@qijenchen/design-system 0.1.0-beta.3 → 0.1.0-beta.32

package/dist/components/Alert/alert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../../src/components/Alert/alert.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EAA8C,KAAK,aAAa,EAAE,MAAM,0CAA0C,CAAA;AA2CzH,QAAA,MAAM,aAAa;;8EAQjB,CAAA;AAEF,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,EACzD,YAAY,CAAC,OAAO,aAAa,CAAC;IACpC,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,UAAU,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;IAC/B,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC7B,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB;AAGD,QAAA,MAAM,KAAK,mFA2FV,CAAA;AAMD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBZ,CAAA;AAEV,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAA"}

package/dist/components/Alert/alert.js

@@ -0,0 +1,132 @@
+import { jsx } from "react/jsx-runtime";
+import * as React from "react";
+import { cva } from "class-variance-authority";
+import { cn } from "../../lib/utils.js";
+import { useInverseTheme, SUBTLE_ICON_COLOR, Notice } from "../Notice/notice.js";
+const SUBTLE_CONTAINER = {
+  neutral: "bg-muted border border-border",
+  info: "bg-info-subtle border border-[var(--info-hover)]",
+  success: "bg-success-subtle border border-[var(--success-hover)]",
+  warning: "bg-warning-subtle border border-[var(--warning-hover)]",
+  error: "bg-error-subtle border border-[var(--error-hover)]"
+};
+const SOLID_HUE_BG = {
+  info: "bg-info",
+  success: "bg-success",
+  warning: "bg-warning",
+  error: "bg-error"
+};
+const SOLID_HUE_THEME = {
+  info: "dark",
+  success: "dark",
+  warning: "light",
+  error: "dark"
+};
+const alertVariants = cva("w-full overflow-hidden", {
+  variants: {
+    placement: {
+      inline: "rounded-md",
+      fixed: "rounded-none border-none"
+    }
+  },
+  defaultVariants: { placement: "inline" }
+});
+const Alert = React.forwardRef(
+  ({
+    variant = "neutral",
+    appearance = "subtle",
+    placement,
+    title,
+    description,
+    endContent,
+    dismissible = true,
+    onDismiss,
+    className,
+    ...props
+  }, ref) => {
+    const inverseTheme = useInverseTheme();
+    const isSolid = appearance === "solid";
+    const iconClassName = !isSolid ? SUBTLE_ICON_COLOR[variant] : void 0;
+    const isCritical = variant === "error" || variant === "warning";
+    const liveRole = isCritical ? "alert" : "status";
+    const liveLevel = isCritical ? "assertive" : "polite";
+    const noticeEl = /* @__PURE__ */ jsx(
+      Notice,
+      {
+        variant,
+        title,
+        description,
+        endContent,
+        dismissible,
+        onDismiss,
+        iconClassName,
+        className: placement === "fixed" ? "px-[var(--layout-space-loose)]" : void 0
+      }
+    );
+    if (!isSolid) {
+      return /* @__PURE__ */ jsx(
+        "div",
+        {
+          ref,
+          role: liveRole,
+          "aria-live": liveLevel,
+          className: cn(alertVariants({ placement }), SUBTLE_CONTAINER[variant], className),
+          ...props,
+          children: noticeEl
+        }
+      );
+    }
+    if (variant === "neutral") {
+      return /* @__PURE__ */ jsx(
+        "div",
+        {
+          ref,
+          role: liveRole,
+          "aria-live": liveLevel,
+          "data-theme": inverseTheme,
+          className: cn(alertVariants({ placement }), "bg-surface-raised text-foreground", className),
+          ...props,
+          children: noticeEl
+        }
+      );
+    }
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref,
+        role: liveRole,
+        "aria-live": liveLevel,
+        className: cn(alertVariants({ placement }), SOLID_HUE_BG[variant], className),
+        ...props,
+        children: /* @__PURE__ */ jsx("div", { "data-theme": SOLID_HUE_THEME[variant], className: "text-foreground", children: noticeEl })
+      }
+    );
+  }
+);
+Alert.displayName = "Alert";
+const alertMeta = {
+  component: "Alert",
+  family: null,
+  // non-family composite / overlay / layout
+  variants: {
+    neutral: { purpose: "中性提示(系統公告、非緊急說明);無情緒色" },
+    info: { purpose: "資訊性提示(版本更新、流程說明);藍色 hue" },
+    success: { purpose: "成功狀態的持久性宣告(綁定生效、付款完成需保留確認)" },
+    warning: { purpose: "警告但非阻斷(方案到期、需更新付款方式);最高頻" },
+    error: { purpose: "錯誤但非阻斷(系統錯誤可重試、API 失敗摘要);aria-live=assertive" }
+  },
+  sizes: {},
+  states: ["default", "hover", "active", "focus-visible", "disabled"],
+  tokens: {
+    bg: ["bg-error", "bg-error-subtle", "bg-info", "bg-info-subtle", "bg-muted", "bg-success", "bg-success-subtle", "bg-surface-raised", "bg-warning", "bg-warning-subtle"],
+    fg: ["text-foreground"],
+    ring: []
+  },
+  defaultVariant: "neutral"
+};
+export {
+  Alert,
+  alertMeta,
+  alertVariants
+};
+//# sourceMappingURL=alert.js.map

