@hjmds/design-contracts 0.8.2

package/dist/semantic-colors.d.ts

@@ -0,0 +1,275 @@
+/**
+ * Stable role aliases above the legacy ThemeColors key set. New recipes should
+ * prefer these roles so the underlying theme shape can evolve independently.
+ */
+export declare const semanticColors: {
+    readonly canvas: Readonly<{
+        source: "theme";
+        key: "bg";
+        alpha?: number;
+    }>;
+    readonly surface: {
+        readonly default: Readonly<{
+            source: "theme";
+            key: "surface";
+            alpha?: number;
+        }>;
+        readonly sunken: Readonly<{
+            source: "theme";
+            key: "surfaceAlt";
+            alpha?: number;
+        }>;
+        readonly raised: Readonly<{
+            source: "theme";
+            key: "bg";
+            alpha?: number;
+        }>;
+        readonly brand: Readonly<{
+            source: "theme";
+            key: "surfaceAccent";
+            alpha?: number;
+        }>;
+    };
+    readonly content: {
+        readonly primary: Readonly<{
+            source: "theme";
+            key: "text";
+            alpha?: number;
+        }>;
+        readonly body: Readonly<{
+            source: "theme";
+            key: "textBody";
+            alpha?: number;
+        }>;
+        readonly secondary: Readonly<{
+            source: "theme";
+            key: "textMuted";
+            alpha?: number;
+        }>;
+        readonly tertiary: Readonly<{
+            source: "theme";
+            key: "textSub";
+            alpha?: number;
+        }>;
+        readonly decorative: Readonly<{
+            source: "theme";
+            key: "textWeak";
+            alpha?: number;
+        }>;
+        readonly brand: Readonly<{
+            source: "theme";
+            key: "contentBrand";
+            alpha?: number;
+        }>;
+        readonly danger: Readonly<{
+            source: "theme";
+            key: "danger";
+            alpha?: number;
+        }>;
+        readonly inverse: Readonly<{
+            source: "theme";
+            key: "onPrimary";
+            alpha?: number;
+        }>;
+    };
+    readonly border: {
+        readonly subtle: Readonly<{
+            source: "theme";
+            key: "border";
+            alpha?: number;
+        }>;
+        readonly default: Readonly<{
+            source: "theme";
+            key: "border";
+            alpha?: number;
+        }>;
+        readonly strong: Readonly<{
+            source: "theme";
+            key: "textWeak";
+            alpha?: number;
+        }>;
+        readonly focus: Readonly<{
+            source: "theme";
+            key: "contentBrand";
+            alpha?: number;
+        }>;
+        readonly danger: Readonly<{
+            source: "theme";
+            key: "danger";
+            alpha?: number;
+        }>;
+    };
+    readonly action: {
+        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: "surfaceAlt";
+                alpha?: number;
+            }>;
+            readonly content: Readonly<{
+                source: "theme";
+                key: "text";
+                alpha?: number;
+            }>;
+        };
+        readonly danger: {
+            readonly background: Readonly<{
+                source: "theme";
+                key: "dangerFill";
+                alpha?: number;
+            }>;
+            readonly content: Readonly<{
+                source: "theme";
+                key: "onDanger";
+                alpha?: number;
+            }>;
+        };
+    };
+    readonly feedback: {
+        readonly info: {
+            readonly foreground: Readonly<{
+                source: "accent";
+                key: "info";
+                alpha?: number;
+            }>;
+            readonly background: Readonly<{
+                source: "accent";
+                key: "info";
+                alpha?: number;
+            }>;
+            readonly badgeBackground: Readonly<{
+                source: "accent";
+                key: "info";
+                alpha?: number;
+            }>;
+            readonly border: Readonly<{
+                source: "accent";
+                key: "info";
+                alpha?: number;
+            }>;
+        };
+        readonly success: {
+            readonly foreground: Readonly<{
+                source: "accent";
+                key: "success";
+                alpha?: number;
+            }>;
+            readonly background: Readonly<{
+                source: "accent";
+                key: "success";
+                alpha?: number;
+            }>;
+            readonly badgeBackground: Readonly<{
+                source: "accent";
+                key: "success";
+                alpha?: number;
+            }>;
+            readonly border: Readonly<{
+                source: "accent";
+                key: "success";
+                alpha?: number;
+            }>;
+        };
+        readonly warning: {
+            readonly foreground: Readonly<{
+                source: "accent";
+                key: "warning";
+                alpha?: number;
+            }>;
+            readonly background: Readonly<{
+                source: "accent";
+                key: "warning";
+                alpha?: number;
+            }>;
+            readonly badgeBackground: Readonly<{
+                source: "accent";
+                key: "warning";
+                alpha?: number;
+            }>;
+            readonly border: Readonly<{
+                source: "accent";
+                key: "warning";
+                alpha?: number;
+            }>;
+        };
+        readonly attention: {
+            readonly foreground: Readonly<{
+                source: "accent";
+                key: "attention";
+                alpha?: number;
+            }>;
+            readonly background: Readonly<{
+                source: "accent";
+                key: "attention";
+                alpha?: number;
+            }>;
+            readonly badgeBackground: Readonly<{
+                source: "accent";
+                key: "attention";
+                alpha?: number;
+            }>;
+            readonly border: Readonly<{
+                source: "accent";
+                key: "attention";
+                alpha?: number;
+            }>;
+        };
+        readonly danger: {
+            readonly foreground: Readonly<{
+                source: "theme";
+                key: "danger";
+                alpha?: number;
+            }>;
+            readonly background: Readonly<{
+                source: "theme";
+                key: "danger";
+                alpha?: number;
+            }>;
+            readonly badgeBackground: Readonly<{
+                source: "theme";
+                key: "danger";
+                alpha?: number;
+            }>;
+            readonly border: Readonly<{
+                source: "theme";
+                key: "danger";
+                alpha?: number;
+            }>;
+        };
+    };
+    readonly interaction: {
+        readonly hover: Readonly<{
+            source: "theme";
+            key: "text";
+            alpha?: number;
+        }>;
+        readonly focus: Readonly<{
+            source: "theme";
+            key: "contentBrand";
+            alpha?: number;
+        }>;
+        readonly pressed: Readonly<{
+            source: "theme";
+            key: "text";
+            alpha?: number;
+        }>;
+        readonly selected: Readonly<{
+            source: "theme";
+            key: "primary";
+            alpha?: number;
+        }>;
+    };
+};
+//# sourceMappingURL=semantic-colors.d.ts.map

