@hewnui/themes 0.0.0-stage → 0.1.0

package/dist/authoring/pack-def.js

@@ -0,0 +1,3 @@
+export function o(l, c, h, alpha) {
+    return alpha === undefined ? { l, c, h } : { l, c, h, alpha };
+}

package/dist/authoring/pack-meta.d.ts

@@ -0,0 +1,10 @@
+import type { BasePackId } from "./types";
+/** Curated pack identity copy — mirrors docs/design-hewn-v2.md. */
+export declare const PACK_IDENTITY: Record<BasePackId, {
+    label: string;
+    summary: string;
+}>;
+export declare const COLOR_ROLES: Record<string, string>;
+/** Shared design rules for DESIGN.md and agent skills. */
+export declare const DESIGN_DO: readonly ["Use semantic OKLCH tokens (`--kp-*` / `--color-*`); never hard-code theme hues.", "Typography: IBM Plex Sans (UI), IBM Plex Mono (code/labels), Space Grotesk only for marketing hero H1 and brand wordmark ≥18px.", "Icons: Phosphor. Interactive hit targets ≥40×40px; press feedback `scale(0.96)`.", "Motion: animate transform, opacity, and filter; reduced motion always wins.", "Radius: concentric scale; panels use `--kp-radius-panel` (never full-pill menus/dialogs).", "Glass is a global material — tint, blur, saturation, refraction edge, opaque fallback."];
+export declare const DESIGN_DONT: readonly ["No purple/lila defaults, neon glow, pure black, Inter, emoji, or generic centered heroes.", "Never `transition: all` — list exact properties.", "Never `h-screen` for full-height sections — use `min-h-[100dvh]`.", "No per-component `glass` prop; material is global.", "Do not invent unsupported light/dark combinations for a pack.", "Do not put Space Grotesk in UI chrome, forms, or dense product copy."];

package/dist/authoring/pack-meta.js

@@ -0,0 +1,58 @@
+/** Curated pack identity copy — mirrors docs/design-hewn-v2.md. */
+export const PACK_IDENTITY = {
+    forest: {
+        label: "Forest",
+        summary: "Moss and emerald; grounded organic product UI.",
+    },
+    tide: {
+        label: "Tide",
+        summary: "Mineral neutrals and desaturated teal.",
+    },
+    graphite: {
+        label: "Graphite",
+        summary: "Technical neutral and restrained steel-blue.",
+    },
+    dune: {
+        label: "Dune",
+        summary: "Sand, ochre, soft paper surfaces.",
+    },
+    clay: {
+        label: "Clay",
+        summary: "Warm stone and terracotta.",
+    },
+    ember: {
+        label: "Ember",
+        summary: "Charcoal and burnt orange.",
+    },
+};
+export const COLOR_ROLES = {
+    background: "Page and app canvas",
+    foreground: "Primary text and icons",
+    surface: "Cards, panels, and elevated chrome",
+    "surface-raised": "Overlays and nested elevation",
+    muted: "Subtle fills and disabled wells",
+    "muted-foreground": "Secondary text and captions",
+    accent: "Primary actions and focus accents",
+    "accent-foreground": "Text/icons on accent",
+    border: "Separators and control outlines",
+    ring: "Focus ring",
+    danger: "Destructive and error states",
+    "glass-tint": "Tinted frosted glass material",
+};
+/** Shared design rules for DESIGN.md and agent skills. */
+export const DESIGN_DO = [
+    "Use semantic OKLCH tokens (`--kp-*` / `--color-*`); never hard-code theme hues.",
+    "Typography: IBM Plex Sans (UI), IBM Plex Mono (code/labels), Space Grotesk only for marketing hero H1 and brand wordmark ≥18px.",
+    "Icons: Phosphor. Interactive hit targets ≥40×40px; press feedback `scale(0.96)`.",
+    "Motion: animate transform, opacity, and filter; reduced motion always wins.",
+    "Radius: concentric scale; panels use `--kp-radius-panel` (never full-pill menus/dialogs).",
+    "Glass is a global material — tint, blur, saturation, refraction edge, opaque fallback.",
+];
+export const DESIGN_DONT = [
+    "No purple/lila defaults, neon glow, pure black, Inter, emoji, or generic centered heroes.",
+    "Never `transition: all` — list exact properties.",
+    "Never `h-screen` for full-height sections — use `min-h-[100dvh]`.",
+    "No per-component `glass` prop; material is global.",
+    "Do not invent unsupported light/dark combinations for a pack.",
+    "Do not put Space Grotesk in UI chrome, forms, or dense product copy.",
+];

package/dist/authoring/packs-dual.d.ts

@@ -0,0 +1,129 @@
+/** Dual-mode curated packs. Keep in sync with src/packs/*.css. */
+export declare const DUAL_PACKS: {
+    readonly forest: {
+        readonly structural: {
+            readonly radiusSm: "0.5rem";
+            readonly radiusMd: "0.75rem";
+            readonly radiusLg: "1rem";
+            readonly radiusPanel: "1rem";
+            readonly density: 1;
+            readonly motionDuration: "260ms";
+            readonly motionStiffness: 360;
+            readonly motionDamping: 28;
+        };
+        readonly modes: {
+            readonly light: {
+                readonly background: import("./types").Oklch;
+                readonly foreground: import("./types").Oklch;
+                readonly surface: import("./types").Oklch;
+                readonly surfaceRaised: import("./types").Oklch;
+                readonly muted: import("./types").Oklch;
+                readonly mutedForeground: import("./types").Oklch;
+                readonly accent: import("./types").Oklch;
+                readonly accentForeground: import("./types").Oklch;
+                readonly border: import("./types").Oklch;
+                readonly ring: import("./types").Oklch;
+                readonly danger: import("./types").Oklch;
+                readonly glassTint: import("./types").Oklch;
+            };
+            readonly dark: {
+                readonly background: import("./types").Oklch;
+                readonly foreground: import("./types").Oklch;
+                readonly surface: import("./types").Oklch;
+                readonly surfaceRaised: import("./types").Oklch;
+                readonly muted: import("./types").Oklch;
+                readonly mutedForeground: import("./types").Oklch;
+                readonly accent: import("./types").Oklch;
+                readonly accentForeground: import("./types").Oklch;
+                readonly border: import("./types").Oklch;
+                readonly ring: import("./types").Oklch;
+                readonly danger: import("./types").Oklch;
+                readonly glassTint: import("./types").Oklch;
+            };
+        };
+    };
+    readonly tide: {
+        readonly structural: {
+            readonly radiusSm: "0.45rem";
+            readonly radiusMd: "0.7rem";
+            readonly radiusLg: "0.95rem";
+            readonly radiusPanel: "0.95rem";
+            readonly density: 1;
+            readonly motionDuration: "240ms";
+            readonly motionStiffness: 380;
+            readonly motionDamping: 30;
+        };
+        readonly modes: {
+            readonly light: {
+                readonly background: import("./types").Oklch;
+                readonly foreground: import("./types").Oklch;
+                readonly surface: import("./types").Oklch;
+                readonly surfaceRaised: import("./types").Oklch;
+                readonly muted: import("./types").Oklch;
+                readonly mutedForeground: import("./types").Oklch;
+                readonly accent: import("./types").Oklch;
+                readonly accentForeground: import("./types").Oklch;
+                readonly border: import("./types").Oklch;
+                readonly ring: import("./types").Oklch;
+                readonly danger: import("./types").Oklch;
+                readonly glassTint: import("./types").Oklch;
+            };
+            readonly dark: {
+                readonly background: import("./types").Oklch;
+                readonly foreground: import("./types").Oklch;
+                readonly surface: import("./types").Oklch;
+                readonly surfaceRaised: import("./types").Oklch;
+                readonly muted: import("./types").Oklch;
+                readonly mutedForeground: import("./types").Oklch;
+                readonly accent: import("./types").Oklch;
+                readonly accentForeground: import("./types").Oklch;
+                readonly border: import("./types").Oklch;
+                readonly ring: import("./types").Oklch;
+                readonly danger: import("./types").Oklch;
+                readonly glassTint: import("./types").Oklch;
+            };
+        };
+    };
+    readonly graphite: {
+        readonly structural: {
+            readonly radiusSm: "0.4rem";
+            readonly radiusMd: "0.6rem";
+            readonly radiusLg: "0.85rem";
+            readonly radiusPanel: "0.85rem";
+            readonly density: 1.05;
+            readonly motionDuration: "220ms";
+            readonly motionStiffness: 420;
+            readonly motionDamping: 32;
+        };
+        readonly modes: {
+            readonly light: {
+                readonly background: import("./types").Oklch;
+                readonly foreground: import("./types").Oklch;
+                readonly surface: import("./types").Oklch;
+                readonly surfaceRaised: import("./types").Oklch;
+                readonly muted: import("./types").Oklch;
+                readonly mutedForeground: import("./types").Oklch;
+                readonly accent: import("./types").Oklch;
+                readonly accentForeground: import("./types").Oklch;
+                readonly border: import("./types").Oklch;
+                readonly ring: import("./types").Oklch;
+                readonly danger: import("./types").Oklch;
+                readonly glassTint: import("./types").Oklch;
+            };
+            readonly dark: {
+                readonly background: import("./types").Oklch;
+                readonly foreground: import("./types").Oklch;
+                readonly surface: import("./types").Oklch;
+                readonly surfaceRaised: import("./types").Oklch;
+                readonly muted: import("./types").Oklch;
+                readonly mutedForeground: import("./types").Oklch;
+                readonly accent: import("./types").Oklch;
+                readonly accentForeground: import("./types").Oklch;
+                readonly border: import("./types").Oklch;
+                readonly ring: import("./types").Oklch;
+                readonly danger: import("./types").Oklch;
+                readonly glassTint: import("./types").Oklch;
+            };
+        };
+    };
+};

