ksk-design-system 1.63.1 → 1.65.0

package/README.md

@@ -119,9 +119,11 @@ import { Button, Card, Input, FormField } from "ksk-design-system"
 | `Button` | `type` 既定 `"button"` / disabled・aria-disabled クリックの抑止 / `haptic` / `asChild` | `inline-flex` `items-center` `justify-center` `gap-*` `whitespace-nowrap` `typo-*` `cursor-pointer` と variant・size・layout の全クラス |
 | `Input` | `showCount`（IME 追従）/ adornment の配置土台 | `h-*` `w-full` `border-*` `bg-*` `px-*` `typo-*` `placeholder:*` |
 | `Textarea` | `autoGrow` / `showCount` | `min-h-*` `w-full` `border-*` `bg-*` `px-*` `py-*` `typo-*` `placeholder:*` |
+| `Label` | Radix Label の挙動（クリックで対象コントロールへフォーカス移動） | `typo-label-md` `text-[var(--Text-High-Emphasis)]` `peer-disabled:cursor-not-allowed` `peer-disabled:opacity-50` |
 
-キーボード操作時の `focus-visible` リングだけは a11y のため既定で残ります。手書き CSS が
-自前のフォーカス表現を持つ場合は `className="focus-visible:ring-0"` で消せます。
+キーボード操作時の `focus-visible` リングだけは a11y のため既定で残ります（`Label` は
+フォーカス可能要素ではないため対象外）。手書き CSS が自前のフォーカス表現を持つ場合は
+`className="focus-visible:ring-0"` で消せます。
 
 移行の順番は次のとおりです。
 
@@ -198,8 +200,34 @@ const BRAND = "#06C755"
 - 先頭 12 行に自動生成マーカー（`AUTO-GENERATED` / `DO NOT EDIT` / `自動生成` 等）を持つ
   ファイルは全ルールを skip します。直す先は生成物ではなく生成元です。
 - DS 自身のトークン定義 CSS（`src/styles/*.css` / `src/themes/*.css` / `src/preset.css` と、
-  それを再梱包したベンダリングコピー）は P049 の対象外です。トークンを**定義**している側で
-  あって、consumer による上書きではないためです。
+  それを再梱包したベンダリングコピー）は P049 / P050 の対象外です。トークンを**定義**している側で
+  あって、consumer による上書き・並行実装ではないためです。
+
+#### P050: DS を参照しない並行パレットの検出（issue #393）
+
+P049 は「DS の名前空間の変数（`--Primitive-Brand-500` 等）に触れている CSS」しか見ないため、DS を
+一切使わない独自パレット（`--bg` / `--accent` / `--surface` 等）を持つ consumer には
+無言でした。P050 は `:root` / `.dark` / `[data-theme=...]` のようなルート的セレクタの中で、
+DS 名前空間に属さないカスタムプロパティへ色値（`#hex` / `rgb()` / `hsl()` / `oklch()`）を
+<!-- docs-drift-ignore: --Primitive- -->
+5 個以上定義していたら「並行パレットの疑い」を warn します。値が `var(--Primitive-...)` の
+ように DS トークンを参照しているだけのものはカウントしません。意図的な独立パレット
+（LINE 風チャット画面のライトなど）は `// ksk-ds-lint-ignore P050 -- 理由` で抑制できます。
+
+#### ルールごとの除外（rules.json の excludes 系）
+
+`contracts/rules.json` の除外指定は、当てる対象ごとに 3 つに分かれています。
+
+| フィールド | 当てる対象 | 効く範囲 |
+|---|---|---|
+| `excludePaths` | ファイルパス | 全リポジトリ（`.stories.` 等） |
+| `excludeDsPaths` | ファイルパス | **DS パッケージ配下のファイルだけ**（`components/ui/` 等） |
+| `excludeLines` | 行の内容 | 全リポジトリ（`data-slot` / `asChild` 等） |
+
+`excludeDsPaths` は「DS 自身の実装だから生タグを書いてよい」という意味の除外なので、
+consumer が shadcn 既定の `src/components/ui/` に部品を置いても中核ルールは無効化されません
+（v1.63.x までは単一の `excludes` をパスと行内容の両方に OR で当てていたため、
+このディレクトリ名だけで 13 ルールが同時に黙っていました）。
 
 ### Jest（CommonJS）でコンポーネントをテストする
 
@@ -275,6 +303,14 @@ npx ksk-ds check-duplicates ./src --strict
 
 既定は助言モードで終了コード 0、`--strict` は重複候補があると終了コード 1 です。正本は同梱の `contracts/components.json` であり、consumer 側に別の「昇格候補台帳」を作らないでください。
 
