ts-repo-utils 1.0.0 → 1.1.0

package/README.md

@@ -1,3 +1,281 @@
 # ts-repo-utils
 
 Utilities for TypeScript Repositories.
+
+A comprehensive toolkit for managing TypeScript projects with strict ESM support, providing essential utilities for file validation, code formatting, git operations, and project automation.
+
+## Installation
+
+```bash
+npm install ts-repo-utils
+```
+
+## API Reference
+
+### Path and File System Utilities
+
+#### `pathExists(filePath: string): Promise<boolean>`
+
+Checks if a file or directory exists at the specified path.
+
+```typescript
+import { pathExists } from 'ts-repo-utils';
+
+const exists = await pathExists('./src/index.ts');
+console.log(exists); // true or false
+```
+
+#### `assertPathExists(filePath: string, description?: string): Promise<void>`
+
+Validates that a path exists and exits with code 1 if it doesn't.
+
+```typescript
+import { assertPathExists } from 'ts-repo-utils';
+
+// If the file doesn't exist, this will exit the process with code 1
+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.
+
+```typescript
+import { assertExt } from 'ts-repo-utils';
+
+await assertExt({
+    directories: [
+        {
+            path: './src',
+            extension: '.ts',
+            ignorePatterns: ['*.d.ts', '*.test.ts'],
+        },
+        {
+            path: './scripts',
+            extension: '.mjs',
+        },
+    ],
+});
+```
+
+**Configuration Type:**
+
+```typescript
+type CheckExtConfig = DeepReadonly<{
+    directories: {
+        path: string; // Directory path to check
+        extension: string; // Expected file extension (including the dot)
+        ignorePatterns?: string[]; // Optional glob patterns to ignore
+    }[];
+}>;
+```
+
+### Git Repository Utilities
+
+#### `repoIsDirty(): Promise<boolean>`
+
+Checks if the repository has uncommitted changes.
+
+```typescript
+import { repoIsDirty } from 'ts-repo-utils';
+
+const isDirty = await repoIsDirty();
+if (isDirty) {
+    console.log('Repository has uncommitted changes');
+}
+```
+
+#### `assertRepoIsDirty(): Promise<void>`
+
+Checks if repository is dirty and exits with code 1 if it is (shows changes and diff).
+
+```typescript
+import { assertRepoIsDirty } from 'ts-repo-utils';
+
+// Use in CI/build scripts to ensure clean state
+await assertRepoIsDirty();
+```
+
+### 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);
+}
+```
+
+**Types:**
+
+```typescript
+type ExecOptions = Readonly<{
+    silent?: boolean; // Don't log command/output (default: false)
+    timeout?: number; // Timeout in milliseconds (default: 30000)
+}>;
+
+type ExecResult = Readonly<
+    | { type: 'ok'; stdout: string; stderr: string }
+    | { type: 'error'; exception: ExecException }
+>;
+```
+
+### Code Formatting Utilities
+
+#### `formatFiles(pathGlob: string): Promise<'ok' | 'err'>`
+
+Format files matching a glob pattern using Prettier.
+
+```typescript
+import { formatFiles } from 'ts-repo-utils';
+
+// Format all TypeScript files in src
+await formatFiles('src/**/*.ts');
+
+// Format specific files
+await formatFiles('src/{index,utils}.ts');
+```
+
+#### `formatChanged(): Promise<'ok' | 'err'>`
+
+Format only files that have been changed according to git status.
+
+```typescript
+import { formatChanged } from 'ts-repo-utils';
+
+// Format only modified files
+await formatChanged();
+```
+
+#### `formatDiffFrom(base?: string): Promise<'ok' | 'err'>`
+
+Format only files that differ from the specified base branch or commit.
+
+```typescript
+import { formatDiffFrom } from 'ts-repo-utils';
+
+// Format files different from main branch
+await formatDiffFrom('main');
+
+// Format files different from specific commit
+await formatDiffFrom('abc123');
+```
+
+### Index File Generation
+
+#### `genIndex(config: GenIndexConfig): Promise<void>`
+
+Generates index.mts files recursively in target directories with automatic barrel exports.
+
+```typescript
+import { genIndex } from 'ts-repo-utils';
+
+await genIndex({
+    targetDirectory: './src',
+    sourceExtension: '.ts',
+    exportExtension: '.js',
+    excludePatterns: ['*.test.ts', '*.spec.ts'],
+});
+```
+
+**Configuration Type:**
+
+```typescript
+type GenIndexConfig = DeepReadonly<{
+    targetDirectory: string | string[]; // Target directories to generate index files for
+    sourceExtension?: `.${string}`; // File extension of source files (default: '.mts')
+    exportExtension?: `.${string}`; // Extension to use in exports (default: '.mjs')
+    excludePatterns?: string[]; // Glob patterns to exclude (default: excludes .d.* and .test.*)
+}>;
+```
+
+**Features:**
+
+- Validates file extensions before generation
+- Creates barrel exports for all subdirectories
+- Supports complex glob exclusion patterns
+- Automatically formats generated files
+- Works with both single directories and directory arrays
+
+## 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
+
+## Common Patterns
+
+### Pre-commit Hook
+
+```typescript
+import { formatChanged, assertExt, repoIsDirty } from 'ts-repo-utils';
+
+// Format changed files
+await formatChanged();
+
+// Validate file extensions
+await assertExt({
+    directories: [{ path: './src', extension: '.ts' }],
+});
+
+// Ensure no uncommitted changes remain
+await assertRepoIsDirty();
+```
+
+### Build Pipeline
+
+```typescript
+import { assertExt, genIndex, $, formatFiles } from 'ts-repo-utils';
+
+// Validate extensions
+await assertExt({
+    directories: [
+        { path: './src', extension: '.ts' },
+        { path: './scripts', extension: '.mjs' },
+    ],
+});
+
+// Generate barrel exports
+await genIndex({ targetDirectory: './src' });
+
+// Type check
+await $('tsc --noEmit');
+
+// Build
+await $('rollup -c');
+
+// Format output
+await formatFiles('dist/**/*.js');
+```
+
+### Project Validation
+
+```typescript
+import { pathExists, assertPathExists, assertRepoIsDirty } 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');
+
+// Verify clean repository state (exits with code 1 if repo is dirty)
+await assertRepoIsDirty();
+```
+
+## License
+
+Apache-2.0

