6.7 KiB

Raw Blame History Unescape Escape

link — alcance de tema: análisis y propuesta

Generado por node --import tsx/esm scripts/theming-census.ts --report. Lo medido y la propuesta se regeneran; el Veredicto (§5) se conserva. Vista de conjunto: README · método y protocolo: PLAN-theming.md §1, §2, §7.

Medido: 2026-08-23 · Alcance: 36% — 4 de 11 knobs por token público
Knobs de apariencia: 14 — público 4 · privado 4 · global 1 · literal 2 · sistema 3 · excepción 0 (los dos últimos, fuera del ratio)
Contrato hoy (lib/recipes/base.ts): 5 pública(s) — radius, gap, external-icon-size, underline-width, underline-offset · 2 privada(s) forward — _palette-text, _palette-solid-hover
Eje size: no · ficheros: link.css

1. Knobs fuera de alcance

1.1 Directo a primitivo global (1)

#	fichero:línea	selector	propiedad	valor
1	`link.css:93`	`[data-link]:active, [data-link][data-variant]:active`	`opacity`	`var(--opacity-70)`

1.2 A través de un privado (4)

#	fichero:línea	selector	propiedad	valor
1	`link.css:19`	`[data-link]`	`font-size`	`var(--_link-font-size, inherit)`
2	`link.css:20`	`[data-link]`	`line-height`	`var(--_link-line-height, inherit)`
3	`link.css:21`	`[data-link]`	`color`	`var(--_link-palette-text)`
4	`link.css:76`	`[data-link]:hover`	`color`	`var(--_link-palette-solid-hover)`

1.3 Literales (2)

#	fichero:línea	selector	propiedad	valor
1	`link.css:116`	`[data-link-sr-only]`	`width`	`1px`
2	`link.css:117`	`[data-link-sr-only]`	`height`	`1px`

1.4 Excepciones firmadas (0) — fuera del ratio

Literales que llevan su anotación /* literal: <razón> */ en la propia declaración: la válvula de recipe-contract §3, la misma que honra component-audit. Una desviación firmada no es deuda — se listan para que la razón se lea, no para acuñarlas.

Ninguno.

2. Sistema transversal (3) — informativo, fuera del ratio

Un tema los alcanza a nivel de sistema, por diseño (recipe-contract §2).

#	fichero:línea	selector	propiedad	valor
1	`link.css:81`	`[data-link][data-variant='subtle']:not([data-color]):not([data-color-custom]):hover, [data-link][data-variant='plain']:not([data-color]):not([data-color-custom]):hover`	`opacity`	`var(--opacity-subtle)`
2	`link.css:97`	`[data-link]:focus-visible`	`outline`	`var(--focus-ring-width) solid var(--focus-ring-color)`
3	`link.css:103`	`[data-link][data-disabled]`	`opacity`	`var(--opacity-disabled)`

3. Privados de la receta — ¿de dónde sale su valor?

La receta no declara privados propios en su CSS.

Consumidos y no declarados en el CSS (vienen de base.ts o de un estilo inline del wrapper): --_link-font-size, --_link-line-height, --_link-palette-solid-hover, --_link-palette-text.

4. Propuesta de corrección

4.1 Tokens a declarar en `lib/recipes/base.ts` (1)

Valor verbatim del CSS de hoy: el default no se mueve, sólo cambia quién puede moverlo. Nombres derivados de recipe-contract §1 (ejes lógicos, talla al final) y theming §6.7 (slots de color, modificador delante). Un token con DOS valores distintos es una colisión de nombre: son dos knobs, o el nombre no distingue lo que debería — se marca ⚠.

token (`--link-…`)	scope TSC	valor propuesto	usos
`press-opacity`	`root`	`var(--opacity-70)`	1

4.2 Sin nombre mecánico (6)

⚠ decisión: el privado que alimenta este knob no se declara en el CSS (viene de base.ts o de un estilo inline) — hay que resolverlo antes de nombrarlo — 4: font-size, line-height, color.
⚠ decisión: width es shorthand o eje físico — hay que partirlo en ejes lógicos antes de nombrarlo (recipe-contract §1, R-4.4) — 1: width.
⚠ decisión: height es shorthand o eje físico — hay que partirlo en ejes lógicos antes de nombrarlo (recipe-contract §1, R-4.4) — 1: height.

4.4 Lo que hay que comprobar a mano (PLAN-theming §1.3 · §7.4)

Privado que no deriva de un público — §3 lo marca; el privado debe leer el público o desaparecer.
Velo o acento en el nodo equivocado (archetype: 'item' en un envoltorio, un background en shorthand que mata la capa de estado) — se mide desde el píxel hacia arriba.
Doble animación al mover un sello a una superficie con animación propia — registro de animationstart/animationend.
Diff de computed = 0 en reposo · hover · abierto · disabled · foco, por talla, antes y después.
Centinela por token nuevo: valor imposible en el root → el nodo lo sigue. Si no, el token miente.

5. Veredicto

Medido 2026-08-21 (sonda ×2 = 0 diffs en 203 valores · 7 estados). Un enlace en línea hereda casi todo del texto que lo rodea, así que su superficie de tema es pequeña por diseño — y esa es la respuesta correcta, no una carencia.

--_link-font-size y --_link-line-height NO se tokenizan. Son escotillas por instancia cuyo fallback es inherit, y ese inherit es SEMÁNTICO: el enlace toma la tipografía del párrafo en el que vive («inherits ambient typography», dice la receta). Convertirlo en token exigiría un público con valor inherit, que en :root no significa lo mismo. Se quedan privadas y son parte del 36 % que no alcanza — honestamente.
Los dos forwards de paleta también (THM-2): la tinta y su hover leen --_link-palette-text / -solid-hover a pelo, sin sitio donde meter un público sin duplicar la regla.
Lo tokenizable es la geometría: el radio del anillo, el hueco del icono externo, el grosor y el desplazamiento del subrayado (cada uno en DOS reglas — always y hover — con el mismo valor, así que un knob cada uno), y el tamaño del icono externo, que es 0.85em en las dos dimensiones: un knob, no dos.
Las tres opacidades son sistema (--opacity-subtle, --opacity-70, --opacity-disabled) y no entran al ratio. El fill: currentColor del icono es identidad: sigue a la tinta del enlace a propósito.
No se toca la cascada. El CSS lleva dos correcciones de especificidad ya medidas y explicadas en su sitio (el inherit condicional para que un color pedido no se descarte en silencio, y el :active declarado al final porque una pulsación es siempre también un hover). Tokenizar no las altera: el diff de computed lo confirma.

6.7 KiB Raw Blame History Unescape Escape