package/dist/semantic-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-colors.d.ts","sourceRoot":"","sources":["../src/semantic-colors.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6EjB,CAAC"}

package/dist/semantic-colors.js

@@ -0,0 +1,84 @@
+import { accentColor, themeColor } from "./color-references.js";
+/**
+ * Stable role aliases above the legacy ThemeColors key set. New recipes should
+ * prefer these roles so the underlying theme shape can evolve independently.
+ */
+export const semanticColors = {
+    canvas: themeColor("bg"),
+    surface: {
+        default: themeColor("surface"),
+        sunken: themeColor("surfaceAlt"),
+        raised: themeColor("bg"),
+        brand: themeColor("surfaceAccent"),
+    },
+    content: {
+        primary: themeColor("text"),
+        body: themeColor("textBody"),
+        secondary: themeColor("textMuted"),
+        tertiary: themeColor("textSub"),
+        decorative: themeColor("textWeak"),
+        brand: themeColor("contentBrand"),
+        danger: themeColor("danger"),
+        inverse: themeColor("onPrimary"),
+    },
+    border: {
+        subtle: themeColor("border", 0.7),
+        default: themeColor("border"),
+        strong: themeColor("textWeak"),
+        focus: themeColor("contentBrand"),
+        danger: themeColor("danger"),
+    },
+    action: {
+        brand: {
+            background: themeColor("primary"),
+            content: themeColor("onPrimary"),
+        },
+        neutral: {
+            background: themeColor("surfaceAlt"),
+            content: themeColor("text"),
+        },
+        danger: {
+            background: themeColor("dangerFill"),
+            content: themeColor("onDanger"),
+        },
+    },
+    feedback: {
+        info: {
+            foreground: accentColor("info"),
+            background: accentColor("info", 0.1),
+            badgeBackground: accentColor("info", 0.1),
+            border: accentColor("info", 0.3),
+        },
+        success: {
+            foreground: accentColor("success"),
+            background: accentColor("success", 0.1),
+            badgeBackground: accentColor("success", 0.1),
+            border: accentColor("success", 0.3),
+        },
+        warning: {
+            foreground: accentColor("warning"),
+            background: accentColor("warning", 0.1),
+            badgeBackground: accentColor("warning", 0.1),
+            border: accentColor("warning", 0.3),
+        },
+        attention: {
+            foreground: accentColor("attention"),
+            background: accentColor("attention", 0.1),
+            badgeBackground: accentColor("attention", 0.1),
+            border: accentColor("attention", 0.3),
+        },
+        danger: {
+            foreground: themeColor("danger"),
+            background: themeColor("danger", 0.1),
+            badgeBackground: themeColor("danger", 0.1),
+            border: themeColor("danger", 0.3),
+        },
+    },
+    interaction: {
+        hover: themeColor("text", 0.06),
+        focus: themeColor("contentBrand", 0.08),
+        pressed: themeColor("text", 0.1),
+        selected: themeColor("primary", 0.1),
+    },
+};
+//# sourceMappingURL=semantic-colors.js.map

