@stridge/noctis-design-tokens 1.0.0-beta.0

package/dist/graph/serialize.d.ts

@@ -0,0 +1,16 @@
+import { TokenName } from "./model.js";
+
+//#region src/graph/serialize.d.ts
+/**
+ * The dashed body of a token name (namespace prefix excluded): a flat name's id verbatim, or a
+ * component name's `component[-anatomy]-property[-state]`. Object field order is irrelevant —
+ * the serialization order is fixed (component → anatomy → property → state).
+ */
+declare function serializeTokenName(name: TokenName): string;
+/**
+ * The slot-internal custom property a component declares on its slot to carry the resolution
+ * chain. Defined only for component names — flat names have no internal twin.
+ */
+declare function internalVar(name: TokenName): `--_${string}`;
+//#endregion
+export { internalVar, serializeTokenName };

package/dist/graph/serialize.js

@@ -0,0 +1,25 @@
+//#region src/graph/serialize.ts
+/**
+* The dashed body of a token name (namespace prefix excluded): a flat name's id verbatim, or a
+* component name's `component[-anatomy]-property[-state]`. Object field order is irrelevant —
+* the serialization order is fixed (component → anatomy → property → state).
+*/
+function serializeTokenName(name) {
+	if (name.kind === "flat") return name.id;
+	return [
+		name.component,
+		name.anatomy,
+		name.property,
+		name.state
+	].filter(Boolean).join("-");
+}
+/**
+* The slot-internal custom property a component declares on its slot to carry the resolution
+* chain. Defined only for component names — flat names have no internal twin.
+*/
+function internalVar(name) {
+	if (name.kind !== "component") throw new Error(`internalVar is component-only; received a flat name "${serializeTokenName(name)}"`);
+	return `--_${serializeTokenName(name)}`;
+}
+//#endregion
+export { internalVar, serializeTokenName };

package/dist/graph/statics.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/graph/statics.js

