beez-ui 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,26 +1,38 @@
 # Cambios
 
-## 0.4.0 - 2026-09-08
+## 0.5.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.
+- Actualiza el paquete a la versión 0.5.0.
 
-## 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.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

@@ -66,6 +66,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,32 +99,50 @@ 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.
 
 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, 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`.
+
+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/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;
 }