ksk-design-system 1.45.0 → 1.46.0

package/AGENTS.md

@@ -38,6 +38,13 @@ UI コンポーネント・画面の生成/修正・レビューの前には、
 
 コンポーネントを新規作成する前に `COMPONENT_LOOKUP.md` で同等品がないか確認すること。
 
+### ローカル二重実装ゲート
+
+DS に無いと思っても consumer 側に別台帳を作らないこと。最初に `contracts/components.json` と
+`COMPONENT_LOOKUP.md` を検索し、consumer では `npx ksk-ds check-duplicates ./src --strict` を実行する。
+それでも不足する場合は DS 側に issue を登録する。やむを得ない一時実装には、削除条件と issue を
+`// ksk-ds-local-fallback: DS に X が追加されたら削除 (issue #123)` の形式で残すこと。
+
 Storybook 全体を横断で視覚監査する（定期監査・リリース前総点検）場合は `.claude/skills/audit-pages/SKILL.md` の手順に従うこと。
 
 ---

package/CLAUDE.md

@@ -92,6 +92,13 @@ Brand色を差し替え（10行）→ Primitive Layer → Semantic Layer → Bri
 5. `tokens.json` でカラー・余白・影・タイポのトークンを確認
 6. 画面（ページ/ダイアログ等）を実装する場合は `contracts/screen-patterns.json` の decisionTree でシェル/パターンを選び、`contracts/composition.json` で内部の並べ方を確認
 
+### ローカル二重実装ゲート
+
+DS に無いと思っても consumer 側に別台帳を作らないこと。最初に `contracts/components.json` と
+`COMPONENT_LOOKUP.md` を検索し、consumer では `npx ksk-ds check-duplicates ./src --strict` を実行する。
+それでも不足する場合は DS 側に issue を登録する。やむを得ない一時実装には、削除条件と issue を
+`// ksk-ds-local-fallback: DS に X が追加されたら削除 (issue #123)` の形式で残すこと。
+
 **`.tsx` を編集したら `bash scripts/lint-scratch.sh`、コンポーネント増減時は `npm run check` を実行すること。**
 
 Storybook 全体を横断で視覚監査する（定期監査・リリース前総点検・「全ページ確認して」）場合は `.claude/skills/audit-pages/SKILL.md` を使う。

package/DESIGN.md

@@ -46,6 +46,7 @@ rounded:
 spacing:
   unit: "4px"      # 4px グリッド（scale: 0,4,8,12,16,20,24,28,32,36,40,44,48,...）
   page: "16px"     # 基準画面端マージン。実レイアウトは Screen / Shell の padding contract を優先
+  section: { xs: "32px", sm: "40px", md: "48px", lg: "56px", xl: "64px", 2xl: "80px" }
 elevation:                                          # 影色は neutral（Gray-900 ベース rgba(17,24,39,…)）でテーマ非依存
   sm: "0 1px 2px 0 rgba(0, 0, 0, 0.05)"
   md: "0 0 8px rgba(20, 20, 20, 0.08)"
@@ -98,7 +99,7 @@ EC/BtoC 系）を回すのが狙い。
 `DESIGN.md` は Google DESIGN.md の「front matter + rationale」形式を参考にした **AI 向け配布サマリ**であり、
 実装正本ではない。KSK の正本は次のファイルに置く。
 
-- `tokens.json`: primitive / semantic / dark semantic / typography / spacing / shadow / touch target。
+- `tokens.json`: primitive / semantic / dark semantic / typography / spacing / responsive breakpoint / shadow / touch target。
 - `src/styles/*.css`: 実際に publish される CSS custom properties と typography / glass utilities。
 - `contracts/rules.json`: 禁止パターン、AI anti-pattern、a11y、consumer lint の正本。
 - `contracts/components.json`: component 名、variant、subcomponent、usage rule、件数の正本。
@@ -140,6 +141,7 @@ KSK の必須正本・publish 依存にせず、KSK 固有の multi-theme / nati
 ## Layout & Spacing
 
 - **4px グリッド**。余白・サイズは 4 の倍数（scale 0–60）。
