@hjmds/design-contracts 0.8.2

package/dist/password-field.js

@@ -0,0 +1,120 @@
+import { fieldFrameContract, focusIndicatorContract, formSupportContract, } from "./component-contracts.js";
+import { control, opacity, spacing } from "./foundations.js";
+import { semanticColors } from "./semantic-colors.js";
+function assertBoolean(value, field) {
+    if (typeof value !== "boolean") {
+        throw new TypeError(`PasswordField ${field} must be a boolean`);
+    }
+}
+export function validatePasswordFieldDescriptor(descriptor) {
+    assertBoolean(descriptor.revealed, "revealed");
+    if (descriptor.autofillHint !== "current" && descriptor.autofillHint !== "new") {
+        throw new TypeError(`Unsupported PasswordField autofillHint: ${String(descriptor.autofillHint)}`);
+    }
+}
+/**
+ * Toggling `revealed` only ever changes how the value is displayed — it
+ * never touches the value itself. That guarantee is why this resolver takes
+ * no value parameter at all: there is nothing here that could reach into it.
+ */
+export function resolvePasswordFieldDescriptor(descriptor, options) {
+    validatePasswordFieldDescriptor(descriptor);
+    if (typeof options.composeToggleAccessibleName !== "function") {
+        throw new TypeError("PasswordField composeToggleAccessibleName must be a function");
+    }
+    const toggleAccessibleName = options.composeToggleAccessibleName({
+        willReveal: !descriptor.revealed,
+    });
+    if (typeof toggleAccessibleName !== "string" ||
+        toggleAccessibleName.trim().length === 0) {
+        throw new TypeError("PasswordField composeToggleAccessibleName must return a non-empty string");
+    }
+    return {
+        ...descriptor,
+        toggleAccessibleName,
+        webInputType: descriptor.revealed ? "text" : "password",
+        nativeSecureTextEntry: !descriptor.revealed,
+    };
+}
+/**
+ * Reuses Field's frame and form support copy verbatim — the same judgment
+ * NumberField already made (see src/number-field.ts) — and adds only the
+ * toggle slot, styled like SearchField's trailing clear button (same
+ * diameter/hit-slop convention) but with the visibility icon pair instead.
+ */
+export const passwordFieldRecipe = {
+    slots: ["root", "frame", "input", "toggle", "description", "error"],
+    defaults: { size: "medium" },
+    frame: fieldFrameContract,
+    support: formSupportContract,
+    sizes: {
+        medium: {
+            minHeight: fieldFrameContract.minHeight,
+            paddingHorizontal: fieldFrameContract.paddingHorizontal,
+            textVariant: "body",
+            toggleDiameter: control.minTouchTarget,
+        },
+        large: {
+            minHeight: control.buttonHeight.large,
+            paddingHorizontal: spacing.lg,
+            textVariant: "bodyLarge",
+            toggleDiameter: control.minTouchTarget,
+        },
+    },
+    value: {
+        color: semanticColors.content.body,
+    },
+    toggle: {
+        /**
+         * Icon mirrors the same action-not-state judgment as the accessible
+         * name: concealed shows the "eye" (pressing reveals), revealed shows the
+         * "eye-off" (pressing conceals).
+         */
+        icons: {
+            concealed: "visibility",
+            revealed: "visibilityOff",
+        },
+        color: semanticColors.content.secondary,
+    },
+    states: {
+        focus: focusIndicatorContract,
+        invalidBorder: semanticColors.border.danger,
+        disabledOpacity: opacity.disabled,
+    },
+};
+export const passwordFieldBehavior = {
+    controlled: [
+        "value",
+        "defaultValue",
+        "onValueChange",
+        "revealed",
+        "defaultRevealed",
+        "onRevealedChange",
+    ],
+    inputs: ["autofillHint"],
+    stateAxes: {
+        availability: ["enabled", "disabled", "readOnly"],
+        value: ["empty", "filled"],
+        validation: ["valid", "invalid"],
+    },
+    web: {
+        roles: ["textbox", "button"],
+        keyboard: ["Tab", "Enter", "Space"],
+        focus: "native",
+    },
+    native: {
+        roles: ["text", "button"],
+        states: ["disabled"],
+        actions: ["focus", "setText", "toggleReveal"],
+    },
+    scenarios: [
+        "toggle-never-changes-the-controlled-value",
+        "toggle-and-value-are-independent-controlled-axes",
+        "toggle-accessible-name-describes-the-action-not-the-current-state",
+        "toggle-icon-mirrors-the-same-action-not-state-judgment",
+        "toggle-is-its-own-tab-stop-after-the-field-like-searchfields-clear-button",
+        "autofill-hint-is-a-required-product-decision-not-a-renderer-guess",
+        "strength-meter-is-out-of-scope-product-policy",
+    ],
+};
+//# sourceMappingURL=password-field.js.map

