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

package/dist/graph/scales.js

@@ -0,0 +1,1296 @@
+//#region src/graph/scales.ts
+/**
+* A foundation token: tier `"foundation"`, a flat id, a structural `category`, an alias-graph
+* `value`, and an optional `bridge` (omitted ⇒ canonical-only). `utility` is display metadata for
+* the docs/reference surfaces and never controls emission.
+*/
+function foundation(args) {
+	const { uuid, id, category, value, description, usage, bridge, utility } = args;
+	return {
+		uuid,
+		tier: "foundation",
+		name: {
+			kind: "flat",
+			id
+		},
+		value,
+		description,
+		usage,
+		introduced: "0.0.0",
+		category,
+		...utility ? { utility } : {},
+		...bridge ? { bridge } : {}
+	};
+}
+/** A `theme-inline` bridge — a bare Tailwind name re-pointed at the canonical via `@theme inline`. */
+const themeInline = (name) => ({
+	kind: "theme-inline",
+	name
+});
+/** A raw-literal value. */
+const raw = (value) => ({ raw: value });
+/**
+* The sanctioned spacing ramp — every step a spacing-driven Tailwind
+* utility (`p-*`, `m-*`, `gap-*`, `size-*`, `w-*`, `inset-*`, …) may use. With `--spacing: initial`
+* killing Tailwind's bare multiplier, these minted `--spacing-<step>` keys are the only spacing
+* source: an unsanctioned step (`p-17`, `w-88`) simply stops emitting, and the build is the
+* detection mechanism. Fractional ids carry a bare `.` (escaped to `\.` at CSS emission).
+*/
+const SPACING_STEPS = [
+	{
+		step: "0",
+		uuid: "9e61823d-4341-4cf7-b940-e6dcb8b7893a"
+	},
+	{
+		step: "0.5",
+		uuid: "c531515a-a229-457f-a13f-8f890145eb7e"
+	},
+	{
+		step: "1",
+		uuid: "e5d40857-accc-4687-b573-39c3946aa238"
+	},
+	{
+		step: "1.5",
+		uuid: "df0aec81-5b0d-4d3b-ad90-9cdd6302a58e"
+	},
+	{
+		step: "2",
+		uuid: "fbbf41a3-0ea9-434a-b1d0-8244cf25452a"
+	},
+	{
+		step: "2.5",
+		uuid: "b2f1420a-b918-4a5e-8405-c3ca52576aee"
+	},
+	{
+		step: "3",
+		uuid: "ebcd637f-d5a1-46b9-b03d-a9eb37936b48"
+	},
+	{
+		step: "3.5",
+		uuid: "85d34ab1-f29c-4068-94ab-8aa5db32a6c1"
+	},
+	{
+		step: "4",
+		uuid: "cd4d529f-aa55-4560-a105-540c9183ed12"
+	},
+	{
+		step: "5",
+		uuid: "0ea68ba3-d1b6-452c-9c5f-c6669bfacdda"
+	},
+	{
+		step: "6",
+		uuid: "5f98b439-8ff7-493f-addc-63b2b1eee429"
+	},
+	{
+		step: "7",
+		uuid: "83b33c44-e524-4f5f-a353-1735089b1895"
+	},
+	{
+		step: "8",
+		uuid: "c92ebd8b-b1a7-4aa9-8ae8-2909007c7a69"
+	},
+	{
+		step: "9",
+		uuid: "c6ebed23-f8d8-49a0-aa4b-6b45b718e455"
+	},
+	{
+		step: "10",
+		uuid: "f100131a-1e18-45dd-b25a-cf31bdde713e"
+	},
+	{
+		step: "11",
+		uuid: "c5174e39-2132-46fa-982e-8463fd03146c"
+	},
+	{
+		step: "12",
+		uuid: "14768430-84ce-4598-a082-5badbce1f24a"
+	},
+	{
+		step: "14",
+		uuid: "4fdb1b7e-5efe-47d1-a2d1-8add00677795"
+	},
+	{
+		step: "16",
+		uuid: "ccffde22-1dd1-4951-94cb-a2122a7b60e6"
+	},
+	{
+		step: "20",
+		uuid: "587d8ddf-aa84-4c29-bc1c-ef89aa51b4a9"
+	},
+	{
+		step: "24",
+		uuid: "a34dfaa1-d238-427d-b6f2-d5014c8c5f58"
+	},
+	{
+		step: "28",
+		uuid: "9db3bbde-83a5-40d0-acce-4431373b69d1"
+	},
+	{
+		step: "32",
+		uuid: "160eaeef-a44d-4ce9-ac4b-2ba876069b3f"
+	},
+	{
+		step: "36",
+		uuid: "74e3c1cb-447c-4ae0-991a-3707af9e0cb3"
+	},
+	{
+		step: "40",
+		uuid: "b6cfa978-9c02-4ad4-a875-e64e4bfab97e"
+	},
+	{
+		step: "44",
+		uuid: "66053c8f-a319-49e2-99f1-03de4ec9bd25"
+	},
+	{
+		step: "48",
+		uuid: "26719184-bd81-4751-a038-9fe2ad756625"
+	},
+	{
+		step: "52",
+		uuid: "010cd46f-dc4d-4da1-90ac-96d5e9f20e00"
+	},
+	{
+		step: "56",
+		uuid: "72d6da37-a17f-46c7-828c-2f5cc4df2cbc"
+	},
+	{
+		step: "60",
+		uuid: "f060115d-28cc-4d25-a196-dad7f936388d"
+	},
+	{
+		step: "64",
+		uuid: "e2164d78-9b4e-434a-b21e-13e51925df97"
+	},
+	{
+		step: "72",
+		uuid: "6cead136-810f-4b29-b299-6df42fcd2dac"
+	},
+	{
+		step: "80",
+		uuid: "bf5a0a0f-3781-4e76-8fd5-4a1878faf97e"
+	},
+	{
+		step: "96",
+		uuid: "a680b08f-cfd9-4444-8558-c74e68149b2b"
+	},
+	{
+		step: "px",
+		uuid: "141b642e-522c-4ee9-a3cb-66d83e1f6e3e"
+	}
+];
+/**
+* The value of a spacing step: `0.25rem × step × density` so the whole ramp re-spaces live with
+* the `--noctis-seed-density` knob (1 = today's values). `0` stays a static `0px` and `px` a
+* static `1px` — hairlines and zero never scale. The `0.25rem`-first operand order mirrors the
+* type-scale calcs (and the Tailwind multiplier form).
+*/
+function spacingValue(step) {
+	if (step === "px") return raw("1px");
+	if (step === "0") return raw("0px");
+	return raw(`calc(0.25rem * ${step} * var(--noctis-seed-density))`);
+}
+function spacingToken({ step, uuid }) {
+	const label = step === "px" ? "Hairline spacing — a static 1px, never density-scaled." : `Spacing step ${step} (${step} × 0.25rem).`;
+	return foundation({
+		uuid,
+		id: step,
+		category: "space",
+		value: spacingValue(step),
+		description: label,
+		usage: `The ${step} step of the spacing-driven utilities (p-${step}, m-${step}, gap-${step}, size-${step}, …).`,
+		bridge: themeInline(`--spacing-${step}`)
+	});
+}
+/** The canonical part variable of a shadow layer — `--noctis-shadow-{family}-{layer}-{part}`. */
+const shadowPartVar = (family, layer, part) => `--noctis-shadow-${family}-${layer}-${part}`;
+/**
+* One composed drop-shadow layer: the geometry quad read from the part tokens, colored by the
+* engine's shadow base at the layer's own alpha part. The colour reads `--noctis-engine-shadow-color`
+* through a relative-colour `oklch(from … l c h / <alpha>)`, so the shadow tone follows the engine
+* (re-deriving under each elevation scope) while every layer keeps its own alpha part. Each part is a
+* real cascade seam: override `--noctis-shadow-low-1-blur` (or its alpha) on any scope and the composed
+* shadow re-resolves.
+*/
+function shadowLayer(family, layer) {
+	const part = (p) => `var(${shadowPartVar(family, layer, p)})`;
+	return `${part("x")} ${part("y")} ${part("blur")} ${part("spread")} oklch(from var(--noctis-engine-shadow-color) l c h / ${part("alpha")})`;
+}
+/** The focus layer: the geometry quad colored by the engine's focus ring (scope-variant). */
+function focusShadowLayer() {
+	const part = (p) => `var(${shadowPartVar("focus", 1, p)})`;
+	return `${part("x")} ${part("y")} ${part("blur")} ${part("spread")} var(--noctis-engine-focus-ring)`;
+}
+/**
+* The per-layer shadow geometry + alpha parts. Drop families carry an `alpha` part consumed by the
+* layer's `oklch(from --noctis-engine-shadow-color … / <alpha>)` colour; the focus family is
+* geometry-only (its colour is the engine focus ring). Alphas are authored in trailing-zero-trimmed
+* form (`0.1`, not `0.10`).
+*/
+const SHADOW_PARTS = [
+	{
+		id: "low-1-x",
+		value: "0",
+		uuid: "612ae869-6914-44e9-bf75-62432cc405af"
+	},
+	{
+		id: "low-1-y",
+		value: "1px",
+		uuid: "59f87c01-71e6-4b8d-a0b8-259a52355c31"
+	},
+	{
+		id: "low-1-blur",
+		value: "2px",
+		light: "3px",
+		uuid: "f165481c-4c5e-429f-a618-9aa2b88bfd0a"
+	},
+	{
+		id: "low-1-spread",
+		value: "0",
+		uuid: "c5365d3d-6b07-4541-b32c-0a8de2cd1434"
+	},
+	{
+		id: "low-1-alpha",
+		value: "0.08",
+		light: "0.05",
+		uuid: "d770f365-e21d-4c73-910e-a71488492f5b"
+	},
+	{
+		id: "low-2-x",
+		value: "0",
+		uuid: "e308e64f-0999-4cbf-9a6e-43fce59e80a2"
+	},
+	{
+		id: "low-2-y",
+		value: "1px",
+		uuid: "6556784a-ab18-42f0-8333-7a7fa0123e30"
+	},
+	{
+		id: "low-2-blur",
+		value: "1px",
+		light: "2px",
+		uuid: "b6bb5753-cf70-4fb1-ac35-fe832e80af60"
+	},
+	{
+		id: "low-2-spread",
+		value: "0",
+		uuid: "fecae0df-c10c-44ef-844b-df664aeeeda9"
+	},
+	{
+		id: "low-2-alpha",
+		value: "0.06",
+		light: "0.04",
+		uuid: "ce033955-c160-4107-9e88-dde93ac5f242"
+	},
+	{
+		id: "medium-1-x",
+		value: "0",
+		uuid: "2686aed8-43e1-4583-baff-72fb87ace4d8"
+	},
+	{
+		id: "medium-1-y",
+		value: "4px",
+		light: "5px",
+		uuid: "81a7a55e-ca77-4123-870e-f014e8f24b40"
+	},
+	{
+		id: "medium-1-blur",
+		value: "8px",
+		light: "18px",
+		uuid: "887f6e8b-678a-4676-8bdf-3cf051ab0750"
+	},
+	{
+		id: "medium-1-spread",
+		value: "-2px",
+		light: "-3px",
+		uuid: "edc0f99b-7483-4f0d-8aa4-2e3e7fa40e26"
+	},
+	{
+		id: "medium-1-alpha",
+		value: "0.12",
+		light: "0.1",
+		uuid: "1a1e8612-a544-42d9-b632-c1b7a7cd74c7"
+	},
+	{
+		id: "medium-2-x",
+		value: "0",
+		uuid: "b6536338-e86b-49e0-80aa-23391ab3ab6b"
+	},
+	{
+		id: "medium-2-y",
+		value: "2px",
+		uuid: "60373881-6e3e-4167-bab5-2163bf98cbb9"
+	},
+	{
+		id: "medium-2-blur",
+		value: "4px",
+		light: "6px",
+		uuid: "2e976f4f-d3a6-4ca1-8613-3a6c209b3541"
+	},
+	{
+		id: "medium-2-spread",
+		value: "-1px",
+		uuid: "4cb07b13-7685-4893-87e7-30d3a2996311"
+	},
+	{
+		id: "medium-2-alpha",
+		value: "0.1",
+		light: "0.06",
+		uuid: "23297190-6131-4750-b7e1-66ab04e8ed75"
+	},
+	{
+		id: "high-1-x",
+		value: "0",
+		uuid: "7efb0bac-dde1-4a39-884c-ec7affb5da04"
+	},
+	{
+		id: "high-1-y",
+		value: "12px",
+		light: "16px",
+		uuid: "9e54a53d-2ef8-4621-9e65-dd9a024bc4f9"
+	},
+	{
+		id: "high-1-blur",
+		value: "32px",
+		light: "44px",
+		uuid: "b8e53c3d-dc46-4190-8b5d-a7399036adea"
+	},
+	{
+		id: "high-1-spread",
+		value: "-4px",
+		light: "-6px",
+		uuid: "7ea620f1-02e9-4167-ba0d-65d9653eecae"
+	},
+	{
+		id: "high-1-alpha",
+		value: "0.18",
+		light: "0.14",
+		uuid: "873bd9ed-5804-464e-907c-d695252fcf6c"
+	},
+	{
+		id: "high-2-x",
+		value: "0",
+		uuid: "4b088e29-e96b-4a0b-bea9-5064fc7af943"
+	},
+	{
+		id: "high-2-y",
+		value: "6px",
+		uuid: "74ec8ba7-a9ed-42e7-933b-343c2590334e"
+	},
+	{
+		id: "high-2-blur",
+		value: "12px",
+		light: "16px",
+		uuid: "efe26ac5-f041-47ae-bf28-502ddd10ae16"
+	},
+	{
+		id: "high-2-spread",
+		value: "-2px",
+		uuid: "b39795f6-cf0e-4a5e-8c98-bb4b4aeeddc5"
+	},
+	{
+		id: "high-2-alpha",
+		value: "0.14",
+		light: "0.08",
+		uuid: "5360903d-8dfc-4709-a4e1-58e72e7c0294"
+	},
+	{
+		id: "inset-1-x",
+		value: "0",
+		uuid: "7c09bd86-12e5-4855-b25e-9658fbef4547"
+	},
+	{
+		id: "inset-1-y",
+		value: "1px",
+		uuid: "6435624f-6e81-43b6-a87e-71f5708a3dac"
+	},
+	{
+		id: "inset-1-blur",
+		value: "2px",
+		uuid: "74f76c5a-4b12-400f-9c77-9da62ca10509"
+	},
+	{
+		id: "inset-1-spread",
+		value: "0",
+		uuid: "cc4e98cf-4591-42f6-967d-48442f39851c"
+	},
+	{
+		id: "inset-1-alpha",
+		value: "0.1",
+		uuid: "b0acb421-9aba-4ad5-96f1-e80c89084a76"
+	},
+	{
+		id: "focus-1-x",
+		value: "0",
+		uuid: "36cdee68-3f6b-4f24-bf1b-f92f9e731868"
+	},
+	{
+		id: "focus-1-y",
+		value: "0",
+		uuid: "743f6b24-963e-42dd-a144-4da741d0fda7"
+	},
+	{
+		id: "focus-1-blur",
+		value: "0",
+		uuid: "ead80153-00e5-4087-a064-569bf83b3393"
+	},
+	{
+		id: "focus-1-spread",
+		value: "1px",
+		uuid: "28ac7aa8-8b06-4b83-b745-b5347e47c9b0"
+	}
+];
+function shadowPartToken({ id, value, uuid, light }) {
+	const [family, layer, part] = id.split("-");
+	return foundation({
+		uuid,
+		id,
+		category: "shadow",
+		value: light === void 0 ? raw(value) : {
+			raw: value,
+			rawLight: light
+		},
+		description: `Shadow part — ${part} of the ${family} shadow's layer ${layer}.`,
+		usage: `Composed into --noctis-shadow-${family}; override it (cascade or scoped) to retune that one part.`
+	});
+}
+/** Static foundation scale tokens. */
+const FOUNDATION_TOKENS = [
+	foundation({
+		uuid: "2a366fb9-5ad3-4e12-a10e-08d7e6f71731",
+		id: "disabled",
+		category: "opacity",
+		value: raw("0.5"),
+		description: "Opacity applied to disabled controls.",
+		usage: "The opacity-disabled utility.",
+		utility: "opacity-disabled",
+		bridge: { kind: "utility" }
+	}),
+	foundation({
+		uuid: "f6a8b3d2-1c4e-4a7b-9f0d-2e5c8a1b3d6f",
+		id: "sans",
+		category: "font",
+		value: raw("\"Inter\", ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, sans-serif"),
+		description: "Sans-serif type family — the default UI font.",
+		usage: "The font-sans family utility.",
+		utility: "font-sans",
+		bridge: themeInline("--font-sans")
+	}),
+	foundation({
+		uuid: "b2e7c9a4-3d6f-4b8e-a1c5-7f0d2e4a6b8c",
+		id: "mono",
+		category: "font",
+		value: raw("\"Geist Mono\", ui-monospace, \"SF Mono\", \"JetBrains Mono\", Menlo, Consolas, monospace"),
+		description: "Monospace type family — code and tabular text.",
+		usage: "The font-mono family utility.",
+		utility: "font-mono",
+		bridge: themeInline("--font-mono")
+	}),
+	foundation({
+		uuid: "cbab8246-4ab7-4bfc-81ff-f37608b55c28",
+		id: "micro",
+		category: "text",
+		value: raw("calc(0.6875rem * var(--noctis-seed-font-scale))"),
+		description: "Font size — micro.",
+		usage: "The text-micro size utility.",
+		utility: "text-micro",
+		bridge: themeInline("--text-micro")
+	}),
+	foundation({
+		uuid: "b73bf112-960f-4eac-b5fc-f7eb350bf552",
+		id: "mini",
+		category: "text",
+		value: raw("calc(0.75rem * var(--noctis-seed-font-scale))"),
+		description: "Font size — mini.",
+		usage: "The text-mini size utility.",
+		utility: "text-mini",
+		bridge: themeInline("--text-mini")
+	}),
+	foundation({
+		uuid: "38378ea4-41f4-4ff6-85dd-0d46ba93a483",
+		id: "small",
+		category: "text",
+		value: raw("calc(0.8125rem * var(--noctis-seed-font-scale))"),
+		description: "Font size — small.",
+		usage: "The text-small size utility.",
+		utility: "text-small",
+		bridge: themeInline("--text-small")
+	}),
+	foundation({
+		uuid: "212d0b64-ae4f-43a2-bd07-a0d3a2ba6828",
+		id: "regular",
+		category: "text",
+		value: raw("calc(0.9375rem * var(--noctis-seed-font-scale))"),
+		description: "Font size — regular.",
+		usage: "The text-regular size utility.",
+		utility: "text-regular",
+		bridge: themeInline("--text-regular")
+	}),
+	foundation({
+		uuid: "9554f63f-3f5d-4b99-8473-0364b89d5c67",
+		id: "large",
+		category: "text",
+		value: raw("calc(1.125rem * var(--noctis-seed-font-scale))"),
+		description: "Font size — large.",
+		usage: "The text-large size utility.",
+		utility: "text-large",
+		bridge: themeInline("--text-large")
+	}),
+	foundation({
+		uuid: "1d800457-d21a-48cc-a559-5f09f2e7ee29",
+		id: "title-1",
+		category: "text",
+		value: raw("calc(2.25rem * var(--noctis-seed-font-scale))"),
+		description: "Font size — title-1.",
+		usage: "The text-title-1 size utility.",
+		utility: "text-title-1",
+		bridge: themeInline("--text-title-1")
+	}),
+	foundation({
+		uuid: "9db3ba5a-50f3-4acc-bdcc-0ce3896a4889",
+		id: "title-2",
+		category: "text",
+		value: raw("calc(1.5rem * var(--noctis-seed-font-scale))"),
+		description: "Font size — title-2.",
+		usage: "The text-title-2 size utility.",
+		utility: "text-title-2",
+		bridge: themeInline("--text-title-2")
+	}),
+	foundation({
+		uuid: "98edca8f-2949-49be-9155-30145ec369da",
+		id: "title-3",
+		category: "text",
+		value: raw("calc(1.25rem * var(--noctis-seed-font-scale))"),
+		description: "Font size — title-3.",
+		usage: "The text-title-3 size utility.",
+		utility: "text-title-3",
+		bridge: themeInline("--text-title-3")
+	}),
+	foundation({
+		uuid: "a7e015b2-453a-4cc6-996f-1a7bc744de47",
+		id: "micro",
+		category: "leading",
+		value: raw("calc(1rem * var(--noctis-seed-font-scale))"),
+		description: "Line height paired with text-micro.",
+		usage: "The line box for the text-micro size.",
+		bridge: themeInline("--text-micro--line-height")
+	}),
+	foundation({
+		uuid: "e77c0894-a1a4-4064-a9b7-45b44892f5ac",
+		id: "mini",
+		category: "leading",
+		value: raw("calc(1rem * var(--noctis-seed-font-scale))"),
+		description: "Line height paired with text-mini.",
+		usage: "The line box for the text-mini size.",
+		bridge: themeInline("--text-mini--line-height")
+	}),
+	foundation({
+		uuid: "fe830136-acf1-4d4d-9ef5-2650980a118f",
+		id: "small",
+		category: "leading",
+		value: raw("calc(1.25rem * var(--noctis-seed-font-scale))"),
+		description: "Line height paired with text-small.",
+		usage: "The line box for the text-small size.",
+		bridge: themeInline("--text-small--line-height")
+	}),
+	foundation({
+		uuid: "896d6fc0-508a-4b00-8202-0db16de2dda5",
+		id: "regular",
+		category: "leading",
+		value: raw("calc(1.5rem * var(--noctis-seed-font-scale))"),
+		description: "Line height paired with text-regular.",
+		usage: "The line box for the text-regular size.",
+		bridge: themeInline("--text-regular--line-height")
+	}),
+	foundation({
+		uuid: "fc2d55a5-8803-4189-904a-66d9d15cf3b1",
+		id: "large",
+		category: "leading",
+		value: raw("calc(1.75rem * var(--noctis-seed-font-scale))"),
+		description: "Line height paired with text-large.",
+		usage: "The line box for the text-large size.",
+		bridge: themeInline("--text-large--line-height")
+	}),
+	foundation({
+		uuid: "cd13efdc-485e-431f-81c3-1cc142094848",
+		id: "title-1",
+		category: "leading",
+		value: raw("calc(2.75rem * var(--noctis-seed-font-scale))"),
+		description: "Line height paired with text-title-1.",
+		usage: "The line box for the text-title-1 size.",
+		bridge: themeInline("--text-title-1--line-height")
+	}),
+	foundation({
+		uuid: "ecca6a90-c283-4dcd-9441-c06e32104fb8",
+		id: "title-2",
+		category: "leading",
+		value: raw("calc(2rem * var(--noctis-seed-font-scale))"),
+		description: "Line height paired with text-title-2.",
+		usage: "The line box for the text-title-2 size.",
+		bridge: themeInline("--text-title-2--line-height")
+	}),
+	foundation({
+		uuid: "1e58e2b8-2fd8-4cd8-9150-f2cf3aa97ec7",
+		id: "title-3",
+		category: "leading",
+		value: raw("calc(1.75rem * var(--noctis-seed-font-scale))"),
+		description: "Line height paired with text-title-3.",
+		usage: "The line box for the text-title-3 size.",
+		bridge: themeInline("--text-title-3--line-height")
+	}),
+	foundation({
+		uuid: "6d972fdc-b4c3-468d-b190-df4e8c43fa5f",
+		id: "snug",
+		category: "leading",
+		value: raw("1.375"),
+		description: "Standalone line height — snug (mirrors Tailwind's leading-snug).",
+		usage: "The leading-snug utility, for tightened multi-line text outside the paired type scale.",
+		utility: "leading-snug",
+		bridge: themeInline("--leading-snug")
+	}),
+	foundation({
+		uuid: "89bad250-d65e-48c0-8417-48af6b6a4b9b",
+		id: "relaxed",
+		category: "leading",
+		value: raw("1.625"),
+		description: "Standalone line height — relaxed (mirrors Tailwind's leading-relaxed).",
+		usage: "The leading-relaxed utility, for opened-up prose like the Lead block.",
+		utility: "leading-relaxed",
+		bridge: themeInline("--leading-relaxed")
+	}),
+	foundation({
+		uuid: "0c605276-ec6f-4c1f-a05e-f30ed09aba75",
+		id: "weight-light",
+		category: "font",
+		value: raw("300"),
+		description: "Font weight — light.",
+		usage: "The font-light weight utility.",
+		utility: "font-light",
+		bridge: themeInline("--font-weight-light")
+	}),
+	foundation({
+		uuid: "4acce504-1c35-4385-ab69-6143b768d03d",
+		id: "weight-normal",
+		category: "font",
+		value: raw("450"),
+		description: "Font weight — normal.",
+		usage: "The font-normal weight utility.",
+		utility: "font-normal",
+		bridge: themeInline("--font-weight-normal")
+	}),
+	foundation({
+		uuid: "f57be22a-0b37-4dd6-97a8-a1cb7c41ad81",
+		id: "weight-medium",
+		category: "font",
+		value: raw("500"),
+		description: "Font weight — medium.",
+		usage: "The font-medium weight utility.",
+		utility: "font-medium",
+		bridge: themeInline("--font-weight-medium")
+	}),
+	foundation({
+		uuid: "6139d888-2c91-4ef9-876f-ab60b0a811be",
+		id: "weight-semibold",
+		category: "font",
+		value: raw("600"),
+		description: "Font weight — semibold.",
+		usage: "The font-semibold weight utility.",
+		utility: "font-semibold",
+		bridge: themeInline("--font-weight-semibold")
+	}),
+	foundation({
+		uuid: "b10e620f-1cb0-4987-ad1f-cf10b2198628",
+		id: "weight-bold",
+		category: "font",
+		value: raw("700"),
+		description: "Font weight — bold.",
+		usage: "The font-bold weight utility.",
+		utility: "font-bold",
+		bridge: themeInline("--font-weight-bold")
+	}),
+	foundation({
+		uuid: "5cfe9226-e50f-4a69-ac80-20be45250f60",
+		id: "weight-extrabold",
+		category: "font",
+		value: raw("800"),
+		description: "Font weight — extrabold.",
+		usage: "The font-extrabold weight utility.",
+		utility: "font-extrabold",
+		bridge: themeInline("--font-weight-extrabold")
+	}),
+	foundation({
+		uuid: "66847f3c-4495-47a6-8f5f-9e10f0d8f676",
+		id: "weight-black",
+		category: "font",
+		value: raw("900"),
+		description: "Font weight — black.",
+		usage: "The font-black weight utility.",
+		utility: "font-black",
+		bridge: themeInline("--font-weight-black")
+	}),
+	foundation({
+		uuid: "b59110d5-d90b-4528-93d4-b9a4015ecc3a",
+		id: "tight",
+		category: "tracking",
+		value: raw("-0.01em"),
+		description: "Letter spacing — tight.",
+		usage: "The tracking-tight utility.",
+		utility: "tracking-tight",
+		bridge: themeInline("--tracking-tight")
+	}),
+	foundation({
+		uuid: "5bd45b75-1b54-40b3-a1f0-d58b06bee6a7",
+		id: "normal",
+		category: "tracking",
+		value: raw("0em"),
+		description: "Letter spacing — normal.",
+		usage: "The tracking-normal utility.",
+		utility: "tracking-normal",
+		bridge: themeInline("--tracking-normal")
+	}),
+	foundation({
+		uuid: "d49913b4-e90c-4792-b61b-8580d8500677",
+		id: "wide",
+		category: "tracking",
+		value: raw("0.02em"),
+		description: "Letter spacing — wide.",
+		usage: "The tracking-wide utility.",
+		utility: "tracking-wide",
+		bridge: themeInline("--tracking-wide")
+	}),
+	foundation({
+		uuid: "6f987bc6-405c-4867-b971-257586e795cf",
+		id: "xs",
+		category: "radius",
+		value: raw("min(calc(var(--noctis-seed-radius) * 0.5), 0.375rem)"),
+		description: "Corner radius — xs.",
+		usage: "The rounded-xs utility.",
+		utility: "rounded-xs",
+		bridge: themeInline("--radius-xs")
+	}),
+	foundation({
+		uuid: "0038068b-64ba-443e-973c-75ea73a5ece7",
+		id: "sm",
+		category: "radius",
+		value: raw("min(calc(var(--noctis-seed-radius) * 0.75), 0.5rem)"),
+		description: "Corner radius — sm.",
+		usage: "The rounded-sm utility.",
+		utility: "rounded-sm",
+		bridge: themeInline("--radius-sm")
+	}),
+	foundation({
+		uuid: "218d2347-9b0a-4e33-a8c3-cdc336890b59",
+		id: "md",
+		category: "radius",
+		value: raw("min(var(--noctis-seed-radius), 0.625rem)"),
+		description: "Corner radius — md.",
+		usage: "The rounded-md utility.",
+		utility: "rounded-md",
+		bridge: themeInline("--radius-md")
+	}),
+	foundation({
+		uuid: "1e93c1fb-edce-487f-a100-757fb336621f",
+		id: "lg",
+		category: "radius",
+		value: raw("min(calc(var(--noctis-seed-radius) * 1.5), 0.875rem)"),
+		description: "Corner radius — lg.",
+		usage: "The rounded-lg utility.",
+		utility: "rounded-lg",
+		bridge: themeInline("--radius-lg")
+	}),
+	foundation({
+		uuid: "d5fa2ad2-2336-4cb7-a6c4-b8a47f4d9bd8",
+		id: "xl",
+		category: "radius",
+		value: raw("min(calc(var(--noctis-seed-radius) * 2), 1.25rem)"),
+		description: "Corner radius — xl.",
+		usage: "The rounded-xl utility.",
+		utility: "rounded-xl",
+		bridge: themeInline("--radius-xl")
+	}),
+	foundation({
+		uuid: "3f890c01-e8b1-4563-99fb-84146cb5e79b",
+		id: "full",
+		category: "radius",
+		value: raw("9999px"),
+		description: "Corner radius — full.",
+		usage: "The rounded-full utility.",
+		utility: "rounded-full",
+		bridge: themeInline("--radius-full")
+	}),
+	foundation({
+		uuid: "a0d422fd-1cce-4d34-a399-7004927dd980",
+		id: "control",
+		category: "radius",
+		value: raw("var(--noctis-seed-radius)"),
+		description: "Corner radius — control.",
+		usage: "The rounded-control utility.",
+		utility: "rounded-control",
+		bridge: themeInline("--radius-control")
+	}),
+	foundation({
+		uuid: "122406f3-d0c7-46c3-9675-f86f3d50949e",
+		id: "standard",
+		category: "ease",
+		value: raw("cubic-bezier(0.25, 0.46, 0.45, 0.94)"),
+		description: "Easing curve — standard.",
+		usage: "The ease-standard utility.",
+		utility: "ease-standard",
+		bridge: themeInline("--ease-standard")
+	}),
+	foundation({
+		uuid: "b0a0c4fd-932b-4a8c-8964-630b10d8aeb9",
+		id: "in",
+		category: "ease",
+		value: raw("cubic-bezier(0.55, 0.055, 0.675, 0.19)"),
+		description: "Easing curve — in.",
+		usage: "The ease-in utility.",
+		utility: "ease-in",
+		bridge: themeInline("--ease-in")
+	}),
+	foundation({
+		uuid: "5dd9fc83-457e-480e-b989-fc6a47fbd6da",
+		id: "out",
+		category: "ease",
+		value: raw("cubic-bezier(0.215, 0.61, 0.355, 1)"),
+		description: "Easing curve — out.",
+		usage: "The ease-out utility.",
+		utility: "ease-out",
+		bridge: themeInline("--ease-out")
+	}),
+	foundation({
+		uuid: "46e01fe2-e027-4034-8686-5e1032a99455",
+		id: "in-out",
+		category: "ease",
+		value: raw("cubic-bezier(0.645, 0.045, 0.355, 1)"),
+		description: "Easing curve — in-out.",
+		usage: "The ease-in-out utility.",
+		utility: "ease-in-out",
+		bridge: themeInline("--ease-in-out")
+	}),
+	foundation({
+		uuid: "5a608cbe-7451-4a99-ae66-9236388cfb46",
+		id: "overlay",
+		category: "ease",
+		value: raw("cubic-bezier(0.32, 0.72, 0, 1)"),
+		description: "Easing curve — overlay slide. A long, settling ease for modal-overlay motion.",
+		usage: "The ease-overlay utility — the command-palette and overlay slide-in curve.",
+		utility: "ease-overlay",
+		bridge: themeInline("--ease-overlay")
+	}),
+	foundation({
+		uuid: "94a86419-1b42-44bc-aa11-959b7c115d54",
+		id: "fast",
+		category: "duration",
+		value: raw("0.1s"),
+		description: "Transition duration — fast.",
+		usage: "The fast motion duration — exit transitions and indicators.",
+		bridge: themeInline("--transition-duration-fast")
+	}),
+	foundation({
+		uuid: "01bf8244-15f9-48a4-abb9-3cfcb93f0b96",
+		id: "quick",
+		category: "duration",
+		value: raw("0.15s"),
+		description: "Transition duration — quick.",
+		usage: "The library-wide control-feedback duration — hover/press transitions on controls.",
+		bridge: themeInline("--transition-duration-quick")
+	}),
+	foundation({
+		uuid: "3ed9d4d3-0525-4df3-afdf-87ffa332c639",
+		id: "regular",
+		category: "duration",
+		value: raw("0.2s"),
+		description: "Transition duration — regular.",
+		usage: "The regular motion duration — surface and indicator transitions.",
+		bridge: themeInline("--transition-duration-regular")
+	}),
+	foundation({
+		uuid: "afd02fcd-99ce-40d0-8e4a-0eb1dccde12f",
+		id: "slow",
+		category: "duration",
+		value: raw("0.35s"),
+		description: "Transition duration — slow.",
+		usage: "The slow motion duration — panel collapse and content push.",
+		bridge: themeInline("--transition-duration-slow")
+	}),
+	foundation({
+		uuid: "454da440-88d0-4d28-a4fa-b10f27da5046",
+		id: "overlay",
+		category: "duration",
+		value: raw("0.26s"),
+		description: "Transition duration — overlay.",
+		usage: "The modal-overlay motion duration — the command-palette backdrop and popup slide.",
+		bridge: themeInline("--transition-duration-overlay")
+	}),
+	foundation({
+		uuid: "00beceae-3555-43ef-bac6-4c577f4481fc",
+		id: "control-xs",
+		category: "size",
+		value: raw("calc(1.25rem * var(--noctis-seed-density))"),
+		description: "Control height — xs (20px at density 1).",
+		usage: "The xs control height — extra-small buttons, chips, and the shortcut chip."
+	}),
+	foundation({
+		uuid: "a7df1cf1-7116-4e6a-8ce1-b362ff0b9cde",
+		id: "control-sm",
+		category: "size",
+		value: raw("calc(1.625rem * var(--noctis-seed-density))"),
+		description: "Control height — sm (26px at density 1).",
+		usage: "The sm control height — compact buttons, tabs, swatches, and triggers."
+	}),
+	foundation({
+		uuid: "9fc04a8b-38a2-4eb7-8c82-cb601047fd87",
+		id: "control-md",
+		category: "size",
+		value: raw("calc(2.25rem * var(--noctis-seed-density))"),
+		description: "Control height — md (36px at density 1).",
+		usage: "The default control height — buttons, inputs, and the code-block header."
+	}),
+	foundation({
+		uuid: "a5d4d2e9-5b21-4287-b4f5-5583bd309c5b",
+		id: "control-lg",
+		category: "size",
+		value: raw("calc(2.5rem * var(--noctis-seed-density))"),
+		description: "Control height — lg (40px at density 1).",
+		usage: "The large control height — prominent buttons and swatches."
+	}),
+	foundation({
+		uuid: "24e6d310-66bc-4ed3-aa9c-1cba023f638d",
+		id: "focus-ring-width",
+		category: "size",
+		value: raw("2px"),
+		description: "Focus-ring outline width.",
+		usage: "The keyboard focus-ring thickness shared by every control."
+	}),
+	foundation({
+		uuid: "316e17af-d943-4640-be47-e3e674a26601",
+		id: "focus-ring-offset",
+		category: "size",
+		value: raw("2px"),
+		description: "Focus-ring outline offset.",
+		usage: "The gap between a control's edge and its focus ring."
+	}),
+	...SPACING_STEPS.map(spacingToken),
+	foundation({
+		uuid: "e6e2cace-236d-4c1b-8b67-38e1dbd1cf9c",
+		id: "region",
+		category: "space",
+		value: raw("calc(1.25rem * var(--noctis-seed-density))"),
+		description: "Region padding (1.25rem at density 1).",
+		usage: "The padding of a panel region — sheet and rail header/body/footer."
+	}),
+	foundation({
+		uuid: "571b6804-2df8-43ca-8476-4053a3ae3f68",
+		id: "base",
+		category: "z",
+		value: raw("0"),
+		description: "Stacking context — base.",
+		usage: "Read as var(--noctis-z-base)."
+	}),
+	foundation({
+		uuid: "c0ecb198-b2a2-4a59-b3f3-a1e8bf83eba7",
+		id: "raised",
+		category: "z",
+		value: raw("1"),
+		description: "Stacking context — raised.",
+		usage: "A within-component raise above an adjacent sibling — read as var(--noctis-z-raised).",
+		bridge: themeInline("--z-index-raised")
+	}),
+	foundation({
+		uuid: "609bc1db-7304-44ae-992a-a2f6be0ed0bf",
+		id: "dropdown",
+		category: "z",
+		value: raw("1000"),
+		description: "Stacking context — dropdown.",
+		usage: "Read as var(--noctis-z-dropdown).",
+		bridge: themeInline("--z-index-dropdown")
+	}),
+	foundation({
+		uuid: "40b3456b-bfcb-42fe-a6e3-c4a36e4f77ea",
+		id: "sticky",
+		category: "z",
+		value: raw("1100"),
+		description: "Stacking context — sticky.",
+		usage: "Read as var(--noctis-z-sticky).",
+		bridge: themeInline("--z-index-sticky")
+	}),
+	foundation({
+		uuid: "e394402e-0a5d-45cf-868c-b6a6d7e16ff2",
+		id: "overlay",
+		category: "z",
+		value: raw("1300"),
+		description: "Stacking context — overlay.",
+		usage: "Read as var(--noctis-z-overlay).",
+		bridge: themeInline("--z-index-overlay")
+	}),
+	foundation({
+		uuid: "30fcdde1-058f-4fe3-b681-2a7b7648b9a6",
+		id: "modal",
+		category: "z",
+		value: raw("1400"),
+		description: "Stacking context — modal.",
+		usage: "Read as var(--noctis-z-modal).",
+		bridge: themeInline("--z-index-modal")
+	}),
+	foundation({
+		uuid: "d355e4b1-84f4-456e-b273-ae6ebe5e6a60",
+		id: "popover",
+		category: "z",
+		value: raw("1500"),
+		description: "Stacking context — popover.",
+		usage: "Read as var(--noctis-z-popover).",
+		bridge: themeInline("--z-index-popover")
+	}),
+	foundation({
+		uuid: "cb5d5a20-94a7-4115-9405-2ee6ef690ede",
+		id: "toast",
+		category: "z",
+		value: raw("1700"),
+		description: "Stacking context — toast.",
+		usage: "Read as var(--noctis-z-toast).",
+		bridge: themeInline("--z-index-toast")
+	}),
+	foundation({
+		uuid: "d07c23f6-5712-4ac9-8895-fd99b8715b59",
+		id: "sm",
+		category: "breakpoint",
+		value: raw("40rem"),
+		description: "Responsive breakpoint — sm.",
+		usage: "The sm: Tailwind variant.",
+		bridge: {
+			kind: "theme",
+			name: "--breakpoint-sm"
+		}
+	}),
+	foundation({
+		uuid: "607d5a56-6536-444c-a9d6-364dcd3f8259",
+		id: "md",
+		category: "breakpoint",
+		value: raw("48rem"),
+		description: "Responsive breakpoint — md.",
+		usage: "The md: Tailwind variant.",
+		bridge: {
+			kind: "theme",
+			name: "--breakpoint-md"
+		}
+	}),
+	foundation({
+		uuid: "4621e544-f4be-4062-a52c-884c2f63e85b",
+		id: "lg",
+		category: "breakpoint",
+		value: raw("64rem"),
+		description: "Responsive breakpoint — lg.",
+		usage: "The lg: Tailwind variant.",
+		bridge: {
+			kind: "theme",
+			name: "--breakpoint-lg"
+		}
+	}),
+	foundation({
+		uuid: "28a388ed-5d29-4118-9926-8e905b876550",
+		id: "xl",
+		category: "breakpoint",
+		value: raw("80rem"),
+		description: "Responsive breakpoint — xl.",
+		usage: "The xl: Tailwind variant.",
+		bridge: {
+			kind: "theme",
+			name: "--breakpoint-xl"
+		}
+	}),
+	foundation({
+		uuid: "dd165786-b647-49bc-9bfa-1c98ea601519",
+		id: "2xl",
+		category: "breakpoint",
+		value: raw("96rem"),
+		description: "Responsive breakpoint — 2xl.",
+		usage: "The 2xl: Tailwind variant.",
+		bridge: {
+			kind: "theme",
+			name: "--breakpoint-2xl"
+		}
+	}),
+	...SHADOW_PARTS.map(shadowPartToken),
+	foundation({
+		uuid: "c3f1a8d6-5b2e-4c9a-8d7f-1e4b6a3c9d2e",
+		id: "low",
+		category: "shadow",
+		value: raw(`${shadowLayer("low", 1)}, ${shadowLayer("low", 2)}`),
+		description: "Elevation shadow — low. The resting card/raised-surface drop shadow, composed from its parts.",
+		usage: "The shadow-card utility.",
+		utility: "shadow-card",
+		bridge: themeInline("--shadow-card")
+	}),
+	foundation({
+		uuid: "d4e2b9c7-6c3f-4d8b-9e1a-2f5c7b4d1e3f",
+		id: "medium",
+		category: "shadow",
+		value: raw(`${shadowLayer("medium", 1)}, ${shadowLayer("medium", 2)}`),
+		description: "Elevation shadow — medium. The popover/floating-surface drop shadow, composed from its parts.",
+		usage: "The shadow-popover utility.",
+		utility: "shadow-popover",
+		bridge: themeInline("--shadow-popover")
+	}),
+	foundation({
+		uuid: "e5f3c0d8-7d4a-4e9c-8f2b-3a6d8c5e2f4a",
+		id: "high",
+		category: "shadow",
+		value: raw(`${shadowLayer("high", 1)}, ${shadowLayer("high", 2)}`),
+		description: "Elevation shadow — high. The modal/dialog drop shadow, composed from its parts.",
+		usage: "The shadow-modal utility.",
+		utility: "shadow-modal",
+		bridge: themeInline("--shadow-modal")
+	}),
+	foundation({
+		uuid: "f6a4d1e9-8e5b-4f0d-9a3c-4b7e9d6f3a5b",
+		id: "inset",
+		category: "shadow",
+		value: raw(`inset ${shadowLayer("inset", 1)}`),
+		description: "Inset shadow. The recessed inner shadow for wells, inputs, and any drilled-in panel, composed from its parts.",
+		usage: "The shadow-inset utility.",
+		utility: "shadow-inset",
+		bridge: themeInline("--shadow-inset")
+	}),
+	foundation({
+		uuid: "a7b5e2f0-9f6c-4a1e-8b4d-5c8f0e7a4b6c",
+		id: "focus",
+		category: "shadow",
+		value: raw(focusShadowLayer()),
+		description: "Focus shadow. The focus-ring shadow drawn around a focused control — geometry parts × engine focus ring.",
+		usage: "The shadow-focus utility.",
+		utility: "shadow-focus",
+		bridge: themeInline("--shadow-focus")
+	}),
+	foundation({
+		uuid: "3a8b64d4-f3b5-43f4-9163-583f143152f4",
+		id: "sm",
+		category: "shadow",
+		value: raw("0 1px 3px 0 #0000001a, 0 1px 2px -1px #0000001a"),
+		description: "Utility shadow — sm (mirrors Tailwind's shadow-sm; --shadow-*: initial owns the namespace).",
+		usage: "The shadow-sm utility — light docs-chrome lift outside the elevation ladder.",
+		utility: "shadow-sm",
+		bridge: themeInline("--shadow-sm")
+	}),
+	foundation({
+		uuid: "67659a08-cdd4-4bdc-aef7-8610b04dcc55",
+		id: "sm",
+		category: "blur",
+		value: raw("8px"),
+		description: "Blur radius — sm (mirrors Tailwind's blur-sm).",
+		usage: "The blur-sm / backdrop-blur-sm utilities.",
+		utility: "backdrop-blur-sm",
+		bridge: themeInline("--blur-sm")
+	}),
+	foundation({
+		uuid: "4fb231f7-8f17-4313-8a20-3b17f9aea733",
+		id: "md",
+		category: "blur",
+		value: raw("12px"),
+		description: "Blur radius — md (mirrors Tailwind's blur-md).",
+		usage: "The blur-md / backdrop-blur-md utilities.",
+		utility: "backdrop-blur-md",
+		bridge: themeInline("--blur-md")
+	}),
+	foundation({
+		uuid: "d9355fc1-97e0-4308-9381-52751b162dc4",
+		id: "spin",
+		category: "animate",
+		value: raw("spin 1s linear infinite"),
+		description: "Animation — spin (mirrors Tailwind's animate-spin; the spin keyframes ship top-level in tokens.css).",
+		usage: "The animate-spin utility — busy indicators.",
+		utility: "animate-spin",
+		bridge: themeInline("--animate-spin")
+	}),
+	foundation({
+		uuid: "240c3da2-515c-4371-b8a0-2ab522cd1001",
+		id: "xs",
+		category: "container",
+		value: raw("20rem"),
+		description: "Container width — xs (mirrors Tailwind's --container-xs).",
+		usage: "The max-w-xs / w-xs named width step.",
+		bridge: themeInline("--container-xs")
+	}),
+	foundation({
+		uuid: "9d112d43-299f-46c9-ad2e-78012822572e",
+		id: "sm",
+		category: "container",
+		value: raw("24rem"),
+		description: "Container width — sm (mirrors Tailwind's --container-sm).",
+		usage: "The max-w-sm / w-sm named width step.",
+		bridge: themeInline("--container-sm")
+	}),
+	foundation({
+		uuid: "e25fc814-415e-4ef6-b861-5b00bdaf7c00",
+		id: "md",
+		category: "container",
+		value: raw("28rem"),
+		description: "Container width — md (mirrors Tailwind's --container-md).",
+		usage: "The max-w-md / w-md named width step.",
+		bridge: themeInline("--container-md")
+	}),
+	foundation({
+		uuid: "99c4044e-3659-47a3-b012-9c7f114995ba",
+		id: "xl",
+		category: "container",
+		value: raw("36rem"),
+		description: "Container width — xl (mirrors Tailwind's --container-xl).",
+		usage: "The max-w-xl / w-xl named width step.",
+		bridge: themeInline("--container-xl")
+	}),
+	foundation({
+		uuid: "8818e6db-b489-49a8-b80e-3bed139a41ff",
+		id: "2xl",
+		category: "container",
+		value: raw("42rem"),
+		description: "Container width — 2xl (mirrors Tailwind's --container-2xl).",
+		usage: "The max-w-2xl / w-2xl named width step.",
+		bridge: themeInline("--container-2xl")
+	}),
+	foundation({
+		uuid: "4f12acb2-9ecf-4d10-853b-965479d8114f",
+		id: "3xl",
+		category: "container",
+		value: raw("48rem"),
+		description: "Container width — 3xl (mirrors Tailwind's --container-3xl).",
+		usage: "The max-w-3xl / w-3xl named width step.",
+		bridge: themeInline("--container-3xl")
+	}),
+	foundation({
+		uuid: "9e27cf1b-07fa-4ddd-8aed-3eae37d7cdb1",
+		id: "7xl",
+		category: "container",
+		value: raw("80rem"),
+		description: "Container width — 7xl (mirrors Tailwind's --container-7xl).",
+		usage: "The max-w-7xl / w-7xl named width step.",
+		bridge: themeInline("--container-7xl")
+	}),
+	foundation({
+		uuid: "b2b54886-a35d-41e5-8888-d866fccfec22",
+		id: "width-1",
+		category: "border",
+		value: raw("1px"),
+		description: "Border width — 1px (the default border).",
+		usage: "The border / border-1 width step.",
+		bridge: themeInline("--border-width-1")
+	}),
+	foundation({
+		uuid: "814e3789-e9e1-4216-8269-b4a09d4e6d07",
+		id: "width-2",
+		category: "border",
+		value: raw("2px"),
+		description: "Border width — 2px.",
+		usage: "The border-2 width step.",
+		bridge: themeInline("--border-width-2")
+	}),
+	foundation({
+		uuid: "3e83f22c-942f-4385-840e-cff5250aac18",
+		id: "width-4",
+		category: "border",
+		value: raw("4px"),
+		description: "Border width — 4px.",
+		usage: "The border-4 width step.",
+		bridge: themeInline("--border-width-4")
+	})
+];
+//#endregion
+export { FOUNDATION_TOKENS };