@navecss/tokens 0.1.0

package/dist/lib/token-name.js

@@ -0,0 +1,28 @@
+const SPLIT_LOWER_UPPER_RE = /([\p{Ll}\d])(\p{Lu})/gu;
+const SPLIT_UPPER_UPPER_RE = /(\p{Lu})([\p{Lu}][\p{Ll}])/gu;
+const STRIP_RE = /[^\p{L}\d]+/gu;
+function splitWords(value) {
+    let result = value.trim();
+    result = result
+        .replaceAll(SPLIT_LOWER_UPPER_RE, '$1\0$2')
+        .replaceAll(SPLIT_UPPER_UPPER_RE, '$1\0$2');
+    result = result.replaceAll(STRIP_RE, '\0');
+    let start = 0;
+    let end = result.length;
+    while (result.charAt(start) === '\0')
+        start++;
+    if (start === end)
+        return [];
+    while (result.charAt(end - 1) === '\0')
+        end--;
+    return result.slice(start, end).split('\0');
+}
+export function kebabName(path) {
+    return splitWords(path.join(' '))
+        .map((w) => w.toLowerCase())
+        .join('-');
+}
+export function nameFromPath(path) {
+    const namePath = path.length > 1 && path[0] === 'nave' ? path.slice(1) : path;
+    return kebabName(namePath);
+}

package/dist/lib/validate-report.d.ts

@@ -0,0 +1,19 @@
+import type { CoreContractManifest, ManifestVersionSkew } from './theming/core-contract.ts';
+export interface ManifestFormatRefusal {
+    found: number;
+    supported: number;
+}
+export declare function checkManifestFormatSupport(manifest: CoreContractManifest): ManifestFormatRefusal | undefined;
+export type CoreVersionReportStatus = {
+    status: 'resolved';
+} | {
+    status: 'not-installed';
+} | {
+    status: 'unresolvable';
+} | {
+    message: string;
+    status: 'unreadable';
+};
+export declare function formatValidateReport(manifest: CoreContractManifest, missing: readonly string[], versionSkew: ManifestVersionSkew | undefined, coreVersionStatus?: CoreVersionReportStatus & {
+    supplied?: readonly string[];
+}): string[];

package/dist/lib/validate-report.js

@@ -0,0 +1,93 @@
+import { MANIFEST_FORMAT_VERSION } from "./theming/core-contract.js";
+export function checkManifestFormatSupport(manifest) {
+    if (manifest.formatVersion <= MANIFEST_FORMAT_VERSION)
+        return undefined;
+    return { found: manifest.formatVersion, supported: MANIFEST_FORMAT_VERSION };
+}
+const NAMESPACE_PREAMBLE = 'Contract names below are the emitted CSS custom-property spelling (for example ' +
+    '--nave-color-surface-base). Your DTCG 2025.10 source names the same node with the "--nave-" ' +
+    'prefix dropped and hyphens read as a dotted path (color.surface.base).';
+const SCOPE_STATEMENT = 'This check is one-directional: it reports every core contract name missing from your ' +
+    'source. A token in your source beyond the contract is never an error.';
+const NO_INSTALLED_CORE_DISCLAIMER = 'No installed @navecss/core was found, so no version-skew check ran.';
+function producerOf(manifest) {
+    return `${manifest.producer.name}@${manifest.producer.version} (manifest format ${manifest.formatVersion})`;
+}
+function recordedProducerOf(manifest) {
+    return `the manifest's own recorded ${producerOf(manifest)}`;
+}
+function formatSuccessLine(manifest, coreStatus, suppliedCount) {
+    const checkable = manifest.tokens.length - suppliedCount;
+    const provenance = producerOf(manifest);
+    if (coreStatus.status === 'not-installed') {
+        const scope = checkable === 0
+            ? `every contract name is supplied by \`navecss-tokens build\`'s theming layer from ` +
+                `your seed, so none could have been checked as missing (true only if you build ` +
+                `with that tool)`
+            : `${checkable} name(s) checked`;
+        return `0 missing against ${recordedProducerOf(manifest)}, ${scope}. ${NO_INSTALLED_CORE_DISCLAIMER}`;
+    }
+    if (checkable === 0) {
+        return (`Every contract name is supplied by \`navecss-tokens build\`'s theming layer from your ` +
+            `seed, so none could have been checked as missing (true only if you build with that ` +
+            `tool). Manifest from ${provenance}.`);
+    }
+    return `0 missing. Checked ${checkable} name(s) from ${provenance}.`;
+}
+function formatMissingLines(manifest, missing, coreStatus, suppliedCount) {
+    if (missing.length === 0)
+        return [formatSuccessLine(manifest, coreStatus, suppliedCount)];
+    const provenance = coreStatus.status === 'not-installed'
+        ? `Checked against ${recordedProducerOf(manifest)}. ${NO_INSTALLED_CORE_DISCLAIMER}`
+        : `Checked against ${producerOf(manifest)}.`;
+    return [`${missing.length} missing name(s):`, ...missing.map((name) => `  ${name}`), provenance];
+}
+function formatSuppliedLines(supplied) {
+    if (supplied.length === 0)
+        return [];
+    return [
+        `${supplied.length} more name(s) are not in your source but are emitted by ` +
+            `\`navecss-tokens build\`'s theming layer from your seed, so they are not counted as ` +
+            `missing above (true only if you build with that tool):`,
+        ...supplied.map((name) => `  ${name}`),
+    ];
+}
+export function formatValidateReport(manifest, missing, versionSkew, coreVersionStatus) {
+    const coreStatus = coreVersionStatus ?? { status: 'resolved' };
+    const supplied = coreVersionStatus?.supplied ?? [];
+    const formatRefusal = checkManifestFormatSupport(manifest);
+    if (formatRefusal) {
+        return [
+            `Unrecognized manifest format: this manifest declares format ` +
+                `${formatRefusal.found}, and this @navecss/tokens understands manifest format ` +
+                `${formatRefusal.supported} at most. Upgrade @navecss/tokens to read this manifest.`,
+        ];
+    }
+    if (coreStatus.status === 'unreadable') {
+        return [
+            `Could not read the installed @navecss/core's package.json to check for version ` +
+                `skew (${coreStatus.message}). Reinstall @navecss/core and try again.`,
+        ];
+    }
+    if (coreStatus.status === 'unresolvable') {
+        return [
+            `Could not determine the installed @navecss/core's version: this @navecss/tokens ` +
+                `checks it via @navecss/core's own "./package.json" export, which the installed ` +
+                `@navecss/core does not declare. Upgrade @navecss/core, or reinstall matching ` +
+                `versions, before trusting a validate result.`,
+        ];
+    }
+    if (versionSkew) {
+        return [
+            `Version skew: this manifest was recorded against ${manifest.producer.name}@` +
+                `${versionSkew.recorded}, but the installed ${manifest.producer.name} is @` +
+                `${versionSkew.installed}. Reinstall matching versions before trusting this result.`,
+        ];
+    }
+    return [
+        NAMESPACE_PREAMBLE,
+        ...formatMissingLines(manifest, missing, coreStatus, supplied.length),
+        ...formatSuppliedLines(supplied),
+        SCOPE_STATEMENT,
+    ];
+}