package/dist/password-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"password-field.js","sourceRoot":"","sources":["../src/password-field.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BehaviorContract } from \"./behaviors.js\";\nimport type { ColorReference } from \"./color-references.js\";\nimport type { SemanticIconName } from \"./icon.js\";\nimport {\n  fieldFrameContract,\n  focusIndicatorContract,\n  formSupportContract,\n} from \"./component-contracts.js\";\nimport { control, opacity, spacing, type TextVariant } from \"./foundations.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\n/**\n * PasswordField is Field's existing frame plus exactly one new problem: a\n * reveal toggle. It does not redeclare Field's own `value`/`onValueChange` —\n * a password's value is a plain string, identical to Field's, so there is\n * nothing new to contract there (unlike NumberField, whose value is a parsed\n * number). See docs/password-field.md.\n */\nexport type PasswordFieldAutofillHint = \"current\" | \"new\";\n\nexport type PasswordFieldDescriptor = Readonly<{\n  revealed: boolean;\n  /**\n   * Which password-manager autofill bucket this field is for. Required, not\n   * inferred — HJM cannot tell a login screen from a signup screen from the\n   * descriptor alone, and guessing wrong actively harms the browser/OS\n   * autofill suggestion. See docs/password-field.md for the platform\n   * translation (Web autocomplete token, iOS textContentType, Android\n   * autofill hint) — the exact attribute values are a renderer concern, not\n   * asserted here.\n   */\n  autofillHint: PasswordFieldAutofillHint;\n}>;\n\nfunction assertBoolean(value: boolean, field: string): void {\n  if (typeof value !== \"boolean\") {\n    throw new TypeError(`PasswordField ${field} must be a boolean`);\n  }\n}\n\nexport function validatePasswordFieldDescriptor(\n  descriptor: PasswordFieldDescriptor,\n): void {\n  assertBoolean(descriptor.revealed, \"revealed\");\n  if (descriptor.autofillHint !== \"current\" && descriptor.autofillHint !== \"new\") {\n    throw new TypeError(\n      `Unsupported PasswordField autofillHint: ${String(descriptor.autofillHint)}`,\n    );\n  }\n}\n\nexport type PasswordToggleAccessibleNameInfo = Readonly<{\n  /**\n   * The action pressing the toggle will perform — not whether the password\n   * is currently masked. See docs/password-field.md for why the name must\n   * describe the action.\n   */\n  willReveal: boolean;\n}>;\n\nexport type ComposePasswordToggleAccessibleName = (\n  info: PasswordToggleAccessibleNameInfo,\n) => string;\n\nexport type ResolvedPasswordFieldDescriptor = PasswordFieldDescriptor &\n  Readonly<{\n    toggleAccessibleName: string;\n    webInputType: \"text\" | \"password\";\n    nativeSecureTextEntry: boolean;\n  }>;\n\nexport type ResolvePasswordFieldOptions = Readonly<{\n  composeToggleAccessibleName: ComposePasswordToggleAccessibleName;\n}>;\n\n/**\n * Toggling `revealed` only ever changes how the value is displayed — it\n * never touches the value itself. That guarantee is why this resolver takes\n * no value parameter at all: there is nothing here that could reach into it.\n */\nexport function resolvePasswordFieldDescriptor(\n  descriptor: PasswordFieldDescriptor,\n  options: ResolvePasswordFieldOptions,\n): ResolvedPasswordFieldDescriptor {\n  validatePasswordFieldDescriptor(descriptor);\n  if (typeof options.composeToggleAccessibleName !== \"function\") {\n    throw new TypeError(\n      \"PasswordField composeToggleAccessibleName must be a function\",\n    );\n  }\n  const toggleAccessibleName = options.composeToggleAccessibleName({\n    willReveal: !descriptor.revealed,\n  });\n  if (\n    typeof toggleAccessibleName !== \"string\" ||\n    toggleAccessibleName.trim().length === 0\n  ) {\n    throw new TypeError(\n      \"PasswordField composeToggleAccessibleName must return a non-empty string\",\n    );\n  }\n  return {\n    ...descriptor,\n    toggleAccessibleName,\n    webInputType: descriptor.revealed ? \"text\" : \"password\",\n    nativeSecureTextEntry: !descriptor.revealed,\n  };\n}\n\nexport type PasswordFieldSize = \"medium\" | \"large\";\n\n/**\n * Reuses Field's frame and form support copy verbatim — the same judgment\n * NumberField already made (see src/number-field.ts) — and adds only the\n * toggle slot, styled like SearchField's trailing clear button (same\n * diameter/hit-slop convention) but with the visibility icon pair instead.\n */\nexport const passwordFieldRecipe = {\n  slots: [\"root\", \"frame\", \"input\", \"toggle\", \"description\", \"error\"] as const,\n  defaults: { size: \"medium\" },\n  frame: fieldFrameContract,\n  support: formSupportContract,\n  sizes: {\n    medium: {\n      minHeight: fieldFrameContract.minHeight,\n      paddingHorizontal: fieldFrameContract.paddingHorizontal,\n      textVariant: \"body\",\n      toggleDiameter: control.minTouchTarget,\n    },\n    large: {\n      minHeight: control.buttonHeight.large,\n      paddingHorizontal: spacing.lg,\n      textVariant: \"bodyLarge\",\n      toggleDiameter: control.minTouchTarget,\n    },\n  },\n  value: {\n    color: semanticColors.content.body,\n  },\n  toggle: {\n    /**\n     * Icon mirrors the same action-not-state judgment as the accessible\n     * name: concealed shows the \"eye\" (pressing reveals), revealed shows the\n     * \"eye-off\" (pressing conceals).\n     */\n    icons: {\n      concealed: \"visibility\",\n      revealed: \"visibilityOff\",\n    },\n    color: semanticColors.content.secondary,\n  },\n  states: {\n    focus: focusIndicatorContract,\n    invalidBorder: semanticColors.border.danger,\n    disabledOpacity: opacity.disabled,\n  },\n} as const satisfies {\n  slots: readonly string[];\n  defaults: { size: PasswordFieldSize };\n  frame: typeof fieldFrameContract;\n  support: typeof formSupportContract;\n  sizes: Record<\n    PasswordFieldSize,\n    {\n      minHeight: number;\n      paddingHorizontal: number;\n      textVariant: TextVariant;\n      toggleDiameter: number;\n    }\n  >;\n  value: { color: ColorReference };\n  toggle: {\n    icons: Readonly<{ concealed: SemanticIconName; revealed: SemanticIconName }>;\n    color: ColorReference;\n  };\n  states: {\n    focus: typeof focusIndicatorContract;\n    invalidBorder: ColorReference;\n    disabledOpacity: number;\n  };\n};\n\nexport const passwordFieldBehavior = {\n  controlled: [\n    \"value\",\n    \"defaultValue\",\n    \"onValueChange\",\n    \"revealed\",\n    \"defaultRevealed\",\n    \"onRevealedChange\",\n  ],\n  inputs: [\"autofillHint\"],\n  stateAxes: {\n    availability: [\"enabled\", \"disabled\", \"readOnly\"],\n    value: [\"empty\", \"filled\"],\n    validation: [\"valid\", \"invalid\"],\n  },\n  web: {\n    roles: [\"textbox\", \"button\"],\n    keyboard: [\"Tab\", \"Enter\", \"Space\"],\n    focus: \"native\",\n  },\n  native: {\n    roles: [\"text\", \"button\"],\n    states: [\"disabled\"],\n    actions: [\"focus\", \"setText\", \"toggleReveal\"],\n  },\n  scenarios: [\n    \"toggle-never-changes-the-controlled-value\",\n    \"toggle-and-value-are-independent-controlled-axes\",\n    \"toggle-accessible-name-describes-the-action-not-the-current-state\",\n    \"toggle-icon-mirrors-the-same-action-not-state-judgment\",\n    \"toggle-is-its-own-tab-stop-after-the-field-like-searchfields-clear-button\",\n    \"autofill-hint-is-a-required-product-decision-not-a-renderer-guess\",\n    \"strength-meter-is-out-of-scope-product-policy\",\n  ],\n} as const satisfies BehaviorContract;\n"]}

