29 KiB

Raw Blame History Unescape Escape

CONTINUE — la dirección deja de ser una convención

Handoff para una sesión nueva. Leer entero antes de tocar nada: el refactor es pequeño en líneas y grande en alcance — toca un mecanismo del que cuelga todo el catálogo.

Contexto previo: docs/process/CONTINUE-direction.md (el eje entero) y docs/canon/direction-contract.md (el contrato, que es lo que este refactor automatiza). No hay que releerlos para empezar; lo que hace falta está aquí.

1. Por qué — los números

El contrato es correcto. El mecanismo para cumplirlo es teclear la misma línea en cada componente, y por eso falla:

	veces
Estampado del `dir` escrito a mano en un provider	54
Enlace al padre compuesto a mano en un envoltorio	7
`Content` portalizados que re-arrancan la cadena por su cuenta	9
Componentes que aceptaban `dir` y no lo estampaban	20 de 55

Los 20 se arreglaron uno a uno (21055bd3c), leyendo receta y envoltorio de cada uno. Encontrarlos costó una auditoría. El siguiente componente que alguien escriba volverá a tenerlo, porque nada lo impide: la regla vive en la cabeza del que lo escribe.

Una convención que hay que repetir 54 veces y que 20 de 55 incumplían no es una convención — es una abstracción que falta.

2. Las dos comprobaciones, HECHAS

Las dos condiciones de viabilidad están verificadas. No hay que repetirlas.

2.1 · ¿Puede el runtime emitir un atributo que a veces debe estar AUSENTE?

Sí, ya lo hace. src/uix/soma/runtime.svelte.ts:519-522, en renderProps():

for (const plan of compiledPart.dynamicAttrs) {
	const value = evalAttrPlan(plan, bindings);
	if (value !== undefined) props[plan.attr] = value;
}

undefined ⇒ el atributo no se escribe. Es exactamente la semántica del estampado crudo: nadie afirmó ⇒ no hay atributo ⇒ el elemento hereda. resolveProps() (:496-503) hace lo mismo. No hay que construir nada para esto.

2.2 · ¿Y sin declararlo en el morfo?

También, y hay precedente literal. partPropsForRegistration() (runtime.svelte.ts:538-551) ya inyecta id, el marcador del componente, data-archetype y reg.attachment sin ninguna declaración en el morfo, y el comentario de data-archetype justifica por qué:

data-archetype is part of static identity (cross-component classification, never mutates), so it ships through partProps — not through dom.apply.

Así que el movimiento 1 NO exige tocar 55 ficheros de morfo. Hay dos vehículos posibles y la elección es de quien lo haga (§4.1).

2.3 · ¿Tiene la capa flotante acceso al dueño?

Sí. Los sub-proveedores llevan this.provider (verificado en select y popover).

⚠️ El reparto que decía este apartado era FALSO, y la fuga no estaba donde decía. Censo real (§9.1): de los 11 FloatingContent.create, 10 pasan dir: opts.dir y 1 (sidebar) pasa this.provider.opts.dir — no 8 y 3. Y ese opts.dir no era una fuga: los 7 envoltorios Content que lo alimentan ya componían el enlace al padre a mano, así que la afirmación de la raíz SÍ cruzaba. Lo que no cruzaba era otra cosa (§9.1).

3. Qué está mal hoy, en una frase

El estampado y la propagación son dos convenciones manuales, y el eje entero —cuatro auditorías, tres barridos y unos veinte defectos— es lo que cuesta mantenerlas a mano.

4. Los dos movimientos

4.1 · El estampado pertenece al runtime

Objetivo: que las 54 líneas escritas a mano se vuelvan cero, y que un componente que acepte dir no pueda dejar de estamparlo.

Vehículo A — inyección en partPropsForRegistration. El provider registra su parte pasando la dirección cruda; el runtime la emite junto a id y data-archetype. Precedente exacto (§2.2). Mínimo código. Coste: el runtime pasa a conocer un concepto que hoy no conoce.

Vehículo B — un dynamicAttr universal en el compilador de morfo. El compilador añade a la parte provider un AttrPlan para dir con fuente fromProp: 'dir'. Encaja con «morfo declara, soma ejecuta», y renderProps() ya lo omitiría solo cuando resuelve undefined (§2.1). Coste: toca el compilador y su caché; hay que mirar contracts.cssSelectors, porque el conjunto cerrado de selectores que eidos puede usar se calcula ahí.