+- セクション同士の縦リズムは `--Space-Section-{xs..2xl}`（32–80px）を使い、コンポーネント内の gap scale と分離する。
 - 画面端マージン: 16px を基準にしつつ、実レイアウトでは `Screen` / shell component の padding contract を優先する。
 - **タッチターゲット**（モバイル）: WCAG 2.5.5 / Apple HIG に従い主要操作（ボタン/アイコンボタン/入力/ナビ）の
   **min は 44px** 以上、推奨 48px。44 未満が避けられない **チップ（min 32px）は hitSlop**（不可視の拡張タップ領域）で

package/PUBLISHING.md

@@ -5,7 +5,8 @@
 > **配布方式**: v1.36.0 以降は npm レジストリ経由で配布する。
 > `npm publish --access public` で公開し、各消費リポジトリの
 > `package.json` は `ksk-design-system@X.Y.Z` を参照する。
-> 消費リポ: belle-todo / trip_todo / ninshin-todo / yokoku-app / pawly（いずれも `~/LocalDev/` 直下）。
+> 対象の消費リポ一覧は `scripts/update-consumers.sh` の `DEFAULT_REPOS` が正本
+> （単体リポ・monorepo が混在し、`~/LocalDev/` と `~/LocalDev/Examination/` 配下にまたがる）。
 
 ## 前提
 
@@ -15,18 +16,32 @@
 ## 最短手順（推奨）
 
 ```bash
-bash scripts/release.sh minor   # patch / minor / major / x.y.z
+# release branch で package.json / package-lock.json と契約 version を更新
+# PR を main にマージ
+RUN_ID="$(gh run list --workflow=publish.yml --branch=main --limit=1 \
+  --json databaseId --jq '.[0].databaseId')"
+gh run watch "$RUN_ID" --exit-status
 ```
 
-これだけ。中で以下を全部やる:
+main への version 変更を `.github/workflows/publish.yml` が検知し、npm Trusted
+Publishing (OIDC) で以下を自動実行する:
 
-1. `git diff --quiet` & main ブランチチェック（曜日チェック）
-2. `npm run check`
-3. `npm version <level>`（tag 切り）
-4. `npm pack`（prepack で `dist/` を生成し、中身を検証）
-5. `npm publish --access public`
-6. `git push origin main --tags`
-7. `bash scripts/update-consumers.sh <version>`（5 リポへ PR 自動作成）
+1. npm 上の最新版と `package.json` の version を比較
+2. `npm ci`
+3. `npm publish`（prepack で `dist/` を生成）
+4. `vX.Y.Z` tag と GitHub Release を作成
+
+公開後、レジストリ反映を確認してから消費リポへ配布する:
+
+```bash
+npm view ksk-design-system@<version> version --json
+npm dist-tag ls ksk-design-system
+bash scripts/update-consumers.sh <version>
+```
+
+PR では `npm run check`、`npm test`、`npm pack --dry-run` を通してからマージする。
+ローカル認証による手動公開が必要な場合だけ `bash scripts/release.sh <version>` を
+フォールバックとして使う。
 
 > v1.35.0 で旧名 `@ksk/design-system` 互換 tgz の生成は廃止。
 > 消費5リポ + todo-shared が新名 `ksk-design-system` に移行済。
@@ -148,16 +163,19 @@ bash scripts/update-consumers.sh <version> <影響リポ...>
 ## 注意
 
 - 配布前に必ず `npm pack --dry-run` で中身確認
-- npm registry 公開には `npm login` 済みであること
+- 通常公開は Trusted Publishing (OIDC) を使う。`npm login` は
+  `scripts/release.sh` でローカル公開へフォールバックする場合のみ必要
 - `package.json#exports` を変更したら必ず利用側プロジェクトでの import を試す
 - 金曜午後のリリースは厳禁（週末に障害対応できない）
 - メジャーリリースは月初の月曜が望ましい（フィードバック収集期間が取れる）
 
 ## npm 公開について
 
-v1.36.0 以降は npm registry 経由配布。GitHub Actions による自動 publish はなく、
-ローカルの `npm login` 済み環境から `scripts/release.sh` で公開する。
-CI/CD に戻す場合は、NPM_TOKEN の Secrets 登録と workflow の再作成をセットで行うこと。
+v1.36.0 以降は npm registry 経由配布。通常公開は
+`.github/workflows/publish.yml` と npm Trusted Publishing (OIDC) を使うため、
+長寿命の `NPM_TOKEN` やローカルの `npm login` は不要。
+workflow が利用できない緊急時だけ、`scripts/release.sh` のローカル公開へ
+フォールバックする。
 
 ## 関連
 

package/README.md

