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

package/ds-canonical/hooks/tests/test_auto_regen_ds_barrel.sh

@@ -0,0 +1,180 @@
+#!/bin/bash
+# Tests for auto_regen_ds_barrel.sh(2026-05-25 SSOT auto-sync invariant)
+#
+# Hook 規則(PostToolUse Write|Edit|MultiEdit,reads tool_input.file_path):
+#   - 這是 auto-fix-up hook,**不是 BLOCKER**:任何情況都 exit 0,從不 deny/block。
+#   - "Fire"(positive)= 在 stdout emit JSON additionalContext(hookSpecificOutput),
+#     發生條件:file_path 在 packages/design-system/src/(components|patterns|hooks|lib)/
+#     且非 stories/spec/test,且 gen-design-system-barrel.mjs 輸出含 'generated' / 'with N components'。
+#   - "Silent"(negative)= 無 stdout(exit 0),發生條件:
+#       (a) file_path 空
+#       (b) file_path 不在 scope(components|patterns|hooks|lib)
+#       (c) file_path 是 .stories/.spec/.test/.spec.md
+#       (d) barrel 腳本沒印 'generated' 關鍵字
+#
+# Determinism:CLAUDE_PROJECT_DIR 指向 TMP_DIR,內含 **stub** gen scripts,
+#   控制 barrel 是否印 'generated' + 不污染 real repo barrel 檔案。Hook 在 line 38-39
+#   會 cd 進 CLAUDE_PROJECT_DIR 再 `node scripts/...`。
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../auto_regen_ds_barrel.sh"
+
+if [ ! -f "$HOOK" ]; then echo "FATAL: hook not found: $HOOK"; exit 1; fi
+if ! command -v node >/dev/null 2>&1; then echo "FATAL: node not on PATH (hook 需要 node)"; exit 1; fi
+
+PASS=0
+FAIL=0
+FAILED_TESTS=""
+
+TMP_DIR=$(mktemp -d)
+trap 'rm -rf "$TMP_DIR"' EXIT
+
+# --- Build isolated project dir with stub gen scripts ----------------------
+# index 腳本只需成功 run;barrel 腳本控制是否印 'generated'(emission gate)。
+mkdir -p "$TMP_DIR/scripts" "$TMP_DIR/.claude/logs"
+cat > "$TMP_DIR/scripts/gen-component-indexes.mjs" <<'EOF'
+console.log("component indexes regenerated");
+EOF
+
+# Default barrel stub = 印 'generated'(讓 in-scope case 會 emit)
+write_barrel_with_generated() {
+  cat > "$TMP_DIR/scripts/gen-design-system-barrel.mjs" <<'EOF'
+console.log("barrel src/index.ts generated with 12 components");
+EOF
+}
+# Alt barrel stub = 不印 'generated'(模擬 no-op,emission 應被抑制)
+write_barrel_without_generated() {
+  cat > "$TMP_DIR/scripts/gen-design-system-barrel.mjs" <<'EOF'
+console.log("nothing changed; up to date");
+EOF
+}
+write_barrel_with_generated
+
+export CLAUDE_PROJECT_DIR="$TMP_DIR"
+
+# --- run-hook helper:pipe JSON into hook via stdin -------------------------
+run_hook() {
+  local file_path="$1"
+  local payload
+  payload=$(jq -n --arg fp "$file_path" \
+    '{hook_event_name:"PostToolUse", tool_name:"Write", tool_input:{file_path:$fp, content:""}}')
+  STDOUT=$(mktemp); STDERR=$(mktemp)
+  set +e
+  printf '%s' "$payload" | bash "$HOOK" >"$STDOUT" 2>"$STDERR"
+  EXIT=$?
+  set -e
+  STDOUT_TEXT=$(cat "$STDOUT" 2>/dev/null)
+  STDERR_TEXT=$(cat "$STDERR" 2>/dev/null)
+  rm -f "$STDOUT" "$STDERR"
+}
+
+# POSITIVE assertion:hook fires = exit 0 + stdout 含 additionalContext needle
+expect_fire() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && echo "$STDOUT_TEXT" | grep -qF "auto-regen DS barrel"; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected FIRE: exit 0 + additionalContext, got exit=$EXIT, stdout=$([ -n "$STDOUT_TEXT" ] && echo non-empty || echo empty))"
+    echo "  --- stdout ---"; echo "$STDOUT_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+# NEGATIVE assertion:hook silent = exit 0 + 無 stdout(且 never block / exit 2)
+expect_silent() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && [ -z "$STDOUT_TEXT" ]; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected SILENT: exit 0 + no stdout, got exit=$EXIT, stdout=$([ -n "$STDOUT_TEXT" ] && echo non-empty || echo empty))"
+    echo "  --- stdout ---"; echo "$STDOUT_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+echo "=== auto_regen_ds_barrel tests ==="
+
+# ---------------------------------------------------------------------------
+# POSITIVE cases(SHOULD fire = emit additionalContext)
+# ---------------------------------------------------------------------------
+
+# 1. In-scope component primary tsx → fire(real violation, guards over-narrow regex)
+run_hook "packages/design-system/src/components/Badge/badge.tsx"
+expect_fire "1. components/Badge/badge.tsx → FIRE (regen)"
+
+# 2. In-scope pattern tsx → fire(scope 'patterns' alt)
+run_hook "packages/design-system/src/patterns/element-anatomy/item-anatomy.tsx"
+expect_fire "2. patterns/.../item-anatomy.tsx → FIRE"
+
+# 3. In-scope hooks/*.ts → fire(barrel includes hooks)
+run_hook "packages/design-system/src/hooks/use-disclosure.ts"
+expect_fire "3. hooks/use-disclosure.ts → FIRE"
+
+# 4. In-scope lib/*.ts → fire(barrel includes lib)
+run_hook "packages/design-system/src/lib/cn.ts"
+expect_fire "4. lib/cn.ts → FIRE"
+
+# 5. In-scope per-component index.ts → fire(barrel 也 include index 改動)
+run_hook "packages/design-system/src/components/Badge/index.ts"
+expect_fire "5. components/Badge/index.ts → FIRE"
+
+# 6. NEAR-MISS guard against OVER-BROAD exclusion regex:
+#    'specimen.tsx' 含 'spec' substring 但 **不是** .spec 檔 → 必須 FIRE,不可被誤排除。
+#    (exclusion regex 是 \.(...spec...)\.(tsx?|md)$ anchored,specimen 不該命中)
+run_hook "packages/design-system/src/components/Specimen/specimen.tsx"
+expect_fire "6. NEAR-MISS specimen.tsx (含 'spec' 子字串) → FIRE (regex 非過寬)"
+
+# ---------------------------------------------------------------------------
+# NEGATIVE cases(should NOT fire = silent, exit 0)
+# ---------------------------------------------------------------------------
+
+# 7. Empty file_path → silent(line 26 early exit)
+run_hook ""
+expect_silent "7. empty file_path → silent"
+
+# 8. Out-of-scope app consumer tsx → silent(不在 design-system scope)
+run_hook "apps/template/src/App.tsx"
+expect_silent "8. apps/template/src/App.tsx (out of scope) → silent"
+
+# 9. NEAR-MISS scope guard:design-system/src/tokens/ 不在 (components|patterns|hooks|lib) → silent
+#    (guards against over-broad scope regex matching all of design-system/src)
+run_hook "packages/design-system/src/tokens/colors.ts"
+expect_silent "9. NEAR-MISS tokens/colors.ts (DS src but 非 barrel scope) → silent"
+
+# 10. In-scope .stories.tsx → silent(line 34 exclusion)
+run_hook "packages/design-system/src/components/Badge/badge.stories.tsx"
+expect_silent "10. badge.stories.tsx → silent (excluded)"
+
+# 11. In-scope .anatomy.stories.tsx → silent
+run_hook "packages/design-system/src/components/Badge/badge.anatomy.stories.tsx"
+expect_silent "11. badge.anatomy.stories.tsx → silent (excluded)"
+
+# 12. In-scope .spec.md → silent
+run_hook "packages/design-system/src/components/Badge/badge.spec.md"
+expect_silent "12. badge.spec.md → silent (excluded)"
+
+# 13. In-scope .spec.ts → silent
+run_hook "packages/design-system/src/components/Badge/badge.spec.ts"
+expect_silent "13. badge.spec.ts → silent (excluded)"
+
+# 14. In-scope .test.tsx → silent
+run_hook "packages/design-system/src/components/Badge/badge.test.tsx"
+expect_silent "14. badge.test.tsx → silent (excluded)"
+
+# 15. Emission gate:in-scope tsx BUT barrel 沒印 'generated' → silent(no additionalContext)
+#     即使 scripts run 成功,grep 'generated|with N components' 沒命中 → 不 emit。
+write_barrel_without_generated
+run_hook "packages/design-system/src/components/Badge/badge.tsx"
+expect_silent "15. in-scope tsx, barrel no 'generated' output → silent (emission gate)"
+write_barrel_with_generated  # restore for any later cases
+
+echo ""
+echo "=== Summary ==="
+echo "Passed: $PASS / $((PASS + FAIL))"
+if [ "$FAIL" -gt 0 ]; then
+  printf "Failed:%b\n" "$FAILED_TESTS"
+  exit 1
+fi
+exit 0