⚠️ Decidir A o B es la primera tarea, y no está decidida. Mi inclinación es A por tamaño y por precedente, pero B es más fiel a la doctrina. Léete los dos sitios antes de elegir.

⚠️ Lo que NO debe pasar: que el atributo aparezca en componentes que hoy NO deben llevarlo. Son cuatro y están verificados: popover, tooltip, link-preview y context-menu — su raíz no renderiza elemento o no pinta nada direccional, y su pintura vive en el panel portalizado. Si el runtime lo emite universalmente, esos cuatro ganan un atributo inútil. Es la parte delicada del movimiento 1: la emisión tiene que colgar de que el componente ACEPTE dir, no de que exista una parte provider.

⚠️ Y la excepción del §2 del contrato: avatar e image NO aceptan dir a propósito (su :dir() sólo traduce a físico una prop lógica que ya eligió el consumidor). Si acaban con la prop por efecto colateral, el refactor se ha llevado por delante una decisión firmada por el usuario.

4.2 · La propagación pertenece a la capa flotante

Objetivo: que la afirmación de la raíz cruce el portal sin que nadie escriba el enlace.

Hoy cada Content portalizado vuelve a arrancar activeDir desde cero, y por eso la afirmación no cruza. La forma: FloatingContent toma la dirección del proveedor DUEÑO, y el dir propio del Content la pisa si existe. Una composición dentro de la capa en vez de once fuera.

Los 7 enlaces compuestos a mano (dropdown-menu ×2, menubar, select, combobox, context-menu ×2) y el de color-picker se borran.

Y cierra sin trabajo extra el pendiente que quedó reportado: ningún picker de eidos reenvía dir a su PopoverContent, así que el cromo del picker-shell dentro del portal (picker-shell.css:78, el split del pie) está sin cubrir en los siete. Con 4.2 deja de ser una tarea; sin 4.2 son seis parches idénticos.

✅ 4.2 EJECUTADA — ver §9. Lo de abajo es el enunciado original, conservado porque el diagnóstico cambió al verificarlo.

5. Orden, y por qué

4.2 primero. Es más pequeña, está más acotada (una capa, once consumidores) y su verificación es directa: abrir un Select y comprobar que trigger y panel coinciden. Además borra código, así que 4.1 llega a un árbol más limpio.

4.1 después, y sólo cuando 4.2 esté verde y commiteada.

6. Verificación — la línea base exacta

Antes de empezar, tomar estas medidas y compararlas al final. Cualquier desviación hay que explicarla, no absorberla:

	valor esperado
`npx svelte-check --threshold error`	77 (la base; sube si otra sesión toca `media-player`)
`npm run rtl:check`	1 error — `palabras-chrome.css:446`, preexistente y excluido
`npm run docs:check`	0 errores sobre 564 docs
Tests de los componentes tocados	verdes; `eidos/lint.test.ts` falla por `audio-player` sin morfo, ajeno

⚠️ En navegador, y no es opcional: el censo del estampado NO se puede hacer por grep. Dos componentes (listbox, navigation-menu) estampan a través de un alias assertedDir y un grep del patrón literal los da como huecos. La comprobación buena es leer el DOM:

// con la demo abierta, por cada componente
document.querySelector('[data-select]').getAttribute('dir');

⚠️ El panel del navegador tiene que estar VISIBLE. Oculto no compone frames: no hay capturas y las transiciones CSS se congelan, así que getComputedStyle(...).transform devuelve la matriz identidad y parece un defecto que no lo es. Me pasó dos veces.

7. Trampas ya pagadas — no volver a pisarlas

El estampado es el CRUDO (opts.dir.current), nunca resolvedDir. Un valor resuelto escribe dir="ltr" cuando nadie afirmó nada, forzando el subárbol a LTR dentro de una página RTL. Pasó en sidebar y lo escribí yo.
dir en un <svg> no hace nada — la hoja UA de HTML no alcanza a los elementos SVG. Va en el envoltorio HTML. Medido en Chrome.
OptsFromProps quita el undefined del prop público y destruye la distinción entre «nadie afirmó» y 'ltr'. Quien lo use declara dir aparte.
Clasificar esto por grep se equivoca. Yo di avatar por defectuoso leyendo el patrón en vez del componente, y el usuario lo cazó. Abre la receta, abre el provider, mira dónde renderiza cada parte.
Una migración mecánica hereda los defectos que traduce. El barrido de §6.3 cambió doce selectores sin mirar los cuerpos y arrastró dos dobles volteos hasta que los cazó el guard RTL-2.

