@adea-ai/ui 0.123.1 → 0.125.0

package/dist/lib/accent-roles.js

@@ -0,0 +1,163 @@
+import { ACCENTS, accentRoles, accentValue, primarySubtleCss } from "@adea-ai/themes";
+import { contrastRatio, oklchToHex, parseColor, repairContrast } from "@adea-ai/themes/oklch";
+//#region src/lib/accent-roles.ts
+var WHITE_OKLCH = {
+	l: 1,
+	c: 0,
+	h: 0
+};
+/**
+* The nearest colour to `source` that reaches `minimum` against `canvas`, as hex.
+*
+* The catalogue's `repairContrast` is asked for a little more than the floor, in
+* 0.001 steps up to 0.05, because the result is rounded to 8-bit hex and the
+* rounded colour is what is measured: asking for exactly the floor can land a hair
+* under it after rounding. If nothing in that range survives the rounding, white or
+* black stands in, whichever clears the floor.
+*/
+function repairedHex(source, canvas, minimum) {
+	for (let margin = 0; margin <= .05; margin = Number((margin + .001).toFixed(3))) {
+		const repaired = repairContrast(source, canvas, minimum + margin);
+		if (!repaired.satisfied) continue;
+		const hex = oklchToHex(repaired.color);
+		const rounded = parseColor(hex);
+		if (rounded && contrastRatio(rounded, canvas) >= minimum) return hex;
+	}
+	return contrastRatio(WHITE_OKLCH, canvas) >= minimum ? "#ffffff" : "#000000";
+}
+/**
+* The stored form of a custom accent: `#rrggbb`, six digits, opaque, lower case.
+*
+* Deliberately narrower than {@link parseColor}. A stored accent is compared,
+* deduplicated and used as an attribute, so it has one spelling; a host that
+* accepts `#abc` in a field expands it before storing. Anything else — a name, an
+* `rgb()`, a short or alpha form, a non-string — is not an accent and returns
+* `undefined`.
+*/
+function normalizeCustomAccent(value) {
+	return typeof value === "string" && /^#[0-9a-fA-F]{6}$/.test(value) ? value.toLowerCase() : void 0;
+}
+/** Whether a selection's accent is the custom `#rrggbb` form (any letter case). */
+function isCustomAccent(value) {
+	return normalizeCustomAccent(value) !== void 0;
+}
+function appearanceOf(target) {
+	return typeof target === "string" ? target : target.appearance;
+}
+/**
+* `value` raised to `floor` against `background` as hex, or `value` itself when it
+* already clears the floor, is not a colour, or there is no surface to measure it on.
+*
+* Returning the argument itself is what makes the floor the identity for a preset
+* that already reads: the caller compares and keeps the catalogue's own roles.
+*/
+function gateColor(value, background, floor) {
+	const source = parseColor(value);
+	const canvas = background ? parseColor(background) : void 0;
+	if (!source || !canvas) return value;
+	if (contrastRatio(source, canvas) >= floor) return value;
+	return repairedHex(source, canvas, floor);
+}
+/**
+* The roles for a preset (or a custom colour made into one), held to the floor.
+*
+* A preset that clears the floor keeps the catalogue's roles untouched. One that
+* does not is repaired to the nearest passing colour and the whole role set is
+* rebuilt from the repaired value, so the label, hover and ring follow it instead
+* of describing a colour that is no longer on screen.
+*/
+function accentRolesForPreset(preset, context) {
+	const appearance = appearanceOf(context.target);
+	const requested = accentValue(preset, appearance);
+	if (!parseColor(requested)) return void 0;
+	const floor = context.floor;
+	if (floor === void 0) return accentRoles(preset, context.target);
+	const gated = gateColor(requested, context.background, floor);
+	if (gated === requested) return accentRoles(preset, context.target);
+	return {
+		...accentRoles({
+			...preset,
+			light: gated,
+			dark: gated
+		}, context.target),
+		primarySubtle: primarySubtleCss(context.target, "--primary", [gated])
+	};
+}
+/**
+* Resolve an accent selection to its roles, or `undefined` when it overrides nothing.
+*
+* `undefined` is "use the theme's own primary": the literal `theme`, an id that is
+* neither a preset, an offered theme accent nor a colour, and a colour that does not
+* parse. A host that wants one of those to mean something else decides before
+* asking (Adea's codec maps a stored `theme` to its default preset when it reads).
+*/
+function resolveAccentRoles(accent, context) {
+	if (accent === "theme") return void 0;
+	const custom = normalizeCustomAccent(accent);
+	if (custom) {
+		const floor = context.floor ?? 3;
+		return accentRolesForPreset({
+			id: "custom",
+			label: "Custom",
+			description: "",
+			light: custom,
+			dark: custom
+		}, {
+			...context,
+			floor
+		});
+	}
+	const preset = ACCENTS.find((candidate) => candidate.id === accent) ?? context.themeAccents?.find((candidate) => candidate.id === accent);
+	return preset ? accentRolesForPreset(preset, context) : void 0;
+}
+/**
+* The custom properties an accent override owns on `<html>`.
+*
+* `--primary-subtle` is deliberately not among them. It is a `color-mix()` over
+* `var(--primary)`, so on the same element it follows an accent by itself, and its
+* strength is the theme's, measured to keep body text at 4.5:1 on the tint.
+* Writing one here would replace that measurement with the argument's.
+*/
+function accentOverrideVariables(roles) {
+	return {
+		"--primary": roles.primary,
+		"--primary-foreground": roles.primaryForeground,
+		"--primary-hover": roles.primaryHover,
+		"--ring": roles.ring
+	};
+}
+/** The custom properties {@link paintAccentRoles} writes and clears. */
+var ACCENT_PAINT_PROPERTIES = [
+	"--primary",
+	"--primary-foreground",
+	"--primary-hover",
+	"--primary-subtle",
+	"--ring"
+];
+/**
+* Scope an accent to one element and its descendants.
+*
+* Unlike the document, an element must write `--primary-subtle` too. A custom
+* property that uses `var()` is resolved where it is declared, so the tint inherited
+* from `<html>` is already a mix over *`<html>`'s* primary and an element that only
+* overrides `--primary` would keep the old tint. Declared here, the same expression
+* resolves against this element's primary.
+*
+* `undefined` clears every property, and the element inherits the document's accent
+* again.
+*/
+function paintAccentRoles(element, roles) {
+	if (!roles) {
+		for (const property of ACCENT_PAINT_PROPERTIES) element.style.removeProperty(property);
+		return;
+	}
+	element.style.setProperty("--primary", roles.primary);
+	element.style.setProperty("--primary-foreground", roles.primaryForeground);
+	element.style.setProperty("--primary-hover", roles.primaryHover);
+	element.style.setProperty("--primary-subtle", roles.primarySubtle);
+	element.style.setProperty("--ring", roles.ring);
+}
+//#endregion
+export { ACCENT_PAINT_PROPERTIES, accentOverrideVariables, accentRolesForPreset, isCustomAccent, normalizeCustomAccent, paintAccentRoles, resolveAccentRoles };
+
+//# sourceMappingURL=accent-roles.js.map