package/dist/popover.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Popover is the third corner of a triangle with Tooltip and Menu — all three
+ * are "a floating surface anchored to a trigger." Tooltip is explicitly
+ * plain-text and never receives focus (docs/tooltip.md: "interactive
+ * Popover로 확장하지 않는다"). Menu is a collection of actionable items with
+ * its own role/keyboard table (behaviorRegistry.menu). Popover is what is left:
+ * arbitrary *interactive* content (a small form, rich text with a link, a
+ * mixed layout) that is neither a single plain sentence nor an item list.
+ * Focus entering the surface is the decisive, testable difference from
+ * Tooltip — everything else here (dismiss reasons, non-modal posture) follows
+ * from that one fact.
+ */
+export type PopoverPlacement = "top" | "bottom" | "start" | "end";
+export type PopoverAlign = "start" | "center" | "end";
+/**
+ * Popover is non-modal: it does not trap focus like Dialog/Sheet and does not
+ * block the rest of the page. So its dismiss vocabulary is deliberately
+ * narrower than SheetDismissReason — no "back" or "swipe" (this is a web-only
+ * surface), but it adds "outside-focus" because, unlike a modal, Tab can
+ * legitimately carry focus out of a non-modal surface and that departure is
+ * itself a dismiss signal distinct from a pointer click outside.
+ */
+export type PopoverDismissReason = "close-action" | "outside-pointer" | "outside-focus" | "escape" | "programmatic";
+/**
+ * 여는 사유는 `"trigger"`다. Sheet·SidePanel·CommandPalette가 모두 이 이름을 쓰고,
+ * `"trigger-activation"`은 `src/tooltip.ts`에서 **닫는** 사유(열려 있는 툴팁의
+ * 트리거를 눌러 닫는다)로 이미 쓰이고 있다. 한 문자열이 여는 뜻과 닫는 뜻을 겸하면
+ * 렌더러가 조용히 반대로 처리한다 — 컴파일러는 둘 다 유효한 문자열로만 본다.
+ */
+export type PopoverOpenChangeReason = "trigger" | PopoverDismissReason;
+export type PopoverOpenChangeDetails = Readonly<{
+    reason: PopoverOpenChangeReason;
+}>;
+export type PopoverDescriptor = Readonly<{
+    placement?: PopoverPlacement;
+    align?: PopoverAlign;
+    /**
+     * Only needed when the content has no visible heading the platform
+     * accessibility tree can already read as the surface's name. Most Popover
+     * content should carry its own heading; this is an escape hatch, not the
+     * default path.
+     */
+    accessibilityLabel?: string;
+}>;
+export type ResolvedPopoverDescriptor = Readonly<{
+    placement: PopoverPlacement;
+    align: PopoverAlign;
+    accessibilityLabel?: string;
+}>;
+export declare const popoverDescriptorDefaults: {
+    readonly placement: "bottom";
+    readonly align: "start";
+};
+/**
+ * A controlled owner's programmatic close always wins, exactly like
+ * SheetDismissPolicy/canDismissSheet. Popover has no `busy` axis: unlike
+ * Sheet/AlertDialog it is not modal, so there is no global "block every
+ * dismiss" state to defend — a form inside the content that wants to ignore
+ * Escape while submitting makes that call itself, at the content level.
+ */
+export type PopoverDismissPolicy = Readonly<{
+    dismissible: boolean;
+    outsideDismiss: boolean;
+    escapeDismiss: boolean;
+    focusOutDismiss: boolean;
+}>;
+export declare const popoverBehaviorDefaults: {
+    readonly dismissible: true;
+    readonly outsideDismiss: true;
+    readonly escapeDismiss: true;
+    readonly focusOutDismiss: true;
+};
+export type ControlledPopoverOpenState = Readonly<{
+    open: boolean;
+    defaultOpen?: never;
+    onOpenChange(open: boolean, details: PopoverOpenChangeDetails): void;
+}>;
+export type UncontrolledPopoverOpenState = Readonly<{
+    open?: never;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean, details: PopoverOpenChangeDetails) => void;
+}>;
+export type PopoverOpenState = ControlledPopoverOpenState | UncontrolledPopoverOpenState;
+/** Products own what page-change caused this; Popover only needs "did it happen and how." */
+export type PopoverChangeHandler = PopoverOpenState["onOpenChange"];
+export declare function validatePopoverDescriptor(descriptor: PopoverDescriptor): void;
+export declare function resolvePopoverDescriptor(descriptor: PopoverDescriptor): ResolvedPopoverDescriptor;
+export declare function validatePopoverOpenState(state: PopoverOpenState): void;
+/**
+ * Resolves an attempted close without platform knowledge, mirroring
+ * canDismissSheet. Programmatic close is always an owner override.
+ */
+export declare function canDismissPopover(reason: PopoverDismissReason, policy?: PopoverDismissPolicy): boolean;
+/**
+ * Positioning boundary is identical to Tooltip's: HJM owns preferred
+ * placement, spacing, and motion; DOM measurement, portal, flip/shift, and
+ * RTL logical-to-physical translation stay in the product Web renderer's
+ * private AnchoredOverlay (see docs/tooltip.md "Positioning boundary"). This
+ * module never exposes that internal tool, so Popover cannot regress Tooltip's
+ * "no public collision/portal API" boundary.
+ */
+export declare const popoverRecipe: {
+    readonly slots: readonly ["trigger", "content", "arrow", "closeAction"];
+    readonly surface: {
+        readonly background: Readonly<{
+            source: "theme";
+            key: "bg";
+            alpha?: number;
+        }>;
+        readonly border: Readonly<{
+            source: "theme";
+            key: "border";
+            alpha?: number;
+        }>;
+        readonly borderWidth: 1;
+        readonly radius: "md";
+        readonly shadow: {
+            readonly color: "#000000";
+            readonly opacity: 0.12;
+            readonly radius: 12;
+            readonly offsetY: 4;
+        };
+        readonly padding: 8;
+    };
+    readonly arrow: {
+        readonly size: 4;
+        readonly offset: 4;
+    };
+    readonly sideOffset: 8;
+    readonly collisionPadding: 8;
+    readonly minWidth: 240;
+    readonly maxWidth: 360;
+    readonly transition: {
+        readonly enter: {
+            readonly duration: 200;
+            readonly easing: "enter";
+            readonly reducedMotion: "opacity";
+        };
+        readonly exit: {
+            readonly duration: 120;
+            readonly easing: "exit";
+            readonly reducedMotion: "instant";
+        };
+    };
+};
+/**
+ * Literal scenario names for behaviorRegistry.popover (lead wires into
+ * src/behaviors.ts). Kept here, not there, so this module stays self-contained
+ * per the authoring brief.
+ */
+export declare const popoverBehaviorScenarios: readonly ["focus-enters-surface-on-open", "escape-closes-and-restores-trigger-focus", "outside-pointer-close-does-not-cancel-the-original-interaction", "tabbing-past-last-focusable-child-closes-without-trapping", "controlled-owner-programmatic-close-always-wins", "close-action-inside-content-closes-exactly-once", "trigger-while-open-does-not-reopen", "one-visible-popover-per-trigger"];
+//# sourceMappingURL=popover.d.ts.map

