@hjmds/design-contracts 0.8.2

package/dist/content-state.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Products render `idle|loading|loadingMore|empty|error` content states (see
+ * `docs/expansion-roadmap.md`'s common state axis table) at two different
+ * granularities: replacing an entire screen's content, or replacing one
+ * region while the rest of the screen keeps working. That granularity is a
+ * second, orthogonal axis — `scope` — not a new content value and not the
+ * `status` axis `Result` owns (`docs/result.md`). This module is that axis
+ * plus what it forces: action emphasis and accessibility announcement scope.
+ *
+ * `loadingMore` and `complete` are excluded from `ContentStateStatus` on
+ * purpose. Both belong to `LoadMore`'s footer, which is a region by
+ * construction (a list footer is never a whole screen) and already owns its
+ * own state machine (`src/load-more.ts`). `idle` and `success` render no
+ * block at all — the caller shows real content instead.
+ */
+export type ContentScope = "screen" | "region";
+export type ContentStateStatus = "loading" | "empty" | "error";
+export type ContentStateActionDescriptor = Readonly<{
+    label: string;
+    accessibilityLabel?: string;
+    onAction(): void;
+}>;
+export type ContentStateLoadingDescriptor = Readonly<{
+    status: "loading";
+    scope: ContentScope;
+    /** The only accessible signal for a loading block; there is no title/action slot. */
+    loadingLabel: string;
+}>;
+export type ContentStateEmptyDescriptor = Readonly<{
+    status: "empty";
+    scope: ContentScope;
+    title: string;
+    description?: string;
+    action?: ContentStateActionDescriptor;
+}>;
+export type ContentStateErrorDescriptor = Readonly<{
+    status: "error";
+    scope: ContentScope;
+    title: string;
+    description?: string;
+    action?: ContentStateActionDescriptor;
+}>;
+export type ContentStateDescriptor = ContentStateLoadingDescriptor | ContentStateEmptyDescriptor | ContentStateErrorDescriptor;
+/**
+ * `"sole"`: this action is the only content-level way forward (`scope:
+ * "screen"`) — render it as the product's primary/filled affordance.
+ * `"optional"`: recovery is one option among several still-working controls
+ * (`scope: "region"`) — render it de-emphasized so it never competes with a
+ * screen's real primary action. Named independently of any Button tone
+ * enum: HJM's current `ghost` tone (`src/recipes.ts`) resolves to a muted
+ * content color, not the brand-tinted text this repo's product code already
+ * renders for it (`AppButton tone="link"`, see docs). Until Button's tone
+ * vocabulary grows a brand-tinted low-emphasis tone, products map
+ * `"optional"` to whatever local tone matches that description.
+ */
+export type ContentStateActionEmphasis = "sole" | "optional";
+export type ContentStateWebAnnouncement = Readonly<{
+    role: "status" | "alert";
+    live: "polite" | "assertive";
+}>;
+export type ContentStateNativeAnnouncement = Readonly<{
+    accessibilityLiveRegion: "polite" | "assertive";
+    accessibilityRole: "progressbar" | "alert" | "text";
+    /**
+     * Region-scope failures/empties must never pull the reader away from
+     * whatever else they were doing on the screen — that would announce as a
+     * whole-screen failure. Only `scope: "screen"`, which has no sibling
+     * content to protect, may move initial accessibility focus onto this
+     * block, and even then only for `error` — `empty` is calm information
+     * (§8.4 "빈 상태는 결핍이 아니라 초대다"), not an interruption, so it never
+     * steals focus regardless of scope.
+     */
+    moveAccessibilityFocus: boolean;
+}>;
+export type ResolvedContentStateAction = Readonly<{
+    label: string;
+    accessibilityLabel: string;
+    onAction(): void;
+    emphasis: ContentStateActionEmphasis;
+}>;
+export type ResolvedContentStateDescriptor = Readonly<{
+    status: ContentStateStatus;
+    scope: ContentScope;
+    title: string | null;
+    description: string | null;
+    loadingLabel: string | null;
+    action: ResolvedContentStateAction | null;
+    web: ContentStateWebAnnouncement;
+    native: ContentStateNativeAnnouncement;
+}>;
+/**
+ * `loading` descriptors carry no `title`/`description`/`action` by design —
+ * a validator that reused one blanket "title required" check across every
+ * status would reject a perfectly valid loading block. Branch on `status`
+ * before asserting copy, and never assert fields the branch doesn't declare.
+ */
+export declare function validateContentStateDescriptor(descriptor: ContentStateDescriptor): void;
+export declare function resolveContentStateActionEmphasis(scope: ContentScope): ContentStateActionEmphasis;
+export declare function resolveContentStateAnnouncement(status: ContentStateStatus, scope: ContentScope): Readonly<{
+    web: ContentStateWebAnnouncement;
+    native: ContentStateNativeAnnouncement;
+}>;
+export declare function resolveContentStateDescriptor(descriptor: ContentStateDescriptor): ResolvedContentStateDescriptor;
+//# sourceMappingURL=content-state.d.ts.map

package/dist/content-state.d.ts.map

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

package/dist/content-state.js

@@ -0,0 +1,116 @@
+function assertCopy(value, field) {
+    if (value.trim().length === 0) {
+        throw new TypeError(`ContentState ${field} must not be empty`);
+    }
+}
+function assertScope(scope) {
+    if (scope !== "screen" && scope !== "region") {
+        throw new TypeError(`Unsupported ContentState scope: ${String(scope)}`);
+    }
+}
+function assertAction(action, field) {
+    assertCopy(action.label, `${field}.label`);
+    if (action.accessibilityLabel !== undefined) {
+        assertCopy(action.accessibilityLabel, `${field}.accessibilityLabel`);
+    }
+    if (typeof action.onAction !== "function") {
+        throw new TypeError(`ContentState ${field}.onAction must be a function`);
+    }
+}
+/**
+ * `loading` descriptors carry no `title`/`description`/`action` by design —
+ * a validator that reused one blanket "title required" check across every
+ * status would reject a perfectly valid loading block. Branch on `status`
+ * before asserting copy, and never assert fields the branch doesn't declare.
+ */
+export function validateContentStateDescriptor(descriptor) {
+    assertScope(descriptor.scope);
+    const status = descriptor.status;
+    if (status !== "loading" && status !== "empty" && status !== "error") {
+        throw new TypeError(`Unsupported ContentState status: ${String(status)}`);
+    }
+    if (descriptor.status === "loading") {
+        assertCopy(descriptor.loadingLabel, "loadingLabel");
+        return;
+    }
+    assertCopy(descriptor.title, "title");
+    if (descriptor.description !== undefined) {
+        assertCopy(descriptor.description, "description");
+    }
+    if (descriptor.action)
+        assertAction(descriptor.action, "action");
+}
+export function resolveContentStateActionEmphasis(scope) {
+    assertScope(scope);
+    return scope === "screen" ? "sole" : "optional";
+}
+export function resolveContentStateAnnouncement(status, scope) {
+    assertScope(scope);
+    if (status === "loading") {
+        return {
+            web: { role: "status", live: "polite" },
+            native: {
+                accessibilityLiveRegion: "polite",
+                accessibilityRole: "progressbar",
+                moveAccessibilityFocus: false,
+            },
+        };
+    }
+    if (status === "empty") {
+        return {
+            web: { role: "status", live: "polite" },
+            native: {
+                accessibilityLiveRegion: "polite",
+                accessibilityRole: "text",
+                moveAccessibilityFocus: false,
+            },
+        };
+    }
+    if (status === "error") {
+        return {
+            web: { role: "alert", live: "assertive" },
+            native: {
+                accessibilityLiveRegion: "assertive",
+                accessibilityRole: "alert",
+                moveAccessibilityFocus: scope === "screen",
+            },
+        };
+    }
+    throw new TypeError(`Unsupported ContentState status: ${String(status)}`);
+}
+export function resolveContentStateDescriptor(descriptor) {
+    validateContentStateDescriptor(descriptor);
+    const { web, native } = resolveContentStateAnnouncement(descriptor.status, descriptor.scope);
+    if (descriptor.status === "loading") {
+        return {
+            status: "loading",
+            scope: descriptor.scope,
+            title: null,
+            description: null,
+            loadingLabel: descriptor.loadingLabel,
+            action: null,
+            web,
+            native,
+        };
+    }
+    const emphasis = resolveContentStateActionEmphasis(descriptor.scope);
+    const action = descriptor.action
+        ? {
+            label: descriptor.action.label,
+            accessibilityLabel: descriptor.action.accessibilityLabel ?? descriptor.action.label,
+            onAction: descriptor.action.onAction,
+            emphasis,
+        }
+        : null;
+    return {
+        status: descriptor.status,
+        scope: descriptor.scope,
+        title: descriptor.title,
+        description: descriptor.description ?? null,
+        loadingLabel: null,
+        action,
+        web,
+        native,
+    };
+}
+//# sourceMappingURL=content-state.js.map

package/dist/content-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-state.js","sourceRoot":"","sources":["../src/content-state.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Products render `idle|loading|loadingMore|empty|error` content states (see\n * `docs/expansion-roadmap.md`'s common state axis table) at two different\n * granularities: replacing an entire screen's content, or replacing one\n * region while the rest of the screen keeps working. That granularity is a\n * second, orthogonal axis — `scope` — not a new content value and not the\n * `status` axis `Result` owns (`docs/result.md`). This module is that axis\n * plus what it forces: action emphasis and accessibility announcement scope.\n *\n * `loadingMore` and `complete` are excluded from `ContentStateStatus` on\n * purpose. Both belong to `LoadMore`'s footer, which is a region by\n * construction (a list footer is never a whole screen) and already owns its\n * own state machine (`src/load-more.ts`). `idle` and `success` render no\n * block at all — the caller shows real content instead.\n */\nexport type ContentScope = \"screen\" | \"region\";\n\nexport type ContentStateStatus = \"loading\" | \"empty\" | \"error\";\n\nexport type ContentStateActionDescriptor = Readonly<{\n  label: string;\n  accessibilityLabel?: string;\n  onAction(): void;\n}>;\n\nexport type ContentStateLoadingDescriptor = Readonly<{\n  status: \"loading\";\n  scope: ContentScope;\n  /** The only accessible signal for a loading block; there is no title/action slot. */\n  loadingLabel: string;\n}>;\n\nexport type ContentStateEmptyDescriptor = Readonly<{\n  status: \"empty\";\n  scope: ContentScope;\n  title: string;\n  description?: string;\n  action?: ContentStateActionDescriptor;\n}>;\n\nexport type ContentStateErrorDescriptor = Readonly<{\n  status: \"error\";\n  scope: ContentScope;\n  title: string;\n  description?: string;\n  action?: ContentStateActionDescriptor;\n}>;\n\nexport type ContentStateDescriptor =\n  | ContentStateLoadingDescriptor\n  | ContentStateEmptyDescriptor\n  | ContentStateErrorDescriptor;\n\n/**\n * `\"sole\"`: this action is the only content-level way forward (`scope:\n * \"screen\"`) — render it as the product's primary/filled affordance.\n * `\"optional\"`: recovery is one option among several still-working controls\n * (`scope: \"region\"`) — render it de-emphasized so it never competes with a\n * screen's real primary action. Named independently of any Button tone\n * enum: HJM's current `ghost` tone (`src/recipes.ts`) resolves to a muted\n * content color, not the brand-tinted text this repo's product code already\n * renders for it (`AppButton tone=\"link\"`, see docs). Until Button's tone\n * vocabulary grows a brand-tinted low-emphasis tone, products map\n * `\"optional\"` to whatever local tone matches that description.\n */\nexport type ContentStateActionEmphasis = \"sole\" | \"optional\";\n\nexport type ContentStateWebAnnouncement = Readonly<{\n  role: \"status\" | \"alert\";\n  live: \"polite\" | \"assertive\";\n}>;\n\nexport type ContentStateNativeAnnouncement = Readonly<{\n  accessibilityLiveRegion: \"polite\" | \"assertive\";\n  accessibilityRole: \"progressbar\" | \"alert\" | \"text\";\n  /**\n   * Region-scope failures/empties must never pull the reader away from\n   * whatever else they were doing on the screen — that would announce as a\n   * whole-screen failure. Only `scope: \"screen\"`, which has no sibling\n   * content to protect, may move initial accessibility focus onto this\n   * block, and even then only for `error` — `empty` is calm information\n   * (§8.4 \"빈 상태는 결핍이 아니라 초대다\"), not an interruption, so it never\n   * steals focus regardless of scope.\n   */\n  moveAccessibilityFocus: boolean;\n}>;\n\nexport type ResolvedContentStateAction = Readonly<{\n  label: string;\n  accessibilityLabel: string;\n  onAction(): void;\n  emphasis: ContentStateActionEmphasis;\n}>;\n\nexport type ResolvedContentStateDescriptor = Readonly<{\n  status: ContentStateStatus;\n  scope: ContentScope;\n  title: string | null;\n  description: string | null;\n  loadingLabel: string | null;\n  action: ResolvedContentStateAction | null;\n  web: ContentStateWebAnnouncement;\n  native: ContentStateNativeAnnouncement;\n}>;\n\nfunction assertCopy(value: string, field: string): void {\n  if (value.trim().length === 0) {\n    throw new TypeError(`ContentState ${field} must not be empty`);\n  }\n}\n\nfunction assertScope(scope: ContentScope): void {\n  if (scope !== \"screen\" && scope !== \"region\") {\n    throw new TypeError(`Unsupported ContentState scope: ${String(scope)}`);\n  }\n}\n\nfunction assertAction(\n  action: ContentStateActionDescriptor,\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(`ContentState ${field}.onAction must be a function`);\n  }\n}\n\n/**\n * `loading` descriptors carry no `title`/`description`/`action` by design —\n * a validator that reused one blanket \"title required\" check across every\n * status would reject a perfectly valid loading block. Branch on `status`\n * before asserting copy, and never assert fields the branch doesn't declare.\n */\nexport function validateContentStateDescriptor(\n  descriptor: ContentStateDescriptor,\n): void {\n  assertScope(descriptor.scope);\n  const status = (descriptor as Readonly<{ status?: unknown }>).status;\n  if (status !== \"loading\" && status !== \"empty\" && status !== \"error\") {\n    throw new TypeError(`Unsupported ContentState status: ${String(status)}`);\n  }\n  if (descriptor.status === \"loading\") {\n    assertCopy(descriptor.loadingLabel, \"loadingLabel\");\n    return;\n  }\n  assertCopy(descriptor.title, \"title\");\n  if (descriptor.description !== undefined) {\n    assertCopy(descriptor.description, \"description\");\n  }\n  if (descriptor.action) assertAction(descriptor.action, \"action\");\n}\n\nexport function resolveContentStateActionEmphasis(\n  scope: ContentScope,\n): ContentStateActionEmphasis {\n  assertScope(scope);\n  return scope === \"screen\" ? \"sole\" : \"optional\";\n}\n\nexport function resolveContentStateAnnouncement(\n  status: ContentStateStatus,\n  scope: ContentScope,\n): Readonly<{\n  web: ContentStateWebAnnouncement;\n  native: ContentStateNativeAnnouncement;\n}> {\n  assertScope(scope);\n  if (status === \"loading\") {\n    return {\n      web: { role: \"status\", live: \"polite\" },\n      native: {\n        accessibilityLiveRegion: \"polite\",\n        accessibilityRole: \"progressbar\",\n        moveAccessibilityFocus: false,\n      },\n    };\n  }\n  if (status === \"empty\") {\n    return {\n      web: { role: \"status\", live: \"polite\" },\n      native: {\n        accessibilityLiveRegion: \"polite\",\n        accessibilityRole: \"text\",\n        moveAccessibilityFocus: false,\n      },\n    };\n  }\n  if (status === \"error\") {\n    return {\n      web: { role: \"alert\", live: \"assertive\" },\n      native: {\n        accessibilityLiveRegion: \"assertive\",\n        accessibilityRole: \"alert\",\n        moveAccessibilityFocus: scope === \"screen\",\n      },\n    };\n  }\n  throw new TypeError(`Unsupported ContentState status: ${String(status)}`);\n}\n\nexport function resolveContentStateDescriptor(\n  descriptor: ContentStateDescriptor,\n): ResolvedContentStateDescriptor {\n  validateContentStateDescriptor(descriptor);\n  const { web, native } = resolveContentStateAnnouncement(\n    descriptor.status,\n    descriptor.scope,\n  );\n\n  if (descriptor.status === \"loading\") {\n    return {\n      status: \"loading\",\n      scope: descriptor.scope,\n      title: null,\n      description: null,\n      loadingLabel: descriptor.loadingLabel,\n      action: null,\n      web,\n      native,\n    };\n  }\n\n  const emphasis = resolveContentStateActionEmphasis(descriptor.scope);\n  const action: ResolvedContentStateAction | null = descriptor.action\n    ? {\n        label: descriptor.action.label,\n        accessibilityLabel:\n          descriptor.action.accessibilityLabel ?? descriptor.action.label,\n        onAction: descriptor.action.onAction,\n        emphasis,\n      }\n    : null;\n\n  return {\n    status: descriptor.status,\n    scope: descriptor.scope,\n    title: descriptor.title,\n    description: descriptor.description ?? null,\n    loadingLabel: null,\n    action,\n    web,\n    native,\n  };\n}\n"]}

