ts-codemod-lib 1.0.1 → 1.1.0

package/dist/functions/ast-transformers/index.d.mts

@@ -1,6 +1,8 @@
+export * from './append-as-const.mjs';
 export * from './convert-interface-to-type.mjs';
 export * from './convert-to-readonly-type.mjs';
 export * from './readonly-transformer-helpers/index.mjs';
+export * from './replace-any-with-unknown.mjs';
 export * from './replace-record-with-unknown-record.mjs';
 export * from './transform-source-code.mjs';
 export * from './types.mjs';

package/dist/functions/ast-transformers/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/functions/ast-transformers/index.mts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0CAA0C,CAAC;AACzD,cAAc,0CAA0C,CAAC;AACzD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/functions/ast-transformers/index.mts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0CAA0C,CAAC;AACzD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,aAAa,CAAC"}

package/dist/functions/ast-transformers/index.mjs

@@ -1,9 +1,11 @@
+export { appendAsConstTransformer } from './append-as-const.mjs';
 export { convertInterfaceToTypeTransformer } from './convert-interface-to-type.mjs';
 export { convertToReadonlyTypeTransformer } from './convert-to-readonly-type.mjs';
 export { compareUnionIntersectionTypes } from './readonly-transformer-helpers/compare-union-types.mjs';
 export { invalidDeepReadonlyTypeName } from './readonly-transformer-helpers/constants.mjs';
 export { groupUnionIntersectionTypes } from './readonly-transformer-helpers/group-union-types.mjs';
 export { nextReadonlyContext } from './readonly-transformer-helpers/readonly-context.mjs';
+export { replaceAnyWithUnknownTransformer } from './replace-any-with-unknown.mjs';
 export { replaceRecordWithUnknownRecordTransformer } from './replace-record-with-unknown-record.mjs';
 export { transformSourceCode } from './transform-source-code.mjs';
 //# sourceMappingURL=index.mjs.map

package/dist/functions/ast-transformers/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/ast-transformers/replace-any-with-unknown.d.mts

@@ -0,0 +1,3 @@
+import { type TsMorphTransformer } from './types.mjs';
+export declare const replaceAnyWithUnknownTransformer: () => TsMorphTransformer;
+//# sourceMappingURL=replace-any-with-unknown.d.mts.map

package/dist/functions/ast-transformers/replace-any-with-unknown.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-any-with-unknown.d.mts","sourceRoot":"","sources":["../../../src/functions/ast-transformers/replace-any-with-unknown.mts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,gCAAgC,QAAO,kBAA0B,CAAC"}

package/dist/functions/ast-transformers/replace-any-with-unknown.mjs

@@ -0,0 +1,38 @@
+import * as tsm from 'ts-morph';
+import { hasDisableNextLineComment } from '../functions/has-disable-next-line-comment.mjs';
+import '../functions/is-primitive-type-node.mjs';
+import 'ts-data-forge';
+import { isSpreadParameterNode, isSpreadNamedTupleMemberNode } from '../functions/is-spread-parameter-node.mjs';
+
+const replaceAnyWithUnknownTransformer = () => body;
+const body = (sourceAst) => {
+    for (const node of sourceAst.getChildren()) {
+        transformNode(node);
+    }
+};
+const transformNode = (node) => {
+    if (hasDisableNextLineComment(node)) {
+        console.debug('skipped by disable-next-line comment');
+        return;
+    }
+    if (node.isKind(tsm.SyntaxKind.AnyKeyword)) {
+        const anyKeywordNode = node;
+        const parent = anyKeywordNode.getParent();
+        if (parent !== undefined &&
+            // `(...args: any) => any` -> `(...args: unknown[]) => any`
+            (isSpreadParameterNode(parent) ||
+                // `[name: E0, ...args: any)]` -> `[name: E0, ...args: unknown[]]`
+                isSpreadNamedTupleMemberNode(parent))) {
+            anyKeywordNode.replaceWithText('readonly unknown[]');
+            return;
+        }
+        anyKeywordNode.replaceWithText('unknown');
+        return;
+    }
+    for (const child of node.getChildren()) {
+        transformNode(child);
+    }
+};
+
+export { replaceAnyWithUnknownTransformer };
+//# sourceMappingURL=replace-any-with-unknown.mjs.map

