# Eidos Theming — Architecture Reference (moved)

The theming reference moved to the docs corpus (same `§N` numbering — every
historical `§N` citation resolves there):
**[`docs/theming/reference.md`](../../../docs/theming/reference.md)**

Section map:

- **§1** mental model · **§1.bis** theming lives in eidos, not morfo (the
  2-of-3 derivation, the forbidden morfo-import, the canonical split)
- **§2** the CSS layers of the entrypoint · **§3** the 7 token layers
  (scale → primitive → color → component → palette → variant → private)
- **§4** the 9 canonical color roles (mapping = `THEME_BASE_COLOR_ROLES`;
  convention ≠ authorship) · **§5** the size canon (universal 1:1
  size→font; label one step below; container cap at `md`; icon scale)
- **§6** naming conventions (the public-prefix table + the 7 strict rules)
- **§7** TSC → [`docs/canon/tsc.md`](../../../docs/canon/tsc.md) ·
  **§8/§9** how-tos → [`docs/theming/guide.md`](../../../docs/theming/guide.md)
- **§10** runtime overrides + the builders (`applyColorScheme`,
  `applyTypeScale`) · **§11** bundle strategy + `eidos:purge` ·
  **§12** validation tooling
- **§13** superseded (`event:*` scope) · **§14** motion (the theming side:
  the `--motion-scale-lift` pickup) — the model lives in
  [`docs/theming/motion.md`](../../../docs/theming/motion.md)
- **§15/§17** comparison + FAQ →
  [`docs/theming/notes.md`](../../../docs/theming/notes.md) ·
  **§16** anti-patterns · **§18** → TSC ·
  **§19** variants are eidos canon (`EIDOS_VARIANTS`)
- **§20–§38** standing-decision stubs; the chronicle is
  [`docs/theming/changelog.md`](../../../docs/theming/changelog.md)
  (§23 scaling · §25 color model · §26 theme builder · §28 forced-colors ·
  §29 depth · §30 shape · §31 structure · §32 focus ring · §35 scale canon ·
  §36 floating gap · §37 touch-target · §38 state layer)

Quick pointers: recipes in [`lib/recipes/base.ts`](./lib/recipes/base.ts);
themes in [`lib/themes/base.ts`](./lib/themes/base.ts); generator in
[`lib/render-css.ts`](./lib/render-css.ts); guards in
[`recipe-css-contract.test.ts`](./recipe-css-contract.test.ts) +
`component-audit` R-4.x
([`docs/canon/recipe-contract.md`](../../../docs/canon/recipe-contract.md)).