package/dist/semantic-colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-colors.js","sourceRoot":"","sources":["../src/semantic-colors.ts"],"names":[],"mappings":"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","sourcesContent":["import { accentColor, themeColor } from \"./color-references.js\";\n\n/**\n * Stable role aliases above the legacy ThemeColors key set. New recipes should\n * prefer these roles so the underlying theme shape can evolve independently.\n */\nexport const semanticColors = {\n  canvas: themeColor(\"bg\"),\n  surface: {\n    default: themeColor(\"surface\"),\n    sunken: themeColor(\"surfaceAlt\"),\n    raised: themeColor(\"bg\"),\n    brand: themeColor(\"surfaceAccent\"),\n  },\n  content: {\n    primary: themeColor(\"text\"),\n    body: themeColor(\"textBody\"),\n    secondary: themeColor(\"textMuted\"),\n    tertiary: themeColor(\"textSub\"),\n    decorative: themeColor(\"textWeak\"),\n    brand: themeColor(\"contentBrand\"),\n    danger: themeColor(\"danger\"),\n    inverse: themeColor(\"onPrimary\"),\n  },\n  border: {\n    subtle: themeColor(\"border\", 0.7),\n    default: themeColor(\"border\"),\n    strong: themeColor(\"textWeak\"),\n    focus: themeColor(\"contentBrand\"),\n    danger: themeColor(\"danger\"),\n  },\n  action: {\n    brand: {\n      background: themeColor(\"primary\"),\n      content: themeColor(\"onPrimary\"),\n    },\n    neutral: {\n      background: themeColor(\"surfaceAlt\"),\n      content: themeColor(\"text\"),\n    },\n    danger: {\n      background: themeColor(\"dangerFill\"),\n      content: themeColor(\"onDanger\"),\n    },\n  },\n  feedback: {\n    info: {\n      foreground: accentColor(\"info\"),\n      background: accentColor(\"info\", 0.1),\n      badgeBackground: accentColor(\"info\", 0.1),\n      border: accentColor(\"info\", 0.3),\n    },\n    success: {\n      foreground: accentColor(\"success\"),\n      background: accentColor(\"success\", 0.1),\n      badgeBackground: accentColor(\"success\", 0.1),\n      border: accentColor(\"success\", 0.3),\n    },\n    warning: {\n      foreground: accentColor(\"warning\"),\n      background: accentColor(\"warning\", 0.1),\n      badgeBackground: accentColor(\"warning\", 0.1),\n      border: accentColor(\"warning\", 0.3),\n    },\n    attention: {\n      foreground: accentColor(\"attention\"),\n      background: accentColor(\"attention\", 0.1),\n      badgeBackground: accentColor(\"attention\", 0.1),\n      border: accentColor(\"attention\", 0.3),\n    },\n    danger: {\n      foreground: themeColor(\"danger\"),\n      background: themeColor(\"danger\", 0.1),\n      badgeBackground: themeColor(\"danger\", 0.1),\n      border: themeColor(\"danger\", 0.3),\n    },\n  },\n  interaction: {\n    hover: themeColor(\"text\", 0.06),\n    focus: themeColor(\"contentBrand\", 0.08),\n    pressed: themeColor(\"text\", 0.1),\n    selected: themeColor(\"primary\", 0.1),\n  },\n} as const;\n"]}

