the design language for the suite, rendered from a versioned source. the language text is canonical in the design language document in the repo’s docs/ tree; its constitution is merged law, and these pages carry it section by section. where a page has a machine source (the design tokens, the decisions log, the haptics chapter), the page is generated from that source and CI fails if it drifts.

every page carries a status badge: LAW, PROPOSAL, or CONCEPT. that’s the roadmap-honesty rule, pointed at the docs themselves, and a CI gate checks each badge against the status its source document records.

• Foundations — tokens, colour/accent law, type, motion, haptics, sound, vector/resolution law, voice, themes & the dynamic base, appearance settings, the capability ladder.
• Device chapters — tray popover, full window, web, mobile touch, small/ambient.
• Components & patterns — anatomy, states, the friction ladder, the cheatsheet.
• Governance — performance budgets, security presentation, decisions log, roadmap labelling, how a rule becomes law, CI gates.