package/dist/functions/ast-transformers/replace-any-with-unknown.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-any-with-unknown.mjs","sources":["../../../src/functions/ast-transformers/replace-any-with-unknown.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;MAQa,gCAAgC,GAAG,MAA0B;AAE1E,MAAM,IAAI,GAAuB,CAAC,SAAS,KAAI;IAC7C,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,WAAW,EAAE,EAAE;QAC1C,aAAa,CAAC,IAAI,CAAC;IACrB;AACF,CAAC;AAED,MAAM,aAAa,GAAG,CAAC,IAAc,KAAU;AAC7C,IAAA,IAAI,yBAAyB,CAAC,IAAI,CAAC,EAAE;AACnC,QAAA,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC;QAErD;IACF;IAEA,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QAC1C,MAAM,cAAc,GAAG,IAAI;AAE3B,QAAA,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,EAAE;QAEzC,IACE,MAAM,KAAK,SAAS;;aAEnB,qBAAqB,CAAC,MAAM,CAAC;;AAE5B,gBAAA,4BAA4B,CAAC,MAAM,CAAC,CAAC,EACvC;AACA,YAAA,cAAc,CAAC,eAAe,CAAC,oBAAoB,CAAC;YAEpD;QACF;AAEA,QAAA,cAAc,CAAC,eAAe,CAAC,SAAS,CAAC;QAEzC;IACF;IAEA,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE;QACtC,aAAa,CAAC,KAAK,CAAC;IACtB;AACF,CAAC;;;;"}

package/dist/functions/index.mjs

@@ -1,9 +1,11 @@
+export { appendAsConstTransformer } from './ast-transformers/append-as-const.mjs';
 export { convertInterfaceToTypeTransformer } from './ast-transformers/convert-interface-to-type.mjs';
 export { convertToReadonlyTypeTransformer } from './ast-transformers/convert-to-readonly-type.mjs';
 export { compareUnionIntersectionTypes } from './ast-transformers/readonly-transformer-helpers/compare-union-types.mjs';
 export { invalidDeepReadonlyTypeName } from './ast-transformers/readonly-transformer-helpers/constants.mjs';
 export { groupUnionIntersectionTypes } from './ast-transformers/readonly-transformer-helpers/group-union-types.mjs';
 export { nextReadonlyContext } from './ast-transformers/readonly-transformer-helpers/readonly-context.mjs';
+export { replaceAnyWithUnknownTransformer } from './ast-transformers/replace-any-with-unknown.mjs';
 export { replaceRecordWithUnknownRecordTransformer } from './ast-transformers/replace-record-with-unknown-record.mjs';
 export { transformSourceCode } from './ast-transformers/transform-source-code.mjs';
 export { IGNORE_FILE_COMMENT_TEXT, IGNORE_LINE_COMMENT_TEXT } from './constants/ignore-comment-text.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/index.mjs

@@ -1,9 +1,11 @@
+export { appendAsConstTransformer } from './functions/ast-transformers/append-as-const.mjs';
 export { convertInterfaceToTypeTransformer } from './functions/ast-transformers/convert-interface-to-type.mjs';
 export { convertToReadonlyTypeTransformer } from './functions/ast-transformers/convert-to-readonly-type.mjs';
 export { compareUnionIntersectionTypes } from './functions/ast-transformers/readonly-transformer-helpers/compare-union-types.mjs';
 export { invalidDeepReadonlyTypeName } from './functions/ast-transformers/readonly-transformer-helpers/constants.mjs';
 export { groupUnionIntersectionTypes } from './functions/ast-transformers/readonly-transformer-helpers/group-union-types.mjs';
 export { nextReadonlyContext } from './functions/ast-transformers/readonly-transformer-helpers/readonly-context.mjs';
