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

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'\nimport type { DataTableFilterPanelLabels } from './data-table-filter-labels'\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(\n  type: ColumnType | undefined,\n  operatorLabels: DataTableFilterPanelLabels['operatorLabels'],\n): SelectOption[] {\n  const registry = type && OPERATOR_REGISTRY[type] ? OPERATOR_REGISTRY[type] : OPERATOR_REGISTRY.string\n  return registry.map((op) => ({ value: op.op, label: operatorLabels[op.op] ?? 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\nfunction ConjunctionLabel({\n  index, conjunction, onChange, labels,\n}: {\n  index: number\n  conjunction: Conjunction\n  onChange: (c: Conjunction) => void\n  labels: DataTableFilterPanelLabels\n}) {\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-secondary px-[var(--field-px)] self-center\">{labels.where}</div>\n  }\n  if (index >= 2) {\n    const label = conjunction === 'and' ? labels.and : labels.or\n    return <div className=\"w-20 shrink-0 text-body text-fg-secondary 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={[\n          { value: 'and', label: labels.and },\n          { value: 'or', label: labels.or },\n        ]}\n        value={conjunction}\n        onChange={(v) => onChange(v as Conjunction)}\n        minRows={2}\n        aria-label={labels.conjunctionAriaLabel}\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, labels,\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  labels: DataTableFilterPanelLabels\n}) {\n  const colInfo = filterableColumns.find((c) => c.id === condition.field)\n  const operatorOptions = getOperatorOptions(colInfo?.type, labels.operatorLabels)\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} labels={labels} />\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 [&_.text-fg-muted]:!text-fg-secondary\"\n          size=\"sm\"\n          options={fieldOptions}\n          value={condition.field}\n          onChange={onChangeField}\n          placeholder={labels.fieldPlaceholder}\n          aria-label={labels.fieldAriaLabel}\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={labels.operatorPlaceholder}\n          aria-label={labels.operatorAriaLabel}\n        />\n        {hasValueCell && (\n          <FilterValuePicker\n            shape={valueShape}\n            value={condition.value}\n            onChange={onChangeValue}\n            colInfo={colInfo}\n            disabled={!hasField}\n            ariaLabel={labels.filterValueAriaLabel(colInfo?.label)}\n            labels={labels}\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={labels.deleteCondition} 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  canAddCondition, labels,\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  canAddCondition: boolean\n  labels: DataTableFilterPanelLabels\n}) {\n  return (\n    <div className=\"flex items-start gap-2\">\n      <div className=\"pt-2\">\n        <ConjunctionLabel index={index} conjunction={rootConjunction} onChange={onChangeRootConjunction} labels={labels} />\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            labels={labels}\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} disabled={!canAddCondition}>\n            {labels.addNestedFilter}\n          </Button>\n          {group.children.length === 0 && (\n            <Button variant=\"text\" size=\"sm\" startIcon={Trash2} danger onClick={onRemoveGroup}>\n              {labels.removeEmptyGroup}\n            </Button>\n          )}\n        </div>\n      </div>\n    </div>\n  )\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,44 @@
+import type { DATE_RELATIVE_GROUPS, DATE_RELATIVE_OPTIONS } from './filter-operators';
+type RelativeDateGroupKey = (typeof DATE_RELATIVE_GROUPS)[number]['key'];
+type RelativeDateValue = (typeof DATE_RELATIVE_OPTIONS)[number]['value'];
+export interface DataTableFilterPanelLabels {
+    title: string;
+    resetToDefault: string;
+    close: string;
+    where: string;
+    and: string;
+    or: string;
+    conjunctionAriaLabel: string;
+    fieldPlaceholder: string;
+    fieldAriaLabel: string;
+    operatorPlaceholder: string;
+    operatorAriaLabel: string;
+    valuePlaceholder: string;
+    numberPlaceholder: string;
+    relativeDatePlaceholder: string;
+    singleSelectPlaceholder: string;
+    multiSelectPlaceholder: string;
+    multiSelectEmptyText: string;
+    peoplePlaceholder: string;
+    peopleSearchPlaceholder: string;
+    peopleSearchAriaLabel: string;
+    peopleEmptyText: string;
+    filterValueAriaLabel: (columnLabel?: string) => string;
+    deleteCondition: string;
+    addFilter: string;
+    addGroup: string;
+    addNestedFilter: string;
+    removeEmptyGroup: string;
+    /**
+     * Operator key → visible label override. Missing keys fall back to
+     * `OPERATOR_REGISTRY` labels, preserving the registry as the default SSOT.
+     */
+    operatorLabels: Partial<Record<string, string>>;
+    /** Relative-date group/value overrides; missing keys retain registry defaults. */
+    relativeDateGroupLabels: Partial<Record<RelativeDateGroupKey, string>>;
+    relativeDateOptionLabels: Partial<Record<RelativeDateValue, string>>;
+}
+export declare const DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS: DataTableFilterPanelLabels;
+export declare function resolveDataTableFilterPanelLabels(overrides?: Partial<DataTableFilterPanelLabels>): DataTableFilterPanelLabels;
+export {};
+//# sourceMappingURL=data-table-filter-labels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-filter-labels.d.ts","sourceRoot":"","sources":["../../../src/components/DataTable/data-table-filter-labels.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAErF,KAAK,oBAAoB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAA;AACxE,KAAK,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAA;AAExE,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,EAAE,EAAE,MAAM,CAAA;IACV,oBAAoB,EAAE,MAAM,CAAA;IAC5B,gBAAgB,EAAE,MAAM,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,iBAAiB,EAAE,MAAM,CAAA;IACzB,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,uBAAuB,EAAE,MAAM,CAAA;IAC/B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,oBAAoB,EAAE,MAAM,CAAA;IAC5B,iBAAiB,EAAE,MAAM,CAAA;IACzB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,eAAe,EAAE,MAAM,CAAA;IACvB,oBAAoB,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IACtD,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC/C,kFAAkF;IAClF,uBAAuB,EAAE,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAA;IACtE,wBAAwB,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAA;CACrE;AAGD,eAAO,MAAM,sCAAsC,EAAE,0BA+BpD,CAAA;AAED,wBAAgB,iCAAiC,CAC/C,SAAS,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAC9C,0BAA0B,CAiB5B"}

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

