ts-repo-utils 5.2.1 → 6.0.0

package/README.md

@@ -15,6 +15,139 @@ 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
+npx gen-index-ts ./src --target-ext .mts --index-ext .mts --export-ext .mjs
+
+# With formatting command
+npx gen-index-ts ./src --target-ext .mts --index-ext .mts --export-ext .mjs --fmt 'npm run fmt'
+
+# Multiple target extensions
+npx gen-index-ts ./src --target-ext .mts --target-ext .tsx --index-ext .mts --export-ext .mjs
+
+# With exclude patterns
+npx 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/functions --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
+npx assert-repo-is-clean
+
+# Silent mode
+npx assert-repo-is-clean --silent
+```
+
+```yaml
+# Example in GitHub Actions
+- name: Check if there is no file diff
+  run: npx tsx ./src/cmd/assert-repo-is-clean.mts
+```
+
+**Options:**
+
+- `--silent` - Suppress output messages (optional)
+
+### `format-untracked`
+
+Formats only untracked/modified files using Prettier.
+
+```bash
+# Basic usage
+npx format-untracked
+
+# Silent mode
+npx 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
+npx format-diff-from main
+
+# Format files different from origin/main
+npx format-diff-from origin/main
+
+# Exclude untracked files
+npx format-diff-from main --exclude-untracked
+
+# Silent mode
+npx 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)
+
+### 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/functions --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
+      npx 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: npx tsx ./src/cmd/assert-repo-is-clean.mts
+```
+
 ## 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 * as cmd from 'cmd-ts';
+import 'ts-data-forge';
+import '../node-global.mjs';
+import { assertRepoIsClean } from '../functions/assert-repo-is-clean.mjs';
+import 'node:child_process';
+import 'prettier';
+import 'micromatch';
+import 'child_process';
+
+const cmdDef = cmd.command({
+    name: 'assert-repo-is-clean-cli',
+    version: '6.0.0',
+    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,40 @@
+#!/usr/bin/env -S npx tsx
+import * as cmd from 'cmd-ts';
+import 'ts-data-forge';
+import '../node-global.mjs';
+import 'node:child_process';
+import 'prettier';
+import 'micromatch';
+import { checkShouldRunTypeChecks } from '../functions/should-run.mjs';
+import 'child_process';
+
+const cmdDef = cmd.command({
+    name: 'check-should-run-type-checks-cli',
+    version: '6.0.0',
+    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,44 @@
+#!/usr/bin/env -S npx tsx
+import * as cmd from 'cmd-ts';
+import 'ts-data-forge';
+import '../node-global.mjs';
+import 'node:child_process';
+import { formatDiffFrom } from '../functions/format.mjs';
+import 'micromatch';
+import 'child_process';
+
+const cmdDef = cmd.command({
+    name: 'format-diff-from-cli',
+    version: '6.0.0',
+    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 * as cmd from 'cmd-ts';
+import 'ts-data-forge';
+import '../node-global.mjs';
+import 'node:child_process';
+import { formatUntracked } from '../functions/format.mjs';
+import 'micromatch';
+import 'child_process';
+
+const cmdDef = cmd.command({
+    name: 'format-untracked-cli',
+    version: '6.0.0',
+    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,103 @@
+#!/usr/bin/env -S npx tsx
+import * as cmd from 'cmd-ts';
+import 'ts-data-forge';
+import '../node-global.mjs';
+import 'node:child_process';
+import 'prettier';
+import { genIndex } from '../functions/gen-index.mjs';
+import 'child_process';
+
+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.0',
+    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/exec-async.d.mts

@@ -1,17 +1,26 @@
-import { type ExecException } from 'node:child_process';
+import { type ExecException, type ExecOptions as ExecOptions_ } from 'node:child_process';
 import { Result } from 'ts-data-forge';
+type ExecOptionsCustom = Readonly<{
+    silent?: boolean;
+}>;
+type ExecOptions = DeepReadonly<ExecOptions_ & ExecOptionsCustom>;
+type ExecResult<T extends string | Buffer> = Result<Readonly<{
+    stdout: T;
+    stderr: T;
+}>, ExecException>;
 /**
  * Executes a shell command asynchronously.
  *
- * @param cmd - The command to execute.
+ * @param command - The command to execute.
  * @param options - Optional configuration for command execution.
  * @returns A promise that resolves with the command result.
  */
-export declare const $: (cmd: string, options?: Readonly<{
-    silent?: boolean;
-    timeout?: number;
-}>) => Promise<Result<Readonly<{
-    stdout: string;
-    stderr: string;
-}>, ExecException>>;
+export declare function $(command: string, options?: ExecOptionsCustom): Promise<ExecResult<string>>;
+export declare function $(command: string, options: Readonly<{
+    encoding: 'buffer' | null;
+} & ExecOptions>): Promise<ExecResult<Buffer>>;
+export declare function $(command: string, options: Readonly<{
+    encoding: BufferEncoding;
+} & ExecOptions>): Promise<ExecResult<string>>;
+export {};
 //# sourceMappingURL=exec-async.d.mts.map

package/dist/functions/exec-async.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"exec-async.d.mts","sourceRoot":"","sources":["../../src/functions/exec-async.mts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC;;;;;;GAMG;AACH,eAAO,MAAM,CAAC,GACZ,KAAK,MAAM,EACX,UAAS,QAAQ,CAAC;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAM,KAC7D,OAAO,CACR,MAAM,CAAC,QAAQ,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,aAAa,CAAC,CA6BpE,CAAC"}
+{"version":3,"file":"exec-async.d.mts","sourceRoot":"","sources":["../../src/functions/exec-async.mts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,WAAW,IAAI,YAAY,EACjC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,KAAK,iBAAiB,GAAG,QAAQ,CAAC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC,CAAC;AAEH,KAAK,WAAW,GAAG,YAAY,CAAC,YAAY,GAAG,iBAAiB,CAAC,CAAC;AAElE,KAAK,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,MAAM,CACjD,QAAQ,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC,EAClC,aAAa,CACd,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,CAAC,CACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAE/B,wBAAgB,CAAC,CACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,QAAQ,CAAC;IAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;CAAE,GAAG,WAAW,CAAC,GAC7D,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAE/B,wBAAgB,CAAC,CACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,QAAQ,CAAC;IAAE,QAAQ,EAAE,cAAc,CAAA;CAAE,GAAG,WAAW,CAAC,GAC5D,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/functions/exec-async.mjs

@@ -1,22 +1,16 @@
 import { exec } from 'node:child_process';
 import { Result } from 'ts-data-forge';
 
-/**
- * Executes a shell command asynchronously.
- *
- * @param cmd - The command to execute.
- * @param options - Optional configuration for command execution.
- * @returns A promise that resolves with the command result.
- */
-const $ = (cmd, options = {}) => {
-    const { silent = false, timeout = 30000 } = options;
+function $(command, options) {
+    const { silent = false, ...restOptions } = options ?? {};
     if (!silent) {
-        echo(`$ ${cmd}`);
+        echo(`$ ${command}`);
     }
     return new Promise((resolve) => {
-        const execOptions = { timeout };
         // eslint-disable-next-line security/detect-child-process
-        exec(cmd, execOptions, (error, stdout, stderr) => {
+        exec(command, 
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        restOptions, (error, stdout, stderr) => {
             if (!silent) {
                 if (stdout !== '') {
                     echo(stdout);
@@ -33,7 +27,7 @@ const $ = (cmd, options = {}) => {
             }
         });
     });
-};
+}
 
 export { $ };
 //# sourceMappingURL=exec-async.mjs.map

package/dist/functions/exec-async.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"exec-async.mjs","sources":["../../src/functions/exec-async.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AAGA;;;;;;AAMG;AACI,MAAM,CAAC,GAAG,CACf,GAAW,EACX,OAAA,GAA4D,EAAE,KAG5D;IACF,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,OAAO;IAEnD,IAAI,CAAC,MAAM,EAAE;AACX,QAAA,IAAI,CAAC,CAAA,EAAA,EAAK,GAAG,CAAA,CAAE,CAAC;IAClB;AAEA,IAAA,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,KAAI;AAC7B,QAAA,MAAM,WAAW,GAAG,EAAE,OAAO,EAAE;;AAG/B,QAAA,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,KAAI;YAC/C,IAAI,CAAC,MAAM,EAAE;AACX,gBAAA,IAAI,MAAM,KAAK,EAAE,EAAE;oBACjB,IAAI,CAAC,MAAM,CAAC;gBACd;AACA,gBAAA,IAAI,MAAM,KAAK,EAAE,EAAE;AACjB,oBAAA,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;gBACvB;YACF;AAEA,YAAA,IAAI,KAAK,KAAK,IAAI,EAAE;gBAClB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC5B;iBAAO;AACL,gBAAA,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACxC;AACF,QAAA,CAAC,CAAC;AACJ,IAAA,CAAC,CAAC;AACJ;;;;"}
+{"version":3,"file":"exec-async.mjs","sources":["../../src/functions/exec-async.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AAwCM,SAAU,CAAC,CACf,OAAe,EACf,OAEC,EAAA;AAED,IAAA,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,IAAI,EAAE;IAExD,IAAI,CAAC,MAAM,EAAE;AACX,QAAA,IAAI,CAAC,CAAA,EAAA,EAAK,OAAO,CAAA,CAAE,CAAC;IACtB;AAEA,IAAA,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,KAAI;;AAE7B,QAAA,IAAI,CACF,OAAO;;QAEP,WAEgB,EAChB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,KAAI;YACxB,IAAI,CAAC,MAAM,EAAE;AACX,gBAAA,IAAI,MAAM,KAAK,EAAE,EAAE;oBACjB,IAAI,CAAC,MAAM,CAAC;gBACd;AACA,gBAAA,IAAI,MAAM,KAAK,EAAE,EAAE;AACjB,oBAAA,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;gBACvB;YACF;AAEA,YAAA,IAAI,KAAK,KAAK,IAAI,EAAE;gBAClB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC5B;iBAAO;AACL,gBAAA,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACxC;AACF,QAAA,CAAC,CACF;AACH,IAAA,CAAC,CAAC;AACJ;;;;"}

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"}