package/dist/counter-badge-recipe.d.ts

@@ -0,0 +1,80 @@
+export { counterBadgeDefaults, formatCounterBadgeCount, type CounterBadgeSize, type CounterBadgeTone, type CounterBadgeVariant, } from "./counter-badge.js";
+/** Numeric counters use a compact solid plate, distinct from status badges. */
+export declare const counterBadgeRecipe: {
+    readonly slots: readonly ["root", "label"];
+    readonly defaults: {
+        readonly tone: "danger";
+        readonly size: "medium";
+        readonly variant: "inline";
+        readonly max: 99;
+    };
+    readonly tones: {
+        readonly danger: {
+            readonly background: Readonly<{
+                source: "theme";
+                key: "dangerFill";
+                alpha?: number;
+            }>;
+            readonly content: Readonly<{
+                source: "theme";
+                key: "onDanger";
+                alpha?: number;
+            }>;
+        };
+        readonly brand: {
+            readonly background: Readonly<{
+                source: "theme";
+                key: "primary";
+                alpha?: number;
+            }>;
+            readonly content: Readonly<{
+                source: "theme";
+                key: "onPrimary";
+                alpha?: number;
+            }>;
+        };
+        readonly neutral: {
+            readonly background: Readonly<{
+                source: "theme";
+                key: "textBody";
+                alpha?: number;
+            }>;
+            readonly content: Readonly<{
+                source: "theme";
+                key: "bg";
+                alpha?: number;
+            }>;
+        };
+    };
+    readonly sizes: {
+        readonly small: {
+            readonly height: 16;
+            readonly minWidth: 16;
+            readonly paddingHorizontal: 4;
+            readonly textVariant: "caption";
+        };
+        readonly medium: {
+            readonly height: 20;
+            readonly minWidth: 20;
+            readonly paddingHorizontal: 8;
+            readonly textVariant: "caption";
+        };
+    };
+    readonly variants: {
+        readonly inline: {
+            readonly border: null;
+            readonly borderWidth: 0;
+        };
+        readonly floating: {
+            readonly border: Readonly<{
+                source: "theme";
+                key: "bg";
+                alpha?: number;
+            }>;
+            readonly borderWidth: 2;
+        };
+    };
+    readonly radius: "full";
+    readonly fontWeight: "700";
+};
+//# sourceMappingURL=counter-badge-recipe.d.ts.map

package/dist/counter-badge-recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter-badge-recipe.d.ts","sourceRoot":"","sources":["../src/counter-badge-recipe.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgE9B,CAAC"}

package/dist/counter-badge-recipe.js

@@ -0,0 +1,44 @@
+import { fontWeight, radius, spacing, stroke, } from "./foundations.js";
+import { semanticColors } from "./semantic-colors.js";
+import { counterBadgeDefaults, } from "./counter-badge.js";
+export { counterBadgeDefaults, formatCounterBadgeCount, } from "./counter-badge.js";
+/** Numeric counters use a compact solid plate, distinct from status badges. */
+export const counterBadgeRecipe = {
+    slots: ["root", "label"],
+    defaults: counterBadgeDefaults,
+    tones: {
+        danger: {
+            background: semanticColors.action.danger.background,
+            content: semanticColors.action.danger.content,
+        },
+        brand: {
+            background: semanticColors.action.brand.background,
+            content: semanticColors.action.brand.content,
+        },
+        neutral: {
+            background: semanticColors.content.body,
+            content: semanticColors.canvas,
+        },
+    },
+    sizes: {
+        small: {
+            height: 16,
+            minWidth: 16,
+            paddingHorizontal: spacing.xxs,
+            textVariant: "caption",
+        },
+        medium: {
+            height: 20,
+            minWidth: 20,
+            paddingHorizontal: spacing.xs,
+            textVariant: "caption",
+        },
+    },
+    variants: {
+        inline: { border: null, borderWidth: 0 },
+        floating: { border: semanticColors.canvas, borderWidth: stroke.strong },
+    },
+    radius: "full",
+    fontWeight: fontWeight.bold,
+};
+//# sourceMappingURL=counter-badge-recipe.js.map

