@hjmds/design-contracts 0.8.2

package/dist/recipes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.js","sourceRoot":"","sources":["../src/recipes.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,eAAe,EACf,eAAe,EACf,aAAa,GAQd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACb,cAAc,EACd,UAAU,EACV,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EACX,cAAc,EACd,aAAa,EACb,WAAW,EACX,eAAe,EACf,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,YAAY,GAuDb,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;EAUE;AACF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAyB,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,iEAAiE;AACjE,yEAAyE;AACzE,sDAAsD;AACtD,yDAAyD;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC","sourcesContent":["export {\n  buttonRecipe,\n  fieldRecipe,\n  surfaceDefaults,\n  surfaceGeometry,\n  surfaceRecipe,\n  type ButtonSize,\n  type ButtonTone,\n  type FieldShape,\n  type FieldVariant,\n  type SurfacePadding,\n  type SurfaceRadius,\n  type SurfaceTone,\n} from \"./base-recipes.js\";\n\nexport {\n  accordionRecipe,\n  alertDialogRecipe,\n  avatarRecipe,\n  badgeRecipe,\n  bottomNavigationRecipe,\n  bottomCtaRecipe,\n  chipRecipe,\n  comboboxRecipe,\n  counterBadgeRecipe,\n  dialogRecipe,\n  dividerRecipe,\n  emptyStateRecipe,\n  formatCounterBadgeCount,\n  iconButtonRecipe,\n  iconRecipe,\n  linkRecipe,\n  listRecipe,\n  listRowRecipe,\n  loadMoreRecipe,\n  menuRecipe,\n  noticeRecipe,\n  progressRecipe,\n  searchFieldRecipe,\n  selectRecipe,\n  selectionGroupRecipe,\n  sectionRecipe,\n  segmentedControlRecipe,\n  selectionControlRecipe,\n  sheetRecipe,\n  skeletonRecipe,\n  spinnerRecipe,\n  stackRecipe,\n  statisticRecipe,\n  switchRecipe,\n  tabsRecipe,\n  textRecipe,\n  toastRecipe,\n  tooltipRecipe,\n  topBarRecipe,\n  type AccordionDensity,\n  type AlertDialogTone,\n  type AvatarShape,\n  type AvatarSize,\n  type BadgeSize,\n  type BadgeTone,\n  type BadgeVariant,\n  type BottomNavigationDensity,\n  type BottomNavigationDistribution,\n  type BottomNavigationPresentation,\n  type ChipSize,\n  type SelectDensity,\n  type SelectSize,\n  type CounterBadgeSize,\n  type CounterBadgeTone,\n  type CounterBadgeVariant,\n  type DialogSize,\n  type IconButtonShape,\n  type IconButtonSize,\n  type IconTone,\n  type IconWeight,\n  type LinkTone,\n  type LinkVariant,\n  type LoadMoreDensity,\n  type ListRowDensity,\n  type MenuDensity,\n  type MenuItemTone,\n  type NoticeTone,\n  type ProgressSize,\n  type ProgressTone,\n  type SearchFieldSize,\n  type SegmentedControlSize,\n  type SelectionControlKind,\n  type SelectionControlPresentation,\n  type SelectionControlSize,\n  type SelectionGroupOrientation,\n  type SelectionGroupPresentation,\n  type SpinnerSize,\n  type SpinnerTone,\n  type StackAlign,\n  type StackAxis,\n  type StackGap,\n  type StackJustify,\n  type StatisticDensity,\n  type StatisticPresentation,\n  type SwitchSize,\n  type TabSize,\n  type TabsLayout,\n  type TabsOverflow,\n  type TextEmphasis,\n  type TextTone,\n  type ToastPlacement,\n  type ToastTone,\n  type ToastToneMark,\n} from \"./component-recipes.js\";\n\n/*\n  Batch 2 저작 모듈의 시각 recipe.\n\n  각 컴포넌트의 계약·recipe·행동을 한 모듈에 자급자족으로 담고, 여기서는 **경로만**\n  모은다(`docs/authoring-brief.md`). 여러 저작자가 병렬로 작업할 때 공유 레지스트리를\n  각자 고치면 서로의 변경을 덮어쓰므로, 배선은 리드가 한 번에 한다.\n\n  recipe 본문을 `component-recipes.ts`로 옮기지 않는 이유: 그 파일은 이미 1,500줄이 넘고,\n  계약(타입·validator·resolver)과 recipe가 **같은 컴포넌트를 두 파일로 갈라** 놓으면\n  둘이 어긋날 자리가 생긴다. 한 컴포넌트는 한 모듈에 둔다.\n*/\nexport { breadcrumbRecipe } from \"./breadcrumb.js\";\nexport { cardRecipe, type CardHeadingLevel } from \"./card.js\";\nexport { calendarRecipe } from \"./calendar.js\";\nexport { carouselRecipe } from \"./carousel.js\";\nexport { commandPaletteRecipe } from \"./command-palette.js\";\nexport { dataTableRecipe } from \"./data-table.js\";\nexport { transferListRecipe } from \"./transfer-list.js\";\n// floatingActionButtonRecipe는 여기서 재수출하지 않는다. 이 모듈이 buttonRecipe를\n// 정의하는데 floating-action-button.ts가 그것을 import하므로, 여기에 `export ... from`을\n// 두면 순환이 된다 — ESM은 재수출을 본문보다 먼저 평가해서 buttonRecipe가 아직\n// undefined인 채로 그 모듈이 실행된다. catalog.ts가 해당 모듈에서 직접 가져간다.\nexport { tourRecipe } from \"./tour.js\";\nexport { layoutRecipe } from \"./layout.js\";\nexport { otpFieldRecipe } from \"./otp-field.js\";\nexport { passwordFieldRecipe } from \"./password-field.js\";\nexport { splitterRecipe } from \"./splitter.js\";\nexport { datePickerRecipe } from \"./date-picker.js\";\nexport { descriptionListRecipe } from \"./description-list.js\";\nexport { filePickerRecipe } from \"./file-picker.js\";\nexport { formRecipe } from \"./form.js\";\nexport { imageRecipe } from \"./image.js\";\nexport { numberFieldRecipe } from \"./number-field.js\";\nexport { paginationRecipe } from \"./pagination.js\";\nexport { popoverRecipe } from \"./popover.js\";\nexport { resultRecipe } from \"./result.js\";\nexport { sliderRecipe } from \"./slider.js\";\nexport { stepsRecipe } from \"./steps.js\";\nexport { tagRecipe } from \"./tag.js\";\nexport { sidePanelRecipe } from \"./side-panel.js\";\nexport { timelineRecipe } from \"./timeline.js\";\nexport { treeRecipe } from \"./tree.js\";\nexport { uploadItemRecipe } from \"./upload-item.js\";\n"]}

