6 Commits (46da0edd1a2c3fcb8a5f32216d51d7200876db8f)

Author	SHA1	Message	Date
dev	5638d67fde	tooling(theming): el censo aprende a leer la válvula del canon — clase `exception` ... Global 58 % → **59 %** sin tocar una línea de CSS: 54 knobs que eran deuda resultan ser desviaciones que el canon ya había firmado. `recipe-contract` §3 dice que una desviación anotada `/* literal: <razón> */` EN SU PROPIA DECLARACIÓN es válida, y `component-audit` la honra desde siempre (`declarationWindow` + `/literal:/i` en R-2.1, R-2.6 y R-2.7). El censo era el único instrumento que no: su `strip()` blanquea los comentarios ANTES de clasificar, así que las **81 anotaciones del catálogo** contaban como literales sin excusa. Dos instrumentos, un canon, dos respuestas — y la que mandaba era la del que no sabía leerlo. Ahora un literal anotado cae en la clase **`exception`, fuera del ratio** como `system`, y por la misma razón: no es que un tema no lo alcance, es que el canon ya aceptó por escrito que ahí no va un token. **54 knobs en 12 componentes**: `prose` 21 (su escala editorial em-relativa, que su README documenta como decisión — «No 5× duplicated scale»), `proof-of-human` 16 (la escena de tono fijo), `palabras` 3, `timeline` 2 (73 % → **77 %**), `result` 1 (86 % → **90 %**), y siete más con una cada uno. Detalles que costaron medición: - **La anotación vale para la DECLARACIÓN entera**, no sólo para su primera línea: un valor partido en varias líneas lleva la nota al final. Se comprueban todas las líneas que abarca la declaración. - **`strip()` blanquea en el sitio** (sustituye por espacios, conserva los saltos), así que el cuerpo despojado y el crudo quedan alineados línea a línea y basta con guardar el crudo al lado. - Muta-prueba: retirar una anotación de `prose` mueve el knob de `exception` a `literal` (21 → 20) y el conteo vuelve al restaurarla. Efecto colateral bueno: cada ficha gana una **§1.4 «Excepciones firmadas»** que las LISTA con su razón. Estaban escritas en el CSS y no se leían desde ninguna parte; ahora la ficha del componente las enseña, que es donde se decide si una sigue siendo cierta. Las 163 fichas cambian porque la plantilla cambia (sección nueva + la línea de reparto); el README de la auditoría gana la fila de la clase y la nota de que `system` y `exception` quedan fuera del denominador. Guards: `--names` 4.105 claves, DESVIADAS 0 · component-audit PASS · docs:check 0 · `check` con 72 errores globales y 0 en los ficheros tocados. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago
dev	1c4f9518bb	uix(theming): tres techos que no son deuda — el PUENTE DE PALETA no se acuña ... Sin cambios de código: los veredictos §5 de `tag-group` (65 %), `stepper` (79 %) y `timeline` (73 %), y la clase registrada. Los tres tienen `global` a CERO. Lo único fuera de alcance son sus privados `--_{c}-palette-*`: el puente THM-2 que la capa compartida alimenta POR INSTANCIA desde `[data-color]`. **Un público encima del puente (`--tag-group-selected-bg: var(--_tag-group-palette-surface)`) dejaría que un tema lo fijara y matara en silencio el `color=` de cada instancia** — la misma clase de daño que «declarar un público de facto mata una escala» (`knob`). Y no hace falta: los componentes ya exponen sus nueve roles × variante como claves públicas (91 en `tag-group`). Ésa ES su superficie de color, y está completa. `timeline` suma una segunda razón, también firmada: sus `--_timeline-hue-*` son un CONMUTADOR —cada `data-intent` los re-apunta a las ranuras de rol y el intent por defecto al puente—, y aplanarlo obligaría a duplicar cada regla por intent (doctrina F2-B, cinco precedentes). MEDIDO, para no adjudicar de oído: de las **687** declaraciones del catálogo que leen un privado, **130 leen un `--_{c}-palette-*`**, y son las que dominan la columna `private` de todo componente con paleta — tag-group 14/14, stepper 11/11, radio-group 10, checkbox 8, file-upload 8, calendar / editable / los tres grids 7 cada uno. Consecuencia que queda escrita en §13: **el techo de un componente con paleta no es el 100 %**, y su cifra no compara con la de uno sin ella, porque el denominador incluye un puente que por diseño no se acuña. Si algún día se quiere comparabilidad, la salida es una clase `bridge` en el censo — no acuñar los tokens. Los otros seis heredan la razón cuando les toque, pero ojo: ésos tienen ADEMÁS knobs `global` y sí les toca trabajo real. Los cuatro literales de los tres son identidad anotada: el `line-height: 1` del botón de quitar y el del glifo del marcador, el `100%` de layout del stepper y los dos `1em` que hacen que título y descripción del timeline hereden el tamaño escalado del item en vez del tamaño UA del encabezado. docs:check 0. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago
dev	a9acf8d0c4	uix(theming): el censo aprende que un privado DERIVADO sí alcanza — 50 % → 56 % ... Seis puntos de alcance sin tocar una línea de componente: **la medición estaba mal, no el código**. EL DEFECTO. F0 encargaba «detección "privado que deriva de público" (leer `--_c-x: var(--c-y)` en la misma receta y reclasificar)». Se implementó a medias: el censo CALCULA `derives` y lo imprime en la columna «¿deriva de un público?» de la §3 de cada ficha, pero **el contador nunca lo usó** — esos knobs seguían puntuando como deuda. Medido: **240 privados en 59 componentes** estaban en ese estado, es decir, haciendo exactamente lo que la doctrina prescribe («privados sólo si derivan de públicos») y penalizados por ello. Lo destapó tokenizar `avatar`: sus 17 privados YA leían públicos (`--_avatar-size: var(--avatar-size-md)`), así que no había nada que tokenizar — había que arreglar el instrumento. LA CORRECCIÓN. Segunda pasada tras recoger privados y knobs: un knob que lee `var(--_c-x)` pasa a `public` si ese privado alcanza un público. El cierre es **TRANSITIVO** (`--_a: calc(var(--_b) * .3)` alcanza si `--_b` alcanza) con conjunto de visitados para que un ciclo no lo cuelgue. **Muta-prueba** (obligatoria, memoria `a-guard-that-inspects-nothing-passes`): apuntar `--_avatar-radius` al primitivo crudo baja avatar de 75 % a 72 % y el knob vuelve a `private`; revertirlo lo devuelve a 75 % y deja el árbol idéntico. EFECTO MEDIDO: - Global **50 % → 56 %** · privados 625 → 341 · al 100 % 10 → 14 · <20 % 22 → 20. - `avatar` 36 % → **75 %**, `picker-shell` 76 % → **95 %**, `menu-dial` 25 % → 38 %, y otras 51 fichas con cifras nuevas — **ninguna por cambio de código**. - Los READMEs de `picker-shell` y `menu-dial` se actualizan con la cifra nueva y con la razón, para que nadie crea que el componente cambió. ⚠ **Cualquier cifra anterior a este commit no es comparable con las de ahora.** Queda escrito en el handoff. Y un hueco de F0 que sale al hacerlo, registrado en §13: **el test del SUELO que el plan pedía NO EXISTE** («alcance global ≥ el de hoy y literales ≤ 614 — el número sube o el test falla»). Hoy nada impide que el alcance BAJE entre sesiones: sólo se vería mirando la cifra a mano. Con el censo ya endurecido, es el momento de escribirlo. Gates: `component:audit` 162 PASS / 4 NEEDS-WORK (preexistentes) · `--names` DESVIADAS 0 · suite eidos sin rojos nuevos · rtl:check 0 · docs:check 0 · el censo compila. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2 months ago
dev	e20e8b8095	docs(theming): el informe habla el idioma nuevo — y el fleco del README, cerrado ... Al rendir cuentas del repaso de los 7 salió un fleco: el README de gradient-builder mencionaba `checker-color` por su clave SUELTA, sin el prefijo `--gradient-builder-`, y el codemod busca tokens completos — quedó con el nombre muerto. Dos líneas corregidas, más las dos del §5 de su ficha. Y la causa de fondo: las 170 fichas del informe llevaban desde el codemod citando el contrato con los nombres viejos en sus secciones generadas. Regenerado entero (`--report`): 69 fichas cambian, los 171 veredictos §5 escritos a mano sobreviven (verificado), `docs:check` 0. El censo del informe registra 5.199 knobs · 1.837 públicos — cuatro menos que el suelo del codemod, que son EXACTAMENTE las cuatro declaraciones de hover bespoke que la firma 3 retiró (checkbox, splitter, switch, drp ×2 −1 nueva del checked). El alcance global sigue en 37 %. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago
dev	cef2d32f16	uix(combobox): el campo y su panel pasan a tokens públicos, con la talla resuelta donde manda ... Segundo del eje theme-reach. El combobox tenía UN token propio (`content-z`) y todo lo demás atado a primitivos globales o enterrado en privados: alcance 0 %. Ahora son 106 claves públicas y el 76 % medido — lo que queda fuera son tres hovers que esperan firma, seis literales de layout y doce knobs que pasan por privados que ya derivan de un público. La talla sigue el canon de dos piezas (coordenada + nombre resuelto), pero con una diferencia que el DOM impone: los resueltos del control se emiten sobre `control` e `input`, no sobre el root, porque el `data-size` que manda vive en el control — y el input suelto lo necesita fuera de él. Los del panel se emiten sobre `content`, que viaja por portal y nunca vería un token del root. Es el precedente de `select` aplicado donde toca. Altura, tipografía y separación del control consumen la coordenada del bundle `--size-{k}-*`; el relleno inline SE DESVÍA del bundle en cuatro tallas y conserva su valor de hoy — la desviación queda visible en el contrato en vez de redondearse a la coordenada, que habría sido un cambio visual disfrazado de limpieza. El chip conserva sus expresiones (`control-height − inset`, `control-font-size − offset`), así que mover el control sigue arrastrándolo. El centinela cazó un fallo real a mitad del trabajo: la primera pasada dejó vivos los ocho bloques `[data-…][data-size='…']` de la receta, que pisaban los tokens nuevos con los valores viejos. El diff de computed daba cero JUSTAMENTE porque la ruta vieja seguía mandando; sin centinela habría pasado por bueno. Verificación: diff de computed vacío sobre 1.566 valores en ocho estados — reposo, las cinco tallas, el panel ABIERTO y hover. Centinela 67/106 automático y el resto verificado a mano: `content-z` alcanza (80 → 4321) aunque viva en el wrapper flotante; placeholder, disabled e ink del trigger forzando su estado; los del panel abriéndolo por teclado. Los siete nombres resueltos no se mueven por diseño — el tema mueve la coordenada. Los catorce `selected-tag-*`, los tres `separator-*` y `scrollbar-inset` no son verificables en esta demo (no monta modo múltiple, ni separadores, ni scroll): queda dicho, con su consumidor comprobado en la receta, en vez de darlos por buenos. Un token nace inerte y se anota como tal: `content-font-family` y `content-line-height` los pisa `[data-depth='overlay']` con la misma especificidad — es la tipografía de portal del Build contract, y tocarla sería otro eje. Guards: component:audit PASS · eidos-lint 0 invalid · suite eidos sin rojos nuevos · rtl:check 0 · docs:check 0 · el guard del bundle obligó a apuntar `indicator-size` e `item-indicator-size` a `--size-sm-icon-size`. El informe `docs/audit/theming/` se regenera entero, así que todas las fichas actualizan su fecha de medida; las que cambian de contenido son combobox y gradient-builder. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago
dev	2591ec2f03	docs(theming): la auditoría de alcance de tema, componente a componente, con su propuesta ... El censo medía el eje y no lo explicaba: 5.205 knobs en dos tablas del plan no dicen QUÉ knob de QUÉ línea no alcanza un tema, ni qué token habría que crear. Ahora `theming-census.ts --report` escribe la auditoría entera bajo `docs/audit/theming/`: un README con la vista de conjunto y 170 fichas — 162 recetas con CSS + 8 componentes sin receta, el árbol completo de `eidos/components/`. Cada ficha de receta: knobs fuera de alcance con fichero:línea Y selector (agrupados por clase), sistema transversal aparte, los privados con la columna que decide («¿deriva de un público?»), y una PROPUESTA de corrección — el token a declarar en `base.ts` con su valor VERBATIM y su scope TSC. La propuesta deriva los nombres de recipe-contract §1 y theming §6.7; donde la doctrina no decide, marca `⚠ decisión` en vez de inventar. Y no propone acuñar lo que la doctrina prohíbe: lo que posee una capa compartida, el foco, la capa de estado, un token prestado de otra receta, un shorthand o un eje físico. Las 8 fichas sin receta dicen —medido, no supuesto— dónde vive su visual: el componente que componen (icon-button → button), la capa que consumen (affix → viewport-placement) o la receta ajena que pinta sus attrs (svg → badge/button). Defectos del instrumento corregidos en el mismo pase, todos encontrados mirando la salida: un `@import` pegado al primer selector se comía 2 knobs de color-picker (el suelo del censo no puede moverse); `:not(:disabled)` se leía como estado y producía `hover-disabled-*`; un knob que lee un privado se proponía a sí mismo en vez de resolverse por talla; `--icon-size-sm` se reportaba como préstamo del componente `icon` (ahora el préstamo se verifica contra las claves del dueño en `base.ts`); y el default de talla salía sin nombrar en vez de `-md`. Verificación: censo global idéntico al suelo publicado (5205 · 1621/33% · 856 · 1880 · 614 · 234) y COMPONENTE A COMPONENTE contra la tabla §9 del plan — 0 diferencias en 162 · regenerar dos veces da el árbol idéntico · el bloque de veredicto escrito a mano sobrevive · docs:check 0 errores sobre 813 docs · prettier limpio (el árbol generado entra en .prettierignore junto a eidos/generated). Las 10 primeras fichas llevan ya su veredicto de revisión: análisis correcto en las 10, propuesta apta en 2 (gradient-builder como piloto, combobox con cinco correcciones — dos de ellas evitaban romper el default), y 5 que no se tokenizan en solitario porque son alias de --calendar-*/--field-* y esperan la decisión de familia. Cuatro destaparon privados con prefijo ajeno o abreviado declarados en su propio CSS. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago