@hjmds/design-contracts 0.8.2

package/dist/date-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-picker.js","sourceRoot":"","sources":["../src/date-picker.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ColorReference } from \"./color-references.js\";\nimport type { BehaviorContract } from \"./behaviors.js\";\nimport {\n  assertIsoCalendarDate,\n  validateCalendarGridDescriptor,\n  type CalendarGridDescriptor,\n  type CalendarMonthNavigation,\n  type ComposeCalendarAccessibleName,\n  type ResolvedCalendarGridCell,\n  resolveCalendarGridDescriptor,\n  validateCalendarMonthNavigation,\n} from \"./calendar.js\";\nimport { fieldFrameContract, floatingSurfaceContract, focusIndicatorContract, formSupportContract } from \"./component-contracts.js\";\nimport { control, spacing, type GlyphSize, type TextVariant } from \"./foundations.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new TypeError(`DatePicker ${field} must not be empty`);\n  }\n}\n\n/**\n * Mirrors `SelectLabel` by shape rather than importing it: Select's type\n * lives in `collection.ts` for Select/Combobox/Menu's shared collection\n * story, and DatePicker's date grid deliberately does not adopt that\n * collection contract (see docs/calendar.md). Repeating the small, obvious\n * \"visible label or accessibility label\" shape here keeps this module\n * self-sufficient while staying consistent with the rest of the system.\n */\nexport type DatePickerLabel =\n  | Readonly<{ label: string; accessibilityLabel?: string }>\n  | Readonly<{ label?: never; accessibilityLabel: string }>;\n\nexport type DatePickerOpenChangeReason =\n  | \"trigger\"\n  | \"keyboard\"\n  | \"selection\"\n  | \"clear\"\n  | \"escape\"\n  | \"outside\"\n  | \"blur\"\n  | \"programmatic\";\n\nexport type DatePickerOpenState =\n  | Readonly<{\n      open: boolean;\n      defaultOpen?: never;\n      onOpenChange(open: boolean, reason: DatePickerOpenChangeReason): void;\n    }>\n  | Readonly<{\n      open?: never;\n      defaultOpen?: boolean;\n      onOpenChange?: (open: boolean, reason: DatePickerOpenChangeReason) => void;\n    }>;\n\n/**\n * A committed date closes the popover/sheet the same way Select's\n * `selection-requests-close-and-restores-trigger-focus` scenario works.\n * `clear` commits `null` without reopening — this is the field's only\n * \"empty\" affordance; there is no separate disallow-empty configuration\n * because an optional date field is the common case (unlike Select, which\n * more often names a required option).\n */\nexport type DatePickerSelection =\n  | Readonly<{\n      selectedDate: string | null;\n      defaultSelectedDate?: never;\n      onSelectionChange(date: string | null, reason: \"activate\" | \"clear\"): void;\n    }>\n  | Readonly<{\n      selectedDate?: never;\n      defaultSelectedDate?: string | null;\n      onSelectionChange?: (date: string | null, reason: \"activate\" | \"clear\") => void;\n    }>;\n\nexport function validateDatePickerSelection(selection: DatePickerSelection): void {\n  const selected = selection.selectedDate ?? selection.defaultSelectedDate;\n  if (selected != null) assertIsoCalendarDate(selected, \"selectedDate\");\n}\n\n/**\n * Field + grid + adaptive overlay. The grid itself is the exact\n * `CalendarGridDescriptor` from `calendar.ts` — Web renders it inside an\n * anchored popover, Native inside a Sheet (the `Select` adaptive split:\n * `adaptive: { web: \"popover\", native: \"sheet\" }`), but neither renderer\n * reinterprets the grid's cells, navigation, or accessible-name contract.\n */\nexport type DatePickerDescriptor<Content = unknown> = Readonly<{\n  grid: CalendarGridDescriptor<Content>;\n  /** Product-formatted trigger copy for the committed date (\"2026년 8월 19일\"); DatePicker never formats a date itself. */\n  displayValue: string | null;\n  placeholder: string;\n  disabled?: boolean;\n  readOnly?: boolean;\n  invalid?: boolean;\n}> &\n  DatePickerLabel &\n  DatePickerOpenState &\n  DatePickerSelection &\n  CalendarMonthNavigation;\n\nexport function validateDatePickerDescriptor<Content>(\n  descriptor: DatePickerDescriptor<Content>,\n): void {\n  validateCalendarGridDescriptor(descriptor.grid);\n  assertNonEmpty(descriptor.placeholder, \"placeholder\");\n  if (descriptor.displayValue !== null) {\n    assertNonEmpty(descriptor.displayValue, \"displayValue\");\n  }\n  const label = descriptor.label ?? descriptor.accessibilityLabel;\n  assertNonEmpty(label as string, \"label or accessibilityLabel\");\n  validateDatePickerSelection(descriptor);\n  validateCalendarMonthNavigation(descriptor);\n}\n\n/** Trigger copy is the committed display value, or the placeholder when nothing is selected yet. */\nexport function resolveDatePickerTriggerText(\n  descriptor: Pick<DatePickerDescriptor, \"displayValue\" | \"placeholder\">,\n): string {\n  if (descriptor.displayValue !== null) assertNonEmpty(descriptor.displayValue, \"displayValue\");\n  assertNonEmpty(descriptor.placeholder, \"placeholder\");\n  return descriptor.displayValue ?? descriptor.placeholder;\n}\n\n/**\n * Resolves the popover/sheet content: the exact same cell shape, today/\n * selected marks, and accessible names Calendar renders inline. DatePicker\n * adds no per-cell semantics of its own — only the surrounding field/overlay\n * lifecycle is new.\n */\nexport function resolveDatePickerGrid<Content>(\n  descriptor: DatePickerDescriptor<Content>,\n  options: Readonly<{ composeAccessibleName: ComposeCalendarAccessibleName<Content> }>,\n): readonly ResolvedCalendarGridCell<Content>[] {\n  validateDatePickerDescriptor(descriptor);\n  const selectedDate = descriptor.selectedDate ?? descriptor.defaultSelectedDate ?? null;\n  return resolveCalendarGridDescriptor(descriptor.grid, selectedDate, options);\n}\n\nexport type DatePickerSize = \"medium\" | \"large\";\n\n/**\n * Reuses `fieldFrameContract`/`formSupportContract` verbatim, exactly like\n * NumberField and Select each do independently — a second field frame would\n * drift the first time either one's border or height changes. `calendar`\n * anatomy is intentionally not re-declared here: the popover/sheet mounts\n * `calendarRecipe` unchanged, so this recipe only owns the field/trigger and\n * the overlay frame around it.\n */\nexport const datePickerRecipe = {\n  slots: [\n    \"root\",\n    \"label\",\n    \"trigger\",\n    \"leading\",\n    \"value\",\n    \"placeholder\",\n    \"clear\",\n    \"indicator\",\n    \"description\",\n    \"error\",\n    \"popover\",\n  ] as const,\n  defaults: { size: \"medium\" },\n  adaptive: { web: \"popover\", native: \"sheet\" },\n  frame: fieldFrameContract,\n  sizes: {\n    medium: {\n      minHeight: fieldFrameContract.minHeight,\n      paddingHorizontal: fieldFrameContract.paddingHorizontal,\n      textVariant: \"body\",\n      glyph: \"sm\",\n    },\n    large: {\n      minHeight: control.buttonHeight.large,\n      paddingHorizontal: spacing.lg,\n      textVariant: \"bodyLarge\",\n      glyph: \"md\",\n    },\n  },\n  support: formSupportContract,\n  value: {\n    color: semanticColors.content.body,\n    placeholderColor: semanticColors.content.secondary,\n  },\n  leading: { color: semanticColors.content.secondary, icon: \"calendar\" as const },\n  indicator: { color: semanticColors.content.secondary },\n  clear: {\n    diameter: control.buttonHeight.small,\n    hitSlop: control.buttonHitSlop.small,\n    glyph: \"xs\" as const,\n    color: semanticColors.content.secondary,\n  },\n  popover: {\n    ...floatingSurfaceContract,\n    minWidth: 300,\n    maxWidth: 360,\n    sideOffset: spacing.xs,\n    collisionPadding: spacing.xs,\n  },\n  states: {\n    focus: focusIndicatorContract,\n    invalidBorder: semanticColors.border.danger,\n  },\n} as const satisfies {\n  slots: readonly string[];\n  defaults: { size: DatePickerSize };\n  adaptive: { web: \"popover\"; native: \"sheet\" };\n  frame: typeof fieldFrameContract;\n  sizes: Record<\n    DatePickerSize,\n    { minHeight: number; paddingHorizontal: number; textVariant: TextVariant; glyph: GlyphSize }\n  >;\n  support: typeof formSupportContract;\n  value: { color: ColorReference; placeholderColor: ColorReference };\n  leading: { color: ColorReference; icon: \"calendar\" };\n  indicator: { color: ColorReference };\n  clear: { diameter: number; hitSlop: number; glyph: GlyphSize; color: ColorReference };\n  popover: typeof floatingSurfaceContract & {\n    minWidth: number;\n    maxWidth: number;\n    sideOffset: number;\n    collisionPadding: number;\n  };\n  states: { focus: typeof focusIndicatorContract; invalidBorder: ColorReference };\n};\n\n/**\n * Web mounts the grid as a real focus-bearing `dialog` (APG's Date Picker\n * Dialog pattern moves actual DOM focus through gridcells via roving\n * tabindex, unlike Select's `activeDescendant` listbox where focus stays on\n * the trigger). Native mounts the same grid inside a Sheet. Both close on a\n * committed selection or `clear` and restore trigger focus, matching\n * Select's own dismiss-and-restore scenario.\n */\nexport const datePickerBehavior = {\n  controlled: [\n    \"selectedDate\",\n    \"defaultSelectedDate\",\n    \"onSelectionChange\",\n    \"open\",\n    \"defaultOpen\",\n    \"onOpenChange\",\n  ],\n  inputs: [\"grid\", \"displayValue\", \"focusedMonth\", \"defaultFocusedMonth\"],\n  stateAxes: {\n    availability: [\"enabled\", \"disabled\", \"readOnly\", \"busy\"],\n    value: [\"empty\", \"selected\", \"open\"],\n    validation: [\"valid\", \"invalid\"],\n  },\n  web: {\n    roles: [\"button\", \"dialog\", \"grid\", \"row\", \"gridcell\"],\n    keyboard: [\n      \"Tab\",\n      \"Enter\",\n      \"Space\",\n      \"Escape\",\n      \"ArrowUp\",\n      \"ArrowDown\",\n      \"ArrowLeft\",\n      \"ArrowRight\",\n      \"Home\",\n      \"End\",\n    ],\n    focus: \"roving\",\n    dismiss: [\"selection\", \"escape\", \"outside\", \"blur\"],\n  },\n  native: {\n    roles: [\"button\", \"dialog\"],\n    states: [\"disabled\", \"expanded\"],\n    actions: [\"activate\", \"dismiss\"],\n    dismiss: [\"selection\", \"back\", \"outside\"],\n  },\n  scenarios: [\n    \"visible-label-or-accessibility-label-names-trigger\",\n    \"trigger-shows-the-product-formatted-display-value-or-placeholder\",\n    \"popover-and-sheet-content-reuse-the-calendar-grid-contract-unchanged\",\n    \"activating-an-enabled-date-commits-selection-and-closes\",\n    \"disabled-dates-remain-focusable-but-never-commit-or-close\",\n    \"clear-commits-null-and-closes-without-reopening\",\n    \"escape-closes-without-commit-and-restores-trigger-focus\",\n    \"outside-press-closes-without-commit\",\n    \"controlled-owner-may-defer-a-selection-close-request\",\n    \"changing-the-focused-month-never-changes-or-clears-the-selection\",\n    \"range-selection-is-not-part-of-the-contract\",\n  ],\n} as const satisfies BehaviorContract;\n"]}