package/dist/popover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../src/popover.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,iBAAiB,GACjB,eAAe,GACf,QAAQ,GACR,cAAc,CAAC;AAEnB;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,oBAAoB,CAAC;AAEvE,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,MAAM,EAAE,uBAAuB,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;CAG6C,CAAC;AAEpF;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;CAKK,CAAC;AAE1C,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAC;CACtE,CAAC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CAAC;IAClD,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,CACb,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,wBAAwB,KAC9B,IAAI,CAAC;CACX,CAAC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GACxB,0BAA0B,GAC1B,4BAA4B,CAAC;AAEjC,6FAA6F;AAC7F,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC;AAuBpE,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CA6B7E;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,iBAAiB,GAC5B,yBAAyB,CAS3B;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAgCtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,oBAAoB,EAC5B,MAAM,GAAE,oBAA8C,GACrD,OAAO,CAOT;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,qYAS3B,CAAC"}

package/dist/popover.js

@@ -0,0 +1,137 @@
+import { floatingSurfaceContract } from "./component-contracts.js";
+import { motionPreset, spacing } from "./foundations.js";
+export const popoverDescriptorDefaults = {
+    placement: "bottom",
+    align: "start",
+};
+export const popoverBehaviorDefaults = {
+    dismissible: true,
+    outsideDismiss: true,
+    escapeDismiss: true,
+    focusOutDismiss: true,
+};
+const placements = new Set(["top", "bottom", "start", "end"]);
+const alignments = new Set(["start", "center", "end"]);
+const descriptorKeys = new Set(["placement", "align", "accessibilityLabel"]);
+const openStateKeys = new Set(["open", "defaultOpen", "onOpenChange"]);
+function isObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function rejectUnknownKeys(value, allowed, field) {
+    for (const key of Object.keys(value)) {
+        if (!allowed.has(key)) {
+            throw new TypeError(`Unsupported Popover ${field} field: ${key}`);
+        }
+    }
+}
+export function validatePopoverDescriptor(descriptor) {
+    if (!isObject(descriptor)) {
+        throw new TypeError("Popover descriptor must be an object");
+    }
+    rejectUnknownKeys(descriptor, descriptorKeys, "descriptor");
+    if (descriptor.placement !== undefined &&
+        !placements.has(descriptor.placement)) {
+        throw new TypeError(`Unsupported Popover placement: ${String(descriptor.placement)}`);
+    }
+    if (descriptor.align !== undefined && !alignments.has(descriptor.align)) {
+        throw new TypeError(`Unsupported Popover align: ${String(descriptor.align)}`);
+    }
+    if (descriptor.accessibilityLabel !== undefined) {
+        if (typeof descriptor.accessibilityLabel !== "string" ||
+            descriptor.accessibilityLabel.trim().length === 0) {
+            throw new TypeError("Popover accessibilityLabel must not be empty");
+        }
+        if (descriptor.accessibilityLabel !== descriptor.accessibilityLabel.trim()) {
+            throw new TypeError("Popover accessibilityLabel must not start or end with whitespace");
+        }
+    }
+}
+export function resolvePopoverDescriptor(descriptor) {
+    validatePopoverDescriptor(descriptor);
+    return {
+        placement: descriptor.placement ?? popoverDescriptorDefaults.placement,
+        align: descriptor.align ?? popoverDescriptorDefaults.align,
+        ...(descriptor.accessibilityLabel !== undefined
+            ? { accessibilityLabel: descriptor.accessibilityLabel }
+            : {}),
+    };
+}
+export function validatePopoverOpenState(state) {
+    if (!isObject(state)) {
+        throw new TypeError("Popover open state must be an object");
+    }
+    rejectUnknownKeys(state, openStateKeys, "open state");
+    const runtime = state;
+    const hasOpen = Object.prototype.hasOwnProperty.call(runtime, "open");
+    const hasDefaultOpen = Object.prototype.hasOwnProperty.call(runtime, "defaultOpen");
+    if (hasOpen) {
+        if (typeof runtime.open !== "boolean") {
+            throw new TypeError("Popover open must be a boolean");
+        }
+        if (hasDefaultOpen) {
+            throw new TypeError("Controlled Popover must not provide defaultOpen");
+        }
+        if (typeof runtime.onOpenChange !== "function") {
+            throw new TypeError("Controlled Popover must provide onOpenChange");
+        }
+        return;
+    }
+    if (hasDefaultOpen && typeof runtime.defaultOpen !== "boolean") {
+        throw new TypeError("Popover defaultOpen must be a boolean");
+    }
+    if (runtime.onOpenChange !== undefined &&
+        typeof runtime.onOpenChange !== "function") {
+        throw new TypeError("Popover onOpenChange must be a function");
+    }
+}
+/**
+ * Resolves an attempted close without platform knowledge, mirroring
+ * canDismissSheet. Programmatic close is always an owner override.
+ */
+export function canDismissPopover(reason, policy = popoverBehaviorDefaults) {
+    if (reason === "programmatic")
+        return true;
+    if (!policy.dismissible)
+        return false;
+    if (reason === "outside-pointer")
+        return policy.outsideDismiss;
+    if (reason === "outside-focus")
+        return policy.focusOutDismiss;
+    if (reason === "escape")
+        return policy.escapeDismiss;
+    return true;
+}
+/**
+ * Positioning boundary is identical to Tooltip's: HJM owns preferred
+ * placement, spacing, and motion; DOM measurement, portal, flip/shift, and
+ * RTL logical-to-physical translation stay in the product Web renderer's
+ * private AnchoredOverlay (see docs/tooltip.md "Positioning boundary"). This
+ * module never exposes that internal tool, so Popover cannot regress Tooltip's
+ * "no public collision/portal API" boundary.
+ */
+export const popoverRecipe = {
+    slots: ["trigger", "content", "arrow", "closeAction"],
+    surface: floatingSurfaceContract,
+    arrow: { size: spacing.xxs, offset: spacing.xxs },
+    sideOffset: spacing.xs,
+    collisionPadding: spacing.xs,
+    minWidth: 240,
+    maxWidth: 360,
+    transition: { enter: motionPreset.enter, exit: motionPreset.exit },
+};
+/**
+ * Literal scenario names for behaviorRegistry.popover (lead wires into
+ * src/behaviors.ts). Kept here, not there, so this module stays self-contained
+ * per the authoring brief.
+ */
+export const popoverBehaviorScenarios = [
+    "focus-enters-surface-on-open",
+    "escape-closes-and-restores-trigger-focus",
+    "outside-pointer-close-does-not-cancel-the-original-interaction",
+    "tabbing-past-last-focusable-child-closes-without-trapping",
+    "controlled-owner-programmatic-close-always-wins",
+    "close-action-inside-content-closes-exactly-once",
+    "trigger-while-open-does-not-reopen",
+    "one-visible-popover-per-trigger",
+];
+//# sourceMappingURL=popover.js.map