package/dist/counter-badge-recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter-badge-recipe.js","sourceRoot":"","sources":["../src/counter-badge-recipe.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,MAAM,EACN,OAAO,EACP,MAAM,GAGP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,oBAAoB,GAIrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GAIxB,MAAM,oBAAoB,CAAC;AAE5B,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAU;IACjC,QAAQ,EAAE,oBAAoB;IAC9B,KAAK,EAAE;QACL,MAAM,EAAE;YACN,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU;YACnD,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO;SAC9C;QACD,KAAK,EAAE;YACL,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU;YAClD,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO;SAC7C;QACD,OAAO,EAAE;YACP,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC,IAAI;YACvC,OAAO,EAAE,cAAc,CAAC,MAAM;SAC/B;KACF;IACD,KAAK,EAAE;QACL,KAAK,EAAE;YACL,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;YACZ,iBAAiB,EAAE,OAAO,CAAC,GAAG;YAC9B,WAAW,EAAE,SAAS;SACvB;QACD,MAAM,EAAE;YACN,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;YACZ,iBAAiB,EAAE,OAAO,CAAC,EAAE;YAC7B,WAAW,EAAE,SAAS;SACvB;KACF;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE;QACxC,QAAQ,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;KACxE;IACD,MAAM,EAAE,MAAM;IACd,UAAU,EAAE,UAAU,CAAC,IAAI;CA4B5B,CAAC","sourcesContent":["import type { ColorReference } from \"./color-references.js\";\nimport {\n  fontWeight,\n  radius,\n  spacing,\n  stroke,\n  type FontWeightValue,\n  type TextVariant,\n} from \"./foundations.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\nimport {\n  counterBadgeDefaults,\n  type CounterBadgeSize,\n  type CounterBadgeTone,\n  type CounterBadgeVariant,\n} from \"./counter-badge.js\";\n\nexport {\n  counterBadgeDefaults,\n  formatCounterBadgeCount,\n  type CounterBadgeSize,\n  type CounterBadgeTone,\n  type CounterBadgeVariant,\n} from \"./counter-badge.js\";\n\n/** Numeric counters use a compact solid plate, distinct from status badges. */\nexport const counterBadgeRecipe = {\n  slots: [\"root\", \"label\"] as const,\n  defaults: counterBadgeDefaults,\n  tones: {\n    danger: {\n      background: semanticColors.action.danger.background,\n      content: semanticColors.action.danger.content,\n    },\n    brand: {\n      background: semanticColors.action.brand.background,\n      content: semanticColors.action.brand.content,\n    },\n    neutral: {\n      background: semanticColors.content.body,\n      content: semanticColors.canvas,\n    },\n  },\n  sizes: {\n    small: {\n      height: 16,\n      minWidth: 16,\n      paddingHorizontal: spacing.xxs,\n      textVariant: \"caption\",\n    },\n    medium: {\n      height: 20,\n      minWidth: 20,\n      paddingHorizontal: spacing.xs,\n      textVariant: \"caption\",\n    },\n  },\n  variants: {\n    inline: { border: null, borderWidth: 0 },\n    floating: { border: semanticColors.canvas, borderWidth: stroke.strong },\n  },\n  radius: \"full\",\n  fontWeight: fontWeight.bold,\n} as const satisfies {\n  slots: readonly [\"root\", \"label\"];\n  defaults: {\n    tone: CounterBadgeTone;\n    size: CounterBadgeSize;\n    variant: CounterBadgeVariant;\n    max: number;\n  };\n  tones: Record<\n    CounterBadgeTone,\n    { background: ColorReference; content: ColorReference }\n  >;\n  sizes: Record<\n    CounterBadgeSize,\n    {\n      height: number;\n      minWidth: number;\n      paddingHorizontal: number;\n      textVariant: TextVariant;\n    }\n  >;\n  variants: Record<\n    CounterBadgeVariant,\n    { border: ColorReference | null; borderWidth: number }\n  >;\n  radius: keyof typeof radius;\n  fontWeight: FontWeightValue;\n};\n"]}

