ts-repo-utils 5.2.1 → 6.0.0

package/dist/functions/gen-index.mjs

@@ -3,6 +3,13 @@ import { Result, ISet, pipe, Arr, isString } from 'ts-data-forge';
 import '../node-global.mjs';
 import { assertPathExists } from './assert-path-exists.mjs';
 
+const defaultConfig = {
+    exclude: ['**/*.{test,spec}.?(c|m)[jt]s?(x)', '**/*.d.?(c|m)ts'],
+    targetExtensions: ['.ts', '.tsx'],
+    indexFileExtension: '.ts',
+    exportStatementExtension: '.js', // For ESM imports, .mts resolves to .mjs
+    silent: false,
+};
 /**
  * Generates index.ts files recursively in `config.targetDirectory`.
  *
@@ -51,21 +58,20 @@ const genIndex = async (config) => {
     }
 };
 const fillConfig = (config) => {
-    const sourceExtensions = config.sourceExtensions ?? ['.ts'];
-    const exportExtension = config.exportExtension ?? '.js'; // For ESM imports, .mts resolves to .mjs
+    const targetExtensions = config.targetExtensions ?? defaultConfig.targetExtensions;
+    const exportExtension = config.exportStatementExtension ?? defaultConfig.exportStatementExtension;
     return {
         formatCommand: config.formatCommand,
         targetDirectory: ISet.create(isString(config.targetDirectory)
             ? [config.targetDirectory]
             : config.targetDirectory),
-        // eslint-disable-next-line @typescript-eslint/no-deprecated
-        exclude: pipe(config.exclude ?? config.excludePatterns).map((exclude) => typeof exclude === 'function'
+        exclude: pipe(config.exclude).map((exclude) => typeof exclude === 'function'
             ? exclude
             : pipe(ISet.create(Arr.generate(function* () {
                 if (exclude !== undefined && Array.isArray(exclude)) {
                     yield* exclude;
                 }
-                yield '**/*.{test,spec}.?(c|m)[jt]s?(x)';
+                yield* defaultConfig.exclude;
             }))).map((set) => ({ relativePath, fileName, }) => {
                 for (const pattern of set.values()) {
                     if (micromatch.isMatch(relativePath, pattern) ||
@@ -75,10 +81,10 @@ const fillConfig = (config) => {
                 }
                 return false;
             }).value).value,
-        sourceExtensions: ISet.create(sourceExtensions),
-        indexExtension: config.indexExtension ?? '.ts',
-        exportExtension,
-        silent: config.silent ?? false,
+        targetExtensions: ISet.create(targetExtensions),
+        indexFileExtension: config.indexFileExtension ?? defaultConfig.indexFileExtension,
+        exportStatementExtension: exportExtension,
+        silent: config.silent ?? defaultConfig.silent,
     };
 };
 /**
@@ -124,7 +130,7 @@ const generateIndexFileForDir = async (dirPath, config, baseDir) => {
             }
         }
         const indexContent = generateIndexContent(mut_subDirectories, mut_filesToExport, config);
-        const indexPath = path.join(dirPath, `index${config.indexExtension}`);
+        const indexPath = path.join(dirPath, `index${config.indexFileExtension}`);
         await fs.writeFile(indexPath, indexContent);
         echo(`Generated: ${path.relative(process.cwd(), indexPath)}`);
     }
@@ -150,7 +156,7 @@ const shouldExportFile = ({ absolutePath, filePath, config, }) => {
     const fileName = path.basename(filePath);
     const ext = path.extname(fileName);
     // Must have the correct source extension
-    if (!config.sourceExtensions.has(ext)) {
+    if (!config.targetExtensions.has(ext)) {
         return false;
     }
     // Don't export the index file itself
@@ -178,14 +184,14 @@ const shouldExportFile = ({ absolutePath, filePath, config, }) => {
  */
 const generateIndexContent = (subDirectories, filesToExport, config) => {
     const exportStatements = [
-        ...subDirectories.map((subDir) => config.exportExtension === 'none'
+        ...subDirectories.map((subDir) => config.exportStatementExtension === 'none'
             ? `export * from "./${subDir}";`
-            : `export * from "./${subDir}/index${config.exportExtension}";`),
+            : `export * from "./${subDir}/index${config.exportStatementExtension}";`),
         ...filesToExport.map((file) => {
             const fileNameWithoutExt = path.basename(file, path.extname(file));
-            return config.exportExtension === 'none'
+            return config.exportStatementExtension === 'none'
                 ? `export * from "./${fileNameWithoutExt}";`
-                : `export * from "./${fileNameWithoutExt}${config.exportExtension}";`;
+                : `export * from "./${fileNameWithoutExt}${config.exportStatementExtension}";`;
         }),
     ];
     return exportStatements.length === 0

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

@@ -1 +1 @@
-{"version":3,"file":"gen-index.mjs","sources":["../../src/functions/gen-index.mts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"gen-index.mjs","sources":["../../src/functions/gen-index.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAyCA,MAAM,aAAa,GAAG;AACpB,IAAA,OAAO,EAAE,CAAC,kCAAkC,EAAE,iBAAiB,CAAC;AAChE,IAAA,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;AACjC,IAAA,kBAAkB,EAAE,KAAK;IACzB,wBAAwB,EAAE,KAAK;AAC/B,IAAA,MAAM,EAAE,KAAK;CAGd;AAkBD;;;;;AAKG;MACU,QAAQ,GAAG,OAAO,MAAsB,KAAmB;IACtE,IAAI,CAAC,qCAAqC,CAAC;;AAG3C,IAAA,MAAM,YAAY,GAA2B,UAAU,CAAC,MAAM,CAAC;;AAG/D,IAAA,MAAM,UAAU,GACd,OAAO,MAAM,CAAC,eAAe,KAAK;AAChC,UAAE,CAAC,MAAM,CAAC,eAAe;AACzB,UAAE,MAAM,CAAC,eAAe;AAE5B,IAAA,IAAI;;AAEF,QAAA,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE;YAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;;YAErC,MAAM,gBAAgB,CAAC,WAAW,EAAE,qBAAqB,GAAG,CAAA,CAAE,CAAC;QACjE;;QAGA,IAAI,CAAC,2BAA2B,CAAC;AACjC,QAAA,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE;YAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;;AAErC,YAAA,MAAM,uBAAuB,CAAC,WAAW,EAAE,YAAY,CAAC;QAC1D;QACA,IAAI,CAAC,2BAA2B,CAAC;;AAGjC,QAAA,IAAI,YAAY,CAAC,aAAa,KAAK,SAAS,EAAE;YAC5C,IAAI,CAAC,+BAA+B,CAAC;YACrC,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,YAAY,CAAC,aAAa,EAAE;gBACpD,MAAM,EAAE,YAAY,CAAC,MAAM;AAC5B,aAAA,CAAC;AACF,YAAA,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;gBAC3B,MAAM,IAAI,KAAK,CAAC,CAAA,mBAAA,EAAsB,SAAS,CAAC,KAAK,CAAC,OAAO,CAAA,CAAE,CAAC;YAClE;YACA,IAAI,CAAC,0BAA0B,CAAC;QAClC;QAEA,IAAI,CAAC,mDAAmD,CAAC;IAC3D;IAAE,OAAO,KAAK,EAAE;QACd,IAAI,CAAC,8BAA8B,MAAM,CAAC,KAAK,CAAC,CAAA,EAAA,CAAI,CAAC;AACrD,QAAA,MAAM,KAAK;IACb;AACF;AAEA,MAAM,UAAU,GAAG,CAAC,MAAsB,KAA4B;IACpE,MAAM,gBAAgB,GACpB,MAAM,CAAC,gBAAgB,IAAI,aAAa,CAAC,gBAAgB;IAE3D,MAAM,eAAe,GACnB,MAAM,CAAC,wBAAwB,IAAI,aAAa,CAAC,wBAAwB;IAE3E,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,eAAe,EAAE,IAAI,CAAC,MAAM,CAC1B,QAAQ,CAAC,MAAM,CAAC,eAAe;AAC7B,cAAE,CAAC,MAAM,CAAC,eAAe;AACzB,cAAE,MAAM,CAAC,eAAe,CAC3B;AACD,QAAA,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,KACxC,OAAO,OAAO,KAAK;AACjB,cAAE;AACF,cAAE,IAAI,CACF,IAAI,CAAC,MAAM,CACT,GAAG,CAAC,QAAQ,CAAC,aAAS;gBACpB,IAAI,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;oBACnD,OAAO,OAAO;gBAChB;AACA,gBAAA,OAAO,aAAa,CAAC,OAAO;AAC9B,YAAA,CAAC,CAAC,CACH,CACF,CAAC,GAAG,CACH,CAAC,GAAG,KACF,CAAC,EACC,YAAY,EACZ,QAAQ,GAKR,KAAI;gBACJ,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,EAAE;AAClC,oBAAA,IACE,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC;wBACzC,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,EACrC;AACA,wBAAA,OAAO,IAAI;oBACb;gBACF;AACA,gBAAA,OAAO,KAAK;AACd,YAAA,CAAC,CACJ,CAAC,KAAK,CACZ,CAAC,KAAK;AACP,QAAA,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;AAC/C,QAAA,kBAAkB,EAChB,MAAM,CAAC,kBAAkB,IAAI,aAAa,CAAC,kBAAkB;AAC/D,QAAA,wBAAwB,EAAE,eAAe;AACzC,QAAA,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM;KAC9C;AACH,CAAC;AAED;;;;;;;;;AASG;AACH,MAAM,uBAAuB,GAAG,OAC9B,OAAe,EACf,MAA8B,EAC9B,OAAgB,KACC;AACjB,IAAA,IAAI;AACF,QAAA,MAAM,aAAa,GAAG,OAAO,IAAI,OAAO;AACxC,QAAA,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QAElE,MAAM,kBAAkB,GAAa,EAAE;QACvC,MAAM,iBAAiB,GAAa,EAAE;AAEtC,QAAA,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE;AAC3B,YAAA,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI;YAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC;YAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC;YAE5D,IACE,MAAM,CAAC,OAAO,CAAC;AACb,gBAAA,YAAY,EAAE,SAAS;gBACvB,YAAY;AACZ,gBAAA,QAAQ,EAAE,SAAS;AACpB,aAAA,CAAC,EACF;AACA,gBAAA,SAAS;YACX;AAEA,YAAA,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE;AACvB,gBAAA,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC;;;gBAGlC,MAAM,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC;YACjE;iBAAO,IACL,KAAK,CAAC,MAAM,EAAE;AACd,gBAAA,gBAAgB,CAAC;AACf,oBAAA,YAAY,EAAE,SAAS;AACvB,oBAAA,QAAQ,EAAE,YAAY;oBACtB,MAAM;AACP,iBAAA,CAAC,EACF;AACA,gBAAA,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC;YACnC;QACF;QAEA,MAAM,YAAY,GAAG,oBAAoB,CACvC,kBAAkB,EAClB,iBAAiB,EACjB,MAAM,CACP;AAED,QAAA,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAA,KAAA,EAAQ,MAAM,CAAC,kBAAkB,CAAA,CAAE,CAAC;QAEzE,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,YAAY,CAAC;AAC3C,QAAA,IAAI,CAAC,CAAA,WAAA,EAAc,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAA,CAAE,CAAC;IAC/D;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,MAAM,IAAI,KAAK,CACb,CAAA,uCAAA,EAA0C,OAAO,CAAA,EAAA,EAAK,MAAM,CAAC,KAAK,CAAC,CAAA,CAAE,CACtE;IACH;AACF,CAAC;AAED,MAAM,UAAU,GAAG,0BAA0B;AAE7C;;;;;;;;;;;;AAYG;AACH,MAAM,gBAAgB,GAAG,CAAC,EACxB,YAAY,EACZ,QAAQ,EACR,MAAM,GAKN,KAAa;IACb,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAExC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;;IAGlC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;AACrC,QAAA,OAAO,KAAK;IACd;;AAGA,IAAA,IACE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;MACzB;AACA,QAAA,OAAO,KAAK;IACd;;IAGA,IACE,MAAM,CAAC,OAAO,CAAC;QACb,YAAY;AACZ,QAAA,YAAY,EAAE,QAAQ;QACtB,QAAQ;AACT,KAAA,CAAC,EACF;AACA,QAAA,OAAO,KAAK;IACd;AAEA,IAAA,OAAO,IAAI;AACb,CAAC;AAqBD;;;;;;;AAOG;AACH,MAAM,oBAAoB,GAAG,CAC3B,cAAiC,EACjC,aAAgC,EAChC,MAA8B,KACpB;AACV,IAAA,MAAM,gBAAgB,GAAG;AACvB,QAAA,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,KAC3B,MAAM,CAAC,wBAAwB,KAAK;cAChC,CAAA,iBAAA,EAAoB,MAAM,CAAA,EAAA;cAC1B,oBAAoB,MAAM,CAAA,MAAA,EAAS,MAAM,CAAC,wBAAwB,IAAI,CAC3E;AACD,QAAA,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,KAAI;AAC5B,YAAA,MAAM,kBAAkB,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAElE,YAAA,OAAO,MAAM,CAAC,wBAAwB,KAAK;kBACvC,CAAA,iBAAA,EAAoB,kBAAkB,CAAA,EAAA;kBACtC,oBAAoB,kBAAkB,CAAA,EAAG,MAAM,CAAC,wBAAwB,IAAI;AAClF,QAAA,CAAC,CAAC;KACH;AAED,IAAA,OAAO,gBAAgB,CAAC,MAAM,KAAK;AACjC,UAAE;AACF,UAAE,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;;;;"}

package/dist/functions/should-run.d.mts

@@ -1,20 +1,60 @@
 import '../node-global.mjs';
 /**
- * Checks if TypeScript type checks should run based on the diff from
- * origin/main. Skips type checks if all changed files are documentation files,
- * spell check config, or other non-TypeScript files that don't affect type
- * checking.
+ * Checks if TypeScript type checks should run based on the diff from a base
+ * branch. Skips type checks if all changed files match the ignored patterns.
  *
- * Ignored file patterns:
+ * This function is typically used in CI/CD pipelines to determine whether
+ * expensive type checking operations should be performed. If all changed files
+ * are documentation, configuration, or other non-TypeScript files, type checks
+ * can be safely skipped to improve build performance.
  *
- * - '.cspell.json'
- * - '**.md'
- * - '**.txt'
- * - 'docs/**'
+ * @example
+ *   ```typescript
+ *   // Use default settings (compare against origin/main, ignore docs/md/txt files)
+ *   await checkShouldRunTypeChecks();
  *
- * @returns A promise that resolves when the check is complete. Sets
- *   GITHUB_OUTPUT environment variable with should_run=true/false if running in
- *   GitHub Actions.
+ *   // Custom ignore patterns
+ *   await checkShouldRunTypeChecks({
+ *     pathsIgnore: ['.eslintrc.json', 'docs/', '**.md', 'scripts/'],
+ *   });
+ *
+ *   // Custom base branch
+ *   await checkShouldRunTypeChecks({
+ *     baseBranch: 'origin/develop',
+ *   });
+ *   ```;
+ *
+ * @example
+ *   GitHub Actions usage
+ *   ```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
+ *   ```
+ *
+ * @param options - Configuration options
+ * @param options.pathsIgnore - Array of patterns to ignore when determining if
+ *   type checks should run. Supports three pattern types:
+ *
+ *   - **Exact file matches**: e.g., `.cspell.json` matches only that file
+ *   - **Directory prefixes**: e.g., `docs/` matches any file in docs directory
+ *   - **File extensions**: e.g., `**.md` matches any markdown file Defaults to:
+ *       `['LICENSE', '.editorconfig', '.gitignore', '.cspell.json',
+ *       '.markdownlint-cli2.mjs', '.npmignore', '.prettierignore',
+ *       '.prettierrc', 'docs/', '**.md', '**.txt']`
+ *
+ * @param options.baseBranch - Base branch to compare against for determining
+ *   changed files. Defaults to `'origin/main'`
+ * @returns A promise that resolves when the check is complete. The function
+ *   will set the GITHUB_OUTPUT environment variable with `should_run=true` or
+ *   `should_run=false` if running in GitHub Actions environment.
  */
-export declare const checkShouldRunTypeChecks: () => Promise<void>;
+export declare const checkShouldRunTypeChecks: (options?: Readonly<{
+    pathsIgnore?: readonly string[];
+    baseBranch?: string;
+}>) => Promise<void>;
 //# sourceMappingURL=should-run.d.mts.map

package/dist/functions/should-run.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"should-run.d.mts","sourceRoot":"","sources":["../../src/functions/should-run.mts"],"names":[],"mappings":"AACA,OAAO,oBAAoB,CAAC;AAG5B;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,wBAAwB,QAAa,OAAO,CAAC,IAAI,CA4B7D,CAAC"}
+{"version":3,"file":"should-run.d.mts","sourceRoot":"","sources":["../../src/functions/should-run.mts"],"names":[],"mappings":"AACA,OAAO,oBAAoB,CAAC;AAG5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,QAAQ,CAAC;IACjB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC,KACD,OAAO,CAAC,IAAI,CAmDd,CAAC"}

package/dist/functions/should-run.mjs

@@ -1,39 +1,98 @@
-import { Result, pipe } from 'ts-data-forge';
+import { Result } from 'ts-data-forge';
 import '../node-global.mjs';
 import { getDiffFrom } from './diff.mjs';
 
 /**
- * Checks if TypeScript type checks should run based on the diff from
- * origin/main. Skips type checks if all changed files are documentation files,
- * spell check config, or other non-TypeScript files that don't affect type
- * checking.
+ * Checks if TypeScript type checks should run based on the diff from a base
+ * branch. Skips type checks if all changed files match the ignored patterns.
  *
- * Ignored file patterns:
+ * This function is typically used in CI/CD pipelines to determine whether
+ * expensive type checking operations should be performed. If all changed files
+ * are documentation, configuration, or other non-TypeScript files, type checks
+ * can be safely skipped to improve build performance.
  *
- * - '.cspell.json'
- * - '**.md'
- * - '**.txt'
- * - 'docs/**'
+ * @example
+ *   ```typescript
+ *   // Use default settings (compare against origin/main, ignore docs/md/txt files)
+ *   await checkShouldRunTypeChecks();
  *
- * @returns A promise that resolves when the check is complete. Sets
- *   GITHUB_OUTPUT environment variable with should_run=true/false if running in
- *   GitHub Actions.
+ *   // Custom ignore patterns
+ *   await checkShouldRunTypeChecks({
+ *     pathsIgnore: ['.eslintrc.json', 'docs/', '**.md', 'scripts/'],
+ *   });
+ *
+ *   // Custom base branch
+ *   await checkShouldRunTypeChecks({
+ *     baseBranch: 'origin/develop',
+ *   });
+ *   ```;
+ *
+ * @example
+ *   GitHub Actions usage
+ *   ```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
+ *   ```
+ *
+ * @param options - Configuration options
+ * @param options.pathsIgnore - Array of patterns to ignore when determining if
+ *   type checks should run. Supports three pattern types:
+ *
+ *   - **Exact file matches**: e.g., `.cspell.json` matches only that file
+ *   - **Directory prefixes**: e.g., `docs/` matches any file in docs directory
+ *   - **File extensions**: e.g., `**.md` matches any markdown file Defaults to:
+ *       `['LICENSE', '.editorconfig', '.gitignore', '.cspell.json',
+ *       '.markdownlint-cli2.mjs', '.npmignore', '.prettierignore',
+ *       '.prettierrc', 'docs/', '**.md', '**.txt']`
+ *
+ * @param options.baseBranch - Base branch to compare against for determining
+ *   changed files. Defaults to `'origin/main'`
+ * @returns A promise that resolves when the check is complete. The function
+ *   will set the GITHUB_OUTPUT environment variable with `should_run=true` or
+ *   `should_run=false` if running in GitHub Actions environment.
  */
-const checkShouldRunTypeChecks = async () => {
-    // paths-ignore:
-    //   - '.cspell.json'
-    //   - '**.md'
-    //   - '**.txt'
-    //   - 'docs/**'
+const checkShouldRunTypeChecks = async (options) => {
+    const pathsIgnore = options?.pathsIgnore ?? [
+        'LICENSE',
+        '.editorconfig',
+        '.gitignore',
+        '.cspell.json',
+        '.markdownlint-cli2.mjs',
+        '.npmignore',
+        '.prettierignore',
+        '.prettierrc',
+        'docs/',
+        '**.md',
+        '**.txt',
+    ];
+    const baseBranch = options?.baseBranch ?? 'origin/main';
     const GITHUB_OUTPUT = process.env['GITHUB_OUTPUT'];
-    const files = await getDiffFrom('origin/main');
+    const files = await getDiffFrom(baseBranch);
     if (Result.isErr(files)) {
         console.error('Error getting diff:', files.value);
         process.exit(1);
     }
-    const shouldRunTsChecks = !files.value.every((file) => file === '.cspell.json' ||
-        file.startsWith('docs/') ||
-        pipe(path.basename(file)).map((filename) => filename.endsWith('.md') || filename.endsWith('.txt')).value);
+    const shouldRunTsChecks = !files.value.every((file) => pathsIgnore.some((pattern) => {
+        // Exact file match
+        if (pattern === file) {
+            return true;
+        }
+        // Directory prefix match (pattern ends with '/')
+        if (pattern.endsWith('/') && file.startsWith(pattern)) {
+            return true;
+        }
+        // File extension pattern match (pattern starts with '**.')
+        if (pattern.startsWith('**.')) {
+            const extension = pattern.slice(2); // Remove '**'
+            return path.basename(file).endsWith(extension);
+        }
+        return false;
+    }));
     if (GITHUB_OUTPUT !== undefined) {
         await fs.appendFile(GITHUB_OUTPUT, `should_run=${shouldRunTsChecks}\n`);
     }

package/dist/functions/should-run.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"should-run.mjs","sources":["../../src/functions/should-run.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAIA;;;;;;;;;;;;;;;;AAgBG;AACI,MAAM,wBAAwB,GAAG,YAA0B;;;;;;IAOhE,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AAElD,IAAA,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC;AAE9C,IAAA,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QACvB,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,KAAK,CAAC;AACjD,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;AAEA,IAAA,MAAM,iBAAiB,GAAY,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CACnD,CAAC,IAAI,KACH,IAAI,KAAK,cAAc;AACvB,QAAA,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;AACxB,QAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAC3B,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CACpE,CAAC,KAAK,CACV;AAED,IAAA,IAAI,aAAa,KAAK,SAAS,EAAE;QAC/B,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,EAAE,CAAA,WAAA,EAAc,iBAAiB,CAAA,EAAA,CAAI,CAAC;IACzE;AACF;;;;"}
+{"version":3,"file":"should-run.mjs","sources":["../../src/functions/should-run.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqDG;MACU,wBAAwB,GAAG,OACtC,OAGE,KACe;AACjB,IAAA,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI;QAC1C,SAAS;QACT,eAAe;QACf,YAAY;QACZ,cAAc;QACd,wBAAwB;QACxB,YAAY;QACZ,iBAAiB;QACjB,aAAa;QACb,OAAO;QACP,OAAO;QACP,QAAQ;KACT;AAED,IAAA,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,aAAa;IAEvD,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AAElD,IAAA,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC;AAE3C,IAAA,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QACvB,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,KAAK,CAAC;AACjD,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjB;IAEA,MAAM,iBAAiB,GAAY,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,KACzD,WAAW,CAAC,IAAI,CAAC,CAAC,OAAO,KAAI;;AAE3B,QAAA,IAAI,OAAO,KAAK,IAAI,EAAE;AACpB,YAAA,OAAO,IAAI;QACb;;AAGA,QAAA,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE;AACrD,YAAA,OAAO,IAAI;QACb;;AAGA,QAAA,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE;YAC7B,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;QAChD;AAEA,QAAA,OAAO,KAAK;IACd,CAAC,CAAC,CACH;AAED,IAAA,IAAI,aAAa,KAAK,SAAS,EAAE;QAC/B,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,EAAE,CAAA,WAAA,EAAc,iBAAiB,CAAA,EAAA,CAAI,CAAC;IACzE;AACF;;;;"}

package/dist/index.d.mts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-repo-utils",
-  "version": "5.2.1",
+  "version": "6.0.0",
   "private": false,
   "keywords": [
     "typescript"
@@ -23,6 +23,13 @@
   },
   "module": "./dist/index.mjs",
   "types": "./dist/type.d.mts",
+  "bin": {
+    "assert-repo-is-clean": "./src/cmd/assert-repo-is-clean.mts",
+    "check-should-run-type-checks": "./src/cmd/check-should-run-type-checks.mts",
+    "format-diff-from": "./src/cmd/format-diff-from.mts",
+    "format-untracked": "./src/cmd/format-untracked.mts",
+    "gen-index-ts": "./src/cmd/gen-index-ts.mts"
+  },
   "files": [
     "src",
     "dist",
@@ -35,12 +42,14 @@
     "check:ext": "tsx ./scripts/cmd/check-ext.mjs",
     "cspell": "cspell \"**\" --gitignore --gitignore-root ./ --no-progress",
     "doc": "tsx ./scripts/cmd/gen-docs.mjs",
-    "fmt": "tsx ./scripts/cmd/fmt-diff.mjs",
+    "fmt": "npm exec -- format-diff-from origin/main",
     "fmt:full": "prettier --write .",
-    "gi": "tsx ./scripts/cmd/gi.mjs",
+    "gi": "npm exec -- gen-index-ts ./src/functions --index-ext .mts --export-ext .mjs --target-ext .mts --target-ext .tsx --fmt 'npm run fmt'",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "md": "markdownlint-cli2",
+    "prepare-release": "run-s sync-cli-versions fmt build doc",
+    "sync-cli-versions": "tsx scripts/cmd/sync-cli-versions.mts",
     "test": "npm run z:vitest -- run",
     "test:cov": "npm run z:vitest -- run --coverage",
     "test:cov:ui": "vite preview --outDir ./coverage",
@@ -54,10 +63,12 @@
   },
   "dependencies": {
     "@types/micromatch": "^4.0.9",
+    "cmd-ts": "^0.13.0",
     "fast-glob": "^3.3.3",
     "micromatch": "^4.0.8",
     "prettier": "^3.6.2",
-    "ts-data-forge": "^3.0.5"
+    "ts-data-forge": "^3.0.5",
+    "tsx": "^4.20.3"
   },
   "devDependencies": {
     "@eslint/js": "^9.31.0",
@@ -88,16 +99,16 @@
     "eslint-plugin-unicorn": "60.0.0",
     "eslint-plugin-vitest": "0.5.4",
     "markdownlint-cli2": "^0.18.1",
+    "npm-run-all2": "^8.0.4",
     "prettier-plugin-jsdoc": "^1.3.3",
     "prettier-plugin-organize-imports": "^4.2.0",
     "prettier-plugin-packagejson": "^2.5.19",
-    "rollup": "^4.45.1",
+    "rollup": "^4.46.2",
     "semantic-release": "^24.2.7",
     "ts-type-forge": "^2.1.1",
     "tslib": "^2.8.1",
-    "tsx": "^4.20.3",
     "typedoc": "^0.28.7",
-    "typedoc-plugin-markdown": "^4.7.1",
+    "typedoc-plugin-markdown": "^4.8.0",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.38.0",
     "vitest": "^3.2.4"

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

@@ -0,0 +1,28 @@
+#!/usr/bin/env -S npx tsx
+
+import * as cmd from 'cmd-ts';
+import { assertRepoIsClean } from '../functions/index.mjs';
+
+const cmdDef = cmd.command({
+  name: 'assert-repo-is-clean-cli',
+  version: '6.0.0',
+  args: {
+    silent: cmd.flag({
+      long: 'silent',
+      type: cmd.optional(cmd.boolean),
+      description: 'If true, suppresses output messages (default: false)',
+    }),
+  },
+  handler: (args) => {
+    main(args).catch((error) => {
+      console.error('An error occurred:', error);
+      process.exit(1);
+    });
+  },
+});
+
+const main = async (args: Readonly<{ silent?: boolean }>): Promise<void> => {
+  await assertRepoIsClean({ silent: args.silent });
+};
+
+await cmd.run(cmdDef, process.argv.slice(2));

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

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

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

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

package/src/cmd/format-untracked.mts

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