package/dist/popover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover.js","sourceRoot":"","sources":["../src/popover.ts"],"names":[],"mappings":"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","sourcesContent":["import { floatingSurfaceContract } from \"./component-contracts.js\";\nimport { motionPreset, spacing } from \"./foundations.js\";\n\n/**\n * Popover is the third corner of a triangle with Tooltip and Menu — all three\n * are \"a floating surface anchored to a trigger.\" Tooltip is explicitly\n * plain-text and never receives focus (docs/tooltip.md: \"interactive\n * Popover로 확장하지 않는다\"). Menu is a collection of actionable items with\n * its own role/keyboard table (behaviorRegistry.menu). Popover is what is left:\n * arbitrary *interactive* content (a small form, rich text with a link, a\n * mixed layout) that is neither a single plain sentence nor an item list.\n * Focus entering the surface is the decisive, testable difference from\n * Tooltip — everything else here (dismiss reasons, non-modal posture) follows\n * from that one fact.\n */\nexport type PopoverPlacement = \"top\" | \"bottom\" | \"start\" | \"end\";\nexport type PopoverAlign = \"start\" | \"center\" | \"end\";\n\n/**\n * Popover is non-modal: it does not trap focus like Dialog/Sheet and does not\n * block the rest of the page. So its dismiss vocabulary is deliberately\n * narrower than SheetDismissReason — no \"back\" or \"swipe\" (this is a web-only\n * surface), but it adds \"outside-focus\" because, unlike a modal, Tab can\n * legitimately carry focus out of a non-modal surface and that departure is\n * itself a dismiss signal distinct from a pointer click outside.\n */\nexport type PopoverDismissReason =\n  | \"close-action\"\n  | \"outside-pointer\"\n  | \"outside-focus\"\n  | \"escape\"\n  | \"programmatic\";\n\n/**\n * 여는 사유는 `\"trigger\"`다. Sheet·SidePanel·CommandPalette가 모두 이 이름을 쓰고,\n * `\"trigger-activation\"`은 `src/tooltip.ts`에서 **닫는** 사유(열려 있는 툴팁의\n * 트리거를 눌러 닫는다)로 이미 쓰이고 있다. 한 문자열이 여는 뜻과 닫는 뜻을 겸하면\n * 렌더러가 조용히 반대로 처리한다 — 컴파일러는 둘 다 유효한 문자열로만 본다.\n */\nexport type PopoverOpenChangeReason = \"trigger\" | PopoverDismissReason;\n\nexport type PopoverOpenChangeDetails = Readonly<{\n  reason: PopoverOpenChangeReason;\n}>;\n\nexport type PopoverDescriptor = Readonly<{\n  placement?: PopoverPlacement;\n  align?: PopoverAlign;\n  /**\n   * Only needed when the content has no visible heading the platform\n   * accessibility tree can already read as the surface's name. Most Popover\n   * content should carry its own heading; this is an escape hatch, not the\n   * default path.\n   */\n  accessibilityLabel?: string;\n}>;\n\nexport type ResolvedPopoverDescriptor = Readonly<{\n  placement: PopoverPlacement;\n  align: PopoverAlign;\n  accessibilityLabel?: string;\n}>;\n\nexport const popoverDescriptorDefaults = {\n  placement: \"bottom\",\n  align: \"start\",\n} as const satisfies Readonly<{ placement: PopoverPlacement; align: PopoverAlign }>;\n\n/**\n * A controlled owner's programmatic close always wins, exactly like\n * SheetDismissPolicy/canDismissSheet. Popover has no `busy` axis: unlike\n * Sheet/AlertDialog it is not modal, so there is no global \"block every\n * dismiss\" state to defend — a form inside the content that wants to ignore\n * Escape while submitting makes that call itself, at the content level.\n */\nexport type PopoverDismissPolicy = Readonly<{\n  dismissible: boolean;\n  outsideDismiss: boolean;\n  escapeDismiss: boolean;\n  focusOutDismiss: boolean;\n}>;\n\nexport const popoverBehaviorDefaults = {\n  dismissible: true,\n  outsideDismiss: true,\n  escapeDismiss: true,\n  focusOutDismiss: true,\n} as const satisfies PopoverDismissPolicy;\n\nexport type ControlledPopoverOpenState = Readonly<{\n  open: boolean;\n  defaultOpen?: never;\n  onOpenChange(open: boolean, details: PopoverOpenChangeDetails): void;\n}>;\n\nexport type UncontrolledPopoverOpenState = Readonly<{\n  open?: never;\n  defaultOpen?: boolean;\n  onOpenChange?: (\n    open: boolean,\n    details: PopoverOpenChangeDetails,\n  ) => void;\n}>;\n\nexport type PopoverOpenState =\n  | ControlledPopoverOpenState\n  | UncontrolledPopoverOpenState;\n\n/** Products own what page-change caused this; Popover only needs \"did it happen and how.\" */\nexport type PopoverChangeHandler = PopoverOpenState[\"onOpenChange\"];\n\nconst placements = new Set<PopoverPlacement>([\"top\", \"bottom\", \"start\", \"end\"]);\nconst alignments = new Set<PopoverAlign>([\"start\", \"center\", \"end\"]);\nconst descriptorKeys = new Set([\"placement\", \"align\", \"accessibilityLabel\"]);\nconst openStateKeys = new Set([\"open\", \"defaultOpen\", \"onOpenChange\"]);\n\nfunction isObject(value: unknown): value is Readonly<Record<string, unknown>> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction rejectUnknownKeys(\n  value: Readonly<Record<string, unknown>>,\n  allowed: ReadonlySet<string>,\n  field: string,\n): void {\n  for (const key of Object.keys(value)) {\n    if (!allowed.has(key)) {\n      throw new TypeError(`Unsupported Popover ${field} field: ${key}`);\n    }\n  }\n}\n\nexport function validatePopoverDescriptor(descriptor: PopoverDescriptor): void {\n  if (!isObject(descriptor)) {\n    throw new TypeError(\"Popover descriptor must be an object\");\n  }\n  rejectUnknownKeys(descriptor, descriptorKeys, \"descriptor\");\n  if (\n    descriptor.placement !== undefined &&\n    !placements.has(descriptor.placement)\n  ) {\n    throw new TypeError(\n      `Unsupported Popover placement: ${String(descriptor.placement)}`,\n    );\n  }\n  if (descriptor.align !== undefined && !alignments.has(descriptor.align)) {\n    throw new TypeError(`Unsupported Popover align: ${String(descriptor.align)}`);\n  }\n  if (descriptor.accessibilityLabel !== undefined) {\n    if (\n      typeof descriptor.accessibilityLabel !== \"string\" ||\n      descriptor.accessibilityLabel.trim().length === 0\n    ) {\n      throw new TypeError(\"Popover accessibilityLabel must not be empty\");\n    }\n    if (descriptor.accessibilityLabel !== descriptor.accessibilityLabel.trim()) {\n      throw new TypeError(\n        \"Popover accessibilityLabel must not start or end with whitespace\",\n      );\n    }\n  }\n}\n\nexport function resolvePopoverDescriptor(\n  descriptor: PopoverDescriptor,\n): ResolvedPopoverDescriptor {\n  validatePopoverDescriptor(descriptor);\n  return {\n    placement: descriptor.placement ?? popoverDescriptorDefaults.placement,\n    align: descriptor.align ?? popoverDescriptorDefaults.align,\n    ...(descriptor.accessibilityLabel !== undefined\n      ? { accessibilityLabel: descriptor.accessibilityLabel }\n      : {}),\n  };\n}\n\nexport function validatePopoverOpenState(state: PopoverOpenState): void {\n  if (!isObject(state)) {\n    throw new TypeError(\"Popover open state must be an object\");\n  }\n  rejectUnknownKeys(state, openStateKeys, \"open state\");\n  const runtime = state as Readonly<Record<string, unknown>>;\n  const hasOpen = Object.prototype.hasOwnProperty.call(runtime, \"open\");\n  const hasDefaultOpen = Object.prototype.hasOwnProperty.call(\n    runtime,\n    \"defaultOpen\",\n  );\n  if (hasOpen) {\n    if (typeof runtime.open !== \"boolean\") {\n      throw new TypeError(\"Popover open must be a boolean\");\n    }\n    if (hasDefaultOpen) {\n      throw new TypeError(\"Controlled Popover must not provide defaultOpen\");\n    }\n    if (typeof runtime.onOpenChange !== \"function\") {\n      throw new TypeError(\"Controlled Popover must provide onOpenChange\");\n    }\n    return;\n  }\n  if (hasDefaultOpen && typeof runtime.defaultOpen !== \"boolean\") {\n    throw new TypeError(\"Popover defaultOpen must be a boolean\");\n  }\n  if (\n    runtime.onOpenChange !== undefined &&\n    typeof runtime.onOpenChange !== \"function\"\n  ) {\n    throw new TypeError(\"Popover onOpenChange must be a function\");\n  }\n}\n\n/**\n * Resolves an attempted close without platform knowledge, mirroring\n * canDismissSheet. Programmatic close is always an owner override.\n */\nexport function canDismissPopover(\n  reason: PopoverDismissReason,\n  policy: PopoverDismissPolicy = popoverBehaviorDefaults,\n): boolean {\n  if (reason === \"programmatic\") return true;\n  if (!policy.dismissible) return false;\n  if (reason === \"outside-pointer\") return policy.outsideDismiss;\n  if (reason === \"outside-focus\") return policy.focusOutDismiss;\n  if (reason === \"escape\") return policy.escapeDismiss;\n  return true;\n}\n\n/**\n * Positioning boundary is identical to Tooltip's: HJM owns preferred\n * placement, spacing, and motion; DOM measurement, portal, flip/shift, and\n * RTL logical-to-physical translation stay in the product Web renderer's\n * private AnchoredOverlay (see docs/tooltip.md \"Positioning boundary\"). This\n * module never exposes that internal tool, so Popover cannot regress Tooltip's\n * \"no public collision/portal API\" boundary.\n */\nexport const popoverRecipe = {\n  slots: [\"trigger\", \"content\", \"arrow\", \"closeAction\"] as const,\n  surface: floatingSurfaceContract,\n  arrow: { size: spacing.xxs, offset: spacing.xxs },\n  sideOffset: spacing.xs,\n  collisionPadding: spacing.xs,\n  minWidth: 240,\n  maxWidth: 360,\n  transition: { enter: motionPreset.enter, exit: motionPreset.exit },\n} as const satisfies {\n  slots: readonly string[];\n  surface: typeof floatingSurfaceContract;\n  arrow: { size: number; offset: number };\n  sideOffset: number;\n  collisionPadding: number;\n  minWidth: number;\n  maxWidth: number;\n  transition: { enter: typeof motionPreset.enter; exit: typeof motionPreset.exit };\n};\n\n/**\n * Literal scenario names for behaviorRegistry.popover (lead wires into\n * src/behaviors.ts). Kept here, not there, so this module stays self-contained\n * per the authoring brief.\n */\nexport const popoverBehaviorScenarios = [\n  \"focus-enters-surface-on-open\",\n  \"escape-closes-and-restores-trigger-focus\",\n  \"outside-pointer-close-does-not-cancel-the-original-interaction\",\n  \"tabbing-past-last-focusable-child-closes-without-trapping\",\n  \"controlled-owner-programmatic-close-always-wins\",\n  \"close-action-inside-content-closes-exactly-once\",\n  \"trigger-while-open-does-not-reopen\",\n  \"one-visible-popover-per-trigger\",\n] as const;\n"]}

