@qijenchen/design-system 0.1.0-beta.13 → 0.1.0-beta.131

package/dist/components/AgentPanel/agent-panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-panel.js","sources":["../../../src/components/AgentPanel/agent-panel.tsx"],"sourcesContent":["// code-quality-allow: file-size foundational composite family(9 元件一家族檔,同 Sidebar 前例)\n/**\n * AgentPanel 家族 — 智慧代理面板(9 元件;附屬資產 AgentLogo/AgentFab 另檔)。\n *\n * ── 消費的 SSOT ──\n * - 容器:右側欄=bg-surface + border-l border-divider(app-shell aside 前例);\n *   寬 --agent-panel-width(uiSize.css;可拖拉 360–640 且 ≤50vw,把手=ResizeHandle pattern,\n *   鍵盤等價=WAI-ARIA separator 同 DataTable 欄寬慣例);開合 --motion-duration-surface。\n * - 標題列:ChromeHeader(header-canonical;chrome 內控件一律 sm);品牌區=gap-2+24 標誌;\n *   標題+chevron=單一複合觸發鈕(Button text sm + endIcon,Polaris disclosure / Combobox 觸發器同構),\n *   chevron=裝飾性指示(inline-action.spec.md Q1);ButtonDivider 於 gap-2 cluster(action-bar 規則 3)。\n *   **固定構件恆渲染**:+ / × / 標題觸發鈕不隨 callback 有無消失(2026-09-02 根因修正)。\n * - 歷史浮層:Popover+Command+MenuItem,列組裝逐字照 select-menu.tsx 原型(外層 CommandItem 單一\n *   互動 owner、內層 MenuItem role=presentation 透明、群組 heading、CommandSeparator、Empty);\n *   行內動作=ItemSuffix hoverReveal + ItemInlineAction(懸停/鍵盤 focus-visible 浮出);思考列=CircularProgress 16。\n * - 訊息:氣泡 bg-secondary/rounded-md/8/12;附件=Chip assist 分支(chip.spec.md),相互 4;\n *   輪距 40=8+24(Button text xs)+8。\n * - 思考塊:Radix Collapsible+animate-accordion(base.css;Sidebar 同法);chevron=accordion 慣例\n *   (裝飾指示、色同 Select 觸發器 chevron);微光僅標題+最新行(agent-panel.css);完成步驟 fg-secondary。\n * - 輸入盒:欄位家族內距(--field-control-py-md/--field-px/text-body;32 等高鐵律);\n *   附件列=Tag md 單列 + OverflowIndicator(+N,useOverflowIndices 量測);送出/停止=Button primary xs。\n * - 決策卡:SurfaceHeader(compact)+SurfaceFooter(overlay-surface);選項=灰底卡(--secondary、\n *   rounded-md、內距 8/12、整卡可點)包 RadioGroup md(Popover all-sm 律之拍板豁免;footer 鈕 sm 守律);\n *   一題一問步進(Skip / 下一題 / 送出);N>1 才顯示「n / N」小標;淡入+下滑 --motion-duration-overlay。\n * - 改名/刪除:Dialog(header md+X;body Field+Input;footer md 鈕;刪除=primary+danger;\n *   form-validation:儲存 dirty 規則、空名 blur 顯錯;Esc=Dialog 取消)。\n * - 空狀態:Empty icon slot 接 AgentLogo 招喚態。\n * 全表:agent-panel.spec.md。\n */\nimport * as React from 'react'\nimport * as CollapsiblePrimitive from '@radix-ui/react-collapsible'\nimport {\n  createLucideIcon,\n  ArrowUp,\n  ChevronDown,\n  Copy,\n  MessageSquare,\n  Pencil,\n  Plus,\n  ThumbsDown,\n  ThumbsUp,\n  Trash2,\n  X as XIcon,\n} from 'lucide-react'\nimport { cn } from '@/lib/utils'\n\n/**\n * 停止實心正方:12/24 grid(= Material Symbols `stop` 480/960)→ 8px @ Button icon 16。\n * lucide Square 填滿後 20/24 = 13.3px,比 ArrowUp/Plus(14/24 線稿)視覺偏重,故自繪\n * (2026-09-02 user 抓「太巨大」;rx 1.5 ≈ Carbon 2/20、lucide 2/18 圓角比例)。\n */\nconst StopFilled = createLucideIcon('StopFilled', [\n  ['rect', { x: '6', y: '6', width: '12', height: '12', rx: '1.5', fill: 'currentColor', stroke: 'none', key: 'stop' }],\n])\nimport { Button } from '@/design-system/components/Button/button'\nimport { ButtonDivider } from '@/design-system/components/Button/button-group'\nimport { ChromeHeader } from '@/design-system/patterns/header-canonical/chrome-header'\nimport {\n  SurfaceHeader,\n  SurfaceFooter,\n  COMPACT_HEADER_SLOT,\n} from '@/design-system/patterns/overlay-surface/overlay-surface'\nimport {\n  Popover,\n  PopoverTrigger,\n  PopoverContent,\n} from '@/design-system/components/Popover/popover'\nimport {\n  Command,\n  CommandEmpty,\n  CommandGroup,\n  CommandInput,\n  CommandItem,\n  CommandList,\n  CommandSeparator,\n} from '@/design-system/components/Command/command'\nimport { MenuItem } from '@/design-system/components/Menu/menu-item'\nimport {\n  ItemInlineAction,\n  ItemSuffix,\n} from '@/design-system/patterns/element-anatomy/item-anatomy'\nimport { ResizeHandle } from '@/design-system/patterns/resize-handle/resize-handle'\nimport { useOverflowIndices } from '@/design-system/patterns/horizontal-overflow/horizontal-overflow'\nimport { OverflowIndicator } from '@/design-system/components/OverflowIndicator/overflow-indicator'\nimport { CircularProgress } from '@/design-system/components/CircularProgress/circular-progress'\nimport { RadioGroup, RadioGroupItem } from '@/design-system/components/RadioGroup/radio-group'\nimport { Checkbox } from '@/design-system/components/Checkbox/checkbox'\nimport { CheckboxGroup } from '@/design-system/components/Checkbox/checkbox-group'\nimport { Chip } from '@/design-system/components/Chip/chip'\nimport { Tag } from '@/design-system/components/Tag/tag'\nimport { Input } from '@/design-system/components/Input/input'\nimport { Empty } from '@/design-system/components/Empty/empty'\nimport { Field, FieldLabel, FieldError } from '@/design-system/components/Field/field'\nimport {\n  Dialog,\n  DialogBody,\n  DialogContent,\n  DialogFooter,\n  DialogHeader,\n  DialogTitle,\n} from '@/design-system/components/Dialog/dialog'\nimport { ScrollArea } from '@/design-system/components/ScrollArea/scroll-area'\nimport { AgentLogo, type AgentLogoState } from './agent-logo'\nimport './agent-panel.css'\n\n/* ────────────────────────────────────────────────────────────────────────────\n * 1. AgentPanel(容器;可拖拉寬度)\n * ──────────────────────────────────────────────────────────────────────── */\n\n/** 拖拉寬度界限(spec「AgentPanel」節;token 鏡像:--agent-panel-width-min / -max)。 */\nconst PANEL_WIDTH_DEFAULT = 400\nconst PANEL_WIDTH_MIN = 360\nconst PANEL_WIDTH_MAX = 640\nconst PANEL_RESIZE_KEY_STEP = 16\n\nfunction clampPanelWidth(width: number) {\n  const viewportCap = typeof window === 'undefined' ? PANEL_WIDTH_MAX : Math.floor(window.innerWidth / 2)\n  return Math.min(Math.max(width, PANEL_WIDTH_MIN), Math.min(PANEL_WIDTH_MAX, Math.max(viewportCap, PANEL_WIDTH_MIN)))\n}\n\nexport interface AgentPanelProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** 面板開合;false 時不渲染(關閉後由 AgentFab 承接入口,兩者互斥)。 */\n  open?: boolean\n  /** 受控寬度(px);省略=非受控,起於 defaultWidth。 */\n  width?: number\n  /** 非受控初始寬;預設 --agent-panel-width 400。 */\n  defaultWidth?: number\n  /** 拖拉/鍵盤調整結束時回報(DS 不持久化,產品自存)。 */\n  onWidthChange?: (width: number) => void\n  /** 可拖拉(左緣把手);預設 true。Sheet 承載時同樣可拖。 */\n  resizable?: boolean\n}\n\nconst AgentPanel = React.forwardRef<HTMLDivElement, AgentPanelProps>(\n  (\n    {\n      open = true,\n      width,\n      defaultWidth = PANEL_WIDTH_DEFAULT,\n      onWidthChange,\n      resizable = true,\n      className,\n      style,\n      children,\n      ...props\n    },\n    ref,\n  ) => {\n    const [uncontrolledWidth, setUncontrolledWidth] = React.useState(() => clampPanelWidth(defaultWidth))\n    const resolvedWidth = clampPanelWidth(width ?? uncontrolledWidth)\n    const dragRef = React.useRef<{ startX: number; startWidth: number } | null>(null)\n    const [dragging, setDragging] = React.useState(false)\n\n    const applyWidth = React.useCallback(\n      (next: number, commit: boolean) => {\n        const clamped = clampPanelWidth(next)\n        if (width === undefined) setUncontrolledWidth(clamped)\n        if (commit) onWidthChange?.(clamped)\n      },\n      [width, onWidthChange],\n    )\n\n    const onHandlePointerDown = (e: React.PointerEvent<HTMLSpanElement>) => {\n      e.preventDefault()\n      dragRef.current = { startX: e.clientX, startWidth: resolvedWidth }\n      setDragging(true)\n      const onMove = (ev: PointerEvent) => {\n        const drag = dragRef.current\n        if (!drag) return\n        // 把手在左緣:往左拖=變寬。\n        applyWidth(drag.startWidth + (drag.startX - ev.clientX), false)\n      }\n      const onUp = (ev: PointerEvent) => {\n        const drag = dragRef.current\n        dragRef.current = null\n        setDragging(false)\n        window.removeEventListener('pointermove', onMove)\n        window.removeEventListener('pointerup', onUp)\n        if (drag) applyWidth(drag.startWidth + (drag.startX - ev.clientX), true)\n      }\n      window.addEventListener('pointermove', onMove)\n      window.addEventListener('pointerup', onUp)\n    }\n\n    if (!open) return null\n    return (\n      <div\n        ref={ref}\n        role=\"complementary\"\n        aria-label=\"智慧代理\" // i18n-allow: DS 預設,props 展開在後可覆寫\n        className={cn(\n          'relative flex h-full min-h-0 shrink-0 flex-col overflow-hidden',\n          'border-l border-divider bg-surface',\n          'animate-in fade-in-0 slide-in-from-right-4 duration-[var(--motion-duration-surface)] motion-reduce:animate-none',\n          className,\n        )}\n        style={{ width: resolvedWidth, ...style }}\n        {...props}\n      >\n        {resizable && (\n          // 視覺/滑鼠=ResizeHandle(固定 aria-hidden);鍵盤等價=WAI-ARIA window-splitter(DataTable 欄寬同慣例)。\n          <span\n            role=\"separator\"\n            aria-orientation=\"vertical\"\n            aria-label=\"調整面板寬度\" // i18n-allow: DS 預設文案\n            aria-valuenow={resolvedWidth}\n            aria-valuemin={PANEL_WIDTH_MIN}\n            aria-valuemax={PANEL_WIDTH_MAX}\n            aria-valuetext={`${resolvedWidth}px`}\n            tabIndex={0}\n            onKeyDown={(e) => {\n              let next: number | null = null\n              if (e.key === 'ArrowLeft') next = resolvedWidth + PANEL_RESIZE_KEY_STEP\n              else if (e.key === 'ArrowRight') next = resolvedWidth - PANEL_RESIZE_KEY_STEP\n              else if (e.key === 'Home') next = PANEL_WIDTH_MIN\n              else if (e.key === 'End') next = PANEL_WIDTH_MAX\n              if (next == null) return\n              e.preventDefault()\n              applyWidth(next, true)\n            }}\n            className=\"absolute inset-y-0 left-0 z-10 w-0 focus-visible:outline-none\"\n          >\n            <ResizeHandle\n              direction=\"horizontal\"\n              position=\"start\"\n              isResizing={dragging}\n              onPointerDown={onHandlePointerDown}\n            />\n          </span>\n        )}\n        {children}\n      </div>\n    )\n  },\n)\nAgentPanel.displayName = 'AgentPanel'\n\n/* ────────────────────────────────────────────────────────────────────────────\n * 2. AgentPanelHeader(標題列)+ 歷史浮層 / 改名 / 刪除\n * ──────────────────────────────────────────────────────────────────────── */\n\nexport interface AgentConversationSummary {\n  id: string\n  title: string\n  /** 分組標題(如「今天」「過去 7 天」);同組相鄰排列。 */\n  group?: string\n  /** 代理仍在回覆:列首圖示原地換 CircularProgress 16,等寬等高不動版面。 */\n  thinking?: boolean\n}\n\nexport interface AgentPanelHeaderProps\n  extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {\n  /** 目前對話標題(標題本身=歷史浮層觸發鈕)。 */\n  title: string\n  /** 歷史浮層搜尋 placeholder(i18n override)。 */\n  historySearchPlaceholder?: string\n  /** 歷史浮層無結果文案(i18n override)。 */\n  historyEmptyText?: string\n  /** 標誌狀態(代理思考中傳 \"think\")。 */\n  logoState?: AgentLogoState\n  /** 歷史對話清單;空清單=浮層顯示無結果(觸發鈕恆在)。 */\n  conversations?: AgentConversationSummary[]\n  /** 目前對話 id(歷史清單高亮)。 */\n  activeConversationId?: string\n  /** 目前對話尚無已送出訊息=本身就是新對話 → 「+ 新對話」停用。 */\n  conversationEmpty?: boolean\n  /** 歷史浮層初始開啟(展示/快照用;M15 OpenSnapshot)。 */\n  defaultHistoryOpen?: boolean\n  onSelectConversation?: (id: string) => void\n  /** 改名確認(Dialog 流程由元件內建)。 */\n  onRenameConversation?: (id: string, title: string) => void\n  /**\n   * 刪除確認(Dialog 流程由元件內建)。consumer 契約:刪的是目前對話 → 切到最近一則;\n   * 全部刪光 → 面板回空狀態(spec「附:歷史浮層」)。\n   */\n  onDeleteConversation?: (id: string) => void\n  /** 固定構件:+ 恆渲染,主流程無內建行為 → 必填。 */\n  onNewConversation: () => void\n  /** 固定構件:× 恆渲染,面板 open 是 consumer state → 必填。 */\n  onClose: () => void\n}\n\n/** 歷史列(select-menu.tsx 原型):外層 CommandItem 單一互動 owner;內層 MenuItem 純視覺。 */\nfunction HistoryRow({\n  conversation,\n  selected,\n  onSelect,\n  onRename,\n  onDelete,\n}: {\n  conversation: AgentConversationSummary\n  selected: boolean\n  onSelect: () => void\n  onRename: () => void\n  onDelete: () => void\n}) {\n  return (\n    <CommandItem\n      value={conversation.id}\n      keywords={[conversation.title]}\n      onSelect={onSelect}\n      className={cn(\n        'group/menu-item p-0 rounded-none',\n        // 選中 × 鍵盤游標疊加(select-menu.tsx 2026-08-11 拍板:滑鼠釘住、鍵盤反白深一階)。\n        selected && 'bg-neutral-selected data-[selected=true]:bg-neutral-selected data-[selected=true]:not-hover:bg-neutral-selected-focus',\n      )}\n    >\n      <MenuItem\n        role=\"presentation\"\n        selected={selected}\n        className=\"!bg-transparent hover:!bg-transparent\"\n        startContent={\n          conversation.thinking ? (\n            <CircularProgress size={16} aria-label=\"回覆中\" /> // i18n-allow: DS 預設\n          ) : (\n            <MessageSquare size={16} aria-hidden className=\"text-fg-muted\" />\n          )\n        }\n        endContent={\n          // 行內動作恆在 DOM(鍵盤 Tab 可達);懸停/focus-visible 淡入=ItemSuffix hoverReveal SSOT。\n          <ItemSuffix hoverReveal hoverGroup=\"menu-item\">\n            <ItemInlineAction\n              action={{\n                icon: Pencil,\n                label: '改名', // i18n-allow: DS 預設文案(Dialog「關閉」同前例)\n                onClick: (e) => {\n                  e?.stopPropagation()\n                  onRename()\n                },\n              }}\n            />\n            <ItemInlineAction\n              action={{\n                icon: Trash2,\n                label: '刪除', // i18n-allow: DS 預設文案(Dialog「關閉」同前例)\n                onClick: (e) => {\n                  e?.stopPropagation()\n                  onDelete()\n                },\n              }}\n            />\n          </ItemSuffix>\n        }\n      >\n        {conversation.title}\n      </MenuItem>\n    </CommandItem>\n  )\n}\n\nconst AgentPanelHeader = React.forwardRef<HTMLElement, AgentPanelHeaderProps>(\n  (\n    {\n      title,\n      logoState = 'still',\n      historySearchPlaceholder = '搜尋對話', // i18n-allow: DS 預設文案,prop 可覆寫\n      historyEmptyText = '沒有符合的對話', // i18n-allow: DS 預設文案,prop 可覆寫\n      conversations = [],\n      activeConversationId,\n      conversationEmpty = false,\n      defaultHistoryOpen = false,\n      onSelectConversation,\n      onRenameConversation,\n      onDeleteConversation,\n      onNewConversation,\n      onClose,\n      className,\n      ...props\n    },\n    ref,\n  ) => {\n    const [historyOpen, setHistoryOpen] = React.useState(defaultHistoryOpen)\n    const [renameTarget, setRenameTarget] = React.useState<AgentConversationSummary | null>(null)\n    const [deleteTarget, setDeleteTarget] = React.useState<AgentConversationSummary | null>(null)\n    const triggerRef = React.useRef<HTMLButtonElement>(null)\n    /** Dialog 關閉後焦點回歷史觸發鈕(Popover 已因焦點外移關閉;WCAG 2.4.3)。 */\n    const returnFocus = () => triggerRef.current?.focus({ preventScroll: true })\n\n    const groups = React.useMemo(() => {\n      const order: string[] = []\n      const byGroup = new Map<string, AgentConversationSummary[]>()\n      for (const item of conversations) {\n        const key = item.group ?? ''\n        if (!byGroup.has(key)) {\n          byGroup.set(key, [])\n          order.push(key)\n        }\n        byGroup.get(key)!.push(item)\n      }\n      return order.map((key) => ({ label: key, items: byGroup.get(key)! }))\n    }, [conversations])\n\n    return (\n      <ChromeHeader ref={ref} className={cn('bg-surface', className)} {...props}>\n        <div className=\"flex min-w-0 flex-1 items-center gap-2\">\n          <AgentLogo state={logoState} size={24} />\n          <Popover open={historyOpen} onOpenChange={setHistoryOpen}>\n            <PopoverTrigger asChild>\n              {/* 標題+chevron=單一複合觸發鈕;chevron 裝飾指示(aria-hidden 由 Button endIcon 處理)。 */}\n              <Button\n                ref={triggerRef}\n                variant=\"text\"\n                size=\"sm\"\n                endIcon={ChevronDown}\n                aria-haspopup=\"dialog\"\n                aria-expanded={historyOpen}\n                className=\"min-w-0 max-w-full px-1 text-body-lg font-medium\"\n              >\n                <span className=\"truncate\">{title}</span>\n              </Button>\n            </PopoverTrigger>\n            <PopoverContent\n              align=\"start\"\n              aria-label=\"歷史對話\" // i18n-allow: DS 預設文案\n              className=\"w-auto min-w-60 overflow-hidden p-0\"\n            >\n              <Command label=\"歷史對話\" className=\"[&_[cmdk-input-wrapper]]:py-1\">\n                {/* 搜尋列 40 = 32 + 8(select-menu.tsx 搜尋列同高)。 */}\n                <CommandInput\n                  placeholder={historySearchPlaceholder}\n                  aria-label={historySearchPlaceholder}\n                  className=\"h-8 py-0\"\n                />\n                <CommandList aria-label=\"對話\">\n                  <CommandEmpty className=\"flex items-center justify-center\">\n                    <Empty description={historyEmptyText} className=\"py-6\" />\n                  </CommandEmpty>\n                  {groups.map(({ label, items }, gi) => (\n                    <React.Fragment key={label || '(ungrouped)'}>\n                      {gi > 0 && <CommandSeparator />}\n                      <CommandGroup\n                        className=\"p-0 py-2 [&_[cmdk-group-heading]]:p-0\"\n                        heading={label ? <MenuItem header>{label}</MenuItem> : undefined}\n                      >\n                        {items.map((conversation) => (\n                          <HistoryRow\n                            key={conversation.id}\n                            conversation={conversation}\n                            selected={conversation.id === activeConversationId}\n                            onSelect={() => {\n                              onSelectConversation?.(conversation.id)\n                              setHistoryOpen(false)\n                            }}\n                            onRename={() => setRenameTarget(conversation)}\n                            onDelete={() => setDeleteTarget(conversation)}\n                          />\n                        ))}\n                      </CommandGroup>\n                    </React.Fragment>\n                  ))}\n                </CommandList>\n              </Command>\n            </PopoverContent>\n          </Popover>\n        </div>\n        <div className=\"flex items-center gap-2\">\n          <Button\n            variant=\"text\"\n            size=\"sm\"\n            iconOnly\n            startIcon={Plus}\n            aria-label=\"新對話\" // i18n-allow: DS 預設文案(Dialog「關閉」同前例)\n            disabled={conversationEmpty}\n            onClick={onNewConversation}\n          />\n          <ButtonDivider />\n          <Button dismiss size=\"sm\" startIcon={XIcon} aria-label=\"關閉面板\" onClick={onClose} />\n        </div>\n        {renameTarget && (\n          <AgentRenameDialog\n            conversation={renameTarget}\n            onOpenChange={(next) => {\n              if (!next) {\n                setRenameTarget(null)\n                returnFocus()\n              }\n            }}\n            onConfirm={(nextTitle) => {\n              onRenameConversation?.(renameTarget.id, nextTitle)\n              setRenameTarget(null)\n              returnFocus()\n            }}\n          />\n        )}\n        {deleteTarget && (\n          <Dialog\n            open\n            onOpenChange={(next) => {\n              if (!next) {\n                setDeleteTarget(null)\n                returnFocus()\n              }\n            }}\n          >\n            <DialogContent>\n              <DialogHeader>\n                <DialogTitle>刪除對話</DialogTitle>\n              </DialogHeader>\n              <DialogBody>\n                確定刪除「{deleteTarget.title}」?此動作立即生效且不可復原。\n              </DialogBody>\n              <DialogFooter>\n                <Button variant=\"tertiary\" onClick={() => { setDeleteTarget(null); returnFocus() }}>\n                  取消\n                </Button>\n                <Button\n                  variant=\"primary\"\n                  danger\n                  onClick={() => {\n                    onDeleteConversation?.(deleteTarget.id)\n                    setDeleteTarget(null)\n                    returnFocus()\n                  }}\n                >\n                  刪除\n                </Button>\n              </DialogFooter>\n            </DialogContent>\n          </Dialog>\n        )}\n      </ChromeHeader>\n    )\n  },\n)\nAgentPanelHeader.displayName = 'AgentPanelHeader'\n\n/** 改名 Dialog:Field+Input 預填全選;儲存=更新類 dirty 規則;空名 blur 顯錯;Esc=Dialog 取消。 */\nfunction AgentRenameDialog({\n  conversation,\n  onOpenChange,\n  onConfirm,\n}: {\n  conversation: AgentConversationSummary\n  onOpenChange: (open: boolean) => void\n  onConfirm: (title: string) => void\n}) {\n  const [value, setValue] = React.useState(conversation.title)\n  const [touched, setTouched] = React.useState(false)\n  const trimmed = value.trim()\n  const dirty = trimmed !== conversation.title\n  const empty = trimmed.length === 0\n  const showError = touched && empty\n  const commit = () => {\n    setTouched(true)\n    if (empty || !dirty) return\n    onConfirm(trimmed)\n  }\n  return (\n    <Dialog open onOpenChange={onOpenChange}>\n      <DialogContent>\n        <DialogHeader>\n          <DialogTitle>改名對話</DialogTitle>\n        </DialogHeader>\n        <DialogBody>\n          <Field required invalid={showError}>\n            <FieldLabel>名稱</FieldLabel>\n            <Input\n              value={value}\n              error={showError}\n              onChange={(e) => setValue(e.target.value)}\n              onFocus={(e) => e.currentTarget.select()}\n              onBlur={() => setTouched(true)}\n              onKeyDown={(e) => {\n                // form-validation:Enter=等同 blur(觸發驗證並提交);Esc 由 Dialog 承接=取消。\n                if (e.key === 'Enter') {\n                  e.preventDefault()\n                  commit()\n                }\n              }}\n            />\n            {showError && <FieldError>名稱不可空白</FieldError>}\n          </Field>\n        </DialogBody>\n        <DialogFooter>\n          <Button variant=\"tertiary\" onClick={() => onOpenChange(false)}>\n            取消\n          </Button>\n          <Button variant=\"primary\" disabled={!dirty} onClick={commit}>\n            儲存\n          </Button>\n        </DialogFooter>\n      </DialogContent>\n    </Dialog>\n  )\n}\n\n/* ────────────────────────────────────────────────────────────────────────────\n * 3. AgentConversation(訊息卷軸區)\n * ──────────────────────────────────────────────────────────────────────── */\n\nexport type AgentConversationProps = React.HTMLAttributes<HTMLDivElement>\n\nconst AgentConversation = React.forwardRef<HTMLDivElement, AgentConversationProps>(\n  ({ className, children, ...props }, ref) => (\n    // 捲軸必用 ScrollArea(跨 OS 一致;Dialog body 同法)。\n    <ScrollArea fillX className=\"min-h-0 flex-1\">\n      <div\n        ref={ref}\n        role=\"log\"\n        aria-live=\"polite\"\n        className={cn(\n          // 輪距 40 = 8 + 24(工具列)+ 8;工具列絕對定位於輪距內,出現不推擠。\n          'flex flex-col gap-10 p-[var(--layout-space-loose)]',\n          className,\n        )}\n        {...props}\n      >\n        {children}\n      </div>\n    </ScrollArea>\n  ),\n)\nAgentConversation.displayName = 'AgentConversation'\n\n/* ────────────────────────────────────────────────────────────────────────────\n * 4. AgentMessage(訊息)\n * ──────────────────────────────────────────────────────────────────────── */\n\nexport interface AgentAttachment {\n  id: string\n  label: string\n}\n\nexport interface AgentMessageProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** 訊息角色:user=我方氣泡靠右;agent=無氣泡全寬。 */\n  role?: 'user' | 'agent'\n  /** 氣泡內文字上方的附件(送出後視覺=Chip assist 分支)。 */\n  attachments?: AgentAttachment[]\n  onAttachmentClick?: (attachment: AgentAttachment) => void\n  /** 訊息工具列(AgentToolbar);絕對定位於輪距內。 */\n  toolbar?: React.ReactNode\n}\n\nconst AgentMessage = React.forwardRef<HTMLDivElement, AgentMessageProps>(\n  (\n    { role = 'agent', attachments, onAttachmentClick, toolbar, className, children, ...props },\n    ref,\n  ) => {\n    const isUser = role === 'user'\n    return (\n      <div\n        ref={ref}\n        className={cn('group/agent-message relative', isUser && 'flex justify-end', className)}\n        {...props}\n      >\n        <div\n          className={cn(\n            'text-body text-foreground',\n            isUser\n              ? [\n                  'max-w-[85%] rounded-md bg-secondary px-3 py-2',\n                  'animate-in fade-in-0 slide-in-from-bottom-2 duration-[var(--motion-duration-overlay)] motion-reduce:animate-none',\n                ]\n              : 'w-full [&_a]:text-primary [&_a:hover]:text-primary-hover [&_a]:underline-offset-2 [&_a:hover]:underline',\n          )}\n        >\n          {attachments && attachments.length > 0 && (\n            // chip 相互垂直/水平 4(=Combobox 內 Tag 區間距;2026-09-02 拍板)。\n            <div className=\"mb-2 flex flex-wrap gap-1\">\n              {attachments.map((attachment) => (\n                <Chip\n                  key={attachment.id}\n                  variant=\"assist\"\n                  aria-label={`附件:${attachment.label}`}\n                  onClick={() => onAttachmentClick?.(attachment)}\n                >\n                  {attachment.label}\n                </Chip>\n              ))}\n            </div>\n          )}\n          {children}\n        </div>\n        {toolbar}\n      </div>\n    )\n  },\n)\nAgentMessage.displayName = 'AgentMessage'\n\n/* ────────────────────────────────────────────────────────────────────────────\n * 5. AgentThinking(思考塊)\n * ──────────────────────────────────────────────────────────────────────── */\n\nexport interface AgentThinkingProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {\n  /** 進行中:標題「思考中」+微光;完成:「思考過程」靜態。 */\n  thinking?: boolean\n  /** 已完成的步驟(靜態,fg-secondary)。 */\n  steps?: React.ReactNode[]\n  /** 正在寫入的最新一行(僅此行與標題套微光)。 */\n  currentStep?: React.ReactNode\n  /** 開合(未受控時:回覆中自動展開、回覆完自動收合)。 */\n  open?: boolean\n  onOpenChange?: (open: boolean) => void\n}\n\nconst AgentThinking = React.forwardRef<HTMLDivElement, AgentThinkingProps>(\n  ({ thinking = false, steps, currentStep, open, onOpenChange, className, ...props }, ref) => {\n    // 非受控:AI 回覆中自動展開、回覆完自動收合(拍板;三套元件庫一致慣例)。\n    const [uncontrolledOpen, setUncontrolledOpen] = React.useState(thinking)\n    React.useEffect(() => {\n      if (open === undefined) setUncontrolledOpen(thinking)\n    }, [thinking, open])\n    const resolvedOpen = open ?? uncontrolledOpen\n    const handleOpenChange = (next: boolean) => {\n      setUncontrolledOpen(next)\n      onOpenChange?.(next)\n    }\n    return (\n      <CollapsiblePrimitive.Root\n        ref={ref}\n        open={resolvedOpen}\n        onOpenChange={handleOpenChange}\n        className={cn('text-body', className)}\n        {...props}\n      >\n        <CollapsiblePrimitive.Trigger\n          className={cn(\n            'group/agent-thinking flex cursor-pointer items-center gap-1 text-fg-secondary hover:text-foreground',\n            'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring rounded-sm',\n          )}\n        >\n          <span className={cn(thinking && 'agent-shimmer')}>\n            {thinking ? '思考中…' : '思考過程'}\n          </span>\n          {/* chevron=裝飾指示(accordion 慣例),不吃微光;色同 Select 觸發器 chevron(fg-muted)。 */}\n          <ChevronDown\n            size={16}\n            aria-hidden\n            className=\"shrink-0 text-fg-muted transition-transform duration-[var(--motion-duration-overlay)] motion-reduce:duration-0 group-data-[state=open]/agent-thinking:rotate-180\"\n          />\n        </CollapsiblePrimitive.Trigger>\n        <CollapsiblePrimitive.Content\n          className=\"overflow-hidden data-[state=open]:animate-accordion-down data-[state=closed]:animate-accordion-up\"\n        >\n          {/* 完成步驟=fg-secondary(2026-09-02 拍板;原 muted 太淺);微光行基色由 agent-panel.css 自管。 */}\n          <div className=\"mt-2 flex flex-col gap-1 border-l border-divider pl-3 text-fg-secondary\">\n            {steps?.map((step, index) => <div key={index}>{step}</div>)}\n            {currentStep != null && (\n              <div className={cn(thinking && 'agent-shimmer')}>{currentStep}</div>\n            )}\n          </div>\n        </CollapsiblePrimitive.Content>\n      </CollapsiblePrimitive.Root>\n    )\n  },\n)\nAgentThinking.displayName = 'AgentThinking'\n\n/* ────────────────────────────────────────────────────────────────────────────\n * 6. AgentToolbar(訊息工具列;固定 anatomy 恆渲染)\n * ──────────────────────────────────────────────────────────────────────── */\n\nexport interface AgentToolbarProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** 常駐顯示(代理最後一則);其他訊息=懸停淡入。 */\n  pinned?: boolean\n  onCopy?: () => void\n  onLike?: () => void\n  onDislike?: () => void\n}\n\nconst AgentToolbar = React.forwardRef<HTMLDivElement, AgentToolbarProps>(\n  ({ pinned = false, onCopy, onLike, onDislike, className, children, ...props }, ref) => (\n    <div\n      ref={ref}\n      className={cn(\n        'absolute left-0 top-full mt-2 flex items-center gap-2',\n        'transition-opacity duration-[var(--motion-duration-overlay)] motion-reduce:transition-none',\n        pinned\n          ? 'opacity-100'\n          : 'opacity-0 group-hover/agent-message:opacity-100 focus-within:opacity-100',\n        className,\n      )}\n      {...props}\n    >\n      <Button variant=\"text\" size=\"xs\" iconOnly startIcon={Copy} aria-label=\"複製\" onClick={() => onCopy?.()} />\n      <ButtonDivider />\n      <Button variant=\"text\" size=\"xs\" iconOnly startIcon={ThumbsUp} aria-label=\"讚\" onClick={() => onLike?.()} />\n      <Button variant=\"text\" size=\"xs\" iconOnly startIcon={ThumbsDown} aria-label=\"倒讚\" onClick={() => onDislike?.()} />\n      {children}\n    </div>\n  ),\n)\nAgentToolbar.displayName = 'AgentToolbar'\n\n/* ────────────────────────────────────────────────────────────────────────────\n * 7. AgentPromptInput(複合輸入盒;固定 anatomy 恆渲染)\n * ──────────────────────────────────────────────────────────────────────── */\n\nexport interface AgentPromptAttachment {\n  id: string\n  label: string\n}\n\nexport interface AgentPromptInputProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onSubmit'> {\n  value: string\n  onValueChange: (value: string) => void\n  /** 送出(Enter / 送出鈕);無內建行為 → 必填。 */\n  onSubmit: () => void\n  /** 代理進行中:送出鈕同位換停止(實心正方),0.15s 淡切。 */\n  busy?: boolean\n  onStop?: () => void\n  /** 輸入中附件(Tag md 恆帶 ×;超寬 +N;送出後於訊息內轉 Chip assist 視覺)。 */\n  attachments?: AgentPromptAttachment[]\n  /** 固定構件:每個 Tag 的 × 恆渲染 → 必填。 */\n  onRemoveAttachment: (attachment: AgentPromptAttachment) => void\n  /** 固定構件:工具列 + 恆渲染 → 必填。 */\n  onAddAttachment: () => void\n  placeholder?: string\n}\n\n/** 附件單列 + 超寬 +N(useOverflowIndices 量測;Combobox 多選 Tag 區同族)。 */\nfunction PromptAttachmentRow({\n  attachments,\n  onRemove,\n}: {\n  attachments: AgentPromptAttachment[]\n  onRemove: (attachment: AgentPromptAttachment) => void\n}) {\n  const { containerRef, registerItem, overflowIndices } = useOverflowIndices<HTMLDivElement>({\n    reserveTriggerWidth: 48,\n  })\n  const hidden = new Set(overflowIndices)\n  const hiddenItems = attachments.filter((_, i) => hidden.has(i))\n  return (\n    // 附件列 28:Tag 相互間距 4、距內緣 4;單列不換行,溢出以 +N 收納。\n    // 被藏的 Tag 留在 flow 內、排到 +N 之後(order-last)並隱形:useOverflowIndices 每次重量都拿得到\n    // 真實位置(抽離 flow 會在放寬時被誤判「可見」而失去 +N,2026-09-02 實測)。\n    <div ref={containerRef} className=\"flex items-center gap-1 overflow-hidden px-1 pt-1\">\n      {attachments.map((attachment, index) => (\n        <div\n          key={attachment.id}\n          ref={registerItem(index)}\n          className={cn('shrink-0', hidden.has(index) && 'invisible order-last')}\n        >\n          <Tag size=\"md\" onRemove={() => onRemove(attachment)}>\n            {attachment.label}\n          </Tag>\n        </div>\n      ))}\n      {hiddenItems.length > 0 && (\n        <OverflowIndicator count={hiddenItems.length} shape=\"tag\" size=\"md\">\n          {hiddenItems.map((attachment) => (\n            <Tag key={attachment.id} size=\"md\" onRemove={() => onRemove(attachment)}>\n              {attachment.label}\n            </Tag>\n          ))}\n        </OverflowIndicator>\n      )}\n    </div>\n  )\n}\n\nconst AgentPromptInput = React.forwardRef<HTMLDivElement, AgentPromptInputProps>(\n  (\n    {\n      value,\n      onValueChange,\n      onSubmit,\n      busy = false,\n      onStop,\n      attachments = [],\n      onRemoveAttachment,\n      onAddAttachment,\n      placeholder = '輸入訊息…',\n      className,\n      ...props\n    },\n    ref,\n  ) => {\n    const canSubmit = value.trim().length > 0\n    const submit = () => {\n      if (busy || !canSubmit) return\n      onSubmit()\n    }\n    return (\n      <div\n        ref={ref}\n        className={cn(\n          'm-[var(--layout-space-loose)] mt-0 shrink-0 rounded-md border border-border bg-surface',\n          'focus-within:border-border-hover transition-colors duration-[var(--motion-duration-overlay)]',\n          className,\n        )}\n        {...props}\n      >\n        {attachments.length > 0 && (\n          <PromptAttachmentRow attachments={attachments} onRemove={onRemoveAttachment} />\n        )}\n        <textarea\n          value={value}\n          onChange={(e) => onValueChange(e.target.value)}\n          onKeyDown={(e) => {\n            // 按 Enter 送出、Shift+Enter 換行(拍板)。\n            if (e.key === 'Enter' && !e.shiftKey && !e.nativeEvent.isComposing) {\n              e.preventDefault()\n              submit()\n            }\n          }}\n          rows={1}\n          placeholder={placeholder}\n          aria-label=\"訊息\"\n          className={cn(\n            // 欄位家族內距:單行 32 等高鐵律((欄高−1lh)/2−1 + --field-px)。\n            'block w-full resize-none bg-transparent outline-none',\n            'px-[var(--field-px)] py-[var(--field-control-py-md)] text-body text-foreground',\n            'placeholder:text-fg-muted',\n            'field-sizing-content max-h-40',\n          )}\n        />\n        <div className=\"flex h-10 items-center justify-between px-2\">\n          <Button\n            variant=\"text\"\n            size=\"xs\"\n            iconOnly\n            startIcon={Plus}\n            aria-label=\"新增附件\"\n            onClick={onAddAttachment}\n          />\n          {busy ? (\n            <Button\n              variant=\"primary\"\n              size=\"xs\"\n              iconOnly\n              startIcon={StopFilled}\n              aria-label=\"停止生成\"\n              onClick={() => onStop?.()}\n              className=\"animate-in fade-in-0 duration-[var(--motion-duration-overlay)]\"\n            />\n          ) : (\n            <Button\n              variant=\"primary\"\n              size=\"xs\"\n              iconOnly\n              startIcon={ArrowUp}\n              aria-label=\"送出\"\n              disabled={!canSubmit}\n              onClick={submit}\n              className=\"animate-in fade-in-0 duration-[var(--motion-duration-overlay)]\"\n            />\n          )}\n        </div>\n      </div>\n    )\n  },\n)\nAgentPromptInput.displayName = 'AgentPromptInput'\n\n/* ────────────────────────────────────────────────────────────────────────────\n * 8. AgentDecisionCard(決策卡;一題一問步進)\n * ──────────────────────────────────────────────────────────────────────── */\n\nexport interface AgentDecisionOption {\n  value: string\n  /** 單行、≤10 字、無句尾標點、說「選了會怎樣」(產題守則 5)。 */\n  label: string\n  /** 一行差異描述:單句、無句號、同題比同一維度(產題守則 6)。 */\n  description: string\n}\n\nexport interface AgentDecisionQuestion {\n  id: string\n  /** 題目=一句完整問句、以「?」結尾、句內點名決策對象(產題守則 3)。 */\n  label: string\n  /** 2-4 具名選項(不含「其他」;「其他」由元件必備附加,產題守則 4/7)。 */\n  options: AgentDecisionOption[]\n  /** 預選推薦解;省略=第一項;元件在該項 label 後加「(建議)」(產題守則 8)。 */\n  defaultValue?: string\n  /** 不可逆/安全/法律/稱謂類題:不預選(產題守則 8 例外);複選題恆不預選。 */\n  noDefault?: boolean\n  /** 答案本質可複選才開(產題守則 10):改 CheckboxGroup、不預選、值以 `\\n` 連接。 */\n  multiSelect?: boolean\n}\n\nexport interface AgentDecisionCardProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onSubmit' | 'title'> {\n  /** ≤3 題;一題一問步進,N>1 時標題列顯示「n / N」。 */\n  questions: AgentDecisionQuestion[]\n  /** 全部作答後送出:answers[questionId] = 選項值或「其他」文字(複選以 `\\n` 連接)。 */\n  onSubmit?: (answers: Record<string, string>) => void\n  /** 跳過=採預設值繼續(Skip 鈕與 header × 同一行為);回傳目前預設/已選值。 */\n  onSkip?: (answers: Record<string, string>) => void\n}\n\nconst OTHER_VALUE = '__agent_decision_other__'\nconst OTHER_LABEL = '其他'\nconst RECOMMENDED_SUFFIX = '(建議)'\nconst MULTI_JOIN = '\\n'\n\n/** 產題守則機械層(agent-panel.spec.md §8 ⚙ 條):DEV 只警告不阻擋,內容規則靠稽核。 */\nfunction warnDecisionRules(questions: AgentDecisionQuestion[]) {\n  const warn = (msg: string) => console.warn(`[AgentDecisionCard] 產題守則:${msg}`)\n  if (questions.length === 0 || questions.length > 3) warn(`題數 1–3(收到 ${questions.length})。`)\n  for (const q of questions) {\n    if (!/[??]$/.test(q.label.trim())) warn(`題目必是完整問句、以「?」結尾(${q.id}:「${q.label}」)。`)\n    if (q.options.length < 2 || q.options.length > 4) warn(`每題 2–4 個具名選項(${q.id} 有 ${q.options.length})。`)\n    for (const o of q.options) {\n      if (/\\n/.test(o.label) || o.label.length > 10) warn(`選項標籤單行且 ≤10 字(${q.id}:「${o.label}」)。`)\n      if (/[,,;;.。!!]$/.test(o.label)) warn(`選項標籤無句尾標點(${q.id}:「${o.label}」)。`)\n      if (/\\(建議\\)|\\(建議\\)|\\(Recommended\\)/i.test(o.label)) warn(`「(建議)」由元件標,勿寫進標籤(${q.id}:「${o.label}」)。`)\n      if (!o.description?.trim()) warn(`每個具名選項必附一行差異描述(${q.id}:「${o.label}」)。`)\n      else if (/\\n/.test(o.description) || /[。.]$/.test(o.description.trim())) warn(`描述單句、無句號(${q.id}:「${o.label}」)。`)\n      if (/^(其他|other)$/i.test(o.label.trim()) || o.value === OTHER_VALUE) warn(`「其他」由元件附加,勿自列(${q.id})。`)\n    }\n    if (q.multiSelect && q.defaultValue) warn(`複選題不預選(${q.id})。`)\n    if (!q.multiSelect && !q.noDefault) {\n      const def = q.defaultValue ?? q.options[0]?.value\n      if (q.defaultValue && !q.options.some((o) => o.value === q.defaultValue)) warn(`defaultValue 必是選項之一(${q.id})。`)\n      if (def !== q.options[0]?.value) warn(`推薦解必排第一(${q.id})。`)\n    }\n  }\n}\n\nfunction initialAnswer(q: AgentDecisionQuestion) {\n  if (q.multiSelect || q.noDefault) return ''\n  return q.defaultValue ?? q.options[0]?.value ?? ''\n}\n\n/** 複選值 = 已勾選 value 集合(含 OTHER_VALUE),以 `\\n` 連接存於 answers。 */\nconst splitMulti = (v: string | undefined) => (v ? v.split(MULTI_JOIN).filter(Boolean) : [])\n\nconst AgentDecisionCard = React.forwardRef<HTMLDivElement, AgentDecisionCardProps>(\n  ({ questions, onSubmit, onSkip, className, ...props }, ref) => {\n    const titleId = React.useId()\n    const otherInputId = React.useId()\n    if (import.meta.env?.DEV) warnDecisionRules(questions)\n    const [step, setStep] = React.useState(0)\n    const [answers, setAnswers] = React.useState<Record<string, string>>(() =>\n      Object.fromEntries(questions.map((q) => [q.id, initialAnswer(q)])),\n    )\n    const [otherText, setOtherText] = React.useState<Record<string, string>>({})\n    const resolveOne = (q: AgentDecisionQuestion) => {\n      const other = (otherText[q.id] ?? '').trim()\n      if (q.multiSelect) {\n        return splitMulti(answers[q.id])\n          .map((v) => (v === OTHER_VALUE ? other : v))\n          .filter(Boolean)\n          .join(MULTI_JOIN)\n      }\n      return answers[q.id] === OTHER_VALUE ? other : (answers[q.id] ?? '')\n    }\n    const resolvedAnswers = () =>\n      Object.fromEntries(questions.map((q) => [q.id, resolveOne(q)])) as Record<string, string>\n    const total = questions.length\n    const question = questions[Math.min(step, total - 1)]\n    const isLast = step >= total - 1\n    const select = (value: string) => setAnswers((prev) => ({ ...prev, [question.id]: value }))\n    const toggle = (value: string, checked: boolean) =>\n      setAnswers((prev) => {\n        const set = new Set(splitMulti(prev[question.id]))\n        if (checked) set.add(value)\n        else set.delete(value)\n        return { ...prev, [question.id]: [...set].join(MULTI_JOIN) }\n      })\n    const skip = () => onSkip?.(resolvedAnswers())\n\n    if (!question) return null\n    const multi = Boolean(question.multiSelect)\n    const selectedSet = new Set(multi ? splitMulti(answers[question.id]) : [answers[question.id]])\n    const otherSelected = selectedSet.has(OTHER_VALUE)\n    // 「其他」選中而文字為空 → 不得前進/送出(產題守則 7);複選一項未勾 → 亦不得前進。\n    const canAdvance =\n      (!otherSelected || (otherText[question.id] ?? '').trim() !== '') &&\n      (!multi || selectedSet.size > 0)\n    const recommendedValue =\n      !multi && !question.noDefault ? (question.defaultValue ?? question.options[0]?.value) : undefined\n    const optionLabel = (option: AgentDecisionOption | { value: string; label: string }) =>\n      option.value === recommendedValue ? `${option.label}${RECOMMENDED_SUFFIX}` : option.label\n    const allOptions = [...question.options, { value: OTHER_VALUE, label: OTHER_LABEL }]\n    const renderOtherInput = () => (\n      // 「其他」卡:常駐 32 高輸入格;距卡右/下各 12(卡 px 12;卡 py 8 + mb 4)。\n      <div className=\"mb-1 mt-1.5 pl-6\">\n        <Input\n          id={otherInputId}\n          value={otherText[question.id] ?? ''}\n          placeholder=\"輸入其他選項\"\n          aria-label=\"其他(自由輸入)\"\n          onFocus={() => (multi ? toggle(OTHER_VALUE, true) : select(OTHER_VALUE))}\n          onChange={(e) => setOtherText((prev) => ({ ...prev, [question.id]: e.target.value }))}\n          onClick={(e) => e.stopPropagation()}\n        />\n      </div>\n    )\n    const cardClass = 'cursor-pointer rounded-md bg-secondary px-3 py-2'\n    return (\n      <div\n        ref={ref}\n        role=\"group\"\n        aria-labelledby={titleId}\n        className={cn(\n          // 繼承 Popover surface:rounded-lg/border/elevation-200;改寫:無下圓角、貼底。\n          'absolute inset-x-0 bottom-0 z-10 flex flex-col overflow-hidden',\n          'rounded-t-lg rounded-b-none border border-b-0 border-border bg-surface-raised',\n          'shadow-[var(--elevation-200)]',\n          'animate-in fade-in-0 slide-in-from-bottom-2 duration-[var(--motion-duration-overlay)] motion-reduce:animate-none',\n          className,\n        )}\n        {...props}\n      >\n        {/* 標題列:N>1 時小標「n / N」+ 題目 + ×(跳過);改寫:header 下無分隔線。 */}\n        <SurfaceHeader className={cn(COMPACT_HEADER_SLOT, 'items-start justify-between border-b-0')}>\n          <div className=\"flex min-w-0 flex-1 flex-col\">\n            {total > 1 && (\n              <span className=\"text-caption font-medium text-fg-secondary\">\n                {step + 1} / {total}\n              </span>\n            )}\n            <span id={titleId} className=\"text-body font-medium text-foreground\">\n              {question.label}\n            </span>\n          </div>\n          <Button dismiss size=\"sm\" startIcon={XIcon} aria-label=\"跳過\" onClick={skip} />\n        </SurfaceHeader>\n        {/* body:上下無內距、左右 16;選項=灰底卡 gap 8(整卡可點;拍板樣張,本地包裝不抽通用元件);捲軸必用 ScrollArea。 */}\n        <ScrollArea fillX className=\"min-h-0\">\n          {multi ? (\n            <CheckboxGroup\n              key={question.id}\n              aria-labelledby={titleId}\n              className=\"flex flex-col gap-2 px-[var(--layout-space-loose)]\"\n            >\n              {allOptions.map((option) => {\n                const isOther = option.value === OTHER_VALUE\n                const checked = selectedSet.has(option.value)\n                return (\n                  <div\n                    key={option.value}\n                    data-state={checked ? 'checked' : 'unchecked'}\n                    className={cardClass}\n                    onClick={() => toggle(option.value, !checked)}\n                  >\n                    <Checkbox\n                      size=\"md\"\n                      checked={checked}\n                      onCheckedChange={(next) => toggle(option.value, next === true)}\n                      onClick={(e) => e.stopPropagation()}\n                      label={optionLabel(option)}\n                      description={isOther ? undefined : (option as AgentDecisionOption).description}\n                    />\n                    {isOther && renderOtherInput()}\n                  </div>\n                )\n              })}\n            </CheckboxGroup>\n          ) : (\n            <RadioGroup\n              key={question.id}\n              value={answers[question.id] ?? ''}\n              onValueChange={select}\n              aria-labelledby={titleId}\n              className=\"flex flex-col gap-2 px-[var(--layout-space-loose)]\"\n            >\n              {allOptions.map((option) => {\n                const isOther = option.value === OTHER_VALUE\n                const checked = selectedSet.has(option.value)\n                return (\n                  <div\n                    key={option.value}\n                    data-state={checked ? 'checked' : 'unchecked'}\n                    className={cardClass}\n                    onClick={() => select(option.value)}\n                  >\n                    <RadioGroupItem\n                      value={option.value}\n                      size=\"md\"\n                      label={optionLabel(option)}\n                      description={isOther ? undefined : (option as AgentDecisionOption).description}\n                    />\n                    {isOther && renderOtherInput()}\n                  </div>\n                )\n              })}\n            </RadioGroup>\n          )}\n        </ScrollArea>\n        {/* footer:Skip / 下一題 / 送出(最後一題);鈕 sm 守 Popover all-sm 律;無上分隔線。 */}\n        <SurfaceFooter className=\"border-t-0\">\n          <Button variant=\"tertiary\" size=\"sm\" onClick={skip}>\n            跳過\n          </Button>\n          {isLast ? (\n            <Button variant=\"primary\" size=\"sm\" disabled={!canAdvance} onClick={() => onSubmit?.(resolvedAnswers())}>\n              送出\n            </Button>\n          ) : (\n            <Button variant=\"primary\" size=\"sm\" disabled={!canAdvance} onClick={() => setStep((s) => s + 1)}>\n              下一題\n            </Button>\n          )}\n        </SurfaceFooter>\n      </div>\n    )\n  },\n)\nAgentDecisionCard.displayName = 'AgentDecisionCard'\n\n/* ────────────────────────────────────────────────────────────────────────────\n * 9. AgentDecisionSummary(決策回執)\n * ──────────────────────────────────────────────────────────────────────── */\n\nexport interface AgentDecisionSummaryProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** [問題, 答案] 配對(靜態回執)。 */\n  entries: Array<{ question: string; answer: string }>\n}\n\nconst AgentDecisionSummary = React.forwardRef<HTMLDivElement, AgentDecisionSummaryProps>(\n  ({ entries, className, ...props }, ref) => (\n    <div\n      ref={ref}\n      className={cn(\n        'flex flex-col gap-2 rounded-md border border-border px-3 py-2 text-body',\n        className,\n      )}\n      {...props}\n    >\n      {entries.map(({ question, answer }, index) => (\n        <div key={index} className=\"flex flex-col\">\n          <span className=\"text-fg-secondary\">{question}</span>\n          <span className=\"text-foreground\">{answer}</span>\n        </div>\n      ))}\n    </div>\n  ),\n)\nAgentDecisionSummary.displayName = 'AgentDecisionSummary'\n\nexport {\n  AgentPanel,\n  AgentPanelHeader,\n  AgentConversation,\n  AgentMessage,\n  AgentThinking,\n  AgentToolbar,\n  AgentPromptInput,\n  AgentDecisionCard,\n  AgentDecisionSummary,\n  PANEL_WIDTH_DEFAULT as AGENT_PANEL_WIDTH_DEFAULT,\n  PANEL_WIDTH_MIN as AGENT_PANEL_WIDTH_MIN,\n  PANEL_WIDTH_MAX as AGENT_PANEL_WIDTH_MAX,\n}\n"],"names":["XIcon"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,MAAM,aAAa,iBAAiB,cAAc;AAAA,EAChD,CAAC,QAAQ,EAAE,GAAG,KAAK,GAAG,KAAK,OAAO,MAAM,QAAQ,MAAM,IAAI,OAAO,MAAM,gBAAgB,QAAQ,QAAQ,KAAK,QAAQ;AACtH,CAAC;AAyDD,MAAM,sBAAsB;AAC5B,MAAM,kBAAkB;AACxB,MAAM,kBAAkB;AACxB,MAAM,wBAAwB;AAE9B,SAAS,gBAAgB,OAAe;AACtC,QAAM,cAAc,OAAO,WAAW,cAAc,kBAAkB,KAAK,MAAM,OAAO,aAAa,CAAC;AACtG,SAAO,KAAK,IAAI,KAAK,IAAI,OAAO,eAAe,GAAG,KAAK,IAAI,iBAAiB,KAAK,IAAI,aAAa,eAAe,CAAC,CAAC;AACrH;AAeA,MAAM,aAAa,MAAM;AAAA,EACvB,CACE;AAAA,IACE,OAAO;AAAA,IACP;AAAA,IACA,eAAe;AAAA,IACf;AAAA,IACA,YAAY;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAG;AAAA,EAAA,GAEL,QACG;AACH,UAAM,CAAC,mBAAmB,oBAAoB,IAAI,MAAM,SAAS,MAAM,gBAAgB,YAAY,CAAC;AACpG,UAAM,gBAAgB,gBAAgB,SAAS,iBAAiB;AAChE,UAAM,UAAU,MAAM,OAAsD,IAAI;AAChF,UAAM,CAAC,UAAU,WAAW,IAAI,MAAM,SAAS,KAAK;AAEpD,UAAM,aAAa,MAAM;AAAA,MACvB,CAAC,MAAc,WAAoB;AACjC,cAAM,UAAU,gBAAgB,IAAI;AACpC,YAAI,UAAU,OAAW,sBAAqB,OAAO;AACrD,YAAI,uDAAwB;AAAA,MAC9B;AAAA,MACA,CAAC,OAAO,aAAa;AAAA,IAAA;AAGvB,UAAM,sBAAsB,CAAC,MAA2C;AACtE,QAAE,eAAA;AACF,cAAQ,UAAU,EAAE,QAAQ,EAAE,SAAS,YAAY,cAAA;AACnD,kBAAY,IAAI;AAChB,YAAM,SAAS,CAAC,OAAqB;AACnC,cAAM,OAAO,QAAQ;AACrB,YAAI,CAAC,KAAM;AAEX,mBAAW,KAAK,cAAc,KAAK,SAAS,GAAG,UAAU,KAAK;AAAA,MAChE;AACA,YAAM,OAAO,CAAC,OAAqB;AACjC,cAAM,OAAO,QAAQ;AACrB,gBAAQ,UAAU;AAClB,oBAAY,KAAK;AACjB,eAAO,oBAAoB,eAAe,MAAM;AAChD,eAAO,oBAAoB,aAAa,IAAI;AAC5C,YAAI,iBAAiB,KAAK,cAAc,KAAK,SAAS,GAAG,UAAU,IAAI;AAAA,MACzE;AACA,aAAO,iBAAiB,eAAe,MAAM;AAC7C,aAAO,iBAAiB,aAAa,IAAI;AAAA,IAC3C;AAEA,QAAI,CAAC,KAAM,QAAO;AAClB,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,MAAK;AAAA,QACL,cAAW;AAAA,QACX,WAAW;AAAA,UACT;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QAAA;AAAA,QAEF,OAAO,EAAE,OAAO,eAAe,GAAG,MAAA;AAAA,QACjC,GAAG;AAAA,QAEH,UAAA;AAAA,UAAA;AAAA,UAEC;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,MAAK;AAAA,cACL,oBAAiB;AAAA,cACjB,cAAW;AAAA,cACX,iBAAe;AAAA,cACf,iBAAe;AAAA,cACf,iBAAe;AAAA,cACf,kBAAgB,GAAG,aAAa;AAAA,cAChC,UAAU;AAAA,cACV,WAAW,CAAC,MAAM;AAChB,oBAAI,OAAsB;AAC1B,oBAAI,EAAE,QAAQ,YAAa,QAAO,gBAAgB;AAAA,yBACzC,EAAE,QAAQ,aAAc,QAAO,gBAAgB;AAAA,yBAC/C,EAAE,QAAQ,OAAQ,QAAO;AAAA,yBACzB,EAAE,QAAQ,MAAO,QAAO;AACjC,oBAAI,QAAQ,KAAM;AAClB,kBAAE,eAAA;AACF,2BAAW,MAAM,IAAI;AAAA,cACvB;AAAA,cACA,WAAU;AAAA,cAEV,UAAA;AAAA,gBAAC;AAAA,gBAAA;AAAA,kBACC,WAAU;AAAA,kBACV,UAAS;AAAA,kBACT,YAAY;AAAA,kBACZ,eAAe;AAAA,gBAAA;AAAA,cAAA;AAAA,YACjB;AAAA,UAAA;AAAA,UAGH;AAAA,QAAA;AAAA,MAAA;AAAA,IAAA;AAAA,EAGP;AACF;AACA,WAAW,cAAc;AAgDzB,SAAS,WAAW;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAMG;AACD,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,OAAO,aAAa;AAAA,MACpB,UAAU,CAAC,aAAa,KAAK;AAAA,MAC7B;AAAA,MACA,WAAW;AAAA,QACT;AAAA;AAAA,QAEA,YAAY;AAAA,MAAA;AAAA,MAGd,UAAA;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,MAAK;AAAA,UACL;AAAA,UACA,WAAU;AAAA,UACV,cACE,aAAa,WACX,oBAAC,kBAAA,EAAiB,MAAM,IAAI,cAAW,MAAA,CAAM,wBAE5C,eAAA,EAAc,MAAM,IAAI,eAAW,MAAC,WAAU,iBAAgB;AAAA,UAGnE;AAAA;AAAA,iCAEG,YAAA,EAAW,aAAW,MAAC,YAAW,aACjC,UAAA;AAAA,cAAA;AAAA,gBAAC;AAAA,gBAAA;AAAA,kBACC,QAAQ;AAAA,oBACN,MAAM;AAAA,oBACN,OAAO;AAAA;AAAA,oBACP,SAAS,CAAC,MAAM;AACd,6CAAG;AACH,+BAAA;AAAA,oBACF;AAAA,kBAAA;AAAA,gBACF;AAAA,cAAA;AAAA,cAEF;AAAA,gBAAC;AAAA,gBAAA;AAAA,kBACC,QAAQ;AAAA,oBACN,MAAM;AAAA,oBACN,OAAO;AAAA;AAAA,oBACP,SAAS,CAAC,MAAM;AACd,6CAAG;AACH,+BAAA;AAAA,oBACF;AAAA,kBAAA;AAAA,gBACF;AAAA,cAAA;AAAA,YACF,GACF;AAAA;AAAA,UAGD,UAAA,aAAa;AAAA,QAAA;AAAA,MAAA;AAAA,IAChB;AAAA,EAAA;AAGN;AAEA,MAAM,mBAAmB,MAAM;AAAA,EAC7B,CACE;AAAA,IACE;AAAA,IACA,YAAY;AAAA,IACZ,2BAA2B;AAAA;AAAA,IAC3B,mBAAmB;AAAA;AAAA,IACnB,gBAAgB,CAAA;AAAA,IAChB;AAAA,IACA,oBAAoB;AAAA,IACpB,qBAAqB;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAG;AAAA,EAAA,GAEL,QACG;AACH,UAAM,CAAC,aAAa,cAAc,IAAI,MAAM,SAAS,kBAAkB;AACvE,UAAM,CAAC,cAAc,eAAe,IAAI,MAAM,SAA0C,IAAI;AAC5F,UAAM,CAAC,cAAc,eAAe,IAAI,MAAM,SAA0C,IAAI;AAC5F,UAAM,aAAa,MAAM,OAA0B,IAAI;AAEvD,UAAM,cAAc,MAAA;;AAAM,8BAAW,YAAX,mBAAoB,MAAM,EAAE,eAAe;;AAErE,UAAM,SAAS,MAAM,QAAQ,MAAM;AACjC,YAAM,QAAkB,CAAA;AACxB,YAAM,8BAAc,IAAA;AACpB,iBAAW,QAAQ,eAAe;AAChC,cAAM,MAAM,KAAK,SAAS;AAC1B,YAAI,CAAC,QAAQ,IAAI,GAAG,GAAG;AACrB,kBAAQ,IAAI,KAAK,EAAE;AACnB,gBAAM,KAAK,GAAG;AAAA,QAChB;AACA,gBAAQ,IAAI,GAAG,EAAG,KAAK,IAAI;AAAA,MAC7B;AACA,aAAO,MAAM,IAAI,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,QAAQ,IAAI,GAAG,EAAA,EAAK;AAAA,IACtE,GAAG,CAAC,aAAa,CAAC;AAElB,WACE,qBAAC,gBAAa,KAAU,WAAW,GAAG,cAAc,SAAS,GAAI,GAAG,OAClE,UAAA;AAAA,MAAA,qBAAC,OAAA,EAAI,WAAU,0CACb,UAAA;AAAA,4BAAC,WAAA,EAAU,OAAO,WAAW,MAAM,IAAI;AAAA,6BACtC,SAAA,EAAQ,MAAM,aAAa,cAAc,gBACxC,UAAA;AAAA,UAAA,oBAAC,gBAAA,EAAe,SAAO,MAErB,UAAA;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,KAAK;AAAA,cACL,SAAQ;AAAA,cACR,MAAK;AAAA,cACL,SAAS;AAAA,cACT,iBAAc;AAAA,cACd,iBAAe;AAAA,cACf,WAAU;AAAA,cAEV,8BAAC,QAAA,EAAK,WAAU,YAAY,UAAA,OAAM;AAAA,YAAA;AAAA,UAAA,GAEtC;AAAA,UACA;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,OAAM;AAAA,cACN,cAAW;AAAA,cACX,WAAU;AAAA,cAEV,+BAAC,SAAA,EAAQ,OAAM,QAAO,WAAU,iCAE9B,UAAA;AAAA,gBAAA;AAAA,kBAAC;AAAA,kBAAA;AAAA,oBACC,aAAa;AAAA,oBACb,cAAY;AAAA,oBACZ,WAAU;AAAA,kBAAA;AAAA,gBAAA;AAAA,gBAEZ,qBAAC,aAAA,EAAY,cAAW,MACtB,UAAA;AAAA,kBAAA,oBAAC,cAAA,EAAa,WAAU,oCACtB,UAAA,oBAAC,SAAM,aAAa,kBAAkB,WAAU,OAAA,CAAO,GACzD;AAAA,kBACC,OAAO,IAAI,CAAC,EAAE,OAAO,MAAA,GAAS,OAC7B,qBAAC,MAAM,UAAN,EACE,UAAA;AAAA,oBAAA,KAAK,yBAAM,kBAAA,CAAA,CAAiB;AAAA,oBAC7B;AAAA,sBAAC;AAAA,sBAAA;AAAA,wBACC,WAAU;AAAA,wBACV,SAAS,QAAQ,oBAAC,YAAS,QAAM,MAAE,iBAAM,IAAc;AAAA,wBAEtD,UAAA,MAAM,IAAI,CAAC,iBACV;AAAA,0BAAC;AAAA,0BAAA;AAAA,4BAEC;AAAA,4BACA,UAAU,aAAa,OAAO;AAAA,4BAC9B,UAAU,MAAM;AACd,2FAAuB,aAAa;AACpC,6CAAe,KAAK;AAAA,4BACtB;AAAA,4BACA,UAAU,MAAM,gBAAgB,YAAY;AAAA,4BAC5C,UAAU,MAAM,gBAAgB,YAAY;AAAA,0BAAA;AAAA,0BARvC,aAAa;AAAA,wBAAA,CAUrB;AAAA,sBAAA;AAAA,oBAAA;AAAA,kBACH,EAAA,GAnBmB,SAAS,aAoB9B,CACD;AAAA,gBAAA,GACH;AAAA,cAAA,GACF;AAAA,YAAA;AAAA,UAAA;AAAA,QACF,GACF;AAAA,MAAA,GACF;AAAA,MACA,qBAAC,OAAA,EAAI,WAAU,2BACb,UAAA;AAAA,QAAA;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,SAAQ;AAAA,YACR,MAAK;AAAA,YACL,UAAQ;AAAA,YACR,WAAW;AAAA,YACX,cAAW;AAAA,YACX,UAAU;AAAA,YACV,SAAS;AAAA,UAAA;AAAA,QAAA;AAAA,4BAEV,eAAA,EAAc;AAAA,QACf,oBAAC,QAAA,EAAO,SAAO,MAAC,MAAK,MAAK,WAAWA,GAAO,cAAW,QAAO,SAAS,SAAS;AAAA,MAAA,GAClF;AAAA,MACC,gBACC;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,cAAc;AAAA,UACd,cAAc,CAAC,SAAS;AACtB,gBAAI,CAAC,MAAM;AACT,8BAAgB,IAAI;AACpB,0BAAA;AAAA,YACF;AAAA,UACF;AAAA,UACA,WAAW,CAAC,cAAc;AACxB,yEAAuB,aAAa,IAAI;AACxC,4BAAgB,IAAI;AACpB,wBAAA;AAAA,UACF;AAAA,QAAA;AAAA,MAAA;AAAA,MAGH,gBACC;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,MAAI;AAAA,UACJ,cAAc,CAAC,SAAS;AACtB,gBAAI,CAAC,MAAM;AACT,8BAAgB,IAAI;AACpB,0BAAA;AAAA,YACF;AAAA,UACF;AAAA,UAEA,+BAAC,eAAA,EACC,UAAA;AAAA,YAAA,oBAAC,cAAA,EACC,UAAA,oBAAC,aAAA,EAAY,UAAA,OAAA,CAAI,GACnB;AAAA,iCACC,YAAA,EAAW,UAAA;AAAA,cAAA;AAAA,cACJ,aAAa;AAAA,cAAM;AAAA,YAAA,GAC3B;AAAA,iCACC,cAAA,EACC,UAAA;AAAA,kCAAC,QAAA,EAAO,SAAQ,YAAW,SAAS,MAAM;AAAE,gCAAgB,IAAI;AAAG,4BAAA;AAAA,cAAc,GAAG,UAAA,MAEpF;AAAA,cACA;AAAA,gBAAC;AAAA,gBAAA;AAAA,kBACC,SAAQ;AAAA,kBACR,QAAM;AAAA,kBACN,SAAS,MAAM;AACb,iFAAuB,aAAa;AACpC,oCAAgB,IAAI;AACpB,gCAAA;AAAA,kBACF;AAAA,kBACD,UAAA;AAAA,gBAAA;AAAA,cAAA;AAAA,YAED,GACF;AAAA,UAAA,GACF;AAAA,QAAA;AAAA,MAAA;AAAA,IACF,GAEJ;AAAA,EAEJ;AACF;AACA,iBAAiB,cAAc;AAG/B,SAAS,kBAAkB;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,QAAM,CAAC,OAAO,QAAQ,IAAI,MAAM,SAAS,aAAa,KAAK;AAC3D,QAAM,CAAC,SAAS,UAAU,IAAI,MAAM,SAAS,KAAK;AAClD,QAAM,UAAU,MAAM,KAAA;AACtB,QAAM,QAAQ,YAAY,aAAa;AACvC,QAAM,QAAQ,QAAQ,WAAW;AACjC,QAAM,YAAY,WAAW;AAC7B,QAAM,SAAS,MAAM;AACnB,eAAW,IAAI;AACf,QAAI,SAAS,CAAC,MAAO;AACrB,cAAU,OAAO;AAAA,EACnB;AACA,6BACG,QAAA,EAAO,MAAI,MAAC,cACX,+BAAC,eAAA,EACC,UAAA;AAAA,IAAA,oBAAC,cAAA,EACC,UAAA,oBAAC,aAAA,EAAY,UAAA,OAAA,CAAI,GACnB;AAAA,wBACC,YAAA,EACC,UAAA,qBAAC,SAAM,UAAQ,MAAC,SAAS,WACvB,UAAA;AAAA,MAAA,oBAAC,cAAW,UAAA,MAAE;AAAA,MACd;AAAA,QAAC;AAAA,QAAA;AAAA,UACC;AAAA,UACA,OAAO;AAAA,UACP,UAAU,CAAC,MAAM,SAAS,EAAE,OAAO,KAAK;AAAA,UACxC,SAAS,CAAC,MAAM,EAAE,cAAc,OAAA;AAAA,UAChC,QAAQ,MAAM,WAAW,IAAI;AAAA,UAC7B,WAAW,CAAC,MAAM;AAEhB,gBAAI,EAAE,QAAQ,SAAS;AACrB,gBAAE,eAAA;AACF,qBAAA;AAAA,YACF;AAAA,UACF;AAAA,QAAA;AAAA,MAAA;AAAA,MAED,aAAa,oBAAC,YAAA,EAAW,UAAA,UAAM;AAAA,IAAA,EAAA,CAClC,EAAA,CACF;AAAA,yBACC,cAAA,EACC,UAAA;AAAA,MAAA,oBAAC,QAAA,EAAO,SAAQ,YAAW,SAAS,MAAM,aAAa,KAAK,GAAG,UAAA,KAAA,CAE/D;AAAA,MACA,oBAAC,UAAO,SAAQ,WAAU,UAAU,CAAC,OAAO,SAAS,QAAQ,UAAA,KAAA,CAE7D;AAAA,IAAA,GACF;AAAA,EAAA,EAAA,CACF,EAAA,CACF;AAEJ;AAQA,MAAM,oBAAoB,MAAM;AAAA,EAC9B,CAAC,EAAE,WAAW,UAAU,GAAG,SAAS;AAAA;AAAA,wBAEjC,YAAA,EAAW,OAAK,MAAC,WAAU,kBAC1B,UAAA;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,MAAK;AAAA,QACL,aAAU;AAAA,QACV,WAAW;AAAA;AAAA,UAET;AAAA,UACA;AAAA,QAAA;AAAA,QAED,GAAG;AAAA,QAEH;AAAA,MAAA;AAAA,IAAA,GAEL;AAAA;AAEJ;AACA,kBAAkB,cAAc;AAqBhC,MAAM,eAAe,MAAM;AAAA,EACzB,CACE,EAAE,OAAO,SAAS,aAAa,mBAAmB,SAAS,WAAW,UAAU,GAAG,MAAA,GACnF,QACG;AACH,UAAM,SAAS,SAAS;AACxB,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,WAAW,GAAG,gCAAgC,UAAU,oBAAoB,SAAS;AAAA,QACpF,GAAG;AAAA,QAEJ,UAAA;AAAA,UAAA;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,WAAW;AAAA,gBACT;AAAA,gBACA,SACI;AAAA,kBACE;AAAA,kBACA;AAAA,gBAAA,IAEF;AAAA,cAAA;AAAA,cAGL,UAAA;AAAA,gBAAA,eAAe,YAAY,SAAS;AAAA,oCAElC,OAAA,EAAI,WAAU,6BACZ,UAAA,YAAY,IAAI,CAAC,eAChB;AAAA,kBAAC;AAAA,kBAAA;AAAA,oBAEC,SAAQ;AAAA,oBACR,cAAY,MAAM,WAAW,KAAK;AAAA,oBAClC,SAAS,MAAM,uDAAoB;AAAA,oBAElC,UAAA,WAAW;AAAA,kBAAA;AAAA,kBALP,WAAW;AAAA,gBAAA,CAOnB,GACH;AAAA,gBAED;AAAA,cAAA;AAAA,YAAA;AAAA,UAAA;AAAA,UAEF;AAAA,QAAA;AAAA,MAAA;AAAA,IAAA;AAAA,EAGP;AACF;AACA,aAAa,cAAc;AAmB3B,MAAM,gBAAgB,MAAM;AAAA,EAC1B,CAAC,EAAE,WAAW,OAAO,OAAO,aAAa,MAAM,cAAc,WAAW,GAAG,MAAA,GAAS,QAAQ;AAE1F,UAAM,CAAC,kBAAkB,mBAAmB,IAAI,MAAM,SAAS,QAAQ;AACvE,UAAM,UAAU,MAAM;AACpB,UAAI,SAAS,OAAW,qBAAoB,QAAQ;AAAA,IACtD,GAAG,CAAC,UAAU,IAAI,CAAC;AACnB,UAAM,eAAe,QAAQ;AAC7B,UAAM,mBAAmB,CAAC,SAAkB;AAC1C,0BAAoB,IAAI;AACxB,mDAAe;AAAA,IACjB;AACA,WACE;AAAA,MAAC,qBAAqB;AAAA,MAArB;AAAA,QACC;AAAA,QACA,MAAM;AAAA,QACN,cAAc;AAAA,QACd,WAAW,GAAG,aAAa,SAAS;AAAA,QACnC,GAAG;AAAA,QAEJ,UAAA;AAAA,UAAA;AAAA,YAAC,qBAAqB;AAAA,YAArB;AAAA,cACC,WAAW;AAAA,gBACT;AAAA,gBACA;AAAA,cAAA;AAAA,cAGF,UAAA;AAAA,gBAAA,oBAAC,QAAA,EAAK,WAAW,GAAG,YAAY,eAAe,GAC5C,UAAA,WAAW,SAAS,OAAA,CACvB;AAAA,gBAEA;AAAA,kBAAC;AAAA,kBAAA;AAAA,oBACC,MAAM;AAAA,oBACN,eAAW;AAAA,oBACX,WAAU;AAAA,kBAAA;AAAA,gBAAA;AAAA,cACZ;AAAA,YAAA;AAAA,UAAA;AAAA,UAEF;AAAA,YAAC,qBAAqB;AAAA,YAArB;AAAA,cACC,WAAU;AAAA,cAGV,UAAA,qBAAC,OAAA,EAAI,WAAU,2EACZ,UAAA;AAAA,gBAAA,+BAAO,IAAI,CAAC,MAAM,8BAAW,OAAA,EAAiB,UAAA,KAAA,GAAR,KAAa;AAAA,gBACnD,eAAe,QACd,oBAAC,OAAA,EAAI,WAAW,GAAG,YAAY,eAAe,GAAI,UAAA,YAAA,CAAY;AAAA,cAAA,GAElE;AAAA,YAAA;AAAA,UAAA;AAAA,QACF;AAAA,MAAA;AAAA,IAAA;AAAA,EAGN;AACF;AACA,cAAc,cAAc;AAc5B,MAAM,eAAe,MAAM;AAAA,EACzB,CAAC,EAAE,SAAS,OAAO,QAAQ,QAAQ,WAAW,WAAW,UAAU,GAAG,MAAA,GAAS,QAC7E;AAAA,IAAC;AAAA,IAAA;AAAA,MACC;AAAA,MACA,WAAW;AAAA,QACT;AAAA,QACA;AAAA,QACA,SACI,gBACA;AAAA,QACJ;AAAA,MAAA;AAAA,MAED,GAAG;AAAA,MAEJ,UAAA;AAAA,4BAAC,QAAA,EAAO,SAAQ,QAAO,MAAK,MAAK,UAAQ,MAAC,WAAW,MAAM,cAAW,MAAK,SAAS,MAAM,oCAAY;AAAA,4BACrG,eAAA,EAAc;AAAA,4BACd,QAAA,EAAO,SAAQ,QAAO,MAAK,MAAK,UAAQ,MAAC,WAAW,UAAU,cAAW,KAAI,SAAS,MAAM,oCAAY;AAAA,4BACxG,QAAA,EAAO,SAAQ,QAAO,MAAK,MAAK,UAAQ,MAAC,WAAW,YAAY,cAAW,MAAK,SAAS,MAAM,0CAAe;AAAA,QAC9G;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAGP;AACA,aAAa,cAAc;AA8B3B,SAAS,oBAAoB;AAAA,EAC3B;AAAA,EACA;AACF,GAGG;AACD,QAAM,EAAE,cAAc,cAAc,gBAAA,IAAoB,mBAAmC;AAAA,IACzF,qBAAqB;AAAA,EAAA,CACtB;AACD,QAAM,SAAS,IAAI,IAAI,eAAe;AACtC,QAAM,cAAc,YAAY,OAAO,CAAC,GAAG,MAAM,OAAO,IAAI,CAAC,CAAC;AAC9D;AAAA;AAAA;AAAA;AAAA,yBAIG,OAAA,EAAI,KAAK,cAAc,WAAU,qDAC/B,UAAA;AAAA,MAAA,YAAY,IAAI,CAAC,YAAY,UAC5B;AAAA,QAAC;AAAA,QAAA;AAAA,UAEC,KAAK,aAAa,KAAK;AAAA,UACvB,WAAW,GAAG,YAAY,OAAO,IAAI,KAAK,KAAK,sBAAsB;AAAA,UAErE,UAAA,oBAAC,KAAA,EAAI,MAAK,MAAK,UAAU,MAAM,SAAS,UAAU,GAC/C,UAAA,WAAW,OACd;AAAA,QAAA;AAAA,QANK,WAAW;AAAA,MAAA,CAQnB;AAAA,MACA,YAAY,SAAS,KACpB,oBAAC,mBAAA,EAAkB,OAAO,YAAY,QAAQ,OAAM,OAAM,MAAK,MAC5D,sBAAY,IAAI,CAAC,eAChB,oBAAC,KAAA,EAAwB,MAAK,MAAK,UAAU,MAAM,SAAS,UAAU,GACnE,UAAA,WAAW,SADJ,WAAW,EAErB,CACD,GACH;AAAA,IAAA,GAEJ;AAAA;AAEJ;AAEA,MAAM,mBAAmB,MAAM;AAAA,EAC7B,CACE;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA,OAAO;AAAA,IACP;AAAA,IACA,cAAc,CAAA;AAAA,IACd;AAAA,IACA;AAAA,IACA,cAAc;AAAA,IACd;AAAA,IACA,GAAG;AAAA,EAAA,GAEL,QACG;AACH,UAAM,YAAY,MAAM,KAAA,EAAO,SAAS;AACxC,UAAM,SAAS,MAAM;AACnB,UAAI,QAAQ,CAAC,UAAW;AACxB,eAAA;AAAA,IACF;AACA,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,WAAW;AAAA,UACT;AAAA,UACA;AAAA,UACA;AAAA,QAAA;AAAA,QAED,GAAG;AAAA,QAEH,UAAA;AAAA,UAAA,YAAY,SAAS,KACpB,oBAAC,qBAAA,EAAoB,aAA0B,UAAU,oBAAoB;AAAA,UAE/E;AAAA,YAAC;AAAA,YAAA;AAAA,cACC;AAAA,cACA,UAAU,CAAC,MAAM,cAAc,EAAE,OAAO,KAAK;AAAA,cAC7C,WAAW,CAAC,MAAM;AAEhB,oBAAI,EAAE,QAAQ,WAAW,CAAC,EAAE,YAAY,CAAC,EAAE,YAAY,aAAa;AAClE,oBAAE,eAAA;AACF,yBAAA;AAAA,gBACF;AAAA,cACF;AAAA,cACA,MAAM;AAAA,cACN;AAAA,cACA,cAAW;AAAA,cACX,WAAW;AAAA;AAAA,gBAET;AAAA,gBACA;AAAA,gBACA;AAAA,gBACA;AAAA,cAAA;AAAA,YACF;AAAA,UAAA;AAAA,UAEF,qBAAC,OAAA,EAAI,WAAU,+CACb,UAAA;AAAA,YAAA;AAAA,cAAC;AAAA,cAAA;AAAA,gBACC,SAAQ;AAAA,gBACR,MAAK;AAAA,gBACL,UAAQ;AAAA,gBACR,WAAW;AAAA,gBACX,cAAW;AAAA,gBACX,SAAS;AAAA,cAAA;AAAA,YAAA;AAAA,YAEV,OACC;AAAA,cAAC;AAAA,cAAA;AAAA,gBACC,SAAQ;AAAA,gBACR,MAAK;AAAA,gBACL,UAAQ;AAAA,gBACR,WAAW;AAAA,gBACX,cAAW;AAAA,gBACX,SAAS,MAAM;AAAA,gBACf,WAAU;AAAA,cAAA;AAAA,YAAA,IAGZ;AAAA,cAAC;AAAA,cAAA;AAAA,gBACC,SAAQ;AAAA,gBACR,MAAK;AAAA,gBACL,UAAQ;AAAA,gBACR,WAAW;AAAA,gBACX,cAAW;AAAA,gBACX,UAAU,CAAC;AAAA,gBACX,SAAS;AAAA,gBACT,WAAU;AAAA,cAAA;AAAA,YAAA;AAAA,UACZ,GAEJ;AAAA,QAAA;AAAA,MAAA;AAAA,IAAA;AAAA,EAGN;AACF;AACA,iBAAiB,cAAc;AAsC/B,MAAM,cAAc;AACpB,MAAM,cAAc;AACpB,MAAM,qBAAqB;AAC3B,MAAM,aAAa;AA0BnB,SAAS,cAAc,GAA0B;;AAC/C,MAAI,EAAE,eAAe,EAAE,UAAW,QAAO;AACzC,SAAO,EAAE,kBAAgB,OAAE,QAAQ,CAAC,MAAX,mBAAc,UAAS;AAClD;AAGA,MAAM,aAAa,CAAC,MAA2B,IAAI,EAAE,MAAM,UAAU,EAAE,OAAO,OAAO,IAAI,CAAA;AAEzF,MAAM,oBAAoB,MAAM;AAAA,EAC9B,CAAC,EAAE,WAAW,UAAU,QAAQ,WAAW,GAAG,MAAA,GAAS,QAAQ;;AAC7D,UAAM,UAAU,MAAM,MAAA;AACtB,UAAM,eAAe,MAAM,MAAA;AAE3B,UAAM,CAAC,MAAM,OAAO,IAAI,MAAM,SAAS,CAAC;AACxC,UAAM,CAAC,SAAS,UAAU,IAAI,MAAM;AAAA,MAAiC,MACnE,OAAO,YAAY,UAAU,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC;AAAA,IAAA;AAEnE,UAAM,CAAC,WAAW,YAAY,IAAI,MAAM,SAAiC,CAAA,CAAE;AAC3E,UAAM,aAAa,CAAC,MAA6B;AAC/C,YAAM,SAAS,UAAU,EAAE,EAAE,KAAK,IAAI,KAAA;AACtC,UAAI,EAAE,aAAa;AACjB,eAAO,WAAW,QAAQ,EAAE,EAAE,CAAC,EAC5B,IAAI,CAAC,MAAO,MAAM,cAAc,QAAQ,CAAE,EAC1C,OAAO,OAAO,EACd,KAAK,UAAU;AAAA,MACpB;AACA,aAAO,QAAQ,EAAE,EAAE,MAAM,cAAc,QAAS,QAAQ,EAAE,EAAE,KAAK;AAAA,IACnE;AACA,UAAM,kBAAkB,MACtB,OAAO,YAAY,UAAU,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;AAChE,UAAM,QAAQ,UAAU;AACxB,UAAM,WAAW,UAAU,KAAK,IAAI,MAAM,QAAQ,CAAC,CAAC;AACpD,UAAM,SAAS,QAAQ,QAAQ;AAC/B,UAAM,SAAS,CAAC,UAAkB,WAAW,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,GAAG,QAAQ;AAC1F,UAAM,SAAS,CAAC,OAAe,YAC7B,WAAW,CAAC,SAAS;AACnB,YAAM,MAAM,IAAI,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC,CAAC;AACjD,UAAI,QAAS,KAAI,IAAI,KAAK;AAAA,UACrB,KAAI,OAAO,KAAK;AACrB,aAAO,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,KAAK,UAAU,EAAA;AAAA,IAC3D,CAAC;AACH,UAAM,OAAO,MAAM,iCAAS;AAE5B,QAAI,CAAC,SAAU,QAAO;AACtB,UAAM,QAAQ,QAAQ,SAAS,WAAW;AAC1C,UAAM,cAAc,IAAI,IAAI,QAAQ,WAAW,QAAQ,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,SAAS,EAAE,CAAC,CAAC;AAC7F,UAAM,gBAAgB,YAAY,IAAI,WAAW;AAEjD,UAAM,cACH,CAAC,kBAAkB,UAAU,SAAS,EAAE,KAAK,IAAI,KAAA,MAAW,QAC5D,CAAC,SAAS,YAAY,OAAO;AAChC,UAAM,mBACJ,CAAC,SAAS,CAAC,SAAS,YAAa,SAAS,kBAAgB,cAAS,QAAQ,CAAC,MAAlB,mBAAqB,SAAS;AAC1F,UAAM,cAAc,CAAC,WACnB,OAAO,UAAU,mBAAmB,GAAG,OAAO,KAAK,GAAG,kBAAkB,KAAK,OAAO;AACtF,UAAM,aAAa,CAAC,GAAG,SAAS,SAAS,EAAE,OAAO,aAAa,OAAO,aAAa;AACnF,UAAM,mBAAmB;AAAA;AAAA,MAEvB,oBAAC,OAAA,EAAI,WAAU,oBACb,UAAA;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,IAAI;AAAA,UACJ,OAAO,UAAU,SAAS,EAAE,KAAK;AAAA,UACjC,aAAY;AAAA,UACZ,cAAW;AAAA,UACX,SAAS,MAAO,QAAQ,OAAO,aAAa,IAAI,IAAI,OAAO,WAAW;AAAA,UACtE,UAAU,CAAC,MAAM,aAAa,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,QAAQ;AAAA,UACpF,SAAS,CAAC,MAAM,EAAE,gBAAA;AAAA,QAAgB;AAAA,MAAA,GAEtC;AAAA;AAEF,UAAM,YAAY;AAClB,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,MAAK;AAAA,QACL,mBAAiB;AAAA,QACjB,WAAW;AAAA;AAAA,UAET;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QAAA;AAAA,QAED,GAAG;AAAA,QAGJ,UAAA;AAAA,UAAA,qBAAC,eAAA,EAAc,WAAW,GAAG,qBAAqB,wCAAwC,GACxF,UAAA;AAAA,YAAA,qBAAC,OAAA,EAAI,WAAU,gCACZ,UAAA;AAAA,cAAA,QAAQ,KACP,qBAAC,QAAA,EAAK,WAAU,8CACb,UAAA;AAAA,gBAAA,OAAO;AAAA,gBAAE;AAAA,gBAAI;AAAA,cAAA,GAChB;AAAA,kCAED,QAAA,EAAK,IAAI,SAAS,WAAU,yCAC1B,mBAAS,MAAA,CACZ;AAAA,YAAA,GACF;AAAA,YACA,oBAAC,QAAA,EAAO,SAAO,MAAC,MAAK,MAAK,WAAWA,GAAO,cAAW,MAAK,SAAS,MAAM;AAAA,UAAA,GAC7E;AAAA,8BAEC,YAAA,EAAW,OAAK,MAAC,WAAU,WACzB,UAAA,QACC;AAAA,YAAC;AAAA,YAAA;AAAA,cAEC,mBAAiB;AAAA,cACjB,WAAU;AAAA,cAET,UAAA,WAAW,IAAI,CAAC,WAAW;AAC1B,sBAAM,UAAU,OAAO,UAAU;AACjC,sBAAM,UAAU,YAAY,IAAI,OAAO,KAAK;AAC5C,uBACE;AAAA,kBAAC;AAAA,kBAAA;AAAA,oBAEC,cAAY,UAAU,YAAY;AAAA,oBAClC,WAAW;AAAA,oBACX,SAAS,MAAM,OAAO,OAAO,OAAO,CAAC,OAAO;AAAA,oBAE5C,UAAA;AAAA,sBAAA;AAAA,wBAAC;AAAA,wBAAA;AAAA,0BACC,MAAK;AAAA,0BACL;AAAA,0BACA,iBAAiB,CAAC,SAAS,OAAO,OAAO,OAAO,SAAS,IAAI;AAAA,0BAC7D,SAAS,CAAC,MAAM,EAAE,gBAAA;AAAA,0BAClB,OAAO,YAAY,MAAM;AAAA,0BACzB,aAAa,UAAU,SAAa,OAA+B;AAAA,wBAAA;AAAA,sBAAA;AAAA,sBAEpE,WAAW,iBAAA;AAAA,oBAAiB;AAAA,kBAAA;AAAA,kBAbxB,OAAO;AAAA,gBAAA;AAAA,cAgBlB,CAAC;AAAA,YAAA;AAAA,YAzBI,SAAS;AAAA,UAAA,IA4BhB;AAAA,YAAC;AAAA,YAAA;AAAA,cAEC,OAAO,QAAQ,SAAS,EAAE,KAAK;AAAA,cAC/B,eAAe;AAAA,cACf,mBAAiB;AAAA,cACjB,WAAU;AAAA,cAET,UAAA,WAAW,IAAI,CAAC,WAAW;AAC1B,sBAAM,UAAU,OAAO,UAAU;AACjC,sBAAM,UAAU,YAAY,IAAI,OAAO,KAAK;AAC5C,uBACE;AAAA,kBAAC;AAAA,kBAAA;AAAA,oBAEC,cAAY,UAAU,YAAY;AAAA,oBAClC,WAAW;AAAA,oBACX,SAAS,MAAM,OAAO,OAAO,KAAK;AAAA,oBAElC,UAAA;AAAA,sBAAA;AAAA,wBAAC;AAAA,wBAAA;AAAA,0BACC,OAAO,OAAO;AAAA,0BACd,MAAK;AAAA,0BACL,OAAO,YAAY,MAAM;AAAA,0BACzB,aAAa,UAAU,SAAa,OAA+B;AAAA,wBAAA;AAAA,sBAAA;AAAA,sBAEpE,WAAW,iBAAA;AAAA,oBAAiB;AAAA,kBAAA;AAAA,kBAXxB,OAAO;AAAA,gBAAA;AAAA,cAclB,CAAC;AAAA,YAAA;AAAA,YAzBI,SAAS;AAAA,UAAA,GA4BpB;AAAA,UAEA,qBAAC,eAAA,EAAc,WAAU,cACvB,UAAA;AAAA,YAAA,oBAAC,UAAO,SAAQ,YAAW,MAAK,MAAK,SAAS,MAAM,UAAA,KAAA,CAEpD;AAAA,YACC,SACC,oBAAC,QAAA,EAAO,SAAQ,WAAU,MAAK,MAAK,UAAU,CAAC,YAAY,SAAS,MAAM,qCAAW,oBAAoB,UAAA,KAAA,CAEzG,IAEA,oBAAC,UAAO,SAAQ,WAAU,MAAK,MAAK,UAAU,CAAC,YAAY,SAAS,MAAM,QAAQ,CAAC,MAAM,IAAI,CAAC,GAAG,UAAA,OAEjG;AAAA,UAAA,GAEJ;AAAA,QAAA;AAAA,MAAA;AAAA,IAAA;AAAA,EAGN;AACF;AACA,kBAAkB,cAAc;AAWhC,MAAM,uBAAuB,MAAM;AAAA,EACjC,CAAC,EAAE,SAAS,WAAW,GAAG,MAAA,GAAS,QACjC;AAAA,IAAC;AAAA,IAAA;AAAA,MACC;AAAA,MACA,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MAAA;AAAA,MAED,GAAG;AAAA,MAEH,UAAA,QAAQ,IAAI,CAAC,EAAE,UAAU,OAAA,GAAU,UAClC,qBAAC,OAAA,EAAgB,WAAU,iBACzB,UAAA;AAAA,4BAAC,QAAA,EAAK,WAAU,qBAAqB,UAAA,UAAS;AAAA,4BAC7C,QAAA,EAAK,WAAU,mBAAmB,UAAA,QAAO;AAAA,MAAA,EAAA,GAFlC,KAGV,CACD;AAAA,IAAA;AAAA,EAAA;AAGP;AACA,qBAAqB,cAAc;"}

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

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

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

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

