@hjmds/design-contracts 0.8.2

package/dist/collection.js

@@ -0,0 +1,211 @@
+export const collectionValidationDefaults = {
+    requireItemLabel: true,
+    requireTextValue: true,
+    requireSectionName: true,
+};
+function assertNonEmpty(value, name) {
+    if (!value.trim())
+        throw new TypeError(`${name} must not be empty`);
+}
+/**
+ * Validates renderer-neutral collection identity before focus or selection state
+ * is derived. Item IDs are global across sections because selection APIs expose
+ * one key namespace.
+ */
+export function validateCollection(source, options = collectionValidationDefaults) {
+    const resolved = { ...collectionValidationDefaults, ...options };
+    const itemIds = new Set();
+    const sectionIds = new Set();
+    const sections = source.sections;
+    const items = sections
+        ? sections.flatMap((section) => {
+            assertNonEmpty(section.id, "section id");
+            if (sectionIds.has(section.id)) {
+                throw new TypeError(`duplicate section id: ${section.id}`);
+            }
+            sectionIds.add(section.id);
+            if (resolved.requireSectionName) {
+                const name = section.accessibilityLabel?.trim() || section.label;
+                if (!name) {
+                    throw new TypeError(`section ${section.id} needs an accessible name`);
+                }
+                assertNonEmpty(name, `section ${section.id} name`);
+            }
+            return section.items;
+        })
+        : source.items;
+    for (const item of items) {
+        assertNonEmpty(item.id, "item id");
+        if (itemIds.has(item.id)) {
+            throw new TypeError(`duplicate item id: ${item.id}`);
+        }
+        itemIds.add(item.id);
+        if (resolved.requireItemLabel) {
+            assertNonEmpty(item.label, `item ${item.id} label`);
+        }
+        if (resolved.requireTextValue) {
+            assertNonEmpty(item.textValue, `item ${item.id} textValue`);
+        }
+    }
+}
+export function flattenCollectionItems(source) {
+    return source.sections
+        ? source.sections.flatMap((section) => section.items)
+        : source.items;
+}
+export function resolveCollectionItem(source, key) {
+    if (key == null)
+        return null;
+    return flattenCollectionItems(source).find((item) => item.id === key) ?? null;
+}
+export function getCollectionNavigationIntent(key) {
+    if (key === "ArrowDown")
+        return "next";
+    if (key === "ArrowUp")
+        return "previous";
+    if (key === "Home")
+        return "first";
+    if (key === "End")
+        return "last";
+    return undefined;
+}
+/** Navigation math shared by Menu, Select, Combobox and future listboxes. */
+export function getCollectionNavigationTarget(source, currentKey, intent, loop = true) {
+    validateCollection(source);
+    const enabled = flattenCollectionItems(source).filter((item) => !item.disabled);
+    if (enabled.length === 0)
+        return undefined;
+    if (intent === "first")
+        return enabled[0]?.id;
+    if (intent === "last")
+        return enabled.at(-1)?.id;
+    const currentIndex = enabled.findIndex((item) => item.id === currentKey);
+    if (currentIndex < 0) {
+        return intent === "previous" ? enabled.at(-1)?.id : enabled[0]?.id;
+    }
+    const nextIndex = currentIndex + (intent === "next" ? 1 : -1);
+    if (!loop && (nextIndex < 0 || nextIndex >= enabled.length)) {
+        return enabled[currentIndex]?.id;
+    }
+    return enabled[(nextIndex + enabled.length) % enabled.length]?.id;
+}
+function collectionTextStartsWith(textValue, query, locale) {
+    const candidate = textValue.normalize("NFC").trimStart();
+    const normalizedQuery = query.normalize("NFC").trim();
+    if (!normalizedQuery)
+        return false;
+    const collator = new Intl.Collator(locale, {
+        usage: "search",
+        sensitivity: "base",
+    });
+    // Collation-equivalent prefixes do not always have the same UTF-16 length
+    // (for example German ß and ss), so compare a small prefix window instead
+    // of slicing only by query.length.
+    const maxPrefixLength = Math.min(candidate.length, normalizedQuery.length + 4);
+    for (let length = 1; length <= maxPrefixLength; length += 1) {
+        if (collator.compare(candidate.slice(0, length), normalizedQuery) === 0) {
+            return true;
+        }
+    }
+    return false;
+}
+/** Products own buffering; this helper owns matching order and disabled skip. */
+export function getCollectionTypeaheadMatch(source, query, options = {}) {
+    validateCollection(source);
+    if (!query.trim())
+        return undefined;
+    const enabled = flattenCollectionItems(source).filter((item) => !item.disabled);
+    if (enabled.length === 0)
+        return undefined;
+    const currentIndex = enabled.findIndex((item) => item.id === options.startsAfterKey);
+    for (let offset = 1; offset <= enabled.length; offset += 1) {
+        const item = enabled[(currentIndex + offset + enabled.length) % enabled.length];
+        if (item &&
+            collectionTextStartsWith(item.textValue, query, options.locale)) {
+            return item.id;
+        }
+    }
+    return undefined;
+}
+/** Missing keys clear; disabled-but-still-present selections are retained. */
+export function reconcileSelectSelection(source, selectedKey, options = {}) {
+    validateCollection(source);
+    if (options.selectedItem) {
+        validateCollection({ items: [options.selectedItem] });
+        if (selectedKey == null) {
+            throw new RangeError("selectedItem requires a selectedKey");
+        }
+        if (options.selectedItem.id !== selectedKey) {
+            throw new RangeError("selectedItem id must match selectedKey");
+        }
+    }
+    const items = flattenCollectionItems(source);
+    if (selectedKey != null && items.some((item) => item.id === selectedKey)) {
+        return selectedKey;
+    }
+    if (selectedKey != null &&
+        (options.asyncState?.status === "loading" ||
+            options.asyncState?.status === "loadingMore" ||
+            options.asyncState?.status === "error")) {
+        return selectedKey;
+    }
+    if (options.disallowEmptySelection) {
+        return items.find((item) => !item.disabled)?.id ?? null;
+    }
+    return null;
+}
+/** Resolves visible Select copy independently from a transient result page. */
+export function resolveSelectSelectedItem(source, selectedKey, selectedItem) {
+    validateCollection(source);
+    if (selectedItem)
+        validateCollection({ items: [selectedItem] });
+    if (selectedKey == null) {
+        if (selectedItem) {
+            throw new RangeError("selectedItem requires a selectedKey");
+        }
+        return null;
+    }
+    if (selectedItem && selectedItem.id !== selectedKey) {
+        throw new RangeError("selectedItem id must match selectedKey");
+    }
+    const itemInSource = source.sections
+        ? source.sections
+            .flatMap((section) => section.items)
+            .find((item) => item.id === selectedKey)
+        : source.items.find((item) => item.id === selectedKey);
+    return selectedItem ?? itemInSource ?? null;
+}
+export function isComboboxResultCurrent(queryValue, resultQuery) {
+    return queryValue === resultQuery;
+}
+/**
+ * External result pages are not the source of truth for a committed value.
+ * A product may supply the committed descriptor while a different query is
+ */
+export function resolveComboboxSelectedItem(source, selectedKey, selectedItem) {
+    validateCollection(source);
+    if (selectedItem)
+        validateCollection({ items: [selectedItem] });
+    if (selectedKey == null) {
+        if (selectedItem) {
+            throw new RangeError("selectedItem requires a selectedKey");
+        }
+        return null;
+    }
+    if (selectedItem && selectedItem.id !== selectedKey) {
+        throw new RangeError("selectedItem id must match selectedKey");
+    }
+    // A supplied descriptor is the committed snapshot. Prefer it even if a
+    // stale external page happens to contain the same stable key.
+    if (selectedItem)
+        return selectedItem;
+    const itemInResults = source.sections
+        ? source.sections
+            .flatMap((section) => section.items)
+            .find((item) => item.id === selectedKey)
+        : source.items.find((item) => item.id === selectedKey);
+    if (itemInResults)
+        return itemInResults;
+    throw new RangeError(`Selected combobox item is unavailable: ${selectedKey}`);
+}
+//# sourceMappingURL=collection.js.map

