ksk-design-system 1.63.0 → 1.64.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,11 @@ 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` を含めてください。
+
 ### 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
 }
 
@@ -187,12 +192,60 @@ 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)
@@ -206,7 +259,23 @@ 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
+      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 +300,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 +329,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 +362,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.0",
+    "version": "1.64.0",
     "description": "全コンポーネントの構造化定義。バリアント・アクセシビリティ要件・使用ルールを機械可読形式で管理。",
     "counts": {
       "ui": 68,
@@ -211,7 +211,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 +243,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"
       ]
@@ -1037,7 +1043,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）"
       }
     },
     {
@@ -2107,7 +2114,10 @@
         "単純な on/off トグルは FilterChip、単一選択リストは DropdownFilter、任意パネル + 明示クリアは FilterPill",
         "適用中かどうかの正本は value（active フラグを別に持たない）",
         "value の整形（複数選択の \"渋谷 他2件\" 等）は呼び出し側の責務"
-      ]
+      ],
+      "props": {
+        "icon": "ReactNode — ラベル左のアイコン（装飾・aria-hidden。iconsax size=16 相当）"
+      }
     },
     {
       "name": "ImageOverlayAction",