package/dist/sheet.d.ts

@@ -0,0 +1,51 @@
+/** Why an open Sheet is being asked to close. */
+export type SheetDismissReason = "close-action" | "escape" | "back" | "outside" | "swipe" | "programmatic";
+/**
+ * `trigger` only opens a Sheet. Every close reports the concrete dismiss reason
+ * so renderers and product analytics do not have to infer it from platform events.
+ */
+export type SheetOpenChangeDetails = Readonly<{
+    reason: "trigger" | SheetDismissReason;
+}>;
+/** User-dismiss policy. A controlled owner may always close programmatically. */
+export type SheetDismissPolicy = Readonly<{
+    dismissible: boolean;
+    dismissWhileBusy: boolean;
+    outsideDismiss: boolean;
+    escapeOrBackDismiss: boolean;
+    swipeDismiss: boolean;
+}>;
+export type SheetOpenState = Readonly<{
+    open: boolean;
+    defaultOpen?: never;
+    onOpenChange(open: boolean, detail: SheetOpenChangeDetails): void;
+}> | Readonly<{
+    open?: never;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean, detail: SheetOpenChangeDetails) => void;
+}>;
+export declare const sheetBehaviorDefaults: {
+    readonly dismissible: true;
+    readonly dismissWhileBusy: false;
+    readonly outsideDismiss: true;
+    readonly escapeOrBackDismiss: true;
+    readonly swipeDismiss: false;
+};
+/**
+ * Resolves an attempted close without platform knowledge. Programmatic close is
+ * intentionally an owner override: a controlled `open={false}` cannot be vetoed
+ * by a renderer, even while the Sheet is busy or not user-dismissible.
+ */
+export declare function canDismissSheet(reason: SheetDismissReason, busy: boolean, policy?: SheetDismissPolicy): boolean;
+export type SheetLifecycle = Readonly<{
+    open(): number;
+    beginDismiss(): number | null;
+    requestClose(reason: SheetDismissReason, busy: boolean, policy?: SheetDismissPolicy): boolean;
+    completeDismiss(cycle: number): boolean;
+}>;
+/**
+ * Makes persistent native Modal renderers settle each visible cycle once.
+ * Platform adapters still decide when native dismissal has actually completed.
+ */
+export declare function createSheetLifecycle(initiallyVisible?: boolean): SheetLifecycle;
+//# sourceMappingURL=sheet.d.ts.map

package/dist/sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet.d.ts","sourceRoot":"","sources":["../src/sheet.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,MAAM,kBAAkB,GAC1B,cAAc,GACd,QAAQ,GACR,MAAM,GACN,SAAS,GACT,OAAO,GACP,cAAc,CAAC;AAEnB;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C,MAAM,EAAE,SAAS,GAAG,kBAAkB,CAAC;CACxC,CAAC,CAAC;AAEH,iFAAiF;AACjF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GACtB,QAAQ,CAAC;IACP,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACnE,CAAC,GACF,QAAQ,CAAC;IACP,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,sBAAsB,KAAK,IAAI,CAAC;CACxE,CAAC,CAAC;AAEP,eAAO,MAAM,qBAAqB;;;;;;CAMK,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,kBAA0C,GACjD,OAAO,CAUT;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,IAAI,IAAI,MAAM,CAAC;IACf,YAAY,IAAI,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,CACV,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC;IACX,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACzC,CAAC,CAAC;AAEH;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,gBAAgB,UAAQ,GACvB,cAAc,CAgChB"}

