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/textarea.md

12 KiB

textarea — 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 25 knobs por token público
  • Knobs de apariencia: 28 — público 0 · privado 16 · global 5 · literal 4 · sistema 3 (fuera del ratio)
  • Contrato hoy (lib/recipes/base.ts): 0 pública(s) · 1 privada(s) forward — _palette-solid
  • Eje size: sí · ficheros: textarea.css

1. Knobs fuera de alcance

1.1 Directo a primitivo global (5)

# fichero:línea selector propiedad valor
1 textarea.css:88 [data-textarea-input] font-family var(--font-family-primary)
2 textarea.css:89 [data-textarea-input] font-weight var(--font-weight-medium)
3 textarea.css:111 [data-textarea-input][data-invalid] border-color var(--color-threat-solid)
4 textarea.css:142 [data-textarea-count] font-family var(--font-family-mono, ui-monospace, monospace)
5 textarea.css:150 [data-textarea-count][data-overflow] font-weight var(--font-weight-semibold)

1.2 A través de un privado (16)

# fichero:línea selector propiedad valor
1 textarea.css:29 [data-textarea] gap var(--_textarea-gap)
2 textarea.css:82 [data-textarea-input] padding-block var(--_textarea-padding-block)
3 textarea.css:83 [data-textarea-input] padding-inline var(--_textarea-padding-inline)
4 textarea.css:84 [data-textarea-input] border var(--border-width) solid var(--_textarea-border)
5 textarea.css:85 [data-textarea-input] border-radius var(--_textarea-radius)
6 textarea.css:86 [data-textarea-input] background var(--_textarea-bg)
7 textarea.css:87 [data-textarea-input] color var(--_textarea-color)
8 textarea.css:90 [data-textarea-input] font-size var(--_textarea-font-size)
9 textarea.css:91 [data-textarea-input] line-height var(--_textarea-line-height)
10 textarea.css:99 [data-textarea-input]:hover:not([data-disabled]):not([data-readonly]) border-color var(--_textarea-border-hover)
11 textarea.css:103 [data-textarea][data-focused] [data-textarea-input] border-color var(--_textarea-border-focus)
12 textarea.css:123 [data-textarea][data-variant='ghost'][data-focused] [data-textarea-input] border-color var(--_textarea-border-focus)
13 textarea.css:132 [data-textarea-input]::placeholder color var(--_textarea-placeholder)
14 textarea.css:141 [data-textarea-count] color var(--_textarea-count-color)
15 textarea.css:143 [data-textarea-count] font-size calc(var(--_textarea-font-size) * 0.85)
16 textarea.css:149 [data-textarea-count][data-overflow] color var(--_textarea-count-overflow)

1.3 Literales (4)

# fichero:línea selector propiedad valor
1 textarea.css:30 [data-textarea] inline-size 100%
2 textarea.css:79 [data-textarea-input] inline-size 100%
3 textarea.css:139 [data-textarea-count] gap 0.25em
4 textarea.css:145 [data-textarea-count] line-height 1

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 textarea.css:106 [data-textarea][data-focused] [data-textarea-input] outline var(--focus-ring-width) solid var(--focus-ring-color)
2 textarea.css:128 [data-textarea-input][data-disabled] opacity var(--opacity-disabled)
3 textarea.css:154 [data-textarea-count-sep] opacity var(--opacity-muted)

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

