@qijenchen/design-system 0.1.0-beta.80 → 0.1.0-beta.82

package/ds-canonical/hooks/check_story_invariants.sh

@@ -639,9 +639,12 @@ rule_story_archetype_registry() {
       continue
     fi
 
-    # Read antiPatterns regex list(P0 block only — warn ship later)
+    # Read antiPatterns(block + warn 皆載;2026-07-04 dim 54 修:原只載 block → warn 條目=從未執行的紙防線)
+    # 每條三行一組:severity / regex / unlessRegex(jq -r 原始輸出零跳脫;**禁 @tsv/插值** —
+    # @tsv 把 regex 反斜線雙跳脫、插值 nested-quote 踩 jq lexer,2026-07-04 smoke 連抓兩雷)。
+    # unlessRegex 選填 — ERE 不支援 negative lookahead,兩段式替代:match 且 unless 不 match 才 fire。
     local PATTERNS
-    PATTERNS=$(jq -r --arg c "$COMP" '.components[$c].antiPatterns[]? | select(.severity == "block") | .regex' "$REGISTRY" 2>/dev/null)
+    PATTERNS=$(jq -r --arg c "$COMP" '.components[$c].antiPatterns[]? | .severity, .regex, (.unlessRegex // "")' "$REGISTRY" 2>/dev/null)
     [ -z "$PATTERNS" ] && continue
 
     # 2026-06-03 修:CONTENT 換行 → 空格再 grep。真實 JSX 是多行(<ChromeHeader> 與 <span> 分行),
@@ -649,10 +652,18 @@ rule_story_archetype_registry() {
     # 靜默漏 = 假 P0(對抗稽核抓到)。tr 後整段成單行,[[:space:]]* / .* 才能跨原換行匹配。
     local CONTENT_FLAT
     CONTENT_FLAT=$(echo "$CONTENT" | tr '\n' ' ')
-    while IFS= read -r PATTERN; do
+    while read -r SEV && read -r PATTERN && { read -r UNLESS || true; }; do
       [ -z "$PATTERN" ] && continue
+      # regex self-test(2026-07-04 dim 54:PCRE lookahead 混入曾致 grep exit 2 靜默永不 fire;fail-loud)
+      echo x | grep -qE "$PATTERN" 2>/dev/null
+      if [ $? -eq 2 ]; then
+        echo "⚠️  R8 registry regex 不可執行(ERE invalid,此條防線失效,修 registry):$PATTERN" >&2
+        continue
+      fi
       if echo "$CONTENT_FLAT" | grep -qE "$PATTERN"; then
-        echo "⚠️  R8 story_archetype_registry violation:" >&2
+        # unlessRegex 存在且 match → 豁免(兩段式 negative)
+        if [ -n "$UNLESS" ] && echo "$CONTENT_FLAT" | grep -qE "$UNLESS" 2>/dev/null; then continue; fi
+        echo "⚠️  R8 story_archetype_registry violation(severity: $SEV):" >&2
         echo "   $FILE_PATH wrap <$COMP> matches anti-pattern:" >&2
         echo "   regex: $PATTERN" >&2
         echo "   per registry: .claude/references/story-baseline-registry.json#components.$COMP.antiPatterns" >&2
@@ -660,7 +671,8 @@ rule_story_archetype_registry() {
         echo "   修法:Read baseline story + helpers,抄 production archetype。" >&2
         echo "   或加 \`// @story-baseline-allow: <reason>\` 檔頭豁免(audit-logged)。" >&2
         echo "   詳 .claude/rules/meta-patterns.md M35 + memory/feedback_nearest_same_purpose_canonical.md" >&2
-        record_worst 2  # 2026-06-02 升 P0 BLOCKER:DS + consumer(ds-product-template)全掃確認零現有違規後升級(原 2026-05-20 ship-as-warn 的 TODO 條件達成);只 block-severity antiPattern(warn-severity 仍 stderr-only)
+        # 2026-06-02 升 P0 BLOCKER(block-severity record_worst);warn-severity stderr-only(2026-07-04 補實作)
+        [ "$SEV" = "block" ] && record_worst 2
       fi
     done <<< "$PATTERNS"
   done

package/ds-canonical/hooks/check_substantive_edit_approval_preflight.sh

@@ -43,8 +43,9 @@ case "$FILE_PATH" in
 esac
 
 # Allowlist:storybook config / scripts / tests 等非 production code
+# (dim 59 2026-07-04:*.test.ts → *.test.* 補 .test.tsx;第一道 case 已限 tsx/ts/css,不會誤放 .md)
 case "$FILE_PATH" in
-  *.stories.tsx|*.test.ts|*.spec.ts|*/scripts/*) exit 0 ;;
+  *.stories.tsx|*.test.*|*.spec.ts|*/scripts/*) exit 0 ;;
 esac
 
 [ -z "$TRANSCRIPT_PATH" ] || [ ! -f "$TRANSCRIPT_PATH" ] && exit 0
@@ -63,7 +64,9 @@ RECENT_USER_MSGS=$(tail -200 "$TRANSCRIPT_PATH" 2>/dev/null | \
 #   (a) 加「妳」變體(`照妳`= `照你` 文書通用 variant)
 #   (b) 加「決策[一二三四五六七八九十1-9]」numbered directive(eg.「決策一改…」「決策3做」)
 #   (c) 加「做到好」/「都做」/「全做」auto-approve 變體
-APPROVAL_RE='(同意|採用|採納|拍板|拍\s*[A-Z0-9]|可以|改成|改為|執行|上吧|push|implement|go ahead|approved|OK|好|沒問題|做一做|就做|做吧|做完|全部做完|做到完|做到好|都做|全做|馬不停蹄|建議做|ship|合 main|^#[0-9]+|照你|照妳|照建議|照共識|照我的|按照|決策[一二三四五六七八九十1-9]|[A-Z][0-9]+\s*(做|改|修)|先\s*[A-Z][0-9]+)'
+# 2026-07-04 M7 detection-breadth fix(user verbatim「同意補詞」拍板):「核可修 production 佇列」曾被判
+# 0 approval — 20+ 口語變體卻漏最標準的「核可 / 批准」,補上。
+APPROVAL_RE='(同意|採用|採納|拍板|拍\s*[A-Z0-9]|核可|批准|可以|改成|改為|執行|上吧|push|implement|go ahead|approved|OK|好|沒問題|做一做|就做|做吧|做完|全部做完|做到完|做到好|都做|全做|馬不停蹄|建議做|ship|合 main|^#[0-9]+|照你|照妳|照建議|照共識|照我的|按照|決策[一二三四五六七八九十1-9]|[A-Z][0-9]+\s*(做|改|修)|先\s*[A-Z][0-9]+)'
 HAS_APPROVAL=$(echo "$RECENT_USER_MSGS" | grep -cE "$APPROVAL_RE" 2>/dev/null)
 HAS_APPROVAL=${HAS_APPROVAL:-0}
 

package/ds-canonical/references/principle-dim-map.json

@@ -436,6 +436,106 @@
     "propose_pre_grep_verify": {
       "dims": [],
       "note": "2026-05-18 ship(M18 Q0 Pre-ASK self-verify governance infra):PreToolUse Edit/Write planning/reports/handoff *.md 偵測 propose keyword(請拍板 / 等你拍板 / 決策 N / 我推 A/B/C / 選項)但 content 無 file:line cite 證據 → P1 stderr warn。Escape:檔頭 <!-- @propose-pre-verified --> 含 rationale。起因 2026-05-18 Sheet/inline-action/SurfaceBody 三題 propose 給 user 拍板,grep 後 0 個真 gap;user verbatim「不是老早就跟你說過要我決策前請先基於我們所有的檔案包括設計原則包括 ssot 包括所有實作代碼,自主自動驗證這些問題是否真的是問題」"
+    },
+    "tabs_content_chrome_body_double_gap": {
+      "dims": [
+        89,
+        90
+      ],
+      "note": "2026-07-03 entry add per audit-preflight gap:write-time P0(Check1 tabs double-gap + Check2 overlay-body fixed macro gap);audit-time dim 89 sweep + dim 90 judgment"
+    },
+    "storybook_addon_packaging": {
+      "dims": [
+        87
+      ],
+      "note": "2026-07-03 entry add:packaging 事故家族(beta.27-31)write-time P0;audit-time 由 dim 87 dogfood prepublish(npm install + build-storybook consumer view)deterministic cover"
+    },
+    "tailwind_wildcard_in_docs": {
+      "dims": [],
+      "note": "2026-07-03 entry add:beta.27 release-fail anchor write-time P0;audit-time 由 release preflight build gate(build:lib + build-storybook)deterministic cover,無獨立 dim"
+    },
+    "chrome_header_avatar_canonical": {
+      "dims": [],
+      "note": "2026-07-03 entry add per audit-preflight gap:write-time P0 攔 chrome header 內 ItemAvatar 誤用(header-canonical 消費紀律);audit-time 由 dim 1 design-language + A.1b per-component cover,無獨立 dim"
+    },
+    "codex_brief_invariants": {
+      "dims": [],
+      "note": "2026-07-03 entry add per audit-preflight gap:codex-collab runtime 紀律(brief 三 invariant);governance-only,solo mode 不涉"
+    },
+    "consumer_app_invariants": {
+      "dims": [
+        69,
+        70,
+        71,
+        82
+      ],
+      "note": "2026-07-03 entry add per audit-preflight gap:consumer app DS 使用紀律 write-time ×4;audit-time dim 69-71(no-catalog/@story-baseline/primitive misuse)+ 82(app story title)"
+    },
+    "ds_anchor_preflight": {
+      "dims": [
+        57
+      ],
+      "note": "2026-07-03 entry add per audit-preflight gap:M29 anchor preflight;dim 57 直接對應(enforcement coverage)"
+    },
+    "escape_marker_abuse": {
+      "dims": [
+        76
+      ],
+      "note": "2026-07-03 entry add per audit-preflight gap:dim 76 escape marker abuse 直接對應"
+    },
+    "full_story_visual_interaction_sweep": {
+      "dims": [
+        73
+      ],
+      "note": "2026-07-03 entry add per audit-preflight gap:dim 73 full-story sweep 直接對應"
+    },
+    "item_list_gap": {
+      "dims": [
+        21
+      ],
+      "note": "2026-07-03 entry add per audit-preflight gap:M16 standalone gap;dim 21 直接對應"
+    },
+    "layout_space_magic_numbers": {
+      "dims": [
+        90
+      ],
+      "note": "2026-07-03 entry add per audit-preflight gap:app-code write-time P0(skip DS-src by design);DS-src 由 dim 90 judgment sweep cover"
+    },
+    "orphan_ds_css": {
+      "dims": [],
+      "note": "2026-07-03 entry add per audit-preflight gap:write-time P0(css 不在 aggregator 也沒被 import = orphan;失敗記憶索引條目);audit-time 由 build + visual 間接,無獨立 dim"
+    },
+    "overlay_open_focus_escape_probe": {
+      "dims": [
+        74
+      ],
+      "note": "2026-07-03 entry add per audit-preflight gap:dim 74 overlay probe 直接對應"
+    },
+    "plugin_fork_health": {
+      "dims": [
+        58
+      ],
+      "note": "2026-07-03 entry add per audit-preflight gap:dim 58 plugin install enforcement 直接對應"
+    },
+    "post_main_ssot_propagate": {
+      "dims": [
+        64
+      ],
+      "note": "2026-07-03 entry add per audit-preflight gap:dim 64 post-main-push SSOT propagation 直接對應"
+    },
+    "propose_discipline": {
+      "dims": [],
+      "note": "2026-07-03 entry add per audit-preflight gap:Stop hook runtime 紀律(中文人話 + cite);governance-only"
+    },
+    "propose_without_benchmark": {
+      "dims": [],
+      "note": "2026-07-03 entry add per audit-preflight gap:M26 runtime 紀律(propose 前 WebFetch);governance-only"
+    },
+    "sidebar_menu_button_implicit_wrap": {
+      "dims": [
+        71
+      ],
+      "note": "2026-07-03 entry add per audit-preflight gap:write-time 攔隱式 wrap;audit-time dim 71 primitive misuse + A.1b composition cover"
     }
   },
   "newDims_2026_05_17": {

package/ds-canonical/references/story-baseline-registry.json

@@ -79,9 +79,10 @@
         },
         {
           "id": "datatable-toolbar-no-popover-wrap",
-          "regex": "startIcon=\\{(Filter|ArrowUpDown)\\}(?![\\s\\S]*?(DataTableFilterPanel|DataTableSortManager))",
+          "regex": "startIcon=\\{(Filter|ArrowUpDown)\\}",
           "severity": "warn",
-          "rationale": "DataTable toolbar filter/sort button 必包在 Popover 內,內含真 DataTableFilterPanel / DataTableSortManager primitive"
+          "rationale": "DataTable toolbar filter/sort button 必包在 Popover 內,內含真 DataTableFilterPanel / DataTableSortManager primitive(2026-07-04 dim 54:原 PCRE lookahead 在 ERE grep exit 2 永不 fire → 改兩段式 regex+unlessRegex)",
+          "unlessRegex": "DataTableFilterPanel|DataTableSortManager"
         }
       ]
     },
@@ -104,4 +105,4 @@
       ]
     }
   }
-}
+}

package/ds-canonical/skills/deep-audit-cross-codex/SKILL.md

@@ -42,7 +42,7 @@ detect_mode() {
 | Mode | A.0 全盤閱讀 scope | A.1 audit dim scope | Phase B codex scope |
 |---|---|---|---|
 | **ds-repo**(DS owner workflow,含 template SSOT 編輯)| full DS canonical + spec + token + pattern + memory + `template/ds-product-template/` scaffold | 全 dim per `/design-system-audit --deep` SSOT(含 dim 83 cross-3-repo runtime audit)**＋ chain `/product-ui-audit` 對 `apps/template`**(DS owner dogfood 自家消費端 surface,用 fork user 同等產品標準把關)| 全 dim parallel verify |
-| **fork-user-repo**(published template repo / fork user product repo)| `node_modules/@qijenchen/design-system/CLAUDE.md` + `ds-canonical/rules/meta-patterns.md` + `apps/**` + 本 repo `CLAUDE.md` | dim 83 fork-side runtime checks(plugin hook fire / **fork-committed bootstrap hooks fire〔check_plugin_bootstrap SessionStart + block_production_edit_without_plugin PreToolUse〕** / cross-load / setup-netlify smoke / **deploy URL hook 每次 push 吐 URL live** / **環境建置斷點清單通暢 + 無法自動的斷點有 plain-中文引導**)+ **完整 consumer/fork enforcement dim 集(2026-05-30 補,原僅 62-67 漏掉 bootstrap 等)**:58(plugin install + bootstrap chicken-egg gate)/ 59(approval-preflight `apps/**`)/ 62(Netlify onboarding + 斷點清單 + ≥6 條中文引導話術)/ 63(deploy URL auto-reply 每次必吐)/ 64(post-main-push SSOT propagation)/ 69-71(consumer no-catalog / @story-baseline / DS primitive misuse)/ 73-74(full-story sweep / overlay probe)/ 75(plugin freshness)/ 76(escape marker abuse)/ 82(consumer app story title)| 同 dim,fork-side verify;**禁** propose DS source change |
+| **fork-user-repo**(published template repo / fork user product repo)| `node_modules/@qijenchen/design-system/CLAUDE.md` + `ds-canonical/rules/meta-patterns.md` + `apps/**` + 本 repo `CLAUDE.md` | dim 83 fork-side runtime checks(**C-prime committed 治理鏈 fire〔fork-governance-dispatcher.sh Pre/Post/UserPromptSubmit 讀 ds-canonical/fork/manifest.json + inject_fork_governance_preamble.sh SessionStart;免 plugin,2026-06-17 改版〕** / cross-load / setup-netlify smoke / **deploy URL hook 每次 push 吐 URL live** / **環境建置斷點清單通暢 + 無法自動的斷點有 plain-中文引導**)+ **完整 consumer/fork enforcement dim 集(2026-05-30 補,原僅 62-67 漏掉 bootstrap 等)**:58(plugin install + bootstrap chicken-egg gate)/ 59(approval-preflight `apps/**`)/ 62(Netlify onboarding + 斷點清單 + ≥6 條中文引導話術)/ 63(deploy URL auto-reply 每次必吐)/ 64(post-main-push SSOT propagation)/ 69-71(consumer no-catalog / @story-baseline / DS primitive misuse)/ 73-74(full-story sweep / overlay probe)/ 75(plugin freshness)/ 76(escape marker abuse)/ 82(consumer app story title)| 同 dim,fork-side verify;**禁** propose DS source change |
 
 ### Fork-mode safety invariants(2026-05-29 加)
 

package/ds-canonical/skills/design-system-audit/SKILL.md

@@ -175,7 +175,7 @@ User 2026-05-15 verbatim 抓「DS 深度稽核漏 storybook content quality」+
 | 55 | **Token cross-namespace mapping integrity**(2026-05-20 codify per user 抓 red→deep-orange bug 100+ audit 沒發現)| `tokens/color/semantic.css` 每 hue interaction token(`--blue-hover` / `--red-hover` / ...)必指向**同名**primitive(`--red-hover: var(--color-red-N)`),**禁**跨 hue 混(`--red-hover: var(--color-deep-orange-N)` 違反)。Primitive 12 hue 全該有對應 interaction(blue/red/deep-orange/orange/amber/yellow/lime/green/turquoise/indigo/purple/magenta)。Status semantic(`--error-hover` 等)直指 primitive,**不**透過 hue layer。錨例:2026-05-20 semantic.css:246 `--red-hover: var(--color-deep-orange-5)` cross-namespace bug,100+ audit 沒發現 = audit 沒檢 token mapping integrity |
 | 56 | **AppShell primary-header consistency**(2026-05-21 codify;2026-06-18 beta.74 擴 V3 + responsive 豁免)| 對每 consumer `.tsx`(stories / app code)grep `layout="primary-header"`(三種 JSX 引號形式 `layout="x"` / `{"x"}` / `{'x'}` 皆偵測,grep -E 字面引號),verify 3 條:(V1) 同 file 含 `globalHeader=` prop(否則邏輯矛盾)/(V2) 不含裸 `<SidebarHeader>`(WorkspaceBrand 該在 globalHeader,不重複;**例外**:同 file 用 `useSidebar`/`isMobile` = mobile-only Sheet 補品牌的 responsive fork → 豁免)/(V3) 不含 `<SidebarFooter>`(帳號入口家在 globalHeader 右、收成 Sheet 鏡像到 Sheet header 右,**不該**用 sidebar footer〔那是 primary-sidebar 慣例〕;**無** isMobile 豁免)。trigger 用 tag-boundary `([^A-Za-z]|$)` 避 prefix-extended 名誤觸。World-class cite:GitHub repo sidebar 無 header + Gmail / Figma brand 在 global top bar + Material modal nav drawer「account switcher 放 drawer header」。Hook `check_app_shell_primary_header_consistency.sh`(V1-V3)write-time exit 2 BLOCKER(via chrome_header_dispatcher,可 escape `// @app-shell-primary-header-allow:`)。對應 `app-shell.spec.md`「WorkspaceBrand 放置 SSOT」+「帳號入口(Account entry)放置 SSOT」段(均含 Responsive 精修子句)|
 | 57 | **M29 DS Anchor Preflight enforcement coverage**(2026-05-26 codify per user verbatim「該程式化的都沒程式化」)| 對每 `*.tsx`(production code,非 stories / test)grep wrap DS primitive(`<Sidebar>` / `<AppShell>` / `<DataTable>` 等)→ verify 過去 30 turns transcript 含 `Grep`/`Read` tool call hit `packages/design-system/src/**/*.spec.md` 或 `*.stories.tsx`,OR 檔頭含 `@story-baseline:` marker 或 inline 3-column owner table。Hook `check_ds_anchor_preflight.sh` write-time soft BLOCKER。對應 meta-patterns.md M29 + self-verify.md Pre-edit phase。錨例:2026-05-26 App.tsx 漏 SidebarTrigger / collapsible / startIcon mock-drift = M29 hook 不存在使 infra 沒攔 |
-| 58 | **Fork-user plugin install enforcement**(2026-05-26 codify per user「我們做那麼多 plugin 不就是要避免這件事?」)| SessionStart hook `check_plugin_fork_health.sh(r1,2026-06-11 merge)` 偵測:(a) cwd 不是 DS repo(無 `packages/design-system/src`)/(b) `package.json` 含 `@qijenchen/design-system` dep /(c) `~/.claude/plugins/design-system/` OR `.claude/plugins/design-system/` 不存在 → 三題 YES 印強制提示。互補 product-workspace `scripts/check-plugin-installed.mjs` npm postinstall layer。**+ 2026-05-30 fork-committed bootstrap 層(補 chicken-egg:plugin 硬 hook 隨 plugin 才裝,沒裝前無 mechanical 防線)**:fork 自帶 `template/ds-product-template/.claude/hooks/check_plugin_bootstrap.sh`(SessionStart 每 session 提醒,fail-open)+ `block_production_edit_without_plugin.sh`(PreToolUse 硬攔 `apps/**` production .tsx/.ts/.css edit,沒裝 plugin → exit 2 BLOCK,escape `CLAUDE_BYPASS_PLUGIN_BOOTSTRAP=1`)+ `.claude/settings.json` hooks 註冊;**不依賴 plugin**(committed in fork),mirror allowlist `.claude` ship 給 published fork。對應 product-workspace/CLAUDE.md「第 −1 步」段 |
+| 58 | **Fork-user 治理鏈 enforcement**(2026-05-26 codify per user「我們做那麼多 plugin 不就是要避免這件事?」;**2026-06-17 C-prime 改版:主路徑 = committed-config + npm,免 plugin**〔beta.70 真機蓋章;plugin 路線不可靠 per memory `reference_cloud_governance_loading`〕)| SessionStart hook `check_plugin_fork_health.sh` 偵測 fork repo(cwd 非 DS repo + `package.json` 含 `@qijenchen/design-system` dep)治理鏈缺失 → 印 npm 修法提示(r1)+ local vs published 版本 stale 比對提示 `npm run sync-all`(r2)。**Chicken-egg 層(C-prime,取代 2026-05-30 bootstrap hooks — `check_plugin_bootstrap.sh` / `block_production_edit_without_plugin.sh` 已 retired,`refresh-fork-launchers.mjs` OBSOLETE_HOOKS 主動移除避免 brick)**:fork 自帶 committed 啟動器 `fork-governance-dispatcher.sh`(Pre/Post/UserPromptSubmit 讀 `node_modules/@qijenchen/design-system/ds-canonical/fork/manifest.json` 跑官方 fork hooks;任一 exit 2 轉發 BLOCK;manifest 缺 → exit 0 永不 brick)+ `inject_fork_governance_preamble.sh`(SessionStart install-if-missing + 設計紀律 preamble)+ `.claude/settings.json` 註冊;**治理本體在 node_modules = npm install 覆蓋官方控管**,`build-fork-governance.mjs` 從 DS repo hooks 生 manifest,`test-fork-governance.mjs` 回歸鎖。Audit verify:dispatcher 轉發 exit 2 / manifest event 覆蓋 / obsolete hook 移除。對應 template CLAUDE.md「🚀 Onboarding(C-prime)」段 |
 | 59 | **Approval preflight scope coverage**(2026-05-26 extend per user「未來其他人 fork 用其他元件也偏移」)| `check_substantive_edit_approval_preflight.sh` scope 從 `packages/design-system/src/**` 擴大到 `apps/**.{tsx,ts,css}` + `node_modules/@qijenchen/design-system/**`。Audit verify hook regex 涵蓋三 scope + allowlist `*.stories.tsx`/`*.test.*`/`scripts/*`。對應 memory/feedback_ship_then_revert_anti_pattern.md SSOT |
 | 60 | **M26 propose-without-benchmark enforcement**(2026-05-26 backfill)| UserPromptSubmit hook `check_propose_without_benchmark.sh` 偵測 user prompt 含 propose / 建議 / 方案 / 看法 / visual / behavior keyword + 過去 20 turns transcript 中 `WebFetch`/`WebSearch` tool_use count < 2 → soft inject 提醒「propose 前必跑 ≥3 source benchmark」。對應 meta-patterns.md M26 + propose-options/SKILL.md。錨例:2026-05-05 user 反覆糾「為什麼每次都沒 webfetch 只憑印象」 |
 | 61 | **M16 item-list gap + M23(c) DataTable framework prop conflict enforcement**(2026-05-26 backfill)| PreToolUse hooks 兩 invariant:(a) `check_item_list_gap.sh` — 2+ `<FileItem>` / `<MenuItem variant="rich">` 在同 NEW content 且無 `gap-N` / `space-y-N` parent → warn(M16);(b) `check_datatable_invariants.sh(r2 folded,2026-06-11)` — `ColumnDef` 上下文出現 `size: <number>` 但無 `meta: { width: ... }` → warn TanStack `size:px` vs DS `size:density` 框架 prop 衝突(M23(c))。對應 meta-patterns.md M16 + M23(c) + item-anatomy.spec.md + data-table.spec.md |
@@ -190,7 +190,7 @@ User 2026-05-15 verbatim 抓「DS 深度稽核漏 storybook content quality」+
 | 70 | **Consumer @story-baseline enforcement**(2026-05-27 M31 codex synthesis)| 對 consumer `apps/**/*.stories.tsx` grep:用高風險 DS primitive(DataTable / Dialog / Sheet / Popover / DropdownMenu / Tooltip / HoverCard / LinkInput / RadioGroup / CircularProgress / AppShell / Sidebar)但無 `// @story-baseline: <DS-story-path>#<exportName>` marker → 違反(consumer 必 reference DS canonical story 才 enable visual diff CI)。Hook `check_consumer_app_invariants.sh(r2,2026-06-11 merge)` PostToolUse BLOCKER,escape `// @story-baseline-allow:`。SSOT mapping → `ds-story-manifest.json`(DS package ship)|
 | 71 | **Consumer DS primitive misuse anti-pattern**(2026-05-27 per user「做產品真的要能使用跟 ds repo 一模一樣的元件」)| 對 consumer `apps/**/*.{tsx,ts}` production + stories grep:`<CircularProgress size={N}>` literal number 覆蓋 default 24 / `<RadioGroupItem>` 無 `<SelectionItem control={...}>` wrap / `<DataTable columns={[single-col]}>` minimal / `<LinkInput placeholder=...>` 無 `value` prop / `<Empty title=...>` 無 icon AND 無 description / Overlay story 無 `defaultOpen` 視覺 snapshot 看不到 content / **硬寫色值-字級-shadow 繞 token(`bg-[#hex]` / `text-[14px]` / `shadow-md`,2026-06-02 Pattern 8,CF conformance-model 主防線)** / **AppShell slot 餵 raw element(`sidebar={<div>}` 等,2026-06-12 Pattern 9,app-shell.spec:296-299)** / **手刻 RAW primitive 取代 DS 元件(raw `<table>`+`<thead>`/`<th>`→`<DataTable>` / `<img rounded-full>`→`<Avatar>` / native `<select>`→`<Select>` / `<hr>`→`<Separator>`,2026-06-16 Pattern 10,user 抓 fork prototype 手刻 table 不用 DataTable;反 pattern 由 `build-ui-canonicals.md` ❌→✅ 對照表 SSOT 驅動;落實「優先消費既有元件」大原則機械閘 — 補 Pattern 1-9 只抓「DS 元件用錯」、漏「根本沒用 DS 元件亂刻 raw HTML」之洞;`@ds-misuse-allow:` 有理由可豁免)**。**判斷層補掃(2026-06-12 fork 四不像 + 先驗滲漏 anchor;hook 零誤判原則不上 regex)**:(a) page-level entry 手拼 raw 殼而無 `<DS.AppShell>`(對照 app-shell.spec「何時用/不用」表;愈不用 DS 愈不觸 hook = 反直覺洞)(b) 手刻 right panel(`w-[Npx] border-l` div,該走 `aside={<AppShellAside>}`)(c) ChromeHeader/頁頂 tabs 沒走 `withTabs` lockstep(header-canonical.spec「withTabs 連動」段)(d) BulkActionBar 內 primary 鈕 / 浮層 shadow(bulk-action-bar.spec 禁止事項 — regex 無法 bound 到 actions slot,判斷層接)(e) FileViewer toolbar 加鈕不走 `onCapabilitiesChange`(file-viewer.spec:183-194;R9 skip-list 豁免該家族故無寫入網)(f) chrome 面(ChromeHeader/SidebarFooter)title 下第二行(registry 簽名涵蓋 stories;fork production code 由本 dim 接)。Hook `check_consumer_app_invariants.sh(r3,2026-06-11 merge)` BLOCKER。Per-violation cite spec.md file:line。Escape `// @ds-misuse-allow:` |
 | 72 | **DS API surface tightening**(2026-05-27 — 治標 vs 治本)| Hook 71 偵測 anti-pattern 是 lint 層攔截;治本要 DS API design 強到 misuse 即 fail tsc。Audit:逐 component review API surface — `size?: number` 該改 `'sm'\|'md'\|'lg'` enum / `columns: Column[]` 該加 min length runtime check / `title` + `description` 該有 type-level XOR / Overlay primitive `defaultOpen` 該 require explicit。配套 codify in `tightening-roadmap.md`(若存在;不存在則以 `props-naming.md` + 各 spec API 段為準,對齊 audit-prompts.md dim 72),分 quarter ship。對應 Dim 71 是攔當前 misuse,本 dim 是消除未來 misuse 可能 |
-| 73 | **Full-story visual+interaction sweep enforce**(2026-05-27 codex M31 P0 finding)| Audit report JSON `storyResults.length === manifest.totalStories`(916)。Sample < 916 = reject(per user「不准抽樣」)。Hook `check_full_story_visual_interaction_sweep.sh` PostToolUse audit-report.json BLOCKER。Escape `"_sampling_allowed": "<rationale>"`(極罕見)|
+| 73 | **Full-story visual+interaction sweep enforce**(2026-05-27 codex M31 P0 finding)| Audit report JSON `storyResults.length === manifest.totalStories`(動態讀 `ds-story-manifest.json`,禁 hardcode 數字 — 2026-07-04 dim 73 修 stale 916)。Sample < totalStories = reject(per user「不准抽樣」)。Hook `check_full_story_visual_interaction_sweep.sh` PostToolUse audit-report.json BLOCKER。Escape `"_sampling_allowed": "<rationale>"`(極罕見)|
 | 74 | **Overlay open/focus/Escape probe**(2026-05-27 codex M31 P0 finding + user 7-bug 錨點「overlay 沒彈出」)| Consumer story 用 Tooltip / Popover / Dialog / Sheet / DropdownMenu / HoverCard Trigger 必含 `defaultOpen` OR `open={true}` OR `play()` interaction click。Trigger-only catalog = reject(visual snapshot 看不到 content)。Hook `check_overlay_open_focus_escape_probe.sh` BLOCKER。HoverCard exception via `@story-trait-allow: missing-opensnapshot` per codex |
 | 75 | **Plugin freshness session-start prompt**(2026-05-27 chain-C ship + user「主動引導」directive)| Fork user session_start hook `check_plugin_fork_health.sh(r2,2026-06-11 merge)` reads local installed plugin.json version → fetch GitHub raw marketplace.json → diff version → if stale prompt run `npm run sync-all`. Sync-all 1-command(2026-06-17 起 npm-only,不再跑 `claude plugin`):npm update 治理本體 + idempotent 刷新接線骨架 + skills;生效分軌(機械即時 / settings 自動 hot-reload / 指引 `/clear` 或下個 session)|
 | 76 | **Escape marker abuse cap**(2026-05-27 per user「不亂加 escape markers」)| Consumer file 10 escape markers 累計 ≥3 distinct types OR ≥5 total → BLOCK。修法 3 選 1:重構走 DS canonical / 拆 file / env override `CLAUDE_BYPASS_ESCAPE_MARKER_AUDIT`。Hook `check_escape_marker_abuse.sh` enforces escape philosophy「rare per-line documented exception,非 daily tool」|

package/ds-story-manifest.json

@@ -7,7 +7,7 @@
       "scripts/composition-fidelity-visual-diff.mjs",
       "product-workspace apps/template/src/AllDsComponents.stories.tsx (ImportSmoke portal → DS Storybook link)"
     ],
-    "generatedAt": "2026-07-03T00:23:00.203Z"
+    "generatedAt": "2026-07-06T11:37:10.794Z"
   },
   "components": {
     "accordion": {
@@ -375,7 +375,6 @@
       "tiers": {
         "展示": [
           "design-system-components-circularprogress-展示--default",
-          "design-system-components-circularprogress-展示--button-loading",
           "design-system-components-circularprogress-展示--inline-action",
           "design-system-components-circularprogress-展示--inline-cell-loading",
           "design-system-components-circularprogress-展示--full-screen-overlay"
@@ -499,7 +498,8 @@
           "design-system-components-datatable-展示--row-drag-interactive",
           "design-system-components-datatable-展示--row-drag-with-virtualization",
           "design-system-components-datatable-展示--roadmap-all-in-one",
-          "design-system-components-datatable-展示--roadmap-perf-budget"
+          "design-system-components-datatable-展示--roadmap-perf-budget",
+          "design-system-components-datatable-展示--with-pagination"
         ],
         "設計規格": [
           "design-system-components-datatable-設計規格--overview",
@@ -563,6 +563,7 @@
           "design-system-components-datepicker-展示--show-time",
           "design-system-components-datepicker-展示--range-popover-open",
           "design-system-components-datepicker-展示--show-time-popover-open",
+          "design-system-components-datepicker-展示--need-confirm-date-only-open",
           "design-system-components-datepicker-展示--show-time-range-popover-open",
           "design-system-components-datepicker-展示--range-middle-hover-state",
           "design-system-components-datepicker-展示--show-time-range",
@@ -587,6 +588,7 @@
       "openSnapshotIds": [
         "design-system-components-datepicker-展示--range-popover-open",
         "design-system-components-datepicker-展示--show-time-popover-open",
+        "design-system-components-datepicker-展示--need-confirm-date-only-open",
         "design-system-components-datepicker-展示--show-time-range-popover-open"
       ],
       "exception": null
@@ -686,7 +688,6 @@
         "展示": [
           "design-system-components-empty-展示--search-no-results",
           "design-system-components-empty-展示--no-tasks",
-          "design-system-components-empty-展示--load-failure",
           "design-system-components-empty-展示--no-permission"
         ],
         "設計規格": [
@@ -1033,6 +1034,28 @@
       "openSnapshotIds": [],
       "exception": null
     },
+    "pagination": {
+      "tiers": {
+        "展示": [
+          "design-system-components-pagination-展示--default",
+          "design-system-components-pagination-展示--full-bar",
+          "design-system-components-pagination-展示--many-pages",
+          "design-system-components-pagination-展示--states"
+        ],
+        "設計規格": [
+          "design-system-components-pagination-設計規格--overview",
+          "design-system-components-pagination-設計規格--inspector",
+          "design-system-components-pagination-設計規格--color-matrix",
+          "design-system-components-pagination-設計規格--state-behavior",
+          "design-system-components-pagination-設計規格--accessibility"
+        ],
+        "設計原則": [
+          "design-system-components-pagination-設計原則--usage-guidance"
+        ]
+      },
+      "openSnapshotIds": [],
+      "exception": null
+    },
     "peoplepicker": {
       "tiers": {
         "展示": [
@@ -1088,22 +1111,22 @@
     "profilecard": {
       "tiers": {
         "展示": [
-          "design-system-internal-profilecard-展示--default"
+          "design-system-components-profilecard-展示--default"
         ],
         "設計規格": [
-          "design-system-internal-profilecard-設計規格--overview",
-          "design-system-internal-profilecard-設計規格--inspector",
-          "design-system-internal-profilecard-設計規格--section-matrix",
-          "design-system-internal-profilecard-設計規格--color-matrix",
-          "design-system-internal-profilecard-設計規格--hover-card-integration",
-          "design-system-internal-profilecard-設計規格--state-behavior",
-          "design-system-internal-profilecard-設計規格--accessibility"
+          "design-system-components-profilecard-設計規格--overview",
+          "design-system-components-profilecard-設計規格--inspector",
+          "design-system-components-profilecard-設計規格--section-matrix",
+          "design-system-components-profilecard-設計規格--color-matrix",
+          "design-system-components-profilecard-設計規格--hover-card-integration",
+          "design-system-components-profilecard-設計規格--state-behavior",
+          "design-system-components-profilecard-設計規格--accessibility"
         ],
         "設計原則": [
-          "design-system-internal-profilecard-設計原則--usage-guidance",
-          "design-system-internal-profilecard-設計原則--trigger-context-rule",
-          "design-system-internal-profilecard-設計原則--fixed-width-rule",
-          "design-system-internal-profilecard-設計原則--section-rule"
+          "design-system-components-profilecard-設計原則--usage-guidance",
+          "design-system-components-profilecard-設計原則--trigger-context-rule",
+          "design-system-components-profilecard-設計原則--fixed-width-rule",
+          "design-system-components-profilecard-設計原則--section-rule"
         ]
       },
       "openSnapshotIds": [],
@@ -1679,6 +1702,6 @@
       "exception": null
     }
   },
-  "totalComponents": 62,
-  "totalStories": 910
+  "totalComponents": 63,
+  "totalStories": 920
 }

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.80。
+> 全 component / pattern 的 variants / sizes / 禁止事項。build-time 從 spec.md frontmatter 生成,禁手改。v0.1.0-beta.82。
 
 # Components
 
@@ -209,6 +209,11 @@ Source(AI 讀此看官方範例): src/components/LinkInput/
 Storybook: https://ajenchen-design-system.netlify.app
 Source(AI 讀此看官方範例): src/components/NumberInput/
 
+## Pagination(family composite)
+
+Storybook: https://ajenchen-design-system.netlify.app
+Source(AI 讀此看官方範例): src/components/Pagination/
+
 ## PeoplePicker(family 4)
 
 Storybook: https://ajenchen-design-system.netlify.app
@@ -219,6 +224,11 @@ Source(AI 讀此看官方範例): src/components/PeoplePicker/
 Storybook: https://ajenchen-design-system.netlify.app
 Source(AI 讀此看官方範例): src/components/Popover/
 
+## ProfileCard(family composite)
+
+Storybook: https://ajenchen-design-system.netlify.app
+Source(AI 讀此看官方範例): src/components/ProfileCard/
+
 ## ProgressBar(family self-contained)
 
 Storybook: https://ajenchen-design-system.netlify.app

package/llms.txt

@@ -1,7 +1,7 @@
 # @qijenchen/design-system
 
 > World-class React design system(Radix/shadcn + Tailwind v4 + 自訂 design token)。
-> 54 components + 4 public patterns + design tokens。v0.1.0-beta.80。
+> 56 components + 4 public patterns + design tokens。v0.1.0-beta.82。
 
 本檔由 source(spec.md frontmatter + Storybook index)build-time 自動生成,**禁手改**(CI --check drift gate 守)。
 每元件 / pattern 的完整 variants / sizes / 禁止事項 全文見 [llms-full.txt](./llms-full.txt)。
@@ -40,8 +40,10 @@
 - [Input](https://ajenchen-design-system.netlify.app): 見 Storybook / spec — src:components/Input
 - [LinkInput](https://ajenchen-design-system.netlify.app): 見 Storybook / spec — src:components/LinkInput
 - [NumberInput](https://ajenchen-design-system.netlify.app): 見 Storybook / spec — src:components/NumberInput
+- [Pagination](https://ajenchen-design-system.netlify.app): 見 Storybook / spec — src:components/Pagination
 - [PeoplePicker](https://ajenchen-design-system.netlify.app): 見 Storybook / spec — src:components/PeoplePicker
 - [Popover](https://ajenchen-design-system.netlify.app): 見 Storybook / spec — src:components/Popover
+- [ProfileCard](https://ajenchen-design-system.netlify.app): 見 Storybook / spec — src:components/ProfileCard
 - [ProgressBar](https://ajenchen-design-system.netlify.app): 見 Storybook / spec — src:components/ProgressBar
 - [RadioGroup](https://ajenchen-design-system.netlify.app): sizes:sm/md/lg — src:components/RadioGroup
 - [Rating](https://ajenchen-design-system.netlify.app): 見 Storybook / spec — src:components/Rating

package/package.json

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

package/src/components/Alert/alert.anatomy.stories.tsx

@@ -21,11 +21,12 @@ export const Overview: Story = {
     <div className="flex flex-col gap-10">
       <div>
         <H3>Anatomy</H3>
-        <Desc>Alert 跟 Toast 共用同一套排版、圖示與主題策略。結構:圖示 + 標題 + 說明文字 + 右側操作區(endContent)+ 右上角關閉鈕。</Desc>
+        <Desc>Alert 跟 Toast 共用同一套排版、圖示與主題策略。結構:圖示 + 標題 + 說明文字 + 右側操作區(endContent)+ 右上角關閉鈕(需傳 onDismiss 才渲染)。</Desc>
         <Alert
           variant="warning"
           title="方案即將到期"
           description="您的 Pro 方案將在 3 天後到期,請及時續訂以維持服務"
+          onDismiss={() => {}} // anatomy 展示含 dismiss X slot(2026-07-05 D4:X 僅在傳 onDismiss 時渲染)
         />
       </div>
 
@@ -42,8 +43,8 @@ export const Overview: Story = {
                 ['title', 'ReactNode', '必填', '主要訊息'],
                 ['description', 'ReactNode', '—', '補充說明'],
                 ['endContent', 'ReactNode', '—', '右側操作區（CTA 按鈕等）'],
-                ['dismissible', 'boolean', 'true', '是否顯示右上角關閉按鈕'],
-                ['onDismiss', '() => void', '—', '按下關閉按鈕時觸發'],
+                ['dismissible', 'boolean', 'true', '搭配 onDismiss 顯示右上角關閉按鈕(兩者同時成立才渲染 X)'],
+                ['onDismiss', '() => void', '—', '按下關閉按鈕時觸發;未傳則不渲染 X(2026-07-05 D4)'],
               ].map(([p, t, d, desc]) => (
                 <tr key={p}><Td mono>{p}</Td><Td mono>{t}</Td><Td mono>{d}</Td><Td>{desc}</Td></tr>
               ))}
@@ -71,6 +72,7 @@ export const Inspector: InspectorStory = {
     title: '方案即將到期',
     description: '您的 Pro 方案將在 3 天後到期,請及時續訂以維持服務',
     dismissible: true,
+    onDismiss: () => {}, // 2026-07-05 D4:X 僅在傳 onDismiss 時渲染,Inspector 切 dismissible 才看得到 X
   },
   argTypes: {
     variant: {
@@ -90,7 +92,7 @@ export const Inspector: InspectorStory = {
     },
     title: { control: 'text', description: '主要訊息' },
     description: { control: 'text', description: '補充說明' },
-    dismissible: { control: 'boolean', description: '是否顯示關閉按鈕' },
+    dismissible: { control: 'boolean', description: '是否顯示關閉按鈕(需同時傳 onDismiss 才渲染 X)' },
   },
   render: (args) => <Alert {...args} />,
 }
@@ -189,11 +191,12 @@ export const StateBehavior: Story = {
       <div>
         <H3>Dismissible(右側 close icon)</H3>
         <Desc>
-          Alert 預設 `dismissible=true`,右上角顯示 close button。按 close 觸發 `onDismiss` 由 consumer 控制移除(Alert 本身不 own unmount 狀態——inline 通知通常需要 consumer 記住「使用者已關閉」狀態)。
+          Alert 預設 `dismissible=true`,**傳入 `onDismiss` 時**右上角顯示 close button(未傳 handler 不渲染 X——controlled-only,無 handler 的 X 是死按鈕;2026-07-05 D4)。按 close 觸發 `onDismiss` 由 consumer 控制移除(Alert 本身不 own unmount 狀態——inline 通知通常需要 consumer 記住「使用者已關閉」狀態)。
         </Desc>
         <div className="flex flex-col gap-3 max-w-xl">
-          <Alert variant="info" title="可關閉" description="右上角有 close icon,按下觸發 onDismiss" />
+          <Alert variant="info" title="可關閉" description="右上角有 close icon,按下觸發 onDismiss" onDismiss={() => {}} />
           <Alert variant="warning" title="不可關閉" description="永久性警告,設 dismissible={false} 隱藏 close icon" dismissible={false} />
+          <Alert variant="neutral" title="靜態通知" description="沒傳 onDismiss 時同樣不渲染 close icon(避免按了沒反應的假 affordance)" />
         </div>
       </div>
 

package/src/components/Alert/alert.spec.md

@@ -134,7 +134,7 @@ Alert chrome corner 可承載多個 action(close 左側並排):
 
 ### Multi corner action 場景
 
-目前 Alert API 只透過 `dismissible` 渲染單一 close X。多 corner action 場景目前不支援;若未來 consumer 有需求,走 Checkpoint 3 決策(M8 benchmark + consumer survey),不預先投機擴 API。
+目前 Alert API 只透過 `dismissible` + `onDismiss` 渲染單一 close X(X 僅在傳 `onDismiss` 時渲染——controlled-only,無 handler 的 X 是死按鈕;對齊 Polaris Banner `onDismiss`-driven,2026-07-05 D4,詳 `../Notice/notice.spec.md`「邊界案例」)。多 corner action 場景目前不支援;若未來 consumer 有需求,走 Checkpoint 3 決策(M8 benchmark + consumer survey),不預先投機擴 API。
 
 ---
 
@@ -155,7 +155,7 @@ Subtle vs Solid 的完整 variant × theme class 對照見 anatomy `ColorMatrix`
 - **`inline`(預設)**:頁面內嵌,圓角 + 邊框,像一張 card 嵌在內容區塊裡
 - **`fixed`**:頂部全域警告,無圓角無邊框,橫跨頁面寬度
 
-**為什麼兩種 placement 的圓角不同**:inline 是 content-level card(rounded-md = 4px,對齊 Alert 的 inline 容器身份,與 Dialog / Card 一致);fixed 是 page-level bar(無 radius,橫跨畫面形成整條)。Toast 是浮層用 `rounded-lg`(8px,浮層慣例),跟 Alert 區分。
+**為什麼兩種 placement 的圓角不同**:inline 是 content-level card(rounded-md = 4px,對齊 Alert 的 inline 容器身份,與 Card 同 tier — 見 `tokens/radius/radius.spec.md`「一般元件」;Dialog 屬浮層走 rounded-lg);fixed 是 page-level bar(無 radius,橫跨畫面形成整條)。Toast 是浮層用 `rounded-lg`(8px,浮層慣例),跟 Alert 區分。
 
 完整 placement 對照見 anatomy `PlacementMatrix` story。
 
@@ -180,7 +180,7 @@ Subtle vs Solid 的完整 variant × theme class 對照見 anatomy `ColorMatrix`
 
 ## 邊界案例
 
-- **Disabled(dismiss button)**:Alert **不提供 dismiss 停用 API**——banner dismiss 恆可用(對齊 Polaris / Material Banner:通知關閉鈕應永遠可按)。Alert 本身亦無 `disabled` prop(持久通知不該被禁用)。若需防止 close action(API in-flight)被雙擊,consumer 在 `onDismiss` 內自行 debounce / 加上層鎖,不在 UI 層加 disable(Alert 不提供 dismiss 停用 API、也不把 disabled 轉傳給內部 dismiss Button;Button primitive 本身支援 disabled,但 Alert 刻意不開洞)。
+- **Disabled(dismiss button)**:Alert **不提供 dismiss 停用 API**——banner dismiss 恆可用(對齊 Polaris / Material Banner:通知關閉鈕應永遠可按)。「恆可用」指**已渲染的 X 永遠可按**;X 本身僅在傳 `onDismiss` 時渲染(否則是死按鈕假 affordance,2026-07-05 D4,見「Multi corner action 場景」段 + `../Notice/notice.spec.md`「邊界案例」)。Alert 本身亦無 `disabled` prop(持久通知不該被禁用)。若需防止 close action(API in-flight)被雙擊,consumer 在 `onDismiss` 內自行 debounce / 加上層鎖,不在 UI 層加 disable(Alert 不提供 dismiss 停用 API、也不把 disabled 轉傳給內部 dismiss Button;Button primitive 本身支援 disabled,但 Alert 刻意不開洞)。
 - **Loading**:Alert 本身不需 loading state(非 async surface);若 Alert body action row 內 CTA 在 async 動作中,該 Button 自己處理 `loading` prop。
 - **Empty / icon-only**:Alert 必有 `title`(API contract),無 empty 場景;若無 description 則僅顯示 title + icon,layout 自動收斂。
 - **極長字串**:title 單行 truncate、description 自由換行不截斷(皆繼承 ItemContent 預設);description 超過 2–3 行屬誤用,改 Dialog(見禁止事項)。

package/src/components/Alert/alert.tsx

@@ -66,6 +66,11 @@ export interface AlertProps
   title: React.ReactNode
   description?: React.ReactNode
   endContent?: React.ReactNode
+  /**
+   * 顯示關閉鈕(預設 true)。**需同時傳 `onDismiss` 才會渲染 X** — Alert 是 controlled-only
+   * (不自我移除),無 handler 的 X 是死按鈕(2026-07-05 D4;對齊 Polaris Banner / Ant Alert)。
+   * 條件判斷 SSOT 在 Notice(notice.tsx `showDismiss`),Alert 原樣 forward。
+   */
   dismissible?: boolean
   onDismiss?: () => void
 }
@@ -80,7 +85,10 @@ const Alert = React.forwardRef<HTMLDivElement, AlertProps>(
       title,
       description,
       endContent,
-      dismissible = true,
+      // 2026-07-05 D4:不 destructure-default(原 `= true` 會把「consumer 沒傳」materialize 成顯式
+      // true,讓 Notice 的 dev-warn 無法分辨消費端矛盾)。等效預設 true 由 Notice showDismiss
+      // `!== false` 承擔,行為不變;X 僅在同時傳 onDismiss 時渲染(SSOT 在 notice.tsx)。
+      dismissible,
       onDismiss,
       className,
       ...props

package/src/components/AppShell/app-shell.anatomy.stories.tsx

@@ -1,3 +1,6 @@
+// @anatomy-rationale: Inspector + ColorMatrix N/A — AppShell 是 page-level layout composite
+// (sidebar+header+main+aside 組合),無 cva color variant → ColorMatrix N/A;
+// 無 interactive prop control(slots 全 ReactNode 組合)→ Inspector N/A(Dim 13 例外 marker)。
 // @benchmark-cited: anatomy 6-canonical 對齊 Polaris / Material anatomy spec
 // @story-baseline: packages/design-system/src/components/Sidebar/sidebar.stories.tsx#IconCollapse
 // (透過 ./_demo-helpers AcmeSidebar / PageHeader / WorkspaceBrand / UserFooter 共用 baseline,

package/src/components/AppShell/app-shell.spec.md

@@ -1,6 +1,7 @@
 ---
 component: AppShell
 family: composite  # 組合 sidebar+header+main+aside,非 Family 1-4 row element
+traits: []  # page-level layout composite,slots 全 ReactNode 組合,無 trait variants(R3 trait enforce 無適用項;2026-07-04 dim 29 補宣告)
 scope: web service page-level layout primitive (sidebar + header + main + aside composition)
 benchmark:
   - Mantine AppShell: https://mantine.dev/core/app-shell/ — 6-slot (Header/Navbar/Aside/Footer/Main) + layout="default|alt" mode
@@ -201,7 +202,7 @@ function CustomAside() {
 - `primary-header` mode:右側 fix 在 **Header 下方**(不 underlap header,跟 sidebar 同高 — 都從 header 底邊起)
 - Width consumer 自傳 `width` prop(`number` 或 `{ md, xl }` breakpoint-keyed),DS 不發明 width token,**clamp `min-width: 240` / `max-width: 640`** 避免過窄無法閱讀 / 過寬擠 main
 - 跟 main 共享 layout space(main width = viewport - sidebar - aside)
-- **Scroll ownership**:Aside 自帶 scroll(`overflow-y: auto` + `min-h-0`,per Atlassian Layout 慣例),main 自帶 scroll,**禁止** body-level scroll
+- **Scroll ownership**:Aside 自帶 scroll(body 包 `<ScrollArea>` primitive + `min-h-0`,per Atlassian Layout 慣例),main 自帶 scroll,**禁止** body-level scroll
 
 **Modal overlay** 行為:
 - 消費既有 `sheet.spec.md` canonical(從右滑出 + Esc 關 + click-outside 關 + focus trap + restore focus)
@@ -262,7 +263,7 @@ Main 內塞什麼(table / field / card / page header / list)的 layout + spacing
 | **`⌘.`(macOS)/ `Ctrl+.`(Windows)** | Toggle aside | Linear convention(新加) |
 | **Skip-to-main link** | `Tab` 第一站 focus 「Skip to content」link → `main` | A11y WCAG 2.4.1 bypass blocks;對齊 Atlassian Layout skip-link |
 
-兩者消費既有 Sidebar keyboard shortcut 機制(`useEffect` + `document.addEventListener('keydown')`),AppShell 不發明新機制。
+兩者消費既有 Sidebar keyboard shortcut 機制(`useEffect` + `window.addEventListener('keydown')`),AppShell 不發明新機制。
 
 ---
 

package/src/components/AppShell/app-shell.tsx

@@ -282,7 +282,7 @@ AppShell.displayName = 'AppShell'
  * AppShellAside — right panel:standard inline(desktop) vs modal overlay(mobile)。
  *
  * Desktop(viewport ≥ 768px):
- *   - Render 直接放 layout grid 右側(asideOpen=true 才 mount,close hide via parent)
+ *   - Render 直接放 layout grid 右側(AppShell 恆 render {aside};AppShellAside 於 !asideOpen 自行 return null — 內部自決,非 via parent)
  *   - 不蓋 mask / background 可操作 / 佔 layout 寬
  *   - Vertical extent:primary-sidebar → 頂天立地 / primary-header → header 下方
  *

package/src/components/AspectRatio/aspect-ratio.spec.md

@@ -3,8 +3,7 @@ component: AspectRatio
 family: self-contained
 variants: {}
 sizes: {}
-traits:
-  - isMatrixHeavy
+traits: []  # 2026-07-04 audit:移除幻影 isMatrixHeavy(spec body「為何無 Matrix」明文 rationale + 0 matrix stories,trait 與自家宣告矛盾)
 benchmark:
   - Radix AspectRatio primitive: github.com/radix-ui/primitives/tree/main/packages/react/aspect-ratio
 ---