package/dist/progress-recipe.d.ts

@@ -0,0 +1,43 @@
+export declare const progressRecipe: {
+    readonly slots: readonly ["root", "track", "indicator", "label", "value"];
+    readonly defaults: {
+        readonly size: "medium";
+        readonly tone: "brand";
+    };
+    readonly sizes: {
+        readonly small: 4;
+        readonly medium: 8;
+        readonly large: 12;
+    };
+    readonly tones: {
+        readonly brand: Readonly<{
+            source: "theme";
+            key: "contentBrand";
+            alpha?: number;
+        }>;
+        readonly success: Readonly<{
+            source: "accent";
+            key: "success";
+            alpha?: number;
+        }>;
+        readonly warning: Readonly<{
+            source: "accent";
+            key: "warning";
+            alpha?: number;
+        }>;
+        readonly danger: Readonly<{
+            source: "theme";
+            key: "danger";
+            alpha?: number;
+        }>;
+    };
+    readonly track: Readonly<{
+        source: "theme";
+        key: "surfaceAlt";
+        alpha?: number;
+    }>;
+    readonly radius: "full";
+};
+export type ProgressSize = keyof typeof progressRecipe.sizes;
+export type ProgressTone = keyof typeof progressRecipe.tones;
+//# sourceMappingURL=progress-recipe.d.ts.map

