beez-ui 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -1,152 +1,160 @@
-# Cambios
-
-Todos los cambios relevantes de beez-ui se documentan en este archivo con el formato de [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y versionado [SemVer](https://semver.org/lang/es/). Cada cambio agrega sus entradas en `[Unreleased]`; `pnpm create-version` las pasa a la versión publicada con su fecha.
-
+# Cambios
+
+Todos los cambios relevantes de beez-ui se documentan en este archivo con el formato de [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y versionado [SemVer](https://semver.org/lang/es/). Cada cambio agrega sus entradas en `[Unreleased]`; `pnpm create-version` las pasa a la versión publicada con su fecha.
+
 ## [Unreleased]
 
+## [0.8.1] - 2026-09-27
+
+### Changed
+
+- Cada versión publicada queda en un commit `X.Y.Z` con el tag `vX.Y.Z` en GitHub (antes era un commit `chore(release): prepara la versión X.Y.Z` sin tag), para ubicar el código exacto de cada versión.
+- La publicación en npm la hace el comando compartido de beez-rp, que vuelve a verificar el SHA-256 y el contenido del tarball antes de subirlo; se retira `pnpm release:publish`.
+- Publicar con `pnpm publish` queda bloqueado por `beez-rp guard-publish`: cada versión sale sólo desde `pnpm create-version`, que publica con npm el tarball verificado.
+
 ## [0.8.0] - 2026-09-26
 
-### Added
-
-- Los tokens de movimiento (`MOTION_TIMING`, `MOTION_EASE`, springs y distancias) se exportan desde la raíz y desde `beez-ui/motion-tokens`, con los nuevos `SPRING_POP`, `MOTION_ITEM_ENTER_SCALE` y las duraciones `pop` y `collapse`, para animar superficies propias igual que la biblioteca.
-- Primitivas de movimiento `PresenceSwap`, `AnimatedCount`, `AnimatedCollapse` y `AnimatedListItem`, que respetan el movimiento reducido.
-- `BouncingDotsLoader`, `ProgressRing`, `EmptyState`, `ErrorState`, `InfoPopover`, `ConfirmDeleteButton` y `ReactionButton`.
-- `AccountMenu`: menú de cuenta con avatar, identidad, inicio de sesión como link o callback, cierre de sesión y variante para sidebar.
-- `RichTextContent`, `RichMarkdownContent`, `RichLinkEditor` y `useRichLinkEditor` para mostrar y editar texto con links en markdown sin interpretar HTML, junto con `parseRichTextSegments` y `parseRichMarkdownBlocks`.
-- `OpenInBrowserCta` y `ExternalBrowserHandoff` para salir de navegadores internos de otras apps, con `detectInAppBrowser` y `buildExternalBrowserUrl`.
-- `PwaUpdateControl`, que ofrece aplicar una actualización pendiente del service worker.
-- `NotificationBell` y `NotificationPanel`: bandeja de notificaciones en popover o en sheet según el viewport, a partir de ítems ya resueltos por la app.
-- `MonthGrid` y `MonthCalendarHeader` para calendarios mensuales, con `createMonthGridDays`, `groupItemsByDateKey`, `shiftMonthKey` y `useMonthTransitionDirection`.
-- `FileUpload`, `FileUploadDropZone`, `FileUploadList` y `FileUploadItem`, con validación por tipo y tamaño (`classifyFiles`, `isFileTypeAccepted`).
-- `EmojiPicker` en el entrypoint opcional `beez-ui/emoji-picker`; requiere instalar `emoji-picker-react`.
-- Hooks `useIsHydrated`, `useMinuteClock`, `useViewerTimeZone`, `useHorizontalSwipe` y `usePrefersReducedMotion`.
-- Utilidades `formatFileSize`, `copyTextToClipboard`, `getNameInitials`, búsqueda difusa (`getFuzzyMatchRank`, `renderHighlightedText`) y helpers de URL (`replaceCurrentUrlSearchParams`).
-
-### Fixed
-
+### Added
+
+- Los tokens de movimiento (`MOTION_TIMING`, `MOTION_EASE`, springs y distancias) se exportan desde la raíz y desde `beez-ui/motion-tokens`, con los nuevos `SPRING_POP`, `MOTION_ITEM_ENTER_SCALE` y las duraciones `pop` y `collapse`, para animar superficies propias igual que la biblioteca.
+- Primitivas de movimiento `PresenceSwap`, `AnimatedCount`, `AnimatedCollapse` y `AnimatedListItem`, que respetan el movimiento reducido.
+- `BouncingDotsLoader`, `ProgressRing`, `EmptyState`, `ErrorState`, `InfoPopover`, `ConfirmDeleteButton` y `ReactionButton`.
+- `AccountMenu`: menú de cuenta con avatar, identidad, inicio de sesión como link o callback, cierre de sesión y variante para sidebar.
+- `RichTextContent`, `RichMarkdownContent`, `RichLinkEditor` y `useRichLinkEditor` para mostrar y editar texto con links en markdown sin interpretar HTML, junto con `parseRichTextSegments` y `parseRichMarkdownBlocks`.
+- `OpenInBrowserCta` y `ExternalBrowserHandoff` para salir de navegadores internos de otras apps, con `detectInAppBrowser` y `buildExternalBrowserUrl`.
+- `PwaUpdateControl`, que ofrece aplicar una actualización pendiente del service worker.
+- `NotificationBell` y `NotificationPanel`: bandeja de notificaciones en popover o en sheet según el viewport, a partir de ítems ya resueltos por la app.
+- `MonthGrid` y `MonthCalendarHeader` para calendarios mensuales, con `createMonthGridDays`, `groupItemsByDateKey`, `shiftMonthKey` y `useMonthTransitionDirection`.
+- `FileUpload`, `FileUploadDropZone`, `FileUploadList` y `FileUploadItem`, con validación por tipo y tamaño (`classifyFiles`, `isFileTypeAccepted`).
+- `EmojiPicker` en el entrypoint opcional `beez-ui/emoji-picker`; requiere instalar `emoji-picker-react`.
+- Hooks `useIsHydrated`, `useMinuteClock`, `useViewerTimeZone`, `useHorizontalSwipe` y `usePrefersReducedMotion`.
+- Utilidades `formatFileSize`, `copyTextToClipboard`, `getNameInitials`, búsqueda difusa (`getFuzzyMatchRank`, `renderHighlightedText`) y helpers de URL (`replaceCurrentUrlSearchParams`).
+
+### Fixed
+
 - `BeezUIProvider` ya no provoca el aviso de React «Encountered a script tag» en apps renderizadas solo en el cliente; con SSR conserva el script que aplica el tema antes de hidratar, sin parpadeo.
 
-## [0.7.0] - 2026-09-26
-
-### Added
-
-- `PaginationContent` desliza el resaltado de la página actual hacia la página elegida cuando la lista permanece montada (paginación en el cliente).
-- `Calendar` desliza el mes entrante desde el lado de la navegación (también en RTL) y se mantiene estático con movimiento reducido.
-- `AvatarImage` revela la imagen con un desenfoque y un zoom breves al terminar de cargar, en lugar de aparecer de golpe sobre el fallback.
-- Las sugerencias de `FilterQueryBar` deslizan el resaltado entre opciones con teclado, como los menús y `Select`.
-- `AvatarGroup` eleva levemente el avatar bajo el puntero en dispositivos con hover real.
-- El chevron de `DropdownMenuSubTrigger` se desplaza hacia el submenú abierto.
-
-### Changed
-
-- `Skeleton` muestra un brillo que recorre el placeholder en lugar del pulso de opacidad; con movimiento reducido queda como un bloque liso.
-- `Sheet` se cierra con una curva de cajón breve en lugar de un spring, y su botón de cierre aparece con un pop demorado como el de `Dialog`.
-- `Alert` entra con un leve desplazamiento y desenfoque.
-- Los anillos de foco y bordes de `Input`, `Textarea`, `InputGroup`, `SelectTrigger`, `Checkbox` y `RadioGroupItem` aparecen con una transición en lugar de saltar.
-- En menús, `Select` y sugerencias, el resaltado sigue al puntero al instante y solo se desliza al navegar con teclado, con un spring más rápido.
-- El sidebar colapsa y expande con una curva de cajón de 300 ms en lugar de una transición lineal.
-- El thumb de `Switch` tiene una sombra sutil que lo separa del track.
-
-### Fixed
-
-- El cursor de `TypingAnimation` vuelve a parpadear: queda fijo mientras escribe o borra, parpadea en reposo y los lectores de pantalla lo ignoran.
-- `Carousel` vertical responde a las flechas arriba y abajo; antes solo reaccionaba a izquierda y derecha.
-- `SidebarMenuButton` con `variant="outline"` vuelve a pintar su borde con los tokens `oklch` del tema.
-- `FormLabel`, `FormControl`, `FormDescription` y `FormMessage` fuera de un `FormField` lanzan un error claro en lugar de fallar en silencio.
-- Los bordes sin color explícito (footers de `Card`, `Dialog` y `AlertDialog`, `Alert`, filas de `Table`, bordes de `Sheet` y del sidebar) usan el token `--border` del tema en lugar del color del texto cuando se consume `beez-ui/styles.css` sin Tailwind.
-- `DropdownMenu`, sus submenús, `Popover`, `HoverCard` y `Select` muestran su borde y su sombra desde el primer frame al abrirse; antes el revelado los recortaba durante ~650 ms.
-- `DataTable` filtra las columnas apuntadas por `queryFilterConfig` que no declaran `filterFn` (rangos numéricos, enums y año-mes); antes un rango sobre una columna numérica lanzaba `TypeError: val is not iterable` y un enum ocultaba todas las filas. Un `filterFn` propio de la columna sigue teniendo prioridad.
-- Las `Card` interactivas conservan su contorno mientras muestran la sombra de hover; antes la sombra reemplazaba el anillo del borde.
-
-## [0.6.2] - 2026-09-26
-
-### Changed
-
-- El comando de release (`pnpm create-version`, alias `pnpm cv`) toma las notas del bloque `[Unreleased]` del CHANGELOG, les asigna la versión y la fecha, y pide a Codex que lo complete cuando está vacío.
-- Las cajas del comando de release ajustan el texto largo en varias líneas en lugar de cortarlo.
-- Un release interrumpido reusa automáticamente el artefacto ya preparado cuando es posterior al último cambio de código.
-
-### Removed
-
-- La opción `--notes` y las preguntas sobre las notas del CHANGELOG y sobre reusar el artefacto preparado.
-
-## 0.6.1 - 2026-09-26
-
-- Actualiza pnpm a 12.6.0 y next a 16.3.6
-- Add terminal UI for interactive prompts and spinners
-- Update release banner and icons for improved visibility
-- Remove create-version script
-- Update release command to create-version and improve documentation
-
-## 0.6.0 - 2026-09-23
-
-- Actualiza el paquete a la versión 0.6.0.
-
-## 0.5.6 - 2026-09-09
-
-- Actualiza el paquete a la versión 0.5.6.
-
-## 0.5.5 - 2026-09-09
-
-- Actualiza el paquete a la versión 0.5.5.
-
-## 0.5.4 - 2026-09-09
-
-- Actualiza el paquete a la versión 0.5.4.
-
-## 0.5.3 - 2026-09-09
-
-- Actualiza el paquete a la versión 0.5.3.
-
-## 0.5.2 - 2026-09-09
-
-- Actualiza el paquete a la versión 0.5.2.
-
-## 0.5.1 - 2026-09-08
-
-- Actualiza el paquete a la versión 0.5.1.
-
-## 0.5.0 - 2026-09-08
-
-- Actualiza el paquete a la versión 0.5.0.
-
-## 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.
-- Incluye CSS precompilado, tema y fuentes; los consumidores sólo importan `beez-ui/styles.css`, sin configurar Tailwind.
-- Valida el tarball sin compiladores CSS y las integraciones en Chromium y WebKit.
-
-## 0.3.1 - 2026-09-08
-
-- Publica CSS precompilado para que los estilos funcionen sin Tailwind ni detección de clases en el consumidor.
-- Conserva el tema, las fuentes y las utilidades compartidas mediante `beez-ui/styles.css`.
-- Verifica estilos computados del tarball servido por HTTP sin procesadores CSS en Chromium y WebKit.
-
-## 0.2.0 - 2026-09-08
-
-- Unifica el nombre `BeezUIProvider` en los entrypoints nativo, Next y TanStack; reemplaza `NextBeezUIProvider`.
-- Comparte el tema mediante `next-themes`, `themeOptions` y `useTheme` en todos los providers.
-- Restaura `Link` desde la raíz con navegación por adaptadores y prefetch desactivado por defecto.
-- Integra Unpic para imágenes nativas y de TanStack, y conserva Next Image en el provider de Next.
-- Separa los tipos de tests y valida navegación, imágenes y tema en Chromium y WebKit.
-
-## 0.1.1 - 2026-09-08
-
-- Publica JavaScript ESM y declaraciones TypeScript en `dist`.
-- Conserva los componentes agrupados y el tema de LaTribu.
-- Mantiene visible el área del avatar durante la carga diferida para permitir que el navegador solicite la imagen.
-- Agrega `BeezUIProvider` para adaptadores nativos o propios y `NextBeezUIProvider` como integración opcional.
-- Incorpora preparación de releases con checks, control del contenido del paquete y checksum SHA-256.
-- Documenta la autenticación con `NPM_TOKEN` y la publicación del artefacto validado.
-
-## 0.1.0 - 2026-09-08
-
-- Centraliza los componentes de LaTribu y agenda-mensual con su tema, fuentes y pruebas.
+## [0.7.0] - 2026-09-26
+
+### Added
+
+- `PaginationContent` desliza el resaltado de la página actual hacia la página elegida cuando la lista permanece montada (paginación en el cliente).
+- `Calendar` desliza el mes entrante desde el lado de la navegación (también en RTL) y se mantiene estático con movimiento reducido.
+- `AvatarImage` revela la imagen con un desenfoque y un zoom breves al terminar de cargar, en lugar de aparecer de golpe sobre el fallback.
+- Las sugerencias de `FilterQueryBar` deslizan el resaltado entre opciones con teclado, como los menús y `Select`.
+- `AvatarGroup` eleva levemente el avatar bajo el puntero en dispositivos con hover real.
+- El chevron de `DropdownMenuSubTrigger` se desplaza hacia el submenú abierto.
+
+### Changed
+
+- `Skeleton` muestra un brillo que recorre el placeholder en lugar del pulso de opacidad; con movimiento reducido queda como un bloque liso.
+- `Sheet` se cierra con una curva de cajón breve en lugar de un spring, y su botón de cierre aparece con un pop demorado como el de `Dialog`.
+- `Alert` entra con un leve desplazamiento y desenfoque.
+- Los anillos de foco y bordes de `Input`, `Textarea`, `InputGroup`, `SelectTrigger`, `Checkbox` y `RadioGroupItem` aparecen con una transición en lugar de saltar.
+- En menús, `Select` y sugerencias, el resaltado sigue al puntero al instante y solo se desliza al navegar con teclado, con un spring más rápido.
+- El sidebar colapsa y expande con una curva de cajón de 300 ms en lugar de una transición lineal.
+- El thumb de `Switch` tiene una sombra sutil que lo separa del track.
+
+### Fixed
+
+- El cursor de `TypingAnimation` vuelve a parpadear: queda fijo mientras escribe o borra, parpadea en reposo y los lectores de pantalla lo ignoran.
+- `Carousel` vertical responde a las flechas arriba y abajo; antes solo reaccionaba a izquierda y derecha.
+- `SidebarMenuButton` con `variant="outline"` vuelve a pintar su borde con los tokens `oklch` del tema.
+- `FormLabel`, `FormControl`, `FormDescription` y `FormMessage` fuera de un `FormField` lanzan un error claro en lugar de fallar en silencio.
+- Los bordes sin color explícito (footers de `Card`, `Dialog` y `AlertDialog`, `Alert`, filas de `Table`, bordes de `Sheet` y del sidebar) usan el token `--border` del tema en lugar del color del texto cuando se consume `beez-ui/styles.css` sin Tailwind.
+- `DropdownMenu`, sus submenús, `Popover`, `HoverCard` y `Select` muestran su borde y su sombra desde el primer frame al abrirse; antes el revelado los recortaba durante ~650 ms.
+- `DataTable` filtra las columnas apuntadas por `queryFilterConfig` que no declaran `filterFn` (rangos numéricos, enums y año-mes); antes un rango sobre una columna numérica lanzaba `TypeError: val is not iterable` y un enum ocultaba todas las filas. Un `filterFn` propio de la columna sigue teniendo prioridad.
+- Las `Card` interactivas conservan su contorno mientras muestran la sombra de hover; antes la sombra reemplazaba el anillo del borde.
+
+## [0.6.2] - 2026-09-26
+
+### Changed
+
+- El comando de release (`pnpm create-version`, alias `pnpm cv`) toma las notas del bloque `[Unreleased]` del CHANGELOG, les asigna la versión y la fecha, y pide a Codex que lo complete cuando está vacío.
+- Las cajas del comando de release ajustan el texto largo en varias líneas en lugar de cortarlo.
+- Un release interrumpido reusa automáticamente el artefacto ya preparado cuando es posterior al último cambio de código.
+
+### Removed
+
+- La opción `--notes` y las preguntas sobre las notas del CHANGELOG y sobre reusar el artefacto preparado.
+
+## 0.6.1 - 2026-09-26
+
+- Actualiza pnpm a 12.6.0 y next a 16.3.6
+- Add terminal UI for interactive prompts and spinners
+- Update release banner and icons for improved visibility
+- Remove create-version script
+- Update release command to create-version and improve documentation
+
+## 0.6.0 - 2026-09-23
+
+- Actualiza el paquete a la versión 0.6.0.
+
+## 0.5.6 - 2026-09-09
+
+- Actualiza el paquete a la versión 0.5.6.
+
+## 0.5.5 - 2026-09-09
+
+- Actualiza el paquete a la versión 0.5.5.
+
+## 0.5.4 - 2026-09-09
+
+- Actualiza el paquete a la versión 0.5.4.
+
+## 0.5.3 - 2026-09-09
+
+- Actualiza el paquete a la versión 0.5.3.
+
+## 0.5.2 - 2026-09-09
+
+- Actualiza el paquete a la versión 0.5.2.
+
+## 0.5.1 - 2026-09-08
+
+- Actualiza el paquete a la versión 0.5.1.
+
+## 0.5.0 - 2026-09-08
+
+- Actualiza el paquete a la versión 0.5.0.
+
+## 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.
+- Incluye CSS precompilado, tema y fuentes; los consumidores sólo importan `beez-ui/styles.css`, sin configurar Tailwind.
+- Valida el tarball sin compiladores CSS y las integraciones en Chromium y WebKit.
+
+## 0.3.1 - 2026-09-08
+
+- Publica CSS precompilado para que los estilos funcionen sin Tailwind ni detección de clases en el consumidor.
+- Conserva el tema, las fuentes y las utilidades compartidas mediante `beez-ui/styles.css`.
+- Verifica estilos computados del tarball servido por HTTP sin procesadores CSS en Chromium y WebKit.
+
+## 0.2.0 - 2026-09-08
+
+- Unifica el nombre `BeezUIProvider` en los entrypoints nativo, Next y TanStack; reemplaza `NextBeezUIProvider`.
+- Comparte el tema mediante `next-themes`, `themeOptions` y `useTheme` en todos los providers.
+- Restaura `Link` desde la raíz con navegación por adaptadores y prefetch desactivado por defecto.
+- Integra Unpic para imágenes nativas y de TanStack, y conserva Next Image en el provider de Next.
+- Separa los tipos de tests y valida navegación, imágenes y tema en Chromium y WebKit.
+
+## 0.1.1 - 2026-09-08
+
+- Publica JavaScript ESM y declaraciones TypeScript en `dist`.
+- Conserva los componentes agrupados y el tema de LaTribu.
+- Mantiene visible el área del avatar durante la carga diferida para permitir que el navegador solicite la imagen.
+- Agrega `BeezUIProvider` para adaptadores nativos o propios y `NextBeezUIProvider` como integración opcional.
+- Incorpora preparación de releases con checks, control del contenido del paquete y checksum SHA-256.
+- Documenta la autenticación con `NPM_TOKEN` y la publicación del artefacto validado.
+
+## 0.1.0 - 2026-09-08
+
+- Centraliza los componentes de LaTribu y agenda-mensual con su tema, fuentes y pruebas.

package/README.md

@@ -240,44 +240,34 @@ pnpm create-version --dry-run               # solo muestra el diagnóstico y el
 pnpm cv                                     # alias de pnpm create-version
 ```
 
-El comando hace `git fetch`, consulta npm y muestra un panel con la rama, el upstream, el working tree, `main` frente a origin, la versión local, la última versión publicada, los commits posteriores al último cambio de versión y el artefacto ya preparado. Después decide qué falta:
+El comando es el motor compartido de los proyectos Beez, `beez-rp create-version` (devDependency `beez-rp`). Su funcionamiento general (diagnóstico, bloqueos, reanudación, Codex, versiones permitidas) está documentado en el README de [beez-rp](https://github.com/guidomodarelli/beez-rp#create-version). Lo propio de beez-ui vive en `beez-rp.config.js`: la audiencia del CHANGELOG, la descripción de cada tipo de versión, el hook `prepare` de `scripts/release-hooks.js` y la publicación en npm del tarball preparado (`publish: "npm"` + `artifact`).
 
-- **Release nuevo**: si hay commits sin publicar, sugiere `patch`, `minor` o `major` según los commits (breaking change, funcionalidades o solo arreglos) y pregunta con las flechas. Las notas salen del bloque `## [Unreleased]` de `CHANGELOG.md` (ver la sección CHANGELOG más abajo); si está vacío, invoca a Codex (`codex exec`) para completarlo desde los commits sin publicar y muestra el resultado, y si Codex no está o no escribe nada válido, el release se corta. Tras confirmar ejecuta el flujo validado completo (ver abajo).
-- **Release a medio terminar**: si `package.json` tiene una versión que npm todavía no tiene, completa solo lo que falta: si `package.json` y `CHANGELOG.md` quedaron sin commitear los commitea primero; después prepara el artefacto (reusa automáticamente el ya preparado cuando es posterior al último cambio de código, y `release:publish` lo vuelve a verificar), pushea el commit de release si todavía no está en origin y publica (la confirmación del inicio cubre la publicación). Nunca vuelve a subir la versión.
-- **Todo al día**: si la versión está publicada y no hay commits nuevos, no hace nada.
+Los releases salen sólo desde `main`, limpio y al día con origin (sólo `CHANGELOG.md` puede quedar sin commitear). En otra rama explica qué falta: pushear, abrir o mergear el PR. El último release es el último commit de `origin/main` que cambió el `version` de `package.json`, así que reconoce tanto los commits `X.Y.Z` como los anteriores `chore(release): prepara la versión X.Y.Z`.
 
-`--set-version` sólo acepta el siguiente patch, minor o major de la versión actual (desde `0.6.0`: `0.6.1`, `0.7.0` o `1.0.0`); rechaza versiones menores, iguales, prerelease o que salteen versiones. Los releases salen sólo desde `main` con upstream configurado. Se detiene y explica qué hacer ante otra rama, `HEAD` desacoplado, cambios sin commitear (salvo `CHANGELOG.md` en un release nuevo, que viaja en el commit de release, o `package.json` y `CHANGELOG.md` de un release a medio terminar), secciones de `[Unreleased]` fuera de las de Keep a Changelog, `main` divergida o npm sin respuesta; un bloqueo termina con código 0 porque ya está explicado en pantalla, y un paso fallido termina con código 1. Si `main` está atrás, la actualiza con fast-forward antes de versionar. Si algo falla, basta con volver a ejecutar `pnpm create-version`: retoma desde el primer paso pendiente. Las opciones de cada pregunta están numeradas: se eligen apretando su número, o con las flechas y Enter; cada versión muestra debajo qué significa patch, minor o major. Sin terminal interactiva cada pregunta toma su opción por defecto. El tiempo total que muestra al final no cuenta el tiempo que espera tus respuestas.
+### Flujo validado de un release nuevo
 
-La lógica pura vive en `scripts/release-plan.js` y `scripts/changelog.js` (lectura y release de `[Unreleased]`), la invocación de Codex en `scripts/changelog-ai.js`, la lectura de Git y npm en `scripts/release-state.js`, la UI de terminal (cajas, colores, íconos Nerd Font, spinner y selector) en `scripts/terminal-ui.js` y el orquestador en `scripts/release.js`, sin dependencias nuevas. Los íconos requieren una Nerd Font en la terminal.
+1. Actualiza `main` con fast-forward si está atrás.
+2. Si `## [Unreleased]` está vacío, Codex lo completa desde los commits sin publicar; si no puede, el release se corta.
+3. Pide la versión (sugiere `patch`, `minor` o `major` según los commits), renombra `## [Unreleased]` a `## [X.Y.Z] - AAAA-MM-DD` dejando un `[Unreleased]` vacío arriba y crea el commit `X.Y.Z` con `package.json` y `CHANGELOG.md` y el tag anotado `vX.Y.Z`, antes de las validaciones largas.
+4. `prepare` (`scripts/release-hooks.js`): reusa el tarball ya preparado para esa versión si es posterior al último cambio de código (el commit de versión no cuenta); si no, ejecuta `pnpm release:prepare` sobre el commit de versión: instalación congelada, tests sin React Compiler, build optimizado, lint, typechecks, tests unitarios y pruebas de navegador, y genera el tarball verificado con `npm pack --ignore-scripts` (npm y no pnpm, para que sea reproducible) en `releases/<version>-<sha256>/beez-ui-<version>.tgz`.
+5. Sube `main` y el tag `vX.Y.Z` a origin con un único `git push --atomic`.
+6. Publicación: beez-rp exige que el commit de versión siga sin cambios, toma `releases/<version>-<sha256>/beez-ui-<version>.tgz`, verifica el SHA-256 de su ruta y compara su SHA-512 con el `integrity` de `npm pack --dry-run` sobre ese commit (`npm pack` es reproducible, así que coincidir prueba que es byte a byte lo que npm empaqueta) y recién ahí lo publica con acceso público y etiqueta `latest`. Además, `prepublishOnly` ejecuta `beez-rp guard-publish`, que corta un `pnpm publish` manual (o yarn/bun): se publica sólo con `pnpm create-version`, que usa npm.
 
-### CHANGELOG
+Si algo falla después del commit de versión, basta con volver a ejecutar `pnpm create-version`: si `HEAD` es el commit `X.Y.Z` y npm todavía no tiene esa versión, retoma sólo la preparación (reusando el tarball si sigue vigente), el push si falta y la publicación. Nunca vuelve a subir la versión.
 
-`CHANGELOG.md` sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/). Cada cambio agrega sus entradas en el bloque `## [Unreleased]`, agrupadas en `### Added`, `### Changed`, `### Deprecated`, `### Removed`, `### Fixed` y `### Security` (solo las que apliquen). Nunca se escriben la versión ni la fecha a mano: `pnpm create-version` las agrega al publicar. Las versiones anteriores a este formato (`## 0.6.1 - 2026-09-26`) siguen siendo válidas. La regla completa está en `AGENTS.md`.
-
-### Flujo validado de un release nuevo
+La publicación usa el cliente oficial de npm y hereda la terminal, así que admite su verificación interactiva en el navegador/2FA: hay que ejecutar el release desde una terminal interactiva cuando la cuenta la requiera. Instalación, build y checks siguen usando pnpm 12. `NPM_TOKEN` se toma del entorno o del `.env` ignorado y no se imprime; el repositorio no tiene `.npmrc`: beez-rp crea un config temporal de npm fuera del repositorio que sólo referencia `${NPM_TOKEN}` (npm lo expande desde el entorno; el token no se escribe en disco ni en la línea de comandos), lo pasa con `--userconfig` y lo borra al terminar, también si la publicación falla.
 
-1. Actualiza `package.json` y renombra `## [Unreleased]` a `## [X.Y.Z] - AAAA-MM-DD` (fecha UTC), dejando un `[Unreleased]` vacío arriba y conservando el historial (`scripts/release-version.js`). Si `[Unreleased]` no tiene cambios o usa secciones no válidas, no toca nada.
-2. Commitea en el momento `package.json` y `CHANGELOG.md` (sólo esos dos archivos, conservando otros archivos staged), antes de las validaciones largas: si algo se corta después, queda un commit local y nunca metadata suelta.
-3. Prepara la release: instalación congelada, tests sin React Compiler, build optimizado de JavaScript, tipos y CSS, lint, typechecks, tests unitarios y pruebas de navegador.
-4. Genera el tarball en `releases/<version>-<sha256>/beez-ui-<version>.tgz` y valida su contenido, exports e integridad.
-5. Pushea el commit de release a la rama upstream configurada, sólo si sigue siendo el commit actual.
-6. 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 y no se imprime. El repositorio no tiene `.npmrc`: pnpm 12 ignora las variables de entorno en credenciales controladas por el repositorio y avisaba en cada comando. `release:publish` crea un config temporal de npm fuera del repositorio que sólo referencia `${NPM_TOKEN}` (npm lo expande desde el entorno; el token no se escribe en disco ni en la línea de comandos), lo pasa con `--userconfig` y lo borra al terminar, también si la publicación falla (`scripts/npm-auth.js`).
+### CHANGELOG
 
-El commit se limita a los dos archivos de metadatos, incluidos sus cambios previos; revisar el código antes de ejecutar la release. No crea tags ni hace force push. Si cambian el checkout, el upstream o los metadatos durante las validaciones, se detiene. También comprueba que los hooks de Git no hayan agregado archivos ni alterado los metadatos validados antes de pushear. Si falla una validación o el push, no publica y el commit de release queda en local: `pnpm create-version` lo detecta y retoma sólo lo que falte (preparar, pushear, publicar), sin volver a subir la versión. Si falla la publicación, comprobar primero si npm recibió la versión; si no, `pnpm create-version` reintenta sólo la publicación del mismo tarball.
+`CHANGELOG.md` sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/). Cada cambio agrega sus entradas en el bloque `## [Unreleased]`, agrupadas en `### Added`, `### Changed`, `### Deprecated`, `### Removed`, `### Fixed` y `### Security` (solo las que apliquen). Nunca se escriben la versión ni la fecha a mano: `pnpm create-version` las agrega al publicar. Las versiones anteriores a este formato (`## 0.6.1 - 2026-09-26`) siguen siendo válidas. La regla completa está en `AGENTS.md`.
 
-Los pasos individuales siguen disponibles:
+Para validar y empaquetar la versión actual sin publicarla:
 
 ```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
 ```
 
-`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.
+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.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beez-ui",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Shared UI components with the customizations extracted from TuTribu.",
   "type": "module",
   "sideEffects": [
@@ -451,6 +451,26 @@
     "type": "git",
     "url": "git+https://github.com/guidomodarelli/beez-ui.git"
   },
+  "scripts": {
+    "typecheck": "pnpm build && pnpm typecheck:src && pnpm typecheck:tests && pnpm typecheck:stories",
+    "typecheck:src": "tsc --noEmit -p tsconfig.json",
+    "typecheck:tests": "tsc --noEmit -p tests/tsconfig.json",
+    "test": "pnpm build && vitest run",
+    "test:uncompiled": "pnpm build --no-react-compiler && vitest run",
+    "check": "pnpm build && pnpm lint && pnpm typecheck:src && pnpm typecheck:tests && pnpm typecheck:stories && pnpm exec vitest run",
+    "lint": "eslint .",
+    "test:browser": "pnpm build && playwright test",
+    "build": "node scripts/build.js",
+    "prepack": "pnpm build",
+    "prepublishOnly": "beez-rp guard-publish",
+    "create-version": "beez-rp create-version",
+    "cv": "beez-rp create-version",
+    "release:prepare": "node scripts/prepare-release.js",
+    "storybook": "pnpm build && storybook dev -p 6006 --no-open",
+    "build-storybook": "pnpm build && storybook build",
+    "typecheck:stories": "tsc --noEmit -p stories/tsconfig.json",
+    "test:storybook": "pnpm build-storybook && playwright test --config playwright.storybook.config.ts"
+  },
   "peerDependencies": {
     "@tanstack/react-router": "^1.170.33",
     "emoji-picker-react": "^4.19.1",
@@ -488,9 +508,9 @@
     "@types/node": "^25.9.5",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
-    "@types/semver": "^7.8.0",
     "@typescript/native": "npm:typescript@^7.0.2",
     "@vitejs/plugin-react": "^6.1.1",
+    "beez-rp": "^0.3.0",
     "emoji-picker-react": "^4.22.2",
     "eslint": "^10.10.0",
     "eslint-plugin-react-hooks": "^7.1.1",
@@ -501,7 +521,6 @@
     "oxc-transform-react": "^0.149.0",
     "react": "^19.3.0",
     "react-dom": "^19.3.0",
-    "semver": "^7.8.5",
     "shadcn": "^4.21.0",
     "storybook": "^10.6.0",
     "tailwindcss": "^4.3.3",
@@ -511,6 +530,7 @@
     "vite": "^8.2.2",
     "vitest": "^5.0.0"
   },
+  "packageManager": "pnpm@12.6.0",
   "engines": {
     "node": ">=22",
     "pnpm": ">=12 <13"
@@ -537,24 +557,5 @@
     "@tanstack/react-router": {
       "optional": true
     }
-  },
-  "scripts": {
-    "typecheck": "pnpm build && pnpm typecheck:src && pnpm typecheck:tests && pnpm typecheck:stories",
-    "typecheck:src": "tsc --noEmit -p tsconfig.json",
-    "typecheck:tests": "tsc --noEmit -p tests/tsconfig.json",
-    "test": "pnpm build && vitest run",
-    "test:uncompiled": "pnpm build --no-react-compiler && vitest run",
-    "check": "pnpm build && pnpm lint && pnpm typecheck:src && pnpm typecheck:tests && pnpm typecheck:stories && pnpm exec vitest run",
-    "lint": "eslint .",
-    "test:browser": "pnpm build && playwright test",
-    "build": "node scripts/build.js",
-    "create-version": "node scripts/release.js",
-    "cv": "node scripts/release.js",
-    "release:prepare": "node scripts/prepare-release.js",
-    "release:publish": "node scripts/publish-release.js",
-    "storybook": "pnpm build && storybook dev -p 6006 --no-open",
-    "build-storybook": "pnpm build && storybook build",
-    "typecheck:stories": "tsc --noEmit -p stories/tsconfig.json",
-    "test:storybook": "pnpm build-storybook && playwright test --config playwright.storybook.config.ts"
   }
-}
+}