package/dist/counter-badge.d.ts

@@ -0,0 +1,12 @@
+export type CounterBadgeTone = "danger" | "brand" | "neutral";
+export type CounterBadgeSize = "small" | "medium";
+export type CounterBadgeVariant = "inline" | "floating";
+/** Shared defaults usable without importing the visual recipe barrel. */
+export declare const counterBadgeDefaults: {
+    readonly tone: "danger";
+    readonly size: "medium";
+    readonly variant: "inline";
+    readonly max: 99;
+};
+export declare function formatCounterBadgeCount(count: number, max?: number): string | null;
+//# sourceMappingURL=counter-badge.d.ts.map

package/dist/counter-badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter-badge.d.ts","sourceRoot":"","sources":["../src/counter-badge.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAC9D,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAClD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAExD,yEAAyE;AACzE,eAAO,MAAM,oBAAoB;;;;;CAU/B,CAAC;AAEH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,MAAiC,GACrC,MAAM,GAAG,IAAI,CAWf"}

package/dist/counter-badge.js

@@ -0,0 +1,21 @@
+/** Shared defaults usable without importing the visual recipe barrel. */
+export const counterBadgeDefaults = {
+    tone: "danger",
+    size: "medium",
+    variant: "inline",
+    max: 99,
+};
+export function formatCounterBadgeCount(count, max = counterBadgeDefaults.max) {
+    const normalizedCount = Number.isFinite(count)
+        ? Math.max(0, Math.trunc(count))
+        : 0;
+    if (normalizedCount === 0)
+        return null;
+    const normalizedMax = Number.isFinite(max)
+        ? Math.max(1, Math.trunc(max))
+        : counterBadgeDefaults.max;
+    return normalizedCount > normalizedMax
+        ? `${normalizedMax}+`
+        : String(normalizedCount);
+}
+//# sourceMappingURL=counter-badge.js.map