package/dist/description-list.d.ts

@@ -0,0 +1,68 @@
+import type { DesignSystemTextScale } from "./design-system-provider.js";
+export type DescriptionListColumns = 1 | 2;
+/**
+ * One label-value pair. Like Statistic, DescriptionList never formats the
+ * value itself — products own locale, unit, and domain formatting and pass
+ * the finished string.
+ */
+export type DescriptionItemDescriptor<Id extends string = string> = Readonly<{
+    id: Id;
+    label: string;
+    value: string;
+}>;
+export type DescriptionListDescriptor<Id extends string = string> = Readonly<{
+    items: readonly DescriptionItemDescriptor<Id>[];
+    /** Renderer preference; the resolver may still collapse this to 1. */
+    columns?: DescriptionListColumns;
+}>;
+export declare const descriptionListDefaults: {
+    readonly columns: 2;
+};
+export type ResolvedDescriptionListDescriptor<Id extends string = string> = Readonly<{
+    items: readonly DescriptionItemDescriptor<Id>[];
+    columns: DescriptionListColumns;
+}>;
+export declare function validateDescriptionItem<Id extends string>(item: DescriptionItemDescriptor<Id>): void;
+export declare function validateDescriptionList<Id extends string>(descriptor: DescriptionListDescriptor<Id>): void;
+export declare function resolveDescriptionListDescriptor<Id extends string>(descriptor: DescriptionListDescriptor<Id>): ResolvedDescriptionListDescriptor<Id>;
+export declare const descriptionListRecipe: {
+    readonly slots: readonly ["root", "group", "item", "label", "value"];
+    readonly defaults: {
+        readonly columns: 2;
+    };
+    readonly group: {
+        readonly gap: 12;
+        readonly minItemWidth: 160;
+        readonly columns: readonly [1, 2];
+    };
+    readonly item: {
+        readonly gap: 4;
+    };
+    readonly label: {
+        readonly textVariant: "label";
+        readonly color: Readonly<{
+            source: "theme";
+            key: "textMuted";
+            alpha?: number;
+        }>;
+    };
+    readonly value: {
+        readonly textVariant: "body";
+        readonly color: Readonly<{
+            source: "theme";
+            key: "text";
+            alpha?: number;
+        }>;
+        readonly maxLines: null;
+    };
+};
+/**
+ * Owns the large-text reflow so products stop re-deriving a per-screen
+ * `textScale >= 1.6` guard (five screens missed it in the last review). The
+ * minimum item width grows with `textScale`, so at a fixed `availableWidth`
+ * the same formula that reflows for narrow screens also reflows for large
+ * text — mirrors `resolveStatisticColumnCount`'s shape in the Yajalal app-rn
+ * renderer contract.
+ */
+export declare function resolveDescriptionListColumnCount(availableWidth: number, requestedColumns: DescriptionListColumns, textScale?: DesignSystemTextScale): DescriptionListColumns;
+//# sourceMappingURL=description-list.d.ts.map

