@qijenchen/design-system 0.1.0-beta.10

package/dist/components/Tabs/tabs.js

@@ -0,0 +1,316 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import * as TabsPrimitive from "@radix-ui/react-tabs";
+import { cva } from "class-variance-authority";
+import { cn } from "../../lib/utils.js";
+import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem } from "../DropdownMenu/dropdown-menu.js";
+import { useScrollByPage, buildFadeMask, ARROW_BUTTON_WIDTH, OverflowScrollArrow, OverflowMenuTriggerButton } from "../../patterns/horizontal-overflow/horizontal-overflow.js";
+import { ICON_SIZE } from "../../patterns/element-anatomy/item-anatomy.js";
+import { useScrollEdges } from "../../hooks/use-overflow-items.js";
+const TabsContext = React.createContext({ size: "md" });
+const TabsValueContext = React.createContext({});
+const Tabs = React.forwardRef(({ value, onValueChange, defaultValue, children, ...props }, ref) => {
+  const [internalValue, setInternalValue] = React.useState(defaultValue);
+  const isControlled = value !== void 0;
+  const currentValue = isControlled ? value : internalValue;
+  const handleValueChange = React.useCallback(
+    (next) => {
+      if (!isControlled) setInternalValue(next);
+      onValueChange == null ? void 0 : onValueChange(next);
+    },
+    [isControlled, onValueChange]
+  );
+  const valueContext = React.useMemo(
+    () => ({ value: currentValue, onValueChange: handleValueChange }),
+    [currentValue, handleValueChange]
+  );
+  return /* @__PURE__ */ jsx(TabsValueContext.Provider, { value: valueContext, children: /* @__PURE__ */ jsx(
+    TabsPrimitive.Root,
+    {
+      ref,
+      value: currentValue,
+      onValueChange: handleValueChange,
+      ...props,
+      children
+    }
+  ) });
+});
+Tabs.displayName = "Tabs";
+const TABS_LIST_BASE = [
+  "inline-flex items-stretch",
+  "gap-[var(--layout-space-loose)]",
+  "border-b border-divider"
+].join(" ");
+const TabsList = React.forwardRef(({ className, size = "sm", overflow = "none", children, ...props }, ref) => {
+  const tabsSizeContext = React.useMemo(() => ({ size }), [size]);
+  if (overflow === "scroll") {
+    return /* @__PURE__ */ jsx(TabsContext.Provider, { value: tabsSizeContext, children: /* @__PURE__ */ jsx(ScrollTabsList, { ref, className, ...props, children }) });
+  }
+  if (overflow === "menu") {
+    return /* @__PURE__ */ jsx(TabsContext.Provider, { value: tabsSizeContext, children: /* @__PURE__ */ jsx(MenuTabsList, { ref, className, ...props, children }) });
+  }
+  return /* @__PURE__ */ jsx(TabsContext.Provider, { value: tabsSizeContext, children: /* @__PURE__ */ jsx(
+    TabsPrimitive.List,
+    {
+      ref,
+      className: cn(TABS_LIST_BASE, "w-fit", className),
+      ...props,
+      children
+    }
+  ) });
+});
+TabsList.displayName = "TabsList";
+const ScrollTabsList = React.forwardRef(({ className, children, ...props }, ref) => {
+  const { scrollRef, atStart, atEnd, canScroll } = useScrollEdges();
+  const scrollByPage = useScrollByPage(scrollRef);
+  const maskImage = buildFadeMask({
+    canScroll,
+    atStart,
+    atEnd,
+    reserveArrowWidth: ARROW_BUTTON_WIDTH
+  });
+  return (
+    // 2026-05-19 fix(scroll-overflow underline clip + y auto-promote):
+    //   outer 撤 `border-b` → owner 升到 `TabsList` (TABS_LIST_BASE 含 border-b border-divider)
+    //   把 trigger `after:bottom-[-1px]` 2px underline 的下半部 1px 收進 list border-box,
+    //   再加 `overflow-y-hidden` 明示阻 browser y auto-promote(CSS overflow-3 spec:
+    //   overflow-x:auto + overflow-y:visible 必 compute auto)。
+    //   不加 `pb-px`(outer border 撤後 list border 已接 -1px 部分,加 pb 多 1px 多餘空白)。
+    //   對齊 Primer UnderlineNav `overflow-x:auto; overflow-y:hidden` canonical 同步動
+    //   horizontal-overflow.spec.md L75/L101/L129 owner 升 list 內部。
+    /* @__PURE__ */ jsxs("div", { className: "relative", children: [
+      /* @__PURE__ */ jsx(
+        "div",
+        {
+          ref: scrollRef,
+          className: "overflow-x-auto overflow-y-hidden [scrollbar-width:none] [&::-webkit-scrollbar]:hidden",
+          style: { maskImage, WebkitMaskImage: maskImage },
+          children: /* @__PURE__ */ jsx(
+            TabsPrimitive.List,
+            {
+              ref,
+              className: cn(TABS_LIST_BASE, "w-fit", className),
+              ...props,
+              children
+            }
+          )
+        }
+      ),
+      !atStart && canScroll && /* @__PURE__ */ jsx(OverflowScrollArrow, { direction: "left", onClick: () => scrollByPage("left") }),
+      !atEnd && canScroll && /* @__PURE__ */ jsx(OverflowScrollArrow, { direction: "right", onClick: () => scrollByPage("right") })
+    ] })
+  );
+});
+ScrollTabsList.displayName = "ScrollTabsList";
+const MenuTabsList = React.forwardRef(({ className, children, ...props }, ref) => {
+  const { scrollRef, atStart, atEnd, canScroll } = useScrollEdges();
+  const { onValueChange, value: activeValue } = React.useContext(TabsValueContext);
+  const itemRefs = React.useRef(/* @__PURE__ */ new Map());
+  const scrollRafIdRef = React.useRef(0);
+  React.useEffect(() => () => {
+    if (scrollRafIdRef.current) cancelAnimationFrame(scrollRafIdRef.current);
+  }, []);
+  const registerItem = React.useCallback(
+    (index) => (el) => {
+      if (el) itemRefs.current.set(index, el);
+      else itemRefs.current.delete(index);
+    },
+    []
+  );
+  const items = React.useMemo(
+    () => React.Children.toArray(children).filter(React.isValidElement),
+    [children]
+  );
+  const enhancedChildren = items.map(
+    (child, i) => React.cloneElement(
+      child,
+      { ref: registerItem(i) }
+    )
+  );
+  const maskImage = buildFadeMask({ canScroll, atStart, atEnd, reserveArrowWidth: 0 });
+  const handleMenuSelect = React.useCallback(
+    (triggerValue, index) => {
+      onValueChange == null ? void 0 : onValueChange(triggerValue);
+      if (scrollRafIdRef.current) cancelAnimationFrame(scrollRafIdRef.current);
+      scrollRafIdRef.current = requestAnimationFrame(() => {
+        var _a;
+        scrollRafIdRef.current = 0;
+        (_a = itemRefs.current.get(index)) == null ? void 0 : _a.scrollIntoView({ behavior: "smooth", inline: "center", block: "nearest" });
+      });
+    },
+    [onValueChange]
+  );
+  return (
+    // 2026-05-19 fix(scroll-overflow underline clip + y auto-promote,parallel to ScrollTabsList):
+    //   outer 改 items-stretch(menu button 容器跟 TabsList 含 border 共底線)+ 撤 border。
+    //   list 套 TABS_LIST_BASE,inner scroll 加 overflow-y-hidden。menu button 容器自帶
+    //   border-b border-divider 跟 TabsList border 同 y 對齊(items-stretch 保證)。
+    /* @__PURE__ */ jsxs("div", { className: "flex items-stretch", children: [
+      /* @__PURE__ */ jsx(
+        "div",
+        {
+          ref: scrollRef,
+          className: "flex-1 min-w-0 overflow-x-auto overflow-y-hidden [scrollbar-width:none] [&::-webkit-scrollbar]:hidden",
+          style: { maskImage, WebkitMaskImage: maskImage },
+          children: /* @__PURE__ */ jsx(
+            TabsPrimitive.List,
+            {
+              ref,
+              className: cn(TABS_LIST_BASE, "w-fit", className),
+              ...props,
+              children: enhancedChildren
+            }
+          )
+        }
+      ),
+      canScroll && /* @__PURE__ */ jsx("div", { className: "flex-shrink-0 pl-[var(--layout-space-loose)] flex items-center border-b border-divider", children: /* @__PURE__ */ jsxs(DropdownMenu, { children: [
+        /* @__PURE__ */ jsx(DropdownMenuTrigger, { asChild: true, children: /* @__PURE__ */ jsx(
+          OverflowMenuTriggerButton,
+          {
+            "aria-label": `頁籤選單(共 ${items.length} 個)`
+          }
+        ) }),
+        /* @__PURE__ */ jsx(DropdownMenuContent, { align: "end", children: items.map((trigger, index) => {
+          const triggerProps = trigger.props;
+          const triggerValue = triggerProps.value;
+          if (typeof triggerValue !== "string") return null;
+          return /* @__PURE__ */ jsx(
+            DropdownMenuItem,
+            {
+              disabled: triggerProps.disabled,
+              selected: activeValue === triggerValue,
+              onSelect: () => handleMenuSelect(triggerValue, index),
+              children: triggerProps.children
+            },
+            triggerValue
+          );
+        }) })
+      ] }) })
+    ] })
+  );
+});
+MenuTabsList.displayName = "MenuTabsList";
+const tabsTriggerVariants = cva(
+  [
+    "relative inline-flex items-center justify-center",
+    "gap-2",
+    "whitespace-nowrap",
+    "font-medium text-fg-secondary",
+    "transition-colors duration-150",
+    "cursor-pointer select-none",
+    "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-1",
+    // Trigger 無水平 padding — 寬度 = 內容寬度。triggers 間的分隔靠 TabsList 的 gap-[layout-space-loose]
+    // selected underline：::after 絕對定位在 bottom:-1px，2px primary-hover
+    // left-0/right-0 因為 trigger 已無 padding，底線等於內容寬度
+    // 底線蓋住 TabsList 的 1px gray border，視覺單一線條
+    "after:absolute after:left-0 after:right-0 after:bottom-[-1px] after:h-0.5",
+    "after:bg-transparent after:transition-colors after:duration-150",
+    // hover（未選）：文字轉深
+    "hover:text-foreground",
+    // selected
+    "data-[state=active]:text-foreground data-[state=active]:font-medium",
+    "data-[state=active]:after:bg-primary-hover",
+    // disabled：cursor-not-allowed + 不吃 hover 色
+    // 不用 pointer-events-none，否則 cursor 不會改變；button[disabled] 本身就擋 click
+    "disabled:cursor-not-allowed disabled:text-fg-disabled",
+    "disabled:hover:text-fg-disabled"
+  ],
+  {
+    variants: {
+      size: {
+        // leading-compact：trigger 是單行文字容器，使用 1.3 行高避免 text-body/body-lg 預設 1.5 造成垂直偏移
+        sm: "h-[var(--tab-height-sm)] text-body leading-compact",
+        md: "h-[var(--tab-height-md)] text-body leading-compact",
+        lg: "h-[var(--tab-height-lg)] text-body-lg leading-compact"
+      }
+    },
+    defaultVariants: {
+      // size = 'sm' per header-canonical.spec.md W6:overlay / chrome / dense toolbar
+      // 都用 sm;獨立 page hero 用 lg。md 為 future tier(無 recommended use case)。
+      // 2026-05-17 從 'md' 改 'sm'(M31 codex 比稿後)— production consumer = 0,
+      // 影響面限 stories baseline(已過 visual diff gate)。
+      size: "sm"
+    }
+  }
+);
+const TabsTrigger = React.forwardRef(({ className, startIcon: StartIcon, badge, endIcon: EndIcon, inlineAction, children, ...props }, ref) => {
+  const { size } = React.useContext(TabsContext);
+  const iconSize = ICON_SIZE[size];
+  const hasSuffix = badge != null || EndIcon !== void 0 || inlineAction != null;
+  return /* @__PURE__ */ jsxs(
+    TabsPrimitive.Trigger,
+    {
+      ref,
+      className: cn(tabsTriggerVariants({ size }), className),
+      ...props,
+      children: [
+        StartIcon && /* @__PURE__ */ jsx(StartIcon, { size: iconSize, "aria-hidden": true }),
+        children != null && /* @__PURE__ */ jsx("span", { children }),
+        hasSuffix && /* @__PURE__ */ jsxs("span", { className: "inline-flex items-center gap-1", children: [
+          badge,
+          EndIcon && /* @__PURE__ */ jsx(EndIcon, { size: iconSize, "aria-hidden": true }),
+          inlineAction != null && // 2026-05-21 split-click invariant:inlineAction 點擊不冒泡到 TabsPrimitive.Trigger。
+          // Radix Tabs 在 3 個 channel 觸發 tab 切換,全部 stopPropagation:
+          //   - onMouseDown(primary, Radix Tabs source code main switch trigger)
+          //   - onFocus(activationMode='automatic' default,focus 落內部按鈕也算「focused」)
+          //   - onKeyDown Enter/Space(鍵盤啟動)
+          // 加 onPointerDown / onClick 防禦其他 framework 慣例。
+          // 對齊 GitHub「Code ▾」/ Linear "Triage..." split-tab 共識。
+          /* @__PURE__ */ jsx(
+            "span",
+            {
+              onPointerDown: (e) => e.stopPropagation(),
+              onMouseDown: (e) => e.stopPropagation(),
+              onClick: (e) => e.stopPropagation(),
+              onFocus: (e) => e.stopPropagation(),
+              onKeyDown: (e) => {
+                if (e.key === "Enter" || e.key === " ") e.stopPropagation();
+              },
+              children: inlineAction
+            }
+          )
+        ] })
+      ]
+    }
+  );
+});
+TabsTrigger.displayName = "TabsTrigger";
+const TabsContent = React.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+  TabsPrimitive.Content,
+  {
+    ref,
+    className: cn(
+      "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-1",
+      className
+    ),
+    ...props
+  }
+));
+TabsContent.displayName = "TabsContent";
+const tabsMeta = {
+  component: "Tabs",
+  family: null,
+  // non-family composite / overlay / layout
+  variants: {},
+  sizes: {
+    sm: { fieldHeight: 28, iconSize: 16, typography: "body" },
+    md: { fieldHeight: 32, iconSize: 16, typography: "body" },
+    lg: { fieldHeight: 40, iconSize: 20, typography: "body" }
+  },
+  states: ["default", "hover", "active", "focus-visible", "disabled"],
+  tokens: {
+    bg: ["bg-primary-hover", "bg-transparent"],
+    fg: ["text-fg-disabled", "text-fg-secondary", "text-foreground"],
+    ring: ["ring-ring"]
+  },
+  defaultSize: "sm"
+};
+export {
+  Tabs,
+  TabsContent,
+  TabsList,
+  TabsTrigger,
+  tabsMeta,
+  tabsTriggerVariants
+};
+//# sourceMappingURL=tabs.js.map