@@ -0,0 +1,55 @@
+const DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS = {
+  title: "篩選",
+  resetToDefault: "恢復預設",
+  close: "關閉",
+  where: "Where",
+  and: "And",
+  or: "Or",
+  conjunctionAriaLabel: "連接詞 — 同 group 共用",
+  fieldPlaceholder: "選擇欄位",
+  fieldAriaLabel: "篩選欄位",
+  operatorPlaceholder: "運算子",
+  operatorAriaLabel: "篩選運算子",
+  valuePlaceholder: "輸入值…",
+  numberPlaceholder: "輸入數字…",
+  relativeDatePlaceholder: "選擇相對日期",
+  singleSelectPlaceholder: "選擇值",
+  multiSelectPlaceholder: "選擇值…",
+  multiSelectEmptyText: "沒有符合的值",
+  peoplePlaceholder: "選擇人員",
+  peopleSearchPlaceholder: "搜尋人員…",
+  peopleSearchAriaLabel: "搜尋篩選人員",
+  peopleEmptyText: "沒有符合的人員",
+  filterValueAriaLabel: (columnLabel) => columnLabel ? `${columnLabel} 篩選值` : "篩選值",
+  deleteCondition: "刪除",
+  addFilter: "加篩選",
+  addGroup: "加入篩選器",
+  addNestedFilter: "加入巢狀篩選",
+  removeEmptyGroup: "移除空群組",
+  operatorLabels: {},
+  relativeDateGroupLabels: {},
+  relativeDateOptionLabels: {}
+};
+function resolveDataTableFilterPanelLabels(overrides) {
+  return {
+    ...DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS,
+    ...overrides,
+    operatorLabels: {
+      ...DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS.operatorLabels,
+      ...overrides == null ? void 0 : overrides.operatorLabels
+    },
+    relativeDateGroupLabels: {
+      ...DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS.relativeDateGroupLabels,
+      ...overrides == null ? void 0 : overrides.relativeDateGroupLabels
+    },
+    relativeDateOptionLabels: {
+      ...DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS.relativeDateOptionLabels,
+      ...overrides == null ? void 0 : overrides.relativeDateOptionLabels
+    }
+  };
+}
+export {
+  DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS,
+  resolveDataTableFilterPanelLabels
+};
+//# sourceMappingURL=data-table-filter-labels.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-filter-labels.js","sources":["../../../src/components/DataTable/data-table-filter-labels.ts"],"sourcesContent":["// @internal — DataTableFilterPanel chrome/operator/value-picker labels shared by\n// panel orchestration, row/group rendering, and value-picker dispatch.\n\nimport type { DATE_RELATIVE_GROUPS, DATE_RELATIVE_OPTIONS } from './filter-operators'\n\ntype RelativeDateGroupKey = (typeof DATE_RELATIVE_GROUPS)[number]['key']\ntype RelativeDateValue = (typeof DATE_RELATIVE_OPTIONS)[number]['value']\n\nexport interface DataTableFilterPanelLabels {\n  title: string\n  resetToDefault: string\n  close: string\n  where: string\n  and: string\n  or: string\n  conjunctionAriaLabel: string\n  fieldPlaceholder: string\n  fieldAriaLabel: string\n  operatorPlaceholder: string\n  operatorAriaLabel: string\n  valuePlaceholder: string\n  numberPlaceholder: string\n  relativeDatePlaceholder: string\n  singleSelectPlaceholder: string\n  multiSelectPlaceholder: string\n  multiSelectEmptyText: string\n  peoplePlaceholder: string\n  peopleSearchPlaceholder: string\n  peopleSearchAriaLabel: string\n  peopleEmptyText: string\n  filterValueAriaLabel: (columnLabel?: string) => string\n  deleteCondition: string\n  addFilter: string\n  addGroup: string\n  addNestedFilter: string\n  removeEmptyGroup: string\n  /**\n   * Operator key → visible label override. Missing keys fall back to\n   * `OPERATOR_REGISTRY` labels, preserving the registry as the default SSOT.\n   */\n  operatorLabels: Partial<Record<string, string>>\n  /** Relative-date group/value overrides; missing keys retain registry defaults. */\n  relativeDateGroupLabels: Partial<Record<RelativeDateGroupKey, string>>\n  relativeDateOptionLabels: Partial<Record<RelativeDateValue, string>>\n}\n\n// code-quality-allow: dead-export — public i18n defaults, re-exported by panel.\nexport const DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS: DataTableFilterPanelLabels = {\n  title: '篩選',\n  resetToDefault: '恢復預設',\n  close: '關閉',\n  where: 'Where',\n  and: 'And',\n  or: 'Or',\n  conjunctionAriaLabel: '連接詞 — 同 group 共用',\n  fieldPlaceholder: '選擇欄位',\n  fieldAriaLabel: '篩選欄位',\n  operatorPlaceholder: '運算子',\n  operatorAriaLabel: '篩選運算子',\n  valuePlaceholder: '輸入值…',\n  numberPlaceholder: '輸入數字…',\n  relativeDatePlaceholder: '選擇相對日期',\n  singleSelectPlaceholder: '選擇值',\n  multiSelectPlaceholder: '選擇值…',\n  multiSelectEmptyText: '沒有符合的值',\n  peoplePlaceholder: '選擇人員',\n  peopleSearchPlaceholder: '搜尋人員…',\n  peopleSearchAriaLabel: '搜尋篩選人員',\n  peopleEmptyText: '沒有符合的人員',\n  filterValueAriaLabel: (columnLabel) => columnLabel ? `${columnLabel} 篩選值` : '篩選值',\n  deleteCondition: '刪除',\n  addFilter: '加篩選',\n  addGroup: '加入篩選器',\n  addNestedFilter: '加入巢狀篩選',\n  removeEmptyGroup: '移除空群組',\n  operatorLabels: {},\n  relativeDateGroupLabels: {},\n  relativeDateOptionLabels: {},\n}\n\nexport function resolveDataTableFilterPanelLabels(\n  overrides?: Partial<DataTableFilterPanelLabels>,\n): DataTableFilterPanelLabels {\n  return {\n    ...DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS,\n    ...overrides,\n    operatorLabels: {\n      ...DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS.operatorLabels,\n      ...overrides?.operatorLabels,\n    },\n    relativeDateGroupLabels: {\n      ...DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS.relativeDateGroupLabels,\n      ...overrides?.relativeDateGroupLabels,\n    },\n    relativeDateOptionLabels: {\n      ...DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS.relativeDateOptionLabels,\n      ...overrides?.relativeDateOptionLabels,\n    },\n  }\n}\n"],"names":[],"mappings":"AA+CO,MAAM,yCAAqE;AAAA,EAChF,OAAO;AAAA,EACP,gBAAgB;AAAA,EAChB,OAAO;AAAA,EACP,OAAO;AAAA,EACP,KAAK;AAAA,EACL,IAAI;AAAA,EACJ,sBAAsB;AAAA,EACtB,kBAAkB;AAAA,EAClB,gBAAgB;AAAA,EAChB,qBAAqB;AAAA,EACrB,mBAAmB;AAAA,EACnB,kBAAkB;AAAA,EAClB,mBAAmB;AAAA,EACnB,yBAAyB;AAAA,EACzB,yBAAyB;AAAA,EACzB,wBAAwB;AAAA,EACxB,sBAAsB;AAAA,EACtB,mBAAmB;AAAA,EACnB,yBAAyB;AAAA,EACzB,uBAAuB;AAAA,EACvB,iBAAiB;AAAA,EACjB,sBAAsB,CAAC,gBAAgB,cAAc,GAAG,WAAW,SAAS;AAAA,EAC5E,iBAAiB;AAAA,EACjB,WAAW;AAAA,EACX,UAAU;AAAA,EACV,iBAAiB;AAAA,EACjB,kBAAkB;AAAA,EAClB,gBAAgB,CAAA;AAAA,EAChB,yBAAyB,CAAA;AAAA,EACzB,0BAA0B,CAAA;AAC5B;AAEO,SAAS,kCACd,WAC4B;AAC5B,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAG;AAAA,IACH,gBAAgB;AAAA,MACd,GAAG,uCAAuC;AAAA,MAC1C,GAAG,uCAAW;AAAA,IAAA;AAAA,IAEhB,yBAAyB;AAAA,MACvB,GAAG,uCAAuC;AAAA,MAC1C,GAAG,uCAAW;AAAA,IAAA;AAAA,IAEhB,0BAA0B;AAAA,MACxB,GAAG,uCAAuC;AAAA,MAC1C,GAAG,uCAAW;AAAA,IAAA;AAAA,EAChB;AAEJ;"}

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