package/dist/progress-recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-recipe.d.ts","sourceRoot":"","sources":["../src/progress-recipe.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmB1B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,cAAc,CAAC,KAAK,CAAC;AAC7D,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,cAAc,CAAC,KAAK,CAAC"}

package/dist/progress-recipe.js

@@ -0,0 +1,16 @@
+import { radius } from "./foundations.js";
+import { semanticColors } from "./semantic-colors.js";
+export const progressRecipe = {
+    slots: ["root", "track", "indicator", "label", "value"],
+    defaults: { size: "medium", tone: "brand" },
+    sizes: { small: 4, medium: 8, large: 12 },
+    tones: {
+        brand: semanticColors.content.brand,
+        success: semanticColors.feedback.success.foreground,
+        warning: semanticColors.feedback.warning.foreground,
+        danger: semanticColors.content.danger,
+    },
+    track: semanticColors.surface.sunken,
+    radius: "full",
+};
+//# sourceMappingURL=progress-recipe.js.map

package/dist/progress-recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-recipe.js","sourceRoot":"","sources":["../src/progress-recipe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,CAAU;IAChE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE;IAC3C,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;IACzC,KAAK,EAAE;QACL,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK;QACnC,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU;QACnD,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU;QACnD,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,MAAM;KACtC;IACD,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,MAAM;IACpC,MAAM,EAAE,MAAM;CAQf,CAAC","sourcesContent":["import type { ColorReference } from \"./color-references.js\";\nimport { radius } from \"./foundations.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\nexport const progressRecipe = {\n  slots: [\"root\", \"track\", \"indicator\", \"label\", \"value\"] as const,\n  defaults: { size: \"medium\", tone: \"brand\" },\n  sizes: { small: 4, medium: 8, large: 12 },\n  tones: {\n    brand: semanticColors.content.brand,\n    success: semanticColors.feedback.success.foreground,\n    warning: semanticColors.feedback.warning.foreground,\n    danger: semanticColors.content.danger,\n  },\n  track: semanticColors.surface.sunken,\n  radius: \"full\",\n} as const satisfies {\n  radius: keyof typeof radius;\n  slots: readonly string[];\n  defaults: { size: \"small\" | \"medium\" | \"large\"; tone: \"brand\" | \"success\" | \"warning\" | \"danger\" };\n  sizes: Record<\"small\" | \"medium\" | \"large\", number>;\n  tones: Record<\"brand\" | \"success\" | \"warning\" | \"danger\", ColorReference>;\n  track: ColorReference;\n};\n\nexport type ProgressSize = keyof typeof progressRecipe.sizes;\nexport type ProgressTone = keyof typeof progressRecipe.tones;\n"]}

package/dist/recipes.d.ts

