beez-ui 0.5.5 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Cambios
 
+## 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.
@@ -20,47 +28,47 @@
 
 - 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.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

@@ -1,7 +1,7 @@
-# beez-ui
-
-Biblioteca de componentes React reutilizables, con adaptadores opcionales por framework y tema compartido. Reúne los componentes de LaTribu y las funcionalidades reutilizables de agenda-mensual.
-
+# beez-ui
+
+Biblioteca de componentes React reutilizables, con adaptadores opcionales por framework y tema compartido. Reúne los componentes de LaTribu y las funcionalidades reutilizables de agenda-mensual.
+
 ## Storybook
 
 ```bash
@@ -32,21 +32,21 @@ Configuración basada en [React con Vite](https://storybook.js.org/docs/get-star
 y [Controls](https://storybook.js.org/docs/essentials/controls).
 
 ## Uso del paquete
-
-```tsx
-import { Button, Avatar, AvatarImage, DataTable, Calendar } from "beez-ui";
-```
-
+
+```tsx
+import { Button, Avatar, AvatarImage, DataTable, Calendar } from "beez-ui";
+```
+
 Agrupar los imports de componentes desde la raíz. El paquete publica JavaScript ESM y declaraciones TypeScript en `dist`; el consumidor no necesita transpilar el código fuente de la librería. La gramática de filtros y los helpers de mes-año son independientes de React.
 
 La utilidad `cn`, también exportada desde `beez-ui`, usa el paquete `cn` para combinar clases condicionales y resolver conflictos de Tailwind.
-
-```css
-@import "beez-ui/styles.css";
-```
-
-`beez-ui/styles.css` es CSS listo para el navegador: incluye reset, utilidades, tema claro/oscuro, radios y fuentes locales Geist, Poppins e IBM Plex Mono. No requiere Tailwind, plugins PostCSS ni declaraciones `@source` en el consumidor. Las clases se compilan en el build de la biblioteca y se publican en `dist/styles.css`; `styles.source.css` es la entrada de desarrollo y no se distribuye.
-
+
+```css
+@import "beez-ui/styles.css";
+```
+
+`beez-ui/styles.css` es CSS listo para el navegador: incluye reset, utilidades, tema claro/oscuro, radios y fuentes locales Geist, Poppins e IBM Plex Mono. No requiere Tailwind, plugins PostCSS ni declaraciones `@source` en el consumidor. Las clases se compilan en el build de la biblioteca y se publican en `dist/styles.css`; `styles.source.css` es la entrada de desarrollo y no se distribuye.
+
 Los consumidores pueden sobrescribir tokens mediante CSS normal. Poppins se reserva para títulos grandes mediante `--font-display`; las licencias se incluyen en `assets/fonts`. Si la aplicación usa Tailwind para sus propios estilos puede mantenerlo, pero ya no necesita escanear beez-ui.
 
 `DropdownMenuContent` toma el ancho natural de sus opciones, con un mínimo de 12 rem y un máximo limitado por el espacio disponible. No hereda el ancho del botón disparador: los menús abiertos desde un icono deben mantener sus etiquetas legibles. Para un ancho específico, usar `className` y ajustar también el mínimo cuando se necesite un menú más pequeño.
@@ -54,7 +54,7 @@ Los consumidores pueden sobrescribir tokens mediante CSS normal. Poppins se rese
 Los componentes usan por defecto los espaciados compactos de Agenda: `Select` mide 2 rem (1.75 rem en tamaño pequeño), `TabsList` horizontal mide 2 rem y `PopoverContent` usa 0.625 rem de padding. Los menús y submenús tienen un mínimo de 12 rem, con filas compactas. `Dialog` y `AlertDialog` usan 1 rem de padding y un footer con borde superior y fondo diferenciado; `Textarea` distingue el estado deshabilitado mediante su fondo. Estos valores conservan los colores y fuentes del tema compartido. Son cambios de los defaults, sin una prop adicional para activarlos; los consumidores pueden personalizarlos mediante `className`.
 
 Los `Sheet` superiores e inferiores limitan su altura al viewport dinámico (`100dvh`) y permiten desplazar el contenido para mantener accesibles las acciones de paneles largos.
-
+
 ## Movimiento
 
 Las nuevas animaciones usan la dependencia `motion`: `animate` controla la
@@ -63,11 +63,34 @@ retienen los overlays durante su salida. Los presets y tiempos viven en
 `src/motion/`. No se usan keyframes CSS para estas animaciones.
 
 `MotionSlot` anima el nodo original del primitive mediante refs compuestos,
-sin agregar wrappers al DOM ni reemplazar sus handlers. Las pulsaciones reducen
-la escala a 0.98; cards y enlaces responden al hover; campos e indicadores
-responden al foco y la selección. Menús, popovers, diálogos y sheets usan entradas
-cortas y salidas de 120 ms. El skeleton pulsa con Motion. Las animaciones
-especializadas existentes de Embla, Sonner y rough-notation se conservan.
+sin agregar wrappers al DOM ni reemplazar sus handlers. Las curvas y springs
+siguen los tokens de [beui motion](https://beui.dev/components/motion):
+
+- `Button` se comprime con spring a 0.93 y se eleva a 1.02 al hover, solo en
+  dispositivos con hover real (`(hover: hover) and (pointer: fine)`); los ítems de
+  `Sidebar` y `Tabs` se comprimen a 0.98.
+- `Checkbox` y `RadioGroup` se comprimen a 0.92. La marca del checkbox aparece
+  con pop y trazo (`pathLength`) y sale con blur; el punto del radio aparece con spring.
+- El thumb de `Switch` viaja con un spring pesado y se aplasta mientras se presiona.
+- `Input`, `Textarea`, `InputGroup` y `SelectTrigger` tiemblan al pasar a
+  `aria-invalid="true"`; `FormMessage` entra con blur.
+- `Tooltip` entra con blur, escala y desplazamiento desde el trigger.
+  `Popover`, `HoverCard`, `DropdownMenu` y `Select` escalan desde 0.96 y se revelan
+  con un clip desde la esquina más cercana al trigger.
+- `Dialog` y `AlertDialog` suben con spring; `Sheet` entra desde su borde con spring.
+- `GlideSlot` desliza el indicador activo entre ítems como un `layoutId` compartido:
+  la pestaña activa de `Tabs` (fondo o subrayado), el ítem activo de `SidebarMenu` y
+  el ítem resaltado de `DropdownMenu` y `Select`, también con teclado. Una copia
+  transitoria viaja entre ítems y se elimina al llegar, devolviendo el estilo al ítem.
+- El chevron de `SelectTrigger` gira 180° al abrir y los chevrons de `DataTable`
+  (grupos y columnas) giran en lugar de cambiar de ícono; CSS define el ángulo final.
+- Las opciones del `Select` entran escalonadas con blur (las primeras 10; el resto
+  solo se desvanece) y los checks de ítems de `Select` y `DropdownMenu` aparecen con pop.
+- El ícono de `AnimatedThemeToggler` cambia con blur y escala; el botón de cierre de
+  `Dialog` aparece con un pop demorado.
+- El contenido de `Tabs` entra con un desplazamiento de 4 px. Cards y enlaces
+  responden al hover. El skeleton pulsa con Motion. Las animaciones especializadas
+  existentes de Embla, Sonner y rough-notation se conservan.
 
 El contenido que está saliendo deja de ser interactivo y accesible de inmediato.
 Cada familia de overlays tiene un contexto de visibilidad independiente para
@@ -88,136 +111,136 @@ la reproducción. Las stories permiten probar los gestos y estados reales; el
 selector de tema de la story y la barra de Storybook se mantienen sincronizados.
 
 ## Providers de UI
-
-Elegir un único `BeezUIProvider` según el framework. Los componentes y `useTheme` siempre se importan desde `beez-ui`.
-
-| Import del provider | Navegación | Imágenes de avatar |
-| --- | --- | --- |
-| `beez-ui` | Anclas nativas | `@unpic/react` |
-| `beez-ui/next` | `next/link` | `next/image` |
-| `beez-ui/tanstack` | TanStack Router | `@unpic/react` |
-
-```tsx
-"use client";
-
-import type { ReactNode } from "react";
-import { BeezUIProvider } from "beez-ui/next";
-
-export function Providers({ children }: { children: ReactNode }) {
-  return (
-    <BeezUIProvider themeOptions={{ storageKey: "tutribu-theme", defaultTheme: "system" }}>
-      {children}
-    </BeezUIProvider>
-  );
-}
-```
-
-Todos los providers usan `next-themes` con clases CSS. El consumidor configura `themeOptions` y conecta sus controles a `useTheme` desde `beez-ui`. Al migrar una aplicación, conservar su clave de almacenamiento y retirar los scripts y estados anteriores que modifiquen el tema. En Next, mantener `suppressHydrationWarning` en el elemento `html` porque el provider restaura la preferencia antes de hidratar.
-
-El provider de Next desactiva prefetch y optimización de imágenes por defecto, como LaTribu. Se activan con `prefetch` y `optimizeImages`; para optimizar imágenes remotas hay que configurar sus hosts en la app. `Link` y los enlaces de paginación usan el adaptador del provider. El contrato común de `Link` acepta href como string y atributos de ancla, no todas las opciones exclusivas de Next.
-
-El provider de TanStack se monta dentro del router de la aplicación. Preserva query y hash; `prefetch` activa precarga por intención. TanStack no aporta un componente Image propio: Unpic genera variantes responsivas para CDNs compatibles y conserva las URLs que no reconoce; no instala un servidor de optimización.
-
-Next y TanStack Router son peers opcionales aislados en sus entrypoints. El provider nativo admite overrides mediante `components`. Sin provider, los componentes conservan anclas e imágenes HTML como fallback.
-
-## Responsabilidades del consumidor
-
-- Tema: `AnimatedThemeToggler` y `ThemedToaster` consumen el contexto compartido. Sus props explícitas de tema siguen disponibles para usos controlados.
-- Navegación: `PaginationNext`, `PaginationPrevious` y `PaginationLink` usan anclas nativas. El prop opcional `component` admite el adaptador del router que elija la app. Sin proveedor usa el elemento nativo; con el proveedor de Next usa su navegación cliente.
-- Sidebar: `defaultOpen` y el modo controlado conservan la semántica de LaTribu. `storageKey` activa opcionalmente persistencia local segura tras hidratar, sin cambiar la cookie pública `sidebar_state` ni sus siete días de duración.
-- Formularios y tablas: el consumidor provee sus datos, validaciones y callbacks. No se importan servicios, modelos de negocio ni endpoints de agenda-mensual.
-
-## Componentes incorporados desde agenda-mensual
-
+
+Elegir un único `BeezUIProvider` según el framework. Los componentes y `useTheme` siempre se importan desde `beez-ui`.
+
+| Import del provider | Navegación | Imágenes de avatar |
+| --- | --- | --- |
+| `beez-ui` | Anclas nativas | `@unpic/react` |
+| `beez-ui/next` | `next/link` | `next/image` |
+| `beez-ui/tanstack` | TanStack Router | `@unpic/react` |
+
+```tsx
+"use client";
+
+import type { ReactNode } from "react";
+import { BeezUIProvider } from "beez-ui/next";
+
+export function Providers({ children }: { children: ReactNode }) {
+  return (
+    <BeezUIProvider themeOptions={{ storageKey: "tutribu-theme", defaultTheme: "system" }}>
+      {children}
+    </BeezUIProvider>
+  );
+}
+```
+
+Todos los providers usan `next-themes` con clases CSS. El consumidor configura `themeOptions` y conecta sus controles a `useTheme` desde `beez-ui`. Al migrar una aplicación, conservar su clave de almacenamiento y retirar los scripts y estados anteriores que modifiquen el tema. En Next, mantener `suppressHydrationWarning` en el elemento `html` porque el provider restaura la preferencia antes de hidratar.
+
+El provider de Next desactiva prefetch y optimización de imágenes por defecto, como LaTribu. Se activan con `prefetch` y `optimizeImages`; para optimizar imágenes remotas hay que configurar sus hosts en la app. `Link` y los enlaces de paginación usan el adaptador del provider. El contrato común de `Link` acepta href como string y atributos de ancla, no todas las opciones exclusivas de Next.
+
+El provider de TanStack se monta dentro del router de la aplicación. Preserva query y hash; `prefetch` activa precarga por intención. TanStack no aporta un componente Image propio: Unpic genera variantes responsivas para CDNs compatibles y conserva las URLs que no reconoce; no instala un servidor de optimización.
+
+Next y TanStack Router son peers opcionales aislados en sus entrypoints. El provider nativo admite overrides mediante `components`. Sin provider, los componentes conservan anclas e imágenes HTML como fallback.
+
+## Responsabilidades del consumidor
+
+- Tema: `AnimatedThemeToggler` y `ThemedToaster` consumen el contexto compartido. Sus props explícitas de tema siguen disponibles para usos controlados.
+- Navegación: `PaginationNext`, `PaginationPrevious` y `PaginationLink` usan anclas nativas. El prop opcional `component` admite el adaptador del router que elija la app. Sin proveedor usa el elemento nativo; con el proveedor de Next usa su navegación cliente.
+- Sidebar: `defaultOpen` y el modo controlado conservan la semántica de LaTribu. `storageKey` activa opcionalmente persistencia local segura tras hidratar, sin cambiar la cookie pública `sidebar_state` ni sus siete días de duración.
+- Formularios y tablas: el consumidor provee sus datos, validaciones y callbacks. No se importan servicios, modelos de negocio ni endpoints de agenda-mensual.
+
+## Componentes incorporados desde agenda-mensual
+
 `Alert`, `AnimatedThemeToggler`, `Calendar`, `DataTable`, `FilterQueryBar`, `Form`, `Highlighter`, `InputGroup`, `Label`, `RadioGroup`, `TypingAnimation` y `ThemedToaster`, junto con sus subcomponentes, tipos y gramática de filtros.
 
 `FilterQueryBar` mantiene el foco en el input mientras se recorren las sugerencias con el puntero o las flechas. Enter aplica la opción activa; interactuar con el input no cierra la lista.
-
-La tabla conserva agrupación estable, columnas configurables, memoización, exclusiones y sincronización de qualifiers por identificadores. La barra conserva navegación por teclado, autocompletado y filtros de texto, rangos, fechas, presencia y carpetas. `Calendar` usa español por defecto y acepta otra locale. Los textos y configuraciones de filtros se pueden personalizar por props.
-
-Los componentes compartidos conservan el tema de LaTribu. Se incorporaron atributos `data-variant`/`data-size` del botón, scroll para paneles largos y persistencia opcional del sidebar. Se mantienen `Button.asChild`, estados deshabilitados y skeletons deterministas. `AvatarImage` delega carga y fallback a Base UI; conserva carga diferida y recuperación al cambiar `src`. El export original `Toaster` permanece disponible; `ThemedToaster` agrega los estilos e iconos compartidos.
-
-## React Compiler
-
-El build usa el port de React Compiler en Rust de [Oxc](https://oxc.rs/blog/2026-08-18-react-compiler-support), mediante `oxc-transform-react`. Esta integración sigue marcada como experimental por Oxc.
-
-Las optimizaciones se incluyen en el JavaScript publicado: el consumidor no necesita habilitar React Compiler en Vite, Next ni otro bundler. El target es React 19 y utiliza `react/compiler-runtime`, incluido en el peer React 19.2; no se añade un runtime independiente.
-
-TypeScript 7 valida los tipos y genera las declaraciones. Oxc recibe los fuentes originales y ejecuta React Compiler antes de eliminar TypeScript y transformar JSX. Conserva ESM, los exports y las directivas de cliente. Sólo los módulos cuyo prólogo declara `"use client"` reciben memoización automática; los módulos compatibles con Server Components se emiten sin cachés de cliente. Esto evita introducir hooks del runtime de cliente en el render servidor de Next.
-
-La cobertura depende de las heurísticas del compilador y de las reglas de React: algunas funciones conservan su implementación sin optimizar. Las memoizaciones y comentarios del código fuente permanecen intactos. El build informa cuántos módulos incluyen memoización automática y falla ante errores fatales de transformación.
-
-```sh
-# Comparar el comportamiento sin memoización automática.
-pnpm test:uncompiled
-
-# Volver a generar la distribución optimizada.
-pnpm build
-```
-
-`test:uncompiled` usa `pnpm build --no-react-compiler` y ejecuta Vitest. CI y `release:prepare` ejecutan esa comparación antes del check normal, que restaura el build optimizado. Los consumidores de prueba no habilitan un segundo compilador: ejercen el paquete generado, incluido un componente de servidor real en Next.
-
-## Desarrollo y validación
-
-Usar pnpm **12.3.4**. Las dependencias tienen rangos `^` y el lockfile fija las versiones verificadas.
-
-```sh
-pnpm install --frozen-lockfile
-pnpm check
-pnpm exec playwright install chromium webkit
-pnpm test:browser
-pnpm build
-pnpm release:prepare
-```
-
-`pnpm build` genera las declaraciones con TypeScript 7, JavaScript con Oxc/React Compiler y CSS con el CLI de Tailwind. `pnpm check` ejecuta ESLint 10, los typechecks separados de código y tests con TypeScript 7, y Vitest 5. `tests/tsconfig.json` incorpora los matchers de Testing Library y los tipos de Vite sin incluirlos en el código de producción. `test:browser` verifica una app React/Vite nativa y una app Next real en Chromium y WebKit, tanto en desktop como en móvil. Los tests unitarios importan los archivos compilados. Los consumidores de navegador no instalan plugins de Tailwind, y una prueba adicional sirve el tarball por HTTP sin procesadores CSS para verificar estilos computados y carga de fuentes. Una prueba adicional instala el tarball en un consumidor aislado sin Next y verifica render, filtrado y declaraciones públicas.
-
-Los tests resuelven `beez-ui`, `beez-ui/next` y `beez-ui/tanstack` mediante rutas explícitas a las declaraciones compiladas en `tests/tsconfig.json`. Ejecutar `pnpm build` después de clonar o si falta `dist`; los comandos de validación completos ya lo hacen. Si el editor conserva diagnósticos anteriores después del build, reiniciar su servidor de TypeScript.
-
-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.
-
-## Crear y publicar una versión
-
-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:
-
-```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, tests sin React Compiler, build optimizado 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. Crea un commit con el contenido validado de `package.json` y `CHANGELOG.md`, conservando otros archivos staged, y pushea ese commit a la rama upstream configurada.
-5. 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 requiere una rama Git con upstream configurado. 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, el commit o el push, no publica. Los metadatos de la nueva versión quedan disponibles: corregir el error, ejecutar `pnpm release:prepare`, commitear y pushear los metadatos y publicar el artefacto resultante. Si falla el push después del commit, resolver el problema y pushear ese commit antes de publicar el tarball preparado. 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
-```
-
-`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 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.
-
-## Procedencia
-
-Fuentes originales: `guidomodarelli/TuTribu` (`components/ui`) y `agenda-mensual` (`src/components/ui`). Se preservan las funcionalidades y los comentarios que explican sus decisiones; la integración adapta imports, contratos y dependencias del consumidor. Consultar `LICENSE.md` para la licencia original de shadcn/ui y `assets/fonts/*-LICENSE.txt` para las fuentes. El icono de WhatsApp proviene del registry `@svgl`.
+
+La tabla conserva agrupación estable, columnas configurables, memoización, exclusiones y sincronización de qualifiers por identificadores. La barra conserva navegación por teclado, autocompletado y filtros de texto, rangos, fechas, presencia y carpetas. `Calendar` usa español por defecto y acepta otra locale. Los textos y configuraciones de filtros se pueden personalizar por props.
+
+Los componentes compartidos conservan el tema de LaTribu. Se incorporaron atributos `data-variant`/`data-size` del botón, scroll para paneles largos y persistencia opcional del sidebar. Se mantienen `Button.asChild`, estados deshabilitados y skeletons deterministas. `AvatarImage` delega carga y fallback a Base UI; conserva carga diferida y recuperación al cambiar `src`. El export original `Toaster` permanece disponible; `ThemedToaster` agrega los estilos e iconos compartidos.
+
+## React Compiler
+
+El build usa el port de React Compiler en Rust de [Oxc](https://oxc.rs/blog/2026-08-18-react-compiler-support), mediante `oxc-transform-react`. Esta integración sigue marcada como experimental por Oxc.
+
+Las optimizaciones se incluyen en el JavaScript publicado: el consumidor no necesita habilitar React Compiler en Vite, Next ni otro bundler. El target es React 19 y utiliza `react/compiler-runtime`, incluido en el peer React 19.2; no se añade un runtime independiente.
+
+TypeScript 7 valida los tipos y genera las declaraciones. Oxc recibe los fuentes originales y ejecuta React Compiler antes de eliminar TypeScript y transformar JSX. Conserva ESM, los exports y las directivas de cliente. Sólo los módulos cuyo prólogo declara `"use client"` reciben memoización automática; los módulos compatibles con Server Components se emiten sin cachés de cliente. Esto evita introducir hooks del runtime de cliente en el render servidor de Next.
+
+La cobertura depende de las heurísticas del compilador y de las reglas de React: algunas funciones conservan su implementación sin optimizar. Las memoizaciones y comentarios del código fuente permanecen intactos. El build informa cuántos módulos incluyen memoización automática y falla ante errores fatales de transformación.
+
+```sh
+# Comparar el comportamiento sin memoización automática.
+pnpm test:uncompiled
+
+# Volver a generar la distribución optimizada.
+pnpm build
+```
+
+`test:uncompiled` usa `pnpm build --no-react-compiler` y ejecuta Vitest. CI y `release:prepare` ejecutan esa comparación antes del check normal, que restaura el build optimizado. Los consumidores de prueba no habilitan un segundo compilador: ejercen el paquete generado, incluido un componente de servidor real en Next.
+
+## Desarrollo y validación
+
+Usar pnpm **12.3.4**. Las dependencias tienen rangos `^` y el lockfile fija las versiones verificadas.
+
+```sh
+pnpm install --frozen-lockfile
+pnpm check
+pnpm exec playwright install chromium webkit
+pnpm test:browser
+pnpm build
+pnpm release:prepare
+```
+
+`pnpm build` genera las declaraciones con TypeScript 7, JavaScript con Oxc/React Compiler y CSS con el CLI de Tailwind. `pnpm check` ejecuta ESLint 10, los typechecks separados de código y tests con TypeScript 7, y Vitest 5. `tests/tsconfig.json` incorpora los matchers de Testing Library y los tipos de Vite sin incluirlos en el código de producción. `test:browser` verifica una app React/Vite nativa y una app Next real en Chromium y WebKit, tanto en desktop como en móvil. Los tests unitarios importan los archivos compilados. Los consumidores de navegador no instalan plugins de Tailwind, y una prueba adicional sirve el tarball por HTTP sin procesadores CSS para verificar estilos computados y carga de fuentes. Una prueba adicional instala el tarball en un consumidor aislado sin Next y verifica render, filtrado y declaraciones públicas.
+
+Los tests resuelven `beez-ui`, `beez-ui/next` y `beez-ui/tanstack` mediante rutas explícitas a las declaraciones compiladas en `tests/tsconfig.json`. Ejecutar `pnpm build` después de clonar o si falta `dist`; los comandos de validación completos ya lo hacen. Si el editor conserva diagnósticos anteriores después del build, reiniciar su servidor de TypeScript.
+
+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.
+
+## Crear y publicar una versión
+
+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:
+
+```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, tests sin React Compiler, build optimizado 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. Crea un commit con el contenido validado de `package.json` y `CHANGELOG.md`, conservando otros archivos staged, y pushea ese commit a la rama upstream configurada.
+5. 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 requiere una rama Git con upstream configurado. 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, el commit o el push, no publica. Los metadatos de la nueva versión quedan disponibles: corregir el error, ejecutar `pnpm release:prepare`, commitear y pushear los metadatos y publicar el artefacto resultante. Si falla el push después del commit, resolver el problema y pushear ese commit antes de publicar el tarball preparado. 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
+```
+
+`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 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.
+
+## Procedencia
+
+Fuentes originales: `guidomodarelli/TuTribu` (`components/ui`) y `agenda-mensual` (`src/components/ui`). Se preservan las funcionalidades y los comentarios que explican sus decisiones; la integración adapta imports, contratos y dependencias del consumidor. Consultar `LICENSE.md` para la licencia original de shadcn/ui y `assets/fonts/*-LICENSE.txt` para las fuentes. El icono de WhatsApp proviene del registry `@svgl`.

package/dist/components/animated-theme-toggler.js

@@ -3,10 +3,11 @@ import { c as _c } from "react/compiler-runtime";
 import { useEffect, useRef, useSyncExternalStore } from "react";
 import { Monitor, Moon, Sun, SunMoon } from "lucide-react";
 import { animate, frame } from "motion/react";
+import { MotionSlot } from "../motion/motion-slot.js";
 import { MOTION_EASE } from "../motion/tokens.js";
 import { useTheme } from "next-themes";
 import { DropdownMenu, DropdownMenuContent, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuTrigger } from "./dropdown-menu.js";
-import { REDUCED_MOTION_QUERY } from "../constants/motion.js";
+import { MILLISECONDS_PER_SECOND, REDUCED_MOTION_QUERY } from "../constants/motion.js";
 import { cn } from "../lib/utils.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const THEME_OPTIONS = [
@@ -26,8 +27,6 @@ const THEME_OPTIONS = [
 		value: "system"
 	}
 ];
-/** Converts the public duration (milliseconds) to Motion seconds. */
-const MILLISECONDS_PER_SECOND = 1e3;
 export const AnimatedThemeToggler = (t0) => {
 	const $ = _c(34);
 	let className;
@@ -134,7 +133,10 @@ export const AnimatedThemeToggler = (t0) => {
 	}
 	let t6;
 	if ($[16] !== isDark || $[17] !== isThemeReady) {
-		t6 = !isThemeReady ? /* @__PURE__ */ _jsx(SunMoon, { "aria-hidden": "true" }) : isDark ? /* @__PURE__ */ _jsx(Moon, { "aria-hidden": "true" }) : /* @__PURE__ */ _jsx(Sun, { "aria-hidden": "true" });
+		t6 = !isThemeReady ? /* @__PURE__ */ _jsx(SunMoon, { "aria-hidden": "true" }) : /* @__PURE__ */ _jsx(MotionSlot, {
+			kind: "icon-swap",
+			children: isDark ? /* @__PURE__ */ _jsx(Moon, { "aria-hidden": "true" }) : /* @__PURE__ */ _jsx(Sun, { "aria-hidden": "true" })
+		}, isDark ? "dark" : "light");
 		$[16] = isDark;
 		$[17] = isThemeReady;
 		$[18] = t6;

package/dist/components/checkbox.js

@@ -30,10 +30,11 @@ function Checkbox(t0) {
 	let t2;
 	if ($[5] === Symbol.for("react.memo_cache_sentinel")) {
 		t2 = /* @__PURE__ */ _jsx(MotionSlot, {
-			kind: "selection",
+			kind: "check",
 			children: /* @__PURE__ */ _jsx(CheckboxPrimitive.Indicator, {
+				forceMount: true,
 				"data-slot": "checkbox-indicator",
-				className: "grid place-content-center text-current transition-none [&>svg]:size-3.5",
+				className: "grid place-content-center text-current transition-none data-unchecked:opacity-0 [&>svg]:size-3.5",
 				children: /* @__PURE__ */ _jsx(CheckIcon, {})
 			})
 		});
@@ -44,7 +45,7 @@ function Checkbox(t0) {
 	let t3;
 	if ($[6] !== props || $[7] !== t1) {
 		t3 = /* @__PURE__ */ _jsx(MotionSlot, {
-			kind: "field",
+			kind: "toggle",
 			children: /* @__PURE__ */ _jsx(CheckboxPrimitive.Root, {
 				"data-slot": "checkbox",
 				className: t1,

package/dist/components/data-table.js

@@ -2,6 +2,8 @@
 import * as React from "react";
 import { flexRender, getCoreRowModel, getFilteredRowModel, getSortedRowModel, useReactTable } from "@tanstack/react-table";
 import { CircleAlert, ChevronDown, ChevronRight, Ellipsis, Eraser, X } from "lucide-react";
+import { cn } from "../lib/utils.js";
+import { MotionSlot } from "../motion/motion-slot.js";
 import { Button } from "./button.js";
 import { Badge } from "./badge.js";
 import { FilterQueryBar } from "./filter-query-bar.js";
@@ -510,12 +512,12 @@ export function DataTable({ columns, data, emptyMessage, toolbarActions, onVisib
 								className: "flex w-full items-center gap-1.5 text-left",
 								onClick: () => handleGroupToggle(groupKey),
 								type: "button",
-								children: [isGroupCollapsed ? /* @__PURE__ */ _jsx(ChevronRight, {
-									"aria-hidden": "true",
-									className: "size-4 shrink-0"
-								}) : /* @__PURE__ */ _jsx(ChevronDown, {
-									"aria-hidden": "true",
-									className: "size-4 shrink-0"
+								children: [/* @__PURE__ */ _jsx(MotionSlot, {
+									kind: "rotate",
+									children: /* @__PURE__ */ _jsx(ChevronRight, {
+										"aria-hidden": "true",
+										className: cn("size-4 shrink-0", !isGroupCollapsed && "rotate-90")
+									})
 								}), groupHeaderContent]
 							}) : groupHeaderContent
 						})
@@ -765,12 +767,18 @@ export function DataTable({ columns, data, emptyMessage, toolbarActions, onVisib
 						asChild: true,
 						children: /* @__PURE__ */ _jsxs(Button, {
 							"aria-label": columnVisibilityButtonLabel,
-							className: "relative",
+							className: "relative aria-expanded:*:data-[slot=data-table-columns-chevron]:rotate-180",
 							type: "button",
 							variant: "outline",
 							children: [
 								columnVisibilityButtonLabel,
-								/* @__PURE__ */ _jsx(ChevronDown, { "aria-hidden": "true" }),
+								/* @__PURE__ */ _jsx(MotionSlot, {
+									kind: "rotate",
+									children: /* @__PURE__ */ _jsx(ChevronDown, {
+										"aria-hidden": "true",
+										"data-slot": "data-table-columns-chevron"
+									})
+								}),
 								hasToolbarChanges ? /* @__PURE__ */ _jsxs(_Fragment, { children: [/* @__PURE__ */ _jsx("span", {
 									"aria-hidden": "true",
 									className: "absolute -right-0.5 -top-0.5 size-2 rounded-full bg-destructive ring-2 ring-background"

package/dist/components/dialog.js

@@ -203,14 +203,17 @@ function DialogContent(t0) {
 		t5 = showCloseButton && /* @__PURE__ */ _jsx(DialogPrimitive.Close, {
 			"data-slot": "dialog-close",
 			asChild: true,
-			children: /* @__PURE__ */ _jsxs(Button, {
-				variant: "ghost",
-				className: "absolute top-2 right-2",
-				size: "icon-sm",
-				children: [/* @__PURE__ */ _jsx(XIcon, {}), /* @__PURE__ */ _jsx("span", {
-					className: "sr-only",
-					children: "Cerrar"
-				})]
+			children: /* @__PURE__ */ _jsx(MotionSlot, {
+				kind: "delayed-pop",
+				children: /* @__PURE__ */ _jsxs(Button, {
+					variant: "ghost",
+					className: "absolute top-2 right-2",
+					size: "icon-sm",
+					children: [/* @__PURE__ */ _jsx(XIcon, {}), /* @__PURE__ */ _jsx("span", {
+						className: "sr-only",
+						children: "Cerrar"
+					})]
+				})
 			})
 		});
 		$[8] = showCloseButton;