@@ -1,11 +1,12 @@
 import * as React from 'react';
 import type { ColumnDef } from '@tanstack/react-table';
 import { createEmptyFilterTree, isFilterTreeActive, evaluateTree, dataTableFilterMatch, type Conjunction, type FilterCondition, type FilterGroup, type FilterTree, type FilterTreeFlat, type FilterTreeNested } from './filter-tree';
+import { DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS, type DataTableFilterPanelLabels } from './data-table-filter-labels';
 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';
+export { DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS };
+export type { DataTableFilterPanelLabels };
+export interface DataTableFilterPanelProps<TData> extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
     /** 可被 filter 的 columns */
     columns: ColumnDef<TData, any>[];
     /** 當前 FilterTree(controlled) */
@@ -21,6 +22,14 @@ export interface DataTableFilterPanelProps<TData> {
     /** Cell ⌄ menu「Filter by this」帶入的 column id(自動 add 一條 condition) */
     prefilledColumnId?: string;
     onPrefillConsumed?: () => void;
+    /**
+     * Condition leaf 上限(flat children 或 nested 所有 group.children 的總和)。
+     * 預設不限。到上限後所有 add 路徑與 prefill 都 fail closed；controlled value
+     * 已超過上限時保留原資料、不裁切，只停用後續新增。
+     */
+    maxConditions?: number;
+    /** Panel chrome/operator/value-picker labels. Nested maps are deep-merged with defaults. */
+    labels?: Partial<DataTableFilterPanelLabels>;
     onClose?: () => void;
     className?: string;
 }

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;AAuTvG,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;AA2PD,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;AACtB,OAAO,EACL,sCAAsC,EAEtC,KAAK,0BAA0B,EAChC,MAAM,4BAA4B,CAAA;AAGnC,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;AACvG,OAAO,EAAE,sCAAsC,EAAE,CAAA;AACjD,YAAY,EAAE,0BAA0B,EAAE,CAAA;AAiG1C,MAAM,WAAW,yBAAyB,CAAC,KAAK,CAAE,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,cAAc,CAAC;IAI/H,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;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAA;IAC5C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAgRD,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"}

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