@@ -0,0 +1,419 @@
+/** Authored static T1 semantic tokens, in reference display order. */
+const STATIC_SEMANTIC_TOKENS = [
+	{
+		uuid: "fc02f2e2-77c0-4e43-8f14-5f26d16f36f1",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "text-disabled"
+		},
+		value: { raw: "color-mix(in oklch, var(--noctis-engine-fg-4) 55%, transparent)" },
+		description: "Disabled text where reduced opacity is inappropriate.",
+		usage: "Disabled text over busy rows where dimming the whole element is wrong.",
+		introduced: "0.0.0",
+		label: "Disabled text",
+		category: "color",
+		group: "text",
+		utility: "text-disabled",
+		bridge: {
+			kind: "theme-inline",
+			name: "--color-disabled"
+		}
+	},
+	{
+		uuid: "4e1b2bce-53d9-47fe-be88-583041a0bc01",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "well"
+		},
+		value: { raw: `color-mix(in oklch, var(--noctis-engine-fg-1) 20%, transparent)` },
+		description: "Recessed-well / track fill that stays visible on any surface.",
+		usage: "The unfilled bed of a track, gutter, or recessed region — a translucent foreground overlay so it self-adapts to whatever surface sits behind it.",
+		introduced: "0.1.0-alpha.2",
+		label: "Well",
+		category: "color",
+		group: "surface",
+		utility: "bg-well",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "45be4a2b-5971-4a3c-9c6e-289ba72c3e63",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "chart-1"
+		},
+		value: {
+			raw: "oklch(0.7 0.15 264)",
+			rawLight: "oklch(0.55 0.17 264)"
+		},
+		description: "Categorical chart series 1.",
+		usage: "Categorical chart series — a stable, accent-independent palette.",
+		introduced: "0.0.0",
+		label: "Chart 1",
+		category: "color",
+		group: "chart",
+		utility: "bg-chart-1",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "d2d0d9bd-d1d5-4447-a08b-c544dcc51922",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "chart-2"
+		},
+		value: {
+			raw: "oklch(0.78 0.13 195)",
+			rawLight: "oklch(0.6 0.13 195)"
+		},
+		description: "Categorical chart series 2.",
+		usage: "Categorical chart series — a stable, accent-independent palette.",
+		introduced: "0.0.0",
+		label: "Chart 2",
+		category: "color",
+		group: "chart",
+		utility: "bg-chart-2",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "ea930647-ecef-4ae2-bb81-2d601f3eac43",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "chart-3"
+		},
+		value: {
+			raw: "oklch(0.74 0.16 150)",
+			rawLight: "oklch(0.58 0.16 150)"
+		},
+		description: "Categorical chart series 3.",
+		usage: "Categorical chart series — a stable, accent-independent palette.",
+		introduced: "0.0.0",
+		label: "Chart 3",
+		category: "color",
+		group: "chart",
+		utility: "bg-chart-3",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "a2ef87da-e31c-47cf-b5cf-39afed4fb2ad",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "chart-4"
+		},
+		value: {
+			raw: "oklch(0.83 0.15 95)",
+			rawLight: "oklch(0.68 0.15 95)"
+		},
+		description: "Categorical chart series 4.",
+		usage: "Categorical chart series — a stable, accent-independent palette.",
+		introduced: "0.0.0",
+		label: "Chart 4",
+		category: "color",
+		group: "chart",
+		utility: "bg-chart-4",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "c9de26e2-f367-4316-bf36-62db564182d9",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "chart-5"
+		},
+		value: {
+			raw: "oklch(0.72 0.16 55)",
+			rawLight: "oklch(0.6 0.17 55)"
+		},
+		description: "Categorical chart series 5.",
+		usage: "Categorical chart series — a stable, accent-independent palette.",
+		introduced: "0.0.0",
+		label: "Chart 5",
+		category: "color",
+		group: "chart",
+		utility: "bg-chart-5",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "ad319f18-7ae2-453a-a01f-c0244df13e0d",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "chart-6"
+		},
+		value: {
+			raw: "oklch(0.68 0.18 25)",
+			rawLight: "oklch(0.55 0.2 25)"
+		},
+		description: "Categorical chart series 6.",
+		usage: "Categorical chart series — a stable, accent-independent palette.",
+		introduced: "0.0.0",
+		label: "Chart 6",
+		category: "color",
+		group: "chart",
+		utility: "bg-chart-6",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "9d894fe9-1815-46ae-bbd0-d4e1e1ebf3f7",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "chart-7"
+		},
+		value: {
+			raw: "oklch(0.7 0.17 310)",
+			rawLight: "oklch(0.55 0.19 310)"
+		},
+		description: "Categorical chart series 7.",
+		usage: "Categorical chart series — a stable, accent-independent palette.",
+		introduced: "0.0.0",
+		label: "Chart 7",
+		category: "color",
+		group: "chart",
+		utility: "bg-chart-7",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "f6235811-1942-406d-8e9c-30578c2b6ab3",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "chart-8"
+		},
+		value: {
+			raw: "oklch(0.76 0.14 350)",
+			rawLight: "oklch(0.6 0.16 350)"
+		},
+		description: "Categorical chart series 8.",
+		usage: "Categorical chart series — a stable, accent-independent palette.",
+		introduced: "0.0.0",
+		label: "Chart 8",
+		category: "color",
+		group: "chart",
+		utility: "bg-chart-8",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "e3a3fffd-08c6-4428-b1c4-2ef6871cd105",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "avatar-1"
+		},
+		value: {
+			raw: "oklch(0.62 0.17 264)",
+			rawLight: "oklch(0.58 0.18 264)"
+		},
+		description: "Generative avatar swatch 1.",
+		usage: "Avatar / initials background, indexed by a stable id hash.",
+		introduced: "0.0.0",
+		label: "Avatar 1",
+		category: "color",
+		group: "avatar",
+		utility: "bg-avatar-1",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "c94440a3-9695-4a60-a30f-d4208264fb9c",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "avatar-2"
+		},
+		value: {
+			raw: "oklch(0.62 0.15 196)",
+			rawLight: "oklch(0.56 0.15 196)"
+		},
+		description: "Generative avatar swatch 2.",
+		usage: "Avatar / initials background, indexed by a stable id hash.",
+		introduced: "0.0.0",
+		label: "Avatar 2",
+		category: "color",
+		group: "avatar",
+		utility: "bg-avatar-2",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "9a123d6a-99a1-47d6-894e-f8d4955443e9",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "avatar-3"
+		},
+		value: {
+			raw: "oklch(0.62 0.16 152)",
+			rawLight: "oklch(0.56 0.16 152)"
+		},
+		description: "Generative avatar swatch 3.",
+		usage: "Avatar / initials background, indexed by a stable id hash.",
+		introduced: "0.0.0",
+		label: "Avatar 3",
+		category: "color",
+		group: "avatar",
+		utility: "bg-avatar-3",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "17763bc9-6671-4f36-858d-d8a598a00987",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "avatar-4"
+		},
+		value: {
+			raw: "oklch(0.64 0.15 130)",
+			rawLight: "oklch(0.58 0.15 130)"
+		},
+		description: "Generative avatar swatch 4.",
+		usage: "Avatar / initials background, indexed by a stable id hash.",
+		introduced: "0.0.0",
+		label: "Avatar 4",
+		category: "color",
+		group: "avatar",
+		utility: "bg-avatar-4",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "7728d6d9-a196-4d33-8113-2fae86a08a2b",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "avatar-5"
+		},
+		value: {
+			raw: "oklch(0.66 0.16 70)",
+			rawLight: "oklch(0.62 0.16 70)"
+		},
+		description: "Generative avatar swatch 5.",
+		usage: "Avatar / initials background, indexed by a stable id hash.",
+		introduced: "0.0.0",
+		label: "Avatar 5",
+		category: "color",
+		group: "avatar",
+		utility: "bg-avatar-5",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "d5536df4-39ab-4dd2-a3a2-e9acbcf0ec77",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "avatar-6"
+		},
+		value: {
+			raw: "oklch(0.62 0.18 40)",
+			rawLight: "oklch(0.58 0.19 40)"
+		},
+		description: "Generative avatar swatch 6.",
+		usage: "Avatar / initials background, indexed by a stable id hash.",
+		introduced: "0.0.0",
+		label: "Avatar 6",
+		category: "color",
+		group: "avatar",
+		utility: "bg-avatar-6",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "c27d7067-d36c-486d-87bd-8c9d6ec2c5a9",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "avatar-7"
+		},
+		value: {
+			raw: "oklch(0.6 0.2 18)",
+			rawLight: "oklch(0.56 0.21 18)"
+		},
+		description: "Generative avatar swatch 7.",
+		usage: "Avatar / initials background, indexed by a stable id hash.",
+		introduced: "0.0.0",
+		label: "Avatar 7",
+		category: "color",
+		group: "avatar",
+		utility: "bg-avatar-7",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "14d955f4-5a36-43b1-91c3-8aa452ea097d",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "avatar-8"
+		},
+		value: {
+			raw: "oklch(0.6 0.18 330)",
+			rawLight: "oklch(0.56 0.19 330)"
+		},
+		description: "Generative avatar swatch 8.",
+		usage: "Avatar / initials background, indexed by a stable id hash.",
+		introduced: "0.0.0",
+		label: "Avatar 8",
+		category: "color",
+		group: "avatar",
+		utility: "bg-avatar-8",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "9ce232b0-56f8-4098-983a-a3af52fb0ffb",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "avatar-9"
+		},
+		value: {
+			raw: "oklch(0.6 0.18 300)",
+			rawLight: "oklch(0.56 0.19 300)"
+		},
+		description: "Generative avatar swatch 9.",
+		usage: "Avatar / initials background, indexed by a stable id hash.",
+		introduced: "0.0.0",
+		label: "Avatar 9",
+		category: "color",
+		group: "avatar",
+		utility: "bg-avatar-9",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "a78cb6f4-a317-455a-930d-96687f38d69f",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "avatar-10"
+		},
+		value: {
+			raw: "oklch(0.6 0.15 285)",
+			rawLight: "oklch(0.56 0.16 285)"
+		},
+		description: "Generative avatar swatch 10.",
+		usage: "Avatar / initials background, indexed by a stable id hash.",
+		introduced: "0.0.0",
+		label: "Avatar 10",
+		category: "color",
+		group: "avatar",
+		utility: "bg-avatar-10",
+		bridge: { kind: "color" }
+	},
+	{
+		uuid: "8ac67b72-d712-4c92-af5f-c0caae413e20",
+		tier: "semantic",
+		name: {
+			kind: "flat",
+			id: "avatar-foreground"
+		},
+		value: { raw: "oklch(0.99 0 0)" },
+		description: "Initials text on an avatar background.",
+		usage: "Initials text on an avatar — the page background as a knockout.",
+		introduced: "0.0.0",
+		label: "Avatar foreground",
+		category: "color",
+		group: "avatar",
+		utility: "text-avatar-foreground",
+		bridge: { kind: "color" }
+	}
+];
+//#endregion
+export { STATIC_SEMANTIC_TOKENS };

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import { applyThemeWithScopes } from "./apply-scopes.js";
+import { defaultThemeCss } from "./css.js";
+import { CATEGORY_REGISTRY, COMPOSITE_PROPERTIES, ComponentCategory, CompositeProperty, ROLE_VAR_PREFIX, STATE_REGISTRY, TOKEN_CATEGORIES, TOKEN_TIERS, TokenCategory, TokenState, TokenTier } from "./graph/registry.js";
+import { ComponentDeclaration, DesignToken, GraphValidationError, TokenBridge, TokenDeprecation, TokenGroup, TokenName, TokenValue, bridgeVarName, componentDeclarationSchema, cssVarName, designTokenSchema, validateGraph } from "./graph/model.js";
+import { COMPONENT_DECLARATIONS } from "./graph/components.js";
+import { DESIGN_TOKENS, SemanticRoleId } from "./graph/index.js";
+import { internalVar, serializeTokenName } from "./graph/serialize.js";
+import { AVATAR_FOREGROUND, AVATAR_PALETTE, AVATAR_SWATCH_COUNT, CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, ModePalette, avatarIndex } from "./palettes.js";
+import { BREAKPOINTS, DENSITY_VAR, EASINGS, FONT_SCALE_VAR, FONT_SIZES, FONT_WEIGHTS, RADII, RADIUS_VAR, SPEEDS, Z_INDEX } from "./scales.js";
+import { ACCENT_SWATCHES, BACKGROUND_SWATCHES, ThemeSwatch } from "./swatches.js";
+import { ELEVATION_SCOPES, ElevationScope, SEMANTIC_ROLES, STATIC_TOKENS, SemanticRole, StaticToken } from "./semantic.js";
+import { ThemeOverrides, ThemePreset, defaultPreset, presets } from "@stridge/noctis-theme-engine";
+
+//#region src/index.d.ts
+/**
+ * `@stridge/noctis-design-tokens` — the semantic token layer on top of `@stridge/noctis-theme-engine`.
+ *
+ * Defines the intent-named L2 roles components consume, the static L0 scales the engine
+ * does not own, the brand presets, and the build-time default CSS. The Tailwind bridge that
+ * turns the roles into utilities lives in `./tokens.css`; the "semantic tokens only" lint is
+ * the `stridge/semantic-tokens` oxlint rule in `toolings/noctis-lint`.
+ */
+/** Package identifier — the workspace-resolution marker consumed by the app scaffold. */
+declare const DESIGN_TOKENS_PACKAGE: "@stridge/noctis-design-tokens";
+//#endregion
+export { ACCENT_SWATCHES, AVATAR_FOREGROUND, AVATAR_PALETTE, AVATAR_SWATCH_COUNT, BACKGROUND_SWATCHES, BREAKPOINTS, CATEGORY_REGISTRY, CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, COMPONENT_DECLARATIONS, COMPOSITE_PROPERTIES, type ComponentCategory, type ComponentDeclaration, type CompositeProperty, DENSITY_VAR, DESIGN_TOKENS, DESIGN_TOKENS_PACKAGE, type DesignToken, EASINGS, ELEVATION_SCOPES, type ElevationScope, FONT_SCALE_VAR, FONT_SIZES, FONT_WEIGHTS, GraphValidationError, type ModePalette, RADII, RADIUS_VAR, ROLE_VAR_PREFIX, SEMANTIC_ROLES, SPEEDS, STATE_REGISTRY, STATIC_TOKENS, type SemanticRole, type SemanticRoleId, type StaticToken, TOKEN_CATEGORIES, TOKEN_TIERS, type ThemeOverrides, type ThemePreset, type ThemeSwatch, type TokenBridge, type TokenCategory, type TokenDeprecation, type TokenGroup, type TokenName, type TokenState, type TokenTier, type TokenValue, Z_INDEX, applyThemeWithScopes, avatarIndex, bridgeVarName, componentDeclarationSchema, cssVarName, defaultPreset, defaultThemeCss, designTokenSchema, internalVar, presets, serializeTokenName, validateGraph };