@@ -37,7 +37,7 @@ Brand 色を差し替えるだけで業種に合わせた配色に切り替わ
 
 React 19 + TypeScript / Vite / **Tailwind CSS v4** / shadcn/ui（Radix UI）/ CVA / iconsax-reactjs / Storybook
 
-**Peer dependencies**: `react` 18 or 19, `react-dom`, `tailwindcss` ^4, `radix-ui`, `@radix-ui/react-slot`, `iconsax-reactjs`
+**Peer dependencies**: `react` 18 or 19, `react-dom`, `tailwindcss` ^4
 
 ## 🚀 使い方
 
@@ -48,11 +48,18 @@ npm install ksk-design-system
 ```
 
 ```css
-/* プロジェクトの CSS */
+/* globals.css / app.css（CSS の場所に応じて ../../ の数を調整） */
+@import "tailwindcss";
 @import "ksk-design-system/preset";
+@import "ksk-design-system/themes/default";
 @import "./themes/my-client.css"; /* Brand 色を差し替えたテーマ */
+@source "../../node_modules/ksk-design-system/dist";
 ```
 
+Tailwind CSS v4 は `node_modules` を既定では走査しません。`@source` がないと、
+DS 内部だけで使うレイアウト・サイズ・状態クラスが生成されず、コンポーネントの表示や操作が崩れます。
+consumer 側の Tailwind と DS を同じビルドで処理するため、上記の設定をセットで使用してください。
+
 ```tsx
 import { Button, Card, Input, FormField } from "ksk-design-system"
 ```
@@ -75,6 +82,80 @@ npx ksk-ds lint --changed
 // ksk-ds-allow-custom-ui: medical chart requires bespoke interaction
 ```
 
+### Jest（CommonJS）でコンポーネントをテストする
+
+このパッケージは **ESM-only** です。CJS との dual build は配布せず、Jest
+側で DS とその ESM 依存を `babel-jest` の変換対象にします。Vitest など
+ESM をネイティブに扱うランナーでは、以下の設定は不要です。
+
+Jest 29 では Babel 7 系を使います（Babel 8 は `babel-jest@29` の peer
+範囲外です）。
+
+```bash
+npm install --save-dev \
+  jest@29.7.0 babel-jest@29.7.0 jest-environment-jsdom@29.7.0 \
+  @babel/core@^7.28.0 @babel/preset-env@^7.28.0 \
+  @babel/preset-react@^7.28.0 @babel/preset-typescript@^7.28.0
+```
+
+```js
+// babel.config.cjs
+module.exports = {
+  presets: [
+    ["@babel/preset-env", { targets: { node: "current" } }],
+    ["@babel/preset-react", { runtime: "automatic" }],
+    ["@babel/preset-typescript", { allExtensions: true, isTSX: true }],
+  ],
+}
+```
+
+```js
+// jest.config.cjs
+module.exports = {
+  testEnvironment: "jsdom",
+  transform: {
+    "^.+\\.m?[jt]sx?$": "babel-jest",
+  },
+  transformIgnorePatterns: [
+    "<rootDir>/node_modules/.pnpm/(?!(ksk-design-system|radix-ui|iconsax-reactjs|@radix-ui\\+[^@]+)@)",
+    "node_modules/(?!.pnpm|ksk-design-system|radix-ui|@radix-ui|iconsax-reactjs)",
+  ],
+  moduleNameMapper: {
+    "\\.(css|less|sass|scss)$": "<rootDir>/test/style-mock.cjs",
+    "^ksk-design-system/(preset|styles(?:\\.css)?|glass|tokens/(?:primitive|semantic|typography|categorical)|themes/(?:default|blue|orange|green|violet|cobalt))$":
+      "<rootDir>/test/style-mock.cjs",
+  },
+}
+```
+
+```js
+// test/style-mock.cjs
+module.exports = {}
+```
+
+この構成なら `ksk-design-system` をコンポーネント単位で mock せず、そのまま
+render できます。リポジトリ内では、実際に `npm pack` した tgz を空の Jest
+プロジェクトへインストールする再現テストを実行できます。
+
+```bash
+npm run test:jest-consumer
+```
+
+React Native / Expo の `jest-expo` でも考え方は同じです。既存の Expo preset
+は維持し、`transformIgnorePatterns` の除外対象へ
+`ksk-design-system` と利用する ESM peer を加えてください。
+
+### Consumer duplicate check
+
+DS に存在する部品を consumer 側で再実装しないよう、コンポーネント名の重複検査を同梱しています。
+
+```bash
+npx ksk-ds check-duplicates
+npx ksk-ds check-duplicates ./src --strict
+```
+
+既定は助言モードで終了コード 0、`--strict` は重複候補があると終了コード 1 です。正本は同梱の `contracts/components.json` であり、consumer 側に別の「昇格候補台帳」を作らないでください。
+
 ### 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/UPDATING.md

