@eifi1/ui-kit 0.33.1 → 0.35.0

package/dist/testing/viewport.d.ts

@@ -0,0 +1,116 @@
+/**
+ * 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 keep their listeners, and
+ * {@link setViewportWidth} resizes the viewport under them the way a browser window
+ * does: each list whose answer flips fires `change`.
+ *
+ * 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;
+/**
+ * Resize the stubbed viewport to `width` CSS px, live — the window being dragged narrower,
+ * a phone turned (0.35, keksdose's 0.34 report). Every list the stub in force has handed
+ * out answers from the new width, and each one whose answer flipped fires `change` to its
+ * `addEventListener` listeners, its legacy `addListener` ones and its `onchange`, as in a
+ * browser; a list whose answer stayed the same tells nobody. So a mounted component that
+ * listens to a breakpoint (`usePhoneLayout()`, `useBreakpoint()`) switches without being
+ * rendered again.
+ *
+ * The stub in force is whatever `window.matchMedia` is now — one {@link stubViewportWidth}
+ * or `vi.stubGlobal("matchMedia", viewportMatchMedia(…))` put in; its features
+ * (`options`) stay as they were. Throws when `matchMedia` is not one of these stubs, rather
+ * than resize nothing. Synchronous: wrap it in `act()` when a listener sets state.
+ *
+ * ```ts
+ * undo = stubViewportWidth(1280);
+ * render(<Page />);
+ * act(() => setViewportWidth(375));
+ * expect(screen.getByRole("list")).toBeInTheDocument(); // the cards
+ * ```
+ */
+export declare function setViewportWidth(width: number): void;
+/**
+ * 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,203 @@
+"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 answer(query, width, options) {
+  return query.split(",").some(
+    (alternative) => alternative.split(/\s+and\s+/).every((part) => condition(part, width, options))
+  );
+}
+const VIEWPORTS = /* @__PURE__ */ new WeakMap();
+function mediaQueryList(query, viewport) {
+  const listeners = /* @__PURE__ */ new Set();
+  const list = {
+    matches: answer(query, viewport.width, viewport.options),
+    media: query,
+    onchange: null,
+    addEventListener(type, listener) {
+      if (type === "change" && listener) listeners.add(listener);
+    },
+    removeEventListener(type, listener) {
+      if (type === "change" && listener) listeners.delete(listener);
+    },
+    addListener(listener) {
+      if (listener) listeners.add(listener);
+    },
+    removeListener(listener) {
+      if (listener) listeners.delete(listener);
+    },
+    dispatchEvent(event) {
+      if (event.type !== "change") return true;
+      const self = list;
+      list.onchange?.call(self, event);
+      for (const listener of [...listeners]) {
+        if (typeof listener === "function") listener.call(self, event);
+        else listener.handleEvent(event);
+      }
+      return !event.defaultPrevented;
+    }
+  };
+  return list;
+}
+function changeEvent(list) {
+  const event = new Event("change");
+  for (const [key, value] of Object.entries({ matches: list.matches, media: list.media, target: list, currentTarget: list })) {
+    Object.defineProperty(event, key, { value, enumerable: true });
+  }
+  return event;
+}
+function viewportMatchMedia(width, options = {}) {
+  const viewport = { width, options, lists: /* @__PURE__ */ new Set() };
+  const matchMedia = (query) => {
+    const list = mediaQueryList(query, viewport);
+    viewport.lists.add(list);
+    return list;
+  };
+  VIEWPORTS.set(matchMedia, viewport);
+  return matchMedia;
+}
+function setViewportWidth(width) {
+  const viewport = typeof window === "undefined" ? void 0 : VIEWPORTS.get(window.matchMedia);
+  if (!viewport) {
+    throw new Error(
+      'setViewportWidth: no viewport stub is in force \u2014 put one in first with stubViewportWidth(width), or vi.stubGlobal("matchMedia", viewportMatchMedia(width)).'
+    );
+  }
+  viewport.width = width;
+  for (const list of [...viewport.lists]) {
+    const matches = answer(list.media, width, viewport.options);
+    if (matches === list.matches) continue;
+    list.matches = matches;
+    list.dispatchEvent(changeEvent(list));
+  }
+}
+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 {
+  setViewportWidth,
+  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/** A whole query: comma lists are alternatives, `and` joins conditions, as in CSS. */\nfunction answer(query: string, width: number, options: ViewportOptions): boolean {\n  return query\n    .split(\",\")\n    .some((alternative) =>\n      alternative.split(/\\s+and\\s+/).every((part) => condition(part, width, options)),\n    );\n}\n\n/** A list {@link viewportMatchMedia} handed out: what {@link setViewportWidth} flips. */\ninterface StubMediaQueryList {\n  matches: boolean;\n  readonly media: string;\n  onchange: ((this: MediaQueryList, event: MediaQueryListEvent) => unknown) | null;\n  addEventListener(type: string, listener: EventListenerOrEventListenerObject | null): void;\n  removeEventListener(type: string, listener: EventListenerOrEventListenerObject | null): void;\n  addListener(listener: EventListenerOrEventListenerObject | null): void;\n  removeListener(listener: EventListenerOrEventListenerObject | null): void;\n  dispatchEvent(event: Event): boolean;\n}\n\n/** One stub's viewport: its width now, and every list it has handed out. */\ninterface StubViewport {\n  width: number;\n  readonly options: ViewportOptions;\n  readonly lists: Set<StubMediaQueryList>;\n}\n\n/** Each `matchMedia` {@link viewportMatchMedia} made → its viewport. Keyed by the function,\n *  so {@link setViewportWidth} finds whichever stub is in force however it was put in. */\nconst VIEWPORTS = new WeakMap<object, StubViewport>();\n\nfunction mediaQueryList(query: string, viewport: StubViewport): StubMediaQueryList {\n  // One set for both APIs: in a browser `addListener(fn)` IS `addEventListener(\"change\",\n  // fn)`, so adding the same function through both registers it once.\n  const listeners = new Set<EventListenerOrEventListenerObject>();\n  const list: StubMediaQueryList = {\n    matches: answer(query, viewport.width, viewport.options),\n    media: query,\n    onchange: null,\n    addEventListener(type, listener) {\n      if (type === \"change\" && listener) listeners.add(listener);\n    },\n    removeEventListener(type, listener) {\n      if (type === \"change\" && listener) listeners.delete(listener);\n    },\n    addListener(listener) {\n      if (listener) listeners.add(listener);\n    },\n    removeListener(listener) {\n      if (listener) listeners.delete(listener);\n    },\n    dispatchEvent(event) {\n      if (event.type !== \"change\") return true;\n      const self = list as unknown as MediaQueryList;\n      list.onchange?.call(self, event as MediaQueryListEvent);\n      for (const listener of [...listeners]) {\n        if (typeof listener === \"function\") listener.call(self, event);\n        else listener.handleEvent(event);\n      }\n      return !event.defaultPrevented;\n    },\n  };\n  return list;\n}\n\n/** The `change` a browser fires at a list whose answer flipped: a `MediaQueryListEvent`'s\n *  `matches` and `media`, on an `Event` (jsdom has no `MediaQueryListEvent`). */\nfunction changeEvent(list: StubMediaQueryList): Event {\n  const event = new Event(\"change\");\n  for (const [key, value] of Object.entries({ matches: list.matches, media: list.media, target: list, currentTarget: list })) {\n    Object.defineProperty(event, key, { value, enumerable: true });\n  }\n  return event;\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 keep their listeners, and\n * {@link setViewportWidth} resizes the viewport under them the way a browser window\n * does: each list whose answer flips fires `change`.\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 viewport: StubViewport = { width, options, lists: new Set() };\n  const matchMedia = (query: string) => {\n    const list = mediaQueryList(query, viewport);\n    viewport.lists.add(list);\n    return list as unknown as MediaQueryList;\n  };\n  VIEWPORTS.set(matchMedia, viewport);\n  return matchMedia;\n}\n\n/**\n * Resize the stubbed viewport to `width` CSS px, live — the window being dragged narrower,\n * a phone turned (0.35, keksdose's 0.34 report). Every list the stub in force has handed\n * out answers from the new width, and each one whose answer flipped fires `change` to its\n * `addEventListener` listeners, its legacy `addListener` ones and its `onchange`, as in a\n * browser; a list whose answer stayed the same tells nobody. So a mounted component that\n * listens to a breakpoint (`usePhoneLayout()`, `useBreakpoint()`) switches without being\n * rendered again.\n *\n * The stub in force is whatever `window.matchMedia` is now — one {@link stubViewportWidth}\n * or `vi.stubGlobal(\"matchMedia\", viewportMatchMedia(…))` put in; its features\n * (`options`) stay as they were. Throws when `matchMedia` is not one of these stubs, rather\n * than resize nothing. Synchronous: wrap it in `act()` when a listener sets state.\n *\n * ```ts\n * undo = stubViewportWidth(1280);\n * render(<Page />);\n * act(() => setViewportWidth(375));\n * expect(screen.getByRole(\"list\")).toBeInTheDocument(); // the cards\n * ```\n */\nexport function setViewportWidth(width: number): void {\n  const viewport = typeof window === \"undefined\" ? undefined : VIEWPORTS.get(window.matchMedia);\n  if (!viewport) {\n    throw new Error(\n      \"setViewportWidth: no viewport stub is in force — put one in first with \" +\n        \"stubViewportWidth(width), or vi.stubGlobal(\\\"matchMedia\\\", viewportMatchMedia(width)).\",\n    );\n  }\n  viewport.width = width;\n  for (const list of [...viewport.lists]) {\n    const matches = answer(list.media, width, viewport.options);\n    if (matches === list.matches) continue;\n    list.matches = matches;\n    list.dispatchEvent(changeEvent(list));\n  }\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":";AAkCA,SAAS,SAAS,OAAe,MAAsB;AACrD,SAAO,SAAS,OAAO,OAAO,KAAK,IAAI,OAAO,KAAK,IAAI;AACzD;AAEA,MAAM,QAAQ;AACd,MAAM,UAAU;AAChB,MAAM,UAAU;AAGhB,SAAS,UAAU,MAAc,OAAe,SAAmC;AACjF,QAAM,IAAI,KAAK,KAAK;AACpB,MAAI,MAAM,SAAS,MAAM,SAAU,QAAO;AAC1C,QAAM,QAAQ,MAAM,KAAK,CAAC;AAC1B,MAAI,OAAO;AACT,UAAM,KAAK,SAAS,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;AACtC,YAAQ,MAAM,CAAC,GAAG;AAAA,MAChB,KAAK;AACH,eAAO,QAAQ;AAAA,MACjB,KAAK;AACH,eAAO,SAAS;AAAA,MAClB,KAAK;AACH,eAAO,QAAQ;AAAA,MACjB;AACE,eAAO,SAAS;AAAA,IACpB;AAAA,EACF;AACA,QAAM,SAAS,QAAQ,KAAK,CAAC;AAC7B,MAAI,QAAQ;AACV,UAAM,KAAK,SAAS,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AACxC,WAAO,OAAO,CAAC,MAAM,QAAQ,SAAS,KAAK,SAAS;AAAA,EACtD;AACA,QAAM,UAAU,QAAQ,KAAK,CAAC;AAC9B,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,CAAC,EAAE,MAAM,KAAK,IAAI;AACxB,QAAM,SAAS,QAAQ,QAAQ,MAAM;AACrC,UAAQ,MAAM;AAAA,IACZ,KAAK;AAAA,IACL,KAAK;AACH,aAAO,WAAW,SAAS,WAAW;AAAA,IACxC,KAAK;AAAA,IACL,KAAK;AACH,aAAO,WAAW,SAAS,SAAS;AAAA,IACtC,KAAK;AACH,aAAO,WAAW,QAAQ,gBAAgB,WAAW;AAAA,IACvD,KAAK;AACH,aAAO,WAAW,QAAQ,OAAO,SAAS;AAAA,IAC5C,KAAK;AACH,aAAO,WAAW,QAAQ,eAAe,SAAS;AAAA,IACpD;AACE,aAAO;AAAA,EACX;AACF;AAGA,SAAS,OAAO,OAAe,OAAe,SAAmC;AAC/E,SAAO,MACJ,MAAM,GAAG,EACT;AAAA,IAAK,CAAC,gBACL,YAAY,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,UAAU,MAAM,OAAO,OAAO,CAAC;AAAA,EAChF;AACJ;AAuBA,MAAM,YAAY,oBAAI,QAA8B;AAEpD,SAAS,eAAe,OAAe,UAA4C;AAGjF,QAAM,YAAY,oBAAI,IAAwC;AAC9D,QAAM,OAA2B;AAAA,IAC/B,SAAS,OAAO,OAAO,SAAS,OAAO,SAAS,OAAO;AAAA,IACvD,OAAO;AAAA,IACP,UAAU;AAAA,IACV,iBAAiB,MAAM,UAAU;AAC/B,UAAI,SAAS,YAAY,SAAU,WAAU,IAAI,QAAQ;AAAA,IAC3D;AAAA,IACA,oBAAoB,MAAM,UAAU;AAClC,UAAI,SAAS,YAAY,SAAU,WAAU,OAAO,QAAQ;AAAA,IAC9D;AAAA,IACA,YAAY,UAAU;AACpB,UAAI,SAAU,WAAU,IAAI,QAAQ;AAAA,IACtC;AAAA,IACA,eAAe,UAAU;AACvB,UAAI,SAAU,WAAU,OAAO,QAAQ;AAAA,IACzC;AAAA,IACA,cAAc,OAAO;AACnB,UAAI,MAAM,SAAS,SAAU,QAAO;AACpC,YAAM,OAAO;AACb,WAAK,UAAU,KAAK,MAAM,KAA4B;AACtD,iBAAW,YAAY,CAAC,GAAG,SAAS,GAAG;AACrC,YAAI,OAAO,aAAa,WAAY,UAAS,KAAK,MAAM,KAAK;AAAA,YACxD,UAAS,YAAY,KAAK;AAAA,MACjC;AACA,aAAO,CAAC,MAAM;AAAA,IAChB;AAAA,EACF;AACA,SAAO;AACT;AAIA,SAAS,YAAY,MAAiC;AACpD,QAAM,QAAQ,IAAI,MAAM,QAAQ;AAChC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,EAAE,SAAS,KAAK,SAAS,OAAO,KAAK,OAAO,QAAQ,MAAM,eAAe,KAAK,CAAC,GAAG;AAC1H,WAAO,eAAe,OAAO,KAAK,EAAE,OAAO,YAAY,KAAK,CAAC;AAAA,EAC/D;AACA,SAAO;AACT;AAgBO,SAAS,mBACd,OACA,UAA2B,CAAC,GACO;AACnC,QAAM,WAAyB,EAAE,OAAO,SAAS,OAAO,oBAAI,IAAI,EAAE;AAClE,QAAM,aAAa,CAAC,UAAkB;AACpC,UAAM,OAAO,eAAe,OAAO,QAAQ;AAC3C,aAAS,MAAM,IAAI,IAAI;AACvB,WAAO;AAAA,EACT;AACA,YAAU,IAAI,YAAY,QAAQ;AAClC,SAAO;AACT;AAuBO,SAAS,iBAAiB,OAAqB;AACpD,QAAM,WAAW,OAAO,WAAW,cAAc,SAAY,UAAU,IAAI,OAAO,UAAU;AAC5F,MAAI,CAAC,UAAU;AACb,UAAM,IAAI;AAAA,MACR;AAAA,IAEF;AAAA,EACF;AACA,WAAS,QAAQ;AACjB,aAAW,QAAQ,CAAC,GAAG,SAAS,KAAK,GAAG;AACtC,UAAM,UAAU,OAAO,KAAK,OAAO,OAAO,SAAS,OAAO;AAC1D,QAAI,YAAY,KAAK,QAAS;AAC9B,SAAK,UAAU;AACf,SAAK,cAAc,YAAY,IAAI,CAAC;AAAA,EACtC;AACF;AAmBO,SAAS,kBAAkB,OAAe,UAA2B,CAAC,GAAe;AAC1F,QAAM,SAAS,OAAO,yBAAyB,QAAQ,YAAY;AACnE,SAAO,eAAe,QAAQ,cAAc;AAAA,IAC1C,cAAc;AAAA,IACd,UAAU;AAAA,IACV,OAAO,mBAAmB,OAAO,OAAO;AAAA,EAC1C,CAAC;AACD,SAAO,MAAM;AACX,QAAI,OAAQ,QAAO,eAAe,QAAQ,cAAc,MAAM;AAAA,QACzD,SAAQ,eAAe,QAAQ,YAAY;AAAA,EAClD;AACF;AAkCO,SAAS,qBAAyC;AACvD,QAAM,OAAO,oBAAI,IAAwB;AAAA,EAEzC,MAAM,mBAAmB;AAAA,IAEvB,YAAqB,UAAkC;AAAlC;AACnB,WAAK,IAAI,IAAI;AAAA,IACf;AAAA,IAFqB;AAAA,IADZ,UAAU,oBAAI,IAAa;AAAA,IAIpC,QAAQ,QAAiB;AACvB,WAAK,QAAQ,IAAI,MAAM;AAAA,IACzB;AAAA,IACA,UAAU,QAAiB;AACzB,WAAK,QAAQ,OAAO,MAAM;AAAA,IAC5B;AAAA,IACA,aAAa;AACX,WAAK,QAAQ,MAAM;AACnB,WAAK,OAAO,IAAI;AAAA,IAClB;AAAA,EACF;AAEA,QAAM,SAAS,OAAO,yBAAyB,YAAY,gBAAgB;AAC3E,SAAO,eAAe,YAAY,kBAAkB;AAAA,IAClD,cAAc;AAAA,IACd,UAAU;AAAA,IACV,OAAO;AAAA,EACT,CAAC;AAED,SAAO;AAAA,IACL,OAAO,QAAQ,EAAE,OAAO,OAAO,GAAG;AAChC,YAAM,MAAM,CAAC,EAAE,YAAY,OAAO,WAAW,OAAO,CAAC;AACrD,YAAM,cAAc;AAAA,QAClB,GAAG;AAAA,QACH,GAAG;AAAA,QACH,KAAK;AAAA,QACL,MAAM;AAAA,QACN;AAAA,QACA;AAAA,QACA,OAAO;AAAA,QACP,QAAQ;AAAA,QACR,QAAQ,OAAO,EAAE,GAAG,GAAG,GAAG,GAAG,OAAO,OAAO;AAAA,MAC7C;AACA,YAAM,QAAQ;AAAA,QACZ;AAAA,QACA;AAAA,QACA,eAAe;AAAA,QACf,gBAAgB;AAAA,QAChB,2BAA2B;AAAA,MAC7B;AACA,iBAAW,YAAY,CAAC,GAAG,IAAI,GAAG;AAChC,YAAI,SAAS,QAAQ,IAAI,MAAM,GAAG;AAChC,mBAAS,SAAS,CAAC,KAAK,GAAG,QAAqC;AAAA,QAClE;AAAA,MACF;AAAA,IACF;AAAA,IACA,WAAW;AACT,YAAM,MAAiB,CAAC;AACxB,iBAAW,YAAY,KAAM,YAAW,UAAU,SAAS,QAAS,KAAI,CAAC,IAAI,SAAS,MAAM,EAAG,KAAI,KAAK,MAAM;AAC9G,aAAO;AAAA,IACT;AAAA,IACA,UAAU;AACR,WAAK,MAAM;AACX,UAAI,OAAQ,QAAO,eAAe,YAAY,kBAAkB,MAAM;AAAA,UACjE,SAAQ,eAAe,YAAY,gBAAgB;AAAA,IAC1D;AAAA,EACF;AACF;","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;