package/dist/index.js

@@ -0,0 +1,25 @@
+import { applyThemeWithScopes } from "./apply-scopes.js";
+import { defaultThemeCss } from "./css.js";
+import { COMPONENT_DECLARATIONS } from "./graph/components.js";
+import { CATEGORY_REGISTRY, COMPOSITE_PROPERTIES, ROLE_VAR_PREFIX, STATE_REGISTRY, TOKEN_CATEGORIES, TOKEN_TIERS } from "./graph/registry.js";
+import { internalVar, serializeTokenName } from "./graph/serialize.js";
+import { GraphValidationError, bridgeVarName, componentDeclarationSchema, cssVarName, designTokenSchema, validateGraph } from "./graph/model.js";
+import { DESIGN_TOKENS } from "./graph/index.js";
+import { AVATAR_FOREGROUND, AVATAR_PALETTE, AVATAR_SWATCH_COUNT, CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, avatarIndex } from "./palettes.js";
+import { BREAKPOINTS, DENSITY_VAR, EASINGS, FONT_SCALE_VAR, FONT_SIZES, FONT_WEIGHTS, RADII, RADIUS_VAR, SPEEDS, Z_INDEX } from "./scales.js";
+import { ACCENT_SWATCHES, BACKGROUND_SWATCHES } from "./swatches.js";
+import { ELEVATION_SCOPES, SEMANTIC_ROLES, STATIC_TOKENS } from "./semantic.js";
+import { defaultPreset, presets } from "@stridge/noctis-theme-engine";
+//#region src/index.ts
+/**
+* `@stridge/noctis-design-tokens` — the semantic token layer on top of `@stridge/noctis-theme-engine`.
+*
+* Defines the intent-named L2 roles components consume, the static L0 scales the engine
+* does not own, the brand presets, and the build-time default CSS. The Tailwind bridge that
+* turns the roles into utilities lives in `./tokens.css`; the "semantic tokens only" lint is
+* the `stridge/semantic-tokens` oxlint rule in `toolings/noctis-lint`.
+*/
+/** Package identifier — the workspace-resolution marker consumed by the app scaffold. */
+const DESIGN_TOKENS_PACKAGE = "@stridge/noctis-design-tokens";
+//#endregion
+export { ACCENT_SWATCHES, AVATAR_FOREGROUND, AVATAR_PALETTE, AVATAR_SWATCH_COUNT, BACKGROUND_SWATCHES, BREAKPOINTS, CATEGORY_REGISTRY, CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, COMPONENT_DECLARATIONS, COMPOSITE_PROPERTIES, DENSITY_VAR, DESIGN_TOKENS, DESIGN_TOKENS_PACKAGE, EASINGS, ELEVATION_SCOPES, FONT_SCALE_VAR, FONT_SIZES, FONT_WEIGHTS, GraphValidationError, RADII, RADIUS_VAR, ROLE_VAR_PREFIX, SEMANTIC_ROLES, SPEEDS, STATE_REGISTRY, STATIC_TOKENS, TOKEN_CATEGORIES, TOKEN_TIERS, Z_INDEX, applyThemeWithScopes, avatarIndex, bridgeVarName, componentDeclarationSchema, cssVarName, defaultPreset, defaultThemeCss, designTokenSchema, internalVar, presets, serializeTokenName, validateGraph };

