@qijenchen/design-system 0.1.0-beta.37 → 0.1.0-beta.38

package/ds-canonical/references/README.md

@@ -4,19 +4,22 @@
 
 Agent 在執行時按需讀的深度 reference 檔 — audit protocol / FP 記憶 / workflow recipe / lookup tables。**不是 product design canonical**(那該進 spec.md / CLAUDE.md)。
 
-## 當前居民(15 檔,2026-05-18 update)
+## 當前居民(17 檔,2026-05-30 update)
 
 | Ref | 用途 |
 |-----|------|
 | `audit-coverage-vs-24-checklist.md` | 業界 24-checklist 對照 + 為何不平行 audit 24 dim rationale |
 | `build-ui-canonicals.md` | 建 UI 前 12 情境 + 8 layout primitive lookup |
+| `composition-fidelity.md` | Composition fidelity visual diff SSOT — DS components 在 consumer 渲染必跟 DS canonical 一致(byte-identity 不夠,需 visual diff) |
 | `cva-patterns.md` | cva 適用 / 不適用 + 例外清單(跟 CLAUDE.md shadcn 規範互補) |
 | `drag-canonical.md` | 世界級 drag impl 對照 + dnd-kit collision strategy + Phase 1/2 fix plan |
 | `item-anatomy-recipe.md` | 7 步建立新 row primitive workflow + audit grep guard |
 | `naming-conventions.md` | 命名詳表 + 禁止清單(CLAUDE.md # 命名一致性 pointer) |
 | `principle-dim-map.json` | M-rule / trait / hook → audit dim explicit mapping(SSOT for dim coverage) |
 | `props-naming.md` | Props callback / Badge / icon canonical 詳表 |
+| `scenario-definition.md` | Monorepo 2-Scenario architecture SSOT(Scenario A direct fork DS / Scenario B fork template + mirror chain + verify checkpoints)|
 | `spec-rules.md` | SSOT 機制 / 邊界案例 scope default 詳展 |
+| `story-baseline-registry.json` | Anti-drift registry — stories wrap 既有 primitive 的 machine-readable canonical archetype(hook `check_story_invariants.sh R8` 讀)|
 | `ssot-consultation.md` | SSOT 消費完整對照表 |
 | `ssot-index.md` | High-risk interface ownership map(propose 前 grep 找 owner) |
 | `structural-token-retention.md` | 6 類結構性保留 token canonical(audit Dim 48 triple-verify) |

package/ds-canonical/skills/codex-collab/references/brief-template.md

@@ -38,7 +38,7 @@ N. <SSOT 是否該抽到更上層 primitive?>
 - 必產 3-column cite table(claim / path:line / reasoning)
 
 ## 🚨 三 invariant — 2026-05-23 user 永久 directive(缺一 = brief 不合格)
-1. **全盤閱讀全部 source**(CLAUDE.md / 31 active M-rules / 5 rules/*.md / 82 audit dims SKILL.md / 全 82 spec.md / 全 196 stories / 全 62 components / tokens / patterns / hooks / 20 memory files / planning),**禁憑記憶**
+1. **全盤閱讀全部 source**(CLAUDE.md / 31 active M-rules / 5 rules/*.md / 88 audit dims SKILL.md / 全 82 spec.md / 全 196 stories / 全 62 components / tokens / patterns / hooks / 20 memory files / planning),**禁憑記憶**
 2. **Triple-verify per finding**:(a) grep DS-wide 確認 pattern 存在 (b) Read 對應 spec.md / tsx 確認 problem 真存在 (c) 對照既有 canonical 確認非 documented exception。任一 NO → 自動撤回,**禁無病呻吟**
 3. **禁抽樣** — DS-wide ALL files 全掃,context 不夠拆 stage 全跑完;sub-agent admission「I sampled / spot-check / representative」= audit incomplete reject
 ```

package/ds-story-manifest.json

@@ -7,7 +7,7 @@
       "scripts/composition-fidelity-visual-diff.mjs",
       "product-workspace apps/template/src/AllDsComponents.stories.tsx (DsCanonicalPortal)"
     ],
-    "generatedAt": "2026-05-30T02:15:38.027Z"
+    "generatedAt": "2026-05-30T04:06:32.550Z"
   },
   "components": {
     "accordion": {

package/package.json

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

package/ds-canonical/skills/design-system-audit/references/spec-template.md

@@ -1,66 +0,0 @@
-# Spec.md 兩段式 chapter template(2026-05-17 codify,codex Q8 verdict (c) 兩段式)
-
-**對齊**:Polaris 7-section component spec + Carbon Component Spec template + Material 3 component anatomy。比全寫死更適合複雜元件,比完全自由更能 audit。
-
-## 必填 7 維(順序固定,hook 攔缺失或嚴重漂移)
-
-```markdown
-# <ComponentName> 設計原則
-
-## 1. Layout Family / scope
-- Layout Family: 1 / 2 / 3 / 4(或明示「self-contained / composite」+ rationale)
-- Implementation base: 基於 Radix X / 基於 cmdk / native / 自建 + 理由
-- Token / pattern 消費清單(SSOT 消費 canonical)
-
-## 2. 何時用
-- 真實業務情境(Jira / Stripe / Notion 可辨識)
-- 預設使用案例(非邊緣 case)
-
-## 3. 何時不用
-- 近親元件分界(vs SiblingX / SiblingY)
-- 反向 trigger:這些情境改用 Z
-
-## 4. 近親分界(decision tree if multiple sibling)
-- vs A:differentiate by axis-1
-- vs B:differentiate by axis-2
-
-## 5. 尺寸 / variant / state canonical
-- Size:xs / sm / md / lg(field-height / table-row 等 token 對應)
-- Variant:列 cva 預設值 + 為什麼
-- State:default / hover / focus / active / disabled / loading / error 各自視覺定義 + state machine 疊加組合(M5)
-
-## 6. 邊界案例 + a11y
-- Empty / loading / error / dark mode / density / icon-only 各自處理
-- ARIA roles + keyboard map(互動元件強制;純視覺 indicator 豁免明寫)
-- Scope defaults 豁免清單(若適用,cite `spec-rules.md`)
-
-## 7. 相關 SSOT links / reciprocal pointers
-- 上游 pattern / token / primitive 引用(`xxx.spec.md「HEADING」`)
-- 下游 consumer 元件 list
-- Reciprocal check:被本 spec link 的對方有沒回連?
-```
-
-## 自由 rationale(後段)— 不限格式
-
-每 component spec 可在 7 維後加任意「為什麼」/ historical anchor / world-class benchmark cite / RFC link / 邊界討論 — hook **不**攔此段。
-
-範例:
-- Button.spec.md 加「Pill Layout 為什麼自建非 Family 3」rationale
-- Field.spec.md 加「為什麼 block primitive 不自己變高」decision tree
-- DataTable.spec.md 加 Phase 7 RFC archive
-
-## Hook 機械強制
-
-**Hook**:`check_spec_chapter_canonical.sh`(待 ship)— PreToolUse Write/Edit `*.spec.md` 檢:
-- 必填 7 維 heading 全在(`## 1. Layout Family` 等)
-- 順序對(1 < 2 < 3 ... < 7)
-- 缺任一 heading → P0 BLOCKER(可 escape:檔頭 `// @spec-template-exempt: <reason>` 例外,用 ≥ 3 家 world-class DS 對照證該 component 不適用標準 template)
-
-**Soft warn**:7 維外的 chapter 結構不限。但若 audit Dim 15 偵測跨 spec 命名漂移(如「為什麼 block」vs「為什麼不變高」相同概念兩寫法)→ flag 統一。
-
-## 歷史錨點
-
-- 2026-05-17 codex Q8 verdict:Button vs Field 章節 order 不一(Button 有「何時不用」/ Field 有「為什麼 block」rationale-heavy)→ 該兩段式
-- Polaris template:https://github.com/Shopify/polaris/blob/main/polaris-react/.template/component.mdx
-- Carbon Component Spec:https://carbondesignsystem.com/contributing/component-checklist/
-- Material 3 anatomy:https://m3.material.io/components/<component>/specs