package/dist/components/Alert/alert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert.js","sources":["../../../src/components/Alert/alert.tsx"],"sourcesContent":["// @benchmark-unverified-blanket: file-level retraction per M22 (d) — claims herein not individually URL-cited; treat as unverified visual/usage rumor unless retrofit per-claim. Hook escape preserved.\nimport * as React from 'react'\nimport { cva, type VariantProps } from 'class-variance-authority'\nimport { cn } from '@/lib/utils'\nimport { Notice, useInverseTheme, SUBTLE_ICON_COLOR, type NoticeVariant } from '@/design-system/components/Notice/notice'\n\n/**\n * Alert — inline / fixed 通知\n *\n * ── data-theme 必須搭配 text-foreground ──\n * CSS color 從 body 繼承已解析值,data-theme 只改 --foreground 不改 color。\n * 在 theme boundary 設 text-foreground 強制 re-resolve。\n *\n * ── Appearance ──\n * subtle: 淺底色 + 四邊 1px border(色相 hover 色)。不設 data-theme,跟隨頁面。\n * solid: 跟 Toast 對齊:\n *   neutral → data-theme={inverse} + bg-surface-raised（同層翻轉）\n *   info/success/error → bg on outer, data-theme=\"dark\" on inner\n *   warning → bg on outer, data-theme=\"light\" on inner\n *\n * ── Placement ──\n * inline: rounded-md(card-level 圓角,非 overlay — 因 Alert 在頁面流內,非 floating)\n * fixed: 無圓角,full-width,無 border\n */\n\nconst SUBTLE_CONTAINER: Record<NoticeVariant, string> = {\n  neutral: 'bg-muted border border-border',\n  info: 'bg-info-subtle border border-[var(--info-hover)]',\n  success: 'bg-success-subtle border border-[var(--success-hover)]',\n  warning: 'bg-warning-subtle border border-[var(--warning-hover)]',\n  error: 'bg-error-subtle border border-[var(--error-hover)]',\n}\n\nconst SOLID_HUE_BG: Record<string, string> = {\n  info: 'bg-info',\n  success: 'bg-success',\n  warning: 'bg-warning',\n  error: 'bg-error',\n}\n\nconst SOLID_HUE_THEME: Record<string, string> = {\n  info: 'dark',\n  success: 'dark',\n  warning: 'light',\n  error: 'dark',\n}\n\nconst alertVariants = cva('w-full overflow-hidden', {\n  variants: {\n    placement: {\n      inline: 'rounded-md',\n      fixed: 'rounded-none border-none',\n    },\n  },\n  defaultVariants: { placement: 'inline' },\n})\n\nexport interface AlertProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'>,\n    VariantProps<typeof alertVariants> {\n  variant?: NoticeVariant\n  appearance?: 'subtle' | 'solid'\n  title: React.ReactNode\n  description?: React.ReactNode\n  endContent?: React.ReactNode\n  dismissible?: boolean\n  onDismiss?: () => void\n}\n\n// code-quality-allow: long-function — foundational composite main body — 拆 sub-fn 會複雜化 local state / ref / context binding\nconst Alert = React.forwardRef<HTMLDivElement, AlertProps>(\n  (\n    {\n      variant = 'neutral',\n      appearance = 'subtle',\n      placement,\n      title,\n      description,\n      endContent,\n      dismissible = true,\n      onDismiss,\n      className,\n      ...props\n    },\n    ref,\n  ) => {\n    const inverseTheme = useInverseTheme()\n    const isSolid = appearance === 'solid'\n    const iconClassName = !isSolid ? SUBTLE_ICON_COLOR[variant] : undefined\n\n    // ── Live region 由 wrapping consumer 擁有(WAI-ARIA + Atlassian / Polaris / Material 共識) ──\n    // Alert 是 outer host —— 自己擁有 role + aria-live;Notice(inner layout)不再帶 role,\n    // 避免 nested live region 造成 screen reader 重複朗讀。\n    // - error / warning → role=\"alert\" + aria-live=\"assertive\"(中斷,使用者必須立刻知道)\n    // - info / success / neutral → role=\"status\" + aria-live=\"polite\"(空閒朗讀,不打斷)\n    const isCritical = variant === 'error' || variant === 'warning'\n    const liveRole = isCritical ? 'alert' : 'status'\n    const liveLevel = isCritical ? 'assertive' : 'polite'\n\n    // placement=\"fixed\" 用 loose px(density-aware)讓 Alert 嵌在更大佈局內時跟周圍\n   // loose-padding 元素(Toolbar / BulkActionBar / DataTable 等)左右對齊。\n    // py 維持 py-3 fixed(notification banner family canonical,垂直不隨 density)。\n    const noticeEl = (\n      <Notice\n        variant={variant}\n        title={title}\n        description={description}\n        endContent={endContent}\n        dismissible={dismissible}\n        onDismiss={onDismiss}\n        iconClassName={iconClassName}\n        className={placement === 'fixed' ? 'px-[var(--layout-space-loose)]' : undefined}\n      />\n    )\n\n    // ── Subtle ──\n    if (!isSolid) {\n      return (\n        <div\n          ref={ref}\n          role={liveRole}\n          aria-live={liveLevel}\n          className={cn(alertVariants({ placement }), SUBTLE_CONTAINER[variant], className)}\n          {...props}\n        >\n          {noticeEl}\n        </div>\n      )\n    }\n\n    // ── Solid neutral (inverse: bg + theme 同層) ──\n    if (variant === 'neutral') {\n      return (\n        <div\n          ref={ref}\n          role={liveRole}\n          aria-live={liveLevel}\n          data-theme={inverseTheme}\n          className={cn(alertVariants({ placement }), 'bg-surface-raised text-foreground', className)}\n          {...props}\n        >\n          {noticeEl}\n        </div>\n      )\n    }\n\n    // ── Solid 有色相: bg outer + data-theme inner ──\n    return (\n      <div\n        ref={ref}\n        role={liveRole}\n        aria-live={liveLevel}\n        className={cn(alertVariants({ placement }), SOLID_HUE_BG[variant], className)}\n        {...props}\n      >\n        <div data-theme={SOLID_HUE_THEME[variant]} className=\"text-foreground\">\n          {noticeEl}\n        </div>\n      </div>\n    )\n  },\n)\nAlert.displayName = 'Alert'\n\n// Story auto-compile metadata — Phase 2 fill(2026-05-15)\n// Variants = NoticeVariant 5 hues(prop name `variant`,cva 內僅 placement,色相由 SUBTLE_CONTAINER / SOLID_HUE_BG map 控)\n// Sizes = none(Alert 視覺尺寸繼承 Notice primitive,不隨 size 變;見 spec「為何無 SizeMatrix」)\nexport const alertMeta = {\n  component: 'Alert',\n  family: null, // non-family composite / overlay / layout\n  variants: {\n    neutral: { purpose: '中性提示(系統公告、非緊急說明);無情緒色' },\n    info: { purpose: '資訊性提示(版本更新、流程說明);藍色 hue' },\n    success: { purpose: '成功狀態的持久性宣告(綁定生效、付款完成需保留確認)' },\n    warning: { purpose: '警告但非阻斷(方案到期、需更新付款方式);最高頻' },\n    error: { purpose: '錯誤但非阻斷(系統錯誤可重試、API 失敗摘要);aria-live=assertive' },\n  },\n  sizes: {},\n  states: ['default', 'hover', 'active', 'focus-visible', 'disabled'],\n  tokens: {\n    bg: ['bg-error', 'bg-error-subtle', 'bg-info', 'bg-info-subtle', 'bg-muted', 'bg-success', 'bg-success-subtle', 'bg-surface-raised', 'bg-warning', 'bg-warning-subtle'],\n    fg: ['text-foreground'],\n    ring: [],\n  },\n  defaultVariant: 'neutral',\n} as const\n\nexport { Alert, alertVariants }\n"],"names":[],"mappings":"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"}