package/dist/lib/validate.d.ts

@@ -0,0 +1,16 @@
+import type { CoreContractManifest } from './theming/core-contract.ts';
+export type ValidateSourceKind = 'css' | 'json';
+export declare function detectSourceKind(filePath: string): ValidateSourceKind | undefined;
+export declare function scanDeclaredCustomProperties(css: string): Set<string>;
+export declare function namesFromDtcgSource(source: unknown, sourceName?: string): Set<string>;
+export type ValidateSourceLabel = {
+    path: string;
+} | {
+    phrase: string;
+};
+export declare function namesFromSource(kind: ValidateSourceKind, content: string, source?: ValidateSourceLabel): Set<string>;
+export declare function computeMissing(manifest: CoreContractManifest, kind: ValidateSourceKind, content: string, source?: ValidateSourceLabel): string[];
+export declare function splitMissingBySupply(kind: ValidateSourceKind, notDeclared: readonly string[]): {
+    missing: string[];
+    supplied: string[];
+};

package/dist/lib/validate.js

@@ -0,0 +1,65 @@
+import { UsageError } from "./errors.js";
+import { readTokens } from "./reader.js";
+import { validateAgainstManifest } from "./theming/core-contract.js";
+import { shippedThemingPropertyNames } from "./theming/emit.js";
+export function detectSourceKind(filePath) {
+    const lowered = filePath.toLowerCase();
+    if (lowered.endsWith('.css'))
+        return 'css';
+    if (lowered.endsWith('.json'))
+        return 'json';
+    return undefined;
+}
+const DECLARED_CUSTOM_PROPERTY_RE = /(--[a-zA-Z0-9-]+)\s*:/g;
+const CSS_COMMENT_RE = /\/\*[\s\S]*?\*\//g;
+export function scanDeclaredCustomProperties(css) {
+    const found = new Set();
+    const declarations = css.replaceAll(CSS_COMMENT_RE, '');
+    for (const match of declarations.matchAll(DECLARED_CUSTOM_PROPERTY_RE))
+        found.add(match[1]);
+    return found;
+}
+export function namesFromDtcgSource(source, sourceName) {
+    const tokens = readTokens(source, sourceName);
+    return new Set(tokens.map((t) => `--nave-${t.name}`));
+}
+const DEFAULT_SOURCE_LABEL = { phrase: 'this validate source' };
+function printSourceLabel(source) {
+    return 'path' in source ? `"${source.path}"` : source.phrase;
+}
+export function namesFromSource(kind, content, source = DEFAULT_SOURCE_LABEL) {
+    if (kind === 'css')
+        return scanDeclaredCustomProperties(content);
+    const sourceLabel = printSourceLabel(source);
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch (error) {
+        throw new UsageError(`${sourceLabel} is not valid JSON: ${error.message}`);
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new UsageError(`${sourceLabel} is not a DTCG 2025.10 token document: its JSON root is ${describeRoot(parsed)}, ` +
+            `not an object.`);
+    }
+    return namesFromDtcgSource(parsed, 'path' in source ? source.path : undefined);
+}
+function describeRoot(root) {
+    if (root === null)
+        return 'null';
+    if (Array.isArray(root))
+        return 'an array';
+    return `a ${typeof root}`;
+}
+export function computeMissing(manifest, kind, content, source) {
+    return validateAgainstManifest(manifest, namesFromSource(kind, content, source));
+}
+export function splitMissingBySupply(kind, notDeclared) {
+    if (kind === 'css')
+        return { missing: [...notDeclared], supplied: [] };
+    const supplied = shippedThemingPropertyNames();
+    return {
+        missing: notDeclared.filter((name) => !supplied.has(name)),
+        supplied: notDeclared.filter((name) => supplied.has(name)),
+    };
+}