package/dist/description-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-list.d.ts","sourceRoot":"","sources":["../src/description-list.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE,MAAM,MAAM,sBAAsB,GAAG,CAAC,GAAG,CAAC,CAAC;AAE3C;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,IAAI,QAAQ,CAAC;IAC3E,EAAE,EAAE,EAAE,CAAC;IACP,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH,MAAM,MAAM,yBAAyB,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,IAAI,QAAQ,CAAC;IAC3E,KAAK,EAAE,SAAS,yBAAyB,CAAC,EAAE,CAAC,EAAE,CAAC;IAChD,sEAAsE;IACtE,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC,CAAC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;CAE8B,CAAC;AAEnE,MAAM,MAAM,iCAAiC,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,IACtE,QAAQ,CAAC;IACP,KAAK,EAAE,SAAS,yBAAyB,CAAC,EAAE,CAAC,EAAE,CAAC;IAChD,OAAO,EAAE,sBAAsB,CAAC;CACjC,CAAC,CAAC;AAQL,wBAAgB,uBAAuB,CAAC,EAAE,SAAS,MAAM,EACvD,IAAI,EAAE,yBAAyB,CAAC,EAAE,CAAC,GAClC,IAAI,CASN;AAED,wBAAgB,uBAAuB,CAAC,EAAE,SAAS,MAAM,EACvD,UAAU,EAAE,yBAAyB,CAAC,EAAE,CAAC,GACxC,IAAI,CAmBN;AAED,wBAAgB,gCAAgC,CAAC,EAAE,SAAS,MAAM,EAChE,UAAU,EAAE,yBAAyB,CAAC,EAAE,CAAC,GACxC,iCAAiC,CAAC,EAAE,CAAC,CAMvC;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiBxB,CAAC;AAEX;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAC/C,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,sBAAsB,EACxC,SAAS,GAAE,qBAAyB,GACnC,sBAAsB,CAexB"}

package/dist/description-list.js

@@ -0,0 +1,85 @@
+import { semanticColors } from "./semantic-colors.js";
+import { spacing } from "./foundations.js";
+export const descriptionListDefaults = {
+    columns: 2,
+};
+function assertCopy(value, field) {
+    if (value.trim().length === 0) {
+        throw new TypeError(`DescriptionList ${field} must not be empty`);
+    }
+}
+export function validateDescriptionItem(item) {
+    assertCopy(item.id, "id");
+    if (item.id !== item.id.trim()) {
+        throw new TypeError("DescriptionList item id must not start or end with whitespace");
+    }
+    assertCopy(item.label, `item ${item.id} label`);
+    assertCopy(item.value, `item ${item.id} value`);
+}
+export function validateDescriptionList(descriptor) {
+    if (descriptor.items.length === 0) {
+        throw new TypeError("DescriptionList must contain at least one item");
+    }
+    if (descriptor.columns !== undefined &&
+        descriptor.columns !== 1 &&
+        descriptor.columns !== 2) {
+        throw new RangeError("DescriptionList columns must be 1 or 2");
+    }
+    const ids = new Set();
+    for (const item of descriptor.items) {
+        validateDescriptionItem(item);
+        if (ids.has(item.id)) {
+            throw new TypeError(`Duplicate DescriptionList item id: ${item.id}`);
+        }
+        ids.add(item.id);
+    }
+}
+export function resolveDescriptionListDescriptor(descriptor) {
+    validateDescriptionList(descriptor);
+    return {
+        items: descriptor.items,
+        columns: descriptor.columns ?? descriptionListDefaults.columns,
+    };
+}
+export const descriptionListRecipe = {
+    slots: ["root", "group", "item", "label", "value"],
+    defaults: descriptionListDefaults,
+    group: {
+        gap: spacing.sm,
+        minItemWidth: 160,
+        columns: [1, 2],
+    },
+    item: {
+        gap: spacing.xxs,
+    },
+    label: { textVariant: "label", color: semanticColors.content.secondary },
+    value: {
+        textVariant: "body",
+        color: semanticColors.content.primary,
+        maxLines: null,
+    },
+};
+/**
+ * Owns the large-text reflow so products stop re-deriving a per-screen
+ * `textScale >= 1.6` guard (five screens missed it in the last review). The
+ * minimum item width grows with `textScale`, so at a fixed `availableWidth`
+ * the same formula that reflows for narrow screens also reflows for large
+ * text — mirrors `resolveStatisticColumnCount`'s shape in the Yajalal app-rn
+ * renderer contract.
+ */
+export function resolveDescriptionListColumnCount(availableWidth, requestedColumns, textScale = 1) {
+    if (!Number.isFinite(availableWidth) || availableWidth <= 0) {
+        return requestedColumns;
+    }
+    const scale = Number.isFinite(textScale) ? Math.max(textScale, 1) : 1;
+    const minItemWidth = descriptionListRecipe.group.minItemWidth * scale;
+    for (let columns = requestedColumns; columns >= 1; columns -= 1) {
+        const itemWidth = (availableWidth - descriptionListRecipe.group.gap * (columns - 1)) /
+            columns;
+        if (itemWidth >= minItemWidth) {
+            return columns;
+        }
+    }
+    return 1;
+}
+//# sourceMappingURL=description-list.js.map

