@eifi1/ui-kit 0.33.0 → 0.34.0

package/dist/testing/css-variables.d.ts

@@ -29,8 +29,8 @@
  *  stylesheet's `:root` / `.dark` mirror. Component internals (`--slider-fill`, `--fp-*`,
  *  `--icon-button-tone`, `--label-strip-edge`) are not: an app that reads one depends on
  *  the kit's internals, and the guard says so. */
-declare const KIT_CSS_VARIABLES: ReadonlySet<string>;
-interface UndeclaredCssVariablesOptions {
+export declare const KIT_CSS_VARIABLES: ReadonlySet<string>;
+export interface UndeclaredCssVariablesOptions {
     /** Variables a library writes at runtime, as names or patterns:
      *  `["--radix-collapsible-content-height"]`. An app's own writes are found in its
      *  source and need no listing. */
@@ -47,7 +47,7 @@ interface UndeclaredCssVariablesOptions {
  * declared only inside `@theme inline`, which Tailwind never emits as a variable. Comments
  * are skipped. The same rule builds {@link KIT_CSS_VARIABLES} from `tokens.css`.
  */
-declare function declaredCustomProperties(css: string): Set<string>;
+export declare function declaredCustomProperties(css: string): Set<string>;
 /**
  * Every `var(--name)` without a fallback that nothing declares, as `"path:line --name"`.
  *
@@ -69,6 +69,4 @@ declare function declaredCustomProperties(css: string): Set<string>;
  * (`test.css.include`) would otherwise lose every declaration and every use in it, and
  * this would pass or fail for the wrong reason.
  */
-declare function undeclaredCssVariables(sources: Record<string, string>, options?: UndeclaredCssVariablesOptions): string[];
-
-export { KIT_CSS_VARIABLES, type UndeclaredCssVariablesOptions, declaredCustomProperties, undeclaredCssVariables };
+export declare function undeclaredCssVariables(sources: Record<string, string>, options?: UndeclaredCssVariablesOptions): string[];

package/dist/testing/css-variables.generated.d.ts

@@ -1,7 +1,5 @@
 /** Every custom property tokens.css declares, `@theme inline` names and `--app-nav-h`
  *  left out (100 names). */
-declare const KIT_NAMES: string;
+export declare const KIT_NAMES: string;
 /** The theme variables of Tailwind 4.3.3's `theme.css` (413 names). */
-declare const TAILWIND_THEME_NAMES: string;
-
-export { KIT_NAMES, TAILWIND_THEME_NAMES };
+export declare const TAILWIND_THEME_NAMES: string;

package/dist/testing/index.d.ts

@@ -1 +1,2 @@
-export { KIT_CSS_VARIABLES, UndeclaredCssVariablesOptions, declaredCustomProperties, undeclaredCssVariables } from './css-variables.js';
+export { KIT_CSS_VARIABLES, declaredCustomProperties, undeclaredCssVariables, type UndeclaredCssVariablesOptions, } from "./css-variables.js";
+export { stubResizeObserver, stubViewportWidth, viewportMatchMedia, type ResizeObserverStub, type StubbedBoxSize, type ViewportOptions, } from "./viewport.js";

package/dist/testing/index.js

@@ -4,9 +4,17 @@ import {
   declaredCustomProperties,
   undeclaredCssVariables
 } from "./css-variables.js";
+import {
+  stubResizeObserver,
+  stubViewportWidth,
+  viewportMatchMedia
+} from "./viewport.js";
 export {
   KIT_CSS_VARIABLES,
   declaredCustomProperties,
-  undeclaredCssVariables
+  stubResizeObserver,
+  stubViewportWidth,
+  undeclaredCssVariables,
+  viewportMatchMedia
 };
 //# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["// `@eifi1/ui-kit/testing` — helpers an app runs from its OWN test suite (0.33).\n//\n// Not part of the main barrel: nothing here renders, and an app's production bundle has\n// no business carrying it. Browser-safe like the rest of the kit (no `node:fs`): each\n// helper takes texts, so an app collects them with `import.meta.glob` or `node:fs`, as\n// its setup allows. The first content is the guard against undeclared CSS custom\n// properties (docs/colour-roles-harmonization.md §8).\nexport {\n  KIT_CSS_VARIABLES,\n  declaredCustomProperties,\n  undeclaredCssVariables,\n  type UndeclaredCssVariablesOptions,\n} from \"./css-variables\";\n"],"mappings":";AAOA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;","names":[]}
+{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["// `@eifi1/ui-kit/testing` — helpers an app runs from its OWN test suite (0.33).\n//\n// Not part of the main barrel: nothing here renders, and an app's production bundle has\n// no business carrying it. Browser-safe like the rest of the kit (no `node:fs`): each\n// helper takes texts, so an app collects them with `import.meta.glob` or `node:fs`, as\n// its setup allows. The first content is the guard against undeclared CSS custom\n// properties (docs/colour-roles-harmonization.md §8).\nexport {\n  KIT_CSS_VARIABLES,\n  declaredCustomProperties,\n  undeclaredCssVariables,\n  type UndeclaredCssVariablesOptions,\n} from \"./css-variables\";\n// 0.34 (refactor audit 2026-10, TST-10): the environment jsdom lacks — a `matchMedia`\n// that answers from a viewport width (right at every text size) and a `ResizeObserver`\n// the test drives. Framework-free: each returns its own undo.\nexport {\n  stubResizeObserver,\n  stubViewportWidth,\n  viewportMatchMedia,\n  type ResizeObserverStub,\n  type StubbedBoxSize,\n  type ViewportOptions,\n} from \"./viewport\";\n"],"mappings":";AAOA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAIP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;","names":[]}

package/dist/testing/viewport.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Environment stubs for an app's own tests (0.34, refactor audit 2026-10, TST-10): the
+ * two browser APIs jsdom does not have and the kit's layout reads — `matchMedia` and
+ * `ResizeObserver`.
+ *
+ * Every suite rebuilt them by hand: the kit stubbed `matchMedia` in 25 files and defined
+ * the same `stubPhone()` eight times, keksdose stubs it in 41, and most copies answer
+ * one literal string. That breaks quietly at Large text, where `md` is 960 px and the
+ * phone query the kit writes is `(width < 960px)`, not `(width < 768px)`. These answer
+ * every width query from a WIDTH, as a browser does, so they stay right at every text
+ * size (docs/text-size-harmonization.md §3.3). The reference is keksdose's
+ * `frontend/src/test/viewport.ts`, which this generalises.
+ *
+ * Framework-free, like the rest of `@eifi1/ui-kit/testing`: nothing here imports vitest
+ * or jest. Each stub returns its own undo, so it works under either runner, and a suite
+ * that prefers `vi.stubGlobal` passes it {@link viewportMatchMedia} instead.
+ */
+/** The media features a test may want besides the width. Each is off by default. */
+export interface ViewportOptions {
+    /** The primary pointer is a finger: `(pointer: coarse)`, `(any-pointer: coarse)` and
+     *  `(hover: none)` match; `(pointer: fine)` and `(hover: hover)` do not. */
+    coarse?: boolean;
+    /** The person asked for less motion: `(prefers-reduced-motion: reduce)` matches, and
+     *  the kit's overlays skip their exit animations. */
+    reducedMotion?: boolean;
+    /** `(prefers-color-scheme: dark)` matches (`light` does not). */
+    dark?: boolean;
+    /** `(prefers-contrast: more)` matches. */
+    moreContrast?: boolean;
+}
+/**
+ * A `window.matchMedia` for a viewport `width` CSS px wide.
+ *
+ * Width queries answer from `width`: the range syntax the kit writes for `max-*`
+ * (`(width < 768px)`) and every other comparison, `(min-width: …)` and `(max-width: …)`,
+ * in px or rem; `and` and comma lists combine as in CSS. The features in `options` answer
+ * as set there; every other query is false. The lists it returns never change, so
+ * nothing fires `change`: a test that changes the width stubs again and renders again.
+ *
+ * Hand it to the runner's own global stub where the suite undoes stubs that way —
+ * `vi.stubGlobal("matchMedia", viewportMatchMedia(375))` — or use
+ * {@link stubViewportWidth}.
+ */
+export declare function viewportMatchMedia(width: number, options?: ViewportOptions): (query: string) => MediaQueryList;
+/**
+ * Make `window.matchMedia` answer as a viewport `width` CSS px wide (see
+ * {@link viewportMatchMedia}), and return the undo: it puts back what was there, which
+ * in jsdom is nothing — no `matchMedia` at all, the desktop fallback of every kit hook.
+ *
+ * ```ts
+ * let undo = () => {};
+ * afterEach(() => undo());
+ * it("shows cards on a phone", () => {
+ *   undo = stubViewportWidth(375);
+ *   …
+ * });
+ * ```
+ *
+ * Right at every text size: at Large the kit's phone query is `(width < 960px)`, which a
+ * 375 px viewport matches and a 1280 px one does not, as in a browser.
+ */
+export declare function stubViewportWidth(width: number, options?: ViewportOptions): () => void;
+/** A box size for {@link ResizeObserverStub.resize}, in CSS px. */
+export interface StubbedBoxSize {
+    width: number;
+    height: number;
+}
+/** What {@link stubResizeObserver} returns: the test drives the observers. */
+export interface ResizeObserverStub {
+    /**
+     * Report `target` at `size` to every live observer watching it, as a browser does once
+     * layout settles: one entry, with `contentRect` and the three box sizes all `size`.
+     * Synchronous; wrap it in `act()` when the callback sets state.
+     */
+    resize(target: Element, size: StubbedBoxSize): void;
+    /** The elements some live observer watches now, each once. */
+    observed(): Element[];
+    /** Put back the `ResizeObserver` that was there before — in jsdom, none. */
+    restore(): void;
+}
+/**
+ * Install a `ResizeObserver` the test drives. jsdom has none, and lays nothing out, so a
+ * component that measures itself (a windowed list, a fitted chart, a measured grid)
+ * either crashes on the missing global or never learns a size. Observers here record
+ * what they watch and are called only by {@link ResizeObserverStub.resize}.
+ *
+ * ```ts
+ * const ro = stubResizeObserver();
+ * afterEach(() => ro.restore());
+ * act(() => ro.resize(screen.getByRole("list"), { width: 400, height: 320 }));
+ * ```
+ */
+export declare function stubResizeObserver(): ResizeObserverStub;

package/dist/testing/viewport.js

@@ -0,0 +1,152 @@
+"use client";
+function lengthPx(value, unit) {
+  return unit === "px" ? Number(value) : Number(value) * 16;
+}
+const RANGE = /^\(\s*width\s*(<=|>=|<|>)\s*([\d.]+)(px|r?em)\s*\)$/;
+const MIN_MAX = /^\(\s*(min|max)-width\s*:\s*([\d.]+)(px|r?em)\s*\)$/;
+const FEATURE = /^\(\s*([a-z-]+)\s*:\s*([a-z-]+)\s*\)$/;
+function condition(part, width, options) {
+  const q = part.trim();
+  if (q === "all" || q === "screen") return true;
+  const range = RANGE.exec(q);
+  if (range) {
+    const px = lengthPx(range[2], range[3]);
+    switch (range[1]) {
+      case "<":
+        return width < px;
+      case "<=":
+        return width <= px;
+      case ">":
+        return width > px;
+      default:
+        return width >= px;
+    }
+  }
+  const minMax = MIN_MAX.exec(q);
+  if (minMax) {
+    const px = lengthPx(minMax[2], minMax[3]);
+    return minMax[1] === "min" ? width >= px : width <= px;
+  }
+  const feature = FEATURE.exec(q);
+  if (!feature) return false;
+  const [, name, value] = feature;
+  const coarse = Boolean(options.coarse);
+  switch (name) {
+    case "pointer":
+    case "any-pointer":
+      return value === (coarse ? "coarse" : "fine");
+    case "hover":
+    case "any-hover":
+      return value === (coarse ? "none" : "hover");
+    case "prefers-reduced-motion":
+      return value === (options.reducedMotion ? "reduce" : "no-preference");
+    case "prefers-color-scheme":
+      return value === (options.dark ? "dark" : "light");
+    case "prefers-contrast":
+      return value === (options.moreContrast ? "more" : "no-preference");
+    default:
+      return false;
+  }
+}
+function viewportMatchMedia(width, options = {}) {
+  const answer = (query) => query.split(",").some(
+    (alternative) => alternative.split(/\s+and\s+/).every((part) => condition(part, width, options))
+  );
+  return (query) => ({
+    matches: answer(query),
+    media: query,
+    onchange: null,
+    addEventListener: () => {
+    },
+    removeEventListener: () => {
+    },
+    addListener: () => {
+    },
+    removeListener: () => {
+    },
+    dispatchEvent: () => false
+  });
+}
+function stubViewportWidth(width, options = {}) {
+  const before = Object.getOwnPropertyDescriptor(window, "matchMedia");
+  Object.defineProperty(window, "matchMedia", {
+    configurable: true,
+    writable: true,
+    value: viewportMatchMedia(width, options)
+  });
+  return () => {
+    if (before) Object.defineProperty(window, "matchMedia", before);
+    else Reflect.deleteProperty(window, "matchMedia");
+  };
+}
+function stubResizeObserver() {
+  const live = /* @__PURE__ */ new Set();
+  class StubResizeObserver {
+    constructor(callback) {
+      this.callback = callback;
+      live.add(this);
+    }
+    callback;
+    targets = /* @__PURE__ */ new Set();
+    observe(target) {
+      this.targets.add(target);
+    }
+    unobserve(target) {
+      this.targets.delete(target);
+    }
+    disconnect() {
+      this.targets.clear();
+      live.delete(this);
+    }
+  }
+  const before = Object.getOwnPropertyDescriptor(globalThis, "ResizeObserver");
+  Object.defineProperty(globalThis, "ResizeObserver", {
+    configurable: true,
+    writable: true,
+    value: StubResizeObserver
+  });
+  return {
+    resize(target, { width, height }) {
+      const box = [{ inlineSize: width, blockSize: height }];
+      const contentRect = {
+        x: 0,
+        y: 0,
+        top: 0,
+        left: 0,
+        width,
+        height,
+        right: width,
+        bottom: height,
+        toJSON: () => ({ x: 0, y: 0, width, height })
+      };
+      const entry = {
+        target,
+        contentRect,
+        borderBoxSize: box,
+        contentBoxSize: box,
+        devicePixelContentBoxSize: box
+      };
+      for (const observer of [...live]) {
+        if (observer.targets.has(target)) {
+          observer.callback([entry], observer);
+        }
+      }
+    },
+    observed() {
+      const all = [];
+      for (const observer of live) for (const target of observer.targets) if (!all.includes(target)) all.push(target);
+      return all;
+    },
+    restore() {
+      live.clear();
+      if (before) Object.defineProperty(globalThis, "ResizeObserver", before);
+      else Reflect.deleteProperty(globalThis, "ResizeObserver");
+    }
+  };
+}
+export {
+  stubResizeObserver,
+  stubViewportWidth,
+  viewportMatchMedia
+};
+//# sourceMappingURL=viewport.js.map

package/dist/testing/viewport.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/viewport.ts"],"sourcesContent":["/**\n * Environment stubs for an app's own tests (0.34, refactor audit 2026-10, TST-10): the\n * two browser APIs jsdom does not have and the kit's layout reads — `matchMedia` and\n * `ResizeObserver`.\n *\n * Every suite rebuilt them by hand: the kit stubbed `matchMedia` in 25 files and defined\n * the same `stubPhone()` eight times, keksdose stubs it in 41, and most copies answer\n * one literal string. That breaks quietly at Large text, where `md` is 960 px and the\n * phone query the kit writes is `(width < 960px)`, not `(width < 768px)`. These answer\n * every width query from a WIDTH, as a browser does, so they stay right at every text\n * size (docs/text-size-harmonization.md §3.3). The reference is keksdose's\n * `frontend/src/test/viewport.ts`, which this generalises.\n *\n * Framework-free, like the rest of `@eifi1/ui-kit/testing`: nothing here imports vitest\n * or jest. Each stub returns its own undo, so it works under either runner, and a suite\n * that prefers `vi.stubGlobal` passes it {@link viewportMatchMedia} instead.\n */\n\n/** The media features a test may want besides the width. Each is off by default. */\nexport interface ViewportOptions {\n  /** The primary pointer is a finger: `(pointer: coarse)`, `(any-pointer: coarse)` and\n   *  `(hover: none)` match; `(pointer: fine)` and `(hover: hover)` do not. */\n  coarse?: boolean;\n  /** The person asked for less motion: `(prefers-reduced-motion: reduce)` matches, and\n   *  the kit's overlays skip their exit animations. */\n  reducedMotion?: boolean;\n  /** `(prefers-color-scheme: dark)` matches (`light` does not). */\n  dark?: boolean;\n  /** `(prefers-contrast: more)` matches. */\n  moreContrast?: boolean;\n}\n\n/** One length in CSS px. A media query's `rem`/`em` is the browser's default font size,\n *  16 px, never `<html>`'s — the kit's own `breakpointQuery` writes px. */\nfunction lengthPx(value: string, unit: string): number {\n  return unit === \"px\" ? Number(value) : Number(value) * 16;\n}\n\nconst RANGE = /^\\(\\s*width\\s*(<=|>=|<|>)\\s*([\\d.]+)(px|r?em)\\s*\\)$/;\nconst MIN_MAX = /^\\(\\s*(min|max)-width\\s*:\\s*([\\d.]+)(px|r?em)\\s*\\)$/;\nconst FEATURE = /^\\(\\s*([a-z-]+)\\s*:\\s*([a-z-]+)\\s*\\)$/;\n\n/** One `(…)` condition, or a media type. */\nfunction condition(part: string, width: number, options: ViewportOptions): boolean {\n  const q = part.trim();\n  if (q === \"all\" || q === \"screen\") return true;\n  const range = RANGE.exec(q);\n  if (range) {\n    const px = lengthPx(range[2], range[3]);\n    switch (range[1]) {\n      case \"<\":\n        return width < px;\n      case \"<=\":\n        return width <= px;\n      case \">\":\n        return width > px;\n      default:\n        return width >= px;\n    }\n  }\n  const minMax = MIN_MAX.exec(q);\n  if (minMax) {\n    const px = lengthPx(minMax[2], minMax[3]);\n    return minMax[1] === \"min\" ? width >= px : width <= px;\n  }\n  const feature = FEATURE.exec(q);\n  if (!feature) return false;\n  const [, name, value] = feature;\n  const coarse = Boolean(options.coarse);\n  switch (name) {\n    case \"pointer\":\n    case \"any-pointer\":\n      return value === (coarse ? \"coarse\" : \"fine\");\n    case \"hover\":\n    case \"any-hover\":\n      return value === (coarse ? \"none\" : \"hover\");\n    case \"prefers-reduced-motion\":\n      return value === (options.reducedMotion ? \"reduce\" : \"no-preference\");\n    case \"prefers-color-scheme\":\n      return value === (options.dark ? \"dark\" : \"light\");\n    case \"prefers-contrast\":\n      return value === (options.moreContrast ? \"more\" : \"no-preference\");\n    default:\n      return false;\n  }\n}\n\n/**\n * A `window.matchMedia` for a viewport `width` CSS px wide.\n *\n * Width queries answer from `width`: the range syntax the kit writes for `max-*`\n * (`(width < 768px)`) and every other comparison, `(min-width: …)` and `(max-width: …)`,\n * in px or rem; `and` and comma lists combine as in CSS. The features in `options` answer\n * as set there; every other query is false. The lists it returns never change, so\n * nothing fires `change`: a test that changes the width stubs again and renders again.\n *\n * Hand it to the runner's own global stub where the suite undoes stubs that way —\n * `vi.stubGlobal(\"matchMedia\", viewportMatchMedia(375))` — or use\n * {@link stubViewportWidth}.\n */\nexport function viewportMatchMedia(\n  width: number,\n  options: ViewportOptions = {},\n): (query: string) => MediaQueryList {\n  const answer = (query: string) =>\n    query\n      .split(\",\")\n      .some((alternative) =>\n        alternative.split(/\\s+and\\s+/).every((part) => condition(part, width, options)),\n      );\n  return (query: string) =>\n    ({\n      matches: answer(query),\n      media: query,\n      onchange: null,\n      addEventListener: () => {},\n      removeEventListener: () => {},\n      addListener: () => {},\n      removeListener: () => {},\n      dispatchEvent: () => false,\n    }) as unknown as MediaQueryList;\n}\n\n/**\n * Make `window.matchMedia` answer as a viewport `width` CSS px wide (see\n * {@link viewportMatchMedia}), and return the undo: it puts back what was there, which\n * in jsdom is nothing — no `matchMedia` at all, the desktop fallback of every kit hook.\n *\n * ```ts\n * let undo = () => {};\n * afterEach(() => undo());\n * it(\"shows cards on a phone\", () => {\n *   undo = stubViewportWidth(375);\n *   …\n * });\n * ```\n *\n * Right at every text size: at Large the kit's phone query is `(width < 960px)`, which a\n * 375 px viewport matches and a 1280 px one does not, as in a browser.\n */\nexport function stubViewportWidth(width: number, options: ViewportOptions = {}): () => void {\n  const before = Object.getOwnPropertyDescriptor(window, \"matchMedia\");\n  Object.defineProperty(window, \"matchMedia\", {\n    configurable: true,\n    writable: true,\n    value: viewportMatchMedia(width, options),\n  });\n  return () => {\n    if (before) Object.defineProperty(window, \"matchMedia\", before);\n    else Reflect.deleteProperty(window, \"matchMedia\");\n  };\n}\n\n/** A box size for {@link ResizeObserverStub.resize}, in CSS px. */\nexport interface StubbedBoxSize {\n  width: number;\n  height: number;\n}\n\n/** What {@link stubResizeObserver} returns: the test drives the observers. */\nexport interface ResizeObserverStub {\n  /**\n   * Report `target` at `size` to every live observer watching it, as a browser does once\n   * layout settles: one entry, with `contentRect` and the three box sizes all `size`.\n   * Synchronous; wrap it in `act()` when the callback sets state.\n   */\n  resize(target: Element, size: StubbedBoxSize): void;\n  /** The elements some live observer watches now, each once. */\n  observed(): Element[];\n  /** Put back the `ResizeObserver` that was there before — in jsdom, none. */\n  restore(): void;\n}\n\n/**\n * Install a `ResizeObserver` the test drives. jsdom has none, and lays nothing out, so a\n * component that measures itself (a windowed list, a fitted chart, a measured grid)\n * either crashes on the missing global or never learns a size. Observers here record\n * what they watch and are called only by {@link ResizeObserverStub.resize}.\n *\n * ```ts\n * const ro = stubResizeObserver();\n * afterEach(() => ro.restore());\n * act(() => ro.resize(screen.getByRole(\"list\"), { width: 400, height: 320 }));\n * ```\n */\nexport function stubResizeObserver(): ResizeObserverStub {\n  const live = new Set<StubResizeObserver>();\n\n  class StubResizeObserver {\n    readonly targets = new Set<Element>();\n    constructor(readonly callback: ResizeObserverCallback) {\n      live.add(this);\n    }\n    observe(target: Element) {\n      this.targets.add(target);\n    }\n    unobserve(target: Element) {\n      this.targets.delete(target);\n    }\n    disconnect() {\n      this.targets.clear();\n      live.delete(this);\n    }\n  }\n\n  const before = Object.getOwnPropertyDescriptor(globalThis, \"ResizeObserver\");\n  Object.defineProperty(globalThis, \"ResizeObserver\", {\n    configurable: true,\n    writable: true,\n    value: StubResizeObserver,\n  });\n\n  return {\n    resize(target, { width, height }) {\n      const box = [{ inlineSize: width, blockSize: height }];\n      const contentRect = {\n        x: 0,\n        y: 0,\n        top: 0,\n        left: 0,\n        width,\n        height,\n        right: width,\n        bottom: height,\n        toJSON: () => ({ x: 0, y: 0, width, height }),\n      };\n      const entry = {\n        target,\n        contentRect,\n        borderBoxSize: box,\n        contentBoxSize: box,\n        devicePixelContentBoxSize: box,\n      } as unknown as ResizeObserverEntry;\n      for (const observer of [...live]) {\n        if (observer.targets.has(target)) {\n          observer.callback([entry], observer as unknown as ResizeObserver);\n        }\n      }\n    },\n    observed() {\n      const all: Element[] = [];\n      for (const observer of live) for (const target of observer.targets) if (!all.includes(target)) all.push(target);\n      return all;\n    },\n    restore() {\n      live.clear();\n      if (before) Object.defineProperty(globalThis, \"ResizeObserver\", before);\n      else Reflect.deleteProperty(globalThis, \"ResizeObserver\");\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/theme/chart-palette.d.ts

@@ -5,23 +5,23 @@
  *  exist — a series with no stroke at all. A fractional index is truncated, and one
  *  that is not a number (NaN, ±Infinity — an `indexOf` miss divided by something)
  *  takes the first colour rather than `var(--chart-NaN)`. */
-declare function paletteFor(index: number): string;
+export declare function paletteFor(index: number): string;
 /** Semantic money colours, theme-aware via tokens. Pair with +/- and arrow
     cues at the call site so colour is never the only signal (CVD). */
-declare const CHART_COLORS: {
+export declare const CHART_COLORS: {
     readonly income: "var(--money-income)";
     readonly expense: "var(--money-expense)";
     readonly net: "var(--money-net)";
     readonly assigned: "var(--brand)";
     readonly activity: "var(--money-expense)";
 };
-declare const PALETTE_HEX: {
+export declare const PALETTE_HEX: {
     readonly light: readonly ["#332288", "#88ccee", "#44aa99", "#117733", "#999933", "#ddcc77", "#cc6677", "#882255", "#aa4499"];
     readonly dark: readonly ["#7e72d6", "#9fd8f2", "#5fc4b0", "#3fa45f", "#bfbf5e", "#e8dda0", "#e08c9a", "#c25a78", "#cc78be"];
 };
 /** A heatmap's interpolation stops for one theme. Open string fields so any
     palette preset (not just the built-in default) can supply its own stops. */
-interface HeatStops {
+export interface HeatStops {
     neutral: string;
     under: string;
     over: string;
@@ -31,7 +31,7 @@ interface HeatStops {
 }
 /** Diverging (variance: under←0→over) and sequential (spending intensity)
     heatmap stops, per theme. Teal = under/good, amber = over/spend = bad. */
-declare const HEATMAP_HEX: {
+export declare const HEATMAP_HEX: {
     readonly light: {
         readonly neutral: "#f1e7d2";
         readonly under: "#0b6650";
@@ -50,7 +50,7 @@ declare const HEATMAP_HEX: {
     };
 };
 /** Linear interpolate two #rrggbb hexes; `t` in [0,1]. Returns #rrggbb. */
-declare function lerpHex(a: string, b: string, t: number): string;
+export declare function lerpHex(a: string, b: string, t: number): string;
 /** Pick a legible text colour (near-black / near-white) for a solid hex fill, by
     MEASURING both against it and keeping the one that wins.
 
@@ -68,6 +68,4 @@ declare function lerpHex(a: string, b: string, t: number): string;
     category with zero assigned and positive activity — a refund). Picking a constant
     instead is what produced the earlier bug: the unparsed fill fell through to the
     light ink, near-white on a near-white cell, and the figure was invisible. */
-declare function textOn(hex: string): string;
-
-export { CHART_COLORS, HEATMAP_HEX, type HeatStops, PALETTE_HEX, lerpHex, paletteFor, textOn };
+export declare function textOn(hex: string): string;

package/dist/theme/color.d.ts

@@ -18,13 +18,13 @@
  *
  * Reference: Björn Ottosson, "A perceptual color space for image processing" (2020).
  */
-interface Rgb {
+export interface Rgb {
     /** 0–255. */
     r: number;
     g: number;
     b: number;
 }
-interface Oklch {
+export interface Oklch {
     /** Perceptual lightness, 0–1. */
     l: number;
     /** Chroma, 0–~0.4 in sRGB. */
@@ -33,9 +33,9 @@ interface Oklch {
     h: number;
 }
 /** `#rgb` or `#rrggbb` → components, or null when it is neither. */
-declare function parseHex(hex: string): Rgb | null;
-declare function toHex({ r, g, b }: Rgb): string;
-declare function rgbToOklch(rgb: Rgb): Oklch;
+export declare function parseHex(hex: string): Rgb | null;
+export declare function toHex({ r, g, b }: Rgb): string;
+export declare function rgbToOklch(rgb: Rgb): Oklch;
 /**
  * OKLCH → sRGB, reducing CHROMA until the colour fits.
  *
@@ -45,13 +45,13 @@ declare function rgbToOklch(rgb: Rgb): Oklch;
  * recognisably the one that was asked for, which matters when the whole point is to
  * derive a family at a fixed lightness.
  */
-declare function oklchToRgb(target: Oklch): Rgb;
-declare function hexToOklch(hex: string): Oklch | null;
-declare function oklchToHex(lch: Oklch): string;
+export declare function oklchToRgb(target: Oklch): Rgb;
+export declare function hexToOklch(hex: string): Oklch | null;
+export declare function oklchToHex(lch: Oklch): string;
 /** WCAG 2.x relative luminance. */
-declare function luminance(rgb: Rgb): number;
+export declare function luminance(rgb: Rgb): number;
 /** WCAG 2.x contrast ratio, 1–21. Order-independent. */
-declare function contrast(a: Rgb | string, b: Rgb | string): number;
+export declare function contrast(a: Rgb | string, b: Rgb | string): number;
 /**
  * The lightness at hue `h`, chroma `c` that hits `target` contrast against `against`.
  *
@@ -65,14 +65,12 @@ declare function contrast(a: Rgb | string, b: Rgb | string): number;
  * it returns the extreme end, and the caller should check the contrast it actually got
  * rather than assuming success — `deriveTokenSet` does exactly that.
  */
-declare function solveLightness(target: number, against: Rgb, h: number, c: number, direction: "lighter" | "darker"): number;
-type CvdType = "protanopia" | "deuteranopia" | "tritanopia";
-declare function simulateCvd(rgb: Rgb, type: CvdType): Rgb;
+export declare function solveLightness(target: number, against: Rgb, h: number, c: number, direction: "lighter" | "darker"): number;
+export type CvdType = "protanopia" | "deuteranopia" | "tritanopia";
+export declare function simulateCvd(rgb: Rgb, type: CvdType): Rgb;
 /**
  * Perceptual distance in OKLab, which is what that space is FOR: a Euclidean distance
  * in OKLab corresponds far more closely to "how different do these look" than one in
  * sRGB, where the same numeric gap is obvious among greens and invisible among blues.
  */
-declare function deltaE(a: Rgb, b: Rgb): number;
-
-export { type CvdType, type Oklch, type Rgb, contrast, deltaE, hexToOklch, luminance, oklchToHex, oklchToRgb, parseHex, rgbToOklch, simulateCvd, solveLightness, toHex };
+export declare function deltaE(a: Rgb, b: Rgb): number;

package/dist/theme/color.js

@@ -86,9 +86,10 @@ function solveLightness(target, against, h, c, direction) {
   const bgL = rgbToOklch(against).l;
   let lo = direction === "darker" ? 0 : bgL;
   let hi = direction === "darker" ? bgL : 1;
+  const bg = toHex(against);
   for (let i = 0; i < 24; i++) {
     const mid = (lo + hi) / 2;
-    const got = contrast(oklchToRgb({ l: mid, c, h }), against);
+    const got = contrast(toHex(oklchToRgb({ l: mid, c, h })), bg);
     if (got < target) {
       if (direction === "darker") hi = mid;
       else lo = mid;

package/dist/theme/color.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/color.ts"],"sourcesContent":["/**\n * Colour maths for the palette system: sRGB ↔ OKLab ↔ OKLCH, WCAG contrast, gamut\n * clipping, and colour-vision-deficiency simulation.\n *\n * Dependency-free on purpose. This package already ships 48MB of runtime dependencies\n * for a 1.4MB library, and a colour-space conversion is forty lines of arithmetic that\n * will not change — importing culori or chroma-js to get it would be the largest\n * dependency in the kit, paid for by every consumer, to avoid writing down formulas\n * that were published once and are now fixed.\n *\n * **Why OKLCH rather than HSL.** HSL's \"lightness\" is not lightness: `hsl(60 100% 50%)`\n * (yellow) and `hsl(240 100% 50%)` (blue) claim the same 50% and differ by a factor of\n * about twelve in perceived brightness. Any scheme that derives a palette by holding HSL\n * lightness constant therefore produces a set that looks wildly uneven, and any scheme\n * that solves for contrast in HSL has to solve separately per hue. OKLab is built so a\n * given L means the same apparent lightness at every hue, which is what makes \"same\n * lightness, different hue\" a usable rule and what makes a contrast solve converge.\n *\n * Reference: Björn Ottosson, \"A perceptual color space for image processing\" (2020).\n */\n\nexport interface Rgb {\n  /** 0–255. */\n  r: number;\n  g: number;\n  b: number;\n}\n\nexport interface Oklch {\n  /** Perceptual lightness, 0–1. */\n  l: number;\n  /** Chroma, 0–~0.4 in sRGB. */\n  c: number;\n  /** Hue angle in degrees, 0–360. */\n  h: number;\n}\n\n/* ── sRGB ─────────────────────────────────────────────────────────────────── */\n\n/** `#rgb` or `#rrggbb` → components, or null when it is neither. */\nexport function parseHex(hex: string): Rgb | null {\n  const h = hex.trim().replace(/^#/, \"\");\n  const full =\n    h.length === 3\n      ? h\n          .split(\"\")\n          .map((c) => c + c)\n          .join(\"\")\n      : h;\n  if (!/^[0-9a-fA-F]{6}$/.test(full)) return null;\n  return {\n    r: parseInt(full.slice(0, 2), 16),\n    g: parseInt(full.slice(2, 4), 16),\n    b: parseInt(full.slice(4, 6), 16),\n  };\n}\n\nexport function toHex({ r, g, b }: Rgb): string {\n  const part = (v: number) =>\n    Math.max(0, Math.min(255, Math.round(v)))\n      .toString(16)\n      .padStart(2, \"0\");\n  return `#${part(r)}${part(g)}${part(b)}`;\n}\n\n/** sRGB 0–255 → linear-light 0–1. The transfer function, not a gamma of 2.2. */\nfunction toLinear(channel: number): number {\n  const c = channel / 255;\n  return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;\n}\n\nfunction fromLinear(channel: number): number {\n  const c = channel <= 0.0031308 ? 12.92 * channel : 1.055 * channel ** (1 / 2.4) - 0.055;\n  return c * 255;\n}\n\n/* ── OKLab / OKLCH ────────────────────────────────────────────────────────── */\n\nexport function rgbToOklch(rgb: Rgb): Oklch {\n  const r = toLinear(rgb.r);\n  const g = toLinear(rgb.g);\n  const b = toLinear(rgb.b);\n\n  const l = Math.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b);\n  const m = Math.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b);\n  const s = Math.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b);\n\n  const L = 0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s;\n  const A = 1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s;\n  const B = 0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s;\n\n  const c = Math.sqrt(A * A + B * B);\n  // Hue is meaningless at zero chroma; 0 keeps it stable rather than NaN-adjacent.\n  const h = c < 1e-6 ? 0 : ((Math.atan2(B, A) * 180) / Math.PI + 360) % 360;\n  return { l: L, c, h };\n}\n\n/** OKLCH → sRGB, WITHOUT gamut clipping. May return components outside 0–255. */\nfunction oklchToRgbRaw({ l, c, h }: Oklch): Rgb {\n  const rad = (h * Math.PI) / 180;\n  const A = c * Math.cos(rad);\n  const B = c * Math.sin(rad);\n\n  const l_ = (l + 0.3963377774 * A + 0.2158037573 * B) ** 3;\n  const m_ = (l - 0.1055613458 * A - 0.0638541728 * B) ** 3;\n  const s_ = (l - 0.0894841775 * A - 1.291485548 * B) ** 3;\n\n  return {\n    r: fromLinear(4.0767416621 * l_ - 3.3077115913 * m_ + 0.2309699292 * s_),\n    g: fromLinear(-1.2684380046 * l_ + 2.6097574011 * m_ - 0.3413193965 * s_),\n    b: fromLinear(-0.0041960863 * l_ - 0.7034186147 * m_ + 1.707614701 * s_),\n  };\n}\n\nfunction inGamut({ r, g, b }: Rgb): boolean {\n  const ok = (v: number) => v >= -0.5 && v <= 255.5;\n  return ok(r) && ok(g) && ok(b);\n}\n\n/**\n * OKLCH → sRGB, reducing CHROMA until the colour fits.\n *\n * Clamping the channels instead — the obvious approach — shifts hue and lightness\n * together and unpredictably: a saturated blue that overflows clips to a different blue\n * that is also lighter. Holding L and h and giving up chroma keeps the colour\n * recognisably the one that was asked for, which matters when the whole point is to\n * derive a family at a fixed lightness.\n */\nexport function oklchToRgb(target: Oklch): Rgb {\n  const direct = oklchToRgbRaw(target);\n  if (inGamut(direct)) return direct;\n\n  let lo = 0;\n  let hi = target.c;\n  // 20 halvings resolves chroma to ~4e-7, far below a perceptible step.\n  for (let i = 0; i < 20; i++) {\n    const mid = (lo + hi) / 2;\n    if (inGamut(oklchToRgbRaw({ ...target, c: mid }))) lo = mid;\n    else hi = mid;\n  }\n  return oklchToRgbRaw({ ...target, c: lo });\n}\n\nexport function hexToOklch(hex: string): Oklch | null {\n  const rgb = parseHex(hex);\n  return rgb ? rgbToOklch(rgb) : null;\n}\n\nexport function oklchToHex(lch: Oklch): string {\n  return toHex(oklchToRgb(lch));\n}\n\n/* ── WCAG contrast ────────────────────────────────────────────────────────── */\n\n/** WCAG 2.x relative luminance. */\nexport function luminance(rgb: Rgb): number {\n  return 0.2126 * toLinear(rgb.r) + 0.7152 * toLinear(rgb.g) + 0.0722 * toLinear(rgb.b);\n}\n\n/** WCAG 2.x contrast ratio, 1–21. Order-independent. */\nexport function contrast(a: Rgb | string, b: Rgb | string): number {\n  const ra = typeof a === \"string\" ? parseHex(a) : a;\n  const rb = typeof b === \"string\" ? parseHex(b) : b;\n  if (!ra || !rb) return 1;\n  const la = luminance(ra);\n  const lb = luminance(rb);\n  return (Math.max(la, lb) + 0.05) / (Math.min(la, lb) + 0.05);\n}\n\n/**\n * The lightness at hue `h`, chroma `c` that hits `target` contrast against `against`.\n *\n * Binary search rather than algebra: OKLab lightness does not map to WCAG luminance in\n * closed form, and it is not even monotonic in the general case once gamut clipping\n * starts reducing chroma. It IS monotonic over the half-range we search — away from the\n * background — which is why the direction is chosen first.\n *\n * Returns the best lightness found. If the target is unreachable at this hue and chroma\n * (a saturated yellow cannot make 7:1 against white at any lightness without going grey)\n * it returns the extreme end, and the caller should check the contrast it actually got\n * rather than assuming success — `deriveTokenSet` does exactly that.\n */\nexport function solveLightness(\n  target: number,\n  against: Rgb,\n  h: number,\n  c: number,\n  direction: \"lighter\" | \"darker\",\n): number {\n  // The half-range on the far side of the background from where we are heading.\n  // Going darker, that is [0, backgroundL]; going lighter, [backgroundL, 1]. Contrast is\n  // monotonic across each of those halves, which is what makes a binary search valid —\n  // it is NOT monotonic across the whole 0..1 range, because it turns around at the\n  // background's own lightness.\n  const bgL = rgbToOklch(against).l;\n  let lo = direction === \"darker\" ? 0 : bgL;\n  let hi = direction === \"darker\" ? bgL : 1;\n\n  for (let i = 0; i < 24; i++) {\n    const mid = (lo + hi) / 2;\n    const got = contrast(oklchToRgb({ l: mid, c, h }), against);\n    // Moving AWAY from the background raises contrast; which way that is depends on\n    // whether we are going lighter or darker.\n    if (got < target) {\n      if (direction === \"darker\") hi = mid;\n      else lo = mid;\n    } else if (direction === \"darker\") lo = mid;\n    else hi = mid;\n  }\n  return direction === \"darker\" ? lo : hi;\n}\n\n/* ── Colour-vision deficiency ─────────────────────────────────────────────── */\n\nexport type CvdType = \"protanopia\" | \"deuteranopia\" | \"tritanopia\";\n\n/**\n * Brettel/Viénot-style dichromat simulation in linear RGB.\n *\n * An approximation, and a well-established one. It is here so the kit can FAIL a\n * categorical ramp that two of its series become indistinguishable under, rather than\n * asserting CVD-safety in a comment the way `chart-palette.ts` did — the audit found\n * four of the nine default light chart hues below the 3:1 they were claimed to hold.\n */\nconst CVD_MATRIX: Record<CvdType, number[][]> = {\n  protanopia: [\n    [0.1705, 0.8295, 0],\n    [0.1705, 0.8295, 0],\n    [-0.0045, 0.0045, 1],\n  ],\n  deuteranopia: [\n    [0.33066, 0.66934, 0],\n    [0.33066, 0.66934, 0],\n    [-0.02785, 0.02785, 1],\n  ],\n  tritanopia: [\n    [1, 0.1273, -0.1273],\n    [0, 0.8739, 0.1261],\n    [0, 0.8739, 0.1261],\n  ],\n};\n\nexport function simulateCvd(rgb: Rgb, type: CvdType): Rgb {\n  const m = CVD_MATRIX[type];\n  const [r, g, b] = [toLinear(rgb.r), toLinear(rgb.g), toLinear(rgb.b)];\n  return {\n    r: fromLinear(m[0][0] * r + m[0][1] * g + m[0][2] * b),\n    g: fromLinear(m[1][0] * r + m[1][1] * g + m[1][2] * b),\n    b: fromLinear(m[2][0] * r + m[2][1] * g + m[2][2] * b),\n  };\n}\n\n/**\n * Perceptual distance in OKLab, which is what that space is FOR: a Euclidean distance\n * in OKLab corresponds far more closely to \"how different do these look\" than one in\n * sRGB, where the same numeric gap is obvious among greens and invisible among blues.\n */\nexport function deltaE(a: Rgb, b: Rgb): number {\n  const A = rgbToOklch(a);\n  const B = rgbToOklch(b);\n  const aA = A.c * Math.cos((A.h * Math.PI) / 180);\n  const aB = A.c * Math.sin((A.h * Math.PI) / 180);\n  const bA = B.c * Math.cos((B.h * Math.PI) / 180);\n  const bB = B.c * Math.sin((B.h * Math.PI) / 180);\n  return Math.hypot(A.l - B.l, aA - bA, aB - bB);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/theme/color.ts"],"sourcesContent":["/**\n * Colour maths for the palette system: sRGB ↔ OKLab ↔ OKLCH, WCAG contrast, gamut\n * clipping, and colour-vision-deficiency simulation.\n *\n * Dependency-free on purpose. This package already ships 48MB of runtime dependencies\n * for a 1.4MB library, and a colour-space conversion is forty lines of arithmetic that\n * will not change — importing culori or chroma-js to get it would be the largest\n * dependency in the kit, paid for by every consumer, to avoid writing down formulas\n * that were published once and are now fixed.\n *\n * **Why OKLCH rather than HSL.** HSL's \"lightness\" is not lightness: `hsl(60 100% 50%)`\n * (yellow) and `hsl(240 100% 50%)` (blue) claim the same 50% and differ by a factor of\n * about twelve in perceived brightness. Any scheme that derives a palette by holding HSL\n * lightness constant therefore produces a set that looks wildly uneven, and any scheme\n * that solves for contrast in HSL has to solve separately per hue. OKLab is built so a\n * given L means the same apparent lightness at every hue, which is what makes \"same\n * lightness, different hue\" a usable rule and what makes a contrast solve converge.\n *\n * Reference: Björn Ottosson, \"A perceptual color space for image processing\" (2020).\n */\n\nexport interface Rgb {\n  /** 0–255. */\n  r: number;\n  g: number;\n  b: number;\n}\n\nexport interface Oklch {\n  /** Perceptual lightness, 0–1. */\n  l: number;\n  /** Chroma, 0–~0.4 in sRGB. */\n  c: number;\n  /** Hue angle in degrees, 0–360. */\n  h: number;\n}\n\n/* ── sRGB ─────────────────────────────────────────────────────────────────── */\n\n/** `#rgb` or `#rrggbb` → components, or null when it is neither. */\nexport function parseHex(hex: string): Rgb | null {\n  const h = hex.trim().replace(/^#/, \"\");\n  const full =\n    h.length === 3\n      ? h\n          .split(\"\")\n          .map((c) => c + c)\n          .join(\"\")\n      : h;\n  if (!/^[0-9a-fA-F]{6}$/.test(full)) return null;\n  return {\n    r: parseInt(full.slice(0, 2), 16),\n    g: parseInt(full.slice(2, 4), 16),\n    b: parseInt(full.slice(4, 6), 16),\n  };\n}\n\nexport function toHex({ r, g, b }: Rgb): string {\n  const part = (v: number) =>\n    Math.max(0, Math.min(255, Math.round(v)))\n      .toString(16)\n      .padStart(2, \"0\");\n  return `#${part(r)}${part(g)}${part(b)}`;\n}\n\n/** sRGB 0–255 → linear-light 0–1. The transfer function, not a gamma of 2.2. */\nfunction toLinear(channel: number): number {\n  const c = channel / 255;\n  return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;\n}\n\nfunction fromLinear(channel: number): number {\n  const c = channel <= 0.0031308 ? 12.92 * channel : 1.055 * channel ** (1 / 2.4) - 0.055;\n  return c * 255;\n}\n\n/* ── OKLab / OKLCH ────────────────────────────────────────────────────────── */\n\nexport function rgbToOklch(rgb: Rgb): Oklch {\n  const r = toLinear(rgb.r);\n  const g = toLinear(rgb.g);\n  const b = toLinear(rgb.b);\n\n  const l = Math.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b);\n  const m = Math.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b);\n  const s = Math.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b);\n\n  const L = 0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s;\n  const A = 1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s;\n  const B = 0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s;\n\n  const c = Math.sqrt(A * A + B * B);\n  // Hue is meaningless at zero chroma; 0 keeps it stable rather than NaN-adjacent.\n  const h = c < 1e-6 ? 0 : ((Math.atan2(B, A) * 180) / Math.PI + 360) % 360;\n  return { l: L, c, h };\n}\n\n/** OKLCH → sRGB, WITHOUT gamut clipping. May return components outside 0–255. */\nfunction oklchToRgbRaw({ l, c, h }: Oklch): Rgb {\n  const rad = (h * Math.PI) / 180;\n  const A = c * Math.cos(rad);\n  const B = c * Math.sin(rad);\n\n  const l_ = (l + 0.3963377774 * A + 0.2158037573 * B) ** 3;\n  const m_ = (l - 0.1055613458 * A - 0.0638541728 * B) ** 3;\n  const s_ = (l - 0.0894841775 * A - 1.291485548 * B) ** 3;\n\n  return {\n    r: fromLinear(4.0767416621 * l_ - 3.3077115913 * m_ + 0.2309699292 * s_),\n    g: fromLinear(-1.2684380046 * l_ + 2.6097574011 * m_ - 0.3413193965 * s_),\n    b: fromLinear(-0.0041960863 * l_ - 0.7034186147 * m_ + 1.707614701 * s_),\n  };\n}\n\nfunction inGamut({ r, g, b }: Rgb): boolean {\n  const ok = (v: number) => v >= -0.5 && v <= 255.5;\n  return ok(r) && ok(g) && ok(b);\n}\n\n/**\n * OKLCH → sRGB, reducing CHROMA until the colour fits.\n *\n * Clamping the channels instead — the obvious approach — shifts hue and lightness\n * together and unpredictably: a saturated blue that overflows clips to a different blue\n * that is also lighter. Holding L and h and giving up chroma keeps the colour\n * recognisably the one that was asked for, which matters when the whole point is to\n * derive a family at a fixed lightness.\n */\nexport function oklchToRgb(target: Oklch): Rgb {\n  const direct = oklchToRgbRaw(target);\n  if (inGamut(direct)) return direct;\n\n  let lo = 0;\n  let hi = target.c;\n  // 20 halvings resolves chroma to ~4e-7, far below a perceptible step.\n  for (let i = 0; i < 20; i++) {\n    const mid = (lo + hi) / 2;\n    if (inGamut(oklchToRgbRaw({ ...target, c: mid }))) lo = mid;\n    else hi = mid;\n  }\n  return oklchToRgbRaw({ ...target, c: lo });\n}\n\nexport function hexToOklch(hex: string): Oklch | null {\n  const rgb = parseHex(hex);\n  return rgb ? rgbToOklch(rgb) : null;\n}\n\nexport function oklchToHex(lch: Oklch): string {\n  return toHex(oklchToRgb(lch));\n}\n\n/* ── WCAG contrast ────────────────────────────────────────────────────────── */\n\n/** WCAG 2.x relative luminance. */\nexport function luminance(rgb: Rgb): number {\n  return 0.2126 * toLinear(rgb.r) + 0.7152 * toLinear(rgb.g) + 0.0722 * toLinear(rgb.b);\n}\n\n/** WCAG 2.x contrast ratio, 1–21. Order-independent. */\nexport function contrast(a: Rgb | string, b: Rgb | string): number {\n  const ra = typeof a === \"string\" ? parseHex(a) : a;\n  const rb = typeof b === \"string\" ? parseHex(b) : b;\n  if (!ra || !rb) return 1;\n  const la = luminance(ra);\n  const lb = luminance(rb);\n  return (Math.max(la, lb) + 0.05) / (Math.min(la, lb) + 0.05);\n}\n\n/**\n * The lightness at hue `h`, chroma `c` that hits `target` contrast against `against`.\n *\n * Binary search rather than algebra: OKLab lightness does not map to WCAG luminance in\n * closed form, and it is not even monotonic in the general case once gamut clipping\n * starts reducing chroma. It IS monotonic over the half-range we search — away from the\n * background — which is why the direction is chosen first.\n *\n * Returns the best lightness found. If the target is unreachable at this hue and chroma\n * (a saturated yellow cannot make 7:1 against white at any lightness without going grey)\n * it returns the extreme end, and the caller should check the contrast it actually got\n * rather than assuming success — `deriveTokenSet` does exactly that.\n */\nexport function solveLightness(\n  target: number,\n  against: Rgb,\n  h: number,\n  c: number,\n  direction: \"lighter\" | \"darker\",\n): number {\n  // The half-range on the far side of the background from where we are heading.\n  // Going darker, that is [0, backgroundL]; going lighter, [backgroundL, 1]. Contrast is\n  // monotonic across each of those halves, which is what makes a binary search valid —\n  // it is NOT monotonic across the whole 0..1 range, because it turns around at the\n  // background's own lightness.\n  const bgL = rgbToOklch(against).l;\n  let lo = direction === \"darker\" ? 0 : bgL;\n  let hi = direction === \"darker\" ? bgL : 1;\n  // Measured on the HEX both colours are painted as, never on the float (round 0.34\n  // BUG-8): a solve that stopped on the float colour rounded to a hex just under the\n  // target — brand #000000's light income figure solved to 4.5000 and shipped at 4.49:1.\n  // Rounding keeps contrast monotonic in each half, so the bisection still holds, and\n  // the side it returns is the side whose hex clears the target.\n  const bg = toHex(against);\n\n  for (let i = 0; i < 24; i++) {\n    const mid = (lo + hi) / 2;\n    const got = contrast(toHex(oklchToRgb({ l: mid, c, h })), bg);\n    // Moving AWAY from the background raises contrast; which way that is depends on\n    // whether we are going lighter or darker.\n    if (got < target) {\n      if (direction === \"darker\") hi = mid;\n      else lo = mid;\n    } else if (direction === \"darker\") lo = mid;\n    else hi = mid;\n  }\n  return direction === \"darker\" ? lo : hi;\n}\n\n/* ── Colour-vision deficiency ─────────────────────────────────────────────── */\n\nexport type CvdType = \"protanopia\" | \"deuteranopia\" | \"tritanopia\";\n\n/**\n * Brettel/Viénot-style dichromat simulation in linear RGB.\n *\n * An approximation, and a well-established one. It is here so the kit can FAIL a\n * categorical ramp that two of its series become indistinguishable under, rather than\n * asserting CVD-safety in a comment the way `chart-palette.ts` did — the audit found\n * four of the nine default light chart hues below the 3:1 they were claimed to hold.\n */\nconst CVD_MATRIX: Record<CvdType, number[][]> = {\n  protanopia: [\n    [0.1705, 0.8295, 0],\n    [0.1705, 0.8295, 0],\n    [-0.0045, 0.0045, 1],\n  ],\n  deuteranopia: [\n    [0.33066, 0.66934, 0],\n    [0.33066, 0.66934, 0],\n    [-0.02785, 0.02785, 1],\n  ],\n  tritanopia: [\n    [1, 0.1273, -0.1273],\n    [0, 0.8739, 0.1261],\n    [0, 0.8739, 0.1261],\n  ],\n};\n\nexport function simulateCvd(rgb: Rgb, type: CvdType): Rgb {\n  const m = CVD_MATRIX[type];\n  const [r, g, b] = [toLinear(rgb.r), toLinear(rgb.g), toLinear(rgb.b)];\n  return {\n    r: fromLinear(m[0][0] * r + m[0][1] * g + m[0][2] * b),\n    g: fromLinear(m[1][0] * r + m[1][1] * g + m[1][2] * b),\n    b: fromLinear(m[2][0] * r + m[2][1] * g + m[2][2] * b),\n  };\n}\n\n/**\n * Perceptual distance in OKLab, which is what that space is FOR: a Euclidean distance\n * in OKLab corresponds far more closely to \"how different do these look\" than one in\n * sRGB, where the same numeric gap is obvious among greens and invisible among blues.\n */\nexport function deltaE(a: Rgb, b: Rgb): number {\n  const A = rgbToOklch(a);\n  const B = rgbToOklch(b);\n  const aA = A.c * Math.cos((A.h * Math.PI) / 180);\n  const aB = A.c * Math.sin((A.h * Math.PI) / 180);\n  const bA = B.c * Math.cos((B.h * Math.PI) / 180);\n  const bB = B.c * Math.sin((B.h * Math.PI) / 180);\n  return Math.hypot(A.l - B.l, aA - bA, aB - bB);\n}\n"],"mappings":"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","names":[]}

package/dist/theme/contrast-tokens.d.ts

@@ -1,6 +1,4 @@
-import { TokenSet } from './palette-presets.js';
-import './chart-palette.js';
-
+import type { TokenSet } from "./palette-presets.js";
 /**
  * The "More contrast" step on a token set (docs/text-size-harmonization.md §5, §10.5).
  * INTERNAL — `applyTokenSet` and the contrast layer share it; it is not re-exported.
@@ -23,8 +21,8 @@ import './chart-palette.js';
  *   `--border-strong` stays derived in tokens.css and grows with it.
  */
 /** The custom properties a contrast step writes. */
-declare const CONTRAST_STEPPED_VARS: readonly ["--text-secondary", "--text-muted", "--text-placeholder", "--border"];
-interface ContrastStep {
+export declare const CONTRAST_STEPPED_VARS: readonly ["--text-secondary", "--text-muted", "--text-placeholder", "--border"];
+export interface ContrastStep {
     textSecondary: string;
     textMuted: string;
     textPlaceholder: string;
@@ -34,7 +32,7 @@ interface ContrastStep {
  *  use, so a stepped value sits where the stylesheet would have put it. A colour that is
  *  not hex (a consumer's own token set) comes back unmixed. The deriver mixes with it
  *  too (`--bg-hover`, `--brand-muted`, `--brand-bg`, `--brand-bg-hover`). */
-declare function mix(a: string, b: string, p: number): string;
+export declare function mix(a: string, b: string, p: number): string;
 /**
  * `--bg-hover` in tokens.css: this share of `--text-primary` mixed into `--bg-surface`.
  *
@@ -47,9 +45,9 @@ declare function mix(a: string, b: string, p: number): string;
  * solves the money colours against this fill, and tokens-css-audit.test.ts measures
  * every text role on it in every shipped preset, so the two cannot part.
  */
-declare const HOVER_INK = 0.055;
+export declare const HOVER_INK = 0.055;
 /** The card's hover fill (`--bg-hover`) for `t`, as tokens.css mixes it. */
-declare function hoverFill(t: Pick<TokenSet, "textPrimary" | "bgSurface">): string;
+export declare function hoverFill(t: Pick<TokenSet, "textPrimary" | "bgSurface">): string;
 /**
  * `--brand-muted` in tokens.css: this share of `--brand` mixed into `--text-primary`.
  *
@@ -61,24 +59,22 @@ declare function hoverFill(t: Pick<TokenSet, "textPrimary" | "bgSurface">): stri
  * lighten: by the time the text cleared 4.5:1 the hover sat 1.00:1 from the chip it
  * hovers. So the text moves toward the ink, as `--bg-hover` moved for its text.
  */
-declare const BRAND_MUTED_SHARE = 0.62;
+export declare const BRAND_MUTED_SHARE = 0.62;
 /** `--brand-bg` and `--brand-bg-hover` in tokens.css: these shares of `--brand` mixed
  *  into `--bg-surface`. */
-declare const BRAND_BG_SHARE = 0.14;
-declare const BRAND_BG_HOVER_SHARE = 0.24;
+export declare const BRAND_BG_SHARE = 0.14;
+export declare const BRAND_BG_HOVER_SHARE = 0.24;
 /** `--brand-muted`, `--brand-bg` and `--brand-bg-hover` for `t`, as tokens.css mixes them.
  *  tokens-css-audit.test.ts holds the three shares equal to the stylesheet's. */
-declare function brandSoft(t: Pick<TokenSet, "brand" | "textPrimary" | "bgSurface">): {
+export declare function brandSoft(t: Pick<TokenSet, "brand" | "textPrimary" | "bgSurface">): {
     brandMuted: string;
     brandBg: string;
     brandBgHover: string;
 };
 /** The four stepped values for `t`. Pure. */
-declare function contrastStep(t: TokenSet): ContrastStep;
+export declare function contrastStep(t: TokenSet): ContrastStep;
 /** Remember the set `applyTokenSet` wrote, so a contrast change can re-apply it. */
-declare function rememberTokenSet(el: HTMLElement, t: TokenSet): void;
+export declare function rememberTokenSet(el: HTMLElement, t: TokenSet): void;
 /** The set `applyTokenSet` last wrote to `el`, or undefined when nothing did — an app
  *  without the palette layer, whose base tokens come from tokens.css. */
-declare function rememberedTokenSet(el: HTMLElement): TokenSet | undefined;
-
-export { BRAND_BG_HOVER_SHARE, BRAND_BG_SHARE, BRAND_MUTED_SHARE, CONTRAST_STEPPED_VARS, type ContrastStep, HOVER_INK, brandSoft, contrastStep, hoverFill, mix, rememberTokenSet, rememberedTokenSet };
+export declare function rememberedTokenSet(el: HTMLElement): TokenSet | undefined;