@kongyo2/ts-comment-scanner 0.0.0 → 1.0.0

package/README.md

@@ -1,12 +1,16 @@
 # ts-comment-scanner
 
-TypeScript プロジェクト内のコメントを検出して一覧・集計する CLI / ライブラリです。TypeScript の AST を使って解析するため、文字列やコードの一部を誤検出しません。
+TypeScript プロジェクト内のコメントを検出・一覧・集計し、安全に削除もできる CLI / ライブラリです。TypeScript の AST を使って解析するため、文字列・テンプレートリテラル・正規表現・JSX テキストを誤検出しません。
 
 ## 特徴
 
-- `.ts` `.tsx` `.mts` `.cts` を再帰的にスキャン（`node_modules` と `.git` は除外）
+- `.ts` `.tsx` `.mts` `.cts` を再帰的にスキャン(`node_modules` と `.git` は除外)
 - 行コメント (`//`) とブロックコメント (`/* */`) を位置情報つきで報告
-- テキスト形式と JSON 形式の出力に対応
+- テキスト / JSON / **GitHub Actions アノテーション**の 3 形式で出力
+- `@ts-ignore` や `eslint-disable` などの**コンパイラ・リンター指示子(ディレクティブ)を自動判別**し、絞り込み・除外が可能
+- **安全なコメント削除**(コードクリーンアップ): ディレクティブとライセンスヘッダーはデフォルトで保持
+- Glob による**カスタム無視パターン** (`--ignore`)、対象拡張子の変更 (`--ext`)
+- CI 向けの `--fail-on-comment`(コメント検出時に終了コード 1)
 - CLI としても、ライブラリとしても利用可能
 
 ## インストール
@@ -26,13 +30,33 @@ npx @kongyo2/ts-comment-scanner src
 ```
 ts-comment-scanner [options] [paths...]
 
-Options:
-  --json         結果を JSON で出力
-  -v, --version  バージョンを表示
-  -h, --help     ヘルプを表示
+出力:
+  --format <fmt>       出力形式: text / json / github(既定: text)
+  --json               --format json の短縮形
+
+フィルタリング:
+  --ignore <glob>      Glob に一致するファイル・ディレクトリを除外(複数指定可)
+  --ext <list>         スキャン対象の拡張子(カンマ区切り、既定: .ts,.tsx,.mts,.cts)
+  --skip-directives    コンパイラ・リンター指示子を結果から除外
+  --only-directives    指示子のみを報告
+
+CI:
+  --fail-on-comment    コメントが報告された場合に終了コード 1 で終了
+
+削除:
+  --remove             報告対象のコメントをファイルから削除(インプレース)
+  --dry-run            --remove と併用: 変更せずに削除対象のみ表示
+  --remove-directives  --remove と併用: 指示子コメントも削除
+  --remove-legal       --remove と併用: ライセンス・法的コメントも削除
+
+その他:
+  -h, --help           ヘルプを表示
+  -v, --version        バージョンを表示
 ```
 
-パスを省略するとカレントディレクトリを対象にします。
+パスを省略するとカレントディレクトリを対象にします。スラッシュを含まない Glob(例: `*.test.ts`)はファイル名に、含むもの(例: `src/legacy/**`)はパスに一致します。明示的に指定したファイルは `--ignore` の対象になりません。
+
+**終了コード**: `0` 成功 / `1` `--fail-on-comment` 指定時にコメントを検出 / `2` 引数・実行時エラー
 
 ### 出力例
 
@@ -40,8 +64,9 @@ Options:
 $ ts-comment-scanner src
 src/index.ts:1:1 [line] // エントリーポイント
 src/scanner.ts:8:3 [block] /* AST を走査する */
+src/legacy.ts:3:1 [line] [@ts-ignore] // @ts-ignore 後で直す
 