package/dist/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AsyncCollectionState,\n  ComboboxCommitReason,\n  ComboboxFiltering,\n  ComboboxInput,\n  CollectionItemDescriptor,\n  CollectionKey,\n  CollectionSectionDescriptor,\n  SelectItemDescriptor,\n  SelectSelection,\n  WebKeyboardKey,\n} from \"./behaviors.js\";\n\nexport type CollectionSource<\n  Key extends CollectionKey = CollectionKey,\n  SectionKey extends CollectionKey = CollectionKey,\n> =\n  | Readonly<{ items: readonly CollectionItemDescriptor<Key>[]; sections?: never }>\n  | Readonly<{\n      items?: never;\n      sections: readonly CollectionSectionDescriptor<Key, SectionKey>[];\n    }>;\n\nexport type SelectCollectionSectionDescriptor<\n  Key extends CollectionKey = CollectionKey,\n  SectionKey extends CollectionKey = CollectionKey,\n> = Readonly<{\n  id: SectionKey;\n  items: readonly SelectItemDescriptor<Key>[];\n}> &\n  (\n    | Readonly<{ label: string; accessibilityLabel?: string }>\n    | Readonly<{ label?: string; accessibilityLabel: string }>\n  );\n\n/** Select/Combobox source excludes Menu-only danger tone and shortcut. */\nexport type SelectCollectionSource<\n  Key extends CollectionKey = CollectionKey,\n  SectionKey extends CollectionKey = CollectionKey,\n> =\n  | Readonly<{ items: readonly SelectItemDescriptor<Key>[]; sections?: never }>\n  | Readonly<{\n      items?: never;\n      sections: readonly SelectCollectionSectionDescriptor<Key, SectionKey>[];\n    }>;\n\nexport type CollectionValidationOptions = Readonly<{\n  requireItemLabel?: boolean;\n  requireTextValue?: boolean;\n  requireSectionName?: boolean;\n}>;\n\nexport const collectionValidationDefaults = {\n  requireItemLabel: true,\n  requireTextValue: true,\n  requireSectionName: true,\n} as const satisfies Required<CollectionValidationOptions>;\n\nfunction assertNonEmpty(value: string, name: string): void {\n  if (!value.trim()) throw new TypeError(`${name} must not be empty`);\n}\n\n/**\n * Validates renderer-neutral collection identity before focus or selection state\n * is derived. Item IDs are global across sections because selection APIs expose\n * one key namespace.\n */\nexport function validateCollection<\n  Key extends CollectionKey,\n  SectionKey extends CollectionKey,\n>(\n  source: CollectionSource<Key, SectionKey>,\n  options: CollectionValidationOptions = collectionValidationDefaults,\n): void {\n  const resolved = { ...collectionValidationDefaults, ...options };\n  const itemIds = new Set<Key>();\n  const sectionIds = new Set<SectionKey>();\n  const sections = source.sections;\n  const items = sections\n    ? sections.flatMap((section) => {\n        assertNonEmpty(section.id, \"section id\");\n        if (sectionIds.has(section.id)) {\n          throw new TypeError(`duplicate section id: ${section.id}`);\n        }\n        sectionIds.add(section.id);\n        if (resolved.requireSectionName) {\n          const name = section.accessibilityLabel?.trim() || section.label;\n          if (!name) {\n            throw new TypeError(`section ${section.id} needs an accessible name`);\n          }\n          assertNonEmpty(name, `section ${section.id} name`);\n        }\n        return section.items;\n      })\n    : source.items;\n\n  for (const item of items) {\n    assertNonEmpty(item.id, \"item id\");\n    if (itemIds.has(item.id)) {\n      throw new TypeError(`duplicate item id: ${item.id}`);\n    }\n    itemIds.add(item.id);\n    if (resolved.requireItemLabel) {\n      assertNonEmpty(item.label, `item ${item.id} label`);\n    }\n    if (resolved.requireTextValue) {\n      assertNonEmpty(item.textValue, `item ${item.id} textValue`);\n    }\n  }\n}\n\nexport function flattenCollectionItems<\n  Key extends CollectionKey,\n  SectionKey extends CollectionKey,\n>(\n  source: CollectionSource<Key, SectionKey>,\n): readonly CollectionItemDescriptor<Key>[] {\n  return source.sections\n    ? source.sections.flatMap((section) => section.items)\n    : source.items;\n}\n\nexport function resolveCollectionItem<\n  Key extends CollectionKey,\n  SectionKey extends CollectionKey,\n>(\n  source: CollectionSource<Key, SectionKey>,\n  key: Key | null | undefined,\n): CollectionItemDescriptor<Key> | null {\n  if (key == null) return null;\n  return flattenCollectionItems(source).find((item) => item.id === key) ?? null;\n}\n\nexport type ReconcileSelectOptions<\n  Key extends CollectionKey = CollectionKey,\n> = Readonly<{\n  disallowEmptySelection?: boolean;\n  /** Retains a committed key while an async collection is transient. */\n  asyncState?: AsyncCollectionState;\n  /** Preserves committed copy when the current result page omits the item. */\n  selectedItem?: SelectItemDescriptor<Key>;\n}>;\n\nexport type CollectionNavigationIntent =\n  | \"next\"\n  | \"previous\"\n  | \"first\"\n  | \"last\";\n\nexport function getCollectionNavigationIntent(\n  key: WebKeyboardKey,\n): CollectionNavigationIntent | undefined {\n  if (key === \"ArrowDown\") return \"next\";\n  if (key === \"ArrowUp\") return \"previous\";\n  if (key === \"Home\") return \"first\";\n  if (key === \"End\") return \"last\";\n  return undefined;\n}\n\n/** Navigation math shared by Menu, Select, Combobox and future listboxes. */\nexport function getCollectionNavigationTarget<\n  Key extends CollectionKey,\n  SectionKey extends CollectionKey,\n>(\n  source: CollectionSource<Key, SectionKey>,\n  currentKey: Key | null | undefined,\n  intent: CollectionNavigationIntent,\n  loop = true,\n): Key | undefined {\n  validateCollection(source);\n  const enabled = flattenCollectionItems(source).filter((item) => !item.disabled);\n  if (enabled.length === 0) return undefined;\n  if (intent === \"first\") return enabled[0]?.id;\n  if (intent === \"last\") return enabled.at(-1)?.id;\n  const currentIndex = enabled.findIndex((item) => item.id === currentKey);\n  if (currentIndex < 0) {\n    return intent === \"previous\" ? enabled.at(-1)?.id : enabled[0]?.id;\n  }\n  const nextIndex = currentIndex + (intent === \"next\" ? 1 : -1);\n  if (!loop && (nextIndex < 0 || nextIndex >= enabled.length)) {\n    return enabled[currentIndex]?.id;\n  }\n  return enabled[(nextIndex + enabled.length) % enabled.length]?.id;\n}\n\nexport type CollectionTypeaheadOptions<\n  Key extends CollectionKey = CollectionKey,\n> = Readonly<{\n  locale?: string | readonly string[];\n  startsAfterKey?: Key | null;\n}>;\n\nfunction collectionTextStartsWith(\n  textValue: string,\n  query: string,\n  locale?: string | readonly string[],\n): boolean {\n  const candidate = textValue.normalize(\"NFC\").trimStart();\n  const normalizedQuery = query.normalize(\"NFC\").trim();\n  if (!normalizedQuery) return false;\n  const collator = new Intl.Collator(locale, {\n    usage: \"search\",\n    sensitivity: \"base\",\n  });\n  // Collation-equivalent prefixes do not always have the same UTF-16 length\n  // (for example German ß and ss), so compare a small prefix window instead\n  // of slicing only by query.length.\n  const maxPrefixLength = Math.min(\n    candidate.length,\n    normalizedQuery.length + 4,\n  );\n  for (let length = 1; length <= maxPrefixLength; length += 1) {\n    if (collator.compare(candidate.slice(0, length), normalizedQuery) === 0) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/** Products own buffering; this helper owns matching order and disabled skip. */\nexport function getCollectionTypeaheadMatch<\n  Key extends CollectionKey,\n  SectionKey extends CollectionKey,\n>(\n  source: CollectionSource<Key, SectionKey>,\n  query: string,\n  options: CollectionTypeaheadOptions<Key> = {},\n): Key | undefined {\n  validateCollection(source);\n  if (!query.trim()) return undefined;\n  const enabled = flattenCollectionItems(source).filter((item) => !item.disabled);\n  if (enabled.length === 0) return undefined;\n  const currentIndex = enabled.findIndex(\n    (item) => item.id === options.startsAfterKey,\n  );\n  for (let offset = 1; offset <= enabled.length; offset += 1) {\n    const item = enabled[(currentIndex + offset + enabled.length) % enabled.length];\n    if (\n      item &&\n      collectionTextStartsWith(item.textValue, query, options.locale)\n    ) {\n      return item.id;\n    }\n  }\n  return undefined;\n}\n\n/** Missing keys clear; disabled-but-still-present selections are retained. */\nexport function reconcileSelectSelection<\n  Key extends CollectionKey,\n  SectionKey extends CollectionKey,\n>(\n  source: SelectCollectionSource<Key, SectionKey>,\n  selectedKey: Key | null,\n  options: ReconcileSelectOptions<Key> = {},\n): Key | null {\n  validateCollection(source);\n  if (options.selectedItem) {\n    validateCollection({ items: [options.selectedItem] });\n    if (selectedKey == null) {\n      throw new RangeError(\"selectedItem requires a selectedKey\");\n    }\n    if (options.selectedItem.id !== selectedKey) {\n      throw new RangeError(\"selectedItem id must match selectedKey\");\n    }\n  }\n  const items = flattenCollectionItems(source);\n  if (selectedKey != null && items.some((item) => item.id === selectedKey)) {\n    return selectedKey;\n  }\n  if (\n    selectedKey != null &&\n    (options.asyncState?.status === \"loading\" ||\n      options.asyncState?.status === \"loadingMore\" ||\n      options.asyncState?.status === \"error\")\n  ) {\n    return selectedKey;\n  }\n  if (options.disallowEmptySelection) {\n    return items.find((item) => !item.disabled)?.id ?? null;\n  }\n  return null;\n}\n\n/** Resolves visible Select copy independently from a transient result page. */\nexport function resolveSelectSelectedItem<\n  Key extends CollectionKey,\n  SectionKey extends CollectionKey,\n>(\n  source: SelectCollectionSource<Key, SectionKey>,\n  selectedKey: Key | null,\n  selectedItem?: SelectItemDescriptor<Key>,\n): SelectItemDescriptor<Key> | null {\n  validateCollection(source);\n  if (selectedItem) validateCollection({ items: [selectedItem] });\n  if (selectedKey == null) {\n    if (selectedItem) {\n      throw new RangeError(\"selectedItem requires a selectedKey\");\n    }\n    return null;\n  }\n  if (selectedItem && selectedItem.id !== selectedKey) {\n    throw new RangeError(\"selectedItem id must match selectedKey\");\n  }\n  const itemInSource = source.sections\n    ? source.sections\n        .flatMap((section) => section.items)\n        .find((item) => item.id === selectedKey)\n    : source.items.find((item) => item.id === selectedKey);\n  return selectedItem ?? itemInSource ?? null;\n}\n\nexport type SelectOpenChangeReason =\n  | \"trigger\"\n  | \"keyboard\"\n  | \"selection\"\n  | \"escape\"\n  | \"outside\"\n  | \"blur\"\n  | \"programmatic\";\n\nexport type SelectOpenState =\n  | Readonly<{\n      open: boolean;\n      defaultOpen?: never;\n      onOpenChange(open: boolean, reason: SelectOpenChangeReason): void;\n    }>\n  | Readonly<{\n      open?: never;\n      defaultOpen?: boolean;\n      onOpenChange?: (open: boolean, reason: SelectOpenChangeReason) => void;\n    }>;\n\nexport type SelectLabel =\n  | Readonly<{ label: string; accessibilityLabel?: string }>\n  | Readonly<{ label?: never; accessibilityLabel: string }>;\n\nexport type SelectConfiguration = Readonly<{\n  disallowEmptySelection?: boolean;\n  loop?: boolean;\n}>;\n\nexport type SelectCollectionState<\n  Key extends CollectionKey = CollectionKey,\n> = Readonly<{\n  asyncState?: AsyncCollectionState;\n  selectedItem?: SelectItemDescriptor<Key>;\n}>;\n\nexport type SelectState<Key extends CollectionKey = CollectionKey> =\n  SelectSelection<Key> &\n    SelectOpenState &\n    SelectLabel &\n    SelectConfiguration &\n    SelectCollectionState<Key>;\n\nexport type ComboboxCollectionState =\n  | Readonly<{\n      filtering?: Extract<ComboboxFiltering, \"local\">;\n      asyncState?: AsyncCollectionState;\n      queryValue?: never;\n      resultQuery?: never;\n    }>\n  | Readonly<{\n      filtering: Extract<ComboboxFiltering, \"external\">;\n      asyncState: AsyncCollectionState;\n      /** Canonical query currently requested by the product search adapter. */\n      queryValue: string;\n      /** Exact canonical query that produced the supplied external items. */\n      resultQuery: string;\n    }>;\n\n/**\n * The future adaptive Combobox keeps selection, editable input and popup state\n * independently controlled. External results carry their originating query so\n * a renderer can reject responses that arrived after the input changed.\n */\nexport type ComboboxState<Key extends CollectionKey = CollectionKey> =\n  SelectSelection<Key> &\n    ComboboxInput &\n    SelectOpenState &\n    SelectLabel &\n    ComboboxCollectionState &\n    Readonly<{ loop?: boolean }> &\n    Readonly<{\n      /** Preserves committed copy when transient external results omit it. */\n      selectedItem?: SelectItemDescriptor<Key>;\n      onCommit?: (key: Key | null, reason: ComboboxCommitReason) => void;\n    }>;\n\nexport function isComboboxResultCurrent(\n  queryValue: string,\n  resultQuery: string,\n): boolean {\n  return queryValue === resultQuery;\n}\n\n/**\n * External result pages are not the source of truth for a committed value.\n * A product may supply the committed descriptor while a different query is\n */\nexport function resolveComboboxSelectedItem<\n  Key extends CollectionKey,\n  SectionKey extends CollectionKey,\n>(\n  source: SelectCollectionSource<Key, SectionKey>,\n  selectedKey: Key | null,\n  selectedItem?: SelectItemDescriptor<Key>,\n): SelectItemDescriptor<Key> | null {\n  validateCollection(source);\n  if (selectedItem) validateCollection({ items: [selectedItem] });\n  if (selectedKey == null) {\n    if (selectedItem) {\n      throw new RangeError(\"selectedItem requires a selectedKey\");\n    }\n    return null;\n  }\n  if (selectedItem && selectedItem.id !== selectedKey) {\n    throw new RangeError(\"selectedItem id must match selectedKey\");\n  }\n  // A supplied descriptor is the committed snapshot. Prefer it even if a\n  // stale external page happens to contain the same stable key.\n  if (selectedItem) return selectedItem;\n  const itemInResults = source.sections\n    ? source.sections\n        .flatMap((section) => section.items)\n        .find((item) => item.id === selectedKey)\n    : source.items.find((item) => item.id === selectedKey);\n  if (itemInResults) return itemInResults;\n  throw new RangeError(`Selected combobox item is unavailable: ${selectedKey}`);\n}\n"]}