package/dist/lib/accent-roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accent-roles.js","names":["parseCanonicalColor","canonicalContrastRatio"],"sources":["../../src/lib/accent-roles.ts"],"sourcesContent":["/*\n * Copyright (c) 2026 Wing\n * SPDX-License-Identifier: MIT\n *\n * The colour helpers, the contrast gate and the custom-accent grammar are\n * substantially translated from Zeron's `Color` and `AccentRoles`\n * (https://github.com/zeronsh/zeron), as Adea's accepted port of them in\n * `packages/ui/src/components/appearance.ts` expresses it. Extracted here so the\n * shared provider and Adea run one implementation; `@adea-ai/themes` owns the\n * colour engine (parsing, contrast, repair, the preset values and their roles).\n * See NOTICE.\n */\n\nimport {\n  ACCENTS,\n  accentRoles,\n  accentValue,\n  primarySubtleCss,\n  type AccentPreset,\n  type AccentRoles as CatalogueAccentRoles,\n} from '@adea-ai/themes'\nimport {\n  contrastRatio as canonicalContrastRatio,\n  oklchToHex,\n  parseColor as parseCanonicalColor,\n  repairContrast,\n  type Oklch,\n} from '@adea-ai/themes/oklch'\nimport type { ThemeAppearance } from './themes'\n\n/**\n * Accent colour maths and the roles an accent paints.\n *\n * Three questions live here, and none of them touches the document or a signal:\n *\n *   - **What colour is this?** `parseColor`, `colorToHex`, `contrastRatio` and\n *     `ensureContrast` are the hex helpers a host needs around an accent (an\n *     imported theme's colours, a colour field). Hex is the host preference format;\n *     the catalogue's colour engine does the maths.\n *   - **Is this accent readable on this surface?** The *contrast floor*. A preset is\n *     curated, so the catalogue already measured it against its own themes and the\n *     floor is the identity for it; a custom `#rrggbb` is anyone's choice, so it is\n *     raised until it clears the floor and can never ship unreadable. A host that\n *     imports themes (whose backgrounds the catalogue never saw) turns the floor on\n *     for presets too.\n *   - **Which custom properties does an accent own?** `AccentRoles`, written on\n *     `<html>` by the provider and onto one element by {@link paintAccentRoles}.\n */\n\n/* Hex is the host preference format; the shared Themes package owns colour maths. */\n\nexport type RgbColor = Readonly<{ r: number; g: number; b: number; a: number }>\n\nconst HEX = /^#([0-9a-fA-F]+)$/\n\n/** Parse a hex colour (`#rgb`, `#rgba`, `#rrggbb`, `#rrggbbaa`). `undefined` for anything else. */\nexport function parseColor(value: string): RgbColor | undefined {\n  const match = HEX.exec(value.trim())\n  const digits = match?.[1]\n  if (!digits) return undefined\n  if (digits.length === 3 || digits.length === 4) {\n    // Each nibble is doubled: `#abc` is `#aabbcc`.\n    const [r, g, b, a] = [...digits].map((digit) => Number.parseInt(digit + digit, 16))\n    return { r: r!, g: g!, b: b!, a: a ?? 255 }\n  }\n  if (digits.length === 6 || digits.length === 8) {\n    const byte = (index: number) => Number.parseInt(digits.slice(index, index + 2), 16)\n    return { r: byte(0), g: byte(2), b: byte(4), a: digits.length === 8 ? byte(6) : 255 }\n  }\n  return undefined\n}\n\nfunction toHexByte(value: number): string {\n  return value.toString(16).padStart(2, '0')\n}\n\n/** `#rrggbb`, or `#rrggbbaa` when the colour is not opaque. */\nexport function colorToHex(color: RgbColor): string {\n  const opaque = `#${toHexByte(color.r)}${toHexByte(color.g)}${toHexByte(color.b)}`\n  return color.a === 255 ? opaque : `${opaque}${toHexByte(color.a)}`\n}\n\nfunction blendOver(foreground: RgbColor, background: RgbColor): RgbColor {\n  const alpha = foreground.a / 255\n  const blend = (front: number, back: number) => Math.round(front * alpha + back * (1 - alpha))\n  return {\n    r: blend(foreground.r, background.r),\n    g: blend(foreground.g, background.g),\n    b: blend(foreground.b, background.b),\n    a: 255,\n  }\n}\n\nfunction toCanonicalColor(color: RgbColor): Oklch | undefined {\n  return parseCanonicalColor(colorToHex({ ...color, a: 255 }))\n}\n\n/** WCAG contrast ratio between two colours. Alpha composites over the background first. */\nexport function contrastRatio(\n  foreground: RgbColor | string,\n  background: RgbColor | string\n): number {\n  const front = typeof foreground === 'string' ? parseColor(foreground) : foreground\n  const back = typeof background === 'string' ? parseColor(background) : background\n  if (!front || !back) return 0\n  const opaqueFront = front.a === 255 ? front : blendOver(front, back)\n  const foregroundColor = toCanonicalColor(opaqueFront)\n  const backgroundColor = toCanonicalColor(back)\n  if (!foregroundColor || !backgroundColor) return 0\n  return canonicalContrastRatio(foregroundColor, backgroundColor)\n}\n\nconst WHITE: RgbColor = { r: 255, g: 255, b: 255, a: 255 }\nconst WHITE_OKLCH: Oklch = { l: 1, c: 0, h: 0 }\n\n/**\n * The nearest colour to `source` that reaches `minimum` against `canvas`, as hex.\n *\n * The catalogue's `repairContrast` is asked for a little more than the floor, in\n * 0.001 steps up to 0.05, because the result is rounded to 8-bit hex and the\n * rounded colour is what is measured: asking for exactly the floor can land a hair\n * under it after rounding. If nothing in that range survives the rounding, white or\n * black stands in, whichever clears the floor.\n */\nfunction repairedHex(source: Oklch, canvas: Oklch, minimum: number): string {\n  for (let margin = 0; margin <= 0.05; margin = Number((margin + 0.001).toFixed(3))) {\n    const repaired = repairContrast(source, canvas, minimum + margin)\n    if (!repaired.satisfied) continue\n    const hex = oklchToHex(repaired.color)\n    const rounded = parseCanonicalColor(hex)\n    if (rounded && canonicalContrastRatio(rounded, canvas) >= minimum) return hex\n  }\n  return canonicalContrastRatio(WHITE_OKLCH, canvas) >= minimum ? '#ffffff' : '#000000'\n}\n\n/** Preserve the host hex shape while delegating contrast repair to the catalogue. */\nexport function ensureContrast(color: RgbColor, background: RgbColor, minimum: number): RgbColor {\n  if (contrastRatio(color, background) >= minimum) return color\n\n  const renderedColor = color.a === 255 ? color : blendOver(color, background)\n  const source = toCanonicalColor(renderedColor)\n  const canvas = toCanonicalColor(background)\n  if (!source || !canvas) return color\n  return parseColor(repairedHex(source, canvas, minimum))!\n}\n\n/** The contrast an accent is held to against its surface unless the host sets another. */\nexport const DEFAULT_ACCENT_CONTRAST_FLOOR = 3\n\n/**\n * Normalise a custom accent against a surface: unparseable input is rejected\n * (`undefined`), and any accepted colour is raised to `minimum` so an accent can\n * never ship unreadable. Accepts every CSS hex length; for the stored grammar use\n * {@link normalizeCustomAccent}.\n */\nexport function normalizeAccentValue(\n  value: string,\n  background: string,\n  minimum: number = DEFAULT_ACCENT_CONTRAST_FLOOR\n): string | undefined {\n  const parsed = parseColor(value)\n  if (!parsed) return undefined\n  const backdrop = parseColor(background) ?? WHITE\n  return colorToHex(ensureContrast(parsed, backdrop, minimum))\n}\n\n/**\n * The stored form of a custom accent: `#rrggbb`, six digits, opaque, lower case.\n *\n * Deliberately narrower than {@link parseColor}. A stored accent is compared,\n * deduplicated and used as an attribute, so it has one spelling; a host that\n * accepts `#abc` in a field expands it before storing. Anything else — a name, an\n * `rgb()`, a short or alpha form, a non-string — is not an accent and returns\n * `undefined`.\n */\nexport function normalizeCustomAccent(value: unknown): string | undefined {\n  return typeof value === 'string' && /^#[0-9a-fA-F]{6}$/.test(value)\n    ? value.toLowerCase()\n    : undefined\n}\n\n/** Whether a selection's accent is the custom `#rrggbb` form (any letter case). */\nexport function isCustomAccent(value: unknown): boolean {\n  return normalizeCustomAccent(value) !== undefined\n}\n\n/**\n * The roles an accent paints, as CSS values: the catalogue's `AccentRoles`, so the\n * provider, the generated stylesheet and a host's own paint cannot disagree about\n * what a role is. `primarySubtle` is an expression over `var(--primary)`; the\n * document writer never sets it (see {@link accentOverrideVariables}), an element\n * paint must.\n */\nexport type AccentRoles = CatalogueAccentRoles\n\n/** What an accent resolves against: the surface it sits on and the theme it sits in. */\nexport type AccentTarget = {\n  /** The theme, or only its appearance. A theme gives the tint its measured strength. */\n  target: Parameters<typeof accentRoles>[1]\n  /** The surface the accent must read on. Without it nothing can be measured or repaired. */\n  background: string | undefined\n  /**\n   * The contrast to hold the accent to against `background`. Absent, a preset is\n   * painted verbatim and a custom colour is held to {@link DEFAULT_ACCENT_CONTRAST_FLOOR}.\n   */\n  floor?: number\n  /**\n   * The accents the selected theme pair carries (`ansi-blue`…), for an id that is\n   * neither a preset nor a colour.\n   */\n  themeAccents?: readonly AccentPreset[]\n}\n\nfunction appearanceOf(target: AccentTarget['target']): ThemeAppearance {\n  return typeof target === 'string' ? target : target.appearance\n}\n\n/**\n * `value` raised to `floor` against `background` as hex, or `value` itself when it\n * already clears the floor, is not a colour, or there is no surface to measure it on.\n *\n * Returning the argument itself is what makes the floor the identity for a preset\n * that already reads: the caller compares and keeps the catalogue's own roles.\n */\nfunction gateColor(value: string, background: string | undefined, floor: number): string {\n  const source = parseCanonicalColor(value)\n  const canvas = background ? parseCanonicalColor(background) : undefined\n  if (!source || !canvas) return value\n  if (canonicalContrastRatio(source, canvas) >= floor) return value\n  return repairedHex(source, canvas, floor)\n}\n\n/**\n * The roles for a preset (or a custom colour made into one), held to the floor.\n *\n * A preset that clears the floor keeps the catalogue's roles untouched. One that\n * does not is repaired to the nearest passing colour and the whole role set is\n * rebuilt from the repaired value, so the label, hover and ring follow it instead\n * of describing a colour that is no longer on screen.\n */\nexport function accentRolesForPreset(\n  preset: AccentPreset,\n  context: AccentTarget\n): AccentRoles | undefined {\n  const appearance = appearanceOf(context.target)\n  const requested = accentValue(preset, appearance)\n  if (!parseCanonicalColor(requested)) return undefined\n\n  const floor = context.floor\n  if (floor === undefined) return accentRoles(preset, context.target)\n\n  const gated = gateColor(requested, context.background, floor)\n  if (gated === requested) return accentRoles(preset, context.target)\n\n  const roles = accentRoles({ ...preset, light: gated, dark: gated }, context.target)\n  // The tint's strength is measured against the primary it will sit over, and the\n  // repaired primary is not one the theme's own measurement saw.\n  return { ...roles, primarySubtle: primarySubtleCss(context.target, '--primary', [gated]) }\n}\n\n/**\n * Resolve an accent selection to its roles, or `undefined` when it overrides nothing.\n *\n * `undefined` is \"use the theme's own primary\": the literal `theme`, an id that is\n * neither a preset, an offered theme accent nor a colour, and a colour that does not\n * parse. A host that wants one of those to mean something else decides before\n * asking (Adea's codec maps a stored `theme` to its default preset when it reads).\n */\nexport function resolveAccentRoles(accent: string, context: AccentTarget): AccentRoles | undefined {\n  if (accent === 'theme') return undefined\n\n  const custom = normalizeCustomAccent(accent)\n  if (custom) {\n    const floor = context.floor ?? DEFAULT_ACCENT_CONTRAST_FLOOR\n    return accentRolesForPreset(\n      { id: 'custom', label: 'Custom', description: '', light: custom, dark: custom },\n      { ...context, floor }\n    )\n  }\n\n  const preset =\n    ACCENTS.find((candidate) => candidate.id === accent) ??\n    context.themeAccents?.find((candidate) => candidate.id === accent)\n  return preset ? accentRolesForPreset(preset, context) : undefined\n}\n\n/**\n * The custom properties an accent override owns on `<html>`.\n *\n * `--primary-subtle` is deliberately not among them. It is a `color-mix()` over\n * `var(--primary)`, so on the same element it follows an accent by itself, and its\n * strength is the theme's, measured to keep body text at 4.5:1 on the tint.\n * Writing one here would replace that measurement with the argument's.\n */\nexport function accentOverrideVariables(roles: AccentRoles): Record<string, string> {\n  return {\n    '--primary': roles.primary,\n    '--primary-foreground': roles.primaryForeground,\n    '--primary-hover': roles.primaryHover,\n    '--ring': roles.ring,\n  }\n}\n\n/** The custom properties {@link paintAccentRoles} writes and clears. */\nexport const ACCENT_PAINT_PROPERTIES = [\n  '--primary',\n  '--primary-foreground',\n  '--primary-hover',\n  '--primary-subtle',\n  '--ring',\n] as const\n\n/**\n * Scope an accent to one element and its descendants.\n *\n * Unlike the document, an element must write `--primary-subtle` too. A custom\n * property that uses `var()` is resolved where it is declared, so the tint inherited\n * from `<html>` is already a mix over *`<html>`'s* primary and an element that only\n * overrides `--primary` would keep the old tint. Declared here, the same expression\n * resolves against this element's primary.\n *\n * `undefined` clears every property, and the element inherits the document's accent\n * again.\n */\nexport function paintAccentRoles(\n  element: { style: Pick<CSSStyleDeclaration, 'setProperty' | 'removeProperty'> },\n  roles: AccentRoles | undefined\n): void {\n  if (!roles) {\n    for (const property of ACCENT_PAINT_PROPERTIES) element.style.removeProperty(property)\n    return\n  }\n  element.style.setProperty('--primary', roles.primary)\n  element.style.setProperty('--primary-foreground', roles.primaryForeground)\n  element.style.setProperty('--primary-hover', roles.primaryHover)\n  element.style.setProperty('--primary-subtle', roles.primarySubtle)\n  element.style.setProperty('--ring', roles.ring)\n}\n"],"mappings":"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"}

