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/picker-shell.md

6.9 KiB

picker-shell — 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: 0% — 0 de 21 knobs por token público
  • Knobs de apariencia: 21 — público 0 · privado 4 · global 17 · literal 0 · sistema 0 (fuera del ratio)
  • Contrato hoy (lib/recipes/base.ts): sin entrada en base.ts
  • Eje size: sí · ficheros: picker-shell.css, picker-time-row.css

1. Knobs fuera de alcance

1.1 Directo a primitivo global (17)

# fichero:línea selector propiedad valor
1 picker-shell.css:32 [data-picker-header] gap var(--space-2)
2 picker-shell.css:34 [data-picker-header] border-block-end var(--border-width) solid var(--color-border-subtle)
3 picker-shell.css:35 [data-picker-header] color var(--color-content-primary)
4 picker-shell.css:36 [data-picker-header] font-size var(--font-size-sm)
5 picker-shell.css:37 [data-picker-header] font-weight var(--font-weight-medium)
6 picker-shell.css:38 [data-picker-header] line-height var(--leading-ui)
7 picker-shell.css:44 [data-picker-body] gap var(--space-3)
8 picker-shell.css:61 [data-picker-footer] border-block-start var(--border-width) solid var(--color-border-subtle)
9 picker-shell.css:89 [data-popover-content][data-picker-size='xs'] [data-picker-header] font-size var(--font-size-xs)
10 picker-shell.css:100 [data-popover-content][data-picker-size='md'] [data-picker-header] font-size var(--font-size-md)
11 picker-shell.css:108 [data-popover-content][data-picker-size='lg'] [data-picker-header] font-size var(--font-size-md)
12 picker-time-row.css:9 .picker-time-row gap var(--space-3)
13 picker-time-row.css:10 .picker-time-row padding-block-start var(--space-2)
14 picker-time-row.css:11 .picker-time-row padding-inline var(--space-2)
15 picker-time-row.css:12 .picker-time-row border-block-start var(--border-width, 1px) solid var(--color-neutral-border)
16 picker-time-row.css:32 .picker-time-label color var(--color-content-secondary)
17 picker-time-row.css:33 .picker-time-label font-size var(--_picker-time-label-font)

1.2 A través de un privado (4)

# fichero:línea selector propiedad valor
1 picker-shell.css:20 [data-picker-shell] gap var(--_picker-shell-section-gap)
2 picker-shell.css:33 [data-picker-header] padding-block-end var(--_picker-shell-row-spacing)
3 picker-shell.css:59 [data-picker-footer] gap var(--_picker-shell-gap)
4 picker-shell.css:60 [data-picker-footer] padding-block-start var(--_picker-shell-row-spacing)

1.3 Literales (0)

Ninguno.

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

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

Ninguno.

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

privado declaraciones valor(es) origen ¿deriva de un público?
--_picker-shell-section-gap 4 var(--space-3), var(--space-2), var(--space-3-5), var(--space-4) global no
--_picker-shell-row-spacing 6 var(--space-3), var(--space-2), var(--space-4) global no
--_picker-shell-gap 3 var(--space-2), var(--space-1-5), var(--space-2-5) global no

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 guard recipe-css-contract prohíbe el primitivo).

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

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 (--picker-shell-…) scope TSC valor propuesto usos
padding-block root ⚠ var(--space-3) / var(--space-2) / var(--space-4) 13
gap root ⚠ var(--space-3) / var(--space-2) / var(--space-3-5) / var(--space-4) / var(--space-1-5) / var(--space-2-5) 10
font-size root ⚠ var(--font-size-sm) / var(--font-size-xs) / var(--font-size-md) / var(--_picker-time-label-font) 5
fg root ⚠ var(--color-content-primary) / var(--color-content-secondary) 2
font-weight root var(--font-weight-medium) 1
line-height root var(--leading-ui) 1
padding-inline root var(--space-2) 1

4.2 Sin nombre mecánico (3)

  • ⚠ decisión: border-block-end es shorthand o eje físico — hay que partirlo en ejes lógicos antes de nombrarlo (recipe-contract §1, R-4.4) — 1: border-block-end.
  • ⚠ decisión: border-block-start es shorthand o eje físico — hay que partirlo en ejes lógicos antes de nombrarlo (recipe-contract §1, R-4.4) — 2: border-block-start.

4.3 Avisos sobre los tokens propuestos (3)

  • el privado --_picker-shell-section-gap debe pasar a leer este público (o desaparecer) — --picker-shell-gap
  • el privado --_picker-shell-row-spacing debe pasar a leer este público (o desaparecer) — --picker-shell-padding-block
  • el privado --_picker-shell-gap debe pasar a leer este público (o desaparecer) — --picker-shell-gap

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.