package/dist/components/AgentPanel/index.js

@@ -0,0 +1,16 @@
+import { AGENT_PANEL_WIDTH_DEFAULT, AGENT_PANEL_WIDTH_MAX, AGENT_PANEL_WIDTH_MIN, AgentConversation, AgentDecisionCard, AgentDecisionSummary, AgentMessage, AgentPanel, AgentPanelHeader, AgentPromptInput, AgentThinking, AgentToolbar } from "./agent-panel.js";
+export {
+  AGENT_PANEL_WIDTH_DEFAULT,
+  AGENT_PANEL_WIDTH_MAX,
+  AGENT_PANEL_WIDTH_MIN,
+  AgentConversation,
+  AgentDecisionCard,
+  AgentDecisionSummary,
+  AgentMessage,
+  AgentPanel,
+  AgentPanelHeader,
+  AgentPromptInput,
+  AgentThinking,
+  AgentToolbar
+};
+//# sourceMappingURL=index.js.map

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

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

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

@@ -10,13 +10,18 @@ export interface AlertProps extends Omit<React.HTMLAttributes<HTMLDivElement>, '
     title: React.ReactNode;
     description?: React.ReactNode;
     endContent?: React.ReactNode;
+    /**
+     * 顯示關閉鈕(預設 true)。**需同時傳 `onDismiss` 才會渲染 X** — Alert 是 controlled-only
+     * (不自我移除),無 handler 的 X 是死按鈕(2026-07-05 D4;對齊 Polaris Banner / Ant Alert)。
+     * 條件判斷 SSOT 在 Notice(notice.tsx `showDismiss`),Alert 原樣 forward。
+     */
     dismissible?: boolean;
     onDismiss?: () => void;
 }
 declare const Alert: React.ForwardRefExoticComponent<AlertProps & React.RefAttributes<HTMLDivElement>>;
 export declare const alertMeta: {
     readonly component: "Alert";
-    readonly family: null;
+    readonly family: 2;
     readonly variants: {
         readonly neutral: {
             readonly purpose: "中性提示(系統公告、非緊急說明);無情緒色";
@@ -35,7 +40,7 @@ export declare const alertMeta: {
         };
     };
     readonly sizes: {};
-    readonly states: readonly ["default", "hover", "active", "focus-visible", "disabled"];
+    readonly states: readonly ["default"];
     readonly tokens: {
         readonly bg: readonly ["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"];
         readonly fg: readonly ["text-foreground"];

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

@@ -1 +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"}
+{"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;AA8CzH,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;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB;AAGD,QAAA,MAAM,KAAK,mFA8FV,CAAA;AAMD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBZ,CAAA;AAEV,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAA"}

package/dist/components/Alert/alert.js

@@ -5,10 +5,10 @@ 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)]"
+  info: "bg-info-subtle border border-[var(--info-text)]",
+  success: "bg-success-subtle border border-[var(--success-text)]",
+  warning: "bg-warning-subtle border border-[var(--warning-text)]",
+  error: "bg-error-subtle border border-[var(--error-text)]"
 };
 const SOLID_HUE_BG = {
   info: "bg-info",
@@ -39,7 +39,10 @@ const Alert = React.forwardRef(
     title,
     description,
     endContent,
-    dismissible = true,
+    // 2026-07-05 D4:不 destructure-default(原 `= true` 會把「consumer 沒傳」materialize 成顯式
+    // true,讓 Notice 的 dev-warn 無法分辨消費端矛盾)。等效預設 true 由 Notice showDismiss
+    // `!== false` 承擔,行為不變;X 僅在同時傳 onDismiss 時渲染(SSOT 在 notice.tsx)。
+    dismissible,
     onDismiss,
     className,
     ...props
@@ -106,8 +109,8 @@ const Alert = React.forwardRef(
 Alert.displayName = "Alert";
 const alertMeta = {
   component: "Alert",
-  family: null,
-  // non-family composite / overlay / layout
+  family: 2,
+  // List item(對齊 alert.spec.md frontmatter family: 2)
   variants: {
     neutral: { purpose: "中性提示(系統公告、非緊急說明);無情緒色" },
     info: { purpose: "資訊性提示(版本更新、流程說明);藍色 hue" },
@@ -116,7 +119,8 @@ const alertMeta = {
     error: { purpose: "錯誤但非阻斷(系統錯誤可重試、API 失敗摘要);aria-live=assertive" }
   },
   sizes: {},
-  states: ["default", "hover", "active", "focus-visible", "disabled"],
+  states: ["default"],
+  // 2026-06-11 R2:Alert 本體無互動 state(spec L183 明文無 disabled;dismiss 互動屬內部 Button),
   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"],

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

@@ -1 +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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"}
+{"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(色相 text 色 = icon 同色,見下方 SUBTLE_CONTAINER 註)。不設 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\n// border 用 `--{hue}-text`(= icon 同色,2026-06-15 user 拍板「直接共用 hue-text,不開新 token」)。\n// 原借 `--{hue}-hover`(互動狀態 token)當靜態 border 是語意 smell + 跟 icon 不同色;\n// 改共用 hue-text(SUBTLE_ICON_COLOR 用的同一顆,blue-7 等)→ 0 新 token + border/icon cohesion。\nconst SUBTLE_CONTAINER: Record<NoticeVariant, string> = {\n  neutral: 'bg-muted border border-border',\n  info: 'bg-info-subtle border border-[var(--info-text)]',\n  success: 'bg-success-subtle border border-[var(--success-text)]',\n  warning: 'bg-warning-subtle border border-[var(--warning-text)]',\n  error: 'bg-error-subtle border border-[var(--error-text)]',\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  /**\n   * 顯示關閉鈕(預設 true)。**需同時傳 `onDismiss` 才會渲染 X** — Alert 是 controlled-only\n   * (不自我移除),無 handler 的 X 是死按鈕(2026-07-05 D4;對齊 Polaris Banner / Ant Alert)。\n   * 條件判斷 SSOT 在 Notice(notice.tsx `showDismiss`),Alert 原樣 forward。\n   */\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      // 2026-07-05 D4:不 destructure-default(原 `= true` 會把「consumer 沒傳」materialize 成顯式\n      // true,讓 Notice 的 dev-warn 無法分辨消費端矛盾)。等效預設 true 由 Notice showDismiss\n      // `!== false` 承擔,行為不變;X 僅在同時傳 onDismiss 時渲染(SSOT 在 notice.tsx)。\n      dismissible,\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: 2, // List item(對齊 alert.spec.md frontmatter family: 2)\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'], // 2026-06-11 R2:Alert 本體無互動 state(spec L183 明文無 disabled;dismiss 互動屬內部 Button),\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":";;;;;AA4BA,MAAM,mBAAkD;AAAA,EACtD,SAAS;AAAA,EACT,MAAM;AAAA,EACN,SAAS;AAAA,EACT,SAAS;AAAA,EACT,OAAO;AACT;AAEA,MAAM,eAAuC;AAAA,EAC3C,MAAM;AAAA,EACN,SAAS;AAAA,EACT,SAAS;AAAA,EACT,OAAO;AACT;AAEA,MAAM,kBAA0C;AAAA,EAC9C,MAAM;AAAA,EACN,SAAS;AAAA,EACT,SAAS;AAAA,EACT,OAAO;AACT;AAEA,MAAM,gBAAgB,IAAI,0BAA0B;AAAA,EAClD,UAAU;AAAA,IACR,WAAW;AAAA,MACT,QAAQ;AAAA,MACR,OAAO;AAAA,IAAA;AAAA,EACT;AAAA,EAEF,iBAAiB,EAAE,WAAW,SAAA;AAChC,CAAC;AAoBD,MAAM,QAAQ,MAAM;AAAA,EAClB,CACE;AAAA,IACE,UAAU;AAAA,IACV,aAAa;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA;AAAA;AAAA;AAAA,IAIA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAG;AAAA,EAAA,GAEL,QACG;AACH,UAAM,eAAe,gBAAA;AACrB,UAAM,UAAU,eAAe;AAC/B,UAAM,gBAAgB,CAAC,UAAU,kBAAkB,OAAO,IAAI;AAO9D,UAAM,aAAa,YAAY,WAAW,YAAY;AACtD,UAAM,WAAW,aAAa,UAAU;AACxC,UAAM,YAAY,aAAa,cAAc;AAK7C,UAAM,WACJ;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,WAAW,cAAc,UAAU,mCAAmC;AAAA,MAAA;AAAA,IAAA;AAK1E,QAAI,CAAC,SAAS;AACZ,aACE;AAAA,QAAC;AAAA,QAAA;AAAA,UACC;AAAA,UACA,MAAM;AAAA,UACN,aAAW;AAAA,UACX,WAAW,GAAG,cAAc,EAAE,UAAA,CAAW,GAAG,iBAAiB,OAAO,GAAG,SAAS;AAAA,UAC/E,GAAG;AAAA,UAEH,UAAA;AAAA,QAAA;AAAA,MAAA;AAAA,IAGP;AAGA,QAAI,YAAY,WAAW;AACzB,aACE;AAAA,QAAC;AAAA,QAAA;AAAA,UACC;AAAA,UACA,MAAM;AAAA,UACN,aAAW;AAAA,UACX,cAAY;AAAA,UACZ,WAAW,GAAG,cAAc,EAAE,WAAW,GAAG,qCAAqC,SAAS;AAAA,UACzF,GAAG;AAAA,UAEH,UAAA;AAAA,QAAA;AAAA,MAAA;AAAA,IAGP;AAGA,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,MAAM;AAAA,QACN,aAAW;AAAA,QACX,WAAW,GAAG,cAAc,EAAE,UAAA,CAAW,GAAG,aAAa,OAAO,GAAG,SAAS;AAAA,QAC3E,GAAG;AAAA,QAEJ,UAAA,oBAAC,SAAI,cAAY,gBAAgB,OAAO,GAAG,WAAU,mBAClD,UAAA,SAAA,CACH;AAAA,MAAA;AAAA,IAAA;AAAA,EAGN;AACF;AACA,MAAM,cAAc;AAKb,MAAM,YAAY;AAAA,EACvB,WAAW;AAAA,EACX,QAAQ;AAAA;AAAA,EACR,UAAU;AAAA,IACR,SAAS,EAAE,SAAS,wBAAA;AAAA,IACpB,MAAM,EAAE,SAAS,0BAAA;AAAA,IACjB,SAAS,EAAE,SAAS,6BAAA;AAAA,IACpB,SAAS,EAAE,SAAS,2BAAA;AAAA,IACpB,OAAO,EAAE,SAAS,+CAAA;AAAA,EAA+C;AAAA,EAEnE,OAAO,CAAA;AAAA,EACP,QAAQ,CAAC,SAAS;AAAA;AAAA,EAClB,QAAQ;AAAA,IACN,IAAI,CAAC,YAAY,mBAAmB,WAAW,kBAAkB,YAAY,cAAc,qBAAqB,qBAAqB,cAAc,mBAAmB;AAAA,IACtK,IAAI,CAAC,iBAAiB;AAAA,IACtB,MAAM,CAAA;AAAA,EAAC;AAAA,EAET,gBAAgB;AAClB;"}

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

@@ -25,10 +25,12 @@ export declare const MAIN_NAV: readonly [{
 }];
 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, }?: {
+export declare function AcmeSidebar({ viewportInsetTop, includeWorkspaceBrand, includeUserFooter, }?: {
     viewportInsetTop?: string;
     includeWorkspaceBrand?: boolean;
+    includeUserFooter?: boolean;
 }): import("react/jsx-runtime").JSX.Element;
+export declare function AccountMenu(): import("react/jsx-runtime").JSX.Element;
 export declare function GlobalHeader({ rightSlot }?: {
     rightSlot?: React.ReactNode;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -1 +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"}
+{"version":3,"file":"_demo-helpers.d.ts","sourceRoot":"","sources":["../../../src/components/AppShell/_demo-helpers.tsx"],"names":[],"mappings":"AAkDA,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;EAOX,CAAA;AAqBV,eAAO,MAAM,cAAc,+CAQ1B,CAAA;AAOD,eAAO,MAAM,UAAU,+CAkBtB,CAAA;AAQD,wBAAgB,WAAW,CAAC,EAC1B,gBAAgB,EAChB,qBAA4B,EAC5B,iBAAwB,GACzB,GAAE;IACD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,iBAAiB,CAAC,EAAE,OAAO,CAAA;CACvB,2CAwDL;AA4BD,wBAAgB,WAAW,4CAY1B;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

@@ -1,21 +1,21 @@
 /**
  * AppShell — web service page-level layout primitive。
  *
- * 組合 Sidebar + ChromeHeader + Aside + main 成完整 page shell。SSOT 邊界:本 pattern only
+ * 組合 Sidebar + ChromeHeader + Aside + main 成完整 page shell。SSOT 邊界:本 composite component 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`
+ * Spec SSOT:`components/AppShell/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 元素(應傳 Sidebar primitive,per Consumer 紀律;型別 optional 不機械強制,對齊 spec「應」措辭)*/
     sidebar?: React.ReactNode;
     /**
      * Local page header(永遠 render 在 main column 頂部,當前頁 actions / breadcrumb / page-level filter)。
@@ -62,7 +62,7 @@ declare const AppShell: React.ForwardRefExoticComponent<AppShellProps & React.Re
  * AppShellAside — right panel:standard inline(desktop) vs modal overlay(mobile)。
  *
  * Desktop(viewport ≥ 768px):
- *   - Render 直接放 layout grid 右側(asideOpen=true 才 mount,close hide via parent)
+ *   - Render 直接放 layout grid 右側(AppShell 恆 render {aside};AppShellAside 於 !asideOpen 自行 return null — 內部自決,非 via parent)
  *   - 不蓋 mask / background 可操作 / 佔 layout 寬
  *   - Vertical extent:primary-sidebar → 頂天立地 / primary-header → header 下方
  *
@@ -72,5 +72,20 @@ declare const AppShell: React.ForwardRefExoticComponent<AppShellProps & React.Re
  *   - title 強制(aria-labelledby per sheet.spec.md:98)
  */
 declare const AppShellAside: React.ForwardRefExoticComponent<AppShellAsideProps & React.RefAttributes<HTMLElement>>;
+export declare const appShellMeta: {
+    readonly component: "AppShell";
+    readonly family: "composite";
+    readonly variants: {};
+    readonly sizes: {};
+    readonly states: readonly [];
+    readonly tokens: {
+        readonly bg: readonly ["bg-canvas", "bg-surface"];
+        readonly fg: readonly ["text-foreground"];
+        readonly border: readonly ["border-divider"];
+        readonly ring: readonly ["ring-primary"];
+    };
+    readonly defaultVariant: undefined;
+    readonly defaultSize: undefined;
+};
 export { AppShell, AppShellAside, useAppShell };
 //# sourceMappingURL=app-shell.d.ts.map

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

@@ -1 +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"}
+{"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;AAgB9B,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,qFAAqF;IACrF,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;AAiED,QAAA,MAAM,QAAQ,sFAiIb,CAAA;AAKD;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,aAAa,wFA6FlB,CAAA;AAQD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;CAcf,CAAA;AAKV,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA"}

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

@@ -1,7 +1,7 @@
 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 { Sheet, SheetContent, handleSheetOpenAutoFocus, SheetTitle } 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";
@@ -41,7 +41,7 @@ function resolveAsideWidth(width, isXl) {
   return ASIDE_WIDTH_DEFAULT;
 }
 function SkipToMain() {
-  return /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx("nav", { "aria-label": "Skip links", children: /* @__PURE__ */ jsx(
     "a",
     {
       href: "#app-shell-main",
@@ -54,7 +54,7 @@ function SkipToMain() {
       ),
       children: "Skip to main content"
     }
-  );
+  ) });
 }
 const AppShell = React.forwardRef(
   ({
@@ -134,9 +134,10 @@ const AppShell = React.forwardRef(
           /* @__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。
+            header && // Header 在 main column 內(main col sibling,非 main descendant)。ChromeHeader 自
+            // 2026-05-20 起 render `<header>`(chrome-header.tsx);依 W3C HTML-AAM,`<div>` wrapper
+            // 不 scope out banner(只有 main/article/aside/nav/section 能)→ 仍得 implicit banner ✓
+            // (對齊 app-shell.spec.md「W3C ARIA in HTML banner rule」段)。
             /* @__PURE__ */ jsx("div", { className: "flex-shrink-0", children: header }),
             /* @__PURE__ */ jsx(
               "main",
@@ -160,9 +161,10 @@ const AppShellAside = React.forwardRef(
     const { asideOpen, setAsideOpen, isMobile } = useAppShell();
     const isXl = useIsXl();
     const resolvedWidth = resolveAsideWidth(width, isXl);
-    const frame = /* @__PURE__ */ jsxs(Fragment, { children: [
+    const asideOpenerRef = React.useRef(null);
+    const renderFrame = (titleNode) => /* @__PURE__ */ jsxs(Fragment, { children: [
       /* @__PURE__ */ jsxs(ChromeHeader, { children: [
-        /* @__PURE__ */ jsx("h2", { className: "text-body-lg font-medium flex-1 truncate", children: title }),
+        titleNode,
         /* @__PURE__ */ jsx(
           Button,
           {
@@ -181,10 +183,29 @@ const AppShellAside = React.forwardRef(
       return /* @__PURE__ */ jsx(Sheet, { open: asideOpen, onOpenChange: setAsideOpen, children: /* @__PURE__ */ jsx(
         SheetContent,
         {
+          ref,
           side: "right",
-          className: "w-[min(90vw,var(--app-shell-aside-modal-width))] flex flex-col p-0 [&>button]:hidden",
+          onOpenAutoFocus: (e) => {
+            asideOpenerRef.current = document.activeElement instanceof HTMLElement ? document.activeElement : null;
+            handleSheetOpenAutoFocus(e);
+          },
+          onCloseAutoFocus: (e) => {
+            var _a;
+            e.preventDefault();
+            const opener = asideOpenerRef.current;
+            asideOpenerRef.current = null;
+            if (opener == null ? void 0 : opener.isConnected) {
+              opener.focus({ preventScroll: true });
+              return;
+            }
+            (_a = document.getElementById("app-shell-main")) == null ? void 0 : _a.focus({ preventScroll: true });
+          },
+          className: cn(
+            "w-[min(90vw,var(--app-shell-aside-modal-width))] flex flex-col p-0 [&>button]:hidden",
+            className
+          ),
           style: { ["--app-shell-aside-modal-width"]: `${resolvedWidth}px` },
-          children: frame
+          children: renderFrame(/* @__PURE__ */ jsx(SheetTitle, { className: "flex-1", children: title }))
         }
       ) });
     }
@@ -200,15 +221,31 @@ const AppShellAside = React.forwardRef(
           className
         ),
         style: { width: resolvedWidth },
-        children: frame
+        children: renderFrame(/* @__PURE__ */ jsx("h2", { className: "text-body-lg font-medium flex-1 truncate", children: title }))
       }
     );
   }
 );
 AppShellAside.displayName = "AppShellAside";
+const appShellMeta = {
+  component: "AppShell",
+  family: "composite",
+  variants: {},
+  sizes: {},
+  states: [],
+  tokens: {
+    bg: ["bg-canvas", "bg-surface"],
+    fg: ["text-foreground"],
+    border: ["border-divider"],
+    ring: ["ring-primary"]
+  },
+  defaultVariant: void 0,
+  defaultSize: void 0
+};
 export {
   AppShell,
   AppShellAside,
+  appShellMeta,
   useAppShell
 };
 //# sourceMappingURL=app-shell.js.map