package/dist/responsive.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Width classes are shared semantic names, not device categories. Web uses
+ * CSS pixels and Native uses density-independent points for the same numeric
+ * thresholds.
+ */
+export declare const windowClassOrder: readonly ["compact", "medium", "expanded", "wide"];
+export type WindowClass = (typeof windowClassOrder)[number];
+/**
+ * `compact` is the required baseline. Missing larger classes inherit the
+ * closest value declared at a narrower class, so sparse maps stay total.
+ */
+export type ResponsiveValue<Value> = Readonly<{
+    compact: Value;
+    medium?: Value;
+    expanded?: Value;
+    wide?: Value;
+}>;
+/** Validates only the responsive map shape; the owning contract validates each value. */
+export declare function validateResponsiveValue<Value>(value: ResponsiveValue<Value>): void;
+/** Resolves the shared width class at the inclusive foundation thresholds. */
+export declare function resolveWindowClass(windowWidth: number): WindowClass;
+/**
+ * Resolves an exact class override or walks toward compact until a declared
+ * value is found. The required compact baseline makes the result total.
+ */
+export declare function resolveResponsiveValue<Value>(value: ResponsiveValue<Value>, windowClass: WindowClass): Value;
+//# sourceMappingURL=responsive.d.ts.map

package/dist/responsive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsive.d.ts","sourceRoot":"","sources":["../src/responsive.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,oDAK4B,CAAC;AAE1D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,KAAK,IAAI,QAAQ,CAAC;IAC5C,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC;CACd,CAAC,CAAC;AAQH,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,KAAK,EAC3C,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,GAC5B,IAAI,CAYN;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAenE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAC1C,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,EAC7B,WAAW,EAAE,WAAW,GACvB,KAAK,CAgBP"}

package/dist/responsive.js