package/dist/description-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-list.js","sourceRoot":"","sources":["../src/description-list.ts"],"names":[],"mappings":"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","sourcesContent":["import { semanticColors } from \"./semantic-colors.js\";\nimport { spacing } from \"./foundations.js\";\nimport type { DesignSystemTextScale } from \"./design-system-provider.js\";\n\nexport type DescriptionListColumns = 1 | 2;\n\n/**\n * One label-value pair. Like Statistic, DescriptionList never formats the\n * value itself — products own locale, unit, and domain formatting and pass\n * the finished string.\n */\nexport type DescriptionItemDescriptor<Id extends string = string> = Readonly<{\n  id: Id;\n  label: string;\n  value: string;\n}>;\n\nexport type DescriptionListDescriptor<Id extends string = string> = Readonly<{\n  items: readonly DescriptionItemDescriptor<Id>[];\n  /** Renderer preference; the resolver may still collapse this to 1. */\n  columns?: DescriptionListColumns;\n}>;\n\nexport const descriptionListDefaults = {\n  columns: 2,\n} as const satisfies Readonly<{ columns: DescriptionListColumns }>;\n\nexport type ResolvedDescriptionListDescriptor<Id extends string = string> =\n  Readonly<{\n    items: readonly DescriptionItemDescriptor<Id>[];\n    columns: DescriptionListColumns;\n  }>;\n\nfunction assertCopy(value: string, field: string): void {\n  if (value.trim().length === 0) {\n    throw new TypeError(`DescriptionList ${field} must not be empty`);\n  }\n}\n\nexport function validateDescriptionItem<Id extends string>(\n  item: DescriptionItemDescriptor<Id>,\n): void {\n  assertCopy(item.id, \"id\");\n  if (item.id !== item.id.trim()) {\n    throw new TypeError(\n      \"DescriptionList item id must not start or end with whitespace\",\n    );\n  }\n  assertCopy(item.label, `item ${item.id} label`);\n  assertCopy(item.value, `item ${item.id} value`);\n}\n\nexport function validateDescriptionList<Id extends string>(\n  descriptor: DescriptionListDescriptor<Id>,\n): void {\n  if (descriptor.items.length === 0) {\n    throw new TypeError(\"DescriptionList must contain at least one item\");\n  }\n  if (\n    descriptor.columns !== undefined &&\n    descriptor.columns !== 1 &&\n    descriptor.columns !== 2\n  ) {\n    throw new RangeError(\"DescriptionList columns must be 1 or 2\");\n  }\n  const ids = new Set<Id>();\n  for (const item of descriptor.items) {\n    validateDescriptionItem(item);\n    if (ids.has(item.id)) {\n      throw new TypeError(`Duplicate DescriptionList item id: ${item.id}`);\n    }\n    ids.add(item.id);\n  }\n}\n\nexport function resolveDescriptionListDescriptor<Id extends string>(\n  descriptor: DescriptionListDescriptor<Id>,\n): ResolvedDescriptionListDescriptor<Id> {\n  validateDescriptionList(descriptor);\n  return {\n    items: descriptor.items,\n    columns: descriptor.columns ?? descriptionListDefaults.columns,\n  };\n}\n\nexport const descriptionListRecipe = {\n  slots: [\"root\", \"group\", \"item\", \"label\", \"value\"] as const,\n  defaults: descriptionListDefaults,\n  group: {\n    gap: spacing.sm,\n    minItemWidth: 160,\n    columns: [1, 2] as const,\n  },\n  item: {\n    gap: spacing.xxs,\n  },\n  label: { textVariant: \"label\", color: semanticColors.content.secondary },\n  value: {\n    textVariant: \"body\",\n    color: semanticColors.content.primary,\n    maxLines: null,\n  },\n} as const;\n\n/**\n * Owns the large-text reflow so products stop re-deriving a per-screen\n * `textScale >= 1.6` guard (five screens missed it in the last review). The\n * minimum item width grows with `textScale`, so at a fixed `availableWidth`\n * the same formula that reflows for narrow screens also reflows for large\n * text — mirrors `resolveStatisticColumnCount`'s shape in the Yajalal app-rn\n * renderer contract.\n */\nexport function resolveDescriptionListColumnCount(\n  availableWidth: number,\n  requestedColumns: DescriptionListColumns,\n  textScale: DesignSystemTextScale = 1,\n): DescriptionListColumns {\n  if (!Number.isFinite(availableWidth) || availableWidth <= 0) {\n    return requestedColumns;\n  }\n  const scale = Number.isFinite(textScale) ? Math.max(textScale, 1) : 1;\n  const minItemWidth = descriptionListRecipe.group.minItemWidth * scale;\n  for (let columns = requestedColumns; columns >= 1; columns -= 1) {\n    const itemWidth =\n      (availableWidth - descriptionListRecipe.group.gap * (columns - 1)) /\n      columns;\n    if (itemWidth >= minItemWidth) {\n      return columns as DescriptionListColumns;\n    }\n  }\n  return 1;\n}\n"]}

package/dist/design-system-provider.d.ts

