8 Commits (1f8ce293bb3234790b1986f5d9f8f950a21dc5c4)

Author	SHA1	Message	Date
dev	1f8ce293bb	fix(theming)!: avatar - el contrato dice la verdad: 4 claves, cero desviadas ... Las ultimas CUATRO claves fuera de gramatica de las 4.558 publicas del catalogo, resueltas cada una por lo que ES (no eran cuatro iguales): - `badge-color-custom-contrast` -> `badge-fg-custom-contrast`: la unica TINTA real y alcanzable. Nombre derivado DE la gramatica D-TH.6 (la ranura se sustituye EN SU SITIO; `custom` no es interactivo ni rol, va detras) con el precedente firmado scrim-fg-over-dark - y es la salida literal del clasificador que consume R-5.3. Renombre a mano (el codemod ABORTA sobre la IIFE de avatar - deuda registrada en 13): value-preserving, verificado con sonda dirigida (la clave vieja movia antes y no despues; la nueva al reves). - `ring-color-custom` y `badge-color-custom` RETIRADAS del contrato publico: canales de valor INALCANZABLES (puerta data-*-custom y escritura inline nacen de la misma expresion - mentiras bajo R-5.4). Mecanismo: canal privado de envoltorio `--_avatar-*-color-custom` + respaldo currentColor (el patron de las 5 privadas-de-envoltorio del parque, 5/5 sin declaracion en receta), NO borrado (el CSS las lee) NI privada plana (cero precedente). Ley 8.bis re-aplicada: cero lectores fuera de avatar, re-barrido. - `group-carve-color` EXENTA en NAME_EXEMPT con razon medida: alimenta box-shadow (geometria del carve, no tinta; alcanza en 59 instancias) - `fg` seria gramatica correcta con semantica peor. Medido: sonda 7.4 0/576 - pixel visible IDENTICO (anillo ambar, insignia violeta, tinta white) e instancia imposible identica (currentColor preserva el default retirado) - Tokens 88 -> 86 EN VIVO con el nombre nuevo (captura revisada por el supervisor) - censo --names: DESVIADAS 0 EN 0 COMPONENTES (4.556 claves) - centinela exit 0 - lint 0 - docs-check 0/0 - vitest 442+1 ajeno - check 0 atribuibles. Hallazgo de instrumento NUEVO, adjudicado y registrado en 13: el chooser del centinela elige el valor por NOMBRE y no conoce `fg` MEDIAL (su prueba de tinta es `fg$`): las 5 claves que la propia D-TH.6 fabrica (badge-fg-custom- contrast, bubble-fg-in/-out, scrim-fg-over-dark/-light) reciben 1234px, invalido para color - y el veredicto depende de si el respaldo coincide por azar (bubble-fg-* leen vivas POR ACCIDENTE). Arreglarlo obliga a re-verificar el ledger - firma de instrumento aparte. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2 months ago
dev	5c8e707a0d	docs(theming): 164 fichas regeneradas — dos perdían prosa medida, y el generador es el culpable ... Una sesión regeneró todas las fichas de docs/audit/theming con el --report del censo y las dejó sucias en el árbol. Antes de commitearlas las clasifiqué una a una en vez de mirar la cifra: - 155 sólo cambiaban la FECHA de medida. Inocuo, y correcto: el censo corrió hoy. - 7 traían cifras nuevas y buenas (collapsible y toolbar, que acaban de cerrar) o retiraban una propuesta §4 ya cumplida. Mejora. - 2 —chat-log y chat-composer— BORRABAN prosa medida: donde un humano escribió «_Ninguno_ — los cuatro que había (el padding-block del divisor, el radio de foco de la fila de evento…) están cosidos», la plantilla dejaba «_Ninguno._», y en chat-composer se llevaba además el bloque de las cuatro declaraciones retiradas por muertas. Esas dos van cosidas: el cuerpo de HEAD con la línea de cabecera regenerada. El resto entra tal cual. Que la regeneración sea mayoritariamente buena y ocasionalmente destructiva es el peor reparto posible, porque nadie la mira. Registrado en §13 con su arreglo: extender los marcadores tipo veredicto:end a cualquier bloque que un humano haya ampliado, o que el generador respete una línea que no empiece por su propia plantilla. Mientras tanto, regenerar fichas y commitear sin leer el diff es una pérdida de datos silenciosa. Y con él, la hermana que reportó una sesión de la tanda: snapshot-y-restaura sobre un directorio COMPARTIDO pisa a quien escriba en medio. Dos sesiones hicieron cp -r de docs/audit/theming y la segunda restauró desde un snapshot anterior al trabajo de la primera, devolviéndole sus veredictos a «pendiente» a media faena. El árbol de trabajo también es compartido: respalda por FICHERO tocado, nunca por directorio. Quedan fuera a propósito las fichas de chat-message y tags-input: sus sesiones siguen trabajando. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago
dev	f68bac4a66	uix(avatar): temable — 75 % → 90 %, y su contrato era INVISIBLE para los dos instrumentos ... Protocolo PLAN-theming §7 sobre `avatar` (incluye `AvatarGroup`, que comparte receta y fichero). Censo 75 % → **90 %**, contrato 84 → 88 claves, centinela **83/88** con 5 adjudicadas. El default NO se mueve. ## Lo primero: el instrumento no veía el contrato La entrada `avatar` de `recipes/base.ts` es la ÚNICA construida por una IIFE (un helper local genera sus 24 ámbitos compuestos), así que su mapa vive en el `return {`, un tabulador más adentro. Consecuencia medida: - el censo la leía como «sin entrada en base.ts» — 84 claves invisibles; - el centinela **moría** con `no recipe block for avatar`: el componente no se podía medir, y su gate no significaba nada. Los dos lectores leen ya la IIFE (dedentan el `return`). Sin este arreglo, todo lo demás de este commit habría sido humo. ## Lo que entra al contrato (6 claves) `group-overlap-{xs,sm,md,lg,xl,xxl}` — la escala de solape de `AvatarGroup`. Había UNA clave, `--avatar-group-overlap`, y la receta la RE-DECLARABA en seis bloques `[data-size]`: sentada en el elemento, ganaba siempre al `:root` donde escribe un tema. Medido: `37px` desde el asiento del tema no movía el margen; el mismo valor escrito sobre el nodo, sí. Ahora el paso viaja por `--_avatar-group-overlap` y los seis alcanzan desde `:root` (−8,4 · −11,2 · −14 · −16,8 · −22,4 · −33,6 px → 37 px, uno a uno). ## Lo que se retira (2 declaraciones muertas, diff 0 las dos) - `group-max`: el envoltorio escribía `--avatar-group-max` INLINE y la receta declaraba su default `99`. **No lo leía nadie** — el tope se aplica con `data-has-max` + `:nth-child(n + M)` porque una variable no entra en `:nth-child()`, y lo dice el propio comentario del CSS. Retirado de los dos sitios; el `+3` del grupo sigue exactamente donde estaba. - el respaldo `, white` de `--_avatar-badge-fg`: el contrato ya declara `--avatar-badge-color-custom-contrast: white`, así que era inalcanzable y sólo podía envejecer contra su token. Comprobado en la rama custom: la tinta sigue computando `rgb(255, 255, 255)`. ## Seis literales firmados (salen del ratio) Los cuatro `100 %` de Image y Fallback son IDENTIDAD — la parte ES la superficie del avatar, no una talla propia — y los dos `line-height: 1` mantienen el glifo centrado por la caja flex. ## Lo que se queda privado (el techo real es 90 %) `--_avatar-bg`, `--_avatar-fg` y `--_avatar-badge-bg` son un CONMUTADOR: cambian de fuente con la variante (solid · soft · outline) y su valor sale del forward de paleta THM-2 que la capa de color alimenta por instancia desde `[data-color]`. Un público encima dejaría que un tema los fijara y matara el `color=` de cada avatar. ## Artefactos - Sonda: **0 diffs** en TRES bases — demo de avatar con insignia y anillo (576 valores), la misma en modo fallback (384) y demo de AvatarGroup (3.072). - Capturas 2× antes/después de las dos demos: **idénticas al byte**. - Centinela R-5.4: 83/88, 5 adjudicadas con su medida en el ledger (`size-xxl` y `font-size-xxl` viven en el paso `xxl`, que el barrido del guard no alcanza — el límite que `metrics` ya registró; `radius-none` y `ring-width-sm` son «sólo el paso en vigor pinta»; `group-overlap-xxl` junta las dos cosas). - El guard aprende `avatar`: la insignia y el anillo son OPT-IN, el barrido de `data-variant` destapa las 16 claves `*-outline-*`, y `AvatarGroup` se mide en su propia ruta (21 muertos → 5). - `eidos-lint` 0 invalid · `vitest src/uix/eidos` sin rojos nuevos (el conocido `skin-media-player`) · `rtl:check` 0 · `docs:check` 0 · `npm run check` COMPLETED sin un solo error en `avatar`. - README «Talla y tema» + pestaña `Tokens` (88 filas, verificada en el navegador con `networkidle` y clic real). ## Lo que NO se arregla aquí (anotado) - **R-5.3 preexistente**: cuatro claves `*-color-custom*` donde la gramática exige `fg`. Son escotillas que el envoltorio escribe INLINE, así que renombrarlas cambia el contrato público de tres canales: se lista, el audit sigue en NEEDS-WORK por esto y sólo por esto. - **Falso POSITIVO nuevo del centinela** (next-features §13): escribe el token en `:root` y también sobre cada nodo, y para una propiedad personalizada que la receta re-declara en el ELEMENTO ese inline gana justo lo que un tema pierde. Es lo que hacía que `--avatar-group-overlap` leyera vivo. - **El barrido de tallas del guard para en `xl`**: añadir `xxl` dejaría STALE las seis excepciones de `metrics`, así que se hace con la re-verificación del ledger entero. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago
dev	c15873be2e	uix(callout): temable — 27 % → 79 %, y la base óptica deja de copiar el sistema ... 7 claves nuevas (28 → 35) y un literal anotado. El 21 % que falta es el PUENTE DE PALETA (THM-2), que no es deuda: es la vía por la que `data-color` resuelve los 8 roles y las 33 escalas donantes sin una línea de CSS extra. Global 64 %. Cosido lo que la receta consumía a pelo: el hueco de fila, la tipografía del cuerpo (`font-size` + `line-height` — así se lee una admonición), la tinta, el tamaño del icono y el peso del título. Los tres pasos leen el BUNDLE (`--size-md-font-size`, `--size-md-font-line-height`, `--size-md-icon-size`). LA LÍNEA BASE ÓPTICA DEL ICONO DEJA DE REPETIR LAS MÉTRICAS DEL SISTEMA: era `calc(var(--size-md-font-size) * var(--font-line-height-md, 1.5))` y ahora es `calc(var(--callout-font-size) * var(--callout-line-height))` — la misma derivación, sobre los tokens del propio callout, así que un tema que agrande la copia mueve la caja del glifo con ella. Cinco respaldos muertos retirados: `var(--callout-gap, var(--space-3))`, `padding`, `accent-width`, `radius` —las cuatro claves están en el contrato— y el `, 1.5` de `--font-line-height-md`, que además MENTÍA: el token existe y vale 1.45. Los 24 rojos del guard son los TONOS, y no son de este componente: es la supersesión de la cascada de paleta que `button` destapó hoy (el bloque genérico va el último y gana por orden). Adjudicados con el patrón compartido, que ahora nombra su razón una sola vez para los dos componentes. Gates: sonda 0 diffs en 896 valores × 7 estados · centinela 10/34 con los tonos adjudicados · censo 79 % · `component:audit` PASS · suite eidos con el rojo conocido ajeno · `rtl:check` 0 · `docs:check` 0 · `check` sin errores propios · captura de cuatro tonos. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago
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	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	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