@@ -0,0 +1,66 @@
+import { breakpoint } from "./foundations.js";
+/**
+ * Width classes are shared semantic names, not device categories. Web uses
+ * CSS pixels and Native uses density-independent points for the same numeric
+ * thresholds.
+ */
+export const windowClassOrder = [
+    "compact",
+    "medium",
+    "expanded",
+    "wide",
+];
+const windowClasses = new Set(windowClassOrder);
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** Validates only the responsive map shape; the owning contract validates each value. */
+export function validateResponsiveValue(value) {
+    if (!isRecord(value)) {
+        throw new TypeError("ResponsiveValue must be an object");
+    }
+    for (const key of Object.keys(value)) {
+        if (!windowClasses.has(key)) {
+            throw new TypeError(`Unsupported ResponsiveValue window class: ${key}`);
+        }
+    }
+    if (!Object.hasOwn(value, "compact")) {
+        throw new TypeError("ResponsiveValue requires a compact baseline");
+    }
+}
+/** Resolves the shared width class at the inclusive foundation thresholds. */
+export function resolveWindowClass(windowWidth) {
+    if (typeof windowWidth !== "number" || !Number.isFinite(windowWidth)) {
+        throw new TypeError("Window width must be a finite number");
+    }
+    if (windowWidth < 0) {
+        throw new RangeError("Window width must not be negative");
+    }
+    for (let index = windowClassOrder.length - 1; index >= 0; index -= 1) {
+        const windowClass = windowClassOrder[index];
+        if (windowWidth >= breakpoint[windowClass])
+            return windowClass;
+    }
+    // `breakpoint.compact` is zero, so every validated width returns above.
+    return "compact";
+}
+/**
+ * Resolves an exact class override or walks toward compact until a declared
+ * value is found. The required compact baseline makes the result total.
+ */
+export function resolveResponsiveValue(value, windowClass) {
+    validateResponsiveValue(value);
+    if (!windowClasses.has(windowClass)) {
+        throw new TypeError(`Unsupported window class: ${String(windowClass)}`);
+    }
+    const activeIndex = windowClassOrder.indexOf(windowClass);
+    for (let index = activeIndex; index >= 0; index -= 1) {
+        const candidate = windowClassOrder[index];
+        if (Object.hasOwn(value, candidate)) {
+            return value[candidate];
+        }
+    }
+    // `validateResponsiveValue` guarantees the compact property exists.
+    return value.compact;
+}
+//# sourceMappingURL=responsive.js.map

package/dist/responsive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsive.js","sourceRoot":"","sources":["../src/responsive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,SAAS;IACT,QAAQ;IACR,UAAU;IACV,MAAM;CACiD,CAAC;AAe1D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAc,gBAAgB,CAAC,CAAC;AAE7D,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,uBAAuB,CACrC,KAA6B;IAE7B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;IAC3D,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAkB,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,SAAS,CAAC,6CAA6C,GAAG,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,UAAU,CAAC,mCAAmC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,IAAI,KAAK,GAAG,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrE,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAE,CAAC;QAC7C,IAAI,WAAW,IAAI,UAAU,CAAC,WAAW,CAAC;YAAE,OAAO,WAAW,CAAC;IACjE,CAAC;IAED,wEAAwE;IACxE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAA6B,EAC7B,WAAwB;IAExB,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,SAAS,CAAC,6BAA6B,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D,KAAK,IAAI,KAAK,GAAG,WAAW,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAE,CAAC;QAC3C,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;YACpC,OAAO,KAAK,CAAC,SAAS,CAAU,CAAC;QACnC,CAAC;IACH,CAAC;IAED,oEAAoE;IACpE,OAAO,KAAK,CAAC,OAAO,CAAC;AACvB,CAAC","sourcesContent":["import { breakpoint } from \"./foundations.js\";\n\n/**\n * Width classes are shared semantic names, not device categories. Web uses\n * CSS pixels and Native uses density-independent points for the same numeric\n * thresholds.\n */\nexport const windowClassOrder = [\n  \"compact\",\n  \"medium\",\n  \"expanded\",\n  \"wide\",\n] as const satisfies readonly (keyof typeof breakpoint)[];\n\nexport type WindowClass = (typeof windowClassOrder)[number];\n\n/**\n * `compact` is the required baseline. Missing larger classes inherit the\n * closest value declared at a narrower class, so sparse maps stay total.\n */\nexport type ResponsiveValue<Value> = Readonly<{\n  compact: Value;\n  medium?: Value;\n  expanded?: Value;\n  wide?: Value;\n}>;\n\nconst windowClasses = new Set<WindowClass>(windowClassOrder);\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\n/** Validates only the responsive map shape; the owning contract validates each value. */\nexport function validateResponsiveValue<Value>(\n  value: ResponsiveValue<Value>,\n): void {\n  if (!isRecord(value)) {\n    throw new TypeError(\"ResponsiveValue must be an object\");\n  }\n  for (const key of Object.keys(value)) {\n    if (!windowClasses.has(key as WindowClass)) {\n      throw new TypeError(`Unsupported ResponsiveValue window class: ${key}`);\n    }\n  }\n  if (!Object.hasOwn(value, \"compact\")) {\n    throw new TypeError(\"ResponsiveValue requires a compact baseline\");\n  }\n}\n\n/** Resolves the shared width class at the inclusive foundation thresholds. */\nexport function resolveWindowClass(windowWidth: number): WindowClass {\n  if (typeof windowWidth !== \"number\" || !Number.isFinite(windowWidth)) {\n    throw new TypeError(\"Window width must be a finite number\");\n  }\n  if (windowWidth < 0) {\n    throw new RangeError(\"Window width must not be negative\");\n  }\n\n  for (let index = windowClassOrder.length - 1; index >= 0; index -= 1) {\n    const windowClass = windowClassOrder[index]!;\n    if (windowWidth >= breakpoint[windowClass]) return windowClass;\n  }\n\n  // `breakpoint.compact` is zero, so every validated width returns above.\n  return \"compact\";\n}\n\n/**\n * Resolves an exact class override or walks toward compact until a declared\n * value is found. The required compact baseline makes the result total.\n */\nexport function resolveResponsiveValue<Value>(\n  value: ResponsiveValue<Value>,\n  windowClass: WindowClass,\n): Value {\n  validateResponsiveValue(value);\n  if (!windowClasses.has(windowClass)) {\n    throw new TypeError(`Unsupported window class: ${String(windowClass)}`);\n  }\n\n  const activeIndex = windowClassOrder.indexOf(windowClass);\n  for (let index = activeIndex; index >= 0; index -= 1) {\n    const candidate = windowClassOrder[index]!;\n    if (Object.hasOwn(value, candidate)) {\n      return value[candidate] as Value;\n    }\n  }\n\n  // `validateResponsiveValue` guarantees the compact property exists.\n  return value.compact;\n}\n"]}