package/dist/palettes.d.ts

@@ -0,0 +1,70 @@
+//#region src/palettes.d.ts
+/**
+ * Static, accent-independent palettes the engine does not generate.
+ *
+ * Charts and avatars need **categorical distinctness that stays stable** regardless of the
+ * active theme accent, so these are authored in OKLCH (not derived from the seed) with
+ * explicit light and dark values. They are emitted as Tailwind colors (`bg-chart-1`,
+ * `bg-avatar-3`, `text-chart-positive`) and switch on the resolved mode via `data-theme`.
+ *
+ * Hue choices are spread across the wheel and separated in lightness as well as hue, so the
+ * series remain distinguishable under the common forms of color-vision deficiency (the worst
+ * case — deutan/protan red↔green — is disambiguated by the lightness and the blue/amber axis).
+ */
+/** A palette with a value per supported mode. */
+interface ModePalette {
+  readonly light: readonly string[];
+  readonly dark: readonly string[];
+}
+/**
+ * Categorical chart series (8). Spread across the hue wheel with alternating lightness;
+ * dark-mode values sit lighter (read on dark surfaces), light-mode values sit darker.
+ */
+declare const CHART_PALETTE: ModePalette;
+/**
+ * Avatar / identity backgrounds (10). Saturated mid-lightness colors chosen so white initials
+ * read clearly on every swatch; picked deterministically by hashing a stable id.
+ */
+declare const AVATAR_PALETTE: ModePalette;
+/** Number of distinct chart series and avatar swatches. */
+declare const CHART_SERIES_COUNT: number;
+declare const AVATAR_SWATCH_COUNT: number;
+/** On-avatar text — a fixed knockout that reads on every (saturated) avatar swatch. */
+declare const AVATAR_FOREGROUND: "oklch(0.99 0 0)";
+/**
+ * Pick a stable avatar swatch index (1-based, matching `bg-avatar-N`) for an id. A small FNV-1a
+ * hash keeps the mapping deterministic across renders and sessions.
+ */
+declare function avatarIndex(id: string): number;
+/** Chart roles that alias engine semantics (kept here so the swatch/reference lists them together). */
+declare const CHART_SEMANTIC_ROLES: readonly [{
+  readonly role: "chart-positive";
+  readonly utility: "text-chart-positive";
+  readonly description: "Up / gain trend (= success).";
+}, {
+  readonly role: "chart-negative";
+  readonly utility: "text-chart-negative";
+  readonly description: "Down / loss trend (= danger).";
+}, {
+  readonly role: "chart-neutral";
+  readonly utility: "text-chart-neutral";
+  readonly description: "Flat / baseline series.";
+}, {
+  readonly role: "chart-grid";
+  readonly utility: "border-chart-grid";
+  readonly description: "Gridlines and axis ticks.";
+}, {
+  readonly role: "chart-axis";
+  readonly utility: "text-chart-axis";
+  readonly description: "Axis labels and tick text.";
+}, {
+  readonly role: "chart-track";
+  readonly utility: "bg-chart-track";
+  readonly description: "Empty bar / gauge remainder.";
+}, {
+  readonly role: "chart-tooltip";
+  readonly utility: "bg-chart-tooltip";
+  readonly description: "Chart tooltip surface.";
+}];
+//#endregion
+export { AVATAR_FOREGROUND, AVATAR_PALETTE, AVATAR_SWATCH_COUNT, CHART_PALETTE, CHART_SEMANTIC_ROLES, CHART_SERIES_COUNT, ModePalette, avatarIndex };