open-index/open-npm huggingface dataset:
npm package: @nextime-ui/docs
Description: **@nextime-ui/docs** é o pacote responsável por hospedar e gerenciar a documentação do monorepo **NeXTIME UI**, utilizando o [Storybook](https://storybook.js.org/) para criar e exibir exemplos interativos dos componentes.
Author: Pedro Duarte - NeXTIME
Latest version: 3.1.9

# @nextime-ui/docs

**@nextime-ui/docs** é o pacote responsável por hospedar e gerenciar a documentação do monorepo **NeXTIME UI**, utilizando o [Storybook](https://storybook.js.org/) para criar e exibir exemplos interativos dos componentes.

![version](https://img.shields.io/npm/v/@nextime-ui/preline.svg)
![license](https://img.shields.io/badge/license-MIT-green)

## 📚 Sobre

Este projeto tem como objetivo documentar os componentes disponíveis no monorepo **NeXTIME UI**, permitindo que desenvolvedores entendam suas funcionalidades e saibam como utilizá-los em seus projetos.

A documentação está disponível online:  
🔗 **[Nextime UI Docs](https://ui.nextime.com.br)**

## 💻 Pré-requisitos

Antes de começar, certifique-se de ter instalado:

- [pnpm](https://pnpm.io/) (versão mais recente)
- [Node.js](https://nodejs.org/) (versão compatível com o projeto)

## 🛠️ Scripts Disponíveis

Os seguintes scripts estão disponíveis no `package.json` para gerenciar o projeto:

- **`pnpm dev`**: Inicia o Storybook no modo de desenvolvimento.
- **`pnpm build`**: Gera a versão estática do Storybook para produção.
- **`pnpm lint`**: Analisa o código usando ESLint e corrige problemas automaticamente.
- **`pnpm typecheck`**: Realiza a verificação de tipos com TypeScript.
- **`pnpm clean`**: Remove arquivos temporários e dependências.
- **`pnpm update`**: Atualiza as dependências para as versões mais recentes.

## 🛠️ Como Configurar o Ambiente

1. **Clone o repositório principal**:
   ```bash
   git clone https://github.com/nextimecode/nextime-ui.git
   ```

2. **Acesse o diretório do pacote `docs`**:
   ```bash
   cd nextime-ui/packages/docs
   ```

3. **Instale as dependências**:
   ```bash
   pnpm install
   ```

4. **Inicie o Storybook**:
   ```bash
   pnpm dev
   ```

5. Acesse a documentação no navegador em:  
   `http://localhost:6006`

## 📝 Publicação

Para publicar a versão estática do Storybook:

1. Gere os arquivos de produção:
   ```bash
   pnpm build
   ```

2. Os arquivos serão gerados no diretório `storybook-static`. Publique-os no servidor ou serviço de hospedagem de sua escolha.

## 🌟 Contribuição

Contribuições para a documentação são bem-vindas! Certifique-se de seguir o [Guia de Contribuição](../../CONTRIBUTING.md).

## 📚 Dependências Principais

Este pacote depende de:

- **[@nextime-ui/preline]**: Componentes React documentados.
- **[@nextime-ui/tokens]**: Tokens de design utilizados para estilização.
- **Storybook**: Ferramenta para criar e organizar a documentação interativa.

## 📬 Contato

- Repositório: [nextimecode/nextime-ui](https://github.com/nextimecode/nextime-ui)
- Autor: [Pedro Duarte](https://github.com/phdduarte) - NeXTIME
npm package: @nextime-ui/eslint-config
Description: ESLint configuration used by NeXTIME.
Author: Pedro Duarte - NeXTIME
Latest version: 3.1.9

# @nextime-ui/eslint-config

**@nextime-ui/eslint-config** é a configuração padrão do ESLint utilizada nos projetos do monorepo **NeXTIME UI**. Ela foi projetada para garantir consistência de estilo de código, boas práticas e acessibilidade, aproveitando integrações com Prettier, TypeScript e outras ferramentas populares.

![version](https://img.shields.io/npm/v/@nextime-ui/preline.svg)
![license](https://img.shields.io/badge/license-MIT-green)

## 📚 Sobre

Este pacote fornece um conjunto de regras e plugins do ESLint que pode ser reutilizado em qualquer projeto, especialmente aqueles que utilizam React, TypeScript e Prettier. O objetivo é simplificar a configuração do ESLint e promover um ambiente de desenvolvimento padronizado.

## 📦 Instalação

Antes de começar, certifique-se de ter o ESLint e o TypeScript instalados no seu projeto. Para instalar o pacote de configuração, execute:

```bash
pnpm add -D @nextime-ui/eslint-config eslint typescript
```

Se o seu projeto já utiliza outras ferramentas ou dependências relacionadas, confira as **peerDependencies** deste pacote no `package.json` para garantir que todas estão instaladas.

## 🛠️ Configuração

Adicione o `@nextime-ui/eslint-config` como extensão no seu arquivo de configuração do ESLint (por exemplo, `.eslintrc.json` ou `.eslintrc.js`):

### Usando `.eslintrc.json`

```json
{
  "extends": "@nextime-ui/eslint-config"
}
```

### Usando `.eslintrc.js`

```javascript
module.exports = {
  extends: ["@nextime-ui/eslint-config"]
};
```

## 🚀 Scripts Sugeridos

Adicione os seguintes scripts no seu `package.json` para facilitar a execução do ESLint no seu projeto:

```json
"scripts": {
  "lint": "eslint 'src/**/*.{ts,tsx,js,jsx}' --fix",
  "lint:check": "eslint 'src/**/*.{ts,tsx,js,jsx}'"
}
```

- **`lint`**: Executa o ESLint corrigindo problemas automaticamente.
- **`lint:check`**: Verifica problemas sem fazer correções.

## ⚙️ Recursos Incluídos

Este pacote inclui suporte para:

- **React**: Configurações específicas para projetos com React.
- **TypeScript**: Regras otimizadas para TypeScript.
- **Prettier**: Integração para manter consistência de formatação.
- **Acessibilidade**: Regras do `jsx-a11y` para melhorar a acessibilidade.
- **Melhores práticas**: Plugins como `eslint-plugin-unicorn` e `eslint-plugin-promise` para garantir código mais limpo e confiável.
- **Importação organizada**: Utiliza o `eslint-plugin-import-helpers` para organizar automaticamente os imports.

## 🔧 Scripts Disponíveis

O pacote também inclui scripts úteis:

- **`pnpm clean`**: Remove os diretórios `node_modules` e outros arquivos temporários.
- **`pnpm update`**: Atualiza as dependências para suas versões mais recentes.

## 🌟 Contribuição

Contribuições são bem-vindas! Se você encontrou um problema ou gostaria de sugerir melhorias, consulte nosso [Guia de Contribuição](../../CONTRIBUTING.md).

## 📬 Contato

- Repositório: [nextimecode/nextime-ui](https://github.com/nextimecode/nextime-ui)
- Autor: [Pedro Duarte](https://github.com/phdduarte) - NeXTIME
npm package: @nextime-ui/theme-tools
Description: NeXTIME UI é uma biblioteca de componentes para React, fundamentada no Chakra-UI. Ela faz a  inclusão do recurso 'use client' em seus componentes, uma estratégia eficaz para solucionar problemas existentes no Next.js versão 13.
Author: Pedro Duarte - NeXTIME
Latest version: 3.0.0

# NeXTIME-UI

NeXTIME UI é uma biblioteca de componentes para React, fundamentada no Chakra-UI. Ela faz a inclusão do recurso 'use client' em seus componentes, uma estratégia eficaz para solucionar problemas existentes no Next.js versão 13.

![version](https://img.shields.io/npm/v/@nextime-ui/react.svg)
![license](https://img.shields.io/badge/license-MIT-green)

## 📝 Usando NeXTIME UI

Você pode instalar a biblioteca NeXTIME UI no seu projeto executando o seguinte comando no diretório raiz do seu projeto:

```bash
pnpm add @nextime-ui/react
```

Veja o exemplo de uso da NeXTIME UI:

```jsx
import { Button } from '@nextime-ui/react'

function App() {
  return <Button>Click me!</Button>
}
```

## 📖 Documentação

O projeto Docs cuida da documentação utilizando storybook e você pode acessar o site da documentação no link https://ui.nextime.com.br/

## 📚 Contato

Se você tiver qualquer dúvida, sinta-se à vontade para nos contatar.

Projeto: https://github.com/nextimecode/nextime-ui

Autor: [Pedro Duarte](https://github.com/phdduarte) - NeXTIME
npm package: @nextime-ui/tokens
Description: ![version](https://img.shields.io/npm/v/@nextime-ui/preline.svg) ![license](https://img.shields.io/badge/license-MIT-green)
Author: Pedro Duarte - NeXTIME
Latest version: 3.1.9

# @nextime-ui/tokens

![version](https://img.shields.io/npm/v/@nextime-ui/preline.svg)
![license](https://img.shields.io/badge/license-MIT-green)

**@nextime-ui/tokens** é um pacote de design tokens que fornece valores reutilizáveis para cores, tamanhos de fonte, espaçamentos, raios de borda e outros estilos fundamentais. Ele foi projetado para ser usado em conjunto com os componentes da **NeXTIME UI**, garantindo consistência visual em todos os projetos.

## 📚 Sobre

Os design tokens são definidos em um formato escalável e tipado (TypeScript), permitindo fácil integração em projetos modernos de front-end. Eles podem ser usados diretamente ou como base para bibliotecas de componentes.

## 📦 Instalação

Você pode instalar o pacote com o seguinte comando:

```bash
pnpm add @nextime-ui/tokens
```

## 🛠️ Como Usar

Os tokens podem ser importados e usados diretamente no seu projeto. Aqui estão alguns exemplos:

### Exemplo de Uso

#### Importando Cores

```tsx
import { colors } from '@nextime-ui/tokens';

console.log(colors.gray900); // '#1E1E1E'
```

#### Importando Tamanhos de Fonte

```tsx
import { fontSizes } from '@nextime-ui/tokens';

console.log(fontSizes.md); // '1rem'
```

#### Importando Espaçamentos

```tsx
import { space } from '@nextime-ui/tokens';

console.log(space[4]); // '16px'
```

### Tokens Disponíveis

#### Cores (`colors`)

- **Predefinidas**: Inclui tons de cinza, cores de destaque (ignite), e mais.
- **Exemplo**:
  - `white`: `#FFFFFF`
  - `ignite500`: `#00875F`

#### Tamanhos de Fonte (`fontSizes`)

- Valores disponíveis:
  - `xxs`: `0.625rem`
  - `md`: `1rem`
  - `9xl`: `6rem`

#### Pesos de Fonte (`fontWeights`)

- Valores disponíveis:
  - `regular`: `400`
  - `medium`: `500`
  - `bold`: `700`

#### Espaçamentos (`space`)

- Valores disponíveis:
  - `1`: `4px`
  - `4`: `16px`

#### Outros Tokens

- **Raios de Borda (`radii`)**
- **Alturas de Linha (`lineHeights`)**

## 🚀 Scripts Sugeridos

Adicione os seguintes scripts ao seu `package.json` para facilitar o desenvolvimento:

```json
"scripts": {
  "build": "tsup src/index.ts --format esm,cjs --dts",
  "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
  "lint": "eslint src/**/*.ts* --fix",
  "typecheck": "tsc --noEmit"
}
```

- **`build`**: Gera os arquivos prontos para produção.
- **`dev`**: Inicia o modo de desenvolvimento com watch.
- **`lint`**: Analisa o código com ESLint e corrige problemas automaticamente.
- **`typecheck`**: Verifica os tipos TypeScript.

## 🌟 Contribuição

Contribuições são bem-vindas! Caso tenha sugestões ou melhorias, confira nosso [Guia de Contribuição](../../CONTRIBUTING.md).

## 📬 Contato

- Repositório: [nextimecode/nextime-ui](https://github.com/nextimecode/nextime-ui)
- Autor: [Pedro Duarte](https://github.com/phdduarte) - NeXTIME
npm package: @nextime-ui/ts-config
Description: ![version](https://img.shields.io/npm/v/@nextime-ui/preline.svg) ![license](https://img.shields.io/badge/license-MIT-green)
Author: Pedro Duarte - NeXTIME
Latest version: 3.1.9

# @nextime-ui/ts-config

![version](https://img.shields.io/npm/v/@nextime-ui/preline.svg)
![license](https://img.shields.io/badge/license-MIT-green)

**@nextime-ui/ts-config** é um conjunto de configurações compartilhadas do TypeScript projetadas para garantir consistência e melhores práticas em projetos desenvolvidos no monorepo **NeXTIME UI**. Ele inclui diferentes configurações específicas para React, Next.js e uso geral.

## 📚 Sobre

Este pacote simplifica o gerenciamento de configurações do TypeScript em múltiplos pacotes, promovendo um padrão unificado e reduzindo a duplicação. Ele utiliza arquivos de configuração extensíveis para permitir que cada pacote herde e ajuste as opções conforme necessário.

## 📦 Instalação

Para instalar o pacote em um projeto, execute:

```bash
pnpm add -D @nextime-ui/ts-config typescript
```

## 🛠️ Configuração

Os arquivos de configuração podem ser estendidos em seu projeto através do arquivo `tsconfig.json`. Aqui estão os exemplos para diferentes cenários:

### Configuração Base

Para projetos TypeScript gerais:

```json
{
  "extends": "@nextime-ui/ts-config/base.json",
  "compilerOptions": {
    "outDir": "./dist"
  },
  "include": ["src/**/*"]
}
```

### Configuração para React

Para projetos com React:

```json
{
  "extends": "@nextime-ui/ts-config/react.json",
  "compilerOptions": {
    "outDir": "./dist"
  },
  "include": ["src/**/*"]
}
```

### Configuração para Next.js

Para projetos com Next.js:

```json
{
  "extends": "@nextime-ui/ts-config/nextjs.json",
  "compilerOptions": {
    "baseUrl": "./",
    "outDir": "./dist"
  },
  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"]
}
```

## 🚀 Estrutura do Pacote

O pacote inclui os seguintes arquivos de configuração:

- **`base.json`**: Configuração base para projetos gerais.
- **`react.json`**: Extende a configuração base com opções específicas para projetos React.
- **`nextjs.json`**: Extende a configuração base com opções específicas para projetos Next.js.

## 🔧 Scripts Sugeridos

Adicione os seguintes scripts ao seu `package.json` para facilitar o uso do TypeScript:

```json
"scripts": {
  "typecheck": "tsc --noEmit"
}
```

- **`typecheck`**: Verifica erros de tipo sem gerar arquivos compilados.

## 🌟 Contribuição

Se você encontrou problemas ou deseja sugerir melhorias, consulte nosso [Guia de Contribuição](../../CONTRIBUTING.md).

## 📬 Contato

- Repositório: [nextimecode/nextime-ui](https://github.com/nextimecode/nextime-ui)
- Autor: [Pedro Duarte](https://github.com/phdduarte) - NeXTIME