package/dist/lib/appearance-font-settings.d.ts

@@ -38,7 +38,7 @@ export declare function normalizeAppearanceEditorFontSettings(value: unknown, le
  * sizes, and projected CSS variables. The marker activates the optional role
  * stylesheet and survives CSS import reordering.
  */
-export declare function applyAppearanceFontSettings(root: HTMLElement, value: unknown): NormalizedAppearanceEditorFontSettings;
+export declare function applyAppearanceFontSettings(root: Pick<HTMLElement, 'removeAttribute' | 'setAttribute' | 'style'>, value: unknown): NormalizedAppearanceEditorFontSettings;
 /**
  * Generate a safe inline prepaint script for a host-owned appearance record.
  *

package/dist/lib/appearance-font-settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appearance-font-settings.d.ts","sourceRoot":"","sources":["../../src/lib/appearance-font-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGhE,eAAO,MAAM,2BAA2B,oCAAqC,CAAA;AAE7E,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAA;AACnF,MAAM,MAAM,4BAA4B,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;AAE3D,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IACjD,6EAA6E;IAC7E,MAAM,EAAE,4BAA4B,CAAA;IACpC,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;CACb,CAAC,CAAA;AAEF,0EAA0E;AAC1E,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CACjD,MAAM,CAAC,wBAAwB,EAAE,2BAA2B,CAAC,CAC9D,CAAA;AAED,eAAO,MAAM,+BAA+B,KAAK,CAAA;AACjD,eAAO,MAAM,+BAA+B,KAAK,CAAA;AAEjD,+DAA+D;AAC/D,eAAO,MAAM,uCAAuC,EAAE,4BAIpD,CAAA;AAEF,MAAM,MAAM,sCAAsC,GAAG,QAAQ,CAAC;IAC5D,QAAQ,EAAE,4BAA4B,CAAA;IACtC,iFAAiF;IACjF,aAAa,EAAE,SAAS,wBAAwB,EAAE,CAAA;CACnD,CAAC,CAAA;AAqEF,oFAAoF;AACpF,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ1F;AAED;;;;;;;GAOG;AACH,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,OAAO,EACd,cAAc,CAAC,EAAE,OAAO,GACvB,sCAAsC,CA+CxC;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,OAAO,GACb,sCAAsC,CAsBxC;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAajG"}
+{"version":3,"file":"appearance-font-settings.d.ts","sourceRoot":"","sources":["../../src/lib/appearance-font-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGhE,eAAO,MAAM,2BAA2B,oCAAqC,CAAA;AAE7E,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAA;AACnF,MAAM,MAAM,4BAA4B,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;AAE3D,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IACjD,6EAA6E;IAC7E,MAAM,EAAE,4BAA4B,CAAA;IACpC,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;CACb,CAAC,CAAA;AAEF,0EAA0E;AAC1E,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CACjD,MAAM,CAAC,wBAAwB,EAAE,2BAA2B,CAAC,CAC9D,CAAA;AAED,eAAO,MAAM,+BAA+B,KAAK,CAAA;AACjD,eAAO,MAAM,+BAA+B,KAAK,CAAA;AAEjD,+DAA+D;AAC/D,eAAO,MAAM,uCAAuC,EAAE,4BAIpD,CAAA;AAEF,MAAM,MAAM,sCAAsC,GAAG,QAAQ,CAAC;IAC5D,QAAQ,EAAE,4BAA4B,CAAA;IACtC,iFAAiF;IACjF,aAAa,EAAE,SAAS,wBAAwB,EAAE,CAAA;CACnD,CAAC,CAAA;AAqEF,oFAAoF;AACpF,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ1F;AAED;;;;;;;GAOG;AACH,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,OAAO,EACd,cAAc,CAAC,EAAE,OAAO,GACvB,sCAAsC,CA+CxC;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,iBAAiB,GAAG,cAAc,GAAG,OAAO,CAAC,EACrE,KAAK,EAAE,OAAO,GACb,sCAAsC,CAsBxC;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAajG"}

package/dist/lib/appearance-font-settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"appearance-font-settings.js","names":[],"sources":["../../src/lib/appearance-font-settings.ts"],"sourcesContent":["import { fontOptions, type FontOption } from '#lib/font-catalog'\nimport { safeScriptStringLiteral } from '#lib/safe-script'\n\nexport const APPEARANCE_EDITOR_FONT_AXES = ['ui', 'content', 'code'] as const\n\nexport type AppearanceEditorFontAxis = (typeof APPEARANCE_EDITOR_FONT_AXES)[number]\nexport type AppearanceEditorFontFamilyId = FontOption['id']\n\nexport type AppearanceEditorFontSetting = Readonly<{\n  /** A stable id from the shared font catalogue, never a CSS family string. */\n  family: AppearanceEditorFontFamilyId\n  /** A pixel size, normalized to the supported range. */\n  size: number\n}>\n\n/** The host-owned choices edited by the shared appearance composition. */\nexport type AppearanceEditorFontSettings = Readonly<\n  Record<AppearanceEditorFontAxis, AppearanceEditorFontSetting>\n>\n\nexport const APPEARANCE_EDITOR_FONT_SIZE_MIN = 10\nexport const APPEARANCE_EDITOR_FONT_SIZE_MAX = 32\n\n/** New preferences use the platform face in each text role. */\nexport const DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS: AppearanceEditorFontSettings = Object.freeze({\n  ui: Object.freeze({ family: 'system', size: 14 }),\n  content: Object.freeze({ family: 'system', size: 14 }),\n  code: Object.freeze({ family: 'system', size: 12 }),\n})\n\nexport type NormalizedAppearanceEditorFontSettings = Readonly<{\n  settings: AppearanceEditorFontSettings\n  /** Axes whose persisted family or size was unavailable or outside its limits. */\n  recoveredAxes: readonly AppearanceEditorFontAxis[]\n}>\n\nconst fontFamilyIds: ReadonlySet<string> = new Set(fontOptions.map((option) => option.id))\nconst fontOptionsById = Object.freeze(\n  Object.fromEntries(fontOptions.map((option) => [option.id, option])) as Record<\n    AppearanceEditorFontFamilyId,\n    FontOption\n  >\n)\nconst fontProjectionById = Object.freeze(\n  Object.fromEntries(\n    fontOptions.map((option) => [\n      option.id,\n      {\n        familyVariables: option.familyVariables,\n        uiTracking: option.uiTracking,\n        uiWordSpacing: option.uiWordSpacing,\n      },\n    ])\n  ) as Record<\n    AppearanceEditorFontFamilyId,\n    Pick<FontOption, 'familyVariables' | 'uiTracking' | 'uiWordSpacing'>\n  >\n)\nconst fontAxisProjection = Object.freeze({\n  ui: Object.freeze({\n    familyAttribute: 'data-ui-font',\n    familyProperty: '--font-ui',\n    sizeProperty: '--font-ui-size',\n    scaleProperty: '--font-ui-scale',\n    defaultSize: DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS.ui.size,\n  }),\n  content: Object.freeze({\n    familyAttribute: 'data-content-font',\n    familyProperty: '--font-content',\n    sizeProperty: '--font-content-size',\n    scaleProperty: '--font-content-scale',\n    defaultSize: DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS.content.size,\n  }),\n  code: Object.freeze({\n    familyAttribute: 'data-code-font',\n    familyProperty: '--font-code',\n    sizeProperty: '--font-code-size',\n    scaleProperty: '--font-code-scale',\n    defaultSize: DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS.code.size,\n  }),\n})\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction hasOwn(value: Record<string, unknown>, key: string): boolean {\n  return Object.prototype.hasOwnProperty.call(value, key)\n}\n\nfunction normalizeFamily(value: unknown): AppearanceEditorFontFamilyId | undefined {\n  return typeof value === 'string' && fontFamilyIds.has(value)\n    ? (value as AppearanceEditorFontFamilyId)\n    : undefined\n}\n\nfunction clampFontSize(value: number): number {\n  return Math.min(\n    APPEARANCE_EDITOR_FONT_SIZE_MAX,\n    Math.max(APPEARANCE_EDITOR_FONT_SIZE_MIN, Math.round(value))\n  )\n}\n\n/** Normalize a single number-input value; invalid edits return the current size. */\nexport function normalizeAppearanceEditorFontSize(value: unknown, fallback: number): number {\n  const parsed =\n    typeof value === 'number'\n      ? value\n      : typeof value === 'string' && value.trim() !== ''\n        ? Number(value)\n        : Number.NaN\n  return Number.isFinite(parsed) ? clampFontSize(parsed) : clampFontSize(fallback)\n}\n\n/**\n * Recover persisted font choices against the shared font catalogue.\n *\n * `legacyUiFamily` lets a host migrate its previous single font field into the\n * UI axis. Content and code remain on the new System defaults during that\n * migration. Missing settings are ordinary defaults; an unknown saved id or an\n * invalid size is reported through `recoveredAxes` for the host's notice.\n */\nexport function normalizeAppearanceEditorFontSettings(\n  value: unknown,\n  legacyUiFamily?: unknown\n): NormalizedAppearanceEditorFontSettings {\n  const source = isRecord(value) ? value : undefined\n  const malformedRoot = value !== undefined && value !== null && source === undefined\n  const recovered = new Set<AppearanceEditorFontAxis>()\n  const settings = {} as Record<AppearanceEditorFontAxis, AppearanceEditorFontSetting>\n\n  for (const axis of APPEARANCE_EDITOR_FONT_AXES) {\n    const axisPresent = source ? hasOwn(source, axis) : false\n    const axisValue = source?.[axis]\n    const axisSource = isRecord(axisValue) ? axisValue : undefined\n    const fallback = DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS[axis]\n\n    if (malformedRoot || (axisPresent && axisSource === undefined)) recovered.add(axis)\n\n    const hasFamily = axisSource ? hasOwn(axisSource, 'family') : false\n    const familyInput = hasFamily\n      ? axisSource?.['family']\n      : axis === 'ui' && legacyUiFamily !== undefined\n        ? legacyUiFamily\n        : undefined\n    const family = normalizeFamily(familyInput) ?? fallback.family\n    if (\n      (hasFamily || (axis === 'ui' && legacyUiFamily !== undefined)) &&\n      !normalizeFamily(familyInput)\n    ) {\n      recovered.add(axis)\n    }\n\n    const hasSize = axisSource ? hasOwn(axisSource, 'size') : false\n    const sizeInput = axisSource?.['size']\n    const size = hasSize\n      ? normalizeAppearanceEditorFontSize(sizeInput, fallback.size)\n      : fallback.size\n    if (\n      hasSize &&\n      (typeof sizeInput !== 'number' || !Number.isFinite(sizeInput) || sizeInput !== size)\n    ) {\n      recovered.add(axis)\n    }\n\n    settings[axis] = Object.freeze({ family, size })\n  }\n\n  return Object.freeze({\n    settings: Object.freeze(settings),\n    recoveredAxes: Object.freeze(APPEARANCE_EDITOR_FONT_AXES.filter((axis) => recovered.has(axis))),\n  })\n}\n\n/**\n * Project normalized font preferences onto a document root.\n *\n * This is shared by `ThemeProvider` and hosts that own their own appearance\n * persistence, so UI/content/code use the same catalogue ids, theme tokens,\n * sizes, and projected CSS variables. The marker activates the optional role\n * stylesheet and survives CSS import reordering.\n */\nexport function applyAppearanceFontSettings(\n  root: HTMLElement,\n  value: unknown\n): NormalizedAppearanceEditorFontSettings {\n  const normalized = normalizeAppearanceEditorFontSettings(value)\n  const { settings } = normalized\n\n  root.removeAttribute('data-font')\n  root.setAttribute('data-font-settings', '')\n  for (const axis of APPEARANCE_EDITOR_FONT_AXES) {\n    const projection = fontAxisProjection[axis]\n    const setting = settings[axis]\n    const option = fontOptionsById[setting.family]\n    if (setting.family === 'system') root.removeAttribute(projection.familyAttribute)\n    else root.setAttribute(projection.familyAttribute, setting.family)\n    root.style.setProperty(projection.familyProperty, `var(${option.familyVariables[axis]})`)\n    root.style.setProperty(projection.sizeProperty, String(setting.size) + 'px')\n    root.style.setProperty(projection.scaleProperty, String(setting.size / projection.defaultSize))\n    if (axis === 'ui') {\n      root.style.setProperty('--ui-tracking', option.uiTracking)\n      root.style.setProperty('--ui-word-spacing', option.uiWordSpacing)\n    }\n  }\n\n  return normalized\n}\n\n/**\n * Generate a safe inline prepaint script for a host-owned appearance record.\n *\n * The stored object is read from `localStorage[storageKey].fonts`. A legacy\n * top-level `font` family migrates into UI only; content/code use the shared\n * defaults. The script applies the same catalogue whitelist, limits, attributes,\n * and CSS properties as `applyAppearanceFontSettings` before styles paint. When\n * `persistedVersion` is supplied, only a record with that exact top-level version\n * is used; absent or mismatched records receive the System defaults.\n */\nexport function fontSettingsBootstrapScript(storageKey: string, persistedVersion?: number): string {\n  if (persistedVersion !== undefined && !Number.isSafeInteger(persistedVersion)) {\n    throw new RangeError('persistedVersion must be a safe integer')\n  }\n  const axisConfig = JSON.stringify(fontAxisProjection)\n  const fontProjection = JSON.stringify(fontProjectionById)\n  const fontIds = `[${fontOptions.map((option) => safeScriptStringLiteral(option.id)).join(',')}]`\n  const persistedVersionGuard =\n    persistedVersion === undefined\n      ? ''\n      : `&&parsed.version===Number(${safeScriptStringLiteral(String(persistedVersion))})`\n\n  return `(function(){var r=document.documentElement;var axes=JSON.parse(${safeScriptStringLiteral(axisConfig)});var projection=JSON.parse(${safeScriptStringLiteral(fontProjection)});var ids=${fontIds};var has=function(v,k){return Object.prototype.hasOwnProperty.call(v,k)};var record=function(v){return typeof v==='object'&&v!==null&&!Array.isArray(v)};var p={};try{var raw=localStorage.getItem(${safeScriptStringLiteral(storageKey)});var parsed=raw?JSON.parse(raw):{};if(record(parsed)${persistedVersionGuard})p=parsed;}catch(e){}var saved=record(p.fonts)?p.fonts:{};var valid=function(v,d){return ids.indexOf(v)!==-1?v:d};var size=function(v,d){var n=typeof v==='number'?v:typeof v==='string'&&v.trim()!==''?Number(v):NaN;return Number.isFinite(n)?Math.min(${APPEARANCE_EDITOR_FONT_SIZE_MAX},Math.max(${APPEARANCE_EDITOR_FONT_SIZE_MIN},Math.round(n))):d};r.setAttribute('data-font-settings','');for(var axis in axes){if(!has(axes,axis))continue;var spec=axes[axis];var candidate=saved[axis];var value=record(candidate)?candidate:{};var legacyUi=axis==='ui'&&!has(value,'family');var family=legacyUi?valid(p.font,'system'):valid(value.family,'system');var font=projection[family];if(family==='system')r.removeAttribute(spec.familyAttribute);else r.setAttribute(spec.familyAttribute,family);r.style.setProperty(spec.familyProperty,'var('+font.familyVariables[axis]+')');var px=size(value.size,spec.defaultSize);r.style.setProperty(spec.sizeProperty,px+'px');r.style.setProperty(spec.scaleProperty,String(px/spec.defaultSize));if(axis==='ui'){r.style.setProperty('--ui-tracking',font.uiTracking);r.style.setProperty('--ui-word-spacing',font.uiWordSpacing);}}r.removeAttribute('data-font');})();`\n}\n"],"mappings":"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"}
+{"version":3,"file":"appearance-font-settings.js","names":[],"sources":["../../src/lib/appearance-font-settings.ts"],"sourcesContent":["import { fontOptions, type FontOption } from '#lib/font-catalog'\nimport { safeScriptStringLiteral } from '#lib/safe-script'\n\nexport const APPEARANCE_EDITOR_FONT_AXES = ['ui', 'content', 'code'] as const\n\nexport type AppearanceEditorFontAxis = (typeof APPEARANCE_EDITOR_FONT_AXES)[number]\nexport type AppearanceEditorFontFamilyId = FontOption['id']\n\nexport type AppearanceEditorFontSetting = Readonly<{\n  /** A stable id from the shared font catalogue, never a CSS family string. */\n  family: AppearanceEditorFontFamilyId\n  /** A pixel size, normalized to the supported range. */\n  size: number\n}>\n\n/** The host-owned choices edited by the shared appearance composition. */\nexport type AppearanceEditorFontSettings = Readonly<\n  Record<AppearanceEditorFontAxis, AppearanceEditorFontSetting>\n>\n\nexport const APPEARANCE_EDITOR_FONT_SIZE_MIN = 10\nexport const APPEARANCE_EDITOR_FONT_SIZE_MAX = 32\n\n/** New preferences use the platform face in each text role. */\nexport const DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS: AppearanceEditorFontSettings = Object.freeze({\n  ui: Object.freeze({ family: 'system', size: 14 }),\n  content: Object.freeze({ family: 'system', size: 14 }),\n  code: Object.freeze({ family: 'system', size: 12 }),\n})\n\nexport type NormalizedAppearanceEditorFontSettings = Readonly<{\n  settings: AppearanceEditorFontSettings\n  /** Axes whose persisted family or size was unavailable or outside its limits. */\n  recoveredAxes: readonly AppearanceEditorFontAxis[]\n}>\n\nconst fontFamilyIds: ReadonlySet<string> = new Set(fontOptions.map((option) => option.id))\nconst fontOptionsById = Object.freeze(\n  Object.fromEntries(fontOptions.map((option) => [option.id, option])) as Record<\n    AppearanceEditorFontFamilyId,\n    FontOption\n  >\n)\nconst fontProjectionById = Object.freeze(\n  Object.fromEntries(\n    fontOptions.map((option) => [\n      option.id,\n      {\n        familyVariables: option.familyVariables,\n        uiTracking: option.uiTracking,\n        uiWordSpacing: option.uiWordSpacing,\n      },\n    ])\n  ) as Record<\n    AppearanceEditorFontFamilyId,\n    Pick<FontOption, 'familyVariables' | 'uiTracking' | 'uiWordSpacing'>\n  >\n)\nconst fontAxisProjection = Object.freeze({\n  ui: Object.freeze({\n    familyAttribute: 'data-ui-font',\n    familyProperty: '--font-ui',\n    sizeProperty: '--font-ui-size',\n    scaleProperty: '--font-ui-scale',\n    defaultSize: DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS.ui.size,\n  }),\n  content: Object.freeze({\n    familyAttribute: 'data-content-font',\n    familyProperty: '--font-content',\n    sizeProperty: '--font-content-size',\n    scaleProperty: '--font-content-scale',\n    defaultSize: DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS.content.size,\n  }),\n  code: Object.freeze({\n    familyAttribute: 'data-code-font',\n    familyProperty: '--font-code',\n    sizeProperty: '--font-code-size',\n    scaleProperty: '--font-code-scale',\n    defaultSize: DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS.code.size,\n  }),\n})\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction hasOwn(value: Record<string, unknown>, key: string): boolean {\n  return Object.prototype.hasOwnProperty.call(value, key)\n}\n\nfunction normalizeFamily(value: unknown): AppearanceEditorFontFamilyId | undefined {\n  return typeof value === 'string' && fontFamilyIds.has(value)\n    ? (value as AppearanceEditorFontFamilyId)\n    : undefined\n}\n\nfunction clampFontSize(value: number): number {\n  return Math.min(\n    APPEARANCE_EDITOR_FONT_SIZE_MAX,\n    Math.max(APPEARANCE_EDITOR_FONT_SIZE_MIN, Math.round(value))\n  )\n}\n\n/** Normalize a single number-input value; invalid edits return the current size. */\nexport function normalizeAppearanceEditorFontSize(value: unknown, fallback: number): number {\n  const parsed =\n    typeof value === 'number'\n      ? value\n      : typeof value === 'string' && value.trim() !== ''\n        ? Number(value)\n        : Number.NaN\n  return Number.isFinite(parsed) ? clampFontSize(parsed) : clampFontSize(fallback)\n}\n\n/**\n * Recover persisted font choices against the shared font catalogue.\n *\n * `legacyUiFamily` lets a host migrate its previous single font field into the\n * UI axis. Content and code remain on the new System defaults during that\n * migration. Missing settings are ordinary defaults; an unknown saved id or an\n * invalid size is reported through `recoveredAxes` for the host's notice.\n */\nexport function normalizeAppearanceEditorFontSettings(\n  value: unknown,\n  legacyUiFamily?: unknown\n): NormalizedAppearanceEditorFontSettings {\n  const source = isRecord(value) ? value : undefined\n  const malformedRoot = value !== undefined && value !== null && source === undefined\n  const recovered = new Set<AppearanceEditorFontAxis>()\n  const settings = {} as Record<AppearanceEditorFontAxis, AppearanceEditorFontSetting>\n\n  for (const axis of APPEARANCE_EDITOR_FONT_AXES) {\n    const axisPresent = source ? hasOwn(source, axis) : false\n    const axisValue = source?.[axis]\n    const axisSource = isRecord(axisValue) ? axisValue : undefined\n    const fallback = DEFAULT_APPEARANCE_EDITOR_FONT_SETTINGS[axis]\n\n    if (malformedRoot || (axisPresent && axisSource === undefined)) recovered.add(axis)\n\n    const hasFamily = axisSource ? hasOwn(axisSource, 'family') : false\n    const familyInput = hasFamily\n      ? axisSource?.['family']\n      : axis === 'ui' && legacyUiFamily !== undefined\n        ? legacyUiFamily\n        : undefined\n    const family = normalizeFamily(familyInput) ?? fallback.family\n    if (\n      (hasFamily || (axis === 'ui' && legacyUiFamily !== undefined)) &&\n      !normalizeFamily(familyInput)\n    ) {\n      recovered.add(axis)\n    }\n\n    const hasSize = axisSource ? hasOwn(axisSource, 'size') : false\n    const sizeInput = axisSource?.['size']\n    const size = hasSize\n      ? normalizeAppearanceEditorFontSize(sizeInput, fallback.size)\n      : fallback.size\n    if (\n      hasSize &&\n      (typeof sizeInput !== 'number' || !Number.isFinite(sizeInput) || sizeInput !== size)\n    ) {\n      recovered.add(axis)\n    }\n\n    settings[axis] = Object.freeze({ family, size })\n  }\n\n  return Object.freeze({\n    settings: Object.freeze(settings),\n    recoveredAxes: Object.freeze(APPEARANCE_EDITOR_FONT_AXES.filter((axis) => recovered.has(axis))),\n  })\n}\n\n/**\n * Project normalized font preferences onto a document root.\n *\n * This is shared by `ThemeProvider` and hosts that own their own appearance\n * persistence, so UI/content/code use the same catalogue ids, theme tokens,\n * sizes, and projected CSS variables. The marker activates the optional role\n * stylesheet and survives CSS import reordering.\n */\nexport function applyAppearanceFontSettings(\n  root: Pick<HTMLElement, 'removeAttribute' | 'setAttribute' | 'style'>,\n  value: unknown\n): NormalizedAppearanceEditorFontSettings {\n  const normalized = normalizeAppearanceEditorFontSettings(value)\n  const { settings } = normalized\n\n  root.removeAttribute('data-font')\n  root.setAttribute('data-font-settings', '')\n  for (const axis of APPEARANCE_EDITOR_FONT_AXES) {\n    const projection = fontAxisProjection[axis]\n    const setting = settings[axis]\n    const option = fontOptionsById[setting.family]\n    if (setting.family === 'system') root.removeAttribute(projection.familyAttribute)\n    else root.setAttribute(projection.familyAttribute, setting.family)\n    root.style.setProperty(projection.familyProperty, `var(${option.familyVariables[axis]})`)\n    root.style.setProperty(projection.sizeProperty, String(setting.size) + 'px')\n    root.style.setProperty(projection.scaleProperty, String(setting.size / projection.defaultSize))\n    if (axis === 'ui') {\n      root.style.setProperty('--ui-tracking', option.uiTracking)\n      root.style.setProperty('--ui-word-spacing', option.uiWordSpacing)\n    }\n  }\n\n  return normalized\n}\n\n/**\n * Generate a safe inline prepaint script for a host-owned appearance record.\n *\n * The stored object is read from `localStorage[storageKey].fonts`. A legacy\n * top-level `font` family migrates into UI only; content/code use the shared\n * defaults. The script applies the same catalogue whitelist, limits, attributes,\n * and CSS properties as `applyAppearanceFontSettings` before styles paint. When\n * `persistedVersion` is supplied, only a record with that exact top-level version\n * is used; absent or mismatched records receive the System defaults.\n */\nexport function fontSettingsBootstrapScript(storageKey: string, persistedVersion?: number): string {\n  if (persistedVersion !== undefined && !Number.isSafeInteger(persistedVersion)) {\n    throw new RangeError('persistedVersion must be a safe integer')\n  }\n  const axisConfig = JSON.stringify(fontAxisProjection)\n  const fontProjection = JSON.stringify(fontProjectionById)\n  const fontIds = `[${fontOptions.map((option) => safeScriptStringLiteral(option.id)).join(',')}]`\n  const persistedVersionGuard =\n    persistedVersion === undefined\n      ? ''\n      : `&&parsed.version===Number(${safeScriptStringLiteral(String(persistedVersion))})`\n\n  return `(function(){var r=document.documentElement;var axes=JSON.parse(${safeScriptStringLiteral(axisConfig)});var projection=JSON.parse(${safeScriptStringLiteral(fontProjection)});var ids=${fontIds};var has=function(v,k){return Object.prototype.hasOwnProperty.call(v,k)};var record=function(v){return typeof v==='object'&&v!==null&&!Array.isArray(v)};var p={};try{var raw=localStorage.getItem(${safeScriptStringLiteral(storageKey)});var parsed=raw?JSON.parse(raw):{};if(record(parsed)${persistedVersionGuard})p=parsed;}catch(e){}var saved=record(p.fonts)?p.fonts:{};var valid=function(v,d){return ids.indexOf(v)!==-1?v:d};var size=function(v,d){var n=typeof v==='number'?v:typeof v==='string'&&v.trim()!==''?Number(v):NaN;return Number.isFinite(n)?Math.min(${APPEARANCE_EDITOR_FONT_SIZE_MAX},Math.max(${APPEARANCE_EDITOR_FONT_SIZE_MIN},Math.round(n))):d};r.setAttribute('data-font-settings','');for(var axis in axes){if(!has(axes,axis))continue;var spec=axes[axis];var candidate=saved[axis];var value=record(candidate)?candidate:{};var legacyUi=axis==='ui'&&!has(value,'family');var family=legacyUi?valid(p.font,'system'):valid(value.family,'system');var font=projection[family];if(family==='system')r.removeAttribute(spec.familyAttribute);else r.setAttribute(spec.familyAttribute,family);r.style.setProperty(spec.familyProperty,'var('+font.familyVariables[axis]+')');var px=size(value.size,spec.defaultSize);r.style.setProperty(spec.sizeProperty,px+'px');r.style.setProperty(spec.scaleProperty,String(px/spec.defaultSize));if(axis==='ui'){r.style.setProperty('--ui-tracking',font.uiTracking);r.style.setProperty('--ui-word-spacing',font.uiWordSpacing);}}r.removeAttribute('data-font');})();`\n}\n"],"mappings":"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"}