package/dist/functions/assert-ext.d.mts

@@ -0,0 +1,22 @@
+import '../node-global.mjs';
+/**
+ * Configuration for directory extension checking.
+ */
+export type CheckExtConfig = DeepReadonly<{
+    /** Array of directory paths and their expected extensions */
+    directories: {
+        /** Directory path to check */
+        path: string;
+        /** Expected file extension (including the dot) */
+        extension: string;
+        /** Optional glob patterns to ignore (defaults to ['tsconfig.json', 'globals.d.*']) */
+        ignorePatterns?: string[];
+    }[];
+}>;
+/**
+ * Validates that all files in specified directories have the correct extensions.
+ * Exits with code 1 if any files have incorrect extensions.
+ * @param config - Configuration specifying directories and expected extensions.
+ */
+export declare const assertExt: (config: CheckExtConfig) => Promise<void>;
+//# sourceMappingURL=assert-ext.d.mts.map

package/dist/functions/assert-ext.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-ext.d.mts","sourceRoot":"","sources":["../../src/functions/assert-ext.mts"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,CAAC;AAG5B;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC;IACxC,6DAA6D;IAC7D,WAAW,EAAE;QACX,8BAA8B;QAC9B,IAAI,EAAE,MAAM,CAAC;QACb,kDAAkD;QAClD,SAAS,EAAE,MAAM,CAAC;QAClB,sFAAsF;QACtF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B,EAAE,CAAC;CACL,CAAC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAU,QAAQ,cAAc,KAAG,OAAO,CAAC,IAAI,CA4DpE,CAAC"}

package/dist/functions/assert-ext.mjs

@@ -0,0 +1,74 @@
+import '../node-global.mjs';
+import { assertPathExists } from './assert-path-exists.mjs';
+
+/**
+ * Validates that all files in specified directories have the correct extensions.
+ * Exits with code 1 if any files have incorrect extensions.
+ * @param config - Configuration specifying directories and expected extensions.
+ */
+const assertExt = async (config) => {
+    const allIncorrectFiles = [];
+    // Check all directories in parallel
+    const results = await Promise.all(config.directories.map(async ({ path: dir, extension, ignorePatterns }) => {
+        try {
+            return await getFilesWithIncorrectExtension(dir, extension, ignorePatterns);
+        }
+        catch (error) {
+            console.error(`Failed to check directory ${dir}: ${String(error)}`);
+            return [];
+        }
+    }));
+    // Collect all incorrect files
+    results.forEach((incorrectFiles) => {
+        allIncorrectFiles.push(...incorrectFiles);
+    });
+    if (allIncorrectFiles.length > 0) {
+        const generateErrorMessage = () => {
+            // Group directories by extension for a cleaner message
+            const extensionGroups = new Map();
+            for (const { path: dirPath, extension } of config.directories) {
+                const relativePath = path.relative(process.cwd(), dirPath);
+                if (!extensionGroups.has(extension)) {
+                    extensionGroups.set(extension, []);
+                }
+                extensionGroups.get(extension)?.push(relativePath);
+            }
+            // Generate message parts for each extension
+            const messageParts = Array.from(extensionGroups.entries()).map(([ext, dirs]) => {
+                const dirList = dirs.length === 1 ? dirs[0] : dirs.join(', ');
+                return `${dirList} should have ${ext} extension`;
+            });
+            return `All files in ${messageParts.join(' and ')}.`;
+        };
+        const errorMessage = [
+            'Files with incorrect extensions found:',
+            ...allIncorrectFiles.map((file) => `  - ${file}`),
+            '',
+            generateErrorMessage(),
+        ].join('\n');
+        echo(errorMessage);
+        process.exit(1);
+    }
+    echo('✓ All files have correct extensions');
+};
+/**
+ * Checks if all files in a directory have the expected extension.
+ * @param dir - The directory to check.
+ * @param expectedExtension - The expected file extension.
+ * @param ignorePatterns - Optional glob patterns to ignore.
+ * @returns Array of files with incorrect extensions.
+ */
+const getFilesWithIncorrectExtension = async (dir, expectedExtension, ignorePatterns) => {
+    await assertPathExists(dir, 'Directory');
+    const defaultIgnorePatterns = ['tsconfig.json', 'globals.d.*'];
+    const finalIgnorePatterns = ignorePatterns ?? defaultIgnorePatterns;
+    // Convert relative patterns to absolute paths for the glob ignore option
+    const absoluteIgnorePatterns = finalIgnorePatterns.map((pattern) => path.isAbsolute(pattern) ? pattern : `${dir}/${pattern}`);
+    const files = await glob(`${dir}/**/*`, {
+        ignore: absoluteIgnorePatterns,
+    });
+    return files.filter((file) => !file.endsWith(expectedExtension));
+};
+
+export { assertExt };
+//# sourceMappingURL=assert-ext.mjs.map