package/dist/result.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Web-page HTTP status vocabulary (403/404/500) does not belong in a
+ * platform-neutral contract. Products/adapters translate those into
+ * `failure` with their own localized copy.
+ */
+export type ResultStatus = "success" | "failure" | "info";
+export declare const resultDefaults: {
+    readonly status: "info";
+};
+export type ResultActionDescriptor = Readonly<{
+    label: string;
+    accessibilityLabel?: string;
+    onAction(): void;
+}>;
+/**
+ * A flow terminus screen (success, failure, 404-equivalent). Unlike
+ * `EmptyState`, which describes a place that can still be filled, Result
+ * means this flow ends here — there is no pending content to wait for.
+ *
+ * `actions` holds at most one primary and one optional secondary action;
+ * the first entry is the primary. A third action is refused, not silently
+ * dropped, so a screen author notices instead of shipping a truncated row.
+ */
+export type ResultDescriptor = Readonly<{
+    status: ResultStatus;
+    title: string;
+    description?: string;
+    actions?: readonly ResultActionDescriptor[];
+}>;
+export type ResolvedResultActionDescriptor = Readonly<{
+    label: string;
+    accessibilityLabel: string;
+    onAction(): void;
+}>;
+export type ResolvedResultDescriptor = Readonly<{
+    status: ResultStatus;
+    title: string;
+    description: string | null;
+    primaryAction: ResolvedResultActionDescriptor | null;
+    secondaryAction: ResolvedResultActionDescriptor | null;
+}>;
+export declare function validateResultAction(action: ResultActionDescriptor, field: string): void;
+export declare function validateResultDescriptor(descriptor: ResultDescriptor): void;
+export declare function resolveResultDescriptor(descriptor: ResultDescriptor): ResolvedResultDescriptor;
+export declare const resultRecipe: {
+    readonly slots: readonly ["root", "icon", "title", "description", "primaryAction", "secondaryAction"];
+    readonly defaults: {
+        readonly status: "info";
+    };
+    readonly tones: {
+        readonly success: {
+            readonly icon: Readonly<{
+                source: "accent";
+                key: "success";
+                alpha?: number;
+            }>;
+            readonly iconBackground: Readonly<{
+                source: "accent";
+                key: "success";
+                alpha?: number;
+            }>;
+        };
+        readonly failure: {
+            readonly icon: Readonly<{
+                source: "theme";
+                key: "danger";
+                alpha?: number;
+            }>;
+            readonly iconBackground: Readonly<{
+                source: "theme";
+                key: "danger";
+                alpha?: number;
+            }>;
+        };
+        readonly info: {
+            readonly icon: Readonly<{
+                source: "accent";
+                key: "info";
+                alpha?: number;
+            }>;
+            readonly iconBackground: Readonly<{
+                source: "accent";
+                key: "info";
+                alpha?: number;
+            }>;
+        };
+    };
+    readonly iconSize: "xl";
+    readonly paddingVertical: 40;
+    readonly paddingHorizontal: 24;
+    readonly gap: 12;
+    readonly title: {
+        readonly textVariant: "titleLarge";
+        readonly color: Readonly<{
+            source: "theme";
+            key: "text";
+            alpha?: number;
+        }>;
+        readonly fontWeight: "700";
+    };
+    readonly description: {
+        readonly textVariant: "body";
+        readonly color: Readonly<{
+            source: "theme";
+            key: "textMuted";
+            alpha?: number;
+        }>;
+    };
+    readonly actionsGap: 12;
+};
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1D,eAAO,MAAM,cAAc;;CAE4B,CAAC;AAExD,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,IAAI,IAAI,CAAC;CAClB,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAC7C,CAAC,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,IAAI,IAAI,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,8BAA8B,GAAG,IAAI,CAAC;IACrD,eAAe,EAAE,8BAA8B,GAAG,IAAI,CAAC;CACxD,CAAC,CAAC;AAQH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,sBAAsB,EAC9B,KAAK,EAAE,MAAM,GACZ,IAAI,CAQN;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAqB3E;AAaD,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,gBAAgB,GAC3B,wBAAwB,CAU1B;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCf,CAAC"}