+DS を import して委譲するだけの薄いラッパー（段階移行の型）は、DS と同名でも重複報告から除外され、`ℹ ラッパー（DS 委譲済み）として除外` として件数のみ表示されます。
+
+<!-- docs-drift-ignore: PrimaryButton AppTextInput BottomSheet CandidateOverflowMenu CrisisBanner AvatarView -->
+さらに、`contracts/components.json` と完全一致しない名前でも、DS 部品を連想させる命名パターン（`PrimaryButton` → `Button` / `AppTextInput` → `Input` / `BottomSheet` → `Sheet` / `CandidateOverflowMenu` → `DropdownMenu` / `CrisisBanner` → `Banner` / `AvatarView` → `Avatar` 等）は「重複の疑い」として `⚠` 付きで warn 表示されます。これは名前一致のみによる推測（AST は使いません）のため確度は下がり、`--strict` でも exit code には影響しません。誤検知の場合は無視して構いませんが、恒常的に抑制したい場合はそのファイル内のコメントに `ksk-ds-local-fallback` を含めてください。
+
+<!-- docs-drift-ignore: CandidateOverflowMenu -->
+ただし、ファイルが `ksk-design-system`（`/native` 等のサブパス含む）から named import し、その import した識別子を JSX またはコールとして実際に使っている場合は、名前が DS と異なっていても「DS 委譲ラッパー」とみなし疑い検出の対象から除外します（例: `CandidateOverflowMenu` が `DropdownMenu` を import して `<DropdownMenu>` として使うケース）。DS を import しているだけで実際には使っていない場合はこの除外の対象外です。
+
 ### Media overlay utilities
 
 動画・写真の上に文字や操作を置く場合は、`--Text-on-Media` と `.text-on-media` / `.text-on-media-secondary`、上下の `.media-scrim-top` / `.media-scrim-bottom` を使います。TikTok / Reels 型の操作群は `MediaActionCluster` が glass ボタン、ラベル、safe-area anchor、idle auto-hide をまとめて扱います。

package/bin/check-duplicates.js

@@ -43,8 +43,13 @@ export function runCheckDuplicatesCli(
   const wrapperExclusions = results
     .flatMap((result) => result.wrapperExclusions)
     .sort((a, b) => a.file.localeCompare(b.file) || a.name.localeCompare(b.name))
+  const suspicions = results
+    .flatMap((result) => result.suspicions)
+    .sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.name.localeCompare(b.name))
 
-  printFindings(findings, wrapperExclusions, files.length, options.strict)
+  printFindings(findings, wrapperExclusions, suspicions, files.length, options.strict)
+  // suspicions は名前ヒューリスティックによる warn 止まりの「疑い」であり、
+  // --strict でも exit code には影響させない（issue #392 取りこぼし側）。
   return options.strict && findings.length > 0 ? 1 : 0
 }
 
@@ -169,6 +174,34 @@ function collectDsImportSourceNames(source) {
   return names
 }
 
+// このファイルが ksk-design-system から named import している要素の
+// ローカル名（alias 込み）の集合。DS 委譲ラッパー判定（実使用チェック）に使う。
+function collectDsImportLocalNames(source) {
+  const names = new Set()
+  const importPattern = /import\s*\{([^}]*)\}\s*from\s*["']([^"']+)["']/g
+
+  for (const match of source.matchAll(importPattern)) {
+    const [, specifierList, moduleSpecifier] = match
+    if (!isDsModuleSpecifier(moduleSpecifier)) continue
+    for (const { localName } of parseSpecifierList(specifierList)) {
+      names.add(localName)
+    }
+  }
+
+  return names
+}
+
+// import した DS のローカル名が、JSX（`<Name`）または関数呼び出し（`Name(`）として
+// 実際に使われているか。import しているだけで使っていないケース（不要 import 等）は
+// 「実際に委譲している」とは言えないため対象外にする。
+function usesAnyIdentifierAsJsxOrCall(source, localNames) {
+  for (const localName of localNames) {
+    const usagePattern = new RegExp(`<${localName}[\\s/>]|\\b${localName}\\s*\\(`)
+    if (usagePattern.test(source)) return true
+  }
+  return false
+}
+
 // `export { X as Y } from 'ksk-design-system/...'` のような re-export 形式。
 // これは常に DS の実装をそのまま右から左へ渡すだけなので、localName が
 // registry と一致する場合は無条件でラッパー（除外対象）として扱う。
@@ -187,16 +220,68 @@ function collectDsReExports(source) {
   return reExports
 }
 