package/dist/color-references.d.ts

@@ -0,0 +1,46 @@
+import { type AccentTone, type ThemeColors } from "./colors.js";
+/**
+ * Recipes point at semantic colors instead of copying a palette value.
+ * Renderers resolve the reference with the active theme and accent map.
+ */
+export type ThemeColorReference = Readonly<{
+    source: "theme";
+    key: keyof ThemeColors;
+    alpha?: number;
+}>;
+export type AccentColorReference = Readonly<{
+    source: "accent";
+    key: AccentTone;
+    alpha?: number;
+}>;
+export type AccentFillReference = Readonly<{
+    source: "accentFill";
+    key: AccentTone;
+    alpha?: number;
+}>;
+export type ColorReference = ThemeColorReference | AccentColorReference | AccentFillReference;
+export type ColorReferencePalette = Readonly<{
+    theme: Readonly<ThemeColors>;
+    /** Generic feedback roles. Product aliases belong in a separate product map. */
+    statusAccents: Readonly<Record<AccentTone, string>>;
+    /** Solid fills stay generic too; products may map their vocabulary separately. */
+    statusAccentFills: Readonly<Record<AccentTone, string>>;
+}>;
+export declare function themeColor<K extends keyof ThemeColors>(key: K, alpha?: number): Readonly<{
+    source: "theme";
+    key: K;
+    alpha?: number;
+}>;
+export declare function accentColor<K extends AccentTone>(key: K, alpha?: number): Readonly<{
+    source: "accent";
+    key: K;
+    alpha?: number;
+}>;
+export declare function solidAccentColor<K extends AccentTone>(key: K, alpha?: number): Readonly<{
+    source: "accentFill";
+    key: K;
+    alpha?: number;
+}>;
+/** Resolve a recipe color without coupling the recipe to CSS or React Native. */
+export declare function resolveColorReference(reference: ColorReference, palette: ColorReferencePalette): string;
+//# sourceMappingURL=color-references.d.ts.map

