svelte-kit-vice

Commit Graph

Author	SHA1	Message	Date
dev	c39170abbf	fix(uix): la auditoría del sistema — lo que los guards no veían Auditoría clean-room de todo ActiveUIX (excluido `web/`), componente a componente. Lo que sale de aquí no es una lista de bugs: es un patrón. El framework validaba que lo escrito fuese VÁLIDO, no que lo declarado se CUMPLIESE — y sus guards fallaban ABIERTOS. ## El colapso de las uniones de props (95 → 0) Un `Props` de eidos es `{ …props propias… } & <atributos nativos>`. Cuando el elemento declara un atributo homónimo, la intersección funde ambos y una unión estrecha contra el `string` nativo COLAPSA a `string`. Causa: `Without<T, U> = Omit<T, keyof U>` invocado como `Without<T, {}>` — `Omit<T, never>`, un no-op — 433 veces en soma; sólo 3 con argumento real. Invisible para `svelte-check`: ensanchar un tipo no es un error, es una garantía perdida. Medido: 95 props en 72 componentes. `<Avatar color="nonsense">` compilaba. `ComboboxInput.size` chocaba con el `<input size>` numérico y era inusable. Migrado con codemod sobre AST (nunca regex) a `Own & Omit<Nativos, keyof Own>`: 92 tipos en 73 ficheros + carousel a mano. `check` no se movió. Garantía nueva: `eidos/prop-surface.test.ts` (PROP-1) compara los literales de la anotación del autor contra los de la propiedad pública. Verificado que falla reintroduciendo el defecto. ## Los cuatro guards que fallaban abiertos - `translations:check` crasheaba en CADA ejecución de su historia — un stripper de comentarios borraba `//` dentro de strings. Sustituido por import dinámico. Al arrancar destapó 8 slots `texts` sin traducción. - `soma-attr-audit` agotaba el timeout de 5 s: sin veredicto, verde por omisión. - `component-audit` D-7.4 hacía `continue` mudo cuando el tipo no resolvía. Ahora resuelve con el checker de TypeScript (`scripts/prop-unions.ts`): puntos ciegos de 124 → 3. - `component-audit` R-1.1: el regex casaba `[data-motion='reduce']` y daba PASS por el motivo equivocado. Regla adoptada: un guard que no puede evaluar TIENE que decirlo. El informe lleva ahora bloque «Not verified» y recuento en el resumen. ## D-1 · tooltip y D-2 · card, cableados `tooltip` declaraba 3 eventos `emerge` que nadie emitía. Ahora emiten; `present` pasa a `sequence: 'post'` — con `'pre'` el hold de ~240 ms gateaba el montaje del propio overlay. `card` declaraba `commit-select` sin emisor posible (scope sin soma). Puente headless en `soma/components/card/` con la forma ya establecida por `menu-dial` / `onion-menu`: eidos posee estado y render, soma posee sólo el `SomaRuntime` que emite. ## Documentación: 22 mentiras corregidas `docs/` afirmaba guards inexistentes (`NO_MISSING_PROVIDER_TESTS`), APIs con firma equivocada y un modelo de Motion que el código no implementa. Corregido en CANON, arquitectura, glosario, theming/motion, checklist y los README de `motion` / `callout` / `arts/motion`. ## Además - CardGroup: la descripción se metía en la primera celda del grid. - Motion: `data-state` siempre estampado, salida real en `leave()`, token fantasma `--motion-stagger-each-default` eliminado. - `engine-motion`: `handoffState` Map → WeakMap (fuga por nodo). - `mockup`: primitivo crudo → token de rol (R-4.6). - 5 catálogos de traducción que faltaban. Handoff: `docs/process/CONTINUE-audit-2026-07-29.md`. Batería: check 0 errores en src · vitest server 3701/3701 · docs:check 0/0 · component:audit 161 PASS / 2 NEEDS-WORK. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago
dev	63b371d5ce	feat(packs+text): incorporate the animation collection — Ambient pack + text-effects family + docs Two streams, split by what the animation touches: STREAM A — decorative backgrounds → the pack tier - arts/scene: a consolidated scene runtime ($scene) that owns, once, the citizenship every ad-hoc background reinvented or skipped (frame loop, off-view pause, DPR cap, mandatory reduced-motion, WebGL context loss/restore, scene budget, teardown). SceneDom port (adom satisfies it), webgl/webgl2/canvas2d drivers + a custom-pipeline extension (vertexShader + draw + glContext.depth/dprCap) for real geometry (beam, particles, dither, grid, eter, pixel-blast, hyperspeed). 32 effects as shared resources. - src/packs/ambient: the first pack — <Ambient effect="…"> mounts a registered effect; the P contract (P-1..P-6) guarded by scripts/packs-check.ts; colors are token-aware (P-4). One-way dependency, removable-by-construction. - resolveToken extended to semantic color slots (--color-{role}-{slot}) so consumers resolve theme tokens to concrete colors (the P-4 half). STREAM B — animations over real text → canon - Six components (count-up + text-{gradient,circular,blur,focus,scramble}): each a morfo + eidos recipe (where there's styling) + demo. CountUp is a service component (counts through uix.format.numbers). The five Text* are passive decoratives. Upgrades over the seeds: SR hardening (real text visually-hidden + aria-hidden decoration), a11y fix (no fake role=button), measurement discipline (cached rects via dom.measure, no reflow storm), reduced-motion, ecosystem citizenship (eidos.dom/timers, no raw platform). - MorfoElement gains 'p'. DOCS - docs/architecture/packs.md (pack tier, admission rule, P contract, Aura promotion path); docs/decisions/design-text-effects.md (the family design record) + indexed in decisions.md / README.md; glossary entries (scene/Ambient/Aura/text effects); scene README custom-pipeline + authoring bridge; motion-guide content-effects note; strata tables acknowledge packs. Gates: component:audit 141/0/0 · docs:check 0/0 · scene tests 9/9 · packs:check 0/36 · check 0 own errors. Verified in browser (32 effects mount+compile; 6 text components SSR+hydrate, CountUp re-formats by locale live, TextGradient resolves token stops to OKLCH via var()). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago

Author

SHA1

Message

Date

dev

c39170abbf

fix(uix): la auditoría del sistema — lo que los guards no veían

Auditoría clean-room de todo ActiveUIX (excluido `web/`), componente a
componente. Lo que sale de aquí no es una lista de bugs: es un patrón.
El framework validaba que lo escrito fuese VÁLIDO, no que lo declarado
se CUMPLIESE — y sus guards fallaban ABIERTOS.

## El colapso de las uniones de props (95 → 0)

Un `Props` de eidos es `{ …props propias… } & <atributos nativos>`.
Cuando el elemento declara un atributo homónimo, la intersección funde
ambos y una unión estrecha contra el `string` nativo COLAPSA a `string`.

Causa: `Without<T, U> = Omit<T, keyof U>` invocado como `Without<T, {}>`
— `Omit<T, never>`, un no-op — 433 veces en soma; sólo 3 con argumento
real. Invisible para `svelte-check`: ensanchar un tipo no es un error,
es una garantía perdida.

Medido: 95 props en 72 componentes. `<Avatar color="nonsense">`
compilaba. `ComboboxInput.size` chocaba con el `<input size>` numérico
y era inusable. Migrado con codemod sobre AST (nunca regex) a
`Own & Omit<Nativos, keyof Own>`: 92 tipos en 73 ficheros + carousel a
mano. `check` no se movió.

Garantía nueva: `eidos/prop-surface.test.ts` (PROP-1) compara los
literales de la anotación del autor contra los de la propiedad pública.
Verificado que falla reintroduciendo el defecto.

## Los cuatro guards que fallaban abiertos

- `translations:check` crasheaba en CADA ejecución de su historia — un
  stripper de comentarios borraba `//` dentro de strings. Sustituido por
  import dinámico. Al arrancar destapó 8 slots `texts` sin traducción.
- `soma-attr-audit` agotaba el timeout de 5 s: sin veredicto, verde por
  omisión.
- `component-audit` D-7.4 hacía `continue` mudo cuando el tipo no
  resolvía. Ahora resuelve con el checker de TypeScript
  (`scripts/prop-unions.ts`): puntos ciegos de 124 → 3.
- `component-audit` R-1.1: el regex casaba `[data-motion='reduce']` y
  daba PASS por el motivo equivocado.

Regla adoptada: un guard que no puede evaluar TIENE que decirlo. El
informe lleva ahora bloque «Not verified» y recuento en el resumen.

## D-1 · tooltip y D-2 · card, cableados

`tooltip` declaraba 3 eventos `emerge` que nadie emitía. Ahora emiten;
`present` pasa a `sequence: 'post'` — con `'pre'` el hold de ~240 ms
gateaba el montaje del propio overlay.

`card` declaraba `commit-select` sin emisor posible (scope sin soma).
Puente headless en `soma/components/card/` con la forma ya establecida
por `menu-dial` / `onion-menu`: eidos posee estado y render, soma posee
sólo el `SomaRuntime` que emite.

## Documentación: 22 mentiras corregidas

`docs/` afirmaba guards inexistentes (`NO_MISSING_PROVIDER_TESTS`),
APIs con firma equivocada y un modelo de Motion que el código no
implementa. Corregido en CANON, arquitectura, glosario, theming/motion,
checklist y los README de `motion` / `callout` / `arts/motion`.

## Además

- CardGroup: la descripción se metía en la primera celda del grid.
- Motion: `data-state` siempre estampado, salida real en `leave()`,
  token fantasma `--motion-stagger-each-default` eliminado.
- `engine-motion`: `handoffState` Map → WeakMap (fuga por nodo).
- `mockup`: primitivo crudo → token de rol (R-4.6).
- 5 catálogos de traducción que faltaban.

Handoff: `docs/process/CONTINUE-audit-2026-07-29.md`.

Batería: check 0 errores en src · vitest server 3701/3701 ·
docs:check 0/0 · component:audit 161 PASS / 2 NEEDS-WORK.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

dev

63b371d5ce

feat(packs+text): incorporate the animation collection — Ambient pack + text-effects family + docs

Two streams, split by what the animation touches:

STREAM A — decorative backgrounds → the pack tier
- arts/scene: a consolidated scene runtime ($scene) that owns, once, the
  citizenship every ad-hoc background reinvented or skipped (frame loop,
  off-view pause, DPR cap, mandatory reduced-motion, WebGL context
  loss/restore, scene budget, teardown). SceneDom port (adom satisfies it),
  webgl/webgl2/canvas2d drivers + a custom-pipeline extension (vertexShader +
  draw + glContext.depth/dprCap) for real geometry (beam, particles, dither,
  grid, eter, pixel-blast, hyperspeed). 32 effects as shared resources.
- src/packs/ambient: the first pack — <Ambient effect="…"> mounts a registered
  effect; the P contract (P-1..P-6) guarded by scripts/packs-check.ts; colors
  are token-aware (P-4). One-way dependency, removable-by-construction.
- resolveToken extended to semantic color slots (--color-{role}-{slot}) so
  consumers resolve theme tokens to concrete colors (the P-4 half).

STREAM B — animations over real text → canon
- Six components (count-up + text-{gradient,circular,blur,focus,scramble}):
  each a morfo + eidos recipe (where there's styling) + demo. CountUp is a
  service component (counts through uix.format.numbers). The five Text* are
  passive decoratives. Upgrades over the seeds: SR hardening (real text
  visually-hidden + aria-hidden decoration), a11y fix (no fake role=button),
  measurement discipline (cached rects via dom.measure, no reflow storm),
  reduced-motion, ecosystem citizenship (eidos.dom/timers, no raw platform).
- MorfoElement gains 'p'.

DOCS
- docs/architecture/packs.md (pack tier, admission rule, P contract, Aura
  promotion path); docs/decisions/design-text-effects.md (the family design
  record) + indexed in decisions.md / README.md; glossary entries
  (scene/Ambient/Aura/text effects); scene README custom-pipeline + authoring
  bridge; motion-guide content-effects note; strata tables acknowledge packs.

Gates: component:audit 141/0/0 · docs:check 0/0 · scene tests 9/9 · packs:check
0/36 · check 0 own errors. Verified in browser (32 effects mount+compile;
6 text components SSR+hydrate, CountUp re-formats by locale live, TextGradient
resolves token stops to OKLCH via var()).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2 Commits (352ca8bbecf7411283c122b4ef06f280c418e03c)