package/dist/result.js

@@ -0,0 +1,97 @@
+import { semanticColors } from "./semantic-colors.js";
+import { fontWeight, spacing } from "./foundations.js";
+export const resultDefaults = {
+    status: "info",
+};
+function assertCopy(value, field) {
+    if (value.trim().length === 0) {
+        throw new TypeError(`Result ${field} must not be empty`);
+    }
+}
+export function validateResultAction(action, field) {
+    assertCopy(action.label, `${field}.label`);
+    if (action.accessibilityLabel !== undefined) {
+        assertCopy(action.accessibilityLabel, `${field}.accessibilityLabel`);
+    }
+    if (typeof action.onAction !== "function") {
+        throw new TypeError(`Result ${field}.onAction must be a function`);
+    }
+}
+export function validateResultDescriptor(descriptor) {
+    if (descriptor.status !== "success" &&
+        descriptor.status !== "failure" &&
+        descriptor.status !== "info") {
+        throw new TypeError(`Unsupported Result status: ${String(descriptor.status)}`);
+    }
+    assertCopy(descriptor.title, "title");
+    if (descriptor.description !== undefined) {
+        assertCopy(descriptor.description, "description");
+    }
+    const actions = descriptor.actions ?? [];
+    if (actions.length > 2) {
+        throw new RangeError("Result supports at most one primary and one secondary action");
+    }
+    actions.forEach((action, index) => {
+        validateResultAction(action, index === 0 ? "primaryAction" : "secondaryAction");
+    });
+}
+function resolveAction(action) {
+    if (!action)
+        return null;
+    return {
+        label: action.label,
+        accessibilityLabel: action.accessibilityLabel ?? action.label,
+        onAction: action.onAction,
+    };
+}
+export function resolveResultDescriptor(descriptor) {
+    validateResultDescriptor(descriptor);
+    const actions = descriptor.actions ?? [];
+    return {
+        status: descriptor.status,
+        title: descriptor.title,
+        description: descriptor.description ?? null,
+        primaryAction: resolveAction(actions[0]),
+        secondaryAction: resolveAction(actions[1]),
+    };
+}
+export const resultRecipe = {
+    slots: [
+        "root",
+        "icon",
+        "title",
+        "description",
+        "primaryAction",
+        "secondaryAction",
+    ],
+    defaults: resultDefaults,
+    tones: {
+        success: {
+            icon: semanticColors.feedback.success.foreground,
+            iconBackground: semanticColors.feedback.success.badgeBackground,
+        },
+        failure: {
+            icon: semanticColors.feedback.danger.foreground,
+            iconBackground: semanticColors.feedback.danger.badgeBackground,
+        },
+        info: {
+            icon: semanticColors.feedback.info.foreground,
+            iconBackground: semanticColors.feedback.info.badgeBackground,
+        },
+    },
+    iconSize: "xl",
+    paddingVertical: spacing.xxxl,
+    paddingHorizontal: spacing.xl,
+    gap: spacing.sm,
+    title: {
+        textVariant: "titleLarge",
+        color: semanticColors.content.primary,
+        fontWeight: fontWeight.bold,
+    },
+    description: {
+        textVariant: "body",
+        color: semanticColors.content.secondary,
+    },
+    actionsGap: spacing.sm,
+};
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"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","sourcesContent":["import { semanticColors } from \"./semantic-colors.js\";\nimport { fontWeight, spacing } from \"./foundations.js\";\n\n/**\n * Web-page HTTP status vocabulary (403/404/500) does not belong in a\n * platform-neutral contract. Products/adapters translate those into\n * `failure` with their own localized copy.\n */\nexport type ResultStatus = \"success\" | \"failure\" | \"info\";\n\nexport const resultDefaults = {\n  status: \"info\",\n} as const satisfies Readonly<{ status: ResultStatus }>;\n\nexport type ResultActionDescriptor = Readonly<{\n  label: string;\n  accessibilityLabel?: string;\n  onAction(): void;\n}>;\n\n/**\n * A flow terminus screen (success, failure, 404-equivalent). Unlike\n * `EmptyState`, which describes a place that can still be filled, Result\n * means this flow ends here — there is no pending content to wait for.\n *\n * `actions` holds at most one primary and one optional secondary action;\n * the first entry is the primary. A third action is refused, not silently\n * dropped, so a screen author notices instead of shipping a truncated row.\n */\nexport type ResultDescriptor = Readonly<{\n  status: ResultStatus;\n  title: string;\n  description?: string;\n  actions?: readonly ResultActionDescriptor[];\n}>;\n\nexport type ResolvedResultActionDescriptor = Readonly<{\n  label: string;\n  accessibilityLabel: string;\n  onAction(): void;\n}>;\n\nexport type ResolvedResultDescriptor = Readonly<{\n  status: ResultStatus;\n  title: string;\n  description: string | null;\n  primaryAction: ResolvedResultActionDescriptor | null;\n  secondaryAction: ResolvedResultActionDescriptor | null;\n}>;\n\nfunction assertCopy(value: string, field: string): void {\n  if (value.trim().length === 0) {\n    throw new TypeError(`Result ${field} must not be empty`);\n  }\n}\n\nexport function validateResultAction(\n  action: ResultActionDescriptor,\n  field: string,\n): void {\n  assertCopy(action.label, `${field}.label`);\n  if (action.accessibilityLabel !== undefined) {\n    assertCopy(action.accessibilityLabel, `${field}.accessibilityLabel`);\n  }\n  if (typeof action.onAction !== \"function\") {\n    throw new TypeError(`Result ${field}.onAction must be a function`);\n  }\n}\n\nexport function validateResultDescriptor(descriptor: ResultDescriptor): void {\n  if (\n    descriptor.status !== \"success\" &&\n    descriptor.status !== \"failure\" &&\n    descriptor.status !== \"info\"\n  ) {\n    throw new TypeError(`Unsupported Result status: ${String(descriptor.status)}`);\n  }\n  assertCopy(descriptor.title, \"title\");\n  if (descriptor.description !== undefined) {\n    assertCopy(descriptor.description, \"description\");\n  }\n  const actions = descriptor.actions ?? [];\n  if (actions.length > 2) {\n    throw new RangeError(\n      \"Result supports at most one primary and one secondary action\",\n    );\n  }\n  actions.forEach((action, index) => {\n    validateResultAction(action, index === 0 ? \"primaryAction\" : \"secondaryAction\");\n  });\n}\n\nfunction resolveAction(\n  action: ResultActionDescriptor | undefined,\n): ResolvedResultActionDescriptor | null {\n  if (!action) return null;\n  return {\n    label: action.label,\n    accessibilityLabel: action.accessibilityLabel ?? action.label,\n    onAction: action.onAction,\n  };\n}\n\nexport function resolveResultDescriptor(\n  descriptor: ResultDescriptor,\n): ResolvedResultDescriptor {\n  validateResultDescriptor(descriptor);\n  const actions = descriptor.actions ?? [];\n  return {\n    status: descriptor.status,\n    title: descriptor.title,\n    description: descriptor.description ?? null,\n    primaryAction: resolveAction(actions[0]),\n    secondaryAction: resolveAction(actions[1]),\n  };\n}\n\nexport const resultRecipe = {\n  slots: [\n    \"root\",\n    \"icon\",\n    \"title\",\n    \"description\",\n    \"primaryAction\",\n    \"secondaryAction\",\n  ] as const,\n  defaults: resultDefaults,\n  tones: {\n    success: {\n      icon: semanticColors.feedback.success.foreground,\n      iconBackground: semanticColors.feedback.success.badgeBackground,\n    },\n    failure: {\n      icon: semanticColors.feedback.danger.foreground,\n      iconBackground: semanticColors.feedback.danger.badgeBackground,\n    },\n    info: {\n      icon: semanticColors.feedback.info.foreground,\n      iconBackground: semanticColors.feedback.info.badgeBackground,\n    },\n  },\n  iconSize: \"xl\",\n  paddingVertical: spacing.xxxl,\n  paddingHorizontal: spacing.xl,\n  gap: spacing.sm,\n  title: {\n    textVariant: \"titleLarge\",\n    color: semanticColors.content.primary,\n    fontWeight: fontWeight.bold,\n  },\n  description: {\n    textVariant: \"body\",\n    color: semanticColors.content.secondary,\n  },\n  actionsGap: spacing.sm,\n} as const;\n"]}

