Go to file

dev 8190784003 docs: el repositorio, el formato y los guards de texto entran en el corpus; cuatro afirmaciones caducas mueren (documentación del cierre) El plan de cierre cambió cosas de un nivel que el corpus no cubría: la forma del repositorio, la política de formato, el inventario de lo generado y la clase de guard que lee TEXTO fuente. Un inventario previo de todo `docs/` (más los README de raíz, `src/` y `apps/**`) midió qué había: los temas de capa estaban cubiertos, y este nivel no. NUEVO - `docs/repository.md` (E0): las zonas y quién escribe en cada una; la LEY de `web/routes/` congelado y sus dos consecuencias (los validadores de navegador siguen manuales; el formato no llega ahí); un solo install y un solo workspace (el argumento de la copia única de Svelte); un solo mapa de importación con el orden como contrato; qué debe cero y qué debe un ledger que solo mengua. Enlazada desde el mapa, el README de la raíz, getting-started y AGENTS.md. - `docs/testing-and-tooling.md` §Format policy: `.prettierignore` enumerado y justificado (cinco clases), el commit único de formato, el `git config blame.ignoreRevsFile` que hay que ejecutar a mano y que Gitea no lo lee. - `docs/testing-and-tooling.md` §Guards that read source text: la doctrina que faltaba. Un guard de texto está acoplado al formateador; el positivo se pone ROJO y te enteras, el NEGATIVO pasa en VERDE sin inspeccionar nada. Los cinco síntomas medidos en el formateo de una sola vez, seis reglas para escribir uno que no dependa del formato, y los cuatro pasos antes de commitear un formateo masivo (neutralidad compilada, la vista de los guards, los validadores que NO están en el gate, un commit puro). CORREGIDO (afirmaciones vivas y falsas) - `README.md` de la raíz: era una plantilla vacía que mandaba `npm install vicen` con el repositorio `private: true` y sin paquete. Ahora es una puerta. - `AGENTS.md`: su pre-flight INVIOLABLE mandaba leer dos guías del árbol congelado (el canónico está migrado), su ejemplo de test apuntaba a `src/lib/ling/`, borrado en el refactor, y describía cuatro librerías que no existen. Además decía que los comentarios en castellano valen, contra CLAUDE.md. - `docs/theming/guide.md`: los cuatro sitios que llamaban `eidos.listThemes()` DENTRO de `hooks.server.ts`, donde no hay instancia; ahora `THEME_IDS` derivado con `listEidosThemes(config)` del módulo que la raíz también importa. - `docs/architecture/active-uix.md`: la regla 6 decía que la raíz no proyecta preferencias; hoy standalone proyecta por defecto (`projectPrefs`, `@default true`) y attach es opt-in. Su ejemplo de arranque montaba una SEGUNDA proyección a mano. - `announce`: el opt-in queda calificado (motor desnudo) frente al cableado por defecto de las raíces, en `book-deviations.md`, `channels.md:58` y el docblock del canal. - `docs/getting-started.md` y `docs/architecture/morfo.md`: la política de `check:gate` también cubre `scripts/`. - `docs/canon/direction-contract.md`: los dueños literales de la marca (`boot`, `projection-<n>`) pasan a la prosa, citables por un guard. - `src/uix/eidos/components/README.md`: regla 8 — un bindable se reenvía con `bind:`, nunca por el spread del resto (el proxy de rest props no lleva `set`, así que el tipo promete lo que no ata). Con el `ref` en la superficie del `Button` y el gap RESUELTO en `cookie-consent`. `docs/canon/vocabularies.md` y `src/libs/emoji/data.ts` aparecen por fin como artefactos generados, con su comando. Ledger: L-133 · L-142 · L-143 · L-154 a ARREGLADO; L-152 conserva los 532 ficheros pero ya con doctrina escrita; nuevas L-161…L-165 (la última, DIFERIDA: nadie obliga aún a que un guard de texto falle con el corpus vacío). Verificación: `npm run gate` exit 0 en 542 s — lint limpio · check:gate OK (89 de web/ en el ledger) · docs:check 0/0 en 822 docs · suite 466/466 ficheros, 5445/5445 tests · apps:check verde. `component:audit` exit 0 con PASS 161 / NEEDS-WORK 5, las cifras de antes. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>		3 weeks ago
.claude	blocks(hero): la mitad de escritorio no se oculta en el móvil, no existe — y el clip no se pide	2 months ago
.idea	soma: tier 1/2 components, Field/NumberField integration, codex_audit fixes	6 months ago
.kilo/plans	soma: 12 components, architecture docs, naming fixes, form tier complete	6 months ago
.vscode	Initial commit: SvelteKit application with modular libraries	7 months ago
apps/base	feat(apps): apps/base — la primera app que consume UIX como fuente desde un workspace, y su check entra en el gate (F3 del cierre)	3 weeks ago
docs	docs: el repositorio, el formato y los guards de texto entran en el corpus; cuatro afirmaciones caducas mueren (documentación del cierre)	3 weeks ago
routes/web	docs: consolidate kind contract + composition norms (sweep)	5 months ago
scripts	fix(guards): el formateo dejó un guard CIEGO y dos en rojo; reparados y medidos (F5 del cierre, parte 5)	3 weeks ago
src	docs: el repositorio, el formato y los guards de texto entran en el corpus; cuatro afirmaciones caducas mueren (documentación del cierre)	3 weeks ago
static	feat(sema,sound): un pack se entrega como quieras — y un `data:` no se pide, se descodifica	2 months ago
web/routes	fix(blocks): /blocks habla prefs — modo y densidad por uix.prefs, preview sin persistencia, muere el segundo motor de densidad (P2 #5-D)	3 weeks ago
.git-blame-ignore-revs	chore(gate): lint entra el primero en el gate; .git-blame-ignore-revs con el commit de formato; el hook y testing-and-tooling dicen lo que el gate hace hoy (F5 del cierre, parte 4)	3 weeks ago
.gitignore	feat(apps): apps/base — la primera app que consume UIX como fuente desde un workspace, y su check entra en el gate (F3 del cierre)	3 weeks ago
.npmrc	Initial commit: SvelteKit application with modular libraries	7 months ago
.prettierignore	test(focus-census): el guard de la política de foco deja de depender del formato; prettier ignora los dos artefactos generados que tocaba (F5 del cierre, parte 2)	3 weeks ago
.prettierrc	feat(gate): fase B de P0 — la puerta existe y sabe fallar	1 month ago
AGENTS.md	docs: el repositorio, el formato y los guards de texto entran en el corpus; cuatro afirmaciones caducas mueren (documentación del cierre)	3 weeks ago
CLAUDE.md	refactor(build): un solo mapa de alias — uix.aliases.js lo importan vite.config.ts, svelte.config.js, el compilador del boot y docs-check; muere la copia a mano (F2 del cierre)	3 weeks ago
README.md	docs: el repositorio, el formato y los guards de texto entran en el corpus; cuatro afirmaciones caducas mueren (documentación del cierre)	3 weeks ago
STUMBLES.md	style: prettier de una sola vez sobre el repositorio (F5 del cierre, parte 3)	3 weeks ago
package-lock.json	chore(gate): scripts/ entra en el comprobador de tipos y debe cero como src/; fuera csstype, esm-env y generate:contracts-docs; prettier ignora web/ y .claude/ (F5 del cierre, parte 1)	3 weeks ago
package.json	chore(gate): lint entra el primero en el gate; .git-blame-ignore-revs con el commit de formato; el hook y testing-and-tooling dicen lo que el gate hace hoy (F5 del cierre, parte 4)	3 weeks ago
svelte.config.js	style: prettier de una sola vez sobre el repositorio (F5 del cierre, parte 3)	3 weeks ago
tsconfig.json	style: prettier de una sola vez sobre el repositorio (F5 del cierre, parte 3)	3 weeks ago
tsconfig.tsbuildinfo	soma: refactor providers to follow terra patterns, fix translations, add table/number-field	6 months ago
uix.aliases.js	refactor(build): un solo mapa de alias — uix.aliases.js lo importan vite.config.ts, svelte.config.js, el compilador del boot y docs-check; muere la copia a mano (F2 del cierre)	3 weeks ago
vite.config.ts	refactor(build): un solo mapa de alias — uix.aliases.js lo importan vite.config.ts, svelte.config.js, el compilador del boot y docs-check; muere la copia a mano (F2 del cierre)	3 weeks ago

README.md

UIX

A Svelte 5 component system built around a declarative contract: a component is declared once in morfo (parts, data-*/ARIA, keyboard, events with a semantic family and intent), and the other layers read that declaration — soma runs the behavior, sema projects the perceptual signal (sound, haptic, live region), eidos paints against exactly those attributes.

Morfo declares · Soma transcribes · Sema projects · Eidos paints.

This repository is private and consumed as source, not published to npm: an app lives beside the framework as a workspace and imports it through the shared alias table — docs/consuming.md.

Start here

If you want to…	Read
Understand the corpus and find a doc	`docs/README.md` — the map of everything
Run it and make a first change	`docs/getting-started.md`
Know what each zone of the tree is	`docs/repository.md`
Build an app on it	`docs/consuming.md` · `apps/base`
Build or finish a component	`docs/building-a-component.md`
Test, validate, or reformat	`docs/testing-and-tooling.md`

npm install
npm run dev     # the demo site (web/routes — frozen, read-only)
npm run gate    # everything the pre-push hook runs

Agent rules: CLAUDE.md and AGENTS.md.