package/dist/counter-badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter-badge.js","sourceRoot":"","sources":["../src/counter-badge.ts"],"names":[],"mappings":"AAIA,yEAAyE;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,QAAQ;IACjB,GAAG,EAAE,EAAE;CAMP,CAAC;AAEH,MAAM,UAAU,uBAAuB,CACrC,KAAa,EACb,MAAc,oBAAoB,CAAC,GAAG;IAEtC,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC5C,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC,CAAC;IACN,IAAI,eAAe,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QACxC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC;IAC7B,OAAO,eAAe,GAAG,aAAa;QACpC,CAAC,CAAC,GAAG,aAAa,GAAG;QACrB,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;AAC9B,CAAC","sourcesContent":["export type CounterBadgeTone = \"danger\" | \"brand\" | \"neutral\";\nexport type CounterBadgeSize = \"small\" | \"medium\";\nexport type CounterBadgeVariant = \"inline\" | \"floating\";\n\n/** Shared defaults usable without importing the visual recipe barrel. */\nexport const counterBadgeDefaults = {\n  tone: \"danger\",\n  size: \"medium\",\n  variant: \"inline\",\n  max: 99,\n} as const satisfies Readonly<{\n  tone: CounterBadgeTone;\n  size: CounterBadgeSize;\n  variant: CounterBadgeVariant;\n  max: number;\n}>;\n\nexport function formatCounterBadgeCount(\n  count: number,\n  max: number = counterBadgeDefaults.max,\n): string | null {\n  const normalizedCount = Number.isFinite(count)\n    ? Math.max(0, Math.trunc(count))\n    : 0;\n  if (normalizedCount === 0) return null;\n  const normalizedMax = Number.isFinite(max)\n    ? Math.max(1, Math.trunc(max))\n    : counterBadgeDefaults.max;\n  return normalizedCount > normalizedMax\n    ? `${normalizedMax}+`\n    : String(normalizedCount);\n}\n"]}

package/dist/data-table.d.ts

