[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_1020":1021,"_1022":1023},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":-7,"_18":19,"_17":-7,"_756":-5,"_20":757,"_22":758,"_759":760,"_761":762,"_26":763,"_24":764,"_765":-5,"_766":-5,"_767":54,"_768":769,"_770":46,"_771":-5,"_772":-5,"_773":774},"routes/_app.x.$handle.$name.code.$",{"_11":12,"_13":14,"_15":16,"_17":-7,"_18":19,"_20":21,"_22":23,"_24":25,"_26":27,"_28":-5,"_29":-5,"_30":-5,"_31":-5,"_32":-5},"handle","nbbaier","name","kyla-ui","branchName","main","version","path","docs/reference","project",{"_34":699,"_13":14,"_47":700,"_701":-5,"_702":54,"_703":704,"_705":704,"_706":707,"_708":-5,"_709":710,"_711":-5,"_712":54,"_713":-5,"_714":-5,"_715":63,"_716":717,"_718":719,"_720":721,"_722":723,"_724":-5,"_725":726,"_727":726,"_728":729,"_730":729,"_731":729,"_732":726,"_733":726,"_734":735,"_736":737,"_738":739,"_740":54},"tree",[66,67,68,69,70,71,72,73,74,75],"file",{"_34":59,"_13":58,"_37":40,"_39":60,"_41":42,"_43":61,"_45":46,"_47":62,"_17":63,"_50":64,"_51":-5,"_53":54,"_55":-5,"_18":65},"contents",[33],"upstream","pull","ahead","behind","envVars",{"_34":35,"_13":36,"_37":38,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_17":49,"_50":24,"_51":52,"_53":54,"_55":-5,"_18":56},"id","215dc930-a2db-4e41-aef0-9c14d133f215","val-town-style-guide.md","fileId","c81d8562-798e-11f1-8388-1607ee4eb77e","parentId","c798cbce-798e-11f1-b338-1607ee4eb77e","branchId","687a9437-44a8-49ca-94d7-3277b6842513","branchVersion",268,"latest",true,"createdAt",["D",1784076371333],5,"fileType","content","# Val Town UI style guide — design tokens reference\n\nResearch reference for ADR-0005\n(`docs/adr/0005-val-town-visual-language-default-theme.md`) and the\nscales/palette PRD (`docs/issues/structural-scales-palette/spec.md`). Extracted\n2026-07-06.\n\n## What was found, and from where\n\nVal Town's marketing/app site is a **Remix SSR** application, so a plain HTTP\n`GET` of each `https://www.val.town/_ui/` page returns the **real,\nserver-rendered component markup** — every element with its full Tailwind\nutility class list. The token layer lives in the site's compiled Tailwind **v4**\nstylesheet, linked from every page and served from\n`https://static2.esm.town/assets/tailwind-.css` (current hash at\nextraction time: `tailwind-Dy1Hj0e7.css`). That file contains the Tailwind v4\n`@theme` block (the full `--color-*` scale in **oklch**, plus `--spacing`,\n`--radius-*`, `--text-*`, `--font-weight-*`) **and** Val Town's own semantic\ncolor aliases split across the light `@theme`/`:root` layer and a `.dark {…}`\nblock.\n\n**This is the primary, authoritative source** and it is machine-readable\nend-to-end: component class lists → utility classes → resolved token values, all\nfrom the live site.\n\nA **secondary** source — the val **`dcm31/townie-mobile`**, `frontend/style.css`\n(read via the Val Town MCP `read_file`) — is the distilled token set its author\nhand-fed to Fable. It agrees with the live site on the design _language_\n(slate + sky, IBM Plex Sans, iA Writer Quattro eyebrows, dark-ink-on-accent, 8px\nradius) but its literal hex values are **Tailwind v3** (e.g.\n`--vt-sky: #38bdf8`), which differ numerically from the live site's Tailwind\n**v4** oklch derivations (`sky-400` → `#00bcff`). Reconciliation is called out\nbelow.\n\n### Colour-space note\n\nThe live tokens are **oklch** (Tailwind v4). Every hex in this doc is a\n**computed** oklch→sRGB conversion (D65, standard sRGB transfer). Hexes are\nlabelled as computed; the oklch string is the source-of-truth value. Contrast\nratios are likewise computed from those sRGB values.\n\n### Reconciliation: townie-mobile (v3 hex) vs live `_ui` (v4 oklch)\n\n| Role | townie `style.css` (v3 literal) | live `_ui` (v4 oklch → computed hex) | Agree? |\n| ----------- | --------------------------------------- | --------------------------------------------------- | -------------------------------------- |\n| Accent | `--vt-sky #38bdf8` (sky-400) | `sky-400` `oklch(74.6% .16 232.661)` → `#00bcff` | Same token name; v4 hex more saturated |\n| Deep accent | `--vt-sky-deep #0369a1` (sky-700) | `sky-700` `oklch(50% .134 242.749)` → `#0069a8` | Same name, v4 slightly different |\n| Border | `--vt-border #e2e8f0` (slate-200) | `slate-200` `oklch(92.9% .013 255.508)` → `#e2e8f0` | **Identical** |\n| Accent-fg | send btn `text-sky-950` on `bg-sky-400` | primary btn `text-sky-950` on `bg-sky-400` | **Identical convention** |\n\nBoth confirm **VT = Tailwind slate + sky**. Treat the **live `_ui` v4 oklch\nvalues as current source of truth**; townie's hexes are the older/hand-distilled\nvariant.\n\n---\n\n## 1. Color palette\n\n### 1a. Val Town semantic aliases (the actual theme layer)\n\nVT defines exactly **five** semantic color tokens, each aliased to a raw scale\nstep, with a light default (in the `@theme`/root layer) and a `.dark` override.\nSource: `tailwind-Dy1Hj0e7.css`, `:root`/`@theme` and `.dark{…}` blocks\n(verbatim property names).\n\n| Semantic token | Light → raw | Light hex (computed) | Dark → raw | Dark hex (computed) |\n| -------------------- | ------------------- | -------------------- | ------------------- | ------------------- |\n| `--color-background` | `--color-white` | `#ffffff` | `--color-black` | `#000000` |\n| `--color-text` | `--color-black` | `#000000` | `--color-white` | `#ffffff` |\n| `--color-border` | `--color-slate-200` | `#e2e8f0` | `--color-slate-700` | `#314158` |\n| `--color-muted` | `--color-gray-600` | `#4a5565` | `--color-gray-300` | `#d1d5dc` |\n| `--color-shadow` | `--color-gray-50` | `#f8fafc`* | `--color-gray-900` | `#101828`* |\n\nVerbatim:\n`.dark{--color-text:var(--color-white);--color-background:var(--color-black);--color-border:var(--color-slate-700);--color-muted:var(--color-gray-300);--color-shadow:var(--color-gray-900)}`\nand light\n`--color-text:var(--color-black);--color-background:var(--color-white);--color-border:var(--color-slate-200);--color-muted:var(--color-gray-600);--color-shadow:var(--color-gray-50)`.\n(*`--color-shadow` gray hexes are approximate; used as a shadow tint, not a\nsurface.)\n\nNotable: **dark-mode background is true black** (`#000`) with true-white text —\nan OLED-style maximum-contrast choice, not a dark-gray. There is **no** semantic\ntoken for elevated / recessed surfaces or for accent — those come from raw\n`sky-*`/`slate-*` utilities in the components (§1b, §5).\n\n### 1b. Raw scale steps used across components (Tailwind v4 oklch)\n\nEvery value below is a class observed in live `_ui` component markup. oklch is\nthe source value; hex is computed. Full scales for slate/sky/rose/emerald/gray\nexist in the file; these are the steps actually referenced.\n\n**Neutrals — `slate` (structure) and `gray` (muted text)**\n\n| Token | oklch | Hex (computed) | Role in `_ui` |\n| ----------- | --------------------------- | -------------- | ------------------------------------------------------- |\n| `white` | `#fff` | `#ffffff` | Base surface (light) |\n| `slate-50` | `oklch(98.4% .003 247.858)` | `#f8fafc` | Secondary button fill (light); read-only input bg |\n| `slate-100` | `oklch(96.8% .007 247.896)` | `#f1f5f9` | Default button fill; soft/filled input fill (light) |\n| `slate-200` | `oklch(92.9% .013 255.508)` | `#e2e8f0` | **Border** (`--color-border` light) |\n| `slate-300` | `oklch(86.9% .022 252.894)` | `#cad5e2` | Input border (light); hover border on filled input |\n| `slate-400` | `oklch(70.4% .04 256.788)` | `#90a1b9` | Input hover border (light) |\n| `slate-700` | `oklch(37.2% .044 257.287)` | `#314158` | **Border** (`--color-border` dark); input border (dark) |\n| `slate-800` | `oklch(27.9% .041 260.031)` | `#1d293d` | Default button fill (dark); soft input fill (dark) |\n| `slate-900` | `oklch(20.8% .042 265.755)` | `#0f172b` | Secondary button fill (dark); read-only input bg (dark) |\n| `slate-950` | `oklch(12.9% .042 264.695)` | `#020618` | (deepest neutral) |\n| `gray-300` | `oklch(87.2% .01 258.338)` | `#d1d5dc` | **Muted text** (`--color-muted` dark) |\n| `gray-600` | `oklch(44.6% .03 256.802)` | `#4a5565` | **Muted text** (`--color-muted` light) |\n| `black` | `#000` | `#000000` | Text (light); base (dark) |\n\n**Accent — `sky`**\n\n| Token | oklch | Hex (computed) | Role in `_ui` |\n| --------- | --------------------------- | -------------- | ---------------------------------------------- |\n| `sky-50` | `oklch(97.7% .013 236.62)` | `#f0f9ff` | Secondary/clear button hover fill (light) |\n| `sky-100` | `oklch(95.1% .026 236.824)` | `#dff2fe` | Default button hover fill; active card (light) |\n| `sky-200` | `oklch(90.1% .058 230.902)` | `#b8e6fe` | Default button active; accent text (dark) |\n| `sky-300` | `oklch(82.8% .111 230.318)` | `#74d4ff` | **Input focus ring** |\n| `sky-400` | `oklch(74.6% .16 232.661)` | `#00bcff` | **Primary button fill (light)** — the accent |\n| `sky-500` | `oklch(68.5% .169 237.323)` | `#00a6f4` | **Button focus ring**; input focus border |\n| `sky-700` | `oklch(50% .134 242.749)` | `#0069a8` | **Primary button fill (dark)** |\n| `sky-800` | `oklch(44.3% .11 240.79)` | `#00598a` | Accent text on light (hover/aria-current) |\n| `sky-950` | `oklch(29.3% .066 243.157)` | `#052f4a` | **Text on `sky-400` primary fill (light)** |\n\n**Danger — `rose`; Success — `emerald`**\n\n| Token | oklch | Hex (computed) | Role |\n| ------------- | --------------------------- | -------------- | ----------------------------------------- |\n| `rose-50` | `oklch(96.9% .015 12.422)` | `#fff1f2` | Private privacy-badge bg |\n| `rose-300` | `oklch(81% .117 11.638)` | `#ffa1ad` | **Danger button fill (light)** |\n| `rose-400` | `oklch(71.2% .194 13.428)` | `#ff637e` | Danger button hover; focus ring |\n| `rose-800` | `oklch(45.5% .188 13.697)` | `#a50036` | **Danger button fill (dark)**; badge text |\n| `rose-950` | `oklch(27.1% .105 12.094)` | `#4d0218` | **Text on danger fill (light)** |\n| `emerald-100` | `oklch(95% .052 163.051)` | `#d0fae5` | Public privacy-badge bg |\n| `emerald-400` | `oklch(76.5% .177 163.223)` | `#00d492` | **Success/green button fill (light)** |\n| `emerald-950` | `oklch(26.2% .051 172.552)` | `#002c22` | Text on success fill (light) |\n\nAlso referenced: `red-300`/`red-700` for input invalid rings; `amber-*` and\n`blue-*` for callout variants; `orange-*` for the \"unlisted\" privacy badge.\n\n---\n\n## 2. Spacing scale\n\n`--spacing: .25rem` → **base unit 4px** (Tailwind v4 default; all\n`gap-*`/`p-*`/`h-*`/`w-*` utilities are multiples of it). No bespoke VT spacing\ntokens. Container widths are also defined\n(`--container-xs 20rem … --container-7xl 80rem`) if a max-width scale is needed.\n\nComponent-level spacing is captured per component in §5.\n\n---\n\n## 3. Border-radius scale\n\nFrom the `@theme` block (verbatim):\n\n| Token | rem | px | Where used in `_ui` |\n| -------------- | --------- | ------- | ------------------------------------------------------------------------------ |\n| `--radius-xs` | `.125rem` | 2px | — |\n| `--radius-sm` | `.25rem` | 4px | — |\n| `--radius-md` | `.375rem` | 6px | — |\n| `--radius-lg` | `.5rem` | **8px** | **Buttons, inputs, selects, textareas, cards, sidebar panels** (the workhorse) |\n| `--radius-xl` | `.75rem` | 12px | Large buttons; callouts |\n| `--radius-2xl` | `1rem` | 16px | — |\n| `--radius-3xl` | `1.5rem` | 24px | — |\n| `rounded-full` | 9999px | — | Privacy badges, pills |\n\nCanonical control radius = **8px (`rounded-lg`)**; large controls step up to\n12px (`rounded-xl`). Matches townie's \"8px radius.\"\n\n---\n\n## 4. Typography\n\n**Font families** (from `tailwind-.css` `html` rule + `app.css`\n`@font-face`)\n\n| Role | Stack | Source |\n| ----------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------- |\n| Sans (body/UI) | `\"IBM Plex Sans\", -apple-system, sans-serif` | `html,:host{…font-family:IBM Plex Sans,-apple-system,sans-serif;line-height:1.5}` |\n| Mono | `\"iA Writer Mono\", \"Menlo\", \"Consolas\", \"ui-monospace\", monospace` | `--font-mono` |\n| Eyebrow / display | `\"iA Writer Quattro\"` (weights 400/700, normal+italic) | `app.css` `@font-face` blocks |\n\n**Type scale** (`--text-*` with paired `--line-height`, verbatim)\n\n| Token | size | line-height (computed) | approx px |\n| ----------- | ----------------- | ---------------------------- | --------- |\n| `text-xs` | `.75rem` (12px) | `calc(1 / .75)` = 1.333 | 12 / 16 |\n| `text-sm` | `.875rem` (14px) | `calc(1.25 / .875)` = 1.429 | 14 / 20 |\n| `text-base` | `1rem` (16px) | `1.5` | 16 / 24 |\n| `text-lg` | `1.125rem` (18px) | `calc(1.75 / 1.125)` = 1.556 | 18 / 28 |\n| `text-xl` | `1.25rem` (20px) | `calc(1.75 / 1.25)` = 1.4 | 20 / 28 |\n| `text-2xl` | `1.5rem` (24px) | `calc(2 / 1.5)` = 1.333 | 24 / 32 |\n| `text-3xl` | `1.875rem` (30px) | `1.2` | 30 / 36 |\n\nControls (buttons/inputs) default to `text-sm` (14/20). `text-[11px]` is used\nfor privacy badges. Default body line-height is `1.5`.\n\n**Font weights** (`--font-weight-*`): normal 400, medium 500, semibold 600, bold\n700, extrabold 800. Buttons are **`font-bold` (700)**; badges are\n**`font-semibold` (600)**; inputs/selects `font-normal` (400).\n\n---\n\n## 5. Component-level styling specs\n\nAll class lists below are verbatim from live `_ui` SSR markup\n(`www.val.town/_ui/`), condensed to the meaningful tokens (dropped the\nlong `[&:not([disabled])]:` guards where they only wrap a hover/active listed\nhere).\n\n### Button (`/_ui/button`)\n\n**Base:**\n`inline-flex items-center justify-center gap-x-2 shrink-0 whitespace-nowrap\nselect-none cursor-pointer disabled:cursor-not-allowed disabled:opacity-50 outline-0\nfocus-visible:ring-2 transition font-bold`\n\n**Sizes:** `sm` = `text-sm h-8 px-3 rounded-lg` · `md`(default) =\n`text-sm h-10 px-4\nrounded-lg` · `lg` = `text-base h-12 px-5 rounded-xl`.\nIcon-only appends `!px-0 w-8` (sm) / `w-10` (md).\n\n**Focus ring:** `ring-2 ring-sky-500` (rose-400 for danger, emerald-500 for\ngreen, slate-700 for blend).\n\n| Variant | Light fill / text / border | Light hover → active | Dark fill / text | Dark hover → active |\n| ----------- | --------------------------------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------- | --------------------------------------------------------- |\n| `default` | `bg-slate-100 text-slate-800` | `bg-sky-100 text-sky-800` → `bg-sky-200` | `bg-slate-800 text-slate-200` | `bg-sky-900 text-sky-200` → `bg-slate-800` |\n| `primary` | `bg-sky-400 text-sky-950` border-transparent | `bg-sky-500` → `bg-sky-600` | `bg-sky-700 text-white` | `bg-sky-600` → `bg-sky-700` |\n| `secondary` | `bg-slate-50 text-black border-slate-200` | `bg-sky-50 text-sky-800 border-sky-200` → `bg-sky-100` | `bg-slate-900 text-white border-slate-800` | `bg-sky-900 text-sky-200 border-sky-500` → `bg-slate-800` |\n| `clear` | `text-black` (no fill) | `text-sky-800 bg-sky-500/10` → `bg-sky-500/5` | `text-white` | `text-sky-200 bg-sky-500/40` → `bg-sky-500/20` |\n| `danger` | `bg-rose-300 text-rose-950` border-transparent | `bg-rose-400` → `bg-rose-500` | `bg-rose-800 text-white` | `bg-rose-700` → `bg-rose-800` |\n| `green` | `bg-emerald-400 text-emerald-950` border-transparent | `bg-emerald-500` → `bg-emerald-600` | `bg-emerald-700 text-white` | `bg-emerald-600` → `bg-emerald-700` |\n| `blend` | `mix-blend-color-burn bg-slate-500 text-black border-slate-700` | `bg-slate-600` → `bg-slate-700` | `mix-blend-color-dodge bg-slate-500 text-white border-slate-400` | `bg-slate-400` → `bg-slate-300` |\n\nKey convention: **primary/danger/green fills use a dark-ink-on-bright-color\npairing in light mode** (`text-sky-950`/`text-rose-950`/`text-emerald-950`) and\nflip to **white ink on a deeper fill in dark mode** (`text-white` on\n`sky-700`/`rose-800`/`emerald-700`).\n\n### Input / Select / Textarea (`/_ui/input`, `/select`, `/textarea`)\n\n**Base:**\n`block w-full border outline-0 transition disabled:cursor-not-allowed\ndisabled:opacity-50 text-sm h-10 px-3 rounded-lg`.\nsm = `h-8 px-2`.\n\n- **Default variant:** `bg-background text-black border-slate-300`, hover\n `border-slate-400`; dark `text-white border-slate-700`, hover\n `border-slate-600`. (Note it uses the semantic `bg-background` token, so field\n bg = white/black by mode.)\n- **Filled/soft variant:** `bg-slate-100 text-black border-transparent`, hover\n `border-slate-300`; dark `bg-slate-800 text-white`, hover `border-slate-700`.\n- **Focus:** `focus-visible:ring-2 focus-visible:ring-sky-300` +\n `focus-visible:border-sky-500`.\n- **Invalid** (`aria-invalid`/`user-invalid`): `ring-red-300 border-red-300`\n (dark `ring-red-700 border-red-700`), hover `border-red-400`.\n- **Read-only:** `read-only:bg-slate-50` (dark `bg-slate-900`).\n- **Disabled:** `opacity-50 cursor-not-allowed`.\n- **Select** adds `appearance-none pr-10 cursor-pointer`; **Textarea** adds\n `h-auto py-2`; a `code` content variant adds `font-mono`.\n\n### Card (`/_ui/card`)\n\nSurface uses `bg-background`, `border`, `rounded-lg`, `transition`; hover\n`hover:border-blue-400 dark:hover:border-blue-600 hover:shadow-lg` (note: cards\nhover **blue**, not sky). BigCard is the larger variant.\n\n### Callout (`/_ui/callout`)\n\n**Base:**\n`flex flex-wrap items-center gap-2 pl-4 pr-2 py-2 min-h-12 text-sm rounded-xl\nborder`.\nColor variants (light → dark):\n\n- info/blue: `text-blue-800 bg-blue-50 border-blue-100` →\n `text-blue-200 bg-blue-950 border-blue-900`\n- warning/amber: `text-amber-800 bg-amber-100 border-amber-200` →\n `text-amber-100 bg-amber-950 border-amber-900`\n\n### Privacy Badge (`/_ui/privacy-badge`)\n\n**Base:**\n`inline-flex items-center justify-center font-semibold text-[11px] h-5\nmin-w-[56px] rounded-full px-2`.\nVariants:\n\n- public: `text-emerald-800 bg-emerald-100 saturate-50`\n- private: `text-rose-800 bg-rose-50`\n- unlisted: `text-orange-800 bg-orange-50`\n\n### Dropdown / panel (`/_ui/dropdown`)\n\nFloating panel: `bg-background rounded-lg shadow-lg` (width `w-64`, margin\n`m-2`).\n\n### Shadows\n\nTailwind defaults (`shadow-lg` on cards/panels/dropdowns). The `--color-shadow`\nsemantic token (gray-50 light / gray-900 dark) tints shadow color per mode.\ntownie additionally used custom `0 2px 12px rgba(15,23,42,.05)` composer shadows\n(slate-tinted).\n\n---\n\n## 6. Mapping onto Kylä tokens\n\nKylä `--kyla-*` mapped from Val Town values. The VT source columns and notes\npreserve the live `_ui` Tailwind v4 research (semantic aliases + component\nusage); the light/dark columns report Kylä's shipped values, including\ndocumented sanctioned deviations. Hexes are computed from oklch unless noted.\n\n| Kylä token | VT source | Kylä light | Kylä dark | Notes |\n| -------------------- | -------------------------------------- | ------------------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `--kyla-base` | `--color-background` | `#ffffff` (white) | `#020618` (`slate-950`) | VT's source value is true black `#000000`; Kylä ships the ADR-0005 sanctioned slate-950 softening to reduce glare. |\n| `--kyla-elevated` | _(no VT token)_ | `#ffffff` + shadow | `#0f172b` (`slate-900`) | VT has no elevated-fill token in light; raise via `shadow-lg`. In dark, `slate-900` (secondary-button fill) is the natural raised surface. See Gaps. |\n| `--kyla-recessed` | component `bg-slate-100`/`bg-slate-50` | `#f1f5f9` (`slate-100`) | `#1d293d` (`slate-800`) | Filled input / default-button wells. `slate-50 #f8fafc` is a shallower recess (secondary btn, read-only). |\n| `--kyla-fg` | `--color-text` | `#000000` | `#ffffff` | true-black / true-white. |\n| `--kyla-fg-muted` | `--color-muted` | `#4a5565` (`gray-600`) | `#d1d5dc` (`gray-300`) | VT's real, now-sourced muted token — AA-safe both modes (§7). Supersedes the earlier `slate-700` guess; the two are near-equivalent (`gray-600` 7.56:1, `slate-700` 10.36:1) — either is fine, `gray-600` is the literal VT value. Definitely **not** `slate-400`. |\n| `--kyla-line` | `--color-border` | `#e2e8f0` (`slate-200`) | `#314158` (`slate-700`) | The one VT border token. Note controls use `slate-300`/`slate-700` for _field_ borders — a touch stronger than the panel border. |\n| `--kyla-hairline` | _(no VT token)_ | `#f1f5f9` (`slate-100`) | `#1d293d` (`slate-800`) | VT has no lighter-than-border token; Kylä ships one step lighter (light) / the elevated fill (dark). See Gaps. |\n| `--kyla-accent` | primary button fill | `#00bcff` (`sky-400`) | `#0069a8` (`sky-700`) | VT's accent **changes by mode**: bright sky-400 in light, deeper sky-700 in dark. Focus rings use `sky-500 #00a6f4`. |\n| `--kyla-accent-fg` | primary button text | `#052f4a` (`sky-950`, dark ink) | `#ffffff` (white) | Dark ink on the bright light-mode fill; white on the deep dark-mode fill. **Never white on sky-400** (§7). |\n| `--kyla-accent-ring` | focus ring | `#00a6f4` (`sky-500`) | `#00a6f4` (`sky-500`) | Dedicated focus affordance rather than overloading the fill token. |\n| `--kyla-accent-text` | accent text on surfaces | `#00598a` (`sky-800`) | `#b8e6fe` (`sky-200`) | Mode-aware accent text used separately from filled-button ink. |\n| `--kyla-danger` | danger button fill | `#ffa1ad` (`rose-300`) | `#a50036` (`rose-800`) | Pale rose w/ dark ink (light) → deep rose w/ white (dark). |\n| `--kyla-danger-fg` | danger button text | `#4d0218` (`rose-950`) | `#ffffff` | Shipped semantic ink token for the danger fill. |\n| `--kyla-danger-text` | danger text on surfaces | `#a50036` (`rose-800`) | `#ffc9d4` (`rose-200`) | Mode-aware danger text, the counterpart to `--kyla-accent-text`; the `danger` fill is 1.4:1 on white and cannot double as text. Light is VT's sourced badge-text value (`rose-800`, §5); dark has no VT source and mirrors `accent-text`'s 200-step choice. |\n| `--kyla-success` | success/green button fill | `#00d492` (`emerald-400`) | `#007a55` (`emerald-700`) | Shipped semantic success fill. |\n| `--kyla-success-fg` | success/green button text | `#002c22` (`emerald-950`) | `#ffffff` | Shipped semantic ink token for the success fill. |\n| `--kyla-radius` | `--radius-lg` | `8px` | `8px` | Consumer-overridable base for the shipped `sm` / `md` / `lg` derivations. |\n\nScale-level (needed by the PRD):\n\n| Concept | VT value (light = dark unless noted) |\n| --------------- | ----------------------------------------------------------------------- |\n| Spacing base | `--spacing: .25rem` = 4px |\n| Radius scale | 2 / 4 / 6 / 8 / 12 / 16 / 24 px (`xs…3xl`); control default 8 |\n| Sans | `\"IBM Plex Sans\", -apple-system, sans-serif` |\n| Mono | `\"iA Writer Mono\", \"Menlo\", \"Consolas\", \"ui-monospace\", monospace` |\n| Eyebrow/display | `\"iA Writer Quattro\"` (400/700) |\n| Body type | `text-base` 16px / lh 1.5; controls `text-sm` 14/20 |\n| Weights | 400 / 500 / 600 / 700 / 800; buttons 700, badges 600 |\n| Hues | accent = sky · danger = rose · success = emerald · neutral = slate/gray |\n\nKylä deliberately exposes a supported subset of those upstream scales. The\ndelivered spacing steps are `0, 1, 2, 3, 4, 5, 6, 8, 10, 12, 16, 20, 24` on the\n4px base. Its radius roles are `sm`, `md`, and `lg`, derived as 4px / 8px / 12px\nfrom the consumer-overridable 8px base. `src/theme/tokens.ts` remains the\nexecutable source of truth for these names and values.\n\n---\n\n## 7. Gaps and AA concerns\n\n### Gaps — Kylä tokens with no direct VT semantic equivalent\n\n- **`--kyla-elevated`, `--kyla-recessed`, `--kyla-hairline`:** VT's semantic\n layer is only `background / text / border / muted / shadow`. There is **no**\n token for a second surface level. In light mode VT elevates by shadow over the\n same white; recessed/hairline surfaces come from raw `slate-50`/`slate-100`\n fills at the component level. Kylä's shipped values are the observed component\n fills, not named VT tokens — a deliberate extrapolation retained in the\n current palette.\n- **Filled-role foreground split:** VT expresses \"ink on a colored fill\" per\n component (dark-950 in light, white in dark) rather than as a token. Also, VT\n uses several distinct accent roles a single `--kyla-accent`/`--kyla-accent-fg`\n can't hold: **fill** (`sky-400`/`sky-700`), **focus ring** (`sky-500`, inputs\n `sky-300`), and **accent text on a surface** (`sky-800` light / `sky-200`\n dark, used for hover/aria-current). Kylä therefore ships `--kyla-accent-fg`,\n `--kyla-accent-ring`, and `--kyla-accent-text` as separate roles.\n\n### VT tokens/roles Kylä has no home for\n\n- **`--color-shadow`** (gray-50 light / gray-900 dark) — a mode-aware shadow\n tint; Kylä has no shadow token.\n- **Field border ≠ panel border:** inputs use `slate-300`/`slate-700`, panels\n use `slate-200`/`slate-700` (`--color-border`). Kylä's single `--kyla-line`\n flattens this.\n- **Semantic status set beyond the shipped danger/success pair:** VT also uses\n `amber`/`blue` (callouts) and `orange` (unlisted badge), which Kylä does not\n currently expose as semantic roles.\n- **`blend` button** (`mix-blend-color-burn`/`-dodge`) — a mode-adaptive\n technique, no token.\n\n### WCAG AA (ratios **computed** from oklch→sRGB; 4.5:1 body, 3:1 large/UI)\n\n| Foreground | Background | Ratio | Verdict |\n| ------------------------------- | ---------------------------- | ----------- | ----------------------------------------------------------------------------- |\n| `text` black | `background` white (light) | **21.0:1** | Pass AAA |\n| `text` white | `background` black (dark) | **21.0:1** | Pass AAA |\n| `muted` gray-600 | white (light) | **7.56:1** | Pass |\n| `muted` gray-300 | black (dark) | **14.26:1** | Pass |\n| primary `sky-950` | `sky-400` fill (light) | **6.37:1** | Pass |\n| primary white | `sky-700` fill (dark) | **5.86:1** | Pass |\n| default `slate-800` | `slate-100` fill (light) | **13.34:1** | Pass |\n| default-hover `sky-800` | `sky-100` (light) | **6.53:1** | Pass |\n| danger `rose-950` | `rose-300` fill (light) | **8.19:1** | Pass |\n| danger white | `rose-800` fill (dark) | **7.92:1** | Pass |\n| green `emerald-950` | `emerald-400` fill (light) | **7.83:1** | Pass |\n| `slate-700` (field border/text) | white | **10.36:1** | Pass |\n| **white** | **`sky-400`** (anti-pattern) | **2.18:1** | **FAIL** — do not put white on the light accent; VT correctly uses `sky-950`. |\n\nTakeaways for Kylä:\n\n1. Every default VT foreground/surface pairing clears AA comfortably (5.9–21:1)\n in **both** modes — safe to adopt wholesale.\n2. `--kyla-accent-fg` must be **dark ink (`sky-950`) in light** and **white in\n dark**; a single fixed value can't serve both because `sky-400` needs dark\n ink (white fails at 2.18:1) while `sky-700` needs white.\n3. `--kyla-fg-muted` = `gray-600` (light) / `gray-300` (dark) is AA-safe; keep\n the mode split rather than one value.\n4. Note the deliberate **true-black dark background** — visually aggressive\n (21:1); fine for AA, but worth a conscious call vs a softer\n `slate-950 #020618` if Kylä prefers less glare.\n\n---\n\n## 8. Sources\n\n**Primary — live `_ui` (Remix SSR, plain HTTPS GET; class lists verbatim):**\n\n1. `https://www.val.town/_ui/button`, `/callout`, `/card`, `/dropdown`,\n `/input`, `/select`, `/textarea`, `/forms`, `/privacy-badge` —\n server-rendered component markup with full Tailwind class lists (cited per\n component in §5).\n2. `https://static2.esm.town/assets/tailwind-Dy1Hj0e7.css` — compiled Tailwind\n v4 stylesheet: the `@theme` `--color-*` (oklch) / `--spacing` / `--radius-*`\n / `--text-*` / `--font-weight-*` tokens, the `html` font-family rule, and\n VT's semantic aliases in the root layer + `.dark{…}` block (all quoted\n verbatim in §1a, §3, §4). Hash read from the pages' ``\n tags.\n3. `https://static2.esm.town/assets/_app-*.css` — `@font-face` for iA Writer\n Quattro (400/700, normal+italic).\n\n**Secondary — distilled token set (via Val Town MCP `read_file`):** 4.\n`dcm31/townie-mobile` → `frontend/style.css` — `--vt-sky #38bdf8`,\n`--vt-sky-deep\n #0369a1`, `--vt-border #e2e8f0` (Tailwind **v3** hexes), IBM\nPlex Sans body, iA Writer Quattro eyebrow (10px/700/0.14em uppercase).\nReconciled against the live v4 values in the intro; agrees on token names and\nthe dark-ink-on-accent convention, differs on exact hex.\n\n**Value resolution / conversion:** 5. oklch→sRGB hex and all §7 contrast ratios\nare **computed** (D65 sRGB), not read from a source. oklch strings in §1 are the\nsource-of-truth values.\n\n**Informal, non-verbatim signal (not used for any concrete value in this doc):**\n6. `https://www.val.town/secret-styleguide` — Val Town's broader internal\ncomponent library (Tag, Alert, Link, Pagination, Table, Tooltip, Card/\nProjectCard/BigCard, and ~20 more, many product-specific). Unlike the `_ui/*`\npages, this one does not expose Tailwind class attributes to a plain fetch —\nonly rendered layout/component names are recoverable. Cited in the\n`v1-component-set` PRD's VT Parallelism Audit purely as a qualitative signal\n(e.g. confirming Card is really \"ProjectCard,\" or that \"Tag\" is the closer\nanalog to a generic Badge) — never as a source of hex/class values the way §1–§5\nare.\n\nNothing here is invented: every token traces to a CSS property name or a\ncomponent class list; every hex/ratio is a labelled computation from a sourced\noklch value.\n","deleted",false,"label",[57,58,36],"docs","reference","7bfbe88f-a1d2-4bed-ba24-1cf295c3ee4b","bc8b0c5c-6b46-11f1-aeb1-1607ee4eb77e",98,["D",1783378956608],0,"directory",[57,58],{"_34":315,"_13":57,"_37":60,"_39":-5,"_41":42,"_43":316,"_45":46,"_47":317,"_17":63,"_50":64,"_51":-5,"_53":54,"_55":-5,"_83":318,"_18":319},{"_34":282,"_13":283,"_37":284,"_39":-5,"_41":42,"_43":285,"_45":46,"_47":286,"_17":63,"_50":64,"_51":-5,"_53":54,"_55":-5,"_83":287,"_18":288},{"_34":134,"_13":135,"_37":136,"_39":-5,"_41":42,"_43":137,"_45":46,"_47":138,"_17":63,"_50":64,"_51":-5,"_53":54,"_55":-5,"_83":139,"_18":140},{"_34":125,"_13":126,"_37":127,"_39":-5,"_41":42,"_43":128,"_45":46,"_47":129,"_17":130,"_50":24,"_51":131,"_53":54,"_55":-5,"_83":132,"_18":133},{"_34":119,"_13":120,"_37":121,"_39":-5,"_41":42,"_43":114,"_45":46,"_47":122,"_17":80,"_50":24,"_51":116,"_53":54,"_55":-5,"_83":123,"_18":124},{"_34":111,"_13":112,"_37":113,"_39":-5,"_41":42,"_43":114,"_45":46,"_47":115,"_17":100,"_50":24,"_51":116,"_53":54,"_55":-5,"_83":117,"_18":118},{"_34":104,"_13":105,"_37":106,"_39":-5,"_41":42,"_43":44,"_45":46,"_47":107,"_17":100,"_50":24,"_51":108,"_53":54,"_55":-5,"_83":109,"_18":110},{"_34":95,"_13":96,"_37":97,"_39":-5,"_41":42,"_43":98,"_45":46,"_47":99,"_17":100,"_50":24,"_51":101,"_53":54,"_55":-5,"_83":102,"_18":103},{"_34":86,"_13":87,"_37":88,"_39":-5,"_41":42,"_43":89,"_45":46,"_47":90,"_17":91,"_50":24,"_51":92,"_53":54,"_55":-5,"_83":93,"_18":94},{"_34":76,"_13":77,"_37":78,"_39":-5,"_41":42,"_43":44,"_45":46,"_47":79,"_17":80,"_50":81,"_51":82,"_53":54,"_55":-5,"_83":84,"_18":85},"945f4eec-9cce-4d11-b223-f2da2d511c2d","mod.ts","92255786-6b52-11f1-8262-1607ee4eb77e",["D",1784076371333],6,"script","/**\n * Kylä UI — public barrel for the zero-dependency core.\n *\n * Radix-backed components (e.g. Dialog) are intentionally NOT re-exported here;\n * they live behind their own import paths so Radix only loads when used (ADR-0002).\n */\n\n// Components\nexport { Button, type ButtonProps } from \"./src/components/button.tsx\";\nexport {\n Heading,\n type HeadingLevel,\n type HeadingProps,\n Text,\n type TextProps,\n type TextTone,\n} from \"./src/components/text.tsx\";\nexport { KylaProvider, type Mode, useKylaMode } from \"./src/theme/provider.tsx\";\nexport {\n type ColorToken,\n type FontWeightToken,\n type RadiusToken,\n type SpaceProperty,\n type SpaceToken,\n type State,\n tw,\n type TypeToken,\n} from \"./src/theme/tw.ts\";\nexport { cn } from \"./src/utils/cn.ts\";\nexport { variants } from \"./src/utils/variants.ts\";\n","children",[],[77],"fb6b027f-bd29-4744-8112-2dc00068f0a8","deno.json","47d67822-6b3e-11f1-bad1-1607ee4eb77e",223,["D",1784059569607],4,"{\n \"compilerOptions\": {\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ],\n \"noImplicitAny\": false,\n \"strict\": false,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"]\n },\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-sloppy-imports\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true\n },\n \"fmt\": {\n \"exclude\": [\".vt/\"]\n },\n \"lint\": {\n \"include\": [\"mod.ts\", \"preview/\", \"src/\"],\n \"rules\": {\n \"exclude\": [\"no-explicit-any\", \"no-import-prefix\"]\n }\n },\n \"tasks\": {\n \"fmt\": \"deno fmt\",\n \"fmt:check\": \"deno fmt --check\",\n \"lint\": \"deno lint\",\n \"typecheck\": \"deno check --allow-import=esm.town,www.val.town,esm.sh,jsr.io mod.ts preview src\",\n \"test\": \"deno test --allow-import=esm.town,www.val.town,esm.sh,jsr.io\",\n \"check\": \"deno task fmt:check && deno task lint && deno task typecheck && deno task test\"\n },\n \"lock\": false,\n \"nodeModulesDir\": \"auto\"\n}\n",[],[87],"5b3e52d4-c883-401e-85fc-f802d9c332b5","README.md","ec9dd180-6b3d-11f1-89a3-1607ee4eb77e",267,["D",1784074390869],8,"# Kylä UI\n\nA component library for building **consistently styled** web apps on Val Town.\nKylä is Finnish for \"village.\"\n\nMost Val Town apps are assembled fast and without a designer, so they end up\nlooking inconsistent. Kylä gives you opinionated, on-system components so your\napp looks coherent by default. Accessibility (semantic HTML, label association,\nvisible focus, AA contrast) is a quiet guarantee underneath.\n\nBuilt for Val Town's reality: **no build step**. Components are React, styled\nwith runtime [Twind](https://twind.style) + semantic CSS-variable tokens, and\nconsumed by import — no bundler, no codegen.\n\n## Quick start\n\n1. Your HTML shell must load Twind (it has to be present before first paint):\n\n ```html\n \n ```\n\n2. Wrap your app in `KylaProvider` (it injects the design tokens and owns\n light/dark mode), then use components:\n\n ```tsx\n /** @jsxImportSource https://esm.sh/react@18.2.0 */\n import {\n Button,\n KylaProvider,\n } from \"https://esm.town/v/nbbaier/kyla-ui/mod.ts\";\n\n export function App() {\n return (\n \n \n \n );\n }\n ```\n\nTo pin a version, append `?v=NNN` to the import URL; the unpinned URL always\ntracks the latest release (see\n[ADR-0004](docs/adr/0004-version-pinned-upgrade-contract.md)).\n\n## Status\n\nEarly. The styling foundation (`cn`, `tw`, `variants`, `KylaProvider`), real\nAA-checked palette, structural spacing/radius/type scales, and first component\n(`Button`) are in place. The rest of the v1 component set is still to come.\n\n## Components\n\n- `Button` — `variant`: `primary | subtle | ghost | danger`, `size`:\n `sm | md | lg`.\n\n## Project docs\n\n- [`CONTEXT.md`](CONTEXT.md) — the glossary / shared language.\n- [`docs/roadmap.md`](docs/roadmap.md) — the dependency-ordered plan to v1 +\n status.\n- [`docs/adr/`](docs/adr/) — architecture decision records.\n\nThe substrate (Radix + Twind + tokens + Provider on Val Town) is proven in a\nseparate spike val, `nbbaier/kyla-ui-spike`.\n",[],[96],"49aa049f-a7ee-4d44-b501-bab82c31cbb7","CONTEXT.md","bce56486-6b46-11f1-8898-1607ee4eb77e",["D",1784076371333],"# Kylä UI — Context\n\nA glossary of the core terms in this project. Implementation details live in\ncode and ADRs, not here.\n\n> \"Kylä\" is Finnish for \"village.\"\n\n## Glossary\n\n### Kylä UI\n\nThe component library itself: a Val Town val (`nbbaier/kyla-ui`) that exports\nReact components, a styling system, and any helpers needed to build consistently\nstyled web apps. It is **consumed by import**\n(`import { ... } from \"https://esm.town/v/nbbaier/kyla-ui/...\"`), not by\nremixing. This val is the source of truth for visual consistency across apps. It\n**also serves its own Gallery** (docs) at its HTTP route — the library documents\nitself, co-located with its source.\n\n### Starter\n\nA separate, remixable demo val (`kyla-ui-starter` or similar) that shows\nidiomatic _end-to-end_ use of Kylä UI: a tiny but genuine **todo app** with a\nreal HTTP route and `std/sqlite`, a working app shell, Provider + hydration\nwiring, and view-source link. A new app begins by remixing the Starter, then\nediting. The Starter **depends on** Kylä UI; the library never depends on the\nStarter. (Component reference/docs live in the library's Gallery, not the\nStarter.)\n\n### Gallery\n\nThe library's self-hosted documentation surface: an HTTP route on `kyla-ui` that\nrenders every component in its variants and Modes, with the Mode toggle. It is\nboth living docs and the in-browser proof that the stack renders correctly on\nVal Town (Twind + CSS-var tokens, Provider mode, Radix `Dialog` hydration). The\nseed of a fuller docs site later.\n\n### Release\n\nA blessed version of Kylä UI, produced by merging a development branch into\n`main`. `main` is the stable line: raw development never happens on it, so\nHEAD-of-`main` is always a Release. Each Release corresponds to a concrete Val\nTown version number (`?v=NNN`). A consumer tracks Releases by importing the\nunpinned URL (always latest Release) or freezes onto one by pinning its\n`?v=NNN`, which the README's release table maps by name.\n\n### Consumer\n\nA web app (a val) built with Kylä UI. Gets visual consistency by importing the\nlibrary rather than copying its code.\n\n### Semantic Token\n\nA named, intent-based design value (e.g. \"base surface,\" \"default foreground,\"\n\"line/border,\" \"danger\") rather than a raw value (e.g. \"blue-500\"). Components\nreference semantic tokens only; they never hard-code raw colors. Tokens are the\nunit of visual consistency and the surface through which a Theme is applied.\n(Modeled on Cloudflare Kumo's semantic-token system.)\n\nCanonical token vocabulary (CSS custom properties, all prefixed `--kyla-`):\n\n- **Surfaces** (hierarchy): `base` → `elevated` → `recessed`\n- **Foreground:** `fg`, `fg-muted`\n- **Borders:** `line`, `hairline`\n- **Accent:** `accent`, `accent-fg`, `accent-ring`, `accent-text`\n- **Status:** `danger`, `danger-fg`, `danger-text`, `success`, `success-fg`\n- **Shape:** `radius`\n\nThe default theme's values conform to the Val Town UI style guide (see\n[ADR-0005](docs/adr/0005-val-town-visual-language-default-theme.md)); Kylä keeps\nits own richer surface hierarchy over VT's palette.\n\nOf these, the consumer-facing Override Surface for v1 is exactly\n`--kyla-accent`, `--kyla-radius`, and `--kyla-font`; the rest are structural and\noutside the supported theme override surface.\n\n### Theme\n\nA complete set of values bound to the Semantic Tokens, producing a coherent\nlook. A consumer switches the active theme without touching component code.\nLight/dark is one axis of theming; brand/variant overrides are another.\n\nFor v1, Kylä ships **one opinionated theme** with automatic light/dark, and\nexposes a deliberately small **Override Surface**: consumers may redefine\n`--kyla-accent`, `--kyla-radius`, and `--kyla-font` (with the graduated radius\ntokens deriving directly from `--kyla-radius`). Everything else is structural\nand fixed as the supported consumer contract: the surface hierarchy, foreground\nand border roles, status roles, spacing scale, type sizes and line-heights, and\nfont weights. Because these values are CSS custom properties, consumers can\ntechnically redefine them, but doing so is an unsupported escape hatch rather\nthan part of the Theme API. That stable contract _is_ the consistency. A fuller\nnamed-theme system (multiple consumer-defined Themes, à la Kumo's theme configs)\nis a deliberate later step, not a v1 feature.\n\n### Variant\n\nA named, typed dimension of a component's appearance exposed as a prop (e.g.\n`variant=\"primary\"`, `size=\"sm\"`, `tone=\"danger\"`). Variants map to Semantic\nTokens internally; they are the consumer's primary, discoverable means of\nvarying a component while staying on-system. An escape-hatch `className` always\nmerges last, letting an app deviate locally without forking. For v1 the public\nsurface is finished components plus a `cn()` helper and the Provider — the\nunderlying Headless Primitives stay internal.\n\n### Mode\n\nThe light/dark axis of a Theme. Modeled as\n`data-mode=\"light\" | \"dark\" | \"system\"`, where `system` falls through to the OS\npreference via CSS `light-dark()` (zero JS). Mode is **owned by the Provider** —\nit sets `data-mode` and exposes a hook to read/set it (persistence opt-in) — so\napps get a first-class light/dark toggle without hand-rolling one (a common\nsource of inconsistency and flash-of-wrong-theme bugs).\n\n### Headless Primitive\n\nThe behavior-and-accessibility layer of an interactive component (focus\nmanagement, keyboard nav, ARIA), independent of its visual styling. For the hard\ninteractive components (Dialog, Popover, Menu, Tabs), Kylä builds on a\nthird-party headless primitive library rather than hand-rolling. Simple visual\ncomponents (Button, Card, Stack, Text, Input, Badge) have no separate Headless\nPrimitive — they are styled directly.\n",[],[105],"f15ee7d6-b4dd-4320-a2af-5548291d584a","CLAUDE.md","a53286c6-775c-11f1-abf2-1607ee4eb77e",261,["D",1784061317835],"## Working on changes\n\nDevelopment happens on a Val Town **val branch**, never directly on `main`.\n`main` is the stable release line — HEAD-of-`main` is always a Release (a\nconcrete `?v=NNN`), so raw work never lands on it. Branch off `main`, do the\nwork on the branch, and land it by merging the branch into `main`, which cuts\nthe next Release. See\n[ADR-0004](docs/adr/0004-version-pinned-upgrade-contract.md) for the rationale\nand the consumer-facing pinning contract.\n\n**Exception: docs-only changes push straight to `main`.** Changes confined to\n`docs/**` (specs, ADRs, roadmap, reference docs) carry no code/version surface,\nso they don't need a branch + merge cycle — push them directly. Any change that\ntouches `src/`, `mod.ts`, or other shipped code still follows the branch flow\nabove.\n\n### Val Town branch workflow\n\n- Before starting, verify the checkout with `vt status`, then branch from the\n stable line with `vt checkout main` followed by\n `vt checkout -b -NN-`; use a short prefix derived from\n the spec/feature (for example, `scales-03-type-scale-and-font`).\n- Keep implementation work on that branch. `vt push` is the Val Town commit for\n the branch; finish by running `vt status` and confirming local state matches\n remote state.\n- A ticket is not landed when it is merely pushed to a work branch. Merge the\n branch into `main` to cut the next Release, then record the `Landed: vNNN`\n version and `Status: done` in the issue file.\n\n## Agent skills\n\n### Issue tracker\n\nIssues and specs live as local markdown files under\n`docs/issues//`; no external tracker. See\n`docs/agents/issue-tracker.md`.\n\n### Triage labels\n\nUses the default five-role label vocabulary unchanged (`needs-triage`,\n`needs-info`, `ready-for-agent`, `ready-for-human`, `wontfix`). See\n`docs/agents/triage-labels.md`.\n\n### Domain docs\n\nSingle-context layout: `CONTEXT.md` + `docs/adr/` at the repo root. See\n`docs/agents/domain.md`.\n",[],[112],"8509b37e-b05c-44c0-bc74-d25f1f2990a0","AGENTS.md","9b865e5e-7770-11f1-b136-1607ee4eb77e",["D",1784061317835],[],[120],"1c7f3876-c7c1-4d67-8ed9-16bd851ecf3f",".vtignore","47ce4d8c-6b3e-11f1-8eca-1607ee4eb77e",13,["D",1781805649048],1,".git\n.vscode\n.cursor\n.DS_Store\nnode_modules\nvendor\n.claude",[],[126],"da3f4f02-c070-4df1-9bc5-96c25fc6eefd","src","91e38b30-6b52-11f1-bb7a-1607ee4eb77e",28,["D",1781813780417],[141,142,143,144],[135],{"_34":242,"_13":243,"_37":244,"_39":136,"_41":42,"_43":245,"_45":46,"_47":246,"_17":63,"_50":64,"_51":-5,"_53":54,"_55":-5,"_83":247,"_18":248},{"_34":228,"_13":229,"_37":230,"_39":136,"_41":42,"_43":44,"_45":46,"_47":231,"_17":63,"_50":64,"_51":-5,"_53":54,"_55":-5,"_83":232,"_18":233},{"_34":171,"_13":172,"_37":173,"_39":136,"_41":42,"_43":174,"_45":46,"_47":175,"_17":63,"_50":64,"_51":-5,"_53":54,"_55":-5,"_83":176,"_18":177},{"_34":145,"_13":146,"_37":147,"_39":136,"_41":42,"_43":148,"_45":46,"_47":149,"_17":63,"_50":64,"_51":-5,"_53":54,"_55":-5,"_83":150,"_18":151},"14b26de5-d175-4ba4-8abe-7f94001d8ac4","utils","56dc5a24-6b54-11f1-9b1d-1607ee4eb77e",48,["D",1781814540380],[152,153],[135,146],{"_34":162,"_13":163,"_37":164,"_39":147,"_41":42,"_43":165,"_45":46,"_47":166,"_17":167,"_50":81,"_51":168,"_53":54,"_55":-5,"_83":169,"_18":170},{"_34":154,"_13":155,"_37":156,"_39":147,"_41":42,"_43":157,"_45":46,"_47":158,"_17":91,"_50":81,"_51":159,"_53":54,"_55":-5,"_83":160,"_18":161},"c02d2fe3-028f-40aa-85fb-5ebf33d9c984","variants.ts","92020682-6b52-11f1-80b8-1607ee4eb77e",266,["D",1784072875132],"import { cn } from \"./cn.ts\";\n\ntype VariantShape = Record>;\ntype Selection = { [K in keyof V]?: keyof V[K] };\n\n/**\n * Minimal cva-style helper: maps typed variant props to token-based class strings.\n *\n * Hand-rolled to avoid an external dependency (per ADR-0002's keep-the-common-case\n * dependency-free posture). Supports a `base` string, `variants` maps, optional\n * `defaultVariants`, and a trailing `className` escape hatch (merged last via cn()).\n *\n * Example:\n * const button = variants({\n * base: cn(tw.radius(\"md\"), \"px-4 py-2 font-medium\"),\n * variants: {\n * variant: { primary: cn(tw.bg(\"accent\"), tw.text(\"accent-fg\")), ... },\n * size: { sm: \"text-sm px-3 py-1.5\", md: \"text-base\" },\n * },\n * defaultVariants: { variant: \"primary\", size: \"md\" },\n * });\n * button({ variant: \"primary\", size: \"sm\", className });\n */\nexport function variants(config: {\n base?: string;\n variants?: V;\n defaultVariants?: Selection;\n}) {\n return (props: Selection & { className?: string } = {}): string => {\n const selected: Selection = props;\n const classes: string[] = [];\n if (config.base) classes.push(config.base);\n if (config.variants) {\n for (const key in config.variants) {\n const chosen = selected[key] ?? config.defaultVariants?.[key];\n if (chosen != null) {\n const cls = config.variants[key][chosen];\n if (cls) classes.push(cls);\n }\n }\n }\n return cn(...classes, props.className);\n };\n}\n",[],[135,146,155],"33c08f5a-4737-462a-a6c8-7f544fc943d7","cn.ts","91f4e2d6-6b52-11f1-a883-1607ee4eb77e",208,["D",1784058612720],2,"import { type ClassValue, clsx } from \"npm:clsx@2.1.1\";\nimport { twMerge } from \"npm:tailwind-merge@3.6.0\";\n\n/**\n * Merge class strings with conflict resolution.\n *\n * `clsx` flattens conditionals/arrays and drops falsy values; `twMerge` keeps only\n * the winning class when two conflict. This matters on Val Town: Twind injects CSS\n * rules in first-seen order, so source order — not className order — would otherwise\n * decide a tie. `cn()` resolves the conflict *in the class string itself*, so the\n * outcome is deterministic regardless of Twind's injection order. The\n * `[color:var(--…)]` hint our token utilities carry (ADR-0001) is also what lets\n * twMerge group and dedupe background/text/border *colors* independently of\n * size/width utilities — verified empirically on the Val Town runtime.\n *\n * Call order is the contract: a component passes its own classes FIRST and the\n * caller's escape-hatch `className` LAST — `cn(componentClasses, className)` — so\n * the caller reliably overrides. Versions are pinned so merge behavior is\n * reproducible (bare `npm:` specifiers resolve to \"latest\" and could shift).\n */\nexport function cn(...inputs: ClassValue[]): string {\n return twMerge(clsx(inputs));\n}\n",[],[135,146,163],"05fe2e2c-2444-41d7-938d-50483f27ebd6","theme","56fb5e2e-6b54-11f1-95d4-1607ee4eb77e",50,["D",1781814540580],[178,179,180,181,182,183],[135,172],{"_34":220,"_13":221,"_37":222,"_39":173,"_41":42,"_43":223,"_45":46,"_47":224,"_17":130,"_50":81,"_51":225,"_53":54,"_55":-5,"_83":226,"_18":227},{"_34":213,"_13":214,"_37":215,"_39":173,"_41":42,"_43":157,"_45":46,"_47":216,"_17":91,"_50":81,"_51":217,"_53":54,"_55":-5,"_83":218,"_18":219},{"_34":205,"_13":206,"_37":207,"_39":173,"_41":42,"_43":44,"_45":46,"_47":208,"_17":209,"_50":81,"_51":210,"_53":54,"_55":-5,"_83":211,"_18":212},{"_34":198,"_13":199,"_37":200,"_39":173,"_41":42,"_43":44,"_45":46,"_47":201,"_17":80,"_50":81,"_51":202,"_53":54,"_55":-5,"_83":203,"_18":204},{"_34":191,"_13":192,"_37":193,"_39":173,"_41":42,"_43":98,"_45":46,"_47":194,"_17":100,"_50":81,"_51":195,"_53":54,"_55":-5,"_83":196,"_18":197},{"_34":184,"_13":185,"_37":186,"_39":173,"_41":42,"_43":114,"_45":46,"_47":187,"_17":130,"_50":81,"_51":188,"_53":54,"_55":-5,"_83":189,"_18":190},"0eea0f24-7e97-4c9c-bb76-aaf2144d54b4","tw_test.ts","4190d9b6-7fc1-11f1-8791-1607ee4eb77e",["D",1784061317835],"import { assertEquals } from \"jsr:@std/assert@1\";\nimport { tw } from \"./tw.ts\";\n\nDeno.test(\"spacing accessors emit bare arbitrary-value classes\", () => {\n assertEquals(tw.space(\"4\"), \"p-[var(--kyla-space-4)]\");\n assertEquals(tw.space(\"p\", \"4\"), \"p-[var(--kyla-space-4)]\");\n assertEquals(tw.space(\"gap\", \"6\"), \"gap-[var(--kyla-space-6)]\");\n assertEquals(tw.space(\"space-x\", \"2\"), \"space-x-[var(--kyla-space-2)]\");\n});\n\nDeno.test(\"radius accessors emit derived bare arbitrary-value classes\", () => {\n assertEquals(tw.radius(\"sm\"), \"rounded-[var(--kyla-radius-sm)]\");\n assertEquals(tw.radius(\"md\"), \"rounded-[var(--kyla-radius-md)]\");\n assertEquals(tw.radius(\"lg\"), \"rounded-[var(--kyla-radius-lg)]\");\n assertEquals(tw.radius(), \"rounded-[var(--kyla-radius-md)]\");\n});\n\nDeno.test(\"type accessors bundle size and line-height\", () => {\n assertEquals(\n tw.type(\"sm\"),\n \"text-[length:var(--kyla-text-sm)] leading-[var(--kyla-text-sm-line-height)]\",\n );\n assertEquals(\n tw.type(\"3xl\"),\n \"text-[length:var(--kyla-text-3xl)] leading-[var(--kyla-text-3xl-line-height)]\",\n );\n});\n\nDeno.test(\"weight accessors emit bare arbitrary-value classes\", () => {\n assertEquals(\n tw.weight(\"semibold\"),\n \"font-[weight:var(--kyla-font-weight-semibold)]\",\n );\n});\n\n// These calls intentionally verify that the accessor arguments are unions.\n// @ts-expect-error \"7\" is not one of the fixed spacing steps.\ntw.space(\"7\");\n// @ts-expect-error \"xl\" is not one of the graduated radius roles.\ntw.radius(\"xl\");\n// @ts-expect-error \"4xl\" is not one of the fixed type steps.\ntw.type(\"4xl\");\n// @ts-expect-error \"black\" is not one of the fixed font weights.\ntw.weight(\"black\");\n",[],[135,172,185],"46e6aee9-4822-4f72-bf5a-6aaea6d63b38","tw.ts","92125ad2-6b52-11f1-8a2f-1607ee4eb77e",["D",1784074390869],"/**\n * Token utilities — the only sanctioned way to apply semantic colors.\n *\n * Authors compose styles from these instead of hand-writing `[color:var(--…)]`,\n * which makes the silent \"forgot the color: hint\" failure (see ADR-0001 — a bare\n * `bg-[var(--…)]` is type-ambiguous and Twind emits nothing) structurally\n * impossible. The TypeScript union also makes a typo'd token a compile error.\n *\n * Each color builder takes an optional state prefix so prefixed utilities keep the\n * hint too — `tw.bg(\"recessed\", \"hover\")` → `hover:bg-[color:var(--kyla-recessed)]`.\n */\nimport type {\n COLOR_TOKENS,\n FONT_WEIGHT_STEPS,\n RADIUS_STEPS,\n SPACE_STEPS,\n TYPE_STEPS,\n} from \"./tokens.ts\";\n\nexport type ColorToken = (typeof COLOR_TOKENS)[number];\n\n/** Common interaction states a token utility may be scoped to. */\nexport type State = \"hover\" | \"focus\" | \"focus-visible\" | \"active\" | \"disabled\";\n\n/** Fixed spacing steps, each representing a multiple of the 4px base unit. */\nexport type SpaceToken = (typeof SPACE_STEPS)[number];\n\n/** The graduated radius roles derived from `--kyla-radius`. */\nexport type RadiusToken = (typeof RADIUS_STEPS)[number];\n\n/** Fixed type steps, each paired with its intended line-height. */\nexport type TypeToken = (typeof TYPE_STEPS)[number];\n\n/** Fixed font weights from the Val Town typography scale. */\nexport type FontWeightToken = (typeof FONT_WEIGHT_STEPS)[number];\n\n/**\n * Twind spacing utilities that consume a spacing token. Component dimensions\n * such as width and height are intentionally outside this accessor contract.\n */\nexport type SpaceProperty =\n | \"p\"\n | \"px\"\n | \"py\"\n | \"pt\"\n | \"pr\"\n | \"pb\"\n | \"pl\"\n | \"m\"\n | \"mx\"\n | \"my\"\n | \"mt\"\n | \"mr\"\n | \"mb\"\n | \"ml\"\n | \"gap\"\n | \"gap-x\"\n | \"gap-y\"\n | \"space-x\"\n | \"space-y\";\n\nconst color = (prop: string, name: ColorToken, on?: State): string =>\n `${on ? `${on}:` : \"\"}${prop}-[color:var(--kyla-${name})]`;\n\nconst length = (prop: string, family: string, name: string): string =>\n `${prop}-[var(--kyla-${family}-${name})]`;\n\nconst typeScale = (step: TypeToken): string =>\n [\n // `text-*` is shared by color and font-size utilities, so the length hint\n // makes the CSS variable's intended role explicit to Twind.\n `text-[length:var(--kyla-text-${step})]`,\n length(\"leading\", \"text\", `${step}-line-height`),\n ].join(\" \");\n\nfunction space(step: SpaceToken): string;\nfunction space(prop: SpaceProperty, step: SpaceToken): string;\nfunction space(\n propOrStep: SpaceProperty | SpaceToken,\n step?: SpaceToken,\n): string {\n const prop = step === undefined ? \"p\" : propOrStep as SpaceProperty;\n const token = step ?? propOrStep as SpaceToken;\n return length(prop, \"space\", token);\n}\n\n/**\n * Token class builders. Usage: `cn(tw.bg(\"elevated\"), tw.border(\"line\"), \"p-6\")`.\n * Color builders emit the required `color:` hint (optionally state-prefixed).\n * Length builders intentionally emit bare arbitrary-value classes: lengths\n * are unambiguous to Twind and do not need the color hint.\n */\nexport const tw = {\n bg: (t: ColorToken, on?: State) => color(\"bg\", t, on),\n text: (t: ColorToken, on?: State) => color(\"text\", t, on),\n border: (t: ColorToken, on?: State) => color(\"border\", t, on),\n ring: (t: ColorToken, on?: State) => color(\"ring\", t, on),\n ringOffset: (t: ColorToken, on?: State) => color(\"ring-offset\", t, on),\n /**\n * Fixed spacing token. With one argument it emits padding for the token;\n * pass a Twind spacing property first for other uses, e.g.\n * `tw.space(\"gap\", \"4\")`.\n */\n space,\n /** border-radius token (a length — no `color:` hint needed) */\n radius: (t: RadiusToken = \"md\") => length(\"rounded\", \"radius\", t),\n /** type token — always applies the paired size and line-height */\n type: typeScale,\n /** fixed font-weight token */\n weight: (t: FontWeightToken) => `font-[weight:var(--kyla-font-weight-${t})]`,\n} as const;\n",[],[135,172,192],"e88a6980-667a-4f56-a3bd-c3ddd7a1e008","tokens_test.ts","e650bcd8-7b38-11f1-a19c-1607ee4eb77e",["D",1784076371333],"/**\n * The repo's first test harness — the load-bearing AA-contrast guarantee.\n *\n * It parses the token stylesheet, enumerates every *sanctioned* foreground /\n * surface pairing, and asserts each meets its WCAG AA threshold in **both** light\n * and dark mode. A future palette edit that breaks contrast fails here rather than\n * shipping. Kept a plain `deno test` so later scale slices reuse the pattern.\n */\nimport { assert, assertAlmostEquals, assertEquals } from \"jsr:@std/assert@1\";\nimport { contrastRatio } from \"./contrast.ts\";\nimport {\n COLOR_TOKENS,\n FONT_WEIGHT_STEPS,\n RADIUS_STEPS,\n SPACE_STEPS,\n tokenCSS,\n TYPE_STEPS,\n} from \"./tokens.ts\";\n\ntype Mode = \"light\" | \"dark\";\ntype Palette = Record>;\n\n/** Parse `--kyla-NAME: light-dark(, );` declarations into a palette. */\nfunction parsePalette(css: string): Palette {\n const re =\n /--kyla-([\\w-]+):\\s*light-dark\$\\s*(#[0-9a-fA-F]{3,6})\\s*,\\s*(#[0-9a-fA-F]{3,6})\\s*\$/g;\n const palette: Palette = {};\n for (const [, name, light, dark] of css.matchAll(re)) {\n palette[name] = { light, dark };\n }\n return palette;\n}\n\nconst palette = parsePalette(tokenCSS);\nconst MODES: Mode[] = [\"light\", \"dark\"];\n\n// WCAG AA: 4.5:1 for body text. Every sanctioned pairing here is text-on-surface.\nconst AA_BODY = 4.5;\n\n/**\n * The sanctioned foreground/surface pairings (PRD §Palette): body text and\n * secondary text on every surface, the status/accent *text* roles on every\n * surface, and ink on each colored fill. Anything not listed here is not a\n * promised pairing and is intentionally not asserted.\n */\nconst SURFACES = [\"base\", \"elevated\", \"recessed\"] as const;\nconst PAIRINGS: Array<{ fg: string; bg: string; min: number }> = [\n ...SURFACES.map((bg) => ({ fg: \"fg\", bg, min: AA_BODY })),\n ...SURFACES.map((bg) => ({ fg: \"fg-muted\", bg, min: AA_BODY })),\n ...SURFACES.map((bg) => ({ fg: \"accent-text\", bg, min: AA_BODY })),\n ...SURFACES.map((bg) => ({ fg: \"danger-text\", bg, min: AA_BODY })),\n { fg: \"accent-fg\", bg: \"accent\", min: AA_BODY },\n { fg: \"danger-fg\", bg: \"danger\", min: AA_BODY },\n { fg: \"success-fg\", bg: \"success\", min: AA_BODY },\n];\n\nDeno.test(\"contrastRatio returns the correct WCAG ratio for known pairs\", () => {\n assertAlmostEquals(contrastRatio(\"#000000\", \"#ffffff\"), 21, 0.05);\n assertAlmostEquals(contrastRatio(\"#ffffff\", \"#ffffff\"), 1, 0.001);\n // #767676 on white is the canonical WCAG AA boundary example (~4.54:1).\n assertAlmostEquals(contrastRatio(\"#767676\", \"#ffffff\"), 4.54, 0.05);\n // Order-independent.\n assertAlmostEquals(\n contrastRatio(\"#052f4a\", \"#00bcff\"),\n contrastRatio(\"#00bcff\", \"#052f4a\"),\n 0.001,\n );\n});\n\nDeno.test(\"every sanctioned fg/surface pairing meets AA in both modes\", () => {\n for (const mode of MODES) {\n for (const { fg, bg, min } of PAIRINGS) {\n assert(palette[fg], `missing token --kyla-${fg}`);\n assert(palette[bg], `missing token --kyla-${bg}`);\n const ratio = contrastRatio(palette[fg][mode], palette[bg][mode]);\n assert(\n ratio >= min,\n `${fg} on ${bg} (${mode}) is ${ratio.toFixed(2)}:1, below AA ${min}:1`,\n );\n }\n }\n});\n\nDeno.test(\"palette expands the color vocabulary with the new semantic tokens\", () => {\n for (const name of COLOR_TOKENS) {\n assert(palette[name], `expected --kyla-${name} in the token stylesheet`);\n }\n});\n\nDeno.test(\"dark-mode base uses the sanctioned slate-950 softening, not true black\", () => {\n assert(palette.base, \"missing --kyla-base\");\n assertEqualsHex(palette.base.dark, \"#020618\");\n assert(\n palette.base.dark.toLowerCase() !== \"#000000\",\n \"dark base must be softened slate-950, not true black\",\n );\n});\n\nfunction assertEqualsHex(actual: string, expected: string): void {\n assert(\n actual.toLowerCase() === expected.toLowerCase(),\n `expected ${expected}, got ${actual}`,\n );\n}\n\ntype LengthScale = Record;\n\nfunction parsePixelScale(css: string, family: string): LengthScale {\n const scale: LengthScale = {};\n const re = new RegExp(\n `--kyla-${family}-([\\\\w-]+):\\\\s*([0-9]+)px\\\\s*;`,\n \"g\",\n );\n for (const [, name, value] of css.matchAll(re)) {\n scale[name] = Number(value);\n }\n return scale;\n}\n\nDeno.test(\"spacing scale is the fixed monotonic 4px-based step set\", () => {\n const spacing = parsePixelScale(tokenCSS, \"space\");\n assertEquals(Object.keys(spacing), [...SPACE_STEPS]);\n\n let previous = -1;\n for (const step of SPACE_STEPS) {\n const value = spacing[step];\n assert(value >= 0, `space-${step} must be non-negative`);\n assert(value >= previous, `space-${step} must be monotonic`);\n assertEquals(value, Number(step) * 4);\n previous = value;\n }\n});\n\nDeno.test(\"radius scale derives sm/md/lg from the overridable base\", () => {\n assert(\n /--kyla-radius:\\s*8px\\s*;/.test(tokenCSS),\n \"expected an 8px overridable base radius\",\n );\n\n assertEquals(RADIUS_STEPS.length, 3);\n\n const expectedDerivations: Record<(typeof RADIUS_STEPS)[number], string> = {\n sm: \"calc(var(--kyla-radius) * 0.5)\",\n md: \"var(--kyla-radius)\",\n lg: \"calc(var(--kyla-radius) * 1.5)\",\n };\n for (const step of RADIUS_STEPS) {\n assert(\n tokenCSS.includes(\n `--kyla-radius-${step}: ${expectedDerivations[step]};`,\n ),\n `radius-${step} must derive from --kyla-radius`,\n );\n }\n});\n\ntype TypeScale = Record;\n\nfunction parseTypeScale(css: string): TypeScale {\n const scale: TypeScale = {};\n for (const step of TYPE_STEPS) {\n const size = css.match(\n new RegExp(`--kyla-text-${step}:\\\\s*([0-9.]+)rem\\\\s*;`),\n );\n const lineHeight = css.match(\n new RegExp(`--kyla-text-${step}-line-height:\\\\s*([^;]+);`),\n );\n if (size && lineHeight) {\n scale[step] = { size: Number(size[1]), lineHeight: lineHeight[1].trim() };\n }\n }\n return scale;\n}\n\nDeno.test(\"type scale is the fixed monotonic VT size and line-height set\", () => {\n const typeScale = parseTypeScale(tokenCSS);\n assertEquals(Object.keys(typeScale), [...TYPE_STEPS]);\n\n let previousSize = 0;\n for (const step of TYPE_STEPS) {\n const pair = typeScale[step];\n assert(pair.size > previousSize, `text-${step} must be monotonic by size`);\n assert(pair.lineHeight.length > 0, `text-${step} must have a line-height`);\n previousSize = pair.size;\n }\n});\n\nDeno.test(\"font and weight tokens expose the VT typography foundation\", () => {\n assert(\n tokenCSS.includes(\n '--kyla-font: \"IBM Plex Sans\", -apple-system, sans-serif;',\n ),\n \"expected the overridable IBM Plex Sans font token\",\n );\n\n for (const [index, name] of FONT_WEIGHT_STEPS.entries()) {\n const value = String(400 + index * 100);\n assert(\n tokenCSS.includes(`--kyla-font-weight-${name}: ${value};`),\n `expected --kyla-font-weight-${name}`,\n );\n }\n});\n\nconst OVERRIDE_TOKENS = [\"accent\", \"radius\", \"font\"] as const;\n\nconst STRUCTURAL_TOKENS = [\n // Semantic palette roles other than the overridable accent.\n \"base\",\n \"elevated\",\n \"recessed\",\n \"fg\",\n \"fg-muted\",\n \"line\",\n \"hairline\",\n \"accent-fg\",\n \"accent-ring\",\n \"accent-text\",\n \"danger\",\n \"danger-fg\",\n \"danger-text\",\n \"success\",\n \"success-fg\",\n // Direct radius derivations remain structural even though the base is not.\n ...RADIUS_STEPS.map((step) => `radius-${step}`),\n ...SPACE_STEPS.map((step) => `space-${step}`),\n ...TYPE_STEPS.flatMap((step) => [\n `text-${step}`,\n `text-${step}-line-height`,\n ]),\n ...FONT_WEIGHT_STEPS.map((weight) => `font-weight-${weight}`),\n] as const;\n\nDeno.test(\"override surface and structural token names are all present\", () => {\n for (const name of OVERRIDE_TOKENS) {\n assert(\n tokenCSS.includes(`--kyla-${name}:`),\n `expected overridable token --kyla-${name}`,\n );\n }\n\n for (const name of STRUCTURAL_TOKENS) {\n assert(\n tokenCSS.includes(`--kyla-${name}:`),\n `expected structural token --kyla-${name}`,\n );\n }\n});\n",[],[135,172,199],"4165e406-9df6-4deb-bdd8-2198b50dbeb2","tokens.ts","920ac18c-6b52-11f1-a416-1607ee4eb77e",["D",1784076371333],12,"/**\n * The Kylä token stylesheet, as a string the Provider injects at runtime.\n *\n * Semantic design values as CSS custom properties (ADR-0001). `light-dark()`\n * resolves against the CSS `color-scheme` property, so toggling `color-scheme`\n * via `data-mode` flips every token at once — no `dark:` variants.\n *\n * Surface hierarchy (conventional): in light mode `elevated` is the *brightest*\n * (cards lift toward the light), `base` is the page, `recessed` is an inset well;\n * dark mode inverts brightness.\n *\n * Palette: the real Val Town values, ported (not invented) from the VT UI style\n * guide and AA-verified in both modes (ADR-0005; see\n * docs/reference/val-town-style-guide.md §6–§7). The AA guarantee is enforced by\n * tokens_test.ts — a pairing that regresses fails the suite. The one sanctioned\n * deviation from VT is the dark-mode `base`: `slate-950 #020618`, a deliberate\n * softening of VT's true-black `#000` to cut glare.\n *\n * Structural scales: spacing is fixed as Kylä's supported consumer contract\n * on the Val Town/Tailwind 4px base unit. \"Fixed\" means these values are not\n * supported theme override inputs; because they are CSS custom properties, a\n * consumer can still redefine them at their own risk.\n * The radius scale is derived from the one consumer-overridable base so the\n * proportions remain intact when a consumer changes --kyla-radius. The\n * consumer override surface is exactly --kyla-accent, --kyla-radius, and\n * --kyla-font (plus the direct radius derivations). Every other token below —\n * surfaces, foregrounds, borders, status roles, spacing, type sizes/leading,\n * and font weights — is structural and outside the supported override surface.\n */\nexport const COLOR_TOKENS = [\n \"base\",\n \"elevated\",\n \"recessed\",\n \"fg\",\n \"fg-muted\",\n \"line\",\n \"hairline\",\n \"accent\",\n \"accent-fg\",\n \"accent-ring\",\n \"accent-text\",\n \"danger\",\n \"danger-fg\",\n \"danger-text\",\n \"success\",\n \"success-fg\",\n] as const;\n\nexport const SPACE_STEPS = [\n \"0\",\n \"1\",\n \"2\",\n \"3\",\n \"4\",\n \"5\",\n \"6\",\n \"8\",\n \"10\",\n \"12\",\n \"16\",\n \"20\",\n \"24\",\n] as const;\n\nexport const RADIUS_STEPS = [\"sm\", \"md\", \"lg\"] as const;\n\nexport const TYPE_STEPS = [\n \"xs\",\n \"sm\",\n \"base\",\n \"lg\",\n \"xl\",\n \"2xl\",\n \"3xl\",\n] as const;\n\nexport const FONT_WEIGHT_STEPS = [\n \"normal\",\n \"medium\",\n \"semibold\",\n \"bold\",\n \"extrabold\",\n] as const;\n\nexport const tokenCSS = `\n:root {\n color-scheme: light dark;\n\n /* surfaces — base (page) / elevated (cards) / recessed (wells) */\n --kyla-base: light-dark(#ffffff, #020618);\n --kyla-elevated: light-dark(#ffffff, #0f172b);\n --kyla-recessed: light-dark(#f1f5f9, #1d293d);\n\n /* foreground */\n --kyla-fg: light-dark(#000000, #ffffff);\n --kyla-fg-muted: light-dark(#4a5565, #d1d5dc);\n\n /* borders */\n --kyla-line: light-dark(#e2e8f0, #314158);\n --kyla-hairline: light-dark(#f1f5f9, #1d293d);\n\n /* accent */\n /* consumer-overridable; all other palette roles are structural */\n --kyla-accent: light-dark(#00bcff, #0069a8);\n --kyla-accent-fg: light-dark(#052f4a, #ffffff);\n --kyla-accent-ring: light-dark(#00a6f4, #00a6f4);\n --kyla-accent-text: light-dark(#00598a, #b8e6fe);\n\n /* status — danger / success */\n /*\n * danger is a fill; danger-text is danger on a surface, the counterpart to\n * accent-text. The fill is far too pale in light mode to double as text\n * (rose-300 on white is 1.4:1), so the two roles cannot share one token.\n */\n --kyla-danger: light-dark(#ffa1ad, #a50036);\n --kyla-danger-fg: light-dark(#4d0218, #ffffff);\n --kyla-danger-text: light-dark(#a50036, #ffc9d4);\n --kyla-success: light-dark(#00d492, #007a55);\n --kyla-success-fg: light-dark(#002c22, #ffffff);\n\n /*\n * Typography — --kyla-font is consumer-overridable. The type sizes, their\n * paired line-heights, and weights are structural so components share one\n * hierarchy. Values are the VT style-guide scale (§4).\n */\n --kyla-font: \"IBM Plex Sans\", -apple-system, sans-serif;\n --kyla-text-xs: 0.75rem;\n --kyla-text-xs-line-height: 1rem;\n --kyla-text-sm: 0.875rem;\n --kyla-text-sm-line-height: 1.25rem;\n --kyla-text-base: 1rem;\n --kyla-text-base-line-height: 1.5rem;\n --kyla-text-lg: 1.125rem;\n --kyla-text-lg-line-height: 1.75rem;\n --kyla-text-xl: 1.25rem;\n --kyla-text-xl-line-height: 1.75rem;\n --kyla-text-2xl: 1.5rem;\n --kyla-text-2xl-line-height: 2rem;\n --kyla-text-3xl: 1.875rem;\n --kyla-text-3xl-line-height: 2.25rem;\n\n --kyla-font-weight-normal: 400;\n --kyla-font-weight-medium: 500;\n --kyla-font-weight-semibold: 600;\n --kyla-font-weight-bold: 700;\n --kyla-font-weight-extrabold: 800;\n\n /*\n * Structural spacing — fixed supported contract on a 4px base, following the\n * compact VT/Tailwind steps used by the component style guide. These are not\n * supported theme overrides, though CSS custom properties remain mutable.\n */\n --kyla-space-0: 0px;\n --kyla-space-1: 4px;\n --kyla-space-2: 8px;\n --kyla-space-3: 12px;\n --kyla-space-4: 16px;\n --kyla-space-5: 20px;\n --kyla-space-6: 24px;\n --kyla-space-8: 32px;\n --kyla-space-10: 40px;\n --kyla-space-12: 48px;\n --kyla-space-16: 64px;\n --kyla-space-20: 80px;\n --kyla-space-24: 96px;\n\n /*\n * Shape — --kyla-radius is the one consumer-overridable base. The graduated\n * values are direct derivations, so changing the base preserves\n * the 4px / 8px / 12px proportions used by the VT style guide.\n */\n --kyla-radius: 8px;\n --kyla-radius-sm: calc(var(--kyla-radius) * 0.5);\n --kyla-radius-md: var(--kyla-radius);\n --kyla-radius-lg: calc(var(--kyla-radius) * 1.5);\n}\n\n/* data-mode overrides the OS preference by pinning color-scheme */\n[data-mode=\"light\"] { color-scheme: light; }\n[data-mode=\"dark\"] { color-scheme: dark; }\n[data-mode=\"system\"] { color-scheme: light dark; }\n\nhtml, body {\n margin: 0;\n font-family: var(--kyla-font);\n}\n`;\n",[],[135,172,206],"68118008-0757-4031-adf9-976c0c4bbe47","provider.tsx","92200010-6b52-11f1-80b8-1607ee4eb77e",["D",1784072875132],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport {\n createContext,\n type ReactNode,\n useContext,\n useEffect,\n useState,\n} from \"https://esm.sh/react@18.2.0\";\nimport { tokenCSS } from \"./tokens.ts\";\n\n/**\n * The Kylä root. Guarantees the styling substrate is present and owns Mode.\n *\n * - Injects the token stylesheet into at runtime (idempotent). Twind itself\n * must live in the HTML shell since it has to load before first paint (ADR-0001);\n * the Provider injects tokens and the default IBM Plex Sans stylesheet.\n * - Owns Mode via `data-mode` on and exposes `useKylaMode()`. `system`\n * falls through to the OS preference via `light-dark()` (zero JS).\n */\nexport type Mode = \"light\" | \"dark\" | \"system\";\n\nconst ModeContext = createContext<{ mode: Mode; setMode: (m: Mode) => void }>({\n mode: \"system\",\n setMode: () => {},\n});\n\nexport function useKylaMode() {\n return useContext(ModeContext);\n}\n\nconst TOKENS_ID = \"kyla-tokens\";\nconst FONT_STYLESHEET_ID = \"kyla-font-stylesheet\";\nconst FONT_STYLESHEET_HREF =\n \"https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;500;600;700;800&display=swap\";\n\nexport function KylaProvider({\n children,\n defaultMode = \"system\",\n}: {\n children: ReactNode;\n defaultMode?: Mode;\n}) {\n const [mode, setMode] = useState(defaultMode);\n\n // Inject the token stylesheet once. Idempotent: guards against double-inject.\n useEffect(() => {\n if (!document.getElementById(TOKENS_ID)) {\n const style = document.createElement(\"style\");\n style.id = TOKENS_ID;\n style.textContent = tokenCSS;\n document.head.appendChild(style);\n }\n\n if (!document.getElementById(FONT_STYLESHEET_ID)) {\n const link = document.createElement(\"link\");\n link.id = FONT_STYLESHEET_ID;\n link.rel = \"stylesheet\";\n link.href = FONT_STYLESHEET_HREF;\n document.head.appendChild(link);\n }\n }, []);\n\n // Reflect Mode onto the document so `data-mode` selectors take effect.\n useEffect(() => {\n document.documentElement.setAttribute(\"data-mode\", mode);\n }, [mode]);\n\n return (\n \n {children}\n \n );\n}\n",[],[135,172,214],"8d4dc0bf-f133-42f5-9cde-dd3ce6ec7cf1","contrast.ts","e6508772-7b38-11f1-a19c-1607ee4eb77e",213,["D",1784058613115],"/**\n * Pure WCAG contrast utilities over resolved sRGB colors — no DOM, no browser.\n *\n * This is the natural seam for the palette's AA guarantee: \"AA holds\" is a\n * property of the resolved color values, computable without a browser. The token\n * stylesheet resolves each semantic token to a concrete hex per mode (via\n * `light-dark()`); these helpers turn those hexes into WCAG contrast ratios so a\n * test can assert every sanctioned foreground/surface pairing stays legible.\n */\n\n/** An sRGB color as integer channels in the range 0–255. */\nexport type RGB = [r: number, g: number, b: number];\n\n/** Parse a `#rgb` or `#rrggbb` hex string into sRGB channels (0–255). */\nexport function parseHex(hex: string): RGB {\n const h = hex.trim().replace(/^#/, \"\");\n const full = h.length === 3\n ? h\n .split(\"\")\n .map((c) => c + c)\n .join(\"\")\n : h;\n if (!/^[0-9a-fA-F]{6}$/.test(full)) {\n throw new Error(`Invalid hex color: ${hex}`);\n }\n return [\n parseInt(full.slice(0, 2), 16),\n parseInt(full.slice(2, 4), 16),\n parseInt(full.slice(4, 6), 16),\n ];\n}\n\n/** WCAG relative luminance of an sRGB color (0 = black, 1 = white). */\nexport function relativeLuminance([r, g, b]: RGB): number {\n const linear = (channel: number): number => {\n const s = channel / 255;\n return s <= 0.03928 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;\n };\n return 0.2126 * linear(r) + 0.7152 * linear(g) + 0.0722 * linear(b);\n}\n\n/**\n * WCAG contrast ratio between two colors (hex strings), in the range 1–21.\n * Order-independent: `contrastRatio(a, b) === contrastRatio(b, a)`.\n */\nexport function contrastRatio(a: string, b: string): number {\n const la = relativeLuminance(parseHex(a));\n const lb = relativeLuminance(parseHex(b));\n const lighter = Math.max(la, lb);\n const darker = Math.min(la, lb);\n return (lighter + 0.05) / (darker + 0.05);\n}\n",[],[135,172,221],"ac308654-498d-4298-96bd-8cc069cca144","testing","019f633d-0582-77fb-acd2-dee89530f904",["D",1784076371333],[234],[135,229],{"_34":235,"_13":236,"_37":237,"_39":230,"_41":42,"_43":44,"_45":46,"_47":238,"_17":63,"_50":81,"_51":239,"_53":54,"_55":-5,"_83":240,"_18":241},"30575e74-9370-411c-8a06-4402af2152fb","render.ts","933ab820-7fe6-11f1-82c9-1607ee4eb77e",["D",1784076371333],"/**\n * The render-to-HTML seam for component tests.\n *\n * Components are asserted through their *external* output — the semantic element\n * they emit, the token classes they carry, and their accessibility wiring — never\n * through their internal `variants()`/`cn()` calls. Server-rendering to a string\n * is the highest seam that still sees all of that, and it is uniform across the\n * whole component set.\n *\n * Asserting the emitted class string also guards ADR-0001's silent Twind failure:\n * a token utility that loses its `color:`/`length:` hint emits no CSS at all, which\n * surfaces here as an absent class rather than as an invisible styling bug.\n */\nimport type { ReactNode } from \"https://esm.sh/react@18.2.0\";\nimport { renderToStaticMarkup as render } from \"https://esm.sh/react-dom@18.2.0/server?deps=react@18.2.0&no-dts\";\n\n/**\n * Render an element to a static HTML string.\n *\n * The runtime import is `no-dts` (react-dom/server ships types Deno can't resolve\n * over esm.sh), so the signature is restored by annotation at this one boundary\n * instead of at every call site.\n */\nexport const renderToStaticMarkup: (element: ReactNode) => string = render;\n",[],[135,229,236],"54c062bb-13ee-444c-88e8-807490ff0543","components","56eb3bb6-6b54-11f1-95d4-1607ee4eb77e",49,["D",1781814540481],[249,250,251,252],[135,243],{"_34":274,"_13":275,"_37":276,"_39":244,"_41":42,"_43":98,"_45":46,"_47":277,"_17":278,"_50":81,"_51":279,"_53":54,"_55":-5,"_83":280,"_18":281},{"_34":267,"_13":268,"_37":269,"_39":244,"_41":42,"_43":44,"_45":46,"_47":270,"_17":167,"_50":81,"_51":271,"_53":54,"_55":-5,"_83":272,"_18":273},{"_34":260,"_13":261,"_37":262,"_39":244,"_41":42,"_43":44,"_45":46,"_47":263,"_17":63,"_50":81,"_51":264,"_53":54,"_55":-5,"_83":265,"_18":266},{"_34":253,"_13":254,"_37":255,"_39":244,"_41":42,"_43":44,"_45":46,"_47":256,"_17":63,"_50":81,"_51":257,"_53":54,"_55":-5,"_83":258,"_18":259},"3b6717d1-0cd8-4abf-a98e-5b1d127e571b","text_test.ts","933a5146-7fe6-11f1-82c9-1607ee4eb77e",["D",1784076371333],"import {\n assert,\n assertMatch,\n assertNotMatch,\n assertStringIncludes,\n} from \"jsr:@std/assert@1\";\nimport { createElement } from \"https://esm.sh/react@18.2.0\";\nimport { FONT_WEIGHT_STEPS, TYPE_STEPS } from \"../theme/tokens.ts\";\nimport { renderToStaticMarkup } from \"../testing/render.ts\";\nimport { Heading, Text, type TextTone } from \"./text.tsx\";\n\nDeno.test(\"Text renders a paragraph by default and honors the polymorphic `as`\", () => {\n assertMatch(renderToStaticMarkup(createElement(Text, null, \"Body\")), /^

{\n const html = renderToStaticMarkup(\n createElement(Text, { size: \"lg\" }, \"Body\"),\n );\n\n assertStringIncludes(html, \"text-[length:var(--kyla-text-lg)]\");\n assertStringIncludes(html, \"leading-[var(--kyla-text-lg-line-height)]\");\n});\n\nDeno.test(\"Text maps weight to a font-weight token\", () => {\n assertStringIncludes(\n renderToStaticMarkup(createElement(Text, { weight: \"bold\" }, \"Body\")),\n \"font-[weight:var(--kyla-font-weight-bold)]\",\n );\n});\n\nDeno.test(\"Text covers every step of the type and weight scales\", () => {\n // The props' unions derive from these constants, so a step added to a scale\n // without a matching variant entry would type-check and then emit nothing at\n // all — `variants()` skips an unknown key silently.\n for (const size of TYPE_STEPS) {\n assertStringIncludes(\n renderToStaticMarkup(createElement(Text, { size }, \"Body\")),\n `text-[length:var(--kyla-text-${size})]`,\n );\n }\n\n for (const weight of FONT_WEIGHT_STEPS) {\n assertStringIncludes(\n renderToStaticMarkup(createElement(Text, { weight }, \"Body\")),\n `font-[weight:var(--kyla-font-weight-${weight})]`,\n );\n }\n});\n\nDeno.test(\"Text tones resolve to the text-on-surface color tokens\", () => {\n const toneToken: Record = {\n \"fg\": \"fg\",\n \"fg-muted\": \"fg-muted\",\n // `accent`/`danger` are *fill* tokens; text tones must use the AA-verified\n // text-on-surface roles instead, or they render unreadably on a surface.\n \"accent\": \"accent-text\",\n \"danger\": \"danger-text\",\n };\n\n for (\n const [tone, token] of Object.entries(toneToken) as [TextTone, string][]\n ) {\n assertStringIncludes(\n renderToStaticMarkup(createElement(Text, { tone }, \"Body\")),\n `text-[color:var(--kyla-${token})]`,\n );\n }\n});\n\nDeno.test(\"Text emits its size and its tone together\", () => {\n // `text-*` is shared by font-size and color utilities. Without the\n // `length:`/`color:` hints (ADR-0001) twMerge would treat these as conflicting\n // and silently drop one, so assert both survive the same render.\n const html = renderToStaticMarkup(\n createElement(Text, { size: \"sm\", tone: \"fg-muted\" }, \"Body\"),\n );\n\n assertStringIncludes(html, \"text-[length:var(--kyla-text-sm)]\");\n assertStringIncludes(html, \"text-[color:var(--kyla-fg-muted)]\");\n});\n\nDeno.test(\"Text className wins over the component's own conflicting tone\", () => {\n const html = renderToStaticMarkup(\n createElement(\n Text,\n { tone: \"fg\", className: \"text-[color:var(--kyla-accent-text)]\" },\n \"Body\",\n ),\n );\n\n assertStringIncludes(html, \"text-[color:var(--kyla-accent-text)]\");\n assertNotMatch(html, /text-\\[color:var\$--kyla-fg\$\\]/);\n});\n\nDeno.test(\"Text forwards rest props to the underlying element\", () => {\n const html = renderToStaticMarkup(\n createElement(Text, { id: \"intro\", \"data-testid\": \"t\" }, \"Body\"),\n );\n\n assertStringIncludes(html, 'id=\"intro\"');\n assertStringIncludes(html, 'data-testid=\"t\"');\n});\n\nDeno.test(\"Heading renders the heading tag for its level\", () => {\n for (const level of [1, 2, 3, 4, 5, 6] as const) {\n assertMatch(\n renderToStaticMarkup(createElement(Heading, { level }, \"Title\")),\n new RegExp(`^ {\n assertMatch(\n renderToStaticMarkup(createElement(Heading, null, \"Title\")),\n /^

{\n const sizes = ([1, 2, 3, 4, 5, 6] as const).map((level) => {\n const html = renderToStaticMarkup(\n createElement(Heading, { level }, \"Title\"),\n );\n const match = html.match(/text-\\[length:var\$--kyla-text-([\\w-]+)\$\\]/);\n assert(match, `h${level} emitted no type-scale size`);\n return match[1];\n });\n\n assert(\n new Set(sizes).size === sizes.length,\n `each level needs its own step, got ${sizes.join(\", \")}`,\n );\n assertStringIncludes(sizes[0], \"3xl\");\n});\n\nDeno.test(\"Heading is semibold by default and lets an explicit weight win\", () => {\n assertStringIncludes(\n renderToStaticMarkup(createElement(Heading, null, \"Title\")),\n \"font-[weight:var(--kyla-font-weight-semibold)]\",\n );\n assertStringIncludes(\n renderToStaticMarkup(\n createElement(Heading, { weight: \"normal\" }, \"Title\"),\n ),\n \"font-[weight:var(--kyla-font-weight-normal)]\",\n );\n});\n\nDeno.test(\"Heading keeps its semantic level when size is overridden\", () => {\n // A small h1 is still an h1 — styling must not rewrite the document outline.\n const html = renderToStaticMarkup(\n createElement(Heading, { level: 1, size: \"base\" }, \"Title\"),\n );\n\n assertMatch(html, /^

` HTML shell in line with platform conventions (real `.html` file, no inline `

\n {title}\n