You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
9.9 KiB
9.9 KiB
button — 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-22 · Alcance: 55% — 16 de 29 knobs por token público
- Knobs de apariencia: 30 — público 16 · privado 6 · global 0 · literal 7 · sistema 1 (fuera del ratio)
- Contrato hoy (
lib/recipes/base.ts): 105 pública(s) —height-xs,height-sm,height-md,height-lg,height-xl,padding-inline-xs,padding-inline-sm,padding-inline-md,padding-inline-lg,padding-inline-xl,gap-xs,gap-sm,gap-md,gap-lg,gap-xl,font-family,line-height,letter-spacing,font-size-xs,font-size-sm,font-size-md,font-size-lg,font-size-xl,font-weight-xs,font-weight-sm,font-weight-md,font-weight-lg,font-weight-xl,icon-size-xs,icon-size-sm,icon-size-md,icon-size-lg,icon-size-xl,radius-sm,radius-md,radius-lg,radius-xl,border-width,shadow,transition-duration,transition-ease,disabled-opacity,primary-track,primary-element,primary-border,primary-solid,primary-solid-hover,primary-text,primary-contrast,secondary-track,secondary-element,secondary-border,secondary-solid,secondary-solid-hover,secondary-text,secondary-contrast,neutral-track,neutral-element,neutral-border,neutral-solid,neutral-solid-hover,neutral-text,neutral-contrast,affirm-track,affirm-element,affirm-border,affirm-solid,affirm-solid-hover,affirm-text,affirm-contrast,fulfill-track,fulfill-element,fulfill-border,fulfill-solid,fulfill-solid-hover,fulfill-text,fulfill-contrast,risk-track,risk-element,risk-border,risk-solid,risk-solid-hover,risk-text,risk-contrast,threat-track,threat-element,threat-border,threat-solid,threat-solid-hover,threat-text,threat-contrast,loss-track,loss-element,loss-border,loss-solid,loss-solid-hover,loss-text,loss-contrast,palette-track,palette-element,palette-border,palette-solid,palette-solid-hover,palette-text,palette-contrast - Eje
size: sí · ficheros:button.css
1. Knobs fuera de alcance
1.1 Directo a primitivo global (0)
Ninguno.
1.2 A través de un privado (6)
| # | fichero:línea | selector | propiedad | valor |
|---|---|---|---|---|
| 1 | button.css:68 |
[data-button] |
border-radius |
var(--_button-radius) |
| 2 | button.css:69 |
[data-button] |
background |
var(--_button-bg) |
| 3 | button.css:89 |
[data-button]:hover:not([data-disabled]):not([data-loading]) |
background |
var(--_button-hover-bg) |
| 4 | button.css:90 |
[data-button]:hover:not([data-disabled]):not([data-loading]) |
border-color |
var(--_button-hover-border) |
| 5 | button.css:100 |
[data-button][data-gradient][data-variant='solid'] |
background-image |
var(--_button-fill-finish) |
| 6 | button.css:103 |
[data-button][data-gradient][data-variant='solid']:hover:not([data-disabled]):not([data-loading]) |
background-image |
var(--_button-fill-finish) |
1.3 Literales (7)
| # | fichero:línea | selector | propiedad | valor |
|---|---|---|---|---|
| 1 | button.css:63 |
[data-button] |
inline-size |
fit-content |
| 2 | button.css:64 |
[data-button] |
block-size |
fit-content |
| 3 | button.css:244 |
[data-button][data-block] |
inline-size |
100% |
| 4 | button.css:262 |
[data-button][data-icon-only] [data-button-body] |
inline-size |
1px |
| 5 | button.css:263 |
[data-button][data-icon-only] [data-button-body] |
block-size |
1px |
| 6 | button.css:309 |
[data-button-sr-only] |
inline-size |
1px |
| 7 | button.css:310 |
[data-button-sr-only] |
block-size |
1px |
2. Sistema transversal (1) — 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 | button.css:121 |
[data-button]:focus-visible |
outline |
var(--focus-ring-width) solid var(--focus-ring-color) |
3. Privados de la receta — ¿de dónde sale su valor?
| privado | declaraciones | valor(es) | origen | ¿deriva de un público? |
|---|---|---|---|---|
--_button-height |
6 | var(--button-height-md), var(--button-height-xs), var(--button-height-sm), var(--button-height-lg), var(--button-height-xl) |
public | sí |
--_button-padding-inline |
6 | var(--button-padding-inline-md), var(--button-padding-inline-xs), var(--button-padding-inline-sm), var(--button-padding-inline-lg), var(--button-padding-inline-xl) |
public | sí |
--_button-gap |
6 | var(--button-gap-md), var(--button-gap-xs), var(--button-gap-sm), var(--button-gap-lg), var(--button-gap-xl) |
public | sí |
--_button-radius |
6 | var(--button-radius-md), var(--button-radius-sm), var(--button-radius-lg), var(--button-radius-xl), var(--radius-full) |
global, public | no |
--_button-font-size |
6 | var(--button-font-size-md), var(--button-font-size-xs), var(--button-font-size-sm), var(--button-font-size-lg), var(--button-font-size-xl) |
public | sí |
--_button-font-weight |
6 | var(--button-font-weight-md), var(--button-font-weight-xs), var(--button-font-weight-sm), var(--button-font-weight-lg), var(--button-font-weight-xl) |
public | sí |
--_button-icon-size |
6 | var(--button-icon-size-md), var(--button-icon-size-xs), var(--button-icon-size-sm), var(--button-icon-size-lg), var(--button-icon-size-xl) |
public | sí |
--_button-bg |
7 | var(--button-palette-solid), var(--button-palette-track), transparent |
literal, public | no |
--_button-fg |
7 | var(--_button-finish-ink, var(--button-palette-contrast)), var(--button-palette-text) |
public | sí |
--_button-border |
7 | var(--button-palette-solid), transparent, var(--button-palette-border) |
literal, public | no |
--_button-hover-bg |
7 | var(--button-palette-solid-hover), var(--button-palette-element), var(--button-palette-track), transparent |
literal, public | no |
--_button-hover-border |
7 | var(--button-palette-solid-hover), transparent, var(--button-palette-border) |
literal, public | no |
Consumidos y no declarados en el CSS (vienen de base.ts o de un estilo inline del wrapper): --_button-fill-finish, --_button-finish-ink.
4. Propuesta de corrección
- Tiene eje
size: los tokens dimensionales van por talla ({part}-{eje}-{k}) apuntando al bundle--size-{k}-*, nunca al primitivo crudo (theming §5; el guardrecipe-css-contractprohíbe el primitivo).
4.1 Tokens a declarar en lib/recipes/base.ts (10)
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 (--button-…) |
scope TSC | valor propuesto | usos |
|---|---|---|---|
bg |
host |
⚠ var(--button-palette-solid) / var(--button-palette-track) / transparent |
7 |
hover-bg |
host |
⚠ var(--button-palette-solid-hover) / var(--button-palette-element) / var(--button-palette-track) / transparent |
7 |
hover-border |
host |
⚠ var(--button-palette-solid-hover) / transparent / var(--button-palette-border) |
7 |
radius |
root |
⚠ var(--button-radius-md) / var(--button-radius-sm) / var(--button-radius-lg) / var(--button-radius-xl) / var(--radius-full) |
6 |
width |
root |
fit-content |
1 |
height |
root |
fit-content |
1 |
body-width |
root |
1px |
1 |
body-height |
root |
1px |
1 |
sr-only-width |
root |
1px |
1 |
sr-only-height |
root |
1px |
1 |
4.2 Sin nombre mecánico (3)
- ⚠ decisión: el privado que alimenta este knob no se declara en el CSS (viene de
base.tso de un estilo inline) — hay que resolverlo antes de nombrarlo — 2:background-image. - ⚠ decisión:
100%es un valor identidad o geometría de layout, no un knob de tema — el perímetro de «knob» es D-TH.2, sin firmar — 1:inline-size.
4.3 Avisos sobre los tokens propuestos (4)
- el privado
--_button-radiusdebe pasar a leer este público (o desaparecer) —--button-radius - el privado
--_button-bgdebe pasar a leer este público (o desaparecer) —--button-bg - el privado
--_button-hover-bgdebe pasar a leer este público (o desaparecer) —--button-hover-bg - el privado
--_button-hover-borderdebe pasar a leer este público (o desaparecer) —--button-hover-border
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, unbackgrounden 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
(pendiente — lo escribe el autor; se conserva al regenerar)