package/dist/color-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-references.d.ts","sourceRoot":"","sources":["../src/color-references.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,MAAM,WAAW,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,MAAM,EAAE,QAAQ,CAAC;IACjB,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GACtB,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,CAAC;AAExB,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC7B,gFAAgF;IAChF,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,kFAAkF;IAClF,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD,CAAC,CAAC;AAQH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,WAAW,EACpD,GAAG,EAAE,CAAC,EACN,KAAK,CAAC,EAAE,MAAM,GACb,QAAQ,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAIvD;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,UAAU,EAC9C,GAAG,EAAE,CAAC,EACN,KAAK,CAAC,EAAE,MAAM,GACb,QAAQ,CAAC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAIxD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,UAAU,EACnD,GAAG,EAAE,CAAC,EACN,KAAK,CAAC,EAAE,MAAM,GACb,QAAQ,CAAC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAI5D;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE,qBAAqB,GAC7B,MAAM,CAiBR"}

package/dist/color-references.js

@@ -0,0 +1,39 @@
+import { withAlpha, } from "./colors.js";
+function assertAlpha(alpha) {
+    if (!Number.isFinite(alpha) || alpha < 0 || alpha > 1) {
+        throw new RangeError("Color reference alpha must be between 0 and 1");
+    }
+}
+export function themeColor(key, alpha) {
+    if (alpha === undefined)
+        return { source: "theme", key };
+    assertAlpha(alpha);
+    return { source: "theme", key, alpha };
+}
+export function accentColor(key, alpha) {
+    if (alpha === undefined)
+        return { source: "accent", key };
+    assertAlpha(alpha);
+    return { source: "accent", key, alpha };
+}
+export function solidAccentColor(key, alpha) {
+    if (alpha === undefined)
+        return { source: "accentFill", key };
+    assertAlpha(alpha);
+    return { source: "accentFill", key, alpha };
+}
+/** Resolve a recipe color without coupling the recipe to CSS or React Native. */
+export function resolveColorReference(reference, palette) {
+    const value = reference.source === "theme"
+        ? palette.theme[reference.key]
+        : reference.source === "accent"
+            ? palette.statusAccents[reference.key]
+            : palette.statusAccentFills[reference.key];
+    if (typeof value !== "string") {
+        throw new TypeError(`Missing ${reference.source} color for semantic key \"${reference.key}\"`);
+    }
+    return reference.alpha === undefined || reference.alpha === 1
+        ? value
+        : withAlpha(value, reference.alpha);
+}
+//# sourceMappingURL=color-references.js.map