package/dist/authoring/packs-dual.js

@@ -0,0 +1,130 @@
+import { o } from "./pack-def.js";
+/** Dual-mode curated packs. Keep in sync with src/packs/*.css. */
+export const DUAL_PACKS = {
+    forest: {
+        structural: {
+            radiusSm: "0.5rem",
+            radiusMd: "0.75rem",
+            radiusLg: "1rem",
+            radiusPanel: "1rem",
+            density: 1,
+            motionDuration: "260ms",
+            motionStiffness: 360,
+            motionDamping: 28,
+        },
+        modes: {
+            light: {
+                background: o(0.972, 0.012, 145),
+                foreground: o(0.225, 0.028, 145),
+                surface: o(0.995, 0.004, 145),
+                surfaceRaised: o(1, 0, 0),
+                muted: o(0.925, 0.022, 145),
+                mutedForeground: o(0.49, 0.035, 145),
+                accent: o(0.49, 0.105, 148),
+                accentForeground: o(0.985, 0.008, 145),
+                border: o(0.36, 0.035, 145, 0.14),
+                ring: o(0.55, 0.12, 148),
+                danger: o(0.56, 0.17, 27),
+                glassTint: o(0.72, 0.12, 148, 0.28),
+            },
+            dark: {
+                background: o(0.185, 0.018, 145),
+                foreground: o(0.93, 0.018, 145),
+                surface: o(0.225, 0.024, 145),
+                surfaceRaised: o(0.265, 0.028, 145),
+                muted: o(0.285, 0.026, 145),
+                mutedForeground: o(0.715, 0.03, 145),
+                accent: o(0.71, 0.12, 148),
+                accentForeground: o(0.985, 0.01, 145),
+                border: o(0.86, 0.025, 145, 0.13),
+                ring: o(0.71, 0.12, 148),
+                danger: o(0.68, 0.16, 27),
+                glassTint: o(0.63, 0.13, 148, 0.24),
+            },
+        },
+    },
+    tide: {
+        structural: {
+            radiusSm: "0.45rem",
+            radiusMd: "0.7rem",
+            radiusLg: "0.95rem",
+            radiusPanel: "0.95rem",
+            density: 1,
+            motionDuration: "240ms",
+            motionStiffness: 380,
+            motionDamping: 30,
+        },
+        modes: {
+            light: {
+                background: o(0.97, 0.01, 220),
+                foreground: o(0.24, 0.03, 230),
+                surface: o(0.995, 0.004, 220),
+                surfaceRaised: o(1, 0, 0),
+                muted: o(0.93, 0.015, 220),
+                mutedForeground: o(0.48, 0.03, 230),
+                accent: o(0.52, 0.07, 210),
+                accentForeground: o(0.98, 0.01, 210),
+                border: o(0.35, 0.03, 230, 0.14),
+                ring: o(0.58, 0.08, 210),
+                danger: o(0.56, 0.17, 27),
+                glassTint: o(0.72, 0.08, 210, 0.28),
+            },
+            dark: {
+                background: o(0.18, 0.02, 230),
+                foreground: o(0.92, 0.015, 220),
+                surface: o(0.22, 0.025, 230),
+                surfaceRaised: o(0.26, 0.028, 230),
+                muted: o(0.28, 0.025, 230),
+                mutedForeground: o(0.72, 0.025, 220),
+                accent: o(0.72, 0.08, 205),
+                accentForeground: o(0.985, 0.01, 220),
+                border: o(0.86, 0.02, 220, 0.13),
+                ring: o(0.72, 0.08, 205),
+                danger: o(0.68, 0.16, 27),
+                glassTint: o(0.6, 0.09, 205, 0.24),
+            },
+        },
+    },
+    graphite: {
+        structural: {
+            radiusSm: "0.4rem",
+            radiusMd: "0.6rem",
+            radiusLg: "0.85rem",
+            radiusPanel: "0.85rem",
+            density: 1.05,
+            motionDuration: "220ms",
+            motionStiffness: 420,
+            motionDamping: 32,
+        },
+        modes: {
+            light: {
+                background: o(0.965, 0.005, 255),
+                foreground: o(0.23, 0.02, 255),
+                surface: o(0.99, 0.003, 255),
+                surfaceRaised: o(1, 0, 0),
+                muted: o(0.925, 0.008, 255),
+                mutedForeground: o(0.47, 0.02, 255),
+                accent: o(0.48, 0.06, 250),
+                accentForeground: o(0.98, 0.01, 250),
+                border: o(0.34, 0.02, 255, 0.14),
+                ring: o(0.55, 0.07, 250),
+                danger: o(0.55, 0.17, 27),
+                glassTint: o(0.7, 0.06, 250, 0.26),
+            },
+            dark: {
+                background: o(0.17, 0.012, 255),
+                foreground: o(0.93, 0.01, 255),
+                surface: o(0.21, 0.015, 255),
+                surfaceRaised: o(0.25, 0.018, 255),
+                muted: o(0.27, 0.016, 255),
+                mutedForeground: o(0.715, 0.015, 255),
+                accent: o(0.7, 0.07, 245),
+                accentForeground: o(0.985, 0.008, 255),
+                border: o(0.85, 0.012, 255, 0.12),
+                ring: o(0.7, 0.07, 245),
+                danger: o(0.68, 0.16, 27),
+                glassTint: o(0.58, 0.07, 245, 0.22),
+            },
+        },
+    },
+};