@@ -0,0 +1,80 @@
+import type { ColorReferencePalette } from "./color-references.js";
+import { type ResolvedTheme, type ThemePreference } from "./colors.js";
+/**
+ * Canonical logical direction. Existing public component-specific names stay
+ * source-compatible as aliases of this type instead of redeclaring the union.
+ */
+export type DesignSystemDirection = "ltr" | "rtl";
+/**
+ * A continuous OS/user font-scale multiplier (iOS Dynamic Type, Android font
+ * size, browser zoom) — not `ShowcaseTextScale`'s closed `1 | 1.5 | 2`, which
+ * only names Showcase's five fixture stories, or `description-list.ts`'s
+ * local layout clamp. This is the single upstream signal both now consume.
+ */
+export type DesignSystemTextScale = number;
+export type DesignSystemEnvironmentInput = Readonly<{
+    theme?: ThemePreference;
+    direction?: DesignSystemDirection;
+    textScale?: DesignSystemTextScale;
+    reducedMotion?: boolean;
+}>;
+export declare const designSystemEnvironmentDefaults: {
+    readonly theme: "system";
+    readonly direction: "ltr";
+    readonly textScale: 1;
+    readonly reducedMotion: false;
+};
+export type ResolvedDesignSystemEnvironment = Readonly<{
+    theme: ResolvedTheme;
+    direction: DesignSystemDirection;
+    textScale: DesignSystemTextScale;
+    reducedMotion: boolean;
+}>;
+export type ResolveDesignSystemEnvironmentOptions = Readonly<{
+    /**
+     * The platform's current OS-level scheme, consulted only when `theme`
+     * resolves to `"system"`. Renderers detect this themselves
+     * (`Appearance.getColorScheme()`, `matchMedia('(prefers-color-scheme)')`)
+     * — this package never queries the OS.
+     */
+    systemTheme: ResolvedTheme;
+    /** Optional OS/renderer signals used when neither input nor a parent supplies the axis. */
+    systemDirection?: DesignSystemDirection;
+    systemTextScale?: DesignSystemTextScale;
+    systemReducedMotion?: boolean;
+    /** A nested renderer inherits the already-resolved parent before consulting OS defaults. */
+    parent?: ResolvedDesignSystemEnvironment;
+}>;
+export type DesignSystemProviderValue = Readonly<{
+    environment: ResolvedDesignSystemEnvironment;
+    /** Palette consumed directly by `resolveColorReference`. */
+    palette: ColorReferencePalette;
+}>;
+/**
+ * Runtime boundary for reviewed full product palettes supplied to a renderer.
+ * Partial token overrides remain unsupported: every semantic role required by
+ * a recipe must be present, and alpha composition requires six-digit hex.
+ */
+export declare function validateDesignSystemProviderValue(value: DesignSystemProviderValue): void;
+export declare function validateDesignSystemEnvironmentInput(input: DesignSystemEnvironmentInput): void;
+/**
+ * A parent has already crossed the system-preference boundary. Unlike the
+ * partial input validator, this rejects `"system"`, missing axes, and every
+ * malformed resolved value instead of silently resolving them again.
+ */
+export declare function validateResolvedDesignSystemEnvironment(environment: ResolvedDesignSystemEnvironment): void;
+/**
+ * Merges partial signals with safe defaults and resolves `"system"` against
+ * the renderer-supplied `systemTheme`. This — not a React/RN context, which
+ * this package cannot own — is the entire portable contract behind antd
+ * `ConfigProvider`: see docs/design-system-provider.md for what was
+ * deliberately left to the renderer.
+ */
+export declare function resolveDesignSystemEnvironment(input: DesignSystemEnvironmentInput, options: ResolveDesignSystemEnvironmentOptions): ResolvedDesignSystemEnvironment;
+/**
+ * Resolves the portable Provider value without owning React/RN Context. A
+ * renderer stores this object in its own context and feeds `palette` directly
+ * to recipe color resolution.
+ */
+export declare function resolveDesignSystemProviderValue(input: DesignSystemEnvironmentInput, options: ResolveDesignSystemEnvironmentOptions): DesignSystemProviderValue;
+//# sourceMappingURL=design-system-provider.d.ts.map

package/dist/design-system-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-system-provider.d.ts","sourceRoot":"","sources":["../src/design-system-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,KAAK,CAAC;AAElD;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE3C,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CAAC;IAClD,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;CAU1C,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,QAAQ,CAAC;IACrD,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,qBAAqB,CAAC;IACjC,SAAS,EAAE,qBAAqB,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,MAAM,qCAAqC,GAAG,QAAQ,CAAC;IAC3D;;;;;OAKG;IACH,WAAW,EAAE,aAAa,CAAC;IAC3B,2FAA2F;IAC3F,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,4FAA4F;IAC5F,MAAM,CAAC,EAAE,+BAA+B,CAAC;CAC1C,CAAC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,WAAW,EAAE,+BAA+B,CAAC;IAC7C,4DAA4D;IAC5D,OAAO,EAAE,qBAAqB,CAAC;CAChC,CAAC,CAAC;AAyBH;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,yBAAyB,GAC/B,IAAI,CAuBN;AAsBD,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,4BAA4B,GAClC,IAAI,CAmBN;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,WAAW,EAAE,+BAA+B,GAC3C,IAAI,CASN;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE,qCAAqC,GAC7C,+BAA+B,CAsCjC;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE,qCAAqC,GAC7C,yBAAyB,CAY3B"}

package/dist/design-system-provider.js