package/dist/lib/themes.d.ts

@@ -33,6 +33,7 @@
  * `surfaceHover`, which is what shadcn components actually use it for.
  */
 import { type AccentPreset, type AdeaTheme, type AdeaThemeRecord } from '@adea-ai/themes';
+import { type AccentRoles } from './accent-roles';
 export { isThemeAccentId } from './theme-accents';
 export type ThemeAppearance = 'light' | 'dark';
 /**
@@ -147,7 +148,26 @@ export type ThemeVariant = {
     /** The categorical series, in order. */
     chart: readonly string[];
     provenance: ThemeProvenance;
+    /**
+     * Custom properties written verbatim over {@link themeCssVariables}, last.
+     *
+     * For a variant a host built from data it does not control the derivation of —
+     * an imported theme whose painted colours must stay exactly what the user
+     * imported. The catalogue's own variants never carry it, so the derived roles
+     * stay the only source of truth for them.
+     */
+    tokens?: Readonly<Record<string, string>>;
 };
+/**
+ * The design system's view of one catalogue record, built in full and at once.
+ *
+ * For a host that holds a record the catalogue does not — an imported theme, a
+ * reconstruction from stored data — and wants a variant it can hand to
+ * `ThemeProvider`'s `themes`. It throws for a record the shadcn projection cannot
+ * map, here and now, rather than on first paint. The catalogue itself goes through
+ * {@link lazyVariant} instead.
+ */
+export declare function variantFromRecord(theme: AdeaThemeRecord): ThemeVariant;
 /**
  * A variant's `--primary-subtle`: the tint over `var(--primary)` at the strength its
  * catalogue record measures (`primarySubtleAlpha`). A variant that is not in the
@@ -157,6 +177,24 @@ export declare function primarySubtleFor(theme: Pick<ThemeVariant, 'id' | 'appea
 /** The catalogue, in catalogue order. */
 export declare const builtinThemes: readonly ThemeVariant[];
 export declare function themeById(id: string): ThemeVariant | undefined;
