beez-ui 0.4.2 → 0.5.1

package/CHANGELOG.md

@@ -1,34 +1,42 @@
 # Cambios
 
-## 0.4.2 - 2026-09-08
+## 0.5.1 - 2026-09-08
 
-- Actualiza el paquete a la versión 0.4.2.
+- Actualiza el paquete a la versión 0.5.1.
 
-## 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
+## 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.

package/README.md

@@ -16,7 +16,9 @@ Agrupar los imports de componentes desde la raíz. El paquete publica JavaScript
 
 `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.
+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.
 
 ## Providers de UI
 
@@ -66,6 +68,26 @@ La tabla conserva agrupación estable, columnas configurables, memoización, exc
 
 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.
@@ -79,7 +101,7 @@ pnpm build
 pnpm release:prepare
 ```
 
-`pnpm build` compila JavaScript, declaraciones 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.
+`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.
 
@@ -100,13 +122,14 @@ Acepta `patch`, `minor`, `major` o una versión estable explícita mayor que la
 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.
+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. Publica ese mismo artefacto en npm con acceso público y etiqueta `latest`.
+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 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.
+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:
 

package/dist/adapters/unpic-image.js

@@ -1,20 +1,98 @@
 "use client";
-import { jsx as _jsx } from "react/jsx-runtime";
+import { c as _c } from "react/compiler-runtime";
 /** Uses Unpic for responsive images without coupling the native adapter to a framework. */
 import { Image } from "@unpic/react";
 import { imageDimension } from "../lib/image-dimensions.js";
+import { jsx as _jsx } from "react/jsx-runtime";
 /** Preserves browser events and consumer styles while deriving responsive image sources. */
-export function UnpicImageAdapter({ src, width, height, style, ...props }) {
-    if (!src)
-        return _jsx("img", { ...props, width: width, height: height, style: style });
-    // Unpic merges style overrides at runtime; its 1.x React declarations omit that field.
-    const imageProps = {
-        ...props,
-        src,
-        width: imageDimension(width),
-        height: imageDimension(height),
-        layout: "constrained",
-        style: { maxWidth: "100%", maxHeight: "100%", ...style },
-    };
-    return _jsx(Image, { ...imageProps });
+export function UnpicImageAdapter(t0) {
+	const $ = _c(23);
+	let height;
+	let props;
+	let src;
+	let style;
+	let width;
+	if ($[0] !== t0) {
+		({src, width, height, style, ...props} = t0);
+		$[0] = t0;
+		$[1] = height;
+		$[2] = props;
+		$[3] = src;
+		$[4] = style;
+		$[5] = width;
+	} else {
+		height = $[1];
+		props = $[2];
+		src = $[3];
+		style = $[4];
+		width = $[5];
+	}
+	if (!src) {
+		let t1;
+		if ($[6] !== height || $[7] !== props || $[8] !== style || $[9] !== width) {
+			t1 = /* @__PURE__ */ _jsx("img", {
+				...props,
+				width,
+				height,
+				style
+			});
+			$[6] = height;
+			$[7] = props;
+			$[8] = style;
+			$[9] = width;
+			$[10] = t1;
+		} else {
+			t1 = $[10];
+		}
+		return t1;
+	}
+	let t1;
+	if ($[11] !== width) {
+		t1 = imageDimension(width);
+		$[11] = width;
+		$[12] = t1;
+	} else {
+		t1 = $[12];
+	}
+	let t2;
+	if ($[13] !== height) {
+		t2 = imageDimension(height);
+		$[13] = height;
+		$[14] = t2;
+	} else {
+		t2 = $[14];
+	}
+	let t3;
+	if ($[15] !== style) {
+		t3 = {
+			maxWidth: "100%",
+			maxHeight: "100%",
+			...style
+		};
+		$[15] = style;
+		$[16] = t3;
+	} else {
+		t3 = $[16];
+	}
+	let t4;
+	if ($[17] !== props || $[18] !== src || $[19] !== t1 || $[20] !== t2 || $[21] !== t3) {
+		const imageProps = {
+			...props,
+			src,
+			width: t1,
+			height: t2,
+			layout: "constrained",
+			style: t3
+		};
+		t4 = /* @__PURE__ */ _jsx(Image, { ...imageProps });
+		$[17] = props;
+		$[18] = src;
+		$[19] = t1;
+		$[20] = t2;
+		$[21] = t3;
+		$[22] = t4;
+	} else {
+		t4 = $[22];
+	}
+	return t4;
 }