package/dist/components/Tabs/tabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.js","sources":["../../../src/components/Tabs/tabs.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.\n// code-quality-allow: file-size — foundational composite(Tabs + overflow scroll mode + dropdown switcher + inline action slot)在單一 wrapper SSOT 內,拆分會破壞 a11y / focus management chain。當前 515 < cap 800。\nimport * as React from 'react'\nimport * as TabsPrimitive from '@radix-ui/react-tabs'\nimport { cva } from 'class-variance-authority'\nimport type { LucideIcon } from 'lucide-react'\nimport { cn } from '@/lib/utils'\nimport {\n  DropdownMenu,\n  DropdownMenuTrigger,\n  DropdownMenuContent,\n  DropdownMenuItem,\n} from '@/design-system/components/DropdownMenu/dropdown-menu'\nimport {\n  useScrollEdges,\n  useScrollByPage,\n  buildFadeMask,\n  ARROW_BUTTON_WIDTH,\n  OverflowScrollArrow,\n  OverflowMenuTriggerButton,\n} from '@/design-system/patterns/horizontal-overflow/horizontal-overflow'\nimport { ICON_SIZE } from '@/design-system/tokens/uiSize/icon-size'\n\n/**\n * Tabs — 基於 Radix Tabs，橋接設計系統 token\n *\n * ── 定位 ──\n *   同一上下文底下切換平行的 view。切 view（不是切 value）。\n *   切 value 用 SegmentedControl；切路由用 navigation。\n *\n * ── Size ──\n *   sm   h-tab-sm（32/40），★ 預設(2026-05-17 從 md 改),overlay / chrome / dense\n *   md   h-tab-md（40/48），future tier 無 recommended use case\n *   lg   h-tab-lg（48/56），page-level hero / 獨立 tabs 取代 chrome header\n *\n * ── 寬度行為 ──\n *   Trigger 寬度永遠由內容決定（hug content）。\n *   Triggers 之間 gap 為 --layout-space-loose（16px / 24px lg density）。\n *\n * ── Trigger 結構 ──\n *   [startIcon?] [label] [suffix: badge? + endIcon?]\n *   slot 間 gap-2，suffix 內 gap-1\n *\n * ── Selected underline ──\n *   使用 ::after 絕對定位在 bottom: -1px，2px primary-hover，\n *   蓋住 TabsList 的 1px gray border（單一視覺線條，不雙線）。\n */\n\n// ── Size context ──\ntype TabsSize = 'sm' | 'md' | 'lg'\ntype TabsOverflow = 'none' | 'scroll' | 'menu'\n\ninterface TabsContextValue {\n  size: TabsSize\n}\nconst TabsContext = React.createContext<TabsContextValue>({ size: 'md' })\n\n// ── Root ──\n// Wrap Radix Tabs 以支援 value/onValueChange 的 context pass-through\n// （menu 模式的 overflow items 需要能 proxy click 觸發同一個 onValueChange）\ninterface TabsProps extends React.ComponentPropsWithoutRef<typeof TabsPrimitive.Root> {}\n\nconst TabsValueContext = React.createContext<{\n  value?: string\n  onValueChange?: (value: string) => void\n}>({})\n\nconst Tabs = React.forwardRef<\n  React.ElementRef<typeof TabsPrimitive.Root>,\n  TabsProps\n>(({ value, onValueChange, defaultValue, children, ...props }, ref) => {\n  // 內部維護一份 uncontrolled state，讓 overflow menu 的 proxy 有 onValueChange 可呼叫\n  const [internalValue, setInternalValue] = React.useState<string | undefined>(defaultValue)\n  const isControlled = value !== undefined\n  const currentValue = isControlled ? value : internalValue\n\n  const handleValueChange = React.useCallback(\n    (next: string) => {\n      if (!isControlled) setInternalValue(next)\n      onValueChange?.(next)\n    },\n    [isControlled, onValueChange]\n  )\n\n  const valueContext = React.useMemo(\n    () => ({ value: currentValue, onValueChange: handleValueChange }),\n    [currentValue, handleValueChange]\n  )\n\n  return (\n    <TabsValueContext.Provider value={valueContext}>\n      <TabsPrimitive.Root\n        ref={ref}\n        value={currentValue}\n        onValueChange={handleValueChange}\n        {...props}\n      >\n        {children}\n      </TabsPrimitive.Root>\n    </TabsValueContext.Provider>\n  )\n})\nTabs.displayName = 'Tabs'\n\n// ── List ──\n// TabsList 基礎 class — inline-flex 單列 + gap-loose + 底部 border-divider\n// 2026-05-18 改 border-border → border-divider(per user verbatim「我認為應該把 tabs 的\n// 下底線統一改成是 divider 色吧?」+「做」approval):\n// - 跟 Dialog / Sheet / Popover / Sidebar header `border-b border-divider`(neutral-4)同色\n// - withTabs scenario 下 tabs underline = chrome separator,跟 dialog 其他 separator 視覺一致\n// - Selected trigger 2px primary 仍 overlay underlying divider(對比 primary >> divider 不弱)\n// - 對齊 `color.spec.md:706-708` outer-vs-divider 判準(Dialog 結構,T-junction 思路適用)\nconst TABS_LIST_BASE = [\n  'inline-flex items-stretch',\n  'gap-[var(--layout-space-loose)]',\n  'border-b border-divider',\n].join(' ')\n\ninterface TabsListProps\n  extends React.ComponentPropsWithoutRef<typeof TabsPrimitive.List> {\n  size?: TabsSize\n  /**\n   * Overflow 處理模式。詳見 tabs.spec.md 的 overflow 段。\n   *   'none'   ★ 預設，不處理，triggers 溢出父容器（適用 tabs 數量可控的情境）\n   *   'scroll' 單行橫向滾動 + 邊緣 fade mask（Material / Polaris / iOS 作法）\n   *   'menu'   塞不下收進 \"⋯\" dropdown，所有 triggers 仍在 DOM 保留 Radix a11y\n   *            （Ant Design / Atlassian 作法）\n   */\n  overflow?: TabsOverflow\n}\n\nconst TabsList = React.forwardRef<\n  React.ElementRef<typeof TabsPrimitive.List>,\n  TabsListProps\n>(({ className, size = 'sm', overflow = 'none', children, ...props }, ref) => {\n  const tabsSizeContext = React.useMemo(() => ({ size }), [size])\n  if (overflow === 'scroll') {\n    return (\n      <TabsContext.Provider value={tabsSizeContext}>\n        <ScrollTabsList ref={ref} className={className} {...props}>\n          {children}\n        </ScrollTabsList>\n      </TabsContext.Provider>\n    )\n  }\n  if (overflow === 'menu') {\n    return (\n      <TabsContext.Provider value={tabsSizeContext}>\n        <MenuTabsList ref={ref} className={className} {...props}>\n          {children}\n        </MenuTabsList>\n      </TabsContext.Provider>\n    )\n  }\n  // none（預設）\n  return (\n    <TabsContext.Provider value={tabsSizeContext}>\n      <TabsPrimitive.List\n        ref={ref}\n        className={cn(TABS_LIST_BASE, 'w-fit', className)}\n        {...props}\n      >\n        {children}\n      </TabsPrimitive.List>\n    </TabsContext.Provider>\n  )\n})\nTabsList.displayName = 'TabsList'\n\n// ── Scroll mode ──\n//\n// 共同策略(對齊 Material 3 / Ant Design / Primer UnderlineNav 世界級作法):\n//   - 容器 overflow-x-auto + overflow-y-hidden(真的可滾,鍵盤焦點可 scroll-into-view;\n//     明示 y-hidden 阻 CSS overflow-3 spec「一軸 auto 時另軸 visible compute auto」)\n//   - border-b 在 TabsList 內部(TABS_LIST_BASE),不在 outer wrapper,避免\n//     active underline `after:bottom:-1px` 跟 outer + overflow-x-auto 觸發 y promote bug\n//   - mask / arrow / fade 全部從 horizontal-overflow pattern module 取得——\n//     參見 `patterns/horizontal-overflow/horizontal-overflow.spec.md`\n//   - Menu 模式 = scroll 模式 + 額外的 ⌄ quick-jump button,點 menu item 同時\n//     觸發 onValueChange + scrollIntoView,讓使用者在 tab strip 看到選中的 tab\n// 單行水平滾動 + 邊緣 fade mask 延伸到 arrow button 底下 + 左右 always-visible arrows\n//   - 鍵盤: Radix 原生方向鍵 + 瀏覽器 scroll-into-view\n//   - Trackpad: 兩指橫向滑動\n//   - 滑鼠滾輪: 點 arrow buttons (Shift+wheel 太隱晦)\n\nconst ScrollTabsList = React.forwardRef<\n  React.ElementRef<typeof TabsPrimitive.List>,\n  React.ComponentPropsWithoutRef<typeof TabsPrimitive.List>\n>(({ className, children, ...props }, ref) => {\n  const { scrollRef, atStart, atEnd, canScroll } = useScrollEdges<HTMLDivElement>()\n  const scrollByPage = useScrollByPage(scrollRef)\n  const maskImage = buildFadeMask({\n    canScroll,\n    atStart,\n    atEnd,\n    reserveArrowWidth: ARROW_BUTTON_WIDTH,\n  })\n\n  return (\n    // 2026-05-19 fix(scroll-overflow underline clip + y auto-promote):\n    //   outer 撤 `border-b` → owner 升到 `TabsList` (TABS_LIST_BASE 含 border-b border-divider)\n    //   把 trigger `after:bottom-[-1px]` 2px underline 的下半部 1px 收進 list border-box,\n    //   再加 `overflow-y-hidden` 明示阻 browser y auto-promote(CSS overflow-3 spec:\n    //   overflow-x:auto + overflow-y:visible 必 compute auto)。\n    //   不加 `pb-px`(outer border 撤後 list border 已接 -1px 部分,加 pb 多 1px 多餘空白)。\n    //   對齊 Primer UnderlineNav `overflow-x:auto; overflow-y:hidden` canonical 同步動\n    //   horizontal-overflow.spec.md L75/L101/L129 owner 升 list 內部。\n    <div className=\"relative\">\n      <div\n        ref={scrollRef}\n        className=\"overflow-x-auto overflow-y-hidden [scrollbar-width:none] [&::-webkit-scrollbar]:hidden\"\n        style={{ maskImage, WebkitMaskImage: maskImage }}\n      >\n        <TabsPrimitive.List\n          ref={ref}\n          className={cn(TABS_LIST_BASE, 'w-fit', className)}\n          {...props}\n        >\n          {children}\n        </TabsPrimitive.List>\n      </div>\n      {!atStart && canScroll && (\n        <OverflowScrollArrow direction=\"left\" onClick={() => scrollByPage('left')} />\n      )}\n      {!atEnd && canScroll && (\n        <OverflowScrollArrow direction=\"right\" onClick={() => scrollByPage('right')} />\n      )}\n    </div>\n  )\n})\nScrollTabsList.displayName = 'ScrollTabsList'\n\n// ── Menu mode ──\n// Show-all navigator pattern (Chrome tab dropdown / VS Code editor tabs / Discord channel jumper):\n//   - Menu 永遠顯示全部 tabs,active 的用 checked 標記 (單選語意)\n//   - 點 menu item = onValueChange + scrollIntoView(center),把該 tab 捲到視圖中央\n//   - Menu 內容穩定,跟 scroll 位置無關,使用者對「⋯ = navigator」的直覺一致\n//\n// 為什麼底層仍是 overflow-x-auto 而非 overflow-hidden:\n//   - scrollIntoView 需要真實 scroll 容器\n//   - 鍵盤 focus 也依賴真實 scroll 讓 browser auto scroll-into-view\n//   - scrollbar 用 CSS 隱藏,視覺看不出來\n//\n// Fade mask 純視覺,軟化內容硬邊,跟 menu 機制正交 (兩者可並存)。\n// Menu button 出現條件: canScroll (有溢出空間才需要 navigator)。\n\n// code-quality-allow: long-function — foundational composite main body — 拆 sub-fn 會複雜化 local state / ref / context binding\nconst MenuTabsList = React.forwardRef<\n  React.ElementRef<typeof TabsPrimitive.List>,\n  React.ComponentPropsWithoutRef<typeof TabsPrimitive.List>\n>(({ className, children, ...props }, ref) => {\n  const { scrollRef, atStart, atEnd, canScroll } = useScrollEdges<HTMLDivElement>()\n  const { onValueChange, value: activeValue } = React.useContext(TabsValueContext)\n\n  // Local ref map — 追蹤每個 trigger 的 DOM 元素,供 scrollIntoView 使用。\n  // 不用 useOverflowIndices 因為 menu 永遠顯示全部,不需要動態 overflow 計算。\n  // code-quality-allow: long-function — helper fn 結構緊密,拆 sub-fn 會跨 fn 傳 state 反而複雜\n  const itemRefs = React.useRef<Map<number, HTMLElement>>(new Map())\n  // 2026-05-16 audit codex Round 6:capture rAF + cancel on unmount(defensive hygiene)\n  const scrollRafIdRef = React.useRef<number>(0)\n  React.useEffect(() => () => { if (scrollRafIdRef.current) cancelAnimationFrame(scrollRafIdRef.current) }, [])\n  const registerItem = React.useCallback(\n    (index: number) => (el: HTMLElement | null) => {\n      if (el) itemRefs.current.set(index, el)\n      else itemRefs.current.delete(index)\n    },\n    []\n  )\n\n  const items = React.useMemo(\n    () => React.Children.toArray(children).filter(React.isValidElement) as React.ReactElement[],\n    [children]\n  )\n\n  const enhancedChildren = items.map((child, i) =>\n    React.cloneElement(\n      child as React.ReactElement<{ ref?: React.Ref<HTMLElement> }>,\n      { ref: registerItem(i) }\n    )\n  )\n\n  // Menu 模式沒有 arrows,但仍套 fade mask (reserveArrowWidth: 0) 軟化內容硬邊\n  // code-quality-allow: long-function — helper fn 結構緊密,拆 sub-fn 會跨 fn 傳 state 反而複雜\n  const maskImage = buildFadeMask({ canScroll, atStart, atEnd, reserveArrowWidth: 0 })\n\n  const handleMenuSelect = React.useCallback(\n    (triggerValue: string, index: number) => {\n      onValueChange?.(triggerValue)\n      // 下一個 tick 再 scroll, 讓 Radix 先完成 data-state 更新\n      if (scrollRafIdRef.current) cancelAnimationFrame(scrollRafIdRef.current)\n      scrollRafIdRef.current = requestAnimationFrame(() => {\n        scrollRafIdRef.current = 0\n        itemRefs.current.get(index)?.scrollIntoView({ behavior: 'smooth', inline: 'center', block: 'nearest' })\n      })\n    },\n    [onValueChange]\n  )\n\n  return (\n    // 2026-05-19 fix(scroll-overflow underline clip + y auto-promote,parallel to ScrollTabsList):\n    //   outer 改 items-stretch(menu button 容器跟 TabsList 含 border 共底線)+ 撤 border。\n    //   list 套 TABS_LIST_BASE,inner scroll 加 overflow-y-hidden。menu button 容器自帶\n    //   border-b border-divider 跟 TabsList border 同 y 對齊(items-stretch 保證)。\n    <div className=\"flex items-stretch\">\n      <div\n        ref={scrollRef}\n        className=\"flex-1 min-w-0 overflow-x-auto overflow-y-hidden [scrollbar-width:none] [&::-webkit-scrollbar]:hidden\"\n        style={{ maskImage, WebkitMaskImage: maskImage }}\n      >\n        <TabsPrimitive.List\n          ref={ref}\n          className={cn(TABS_LIST_BASE, 'w-fit', className)}\n          {...props}\n        >\n          {enhancedChildren}\n        </TabsPrimitive.List>\n      </div>\n      {canScroll && (\n        <div className=\"flex-shrink-0 pl-[var(--layout-space-loose)] flex items-center border-b border-divider\">\n          <DropdownMenu>\n            <DropdownMenuTrigger asChild>\n              <OverflowMenuTriggerButton\n                aria-label={`頁籤選單(共 ${items.length} 個)`}\n              />\n            </DropdownMenuTrigger>\n            <DropdownMenuContent align=\"end\">\n              {items.map((trigger, index) => {\n                const triggerProps = trigger.props as {\n                  value?: string\n                  children?: React.ReactNode\n                  disabled?: boolean\n                }\n                const triggerValue = triggerProps.value\n                if (typeof triggerValue !== 'string') return null\n                // 單選 active 用 DropdownMenuItem 的 selected prop\n                //  → 對應 bg-neutral-selected 持續選中背景, 跟 SelectMenu 單選完全\n                //  同一套 canonical 視覺, 全 DS 一致。不可用 className 發明樣式。\n                return (\n                  <DropdownMenuItem\n                    key={triggerValue}\n                    disabled={triggerProps.disabled}\n                    selected={activeValue === triggerValue}\n                    onSelect={() => handleMenuSelect(triggerValue, index)}\n                  >\n                    {triggerProps.children}\n                  </DropdownMenuItem>\n                )\n              })}\n            </DropdownMenuContent>\n          </DropdownMenu>\n        </div>\n      )}\n    </div>\n  )\n})\nMenuTabsList.displayName = 'MenuTabsList'\n\n// ── Trigger ──\nconst tabsTriggerVariants = cva(\n  [\n    'relative inline-flex items-center justify-center',\n    'gap-2',\n    'whitespace-nowrap',\n    'font-medium text-fg-secondary',\n    'transition-colors duration-150',\n    'cursor-pointer select-none',\n    'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-1',\n    // Trigger 無水平 padding — 寬度 = 內容寬度。triggers 間的分隔靠 TabsList 的 gap-[layout-space-loose]\n    // selected underline：::after 絕對定位在 bottom:-1px，2px primary-hover\n    // left-0/right-0 因為 trigger 已無 padding，底線等於內容寬度\n    // 底線蓋住 TabsList 的 1px gray border，視覺單一線條\n    'after:absolute after:left-0 after:right-0 after:bottom-[-1px] after:h-0.5',\n    'after:bg-transparent after:transition-colors after:duration-150',\n    // hover（未選）：文字轉深\n    'hover:text-foreground',\n    // selected\n    'data-[state=active]:text-foreground data-[state=active]:font-medium',\n    'data-[state=active]:after:bg-primary-hover',\n    // disabled：cursor-not-allowed + 不吃 hover 色\n    // 不用 pointer-events-none，否則 cursor 不會改變；button[disabled] 本身就擋 click\n    'disabled:cursor-not-allowed disabled:text-fg-disabled',\n    'disabled:hover:text-fg-disabled',\n  ],\n  {\n    variants: {\n      size: {\n        // leading-compact：trigger 是單行文字容器，使用 1.3 行高避免 text-body/body-lg 預設 1.5 造成垂直偏移\n        sm: 'h-[var(--tab-height-sm)] text-body leading-compact',\n        md: 'h-[var(--tab-height-md)] text-body leading-compact',\n        lg: 'h-[var(--tab-height-lg)] text-body-lg leading-compact',\n      },\n    },\n    defaultVariants: {\n      // size = 'sm' per header-canonical.spec.md W6:overlay / chrome / dense toolbar\n      // 都用 sm;獨立 page hero 用 lg。md 為 future tier(無 recommended use case)。\n      // 2026-05-17 從 'md' 改 'sm'(M31 codex 比稿後)— production consumer = 0,\n      // 影響面限 stories baseline(已過 visual diff gate)。\n      size: 'sm',\n    },\n  }\n)\n\ninterface TabsTriggerProps\n  extends React.ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger> {\n  /** 左側 icon（LucideIcon） */\n  startIcon?: LucideIcon\n  /** 右側 badge（通常是計數指示器） */\n  badge?: React.ReactNode\n  /**\n   * 右側純視覺 indicator(LucideIcon)。**僅限方向 / 狀態 indicator**:ChevronDown / Pin / Star。\n   * **不要拼 click 行為** — endIcon 是 tab body 的一部分,點到也是切 tab。\n   * 需要「點該後綴開 dropdown / menu」場景請用 `inlineAction` slot(2026-05-21 拆分)。\n   */\n  endIcon?: LucideIcon\n  /**\n   * Inline action slot(2026-05-21 v3 加,per user「圖一 後綴應該是 inline action」+「點擊\n   * 該 tab 的 inline action 跟其他地方應該不同反應」directive):\n   * 提供 `<ItemInlineAction>` / `<DropdownMenuTrigger asChild><ItemInlineAction ... /></DropdownMenuTrigger>`\n   * 等獨立 click target。**TabsTrigger 自動 stopPropagation**,inline action 點擊不冒泡到 tab body,\n   * 達成 split-click 行為(對齊 GitHub「Code ▾」/ Linear \"Triage...\" menu / Atlassian split-tab 共識)。\n   *\n   * 跟 endIcon 區別:endIcon = 純視覺 indicator(無獨立行為,連同 tab 一起 click),\n   * inlineAction = 獨立 click target(自己的 handler,不切 tab)。語意分家明確。\n   */\n  inlineAction?: React.ReactNode\n}\n\nconst TabsTrigger = React.forwardRef<\n  React.ElementRef<typeof TabsPrimitive.Trigger>,\n  TabsTriggerProps\n>(({ className, startIcon: StartIcon, badge, endIcon: EndIcon, inlineAction, children, ...props }, ref) => {\n  const { size } = React.useContext(TabsContext)\n  // 2026-05-18 改 import ICON_SIZE SSOT(per user『做完』approval,消除 M17 違反 7+ 重複 ternary)\n  const iconSize = ICON_SIZE[size as 'sm' | 'md' | 'lg']\n  const hasSuffix = badge != null || EndIcon !== undefined || inlineAction != null\n\n  return (\n    <TabsPrimitive.Trigger\n      ref={ref}\n      className={cn(tabsTriggerVariants({ size }), className)}\n      {...props}\n    >\n      {StartIcon && <StartIcon size={iconSize} aria-hidden />}\n      {children != null && <span>{children}</span>}\n      {hasSuffix && (\n        <span className=\"inline-flex items-center gap-1\">\n          {badge}\n          {EndIcon && <EndIcon size={iconSize} aria-hidden />}\n          {inlineAction != null && (\n            // 2026-05-21 split-click invariant:inlineAction 點擊不冒泡到 TabsPrimitive.Trigger。\n            // Radix Tabs 在 3 個 channel 觸發 tab 切換,全部 stopPropagation:\n            //   - onMouseDown(primary, Radix Tabs source code main switch trigger)\n            //   - onFocus(activationMode='automatic' default,focus 落內部按鈕也算「focused」)\n            //   - onKeyDown Enter/Space(鍵盤啟動)\n            // 加 onPointerDown / onClick 防禦其他 framework 慣例。\n            // 對齊 GitHub「Code ▾」/ Linear \"Triage...\" split-tab 共識。\n            <span\n              onPointerDown={(e) => e.stopPropagation()}\n              onMouseDown={(e) => e.stopPropagation()}\n              onClick={(e) => e.stopPropagation()}\n              onFocus={(e) => e.stopPropagation()}\n              onKeyDown={(e) => {\n                if (e.key === 'Enter' || e.key === ' ') e.stopPropagation()\n              }}\n            >\n              {inlineAction}\n            </span>\n          )}\n        </span>\n      )}\n    </TabsPrimitive.Trigger>\n  )\n})\nTabsTrigger.displayName = 'TabsTrigger'\n\n// ── Content ──\nconst TabsContent = React.forwardRef<\n  React.ElementRef<typeof TabsPrimitive.Content>,\n  React.ComponentPropsWithoutRef<typeof TabsPrimitive.Content>\n>(({ className, ...props }, ref) => (\n  <TabsPrimitive.Content\n    ref={ref}\n    className={cn(\n      'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-1',\n      className\n    )}\n    {...props}\n  />\n))\nTabsContent.displayName = 'TabsContent'\n\n// Story auto-compile metadata — Phase 1 mechanical migration(2026-04-24)\n// Phase 2 fill needed: purpose descriptions + when rationale + world-class refs\nexport const tabsMeta = {\n  component: 'Tabs',\n  family: null, // non-family composite / overlay / layout\n  variants: {\n\n  },\n  sizes: {\n    sm: { fieldHeight: 28, iconSize: 16, typography: 'body' },\n    md: { fieldHeight: 32, iconSize: 16, typography: 'body' },\n    lg: { fieldHeight: 40, iconSize: 20, typography: 'body' },\n  },\n  states: ['default', 'hover', 'active', 'focus-visible', 'disabled'],\n  tokens: {\n    bg: ['bg-primary-hover', 'bg-transparent'],\n    fg: ['text-fg-disabled', 'text-fg-secondary', 'text-foreground'],\n    ring: ['ring-ring'],\n  },\n  defaultSize: 'sm',\n} as const\n\nexport { Tabs, TabsList, TabsTrigger, TabsContent, tabsTriggerVariants }\nexport type { TabsSize, TabsListProps, TabsTriggerProps }\n"],"names":[],"mappings":"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"}

