ts-codemod-lib 2.0.4 → 2.1.0

package/dist/functions/ast-transformers/transform-source-code.mjs

@@ -1,27 +1,55 @@
+import { Arr } from 'ts-data-forge';
 import * as tsm from 'ts-morph';
 
 const extractFileIgnoreTransformers = (code) => {
-    const match = /\/\*\s*transformer-ignore\s*(.*?)\s*\*\//u.exec(code);
-    if (match === null) {
-        return [];
-    }
-    const targetTransformers = match[1]?.trim() ?? '';
-    // Empty means ignore all transformers
-    if (targetTransformers === '') {
-        return [];
+    // Try to find any of the supported file-level ignore comment prefixes
+    const patterns = [
+        {
+            prefix: 'transformer-ignore',
+            regex: /\/\*\s*transformer-ignore\s*(.*?)\s*\*\//u,
+        },
+        {
+            prefix: 'ts-codemod-ignore',
+            regex: /\/\*\s*ts-codemod-ignore\s*(.*?)\s*\*\//u,
+        },
+        {
+            prefix: 'codemod-ignore',
+            regex: /\/\*\s*codemod-ignore\s*(.*?)\s*\*\//u,
+        },
+        {
+            prefix: 'transform-ignore',
+            regex: /\/\*\s*transform-ignore\s*(.*?)\s*\*\//u,
+        },
+    ];
+    for (const { regex } of patterns) {
+        const match = regex.exec(code);
+        if (match !== null) {
+            const targetTransformers = match[1]?.trim() ?? '';
+            // Empty means ignore all transformers
+            if (targetTransformers === '') {
+                return [];
+            }
+            // Parse comma-separated transformer names
+            return targetTransformers.split(',').map((name) => name.trim());
+        }
     }
-    // Parse comma-separated transformer names
-    return targetTransformers.split(',').map((name) => name.trim());
+    return [];
 };
 const shouldSkipFile = (code, transformerName) => {
     const ignoredTransformers = extractFileIgnoreTransformers(code);
     // If no file-level ignore comment found, don't skip
-    if (ignoredTransformers.length === 0 &&
-        !/\/\*\s*transformer-ignore\s*.*?\s*\*\//u.test(code)) {
+    const patterns = [
+        /\/\*\s*transformer-ignore\s*.*?\s*\*\//u,
+        /\/\*\s*ts-codemod-ignore\s*.*?\s*\*\//u,
+        /\/\*\s*codemod-ignore\s*.*?\s*\*\//u,
+        /\/\*\s*transform-ignore\s*.*?\s*\*\//u,
+    ];
+    const hasFileIgnoreComment = patterns.some((regex) => regex.test(code));
+    if (Arr.isArrayOfLength(ignoredTransformers, 0) && !hasFileIgnoreComment) {
         return false;
     }
     // Empty array means ignore all transformers (file-level ignore without specific transformers)
-    if (ignoredTransformers.length === 0) {
+    if (Arr.isArrayOfLength(ignoredTransformers, 0)) {
         return true;
     }
     // If transformer name is not specified, don't skip

package/dist/functions/ast-transformers/transform-source-code.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"transform-source-code.mjs","sources":["../../../src/functions/ast-transformers/transform-source-code.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA,MAAM,6BAA6B,GAAG,CAAC,IAAY,KAAuB;IACxE,MAAM,KAAK,GAAG,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC;AAEpE,IAAA,IAAI,KAAK,KAAK,IAAI,EAAE;AAClB,QAAA,OAAO,EAAE;IACX;IAEA,MAAM,kBAAkB,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;;AAGjD,IAAA,IAAI,kBAAkB,KAAK,EAAE,EAAE;AAC7B,QAAA,OAAO,EAAE;IACX;;AAGA,IAAA,OAAO,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,cAAc,GAAG,CACrB,IAAY,EACZ,eAAmC,KACxB;AACX,IAAA,MAAM,mBAAmB,GAAG,6BAA6B,CAAC,IAAI,CAAC;;AAG/D,IAAA,IACE,mBAAmB,CAAC,MAAM,KAAK,CAAC;AAChC,QAAA,CAAC,yCAAyC,CAAC,IAAI,CAAC,IAAI,CAAC,EACrD;AACA,QAAA,OAAO,KAAK;IACd;;AAGA,IAAA,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE;AACpC,QAAA,OAAO,IAAI;IACb;;AAGA,IAAA,IAAI,eAAe,KAAK,SAAS,EAAE;AACjC,QAAA,OAAO,KAAK;IACd;;AAGA,IAAA,OAAO,mBAAmB,CAAC,QAAQ,CAAC,eAAe,CAAC;AACtD,CAAC;AAEM,MAAM,mBAAmB,GAAG,CACjC,IAAY,EACZ,KAAc,EACd,YAA2C,EAC3C,KAAA,GAAiB,KAAK,KACZ;AACV,IAAA,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC;AAC9B,QAAA,qBAAqB,EAAE,IAAI;AAC3B,QAAA,eAAe,EAAE;AACf,YAAA,GAAG,EAAE,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,GAAG,SAAS;AAC7C,YAAA,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM;AAClC,YAAA,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM;AACjC,SAAA;AACF,KAAA,CAAC;IAEF,MAAM,SAAS,GAAG,OAAO,CAAC,gBAAgB,CACxC,CAAA,OAAA,EAAU,KAAK,GAAG,KAAK,GAAG,IAAI,EAAE,EAChC,IAAI,CACL;AAED,IAAA,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE;AACtC,QAAA,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI;AAExC,QAAA,IAAI,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE;YACzC,IAAI,KAAK,EAAE;AACT,gBAAA,OAAO,CAAC,KAAK,CACX,mDAAmD,eAAe,CAAA,CAAE,CACrE;YACH;YAEA;QACF;AAEA,QAAA,WAAW,CAAC,SAAS,CAAC,SAAS,CAAC;IAClC;AAEA,IAAA,OAAO,SAAS,CAAC,WAAW,EAAE;AAChC;;;;"}
+{"version":3,"file":"transform-source-code.mjs","sources":["../../../src/functions/ast-transformers/transform-source-code.mts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/functions/constants/ignore-comment-text.d.mts

@@ -1,3 +1,3 @@
-export declare const IGNORE_LINE_COMMENT_PREFIX = "transformer-ignore-next-line";
-export declare const IGNORE_FILE_COMMENT_PREFIX = "transformer-ignore";
+export declare const IGNORE_LINE_COMMENT_PREFIXES: readonly ["transformer-ignore-next-line", "ts-codemod-ignore-next-line", "codemod-ignore-next-line", "transform-ignore-next-line"];
+export declare const IGNORE_FILE_COMMENT_PREFIXES: readonly ["transformer-ignore", "ts-codemod-ignore", "codemod-ignore", "transform-ignore"];
 //# sourceMappingURL=ignore-comment-text.d.mts.map

package/dist/functions/constants/ignore-comment-text.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ignore-comment-text.d.mts","sourceRoot":"","sources":["../../../src/functions/constants/ignore-comment-text.mts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,iCAAiC,CAAC;AAEzE,eAAO,MAAM,0BAA0B,uBAAuB,CAAC"}
+{"version":3,"file":"ignore-comment-text.d.mts","sourceRoot":"","sources":["../../../src/functions/constants/ignore-comment-text.mts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,oIAK/B,CAAC;AAEX,eAAO,MAAM,4BAA4B,4FAK/B,CAAC"}

package/dist/functions/constants/ignore-comment-text.mjs

@@ -1,5 +1,15 @@
-const IGNORE_LINE_COMMENT_PREFIX = 'transformer-ignore-next-line';
-const IGNORE_FILE_COMMENT_PREFIX = 'transformer-ignore';
+const IGNORE_LINE_COMMENT_PREFIXES = [
+    'transformer-ignore-next-line',
+    'ts-codemod-ignore-next-line',
+    'codemod-ignore-next-line',
+    'transform-ignore-next-line',
+];
+const IGNORE_FILE_COMMENT_PREFIXES = [
+    'transformer-ignore',
+    'ts-codemod-ignore',
+    'codemod-ignore',
+    'transform-ignore',
+];
 
-export { IGNORE_FILE_COMMENT_PREFIX, IGNORE_LINE_COMMENT_PREFIX };
+export { IGNORE_FILE_COMMENT_PREFIXES, IGNORE_LINE_COMMENT_PREFIXES };
 //# sourceMappingURL=ignore-comment-text.mjs.map

package/dist/functions/constants/ignore-comment-text.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ignore-comment-text.mjs","sources":["../../../src/functions/constants/ignore-comment-text.mts"],"sourcesContent":[null],"names":[],"mappings":"AAAO,MAAM,0BAA0B,GAAG;AAEnC,MAAM,0BAA0B,GAAG;;;;"}
+{"version":3,"file":"ignore-comment-text.mjs","sources":["../../../src/functions/constants/ignore-comment-text.mts"],"sourcesContent":[null],"names":[],"mappings":"AAAO,MAAM,4BAA4B,GAAG;IAC1C,8BAA8B;IAC9B,6BAA6B;IAC7B,0BAA0B;IAC1B,4BAA4B;;AAGvB,MAAM,4BAA4B,GAAG;IAC1C,oBAAoB;IACpB,mBAAmB;IACnB,gBAAgB;IAChB,kBAAkB;;;;;"}

package/dist/functions/constants/index.mjs

@@ -1,2 +1,2 @@
-export { IGNORE_FILE_COMMENT_PREFIX, IGNORE_LINE_COMMENT_PREFIX } from './ignore-comment-text.mjs';
+export { IGNORE_FILE_COMMENT_PREFIXES, IGNORE_LINE_COMMENT_PREFIXES } from './ignore-comment-text.mjs';
 //# sourceMappingURL=index.mjs.map

package/dist/functions/functions/has-disable-next-line-comment.d.mts

@@ -1,7 +1,7 @@
 import * as tsm from 'ts-morph';
 /**
- * Checks if a given ts-morph Node is immediately preceded by a
- * '// transformer-ignore-next-line' comment, optionally filtered by transformer name(s).
+ * Checks if a given ts-morph Node is immediately preceded by an ignore-next-line comment,
+ * optionally filtered by transformer name(s).
  *
  * @param node - The ts-morph Node to check.
  * @param transformerName - Optional transformer name to check for specific ignore directive.
@@ -10,6 +10,7 @@ import * as tsm from 'ts-morph';
  *                          - `// transformer-ignore-next-line` (ignores all transformers)
  *                          - `// transformer-ignore-next-line append-as-const` (specific transformer)
  *                          - `// transformer-ignore-next-line append-as-const, replace-any-with-unknown` (multiple transformers)
+ *                          - Also accepts `ts-codemod-ignore-next-line`, `codemod-ignore-next-line`, `transform-ignore-next-line`
  * @returns True if the node is preceded by the ignore comment on the immediately previous line, false otherwise.
  */
 export declare const hasDisableNextLineComment: (node: tsm.Node, transformerName?: string) => boolean;

package/dist/functions/functions/has-disable-next-line-comment.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"has-disable-next-line-comment.d.mts","sourceRoot":"","sources":["../../../src/functions/functions/has-disable-next-line-comment.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAGhC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,GACpC,MAAM,GAAG,CAAC,IAAI,EACd,kBAAkB,MAAM,KACvB,OAmEF,CAAC"}
+{"version":3,"file":"has-disable-next-line-comment.d.mts","sourceRoot":"","sources":["../../../src/functions/functions/has-disable-next-line-comment.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAGhC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,yBAAyB,GACpC,MAAM,GAAG,CAAC,IAAI,EACd,kBAAkB,MAAM,KACvB,OAwEF,CAAC"}

package/dist/functions/functions/has-disable-next-line-comment.mjs

@@ -1,9 +1,9 @@
 import * as tsm from 'ts-morph';
-import { IGNORE_LINE_COMMENT_PREFIX } from '../constants/ignore-comment-text.mjs';
+import { IGNORE_LINE_COMMENT_PREFIXES } from '../constants/ignore-comment-text.mjs';
 
 /**
- * Checks if a given ts-morph Node is immediately preceded by a
- * '// transformer-ignore-next-line' comment, optionally filtered by transformer name(s).
+ * Checks if a given ts-morph Node is immediately preceded by an ignore-next-line comment,
+ * optionally filtered by transformer name(s).
  *
  * @param node - The ts-morph Node to check.
  * @param transformerName - Optional transformer name to check for specific ignore directive.
@@ -12,6 +12,7 @@ import { IGNORE_LINE_COMMENT_PREFIX } from '../constants/ignore-comment-text.mjs
  *                          - `// transformer-ignore-next-line` (ignores all transformers)
  *                          - `// transformer-ignore-next-line append-as-const` (specific transformer)
  *                          - `// transformer-ignore-next-line append-as-const, replace-any-with-unknown` (multiple transformers)
+ *                          - Also accepts `ts-codemod-ignore-next-line`, `codemod-ignore-next-line`, `transform-ignore-next-line`
  * @returns True if the node is preceded by the ignore comment on the immediately previous line, false otherwise.
  */
 const hasDisableNextLineComment = (node, transformerName) => {
@@ -34,11 +35,13 @@ const hasDisableNextLineComment = (node, transformerName) => {
             // Check if it's a single-line comment containing the specific ignore text
             if (commentRange.getKind() === tsm.SyntaxKind.SingleLineCommentTrivia) {
                 const commentText = commentRange.getText().trim();
-                if (commentText.includes(IGNORE_LINE_COMMENT_PREFIX)) {
+                // Check if the comment contains any of the supported ignore prefixes
+                const matchedPrefix = IGNORE_LINE_COMMENT_PREFIXES.find((prefix) => commentText.includes(prefix));
+                if (matchedPrefix !== undefined) {
                     // Extract the part after the prefix
                     const afterPrefix = commentText
-                        .slice(commentText.indexOf(IGNORE_LINE_COMMENT_PREFIX))
-                        .replace(IGNORE_LINE_COMMENT_PREFIX, '')
+                        .slice(commentText.indexOf(matchedPrefix))
+                        .replace(matchedPrefix, '')
                         .trim();
                     // If no transformer name specified, check if comment applies to all transformers
                     if (transformerName === undefined) {

package/dist/functions/functions/has-disable-next-line-comment.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"has-disable-next-line-comment.mjs","sources":["../../../src/functions/functions/has-disable-next-line-comment.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;AAYG;MACU,yBAAyB,GAAG,CACvC,IAAc,EACd,eAAwB,KACb;AACX,IAAA,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,EAAE;;AAG/C,IAAA,IAAI,aAAa,IAAI,CAAC,EAAE;AACtB,QAAA,OAAO,KAAK;IACd;IAEA,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;AAExC,IAAA,MAAM,oBAAoB,GAAG,IAAI,CAAC,uBAAuB,EAAE;;AAG3D,IAAA,KAAK,IAAI,KAAK,GAAG,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE;;AAErE,QAAA,MAAM,YAAY,GAAG,oBAAoB,CAAC,KAAK,CAAE;;AAGjD,QAAA,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,EAAE;QAE3C,MAAM,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC,IAAI;;AAG3E,QAAA,IAAI,aAAa,KAAK,cAAc,GAAG,CAAC,EAAE;;YAExC,IAAI,YAAY,CAAC,OAAO,EAAE,KAAK,GAAG,CAAC,UAAU,CAAC,uBAAuB,EAAE;gBACrE,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE;AAEjD,gBAAA,IAAI,WAAW,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE;;oBAEpD,MAAM,WAAW,GAAG;AACjB,yBAAA,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,0BAA0B,CAAC;AACrD,yBAAA,OAAO,CAAC,0BAA0B,EAAE,EAAE;AACtC,yBAAA,IAAI,EAAE;;AAGT,oBAAA,IAAI,eAAe,KAAK,SAAS,EAAE;AACjC,wBAAA,OAAO,IAAI;oBACb;;AAGA,oBAAA,IAAI,WAAW,KAAK,EAAE,EAAE;AACtB,wBAAA,OAAO,IAAI;oBACb;;oBAGA,MAAM,kBAAkB,GAAG;yBACxB,KAAK,CAAC,GAAG;yBACT,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;AAE7B,oBAAA,OAAO,kBAAkB,CAAC,QAAQ,CAAC,eAAe,CAAC;gBACrD;YACF;;;;AAKA,YAAA,OAAO,KAAK;QACd;;AAGA,QAAA,IAAI,cAAc,GAAG,aAAa,GAAG,CAAC,EAAE;YACtC;QACF;IACF;AAEA,IAAA,OAAO,KAAK;AACd;;;;"}
+{"version":3,"file":"has-disable-next-line-comment.mjs","sources":["../../../src/functions/functions/has-disable-next-line-comment.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;AAaG;MACU,yBAAyB,GAAG,CACvC,IAAc,EACd,eAAwB,KACb;AACX,IAAA,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,EAAE;;AAG/C,IAAA,IAAI,aAAa,IAAI,CAAC,EAAE;AACtB,QAAA,OAAO,KAAK;IACd;IAEA,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;AAExC,IAAA,MAAM,oBAAoB,GAAG,IAAI,CAAC,uBAAuB,EAAE;;AAG3D,IAAA,KAAK,IAAI,KAAK,GAAG,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE;;AAErE,QAAA,MAAM,YAAY,GAAG,oBAAoB,CAAC,KAAK,CAAE;;AAGjD,QAAA,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,EAAE;QAE3C,MAAM,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC,IAAI;;AAG3E,QAAA,IAAI,aAAa,KAAK,cAAc,GAAG,CAAC,EAAE;;YAExC,IAAI,YAAY,CAAC,OAAO,EAAE,KAAK,GAAG,CAAC,UAAU,CAAC,uBAAuB,EAAE;gBACrE,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE;;AAGjD,gBAAA,MAAM,aAAa,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAC,MAAM,KAC7D,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC7B;AAED,gBAAA,IAAI,aAAa,KAAK,SAAS,EAAE;;oBAE/B,MAAM,WAAW,GAAG;AACjB,yBAAA,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,aAAa,CAAC;AACxC,yBAAA,OAAO,CAAC,aAAa,EAAE,EAAE;AACzB,yBAAA,IAAI,EAAE;;AAGT,oBAAA,IAAI,eAAe,KAAK,SAAS,EAAE;AACjC,wBAAA,OAAO,IAAI;oBACb;;AAGA,oBAAA,IAAI,WAAW,KAAK,EAAE,EAAE;AACtB,wBAAA,OAAO,IAAI;oBACb;;oBAGA,MAAM,kBAAkB,GAAG;yBACxB,KAAK,CAAC,GAAG;yBACT,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;AAE7B,oBAAA,OAAO,kBAAkB,CAAC,QAAQ,CAAC,eAAe,CAAC;gBACrD;YACF;;;;AAKA,YAAA,OAAO,KAAK;QACd;;AAGA,QAAA,IAAI,cAAc,GAAG,aAAa,GAAG,CAAC,EAAE;YACtC;QACF;IACF;AAEA,IAAA,OAAO,KAAK;AACd;;;;"}

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

@@ -4,6 +4,7 @@ export * from './is-atomic-type-node.mjs';
 export * from './is-readonly-node.mjs';
 export * from './is-spread-parameter-node.mjs';
 export * from './remove-parentheses.mjs';
+export * from './should-avoid-parentheses-for-readonly.mjs';
 export * from './unwrap-readonly.mjs';
 export * from './wrap-with-parentheses.mjs';
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/functions/functions/index.mts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/functions/functions/index.mts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6CAA6C,CAAC;AAC5D,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC"}

package/dist/functions/functions/index.mjs

@@ -4,6 +4,7 @@ export { isAtomicTypeNode } from './is-atomic-type-node.mjs';
 export { isReadonlyArrayTypeNode, isReadonlyTupleOrArrayTypeNode, isReadonlyTupleTypeNode, isReadonlyTypeReferenceNode, isShallowReadonlyTypeNode } from './is-readonly-node.mjs';
 export { isSpreadNamedTupleMemberNode, isSpreadParameterNode } from './is-spread-parameter-node.mjs';
 export { removeParentheses } from './remove-parentheses.mjs';
+export { shouldAvoidParenthesesForReadonly } from './should-avoid-parentheses-for-readonly.mjs';
 export { unwrapReadonlyTypeArgText } from './unwrap-readonly.mjs';
 export { wrapWithParentheses } from './wrap-with-parentheses.mjs';
 //# sourceMappingURL=index.mjs.map

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

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

package/dist/functions/functions/is-as-const-node.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"is-as-const-node.d.mts","sourceRoot":"","sources":["../../../src/functions/functions/is-as-const-node.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,UAAU,CAAC;AAE/B,eAAO,MAAM,aAAa,GACxB,MAAM,EAAE,CAAC,IAAI,KACZ,IAAI,IAAI,EAAE,CAAC,YAAY,GACxB,QAAQ,CAAC;IACP,IAAI,EAAE,EAAE,CAAC,iBAAiB,GACxB,QAAQ,CAAC;QACP,QAAQ,EAAE,EAAE,CAAC,UAAU,GACrB,QAAQ,CAAC;YACP,IAAI,EAAE,OAAO,CAAC;SACf,CAAC,CAAC;QACL,aAAa,EAAE,SAAS,CAAC;KAC1B,CAAC,CAAC;CACN,CAgCF,CAAC"}
+{"version":3,"file":"is-as-const-node.d.mts","sourceRoot":"","sources":["../../../src/functions/functions/is-as-const-node.mts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,UAAU,CAAC;AAE/B,eAAO,MAAM,aAAa,GACxB,MAAM,EAAE,CAAC,IAAI,KACZ,IAAI,IAAI,EAAE,CAAC,YAAY,GACxB,QAAQ,CAAC;IACP,IAAI,EAAE,EAAE,CAAC,iBAAiB,GACxB,QAAQ,CAAC;QACP,QAAQ,EAAE,EAAE,CAAC,UAAU,GACrB,QAAQ,CAAC;YACP,IAAI,EAAE,OAAO,CAAC;SACf,CAAC,CAAC;QACL,aAAa,EAAE,SAAS,CAAC;KAC1B,CAAC,CAAC;CACN,CAgCF,CAAC"}

package/dist/functions/functions/is-as-const-node.mjs

@@ -1,3 +1,4 @@
+import { Arr } from 'ts-data-forge';
 import * as tsm from 'ts-morph';
 
 const isAsConstNode = (node) => {
@@ -23,7 +24,7 @@ const isAsConstNode = (node) => {
     // 6. Check if the Identifier's text is 'const'
     //    and that there are no type arguments (as const doesn't have them)
     return (typeNameNode.getText() === 'const' &&
-        typeNode.getTypeArguments().length === 0);
+        Arr.isArrayOfLength(typeNode.getTypeArguments(), 0));
 };
 
 export { isAsConstNode };

package/dist/functions/functions/is-as-const-node.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"is-as-const-node.mjs","sources":["../../../src/functions/functions/is-as-const-node.mts"],"sourcesContent":[null],"names":["ts"],"mappings":";;AAEO,MAAM,aAAa,GAAG,CAC3B,IAAa,KAWR;AACL,IAAA,IAAI,CAAC,IAAI,CAAC,MAAM,CAACA,GAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;AAC5C,QAAA,OAAO,KAAK;IACd;;AAGA,IAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE;AAEnC,IAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;QAC1B,OAAO,KAAK,CAAC;IACf;;AAGA,IAAA,IAAI,CAAC,QAAQ,CAAC,MAAM,CAACA,GAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE;AACjD,QAAA,OAAO,KAAK;IACd;;AAGA,IAAA,MAAM,YAAY,GAAG,QAAQ,CAAC,WAAW,EAAE;;AAG3C,IAAA,IAAI,CAAC,YAAY,CAAC,MAAM,CAACA,GAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;;AAElD,QAAA,OAAO,KAAK;IACd;;;AAIA,IAAA,QACE,YAAY,CAAC,OAAO,EAAE,KAAK,OAAO;QAClC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,MAAM,KAAK,CAAC;AAE5C;;;;"}
+{"version":3,"file":"is-as-const-node.mjs","sources":["../../../src/functions/functions/is-as-const-node.mts"],"sourcesContent":[null],"names":["ts"],"mappings":";;;AAGO,MAAM,aAAa,GAAG,CAC3B,IAAa,KAWR;AACL,IAAA,IAAI,CAAC,IAAI,CAAC,MAAM,CAACA,GAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;AAC5C,QAAA,OAAO,KAAK;IACd;;AAGA,IAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE;AAEnC,IAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;QAC1B,OAAO,KAAK,CAAC;IACf;;AAGA,IAAA,IAAI,CAAC,QAAQ,CAAC,MAAM,CAACA,GAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE;AACjD,QAAA,OAAO,KAAK;IACd;;AAGA,IAAA,MAAM,YAAY,GAAG,QAAQ,CAAC,WAAW,EAAE;;AAG3C,IAAA,IAAI,CAAC,YAAY,CAAC,MAAM,CAACA,GAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;;AAElD,QAAA,OAAO,KAAK;IACd;;;AAIA,IAAA,QACE,YAAY,CAAC,OAAO,EAAE,KAAK,OAAO;QAClC,GAAG,CAAC,eAAe,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;AAEvD;;;;"}

package/dist/functions/functions/should-avoid-parentheses-for-readonly.d.mts

@@ -0,0 +1,16 @@
+import * as tsm from 'ts-morph';
+/**
+ * Determines if parentheses should be avoided when adding 'readonly' prefix to a type.
+ *
+ * Parentheses should be AVOIDED in these specific contexts:
+ * - Type predicates: `x is [T, U]` -> `x is readonly [T, U]` (not `x is (readonly [T, U])`)
+ *   because parentheses around the type in a type predicate cause syntax errors
+ *
+ * For all other contexts, we keep parentheses for safety to avoid precedence issues,
+ * relying on prettier to remove unnecessary ones.
+ *
+ * @param node - The type node to check
+ * @returns true if parentheses should be avoided, false otherwise (keep parentheses)
+ */
+export declare const shouldAvoidParenthesesForReadonly: (node: tsm.Node) => boolean;
+//# sourceMappingURL=should-avoid-parentheses-for-readonly.d.mts.map

package/dist/functions/functions/should-avoid-parentheses-for-readonly.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"should-avoid-parentheses-for-readonly.d.mts","sourceRoot":"","sources":["../../../src/functions/functions/should-avoid-parentheses-for-readonly.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iCAAiC,GAAI,MAAM,GAAG,CAAC,IAAI,KAAG,OAgBlE,CAAC"}

package/dist/functions/functions/should-avoid-parentheses-for-readonly.mjs

@@ -0,0 +1,32 @@
+import * as tsm from 'ts-morph';
+
+/**
+ * Determines if parentheses should be avoided when adding 'readonly' prefix to a type.
+ *
+ * Parentheses should be AVOIDED in these specific contexts:
+ * - Type predicates: `x is [T, U]` -> `x is readonly [T, U]` (not `x is (readonly [T, U])`)
+ *   because parentheses around the type in a type predicate cause syntax errors
+ *
+ * For all other contexts, we keep parentheses for safety to avoid precedence issues,
+ * relying on prettier to remove unnecessary ones.
+ *
+ * @param node - The type node to check
+ * @returns true if parentheses should be avoided, false otherwise (keep parentheses)
+ */
+const shouldAvoidParenthesesForReadonly = (node) => {
+    const parent = node.getParent();
+    if (parent === undefined) {
+        return false;
+    }
+    // Check if parent is TypePredicate: x is T
+    // In this case, we MUST avoid parentheses: x is readonly T (not x is (readonly T))
+    // because `x is (readonly T)` is a syntax error
+    if (parent.isKind(tsm.SyntaxKind.TypePredicate)) {
+        return true;
+    }
+    // For all other cases, keep parentheses for safety
+    return false;
+};
+
+export { shouldAvoidParenthesesForReadonly };
+//# sourceMappingURL=should-avoid-parentheses-for-readonly.mjs.map

package/dist/functions/functions/should-avoid-parentheses-for-readonly.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"should-avoid-parentheses-for-readonly.mjs","sources":["../../../src/functions/functions/should-avoid-parentheses-for-readonly.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;;;;;;;;AAYG;AACI,MAAM,iCAAiC,GAAG,CAAC,IAAc,KAAa;AAC3E,IAAA,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE;AAE/B,IAAA,IAAI,MAAM,KAAK,SAAS,EAAE;AACxB,QAAA,OAAO,KAAK;IACd;;;;IAKA,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE;AAC/C,QAAA,OAAO,IAAI;IACb;;AAGA,IAAA,OAAO,KAAK;AACd;;;;"}

package/dist/functions/functions/wrap-with-parentheses.d.mts

@@ -1,2 +1,14 @@
-export declare const wrapWithParentheses: (nodeStr: string) => `(${string})`;
+/**
+ * Wraps a string with parentheses if not already wrapped.
+ * Avoids adding redundant parentheses when the expression is already
+ * fully wrapped with balanced parentheses.
+ *
+ * @example
+ * wrapWithParentheses('A') // '(A)'
+ * wrapWithParentheses('(A)') // '(A)' (not '((A))')
+ * wrapWithParentheses('A | B') // '(A | B)'
+ * wrapWithParentheses('(A | B)') // '(A | B)' (not '((A | B))')
+ * wrapWithParentheses('(A) | (B)') // '((A) | (B))' (needs outer parens)
+ */
+export declare const wrapWithParentheses: (nodeStr: string) => string;
 //# sourceMappingURL=wrap-with-parentheses.d.mts.map

package/dist/functions/functions/wrap-with-parentheses.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap-with-parentheses.d.mts","sourceRoot":"","sources":["../../../src/functions/functions/wrap-with-parentheses.mts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,KAAG,IAAI,MAAM,GAChC,CAAC"}
+{"version":3,"file":"wrap-with-parentheses.d.mts","sourceRoot":"","sources":["../../../src/functions/functions/wrap-with-parentheses.mts"],"names":[],"mappings":"AAsDA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,KAAG,MAQrD,CAAC"}

package/dist/functions/functions/wrap-with-parentheses.mjs

@@ -1,4 +1,61 @@
-const wrapWithParentheses = (nodeStr) => `(${nodeStr.trim()})`;
+import { range, asUint32 } from 'ts-data-forge';
+
+/**
+ * Checks if a string is already wrapped with a single pair of balanced parentheses
+ * that encompasses the entire expression.
+ *
+ * @example
+ * isWrappedWithParentheses('(A)') // true
+ * isWrappedWithParentheses('((A))') // true (outer pair wraps everything)
+ * isWrappedWithParentheses('(A) | (B)') // false (outer parens don't wrap everything)
+ * isWrappedWithParentheses('A') // false
+ */
+const isWrappedWithParentheses = (str) => {
+    const trimmed = str.trim();
+    if (!trimmed.startsWith('(') || !trimmed.endsWith(')')) {
+        return false;
+    }
+    // Check if the opening and closing parentheses are balanced
+    // and the opening parenthesis corresponds to the closing one
+    let mut_depth = 0;
+    for (const mut_i of range(0, asUint32(trimmed.length))) {
+        const char = trimmed.charAt(mut_i);
+        switch (char) {
+            case '(': {
+                mut_depth += 1;
+                break;
+            }
+            case ')': {
+                mut_depth -= 1;
+                // If we reach depth 0 before the end, the outer parentheses don't wrap everything
+                if (mut_depth === 0 && mut_i < trimmed.length - 1) {
+                    return false;
+                }
+                break;
+            }
+        }
+    }
+    return true;
+};
+/**
+ * Wraps a string with parentheses if not already wrapped.
+ * Avoids adding redundant parentheses when the expression is already
+ * fully wrapped with balanced parentheses.
+ *
+ * @example
+ * wrapWithParentheses('A') // '(A)'
+ * wrapWithParentheses('(A)') // '(A)' (not '((A))')
+ * wrapWithParentheses('A | B') // '(A | B)'
+ * wrapWithParentheses('(A | B)') // '(A | B)' (not '((A | B))')
+ * wrapWithParentheses('(A) | (B)') // '((A) | (B))' (needs outer parens)
+ */
+const wrapWithParentheses = (nodeStr) => {
+    const trimmed = nodeStr.trim();
+    if (isWrappedWithParentheses(trimmed)) {
+        return trimmed;
+    }
+    return `(${trimmed})`;
+};
 
 export { wrapWithParentheses };
 //# sourceMappingURL=wrap-with-parentheses.mjs.map

package/dist/functions/functions/wrap-with-parentheses.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"wrap-with-parentheses.mjs","sources":["../../../src/functions/functions/wrap-with-parentheses.mts"],"sourcesContent":[null],"names":[],"mappings":"AAAO,MAAM,mBAAmB,GAAG,CAAC,OAAe,KACjD,IAAI,OAAO,CAAC,IAAI,EAAE;;;;"}
+{"version":3,"file":"wrap-with-parentheses.mjs","sources":["../../../src/functions/functions/wrap-with-parentheses.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;AASG;AAGH,MAAM,wBAAwB,GAAG,CAAC,GAAW,KAAa;AACxD,IAAA,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE;AAE1B,IAAA,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;AACtD,QAAA,OAAO,KAAK;IACd;;;IAIA,IAAI,SAAS,GAAG,CAAC;AAEjB,IAAA,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE;QACtD,MAAM,IAAI,GAAW,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAE1C,QAAQ,IAAI;YACV,KAAK,GAAG,EAAE;gBACR,SAAS,IAAI,CAAC;gBAEd;YACF;YAEA,KAAK,GAAG,EAAE;gBACR,SAAS,IAAI,CAAC;;AAGd,gBAAA,IAAI,SAAS,KAAK,CAAC,IAAI,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;AACjD,oBAAA,OAAO,KAAK;gBACd;gBAEA;YACF;;IAOJ;AAEA,IAAA,OAAO,IAAI;AACb,CAAC;AAED;;;;;;;;;;;AAWG;AACI,MAAM,mBAAmB,GAAG,CAAC,OAAe,KAAY;AAC7D,IAAA,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE;AAE9B,IAAA,IAAI,wBAAwB,CAAC,OAAO,CAAC,EAAE;AACrC,QAAA,OAAO,OAAO;IAChB;IAEA,OAAO,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA,CAAY;AAChC;;;;"}

package/dist/functions/index.mjs

@@ -8,13 +8,14 @@ export { nextReadonlyContext } from './ast-transformers/readonly-transformer-hel
 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_PREFIX, IGNORE_LINE_COMMENT_PREFIX } from './constants/ignore-comment-text.mjs';
+export { IGNORE_FILE_COMMENT_PREFIXES, IGNORE_LINE_COMMENT_PREFIXES } from './constants/ignore-comment-text.mjs';
 export { hasDisableNextLineComment } from './functions/has-disable-next-line-comment.mjs';
 export { isAsConstNode } from './functions/is-as-const-node.mjs';
 export { isAtomicTypeNode } from './functions/is-atomic-type-node.mjs';
 export { isReadonlyArrayTypeNode, isReadonlyTupleOrArrayTypeNode, isReadonlyTupleTypeNode, isReadonlyTypeReferenceNode, isShallowReadonlyTypeNode } from './functions/is-readonly-node.mjs';
 export { isSpreadNamedTupleMemberNode, isSpreadParameterNode } from './functions/is-spread-parameter-node.mjs';
 export { removeParentheses } from './functions/remove-parentheses.mjs';
+export { shouldAvoidParenthesesForReadonly } from './functions/should-avoid-parentheses-for-readonly.mjs';
 export { unwrapReadonlyTypeArgText } from './functions/unwrap-readonly.mjs';
 export { wrapWithParentheses } from './functions/wrap-with-parentheses.mjs';
 export { replaceNodeWithDebugPrint } from './utils/replace-with-debug.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

@@ -8,13 +8,14 @@ export { nextReadonlyContext } from './functions/ast-transformers/readonly-trans
 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_PREFIX, IGNORE_LINE_COMMENT_PREFIX } from './functions/constants/ignore-comment-text.mjs';
+export { IGNORE_FILE_COMMENT_PREFIXES, IGNORE_LINE_COMMENT_PREFIXES } from './functions/constants/ignore-comment-text.mjs';
 export { hasDisableNextLineComment } from './functions/functions/has-disable-next-line-comment.mjs';
 export { isAsConstNode } from './functions/functions/is-as-const-node.mjs';
 export { isAtomicTypeNode } from './functions/functions/is-atomic-type-node.mjs';
 export { isReadonlyArrayTypeNode, isReadonlyTupleOrArrayTypeNode, isReadonlyTupleTypeNode, isReadonlyTypeReferenceNode, isShallowReadonlyTypeNode } from './functions/functions/is-readonly-node.mjs';
 export { isSpreadNamedTupleMemberNode, isSpreadParameterNode } from './functions/functions/is-spread-parameter-node.mjs';
 export { removeParentheses } from './functions/functions/remove-parentheses.mjs';
+export { shouldAvoidParenthesesForReadonly } from './functions/functions/should-avoid-parentheses-for-readonly.mjs';
 export { unwrapReadonlyTypeArgText } from './functions/functions/unwrap-readonly.mjs';
 export { wrapWithParentheses } from './functions/functions/wrap-with-parentheses.mjs';
 export { replaceNodeWithDebugPrint } from './functions/utils/replace-with-debug.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": "2.0.4",
+  "version": "2.1.0",
   "private": false,
   "keywords": [
     "typescript",
@@ -99,7 +99,7 @@
     "z:vitest:node": "pnpm run z:vitest --project='Node.js'"
   },
   "dependencies": {
-    "ts-data-forge": "6.4.0",
+    "ts-data-forge": "6.5.0",
     "ts-morph": "27.0.2"
   },
   "devDependencies": {
@@ -110,36 +110,36 @@
     "@semantic-release/commit-analyzer": "13.0.1",
     "@semantic-release/exec": "7.1.0",
     "@semantic-release/git": "10.0.1",
-    "@semantic-release/github": "12.0.3",
-    "@semantic-release/npm": "13.1.3",
+    "@semantic-release/github": "12.0.6",
+    "@semantic-release/npm": "13.1.4",
     "@semantic-release/release-notes-generator": "14.1.0",
-    "@types/node": "25.2.0",
+    "@types/node": "25.3.2",
     "@vitest/browser-playwright": "4.0.18",
     "@vitest/coverage-v8": "4.0.18",
     "@vitest/ui": "4.0.18",
-    "cmd-ts": "0.14.3",
+    "cmd-ts": "0.15.0",
     "conventional-changelog-conventionalcommits": "9.1.0",
-    "cspell": "9.6.3",
+    "cspell": "9.6.4",
     "dedent": "1.7.1",
     "eslint": "9.39.2",
-    "eslint-config-typed": "4.6.1",
-    "github-settings-as-code": "1.1.2",
+    "eslint-config-typed": "4.6.4",
+    "github-settings-as-code": "1.1.9",
     "jiti": "2.6.1",
     "markdownlint": "0.40.0",
-    "markdownlint-cli2": "0.20.0",
+    "markdownlint-cli2": "0.21.0",
     "npm-run-all2": "8.0.4",
-    "playwright": "1.58.1",
+    "playwright": "1.58.2",
     "prettier": "3.8.1",
     "prettier-plugin-organize-imports": "4.3.0",
     "prettier-plugin-packagejson": "3.0.0",
-    "rollup": "4.57.1",
+    "rollup": "4.59.0",
     "semantic-release": "25.0.3",
-    "ts-repo-utils": "8.1.0",
+    "ts-repo-utils": "8.2.0",
     "ts-type-forge": "2.3.1",
     "tslib": "2.8.1",
     "tsx": "4.21.0",
-    "typedoc": "0.28.16",
-    "typedoc-github-theme": "0.3.1",
+    "typedoc": "0.28.17",
+    "typedoc-github-theme": "0.4.0",
     "typescript": "5.9.3",
     "vite": "7.3.1",
     "vitest": "4.0.18"
@@ -160,7 +160,7 @@
       "optional": true
     }
   },
-  "packageManager": "pnpm@10.29.2",
+  "packageManager": "pnpm@10.29.3",
   "engines": {
     "node": ">=20.11.0",
     "pnpm": ">=8.0.0"

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

@@ -9,7 +9,7 @@ const transformer = appendAsConstTransformer();
 
 const cmdDef = cmd.command({
   name: transformer.name,
-  version: '2.0.4',
+  version: '2.1.0',
   args: {
     baseDir: cmd.positional({
       type: cmd.string,

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

@@ -9,7 +9,7 @@ const transformer = convertInterfaceToTypeTransformer();
 
 const cmdDef = cmd.command({
   name: transformer.name,
-  version: '2.0.4',
+  version: '2.1.0',
   args: {
     baseDir: cmd.positional({
       type: cmd.string,

package/src/cmd/convert-to-readonly.mts

@@ -9,7 +9,7 @@ const transformer = convertToReadonlyTransformer();
 
 const cmdDef = cmd.command({
   name: transformer.name,
-  version: '2.0.4',
+  version: '2.1.0',
   args: {
     baseDir: cmd.positional({
       type: cmd.string,

package/src/cmd/replace-any-with-unknown.mts

@@ -9,7 +9,7 @@ const transformer = replaceAnyWithUnknownTransformer();
 
 const cmdDef = cmd.command({
   name: transformer.name,
-  version: '2.0.4',
+  version: '2.1.0',
   args: {
     baseDir: cmd.positional({
       type: cmd.string,

package/src/cmd/replace-record-with-unknown-record.mts

@@ -9,7 +9,7 @@ const transformer = replaceRecordWithUnknownRecordTransformer();
 
 const cmdDef = cmd.command({
   name: transformer.name,
-  version: '2.0.4',
+  version: '2.1.0',
   args: {
     baseDir: cmd.positional({
       type: cmd.string,

package/src/cmd/run-transformer-cli.mts

@@ -44,7 +44,7 @@ export const runTransformerCLI = async (
 
   const files = filesResult.value;
 
-  if (files.length === 0) {
+  if (Arr.isArrayOfLength(files, 0)) {
     echoIfNotSilent(
       options.uncommitted
         ? 'No uncommitted files found'
@@ -71,7 +71,7 @@ export const runTransformerCLI = async (
       📊 Total:       ${files.length}
   `);
 
-  if (errorFiles.length > 0) {
+  if (Arr.isNonEmpty(errorFiles)) {
     echoIfNotSilent('\nFiles with errors:');
 
     for (const fileName of errorFiles) {
@@ -81,7 +81,7 @@ export const runTransformerCLI = async (
 
   echoIfNotSilent(hr);
 
-  if (errorFiles.length > 0) {
+  if (Arr.isNonEmpty(errorFiles)) {
     return Result.err(undefined);
   }