+export { replaceAnyWithUnknownTransformer } from './functions/ast-transformers/replace-any-with-unknown.mjs';
 export { replaceRecordWithUnknownRecordTransformer } from './functions/ast-transformers/replace-record-with-unknown-record.mjs';
 export { transformSourceCode } from './functions/ast-transformers/transform-source-code.mjs';
 export { IGNORE_FILE_COMMENT_TEXT, IGNORE_LINE_COMMENT_TEXT } from './functions/constants/ignore-comment-text.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-codemod-lib",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "private": false,
   "keywords": [
     "typescript",
@@ -27,8 +27,10 @@
   "module": "./dist/entry-point.mjs",
   "types": "./dist/types.d.mts",
   "bin": {
+    "append-as-const": "./dist/cmd/append-as-const.mjs",
     "convert-interface-to-type": "./dist/cmd/convert-interface-to-type.mjs",
     "convert-to-readonly": "./dist/cmd/convert-to-readonly.mjs",
+    "replace-any-with-unknown": "./dist/cmd/replace-any-with-unknown.mjs",
     "replace-record-with-unknown-record": "./dist/cmd/replace-record-with-unknown-record.mjs"
   },
   "files": [
@@ -37,6 +39,48 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "tsx ./scripts/cmd/build.mts",
+    "build:min": "tsx ./scripts/cmd/build.mts --skip-check",
+    "check-all": "tsx ./scripts/cmd/check-all.mts",
+    "check:ext": "tsx ./scripts/cmd/check-ext.mts",
+    "clean": "pnpm run /clean:.*/",
+    "clean:logs": "npx rimraf ./*.log",
+    "cspell": "cspell \"**\" --gitignore --gitignore-root ./ --no-progress",
+    "doc": "tsx ./scripts/cmd/gen-docs.mts",
+    "doc:embed": "tsx ./scripts/cmd/embed-samples.mts",
+    "doc:preview": "vite preview --config ./configs/vite.doc.config.mts",
+    "doc:watch": "typedoc --options ./configs/typedoc.config.mjs --watch",
+    "fmt": "format-uncommitted",
+    "fmt:diff": "format-diff-from origin/main",
+    "fmt:full": "prettier --write .",
+    "gh:apply-all": "gh-apply-all",
+    "gh:apply-repository-settings": "gh-apply-repository-settings",
+    "gh:apply-rulesets": "gh-apply-rulesets",
+    "gh:apply-variables": "gh-apply-variables",
+    "gh:backup-all": "gh-backup-all",
+    "gh:backup-repository-settings": "gh-backup-repository-settings",
+    "gh:backup-rulesets": "gh-backup-rulesets",
+    "gi": "run-s gi:src fmt",
+    "gi:src": "gen-index-ts ./src --index-ext .mts --export-ext .mjs --target-ext .mts --target-ext .tsx --exclude entry-point.mts --exclude cmd",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "md": "markdownlint-cli2",
+    "run:cmd": "tsx ./src/cmd/convert-to-readonly.mts ./test/sample1.mts",
+    "run:test": "tsx ./scripts/test-code/transform-test-code.mts",
+    "test": "pnpm run z:vitest:node run",
+    "test:browser": "pnpm run z:vitest --project='Browser' run",
+    "test:cov": "pnpm run z:vitest:node run --coverage",
+    "test:cov:ui": "vite preview --outDir ./coverage",
+    "test:ui": "pnpm run z:vitest:node --ui",
+    "testw": "pnpm run z:vitest:node watch",
+    "tsc": "tsc --noEmit",
+    "tscw": "tsc --noEmit --watch -p ./tsconfig.json",
+    "type-check": "tsc --noEmit",
+    "update-packages": "pnpm update --latest",
+    "z:vitest": "vitest --config ./configs/vitest.config.mts",
+    "z:vitest:node": "pnpm run z:vitest --project='Node.js'"
+  },
   "dependencies": {
     "cmd-ts": "0.14.3",
     "dedent": "1.7.1",
@@ -54,81 +98,41 @@
     "@semantic-release/github": "12.0.2",
     "@semantic-release/npm": "13.1.3",
     "@semantic-release/release-notes-generator": "14.1.0",
-    "@types/node": "25.0.6",
-    "@vitest/browser-playwright": "4.0.16",
-    "@vitest/coverage-v8": "4.0.16",
-    "@vitest/ui": "4.0.16",
+    "@types/node": "25.0.9",
+    "@vitest/browser-playwright": "4.0.17",
+    "@vitest/coverage-v8": "4.0.17",
+    "@vitest/ui": "4.0.17",
     "conventional-changelog-conventionalcommits": "9.1.0",
-    "cspell": "9.4.0",
+    "cspell": "9.6.0",
     "eslint": "9.39.2",
-    "eslint-config-typed": "4.4.1",
-    "github-settings-as-code": "1.0.7",
+    "eslint-config-typed": "4.5.0",
+    "github-settings-as-code": "1.0.11",
     "jiti": "2.6.1",
     "markdownlint": "0.40.0",
     "markdownlint-cli2": "0.20.0",
     "npm-run-all2": "8.0.4",
     "playwright": "1.57.0",
-    "prettier": "3.7.4",
+    "prettier": "3.8.0",
     "prettier-plugin-organize-imports": "4.3.0",
-    "prettier-plugin-packagejson": "2.5.20",
-    "rollup": "4.54.0",
+    "prettier-plugin-packagejson": "2.5.21",
+    "rollup": "4.55.1",
     "semantic-release": "25.0.2",
     "ts-data-forge": "6.2.1",
     "ts-type-forge": "2.3.0",
     "tslib": "2.8.1",
     "tsx": "4.21.0",
-    "typedoc": "0.28.15",
+    "typedoc": "0.28.16",
     "typedoc-github-theme": "0.3.1",
     "typescript": "5.9.3",
-    "vite": "7.3.0",
-    "vitest": "4.0.16"
+    "vite": "7.3.1",
+    "vitest": "4.0.17"
   },
+  "packageManager": "pnpm@10.27.0",
   "engines": {
     "node": ">=22",
     "pnpm": ">=8.0.0"
   },
   "volta": {
     "node": "25.2.1"
-  },
-  "scripts": {
-    "build": "tsx ./scripts/cmd/build.mts",
-    "build:min": "tsx ./scripts/cmd/build.mts --skip-check",
-    "check-all": "tsx ./scripts/cmd/check-all.mts",
-    "check:ext": "tsx ./scripts/cmd/check-ext.mts",
-    "clean": "pnpm run /clean:.*/",
-    "clean:logs": "npx rimraf ./*.log",
-    "cspell": "cspell \"**\" --gitignore --gitignore-root ./ --no-progress",
-    "doc": "tsx ./scripts/cmd/gen-docs.mts",
-    "doc:embed": "tsx ./scripts/cmd/embed-samples.mts",
-    "doc:preview": "vite preview --config ./configs/vite.doc.config.mts",
-    "doc:watch": "typedoc --options ./configs/typedoc.config.mjs --watch",
-    "fmt": "format-uncommitted",
-    "fmt:diff": "format-diff-from origin/main",
-    "fmt:full": "prettier --write .",
-    "gh:apply-all": "gh-apply-all",
-    "gh:apply-repository-settings": "gh-apply-repository-settings",
-    "gh:apply-rulesets": "gh-apply-rulesets",
-    "gh:apply-variables": "gh-apply-variables",
-    "gh:backup-all": "gh-backup-all",
-    "gh:backup-repository-settings": "gh-backup-repository-settings",
-    "gh:backup-rulesets": "gh-backup-rulesets",
-    "gi": "run-s gi:src fmt",
-    "gi:src": "gen-index-ts ./src --index-ext .mts --export-ext .mjs --target-ext .mts --target-ext .tsx --exclude entry-point.mts --exclude cmd",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "md": "markdownlint-cli2",
-    "run:cmd": "tsx ./src/cmd/convert-to-readonly.mts ./test/convert-to-readonly.mts",
-    "test": "pnpm run z:vitest:node run",
-    "test:browser": "pnpm run z:vitest --project='Browser' run",
-    "test:cov": "pnpm run z:vitest:node run --coverage",
-    "test:cov:ui": "vite preview --outDir ./coverage",
-    "test:ui": "pnpm run z:vitest:node --ui",
-    "testw": "pnpm run z:vitest:node watch",
-    "tsc": "tsc --noEmit",
-    "tscw": "tsc --noEmit --watch -p ./tsconfig.json",
-    "type-check": "tsc --noEmit",
-    "update-packages": "pnpm update --latest",
-    "z:vitest": "vitest --config ./configs/vitest.config.mts",
-    "z:vitest:node": "vitest --config ./configs/vitest.config.mts --project='Node.js'"
   }
-}
+}