-2 comments across 2 files
+3 comments across 3 files
 ```
 
 JSON 出力:
@@ -49,42 +74,97 @@ JSON 出力:
 ```bash
 $ ts-comment-scanner --json src
 {
-  "summary": { "files": 1, "comments": 1 },
+  "summary": { "files": 1, "comments": 1, "directives": 0 },
   "files": [
     {
       "file": "src/index.ts",
       "comments": [
-        { "kind": "line", "text": "// エントリーポイント", "start": 0, "end": 12, "line": 1, "column": 1 }
+        {
+          "kind": "line",
+          "text": "// エントリーポイント",
+          "start": 0,
+          "end": 12,
+          "line": 1,
+          "column": 1,
+          "endLine": 1,
+          "endColumn": 13
+        }
       ]
     }
   ]
 }
 ```
 
+ディレクティブと判定されたコメントには `"directive": "@ts-ignore"` のように名前が付きます。
+
+### GitHub Actions で使う
+
+`--format github` は各コメントを [workflow command](https://docs.github.com/actions/reference/workflow-commands-for-github-actions) として出力するため、PR の該当行にアノテーションが表示されます。
+
+```yaml
+- name: Check for stray comments
+  run: npx @kongyo2/ts-comment-scanner --format github --skip-directives --fail-on-comment src
+```
+
+```
+::notice file=src/index.ts,line=1,endLine=1,col=1,endColumn=13,title=line comment::// エントリーポイント
+```
+
+### コメントの一括削除(コードクリーンアップ)
+
+```bash
+# まず削除対象を確認
+ts-comment-scanner --remove --dry-run src
+
+# 実際に削除(ディレクティブとライセンスヘッダーは保持される)
+ts-comment-scanner --remove src
+
+# 指示子・ライセンスも含めて完全に削除
+ts-comment-scanner --remove --remove-directives --remove-legal src
+```
+
+削除は AST のコメント範囲に基づいて行われるため、文字列やコードには影響しません。さらに:
+
+- `@ts-expect-error` / `eslint-disable` などの指示子は、削除するとビルドやリントが壊れるため**デフォルトで保持**
+- `/*! ... */` や `@license` / `@preserve` / `@copyright` を含む法的コメントも**デフォルトで保持**
+- ブロックコメント除去でトークンが結合してしまう位置には空白を挿入(`a/* x */b` → `a b`)
+- コメントだけの行は行ごと削除、行末コメントは手前の空白ごと削除
+- 削除後のソースを再スキャンして検証し、想定外の結果になる場合はファイルを変更せずエラー報告
+
+### 検出できるディレクティブ(抜粋)
+
+`@ts-ignore` `@ts-expect-error` `@ts-nocheck` `@ts-check` / `eslint-disable` 系・`eslint-env`・`/* global */` / `tslint:` / `oxlint-disable` 系 / `biome-ignore` 系 / `deno-lint-ignore` 系 / `prettier-ignore` / `istanbul ignore`・`c8 ignore`・`v8 ignore`・`node:coverage` / `webpackChunkName:` などの webpack マジックコメント / `@vite-ignore` / `#__PURE__` / `//# sourceMappingURL=`・`//# sourceURL=` / `@jsx` 系プラグマ / `@jest-environment`・`@vitest-environment` / `/// <reference>` / `#region`・`#endregion`
+
 ## ライブラリとして使う
 
 ```ts
-import { scanPaths, scanComments, formatText } from "@kongyo2/ts-comment-scanner";
+import { scanPaths, scanComments, removeComments, formatText } from "@kongyo2/ts-comment-scanner";
 
 // ファイル / ディレクトリをまとめてスキャン
-const results = await scanPaths(["src"]);
+const results = await scanPaths(["src"], { ignore: ["**/*.test.ts"] });
 console.log(formatText(results));
 
 // ソース文字列を直接スキャン
 const comments = scanComments("// hello\nconst x = 1;");
+
+// コメントを安全に削除
+const { code, removed, kept } = removeComments("// note\nconst x = 1;\n");
 ```
 
 ### 主な API
 
 | 関数 | 概要 |
 | --- | --- |
-| `scanComments(source, options?)` | ソース文字列からコメント配列を取得（`options.jsx` で TSX を解析） |
+| `scanComments(source, options?)` | ソース文字列からコメント配列を取得(`options.jsx` で TSX を解析) |
 | `scanFile(file)` | 1 ファイルをスキャン |
-| `scanPaths(inputs, options?)` | ファイル / ディレクトリ群を再帰的にスキャン |
+| `scanPaths(inputs, options?)` | ファイル / ディレクトリ群を再帰的にスキャン(`ignore` / `extensions` 対応) |
 | `collectFiles(inputs, options?)` | 対象ファイルのパス一覧を収集 |
