10 Commits (cef2d32f161eb2d42e628003963346b8db0c9b98)

Author	SHA1	Message	Date
dev	2870874cbb	docs(opts): la auditoria exhaustiva del corpus — el canon deja de mentir ... Barrido mecanico sobre los 673 .md del repo (1485 bloques de codigo en 319 docs): cada import contra la tabla de alias real, cada *Provider/*Opts contra 11481 simbolos del codigo, cada tabla de props de los 284 READMEs contra su types.ts. Causado por el eje de opts: - active-architecture §8 (canon) daba OptsFromProps SIN el 4o parametro —el que salva el `undefined`— y bindProps en forma v1; partOpts no aparecia pese a ser el mecanismo de 288 wrappers. Tabla reescrita + las dos notas que la tabla no puede llevar. - architecture/soma.md tenia el UNICO bloque con bolsa manual que quedaba en los 673, y sus DOS imports eran rutas fantasma ('../../reactive', '../../props'). Ejemplo reescrito al canon. - CONTINUE-direction afirmaba que switch no podia usar OptsFromProps y que bindProps no acepta Active: falso por ambas mitades desde el eje. Marcado. - CONTINUE-opts-canonicas se leia como plan VIVO con seis decisiones sin tomar —una sesion futura habria rehecho 353 ficheros—: banner de cierre con lo que cada decision acabo siendo. - El invariante de catalogo sube al estrato arquitectura y gana filas de aceptacion E-3.7 / E-3.8. drawer documenta que el snap SOBREVIVE al cierre; knob y cropper precisan que su callback cubre reset y clamp. Preexistentes que solo aparecen con el metodo exhaustivo: - carousel documentaba `value`/`onValueChange`; son `index`/`onIndexChange` —y el mismo README ya decia `index` doce lineas mas abajo. - navigation-menu seguia con `skipDelayDuration`, renombrado a `groupSkipDelay` en la pasada N6 (el propio types.ts registra el rename). - textarea documentaba `submitShortcut` con **el default invertido**: el prop es `submitOn` y por defecto es `false`, no 'mod+enter' —un consumidor esperaba que Ctrl+Enter enviara de fabrica—, y `minLength` no existe. - search-field ensenaba a envolver el callback en un debounce a mano (con el alias `$lib`, retirado del proyecto) teniendo `debounceMs` propio: era debounce sobre debounce. - GESTURES nombraba SplitterTriggerProvider; la clase es SplitterResizeTriggerProvider. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago
dev	b80ccb33cb	docs(direction): el contrato pasa a ser canon, y el corpus deja de contradecirlo ... El eje estaba cerrado en CODIGO y no en DOCUMENTACION. El contrato vivia solo en `CONTINUE-direction.md`, un handoff que `docs/README.md` declara «never a source of truth». Un capitulo E2 lo fija ahora: `docs/canon/direction-contract.md`. Va a canon y no a arquitectura por la misma razon que `recipe-contract.md`: es normativo y tiene guard ejecutable. Cubre la cadena y donde corre cada eslabon; por que `undefined` no es `'ltr'`; las DOS atributos —`dir` crudo (nativo, lo que `:dir()` mira) y `data-dir` resuelto (opt-in, para recetas que necesitan un hook incondicional)—; cuando el estampado es OBLIGATORIO; la doctrina de selector; las trampas que el guard no ve; que espeja y que no; y la mitad global de prefs. EL CORPUS SE CONTRADECIA en cuatro sitios, y dos de ellos ENSENABAN mal: - `component-guide.md:372` daba la cadena como `prefs → 'ltr'`, DOS eslabones, mandando al wrapper a leer prefs directamente. Eso excluye la prop. - `soma-architecture.md` §3.4 presentaba el resolutor a pelo (`soma.prefs.getDir()` dentro del provider) como LA forma de obtener la direccion — justo lo que el eje retiro del catalogo. - `html.ts` ensenaba en su JSDoc `dir?: 'ltr' | 'rtl'`, el union a mano que la regla E-2.5 ahora prohibe. El mecanismo que ensena (extender para estrechar una clave HTML) es correcto y sobrevive; solo cambia el ejemplo. - `active-architecture.md:416` no listaba `lang` en la proyeccion, contra `contracts.ts` y contra su propio test de frontera. Igual `prefs/README.md`. Y no lo mencionaba en absoluto: el glosario (`activeDir`, `resolvedDir`, `data-dir`, RTL-1, el escape `rtl-physical:`), `eidos.md` (RTL-1 es el TERCER guard de deriva y faltaba junto al builder tipado y eidos-lint), `soma.md`, `building-a-component.md` (§Known traps es exactamente donde va «la prop mueve la matematica y deja la pintura atras»), y la tabla de atributos de la arquitectura, que afirma «todo lo que viaja entre capas viaja por atributos» y omitia `dir`. El checklist gana cuatro reglas y el guard que faltaba (`rtl:check` no estaba en la matriz de aceptacion pese a que la tabla canon lo nombra), mas un recorte en E-3.5: «todas las props visuales mapean a `data-{prop}`» leia como mandato de estampar `data-dir`, que `:dir()` no puede ver. DIVERGENCIA DECLARADA (§7): la familia `chart` no tiene prop ni provider y resuelve leyendo `getComputedStyle(node).direction`. Es el unico sitio del catalogo que hace lo que §1 prohibe. Se registra en vez de esconderse. Tres verificadores adversariales sobre el barrido; sus hallazgos, corregidos: RTL-1 estaba anunciado como guard de TODO el capitulo (solo cubre §4) · «nunca lee al padre» era absoluto y borraba la composicion sancionada en el punto de llamada · el estampado se afirmaba incondicional en un sitio y condicional en otro · las cuatro filas nuevas usaban una aplicabilidad que ni la leyenda ni `component-audit.ts` conocen. `docs:check` 0 errores sobre 564 docs. `check` 77 = la linea base. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago
dev	3097cfcb69	revert: deshacer la auditoría entera — se hizo sin leer la doctrina ... Revert de los 7 commits de la sesión del 2026-07-29/30: 352ca8bbe style(soma): formato Prettier en el test de gradient-picker 17a1f167b test(soma): chat-list e70397fca test(soma): field-langs y gradient-picker c9b83d025 docs(morfo): qué hace pública una parte + hallazgos retirados feb4a8424 test(soma): los primeros providers que no tenían red f8e35b8fd fix(morfo): el eje intent/color c39170abb fix(uix): la auditoría del sistema `4e785d32b` (stats-band, otra sesión) queda intacto — el revert lo salta. ## Por qué se revierte todo y no una parte La instrucción de partida era «audita el sistema, **para ello previamente lee toda la documentación**». No se leyó. Se auditó primero y se justificó después, y eso contaminó el conjunto, no unos commits concretos: - Tres hallazgos del informe eran FALSOS, todos de la misma forma — heurísticas de una sola vía dadas por hechas sin abrir el código: D-3 `AgentTimersPort` (el puerto sí está satisfecho por el adaptador de `defineActiveAgent`); «5 derivas de scope» (`avatar-group` / `path-trace` / `rotate-align` sí están implementados, co-locados en el directorio del padre); «29 morfos con `kind:'public'` irreal» (medía si existe `<Componente.Parte>` e ignoraba que un primitivo de API plana compone por props y snippets). - `c9b83d025` existe SÓLO para retirar esos hallazgos del commit anterior. - Los 6 tests de provider se montan sobre un `installSomaHarness` que FABRICA cuatro servicios compartidos (`dom`, `langs`, `timers`, `prefs`), violando la primera regla de propiedad de `architecture/active-uix.md`: «Only composition roots create shared services. `morfo`, `soma`, `sema`, `eidos` and components never create `dom`, `langs`, `prefs`, `format`, `clipboard` or equivalents: they receive them from `ActiveUix`.» El arranque real son tres líneas (`createActiveUix` → `setActiveUix` → `Soma.create()`) que estaban escritas. - Y se le pidieron al usuario decisiones cuya respuesta estaba en el corpus (`testing-and-tooling.md` dice que los tests de provider son convención, no guard; la regla 1 zanja el arnés). Triar qué conservar exigía justo el juicio que falló. Se revierte todo, se lee el corpus, y vuelve sólo lo que se pueda sostener citando un documento — o lo que sea defecto MEDIBLE y por tanto no dependa de criterio (el colapso de uniones de props, que hacía compilar `<Avatar color="nonsense">`; que `translations:check` crashease en cada ejecución de su historia). Nada se pierde: los commits siguen en la historia y se recuperan con `cherry-pick`. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago
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	b55ca6eecb	fix(cleanroom): F2+F3+F4-C+SEM-4s1 — lote mecánico, censos con guard, corpus documental y el close polimórfico de los pickers VIVO ... F2 — lote mecánico (13 ítems): - DEP-2 ogl eliminado (0 imports) · DEP-1 clsx inlineado como toClassString propio + suite de contrato (props.test.ts; soma.md §12 cerrado). - THM-7: los 5 selectores manuales de sema.md reescritos con semaSelector (los ejemplos [data-toast-root] apuntaban a un part INEXISTENTE — la deriva que el builder previene, demostrada en el propio doc). - MOR-1 escape isomorfo + validación de attr-names en semaSelector + 9 tests (selectors.test.ts, matches() real con comillas/corchetes) · MOR-2 partMarkerAttr = única fuente compilador↔builder + test de paridad · MOR-3 _resetCompileCache borrado (0 usos). - SOM-2 keydown continue en match sin handler + keyboardFixtureMorfo · SOM-1 no-await de handlers (censo async = 0; contrato V1 cumplido) + pin. - SEM-2 trigger pre-attacha catch con logger (void trigger sin unhandled rejection; throw intacto para awaiters) + pin · SEM-3 fallback muerto de applyDominance → skip defensivo + timer tope de awaitExpression cancelado · SEC-1 adjudicado YA implementado (assertCssVariableValue desde 2026-05-11) + pin del path de VALOR. - accordion → outline (§32; su outline:none dejaba CERO anillo en HCM) — verificado en vivo · THM-6 radius-full 9999px · EID-4 recuentos 33. F3 — censos con guard: - SOM-3 cerrado: announcer + image-provider migrados a scheduler-preferred (consumidores cableados: date/time-field vía soma.uix.timers; avatar/image vía eidos.timers — verificado en vivo); guard de timers ENSANCHADO de soma/components a TODO soma y pasado a EVIDENCIA (setTimeout exige .schedule( en el fichero — layers/ y datetime/ escapaban del ámbito viejo). - THM-5: R-4.7 nueva (válvula same-line /* important: <razón> */, escaneo comment-blanked) + las 15 declaraciones anotadas con su razón + canon recipe-contract §3/§4. - SOM-4 adjudicado: el censo/guard YA existían (49 pins); knob/mask-field/ timeline pinneados (overrides documentados en call-site); media-player Batch-4 (35 hits, cero renderProps) = único batch restante, registrado. - THM-4 doctrinado en eidos.md §unused (comportamiento/composición = legítimo; deuda = eje visual sin consumidor; hotspots por lotes). F4-C — corpus documental (decisiones de usuario aplicadas): - DOC-3: los 15 enlaces muertos resueltos (repoint a la edición FINAL trackeada / des-link históricos) · docs:check I6-links WARN→ERROR. - DOC-1: tabla «Build contract» MIGRADA a component-guide con estados modernizados (A3–A5 → LIVE + guards de hoy); banners reapuntados; citas de CANON/sema.md historificadas; lápida-redirect en el §13 del fósil. - DOC-4: hold chain → holds.ts · FAQ event:* SUPERSEDED por signatures · gradient añadido a los DOS capstones (sextet real) · nota de paleta de demo-authoring corregida (universalPaletteDecls + decisión THM-2 = mecanismo universal como sucesor del tracker borrado). - DOC-5/6: recuentos anti-frágiles datados · §4.11 dup → §4.12 · Known gaps historificado · N-6/N-7 recuperadas de git (d68d2c45^) y canonizadas en eidos.md §pickers · authoring E2 → canon/tsc.md · air-old des-linkado · EID-3 (placement) en la fila RTL · AUX-2 disabledDom documentado. SEM-4 sesión 1 — el close polimórfico de los pickers, VIVO (D.11): - Reconciliación: los morfos ya no declaran close (delegated al Popover, de-dialoged 06-27); el agujero real era el cierre programático bypaseando dismissWith → save/cancel/select eran perceptualmente SILENCIOSOS. - Fix: PickerShellHandle.setPopoverDismiss + closeWith(cause) en los 5 providers (14 sitios; select/commit → 'save' = commit.save+fulfill, cancel → 'cancel' = emerge; fallback raw para headless) + UN inyector en el eidos PickerShell root (norma N-8). Picker genérico fuera a propósito (ya suena commit-set/cancel por diseño S9). - Verificado en vivo (date-picker): Done → close·commit·fulfill·active · Cancel → close·emerge · cierre real. Gates: matriz 141/141 (los 6 morfos nuevos de la pista de texto paralela también PASS) · contracts 38/38 · eidos 314 · sema 178 · morfo 94 · docs:check 0/0 con I6 en error · baseline propio 57. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	0ca2495468	docs(soma,stumbles): S6 authoring notes; STUMBLES #9 resolved (8/9 closed) ... Adds a '### Authoring notes' subsection to soma.md §6 grounded in the real defs — state<T>() vs $state, role optionality on a Provider, Without<>/ PrimitiveDivAttributes, and gesture pointermove/up ownership. Closes STUMBLES #9; only #7 (soma->eidos CSS-var contract, design-open) remains. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	3 months ago
dev	d0f41fb21a	refactor(libs): own port of runed + tabbable — drop 2 runtime deps (F1+F2) ... Removes the two runtime dependencies that broke the "framework depends on nobody" doctrine, porting them into our own code (same move as floating-ui -> $ethereal). F1 (dropped the deps): - tabbable -> src/libs/dom/tabbable-core.ts (getComputedStyle/CSS.escape resolved from the node's own window, iframe-safe); consumed by the existing tabbable.ts wrapper and surfaced via $adom. - runed Context + watch/watch.pre/watchOnce -> $libs/reactive. - runed ElementSize -> $adom/element-size.svelte.ts, rebuilt window-correct on the node's own window (not defaultWindow). - Rewired ~33 watch + 3 Context imports; floating (ElementSize) and focus-scope (tabbable) now consume $adom. F2 (rest of the pure reactive runes -> $libs/reactive): - Previous, IsMounted, onCleanup, interval, debounce/Debounced, throttle/Throttled, StateHistory, FiniteStateMachine, resource. - Dropped runed's React-style use* prefix; reused framework toValue (=extract) + MaybeActiveOrGetter; added Setter<T>. runed + tabbable removed from package.json. `npm run check` = 59 (baseline, 0 in ported files); tests unchanged (pre-existing failures only). F3 (remaining DOM-reactive runes -> $adom on ActiveDom, + PersistedState -> $storage) is pending: see docs/process/continue-runed-tabbable-port.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	3 months ago
dev	0588644a71	docs(book): F7.5 (1/2) — checklist + audit guide + demo guide moved to docs/guides/ ... Three English guides moved verbatim (copy + link touch-ups, no translation): COMPONENT_COMPLETION_CHECKLIST -> guides/ completion-checklist.md, COMPONENT_AUDIT_GUIDE -> guides/ component-audit.md, DEMO_AUTHORING_GUIDE -> guides/demo-authoring.md. Tooling moved with its doc in the same pass: docs-check I5 now parses the checklist at the new path (verified: 0 errors, rule tables found) and component-audit.ts's two path strings updated. One reconciliation in the audit guide's s5, applied as link-don't-copy: the copied v1 6-tab template list (stale vs the v2 9-tab guide it links, drawer canary vs button) is replaced by a pointer to demo-authoring.md; the domain canaries in s7 stay. demo-authoring's harness links now reach into web/routes/uix/lib/ (the modules stay with the code); the deleted pendiente_color_demos.md reference is marked TODO(reconcile). Corpus swept: building-a-component (frontmatter related: + phases 6/8), authoring, architecture/soma, theming/reference s5-parity, testing-and-tooling, getting-started, README (E4 rows + component-audit row added + two stale F7.3 paths in 'I want to' fixed). Remaining warns = links to component-guide.md, which lands in F7.5 (2/2). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	1a710c12ff	docs(book): F7.2 (7/7) — soma-architecture chapter translated; architecture/ batch COMPLETE ... src/uix/soma/SOMA_ARCHITECTURE.md (1058 L, Spanish) translated to English as docs/architecture/soma-architecture.md, same s1-s17 numbering: layer architecture, design principles, the closed six-piece model + SomaRuntime, component model (picker composition), runtime parts, the layers inventory, the Soma class + date/time domain + statics convention, the reactive system, internal helpers, data-* contracts, IDs, barrels, boundaries, directory structure, anti-patterns, current shape, stability rule, checklist. The frozen per-provider test list (dated 2026-05-15, ~140 L) became the timeless fact: the NO_MISSING_PROVIDER_TESTS guard + the test tree ARE the coverage inventory (testing-and-tooling aligned). Stub with the full sN map at the old path; corpus links swept. F7.2 is complete: docs/architecture/ now holds the whole E1 stratum in English (7 chapters, ~5.4k lines), with thin stubs + sN maps next to the code. docs:check 0 errors (251 docs). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	e941bd2a7f	docs(book): F7.2 (3/6) — soma chapter translated to docs/architecture/soma.md ... src/uix/soma/README.md (405 L, Spanish) translated to English: purpose, membership criteria, dependencies (incl. the clsx phantom-dep note), morfo consumption, provider/wrapper pattern, composition + context rules, eidos relationship, inventory doctrine. Thin stub at the old path; corpus links swept (docs map, glossary, building-a-component s0, overview). docs:check 0 errors. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago