npm - @qijenchen/design-system - Versions diffs - 0.1.0-beta.13 → 0.1.0-beta.130 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1751) hide show

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

@@ -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);開合 --motion-duration-surface。\n * - 標題列:ChromeHeader(header-canonical;chrome 內控件一律 sm);品牌區=gap-2+24 標誌;\n * chevron=ItemInlineActionButton(item-anatomy);ButtonDivider 於 gap-2 cluster(action-bar 規則 3)。\n * - 歷史浮層:Popover+Command+MenuItem(SelectMenu 同源 primitives;metrics 同 select-menu.tsx);\n * 行內動作=ItemInlineAction(inline-action canonical);思考列=CircularProgress 16。\n * - 訊息:氣泡 bg-secondary/rounded-md/8/12;附件=Chip assist 分支(chip.spec.md);\n * 輪距 40=8+24(Button text xs)+8。\n * - 思考塊:Radix Collapsible+animate-accordion(base.css;Sidebar 同法);\n * 微光=shadcn shimmer 參數(agent-panel.css;--motion-duration-shimmer)。\n * - 輸入盒:欄位家族內距(--field-control-py-md/--field-px/text-body;32 等高鐵律);\n * 附件列=Tag md+OverflowIndicator;送出/停止=Button primary xs。\n * - 決策卡:SurfaceHeader(compact 45)+SurfaceFooter(overlay-surface);RadioGroup md\n * (Popover all-sm 律之拍板豁免;footer 鈕 sm 守律);淡入+下滑 --motion-duration-overlay。\n * - 改名/刪除:Dialog(header md+X;body Field+Input;footer md 鈕;刪除=primary+danger;\n * form-validation 更新類規則)。\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 ArrowUp,\n ChevronDown,\n Copy,\n MessageSquare,\n Pencil,\n Plus,\n Square,\n ThumbsDown,\n ThumbsUp,\n Trash2,\n X as XIcon,\n} from 'lucide-react'\nimport { cn } from '@/lib/utils'\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} from '@/design-system/components/Command/command'\nimport { MenuItem } from '@/design-system/components/Menu/menu-item'\nimport { ItemInlineAction } from '@/design-system/patterns/element-anatomy/item-anatomy'\nimport { CircularProgress } from '@/design-system/components/CircularProgress/circular-progress'\nimport { RadioGroup, RadioGroupItem } from '@/design-system/components/RadioGroup/radio-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 { Field, FieldLabel } 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\nexport interface AgentPanelProps extends React.HTMLAttributes<HTMLDivElement> {\n /** 面板開合;false 時不渲染。 */\n open?: boolean\n}\n\nconst AgentPanel = React.forwardRef<HTMLDivElement, AgentPanelProps>(\n ({ open = true, className, children, ...props }, ref) => {\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 w-[var(--agent-panel-width)] 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 {...props}\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 /** 歷史對話清單;省略=不顯示 chevron。 */\n conversations?: AgentConversationSummary[]\n /** 目前對話 id(歷史清單高亮)。 */\n activeConversationId?: string\n onSelectConversation?: (id: string) => void\n /** 改名確認(Dialog 流程由元件內建)。 */\n onRenameConversation?: (id: string, title: string) => void\n /** 刪除確認(Dialog 流程由元件內建)。 */\n onDeleteConversation?: (id: string) => void\n onNewConversation?: () => void\n onClose?: () => void\n}\n\n/** 歷史列: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 const actions = (onRename || onDelete) && (\n <span\n className={cn(\n 'hidden items-center group-hover/agent-history:flex group-focus-within/agent-history:flex',\n 'animate-in fade-in-0 duration-[var(--motion-duration-overlay)]',\n )}\n >\n {onRename && (\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 )}\n {onDelete && (\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 )}\n </span>\n )\n return (\n <CommandItem\n value={`${conversation.title}\u0000${conversation.id}`}\n onSelect={onSelect}\n className=\"group/agent-history p-0\"\n >\n <MenuItem\n selected={selected}\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={actions}\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 onSelectConversation,\n onRenameConversation,\n onDeleteConversation,\n onNewConversation,\n onClose,\n className,\n ...props\n },\n ref,\n ) => {\n const [historyOpen, setHistoryOpen] = React.useState(false)\n const [renameTarget, setRenameTarget] = React.useState<AgentConversationSummary | null>(null)\n const [deleteTarget, setDeleteTarget] = React.useState<AgentConversationSummary | null>(null)\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 <span className=\"truncate text-body-lg font-medium\">{title}</span>\n {conversations && (\n <Popover open={historyOpen} onOpenChange={setHistoryOpen}>\n <PopoverTrigger asChild>\n <ItemInlineAction\n action={{ icon: ChevronDown, label: '歷史對話', onClick: () => {} }} // i18n-allow: DS 預設文案(Dialog「關閉」同前例)\n aria-haspopup=\"menu\"\n aria-expanded={historyOpen}\n />\n </PopoverTrigger>\n <PopoverContent\n align=\"start\"\n sideOffset={8}\n className=\"w-auto min-w-60 overflow-hidden rounded-lg border-border p-0\"\n style={{ boxShadow: 'var(--elevation-200)' }}\n >\n <Command>\n <CommandInput\n placeholder={historySearchPlaceholder}\n aria-label={historySearchPlaceholder}\n />\n <CommandList>\n <CommandEmpty>{historyEmptyText}</CommandEmpty>\n {groups.map(({ label, items }) => (\n <CommandGroup key={label || '(未分組)'} className=\"p-0 py-2\"> // i18n-allow: DS 預設文案(Dialog「關閉」同前例)\n {label && <MenuItem header>{label}</MenuItem>}\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={\n onRenameConversation\n ? () => setRenameTarget(conversation)\n : undefined\n }\n onDelete={\n onDeleteConversation\n ? () => setDeleteTarget(conversation)\n : undefined\n }\n />\n ))}\n </CommandGroup>\n ))}\n </CommandList>\n </Command>\n </PopoverContent>\n </Popover>\n )}\n </div>\n <div className=\"flex items-center gap-2\">\n {onNewConversation && (\n <Button\n variant=\"text\"\n size=\"sm\"\n iconOnly\n startIcon={Plus}\n aria-label=\"新對話\" // i18n-allow: DS 預設文案(Dialog「關閉」同前例)\n onClick={onNewConversation}\n />\n )}\n {onClose && (\n <>\n {onNewConversation && <ButtonDivider />}\n <Button dismiss size=\"sm\" startIcon={XIcon} aria-label=\"關閉面板\" onClick={onClose} />\n </>\n )}\n </div>\n {renameTarget && (\n <AgentRenameDialog\n conversation={renameTarget}\n onOpenChange={(next) => !next && setRenameTarget(null)}\n onConfirm={(nextTitle) => {\n onRenameConversation?.(renameTarget.id, nextTitle)\n setRenameTarget(null)\n }}\n />\n )}\n {deleteTarget && (\n <Dialog open onOpenChange={(next) => !next && setDeleteTarget(null)}>\n <DialogContent>\n <DialogHeader>\n <DialogTitle>刪除對話</DialogTitle> // i18n-allow: DS 預設文案(Dialog「關閉」同前例)\n </DialogHeader>\n <DialogBody>\n 確定刪除「{deleteTarget.title}」?此動作立即生效且不可復原。\n </DialogBody>\n <DialogFooter>\n <Button variant=\"tertiary\" onClick={() => setDeleteTarget(null)}>\n 取消\n </Button>\n <Button\n variant=\"primary\"\n danger\n onClick={() => {\n onDeleteConversation?.(deleteTarget.id)\n setDeleteTarget(null)\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 規則;Enter=blur、Esc=回復。 */\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 dirty = value !== conversation.title\n return (\n <Dialog open onOpenChange={onOpenChange}>\n <DialogContent>\n <DialogHeader>\n <DialogTitle>改名對話</DialogTitle> // i18n-allow: DS 預設文案(Dialog「關閉」同前例)\n </DialogHeader>\n <DialogBody>\n <Field>\n <FieldLabel>名稱</FieldLabel>\n <Input\n autoFocus\n value={value}\n onChange={(e) => setValue(e.target.value)}\n onFocus={(e) => e.currentTarget.select()}\n onKeyDown={(e) => {\n // form-validation:Enter=等同 blur;Esc=回復原值不觸發驗證。\n if (e.key === 'Enter') e.currentTarget.blur()\n if (e.key === 'Escape') {\n e.stopPropagation()\n setValue(conversation.title)\n }\n }}\n />\n </Field>\n </DialogBody>\n <DialogFooter>\n <Button variant=\"tertiary\" onClick={() => onOpenChange(false)}>\n 取消\n </Button>\n <Button variant=\"primary\" disabled={!dirty} onClick={() => onConfirm(value)}>\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 <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 /** 已完成的步驟(靜態)。 */\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 <ChevronDown\n size={16}\n aria-hidden\n className=\"transition-transform duration-150 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 <div className=\"mt-2 flex flex-col gap-1 border-l border-divider pl-3 text-fg-muted\">\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(訊息工具列)\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 {onCopy && (\n <Button variant=\"text\" size=\"xs\" iconOnly startIcon={Copy} aria-label=\"複製\" onClick={onCopy} />\n )}\n {onCopy && (onLike || onDislike) && <ButtonDivider />}\n {onLike && (\n <Button variant=\"text\" size=\"xs\" iconOnly startIcon={ThumbsUp} aria-label=\"讚\" onClick={onLike} />\n )}\n {onDislike && (\n <Button\n variant=\"text\"\n size=\"xs\"\n iconOnly\n startIcon={ThumbsDown}\n aria-label=\"倒讚\"\n onClick={onDislike}\n />\n )}\n {children}\n </div>\n ),\n)\nAgentToolbar.displayName = 'AgentToolbar'\n\n/* ────────────────────────────────────────────────────────────────────────────\n * 7. AgentPromptInput(複合輸入盒)\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 onSubmit?: () => void\n /** 代理進行中:送出鈕同位換停止(實心正方),0.15s 淡切。 */\n busy?: boolean\n onStop?: () => void\n /** 輸入中附件(Tag md,可移除;送出後於訊息內轉 Chip assist 視覺)。 */\n attachments?: AgentPromptAttachment[]\n onRemoveAttachment?: (attachment: AgentPromptAttachment) => void\n onAddAttachment?: () => void\n placeholder?: string\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-150',\n className,\n )}\n {...props}\n >\n {attachments && attachments.length > 0 && (\n // 附件列:Tag 相互間距 4、距內緣 4(28 高)。\n <div className=\"flex flex-wrap items-center gap-1 px-1 pt-1\">\n {attachments.map((attachment) => (\n <Tag\n key={attachment.id}\n size=\"md\"\n onRemove={\n onRemoveAttachment ? () => onRemoveAttachment(attachment) : undefined\n }\n >\n {attachment.label}\n </Tag>\n ))}\n </div>\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 <div className=\"flex items-center\">\n {onAddAttachment && (\n <Button\n variant=\"text\"\n size=\"xs\"\n iconOnly\n startIcon={Plus}\n aria-label=\"新增附件\"\n onClick={onAddAttachment}\n />\n )}\n </div>\n {busy ? (\n <Button\n variant=\"primary\"\n size=\"xs\"\n iconOnly\n startIcon={Square}\n aria-label=\"停止生成\"\n onClick={onStop}\n className=\"animate-in fade-in-0 duration-[var(--motion-duration-overlay)] [&_svg]:fill-current\"\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 label: string\n description?: string\n}\n\nexport interface AgentDecisionQuestion {\n id: string\n label: string\n /** 2-4 具名選項;Other 自由輸入由元件必備附加。 */\n options: AgentDecisionOption[]\n /** 預選最佳解。 */\n defaultValue?: string\n}\n\nexport interface AgentDecisionCardProps\n extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onSubmit' | 'title'> {\n title: string\n /** ≤3 題;一題一問。 */\n questions: AgentDecisionQuestion[]\n /** 送出:answers[questionId] = 選項值或 Other 文字。 */\n onSubmit?: (answers: Record<string, string>) => void\n /** 跳過(Skip 鈕與 header × 同一行為=單一語意雙入口)。 */\n onSkip?: () => void\n}\n\nconst OTHER_VALUE = '__agent_decision_other__'\n\nconst AgentDecisionCard = React.forwardRef<HTMLDivElement, AgentDecisionCardProps>(\n ({ title, questions, onSubmit, onSkip, className, ...props }, ref) => {\n const titleId = React.useId()\n if (import.meta.env?.DEV && questions.length > 3) {\n console.warn('[AgentDecisionCard] 表單指引為 ≤3 題(agent-panel.spec.md)。')\n }\n const [answers, setAnswers] = React.useState<Record<string, string>>(() =>\n Object.fromEntries(\n questions\n .filter((q) => q.defaultValue !== undefined)\n .map((q) => [q.id, q.defaultValue as string]),\n ),\n )\n const [otherText, setOtherText] = React.useState<Record<string, string>>({})\n const resolvedAnswers = () =>\n Object.fromEntries(\n questions\n .map((q) => {\n const selected = answers[q.id]\n if (selected === OTHER_VALUE) return [q.id, otherText[q.id] ?? '']\n return [q.id, selected]\n })\n .filter(([, v]) => v !== undefined),\n ) as Record<string, string>\n\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 {/* compact header 45(COMPACT_HEADER_SLOT);改寫:header 下無分隔線。 */}\n <SurfaceHeader className={cn(COMPACT_HEADER_SLOT, 'justify-between border-b-0')}>\n <span id={titleId} className=\"truncate text-body font-medium\">\n {title}\n </span>\n <Button dismiss size=\"sm\" startIcon={XIcon} aria-label=\"跳過\" onClick={onSkip} />\n </SurfaceHeader>\n {/* 改寫:body 無內距(選項列自帶 px);捲軸必用 ScrollArea。 */}\n <ScrollArea fillX className=\"min-h-0\">\n {questions.map((question) => (\n <RadioGroup\n key={question.id}\n value={answers[question.id] ?? ''}\n onValueChange={(next) =>\n setAnswers((prev) => ({ ...prev, [question.id]: next }))\n }\n aria-label={question.label}\n className=\"px-[var(--layout-space-loose)] py-[var(--layout-space-tight)]\"\n >\n {questions.length > 1 && (\n <div className=\"text-body font-medium\">{question.label}</div>\n )}\n {question.options.map((option) => (\n <RadioGroupItem\n key={option.value}\n value={option.value}\n size=\"md\"\n label={option.label}\n description={option.description}\n />\n ))}\n <RadioGroupItem value={OTHER_VALUE} size=\"md\" label=\"其他\" />\n {answers[question.id] === OTHER_VALUE && (\n // Other 輸入:右/下各 12 對稱。\n <div className=\"pb-3 pl-6 pr-3\">\n <Input\n autoFocus\n value={otherText[question.id] ?? ''}\n onChange={(e) =>\n setOtherText((prev) => ({ ...prev, [question.id]: e.target.value }))\n }\n aria-label=\"其他(自由輸入)\"\n />\n </div>\n )}\n </RadioGroup>\n ))}\n </ScrollArea>\n {/* 改寫:footer 上無分隔線;鈕 sm 守 Popover all-sm 律。 */}\n <SurfaceFooter className=\"border-t-0\">\n <Button variant=\"tertiary\" size=\"sm\" onClick={onSkip}>\n 跳過\n </Button>\n <Button\n variant=\"primary\"\n size=\"sm\"\n onClick={() => onSubmit?.(resolvedAnswers())}\n >\n 送出\n </Button>\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}\n"],"names":["XIcon"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA0FA,MAAM,aAAa,MAAM;AAAA,EACvB,CAAC,EAAE,OAAO,MAAM,WAAW,UAAU,GAAG,MAAA,GAAS,QAAQ;AACvD,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,QAED,GAAG;AAAA,QAEH;AAAA,MAAA;AAAA,IAAA;AAAA,EAGP;AACF;AACA,WAAW,cAAc;AAuCzB,SAAS,WAAW;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAMG;AACD,QAAM,WAAW,YAAY,aAC3B;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MAAA;AAAA,MAGD,UAAA;AAAA,QAAA,YACC;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,QAAQ;AAAA,cACN,MAAM;AAAA,cACN,OAAO;AAAA;AAAA,cACP,SAAS,CAAC,MAAM;AACd,uCAAG;AACH,yBAAA;AAAA,cACF;AAAA,YAAA;AAAA,UACF;AAAA,QAAA;AAAA,QAGH,YACC;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,QAAQ;AAAA,cACN,MAAM;AAAA,cACN,OAAO;AAAA;AAAA,cACP,SAAS,CAAC,MAAM;AACd,uCAAG;AACH,yBAAA;AAAA,cACF;AAAA,YAAA;AAAA,UACF;AAAA,QAAA;AAAA,MACF;AAAA,IAAA;AAAA,EAAA;AAIN,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,OAAO,GAAG,aAAa,KAAK,KAAI,aAAa,EAAE;AAAA,MAC/C;AAAA,MACA,WAAU;AAAA,MAEV,UAAA;AAAA,QAAC;AAAA,QAAA;AAAA,UACC;AAAA,UACA,cACE,aAAa,WACX,oBAAC,kBAAA,EAAiB,MAAM,IAAI,cAAW,MAAA,CAAM,wBAE5C,eAAA,EAAc,MAAM,IAAI,eAAW,MAAC,WAAU,iBAAgB;AAAA,UAGnE,YAAY;AAAA,UAEX,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;AAAA,IACA;AAAA,IACA;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,KAAK;AAC1D,UAAM,CAAC,cAAc,eAAe,IAAI,MAAM,SAA0C,IAAI;AAC5F,UAAM,CAAC,cAAc,eAAe,IAAI,MAAM,SAA0C,IAAI;AAE5F,UAAM,SAAS,MAAM,QAAQ,MAAM;AACjC,YAAM,QAAkB,CAAA;AACxB,YAAM,8BAAc,IAAA;AACpB,iBAAW,QAAQ,iBAAiB,IAAI;AACtC,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,4BACtC,QAAA,EAAK,WAAU,qCAAqC,UAAA,OAAM;AAAA,QAC1D,sCACE,SAAA,EAAQ,MAAM,aAAa,cAAc,gBACxC,UAAA;AAAA,UAAA,oBAAC,gBAAA,EAAe,SAAO,MACrB,UAAA;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,QAAQ,EAAE,MAAM,aAAa,OAAO,QAAQ,SAAS,MAAM;AAAA,cAAC,EAAA;AAAA,cAC5D,iBAAc;AAAA,cACd,iBAAe;AAAA,YAAA;AAAA,UAAA,GAEnB;AAAA,UACA;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,OAAM;AAAA,cACN,YAAY;AAAA,cACZ,WAAU;AAAA,cACV,OAAO,EAAE,WAAW,uBAAA;AAAA,cAEpB,+BAAC,SAAA,EACC,UAAA;AAAA,gBAAA;AAAA,kBAAC;AAAA,kBAAA;AAAA,oBACC,aAAa;AAAA,oBACb,cAAY;AAAA,kBAAA;AAAA,gBAAA;AAAA,qCAEb,aAAA,EACC,UAAA;AAAA,kBAAA,oBAAC,gBAAc,UAAA,kBAAiB;AAAA,kBAC/B,OAAO,IAAI,CAAC,EAAE,OAAO,MAAA,MACpB,qBAAC,cAAA,EAAoC,WAAU,YAAW,UAAA;AAAA,oBAAA;AAAA,oBACvD,6BAAU,UAAA,EAAS,QAAM,MAAE,UAAA,OAAM;AAAA,oBACjC,MAAM,IAAI,CAAC,iBACV;AAAA,sBAAC;AAAA,sBAAA;AAAA,wBAEC;AAAA,wBACA,UAAU,aAAa,OAAO;AAAA,wBAC9B,UAAU,MAAM;AACd,uFAAuB,aAAa;AACpC,yCAAe,KAAK;AAAA,wBACtB;AAAA,wBACA,UACE,uBACI,MAAM,gBAAgB,YAAY,IAClC;AAAA,wBAEN,UACE,uBACI,MAAM,gBAAgB,YAAY,IAClC;AAAA,sBAAA;AAAA,sBAfD,aAAa;AAAA,oBAAA,CAkBrB;AAAA,kBAAA,EAAA,GAtBgB,SAAS,OAuB5B,CACD;AAAA,gBAAA,GACH;AAAA,cAAA,GACF;AAAA,YAAA;AAAA,UAAA;AAAA,QACF,GACF;AAAA,MAAA,GAEJ;AAAA,MACA,qBAAC,OAAA,EAAI,WAAU,2BACZ,UAAA;AAAA,QAAA,qBACC;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,SAAQ;AAAA,YACR,MAAK;AAAA,YACL,UAAQ;AAAA,YACR,WAAW;AAAA,YACX,cAAW;AAAA,YACX,SAAS;AAAA,UAAA;AAAA,QAAA;AAAA,QAGZ,WACC,qBAAA,UAAA,EACG,UAAA;AAAA,UAAA,yCAAsB,eAAA,EAAc;AAAA,UACrC,oBAAC,QAAA,EAAO,SAAO,MAAC,MAAK,MAAK,WAAWA,GAAO,cAAW,QAAO,SAAS,SAAS;AAAA,QAAA,GAClF;AAAA,MAAA,GAEJ;AAAA,MACC,gBACC;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,cAAc;AAAA,UACd,cAAc,CAAC,SAAS,CAAC,QAAQ,gBAAgB,IAAI;AAAA,UACrD,WAAW,CAAC,cAAc;AACxB,yEAAuB,aAAa,IAAI;AACxC,4BAAgB,IAAI;AAAA,UACtB;AAAA,QAAA;AAAA,MAAA;AAAA,MAGH,gBACC,oBAAC,QAAA,EAAO,MAAI,MAAC,cAAc,CAAC,SAAS,CAAC,QAAQ,gBAAgB,IAAI,GAChE,+BAAC,eAAA,EACC,UAAA;AAAA,QAAA,qBAAC,cAAA,EACC,UAAA;AAAA,UAAA,oBAAC,eAAY,UAAA,QAAI;AAAA,UAAc;AAAA,QAAA,GACjC;AAAA,6BACC,YAAA,EAAW,UAAA;AAAA,UAAA;AAAA,UACJ,aAAa;AAAA,UAAM;AAAA,QAAA,GAC3B;AAAA,6BACC,cAAA,EACC,UAAA;AAAA,UAAA,oBAAC,QAAA,EAAO,SAAQ,YAAW,SAAS,MAAM,gBAAgB,IAAI,GAAG,UAAA,KAAA,CAEjE;AAAA,UACA;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,SAAQ;AAAA,cACR,QAAM;AAAA,cACN,SAAS,MAAM;AACb,6EAAuB,aAAa;AACpC,gCAAgB,IAAI;AAAA,cACtB;AAAA,cACD,UAAA;AAAA,YAAA;AAAA,UAAA;AAAA,QAED,GACF;AAAA,MAAA,EAAA,CACF,EAAA,CACF;AAAA,IAAA,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,QAAQ,UAAU,aAAa;AACrC,6BACG,QAAA,EAAO,MAAI,MAAC,cACX,+BAAC,eAAA,EACC,UAAA;AAAA,IAAA,qBAAC,cAAA,EACC,UAAA;AAAA,MAAA,oBAAC,eAAY,UAAA,QAAI;AAAA,MAAc;AAAA,IAAA,GACjC;AAAA,wBACC,YAAA,EACC,UAAA,qBAAC,OAAA,EACC,UAAA;AAAA,MAAA,oBAAC,cAAW,UAAA,MAAE;AAAA,MACd;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,WAAS;AAAA,UACT;AAAA,UACA,UAAU,CAAC,MAAM,SAAS,EAAE,OAAO,KAAK;AAAA,UACxC,SAAS,CAAC,MAAM,EAAE,cAAc,OAAA;AAAA,UAChC,WAAW,CAAC,MAAM;AAEhB,gBAAI,EAAE,QAAQ,QAAS,GAAE,cAAc,KAAA;AACvC,gBAAI,EAAE,QAAQ,UAAU;AACtB,gBAAE,gBAAA;AACF,uBAAS,aAAa,KAAK;AAAA,YAC7B;AAAA,UACF;AAAA,QAAA;AAAA,MAAA;AAAA,IACF,EAAA,CACF,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,QAAA,EAAO,SAAQ,WAAU,UAAU,CAAC,OAAO,SAAS,MAAM,UAAU,KAAK,GAAG,UAAA,MAE7E;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,KACnC,oBAAC,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,gBACA;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,cAEV,UAAA,qBAAC,OAAA,EAAI,WAAU,uEACZ,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,MAEH,UAAA;AAAA,QAAA,UACC,oBAAC,QAAA,EAAO,SAAQ,QAAO,MAAK,MAAK,UAAQ,MAAC,WAAW,MAAM,cAAW,MAAK,SAAS,QAAQ;AAAA,QAE7F,WAAW,UAAU,cAAc,oBAAC,eAAA,CAAA,CAAc;AAAA,QAClD,UACC,oBAAC,QAAA,EAAO,SAAQ,QAAO,MAAK,MAAK,UAAQ,MAAC,WAAW,UAAU,cAAW,KAAI,SAAS,QAAQ;AAAA,QAEhG,aACC;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,SAAQ;AAAA,YACR,MAAK;AAAA,YACL,UAAQ;AAAA,YACR,WAAW;AAAA,YACX,cAAW;AAAA,YACX,SAAS;AAAA,UAAA;AAAA,QAAA;AAAA,QAGZ;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAGP;AACA,aAAa,cAAc;AA0B3B,MAAM,mBAAmB,MAAM;AAAA,EAC7B,CACE;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA;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;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,eAAe,YAAY,SAAS;AAAA,8BAElC,OAAA,EAAI,WAAU,+CACZ,UAAA,YAAY,IAAI,CAAC,eAChB;AAAA,YAAC;AAAA,YAAA;AAAA,cAEC,MAAK;AAAA,cACL,UACE,qBAAqB,MAAM,mBAAmB,UAAU,IAAI;AAAA,cAG7D,UAAA,WAAW;AAAA,YAAA;AAAA,YANP,WAAW;AAAA,UAAA,CAQnB,GACH;AAAA,UAEF;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,gCAAC,OAAA,EAAI,WAAU,qBACZ,UAAA,mBACC;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,GAGf;AAAA,YACC,OACC;AAAA,cAAC;AAAA,cAAA;AAAA,gBACC,SAAQ;AAAA,gBACR,MAAK;AAAA,gBACL,UAAQ;AAAA,gBACR,WAAW;AAAA,gBACX,cAAW;AAAA,gBACX,SAAS;AAAA,gBACT,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;AAgC/B,MAAM,cAAc;AAEpB,MAAM,oBAAoB,MAAM;AAAA,EAC9B,CAAC,EAAE,OAAO,WAAW,UAAU,QAAQ,WAAW,GAAG,MAAA,GAAS,QAAQ;AACpE,UAAM,UAAU,MAAM,MAAA;AAItB,UAAM,CAAC,SAAS,UAAU,IAAI,MAAM;AAAA,MAAiC,MACnE,OAAO;AAAA,QACL,UACG,OAAO,CAAC,MAAM,EAAE,iBAAiB,MAAS,EAC1C,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,YAAsB,CAAC;AAAA,MAAA;AAAA,IAChD;AAEF,UAAM,CAAC,WAAW,YAAY,IAAI,MAAM,SAAiC,CAAA,CAAE;AAC3E,UAAM,kBAAkB,MACtB,OAAO;AAAA,MACL,UACG,IAAI,CAAC,MAAM;AACV,cAAM,WAAW,QAAQ,EAAE,EAAE;AAC7B,YAAI,aAAa,YAAa,QAAO,CAAC,EAAE,IAAI,UAAU,EAAE,EAAE,KAAK,EAAE;AACjE,eAAO,CAAC,EAAE,IAAI,QAAQ;AAAA,MACxB,CAAC,EACA,OAAO,CAAC,CAAA,EAAG,CAAC,MAAM,MAAM,MAAS;AAAA,IAAA;AAGxC,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,4BAA4B,GAC5E,UAAA;AAAA,YAAA,oBAAC,QAAA,EAAK,IAAI,SAAS,WAAU,kCAC1B,UAAA,OACH;AAAA,YACA,oBAAC,QAAA,EAAO,SAAO,MAAC,MAAK,MAAK,WAAWA,GAAO,cAAW,MAAK,SAAS,QAAQ;AAAA,UAAA,GAC/E;AAAA,UAEA,oBAAC,cAAW,OAAK,MAAC,WAAU,WACzB,UAAA,UAAU,IAAI,CAAC,aACd;AAAA,YAAC;AAAA,YAAA;AAAA,cAEC,OAAO,QAAQ,SAAS,EAAE,KAAK;AAAA,cAC/B,eAAe,CAAC,SACd,WAAW,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,GAAG,OAAO;AAAA,cAEzD,cAAY,SAAS;AAAA,cACrB,WAAU;AAAA,cAET,UAAA;AAAA,gBAAA,UAAU,SAAS,KAClB,oBAAC,SAAI,WAAU,yBAAyB,mBAAS,MAAA,CAAM;AAAA,gBAExD,SAAS,QAAQ,IAAI,CAAC,WACrB;AAAA,kBAAC;AAAA,kBAAA;AAAA,oBAEC,OAAO,OAAO;AAAA,oBACd,MAAK;AAAA,oBACL,OAAO,OAAO;AAAA,oBACd,aAAa,OAAO;AAAA,kBAAA;AAAA,kBAJf,OAAO;AAAA,gBAAA,CAMf;AAAA,oCACA,gBAAA,EAAe,OAAO,aAAa,MAAK,MAAK,OAAM,MAAK;AAAA,gBACxD,QAAQ,SAAS,EAAE,MAAM;AAAA,gBAExB,oBAAC,OAAA,EAAI,WAAU,kBACb,UAAA;AAAA,kBAAC;AAAA,kBAAA;AAAA,oBACC,WAAS;AAAA,oBACT,OAAO,UAAU,SAAS,EAAE,KAAK;AAAA,oBACjC,UAAU,CAAC,MACT,aAAa,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,QAAQ;AAAA,oBAErE,cAAW;AAAA,kBAAA;AAAA,gBAAA,GAEf;AAAA,cAAA;AAAA,YAAA;AAAA,YAhCG,SAAS;AAAA,UAAA,CAmCjB,GACH;AAAA,UAEA,qBAAC,eAAA,EAAc,WAAU,cACvB,UAAA;AAAA,YAAA,oBAAC,UAAO,SAAQ,YAAW,MAAK,MAAK,SAAS,QAAQ,UAAA,KAAA,CAEtD;AAAA,YACA;AAAA,cAAC;AAAA,cAAA;AAAA,gBACC,SAAQ;AAAA,gBACR,MAAK;AAAA,gBACL,SAAS,MAAM,qCAAW;gBAC3B,UAAA;AAAA,cAAA;AAAA,YAAA;AAAA,UAED,GACF;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 ADDED Viewed

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

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

	@@ -0,0 +1 @@
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 ADDED Viewed

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

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

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

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

@@ -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 CHANGED Viewed

	@@ -1 +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"}
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;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 CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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":";;;;;~~AAyBA~~,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;~~AAeD~~,MAAM,QAAQ,MAAM;AAAA,EAClB,CACE;AAAA,IACE,UAAU;AAAA,IACV,aAAa;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,~~IACA,cAAc~~;AAAA,~~IACd~~;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,~~WAAW,~~SAAS~~,UAAU,iBAAiB,UAAU~~;AAAA,~~EAClE~~,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;"}
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(色相 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":"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"}

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

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

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

	@@ -0,0 +1 @@
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 ADDED Viewed

@@ -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 ADDED Viewed

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

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

@@ -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 CHANGED Viewed

	@@ -1 +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"}
1	+ {"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 CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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"}
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;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 CHANGED Viewed

@@ -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