package/dist/color-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-references.js","sourceRoot":"","sources":["../src/color-references.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,GAGV,MAAM,aAAa,CAAC;AAqCrB,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,UAAU,CAAC,+CAA+C,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,GAAM,EACN,KAAc;IAEd,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IACzD,WAAW,CAAC,KAAK,CAAC,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,GAAM,EACN,KAAc;IAEd,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAC1D,WAAW,CAAC,KAAK,CAAC,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,GAAM,EACN,KAAc;IAEd,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;IAC9D,WAAW,CAAC,KAAK,CAAC,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AAC9C,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,qBAAqB,CACnC,SAAyB,EACzB,OAA8B;IAE9B,MAAM,KAAK,GACT,SAAS,CAAC,MAAM,KAAK,OAAO;QAC1B,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC;QAC9B,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,QAAQ;YAC7B,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC;YACtC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAEjD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,SAAS,CACjB,WAAW,SAAS,CAAC,MAAM,6BAA6B,SAAS,CAAC,GAAG,IAAI,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC,KAAK,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,KAAK,CAAC;QAC3D,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC","sourcesContent":["import {\n  withAlpha,\n  type AccentTone,\n  type ThemeColors,\n} from \"./colors.js\";\n\n/**\n * Recipes point at semantic colors instead of copying a palette value.\n * Renderers resolve the reference with the active theme and accent map.\n */\nexport type ThemeColorReference = Readonly<{\n  source: \"theme\";\n  key: keyof ThemeColors;\n  alpha?: number;\n}>;\n\nexport type AccentColorReference = Readonly<{\n  source: \"accent\";\n  key: AccentTone;\n  alpha?: number;\n}>;\n\nexport type AccentFillReference = Readonly<{\n  source: \"accentFill\";\n  key: AccentTone;\n  alpha?: number;\n}>;\n\nexport type ColorReference =\n  | ThemeColorReference\n  | AccentColorReference\n  | AccentFillReference;\n\nexport type ColorReferencePalette = Readonly<{\n  theme: Readonly<ThemeColors>;\n  /** Generic feedback roles. Product aliases belong in a separate product map. */\n  statusAccents: Readonly<Record<AccentTone, string>>;\n  /** Solid fills stay generic too; products may map their vocabulary separately. */\n  statusAccentFills: Readonly<Record<AccentTone, string>>;\n}>;\n\nfunction assertAlpha(alpha: number): void {\n  if (!Number.isFinite(alpha) || alpha < 0 || alpha > 1) {\n    throw new RangeError(\"Color reference alpha must be between 0 and 1\");\n  }\n}\n\nexport function themeColor<K extends keyof ThemeColors>(\n  key: K,\n  alpha?: number,\n): Readonly<{ source: \"theme\"; key: K; alpha?: number }> {\n  if (alpha === undefined) return { source: \"theme\", key };\n  assertAlpha(alpha);\n  return { source: \"theme\", key, alpha };\n}\n\nexport function accentColor<K extends AccentTone>(\n  key: K,\n  alpha?: number,\n): Readonly<{ source: \"accent\"; key: K; alpha?: number }> {\n  if (alpha === undefined) return { source: \"accent\", key };\n  assertAlpha(alpha);\n  return { source: \"accent\", key, alpha };\n}\n\nexport function solidAccentColor<K extends AccentTone>(\n  key: K,\n  alpha?: number,\n): Readonly<{ source: \"accentFill\"; key: K; alpha?: number }> {\n  if (alpha === undefined) return { source: \"accentFill\", key };\n  assertAlpha(alpha);\n  return { source: \"accentFill\", key, alpha };\n}\n\n/** Resolve a recipe color without coupling the recipe to CSS or React Native. */\nexport function resolveColorReference(\n  reference: ColorReference,\n  palette: ColorReferencePalette,\n): string {\n  const value =\n    reference.source === \"theme\"\n      ? palette.theme[reference.key]\n      : reference.source === \"accent\"\n        ? palette.statusAccents[reference.key]\n        : palette.statusAccentFills[reference.key];\n\n  if (typeof value !== \"string\") {\n    throw new TypeError(\n      `Missing ${reference.source} color for semantic key \\\"${reference.key}\\\"`,\n    );\n  }\n\n  return reference.alpha === undefined || reference.alpha === 1\n    ? value\n    : withAlpha(value, reference.alpha);\n}\n"]}

package/dist/colors.d.ts

@@ -0,0 +1,56 @@
+/** A persisted preference is an application concern; this package only defines valid values. */
+export type ThemePreference = "system" | "light" | "dark";
+export type ResolvedTheme = Exclude<ThemePreference, "system">;
+export declare function isThemePreference(value: unknown): value is ThemePreference;
+/**
+ * Product code chooses colors by meaning, never by a raw palette name.
+ * Both themes deliberately expose exactly the same keys.
+ */
+export type ThemeColors = {
+    bg: string;
+    surface: string;
+    surfaceAlt: string;
+    surfaceAccent: string;
+    border: string;
+    text: string;
+    textBody: string;
+    textMuted: string;
+    textSub: string;
+    textWeak: string;
+    primary: string;
+    contentBrand: string;
+    danger: string;
+    onPrimary: string;
+    dangerFill: string;
+    onDanger: string;
+};
+export declare const THEMES: Readonly<Record<ResolvedTheme, Readonly<ThemeColors>>>;
+/** Generic emphasis roles. Product-specific meanings are mapped by each consumer. */
+export type AccentTone = "info" | "success" | "warning" | "attention";
+export declare const ACCENTS: Readonly<Record<ResolvedTheme, Readonly<Record<AccentTone, string>>>>;
+/** Solid emphasis fills always pair with `onAccentFill`. */
+export declare const accentFill: Readonly<Record<AccentTone, string>>;
+export declare const onAccentFill = "#ffffff";
+export declare const accentTint: {
+    readonly weak: 0.1;
+    readonly base: 0.15;
+    readonly strong: 0.2;
+    readonly border: 0.3;
+};
+/** Shared visual signature. Renderers translate the normalized coordinates. */
+export declare const brandGradient: {
+    readonly from: "#0369a1";
+    readonly to: "#155dfc";
+    readonly start: {
+        readonly x: 0;
+        readonly y: 0;
+    };
+    readonly end: {
+        readonly x: 1;
+        readonly y: 1;
+    };
+};
+export declare const onBrandGradient = "#ffffff";
+/** Add an alpha channel without coupling callers to a CSS or React Native helper. */
+export declare function withAlpha(hex: string, alpha: number): string;
+//# sourceMappingURL=colors.d.ts.map