@@ -0,0 +1,203 @@
+import type { AsyncCollectionState, CheckboxState, CollectionKey, CollectionSelectionModel } from "./behaviors.js";
+export type DataTableAlign = "start" | "center" | "end";
+export type DataTableColumnDescriptor<Key extends CollectionKey = CollectionKey> = Readonly<{
+    id: Key;
+    /** Visible column header text; also the columnheader's accessible name. */
+    header: string;
+    align?: DataTableAlign;
+    sortable?: boolean;
+    /** Layout hint only (px or flex-basis); renderers may ignore or clamp it. */
+    width?: number;
+}>;
+export declare const dataTableColumnDefaults: {
+    readonly align: "start";
+    readonly sortable: false;
+};
+export declare function validateDataTableColumns<Key extends CollectionKey>(columns: readonly DataTableColumnDescriptor<Key>[]): void;
+/**
+ * Row identity and selection deliberately do NOT reuse `CollectionItemDescriptor`
+ * verbatim: a table row has no single visible `label`/`textValue` the way a
+ * Menu or Select item does — its "content" is however many columns the
+ * product renders per row. Only the parts of the Collection base contract
+ * that are genuinely row-shaped (`CollectionKey` identity, `disabled`) apply.
+ */
+export type DataTableRowDescriptor<Key extends CollectionKey = CollectionKey> = Readonly<{
+    id: Key;
+    disabled?: boolean;
+}>;
+export declare function validateDataTableRows<Key extends CollectionKey>(rows: readonly DataTableRowDescriptor<Key>[]): void;
+/** Row selection is the unmodified Collection base contract — no DataTable-only selection shape. */
+export type DataTableSelection<Key extends CollectionKey = CollectionKey> = CollectionSelectionModel<Key>;
+/**
+ * Header "select all" state as the same tri-state `CheckboxState` the
+ * selection column's checkbox already renders (check/dash), instead of a new
+ * `"none" | "some" | "all"` enum the recipe would have to translate again.
+ * Disabled rows are excluded from both the denominator and the count.
+ */
+export declare function resolveDataTableSelectAllState<Key extends CollectionKey>(rows: readonly DataTableRowDescriptor<Key>[], selectedKeys: ReadonlySet<Key>): CheckboxState;
+/**
+ * Values are the literal `aria-sort` vocabulary (minus `"none"`, which is
+ * `null`) so the Web renderer passes them through without a translation
+ * table — the same "pass the platform value through" choice Slider makes
+ * for `valueText`.
+ */
+export type DataTableSortDirection = "ascending" | "descending";
+export type DataTableSortState<Key extends CollectionKey = CollectionKey> = Readonly<{
+    columnId: Key;
+    direction: DataTableSortDirection;
+}> | null;
+export type DataTableSortCycle = "two-state" | "three-state";
+export declare const dataTableDefaults: {
+    readonly sortCycle: "three-state";
+};
+export declare function validateDataTableSortState<Key extends CollectionKey>(state: DataTableSortState<Key>, columns: readonly DataTableColumnDescriptor<Key>[]): void;
+/**
+ * Pure toggle: does not read or write product data. The product still owns
+ * actually re-sorting rows (Combobox's local/external filtering split is the
+ * same boundary — HJM judges intent, never executes the data operation).
+ */
+export declare function getNextDataTableSortState<Key extends CollectionKey>(current: DataTableSortState<Key>, columnId: Key, cycle?: DataTableSortCycle): DataTableSortState<Key>;
+/** The whole table's row-loading status — the unmodified Collection base async contract. */
+export type DataTableAsyncState = AsyncCollectionState;
+export type DataTableDensity = "compact" | "regular";
+/**
+ * Reuses `collectionItemContract`'s hover/selected/focus tokens instead of a
+ * second set of row-interaction colors — Menu, Select, and DataTable rows
+ * stay one visual vocabulary.
+ */
+export declare const dataTableRecipe: {
+    readonly slots: readonly ["root", "header", "headerCell", "sortButton", "sortIcon", "row", "cell", "selectionCell", "emptyState", "errorState"];
+    readonly defaults: {
+        readonly density: "regular";
+    };
+    readonly density: {
+        readonly compact: {
+            readonly paddingVertical: 8;
+            readonly paddingHorizontal: 12;
+        };
+        readonly regular: {
+            readonly paddingVertical: 12;
+            readonly paddingHorizontal: 16;
+        };
+    };
+    readonly header: {
+        readonly background: Readonly<{
+            source: "theme";
+            key: "surfaceAlt";
+            alpha?: number;
+        }>;
+        readonly color: Readonly<{
+            source: "theme";
+            key: "textMuted";
+            alpha?: number;
+        }>;
+        readonly textVariant: "label";
+        readonly fontWeight: "700";
+        readonly borderBottom: Readonly<{
+            source: "theme";
+            key: "border";
+            alpha?: number;
+        }>;
+    };
+    readonly row: {
+        readonly borderBottom: Readonly<{
+            source: "theme";
+            key: "border";
+            alpha?: number;
+        }>;
+        readonly hoverBackground: Readonly<{
+            source: "theme";
+            key: "text";
+            alpha?: number;
+        }>;
+        readonly selectedBackground: Readonly<{
+            source: "theme";
+            key: "primary";
+            alpha?: number;
+        }>;
+    };
+    readonly cell: {
+        readonly color: Readonly<{
+            source: "theme";
+            key: "textBody";
+            alpha?: number;
+        }>;
+        readonly textVariant: "body";
+    };
+    readonly sortButton: {
+        readonly minTarget: 44;
+        readonly color: Readonly<{
+            source: "theme";
+            key: "textMuted";
+            alpha?: number;
+        }>;
+        readonly activeColor: Readonly<{
+            source: "theme";
+            key: "contentBrand";
+            alpha?: number;
+        }>;
+    };
+    readonly selectionCell: {
+        readonly width: 44;
+    };
+    readonly emptyState: {
+        readonly color: Readonly<{
+            source: "theme";
+            key: "textMuted";
+            alpha?: number;
+        }>;
+        readonly textVariant: "body";
+    };
+    readonly errorState: {
+        readonly color: Readonly<{
+            source: "theme";
+            key: "danger";
+            alpha?: number;
+        }>;
+        readonly textVariant: "body";
+    };
+    readonly states: {
+        readonly focus: {
+            readonly color: Readonly<{
+                source: "theme";
+                key: "contentBrand";
+                alpha?: number;
+            }>;
+            readonly width: 2;
+            readonly offset: 2;
+        };
+    };
+};
+/**
+ * No roving-tabindex grid keyboard navigation (arrow keys between cells):
+ * no product using this contract has measured demand for full ARIA-grid
+ * traversal, and it is a materially bigger accessibility surface than a
+ * sortable header button plus native checkbox/radio tab stops.
+ */
+export declare const dataTableBehavior: {
+    readonly controlled: readonly ["selection"];
+    readonly inputs: readonly ["columns", "rows", "sortState", "asyncState"];
+    readonly events: readonly ["onSortChange"];
+    readonly configuration: {
+        readonly sortCycle: readonly ["two-state", "three-state"];
+    };
+    readonly defaults: {
+        readonly sortCycle: "three-state";
+    };
+    readonly stateAxes: {
+        readonly value: readonly ["selected"];
+        readonly content: readonly ["idle", "loading", "loadingMore", "empty", "error"];
+    };
+    readonly web: {
+        readonly roles: readonly ["table", "row", "columnheader", "cell", "button", "checkbox", "radio"];
+        readonly keyboard: readonly ["Tab", "Enter", "Space"];
+        readonly focus: "native";
+    };
+    readonly native: {
+        readonly roles: readonly [];
+        readonly states: readonly [];
+        readonly actions: readonly [];
+    };
+    readonly scenarios: readonly ["row-selection-reuses-the-shared-collection-selection-model-unchanged", "select-all-reuses-the-shared-tri-state-checkbox-value", "async-state-reuses-the-shared-collection-async-state-unchanged", "sortable-header-is-a-button-inside-the-columnheader-not-the-header-itself", "sort-direction-values-pass-through-to-aria-sort-without-translation", "disabled-rows-are-excluded-from-select-all-accounting", "pagination-or-load-more-is-composed-beneath-the-table-not-owned-by-it", "row-expansion-is-not-owned-here-compose-the-disclosure-group-contract-per-row", "a-data-cell-exposes-at-most-one-focusable-control", "no-roving-tabindex-grid-navigation-is-implied"];
+};
+//# sourceMappingURL=data-table.d.ts.map

