ts-repo-utils 7.2.0 → 7.3.1

package/README.md

@@ -12,47 +12,24 @@ A comprehensive toolkit for managing TypeScript projects with strict ESM support
 ## Installation
 
 ```bash
-npm install ts-repo-utils
+npm add --save-dev 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'
+yarn add --dev ts-repo-utils
+```
 
-# 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'"
+```bash
+pnpm add --save-dev ts-repo-utils
 ```
 
-**Options:**
+## CLI Commands
 
-- `<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)
+`ts-repo-utils` provides several CLI commands that can be used directly or through npm scripts.
 
 ### `assert-repo-is-clean`
 
-Checks if repository is clean and exits with code 1 if it has uncommitted changes.
+Checks if the repository is clean (i.e., there are no uncommitted changes, untracked files, or staged files) and exits with code 1 if any are present.
 
 ```bash
 # Basic usage
@@ -64,6 +41,8 @@ npm exec -- assert-repo-is-clean --silent
 
 ```yaml
 # Example in GitHub Actions
+- name: Format check
+  run: npm run fmt
 - name: Check if there is no file diff
   run: npm exec -- assert-repo-is-clean
 ```
@@ -108,9 +87,16 @@ 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"
+Example in npm scripts:
+
+```json
+{
+    "scripts": {
+        "fmt": "npm exec -- format-diff-from origin/main"
+    }
+}
 ```
 
 **Options:**
@@ -122,9 +108,53 @@ npm exec -- format-diff-from main --silent
 - `--silent` - Suppress output messages (default: false)
 - `--ignore-unknown` - Skip files without a Prettier parser instead of erroring (default: true)
 
+### `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'"
+```
+
+**Features:**
+
+- Creates barrel exports for all subdirectories
+- Supports complex glob exclusion patterns (using micromatch)
+- Automatically formats generated files using the project's Prettier config
+- Works with both single directories and directory arrays
+- Respects source and export extension configuration
+
+**Benefits:**
+
+- Prevents forgetting to export modules
+- TypeScript can detect duplicate variables, type names, etc.
+
+**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)
+
 ### `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.
+Checks whether TypeScript type checks should run based on file changes from the base branch. Optimizes CI/CD pipelines by skipping type checks when only non-TypeScript files have changed. The determination of "non-TypeScript files" is based on configurable ignore patterns, which can be specified using the `--paths-ignore` option.
 
 ```bash
 # Basic usage (compares against origin/main)
@@ -165,39 +195,79 @@ npm exec -- check-should-run-type-checks \
 
 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
+## API Reference
 
-The CLI commands are commonly used in npm scripts for automation:
+### Command Execution
 
-```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"
-    }
+#### `$(command: string, options?: ExecOptions): Promise<ExecResult>`
+
+Executes a shell command asynchronously with type-safe results.
+
+```typescript
+import { $, Result } from 'ts-repo-utils';
+
+// or
+// import "ts-repo-utils"; // $ and Result are globally defined in ts-repo-utils
+
+const result = await $('npm test');
+
+if (Result.isOk(result)) {
+    console.log('Tests passed:', result.value.stdout);
+} else {
+    console.error('Tests failed:', result.value.message);
 }
 ```
 
-### Usage in CI/CD
+**Options:**
 
-These commands are particularly useful in CI/CD pipelines:
+- `silent?: boolean` - Don't log command/output (default: false)
+- `'node:child_process'` `exec` function options
 
-```yaml
-# GitHub Actions example
-- name: Format check
-  run: |
-      npm run fmt
-      npm exec -- assert-repo-is-clean
+**Return Type:**
 
-# 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
+```typescript
+type Ret = Promise<
+    Result<
+        Readonly<{ stdout: string | Buffer; stderr: string | Buffer }>,
+        import('node:child_process').ExecException
+    >
+>;
 ```
 
-## API Reference
+### Script Execution Utilities
+
+#### `isDirectlyExecuted(fileUrl: string): boolean`
+
+Determines whether a script is being executed directly via CLI or imported as a module. This is useful for creating scripts that can both be imported as libraries and executed directly.
+
+```typescript
+import { isDirectlyExecuted } from 'ts-repo-utils';
+
+// or
+// import "ts-repo-utils"; // isDirectlyExecuted is globally defined in ts-repo-utils
+
+// calculator.mjs
+export const add = (a: number, b: number): number => a + b;
+export const multiply = (a: number, b: number): number => a * b;
+
+// Only run main logic when executed directly: node calculator.mjs (or tsx calculator.mts)
+// When imported elsewhere, only the functions are available
+if (isDirectlyExecuted(import.meta.url)) {
+    console.log('Calculator CLI');
+    console.log('2 + 3 =', add(2, 3));
+    console.log('4 × 5 =', multiply(4, 5));
+}
+```
+
+When executed directly (`node calculator.mjs`), it runs the main function and prints the results. When imported (`import { add } from './calculator.mjs'`), it only provides the functions without executing the main logic.
+
+NOTE: If you use [tsx](https://www.npmjs.com/package/tsx) or [ts-node](https://www.npmjs.com/package/ts-node), run your scripts with the extension `.(m)ts` instead of `.(m)js` so that `isDirectlyExecuted` can correctly determine if the script is executed directly.
+
+**Use Cases:**
+
+- Creating CLI tools that can also be used as libraries
+- Preventing automatic execution when a file is imported
+- Running initialization code only during direct execution
 
 ### Path and File System Utilities
 
@@ -209,7 +279,7 @@ Checks if a file or directory exists at the specified path.
 import { pathExists } from 'ts-repo-utils';
 
 const exists = await pathExists('./src/index.ts');
-console.log(exists); // true or false
+console.log(exists satisfies boolean); // true or false
 ```
 
 #### `assertPathExists(filePath: string, description?: string): Promise<void>`