package/ds-canonical/hooks/tests/test_block_prototype_imports.sh

@@ -0,0 +1,143 @@
+#!/bin/bash
+# Tests for block_prototype_imports.py
+#
+# This hook is PostToolUse — reads files from disk via os.path.exists, so we
+# create real temp files inside src/ tree to drive each scenario.
+#
+# Usage: bash test_block_prototype_imports.sh
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../block_prototype_imports.py"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+if [ ! -f "$HOOK" ]; then
+  echo "FATAL: hook not found: $HOOK"
+  exit 1
+fi
+
+PASS=0
+FAIL=0
+FAILED_TESTS=""
+
+# Sandbox dir for temp files inside src/ (so should_check passes prefix gate)
+SANDBOX="$PROJECT_ROOT/src/.test-block-prototype-imports-$$"
+mkdir -p "$SANDBOX"
+trap 'rm -rf "$SANDBOX"' EXIT
+
+run_hook() {
+  local file_path="$1"
+  local payload
+  payload=$(jq -n --arg fp "$file_path" \
+    '{tool_name: "Write", tool_input: {file_path: $fp}}')
+
+  STDOUT=$(mktemp)
+  STDERR=$(mktemp)
+  set +e
+  printf '%s' "$payload" | python3 "$HOOK" >"$STDOUT" 2>"$STDERR"
+  EXIT=$?
+  set -e
+  STDOUT_TEXT=$(cat "$STDOUT")
+  STDERR_TEXT=$(cat "$STDERR")
+  rm -f "$STDOUT" "$STDERR"
+}
+
+expect_pass() {
+  local name="$1"
+  if [ "$EXIT" = "0" ]; then
+    echo "  PASS  $name"
+    PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected exit 0, got $EXIT)"
+    echo "$STDOUT_TEXT" | sed 's/^/    /'
+    FAIL=$((FAIL+1))
+    FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+expect_block() {
+  local name="$1"
+  local needle="$2"
+  if [ "$EXIT" = "2" ]; then
+    if echo "$STDOUT_TEXT" | grep -qF "$needle"; then
+      echo "  PASS  $name"
+      PASS=$((PASS+1))
+    else
+      echo "  FAIL  $name (exit 2 OK but stdout missing '$needle')"
+      echo "$STDOUT_TEXT" | sed 's/^/    /'
+      FAIL=$((FAIL+1))
+      FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+    fi
+  else
+    echo "  FAIL  $name (expected exit 2, got $EXIT)"
+    echo "$STDOUT_TEXT" | sed 's/^/    /'
+    FAIL=$((FAIL+1))
+    FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+cd "$PROJECT_ROOT"
+
+# ── Test 1: clean import → pass ──────────────────────────────────────────────
+echo "Test 1: clean tsx with non-explorations import → pass"
+F1="$SANDBOX/clean.tsx"
+cat >"$F1" <<'EOF'
+import { Button } from '@/design-system/components/Button/button'
+export const X = () => <Button>OK</Button>
+EOF
+run_hook "${F1#$PROJECT_ROOT/}"
+expect_pass "Test 1 clean import"
+
+# ── Test 2: import from src/explorations → block ─────────────────────────────
+echo ""
+echo "Test 2: tsx imports from src/explorations/ → block"
+F2="$SANDBOX/violation.tsx"
+cat >"$F2" <<'EOF'
+import { ProtoX } from '@/explorations/foo/bar'
+import { Button } from '@/design-system/components/Button/button'
+export const X = () => <ProtoX />
+EOF
+run_hook "${F2#$PROJECT_ROOT/}"
+expect_block "Test 2 explorations import blocked" "Blocked"
+
+# ── Test 3: file inside src/explorations/ itself → exempt (pass) ──────────────
+echo ""
+echo "Test 3: file IN src/explorations/ importing from explorations → pass (allowed)"
+EXPL_DIR="$PROJECT_ROOT/src/explorations/.test-block-prototype-imports-$$"
+mkdir -p "$EXPL_DIR"
+F3="$EXPL_DIR/proto.tsx"
+cat >"$F3" <<'EOF'
+import { Other } from '@/explorations/other'
+export const Y = () => <Other />
+EOF
+run_hook "${F3#$PROJECT_ROOT/}"
+EXIT_CAPTURED=$EXIT
+rm -rf "$EXPL_DIR"
+EXIT=$EXIT_CAPTURED
+expect_pass "Test 3 explorations file is exempt"
+
+# ── Test 4: non-tsx file (md) → pass ─────────────────────────────────────────
+echo ""
+echo "Test 4: .md file (out of scope) → pass"
+F4="$SANDBOX/note.md"
+echo "import from src/explorations/foo (just text)" >"$F4"
+run_hook "${F4#$PROJECT_ROOT/}"
+expect_pass "Test 4 non-tsx out of scope"
+
+# ── Test 5: nonexistent path → pass (silently skip) ──────────────────────────
+echo ""
+echo "Test 5: nonexistent path → pass (silently skip)"
+run_hook "src/does-not-exist-$$.tsx"
+expect_pass "Test 5 nonexistent path"
+
+# ── Summary ──────────────────────────────────────────────────────────────────
+echo ""
+echo "════════════════════════════════════════"
+echo "  Results: $PASS PASS, $FAIL FAIL"
+echo "════════════════════════════════════════"
+if [ "$FAIL" -gt 0 ]; then
+  printf "Failed tests:%b\n" "$FAILED_TESTS"
+  exit 1
+fi
+exit 0

package/ds-canonical/hooks/tests/test_check_addon_subdir_ship.sh

@@ -0,0 +1,171 @@
+#!/bin/bash
+# 2026-06-11 repoint:check_addon_subdir_ship.sh 已合併進 check_storybook_addon_packaging.sh(prune merge;測試 payload 不變 = 行為等價驗證)
+# Tests for check_storybook_addon_packaging.sh(P0 BLOCKER,2026-05-28 beta.27 anchor)
+#
+# Hook 規則(PreToolUse,Edit / Write / MultiEdit):
+#   Scope: file_path 命中 /(\.storybook|storybook-config)/addons/<addonName>/<MainFile>.(ts|tsx)$
+#          (addon 主檔。子資料夾檔 utils/x.ts / *.stories.tsx 等不在 scope)
+#   Reads: tool_input.new_string // tool_input.content (CONTENT)
+#   BLOCKER(exit 2 + stderr "ADDON SUBDIR SHIP BLOCKER"):
+#          CONTENT 含 `from './<subdir>/...'` relative-subdir import,
+#          但 dirname(file_path)/<subdir> 在真實檔案系統不存在 → block + cite missing dir。
+#   Escape: CONTENT 含 `@addon-subdir-skip:` → silent。
+#   Non-block(silent exit 0):
+#          - 非 Edit/Write/MultiEdit tool
+#          - 非 addon 主檔 path
+#          - import 的 subdir 真的存在(correctly shipped)
+#          - 只 same-dir import(`from './constants'` 無 subdir 段)
+#
+# IMPORTANT: hook 對 dirname(file_path)/<subdir> 做真實 filesystem `[ -d ]` 檢查,
+# 因此本 test 把 file_path 指到 TMP_DIR 內真實建立的 addon 結構,藉建/不建 subdir
+# 控制 missing-vs-shipped。
+
+set -u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK="$SCRIPT_DIR/../check_storybook_addon_packaging.sh"
+
+if [ ! -x "$HOOK" ]; then
+  echo "FATAL: hook not executable: $HOOK"
+  exit 1
+fi
+
+PASS=0
+FAIL=0
+FAILED_TESTS=""
+
+TMP_DIR=$(mktemp -d)
+trap 'rm -rf "$TMP_DIR"' EXIT
+
+# Real addon dir on disk(hook 用 [ -d ] 查真實 path)。
+# addon 主檔住這:$ADDON/<MainFile>.ts ;子資料夾依 case 建或不建。
+ADDON="$TMP_DIR/packages/storybook-config/addons/ds-devmode"
+mkdir -p "$ADDON"
+PREVIEW="$ADDON/preview.ts"
+MANAGER="$ADDON/manager.tsx"
+
+run_hook() {
+  # $1=file_path  $2=content  $3=tool_name(default Write)  $4=content_field(default content)
+  local file_path="$1"; local content="$2"
+  local tool="${3:-Write}"; local field="${4:-content}"
+  local payload
+  if [ "$field" = "new_string" ]; then
+    payload=$(jq -n --arg fp "$file_path" --arg c "$content" --arg t "$tool" \
+      '{hook_event_name:"PreToolUse", tool_name:$t, tool_input:{file_path:$fp, new_string:$c}}')
+  else
+    payload=$(jq -n --arg fp "$file_path" --arg c "$content" --arg t "$tool" \
+      '{hook_event_name:"PreToolUse", tool_name:$t, tool_input:{file_path:$fp, content:$c}}')
+  fi
+  STDOUT=$(mktemp); STDERR=$(mktemp)
+  set +e
+  printf '%s' "$payload" | bash "$HOOK" >"$STDOUT" 2>"$STDERR"
+  EXIT=$?
+  set -e
+  STDERR_TEXT=$(cat "$STDERR" 2>/dev/null)
+  rm -f "$STDOUT" "$STDERR"
+}
+
+expect_pass_silent() {
+  local name="$1"
+  if [ "$EXIT" = "0" ] && [ -z "$STDERR_TEXT" ]; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected silent, exit=$EXIT, stderr=$([ -n "$STDERR_TEXT" ] && echo non-empty || echo empty))"
+    echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+expect_block() {
+  local name="$1"; local needle="$2"
+  if [ "$EXIT" = "2" ] && echo "$STDERR_TEXT" | grep -qF "$needle"; then
+    echo "  PASS  $name"; PASS=$((PASS+1))
+  else
+    echo "  FAIL  $name (expected BLOCK exit=2 + '$needle', got exit=$EXIT)"
+    echo "  --- stderr ---"; echo "$STDERR_TEXT" | sed 's/^/    /'; echo "  --- end ---"
+    FAIL=$((FAIL+1)); FAILED_TESTS="${FAILED_TESTS}\n  - $name"
+  fi
+}
+
+NEEDLE="ADDON SUBDIR SHIP BLOCKER"
+
+echo "=== check_addon_subdir_ship tests ==="
+
+# ─────────────────────────────────────────────────────────────────────
+# POSITIVE cases — SHOULD trigger the BLOCKER (exit 2)
+# ─────────────────────────────────────────────────────────────────────
+
+# P1. addon 主檔 import 從 ./utils/* 但 utils/ dir 不存在 → BLOCK
+#     (真 beta.27 anchor:ds-devmode 搬家漏帶 utils/ 6 files)
+rm -rf "$ADDON/utils"
+run_hook "$PREVIEW" "import { measure } from './utils/dom-geometry';
+export const decorators = [];"
+expect_block "P1. import ./utils/* but utils/ absent → BLOCK" "$NEEDLE"
+
+# P2. manager.tsx import 從 ./components/* 但 components/ 不存在 → BLOCK
+#     (probe over-NARROW: hook 不該只認 utils/ 一個固定名;任意缺漏 subdir 都要抓)
+rm -rf "$ADDON/components"
+run_hook "$MANAGER" "import { Panel } from './components/Panel';
+addons.register('ds-devmode', () => {});"
+expect_block "P2. import ./components/* (non-utils name) but absent → BLOCK [M34 over-narrow guard]" "$NEEDLE"
+
+# P3. content via new_string field(Edit / MultiEdit 用 new_string 而非 content)→ BLOCK
+rm -rf "$ADDON/utils"
+run_hook "$PREVIEW" "import { drift } from './utils/token-drift-detector';" "Edit" "new_string"
+expect_block "P3. Edit tool via new_string, missing subdir → BLOCK" "$NEEDLE"
+
+# ─────────────────────────────────────────────────────────────────────
+# NEGATIVE cases — SHOULD stay silent (exit 0)
+# ─────────────────────────────────────────────────────────────────────
+
+# N1. utils/ dir 真實存在(correctly shipped)→ silent
+#     [M34 over-broad guard:子 dir 有一起 ship 時不可 false-positive block]
+mkdir -p "$ADDON/utils"
+: > "$ADDON/utils/dom-geometry.ts"
+run_hook "$PREVIEW" "import { measure } from './utils/dom-geometry';
+export const decorators = [];"
+expect_pass_silent "N1. import ./utils/* AND utils/ shipped → silent [M34 over-broad guard]"
+
+# N2. 只 same-dir import(`from './constants'` 無第二層 subdir 段)→ silent
+#     (near-miss:./constants 是同層檔不是子資料夾,不該被當 subdir import 誤抓)
+run_hook "$PREVIEW" "import { ADDON_ID } from './constants';
+import { PANEL_ID } from './constants';"
+expect_pass_silent "N2. same-dir './constants' import (no subdir) → silent [near-miss]"
+
+# N3. @addon-subdir-skip escape comment present(即使 subdir 缺)→ silent
+rm -rf "$ADDON/utils"
+run_hook "$PREVIEW" "// @addon-subdir-skip: utils intentionally resolved via tsconfig paths
+import { measure } from './utils/dom-geometry';"
+expect_pass_silent "N3. @addon-subdir-skip escape + missing subdir → silent"
+
+# N4. 非 addon 主檔 path(DS component tsx)→ out of scope → silent
+#     (near-miss:同樣有 ./utils/* 缺漏 import,但 path 不在 addons/ scope)
+DS_TSX="$TMP_DIR/packages/design-system/src/components/Foo/Foo.tsx"
+mkdir -p "$(dirname "$DS_TSX")"
+run_hook "$DS_TSX" "import { x } from './utils/helper';"
+expect_pass_silent "N4. non-addon path (DS component) → out of scope → silent [near-miss]"
+
+# N5. addon 子資料夾檔本身(utils/x.ts,非主檔)→ regex 要求主檔在 addonName 同層,
+#     子層檔不命中 [^/]+/<Main>\.ts$ → out of scope → silent
+SUBFILE="$ADDON/utils/dom-geometry.ts"
+mkdir -p "$(dirname "$SUBFILE")"
+run_hook "$SUBFILE" "import { y } from './sub/missing';"
+expect_pass_silent "N5. addon subdir file (not main file) → out of scope → silent [near-miss]"
+
+# N6. 非 Edit/Write/MultiEdit tool(Read)→ silent
+run_hook "$PREVIEW" "import { measure } from './utils/dom-geometry';" "Read"
+expect_pass_silent "N6. tool=Read → skip → silent"
+
+# N7. addon 主檔但只 package import(無 relative subdir)→ silent
+run_hook "$PREVIEW" "import React from 'react';
+import { addons } from '@storybook/manager-api';"
+expect_pass_silent "N7. only package imports, no relative subdir → silent"
+
+echo ""
+echo "=== Summary ==="
+echo "Passed: $PASS / $((PASS + FAIL))"
+if [ "$FAIL" -gt 0 ]; then
+  printf "Failed:%b\n" "$FAILED_TESTS"
+  exit 1
+fi
+exit 0