package/dist/selection-helpers.d.ts

@@ -0,0 +1,16 @@
+export type CheckboxState = boolean | "mixed";
+export type MixedCheckboxActivation = "check" | "uncheck";
+/** Minimum collection shape needed by checkbox selection algorithms. */
+export type CheckboxSelectionItem<Key extends string = string> = Readonly<{
+    id: Key;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+}>;
+export declare const checkboxBehaviorDefaults: {
+    readonly mixedActivation: "check";
+};
+export declare function getCheckboxNextState(current: CheckboxState, mixedActivation?: MixedCheckboxActivation): boolean;
+export declare function toggleCheckboxSelection<Key extends string>(items: readonly CheckboxSelectionItem<Key>[], current: ReadonlySet<Key>, id: Key): ReadonlySet<Key>;
+export declare function reconcileCheckboxSelection<Key extends string>(items: readonly CheckboxSelectionItem<Key>[], current: ReadonlySet<Key>): ReadonlySet<Key>;
+//# sourceMappingURL=selection-helpers.d.ts.map

package/dist/selection-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-helpers.d.ts","sourceRoot":"","sources":["../src/selection-helpers.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC;AAC9C,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,SAAS,CAAC;AAE1D,wEAAwE;AACxE,MAAM,MAAM,qBAAqB,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,IAAI,QAAQ,CAAC;IACxE,EAAE,EAAE,GAAG,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;CAEsC,CAAC;AA4B5E,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,eAAe,GAAE,uBAAkE,GAClF,OAAO,CAET;AAED,wBAAgB,uBAAuB,CAAC,GAAG,SAAS,MAAM,EACxD,KAAK,EAAE,SAAS,qBAAqB,CAAC,GAAG,CAAC,EAAE,EAC5C,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,EACzB,EAAE,EAAE,GAAG,GACN,WAAW,CAAC,GAAG,CAAC,CAgBlB;AAED,wBAAgB,0BAA0B,CAAC,GAAG,SAAS,MAAM,EAC3D,KAAK,EAAE,SAAS,qBAAqB,CAAC,GAAG,CAAC,EAAE,EAC5C,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,GACxB,WAAW,CAAC,GAAG,CAAC,CAKlB"}