package/dist/palette-record.json

@@ -0,0 +1,293 @@
+{
+  "aboutThisFile": "This file is a resolved palette record: what this build produced for every semantic colour slot, in both schemes. It is not a DTCG 2025.10 document, and it is not meant to be read by a DTCG 2025.10 tool, because its keys are flat dotted names and most of its values are relative-colour-syntax strings, neither of which that format expresses. The token document is tokens.json, shipped beside it.",
+  "color.surface.base.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 1 0 h)"
+  },
+  "color.surface.base.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.18 0.0067 h)"
+  },
+  "color.surface.raised.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 1 0 h)"
+  },
+  "color.surface.raised.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.225 0.0067 h)"
+  },
+  "color.surface.overlay.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 1 0 h)"
+  },
+  "color.surface.overlay.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.27 0.0067 h)"
+  },
+  "color.surface.sunken.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.985 0.0067 h)"
+  },
+  "color.surface.sunken.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.12 0.0067 h)"
+  },
+  "color.surface.inverse.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.18 0.0067 h)"
+  },
+  "color.surface.inverse.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.965 0.0067 h)"
+  },
+  "color.content.primary.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.18 0.0067 h)"
+  },
+  "color.content.primary.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.965 0.0067 h)"
+  },
+  "color.content.secondary.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.37 0.0067 h)"
+  },
+  "color.content.secondary.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.835 0.0067 h)"
+  },
+  "color.content.tertiary.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.47 0.0067 h)",
+    "$description": "Placeholder and hint text only."
+  },
+  "color.content.tertiary.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.72 0.0067 h)",
+    "$description": "Placeholder and hint text only."
+  },
+  "color.content.disabled.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.835 0.0067 h)",
+    "$description": "Text inside a disabled interactive component."
+  },
+  "color.content.disabled.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.37 0.0067 h)",
+    "$description": "Text inside a disabled interactive component."
+  },
+  "color.content.inverse.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.965 0.0067 h)",
+    "$description": "Declared foreground for surface.inverse."
+  },
+  "color.content.inverse.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.18 0.0067 h)",
+    "$description": "Declared foreground for surface.inverse."
+  },
+  "color.content.link.light": {
+    "$type": "color",
+    "$value": "oklch(0.47 0.0748 186.17)",
+    "$description": "Do not distinguish a link by colour alone. Nave's own examples keep a non-colour distinction wherever this token is shown."
+  },
+  "color.content.link.dark": {
+    "$type": "color",
+    "$value": "oklch(0.835 0.123 186.17)",
+    "$description": "Do not distinguish a link by colour alone. Nave's own examples keep a non-colour distinction wherever this token is shown."
+  },
+  "color.border.default.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.905 0.0067 h)",
+    "$description": "Decorative dividers and card edges."
+  },
+  "color.border.default.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.37 0.0067 h)",
+    "$description": "Decorative dividers and card edges."
+  },
+  "color.border.strong.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.72 0.0067 h)"
+  },
+  "color.border.strong.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.47 0.0067 h)"
+  },
+  "color.border.control.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.59 0.0067 h)",
+    "$description": "Identifying boundary for a control (inputs, form boundaries, and the secondary action control)."
+  },
+  "color.border.control.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.59 0.0067 h)",
+    "$description": "Identifying boundary for a control (inputs, form boundaries, and the secondary action control)."
+  },
+  "color.border.disabled.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.94 0.0067 h)"
+  },
+  "color.border.disabled.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.27 0.0067 h)"
+  },
+  "color.border.focus.light": {
+    "$type": "color",
+    "$value": "oklch(0.59 0.0939 186.17)"
+  },
+  "color.border.focus.dark": {
+    "$type": "color",
+    "$value": "oklch(0.59 0.0939 186.17)"
+  },
+  "color.action.primary.light": {
+    "$type": "color",
+    "$value": "oklch(0.47 0.0748 186.17)"
+  },
+  "color.action.primary.dark": {
+    "$type": "color",
+    "$value": "oklch(0.835 0.123 186.17)"
+  },
+  "color.action.primary.hover.light": {
+    "$type": "color",
+    "$value": "oklch(0.37 0.0589 186.17)"
+  },
+  "color.action.primary.hover.dark": {
+    "$type": "color",
+    "$value": "oklch(0.905 0.1106 186.17)"
+  },
+  "color.action.primary.active.light": {
+    "$type": "color",
+    "$value": "oklch(0.27 0.0398 186.17)"
+  },
+  "color.action.primary.active.dark": {
+    "$type": "color",
+    "$value": "oklch(0.94 0.0574 186.17)"
+  },
+  "color.on-action.primary.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 1 0 h)"
+  },
+  "color.on-action.primary.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.18 0.0067 h)"
+  },
+  "color.action.secondary.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.965 0.0067 h)"
+  },
+  "color.action.secondary.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.27 0.0067 h)"
+  },
+  "color.feedback.danger.light": {
+    "$type": "color",
+    "$value": "oklch(0.47 0.1455 15.02)",
+    "$description": "Solid-background role for a destructive control or error state."
+  },
+  "color.feedback.danger.dark": {
+    "$type": "color",
+    "$value": "oklch(0.835 0.0661 15.02)",
+    "$description": "Solid-background role for a destructive control or error state."
+  },
+  "color.feedback.danger.foreground.light": {
+    "$type": "color",
+    "$value": "oklch(0.47 0.1455 15.02)",
+    "$description": "Foreground role for danger text and icons."
+  },
+  "color.feedback.danger.foreground.dark": {
+    "$type": "color",
+    "$value": "oklch(0.835 0.0661 15.02)",
+    "$description": "Foreground role for danger text and icons."
+  },
+  "color.on-feedback.danger.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 1 0 h)",
+    "$description": "Declared foreground for the solid feedback.danger background."
+  },
+  "color.on-feedback.danger.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.18 0.0067 h)",
+    "$description": "Declared foreground for the solid feedback.danger background."
+  },
+  "color.feedback.warning.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.47 0.0067 h)",
+    "$description": "Solid-background role for a warning state (shared tinted-neutral family)."
+  },
+  "color.feedback.warning.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.835 0.0067 h)",
+    "$description": "Solid-background role for a warning state (shared tinted-neutral family)."
+  },
+  "color.feedback.warning.foreground.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.47 0.0067 h)",
+    "$description": "Foreground role for warning text and icons."
+  },
+  "color.feedback.warning.foreground.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.835 0.0067 h)",
+    "$description": "Foreground role for warning text and icons."
+  },
+  "color.on-feedback.warning.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 1 0 h)"
+  },
+  "color.on-feedback.warning.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.18 0.0067 h)"
+  },
+  "color.feedback.success.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.47 0.0067 h)",
+    "$description": "Alias of feedback.warning (shared tinted-neutral family)."
+  },
+  "color.feedback.success.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.835 0.0067 h)",
+    "$description": "Alias of feedback.warning (shared tinted-neutral family)."
+  },
+  "color.feedback.success.foreground.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.47 0.0067 h)"
+  },
+  "color.feedback.success.foreground.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.835 0.0067 h)"
+  },
+  "color.on-feedback.success.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 1 0 h)"
+  },
+  "color.on-feedback.success.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.18 0.0067 h)"
+  },
+  "color.feedback.info.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.47 0.0067 h)",
+    "$description": "Alias of feedback.warning (shared tinted-neutral family)."
+  },
+  "color.feedback.info.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.835 0.0067 h)",
+    "$description": "Alias of feedback.warning (shared tinted-neutral family)."
+  },
+  "color.feedback.info.foreground.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.47 0.0067 h)"
+  },
+  "color.feedback.info.foreground.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.835 0.0067 h)"
+  },
+  "color.on-feedback.info.light": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 1 0 h)"
+  },
+  "color.on-feedback.info.dark": {
+    "$type": "color",
+    "$value": "oklch(from var(--nave-color-tint) 0.18 0.0067 h)"
+  }
+}