From 540abee0267e371f5a74a0daa0b9da4b9d3145e5 Mon Sep 17 00:00:00 2001
From: dev <info@activething.com>
Date: Mon, 25 May 2026 13:50:14 +0200
Subject: [PATCH] refactor(soma/eidos): migrate 4 service components from Eidos
 to Soma
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Architectural cleanup: Trans, FormatDate, FormatNumber, RelativeTime no
son visuales — son behavior alrededor del runtime (`uix.langs.t/ts`,
`uix.format.*`). Estaban en `eidos/components/` solo porque ahi se
inventariaban los wrappers. Naturaleza real: Soma.

Beneficio principal: el invariante "Eidos no importa `getActiveUix()`"
recupera su pureza — los 4 service components ya no contaban como
violación del audit Codex (P1 #1 reducido en 4 archivos +
dependencias).

Movimientos (4 componentes, 31 archivos staged):

- src/uix/eidos/components/{kebab}/ → src/uix/soma/components/{kebab}/
  - {kebab}.svelte → components/{kebab}.svelte (subdir convencion Soma)
  - types.ts → types.ts
  - README.md → README.md
  - index.ts → exports.ts (Soma pattern: index re-exports from exports)
  - + nuevo index.ts: `export * from './exports';`
  - Eidos dirs eliminados (4 directories).

Morfos: scope `['eidos']` → scope `['soma']` (4 archivos):
- morfo/components/trans.ts
- morfo/components/format-date.ts
- morfo/components/format-number.ts
- morfo/components/relative-time.ts

Demos (4 +page.svelte) updated:
- import paths `$uix/eidos/components/{kebab}` → `$soma/components/{kebab}`
- meta-pill `scope: eidos` → `scope: soma`

Headers de los .svelte updated: "Eidos `<X>`" → "Soma `<X>` — service
component" + parrafo explicando por que vive en Soma (behavior, no
visual primitive).

Verificación:
- `npm run check`: 0 errors (mantenido).
- HTTP probes /uix/components/{trans,format-date,format-number,relative-time}:
  todos 200.

Sin barrel re-exports a limpiar (no existían). Sin consumers fuera de
los 4 demos.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 src/uix/eidos/components/format-date/index.ts | 20 -----
 .../eidos/components/relative-time/index.ts   | 19 -----
 src/uix/eidos/components/trans/README.md      | 82 -------------------
 src/uix/eidos/components/trans/index.ts       | 17 ----
 src/uix/morfo/components/format-date.ts       |  2 +-
 src/uix/morfo/components/format-number.ts     |  2 +-
 src/uix/morfo/components/relative-time.ts     |  2 +-
 src/uix/morfo/components/trans.ts             |  2 +-
 .../components/format-date/README.md          | 10 ++-
 .../components}/format-date.svelte            | 11 ++-
 .../soma/components/format-date/exports.ts    | 24 ++++++
 src/uix/soma/components/format-date/index.ts  |  1 +
 .../components/format-date/types.ts           |  0
 .../components/format-number/README.md        |  8 +-
 .../components}/format-number.svelte          | 11 ++-
 .../components/format-number/exports.ts}      | 12 ++-
 .../soma/components/format-number/index.ts    |  1 +
 .../components/format-number/types.ts         |  0
 .../components/relative-time/README.md        |  8 +-
 .../components}/relative-time.svelte          |  9 +-
 .../soma/components/relative-time/exports.ts  | 23 ++++++
 .../soma/components/relative-time/index.ts    |  1 +
 .../components/relative-time/types.ts         |  0
 .../components/trans/components}/trans.svelte | 19 +++--
 src/uix/soma/components/trans/exports.ts      | 22 +++++
 src/uix/soma/components/trans/index.ts        |  1 +
 .../{eidos => soma}/components/trans/types.ts | 28 +++----
 .../uix/components/format-date/+page.svelte   |  4 +-
 .../uix/components/format-number/+page.svelte |  6 +-
 .../uix/components/relative-time/+page.svelte |  4 +-
 web/routes/uix/components/trans/+page.svelte  |  6 +-
 31 files changed, 160 insertions(+), 195 deletions(-)
 delete mode 100644 src/uix/eidos/components/format-date/index.ts
 delete mode 100644 src/uix/eidos/components/relative-time/index.ts
 delete mode 100644 src/uix/eidos/components/trans/README.md
 delete mode 100644 src/uix/eidos/components/trans/index.ts
 rename src/uix/{eidos => soma}/components/format-date/README.md (92%)
 rename src/uix/{eidos/components/format-date => soma/components/format-date/components}/format-date.svelte (90%)
 create mode 100644 src/uix/soma/components/format-date/exports.ts
 create mode 100644 src/uix/soma/components/format-date/index.ts
 rename src/uix/{eidos => soma}/components/format-date/types.ts (100%)
 rename src/uix/{eidos => soma}/components/format-number/README.md (93%)
 rename src/uix/{eidos/components/format-number => soma/components/format-number/components}/format-number.svelte (89%)
 rename src/uix/{eidos/components/format-number/index.ts => soma/components/format-number/exports.ts} (59%)
 create mode 100644 src/uix/soma/components/format-number/index.ts
 rename src/uix/{eidos => soma}/components/format-number/types.ts (100%)
 rename src/uix/{eidos => soma}/components/relative-time/README.md (90%)
 rename src/uix/{eidos/components/relative-time => soma/components/relative-time/components}/relative-time.svelte (94%)
 create mode 100644 src/uix/soma/components/relative-time/exports.ts
 create mode 100644 src/uix/soma/components/relative-time/index.ts
 rename src/uix/{eidos => soma}/components/relative-time/types.ts (100%)
 rename src/uix/{eidos/components/trans => soma/components/trans/components}/trans.svelte (82%)
 create mode 100644 src/uix/soma/components/trans/exports.ts
 create mode 100644 src/uix/soma/components/trans/index.ts
 rename src/uix/{eidos => soma}/components/trans/types.ts (66%)

