ts-repo-utils 5.3.0 → 6.0.1

package/README.md

@@ -15,6 +15,182 @@ A comprehensive toolkit for managing TypeScript projects with strict ESM support
 npm install ts-repo-utils
 ```
 
+## CLI Commands
+
+`ts-repo-utils` provides several CLI commands that can be used directly or through npm scripts.
+
+### `gen-index-ts`
+
+Generates index.ts files recursively in target directories with automatic barrel exports.
+
+```bash
+# Basic usage with required options
+npm exec -- gen-index-ts ./src --target-ext .mts --index-ext .mts --export-ext .mjs
+
+# With formatting command
+npm exec -- gen-index-ts ./src --target-ext .mts --index-ext .mts --export-ext .mjs --fmt 'npm run fmt'
+
+# Multiple target extensions
+npm exec -- gen-index-ts ./src --target-ext .mts --target-ext .tsx --index-ext .mts --export-ext .mjs
+
+# With exclude patterns
+npm exec -- gen-index-ts ./src --target-ext .ts --index-ext .ts --export-ext .js --exclude '*.test.ts' --exclude '*.spec.ts'
+
+# Example in npm scripts
+"gi": "gen-index-ts ./src --index-ext .mts --export-ext .mjs --target-ext .mts --target-ext .tsx --fmt 'npm run fmt'"
+```
+
+**Options:**
+
+- `<target-directory>` - Directory where the index file will be generated (comma-separated list can be used)
+- `--target-ext` - File extensions to include in the index file (required, can be specified multiple times)
+- `--index-ext` - Extension of the index file to be generated (required)
+- `--export-ext` - Extension of the export statements in the index file (required, or 'none')
+- `--exclude` - Glob patterns of files to exclude (optional, can be specified multiple times)
+- `--fmt` - Command to format after generating the index file (optional)
+- `--silent` - Suppress output messages (optional)
+
+### `assert-repo-is-clean`
+
+Checks if repository is clean and exits with code 1 if it has uncommitted changes.
+
+```bash
+# Basic usage
+npm exec -- assert-repo-is-clean
+
+# Silent mode
+npm exec -- assert-repo-is-clean --silent
+```
+
+```yaml
+# Example in GitHub Actions
+- name: Check if there is no file diff
+  run: npm exec -- assert-repo-is-clean
+```
+
+**Options:**
+
+- `--silent` - Suppress output messages (optional)
+
+### `format-untracked`
+
+Formats only untracked/modified files using Prettier.
+
+```bash
+# Basic usage
+npm exec -- format-untracked
+
+# Silent mode
+npm exec -- format-untracked --silent
+```
+
+**Options:**
+
+- `--silent` - Suppress output messages (optional)
+
+### `format-diff-from`
+
+Formats only files that differ from the specified base branch or commit.
+
+```bash
+# Format files different from main branch
+npm exec -- format-diff-from main
+
+# Format files different from origin/main
+npm exec -- format-diff-from origin/main
+
+# Exclude untracked files
+npm exec -- format-diff-from main --exclude-untracked
+
+# Silent mode
+npm exec -- format-diff-from main --silent
+
+# Example in npm scripts
+"fmt": "format-diff-from origin/main"
+```
+
+**Options:**
+
+- `<base>` - Base branch name or commit hash to compare against (required)
+- `--include-untracked` - Include untracked files in addition to diff files (default: true)
+- `--exclude-untracked` - Exclude untracked files, only format diff files (optional)
+- `--silent` - Suppress output messages (optional)
+
+### `check-should-run-type-checks`
+
+Checks if TypeScript type checks should run based on the diff from a base branch. Optimizes CI/CD pipelines by skipping type checks when only non-TypeScript files are changed.
+
+```bash
+# Basic usage (compares against origin/main)
+npm exec -- check-should-run-type-checks
+
+# Custom base branch
+npm exec -- check-should-run-type-checks --base-branch origin/develop
+
+# Custom ignore patterns
+npm exec -- check-should-run-type-checks \
+  --paths-ignore '.github/' \
+  --paths-ignore 'docs/' \
+  --paths-ignore '**.md' \
+  --paths-ignore '**.yml'
+```
+
+```yaml
+# Example in GitHub Actions
+- name: Check if type checks should run
+  id: check_diff
+  run: npm exec -- check-should-run-type-checks
+
+- name: Run type checks
+  if: steps.check_diff.outputs.should_run == 'true'
+  run: npm run type-check
+```
+
+**Options:**
+
+- `--paths-ignore` - Patterns to ignore when checking if type checks should run (optional, can be specified multiple times)
+    - Supports exact file matches: `.cspell.json`
+    - Directory prefixes: `docs/` (matches any file in docs directory)
+    - File extensions: `**.md` (matches any markdown file)
+    - Default: `['LICENSE', '.editorconfig', '.gitignore', '.cspell.json', '.markdownlint-cli2.mjs', '.npmignore', '.prettierignore', '.prettierrc', 'docs/', '**.md', '**.txt']`
+- `--base-branch` - Base branch to compare against for determining changed files (default: `origin/main`)
+
+**GitHub Actions Integration:**
+
+When running in GitHub Actions, the command sets the `GITHUB_OUTPUT` environment variable with `should_run=true` or `should_run=false`, which can be used in subsequent steps.
+
+### Usage in npm scripts
+
+The CLI commands are commonly used in npm scripts for automation:
+
+```json
+{
+    "scripts": {
+        "fmt": "format-diff-from origin/main",
+        "gi": "gen-index-ts ./src --index-ext .mts --export-ext .mjs --target-ext .mts --target-ext .tsx --fmt 'npm run fmt'",
+        "check:clean": "assert-repo-is-clean"
+    }
+}
+```
+
+### Usage in CI/CD
+
+These commands are particularly useful in CI/CD pipelines:
+
+```yaml
+# GitHub Actions example
+- name: Format check
+  run: |
+      npm run fmt
+      npm exec -- assert-repo-is-clean
+
+# Check for uncommitted changes after build
+- name: Build
+  run: npm run build
+- name: Check if there is no file diff
+  run: npm exec -- assert-repo-is-clean
+```
+
 ## API Reference
 
 ### Path and File System Utilities

package/dist/cmd/assert-repo-is-clean.d.mts

@@ -0,0 +1,3 @@
+#!/usr/bin/env -S npx tsx
+export {};
+//# sourceMappingURL=assert-repo-is-clean.d.mts.map

package/dist/cmd/assert-repo-is-clean.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-repo-is-clean.d.mts","sourceRoot":"","sources":["../../src/cmd/assert-repo-is-clean.mts"],"names":[],"mappings":""}

package/dist/cmd/assert-repo-is-clean.mjs

@@ -0,0 +1,32 @@
+#!/usr/bin/env -S npx tsx
+import 'child_process';
+import * as cmd from 'cmd-ts';
+import 'micromatch';
+import 'node:child_process';
+import 'prettier';
+import 'ts-data-forge';
+import { assertRepoIsClean } from '../functions/assert-repo-is-clean.mjs';
+import '../node-global.mjs';
+
+const cmdDef = cmd.command({
+  name: 'assert-repo-is-clean-cli',
+  version: '6.0.1',
+  args: {
+    silent: cmd.flag({
+      long: 'silent',
+      type: cmd.optional(cmd.boolean),
+      description: 'If true, suppresses output messages (default: false)',
+    }),
+  },
+  handler: (args) => {
+    main(args).catch((error) => {
+      console.error('An error occurred:', error);
+      process.exit(1);
+    });
+  },
+});
+const main = async (args) => {
+  await assertRepoIsClean({ silent: args.silent });
+};
+await cmd.run(cmdDef, process.argv.slice(2));
+//# sourceMappingURL=assert-repo-is-clean.mjs.map

package/dist/cmd/assert-repo-is-clean.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-repo-is-clean.mjs","sources":["../../src/cmd/assert-repo-is-clean.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;AAKA,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC;AACzB,IAAA,IAAI,EAAE,0BAA0B;AAChC,IAAA,OAAO,EAAE,OAAO;AAChB,IAAA,IAAI,EAAE;AACJ,QAAA,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC;AACf,YAAA,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AAC/B,YAAA,WAAW,EAAE,sDAAsD;SACpE,CAAC;AACH,KAAA;AACD,IAAA,OAAO,EAAE,CAAC,IAAI,KAAI;QAChB,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,KAAI;AACzB,YAAA,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC;AAC1C,YAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACjB,QAAA,CAAC,CAAC;IACJ,CAAC;AACF,CAAA,CAAC;AAEF,MAAM,IAAI,GAAG,OAAO,IAAoC,KAAmB;IACzE,MAAM,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC"}

package/dist/cmd/check-should-run-type-checks.d.mts

@@ -0,0 +1,3 @@
+#!/usr/bin/env -S npx tsx
+export {};
+//# sourceMappingURL=check-should-run-type-checks.d.mts.map

package/dist/cmd/check-should-run-type-checks.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-should-run-type-checks.d.mts","sourceRoot":"","sources":["../../src/cmd/check-should-run-type-checks.mts"],"names":[],"mappings":""}

package/dist/cmd/check-should-run-type-checks.mjs

@@ -0,0 +1,42 @@
+#!/usr/bin/env -S npx tsx
+import 'child_process';
+import * as cmd from 'cmd-ts';
+import 'micromatch';
+import 'node:child_process';
+import 'prettier';
+import 'ts-data-forge';
+import { checkShouldRunTypeChecks } from '../functions/should-run.mjs';
+import '../node-global.mjs';
+
+const cmdDef = cmd.command({
+  name: 'check-should-run-type-checks-cli',
+  version: '6.0.1',
+  args: {
+    pathsIgnore: cmd.multioption({
+      long: 'paths-ignore',
+      type: cmd.optional(cmd.array(cmd.string)),
+      description:
+        'Patterns to ignore when checking if type checks should run. Supports exact file matches, directory prefixes (ending with "/"), and file extensions (starting with "**.")',
+    }),
+    baseBranch: cmd.option({
+      long: 'base-branch',
+      type: cmd.optional(cmd.string),
+      description:
+        'Base branch to compare against for determining changed files. Defaults to "origin/main"',
+    }),
+  },
+  handler: (args) => {
+    main(args).catch((error) => {
+      console.error('An error occurred:', error);
+      process.exit(1);
+    });
+  },
+});
+const main = async (args) => {
+  await checkShouldRunTypeChecks({
+    pathsIgnore: args.pathsIgnore,
+    baseBranch: args.baseBranch,
+  });
+};
+await cmd.run(cmdDef, process.argv.slice(2));
+//# sourceMappingURL=check-should-run-type-checks.mjs.map

package/dist/cmd/check-should-run-type-checks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-should-run-type-checks.mjs","sources":["../../src/cmd/check-should-run-type-checks.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;AAKA,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC;AACzB,IAAA,IAAI,EAAE,kCAAkC;AACxC,IAAA,OAAO,EAAE,OAAO;AAChB,IAAA,IAAI,EAAE;AACJ,QAAA,WAAW,EAAE,GAAG,CAAC,WAAW,CAAC;AAC3B,YAAA,IAAI,EAAE,cAAc;AACpB,YAAA,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACzC,YAAA,WAAW,EACT,0KAA0K;SAC7K,CAAC;AACF,QAAA,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC;AACrB,YAAA,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;AAC9B,YAAA,WAAW,EACT,yFAAyF;SAC5F,CAAC;AACH,KAAA;AACD,IAAA,OAAO,EAAE,CAAC,IAAI,KAAI;QAChB,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,KAAI;AACzB,YAAA,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC;AAC1C,YAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACjB,QAAA,CAAC,CAAC;IACJ,CAAC;AACF,CAAA,CAAC;AAEF,MAAM,IAAI,GAAG,OACX,IAGE,KACe;AACjB,IAAA,MAAM,wBAAwB,CAAC;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;AAC5B,KAAA,CAAC;AACJ,CAAC;AAED,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC"}

package/dist/cmd/format-diff-from.d.mts

@@ -0,0 +1,3 @@
+#!/usr/bin/env -S npx tsx
+export {};
+//# sourceMappingURL=format-diff-from.d.mts.map

package/dist/cmd/format-diff-from.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-diff-from.d.mts","sourceRoot":"","sources":["../../src/cmd/format-diff-from.mts"],"names":[],"mappings":""}

package/dist/cmd/format-diff-from.mjs

@@ -0,0 +1,45 @@
+#!/usr/bin/env -S npx tsx
+import 'child_process';
+import * as cmd from 'cmd-ts';
+import 'micromatch';
+import 'node:child_process';
+import 'ts-data-forge';
+import { formatDiffFrom } from '../functions/format.mjs';
+import '../node-global.mjs';
+
+const cmdDef = cmd.command({
+  name: 'format-diff-from-cli',
+  version: '6.0.1',
+  args: {
+    base: cmd.positional({
+      type: cmd.string,
+      displayName: 'base',
+      description: 'Base branch name or commit hash to compare against',
+    }),
+    includeUntracked: cmd.flag({
+      long: 'include-untracked',
+      type: cmd.optional(cmd.boolean),
+      description:
+        'Include untracked files in addition to diff files (default: true)',
+    }),
+    silent: cmd.flag({
+      long: 'silent',
+      type: cmd.optional(cmd.boolean),
+      description: 'If true, suppresses output messages (default: false)',
+    }),
+  },
+  handler: (args) => {
+    main(args).catch((error) => {
+      console.error('An error occurred:', error);
+      process.exit(1);
+    });
+  },
+});
+const main = async (args) => {
+  const result = await formatDiffFrom(args.base, args);
+  if (result === 'err') {
+    process.exit(1);
+  }
+};
+await cmd.run(cmdDef, process.argv.slice(2));
+//# sourceMappingURL=format-diff-from.mjs.map

package/dist/cmd/format-diff-from.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-diff-from.mjs","sources":["../../src/cmd/format-diff-from.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;AAKA,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC;AACzB,IAAA,IAAI,EAAE,sBAAsB;AAC5B,IAAA,OAAO,EAAE,OAAO;AAChB,IAAA,IAAI,EAAE;AACJ,QAAA,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC;YACnB,IAAI,EAAE,GAAG,CAAC,MAAM;AAChB,YAAA,WAAW,EAAE,MAAM;AACnB,YAAA,WAAW,EAAE,oDAAoD;SAClE,CAAC;AACF,QAAA,gBAAgB,EAAE,GAAG,CAAC,IAAI,CAAC;AACzB,YAAA,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AAC/B,YAAA,WAAW,EACT,mEAAmE;SACtE,CAAC;AACF,QAAA,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC;AACf,YAAA,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AAC/B,YAAA,WAAW,EAAE,sDAAsD;SACpE,CAAC;AACH,KAAA;AACD,IAAA,OAAO,EAAE,CAAC,IAAI,KAAI;QAChB,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,KAAI;AACzB,YAAA,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC;AAC1C,YAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACjB,QAAA,CAAC,CAAC;IACJ,CAAC;AACF,CAAA,CAAC;AAEF,MAAM,IAAI,GAAG,OACX,IAIE,KACe;IACjB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;AAEpD,IAAA,IAAI,MAAM,KAAK,KAAK,EAAE;AACpB,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;AACF,CAAC;AAED,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC"}

package/dist/cmd/format-untracked.d.mts

@@ -0,0 +1,3 @@
+#!/usr/bin/env -S npx tsx
+export {};
+//# sourceMappingURL=format-untracked.d.mts.map

package/dist/cmd/format-untracked.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-untracked.d.mts","sourceRoot":"","sources":["../../src/cmd/format-untracked.mts"],"names":[],"mappings":""}

package/dist/cmd/format-untracked.mjs

@@ -0,0 +1,34 @@
+#!/usr/bin/env -S npx tsx
+import 'child_process';
+import * as cmd from 'cmd-ts';
+import 'micromatch';
+import 'node:child_process';
+import 'ts-data-forge';
+import { formatUntracked } from '../functions/format.mjs';
+import '../node-global.mjs';
+
+const cmdDef = cmd.command({
+  name: 'format-untracked-cli',
+  version: '6.0.1',
+  args: {
+    silent: cmd.flag({
+      long: 'silent',
+      type: cmd.optional(cmd.boolean),
+      description: 'If true, suppresses output messages (default: false)',
+    }),
+  },
+  handler: (args) => {
+    main(args).catch((error) => {
+      console.error('An error occurred:', error);
+      process.exit(1);
+    });
+  },
+});
+const main = async (args) => {
+  const result = await formatUntracked({ silent: args.silent });
+  if (result === 'err') {
+    process.exit(1);
+  }
+};
+await cmd.run(cmdDef, process.argv.slice(2));
+//# sourceMappingURL=format-untracked.mjs.map

package/dist/cmd/format-untracked.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-untracked.mjs","sources":["../../src/cmd/format-untracked.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;AAKA,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC;AACzB,IAAA,IAAI,EAAE,sBAAsB;AAC5B,IAAA,OAAO,EAAE,OAAO;AAChB,IAAA,IAAI,EAAE;AACJ,QAAA,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC;AACf,YAAA,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AAC/B,YAAA,WAAW,EAAE,sDAAsD;SACpE,CAAC;AACH,KAAA;AACD,IAAA,OAAO,EAAE,CAAC,IAAI,KAAI;QAChB,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,KAAI;AACzB,YAAA,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC;AAC1C,YAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACjB,QAAA,CAAC,CAAC;IACJ,CAAC;AACF,CAAA,CAAC;AAEF,MAAM,IAAI,GAAG,OAAO,IAAoC,KAAmB;AACzE,IAAA,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AAC7D,IAAA,IAAI,MAAM,KAAK,KAAK,EAAE;AACpB,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;AACF,CAAC;AAED,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC"}

package/dist/cmd/gen-index-ts.d.mts

@@ -0,0 +1,3 @@
+#!/usr/bin/env -S npx tsx
+export {};
+//# sourceMappingURL=gen-index-ts.d.mts.map

package/dist/cmd/gen-index-ts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gen-index-ts.d.mts","sourceRoot":"","sources":["../../src/cmd/gen-index-ts.mts"],"names":[],"mappings":""}

package/dist/cmd/gen-index-ts.mjs

@@ -0,0 +1,119 @@
+#!/usr/bin/env -S npx tsx
+import 'child_process';
+import * as cmd from 'cmd-ts';
+import 'node:child_process';
+import 'prettier';
+import 'ts-data-forge';
+import { genIndex } from '../functions/gen-index.mjs';
+import '../node-global.mjs';
+
+const extensionType = cmd.extendType(cmd.string, {
+  from: (s) => {
+    if (!s.startsWith('.')) {
+      throw new Error(`ext should start with '.'`);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    return Promise.resolve(s);
+  },
+});
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const nonEmptyArray = (t, commandName) =>
+  cmd.extendType(cmd.array(t), {
+    from: (arr) => {
+      if (arr.length === 0) {
+        throw new Error(
+          `No value provided for --${commandName}. At least one value is required.`,
+        );
+      }
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+      return Promise.resolve(arr);
+    },
+  });
+const cmdDef = cmd.command({
+  name: 'gen-index-ts-cli',
+  version: '6.0.1',
+  args: {
+    // required args
+    targetDirectory: cmd.positional({
+      type: cmd.string,
+      displayName: 'target-directory',
+      description:
+        'Directory where the index file will be generated  (Comma-separated list can be used)',
+    }),
+    targetExtensions: cmd.multioption({
+      long: 'target-ext',
+      type: nonEmptyArray(extensionType, 'target-ext'),
+      description: 'File extensions to include in the index file',
+    }),
+    indexFileExtension: cmd.option({
+      long: 'index-ext',
+      type: extensionType,
+      description: 'Extension of the index file to be generated',
+    }),
+    exportStatementExtension: cmd.option({
+      long: 'export-ext',
+      type: cmd.union([
+        extensionType,
+        cmd.extendType(cmd.string, {
+          from: (s) => {
+            if (s !== 'none') {
+              throw new Error(
+                `export-ext should be 'none' or a valid extension`,
+              );
+            }
+            return Promise.resolve('none');
+          },
+        }),
+      ]),
+      description: 'Extension of the export statements in the index file',
+    }),
+    // optional args
+    exclude: cmd.multioption({
+      long: 'exclude',
+      type: cmd.optional(cmd.array(cmd.string)),
+      description:
+        'Glob patterns of files to exclude from the index file (e.g., "*.d.mts", "*.test.mts")',
+    }),
+    formatCommand: cmd.option({
+      long: 'fmt',
+      type: cmd.optional(cmd.string),
+      description:
+        'Command to format after generating the index file (e.g., "npm run fmt")',
+    }),
+    silent: cmd.flag({
+      long: 'silent',
+      type: cmd.optional(cmd.boolean),
+      description: 'If true, suppresses output messages (default: false)',
+    }),
+  },
+  handler: (args) => {
+    console.log(args);
+    main(args).catch((error) => {
+      console.error('An error occurred:', error);
+      process.exit(1);
+    });
+  },
+});
+const main = async ({
+  targetDirectory,
+  targetExtensions,
+  exportStatementExtension,
+  indexFileExtension,
+  exclude,
+  formatCommand,
+  silent,
+}) => {
+  await genIndex({
+    targetDirectory: targetDirectory.includes(',')
+      ? targetDirectory.split(',').map((dir) => dir.trim())
+      : targetDirectory,
+    exportStatementExtension,
+    targetExtensions,
+    exclude,
+    indexFileExtension,
+    formatCommand,
+    silent,
+  });
+};
+await cmd.run(cmdDef, process.argv.slice(2));
+//# sourceMappingURL=gen-index-ts.mjs.map

package/dist/cmd/gen-index-ts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gen-index-ts.mjs","sources":["../../src/cmd/gen-index-ts.mts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/functions/format.mjs

@@ -1,7 +1,7 @@
 import * as prettier from 'prettier';
 import { Result, Arr } from 'ts-data-forge';
 import '../node-global.mjs';
-import { getUntrackedFiles, getDiffFrom } from './diff.mjs';
+import { getDiffFrom, getUntrackedFiles } from './diff.mjs';
 
 /**
  * Format a list of files using Prettier

package/dist/functions/gen-index.d.mts

@@ -5,26 +5,20 @@ export type GenIndexConfig = DeepReadonly<{
     targetDirectory: string | readonly string[];
     /**
      * Glob patterns of files or predicate function to exclude from exports
-     * (default: excludes `'**\/*.{test,spec}.?(c|m)[jt]s?(x)'`)
+     * (default: excludes `'**\/*.{test,spec}.?(c|m)[jt]s?(x)'` and
+     * `'**\/*.d.?(c|m)ts'`)
      */
     exclude?: readonly string[] | ((args: Readonly<{
         absolutePath: string;
         relativePath: string;
         fileName: string;
     }>) => boolean);
-    /**
-     * Glob patterns of files or predicate function to exclude from exports
-     * (default: excludes `'**\/*.{test,spec}.?(c|m)[jt]s?(x)'`)
-     *
-     * @deprecated Use `exclude` instead.
-     */
-    excludePatterns?: readonly string[];
     /** File extensions of source files to export (default: ['.ts', '.tsx']) */
-    sourceExtensions?: readonly `.${string}`[];
+    targetExtensions?: readonly `.${string}`[];
     /** File extension of index files to generate (default: '.ts') */
-    indexExtension?: `.${string}`;
+    indexFileExtension?: `.${string}`;
     /** File extension to use in export statements (default: '.js') */
-    exportExtension?: `.${string}` | 'none';
+    exportStatementExtension?: `.${string}` | 'none';
     /** Command to run for formatting generated files (optional) */
     formatCommand?: string;
     /** Whether to suppress output during execution (default: false) */

package/dist/functions/gen-index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"gen-index.d.mts","sourceRoot":"","sources":["../../src/functions/gen-index.mts"],"names":[],"mappings":"AAEA,OAAO,oBAAoB,CAAC;AAG5B,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC;IACxC,kFAAkF;IAClF,eAAe,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAE5C;;;OAGG;IACH,OAAO,CAAC,EACJ,SAAS,MAAM,EAAE,GACjB,CAAC,CACC,IAAI,EAAE,QAAQ,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,KACC,OAAO,CAAC,CAAC;IAElB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEpC,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,SAAS,IAAI,MAAM,EAAE,EAAE,CAAC;IAE3C,iEAAiE;IACjE,cAAc,CAAC,EAAE,IAAI,MAAM,EAAE,CAAC;IAE9B,kEAAkE;IAClE,eAAe,CAAC,EAAE,IAAI,MAAM,EAAE,GAAG,MAAM,CAAC;IAExC,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC,CAAC;AAkBH;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAU,QAAQ,cAAc,KAAG,OAAO,CAAC,IAAI,CA8CnE,CAAC"}
+{"version":3,"file":"gen-index.d.mts","sourceRoot":"","sources":["../../src/functions/gen-index.mts"],"names":[],"mappings":"AAEA,OAAO,oBAAoB,CAAC;AAG5B,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC;IACxC,kFAAkF;IAClF,eAAe,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAE5C;;;;OAIG;IACH,OAAO,CAAC,EACJ,SAAS,MAAM,EAAE,GACjB,CAAC,CACC,IAAI,EAAE,QAAQ,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,KACC,OAAO,CAAC,CAAC;IAElB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,SAAS,IAAI,MAAM,EAAE,EAAE,CAAC;IAE3C,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,IAAI,MAAM,EAAE,CAAC;IAElC,kEAAkE;IAClE,wBAAwB,CAAC,EAAE,IAAI,MAAM,EAAE,GAAG,MAAM,CAAC;IAEjD,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC,CAAC;AA4BH;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAU,QAAQ,cAAc,KAAG,OAAO,CAAC,IAAI,CA8CnE,CAAC"}