package/dist/authoring/packs-single.d.ts

@@ -0,0 +1,87 @@
+/** Single-mode curated packs. Keep in sync with src/packs/*.css. */
+export declare const SINGLE_PACKS: {
+    readonly dune: {
+        readonly structural: {
+            readonly radiusSm: "0.55rem";
+            readonly radiusMd: "0.85rem";
+            readonly radiusLg: "1.15rem";
+            readonly radiusPanel: "1.15rem";
+            readonly density: 0.95;
+            readonly motionDuration: "280ms";
+            readonly motionStiffness: 300;
+            readonly motionDamping: 26;
+        };
+        readonly modes: {
+            readonly light: {
+                readonly background: import("./types").Oklch;
+                readonly foreground: import("./types").Oklch;
+                readonly surface: import("./types").Oklch;
+                readonly surfaceRaised: import("./types").Oklch;
+                readonly muted: import("./types").Oklch;
+                readonly mutedForeground: import("./types").Oklch;
+                readonly accent: import("./types").Oklch;
+                readonly accentForeground: import("./types").Oklch;
+                readonly border: import("./types").Oklch;
+                readonly ring: import("./types").Oklch;
+                readonly danger: import("./types").Oklch;
+                readonly glassTint: import("./types").Oklch;
+            };
+        };
+    };
+    readonly clay: {
+        readonly structural: {
+            readonly radiusSm: "0.5rem";
+            readonly radiusMd: "0.8rem";
+            readonly radiusLg: "1.05rem";
+            readonly radiusPanel: "1.05rem";
+            readonly density: 1;
+            readonly motionDuration: "270ms";
+            readonly motionStiffness: 320;
+            readonly motionDamping: 27;
+        };
+        readonly modes: {
+            readonly light: {
+                readonly background: import("./types").Oklch;
+                readonly foreground: import("./types").Oklch;
+                readonly surface: import("./types").Oklch;
+                readonly surfaceRaised: import("./types").Oklch;
+                readonly muted: import("./types").Oklch;
+                readonly mutedForeground: import("./types").Oklch;
+                readonly accent: import("./types").Oklch;
+                readonly accentForeground: import("./types").Oklch;
+                readonly border: import("./types").Oklch;
+                readonly ring: import("./types").Oklch;
+                readonly danger: import("./types").Oklch;
+                readonly glassTint: import("./types").Oklch;
+            };
+        };
+    };
+    readonly ember: {
+        readonly structural: {
+            readonly radiusSm: "0.45rem";
+            readonly radiusMd: "0.7rem";
+            readonly radiusLg: "0.95rem";
+            readonly radiusPanel: "0.95rem";
+            readonly density: 1.05;
+            readonly motionDuration: "230ms";
+            readonly motionStiffness: 400;
+            readonly motionDamping: 28;
+        };
+        readonly modes: {
+            readonly dark: {
+                readonly background: import("./types").Oklch;
+                readonly foreground: import("./types").Oklch;
+                readonly surface: import("./types").Oklch;
+                readonly surfaceRaised: import("./types").Oklch;
+                readonly muted: import("./types").Oklch;
+                readonly mutedForeground: import("./types").Oklch;
+                readonly accent: import("./types").Oklch;
+                readonly accentForeground: import("./types").Oklch;
+                readonly border: import("./types").Oklch;
+                readonly ring: import("./types").Oklch;
+                readonly danger: import("./types").Oklch;
+                readonly glassTint: import("./types").Oklch;
+            };
+        };
+    };
+};