+/**
+ * The variant a stored id means, or the default of the same appearance.
+ *
+ * An id the registry does not hold — an imported theme that was deleted, a
+ * catalogue entry that was renamed — must still paint *something of the appearance
+ * being shown*. Falling back to whichever variant happens to be first in the
+ * registry painted a dark palette under a light `color-scheme` for a light id, so
+ * the fallback is the appearance's own default, then any variant of that
+ * appearance, then the registry's first entry only when it holds nothing else.
+ *
+ * `registry` is the builtin catalogue plus whatever extras the host supplies; the
+ * stored id is never rewritten, only resolved, so a host that keeps an unknown id
+ * keeps resolving it if the theme comes back.
+ *
+ * The fallback order is translated from Zeron's `ThemeRegistry::resolve` (MIT,
+ * Copyright (c) 2026 Wing); see NOTICE.
+ */
+export declare function resolveVariant(registry: readonly ThemeVariant[], id: string, appearance: ThemeAppearance): ThemeVariant;
 /** The variants of one appearance, which is what a picker for that mode shows. */
 export declare function themesForAppearance(appearance: ThemeAppearance): readonly ThemeVariant[];
 /** The families in the catalogue, in catalogue order. */
@@ -252,7 +290,28 @@ export declare function appearancePreviewThemes(selection: {
 export declare function accentVariables(accentId: string, appearance: ThemeAppearance, pair?: {
     lightThemeId: string;
     darkThemeId: string;
-}): Record<string, string> | undefined;
+}, options?: AccentVariableOptions): Record<string, string> | undefined;
+/** What an accent is held to when it is resolved against a surface. */
+export type AccentVariableOptions = {
+    /** The surface the accent must read on: the variant's `colors.background`. */
+    background?: string;
+    /**
+     * The contrast floor against `background`. Absent, a preset is painted verbatim
+     * and only a custom `#rrggbb` is held to the default floor.
+     */
+    floor?: number;
+    /** The variant the accent is applied to, so the tint takes its measured strength. */
+    variantId?: string;
+};
+/**
+ * An accent selection resolved to the full {@link AccentRoles}, against a theme
+ * pair. {@link accentVariables} is the document half of this; an element-scoped
+ * paint (`paintAccentRoles`) wants all of it, including the tint.
+ */
+export declare function accentRolesForSelection(accentId: string, appearance: ThemeAppearance, pair?: {
+    lightThemeId: string;
+    darkThemeId: string;
+}, options?: AccentVariableOptions): AccentRoles | undefined;
 /**
  * The roles a variant sets, as CSS custom properties.
  *
@@ -262,6 +321,17 @@ export declare function accentVariables(accentId: string, appearance: ThemeAppea
  * than separate roles, which is why they are built here and not in the catalogue.
  */
 export declare function themeCssVariables(theme: ThemeVariant): Record<string, string>;
+/**
+ * Token values with every `oklch()` colour written as `#rrggbb`.
+ *
+ * For a host whose stylesheet, tests or native shell speak hex: the catalogue's
+ * roles are `oklch()` strings, and this is the one conversion, gamut-mapped by the
+ * catalogue's own `oklchToHex`. A value that is already hex, carries alpha
+ * (`rgba()`), or is not a plain colour (`color-mix()`, `var()`) is left byte for
+ * byte, because converting would either lose the alpha or be a guess. Suitable as
+ * `ThemeProvider`'s `transformTokens`.
+ */
+export declare function tokensAsHex(tokens: Readonly<Record<string, string>>): Record<string, string>;
 export type ThemeFinding = {
     themeId: string;
     role: string;

package/dist/lib/themes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../../src/lib/themes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../../src/lib/themes.ts"],"names":[],"mappings":"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"}