diff --git a/src/uix/eidos/components/format-date/index.ts b/src/uix/eidos/components/format-date/index.ts
deleted file mode 100644
index 3cbe49c58..000000000
--- a/src/uix/eidos/components/format-date/index.ts
+++ /dev/null
@@ -1,20 +0,0 @@
-// FormatDate — service component wrapping uix.format.dates.
-//
-//   import { FormatDate } from '$uix/eidos/components/format-date';
-//
-//   <FormatDate value={post.publishedAt} dateStyle="medium" />
-//   <FormatDate value={meeting.startsAt} mode="dateTime" />
-//   <FormatDate value={now} mode="time" timeZoneName="short" />
-//
-// Renders as <time datetime="..."> for semantic ISO 8601 access.
-import FormatDate from './format-date.svelte';
-
-export { FormatDate };
-export default FormatDate;
-export type {
-	FormatDateProps,
-	FormatDateInput,
-	FormatDateMode,
-	FormatDateStyle,
-	FormatTimeStyle
-} from './types';
diff --git a/src/uix/eidos/components/relative-time/index.ts b/src/uix/eidos/components/relative-time/index.ts
deleted file mode 100644
index 13e04df79..000000000
--- a/src/uix/eidos/components/relative-time/index.ts
+++ /dev/null
@@ -1,19 +0,0 @@
-// RelativeTime — service component rendering Intl.RelativeTimeFormat
-// output ("hace 2 horas" / "in 3 days") with an auto-refresh tick.
-//
-//   import { RelativeTime } from '$uix/eidos/components/relative-time';
-//
-//   <RelativeTime value={post.publishedAt} />
-//   <RelativeTime value={createdAt} style="short" />
-//   <RelativeTime value={dueDate} unit="day" updateInterval={0} />
-import RelativeTime from './relative-time.svelte';
-
-export { RelativeTime };
-export default RelativeTime;
-export type {
-	RelativeTimeProps,
-	RelativeTimeInput,
-	RelativeTimeUnit,
-	RelativeTimeNumeric,
-	RelativeTimeStyle
-} from './types';
diff --git a/src/uix/eidos/components/trans/README.md b/src/uix/eidos/components/trans/README.md
deleted file mode 100644
index b32c564af..000000000
--- a/src/uix/eidos/components/trans/README.md
+++ /dev/null
@@ -1,82 +0,0 @@
-# Eidos Trans
-
-`<Trans>` es un **service component** — un wrapper greppable de
-`getActiveUix().langs.t / ts`. Resuelve un `idlangref` o un `path` a
-traves del catalogo activo de langs y renderiza el texto traducido.
-
-Familia con `<FormatDate>`, `<FormatNumber>`, `<RelativeTime>`: todos
-son wrappers tipados del runtime para que un audit i18n encuentre cada
-sitio que toca el catalogo con `grep "<Trans"`.
-
-## Superficie
-
-```svelte
-<!-- 5 modos de resolucion -->
-<Trans>#?common.save|Save</Trans>            <!-- children como idlangref -->
-<Trans value="#?common.save|Save" />          <!-- value prop -->
-<Trans path="common.save">Save</Trans>        <!-- path + children=fallback -->
-<Trans path="common.greet" params={{name: 'Juan'}} />
-<Trans as="strong">#?ui.required|Required</Trans>
-<Trans path="common.save" locale="en-US">Save</Trans>
-```
-
-## Props clave
-
-| Prop | Tipo | Default | Notas |
-| --- | --- | --- | --- |
-| `value` | `LangString` | — | `idlangref` (`#?path\|fallback`) o literal. |
-| `path` | `string` | — | Dotted path al catalogo (ej. `'common.save'`). |
-| `params` | `Record<string, unknown>` | — | Interpolacion para `path`. |
-| `locale` | `SupportedLocale` | runtime | Override por instancia. |
-| `trim` | `boolean` | `true` | Trim del texto capturado de children. |
-| `as` | `keyof HTMLElementTagNameMap` | `'span'` | Tag HTML. |
-| `children` | snippet | — | Fallback / source si no hay `value` / `path`. |
-
-## Modos de resolucion
-
-| Modo | Forma | Source |
-| --- | --- | --- |
-| 1. Children-only | `<Trans>#?common.save\|Save</Trans>` | DOM `textContent` parseado como `idlangref`. |
-| 2. Value prop | `<Trans value="#?common.save\|Save" />` | `value` parseado. |
-| 3. Path + children fallback | `<Trans path="common.save">Save</Trans>` | `t(path)` con `children` como fallback si la key no existe. |
-| 4. Path + params | `<Trans path="common.greet" params={{name}} />` | `t(path, params)`. |
-| 5. Pass-through | `<Trans value="literal text" />` | Texto literal sin resolver. |
-
-## Decisiones
-
-- **Reactivo al locale**: el `$derived` re-corre cuando el locale activo
-  cambia. La lectura va a traves de `uix.langs.t / ts` que estan
-  acopladas al sistema reactivo de runes.
-- **Captura de children**: cuando ni `value` ni `path` estan
-  presentes, el componente captura `textContent` del nodo via
-  `bind:this={captureNode}` + `$effect`. La primera render emite el
-  children original (`#?path|fallback` sin resolver); en `$effect`
-  intercepta y resuelve.
-- **Cast del path**: `langs.t()` tipa su primer overload con
-  `${string}.${string}` (template literal estricto). Como el runtime
-  acepta paths dinamicos en runtime, se castea via
-  `Parameters<typeof t>[0]`.
-- **Fallback a children**: cuando `t(path)` devuelve el path original
-  (signal de "key no encontrada"), el componente cae al `capturedText`
-  si existe.
-- **No CSS recipe**: marker `[data-trans]` solo para tooling.
-- **No emite eventos sema**.
-
-## Comparativa
-
-| Capacidad | Eidos | i18next `Trans` | formatjs `FormattedMessage` | svelte-i18n `_` |
-| --- | --- | --- | --- | --- |
-| Greppable site marker | Si: `<Trans` | Si | Si | No: `$_('key')` inline |
-| Children-as-idlangref | Si: `#?path\|fallback` | Si | No | No |
-| Path + params | Si | Si | Si | Si |
-| Locale override per-instance | Si | Limitado | Si | No |
-| Reactivo al cambio de locale | Si | Si | Si | Si |
-| Tag HTML configurable | Si: `as` | Si: `as` | Si: `tagName` | No |
-| Pluralizacion | Via params del catalogo | Si | Si | Si |
-
-## Referencias
-
-- i18next Trans: https://react.i18next.com/latest/trans-component
-- formatjs: https://formatjs.io/docs/react-intl/components#formattedmessage
-- Active langs: `src/arts/langs/`
-- Sistema idlangref: `src/uix/langs/`
diff --git a/src/uix/eidos/components/trans/index.ts b/src/uix/eidos/components/trans/index.ts
deleted file mode 100644
index 0fcb2f327..000000000
--- a/src/uix/eidos/components/trans/index.ts
+++ /dev/null
@@ -1,17 +0,0 @@
-// Trans — i18n primitive that resolves an idlangref or path through
-// the active langs catalog and renders the translated string.
-//
-//   import { Trans } from '$uix/eidos/components/trans';
-//
-//   <Trans>#?common.save|Save</Trans>
-//   <Trans value="#?common.save|Save" />
-//   <Trans path="common.save">Save</Trans>
-//   <Trans path="common.greet" params={{ name: 'Juan' }} />
-//   <Trans as="strong">#?ui.required|Required</Trans>
-//
-// Reactive to locale changes; greppable as the canonical i18n marker.
-import Trans from './trans.svelte';
-
-export { Trans };
-export default Trans;
-export type { TransProps } from './types';
diff --git a/src/uix/morfo/components/format-date.ts b/src/uix/morfo/components/format-date.ts
index f884d6e4c..492273a42 100644
--- a/src/uix/morfo/components/format-date.ts
+++ b/src/uix/morfo/components/format-date.ts
@@ -12,7 +12,7 @@ import type { Morfo } from '../types';
 export const formatDateMorfo = {
 	name: 'FormatDate',
 	kebab: 'format-date',
-	scope: ['eidos'],
+	scope: ['soma'],
 	parts: [
 		{
 			name: 'Provider',
diff --git a/src/uix/morfo/components/format-number.ts b/src/uix/morfo/components/format-number.ts
index 68151e3f0..8cfeb996c 100644
--- a/src/uix/morfo/components/format-number.ts
+++ b/src/uix/morfo/components/format-number.ts
@@ -16,7 +16,7 @@ import type { Morfo } from '../types';
 export const formatNumberMorfo = {
 	name: 'FormatNumber',
 	kebab: 'format-number',
-	scope: ['eidos'],
+	scope: ['soma'],
 	parts: [
 		{
 			name: 'Provider',
diff --git a/src/uix/morfo/components/relative-time.ts b/src/uix/morfo/components/relative-time.ts
index d3e83fc41..b033c047d 100644
--- a/src/uix/morfo/components/relative-time.ts
+++ b/src/uix/morfo/components/relative-time.ts
@@ -12,7 +12,7 @@ import type { Morfo } from '../types';
 export const relativeTimeMorfo = {
 	name: 'RelativeTime',
 	kebab: 'relative-time',
-	scope: ['eidos'],
+	scope: ['soma'],
 	parts: [
 		{
 			name: 'Provider',
diff --git a/src/uix/morfo/components/trans.ts b/src/uix/morfo/components/trans.ts
index 60163ad62..1909527e0 100644
--- a/src/uix/morfo/components/trans.ts
+++ b/src/uix/morfo/components/trans.ts
@@ -20,7 +20,7 @@ import type { Morfo } from '../types';
 export const transMorfo = {
 	name: 'Trans',
 	kebab: 'trans',
-	scope: ['eidos'],
+	scope: ['soma'],
 	parts: [
 		{
 			name: 'Provider',
diff --git a/src/uix/eidos/components/format-date/README.md b/src/uix/soma/components/format-date/README.md
similarity index 92%
rename from src/uix/eidos/components/format-date/README.md
rename to src/uix/soma/components/format-date/README.md
index 7a6f3b7c7..4adf9c62f 100644
--- a/src/uix/eidos/components/format-date/README.md
+++ b/src/uix/soma/components/format-date/README.md
@@ -1,4 +1,4 @@
-# Eidos FormatDate
+# Soma FormatDate
 
 `<FormatDate>` es un **service component** — un wrapper greppable de
 `getActiveUix().format.dates.formatDate / formatTime / formatDateTime`.
@@ -10,6 +10,10 @@ Familia con `<Trans>`, `<FormatNumber>`, `<RelativeTime>`: todos son
 wrappers tipados del runtime para que un audit i18n/l10n encuentre cada
 sitio de formateo con `grep "<FormatDate"`.
 
+Vive en `soma/components/` (no `eidos/components/`) porque es una pieza
+de comportamiento alrededor de `getActiveUix()`. La invariante "Eidos no
+importa runtime" se preserva sacando los 4 service components a Soma.
+
 ## Superficie
 
 ```svelte
@@ -57,7 +61,7 @@ sitio de formateo con `grep "<FormatDate"`.
   `as="span"`, el `datetime` se aplica al span (validado por Svelte) pero
   pierde la semantica nativa.
 - **No CSS recipe**: el marker `[data-format-date]` existe solo para
-  tooling — no hay estilos a nivel de eidos porque el output es texto
+  tooling — no hay estilos a nivel de soma porque el output es texto
   puro.
 - **No emite eventos sema**: no es una acto perceptivo del usuario.
 
@@ -83,7 +87,7 @@ Si quieres mostrar timezone label (`timeZoneName`), usa per-axis:
 
 ## Comparativa
 
-| Capacidad | Eidos | date-fns | Day.js | luxon | Intl.DateTimeFormat |
+| Capacidad | Soma | date-fns | Day.js | luxon | Intl.DateTimeFormat |
 | --- | --- | --- | --- | --- | --- |
 | Modo `date`/`time`/`dateTime` | Si | Manual via format strings | Manual | Si (`toLocaleString`) | Manual |
 | Locale reactivo desde runtime | Si | No | No | No | No |
diff --git a/src/uix/eidos/components/format-date/format-date.svelte b/src/uix/soma/components/format-date/components/format-date.svelte
similarity index 90%
rename from src/uix/eidos/components/format-date/format-date.svelte
rename to src/uix/soma/components/format-date/components/format-date.svelte
index e0ad1faa4..18acb0e34 100644
--- a/src/uix/eidos/components/format-date/format-date.svelte
+++ b/src/uix/soma/components/format-date/components/format-date.svelte
@@ -1,6 +1,6 @@
 <script lang="ts">
 	/**
-	 * Eidos `<FormatDate>` — service component wrapping the active
+	 * Soma `<FormatDate>` — service component wrapping the active
 	 * dates runtime (`uix.format.dates.formatDate / formatTime /
 	 * formatDateTime`). Renders as `<time datetime="...">` by default
 	 * so screen readers and search engines can parse the original
@@ -9,9 +9,14 @@
 	 *   <FormatDate value={post.publishedAt} dateStyle="medium" />
 	 *   <FormatDate value={meeting.startsAt} mode="dateTime" dateStyle="short" timeStyle="short" />
 	 *   <FormatDate value={createdAt} mode="time" timeZone="UTC" timeZoneName="short" />
+	 *
+	 * Lives in Soma (not Eidos) because it is a behavior component
+	 * around `getActiveUix().format`, not a visual primitive. Eidos
+	 * remains a pure visual layer; service components like this one
+	 * own the runtime access.
 	 */
 	import { getActiveUix } from '$active-uix';
-	import type { FormatDateInput, FormatDateProps } from './types';
+	import type { FormatDateInput, FormatDateProps } from '../types';
 
 	let {
 		value = null,
@@ -90,7 +95,7 @@
 			return dates.formatDate(parsed, options, locale);
 		}
 
-		// No runtime available (e.g. eidos used outside `<UixApp>`).
+		// No runtime available (e.g. soma used outside `<UixApp>`).
 		// Replicate the engine's default-preset logic locally so `mode`
 		// is still honoured. Defaults are skipped when the caller
 		// already passed a conflicting per-axis field or `timeZoneName`
diff --git a/src/uix/soma/components/format-date/exports.ts b/src/uix/soma/components/format-date/exports.ts
new file mode 100644
index 000000000..bf3e1db4d
--- /dev/null
+++ b/src/uix/soma/components/format-date/exports.ts
@@ -0,0 +1,24 @@
+// FormatDate — service component wrapping uix.format.dates.
+//
+//   import { FormatDate } from '$soma/components/format-date';
+//
+//   <FormatDate value={post.publishedAt} dateStyle="medium" />
+//   <FormatDate value={meeting.startsAt} mode="dateTime" />
+//   <FormatDate value={now} mode="time" timeZoneName="short" />
+//
+// Renders as <time datetime="..."> for semantic ISO 8601 access.
+//
+// Lives under `soma/` (not `eidos/`) because the component owns runtime
+// access. Eidos invariant — "no `getActiveUix()` imports" — is enforced
+// across the visual layer; service components like `Trans` /
+// `FormatDate` / `FormatNumber` / `RelativeTime` are their Soma-side peers.
+export { default as FormatDate } from './components/format-date.svelte';
+export { default as Provider } from './components/format-date.svelte';
+
+export type {
+	FormatDateProps,
+	FormatDateInput,
+	FormatDateMode,
+	FormatDateStyle,
+	FormatTimeStyle
+} from './types';
diff --git a/src/uix/soma/components/format-date/index.ts b/src/uix/soma/components/format-date/index.ts
new file mode 100644
index 000000000..8570a426a
--- /dev/null
+++ b/src/uix/soma/components/format-date/index.ts
@@ -0,0 +1 @@
+export * from './exports';
diff --git a/src/uix/eidos/components/format-date/types.ts b/src/uix/soma/components/format-date/types.ts
similarity index 100%
rename from src/uix/eidos/components/format-date/types.ts
rename to src/uix/soma/components/format-date/types.ts
diff --git a/src/uix/eidos/components/format-number/README.md b/src/uix/soma/components/format-number/README.md
similarity index 93%
rename from src/uix/eidos/components/format-number/README.md
rename to src/uix/soma/components/format-number/README.md
index 9deef1086..aa2e3e3fe 100644
--- a/src/uix/eidos/components/format-number/README.md
+++ b/src/uix/soma/components/format-number/README.md
@@ -1,4 +1,4 @@
-# Eidos FormatNumber
+# Soma FormatNumber
 
 `<FormatNumber>` es un **service component** — un wrapper greppable de
 `getActiveUix().format.numbers`. Renderiza un numero a traves del
@@ -7,6 +7,10 @@ preferencias de moneda / sistema de unidades).
 
 Familia con `<Trans>`, `<FormatDate>`, `<RelativeTime>`.
 
+Vive en `soma/components/` (no `eidos/components/`) porque es una pieza
+de comportamiento alrededor de `getActiveUix()`. La invariante "Eidos no
+importa runtime" se preserva sacando los 4 service components a Soma.
+
 ## Superficie
 
 ```svelte
@@ -62,7 +66,7 @@ Familia con `<Trans>`, `<FormatDate>`, `<RelativeTime>`.
 
 ## Comparativa
 
-| Capacidad | Eidos | numbro | accounting.js | Intl.NumberFormat |
+| Capacidad | Soma | numbro | accounting.js | Intl.NumberFormat |
 | --- | --- | --- | --- | --- |
 | Locale reactivo desde runtime | Si | No | No | No |
 | Cache de instancias por options | Si | No | No | No |
diff --git a/src/uix/eidos/components/format-number/format-number.svelte b/src/uix/soma/components/format-number/components/format-number.svelte
similarity index 89%
rename from src/uix/eidos/components/format-number/format-number.svelte
rename to src/uix/soma/components/format-number/components/format-number.svelte
index 90dc45908..87a557a09 100644
--- a/src/uix/eidos/components/format-number/format-number.svelte
+++ b/src/uix/soma/components/format-number/components/format-number.svelte
@@ -1,6 +1,6 @@
 <script lang="ts">
 	/**
-	 * Eidos `<FormatNumber>` — service component wrapping
+	 * Soma `<FormatNumber>` — service component wrapping
 	 * `getActiveUix().format.numbers.format(...)` so consumers can
 	 * type-safe their locale-aware number rendering without inlining
 	 * the runtime call on every site.
@@ -16,9 +16,14 @@
 	 * Reactive to locale + currency + preference changes — the runtime
 	 * already exposes those signals, this component just observes them
 	 * via `$derived`.
+	 *
+	 * Lives in Soma (not Eidos) because it is a behavior component
+	 * around `getActiveUix().format`, not a visual primitive. Eidos
+	 * remains a pure visual layer; service components like this one
+	 * own the runtime access.
 	 */
 	import { getActiveUix } from '$active-uix';
-	import type { FormatNumberProps } from './types';
+	import type { FormatNumberProps } from '../types';
 
 	let {
 		value = null,
@@ -90,7 +95,7 @@
 			return numbers.format(inputValue, options, locale);
 		}
 
-		// No runtime available (e.g. eidos used outside `<UixApp>`).
+		// No runtime available (e.g. soma used outside `<UixApp>`).
 		return new Intl.NumberFormat(locale ?? undefined, options).format(inputValue);
 	});
 </script>
diff --git a/src/uix/eidos/components/format-number/index.ts b/src/uix/soma/components/format-number/exports.ts
similarity index 59%
rename from src/uix/eidos/components/format-number/index.ts
rename to src/uix/soma/components/format-number/exports.ts
index 22104909c..6a9134023 100644
--- a/src/uix/eidos/components/format-number/index.ts
+++ b/src/uix/soma/components/format-number/exports.ts
@@ -1,6 +1,6 @@
 // FormatNumber — service component wrapping uix.format.numbers.
 //
-//   import { FormatNumber } from '$uix/eidos/components/format-number';
+//   import { FormatNumber } from '$soma/components/format-number';
 //
 //   <FormatNumber value={1234567} />
 //   <FormatNumber value={42.5} formatStyle="percent" valueAsPercent />
@@ -10,10 +10,14 @@
 // Same family as <Trans>: no CSS recipe, no behaviour, just a typed
 // wrapper around the active runtime API. Reactive to locale and
 // currency preference changes.
-import FormatNumber from './format-number.svelte';
+//
+// Lives under `soma/` (not `eidos/`) because the component owns runtime
+// access. Eidos invariant — "no `getActiveUix()` imports" — is enforced
+// across the visual layer; service components like `Trans` /
+// `FormatDate` / `FormatNumber` / `RelativeTime` are their Soma-side peers.
+export { default as FormatNumber } from './components/format-number.svelte';
+export { default as Provider } from './components/format-number.svelte';
 
-export { FormatNumber };
-export default FormatNumber;
 export type {
 	FormatNumberProps,
 	FormatNumberStyle,
diff --git a/src/uix/soma/components/format-number/index.ts b/src/uix/soma/components/format-number/index.ts
new file mode 100644
index 000000000..8570a426a
--- /dev/null
+++ b/src/uix/soma/components/format-number/index.ts
@@ -0,0 +1 @@
+export * from './exports';
diff --git a/src/uix/eidos/components/format-number/types.ts b/src/uix/soma/components/format-number/types.ts
similarity index 100%
rename from src/uix/eidos/components/format-number/types.ts
rename to src/uix/soma/components/format-number/types.ts
diff --git a/src/uix/eidos/components/relative-time/README.md b/src/uix/soma/components/relative-time/README.md
similarity index 90%
rename from src/uix/eidos/components/relative-time/README.md
rename to src/uix/soma/components/relative-time/README.md
index 89fb0e507..5b7cc9596 100644
--- a/src/uix/eidos/components/relative-time/README.md
+++ b/src/uix/soma/components/relative-time/README.md
@@ -1,4 +1,4 @@
-# Eidos RelativeTime
+# Soma RelativeTime
 
 `<RelativeTime>` es un **service component** que envuelve
 `Intl.RelativeTimeFormat` con auto-refresh tick. Renderiza frases
@@ -7,6 +7,10 @@ cuando pasa el tiempo.
 
 Familia con `<Trans>`, `<FormatDate>`, `<FormatNumber>`.
 
+Vive en `soma/components/` (no `eidos/components/`) porque es una pieza
+de comportamiento alrededor de `getActiveUix()`. La invariante "Eidos no
+importa runtime" se preserva sacando los 4 service components a Soma.
+
 ## Superficie
 
 ```svelte
@@ -58,7 +62,7 @@ Familia con `<Trans>`, `<FormatDate>`, `<FormatNumber>`.
 
 ## Comparativa
 
-| Capacidad | Eidos | date-fns `formatDistance` | Day.js `from` | luxon `toRelative` | Intl.RelativeTimeFormat |
+| Capacidad | Soma | date-fns `formatDistance` | Day.js `from` | luxon `toRelative` | Intl.RelativeTimeFormat |
 | --- | --- | --- | --- | --- | --- |
 | Auto-unit | Si | Si | Si | Si | No (manual) |
 | Auto-tick | Si | No | No | No | No |
diff --git a/src/uix/eidos/components/relative-time/relative-time.svelte b/src/uix/soma/components/relative-time/components/relative-time.svelte
similarity index 94%
rename from src/uix/eidos/components/relative-time/relative-time.svelte
rename to src/uix/soma/components/relative-time/components/relative-time.svelte
index d742c14da..800e903d9 100644
--- a/src/uix/eidos/components/relative-time/relative-time.svelte
+++ b/src/uix/soma/components/relative-time/components/relative-time.svelte
@@ -1,6 +1,6 @@
 <script lang="ts">
 	/**
-	 * Eidos `<RelativeTime>` — service component wrapping
+	 * Soma `<RelativeTime>` — service component wrapping
 	 * `Intl.RelativeTimeFormat` with an auto-refresh tick. Renders
 	 * relative phrases like "hace 2 horas" / "in 3 days" and updates
 	 * itself as time passes so the displayed text stays fresh.
@@ -13,6 +13,11 @@
 	 * Auto-tick cadence is derived from the resolved unit (1s for
 	 * second, 30s for minute, 5min for hour, 1h for day, none above).
 	 * Pass `updateInterval={0}` to render once and stop.
+	 *
+	 * Lives in Soma (not Eidos) because it is a behavior component
+	 * around `getActiveUix().format`, not a visual primitive. Eidos
+	 * remains a pure visual layer; service components like this one
+	 * own the runtime access.
 	 */
 	import { onDestroy } from 'svelte';
 	import { getActiveUix } from '$active-uix';
@@ -20,7 +25,7 @@
 		RelativeTimeInput,
 		RelativeTimeProps,
 		RelativeTimeUnit
-	} from './types';
+	} from '../types';
 
 	let {
 		value = null,
diff --git a/src/uix/soma/components/relative-time/exports.ts b/src/uix/soma/components/relative-time/exports.ts
new file mode 100644
index 000000000..206f51a8e
--- /dev/null
+++ b/src/uix/soma/components/relative-time/exports.ts
@@ -0,0 +1,23 @@
+// RelativeTime — service component rendering Intl.RelativeTimeFormat
+// output ("hace 2 horas" / "in 3 days") with an auto-refresh tick.
+//
+//   import { RelativeTime } from '$soma/components/relative-time';
+//
+//   <RelativeTime value={post.publishedAt} />
+//   <RelativeTime value={createdAt} style="short" />
+//   <RelativeTime value={dueDate} unit="day" updateInterval={0} />
+//
+// Lives under `soma/` (not `eidos/`) because the component owns runtime
+// access. Eidos invariant — "no `getActiveUix()` imports" — is enforced
+// across the visual layer; service components like `Trans` /
+// `FormatDate` / `FormatNumber` / `RelativeTime` are their Soma-side peers.
+export { default as RelativeTime } from './components/relative-time.svelte';
+export { default as Provider } from './components/relative-time.svelte';
+
+export type {
+	RelativeTimeProps,
+	RelativeTimeInput,
+	RelativeTimeUnit,
+	RelativeTimeNumeric,
+	RelativeTimeStyle
+} from './types';
diff --git a/src/uix/soma/components/relative-time/index.ts b/src/uix/soma/components/relative-time/index.ts
new file mode 100644
index 000000000..8570a426a
--- /dev/null
+++ b/src/uix/soma/components/relative-time/index.ts
@@ -0,0 +1 @@
+export * from './exports';
diff --git a/src/uix/eidos/components/relative-time/types.ts b/src/uix/soma/components/relative-time/types.ts
similarity index 100%
rename from src/uix/eidos/components/relative-time/types.ts
rename to src/uix/soma/components/relative-time/types.ts
diff --git a/src/uix/eidos/components/trans/trans.svelte b/src/uix/soma/components/trans/components/trans.svelte
similarity index 82%
rename from src/uix/eidos/components/trans/trans.svelte
rename to src/uix/soma/components/trans/components/trans.svelte
index 050600135..4ae2a10b4 100644
--- a/src/uix/eidos/components/trans/trans.svelte
+++ b/src/uix/soma/components/trans/components/trans.svelte
@@ -1,8 +1,8 @@
 <script lang="ts">
 	/**
-	 * Eidos `<Trans>` — i18n primitive. Resolves an idlangref or path
-	 * through the active langs catalog and renders the translated text
-	 * in a configurable element (default `<span>`).
+	 * Soma `<Trans>` — i18n service component. Resolves an idlangref or
+	 * path through the active langs catalog and renders the translated
+	 * text in a configurable element (default `<span>`).
 	 *
 	 *   <Trans>#?common.save|Save</Trans>                 <!-- children → idlangref -->
 	 *   <Trans value="#?common.save|Save" />              <!-- value prop -->
@@ -13,13 +13,14 @@
 	 * Reactive to locale changes — when the active locale flips, the
 	 * rendered text updates without consumer plumbing.
 	 *
-	 * Designed as a greppable i18n marker — searching `<Trans` finds
-	 * every site that touches the langs catalog, which is much harder
-	 * to audit when consumers call `langs.ts(...)` inline.
+	 * Lives in Soma (not Eidos) because it is a behavior component
+	 * around `getActiveUix().langs`, not a visual primitive. Eidos
+	 * remains a pure visual layer; service components like this one
+	 * own the runtime access.
 	 */
 	import { getActiveUix } from '$active-uix';
 	import type { LangString } from '$libs/langs';
-	import type { TransProps } from './types';
+	import type { TransProps } from '../types';
 
 	let {
 		value,
@@ -72,7 +73,9 @@
 	// `hasSource` is true once we have any source string to render.
 	// While the children-capture path runs $effect on mount, we render
 	// the children initially so the captureNode has text to read.
-	const hasSource = $derived(value !== undefined || path !== undefined || capturedText !== undefined);
+	const hasSource = $derived(
+		value !== undefined || path !== undefined || capturedText !== undefined
+	);
 </script>
 
 <svelte:element this={as} bind:this={captureNode} data-trans="" {...rest}>
diff --git a/src/uix/soma/components/trans/exports.ts b/src/uix/soma/components/trans/exports.ts
new file mode 100644
index 000000000..37cd09a9b
--- /dev/null
+++ b/src/uix/soma/components/trans/exports.ts
@@ -0,0 +1,22 @@
+// Trans — i18n service component. Renders translated text through the
+// active langs catalog (`uix.langs.t / ts`).
+//
+//   import { Trans } from '$soma/components/trans';
+//
+//   <Trans>#?common.save|Save</Trans>
+//   <Trans value="#?common.save|Save" />
+//   <Trans path="common.save">Save</Trans>
+//   <Trans path="common.greet" params={{ name: 'Juan' }} />
+//   <Trans as="strong">#?ui.required|Required</Trans>
+//
+// Reactive to locale changes; greppable as the canonical i18n marker.
+//
+// Lives under `soma/` (not `eidos/`) because the component owns runtime
+// access. Eidos invariant — "no `getActiveUix()` imports" — is enforced
+// across the visual layer; service components like `Trans` /
+// `FormatDate` / `FormatNumber` / `RelativeTime` are their Soma-side
+// peers.
+export { default as Trans } from './components/trans.svelte';
+export { default as Provider } from './components/trans.svelte';
+
+export type { TransProps } from './types';
diff --git a/src/uix/soma/components/trans/index.ts b/src/uix/soma/components/trans/index.ts
new file mode 100644
index 000000000..8570a426a
--- /dev/null
+++ b/src/uix/soma/components/trans/index.ts
@@ -0,0 +1 @@
+export * from './exports';
diff --git a/src/uix/eidos/components/trans/types.ts b/src/uix/soma/components/trans/types.ts
similarity index 66%
rename from src/uix/eidos/components/trans/types.ts
rename to src/uix/soma/components/trans/types.ts
index 020c9fb1d..b3816e3ce 100644
--- a/src/uix/eidos/components/trans/types.ts
+++ b/src/uix/soma/components/trans/types.ts
@@ -3,29 +3,25 @@ import type { HTMLAttributes } from 'svelte/elements';
 import type { LangParams, SupportedLocale } from '$libs/langs';
 
 /**
- * Props for `<Trans>`.
+ * Props for `<Trans>` — i18n service component.
  *
- * Three resolution modes (any one of them activates translation):
+ * Three resolution modes (any one activates translation):
  *
- *   1. **idlangref string in children**
+ *   1. **idlangref in children**
  *      `<Trans>#?common.save|Save</Trans>`
- *      The component reads the children DOM text content. If it
- *      starts with `#?` it's treated as an idlangref; otherwise it
- *      passes through as a literal string.
+ *      Reads the children DOM text. `#?…` → idlangref;
+ *      otherwise literal string.
  *
  *   2. **`value` prop**
  *      `<Trans value="#?common.save|Save" />`
- *      Same idlangref / literal split, but supplied via prop —
- *      cleaner for SSR and dynamic values.
+ *      Same split via prop — cleaner for SSR and dynamic values.
  *
  *   3. **`path` prop**
  *      `<Trans path="common.save">Save</Trans>`
- *      Strips the `#?` prefix — pass the dotted path directly. The
- *      children act as the fallback text. Use this when the consumer
- *      wants type-safety on the path (autocomplete from the langs
- *      schema).
+ *      Dotted path (no `#?` prefix). Supports `params`. Children act as
+ *      the fallback when the path is missing from the catalog.
  *
- * `path` + `params` enable interpolation:
+ * `path` + `params` interpolate:
  *   `<Trans path="common.greet" params={{ name: 'Juan' }} />`
  *
  * `as` swaps the rendered tag (default `<span>`).
@@ -45,9 +41,9 @@ export type TransProps = Omit<HTMLAttributes<HTMLElement>, 'children'> & {
 	 */
 	path?: string;
 	/**
-	 * Interpolation params for `path`-based translations. Ignored
-	 * when `value` (idlangref) is the source — interpolation in
-	 * idlangrefs lives in the inline syntax.
+	 * Interpolation params for `path`-based translations. Ignored when
+	 * `value` is the source — idlangref interpolation lives in the
+	 * inline syntax.
 	 */
 	params?: LangParams;
 	/**
diff --git a/web/routes/uix/components/format-date/+page.svelte b/web/routes/uix/components/format-date/+page.svelte
index 06d1b097f..eea12973d 100644
--- a/web/routes/uix/components/format-date/+page.svelte
+++ b/web/routes/uix/components/format-date/+page.svelte
@@ -4,7 +4,7 @@
 		type FormatDateMode,
 		type FormatDateStyle,
 		type FormatTimeStyle
-	} from '$uix/eidos/components/format-date';
+	} from '$soma/components/format-date';
 	import { compileMorfo } from '$uix/morfo';
 	import { formatDateMorfo } from '@/uix/morfo/components/format-date';
 	import { getActiveUix } from '$active-uix';
@@ -80,7 +80,7 @@
 				<code>{demoLocale}</code>
 			</span>
 			<span data-uix-meta-pill>
-				<span data-uix-meta-key>scope</span>eidos
+				<span data-uix-meta-key>scope</span>soma
 			</span>
 		</div>
 	</header>
diff --git a/web/routes/uix/components/format-number/+page.svelte b/web/routes/uix/components/format-number/+page.svelte
index 5bbd16663..54a7d719b 100644
--- a/web/routes/uix/components/format-number/+page.svelte
+++ b/web/routes/uix/components/format-number/+page.svelte
@@ -1,5 +1,5 @@
 <script lang="ts">
-	import { FormatNumber } from '$uix/eidos/components/format-number';
+	import { FormatNumber } from '$soma/components/format-number';
 	import { compileMorfo } from '$uix/morfo';
 	import { formatNumberMorfo } from '@/uix/morfo/components/format-number';
 	import { getActiveUix } from '$active-uix';
@@ -41,7 +41,7 @@
 	const eidosSnippet = $derived(
 		[
 			"<script lang='ts'>",
-			"  import { FormatNumber } from '$uix/eidos/components/format-number';",
+			"  import { FormatNumber } from '$soma/components/format-number';",
 			'</' + 'script>',
 			'',
 			'<FormatNumber',
@@ -88,7 +88,7 @@
 				<code>{uix.langs.getLocale()}</code>
 			</span>
 			<span data-uix-meta-pill>
-				<span data-uix-meta-key>scope</span>eidos
+				<span data-uix-meta-key>scope</span>soma
 			</span>
 		</div>
 	</header>
diff --git a/web/routes/uix/components/relative-time/+page.svelte b/web/routes/uix/components/relative-time/+page.svelte
index 2f47ede91..7b6512703 100644
--- a/web/routes/uix/components/relative-time/+page.svelte
+++ b/web/routes/uix/components/relative-time/+page.svelte
@@ -4,7 +4,7 @@
 		type RelativeTimeUnit,
 		type RelativeTimeStyle,
 		type RelativeTimeNumeric
-	} from '$uix/eidos/components/relative-time';
+	} from '$soma/components/relative-time';
 	import { compileMorfo } from '$uix/morfo';
 	import { relativeTimeMorfo } from '@/uix/morfo/components/relative-time';
 	import { getActiveUix } from '$active-uix';
@@ -95,7 +95,7 @@
 				<code>{demoLocale}</code>
 			</span>
 			<span data-uix-meta-pill>
-				<span data-uix-meta-key>scope</span>eidos
+				<span data-uix-meta-key>scope</span>soma
 			</span>
 		</div>
 	</header>
diff --git a/web/routes/uix/components/trans/+page.svelte b/web/routes/uix/components/trans/+page.svelte
index 103d195da..daefd11fa 100644
--- a/web/routes/uix/components/trans/+page.svelte
+++ b/web/routes/uix/components/trans/+page.svelte
@@ -1,5 +1,5 @@
 <script lang="ts">
-	import { Trans } from '$uix/eidos/components/trans';
+	import { Trans } from '$soma/components/trans';
 	import { compileMorfo } from '$uix/morfo';
 	import { transMorfo } from '@/uix/morfo/components/trans';
 	import { getActiveUix } from '$active-uix';
@@ -20,7 +20,7 @@
 	const eidosSnippet = $derived(
 		[
 			"<script lang='ts'>",
-			"  import { Trans } from '$uix/eidos/components/trans';",
+			"  import { Trans } from '$soma/components/trans';",
 			'</' + 'script>',
 			'',
 			'<!-- mode 1 — idlangref via children -->',
@@ -72,7 +72,7 @@
 				<code>{uix.langs.getLocale()}</code>
 			</span>
 			<span data-uix-meta-pill>
-				<span data-uix-meta-key>scope</span>eidos
+				<span data-uix-meta-key>scope</span>soma
 			</span>
 		</div>
 	</header>