# active_architecture.md — session snapshot (May 2026)

Pulled out of `src/uix/active_architecture.md` so that doc reads as a timeless
architecture reference. This is the dated session framing (the "Handoff 2026-05-14"
§0 minus its contract table, which stayed as reference) plus the "Estado actual
(2026-05-17)" §10 status snapshot. Kept for traceability; the rules it fixed live
in `active-uix/README` (ownership/degradation) and `contracts.ts` (the table).

---

## Handoff 2026-05-14 (framing)

Estado acordado al cierre de la sesión:

- **No tocar componentes Eidos** hasta cerrar de nuevo la arquitectura.
- **Contratos mínimos fijados antes de seguir** (tabla autoritativa en
  `src/uix/contracts.ts`, validada con `src/uix/contracts.test.ts`).
- **Regla de composition roots cerrada**: solo `ActiveApp` y `ActiveUix`
  standalone crean servicios compartidos.

Preguntas cerradas tras la revisión: `ActiveUix` expone `uix.prefs` bruto; `Dom`
standalone puede usar `disabledDom`, attach exige `app.dom`; `Sema` fuera de UIX
necesita `dom`/`projector` o `visual:false`; `Eidos` = `ActiveEidos`; `Soma` no
necesita `ActiveSoma`; `langs`↔`prefs.language` / `format`↔`prefs.locale`; `prefs`
es el nombre canónico; `attachActiveUix` exige `langs`+`dom`; la ruta docs
sincroniza prefs y no muta `html[dir]`/`uix.langs` directamente.

Hallazgos P1 resueltos: `createActiveUix({dom:false})` crea `disabledDom` y se lo
pasa a `EngineSemantic`; `ActiveUix.dom` siempre existe; `ActiveUix` no proyecta
prefs al DOM (lo hace `ActivePrefsDomProjection` / `ActiveEidos`); ownership DOM
P1 cerrado (live regions, observers, foco/scroll imperativo vía `ActiveDom`);
`SoundChannel` no registra listeners globales en el constructor; Sema ya no
propaga `motion`/`color`/`presence`.

Hallazgos P2/P3: standalone usa `createSvelteEngineBus`; attach no re-suscribe
`prefs.language → langs`.

Contexto `frontend` cerrado: `arts/frontend` retirado; no reaparece como fuente de
`locale`; `prefs.locale`→`format`, `prefs.language`→`langs`, `prefs.direction`→
`html[dir]` vía `ActivePrefsDomProjection`.

(These rules are now stated, timeless, in `src/uix/active-uix/README.md` §"Reglas
de ownership y degradación".)

---

## Estado actual (2026-05-17)

**Implementado y verificado** (snapshot at that date): `morfo` (115 components,
sium validator, ~265 archetype-classified part declarations, doctrinal event
shape); `soma/morfo/runtime` (`part`/`partProps`/`keydown`/`trigger`, provider
inheritance dropped, domain engines moved to `src/libs`); `sema` (`EngineSemantic`
+ `chans/`, 8 families × 6 intents, SoundChannel with prepare-time priming,
HapticChannel opt-in); `eidos` (`ActiveEidos`, color hierarchy + intents over
12-step scales, discrete `Size`, recipe aliases, `EidosConfigDocument`
persistence); `adom`; `active-uix` + `active-app` (two boot modes, Props bridge V2).

**Pendiente (at that date — several since DONE):** afilar `EidosConfig.recipes`;
reparar demos/rutas en `Provider`/flat-snippets; `persistence` field *(since done)*;
holds-by-intent; topbar-mute → `SoundChannel.masterGain`; polymorphic events
*(since done)*; `a11ySemantic` per event *(since done)*.

**Layers ya muertos:** `src/lib/`, `src/uix/terra/`, `src/uix/air/`,
`src/routes/test`.