package/dist/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../src/colors.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;AAE/D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAwCF,eAAO,MAAM,MAAM,EAAE,QAAQ,CAC3B,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAC3B,CAAC;AAEpB,qFAAqF;AACrF,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAEtE,eAAO,MAAM,OAAO,EAAE,QAAQ,CAC5B,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAc5D,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAK3D,CAAC;AAEF,eAAO,MAAM,YAAY,YAAY,CAAC;AAEtC,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX,+EAA+E;AAC/E,eAAO,MAAM,aAAa;;;;;;;;;;;CAKhB,CAAC;AAEX,eAAO,MAAM,eAAe,YAAY,CAAC;AAEzC,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAc5D"}

package/dist/colors.js

@@ -0,0 +1,90 @@
+export function isThemePreference(value) {
+    return value === "system" || value === "light" || value === "dark";
+}
+const light = {
+    bg: "#ffffff",
+    surface: "#f2f4f6",
+    surfaceAlt: "#e5e8eb",
+    surfaceAccent: "#c9e2ff",
+    border: "#e5e8eb",
+    text: "#191f28",
+    textBody: "#333d4b",
+    textMuted: "#4e5968",
+    textSub: "#6b7684",
+    textWeak: "#8b95a1",
+    primary: "#0369a1",
+    contentBrand: "#075985",
+    danger: "#b71919",
+    onPrimary: "#ffffff",
+    dangerFill: "#b91c1c",
+    onDanger: "#ffffff",
+};
+const dark = {
+    bg: "#0b1026",
+    surface: "#131a36",
+    surfaceAlt: "#1e293b",
+    surfaceAccent: "#1e3a5f",
+    border: "#1e293b",
+    text: "#f1f5f9",
+    textBody: "#e2e8f0",
+    textMuted: "#cbd5e1",
+    textSub: "#94a3b8",
+    textWeak: "#64748b",
+    primary: "#075985",
+    contentBrand: "#38bdf8",
+    danger: "#f87171",
+    onPrimary: "#ffffff",
+    dangerFill: "#b91c1c",
+    onDanger: "#ffffff",
+};
+export const THEMES = { light, dark };
+export const ACCENTS = {
+    light: {
+        info: "#6d28d9",
+        success: "#065f46",
+        warning: "#92400e",
+        attention: "#9a3412",
+    },
+    dark: {
+        info: "#a78bfa",
+        success: "#34d399",
+        warning: "#fbbf24",
+        attention: "#fb923c",
+    },
+};
+/** Solid emphasis fills always pair with `onAccentFill`. */
+export const accentFill = {
+    info: "#6d28d9",
+    success: "#065f46",
+    warning: "#92400e",
+    attention: "#9a3412",
+};
+export const onAccentFill = "#ffffff";
+export const accentTint = {
+    weak: 0.1,
+    base: 0.15,
+    strong: 0.2,
+    border: 0.3,
+};
+/** Shared visual signature. Renderers translate the normalized coordinates. */
+export const brandGradient = {
+    from: "#0369a1",
+    to: "#155dfc",
+    start: { x: 0, y: 0 },
+    end: { x: 1, y: 1 },
+};
+export const onBrandGradient = "#ffffff";
+/** Add an alpha channel without coupling callers to a CSS or React Native helper. */
+export function withAlpha(hex, alpha) {
+    const match = /^#([0-9a-fA-F]{6})$/.exec(hex);
+    if (!match) {
+        throw new TypeError("A six-digit hex color is required");
+    }
+    if (!Number.isFinite(alpha) || alpha < 0 || alpha > 1) {
+        throw new RangeError("Alpha must be a finite number between 0 and 1");
+    }
+    const source = match[1];
+    const channels = [0, 2, 4].map((offset) => Number.parseInt(source.slice(offset, offset + 2), 16));
+    return `rgba(${channels[0]}, ${channels[1]}, ${channels[2]}, ${alpha})`;
+}
+//# sourceMappingURL=colors.js.map