package/dist/sheet.js

@@ -0,0 +1,69 @@
+export const sheetBehaviorDefaults = {
+    dismissible: true,
+    dismissWhileBusy: false,
+    outsideDismiss: true,
+    escapeOrBackDismiss: true,
+    swipeDismiss: false,
+};
+/**
+ * Resolves an attempted close without platform knowledge. Programmatic close is
+ * intentionally an owner override: a controlled `open={false}` cannot be vetoed
+ * by a renderer, even while the Sheet is busy or not user-dismissible.
+ */
+export function canDismissSheet(reason, busy, policy = sheetBehaviorDefaults) {
+    if (reason === "programmatic")
+        return true;
+    if (!policy.dismissible)
+        return false;
+    if (busy && !policy.dismissWhileBusy)
+        return false;
+    if (reason === "outside")
+        return policy.outsideDismiss;
+    if (reason === "escape" || reason === "back") {
+        return policy.escapeOrBackDismiss;
+    }
+    if (reason === "swipe")
+        return policy.swipeDismiss;
+    return true;
+}
+/**
+ * Makes persistent native Modal renderers settle each visible cycle once.
+ * Platform adapters still decide when native dismissal has actually completed.
+ */
+export function createSheetLifecycle(initiallyVisible = false) {
+    let sequence = initiallyVisible ? 1 : 0;
+    let activeCycle = initiallyVisible ? sequence : null;
+    let closeRequested = false;
+    const dismissingCycles = new Set();
+    return {
+        open() {
+            if (activeCycle !== null)
+                return activeCycle;
+            sequence += 1;
+            activeCycle = sequence;
+            closeRequested = false;
+            return activeCycle;
+        },
+        beginDismiss() {
+            if (activeCycle === null)
+                return null;
+            const cycle = activeCycle;
+            activeCycle = null;
+            closeRequested = false;
+            dismissingCycles.add(cycle);
+            return cycle;
+        },
+        requestClose(reason, busy, policy = sheetBehaviorDefaults) {
+            if (activeCycle === null || closeRequested)
+                return false;
+            if (!canDismissSheet(reason, busy, policy))
+                return false;
+            closeRequested = true;
+            return true;
+        },
+        completeDismiss(cycle) {
+            return dismissingCycles.delete(cycle);
+        },
+    };
+}
+//# sourceMappingURL=sheet.js.map

