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.
svelte-kit-vice/docs/audit/theming/radio-group.md

9.8 KiB

radio-group — 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: 77% — 56 de 73 knobs por token público
  • Knobs de apariencia: 75 — público 56 · privado 10 · global 7 · literal 0 · sistema 2 · excepción 0 (los dos últimos, fuera del ratio)
  • Contrato hoy (lib/recipes/base.ts): 61 pública(s) — gap-vertical, gap-horizontal, item-size-xs, item-size-sm, item-size-md, item-size-lg, item-size-xl, dot-size-xs, dot-size-sm, dot-size-md, dot-size-lg, dot-size-xl, item-gap, font-family, font-size-xs, font-size-sm, font-size-md, font-size-lg, font-size-xl, font-weight, line-height, item-label-fg, disabled-item-label-fg, indicator-radius, indicator-border-width, indicator-bg, indicator-border, hover-indicator-border, disabled-indicator-bg, disabled-indicator-border, checked-disabled-indicator-bg, dot-fg, disabled-dot-fg, transition-duration, transition-ease, disabled-opacity, primary-solid, primary-solid-hover, neutral-solid, neutral-solid-hover, secondary-solid, secondary-solid-hover, affirm-solid, affirm-solid-hover, label-font-family, label-font-size, label-font-weight, label-line-height, label-fg, segmented-track-bg, segmented-track-shadow, segmented-track-padding, segmented-track-radius, segmented-segment-padding-inline, segmented-segment-fg, hover-segmented-segment-fg, segmented-segment-font-weight, segmented-pill-shadow, segmented-pill-radius, segmented-transition-duration, segmented-transition-ease · 3 privada(s) forward — _palette-solid, _palette-solid-hover, _palette-text
  • Eje size: sí · ficheros: radio-group.css

1. Knobs fuera de alcance

1.1 Directo a primitivo global (7)

# fichero:línea selector propiedad valor
1 radio-group.css:41 [data-radio-group][data-invalid] [data-radio-group-row-label] color var(--color-threat-text)
2 radio-group.css:78 [data-radio-group-row] min-block-size var(--touch-target)
3 radio-group.css:93 [data-radio-group-item] inline-size var(--_radio-item-size)
4 radio-group.css:94 [data-radio-group-item] block-size var(--_radio-item-size)
5 radio-group.css:188 [data-radio-group][data-invalid] [data-radio-group-item] border-color var(--color-threat-element)
6 radio-group.css:192 [data-radio-group][data-invalid] [data-radio-group-item]:focus-visible box-shadow 0 0 0 2px var(--color-surface-default), 0 0 0 4px var(--color-threat-element)
7 radio-group.css:313 [data-radio-group][data-variant='segmented'] [data-radio-group-item] padding-block var(--space-1)

1.2 A través de un privado (10)

# fichero:línea selector propiedad valor
1 radio-group.css:146 [data-radio-group][data-variant='solid'] [data-radio-group-item][data-state='checked'], [data-radio-group]:not([data-variant]) [data-radio-group-item][data-state='checked'] background var(--_radio-group-palette-solid)
2 radio-group.css:147 [data-radio-group][data-variant='solid'] [data-radio-group-item][data-state='checked'], [data-radio-group]:not([data-variant]) [data-radio-group-item][data-state='checked'] border-color var(--_radio-group-palette-solid)
3 radio-group.css:153 [data-radio-group][data-variant='solid'] [data-radio-group-item][data-state='checked']:hover:not([data-disabled]):not([data-readonly]), [data-radio-group]:not([data-variant]) [data-radio-group-item][data-state='checked']:hover:not([data-disabled]):not([data-readonly]) background var(--_radio-group-palette-solid-hover)
4 radio-group.css:154 [data-radio-group][data-variant='solid'] [data-radio-group-item][data-state='checked']:hover:not([data-disabled]):not([data-readonly]), [data-radio-group]:not([data-variant]) [data-radio-group-item][data-state='checked']:hover:not([data-disabled]):not([data-readonly]) border-color var(--_radio-group-palette-solid-hover)
5 radio-group.css:161 [data-radio-group][data-variant='outline'] [data-radio-group-item][data-state='checked'] border-color var(--_radio-group-palette-solid)
6 radio-group.css:173 [data-radio-group][data-variant='ghost'] [data-radio-group-item]:hover:not([data-disabled]):not([data-readonly]) background color-mix(in srgb, var(--_radio-group-palette-solid) 8%, transparent)
7 radio-group.css:178 [data-radio-group][data-variant='ghost'] [data-radio-group-item][data-state='checked'] background color-mix(in srgb, var(--_radio-group-palette-solid) 18%, transparent)
8 radio-group.css:214 [data-radio-group-indicator] color var(--_radio-group-palette-text)
9 radio-group.css:355 [data-radio-group][data-variant='segmented'] [data-radio-group-item][data-state='checked'] color var(--_radio-group-palette-text)
10 radio-group.css:372 [data-radio-group-selection-indicator] background var(--_radio-group-palette-solid)

1.3 Literales (0)

Ninguno.

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 (2) — 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 radio-group.css:138 [data-radio-group-item]:focus-visible outline var(--focus-ring-width) solid var(--focus-ring-color)
2 radio-group.css:359 [data-radio-group][data-variant='segmented'] [data-radio-group-item]: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?
--_radio-group-palette-text 4 var(--radio-group-dot-fg), var(--_radio-group-palette-solid) private, public no

Consumidos y no declarados en el CSS (vienen de base.ts o de un estilo inline del wrapper): --_radio-group-columns, --_radio-group-palette-solid, --_radio-group-palette-solid-hover.

4. Propuesta de corrección

  • Consume la capa compartida sliding-indicator. Un eje que la capa posee se consume como var(--_x, var(--x)); el consumidor no acuña --radio-group-{eje} para él — sería un vocabulario paralelo (README de eidos/components, «Capas compartidas» regla 2).
  • Tiene eje size: los tokens dimensionales van por talla ({part}-{eje}-{k}) apuntando al bundle --size-{k}-*, nunca al primitivo crudo (theming §5; el guard recipe-css-contract prohíbe el primitivo).

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

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 (--radio-group-…) scope TSC valor propuesto usos
indicator-fg root ⚠ var(--radio-group-dot-fg) / var(--_radio-group-palette-solid) 4
segmented-on-item-fg root ⚠ var(--radio-group-dot-fg) / var(--_radio-group-palette-solid) 4
invalid-row-label-fg root var(--color-threat-text) 1
row-height root var(--touch-target) 1
item-width root var(--_radio-item-size) 1
item-height root var(--_radio-item-size) 1
invalid-item-border root var(--color-threat-element) 1
invalid-item-shadow root 0 0 0 2px var(--color-surface-default), 0 0 0 4px var(--color-threat-element) 1
segmented-item-padding-block root var(--space-1) 1

4.2 Sin nombre mecánico (8)

  • ⚠ 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 — 8: background, border-color.

4.3 Avisos sobre los tokens propuestos (1)

  • el privado --_radio-group-palette-text debe pasar a leer este público (o desaparecer) — --radio-group-indicator-fg, --radio-group-segmented-on-item-fg

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

(pendiente — lo escribe el autor; se conserva al regenerar)

Powered by TurnKey Linux.