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

package/dist/patterns/element-anatomy/item-anatomy.js

@@ -1,7 +1,7 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
 import { cva } from "class-variance-authority";
-import { lineClampClass, cn } from "../../lib/utils.js";
+import { cn, lineClampClass } from "../../lib/utils.js";
 import { Avatar } from "../../components/Avatar/avatar.js";
 import { Tooltip, TooltipTrigger, TooltipContent } from "../../components/Tooltip/tooltip.js";
 const ICON_SIZE = {

package/ds-canonical/hooks/check_overlay_open_focus_escape_probe.sh

@@ -49,14 +49,22 @@ if [ -z "$USED" ]; then exit 0; fi
 # 2026-07-16 dim 74 regex 加廣:原只認 open={true|isOpen|isVisible} 3 個字面名 —
 # 漏 controlled `open={<任意變數/expression>}`(如 open={open} / open={!collapsed})與
 # bare `open` boolean attr(JSX `<Popover open>` = true)→ 合法 controlled story 被誤殺。
-#   - `open=\{[!a-zA-Z_]` 涵蓋任意 identifier / negation expression(含 true/isOpen/isVisible)
 #   - bare attr 兩形態:tag 內 `<Sheet open>` / `<Popover open onX>`(`<Tag[^<>]* open` 限同 tag,
 #     `[^<>]*` 不可跨 `>` → JSX 內文 / 註解 prose 的「open / close」不誤中)+ 多行 prop 排版
 #     「整行只有 open」(`^\s*open\s*$`)。存量驗證:Coachmark principles(行只有 open)pass、
 #     dropdown-menu.anatomy prose「浮層 open / close」不誤 pass。
 #   - defaultOpen 原本就有,保留
+# 2026-07-18 修 bde8973c 過廣 bug:原 `open=\{[!a-zA-Z_]` 把 false/null/undefined 的首字 f/n/u
+#   誤中 → `open={false}`(假 open,控制成關閉)被當成「有 open 機制」→ 漏擋 trigger-only story
+#   (test P3 失敗 → ci.yml Hook test suite 紅 → 下游 gate 全跳過)。修:controlled open={<expr>}
+#   單獨抽出偵測,排除三個「關閉字面值」open={false|null|undefined}(空白容忍);identifier/negation
+#   /true 仍認(如 open={showMenu} / open={!collapsed} / open={true})。
 HAS_OPEN=""
-if echo "$CONTENT" | grep -qE 'defaultOpen|open=\{[!a-zA-Z_]|<[A-Za-z][^<>]*[[:space:]]open([[:space:]>]|$)|^[[:space:]]*open[[:space:]]*$|play:\s*async|play\(.*click'; then
+if echo "$CONTENT" | grep -qE 'defaultOpen|<[A-Za-z][^<>]*[[:space:]]open([[:space:]>]|$)|^[[:space:]]*open[[:space:]]*$|play:\s*async|play\(.*click'; then
+  HAS_OPEN="found"
+fi
+# controlled open={<expr>}:認任意 identifier / negation / true,但排除關閉字面值 false|null|undefined
+if [ -z "$HAS_OPEN" ] && echo "$CONTENT" | grep -oE 'open=\{[^}]*\}' | grep -qvE '^open=\{[[:space:]]*(false|null|undefined)[[:space:]]*\}$'; then
   HAS_OPEN="found"
 fi
 

package/llms-full.txt

@@ -1,6 +1,6 @@
 # @qijenchen/design-system — 完整設計參考(llms-full)
 
-> 全 component / pattern 的 variants / sizes / 禁止事項。build-time 從 spec.md frontmatter 生成,禁手改。v0.1.0-beta.86。
+> 全 component / pattern 的 variants / sizes / 禁止事項。build-time 從 spec.md frontmatter 生成,禁手改。v0.1.0-beta.87。
 
 # Components
 

package/llms.txt

@@ -1,7 +1,7 @@
 # @qijenchen/design-system
 
 > World-class React design system(Radix/shadcn + Tailwind v4 + 自訂 design token)。
-> 57 components + 4 public patterns + design tokens。v0.1.0-beta.86。
+> 57 components + 4 public patterns + design tokens。v0.1.0-beta.87。
 
 本檔由 source(spec.md frontmatter + Storybook index)build-time 自動生成,**禁手改**(CI --check drift gate 守)。
 每元件 / pattern 的完整 variants / sizes / 禁止事項 全文見 [llms-full.txt](./llms-full.txt)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qijenchen/design-system",
-  "version": "0.1.0-beta.86",
+  "version": "0.1.0-beta.87",
   "private": false,
   "description": "World-class design system — components, patterns, tokens, hooks (single source of truth for team distribution).",
   "type": "module",

package/src/components/DataTable/data-table.spec.md

@@ -511,6 +511,7 @@ DataTable 是 composite multi-section 元件,**不套 SizeMatrix / StateBehavior
 - `carousel.spec.md`
 - `circular-progress.spec.md`
 - `description-list.spec.md`
+- `filter-operators.spec.md`
 - `opacity.spec.md`
 - `pagination.spec.md`
 - `scroll-area.spec.md`

package/src/components/DatePicker/date-picker.spec.md

@@ -333,6 +333,7 @@ DatePicker 套 `React.forwardRef` + `displayName`;`DatePickerProps` extends `Omi
 
 - `calendar.spec.md`
 - `date-grid.spec.md`
+- `header-canonical.spec.md`
 - `input.spec.md`
 - `number-input.spec.md`
 - `time-picker.spec.md`

package/src/components/Empty/empty.spec.md

@@ -206,7 +206,6 @@ Empty 是 **pure layout primitive**(排列 icon / title / description / action
 
 - `carousel.spec.md`
 - `circular-progress.spec.md`
-- `combobox.spec.md`
 - `command.spec.md`
 - `file-upload.spec.md`
 - `file-viewer.spec.md`

package/src/components/Field/field-controls.spec.md

@@ -424,11 +424,13 @@ col.accessor('status', {
 - `checkbox.spec.md`
 - `circular-progress.spec.md`
 - `combobox.spec.md`
+- `data-table.spec.md`
 - `date-picker.spec.md`
 - `element-anatomy.spec.md`
 - `field-control-group.spec.md`
 - `field.spec.md`
 - `form-validation.spec.md`
+- `inline-edit.spec.md`
 - `input.spec.md`
 - `item-anatomy.spec.md`
 - `link-input.spec.md`

package/src/components/Field/field.spec.md

@@ -452,6 +452,7 @@ Field 內的資料輸入控件（Input / NumberInput / DatePicker / Select / Com
 
 > 本節由 `scripts/add-reciprocal-pointers.mjs` 自動維護,列出在 SSOT 語境下指向本 spec 的其他 spec。若要手動補充,寫在本節之前。
 
+- `data-table.spec.md`
 - `description-list.spec.md`
 - `element-anatomy.spec.md`
 - `field-control-group.spec.md`

package/src/components/Field/form-validation.spec.md

@@ -168,10 +168,12 @@ Form validation 的 ARIA / 鍵盤行為(對齊 WCAG 3.3.1 Error Identification +
 
 > 本節由 `scripts/add-reciprocal-pointers.mjs` 自動維護,列出在 SSOT 語境下指向本 spec 的其他 spec。若要手動補充,寫在本節之前。
 
+- `checkbox.spec.md`
 - `combobox.spec.md`
 - `date-picker.spec.md`
 - `field-controls.spec.md`
 - `field.spec.md`
 - `link-input.spec.md`
+- `select.spec.md`
 - `textarea.spec.md`
 - `time-picker.spec.md`

package/src/components/Select/select.spec.md

@@ -353,6 +353,7 @@ Select 是 **Field Controls family 成員**——互動狀態(focus / invalid /
 
 - `checkbox.spec.md`
 - `combobox.spec.md`
+- `command.spec.md`
 - `people-picker.spec.md`
 - `radio-group.spec.md`
 - `select-menu.spec.md`

package/src/components/Tag/tag.spec.md

@@ -291,4 +291,5 @@ Tag 是**純視覺 indicator**(非互動 control,互動版本是 Chip),預設 AR
 
 - `avatar.spec.md`
 - `badge.spec.md`
+- `inline-action.spec.md`
 - `overflow-indicator.spec.md`

package/src/patterns/action-bar/action-bar.spec.md

@@ -472,3 +472,4 @@ Icon 的目的是幫助辨識，不是視覺對稱。
 - `data-table.spec.md`
 - `file-viewer.spec.md`
 - `popover.spec.md`
+- `separator.spec.md`

package/src/patterns/element-anatomy/item-anatomy.spec.md

@@ -1028,15 +1028,18 @@ Selection control(Dropdown / Menu / List / SegmentedControl / Chip)的 item 視
 > 本節由 `scripts/add-reciprocal-pointers.mjs` 自動維護,列出在 SSOT 語境下指向本 spec 的其他 spec。若要手動補充,寫在本節之前。
 
 - `alert.spec.md`
+- `checkbox.spec.md`
 - `color.spec.md`
 - `command.spec.md`
 - `dropdown-menu.spec.md`
 - `element-anatomy.spec.md`
 - `empty.spec.md`
+- `field-controls.spec.md`
 - `field.spec.md`
 - `file-item.spec.md`
 - `header-canonical.spec.md`
 - `inline-action.spec.md`
+- `layoutSpace.spec.md`
 - `menu-item.spec.md`
 - `notice.spec.md`
 - `select-menu.spec.md`
@@ -1047,5 +1050,6 @@ Selection control(Dropdown / Menu / List / SegmentedControl / Chip)的 item 視
 - `tabs.spec.md`
 - `time-picker.spec.md`
 - `toast.spec.md`
+- `token-system.spec.md`
 - `tree-view.spec.md`
 - `typography.spec.md`

package/src/tokens/motion/motion.spec.md

@@ -97,13 +97,6 @@ Hover delay token 是「hover 觸發 → 延遲 N ms → overlay 顯示」的延
 - `../../components/Tooltip/tooltip.spec.md`(consumer)
 - `../../components/HoverCard/hover-card.spec.md`(consumer)
 - `../../components/Avatar/avatar.spec.md`(consumer)
-
-## 被引用(auto-maintained,Dim 3 reciprocal audit)
-
-> 本節由 `scripts/add-reciprocal-pointers.mjs` 自動維護,列出在 SSOT 語境下指向本 spec 的其他 spec。若要手動補充,寫在本節之前。
-
-- `hover-card.spec.md`
-
 ## 進出場動畫 token(2026-07-11 加,user 拍板)
 
 Overlay(Tooltip/Popover/HoverCard/DropdownMenu/Dialog/Sheet/FileViewer)的 fade/zoom/slide 進出場動畫,值統一 token 化(原各元件硬寫 zoom-95/slide-2/duration-300 = M17 假 SSOT)。由 tw-animate-css(Tailwind v4,= shadcn 官方機制)的 `--tw-duration`/`--tw-ease` 變數綁定;共用 SSOT = `overlay-motion.ts`(overlayMotion/surfaceMotion)。
@@ -120,3 +113,9 @@ Overlay(Tooltip/Popover/HoverCard/DropdownMenu/Dialog/Sheet/FileViewer)的 fade/
 **幾何原型分層(正當差異,不強行抹平)**:輕量 popup = fade+zoom+slide-side(8px);模態置中 = fade+zoom+slide-center(Dialog/FileViewer);邊緣抽屜 = slide-edge 100%、正當無 zoom(Sheet)。統一的是**時長/曲線/reduced-motion 守衛**(motion-reduce:animate-none 全 7 浮層),非幾何原型(對齊 Material standard-vs-emphasized / Carbon productive-vs-expressive tier 分層)。
 
 **a11y**:prefers-reduced-motion 下 `motion-reduce:animate-none` 全 7 浮層統一關進出場動畫(overlay-motion SSOT 保證,無漏)。
+
+## 被引用(auto-maintained,Dim 3 reciprocal audit)
+
+> 本節由 `scripts/add-reciprocal-pointers.mjs` 自動維護,列出在 SSOT 語境下指向本 spec 的其他 spec。若要手動補充,寫在本節之前。
+
+- `hover-card.spec.md`