8. Estado del árbol al escribir esto

Rama alpha-0.1-dir-prefs, con remoto gita (no hay origin). Último commit del eje: 21055bd3c. Sin tocar y no commitear: .claude/settings.local.json, src/arts/adom/__scratch-verify.ts, web/routes/alpha/. media-player lo edita otra sesión — excluirlo de todo staging.

9. Sesión 2026-08-04 — §4.2 ejecutada

Sin commitear. Rama alpha-0.1-dir-prefs, HEAD se movió a 4755d97d1 mientras trabajaba (otra sesión, media-player + audio-player): esos ficheros están fuera de este cambio y fuera de cualquier staging.

9.1 · El censo del §2.3 estaba mal, y la fuga era otra

Rehecho leyendo los ficheros, no el patrón:


`FloatingContent.create`	11 sitios en 9 ficheros
…pasando `dir: opts.dir`	10
…pasando `this.provider.opts.dir`	1 (`sidebar`)
Envoltorios `Content` que componían el enlace al padre A MANO	7
Envoltorios `Content` SIN enlace	3 — `popover`, `tooltip`, `link-preview`

Y esos 3 no eran un defecto: sus raíces no aceptaban dir en absoluto, así que no había nada de la raíz que heredar. O sea entre los 11 consumidores del motor flotante no había ninguna fuga.

La fuga estaba un piso más arriba: en quien COMPONE un popover. Nueve componentes crean un PopoverProvider internamente (color-picker, date-picker, date-range-picker, emoji-picker, gradient-picker, natural-time-picker, picker, time-picker, time-range-picker) y siete de ellos aceptan dir — pero PopoverProvider no tenía dónde recibirlo, así que la afirmación moría en el borde del portal.

Medido en Chrome ANTES, con <DatePicker dir="rtl"> y la página en LTR:

[data-floating-wrapper]  dir="ltr"      ← el panel entero forzado a LTR
[data-picker-shell]      direction ltr
[data-picker-footer]     direction ltr   Clear x=15 · Cancel x=102 · Close x=209
[data-calendar]          direction RTL   ← lo ÚNICO que espejaba

El calendario mirroreaba porque es un componente soma propio que recibe el dir por el árbol de proveedores; el cromo que lo rodea —el picker-shell, cuyo pie reparte con margin-inline-end: auto (picker-shell.css:78)— no. Panel partido por la mitad, que es exactamente el fallo del §2 del contrato.

9.2 · La forma implementada

el dir propio de la superficie  →  el dir afirmado por el proveedor DUEÑO  →  omitir

FloatingProviderOpts.dir — el dueño baja su afirmación (ya pasada por activeDir, o sea prop → prefs, así que la cola de prefs queda intacta).
FloatingContent.assertedDir — opts.dir.current ?? provider.opts.dir.current. Los dos estampados del wrapper (rama nativa y rama JS) leen de ahí.
createFloatingShellRoot lo reenvía; es la puerta de 8 de los 10 FloatingProvider. Los otros 2 (submenús de dropdown-menu y context-menu) pasan el del menú padre.

⚠️ El punto que decide si esto funciona: FloatingContentOpts.dir pasa a ser la prop cruda del Content, no el resultado de activeDir. Si el envoltorio resolviera ahí, el valor sería casi siempre concreto (prefs) y el dueño nunca ganaría el fallback. Los 10 envoltorios pasan ahora readableActive(() => dir).

Consecuencias:

