|
|
# AUDIT — contradicciones docs↔código: registro de defectos (ledger)
|
|
|
|
|
|
> **Fuente única del estado de los defectos que salieron del barrido
|
|
|
> docs↔morfo del 2026-08-11.** Hasta hoy vivían sólo en la memoria de la
|
|
|
> sesión que los encontró, que es una superficie de recuerdo del agente y no
|
|
|
> del proyecto: un handoff que no se carga los pierde. Este fichero es la casa.
|
|
|
|
|
|
## Por qué existe este fichero
|
|
|
|
|
|
El 2026-08-11 un barrido de alta precisión sacó **101 contradicciones** entre la
|
|
|
documentación y el morfo. La instrucción inicial fue «borra toda la basura», y
|
|
|
fue corregida en el acto: _«puede ser que la documentación esté desfasada o que
|
|
|
el código esté obsoleto, hay que evaluar primero cuál es el caso»_. Sin esa
|
|
|
corrección los 101 hallazgos se habrían aplanado contra el morfo y **habría
|
|
|
desaparecido la única huella de nueve averías reales**.
|
|
|
|
|
|
De ahí el veredicto por sitio, con evidencia (`git log -S`, docs de decisión, el
|
|
|
componente vivo):
|
|
|
|
|
|
- **DOC-DESFASADA** — la documentación miente sobre código correcto → se arregla.
|
|
|
- **CÓDIGO-OBSOLETO** — el código miente sobre documentación correcta → **se
|
|
|
reporta, no se toca**. Son las filas de abajo.
|
|
|
- **FALSO-POSITIVO** — el script se equivocó.
|
|
|
|
|
|
⚠️ Aun con la instrucción explícita, **dos agentes borraron filas de «Gaps» que
|
|
|
documentaban un defecto abierto**. Repuestas a mano. La lección es la regla 3.
|
|
|
|
|
|
## Las reglas de este registro
|
|
|
|
|
|
1. **Se escribe por `id`.** `D1`…`D14` no se renumeran nunca. Un defecto que
|
|
|
resulta ser dos se parte en `D3a`/`D3b`, no desplaza a los siguientes.
|
|
|
2. **Un `ARREGLADO` lleva su commit.** Sin sha no es un arreglo, es una opinión.
|
|
|
3. **Una fila de gap o de known issue NUNCA es basura**, aunque cite nombres
|
|
|
muertos: es la huella de una avería. Borrarla es borrar el defecto, no
|
|
|
arreglarlo.
|
|
|
4. **«No lo referencia nadie» no es un veredicto.** Es una observación. Antes de
|
|
|
proponer retirar algo hay que abrir TODOS los hits de `docs/` que lo nombren
|
|
|
— `D10` nació precisamente de saltarse esto.
|
|
|
|
|
|
Estados: `CONFIRMADO` (medido, abierto) · `ARREGLADO` (con sha) ·
|
|
|
`PENDIENTE` (sin re-medir) · `DIFERIDO` (confirmado, disposición firmada).
|
|
|
|
|
|
## La tabla
|
|
|
|
|
|
| id | Componente | Estado | Prioridad | Una línea |
|
|
|
| --- | --------------------------- | -------------------------------------- | --------- | -------------------------------------------------------------------------------------------------------- |
|
|
|
| D1 | AlertDialog | `ARREGLADO` `f4e414e2e` | P0 | Action y Cancel cerraban sin causa: mudos |
|
|
|
| D2 | Splitter (eidos) | `ARREGLADO` `6f42eebfe` | P0 | regla CSS enganchada a un evento renombrado en mayo |
|
|
|
| D3 | 5 pickers | `ARREGLADO` `f4e414e2e` | P0 | `commit-reset` declarado y jamás disparado |
|
|
|
| D4 | ColorPicker | `ARREGLADO` `f4e414e2e` | P0 | swatch y eyedropper commitean en silencio |
|
|
|
| D5 | los 5 pickers | `ARREGLADO` | P1 | en `modal`, un cierre que no declara causa es un descarte, y un descarte no commitea |
|
|
|
| D6 | date/time/color-field | `ARREGLADO` | P1 | `Home`/`End` en la familia de segmentos, con una sola acción declarada |
|
|
|
| D7 | 5 componentes de campo | `ARREGLADO` | P1 | el Label renderizaba `<div>` y el morfo declara `label` |
|
|
|
| D8 | los 7 `arrow` | `ARREGLADO` | P2 | `defaultElement` falso en el `arrow` — sistémico, confirmado |
|
|
|
| D9 | chronos | `ARREGLADO` | P2 | el acarreo habla: `handle-drag` y `handle-resize`, anclados y a la cadencia del gesto |
|
|
|
| D10 | sema ↔ `$sound` | `ARREGLADO` (2026-08-12, desde el eje) | P1 | los 3 resolvers de gesto RETIRADOS por la sesión del eje de sonido, con los 8 sitios rancios adjudicados |
|
|
|
| D11 | catálogo | `ARREGLADO` | P1 | `defaultElement` mentía en 28 partes; las 28 dicen ya la verdad y el guard no tiene excepciones |
|
|
|
| D12 | context-menu · link-preview | `ARREGLADO` | P2 | sus flechas componen ya la primitiva compartida: una flecha, una forma |
|
|
|
| D13 | 4 componentes | `CONFIRMADO` | P1 | 7 eventos declarados que nadie emite — enumerados y guardados |
|
|
|
| D14 | chronos | `CONFIRMADO` | P1 | `restoreChipFocus` pierde el foco: el movimiento por teclado muere al primer paso |
|
|
|
|
|
|
---
|
|
|
|
|
|
## Fichas
|
|
|
|
|
|
### D1 · AlertDialog mudo — `ARREGLADO` (`f4e414e2e`)
|
|
|
|
|
|
Action y Cancel llamaban `dialog.handleClose()`, que sólo voltea `open`: nunca
|
|
|
pasaban por `dismissWith` ni disparaban `emerge-close`. Medido: sólo sellaba
|
|
|
`contact-activate`. Escape sí funcionaba, así que **el teclado tenía firma y los
|
|
|
botones no**.
|
|
|
|
|
|
Arreglo: Action llama `dismissWith('save', { intent })` y Cancel
|
|
|
`dismissWith('cancel')`. `dismissWith` gana un `opts.intent` porque la causa es
|
|
|
vocabulario cerrado pero el PESO es por instancia — el mismo eje por el que
|
|
|
`emerge-open` liga con `fromProp`. Medido: Action → commit/risk/saved, Cancel →
|
|
|
emerge/cancelled.
|
|
|
|
|
|
### D2 · Regla CSS muerta del splitter — `ARREGLADO` (`6f42eebfe`)
|
|
|
|
|
|
`splitter.css` enganchaba `data-event='commit-resize'`, evento renombrado a
|
|
|
`commit-set` en `bd2e40366` (2026-05-22). No se arreglaba renombrando: el
|
|
|
`commit-set` de hoy apunta al `provider`, no al trigger.
|
|
|
|
|
|
Arreglo: la regla engancha por familia sobre el provider
|
|
|
(`[data-event-family='commit'][data-event-phase='active']`) y pinta el trigger
|
|
|
con **selector descendente**, más un opt-out del anillo global de commit. La
|
|
|
firma que pinta otro nodo es un selector descendente — no una razón para mover
|
|
|
el sello (doctrina en `docs/architecture/eidos.md` §«descendant-selector
|
|
|
corollary»).
|
|
|
|
|
|
### D3 · `commit-reset` mudo en 5 pickers — `ARREGLADO` (`f4e414e2e`)
|
|
|
|
|
|
Declarado en date / time / date-range / time-range / color y jamás disparado:
|
|
|
`clear()` sólo asignaba.
|
|
|
|
|
|
Al arreglarlo salió **una segunda avería debajo**: date-picker y
|
|
|
date-range-picker apuntaban `commit-reset` a la parte `calendar`, que nadie
|
|
|
registra en el runtime — destino inalcanzable, emit rechazado en silencio.
|
|
|
Retargeteados al `provider`.
|
|
|
|
|
|
⚠️ **Una parte declarada sin registro en runtime es un destino inalcanzable, y
|
|
|
no chilla.** Vale para todo el catálogo, no sólo para estos dos.
|
|
|
|
|
|
### D4 · ColorPicker commitea en silencio — `ARREGLADO` (`f4e414e2e`)
|
|
|
|
|
|
Swatch y eyedropper aplican el color sin disparar nada, pese a que el morfo **y**
|
|
|
el pack de sema declaran que disparan `commit-set`.
|
|
|
|
|
|
### D5 · Escape en `modal` cierra sin revertir — `ARREGLADO` (2026-08-12)
|
|
|
|
|
|
⚠️ **Dos afirmaciones de esta fila eran falsas y se corrigen aquí.**
|
|
|
|
|
|
1. _«`mode='modal'` promete bloquear Escape»_ — la promesa existía sólo en
|
|
|
[`picker-shell-handle.svelte.ts:32`](../../src/uix/soma/components/picker-shell/picker-shell-handle.svelte.ts)
|
|
|
y en un comentario de `date-picker.svelte`. **Era doc rancia**: el 2026-08-11
|
|
|
se adjudicó lo contrario en tres pickers, con razón escrita
|
|
|
([`time-picker/types.ts:42`](../../src/uix/soma/components/time-picker/types.ts)):
|
|
|
Escape descarta en AMBOS modos porque el morfo declara el patrón APG
|
|
|
`combobox` y el framework bloquea Escape en exactamente un sitio,
|
|
|
`alertdialog`; tragárselo dejaría a un usuario de teclado sin salida salvo
|
|
|
que el consumidor recordara componer un Cancel. La adjudicación no se propagó
|
|
|
al handle compartido ni a date-picker / date-range-picker. **Propagada el
|
|
|
2026-08-12.**
|
|
|
2. _«No hay buffer»_ — sí lo hay:
|
|
|
[`date-picker-provider.svelte.ts:153`](../../src/uix/soma/components/date-picker/date-picker-provider.svelte.ts)
|
|
|
captura `valueOnOpen` en la arista de apertura y `cancel()` (:262) lo
|
|
|
restaura.
|
|
|
|
|
|
**Lo que sí es un defecto, medido en navegador el 2026-08-12** (date-picker en
|
|
|
`mode='modal'`): el popover no autocierra al elegir ✓, pero Escape **cierra y se
|
|
|
queda la edición** (05/20 → 05/10). Es un tercer camino de salida que se comporta
|
|
|
como Save, y el contrato documentado del modo sólo tiene dos: Save confirma,
|
|
|
Cancel revierte.
|
|
|
|
|
|
La causa está a la vista: `PickerCloseCause` es `'save' | 'cancel' | 'dismiss'`
|
|
|
([`picker-shell-handle.svelte.ts:28`](../../src/uix/soma/components/picker-shell/picker-shell-handle.svelte.ts))
|
|
|
y **`'dismiss'` no lo produce nadie** — misma clase que D1/D3/D4. Escape cierra
|
|
|
por la vía del Popover sin pasar por `closeWith`, así que ni sella causa ni
|
|
|
revierte. Ningún picker cablea `escapeKeydownBehavior`: los cinco se comportan
|
|
|
igual.
|
|
|
|
|
|
**ARREGLADO 2026-08-12** — y con una tercera corrección de la fila: _«`'dismiss'`
|
|
|
no lo produce nadie»_ también era falso. Lo produce el **Popover**
|
|
|
(`dismissWith('dismiss')` en su manejador de Escape), no el picker; por eso el
|
|
|
picker nunca se enteraba. Grepear sólo el directorio del picker lo escondió.
|
|
|
|
|
|
El arreglo **no intercepta la tecla**, que sería frágil y estaría en la capa
|
|
|
equivocada (el `Content` es el del Popover, y su gancho de Escape es prop del
|
|
|
consumidor). Vigila la **arista de cierre**: un cierre que no declara causa es un
|
|
|
descarte, y en `modal` un descarte revierte al valor con el que se abrió. Eso
|
|
|
cubre además a un consumidor que baje `open` a mano, que tampoco es un Save. En
|
|
|
`inline` no revierte nada — allí la selección se aplicó según se hacía y el
|
|
|
snapshot sólo sirve para `cancel()`.
|
|
|
|
|
|
Vive una vez, en `watchPickerDismiss` (`picker-shell-handle.svelte.ts`), y los
|
|
|
cinco pickers lo consumen: eran cinco copias del mismo `watch` sobre `open`. El
|
|
|
provider declara su causa desde `closeWith`, así que `commit()` y `cancel()`
|
|
|
pasan intactos.
|
|
|
|
|
|
Medido en navegador (date / time / color-picker en `modal`): se edita, Escape
|
|
|
cierra el popover Y el valor vuelve al de apertura. ⚠️ La primera medición dijo
|
|
|
«Escape BLOQUEADO» — era la sonda leyendo a 400 ms, en plena animación de salida;
|
|
|
la traza temporal muestra el popover aún presente a +200 ms y ya cerrado, con el
|
|
|
valor revertido, a +600 ms.
|
|
|
|
|
|
Cinco tests sobre el guard compartido (`picker-shell-handle.svelte.test.ts`),
|
|
|
**vistos fallar** desactivando la reversión. ⚠️ Los tres primeros pasaban _en
|
|
|
vacío_ hasta que se les añadió `flushSync`: `watch` no ve una transición si las
|
|
|
tres escrituras caen en el mismo tick, así que no observaba ninguna arista.
|
|
|
|
|
|
### D6 · `Home` / `End` en la familia de segmentos — `CONFIRMADO` · P1
|
|
|
|
|
|
⚠️ **Otra fila con dos afirmaciones falsas.** Decía «`Home`/`End`/`PageUp`/
|
|
|
`PageDown` documentados en 4 sitios» y «las tres páginas se contradicen sobre qué
|
|
|
harían». `PageUp`/`PageDown` **no aparecen en ninguna parte**, y las tres
|
|
|
auditorías **coinciden** — no se contradicen:
|
|
|
|
|
|
| Documento | Qué especifica |
|
|
|
| --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
|
| [`audit/components/date-field.md`](../audit/components/date-field.md) F-1 | `{ key: 'Home', action: 'set-min' }` / `{ key: 'End', action: 'set-max' }` en el morfo + implementación en provider, «extensivo a time-field/color-field (misma familia de segmentos)» |
|
|
|
| [`audit/components/time-field.md`](../audit/components/time-field.md) F-2 | «Sin Home/End (APG spinbutton) — pass de familia de segmentos (con date/color)» |
|
|
|
| [`audit/components/color-field.md`](../audit/components/color-field.md) F-2 | «especialmente útil aquí: canales 0-255/0-360 — pass de familia» |
|
|
|
|
|
|
No era una decisión sin tomar: era una **especificación acordada sin construir**,
|
|
|
con la declaración del morfo escrita literalmente en F-1.
|
|
|
|
|
|
**Hecho el 2026-08-12** — y con una tercera corrección de la fila: **color-field
|
|
|
YA lo tenía implementado** (`handleHomeEnd`, desde que se construyó). Su F-2
|
|
|
estaba desfasada. Así que el pase no inventó la conducta: copió la referencia que
|
|
|
ya vivía en el árbol, a date-field y time-field, incluidos sus segmentos
|
|
|
`dayPeriod` (donde `aria-valuemin` es AM y `aria-valuemax` es PM, así que Home /
|
|
|
End son absolutos donde las flechas ALTERNAN).
|
|
|
|
|
|
**Una sola acción declarada.** F-1 proponía `set-min` / `set-max`; color-field
|
|
|
declaraba `first-item` / `last-item`. El tipo obliga a elegir —
|
|
|
_«Semantic action identifier. Keep consistent across components for the same
|
|
|
intent»_— y el catálogo tiene dos vocabularios: el de LISTA (`first-item`, 25
|
|
|
usos, y `menu-dial` lo consume por el mapa de acciones del runtime) y el de VALOR
|
|
|
(`set-min`, que usa `knob`). Un segmento es un control de valor y no tiene ítems,
|
|
|
así que los tres declaran `set-min` / `set-max` y color-field se alineó. Sin
|
|
|
riesgo: los segmentos despachan por tecla, no por el mapa del runtime.
|
|
|
|
|
|
Medido con teclado real en el navegador, y los valores caen exactamente en el
|
|
|
aria que cada segmento publica: date-field mes `End→12 / Home→01` (min/max 1/12),
|
|
|
time-field hora `End→23 / Home→00` (0/23), color-field hex `End→ffffff /
|
|
|
Home→000000` (0/16777215). Home dos veces no envuelve.
|
|
|
|
|
|
Seis tests nuevos, **los seis vistos fallar** contra la conducta vieja
|
|
|
(inyectando el cierre del gate compartido y la retirada de cada rama). Incluido
|
|
|
uno para color-field, que era la referencia y **no tenía ninguno**.
|
|
|
|
|
|
### D7 · El Label de los campos renderizaba `<div>` — `ARREGLADO` (2026-08-12)
|
|
|
|
|
|
El morfo declara `defaultElement: 'label'` y el componente renderizaba `<div>`.
|
|
|
No eran dos componentes sino **cinco**: date-field, date-range-field, time-field,
|
|
|
time-range-field y color-picker.
|
|
|
|
|
|
⚠️ **La otra mitad de esta fila era falsa.** Decía «la doc promete un par
|
|
|
`for`/`id` que nadie emite»; no existe tal promesa en date-field —
|
|
|
[`types.ts:158`](../../src/uix/soma/components/date-field/types.ts) dice lo
|
|
|
contrario y bien: _«Prefer `aria-labelledby` with a `DateField.Label`»_. La fila
|
|
|
había mezclado el hallazgo del **`Field` genérico** (`field.md:19`, que sí emite
|
|
|
`for` condicional) con el date-field. El nombre accesible ya estaba cableado por
|
|
|
`aria-labelledby` desde el `role="group"` — que es el mecanismo correcto, porque
|
|
|
`for=` no puede apuntar a un grupo — y el clic-a-enfocar ya lo implementaba
|
|
|
`DateFieldLabelProvider.onclick` (enfoca el primer segmento).
|
|
|
|
|
|
Riesgo comprobado antes de tocar, no supuesto: `<label>` es `inline` por defecto
|
|
|
y `<div>` es `block`. Dos de los cinco reciben `display: inline-flex` de
|
|
|
`field.css` vía `fieldRole('label')`; los otros tres son ítems de flex o grid, y
|
|
|
el navegador los blockifica. Medido después en los cinco demos: ninguno queda en
|
|
|
`inline`, ninguno arrastra un `for` que no pueda honrar, y la maquetación no se
|
|
|
mueve.
|
|
|
|
|
|
### D8 · `defaultElement` falso en los `arrow` — `ARREGLADO` (2026-08-12)
|
|
|
|
|
|
La sospecha de deuda sistémica era cierta y peor de lo escrito: **los siete
|
|
|
`arrow` del catálogo declaraban `div` y ninguno renderiza un `div`.** Cinco
|
|
|
(combobox, dropdown-menu, popover, select, tooltip) componen
|
|
|
[`components/internal/arrow.svelte`](../../src/uix/soma/components/internal/arrow.svelte),
|
|
|
cuyo elemento de parte es un `<span>`; dos (context-menu, link-preview) rinden un
|
|
|
`<svg>` propio. Cada morfo declara ahora lo que su componente renderiza.
|
|
|
|
|
|
### D11 · `defaultElement` miente en 24 partes más — `CONFIRMADO` · P1
|
|
|
|
|
|
El censo que cerró D8 destapó la clase entera: **nada verificaba
|
|
|
`defaultElement`**, y es un contrato — `assertContract`, las recetas y quien lee
|
|
|
el morfo lo toman como el tag que aterriza en el DOM.
|
|
|
|
|
|
Hay un guard desde el 2026-08-12
|
|
|
([`contracts.test.ts`](../../src/uix/contracts.test.ts), «guards defaultElement
|
|
|
against the tag the soma part actually renders»), con las 24 restantes
|
|
|
enumeradas en `DEFAULT_ELEMENT_DEBT` para que la deuda sea visible y no crezca.
|
|
|
El guard lleva además un detector anti-podredumbre: si una entrada de la lista
|
|
|
deja de estar rota, falla pidiendo que se retire.
|
|
|
|
|
|
**Cerradas 24 de 28 el 2026-08-12** (eran 28, no 24: mi cifra anterior estaba
|
|
|
mal). Dieciséis eran el morfo yendo detrás de un componente que ya renderiza lo
|
|
|
más correcto — edición de declaración, el DOM no se mueve. Ocho más parecían del
|
|
|
grupo contrario y no lo eran: declaran un `role` explícito que carga la semántica
|
|
|
que daría el elemento nativo (`role='list'`, `listitem'`, `treeitem'`, `group'`,
|
|
|
`article'`, `tablist'`) o son decorativas (`aria-hidden`). Ahí la a11y **no está
|
|
|
rota** y la declaración era aspiracional; cambiar el DOM a listas nativas es una
|
|
|
mejora deliberada aparte, no algo que colar en un pase de verdad-del-contrato.
|
|
|
|
|
|
**Las 4 últimas, cerradas el mismo día.** Cada una pedía un cambio con
|
|
|
consecuencias, y la lección es que la pregunta «¿qué lado está mal?» sólo se
|
|
|
contesta mirando:
|
|
|
|
|
|
- `chronos.event-chip` — **el morfo tenía razón**, con el motivo escrito desde el
|
|
|
2026-08-10: el chip CONTIENE el tirador de redimensionado y el modelo de
|
|
|
contenido de un `<button>` no admite un control anidado, así que es `div` +
|
|
|
`role='button'`. Lo que faltaba era el puente: el «`tabindex` propiedad de soma»
|
|
|
que ese comentario promete no existía. Ahora el provider emite `tabindex: 0` y
|
|
|
un `onkeydown` que convierte Enter / Espacio en un clic (con `preventDefault`
|
|
|
sobre el espacio, que si no desplaza la página), y el componente puede ser el
|
|
|
`div` que su contrato declara.
|
|
|
- `tooltip.trigger` — **probé el morfo y me equivoqué; la medición lo corrigió.**
|
|
|
Declaraba `button`, así que rendericé un `<button>`… y la captura mostró el
|
|
|
cromado nativo alrededor del disparador. La receta llama a esta parte _«a
|
|
|
focusable shell»_ y difiere el anillo de foco _«to the wrapped element»_: es un
|
|
|
ENVOLTORIO, el control real del consumidor va dentro, y un `<button>` que
|
|
|
envuelve un `<button>` es el mismo anidamiento inválido del chip. El morfo era
|
|
|
el lado equivocado; declara `div`, y la a11y la dan el `tabindex: 0` del
|
|
|
provider y el `aria-describedby` del morfo, que es lo que el patrón APG pide.
|
|
|
- `stepper.item` — un `div` **sin rol** dentro de un `role='tablist'`. El patrón
|
|
|
es `list (tablist) > item > trigger (tab)`, y un elemento genérico entre un
|
|
|
tablist y sus tabs rompe la relación de posesión. Es `role='presentation'`
|
|
|
ahora — el envoltorio sale del árbol, igual que un `<li>` dentro de un
|
|
|
`role='menu'`; el idioma ya estaba en 8 componentes del catálogo.
|
|
|
- `color-picker.channel-input` — declaraba `input` mientras compone
|
|
|
`ColorField.Input`, que es `div` + `role='group'` (el contenedor de segmentos,
|
|
|
la misma forma que el `input` de date-field). Ninguna composición podía
|
|
|
satisfacer esa declaración: las piezas editables son las partes hermanas
|
|
|
`channel-segment`.
|
|
|
|
|
|
`DEFAULT_ELEMENT_DEBT` está **vacío**, y su comentario explica que una entrada
|
|
|
nueva es la decisión de publicar un contrato que miente.
|
|
|
|
|
|
Las 24 se partieron en dos, y por eso no se arreglaron en bloque:
|
|
|
|
|
|
- **El componente renderiza lo más correcto y el morfo va detrás** —
|
|
|
`calendar.header` / `range-calendar.header` (`header`), `field.helper-text` /
|
|
|
`field.error-text` (`p`), los cuatro de `slider` (`span`), `chronos.event-chip`
|
|
|
(`button`)… Arreglo mecánico: poner al día el morfo.
|
|
|
- **El morfo declara lo más correcto y el componente va detrás, con peso de
|
|
|
a11y** — `tree-view.item` / `.branch` declaran `li` y rinden `div`,
|
|
|
`tree-view.branch-content` declara `ul`, `stepper.list` declara `ol`,
|
|
|
`file-upload.file-list` declara `ul`, `feed.article` declara `article`,
|
|
|
`tooltip.trigger` declara `button`. Rendirlos como `div` pierde la semántica
|
|
|
de lista / landmark / control que APG espera. **Son decisiones, no ediciones.**
|
|
|
|
|
|
⚠️ Notas de método, por si alguien reescribe el guard: (1) el elemento de la
|
|
|
parte es **el que difunde los props**, no «el tag del último `{:else}`» — el
|
|
|
primer borrador usó lo segundo y se fue en FALSO VERDE, porque el `<svg>`
|
|
|
decorativo de `internal/arrow.svelte` no lleva spread; se descubrió inyectando
|
|
|
una regresión antes de fiarse. (2) Hay partes **polimórficas por diseño**
|
|
|
(`media-player.media` rinde `audio` o `video`, `breadcrumb.link` `span` o `a`):
|
|
|
el guard lee TODAS las ramas y da el contrato por bueno si el declarado está
|
|
|
entre ellas.
|
|
|
|
|
|
### D12 · Dos flechas se dibujan distinto que las otras cinco — `CONFIRMADO` · P2
|
|
|
|
|
|
Salió al censar D8. `internal/arrow.svelte` dibuja `<polygon>` **más** un
|
|
|
`<path>` de contorno trazado; las flechas propias de
|
|
|
[`context-menu`](../../src/uix/soma/components/context-menu/components/context-menu-arrow.svelte)
|
|
|
y [`link-preview`](../../src/uix/soma/components/link-preview/components/link-preview-arrow.svelte)
|
|
|
dibujan sólo el polígono. Dos de siete flechas del sistema no tienen contorno.
|
|
|
|
|
|
**ARREGLADO 2026-08-12**: las dos componen ya la primitiva compartida, así que
|
|
|
las siete flechas del sistema son el mismo `<span>` con el mismo `<svg>`, y las
|
|
|
siete declaran `span`. Las recetas pasan a direccionar las formas por dentro
|
|
|
(`polygon { fill }`, `path { stroke }` con `vector-effect: non-scaling-stroke`),
|
|
|
porque un `fill` sobre el envoltorio no puede pisar los atributos de presentación
|
|
|
que polígono y path llevan encima.
|
|
|
|
|
|
⚠️ **Y el arreglo destapó otro defecto por el camino.** Al componer la primitiva,
|
|
|
la flecha desapareció: `<span>` de 0×0 y sin `<svg>` dentro. Causa: los wrappers
|
|
|
de eidos de estos dos pasaban `{@render children?.()}` **incondicionalmente**, y
|
|
|
la primitiva lee CUALQUIER snippet de children como «el consumidor trae su propio
|
|
|
glifo» y se salta el suyo. popover y tooltip no pasan children en absoluto, por
|
|
|
eso nunca les pasó. Los dos wrappers son condicionales ahora — es la regla
|
|
|
«eidos wrappers need conditional children», reaprendida midiendo.
|
|
|
|
|
|
Medido tras el cambio: context-menu y link-preview dan `<span>` 10×5 con `<svg>`
|
|
|
10×5, polígono relleno y `<path>` con trazo — idénticos a tooltip, que es el
|
|
|
control. Antes link-preview no tenía `<path>` **ninguno**. Consola limpia.
|
|
|
|
|
|
### D9 · Eventos de chronos sin emisor — `CONFIRMADO` · P2
|
|
|
|
|
|
El morfo de chronos declara `handle-drag`
|
|
|
([`chronos.ts:131`](../../src/uix/morfo/components/chronos.ts)) y `handle-resize`
|
|
|
(:141), y **ningún provider los dispara**: el barrido de `trigger(` en
|
|
|
`soma/components/chronos/` da `shift-navigate`, `commit-restore`, `commit-apply`
|
|
|
y el trío `commit-save`/`commit-move`/`commit-delete` de `emitOnChip`. El
|
|
|
arrastre y el redimensionado emiten su `commit-move`, nunca la familia `handle`
|
|
|
que declaran. Ya declarado como S-37 en el README de chronos.
|
|
|
|
|
|
⚠️ Corrección de método, 2026-08-12: la primera lectura de esta fila dio «los
|
|
|
tres `commit-*` tampoco se disparan». Era falsa — se despachan **por variable**
|
|
|
en `emitOnChip` (`chronos-provider.svelte.ts:1240`), invisible a un grep de
|
|
|
`trigger('literal')`.
|
|
|
|
|
|
⚠️ Los dos documentos de chronos discrepaban: el README de soma decía que el pack
|
|
|
«ships rules» para ambos, y el SPEC que **se retiraron el 2026-08-07** por código
|
|
|
muerto. El SPEC tenía razón (el pack sólo lleva los tres `commit-*`); el README
|
|
|
quedó al día el 2026-08-12.
|
|
|
|
|
|
**ARREGLADO 2026-08-12 — se cablean.** `handle` pregunta _«¿estoy manipulando
|
|
|
directamente este objeto?»_, y una familia que no responde su propia pregunta ha
|
|
|
fallado en lo único para lo que existe ([CANON §2](../CANON.md)). Chronos es el
|
|
|
componente más manipulable del catálogo: hablaba el suelte (`commit-move`) y el
|
|
|
acarreo entero estaba mudo. El _handle invisible_.
|
|
|
|
|
|
No se autora nada: `handle` ya declara `sounds: { default: 'step' }` y los dos
|
|
|
canales en el mapa, así que el ritmo ES el sonido — un diente por emisión, a la
|
|
|
cadencia del gesto. Por eso las dos reglas del pack se retiraron el 2026-08-07
|
|
|
como código muerto: sobraba la regla, no el evento.
|
|
|
|
|
|
Estrangulado a ~14 Hz como slider y splitter, y **anclado**: los destinos son
|
|
|
`event-chip` y `event-resize-handle`, partes REPETIDAS, así que es una aplicación
|
|
|
directa de la ley de `e5811e422` (una ocurrencia con un sujeto entre muchos se
|
|
|
ancla). Chronos ya tenía el mecanismo en `emitOnChip`.
|
|
|
|
|
|
**Dónde el acarreo NO es de chronos.** Arrastrar un chip con el PUNTERO pasa por
|
|
|
el `DragDrop` compuesto, que posee ese bucle y lo expresa en `handle-pick` y
|
|
|
`handle-drop` — declara tres eventos y emite tres, sin acarreo continuo (CANON
|
|
|
regla 6: la evaluación se concentra en el drop). Añadir una tercera narración
|
|
|
encima serían dos componentes contando el mismo gesto. Así que `handle-drag` es
|
|
|
aquí el acarreo de TECLADO y `handle-resize` cubre las dos vías.
|
|
|
|
|
|
Medido: el arrastre del tirador con puntero da **6 `handle-resize` en 6 pasos**,
|
|
|
todos sobre `event-resize-handle`. El `handle-drag` sella `event-chip` a la
|
|
|
primera flecha y no más — no por el cableado, sino por **D14**.
|
|
|
|
|
|
### D10 · Los 3 resolvers de gesto: migración a medias — `CONFIRMADO` · P1
|
|
|
|
|
|
El 2026-08-06 se reescribió `dragSignalOverrides` (slider y splitter) a
|
|
|
`sound: 'step'` — el gesto pasa a sonar por REPETICIÓN — y eso dejó
|
|
|
`resolveHandleDragSound` / `resolveSliderDragSound` / `resolveSplitterDragSound`
|
|
|
sin un solo llamador. **No se adjudicó ninguno de los cinco sitios que los
|
|
|
describen como vigentes:**
|
|
|
|
|
|
| Sitio | Qué afirma |
|
|
|
| ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
|
| [`splitter-provider.svelte.ts:435`](../../src/uix/soma/components/splitter/splitter-provider.svelte.ts) | «Pitch/centroid/gain come from… `resolveSplitterDragSound`» — y `dragSignalOverrides`, 30 líneas más abajo **en el mismo fichero**, dice que eso se sustituyó |
|
|
|
| [`sema/components/splitter.ts:15`](../../src/uix/sema/components/splitter.ts) | medio cierto: soma **sí** calcula overrides por emisión, pero no por ese resolver, y «la curva dinámica sobrevive» ya sólo vale para el háptico |
|
|
|
| [`PLAN-sound-engine.md:95`](./PLAN-sound-engine.md) | §4, los tres en la columna **«sema conserva»** de la LÍNEA DE CORTE |
|
|
|
| [`PLAN-audio-player.md:367`](./PLAN-audio-player.md) | D-AP.7, **✅ CONFIRMADO**: el slider adjunta el resolver en cada `handle-drag` |
|
|
|
| [`AUDIT-sema-2026-08-05.md`](./AUDIT-sema-2026-08-05.md) hallazgo 7 | la regla del pack del slider está muda **a propósito** porque las primitivas vienen del resolver — razón hoy sin base |
|
|
|
|
|
|
El slider **no** arrastra el comentario rancio: el suyo describe bien la
|
|
|
sustitución. La contradicción interna es sólo del splitter.
|
|
|
|
|
|
**Decisión abierta del autor:** ¿se retiran los resolvers de gesto, o se
|
|
|
recablean? La tabla de corte de `PLAN-sound-engine.md` §4 hay que actualizarla
|
|
|
en los dos casos. Nada se toca hasta entonces: reescribir los comentarios para
|
|
|
decir «se sustituyó» contesta la pregunta y borra la huella (regla 3).
|
|
|
|
|
|
**RETIRADA EJECUTADA Y REVERTIDA el mismo día (2026-08-12).** El borrado se hizo
|
|
|
en `5571f3bf7` y el autor lo revirtió en el acto, con razón: **la sesión era de
|
|
|
normalizar nombres de evento, no de modificar la librería de sonido**, y la
|
|
|
retirada se ejecutó sin leer primero el handoff vivo del eje
|
|
|
([`CONTINUE-sound-engine.md`](./CONTINUE-sound-engine.md) — la memoria del
|
|
|
proyecto lo marca «PRIMERO») ni `PLAN-audio-player-v2.md` (gate firmado), que ni
|
|
|
siquiera se sabía que existía. La verificación posterior salió limpia — ninguno
|
|
|
de los seis documentos no leídos nombra los resolvers — pero salió limpia por
|
|
|
suerte, no por método. `sounds.ts` está restaurado byte a byte; **no se toca sin
|
|
|
una sesión propia del eje de sonido, que empiece por su handoff.**
|
|
|
|
|
|
**DECISIÓN FIRMADA (2026-08-12): SE RETIRAN.** La ejecuta la sesión del eje de
|
|
|
sonido — la condición procedimental de arriba queda intacta (su handoff
|
|
|
PRIMERO). Con la retirada: actualizar la tabla de corte de
|
|
|
`PLAN-sound-engine.md` §4, adjudicar los cinco sitios de la tabla, y un
|
|
|
**SEXTO** que el re-análisis del 2026-08-12 destapó:
|
|
|
`docs/architecture/sema.md` §«The per-emit payload owns the primitives» aún
|
|
|
describe el payload sonoro de la era resolver («pitch / gain / contour derived
|
|
|
from pointer position and velocity»), cuando lo que soma adjunta hoy es
|
|
|
`sound: 'step'` + curva háptica (`dragSignalOverrides` en
|
|
|
`slider-provider.svelte.ts:233` y `knob-provider.svelte.ts:242`, con el
|
|
|
trade-off del 2026-08-06 citado en el propio comentario). El homónimo
|
|
|
`SoundContour` se disuelve con ellos — nada que renombrar.
|
|
|
|
|
|
**EJECUTADA (2026-08-12, esta vez desde el eje).** Sesión abierta leyendo
|
|
|
ENTEROS `CONTINUE-sound-engine.md` + `PLAN-audio-player-v2.md` antes de tocar.
|
|
|
Retirados los 7 símbolos (3 resolvers · `DragSoundParams` · `SoundContour` de
|
|
|
sema · `clamp`/`lerp` huérfanos) + los 5 re-exports + los 2 tests que sólo se
|
|
|
probaban a sí mismos; el registro (`SEMA_SOUND_VOICE`, `sample`,
|
|
|
`resolveSoundDefinition`…) intacto. Adjudicados los seis sitios — y DOS MÁS que
|
|
|
esta ficha no listaba, hallados al leer el eje (la fila de estado de
|
|
|
`CONTINUE-sound-engine.md`, «conserva su resolver por mecanismo», y D-AP2.7 de
|
|
|
`PLAN-audio-player-v2.md`, «el resolver del drag posee las primitivas»), ambos
|
|
|
con nota fechada. El detalle: comentarios de `splitter-provider` y del pack del
|
|
|
splitter reescritos al modelo vigente · `sema.md` §per-emit payload dice ya la
|
|
|
verdad (nombre + curva háptica) · tabla de corte §4 anotada ·
|
|
|
`book-deviations.md` D.7 gana la nota de que su pasado se hizo verdad hoy ·
|
|
|
`AUDIT-sema-2026-08-05` NO se toca (crónica por cabecera propia). El homónimo
|
|
|
queda resuelto por disolución: sobrevive sólo el `SoundContour` del art (5
|
|
|
valores); los docblocks que contrastaban con el de sema (`sema/types.ts` ·
|
|
|
`arts/motion/types.ts`) apuntan ahora al del art.
|
|
|
|
|
|
El análisis de abajo se conserva porque es evidencia válida PARA esa sesión:
|
|
|
|
|
|
- [`PLAN-sound-engine.md`](./PLAN-sound-engine.md) está **CERRADO** (2026-07-30) y
|
|
|
su columna «sema conserva» miente en 4 de 5 celdas: `SOUND_LIBRARY` no existe,
|
|
|
`SOUND_TUNINGS` se retiró el 2026-08-06 (con guard que lo mantiene retirado),
|
|
|
el sonido salió de la cascada y «qué firma para qué familia × intent» lo
|
|
|
sustituyó la ley del nombre. Es un inventario, no un mandato.
|
|
|
- [`PLAN-audio-player.md`](./PLAN-audio-player.md) está **⛔ GATE RECHAZADO —
|
|
|
SUSPENDIDO**, y su cabecera dice _«nada de lo de abajo se implementa»_. Su ✅
|
|
|
CONFIRMADO es una medición del terreno del 2026-07-31, cierta entonces.
|
|
|
- La fuente que gobierna no es un plan de proceso sino
|
|
|
[`book-deviations.md`](../decisions/book-deviations.md), de **decisiones**, que
|
|
|
el 2026-08-06 escribió en pasado: _«un gesto continuo suena por REPETICIÓN … y
|
|
|
**los tres resolvers se borraron con él**»_. `git log -S` sobre `sounds.ts`
|
|
|
devuelve **un solo commit en toda su vida** (mayo): nunca se borraron. El
|
|
|
registro dio por ejecutado lo que no se ejecutó.
|
|
|
|
|
|
Alcance medido de la retirada (por si esa sesión la retoma): los tres resolvers,
|
|
|
`DragSoundParams`, el `SoundContour` de sema, sus 5 re-exports, 2 tests que sólo
|
|
|
se probaban a sí mismos y los helpers `clamp`/`lerp` huérfanos — 81 líneas, 7
|
|
|
símbolos; el registro (`SEMA_SOUND_VOICE`, `sample`, `resolveSoundDefinition`…)
|
|
|
no se toca. La nota fechada que se añadió al §4 del plan cerrado también se
|
|
|
revirtió con el resto.
|
|
|
|
|
|
**Cae con ellos** el homónimo `SoundContour`: el 2026-08-11 se renombró
|
|
|
`SoundDirection` → `SoundContour` en
|
|
|
[`sema/sounds.ts:34`](../../src/uix/sema/sounds.ts) sin mirar que
|
|
|
[`arts/sound/types.ts:44`](../../src/arts/sound/types.ts) ya exportaba ese nombre
|
|
|
con cinco valores en vez de dos. Cinco sitios a tocar; el nombre no puede volver
|
|
|
a `SoundDirection` (el rename se hizo porque tres cosas distintas se llamaban
|
|
|
`direction`). Propuesto: `GestureContour`, que es la palabra que usa la propia
|
|
|
tabla de corte («los 3 resolvedores de **gesto**»). Si los resolvers se retiran,
|
|
|
el tipo se va con ellos y no hay nada que renombrar.
|
|
|
|
|
|
⚠️ Esta fila nació de un error de método: se propuso **retirar** los tres
|
|
|
resolvers por «cero llamadores», con dos de esos cinco sitios en la salida del
|
|
|
propio grep y sin abrirlos. «No lo referencia nadie» es una observación, nunca
|
|
|
un veredicto (regla 4).
|
|
|
|
|
|
---
|
|
|
|
|
|
## Cola menor · comentarios fósiles
|
|
|
|
|
|
~11 comentarios en código que citan nombres muertos, sin defecto de
|
|
|
comportamiento detrás: color-picker, combobox, nav-tree («stays sema-free» con
|
|
|
dos eventos `emerge` declarados) y aura, que cita el patrón
|
|
|
`close-save`/`close-cancel` que Dialog ya no usa. Sin `id` propio: se limpian
|
|
|
cuando se toque el fichero por otra razón.
|
|
|
|
|
|
### D13 · Siete eventos declarados que nadie emite — `CONFIRMADO` · P1
|
|
|
|
|
|
Salió al cerrar D9: es la CLASE, y la clase ya produjo D1 (AlertDialog mudo), D3
|
|
|
(`commit-reset` en cinco pickers), D4 (ColorPicker) y el propio D9.
|
|
|
`book-deviations.md` tipifica el defecto hermano —declarar una firma de canal que
|
|
|
la activación no incluye— como _«mecánicamente comprobable y merece guard»_. Esto
|
|
|
es la misma forma un piso más arriba.
|
|
|
|
|
|
Hay guard desde el 2026-08-12 (`contracts.test.ts`, «guards declared events
|
|
|
against the ones a provider actually emits»), con los siete en `INERT_EVENT_DEBT`.
|
|
|
|
|
|
⚠️ **Corrección 2026-08-12 (misma jornada): esto NO es «la cola», y el censo no
|
|
|
es nuevo.** [`CONTINUE-sema-audit.md`](./CONTINUE-sema-audit.md) §3.1 ya lo había
|
|
|
medido — _«eventos huérfanos: 14 de 249 en 104 morfos con soma»_— y, sobre todo,
|
|
|
ya los había **clasificado en tres clases que yo metí en un saco**. Verificado
|
|
|
componente a componente, la clasificación de aquella auditoría es la correcta:
|
|
|
|
|
|
| Clase | Cuáles | Quién la cierra |
|
|
|
| ---------------------------------------------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
|
| **Contrato muerto** — el único defecto de la clase D1/D3/D4 | `tooltip` ×3 | libre; es el que queda accionable aquí |
|
|
|
| **Punto de extensión documentado** — lo emite la APP, no el componente | `virtual-list.handle-scroll` · `virtual-grid.handle-scroll-row/column` | el morfo **no tiene forma de declararlo**: la auditoría propone un `emission: 'app'`. Es vocabulario de morfo, no cableado |
|
|
|
| **Verbo delegado** — la transacción vive en un componente compuesto | `gradient-picker.commit-reset` (S-14, **1 de 6 casos idénticos**) | `CONTINUE-sema-audit.md`. No se arregla como D3: `GradientPickerProvider` **no tiene `clear()`** — su docblock dice que open/commit/cancel/clear viven en el `PickerProvider` genérico compuesto, y esta clase «sólo posee el runtime del morfo». No hay dónde enganchar; o se retira la declaración, o el externo re-emite |
|
|
|
|
|
|
Lo que este guard añade sobre aquel censo no es el hallazgo, es que **deja de ser
|
|
|
una medición de una vez**: bloquea la regresión. Eso lo demostró D9 al deshacerlo.
|
|
|
|
|
|
**El accionable: `tooltip`, 3 de 3.** Cero llamadas a `trigger(` en todo
|
|
|
`soma/components/tooltip` — abre y cierra **sin firma alguna**, en uno de los
|
|
|
componentes más ubicuos del catálogo. `CONTINUE-sema-audit.md` lo marca como
|
|
|
«HALLAZGO NUEVO, no está entre los 44» y lo tipifica como _contrato muerto_: o el
|
|
|
provider emite los tres, o las tres declaraciones se retiran. La pregunta previa
|
|
|
es cuál de las dos, porque el tooltip **compone Popover** y podría ser otro
|
|
|
`expression: 'delegated'` como los pickers — eso hay que medirlo antes de tocar,
|
|
|
no suponerlo.
|
|
|
|
|
|
⚠️ Nota de método: la prueba **no es** `trigger('literal')`. Chronos despacha por
|
|
|
variable (`emitOnChip`) y un grep literal dio dos falsos negativos durante la
|
|
|
auditoría. Lo que se comprueba es más débil y robusto: que el nombre aparezca
|
|
|
como literal en algún sitio que el provider alcance — su directorio soma **más
|
|
|
las librerías compartidas**. Sin `$libs/selection` en el ámbito, combobox y
|
|
|
select se leen como inertes y no lo son.
|
|
|
|
|
|
### D14 · El movimiento por teclado de chronos pierde el foco — `CONFIRMADO` · P1
|
|
|
|
|
|
Salió midiendo D9, y es anterior a él.
|
|
|
[`restoreChipFocus`](../../src/uix/soma/components/chronos/chronos-provider.svelte.ts)
|
|
|
reenfoca el chip en un `queueMicrotask`, que corre **antes** de que Svelte reponga
|
|
|
el nodo: consulta un elemento que ya no está, `dom.focus(null)`, y el foco cae al
|
|
|
`<body>`.
|
|
|
|
|
|
Medido: se enfoca un chip, se pulsa flecha → el agarre se activa (`data-dragging`)
|
|
|
y el foco pasa a `BODY`; la segunda y la tercera flecha **no llegan al
|
|
|
manejador**, y el Escape tampoco, así que el agarre queda colgado. La interacción
|
|
|
que el propio componente anuncia —_«Grabbed. Arrow keys move, Enter drops, Escape
|
|
|
cancels»_— muere al primer paso.
|
|
|
|
|
|
No se toca aquí: es un defecto de foco, no de firma, y merece su propia medición
|
|
|
(un `raf` o el `tick` de Svelte en lugar del microtask, verificado en navegador
|
|
|
real y no sólo headless).
|
