@qijenchen/design-system 0.1.0-beta.84 → 0.1.0-beta.86

package/dist/components/DataTable/data-table-column-visibility-panel.js

@@ -1,11 +1,10 @@
-import { jsxs, Fragment, jsx } from "react/jsx-runtime";
+import { jsxs, jsx, Fragment } from "react/jsx-runtime";
 import * as React from "react";
 import { RotateCcw, X, Search, Lock, GripVertical, Eye, EyeOff } from "lucide-react";
 import { Button } from "../Button/button.js";
 import { ButtonDivider } from "../Button/button-group.js";
 import { Input } from "../Input/input.js";
-import { ScrollArea } from "../ScrollArea/scroll-area.js";
-import { PopoverHeader, PopoverTitle, PopoverClose, PopoverFooter } from "../Popover/popover.js";
+import { PopoverHeader, PopoverTitle, PopoverClose, PopoverBody, PopoverFooter } from "../Popover/popover.js";
 import { ItemPrefix, ItemInlineActionButton, ItemLabel, ROW_PADDING_BY_SIZE } from "../../patterns/element-anatomy/item-anatomy.js";
 import { cn } from "../../lib/utils.js";
 import { DndContext, closestCenter } from "@dnd-kit/core";
@@ -67,67 +66,75 @@ function DataTableColumnVisibilityPanel({
     next.splice(newIdx, 0, m);
     onColumnOrderChange(next);
   };
-  return /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsx(PopoverHeader, { hideClose: true, children: /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-1 w-full min-w-0", children: [
-      /* @__PURE__ */ jsx(PopoverTitle, { className: "flex-1", children: "欄位顯示" }),
-      resettable && anyHidden && /* @__PURE__ */ jsxs(Fragment, { children: [
-        /* @__PURE__ */ jsx(
-          Button,
-          {
-            variant: "text",
-            size: "sm",
-            iconOnly: true,
-            startIcon: RotateCcw,
-            "aria-label": "恢復預設",
-            onClick: handleReset
-          }
-        ),
-        /* @__PURE__ */ jsx(ButtonDivider, {})
-      ] }),
-      /* @__PURE__ */ jsx(PopoverClose, { asChild: true, children: /* @__PURE__ */ jsx(Button, { "data-dismiss": true, iconOnly: true, dismiss: true, size: "sm", startIcon: X, "aria-label": "關閉" }) })
-    ] }) }),
-    searchable && /* @__PURE__ */ jsx("div", { className: "px-[var(--layout-space-loose)] pt-[var(--layout-space-tight)]", children: /* @__PURE__ */ jsx(
-      Input,
-      {
-        size: "md",
-        placeholder: "搜尋欄位…",
-        value: search,
-        onChange: (e) => setSearch(e.target.value),
-        startIcon: Search
-      }
-    ) }),
-    /* @__PURE__ */ jsx(ScrollArea, { className: "max-h-72", children: /* @__PURE__ */ jsx("div", { className: "py-2 flex flex-col", style: { "--item-prefix-slot": "16px" }, children: dndEnabled ? /* @__PURE__ */ jsx(DndContext, { collisionDetection: closestCenter, onDragEnd: handleDragEnd, children: /* @__PURE__ */ jsx(
-      SortableContext,
-      {
-        items: filteredEntries.map((e) => e.id).filter((id) => !lockedSet.has(id)),
-        strategy: verticalListSortingStrategy,
-        children: filteredEntries.map(({ id, label }) => /* @__PURE__ */ jsx(
-          VisibilityRow,
-          {
-            id,
-            label,
-            visible: visibility[id] !== false,
-            locked: lockedSet.has(id),
-            draggable: true,
-            onToggle: () => handleToggle(id)
-          },
-          id
-        ))
-      }
-    ) }) : filteredEntries.map(({ id, label }) => /* @__PURE__ */ jsx(
-      VisibilityRow,
-      {
-        id,
-        label,
-        visible: visibility[id] !== false,
-        locked: lockedSet.has(id),
-        draggable: false,
-        onToggle: () => handleToggle(id)
-      },
-      id
-    )) }) }),
-    /* @__PURE__ */ jsx(PopoverFooter, { className: "justify-start", children: /* @__PURE__ */ jsx(Button, { variant: "tertiary", size: "sm", onClick: handleBulkToggle, children: allVisible ? "全部隱藏" : "顯示全部" }) })
-  ] });
+  return (
+    // 決策16 定案(2026-07-18,SSOT consistency 稽核後):對齊 sibling FilterPanel/SortManager 的
+    //   overlay-surface canonical shape —— root `<div flex flex-col h-full min-h-0>`(M25 viewport-aware
+    //   scroll chain)+ viewport-adaptive `PopoverBody`(取代原 fixed `ScrollArea max-h-72`)。三個
+    //   DataTable state-panel 收斂成同一形狀,body 隨視窗高度自適應(高螢幕多欄不再硬卡 288px)。
+    //   寬度仍由 consumer 的 `<PopoverContent w-72>` 提供(panel root w-full 撐滿)。
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-col h-full min-h-0 w-full", children: [
+      /* @__PURE__ */ jsx(PopoverHeader, { hideClose: true, children: /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-1 w-full min-w-0", children: [
+        /* @__PURE__ */ jsx(PopoverTitle, { className: "flex-1", children: "欄位顯示" }),
+        resettable && anyHidden && /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(
+            Button,
+            {
+              variant: "text",
+              size: "sm",
+              iconOnly: true,
+              startIcon: RotateCcw,
+              "aria-label": "恢復預設",
+              onClick: handleReset
+            }
+          ),
+          /* @__PURE__ */ jsx(ButtonDivider, {})
+        ] }),
+        /* @__PURE__ */ jsx(PopoverClose, { asChild: true, children: /* @__PURE__ */ jsx(Button, { "data-dismiss": true, iconOnly: true, dismiss: true, size: "sm", startIcon: X, "aria-label": "關閉" }) })
+      ] }) }),
+      searchable && /* @__PURE__ */ jsx("div", { className: "shrink-0 px-[var(--layout-space-loose)] pt-[var(--layout-space-tight)]", children: /* @__PURE__ */ jsx(
+        Input,
+        {
+          size: "md",
+          placeholder: "搜尋欄位…",
+          "aria-label": "搜尋欄位",
+          value: search,
+          onChange: (e) => setSearch(e.target.value),
+          startIcon: Search
+        }
+      ) }),
+      /* @__PURE__ */ jsx(PopoverBody, { className: "!px-0 !py-0", children: /* @__PURE__ */ jsx("div", { className: "py-2 flex flex-col", style: { "--item-prefix-slot": "16px" }, children: dndEnabled ? /* @__PURE__ */ jsx(DndContext, { collisionDetection: closestCenter, onDragEnd: handleDragEnd, children: /* @__PURE__ */ jsx(
+        SortableContext,
+        {
+          items: filteredEntries.map((e) => e.id).filter((id) => !lockedSet.has(id)),
+          strategy: verticalListSortingStrategy,
+          children: filteredEntries.map(({ id, label }) => /* @__PURE__ */ jsx(
+            VisibilityRow,
+            {
+              id,
+              label,
+              visible: visibility[id] !== false,
+              locked: lockedSet.has(id),
+              draggable: true,
+              onToggle: () => handleToggle(id)
+            },
+            id
+          ))
+        }
+      ) }) : filteredEntries.map(({ id, label }) => /* @__PURE__ */ jsx(
+        VisibilityRow,
+        {
+          id,
+          label,
+          visible: visibility[id] !== false,
+          locked: lockedSet.has(id),
+          draggable: false,
+          onToggle: () => handleToggle(id)
+        },
+        id
+      )) }) }),
+      /* @__PURE__ */ jsx(PopoverFooter, { className: "justify-start", children: /* @__PURE__ */ jsx(Button, { variant: "tertiary", size: "sm", onClick: handleBulkToggle, children: allVisible ? "全部隱藏" : "顯示全部" }) })
+    ] })
+  );
 }
 function VisibilityRow({
   id,

package/dist/components/DataTable/data-table-column-visibility-panel.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-table-column-visibility-panel.js","sources":["../../../src/components/DataTable/data-table-column-visibility-panel.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/**\n * DataTableColumnVisibilityPanel — Issue 3 primitive(2026-05-10)。\n *\n * 從 WithBulkActions story L868+(149 lines)+ RoadmapAllInOne(L1796+,53 lines)抽出 SSOT\n * primitive。Roadmap demo 跟 WithBulkActions 都用此 panel 開啟「欄位顯示」popover。\n *\n * **Feature SSOT**(對齊 Linear / Airtable / Notion / Material X-DataGrid 的 columnVisibility panel idiom):\n *   - 列出所有 togglable 欄位 + Eye / EyeOff 切換\n *   - Locked 欄位(`lockedIds`)— 顯 Lock icon,不可 toggle / 不可 drag\n *   - 可選 search filter(`searchable`,跨欄位 label match)\n *   - 可選 column drag reorder(`onColumnOrderChange` 傳 → 啟 DnD)\n *   - 可選 reset 按鈕(`resettable: boolean` opt-in,header 區 RotateCcw;點擊 `onVisibilityChange({})` 還原全顯示,無獨立 onReset prop)\n *   - Bidirectional bulk toggle(footer button:全可見 → 全部隱藏 / 任一隱藏 → 顯示全部)\n *\n * **Why 抽 primitive**(per Issue 3 Rule-of-3):RoadmapAllInOne + WithBulkActions + 未來 product\n * UI 至少 3 處消費同 panel。重複 hand-craft → 設計語言 drift(已抓到:Roadmap 版無 search /\n * 無 drag / 無 reset,WithBulkActions 版有,語意不一致)。Primitive 把所有 feature 集中,\n * consumer opt-in via props 確保 SSOT。\n *\n * **對齊**:Linear column-visibility-panel pattern / Material X-DataGrid `<GridColumnsPanel>`\n * / Airtable Field-config drawer。\n */\n\nimport * as React from 'react'\nimport { Eye, EyeOff, Lock, GripVertical, Search, RotateCcw, X as XIcon } from 'lucide-react'\nimport { Button } from '@/design-system/components/Button/button'\nimport { ButtonDivider } from '@/design-system/components/Button/button-group'\nimport { Input } from '@/design-system/components/Input/input'\nimport { ScrollArea } from '@/design-system/components/ScrollArea/scroll-area'\nimport { PopoverHeader, PopoverFooter, PopoverTitle, PopoverClose } from '@/design-system/components/Popover/popover'\nimport { ItemPrefix, ItemLabel, ItemInlineActionButton, ROW_PADDING_BY_SIZE } from '@/design-system/patterns/element-anatomy/item-anatomy'\nimport { cn } from '@/lib/utils'\nimport { DndContext, closestCenter, type DragEndEvent } from '@dnd-kit/core'\nimport { SortableContext, useSortable, verticalListSortingStrategy } from '@dnd-kit/sortable'\nimport { CSS } from '@dnd-kit/utilities'\nimport { dragSourceStyle } from '@/design-system/lib/drag-visual'\n\ninterface ColumnVisibilityPanelColumn {\n  /** Column id(stable identifier;對齊 DataTable column.id / accessorKey)*/\n  id: string\n  /** Column header label(human-readable)*/\n  label: string\n}\n\nexport interface DataTableColumnVisibilityPanelProps {\n  /** 全部可 toggle 欄位(consumer 已過濾掉 system cols 如 __select__)*/\n  columns: ColumnVisibilityPanelColumn[]\n  /** 受控 visibility map(`true` / undefined = visible / `false` = hidden)*/\n  visibility: Record<string, boolean>\n  /** Visibility 變更 callback */\n  onVisibilityChange: (next: Record<string, boolean>) => void\n  /** 受控 column order(若提供啟 DnD reorder) */\n  columnOrder?: string[]\n  /** Order 變更 callback;若提供 → 啟用 drag handle / DnD reorder */\n  onColumnOrderChange?: (next: string[]) => void\n  /** Locked column ids(顯 Lock icon,不可 toggle / 不可 drag)*/\n  lockedIds?: string[]\n  /** 是否啟搜尋 input(預設 false)*/\n  searchable?: boolean\n  /** 是否顯 reset button(任一欄隱藏才顯,onClick 清空 visibility map)*/\n  resettable?: boolean\n  // Issue 3 post-codex audit(2026-05-10):`onClose` prop retired — Radix `PopoverClose asChild`\n  // 已自帶 popover dismiss,沒 concrete consumer 需 callback。Future 若需要再加。\n}\n\nexport function DataTableColumnVisibilityPanel({\n  columns,\n  visibility,\n  onVisibilityChange,\n  columnOrder,\n  onColumnOrderChange,\n  lockedIds = [],\n  searchable = false,\n  resettable = false,\n}: DataTableColumnVisibilityPanelProps) {\n  const [search, setSearch] = React.useState('')\n  const lockedSet = React.useMemo(() => new Set(lockedIds), [lockedIds])\n  const dndEnabled = !!(columnOrder && onColumnOrderChange)\n\n  // 計算 visible order:用 columnOrder 排,fallback columns 順序。\n  const orderedIds = React.useMemo(() => {\n    if (columnOrder && columnOrder.length > 0) {\n      const colSet = new Set(columns.map((c) => c.id))\n      return columnOrder.filter((id) => colSet.has(id))\n    }\n    return columns.map((c) => c.id)\n  }, [columnOrder, columns])\n\n  const filteredEntries = React.useMemo(() => {\n    return orderedIds\n      .map((id) => columns.find((c) => c.id === id))\n      .filter((c): c is ColumnVisibilityPanelColumn => c != null)\n      .filter((c) => (search ? c.label.toLowerCase().includes(search.toLowerCase()) : true))\n  }, [orderedIds, columns, search])\n\n  const togglableIds = columns.map((c) => c.id).filter((id) => !lockedSet.has(id))\n  const allVisible = togglableIds.every((id) => visibility[id] !== false)\n  const anyHidden = togglableIds.some((id) => visibility[id] === false)\n\n  const handleToggle = (id: string) => {\n    const visible = visibility[id] !== false\n    onVisibilityChange({ ...visibility, [id]: !visible })\n  }\n\n  const handleReset = () => onVisibilityChange({})\n\n  const handleBulkToggle = () => {\n    if (allVisible) {\n      const next: Record<string, boolean> = {}\n      togglableIds.forEach((id) => { next[id] = false })\n      onVisibilityChange(next)\n    } else {\n      onVisibilityChange({})\n    }\n  }\n\n  const handleDragEnd = (e: DragEndEvent) => {\n    if (!dndEnabled) return\n    const { active, over } = e\n    if (!over || active.id === over.id) return\n    const oldIdx = columnOrder!.indexOf(active.id as string)\n    const newIdx = columnOrder!.indexOf(over.id as string)\n    if (oldIdx < 0 || newIdx < 0) return\n    // Locked id 不可被 reorder 動到\n    if (lockedSet.has(columnOrder![oldIdx]) || lockedSet.has(columnOrder![newIdx])) return\n    const next = [...columnOrder!]\n    const [m] = next.splice(oldIdx, 1)\n    next.splice(newIdx, 0, m)\n    onColumnOrderChange!(next)\n  }\n\n  return (\n    <>\n      <PopoverHeader hideClose>\n        <div className=\"flex items-center gap-1 w-full min-w-0\">\n          <PopoverTitle className=\"flex-1\">欄位顯示</PopoverTitle>\n          {resettable && anyHidden && (\n            <>\n              <Button\n                variant=\"text\" size=\"sm\" iconOnly startIcon={RotateCcw}\n                aria-label=\"恢復預設\"\n                onClick={handleReset}\n              />\n              <ButtonDivider />\n            </>\n          )}\n          <PopoverClose asChild>\n            <Button data-dismiss iconOnly dismiss size=\"sm\" startIcon={XIcon} aria-label=\"關閉\" />\n          </PopoverClose>\n        </div>\n      </PopoverHeader>\n      {searchable && (\n        <div className=\"px-[var(--layout-space-loose)] pt-[var(--layout-space-tight)]\">\n          <Input\n            size=\"md\"\n            placeholder=\"搜尋欄位…\"\n            value={search}\n            onChange={(e) => setSearch(e.target.value)}\n            startIcon={Search}\n          />\n        </div>\n      )}\n      <ScrollArea className=\"max-h-72\">\n        <div className=\"py-2 flex flex-col\" style={{ '--item-prefix-slot': '16px' } as React.CSSProperties}>\n          {dndEnabled ? (\n            <DndContext collisionDetection={closestCenter} onDragEnd={handleDragEnd}>\n              <SortableContext\n                items={filteredEntries.map((e) => e.id).filter((id) => !lockedSet.has(id))}\n                strategy={verticalListSortingStrategy}\n              >\n                {filteredEntries.map(({ id, label }) => (\n                  <VisibilityRow\n                    key={id}\n                    id={id}\n                    label={label}\n                    visible={visibility[id] !== false}\n                    locked={lockedSet.has(id)}\n                    draggable\n                    onToggle={() => handleToggle(id)}\n                  />\n                ))}\n              </SortableContext>\n            </DndContext>\n          ) : (\n            filteredEntries.map(({ id, label }) => (\n              <VisibilityRow\n                key={id}\n                id={id}\n                label={label}\n                visible={visibility[id] !== false}\n                locked={lockedSet.has(id)}\n                draggable={false}\n                onToggle={() => handleToggle(id)}\n              />\n            ))\n          )}\n        </div>\n      </ScrollArea>\n      <PopoverFooter className=\"justify-start\">\n        <Button variant=\"tertiary\" size=\"sm\" onClick={handleBulkToggle}>\n          {allVisible ? '全部隱藏' : '顯示全部'}\n        </Button>\n      </PopoverFooter>\n    </>\n  )\n}\n\n// VisibilityRow:single column row。Draggable mode → GripVertical handle / static mode → 無 handle。\nfunction VisibilityRow({\n  id, label, visible, locked, draggable, onToggle,\n}: {\n  id: string\n  label: string\n  visible: boolean\n  locked: boolean\n  draggable: boolean\n  onToggle: () => void\n}) {\n  // Conditional hooks 不行 — 永遠呼 useSortable,只是 disabled 時 listeners no-op\n  const sortable = useSortable({ id, disabled: locked || !draggable })\n  const { attributes, listeners, setNodeRef, transform, transition, isDragging } = sortable\n  const style: React.CSSProperties = draggable\n    ? { transform: CSS.Transform.toString(transform), transition, ...dragSourceStyle(isDragging) }\n    : {}\n  return (\n    <div\n      ref={draggable ? setNodeRef : undefined}\n      style={style}\n      className={cn(\n        'flex items-start gap-2 w-full px-[var(--layout-space-loose)]',\n        ROW_PADDING_BY_SIZE.md,\n      )}\n    >\n      <ItemPrefix>\n        {/* 2026-05-18 改 per user「做完」approval:14 → 16 對齊 uiSize.spec.md Icon Tier */}\n        {locked ? (\n          <Lock size={16} className=\"text-fg-muted\" aria-hidden />\n        ) : draggable ? (\n          <ItemInlineActionButton\n            icon={GripVertical}\n            size=\"md\"\n            aria-label=\"拖曳重排\"\n            className=\"cursor-grab active:cursor-grabbing\"\n            {...attributes}\n            {...listeners}\n          />\n        ) : null}\n      </ItemPrefix>\n      <ItemLabel className={locked ? 'text-fg-disabled' : undefined}>{label}</ItemLabel>\n      <ItemInlineActionButton\n        icon={visible ? Eye : EyeOff}\n        size=\"md\"\n        aria-label={visible ? '隱藏此欄' : '顯示此欄'}\n        disabled={locked}\n        onClick={onToggle}\n        className={locked ? 'cursor-not-allowed text-fg-disabled' : ''}\n      />\n    </div>\n  )\n}\n"],"names":["XIcon"],"mappings":";;;;;;;;;;;;;;AAkEO,SAAS,+BAA+B;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY,CAAA;AAAA,EACZ,aAAa;AAAA,EACb,aAAa;AACf,GAAwC;AACtC,QAAM,CAAC,QAAQ,SAAS,IAAI,MAAM,SAAS,EAAE;AAC7C,QAAM,YAAY,MAAM,QAAQ,MAAM,IAAI,IAAI,SAAS,GAAG,CAAC,SAAS,CAAC;AACrE,QAAM,aAAa,CAAC,EAAE,eAAe;AAGrC,QAAM,aAAa,MAAM,QAAQ,MAAM;AACrC,QAAI,eAAe,YAAY,SAAS,GAAG;AACzC,YAAM,SAAS,IAAI,IAAI,QAAQ,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;AAC/C,aAAO,YAAY,OAAO,CAAC,OAAO,OAAO,IAAI,EAAE,CAAC;AAAA,IAClD;AACA,WAAO,QAAQ,IAAI,CAAC,MAAM,EAAE,EAAE;AAAA,EAChC,GAAG,CAAC,aAAa,OAAO,CAAC;AAEzB,QAAM,kBAAkB,MAAM,QAAQ,MAAM;AAC1C,WAAO,WACJ,IAAI,CAAC,OAAO,QAAQ,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAC5C,OAAO,CAAC,MAAwC,KAAK,IAAI,EACzD,OAAO,CAAC,MAAO,SAAS,EAAE,MAAM,YAAA,EAAc,SAAS,OAAO,YAAA,CAAa,IAAI,IAAK;AAAA,EACzF,GAAG,CAAC,YAAY,SAAS,MAAM,CAAC;AAEhC,QAAM,eAAe,QAAQ,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;AAC/E,QAAM,aAAa,aAAa,MAAM,CAAC,OAAO,WAAW,EAAE,MAAM,KAAK;AACtE,QAAM,YAAY,aAAa,KAAK,CAAC,OAAO,WAAW,EAAE,MAAM,KAAK;AAEpE,QAAM,eAAe,CAAC,OAAe;AACnC,UAAM,UAAU,WAAW,EAAE,MAAM;AACnC,uBAAmB,EAAE,GAAG,YAAY,CAAC,EAAE,GAAG,CAAC,SAAS;AAAA,EACtD;AAEA,QAAM,cAAc,MAAM,mBAAmB,EAAE;AAE/C,QAAM,mBAAmB,MAAM;AAC7B,QAAI,YAAY;AACd,YAAM,OAAgC,CAAA;AACtC,mBAAa,QAAQ,CAAC,OAAO;AAAE,aAAK,EAAE,IAAI;AAAA,MAAM,CAAC;AACjD,yBAAmB,IAAI;AAAA,IACzB,OAAO;AACL,yBAAmB,CAAA,CAAE;AAAA,IACvB;AAAA,EACF;AAEA,QAAM,gBAAgB,CAAC,MAAoB;AACzC,QAAI,CAAC,WAAY;AACjB,UAAM,EAAE,QAAQ,KAAA,IAAS;AACzB,QAAI,CAAC,QAAQ,OAAO,OAAO,KAAK,GAAI;AACpC,UAAM,SAAS,YAAa,QAAQ,OAAO,EAAY;AACvD,UAAM,SAAS,YAAa,QAAQ,KAAK,EAAY;AACrD,QAAI,SAAS,KAAK,SAAS,EAAG;AAE9B,QAAI,UAAU,IAAI,YAAa,MAAM,CAAC,KAAK,UAAU,IAAI,YAAa,MAAM,CAAC,EAAG;AAChF,UAAM,OAAO,CAAC,GAAG,WAAY;AAC7B,UAAM,CAAC,CAAC,IAAI,KAAK,OAAO,QAAQ,CAAC;AACjC,SAAK,OAAO,QAAQ,GAAG,CAAC;AACxB,wBAAqB,IAAI;AAAA,EAC3B;AAEA,SACE,qBAAA,UAAA,EACE,UAAA;AAAA,IAAA,oBAAC,iBAAc,WAAS,MACtB,UAAA,qBAAC,OAAA,EAAI,WAAU,0CACb,UAAA;AAAA,MAAA,oBAAC,cAAA,EAAa,WAAU,UAAS,UAAA,QAAI;AAAA,MACpC,cAAc,aACb,qBAAA,UAAA,EACE,UAAA;AAAA,QAAA;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,SAAQ;AAAA,YAAO,MAAK;AAAA,YAAK,UAAQ;AAAA,YAAC,WAAW;AAAA,YAC7C,cAAW;AAAA,YACX,SAAS;AAAA,UAAA;AAAA,QAAA;AAAA,4BAEV,eAAA,CAAA,CAAc;AAAA,MAAA,GACjB;AAAA,0BAED,cAAA,EAAa,SAAO,MACnB,UAAA,oBAAC,QAAA,EAAO,gBAAY,MAAC,UAAQ,MAAC,SAAO,MAAC,MAAK,MAAK,WAAWA,GAAO,cAAW,MAAK,EAAA,CACpF;AAAA,IAAA,EAAA,CACF,EAAA,CACF;AAAA,IACC,cACC,oBAAC,OAAA,EAAI,WAAU,iEACb,UAAA;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,MAAK;AAAA,QACL,aAAY;AAAA,QACZ,OAAO;AAAA,QACP,UAAU,CAAC,MAAM,UAAU,EAAE,OAAO,KAAK;AAAA,QACzC,WAAW;AAAA,MAAA;AAAA,IAAA,GAEf;AAAA,wBAED,YAAA,EAAW,WAAU,YACpB,UAAA,oBAAC,OAAA,EAAI,WAAU,sBAAqB,OAAO,EAAE,sBAAsB,UAChE,UAAA,aACC,oBAAC,cAAW,oBAAoB,eAAe,WAAW,eACxD,UAAA;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,OAAO,gBAAgB,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;AAAA,QACzE,UAAU;AAAA,QAET,0BAAgB,IAAI,CAAC,EAAE,IAAI,YAC1B;AAAA,UAAC;AAAA,UAAA;AAAA,YAEC;AAAA,YACA;AAAA,YACA,SAAS,WAAW,EAAE,MAAM;AAAA,YAC5B,QAAQ,UAAU,IAAI,EAAE;AAAA,YACxB,WAAS;AAAA,YACT,UAAU,MAAM,aAAa,EAAE;AAAA,UAAA;AAAA,UAN1B;AAAA,QAAA,CAQR;AAAA,MAAA;AAAA,IAAA,EACH,CACF,IAEA,gBAAgB,IAAI,CAAC,EAAE,IAAI,YACzB;AAAA,MAAC;AAAA,MAAA;AAAA,QAEC;AAAA,QACA;AAAA,QACA,SAAS,WAAW,EAAE,MAAM;AAAA,QAC5B,QAAQ,UAAU,IAAI,EAAE;AAAA,QACxB,WAAW;AAAA,QACX,UAAU,MAAM,aAAa,EAAE;AAAA,MAAA;AAAA,MAN1B;AAAA,IAAA,CAQR,GAEL,EAAA,CACF;AAAA,IACA,oBAAC,eAAA,EAAc,WAAU,iBACvB,8BAAC,QAAA,EAAO,SAAQ,YAAW,MAAK,MAAK,SAAS,kBAC3C,UAAA,aAAa,SAAS,QACzB,EAAA,CACF;AAAA,EAAA,GACF;AAEJ;AAGA,SAAS,cAAc;AAAA,EACrB;AAAA,EAAI;AAAA,EAAO;AAAA,EAAS;AAAA,EAAQ;AAAA,EAAW;AACzC,GAOG;AAED,QAAM,WAAW,YAAY,EAAE,IAAI,UAAU,UAAU,CAAC,WAAW;AACnE,QAAM,EAAE,YAAY,WAAW,YAAY,WAAW,YAAY,eAAe;AACjF,QAAM,QAA6B,YAC/B,EAAE,WAAW,IAAI,UAAU,SAAS,SAAS,GAAG,YAAY,GAAG,gBAAgB,UAAU,EAAA,IACzF,CAAA;AACJ,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,KAAK,YAAY,aAAa;AAAA,MAC9B;AAAA,MACA,WAAW;AAAA,QACT;AAAA,QACA,oBAAoB;AAAA,MAAA;AAAA,MAGtB,UAAA;AAAA,QAAA,oBAAC,YAAA,EAEE,UAAA,SACC,oBAAC,MAAA,EAAK,MAAM,IAAI,WAAU,iBAAgB,eAAW,KAAA,CAAC,IACpD,YACF;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,MAAM;AAAA,YACN,MAAK;AAAA,YACL,cAAW;AAAA,YACX,WAAU;AAAA,YACT,GAAG;AAAA,YACH,GAAG;AAAA,UAAA;AAAA,QAAA,IAEJ,KAAA,CACN;AAAA,4BACC,WAAA,EAAU,WAAW,SAAS,qBAAqB,QAAY,UAAA,OAAM;AAAA,QACtE;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,MAAM,UAAU,MAAM;AAAA,YACtB,MAAK;AAAA,YACL,cAAY,UAAU,SAAS;AAAA,YAC/B,UAAU;AAAA,YACV,SAAS;AAAA,YACT,WAAW,SAAS,wCAAwC;AAAA,UAAA;AAAA,QAAA;AAAA,MAC9D;AAAA,IAAA;AAAA,EAAA;AAGN;"}
+{"version":3,"file":"data-table-column-visibility-panel.js","sources":["../../../src/components/DataTable/data-table-column-visibility-panel.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/**\n * DataTableColumnVisibilityPanel — Issue 3 primitive(2026-05-10)。\n *\n * 從 WithBulkActions story L868+(149 lines)+ RoadmapAllInOne(L1796+,53 lines)抽出 SSOT\n * primitive。Roadmap demo 跟 WithBulkActions 都用此 panel 開啟「欄位顯示」popover。\n *\n * **Feature SSOT**(對齊 Linear / Airtable / Notion / Material X-DataGrid 的 columnVisibility panel idiom):\n *   - 列出所有 togglable 欄位 + Eye / EyeOff 切換\n *   - Locked 欄位(`lockedIds`)— 顯 Lock icon,不可 toggle / 不可 drag\n *   - 可選 search filter(`searchable`,跨欄位 label match)\n *   - 可選 column drag reorder(`onColumnOrderChange` 傳 → 啟 DnD)\n *   - 可選 reset 按鈕(`resettable: boolean` opt-in,header 區 RotateCcw;點擊 `onVisibilityChange({})` 還原全顯示,無獨立 onReset prop)\n *   - Bidirectional bulk toggle(footer button:全可見 → 全部隱藏 / 任一隱藏 → 顯示全部)\n *\n * **Why 抽 primitive**(per Issue 3 Rule-of-3):RoadmapAllInOne + WithBulkActions + 未來 product\n * UI 至少 3 處消費同 panel。重複 hand-craft → 設計語言 drift(已抓到:Roadmap 版無 search /\n * 無 drag / 無 reset,WithBulkActions 版有,語意不一致)。Primitive 把所有 feature 集中,\n * consumer opt-in via props 確保 SSOT。\n *\n * **對齊**:Linear column-visibility-panel pattern / Material X-DataGrid `<GridColumnsPanel>`\n * / Airtable Field-config drawer。\n */\n\nimport * as React from 'react'\nimport { Eye, EyeOff, Lock, GripVertical, Search, RotateCcw, X as XIcon } from 'lucide-react'\nimport { Button } from '@/design-system/components/Button/button'\nimport { ButtonDivider } from '@/design-system/components/Button/button-group'\nimport { Input } from '@/design-system/components/Input/input'\nimport { PopoverHeader, PopoverBody, PopoverFooter, PopoverTitle, PopoverClose } from '@/design-system/components/Popover/popover'\nimport { ItemPrefix, ItemLabel, ItemInlineActionButton, ROW_PADDING_BY_SIZE } from '@/design-system/patterns/element-anatomy/item-anatomy'\nimport { cn } from '@/lib/utils'\nimport { DndContext, closestCenter, type DragEndEvent } from '@dnd-kit/core'\nimport { SortableContext, useSortable, verticalListSortingStrategy } from '@dnd-kit/sortable'\nimport { CSS } from '@dnd-kit/utilities'\nimport { dragSourceStyle } from '@/design-system/lib/drag-visual'\n\ninterface ColumnVisibilityPanelColumn {\n  /** Column id(stable identifier;對齊 DataTable column.id / accessorKey)*/\n  id: string\n  /** Column header label(human-readable)*/\n  label: string\n}\n\nexport interface DataTableColumnVisibilityPanelProps {\n  /** 全部可 toggle 欄位(consumer 已過濾掉 system cols 如 __select__)*/\n  columns: ColumnVisibilityPanelColumn[]\n  /** 受控 visibility map(`true` / undefined = visible / `false` = hidden)*/\n  visibility: Record<string, boolean>\n  /** Visibility 變更 callback */\n  onVisibilityChange: (next: Record<string, boolean>) => void\n  /** 受控 column order(若提供啟 DnD reorder) */\n  columnOrder?: string[]\n  /** Order 變更 callback;若提供 → 啟用 drag handle / DnD reorder */\n  onColumnOrderChange?: (next: string[]) => void\n  /** Locked column ids(顯 Lock icon,不可 toggle / 不可 drag)*/\n  lockedIds?: string[]\n  /** 是否啟搜尋 input(預設 false)*/\n  searchable?: boolean\n  /** 是否顯 reset button(任一欄隱藏才顯,onClick 清空 visibility map)*/\n  resettable?: boolean\n  // Issue 3 post-codex audit(2026-05-10):`onClose` prop retired — Radix `PopoverClose asChild`\n  // 已自帶 popover dismiss,沒 concrete consumer 需 callback。Future 若需要再加。\n}\n\nexport function DataTableColumnVisibilityPanel({\n  columns,\n  visibility,\n  onVisibilityChange,\n  columnOrder,\n  onColumnOrderChange,\n  lockedIds = [],\n  searchable = false,\n  resettable = false,\n}: DataTableColumnVisibilityPanelProps) {\n  const [search, setSearch] = React.useState('')\n  const lockedSet = React.useMemo(() => new Set(lockedIds), [lockedIds])\n  const dndEnabled = !!(columnOrder && onColumnOrderChange)\n\n  // 計算 visible order:用 columnOrder 排,fallback columns 順序。\n  const orderedIds = React.useMemo(() => {\n    if (columnOrder && columnOrder.length > 0) {\n      const colSet = new Set(columns.map((c) => c.id))\n      return columnOrder.filter((id) => colSet.has(id))\n    }\n    return columns.map((c) => c.id)\n  }, [columnOrder, columns])\n\n  const filteredEntries = React.useMemo(() => {\n    return orderedIds\n      .map((id) => columns.find((c) => c.id === id))\n      .filter((c): c is ColumnVisibilityPanelColumn => c != null)\n      .filter((c) => (search ? c.label.toLowerCase().includes(search.toLowerCase()) : true))\n  }, [orderedIds, columns, search])\n\n  const togglableIds = columns.map((c) => c.id).filter((id) => !lockedSet.has(id))\n  const allVisible = togglableIds.every((id) => visibility[id] !== false)\n  const anyHidden = togglableIds.some((id) => visibility[id] === false)\n\n  const handleToggle = (id: string) => {\n    const visible = visibility[id] !== false\n    onVisibilityChange({ ...visibility, [id]: !visible })\n  }\n\n  const handleReset = () => onVisibilityChange({})\n\n  const handleBulkToggle = () => {\n    if (allVisible) {\n      const next: Record<string, boolean> = {}\n      togglableIds.forEach((id) => { next[id] = false })\n      onVisibilityChange(next)\n    } else {\n      onVisibilityChange({})\n    }\n  }\n\n  const handleDragEnd = (e: DragEndEvent) => {\n    if (!dndEnabled) return\n    const { active, over } = e\n    if (!over || active.id === over.id) return\n    const oldIdx = columnOrder!.indexOf(active.id as string)\n    const newIdx = columnOrder!.indexOf(over.id as string)\n    if (oldIdx < 0 || newIdx < 0) return\n    // Locked id 不可被 reorder 動到\n    if (lockedSet.has(columnOrder![oldIdx]) || lockedSet.has(columnOrder![newIdx])) return\n    const next = [...columnOrder!]\n    const [m] = next.splice(oldIdx, 1)\n    next.splice(newIdx, 0, m)\n    onColumnOrderChange!(next)\n  }\n\n  // 2026-07-18 決策16 錯誤史(明記以免再犯):原本這個 panel 是 Fragment + fixed `ScrollArea max-h-72`,\n  //   與 sibling FilterPanel/SortManager(root-div + viewport-aware SurfaceBody)不一致。我給過**兩個都錯**\n  //   的辯護理由 —— (1)「PopoverHeader 用 -mx 負邊距、包 root 會破壞」= 錯(SurfaceHeader 用正 px-loose+border-b,\n  //   無 -mx);(2)「sibling 自刻 header 不用 primitive」= 錯(三 panel 皆消費 SurfaceHeader/PopoverHeader primitive)。\n  //   真正差異只是 body/scroll 策略。multi-agent SSOT consistency 稽核定案:**是 drift,該統一**(fixed 288px cap\n  //   在高螢幕多欄下劣於 sibling 的 viewport-adaptive;且是唯一不能當 template 複製的 panel)。故下方已改成 canonical shape。\n  return (\n    // 決策16 定案(2026-07-18,SSOT consistency 稽核後):對齊 sibling FilterPanel/SortManager 的\n    //   overlay-surface canonical shape —— root `<div flex flex-col h-full min-h-0>`(M25 viewport-aware\n    //   scroll chain)+ viewport-adaptive `PopoverBody`(取代原 fixed `ScrollArea max-h-72`)。三個\n    //   DataTable state-panel 收斂成同一形狀,body 隨視窗高度自適應(高螢幕多欄不再硬卡 288px)。\n    //   寬度仍由 consumer 的 `<PopoverContent w-72>` 提供(panel root w-full 撐滿)。\n    <div className=\"flex flex-col h-full min-h-0 w-full\">\n      <PopoverHeader hideClose>\n        <div className=\"flex items-center gap-1 w-full min-w-0\">\n          <PopoverTitle className=\"flex-1\">欄位顯示</PopoverTitle>\n          {resettable && anyHidden && (\n            <>\n              <Button\n                variant=\"text\" size=\"sm\" iconOnly startIcon={RotateCcw}\n                aria-label=\"恢復預設\"\n                onClick={handleReset}\n              />\n              <ButtonDivider />\n            </>\n          )}\n          <PopoverClose asChild>\n            <Button data-dismiss iconOnly dismiss size=\"sm\" startIcon={XIcon} aria-label=\"關閉\" />\n          </PopoverClose>\n        </div>\n      </PopoverHeader>\n      {searchable && (\n        <div className=\"shrink-0 px-[var(--layout-space-loose)] pt-[var(--layout-space-tight)]\">\n          <Input\n            size=\"md\"\n            placeholder=\"搜尋欄位…\"\n            aria-label=\"搜尋欄位\"\n            value={search}\n            onChange={(e) => setSearch(e.target.value)}\n            startIcon={Search}\n          />\n        </div>\n      )}\n      {/* viewport-adaptive body(List-as-region idiom:PopoverBody !px-0 !py-0 撤 chrome padding,\n          內層 py-2 給垂直呼吸、row 自帶 px-loose 水平 padding)。取代原 fixed ScrollArea max-h-72。 */}\n      <PopoverBody className=\"!px-0 !py-0\">\n        <div className=\"py-2 flex flex-col\" style={{ '--item-prefix-slot': '16px' } as React.CSSProperties}>\n          {dndEnabled ? (\n            <DndContext collisionDetection={closestCenter} onDragEnd={handleDragEnd}>\n              <SortableContext\n                items={filteredEntries.map((e) => e.id).filter((id) => !lockedSet.has(id))}\n                strategy={verticalListSortingStrategy}\n              >\n                {filteredEntries.map(({ id, label }) => (\n                  <VisibilityRow\n                    key={id}\n                    id={id}\n                    label={label}\n                    visible={visibility[id] !== false}\n                    locked={lockedSet.has(id)}\n                    draggable\n                    onToggle={() => handleToggle(id)}\n                  />\n                ))}\n              </SortableContext>\n            </DndContext>\n          ) : (\n            filteredEntries.map(({ id, label }) => (\n              <VisibilityRow\n                key={id}\n                id={id}\n                label={label}\n                visible={visibility[id] !== false}\n                locked={lockedSet.has(id)}\n                draggable={false}\n                onToggle={() => handleToggle(id)}\n              />\n            ))\n          )}\n        </div>\n      </PopoverBody>\n      <PopoverFooter className=\"justify-start\">\n        <Button variant=\"tertiary\" size=\"sm\" onClick={handleBulkToggle}>\n          {allVisible ? '全部隱藏' : '顯示全部'}\n        </Button>\n      </PopoverFooter>\n    </div>\n  )\n}\n\n// VisibilityRow:single column row。Draggable mode → GripVertical handle / static mode → 無 handle。\nfunction VisibilityRow({\n  id, label, visible, locked, draggable, onToggle,\n}: {\n  id: string\n  label: string\n  visible: boolean\n  locked: boolean\n  draggable: boolean\n  onToggle: () => void\n}) {\n  // Conditional hooks 不行 — 永遠呼 useSortable,只是 disabled 時 listeners no-op\n  const sortable = useSortable({ id, disabled: locked || !draggable })\n  const { attributes, listeners, setNodeRef, transform, transition, isDragging } = sortable\n  const style: React.CSSProperties = draggable\n    ? { transform: CSS.Transform.toString(transform), transition, ...dragSourceStyle(isDragging) }\n    : {}\n  return (\n    <div\n      ref={draggable ? setNodeRef : undefined}\n      style={style}\n      className={cn(\n        'flex items-start gap-2 w-full px-[var(--layout-space-loose)]',\n        ROW_PADDING_BY_SIZE.md,\n      )}\n    >\n      <ItemPrefix>\n        {/* 2026-05-18 改 per user「做完」approval:14 → 16 對齊 uiSize.spec.md Icon Tier */}\n        {locked ? (\n          <Lock size={16} className=\"text-fg-muted\" aria-hidden />\n        ) : draggable ? (\n          <ItemInlineActionButton\n            icon={GripVertical}\n            size=\"md\"\n            aria-label=\"拖曳重排\"\n            className=\"cursor-grab active:cursor-grabbing\"\n            {...attributes}\n            {...listeners}\n          />\n        ) : null}\n      </ItemPrefix>\n      <ItemLabel className={locked ? 'text-fg-disabled' : undefined}>{label}</ItemLabel>\n      <ItemInlineActionButton\n        icon={visible ? Eye : EyeOff}\n        size=\"md\"\n        aria-label={visible ? '隱藏此欄' : '顯示此欄'}\n        disabled={locked}\n        onClick={onToggle}\n        className={locked ? 'cursor-not-allowed text-fg-disabled' : ''}\n      />\n    </div>\n  )\n}\n"],"names":["XIcon"],"mappings":"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"}

package/dist/components/DataTable/data-table-filter-group.d.ts

@@ -0,0 +1,47 @@
+import { type SelectOption } from '../../components/Select/select';
+import type { ColumnType } from './column-types';
+import type { Conjunction, FilterCondition, FilterGroup } from './filter-tree';
+export interface FilterColumn {
+    id: string;
+    label: string;
+    type: ColumnType;
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+    /** People pool for person/multiPerson filter picker(對齊 cell-registry meta.people SSOT)*/
+    people?: Array<{
+        name: string;
+        avatarUrl?: string;
+        description?: string;
+    }>;
+    includeTime?: boolean;
+}
+export declare function getDefaultOperator(type?: ColumnType): string;
+export declare const datePrecisionOf: (col: FilterColumn | undefined) => "day" | "ms" | undefined;
+export declare function FilterRow({ index, condition, conjunction, filterableColumns, fieldOptions, onChangeConjunction, onChangeField, onChangeOp, onChangeValue, onRemove, }: {
+    index: number;
+    condition: FilterCondition;
+    conjunction: Conjunction;
+    filterableColumns: FilterColumn[];
+    fieldOptions: SelectOption[];
+    onChangeConjunction: (c: Conjunction) => void;
+    onChangeField: (v: string) => void;
+    onChangeOp: (v: string) => void;
+    onChangeValue: (v: unknown) => void;
+    onRemove: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function GroupBlock({ index, group, rootConjunction, filterableColumns, fieldOptions, onChangeRootConjunction, onChangeGroupConjunction, onChangeCondition, onRemoveCondition, onAddCondition, onRemoveGroup, }: {
+    index: number;
+    group: FilterGroup;
+    rootConjunction: Conjunction;
+    filterableColumns: FilterColumn[];
+    fieldOptions: SelectOption[];
+    onChangeRootConjunction: (c: Conjunction) => void;
+    onChangeGroupConjunction: (c: Conjunction) => void;
+    onChangeCondition: (condId: string, patch: Partial<FilterCondition>) => void;
+    onRemoveCondition: (condId: string) => void;
+    onAddCondition: () => void;
+    onRemoveGroup: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=data-table-filter-group.d.ts.map

package/dist/components/DataTable/data-table-filter-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-filter-group.d.ts","sourceRoot":"","sources":["../../../src/components/DataTable/data-table-filter-group.tsx"],"names":[],"mappings":"AAiBA,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,0CAA0C,CAAA;AAEpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAQhD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAK9E,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,UAAU,CAAA;IAChB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACjD,yFAAyF;IACzF,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC1E,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAOD,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CAE5D;AAID,eAAO,MAAM,eAAe,GAAI,KAAK,YAAY,GAAG,SAAS,KAAG,KAAK,GAAG,IAAI,GAAG,SACV,CAAA;AA0CrE,wBAAgB,SAAS,CAAC,EACxB,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAC9D,mBAAmB,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,GACxE,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,eAAe,CAAA;IAC1B,WAAW,EAAE,WAAW,CAAA;IACxB,iBAAiB,EAAE,YAAY,EAAE,CAAA;IACjC,YAAY,EAAE,YAAY,EAAE,CAAA;IAC5B,mBAAmB,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,CAAA;IAC7C,aAAa,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,aAAa,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACnC,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB,2CAgEA;AAID,wBAAgB,UAAU,CAAC,EACzB,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,YAAY,EAC9D,uBAAuB,EAAE,wBAAwB,EACjD,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,GACpE,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,WAAW,CAAA;IAClB,eAAe,EAAE,WAAW,CAAA;IAC5B,iBAAiB,EAAE,YAAY,EAAE,CAAA;IACjC,YAAY,EAAE,YAAY,EAAE,CAAA;IAC5B,uBAAuB,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,CAAA;IACjD,wBAAwB,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,CAAA;IAClD,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,IAAI,CAAA;IAC5E,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3C,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B,aAAa,EAAE,MAAM,IAAI,CAAA;CAC1B,2CAoCA"}

package/dist/components/DataTable/data-table-filter-group.js

@@ -0,0 +1,154 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import { Trash2, Plus } from "lucide-react";
+import { Button } from "../Button/button.js";
+import { Select } from "../Select/select.js";
+import { FieldControlGroup } from "../FieldControlGroup/field-control-group.js";
+import { DEFAULT_OPERATOR, getOperatorSpec, getValueShape, OPERATOR_REGISTRY } from "./filter-operators.js";
+import { FilterValuePicker } from "./data-table-filter-value-picker.js";
+function getOperatorOptions(type) {
+  const registry = type && OPERATOR_REGISTRY[type] ? OPERATOR_REGISTRY[type] : OPERATOR_REGISTRY.string;
+  return registry.map((op) => ({ value: op.op, label: op.label }));
+}
+function getDefaultOperator(type) {
+  return type && DEFAULT_OPERATOR[type] || DEFAULT_OPERATOR.string;
+}
+const datePrecisionOf = (col) => (col == null ? void 0 : col.type) === "date" ? col.includeTime ? "ms" : "day" : void 0;
+const CONJ_OPTIONS = [
+  { value: "and", label: "And" },
+  { value: "or", label: "Or" }
+];
+function ConjunctionLabel({
+  index,
+  conjunction,
+  onChange
+}) {
+  if (index === 0) {
+    return /* @__PURE__ */ jsx("div", { className: "w-20 shrink-0 text-body text-fg-muted px-[var(--field-px)] self-center", children: "Where" });
+  }
+  if (index >= 2) {
+    const label = conjunction === "and" ? "And" : "Or";
+    return /* @__PURE__ */ jsx("div", { className: "w-20 shrink-0 text-body text-fg-muted px-[var(--field-px)] self-center", children: label });
+  }
+  return /* @__PURE__ */ jsx("div", { className: "w-20 shrink-0", children: /* @__PURE__ */ jsx(
+    Select,
+    {
+      size: "sm",
+      options: CONJ_OPTIONS,
+      value: conjunction,
+      onChange: (v) => onChange(v),
+      minRows: 2,
+      "aria-label": "連接詞 — 同 group 共用"
+    }
+  ) });
+}
+function FilterRow({
+  index,
+  condition,
+  conjunction,
+  filterableColumns,
+  fieldOptions,
+  onChangeConjunction,
+  onChangeField,
+  onChangeOp,
+  onChangeValue,
+  onRemove
+}) {
+  const colInfo = filterableColumns.find((c) => c.id === condition.field);
+  const operatorOptions = getOperatorOptions(colInfo == null ? void 0 : colInfo.type);
+  const hasField = !!condition.field;
+  const opSpec = colInfo ? getOperatorSpec(colInfo.type, condition.op) : null;
+  const valueShape = colInfo && opSpec ? getValueShape(opSpec, colInfo.type, colInfo.includeTime) : null;
+  const hasValueCell = valueShape !== "none";
+  return /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
+    /* @__PURE__ */ jsx(ConjunctionLabel, { index, conjunction, onChange: onChangeConjunction }),
+    /* @__PURE__ */ jsxs(FieldControlGroup, { block: true, className: "flex-1 min-w-0", children: [
+      /* @__PURE__ */ jsx(
+        Select,
+        {
+          className: "!w-[var(--data-table-filter-field-width)] flex-shrink-0",
+          size: "sm",
+          options: fieldOptions,
+          value: condition.field,
+          onChange: onChangeField,
+          placeholder: "選擇欄位",
+          "aria-label": "篩選欄位"
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        Select,
+        {
+          className: hasValueCell ? "!w-[var(--data-table-filter-op-width)] flex-shrink-0" : "!flex-1 !min-w-0",
+          size: "sm",
+          options: operatorOptions,
+          value: condition.op,
+          onChange: onChangeOp,
+          disabled: !hasField,
+          placeholder: "運算子",
+          "aria-label": "篩選運算子"
+        }
+      ),
+      hasValueCell && /* @__PURE__ */ jsx(
+        FilterValuePicker,
+        {
+          shape: valueShape,
+          value: condition.value,
+          onChange: onChangeValue,
+          colInfo,
+          disabled: !hasField,
+          ariaLabel: colInfo ? `${colInfo.label} 篩選值` : "篩選值",
+          className: "!flex-1 !min-w-0"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsx(Button, { variant: "text", size: "sm", iconOnly: true, startIcon: Trash2, "aria-label": "刪除", onClick: onRemove })
+  ] });
+}
+function GroupBlock({
+  index,
+  group,
+  rootConjunction,
+  filterableColumns,
+  fieldOptions,
+  onChangeRootConjunction,
+  onChangeGroupConjunction,
+  onChangeCondition,
+  onRemoveCondition,
+  onAddCondition,
+  onRemoveGroup
+}) {
+  return /* @__PURE__ */ jsxs("div", { className: "flex items-start gap-2", children: [
+    /* @__PURE__ */ jsx("div", { className: "pt-2", children: /* @__PURE__ */ jsx(ConjunctionLabel, { index, conjunction: rootConjunction, onChange: onChangeRootConjunction }) }),
+    /* @__PURE__ */ jsxs("div", { className: "flex-1 min-w-0 rounded-md bg-muted p-2 flex flex-col gap-2", children: [
+      group.children.map((cond, cIdx) => /* @__PURE__ */ jsx(
+        FilterRow,
+        {
+          index: cIdx,
+          condition: cond,
+          conjunction: group.conjunction,
+          filterableColumns,
+          fieldOptions,
+          onChangeConjunction: onChangeGroupConjunction,
+          onChangeField: (v) => {
+            const newCol = filterableColumns.find((c) => c.id === v);
+            onChangeCondition(cond.id, { field: v, op: getDefaultOperator(newCol == null ? void 0 : newCol.type), value: "", datePrecision: datePrecisionOf(newCol) });
+          },
+          onChangeOp: (v) => onChangeCondition(cond.id, { op: v, value: "" }),
+          onChangeValue: (v) => onChangeCondition(cond.id, { value: v }),
+          onRemove: () => onRemoveCondition(cond.id)
+        },
+        cond.id
+      )),
+      /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between", children: [
+        /* @__PURE__ */ jsx(Button, { variant: "text", size: "sm", startIcon: Plus, onClick: onAddCondition, children: "加入巢狀篩選" }),
+        group.children.length === 0 && /* @__PURE__ */ jsx(Button, { variant: "text", size: "sm", startIcon: Trash2, danger: true, onClick: onRemoveGroup, children: "移除空群組" })
+      ] })
+    ] })
+  ] });
+}
+export {
+  FilterRow,
+  GroupBlock,
+  datePrecisionOf,
+  getDefaultOperator
+};
+//# sourceMappingURL=data-table-filter-group.js.map

package/dist/components/DataTable/data-table-filter-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-filter-group.js","sources":["../../../src/components/DataTable/data-table-filter-group.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(2026-07-14 自 data-table-filter-panel.tsx 拆檔搬移,原檔級 escape 隨段落帶入)。\n// @internal — DS-internal 單元(filter row / nested-group renderer + 共用 column/operator\n// helpers;GroupBlock 為 nested-group renderer,FilterRow / ConjunctionLabel 為其 row 構件、\n// flat mode 共用。只被 data-table-filter-panel.tsx 消費);不隨 index.ts re-export 進 npm public surface。\n// ────────────────────────────── 消費的 SSOT ──────────────────────────────\n// - FieldControlGroup:field + op + value border-collapse 接合(field-control-group.spec.md;\n//   FilterValuePicker 為 direct child,className forward 不開 wrapper div — 2026-05-04 #2 fix)\n// - Button(variant=\"text\" iconOnly)row meta trash / Select(size=\"sm\")conjunction・field・op\n//   (data-table.spec.md「四、UI canonical」:trash = form-control row text Button;A6 conjunction)\n// - Width tokens:--data-table-filter-field-width / --data-table-filter-op-width(uiSize.css SSOT,\n//   2026-05-23 Phase A.4 Decision 2)\n// - Operator SSOT:./filter-operators.ts OPERATOR_REGISTRY(禁 hardcode op 字串)\n// - Group container 灰底 bg-muted:color.spec.md L651-654 靜態低重要 surface semantic(2026-05-09 Q3 A)\n// 設計規則:./filter-operators.spec.md + ./data-table.spec.md「進階篩選」段\n\nimport { Plus, Trash2 } from 'lucide-react'\nimport { Button } from '@/design-system/components/Button/button'\nimport { Select, type SelectOption } from '@/design-system/components/Select/select'\nimport { FieldControlGroup } from '@/design-system/components/FieldControlGroup/field-control-group'\nimport type { ColumnType } from './column-types'\nimport {\n  OPERATOR_REGISTRY,\n  DEFAULT_OPERATOR,\n  getOperatorSpec,\n  getValueShape,\n  type ValueShape,\n} from './filter-operators'\nimport type { Conjunction, FilterCondition, FilterGroup } from './filter-tree'\nimport { FilterValuePicker } from './data-table-filter-value-picker'\n\n// ── Shared internal types + operator helpers(panel orchestration 也消費)────\n\nexport interface FilterColumn {\n  id: string\n  label: string\n  type: ColumnType\n  options?: Array<{ value: string; label: string }>\n  /** People pool for person/multiPerson filter picker(對齊 cell-registry meta.people SSOT)*/\n  people?: Array<{ name: string; avatarUrl?: string; description?: string }>\n  includeTime?: boolean\n}\n\nfunction getOperatorOptions(type?: ColumnType): SelectOption[] {\n  const registry = type && OPERATOR_REGISTRY[type] ? OPERATOR_REGISTRY[type] : OPERATOR_REGISTRY.string\n  return registry.map((op) => ({ value: op.op, label: op.label }))\n}\n\nexport function getDefaultOperator(type?: ColumnType): string {\n  return (type && DEFAULT_OPERATOR[type]) || DEFAULT_OPERATOR.string\n}\n\n// Q6(2026-07-04):date 欄位把比對精度寫進 condition(includeTime=true → ms,否則 day)。\n// 'time' 欄暫不寫(值非完整日期,truncate 語意不成立;見 filter-operators.spec v3 time 註)。\nexport const datePrecisionOf = (col: FilterColumn | undefined): 'day' | 'ms' | undefined =>\n  col?.type === 'date' ? (col.includeTime ? 'ms' : 'day') : undefined\n\n// ── ConjunctionLabel ───────────────────────────────────────────────────\n\nconst CONJ_OPTIONS: SelectOption[] = [\n  { value: 'and', label: 'And' },\n  { value: 'or', label: 'Or' },\n]\n\nfunction ConjunctionLabel({\n  index, conjunction, onChange,\n}: { index: number; conjunction: Conjunction; onChange: (c: Conjunction) => void }) {\n  // index === 0:首 row 顯示靜態「Where」label\n  // index === 1:**唯一可改**的 AND/OR Select(連動整 group conjunction)\n  // index ≥ 2:被連動的 row,read-only 顯示當前 conjunction 文字(同 Where 視覺,A6 canonical)\n  //   對齊 Airtable / Notion / Linear 共識 @benchmark-unverified(non-OSS)\n  //   px-[var(--field-px)] 對齊 Field 內部 padding 12px(Q13)\n  if (index === 0) {\n    return <div className=\"w-20 shrink-0 text-body text-fg-muted px-[var(--field-px)] self-center\">Where</div>\n  }\n  if (index >= 2) {\n    const label = conjunction === 'and' ? 'And' : 'Or'\n    return <div className=\"w-20 shrink-0 text-body text-fg-muted px-[var(--field-px)] self-center\">{label}</div>\n  }\n  // index === 1:可切換的 AND/OR Select\n  // minRows={2} — And/Or 2 選項,顯式縮 menu 高度避免 reserve 3 row 空白(Q5)\n  return (\n    <div className=\"w-20 shrink-0\">\n      <Select\n        size=\"sm\"\n        options={CONJ_OPTIONS}\n        value={conjunction}\n        onChange={(v) => onChange(v as Conjunction)}\n        minRows={2}\n        aria-label=\"連接詞 — 同 group 共用\"\n      />\n    </div>\n  )\n}\n\n// ── FilterRow(flat 用 + group 內共用) ──────────────────────────────\n\nexport function FilterRow({\n  index, condition, conjunction, filterableColumns, fieldOptions,\n  onChangeConjunction, onChangeField, onChangeOp, onChangeValue, onRemove,\n}: {\n  index: number\n  condition: FilterCondition\n  conjunction: Conjunction\n  filterableColumns: FilterColumn[]\n  fieldOptions: SelectOption[]\n  onChangeConjunction: (c: Conjunction) => void\n  onChangeField: (v: string) => void\n  onChangeOp: (v: string) => void\n  onChangeValue: (v: unknown) => void\n  onRemove: () => void\n}) {\n  const colInfo = filterableColumns.find((c) => c.id === condition.field)\n  const operatorOptions = getOperatorOptions(colInfo?.type)\n  const hasField = !!condition.field\n  const opSpec = colInfo ? getOperatorSpec(colInfo.type, condition.op) : null\n  const valueShape: ValueShape | null = colInfo && opSpec\n    ? getValueShape(opSpec, colInfo.type, colInfo.includeTime)\n    : null\n  // op 'is_set' / 'is_not_set' 等 shape='none' → 無 value cell,op 自動 expand 填剩餘寬\n  // 對齊 Notion / Airtable / Linear filter row 行為\n  // 注意:valueShape=null(初始無 field 選)時仍 render value cell(disabled placeholder)— 只 'none' 才 fold\n  const hasValueCell = valueShape !== 'none'\n\n  // FieldControlGroup 接合 field + op + value 視覺(2026-05-04 E refactor + 多輪 fix):\n  //   - border collapse 取代 3 顆獨立 Select 並排,對齊 Airtable / Linear / Notion filter row idiom\n  //   - ConjunctionLabel + Trash 在 group 外層(meta actions,不屬 control 一體)\n  //   - **#5 fix**:row 內水平 gap = `gap-2` (8px),layoutSpace 規則 5 緊密相關\n  //   - **#9 fix**:cell 用 `min-w-[]`(field 160 / op 120),value flex-1 min-w-0,讓 long label 可撐寬\n  //   - **#2 fix**:FilterValuePicker 直接是 FieldControlGroup direct child(無 wrapper div),CSS variants 命中正確\n  return (\n    <div className=\"flex items-center gap-2\">\n      <ConjunctionLabel index={index} conjunction={conjunction} onChange={onChangeConjunction} />\n      {/* **#9 fix(2026-05-04 v4)**:Field controls trigger `w-full` override 外 className,改用 Tailwind `!`\n          important 強制 override(`!w-[160px]` / `!w-[120px]`),value 用 `!flex-1 !min-w-0`。\n          Select 元件本身沒 destructure `style` prop 所以 inline style flex-basis 行不通,只能用 className。 */}\n      <FieldControlGroup block className=\"flex-1 min-w-0\">\n        {/* 2026-05-23 Phase A.4 Decision 2:`!w-[160px]` / `!w-[120px]` → tokens\n            `--data-table-filter-field-width` / `--data-table-filter-op-width`(SSOT in uiSize.css)\n            Behavior preserved 完好如初:flat + nested 同 width(token 是 design constant) */}\n        <Select\n          className=\"!w-[var(--data-table-filter-field-width)] flex-shrink-0\"\n          size=\"sm\"\n          options={fieldOptions}\n          value={condition.field}\n          onChange={onChangeField}\n          placeholder=\"選擇欄位\"\n          aria-label=\"篩選欄位\"\n        />\n        <Select\n          className={hasValueCell ? '!w-[var(--data-table-filter-op-width)] flex-shrink-0' : '!flex-1 !min-w-0'}\n          size=\"sm\"\n          options={operatorOptions}\n          value={condition.op}\n          onChange={onChangeOp}\n          disabled={!hasField}\n          placeholder=\"運算子\"\n          aria-label=\"篩選運算子\"\n        />\n        {hasValueCell && (\n          <FilterValuePicker\n            shape={valueShape}\n            value={condition.value}\n            onChange={onChangeValue}\n            colInfo={colInfo}\n            disabled={!hasField}\n            ariaLabel={colInfo ? `${colInfo.label} 篩選值` : '篩選值'}\n            className=\"!flex-1 !min-w-0\"\n          />\n        )}\n      </FieldControlGroup>\n      {/* Trash 用 text Button — filter row 是 form-control row,Field 同高對齊(28 md) */}\n      <Button variant=\"text\" size=\"sm\" iconOnly startIcon={Trash2} aria-label=\"刪除\" onClick={onRemove} />\n    </div>\n  )\n}\n\n// ── GroupBlock(nested 用) ────────────────────────────────────────────\n\nexport function GroupBlock({\n  index, group, rootConjunction, filterableColumns, fieldOptions,\n  onChangeRootConjunction, onChangeGroupConjunction,\n  onChangeCondition, onRemoveCondition, onAddCondition, onRemoveGroup,\n}: {\n  index: number\n  group: FilterGroup\n  rootConjunction: Conjunction\n  filterableColumns: FilterColumn[]\n  fieldOptions: SelectOption[]\n  onChangeRootConjunction: (c: Conjunction) => void\n  onChangeGroupConjunction: (c: Conjunction) => void\n  onChangeCondition: (condId: string, patch: Partial<FilterCondition>) => void\n  onRemoveCondition: (condId: string) => void\n  onAddCondition: () => void\n  onRemoveGroup: () => void\n}) {\n  return (\n    <div className=\"flex items-start gap-2\">\n      <div className=\"pt-2\">\n        <ConjunctionLabel index={index} conjunction={rootConjunction} onChange={onChangeRootConjunction} />\n      </div>\n      {/* Group container 灰底 — `bg-muted`(`--muted` neutral-2,user 2026-05-09 拍板 Q3 A)。對齊 color.spec.md L651-654 「table header / tab / code block / skeleton」靜態低重要 surface semantic */}\n      <div className=\"flex-1 min-w-0 rounded-md bg-muted p-2 flex flex-col gap-2\">\n        {group.children.map((cond, cIdx) => (\n          <FilterRow\n            key={cond.id}\n            index={cIdx}\n            condition={cond}\n            conjunction={group.conjunction}\n            filterableColumns={filterableColumns}\n            fieldOptions={fieldOptions}\n            onChangeConjunction={onChangeGroupConjunction}\n            onChangeField={(v) => {\n              const newCol = filterableColumns.find((c) => c.id === v)\n              onChangeCondition(cond.id, { field: v, op: getDefaultOperator(newCol?.type), value: '', datePrecision: datePrecisionOf(newCol) })\n            }}\n            onChangeOp={(v) => onChangeCondition(cond.id, { op: v, value: '' })}\n            onChangeValue={(v) => onChangeCondition(cond.id, { value: v })}\n            onRemove={() => onRemoveCondition(cond.id)}\n          />\n        ))}\n        {/* Q9 — text variant 對齊 inline 派 + 視覺輕量 */}\n        <div className=\"flex items-center justify-between\">\n          <Button variant=\"text\" size=\"sm\" startIcon={Plus} onClick={onAddCondition}>加入巢狀篩選</Button>\n          {group.children.length === 0 && (\n            <Button variant=\"text\" size=\"sm\" startIcon={Trash2} danger onClick={onRemoveGroup}>移除空群組</Button>\n          )}\n        </div>\n      </div>\n    </div>\n  )\n}\n"],"names":[],"mappings":";;;;;;;AA0CA,SAAS,mBAAmB,MAAmC;AAC7D,QAAM,WAAW,QAAQ,kBAAkB,IAAI,IAAI,kBAAkB,IAAI,IAAI,kBAAkB;AAC/F,SAAO,SAAS,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,OAAO,GAAG,MAAA,EAAQ;AACjE;AAEO,SAAS,mBAAmB,MAA2B;AAC5D,SAAQ,QAAQ,iBAAiB,IAAI,KAAM,iBAAiB;AAC9D;AAIO,MAAM,kBAAkB,CAAC,SAC9B,2BAAK,UAAS,SAAU,IAAI,cAAc,OAAO,QAAS;AAI5D,MAAM,eAA+B;AAAA,EACnC,EAAE,OAAO,OAAO,OAAO,MAAA;AAAA,EACvB,EAAE,OAAO,MAAM,OAAO,KAAA;AACxB;AAEA,SAAS,iBAAiB;AAAA,EACxB;AAAA,EAAO;AAAA,EAAa;AACtB,GAAoF;AAMlF,MAAI,UAAU,GAAG;AACf,WAAO,oBAAC,OAAA,EAAI,WAAU,0EAAyE,UAAA,SAAK;AAAA,EACtG;AACA,MAAI,SAAS,GAAG;AACd,UAAM,QAAQ,gBAAgB,QAAQ,QAAQ;AAC9C,WAAO,oBAAC,OAAA,EAAI,WAAU,0EAA0E,UAAA,OAAM;AAAA,EACxG;AAGA,SACE,oBAAC,OAAA,EAAI,WAAU,iBACb,UAAA;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,MAAK;AAAA,MACL,SAAS;AAAA,MACT,OAAO;AAAA,MACP,UAAU,CAAC,MAAM,SAAS,CAAgB;AAAA,MAC1C,SAAS;AAAA,MACT,cAAW;AAAA,IAAA;AAAA,EAAA,GAEf;AAEJ;AAIO,SAAS,UAAU;AAAA,EACxB;AAAA,EAAO;AAAA,EAAW;AAAA,EAAa;AAAA,EAAmB;AAAA,EAClD;AAAA,EAAqB;AAAA,EAAe;AAAA,EAAY;AAAA,EAAe;AACjE,GAWG;AACD,QAAM,UAAU,kBAAkB,KAAK,CAAC,MAAM,EAAE,OAAO,UAAU,KAAK;AACtE,QAAM,kBAAkB,mBAAmB,mCAAS,IAAI;AACxD,QAAM,WAAW,CAAC,CAAC,UAAU;AAC7B,QAAM,SAAS,UAAU,gBAAgB,QAAQ,MAAM,UAAU,EAAE,IAAI;AACvE,QAAM,aAAgC,WAAW,SAC7C,cAAc,QAAQ,QAAQ,MAAM,QAAQ,WAAW,IACvD;AAIJ,QAAM,eAAe,eAAe;AAQpC,SACE,qBAAC,OAAA,EAAI,WAAU,2BACb,UAAA;AAAA,IAAA,oBAAC,kBAAA,EAAiB,OAAc,aAA0B,UAAU,qBAAqB;AAAA,IAIzF,qBAAC,mBAAA,EAAkB,OAAK,MAAC,WAAU,kBAIjC,UAAA;AAAA,MAAA;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,WAAU;AAAA,UACV,MAAK;AAAA,UACL,SAAS;AAAA,UACT,OAAO,UAAU;AAAA,UACjB,UAAU;AAAA,UACV,aAAY;AAAA,UACZ,cAAW;AAAA,QAAA;AAAA,MAAA;AAAA,MAEb;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,WAAW,eAAe,yDAAyD;AAAA,UACnF,MAAK;AAAA,UACL,SAAS;AAAA,UACT,OAAO,UAAU;AAAA,UACjB,UAAU;AAAA,UACV,UAAU,CAAC;AAAA,UACX,aAAY;AAAA,UACZ,cAAW;AAAA,QAAA;AAAA,MAAA;AAAA,MAEZ,gBACC;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,OAAO;AAAA,UACP,OAAO,UAAU;AAAA,UACjB,UAAU;AAAA,UACV;AAAA,UACA,UAAU,CAAC;AAAA,UACX,WAAW,UAAU,GAAG,QAAQ,KAAK,SAAS;AAAA,UAC9C,WAAU;AAAA,QAAA;AAAA,MAAA;AAAA,IACZ,GAEJ;AAAA,IAEA,oBAAC,QAAA,EAAO,SAAQ,QAAO,MAAK,MAAK,UAAQ,MAAC,WAAW,QAAQ,cAAW,MAAK,SAAS,SAAA,CAAU;AAAA,EAAA,GAClG;AAEJ;AAIO,SAAS,WAAW;AAAA,EACzB;AAAA,EAAO;AAAA,EAAO;AAAA,EAAiB;AAAA,EAAmB;AAAA,EAClD;AAAA,EAAyB;AAAA,EACzB;AAAA,EAAmB;AAAA,EAAmB;AAAA,EAAgB;AACxD,GAYG;AACD,SACE,qBAAC,OAAA,EAAI,WAAU,0BACb,UAAA;AAAA,IAAA,oBAAC,OAAA,EAAI,WAAU,QACb,UAAA,oBAAC,kBAAA,EAAiB,OAAc,aAAa,iBAAiB,UAAU,wBAAA,CAAyB,EAAA,CACnG;AAAA,IAEA,qBAAC,OAAA,EAAI,WAAU,8DACZ,UAAA;AAAA,MAAA,MAAM,SAAS,IAAI,CAAC,MAAM,SACzB;AAAA,QAAC;AAAA,QAAA;AAAA,UAEC,OAAO;AAAA,UACP,WAAW;AAAA,UACX,aAAa,MAAM;AAAA,UACnB;AAAA,UACA;AAAA,UACA,qBAAqB;AAAA,UACrB,eAAe,CAAC,MAAM;AACpB,kBAAM,SAAS,kBAAkB,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;AACvD,8BAAkB,KAAK,IAAI,EAAE,OAAO,GAAG,IAAI,mBAAmB,iCAAQ,IAAI,GAAG,OAAO,IAAI,eAAe,gBAAgB,MAAM,GAAG;AAAA,UAClI;AAAA,UACA,YAAY,CAAC,MAAM,kBAAkB,KAAK,IAAI,EAAE,IAAI,GAAG,OAAO,IAAI;AAAA,UAClE,eAAe,CAAC,MAAM,kBAAkB,KAAK,IAAI,EAAE,OAAO,GAAG;AAAA,UAC7D,UAAU,MAAM,kBAAkB,KAAK,EAAE;AAAA,QAAA;AAAA,QAbpC,KAAK;AAAA,MAAA,CAeb;AAAA,MAED,qBAAC,OAAA,EAAI,WAAU,qCACb,UAAA;AAAA,QAAA,oBAAC,QAAA,EAAO,SAAQ,QAAO,MAAK,MAAK,WAAW,MAAM,SAAS,gBAAgB,UAAA,SAAA,CAAM;AAAA,QAChF,MAAM,SAAS,WAAW,KACzB,oBAAC,UAAO,SAAQ,QAAO,MAAK,MAAK,WAAW,QAAQ,QAAM,MAAC,SAAS,eAAe,UAAA,QAAA,CAAK;AAAA,MAAA,EAAA,CAE5F;AAAA,IAAA,EAAA,CACF;AAAA,EAAA,GACF;AAEJ;"}

package/dist/components/DataTable/data-table-filter-panel.d.ts

@@ -4,8 +4,6 @@ import { createEmptyFilterTree, isFilterTreeActive, evaluateTree, dataTableFilte
 export { createEmptyFilterTree, isFilterTreeActive, evaluateTree, dataTableFilterMatch, };
 export type { Conjunction, FilterCondition, FilterGroup, FilterTree, FilterTreeFlat, FilterTreeNested };
 export interface DataTableFilterPanelProps<TData> {
-    /** flat(無 group)or nested(1-level group)— consumer 拍板 */
-    mode: 'flat' | 'nested';
     /** 可被 filter 的 columns */
     columns: ColumnDef<TData, any>[];
     /** 當前 FilterTree(controlled) */

package/dist/components/DataTable/data-table-filter-panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-table-filter-panel.d.ts","sourceRoot":"","sources":["../../../src/components/DataTable/data-table-filter-panel.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAyBtD,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAElB,YAAY,EACZ,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,GACrB,CAAA;AACD,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAA;AA6TvG,MAAM,WAAW,yBAAyB,CAAC,KAAK;IAC9C,yDAAyD;IACzD,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;IACvB,0BAA0B;IAC1B,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAA;IAChC,gCAAgC;IAChC,KAAK,EAAE,UAAU,CAAA;IACjB,wBAAwB;IACxB,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAA;IACpC;;;;OAIG;IACH,YAAY,CAAC,EAAE,UAAU,CAAA;IACzB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA8PD,eAAO,MAAM,oBAAoB,EAAkD,CAAC,KAAK,EACvF,KAAK,EAAE,yBAAyB,CAAC,KAAK,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;CAAE,KACnF,KAAK,CAAC,YAAY,CACtB"}
+{"version":3,"file":"data-table-filter-panel.d.ts","sourceRoot":"","sources":["../../../src/components/DataTable/data-table-filter-panel.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAgBtD,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAElB,YAAY,EACZ,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,GACrB,CAAA;AACD,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAA;AAsFvG,MAAM,WAAW,yBAAyB,CAAC,KAAK;IAI9C,0BAA0B;IAC1B,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAA;IAChC,gCAAgC;IAChC,KAAK,EAAE,UAAU,CAAA;IACjB,wBAAwB;IACxB,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAA;IACpC;;;;OAIG;IACH,YAAY,CAAC,EAAE,UAAU,CAAA;IACzB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA6PD,eAAO,MAAM,oBAAoB,EAAkD,CAAC,KAAK,EACvF,KAAK,EAAE,yBAAyB,CAAC,KAAK,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;CAAE,KACnF,KAAK,CAAC,YAAY,CACtB"}