Los 7 enlaces compuestos a mano se borran, y con ellos el soma, el activeDir y el parentRoot/parentMenu de cada envoltorio.
popover, tooltip y link-preview aceptan dir en su raíz (prop pública nueva + opt). No estampan nada —no renderizan elemento—; el valor existe para cruzar el portal, y es lo que permite que un picker empuje su dirección al panel. Sin esa prop habría que escribir activeDir(() => undefined, soma) en la raíz, que es peor y no da nada a cambio.
Los 9 composers pasan su dir al PopoverProvider. gradient-picker y picker no aceptan dir (§9.17 del eje), así que corren la cadena con el primer eslabón ausente: activeDir(() => undefined, soma).

Queda UN activeDir con enlace al padre, y a propósito: dropdown-menu-sub-content.svelte lo necesita para effectiveSide (el lado por defecto del submenú es un left/right concreto, o sea MATEMÁTICA, que sí quiere valor resuelto). El ATRIBUTO ya no sale de ahí.

9.3 · Verificación

Medido en Chrome real, con la página en LTR y el dir movido por el control de la demo (el camino real, nunca setAttribute):

	antes	después
`date-picker` · wrapper	`ltr`	`rtl`
`date-picker` · shell / footer	`ltr`	`rtl`
`date-picker` · Clear/Cancel/Close x	15 / 102 / 209	200 / 92 / 15
`date-range-picker` · Clear/Cancel/Close x	—	448 / 217 / 17

Y a ojo: el panel entero espeja —cabecera, rejilla de días y pie—, no sólo el calendario. Sin regresión en los que ya funcionaban, comprobados uno a uno: dropdown-menu (raíz y submenú, con data-side=left en RTL), context-menu, menubar, select (por prefs, las dos direcciones), y tooltip en auto, que sigue estampando ltr — la cola de prefs no se perdió.

guard	resultado
`npx svelte-check --threshold error`	78 = línea base (A/B con stash: 78 sin mis cambios)
Tests de los 20 ámbitos tocados	158/158
`npm run rtl:check`	1 — `palabras-chrome.css:446`, preexistente
`npm run docs:check`	0 sobre 565
Pasada completa de vitest	9 fallos, ninguno mío (A/B con el árbol limpio: los 6 deterministas de `contracts`/`eidos-lint` salen igual; `soma-attr-audit`, `orca` y `cookie-adapter` pasan aislados — flaky bajo carga)

⚠️ La línea base de check es 78, no 77 como decía §6 — con el __scratch-verify.ts sin commitear en el árbol.

9.4 · Trampas de esta sesión

Lancé prettier --write sobre los 43 ficheros tocados y fue un error. Reformateó líneas PREEXISTENTES (imports colapsados, prosa de dos READMEs reflowada: popover/README.md pasó de +7/−4 a +49/−46). Deshecho a mano hasta devolver la diff a su forma quirúrgica. La regla del §5 del eje sigue viva: formatea sólo lo que ensuciaste, y mira el tamaño de la diff después. Lo único que se conserva del formateo son dos líneas MÍAS que superaban las 100 columnas.
Un click JS justo después de navegar no engancha: hasta que Svelte hidrata, .click() no dispara el handler. Y leer el atributo en la MISMA llamada que el click devuelve el valor viejo — hay que separar en dos llamadas.
El control de dirección de algunas demos vive bajo la pestaña «eidos System», no en la vista Live. Sin cambiar de pestaña no hay chips que pulsar.

9.5 · Lo que queda apuntado, sin tocar