package/src/cmd/append-as-const.mts

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+/* eslint-disable no-await-in-loop */
+
+import * as cmd from 'cmd-ts';
+import dedent from 'dedent';
+import { castMutable, Result, unknownToString } from 'ts-data-forge';
+import 'ts-repo-utils';
+import {
+  appendAsConstTransformer,
+  transformSourceCode,
+} from '../functions/index.mjs';
+
+const cmdDef = cmd.command({
+  name: 'append-as-const-cli',
+  version: '1.0.0',
+  args: {
+    baseDir: cmd.positional({
+      type: cmd.string,
+      displayName: 'baseDir',
+      description: 'The base directory in which to perform the conversion',
+    }),
+    exclude: cmd.multioption({
+      long: 'exclude',
+      type: cmd.optional(cmd.array(cmd.string)),
+      description:
+        'Glob patterns of files to exclude from the base directory (e.g., "src/generated/**/*.mts")',
+    }),
+    silent: cmd.flag({
+      long: 'silent',
+      type: cmd.optional(cmd.boolean),
+      description: 'If true, suppresses output messages (default: false)',
+    }),
+  },
+  handler: (args) => {
+    appendAsConstCLI({
+      baseDir: args.baseDir,
+      exclude: args.exclude ?? [],
+      silent: args.silent ?? false,
+    }).catch((error: unknown) => {
+      console.error('An error occurred:', error);
+
+      process.exit(1);
+    });
+  },
+});
+
+type Args = Readonly<{
+  baseDir: string;
+  exclude: readonly string[];
+  silent: boolean;
+}>;
+
+const appendAsConstCLI = async (
+  args: Args,
+): Promise<Result<undefined, undefined>> => {
+  const echoIfNotSilent = args.silent ? () => {} : echo;
+
+  const errorIfNotSilent = args.silent ? () => {} : console.error;
+
+  // Find all files matching the glob
+  const globResult = await glob(args.baseDir, {
+    ignore: castMutable(args.exclude),
+  });
+
+  if (Result.isErr(globResult)) {
+    errorIfNotSilent('Error finding files matching pattern:', globResult.value);
+
+    return Result.err(undefined);
+  }
+
+  const files = globResult.value;
+
+  if (files.length === 0) {
+    echoIfNotSilent('No files found matching pattern:', args.baseDir);
+
+    return Result.ok(undefined);
+  }
+
+  const { errorFiles, transformedCount, unchangedCount } = await transformFiles(
+    files,
+    args.silent,
+  );
+
+  const hr = '='.repeat(50);
+
+  echoIfNotSilent(dedent`
+    ${hr}
+    Summary:
+      ✅ Transformed: ${transformedCount}
+      ⏭️ Unchanged:   ${unchangedCount}
+      ❌ Errors:      ${errorFiles.length}
+      📊 Total:       ${files.length}
+  `);
+
+  if (errorFiles.length > 0) {
+    echoIfNotSilent('\nFiles with errors:');
+
+    for (const fileName of errorFiles) {
+      echoIfNotSilent(`  - ${fileName}`);
+    }
+  }
+
+  echoIfNotSilent(hr);
+
+  if (errorFiles.length > 0) {
+    return Result.err(undefined);
+  }
+
+  return Result.ok(undefined);
+};
+
+const transformFiles = async (
+  filePaths: readonly string[],
+  silent: boolean,
+): Promise<
+  Readonly<{
+    transformedCount: number;
+    unchangedCount: number;
+    errorFiles: readonly string[];
+  }>
+> => {
+  let mut_transformedCount: number = 0;
+
+  let mut_unchangedCount: number = 0;
+
+  const mut_errorFiles: string[] = [];
+
+  for (const filePath of filePaths) {
+    const result = await transformOneFile(filePath, silent);
+
+    if (Result.isOk(result)) {
+      switch (result.value) {
+        case 'transformed':
+          mut_transformedCount += 1;
+
+          break;
+
+        case 'unchanged':
+          mut_unchangedCount += 1;
+
+          break;
+      }
+    } else {
+      mut_errorFiles.push(path.basename(filePath));
+    }
+  }
+
+  return {
+    transformedCount: mut_transformedCount,
+    unchangedCount: mut_unchangedCount,
+    errorFiles: mut_errorFiles,
+  };
+};
+
+const transformOneFile = async (
+  filePath: string,
+  silent: boolean,
+): Promise<Result<'unchanged' | 'transformed', string>> => {
+  const echoIfNotSilent = silent ? () => {} : echo;
+
+  const errorIfNotSilent = silent ? () => {} : console.error;
+
+  const fileName = path.basename(filePath);
+
+  const isTsx = fileName.endsWith('.tsx') || fileName.endsWith('.jsx');
+
+  try {
+    const originalCode = await fs.readFile(filePath, 'utf8');
+
+    // Transform the code with all transformers
+    const transformedCode = transformSourceCode(originalCode, isTsx, [
+      appendAsConstTransformer(),
+    ]);
+
+    // Check if the code was actually changed
+    if (transformedCode === originalCode) {
+      echoIfNotSilent(`⏭️ ${fileName} - no changes needed`);
+
+      return Result.ok('unchanged');
+    } else {
+      // Write back the transformed code
+      await fs.writeFile(filePath, transformedCode, 'utf8');
+
+      echoIfNotSilent(`✅ ${fileName} - transformed`);
+
+      return Result.ok('transformed');
+    }
+  } catch (error) {
+    const errStr = unknownToString(error);
+
+    errorIfNotSilent(`❌ ${fileName} - error: ${errStr}`);
+
+    return Result.err(errStr);
+  }
+};
+
+await cmd.run(cmdDef, process.argv.slice(2));