@@ -0,0 +1,147 @@
+import { ACCENTS, THEMES, accentFill, isThemePreference, } from "./colors.js";
+export const designSystemEnvironmentDefaults = {
+    theme: "system",
+    direction: "ltr",
+    textScale: 1,
+    reducedMotion: false,
+};
+const themeColorKeys = Object.keys(THEMES.light);
+const accentColorKeys = Object.keys(ACCENTS.light);
+const sixDigitHexColor = /^#[0-9a-f]{6}$/i;
+function assertColorRecord(value, keys, field) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new TypeError(`DesignSystemProviderValue ${field} must be a color record`);
+    }
+    const record = value;
+    for (const key of keys) {
+        const color = record[key];
+        if (typeof color !== "string" || !sixDigitHexColor.test(color)) {
+            throw new TypeError(`DesignSystemProviderValue ${field}.${key} must be a six-digit hex color`);
+        }
+    }
+}
+/**
+ * Runtime boundary for reviewed full product palettes supplied to a renderer.
+ * Partial token overrides remain unsupported: every semantic role required by
+ * a recipe must be present, and alpha composition requires six-digit hex.
+ */
+export function validateDesignSystemProviderValue(value) {
+    if (value === null || typeof value !== "object") {
+        throw new TypeError("DesignSystemProviderValue must be an object");
+    }
+    if (value.environment === null || typeof value.environment !== "object") {
+        throw new TypeError("DesignSystemProviderValue environment must be an object");
+    }
+    validateResolvedDesignSystemEnvironment(value.environment);
+    const palette = value.palette;
+    if (palette === null || typeof palette !== "object") {
+        throw new TypeError("DesignSystemProviderValue palette must be an object");
+    }
+    assertColorRecord(palette.theme, themeColorKeys, "palette.theme");
+    assertColorRecord(palette.statusAccents, accentColorKeys, "palette.statusAccents");
+    assertColorRecord(palette.statusAccentFills, accentColorKeys, "palette.statusAccentFills");
+}
+function assertBoolean(value, field) {
+    if (typeof value !== "boolean") {
+        throw new TypeError(`DesignSystemEnvironment ${field} must be a boolean`);
+    }
+}
+function assertDirection(value, field) {
+    if (value !== "ltr" && value !== "rtl") {
+        throw new TypeError(`Unsupported DesignSystemEnvironment ${field}: ${String(value)}`);
+    }
+}
+function assertTextScale(value, field) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        throw new RangeError(`DesignSystemEnvironment ${field} must be a finite number greater than 0`);
+    }
+}
+export function validateDesignSystemEnvironmentInput(input) {
+    if (input.theme !== undefined && !isThemePreference(input.theme)) {
+        throw new TypeError(`Unsupported DesignSystemEnvironment theme: ${String(input.theme)}`);
+    }
+    if (input.direction !== undefined &&
+        input.direction !== "ltr" &&
+        input.direction !== "rtl") {
+        throw new TypeError(`Unsupported DesignSystemEnvironment direction: ${String(input.direction)}`);
+    }
+    if (input.textScale !== undefined) {
+        assertTextScale(input.textScale, "textScale");
+    }
+    if (input.reducedMotion !== undefined) {
+        assertBoolean(input.reducedMotion, "reducedMotion");
+    }
+}
+/**
+ * A parent has already crossed the system-preference boundary. Unlike the
+ * partial input validator, this rejects `"system"`, missing axes, and every
+ * malformed resolved value instead of silently resolving them again.
+ */
+export function validateResolvedDesignSystemEnvironment(environment) {
+    if (environment.theme !== "light" && environment.theme !== "dark") {
+        throw new TypeError(`Unsupported ResolvedDesignSystemEnvironment theme: ${String(environment.theme)}`);
+    }
+    assertDirection(environment.direction, "parent direction");
+    assertTextScale(environment.textScale, "parent textScale");
+    assertBoolean(environment.reducedMotion, "parent reducedMotion");
+}
+/**
+ * Merges partial signals with safe defaults and resolves `"system"` against
+ * the renderer-supplied `systemTheme`. This — not a React/RN context, which
+ * this package cannot own — is the entire portable contract behind antd
+ * `ConfigProvider`: see docs/design-system-provider.md for what was
+ * deliberately left to the renderer.
+ */
+export function resolveDesignSystemEnvironment(input, options) {
+    validateDesignSystemEnvironmentInput(input);
+    if (options.systemTheme !== "light" && options.systemTheme !== "dark") {
+        throw new TypeError(`Unsupported DesignSystemEnvironment systemTheme: ${String(options.systemTheme)}`);
+    }
+    if (options.systemDirection !== undefined) {
+        assertDirection(options.systemDirection, "systemDirection");
+    }
+    if (options.systemTextScale !== undefined) {
+        assertTextScale(options.systemTextScale, "systemTextScale");
+    }
+    if (options.systemReducedMotion !== undefined) {
+        assertBoolean(options.systemReducedMotion, "systemReducedMotion");
+    }
+    if (options.parent !== undefined) {
+        validateResolvedDesignSystemEnvironment(options.parent);
+    }
+    const theme = input.theme ?? options.parent?.theme ?? designSystemEnvironmentDefaults.theme;
+    return {
+        theme: theme === "system" ? options.systemTheme : theme,
+        direction: input.direction ??
+            options.parent?.direction ??
+            options.systemDirection ??
+            designSystemEnvironmentDefaults.direction,
+        textScale: input.textScale ??
+            options.parent?.textScale ??
+            options.systemTextScale ??
+            designSystemEnvironmentDefaults.textScale,
+        reducedMotion: input.reducedMotion ??
+            options.parent?.reducedMotion ??
+            options.systemReducedMotion ??
+            designSystemEnvironmentDefaults.reducedMotion,
+    };
+}
+/**
+ * Resolves the portable Provider value without owning React/RN Context. A
+ * renderer stores this object in its own context and feeds `palette` directly
+ * to recipe color resolution.
+ */
+export function resolveDesignSystemProviderValue(input, options) {
+    const environment = resolveDesignSystemEnvironment(input, options);
+    const value = {
+        environment,
+        palette: {
+            theme: THEMES[environment.theme],
+            statusAccents: ACCENTS[environment.theme],
+            statusAccentFills: accentFill,
+        },
+    };
+    validateDesignSystemProviderValue(value);
+    return value;
+}
+//# sourceMappingURL=design-system-provider.js.map

