@navecss/tokens 0.1.0

package/LICENSE

@@ -0,0 +1,55 @@
+MIT License
+
+Copyright (c) 2026 Nave Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+THIRD-PARTY MATERIAL
+
+This package includes material copied from or derived from the CSS Color Module
+Level 4 specification and its published sample code (css-color-4/conversions.js
+in the w3c/csswg-drafts repository, at commit
+af8661bfe903aac7dbb9c5d1e1eccb725b8c331d, and
+https://drafts.csswg.org/css-color-4/#color-conversion-code). Copyright (c) 2026
+World Wide Web Consortium. That specification, and the repository carrying its
+sample code, are published under the W3C Software and Document License
+(https://www.w3.org/copyright/software-license-2023/).
+
+What is copied is the numeric constants used by src/theming/css-color-4.ts,
+published as dist/lib/theming/css-color-4.js, and the order of the conversion
+steps: the D50 white point, the CIE Lab kappa and epsilon, the Bradford D50 to
+D65 adaptation matrix, the linear display-p3 to XYZ matrix, and the two XYZ to
+OKLab matrices. The names, the types and the function bodies around them are
+this package's own, and everything in this package is offered under the MIT
+licence above.
+
+Also copied from that specification are the names of its colour keywords, held
+in src/theming/css-named-colours.ts and published as
+dist/lib/theming/css-named-colours.js. What is copied there is the keyword names
+alone, in alphabetical order, with none of the colour values the specification
+gives for them.
+
+This package implements the Design Tokens Format Module 2025.10 and the Design
+Tokens Color Module 2025.10, Final Community Group Reports published 28 October
+2025 by the Design Tokens Community Group under the W3C Community Final
+Specification Agreement. Those documents are not W3C Standards. What this
+package takes from them is the format's property names, type names and value
+structures, and the Color Module's colour-space identifiers; the reader, its
+diagnostics and everything around them are this package's own, and everything in
+this package is offered under the MIT licence above.

package/README.md

@@ -0,0 +1,122 @@
+# @navecss/tokens
+
+> DTCG 2025.10 design tokens for Nave, built by a first-party DTCG 2025.10 reader.
+
+## Installation
+
+```bash
+pnpm add @navecss/tokens
+```
+
+## Requirements
+
+- **Browsers: Chrome and Edge 125, Firefox 128, Safari 18 (Baseline 2024).** Every semantic colour in the stylesheet is a `light-dark()` pair, and most of them are also derived with relative colour syntax. An older browser drops whichever of them it does not support, without an error: surfaces and text lose their colours. Your CSS build has to target the same floor, or it rewrites `light-dark()` into an emulation that a `color-scheme` set from script, or on part of the page, does not switch. [Why this floor, and how to set your build's target](https://github.com/navecss/navecss/blob/main/docs/04-adr/0005-browser-floor.md).
+- **A resolver that reads `exports` maps.** Every entry point, `@navecss/tokens/css` included, is reachable only through the package's `exports` map: there is no `main` field to fall back on.
+- **ES modules, with no CommonJS build.** The JavaScript entry points load through `import`, and also through `require()`, which Node 22.18 supports for ES modules. In TypeScript, set `moduleResolution` to `bundler`, `node16` or `nodenext`; under `node10` the types are not found.
+- **Node 22.18 or later.**
+
+## Setup
+
+```css
+/* app.css */
+@import url('@navecss/tokens/css');
+```
+
+This emits the token layer's custom properties (`--nave-*`) inside `@layer tokens.defaults`. Keep the `/css`: unlike `@navecss/core`, whose bare package name is its stylesheet, the bare `@navecss/tokens` is the JavaScript entry point. `@navecss/core` imports this automatically; install `@navecss/tokens` on its own only if you are building without `@navecss/core` (for example, on top of Base UI or Radix UI directly).
+
+## What ships
+
+- **Colour** — the semantic colours consumers use (`action`, `content`, `surface`, `border`, `feedback`, and foregrounds for the primary action and the feedback roles), each with a light and a dark value through `light-dark()`. The `neutral`, `primary` and `danger` scales they are derived from stay inside the build: no step of them is emitted as a custom property. The neutral colours re-hue live from one custom property, under Theming below.
+- **Typography, spacing, size, shape, shadow, motion, z-index, opacity** — the rest of the token taxonomy, authored once in `tokens.json` and compiled by the first-party DTCG 2025.10 reader.
+- **Breakpoints** — a JS-only export (`@navecss/tokens/breakpoints`): custom properties cannot hold media-query ranges, so these ship as typed constants and prebuilt Level 4 media-query strings instead.
+
+Every custom property the stylesheet declares is listed in [TOKENS.md](./TOKENS.md).
+
+## The format this reads
+
+`tokens.json` is written to the Design Tokens Format Module 2025.10, a Final Community Group Report published on 28 October 2025. It is a community specification rather than a standards-track one, and this package implements it without claiming conformance, certification or endorsement.
+
+**The reader reads that one revision.** The format had a pre-stable draft for years, which wrote a dimension as `"16px"`, a font weight as `"400"` and a shadow layer's offsets as CSS strings, and that is still what most token tooling exports. A file in the draft shape is refused rather than guessed at: the refusal names every node in one run, says what the file is, and gives the edit each node needs for its own type. There is no second accepted shape, because a value that could be read either way is a value that can be read wrongly in silence.
+
+**One stated deviation, and it is in the source too.** 90 of this package's 93 tokens conform to that revision. `letterSpacing.tight`, `.normal` and `.wide` carry the unit `em`, which the format's `dimension` unit set (`px` and `rem`) does not include. `em` is lawful CSS and is the right unit for tracking, since it resolves against the element's own font size; converting the three would change what renders, so the deviation is stated rather than the value changed. The cost is real: a strict third-party reader will reject those three.
+
+## Exports
+
+| Export                          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@navecss/tokens`               | JS entry point — the typed constants described under `@navecss/tokens/js` below. Not a CSS entry: `@import url('@navecss/tokens/css')` is the stylesheet                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `@navecss/tokens/css`           | The generated stylesheet — `@import url('@navecss/tokens/css')`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `@navecss/tokens/js`            | Typed ESM token constants — the DTCG 2025.10 token set; every `--nave-color-*` custom property ships in the stylesheet above and not through this export, the `--nave-color-tint` seed included                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `@navecss/tokens/breakpoints`   | Breakpoint values, em conversions, media strings                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `@navecss/tokens/core-contract` | The shipped core-contract manifest, as JSON, for a token layer you generate yourself and load through `@navecss/core/no-tokens`: the `--nave-*` custom-property names `@navecss/core` reads, generated from that package's own source rather than listed by hand, and not the colour namespace alone. Import it with `with { type: 'json' }`. A clean check against it means those names are present rather than that your token set is complete; for what else it does and does not establish, read the header comment in `@navecss/core/no-tokens`. A validator reading the manifest directly should refuse a `formatVersion` higher than it understands, rather than mis-reading it. |
+| `@navecss/tokens/build`         | The token build as a JavaScript API: `build` and `validate`, the two operations the `navecss-tokens` binary wraps                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| `@navecss/tokens/tokens.json`   | The DTCG 2025.10 token source this package ships, the one `build` reads when given no `--source` — a starting point for writing your own (`--source`, below)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+
+## Theming
+
+Re-hue the neutral colours with one custom property, no build step required:
+
+```css
+@layer overrides {
+  :root {
+    --nave-color-tint: oklch(0.6 0.2 250);
+  }
+}
+```
+
+Changing this changes everything Nave derives from it. The contrast of the resulting palette follows from what you set, and checking it is yours.
+
+The neutral surface re-hues live, and so does the text set on the primary action and on danger (`--nave-color-on-action-primary` and `--nave-color-on-feedback-danger`), which is neutral too. The accent does not move: the primary action, links, the focus ring and the danger colours stay exactly as shipped. [TOKENS.md](./TOKENS.md) marks every colour that follows the tint. Moving the accent is a re-seed, which runs through the build below.
+
+Re-seeding, per-step overrides and bringing your own token source all run through the build below.
+
+## Building your own tokens
+
+This package ships a build you run yourself. Give it a seed colour and it
+regenerates the whole token layer from that colour, into a directory you commit.
+
+```json
+{
+  "scripts": {
+    "tokens": "navecss-tokens build --seed=#2f6feb --out=src/styles/nave"
+  }
+}
+```
+
+Changing this changes everything Nave derives from it. The contrast of the resulting palette follows from what you set, and checking it is yours.
+
+Two subcommands, four flags, and no configuration file: the build discovers no
+configuration — it searches no directory and reads no config file.
+
+| flag          | subcommand          | what it takes                                                                                                                                                |
+| ------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `--seed`      | `build`             | **Required.** The colour everything is derived from, as `#rrggbb`, `rgb()`, `hsl()`, `oklch()`, `lab()`, `lch()` or `color()` (`srgb` or `display-p3`)       |
+| `--out`       | `build`             | **Required.** The directory the generated files are written to                                                                                               |
+| `--source`    | `build`, `validate` | A DTCG 2025.10 `.json` token source. `build` defaults to the one this package ships; `validate` requires it, and also accepts a stylesheet you already built |
+| `--overrides` | `build`             | A JSON file pinning individual ramp steps, keyed by scale (`primary`, `danger` or `neutral`) then step number, to a chroma: `{ "primary": { "500": 0.11 } }` |
+
+Write `--flag=value` and not `--flag value`. A `#rrggbb` seed passed as a
+separate word begins a shell comment, so the rest of the command is discarded
+and you get a usage error rather than a wrong colour.
+
+0.1.0 ships no consumer contrast-threshold input. No flag of this entry point sets one, and the build reads none. This is the absence of an input, not a limit on the consumer: a consumer may hold whatever contrast target they choose and check their palette against it with their own tooling. Where a check Nave ships runs in a consumer's build over the consumer's values, it reports and does not fail. A consumer-settable target is deliberately out of 0.1.0 rather than overlooked.
+
+```bash
+navecss-tokens validate --source=src/styles/nave/tokens.css
+```
+
+`validate` checks a token source, or a stylesheet you built yourself, against
+the core contract: the `--nave-*` custom-property names `@navecss/core` reads,
+not the colour ones alone. It reports the names in that contract your source
+does not declare, and it checks nothing else, so a clean run means those names
+are present rather than that your token set is complete.
+
+Both operations are also a JavaScript API, exported as `@navecss/tokens/build`,
+for a build system that would rather call a function than spawn a process.
+
+The exit code is `0` when the run succeeded and `1` when the work failed on its
+merits. `2` is not a verdict on your tokens at all: a run that exits `2`
+reports none, so read `2` as no answer rather than as a bad one. `1` is also
+where a failure the tool has no more specific code for ends up, so a `1` always
+means the run failed and does not always mean your tokens did. Either way the
+message says what happened, and the code is what a script branches on.

package/TOKENS.md

@@ -0,0 +1,180 @@
+# TOKENS.md
+
+Generated from the token build; do not edit by hand.
+
+Every custom property `@navecss/tokens` declares, grouped, with colour's own follows-tint
+column: whether re-hueing `--nave-color-tint` moves that property. Values are not shown —
+a colour's value is a `light-dark()` expression that informs nobody on its own, and a
+non-colour value is exactly what its name says.
+
+## Font
+
+| Custom property               |
+| ----------------------------- |
+| `--nave-font-family-base`     |
+| `--nave-font-family-display`  |
+| `--nave-font-family-mono`     |
+| `--nave-font-size-xs`         |
+| `--nave-font-size-sm`         |
+| `--nave-font-size-md`         |
+| `--nave-font-size-lg`         |
+| `--nave-font-size-xl`         |
+| `--nave-font-size-2xl`        |
+| `--nave-font-size-3xl`        |
+| `--nave-font-size-4xl`        |
+| `--nave-font-weight-regular`  |
+| `--nave-font-weight-medium`   |
+| `--nave-font-weight-semibold` |
+| `--nave-font-weight-bold`     |
+
+## Line height
+
+| Custom property              |
+| ---------------------------- |
+| `--nave-line-height-none`    |
+| `--nave-line-height-tight`   |
+| `--nave-line-height-snug`    |
+| `--nave-line-height-base`    |
+| `--nave-line-height-relaxed` |
+| `--nave-line-height-loose`   |
+
+## Letter spacing
+
+| Custom property                |
+| ------------------------------ |
+| `--nave-letter-spacing-tight`  |
+| `--nave-letter-spacing-normal` |
+| `--nave-letter-spacing-wide`   |
+
+## Spacing
+
+| Custom property             |
+| --------------------------- |
+| `--nave-spacing-content-xs` |
+| `--nave-spacing-content-sm` |
+| `--nave-spacing-content-md` |
+| `--nave-spacing-content-lg` |
+| `--nave-spacing-content-xl` |
+| `--nave-spacing-layout-xs`  |
+| `--nave-spacing-layout-sm`  |
+| `--nave-spacing-layout-md`  |
+| `--nave-spacing-layout-lg`  |
+| `--nave-spacing-control-xs` |
+| `--nave-spacing-control-sm` |
+| `--nave-spacing-control-md` |
+| `--nave-spacing-control-lg` |
+
+## Size
+
+| Custom property          |
+| ------------------------ |
+| `--nave-size-control-xs` |
+| `--nave-size-control-sm` |
+| `--nave-size-control-md` |
+| `--nave-size-control-lg` |
+| `--nave-size-icon-xs`    |
+| `--nave-size-icon-sm`    |
+| `--nave-size-icon-md`    |
+| `--nave-size-icon-lg`    |
+| `--nave-size-icon-xl`    |
+| `--nave-size-avatar-sm`  |
+| `--nave-size-avatar-md`  |
+| `--nave-size-avatar-lg`  |
+
+## Border width
+
+| Custom property             |
+| --------------------------- |
+| `--nave-border-width-none`  |
+| `--nave-border-width-sm`    |
+| `--nave-border-width-focus` |
+| `--nave-border-width-lg`    |
+
+## Radius
+
+| Custom property         |
+| ----------------------- |
+| `--nave-radius-none`    |
+| `--nave-radius-sm`      |
+| `--nave-radius-control` |
+| `--nave-radius-card`    |
+| `--nave-radius-overlay` |
+| `--nave-radius-full`    |
+
+## Shadow
+
+| Custom property         |
+| ----------------------- |
+| `--nave-shadow-none`    |
+| `--nave-shadow-raised`  |
+| `--nave-shadow-overlay` |
+| `--nave-shadow-modal`   |
+
+## Opacity
+
+| Custom property           |
+| ------------------------- |
+| `--nave-opacity-disabled` |
+
+## Layer (z-index)
+
+| Custom property         |
+| ----------------------- |
+| `--nave-layer-base`     |
+| `--nave-layer-dropdown` |
+| `--nave-layer-sticky`   |
+| `--nave-layer-overlay`  |
+| `--nave-layer-modal`    |
+| `--nave-layer-toast`    |
+| `--nave-layer-tooltip`  |
+
+## Motion
+
+| Custom property                   |
+| --------------------------------- |
+| `--nave-motion-duration-instant`  |
+| `--nave-motion-duration-fast`     |
+| `--nave-motion-duration-base`     |
+| `--nave-motion-duration-slow`     |
+| `--nave-motion-easing-standard`   |
+| `--nave-motion-easing-decelerate` |
+| `--nave-motion-easing-accelerate` |
+
+## Colour
+
+| Custom property                            | Follows `--nave-color-tint` |
+| ------------------------------------------ | --------------------------- |
+| `--nave-color-tint`                        | no                          |
+| `--nave-color-surface-base`                | yes                         |
+| `--nave-color-surface-raised`              | yes                         |
+| `--nave-color-surface-overlay`             | yes                         |
+| `--nave-color-surface-sunken`              | yes                         |
+| `--nave-color-surface-inverse`             | yes                         |
+| `--nave-color-content-primary`             | yes                         |
+| `--nave-color-content-secondary`           | yes                         |
+| `--nave-color-content-tertiary`            | yes                         |
+| `--nave-color-content-disabled`            | yes                         |
+| `--nave-color-content-inverse`             | yes                         |
+| `--nave-color-content-link`                | no                          |
+| `--nave-color-border-default`              | yes                         |
+| `--nave-color-border-strong`               | yes                         |
+| `--nave-color-border-control`              | yes                         |
+| `--nave-color-border-disabled`             | yes                         |
+| `--nave-color-border-focus`                | no                          |
+| `--nave-color-action-primary`              | no                          |
+| `--nave-color-action-primary-hover`        | no                          |
+| `--nave-color-action-primary-active`       | no                          |
+| `--nave-color-on-action-primary`           | yes                         |
+| `--nave-color-action-secondary`            | yes                         |
+| `--nave-color-feedback-danger`             | no                          |
+| `--nave-color-feedback-danger-foreground`  | no                          |
+| `--nave-color-on-feedback-danger`          | yes                         |
+| `--nave-color-feedback-warning`            | yes                         |
+| `--nave-color-feedback-warning-foreground` | yes                         |
+| `--nave-color-on-feedback-warning`         | yes                         |
+| `--nave-color-feedback-success`            | yes                         |
+| `--nave-color-feedback-success-foreground` | yes                         |
+| `--nave-color-on-feedback-success`         | yes                         |
+| `--nave-color-feedback-info`               | yes                         |
+| `--nave-color-feedback-info-foreground`    | yes                         |
+| `--nave-color-on-feedback-info`            | yes                         |

package/dist/breakpoints.d.ts

@@ -0,0 +1,25 @@
+/* Nave Design System — generated, do not edit */
+
+export declare const breakpoints: {
+  readonly tabletPortrait: 600
+  readonly tabletLandscape: 900
+  readonly desktop: 1200
+  readonly wide: 1800
+}
+export declare type BreakpointName = keyof typeof breakpoints
+
+export declare const em: {
+  readonly tabletPortrait: '37.5em'
+  readonly tabletLandscape: '56.25em'
+  readonly desktop: '75em'
+  readonly wide: '112.5em'
+}
+
+export declare const media: {
+  readonly phoneOnly: '(width < 37.5em)'
+  readonly tabletPortraitUp: '(width >= 37.5em)'
+  readonly tabletLandscapeUp: '(width >= 56.25em)'
+  readonly desktopUp: '(width >= 75em)'
+  readonly wideUp: '(width >= 112.5em)'
+}
+export declare type MediaName = keyof typeof media

package/dist/breakpoints.js

@@ -0,0 +1,44 @@
+/**
+ * Nave breakpoints — generated from tokens.json
+ * Do not edit directly. Run `pnpm build` in packages/tokens to regenerate.
+ *
+ * breakpoints — raw px boundary values (number, no unit)
+ *   These are the design decisions. Edit tokens.json to change them.
+ *
+ * em — boundary values in em units (base: 16px)
+ *   For reference. The media strings below use these values.
+ *
+ * media — pre-built Level 4 media query condition strings
+ *   Use as @media keys in atoms.ts and consumer atoms.
+ *   Never write breakpoint values as magic numbers in your codebase.
+ *
+ * Syntax: Level 4 range queries — (width < Xem) / (width >= Xem)
+ *   phoneOnly and tabletPortraitUp share the same boundary value (37.5em).
+ *   < is exclusive upper bound, >= is inclusive lower bound.
+ *   No overlap, no gap, no rounding issues at any device pixel ratio.
+ *
+ * Why em: resolves against the browser's default font size, a user setting
+ *   (not page zoom, which scales px and em alike).
+ */
+
+export const breakpoints = {
+  tabletPortrait: 600,
+  tabletLandscape: 900,
+  desktop: 1200,
+  wide: 1800
+}
+
+export const em = {
+  tabletPortrait: '37.5em',
+  tabletLandscape: '56.25em',
+  desktop: '75em',
+  wide: '112.5em'
+}
+
+export const media = {
+  phoneOnly: '(width < 37.5em)',
+  tabletPortraitUp: '(width >= 37.5em)',
+  tabletLandscapeUp: '(width >= 56.25em)',
+  desktopUp: '(width >= 75em)',
+  wideUp: '(width >= 112.5em)'
+}

package/dist/build-record.json

@@ -0,0 +1,77 @@
+{
+  "spec": "documented in this package's README (\"Theming\")",
+  "targetGamut": {
+    "gamut": "srgb",
+    "assumption": "sRGB is the target gamut, stated as an explicit assumption. Every generated value is expressible in sRGB and no wide-gamut colour function is emitted. Wide-gamut (display-p3) output is a deliberate v1 non-goal: a future wide-gamut output regenerates the ramp rather than reusing this one."
+  },
+  "seeds": {
+    "primary": {
+      "input": {
+        "form": "oklch",
+        "value": {
+          "l": 0.7859,
+          "c": 0.1316,
+          "h": 186.17
+        }
+      },
+      "resolved": {
+        "l": 0.7859,
+        "c": 0.1316,
+        "h": 186.17
+      },
+      "intensityScalar": 0.9554792165204288,
+      "sLightness": 0.7859,
+      "substitutions": {
+        "lightnessBandClamped": {
+          "applied": false
+        },
+        "normalized": {
+          "applied": false
+        }
+      },
+      "achromatic": false,
+      "seedColourAppearsInRamp": false
+    },
+    "danger": {
+      "input": {
+        "form": "oklch",
+        "value": {
+          "l": 0.6357,
+          "c": 0.2072,
+          "h": 15.02
+        }
+      },
+      "resolved": {
+        "l": 0.6357,
+        "c": 0.2072,
+        "h": 15.02
+      },
+      "intensityScalar": 0.8152849011743798,
+      "sLightness": 0.6357,
+      "substitutions": {
+        "lightnessBandClamped": {
+          "applied": false
+        },
+        "normalized": {
+          "applied": false
+        }
+      },
+      "achromatic": false,
+      "seedColourAppearsInRamp": false
+    }
+  },
+  "achromaticBranch": {
+    "selected": false,
+    "substitutedSlots": []
+  },
+  "tint": {
+    "hue": 186.17,
+    "source": "primary-seed"
+  },
+  "openAdjacencySlots": [
+    "border.strong",
+    "feedback.warning.foreground",
+    "feedback.success.foreground",
+    "feedback.info.foreground"
+  ]
+}

package/dist/core-contract.json

@@ -0,0 +1,30 @@
+{
+  "formatVersion": 1,
+  "producer": {
+    "name": "@navecss/core",
+    "version": "0.1.0"
+  },
+  "tokens": [
+    "--nave-border-width-focus",
+    "--nave-border-width-sm",
+    "--nave-color-border-default",
+    "--nave-color-border-disabled",
+    "--nave-color-border-focus",
+    "--nave-color-content-disabled",
+    "--nave-color-content-primary",
+    "--nave-color-surface-base",
+    "--nave-font-family-base",
+    "--nave-font-family-display",
+    "--nave-font-family-mono",
+    "--nave-font-size-md",
+    "--nave-font-weight-bold",
+    "--nave-line-height-base",
+    "--nave-line-height-tight",
+    "--nave-motion-duration-base",
+    "--nave-motion-easing-standard",
+    "--nave-radius-card",
+    "--nave-radius-control",
+    "--nave-radius-full",
+    "--nave-spacing-content-md"
+  ]
+}

package/dist/lib/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/lib/bin.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { build, DuplicateTokenNameRefusal, MissingContractTokensError, SeedIngestRefusal, TokenCollisionRefusal, UsageError, validate, } from "./facade.js";
+function normalizationQualifier(seedNormalization) {
+    switch (seedNormalization) {
+        case 'chroma-reduced': {
+            return ' (chroma reduced to fit sRGB)';
+        }
+        case 'mapped-to-black': {
+            return ' (mapped to black to fit sRGB)';
+        }
+        case 'mapped-to-white': {
+            return ' (mapped to white to fit sRGB)';
+        }
+        default: {
+            return '';
+        }
+    }
+}
+const USAGE = 'Usage:\n' +
+    '  navecss-tokens build --seed=<colour> --out=<dir> [--source=<file>] [--overrides=<file>]\n' +
+    '  navecss-tokens validate --source=<file>';
+function parseBuildArgs(args) {
+    let values;
+    try {
+        ;
+        ({ values } = parseArgs({
+            args,
+            options: {
+                out: { type: 'string' },
+                overrides: { type: 'string' },
+                seed: { type: 'string' },
+                source: { type: 'string' },
+            },
+            strict: true,
+        }));
+    }
+    catch (error) {
+        throw new UsageError(error.message);
+    }
+    if (!values.seed)
+        throw new UsageError(`build requires --seed=<colour>.\n${USAGE}`);
+    if (!values.out)
+        throw new UsageError(`build requires --out=<dir>.\n${USAGE}`);
+    return {
+        outDir: values.out,
+        seed: values.seed,
+        ...(values.source !== undefined && { source: values.source }),
+        ...(values.overrides !== undefined && { overrides: values.overrides }),
+    };
+}
+function parseValidateArgs(args) {
+    let values;
+    try {
+        ;
+        ({ values } = parseArgs({ args, options: { source: { type: 'string' } }, strict: true }));
+    }
+    catch (error) {
+        throw new UsageError(error.message);
+    }
+    if (!values.source)
+        throw new UsageError(`validate requires --source=<file>.\n${USAGE}`);
+    return { source: values.source };
+}
+function isHelpRequest(args) {
+    return args.includes('--help') || args.includes('-h');
+}
+async function main() {
+    const [subcommand, ...rest] = process.argv.slice(2);
+    if (subcommand === '--help' || subcommand === '-h') {
+        console.log(USAGE);
+        return 0;
+    }
+    if (subcommand === 'build') {
+        if (isHelpRequest(rest)) {
+            console.log(USAGE);
+            return 0;
+        }
+        const result = await build(parseBuildArgs(rest));
+        console.log(`Built from seed ${result.resolvedSeed}${normalizationQualifier(result.seedNormalization)}: ${result.files.join(', ')}`);
+        return 0;
+    }
+    if (subcommand === 'validate') {
+        if (isHelpRequest(rest)) {
+            console.log(USAGE);
+            return 0;
+        }
+        const result = await validate(parseValidateArgs(rest));
+        for (const line of result.output)
+            console.log(line);
+        return result.exitCode;
+    }
+    throw new UsageError(`unknown subcommand "${subcommand ?? ''}".\n${USAGE}`);
+}
+try {
+    process.exitCode = await main();
+}
+catch (error) {
+    if (error instanceof UsageError || error instanceof SeedIngestRefusal) {
+        console.error(error.message);
+        process.exitCode = 2;
+    }
+    else if (error instanceof MissingContractTokensError ||
+        error instanceof TokenCollisionRefusal ||
+        error instanceof DuplicateTokenNameRefusal) {
+        console.error(error.message);
+        process.exitCode = 1;
+    }
+    else {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    }
+}