-| `formatText(results)` / `formatJson(results)` | スキャン結果を整形 |
+| `removeComments(source, options?)` | コメントを安全に削除(`removeDirectives` / `removeLegal` / `shouldRemove`) |
+| `detectDirective(kind, text)` | コメントがディレクティブなら正規化した名前を返す |
+| `isLegalComment(text)` | ライセンス・法的コメントかどうかを判定 |
+| `formatText(results)` / `formatJson(results)` / `formatGitHub(results)` | スキャン結果を整形 |
 
-型: `Comment` / `CommentKind` / `FileScanResult` / `ScanOptions` / `CollectOptions`
+型: `Comment` / `CommentKind` / `FileScanResult` / `ScanOptions` / `CollectOptions` / `RemoveOptions` / `RemoveResult`
 
 ## 必要環境
 

package/dist/args.d.ts

@@ -1,8 +1,22 @@
+export type OutputFormat = "text" | "json" | "github";
+export type DirectiveMode = "include" | "skip" | "only";
 export interface CliOptions {
     paths: string[];
-    json: boolean;
+    format: OutputFormat;
+    ignore: string[];
+    extensions: string[] | undefined;
+    directives: DirectiveMode;
+    failOnComment: boolean;
+    remove: boolean;
+    removeDirectives: boolean;
+    removeLegal: boolean;
+    dryRun: boolean;
     help: boolean;
     version: boolean;
 }
+/** Invalid command line input; the CLI reports the message and exits with code 2. */
+export declare class UsageError extends Error {
+    constructor(message: string);
+}
 export declare function parseArgs(argv: string[]): CliOptions;
 //# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAyBpD"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AACtD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACjC,UAAU,EAAE,aAAa,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qFAAqF;AACrF,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAKD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAqJpD"}

package/dist/args.js

