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.
15 KiB
15 KiB
toggle — 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-20 · Alcance: 22% — 6 de 27 knobs por token público
- Knobs de apariencia: 28 — público 6 · privado 17 · global 1 · literal 3 · sistema 1 (fuera del ratio)
- Contrato hoy (
lib/recipes/base.ts): 119 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,border-width,shadow,transition-duration,transition-ease,primary-track,primary-element,primary-hover,primary-border,primary-solid,primary-solid-hover,primary-text,primary-contrast,neutral-track,neutral-element,neutral-hover,neutral-border,neutral-solid,neutral-solid-hover,neutral-text,neutral-contrast,risk-track,risk-element,risk-hover,risk-border,risk-solid,risk-solid-hover,risk-text,risk-contrast,threat-track,threat-element,threat-hover,threat-border,threat-solid,threat-solid-hover,threat-text,threat-contrast,secondary-track,secondary-element,secondary-hover,secondary-border,secondary-solid,secondary-solid-hover,secondary-text,secondary-contrast,affirm-track,affirm-element,affirm-hover,affirm-border,affirm-solid,affirm-solid-hover,affirm-text,affirm-contrast,palette-track,palette-element,palette-hover,palette-border,palette-solid,palette-solid-hover,palette-text,palette-contrast,solid-bg,solid-fg,solid-border,solid-hover-bg,solid-hover-border,solid-on-bg,solid-on-fg,solid-on-border,solid-on-hover-bg,solid-on-hover-border,outline-bg,outline-fg,outline-border,outline-hover-bg,outline-hover-border,outline-on-bg,outline-on-fg,outline-on-border,outline-on-hover-bg,outline-on-hover-border,ghost-bg,ghost-fg,ghost-border,ghost-hover-bg,ghost-hover-border,ghost-on-bg,ghost-on-fg,ghost-on-border,ghost-on-hover-bg,ghost-on-hover-border,disabled-opacity - Eje
size: sí · ficheros:toggle.css
1. Knobs fuera de alcance
1.1 Directo a primitivo global (1)
| # | fichero:línea | selector | propiedad | valor |
|---|---|---|---|---|
| 1 | toggle.css:199 |
[data-toggle][data-invalid] |
border-color |
var(--color-threat-element) |
1.2 A través de un privado (17)
| # | fichero:línea | selector | propiedad | valor |
|---|---|---|---|---|
| 1 | toggle.css:31 |
[data-toggle] |
gap |
var(--_toggle-gap) |
| 2 | toggle.css:32 |
[data-toggle] |
min-height |
var(--_toggle-height) |
| 3 | toggle.css:33 |
[data-toggle] |
padding-inline |
var(--_toggle-padding-inline) |
| 4 | toggle.css:35 |
[data-toggle] |
border-radius |
var(--_toggle-radius) |
| 5 | toggle.css:36 |
[data-toggle] |
background |
var(--_toggle-bg) |
| 6 | toggle.css:37 |
[data-toggle] |
color |
var(--_toggle-fg) |
| 7 | toggle.css:40 |
[data-toggle] |
font-size |
var(--_toggle-font-size) |
| 8 | toggle.css:41 |
[data-toggle] |
font-weight |
var(--_toggle-font-weight) |
| 9 | toggle.css:136 |
[data-toggle]:hover |
background |
var(--_toggle-hover-bg) |
| 10 | toggle.css:137 |
[data-toggle]:hover |
border-color |
var(--_toggle-hover-border) |
| 11 | toggle.css:142 |
[data-toggle][data-state='on'], [data-toggle][aria-pressed='true'] |
background |
var(--_toggle-on-bg) |
| 12 | toggle.css:143 |
[data-toggle][data-state='on'], [data-toggle][aria-pressed='true'] |
color |
var(--_toggle-on-fg) |
| 13 | toggle.css:144 |
[data-toggle][data-state='on'], [data-toggle][aria-pressed='true'] |
border-color |
var(--_toggle-on-border) |
| 14 | toggle.css:149 |
[data-toggle][data-state='on']:hover, [data-toggle][aria-pressed='true']:hover |
background |
var(--_toggle-on-hover-bg) |
| 15 | toggle.css:150 |
[data-toggle][data-state='on']:hover, [data-toggle][aria-pressed='true']:hover |
color |
var(--_toggle-on-fg) |
| 16 | toggle.css:151 |
[data-toggle][data-state='on']:hover, [data-toggle][aria-pressed='true']:hover |
border-color |
var(--_toggle-on-hover-border) |
| 17 | toggle.css:164 |
[data-toggle][data-icon-only] |
inline-size |
var(--_toggle-height) |
1.3 Literales (3)
| # | fichero:línea | selector | propiedad | valor |
|---|---|---|---|---|
| 1 | toggle.css:160 |
[data-toggle][data-block] |
inline-size |
100% |
| 2 | toggle.css:173 |
[data-toggle][data-icon-only] [data-toggle-body] |
width |
1px |
| 3 | toggle.css:174 |
[data-toggle][data-icon-only] [data-toggle-body] |
height |
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 | toggle.css:155 |
[data-toggle]: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? |
|---|---|---|---|---|
--_toggle-height |
5 | var(--toggle-height-md), var(--toggle-height-xs), var(--toggle-height-sm), var(--toggle-height-lg), var(--toggle-height-xl) |
public | sí |
--_toggle-padding-inline |
5 | var(--toggle-padding-inline-md), var(--toggle-padding-inline-xs), var(--toggle-padding-inline-sm), var(--toggle-padding-inline-lg), var(--toggle-padding-inline-xl) |
public | sí |
--_toggle-gap |
5 | var(--toggle-gap-md), var(--toggle-gap-xs), var(--toggle-gap-sm), var(--toggle-gap-lg), var(--toggle-gap-xl) |
public | sí |
--_toggle-font-size |
5 | var(--toggle-font-size-md), var(--toggle-font-size-xs), var(--toggle-font-size-sm), var(--toggle-font-size-lg), var(--toggle-font-size-xl) |
public | sí |
--_toggle-font-weight |
5 | var(--toggle-font-weight-md), var(--toggle-font-weight-xs), var(--toggle-font-weight-sm), var(--toggle-font-weight-lg), var(--toggle-font-weight-xl) |
public | sí |
--_toggle-radius |
6 | var(--radius-default), var(--radius-sm), var(--radius-md), var(--radius-lg), var(--radius-xl), var(--radius-full) |
global | no |
--_toggle-bg |
3 | var(--toggle-solid-bg), var(--toggle-outline-bg), var(--toggle-ghost-bg) |
public | sí |
--_toggle-fg |
3 | var(--toggle-solid-fg), var(--toggle-outline-fg), var(--toggle-ghost-fg) |
public | sí |
--_toggle-border |
3 | var(--toggle-solid-border), var(--toggle-outline-border), var(--toggle-ghost-border) |
public | sí |
--_toggle-hover-bg |
3 | var(--toggle-solid-hover-bg), var(--toggle-outline-hover-bg), var(--toggle-ghost-hover-bg) |
public | sí |
--_toggle-hover-border |
3 | var(--toggle-solid-hover-border), var(--toggle-outline-hover-border), var(--toggle-ghost-hover-border) |
public | sí |
--_toggle-on-bg |
3 | var(--toggle-solid-on-bg), var(--toggle-outline-on-bg), var(--toggle-ghost-on-bg) |
public | sí |
--_toggle-on-fg |
3 | var(--toggle-solid-on-fg), var(--toggle-outline-on-fg), var(--toggle-ghost-on-fg) |
public | sí |
--_toggle-on-border |
3 | var(--toggle-solid-on-border), var(--toggle-outline-on-border), var(--toggle-ghost-on-border) |
public | sí |
--_toggle-on-hover-bg |
3 | var(--toggle-solid-on-hover-bg), var(--toggle-outline-on-hover-bg), var(--toggle-ghost-on-hover-bg) |
public | sí |
--_toggle-on-hover-border |
3 | var(--toggle-solid-on-hover-border), var(--toggle-outline-on-hover-border), var(--toggle-ghost-on-hover-border) |
public | sí |
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 (2)
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 (--toggle-…) |
scope TSC | valor propuesto | usos |
|---|---|---|---|
radius |
root |
⚠ var(--radius-default) / var(--radius-sm) / var(--radius-md) / var(--radius-lg) / var(--radius-xl) / var(--radius-full) |
6 |
invalid-border |
root |
var(--color-threat-element) |
1 |
4.2 Sin nombre mecánico (19)
- ya alcanzable: el privado
--_toggle-gapderiva de un público (var(--toggle-gap-md),var(--toggle-gap-xs),var(--toggle-gap-sm),var(--toggle-gap-lg)) — sin acción; el censo lo cuenta como no alcanzable por el límite del regex — 1:gap. - ⚠ decisión:
min-heightes shorthand o eje físico — hay que partirlo en ejes lógicos antes de nombrarlo (recipe-contract §1, R-4.4) — 1:min-height. - ya alcanzable: el privado
--_toggle-padding-inlinederiva de un público (var(--toggle-padding-inline-md),var(--toggle-padding-inline-xs),var(--toggle-padding-inline-sm),var(--toggle-padding-inline-lg)) — sin acción; el censo lo cuenta como no alcanzable por el límite del regex — 1:padding-inline. - ya alcanzable: el privado
--_toggle-bgderiva de un público (var(--toggle-solid-bg),var(--toggle-outline-bg),var(--toggle-ghost-bg)) — sin acción; el censo lo cuenta como no alcanzable por el límite del regex — 1:background. - ya alcanzable: el privado
--_toggle-fgderiva de un público (var(--toggle-solid-fg),var(--toggle-outline-fg),var(--toggle-ghost-fg)) — sin acción; el censo lo cuenta como no alcanzable por el límite del regex — 1:color. - ya alcanzable: el privado
--_toggle-font-sizederiva de un público (var(--toggle-font-size-md),var(--toggle-font-size-xs),var(--toggle-font-size-sm),var(--toggle-font-size-lg)) — sin acción; el censo lo cuenta como no alcanzable por el límite del regex — 1:font-size. - ya alcanzable: el privado
--_toggle-font-weightderiva de un público (var(--toggle-font-weight-md),var(--toggle-font-weight-xs),var(--toggle-font-weight-sm),var(--toggle-font-weight-lg)) — sin acción; el censo lo cuenta como no alcanzable por el límite del regex — 1:font-weight. - ya alcanzable: el privado
--_toggle-hover-bgderiva de un público (var(--toggle-solid-hover-bg),var(--toggle-outline-hover-bg),var(--toggle-ghost-hover-bg)) — sin acción; el censo lo cuenta como no alcanzable por el límite del regex — 1:background. - ya alcanzable: el privado
--_toggle-hover-borderderiva de un público (var(--toggle-solid-hover-border),var(--toggle-outline-hover-border),var(--toggle-ghost-hover-border)) — sin acción; el censo lo cuenta como no alcanzable por el límite del regex — 1:border-color. - ya alcanzable: el privado
--_toggle-on-bgderiva de un público (var(--toggle-solid-on-bg),var(--toggle-outline-on-bg),var(--toggle-ghost-on-bg)) — sin acción; el censo lo cuenta como no alcanzable por el límite del regex — 1:background. - ya alcanzable: el privado
--_toggle-on-fgderiva de un público (var(--toggle-solid-on-fg),var(--toggle-outline-on-fg),var(--toggle-ghost-on-fg)) — sin acción; el censo lo cuenta como no alcanzable por el límite del regex — 2:color. - ya alcanzable: el privado
--_toggle-on-borderderiva de un público (var(--toggle-solid-on-border),var(--toggle-outline-on-border),var(--toggle-ghost-on-border)) — sin acción; el censo lo cuenta como no alcanzable por el límite del regex — 1:border-color. - ya alcanzable: el privado
--_toggle-on-hover-bgderiva de un público (var(--toggle-solid-on-hover-bg),var(--toggle-outline-on-hover-bg),var(--toggle-ghost-on-hover-bg)) — sin acción; el censo lo cuenta como no alcanzable por el límite del regex — 1:background. - ya alcanzable: el privado
--_toggle-on-hover-borderderiva de un público (var(--toggle-solid-on-hover-border),var(--toggle-outline-on-hover-border),var(--toggle-ghost-on-hover-border)) — sin acción; el censo lo cuenta como no alcanzable por el límite del regex — 1:border-color. - ⚠ 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. - ya alcanzable: el privado
--_toggle-heightderiva de un público (var(--toggle-height-md),var(--toggle-height-xs),var(--toggle-height-sm),var(--toggle-height-lg)) — sin acción; el censo lo cuenta como no alcanzable por el límite del regex — 1:inline-size. - ⚠ decisión:
widthes 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:
heightes shorthand o eje físico — hay que partirlo en ejes lógicos antes de nombrarlo (recipe-contract §1, R-4.4) — 1:height.
4.3 Avisos sobre los tokens propuestos (1)
- el privado
--_toggle-radiusdebe pasar a leer este público (o desaparecer) —--toggle-radius
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)