privado declaraciones valor(es) origen ¿deriva de un público?
--_textarea-padding-inline 5 var(--space-3), var(--space-2), var(--space-4), var(--space-5) global no
--_textarea-padding-block 5 var(--space-2), var(--space-1), var(--space-1-5), var(--space-3), var(--space-4) global no
--_textarea-gap 1 var(--space-2) global no
--_textarea-font-size 5 var(--font-size-md), var(--font-size-xs), var(--font-size-sm), var(--font-size-lg), var(--font-size-xl) global no
--_textarea-line-height 1 var(--leading-normal) global no
--_textarea-radius 1 var(--radius-default) global no
--_textarea-border 1 var(--color-neutral-border) global no
--_textarea-border-hover 1 var(--color-border-strong) global no
--_textarea-border-focus 2 var(--focus-ring-color), var(--_textarea-palette-solid) private, system no
--_textarea-bg 1 var(--color-surface-default) global no
--_textarea-color 1 var(--color-content-primary) global no
--_textarea-placeholder 1 var(--color-content-muted) global no
--_textarea-count-color 1 var(--color-content-muted) global no
--_textarea-count-overflow 1 var(--color-threat-text) global no
--_textarea-resize 4 vertical, none, horizontal, both literal no

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

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 (35)

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 (--textarea-…) scope TSC valor propuesto usos
input-fg root ⚠ var(--color-content-primary) / var(--color-content-muted) 2
input-border root ⚠ var(--focus-ring-color) / var(--_textarea-palette-solid) 2
ghost-input-border root ⚠ var(--focus-ring-color) / var(--_textarea-palette-solid) 2
count-fg root ⚠ var(--color-content-muted) / var(--color-threat-text) 2
gap root var(--space-2) 1
input-padding-block-md size:md var(--space-2) 1
input-padding-block-xs size:xs var(--space-1) 1
input-padding-block-sm size:sm var(--space-1-5) 1
input-padding-block-lg size:lg var(--space-3) 1
input-padding-block-xl size:xl var(--space-4) 1
input-padding-inline-md size:md var(--space-3) 1
input-padding-inline-xs size:xs var(--space-2) 1
input-padding-inline-sm size:sm var(--space-2) 1
input-padding-inline-lg size:lg var(--space-4) 1
input-padding-inline-xl size:xl var(--space-5) 1
input-radius root var(--radius-default) 1
input-bg root var(--color-surface-default) 1
input-font-family root var(--font-family-primary) 1
input-font-weight root var(--font-weight-medium) 1
input-font-size-md size:md var(--font-size-md) 1
input-font-size-xs size:xs var(--font-size-xs) 1
input-font-size-sm size:sm var(--font-size-sm) 1
input-font-size-lg size:lg var(--font-size-lg) 1
input-font-size-xl size:xl var(--font-size-xl) 1
input-line-height root var(--leading-normal) 1
hover-input-border root var(--color-border-strong) 1
invalid-input-border root var(--color-threat-solid) 1
count-gap root 0.25em 1
count-font-family root var(--font-family-mono, ui-monospace, monospace) 1
count-font-size-md size:md var(--font-size-md) 1
count-font-size-xs size:xs var(--font-size-xs) 1
count-font-size-sm size:sm var(--font-size-sm) 1
count-font-size-lg size:lg var(--font-size-lg) 1
count-font-size-xl size:xl var(--font-size-xl) 1
count-font-weight root var(--font-weight-semibold) 1

4.2 Sin nombre mecánico (4)

  • ⚠ 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 — 2: inline-size.
  • ⚠ decisión: border es shorthand o eje físico — hay que partirlo en ejes lógicos antes de nombrarlo (recipe-contract §1, R-4.4) — 1: border.
  • ⚠ decisión: 1 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: line-height.

4.3 Avisos sobre los tokens propuestos (13)

  • el privado --_textarea-gap debe pasar a leer este público (o desaparecer) — --textarea-gap
  • el privado --_textarea-padding-block debe pasar a leer este público (o desaparecer) — --textarea-input-padding-block-md, --textarea-input-padding-block-xs, --textarea-input-padding-block-sm, --textarea-input-padding-block-lg, --textarea-input-padding-block-xl
  • el privado --_textarea-padding-inline debe pasar a leer este público (o desaparecer) — --textarea-input-padding-inline-md, --textarea-input-padding-inline-xs, --textarea-input-padding-inline-sm, --textarea-input-padding-inline-lg, --textarea-input-padding-inline-xl
  • el privado --_textarea-radius debe pasar a leer este público (o desaparecer) — --textarea-input-radius
  • el privado --_textarea-bg debe pasar a leer este público (o desaparecer) — --textarea-input-bg
  • el privado --_textarea-color debe pasar a leer este público (o desaparecer) — --textarea-input-fg
  • el privado --_textarea-font-size debe pasar a leer este público (o desaparecer) — --textarea-input-font-size-md, --textarea-input-font-size-xs, --textarea-input-font-size-sm, --textarea-input-font-size-lg, --textarea-input-font-size-xl, --textarea-count-font-size-md, --textarea-count-font-size-xs, --textarea-count-font-size-sm, --textarea-count-font-size-lg, --textarea-count-font-size-xl
  • el privado --_textarea-line-height debe pasar a leer este público (o desaparecer) — --textarea-input-line-height
  • el privado --_textarea-border-hover debe pasar a leer este público (o desaparecer) — --textarea-hover-input-border
  • el privado --_textarea-border-focus debe pasar a leer este público (o desaparecer) — --textarea-input-border, --textarea-ghost-input-border
  • el privado --_textarea-placeholder debe pasar a leer este público (o desaparecer) — --textarea-input-fg
  • el privado --_textarea-count-color debe pasar a leer este público (o desaparecer) — --textarea-count-fg
  • el privado --_textarea-count-overflow debe pasar a leer este público (o desaparecer) — --textarea-count-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.