reactigoded 1.0.0-beta.26

package/CHANGELOG.md

@@ -0,0 +1,3001 @@
+# Changelog
+
+Todos los cambios notables de este paquete se documentan aquí.
+
+Formato basado en [Keep a Changelog](https://keepachangelog.com/),
+versionado [SemVer](https://semver.org/lang/es/).
+
+## [Unreleased]
+
+### Cambiado — BREAKING (última ventana antes de 1.0)
+
+- Renombres de API pública para eliminar colisiones de nombre antes de congelar 1.0:
+  - Clases `.ig-tooltip-color-*` → `.ig-tooltip-*` (el infijo `-color-` era dialecto local; la doc ya prometía la forma sin él).
+  - Clase `.ig-navbar-brand` → `.ig-navbar-logo` y componente `NavbarBrand` → `NavbarLogo` (`brand` colisionaba con el eje de rol de color; el slot es el logo).
+  - Clases `.ig-input-error`/`.ig-input-success` → `.ig-input-invalid`/`.ig-input-valid` y valores del prop `state` (`"invalid"`/`"valid"`), alineados con `aria-invalid`.
+
+### Añadido
+
+- **Garantía `@server-safe` validada contra Vercel Edge REAL (#18)**: el catálogo de globals permitidos se medía contra `@edge-runtime/vm` (sandbox sobre Node que filtra globals Node-shared, ~95% fiel). Un probe de deploy real a Vercel Edge producción (`scripts/runtime-oracle/vercel/`, `typeof <bare>` — el único test fiel dado que el objeto-global de Edge es exótico) cerró ese ~5%: **3 globals que `@edge-runtime/vm` reportaba presentes por fuga de Node (`WeakRef`, `FinalizationRegistry`, `DOMException`) NO existen en Vercel Edge real** → restados de `SAFE_GLOBALS` (nuevo set `EDGE_MISSING_REAL`). Cierra un falso-negativo latente (0 módulos los usaban) que habría dejado pasar un `new WeakRef(...)` bare que crashea en producción Edge. Premisas del catálogo (createObjectURL/WASM/eval/elu) confirmadas 6/6 en el Edge real.
+- **Freeze de API pública (§5.13)**: la superficie estable de 1.0 (clases de componente, data-attributes de estado, tokens Tier-2) se congela en `src/_audit/public-api-names.json`, protegida por el gate `scripts/check-public-api-names.mjs` (`⊆ dist`, encadenado en `verify:unit`). Editar el freeze exige bump MAJOR. La capa utility (`state.css`) y los tokens Tier-1/Tier-3 quedan fuera del freeze **por declaración explícita** (ver CSSAPI.mdx + DesignTokens.mdx).
+
+## [1.0.0-beta.26] — 2026-05-29 (bloque claudegate5 / beta.27 cerrado)
+
+Cierra el bloque **claudegate5 / beta.27** (25 PRs entre #105 y
+#129) con 3 ejes principales:
+
+- **Slot pattern DS-wide (D14)**: refactor `asChild` en las 4
+  familias con triggers (Dialog / AlertDialog / Tooltip / Menu).
+  Patrón canónico Radix/shadcn habilitado en todo el DS.
+- **EOPT widening completo (#155)**: 307 props públicas opcionales
+  ensanchadas a `?: T | undefined` para consumers con
+  `exactOptionalPropertyTypes: true`. 2 fronteras documentadas
+  explícitamente (sección final del bloque).
+- **Red de seguridad cross-platform (#151)**: matriz CI 4 combos
+  (ubuntu/windows × Node 22.12/24), test catálogo `CLIENT_GLOBALS`
+  vs Node runtime (#150), gates de payload reales (#160), peer
+  `@floating-ui/react ^0.27` pre-1.0 documentado (#156).
+
+Tras este release queda el gate review claudegate6 (auditoría AI con
+cruce A+B de dos auditores independientes) antes de tagear
+`1.0.0-rc.1` (API congelada para 1.x). beta.26 puede aún recibir bug
+fixes o ajustes pre-rc.1 si el gate identifica blockers.
+
+
+### BREAKING (D14 Bloque B beta.27)
+
+- **`DialogAction` ELIMINADO**. El patrón canónico para CTAs del footer
+  ahora es `<DialogClose asChild>` con un `<Button>` del consumer como
+  child. Migración:
+
+  ```diff
+   <DialogFooter>
+  -  <DialogAction className="ig-btn ig-btn-secondary">Cancelar</DialogAction>
+  -  <DialogAction className="ig-btn ig-btn-brand">Aceptar</DialogAction>
+  +  <DialogClose asChild>
+  +    <Button variant="secondary">Cancelar</Button>
+  +  </DialogClose>
+  +  <DialogClose asChild>
+  +    <Button variant="brand">Aceptar</Button>
+  +  </DialogClose>
+   </DialogFooter>
+  ```
+
+  Cierra la asimetría léxica `DialogClose styled / DialogAction unstyled /
+  AlertDialogClose clónico` identificada en el cruce reviews beta.25.
+
+- **`AlertDialogClose` cambia default render** a icon-button "×" styled
+  (coherente con `DialogClose`). Antes era unstyled `<button>` para usar
+  con `className="ig-btn ig-btn-*"`. Migración para CTAs del footer:
+
+  ```diff
+   <AlertDialogFooter>
+  -  <AlertDialogClose className="ig-btn ig-btn-secondary">Cancelar</AlertDialogClose>
+  -  <AlertDialogClose className="ig-btn ig-btn-danger">Sí, borrar</AlertDialogClose>
+  +  <AlertDialogClose asChild>
+  +    <Button variant="secondary">Cancelar</Button>
+  +  </AlertDialogClose>
+  +  <AlertDialogClose asChild>
+  +    <Button variant="danger">Sí, borrar</Button>
+  +  </AlertDialogClose>
+   </AlertDialogFooter>
+  ```
+
+### Added (D14 Bloque B beta.27)
+
+- **`asChild` prop en `DialogTrigger`, `DialogClose`, `AlertDialogClose`**.
+  Cuando `asChild={true}`, el componente clona el child del consumer y le
+  inyecta semantics (aria + onClick handler) sin renderizar wrapper
+  propio. Patrón canónico Radix/shadcn. Internamente usa el primitive
+  `<Slot>` de D14 Bloque A (PR #110).
+
+  ```tsx
+  <DialogTrigger asChild>
+    <Button variant="brand">Abrir modal</Button>
+  </DialogTrigger>
+  ```
+
+  `AlertDialogTrigger` es alias de `DialogTrigger`, así que también
+  obtiene `asChild` automáticamente.
+
+  Sin `asChild`, comportamiento idéntico a 1.0.0-beta.25 (backwards-compat
+  para DialogTrigger y DialogClose; AlertDialogClose es BREAKING — ver arriba).
+
+- **`<Slot>` primitive interno** en `src/components/Slot/` — no exportado
+  al consumer, solo usado por components del DS via `asChild` opt-in.
+  Ver D14 + PR #110 para diseño completo.
+
+- **`asChild` prop en `MenuTrigger`** (D14 Bloque D beta.27).
+  Misma semántica que `DialogTrigger`/`DialogClose`/`AlertDialogClose`: si
+  `true`, clona el child del consumer y le aplica id + ARIA (haspopup,
+  expanded, controls) + handlers FUI (click + keyboard) sin renderizar
+  un `<button>` propio ni aplicar `ig-menu-trigger`. Permite usar
+  cualquier elemento como trigger:
+
+  ```tsx
+  <Menu>
+    <MenuTrigger asChild>
+      <Button variant="brand">Abrir menú</Button>
+    </MenuTrigger>
+    <MenuContent>
+      <MenuItem>Editar</MenuItem>
+    </MenuContent>
+  </Menu>
+  ```
+
+  Sin `asChild`, comportamiento idéntico a 1.0.0-beta.25 (backwards-compat).
+
+  **Cierra el refactor Slot DS-wide** (D14): 4 familias migradas (Dialog,
+  AlertDialog, Tooltip, Menu) — todas las que existen con triggers en
+  1.0. Las 13 familias futuras del roadmap `floating/README.md`
+  (Popover, HoverCard, ContextMenu, Combobox, etc.) se diseñarán ya
+  nativas con Slot en 1.1.0+.
+
+- **`Tooltip` forwardea outer Slot props al child final** (D14 Bloque C beta.27).
+  `TooltipProps` admite ahora un index signature (cualquier prop adicional
+  no consumida por Tooltip — `text`, `placement`, `variant`, `children`,
+  delays, `container` — se forwardea via Slot interno al elemento child
+  clonado). Habilita el patrón nested asChild:
+
+  ```tsx
+  <DialogClose asChild>
+    <Tooltip text="Cancela y cierra">
+      <Button variant="danger">×</Button>
+    </Tooltip>
+  </DialogClose>
+  ```
+
+  El outer Slot de `DialogClose` clona Tooltip pasando close `onClick` +
+  ref; Tooltip los recibe en su nuevo `...rest` y los forwardea al
+  `<Button>` final via `<Slot>` interno. Pre-Bloque C, esos props se
+  dropeaban silenciosamente (codex P2 round 2 sobre PR #109 cazó el bug en el
+  doc-only plan).
+
+  API público de Tooltip preservado: `text`, `placement`, `variant`,
+  `children` (ReactElement), delays, `container` siguen igual.
+
+### Added (resto del bloque beta.27)
+
+- **EOPT widening — 307 props opcionales ensanchadas a `?: T | undefined`** (#155, PR #114). Habilita el patrón consumer `<Comp prop={cond ? val : undefined}>` bajo `exactOptionalPropertyTypes: true`. Reparto:
+  - 271 CLASE 1 (codemod AST mecánico).
+  - 36 CLASE 2 (widening + tests runtime sobre los 12 componentes con `useControllableState`).
+  - 11 OUT OF SCOPE (3 discriminadores `?: undefined` literal + 8 exclusiones `?: never`).
+
+  Inventario AST: `scripts/eopt-classify.mjs`. Verifier: `scripts/eopt-verify-class2.mjs`. Codemod: `scripts/eopt-codemod.mjs`. Tests runtime: `src/__tests__/eopt-undefined-uncontrolled.test.tsx`. Fronteras NO cubiertas documentadas más abajo.
+
+- **Rating form-value bridge nativo (#153, PR #117)**. `Rating` añade `name?: string`. Cuando se proporciona, renderiza `<input type="hidden" name={name} value={value}>` adyacente al `role="radiogroup"`. El valor espeja el efectivo (controlled o uncontrolled). Mantiene el canal-de-forma WCAG (#102 — buttons en `radiogroup`).
+
+  ```tsx
+  <form action="/rate" method="post">
+    <Rating name="score" defaultValue={3} max={5} />
+    <button type="submit">Enviar</button>
+  </form>
+  ```
+
+  Cierra la asimetría con los otros 5 inputs del DS (`Checkbox`, `Switch`, `Radio`, `Slider`, `NativeSelect`) que serializan vía `<input>` nativo heredado.
+
+- **CI matriz Windows + Node [22.12, 24]** (#151, PR #121). `.github/workflows/verify.yml` corre 4 combos: ubuntu/windows × Node 22.12/24. Cross-OS gates: `scripts/check-no-dev-warns.mjs` (reemplaza el step inline `grep -cF` POSIX-only), helpers `crossOsResolve/crossOsRelative/crossOsDirname` en `scripts/check-server-safe-markers.mjs` que preservan Windows drive letters (codex P1).
+
+- **Test catálogo `CLIENT_GLOBALS` vs Node runtime cross-version** (#150, PR #122). `src/__tests__/server-safe-catalog-vs-node.test.ts` verifica en runtime real (Node 22.12 + 24, ubuntu + windows) que el catálogo del gate `@server-safe` no tiene falsos positivos sobre globals que Node provee. 4 overlaps documentados (`globalThis`/`process`/`Buffer`/`navigator`) con rationale multi-runtime.
+
+- **Server-safe marker AST** (#158, PR #118). El gate `check-server-safe-markers.mjs` detecta el marker `@server-safe` vía TypeScript Compiler API (JSDoc tag), no via substring. Cierra 3 vectores de falsos positivos: string literals, line comments en prosa, block comments no-JSDoc. Tests: `src/__tests__/server-safe-marker-ast-detection.test.ts`.
+
+- **Consumer-pack tarball-real-install gate** (PR #108). `scripts/test-consumer-pack.mjs` hace `npm pack` → instala en sandbox → corre `tsc --noEmit` con bundler + NodeNext. Caza issues que solo emergen con el flow end-to-end real: exports field interpretado por node/npm, peer deps resueltos, `.d.ts` paths bajo NodeNext.
+
+- **Smuggling cross-módulo gate (HIGH-2)** (PR #106). El gate `@server-safe` ahora sigue imports transitivos (depth-first) para cazar bypasses que importan un util sucio desde un archivo `@server-safe`. Inventario completo en `scripts/check-server-safe-markers.mjs` (orquestador `checkFileWithImports`).
+
+- **NodeNext + CLIENT_GLOBALS ampliado + JSDoc Menu (HIGH bloque)** (PR #105). El gate detecta acceso bare a 46 client globals (catálogo ampliado vs los 6 originales). `CLIENT_GLOBALS` exportado para uso en tests. Resolución alias en NodeNext robustecida con cascada de extensiones `.ts`/`.tsx`/`/index.ts`/`/index.tsx`.
+
+- **D13 — name reservations pre-rc.1** (PR #107). Reservas léxicas para los componentes/props que el roadmap 1.1+ va a añadir (Popover/HoverCard/ContextMenu/Combobox y subsystem `Form`/`Field`/`FormError`). Documentadas en `docs/decisions/D13-name-reservations-pre-rc1.md`.
+
+- **Fixture Playwright contraste pares componente** (#152, PR #129). `src/stories/ContrastPairs.stories.tsx` mide ΔE OKLab sobre DOM real (Chromium vía vitest-browser-playwright + Storybook) y asserta vs `deltaE_at_decision` con drift_tolerance 5%. Complementa el gate `check-component-contrast.mjs` (CSS resolver) con cobertura runtime DOM — caza regresiones de cascade/specificity.
+
+- **Audit fixtures `navigator` wholesale denylist** (#164, PR #125). 10 tests en `src/_audit/server-safe-gate.test.ts` que prueban el wholesale denylist de `navigator.X` (sin allowlist por property name). Blindaje del invariante para que una regresión que saque `navigator` del catálogo salte por dos lados (catálogo + audit).
+
+### Changed
+
+- **ΔE error_threshold blindado 0.05 → 0.07 + axis-kobalium dark ratificado** (#154, PR #115). `scripts/perceptual-allowlist.json` v2: `error_threshold` subido a 0.07 sin recalibrar tokens. `axis-kobalium dark` (ΔE 0.0522) ratificado como excepción consciente vía allowlist (drift gate sigue activo). Cualquier par nuevo bajo 0.07 sin allowlist explícita rompe CI. SKILL.md alineado (PRs #115, #116).
+
+- **DialogContext marcado `@internal`** (#162, PR #120). Los 4 exports del módulo (`DialogContextValue`, `DialogContext`, `useDialogContextOptional`, `useDialogContextRequired`) son `@internal`. `stripInternal: true` borra todo el `.d.ts` publicado (`export {}`). El bundle JS runtime sigue intacto. Verificado vía consumer-pack con `skipLibCheck: false`. El deep-import `AlertDialogClose → @/components/Dialog/DialogContext` es arquitectura D8 documentada (no deuda).
+
+- **StepProps internal split completado** (#161, PR #119). Las 4 props que el `Stepper` inyecta vía `cloneElement` (`index`/`active`/`complete`/`labeled`) movidas de `StepProps` (público) a `StepInternalProps` (`@internal`). Justo con las 3 que ya estaban (`interactive`/`onActivate`/`onStepKeyDown`), `StepInternalProps` agrupa las 7 props internas. `StepProps` publicado queda con `label?: ReactNode` + `ref` + `extends HTMLAttributes`.
+
+- **Size-budget mide payload real (no shim)** (#160, PR #126). `package.json` `size-limit` entries para JS bundles ahora incluyen el lazy chunk vía glob `dist/!(index|server-safe|cn).js` (extglob) — captura cualquier chunk transitivo que Rollup emita. Limits ajustados al payload real: `JS bundle ESM` 18.11 KB gz / 20 KB limit; `JS bundle server-safe ESM` 4.42 KB gz / 8 KB limit (vs 16 KB anterior cosmético).
+
+- **Toast container JSDoc alineado con Tooltip/MenuContent** (#165, PR #127). `ToastProvider.container` documenta el patrón Dialog-nesting (top-layer del browser) + ejemplo Dialog-ref + referencia a `docs/decisions/C-02-modal-tooltip-portal.md`. Cierra la asimetría documental entre los 3 componentes que aceptan `container`.
+
+### Fixed
+
+- **`dist/cn.d.ts` huérfano eliminado del tarball** (#159, PR #123). El `vite-plugin-dts` emite un `.d.ts` por cada entry, pero `exports` field apunta a `./dist/utils/cn.d.ts` (tsc-emitted, con sourcemap). Helper `rmFile` añadido a `scripts/clean-internal-dist.mjs`.
+
+- **Dev-vulns devDep cero** (#163, PR #124). `npm audit` reportaba 3 vulns (`brace-expansion`, `tmp`, `ws`) en devDeps. Verificado `npm audit --omit=dev` = 0 vulns pre/post-fix (runtime nunca afectado). Bumps: brace-expansion 5.0.5 → 5.0.6, tmp 0.2.5 → 0.2.7, ws 8.20.0 → 8.21.0. 0 cambios en `package.json` (solo lockfile).
+
+### Documentation
+
+- **Peer `@floating-ui/react ^0.27` pre-1.0 risk** (#156, PR #128). Sección nueva en README sobre la semántica especial del caret (^) en versiones 0.x: `^0.27.0` matchea SOLO `0.27.x` (NO `0.28.0`). Documenta la política del DS (mantener `^0.27.0` cerrado hasta verify FUI 0.28 compat) + recomendación al consumer (pinear `~0.27.0` si usa FUI directamente). Alineado con `docs/decisions/D10-fui-peer-dep-verify.md`.
+
+### EOPT widening — fronteras (consumer-facing)
+
+El widening `?: T | undefined` de #155 cubre **307 props del DS**. Hay 2 clases NO cubiertas que el consumer EOPT debe conocer.
+
+#### 1. Discriminantes con literal `?: undefined`
+
+`MenuItem.href`, `SidebarItem.href`, `NavbarBrand.AsDiv.href`. NO ensanchadas porque rompería el discriminated union — son los literal `undefined` que activan la rama `button`/`div`:
+
+```tsx
+<MenuItem href={undefined}>Acción button</MenuItem>
+<MenuItem href="/perfil">Acción anchor</MenuItem>
+```
+
+#### 2. Exclusiones con `?: never`
+
+8 props del inventory `scripts/eopt-classify.mjs --json` marcadas `OUT_OF_SCOPE_NEVER`. NO ensanchadas porque `never` es el mecanismo de exclusión de variantes en discriminated unions.
+
+Inventario completo + clasificación AST en `scripts/eopt-classify.mjs`. Ver PR #114 / commit `9bdaf9a` del widening.
+
+## [1.0.0-beta.25] — 2026-05-25 (gate review cruce cycle complete)
+
+Plan **claudegate4** + cruce de gate reviews independientes (GPT Codex +
+Claude Opus 4.7 v2 + Opus 4.7 genérico) cierra los 5 blockers + 2 HIGH del
+cruce sobre `1.0.0-beta.24`. 8 PRs mergeados (#96–#101 + #103), 2 fallos
+WCAG cerrados (1.4.11 AA + 1.4.1 A), 2 codex P1/P2 cazados sobre mis
+propios fixes, 1 hallazgo nuevo (alias `@/` en `.d.ts`) descubierto y
+resuelto durante el ciclo, 1 decision doc nuevo (D12 i18n).
+
+### Added
+
+- **`Rating.getStarLabel` prop**: override del aria-label por estrella
+  individual (`(n: number) => string`). Cierra el hueco i18n
+  detectado en el gate review beta.25 — el label del grupo ya era
+  overrideable vía `aria-label`, los hijos no lo eran. Default ES
+  permanece (`"1 estrella"` / `"N estrellas"`). Additive, no breaking.
+
+### Changed
+
+- **i18n formalización (D12)**: defaults ES quedan registrados como
+  decisión arquitectónica en `docs/decisions/D12-es-defaults-i18n.md`.
+  Tabla de overrides en `docs/CSSAPI.mdx` ampliada con Avatar,
+  SkeletonContainer y Rating (faltaban). Comments
+  `// i18n: ES default deliberado (D12). Override: {prop}.` añadidos
+  junto a cada string ES default en código (Alert, Chip, DialogClose,
+  Pagination, Progress, Stepper, Toast, Avatar, Skeleton, Rating).
+  No cambia comportamiento — solo descubribilidad para auditorías
+  futuras.
+- **Rating contraste empty (gate review beta.25 HIGH)**: el estado
+  empty se comunicaba via `opacity: 0.32` sobre el color filled. Codex
+  midió en igoded.es 1.885:1 light / 2.165:1 dark — ambos `< 3:1`
+  (WCAG 1.4.11 para UI components). La opacity también atenuaba el
+  focus-ring del button focusable. Reemplazo: capa semántica de
+  foreground atenuado (`.ig-star { color: var(--ig-text-muted) }`),
+  que pasa ≥3:1 en ambos temas (light 6.67:1, dark 5.90:1) y deja el
+  focus-ring intacto al 100% contraste.
+- **Rating canal de forma (issue #102, WCAG 1.4.1 nivel A)**: la
+  diferenciación filled/empty viajaba solo por hue (rutilus cálido vs
+  text-muted purple-gray, luminancia casi idéntica → 1.85:1 light /
+  1.88:1 dark). En daltonismo, escala de grises o `forced-colors:
+  active`, las 5 estrellas se ven iguales — el rating deja de
+  comunicar su valor. Reemplazo: glifo state-driven via `::before
+  { content }` — filled `★` (U+2605 BLACK STAR), empty `☆` (U+2606
+  WHITE STAR). Dos canales independientes (forma + color),
+  ortogonales: sobrevive a forced-colors por code point distinto.
+  Cambio sintáctico de la API CSS-only: el consumer ya NO escribe el
+  carácter dentro del `<span class="ig-star">` (queda vacío + recomendado
+  `aria-hidden="true"`); el glifo lo aporta CSS. Markup React JSX no
+  cambia (Rating sigue rendering el button, ahora sin children).
+
+### Removed
+
+- **`--ig-rating-empty` (token público)**: muerto desde beta.24 (la
+  implementación lo abandonó por opacity-based). Sin consumers reales
+  pre-1.0.0, lo eliminamos para reducir surface API. La asimetría con
+  `--ig-rating-filled` (que sí queda público porque permite override
+  del cardinal `rutilus`) es deliberada: el empty consume la capa
+  semántica de foreground atenuado (`--ig-text-muted`) por ser un
+  color flat sin justificación de customización individual.
+
+## [1.0.0-beta.24] — 2026-05-19 (D1 server-safe infrastructure complete)
+
+Plan **claudegate3** (post-RC1 gate review) cierra el bloque D1 con
+4 sub-tasks. Pre-tag de `1.0.0-rc.1` queda únicamente FREEZE-CHECK.
+
+### Added
+
+**`DialogAction` — botón unstyled para CTAs del footer del Dialog**:
+
+Mirror exacto de `AlertDialogClose` para la familia Dialog. Cierra el
+modal via contexto (`setOpen(false)`) pero NO aplica ninguna clase
+base. Diseñado para botones de acción del `DialogFooter` (Cancelar,
+Aceptar, Entendido, etc.) donde el consumer pasa `className="ig-btn
+ig-btn-..."` y espera que esa sea la única clase visual.
+
+**Por qué se añade ahora**: usar `<DialogClose className="ig-btn
+ig-btn-brand">Aceptar</DialogClose>` mezclaba la clase base de
+`DialogClose` (`ig-dialog-close`, que fuerza `2rem × 2rem`, `padding: 0`
+para la "×" del header) con la clase del Button del DS → footer
+descuadrado. `AlertDialogClose` ya tenía esta forma desde D8 (codex P1
+sobre PR #87) pero el Dialog quedó sin el equivalente, así que el
+patrón natural del consumer producía un visual roto.
+
+Migración consumer (no breaking, paralelo a DialogClose):
+
+```tsx
+// Antes (footer descuadrado por clases en conflicto):
+<DialogFooter>
+  <DialogClose className="ig-btn ig-btn-secondary">Cancelar</DialogClose>
+  <DialogClose className="ig-btn ig-btn-brand">Aceptar</DialogClose>
+</DialogFooter>
+
+// Ahora (sizing del Button respetado):
+<DialogFooter>
+  <DialogAction className="ig-btn ig-btn-secondary">Cancelar</DialogAction>
+  <DialogAction className="ig-btn ig-btn-brand">Aceptar</DialogAction>
+</DialogFooter>
+```
+
+`<DialogClose />` queda como el botón "×" del header (sigue intocado).
+Stories actualizadas (Default + Information). Tests añadidos: cierre
+via context, no aplica `ig-dialog-close`, `onClick.preventDefault()`
+bloquea el cierre.
+
+### Fixed
+
+**Rating — distinción visual filled/empty robusta + contraste light mode**:
+
+Patrón canónico Material UI / Mantine / shadcn: ambos estados usan
+el mismo glifo `★` solid; la diferenciación es por **opacity** sobre
+el mismo color base (`--ig-rating-filled`):
+
+- Vacía: ★ a opacity 0.32 sobre `--ig-rating-filled`.
+- Llena: ★ a opacity 1.
+
+Por qué este patrón:
+
+- El glifo solid (`★`) tiene antialiasing más visible que el outline
+  (`☆`) sobre fondos near-white. En light mode el ☆ outline en
+  `--ig-rating-empty` (#685080 sobre #faf9fc) leía casi como bg.
+- Mantener el mismo color base preserva el matiz coherente (cobre
+  rutilus) en ambos estados. La opacity baja conserva el hue sin
+  desaturarlo, evitando blend con el fondo.
+- La diferencia visual filled vs empty es ahora ratio 3:1 (1.0 vs
+  0.32), independiente del tema activo.
+
+Limpieza adicional: removidas reglas CSS-only que duplicaban el hover
+preview (`.ig-rating:not(.ig-rating-readonly):hover .ig-star` y
+`.ig-rating:not(.ig-rating-readonly) .ig-star:hover ~ .ig-star`).
+Eran redundantes — `setHover` en JSX ya aplica `ig-star-filled` a las
+estrellas en el preview. La regla con sibling combinator `~` tenía
+specificity (0,5,0) que sobreescribía el estado, produciendo
+visual inconsistente cuando el cursor permanecía sobre el rating
+tras el click. Ahora el `ig-star-filled` class (estado JSX) es la
+única fuente de verdad.
+
+`--ig-rating-empty` token mantenido en `igoded-tokens.css` por
+backward-compat con consumers que lo extendieran, pero el CSS del
+componente ya no lo referencia.
+
+### Added (beta.24)
+
+**D1-P3 — `reactigoded/server-safe` entry + `react-server` conditional export**:
+
+Nuevo subpath export `reactigoded/server-safe` + condicional automático
+`"react-server"` en `package.json#exports["."]` que re-exporta solo los
+36 componentes marcados `@server-safe` (verificados por el gate
+`test:server-safe-markers`).
+
+Consumer pattern (Next.js App Router Server Component, Astro server
+island, Remix loader, etc.):
+
+```tsx
+// app/page.tsx (server, sin "use client")
+import { Button, CardBody, CardHeader } from "reactigoded";
+// → resuelve a dist/server-safe.js via react-server condition
+```
+
+Componentes interactivos (Dialog/Menu/Toast Provider/Tooltip/Switch/
+ThemeToggle) siguen importables desde el barrel root cuando el
+consumer está en Client Component (`"use client"`).
+
+CI gates añadidos:
+
+- `test:publint`: validador de exports config (sustituye attw temporalmente
+  por bug fflate en ARM64 — ver `docs/known-issues.md`).
+- `test:rsc-fixture`: `tsc -p fixtures/rsc/tsconfig.json --noEmit` con
+  `customConditions: ["react-server"]` + paths a `dist/server-safe.d.ts`.
+  Cubre regresiones del subset server-safe.
+- `test:server-safe-markers` (retroactivo de D1-P1): añadido al
+  workflow `verify.yml` que antes solo lo corría localmente.
+
+Sin cambios breaking — el barrel root sigue exportando todos los componentes.
+
+### Changed (BREAKING — pre-RC1, beta.24)
+
+**D1-P4 — ESM-only package**:
+
+reactigoded ahora es **ESM-only**. La rama CJS de `package.json#exports`
+queda eliminada, junto con los emits `dist/*.cjs` y los campos `main`
++ `module` del manifest. El paquete sigue declarando `"type": "module"`
+(introducido en beta.22).
+
+Migración consumer:
+
+```js
+// Antes (CJS, ya no soportado):
+const { Button } = require("reactigoded");
+
+// Ahora (ESM):
+import { Button } from "reactigoded";
+
+// Si necesitas usarlo desde un CJS file legacy, Node ≥22 soporta
+// require() sincrónico de ESM nativamente:
+const { Button } = require("reactigoded");
+
+// O dynamic import:
+const { Button } = await import("reactigoded");
+```
+
+`package.json#exports` simplificado:
+
+```json
+{
+  ".": {
+    "react-server": {
+      "types": "./dist/server-safe.d.ts",
+      "default": "./dist/server-safe.js"
+    },
+    "default": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "./server-safe": { "types": "...", "default": "./dist/server-safe.js" },
+  "./cn":          { "types": "...", "default": "./dist/cn.js" }
+}
+```
+
+Razones técnicas:
+
+- **Coherencia**: el DS ya era ESM-first (`"type": "module"` desde beta.22),
+  el output CJS era un fallback que pocos consumers usaban.
+- **publint clean**: el warning `pkg.exports["."].require.types` sobre
+  types ESM interpretadas en condición require queda eliminado (no más
+  rama `require`).
+- **Bundle output**: menos artefactos en `dist/` (no `*.cjs`), tamaño
+  total del paquete publicado más ligero.
+- **Tooling moderno**: Vite, Next.js > 13, Astro, Remix, Bun, Deno
+  soportan ESM nativamente. Node 22 LTS (mínimo del DS desde
+  `"engines": { "node": ">=22.12.0" }`) soporta `require()` sincrónico
+  de ESM.
+
+CI workflow actualizado: `dist/index.cjs` removido del check de
+"Bundle has no dev warns".
+
+---
+
+**D1-P2 — clsx promoted from dependency to peerDependency**:
+
+`clsx` (^2.1.0) ahora es **peer-dependency obligatoria**. Antes era una
+dep regular bundleada — el consumer tenía `clsx` instalada de forma
+implícita. A partir de beta.24, el consumer debe instalarla
+explícitamente en su árbol de deps.
+
+Migración:
+
+```bash
+npm install clsx@^2.1.0
+# o
+pnpm add clsx@^2.1.0
+# o
+yarn add clsx@^2.1.0
+```
+
+Razones técnicas:
+
+- **Deduplicación**: la mayoría de consumers (apps con Tailwind, shadcn/ui,
+  proyectos existentes que ya combinan classNames) ya tienen `clsx` en su
+  árbol. Bundle-arla en reactigoded duplica el módulo en runtime sin valor
+  funcional.
+- **Bundle size**: el ESM principal pierde ~500B gz, el CJS un poco más.
+- **Coherencia D1 server-safe**: con `@server-safe` enforced en beta.24,
+  los chunks publicados están auditados — externalizar peer-deps refuerza
+  que el árbol de bundling sea predecible para SSR/RSC consumers.
+
+Decisión documentada inline en `package.json#peerDependencies` y
+`vite.lib.config.ts#rollupOptions.external`. La decisión previa
+(beta.20 "clsx bundleado permanente") queda invalidada por el plan D1.
+
+---
+
+**D2 + D7 — Menu Full FUI portal + namespace reorg** (B1-PR3):
+
+- **Menu file move**: `src/components/Menu/` → `src/components/floating/Menu/`.
+  Public API root barrel `reactigoded` sin cambio (símbolo `Menu` se
+  exporta idéntico). Internal cross-component imports actualizados.
+- **Menu Full FUI portal**: `<FloatingPortal>` + `floatingStyles` inline +
+  `data-side` / `data-align` / `data-state` attributes (split Radix-style).
+  Unmount-on-close (no más CSS-hidden).
+- **Modifier classes eliminadas**: `.ig-menu-right`, `.ig-menu-up`,
+  `.ig-menu-open`, `:focus-within` JS-less fallback. Consumers que las
+  stylizaban en su CSS deben migrar a `[data-side]` / `[data-align]`
+  attribute selectors en MenuContent.
+- **Menu requires JS**: alineado con Tooltip/Dialog/Accordion. No más
+  CSS-only fallback `:focus-within`.
+- **floating/ namespace agrupado**: `src/components/floating/index.ts`
+  nuevo barrel re-exporta `./primitives + ./Tooltip + ./Menu`. En
+  `src/components/index.ts` los 3 wildcards floating sueltos se colapsan
+  a uno (`export * from "./floating"`). Sin cambio para consumer.
+- **useFloatingNode internal definitive**: retirado del wildcard
+  re-export de `floating/primitives/index.ts`. JSDoc declaraba @example
+  interno pero export * lo exponía. Internal consumers ya importan via
+  path directo `@/components/floating/primitives/useFloatingNode`.
+  Consumers que (accidentalmente) lo importaban desde `"reactigoded"`
+  deben removerlo — uso público era unintended.
+
+Decision docs: `docs/decisions/D2-menu-portal.md`,
+`docs/decisions/D7-floating-namespace.md`,
+`src/components/floating/README.md`. C-03 doc status actualizado
+"diferida a 1.1.0" → "DONE en beta.24".
+
+---
+
+C.2 DS-wide rename pattern: callbacks aligned al prop name local cuando
+el prop tiene nombre de dominio (no "value" arbitrario). Sub-patrón DS
+articulado en `docs/decisions/D3-callback-rename-cw.md` y
+`docs/decisions/D4-sidebar-api.md`.
+
+**Pagination** — prop rename + callback rename:
+- `currentPage?: number` → `page?: number`.
+- `defaultPage` queda.
+- `onValueChange?: (page: number) => void` →
+  `onPageChange?: (page: number) => void`.
+- Param signature `(page: number)` queda.
+
+Migration consumer:
+```diff
+- <Pagination currentPage={p} onValueChange={setP} totalPages={N} />
++ <Pagination page={p} onPageChange={setP} totalPages={N} />
+```
+
+**Stepper** — callback rename solo:
+- Prop `active` queda. Callback `onValueChange` → `onActiveChange`.
+- Param signature `(next: number)` queda.
+
+```diff
+- <Stepper active={s} onValueChange={setS}>...</Stepper>
++ <Stepper active={s} onActiveChange={setS}>...</Stepper>
+```
+
+**ThemeToggle** — callback rename solo:
+- Props `theme` + `defaultTheme` quedan. Callback `onValueChange` →
+  `onThemeChange`.
+
+```diff
+- <ThemeToggle theme={t} onValueChange={setT} />
++ <ThemeToggle theme={t} onThemeChange={setT} />
+```
+
+**Sidebar** — callback rename + SidebarItem a11y refactor:
+- Props `collapsed` + `defaultCollapsed` quedan. Callback `onValueChange`
+  → `onCollapsedChange`.
+- CSS class `.ig-sidebar-collapsed` queda. ARIA `aria-expanded={!collapsed}`
+  queda (encapsulado en SidebarToggle).
+- **SidebarItem** ahora consume `useSidebar()` context para aplicar
+  `aria-label` condicionalmente: aplicado solo en estado collapsed
+  (ARIA APG fix — eliminado anti-pattern de nombre accesible duplicado
+  en estado expanded).
+- **SidebarItem pasa a `"use client"`** (consume context). Sale de
+  candidatos `@server-safe` D1 P1.
+- **SidebarItem REQUIERE estar dentro de `<Sidebar>`** (D11.4 regla
+  DS-wide: hooks que requieren ancestor lanzan).
+
+`useSidebar` JSDoc reescrito eliminando `@example PersistSidebar`
+(anti-pattern declaraba uso público mientras bundle no expone el hook
+desde B-04 RC1). Pointer a README sección "Persisting Sidebar state"
+(a añadir en B1-PR1 sweep) para patrón consumer-facing con controlled
+mode external + guard SSR-safe en localStorage.
+
+**Componentes aligned (sin cambios)**: Accordion, Rating, Slider, Tabs
+— sus props se llaman `value`, callbacks `onValueChange` son aligned
+localmente.
+
+---
+
+**D6 — Dialog Full compound refactor** (B2-PR2):
+
+**BREAKING**. `Dialog` pasa de ser un componente monolítico (era el
+`<dialog>` HTML nativo con children directos) a Provider compound
+Radix-style. La lógica del modal real vive en el nuevo `<DialogContent>`;
+`<DialogTrigger>` (nuevo) abre el modal con ARIA disclosure correcto.
+
+API nueva:
+
+```tsx
+<Dialog
+  open?={x}                    // controlled (opcional, era obligatorio)
+  defaultOpen?={false}         // uncontrolled (nuevo)
+  onOpenChange?={fn}
+>
+  <DialogTrigger>Abrir</DialogTrigger>   // nuevo, aria-haspopup/-controls/-expanded
+  <DialogContent                          // nuevo, el <dialog> real
+    size? backdrop? closeOnBackdrop?
+    closeOnEsc? loading? ref? className?
+  >
+    <DialogHeader />
+    <DialogBody />
+    <DialogClose />                       // ahora auto-cierra via contexto
+  </DialogContent>
+</Dialog>
+```
+
+**Migration mecánica** consumer:
+
+```diff
+- <Dialog open={x} onOpenChange={fn} size="md">
+-   <DialogHeader />
+-   <DialogBody>texto</DialogBody>
+-   <DialogClose onClick={() => setOpen(false)} />
+- </Dialog>
++ <Dialog open={x} onOpenChange={fn}>
++   <DialogContent size="md">
++     <DialogHeader />
++     <DialogBody>texto</DialogBody>
++     <DialogClose />
++   </DialogContent>
++ </Dialog>
+```
+
+Opcional: para casos sencillos, eliminar `useState` externo + `Button`
++ `onClick` y usar `<DialogTrigger>` + `defaultOpen`:
+
+```diff
+- const [open, setOpen] = useState(false);
+- <Button onClick={() => setOpen(true)}>Abrir</Button>
+- <Dialog open={open} onOpenChange={setOpen}>
+-   <DialogHeader />
+- </Dialog>
++ <Dialog defaultOpen={false}>
++   <DialogTrigger className="ig-btn ig-btn-brand">Abrir</DialogTrigger>
++   <DialogContent>
++     <DialogHeader />
++   </DialogContent>
++ </Dialog>
+```
+
+Cambios técnicos:
+- `Dialog` ahora es Provider puro (sin DOM). `useControllableState`
+  interno con `SUPPRESS_NO_HANDLER_WARN` en modo controlled-presentational
+  (`active` sin callback, decisión consciente del consumer).
+- `DialogContent` hereda TODAS las props visuales antiguas de `Dialog`:
+  `size`, `backdrop`, `closeOnBackdrop`, `closeOnEsc`, `loading`, `ref`,
+  `className`, `onPointerDown`/`onClick` chained. H-02 drag-out parity
+  preservado.
+- `DialogTrigger` es `<button>` plano con `aria-haspopup="dialog"` +
+  `aria-controls={contentId}` + `aria-expanded={open}` automáticos.
+  Chainea `onClick` consumer; `preventDefault` bloquea apertura.
+- `DialogClose` consume el contexto y llama `setOpen(false)` automático.
+  Sigue siendo tolerante fuera de `<Dialog>` (no rompe, simplemente no
+  cierra nada — responsabilidad del consumer via `onClick`).
+- Alias backward-compat de tipos: `DialogSize` y `DialogBackdrop` ahora
+  son alias de `DialogContentSize` / `DialogContentBackdrop`. Consumers
+  que importaban los tipos del barrel siguen funcionando.
+- Prop `onClose` (deprecated en B-02 RC1) sigue disparando en cierres
+  via wrapper en setOpen; eliminada en 2.0.
+
+Decision doc: `docs/decisions/D6-dialog-compound.md`.
+
+---
+
+**D1-P1 — `@server-safe` JSDoc marker + suite SSR ejecutable** (D1 server-safe, parte 1/4):
+
+Establece la infraestructura declarativa + ejecutable para SSR / React
+Server Components compatibility. Sin breaking — solo añade marker
+JSDoc + gate script + double-render test.
+
+- **JSDoc `@server-safe`** en 36 componentes — todos los archivos sin
+  `"use client"` directive en `src/components/`. Includes:
+  `Avatar/AvatarGroup`, `Badge`, `Breadcrumb/BreadcrumbItem`,
+  `Button`/`IconButton`, `Card`+subcomponentes, `Chip`, `Divider`,
+  `Dialog/DialogBody/DialogFooter`, `Input`+`Label`/`Helper`/etc.,
+  `Navbar`+subcomponentes, `Progress`, `Radio`, `Sidebar` (subs
+  presentacionales), `Skeleton`, `Spinner`, `Stepper`/`Step`, `Table`,
+  `Timeline`/`TimelineItem`, `Toast` (item; el Provider es client).
+- **Gate** `scripts/check-server-safe-markers.mjs` +
+  `npm run test:server-safe-markers` (encadenado en `verify:unit`):
+  enforza que archivos `@server-safe` NO declaren `"use client"` y NO
+  accedan a `document.X`/`window.X`/`navigator.X`/`process.X`/`Buffer.X`
+  sin guard `typeof X !== "undefined"`.
+- **Test double-render idempotence** en `__ssr__.test.tsx`: dos
+  invocaciones de `renderToString(jsx)` con el mismo JSX producen el
+  mismo HTML. Skip components con `useId` (Accordion, Dialog, Menu,
+  Sidebar, Tabs, Tooltip, Toast) por semántica de `useId` entre
+  invocaciones independientes.
+- Decision doc: `docs/decisions/D1-P1-server-safe-marker.md`.
+
+Componentes adicionales se marcarán incrementalmente post-RC1 conforme
+se audite cada uno.
+
+---
+
+**MEDIUMs consolidados beta.24** (B3-PR1):
+
+Batch de fixes individuales identificados en el gate review claudegate3
+sección IV (EXC-A1/A2). Atómicos para bisect-friendliness — un commit
+por finding:
+
+- **M-04 (Tooltip.extractText)**: investigado y descartado tras
+  análisis (codex P2 round 2 sobre PR #89). El finding original asumía
+  que `join("")` rompía spacing en `<>Hello <b>World</b>!</>`, pero
+  JSX YA preserva los espacios en los strings literales adyacentes
+  (`children = ["Hello ", <b>"World"</b>, "!"]`). Inyectar `" "` rompía
+  casos legítimos de tokens contiguos (`<>v<code>1</code>.<code>2</code></>`
+  → "v 1 . 2" en lugar de "v1.2"). El behavior actual `join("")` es
+  correcto — el consumer es dueño de los espacios. Añadido test
+  regression guard "preserva adjacencia de tokens".
+- **M-05 (Label required)**: el asterisco usaba `style={{ marginLeft: 4 }}`
+  inline (CSP issue). Migrado a CSS class `ig-label-required-mark` con
+  margin + color del token `--ig-malum`. **Bonus fix**: el CSS
+  `.ig-label-required::after` también renderizaba un asterisco — junto
+  al `<span>*</span>` del JSX producía DOBLE asterisco visible. Fix
+  inicial (eliminar `::after`) rompía el caso CSS-only API (HTML
+  estático sin React perdía el marker — codex P2 round 2). Fix final:
+  `:has(.ig-label-required-mark)` condiciona el `::after` a aplicar
+  SOLO cuando el span React no está, preservando ambas APIs (React +
+  CSS-only) sin doble asterisco.
+- **M-07 (landmark registries)**: `useLandmarkRegistry` +
+  `useTopLevelLandmarkCheck` mantienen estado module-level (Map y
+  contador). Sin reset entre tests acumulaban entries. Los helpers
+  `__reset*ForTests` existían pero solo se invocaban manualmente en
+  sus tests dedicados. Centralizados en `src/test/setup.ts` `afterEach`
+  para que todos los tests hereden el cleanup.
+- **M-10 (D-02 doc grep)**: `docs/decisions/D-02-forwardref-migration-done.md`
+  afirmaba `grep -rn "forwardRef" → vacío esperado` pero realidad
+  muestra 11 matches (dev-warn references + test fixtures, no DS-side
+  usage). Refinado al call-form `grep -rn "forwardRef("` que sí
+  retorna 0 y captura el invariante real ("ningún componente del DS
+  INVOCA forwardRef").
+
+Findings descartados sin cambio (audit confirmó OK):
+- **M-06 (useA11yWarnInput)**: hook ya robusto.
+- **M-08 (Toast timers)**: cleanup ya correcto via `afterEach`.
+- **M-09 (Twin act() warning)**: no encontrado en logs.
+- **M-11 (C-03 doc DONE)**: ya marcado tras D2/D7 beta.24.
+- **M-13 (Switch indeterminate)**: ya conforme H-15 WAI-ARIA 1.2.
+- **M-14 (Stepper test consolidation)**: refactor cosmético; deferido
+  a iteración futura — los tests cubren regresiones reales (codex P1+P2
+  históricos) y consolidar pierde trazabilidad por marginal LOC saving.
+
+Verify cold: 836/836 sin regresión.
+
+---
+
+**README sweep masivo post-beta.24** (B1-PR1):
+
+`README.md` y `docs/CSSAPI.mdx` tenían drift acumulado de los renames
+y refactors de beta.24. Sweep sistemático:
+
+- **Pagination API** (D3): `currentPage`/`onValueChange` → `page`/
+  `onPageChange` en README sección "Controlled vs uncontrolled" y
+  CSSAPI.mdx § Pagination.
+- **Dialog compound** (D6): tabla de componentes, ejemplos de uso,
+  sección SSR/hydration, CSS API. `Modal*` → `Dialog*` / `DialogContent`
+  / `DialogTrigger` / etc. La línea "Modal es controlled-only" eliminada
+  (ya no aplica: Dialog soporta uncontrolled con DialogTrigger).
+- **AlertDialog family** (D8): añadido a tabla de componentes + tabla
+  CSS API + sección SSR (`role="alertdialog"` + `closeOnBackdrop=false`
+  default mencionado).
+- **Menu rename** (D2/D7): `OptionsMenu*` → `Menu*` (refactor Full FUI
+  beta.24 + namespace reorg).
+- **Tabs subcomponentes**: `TabList`/`Tab`/`TabPanel` → `TabsList`/
+  `TabsTrigger`/`TabsContent` (alineado con exports reales del barrel).
+- **D9 budget claim**: "~14 KB gz" → "~16 KB gz (budget 20 KB ESM con
+  headroom)".
+- **Tabla controlled/uncontrolled DS-wide** añadida bajo § Patrones
+  recurrentes, listando los 10 componentes con la convención
+  `{prop}?` + `default{Prop}?` + `on{Prop}Change` cerrada en beta.24.
+- **D11 hooks disposition**: sección "Hooks públicos del DS" ya
+  existía; el bloque B-04 sobre context hooks privados se renombró a
+  D11 para reflejar la disposición canónica beta.24.
+
+Solo cambios docs. Cero runtime. Verify cold 836/836 sin regresión.
+
+---
+
+**D8 — AlertDialog family** (B2-PR3):
+
+Nueva familia para confirmaciones destructivas / acciones que demandan
+atención consciente. Hereda toda la infraestructura compound de Dialog
+(D6); el único componente con comportamiento propio es
+`<AlertDialogContent>`. Los demás (`AlertDialog`, `AlertDialogTrigger`,
+`AlertDialogHeader/Body/Footer/Close`) son aliases directos de los
+equivalentes Dialog — cero overhead, cero divergence.
+
+```tsx
+<AlertDialog defaultOpen={false}>
+  <AlertDialogTrigger className="ig-btn ig-btn-danger">
+    Borrar permanentemente
+  </AlertDialogTrigger>
+  <AlertDialogContent>
+    <AlertDialogHeader>
+      <h2>Confirmar borrado</h2>
+    </AlertDialogHeader>
+    <AlertDialogBody>Esta acción es irreversible.</AlertDialogBody>
+    <AlertDialogFooter>
+      <AlertDialogClose className="ig-btn ig-btn-secondary">
+        Cancelar
+      </AlertDialogClose>
+      <AlertDialogClose className="ig-btn ig-btn-danger">
+        Sí, borrar
+      </AlertDialogClose>
+    </AlertDialogFooter>
+  </AlertDialogContent>
+</AlertDialog>
+```
+
+Diferencias de `AlertDialogContent` vs `DialogContent`:
+
+1. **`role="alertdialog"`** (override del `role="dialog"` automático del
+   `<dialog>` HTML). WAI-ARIA APG: indica que el modal demanda atención
+   consciente del usuario.
+2. **`closeOnBackdrop={false}` por defecto** (vs `true` en
+   `DialogContent`). Click outside NO cierra — el usuario debe pulsar
+   Cancel o Confirm explícitamente. Override por consumer si su caso
+   es más suave: `<AlertDialogContent closeOnBackdrop />`.
+
+`closeOnEsc` sigue `true` (atajo ergonómico universal).
+
+7 tests cubren las diferencias D8 + composición end-to-end. Decision
+doc: `docs/decisions/D8-alert-dialog.md`. No breaking — D8 es API
+nueva pura.
+
+---
+
+### Fixed (non-breaking, beta.24)
+
+**H-03 — Progress CSP-friendly via CSS custom property** (B2-PR5):
+
+Pre-fix, `Progress.tsx` emitía el porcentaje runtime como propiedad
+CSS arbitraria en el style attribute:
+
+```html
+<div class="ig-progress-bar" style="width: 42%"></div>
+```
+
+Esto rompía CSP estricto sin `'unsafe-inline'` en `style-src`. M-08
+(RC1) lo había documentado como excepción legítima; la auditoría
+beta.24 lo re-clasificó como bug con mitigación canónica disponible.
+
+Fix: sustituir style attribute con propiedad arbitraria por un único
+**CSS custom property**:
+
+```html
+<div class="ig-progress-bar" style="--ig-progress-percent: 42%"></div>
+```
+
+Stylesheet ahora consume la variable: `.ig-progress-bar { width:
+var(--ig-progress-percent, 0%); }`. La lógica visual vive en
+stylesheet; el componente solo pasa datos. Auditores CSP modernos
+y políticas con `'unsafe-hashes'` tratan `style="--var: value"`
+distinto a inline rules visuales — `'unsafe-hashes'` sobre el
+conjunto finito de valores `--ig-progress-percent` (0%..100%) es
+ahora viable. Patrón canónico Radix/Mantine/MUI Joy.
+
+**API React sin cambio**. Consumers que pasaban `value`/`max`/etc.
+no notan nada. CSS-only consumers que copiaban el snippet con
+`style="width: X%"` ven el snippet en docs actualizado a
+`style="--ig-progress-percent: X%"`; el viejo formato sigue
+funcionando (specificity del inline style gana al stylesheet) pero
+NO es CSP-friendly.
+
+Decision doc: `docs/decisions/H-03-progress-csp-css-var.md`.
+
+---
+
+**D11 — Disposición pública de hooks del DS** (B2-PR8):
+
+Cierra la disposición canónica de los símbolos hook/factory expuestos
+por `"reactigoded"`. Sin breaking — solo formaliza intención con JSDoc
+tags + un alias adicional + documentación.
+
+- **Nuevo alias `UseToastReturn`** en `src/components/Toast/ToastContext.ts`,
+  re-exportado desde `Toast/index.ts`. Sigue la convención DS-wide
+  `Use{Name}Return` (cf. `UseThemeReturn`, `UseControllableStateReturn`).
+  El interfaz underlying `ToastContextValue` queda exportado para mocks
+  / adapters; el nombre canónico que el consumer tipa al destructurar
+  `useToast()` es `UseToastReturn`.
+- **JSDoc `@public`** en `useTheme`, `useControllableState`, `useToast`,
+  `FloatingTreeRoot`. Declaración de intención: estos cuatro símbolos
+  son API pública estable 1.0.
+- **JSDoc `@internal`** en `useFloatingNode` con pointer explícito a
+  `FloatingTreeRoot` como entrypoint público para anidación de floats.
+  El hook YA estaba retirado del wildcard re-export (D7.4 beta.24); el
+  tag explicita la intención.
+- **README sección "Hooks públicos del DS"** (bajo § Patrones recurrentes)
+  con tabla de los cuatro símbolos públicos + nota explícita de qué
+  hooks NO son públicos (`useDropdown` / `useTabs` / `useFloatingNode`
+  / `useSidebar` / etc.).
+
+Patrón organizacional: hooks generic (`useTheme`, `useControllableState`)
+viven en `src/hooks/` y se exportan explícitamente desde `src/index.ts`.
+Hooks family-specific (`useToast`, `FloatingTreeRoot`) viven en
+`src/components/<Family>/` y se exportan via la barrel chain de la
+familia. Razonamiento detallado: `docs/decisions/D11-hooks-disposition.md`.
+
+---
+
+**D9 — size-limit re-baseline + budget creep policy + H-07 gate ejecutable** (B2-PR7):
+
+Re-baseline de los budgets `size-limit` del JS bundle tras los cambios
+de beta.24 (Menu Full FUI portal, callback renames, Avatar fallback,
+Progress CSP, hooks disposition). El margen ESM había caído a 0.18 KB
+(1.1%) — funcionalmente cero, cualquier PR mediano rompía CI por scope
+creep accidental. CSS budgets se mantienen en su zona 23-30% headroom
+post-H-13 (sin drift en beta.24).
+
+**Nuevos budgets JS** (25-30% headroom paralelo, política H-13):
+
+| Entry | Real beta.24 | Anterior | **Nuevo** | Headroom |
+|---|---|---|---|---|
+| JS ESM (gzip) | 15.82 KB | 16 KB | **20 KB** | 26.4% |
+| JS CJS (gzip) | 14.06 KB | 15 KB | **18 KB** | 28.0% |
+
+CSS budgets sin cambio.
+
+**Budget creep policy** documentada (`D9-size-limit-baseline.md`):
+- Headroom target 25-30%.
+- Subir budget solo por feature documentada o dep upstream con
+  justificación + cálculo de nuevo budget en el mismo PR.
+- NO subir budget por refactor, dep bumps cosméticos, comodidad de
+  iteración o "CI falla, fix rápido".
+
+**H-07 gate ejecutable**: `scripts/check-state-css-exclusion.mjs` +
+`npm run test:state-css-exclusion`, encadenado en `verify:unit`
+post-build. Verifica que ninguna utility de `state.css` (clases con
+prefijo `hover:ig-`, `focus:ig-`, `active:ig-`, `disabled:ig-`,
+`checked:ig-`, `default:ig-`, `empty:ig-`, `first-child:ig-`,
+`last-child:ig-`) aparezca en `dist/index.js` ni `dist/index.cjs`. Si
+un componente del DS empezara accidentalmente a referenciarlas (713 KB
+gz standalone), el gate explota pre-publish. Cierra el vector de
+escape que H-07 había dejado como deuda (decisión "conservar" sin
+gate ejecutable de invariante).
+
+Decision docs: `docs/decisions/D9-size-limit-baseline.md` (nuevo),
+`docs/decisions/H-07-state-css-and-future.md` (actualizado con
+pointer al gate).
+
+---
+
+**H-08 — hydrateRoot SSR tests** (B2-PR6):
+
+Extensión de la suite SSR (`src/__ssr__.test.tsx`) con 4 nuevos casos
+que ejercitan el **ciclo completo** server → cliente: `renderToString`
+→ mount en `<div>` DOM → `hydrateRoot` con `onRecoverableError` →
+assert no mismatch + DOM intacto post-hidratación. Cubre la categoría
+de bugs que `renderToString` solo no caza:
+
+1. **Hydration mismatch**: HTML server difiere del primer paint
+   cliente. React reconstruye el subtree y pierde estado/handlers.
+2. **useId divergente**: si la posición de tree es no-determinística
+   entre server y cliente, los IDs no matchean. React 19 garantiza
+   determinismo si el tree es idéntico — este test confirma que los
+   componentes del DS lo son.
+3. **DOM mutation post-hydrate**: effect síncrono mal diseñado
+   sobreescribe el HTML del server.
+
+**Selección de 4 componentes representativos** (no toda la suite — los
+38 `renderToString` cases ya cubren server-safety; hidratación es spot
+check del ciclo completo):
+
+- **Button** — golden path simple, sin context ni useId.
+- **Card (compound)** — contenedor con children compound. Caso layout.
+- **Accordion (controlled state)** — estado `open/closed` interno +
+  `useId()` para aria-controls. Stress test snapshot ↔ hydrate sync.
+- **Tabs (compound + useId)** — `useId()` para trigger/panel pairing.
+  Caso histórico de mismatch en DSs que no aíslan ID counter.
+
+**Componentes excluidos** (decisión consciente, documentada en el
+test): Dialog/Menu/Tooltip/Toast (client-only por design, "use client"
+granular + portales — el consumer NO los server-renderiza),
+ThemeToggle/Switch indeterminate (`useSyncExternalStore` con server
+snapshot fijo, ya cubierto trivialmente por renderToString).
+
+Sin `act()` en el test: `hydrateRoot` commitea sincrónicamente y
+`onRecoverableError` se llama durante el commit; los assertions son
+sincronos (array push + DOM snapshot), no dependen de effects
+post-commit.
+
+---
+
+**D5 — Stepper `defaultActive` + modo uncontrolled** (B2-PR1):
+
+Cierra el último componente con estado público del DS que rompía el
+patrón controlled/uncontrolled DS-wide. Pre-D5, `active` era
+obligatorio; consumers debían crear `useState` externo incluso para
+casos sencillos. Ahora alineado con Accordion/Pagination/Sidebar/
+Tabs/Switch/Slider/Rating/ThemeToggle.
+
+API (no breaking — `active` deja de ser obligatorio):
+
+```ts
+export interface StepperProps {
+  active?: number;                // ← era obligatorio
+  defaultActive?: number;         // ← nuevo (default 0)
+  onActiveChange?: (next: number) => void; // ← sin cambio
+}
+```
+
+Semántica de modos:
+| Props pasados | Modo | Interactive |
+|---|---|---|
+| `active=N` | Controlled | NO (sin callback no hay vector de cambio) |
+| `active=N, onActiveChange=fn` | Controlled | SÍ |
+| `defaultActive=N` (o nada) | Uncontrolled | SÍ (estado interno) |
+| `defaultActive=N, onActiveChange=fn` | Uncontrolled + observer | SÍ |
+
+Implementación: `useControllableState<number>` interno. Keyboard
+handlers + click invocan `setActive(nextIdx)` que resuelve a:
+- Controlled: forward a `onActiveChange`.
+- Uncontrolled: actualizar state interno + dispatch a `onActiveChange`
+  como observer.
+
+7 tests nuevos en `Stepper.test.tsx` cubren todos los modos +
+regression guard "controlled sin callback queda presentational".
+Story `Uncontrolled` añadida con play test que valida estado
+interno via click sin useState externo.
+
+Decision doc: `docs/decisions/D5-stepper-defaultactive.md`. Cierra
+la simetría del DS — todos los componentes con estado interno ahora
+siguen el mismo patrón `{prop}?` + `default{Prop}?` + `on{Prop}Change`.
+
+## [1.0.0-beta.23] — 2026-05-16 (RC1 gate review + post-audit codex)
+
+Cierra el playbook RC1 completo: **17 PRs técnicos** ejecutados sobre la
+branch `rc1-gate-fixes` (Menu/FUI, Modal→Dialog, Tabs Radix alignment,
+ThemeSwitch→ThemeToggle, "use client" granular, Tooltip 12 placements,
+3 stories cruzadas, useControllableState updater + breaking semantic,
+Tooltip dev-warn 4-layer + extractText, Dialog drag-out parity,
+`reactigoded/cn` subpath, Skeleton ARIA soak) + **audit post-RC1
+con codex sobre 16 PRs antiguos** que descubrió 5 findings adicionales
+(todos resueltos antes de tagear).
+
+**19 PRs auditados por codex / 5 findings reales / 0 issues abiertos
+en main al cerrar la beta.**
+
+Última pre-release antes de FREEZE-CHECK final + `1.0.0-rc.1`.
+
+### Internal — bump de deps a latest
+
+22 paquetes actualizados a su última versión (minors + patches, sin
+breaking detectado en verify cold 794/794):
+
+| Paquete | Antes | Después |
+|---|---|---|
+| Storybook ecosystem (`storybook`, `addon-a11y`, `addon-docs`, `addon-themes`, `addon-vitest`, `react-vite`, `eslint-plugin-storybook`) | 10.3.6 | **10.4.0** |
+| `vitest`, `@vitest/browser`, `@vitest/browser-playwright`, `@vitest/coverage-v8` | 4.1.5 | 4.1.6 |
+| `vite` | 8.0.10 | 8.0.13 |
+| `eslint` | 10.3.0 | 10.4.0 |
+| `react`, `react-dom` | 19.2.5 | 19.2.6 |
+| `chromatic` | 16.6.3 | 16.10.1 |
+| `playwright` | 1.59.1 | 1.60.0 |
+| `globals` | 17.5.0 | 17.6.0 |
+| `@types/node` | 25.6.0 | 25.8.0 |
+| `@vitejs/plugin-react` | 6.0.1 | 6.0.2 |
+| `postcss` | 8.5.13 | 8.5.14 |
+| `typescript-eslint` | 8.59.1 | 8.59.3 |
+
+**Storybook 10.4 highlights aprovechables**:
+- Sidebar review tools: status filtering, URL-persisted filters,
+  clearer review signals (útil para gate humano FREEZE-CHECK).
+- A11y: `aria-live` announcements en el propio Storybook, contrast en
+  forced colors mode, ArgsTable borders Windows HCM.
+- Addon-Docs: reset story button, avoid re-render de Source blocks (perf).
+- Addon-Vitest: `provide-API` para injectar values en stories.
+
+**Patch local mantenido**: `patches/eslint-plugin-jest-dom+5.5.0.patch`
+sigue necesario — upstream v5.5.0 sigue inconsistente entre uso del
+helper `getSourceCode(context)` y llamadas directas `context.getSourceCode()`
+(broken en ESLint v9). El patch sustituye las directas por
+`context.sourceCode` (sin breaking aún en ESLint v8 porque el wrapper
+upstream ya hace el fallback). Re-evaluar en upgrades futuros del
+plugin.
+
+**`engines.node` raised a `>=22.12.0`** (codex P1 sobre PR #76):
+Vite 8.0.13 exige `^20.19.0 || >=22.12.0`. Nuestro `>=22` previo
+incluía Node 22.0–22.11 en el declared support pero fallaría en
+install/runtime. Floor alineado al peor caso del ecosystem.
+
+### Changed (BREAKING — pre-RC1)
+
+- **`useControllableState.setValue` en modo controlled ya NO advance el
+  pending entre chained calls [codex P1 post-audit sobre PR #70]**:
+  pre-fix, dos `setValue(p => p + 1)` chained en modo controlled desde
+  `value=10` emitían `onChange(11)` y `onChange(22)` — el segundo
+  partía del pending advanced.
+
+  Post-fix: emiten `onChange(11)` y `onChange(20)` — ambos parten del
+  último committed value externo. Esto es semánticamente correcto: en
+  controlled, el padre es la fuente de verdad. Si rechaza el commit
+  (no actualiza `value` prop), no hay re-render y el pending no debe
+  avanzar — si avanzara, el segundo `onChange` daría payload
+  inconsistente con el state real.
+
+  Consumers afectados: uso de chained updater functions con `setValue`
+  en modo controlled (prop `value` definido). Verificado: cero
+  consumers internos del DS dependen de este patrón. Mitigación
+  external consumer: pasar valor calculado externamente en lugar de
+  chaining, o usar modo uncontrolled si el chaining era intencional.
+
+### Fixed
+
+- **`Tooltip`: sr-only span renderiza texto plano via `extractText`
+  [codex P1 post-audit sobre PR #52]**: pre-fix, `text={ReactNode}`
+  con contenido interactivo (`<button>`/`<a>`) se renderizaba completo
+  en el sr-only span. Solución previa (`inert` en el span) rompía
+  `aria-describedby` al excluir el subárbol del a11y tree.
+
+  Fix: `extractText()` extrae texto plano del ReactNode recursivamente.
+  El sr-only renderiza solo `string` — sin focusables posibles → no se
+  necesita `inert`. Resuelve simultáneamente:
+  - Bug original (focus trap invisible con ReactNode interactivo).
+  - Bug post-audit (`inert` rompe accessible name del trigger).
+
+  El portal flotante mantiene el `ReactNode` completo con `inert`
+  (decoración visual aislada).
+
+- **`Stepper`: guard idx-mismatch en focus management
+  [codex P1 post-audit sobre PR #19]**: si el padre rechaza una
+  transición de `active` (no commitea el cambio), `focusTargetIdxRef`
+  quedaba stale apuntando al idx rechazado. Una transición posterior
+  distinta podía mover focus al idx antiguo.
+
+  Fix: guard `if (idx !== clampedActive) return` antes de aplicar
+  focus — solo movemos focus si el commit del padre coincide con la
+  intent del keydown.
+
+- **`Pagination`: `defaultPage` se clampa al inicializar state, no
+  solo en render [codex P2 post-audit sobre PR #19]**: pre-fix,
+  `defaultPage` fuera de rango se almacenaba raw en state interno y
+  solo se clampaba en render. Si `totalPages` aumentaba después, la
+  UI saltaba al `defaultPage` stale.
+
+  Fix: pre-clamp de `defaultPage` contra `totalPages` antes de pasar
+  al hook.
+
+- **`Avatar`: fallback de img preserva accessible name via `alt`
+  [codex P2 post-audit sobre PR #36]**: pre-fix, cuando la imagen
+  fallaba a cargar y caía a `initials`, el span de initials estaba
+  `aria-hidden="true"` y el wrapper sin role/aria-label — el SR
+  quedaba mudo si el consumer no había pasado `aria-label` explícito.
+
+  Fix: en fallback mode, el wrapper recibe `role="img"` +
+  `aria-label={alt ?? ariaLabel}`. Avatares solo decorativos (sin
+  `alt` ni `ariaLabel`) siguen siendo silenciosos por decisión
+  consciente del consumer.
+
+### Added
+
+- **Soak del cambio ARIA de `Skeleton` (beta.22) [M-02]**: cobertura de
+  tests + Storybook ampliada para validar el patrón ARIA del breaking
+  change introducido en beta.22 (cada `Skeleton` standalone es
+  decorativo; el announcement al SR vive en `SkeletonContainer`).
+
+  - Story `ConContainer` recibe play test real verificando contrato
+    completo (único `role=status` + `aria-busy` + `aria-live=polite` +
+    `aria-label` + Skeletons internos con `role=presentation`).
+  - 2 stories nuevas: `SkeletonsStandaloneNoAnuncian` (consciente:
+    sin container, cero announcements) y `MultiplesContainersParalelos`
+    (cada container con status independiente).
+  - 5 tests nuevos en `describe("Skeleton — M-02 ARIA soak")`:
+    container vacío sigue anunciando, múltiples paralelos independientes,
+    anidación preserva ambos status, standalone fuera del a11y tree,
+    role inmutable (regresión guard).
+  - Test extra en `AllStates regression` verifica invariante "sin
+    container, cero announcements" — convierte el placebo legacy en
+    aserción significativa.
+
+  axe-core ahora ejecuta sobre 3 stories del patrón en CI.
+
+- **Subpath export `reactigoded/cn` para tree-shaking [H-12]**: pre-fix,
+  `import { cn } from "reactigoded"` arrastraba el bundle entero
+  (~64 KB ungz / 16 KB gz) incluyendo `createPortal` de `react-dom`
+  vía Toast — los bundlers consumers no tree-shaken bundles
+  monolíticos. Build multi-entry de Vite separa `cn` como entry
+  independiente.
+
+  ```ts
+  // Antes: arrastra todo el DS
+  import { cn } from "reactigoded";  // 16 KB gz
+
+  // Ahora: ~0.4 KB gz (wrapper + clsx)
+  import { cn } from "reactigoded/cn";
+  ```
+
+  El import desde el root (`reactigoded`) sigue funcionando — no es
+  breaking. La subpath solo añade una opción más eficiente para
+  consumers que solo necesitan `cn` (utility libraries, build
+  helpers, etc).
+
+  Output del build:
+  - `dist/cn.js` 70 B (re-export)
+  - `dist/cn-<hash>.js` 0.55 KB (chunk clsx compartido con el root bundle)
+
+### Fixed
+
+- **`Dialog`: drag-out parity tracking — selección de texto ya no cierra
+  el modal [H-02]**: cuando el usuario hacía `mousedown` sobre el contenido
+  del Dialog (para seleccionar texto) y arrastraba hasta soltar sobre el
+  backdrop, el browser disparaba un `click` event con `target === currentTarget`
+  (el `<dialog>` propio) — el handler interpretaba ese click como "click
+  en backdrop" y cerraba el modal, abandonando la selección.
+
+  Fix con `pointerdownTargetRef`: registra el target del `pointerdown` y
+  solo considera "click en backdrop" cuando AMBOS el pointerdown Y el
+  click final tienen target = dialog (no si pointerdown empezó en
+  contenido). El fallback `pointerdownTarget === null` preserva el
+  comportamiento para clicks programáticos sin pointerdown previo
+  (tests, consumer-side `.click()` calls).
+
+  Sin cambio de API — fix interno transparente.
+
+### Added
+
+- **`Tooltip` dev-warn cuando custom child no forwardea ref [M-07.2]**:
+  cuando el `children` del Tooltip es un componente custom que ignora
+  el ref (sin `React.forwardRef` o sin aceptar `ref` como prop normal
+  en React 19), Floating UI no puede medir el trigger ni montar el
+  portal — el tooltip queda inerte al hover/focus pero el sr-only
+  span con `aria-describedby` sigue funcionando. Pre-RC1 el síntoma
+  era silencioso (consumer no sabía por qué el tooltip "no abre").
+
+  Implementación con **approach de 4 capas** (cero magic numbers en
+  camino crítico):
+
+  1. **Static analysis O(1)** sobre `children.type`:
+     - `string` (DOM intrinsic): `guaranteed_ok` → cero runtime.
+     - `$$typeof === REACT_FORWARD_REF_TYPE`: `guaranteed_ok`.
+     - `memo(...)`: recurse en el inner type.
+     - `function`: `ambiguous` (React 19 ref-as-prop posible).
+  2. **Probe sticky** en el ref: `useRef(false)` que se setea a `true`
+     la primera vez que recibe un Element no-null. Una vez true, no se
+     resetea — cero false positives en lazy mounting.
+  3. **Sentinel dev-only** con `display: contents` envolviendo el child
+     (solo si `verdict === 'ambiguous'`). Listeners `mouseenter`/`focus`
+     en capture-phase via `addEventListener` nativo (React no expone
+     `onMouseEnterCapture` porque mouseenter no bubblea). Captura el
+     intent del usuario incluso si el child no propaga handlers — sin
+     depender de tiempo arbitrario.
+  4. **Safety net 2000ms** como fallback solo para el caso edge "dev
+     observa pero no interactúa". Honestamente generoso (cubre
+     `React.lazy`, Suspense, fetch lentos, `requestIdleCallback`).
+
+  Detecta los **3 modos de fallo** del Tooltip (no solo el del ref):
+  child que no forwardea ref, child que no propaga handlers (`...rest`
+  ignorado), child que renderiza null permanentemente.
+
+  Mensaje del warn (incluye nombre del componente):
+
+  ```
+  [reactigoded] <Tooltip>: el child <MyCustom> no expone su nodo DOM
+  via ref. El tooltip no puede medir el trigger ni abrirse al hover/
+  focus. Usa React.forwardRef (React <19) o acepta `ref` como prop
+  normal (React 19+) y pásalo al elemento DOM root del componente.
+  aria-describedby sigue funcionando — el SR anuncia el texto del
+  tooltip pero el portal visual no aparece.
+  ```
+
+  No-op en producción (gated por `import.meta.env.DEV`).
+
+- **`useControllableState.setValue` acepta updater function [M-06]**: el
+  setter del hook ahora acepta valor directo `T` **o** una función
+  updater `(prev: T) => T` — mismo patrón que `useState` de React.
+
+  ```ts
+  const { value, setValue } = useControllableState<boolean>({
+    defaultValue: false,
+  });
+
+  // Antes: solo valor directo (depende del closure de `value`).
+  setValue(!value);
+
+  // Ahora también: updater (no depende del closure).
+  setValue((prev) => !prev);
+  ```
+
+  Útil para updates encadenados en handlers que no quieren capturar
+  `value` en el closure (`onClick`/`onKeyDown` con múltiples acciones).
+
+  Funciona en los 3 modos:
+  - **uncontrolled**: la updater recibe el `internalValue` actual.
+  - **controlled**: la updater recibe el `value` controlado externo y
+    el resuelto se pasa a `onChange` (sin tocar state interno).
+  - **derive**: la updater recibe el valor derivado y el resuelto se
+    pasa a `setDerivedValue`.
+
+  Sin breaking — `setValue(directValue)` sigue funcionando.
+
+- **`Tooltip` stories cruzadas + play tests reales [H-08]**: cobertura
+  Storybook ampliada con 1 story cruzada nueva (`TooltipDentroDeTabs`)
+  y play tests reescritos en stories existentes para sustituir las
+  asserts placebo (counting spans, leyendo `aria-describedby` sin abrir
+  el portal) por **interacciones reales**:
+
+  - `A11yInteraction`: play ahora hace `userEvent.hover`, verifica que
+    el portal monta en `document.body` con `.ig-tooltip` y el texto
+    correcto, dispara `{Escape}` y verifica que el portal desmonta —
+    y que el sr-only persiste como referente estable de `aria-describedby`.
+  - `AllStates`: el `expect(spans).toHaveLength` legacy se mantiene
+    como sanity check pero se añade hover real sobre `top` →
+    verify `.ig-tooltip.ig-tooltip-place-top` en `document.body` con
+    texto → unhover → verify desmonte.
+  - `TooltipDentroDeModal` (story cruzada existente): nuevo play que
+    abre el Dialog, hace hover en el botón danger, verifica que el
+    portal del tooltip monta dentro del top-layer del `<dialog>` (no
+    detrás del backdrop) y dispara Escape para cerrar solo el tooltip.
+  - `TooltipDentroDeTabs` (story cruzada nueva): cambia entre paneles
+    de `Tabs`, verifica que el tooltip del panel inactivo desaparece
+    del DOM al cambiar, y que el del panel activo aparece al hover.
+
+  Coverage cruzada total: 3 stories (`WithCustomContainer` con `<dialog>`
+  nativo + `TooltipDentroDeModal` con `<Dialog>` del DS + `TooltipDentroDeTabs`
+  con `<Tabs>` del DS). axe-core ahora ejecutará a11y checks sobre estas
+  combinaciones en CI.
+
+- **`Tooltip` ampliado a los 12 placements de Floating UI [M-04]**: el
+  type `TooltipPlacement` pasa de 4 (`top` / `bottom` / `left` / `right`)
+  a los **12 valores nativos** de Floating UI — 4 sides × 3 alignments
+  (base, `-start`, `-end`):
+
+  ```ts
+  type TooltipPlacement =
+    | "top" | "top-start" | "top-end"
+    | "right" | "right-start" | "right-end"
+    | "bottom" | "bottom-start" | "bottom-end"
+    | "left" | "left-start" | "left-end";
+  ```
+
+  Sin cambios CSS — las clases `.ig-tooltip-place-*` siguen siendo
+  hooks informativos vacíos (Floating UI posiciona vía inline styles).
+  La nueva clase `.ig-tooltip-place-top-start` y resto se emiten
+  automáticamente.
+
+  Sin breaking — los 4 placements antiguos siguen siendo válidos. Solo
+  amplía el conjunto de opciones permitidas.
+
+  Tests: `describe.each` ampliado a los 12 placements.
+  Stories: nuevo layout 3x3 + alas mostrando los 12 placements simultáneamente.
+
+### Changed
+
+- **`"use client"` granular por archivo en lugar de global [H-09]**: el
+  barrel `src/index.ts` ya no lleva `"use client";` global. En su lugar,
+  los **48 archivos** que dependen de hooks React, browser APIs o context
+  interno llevan la directive en su propio archivo. Los **44 archivos
+  restantes** (Card subcomponents, Dialog body/footer/close, Sidebar
+  items, Navbar pieces, Skeleton, Spinner, Badge, Progress, Divider,
+  Timeline, etc. — ~49% del DS) son server-safe y pueden renderizarse
+  desde React Server Components sin forzar boundary client en el árbol
+  consumer.
+
+  Impacto consumers RSC: árboles puramente presentacionales (p.ej.
+  `<Card><CardBody>...</CardBody></Card>`) ya no escalan el "client
+  boundary" innecesariamente. Para componentes interactivos (`Switch`,
+  `Tabs`, `Dialog`, `Toast`, etc.) el comportamiento es idéntico — la
+  directive sigue presente, ahora a nivel archivo.
+
+  Sin impacto en SPA / Vite dev / Storybook — la directive es no-op
+  fuera de bundlers RSC-aware (Next.js App Router, Remix, etc.).
+
+### Breaking
+
+- **`ThemeSwitch` → `ThemeToggle` (rename JS, sin cambios CSS)**: el componente
+  se renombra a `ThemeToggle` para reflejar fielmente su comportamiento (toggle
+  binario light/dark) y desacoplar el nombre público de la implementación
+  interna (que sigue usando `<Switch>` por dentro). Alinea con la industria
+  (Radix, ShadCN, MUI usan `ThemeToggle`/`ThemeButton`).
+
+  Migración consumers:
+  ```diff
+  - import { ThemeSwitch } from "reactigoded";
+  - <ThemeSwitch defaultTheme="dark" />
+  + import { ThemeToggle } from "reactigoded";
+  + <ThemeToggle defaultTheme="dark" />
+  ```
+
+  Tipo de props renombrado en paralelo: `ThemeSwitchProps` → `ThemeToggleProps`.
+
+  **CSS sin cambios**: `ThemeToggle` sigue emitiendo `.ig-switch` (delega
+  en `<Switch>` internamente). Consumers que customicen vía CSS de
+  `.ig-switch` no se ven afectados.
+
+- **Tabs API alineada a Radix puro (rename + wrapper eliminado)**: la API
+  pública se simplifica a `<Tabs>`, `<TabsList>`, `<TabsTrigger>`, `<TabsContent>`
+  con composición 100% Radix-style. Cierra inconsistencia interna del DS y
+  alinea con la industria (Radix, ShadCN, Ark UI).
+
+  | Antes | Después | Notas |
+  |---|---|---|
+  | `Tab` | `TabsTrigger` | trigger del tab |
+  | `TabList` | `TabsList` | coherencia plural con `TabsContent`/`TabsContext` |
+  | `TabPanel` | `TabsContent` | panel asociado al `value` |
+  | `<TabsContent>` (wrapper sin lógica) | ❌ eliminado | era Caso 1 (`<div ig-tabs-content>` puro). Padding-top movido a `.ig-tabs-content` (el panel renombrado). |
+
+  API final 100% Radix-style:
+  ```tsx
+  <Tabs>
+    <TabsList>
+      <TabsTrigger value="a">A</TabsTrigger>
+    </TabsList>
+    <TabsContent value="a">…</TabsContent>
+  </Tabs>
+  ```
+
+  CSS coordinado:
+  - `.ig-tab` → `.ig-tabs-trigger` (con sufijo `-active`)
+  - `.ig-tab-panel` → `.ig-tabs-content` (con sufijo `-active`)
+  - `.ig-tabs-list` SIN cambio (ya plural pre-RC1)
+  - `.ig-tabs-content` (wrapper original) eliminada — el panel renombrado
+    hereda el nombre.
+  - Utilities `.ig-tab-1/2/4/8` (tab-size CSS) **SIN cambios** — son
+    typography utilities, no componente Tabs.
+
+  Tokens CSS-variable `--ig-tab-*` **mantenidos** (no renombrados) por
+  compatibilidad con custom CSS de consumers (mismo criterio que
+  `--ig-z-modal` en PR 3).
+
+  Razón última: paralelismo con `Menu`/`MenuTrigger`/`MenuContent`
+  post-PR Menu — los compounds del DS siguen el mismo patrón
+  estructural `<X>` / `<XTrigger>` / `<XContent>`.
+
+  Migración:
+  ```diff
+  - import { Tabs, TabList, Tab, TabPanel, TabsContent } from "reactigoded";
+  + import { Tabs, TabsList, TabsTrigger, TabsContent } from "reactigoded";
+
+  - <Tabs>
+  -   <TabList>
+  -     <Tab value="a">A</Tab>
+  -   </TabList>
+  -   <TabsContent>
+  -     <TabPanel value="a">...</TabPanel>
+  -   </TabsContent>
+  - </Tabs>
+  + <Tabs>
+  +   <TabsList>
+  +     <TabsTrigger value="a">A</TabsTrigger>
+  +   </TabsList>
+  +   <TabsContent value="a">...</TabsContent>
+  + </Tabs>
+  ```
+
+- **`Modal` → `Dialog` (rename + regularización CSS-JS)**: el componente JS
+  se renombra a `Dialog` para alinear con el HTML element nativo `<dialog>`
+  (que ya usaba internamente) y con la industria (Radix, Ark UI, HeadlessUI,
+  MUI usan `Dialog`). Las clases CSS ya estaban nombradas `.ig-dialog-*`
+  (alineación previa), por lo que NO cambian. Este rename regulariza la
+  inconsistencia legacy: componente `Modal` (JS) emitiendo clases
+  `.ig-dialog-*` (CSS).
+
+  Renames JS:
+
+  | Antes | Después |
+  |---|---|
+  | `Modal` | `Dialog` |
+  | `ModalBody` | `DialogBody` |
+  | `ModalHeader` | `DialogHeader` |
+  | `ModalFooter` | `DialogFooter` |
+  | `ModalClose` | `DialogClose` |
+  | `ModalProps` (y `Modal*Props` subcomponentes) | `DialogProps` (y `Dialog*Props`) |
+  | `ModalContext` (interno) | `DialogContext` (interno) |
+  | `ModalSize` / `ModalBackdrop` (types) | `DialogSize` / `DialogBackdrop` |
+
+  Las **clases CSS `.ig-dialog-*` SIN cambios** (ya alineadas pre-RC1).
+  Tokens `--ig-z-modal` / `--ig-z-modal-backdrop` se mantienen como
+  utilities z-index genéricas (no renombradas para preservar
+  compatibilidad con custom CSS de consumers).
+
+  Migración:
+  ```diff
+  - import { Modal, ModalBody, ModalHeader, ModalFooter, ModalClose } from "reactigoded";
+  + import { Dialog, DialogBody, DialogHeader, DialogFooter, DialogClose } from "reactigoded";
+  ```
+
+- **`Menu` internals migrados a Floating UI (C-03)**: `Menu` reescrito sobre la
+  capa `floating/primitives/` (PR #62). Reemplaza ~600 LOC hand-rolled de
+  navegación por hooks composables:
+
+  - `useListNavigation` con `focusItemOnOpen: 'auto'` (APG menu pattern: arrows
+    abren menu + focan primer/último item; click abre sin focar).
+  - `useTypeahead` (focus por primera letra, APG).
+  - `useDismiss({ bubbles: { escapeKey: true } })` (cascade dismiss via
+    `<FloatingTreeRoot>`).
+  - `FloatingFocusManager` con `initialFocus={-1}` + `returnFocus` (defiere
+    focus management a useListNavigation, devuelve foco al trigger al cerrar).
+  - `useFloatingNode` para registrar el Menu en el FloatingTree (cascade dismiss
+    cuando hay descendientes flotantes como Tooltip dentro de MenuItem).
+
+  API pública (`open`/`defaultOpen`/`onOpenChange`/`placement`/`direction`/
+  `closeOnSelect`) y compound shape (`Menu`/`MenuTrigger`/`MenuContent`/
+  `MenuItem`/`MenuSeparator`/`MenuLabel`) sin cambio. Las clases CSS
+  `.ig-menu-*` mantienen mismo contrato.
+
+  Breaking de tipos en callbacks de `MenuItem`:
+  - `onClick` y `onKeyDown` cambian de `MouseEvent<HTMLAnchorElement>` /
+    `MouseEvent<HTMLButtonElement>` (según rama) a `MouseEvent<HTMLElement>`
+    (genérico). Mismo para `KeyboardEvent`. Audit pre-RC1 verificó cero usage
+    de API anchor/button-specific (`.href`, `.disabled`, etc.) en callbacks
+    de MenuItem en repo + cero consumers reales.
+
+  Migración consumers futuros que necesiten API element-specific:
+  ```tsx
+  onClick={(e) => {
+    if (e.currentTarget instanceof HTMLAnchorElement) {
+      e.currentTarget.href;  // narrow type-safe
+    }
+  }}
+  ```
+
+- **`OptionsMenu` → `Menu` + 5 subcomponentes renombrados (B-01 redefinido)**:
+  alineación con la industria. 5 de 7 librerías top (MUI, Mantine, Ark UI,
+  HeadlessUI, Chakra) usan el nombre canónico `Menu`. B-01 original (rename
+  `Dropdown` → `OptionsMenu` pre-RC1) liberaba el nombre `Dropdown` para una
+  migración FUI futura; la decisión 2026-05-10 unifica directamente a `Menu`.
+
+  | Antes | Después | Notas |
+  |---|---|---|
+  | `OptionsMenu` | `Menu` | core |
+  | `OptionsMenuTrigger` | `MenuTrigger` | core |
+  | `OptionsMenuContent` | `MenuContent` | core |
+  | `OptionsMenuItem` | `MenuItem` | core |
+  | `OptionsMenuDivider` | `MenuSeparator` | rol ARIA correcto `separator` |
+  | `OptionsMenuHeader` | `MenuLabel` | label de sección dentro del menu |
+
+  CSS coordinado:
+  - `.ig-options-menu-*` → `.ig-menu-*`
+  - `.ig-options-menu-divider-*` → `.ig-menu-separator-*`
+  - `.ig-options-menu-header-*` → `.ig-menu-label-*`
+
+  Migración:
+  ```diff
+  - import { OptionsMenu, OptionsMenuTrigger, OptionsMenuItem } from "reactigoded";
+  + import { Menu, MenuTrigger, MenuItem } from "reactigoded";
+  ```
+
+- **`Tooltip` Slot pattern (D-01 / M-05 / B-03 / H-01)**: el componente
+  ya **no envuelve al child en `<span class="ig-tooltip-wrapper">`**.
+  El render emite el child clonado + un `<span class="ig-sr-only"
+  role="tooltip" inert>` sibling + el portal flotante. La API pública
+  de props (`text`, `placement`, `variant`, `openDelay`, `closeDelay`,
+  `container`) no cambia, **pero**:
+
+  - **CSS público**: la clase `.ig-tooltip-wrapper` ya no se emite. Si
+    tenías reglas CSS dirigidas al wrapper (layout, espaciado), aplica
+    los estilos al child directamente o envuélvelo manualmente en tu
+    propio span/div.
+  - **Tipos de `TooltipProps`**: dejan de extender
+    `HTMLAttributes<HTMLSpanElement>`. `className`, `ref` y
+    `...rest` HTML props del wrapper desaparecen del tipo. Si pasabas
+    `<Tooltip className="..." ref={spanRef}>`, el TS error es
+    intencional — esos props no tenían destino fiable post-Slot.
+  - **Layout**: si el child es block-level (e.g. `<div>`, `<table>`),
+    ahora respeta el flujo natural (antes, el wrapper `display:
+    contents` lo neutralizaba pero introducía un nodo silencioso).
+
+  Razón: el wrapper rompía block-level layouts del consumer y obligaba
+  a CSS extra para corregirlo. M-05 y D-01 lo señalaban; en RC1 se
+  cierran.
+
+### Añadido
+
+- **`FloatingTreeRoot` y `useFloatingNode`** (B-03 / H-01): nueva capa
+  `floating/primitives/` con un wrapper opt-in (`<FloatingTreeRoot>`)
+  que habilita cascade dismiss entre `Tooltip` y futuros floats
+  (`Popover`, `HoverCard`, `Dropdown` FUI 1.x+) cuando se anidan. Sin
+  el root, los floats funcionan independientes (sin regresión).
+
+  ```tsx
+  import { FloatingTreeRoot } from "reactigoded";
+
+  function App() {
+    return (
+      <FloatingTreeRoot>
+        <RouterProvider router={router} />
+      </FloatingTreeRoot>
+    );
+  }
+  ```
+
+  El hook `useFloatingNode()` devuelve `{ nodeId, parentId }` para que
+  componentes flotantes del DS se registren en el árbol activo.
+  `Tooltip` ya lo consume internamente.
+
+### Notas operativas
+
+- **Sin publicación a npm pre-RC1** (M-03 / cf. `docs/RC1_DECISIONS.md`
+  § "Actualización 2026-05-06: pausa operativa"). Pre-RC1 el paquete
+  se consume vía `git clone` + `npm link`. Iván decidió pausar
+  `npm publish --tag beta` de `1.0.0-beta.22` hasta tener capacidad
+  operativa para sostener el mantenimiento (issues, PRs de consumers,
+  semver discipline). El branch `rc1-gate-fixes` ya cerró los 18
+  Blockers + 8 Highs del gate review; la calidad del código no
+  requiere publicación inmediata para ser real.
+- **Tag git `v1.0.0-rc.1`** se creará tras la sesión de FREEZE-CHECK
+  para trazabilidad histórica del repo, **sin acompañar de
+  `npm publish`** mientras la pausa siga vigente.
+- **Reactivación de la publicación** seguirá el procedimiento
+  documentado en `docs/RC1_DECISIONS.md`: bumpear versión, revertir
+  commit B-01-followup (banner del README), `npm publish --tag rc`.
+
+## [1.0.0-beta.22] — 2026-05-06 (saneamiento RC1)
+
+Cierra los 18 Blockers + 8 Highs del audit RC1
+(`rc1-gate-review-reactigoded.md`) más limpieza adicional descubierta
+durante el ciclo. **Última pre-release antes de `1.0.0-rc.1`**.
+
+### Breaking
+
+- **Sidebar**: prop `ariaLabel` eliminada por consistencia con el resto
+  del DS (Pagination, Spinner, Stepper, TabList, Rating, Timeline ya
+  habían eliminado la prop separada en beta.4 y posteriores). Sidebar
+  era el último outlier. Migration:
+  ```diff
+  - <Sidebar ariaLabel="Navegación principal">…</Sidebar>
+  + <Sidebar aria-label="Navegación principal">…</Sidebar>
+  ```
+  Sin override sigue cayendo al default ES `"Navegación lateral"`.
+- **Skeleton**: cambio del patrón ARIA. `Skeleton` ahora es decorativo
+  (`role="presentation"` + `aria-hidden="true"`). Para anunciar carga
+  al lector de pantalla, envuelve un grupo en
+  `<SkeletonContainer label="...">`, que dispara UN solo aviso
+  (`role="status"` + `aria-busy` + `aria-live="polite"`). El patrón
+  anterior generaba spam de "status busy" en SR cuando había varios
+  `Skeleton`. Migration:
+  ```diff
+  - <Skeleton variant="text" />
+  - <Skeleton variant="text" />
+  + <SkeletonContainer label="Cargando lista">
+  +   <Skeleton variant="text" />
+  +   <Skeleton variant="text" />
+  + </SkeletonContainer>
+  ```
+  El layout del wrapper es neutro (`display: contents`): no añade caja
+  al flujo, los hijos se posicionan como si el container no existiese.
+
+### Added
+
+- **`SkeletonContainer`** [B-12]: nuevo wrapper a11y para grupos de
+  `Skeleton`. Props: `label?: string` (default ES
+  `"Cargando contenido…"`), `children`. Acepta `aria-label` directo
+  vía rest (gana sobre `label`).
+- **`Pagination` uncontrolled state sync** [B-18]: cuando `totalPages`
+  baja por debajo del page interno, el componente sincroniza `page`
+  al clamped current con `silent: true` (no dispara `onValueChange`).
+  Cuando `totalPages` vuelve a subir, NO "salta" al page viejo.
+- **`Tabs` controlled inválido — fallback tab stop** [H-26]: cuando
+  `value` no matchea ningún Tab montado, el primer Tab registrado
+  recibe `tabIndex=0` para mantener el tablist navegable por
+  teclado. `aria-selected` permanece `false` en todos. Mensaje de
+  warn dev actualizado.
+- **`useControllableState` warn re-aplicado** [B-08-followup en
+  beta.21]: ahora con escape hatch `__suppressNoHandlerWarn` que se
+  elimina del `.d.ts` publicado vía `stripInternal`.
+- **`Card.ref` polimórfica tipada** [B-03]: `ref` infiere desde
+  `as`. `<Card as="a" ref={r}>` → `r` es `RefObject<HTMLAnchorElement>`.
+- **Skeleton + Stepper data-step-index** [H-25]: el dot interactivo
+  del Stepper expone `data-step-index` (implementation detail, NO
+  API pública) para que el effect post-commit de focus management
+  resuelva por índice lógico, no por orden DOM.
+
+### Fixed
+
+- **Bundle prod sin `console.*` dev warns** [B-07]: 9 componentes
+  migrados de `if (!isDev())` a `if (!import.meta.env.DEV)` para
+  que esbuild/Vite hagan DCE de los warn dev en build de producción.
+  Verificado: `grep -c console.* dist/index.js` = 0; `grep -c
+  console.* dist/index.cjs` = 0. CI ahora gated por step explícito.
+- **`ThemeSwitch` respeta `<html data-theme>` pre-puesto** [B-08]:
+  el derive lee `<html data-theme>` antes de caer a `defaultTheme`,
+  así que un script anti-flash del consumer
+  (`<html data-theme="light">` antes de hidratar) ya no se sobreescribe.
+  6 tests añadidos (incluido SSR `renderToString` smoke + SSR test
+  versión A que stuba `globalThis.document` y valida el branch
+  `typeof document === "undefined"` del derive).
+- **`Stepper` focus management sin `setTimeout`** [H-25]: el focus
+  al nuevo step ya no usa `setTimeout(0)`; ahora usa un
+  `useEffect([active])` post-commit y `data-step-index` para resolver
+  el target de forma robusta contra conditional rendering, Steps
+  decorativos sin role=button, o CSS reordering.
+- **`Slider` warn dev cuando `value=NaN`** [H-27]: el path controlled
+  no-finito ya no es silencioso; emite warn dev-only similar al que
+  existía para `defaultValue` no-finito.
+- **`Sidebar` blindaje a11y** [B-09]: `role`/`aria-busy`/`aria-live`
+  en `<aside>` no pueden ser overrideados por consumer (extracción
+  explícita de `aria-label` desde rest). Mismo patrón canónico del DS.
+- **`Card.ref` con `Ref<unknown>`** [B-03]: pasa a
+  `ComponentPropsWithRef<C>["ref"]`. Consumers en strict TS configs
+  ya no reciben tipo laxo.
+- **Sitio (igoded.es / Storybook)**:
+  - `<html lang="es">` forzado runtime + estático [B-04 + B-04-followup].
+  - Dedupe de `<title>` y `<meta name="description">` [B-05]. Causa
+    raíz arreglada: metas estáticas consolidadas en
+    `.storybook/manager-head.html` (eran duplicadas con
+    `main.ts:managerHead()`); el script runtime queda como red de
+    seguridad defensiva.
+
+### Internal
+
+- **`stripInternal: true`** en `tsconfig.build.json` [B-02]:
+  `__suppressNoHandlerWarn` y cualquier miembro `@internal` no
+  aparecen en el `.d.ts` publicado.
+- **Excludes del dts publicado** [B-06]: `src/test-utils/`,
+  `src/stories/`, helpers internos (`env.ts` borrado, `useIsoLayoutEffect`,
+  `mergeDescribedBy`) ya no viajan al tarball. Script
+  `scripts/clean-internal-dist.mjs` post-build defensivo.
+- **`vite-env.d.ts` aislado** [B-07-followup]: nuevo
+  `src/_internal-env.d.ts` con SOLO `ImportMetaEnv` para que tsc.build
+  resuelva `import.meta.env.DEV` sin contaminar el dts publicado con
+  `declare module "*.css"`.
+- **MDX foundations canónicamente en `docs/`** [M-06]: 6 páginas
+  movidas de `src/stories/` a `docs/`. Storybook `main.ts` añade
+  `../docs/**/*.mdx` a `stories`.
+- **`"use client";` en bundle** [B-17]: directiva añadida vía
+  `output.banner` en `vite.lib.config.ts` (además del source) para
+  garantizar que llega al bundle final tras minify. Soporta consumers
+  Next.js App Router en Server Components.
+- **CI verify pipeline reforzado**:
+  - `test:scope-leaks --strict` [B-15] añadido como step.
+  - `verify:unit` ahora encadena `test:unit:ci` (isolate + forks),
+    no `test:unit` [B-16].
+  - Bundle dev-warn guard con greps explícitos [B-07-followup].
+  - Chromatic sin `--auto-accept-changes=main` ni
+    `--exit-zero-on-changes` [H-02]: revisión visual humana
+    obligatoria pre-RC1.
+- **Build optimizado** [H-04]: `vite.lib.config.ts`
+  `build.minify: "esbuild"`. Shave ~15% del bundle gzipped.
+- **Perceptual allowlist** [B-13]: reversión consciente del tripwire
+  `dark axis-kobalium` (ΔE 0.0522) introducido en c8a5202 (beta.18).
+  El tripwire nunca fue operativo (`error_threshold=0.05 < 0.0522`).
+  NO se tocan tokens. Anti-regresión:
+  `src/_audit/perceptual-allowlist.test.ts` falla CI si la entrada
+  desaparece sin razón documentada.
+- **`merge-refs` consistente**: Stepper, Checkbox y Switch usan
+  ahora el mismo patrón `useCallback(setRefs, [ref])`.
+- **Higiene del repo**: `.claude/`, `.notes-*`, `.release-*`,
+  `BLOQUEOS.md`, `SESION-RESUMEN*.md` añadidos a `.gitignore`.
+  `src/utils/env.ts` (huérfano post-B-07) borrado.
+
+### Docs
+
+- **Pagination** uncontrolled documentado en README [B-14].
+- **`Introduction.mdx`**: banner pre-publicación recomendando
+  `npm install reactigoded@beta` [B-11].
+- **`state.css` size** corregida en 4 sitios:
+  `~6.5 MB sin gzip / ~700 KB gzipped` (antes "7.1 MB") [B-11].
+- **JSDoc** de `Rating`, `Tabs`, `TabsContext`: ejemplos migrados
+  a `aria-label` HTML estándar (antes mostraban API obsoleta
+  `ariaLabel`) [B-10].
+- **`docs/DS_AUTOSUFFICIENCY_DEBT.md`** capa 1.4 marcada cerrada
+  [H-06].
+- **CHANGELOG** referencia stale a `BLOQUEOS.md` reemplazada por
+  puntero a `docs/DS_AUTOSUFFICIENCY_DEBT.md` [H-07].
+- **`docs/RC1_DECISIONS.md`**: registro de las 4 decisiones humanas
+  B1-B4 confirmadas explícitamente.
+- **`docs/POST_RC1_BACKLOG.md`** + **`docs/RC1_FOUND_DURING_FIX.md`**:
+  trackers de la deuda diferida y los hallazgos descubiertos durante
+  el ciclo.
+- **README**: sección "Desarrollo" documenta el requisito de
+  `npm ci --legacy-peer-deps` [H-08].
+
+### Bundle stats (size-limit, gzip)
+
+| Bundle | Tamaño | Límite | Uso |
+|---|---|---|---|
+| JS ESM | 13.96 KB | 16 KB | 87% |
+| JS CJS | 12.39 KB | 15 KB | 83% |
+| state.css | 713.54 KB | 800 KB | 89% |
+| components.css | 28.05 KB | 75 KB | 37% |
+| tokens.css | 6.53 KB | 30 KB | 22% |
+
+JS ESM bajó de 14.91 KB (beta.21) a 13.96 KB tras añadir
+`build.minify: "esbuild"` (H-04), absorbiendo además el coste del
+`SkeletonContainer` nuevo y los 5 tests de hook adicionales.
+
+## [1.0.0-beta.21] — 2026-05-05
+
+### Added
+- **`useControllableState`** dev warn re-aplicado vía Option E
+  (escape hatch interno `__suppressNoHandlerWarn`). Avisa cuando
+  un componente está en modo controlled (`value` definido) sin
+  `onChange` y sin el flag de suppress. Una vez por instancia.
+  Tras el revert en beta.20 por falsos positivos en
+  `Rating.SoloLectura`, ahora cada componente con modo
+  display-only legítimo (Rating con `readOnly`) suprime el warn
+  vía el flag interno.
+- **Audit consistente del hook** en los 9 componentes que lo
+  usan: Rating y Slider ahora pasan `onChange: onValueChange` al
+  hook (eliminando llamadas duplicadas locales). Switch usa
+  `__suppressNoHandlerWarn: true` permanente porque su `onChange`
+  recibe `ChangeEvent` (no boolean) y tiene un warn local más
+  específico.
+- **Script `scripts/check-css-scope-leaks.mjs`** + allowlist
+  `scope-leak-allowlist.json`. Cierra deuda capa 3.1 (PRIORIDAD
+  ALTA). Detecta riesgo de scope-leak: clases globales
+  modificadoras (`.ig-X-active`, `.ig-X-danger`…) emitidas en >1
+  elemento del mismo componente. Modo `--strict` integrado en
+  `verify:unit` pipeline. Run inicial: 420 candidatas / 6
+  allowlisted (audit case-by-case con razón documentada) / 0
+  riesgos nuevos.
+
+### Tests
+- Hook: 5 tests del warn (dispara/no dispara/escape hatch/una
+  vez por instancia).
+- Rating: 2 tests anti-regresión (`readOnly` no genera warn;
+  controlled sin readOnly y sin onValueChange sí lo genera).
+
+### Internal
+- `Rating.stories.tsx AllStates`: instancias `<Rating value={N} />`
+  marcadas `readOnly` (eran galería visual, no interactivas).
+- README.md: actualizado a "última publicación: 1.0.0-beta.20".
+
+## [1.0.0-beta.20] — 2026-05-05
+
+### Added
+- **`Card`**: prop polimórfica `as` con genéricos TS
+  (`<C extends ElementType = "div">`). Acepta strings HTML
+  (`as="article"`, `as="a"` con `href` tipado) y componentes
+  (`as={Link}` para react-router/next). Las props específicas del
+  elemento subyacente se tipan automáticamente. Story `Polimorfica`
+  añadida.
+- **`Pagination`**: modo **uncontrolled** vía `useControllableState`.
+  `currentPage` y `onValueChange` ahora opcionales; `defaultPage`
+  (default 1) inicializa el state interno. Patrón consistente con
+  Tabs / Accordion / OptionsMenu / etc. Story `Uncontrolled` añadida.
+- **`Stepper`**: modo **interactive** opt-in con `onValueChange`.
+  Cuando se pasa el callback, cada step se vuelve focuseable
+  (`role="button"` + roving tabIndex) y soporta keyboard nav
+  completo: ArrowLeft/Right/Up/Down, Home/End, Enter/Space. Sin
+  `onValueChange` permanece presentational (backwards compatible).
+  Nueva clase `.ig-step-interactive`. `aria-label="Paso N"` en
+  cada dot interactivo.
+- **`Progress`**: props `loadingLabel` (default `"Cargando"`) y
+  `formatLabel?: (percent: number) => string` para i18n del
+  `aria-label`. Cierra el inventario de strings hardcoded
+  user-facing del DS.
+- **`AllStates` matrix Ola 2 (16 componentes)**: stories
+  `chromatic.modes light+dark` para Alert, Radio, Rating, Slider,
+  Stepper, Pagination, Tooltip, Timeline, Accordion, Sidebar,
+  Navbar, ThemeSwitch, Toast, OptionsMenu, Modal, Input compound,
+  Table, Textarea, NativeSelect. Cobertura visual completa en Chromatic
+  bajo dual-mode.
+- **`useControllableState` derive mode**: `ThemeSwitch` migrado
+  a `useControllableState({ derive, setDerivedValue, ... })`.
+  Consolida los 9 componentes con state controlled/uncontrolled
+  bajo el mismo hook + soporte explícito para fuente de verdad
+  externa.
+- **`docs/CSSAPI.mdx`**: nueva sección "i18n y a11y strings" con
+  tabla de overrides + patrón de uso con `react-i18next`. Notas
+  sobre `Card.as` polimórfica y `Pagination` controlled+uncontrolled.
+- **`docs/DS_AUTOSUFFICIENCY_DEBT.md`**: capa 6 nueva
+  "Convenciones de tests unit". 6.1 ✅ regla anti-`console.error`
+  mock para warnings React (causa: vitest `isolate: false` +
+  React dedupe). 6.2 ✅ nota DOM Switch (`ig-switch` en `<label>`).
+- **`src/test-utils/`**: utilities `queryAllByRoleSafe()` y
+  `expectAtLeast()` exportadas (capa 1.5/1.6 debt doc).
+- **Tests del CONTRATO** de `useControllableState` (4 tests
+  hook-first cubriendo ambos modos × ambas direcciones de
+  transición controlled↔uncontrolled). Smokes en componentes
+  con input nativo (Rating, Slider, Switch).
+
+### Changed
+- **`Pagination`**: `currentPage` y `onValueChange` pasaron de
+  required a opcionales. Cambio API público pre-1.0.0 (sin
+  breaking productivo). Consumers que ya pasaban ambos siguen
+  funcionando idénticamente.
+- **`Stepper`**: clase global `.ig-step-active` migrada a selector
+  compound `.ig-step.ig-step-active` para evitar scope-leak al
+  wrapper `.ig-step-item.ig-step-active` (bug latente desde beta.5
+  detectado en sub-Bloque A: dejaba label en contraste 1.02).
+  Anti-regresión test añadido.
+- Defaults ES de strings user-facing (`Alert.closeLabel`,
+  `Chip.removeLabel`, `ModalClose aria-label`, `Pagination.prevLabel`/
+  `nextLabel`, `Progress.loadingLabel`, `Stepper aria-label`,
+  `Toast.closeLabel`) declarados intencionales en `CSSAPI.mdx`.
+  Audience inicial hispanohablante; cambio a EN se reevaluará en
+  1.1.0 si demanda real lo justifica.
+- **`Slider` / `Switch`** tests viejos de transición controlled↔
+  uncontrolled que afirmaban sobre warning de React vía
+  `console.error` mock reemplazados por assertions sobre
+  comportamiento observable. Los anteriores eran flaky por orden:
+  vitest `isolate: false` + React dedupe de warnings dev por
+  proceso. Documentado como regla en debt doc capa 6.1.
+
+### Fixed
+- **`Stepper`**: scope-leak CSS de `.ig-step-active` (ver Changed).
+- Documentación JSDoc de `Switch` clarifica estructura DOM
+  (`ig-switch` en `<label>` wrapper, NO en `<input>`).
+
+### Internal
+- Stories storybook con `chromatic.modes light+dark` ya
+  proporcionan dual-theme matrix sin duplicar archivos test:storybook.
+- Tracking de decisiones diferidas y deuda RC1 vive en
+  `docs/DS_AUTOSUFFICIENCY_DEBT.md`.
+- Decisión arquitectónica registrada: warn dev de
+  `useControllableState` para `value=` sin `onChange=` diferido a
+  rc.1 con escape hatch interno `__suppressNoHandlerWarn`.
+  Intento beta.20 (commit 2975e19) revertido por falsos positivos
+  en `Rating.SoloLectura` (readOnly legítimo). Diseño Option E
+  documentado en debt doc sección 1.4.
+
+### Bundle stats (size-limit, gzip)
+
+| Bundle | Tamaño | Límite | Uso |
+|---|---|---|---|
+| JS ESM | 14.91 KB | 15 KB | 99.4% |
+| JS CJS | 12.85 KB | 15 KB | 85.7% |
+| `tokens.css` | 6.53 KB | 30 KB | 21.8% |
+| `components.css` | 28.05 KB | 75 KB | 37.4% |
+| `base.css` | 453 B | 2 KB | 22.7% |
+| `reset.css` | 924 B | 2 KB | 46.2% |
+| `fonts.css` | 142 B | 1 KB | 14.2% |
+| `state.css` | 713.54 KB | 800 KB | 89.2% |
+| `design.css` (meta) | 70 B | 2 KB | 3.5% |
+
+JS ESM al 99% del budget — beta.21/rc.1 debería revisar headroom o
+subir el límite ante crecimiento de features (Card.as polimórfica
++ Stepper keyboard nav son los principales nuevos). state.css cerca
+del límite (89%) — es natural por el growth de utilities pseudo-class.
+
+## [1.0.0-beta.19] — 2026-05-04
+
+### Breaking
+- **Tooltip**: clases CSS migradas a prefijos únicos para evitar
+  colisión semántica.
+  - `ig-tooltip-{top,right,bottom,left}` → `ig-tooltip-place-{...}`
+  - `ig-tooltip-{brand,secondary,success,warning,danger,info}` →
+    `ig-tooltip-color-{...}`
+  Solo afecta a consumers vanilla con clases hardcoded; React API
+  intacta. Migración automática vía `scripts/migrate-tooltip-prefixes.mjs`.
+- **OptionsMenu**: clase de estado abierto migrada de `.open` a
+  `.ig-options-menu-open` para respetar la convención de namespace `ig-*`.
+- **Stepper**: prop `defaultActive` eliminada (era engañosa — el
+  componente nunca fue uncontrolled). Migración:
+  `<Stepper defaultActive={X}>` → `<Stepper active={X}>`. Si necesitas
+  uncontrolled, mantén `[step, setStep]` en el consumer.
+- **Navbar**: dos booleans `sticky`/`fixed` mutuamente excluyentes
+  reemplazados por un único `position?: 'sticky' | 'fixed'`.
+  Migración:
+
+  | Antes | Después |
+  |---|---|
+  | `<Navbar sticky>` | `<Navbar position="sticky">` |
+  | `<Navbar fixed>` | `<Navbar position="fixed">` |
+  | `<Navbar sticky fixed>` | (TS error, antes silencioso) |
+
+### Fixed
+- **OptionsMenu**: keyboard open salta items con `aria-disabled="true"`
+  desde el trigger (fix incompleto del bug original que solo cubría
+  `OptionsMenuItem`). Selector compartido en `optionsMenuSelectors.ts`.
+- **Tabs**: sin `value`/`defaultValue` selecciona el PRIMER tab
+  registrado, no el último. El auto-select usa `setSelectedRaw` con
+  `{ silent: true }` — ya no dispara `onValueChange`.
+- **Pagination**: clamp completo de `currentPage`, `totalPages` y
+  `siblingCount` fuera de rango (NaN, Infinity, negativos). Separación
+  `prevLabel`/`nextLabel` (children visible) de
+  `prevAriaLabel`/`nextAriaLabel` (a11y).
+- **Progress**: guards para `max ≤ 0` o no-finite.
+- **Slider**: guard NaN.
+- **Card**: `tabIndex={0}` automático cuando actsAsButton (con override
+  explícito respetado).
+- **Rating**: `readOnly` aplica `aria-readonly` al radiogroup, no
+  `disabled` a los radios (mejora a11y para SR).
+- **Checkbox**/**Switch**/**Tab**: `useLayoutEffect` con fallback
+  `useEffect` en SSR (no `() => {}`). Util compartida
+  `src/utils/useIsoLayoutEffect.ts`.
+- **Tab**: keyboard nav usa `closest('[role="tablist"]')` en lugar de
+  `parentElement` (robustez ante wrappers).
+- **Tooltip**: warn dev-only si `children` no es elemento React válido.
+- **README**: clases para migración de `<button>` corregidas
+  (`.ig-btn*`, no `.ig-button*`).
+- **igoded-design.css**: cabecera `info → axis` corregida a
+  `info → kobalium`.
+- **manager.ts** y stories Card/Avatar: hex de paleta actualizados a
+  la vigente desde beta.16 (`#5eded5` → `#3ae2f7`,
+  `#d4c2f9` → `#d2bff7`).
+- **SKILL.md**: tabla ΔE OKLab regenerada con cifras reales (eran de
+  paleta pre-beta.16).
+- **styles.test.ts**: test "7 cardinales" verificaba 6, faltaba
+  kobalium.
+- **mixColors** en `check-component-contrast.mjs`: shortest-arc para
+  hue circular (bug latente que no se disparaba con tokens actuales
+  pero podía con futuros).
+
+### Added
+- **`useControllableState<T>`** hook centralizado para patrón
+  controlled/uncontrolled, con setter `silent` opt-in. **9
+  componentes migrados**: Switch, Sidebar, Slider, Rating, Accordion
+  (single + multiple), Alert, OptionsMenu, Tabs. 9 tests del hook
+  (incluyendo `setValue` con `{ silent: true }` para auto-selects y
+  rehidratación de fuentes externas no-de-usuario).
+- **AllStates Ola 1** — 14 stories matrix con `chromatic.modes`
+  light + dark: Button, Input, Checkbox, Switch, Tabs, Progress,
+  Card, Badge, Spinner, Skeleton, Divider, Breadcrumb, Avatar, Chip.
+  Util compartida `src/stories/_matrix.tsx` con `MatrixGrid`. 28
+  snapshots Chromatic. Ola 2 (16 componentes interactivos +
+  compounds) en beta.20.
+- **Tests regresión visual AllStates** — 14 tests vía `composeStory`,
+  uno por componente Ola 1, anti-regresión de "alguien borra una
+  variant".
+- **`Fundamentos/CSS API pública`** — MDX exhaustiva con tabla
+  detallada y ejemplo HTML por los 32 componentes para consumers
+  vanilla. Linkada desde el README.
+- **`Fundamentos/Catálogo AllStates`** — índice MDX que lista los
+  matrices visuales por ola.
+- **`scripts/perceptual-allowlist.json`** con 2 excepciones
+  documentadas (`laurus-vitreus` LIGHT 0.0847,
+  `malum-rutilus` DARK 0.0706).
+- **`check-component-contrast.mjs --print-perceptual-table`** modo
+  debug para regenerar tabla del SKILL.
+- **Tests añadidos** (no exhaustivo): OptionsMenu aria-disabled (×2),
+  Tabs auto-select silent (×4), Pagination clamps (×6),
+  Pagination prev/nextAriaLabel (×2), Progress guards (×6),
+  Card tabIndex (×3), Rating aria-readonly (×2),
+  useControllableState (×9), Tab keyboard wrapped, Spinner.label i18n
+  (×3), Sidebar.ariaLabel i18n (×3).
+- **`.github/workflows/verify.yml`** — gate CI completo (lint,
+  typecheck, test:unit, test:contrast, build, verify:size) + job
+  separado `storybook` con playwright.
+- **`size-limit`** budget para `igoded-state-css.css` (techo 800 KB
+  gzip).
+- **`src/utils/env.ts`** — `isDev()` helper sin global augmentation.
+- **`src/utils/useIsoLayoutEffect.ts`** — patrón canónico SSR-safe.
+- **i18n explícitas**: `Spinner.label`, `Sidebar.ariaLabel`,
+  `Avatar.statusLabel`, `Pagination.prevAriaLabel`/`nextAriaLabel`.
+- **`scripts/migrate-tooltip-prefixes.mjs`** — pase con PostCSS AST
+  para la migración de Tooltip.
+
+### Changed
+- **`scripts/check-component-contrast.mjs`**: Check 3 ΔE OKLab
+  promovido a ERROR con umbral 0.05 + WARN umbral 0.10. Allowlist
+  explícita con drift detection (95% del valor de decisión). Cómputo
+  automático de los pares de cardinales por tema (30 totales).
+- **`dist/env.d.ts`** ya no se publica al consumer
+  (`tsconfig.build.json` lo excluye explícitamente). Componentes
+  ahora usan `isDev()` util en lugar de `import.meta.env.DEV` directo.
+- **`Modal`**: `ModalContextValue` removido del barrel export (era
+  huérfano sin `ModalContext` ni `useModal()` exportados).
+- **CSS publicados minificados con esbuild** (state.css 6.3 MB →
+  713 KB gzipped, components.css 28 KB gzipped).
+- **`design.css`** size-limit budget bajado de 5 KB a 2 KB (real
+  ~70 B gzipped).
+- **`tokens.css`** size-limit budget subido de 25 KB a 30 KB para
+  margen.
+
+### Removed
+- CSS huérfano: `.ig-modal`, `.ig-modal-backdrop` en
+  `igoded-components.css` (3 ocurrencias residuales del cleanup
+  beta.0; el componente Modal usa `<dialog>`/`.ig-dialog`).
+- Referencias prematuras a `1.0.0-rc.{1,2,3}` en código y docs
+  (sustituidas por `1.0.0-beta.8` o `pre-1.0.0-rc.1` según contexto).
+- `Stepper.defaultActive` (era prop muerta).
+- `src/env.d.ts` (sustituido por `src/utils/env.ts` con `isDev()`).
+
+### Notes
+- **2 componentes saltados en migración a `useControllableState`**
+  por razones técnicas documentadas:
+  - **`ThemeSwitch`**: triple fuente de truth (controlled prop +
+    override interno + storage cross-tab vía `useSyncExternalStore`).
+    El componente original deriva el valor en render directamente
+    de las fuentes; el hook genérico introduciría un `useState`
+    interno que en happy-dom provoca loop infinito por la cadena
+    `setItem → StorageEvent → snapshot revaluation → setState →
+    setItem`. El patrón actual es idiomático para este caso, no es
+    deuda técnica. Para post-RC1: extender el hook con modo
+    `derive: () => T` opt-in o crear
+    `useControllableStateWithStorage` dedicado.
+  - **`Modal`**: controlled-only puro (`open: boolean` requerido,
+    sin `defaultOpen`). El hook no aporta valor; siempre sería
+    `isControlled=true`.
+  - **`Checkbox`**: NO tiene `useState` interno — delega checked
+    al `<input type="checkbox">` nativo. La migración añadiría
+    complejidad sin valor.
+- **Migration guide útil — `useControllableState` API**:
+
+  ```ts
+  const { value, setValue } = useControllableState({ value, defaultValue, onChange });
+
+  // Acción del usuario (dispara onChange):
+  setValue(newValue);
+
+  // Auto-select interno o rehidratación post-mount (NO dispara onChange):
+  setValue(newValue, { silent: true });
+  ```
+
+- **Tag retroactivo `v1.0.0-beta.0`** apuntado al commit
+  `8a1c7ef5f030ba7bf227b53a0b8469fa442149e3` (`feat: rewrite as
+  TypeScript + React 19 design system`, 2026-05-01) para
+  trazabilidad histórica completa de la rama 1.0.x.
+
+### Bundle stats (gzip)
+
+| Archivo                                    | Real     | Budget  | Margen |
+|--------------------------------------------|----------|---------|--------|
+| `dist/index.js` (ESM)                      | 14.37 KB | 15 KB   | 4%     |
+| `dist/index.cjs`                           | 12.36 KB | 15 KB   | 18%    |
+| `dist/styles/igoded-design.css`            | 70 B     | 2 KB    | 97%    |
+| `dist/styles/igoded-tokens.css`            | 6.53 KB  | 30 KB   | 78%    |
+| `dist/styles/igoded-components.css`        | 28.05 KB | 75 KB   | 63%    |
+| `dist/styles/igoded-base.css`              | 453 B    | 2 KB    | 78%    |
+| `dist/styles/igoded-reset.css`             | 924 B    | 2 KB    | 55%    |
+| `dist/styles/igoded-fonts.css`             | 142 B    | 1 KB    | 86%    |
+| `dist/styles/igoded-state-css.css`         | 713.5 KB | 800 KB  | 11%    |
+
+### Test stats
+- Suite unit final: **515** tests (`vitest run --project unit`).
+- 36 archivos de test, 100% verde.
+- 14 nuevos AllStates regression tests (composeStory + selectores
+  CSS).
+
+## [1.0.0-beta.18] — 2026-05-03
+
+### Changed
+- **Test cleanup pre-RC1**: refactor masivo de tests unit.
+  - **Variantes/sizes/forma cosmética**: colapsadas en `describe.each`
+    parametrizado. Antes había 10 asserts sueltos por componente
+    (uno por valor del eje); ahora un solo bloque parametrizado
+    cubre todos los valores con una assert densa. Misma señal de
+    contrato CSS, código 5× más compacto. Aplicado en Badge, Button,
+    Card, Checkbox, Chip, Divider, Input, Modal, Navbar, Progress,
+    Radio, Spinner, Switch, Tabs, Tooltip, Avatar, Rating.
+  - **Estados funcionales con efecto observable**: `loading` del
+    Button ahora expone `aria-busy` además de la clase, y el test
+    valida ARIA + behavior (no solo clase). Combo `loading + disabled`
+    cubierto explícitamente.
+  - **Negative asserts** (`not.toHaveClass(default)`, `not.toHaveClass(success)`
+    cuando outline) eliminados — paranoia frágil que rompía con
+    cualquier rename.
+  - **`className` merge desde consumer**: añadido test por componente
+    (Badge, Button, Switch, Checkbox, Radio) verificando que las
+    clases del consumer se mergean sin pisar las del componente. Bug
+    recurrente que Chromatic no detecta.
+  - **Stories `play()` duplicadas**: eliminadas `Checkbox.ToggleInteraction`
+    y `Radio.SelectInteraction` (mismo aserto que el unit test, 10×
+    más lentas).
+
+### Added
+- `Button` ahora expone `aria-busy={loading}` (antes solo clase).
+  Mejora a11y para SR.
+
+### Test stats
+- Suite unit final tras refactor: **453** (`vitest run --project unit`).
+  Con `describe.each` el conteo bruto sube por la expansión de cada
+  parametrización; lo relevante es que el contrato CSS/ARIA queda
+  cubierto con menos archivos y asserts más densos.
+- Asserts cosméticos sueltos eliminados: ~80.
+- Tests transversales nuevos: 5 (`className` merge), 1 combo de
+  estado peligroso (`loading + disabled`).
+- Nota: a partir de esta versión NO publicamos delta numérico
+  contra la versión anterior; el conteo puede oscilar libremente
+  con cada refactor de parametrización y no es una métrica
+  contractual del paquete.
+
+## [1.0.0-beta.17] — 2026-05-03
+
+### Fixed
+- **Textarea / NativeSelect estados `error` y `success` invisibles**: las
+  reglas `.ig-input-error` / `.ig-input-success` (línea 6227) estaban
+  declaradas ANTES de `.ig-textarea`, `.ig-textarea-auto` y `.ig-native-select`
+  (líneas 6306, 6343, 6376), todas con la misma especificidad 0,1,0.
+  Las reglas posteriores definían `border-color` y pisaban al estado de
+  validación. Resultado: pasar `state="error"` o `state="success"` no
+  cambiaba el borde del componente. Fix: reglas con doble clase (0,2,0)
+  para `.ig-textarea.ig-input-error`, `.ig-native-select.ig-input-error`, etc.
+  Input no estaba afectado porque `.ig-input` se declara antes de las
+  reglas de estado.
+
+## [1.0.0-beta.16] — 2026-05-03
+
+### Changed
+- **Vitreus reposicionado** de H≈194.83° (cyan puro sRGB, artefacto
+  histórico de la paleta) a H=207.50° (centro perceptual matemático
+  verde↔azul en OKLCH, punto medio entre verde Hering ~145° y azul
+  Hering ~270°). Hex: `#053a40` (lux) / `#3ae2f7` (nox). Decisión
+  fundacional — vitreus es el color brand del DS y su identidad
+  declarada es "el azul-verde matemáticamente medio en OKLCH"; el hex
+  anterior no cumplía esa intención. Contraste AAA preservado en los
+  5 fondos del tema en ambos modos (LIGHT 11.78, DARK 11.91 sobre
+  fundus opuesto). Las alphas (`--ig-vitreus-alpha-{10,20,30,50,70}`)
+  y `--ig-text-heading` heredan automáticamente porque están definidas
+  con `color-mix` sobre `--ig-vitreus`. Re-baseline de Chromatic
+  requerida para snapshots con brand, text-heading o sus alphas.
+
+### Fixed
+- **Badge default vs Badge pill**: ambos usaban `--ig-rounded-full` y
+  eran visualmente idénticos. Ahora el default es `--ig-rounded-md`
+  (chip estilo etiqueta, esquinas suavemente redondeadas) y `pill`
+  mantiene `--ig-rounded-full` (cápsula).
+
+## [1.0.0-beta.15] — 2026-05-03
+
+### Fixed
+- **Elevación en LIGHT** (`--ig-bg-surface`, `--ig-bg-elevated`): los
+  tokens mezclaban con `white` para "elevarse", pero como el body en
+  LIGHT es `--ig-fundus-lux` = `#faf9fc` (casi blanco) el resultado era
+  prácticamente igual al body. Cards, accordions, dropdowns, modals,
+  toasts, sidebars y tabs se solapaban con el fondo. Ahora la elevación
+  en LIGHT se consigue OSCURECIENDO ligeramente con tinte azulado
+  coherente (`--ig-cinis-lux` 4% para surface, 8% para elevated). DARK
+  intacto.
+
+## [1.0.0-beta.14] — 2026-05-03
+
+### Fixed
+- **Divider con texto + variante** pintaba el `<div>` padre entero
+  con el color de variante. La regla `.ig-divider-brand
+  { background-color: var(--ig-vitreus); }` (del divider básico
+  horizontal `<hr>`) matcheaba también al
+  `<div class="ig-divider-with-text ig-divider-brand">` por compartir
+  la clase modifier. Resultado: caja cyan brillante con el texto cyan
+  encima — invisible. Fix: scope a `.ig-divider.ig-divider-brand` para
+  que solo aplique al divider básico (que sí lleva la clase base
+  `.ig-divider`).
+
+## [1.0.0-beta.13] — 2026-05-03
+
+### Changed
+- **Divider con texto variante** invierte la jerarquía de color:
+  ahora el TEXTO recibe el accent (`vitreus`, `axis`, ...) y las
+  líneas se quedan en `--ig-border-subtle`. Antes (beta.10–12) las
+  líneas iban con accent y el texto en `cinis`; las dos líneas
+  alineadas creaban una banda continua perceptual y el texto quedaba
+  apagado. Patrón Material UI: las líneas son sutiles, el color
+  semántico vive en el label.
+
+## [1.0.0-beta.12] — 2026-05-03
+
+### Removed
+- Stories aisladas `Indeterminate` de `Checkbox` y `Switch`.
+  Confundían — el click no parecía hacer nada porque el sticky
+  behavior re-aplicaba `indeterminate=true` sin un parent que
+  gestione state. La nueva story `MasterSelectAll` (beta.11) ya
+  muestra el indeterminate en su estado inicial y demuestra el
+  patrón canónico.
+
+## [1.0.0-beta.11] — 2026-05-03
+
+### Added
+- Stories `Componentes/Checkbox/MasterSelectAll` y
+  `Componentes/Switch/MasterSelectAll` con el patrón canónico de
+  indeterminate (maestro + grupo de hijos). El `indeterminate` no es
+  un tercer estado del toggle, es una etiqueta visual derivada del
+  estado de los hijos — patrón usado por GitHub, Gmail, Material UI
+  checkbox group, Ant Design Tree, etc.
+
+### Reverted
+- Cambios en `Checkbox` y `Switch` glyph publicados en `beta.10`
+  (`var(--ig-fundus)` adaptativo): diagnóstico erróneo, el reporte
+  "indeterminate no hace nada" era de comportamiento (sticky
+  behavior), no de contraste visual. El glyph vuelve a
+  `var(--ig-fundus-lux)`. El cambio del Divider en `beta.10` se
+  mantiene.
+
+## [1.0.0-beta.10] — 2026-05-03
+
+### Changed
+- **Divider con texto variante**: el texto ya no toma el color del
+  accent (era idéntico a las líneas y se confundía visualmente). Va
+  en `--ig-cinis`. (Posteriormente revisado en `beta.13`: ahora el
+  texto SÍ va en accent y las líneas en subtle.)
+
+### Fixed (luego revertido en beta.11 — diagnóstico erróneo)
+- ~~Glyph del Checkbox/Switch (`tick`, línea de indeterminate, thumb)
+  cambiado a `var(--ig-fundus)` adaptativo. Pretendía resolver bajo
+  contraste blanco-sobre-cyan en DARK; resultó no ser el bug
+  reportado.~~
+
+## [1.0.0-beta.9] — 2026-05-03
+
+### Fixed
+- **Progress bar invisible**: el componente renderizaba el bar como
+  `<span class="ig-progress-bar">`. Como `<span>` es `display: inline`
+  por defecto y el CSS no le aplicaba `display: block`, el `width`
+  inline se ignoraba — todas las variantes se veían iguales (solo el
+  track gris del fondo). Cambiado a `<div>`, alineado con la doc del
+  CSS que ya prescribía `<div>`.
+
+## [1.0.0-beta.8] — 2026-05-03
+
+Consolida el trabajo que estuvo bajo `rc.1` / `rc.2` / `rc.3` (tags
+borrados, no llegaron a publicarse) más los fixes finales sobre
+`Progress` y `Checkbox`/`Switch` detectados al revisar el visual.
+
+### Added
+- **Prop `indeterminate?: boolean`** en `Checkbox` y `Switch`. Hasta
+  `beta.7` el tercer estado solo se podía aplicar via ref-callback
+  (`ref={el => { if (el) el.indeterminate = true }}`), patrón
+  documentado pero poco ergonómico. Ahora basta `<Checkbox indeterminate>`
+  / `<Switch indeterminate>`. Internamente un `useEffect` sincroniza la
+  prop con `el.indeterminate` nativo (la propiedad del DOM, ya que
+  `indeterminate` no es atributo HTML válido). El ref-callback sigue
+  funcionando — los componentes ahora usan un `internalRef` y forwardean
+  al ref del consumer si se pasa.
+- **El estado `indeterminate` es sticky tras click**. El navegador limpia
+  `el.indeterminate` automáticamente cuando el usuario clica un checkbox
+  con `.indeterminate=true` (toggle nativo a checked/unchecked). Si la
+  prop sigue `true`, `handleChange` re-aplica `el.indeterminate=true` —
+  solo el parent decide cuándo salir del estado mixto pasando
+  `indeterminate={false}`. Sin esto, tras el primer click el visual
+  pasaba a checked normal aunque la prop dijera "parcial".
+- **`aria-checked="mixed"`** automático en `Checkbox`/`Switch` cuando
+  `indeterminate=true`, para que NVDA/JAWS/VoiceOver anuncien el estado
+  parcial correctamente.
+- **Visual `:indeterminate`** en `Checkbox` y `Switch`. Hasta `beta.7`
+  el `<input>` nativo se ocultaba detrás de un overlay y las reglas CSS
+  solo cubrían `:checked` / `:focus-visible` / `:disabled`, así que
+  `el.indeterminate=true` no tenía diferencia visual.
+  - **Checkbox**: fondo lleno (color de variante, igual que `:checked`)
+    y glyph "−" (línea horizontal centrada).
+  - **Switch**: thumb centrado en el track con background de variante
+    (Material-like — comunica "ni on ni off" sin glyphs adicionales).
+  - Las 6 variantes (`brand`/`secondary`/`success`/`warning`/`danger`/`info`)
+    tienen su color correspondiente en ambos.
+- **Story `Switch.Indeterminate`** (no existía).
+- **Story `Checkbox.Indeterminate`** refactorizada: usa
+  `args: { indeterminate: true }` en vez del ref-callback (mejor ejemplo).
+
+### Changed
+- **Progress bars siempre usan los `-nox`** (cardinales brillantes) en
+  ambos temas, no los adaptativos `var(--ig-{role})`. Razón: en LIGHT
+  los `-lux` tienen luminosidad y chroma demasiado bajos para
+  distinguirse en una franja de 8-12 px (las 6 variantes se veían
+  "todas oscuras" y costaba diferenciar hue). El track sigue adaptativo
+  via `var(--ig-progress-track)`. Los demás componentes mantienen
+  tokens adaptativos porque tienen texto encima donde el contraste
+  WCAG sí importa; en `Progress` el bar es bloque sólido sin texto.
+- **`Progress.Variantes`** story rediseñada — antes 5 barras
+  `size="md"` (8 px) sin label. Ahora 6 barras `size="lg"` (12 px)
+  con `<span class="ig-story-label">` arriba de cada una. `play()`
+  afirma via `getComputedStyle` que las 6 barras tienen
+  `background-color` distinto — regresión si alguien rompe la cascade
+  `.ig-progress-{v} .ig-progress-bar`.
+- **8 stories de Interacción propagan `args`** — `Radio.SelectInteraction`,
+  `Modal.OpenInteraction`, `Accordion.Interaction`,
+  `Sidebar.ToggleInteraction`, `Stepper.Interactivo`,
+  `Tabs.KeyboardNavInteraction`, `Toast.FireInteraction`,
+  `Tooltip.A11yInteraction` tenían `render: () => (<Comp prop="…" />)`
+  con valores hardcoded, lo que dejaba el panel Controls desconectado
+  del render. Ahora `render: (args) => (<Comp {...args} … />)` con
+  overrides finales solo donde el `play()` necesita un valor concreto
+  (state controlado, `defaultValue` predecible, payload del toast).
+  Cuando hace falta un default distinto al del meta se añade
+  `args: {…}` a nivel de story. `FireToastButton` se inlinea para
+  leer `args.title/message/variant`.
+- **`laurus` recalibrado de H=149° a H≈140°** para subir la separación
+  perceptual ΔE OKLab `laurus ↔ vitreus` en LIGHT de ≈0.054 (rozaba el
+  umbral del Check 3 = 0.05) a ≈0.074. Hex nuevos:
+  `--ig-laurus-lux: #143d0a`, `--ig-laurus-nox: #6aed4a` (antes
+  `#113d1c` / `#5eeb82`). Geometría dual preservada (L_lux=0.319,
+  L_nox=0.841, ΔH=0.11°, suma 1.160). El alias `--ig-success` sigue
+  apuntando a `--ig-laurus`, ningún consumer que use rol `success` debe
+  tocar nada. Las alphas `--ig-laurus-alpha-{10,20,30,50,70}` siguen
+  siendo `color-mix` y arrastran el cambio automáticamente.
+  Visualmente: más vegetal puro, menos "menta caribeña". Re-baseline
+  de Chromatic obligatorio.
+
+### Fixed (Storybook only — no afecta al paquete publicado)
+- **Toggle light/dark del toolbar de Storybook funciona también en
+  páginas MDX puras** (`Contrast`, `DesignTokens`, `Introduction`,
+  `Spacing`, `Variants`). Antes el toggle solo afectaba a las Stories
+  CSF; las MDX se quedaban en el último `data-theme` aplicado por la
+  Story anterior. Causa raíz: el decorator `withThemeByDataAttribute`
+  solo se ejecuta cuando se monta una Story; las MDX sin `<Story of=…>`
+  ni `<Canvas>` que referencie un export son páginas estáticas que no
+  disparan decorators. Fix: `.storybook/preview-head.html` se suscribe
+  al canal `__STORYBOOK_ADDONS_CHANNEL__` y reacciona al evento
+  `updateGlobals` aplicando `data-theme` al `<html>` del iframe.
+  Idempotente con el decorator existente.
+
+### Documentation
+- **README** bloque "Estado": ahora documenta `1.0.0-beta.8` con la
+  paleta final + rename `cyaneus → kobalium` (de `beta.7`) +
+  recalibración de `laurus` + nueva prop `indeterminate` +
+  Progress bars `-nox`.
+- **README** ejemplo de `Pagination` corregido —
+  `ariaLabel="Pagination"` → `aria-label="Pagination"` (era
+  inconsistente con la migración a `aria-*` estándar de `beta.4`).
+- **`igoded-components.css`** cabecera: `info → kobalium (cyan)` →
+  `info → kobalium (cobalt blue)` (residuo del sed `cyaneus → kobalium`
+  de `beta.7` que dejó `(cyan)` colgando). Aclarado "6 roles UI (el
+  sistema tiene 7 cardinales)" para no confundir cardinales con roles.
+- **Migration note ampliada** sobre el rename `cyaneus → kobalium` de
+  `beta.7` distinguiendo:
+  - **API estable** (no tocar nada): `var(--ig-info)`, `.ig-bg-info`,
+    `.ig-text-info`, `.ig-alert-info`, `.ig-badge-info`, `.ig-btn-info`,
+    etc. (30+ clases con sufijo de **rol**, no de cardinal).
+  - **Primitivos internos** (renombrar si los usabas directo):
+    `--ig-cyaneus` / `--ig-cyaneus-{lux,nox}` /
+    `--ig-cyaneus-alpha-{10,20,30,50,70}` / `--ig-text-on-cyaneus` →
+    `--ig-kobalium*` / `--ig-text-on-kobalium`.
+
+### Self-correction
+- La entrada de `1.0.0-beta.6` decía que `.ig-story-canvas` se movía a
+  `.storybook/preview-head.html`. La ruta correcta es
+  `.storybook/storybook.css` (consumido como `className` desde
+  `.storybook/preview.tsx`). El `preview-head.html` no se tocó en
+  `beta.6` — sigue como en `beta.5` con la inyección de
+  `data-theme="dark"`.
+
+## [1.0.0-beta.7] — 2026-05-03
+
+### Renamed (BREAKING — token rename + hue reassignment)
+- **`cyaneus` → `kobalium`** y **reasignación de hue de cyan H≈214° a
+  cobalt blue H≈260°**. Razón: la separación perceptual ΔE OKLab entre
+  `cyaneus` y `vitreus` (brand teal) era marginal (≈0.054 en dark), lo
+  que producía confusión visual cuando ambos cardinales aparecían
+  contiguos. Con kobalium en H≈260° la separación pasa a ≈0.123 (cómoda).
+  El nombre cambia porque "cyaneus" describía un cyan que ya no existe
+  como color real; "kobalium" (latinización de cobalto) refleja el nuevo
+  hue. Hex nuevos: `--ig-kobalium-lux: #082e6d`, `--ig-kobalium-nox: #b1ccf7`
+  (ambos cumplen geometría dual L_lux≈0.32, L_nox≈0.84, ΔH≤10°, AAA contra
+  los 5 fondos del tema).
+
+  **Migración**:
+  - Si tu código usa solo el alias `var(--ig-info)`, **no tocar nada** —
+    el alias sigue funcionando y ahora apunta internamente a `--ig-kobalium`.
+  - Si tu código referencia literalmente `--ig-cyaneus`, `--ig-cyaneus-lux`,
+    `--ig-cyaneus-nox`, `--ig-cyaneus-alpha-{10,20,30,50,70}` o
+    `--ig-text-on-cyaneus`, **renombrar a `--ig-kobalium*`** /
+    `--ig-text-on-kobalium`.
+  - Re-baseline de Chromatic obligatorio: el cambio de hex altera todas
+    las stories que usan info/cyaneus en cualquier forma.
+
+### Added
+- **Check 3 (warning) en `scripts/check-component-contrast.mjs`**:
+  separación perceptual ΔE OKLab ≥ 0.05 entre pares de cardinales de UI
+  activa (los 6 cardinales menos `cinis`, que es texto del cuerpo). Útil
+  para detectar cuándo un cardinal nuevo entra en zona de confusión con
+  uno existente. **No falla CI** — solo imprime aviso. Razón de no
+  promocionar a error en esta beta: hay pares preexistentes (p.ej.
+  `vitreus↔laurus` en light, ΔE≈0.054) que rozan el umbral; auditarlos
+  con cabeza fría requiere su propio commit.
+
+### Changed
+- Doc cabecera de `igoded-tokens.css`, `SKILL.md`, `Introduction.mdx`,
+  `Variants.mdx`, `Palette.stories.tsx`: actualizada la descripción de
+  kobalium (cobalto, H≈260°) y la migration note desde cyaneus.
+
+## [1.0.0-beta.6] — 2026-05-03
+
+### Changed (BREAKING — visual)
+- **`reset.css` ya no estiliza `<button>` con la marca**. Hasta beta.4
+  el reset aplicaba `background: var(--ig-vitreus); color: var(--ig-text-on-vitreus)`
+  a todo `<button>` sin clase. Desde beta.5 los `<button>` que importas
+  con `reset.css` salen `background: transparent; color: inherit;
+  border: 0; padding: 0; cursor: pointer;`. Si tu app dependía de que
+  cualquier `<button>` nativo apareciese con look brand "gratis", ahora
+  los verás transparentes sobre el fondo de su contenedor. Migración:
+  añade la clase `.ig-button` (o variante `.ig-button-primary`,
+  `.ig-button-secondary`…) a esos `<button>`. Razón del cambio: evitar
+  combinaciones bg/color heredadas que rompían contraste cuando un
+  wrapper aplicaba sus propios colores (caso real: SidebarItem con
+  texto `cinis` sobre `<button>` con bg vitreus → ratio 1.06).
+
+### Documentation
+- `igoded-components.css` cabecera: `info → axis` corregido a
+  `info → cyaneus`.
+- `igoded-tokens.css` "CUÁNDO USAR": `info` quitado de la línea de Axis
+  y añadido a una línea propia para Cyaneus.
+- `SKILL.md` y `README.md`: documentado el scope real de
+  `npm run test:contrast` (qué cubre y qué no).
+
+### Added
+- Bloque `@media (forced-colors: active)` quirúrgico en
+  `igoded-components.css` para estados `*-active`/`*-selected` (Tabs,
+  Pagination, Stepper, Chip, Sidebar, Navbar) → `Highlight`/`HighlightText`,
+  e inputs (`.ig-input`, `.ig-native-select`, `.ig-textarea`) → `Field`/`FieldText`.
+  Complementa el mapeo semántico de `igoded-tokens.css` sin duplicarlo.
+- Wrapper canvas de Storybook movido de inline-style a clase
+  `.ig-story-canvas` en `.storybook/preview-head.html`.
+
+## [1.0.0-beta.5] — 2026-05-03
+
+### Changed (BREAKING)
+- **Rediseño total de la paleta cardinal — geometría OKLCH uniforme**.
+  Los 14 hex de los pares `{cardinal}-{lux,nox}` (vitreus, axis, cinis,
+  rutilus, laurus, malum, cyaneus) cambian para cumplir
+  `L_lux ≈ 0.32 ± 0.04`, `L_nox ≈ 0.84 ± 0.04`, `ΔH OKLCH ≤ 10°` entre
+  lux/nox del mismo cardinal y AAA frente a los 5 fondos del tema.
+  Diferencia visible más fuerte: `vitreus-nox` pasa de teal pastel
+  `#5eded5` a cyan eléctrico `#30e6e6`; `laurus-nox` a verde brillante
+  `#5eeb82`; `axis-lux` a violeta `#411271`. Resto: cambios sutiles.
+  `--ig-fundus-{lux,nox}` se mantienen.
+- **`--ig-bg-{surface,sunken,elevated,muted}` derivados de `fundus`**.
+  Ahora se generan vía `color-mix(in oklch, var(--ig-fundus-{lux,nox}), …)`.
+  Si cambias `fundus`, todo el tema acompaña automáticamente. Output
+  visual ±1 punto del previo.
+- **`engines.node`**: `>=20` → `>=22`. Node 20 (Iron) llegó a EOL el
+  2026-04-30 y ya no recibe parches de seguridad. El VPS de despliegue
+  (Debian 13) corre Node 22.22 LTS (Jod), que pasa a ser el floor
+  soportado oficialmente.
+
+### Fixed (a11y / contraste)
+- 32 violaciones WCAG AA por texto `--ig-fundus-lux` hardcoded sobre
+  fondos cardinales adaptativos en Badge (×6), Button outline:hover (×6),
+  Tabs Pills (×6), Pagination active (×1), Stepper dot active+complete
+  (×2) y Chip selected (×2). Ahora todos usan `--ig-text-on-{role}`,
+  que invierte automáticamente entre claro/oscuro según el tema.
+- **Reset CSS de `<button>`**: ya no fuerza `background: vitreus +
+  color: text-on-vitreus`. Pasa a `transparent + inherit` para que
+  cualquier wrapper (SidebarItem, otros) pueda aplicar sus colores sin
+  riesgo de mezcla incoherente (texto cinis sobre fondo vitreus =
+  ratio 1.06 que el runner cazó tras el fix de Bloque 1).
+- **Runner storybook+axe local**: deja de ser ciego al modo dark.
+  Antes, `useEffect` del theme decorator aplicaba `data-theme="dark"`
+  POST-paint y chromium headless evaluaba en light (vía
+  `prefers-color-scheme: light`), donde no había violaciones. Fix
+  con `.storybook/preview-head.html` que inyecta `data-theme="dark"`
+  antes del primer paint del iframe.
+- **Token huérfano**: eliminado `--ig-text-on-cinis` (cinis nunca se
+  usa como background, solo como color de texto-body).
+- **`--ig-text-muted` en light**: ajustado a `#5e5667` (ratio 5.06 sobre
+  el nuevo `bg-muted`). Antes daba 4.45 (< 4.5 AA).
+
+### Added
+- **`scripts/check-component-contrast.mjs`** como guardrail CI: parsea
+  `igoded-components.css` con postcss y valida (a) WCAG ≥ 4.5 en cada
+  par bg/color resuelto en ambos temas y (b) geometría OKLCH dual
+  (ΔH ≤ 10°, L_lux/nox y suma dentro de banda). Conectado a
+  `npm run test:contrast` y `npm run verify`.
+- Story `Fundamentos/Paleta` (visualización viva de los 7 cardinales
+  con hex, OKLCH (L,C,H) y ratios contra `fundus`).
+- `:root { color-scheme: dark light }` + por tema, para que los
+  scrollbars y form-controls del UA sigan el tema activo.
+- Bloque `@media (forced-colors: active)` que mapea los semánticos
+  críticos a system-color keywords (CanvasText, Canvas, LinkText,
+  GrayText) para Windows High Contrast Mode.
+- Token `--ig-theme-transition` con override en
+  `@media (prefers-reduced-motion: reduce)`.
+- Cabecera explícita en `igoded-tokens.css` documentando los 3 tiers
+  de tokens (primitivos / semánticos / escalas universales) y los
+  guardrails de CI.
+- `SKILL.md` con las reglas inviolables del DS (geometría dual, uso de
+  `text-on-*`, prohibición de `fundus-*` directo, separación
+  info/secondary, escala neutral universal).
+
+## [1.0.0-beta.4] — 2026-05-02
+
+Última pasada de pulido pre-`1.0.0`. Cierra los hallazgos de la auditoría
+externa sobre beta.3 + endurecimiento adicional (size budgets, dev-warnings,
+config split lib vs dev/storybook, registry de Tabs robusto frente a
+defaultValue inválido).
+
+### Fixed (a11y / regression / robustness)
+- **Rating**: `value` o `defaultValue` fuera de `[0, max]` se clampa
+  silenciosamente. `value=10 max=5` antes dejaba todos los radios con
+  `tabIndex=-1` (tablist sin tab stop accesible). Ahora va al tope. `max`
+  no entero se redondea hacia abajo, mínimo 1.
+- **Tabs `defaultValue` inválido**: si el value pasado no matchea ningún
+  `<Tab>` montado, fallback al primero registrado tras un useEffect
+  post-mount (no durante el registro tab-a-tab — eso producía un falso
+  positivo cuando los Tabs se montaban en orden alfabético). En modo
+  controlled NO se auto-corrige; solo console.warn dev-only.
+- **Tab.tsx pre-register con `useLayoutEffect`** (en cliente; SSR cae a
+  noop): el primer paint visible ya tiene tab activo, sin flicker.
+- **Slider**: `defaultValue` array (legalmente permitido por
+  `InputHTMLAttributes` aunque `<input type="range">` no lo soporta) ya no
+  se reenvía al DOM como `[object Array]`. Filtramos a number/string
+  válidos.
+- **Modal**: el effect de sincronización `open` ahora resetea
+  `closingFromSyncRef` en su cleanup. No hay leak real (state muere con
+  unmount), pero queda explícitamente correcto frente a re-mounts en
+  desmontaje rápido (navegación SPA durante animación de cierre).
+- **Reset.css `<button>` color**: usaba `--ig-fundus-lux` fijo que daba
+  contraste bajo en dark (texto casi blanco sobre teal claro). Ahora usa
+  `--ig-text-on-vitreus` adaptativo. Se aplicó en beta.3 pero faltaba
+  validación AA en dark — verificada ahora con axe.
+
+### Added
+- **`vite.lib.config.ts` separado** del `vite.config.ts` general. El
+  build de librería (`npm run build`) usa explícitamente esta config con
+  `dts` plugin + `copyDesignSystemStyles`. Más robusto que el guard env
+  `STORYBOOK !== "true"` de beta.3 (Storybook ya nunca puede contaminar
+  el build de librería, independientemente de qué env vars setee).
+- **`size-limit` en CI** con budgets por archivo:
+  - `dist/index.{js,cjs}` → ≤ 15 KB gzipped (real: ~10.7 KB ESM)
+  - `dist/styles/igoded-design.css` → ≤ 5 KB (real: 1 KB, es solo @import)
+  - `dist/styles/igoded-tokens.css` → ≤ 25 KB (real: 22 KB)
+  - `dist/styles/igoded-components.css` → ≤ 75 KB (real: 67 KB)
+  - `dist/styles/igoded-base.css` → ≤ 2 KB (real: 1.4 KB)
+  - `dist/styles/igoded-reset.css` → ≤ 2 KB (real: 1.6 KB)
+  - `dist/styles/igoded-fonts.css` → ≤ 1 KB (real: 0.9 KB)
+  Script `npm run verify:size`. Forma parte de `npm run verify`.
+- **Card**: dev-only `console.warn` si `interactive` + `onClick` está
+  presente pero sin `role="button"`. Avisa una vez por instancia. La
+  card sin role no activa por teclado, este caso suele ser un descuido.
+- **`Fundamentos/Variantes` (nueva MDX)**: visualización del mapeo
+  `variant` → cardinal con los 7 colores nuevos (incluye `cyaneus`).
+  Documentación de override por consumer + ratios WCAG AA.
+- **JSDoc `@example` en hooks públicos**: `useTheme`, `useToast`,
+  `useTabs`, `useAccordion`, `useAccordionItem`, `useOptionsMenu`,
+  `useSidebar`. Mejora autocompletado en LSP del consumer.
+- **Test SSR-hydration ThemeSwitch**: `localStorage.theme="light"` gana
+  al default `dark` y NO se sobreescribe en el primer effect.
+- **`src/env.d.ts`**: declaración tipada de `import.meta.env.DEV/PROD`
+  para que los warnings dev-only de Card/Tabs typechequen sin pisar el
+  `vite-env.d.ts` (que está excluido del build para no exportar
+  declaraciones de módulos `*.css`/`*.svg` al consumer).
+
+### Changed (BREAKING — momento ideal pre-1.0)
+- **`ariaLabel` prop → `aria-label` HTML estándar** en 9 componentes:
+  `Pagination`, `Spinner`, `Stepper`, `Rating`, `Sidebar`, `SidebarNav`,
+  `NavbarNav`, `Tabs.TabList`, `Breadcrumb`, `Progress`, `Avatar`,
+  `Timeline`. Cada uno extrae `aria-label` del rest con fallback ES por
+  defecto. Coherente con el resto del DS (ThemeSwitch ya usaba esto
+  desde beta.3) y con la convención web.
+  - **Migration**: rename en tu JSX `ariaLabel={...}` → `aria-label={...}`.
+- **`docs.defaultName: "Documentación"` → `"Docs"`** (ya estaba en beta.3,
+  reconfirmado: URLs ASCII, sin %C3%B3n).
+- **README CSS imports actualizado**: 7 entradas → 8 entradas (incluye
+  `fonts.css`); la versión del estado pasa de beta.2 a beta.4.
+- **README script anti-flash de tema**: fallback `|| "light"` →
+  `prefers-color-scheme: dark` con fallback `dark` (alineado con el
+  branding dark-first del DS). Try/catch para entornos sin localStorage.
+- **`tokens.css` comentarios**: "FUNDUS + 6 CARDINALES" → "FUNDUS + 7
+  CARDINALES" + tabla de los 7 incluyendo `CYANEUS`. Mención obsoleta a
+  `@font-face` en tokens.css eliminada (vive en fonts.css desde beta.3).
+- **`package.json#keywords`**: quitado `"headless"` (engañoso, el DS es
+  CSS-first opinionated). Añadidos `"design-tokens"`, `"css-first"`,
+  `"themeable"`, `"dark-mode"`.
+- **`vite.config.ts` simplificado**: ya no contiene `build.lib` ni `dts`
+  (eso vive en `vite.lib.config.ts`). Se queda con plugins comunes
+  (react, optimizeDeps) compartidos por playground dev y Storybook.
+
+### Migration desde beta.3
+1. **Si tu JSX usa la prop `ariaLabel`** en alguno de estos componentes,
+   renombra a `aria-label`:
+   ```diff
+   - <Stepper ariaLabel="Checkout">
+   + <Stepper aria-label="Checkout">
+   - <Pagination ariaLabel="Paginación principal">
+   + <Pagination aria-label="Paginación principal">
+   - <TabList ariaLabel="Cuenta">
+   + <TabList aria-label="Cuenta">
+   ```
+   La búsqueda+reemplazo es trivial: tu IDE te marcará los errores TS
+   (la prop ya no existe en los tipos).
+2. **Si tu app inyecta el script anti-flash de tema** del README,
+   actualízalo al nuevo (system-aware + dark fallback) — el viejo
+   pisaba la preferencia del usuario en sistemas dark-first.
+
+### Coverage
+- Statements 92.29% · Branches 86.44% · Functions 95.17% · Lines 95.11%
+- 339 unit tests + 179 storybook (axe-a11y) = 518 tests verdes.
+
+## [1.0.0-beta.3] — 2026-05-02
+
+Pasada agresiva pre-`1.0.0`: a11y real, SSR-safe, naming/types fix y un
+nuevo color cardinal para diferenciar `info` de `secondary`.
+
+### Fixed (a11y / regression)
+- **Input/NativeSelect/Textarea**: `aria-describedby` que el consumer pasara vía
+  `{...rest}` se sobreescribía a `undefined` cuando no se pasaba la prop
+  `describedBy`. La propia story `FormularioCompleto` estaba rota.
+  Solucionado con un nuevo helper `mergeDescribedBy(native, prop)` que
+  concatena ambos. +6 tests de regresión.
+- **Rating**: añadido **roving tabindex + keyboard nav completo** (←/→/↑/↓,
+  Home, End, Space, Enter) para cumplir el patrón WAI-ARIA APG de
+  radiogroup. Antes solo respondía a click. +9 tests de regresión.
+- **ToastProvider SSR**: ya no produce hydration mismatch. Antes el
+  servidor renderizaba inline y el primer paint cliente ya pintaba portal.
+  Ahora arranca inline (idéntico al server) y conmuta al portal en el
+  primer `useEffect` post-mount.
+- **OptionsMenu a11y**: el selector de navegación excluye también
+  `[aria-disabled="true"]` (anchors no tienen `disabled` HTML); items
+  aria-disabled bloquean activación por click y por Enter/Space; **button**
+  menuitem ahora también tiene `tabIndex={-1}` (antes anchor sí lo tenía
+  y button no, inconsistente).
+- **Tabs sin `defaultValue`**: el tablist quedaba sin tab stop si el
+  consumer no pasaba `value`/`defaultValue` (todos los tabs `tabIndex=-1`).
+  Ahora un registry interno selecciona el primer `Tab` montado de forma
+  automática.
+- **Modal `onClose` doble disparo**: cuando el consumer hacía
+  `setOpen(false)`, el effect llamaba `dialog.close()` que disparaba el
+  evento `close` nativo y volvía a invocar `onClose`. Añadido flag
+  `closingFromSyncRef` que distingue cierre user-driven de cierre por
+  sincronización con la prop.
+- **ThemeSwitch `aria-label`**: ahora se puede sobrescribir vía rest
+  (i18n). Antes el hardcoded ganaba al rest por orden de spread.
+- **Slider `defaultValue` string/array**: `defaultValue="60"` (string)
+  dejaba el state interno en `0` mientras el `<input>` mostraba 60.
+  Ahora normaliza a número finito; arrays se ignoran (no soportados por
+  `<input type="range">`).
+
+### Added
+- **`igoded-fonts.css` (nuevo, opt-in)** — `@import` de Google Fonts
+  (Electrolize/Saira/JetBrains Mono). **Antes vivía dentro de
+  `tokens.css`**, lo que metía un request remoto en el bundle de
+  cualquier consumer. Ahora `tokens.css` declara solo los `--ig-font-*`
+  con fallback `system-ui`/`monospace`. Storybook lo importa
+  explícitamente en `preview.tsx`. Expuesto como
+  `reactigoded/styles/fonts.css`.
+- **Color cardinal `cyaneus`** (cian-azul) — nuevo `--ig-cyaneus-{lux,nox}`
+  + `--ig-text-on-cyaneus-{lux,nox}`. `--ig-info` ahora apunta a `cyaneus`
+  en vez de a `axis` (que es violet/secondary). Antes `secondary` e `info`
+  eran visualmente idénticos; ahora son colores distintos. Verificado
+  WCAG AA en light y dark.
+- **`mergeDescribedBy` helper** en `src/utils/`. Tests propios + integrados
+  en Input/NativeSelect/Textarea.
+- **Tabs `register` API** en `TabsContext` para auto-selección del primer
+  Tab.
+- **Modal `closingFromSyncRef`** flag interno.
+- **`test:unit:ci` script** (vitest con `--isolate --pool=forks`) para CI
+  estricto. El `test:unit` por defecto sigue con `isolate=false` por el
+  workaround WSL.
+- **4 stories interactivas con `play`**: `Input/TypeInteraction`,
+  `NativeSelect/ChangeInteraction`, `Slider/KeyboardInteraction`,
+  `Stepper/Interactivo` (ahora con play que verifica `aria-current`).
+
+### Changed
+- **`vite.config.ts`** ahora sólo activa el modo lib build cuando
+  `command === "build" && mode === "production" && STORYBOOK !== "true"`.
+  Antes `mode === "production"` solo, lo que disparaba `dts` plugin y
+  `copyDesignSystemStyles` también durante `storybook build` (cada deploy
+  de igoded.es).
+- **`docs.defaultName: "Documentación"` → `"Docs"`**: el unicode `ó`
+  generaba URLs `componentes-x--documentaci%C3%B3n` feas y problemáticas
+  para search/SEO. Las páginas MDX de Foundations siguen en español.
+- **Tema dark-first uniforme**: `useTheme` (ya estaba dark), `ThemeSwitch`
+  (era light) y Storybook `withThemeByDataAttribute` (era light) ahora
+  todos default `"dark"`. Coherente con el branding.
+- **Card type assertion**: `onClick?.(event as unknown as MouseEvent)`
+  desde el handler de Enter/Space sustituido por `event.currentTarget.click()`,
+  que dispara un MouseEvent auténtico.
+- **Alert** `style={{flex:1, minWidth:0}}` inline → clase
+  `.ig-alert-content` publicada en `components.css`.
+- **Card story `Interactiva`** quita `ig-story-clickable` (la clase
+  `.ig-card-interactive` ya implica `cursor: pointer`, y la helper de
+  storybook.css confundía a consumers que copiaran el código).
+- **`eslint.config.js`** comentario `postinstall` → `prepare` (coincide
+  con el script real de `package.json`).
+- **README** métricas obsoletas (~285/~175) → texto sin números fijos.
+
+### Migration
+- Si confiabas en el `@import` de Google Fonts dentro de `design.css` /
+  `tokens.css`, ahora también necesitas:
+  ```ts
+  import "reactigoded/styles/fonts.css";
+  ```
+  …o self-host con `next/font`/`@fontsource/*` y override de los
+  `--ig-font-*`.
+- **Cambio visual: `info` ahora es CYAN, no violet.** Si tu app usa
+  `<Toast variant="info">`, `<Alert variant="info">`, `<Badge variant="info">`,
+  `<Card variant="info">`, `.ig-btn-info`, `.ig-bg-info`, etc., verás un
+  color cian-azul (`--ig-cyaneus`) en vez del violet (`--ig-axis`) de antes.
+  La razón: en beta.0–beta.2, `secondary` e `info` apuntaban ambos a `axis`
+  y eran visualmente idénticos. Ahora `info` tiene su propio cardinal
+  `cyaneus` (WCAG AA verificado en light + dark). Si necesitas el aspecto
+  anterior, sobreescribe `--ig-info: var(--ig-axis)` en tu `:root`.
+- Si usabas `<Toast variant="default">` en el primitivo (no lo deberías
+  desde beta.1, ya estaba renombrado a `neutral`), nada cambia aquí.
+- Si `defaultValue` de Slider venía como string, antes el value visible no
+  cuadraba con el internal — ahora cuadra. Si dependías del bug, comprueba.
+
+## [1.0.0-beta.2] — 2026-05-02
+
+Refactor de la arquitectura CSS y pulido completo del catálogo Storybook.
+
+### Added
+- **`igoded-base.css` (nuevo, ~3 KB)** — globales mínimos del DS:
+  `box-sizing` universal, `html` (scroll-behavior, scrollbar-gutter,
+  accent-color, caret-color), scrollbar tematizada (`::-webkit-scrollbar*`),
+  `::selection`, `@media (prefers-reduced-motion: reduce)`,
+  `(prefers-contrast: more)`, `(forced-colors: active)`. Standalone, depende
+  solo de tokens. Expuesto como `reactigoded/styles/base.css`.
+- **`igoded-components.css` (nuevo, ~270 KB)** — utilities + componentes
+  (clases `.ig-*`). Sin selectores globales. Depende de tokens + base.
+  Expuesto como `reactigoded/styles/components.css`.
+- `.storybook/manager.ts` no era nuevo; sí lo es **`managerHead`** en
+  `main.ts`: meta description, og:title/description/url/type, theme-color,
+  canonical, twitter:card, y un MutationObserver que reescribe
+  `<title>` `"… ⋅ Storybook"` → `"… · Igoded Design System"` en cada
+  navegación. Sin polling.
+- `docs.defaultName: "Documentación"` (era `"Docs"`).
+- Helpers en `.storybook/storybook.css`: `.ig-story-card-{sm,md,lg}`,
+  `.ig-story-clickable`, `.ig-story-min-h-{sm,md,lg}`,
+  `.ig-foundation-{grid,swatch,token-row,contrast,typo}` para los MDX.
+- README: tabla detallada de globales que aplica `base.css`, escenarios
+  de import por caso de uso (5 filas).
+
+### Changed
+- **`igoded-design.css` ahora es solo un meta-importer** que hace
+  `@import` de `tokens.css` + `base.css` + `components.css`. Backward
+  compat: un consumer que importa `design.css` recibe lo mismo que antes.
+- **`igoded-tokens.css` es ahora 100% variables CSS**: el
+  `*, *::before, *::after { box-sizing: border-box }` se movió a
+  `base.css`. Tokens.css ya no tiene ningún selector global.
+- **Stories renombradas (ES uniforme)**:
+  - `Switch.Toggle` → `InteracciónToggle` (no era prop literal).
+  - `Accordion.Controlled` / `Sidebar.Controlled` /
+    `ThemeSwitch.Controlled` → `Controlado` (consistencia con
+    `Switch.Controlado` y `Rating.Controlado`).
+- **Card stories**: 4 inline `style={{ maxWidth, cursor }}` → clases
+  helper `.ig-story-card-md`, `.ig-story-card-lg`, `.ig-story-clickable`.
+- **MDX foundations** (`Spacing.mdx`, `Contrast.mdx`, `DesignTokens.mdx`)
+  migrados de inline styles a clases `.ig-foundation-*`. Markup más
+  limpio y consistente entre páginas.
+- **`igoded-design.css` cabecera reescrita**: las ~190 líneas de índice
+  legacy con números de línea desactualizados ("RESET BASE OPCIONAL...215"
+  apuntaban a líneas que ya no existen) sustituidas por bloque conciso
+  que documenta la arquitectura modular real.
+
+### Migración (sin breaking)
+- `import "reactigoded/styles/design.css"` sigue funcionando igual que en
+  beta.1. Internamente ahora `@import`a 3 archivos en vez de 2.
+- Si importabas `tokens.css` esperando el `box-sizing` global, ahora
+  importa `base.css` también (`tokens.css` + `base.css` reproduce el
+  comportamiento anterior).
+
+## [1.0.0-beta.1] — 2026-05-02
+
+Pasada de pulido orientada a percepción del catálogo Storybook + saneamiento
+de la API pública antes del `1.0.0`.
+
+### Added
+- `igoded-tokens.css` (nuevo, ~98 KB) — solo variables `--ig-*`, keyframes y
+  `@font-face`, sin clases de componentes. Útil para consumers que construyen
+  su propia capa de componentes sobre los tokens del DS.
+  Expuesto como `reactigoded/styles/tokens.css`.
+- `igoded-reset.css` (nuevo, ~5 KB) — estilos por defecto para HTML nativo
+  (h1-h6, p, a, button, input, table…). **Opt-in**, no se importa
+  automáticamente con `design.css`. Expuesto como
+  `reactigoded/styles/reset.css`.
+- `Button.appearance="link"` — quinta apariencia (aplica `ig-btn-link`,
+  ignora variant).
+- `Card.appearance="outline"|"filled"` — sustituye al flag `filled` (ver
+  Changed).
+- Card activación Enter/Space automática cuando `interactive` +
+  `role="button"` + `onClick`. Encadenable con `onKeyDown` del consumer
+  (preventDefault cancela). +6 tests.
+- `.storybook/manager.ts` con branding Igoded (createTheme dark,
+  Vitreus/Axis colors, brandTitle "Igoded Design System", fonts Saira +
+  JetBrains Mono).
+- `.storybook/storybook.css` con clases helper `ig-story-{stack,row,grid,
+  frame,form,shell,label}` para layouts de stories. NO se publica al paquete.
+- Foundations docs MDX: `Spacing.mdx` (visualización de los 25 tokens
+  `--ig-space-*`, equivalencias Tailwind, guidance) y `Contrast.mdx`
+  (9 pares texto+fondo verificados WCAG AA + garantías a11y de CI).
+
+### Changed
+- **CSS reset extraído** de `igoded-design.css` a `igoded-reset.css` opt-in.
+  En `design.css` queda solo `*, *::before, *::after { box-sizing: border-box }`
+  (necesario para el sizing de los componentes). Eliminado el comentario
+  legacy "ESTÁ COMENTADO A PROPÓSITO" que mentía sobre el estado del reset.
+- **CSS modular split**: `igoded-design.css` ahora `@import`a
+  `igoded-tokens.css` internamente. Self-containment preservado (consumer
+  que importa solo `design.css` recibe lo mismo que antes).
+- **Storybook preview**: eliminado wrapper global con padding/100vh que
+  rompía `layout: "fullscreen"` en Navbar/Sidebar. Eliminado import de
+  `state.css` (7.1 MB innecesarios en HMR). Backgrounds reactivados con
+  4 valores tokenizados (base/surface/muted/sunken).
+- **Stories en español uniforme**: 28 archivos renombrados
+  `Default→PorDefecto`, `Variants→Variantes`, `Sizes→Tamaños`. Otros nombres
+  ya en ES (`ConImagen`, `Compuesta`, `Interactiva`, etc.) o nombres
+  técnicos propios (`Pills`, `Vertical`, `KeepMounted`, `BackdropBlur`)
+  intactos.
+- **External assets fuera del catálogo**: pravatar/placehold.co reemplazados
+  por SVG data URIs inline; 11 emojis de Sidebar reemplazados por SVG inline
+  feather-style (consistencia visual entre SO/navegadores).
+- **Storybook propFilter** excluye HTML attributes heredados
+  (HTMLAttributes, AriaAttributes, DOMAttributes,
+  {Button,Input,Textarea,NativeSelect,Anchor}HTMLAttributes) — Controls panel
+  muestra solo props del propio package.
+- **Glass Navbar story**: gradiente Tailwind genérico
+  (#4f46e5/#ec4899/#f59e0b) → gradientes con tokens
+  `--ig-vitreus-alpha-*` + `--ig-axis-alpha-*` sobre `--ig-bg-base`.
+- **~40 inline styles repetidos** en stories migrados a clases
+  `.ig-story-*`. Los inline styles component-internal (sizing de Card,
+  padding de inputs internos, márgenes decorativos) se conservan.
+- Comentario WCAG en `igoded-design.css:437` corregido AAA → AA (coincide
+  con keyword `wcag-aa` y los memos reales de tokens).
+
+### Breaking
+- `Button.variant="outline"|"ghost"|"link"` → migrar a
+  `Button.appearance="outline"|"ghost"|"link"`. `ButtonVariant` se reduce a
+  los 6 colores semánticos. Razón: dos ejes ortogonales
+  (color × estilo visual) en vez de mezclar 9 valores en uno.
+- `Card.filled` (boolean flag) → migrar a `Card.appearance="filled"`. El
+  comportamiento default (`appearance="outline"`) es idéntico.
+- `Toast.variant="default"` → renombrado a `"neutral"` por consistencia con
+  Alert. Comportamiento idéntico (no añade clase de variant).
+- Estilos para HTML nativo (`<h1>`, `<p>`, `<a>`, `<table>`…) ya **no se
+  cargan** desde `reactigoded/styles/design.css`. Si los necesitas, importa
+  también `reactigoded/styles/reset.css`.
+
+## [1.0.0-beta.0] — 2026-05-01
+
+Cambios desde la migración inicial JSX→TSX. Agrupa el trabajo de las 6
+auditorías profundas previas a `1.0.0`.
+
+### Added
+- 32 componentes React 19 + TypeScript estricto, con tests unit
+  (happy-dom) + Storybook tests (Chromium real + axe-a11y) + 16 stories
+  con `play` (interaction tests).
+- Compound components: `Accordion`, `Card`, `OptionsMenu`, `Input`, `Modal`,
+  `Navbar`, `Sidebar`, `Stepper`, `Table`, `Tabs`, `Timeline`, `Toast`.
+- Hooks públicos: `useTheme`, `useToast`, `useAccordion`,
+  `useAccordionItem`, `useOptionsMenu`, `useSidebar`, `useTabs`.
+- API controlled+uncontrolled en `Accordion`, `Alert`, `OptionsMenu`,
+  `Sidebar`, `Slider`, `Switch`, `Tabs`, `ThemeSwitch`, `Rating`.
+- `Modal.loading` (aplica `ig-dialog-loading` + `aria-busy`).
+- `Badge.dot` (modo punto sin texto, con `role="img"` automático).
+- `Button.appearance="solid"|"outline"|"ghost"` combinable con variant
+  color (12 clases CSS antes huérfanas ahora expuestas).
+- `Input/NativeSelect/Textarea.describedBy` (string|string[]) — auto-`aria-describedby`.
+- `Slider.onValueChange(v:number)` — alternativa al `onChange` nativo.
+- `Slider aria-valuetext` automático cuando hay `formatValue`.
+- `Modal.aria-labelledby` automático vía `ModalContext`+`ModalHeader`.
+- `Switch role="switch"` + `aria-checked` (refactor desde checkbox plano).
+- `Tooltip.aria-describedby` concatena con el del child existente.
+- `BreadcrumbItem` discriminated union por `current`.
+- `Step.aria-current` en el span del círculo (no en el div wrapper).
+- `Textarea.auto` con `field-sizing: content` (Chrome/Edge 123+,
+  Safari 17.4+; Firefox cae al `rows` por defecto).
+- `browserslist` declarado en package.json.
+- Stories `play` (interaction) en 16 componentes interactivos.
+- Tests "fuera de provider" para los 5 hooks de context.
+- Tests de cleanup en unmount: OptionsMenu limpia listeners globales,
+  ToastProvider limpia timers.
+- Tests de transición controlled↔uncontrolled (warning de React).
+- `scripts/strip-orphan-css.mjs` — limpia con postcss utilities
+  pseudo-class del `state-css` que apuntan a tokens eliminados.
+
+### Changed
+- `Toast.closable` → `Toast.dismissible` (alineado con `Alert`).
+- `Rating.onChange` → `Rating.onValueChange` (consistencia con `Tabs`,
+  `Accordion`, `Slider`).
+- `Spinner.label` / `Progress.label` / `Rating.label` → `ariaLabel`
+  (estandarización a camelCase).
+- `Stepper.active` ahora opcional + `defaultActive`.
+- `Alert.open` ahora opcional + `defaultOpen` + `onOpenChange`.
+- `dist/styles/index.css` ahora usa `@import` (no concatenación física —
+  ahorra 7.85 MB en el unpacked).
+- Publish sin sourcemaps de JS (`.js.map`/`.cjs.map`); `.d.ts.map` sí se
+  publica.
+- `tsconfig.json#exactOptionalPropertyTypes: true`.
+- Sección CSS "78b. DIALOG" renombrada a "78. DIALOG / MODAL" (la 78
+  legacy se eliminó).
+- `Tabs`, `Sidebar`, `OptionsMenu`, `Modal`, `Accordion`, `ToastProvider`
+  con `Provider value` memoizado (`useMemo`+`useCallback`).
+- `OptionsMenu.setOpen` ahora `useCallback` con deps correctas (era stale
+  closure cuando `onOpenChange` cambiaba entre renders).
+- `Button.disabled || loading` (antes `??`, permitía que `disabled={false}`
+  anulara `loading={true}`).
+- `{...rest}` ahora se aplica ANTES de role/aria/tabIndex/disabled/hidden
+  en todos los componentes, evitando que un consumer pueda sobreescribir
+  atributos críticos accidentalmente.
+
+### Removed
+- `.ig-modal-*` (variante legacy con `<div>` — el componente React usa
+  `<dialog>` nativo). 11 clases CSS + 7 tokens `--ig-modal-*` + 164
+  utilities pseudo-class autogeneradas.
+- `.ig-input-{brand,secondary,info,danger,warning}` (variantes color
+  nunca expuestas en TS).
+- `dist/test/setup.d.ts` del publish (Vitest setup, no público).
+- `useState` muerto en `Stepper` (era presentational, no necesitaba
+  estado interno).
+- Cast `alt={alt ?? ""}` en `Avatar` (`alt` ya required en el tipo
+  `AvatarImage`).
+
+### Fixed
+- 4 missings de barrel export: `useOptionsMenu`+`OptionsMenuContextValue`,
+  `useTabs`+`TabsContextValue`, `SidebarContextValue`,
+  `ToastContextValue`, `ModalContextValue`.
+- Colisión de `Theme` (definido en dos sitios) — ahora única fuente en
+  `hooks/useTheme.ts`.
+- `Badge.outline-{variant}` y `Badge.pill` referenciaban CSS inexistente.
+- `Spinner.size="xs"` referenciaba CSS inexistente.
+- `TabPanel.tabIndex={isActive ? 0 : -1}` (antes siempre 0, panel oculto
+  era focusable).
+- Tooltip ya no sobreescribe `aria-describedby` del child existente.
+
+### Métricas finales
+- Pack tarball: 860 KB.
+- 32 unit test files / 285 tests + 32 storybook test files / 175 tests.
+- 0 TSX→CSS missings, 0 hooks/contexts sin barrel, 0 CSS huérfanas reales.
+- Bundle ESM: 50 KB / gzip 11 KB para 74 componentes.