svelte-kit-vice/docs/audit/theming/toast.md

toast — 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: 98% — 41 de 42 knobs por token público
• Knobs de apariencia: 42 — público 41 · privado 0 · global 0 · literal 1 · sistema 0 · excepción 0 (los dos últimos, fuera del ratio)
• Contrato hoy (lib/recipes/base.ts): 85 pública(s) — toaster-z, toaster-inset, toaster-gap, toaster-width, provider-min-width, provider-max-width, provider-gap, provider-stack-gap, provider-padding-inline, provider-padding-block, provider-border-width, provider-radius, provider-shadow, accent-width, transition-duration, transition-ease, closed-offset, closed-scale, status-size, status-radius, title-font-family, title-font-size, title-font-weight, title-line-height, title-fg, message-fg, description-font-family, description-font-size, description-line-height, description-fg, action-gap, action-padding-inline, action-padding-block, action-margin-top, action-border-width, action-radius, action-font-family, action-font-size, action-font-weight, action-line-height, action-focus-ring-offset, action-focus-ring-width, action-focus-ring-color, default-surface, default-border, default-accent, default-status-bg, default-status-fg, default-action-fg, default-action-hover-bg, affirm-surface, affirm-border, affirm-accent, affirm-status-bg, affirm-status-fg, affirm-action-fg, affirm-action-hover-bg, fulfill-surface, fulfill-border, fulfill-accent, fulfill-status-bg, fulfill-status-fg, fulfill-action-fg, fulfill-action-hover-bg, risk-surface, risk-border, risk-accent, risk-status-bg, risk-status-fg, risk-action-fg, risk-action-hover-bg, threat-surface, threat-border, threat-accent, threat-status-bg, threat-status-fg, threat-action-fg, threat-action-hover-bg, loss-surface, loss-border, loss-accent, loss-status-bg, loss-status-fg, loss-action-fg, loss-action-hover-bg
• Eje size: no · ficheros: toast.css

1. Knobs fuera de alcance

1.1 Directo a primitivo global (0)

Ninguno.

1.2 A través de un privado (0)

Ninguno.

1.3 Literales (1)

#	fichero:línea	selector	propiedad	valor
1	toast.css:101	[data-toast-item]	opacity	1

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 (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?
--_toast-surface	6	var(--toast-default-surface), var(--toast-affirm-surface), var(--toast-fulfill-surface), var(--toast-risk-surface), var(--toast-threat-surface), var(--toast-loss-surface)	public	sí
--_toast-border	6	var(--toast-default-border), var(--toast-affirm-border), var(--toast-fulfill-border), var(--toast-risk-border), var(--toast-threat-border), var(--toast-loss-border)	public	sí
--_toast-accent	6	var(--toast-default-accent), var(--toast-affirm-accent), var(--toast-fulfill-accent), var(--toast-risk-accent), var(--toast-threat-accent), var(--toast-loss-accent)	public	sí
--_toast-status-bg	6	var(--toast-default-status-bg), var(--toast-affirm-status-bg), var(--toast-fulfill-status-bg), var(--toast-risk-status-bg), var(--toast-threat-status-bg), var(--toast-loss-status-bg)	public	sí
--_toast-status-color	6	var(--toast-default-status-fg), var(--toast-affirm-status-fg), var(--toast-fulfill-status-fg), var(--toast-risk-status-fg), var(--toast-threat-status-fg), var(--toast-loss-status-fg)	public	sí
--_toast-action-color	6	var(--toast-default-action-fg), var(--toast-affirm-action-fg), var(--toast-fulfill-action-fg), var(--toast-risk-action-fg), var(--toast-threat-action-fg), var(--toast-loss-action-fg)	public	sí
--_toast-action-hover-bg	6	var(--toast-default-action-hover-bg), var(--toast-affirm-action-hover-bg), var(--toast-fulfill-action-hover-bg), var(--toast-risk-action-hover-bg), var(--toast-threat-action-hover-bg), var(--toast-loss-action-hover-bg)	public	sí

4. Propuesta de corrección

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

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 (--toast-…)	scope TSC	valor propuesto	usos

4.2 Sin nombre mecánico (1)

• ⚠ 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: opacity.

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)