svelte-kit-vice/docs/process/CONTINUE-direction-runtime.md

# 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()`:

```ts
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:

```js
// 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

1. **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.**
2. **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.
3. **`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. **§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.