package/dist/design-system-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-system-provider.js","sourceRoot":"","sources":["../src/design-system-provider.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ColorReferencePalette } from \"./color-references.js\";\nimport {\n  ACCENTS,\n  THEMES,\n  accentFill,\n  isThemePreference,\n  type ResolvedTheme,\n  type ThemePreference,\n} from \"./colors.js\";\n\n/**\n * Canonical logical direction. Existing public component-specific names stay\n * source-compatible as aliases of this type instead of redeclaring the union.\n */\nexport type DesignSystemDirection = \"ltr\" | \"rtl\";\n\n/**\n * A continuous OS/user font-scale multiplier (iOS Dynamic Type, Android font\n * size, browser zoom) — not `ShowcaseTextScale`'s closed `1 | 1.5 | 2`, which\n * only names Showcase's five fixture stories, or `description-list.ts`'s\n * local layout clamp. This is the single upstream signal both now consume.\n */\nexport type DesignSystemTextScale = number;\n\nexport type DesignSystemEnvironmentInput = Readonly<{\n  theme?: ThemePreference;\n  direction?: DesignSystemDirection;\n  textScale?: DesignSystemTextScale;\n  reducedMotion?: boolean;\n}>;\n\nexport const designSystemEnvironmentDefaults = {\n  theme: \"system\",\n  direction: \"ltr\",\n  textScale: 1,\n  reducedMotion: false,\n} as const satisfies Readonly<{\n  theme: ThemePreference;\n  direction: DesignSystemDirection;\n  textScale: DesignSystemTextScale;\n  reducedMotion: boolean;\n}>;\n\nexport type ResolvedDesignSystemEnvironment = Readonly<{\n  theme: ResolvedTheme;\n  direction: DesignSystemDirection;\n  textScale: DesignSystemTextScale;\n  reducedMotion: boolean;\n}>;\n\nexport type ResolveDesignSystemEnvironmentOptions = Readonly<{\n  /**\n   * The platform's current OS-level scheme, consulted only when `theme`\n   * resolves to `\"system\"`. Renderers detect this themselves\n   * (`Appearance.getColorScheme()`, `matchMedia('(prefers-color-scheme)')`)\n   * — this package never queries the OS.\n   */\n  systemTheme: ResolvedTheme;\n  /** Optional OS/renderer signals used when neither input nor a parent supplies the axis. */\n  systemDirection?: DesignSystemDirection;\n  systemTextScale?: DesignSystemTextScale;\n  systemReducedMotion?: boolean;\n  /** A nested renderer inherits the already-resolved parent before consulting OS defaults. */\n  parent?: ResolvedDesignSystemEnvironment;\n}>;\n\nexport type DesignSystemProviderValue = Readonly<{\n  environment: ResolvedDesignSystemEnvironment;\n  /** Palette consumed directly by `resolveColorReference`. */\n  palette: ColorReferencePalette;\n}>;\n\nconst themeColorKeys = Object.keys(THEMES.light) as readonly (keyof typeof THEMES.light)[];\nconst accentColorKeys = Object.keys(ACCENTS.light) as readonly (keyof typeof ACCENTS.light)[];\nconst sixDigitHexColor = /^#[0-9a-f]{6}$/i;\n\nfunction assertColorRecord(\n  value: unknown,\n  keys: readonly string[],\n  field: string,\n): asserts value is Readonly<Record<string, string>> {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    throw new TypeError(`DesignSystemProviderValue ${field} must be a color record`);\n  }\n  const record = value as Readonly<Record<string, unknown>>;\n  for (const key of keys) {\n    const color = record[key];\n    if (typeof color !== \"string\" || !sixDigitHexColor.test(color)) {\n      throw new TypeError(\n        `DesignSystemProviderValue ${field}.${key} must be a six-digit hex color`,\n      );\n    }\n  }\n}\n\n/**\n * Runtime boundary for reviewed full product palettes supplied to a renderer.\n * Partial token overrides remain unsupported: every semantic role required by\n * a recipe must be present, and alpha composition requires six-digit hex.\n */\nexport function validateDesignSystemProviderValue(\n  value: DesignSystemProviderValue,\n): void {\n  if (value === null || typeof value !== \"object\") {\n    throw new TypeError(\"DesignSystemProviderValue must be an object\");\n  }\n  if (value.environment === null || typeof value.environment !== \"object\") {\n    throw new TypeError(\"DesignSystemProviderValue environment must be an object\");\n  }\n  validateResolvedDesignSystemEnvironment(value.environment);\n  const palette = value.palette;\n  if (palette === null || typeof palette !== \"object\") {\n    throw new TypeError(\"DesignSystemProviderValue palette must be an object\");\n  }\n  assertColorRecord(palette.theme, themeColorKeys, \"palette.theme\");\n  assertColorRecord(\n    palette.statusAccents,\n    accentColorKeys,\n    \"palette.statusAccents\",\n  );\n  assertColorRecord(\n    palette.statusAccentFills,\n    accentColorKeys,\n    \"palette.statusAccentFills\",\n  );\n}\n\nfunction assertBoolean(value: boolean, field: string): void {\n  if (typeof value !== \"boolean\") {\n    throw new TypeError(`DesignSystemEnvironment ${field} must be a boolean`);\n  }\n}\n\nfunction assertDirection(value: DesignSystemDirection, field: string): void {\n  if (value !== \"ltr\" && value !== \"rtl\") {\n    throw new TypeError(`Unsupported DesignSystemEnvironment ${field}: ${String(value)}`);\n  }\n}\n\nfunction assertTextScale(value: DesignSystemTextScale, field: string): void {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value <= 0) {\n    throw new RangeError(\n      `DesignSystemEnvironment ${field} must be a finite number greater than 0`,\n    );\n  }\n}\n\nexport function validateDesignSystemEnvironmentInput(\n  input: DesignSystemEnvironmentInput,\n): void {\n  if (input.theme !== undefined && !isThemePreference(input.theme)) {\n    throw new TypeError(`Unsupported DesignSystemEnvironment theme: ${String(input.theme)}`);\n  }\n  if (\n    input.direction !== undefined &&\n    input.direction !== \"ltr\" &&\n    input.direction !== \"rtl\"\n  ) {\n    throw new TypeError(\n      `Unsupported DesignSystemEnvironment direction: ${String(input.direction)}`,\n    );\n  }\n  if (input.textScale !== undefined) {\n    assertTextScale(input.textScale, \"textScale\");\n  }\n  if (input.reducedMotion !== undefined) {\n    assertBoolean(input.reducedMotion, \"reducedMotion\");\n  }\n}\n\n/**\n * A parent has already crossed the system-preference boundary. Unlike the\n * partial input validator, this rejects `\"system\"`, missing axes, and every\n * malformed resolved value instead of silently resolving them again.\n */\nexport function validateResolvedDesignSystemEnvironment(\n  environment: ResolvedDesignSystemEnvironment,\n): void {\n  if (environment.theme !== \"light\" && environment.theme !== \"dark\") {\n    throw new TypeError(\n      `Unsupported ResolvedDesignSystemEnvironment theme: ${String(environment.theme)}`,\n    );\n  }\n  assertDirection(environment.direction, \"parent direction\");\n  assertTextScale(environment.textScale, \"parent textScale\");\n  assertBoolean(environment.reducedMotion, \"parent reducedMotion\");\n}\n\n/**\n * Merges partial signals with safe defaults and resolves `\"system\"` against\n * the renderer-supplied `systemTheme`. This — not a React/RN context, which\n * this package cannot own — is the entire portable contract behind antd\n * `ConfigProvider`: see docs/design-system-provider.md for what was\n * deliberately left to the renderer.\n */\nexport function resolveDesignSystemEnvironment(\n  input: DesignSystemEnvironmentInput,\n  options: ResolveDesignSystemEnvironmentOptions,\n): ResolvedDesignSystemEnvironment {\n  validateDesignSystemEnvironmentInput(input);\n  if (options.systemTheme !== \"light\" && options.systemTheme !== \"dark\") {\n    throw new TypeError(`Unsupported DesignSystemEnvironment systemTheme: ${String(options.systemTheme)}`);\n  }\n  if (options.systemDirection !== undefined) {\n    assertDirection(options.systemDirection, \"systemDirection\");\n  }\n  if (options.systemTextScale !== undefined) {\n    assertTextScale(options.systemTextScale, \"systemTextScale\");\n  }\n  if (options.systemReducedMotion !== undefined) {\n    assertBoolean(options.systemReducedMotion, \"systemReducedMotion\");\n  }\n  if (options.parent !== undefined) {\n    validateResolvedDesignSystemEnvironment(options.parent);\n  }\n\n  const theme =\n    input.theme ?? options.parent?.theme ?? designSystemEnvironmentDefaults.theme;\n  return {\n    theme: theme === \"system\" ? options.systemTheme : theme,\n    direction:\n      input.direction ??\n      options.parent?.direction ??\n      options.systemDirection ??\n      designSystemEnvironmentDefaults.direction,\n    textScale:\n      input.textScale ??\n      options.parent?.textScale ??\n      options.systemTextScale ??\n      designSystemEnvironmentDefaults.textScale,\n    reducedMotion:\n      input.reducedMotion ??\n      options.parent?.reducedMotion ??\n      options.systemReducedMotion ??\n      designSystemEnvironmentDefaults.reducedMotion,\n  };\n}\n\n/**\n * Resolves the portable Provider value without owning React/RN Context. A\n * renderer stores this object in its own context and feeds `palette` directly\n * to recipe color resolution.\n */\nexport function resolveDesignSystemProviderValue(\n  input: DesignSystemEnvironmentInput,\n  options: ResolveDesignSystemEnvironmentOptions,\n): DesignSystemProviderValue {\n  const environment = resolveDesignSystemEnvironment(input, options);\n  const value = {\n    environment,\n    palette: {\n      theme: THEMES[environment.theme],\n      statusAccents: ACCENTS[environment.theme],\n      statusAccentFills: accentFill,\n    },\n  };\n  validateDesignSystemProviderValue(value);\n  return value;\n}\n"]}