package/src/cmd/convert-interface-to-type.mts

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+/* eslint-disable no-await-in-loop */
+
+import * as cmd from 'cmd-ts';
+import dedent from 'dedent';
+import { castMutable, Result, unknownToString } from 'ts-data-forge';
+import 'ts-repo-utils';
+import {
+  convertInterfaceToTypeTransformer,
+  transformSourceCode,
+} from '../functions/index.mjs';
+
+const cmdDef = cmd.command({
+  name: 'convert-interface-to-type-cli',
+  version: '1.0.0',
+  args: {
+    baseDir: cmd.positional({
+      type: cmd.string,
+      displayName: 'baseDir',
+      description: 'The base directory in which to perform the conversion',
+    }),
+    exclude: cmd.multioption({
+      long: 'exclude',
+      type: cmd.optional(cmd.array(cmd.string)),
+      description:
+        'Glob patterns of files to exclude from the base directory (e.g., "src/generated/**/*.mts")',
+    }),
+    silent: cmd.flag({
+      long: 'silent',
+      type: cmd.optional(cmd.boolean),
+      description: 'If true, suppresses output messages (default: false)',
+    }),
+  },
+  handler: (args) => {
+    convertInterfaceToTypeCLI({
+      baseDir: args.baseDir,
+      exclude: args.exclude ?? [],
+      silent: args.silent ?? false,
+    }).catch((error: unknown) => {
+      console.error('An error occurred:', error);
+
+      process.exit(1);
+    });
+  },
+});
+
+type Args = Readonly<{
+  baseDir: string;
+  exclude: readonly string[];
+  silent: boolean;
+}>;
+
+const convertInterfaceToTypeCLI = async (
+  args: Args,
+): Promise<Result<undefined, undefined>> => {
+  const echoIfNotSilent = args.silent ? () => {} : echo;
+
+  const errorIfNotSilent = args.silent ? () => {} : console.error;
+
+  // Find all files matching the glob
+  const globResult = await glob(args.baseDir, {
+    ignore: castMutable(args.exclude),
+  });
+
+  if (Result.isErr(globResult)) {
+    errorIfNotSilent('Error finding files matching pattern:', globResult.value);
+
+    return Result.err(undefined);
+  }
+
+  const files = globResult.value;
+
+  if (files.length === 0) {
+    echoIfNotSilent('No files found matching pattern:', args.baseDir);
+
+    return Result.ok(undefined);
+  }
+
+  const { errorFiles, transformedCount, unchangedCount } = await transformFiles(
+    files,
+    args.silent,
+  );
+
+  const hr = '='.repeat(50);
+
+  echoIfNotSilent(dedent`
+    ${hr}
+    Summary:
+      ✅ Transformed: ${transformedCount}
+      ⏭️ Unchanged:   ${unchangedCount}
+      ❌ Errors:      ${errorFiles.length}
+      📊 Total:       ${files.length}
+  `);
+
+  if (errorFiles.length > 0) {
+    echoIfNotSilent('\nFiles with errors:');
+
+    for (const fileName of errorFiles) {
+      echoIfNotSilent(`  - ${fileName}`);
+    }
+  }
+
+  echoIfNotSilent(hr);
+
+  if (errorFiles.length > 0) {
+    return Result.err(undefined);
+  }
+
+  return Result.ok(undefined);
+};
+
+const transformFiles = async (
+  filePaths: readonly string[],
+  silent: boolean,
+): Promise<
+  Readonly<{
+    transformedCount: number;
+    unchangedCount: number;
+    errorFiles: readonly string[];
+  }>
+> => {
+  let mut_transformedCount: number = 0;
+
+  let mut_unchangedCount: number = 0;
+
+  const mut_errorFiles: string[] = [];
+
+  for (const filePath of filePaths) {
+    const result = await transformOneFile(filePath, silent);
+
+    if (Result.isOk(result)) {
+      switch (result.value) {
+        case 'transformed':
+          mut_transformedCount += 1;
+
+          break;
+
+        case 'unchanged':
+          mut_unchangedCount += 1;
+
+          break;
+      }
+    } else {
+      mut_errorFiles.push(path.basename(filePath));
+    }
+  }
+
+  return {
+    transformedCount: mut_transformedCount,
+    unchangedCount: mut_unchangedCount,
+    errorFiles: mut_errorFiles,
+  };
+};
+
+const transformOneFile = async (
+  filePath: string,
+  silent: boolean,
+): Promise<Result<'unchanged' | 'transformed', string>> => {
+  const echoIfNotSilent = silent ? () => {} : echo;
+
+  const errorIfNotSilent = silent ? () => {} : console.error;
+
+  const fileName = path.basename(filePath);
+
+  const isTsx = fileName.endsWith('.tsx') || fileName.endsWith('.jsx');
+
+  try {
+    const originalCode = await fs.readFile(filePath, 'utf8');
+
+    // Transform the code with all transformers
+    const transformedCode = transformSourceCode(originalCode, isTsx, [
+      convertInterfaceToTypeTransformer(),
+    ]);
+
+    // Check if the code was actually changed
+    if (transformedCode === originalCode) {
+      echoIfNotSilent(`⏭️ ${fileName} - no changes needed`);
+
+      return Result.ok('unchanged');
+    } else {
+      // Write back the transformed code
+      await fs.writeFile(filePath, transformedCode, 'utf8');
+
+      echoIfNotSilent(`✅ ${fileName} - transformed`);
+
+      return Result.ok('transformed');
+    }
+  } catch (error) {
+    const errStr = unknownToString(error);
+
+    errorIfNotSilent(`❌ ${fileName} - error: ${errStr}`);
+
+    return Result.err(errStr);
+  }
+};
+
+await cmd.run(cmdDef, process.argv.slice(2));