package/dist/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../src/colors.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,CAAC;AACrE,CAAC;AAyBD,MAAM,KAAK,GAAG;IACZ,EAAE,EAAE,SAAS;IACb,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,SAAS;IACrB,aAAa,EAAE,SAAS;IACxB,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,SAAS;IACnB,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,SAAS;IACvB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,SAAS;IACrB,QAAQ,EAAE,SAAS;CACW,CAAC;AAEjC,MAAM,IAAI,GAAG;IACX,EAAE,EAAE,SAAS;IACb,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,SAAS;IACrB,aAAa,EAAE,SAAS;IACxB,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,SAAS;IACnB,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,SAAS;IACvB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,SAAS;IACrB,QAAQ,EAAE,SAAS;CACW,CAAC;AAEjC,MAAM,CAAC,MAAM,MAAM,GAEf,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAKpB,MAAM,CAAC,MAAM,OAAO,GAEhB;IACF,KAAK,EAAE;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,SAAS;KACrB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,SAAS;KACrB;CACF,CAAC;AAEF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,UAAU,GAAyC;IAC9D,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,SAAS;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC;AAEtC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,GAAG;IACX,MAAM,EAAE,GAAG;CACH,CAAC;AAEX,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,SAAS;IACf,EAAE,EAAE,SAAS;IACb,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACrB,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;CACX,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC;AAEzC,qFAAqF;AACrF,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,KAAa;IAClD,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,UAAU,CAAC,+CAA+C,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IACzB,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACxC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CACtD,CAAC;IACF,OAAO,QAAQ,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC;AAC1E,CAAC","sourcesContent":["/** A persisted preference is an application concern; this package only defines valid values. */\nexport type ThemePreference = \"system\" | \"light\" | \"dark\";\nexport type ResolvedTheme = Exclude<ThemePreference, \"system\">;\n\nexport function isThemePreference(value: unknown): value is ThemePreference {\n  return value === \"system\" || value === \"light\" || value === \"dark\";\n}\n\n/**\n * Product code chooses colors by meaning, never by a raw palette name.\n * Both themes deliberately expose exactly the same keys.\n */\nexport type ThemeColors = {\n  bg: string;\n  surface: string;\n  surfaceAlt: string;\n  surfaceAccent: string;\n  border: string;\n  text: string;\n  textBody: string;\n  textMuted: string;\n  textSub: string;\n  textWeak: string;\n  primary: string;\n  contentBrand: string;\n  danger: string;\n  onPrimary: string;\n  dangerFill: string;\n  onDanger: string;\n};\n\nconst light = {\n  bg: \"#ffffff\",\n  surface: \"#f2f4f6\",\n  surfaceAlt: \"#e5e8eb\",\n  surfaceAccent: \"#c9e2ff\",\n  border: \"#e5e8eb\",\n  text: \"#191f28\",\n  textBody: \"#333d4b\",\n  textMuted: \"#4e5968\",\n  textSub: \"#6b7684\",\n  textWeak: \"#8b95a1\",\n  primary: \"#0369a1\",\n  contentBrand: \"#075985\",\n  danger: \"#b71919\",\n  onPrimary: \"#ffffff\",\n  dangerFill: \"#b91c1c\",\n  onDanger: \"#ffffff\",\n} as const satisfies ThemeColors;\n\nconst dark = {\n  bg: \"#0b1026\",\n  surface: \"#131a36\",\n  surfaceAlt: \"#1e293b\",\n  surfaceAccent: \"#1e3a5f\",\n  border: \"#1e293b\",\n  text: \"#f1f5f9\",\n  textBody: \"#e2e8f0\",\n  textMuted: \"#cbd5e1\",\n  textSub: \"#94a3b8\",\n  textWeak: \"#64748b\",\n  primary: \"#075985\",\n  contentBrand: \"#38bdf8\",\n  danger: \"#f87171\",\n  onPrimary: \"#ffffff\",\n  dangerFill: \"#b91c1c\",\n  onDanger: \"#ffffff\",\n} as const satisfies ThemeColors;\n\nexport const THEMES: Readonly<\n  Record<ResolvedTheme, Readonly<ThemeColors>>\n> = { light, dark };\n\n/** Generic emphasis roles. Product-specific meanings are mapped by each consumer. */\nexport type AccentTone = \"info\" | \"success\" | \"warning\" | \"attention\";\n\nexport const ACCENTS: Readonly<\n  Record<ResolvedTheme, Readonly<Record<AccentTone, string>>>\n> = {\n  light: {\n    info: \"#6d28d9\",\n    success: \"#065f46\",\n    warning: \"#92400e\",\n    attention: \"#9a3412\",\n  },\n  dark: {\n    info: \"#a78bfa\",\n    success: \"#34d399\",\n    warning: \"#fbbf24\",\n    attention: \"#fb923c\",\n  },\n};\n\n/** Solid emphasis fills always pair with `onAccentFill`. */\nexport const accentFill: Readonly<Record<AccentTone, string>> = {\n  info: \"#6d28d9\",\n  success: \"#065f46\",\n  warning: \"#92400e\",\n  attention: \"#9a3412\",\n};\n\nexport const onAccentFill = \"#ffffff\";\n\nexport const accentTint = {\n  weak: 0.1,\n  base: 0.15,\n  strong: 0.2,\n  border: 0.3,\n} as const;\n\n/** Shared visual signature. Renderers translate the normalized coordinates. */\nexport const brandGradient = {\n  from: \"#0369a1\",\n  to: \"#155dfc\",\n  start: { x: 0, y: 0 },\n  end: { x: 1, y: 1 },\n} as const;\n\nexport const onBrandGradient = \"#ffffff\";\n\n/** Add an alpha channel without coupling callers to a CSS or React Native helper. */\nexport function withAlpha(hex: string, alpha: number): string {\n  const match = /^#([0-9a-fA-F]{6})$/.exec(hex);\n  if (!match) {\n    throw new TypeError(\"A six-digit hex color is required\");\n  }\n  if (!Number.isFinite(alpha) || alpha < 0 || alpha > 1) {\n    throw new RangeError(\"Alpha must be a finite number between 0 and 1\");\n  }\n\n  const source = match[1]!;\n  const channels = [0, 2, 4].map((offset) =>\n    Number.parseInt(source.slice(offset, offset + 2), 16),\n  );\n  return `rgba(${channels[0]}, ${channels[1]}, ${channels[2]}, ${alpha})`;\n}\n"]}