package/dist/authoring/packs-single.js

@@ -0,0 +1,88 @@
+import { o } from "./pack-def.js";
+/** Single-mode curated packs. Keep in sync with src/packs/*.css. */
+export const SINGLE_PACKS = {
+    dune: {
+        structural: {
+            radiusSm: "0.55rem",
+            radiusMd: "0.85rem",
+            radiusLg: "1.15rem",
+            radiusPanel: "1.15rem",
+            density: 0.95,
+            motionDuration: "280ms",
+            motionStiffness: 300,
+            motionDamping: 26,
+        },
+        modes: {
+            light: {
+                background: o(0.96, 0.02, 85),
+                foreground: o(0.28, 0.04, 65),
+                surface: o(0.985, 0.012, 90),
+                surfaceRaised: o(0.995, 0.006, 95),
+                muted: o(0.92, 0.025, 85),
+                mutedForeground: o(0.5, 0.04, 70),
+                accent: o(0.58, 0.11, 70),
+                accentForeground: o(0.98, 0.01, 90),
+                border: o(0.4, 0.04, 70, 0.16),
+                ring: o(0.62, 0.12, 70),
+                danger: o(0.55, 0.16, 30),
+                glassTint: o(0.78, 0.09, 80, 0.3),
+            },
+        },
+    },
+    clay: {
+        structural: {
+            radiusSm: "0.5rem",
+            radiusMd: "0.8rem",
+            radiusLg: "1.05rem",
+            radiusPanel: "1.05rem",
+            density: 1,
+            motionDuration: "270ms",
+            motionStiffness: 320,
+            motionDamping: 27,
+        },
+        modes: {
+            light: {
+                background: o(0.955, 0.02, 55),
+                foreground: o(0.27, 0.045, 40),
+                surface: o(0.98, 0.012, 50),
+                surfaceRaised: o(0.995, 0.006, 45),
+                muted: o(0.915, 0.025, 50),
+                mutedForeground: o(0.5, 0.045, 40),
+                accent: o(0.55, 0.12, 40),
+                accentForeground: o(0.98, 0.01, 50),
+                border: o(0.4, 0.05, 40, 0.16),
+                ring: o(0.6, 0.13, 40),
+                danger: o(0.54, 0.17, 28),
+                glassTint: o(0.74, 0.1, 45, 0.28),
+            },
+        },
+    },
+    ember: {
+        structural: {
+            radiusSm: "0.45rem",
+            radiusMd: "0.7rem",
+            radiusLg: "0.95rem",
+            radiusPanel: "0.95rem",
+            density: 1.05,
+            motionDuration: "230ms",
+            motionStiffness: 400,
+            motionDamping: 28,
+        },
+        modes: {
+            dark: {
+                background: o(0.17, 0.02, 40),
+                foreground: o(0.93, 0.02, 70),
+                surface: o(0.21, 0.025, 40),
+                surfaceRaised: o(0.255, 0.03, 42),
+                muted: o(0.275, 0.028, 40),
+                mutedForeground: o(0.72, 0.03, 60),
+                accent: o(0.7, 0.15, 50),
+                accentForeground: o(0.985, 0.015, 50),
+                border: o(0.84, 0.03, 60, 0.14),
+                ring: o(0.7, 0.15, 50),
+                danger: o(0.66, 0.17, 28),
+                glassTint: o(0.58, 0.15, 50, 0.28),
+            },
+        },
+    },
+};