@@ -0,0 +1,31 @@
+export { buttonRecipe, fieldRecipe, surfaceDefaults, surfaceGeometry, surfaceRecipe, type ButtonSize, type ButtonTone, type FieldShape, type FieldVariant, type SurfacePadding, type SurfaceRadius, type SurfaceTone, } from "./base-recipes.js";
+export { accordionRecipe, alertDialogRecipe, avatarRecipe, badgeRecipe, bottomNavigationRecipe, bottomCtaRecipe, chipRecipe, comboboxRecipe, counterBadgeRecipe, dialogRecipe, dividerRecipe, emptyStateRecipe, formatCounterBadgeCount, iconButtonRecipe, iconRecipe, linkRecipe, listRecipe, listRowRecipe, loadMoreRecipe, menuRecipe, noticeRecipe, progressRecipe, searchFieldRecipe, selectRecipe, selectionGroupRecipe, sectionRecipe, segmentedControlRecipe, selectionControlRecipe, sheetRecipe, skeletonRecipe, spinnerRecipe, stackRecipe, statisticRecipe, switchRecipe, tabsRecipe, textRecipe, toastRecipe, tooltipRecipe, topBarRecipe, type AccordionDensity, type AlertDialogTone, type AvatarShape, type AvatarSize, type BadgeSize, type BadgeTone, type BadgeVariant, type BottomNavigationDensity, type BottomNavigationDistribution, type BottomNavigationPresentation, type ChipSize, type SelectDensity, type SelectSize, type CounterBadgeSize, type CounterBadgeTone, type CounterBadgeVariant, type DialogSize, type IconButtonShape, type IconButtonSize, type IconTone, type IconWeight, type LinkTone, type LinkVariant, type LoadMoreDensity, type ListRowDensity, type MenuDensity, type MenuItemTone, type NoticeTone, type ProgressSize, type ProgressTone, type SearchFieldSize, type SegmentedControlSize, type SelectionControlKind, type SelectionControlPresentation, type SelectionControlSize, type SelectionGroupOrientation, type SelectionGroupPresentation, type SpinnerSize, type SpinnerTone, type StackAlign, type StackAxis, type StackGap, type StackJustify, type StatisticDensity, type StatisticPresentation, type SwitchSize, type TabSize, type TabsLayout, type TabsOverflow, type TextEmphasis, type TextTone, type ToastPlacement, type ToastTone, type ToastToneMark, } from "./component-recipes.js";
+export { breadcrumbRecipe } from "./breadcrumb.js";
+export { cardRecipe, type CardHeadingLevel } from "./card.js";
+export { calendarRecipe } from "./calendar.js";
+export { carouselRecipe } from "./carousel.js";
+export { commandPaletteRecipe } from "./command-palette.js";
+export { dataTableRecipe } from "./data-table.js";
+export { transferListRecipe } from "./transfer-list.js";
+export { tourRecipe } from "./tour.js";
+export { layoutRecipe } from "./layout.js";
+export { otpFieldRecipe } from "./otp-field.js";
+export { passwordFieldRecipe } from "./password-field.js";
+export { splitterRecipe } from "./splitter.js";
+export { datePickerRecipe } from "./date-picker.js";
+export { descriptionListRecipe } from "./description-list.js";
+export { filePickerRecipe } from "./file-picker.js";
+export { formRecipe } from "./form.js";
+export { imageRecipe } from "./image.js";
+export { numberFieldRecipe } from "./number-field.js";
+export { paginationRecipe } from "./pagination.js";
+export { popoverRecipe } from "./popover.js";
+export { resultRecipe } from "./result.js";
+export { sliderRecipe } from "./slider.js";
+export { stepsRecipe } from "./steps.js";
+export { tagRecipe } from "./tag.js";
+export { sidePanelRecipe } from "./side-panel.js";
+export { timelineRecipe } from "./timeline.js";
+export { treeRecipe } from "./tree.js";
+export { uploadItemRecipe } from "./upload-item.js";
+//# sourceMappingURL=recipes.d.ts.map

package/dist/recipes.d.ts.map

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

package/dist/recipes.js

@@ -0,0 +1,46 @@
+export { buttonRecipe, fieldRecipe, surfaceDefaults, surfaceGeometry, surfaceRecipe, } from "./base-recipes.js";
+export { accordionRecipe, alertDialogRecipe, avatarRecipe, badgeRecipe, bottomNavigationRecipe, bottomCtaRecipe, chipRecipe, comboboxRecipe, counterBadgeRecipe, dialogRecipe, dividerRecipe, emptyStateRecipe, formatCounterBadgeCount, iconButtonRecipe, iconRecipe, linkRecipe, listRecipe, listRowRecipe, loadMoreRecipe, menuRecipe, noticeRecipe, progressRecipe, searchFieldRecipe, selectRecipe, selectionGroupRecipe, sectionRecipe, segmentedControlRecipe, selectionControlRecipe, sheetRecipe, skeletonRecipe, spinnerRecipe, stackRecipe, statisticRecipe, switchRecipe, tabsRecipe, textRecipe, toastRecipe, tooltipRecipe, topBarRecipe, } from "./component-recipes.js";
+/*
+  Batch 2 저작 모듈의 시각 recipe.
+
+  각 컴포넌트의 계약·recipe·행동을 한 모듈에 자급자족으로 담고, 여기서는 **경로만**
+  모은다(`docs/authoring-brief.md`). 여러 저작자가 병렬로 작업할 때 공유 레지스트리를
+  각자 고치면 서로의 변경을 덮어쓰므로, 배선은 리드가 한 번에 한다.
+
+  recipe 본문을 `component-recipes.ts`로 옮기지 않는 이유: 그 파일은 이미 1,500줄이 넘고,
+  계약(타입·validator·resolver)과 recipe가 **같은 컴포넌트를 두 파일로 갈라** 놓으면
+  둘이 어긋날 자리가 생긴다. 한 컴포넌트는 한 모듈에 둔다.
+*/
+export { breadcrumbRecipe } from "./breadcrumb.js";
+export { cardRecipe } from "./card.js";
+export { calendarRecipe } from "./calendar.js";
+export { carouselRecipe } from "./carousel.js";
+export { commandPaletteRecipe } from "./command-palette.js";
+export { dataTableRecipe } from "./data-table.js";
+export { transferListRecipe } from "./transfer-list.js";
+// floatingActionButtonRecipe는 여기서 재수출하지 않는다. 이 모듈이 buttonRecipe를
+// 정의하는데 floating-action-button.ts가 그것을 import하므로, 여기에 `export ... from`을
+// 두면 순환이 된다 — ESM은 재수출을 본문보다 먼저 평가해서 buttonRecipe가 아직
+// undefined인 채로 그 모듈이 실행된다. catalog.ts가 해당 모듈에서 직접 가져간다.
+export { tourRecipe } from "./tour.js";
+export { layoutRecipe } from "./layout.js";
+export { otpFieldRecipe } from "./otp-field.js";
+export { passwordFieldRecipe } from "./password-field.js";
+export { splitterRecipe } from "./splitter.js";
+export { datePickerRecipe } from "./date-picker.js";
+export { descriptionListRecipe } from "./description-list.js";
+export { filePickerRecipe } from "./file-picker.js";
+export { formRecipe } from "./form.js";
+export { imageRecipe } from "./image.js";
+export { numberFieldRecipe } from "./number-field.js";
+export { paginationRecipe } from "./pagination.js";
+export { popoverRecipe } from "./popover.js";
+export { resultRecipe } from "./result.js";
+export { sliderRecipe } from "./slider.js";
+export { stepsRecipe } from "./steps.js";
+export { tagRecipe } from "./tag.js";
+export { sidePanelRecipe } from "./side-panel.js";
+export { timelineRecipe } from "./timeline.js";
+export { treeRecipe } from "./tree.js";
+export { uploadItemRecipe } from "./upload-item.js";
+//# sourceMappingURL=recipes.js.map