+// issue #392 取りこぼし側: 名前が違う真の重複（改名された DS 相当の自前実装）を
+// AST を使わず名前ヒューリスティックで拾う。確度が下がるため error にはせず warn
+// （「疑い」）止まりとし、--strict でも exit code は変えない。
+//
+// キーワードは接尾辞（PrimaryButton・AppTextInput 等の前置修飾パターン）と
+// 接頭辞（AvatarView 等、DS 部品名 + 汎用語のパターン）の両方で判定する。
+const NAME_HEURISTIC_MAP = {
+  Button: "Button",
+  TextInput: "Input",
+  Input: "Input",
+  Sheet: "Sheet",
+  Modal: "Dialog",
+  Menu: "DropdownMenu",
+  Banner: "Banner",
+  Alert: "Alert",
+  Avatar: "Avatar",
+  // Card は除外: ドメインカード（PropertyCard 等）が正当に多く、ノイズ源になる
+  Chip: "Chip",
+  Badge: "Badge",
+  Toast: "Toast",
+  Tooltip: "Tooltip",
+  Dialog: "Dialog",
+}
+const NAME_HEURISTIC_KEYWORDS = Object.keys(NAME_HEURISTIC_MAP).sort((a, b) => b.length - a.length)
+// 接頭辞パターンで許容する汎用語（残り部分がこれらに完全一致する場合のみ疑いとする）。
+// 無制限に許可すると「AvatarUploadFlow」のような無関係な名前まで拾ってしまうため絞る。
+const GENERIC_NAME_SUFFIXES = new Set(["View", "Component", "Element", "Widget", "Item", "Base", "Wrapper"])
+// 抑制マーカー: このコメントを含むファイルは「疑い」報告の対象から除外する
+// （contracts/rules.json 等の既存の一時実装ルールに合わせた運用）。
+const SUPPRESSION_MARKER = "ksk-ds-local-fallback"
+
+function suggestDsNameForLocalName(name) {
+  for (const keyword of NAME_HEURISTIC_KEYWORDS) {
+    if (name.length > keyword.length && name.endsWith(keyword)) {
+      return NAME_HEURISTIC_MAP[keyword]
+    }
+  }
+  for (const keyword of NAME_HEURISTIC_KEYWORDS) {
+    if (name.length > keyword.length && name.startsWith(keyword)) {
+      const remainder = name.slice(keyword.length)
+      if (GENERIC_NAME_SUFFIXES.has(remainder)) return NAME_HEURISTIC_MAP[keyword]
+    }
+  }
+  return null
+}
+
 function findDuplicateExports(file, cwd, registry) {
   const source = readFileSync(file, "utf8")
   const lines = source.split(/\r?\n/)
   const findings = []
   const wrapperExclusions = []
+  const suspicions = []
   const relFile = normalize(relative(cwd, file))
+  const suppressSuspicions = source.includes(SUPPRESSION_MARKER)
 
   const codeForImportScan = stripComments(source)
   const dsImportSourceNames = collectDsImportSourceNames(codeForImportScan)
+  const dsImportLocalNames = collectDsImportLocalNames(codeForImportScan)
   const dsReExportLocalNames = collectDsReExports(codeForImportScan)
+  // issue #451: 名前が DS と違っても、DS を import してそれを JSX/関数呼び出しで
+  // 実際に使っていれば「DS 委譲ラッパー」とみなし、名前ヒューリスティックの疑い対象から除外する。
+  const isDsDelegatingWrapper = usesAnyIdentifierAsJsxOrCall(codeForImportScan, dsImportLocalNames)
 
   const declarationPattern =
     /^\s*export\s+(?:default\s+)?(?:(?:async|declare)\s+)?(?:function|const)\s+([A-Z][A-Za-z0-9]*)\b/
@@ -206,7 +291,24 @@ function findDuplicateExports(file, cwd, registry) {
     if (!match) continue
     const name = match[1]
     const components = registry.get(name)
-    if (!components) continue
+
+    if (!components) {
+      // 完全一致は無いが、名前が DS 部品を連想させるパターン（issue #392 取りこぼし側）。
+      // DS を import しているファイル（何らかの形で DS を使っている＝別部品のラッパー等）
+      // でも疑いは出す。抑制は SUPPRESSION_MARKER コメントのみ。
+      if (suppressSuspicions) continue
+      if (isDsDelegatingWrapper) continue
+      const suggested = suggestDsNameForLocalName(name)
+      if (!suggested) continue
+      suspicions.push({
+        file: relFile,
+        line: index + 1,
+        name,
+        suggested,
+        suggestedComponents: registry.get(suggested) ?? null,
+      })
+      continue
+    }
 
     // 同名のローカル宣言があっても、同ファイルが ksk-design-system から同名（元の
     // export 名基準。ローカル alias は問わない）を import して使っているなら、
@@ -231,10 +333,10 @@ function findDuplicateExports(file, cwd, registry) {
     wrapperExclusions.push({ file: relFile, name: localName })
   }
 
-  return { findings, wrapperExclusions }
+  return { findings, wrapperExclusions, suspicions }
 }
 
-function printFindings(findings, wrapperExclusions, scannedFiles, strict) {
+function printFindings(findings, wrapperExclusions, suspicions, scannedFiles, strict) {
   if (findings.length === 0) {
     console.log(`ksk-ds check-duplicates: 重複候補はありません（${scannedFiles} files）`)
   } else {
@@ -260,6 +362,21 @@ function printFindings(findings, wrapperExclusions, scannedFiles, strict) {
       console.log(`  ℹ ラッパー（DS 委譲済み）として除外: ${wrapper.name} (${wrapper.file})`)
     }
   }
+
+  if (suspicions.length > 0) {
+    console.log(`\n⚠ 重複の疑い（名前ヒューリスティック・要確認）: ${suspicions.length} 件`)
+    for (const suspicion of suspicions) {
+      const dsPathHint = suspicion.suggestedComponents
+        ? ` (DS: ${suspicion.suggestedComponents.map((component) => component.path).join(", ")})`
+        : ""
+      console.log(
+        `  ⚠ ${suspicion.file}:${suspicion.line} ${suspicion.name} は DS の ${suspicion.suggested} で置換できる可能性があります${dsPathHint}`,
+      )
+    }
+    console.log(
+      "  ※ 名前一致のみによる推測（warn）です。誤検知の場合は無視して問題ありません。抑制するには実装コメントに `ksk-ds-local-fallback` を含めてください。",
+    )
+  }
 }
 
 function printHelp() {
@@ -278,6 +395,12 @@ DIR の既定値:
   ただし、同ファイルが ksk-design-system から同名（alias 可）を import/re-export して
   使っているものは DS 委譲ラッパーとみなし、重複報告から除外します（info 行で件数報告）。
   既定は助言モード（常に exit 0）、--strict は検出時 exit 1 です。
+
+  完全一致しない名前でも、DS 部品を連想させる命名パターン
+  （PrimaryButton → Button・AppTextInput → Input・BottomSheet → Sheet・
+  CandidateOverflowMenu → DropdownMenu・CrisisBanner → Banner・AvatarView → Avatar 等）は
+  「重複の疑い」として warn 表示します（--strict でも exit code には影響しません）。
+  抑制するにはファイル内のコメントに \`ksk-ds-local-fallback\` を含めてください。
 `)
 }
 

package/bin/lint.js

@@ -1,7 +1,11 @@
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs"
-import { basename, extname, join, relative, resolve } from "node:path"
+import { basename, extname, isAbsolute, join, relative, resolve } from "node:path"
 import { spawnSync } from "node:child_process"
-import { inspectProductThemeOverrides, loadProductThemeContract } from "./product-theme-override.js"
+import {
+  inspectParallelPaletteCandidates,
+  inspectProductThemeOverrides,
+  loadProductThemeContract,
+} from "./product-theme-override.js"
 
 // card-child-spacing.js は `import ts from "typescript"` している（P046 専用エンジン）。
 // typescript は 24MB 前後あり、59ルール中 P046 の1つにしか使わないため、
@@ -354,9 +358,13 @@ export async function runLintCli(argv, { cwd = process.cwd(), pkgRoot = resolve(
     return 1
   }
 
+  // CSS 専用エンジン一覧。P049（product-theme-override）と P050（parallel-palette、
+  // issue #393）はどちらも .css だけを対象にした独自エンジンで、TSX 向けの
+  // 正規表現エンジンとは別の走査経路（lintCssFile）を通す。
+  const CSS_ENGINES = new Set(["product-theme-override", "parallel-palette"])
   const rules = loadRules(rulesPath)
-  const cssRules = rules.filter((rule) => rule.engine === "product-theme-override")
-  let sourceRules = rules.filter((rule) => rule.engine !== "product-theme-override")
+  const cssRules = rules.filter((rule) => CSS_ENGINES.has(rule.engine))
+  let sourceRules = rules.filter((rule) => !CSS_ENGINES.has(rule.engine))
   const productThemeContract = cssRules.length > 0 ? readProductThemeContract(pkgRoot) : null
   // DS 自身 / ベンダリングされた DS の CSS を P049 の対象から外すための材料（issue #407）
   const dsCssIdentity = cssRules.length > 0 ? collectDsCssIdentity(pkgRoot) : null
@@ -393,12 +401,19 @@ export async function runLintCli(argv, { cwd = process.cwd(), pkgRoot = resolve(
       continue
     }
     if (CSS_EXTENSIONS.has(extname(file))) {
-      if (productThemeContract) {
-        findings.push(...lintCssFile(file, cwd, cssRules, productThemeContract, dsCssIdentity))
+      // productThemeContract が読めない環境（contracts/product-theme-overrides.json
+      // が無い）でも P050 は動かせるので、CSS ルールが 1 件でもあれば走査する
+      // （P049 側は contract が null なら lintCssFile 内で個別に skip する）。
+      if (cssRules.length > 0) {
+        findings.push(
+          ...lintCssFile(file, cwd, cssRules, productThemeContract, dsCssIdentity, pkgRoot),
+        )
       }
       continue
     }
-    findings.push(...lintFile(file, cwd, sourceRules, { ...options, inspectCardChildSpacing }))
+    findings.push(
+      ...lintFile(file, cwd, sourceRules, { ...options, inspectCardChildSpacing, pkgRoot }),
+    )
   }
 
   const summary = summarize(findings)
@@ -645,11 +660,12 @@ function readProductThemeContract(pkgRoot) {
 }
 
 /**
- * CSS ファイルには product theme の許可リスト検査（P049）だけを当てる。
- * TSX 向けの正規表現ルールを CSS に流すと誤検知しかしない。
+ * CSS ファイルには P049（product theme の許可リスト検査）と P050（並行パレット検出、
+ * issue #393）だけを当てる。TSX 向けの正規表現ルールを CSS に流すと誤検知しかしない。
  */
-function lintCssFile(file, cwd, cssRules, contract, dsCssIdentity = null) {
+function lintCssFile(file, cwd, cssRules, contract, dsCssIdentity = null, pkgRoot = null) {
   const rel = normalize(relative(cwd, file))
+  const isDsFile = isDsPackageFile(file, pkgRoot)
   const source = readFileSync(file, "utf8")
   // 自動生成 CSS（source-safelist.css 等）は生成元を直すべきなので全ルール skip（issue #408）
   if (isAutoGeneratedSource(source)) return []
@@ -663,10 +679,36 @@ function lintCssFile(file, cwd, cssRules, contract, dsCssIdentity = null) {
   findings.push(...ignores.problems)
   for (const rule of cssRules) {
     // CSS は web のみに存在する（RN に .css は無い）。glob 指定の appliesTo は
-    // capability タグを含まないので、この判定でも従来どおり P049 が当たる。
+    // capability タグを含まないので、この判定でも従来どおり P049/P050 が当たる。
     if (!ruleAppliesTo(rule, { capabilities: CSS_CAPABILITIES, filePath: rel })) continue
+
+    if (rule.engine === "parallel-palette") {
+      // contract が読めない（DS の名前空間一覧が無い）と何が DS 名前空間かを
+      // 判定できず false positive しか出せないので、その場合は skip する。
+      if (!contract) continue
+      const threshold = typeof rule.minColorVars === "number" ? rule.minColorVars : 5
+      const candidates = inspectParallelPaletteCandidates(source, { namespaces: contract.namespaces })
+      if (candidates.length < threshold) continue
+      const first = candidates[0]
+      if (matchesRuleExclude(rule, { file: rel, line: first.name, isDsFile })) continue
+      if (ignores.suppresses(rule.id ?? "UNKNOWN", first.line)) continue
+      const names = candidates.slice(0, 5).map((c) => c.name).join(", ")
+      const suffix = candidates.length > 5 ? ` ほか計${candidates.length}個` : `（計${candidates.length}個）`
+      findings.push({
+        ...toFinding(rule, rel, first.line, "web"),
+        message: `${rule.message ?? "DS を参照しない並行パレットの疑い"}: ${names}${suffix}`,
+      })
+      continue
+    }
+
+    // contract が読めない環境（contracts/product-theme-overrides.json が無い）では
+    // P049 の許可リスト判定ができないので skip する（従来は呼び出し元で丸ごと
+    // skip していたのと同じ挙動を、CSS ルール単位に落とし込んだだけ）。
+    if (!contract) continue
     for (const violation of inspectProductThemeOverrides(source, contract)) {
-      if (matchesRuleExclude(rule, rel, violation.name)) continue
+      // violation.name は CSS 変数名（＝内容）なので line 側に渡す。
+      // パス除外を変数名に当ててはいけない（issue #404 の提案 c）。
+      if (matchesRuleExclude(rule, { file: rel, line: violation.name, isDsFile })) continue
       if (ignores.suppresses(rule.id ?? "UNKNOWN", violation.line)) continue
       findings.push({
         ...toFinding(rule, rel, violation.line, "web"),
@@ -679,6 +721,7 @@ function lintCssFile(file, cwd, cssRules, contract, dsCssIdentity = null) {
 
 function lintFile(file, cwd, rules, options = {}) {
   const rel = normalize(relative(cwd, file))
+  const isDsFile = isDsPackageFile(file, options.pkgRoot)
   const source = readFileSync(file, "utf8")
   // 自動生成物（src/tokens/native/themes.ts 等）は hex をそこにしか書けない。
   // 直す先は生成物ではなく生成元なので、全ルールを skip する（issue #408）。
@@ -710,7 +753,7 @@ function lintFile(file, cwd, rules, options = {}) {
       for (const finding of options.inspectCardChildSpacing(source, file)) {
         const line = lines[finding.line - 1] ?? ""
         if (ignores.suppresses(rule.id ?? "UNKNOWN", finding.line)) continue
-        if (!matchesRuleExclude(rule, rel, line)) {
+        if (!matchesRuleExclude(rule, { file: rel, line, isDsFile })) {
           findings.push(toFinding(rule, rel, finding.line, platform))
         }
       }
@@ -735,7 +778,7 @@ function lintFile(file, cwd, rules, options = {}) {
         // excludes（ksk-ds-allow-* 等）はコメントに書かれることが多いため、
         // 判定は常にマスク前の生の行に対して行う。
         const rawLine = lines[lineNumber - 1] ?? ""
-        if (matchesRuleExclude(rule, rel, rawLine)) continue
+        if (matchesRuleExclude(rule, { file: rel, line: rawLine, isDsFile })) continue
         if (ignores.suppresses(rule.id ?? "UNKNOWN", lineNumber)) continue
         findings.push(toFinding(rule, rel, lineNumber, platform))
       }
@@ -743,7 +786,7 @@ function lintFile(file, cwd, rules, options = {}) {
     }
     for (let index = 0; index < lines.length; index++) {
       const rawLine = lines[index]
-      if (matchesRuleExclude(rule, rel, rawLine)) continue
+      if (matchesRuleExclude(rule, { file: rel, line: rawLine, isDsFile })) continue
       const maskedLine = maskedLines[index] ?? ""
       if (!regex.test(maskedLine)) continue
       if (ignores.suppresses(rule.id ?? "UNKNOWN", index + 1)) continue
@@ -1076,9 +1119,47 @@ function maskTemplateLiterals(source) {
   return maskStrings(source, TEMPLATE_DELIMITER_ONLY)
 }
 
-function matchesRuleExclude(rule, file, line) {
-  const excludes = Array.isArray(rule.excludes) ? rule.excludes : []
-  return excludes.some((exclude) => file.includes(exclude) || line.includes(exclude))
+function excludeList(value) {
+  return Array.isArray(value) ? value : []
+}
+
+/**
+ * このファイルは DS パッケージ本体の中にあるか（issue #404）。
+ *
+ * `excludeDsPaths`（`components/ui/` 等）は「DS 自身の実装なので生タグを書いてよい」
+ * という意味の除外なので、consumer が同名ディレクトリ（shadcn 既定の
+ * `src/components/ui/`）を持っているだけで効いてはいけない。judgement は
+ * 走査対象の実ファイルが DS パッケージ（pkgRoot）配下かどうかで行う。
+ */
+export function isDsPackageFile(absFile, pkgRoot) {
+  if (!pkgRoot || !absFile) return false
+  const rel = relative(resolve(pkgRoot), resolve(absFile))
+  return rel !== "" && !rel.startsWith("..") && !isAbsolute(rel)
+}
+
+/**
+ * ルール単位の除外判定（issue #404）。
+ *
+ * 除外語彙は用途ごとに 3 つに分かれている:
+ * - `excludePaths`   … ファイルパスに当てる。どのリポジトリでも効く（`.stories.` 等）
+ * - `excludeDsPaths` … ファイルパスに当てるが、**DS パッケージ配下のファイルにだけ**効く
+ *                      （`components/ui/` 等。consumer の同名ディレクトリでは効かない）
+ * - `excludeLines`   … 行の内容に当てる（`data-slot` / `asChild` / CSS 変数名 等）
+ *
+ * v1.62.x までは全部が単一の `excludes` に混在し `file.includes || line.includes` の
+ * OR で判定していたため、(1) 行内にパス文字列が出るだけでルールが黙り、
+ * (2) consumer が `src/components/ui/` に部品を置くと中核 13 ルールが丸ごと無効に
+ * なっていた。旧スキーマの `excludes` は後方互換のため従来の OR 判定で引き続き読む。
+ */
+function matchesRuleExclude(rule, { file, line = "", isDsFile = false }) {
+  if (excludeList(rule.excludePaths).some((exclude) => file.includes(exclude))) return true
+  if (isDsFile && excludeList(rule.excludeDsPaths).some((exclude) => file.includes(exclude))) {
+    return true
+  }
+  if (excludeList(rule.excludeLines).some((exclude) => line.includes(exclude))) return true
+  return excludeList(rule.excludes).some(
+    (exclude) => file.includes(exclude) || line.includes(exclude),
+  )
 }
 
 function shouldIgnorePath(relPath, options) {

package/bin/product-theme-override.js

@@ -102,6 +102,61 @@ export function inspectProductThemeOverrides(source, contract) {
   return findings
 }
 
+/**
+ * P050 — DS を参照しない並行パレットの検出（issue #393）
+ *
+ * P049 は「DS の名前空間に触れている CSS」しか見ないため、DS 名前空間を
+ * 一切使わない独自パレット（`--bg` / `--accent` / `--surface` 等）を持つ
+ * consumer には無言だった。`:root` / `.dark` / `[data-theme=...]` のような
+ * ルート的セレクタの中で、DS 名前空間に属さないカスタムプロパティへ
+ * 色値（hex / rgb / hsl / oklch）を敷いている数を数え、閾値以上なら
+ * 「並行パレットの疑い」として warn する。
+ *
+ * 値が `var(--Primitive-...)` のように DS トークンを参照しているだけの
+ * ものはカウントしない（それは並行パレットではなく DS への委譲）。
+ */
+
+/** ルート的セレクタ（ここで宣言された変数だけがテーマの「パレット」候補） */
+const ROOT_LIKE_BLOCK =
+  /(?:^|[};])\s*(:root|\.dark|\[data-theme(?:=[^\]]*)?\])\s*\{([^{}]*)\}/g
+
+/** ブロック内のカスタムプロパティ宣言（値も一緒に取る） */
+const DECLARATION_WITH_VALUE = /(^|[;{}\s])(--[A-Za-z0-9_-]+)\s*:\s*([^;]+);/g
+
+/** 色値を含む値（hex / rgb() / rgba() / hsl() / hsla() / oklch()） */
+const COLOR_VALUE_RE = /#[0-9a-fA-F]{3,8}\b|\brgba?\(|\bhsla?\(|\boklch\(/i
+
+/** 値が `var(...)` の参照だけで完結しているか（DS トークンへの委譲はカウントしない） */
+const VAR_ONLY_RE = /^var\(/i
+
+/**
+ * @param {string} source CSS ソース
+ * @param {{ namespaces?: string[] }} options DS 名前空間の一覧
+ * @returns {Array<{ line: number, name: string }>} DS 名前空間に属さず色値を持つ宣言
+ */
+export function inspectParallelPaletteCandidates(source, { namespaces = [] } = {}) {
+  const stripped = stripCssComments(source)
+  const candidates = []
+
+  for (const block of stripped.matchAll(ROOT_LIKE_BLOCK)) {
+    const body = block[2]
+    const bodyStart = block.index + block[0].indexOf(body)
+    for (const decl of body.matchAll(DECLARATION_WITH_VALUE)) {
+      const name = decl[2]
+      const value = decl[3].trim()
+      if (namespaces.some((prefix) => name.startsWith(prefix))) continue
+      if (VAR_ONLY_RE.test(value)) continue
+      if (!COLOR_VALUE_RE.test(value)) continue
+      const nameIndex = bodyStart + decl.index + decl[0].indexOf(name)
+      candidates.push({
+        line: stripped.slice(0, nameIndex).split(/\r?\n/).length,
+        name,
+      })
+    }
+  }
+  return candidates
+}
+
 /**
  * 契約 JSON から判定に使う形へ畳む。
  *

package/contracts/components.json

@@ -1,7 +1,7 @@
 {
   "meta": {
     "name": "KSK Design System — Component Contracts",
-    "version": "1.63.1",
+    "version": "1.65.0",
     "description": "全コンポーネントの構造化定義。バリアント・アクセシビリティ要件・使用ルールを機械可読形式で管理。",
     "counts": {
       "ui": 68,
@@ -77,6 +77,7 @@
         "リンクを Button として表示する場合は <Button asChild><a href=... /></Button> を使う",
         "Icon-only buttons require aria-label",
         "Native Button supports loading/loadingLabel and leadingIcon/trailingIcon; do not wrap ActivityIndicator in Text",
+        "Native Button supports spinnerColor to override the loading ActivityIndicator color; default unchanged (falls back to variant fg color, issue #450)",
         "variant=glass は背景がグラデーション/写真の場合のみ使用",
         "variant=glass-inverse は暗い写真・動画・濃色面上の Liquid Glass CTA 専用",
         "variant=inverse / ghost-inverse は暗背景・ヒーローセクション専用",
@@ -103,7 +104,8 @@
         "Must use <Input> not <input>",
         "showCount + maxLength で controlled / uncontrolled / IME 対応の文字数カウンタを表示",
         "showCount 未指定時は wrapper / counter DOM を追加しない",
-        "既存の手書き CSS を持つ画面の段階移行では unstyled を使う（showCount / adornment / IME 追従は維持される）"
+        "既存の手書き CSS を持つ画面の段階移行では unstyled を使う（showCount / adornment / IME 追従は維持される）",
+        "Native Input supports style (outer container View) and inputStyle (inner TextInput) as RN-idiomatic style overrides, merged after DS defaults (issue #447)"
       ]
     },
     {
@@ -211,7 +213,10 @@
       "rules": [
         "value/onChange は常に \"YYYY-MM-DD\" 文字列。Date オブジェクトを直接渡さない",
         "strToDate/dateToStr は new Date(y, m-1, d) のローカルタイム方式（TZ ずれ回避）"
-      ]
+      ],
+      "props": {
+        "triggerLabel": "string — trigger のスクリーンリーダー向けラベル。未指定時は選択済みの日付/placeholder が読み上げられる（issue #426。React Native 版は accessibilityLabel）"
+      }
     },
     {
       "name": "Textarea",
@@ -240,6 +245,9 @@
       "path": "src/components/ui/label.tsx",
       "description": "フォームラベル。すべての入力コントロールに対して必須。htmlForで入力と紐付ける。",
       "variants": [],
+      "props": {
+        "unstyled": "boolean — typo-label-md・文字色・peer-disabled 系クラスを出さず Radix Label の挙動だけ提供（段階移行用 / issue #443, #420の続き）"
+      },
       "rules": [
         "Always pair with form control via htmlFor"
       ]
@@ -338,7 +346,8 @@
       ],
       "rules": [
         "rounded-full only",
-        "Use DiceBear shapes for placeholder, not pravatar.cc"
+        "Use DiceBear shapes for placeholder, not pravatar.cc",
+        "native (src/native/components/Avatar.tsx): size はプリセット(sm/md/lg/xl)に加えて pt の数値も可。shape=\"circle\"(既定)|\"rounded\"、rounded の角丸は radius(lg/xl/2xl・既定 xl)。fallback は文字列に加えて ReactNode を受け、独自のフォールバック表示（決定論グラデ+絵文字等）を差し込める。source はリモート URL 文字列も受け取り {uri} に正規化する（issue #449）"
       ]
     },
     {
@@ -402,7 +411,8 @@
         "autoFocus は first-input / title / ref / false を指定可能",
         "description prop はRadix管理IDの sr-only description を自動生成する",
         "SheetTitle は level=\"page\"|\"section\"|\"card\" で見出しの役割を指定する（値は contracts/composition.json の textHierarchy と1対1）。未指定時は BottomSheetFrame preset=\"mobile-full\"|\"mobile-page\" 配下で page 相当、それ以外は従来の typo-heading-lg",
-        "native (src/native/components/Sheet.tsx): safeArea(既定 true) で side=\"top\" の上端 inset 退避と、画面いっぱいに近い side=\"bottom\" の食い込み分の退避を行う。実測 inset は SafeAreaInsetsProvider から供給し、未供給なら回避量 0（従来どおり）"
+        "native (src/native/components/Sheet.tsx): safeArea(既定 true) で side=\"top\" の上端 inset 退避と、画面いっぱいに近い side=\"bottom\" の食い込み分の退避を行う。実測 inset は SafeAreaInsetsProvider から供給し、未供給なら回避量 0（従来どおり）",
+        "native (src/native/components/Sheet.tsx): surfaceColor でパネル（および snap モードの footer）の面色を上書きできる。未指定なら theme.surface.primary（従来どおり）。scrim の色は変えない（issue #448）"
       ],
       "variants": {
         "titleLevel": [
@@ -1037,7 +1047,8 @@
         "3 件以上選択する用途に。少数なら CheckboxGroup を優先"
       ],
       "props": {
-        "clearLabel": "string (既定 \"選択をクリア\") — クリアボタンの aria-label（issue #428）"
+        "clearLabel": "string (既定 \"選択をクリア\") — クリアボタンの aria-label（issue #428）",
+        "triggerLabel": "string — trigger のスクリーンリーダー向けラベル。未指定時は未選択なら placeholder、選択済みならチップの表示テキストが読み上げられる（issue #426。React Native 版は accessibilityLabel）"
       }
     },
     {
@@ -1592,7 +1603,8 @@
         "placement: start / end / center",
         "bottomOffset: none / bottom-nav / bottom-nav-pill / bottom-nav-pill-inline",
         "keyboardBehavior: hide / lift / stay",
-        "fullWidth: true / false"
+        "fullWidth: true / false",
+        "bottomOffsetExtra: CSS length（web）/ number pt（native）。bottomOffset プリセット値へ加算する任意の追加オフセット"
       ],
       "accessibility": [
         "label prop is required and used as aria-label"
@@ -1604,7 +1616,8 @@
         "pill BottomTabBar の上に重ねる場合は bottomOffset=bottom-nav-pill、横並びに置く場合は bottomOffset=bottom-nav-pill-inline を使う",
         "keyboard 表示中に入力を邪魔する場合は keyboardBehavior=hide を使う",
         "variant=glass に shadow-* を重ねない（glass-accent が inset 3層 + drop shadow を内包するため二重になる）",
-        "下部固定の全幅 CTA は fullWidth を使い、fixed inset-x + Button を手組みしない。fullWidth 時は placement が無視されラベルが常に表示される"
+        "下部固定の全幅 CTA は fullWidth を使い、fixed inset-x + Button を手組みしない。fullWidth 時は placement が無視されラベルが常に表示される",
+        "広告バナー等で動的に持ち上げる必要があるときは、内部変数 --ksk-fab-bottom-offset を直接上書きせず bottomOffsetExtra を使う（issue #453）"
       ]
     },
     {
@@ -2196,7 +2209,8 @@
       ],
       "rules": [
         "長い SheetContent className recipe を consumer 側に重複させず BottomSheetFrame preset を使う",
-        "フォーム/詳細の中身は DetailSheetScaffold と KeyboardAwareSheetFooter を使う"
+        "フォーム/詳細の中身は DetailSheetScaffold と KeyboardAwareSheetFooter を使う",
+        "native (src/native/components/BottomSheetFrame.tsx): height=\"preset\"(既定・従来の固定高)|\"fitContent\"(min/max を外して内容量に追従)。maxHeight で上限だけ明示できる。safeArea(既定 false) で bottom inset 分の内側余白、handle(既定 false) で上端のつまみを表示（issue #448）"
       ]
     },
     {