package/dist/authoring/packs.d.ts

@@ -0,0 +1,8 @@
+import type { BasePackId, ModeColorTokens, StructuralTokens, ThemeMode } from "./types";
+export type ResolvedPackDef = {
+    modes: Partial<Record<ThemeMode, ModeColorTokens>>;
+    structural: StructuralTokens;
+};
+/** Curated pack color bases (mirrors CSS packs), including status families. */
+export declare const BASE_PACKS: Record<BasePackId, ResolvedPackDef>;
+export declare function supportedModes(packId: BasePackId): ThemeMode[];

package/dist/authoring/packs.js

@@ -0,0 +1,26 @@
+import { DUAL_PACKS } from "./packs-dual.js";
+import { SINGLE_PACKS } from "./packs-single.js";
+import { PACK_STATUS_HUES, statusColors } from "./status-ramps.js";
+function withStatus(id, def) {
+    const hues = PACK_STATUS_HUES[id];
+    const modes = {};
+    for (const [mode, colors] of Object.entries(def.modes)) {
+        modes[mode] = {
+            ...colors,
+            ...statusColors(mode, colors.danger, hues),
+        };
+    }
+    return { structural: def.structural, modes };
+}
+/** Curated pack color bases (mirrors CSS packs), including status families. */
+export const BASE_PACKS = {
+    forest: withStatus("forest", DUAL_PACKS.forest),
+    tide: withStatus("tide", DUAL_PACKS.tide),
+    graphite: withStatus("graphite", DUAL_PACKS.graphite),
+    dune: withStatus("dune", SINGLE_PACKS.dune),
+    clay: withStatus("clay", SINGLE_PACKS.clay),
+    ember: withStatus("ember", SINGLE_PACKS.ember),
+};
+export function supportedModes(packId) {
+    return Object.keys(BASE_PACKS[packId].modes);
+}

package/dist/authoring/pro-apply.d.ts

@@ -0,0 +1,8 @@
+import type { GlassOverrides, ModeColorTokens, NeutralOverrides, OverrideMap, SemanticOverrides, ShapeOverrides, StructuralTokens, ThemeMode } from "./types";
+export declare function applyNeutrals(colors: ModeColorTokens, neutrals: NeutralOverrides | undefined, mode: ThemeMode, adjustments: string[]): ModeColorTokens;
+export declare function applySemantic(colors: ModeColorTokens, semantic: SemanticOverrides | undefined, mode: ThemeMode, adjustments: string[]): ModeColorTokens | {
+    error: string;
+};
+export declare function applyGlass(colors: ModeColorTokens, glass: GlassOverrides | undefined): ModeColorTokens;
+export declare function applyShape(structural: StructuralTokens, shape: ShapeOverrides | undefined): StructuralTokens;
+export declare function applyMotion(structural: StructuralTokens, motion: OverrideMap["motion"]): StructuralTokens;

