j3w1 UI Theme Spec 0.1.0

The first public specification of the j3w1 identity: warm-black surfaces, rose text, red focus, 1px square borders, zero radii, one monospace family.

Read it: https://j3w1.github.io/theme/

Use it (agents): pin this tag and follow agents/consume.md. Start at theme.json, then exports/theme.compact.md, then the exports/components/<id>.json you need. Record theme.lock.json and report deviations.

What is in it

• Three profiles. default (approved), heritage-ansi (the sixteen historical Xresources slots, exact) and the proposed extended overlay, as DTCG 2025.10 tokens with provenance on every primitive.
• 47 components across nine families, each specified and demonstrated with a full state matrix; ten carry browser tests. Four composed specimens: settings panel, administrative form, filterable table, and an i3 window frame with the workstation's Chinese status labels.
• The rules that matter: selection is a fill and focus is a ring; nothing is rounded, blurred or glowing; disabled never uses opacity; colour is never the only channel.
• 853 declared contrast pairs, measured unrounded, all passing or carrying a decorative waiver. Sixteen non-examples and eleven stress fixtures are rendered on the page.
• For agents: compact and full Markdown, per-component JSON and copyable briefs, resolved tokens, CSS custom properties, llms.txt, digests. A fresh agent given only the sealed kit reconstructed text-field in all fourteen states and passed the browser judge.

What is not in it

No native application ports are published. The historical gedit, IntelliJ, tmux and browser-extension implementations in j3w1/1w3j are catalogued as references, not downloads. Decisions D-005 to D-012 remain proposed; the roles they cover are implemented as listed and named as pending in the compact export.

MIT for code, tokens and generated data; CC BY 4.0 for the prose and specimens; no fonts are distributed.