open-index/open-npm huggingface dataset:
npm package: @mars_444/ui-kit
Description: UI библиотека компонентов для проектов Knit-toys, основанная на shadcn/ui.
Latest version: 0.2.2

# Knit UI Kit

UI библиотека компонентов для проектов Knit-toys, основанная на shadcn/ui.

## Установка

```bash
# В проекте, где вы хотите использовать ui-kit:
npm install @knit/ui-kit
```

## Использование

```tsx
// Импорт стилей
import '@knit/ui-kit/styles.css'; 

// Импорт компонентов
import { Button } from '@knit/ui-kit';

// Использование в компоненте
function MyComponent() {
  return (
    <div>
      <Button variant="default">Нажми меня</Button>
    </div>
  )
}
```

## Разработка

### Добавление новых компонентов

UI-kit использует shadcn-ui для управления компонентами. Для добавления нового компонента:

```bash
# Перейти в директорию ui-kit
cd packages/shared/ui-kit

# Добавить компонент через CLI
npm run add:component

# Выбрать нужный компонент из списка, например: button, card, etc.
```

После добавления компонента через CLI, не забудьте добавить его экспорт в `src/index.ts`:

```typescript
// src/index.ts
// ...существующие импорты

// Добавить экспорт нового компонента
export * from './components/your-new-component';
```

### Сборка и публикация

Для сборки пакета:

```bash
# Через Makefile
make ui-kit-build

# Или напрямую
cd packages/shared/ui-kit && npm run build
```

#### Публикация в npm registry

Перед публикацией, убедитесь что:
1. Вы авторизованы в npm: `npm login`
2. Имя пакета (`@knit/ui-kit`) уникальное или принадлежит вашей организации
3. Версия пакета обновлена (в package.json)

Для публикации:

```bash
# Через Makefile
make ui-kit-publish

# Или напрямую
cd packages/shared/ui-kit && npm run publish:npm
```

#### Локальная публикация для тестирования

Для тестирования пакета без публикации в npm, можно использовать [yalc](https://github.com/wclr/yalc):

```bash
# Через Makefile
make ui-kit-publish-local

# Затем в проекте, где хотите использовать пакет
cd your-frontend-app
yalc add @knit/ui-kit
```

## Доступные компоненты

На данный момент библиотека находится в стадии разработки. После добавления компонентов через CLI shadcn, они будут доступны для импорта.

## Особенности

- Используется Vite для сборки библиотеки
- TypeScript для типизации
- Поддержка Tailwind CSS
- Основано на компонентах shadcn/ui
- Темная и светлая темы через CSS переменные
npm package: @marsaude/tokens
Description: Design Tokens do Sira Design System
Latest version: 1.1.2

```markdown
# Sira Design Tokens (@marsaude/tokens)

Pacote de Design Tokens do Sira Design System. Este pacote contém as variáveis de estilo (cores, tipografia, espaçamentos) geradas automaticamente a partir do Style Dictionary.

## 📦 Instalação

Para instalar a versão mais recente no seu projeto:

```bash
npm install @marsaude/tokens

```

---

## 🚀 Como Usar

Este pacote expõe diferentes arquivos SCSS dependendo da sua necessidade (apenas variáveis ou classes utilitárias).

### 1. Importando as Variáveis (Recomendado)

Para ter acesso às variáveis CSS/SCSS (ex: cores, fontes) em todo o seu projeto, importe o arquivo principal no seu `styles.scss` global:

```scss
// No arquivo src/styles.scss
@import '@marsaude/tokens/mobile';

```

**Exemplo de uso no CSS:**

```scss
.meu-componente {
  // Use as variáveis CSS definidas pelos tokens
  background-color: var(--mar-color-brand-primary);
  padding: var(--mar-spacing-md);
  border-radius: var(--mar-radius-sm);
}

```

### 2. Importando Classes Utilitárias

Se você precisa das classes utilitárias geradas (helpers), utilize o import específico:

```scss
@import '@marsaude/tokens/mobile-classes';

```

---

## 🛠️ Desenvolvimento e Publicação (Para Mantenedores)

### Como gerar os tokens

Se você alterou os arquivos de configuração ou os tokens brutos, regenere os arquivos de build:

```bash
npm run build

```

### Como publicar uma nova versão

O script de publicação já garante que o build seja rodado automaticamente antes de enviar.

1. **Atualize a versão** (se necessário):
```bash
npm version patch

```


2. **Publique no NPM:**
```bash
npm publish --access public

```


*(Certifique-se de que o token de acesso granular está configurado corretamente na sua máquina).*

```

```