@@ -223,8 +293,6 @@ import { assertPathExists } from 'ts-repo-utils';
 await assertPathExists('./src/index.ts', 'Entry point file');
 ```
 
-### File Extension Validation
-
 #### `assertExt(config: CheckExtConfig): Promise<void>`
 
 Validates that all files in specified directories have the correct extensions. Exits with code 1 if any files have incorrect extensions.
@@ -250,12 +318,12 @@ await assertExt({
 **Configuration Type:**
 
 ```typescript
-type CheckExtConfig = DeepReadonly<{
-    directories: {
+type CheckExtConfig = Readonly<{
+    directories: readonly Readonly<{
         path: string; // Directory path to check
         extension: string; // Expected file extension (including the dot)
-        ignorePatterns?: string[]; // Optional glob patterns to ignore
-    }[];
+        ignorePatterns?: readonly string[]; // Optional glob patterns to ignore
+    }>[];
 }>;
 ```
 
@@ -276,7 +344,8 @@ if (isDirty) {
 
 #### `assertRepoIsClean(): Promise<void>`
 
-Checks if repository is clean and exits with code 1 if it has uncommitted changes (shows changes and diff).
+Checks if the repository is clean and exits with code 1 if it has uncommitted changes (shows changes and diff).
+(Function version of the `assert-repo-is-clean` command)
 
 ```typescript
 import { assertRepoIsClean } from 'ts-repo-utils';
@@ -293,22 +362,22 @@ await assertRepoIsClean();
 
 ##### `getUntrackedFiles(options?)`
 
-Get untracked files from the working tree (files not added to git).  
+Gets untracked files from the working tree (files not added to git).  
 Runs `git ls-files --others --exclude-standard [--deleted]`
 
 ##### `getModifiedFiles(options?)`
 
-Get modified files from the working tree (files that have been changed but not staged).  
+Gets modified files from the working tree (files that have been changed but not staged).  
 Runs `git diff --name-only [--diff-filter=d]`
 
 ##### `getStagedFiles(options?)`
 
-Get files that are staged for commit (files added with git add).  
+Gets files that are staged for commit (files added with git add).  
 Runs `git diff --staged --name-only [--diff-filter=d]`
 
 ##### `getDiffFrom(base: string, options?)`
 
-Get files that differ from the specified base branch or commit.  
+Gets files that differ from the specified base branch or commit.  
 Runs `git diff --name-only <base> [--diff-filter=d]`
 
 **Common options:**
@@ -321,87 +390,7 @@ Runs `git diff --name-only <base> [--diff-filter=d]`
 ```typescript
 type Ret = Result<
     readonly string[],
-    ExecException | Readonly<{ message: string }>
->;
-```
-
-### Build Optimization Utilities
-
-#### `checkShouldRunTypeChecks(options?): Promise<boolean>`
-
-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.
-
-```typescript
-import { checkShouldRunTypeChecks } from 'ts-repo-utils';
-
-// Use default settings (compare against origin/main)
-const shouldRun = await checkShouldRunTypeChecks();
-
-if (shouldRun) {
-    await $('npm run type-check');
-}
-
-// Custom ignore patterns and base branch
-const shouldRun = await checkShouldRunTypeChecks({
-    pathsIgnore: ['.eslintrc.json', 'docs/', '**.md', 'scripts/'],
-    baseBranch: 'origin/develop',
-});
-```
-
-**Options:**
-
-- `pathsIgnore?` - Patterns to ignore when checking if type checks should run:
-    - 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']`
-- `baseBranch?` - Base branch to compare against (default: `origin/main`)
-
-**GitHub Actions Integration:**
-
-When running in GitHub Actions, sets `GITHUB_OUTPUT` with `should_run=true/false`:
-
-```yaml
-- name: Check if type checks should run
-  id: check_diff
-  run: npx check-should-run-type-checks
-
-- name: Run type checks
-  if: steps.check_diff.outputs.should_run == 'true'
-  run: npm run type-check
-```
-
-### Command Execution
-
-#### `$(command: string, options?: ExecOptions): Promise<ExecResult>`
-
-Executes a shell command asynchronously with timeout support and type-safe results.
-
-```typescript
-import { $ } from 'ts-repo-utils';
-
-const result = await $('npm test', { timeout: 60000 });
-
-if (result.type === 'ok') {
-    console.log('Tests passed:', result.stdout);
-} else {
-    console.error('Tests failed:', result.exception.message);
-}
-```
-
-**Options:**
-
-- `silent?: boolean` - Don't log command/output (default: false)
-- `'node:child_process'` `exec` function options
-
-**Return Type:**
-
-```typescript
-type Ret = Promise<
-    Result<
-        Readonly<{ stdout: string | Buffer; stderr: string | Buffer }>,
-        import('node:child_process').ExecException
-    >
+    import('node:child_process').ExecException | Readonly<{ message: string }>
 >;
 ```
 
@@ -409,7 +398,7 @@ type Ret = Promise<
 
 #### `formatFilesGlob(pathGlob: string, options?): Promise<Result<undefined, unknown>>`
 
-Format files matching a glob pattern using Prettier.
+Formats files matching a glob pattern using Prettier.
 
 ```typescript
 import { formatFilesGlob } from 'ts-repo-utils';
@@ -435,7 +424,8 @@ await formatFilesGlob('src/**/*.ts', {
 
 #### `formatUncommittedFiles(options?): Promise<Result>`
 
-Format only files that have been changed according to git status.
+Formats only files that have been changed according to git status.
+(Function version of the `format-uncommitted` command)
 
 ```typescript
 import { formatUncommittedFiles } from 'ts-repo-utils';
@@ -465,14 +455,17 @@ await formatUncommittedFiles({
 type Ret = Promise<
     Result<
         undefined,
-        ExecException | Readonly<{ message: string }> | readonly unknown[]
+        | import('node:child_process').ExecException
+        | Readonly<{ message: string }>
+        | readonly unknown[]
     >
 >;
 ```
 
 #### `formatDiffFrom(base: string, options?): Promise<Result>`
 
-Format only files that differ from the specified base branch or commit.
+Formats only files that differ from the specified base branch or commit.
+(Function version of the `format-diff-from` command)
 
 ```typescript
 import { formatDiffFrom } from 'ts-repo-utils';
@@ -506,26 +499,102 @@ await formatDiffFrom('main', {
 type Ret = Promise<
     Result<
         undefined,
-        ExecException | Readonly<{ message: string }> | readonly unknown[]
+        | import('node:child_process').ExecException
+        | Readonly<{ message: string }>
+        | readonly unknown[]
     >
 >;
 ```
 
-### Workspace Management Utilities
+### Index File Generation
+
+#### `genIndex(config: GenIndexConfig): Promise<Result<undefined, unknown>>`
+
+Generates index files recursively in target directories with automatic barrel exports.
+(Function version of the `gen-index-ts` command)
+
+```typescript
+import { genIndex } from 'ts-repo-utils';
+
+await genIndex({
+    targetDirectory: './src',
+    exclude: ['*.test.ts', '*.spec.ts'],
+});
+```
+
+**Configuration Type:**
+
+```typescript
+type GenIndexConfig = Readonly<{
+    /**
+     * Target directories to generate index files for (string or array of
+     * strings)
+     */
+    targetDirectory: string | readonly string[];
+
+    /**
+     * Glob patterns for files or predicate function to exclude from exports
+     * (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);
+
+    /**
+     * File extensions of source files to include in exports (default: ['.ts',
+     * '.tsx'])
+     */
+    targetExtensions?: readonly `.${string}`[];
+
+    /** File extension of index files to generate (default: '.ts') */
+    indexFileExtension?: `.${string}`;
+
+    /** File extension to use in export statements (default: '.js') */
+    exportStatementExtension?: `.${string}` | 'none';
+
+    /** Command to run for formatting generated files (optional) */
+    formatCommand?: string;
+
+    /** Whether to suppress output during execution (default: false) */
+    silent?: boolean;
+}>;
+```
+
+**Features:**
+
+- Creates barrel exports for all subdirectories
+- Supports complex glob exclusion patterns (using micromatch)
+- Automatically formats generated files using the project's Prettier config
+- Works with both single directories and directory arrays
+- Respects source and export extension configuration
+
+**Benefits:**
+
+- Prevents forgetting to export modules
+- TypeScript can detect duplicate variables, type names, etc.
+
+### Monorepo Workspace Management Utilities
 
 #### `runCmdInStagesAcrossWorkspaces(options): Promise<void>`
 
-Executes a npm script command across all workspace packages in dependency order stages. Packages are grouped into stages where each stage contains packages whose dependencies have been completed in previous stages. Uses fail-fast behavior.
+Executes an npm script command across all workspace packages in dependency order stages. Packages are grouped into stages where each stage contains packages whose dependencies have been completed in previous stages. Uses fail-fast behavior.
 
 ```typescript
 import { runCmdInStagesAcrossWorkspaces } from 'ts-repo-utils';
 
 // Run build in dependency order
 await runCmdInStagesAcrossWorkspaces({
-    rootPackageJsonDir: '.',
+    rootPackageJsonDir: '../',
     cmd: 'build',
     concurrency: 3,
-    filterWorkspacePattern: (name) => !name.includes('deprecated'),
+    filterWorkspacePattern: (name) => !name.includes('experimental'),
 });
 ```
 
@@ -538,16 +607,17 @@ await runCmdInStagesAcrossWorkspaces({
 
 #### `runCmdInParallelAcrossWorkspaces(options): Promise<void>`
 
-Executes a npm script command across all workspace packages in parallel. Uses fail-fast behavior - stops execution immediately when any package fails.
+Executes an npm script command across all workspace packages in parallel. Uses fail-fast behavior - stops execution immediately when any package fails.
 
 ```typescript
 import { runCmdInParallelAcrossWorkspaces } from 'ts-repo-utils';
 
 // Run tests in parallel across all packages
 await runCmdInParallelAcrossWorkspaces({
-    rootPackageJsonDir: '.',
+    rootPackageJsonDir: '../',
     cmd: 'test',
     concurrency: 5,
+    filterWorkspacePattern: (name) => !name.includes('experimental'),
 });
 ```
 
@@ -573,17 +643,17 @@ console.log(packages.map((pkg) => pkg.name));
 **Return Type:**
 
 ```typescript
-type Package = {
+type Package = Readonly<{
     name: string;
     path: string;
     packageJson: JsonValue;
-    dependencies: Record<string, string>;
-};
+    dependencies: Readonly<Record<string, string>>;
+}>;
 ```
 
 #### `executeParallel(packages, scriptName, concurrency?): Promise<readonly Result[]>`
 
-Executes a npm script across multiple packages in parallel with a concurrency limit. Lower-level function used by `runCmdInParallelAcrossWorkspaces`.
+Executes an npm script across multiple packages in parallel with a concurrency limit. Lower-level function used by `runCmdInParallelAcrossWorkspaces`.
 
 ```typescript
 import { executeParallel, getWorkspacePackages } from 'ts-repo-utils';
@@ -594,7 +664,7 @@ await executeParallel(packages, 'lint', 4);
 
 #### `executeStages(packages, scriptName, concurrency?): Promise<void>`
 
-Executes a npm script across packages in dependency order stages. Lower-level function used by `runCmdInStagesAcrossWorkspaces`.
+Executes an npm script across packages in dependency order stages. Lower-level function used by `runCmdInStagesAcrossWorkspaces`.
 
 ```typescript
 import { executeStages, getWorkspacePackages } from 'ts-repo-utils';
@@ -611,93 +681,49 @@ await executeStages(packages, 'build', 3);
 - Fail-fast behavior on errors
 - Circular dependency detection
 
-### Index File Generation
-
-#### `genIndex(config: GenIndexConfig): Promise<Result<undefined, unknown>>`
+### Globals
 
-Generates index files recursively in target directories with automatic barrel exports.
+When you import `ts-repo-utils` without destructuring, several utilities become globally available. This is useful for scripts where you want quick access to common functions without explicit imports.
 
 ```typescript
-import { genIndex } from 'ts-repo-utils';
-
-await genIndex({
-    targetDirectory: './src',
-    exclude: ['*.test.ts', '*.spec.ts'],
-});
-```
+import 'ts-repo-utils';
 
-**Configuration Type:**
-
-```typescript
-type GenIndexConfig = DeepReadonly<{
-    /**
-     * Target directories to generate index files for (string or array of
-     * strings)
-     */
-    targetDirectory: string | readonly string[];
+// Now these functions are globally available
 
-    /**
-     * Glob patterns of files or predicate function to exclude from exports
-     * (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);
+await $('npm test');
 
-    /** File extensions of source files to export (default: ['.ts', '.tsx']) */
-    targetExtensions?: readonly `.${string}`[];
+echo('Building project...');
 
-    /** File extension of index files to generate (default: '.ts') */
-    indexFileExtension?: `.${string}`;
+const filePath: string = path.join('src', 'index.ts');
 
-    /** File extension to use in export statements (default: '.js') */
-    exportStatementExtension?: `.${string}` | 'none';
+const configJson: string = await fs.readFile('./config.json', {
+    encoding: 'utf8',
+});
 
-    /** Command to run for formatting generated files (optional) */
-    formatCommand?: string;
+const files: readonly string[] = await glob('**/*.ts');
 
-    /** Whether to suppress output during execution (default: false) */
-    silent?: boolean;
-}>;
+if (isDirectlyExecuted(import.meta.url)) {
+    echo('Running as CLI');
+}
 ```
 
-**Features:**
-
-- Creates barrel exports for all subdirectories
-- Supports complex glob exclusion patterns (using micromatch)
-- Automatically formats generated files using project's prettier config
-- Works with both single directories and directory arrays
-- Respects source and export extension configuration
-
-**Benefits:**
-
-- Prevents forgetting to export libraries
-- tsc can detect duplicate variables, type names, etc.
-
-## Key Features
-
-- **Type Safety**: All functions use strict TypeScript types with readonly parameters
-- **Error Handling**: Comprehensive error handling with descriptive messages
-- **Git Integration**: Built-in git status and diff utilities
-- **Formatting**: Prettier integration with configuration resolution
-- **ESM Support**: Designed for ES modules with .mts/.mjs extension handling
-- **Concurrent Processing**: Uses Promise.all for performance optimization
-- **Configurable**: Flexible configuration options with sensible defaults
-- **Console Feedback**: Informative logging throughout operations
+- `$` - The command execution utility described above.
+- `echo` - Equivalent to `console.log`
+- `path` - `node:path`
+- `fs` - `node:fs/promises`
+- `glob` - `fast-glob`
+- `isDirectlyExecuted` - The script execution utility described above.
 
 ## Common Patterns
 
 ### Pre-commit Hook
 
 ```typescript
-import { formatUntracked, assertExt, assertRepoIsClean } from 'ts-repo-utils';
+import {
+    assertExt,
+    assertRepoIsClean,
+    formatUncommittedFiles,
+} from 'ts-repo-utils';
 
 // Validate file extensions
 await assertExt({
@@ -714,15 +740,7 @@ await assertRepoIsClean();
 ### Build Pipeline
 
 ```typescript
-import { assertExt, genIndex, $, formatFilesGlob } from 'ts-repo-utils';
-
-// Validate extensions
-await assertExt({
-    directories: [
-        { path: './src', extension: '.ts' },
-        { path: './scripts', extension: '.mjs' },
-    ],
-});
+import { formatFilesGlob, genIndex } from 'ts-repo-utils';
 
 // Generate barrel exports
 await genIndex({ targetDirectory: './src' });
@@ -740,12 +758,20 @@ await formatFilesGlob('dist/**/*.js');
 ### Project Validation
 
 ```typescript
-import { pathExists, assertPathExists, assertRepoIsClean } from 'ts-repo-utils';
+import { assertExt, assertPathExists, assertRepoIsClean } from 'ts-repo-utils';
 
 // Check required files exist (exits with code 1 if files don't exist)
 await assertPathExists('./package.json', 'Package manifest');
 await assertPathExists('./tsconfig.json', 'TypeScript config');
 
+// Validate extensions
+await assertExt({
+    directories: [
+        { path: './src', extension: '.ts' },
+        { path: './scripts', extension: '.mjs' },
+    ],
+});
+
 // Verify clean repository state (exits with code 1 if repo is dirty)
 await assertRepoIsClean();
 ```

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

@@ -6,11 +6,12 @@ import { assertRepoIsClean } from '../functions/assert-repo-is-clean.mjs';
 import 'node:child_process';
 import 'prettier';
 import 'micromatch';
+import 'node:url';
 import 'child_process';
 
 const cmdDef = cmd.command({
     name: 'assert-repo-is-clean-cli',
-    version: '7.2.0',
+    version: '7.3.1',
     args: {
         silent: cmd.flag({
             long: 'silent',

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

@@ -1 +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"}
+{"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.mjs

@@ -5,12 +5,13 @@ import '../node-global.mjs';
 import 'node:child_process';
 import 'prettier';
 import 'micromatch';
+import 'node:url';
 import { checkShouldRunTypeChecks } from '../functions/should-run.mjs';
 import 'child_process';
 
 const cmdDef = cmd.command({
     name: 'check-should-run-type-checks-cli',
-    version: '7.2.0',
+    version: '7.3.1',
     args: {
         pathsIgnore: cmd.multioption({
             long: 'paths-ignore',

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

@@ -1 +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"}
+{"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.mjs

@@ -5,11 +5,12 @@ import '../node-global.mjs';
 import 'node:child_process';
 import { formatDiffFrom } from '../functions/format.mjs';
 import 'micromatch';
+import 'node:url';
 import 'child_process';
 
 const cmdDef = cmd.command({
     name: 'format-diff-from-cli',
-    version: '7.2.0',
+    version: '7.3.1',
     args: {
         base: cmd.positional({
             type: cmd.string,

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

@@ -1 +1 @@
-{"version":3,"file":"format-diff-from.mjs","sources":["../../src/cmd/format-diff-from.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;AAMA,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,oEAAoE;SACvE,CAAC;AACF,QAAA,eAAe,EAAE,GAAG,CAAC,IAAI,CAAC;AACxB,YAAA,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AAC/B,YAAA,WAAW,EACT,mEAAmE;SACtE,CAAC;AACF,QAAA,aAAa,EAAE,GAAG,CAAC,IAAI,CAAC;AACtB,YAAA,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AAC/B,YAAA,WAAW,EACT,iEAAiE;SACpE,CAAC;AACF,QAAA,aAAa,EAAE,GAAG,CAAC,IAAI,CAAC;AACtB,YAAA,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AAC/B,YAAA,WAAW,EAAE,sCAAsC;SACpD,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;AAChB,QAAA,IAAI,CAAC;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;AACf,YAAA,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,KAAK;AAChD,YAAA,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,KAAK;AAC9C,YAAA,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,KAAK;AAC1C,YAAA,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;AACzC,YAAA,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;AAC7B,SAAA,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,KAAI;AACjB,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,IAOE,KACe;IACjB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE;AAC7C,QAAA,gBAAgB,EAAE,CAAC,IAAI,CAAC,gBAAgB;AACxC,QAAA,eAAe,EAAE,CAAC,IAAI,CAAC,eAAe;AACtC,QAAA,aAAa,EAAE,CAAC,IAAI,CAAC,aAAa;QAClC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,MAAM,EAAE,IAAI,CAAC,MAAM;AACpB,KAAA,CAAC;AAEF,IAAA,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;AACxB,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"}
+{"version":3,"file":"format-diff-from.mjs","sources":["../../src/cmd/format-diff-from.mts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/cmd/format-uncommitted.mjs

@@ -5,11 +5,12 @@ import '../node-global.mjs';
 import 'node:child_process';
 import { formatUncommittedFiles } from '../functions/format.mjs';
 import 'micromatch';
+import 'node:url';
 import 'child_process';
 
 const cmdDef = cmd.command({
     name: 'format-uncommitted-cli',
-    version: '7.2.0',
+    version: '7.3.1',
     args: {
         excludeUntracked: cmd.flag({
             long: 'exclude-untracked',

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

@@ -1 +1 @@
-{"version":3,"file":"format-uncommitted.mjs","sources":["../../src/cmd/format-uncommitted.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;AAMA,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC;AACzB,IAAA,IAAI,EAAE,wBAAwB;AAC9B,IAAA,OAAO,EAAE,OAAO;AAChB,IAAA,IAAI,EAAE;AACJ,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,oEAAoE;SACvE,CAAC;AACF,QAAA,eAAe,EAAE,GAAG,CAAC,IAAI,CAAC;AACxB,YAAA,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AAC/B,YAAA,WAAW,EACT,mEAAmE;SACtE,CAAC;AACF,QAAA,aAAa,EAAE,GAAG,CAAC,IAAI,CAAC;AACtB,YAAA,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AAC/B,YAAA,WAAW,EACT,iEAAiE;SACpE,CAAC;AACF,QAAA,aAAa,EAAE,GAAG,CAAC,IAAI,CAAC;AACtB,YAAA,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AAC/B,YAAA,WAAW,EAAE,sCAAsC;SACpD,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;AAChB,QAAA,IAAI,CAAC;AACH,YAAA,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,KAAK;AAChD,YAAA,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,KAAK;AAC9C,YAAA,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,KAAK;AAC1C,YAAA,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;AACzC,YAAA,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;AAC7B,SAAA,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,KAAI;AACjB,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,IAME,KACe;AACjB,IAAA,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;AAC1C,QAAA,SAAS,EAAE,CAAC,IAAI,CAAC,gBAAgB;AACjC,QAAA,QAAQ,EAAE,CAAC,IAAI,CAAC,eAAe;AAC/B,QAAA,MAAM,EAAE,CAAC,IAAI,CAAC,aAAa;QAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,MAAM,EAAE,IAAI,CAAC,MAAM;AACpB,KAAA,CAAC;AACF,IAAA,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;AACxB,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"}
+{"version":3,"file":"format-uncommitted.mjs","sources":["../../src/cmd/format-uncommitted.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;AAMA,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC;AACzB,IAAA,IAAI,EAAE,wBAAwB;AAC9B,IAAA,OAAO,EAAE,OAAO;AAChB,IAAA,IAAI,EAAE;AACJ,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,oEAAoE;SACvE,CAAC;AACF,QAAA,eAAe,EAAE,GAAG,CAAC,IAAI,CAAC;AACxB,YAAA,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AAC/B,YAAA,WAAW,EACT,mEAAmE;SACtE,CAAC;AACF,QAAA,aAAa,EAAE,GAAG,CAAC,IAAI,CAAC;AACtB,YAAA,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AAC/B,YAAA,WAAW,EACT,iEAAiE;SACpE,CAAC;AACF,QAAA,aAAa,EAAE,GAAG,CAAC,IAAI,CAAC;AACtB,YAAA,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;AAC/B,YAAA,WAAW,EAAE,sCAAsC;SACpD,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;AAChB,QAAA,IAAI,CAAC;AACH,YAAA,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,KAAK;AAChD,YAAA,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,KAAK;AAC9C,YAAA,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,KAAK;AAC1C,YAAA,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;AACzC,YAAA,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;AAC7B,SAAA,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,KAAI;AACjB,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,IAME,KACe;AACjB,IAAA,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;AAC1C,QAAA,SAAS,EAAE,CAAC,IAAI,CAAC,gBAAgB;AACjC,QAAA,QAAQ,EAAE,CAAC,IAAI,CAAC,eAAe;AAC/B,QAAA,MAAM,EAAE,CAAC,IAAI,CAAC,aAAa;QAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,MAAM,EAAE,IAAI,CAAC,MAAM;AACpB,KAAA,CAAC;AACF,IAAA,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;AACxB,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.mjs

@@ -5,6 +5,7 @@ import '../node-global.mjs';
 import 'node:child_process';
 import 'prettier';
 import { genIndex } from '../functions/gen-index.mjs';
+import 'node:url';
 import 'child_process';
 
 const extensionType = cmd.extendType(cmd.string, {
@@ -28,7 +29,7 @@ const nonEmptyArray = (t, commandName) => cmd.extendType(cmd.array(t), {
 });
 const cmdDef = cmd.command({
     name: 'gen-index-ts-cli',
-    version: '7.2.0',
+    version: '7.3.1',
     args: {
         // required args
         targetDirectory: cmd.positional({

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

@@ -1 +1 @@
-{"version":3,"file":"gen-index-ts.mjs","sources":["../../src/cmd/gen-index-ts.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;AAWA,MAAM,aAAa,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE;AAC/C,IAAA,IAAI,EAAE,CAAC,CAAC,KAAI;QACV,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;AACtB,YAAA,MAAM,IAAI,KAAK,CAAC,CAAA,yBAAA,CAA2B,CAAC;;;AAG9C,QAAA,OAAO,OAAO,CAAC,OAAO,CAAC,CAAQ,CAAC;KACjC;AACF,CAAA,CAAC;AAEF;AACA,MAAM,aAAa,GAAG,CACpB,CAAI,EACJ,WAAmB,KAEnB,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;AAC3B,IAAA,IAAI,EAAE,CAAC,GAAG,KAAI;AACZ,QAAA,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE;AACpB,YAAA,MAAM,IAAI,KAAK,CACb,2BAA2B,WAAW,CAAA,iCAAA,CAAmC,CAC1E;;;AAGH,QAAA,OAAO,OAAO,CAAC,OAAO,CAAC,GAA4C,CAAC;KACrE;AACF,CAAA,CAAC;AAEJ,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC;AACzB,IAAA,IAAI,EAAE,kBAAkB;AACxB,IAAA,OAAO,EAAE,OAAO;AAChB,IAAA,IAAI,EAAE;;AAEJ,QAAA,eAAe,EAAE,GAAG,CAAC,UAAU,CAAC;YAC9B,IAAI,EAAE,GAAG,CAAC,MAAM;AAChB,YAAA,WAAW,EAAE,kBAAkB;AAC/B,YAAA,WAAW,EACT,sFAAsF;SACzF,CAAC;AAEF,QAAA,gBAAgB,EAAE,GAAG,CAAC,WAAW,CAAC;AAChC,YAAA,IAAI,EAAE,YAAY;AAClB,YAAA,IAAI,EAAE,aAAa,CAAC,aAAa,EAAE,YAAY,CAAC;AAChD,YAAA,WAAW,EAAE,8CAA8C;SAC5D,CAAC;AACF,QAAA,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC;AAC7B,YAAA,IAAI,EAAE,WAAW;AACjB,YAAA,IAAI,EAAE,aAAa;AACnB,YAAA,WAAW,EAAE,6CAA6C;SAC3D,CAAC;AACF,QAAA,wBAAwB,EAAE,GAAG,CAAC,MAAM,CAAC;AACnC,YAAA,IAAI,EAAE,YAAY;AAClB,YAAA,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC;gBACd,aAAa;AACb,gBAAA,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE;AACzB,oBAAA,IAAI,EAAE,CAAC,CAAC,KAAI;AACV,wBAAA,IAAI,CAAC,KAAK,MAAM,EAAE;AAChB,4BAAA,MAAM,IAAI,KAAK,CACb,CAAA,gDAAA,CAAkD,CACnD;;AAEH,wBAAA,OAAO,OAAO,CAAC,OAAO,CAAC,MAAe,CAAC;qBACxC;iBACF,CAAC;aACH,CAAC;AACF,YAAA,WAAW,EAAE,sDAAsD;SACpE,CAAC;;AAGF,QAAA,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC;AACvB,YAAA,IAAI,EAAE,SAAS;AACf,YAAA,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACzC,YAAA,WAAW,EACT,uFAAuF;SAC1F,CAAC;AACF,QAAA,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC;AACxB,YAAA,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;AAC9B,YAAA,WAAW,EACT,yEAAyE;SAC5E,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;AAChB,QAAA,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAWjB,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;KACH;AACF,CAAA,CAAC;AAEF,MAAM,IAAI,GAAG,OAAO,EAClB,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,MAAM,GASN,KAAmB;AACnB,IAAA,MAAM,QAAQ,CAAC;AACb,QAAA,eAAe,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG;AAC3C,cAAE,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,EAAE;AACpD,cAAE,eAAe;QACnB,wBAAwB;QACxB,gBAAgB;QAChB,OAAO;QACP,kBAAkB;QAClB,aAAa;QACb,MAAM;AACP,KAAA,CAAC;AACJ,CAAC;AAED,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC"}
+{"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/index.d.mts

@@ -5,6 +5,7 @@ export * from './diff.mjs';
 export * from './exec-async.mjs';
 export * from './format.mjs';
 export * from './gen-index.mjs';
+export * from './is-directly-executed.mjs';
 export * from './should-run.mjs';
 export * from './workspace-utils/index.mjs';
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/functions/index.mts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/functions/index.mts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC"}

package/dist/functions/index.mjs

@@ -5,6 +5,7 @@ export { getDiffFrom, getModifiedFiles, getStagedFiles, getUntrackedFiles } from
 export { $ } from './exec-async.mjs';
 export { formatDiffFrom, formatFiles, formatFilesGlob, formatUncommittedFiles } from './format.mjs';
 export { genIndex } from './gen-index.mjs';
+export { isDirectlyExecuted } from './is-directly-executed.mjs';
 export { checkShouldRunTypeChecks } from './should-run.mjs';
 export { executeParallel, executeStages } from './workspace-utils/execute-parallel.mjs';
 export { getWorkspacePackages } from './workspace-utils/get-workspace-packages.mjs';

package/dist/functions/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;"}
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;"}

package/dist/functions/is-directly-executed.d.mts

@@ -0,0 +1,2 @@
+export declare const isDirectlyExecuted: (fileUrl: string) => boolean;
+//# sourceMappingURL=is-directly-executed.d.mts.map

package/dist/functions/is-directly-executed.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-directly-executed.d.mts","sourceRoot":"","sources":["../../src/functions/is-directly-executed.mts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,KAAG,OACT,CAAC"}

package/dist/functions/is-directly-executed.mjs

@@ -0,0 +1,6 @@
+import { fileURLToPath } from 'node:url';
+
+const isDirectlyExecuted = (fileUrl) => fileURLToPath(fileUrl) === process.argv[1];
+
+export { isDirectlyExecuted };
+//# sourceMappingURL=is-directly-executed.mjs.map

package/dist/functions/is-directly-executed.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-directly-executed.mjs","sources":["../../src/functions/is-directly-executed.mts"],"sourcesContent":[null],"names":[],"mappings":";;MAEa,kBAAkB,GAAG,CAAC,OAAe,KAChD,aAAa,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;;;;"}

package/dist/index.mjs

@@ -5,6 +5,7 @@ export { getDiffFrom, getModifiedFiles, getStagedFiles, getUntrackedFiles } from
 export { $ } from './functions/exec-async.mjs';
 export { formatDiffFrom, formatFiles, formatFilesGlob, formatUncommittedFiles } from './functions/format.mjs';
 export { genIndex } from './functions/gen-index.mjs';
+export { isDirectlyExecuted } from './functions/is-directly-executed.mjs';
 export { checkShouldRunTypeChecks } from './functions/should-run.mjs';
 export { executeParallel, executeStages } from './functions/workspace-utils/execute-parallel.mjs';
 export { getWorkspacePackages } from './functions/workspace-utils/get-workspace-packages.mjs';

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;"}
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;"}

package/dist/node-global.d.mts

@@ -2,11 +2,13 @@ import { default as glob_ } from 'fast-glob';
 import * as fs_ from 'node:fs/promises';
 import * as path_ from 'node:path';
 import { $ as $_ } from './functions/exec-async.mjs';
+import { isDirectlyExecuted as isDirectlyExecuted_ } from './functions/is-directly-executed.mjs';
 declare global {
     const $: typeof $_;
     const echo: typeof console.log;
     const path: typeof path_;
     const fs: typeof fs_;
     const glob: typeof glob_;
+    const isDirectlyExecuted: typeof isDirectlyExecuted_;
 }
 //# sourceMappingURL=node-global.d.mts.map

package/dist/node-global.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"node-global.d.mts","sourceRoot":"","sources":["../src/node-global.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,WAAW,CAAC;AAGnC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,MAAM,4BAA4B,CAAC;AAcrD,OAAO,CAAC,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,MAAM,IAAI,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IAE/B,MAAM,IAAI,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,EAAE,EAAE,OAAO,GAAG,CAAC;IACrB,MAAM,IAAI,EAAE,OAAO,KAAK,CAAC;CAC1B"}
+{"version":3,"file":"node-global.d.mts","sourceRoot":"","sources":["../src/node-global.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,kBAAkB,IAAI,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAejG,OAAO,CAAC,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,MAAM,IAAI,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IAE/B,MAAM,IAAI,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,EAAE,EAAE,OAAO,GAAG,CAAC;IACrB,MAAM,IAAI,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,kBAAkB,EAAE,OAAO,mBAAmB,CAAC;CACtD"}

package/dist/node-global.mjs

@@ -2,13 +2,16 @@ import glob_ from 'fast-glob';
 import * as fs_ from 'node:fs/promises';
 import * as path_ from 'node:path';
 import { $ } from './functions/exec-async.mjs';
+import { isDirectlyExecuted } from './functions/is-directly-executed.mjs';
 
+/* eslint-disable import/no-internal-modules */
 const globalsDef = {
     $: $,
     echo: console.log,
     path: path_,
     fs: fs_,
     glob: glob_,
+    isDirectlyExecuted: isDirectlyExecuted,
 };
 // eslint-disable-next-line functional/immutable-data
 Object.assign(globalThis, globalsDef);

package/dist/node-global.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"node-global.mjs","sources":["../src/node-global.mts"],"sourcesContent":[null],"names":["$_"],"mappings":";;;;;AAOA,MAAM,UAAU,GAAG;AACjB,IAAA,CAAC,EAAEA,CAAE;IACL,IAAI,EAAE,OAAO,CAAC,GAAG;AAEjB,IAAA,IAAI,EAAE,KAAK;AACX,IAAA,EAAE,EAAE,GAAG;AACP,IAAA,IAAI,EAAE,KAAK;CACH;AAEV;AACA,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC"}
+{"version":3,"file":"node-global.mjs","sources":["../src/node-global.mts"],"sourcesContent":[null],"names":["$_","isDirectlyExecuted_"],"mappings":";;;;;;AAAA;AAOA,MAAM,UAAU,GAAG;AACjB,IAAA,CAAC,EAAEA,CAAE;IACL,IAAI,EAAE,OAAO,CAAC,GAAG;AAEjB,IAAA,IAAI,EAAE,KAAK;AACX,IAAA,EAAE,EAAE,GAAG;AACP,IAAA,IAAI,EAAE,KAAK;AACX,IAAA,kBAAkB,EAAEC,kBAAmB;CAC/B;AAEV;AACA,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-repo-utils",
-  "version": "7.2.0",
+  "version": "7.3.1",
   "private": false,
   "keywords": [
     "typescript"
@@ -79,15 +79,15 @@
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/exec": "^7.1.0",
     "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^11.0.5",
+    "@semantic-release/github": "^11.0.6",
     "@semantic-release/npm": "^12.0.2",
     "@semantic-release/release-notes-generator": "^14.1.0",
-    "@types/node": "^24.3.0",
+    "@types/node": "^24.3.3",
     "@vitest/coverage-v8": "^3.2.4",
     "@vitest/ui": "^3.2.4",
     "conventional-changelog-conventionalcommits": "^9.1.0",
     "cspell": "^9.2.0",
-    "dedent": "^1.6.0",
+    "dedent": "^1.7.0",
     "eslint": "^9.35.0",
     "eslint-import-resolver-typescript": "4.4.4",
     "eslint-plugin-array-func": "5.0.2",
@@ -96,7 +96,7 @@
     "eslint-plugin-prefer-arrow-functions": "3.6.2",
     "eslint-plugin-promise": "7.2.1",
     "eslint-plugin-security": "3.0.1",
-    "eslint-plugin-unicorn": "61.0.1",
+    "eslint-plugin-unicorn": "61.0.2",
     "eslint-plugin-vitest": "0.5.4",
     "markdownlint-cli2": "^0.18.1",
     "npm-run-all2": "^8.0.4",
@@ -111,7 +111,7 @@
     "typedoc": "^0.28.12",
     "typedoc-plugin-markdown": "^4.8.1",
     "typescript": "^5.9.2",
-    "typescript-eslint": "^8.42.0",
+    "typescript-eslint": "^8.43.0",
     "vitest": "^3.2.4"
   },
   "peerDependencies": {

package/src/cmd/assert-repo-is-clean.mts

@@ -5,7 +5,7 @@ import { assertRepoIsClean } from '../functions/index.mjs';
 
 const cmdDef = cmd.command({
   name: 'assert-repo-is-clean-cli',
-  version: '7.2.0',
+  version: '7.3.1',
   args: {
     silent: cmd.flag({
       long: 'silent',

package/src/cmd/check-should-run-type-checks.mts

@@ -5,7 +5,7 @@ import { checkShouldRunTypeChecks } from '../functions/index.mjs';
 
 const cmdDef = cmd.command({
   name: 'check-should-run-type-checks-cli',
-  version: '7.2.0',
+  version: '7.3.1',
   args: {
     pathsIgnore: cmd.multioption({
       long: 'paths-ignore',

package/src/cmd/format-diff-from.mts

@@ -6,7 +6,7 @@ import { formatDiffFrom } from '../functions/index.mjs';
 
 const cmdDef = cmd.command({
   name: 'format-diff-from-cli',
-  version: '7.2.0',
+  version: '7.3.1',
   args: {
     base: cmd.positional({
       type: cmd.string,

package/src/cmd/format-uncommitted.mts

@@ -6,7 +6,7 @@ import { formatUncommittedFiles } from '../functions/index.mjs';
 
 const cmdDef = cmd.command({
   name: 'format-uncommitted-cli',
-  version: '7.2.0',
+  version: '7.3.1',
   args: {
     excludeUntracked: cmd.flag({
       long: 'exclude-untracked',

package/src/cmd/gen-index-ts.mts

@@ -38,7 +38,7 @@ const nonEmptyArray = <T extends cmd.Type<any, any>>(
 
 const cmdDef = cmd.command({
   name: 'gen-index-ts-cli',
-  version: '7.2.0',
+  version: '7.3.1',
   args: {
     // required args
     targetDirectory: cmd.positional({

package/src/functions/index.mts

@@ -5,5 +5,6 @@ export * from './diff.mjs';
 export * from './exec-async.mjs';
 export * from './format.mjs';
 export * from './gen-index.mjs';
+export * from './is-directly-executed.mjs';
 export * from './should-run.mjs';
 export * from './workspace-utils/index.mjs';

package/src/functions/is-directly-executed.mts

@@ -0,0 +1,4 @@
+import { fileURLToPath } from 'node:url';
+
+export const isDirectlyExecuted = (fileUrl: string): boolean =>
+  fileURLToPath(fileUrl) === process.argv[1];

package/src/node-global.mts

@@ -1,9 +1,9 @@
+/* eslint-disable import/no-internal-modules */
 import { default as glob_ } from 'fast-glob';
 import * as fs_ from 'node:fs/promises';
 import * as path_ from 'node:path';
-
-// eslint-disable-next-line import/no-internal-modules
 import { $ as $_ } from './functions/exec-async.mjs';
+import { isDirectlyExecuted as isDirectlyExecuted_ } from './functions/is-directly-executed.mjs';
 
 const globalsDef = {
   $: $_,
@@ -12,6 +12,7 @@ const globalsDef = {
   path: path_,
   fs: fs_,
   glob: glob_,
+  isDirectlyExecuted: isDirectlyExecuted_,
 } as const;
 
 // eslint-disable-next-line functional/immutable-data
@@ -24,4 +25,5 @@ declare global {
   const path: typeof path_;
   const fs: typeof fs_;
   const glob: typeof glob_;
+  const isDirectlyExecuted: typeof isDirectlyExecuted_;
 }