package/dist/components/Tag/tag.d.ts

@@ -0,0 +1,86 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+import type { LucideIcon } from "lucide-react";
+declare const tagVariants: (props?: ({
+    color?: "blue" | "green" | "indigo" | "magenta" | "purple" | "red" | "turquoise" | "yellow" | "neutral" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface TagProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'prefix' | 'color'>, VariantProps<typeof tagVariants> {
+    /** 左側 icon（LucideIcon），由 Tag 統一 16px。與 avatar 互斥。 */
+    icon?: LucideIcon;
+    /** 左側 avatar（ReactNode），與 icon 互斥。 */
+    avatar?: React.ReactNode;
+    /** 可移除——Tag 自動渲染 dismiss 按鈕並控制尺寸與互動樣式 */
+    onDismiss?: () => void;
+    /** 深底白字模式（step-6 背景 + 白色前景，warning 例外） */
+    solid?: boolean;
+    /**
+     * 2026-05-15 Q3 真 SSOT fix(per user verbatim「同空間兩判斷點」+「不要冰山一角」):
+     * Tag 寬度由 parent constrain,不套預設 max-w-40(160px)。用於 cell-as-input narrow cell
+     * (< 160px)時 Tag fit cell 寬度 + truncate ellipsis,而非 160px 後被 cell `overflow-hidden`
+     * 硬切。對齊「同 cell width → 同 overflow 判斷」SSOT。Default false 保 backward compat
+     * (wrap layout / pill rail 等仍受 160px 保護)。
+     */
+    unbounded?: boolean;
+}
+declare const Tag: React.ForwardRefExoticComponent<TagProps & React.RefAttributes<HTMLDivElement>>;
+export declare const tagMeta: {
+    readonly component: "Tag";
+    readonly family: 3;
+    readonly variants: {
+        readonly neutral: {
+            readonly purpose: "通用分類、草稿、無特定語義";
+        };
+        readonly blue: {
+            readonly purpose: "進行中、資訊提示、active 狀態（對應 --info）";
+        };
+        readonly red: {
+            readonly purpose: "錯誤、已封鎖、危險（對應 --error）";
+        };
+        readonly green: {
+            readonly purpose: "成功、已完成、已核准（對應 --success）";
+        };
+        readonly yellow: {
+            readonly purpose: "警告、待審核、注意（對應 --warning）";
+        };
+        readonly turquoise: {
+            readonly purpose: "分類色（無固定語義）";
+        };
+        readonly purple: {
+            readonly purpose: "分類色（無固定語義）";
+        };
+        readonly magenta: {
+            readonly purpose: "分類色（無固定語義）";
+        };
+        readonly indigo: {
+            readonly purpose: "分類色（無固定語義）";
+        };
+    };
+    readonly sizes: {
+        readonly sm: {
+            readonly fieldHeight: 28;
+            readonly iconSize: 16;
+            readonly typography: "body";
+        };
+        readonly md: {
+            readonly fieldHeight: 32;
+            readonly iconSize: 16;
+            readonly typography: "body";
+        };
+        readonly lg: {
+            readonly fieldHeight: 40;
+            readonly iconSize: 20;
+            readonly typography: "body";
+        };
+    };
+    readonly states: readonly ["default", "hover", "active", "focus-visible", "disabled"];
+    readonly tokens: {
+        readonly bg: readonly ["bg-neutral-active", "bg-neutral-hover", "bg-secondary", "bg-transparent"];
+        readonly fg: readonly ["text-foreground", "text-inverse-fg"];
+        readonly ring: readonly [];
+    };
+    readonly defaultVariant: "neutral";
+    readonly defaultSize: "md";
+};
+export { Tag, tagVariants };
+//# sourceMappingURL=tag.d.ts.map

package/dist/components/Tag/tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../../src/components/Tag/tag.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAuB9C,QAAA,MAAM,WAAW;;;8EA4BhB,CAAA;AAiBD,MAAM,WAAW,QACf,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,EACpE,YAAY,CAAC,OAAO,WAAW,CAAC;IAClC,qDAAqD;IACrD,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACxB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAyHD,QAAA,MAAM,GAAG,iFAAuD,CAAA;AAKhE,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BV,CAAA;AAEV,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,CAAA"}

package/dist/components/Tag/tag.js

@@ -0,0 +1,172 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import * as React from "react";
+import { cva } from "class-variance-authority";
+import { X } from "lucide-react";
+import { cn } from "../../lib/utils.js";
+import { Tooltip, TooltipTrigger, TooltipContent } from "../Tooltip/tooltip.js";
+import { ItemInlineActionButton } from "../../patterns/element-anatomy/item-anatomy.js";
+let _measureCtx = null;
+function getMeasureCtx() {
+  if (!_measureCtx) _measureCtx = document.createElement("canvas").getContext("2d");
+  return _measureCtx;
+}
+const tagVariants = cva(
+  "inline-flex items-center rounded-md border border-transparent transition-colors cursor-text",
+  {
+    variants: {
+      color: {
+        // 直接引用 primitive（bg=step-1, text=step-7），不經過語義層
+        // step-1 在 dark mode 用 alpha 公式，step-7 用 lighter 公式——兩個 mode 都正確
+        neutral: "bg-secondary text-foreground",
+        blue: "bg-[var(--color-blue-1)] text-[var(--color-blue-7)]",
+        red: "bg-[var(--color-deep-orange-1)] text-[var(--color-deep-orange-7)]",
+        green: "bg-[var(--color-green-1)] text-[var(--color-green-7)]",
+        yellow: "bg-[var(--color-yellow-1)] text-[var(--color-yellow-7)]",
+        turquoise: "bg-[var(--color-turquoise-1)] text-[var(--color-turquoise-7)]",
+        purple: "bg-[var(--color-purple-1)] text-[var(--color-purple-7)]",
+        magenta: "bg-[var(--color-magenta-1)] text-[var(--color-magenta-7)]",
+        indigo: "bg-[var(--color-indigo-1)] text-[var(--color-indigo-7)]"
+      },
+      size: {
+        sm: "h-5 px-1 text-caption font-medium",
+        md: "h-6 px-1 text-body font-normal",
+        lg: "h-6 px-1 text-body font-normal"
+      }
+    },
+    defaultVariants: {
+      color: "neutral",
+      size: "md"
+    }
+  }
+);
+const SOLID_CLASSES = {
+  neutral: "bg-[var(--color-neutral-9)] text-inverse-fg",
+  blue: "bg-[var(--color-blue-6)] text-on-emphasis",
+  red: "bg-[var(--color-deep-orange-6)] text-on-emphasis",
+  green: "bg-[var(--color-green-6)] text-on-emphasis",
+  yellow: "bg-[var(--color-yellow-6)] text-[var(--warning-foreground)]",
+  turquoise: "bg-[var(--color-turquoise-6)] text-on-emphasis",
+  purple: "bg-[var(--color-purple-6)] text-on-emphasis",
+  magenta: "bg-[var(--color-magenta-6)] text-on-emphasis",
+  indigo: "bg-[var(--color-indigo-6)] text-on-emphasis"
+};
+const SOLID_DISMISS_HOVER = {
+  neutral: { hover: "var(--inverse-neutral-hover)", active: "var(--inverse-neutral-active)" },
+  blue: { hover: "var(--blue-hover)", active: "var(--blue-active)" },
+  red: { hover: "var(--red-hover)", active: "var(--red-active)" },
+  green: { hover: "var(--green-hover)", active: "var(--green-active)" },
+  yellow: { hover: "var(--yellow-hover)", active: "var(--yellow-active)" },
+  turquoise: { hover: "var(--turquoise-hover)", active: "var(--turquoise-active)" },
+  purple: { hover: "var(--purple-hover)", active: "var(--purple-active)" },
+  magenta: { hover: "var(--magenta-hover)", active: "var(--magenta-active)" },
+  indigo: { hover: "var(--indigo-hover)", active: "var(--indigo-active)" }
+};
+function TagDismiss({ onDismiss, label, solid, color }) {
+  const solidColors = solid && color ? SOLID_DISMISS_HOVER[color] : void 0;
+  return /* @__PURE__ */ jsx(
+    ItemInlineActionButton,
+    {
+      icon: X,
+      size: "md",
+      onClick: (e) => {
+        e.stopPropagation();
+        onDismiss();
+      },
+      "aria-label": `移除 ${label}`,
+      style: solidColors ? { "--dismiss-hover": solidColors.hover, "--dismiss-active": solidColors.active } : void 0,
+      hoverBgClassName: solidColors ? "group-hover/action:bg-[var(--dismiss-hover)] group-active/action:bg-[var(--dismiss-active)]" : void 0,
+      className: "text-current hover:text-current active:text-current"
+    }
+  );
+}
+function TagInner({ className, color, size, icon: Icon, avatar, onDismiss, solid, unbounded = false, children, style, ...props }, forwardedRef) {
+  const solidClass = solid ? SOLID_CLASSES[color ?? "neutral"] : void 0;
+  const ownRef = React.useRef(null);
+  const [isTruncated, setIsTruncated] = React.useState(false);
+  React.useLayoutEffect(() => {
+    const el = ownRef.current;
+    if (!el) return;
+    const ctx = getMeasureCtx();
+    const check = () => {
+      const textSpan = el.querySelector("[data-tag-text]");
+      if (!textSpan || !ctx) return;
+      const text = textSpan.textContent || "";
+      const cs = getComputedStyle(textSpan);
+      ctx.font = `${cs.fontWeight} ${cs.fontSize} ${cs.fontFamily}`;
+      const textWidth = ctx.measureText(text).width;
+      const padL = parseFloat(cs.paddingLeft) || 0;
+      const padR = parseFloat(cs.paddingRight) || 0;
+      const needed = textWidth + padL + padR;
+      setIsTruncated(needed > textSpan.clientWidth + 1);
+    };
+    check();
+    const obs = new ResizeObserver(check);
+    obs.observe(el);
+    return () => obs.disconnect();
+  }, [children]);
+  const label = typeof children === "string" ? children : "";
+  const tag = /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ref: (el) => {
+        ownRef.current = el;
+        if (typeof forwardedRef === "function") forwardedRef(el);
+        else if (forwardedRef) forwardedRef.current = el;
+      },
+      "data-tag-root": "",
+      className: cn(tagVariants({ color, size }), solidClass, "w-fit min-w-0 overflow-hidden", className),
+      style: {
+        maxWidth: unbounded ? "var(--combobox-tag-area-inline-size, 100%)" : "min(var(--combobox-tag-area-inline-size, 10rem), 10rem)",
+        ...style
+      },
+      ...props,
+      children: [
+        Icon && /* @__PURE__ */ jsx(Icon, { size: 16, "aria-hidden": true }),
+        avatar && /* @__PURE__ */ jsx("span", { className: "shrink-0 w-4 h-4 rounded-full overflow-hidden inline-grid place-content-center [&>*]:w-full [&>*]:h-full", children: avatar }),
+        /* @__PURE__ */ jsx("span", { "data-tag-text": "", className: "px-1 truncate min-w-0", children }),
+        onDismiss && /* @__PURE__ */ jsx(TagDismiss, { onDismiss, label, solid, color: color ?? "neutral" })
+      ]
+    }
+  );
+  if (!isTruncated) return tag;
+  return /* @__PURE__ */ jsxs(Tooltip, { children: [
+    /* @__PURE__ */ jsx(TooltipTrigger, { asChild: true, children: tag }),
+    /* @__PURE__ */ jsx(TooltipContent, { children })
+  ] });
+}
+const Tag = React.forwardRef(TagInner);
+Tag.displayName = "Tag";
+const tagMeta = {
+  component: "Tag",
+  family: 3,
+  variants: {
+    neutral: { purpose: "通用分類、草稿、無特定語義" },
+    blue: { purpose: "進行中、資訊提示、active 狀態（對應 --info）" },
+    red: { purpose: "錯誤、已封鎖、危險（對應 --error）" },
+    green: { purpose: "成功、已完成、已核准（對應 --success）" },
+    yellow: { purpose: "警告、待審核、注意（對應 --warning）" },
+    turquoise: { purpose: "分類色（無固定語義）" },
+    purple: { purpose: "分類色（無固定語義）" },
+    magenta: { purpose: "分類色（無固定語義）" },
+    indigo: { purpose: "分類色（無固定語義）" }
+  },
+  sizes: {
+    sm: { fieldHeight: 28, iconSize: 16, typography: "body" },
+    md: { fieldHeight: 32, iconSize: 16, typography: "body" },
+    lg: { fieldHeight: 40, iconSize: 20, typography: "body" }
+  },
+  states: ["default", "hover", "active", "focus-visible", "disabled"],
+  tokens: {
+    bg: ["bg-neutral-active", "bg-neutral-hover", "bg-secondary", "bg-transparent"],
+    fg: ["text-foreground", "text-inverse-fg"],
+    ring: []
+  },
+  defaultVariant: "neutral",
+  defaultSize: "md"
+};
+export {
+  Tag,
+  tagMeta,
+  tagVariants
+};
+//# sourceMappingURL=tag.js.map