@mew-lab/a11y-cli 0.1.0

package/README.md

@@ -0,0 +1,80 @@
+# @mew-lab/a11y-cli
+
+writer: Claude Code
+
+WAI-ARIA APG パターンと WCAG 2.2 のアクセシビリティ観点を、コマンドラインと JSON で引けるツールです。
+[a11y.mew-lab.com](https://a11y.mew-lab.com) と同じ知識（日本語）を、エディタの手元や AI エージェントから参照できます。
+
+## インストール
+
+```sh
+# 単発で使う（推奨）
+npx @mew-lab/a11y-cli pattern dialog-modal
+
+# グローバルに入れる
+npm install -g @mew-lab/a11y-cli
+a11y pattern dialog-modal
+```
+
+Node.js 18 以上が必要です。
+
+## コマンド
+
+| コマンド | 説明 |
+|---|---|
+| `a11y pattern [slug]` | APG パターンの観点（ARIA・キーボード・チェックリスト・アンチパターン・関連 WCAG）。無引数で一覧 |
+| `a11y wcag [slug]` | WCAG 2.2 達成基準（レベル・原則・要約・参照 URL・関連パターン）。無引数で一覧 |
+| `a11y search <query>` | パターン + WCAG を横断検索 |
+| `a11y checklist <slug>` | パターンの実装チェックリストだけを表示（PR レビュー向け） |
+| `a11y manifest` | 全コマンド/レスポンス型の構造化 manifest（AI エージェント向け） |
+| `a11y doctor` | 実行環境を診断 |
+
+グローバルオプション: `--json`（型付き JSON 出力）/ `--detail <full\|compact\|brief>` / `-v, --version`。
+
+## 使用例
+
+```sh
+# モーダルダイアログの観点を見る
+a11y pattern dialog-modal
+
+# パターン一覧
+a11y pattern
+
+# WCAG 達成基準を JSON で取得（スクリプト/AI 向け）
+a11y wcag 1-1-1 --json
+
+# 「フォーカス」に関する項目を横断検索
+a11y search フォーカス
+
+# タブの実装チェックリストだけ
+a11y checklist tabs
+```
+
+## AI エージェント / スクリプトから使う
+
+`--json` を付けると、機械可読な封筒で出力します。
+
+```jsonc
+// 成功
+{ "apiVersion": 1, "type": "pattern.detail", "data": { /* ... */ } }
+
+// エラー（code で分岐できる。code は append-only の安定値）
+{ "apiVersion": 1, "error": "'dialg' というパターンはありません",
+  "code": "ERR_UNKNOWN_PATTERN",
+  "suggestions": [{ "slug": "dialog-modal", "reason": "モーダルダイアログ（似た名前）" }] }
+```
+
+まず `a11y manifest --json` でコマンドとレスポンス型の一覧を取得すると、ヘルプをスクレイプせずに使えます。
+
+### プログラムから（API）
+
+```ts
+import { patternDetail, wcagDetail, search } from '@mew-lab/a11y-cli/api';
+
+const { data } = patternDetail('dialog-modal'); // { type, data } を返す。CLI と同じロジック
+```
+
+## データの出どころ
+
+すべての観点データは [`@mew-lab/a11y-core`](../core) に一元化されています（唯一の真実）。
+Web サイトと CLI は同じ core を参照するため、内容が食い違いません。

package/bin/a11y.mjs

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+// Node バージョンゲート → CLI 本体（dist）を動的 import する。
+// 古い Node でも cryptic な ESM エラーではなく分かりやすいメッセージを出す。
+const MIN = [18, 0, 0];
+const cur = process.versions.node.split('.').map((n) => Number.parseInt(n, 10));
+
+function isOlder(a, b) {
+  for (let i = 0; i < 3; i++) {
+    const va = a[i] ?? 0;
+    const vb = b[i] ?? 0;
+    if (va !== vb) return va < vb;
+  }
+  return false;
+}
+
+if (isOlder(cur, MIN)) {
+  const msg = `a11y CLI には Node.js ${MIN.join('.')} 以上が必要です（現在: ${process.versions.node}）`;
+  if (process.argv.includes('--json')) {
+    console.log(JSON.stringify({ apiVersion: 1, error: msg, code: 'ERR_NODE_VERSION' }, null, 2));
+  } else {
+    console.error(msg);
+  }
+  process.exit(1);
+}
+
+const { run } = await import('../dist/index.js');
+await run(process.argv);

package/dist/api.d.ts

@@ -0,0 +1,50 @@
+import { SearchHit, PatternDetail, CriterionDetail } from '@mew-lab/a11y-core';
+
+interface ApiResult<T extends string, D> {
+    type: T;
+    data: D;
+}
+interface PatternListData {
+    total: number;
+    categories: {
+        category: string;
+        items: {
+            slug: string;
+            ja: string;
+            en: string;
+            summary: string;
+        }[];
+    }[];
+}
+declare function patternList(): ApiResult<'pattern.list', PatternListData>;
+declare function patternDetail(slug: string): ApiResult<'pattern.detail', PatternDetail>;
+interface WcagListData {
+    total: number;
+    principles: {
+        principle: string;
+        items: {
+            slug: string;
+            num: string;
+            ja: string;
+            en: string;
+            level: string;
+            summary: string;
+        }[];
+    }[];
+}
+declare function wcagList(): ApiResult<'wcag.list', WcagListData>;
+declare function wcagDetail(slug: string): ApiResult<'wcag.detail', CriterionDetail>;
+interface SearchData {
+    query: string;
+    total: number;
+    hits: SearchHit[];
+}
+declare function search(query: string): ApiResult<'search.results', SearchData>;
+interface ChecklistData {
+    slug: string;
+    ja: string;
+    checklist: string[];
+}
+declare function checklist(slug: string): ApiResult<'pattern.checklist', ChecklistData>;
+
+export { type ApiResult, type ChecklistData, type PatternListData, type SearchData, type WcagListData, checklist, patternDetail, patternList, search, wcagDetail, wcagList };

package/dist/api.js

@@ -0,0 +1,17 @@
+import {
+  checklist,
+  patternDetail,
+  patternList,
+  search,
+  wcagDetail,
+  wcagList
+} from "./chunk-Y6KJQSVY.js";
+export {
+  checklist,
+  patternDetail,
+  patternList,
+  search,
+  wcagDetail,
+  wcagList
+};
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}