package/dist/authoring/pro-apply.js

@@ -0,0 +1,107 @@
+import { contrastForeground, parseColor } from "./oklch.js";
+import { statusColors } from "./status-ramps.js";
+const DENSITY = {
+    compact: 0.85,
+    default: 1,
+    comfortable: 1.15,
+};
+const MOTION = {
+    snappy: {
+        motionDuration: "180ms",
+        motionStiffness: 480,
+        motionDamping: 32,
+    },
+    soft: {
+        motionDuration: "340ms",
+        motionStiffness: 220,
+        motionDamping: 26,
+    },
+};
+function clampL(color, delta) {
+    return { ...color, l: Math.min(0.99, Math.max(0.05, color.l + delta)) };
+}
+function scaleC(color, scale) {
+    return { ...color, c: Math.max(0, color.c * scale) };
+}
+function biasNeutral(color, n) {
+    let next = color;
+    if (n.surfaceShift !== undefined)
+        next = clampL(next, n.surfaceShift);
+    if (n.chromaScale !== undefined)
+        next = scaleC(next, n.chromaScale);
+    return next;
+}
+export function applyNeutrals(colors, neutrals, mode, adjustments) {
+    if (!neutrals)
+        return colors;
+    if (neutrals.surfaceShift === undefined &&
+        neutrals.chromaScale === undefined) {
+        return colors;
+    }
+    const next = {
+        ...colors,
+        background: biasNeutral(colors.background, neutrals),
+        surface: biasNeutral(colors.surface, neutrals),
+        surfaceRaised: biasNeutral(colors.surfaceRaised, neutrals),
+        muted: biasNeutral(colors.muted, neutrals),
+        border: biasNeutral(colors.border, neutrals),
+    };
+    const fg = contrastForeground(next.background, colors.foreground);
+    if (fg.adjusted) {
+        next.foreground = fg.color;
+        adjustments.push(`${mode} foreground adjusted after neutral bias to meet WCAG AA`);
+    }
+    else {
+        next.foreground = colors.foreground;
+    }
+    const mutedFg = contrastForeground(next.muted, colors.mutedForeground, 3);
+    next.mutedForeground = mutedFg.color;
+    return next;
+}
+export function applySemantic(colors, semantic, mode, adjustments) {
+    if (!semantic?.dangerSeed)
+        return colors;
+    const seed = parseColor(semantic.dangerSeed);
+    if (!seed)
+        return { error: `invalid danger seed: "${semantic.dangerSeed}"` };
+    const danger = mode === "dark"
+        ? { ...seed, l: Math.min(0.78, Math.max(0.58, seed.l + 0.08)) }
+        : { ...seed, l: Math.min(0.62, Math.max(0.48, seed.l)) };
+    if (danger.l !== seed.l) {
+        adjustments.push(`${mode} danger lightness clamped to ${danger.l.toFixed(2)}`);
+    }
+    const status = statusColors(mode, danger, {
+        success: colors.success.h,
+        warning: colors.warning.h,
+        info: colors.info.h,
+    });
+    return {
+        ...colors,
+        danger,
+        dangerForeground: status.dangerForeground,
+        dangerSubtle: status.dangerSubtle,
+        dangerBorder: status.dangerBorder,
+    };
+}
+export function applyGlass(colors, glass) {
+    if (!glass?.tintStrength || glass.tintStrength === 1)
+        return colors;
+    const base = colors.glassTint.alpha ?? 1;
+    return {
+        ...colors,
+        glassTint: {
+            ...colors.glassTint,
+            alpha: Math.min(0.55, Math.max(0.08, base * glass.tintStrength)),
+        },
+    };
+}
+export function applyShape(structural, shape) {
+    if (!shape?.density || shape.density === "default")
+        return structural;
+    return { ...structural, density: DENSITY[shape.density] };
+}
+export function applyMotion(structural, motion) {
+    if (!motion || motion === "balanced")
+        return structural;
+    return { ...structural, ...MOTION[motion] };
+}