@@ -1,25 +1,165 @@
+/** Invalid command line input; the CLI reports the message and exits with code 2. */
+export class UsageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "UsageError";
+    }
+}
+const FORMATS = ["text", "json", "github"];
+const DIRECTIVE_CONFLICT = "--skip-directives and --only-directives cannot be combined";
 export function parseArgs(argv) {
     const paths = [];
-    let json = false;
+    const ignore = [];
+    const extensions = [];
+    let format = "text";
+    let directives = "include";
+    let failOnComment = false;
+    let remove = false;
+    let removeDirectives = false;
+    let removeLegal = false;
+    let dryRun = false;
     let help = false;
     let version = false;
-    for (const arg of argv) {
-        switch (arg) {
+    let pathsOnly = false;
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (pathsOnly || !arg.startsWith("-") || arg === "-") {
+            paths.push(arg);
+            continue;
+        }
+        const [flag, inlineValue] = splitFlag(arg);
+        const readValue = () => {
+            if (inlineValue !== undefined)
+                return inlineValue;
+            const next = argv[index + 1];
+            if (next === undefined)
+                throw new UsageError(`option ${flag} requires a value`);
+            index += 1;
+            return next;
+        };
+        const rejectValue = () => {
+            if (inlineValue !== undefined)
+                throw new UsageError(`option ${flag} does not take a value`);
+        };
+        switch (flag) {
+            case "--":
+                rejectValue();
+                pathsOnly = true;
+                break;
+            case "--format": {
+                const value = readValue();
+                if (!FORMATS.includes(value)) {
+                    throw new UsageError(`unknown format: ${value} (expected ${FORMATS.join(", ")})`);
+                }
+                format = value;
+                break;
+            }
             case "--json":
-                json = true;
+                rejectValue();
+                format = "json";
+                break;
+            case "--ignore":
+                ignore.push(readValue());
+                break;
+            case "--ext": {
+                const parsed = readValue()
+                    .split(",")
+                    .map((extension) => extension.trim())
+                    .filter((extension) => extension !== "");
+                if (parsed.length === 0) {
+                    throw new UsageError("option --ext requires at least one extension");
+                }
+                extensions.push(...parsed);
+                break;
+            }
+            case "--skip-directives":
+                rejectValue();
+                if (directives === "only")
+                    throw new UsageError(DIRECTIVE_CONFLICT);
+                directives = "skip";
+                break;
+            case "--only-directives":
+                rejectValue();
+                if (directives === "skip")
+                    throw new UsageError(DIRECTIVE_CONFLICT);
+                directives = "only";
+                break;
+            case "--fail-on-comment":
+                rejectValue();
+                failOnComment = true;
+                break;
+            case "--remove":
+                rejectValue();
+                remove = true;
+                break;
+            case "--remove-directives":
+                rejectValue();
+                removeDirectives = true;
+                break;
+            case "--remove-legal":
+                rejectValue();
+                removeLegal = true;
+                break;
+            case "--dry-run":
+                rejectValue();
+                dryRun = true;
                 break;
             case "-h":
             case "--help":
+                rejectValue();
                 help = true;
                 break;
             case "-v":
             case "--version":
+                rejectValue();
                 version = true;
                 break;
             default:
-                paths.push(arg);
+                throw new UsageError(`unknown option: ${flag}`);
         }
     }
-    return { paths: paths.length > 0 ? paths : ["."], json, help, version };
+    if (!remove) {
+        for (const [set, flag] of [
+            [dryRun, "--dry-run"],
+            [removeDirectives, "--remove-directives"],
+            [removeLegal, "--remove-legal"],
+        ]) {
+            if (set)
+                throw new UsageError(`${flag} requires --remove`);
+        }
+    }
+    if (remove && failOnComment) {
+        throw new UsageError("--fail-on-comment cannot be combined with --remove");
+    }
+    if (remove && format === "github") {
+        throw new UsageError("--format github cannot be combined with --remove");
+    }
+    if (remove && directives === "only" && !removeDirectives) {
+        throw new UsageError("--remove --only-directives would remove nothing; add --remove-directives to delete directives");
+    }
+    if (remove && directives === "skip" && removeDirectives) {
+        throw new UsageError("--remove-directives cannot be combined with --skip-directives");
+    }
+    return {
+        paths: paths.length > 0 ? paths : ["."],
+        format,
+        ignore,
+        extensions: extensions.length > 0 ? extensions : undefined,
+        directives,
+        failOnComment,
+        remove,
+        removeDirectives,
+        removeLegal,
+        dryRun,
+        help,
+        version,
+    };
+}
+function splitFlag(arg) {
+    const equalsIndex = arg.indexOf("=");
+    if (arg.startsWith("--") && equalsIndex > 2) {
+        return [arg.slice(0, equalsIndex), arg.slice(equalsIndex + 1)];
+    }
+    return [arg, undefined];
 }
 //# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,QAAQ;gBACX,IAAI,GAAG,IAAI,CAAC;gBACZ,MAAM;YACR,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ;gBACX,IAAI,GAAG,IAAI,CAAC;gBACZ,MAAM;YACR,KAAK,IAAI,CAAC;YACV,KAAK,WAAW;gBACd,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM;YACR;gBACE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}

package/dist/directives.d.ts

@@ -0,0 +1,12 @@
+import type { CommentKind } from "./types.js";
+/**
+ * Returns the canonical name of the compiler/linter/tooling directive the
+ * comment represents, or `undefined` when the comment is an ordinary comment.
+ */
+export declare function detectDirective(kind: CommentKind, text: string): string | undefined;
+/**
+ * True for license/legal comments (`/*!`, `@license`, `@preserve`, `@copyright`)
+ * that build tools conventionally keep when stripping comments.
+ */
+export declare function isLegalComment(text: string): boolean;
+//# sourceMappingURL=directives.d.ts.map

package/dist/directives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives.d.ts","sourceRoot":"","sources":["../src/directives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAmE9C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkCnF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD"}

package/dist/directives.js

@@ -0,0 +1,133 @@
+const RULES = [
+    // ESLint
+    { pattern: /^eslint-(?:disable|enable)(?:-next-line|-line)?\b/ },
+    { pattern: /^eslint-env\b/ },
+    { pattern: /^eslint\s+\S/, name: "eslint", blockOnly: true },
+    { pattern: /^(globals?|exported)\s+\S/, name: (match) => match[1] ?? "global", blockOnly: true },
+    // TSLint (legacy)
+    { pattern: /^tslint:[a-z-]+/ },
+    // oxlint
+    { pattern: /^oxlint-(?:disable|enable)(?:-next-line|-line)?\b/ },
+    // Biome
+    { pattern: /^biome-ignore(?:-all|-start|-end)?\b/ },
+    // Deno
+    { pattern: /^deno-(?:lint-ignore(?:-file)?|fmt-ignore(?:-file)?|coverage-ignore(?:-file|-start|-stop)?)\b/ },
+    // Prettier
+    { pattern: /^prettier-ignore(?:-start|-end)?\b/ },
+    // Coverage tools. The mode is part of the name so that consumers can tell
+    // next-statement pragmas (`next`, `if`, ...) from file/range ones (`file`,
+    // `start`, `stop`). Istanbul hints work in either comment kind; the V8-based
+    // tools (c8, v8, node:coverage) only document and parse block comments.
+    { pattern: /^istanbul\s+ignore\s+([a-z]+)/, name: (match) => `istanbul-ignore-${match[1]}` },
+    { pattern: /^istanbul\s+ignore\b/, name: "istanbul-ignore" },
+    { pattern: /^c8\s+ignore\s+([a-z]+)/, name: (match) => `c8-ignore-${match[1]}`, blockOnly: true },
+    { pattern: /^c8\s+ignore\b/, name: "c8-ignore", blockOnly: true },
+    { pattern: /^v8\s+ignore\s+([a-z]+)/, name: (match) => `v8-ignore-${match[1]}`, blockOnly: true },
+    { pattern: /^v8\s+ignore\b/, name: "v8-ignore", blockOnly: true },
+    {
+        pattern: /^node:coverage\s+(disable|enable|ignore)\b/,
+        name: (match) => `node:coverage-${match[1]}`,
+        blockOnly: true,
+    },
+    // Bundlers
+    { pattern: /^webpack[A-Z][A-Za-z]*\s*:/, name: "webpack-magic-comment" },
+    { pattern: /^@vite-ignore\b/ },
+    { pattern: /^[#@]__(?:PURE|NO_SIDE_EFFECTS|INLINE|NOINLINE)__/ },
+    // Source maps (`//# sourceMappingURL=`, legacy `//@`, and the block form)
+    { pattern: /^[#@]\s*(source(?:Mapping)?URL)=/, name: (match) => match[1] ?? "sourceMappingURL" },
+    // JSX pragmas (docblock pragmas: block comments only, honoured on any line)
+    { pattern: /^@jsx(?:Runtime|ImportSource|Frag)?\b/, blockOnly: true, anyLine: true },
+    // Test runners (docblock pragmas as well)
+    { pattern: /^@(?:jest|vitest)-environment\b/, blockOnly: true, anyLine: true },
+    // Editor folding
+    { pattern: /^#(?:region|endregion)\b/ },
+];
+const TRIPLE_SLASH = /^\/\/\/\s*<(reference|amd-dependency|amd-module)\b/;
+// Mirrors the TypeScript compiler's own comment-directive matching, verified
+// against tsc: the suppression directives are case-sensitive PREFIX matches
+// (`@ts-ignoreTODO` is active), while the file-wide check pragmas are
+// case-insensitive and must end at a word boundary (`@ts-nocheckfoo` is not).
+const TS_LINE_SUPPRESSION = /^\/\/\/?\s*@ts-(ignore|expect-error)/;
+const TS_LINE_CHECK_PRAGMA = /^\/\/\/?\s*@ts-(nocheck|check)\b/i;
+// Block comments: only the suppression directives, and only on the last line.
+const TS_BLOCK_SUPPRESSION = /^[\s/*]*@ts-(ignore|expect-error)/;
+/**
+ * Returns the canonical name of the compiler/linter/tooling directive the
+ * comment represents, or `undefined` when the comment is an ordinary comment.
+ */
+export function detectDirective(kind, text) {
+    if (kind === "line") {
+        const tripleSlash = TRIPLE_SLASH.exec(text);
+        if (tripleSlash) {
+            return `triple-slash-${tripleSlash[1]}`;
+        }
+        const suppression = TS_LINE_SUPPRESSION.exec(text);
+        if (suppression) {
+            return `@ts-${suppression[1]}`;
+        }
+        const checkPragma = TS_LINE_CHECK_PRAGMA.exec(text);
+        if (checkPragma) {
+            return `@ts-${checkPragma[1]?.toLowerCase()}`;
+        }
+    }
+    else {
+        const suppression = TS_BLOCK_SUPPRESSION.exec(lastContentLine(text));
+        if (suppression) {
+            return `@ts-${suppression[1]}`;
+        }
+    }
+    const lines = contentLines(kind, text);
+    for (const rule of RULES) {
+        if (rule.blockOnly === true && kind !== "block")
+            continue;
+        const candidates = rule.anyLine === true ? lines : lines.slice(0, 1);
+        for (const line of candidates) {
+            const match = rule.pattern.exec(line);
+            if (!match)
+                continue;
+            if (typeof rule.name === "string")
+                return rule.name;
+            if (typeof rule.name === "function")
+                return rule.name(match);
+            return match[0];
+        }
+    }
+    return undefined;
+}
+/**
+ * True for license/legal comments (`/*!`, `@license`, `@preserve`, `@copyright`)
+ * that build tools conventionally keep when stripping comments.
+ */
+export function isLegalComment(text) {
+    if (text.startsWith("/*!") || text.startsWith("//!"))
+        return true;
+    return /@(?:license|preserve|copyright)\b/i.test(text);
+}
+/**
+ * Non-empty content lines of the comment, with comment markers stripped.
+ * For line comments only the `//` marker itself is removed: extra slashes or
+ * stars are content, so `//// @ts-ignore` and `// * prettier-ignore` stay
+ * ordinary. JSDoc-style `*` prefixes are stripped for block comments only.
+ */
+function contentLines(kind, text) {
+    const inner = kind === "line" ? text.replace(/^\/\//, "") : text.replace(/^\/\*+/, "").replace(/\*+\/\s*$/, "");
+    const lines = [];
+    for (const line of inner.split(/\r?\n/)) {
+        const stripped = (kind === "block" ? line.replace(/^\s*\*+\s*/, "") : line).trim();
+        if (stripped !== "")
+            lines.push(stripped);
+    }
+    return lines;
+}
+/** Last non-blank line of the comment, with the closing comment marker stripped. */
+function lastContentLine(text) {
+    const inner = text.replace(/\*+\/\s*$/, "");
+    const lines = inner.split(/\r?\n/);
+    for (let index = lines.length - 1; index >= 0; index -= 1) {
+        const line = lines[index] ?? "";
+        if (line.trim() !== "")
+            return line;
+    }
+    return "";
+}
+//# sourceMappingURL=directives.js.map

package/dist/directives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives.js","sourceRoot":"","sources":["../src/directives.ts"],"names":[],"mappings":"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"}

package/dist/files.d.ts

@@ -1,9 +1,21 @@
 import type { FileScanResult } from "./types.js";
 export interface CollectOptions {
+    /** File extensions to include (with or without a leading dot, case-insensitive). */
     extensions?: string[];
+    /** Directory names that are never traversed. Default: node_modules, .git */
     ignoreDirs?: string[];
+    /**
+     * Glob patterns for files and directories to skip (picomatch syntax).
+     * Patterns without a slash match against base names, e.g. `*.test.ts`.
+     * Explicitly listed input files bypass these patterns.
+     */
+    ignore?: string[];
 }
 export declare function collectFiles(inputs: string[], options?: CollectOptions): Promise<string[]>;
+export declare function isJsxFile(file: string): boolean;
 export declare function scanFile(file: string): Promise<FileScanResult>;
 export declare function scanPaths(inputs: string[], options?: CollectOptions): Promise<FileScanResult[]>;
+export declare const FILE_CONCURRENCY = 16;
+/** Concurrency-limited map that keeps input order and starts work as slots free up. */
+export declare function mapLimit<T, R>(items: readonly T[], limit: number, fn: (item: T) => Promise<R>): Promise<R[]>;
 //# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBpG;AAmBD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAGpE;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAGzG"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAID,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA2BpG;AA2ED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG/C;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAMpE;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAGzG;AAED,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,uFAAuF;AACvF,wBAAsB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAclH"}