@@ -0,0 +1,316 @@
+import { jsxs, jsx, Fragment } from "react/jsx-runtime";
+import * as React from "react";
+import { RotateCcw, X, Plus } from "lucide-react";
+import { cn } from "../../lib/utils.js";
+import { Button } from "../Button/button.js";
+import { SurfaceHeader, COMPACT_HEADER_SLOT, SurfaceBody } from "../../patterns/overlay-surface/overlay-surface.js";
+import { PopoverTitle, PopoverClose } from "../Popover/popover.js";
+import { ButtonDivider } from "../Button/button-group.js";
+import { getColumnId, getColumnMeta, getColumnLabel } from "./lib/column-meta.js";
+import { datePrecisionOf, getDefaultOperator, FilterRow, GroupBlock } from "./data-table-filter-group.js";
+import { isFilterTreeEqual } from "./filter-tree.js";
+import { createEmptyFilterTree, dataTableFilterMatch, evaluateTree, isFilterTreeActive } from "./filter-tree.js";
+import { resolveDataTableFilterPanelLabels } from "./data-table-filter-labels.js";
+import { DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS } from "./data-table-filter-labels.js";
+let _idSeed = 0;
+const newId = () => `f${++_idSeed}-${Date.now().toString(36)}`;
+function extractColumns(columns) {
+  const out = [];
+  for (const col of columns) {
+    const id = getColumnId(col);
+    if (!id || id === "__select__") continue;
+    const meta = getColumnMeta(col);
+    const type = meta == null ? void 0 : meta.type;
+    if (!type) continue;
+    if ((meta == null ? void 0 : meta.filterable) === false) continue;
+    out.push({
+      id,
+      label: getColumnLabel(col, id),
+      type,
+      options: meta == null ? void 0 : meta.options,
+      people: meta == null ? void 0 : meta.people,
+      includeTime: meta == null ? void 0 : meta.includeTime
+    });
+  }
+  return out;
+}
+const newCondition = (firstCol) => ({
+  kind: "cond",
+  id: newId(),
+  field: (firstCol == null ? void 0 : firstCol.id) ?? "",
+  op: firstCol ? getDefaultOperator(firstCol.type) : "",
+  value: "",
+  datePrecision: datePrecisionOf(firstCol)
+});
+const newEmptyCondition = () => ({
+  kind: "cond",
+  id: newId(),
+  field: "",
+  op: "",
+  value: ""
+});
+const newGroup = (firstCol) => ({
+  kind: "group",
+  id: newId(),
+  conjunction: "or",
+  // group 內 default OR(對齊 ref 圖)
+  children: [newCondition(firstCol)]
+});
+const newEmptyGroup = () => ({
+  kind: "group",
+  id: newId(),
+  conjunction: "or",
+  children: [newEmptyCondition()]
+});
+const countFilterConditions = (tree) => tree.mode === "flat" ? tree.children.length : tree.children.reduce((total, group) => total + group.children.length, 0);
+const normalizeMaxConditions = (maxConditions) => {
+  if (maxConditions === void 0 || maxConditions === Number.POSITIVE_INFINITY) return Number.POSITIVE_INFINITY;
+  if (!Number.isFinite(maxConditions)) return 0;
+  return Math.max(0, Math.floor(maxConditions));
+};
+function DataTableFilterPanelInner({
+  columns,
+  value,
+  onChange,
+  defaultValue,
+  prefilledColumnId,
+  onPrefillConsumed,
+  maxConditions,
+  labels: labelsOverride,
+  onClose,
+  className,
+  ...props
+}, ref) {
+  const filterableColumns = React.useMemo(() => extractColumns(columns), [columns]);
+  const fieldOptions = React.useMemo(
+    () => filterableColumns.map((c) => ({ value: c.id, label: c.label })),
+    [filterableColumns]
+  );
+  const labels = React.useMemo(
+    () => resolveDataTableFilterPanelLabels(labelsOverride),
+    [labelsOverride]
+  );
+  const conditionCount = countFilterConditions(value);
+  const normalizedMaxConditions = normalizeMaxConditions(maxConditions);
+  const canAddCondition = conditionCount < normalizedMaxConditions;
+  const initialMountDoneRef = React.useRef(false);
+  React.useEffect(() => {
+    if (initialMountDoneRef.current) return;
+    initialMountDoneRef.current = true;
+    if (filterableColumns.length === 0) return;
+    if (value.children.length > 0) return;
+    if (!canAddCondition) return;
+    if (value.mode === "flat") {
+      onChange({ ...value, children: [newEmptyCondition()] });
+    } else {
+      onChange({ ...value, children: [newEmptyGroup()] });
+    }
+  }, [filterableColumns.length]);
+  React.useEffect(() => {
+    if (!prefilledColumnId) return;
+    const colInfo = filterableColumns.find((c) => c.id === prefilledColumnId);
+    if (colInfo && canAddCondition) {
+      const cond = {
+        kind: "cond",
+        id: newId(),
+        field: prefilledColumnId,
+        op: getDefaultOperator(colInfo.type),
+        value: "",
+        // 2026-07-14 deep-audit fix:補 datePrecision(原漏 → datetime(includeTime=true)欄
+        // prefill 掉到 undefined=day 精度忽略 ms;對齊初始 add / changeField 路徑的 datePrecisionOf)
+        datePrecision: datePrecisionOf(colInfo)
+      };
+      if (value.mode === "flat") {
+        onChange({ ...value, children: [...value.children, cond] });
+      } else {
+        if (value.children.length === 0) {
+          onChange({ ...value, children: [{ ...newGroup(colInfo), children: [cond] }] });
+        } else {
+          const updatedGroups = value.children.map(
+            (g, i) => i === 0 ? { ...g, children: [...g.children, cond] } : g
+          );
+          onChange({ ...value, children: updatedGroups });
+        }
+      }
+    }
+    onPrefillConsumed == null ? void 0 : onPrefillConsumed();
+  }, [prefilledColumnId]);
+  const flatTree = value.mode === "flat" ? value : null;
+  const updateFlatCondition = (id, patch) => {
+    if (!flatTree) return;
+    onChange({
+      ...flatTree,
+      children: flatTree.children.map((c) => c.id === id ? { ...c, ...patch } : c)
+    });
+  };
+  const removeFlatCondition = (id) => {
+    if (!flatTree) return;
+    onChange({ ...flatTree, children: flatTree.children.filter((c) => c.id !== id) });
+  };
+  const addFlatCondition = () => {
+    if (!flatTree || !canAddCondition) return;
+    onChange({ ...flatTree, children: [...flatTree.children, newEmptyCondition()] });
+  };
+  const setFlatConjunction = (conj) => {
+    if (!flatTree) return;
+    onChange({ ...flatTree, conjunction: conj });
+  };
+  const nestedTree = value.mode === "nested" ? value : null;
+  const updateGroup = (groupId, patch) => {
+    if (!nestedTree) return;
+    onChange({
+      ...nestedTree,
+      children: nestedTree.children.map((g) => g.id === groupId ? { ...g, ...patch } : g)
+    });
+  };
+  const updateGroupCondition = (groupId, condId, patch) => {
+    if (!nestedTree) return;
+    onChange({
+      ...nestedTree,
+      children: nestedTree.children.map(
+        (g) => g.id === groupId ? { ...g, children: g.children.map((c) => c.id === condId ? { ...c, ...patch } : c) } : g
+      )
+    });
+  };
+  const removeGroupCondition = (groupId, condId) => {
+    if (!nestedTree) return;
+    onChange({
+      ...nestedTree,
+      children: nestedTree.children.map(
+        (g) => g.id === groupId ? { ...g, children: g.children.filter((c) => c.id !== condId) } : g
+      )
+    });
+  };
+  const addConditionToGroup = (groupId) => {
+    if (!nestedTree || !canAddCondition) return;
+    onChange({
+      ...nestedTree,
+      children: nestedTree.children.map(
+        (g) => g.id === groupId ? { ...g, children: [...g.children, newEmptyCondition()] } : g
+      )
+    });
+  };
+  const removeGroup = (groupId) => {
+    if (!nestedTree) return;
+    onChange({ ...nestedTree, children: nestedTree.children.filter((g) => g.id !== groupId) });
+  };
+  const addGroup = () => {
+    if (!nestedTree || !canAddCondition) return;
+    onChange({ ...nestedTree, children: [...nestedTree.children, newEmptyGroup()] });
+  };
+  const setRootConjunction = (conj) => {
+    if (!nestedTree) return;
+    onChange({ ...nestedTree, conjunction: conj });
+  };
+  return (
+    // 寬度策略:desktop 680px;mobile 縮到 viewport 內留 32px 邊(避溢出 popover 切右半)。
+    // 對齊 Notion / Airtable 的 advanced filter 在 mobile 走 full-width 邊處理。
+    // **#8 fix(2026-05-04)**:popover width by mode(由 cell min-w 與 group nested chrome 反推)
+    //   flat:cell ConjunctionLabel(80) + gap-2(8) + FCG(field-min 160 + op-min 120 + value 200) +
+    //         gap-2(8) + trash(28) + 2×loose padding(32) = ~636 → 640px
+    //   nested:再加 group p-2 (16) + outer ConjunctionLabel (80) + outer gap (8) → ~740 → 760px
+    //   對齊 Airtable / Notion / Linear filter row 視覺密度 @benchmark-unverified(non-OSS)
+    // **K11 fix(2026-05-04)**:viewport-aware scroll chain invariant
+    //   parent PopoverContent 是 flex flex-col + max-h + overflow-hidden,
+    //   panel root 必 forward `flex flex-col h-full` 才能讓 SurfaceBody flex-1 min-h-0 overflow-y-auto 生效
+    //   無此 forward → 中間 wrapper 斷鏈 → body 不 scroll(ProfileCard 因為自身設 max-h flex-col 才繞過)
+    //   詳 overlay-surface.spec.md「viewport-aware scroll chain invariant」段
+    // K11 v2 fix(2026-05-04):flex item 預設 min-h:auto 讓 content 撐 height,h-full 失效。
+    // 必加 `min-h-0` 才能讓 panel 在 PopoverContent max-h cap 下正確 shrink + body scroll。
+    /* @__PURE__ */ jsxs(
+      "div",
+      {
+        ref,
+        className: cn(
+          "flex flex-col h-full min-h-0",
+          value.mode === "nested" ? "w-[min(760px,calc(100vw-2rem))]" : "w-[min(640px,calc(100vw-2rem))]",
+          className
+        ),
+        ...props,
+        children: [
+          /* @__PURE__ */ jsxs(SurfaceHeader, { className: COMPACT_HEADER_SLOT, children: [
+            /* @__PURE__ */ jsx(PopoverTitle, { className: "flex-1", children: labels.title }),
+            defaultValue && !isFilterTreeEqual(value, defaultValue) && /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx(
+                Button,
+                {
+                  variant: "text",
+                  size: "sm",
+                  iconOnly: true,
+                  startIcon: RotateCcw,
+                  "aria-label": labels.resetToDefault,
+                  onClick: () => onChange(defaultValue)
+                }
+              ),
+              onClose && /* @__PURE__ */ jsx(ButtonDivider, {})
+            ] }),
+            onClose && /* @__PURE__ */ jsx(PopoverClose, { asChild: true, children: /* @__PURE__ */ jsx(Button, { "data-dismiss": true, iconOnly: true, dismiss: true, size: "sm", startIcon: X, "aria-label": labels.close, onClick: onClose }) })
+          ] }),
+          /* @__PURE__ */ jsxs(SurfaceBody, { className: "flex flex-col gap-[var(--layout-space-tight)]", children: [
+            flatTree && flatTree.children.map((cond, idx) => /* @__PURE__ */ jsx(
+              FilterRow,
+              {
+                index: idx,
+                condition: cond,
+                conjunction: flatTree.conjunction,
+                filterableColumns,
+                fieldOptions,
+                onChangeConjunction: setFlatConjunction,
+                onChangeField: (v) => {
+                  const newCol = filterableColumns.find((c) => c.id === v);
+                  updateFlatCondition(cond.id, { field: v, op: getDefaultOperator(newCol == null ? void 0 : newCol.type), value: "", datePrecision: datePrecisionOf(newCol) });
+                },
+                onChangeOp: (v) => updateFlatCondition(cond.id, { op: v, value: "" }),
+                onChangeValue: (v) => updateFlatCondition(cond.id, { value: v }),
+                onRemove: () => removeFlatCondition(cond.id),
+                labels
+              },
+              cond.id
+            )),
+            nestedTree && nestedTree.children.map((group, gIdx) => /* @__PURE__ */ jsx(
+              GroupBlock,
+              {
+                index: gIdx,
+                group,
+                rootConjunction: nestedTree.conjunction,
+                filterableColumns,
+                fieldOptions,
+                onChangeRootConjunction: setRootConjunction,
+                onChangeGroupConjunction: (c) => updateGroup(group.id, { conjunction: c }),
+                onChangeCondition: (condId, patch) => updateGroupCondition(group.id, condId, patch),
+                onRemoveCondition: (condId) => removeGroupCondition(group.id, condId),
+                onAddCondition: () => addConditionToGroup(group.id),
+                onRemoveGroup: () => removeGroup(group.id),
+                canAddCondition,
+                labels
+              },
+              group.id
+            )),
+            /* @__PURE__ */ jsx("div", { children: /* @__PURE__ */ jsx(
+              Button,
+              {
+                variant: "tertiary",
+                size: "sm",
+                startIcon: Plus,
+                onClick: value.mode === "flat" ? addFlatCondition : addGroup,
+                disabled: !canAddCondition,
+                children: value.mode === "nested" ? labels.addGroup : labels.addFilter
+              }
+            ) })
+          ] })
+        ]
+      }
+    )
+  );
+}
+const DataTableFilterPanel = React.forwardRef(DataTableFilterPanelInner);
+DataTableFilterPanel.displayName = "DataTableFilterPanel";
+export {
+  DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS,
+  DataTableFilterPanel,
+  createEmptyFilterTree,
+  dataTableFilterMatch,
+  evaluateTree,
+  isFilterTreeActive
+};
+//# sourceMappingURL=data-table-filter-panel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-filter-panel.js","sources":["../../../src/components/DataTable/data-table-filter-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// same-row-mixed-allow: header chrome corner buttons(close)跟 row inline actions(trash)不在同 row\nimport * as React from 'react'\nimport { Plus, X as XIcon, RotateCcw } from 'lucide-react'\nimport type { ColumnDef } from '@tanstack/react-table'\nimport { cn } from '@/lib/utils'\nimport { Button } from '@/design-system/components/Button/button'\nimport type { SelectOption } from '@/design-system/components/Select/select'\nimport { SurfaceHeader, SurfaceBody, COMPACT_HEADER_SLOT } from '@/design-system/patterns/overlay-surface/overlay-surface'\nimport { PopoverTitle, PopoverClose } from '@/design-system/components/Popover/popover'\nimport { ButtonDivider } from '@/design-system/components/Button/button-group'\nimport type { ColumnType } from './column-types'\nimport { getColumnId, getColumnLabel, getColumnMeta } from './lib/column-meta'\nimport {\n  FilterRow,\n  GroupBlock,\n  getDefaultOperator,\n  datePrecisionOf,\n  type FilterColumn,\n} from './data-table-filter-group'\nimport {\n  createEmptyFilterTree,\n  isFilterTreeActive,\n  isFilterTreeEqual,\n  evaluateTree,\n  dataTableFilterMatch,\n  type Conjunction,\n  type FilterCondition,\n  type FilterGroup,\n  type FilterTree,\n  type FilterTreeFlat,\n  type FilterTreeNested,\n} from './filter-tree'\nimport {\n  DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS,\n  resolveDataTableFilterPanelLabels,\n  type DataTableFilterPanelLabels,\n} from './data-table-filter-labels'\n\n// Re-export public API from filter-tree(consumer 既有 import path 不變)\nexport {\n  createEmptyFilterTree,\n  isFilterTreeActive,\n  evaluateTree,\n  dataTableFilterMatch,\n}\nexport type { Conjunction, FilterCondition, FilterGroup, FilterTree, FilterTreeFlat, FilterTreeNested }\nexport { DATA_TABLE_FILTER_PANEL_DEFAULT_LABELS }\nexport type { DataTableFilterPanelLabels }\n\n/**\n * DataTableFilterPanel — ClickUp-style 進階篩選 panel\n *\n * 對齊 ClickUp / Airtable / Notion / Coda / Linear advanced-filter 派 —\n * parenthesized boolean expression builder。\n *\n * 兩種 mode 由 consumer 拍板:\n * - `flat`:root 下只能裝 condition,無 group\n * - `nested`:root 下裝 1+ group(灰底框),每個 group 內裝 1+ condition,**剛好 1 層**\n *\n * Source-of-truth:\n * - Operator definitions:`./filter-operators.ts` `OPERATOR_REGISTRY`(SSOT,禁 hardcode op 字串)\n * - Filter state:**FilterTree**(本檔自管;搭配 TanStack `globalFilter` 求值)\n * - Row / nested-group renderer:`./data-table-filter-group.tsx`;value picker:\n *   `./data-table-filter-value-picker.tsx`(皆 @internal — 2026-07-14 file-size 拆檔,\n *   本檔只留 orchestration:columns 抽取 / FilterTree mutators / panel chrome)\n *\n * 詳:`./filter-operators.spec.md`\n */\n\n// ── Internal — id seed ──────────────────────────────────────────────────\n\nlet _idSeed = 0\nconst newId = () => `f${++_idSeed}-${Date.now().toString(36)}`\n\n// ── Helpers — column extraction + condition factories ──────────────────\n// (FilterColumn type + operator helpers 住 ./data-table-filter-group.tsx)\n\nfunction extractColumns<TData>(columns: ColumnDef<TData, any>[]): FilterColumn[] {\n  const out: FilterColumn[] = []\n  for (const col of columns) {\n    const id = getColumnId(col)\n    if (!id || id === '__select__') continue\n    const meta = getColumnMeta(col)\n    const type: ColumnType | undefined = meta?.type\n    if (!type) continue\n    if (meta?.filterable === false) continue\n    out.push({\n      id,\n      label: getColumnLabel(col, id),\n      type,\n      options: meta?.options,\n      people: meta?.people,\n      includeTime: meta?.includeTime,\n    })\n  }\n  return out\n}\n\nconst newCondition = (firstCol: FilterColumn | undefined): FilterCondition => ({\n  kind: 'cond',\n  id: newId(),\n  field: firstCol?.id ?? '',\n  op: firstCol ? getDefaultOperator(firstCol.type) : '',\n  value: '',\n  datePrecision: datePrecisionOf(firstCol),\n})\n\n// **G fix(2026-05-04)**:initial-mount 用 — field 不預選,user 自選後 op/value 才 enable\n//   Disabled state(field='')→ op + value 在 FilterRow 內走 `disabled={!hasField}` 自動連動\nconst newEmptyCondition = (): FilterCondition => ({\n  kind: 'cond',\n  id: newId(),\n  field: '',\n  op: '',\n  value: '',\n})\n\nconst newGroup = (firstCol: FilterColumn | undefined): FilterGroup => ({\n  kind: 'group',\n  id: newId(),\n  conjunction: 'or',                                // group 內 default OR(對齊 ref 圖)\n  children: [newCondition(firstCol)],\n})\n\nconst newEmptyGroup = (): FilterGroup => ({\n  kind: 'group',\n  id: newId(),\n  conjunction: 'or',\n  children: [newEmptyCondition()],\n})\n\nconst countFilterConditions = (tree: FilterTree): number =>\n  tree.mode === 'flat'\n    ? tree.children.length\n    : tree.children.reduce((total, group) => total + group.children.length, 0)\n\nconst normalizeMaxConditions = (maxConditions: number | undefined): number => {\n  if (maxConditions === undefined || maxConditions === Number.POSITIVE_INFINITY) return Number.POSITIVE_INFINITY\n  if (!Number.isFinite(maxConditions)) return 0\n  return Math.max(0, Math.floor(maxConditions))\n}\n\n// ── Component Props ─────────────────────────────────────────────────────\n\nexport interface DataTableFilterPanelProps<TData> extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {\n  // 2026-07-18 決策17:移除獨立 `mode` prop(單一真相源 = `value.mode` discriminant)——\n  //   舊設計 mode + value.mode 兩來源型別允許矛盾(mode='nested' 配 flat value → CTA 錯文案 + 死操作);\n  //   無外部消費者傳 mode(grep 0),全由 value.mode 推導。對齊 MUI X GridFilterModel / AG Grid 單一 model。\n  /** 可被 filter 的 columns */\n  columns: ColumnDef<TData, any>[]\n  /** 當前 FilterTree(controlled) */\n  value: FilterTree\n  /** state 變更 callback */\n  onChange: (next: FilterTree) => void\n  /**\n   * 管理員 set-as-default 的 baseline(refresh icon 顯示判定用)。\n   * 當 `value` ≠ `defaultValue`(deep equal)→ panel header 顯示 refresh icon,\n   * click → reset 回 defaultValue。對齊 sort 邏輯(相同 modified-from-default UX)。\n   */\n  defaultValue?: FilterTree\n  /** Cell ⌄ menu「Filter by this」帶入的 column id(自動 add 一條 condition) */\n  prefilledColumnId?: string\n  onPrefillConsumed?: () => void\n  /**\n   * Condition leaf 上限(flat children 或 nested 所有 group.children 的總和)。\n   * 預設不限。到上限後所有 add 路徑與 prefill 都 fail closed；controlled value\n   * 已超過上限時保留原資料、不裁切，只停用後續新增。\n   */\n  maxConditions?: number\n  /** Panel chrome/operator/value-picker labels. Nested maps are deep-merged with defaults. */\n  labels?: Partial<DataTableFilterPanelLabels>\n  onClose?: () => void\n  className?: string\n}\n\n// ── Main Component ──────────────────────────────────────────────────────\n\n// 內部 fn — generic + ref 轉發。export 走 cast(對齊 DataTable 同 pattern)\nfunction DataTableFilterPanelInner<TData>({\n  columns,\n  value,\n  onChange,\n  defaultValue,\n  prefilledColumnId,\n  onPrefillConsumed,\n  maxConditions,\n  labels: labelsOverride,\n  onClose,\n  className,\n  ...props\n}: DataTableFilterPanelProps<TData>, ref: React.ForwardedRef<HTMLDivElement>): React.ReactElement {\n  const filterableColumns = React.useMemo(() => extractColumns(columns), [columns])\n  const fieldOptions: SelectOption[] = React.useMemo(\n    () => filterableColumns.map((c) => ({ value: c.id, label: c.label })),\n    [filterableColumns],\n  )\n  const labels = React.useMemo(\n    () => resolveDataTableFilterPanelLabels(labelsOverride),\n    [labelsOverride],\n  )\n  const conditionCount = countFilterConditions(value)\n  const normalizedMaxConditions = normalizeMaxConditions(maxConditions)\n  const canAddCondition = conditionCount < normalizedMaxConditions\n  // K13 後 firstCol 不再被 add* 消費(改用 newEmpty*),這裡只留 prefill effect 用(已直接讀 prefilledColumnId)。\n\n  // **G fix(2026-05-04 v2)**:initial-mount 預設 1 empty row(field 未選 → op+value 自動 disabled)\n  //   useRef gate → 只 mount 一次;user 後續手動刪光 → 不 re-add → 維持「全清 = empty CTA only」UX\n  //   Two states clearly separated:\n  //     (a) Initial mount with empty value → auto-add 1 empty row(讓 user 看到 row shape,不必先點 CTA)\n  //     (b) User explicitly deletes all → empty CTA only(無 row,respect user intent)\n  const initialMountDoneRef = React.useRef(false)\n  React.useEffect(() => {\n    if (initialMountDoneRef.current) return\n    initialMountDoneRef.current = true\n    if (filterableColumns.length === 0) return\n    if (value.children.length > 0) return\n    if (!canAddCondition) return\n    if (value.mode === 'flat') {\n      onChange({ ...value, children: [newEmptyCondition()] } as FilterTreeFlat)\n    } else {\n      onChange({ ...value, children: [newEmptyGroup()] } as FilterTreeNested)\n    }\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [filterableColumns.length])\n\n  // Prefill from cell ⌄ menu「Filter by this」\n  React.useEffect(() => {\n    if (!prefilledColumnId) return\n    const colInfo = filterableColumns.find((c) => c.id === prefilledColumnId)\n    if (colInfo && canAddCondition) {\n      const cond: FilterCondition = {\n        kind: 'cond',\n        id: newId(),\n        field: prefilledColumnId,\n        op: getDefaultOperator(colInfo.type),\n        value: '',\n        // 2026-07-14 deep-audit fix:補 datePrecision(原漏 → datetime(includeTime=true)欄\n        // prefill 掉到 undefined=day 精度忽略 ms;對齊初始 add / changeField 路徑的 datePrecisionOf)\n        datePrecision: datePrecisionOf(colInfo),\n      }\n      if (value.mode === 'flat') {\n        onChange({ ...value, children: [...value.children, cond] })\n      } else {\n        // nested mode:add 到第 1 個 group(若無則新建)\n        if (value.children.length === 0) {\n          onChange({ ...value, children: [{ ...newGroup(colInfo), children: [cond] }] })\n        } else {\n          const updatedGroups = value.children.map((g, i) =>\n            i === 0 ? { ...g, children: [...g.children, cond] } : g\n          )\n          onChange({ ...value, children: updatedGroups })\n        }\n      }\n    }\n    onPrefillConsumed?.()\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [prefilledColumnId])\n\n  // ── flat-mode mutators ──\n  const flatTree = value.mode === 'flat' ? value : null\n  const updateFlatCondition = (id: string, patch: Partial<FilterCondition>) => {\n    if (!flatTree) return\n    onChange({\n      ...flatTree,\n      children: flatTree.children.map((c) => (c.id === id ? { ...c, ...patch } : c)),\n    })\n  }\n  const removeFlatCondition = (id: string) => {\n    if (!flatTree) return\n    onChange({ ...flatTree, children: flatTree.children.filter((c) => c.id !== id) })\n  }\n  const addFlatCondition = () => {\n    if (!flatTree || !canAddCondition) return\n    // K13 fix(2026-05-04):加篩選 → empty row(field 未選 → op+value disabled)\n    //   World-class:Notion / Coda / ClickUp 不 auto-select;對齊 initial mount canonical\n    onChange({ ...flatTree, children: [...flatTree.children, newEmptyCondition()] })\n  }\n  const setFlatConjunction = (conj: Conjunction) => {\n    if (!flatTree) return\n    onChange({ ...flatTree, conjunction: conj })\n  }\n\n  // ── nested-mode mutators ──\n  const nestedTree = value.mode === 'nested' ? value : null\n  const updateGroup = (groupId: string, patch: Partial<FilterGroup>) => {\n    if (!nestedTree) return\n    onChange({\n      ...nestedTree,\n      children: nestedTree.children.map((g) => (g.id === groupId ? { ...g, ...patch } : g)),\n    })\n  }\n  const updateGroupCondition = (groupId: string, condId: string, patch: Partial<FilterCondition>) => {\n    if (!nestedTree) return\n    onChange({\n      ...nestedTree,\n      children: nestedTree.children.map((g) =>\n        g.id === groupId\n          ? { ...g, children: g.children.map((c) => (c.id === condId ? { ...c, ...patch } : c)) }\n          : g\n      ),\n    })\n  }\n  const removeGroupCondition = (groupId: string, condId: string) => {\n    if (!nestedTree) return\n    onChange({\n      ...nestedTree,\n      children: nestedTree.children.map((g) =>\n        g.id === groupId ? { ...g, children: g.children.filter((c) => c.id !== condId) } : g\n      ),\n    })\n  }\n  // K13 fix(2026-05-04):同 addFlatCondition,巢狀內加條件也 empty row\n  const addConditionToGroup = (groupId: string) => {\n    if (!nestedTree || !canAddCondition) return\n    onChange({\n      ...nestedTree,\n      children: nestedTree.children.map((g) =>\n        g.id === groupId ? { ...g, children: [...g.children, newEmptyCondition()] } : g\n      ),\n    })\n  }\n  const removeGroup = (groupId: string) => {\n    if (!nestedTree) return\n    onChange({ ...nestedTree, children: nestedTree.children.filter((g) => g.id !== groupId) })\n  }\n  const addGroup = () => {\n    if (!nestedTree || !canAddCondition) return\n    // K13:加群組也用 empty group\n    onChange({ ...nestedTree, children: [...nestedTree.children, newEmptyGroup()] })\n  }\n  const setRootConjunction = (conj: Conjunction) => {\n    if (!nestedTree) return\n    onChange({ ...nestedTree, conjunction: conj })\n  }\n\n  return (\n    // 寬度策略:desktop 680px;mobile 縮到 viewport 內留 32px 邊(避溢出 popover 切右半)。\n    // 對齊 Notion / Airtable 的 advanced filter 在 mobile 走 full-width 邊處理。\n    // **#8 fix(2026-05-04)**:popover width by mode(由 cell min-w 與 group nested chrome 反推)\n    //   flat:cell ConjunctionLabel(80) + gap-2(8) + FCG(field-min 160 + op-min 120 + value 200) +\n    //         gap-2(8) + trash(28) + 2×loose padding(32) = ~636 → 640px\n    //   nested:再加 group p-2 (16) + outer ConjunctionLabel (80) + outer gap (8) → ~740 → 760px\n    //   對齊 Airtable / Notion / Linear filter row 視覺密度 @benchmark-unverified(non-OSS)\n    // **K11 fix(2026-05-04)**:viewport-aware scroll chain invariant\n    //   parent PopoverContent 是 flex flex-col + max-h + overflow-hidden,\n    //   panel root 必 forward `flex flex-col h-full` 才能讓 SurfaceBody flex-1 min-h-0 overflow-y-auto 生效\n    //   無此 forward → 中間 wrapper 斷鏈 → body 不 scroll(ProfileCard 因為自身設 max-h flex-col 才繞過)\n    //   詳 overlay-surface.spec.md「viewport-aware scroll chain invariant」段\n    // K11 v2 fix(2026-05-04):flex item 預設 min-h:auto 讓 content 撐 height,h-full 失效。\n    // 必加 `min-h-0` 才能讓 panel 在 PopoverContent max-h cap 下正確 shrink + body scroll。\n    <div\n      ref={ref}\n      className={cn(\n        'flex flex-col h-full min-h-0',\n        value.mode === 'nested'\n          ? 'w-[min(760px,calc(100vw-2rem))]'\n          : 'w-[min(640px,calc(100vw-2rem))]',\n        className,\n      )}\n      {...props}\n    >\n      {/* Popover 派輕量 chrome — slot 走 COMPACT_HEADER_SLOT(=21,衍生自 PopoverTitle text-body line-box),header 自然 ~45px */}\n      <SurfaceHeader className={COMPACT_HEADER_SLOT}>\n        <PopoverTitle className=\"flex-1\">{labels.title}</PopoverTitle>\n        {/* Refresh icon — 只在 value ≠ defaultValue 時顯示(對齊 sort modified-from-default UX)\n            含 ButtonDivider 對齊「欄位顯示」+「排序」chrome corner action canonical(2026-05-04) */}\n        {defaultValue && !isFilterTreeEqual(value, defaultValue) && (\n          <>\n            <Button\n              variant=\"text\" size=\"sm\" iconOnly startIcon={RotateCcw}\n              aria-label={labels.resetToDefault}\n              onClick={() => onChange(defaultValue)}\n            />\n            {onClose && <ButtonDivider />}\n          </>\n        )}\n        {onClose && (\n          <PopoverClose asChild>\n            <Button data-dismiss iconOnly dismiss size=\"sm\" startIcon={XIcon} aria-label={labels.close} onClick={onClose} />\n          </PopoverClose>\n        )}\n      </SurfaceHeader>\n\n      {/* Body — flat / nested 條件;空條件 → 直接顯 + 加篩選 CTA(對齊 Notion / Airtable / Linear inline 派,\n          無條件時不需要 Empty 元件大區塊,單顆 CTA 引導即可。SurfaceFooter 整層拔除,\n          + Add filter / + 加篩選器 inline 緊貼最後一條 row,讓 user 感受到「條件」與「加入」屬同一語境)*/}\n      <SurfaceBody className=\"flex flex-col gap-[var(--layout-space-tight)]\">\n        {flatTree && flatTree.children.map((cond, idx) => (\n          <FilterRow\n            key={cond.id}\n            index={idx}\n            condition={cond}\n            conjunction={flatTree.conjunction}\n            filterableColumns={filterableColumns}\n            fieldOptions={fieldOptions}\n            onChangeConjunction={setFlatConjunction}\n            onChangeField={(v) => {\n              const newCol = filterableColumns.find((c) => c.id === v)\n              updateFlatCondition(cond.id, { field: v, op: getDefaultOperator(newCol?.type), value: '', datePrecision: datePrecisionOf(newCol) })\n            }}\n            onChangeOp={(v) => updateFlatCondition(cond.id, { op: v, value: '' })}\n            onChangeValue={(v) => updateFlatCondition(cond.id, { value: v })}\n            onRemove={() => removeFlatCondition(cond.id)}\n            labels={labels}\n          />\n        ))}\n\n        {nestedTree && nestedTree.children.map((group, gIdx) => (\n          <GroupBlock\n            key={group.id}\n            index={gIdx}\n            group={group}\n            rootConjunction={nestedTree.conjunction}\n            filterableColumns={filterableColumns}\n            fieldOptions={fieldOptions}\n            onChangeRootConjunction={setRootConjunction}\n            onChangeGroupConjunction={(c) => updateGroup(group.id, { conjunction: c })}\n            onChangeCondition={(condId, patch) => updateGroupCondition(group.id, condId, patch)}\n            onRemoveCondition={(condId) => removeGroupCondition(group.id, condId)}\n            onAddCondition={() => addConditionToGroup(group.id)}\n            onRemoveGroup={() => removeGroup(group.id)}\n            canAddCondition={canAddCondition}\n            labels={labels}\n          />\n        ))}\n\n        {/* Inline CTA(2026-05-04 A1)— root-level「加篩選」用 tertiary(視覺輕量但有邊界,\n            符合 root-CTA 視覺重量);nested 內「加入巢狀篩選」走 text variant(更輕,在 group 內 inline)\n            不放 SurfaceFooter:條件與「加入」屬同一語義群,中間插 footer 切斷敘事 */}\n        <div>\n          <Button\n            variant=\"tertiary\" size=\"sm\" startIcon={Plus}\n            onClick={value.mode === 'flat' ? addFlatCondition : addGroup}\n            disabled={!canAddCondition}\n          >\n            {value.mode === 'nested' ? labels.addGroup : labels.addFilter}\n          </Button>\n        </div>\n      </SurfaceBody>\n    </div>\n  )\n}\n\n// Generic + ref forward 套 cast 的 idiom — 對齊 DataTable(同檔家)。\n// React.forwardRef 對 generic component 會丟掉 type param,改 cast 成 generic-preserving signature。\nexport const DataTableFilterPanel = React.forwardRef(DataTableFilterPanelInner) as <TData>(\n  props: DataTableFilterPanelProps<TData> & { ref?: React.ForwardedRef<HTMLDivElement> }\n) => React.ReactElement\n;(DataTableFilterPanel as { displayName?: string }).displayName = 'DataTableFilterPanel'\n"],"names":["XIcon"],"mappings":"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"}

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

