cuenti-dna 0.1.0-beta.1

package/README.md

@@ -0,0 +1,133 @@
+# cuenti-dna
+
+Libreria de componentes React para el sistema de diseno de Cuenti.
+
+## Requisitos
+
+- Node.js 18+
+- React 18 o React 19
+
+## Instalacion
+
+Version beta actual:
+
+```bash
+npm install cuenti-dna@beta
+```
+
+o
+
+```bash
+pnpm add cuenti-dna@beta
+```
+
+Cuando publiques una version estable, podras instalar con `@latest`.
+
+### Postinstall automatico
+
+Al instalar `cuenti-dna`, el paquete ejecuta un `postinstall` que intenta cargar automaticamente las variables CSS y tipografias:
+
+- Busca un archivo global CSS del proyecto (por ejemplo `src/styles/globals.css`, `app/globals.css`, `src/index.css`).
+- Inserta al inicio un bloque gestionado por Cuenti con:
+   - `@import 'cuenti-dna/styles.css';`
+   - imports de tipografias
+   - tokens `:root`
+   - tokens `@theme inline` (Tailwind v4)
+- Deja el contenido original del proyecto al final del archivo.
+- Si detecta colisiones de variables, pregunta si deseas sobreescribir.
+   - En entornos no interactivos (CI), por defecto conserva las variables del proyecto.
+   - Puedes forzar overwrite con `CUENTI_DNA_OVERWRITE_VARS=true`.
+
+Si tu entorno instala dependencias con scripts deshabilitados, usa import manual:
+
+```tsx
+import 'cuenti-dna/styles.css'
+```
+
+## Uso
+
+Importa los componentes desde el paquete:
+
+```tsx
+import { Input, Button } from 'cuenti-dna'
+```
+
+Importa los estilos globales una sola vez en tu app (por ejemplo en el entrypoint):
+
+```tsx
+import 'cuenti-dna/styles.css'
+```
+
+Ejemplo rapido:
+
+```tsx
+import 'cuenti-dna/styles.css'
+import { Input } from 'cuenti-dna'
+
+export function Example() {
+  return (
+      <Input
+         type="text"
+         variant="default"
+         size="md"
+         aria-label="Nombre"
+         placeholder="Ingresa tu nombre"
+      />
+  )
+}
+```
+
+## Scripts
+
+- `pnpm run build`: genera artefactos de libreria en `dist/` (JS ESM/CJS, tipos y CSS).
+- `pnpm run dev`: atajo para levantar Storybook en desarrollo.
+- `pnpm run storybook`: levanta Storybook en desarrollo.
+- `pnpm run build-storybook`: genera el build estatico de Storybook en `storybook-static/`.
+- `pnpm run lint`: ejecuta Biome.
+
+## Publicacion en npm
+
+1. Inicia sesion en npm (una sola vez por maquina):
+
+   ```bash
+   npm login
+   ```
+
+2. Verifica build local:
+
+   ```bash
+   pnpm run build
+   ```
+
+3. (Opcional) Revisa el contenido que se publicara:
+
+   ```bash
+   npm pack --dry-run
+   ```
+
+4. Sube la version beta:
+
+   ```bash
+   npm version prerelease --preid beta
+   ```
+
+5. Publica con dist-tag beta:
+
+   ```bash
+   pnpm run publish:beta
+   ```
+
+Nota: al ser una version `beta`, npm exige publicar con `--tag beta`.
+
+## Storybook deploy
+
+Para deployar Storybook en tu proveedor preferido:
+
+1. Ejecuta `pnpm run build-storybook`.
+2. Publica el contenido de `storybook-static/`.
+
+Si usas Chromatic:
+
+```bash
+npx chromatic --project-token=<TU_TOKEN>
+```