package/dist/selection-helpers.js

@@ -0,0 +1,52 @@
+export const checkboxBehaviorDefaults = {
+    mixedActivation: "check",
+};
+function validateCheckboxSelectionItems(items) {
+    const ids = new Set();
+    for (const item of items) {
+        if (typeof item.id !== "string" || item.id.trim().length === 0) {
+            throw new TypeError("Selection item id must not be empty");
+        }
+        if (typeof item.label !== "string" || item.label.trim().length === 0) {
+            throw new TypeError(`Selection item ${item.id} label must not be empty`);
+        }
+        if (item.description !== undefined &&
+            (typeof item.description !== "string" || item.description.trim().length === 0)) {
+            throw new TypeError(`Selection item ${item.id} description must not be empty when provided`);
+        }
+        if (ids.has(item.id)) {
+            throw new TypeError(`Duplicate selection item id: ${item.id}`);
+        }
+        ids.add(item.id);
+    }
+}
+export function getCheckboxNextState(current, mixedActivation = checkboxBehaviorDefaults.mixedActivation) {
+    return current === "mixed" ? mixedActivation === "check" : !current;
+}
+export function toggleCheckboxSelection(items, current, id) {
+    validateCheckboxSelectionItems(items);
+    const knownIds = new Set(items.map((item) => item.id));
+    for (const selectedId of current) {
+        if (!knownIds.has(selectedId)) {
+            throw new RangeError(`Selected checkbox must exist: ${selectedId}`);
+        }
+    }
+    const item = items.find((candidate) => candidate.id === id);
+    if (!item)
+        throw new RangeError(`Checkbox must exist: ${id}`);
+    const next = new Set(current);
+    if (item.disabled)
+        return next;
+    if (next.has(id))
+        next.delete(id);
+    else
+        next.add(id);
+    return next;
+}
+export function reconcileCheckboxSelection(items, current) {
+    validateCheckboxSelectionItems(items);
+    const knownIds = new Set(items.map((item) => item.id));
+    const reconciled = [...current].filter((id) => knownIds.has(id));
+    return reconciled.length === current.size ? current : new Set(reconciled);
+}
+//# sourceMappingURL=selection-helpers.js.map