@@ -0,0 +1,32 @@
+import { type ValueShape } from './filter-operators';
+import type { DataTableFilterPanelLabels } from './data-table-filter-labels';
+export interface FilterValuePickerColInfo {
+    id: string;
+    label: string;
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+    /** Person pool — person/multiPerson filter picker 用(2026-05-07 升級,SSOT 對齊 cell-registry) */
+    people?: Array<{
+        name: string;
+        avatarUrl?: string;
+        description?: string;
+    }>;
+}
+export interface FilterValuePickerProps {
+    shape: ValueShape | null;
+    value: unknown;
+    onChange: (v: unknown) => void;
+    colInfo?: FilterValuePickerColInfo;
+    disabled?: boolean;
+    /** 用 column.label 組「{label} 篩選值」(panel 每 row 不顯式 label,a11y 必填) */
+    ariaLabel?: string;
+    /** Resolved panel labels; placeholders and relative-date labels share one SSOT. */
+    labels: DataTableFilterPanelLabels;
+    /** Forward 給內部 Field control 的 className(2026-05-04 #2 fix)
+     *  避免外層包 wrapper div 破壞 FieldControlGroup CSS variants(rounded radii / margin overlap) */
+    className?: string;
+}
+export declare function FilterValuePicker({ shape, value, onChange, colInfo, disabled, ariaLabel, labels, className, }: FilterValuePickerProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=data-table-filter-value-picker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-filter-value-picker.d.ts","sourceRoot":"","sources":["../../../src/components/DataTable/data-table-filter-value-picker.tsx"],"names":[],"mappings":"AAoBA,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAA;AAS5E,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACjD,4FAA4F;IAC5F,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;CAC3E;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACxB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9B,OAAO,CAAC,EAAE,wBAAwB,CAAA;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mFAAmF;IACnF,MAAM,EAAE,0BAA0B,CAAA;IAClC;8FAC0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,GACV,EAAE,sBAAsB,kDA2LxB"}