package/dist/components/Alert/index.d.ts

@@ -0,0 +1,2 @@
+export * from './alert';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Alert/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Alert/index.ts"],"names":[],"mappings":"AAIA,cAAc,SAAS,CAAA"}

package/dist/components/Alert/index.js

@@ -0,0 +1,7 @@
+import { Alert, alertMeta, alertVariants } from "./alert.js";
+export {
+  Alert,
+  alertMeta,
+  alertVariants
+};
+//# sourceMappingURL=index.js.map

package/dist/components/Alert/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/AppShell/_demo-helpers.d.ts

@@ -0,0 +1,49 @@
+export declare const MAIN_NAV: readonly [{
+    readonly id: "dashboard";
+    readonly label: "Dashboard";
+    readonly icon: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+}, {
+    readonly id: "inbox";
+    readonly label: "Inbox";
+    readonly icon: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+}, {
+    readonly id: "team";
+    readonly label: "Team";
+    readonly icon: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+}, {
+    readonly id: "insights";
+    readonly label: "Insights";
+    readonly icon: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+}, {
+    readonly id: "calendar";
+    readonly label: "Calendar";
+    readonly icon: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+}, {
+    readonly id: "settings";
+    readonly label: "Settings";
+    readonly icon: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+}];
+export declare const WorkspaceBrand: () => import("react/jsx-runtime").JSX.Element;
+export declare const UserFooter: () => import("react/jsx-runtime").JSX.Element;
+export declare function AcmeSidebar({ viewportInsetTop, includeWorkspaceBrand, }?: {
+    viewportInsetTop?: string;
+    includeWorkspaceBrand?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function GlobalHeader({ rightSlot }?: {
+    rightSlot?: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function PageHeader({ title, tabsSlot, includeSidebarTrigger, }: {
+    title: string;
+    /**
+     * Optional tabs row(per header-canonical.spec.md W1-W6 + Background ownership 段)。
+     * 提供時 ChromeHeader 自動 column mode + suppress border + delegate paint 給 TabsList。
+     */
+    tabsSlot?: React.ReactNode;
+    /**
+     * 是否含 SidebarTrigger(2026-05-21 加 per user「primary-header mode 的 sidebar toggle 應該只放在 primary header 才對」)。
+     * - `primary-sidebar` mode = true(預設):PageHeader 是 chrome 第一層,trigger 自然在這
+     * - `primary-header` mode = false:SidebarTrigger 已在 GlobalHeader,PageHeader 不該重複
+     */
+    includeSidebarTrigger?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=_demo-helpers.d.ts.map

package/dist/components/AppShell/_demo-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_demo-helpers.d.ts","sourceRoot":"","sources":["../../../src/components/AppShell/_demo-helpers.tsx"],"names":[],"mappings":"AAuCA,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;EAOX,CAAA;AAqBV,eAAO,MAAM,cAAc,+CAM1B,CAAA;AAID,eAAO,MAAM,UAAU,+CAuBtB,CAAA;AAMD,wBAAgB,WAAW,CAAC,EAC1B,gBAAgB,EAChB,qBAA4B,GAC7B,GAAE;IACD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAC3B,2CAgCL;AAQD,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,GAAE;IAAE,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAAO,2CAY/E;AASD,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,qBAA4B,GAC7B,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC,2CAOA"}

package/dist/components/AppShell/app-shell.d.ts

@@ -0,0 +1,76 @@
+/**
+ * AppShell — web service page-level layout primitive。
+ *
+ * 組合 Sidebar + ChromeHeader + Aside + main 成完整 page shell。SSOT 邊界:本 pattern only
+ * own slot composition + layout mode + Aside responsive mode;不 own sidebar / header /
+ * sheet 視覺(各自 spec own)。
+ *
+ * 對齊 Mantine AppShell compound API + Ant Layout slot 模式 + Material 3 standard/modal
+ * drawer canonical(per spec.md frontmatter cite)。
+ *
+ * Spec SSOT:`patterns/app-shell/app-shell.spec.md`
+ */
+import * as React from 'react';
+type AppShellLayout = 'primary-sidebar' | 'primary-header';
+export interface AppShellProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** primary-sidebar (Linear/Notion 派) | primary-header (GitHub/Slack 派);預設 primary-sidebar */
+    layout?: AppShellLayout;
+    /** Sidebar 元素(必傳 Sidebar primitive,per Consumer 紀律)*/
+    sidebar?: React.ReactNode;
+    /**
+     * Local page header(永遠 render 在 main column 頂部,當前頁 actions / breadcrumb / page-level filter)。
+     * 兩 layout mode 都會 render 此 slot — `primary-header` mode 多了 globalHeader 在上方,
+     * **不取代** local header(per 2026-05-20 user clarification「primary-header = primary-sidebar + 一條 global header」)。
+     */
+    header?: React.ReactNode;
+    /**
+     * Global header(僅 `primary-header` mode render)。橫跨整 viewport 的頂部 bar:
+     * account avatar / workspace switcher / global search / notifications。
+     * 對齊 GitHub top nav / Slack workspace bar / Gmail logo bar 慣例。
+     * `primary-sidebar` mode 傳此 prop 會被忽略。
+     */
+    globalHeader?: React.ReactNode;
+    /** Aside 元素(`<AppShellAside>` sub-component);可選 */
+    aside?: React.ReactNode;
+    /** Aside open state(modal mode 必須)*/
+    asideOpen?: boolean;
+    onAsideOpenChange?: (open: boolean) => void;
+    /** Main content;`<main>` landmark + padding=0 */
+    children: React.ReactNode;
+}
+export interface AppShellAsideProps {
+    /** Required:modal mode 走 Sheet → aria-labelledby 強制,per sheet.spec.md:98 */
+    title: string;
+    /** Width(number 或 breakpoint-keyed object);clamp min:240 max:640 */
+    width?: number | {
+        md?: number;
+        xl?: number;
+    };
+    /** Children content */
+    children: React.ReactNode;
+    className?: string;
+}
+interface AppShellContextValue {
+    layout: AppShellLayout;
+    asideOpen: boolean;
+    setAsideOpen: (open: boolean) => void;
+    isMobile: boolean;
+}
+declare function useAppShell(): AppShellContextValue;
+declare const AppShell: React.ForwardRefExoticComponent<AppShellProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * AppShellAside — right panel:standard inline(desktop) vs modal overlay(mobile)。
+ *
+ * Desktop(viewport ≥ 768px):
+ *   - Render 直接放 layout grid 右側(asideOpen=true 才 mount,close hide via parent)
+ *   - 不蓋 mask / background 可操作 / 佔 layout 寬
+ *   - Vertical extent:primary-sidebar → 頂天立地 / primary-header → header 下方
+ *
+ * Mobile(viewport < 768px):
+ *   - Render 走 Sheet primitive(side="right",per sheet.spec.md)
+ *   - Mask 蓋 / background 不可操作 / 不佔 layout 寬
+ *   - title 強制(aria-labelledby per sheet.spec.md:98)
+ */
+declare const AppShellAside: React.ForwardRefExoticComponent<AppShellAsideProps & React.RefAttributes<HTMLElement>>;
+export { AppShell, AppShellAside, useAppShell };
+//# sourceMappingURL=app-shell.d.ts.map

package/dist/components/AppShell/app-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../../src/components/AppShell/app-shell.tsx"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAc9B,KAAK,cAAc,GAAG,iBAAiB,GAAG,gBAAgB,CAAA;AAE1D,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACzE,6FAA6F;IAC7F,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,sDAAsD;IACtD,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACxB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC9B,mDAAmD;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAC3C,iDAAiD;IACjD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,uBAAuB;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAID,UAAU,oBAAoB;IAC5B,MAAM,EAAE,cAAc,CAAA;IACtB,SAAS,EAAE,OAAO,CAAA;IAClB,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,QAAQ,EAAE,OAAO,CAAA;CAClB;AAID,iBAAS,WAAW,IAAI,oBAAoB,CAI3C;AA+DD,QAAA,MAAM,QAAQ,sFAgIb,CAAA;AAKD;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,aAAa,wFAgElB,CAAA;AAQD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA"}

package/dist/components/AppShell/app-shell.js

@@ -0,0 +1,214 @@
+import { jsx, jsxs, Fragment } from "react/jsx-runtime";
+import * as React from "react";
+import { X } from "lucide-react";
+import { Sheet, SheetContent } from "../Sheet/sheet.js";
+import { Button } from "../Button/button.js";
+import { ScrollArea } from "../ScrollArea/scroll-area.js";
+import { ChromeHeader } from "../../patterns/header-canonical/chrome-header.js";
+import { useIsNarrowViewport } from "../../hooks/use-is-narrow-viewport.js";
+import { cn } from "../../lib/utils.js";
+const AppShellContext = React.createContext(null);
+function useAppShell() {
+  const ctx = React.useContext(AppShellContext);
+  if (!ctx) throw new Error("AppShellAside must be used within <AppShell>");
+  return ctx;
+}
+const XL_BREAKPOINT_PX = 1280;
+function useIsXl() {
+  const [isXl, setIsXl] = React.useState(() => {
+    if (typeof window === "undefined") return false;
+    return window.matchMedia(`(min-width: ${XL_BREAKPOINT_PX}px)`).matches;
+  });
+  React.useEffect(() => {
+    const mq = window.matchMedia(`(min-width: ${XL_BREAKPOINT_PX}px)`);
+    const handler = (e) => setIsXl(e.matches);
+    mq.addEventListener("change", handler);
+    return () => mq.removeEventListener("change", handler);
+  }, []);
+  return isXl;
+}
+const ASIDE_WIDTH_MIN = 240;
+const ASIDE_WIDTH_MAX = 640;
+const ASIDE_WIDTH_DEFAULT = 320;
+function resolveAsideWidth(width, isXl) {
+  if (typeof width === "number") {
+    return Math.max(ASIDE_WIDTH_MIN, Math.min(ASIDE_WIDTH_MAX, width));
+  }
+  if (width && typeof width === "object") {
+    const v = (isXl ? width.xl ?? width.md : width.md) ?? ASIDE_WIDTH_DEFAULT;
+    return Math.max(ASIDE_WIDTH_MIN, Math.min(ASIDE_WIDTH_MAX, v));
+  }
+  return ASIDE_WIDTH_DEFAULT;
+}
+function SkipToMain() {
+  return /* @__PURE__ */ jsx(
+    "a",
+    {
+      href: "#app-shell-main",
+      className: cn(
+        "sr-only focus:not-sr-only",
+        "focus:fixed focus:top-2 focus:left-2 focus:z-50",
+        "focus:px-3 focus:py-2 focus:rounded-md",
+        "focus:bg-surface focus:text-foreground focus:shadow-[var(--elevation-200)]",
+        "focus:outline-none focus:ring-2 focus:ring-primary"
+      ),
+      children: "Skip to main content"
+    }
+  );
+}
+const AppShell = React.forwardRef(
+  ({
+    layout = "primary-sidebar",
+    sidebar,
+    header,
+    globalHeader,
+    aside,
+    asideOpen: asideOpenProp,
+    onAsideOpenChange,
+    children,
+    className,
+    ...props
+  }, ref) => {
+    const [asideOpenInternal, setAsideOpenInternal] = React.useState(false);
+    const isControlled = asideOpenProp !== void 0;
+    const asideOpen = isControlled ? asideOpenProp : asideOpenInternal;
+    const setAsideOpen = React.useCallback(
+      (open) => {
+        if (!isControlled) setAsideOpenInternal(open);
+        onAsideOpenChange == null ? void 0 : onAsideOpenChange(open);
+      },
+      [isControlled, onAsideOpenChange]
+    );
+    const isMobile = useIsNarrowViewport();
+    React.useEffect(() => {
+      const onKey = (e) => {
+        if (e.key === "." && (e.metaKey || e.ctrlKey)) {
+          e.preventDefault();
+          setAsideOpen(!asideOpen);
+        }
+      };
+      window.addEventListener("keydown", onKey);
+      return () => window.removeEventListener("keydown", onKey);
+    }, [asideOpen, setAsideOpen]);
+    const ctxValue = React.useMemo(
+      () => ({ layout, asideOpen, setAsideOpen, isMobile }),
+      [layout, asideOpen, setAsideOpen, isMobile]
+    );
+    if (layout === "primary-header") {
+      return /* @__PURE__ */ jsx(AppShellContext.Provider, { value: ctxValue, children: /* @__PURE__ */ jsxs(
+        "div",
+        {
+          ref,
+          className: cn("flex h-svh w-full flex-col overflow-hidden bg-canvas", className),
+          ...props,
+          children: [
+            /* @__PURE__ */ jsx(SkipToMain, {}),
+            globalHeader && /* @__PURE__ */ jsx("div", { className: "flex-shrink-0", children: globalHeader }),
+            /* @__PURE__ */ jsxs("div", { className: "flex flex-1 min-h-0 w-full", children: [
+              sidebar,
+              /* @__PURE__ */ jsxs("div", { className: "flex flex-col flex-1 min-w-0 min-h-0 overflow-hidden", children: [
+                header && /* @__PURE__ */ jsx("div", { className: "flex-shrink-0", children: header }),
+                /* @__PURE__ */ jsx(
+                  "main",
+                  {
+                    id: "app-shell-main",
+                    tabIndex: -1,
+                    className: "flex-1 min-w-0 min-h-0 overflow-y-auto focus:outline-none",
+                    children
+                  }
+                )
+              ] }),
+              aside
+            ] })
+          ]
+        }
+      ) });
+    }
+    return /* @__PURE__ */ jsx(AppShellContext.Provider, { value: ctxValue, children: /* @__PURE__ */ jsxs(
+      "div",
+      {
+        ref,
+        className: cn("flex h-svh w-full overflow-hidden bg-canvas", className),
+        ...props,
+        children: [
+          /* @__PURE__ */ jsx(SkipToMain, {}),
+          sidebar,
+          /* @__PURE__ */ jsxs("div", { className: "flex flex-col flex-1 min-w-0 min-h-0 overflow-hidden", children: [
+            header && // Header 在 main column 內(main col sibling,非 main descendant)→ 跟 W3C ARIA in HTML
+            // banner rule 對照:`<header>` 在 main descendant 才不是 banner,本 ChromeHeader 是 <div>
+            // 所以本來就不會被 banner role 計算。仍包 wrap div not <header> 確保不無意觸發 banner。
+            /* @__PURE__ */ jsx("div", { className: "flex-shrink-0", children: header }),
+            /* @__PURE__ */ jsx(
+              "main",
+              {
+                id: "app-shell-main",
+                tabIndex: -1,
+                className: "flex-1 min-h-0 overflow-y-auto focus:outline-none",
+                children
+              }
+            )
+          ] }),
+          aside
+        ]
+      }
+    ) });
+  }
+);
+AppShell.displayName = "AppShell";
+const AppShellAside = React.forwardRef(
+  ({ title, width, children, className }, ref) => {
+    const { asideOpen, setAsideOpen, isMobile } = useAppShell();
+    const isXl = useIsXl();
+    const resolvedWidth = resolveAsideWidth(width, isXl);
+    const frame = /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsxs(ChromeHeader, { children: [
+        /* @__PURE__ */ jsx("h2", { className: "text-body-lg font-medium flex-1 truncate", children: title }),
+        /* @__PURE__ */ jsx(
+          Button,
+          {
+            iconOnly: true,
+            dismiss: true,
+            size: "sm",
+            startIcon: X,
+            "aria-label": "關閉",
+            onClick: () => setAsideOpen(false)
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsx(ScrollArea, { className: "flex-1 min-h-0", children })
+    ] });
+    if (isMobile) {
+      return /* @__PURE__ */ jsx(Sheet, { open: asideOpen, onOpenChange: setAsideOpen, children: /* @__PURE__ */ jsx(
+        SheetContent,
+        {
+          side: "right",
+          className: "w-[min(90vw,var(--app-shell-aside-modal-width))] flex flex-col p-0 [&>button]:hidden",
+          style: { ["--app-shell-aside-modal-width"]: `${resolvedWidth}px` },
+          children: frame
+        }
+      ) });
+    }
+    if (!asideOpen) return null;
+    return /* @__PURE__ */ jsx(
+      "aside",
+      {
+        ref,
+        "aria-label": title,
+        className: cn(
+          "flex flex-col h-full min-h-0 overflow-hidden",
+          "bg-surface border-l border-divider",
+          className
+        ),
+        style: { width: resolvedWidth },
+        children: frame
+      }
+    );
+  }
+);
+AppShellAside.displayName = "AppShellAside";
+export {
+  AppShell,
+  AppShellAside,
+  useAppShell
+};
+//# sourceMappingURL=app-shell.js.map

package/dist/components/AppShell/app-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-shell.js","sources":["../../../src/components/AppShell/app-shell.tsx"],"sourcesContent":["// @benchmark-cited: 2026-05-19 — Mantine AppShell / Ant Layout / Material 3 Drawer / Atlassian Navigation System cite in app-shell.spec.md frontmatter.\n/**\n * AppShell — web service page-level layout primitive。\n *\n * 組合 Sidebar + ChromeHeader + Aside + main 成完整 page shell。SSOT 邊界:本 pattern only\n * own slot composition + layout mode + Aside responsive mode;不 own sidebar / header /\n * sheet 視覺(各自 spec own)。\n *\n * 對齊 Mantine AppShell compound API + Ant Layout slot 模式 + Material 3 standard/modal\n * drawer canonical(per spec.md frontmatter cite)。\n *\n * Spec SSOT:`patterns/app-shell/app-shell.spec.md`\n */\n\nimport * as React from 'react'\nimport { X as XIcon } from 'lucide-react'\nimport {\n  Sheet,\n  SheetContent,\n} from '@/design-system/components/Sheet/sheet'\nimport { Button } from '@/design-system/components/Button/button'\nimport { ScrollArea } from '@/design-system/components/ScrollArea/scroll-area'\nimport { ChromeHeader } from '@/design-system/patterns/header-canonical/chrome-header'\nimport { useIsNarrowViewport } from '@/design-system/hooks/use-is-narrow-viewport'\nimport { cn } from '@/lib/utils'\n\n// ── Types ────────────────────────────────────────────────────────────────────\n\ntype AppShellLayout = 'primary-sidebar' | 'primary-header'\n\nexport interface AppShellProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** primary-sidebar (Linear/Notion 派) | primary-header (GitHub/Slack 派);預設 primary-sidebar */\n  layout?: AppShellLayout\n  /** Sidebar 元素(必傳 Sidebar primitive,per Consumer 紀律)*/\n  sidebar?: React.ReactNode\n  /**\n   * Local page header(永遠 render 在 main column 頂部,當前頁 actions / breadcrumb / page-level filter)。\n   * 兩 layout mode 都會 render 此 slot — `primary-header` mode 多了 globalHeader 在上方,\n   * **不取代** local header(per 2026-05-20 user clarification「primary-header = primary-sidebar + 一條 global header」)。\n   */\n  header?: React.ReactNode\n  /**\n   * Global header(僅 `primary-header` mode render)。橫跨整 viewport 的頂部 bar:\n   * account avatar / workspace switcher / global search / notifications。\n   * 對齊 GitHub top nav / Slack workspace bar / Gmail logo bar 慣例。\n   * `primary-sidebar` mode 傳此 prop 會被忽略。\n   */\n  globalHeader?: React.ReactNode\n  /** Aside 元素(`<AppShellAside>` sub-component);可選 */\n  aside?: React.ReactNode\n  /** Aside open state(modal mode 必須)*/\n  asideOpen?: boolean\n  onAsideOpenChange?: (open: boolean) => void\n  /** Main content;`<main>` landmark + padding=0 */\n  children: React.ReactNode\n}\n\nexport interface AppShellAsideProps {\n  /** Required:modal mode 走 Sheet → aria-labelledby 強制,per sheet.spec.md:98 */\n  title: string\n  /** Width(number 或 breakpoint-keyed object);clamp min:240 max:640 */\n  width?: number | { md?: number; xl?: number }\n  /** Children content */\n  children: React.ReactNode\n  className?: string\n}\n\n// ── Context ──────────────────────────────────────────────────────────────────\n\ninterface AppShellContextValue {\n  layout: AppShellLayout\n  asideOpen: boolean\n  setAsideOpen: (open: boolean) => void\n  isMobile: boolean\n}\n\nconst AppShellContext = React.createContext<AppShellContextValue | null>(null)\n\nfunction useAppShell(): AppShellContextValue {\n  const ctx = React.useContext(AppShellContext)\n  if (!ctx) throw new Error('AppShellAside must be used within <AppShell>')\n  return ctx\n}\n\n// Mobile breakpoint:**消費既有 `useIsNarrowViewport`**(`hooks/use-is-narrow-viewport.ts` SSOT,\n// 768px,跟 Sidebar SSOT 同源)— 不發明 local hook,per codex Layer B D2/D4 verdict 避 drift。\n\n// xl breakpoint(對齊 Tailwind v4 xl = 1280px,DS-wide consensus)\nconst XL_BREAKPOINT_PX = 1280\n\nfunction useIsXl(): boolean {\n  const [isXl, setIsXl] = React.useState<boolean>(() => {\n    if (typeof window === 'undefined') return false\n    return window.matchMedia(`(min-width: ${XL_BREAKPOINT_PX}px)`).matches\n  })\n\n  React.useEffect(() => {\n    const mq = window.matchMedia(`(min-width: ${XL_BREAKPOINT_PX}px)`)\n    const handler = (e: MediaQueryListEvent) => setIsXl(e.matches)\n    mq.addEventListener('change', handler)\n    return () => mq.removeEventListener('change', handler)\n  }, [])\n\n  return isXl\n}\n\n// ── Width resolve(consumer 自傳 + clamp 240-640)──────────────────────────────\n\nconst ASIDE_WIDTH_MIN = 240\nconst ASIDE_WIDTH_MAX = 640\nconst ASIDE_WIDTH_DEFAULT = 320\n\nfunction resolveAsideWidth(width: AppShellAsideProps['width'], isXl: boolean): number {\n  if (typeof width === 'number') {\n    return Math.max(ASIDE_WIDTH_MIN, Math.min(ASIDE_WIDTH_MAX, width))\n  }\n  if (width && typeof width === 'object') {\n    // breakpoint-keyed:xl viewport(≥1280px)用 xl,否則 md\n    const v = (isXl ? width.xl ?? width.md : width.md) ?? ASIDE_WIDTH_DEFAULT\n    return Math.max(ASIDE_WIDTH_MIN, Math.min(ASIDE_WIDTH_MAX, v))\n  }\n  return ASIDE_WIDTH_DEFAULT\n}\n\n// ── Skip-to-main link(a11y WCAG 2.4.1)───────────────────────────────────────\n\nfunction SkipToMain() {\n  return (\n    <a\n      href=\"#app-shell-main\"\n      className={cn(\n        'sr-only focus:not-sr-only',\n        'focus:fixed focus:top-2 focus:left-2 focus:z-50',\n        'focus:px-3 focus:py-2 focus:rounded-md',\n        'focus:bg-surface focus:text-foreground focus:shadow-[var(--elevation-200)]',\n        'focus:outline-none focus:ring-2 focus:ring-primary'\n      )}\n    >\n      Skip to main content\n    </a>\n  )\n}\n\n// ── AppShell root ────────────────────────────────────────────────────────────\n\nconst AppShell = React.forwardRef<HTMLDivElement, AppShellProps>(\n  (\n    {\n      layout = 'primary-sidebar',\n      sidebar,\n      header,\n      globalHeader,\n      aside,\n      asideOpen: asideOpenProp,\n      onAsideOpenChange,\n      children,\n      className,\n      ...props\n    },\n    ref\n  ) => {\n    const [asideOpenInternal, setAsideOpenInternal] = React.useState(false)\n    const isControlled = asideOpenProp !== undefined\n    const asideOpen = isControlled ? asideOpenProp : asideOpenInternal\n\n    const setAsideOpen = React.useCallback(\n      (open: boolean) => {\n        if (!isControlled) setAsideOpenInternal(open)\n        onAsideOpenChange?.(open)\n      },\n      [isControlled, onAsideOpenChange]\n    )\n\n    const isMobile = useIsNarrowViewport()\n\n    // ── Keyboard: cmd+. toggle aside ──\n    // ⌘B sidebar toggle by Sidebar SSOT(本 component 不重覆 register)\n    React.useEffect(() => {\n      const onKey = (e: KeyboardEvent) => {\n        if (e.key === '.' && (e.metaKey || e.ctrlKey)) {\n          e.preventDefault()\n          setAsideOpen(!asideOpen)\n        }\n      }\n      window.addEventListener('keydown', onKey)\n      return () => window.removeEventListener('keydown', onKey)\n    }, [asideOpen, setAsideOpen])\n\n    const ctxValue = React.useMemo<AppShellContextValue>(\n      () => ({ layout, asideOpen, setAsideOpen, isMobile }),\n      [layout, asideOpen, setAsideOpen, isMobile]\n    )\n\n    // ── Layout grid(2 mode)──\n    // primary-sidebar:\n    //   row1: [sidebar (頂天)][main col (header + main)][aside (頂天)]\n    // primary-header:\n    //   row1: [header (橫跨整 viewport, banner role)]\n    //   row2: [sidebar][main][aside]\n\n    // AppShellAside 自決 inline vs modal mode(via AppShellContext.isMobile)。\n    // AppShell 一律只 render `{aside}` 一次,AppShellAside 內部根據 isMobile 決定 render 形式。\n\n    if (layout === 'primary-header') {\n      // primary-header layout(2026-05-21 v2 — user clarification「primary-header = primary-sidebar + 一條 global header」):\n      // 結構:row1 globalHeader(全寬 global bar)/ row2 [sidebar][main col: localHeader + main][aside]\n      // - globalHeader = 跨頁 account / workspace switcher / notifications(對齊 GitHub top nav / Slack workspace bar)\n      // - header = local page header,**仍存在**(per page actions / breadcrumb,對齊 GitHub repo header / Slack channel header / Gmail email-list toolbar 2-layer 慣例)\n      // Consumer 必傳 `<Sidebar viewportInsetTop=\"var(--chrome-header-height)\">` 讓 sidebar 從 globalHeader 下方起算。\n      return (\n        <AppShellContext.Provider value={ctxValue}>\n          <div\n            ref={ref}\n            className={cn('flex h-svh w-full flex-col overflow-hidden bg-canvas', className)}\n            {...props}\n          >\n            <SkipToMain />\n            {/* Row 1:Global header(account / workspace switcher / notifications,橫跨整 viewport)*/}\n            {globalHeader && <div className=\"flex-shrink-0\">{globalHeader}</div>}\n            {/* Row 2:[sidebar][main col][aside]horizontal row */}\n            <div className=\"flex flex-1 min-h-0 w-full\">\n              {sidebar}\n              {/* Main column:local header + main content(per user model「primary-header = primary-sidebar + global header」)*/}\n              <div className=\"flex flex-col flex-1 min-w-0 min-h-0 overflow-hidden\">\n                {header && <div className=\"flex-shrink-0\">{header}</div>}\n                <main\n                  id=\"app-shell-main\"\n                  tabIndex={-1}\n                  className=\"flex-1 min-w-0 min-h-0 overflow-y-auto focus:outline-none\"\n                >\n                  {children}\n                </main>\n              </div>\n              {aside}\n            </div>\n          </div>\n        </AppShellContext.Provider>\n      )\n    }\n\n    // primary-sidebar layout\n    return (\n      <AppShellContext.Provider value={ctxValue}>\n        <div\n          ref={ref}\n          className={cn('flex h-svh w-full overflow-hidden bg-canvas', className)}\n          {...props}\n        >\n          <SkipToMain />\n          {/* Sidebar — 頂天 */}\n          {sidebar}\n          {/* Main column(header + main 垂直堆)*/}\n          <div className=\"flex flex-col flex-1 min-w-0 min-h-0 overflow-hidden\">\n            {header && (\n              // Header 在 main column 內(main col sibling,非 main descendant)→ 跟 W3C ARIA in HTML\n              // banner rule 對照:`<header>` 在 main descendant 才不是 banner,本 ChromeHeader 是 <div>\n              // 所以本來就不會被 banner role 計算。仍包 wrap div not <header> 確保不無意觸發 banner。\n              <div className=\"flex-shrink-0\">{header}</div>\n            )}\n            <main\n              id=\"app-shell-main\"\n              tabIndex={-1}\n              className=\"flex-1 min-h-0 overflow-y-auto focus:outline-none\"\n            >\n              {children}\n            </main>\n          </div>\n          {/* Aside slot — desktop inline OR mobile Sheet,內部自決 */}\n          {aside}\n        </div>\n      </AppShellContext.Provider>\n    )\n  }\n)\nAppShell.displayName = 'AppShell'\n\n// ── AppShellAside sub-component ──────────────────────────────────────────────\n\n/**\n * AppShellAside — right panel:standard inline(desktop) vs modal overlay(mobile)。\n *\n * Desktop(viewport ≥ 768px):\n *   - Render 直接放 layout grid 右側(asideOpen=true 才 mount,close hide via parent)\n *   - 不蓋 mask / background 可操作 / 佔 layout 寬\n *   - Vertical extent:primary-sidebar → 頂天立地 / primary-header → header 下方\n *\n * Mobile(viewport < 768px):\n *   - Render 走 Sheet primitive(side=\"right\",per sheet.spec.md)\n *   - Mask 蓋 / background 不可操作 / 不佔 layout 寬\n *   - title 強制(aria-labelledby per sheet.spec.md:98)\n */\nconst AppShellAside = React.forwardRef<HTMLElement, AppShellAsideProps>(\n  ({ title, width, children, className }, ref) => {\n    const { asideOpen, setAsideOpen, isMobile } = useAppShell()\n    const isXl = useIsXl()\n    const resolvedWidth = resolveAsideWidth(width, isXl)\n\n    // Shared frame:always-on header(title + close X)+ body(ScrollArea + layoutSpace 規則 1B 父層 padding)\n    // 對齊 codex Layer B 2026-05-20「container mode 可變,panel role/content 不該變」+ Notion/Figma right\n    // panel 共識(modal vs inline 結構相同,host wrapper 不同)。\n    // 2026-05-20 migrate 消費 ChromeHeader primitive(撤回自刻 + 撤回 bg-surface 疊加 — 對齊\n    // `header-canonical.spec.md`「6. Background ownership」段「Nested chrome header 透明繼承\n    // parent」:aside container 自身已 bg-surface,內 header 不該再畫 bg 避免疊加 drift)。\n    const frame = (\n      <>\n        <ChromeHeader>\n          <h2 className=\"text-body-lg font-medium flex-1 truncate\">{title}</h2>\n          <Button\n            iconOnly\n            dismiss\n            size=\"sm\"\n            startIcon={XIcon}\n            aria-label=\"關閉\"\n            onClick={() => setAsideOpen(false)}\n          />\n        </ChromeHeader>\n        <ScrollArea className=\"flex-1 min-h-0\">\n          {children}\n        </ScrollArea>\n      </>\n    )\n\n    // Modal mode(mobile)— Sheet from right\n    if (isMobile) {\n      return (\n        <Sheet open={asideOpen} onOpenChange={setAsideOpen}>\n          <SheetContent\n            side=\"right\"\n            className=\"w-[min(90vw,var(--app-shell-aside-modal-width))] flex flex-col p-0 [&>button]:hidden\"\n            style={{ ['--app-shell-aside-modal-width' as string]: `${resolvedWidth}px` }}\n          >\n            {frame}\n          </SheetContent>\n        </Sheet>\n      )\n    }\n\n    // Standard inline mode(desktop)\n    if (!asideOpen) return null\n\n    return (\n      <aside\n        ref={ref}\n        aria-label={title}\n        className={cn(\n          'flex flex-col h-full min-h-0 overflow-hidden',\n          'bg-surface border-l border-divider',\n          className\n        )}\n        style={{ width: resolvedWidth }}\n      >\n        {frame}\n      </aside>\n    )\n  }\n)\nAppShellAside.displayName = 'AppShellAside'\n\n// ── Exports ──────────────────────────────────────────────────────────────────\n\n// code-quality-allow: dead-export useAppShell — public compound API hook(consumer 可自拼 custom aside layout,\n// 對齊 Radix `useDialogContext` / MUI `useFormControl` 慣例)。內部 AppShellAside 已消費(L294),\n// audit script 抓「無 cross-file import」是 false positive(2026-05-21 D2 codify)。\nexport { AppShell, AppShellAside, useAppShell }\n"],"names":["XIcon"],"mappings":"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"}

package/dist/components/AppShell/index.d.ts

@@ -0,0 +1,2 @@
+export * from './app-shell';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/AppShell/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/AppShell/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAA"}

package/dist/components/AppShell/index.js

@@ -0,0 +1,7 @@
+import { AppShell, AppShellAside, useAppShell } from "./app-shell.js";
+export {
+  AppShell,
+  AppShellAside,
+  useAppShell
+};
+//# sourceMappingURL=index.js.map

package/dist/components/AppShell/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/AspectRatio/aspect-ratio.d.ts

@@ -0,0 +1,40 @@
+import * as React from 'react';
+import * as AspectRatioPrimitive from '@radix-ui/react-aspect-ratio';
+/**
+ * AspectRatio — 固定長寬比容器(Radix AspectRatio primitive 薄包裝)
+ *
+ * 世界級對照:shadcn `AspectRatio` / Ant 無獨立元件(CSS 方案)/ Material 無
+ *
+ * ── 為什麼需要 ──
+ * CSS `aspect-ratio` 屬性雖然現代瀏覽器都支援,但 Radix primitive 提供 SSR-safe
+ * padding-bottom 方案 + consistent API,避免邊緣 bug(image 未載入時容器坍塌 /
+ * content-fit 差異)。保 safe + 一致視覺。
+ *
+ * ── 標準 ratio(DS 慣例) ──
+ * 16/9  — 寬螢幕影片、onboarding feature tour 截圖(Coachmark media 預設)
+ * 4/3   — 老電視 / 照片基本 ratio、產品 thumbnail
+ * 1/1   — Avatar / 方形貼文預覽 / icon preview
+ * 3/4   — 直式照片(人物 portrait)
+ * 21/9  — Ultra-wide banner(hero section)
+ *
+ * Consumer 傳 `ratio={n/m}` 數字計算(如 16/9 = 1.7777)。
+ *
+ * ── 常見消費者 ──
+ * Coachmark media / Carousel item image / Card thumbnail(未來)/ Chart preview
+ */
+export type AspectRatioProps = React.ComponentPropsWithoutRef<typeof AspectRatioPrimitive.Root>;
+declare const AspectRatio: React.ForwardRefExoticComponent<Omit<AspectRatioPrimitive.AspectRatioProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const aspectRatioMeta: {
+    readonly component: "AspectRatio";
+    readonly family: null;
+    readonly variants: {};
+    readonly sizes: {};
+    readonly states: readonly ["default", "hover", "active", "focus-visible", "disabled"];
+    readonly tokens: {
+        readonly bg: readonly [];
+        readonly fg: readonly [];
+        readonly ring: readonly [];
+    };
+};
+export { AspectRatio };
+//# sourceMappingURL=aspect-ratio.d.ts.map

package/dist/components/AspectRatio/aspect-ratio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aspect-ratio.d.ts","sourceRoot":"","sources":["../../../src/components/AspectRatio/aspect-ratio.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,oBAAoB,MAAM,8BAA8B,CAAA;AAEpE;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,wBAAwB,CAAC,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAA;AAK/F,QAAA,MAAM,WAAW,iKAGoD,CAAA;AAKrE,eAAO,MAAM,eAAe;;;;;;;;;;;CAelB,CAAA;AAEV,OAAO,EAAE,WAAW,EAAE,CAAA"}