package/dist/functions/assert-ext.mjs.map

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

package/dist/functions/assert-path-exists.d.mts

@@ -0,0 +1,14 @@
+import '../node-global.mjs';
+/**
+ * Checks if a file or directory exists.
+ * @param filePath - The path to check.
+ * @returns True if the path exists.
+ */
+export declare const pathExists: (filePath: string) => Promise<boolean>;
+/**
+ * Validates that a path exists and exits with code 1 if it doesn't.
+ * @param filePath - The path to validate.
+ * @param description - Description for error message (defaults to 'Path').
+ */
+export declare const assertPathExists: (filePath: string, description?: string) => Promise<void>;
+//# sourceMappingURL=assert-path-exists.d.mts.map

package/dist/functions/assert-path-exists.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-path-exists.d.mts","sourceRoot":"","sources":["../../src/functions/assert-path-exists.mts"],"names":[],"mappings":"AACA,OAAO,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,OAAO,CAOlE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,oBAAoB,KACnB,OAAO,CAAC,IAAI,CAKd,CAAC"}

package/dist/functions/assert-path-exists.mjs

@@ -0,0 +1,31 @@
+import * as fs_ from 'node:fs/promises';
+import '../node-global.mjs';
+
+/**
+ * Checks if a file or directory exists.
+ * @param filePath - The path to check.
+ * @returns True if the path exists.
+ */
+const pathExists = async (filePath) => {
+    try {
+        await fs_.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * Validates that a path exists and exits with code 1 if it doesn't.
+ * @param filePath - The path to validate.
+ * @param description - Description for error message (defaults to 'Path').
+ */
+const assertPathExists = async (filePath, description = 'Path') => {
+    if (!(await pathExists(filePath))) {
+        echo(`${description} does not exist: ${filePath}`);
+        process.exit(1);
+    }
+};
+
+export { assertPathExists, pathExists };
+//# sourceMappingURL=assert-path-exists.mjs.map

package/dist/functions/assert-path-exists.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-path-exists.mjs","sources":["../../src/functions/assert-path-exists.mts"],"sourcesContent":[null],"names":["fs"],"mappings":";;;AAGA;;;;AAIG;MACU,UAAU,GAAG,OAAO,QAAgB,KAAsB;AACrE,IAAA,IAAI;AACF,QAAA,MAAMA,GAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;AACzB,QAAA,OAAO,IAAI;;AACX,IAAA,MAAM;AACN,QAAA,OAAO,KAAK;;AAEhB;AAEA;;;;AAIG;AACI,MAAM,gBAAgB,GAAG,OAC9B,QAAgB,EAChB,WAAW,GAAG,MAAM,KACH;IACjB,IAAI,EAAE,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE;AACjC,QAAA,IAAI,CAAC,CAAG,EAAA,WAAW,oBAAoB,QAAQ,CAAA,CAAE,CAAC;AAClD,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;;AAEnB;;;;"}

package/dist/functions/assert-repo-is-dirty.d.mts

@@ -0,0 +1,13 @@
+import '../node-global.mjs';
+/**
+ * Checks if the repository has uncommitted changes.
+ * @returns True if the repo is dirty, false otherwise.
+ * @throws Error if git command fails.
+ */
+export declare const repoIsDirty: () => Promise<boolean>;
+/**
+ * Checks if the repository is dirty and exits with code 1 if it is.
+ * Shows git status and diff output before exiting.
+ */
+export declare const assertRepoIsDirty: () => Promise<void>;
+//# sourceMappingURL=assert-repo-is-dirty.d.mts.map

package/dist/functions/assert-repo-is-dirty.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-repo-is-dirty.d.mts","sourceRoot":"","sources":["../../src/functions/assert-repo-is-dirty.mts"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAa,OAAO,CAAC,OAAO,CAGnD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,IAAI,CA6BtD,CAAC"}

package/dist/functions/assert-repo-is-dirty.mjs

@@ -0,0 +1,58 @@
+import '../node-global.mjs';
+
+/**
+ * Checks if the repository has uncommitted changes.
+ * @returns True if the repo is dirty, false otherwise.
+ * @throws Error if git command fails.
+ */
+const repoIsDirty = async () => {
+    const status = await getGitStatus();
+    return status.isDirty;
+};
+/**
+ * Checks if the repository is dirty and exits with code 1 if it is.
+ * Shows git status and diff output before exiting.
+ */
+const assertRepoIsDirty = async () => {
+    try {
+        const status = await getGitStatus();
+        if (!status.isDirty) {
+            echo('Repo is clean\n');
+            return;
+        }
+        echo('Repo is dirty\n');
+        echo('Changed files:\n');
+        echo(status.stdout);
+        // Show files not tracked by git and unstaged changes
+        const addResult = await $('git add -N .');
+        if (addResult.type === 'error') {
+            echo('Warning: Failed to add untracked files for diff\n');
+        }
+        const diffResult = await $('git diff');
+        if (diffResult.type === 'error') {
+            echo('Warning: Failed to show diff\n');
+        }
+        process.exit(1);
+    }
+    catch (error) {
+        echo(`Error checking repository status: ${String(error)}\n`);
+        process.exit(1);
+    }
+};
+/**
+ * Gets the git status of the repository.
+ * @returns An object containing status information.
+ */
+const getGitStatus = async () => {
+    const res = await $('git status --porcelain');
+    if (res.type === 'error') {
+        throw new Error(`Failed to get git status: ${res.exception.message}`);
+    }
+    return {
+        isDirty: res.stdout.trim() !== '',
+        stdout: res.stdout,
+    };
+};
+
+export { assertRepoIsDirty, repoIsDirty };
+//# sourceMappingURL=assert-repo-is-dirty.mjs.map

package/dist/functions/assert-repo-is-dirty.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-repo-is-dirty.mjs","sources":["../../src/functions/assert-repo-is-dirty.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;AAIG;AACU,MAAA,WAAW,GAAG,YAA6B;AACtD,IAAA,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE;IACnC,OAAO,MAAM,CAAC,OAAO;AACvB;AAEA;;;AAGG;AACU,MAAA,iBAAiB,GAAG,YAA0B;AACzD,IAAA,IAAI;AACF,QAAA,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE;AAEnC,QAAA,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;YACnB,IAAI,CAAC,iBAAiB,CAAC;YACvB;;QAGF,IAAI,CAAC,iBAAiB,CAAC;QACvB,IAAI,CAAC,kBAAkB,CAAC;AACxB,QAAA,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;;AAGnB,QAAA,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,cAAc,CAAC;AACzC,QAAA,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO,EAAE;YAC9B,IAAI,CAAC,mDAAmD,CAAC;;AAG3D,QAAA,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,UAAU,CAAC;AACtC,QAAA,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,EAAE;YAC/B,IAAI,CAAC,gCAAgC,CAAC;;AAGxC,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;;IACf,OAAO,KAAK,EAAE;QACd,IAAI,CAAC,qCAAqC,MAAM,CAAC,KAAK,CAAC,CAAA,EAAA,CAAI,CAAC;AAC5D,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;;AAEnB;AAEA;;;AAGG;AACH,MAAM,YAAY,GAAG,YAGhB;AACH,IAAA,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,wBAAwB,CAAC;AAE7C,IAAA,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE;QACxB,MAAM,IAAI,KAAK,CAAC,CAA6B,0BAAA,EAAA,GAAG,CAAC,SAAS,CAAC,OAAO,CAAE,CAAA,CAAC;;IAGvE,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;QACjC,MAAM,EAAE,GAAG,CAAC,MAAM;KACnB;AACH,CAAC;;;;"}

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

@@ -0,0 +1,20 @@
+import { type ExecException } from 'node:child_process';
+export type ExecResult = Readonly<{
+    type: 'ok';
+    stdout: string;
+    stderr: string;
+} | {
+    type: 'error';
+    exception: ExecException;
+}>;
+/**
+ * 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.
+ */
+export declare const $: (cmd: string, options?: Readonly<{
+    silent?: boolean;
+    timeout?: number;
+}>) => Promise<ExecResult>;
+//# sourceMappingURL=exec-async.d.mts.map

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

@@ -0,0 +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;AAE9D,MAAM,MAAM,UAAU,GAAG,QAAQ,CAC7B;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,aAAa,CAAA;CAAE,CAC9C,CAAC;AAEF;;;;;GAKG;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,CAAC,UAAU,CA2BpB,CAAC"}

package/dist/functions/exec-async.mjs

@@ -0,0 +1,36 @@
+import { exec } from 'node:child_process';
+
+/**
+ * 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;
+    if (!silent) {
+        console.log(`$ ${cmd}`);
+    }
+    return new Promise((resolve) => {
+        const execOptions = { timeout };
+        exec(cmd, execOptions, (error, stdout, stderr) => {
+            if (!silent) {
+                if (stdout !== '') {
+                    console.log(stdout);
+                }
+                if (stderr !== '') {
+                    console.error(stderr);
+                }
+            }
+            if (error !== null) {
+                resolve({ type: 'error', exception: error });
+            }
+            else {
+                resolve({ type: 'ok', stdout, stderr });
+            }
+        });
+    });
+};
+
+export { $ };
+//# sourceMappingURL=exec-async.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exec-async.mjs","sources":["../../src/functions/exec-async.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAOA;;;;;AAKG;AACU,MAAA,CAAC,GAAG,CACf,GAAW,EACX,OAAA,GAA4D,EAAE,KACvC;IACvB,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,OAAO;IAEnD,IAAI,CAAC,MAAM,EAAE;AACX,QAAA,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAA,CAAE,CAAC;;AAGzB,IAAA,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,KAAI;AAC7B,QAAA,MAAM,WAAW,GAAG,EAAE,OAAO,EAAE;AAE/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;AACjB,oBAAA,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;;AAErB,gBAAA,IAAI,MAAM,KAAK,EAAE,EAAE;AACjB,oBAAA,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;;;AAIzB,YAAA,IAAI,KAAK,KAAK,IAAI,EAAE;gBAClB,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;;iBACvC;gBACL,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;;AAE3C,SAAC,CAAC;AACJ,KAAC,CAAC;AACJ;;;;"}

package/dist/functions/format.d.mts

@@ -0,0 +1,18 @@
+/**
+ * Format files matching the given glob pattern using Prettier
+ * @param pathGlob - Glob pattern to match files
+ * @returns 'ok' if successful, 'err' if any errors occurred
+ */
+export declare const formatFiles: (pathGlob: string) => Promise<"ok" | "err">;
+/**
+ * Format only files that have been changed (git status)
+ * @returns 'ok' if successful, 'err' if any errors occurred
+ */
+export declare const formatChanged: () => Promise<"ok" | "err">;
+/**
+ * Format only files that differ from the specified base branch or commit
+ * @param base - Base branch name or commit hash to compare against (defaults to 'main')
+ * @returns 'ok' if successful, 'err' if any errors occurred
+ */
+export declare const formatDiffFrom: (base?: string) => Promise<"ok" | "err">;
+//# sourceMappingURL=format.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.mts","sourceRoot":"","sources":["../../src/functions/format.mts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,IAAI,GAAG,KAAK,CA6DxE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,IAAI,GAAG,KAAK,CAiF1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GACzB,OAAM,MAAe,KACpB,OAAO,CAAC,IAAI,GAAG,KAAK,CAsEtB,CAAC"}

package/dist/functions/format.mjs

@@ -0,0 +1,204 @@
+import glob_ from 'fast-glob';
+import { exec } from 'node:child_process';
+import { readFile, writeFile } from 'node:fs/promises';
+import { promisify } from 'node:util';
+import * as prettier from 'prettier';
+
+const execAsync = promisify(exec);
+/**
+ * Format files matching the given glob pattern using Prettier
+ * @param pathGlob - Glob pattern to match files
+ * @returns 'ok' if successful, 'err' if any errors occurred
+ */
+const formatFiles = async (pathGlob) => {
+    try {
+        // Find all files matching the glob
+        const files = await glob_(pathGlob, {
+            absolute: true,
+            ignore: ['**/node_modules/**', '**/.git/**'],
+            dot: true,
+        });
+        if (files.length === 0) {
+            console.log('No files found matching pattern:', pathGlob);
+            return 'ok';
+        }
+        console.log(`Formatting ${files.length} files...`);
+        // Format each file
+        const results = await Promise.allSettled(files.map(async (filePath) => {
+            try {
+                // Read file content
+                const content = await readFile(filePath, 'utf8');
+                // Resolve prettier config for this file
+                const options = await prettier.resolveConfig(filePath);
+                // Check if file is ignored by prettier
+                const fileInfo = await prettier.getFileInfo(filePath, {
+                    ignorePath: '.prettierignore',
+                });
+                if (fileInfo.ignored) {
+                    console.log(`Skipping ignored file: ${filePath}`);
+                    return;
+                }
+                // Format the content
+                const formatted = await prettier.format(content, {
+                    ...options,
+                    filepath: filePath,
+                });
+                // Only write if content changed
+                if (formatted !== content) {
+                    await writeFile(filePath, formatted, 'utf8');
+                    console.log(`Formatted: ${filePath}`);
+                }
+            }
+            catch (error) {
+                console.error(`Error formatting ${filePath}:`, error);
+                throw error;
+            }
+        }));
+        // Check if any formatting failed
+        const hasErrors = results.some((result) => result.status === 'rejected');
+        return hasErrors ? 'err' : 'ok';
+    }
+    catch (error) {
+        console.error('Error in formatFiles:', error);
+        return 'err';
+    }
+};
+/**
+ * Format only files that have been changed (git status)
+ * @returns 'ok' if successful, 'err' if any errors occurred
+ */
+const formatChanged = async () => {
+    try {
+        // Get changed files from git status
+        const { stdout, stderr } = await execAsync('git status --porcelain');
+        if (stderr !== '') {
+            console.error('Git error:', stderr);
+            return 'err';
+        }
+        // Parse git status output
+        const files = stdout
+            .split('\n')
+            .filter((line) => line.trim() !== '')
+            .map((line) => {
+            // Status format: "XY filename" where X and Y are status codes
+            const match = /^..\s+(.+)$/u.exec(line);
+            return match?.[1];
+        })
+            .filter((file) => 
+        // Filter out deleted files (status starts with 'D')
+        file !== undefined && !stdout.includes(`D  ${file}`));
+        if (files.length === 0) {
+            console.log('No changed files to format');
+            return 'ok';
+        }
+        console.log('Formatting changed files:', files);
+        // Format each changed file
+        const results = await Promise.allSettled(files.map(async (filePath) => {
+            try {
+                // Check if file exists and is not deleted
+                const content = await readFile(filePath, 'utf8').catch(() => null);
+                if (content === null) {
+                    console.log(`Skipping non-existent file: ${filePath}`);
+                    return;
+                }
+                // Resolve prettier config for this file
+                const options = await prettier.resolveConfig(filePath);
+                // Check if file is ignored by prettier
+                const fileInfo = await prettier.getFileInfo(filePath, {
+                    ignorePath: '.prettierignore',
+                });
+                if (fileInfo.ignored) {
+                    console.log(`Skipping ignored file: ${filePath}`);
+                    return;
+                }
+                // Format the content
+                const formatted = await prettier.format(content, {
+                    ...options,
+                    filepath: filePath,
+                });
+                // Only write if content changed
+                if (formatted !== content) {
+                    await writeFile(filePath, formatted, 'utf8');
+                    console.log(`Formatted: ${filePath}`);
+                }
+            }
+            catch (error) {
+                console.error(`Error formatting ${filePath}:`, error);
+                throw error;
+            }
+        }));
+        // Check if any formatting failed
+        const hasErrors = results.some((result) => result.status === 'rejected');
+        return hasErrors ? 'err' : 'ok';
+    }
+    catch (error) {
+        console.error('Error in formatChanged:', error);
+        return 'err';
+    }
+};
+/**
+ * Format only files that differ from the specified base branch or commit
+ * @param base - Base branch name or commit hash to compare against (defaults to 'main')
+ * @returns 'ok' if successful, 'err' if any errors occurred
+ */
+const formatDiffFrom = async (base = 'main') => {
+    try {
+        // Get files that differ from base branch/commit (excluding deleted files)
+        const { stdout, stderr } = await execAsync(`git diff --name-only ${base} --diff-filter=d`);
+        if (stderr !== '') {
+            console.error('Git error:', stderr);
+            return 'err';
+        }
+        // Parse git diff output
+        const files = stdout
+            .split('\n')
+            .map((line) => line.trim())
+            .filter((line) => line !== '');
+        if (files.length === 0) {
+            console.log(`No files differ from ${base}`);
+            return 'ok';
+        }
+        console.log(`Formatting files that differ from ${base}:`, files);
+        // Format each file
+        const results = await Promise.allSettled(files.map(async (filePath) => {
+            try {
+                // Read file content
+                const content = await readFile(filePath, 'utf8');
+                // Resolve prettier config for this file
+                const options = await prettier.resolveConfig(filePath);
+                // Check if file is ignored by prettier
+                const fileInfo = await prettier.getFileInfo(filePath, {
+                    ignorePath: '.prettierignore',
+                });
+                if (fileInfo.ignored) {
+                    console.log(`Skipping ignored file: ${filePath}`);
+                    return;
+                }
+                // Format the content
+                const formatted = await prettier.format(content, {
+                    ...options,
+                    filepath: filePath,
+                });
+                // Only write if content changed
+                if (formatted !== content) {
+                    await writeFile(filePath, formatted, 'utf8');
+                    console.log(`Formatted: ${filePath}`);
+                }
+            }
+            catch (error) {
+                console.error(`Error formatting ${filePath}:`, error);
+                throw error;
+            }
+        }));
+        // Check if any formatting failed
+        const hasErrors = results.some((result) => result.status === 'rejected');
+        return hasErrors ? 'err' : 'ok';
+    }
+    catch (error) {
+        console.error('Error in formatDiffFrom:', error);
+        return 'err';
+    }
+};
+
+export { formatChanged, formatDiffFrom, formatFiles };
+//# sourceMappingURL=format.mjs.map

package/dist/functions/format.mjs.map

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

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

@@ -0,0 +1,21 @@
+import '../node-global.mjs';
+/**
+ * Configuration for index file generation.
+ */
+export type GenIndexConfig = DeepReadonly<{
+    /** Target directories to generate index files for (string or array of strings) */
+    targetDirectory: string | string[];
+    /** File extension of source files to export (default: '.mts') */
+    sourceExtension?: `.${string}`;
+    /** File extension to use in export statements (default: '.mjs') */
+    exportExtension?: `.${string}`;
+    /** Glob patterns of files to exclude from exports (default: excludes .d.* and .test.* files) */
+    excludePatterns?: string[];
+}>;
+/**
+ * Generates index.mts files recursively in `config.targetDirectory`.
+ * @param config - Configuration for index file generation
+ * @throws Error if any step fails.
+ */
+export declare const genIndex: (config: GenIndexConfig) => Promise<void>;
+//# sourceMappingURL=gen-index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gen-index.d.mts","sourceRoot":"","sources":["../../src/functions/gen-index.mts"],"names":[],"mappings":"AACA,OAAO,oBAAoB,CAAC;AAI5B;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC;IACxC,kFAAkF;IAClF,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEnC,iEAAiE;IACjE,eAAe,CAAC,EAAE,IAAI,MAAM,EAAE,CAAC;IAE/B,mEAAmE;IACnE,eAAe,CAAC,EAAE,IAAI,MAAM,EAAE,CAAC;IAE/B,gGAAgG;IAChG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAU,QAAQ,cAAc,KAAG,OAAO,CAAC,IAAI,CA4DnE,CAAC"}

package/dist/functions/gen-index.mjs

@@ -0,0 +1,161 @@
+import micromatch from 'micromatch';
+import '../node-global.mjs';
+import { assertExt } from './assert-ext.mjs';
+import { assertPathExists } from './assert-path-exists.mjs';
+
+/**
+ * Generates index.mts files recursively in `config.targetDirectory`.
+ * @param config - Configuration for index file generation
+ * @throws Error if any step fails.
+ */
+const genIndex = async (config) => {
+    echo('Starting index file generation...\n');
+    // Merge config with defaults
+    const filledConfig = fillConfig(config);
+    // Normalize target directories to array
+    const targetDirs = typeof config.targetDirectory === 'string'
+        ? [config.targetDirectory]
+        : config.targetDirectory;
+    try {
+        // Step 1: Validate file extensions
+        echo('1. Validating file extensions...');
+        await assertExt({
+            directories: [
+                {
+                    path: path.resolve(projectRootPath, './src'),
+                    extension: '.mts',
+                    ignorePatterns: ['tsconfig.json', 'globals.d.mts'],
+                },
+                {
+                    path: path.resolve(projectRootPath, './scripts'),
+                    extension: '.mts',
+                    ignorePatterns: ['tsconfig.json'],
+                },
+            ],
+        });
+        echo('✓ File extensions validated\n');
+        // Step 2: Verify target directories exist
+        for (const dir of targetDirs) {
+            const resolvedDir = path.resolve(dir);
+            // eslint-disable-next-line no-await-in-loop
+            await assertPathExists(resolvedDir, `Target directory: ${dir}`);
+        }
+        // Step 3: Generate index files
+        echo('2. Generating index files...');
+        for (const dir of targetDirs) {
+            const resolvedDir = path.resolve(dir);
+            // eslint-disable-next-line no-await-in-loop
+            await generateIndexFileForDir(resolvedDir, filledConfig);
+        }
+        echo('✓ Index files generated\n');
+        // Step 4: Format generated files
+        echo('3. Formatting generated files...');
+        const fmtResult = await $('npm run fmt');
+        if (fmtResult.type === 'error') {
+            throw new Error(`Formatting failed: ${fmtResult.exception.message}`);
+        }
+        echo('✓ Formatting completed\n');
+        echo('✅ Index file generation completed successfully!\n');
+    }
+    catch (error) {
+        echo(`❌ Index generation failed: ${String(error)}\n`);
+        throw error;
+    }
+};
+const fillConfig = (config) => {
+    const sourceExtension = config.sourceExtension ?? '.mts';
+    const exportExtension = config.exportExtension ?? '.mjs'; // For ESM imports, .mts resolves to .mjs
+    return {
+        targetDirectory: config.targetDirectory,
+        sourceExtension,
+        exportExtension,
+        excludePatterns: config.excludePatterns ?? [
+            `*.d${sourceExtension}`,
+            `*.test${sourceExtension}`,
+        ],
+    };
+};
+/**
+ * Generates an index.mts file for the given directory.
+ * Recursively calls itself for subdirectories.
+ * @param dirPath - The absolute path to the directory to process.
+ * @param config - The merged configuration object.
+ * @param baseDir - The base directory path for calculating relative paths (optional, defaults to dirPath).
+ * @throws Error if directory processing fails.
+ */
+const generateIndexFileForDir = async (dirPath, config, baseDir) => {
+    try {
+        const actualBaseDir = baseDir ?? dirPath;
+        const entries = await fs.readdir(dirPath, { withFileTypes: true });
+        const subDirectories = [];
+        const filesToExport = [];
+        for (const entry of entries) {
+            const entryName = entry.name;
+            const entryPath = path.join(dirPath, entryName);
+            const relativePath = path.relative(actualBaseDir, entryPath);
+            if (entry.isDirectory()) {
+                subDirectories.push(entryName);
+                // Recursively call for subdirectories first
+                // eslint-disable-next-line no-await-in-loop
+                await generateIndexFileForDir(entryPath, config, actualBaseDir);
+            }
+            else if (entry.isFile() && shouldExportFile(relativePath, config)) {
+                filesToExport.push(entryName);
+            }
+        }
+        const indexContent = generateIndexContent(subDirectories, filesToExport, config);
+        const indexPath = path.join(dirPath, `index${config.sourceExtension}`);
+        await fs.writeFile(indexPath, indexContent);
+        echo(`Generated: ${path.relative(process.cwd(), indexPath)}`);
+    }
+    catch (error) {
+        throw new Error(`Failed to generate index for directory ${dirPath}: ${String(error)}`);
+    }
+};
+/**
+ * Determines if a file should be exported in the index file.
+ * @param filePath - The relative path to the file from the target directory.
+ * @param config - The merged configuration object.
+ * @returns True if the file should be exported.
+ */
+const shouldExportFile = (filePath, config) => {
+    const fileName = path.basename(filePath);
+    // Must have the correct source extension
+    if (!fileName.endsWith(config.sourceExtension)) {
+        return false;
+    }
+    // Don't export the index file itself
+    if (fileName === `index${config.sourceExtension}`) {
+        return false;
+    }
+    // Check against exclusion patterns
+    for (const pattern of config.excludePatterns) {
+        if (micromatch.isMatch(filePath, pattern) ||
+            micromatch.isMatch(fileName, pattern)) {
+            return false;
+        }
+    }
+    return true;
+};
+/**
+ * Generates the content for an index file.
+ * @param subDirectories - Array of subdirectory names.
+ * @param filesToExport - Array of file names to export.
+ * @param config - The merged configuration object.
+ * @returns The index file content.
+ */
+const generateIndexContent = (subDirectories, filesToExport, config) => {
+    const exportStatements = [
+        ...subDirectories.map((subDir) => `export * from "./${subDir}/index${config.exportExtension}";`),
+        ...filesToExport.map((file) => {
+            const fileNameWithoutExt = path.basename(file, config.sourceExtension);
+            return `export * from "./${fileNameWithoutExt}${config.exportExtension}";`;
+        }),
+    ];
+    return exportStatements.length === 0
+        ? 'export {};'
+        : exportStatements.join('\n');
+};
+
+export { genIndex };
+//# sourceMappingURL=gen-index.mjs.map

package/dist/functions/gen-index.mjs.map

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

package/dist/functions/index.d.mts

@@ -0,0 +1,7 @@
+export * from './assert-ext.mjs';
+export * from './assert-path-exists.mjs';
+export * from './assert-repo-is-dirty.mjs';
+export * from './exec-async.mjs';
+export * from './format.mjs';
+export * from './gen-index.mjs';
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +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,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/functions/index.mjs

@@ -0,0 +1,7 @@
+export { assertExt } from './assert-ext.mjs';
+export { assertPathExists, pathExists } from './assert-path-exists.mjs';
+export { assertRepoIsDirty, repoIsDirty } from './assert-repo-is-dirty.mjs';
+export { $ } from './exec-async.mjs';
+export { formatChanged, formatDiffFrom, formatFiles } from './format.mjs';
+export { genIndex } from './gen-index.mjs';
+//# sourceMappingURL=index.mjs.map

package/dist/functions/index.mjs.map

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

package/dist/globals.d.mts

@@ -0,0 +1 @@
+/// <reference types="ts-type-forge" />

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+export * from './functions/index.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/index.mjs

@@ -0,0 +1,7 @@
+export { assertExt } from './functions/assert-ext.mjs';
+export { assertPathExists, pathExists } from './functions/assert-path-exists.mjs';
+export { assertRepoIsDirty, repoIsDirty } from './functions/assert-repo-is-dirty.mjs';
+export { $ } from './functions/exec-async.mjs';
+export { formatChanged, formatDiffFrom, formatFiles } from './functions/format.mjs';
+export { genIndex } from './functions/gen-index.mjs';
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

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

package/dist/node-global.d.mts

@@ -0,0 +1,14 @@
+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 { projectRootPath as projectRootPath_ } from './project-root-path.mjs';
+declare global {
+    const $: typeof $_;
+    const echo: typeof console.log;
+    const projectRootPath: typeof projectRootPath_;
+    const path: typeof path_;
+    const fs: typeof fs_;
+    const glob: typeof glob_;
+}
+//# sourceMappingURL=node-global.d.mts.map

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

@@ -0,0 +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;AACnC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,eAAe,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAc9E,OAAO,CAAC,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,MAAM,IAAI,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IAC/B,MAAM,eAAe,EAAE,OAAO,gBAAgB,CAAC;IAE/C,MAAM,IAAI,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,EAAE,EAAE,OAAO,GAAG,CAAC;IACrB,MAAM,IAAI,EAAE,OAAO,KAAK,CAAC;CAC1B"}

package/dist/node-global.mjs

@@ -0,0 +1,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 { projectRootPath } from './project-root-path.mjs';
+
+const globalsDef = {
+    $: $,
+    echo: console.log,
+    projectRootPath: projectRootPath,
+    path: path,
+    fs: fs_,
+    glob: glob_,
+};
+Object.assign(globalThis, globalsDef);
+//# sourceMappingURL=node-global.mjs.map

package/dist/node-global.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-global.mjs","sources":["../src/node-global.mts"],"sourcesContent":[null],"names":["$_","projectRootPath_","path_"],"mappings":";;;;;;AAMA,MAAM,UAAU,GAAG;AACjB,IAAA,CAAC,EAAEA,CAAE;IACL,IAAI,EAAE,OAAO,CAAC,GAAG;AACjB,IAAA,eAAe,EAAEC,eAAgB;AAEjC,IAAA,IAAI,EAAEC,IAAK;AACX,IAAA,EAAE,EAAE,GAAG;AACP,IAAA,IAAI,EAAE,KAAK;CACH;AAEV,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC"}

package/dist/project-root-path.d.mts

@@ -0,0 +1,2 @@
+export declare const projectRootPath: string;
+//# sourceMappingURL=project-root-path.d.mts.map

package/dist/project-root-path.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root-path.d.mts","sourceRoot":"","sources":["../src/project-root-path.mts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,QAA0C,CAAC"}

package/dist/project-root-path.mjs

@@ -0,0 +1,6 @@
+import * as path from 'node:path';
+
+const projectRootPath = path.resolve(import.meta.dirname, '..');
+
+export { projectRootPath };
+//# sourceMappingURL=project-root-path.mjs.map

package/dist/project-root-path.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root-path.mjs","sources":["../src/project-root-path.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAEa,MAAA,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI;;;;"}

package/dist/tsconfig.json

@@ -0,0 +1 @@
+{"include":["."]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-repo-utils",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "private": false,
   "keywords": [
     "typescript"

package/src/functions/assert-ext.mts

@@ -18,8 +18,8 @@ export type CheckExtConfig = DeepReadonly<{
 
 /**
  * Validates that all files in specified directories have the correct extensions.
+ * Exits with code 1 if any files have incorrect extensions.
  * @param config - Configuration specifying directories and expected extensions.
- * @throws Error with details of all incorrect files found.
  */
 export const assertExt = async (config: CheckExtConfig): Promise<void> => {
   const allIncorrectFiles: string[] = [];
@@ -76,7 +76,8 @@ export const assertExt = async (config: CheckExtConfig): Promise<void> => {
       generateErrorMessage(),
     ].join('\n');
 
-    throw new Error(errorMessage);
+    echo(errorMessage);
+    process.exit(1);
   }
 
   echo('✓ All files have correct extensions');

package/src/functions/assert-path-exists.mts

@@ -1,4 +1,5 @@
 import * as fs from 'node:fs/promises';
+import '../node-global.mjs';
 
 /**
  * Checks if a file or directory exists.
@@ -15,16 +16,16 @@ export const pathExists = async (filePath: string): Promise<boolean> => {
 };
 
 /**
- * Validates that a path exists and throws if it doesn't.
+ * Validates that a path exists and exits with code 1 if it doesn't.
  * @param filePath - The path to validate.
- * @param description - Description for error message.
- * @throws Error if path doesn't exist.
+ * @param description - Description for error message (defaults to 'Path').
  */
 export const assertPathExists = async (
   filePath: string,
   description = 'Path',
 ): Promise<void> => {
   if (!(await pathExists(filePath))) {
-    throw new Error(`${description} does not exist: ${filePath}`);
+    echo(`${description} does not exist: ${filePath}`);
+    process.exit(1);
   }
 };

package/src/functions/assert-repo-is-dirty.mts

@@ -12,7 +12,7 @@ export const repoIsDirty = async (): Promise<boolean> => {
 
 /**
  * Checks if the repository is dirty and exits with code 1 if it is.
- * @throws Error if git command fails.
+ * Shows git status and diff output before exiting.
  */
 export const assertRepoIsDirty = async (): Promise<void> => {
   try {