package/dist/evidence.d.ts

@@ -0,0 +1,49 @@
+import { type ShowcaseComponentEntry, type ShowcaseCoverageEntry, type ShowcaseEvidenceEntry, type ShowcaseScenarioId, type ShowcaseSurface } from "./showcase.js";
+export declare const designSystemEvidenceSchemaVersion: 1;
+export type DesignSystemEvidenceSourceKind = "storybook" | "interaction-test" | "accessibility-audit" | "visual-regression" | "device-test" | "contract-test";
+export type DesignSystemEvidenceSource = Readonly<{
+    /** Stable repository or product identifier, for example `burntok-web`. */
+    id: string;
+    /** Human-readable owner shown in generated reports. */
+    product: string;
+    surface: ShowcaseSurface;
+    kind: DesignSystemEvidenceSourceKind;
+    /** Optional immutable Git revision or release identifier. */
+    revision?: string;
+}>;
+export type DesignSystemEvidenceItem = Readonly<{
+    /** Canonical `category/component-id` from `showcaseManifest`. */
+    storyId: string;
+    scenarios: readonly ShowcaseScenarioId[];
+    /** Product Storybook id when it differs from the canonical HJM id. */
+    storybookStoryId?: string;
+}>;
+export type DesignSystemEvidenceManifest = Readonly<{
+    schemaVersion: typeof designSystemEvidenceSchemaVersion;
+    designSystemVersion: string;
+    source: DesignSystemEvidenceSource;
+    entries: readonly DesignSystemEvidenceItem[];
+}>;
+export type ShowcaseStoryIdComparison = Readonly<{
+    surface: ShowcaseSurface;
+    expected: readonly string[];
+    actual: readonly string[];
+    missing: readonly string[];
+    unexpected: readonly string[];
+    duplicates: readonly string[];
+    complete: boolean;
+}>;
+/**
+ * Returns the canonical component story ids that currently require evidence on
+ * one surface. Consumers use this instead of maintaining hard-coded lists.
+ */
+export declare function getShowcaseStoryIdsForSurface(surface: ShowcaseSurface, manifest?: readonly ShowcaseComponentEntry[]): readonly string[];
+/** Compares a product Storybook inventory with the pinned contract package. */
+export declare function compareShowcaseStoryIds(surface: ShowcaseSurface, storyIds: readonly string[], manifest?: readonly ShowcaseComponentEntry[]): ShowcaseStoryIdComparison;
+export declare function assertShowcaseStoryIds(surface: ShowcaseSurface, storyIds: readonly string[], manifest?: readonly ShowcaseComponentEntry[]): void;
+/** Runtime validation for evidence artifacts submitted by product repositories. */
+export declare function defineDesignSystemEvidence(input: DesignSystemEvidenceManifest, manifest?: readonly ShowcaseComponentEntry[]): DesignSystemEvidenceManifest;
+export declare function createDesignSystemEvidence(source: DesignSystemEvidenceSource, entries: readonly DesignSystemEvidenceItem[]): DesignSystemEvidenceManifest;
+export declare function toShowcaseEvidenceEntries(evidence: readonly DesignSystemEvidenceManifest[]): readonly ShowcaseEvidenceEntry[];
+export declare function createDesignSystemEvidenceCoverage(evidence: readonly DesignSystemEvidenceManifest[], manifest?: readonly ShowcaseComponentEntry[]): readonly ShowcaseCoverageEntry[];
+//# sourceMappingURL=evidence.d.ts.map

package/dist/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../src/evidence.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,iCAAiC,EAAG,CAAU,CAAC;AAE5D,MAAM,MAAM,8BAA8B,GACtC,WAAW,GACX,kBAAkB,GAClB,qBAAqB,GACrB,mBAAmB,GACnB,aAAa,GACb,eAAe,CAAC;AAEpB,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,8BAA8B,CAAC;IACrC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACzC,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CAAC;IAClD,aAAa,EAAE,OAAO,iCAAiC,CAAC;IACxD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,0BAA0B,CAAC;IACnC,OAAO,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC9C,CAAC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC,CAAC;AAiBH;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,eAAe,EACxB,QAAQ,GAAE,SAAS,sBAAsB,EAAqB,GAC7D,SAAS,MAAM,EAAE,CAInB;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,QAAQ,GAAE,SAAS,sBAAsB,EAAqB,GAC7D,yBAAyB,CAqB3B;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,QAAQ,GAAE,SAAS,sBAAsB,EAAqB,GAC7D,IAAI,CAWN;AAED,mFAAmF;AACnF,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,4BAA4B,EACnC,QAAQ,GAAE,SAAS,sBAAsB,EAAqB,GAC7D,4BAA4B,CA0D9B;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,0BAA0B,EAClC,OAAO,EAAE,SAAS,wBAAwB,EAAE,GAC3C,4BAA4B,CAO9B;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,SAAS,4BAA4B,EAAE,GAChD,SAAS,qBAAqB,EAAE,CAIlC;AAED,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,SAAS,4BAA4B,EAAE,EACjD,QAAQ,GAAE,SAAS,sBAAsB,EAAqB,GAC7D,SAAS,qBAAqB,EAAE,CAGlC"}