9 campos resolvedDir MUERTOS en los proveedores Content (select 495, combobox 577, dropdown-menu 314 y 1230, context-menu 252 y 995, menubar 563, tooltip 409, link-preview 268). Verificado que nadie los lee — toda la matemática direccional consume this.provider.resolvedDir, o sea el de la RAÍZ. Ya eran código muerto antes; ahora además su docblock («Direction for this part's OWN math») describe algo que opts.dir ya no es. Borrarlos requiere tu palabra.
Agujero de observabilidad en 5 demos de picker: time-picker, time-range-picker, color-picker, emoji-picker y gradient-picker tienen el control dir del arnés pero no se lo pasan al componente, así que la mitad que ejercita el portal no se puede ver. Sólo date-picker y date-range-picker lo pasan — y por eso son los dos que pude medir. Mismo agujero que §8.2 del eje, misma clase de arreglo.
context-menu-sub-content clava side = 'right' (físico) mientras dropdown-menu-sub-content lo deriva de la dirección. Incoherencia entre dos componentes hermanos, preexistente y ajena a este cambio.
§4.1 sigue entera y sin empezar — el estampado del dir en el runtime, y la elección Vehículo A vs B sigue sin tomar.

10. Auditoría de la sesión — lo que salió al re-verificarlo todo

10.1 · Código muerto: BORRADO

Los 9 resolvedDir de §9.5.1 están eliminados. Antes de borrar, verificado que ninguno se lee: las 5 lecturas vivas de resolvedDir en esos ficheros son todas this.provider.resolvedDir —o sea el de la RAÍZ— desde SelectTriggerProvider, MenuContentProvider, ContextMenuContentProvider, MenubarMenuProvider y MenubarTriggerProvider. Cero lecturas desde eidos, blocks, packs, web/routes o tests. Quedan 5 declaraciones, las cinco de raíces vivas.

10.2 · Las demos: las 5 cableadas

time-picker, time-range-picker y color-picker no tenían control de dirección en absoluto; emoji-picker y natural-time-picker lo tenían en el arnés pero no se lo pasaban al componente. Ahora las siete demos de picker que aceptan dir lo pasan a la instancia, así que el camino de la PROP —el único que ejercita el portal— es observable en todas.

⚠️ Corrección a §9.5.2: dije «5 demos con el control pero sin pasarlo». Falso en dos sentidos: tres no tenían control, y gradient-picker/picker no aceptan dir (§9.17 del eje), así que no entran.

10.3 · Censo de ISLAS — un defecto nuevo, PREEXISTENTE y de otra familia

Con las demos cableadas se puede al fin escanear cada panel en RTL buscando elementos que estampen una dirección DISTINTA a la del envoltorio flotante:

panel	islas
`date-picker` · `date-range-picker` · `time-picker` · `time-range-picker`	0
`natural-time-picker`	1 — `[data-slider]`
`emoji-picker`	3 — `[data-command]` + `[data-toggle-group]` ×2
`color-picker`	1 — `[data-color-field-format-select]` (un `Select`)

La forma es la misma que arregló §4.2, pero para composición EN SITIO en vez de por portal: un componente eidos monta otro componente del canon (natural-time-picker-panel.svelte → Slider.Provider, emoji-picker-content.svelte → Command + ToggleGroup, color-field-format-select.svelte → Select) sin reenviarle el dir. El hijo corre su propia cadena, cae en prefs, estampa ltr — y ese atributo CORTA la herencia del panel, que sí es rtl.

Es preexistente: mientras el panel entero era LTR la isla no se veía. Lo que hizo §4.2 fue volverla visible.

⚠️ No lo he arreglado, y es deliberado: no hay UN solo precedente en eidos de reenviar dir a un componente compuesto (grep "dir={" src/uix/eidos da un único resultado, y es data-dir de otra cosa). Arreglarlo es inventar el patrón —doctrina nueva, no un parche— y toca 3 ficheros que este movimiento no toca. Es un movimiento propio.

La misma clase de defecto vivía en la DEMO del color-picker, que monta <Tabs> y un <ColorField> a mano dentro del panel: ahí sí lo arreglé, porque es demo y porque si no el control de dirección que acabo de añadir enseñaría un panel medio volteado y parecería defecto del framework.

10.4 · Verificación tras la auditoría


`npx svelte-check --threshold error`	78 = línea base (A/B con stash: 78 sin mis cambios)
Tests de los 20 ámbitos tocados	158/158
`npm run rtl:check`	1, el de `palabras`
`npm run docs:check`	0 sobre 565
Islas en los 7 paneles	4 paneles a 0; las 5 restantes documentadas arriba

⚠️ Trampa medida dos veces: svelte-check dio 79 en una pasada y 78 en la siguiente sin tocar nada. Era una CARRERA con la otra sesión guardando ficheros de media-player. En una rama compartida, un número que no reproduce no es un hallazgo — repite la medida antes de perseguirlo.

⚠️ Las 5 demos tocadas ya fallaban prettier --check en HEAD, así que no se formatearon (§9.4).

11. ENDGAME ejecutado — 2026-08-05 (P1–P5, decisiones D1–D4 firmadas)

El plan completo vive en la sesión que lo ejecutó; lo durable está en el canon (direction-contract.md §1/§2/§6) y en docs/decisions.md. Resumen operativo:

fase	commit	qué
P1	`9158d0796`	DirectionContext dentro de `activeDir` — la cadena gana el eslabón del ancestro; los 3 reenvíos de 4.3, el enlace manual del submenú y los 3 canarios de media-player se BORRAN. El repro de la otra sesión pasa sin ellos.
P2	`973d2c886`	Proyección automática + semilla — `createActiveUix` proyecta por defecto (`projectPrefs:false` opt-out; attach opt-in); `readPrefsEnvironmentFromDom` siembra `<html dir>` puesto a mano (`intent > env > derive > default`). Los 3 cableados manuales borrados en el MISMO commit.
P3	`01cc13d41`	El flip — `activeDir(dir)` devuelve la AFIRMACIÓN (prop ?? ctx), sin prefs y sin parámetro soma; la matemática vive en `resolveDir(dir, soma)`. En `auto` la página entera lleva UN `dir` (el `<html>`). SSR: cero `dir` en el payload.
P4	`fc84305c2`	El morfo declara — `direction: { parts }` en 51 morfos; `soma.runtime<M>` computa el requisito del tipo (declarado ⇒ requerido; no ⇒ prohibido); `compileMorfo` valida parts fail-closed; censo prop↔morfo como guard (`direction-census.test.ts`) con las excepciones firmadas (field-langs, waveform, popover/tooltip/link-preview). La ceremonia de 4.1 (67+47 `dir: null`, 49 getters) MUERE.
P5	(este commit)	`activeEidosDir` gana el contexto (compartido con soma) y se parte igual (`resolveEidosDir`); charts al día; corpus + decisiones + memoria.

El estado final del eje: nadie escribe dir= a mano; ausente hereda de verdad; olvidar el cable no compila; el ambiente llega al DOM una vez. Los tres dir= de media-player eran los canarios y CANTARON (panel rtl sin ellos).

Verificación final medida

auto: 1 [dir] en toda la página (el <html> proyectado) — antes ~cada raíz.
prefs rtl: select y su panel portalizado SIN atributo, computan rtl por herencia.
prop rtl: trigger del dropdown estampa, el portal cruza, submenú data-side=left, 0 islas.
matemática: slider sin atributo con página rtl — click 25% físico → 75, ArrowRight baja.
SSR (curl): cero dir= en select y accordion.
check 77 = línea base en todas las fases · rtl:check 1 (palabras) · docs:check 0/566 · suites 1401/1402 (el 1: soma-attr-audit, flaky bajo carga, pasa aislado).

La cola que QUEDA (pospuesta por decisión D4 o ajena)

~~Censo de API~~ CERRADO 2026-08-05 (tarde) — los tres que quedaban: picker y gradient-picker aceptan dir?: Direction (prop → activeDir → morfo direction: {} → runtime; el genérico arrastra la opt a natural-time-picker y gradient-picker por tipo), y chat-log acepta y reenvía a los Feed/VirtualList que compone — sus 2 errores de línea base MUEREN: la base pasa de 77 a 75. El censo-guard los cuenta sin excepción nueva. Verificado en Chrome: gradient-picker root+panel rtl por prop con 0 islas; chat-log AUSENTE en auto y rtl por prop.
Opts canónicas transversales (bindProps v2) — eje propio; el censo completo está en el reporte del agente de diseño de esta sesión.
Deuda ajena intacta: 91 tests que falsean Soma.require() · cero tests de charts · smoke/perm:check sin correr.

Trampas nuevas de esta pasada, para no repetir

git commit SIN pathspec en rama compartida se llevó por delante el índice de la otra sesión una vez (b41669c43). Desde entonces: SIEMPRE git commit -- <rutas>.
El detector de huérfanos por identificador se tropezó con la RUTA del import (core/soma.svelte contiene "soma") — excluir líneas de import antes de buscar usos.
readableActive/vista de prefs construida DENTRO de una función pura llamada por $derived = una alocación por pasada — cachear por instancia (WeakMap en resolveEidosDir).
El gate de P4 cazó a command (estampado inline en el assert que el barrido 4.1 no vio) y a 5 runtimes secundarios del mismo morfo — un tipo condicional bien puesto encuentra lo que los barridos no.

29 KiB Raw Blame History Unescape Escape