beez-ui 0.4.0 → 0.4.2

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Cambios
 
+## 0.4.2 - 2026-09-08
+
+- Actualiza el paquete a la versión 0.4.2.
+
+## 0.4.1 - 2026-09-08
+
+- Actualiza el paquete a la versión 0.4.1.
+
 ## 0.4.0 - 2026-09-08
 
 - Distribuye los providers nativo, Next y TanStack con tema compartido, navegación e imágenes adaptadas al framework.

package/README.md

@@ -85,26 +85,44 @@ Los tests resuelven `beez-ui`, `beez-ui/next` y `beez-ui/tanstack` mediante ruta
 
 El compilador `tsc` es TypeScript 7. Para `typescript-eslint`, se mantiene la [API de compatibilidad oficial de TypeScript 6](https://devblogs.microsoft.com/typescript/announcing-typescript-7-0/#running-side-by-side-with-typescript-6.0) mediante un alias; no reemplaza el compilador de los typechecks.
 
-## Preparar y publicar una versión
+## Crear y publicar una versión
 
-El flujo sigue el utilizado en `eslint-plugin-no-magic`: build reproducible, checks, validación del contenido del tarball y publicación explícita.
+Desde el repositorio de beez-ui, configurar `NPM_TOKEN` con permiso de publicación en el entorno o en `.env`, tomando `.env.example` como referencia. Mantener el archivo local existente si ya está configurado. Después ejecutar:
 
-1. Actualizar `package.json` y la primera entrada de `CHANGELOG.md` con la misma versión.
-2. Ejecutar `pnpm release:prepare`. Instala desde el lockfile congelado, compila JavaScript y tipos, ejecuta lint, typechecks, tests unitarios, prueba del tarball y tests de navegador.
-3. El comando deja un archivo en `releases/<version>-<sha256>/beez-ui-<version>.tgz`, verifica sus exports y excluye fuentes privadas, tests, scripts, `.env` y `.npmrc`. Las fuentes, estilos y licencias públicas sí forman parte del paquete. Conserva releases anteriores.
-4. Revisar y commitear la versión y sus notas. La preparación no crea commits ni tags y no publica.
-5. Configurar `NPM_TOKEN` con permiso de publicación en el entorno o en `.env`, tomando `.env.example` como referencia. Mantener el archivo local existente si ya está configurado.
-6. Publicar el artefacto exacto que imprimió la preparación:
+```sh
+pnpm run create-version patch
+pnpm run create-version minor --notes "Agrega un componente" --notes "Amplía sus opciones"
+pnpm run create-version 0.5.0 --notes "Describe los cambios de esta versión"
+```
+
+Acepta `patch`, `minor`, `major` o una versión estable explícita mayor que la actual. Las notas son opcionales y pueden repetirse. Sin `--notes`, se agrega una entrada básica que indica la nueva versión; las notas explícitas no pueden estar vacías. `pnpm run create-version --help` muestra la sintaxis.
+
+El comando ejecuta el flujo completo:
+
+1. Actualiza `package.json` y agrega la entrada del changelog con fecha UTC, conservando el historial.
+2. Prepara la release: instalación congelada, build de JavaScript, tipos y CSS, lint, typechecks, tests unitarios y pruebas de navegador.
+3. Genera el tarball en `releases/<version>-<sha256>/beez-ui-<version>.tgz` y valida su contenido, exports e integridad.
+4. Publica ese mismo artefacto en npm con acceso público y etiqueta `latest`.
+
+La publicación usa el cliente oficial de npm para admitir su flujo interactivo de verificación en el navegador/2FA. Instalación, build y checks siguen usando pnpm 12. Ejecutar desde una terminal interactiva cuando la cuenta requiera autenticación adicional. El token se carga sólo al publicar, no se imprime y se referencia mediante `${NPM_TOKEN}` en `.npmrc`.
+
+El comando no crea commits ni tags ni modifica ramas Git. Si falla una validación, no publica. Los metadatos de la nueva versión quedan disponibles: corregir el error, ejecutar `pnpm release:prepare` y publicar el artefacto resultante. Si falla la publicación, comprobar primero si npm recibió la versión y reintentar sólo la publicación del mismo tarball. No ejecutar nuevamente `create-version` para reintentar la misma release.
+
+Los pasos individuales siguen disponibles:
 
 ```sh
+# Sólo validar y empaquetar la versión actual, sin publicarla.
+pnpm release:prepare
+
+# Publicar un artefacto ya preparado.
 pnpm release:publish releases/<version>-<sha256>/beez-ui-<version>.tgz
 ```
 
-El comando valida nuevamente nombre, versión, contenido y checksum antes de invocar `pnpm publish --access public`. Carga `.env` sólo si el token no existe en el entorno y no imprime su contenido. La autenticación se configura mediante `.npmrc` con la referencia `${NPM_TOKEN}`. Los controles de Git de pnpm permanecen activos.
+`release:publish` vuelve a verificar nombre, versión, contenido y checksum antes de invocar `npm publish`. El paquete excluye fuentes privadas, tests, scripts, `.env` y `.npmrc`; incluye JavaScript, declaraciones, CSS, fuentes tipográficas y licencias. Conserva releases anteriores.
 
 `prepack` ejecuta el build para los empaquetados manuales. `dist` y `releases` son generados e ignorados por Git. La CI verifica los checks y los tres providers en ambos motores de navegador en Linux y Windows; no publica automáticamente.
 
-Tras publicar, los consumidores pueden instalar `pnpm add beez-ui`. También pueden instalar directamente el `.tgz` validado antes de una publicación. LaTribu mantiene un artefacto versionado en `vendor` y su lockfile para instalaciones reproducibles.
+Tras publicar, los consumidores pueden instalar `pnpm add beez-ui`. También pueden instalar directamente el `.tgz` validado antes de una publicación. LaTribu consume la versión publicada en npm y fija la resolución e integridad mediante su lockfile, sin guardar tarballs locales.
 
 Los componentes nuevos de shadcn/ui se agregan mediante su CLI en esta biblioteca y se exportan desde la raíz. No editar las copias instaladas en los consumidores.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beez-ui",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Shared UI components with the customizations extracted from TuTribu.",
   "type": "module",
   "sideEffects": [
@@ -279,6 +279,7 @@
     "@types/node": "^25.9.5",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.7",
+    "@types/semver": "^7.8.0",
     "@typescript/native": "npm:typescript@^7.0.2",
     "@vitejs/plugin-react": "^6.1.1",
     "eslint": "^10.10.0",
@@ -288,6 +289,7 @@
     "next": "^16.3.4",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
+    "semver": "^7.8.5",
     "shadcn": "^4.21.0",
     "tailwindcss": "^4.3.3",
     "tw-animate-css": "^1.4.0",
@@ -329,6 +331,7 @@
     "lint": "eslint .",
     "test:browser": "pnpm build && playwright test",
     "build": "node scripts/build.js",
+    "create-version": "node scripts/create-version.js",
     "release:prepare": "node scripts/prepare-release.js",
     "release:publish": "node scripts/publish-release.js"
   }