package/dist/selection-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-helpers.js","sourceRoot":"","sources":["../src/selection-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["export type CheckboxState = boolean | \"mixed\";\nexport type MixedCheckboxActivation = \"check\" | \"uncheck\";\n\n/** Minimum collection shape needed by checkbox selection algorithms. */\nexport type CheckboxSelectionItem<Key extends string = string> = Readonly<{\n  id: Key;\n  label: string;\n  description?: string;\n  disabled?: boolean;\n}>;\n\nexport const checkboxBehaviorDefaults = {\n  mixedActivation: \"check\",\n} as const satisfies Readonly<{ mixedActivation: MixedCheckboxActivation }>;\n\nfunction validateCheckboxSelectionItems<Key extends string>(\n  items: readonly CheckboxSelectionItem<Key>[],\n): void {\n  const ids = new Set<Key>();\n  for (const item of items) {\n    if (typeof item.id !== \"string\" || item.id.trim().length === 0) {\n      throw new TypeError(\"Selection item id must not be empty\");\n    }\n    if (typeof item.label !== \"string\" || item.label.trim().length === 0) {\n      throw new TypeError(`Selection item ${item.id} label must not be empty`);\n    }\n    if (\n      item.description !== undefined &&\n      (typeof item.description !== \"string\" || item.description.trim().length === 0)\n    ) {\n      throw new TypeError(\n        `Selection item ${item.id} description must not be empty when provided`,\n      );\n    }\n    if (ids.has(item.id)) {\n      throw new TypeError(`Duplicate selection item id: ${item.id}`);\n    }\n    ids.add(item.id);\n  }\n}\n\nexport function getCheckboxNextState(\n  current: CheckboxState,\n  mixedActivation: MixedCheckboxActivation = checkboxBehaviorDefaults.mixedActivation,\n): boolean {\n  return current === \"mixed\" ? mixedActivation === \"check\" : !current;\n}\n\nexport function toggleCheckboxSelection<Key extends string>(\n  items: readonly CheckboxSelectionItem<Key>[],\n  current: ReadonlySet<Key>,\n  id: Key,\n): ReadonlySet<Key> {\n  validateCheckboxSelectionItems(items);\n  const knownIds = new Set(items.map((item) => item.id));\n  for (const selectedId of current) {\n    if (!knownIds.has(selectedId)) {\n      throw new RangeError(`Selected checkbox must exist: ${selectedId}`);\n    }\n  }\n  const item = items.find((candidate) => candidate.id === id);\n  if (!item) throw new RangeError(`Checkbox must exist: ${id}`);\n\n  const next = new Set(current);\n  if (item.disabled) return next;\n  if (next.has(id)) next.delete(id);\n  else next.add(id);\n  return next;\n}\n\nexport function reconcileCheckboxSelection<Key extends string>(\n  items: readonly CheckboxSelectionItem<Key>[],\n  current: ReadonlySet<Key>,\n): ReadonlySet<Key> {\n  validateCheckboxSelectionItems(items);\n  const knownIds = new Set(items.map((item) => item.id));\n  const reconciled = [...current].filter((id) => knownIds.has(id));\n  return reconciled.length === current.size ? current : new Set(reconciled);\n}\n"]}