@@ -85,6 +85,21 @@ gh pr create
 手動移行が必要な項目（codemod で拾いきれないもの）は [MIGRATION.md](./MIGRATION.md) の
 「移行作業の進め方」節を参照。
 
+### Tailwind CSS v4 の走査設定
+
+アップデート後も、consumer のエントリCSSには次の構成を維持する。
+CSSファイルの場所に応じて `../../` の数だけ調整する。
+
+```css
+@import "tailwindcss";
+@import "ksk-design-system/preset";
+@import "ksk-design-system/themes/default";
+@source "../../node_modules/ksk-design-system/dist";
+```
+
+`@source` を外すと、DS内部だけで使われるクラスが生成されない。`dist` のプリビルドCSSと
+consumer側Tailwindを重ねる二重ビルド方式にも切り替えないこと。
+
 ## 5. していい・ダメ早見表
 
 | していい | ダメ |

package/bin/card-child-spacing.js

@@ -0,0 +1,111 @@
+import ts from "typescript"
+
+const SPACING_CLASS =
+  /(?:^|[\s"'`:({[])-?(?:mt|mb|my|space-y)-[^\s"'`})\]]+/
+
+function tagNameOf(node, sourceFile) {
+  if (ts.isJsxElement(node)) {
+    return node.openingElement.tagName.getText(sourceFile)
+  }
+  if (ts.isJsxSelfClosingElement(node)) {
+    return node.tagName.getText(sourceFile)
+  }
+  return ""
+}
+
+function openingOf(node) {
+  if (ts.isJsxElement(node)) return node.openingElement
+  if (ts.isJsxSelfClosingElement(node)) return node
+  return null
+}
+
+function hasMediaVariant(opening, sourceFile) {
+  const attribute = opening.attributes.properties.find(
+    (property) =>
+      ts.isJsxAttribute(property) &&
+      property.name.getText(sourceFile) === "variant",
+  )
+  if (!attribute || !ts.isJsxAttribute(attribute) || !attribute.initializer) {
+    return false
+  }
+  if (ts.isStringLiteral(attribute.initializer)) {
+    return attribute.initializer.text === "media"
+  }
+  if (
+    ts.isJsxExpression(attribute.initializer) &&
+    attribute.initializer.expression &&
+    (ts.isStringLiteral(attribute.initializer.expression) ||
+      ts.isNoSubstitutionTemplateLiteral(attribute.initializer.expression))
+  ) {
+    return attribute.initializer.expression.text === "media"
+  }
+  return false
+}
+
+function spacingClassOf(node, sourceFile) {
+  const opening = openingOf(node)
+  if (!opening) return null
+  const className = opening.attributes.properties.find(
+    (property) =>
+      ts.isJsxAttribute(property) &&
+      property.name.getText(sourceFile) === "className",
+  )
+  if (!className || !ts.isJsxAttribute(className) || !className.initializer) {
+    return null
+  }
+  const raw = className.initializer.getText(sourceFile)
+  return raw.match(SPACING_CLASS)?.[0]?.trim() ?? null
+}
+
+function directJsxRoots(node, visit) {
+  if (ts.isJsxElement(node) || ts.isJsxSelfClosingElement(node)) {
+    visit(node)
+    return
+  }
+  if (ts.isJsxFragment(node)) {
+    for (const child of node.children) directJsxRoots(child, visit)
+    return
+  }
+  if (ts.isJsxExpression(node) && !node.expression) return
+  ts.forEachChild(node, (child) => directJsxRoots(child, visit))
+}
+
+export function inspectCardChildSpacing(source, filePath = "source.tsx") {
+  const sourceFile = ts.createSourceFile(
+    filePath,
+    source,
+    ts.ScriptTarget.Latest,
+    true,
+    ts.ScriptKind.TSX,
+  )
+  const findings = []
+
+  function walk(node) {
+    if (
+      ts.isJsxElement(node) &&
+      tagNameOf(node, sourceFile) === "Card" &&
+      !hasMediaVariant(node.openingElement, sourceFile)
+    ) {
+      for (const child of node.children) {
+        directJsxRoots(child, (root) => {
+          const spacingClass = spacingClassOf(root, sourceFile)
+          if (!spacingClass) return
+          const position = sourceFile.getLineAndCharacterOfPosition(
+            root.getStart(),
+          )
+          findings.push({
+            line: position.line + 1,
+            tag: tagNameOf(root, sourceFile),
+            spacingClass,
+          })
+        })
+      }
+      ts.forEachChild(node, walk)
+      return
+    }
+    ts.forEachChild(node, walk)
+  }
+
+  walk(sourceFile)
+  return findings
+}

package/bin/check-duplicates.js

@@ -0,0 +1,167 @@
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs"
+import { extname, join, relative, resolve } from "node:path"
+
+const SOURCE_EXTENSIONS = new Set([".ts", ".tsx"])
+const IGNORED_DIRECTORIES = new Set([
+  ".git",
+  ".next",
+  "build",
+  "coverage",
+  "dist",
+  "node_modules",
+  "storybook-static",
+])
+
+export function runCheckDuplicatesCli(
+  argv,
+  { cwd = process.cwd(), pkgRoot = resolve(".") } = {},
+) {
+  const options = parseArgs(argv)
+  if (options.help) {
+    printHelp()
+    return 0
+  }
+
+  const contractsPath = resolve(pkgRoot, "contracts/components.json")
+  if (!existsSync(contractsPath)) {
+    console.error(`contracts/components.json が見つかりません: ${contractsPath}`)
+    return 1
+  }
+
+  const target = resolve(cwd, options.target)
+  if (!existsSync(target)) {
+    console.error(`検査対象が見つかりません: ${target}`)
+    return 1
+  }
+
+  const registry = loadComponentRegistry(contractsPath)
+  const files = collectSourceFiles(target)
+  const findings = files
+    .flatMap((file) => findDuplicateExports(file, cwd, registry))
+    .sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.name.localeCompare(b.name))
+
+  printFindings(findings, files.length, options.strict)
+  return options.strict && findings.length > 0 ? 1 : 0
+}
+
+function parseArgs(argv) {
+  let strict = false
+  let help = false
+  let target = "./src"
+
+  for (const arg of argv) {
+    if (arg === "--strict") {
+      strict = true
+      continue
+    }
+    if (arg === "--help" || arg === "-h") {
+      help = true
+      continue
+    }
+    if (!arg.startsWith("-")) target = arg
+  }
+
+  return { help, strict, target }
+}
+
+function loadComponentRegistry(contractsPath) {
+  const contracts = JSON.parse(readFileSync(contractsPath, "utf8"))
+  const registry = new Map()
+
+  for (const tier of ["ui", "patterns", "commerce", "admin", "shells"]) {
+    for (const component of contracts[tier] ?? []) {
+      if (typeof component?.name !== "string" || typeof component?.path !== "string") continue
+      const matches = registry.get(component.name) ?? []
+      matches.push({ tier, path: component.path })
+      registry.set(component.name, matches)
+    }
+  }
+
+  return registry
+}
+
+function collectSourceFiles(target) {
+  const files = []
+
+  function walk(path) {
+    const stat = statSync(path)
+    if (stat.isDirectory()) {
+      for (const entry of readdirSync(path, { withFileTypes: true })) {
+        if (entry.isDirectory() && IGNORED_DIRECTORIES.has(entry.name)) continue
+        walk(join(path, entry.name))
+      }
+      return
+    }
+    if (stat.isFile() && SOURCE_EXTENSIONS.has(extname(path))) files.push(path)
+  }
+
+  walk(target)
+  return files.sort()
+}
+
+function findDuplicateExports(file, cwd, registry) {
+  const source = readFileSync(file, "utf8")
+  const lines = source.split(/\r?\n/)
+  const findings = []
+  const declarationPattern =
+    /^\s*export\s+(?:default\s+)?(?:(?:async|declare)\s+)?(?:function|const)\s+([A-Z][A-Za-z0-9]*)\b/
+
+  for (let index = 0; index < lines.length; index += 1) {
+    const match = lines[index].match(declarationPattern)
+    if (!match) continue
+    const name = match[1]
+    const components = registry.get(name)
+    if (!components) continue
+    findings.push({
+      components,
+      file: normalize(relative(cwd, file)),
+      line: index + 1,
+      name,
+    })
+  }
+
+  return findings
+}
+
+function printFindings(findings, scannedFiles, strict) {
+  if (findings.length === 0) {
+    console.log(`ksk-ds check-duplicates: 重複候補はありません（${scannedFiles} files）`)
+    return
+  }
+
+  console.log(`ksk-ds check-duplicates: DS と同名のローカル実装を ${findings.length} 件検出しました`)
+  for (const finding of findings) {
+    console.log(`\n${finding.file}:${finding.line} ${finding.name}`)
+    for (const component of finding.components) {
+      console.log(`  DS: ${component.tier} / ${component.path}`)
+    }
+  }
+  console.log("\nローカル実装を削除して ksk-design-system から import できないか確認してください。")
+  console.log("DS に必要な機能が不足する場合は、ローカル台帳を作らず DS 側に Issue を登録してください。")
+  console.log(
+    strict
+      ? "strict mode: 重複候補があるため終了コード 1"
+      : "advice mode: 終了コード 0（CI で失敗させる場合は --strict）",
+  )
+}
+
+function printHelp() {
+  console.log(`ksk-ds check-duplicates
+
+使い方:
+  ksk-ds check-duplicates [DIR]
+  ksk-ds check-duplicates [DIR] --strict
+
+DIR の既定値:
+  ./src
+
+動作:
+  export function / export const の PascalCase 宣言を
+  contracts/components.json と名前の完全一致で照合します。
+  既定は助言モード（常に exit 0）、--strict は検出時 exit 1 です。
+`)
+}
+
+function normalize(path) {
+  return path.split("\\").join("/")
+}

package/bin/init.js

@@ -11,6 +11,7 @@
 //   npx ksk-design-system init --force  # 既存ファイルを上書き
 //   npx ksk-design-system demo [dir]    # DS リポを clone + setup（お試し用）
 //   npx ksk-ds lint src                 # contracts/rules.json に基づき consumer UI を検査
+//   npx ksk-ds check-duplicates src     # DS と同名のローカル実装を検査
 //   npx ksk-design-system postinstall   # npm postinstall から呼ばれる silent モード
 
 import { copyFileSync, existsSync } from "node:fs"
@@ -37,6 +38,8 @@ if (cmd === "help" || cmd === "--help" || cmd === "-h") {
   npx ksk-ds lint src --format json   CI 向け JSON 出力
   npx ksk-ds lint --changed           Git 差分のみ検査
   npx ksk-ds check-migration ./src    非推奨 API の残存を検査（read-only）
+  npx ksk-ds check-duplicates [DIR]    DS と同名のローカル実装を検査
+  npx ksk-ds check-duplicates --strict 検出時に exit 1（CI 向け）
 `)
   process.exit(0)
 }
@@ -53,6 +56,15 @@ if (cmd === "check-migration") {
   process.exit(status)
 }
 
+if (cmd === "check-duplicates") {
+  const { runCheckDuplicatesCli } = await import("./check-duplicates.js")
+  const status = runCheckDuplicatesCli(args.slice(1), {
+    cwd: process.cwd(),
+    pkgRoot,
+  })
+  process.exit(status)
+}
+
 if (cmd === "demo") {
   runDemo(args.slice(1))
   process.exit(0)

package/bin/lint.js

@@ -1,6 +1,7 @@
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs"
 import { extname, join, relative, resolve } from "node:path"
 import { spawnSync } from "node:child_process"
+import { inspectCardChildSpacing } from "./card-child-spacing.js"
 
 const DEFAULT_EXTENSIONS = new Set([".js", ".jsx", ".ts", ".tsx"])
 const DEFAULT_IGNORES = [
@@ -166,6 +167,15 @@ function lintFile(file, cwd, rules) {
   const lines = source.split(/\r?\n/)
 
   for (const rule of rules) {
+    if (rule.engine === "card-direct-child-spacing") {
+      for (const finding of inspectCardChildSpacing(source, file)) {
+        const line = lines[finding.line - 1] ?? ""
+        if (!matchesRuleExclude(rule, rel, line)) {
+          findings.push(toFinding(rule, rel, finding.line))
+        }
+      }
+      continue
+    }
     let regex
     try {
       regex = new RegExp(rule.pattern)