package/dist/data-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table.d.ts","sourceRoot":"","sources":["../src/data-table.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EAEpB,aAAa,EACb,aAAa,EACb,wBAAwB,EACzB,MAAM,gBAAgB,CAAC;AAKxB,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAExD,MAAM,MAAM,yBAAyB,CAAC,GAAG,SAAS,aAAa,GAAG,aAAa,IAAI,QAAQ,CAAC;IAC1F,EAAE,EAAE,GAAG,CAAC;IACR,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;CAGuC,CAAC;AAQ5E,wBAAgB,wBAAwB,CAAC,GAAG,SAAS,aAAa,EAChE,OAAO,EAAE,SAAS,yBAAyB,CAAC,GAAG,CAAC,EAAE,GACjD,IAAI,CAgBN;AAED;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,CAAC,GAAG,SAAS,aAAa,GAAG,aAAa,IAAI,QAAQ,CAAC;IACvF,EAAE,EAAE,GAAG,CAAC;IACR,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,GAAG,SAAS,aAAa,EAC7D,IAAI,EAAE,SAAS,sBAAsB,CAAC,GAAG,CAAC,EAAE,GAC3C,IAAI,CASN;AAED,oGAAoG;AACpG,MAAM,MAAM,kBAAkB,CAAC,GAAG,SAAS,aAAa,GAAG,aAAa,IACtE,wBAAwB,CAAC,GAAG,CAAC,CAAC;AAEhC;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,SAAS,aAAa,EACtE,IAAI,EAAE,SAAS,sBAAsB,CAAC,GAAG,CAAC,EAAE,EAC5C,YAAY,EAAE,WAAW,CAAC,GAAG,CAAC,GAC7B,aAAa,CAOf;AAED;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,YAAY,CAAC;AAEhE,MAAM,MAAM,kBAAkB,CAAC,GAAG,SAAS,aAAa,GAAG,aAAa,IAAI,QAAQ,CAAC;IACnF,QAAQ,EAAE,GAAG,CAAC;IACd,SAAS,EAAE,sBAAsB,CAAC;CACnC,CAAC,GAAG,IAAI,CAAC;AAEV,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,aAAa,CAAC;AAE7D,eAAO,MAAM,iBAAiB;;CAEkC,CAAC;AAEjE,wBAAgB,0BAA0B,CAAC,GAAG,SAAS,aAAa,EAClE,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAC9B,OAAO,EAAE,SAAS,yBAAyB,CAAC,GAAG,CAAC,EAAE,GACjD,IAAI,CAYN;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,SAAS,aAAa,EACjE,OAAO,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAChC,QAAQ,EAAE,GAAG,EACb,KAAK,GAAE,kBAAgD,GACtD,kBAAkB,CAAC,GAAG,CAAC,CAQzB;AAED,4FAA4F;AAC5F,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAEvD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsF3B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;CA4BO,CAAC"}