package/dist/sheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet.js","sourceRoot":"","sources":["../src/sheet.ts"],"names":[],"mappings":"AAsCA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,WAAW,EAAE,IAAI;IACjB,gBAAgB,EAAE,KAAK;IACvB,cAAc,EAAE,IAAI;IACpB,mBAAmB,EAAE,IAAI;IACzB,YAAY,EAAE,KAAK;CACkB,CAAC;AAExC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA0B,EAC1B,IAAa,EACb,SAA6B,qBAAqB;IAElD,IAAI,MAAM,KAAK,cAAc;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,cAAc,CAAC;IACvD,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAC7C,OAAO,MAAM,CAAC,mBAAmB,CAAC;IACpC,CAAC;IACD,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC,YAAY,CAAC;IACnD,OAAO,IAAI,CAAC;AACd,CAAC;AAaD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,gBAAgB,GAAG,KAAK;IAExB,IAAI,QAAQ,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,WAAW,GAAkB,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE3C,OAAO;QACL,IAAI;YACF,IAAI,WAAW,KAAK,IAAI;gBAAE,OAAO,WAAW,CAAC;YAC7C,QAAQ,IAAI,CAAC,CAAC;YACd,WAAW,GAAG,QAAQ,CAAC;YACvB,cAAc,GAAG,KAAK,CAAC;YACvB,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,YAAY;YACV,IAAI,WAAW,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;YACtC,MAAM,KAAK,GAAG,WAAW,CAAC;YAC1B,WAAW,GAAG,IAAI,CAAC;YACnB,cAAc,GAAG,KAAK,CAAC;YACvB,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,qBAAqB;YACvD,IAAI,WAAW,KAAK,IAAI,IAAI,cAAc;gBAAE,OAAO,KAAK,CAAC;YACzD,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;YACzD,cAAc,GAAG,IAAI,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,eAAe,CAAC,KAAK;YACnB,OAAO,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["/** Why an open Sheet is being asked to close. */\nexport type SheetDismissReason =\n  | \"close-action\"\n  | \"escape\"\n  | \"back\"\n  | \"outside\"\n  | \"swipe\"\n  | \"programmatic\";\n\n/**\n * `trigger` only opens a Sheet. Every close reports the concrete dismiss reason\n * so renderers and product analytics do not have to infer it from platform events.\n */\nexport type SheetOpenChangeDetails = Readonly<{\n  reason: \"trigger\" | SheetDismissReason;\n}>;\n\n/** User-dismiss policy. A controlled owner may always close programmatically. */\nexport type SheetDismissPolicy = Readonly<{\n  dismissible: boolean;\n  dismissWhileBusy: boolean;\n  outsideDismiss: boolean;\n  escapeOrBackDismiss: boolean;\n  swipeDismiss: boolean;\n}>;\n\nexport type SheetOpenState =\n  | Readonly<{\n      open: boolean;\n      defaultOpen?: never;\n      onOpenChange(open: boolean, detail: SheetOpenChangeDetails): void;\n    }>\n  | Readonly<{\n      open?: never;\n      defaultOpen?: boolean;\n      onOpenChange?: (open: boolean, detail: SheetOpenChangeDetails) => void;\n    }>;\n\nexport const sheetBehaviorDefaults = {\n  dismissible: true,\n  dismissWhileBusy: false,\n  outsideDismiss: true,\n  escapeOrBackDismiss: true,\n  swipeDismiss: false,\n} as const satisfies SheetDismissPolicy;\n\n/**\n * Resolves an attempted close without platform knowledge. Programmatic close is\n * intentionally an owner override: a controlled `open={false}` cannot be vetoed\n * by a renderer, even while the Sheet is busy or not user-dismissible.\n */\nexport function canDismissSheet(\n  reason: SheetDismissReason,\n  busy: boolean,\n  policy: SheetDismissPolicy = sheetBehaviorDefaults,\n): boolean {\n  if (reason === \"programmatic\") return true;\n  if (!policy.dismissible) return false;\n  if (busy && !policy.dismissWhileBusy) return false;\n  if (reason === \"outside\") return policy.outsideDismiss;\n  if (reason === \"escape\" || reason === \"back\") {\n    return policy.escapeOrBackDismiss;\n  }\n  if (reason === \"swipe\") return policy.swipeDismiss;\n  return true;\n}\n\nexport type SheetLifecycle = Readonly<{\n  open(): number;\n  beginDismiss(): number | null;\n  requestClose(\n    reason: SheetDismissReason,\n    busy: boolean,\n    policy?: SheetDismissPolicy,\n  ): boolean;\n  completeDismiss(cycle: number): boolean;\n}>;\n\n/**\n * Makes persistent native Modal renderers settle each visible cycle once.\n * Platform adapters still decide when native dismissal has actually completed.\n */\nexport function createSheetLifecycle(\n  initiallyVisible = false,\n): SheetLifecycle {\n  let sequence = initiallyVisible ? 1 : 0;\n  let activeCycle: number | null = initiallyVisible ? sequence : null;\n  let closeRequested = false;\n  const dismissingCycles = new Set<number>();\n\n  return {\n    open() {\n      if (activeCycle !== null) return activeCycle;\n      sequence += 1;\n      activeCycle = sequence;\n      closeRequested = false;\n      return activeCycle;\n    },\n    beginDismiss() {\n      if (activeCycle === null) return null;\n      const cycle = activeCycle;\n      activeCycle = null;\n      closeRequested = false;\n      dismissingCycles.add(cycle);\n      return cycle;\n    },\n    requestClose(reason, busy, policy = sheetBehaviorDefaults) {\n      if (activeCycle === null || closeRequested) return false;\n      if (!canDismissSheet(reason, busy, policy)) return false;\n      closeRequested = true;\n      return true;\n    },\n    completeDismiss(cycle) {\n      return dismissingCycles.delete(cycle);\n    },\n  };\n}\n"]}

