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/text-focus.md

78 lines
3.4 KiB

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# text-focus — 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](./README.md) · método y protocolo:
> [`PLAN-theming.md`](../../process/PLAN-theming.md) §1, §2, §7.
- **Medido**: 2026-08-23 · **Alcance**: **100%** — 8 de 8 knobs por token público
- **Knobs de apariencia**: 8 — público 8 · privado 0 · global 0 · literal 0 · sistema 0 · excepción 0 _(los dos últimos, fuera del ratio)_
- **Contrato hoy** (`lib/recipes/base.ts`): 8 pública(s) — `gap`, `word-weight`, `word-size`, `corner-size`, `corner-width`, `corner-radius`, `border-fg`, `glow-fg`
- **Eje `size`**: no · **ficheros**: `text-focus.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 (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 (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?
_La receta no declara privados propios en su CSS._
## 4. Propuesta de corrección
_Nada que proponer: no hay knobs fuera de alcance._
### 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
<!-- veredicto:start -->
**Medido 2026-08-22.** Mismo patrón que `text-circular`: cinco públicos «de
facto» consumidos con fallback y **ninguno declarado**, más tres knobs que sí
faltaban, todos en la ESQUINA del marco de foco.
1. **La esquina es una escuadra dibujada con bordes**: `1rem × 1rem` con dos de
sus cuatro lados a `0` según la posición (`tl`, `tr`, `bl`, `br`). El tamaño
es UN knob (`corner-size`, las dos dimensiones), el grosor del trazo otro
(`corner-width`, hoy `3px` a pelo) y el radio el tercero.
2. **Los desplazamientos `-0.625rem` de cada esquina NO son knobs**: colocan la
escuadra justo fuera del marco y su valor se deriva del tamaño y el trazo —
son construcción de la forma, como las proporciones del spinner.
3. **`border-fg` y `glow-fg` son el mismo acento en dos capas** (el trazo
y su resplandor via `drop-shadow`), y los dos ya leen el mismo default. Se
declaran por separado a propósito: un tema puede querer el halo de otro tono
que el borde.
<!-- veredicto:end -->

Powered by TurnKey Linux.