@eifi1/ui-kit 0.51.4 → 0.51.6

package/dist/testing/viewport.js.map

@@ -1 +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":"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","names":[]}
+{"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) => alternative.split(/\\s+and\\s+/).every((part) => condition(part, width, options)));\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({\n    matches: list.matches,\n    media: list.media,\n    target: list,\n    currentTarget: list,\n  })) {\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(width: number, options: ViewportOptions = {}): (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":"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","names":[]}

package/dist/theme/contrast-tokens.js

@@ -1,5 +1,15 @@
 "use client";
-import { contrast, hexToOklch, luminance, oklchToHex, oklchToRgb, parseHex, rgbToOklch, solveLightness, toHex } from "./color.js";
+import {
+  contrast,
+  hexToOklch,
+  luminance,
+  oklchToHex,
+  oklchToRgb,
+  parseHex,
+  rgbToOklch,
+  solveLightness,
+  toHex
+} from "./color.js";
 const CONTRAST_STEPPED_VARS = [
   "--text-secondary",
   "--text-muted",
@@ -82,7 +92,8 @@ function worstContrast(color, t, well) {
 function steppedBorder(t, well) {
   const surface2 = well?.bgSurface2 ?? t.bgSurface2;
   let lo = BORDER_STRONG_SHARE;
-  if (worstContrast(mix(t.border, t.textPrimary, 1 - lo), t, surface2) >= BORDER_TARGET) return mix(t.border, t.textPrimary, 1 - lo);
+  if (worstContrast(mix(t.border, t.textPrimary, 1 - lo), t, surface2) >= BORDER_TARGET)
+    return mix(t.border, t.textPrimary, 1 - lo);
   let hi = 1;
   for (let i = 0; i < 16; i++) {
     const mid = (lo + hi) / 2;

package/dist/theme/contrast-tokens.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/contrast-tokens.ts"],"sourcesContent":["import { contrast, hexToOklch, luminance, oklchToHex, oklchToRgb, parseHex, rgbToOklch, solveLightness, toHex } from \"./color\";\nimport type { TokenSet } from \"./palette-presets\";\n\n/**\n * The \"More contrast\" step on a token set (docs/text-size-harmonization.md §5, §10.5).\n * INTERNAL — `applyTokenSet` and the contrast layer share it; it is not re-exported.\n *\n * The step happens HERE, in JS, because the tokens it changes are written inline on\n * `<html>` by `applyTokenSet`: an inline value beats any `[data-contrast=more]` rule and\n * any `@media (prefers-contrast: more)` block, so a stylesheet cannot do it (§10.5, the\n * keksdose review). `--text-placeholder` is a CSS-derived token, and it is written inline\n * here too rather than redefined per attribute in tokens.css.\n *\n * What moves (§5):\n * - `--text-muted` becomes the set's `--text-secondary`;\n * - `--text-secondary` moves halfway to `--text-primary`;\n * - `--text-placeholder` becomes the set's `--text-muted` (4.6–5.5:1 on every shipped\n *   preset, where the CSS formula gives 2.4–2.8:1) — the order primary > secondary >\n *   muted > placeholder survives the step;\n * - `--border` moves toward `--text-primary` until it clears 3:1 against the worst of the\n *   three surfaces (WCAG 1.4.11, a field's boundary), and never less far than\n *   `--border-strong`'s 45 % — so every border is at least as strong as a \"strong\" one was.\n *   `--border-strong` stays derived in tokens.css and grows with it;\n * - in a LIGHT set only (0.36, docs/colour-roles-harmonization.md §13): the well\n *   (`--bg-surface-2`) becomes {@link WELL_INK_MORE} of `--text-primary` mixed into the\n *   card, and each of the four money colours that falls under 4.5:1 on that well is\n *   solved darker at its own hue and chroma. The border above is solved against the\n *   stepped well. A dark set's well stands 1.11–1.13:1 from its card already, and its\n *   money has no room: nothing of it steps.\n *\n * What does NOT move here, because it is not inline: the light status, hue and field-sync\n * literals and `--bg-active` step in tokens.css's `:root[data-contrast=\"more\"]:not(.dark)`\n * block, solved over these stepped wells.\n */\n\n/** The custom properties a contrast step writes. The last five only for a light set. */\nexport const CONTRAST_STEPPED_VARS = [\n  \"--text-secondary\",\n  \"--text-muted\",\n  \"--text-placeholder\",\n  \"--border\",\n  \"--bg-surface-2\",\n  \"--money-income\",\n  \"--money-expense\",\n  \"--money-net\",\n  \"--money-neutral\",\n] as const;\n\n/** The light well under More contrast and the money that reads on it (§13.4). */\nexport interface WellStep {\n  bgSurface2: string;\n  moneyIncome: string;\n  moneyExpense: string;\n  moneyNet: string;\n  moneyNeutral: string;\n}\n\nexport interface ContrastStep {\n  textSecondary: string;\n  textMuted: string;\n  textPlaceholder: string;\n  border: string;\n  /** The stepped well and money, or null for a dark set (which does not step them). */\n  well: WellStep | null;\n}\n\ninterface Lab {\n  l: number;\n  a: number;\n  b: number;\n}\n\nfunction toLab(hex: string): Lab | null {\n  const rgb = parseHex(hex);\n  if (!rgb) return null;\n  const { l, c, h } = rgbToOklch(rgb);\n  const rad = (h * Math.PI) / 180;\n  return { l, a: c * Math.cos(rad), b: c * Math.sin(rad) };\n}\n\n/** `color-mix(in oklab, a p, b)` as a hex — the same formula tokens.css's derived roles\n *  use, so a stepped value sits where the stylesheet would have put it. A colour that is\n *  not hex (a consumer's own token set) comes back unmixed. The deriver mixes with it\n *  too (`--bg-hover`, `--brand-muted`, `--brand-bg`, `--brand-bg-hover`). */\nexport function mix(a: string, b: string, p: number): string {\n  const A = toLab(a);\n  const B = toLab(b);\n  if (!A || !B) return a;\n  const l = A.l * p + B.l * (1 - p);\n  const x = A.a * p + B.a * (1 - p);\n  const y = A.b * p + B.b * (1 - p);\n  const c = Math.hypot(x, y);\n  const h = c < 1e-6 ? 0 : ((Math.atan2(y, x) * 180) / Math.PI + 360) % 360;\n  return toHex(oklchToRgb({ l, c, h }));\n}\n\n/**\n * `--bg-hover` in tokens.css: this share of `--text-primary` mixed into `--bg-surface`.\n *\n * 5.5 %, down from 7 % in 0.33 (docs/colour-roles-harmonization.md §12.10): a hovered row\n * on a card is the darkest fill (in dark, the lightest) that text sits on, and at 7 % the\n * light status colours, the money colours and Ink/Moss/Plum's muted text fell to\n * 4.25–4.49:1 on it. The status literals are fixed, the same in every preset, so the\n * hover moved instead: text wins over the hover's step. At 5.5 % the step from the card\n * is still 1.09–1.13:1, above the 1.08:1 the kit's hover rule asks (§12.2). The deriver\n * solves the money colours against this fill, and tokens-css-audit.test.ts measures\n * every text role on it in every shipped preset, so the two cannot part.\n */\nexport const HOVER_INK = 0.055;\n\n/** The card's hover fill (`--bg-hover`) for `t`, as tokens.css mixes it. */\nexport function hoverFill(t: Pick<TokenSet, \"textPrimary\" | \"bgSurface\">): string {\n  return mix(t.textPrimary, t.bgSurface, HOVER_INK);\n}\n\n/**\n * The light well under More contrast: this share of `--text-primary` mixed into the card,\n * `--bg-hover`'s formula at a larger share (0.36, docs/colour-roles-harmonization.md §13).\n *\n * In light the well is the page (§5.3), 1.09–1.11:1 from the card. At 10 % it stands\n * 1.19–1.24:1 from it, about twice that. The rule it is held to: **the stepped well stands\n * at least 1.17:1 from the card**, two of the hover rule's 1.08 steps; 9 % is the least\n * that clears it in every shipped preset, with no room. The step cannot ship alone: on a\n * 10 % well money, status and two hues read 4.07–4.28:1, so the money is solved with it\n * here and the status and hue literals in tokens.css.\n */\nexport const WELL_INK_MORE = 0.1;\n\n/** The least the stepped light well stands from the card (§13.3, decision 2). */\nexport const WELL_STEP_MIN = 1.17;\n\n/** True when `t` is a light set: its body ink darker than its card. */\nfunction isLightSet(t: Pick<TokenSet, \"textPrimary\" | \"bgSurface\">): boolean | null {\n  const ink = parseHex(t.textPrimary);\n  const card = parseHex(t.bgSurface);\n  if (!ink || !card) return null;\n  return luminance(ink) < luminance(card);\n}\n\n/** Money as text: WCAG 1.4.3 AA. */\nconst MONEY_TARGET = 4.5;\n\n/** `color` as it is when it clears 4.5:1 on `well`, else solved darker at its own hue and\n *  chroma until it does — measured on the hex (`solveLightness`). */\nfunction moneyOn(color: string, well: string): string {\n  if (contrast(color, well) >= MONEY_TARGET) return color;\n  const lch = hexToOklch(color);\n  const bg = parseHex(well);\n  if (!lch || !bg) return color;\n  const l = solveLightness(MONEY_TARGET, bg, lch.h, lch.c, \"darker\");\n  return oklchToHex({ l, c: lch.c, h: lch.h });\n}\n\n/** The light well under More contrast for `t`, or null for a dark set (or one whose ink or\n *  card is not hex, which cannot be mixed). The deriver solves the brand against it. */\nexport function steppedWellFill(t: Pick<TokenSet, \"textPrimary\" | \"bgSurface\">): string | null {\n  return isLightSet(t) ? mix(t.textPrimary, t.bgSurface, WELL_INK_MORE) : null;\n}\n\n/** The stepped well and money of a light set, or null (see {@link steppedWellFill}). */\nfunction wellStep(t: TokenSet): WellStep | null {\n  const well = steppedWellFill(t);\n  if (!well) return null;\n  return {\n    bgSurface2: well,\n    moneyIncome: moneyOn(t.moneyIncome, well),\n    moneyExpense: moneyOn(t.moneyExpense, well),\n    moneyNet: moneyOn(t.moneyNet, well),\n    moneyNeutral: moneyOn(t.moneyNeutral, well),\n  };\n}\n\n/**\n * `--brand-muted` in tokens.css: this share of `--brand` mixed into `--text-primary`.\n *\n * 62 %, down from 70 % in 0.33 (docs/colour-roles-harmonization.md §12.11): the brand as\n * text sits on its soft chip HOVERED too (`--brand-bg-hover` — ButtonGroupLink's current\n * page, a selected day), and at 70 % it read 4.08–4.42:1 there in Default and Moss light\n * and in Ink, Moss, Plum and Contrast dark. The brand could not move instead: the dark\n * brands would have flipped their white label to the dark ink. Nor could the chip's hover\n * lighten: by the time the text cleared 4.5:1 the hover sat 1.00:1 from the chip it\n * hovers. So the text moves toward the ink, as `--bg-hover` moved for its text.\n */\nexport const BRAND_MUTED_SHARE = 0.62;\n/** `--brand-bg` and `--brand-bg-hover` in tokens.css: these shares of `--brand` mixed\n *  into `--bg-surface`. */\nexport const BRAND_BG_SHARE = 0.14;\nexport const BRAND_BG_HOVER_SHARE = 0.24;\n\n/** `--brand-muted`, `--brand-bg` and `--brand-bg-hover` for `t`, as tokens.css mixes them.\n *  tokens-css-audit.test.ts holds the three shares equal to the stylesheet's. */\nexport function brandSoft(t: Pick<TokenSet, \"brand\" | \"textPrimary\" | \"bgSurface\">): {\n  brandMuted: string;\n  brandBg: string;\n  brandBgHover: string;\n} {\n  return {\n    brandMuted: mix(t.brand, t.textPrimary, BRAND_MUTED_SHARE),\n    brandBg: mix(t.brand, t.bgSurface, BRAND_BG_SHARE),\n    brandBgHover: mix(t.brand, t.bgSurface, BRAND_BG_HOVER_SHARE),\n  };\n}\n\n/** WCAG 1.4.11 for a component's boundary. */\nconst BORDER_TARGET = 3;\n/** `--border-strong` in tokens.css: 55 % border, 45 % text. */\nconst BORDER_STRONG_SHARE = 0.45;\n\n/** The worst of the three surfaces; `well`, when the step has one, in place of the set's. */\nfunction worstContrast(color: string, t: TokenSet, well: string): number {\n  return Math.min(contrast(color, t.bgPage), contrast(color, t.bgSurface), contrast(color, well));\n}\n\nfunction steppedBorder(t: TokenSet, well: WellStep | null): string {\n  // The share of `--text-primary` in the border: at least --border-strong's, more until\n  // 3:1. Monotonic in the share (the mix walks from the border to the text, away from\n  // every surface), so a bisection finds the least that clears it. Against the stepped\n  // light well (§13.4), which is the darkest surface under More contrast.\n  const surface2 = well?.bgSurface2 ?? t.bgSurface2;\n  let lo = BORDER_STRONG_SHARE;\n  if (worstContrast(mix(t.border, t.textPrimary, 1 - lo), t, surface2) >= BORDER_TARGET) return mix(t.border, t.textPrimary, 1 - lo);\n  let hi = 1;\n  for (let i = 0; i < 16; i++) {\n    const mid = (lo + hi) / 2;\n    if (worstContrast(mix(t.border, t.textPrimary, 1 - mid), t, surface2) >= BORDER_TARGET) hi = mid;\n    else lo = mid;\n  }\n  return mix(t.border, t.textPrimary, 1 - hi);\n}\n\n/** The stepped values for `t`: the four text and line tokens, and for a light set the\n *  well and money (`well`, null in dark). Pure. */\nexport function contrastStep(t: TokenSet): ContrastStep {\n  const well = wellStep(t);\n  return {\n    textSecondary: mix(t.textSecondary, t.textPrimary, 0.5),\n    textMuted: t.textSecondary,\n    textPlaceholder: t.textMuted,\n    border: steppedBorder(t, well),\n    well,\n  };\n}\n\n/* ── The token set last written to an element ───────────────────────────── */\n\nconst lastWritten = new WeakMap<HTMLElement, TokenSet>();\n\n/** Remember the set `applyTokenSet` wrote, so a contrast change can re-apply it. */\nexport function rememberTokenSet(el: HTMLElement, t: TokenSet): void {\n  lastWritten.set(el, t);\n}\n\n/** The set `applyTokenSet` last wrote to `el`, or undefined when nothing did — an app\n *  without the palette layer, whose base tokens come from tokens.css. */\nexport function rememberedTokenSet(el: HTMLElement): TokenSet | undefined {\n  return lastWritten.get(el);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/theme/contrast-tokens.ts"],"sourcesContent":["import {\n  contrast,\n  hexToOklch,\n  luminance,\n  oklchToHex,\n  oklchToRgb,\n  parseHex,\n  rgbToOklch,\n  solveLightness,\n  toHex,\n} from \"./color\";\nimport type { TokenSet } from \"./palette-presets\";\n\n/**\n * The \"More contrast\" step on a token set (docs/text-size-harmonization.md §5, §10.5).\n * INTERNAL — `applyTokenSet` and the contrast layer share it; it is not re-exported.\n *\n * The step happens HERE, in JS, because the tokens it changes are written inline on\n * `<html>` by `applyTokenSet`: an inline value beats any `[data-contrast=more]` rule and\n * any `@media (prefers-contrast: more)` block, so a stylesheet cannot do it (§10.5, the\n * keksdose review). `--text-placeholder` is a CSS-derived token, and it is written inline\n * here too rather than redefined per attribute in tokens.css.\n *\n * What moves (§5):\n * - `--text-muted` becomes the set's `--text-secondary`;\n * - `--text-secondary` moves halfway to `--text-primary`;\n * - `--text-placeholder` becomes the set's `--text-muted` (4.6–5.5:1 on every shipped\n *   preset, where the CSS formula gives 2.4–2.8:1) — the order primary > secondary >\n *   muted > placeholder survives the step;\n * - `--border` moves toward `--text-primary` until it clears 3:1 against the worst of the\n *   three surfaces (WCAG 1.4.11, a field's boundary), and never less far than\n *   `--border-strong`'s 45 % — so every border is at least as strong as a \"strong\" one was.\n *   `--border-strong` stays derived in tokens.css and grows with it;\n * - in a LIGHT set only (0.36, docs/colour-roles-harmonization.md §13): the well\n *   (`--bg-surface-2`) becomes {@link WELL_INK_MORE} of `--text-primary` mixed into the\n *   card, and each of the four money colours that falls under 4.5:1 on that well is\n *   solved darker at its own hue and chroma. The border above is solved against the\n *   stepped well. A dark set's well stands 1.11–1.13:1 from its card already, and its\n *   money has no room: nothing of it steps.\n *\n * What does NOT move here, because it is not inline: the light status, hue and field-sync\n * literals and `--bg-active` step in tokens.css's `:root[data-contrast=\"more\"]:not(.dark)`\n * block, solved over these stepped wells.\n */\n\n/** The custom properties a contrast step writes. The last five only for a light set. */\nexport const CONTRAST_STEPPED_VARS = [\n  \"--text-secondary\",\n  \"--text-muted\",\n  \"--text-placeholder\",\n  \"--border\",\n  \"--bg-surface-2\",\n  \"--money-income\",\n  \"--money-expense\",\n  \"--money-net\",\n  \"--money-neutral\",\n] as const;\n\n/** The light well under More contrast and the money that reads on it (§13.4). */\nexport interface WellStep {\n  bgSurface2: string;\n  moneyIncome: string;\n  moneyExpense: string;\n  moneyNet: string;\n  moneyNeutral: string;\n}\n\nexport interface ContrastStep {\n  textSecondary: string;\n  textMuted: string;\n  textPlaceholder: string;\n  border: string;\n  /** The stepped well and money, or null for a dark set (which does not step them). */\n  well: WellStep | null;\n}\n\ninterface Lab {\n  l: number;\n  a: number;\n  b: number;\n}\n\nfunction toLab(hex: string): Lab | null {\n  const rgb = parseHex(hex);\n  if (!rgb) return null;\n  const { l, c, h } = rgbToOklch(rgb);\n  const rad = (h * Math.PI) / 180;\n  return { l, a: c * Math.cos(rad), b: c * Math.sin(rad) };\n}\n\n/** `color-mix(in oklab, a p, b)` as a hex — the same formula tokens.css's derived roles\n *  use, so a stepped value sits where the stylesheet would have put it. A colour that is\n *  not hex (a consumer's own token set) comes back unmixed. The deriver mixes with it\n *  too (`--bg-hover`, `--brand-muted`, `--brand-bg`, `--brand-bg-hover`). */\nexport function mix(a: string, b: string, p: number): string {\n  const A = toLab(a);\n  const B = toLab(b);\n  if (!A || !B) return a;\n  const l = A.l * p + B.l * (1 - p);\n  const x = A.a * p + B.a * (1 - p);\n  const y = A.b * p + B.b * (1 - p);\n  const c = Math.hypot(x, y);\n  const h = c < 1e-6 ? 0 : ((Math.atan2(y, x) * 180) / Math.PI + 360) % 360;\n  return toHex(oklchToRgb({ l, c, h }));\n}\n\n/**\n * `--bg-hover` in tokens.css: this share of `--text-primary` mixed into `--bg-surface`.\n *\n * 5.5 %, down from 7 % in 0.33 (docs/colour-roles-harmonization.md §12.10): a hovered row\n * on a card is the darkest fill (in dark, the lightest) that text sits on, and at 7 % the\n * light status colours, the money colours and Ink/Moss/Plum's muted text fell to\n * 4.25–4.49:1 on it. The status literals are fixed, the same in every preset, so the\n * hover moved instead: text wins over the hover's step. At 5.5 % the step from the card\n * is still 1.09–1.13:1, above the 1.08:1 the kit's hover rule asks (§12.2). The deriver\n * solves the money colours against this fill, and tokens-css-audit.test.ts measures\n * every text role on it in every shipped preset, so the two cannot part.\n */\nexport const HOVER_INK = 0.055;\n\n/** The card's hover fill (`--bg-hover`) for `t`, as tokens.css mixes it. */\nexport function hoverFill(t: Pick<TokenSet, \"textPrimary\" | \"bgSurface\">): string {\n  return mix(t.textPrimary, t.bgSurface, HOVER_INK);\n}\n\n/**\n * The light well under More contrast: this share of `--text-primary` mixed into the card,\n * `--bg-hover`'s formula at a larger share (0.36, docs/colour-roles-harmonization.md §13).\n *\n * In light the well is the page (§5.3), 1.09–1.11:1 from the card. At 10 % it stands\n * 1.19–1.24:1 from it, about twice that. The rule it is held to: **the stepped well stands\n * at least 1.17:1 from the card**, two of the hover rule's 1.08 steps; 9 % is the least\n * that clears it in every shipped preset, with no room. The step cannot ship alone: on a\n * 10 % well money, status and two hues read 4.07–4.28:1, so the money is solved with it\n * here and the status and hue literals in tokens.css.\n */\nexport const WELL_INK_MORE = 0.1;\n\n/** The least the stepped light well stands from the card (§13.3, decision 2). */\nexport const WELL_STEP_MIN = 1.17;\n\n/** True when `t` is a light set: its body ink darker than its card. */\nfunction isLightSet(t: Pick<TokenSet, \"textPrimary\" | \"bgSurface\">): boolean | null {\n  const ink = parseHex(t.textPrimary);\n  const card = parseHex(t.bgSurface);\n  if (!ink || !card) return null;\n  return luminance(ink) < luminance(card);\n}\n\n/** Money as text: WCAG 1.4.3 AA. */\nconst MONEY_TARGET = 4.5;\n\n/** `color` as it is when it clears 4.5:1 on `well`, else solved darker at its own hue and\n *  chroma until it does — measured on the hex (`solveLightness`). */\nfunction moneyOn(color: string, well: string): string {\n  if (contrast(color, well) >= MONEY_TARGET) return color;\n  const lch = hexToOklch(color);\n  const bg = parseHex(well);\n  if (!lch || !bg) return color;\n  const l = solveLightness(MONEY_TARGET, bg, lch.h, lch.c, \"darker\");\n  return oklchToHex({ l, c: lch.c, h: lch.h });\n}\n\n/** The light well under More contrast for `t`, or null for a dark set (or one whose ink or\n *  card is not hex, which cannot be mixed). The deriver solves the brand against it. */\nexport function steppedWellFill(t: Pick<TokenSet, \"textPrimary\" | \"bgSurface\">): string | null {\n  return isLightSet(t) ? mix(t.textPrimary, t.bgSurface, WELL_INK_MORE) : null;\n}\n\n/** The stepped well and money of a light set, or null (see {@link steppedWellFill}). */\nfunction wellStep(t: TokenSet): WellStep | null {\n  const well = steppedWellFill(t);\n  if (!well) return null;\n  return {\n    bgSurface2: well,\n    moneyIncome: moneyOn(t.moneyIncome, well),\n    moneyExpense: moneyOn(t.moneyExpense, well),\n    moneyNet: moneyOn(t.moneyNet, well),\n    moneyNeutral: moneyOn(t.moneyNeutral, well),\n  };\n}\n\n/**\n * `--brand-muted` in tokens.css: this share of `--brand` mixed into `--text-primary`.\n *\n * 62 %, down from 70 % in 0.33 (docs/colour-roles-harmonization.md §12.11): the brand as\n * text sits on its soft chip HOVERED too (`--brand-bg-hover` — ButtonGroupLink's current\n * page, a selected day), and at 70 % it read 4.08–4.42:1 there in Default and Moss light\n * and in Ink, Moss, Plum and Contrast dark. The brand could not move instead: the dark\n * brands would have flipped their white label to the dark ink. Nor could the chip's hover\n * lighten: by the time the text cleared 4.5:1 the hover sat 1.00:1 from the chip it\n * hovers. So the text moves toward the ink, as `--bg-hover` moved for its text.\n */\nexport const BRAND_MUTED_SHARE = 0.62;\n/** `--brand-bg` and `--brand-bg-hover` in tokens.css: these shares of `--brand` mixed\n *  into `--bg-surface`. */\nexport const BRAND_BG_SHARE = 0.14;\nexport const BRAND_BG_HOVER_SHARE = 0.24;\n\n/** `--brand-muted`, `--brand-bg` and `--brand-bg-hover` for `t`, as tokens.css mixes them.\n *  tokens-css-audit.test.ts holds the three shares equal to the stylesheet's. */\nexport function brandSoft(t: Pick<TokenSet, \"brand\" | \"textPrimary\" | \"bgSurface\">): {\n  brandMuted: string;\n  brandBg: string;\n  brandBgHover: string;\n} {\n  return {\n    brandMuted: mix(t.brand, t.textPrimary, BRAND_MUTED_SHARE),\n    brandBg: mix(t.brand, t.bgSurface, BRAND_BG_SHARE),\n    brandBgHover: mix(t.brand, t.bgSurface, BRAND_BG_HOVER_SHARE),\n  };\n}\n\n/** WCAG 1.4.11 for a component's boundary. */\nconst BORDER_TARGET = 3;\n/** `--border-strong` in tokens.css: 55 % border, 45 % text. */\nconst BORDER_STRONG_SHARE = 0.45;\n\n/** The worst of the three surfaces; `well`, when the step has one, in place of the set's. */\nfunction worstContrast(color: string, t: TokenSet, well: string): number {\n  return Math.min(contrast(color, t.bgPage), contrast(color, t.bgSurface), contrast(color, well));\n}\n\nfunction steppedBorder(t: TokenSet, well: WellStep | null): string {\n  // The share of `--text-primary` in the border: at least --border-strong's, more until\n  // 3:1. Monotonic in the share (the mix walks from the border to the text, away from\n  // every surface), so a bisection finds the least that clears it. Against the stepped\n  // light well (§13.4), which is the darkest surface under More contrast.\n  const surface2 = well?.bgSurface2 ?? t.bgSurface2;\n  let lo = BORDER_STRONG_SHARE;\n  if (worstContrast(mix(t.border, t.textPrimary, 1 - lo), t, surface2) >= BORDER_TARGET)\n    return mix(t.border, t.textPrimary, 1 - lo);\n  let hi = 1;\n  for (let i = 0; i < 16; i++) {\n    const mid = (lo + hi) / 2;\n    if (worstContrast(mix(t.border, t.textPrimary, 1 - mid), t, surface2) >= BORDER_TARGET) hi = mid;\n    else lo = mid;\n  }\n  return mix(t.border, t.textPrimary, 1 - hi);\n}\n\n/** The stepped values for `t`: the four text and line tokens, and for a light set the\n *  well and money (`well`, null in dark). Pure. */\nexport function contrastStep(t: TokenSet): ContrastStep {\n  const well = wellStep(t);\n  return {\n    textSecondary: mix(t.textSecondary, t.textPrimary, 0.5),\n    textMuted: t.textSecondary,\n    textPlaceholder: t.textMuted,\n    border: steppedBorder(t, well),\n    well,\n  };\n}\n\n/* ── The token set last written to an element ───────────────────────────── */\n\nconst lastWritten = new WeakMap<HTMLElement, TokenSet>();\n\n/** Remember the set `applyTokenSet` wrote, so a contrast change can re-apply it. */\nexport function rememberTokenSet(el: HTMLElement, t: TokenSet): void {\n  lastWritten.set(el, t);\n}\n\n/** The set `applyTokenSet` last wrote to `el`, or undefined when nothing did — an app\n *  without the palette layer, whose base tokens come from tokens.css. */\nexport function rememberedTokenSet(el: HTMLElement): TokenSet | undefined {\n  return lastWritten.get(el);\n}\n"],"mappings":"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","names":[]}

package/dist/theme/contrast.d.ts

@@ -90,7 +90,7 @@ export declare function createContrastStore(storageKey: string): {
         setState(state: ContrastState | ((state: ContrastState) => ContrastState), replace: true): unknown;
         persist: {
             setOptions: (options: Partial<import("zustand/middleware").PersistOptions<ContrastState, {
-                contrast: "system" | "standard" | "more" | null;
+                contrast: "more" | "system" | "standard" | null;
             }, unknown>>) => void;
             clearStorage: () => void;
             rehydrate: () => Promise<void> | void;
@@ -98,7 +98,7 @@ export declare function createContrastStore(storageKey: string): {
             onHydrate: (fn: (state: ContrastState) => void) => () => void;
             onFinishHydration: (fn: (state: ContrastState) => void) => () => void;
             getOptions: () => Partial<import("zustand/middleware").PersistOptions<ContrastState, {
-                contrast: "system" | "standard" | "more" | null;
+                contrast: "more" | "system" | "standard" | null;
             }, unknown>>;
         };
     }>;

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

@@ -92,7 +92,7 @@ export interface DerivedPalette {
     /** Compromises the deriver had to make, in plain words. Never silent. */
     warnings: string[];
 }
-export declare function derivePalette({ anchors, mode, surfaceTint, textContrast, }: DeriveOptions): DerivedPalette;
+export declare function derivePalette({ anchors, mode, surfaceTint, textContrast }: DeriveOptions): DerivedPalette;
 /**
  * Measure every pair that has a requirement, and say which ones fail.
  *

package/dist/theme/palette-derive.js

@@ -92,12 +92,7 @@ function tintOn(hue, chroma, surface, mode) {
   const l = mode === "light" ? s.l - 0.055 : s.l + 0.055;
   return oklchToHex({ l, c: Math.min(chroma * 0.45, 0.06), h: hue });
 }
-function derivePalette({
-  anchors,
-  mode,
-  surfaceTint = 0.55,
-  textContrast
-}) {
+function derivePalette({ anchors, mode, surfaceTint = 0.55, textContrast }) {
   const warnings = [];
   const brand = hexToOklch(anchors.brand);
   if (!brand) {
@@ -194,20 +189,8 @@ function derivePalette({
     const hue = semanticHue[role];
     const chroma = semanticChroma[role];
     const bg = tintOn(hue, chroma, surfaces.bgSurface, mode);
-    const onSurface = solveLightness(
-      4.5,
-      parseHex(worstText),
-      hue,
-      chroma,
-      mode === "light" ? "darker" : "lighter"
-    );
-    const onTint = solveLightness(
-      4.5,
-      parseHex(bg),
-      hue,
-      chroma,
-      mode === "light" ? "darker" : "lighter"
-    );
+    const onSurface = solveLightness(4.5, parseHex(worstText), hue, chroma, mode === "light" ? "darker" : "lighter");
+    const onTint = solveLightness(4.5, parseHex(bg), hue, chroma, mode === "light" ? "darker" : "lighter");
     const l = mode === "light" ? Math.min(onSurface, onTint) : Math.max(onSurface, onTint);
     return oklchToHex({ l, c: chroma, h: hue });
   };
@@ -266,7 +249,13 @@ function derivePalette({
   const moneyExpense = money(70, 4.5);
   const moneyNet = money(300, 4.5);
   const neutralChroma = 0.012 * weight;
-  const neutralFloor = solveLightness(4.5, parseHex(worstText), brand.h, neutralChroma, mode === "light" ? "darker" : "lighter");
+  const neutralFloor = solveLightness(
+    4.5,
+    parseHex(worstText),
+    brand.h,
+    neutralChroma,
+    mode === "light" ? "darker" : "lighter"
+  );
   const moneyNeutral = oklchToHex({
     l: mode === "light" ? Math.min(0.52, neutralFloor) : Math.max(0.72, neutralFloor),
     c: neutralChroma,
@@ -350,7 +339,13 @@ function auditPalette(set, semantic, options = {}) {
     else add(`border on ${name}`, t.border, bg, 1.1, "house rule: a hairline must be findable");
   }
   if (step?.well) {
-    add("bgSurface2 on bgSurface", t.bgSurface2, t.bgSurface, WELL_STEP_MIN, "house rule: the well stands two hover steps from the card");
+    add(
+      "bgSurface2 on bgSurface",
+      t.bgSurface2,
+      t.bgSurface,
+      WELL_STEP_MIN,
+      "house rule: the well stands two hover steps from the card"
+    );
   }
   for (const [name, bg] of textGrounds) {
     add(`textPrimary on ${name}`, t.textPrimary, bg, 7, "WCAG 1.4.6 AAA body text");
@@ -387,13 +382,7 @@ function auditPalette(set, semantic, options = {}) {
     add("warning on warningBg", semantic.warning, semantic.warningBg, 4.5, "WCAG 1.4.3 \u2014 badge text");
     add("info on infoBg", semantic.info, semantic.infoBg, 4.5, "WCAG 1.4.3 \u2014 badge text");
     add("success on successBg", semantic.success, semantic.successBg, 4.5, "WCAG 1.4.3 \u2014 badge text");
-    add(
-      "dangerContrast on danger",
-      semantic.dangerContrast,
-      semantic.danger,
-      4.5,
-      "WCAG 1.4.3 AA body text"
-    );
+    add("dangerContrast on danger", semantic.dangerContrast, semantic.danger, 4.5, "WCAG 1.4.3 AA body text");
   }
   const failures = checks.filter((c) => !c.passes);
   return { checks, failures, passes: failures.length === 0 };

package/dist/theme/palette-derive.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/palette-derive.ts"],"sourcesContent":["import type { ThemeMode } from \"./theme-store\";\nimport type { TokenSet } from \"./palette-presets\";\nimport type { HeatStops } from \"./chart-palette\";\nimport {\n  contrast,\n  deltaE,\n  toHex,\n  hexToOklch,\n  oklchToHex,\n  parseHex,\n  rgbToOklch,\n  simulateCvd,\n  solveLightness,\n} from \"./color\";\nimport type { CvdType, Oklch } from \"./color\";\nimport type { ContrastLevel } from \"./contrast\";\nimport { brandSoft, contrastStep, hoverFill, steppedWellFill, WELL_STEP_MIN } from \"./contrast-tokens\";\n\n/**\n * Build a whole palette from one brand colour, plus any number of colours pinned by\n * hand, with every contrast ratio SOLVED rather than chosen and then hoped for.\n *\n * The presets this package shipped were assembled by eye and annotated with the ratios\n * they were believed to hold — `tokens.css` records \"7.0:1 and 4.8:1\", and\n * `palette-presets.ts` records \"2.67:1 … lifted they clear it at 3.30:1\". Nothing\n * computed any of them, and the audit found four of the nine default light chart hues\n * below the 3:1 that WCAG 1.4.11 requires of a graphical object. A comment is not a\n * test. Everything here is derived to a target and then measured, and\n * {@link auditPalette} returns the measurements so a caller can refuse a palette that\n * does not hold up.\n *\n * WHAT IS DERIVED AND WHAT IS NOT. The UI palette and the CATEGORICAL CHART RAMP solve\n * different problems and are deliberately kept apart. A UI colour needs contrast against\n * one known surface and carries a fixed meaning; a chart colour needs to stay separable\n * from eight unknown siblings, at roughly equal salience, with no implied order.\n * Optimising a set for one makes it worse at the other, which is why `deriveTokenSet`\n * leaves `chart` alone unless you explicitly ask for {@link deriveChartRamp}.\n */\n\n/* ── Inputs ───────────────────────────────────────────────────────────────── */\n\n/** A role whose hue may be pinned by the caller instead of chosen by the deriver. */\nexport type AnchorRole = \"brand\" | \"accent\" | \"danger\" | \"warning\" | \"success\" | \"info\";\n\nexport type PaletteAnchors = { brand: string } & Partial<Record<Exclude<AnchorRole, \"brand\">, string>>;\n\nexport interface DeriveOptions {\n  anchors: PaletteAnchors;\n  mode: ThemeMode;\n  /**\n   * How strongly the surfaces carry the brand's hue, 0–1 of the maximum useful tint.\n   * 0 gives neutral greys; the shipped default is a visible warmth, because a page that\n   * is very slightly the brand's hue reads as considered where a pure grey reads as\n   * unstyled. Above ~0.5 the surfaces start competing with the content.\n   */\n  surfaceTint?: number;\n  /** Contrast targets for the three text roles against the WORST surface. */\n  textContrast?: { primary?: number; secondary?: number; muted?: number };\n}\n\n/* ── Outputs ──────────────────────────────────────────────────────────────── */\n\n/** The semantic layer, which lives in tokens.css rather than in `TokenSet`. */\nexport interface SemanticTokens {\n  danger: string;\n  dangerHover: string;\n  dangerContrast: string;\n  dangerBorder: string;\n  /** The error line (invalid field, danger banner, destructive focus ring): as loud as\n   *  `dangerBorder` was before 0.15.5, so it keeps 3:1 against the surface. */\n  dangerBorderStrong: string;\n  dangerBg: string;\n  warning: string;\n  warningBorder: string;\n  warningBg: string;\n  info: string;\n  infoBorder: string;\n  infoBg: string;\n  success: string;\n  successBorder: string;\n  successBg: string;\n  /** Present only when a `accent` (secondary brand) anchor was supplied. */\n  accent?: string;\n  accentContrast?: string;\n  accentBg?: string;\n}\n\nexport interface ContrastCheck {\n  /** e.g. \"textMuted on bgPage\". */\n  pair: string;\n  ratio: number;\n  /** What WCAG asks of this pair. */\n  required: number;\n  /** Which rule the requirement comes from, for a reader who wants to argue with it. */\n  rule: string;\n  passes: boolean;\n}\n\nexport interface ContrastReport {\n  checks: ContrastCheck[];\n  failures: ContrastCheck[];\n  passes: boolean;\n}\n\nexport interface DerivedPalette {\n  tokens: TokenSet;\n  semantic: SemanticTokens;\n  /** {@link auditPalette} at both contrast levels: the More-contrast checks carry a\n   *  \" (More contrast)\" suffix (0.36). */\n  audit: ContrastReport;\n  /** Compromises the deriver had to make, in plain words. Never silent. */\n  warnings: string[];\n}\n\n/* ── The hue homes ────────────────────────────────────────────────────────── */\n\n/**\n * Where each semantic role wants to sit, and how far it may be pushed.\n *\n * A semantic colour is a convention before it is an aesthetic: danger is red because\n * every other interface the user has ever used made it red, and a \"danger\" button in\n * the brand's teal is a worse button however well it matches. So each role has a home\n * hue and a narrow licence to move — enough to get out of the brand's way when the\n * brand happens to live in the same neighbourhood, not enough to stop meaning what it\n * means. If it cannot get far enough, that is a warning, not a silent compromise.\n */\nconst HUE_HOME: Record<Exclude<AnchorRole, \"brand\" | \"accent\">, { hue: number; slack: number }> = {\n  danger: { hue: 27, slack: 14 },\n  warning: { hue: 75, slack: 16 },\n  success: { hue: 150, slack: 20 },\n  info: { hue: 240, slack: 22 },\n};\n\n/** Circular distance between two hue angles, 0–180. */\nfunction hueGap(a: number, b: number): number {\n  const d = Math.abs(((a - b) % 360) + 360) % 360;\n  return d > 180 ? 360 - d : d;\n}\n\n/**\n * Nudge `home` within `slack` to maximise the distance from every taken hue.\n *\n * Sampled rather than solved: the objective is a min-of-distances over a handful of\n * points on a short arc, which is piecewise-linear with kinks wherever the nearest\n * neighbour changes. Gradient methods stall on those kinks; 2° steps over a ±22° arc is\n * 23 evaluations of some trigonometry and cannot stall.\n */\nfunction placeHue(home: number, slack: number, taken: number[]): number {\n  let best = home;\n  let bestGap = Math.min(...taken.map((t) => hueGap(home, t)), 360);\n  for (let d = -slack; d <= slack; d += 2) {\n    const h = (home + d + 360) % 360;\n    const gap = Math.min(...taken.map((t) => hueGap(h, t)), 360);\n    // Ties go to the hue nearest home: a role should move only as far as it must.\n    if (gap > bestGap + 1e-9) {\n      best = h;\n      bestGap = gap;\n    }\n  }\n  return best;\n}\n\n/* ── Derivation ───────────────────────────────────────────────────────────── */\n\nconst SURFACE_L = {\n  // Light: the PAGE is slightly darker than the cards on it, so a card reads as raised\n  // without needing a shadow to say so. Matches the shipped presets' relationship.\n  //\n  // The light WELL is the page itself (0.33, docs/colour-roles-harmonization.md §5.3,\n  // k26). Between the card and the page it sat 1.02–1.05:1 from the card it is inset\n  // in, which is no well at all; at the page's lightness it stands out from the card\n  // exactly as far as the card does from the page, and nothing re-solves, because the\n  // page is already the surface every text role is solved against. Dark keeps its\n  // well a step lighter than the card (1.11–1.13:1).\n  light: { page: 0.912, surface: 0.945, surface2: 0.912 },\n  dark: { page: 0.158, surface: 0.206, surface2: 0.249 },\n} as const;\n\n/**\n * What a hairline has to clear against the surface it divides.\n *\n * WCAG has nothing to say here — a decorative border is not a graphical object that\n * conveys information — so this is a house rule, and it is deliberately low. A border\n * that clears 3:1 is a RULE, not a hairline: it draws the eye to the box instead of to\n * what is in it. 1.5:1 is the point at which the edge is reliably findable without\n * becoming part of the composition.\n */\nconst BORDER_CONTRAST = 1.5;\n\n/** The most tint a surface can carry before it stops reading as a neutral ground. */\nconst MAX_SURFACE_CHROMA = 0.034;\n\n/**\n * The brand chroma from which the surfaces and the greys carry the brand's hue in full;\n * below it they carry it in proportion, down to none for a grey (round 0.34 BUG-8). A\n * grey has no hue — OKLCH reports 0, which is pink — and at full tint #808080 painted\n * every surface #eddde1.\n */\nconst FULL_HUE_CHROMA = 0.06;\n\n/** How much of the brand's hue the neutrals may carry: 0 for a grey, 1 from {@link FULL_HUE_CHROMA}. */\nfunction hueWeight(brand: Oklch): number {\n  return Math.min(1, brand.c / FULL_HUE_CHROMA);\n}\n\nfunction surfaceSet(hue: number, mode: ThemeMode, tint: number, weight: number) {\n  const c = MAX_SURFACE_CHROMA * Math.max(0, Math.min(1, tint)) * weight;\n  const L = SURFACE_L[mode];\n  const bgPage = oklchToHex({ l: L.page, c, h: hue });\n  const bgSurface = oklchToHex({ l: L.surface, c, h: hue });\n  const bgSurface2 = oklchToHex({ l: L.surface2, c, h: hue });\n  // Solved, not guessed: a fixed lightness that looks right against a pale warm ground\n  // disappears against a deep cold one, and both are reachable from the same `hue`\n  // input. The border carries a little more chroma than the surfaces because at these\n  // lightnesses a perfectly neutral hairline on a tinted ground reads as a wrong grey.\n  const borderChroma = c * 1.6;\n  // Solved against the surface the hairline is HARDEST to see on, not against one of\n  // the three. Solving against `bgSurface` alone left it at 1.36:1 on `bgPage`, so the\n  // target and the audit disagreed about the same border.\n  const hardest = [bgPage, bgSurface, bgSurface2].reduce((a, b) =>\n    contrast(a, mode === \"light\" ? \"#000000\" : \"#ffffff\") <\n    contrast(b, mode === \"light\" ? \"#000000\" : \"#ffffff\")\n      ? a\n      : b,\n  );\n  const borderL = solveLightness(\n    BORDER_CONTRAST,\n    parseHex(hardest)!,\n    hue,\n    borderChroma,\n    mode === \"light\" ? \"darker\" : \"lighter\",\n  );\n  return {\n    bgPage,\n    bgSurface,\n    bgSurface2,\n    border: oklchToHex({ l: borderL, c: borderChroma, h: hue }),\n  };\n}\n\n/** Solve a colour at this hue that clears `target` against `against`, keeping chroma. */\nfunction solveAgainst(hue: number, chroma: number, target: number, against: string, mode: ThemeMode): string {\n  const bg = parseHex(against)!;\n  const l = solveLightness(target, bg, hue, chroma, mode === \"light\" ? \"darker\" : \"lighter\");\n  return oklchToHex({ l, c: chroma, h: hue });\n}\n\n/** Whichever of near-white / near-black reads better ON `fill`. */\nfunction contrastOn(fill: string): string {\n  const light = \"#ffffff\";\n  const dark = \"#12100e\";\n  return contrast(fill, light) >= contrast(fill, dark) ? light : dark;\n}\n\n/** A soft tint of `hue` sitting on the surface — a badge fill, not a button fill. */\nfunction tintOn(hue: number, chroma: number, surface: string, mode: ThemeMode): string {\n  const s = hexToOklch(surface)!;\n  // Toward the colour, but only far enough to be seen: these back TEXT of the same hue,\n  // and a strong tint leaves the text nowhere to go.\n  const l = mode === \"light\" ? s.l - 0.055 : s.l + 0.055;\n  return oklchToHex({ l, c: Math.min(chroma * 0.45, 0.06), h: hue });\n}\n\nexport function derivePalette({\n  anchors,\n  mode,\n  surfaceTint = 0.55,\n  textContrast,\n}: DeriveOptions): DerivedPalette {\n  const warnings: string[] = [];\n  const brand = hexToOklch(anchors.brand);\n  if (!brand) {\n    throw new Error(\n      `derivePalette: brand \"${anchors.brand}\" is not a #rgb or #rrggbb colour. ` +\n        `Anchors must be hex — a named colour or an rgba() string cannot be converted.`,\n    );\n  }\n\n  const targets = { primary: 10, secondary: 7, muted: 4.6, ...textContrast };\n\n  // ── Surfaces, from the brand's hue.\n  const weight = hueWeight(brand);\n  const surfaces = surfaceSet(brand.h, mode, surfaceTint, weight);\n  // Every text role is solved against the WORST of the three, so a token is legible\n  // wherever it lands. Solving against `bgSurface` alone is the mistake that makes a\n  // muted label fail on the page background it also sits on.\n  const worstSurface = [surfaces.bgPage, surfaces.bgSurface, surfaces.bgSurface2].reduce((a, b) =>\n    contrast(a, mode === \"light\" ? \"#000000\" : \"#ffffff\") <\n    contrast(b, mode === \"light\" ? \"#000000\" : \"#ffffff\")\n      ? a\n      : b,\n  );\n\n  // ── Text. A trace of the brand hue keeps the greys from reading cold on a warm page.\n  const textChroma = 0.014 * weight;\n  const textPrimary = solveAgainst(brand.h, textChroma, targets.primary, worstSurface, mode);\n  const textSecondary = solveAgainst(brand.h, textChroma, targets.secondary, worstSurface, mode);\n  const textMuted = solveAgainst(brand.h, textChroma, targets.muted, worstSurface, mode);\n\n  // The darkest fill text sits on (the lightest, in dark): the worst surface, or a\n  // hovered row on the card (`--bg-hover`), which in light is a shade darker than the\n  // page. The colours that are solved exactly to 4.5:1 — money, the semantic text — are\n  // solved against this, so they hold on a hovered row too (0.33, §12.10). The text\n  // roles above keep their margin (4.6:1 and up) and need no second solve.\n  const hover = hoverFill({ textPrimary, bgSurface: surfaces.bgSurface });\n  const worstText = [worstSurface, hover].reduce((a, b) =>\n    contrast(a, mode === \"light\" ? \"#000000\" : \"#ffffff\") <\n    contrast(b, mode === \"light\" ? \"#000000\" : \"#ffffff\")\n      ? a\n      : b,\n  );\n\n  // ── Brand. Keep the hue the caller asked for; move only the lightness, and only as\n  // far as 3:1 against the worst surface — WCAG 1.4.11, since a brand-filled control is\n  // a graphical object whose boundary has to be perceivable.\n  //\n  // In light the worst surface includes More contrast's well (0.36, colour-roles §13.4):\n  // 10 % ink into the card, darker than the page. The step is applied, not derived, but\n  // the brand is not stepped, so both brand solves measure there too and a derived\n  // palette holds at both levels.\n  const moreWell = steppedWellFill({ textPrimary, bgSurface: surfaces.bgSurface });\n  const brandGround = moreWell\n    ? [worstSurface, moreWell].reduce((a, b) => (contrast(a, \"#000000\") < contrast(b, \"#000000\") ? a : b))\n    : worstSurface;\n  const brandChroma = Math.max(brand.c, 0.06);\n  const brandRatio = contrast(anchors.brand, brandGround);\n  // NORMALISED, never the caller's raw string. `parseHex` accepts \"4f46e5\" and \"#abc\",\n  // and passing either through unchanged put a value in the TokenSet that is not a CSS\n  // colour — it then fails silently at paint time, three layers from here.\n  let brandHex =\n    brandRatio >= 3\n      ? toHex(parseHex(anchors.brand)!)\n      : solveAgainst(brand.h, brandChroma, 3, brandGround, mode);\n  if (brandRatio < 3) {\n    warnings.push(\n      `brand ${anchors.brand} sits at ${brandRatio.toFixed(2)}:1 against the ${mode} surfaces, ` +\n        `below the 3:1 WCAG 1.4.11 asks of a control boundary. Lightness was adjusted to ` +\n        `${brandHex}; hue and chroma are unchanged.`,\n    );\n  }\n  // `--brand-muted` is the brand AS TEXT — a soft brand chip's label, an outline chip, a\n  // current link — and tokens.css derives it: 62 % brand into the ink. A brand solved\n  // to 3:1 left it at 4.43–4.51:1 in three dark presets (0.33, §5.5), so it gets the\n  // text floor here: the brand moves away from the surfaces, a step at a time, until its\n  // muted form clears 4.5:1 on the worst fill and on its own soft chip, at rest\n  // (`--brand-bg`) and hovered (`--brand-bg-hover`, the harder of the two: §12.11).\n  const brandMutedWorst = (hex: string) => {\n    const soft = brandSoft({ brand: hex, textPrimary, bgSurface: surfaces.bgSurface });\n    return Math.min(\n      contrast(soft.brandMuted, worstText),\n      contrast(soft.brandMuted, soft.brandBg),\n      contrast(soft.brandMuted, soft.brandBgHover),\n      // …and on More contrast's light well, where a link button reads it (§13.3).\n      moreWell ? contrast(soft.brandMuted, moreWell) : Infinity,\n    );\n  };\n  for (let i = 0; i < 40 && brandMutedWorst(brandHex) < 4.5; i++) {\n    const lch = hexToOklch(brandHex)!;\n    brandHex = oklchToHex({ ...lch, l: mode === \"light\" ? lch.l - 0.005 : lch.l + 0.005 });\n  }\n  if (brandMutedWorst(brandHex) < 4.5) {\n    warnings.push(\n      `the brand as text (--brand-muted) reaches only ${brandMutedWorst(brandHex).toFixed(2)}:1 ` +\n        `against the ${mode} surfaces (needs 4.5:1).`,\n    );\n  }\n  const brandLch = hexToOklch(brandHex)!;\n  const brandContrast = contrastOn(brandHex);\n  const brandHover = oklchToHex({\n    ...brandLch,\n    // Hover moves AWAY from the colour of the text on it (0.33, §5.5): darker under\n    // white, lighter under a dark ink. It used to move away from the page, which in dark\n    // lightened a fill that carries WHITE text, toward its own label: 4.07:1.\n    l: brandContrast === \"#ffffff\" ? brandLch.l - 0.06 : brandLch.l + 0.06,\n  });\n  const onBrand = contrast(brandHex, brandContrast);\n  if (onBrand < 4.5) {\n    warnings.push(\n      `text on the brand fill reaches only ${onBrand.toFixed(2)}:1 (needs 4.5:1). ` +\n        `A mid-lightness, high-chroma brand cannot carry legible text at any ink; ` +\n        `use it as an accent and keep primary buttons on a darker or lighter variant.`,\n    );\n  }\n\n  // ── Semantic roles. Anchors are honoured exactly; the rest are placed away from the\n  // brand and from each other, within each role's licence to move.\n  const taken: number[] = [brandLch.h];\n  const accentLch = anchors.accent ? hexToOklch(anchors.accent) : null;\n  if (anchors.accent && !accentLch) {\n    warnings.push(`accent \"${anchors.accent}\" is not a hex colour and was ignored.`);\n  }\n  if (accentLch) taken.push(accentLch.h);\n\n  const semanticHue = {} as Record<Exclude<AnchorRole, \"brand\" | \"accent\">, number>;\n  const semanticChroma = {} as Record<Exclude<AnchorRole, \"brand\" | \"accent\">, number>;\n  for (const role of [\"danger\", \"warning\", \"success\", \"info\"] as const) {\n    const pinned = anchors[role] ? hexToOklch(anchors[role]!) : null;\n    if (anchors[role] && !pinned) {\n      warnings.push(`${role} \"${anchors[role]}\" is not a hex colour and was ignored.`);\n    }\n    const home = HUE_HOME[role];\n    const hue = pinned ? pinned.h : placeHue(home.hue, home.slack, taken);\n    if (!pinned) {\n      const gap = Math.min(...taken.map((t) => hueGap(hue, t)));\n      if (gap < 20) {\n        warnings.push(\n          `${role} could only reach ${gap.toFixed(0)}° from the nearest pinned hue, which is ` +\n            `too close to tell apart at a glance. Pin ${role} explicitly, or move the brand.`,\n        );\n      }\n    }\n    semanticHue[role] = hue;\n    semanticChroma[role] = pinned ? Math.max(pinned.c, 0.08) : 0.13;\n    taken.push(hue);\n  }\n\n  /**\n   * A semantic colour has two jobs and therefore two backgrounds: plain text on the\n   * page, and the label inside its own tinted badge. The badge is the harder of the\n   * two — it is a step toward the colour — so solving only against the surface produced\n   * a badge at 4.1:1 while the loose text passed, which is the failure mode that is\n   * hardest to notice because nine tenths of the uses look fine.\n   */\n  const sem = (role: Exclude<AnchorRole, \"brand\" | \"accent\">) => {\n    const hue = semanticHue[role];\n    const chroma = semanticChroma[role];\n    const bg = tintOn(hue, chroma, surfaces.bgSurface, mode);\n    const onSurface = solveLightness(\n      4.5,\n      parseHex(worstText)!,\n      hue,\n      chroma,\n      mode === \"light\" ? \"darker\" : \"lighter\",\n    );\n    const onTint = solveLightness(\n      4.5,\n      parseHex(bg)!,\n      hue,\n      chroma,\n      mode === \"light\" ? \"darker\" : \"lighter\",\n    );\n    const l = mode === \"light\" ? Math.min(onSurface, onTint) : Math.max(onSurface, onTint);\n    return oklchToHex({ l, c: chroma, h: hue });\n  };\n\n  const danger = sem(\"danger\");\n  const dangerLch = hexToOklch(danger)!;\n  const semantic: SemanticTokens = {\n    danger,\n    dangerHover: oklchToHex({\n      ...dangerLch,\n      l: mode === \"light\" ? dangerLch.l - 0.06 : dangerLch.l + 0.06,\n    }),\n    dangerContrast: contrastOn(danger),\n    // The tone border follows its siblings' lightness in dark mode (warning 0.44, info\n    // and success 0.45) — a soft frame; the strong line keeps the old, louder recipe.\n    dangerBorder: oklchToHex({\n      l: mode === \"light\" ? dangerLch.l + 0.22 : 0.45,\n      c: semanticChroma.danger,\n      h: semanticHue.danger,\n    }),\n    dangerBorderStrong: oklchToHex({\n      l: mode === \"light\" ? dangerLch.l + 0.22 : dangerLch.l - 0.22,\n      c: semanticChroma.danger,\n      h: semanticHue.danger,\n    }),\n    dangerBg: tintOn(semanticHue.danger, semanticChroma.danger, surfaces.bgSurface, mode),\n    warning: sem(\"warning\"),\n    warningBorder: oklchToHex({\n      l: mode === \"light\" ? 0.82 : 0.44,\n      c: semanticChroma.warning,\n      h: semanticHue.warning,\n    }),\n    warningBg: tintOn(semanticHue.warning, semanticChroma.warning, surfaces.bgSurface, mode),\n    info: sem(\"info\"),\n    infoBorder: oklchToHex({\n      l: mode === \"light\" ? 0.8 : 0.45,\n      c: semanticChroma.info,\n      h: semanticHue.info,\n    }),\n    infoBg: tintOn(semanticHue.info, semanticChroma.info, surfaces.bgSurface, mode),\n    success: sem(\"success\"),\n    successBorder: oklchToHex({\n      l: mode === \"light\" ? 0.81 : 0.45,\n      c: semanticChroma.success,\n      h: semanticHue.success,\n    }),\n    successBg: tintOn(semanticHue.success, semanticChroma.success, surfaces.bgSurface, mode),\n  };\n\n  if (accentLch) {\n    const accent = solveAgainst(accentLch.h, Math.max(accentLch.c, 0.06), 3, worstSurface, mode);\n    semantic.accent = accent;\n    semantic.accentContrast = contrastOn(accent);\n    semantic.accentBg = tintOn(accentLch.h, Math.max(accentLch.c, 0.06), surfaces.bgSurface, mode);\n  }\n\n  // ── Money. A THIRD system again: these are data colours with fixed meanings, and the\n  // one rule that outranks everything is that income and expense must never be the\n  // red/green pair — which is why the shipped presets use teal/amber/violet. Derived\n  // here at fixed hues rather than from the brand, for the same reason `--danger` is:\n  // a consumer who rebrands does not thereby change what \"money out\" looks like.\n  const money = (hue: number, target: number) => solveAgainst(hue, 0.12, target, worstText, mode);\n  const moneyIncome = money(175, 4.5);\n  const moneyExpense = money(70, 4.5);\n  const moneyNet = money(300, 4.5);\n  // \"No money has moved\": a quiet grey at a fixed lightness, but printed as TEXT (the\n  // numpad's sign, a future row's figure), so it gets the text floor too (0.33). The\n  // fixed lightness left it at 4.24:1 on four light pages.\n  const neutralChroma = 0.012 * weight;\n  const neutralFloor = solveLightness(4.5, parseHex(worstText)!, brand.h, neutralChroma, mode === \"light\" ? \"darker\" : \"lighter\");\n  const moneyNeutral = oklchToHex({\n    l: mode === \"light\" ? Math.min(0.52, neutralFloor) : Math.max(0.72, neutralFloor),\n    c: neutralChroma,\n    h: brand.h,\n  });\n\n  const tokens: TokenSet = {\n    ...surfaces,\n    textPrimary,\n    textSecondary,\n    textMuted,\n    brand: brandHex,\n    brandHover,\n    brandContrast,\n    moneyIncome,\n    moneyExpense,\n    moneyNet,\n    moneyNeutral,\n    // Left alone. See the note at the top of this file about why the categorical ramp is\n    // not derived from the brand unless the caller asks.\n    //\n    // ⚠️ EMPTY, not absent: a caller who hands this straight to `applyTokenSet` keeps\n    // whatever `--chart-1…9` were already on the element. That is deliberate — the ramp\n    // is a separate decision and clearing it would leave charts unpainted — but it means\n    // a derived palette applied over another preset is a MIX until you also supply a\n    // ramp. `deriveChartRamp` is how you supply one.\n    chart: [],\n    heat: deriveHeat(moneyIncome, moneyExpense, surfaces, mode),\n  };\n\n  // Audited at both contrast levels (0.36, colour-roles §13.5): More contrast steps the\n  // text, the border and, in light, the well and money of this set. The derived semantic\n  // colours are audited at Standard only: they are solved for the standard grounds, and\n  // only tokens.css's shipped literals step for the darker well.\n  const standard = auditPalette(tokens, semantic);\n  const more = auditPalette(tokens, undefined, { level: \"more\" });\n  const checks = [...standard.checks, ...more.checks];\n  const failures = checks.filter((c) => !c.passes);\n  return { tokens, semantic, audit: { checks, failures, passes: failures.length === 0 }, warnings };\n}\n\n/**\n * Heatmap stops, reusing the money pair.\n *\n * `under` is the good direction and `over` the bad one, at the SAME hues as\n * `moneyIncome`/`moneyExpense` — so a heatmap cell and the figure printed beside it\n * agree about which way is which, rather than each inventing its own convention.\n */\nfunction deriveHeat(\n  income: string,\n  expense: string,\n  surfaces: { bgSurface2: string },\n  mode: ThemeMode,\n): HeatStops {\n  const exp = hexToOklch(expense)!;\n  return {\n    neutral: surfaces.bgSurface2,\n    under: income,\n    over: expense,\n    seqLow: oklchToHex({ l: mode === \"light\" ? 0.93 : 0.26, c: 0.05, h: exp.h }),\n    seqHigh: expense,\n    empty: mode === \"light\" ? \"rgba(120,110,95,0.14)\" : \"rgba(160,170,190,0.10)\",\n  };\n}\n\n/* ── Audit ────────────────────────────────────────────────────────────────── */\n\n/**\n * Measure every pair that has a requirement, and say which ones fail.\n *\n * This is the part the shipped presets were missing. `derivePalette` runs it on the way\n * out, and the preset test runs it over everything the package ships, so a palette that\n * does not hold up cannot be merged with a comment claiming that it does.\n *\n * **`level: \"more\"`** (0.36, docs/colour-roles-harmonization.md §13.5) measures the set as\n * More contrast paints it: the stepped secondary, muted and border, and in a light set the\n * stepped well (as `bgSurface2`) and money — the same pairs, named with a \" (More\n * contrast)\" suffix. Two things change with the level: the border is a field's boundary\n * there, held to WCAG 1.4.11's 3:1 rather than the hairline's 1.1, and a light set's well\n * must stand {@link WELL_STEP_MIN}:1 from the card. Pass `semantic` with tokens.css's More\n * literals for a light set (the status colours step there); the status text is then\n * measured on the stepped well too.\n */\nexport function auditPalette(\n  set: TokenSet,\n  semantic?: SemanticTokens,\n  options: { level?: ContrastLevel } = {},\n): ContrastReport {\n  const more = options.level === \"more\";\n  const step = more ? contrastStep(set) : null;\n  // The set as it paints at this level: what `applyTokenSet` writes for it.\n  const t: TokenSet = step\n    ? {\n        ...set,\n        textSecondary: step.textSecondary,\n        textMuted: step.textMuted,\n        border: step.border,\n        ...(step.well && {\n          bgSurface2: step.well.bgSurface2,\n          moneyIncome: step.well.moneyIncome,\n          moneyExpense: step.well.moneyExpense,\n          moneyNet: step.well.moneyNet,\n          moneyNeutral: step.well.moneyNeutral,\n        }),\n      }\n    : set;\n  const suffix = more ? \" (More contrast)\" : \"\";\n  const checks: ContrastCheck[] = [];\n  const surfaces: Array<[string, string]> = [\n    [\"bgPage\", t.bgPage],\n    [\"bgSurface\", t.bgSurface],\n    [\"bgSurface2\", t.bgSurface2],\n  ];\n  // A hovered row on the card (`--bg-hover`) carries the same text as the card, and in\n  // light it is the darkest fill that text sits on (0.33, §12.10). Text is measured on\n  // it; the brand fill and the hairline, which are not text, are not.\n  const hover = hoverFill(t);\n  const textGrounds: Array<[string, string]> = [...surfaces, [\"bgHover\", hover]];\n  // `--brand-muted`, `--brand-bg` and `--brand-bg-hover`, mixed as tokens.css mixes them.\n  const { brandMuted, brandBg, brandBgHover } = brandSoft(t);\n\n  // The 0.05 of slack is for a pair with a color-mix on one side, and only for that: the\n  // browser mixes in float and paints the result, where this mixes and rounds to hex, so\n  // the two can differ by a hair. Hex against hex is what the page paints, measured\n  // exactly — the slack used to cover those too, and passed the Contrast preset's dark\n  // brand fill at 2.998:1 (round 0.34 BUG-8).\n  const MIXED = /\\b(bgHover|brandMuted|brandBg|brandBgHover)\\b/;\n  const add = (pair: string, fg: string, bg: string, required: number, rule: string) => {\n    const ratio = contrast(fg, bg);\n    const slack = MIXED.test(pair) ? 0.05 : 0;\n    checks.push({ pair: pair + suffix, ratio, required, rule, passes: ratio >= required - slack });\n  };\n\n  for (const [name, bg] of surfaces) {\n    add(`brand on ${name}`, t.brand, bg, 3, \"WCAG 1.4.11 graphical object\");\n    if (more) add(`border on ${name}`, t.border, bg, 3, \"WCAG 1.4.11 — under More contrast a border bounds a field\");\n    else add(`border on ${name}`, t.border, bg, 1.1, \"house rule: a hairline must be findable\");\n  }\n  // The stepped light well, a hex `applyTokenSet` writes (§13.3, decision 2).\n  if (step?.well) {\n    add(\"bgSurface2 on bgSurface\", t.bgSurface2, t.bgSurface, WELL_STEP_MIN, \"house rule: the well stands two hover steps from the card\");\n  }\n  for (const [name, bg] of textGrounds) {\n    add(`textPrimary on ${name}`, t.textPrimary, bg, 7, \"WCAG 1.4.6 AAA body text\");\n    add(`textSecondary on ${name}`, t.textSecondary, bg, 4.5, \"WCAG 1.4.3 AA body text\");\n    add(`textMuted on ${name}`, t.textMuted, bg, 4.5, \"WCAG 1.4.3 AA body text\");\n    add(`brandMuted on ${name}`, brandMuted, bg, 4.5, \"WCAG 1.4.3 — the brand as text\");\n    for (const [key, hex] of [\n      [\"moneyIncome\", t.moneyIncome],\n      [\"moneyExpense\", t.moneyExpense],\n      [\"moneyNet\", t.moneyNet],\n      // Not a figure's colour but still printed as one (the numpad's sign, a future\n      // row's amount) — measured since 0.33, when it was found at 4.24:1.\n      [\"moneyNeutral\", t.moneyNeutral],\n    ] as const) {\n      add(`${key} on ${name}`, hex, bg, 4.5, \"WCAG 1.4.3 — these are rendered as TEXT\");\n    }\n  }\n\n  add(\"brandContrast on brand\", t.brandContrast, t.brand, 4.5, \"WCAG 1.4.3 AA body text\");\n  // A hovered brand button carries the same label (0.33): the derived dark presets\n  // lightened the hover toward their white label and left it at 4.07:1.\n  add(\"brandContrast on brandHover\", t.brandContrast, t.brandHover, 4.5, \"WCAG 1.4.3 AA body text\");\n  add(\"brandMuted on brandBg\", brandMuted, brandBg, 4.5, \"WCAG 1.4.3 — a soft brand chip's label\");\n  // The same label on the chip hovered (§12.11): a current link, a selected day. At 70 %\n  // brand the muted text read 4.08–4.42:1 here (Default and Moss light; Ink, Moss, Plum\n  // and Contrast dark).\n  add(\"brandMuted on brandBgHover\", brandMuted, brandBgHover, 4.5, \"WCAG 1.4.3 — a hovered soft brand chip's label\");\n\n  if (semantic) {\n    for (const [name, fg] of [\n      [\"danger\", semantic.danger],\n      [\"warning\", semantic.warning],\n      [\"info\", semantic.info],\n      [\"success\", semantic.success],\n    ] as const) {\n      add(`${name} on bgSurface`, fg, t.bgSurface, 4.5, \"WCAG 1.4.3 — rendered as text\");\n      add(`${name} on bgHover`, fg, hover, 4.5, \"WCAG 1.4.3 — rendered as text, on a hovered row\");\n      // The darker light well the More literals were solved for (§13.3).\n      if (step?.well) add(`${name} on bgSurface2`, fg, t.bgSurface2, 4.5, \"WCAG 1.4.3 — rendered as text, on the well\");\n    }\n    add(\"danger on dangerBg\", semantic.danger, semantic.dangerBg, 4.5, \"WCAG 1.4.3 — badge text\");\n    add(\"warning on warningBg\", semantic.warning, semantic.warningBg, 4.5, \"WCAG 1.4.3 — badge text\");\n    add(\"info on infoBg\", semantic.info, semantic.infoBg, 4.5, \"WCAG 1.4.3 — badge text\");\n    add(\"success on successBg\", semantic.success, semantic.successBg, 4.5, \"WCAG 1.4.3 — badge text\");\n    add(\n      \"dangerContrast on danger\",\n      semantic.dangerContrast,\n      semantic.danger,\n      4.5,\n      \"WCAG 1.4.3 AA body text\",\n    );\n  }\n\n  const failures = checks.filter((c) => !c.passes);\n  return { checks, failures, passes: failures.length === 0 };\n}\n\n/* ── Categorical chart ramp ───────────────────────────────────────────────── */\n\nexport interface ChartRampReport {\n  colors: string[];\n  /** Series pairs that are too close under normal vision or any simulated CVD. */\n  collisions: Array<{ a: number; b: number; under: \"normal\" | CvdType; distance: number }>;\n  /** Series that do not clear 3:1 against a surface they may be drawn on. */\n  lowContrast: Array<{ index: number; surface: string; ratio: number }>;\n  /** The worst pairwise separation, across normal vision and all three dichromacies. */\n  minSeparation: number;\n  /** The worst contrast any series reaches against any surface it was measured on. */\n  minContrast: number;\n  passes: boolean;\n}\n\n/**\n * The floor for pairwise separation in OKLab, across normal vision and each dichromacy.\n *\n * CALIBRATED, not chosen. Paul Tol's \"Muted\" set — which this package ships and which is\n * a well-regarded CVD-safe palette — bottoms out at 0.059 in its light variant and 0.032\n * in the lightened dark one. A threshold above 0.059 would fail a palette that is known\n * to work, which is worse than having no check at all: an audit that cries wolf gets\n * switched off. 0.05 sits just under the known-good case.\n */\nconst MIN_SEPARATION = 0.05;\n\n/**\n * **The categorical trade-off, measured.** At a SINGLE lightness, the most series that\n * can satisfy both the 3:1 fill contrast of WCAG 1.4.11 and {@link MIN_SEPARATION} under\n * dichromacy is FOUR. Searched exhaustively over starting hue and lightness:\n *\n *   n=4  best separation 0.065  — both satisfiable\n *   n=5  best separation 0.041  — not satisfiable\n *   n=9  best separation 0.015  — not satisfiable\n *\n * The reason is structural: dichromacy collapses the red-green axis, so hue alone stops\n * distinguishing colours once you need more than a handful, and the remaining channel is\n * LIGHTNESS — the very thing a uniform-contrast ramp holds constant. Paul Tol's set\n * varies lightness deliberately and pays for it in contrast; that is not an oversight in\n * their palette, it is the only currency left.\n *\n * So above four series this deriver varies lightness too, and reports what it gave up\n * rather than pretending both constraints were met.\n *\n * NOTE ON WHAT THIS BOUND IS. It describes the PROBLEM, not a guarantee about\n * {@link deriveChartRamp}. That function fixes lightness and starts the hue wheel at the\n * brand's own hue rather than searching for the best start, so it reaches the bound only\n * where the brand happens to sit well: sweeping 72 brand hues against the default light\n * surfaces, 7 of 72 produced a passing 4-series ramp (12 of 72 on dark), and none passed\n * at 5 or 9. Read the report it returns; do not assume a pass.\n */\nconst SINGLE_LIGHTNESS_MAX_SERIES = 4;\n\n/**\n * A categorical ramp of `count` hues, evenly spaced and equal in perceived lightness,\n * then MEASURED for separability — including under each dichromacy.\n *\n * Offered but not used by default, and the distinction matters. Evenly spaced hues at\n * one lightness are a reasonable generic answer; Paul Tol's \"Muted\" set, which this\n * package ships, is a better specific one, because it was optimised against real\n * confusion lines rather than derived from a formula. So this exists for a consumer who\n * wants their charts to follow their brand and is willing to read the report — not as\n * a silent upgrade to the default.\n */\nexport function deriveChartRamp(\n  brandHex: string,\n  mode: ThemeMode,\n  surfaces: string[],\n  count = 9,\n): ChartRampReport {\n  const brand = hexToOklch(brandHex) ?? { l: 0.6, c: 0.12, h: 264 };\n  const base = mode === \"light\" ? 0.58 : 0.74;\n  const c = Math.max(0.09, Math.min(brand.c, 0.15));\n  // Up to four series, one lightness: a scale that varies lightness implies rank, and a\n  // categorical one must not. Beyond four, lightness is the only channel left that\n  // survives dichromacy — see SINGLE_LIGHTNESS_MAX_SERIES — so it alternates in a\n  // three-step cycle, which keeps ADJACENT series (the ones a legend puts side by side)\n  // at different lightnesses as well as different hues.\n  const vary = count > SINGLE_LIGHTNESS_MAX_SERIES;\n  const offsets = [0, mode === \"light\" ? -0.1 : 0.1, mode === \"light\" ? 0.08 : -0.08];\n  const colors = Array.from({ length: count }, (_, i) =>\n    oklchToHex({\n      l: vary ? base + offsets[i % offsets.length] : base,\n      c,\n      h: (brand.h + (360 / count) * i) % 360,\n    }),\n  );\n\n  return measureRamp(colors, surfaces);\n}\n\n/** Audit a ramp somebody else chose — the shipped Paul Tol set, say. */\nexport function auditChartRamp(colors: string[], surfaces: string[]): ChartRampReport {\n  return measureRamp(colors, surfaces);\n}\n\nfunction measureRamp(colors: string[], surfaces: string[]): ChartRampReport {\n  const collisions: ChartRampReport[\"collisions\"] = [];\n  const rgbs = colors.map((hex) => parseHex(hex)).filter((v): v is NonNullable<typeof v> => !!v);\n  let minSeparation = Infinity;\n  for (let i = 0; i < rgbs.length; i++) {\n    for (let j = i + 1; j < rgbs.length; j++) {\n      const normal = deltaE(rgbs[i], rgbs[j]);\n      minSeparation = Math.min(minSeparation, normal);\n      if (normal < MIN_SEPARATION) {\n        collisions.push({ a: i, b: j, under: \"normal\", distance: normal });\n      }\n      for (const type of [\"protanopia\", \"deuteranopia\", \"tritanopia\"] as const) {\n        const d = deltaE(simulateCvd(rgbs[i], type), simulateCvd(rgbs[j], type));\n        minSeparation = Math.min(minSeparation, d);\n        if (d < MIN_SEPARATION) collisions.push({ a: i, b: j, under: type, distance: d });\n      }\n    }\n  }\n\n  const lowContrast: ChartRampReport[\"lowContrast\"] = [];\n  let minContrast = Infinity;\n  colors.forEach((hex, index) => {\n    for (const surface of surfaces) {\n      const ratio = contrast(hex, surface);\n      minContrast = Math.min(minContrast, ratio);\n      // WCAG 1.4.11: a graphical object carrying meaning needs 3:1 against what is\n      // adjacent to it. A bar the same value as the card behind it has no boundary.\n      if (ratio < 3) lowContrast.push({ index, surface, ratio });\n    }\n  });\n\n  return {\n    colors,\n    collisions,\n    lowContrast,\n    minSeparation: Number.isFinite(minSeparation) ? minSeparation : 0,\n    minContrast: Number.isFinite(minContrast) ? minContrast : 0,\n    passes: collisions.length === 0 && lowContrast.length === 0,\n  };\n}\n\n/** Convenience: the OKLCH of a hex, for a caller inspecting an anchor. */\nexport function describe(hex: string): Oklch | null {\n  const rgb = parseHex(hex);\n  return rgb ? rgbToOklch(rgb) : null;\n}\n"],"mappings":";AAGA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,WAAW,cAAc,WAAW,iBAAiB,qBAAqB;AA8GnF,MAAM,WAA4F;AAAA,EAChG,QAAQ,EAAE,KAAK,IAAI,OAAO,GAAG;AAAA,EAC7B,SAAS,EAAE,KAAK,IAAI,OAAO,GAAG;AAAA,EAC9B,SAAS,EAAE,KAAK,KAAK,OAAO,GAAG;AAAA,EAC/B,MAAM,EAAE,KAAK,KAAK,OAAO,GAAG;AAC9B;AAGA,SAAS,OAAO,GAAW,GAAmB;AAC5C,QAAM,IAAI,KAAK,KAAM,IAAI,KAAK,MAAO,GAAG,IAAI;AAC5C,SAAO,IAAI,MAAM,MAAM,IAAI;AAC7B;AAUA,SAAS,SAAS,MAAc,OAAe,OAAyB;AACtE,MAAI,OAAO;AACX,MAAI,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC,GAAG,GAAG;AAChE,WAAS,IAAI,CAAC,OAAO,KAAK,OAAO,KAAK,GAAG;AACvC,UAAM,KAAK,OAAO,IAAI,OAAO;AAC7B,UAAM,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,GAAG;AAE3D,QAAI,MAAM,UAAU,MAAM;AACxB,aAAO;AACP,gBAAU;AAAA,IACZ;AAAA,EACF;AACA,SAAO;AACT;AAIA,MAAM,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUhB,OAAO,EAAE,MAAM,OAAO,SAAS,OAAO,UAAU,MAAM;AAAA,EACtD,MAAM,EAAE,MAAM,OAAO,SAAS,OAAO,UAAU,MAAM;AACvD;AAWA,MAAM,kBAAkB;AAGxB,MAAM,qBAAqB;AAQ3B,MAAM,kBAAkB;AAGxB,SAAS,UAAU,OAAsB;AACvC,SAAO,KAAK,IAAI,GAAG,MAAM,IAAI,eAAe;AAC9C;AAEA,SAAS,WAAW,KAAa,MAAiB,MAAc,QAAgB;AAC9E,QAAM,IAAI,qBAAqB,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC,IAAI;AAChE,QAAM,IAAI,UAAU,IAAI;AACxB,QAAM,SAAS,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,CAAC;AAClD,QAAM,YAAY,WAAW,EAAE,GAAG,EAAE,SAAS,GAAG,GAAG,IAAI,CAAC;AACxD,QAAM,aAAa,WAAW,EAAE,GAAG,EAAE,UAAU,GAAG,GAAG,IAAI,CAAC;AAK1D,QAAM,eAAe,IAAI;AAIzB,QAAM,UAAU,CAAC,QAAQ,WAAW,UAAU,EAAE;AAAA,IAAO,CAAC,GAAG,MACzD,SAAS,GAAG,SAAS,UAAU,YAAY,SAAS,IACpD,SAAS,GAAG,SAAS,UAAU,YAAY,SAAS,IAChD,IACA;AAAA,EACN;AACA,QAAM,UAAU;AAAA,IACd;AAAA,IACA,SAAS,OAAO;AAAA,IAChB;AAAA,IACA;AAAA,IACA,SAAS,UAAU,WAAW;AAAA,EAChC;AACA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ,WAAW,EAAE,GAAG,SAAS,GAAG,cAAc,GAAG,IAAI,CAAC;AAAA,EAC5D;AACF;AAGA,SAAS,aAAa,KAAa,QAAgB,QAAgB,SAAiB,MAAyB;AAC3G,QAAM,KAAK,SAAS,OAAO;AAC3B,QAAM,IAAI,eAAe,QAAQ,IAAI,KAAK,QAAQ,SAAS,UAAU,WAAW,SAAS;AACzF,SAAO,WAAW,EAAE,GAAG,GAAG,QAAQ,GAAG,IAAI,CAAC;AAC5C;AAGA,SAAS,WAAW,MAAsB;AACxC,QAAM,QAAQ;AACd,QAAM,OAAO;AACb,SAAO,SAAS,MAAM,KAAK,KAAK,SAAS,MAAM,IAAI,IAAI,QAAQ;AACjE;AAGA,SAAS,OAAO,KAAa,QAAgB,SAAiB,MAAyB;AACrF,QAAM,IAAI,WAAW,OAAO;AAG5B,QAAM,IAAI,SAAS,UAAU,EAAE,IAAI,QAAQ,EAAE,IAAI;AACjD,SAAO,WAAW,EAAE,GAAG,GAAG,KAAK,IAAI,SAAS,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC;AACnE;AAEO,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd;AACF,GAAkC;AAChC,QAAM,WAAqB,CAAC;AAC5B,QAAM,QAAQ,WAAW,QAAQ,KAAK;AACtC,MAAI,CAAC,OAAO;AACV,UAAM,IAAI;AAAA,MACR,yBAAyB,QAAQ,KAAK;AAAA,IAExC;AAAA,EACF;AAEA,QAAM,UAAU,EAAE,SAAS,IAAI,WAAW,GAAG,OAAO,KAAK,GAAG,aAAa;AAGzE,QAAM,SAAS,UAAU,KAAK;AAC9B,QAAM,WAAW,WAAW,MAAM,GAAG,MAAM,aAAa,MAAM;AAI9D,QAAM,eAAe,CAAC,SAAS,QAAQ,SAAS,WAAW,SAAS,UAAU,EAAE;AAAA,IAAO,CAAC,GAAG,MACzF,SAAS,GAAG,SAAS,UAAU,YAAY,SAAS,IACpD,SAAS,GAAG,SAAS,UAAU,YAAY,SAAS,IAChD,IACA;AAAA,EACN;AAGA,QAAM,aAAa,QAAQ;AAC3B,QAAM,cAAc,aAAa,MAAM,GAAG,YAAY,QAAQ,SAAS,cAAc,IAAI;AACzF,QAAM,gBAAgB,aAAa,MAAM,GAAG,YAAY,QAAQ,WAAW,cAAc,IAAI;AAC7F,QAAM,YAAY,aAAa,MAAM,GAAG,YAAY,QAAQ,OAAO,cAAc,IAAI;AAOrF,QAAM,QAAQ,UAAU,EAAE,aAAa,WAAW,SAAS,UAAU,CAAC;AACtE,QAAM,YAAY,CAAC,cAAc,KAAK,EAAE;AAAA,IAAO,CAAC,GAAG,MACjD,SAAS,GAAG,SAAS,UAAU,YAAY,SAAS,IACpD,SAAS,GAAG,SAAS,UAAU,YAAY,SAAS,IAChD,IACA;AAAA,EACN;AAUA,QAAM,WAAW,gBAAgB,EAAE,aAAa,WAAW,SAAS,UAAU,CAAC;AAC/E,QAAM,cAAc,WAChB,CAAC,cAAc,QAAQ,EAAE,OAAO,CAAC,GAAG,MAAO,SAAS,GAAG,SAAS,IAAI,SAAS,GAAG,SAAS,IAAI,IAAI,CAAE,IACnG;AACJ,QAAM,cAAc,KAAK,IAAI,MAAM,GAAG,IAAI;AAC1C,QAAM,aAAa,SAAS,QAAQ,OAAO,WAAW;AAItD,MAAI,WACF,cAAc,IACV,MAAM,SAAS,QAAQ,KAAK,CAAE,IAC9B,aAAa,MAAM,GAAG,aAAa,GAAG,aAAa,IAAI;AAC7D,MAAI,aAAa,GAAG;AAClB,aAAS;AAAA,MACP,SAAS,QAAQ,KAAK,YAAY,WAAW,QAAQ,CAAC,CAAC,kBAAkB,IAAI,8FAExE,QAAQ;AAAA,IACf;AAAA,EACF;AAOA,QAAM,kBAAkB,CAAC,QAAgB;AACvC,UAAM,OAAO,UAAU,EAAE,OAAO,KAAK,aAAa,WAAW,SAAS,UAAU,CAAC;AACjF,WAAO,KAAK;AAAA,MACV,SAAS,KAAK,YAAY,SAAS;AAAA,MACnC,SAAS,KAAK,YAAY,KAAK,OAAO;AAAA,MACtC,SAAS,KAAK,YAAY,KAAK,YAAY;AAAA;AAAA,MAE3C,WAAW,SAAS,KAAK,YAAY,QAAQ,IAAI;AAAA,IACnD;AAAA,EACF;AACA,WAAS,IAAI,GAAG,IAAI,MAAM,gBAAgB,QAAQ,IAAI,KAAK,KAAK;AAC9D,UAAM,MAAM,WAAW,QAAQ;AAC/B,eAAW,WAAW,EAAE,GAAG,KAAK,GAAG,SAAS,UAAU,IAAI,IAAI,OAAQ,IAAI,IAAI,KAAM,CAAC;AAAA,EACvF;AACA,MAAI,gBAAgB,QAAQ,IAAI,KAAK;AACnC,aAAS;AAAA,MACP,kDAAkD,gBAAgB,QAAQ,EAAE,QAAQ,CAAC,CAAC,kBACrE,IAAI;AAAA,IACvB;AAAA,EACF;AACA,QAAM,WAAW,WAAW,QAAQ;AACpC,QAAM,gBAAgB,WAAW,QAAQ;AACzC,QAAM,aAAa,WAAW;AAAA,IAC5B,GAAG;AAAA;AAAA;AAAA;AAAA,IAIH,GAAG,kBAAkB,YAAY,SAAS,IAAI,OAAO,SAAS,IAAI;AAAA,EACpE,CAAC;AACD,QAAM,UAAU,SAAS,UAAU,aAAa;AAChD,MAAI,UAAU,KAAK;AACjB,aAAS;AAAA,MACP,uCAAuC,QAAQ,QAAQ,CAAC,CAAC;AAAA,IAG3D;AAAA,EACF;AAIA,QAAM,QAAkB,CAAC,SAAS,CAAC;AACnC,QAAM,YAAY,QAAQ,SAAS,WAAW,QAAQ,MAAM,IAAI;AAChE,MAAI,QAAQ,UAAU,CAAC,WAAW;AAChC,aAAS,KAAK,WAAW,QAAQ,MAAM,wCAAwC;AAAA,EACjF;AACA,MAAI,UAAW,OAAM,KAAK,UAAU,CAAC;AAErC,QAAM,cAAc,CAAC;AACrB,QAAM,iBAAiB,CAAC;AACxB,aAAW,QAAQ,CAAC,UAAU,WAAW,WAAW,MAAM,GAAY;AACpE,UAAM,SAAS,QAAQ,IAAI,IAAI,WAAW,QAAQ,IAAI,CAAE,IAAI;AAC5D,QAAI,QAAQ,IAAI,KAAK,CAAC,QAAQ;AAC5B,eAAS,KAAK,GAAG,IAAI,KAAK,QAAQ,IAAI,CAAC,wCAAwC;AAAA,IACjF;AACA,UAAM,OAAO,SAAS,IAAI;AAC1B,UAAM,MAAM,SAAS,OAAO,IAAI,SAAS,KAAK,KAAK,KAAK,OAAO,KAAK;AACpE,QAAI,CAAC,QAAQ;AACX,YAAM,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC,CAAC;AACxD,UAAI,MAAM,IAAI;AACZ,iBAAS;AAAA,UACP,GAAG,IAAI,qBAAqB,IAAI,QAAQ,CAAC,CAAC,uFACI,IAAI;AAAA,QACpD;AAAA,MACF;AAAA,IACF;AACA,gBAAY,IAAI,IAAI;AACpB,mBAAe,IAAI,IAAI,SAAS,KAAK,IAAI,OAAO,GAAG,IAAI,IAAI;AAC3D,UAAM,KAAK,GAAG;AAAA,EAChB;AASA,QAAM,MAAM,CAAC,SAAkD;AAC7D,UAAM,MAAM,YAAY,IAAI;AAC5B,UAAM,SAAS,eAAe,IAAI;AAClC,UAAM,KAAK,OAAO,KAAK,QAAQ,SAAS,WAAW,IAAI;AACvD,UAAM,YAAY;AAAA,MAChB;AAAA,MACA,SAAS,SAAS;AAAA,MAClB;AAAA,MACA;AAAA,MACA,SAAS,UAAU,WAAW;AAAA,IAChC;AACA,UAAM,SAAS;AAAA,MACb;AAAA,MACA,SAAS,EAAE;AAAA,MACX;AAAA,MACA;AAAA,MACA,SAAS,UAAU,WAAW;AAAA,IAChC;AACA,UAAM,IAAI,SAAS,UAAU,KAAK,IAAI,WAAW,MAAM,IAAI,KAAK,IAAI,WAAW,MAAM;AACrF,WAAO,WAAW,EAAE,GAAG,GAAG,QAAQ,GAAG,IAAI,CAAC;AAAA,EAC5C;AAEA,QAAM,SAAS,IAAI,QAAQ;AAC3B,QAAM,YAAY,WAAW,MAAM;AACnC,QAAM,WAA2B;AAAA,IAC/B;AAAA,IACA,aAAa,WAAW;AAAA,MACtB,GAAG;AAAA,MACH,GAAG,SAAS,UAAU,UAAU,IAAI,OAAO,UAAU,IAAI;AAAA,IAC3D,CAAC;AAAA,IACD,gBAAgB,WAAW,MAAM;AAAA;AAAA;AAAA,IAGjC,cAAc,WAAW;AAAA,MACvB,GAAG,SAAS,UAAU,UAAU,IAAI,OAAO;AAAA,MAC3C,GAAG,eAAe;AAAA,MAClB,GAAG,YAAY;AAAA,IACjB,CAAC;AAAA,IACD,oBAAoB,WAAW;AAAA,MAC7B,GAAG,SAAS,UAAU,UAAU,IAAI,OAAO,UAAU,IAAI;AAAA,MACzD,GAAG,eAAe;AAAA,MAClB,GAAG,YAAY;AAAA,IACjB,CAAC;AAAA,IACD,UAAU,OAAO,YAAY,QAAQ,eAAe,QAAQ,SAAS,WAAW,IAAI;AAAA,IACpF,SAAS,IAAI,SAAS;AAAA,IACtB,eAAe,WAAW;AAAA,MACxB,GAAG,SAAS,UAAU,OAAO;AAAA,MAC7B,GAAG,eAAe;AAAA,MAClB,GAAG,YAAY;AAAA,IACjB,CAAC;AAAA,IACD,WAAW,OAAO,YAAY,SAAS,eAAe,SAAS,SAAS,WAAW,IAAI;AAAA,IACvF,MAAM,IAAI,MAAM;AAAA,IAChB,YAAY,WAAW;AAAA,MACrB,GAAG,SAAS,UAAU,MAAM;AAAA,MAC5B,GAAG,eAAe;AAAA,MAClB,GAAG,YAAY;AAAA,IACjB,CAAC;AAAA,IACD,QAAQ,OAAO,YAAY,MAAM,eAAe,MAAM,SAAS,WAAW,IAAI;AAAA,IAC9E,SAAS,IAAI,SAAS;AAAA,IACtB,eAAe,WAAW;AAAA,MACxB,GAAG,SAAS,UAAU,OAAO;AAAA,MAC7B,GAAG,eAAe;AAAA,MAClB,GAAG,YAAY;AAAA,IACjB,CAAC;AAAA,IACD,WAAW,OAAO,YAAY,SAAS,eAAe,SAAS,SAAS,WAAW,IAAI;AAAA,EACzF;AAEA,MAAI,WAAW;AACb,UAAM,SAAS,aAAa,UAAU,GAAG,KAAK,IAAI,UAAU,GAAG,IAAI,GAAG,GAAG,cAAc,IAAI;AAC3F,aAAS,SAAS;AAClB,aAAS,iBAAiB,WAAW,MAAM;AAC3C,aAAS,WAAW,OAAO,UAAU,GAAG,KAAK,IAAI,UAAU,GAAG,IAAI,GAAG,SAAS,WAAW,IAAI;AAAA,EAC/F;AAOA,QAAM,QAAQ,CAAC,KAAa,WAAmB,aAAa,KAAK,MAAM,QAAQ,WAAW,IAAI;AAC9F,QAAM,cAAc,MAAM,KAAK,GAAG;AAClC,QAAM,eAAe,MAAM,IAAI,GAAG;AAClC,QAAM,WAAW,MAAM,KAAK,GAAG;AAI/B,QAAM,gBAAgB,QAAQ;AAC9B,QAAM,eAAe,eAAe,KAAK,SAAS,SAAS,GAAI,MAAM,GAAG,eAAe,SAAS,UAAU,WAAW,SAAS;AAC9H,QAAM,eAAe,WAAW;AAAA,IAC9B,GAAG,SAAS,UAAU,KAAK,IAAI,MAAM,YAAY,IAAI,KAAK,IAAI,MAAM,YAAY;AAAA,IAChF,GAAG;AAAA,IACH,GAAG,MAAM;AAAA,EACX,CAAC;AAED,QAAM,SAAmB;AAAA,IACvB,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,IACA,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASA,OAAO,CAAC;AAAA,IACR,MAAM,WAAW,aAAa,cAAc,UAAU,IAAI;AAAA,EAC5D;AAMA,QAAM,WAAW,aAAa,QAAQ,QAAQ;AAC9C,QAAM,OAAO,aAAa,QAAQ,QAAW,EAAE,OAAO,OAAO,CAAC;AAC9D,QAAM,SAAS,CAAC,GAAG,SAAS,QAAQ,GAAG,KAAK,MAAM;AAClD,QAAM,WAAW,OAAO,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM;AAC/C,SAAO,EAAE,QAAQ,UAAU,OAAO,EAAE,QAAQ,UAAU,QAAQ,SAAS,WAAW,EAAE,GAAG,SAAS;AAClG;AASA,SAAS,WACP,QACA,SACA,UACA,MACW;AACX,QAAM,MAAM,WAAW,OAAO;AAC9B,SAAO;AAAA,IACL,SAAS,SAAS;AAAA,IAClB,OAAO;AAAA,IACP,MAAM;AAAA,IACN,QAAQ,WAAW,EAAE,GAAG,SAAS,UAAU,OAAO,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC;AAAA,IAC3E,SAAS;AAAA,IACT,OAAO,SAAS,UAAU,0BAA0B;AAAA,EACtD;AACF;AAoBO,SAAS,aACd,KACA,UACA,UAAqC,CAAC,GACtB;AAChB,QAAM,OAAO,QAAQ,UAAU;AAC/B,QAAM,OAAO,OAAO,aAAa,GAAG,IAAI;AAExC,QAAM,IAAc,OAChB;AAAA,IACE,GAAG;AAAA,IACH,eAAe,KAAK;AAAA,IACpB,WAAW,KAAK;AAAA,IAChB,QAAQ,KAAK;AAAA,IACb,GAAI,KAAK,QAAQ;AAAA,MACf,YAAY,KAAK,KAAK;AAAA,MACtB,aAAa,KAAK,KAAK;AAAA,MACvB,cAAc,KAAK,KAAK;AAAA,MACxB,UAAU,KAAK,KAAK;AAAA,MACpB,cAAc,KAAK,KAAK;AAAA,IAC1B;AAAA,EACF,IACA;AACJ,QAAM,SAAS,OAAO,qBAAqB;AAC3C,QAAM,SAA0B,CAAC;AACjC,QAAM,WAAoC;AAAA,IACxC,CAAC,UAAU,EAAE,MAAM;AAAA,IACnB,CAAC,aAAa,EAAE,SAAS;AAAA,IACzB,CAAC,cAAc,EAAE,UAAU;AAAA,EAC7B;AAIA,QAAM,QAAQ,UAAU,CAAC;AACzB,QAAM,cAAuC,CAAC,GAAG,UAAU,CAAC,WAAW,KAAK,CAAC;AAE7E,QAAM,EAAE,YAAY,SAAS,aAAa,IAAI,UAAU,CAAC;AAOzD,QAAM,QAAQ;AACd,QAAM,MAAM,CAAC,MAAc,IAAY,IAAY,UAAkB,SAAiB;AACpF,UAAM,QAAQ,SAAS,IAAI,EAAE;AAC7B,UAAM,QAAQ,MAAM,KAAK,IAAI,IAAI,OAAO;AACxC,WAAO,KAAK,EAAE,MAAM,OAAO,QAAQ,OAAO,UAAU,MAAM,QAAQ,SAAS,WAAW,MAAM,CAAC;AAAA,EAC/F;AAEA,aAAW,CAAC,MAAM,EAAE,KAAK,UAAU;AACjC,QAAI,YAAY,IAAI,IAAI,EAAE,OAAO,IAAI,GAAG,8BAA8B;AACtE,QAAI,KAAM,KAAI,aAAa,IAAI,IAAI,EAAE,QAAQ,IAAI,GAAG,gEAA2D;AAAA,QAC1G,KAAI,aAAa,IAAI,IAAI,EAAE,QAAQ,IAAI,KAAK,yCAAyC;AAAA,EAC5F;AAEA,MAAI,MAAM,MAAM;AACd,QAAI,2BAA2B,EAAE,YAAY,EAAE,WAAW,eAAe,2DAA2D;AAAA,EACtI;AACA,aAAW,CAAC,MAAM,EAAE,KAAK,aAAa;AACpC,QAAI,kBAAkB,IAAI,IAAI,EAAE,aAAa,IAAI,GAAG,0BAA0B;AAC9E,QAAI,oBAAoB,IAAI,IAAI,EAAE,eAAe,IAAI,KAAK,yBAAyB;AACnF,QAAI,gBAAgB,IAAI,IAAI,EAAE,WAAW,IAAI,KAAK,yBAAyB;AAC3E,QAAI,iBAAiB,IAAI,IAAI,YAAY,IAAI,KAAK,qCAAgC;AAClF,eAAW,CAAC,KAAK,GAAG,KAAK;AAAA,MACvB,CAAC,eAAe,EAAE,WAAW;AAAA,MAC7B,CAAC,gBAAgB,EAAE,YAAY;AAAA,MAC/B,CAAC,YAAY,EAAE,QAAQ;AAAA;AAAA;AAAA,MAGvB,CAAC,gBAAgB,EAAE,YAAY;AAAA,IACjC,GAAY;AACV,UAAI,GAAG,GAAG,OAAO,IAAI,IAAI,KAAK,IAAI,KAAK,8CAAyC;AAAA,IAClF;AAAA,EACF;AAEA,MAAI,0BAA0B,EAAE,eAAe,EAAE,OAAO,KAAK,yBAAyB;AAGtF,MAAI,+BAA+B,EAAE,eAAe,EAAE,YAAY,KAAK,yBAAyB;AAChG,MAAI,yBAAyB,YAAY,SAAS,KAAK,6CAAwC;AAI/F,MAAI,8BAA8B,YAAY,cAAc,KAAK,qDAAgD;AAEjH,MAAI,UAAU;AACZ,eAAW,CAAC,MAAM,EAAE,KAAK;AAAA,MACvB,CAAC,UAAU,SAAS,MAAM;AAAA,MAC1B,CAAC,WAAW,SAAS,OAAO;AAAA,MAC5B,CAAC,QAAQ,SAAS,IAAI;AAAA,MACtB,CAAC,WAAW,SAAS,OAAO;AAAA,IAC9B,GAAY;AACV,UAAI,GAAG,IAAI,iBAAiB,IAAI,EAAE,WAAW,KAAK,oCAA+B;AACjF,UAAI,GAAG,IAAI,eAAe,IAAI,OAAO,KAAK,sDAAiD;AAE3F,UAAI,MAAM,KAAM,KAAI,GAAG,IAAI,kBAAkB,IAAI,EAAE,YAAY,KAAK,iDAA4C;AAAA,IAClH;AACA,QAAI,sBAAsB,SAAS,QAAQ,SAAS,UAAU,KAAK,8BAAyB;AAC5F,QAAI,wBAAwB,SAAS,SAAS,SAAS,WAAW,KAAK,8BAAyB;AAChG,QAAI,kBAAkB,SAAS,MAAM,SAAS,QAAQ,KAAK,8BAAyB;AACpF,QAAI,wBAAwB,SAAS,SAAS,SAAS,WAAW,KAAK,8BAAyB;AAChG;AAAA,MACE;AAAA,MACA,SAAS;AAAA,MACT,SAAS;AAAA,MACT;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,WAAW,OAAO,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM;AAC/C,SAAO,EAAE,QAAQ,UAAU,QAAQ,SAAS,WAAW,EAAE;AAC3D;AA0BA,MAAM,iBAAiB;AA2BvB,MAAM,8BAA8B;AAa7B,SAAS,gBACd,UACA,MACA,UACA,QAAQ,GACS;AACjB,QAAM,QAAQ,WAAW,QAAQ,KAAK,EAAE,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI;AAChE,QAAM,OAAO,SAAS,UAAU,OAAO;AACvC,QAAM,IAAI,KAAK,IAAI,MAAM,KAAK,IAAI,MAAM,GAAG,IAAI,CAAC;AAMhD,QAAM,OAAO,QAAQ;AACrB,QAAM,UAAU,CAAC,GAAG,SAAS,UAAU,OAAO,KAAK,SAAS,UAAU,OAAO,KAAK;AAClF,QAAM,SAAS,MAAM;AAAA,IAAK,EAAE,QAAQ,MAAM;AAAA,IAAG,CAAC,GAAG,MAC/C,WAAW;AAAA,MACT,GAAG,OAAO,OAAO,QAAQ,IAAI,QAAQ,MAAM,IAAI;AAAA,MAC/C;AAAA,MACA,IAAI,MAAM,IAAK,MAAM,QAAS,KAAK;AAAA,IACrC,CAAC;AAAA,EACH;AAEA,SAAO,YAAY,QAAQ,QAAQ;AACrC;AAGO,SAAS,eAAe,QAAkB,UAAqC;AACpF,SAAO,YAAY,QAAQ,QAAQ;AACrC;AAEA,SAAS,YAAY,QAAkB,UAAqC;AAC1E,QAAM,aAA4C,CAAC;AACnD,QAAM,OAAO,OAAO,IAAI,CAAC,QAAQ,SAAS,GAAG,CAAC,EAAE,OAAO,CAAC,MAAkC,CAAC,CAAC,CAAC;AAC7F,MAAI,gBAAgB;AACpB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,aAAS,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACxC,YAAM,SAAS,OAAO,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC;AACtC,sBAAgB,KAAK,IAAI,eAAe,MAAM;AAC9C,UAAI,SAAS,gBAAgB;AAC3B,mBAAW,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,OAAO,UAAU,UAAU,OAAO,CAAC;AAAA,MACnE;AACA,iBAAW,QAAQ,CAAC,cAAc,gBAAgB,YAAY,GAAY;AACxE,cAAM,IAAI,OAAO,YAAY,KAAK,CAAC,GAAG,IAAI,GAAG,YAAY,KAAK,CAAC,GAAG,IAAI,CAAC;AACvE,wBAAgB,KAAK,IAAI,eAAe,CAAC;AACzC,YAAI,IAAI,eAAgB,YAAW,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,OAAO,MAAM,UAAU,EAAE,CAAC;AAAA,MAClF;AAAA,IACF;AAAA,EACF;AAEA,QAAM,cAA8C,CAAC;AACrD,MAAI,cAAc;AAClB,SAAO,QAAQ,CAAC,KAAK,UAAU;AAC7B,eAAW,WAAW,UAAU;AAC9B,YAAM,QAAQ,SAAS,KAAK,OAAO;AACnC,oBAAc,KAAK,IAAI,aAAa,KAAK;AAGzC,UAAI,QAAQ,EAAG,aAAY,KAAK,EAAE,OAAO,SAAS,MAAM,CAAC;AAAA,IAC3D;AAAA,EACF,CAAC;AAED,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,eAAe,OAAO,SAAS,aAAa,IAAI,gBAAgB;AAAA,IAChE,aAAa,OAAO,SAAS,WAAW,IAAI,cAAc;AAAA,IAC1D,QAAQ,WAAW,WAAW,KAAK,YAAY,WAAW;AAAA,EAC5D;AACF;AAGO,SAAS,SAAS,KAA2B;AAClD,QAAM,MAAM,SAAS,GAAG;AACxB,SAAO,MAAM,WAAW,GAAG,IAAI;AACjC;","names":[]}
+{"version":3,"sources":["../../src/theme/palette-derive.ts"],"sourcesContent":["import type { ThemeMode } from \"./theme-store\";\nimport type { TokenSet } from \"./palette-presets\";\nimport type { HeatStops } from \"./chart-palette\";\nimport {\n  contrast,\n  deltaE,\n  toHex,\n  hexToOklch,\n  oklchToHex,\n  parseHex,\n  rgbToOklch,\n  simulateCvd,\n  solveLightness,\n} from \"./color\";\nimport type { CvdType, Oklch } from \"./color\";\nimport type { ContrastLevel } from \"./contrast\";\nimport { brandSoft, contrastStep, hoverFill, steppedWellFill, WELL_STEP_MIN } from \"./contrast-tokens\";\n\n/**\n * Build a whole palette from one brand colour, plus any number of colours pinned by\n * hand, with every contrast ratio SOLVED rather than chosen and then hoped for.\n *\n * The presets this package shipped were assembled by eye and annotated with the ratios\n * they were believed to hold — `tokens.css` records \"7.0:1 and 4.8:1\", and\n * `palette-presets.ts` records \"2.67:1 … lifted they clear it at 3.30:1\". Nothing\n * computed any of them, and the audit found four of the nine default light chart hues\n * below the 3:1 that WCAG 1.4.11 requires of a graphical object. A comment is not a\n * test. Everything here is derived to a target and then measured, and\n * {@link auditPalette} returns the measurements so a caller can refuse a palette that\n * does not hold up.\n *\n * WHAT IS DERIVED AND WHAT IS NOT. The UI palette and the CATEGORICAL CHART RAMP solve\n * different problems and are deliberately kept apart. A UI colour needs contrast against\n * one known surface and carries a fixed meaning; a chart colour needs to stay separable\n * from eight unknown siblings, at roughly equal salience, with no implied order.\n * Optimising a set for one makes it worse at the other, which is why `deriveTokenSet`\n * leaves `chart` alone unless you explicitly ask for {@link deriveChartRamp}.\n */\n\n/* ── Inputs ───────────────────────────────────────────────────────────────── */\n\n/** A role whose hue may be pinned by the caller instead of chosen by the deriver. */\nexport type AnchorRole = \"brand\" | \"accent\" | \"danger\" | \"warning\" | \"success\" | \"info\";\n\nexport type PaletteAnchors = { brand: string } & Partial<Record<Exclude<AnchorRole, \"brand\">, string>>;\n\nexport interface DeriveOptions {\n  anchors: PaletteAnchors;\n  mode: ThemeMode;\n  /**\n   * How strongly the surfaces carry the brand's hue, 0–1 of the maximum useful tint.\n   * 0 gives neutral greys; the shipped default is a visible warmth, because a page that\n   * is very slightly the brand's hue reads as considered where a pure grey reads as\n   * unstyled. Above ~0.5 the surfaces start competing with the content.\n   */\n  surfaceTint?: number;\n  /** Contrast targets for the three text roles against the WORST surface. */\n  textContrast?: { primary?: number; secondary?: number; muted?: number };\n}\n\n/* ── Outputs ──────────────────────────────────────────────────────────────── */\n\n/** The semantic layer, which lives in tokens.css rather than in `TokenSet`. */\nexport interface SemanticTokens {\n  danger: string;\n  dangerHover: string;\n  dangerContrast: string;\n  dangerBorder: string;\n  /** The error line (invalid field, danger banner, destructive focus ring): as loud as\n   *  `dangerBorder` was before 0.15.5, so it keeps 3:1 against the surface. */\n  dangerBorderStrong: string;\n  dangerBg: string;\n  warning: string;\n  warningBorder: string;\n  warningBg: string;\n  info: string;\n  infoBorder: string;\n  infoBg: string;\n  success: string;\n  successBorder: string;\n  successBg: string;\n  /** Present only when a `accent` (secondary brand) anchor was supplied. */\n  accent?: string;\n  accentContrast?: string;\n  accentBg?: string;\n}\n\nexport interface ContrastCheck {\n  /** e.g. \"textMuted on bgPage\". */\n  pair: string;\n  ratio: number;\n  /** What WCAG asks of this pair. */\n  required: number;\n  /** Which rule the requirement comes from, for a reader who wants to argue with it. */\n  rule: string;\n  passes: boolean;\n}\n\nexport interface ContrastReport {\n  checks: ContrastCheck[];\n  failures: ContrastCheck[];\n  passes: boolean;\n}\n\nexport interface DerivedPalette {\n  tokens: TokenSet;\n  semantic: SemanticTokens;\n  /** {@link auditPalette} at both contrast levels: the More-contrast checks carry a\n   *  \" (More contrast)\" suffix (0.36). */\n  audit: ContrastReport;\n  /** Compromises the deriver had to make, in plain words. Never silent. */\n  warnings: string[];\n}\n\n/* ── The hue homes ────────────────────────────────────────────────────────── */\n\n/**\n * Where each semantic role wants to sit, and how far it may be pushed.\n *\n * A semantic colour is a convention before it is an aesthetic: danger is red because\n * every other interface the user has ever used made it red, and a \"danger\" button in\n * the brand's teal is a worse button however well it matches. So each role has a home\n * hue and a narrow licence to move — enough to get out of the brand's way when the\n * brand happens to live in the same neighbourhood, not enough to stop meaning what it\n * means. If it cannot get far enough, that is a warning, not a silent compromise.\n */\nconst HUE_HOME: Record<Exclude<AnchorRole, \"brand\" | \"accent\">, { hue: number; slack: number }> = {\n  danger: { hue: 27, slack: 14 },\n  warning: { hue: 75, slack: 16 },\n  success: { hue: 150, slack: 20 },\n  info: { hue: 240, slack: 22 },\n};\n\n/** Circular distance between two hue angles, 0–180. */\nfunction hueGap(a: number, b: number): number {\n  const d = Math.abs(((a - b) % 360) + 360) % 360;\n  return d > 180 ? 360 - d : d;\n}\n\n/**\n * Nudge `home` within `slack` to maximise the distance from every taken hue.\n *\n * Sampled rather than solved: the objective is a min-of-distances over a handful of\n * points on a short arc, which is piecewise-linear with kinks wherever the nearest\n * neighbour changes. Gradient methods stall on those kinks; 2° steps over a ±22° arc is\n * 23 evaluations of some trigonometry and cannot stall.\n */\nfunction placeHue(home: number, slack: number, taken: number[]): number {\n  let best = home;\n  let bestGap = Math.min(...taken.map((t) => hueGap(home, t)), 360);\n  for (let d = -slack; d <= slack; d += 2) {\n    const h = (home + d + 360) % 360;\n    const gap = Math.min(...taken.map((t) => hueGap(h, t)), 360);\n    // Ties go to the hue nearest home: a role should move only as far as it must.\n    if (gap > bestGap + 1e-9) {\n      best = h;\n      bestGap = gap;\n    }\n  }\n  return best;\n}\n\n/* ── Derivation ───────────────────────────────────────────────────────────── */\n\nconst SURFACE_L = {\n  // Light: the PAGE is slightly darker than the cards on it, so a card reads as raised\n  // without needing a shadow to say so. Matches the shipped presets' relationship.\n  //\n  // The light WELL is the page itself (0.33, docs/colour-roles-harmonization.md §5.3,\n  // k26). Between the card and the page it sat 1.02–1.05:1 from the card it is inset\n  // in, which is no well at all; at the page's lightness it stands out from the card\n  // exactly as far as the card does from the page, and nothing re-solves, because the\n  // page is already the surface every text role is solved against. Dark keeps its\n  // well a step lighter than the card (1.11–1.13:1).\n  light: { page: 0.912, surface: 0.945, surface2: 0.912 },\n  dark: { page: 0.158, surface: 0.206, surface2: 0.249 },\n} as const;\n\n/**\n * What a hairline has to clear against the surface it divides.\n *\n * WCAG has nothing to say here — a decorative border is not a graphical object that\n * conveys information — so this is a house rule, and it is deliberately low. A border\n * that clears 3:1 is a RULE, not a hairline: it draws the eye to the box instead of to\n * what is in it. 1.5:1 is the point at which the edge is reliably findable without\n * becoming part of the composition.\n */\nconst BORDER_CONTRAST = 1.5;\n\n/** The most tint a surface can carry before it stops reading as a neutral ground. */\nconst MAX_SURFACE_CHROMA = 0.034;\n\n/**\n * The brand chroma from which the surfaces and the greys carry the brand's hue in full;\n * below it they carry it in proportion, down to none for a grey (round 0.34 BUG-8). A\n * grey has no hue — OKLCH reports 0, which is pink — and at full tint #808080 painted\n * every surface #eddde1.\n */\nconst FULL_HUE_CHROMA = 0.06;\n\n/** How much of the brand's hue the neutrals may carry: 0 for a grey, 1 from {@link FULL_HUE_CHROMA}. */\nfunction hueWeight(brand: Oklch): number {\n  return Math.min(1, brand.c / FULL_HUE_CHROMA);\n}\n\nfunction surfaceSet(hue: number, mode: ThemeMode, tint: number, weight: number) {\n  const c = MAX_SURFACE_CHROMA * Math.max(0, Math.min(1, tint)) * weight;\n  const L = SURFACE_L[mode];\n  const bgPage = oklchToHex({ l: L.page, c, h: hue });\n  const bgSurface = oklchToHex({ l: L.surface, c, h: hue });\n  const bgSurface2 = oklchToHex({ l: L.surface2, c, h: hue });\n  // Solved, not guessed: a fixed lightness that looks right against a pale warm ground\n  // disappears against a deep cold one, and both are reachable from the same `hue`\n  // input. The border carries a little more chroma than the surfaces because at these\n  // lightnesses a perfectly neutral hairline on a tinted ground reads as a wrong grey.\n  const borderChroma = c * 1.6;\n  // Solved against the surface the hairline is HARDEST to see on, not against one of\n  // the three. Solving against `bgSurface` alone left it at 1.36:1 on `bgPage`, so the\n  // target and the audit disagreed about the same border.\n  const hardest = [bgPage, bgSurface, bgSurface2].reduce((a, b) =>\n    contrast(a, mode === \"light\" ? \"#000000\" : \"#ffffff\") < contrast(b, mode === \"light\" ? \"#000000\" : \"#ffffff\")\n      ? a\n      : b,\n  );\n  const borderL = solveLightness(\n    BORDER_CONTRAST,\n    parseHex(hardest)!,\n    hue,\n    borderChroma,\n    mode === \"light\" ? \"darker\" : \"lighter\",\n  );\n  return {\n    bgPage,\n    bgSurface,\n    bgSurface2,\n    border: oklchToHex({ l: borderL, c: borderChroma, h: hue }),\n  };\n}\n\n/** Solve a colour at this hue that clears `target` against `against`, keeping chroma. */\nfunction solveAgainst(hue: number, chroma: number, target: number, against: string, mode: ThemeMode): string {\n  const bg = parseHex(against)!;\n  const l = solveLightness(target, bg, hue, chroma, mode === \"light\" ? \"darker\" : \"lighter\");\n  return oklchToHex({ l, c: chroma, h: hue });\n}\n\n/** Whichever of near-white / near-black reads better ON `fill`. */\nfunction contrastOn(fill: string): string {\n  const light = \"#ffffff\";\n  const dark = \"#12100e\";\n  return contrast(fill, light) >= contrast(fill, dark) ? light : dark;\n}\n\n/** A soft tint of `hue` sitting on the surface — a badge fill, not a button fill. */\nfunction tintOn(hue: number, chroma: number, surface: string, mode: ThemeMode): string {\n  const s = hexToOklch(surface)!;\n  // Toward the colour, but only far enough to be seen: these back TEXT of the same hue,\n  // and a strong tint leaves the text nowhere to go.\n  const l = mode === \"light\" ? s.l - 0.055 : s.l + 0.055;\n  return oklchToHex({ l, c: Math.min(chroma * 0.45, 0.06), h: hue });\n}\n\nexport function derivePalette({ anchors, mode, surfaceTint = 0.55, textContrast }: DeriveOptions): DerivedPalette {\n  const warnings: string[] = [];\n  const brand = hexToOklch(anchors.brand);\n  if (!brand) {\n    throw new Error(\n      `derivePalette: brand \"${anchors.brand}\" is not a #rgb or #rrggbb colour. ` +\n        `Anchors must be hex — a named colour or an rgba() string cannot be converted.`,\n    );\n  }\n\n  const targets = { primary: 10, secondary: 7, muted: 4.6, ...textContrast };\n\n  // ── Surfaces, from the brand's hue.\n  const weight = hueWeight(brand);\n  const surfaces = surfaceSet(brand.h, mode, surfaceTint, weight);\n  // Every text role is solved against the WORST of the three, so a token is legible\n  // wherever it lands. Solving against `bgSurface` alone is the mistake that makes a\n  // muted label fail on the page background it also sits on.\n  const worstSurface = [surfaces.bgPage, surfaces.bgSurface, surfaces.bgSurface2].reduce((a, b) =>\n    contrast(a, mode === \"light\" ? \"#000000\" : \"#ffffff\") < contrast(b, mode === \"light\" ? \"#000000\" : \"#ffffff\")\n      ? a\n      : b,\n  );\n\n  // ── Text. A trace of the brand hue keeps the greys from reading cold on a warm page.\n  const textChroma = 0.014 * weight;\n  const textPrimary = solveAgainst(brand.h, textChroma, targets.primary, worstSurface, mode);\n  const textSecondary = solveAgainst(brand.h, textChroma, targets.secondary, worstSurface, mode);\n  const textMuted = solveAgainst(brand.h, textChroma, targets.muted, worstSurface, mode);\n\n  // The darkest fill text sits on (the lightest, in dark): the worst surface, or a\n  // hovered row on the card (`--bg-hover`), which in light is a shade darker than the\n  // page. The colours that are solved exactly to 4.5:1 — money, the semantic text — are\n  // solved against this, so they hold on a hovered row too (0.33, §12.10). The text\n  // roles above keep their margin (4.6:1 and up) and need no second solve.\n  const hover = hoverFill({ textPrimary, bgSurface: surfaces.bgSurface });\n  const worstText = [worstSurface, hover].reduce((a, b) =>\n    contrast(a, mode === \"light\" ? \"#000000\" : \"#ffffff\") < contrast(b, mode === \"light\" ? \"#000000\" : \"#ffffff\")\n      ? a\n      : b,\n  );\n\n  // ── Brand. Keep the hue the caller asked for; move only the lightness, and only as\n  // far as 3:1 against the worst surface — WCAG 1.4.11, since a brand-filled control is\n  // a graphical object whose boundary has to be perceivable.\n  //\n  // In light the worst surface includes More contrast's well (0.36, colour-roles §13.4):\n  // 10 % ink into the card, darker than the page. The step is applied, not derived, but\n  // the brand is not stepped, so both brand solves measure there too and a derived\n  // palette holds at both levels.\n  const moreWell = steppedWellFill({ textPrimary, bgSurface: surfaces.bgSurface });\n  const brandGround = moreWell\n    ? [worstSurface, moreWell].reduce((a, b) => (contrast(a, \"#000000\") < contrast(b, \"#000000\") ? a : b))\n    : worstSurface;\n  const brandChroma = Math.max(brand.c, 0.06);\n  const brandRatio = contrast(anchors.brand, brandGround);\n  // NORMALISED, never the caller's raw string. `parseHex` accepts \"4f46e5\" and \"#abc\",\n  // and passing either through unchanged put a value in the TokenSet that is not a CSS\n  // colour — it then fails silently at paint time, three layers from here.\n  let brandHex =\n    brandRatio >= 3 ? toHex(parseHex(anchors.brand)!) : solveAgainst(brand.h, brandChroma, 3, brandGround, mode);\n  if (brandRatio < 3) {\n    warnings.push(\n      `brand ${anchors.brand} sits at ${brandRatio.toFixed(2)}:1 against the ${mode} surfaces, ` +\n        `below the 3:1 WCAG 1.4.11 asks of a control boundary. Lightness was adjusted to ` +\n        `${brandHex}; hue and chroma are unchanged.`,\n    );\n  }\n  // `--brand-muted` is the brand AS TEXT — a soft brand chip's label, an outline chip, a\n  // current link — and tokens.css derives it: 62 % brand into the ink. A brand solved\n  // to 3:1 left it at 4.43–4.51:1 in three dark presets (0.33, §5.5), so it gets the\n  // text floor here: the brand moves away from the surfaces, a step at a time, until its\n  // muted form clears 4.5:1 on the worst fill and on its own soft chip, at rest\n  // (`--brand-bg`) and hovered (`--brand-bg-hover`, the harder of the two: §12.11).\n  const brandMutedWorst = (hex: string) => {\n    const soft = brandSoft({ brand: hex, textPrimary, bgSurface: surfaces.bgSurface });\n    return Math.min(\n      contrast(soft.brandMuted, worstText),\n      contrast(soft.brandMuted, soft.brandBg),\n      contrast(soft.brandMuted, soft.brandBgHover),\n      // …and on More contrast's light well, where a link button reads it (§13.3).\n      moreWell ? contrast(soft.brandMuted, moreWell) : Infinity,\n    );\n  };\n  for (let i = 0; i < 40 && brandMutedWorst(brandHex) < 4.5; i++) {\n    const lch = hexToOklch(brandHex)!;\n    brandHex = oklchToHex({ ...lch, l: mode === \"light\" ? lch.l - 0.005 : lch.l + 0.005 });\n  }\n  if (brandMutedWorst(brandHex) < 4.5) {\n    warnings.push(\n      `the brand as text (--brand-muted) reaches only ${brandMutedWorst(brandHex).toFixed(2)}:1 ` +\n        `against the ${mode} surfaces (needs 4.5:1).`,\n    );\n  }\n  const brandLch = hexToOklch(brandHex)!;\n  const brandContrast = contrastOn(brandHex);\n  const brandHover = oklchToHex({\n    ...brandLch,\n    // Hover moves AWAY from the colour of the text on it (0.33, §5.5): darker under\n    // white, lighter under a dark ink. It used to move away from the page, which in dark\n    // lightened a fill that carries WHITE text, toward its own label: 4.07:1.\n    l: brandContrast === \"#ffffff\" ? brandLch.l - 0.06 : brandLch.l + 0.06,\n  });\n  const onBrand = contrast(brandHex, brandContrast);\n  if (onBrand < 4.5) {\n    warnings.push(\n      `text on the brand fill reaches only ${onBrand.toFixed(2)}:1 (needs 4.5:1). ` +\n        `A mid-lightness, high-chroma brand cannot carry legible text at any ink; ` +\n        `use it as an accent and keep primary buttons on a darker or lighter variant.`,\n    );\n  }\n\n  // ── Semantic roles. Anchors are honoured exactly; the rest are placed away from the\n  // brand and from each other, within each role's licence to move.\n  const taken: number[] = [brandLch.h];\n  const accentLch = anchors.accent ? hexToOklch(anchors.accent) : null;\n  if (anchors.accent && !accentLch) {\n    warnings.push(`accent \"${anchors.accent}\" is not a hex colour and was ignored.`);\n  }\n  if (accentLch) taken.push(accentLch.h);\n\n  const semanticHue = {} as Record<Exclude<AnchorRole, \"brand\" | \"accent\">, number>;\n  const semanticChroma = {} as Record<Exclude<AnchorRole, \"brand\" | \"accent\">, number>;\n  for (const role of [\"danger\", \"warning\", \"success\", \"info\"] as const) {\n    const pinned = anchors[role] ? hexToOklch(anchors[role]!) : null;\n    if (anchors[role] && !pinned) {\n      warnings.push(`${role} \"${anchors[role]}\" is not a hex colour and was ignored.`);\n    }\n    const home = HUE_HOME[role];\n    const hue = pinned ? pinned.h : placeHue(home.hue, home.slack, taken);\n    if (!pinned) {\n      const gap = Math.min(...taken.map((t) => hueGap(hue, t)));\n      if (gap < 20) {\n        warnings.push(\n          `${role} could only reach ${gap.toFixed(0)}° from the nearest pinned hue, which is ` +\n            `too close to tell apart at a glance. Pin ${role} explicitly, or move the brand.`,\n        );\n      }\n    }\n    semanticHue[role] = hue;\n    semanticChroma[role] = pinned ? Math.max(pinned.c, 0.08) : 0.13;\n    taken.push(hue);\n  }\n\n  /**\n   * A semantic colour has two jobs and therefore two backgrounds: plain text on the\n   * page, and the label inside its own tinted badge. The badge is the harder of the\n   * two — it is a step toward the colour — so solving only against the surface produced\n   * a badge at 4.1:1 while the loose text passed, which is the failure mode that is\n   * hardest to notice because nine tenths of the uses look fine.\n   */\n  const sem = (role: Exclude<AnchorRole, \"brand\" | \"accent\">) => {\n    const hue = semanticHue[role];\n    const chroma = semanticChroma[role];\n    const bg = tintOn(hue, chroma, surfaces.bgSurface, mode);\n    const onSurface = solveLightness(4.5, parseHex(worstText)!, hue, chroma, mode === \"light\" ? \"darker\" : \"lighter\");\n    const onTint = solveLightness(4.5, parseHex(bg)!, hue, chroma, mode === \"light\" ? \"darker\" : \"lighter\");\n    const l = mode === \"light\" ? Math.min(onSurface, onTint) : Math.max(onSurface, onTint);\n    return oklchToHex({ l, c: chroma, h: hue });\n  };\n\n  const danger = sem(\"danger\");\n  const dangerLch = hexToOklch(danger)!;\n  const semantic: SemanticTokens = {\n    danger,\n    dangerHover: oklchToHex({\n      ...dangerLch,\n      l: mode === \"light\" ? dangerLch.l - 0.06 : dangerLch.l + 0.06,\n    }),\n    dangerContrast: contrastOn(danger),\n    // The tone border follows its siblings' lightness in dark mode (warning 0.44, info\n    // and success 0.45) — a soft frame; the strong line keeps the old, louder recipe.\n    dangerBorder: oklchToHex({\n      l: mode === \"light\" ? dangerLch.l + 0.22 : 0.45,\n      c: semanticChroma.danger,\n      h: semanticHue.danger,\n    }),\n    dangerBorderStrong: oklchToHex({\n      l: mode === \"light\" ? dangerLch.l + 0.22 : dangerLch.l - 0.22,\n      c: semanticChroma.danger,\n      h: semanticHue.danger,\n    }),\n    dangerBg: tintOn(semanticHue.danger, semanticChroma.danger, surfaces.bgSurface, mode),\n    warning: sem(\"warning\"),\n    warningBorder: oklchToHex({\n      l: mode === \"light\" ? 0.82 : 0.44,\n      c: semanticChroma.warning,\n      h: semanticHue.warning,\n    }),\n    warningBg: tintOn(semanticHue.warning, semanticChroma.warning, surfaces.bgSurface, mode),\n    info: sem(\"info\"),\n    infoBorder: oklchToHex({\n      l: mode === \"light\" ? 0.8 : 0.45,\n      c: semanticChroma.info,\n      h: semanticHue.info,\n    }),\n    infoBg: tintOn(semanticHue.info, semanticChroma.info, surfaces.bgSurface, mode),\n    success: sem(\"success\"),\n    successBorder: oklchToHex({\n      l: mode === \"light\" ? 0.81 : 0.45,\n      c: semanticChroma.success,\n      h: semanticHue.success,\n    }),\n    successBg: tintOn(semanticHue.success, semanticChroma.success, surfaces.bgSurface, mode),\n  };\n\n  if (accentLch) {\n    const accent = solveAgainst(accentLch.h, Math.max(accentLch.c, 0.06), 3, worstSurface, mode);\n    semantic.accent = accent;\n    semantic.accentContrast = contrastOn(accent);\n    semantic.accentBg = tintOn(accentLch.h, Math.max(accentLch.c, 0.06), surfaces.bgSurface, mode);\n  }\n\n  // ── Money. A THIRD system again: these are data colours with fixed meanings, and the\n  // one rule that outranks everything is that income and expense must never be the\n  // red/green pair — which is why the shipped presets use teal/amber/violet. Derived\n  // here at fixed hues rather than from the brand, for the same reason `--danger` is:\n  // a consumer who rebrands does not thereby change what \"money out\" looks like.\n  const money = (hue: number, target: number) => solveAgainst(hue, 0.12, target, worstText, mode);\n  const moneyIncome = money(175, 4.5);\n  const moneyExpense = money(70, 4.5);\n  const moneyNet = money(300, 4.5);\n  // \"No money has moved\": a quiet grey at a fixed lightness, but printed as TEXT (the\n  // numpad's sign, a future row's figure), so it gets the text floor too (0.33). The\n  // fixed lightness left it at 4.24:1 on four light pages.\n  const neutralChroma = 0.012 * weight;\n  const neutralFloor = solveLightness(\n    4.5,\n    parseHex(worstText)!,\n    brand.h,\n    neutralChroma,\n    mode === \"light\" ? \"darker\" : \"lighter\",\n  );\n  const moneyNeutral = oklchToHex({\n    l: mode === \"light\" ? Math.min(0.52, neutralFloor) : Math.max(0.72, neutralFloor),\n    c: neutralChroma,\n    h: brand.h,\n  });\n\n  const tokens: TokenSet = {\n    ...surfaces,\n    textPrimary,\n    textSecondary,\n    textMuted,\n    brand: brandHex,\n    brandHover,\n    brandContrast,\n    moneyIncome,\n    moneyExpense,\n    moneyNet,\n    moneyNeutral,\n    // Left alone. See the note at the top of this file about why the categorical ramp is\n    // not derived from the brand unless the caller asks.\n    //\n    // ⚠️ EMPTY, not absent: a caller who hands this straight to `applyTokenSet` keeps\n    // whatever `--chart-1…9` were already on the element. That is deliberate — the ramp\n    // is a separate decision and clearing it would leave charts unpainted — but it means\n    // a derived palette applied over another preset is a MIX until you also supply a\n    // ramp. `deriveChartRamp` is how you supply one.\n    chart: [],\n    heat: deriveHeat(moneyIncome, moneyExpense, surfaces, mode),\n  };\n\n  // Audited at both contrast levels (0.36, colour-roles §13.5): More contrast steps the\n  // text, the border and, in light, the well and money of this set. The derived semantic\n  // colours are audited at Standard only: they are solved for the standard grounds, and\n  // only tokens.css's shipped literals step for the darker well.\n  const standard = auditPalette(tokens, semantic);\n  const more = auditPalette(tokens, undefined, { level: \"more\" });\n  const checks = [...standard.checks, ...more.checks];\n  const failures = checks.filter((c) => !c.passes);\n  return { tokens, semantic, audit: { checks, failures, passes: failures.length === 0 }, warnings };\n}\n\n/**\n * Heatmap stops, reusing the money pair.\n *\n * `under` is the good direction and `over` the bad one, at the SAME hues as\n * `moneyIncome`/`moneyExpense` — so a heatmap cell and the figure printed beside it\n * agree about which way is which, rather than each inventing its own convention.\n */\nfunction deriveHeat(income: string, expense: string, surfaces: { bgSurface2: string }, mode: ThemeMode): HeatStops {\n  const exp = hexToOklch(expense)!;\n  return {\n    neutral: surfaces.bgSurface2,\n    under: income,\n    over: expense,\n    seqLow: oklchToHex({ l: mode === \"light\" ? 0.93 : 0.26, c: 0.05, h: exp.h }),\n    seqHigh: expense,\n    empty: mode === \"light\" ? \"rgba(120,110,95,0.14)\" : \"rgba(160,170,190,0.10)\",\n  };\n}\n\n/* ── Audit ────────────────────────────────────────────────────────────────── */\n\n/**\n * Measure every pair that has a requirement, and say which ones fail.\n *\n * This is the part the shipped presets were missing. `derivePalette` runs it on the way\n * out, and the preset test runs it over everything the package ships, so a palette that\n * does not hold up cannot be merged with a comment claiming that it does.\n *\n * **`level: \"more\"`** (0.36, docs/colour-roles-harmonization.md §13.5) measures the set as\n * More contrast paints it: the stepped secondary, muted and border, and in a light set the\n * stepped well (as `bgSurface2`) and money — the same pairs, named with a \" (More\n * contrast)\" suffix. Two things change with the level: the border is a field's boundary\n * there, held to WCAG 1.4.11's 3:1 rather than the hairline's 1.1, and a light set's well\n * must stand {@link WELL_STEP_MIN}:1 from the card. Pass `semantic` with tokens.css's More\n * literals for a light set (the status colours step there); the status text is then\n * measured on the stepped well too.\n */\nexport function auditPalette(\n  set: TokenSet,\n  semantic?: SemanticTokens,\n  options: { level?: ContrastLevel } = {},\n): ContrastReport {\n  const more = options.level === \"more\";\n  const step = more ? contrastStep(set) : null;\n  // The set as it paints at this level: what `applyTokenSet` writes for it.\n  const t: TokenSet = step\n    ? {\n        ...set,\n        textSecondary: step.textSecondary,\n        textMuted: step.textMuted,\n        border: step.border,\n        ...(step.well && {\n          bgSurface2: step.well.bgSurface2,\n          moneyIncome: step.well.moneyIncome,\n          moneyExpense: step.well.moneyExpense,\n          moneyNet: step.well.moneyNet,\n          moneyNeutral: step.well.moneyNeutral,\n        }),\n      }\n    : set;\n  const suffix = more ? \" (More contrast)\" : \"\";\n  const checks: ContrastCheck[] = [];\n  const surfaces: Array<[string, string]> = [\n    [\"bgPage\", t.bgPage],\n    [\"bgSurface\", t.bgSurface],\n    [\"bgSurface2\", t.bgSurface2],\n  ];\n  // A hovered row on the card (`--bg-hover`) carries the same text as the card, and in\n  // light it is the darkest fill that text sits on (0.33, §12.10). Text is measured on\n  // it; the brand fill and the hairline, which are not text, are not.\n  const hover = hoverFill(t);\n  const textGrounds: Array<[string, string]> = [...surfaces, [\"bgHover\", hover]];\n  // `--brand-muted`, `--brand-bg` and `--brand-bg-hover`, mixed as tokens.css mixes them.\n  const { brandMuted, brandBg, brandBgHover } = brandSoft(t);\n\n  // The 0.05 of slack is for a pair with a color-mix on one side, and only for that: the\n  // browser mixes in float and paints the result, where this mixes and rounds to hex, so\n  // the two can differ by a hair. Hex against hex is what the page paints, measured\n  // exactly — the slack used to cover those too, and passed the Contrast preset's dark\n  // brand fill at 2.998:1 (round 0.34 BUG-8).\n  const MIXED = /\\b(bgHover|brandMuted|brandBg|brandBgHover)\\b/;\n  const add = (pair: string, fg: string, bg: string, required: number, rule: string) => {\n    const ratio = contrast(fg, bg);\n    const slack = MIXED.test(pair) ? 0.05 : 0;\n    checks.push({ pair: pair + suffix, ratio, required, rule, passes: ratio >= required - slack });\n  };\n\n  for (const [name, bg] of surfaces) {\n    add(`brand on ${name}`, t.brand, bg, 3, \"WCAG 1.4.11 graphical object\");\n    if (more) add(`border on ${name}`, t.border, bg, 3, \"WCAG 1.4.11 — under More contrast a border bounds a field\");\n    else add(`border on ${name}`, t.border, bg, 1.1, \"house rule: a hairline must be findable\");\n  }\n  // The stepped light well, a hex `applyTokenSet` writes (§13.3, decision 2).\n  if (step?.well) {\n    add(\n      \"bgSurface2 on bgSurface\",\n      t.bgSurface2,\n      t.bgSurface,\n      WELL_STEP_MIN,\n      \"house rule: the well stands two hover steps from the card\",\n    );\n  }\n  for (const [name, bg] of textGrounds) {\n    add(`textPrimary on ${name}`, t.textPrimary, bg, 7, \"WCAG 1.4.6 AAA body text\");\n    add(`textSecondary on ${name}`, t.textSecondary, bg, 4.5, \"WCAG 1.4.3 AA body text\");\n    add(`textMuted on ${name}`, t.textMuted, bg, 4.5, \"WCAG 1.4.3 AA body text\");\n    add(`brandMuted on ${name}`, brandMuted, bg, 4.5, \"WCAG 1.4.3 — the brand as text\");\n    for (const [key, hex] of [\n      [\"moneyIncome\", t.moneyIncome],\n      [\"moneyExpense\", t.moneyExpense],\n      [\"moneyNet\", t.moneyNet],\n      // Not a figure's colour but still printed as one (the numpad's sign, a future\n      // row's amount) — measured since 0.33, when it was found at 4.24:1.\n      [\"moneyNeutral\", t.moneyNeutral],\n    ] as const) {\n      add(`${key} on ${name}`, hex, bg, 4.5, \"WCAG 1.4.3 — these are rendered as TEXT\");\n    }\n  }\n\n  add(\"brandContrast on brand\", t.brandContrast, t.brand, 4.5, \"WCAG 1.4.3 AA body text\");\n  // A hovered brand button carries the same label (0.33): the derived dark presets\n  // lightened the hover toward their white label and left it at 4.07:1.\n  add(\"brandContrast on brandHover\", t.brandContrast, t.brandHover, 4.5, \"WCAG 1.4.3 AA body text\");\n  add(\"brandMuted on brandBg\", brandMuted, brandBg, 4.5, \"WCAG 1.4.3 — a soft brand chip's label\");\n  // The same label on the chip hovered (§12.11): a current link, a selected day. At 70 %\n  // brand the muted text read 4.08–4.42:1 here (Default and Moss light; Ink, Moss, Plum\n  // and Contrast dark).\n  add(\"brandMuted on brandBgHover\", brandMuted, brandBgHover, 4.5, \"WCAG 1.4.3 — a hovered soft brand chip's label\");\n\n  if (semantic) {\n    for (const [name, fg] of [\n      [\"danger\", semantic.danger],\n      [\"warning\", semantic.warning],\n      [\"info\", semantic.info],\n      [\"success\", semantic.success],\n    ] as const) {\n      add(`${name} on bgSurface`, fg, t.bgSurface, 4.5, \"WCAG 1.4.3 — rendered as text\");\n      add(`${name} on bgHover`, fg, hover, 4.5, \"WCAG 1.4.3 — rendered as text, on a hovered row\");\n      // The darker light well the More literals were solved for (§13.3).\n      if (step?.well) add(`${name} on bgSurface2`, fg, t.bgSurface2, 4.5, \"WCAG 1.4.3 — rendered as text, on the well\");\n    }\n    add(\"danger on dangerBg\", semantic.danger, semantic.dangerBg, 4.5, \"WCAG 1.4.3 — badge text\");\n    add(\"warning on warningBg\", semantic.warning, semantic.warningBg, 4.5, \"WCAG 1.4.3 — badge text\");\n    add(\"info on infoBg\", semantic.info, semantic.infoBg, 4.5, \"WCAG 1.4.3 — badge text\");\n    add(\"success on successBg\", semantic.success, semantic.successBg, 4.5, \"WCAG 1.4.3 — badge text\");\n    add(\"dangerContrast on danger\", semantic.dangerContrast, semantic.danger, 4.5, \"WCAG 1.4.3 AA body text\");\n  }\n\n  const failures = checks.filter((c) => !c.passes);\n  return { checks, failures, passes: failures.length === 0 };\n}\n\n/* ── Categorical chart ramp ───────────────────────────────────────────────── */\n\nexport interface ChartRampReport {\n  colors: string[];\n  /** Series pairs that are too close under normal vision or any simulated CVD. */\n  collisions: Array<{ a: number; b: number; under: \"normal\" | CvdType; distance: number }>;\n  /** Series that do not clear 3:1 against a surface they may be drawn on. */\n  lowContrast: Array<{ index: number; surface: string; ratio: number }>;\n  /** The worst pairwise separation, across normal vision and all three dichromacies. */\n  minSeparation: number;\n  /** The worst contrast any series reaches against any surface it was measured on. */\n  minContrast: number;\n  passes: boolean;\n}\n\n/**\n * The floor for pairwise separation in OKLab, across normal vision and each dichromacy.\n *\n * CALIBRATED, not chosen. Paul Tol's \"Muted\" set — which this package ships and which is\n * a well-regarded CVD-safe palette — bottoms out at 0.059 in its light variant and 0.032\n * in the lightened dark one. A threshold above 0.059 would fail a palette that is known\n * to work, which is worse than having no check at all: an audit that cries wolf gets\n * switched off. 0.05 sits just under the known-good case.\n */\nconst MIN_SEPARATION = 0.05;\n\n/**\n * **The categorical trade-off, measured.** At a SINGLE lightness, the most series that\n * can satisfy both the 3:1 fill contrast of WCAG 1.4.11 and {@link MIN_SEPARATION} under\n * dichromacy is FOUR. Searched exhaustively over starting hue and lightness:\n *\n *   n=4  best separation 0.065  — both satisfiable\n *   n=5  best separation 0.041  — not satisfiable\n *   n=9  best separation 0.015  — not satisfiable\n *\n * The reason is structural: dichromacy collapses the red-green axis, so hue alone stops\n * distinguishing colours once you need more than a handful, and the remaining channel is\n * LIGHTNESS — the very thing a uniform-contrast ramp holds constant. Paul Tol's set\n * varies lightness deliberately and pays for it in contrast; that is not an oversight in\n * their palette, it is the only currency left.\n *\n * So above four series this deriver varies lightness too, and reports what it gave up\n * rather than pretending both constraints were met.\n *\n * NOTE ON WHAT THIS BOUND IS. It describes the PROBLEM, not a guarantee about\n * {@link deriveChartRamp}. That function fixes lightness and starts the hue wheel at the\n * brand's own hue rather than searching for the best start, so it reaches the bound only\n * where the brand happens to sit well: sweeping 72 brand hues against the default light\n * surfaces, 7 of 72 produced a passing 4-series ramp (12 of 72 on dark), and none passed\n * at 5 or 9. Read the report it returns; do not assume a pass.\n */\nconst SINGLE_LIGHTNESS_MAX_SERIES = 4;\n\n/**\n * A categorical ramp of `count` hues, evenly spaced and equal in perceived lightness,\n * then MEASURED for separability — including under each dichromacy.\n *\n * Offered but not used by default, and the distinction matters. Evenly spaced hues at\n * one lightness are a reasonable generic answer; Paul Tol's \"Muted\" set, which this\n * package ships, is a better specific one, because it was optimised against real\n * confusion lines rather than derived from a formula. So this exists for a consumer who\n * wants their charts to follow their brand and is willing to read the report — not as\n * a silent upgrade to the default.\n */\nexport function deriveChartRamp(brandHex: string, mode: ThemeMode, surfaces: string[], count = 9): ChartRampReport {\n  const brand = hexToOklch(brandHex) ?? { l: 0.6, c: 0.12, h: 264 };\n  const base = mode === \"light\" ? 0.58 : 0.74;\n  const c = Math.max(0.09, Math.min(brand.c, 0.15));\n  // Up to four series, one lightness: a scale that varies lightness implies rank, and a\n  // categorical one must not. Beyond four, lightness is the only channel left that\n  // survives dichromacy — see SINGLE_LIGHTNESS_MAX_SERIES — so it alternates in a\n  // three-step cycle, which keeps ADJACENT series (the ones a legend puts side by side)\n  // at different lightnesses as well as different hues.\n  const vary = count > SINGLE_LIGHTNESS_MAX_SERIES;\n  const offsets = [0, mode === \"light\" ? -0.1 : 0.1, mode === \"light\" ? 0.08 : -0.08];\n  const colors = Array.from({ length: count }, (_, i) =>\n    oklchToHex({\n      l: vary ? base + offsets[i % offsets.length] : base,\n      c,\n      h: (brand.h + (360 / count) * i) % 360,\n    }),\n  );\n\n  return measureRamp(colors, surfaces);\n}\n\n/** Audit a ramp somebody else chose — the shipped Paul Tol set, say. */\nexport function auditChartRamp(colors: string[], surfaces: string[]): ChartRampReport {\n  return measureRamp(colors, surfaces);\n}\n\nfunction measureRamp(colors: string[], surfaces: string[]): ChartRampReport {\n  const collisions: ChartRampReport[\"collisions\"] = [];\n  const rgbs = colors.map((hex) => parseHex(hex)).filter((v): v is NonNullable<typeof v> => !!v);\n  let minSeparation = Infinity;\n  for (let i = 0; i < rgbs.length; i++) {\n    for (let j = i + 1; j < rgbs.length; j++) {\n      const normal = deltaE(rgbs[i], rgbs[j]);\n      minSeparation = Math.min(minSeparation, normal);\n      if (normal < MIN_SEPARATION) {\n        collisions.push({ a: i, b: j, under: \"normal\", distance: normal });\n      }\n      for (const type of [\"protanopia\", \"deuteranopia\", \"tritanopia\"] as const) {\n        const d = deltaE(simulateCvd(rgbs[i], type), simulateCvd(rgbs[j], type));\n        minSeparation = Math.min(minSeparation, d);\n        if (d < MIN_SEPARATION) collisions.push({ a: i, b: j, under: type, distance: d });\n      }\n    }\n  }\n\n  const lowContrast: ChartRampReport[\"lowContrast\"] = [];\n  let minContrast = Infinity;\n  colors.forEach((hex, index) => {\n    for (const surface of surfaces) {\n      const ratio = contrast(hex, surface);\n      minContrast = Math.min(minContrast, ratio);\n      // WCAG 1.4.11: a graphical object carrying meaning needs 3:1 against what is\n      // adjacent to it. A bar the same value as the card behind it has no boundary.\n      if (ratio < 3) lowContrast.push({ index, surface, ratio });\n    }\n  });\n\n  return {\n    colors,\n    collisions,\n    lowContrast,\n    minSeparation: Number.isFinite(minSeparation) ? minSeparation : 0,\n    minContrast: Number.isFinite(minContrast) ? minContrast : 0,\n    passes: collisions.length === 0 && lowContrast.length === 0,\n  };\n}\n\n/** Convenience: the OKLCH of a hex, for a caller inspecting an anchor. */\nexport function describe(hex: string): Oklch | null {\n  const rgb = parseHex(hex);\n  return rgb ? rgbToOklch(rgb) : null;\n}\n"],"mappings":"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","names":[]}