package/dist/showcase.d.ts

@@ -0,0 +1,153 @@
+import { type ComponentCatalogEntry, type ComponentStatus, type ComponentSurfaceMaturity } from "./catalog.js";
+import type { ResolvedTheme } from "./colors.js";
+import type { DesignSystemDirection, DesignSystemEnvironmentInput } from "./design-system-provider.js";
+export type ShowcaseTheme = ResolvedTheme;
+export type ShowcaseDirection = DesignSystemDirection;
+/** Closed fixture subset of the Provider's continuous text-scale signal. */
+export type ShowcaseTextScale = 1 | 1.5 | 2;
+export type ShowcaseMotionPreference = "full" | "reduced";
+export type ShowcaseEnvironment = Readonly<{
+    id: "default" | "dark" | "large-text" | "rtl" | "reduced-motion";
+    label: string;
+    theme: ShowcaseTheme;
+    direction: ShowcaseDirection;
+    textScale: ShowcaseTextScale;
+    motion: ShowcaseMotionPreference;
+}>;
+/**
+ * A small, deliberate environment matrix catches the high-risk differences
+ * without multiplying every story into an unreadable Cartesian product.
+ */
+export declare const showcaseEnvironmentMatrix: readonly [{
+    readonly id: "default";
+    readonly label: "Light · LTR · 100%";
+    readonly theme: "light";
+    readonly direction: "ltr";
+    readonly textScale: 1;
+    readonly motion: "full";
+}, {
+    readonly id: "dark";
+    readonly label: "Dark · LTR · 100%";
+    readonly theme: "dark";
+    readonly direction: "ltr";
+    readonly textScale: 1;
+    readonly motion: "full";
+}, {
+    readonly id: "large-text";
+    readonly label: "Light · LTR · 200%";
+    readonly theme: "light";
+    readonly direction: "ltr";
+    readonly textScale: 2;
+    readonly motion: "full";
+}, {
+    readonly id: "rtl";
+    readonly label: "Light · RTL · 100%";
+    readonly theme: "light";
+    readonly direction: "rtl";
+    readonly textScale: 1;
+    readonly motion: "full";
+}, {
+    readonly id: "reduced-motion";
+    readonly label: "Light · LTR · Reduced motion";
+    readonly theme: "light";
+    readonly direction: "ltr";
+    readonly textScale: 1;
+    readonly motion: "reduced";
+}];
+/** Bridges documentation fixtures to the same environment contract products consume. */
+export declare function getShowcaseEnvironmentInput(environment: ShowcaseEnvironment): DesignSystemEnvironmentInput;
+export type ShowcaseScenarioId = "contract" | "default" | "dark" | "long-copy" | "large-text" | "rtl" | "reduced-motion" | "accessibility" | "keyboard" | "platform-parity";
+export type ShowcaseSurface = "contract" | "web" | "native";
+export type ShowcaseScenario = Readonly<{
+    id: ShowcaseScenarioId;
+    label: string;
+    description: string;
+}>;
+export declare const showcaseScenarios: readonly [{
+    readonly id: "contract";
+    readonly label: "Contract";
+    readonly description: "Anatomy, defaults, supported axes, platform and maturity are visible.";
+}, {
+    readonly id: "default";
+    readonly label: "Default";
+    readonly description: "The normal state renders using recipe defaults without product overrides.";
+}, {
+    readonly id: "dark";
+    readonly label: "Dark";
+    readonly description: "Semantic colors remain legible on the dark theme.";
+}, {
+    readonly id: "long-copy";
+    readonly label: "Long copy";
+    readonly description: "Long Korean and English copy wraps without clipping or hiding meaning.";
+}, {
+    readonly id: "large-text";
+    readonly label: "200% text";
+    readonly description: "Text can grow to 200% without truncating required information.";
+}, {
+    readonly id: "rtl";
+    readonly label: "RTL";
+    readonly description: "Logical start/end layout and directional icons mirror correctly.";
+}, {
+    readonly id: "reduced-motion";
+    readonly label: "Reduced motion";
+    readonly description: "Motion follows the recipe reduced-motion fallback.";
+}, {
+    readonly id: "accessibility";
+    readonly label: "Accessibility";
+    readonly description: "Names, states, relationships, contrast and touch targets are inspectable.";
+}, {
+    readonly id: "keyboard";
+    readonly label: "Keyboard";
+    readonly description: "Focus order and documented keyboard behavior run as interaction tests.";
+}, {
+    readonly id: "platform-parity";
+    readonly label: "Web / Native parity";
+    readonly description: "Adaptive renderers preserve intent while using platform-native behavior.";
+}];
+export type ShowcaseComponentEntry = Readonly<{
+    storyId: string;
+    component: ComponentCatalogEntry;
+    /** Resolved Web/Native renderer maturity, including legacy catalog inputs. */
+    surfaceMaturity: ComponentSurfaceMaturity;
+    requirements: readonly ShowcaseEvidenceRequirement[];
+    requiredScenarios: readonly ShowcaseScenarioId[];
+    requiredSurfaces: readonly ShowcaseSurface[];
+}>;
+export type ShowcaseEvidenceRequirement = Readonly<{
+    surface: ShowcaseSurface;
+    scenarios: readonly ShowcaseScenarioId[];
+}>;
+export type ShowcaseEvidenceEntry = Readonly<{
+    storyId: string;
+    surface: ShowcaseSurface;
+    scenarios: readonly ShowcaseScenarioId[];
+}>;
+export type ShowcaseCoverageEntry = Readonly<{
+    storyId: string;
+    component: ComponentCatalogEntry;
+    missingEvidence: readonly Readonly<{
+        surface: ShowcaseSurface;
+        scenario: ShowcaseScenarioId;
+    }>[];
+    missingSurfaces: readonly ShowcaseSurface[];
+    missingScenarios: readonly ShowcaseScenarioId[];
+    complete: boolean;
+}>;
+export declare function getShowcaseStoryId(entry: ComponentCatalogEntry): string;
+export declare function getRequiredShowcaseScenarios(entry: ComponentCatalogEntry): readonly ShowcaseScenarioId[];
+export declare function getRequiredShowcaseSurfaces(entry: ComponentCatalogEntry): readonly ShowcaseSurface[];
+export declare function getRequiredShowcaseEvidence(entry: ComponentCatalogEntry): readonly ShowcaseEvidenceRequirement[];
+export declare function createShowcaseManifest(entries?: readonly ComponentCatalogEntry[]): readonly ShowcaseComponentEntry[];
+export declare const showcaseManifest: readonly Readonly<{
+    storyId: string;
+    component: ComponentCatalogEntry;
+    /** Resolved Web/Native renderer maturity, including legacy catalog inputs. */
+    surfaceMaturity: ComponentSurfaceMaturity;
+    requirements: readonly ShowcaseEvidenceRequirement[];
+    requiredScenarios: readonly ShowcaseScenarioId[];
+    requiredSurfaces: readonly ShowcaseSurface[];
+}>[];
+export declare function createShowcaseCoverage(evidence: readonly ShowcaseEvidenceEntry[], manifest?: readonly ShowcaseComponentEntry[]): readonly ShowcaseCoverageEntry[];
+export declare function assertShowcaseCoverage(evidence: readonly ShowcaseEvidenceEntry[], manifest?: readonly ShowcaseComponentEntry[]): void;
+export declare function summarizeShowcaseMaturity(entries?: readonly ComponentCatalogEntry[]): Readonly<Record<ComponentStatus, number>>;
+//# sourceMappingURL=showcase.d.ts.map

package/dist/showcase.d.ts.map

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