feat: TypeScript 5.5 (#1545)

BREAKING CHANGE: Upgraded to TypeScript 5.5

docs/index.md

@@ -17,7 +17,7 @@ npm install --save-dev ts-morph
 Or if you're using Deno:
 
 ```
-deno add @ts-morph/ts-morph
+deno add ts-morph@jsr:@ts-morph/ts-morph
 ```
 
 ## Documentation Progress

dprint.json

@@ -15,8 +15,8 @@
  "dist-deno"
  ],
  "plugins": [
- "https://plugins.dprint.dev/typescript-0.88.6.wasm",
- "https://plugins.dprint.dev/json-0.19.1.wasm",
- "https://plugins.dprint.dev/markdown-0.16.3.wasm"
+ "https://plugins.dprint.dev/typescript-0.91.1.wasm",
+ "https://plugins.dprint.dev/json-0.19.3.wasm",
+ "https://plugins.dprint.dev/markdown-0.17.1.wasm"
  ]
 }

package.json

@@ -26,7 +26,6 @@
  "packages/ts-morph"
  ],
  "devDependencies": {
- "dprint": "^0.43.2",
- "every-ts": "^2.0.0"
+ "dprint": "^0.46.3"
  }
 }

packages/bootstrap/package.json

@@ -28,17 +28,17 @@
  },
  "devDependencies": {
  "@rollup/plugin-typescript": "^11.1.6",
- "@types/chai": "^4.3.12",
- "@types/mocha": "^10.0.6",
- "@types/node": "^20.11.25",
+ "@types/chai": "^4.3.16",
+ "@types/mocha": "^10.0.7",
+ "@types/node": "^20.14.8",
  "chai": "^4.3.10",
  "cross-env": "^7.0.3",
- "mocha": "^10.3.0",
- "rimraf": "^5.0.5",
- "rollup": "=4.12.1",
+ "mocha": "^10.4.0",
+ "rimraf": "^5.0.7",
+ "rollup": "=4.18.0",
  "ts-node": "^10.9.2",
- "tslib": "^2.6.2",
- "typescript": "~5.4.2"
+ "tslib": "^2.6.3",
+ "typescript": "~5.5.2"
  },
  "publishConfig": {
  "access": "public"

packages/common/package.json

@@ -20,23 +20,23 @@
  },
  "dependencies": {
  "fast-glob": "^3.3.2",
- "minimatch": "^9.0.3",
+ "minimatch": "^9.0.4",
  "mkdirp": "^3.0.1",
  "path-browserify": "^1.0.1"
  },
  "devDependencies": {
  "@rollup/plugin-typescript": "^11.1.6",
- "@types/chai": "^4.3.12",
- "@types/mocha": "^10.0.6",
- "@types/node": "^20.11.25",
+ "@types/chai": "^4.3.16",
+ "@types/mocha": "^10.0.7",
+ "@types/node": "^20.14.8",
  "chai": "^4.3.10",
  "cross-env": "^7.0.3",
- "mocha": "^10.3.0",
- "rimraf": "^5.0.5",
- "rollup": "=4.12.1",
+ "mocha": "^10.4.0",
+ "rimraf": "^5.0.7",
+ "rollup": "=4.18.0",
  "ts-node": "^10.9.2",
- "tslib": "^2.6.2",
- "typescript": "5.4.2"
+ "tslib": "^2.6.3",
+ "typescript": "5.5.2"
  },
  "publishConfig": {
  "access": "public"

packages/common/scripts/bundleLocalTs.ts

@@ -38,8 +38,4 @@ nodeWithTypeArgs.insertProperty(0, {
  name: "_nodeWithTypeArgumentsBrand",
  type: "any",
 });
-for (const qualifiedName of tsFile.getDescendantsOfKind(tsMorph.ts.SyntaxKind.QualifiedName)) {
- if (qualifiedName.getLeft().getText() === "ts")
- qualifiedName.replaceWithText(qualifiedName.getText().replace(/^ts\./, ""));
-}
 tsFile.saveSync();

packages/scripts/utils/Memoize.ts

@@ -1,10 +1,9 @@
 /** Decorator for memoizing the result of a method. */
 export function Memoize(target: (...args: any[]) => void) {
- if (target instanceof Function) {
+ if (target instanceof Function)
  return getNewFunction(target);
- } else {
+ else
  throw new Error("Not implemented.");
- }
 }
 
 const weakMap = new WeakMap<object, Map<string, unknown>>();

packages/ts-morph/breaking-changes.md

@@ -1,4 +1,4 @@
-# Breaking Changes
+# Breaking Changes
 
 View [CHANGELOG.md](CHANGELOG.md) for more detail on releases. This file is only a high level overview of breaking changes.
 

packages/ts-morph/lib/ts-morph.d.ts

@@ -9525,6 +9525,8 @@ export declare class EmitOutput {
  private constructor();
  /** TypeScript compiler emit result. */
  get compilerObject(): ts.EmitOutput;
+ /** Gets the diagnostics. */
+ getDiagnostics(): Diagnostic<ts.Diagnostic>[];
  /** Gets if the emit was skipped. */
  getEmitSkipped(): boolean;
  /** Gets the output files. */
@@ -10071,7 +10073,7 @@ export declare class Type<TType extends ts.Type = ts.Type> {
  * Gets the object flags.
  * @remarks Returns 0 for a non-object type.
  */
- getObjectFlags(): 0 | ObjectFlags.Class | ObjectFlags.Interface | ObjectFlags.Reference | ObjectFlags.Tuple | ObjectFlags.Anonymous | ObjectFlags.Mapped | ObjectFlags.Instantiated | ObjectFlags.ObjectLiteral | ObjectFlags.EvolvingArray | ObjectFlags.ObjectLiteralPatternWithComputedProperties | ObjectFlags.ReverseMapped | ObjectFlags.JsxAttributes | ObjectFlags.JSLiteral | ObjectFlags.FreshLiteral | ObjectFlags.ArrayLiteral | ObjectFlags.ClassOrInterface | ObjectFlags.ContainsSpread | ObjectFlags.ObjectRestType | ObjectFlags.InstantiationExpressionType;
+ getObjectFlags(): 0 | ObjectFlags.Class | ObjectFlags.Interface | ObjectFlags.Reference | ObjectFlags.Tuple | ObjectFlags.Anonymous | ObjectFlags.Mapped | ObjectFlags.Instantiated | ObjectFlags.ObjectLiteral | ObjectFlags.EvolvingArray | ObjectFlags.ObjectLiteralPatternWithComputedProperties | ObjectFlags.ReverseMapped | ObjectFlags.JsxAttributes | ObjectFlags.JSLiteral | ObjectFlags.FreshLiteral | ObjectFlags.ArrayLiteral | ObjectFlags.ClassOrInterface | ObjectFlags.ContainsSpread | ObjectFlags.ObjectRestType | ObjectFlags.InstantiationExpressionType | ObjectFlags.SingleSignatureType;
 }
 
 export declare class TypeParameter extends Type<ts.TypeParameter> {

packages/ts-morph/package.json

@@ -49,19 +49,19 @@
  },
  "devDependencies": {
  "@rollup/plugin-typescript": "^11.1.6",
- "@types/chai": "^4.3.12",
- "@types/diff": "^5.0.9",
- "@types/mocha": "^10.0.6",
- "@types/node": "^20.11.25",
+ "@types/chai": "^4.3.16",
+ "@types/diff": "^5.2.1",
+ "@types/mocha": "^10.0.7",
+ "@types/node": "^20.14.8",
  "chai": "^4.3.10",
  "conditional-type-checks": "^1.0.6",
  "cross-env": "^7.0.3",
  "diff": "^5.2.0",
- "mocha": "10.3.0",
- "rimraf": "^5.0.5",
- "rollup": "=4.12.1",
+ "mocha": "10.4.0",
+ "rimraf": "^5.0.7",
+ "rollup": "=4.18.0",
  "ts-node": "10.9.2",
- "typescript": "~5.3.2"
+ "typescript": "~5.5.2"
  },
  "standard-version": {
  "tagPrefix": "",

packages/ts-morph/readme.md

@@ -1,4 +1,4 @@
-# ts-morph
+# ts-morph
 
 [![npm version](https://badge.fury.io/js/ts-morph.svg)](https://badge.fury.io/js/ts-morph)
 [![CI](https:/dsherret/ts-morph/workflows/CI/badge.svg)](https:/dsherret/ts-morph/actions?query=workflow%3ACI)

packages/ts-morph/scripts/buildDeno.ts

@@ -44,7 +44,7 @@ fileSystem.writeFileSync(
 fileSystem.writeFileSync(
  `${destPath}/readme.md`,
  `
-# ts_morph
+# ts-morph
 
 To use:
 
@@ -59,7 +59,7 @@ import { Project } from "ts-morph";
 Or use \`@ts-morph/bootstrap\`:
 
 \`\`\`
-deno add @ts-morph/ts-morph
+deno add @ts-morph/bootstrap
 \`\`\`
 
 \`\`\`ts

packages/ts-morph/scripts/readme.md

@@ -1,3 +1,3 @@
-# Scripts
+# Scripts
 
 This folder contains the code that verifies, manipulates, and generates code for ts-morph.

packages/ts-morph/src/compiler/ast/common/Node.ts

@@ -26,7 +26,7 @@ import { Expression } from "../expression";
 import { KindToNodeMappings } from "../kindToNodeMappings.generated";
 import { SourceFile } from "../module";
 import { Statement, StatementedNode } from "../statement";
-import { ExtendedParser, hasParsedTokens } from "../utils";
+import { ExtendedParser } from "../utils";
 import { SyntaxList } from "./SyntaxList";
 import { TextRange } from "./TextRange";
 import { ForEachDescendantTraversalControl, TransformTraversalControl } from "./TraversalControl";
@@ -133,10 +133,6 @@ export class Node<NodeType extends ts.Node = ts.Node> {
  if (parent != null)
  parent._wrappedChildCount--;
 
- const parentSyntaxList = this._getParentSyntaxListIfWrapped();
- if (parentSyntaxList != null)
- parentSyntaxList._wrappedChildCount--;
-
  this.#storeTextForForgetting();
  this._context.compilerFactory.removeNodeFromCache(this);
  this._clearInternals();
@@ -156,7 +152,9 @@ export class Node<NodeType extends ts.Node = ts.Node> {
  * @internal
  */
  _hasWrappedChildren() {
- return this._wrappedChildCount > 0;
+ // always consider syntax lists as having warpped children because tracking
+ // them is more work than it's worth
+ return this._wrappedChildCount > 0 || this.#compilerNode?.kind === SyntaxKind.SyntaxList;
  }
 
  /**
@@ -1290,7 +1288,7 @@ export class Node<NodeType extends ts.Node = ts.Node> {
  */
  _getParentSyntaxListIfWrapped(): SyntaxList | undefined {
  const parent = this.getParent();
- if (parent == null || !hasParsedTokens(parent.compilerNode))
+ if (parent == null || !ExtendedParser.hasParsedTokens(parent.compilerNode))
  return undefined;
  return this.getParentSyntaxList();
  }
@@ -1926,15 +1924,15 @@ export class Node<NodeType extends ts.Node = ts.Node> {
  * Gets the compiler children of the node.
  * @internal
  */
- _getCompilerChildren(): ts.Node[] {
+ _getCompilerChildren(): readonly ts.Node[] {
  return ExtendedParser.getCompilerChildren(this.compilerNode, this._sourceFile.compilerNode);
  }
 
  /**
  * Gets the compiler children of the node using .forEachChild
  * @internal
  */
- _getCompilerForEachChildren(): ts.Node[] {
+ _getCompilerForEachChildren(): readonly ts.Node[] {
  return ExtendedParser.getCompilerForEachChildren(this.compilerNode, this._sourceFile.compilerNode);
  }
 
@@ -1943,15 +1941,15 @@ export class Node<NodeType extends ts.Node = ts.Node> {
  * @internal
  */
  _getCompilerChildrenFast() {
- return hasParsedTokens(this.compilerNode) ? this._getCompilerChildren() : this._getCompilerForEachChildren();
+ return ExtendedParser.hasParsedTokens(this.compilerNode) ? this._getCompilerChildren() : this._getCompilerForEachChildren();
  }
 
  /**
  * Gets the compiler children of the specified kind.
  * @internal
  */
  _getCompilerChildrenOfKind(kind: SyntaxKind) {
- const children: ts.Node[] = useParseTreeSearchForKind(this, kind) ? this._getCompilerForEachChildren() : this._getCompilerChildren();
+ const children: readonly ts.Node[] = useParseTreeSearchForKind(this, kind) ? this._getCompilerForEachChildren() : this._getCompilerChildren();
  return children.filter(c => c.kind === kind);
  }
 

packages/ts-morph/src/compiler/ast/utils/ExtendedParser.ts

@@ -1,9 +1,8 @@
 import { SyntaxKind, ts } from "@ts-morph/common";
 import { CommentNodeParser, ContainerNodes } from "./CommentNodeParser";
-import { hasParsedTokens } from "./hasParsedTokens";
 
 const forEachChildSaver = new WeakMap<ts.Node, ts.Node[]>();
-const getChildrenSaver = new WeakMap<ts.Node, ts.Node[]>();
+const getChildrenSaver = new WeakMap<ts.Node, readonly ts.Node[]>();
 
 /**
  * Parser that parses around nodes for comments.
@@ -14,8 +13,13 @@ export class ExtendedParser {
  return CommentNodeParser.getOrParseChildren(container, sourceFile);
  }
 
+ static hasParsedTokens(node: ts.Node) {
+ // if this is true, it means the compiler has previously parsed the tokens
+ return getChildrenSaver.has(node) || node.kind == SyntaxKind.SyntaxList;
+ }
+
  static getCompilerChildrenFast(node: ts.Node, sourceFile: ts.SourceFile) {
- if (hasParsedTokens(node))
+ if (ExtendedParser.hasParsedTokens(node))
  return ExtendedParser.getCompilerChildren(node, sourceFile);
 
  return ExtendedParser.getCompilerForEachChildren(node, sourceFile);
@@ -43,20 +47,21 @@ export class ExtendedParser {
  }
  }
 
- static getCompilerChildren(node: ts.Node, sourceFile: ts.SourceFile) {
- if (isStatementMemberOrPropertyHoldingSyntaxList()) {
-  let result = getChildrenSaver.get(node);
- if (result == null) {
+ static getCompilerChildren(node: ts.Node, sourceFile: ts.SourceFile): readonly ts.Node[] {
+ let result = getChildrenSaver.get(node);
+ if (result == null) {
+ if (isStatementMemberOrPropertyHoldingSyntaxList()) {
  // @code-fence-allow(getChildren): This merges in comment nodes.
- result = [...node.getChildren(sourceFile)]; // make a copy; do not modify the compiler api's array
- mergeInComments(result, CommentNodeParser.getOrParseChildren(node as ts.SyntaxList, sourceFile));
- getChildrenSaver.set(node, result);
+ const newArray = [...node.getChildren(sourceFile)]; // make a copy; do not modify the compiler api's array
+ mergeInComments(newArray, CommentNodeParser.getOrParseChildren(node as ts.SyntaxList, sourceFile));
+ result = newArray;
+ } else {
+ // @code-fence-allow(getChildren): No need to merge in comment nodes.
+ result = node.getChildren(sourceFile);
  }
- return result;
+ getChildrenSaver.set(node, result);
  }
-
- // @code-fence-allow(getChildren): No need to merge in comment nodes.
- return node.getChildren(sourceFile);
+ return result;
 
  function isStatementMemberOrPropertyHoldingSyntaxList() {
  if (node.kind !== ts.SyntaxKind.SyntaxList)

packages/ts-morph/src/compiler/ast/utils/index.ts

@@ -1,4 +1,3 @@
 export * from "./CommentNodeParser";
 export * from "./ExtendedParser";
-export * from "./hasParsedTokens";
 export * from "./isComment";

packages/ts-morph/src/compiler/tools/LanguageService.ts

@@ -273,7 +273,7 @@ export class LanguageService {
  function getCompilerEmitOutput(): ts.EmitOutput {
  const program = compilerObject.getProgram();
  if (program == null || program.getSourceFile(filePath) == null)
- return { emitSkipped: true, outputFiles: [] };
+ return { emitSkipped: true, outputFiles: [], diagnostics: [] };
  return compilerObject.getEmitOutput(filePath, emitOnlyDtsFiles);
  }
  }

packages/ts-morph/src/compiler/tools/results/EmitOutput.ts

@@ -26,6 +26,12 @@ export class EmitOutput {
  return this.#compilerObject;
  }
 
+ /** Gets the diagnostics. */
+ @Memoize
+ getDiagnostics() {
+ return this.compilerObject.diagnostics.map(d => this.#context.compilerFactory.getDiagnostic(d));
+ }
+
  /**
  * Gets if the emit was skipped.
  */

packages/ts-morph/src/manipulation/nodeHandlers/ChangeChildOrderParentHandler.ts

@@ -40,7 +40,7 @@ export class ChangeChildOrderParentHandler implements NodeHandler {
  this.#compilerFactory.replaceCompilerNode(currentNode, newNode);
  }
 
- #getChildrenInNewOrder(children: ts.Node[]) {
+ #getChildrenInNewOrder(children: readonly ts.Node[]) {
  const result = [...children];
  const movingNode = result.splice(this.#oldIndex, 1)[0];
  result.splice(this.#newIndex, 0, movingNode);

packages/ts-morph/src/manipulation/nodeHandlers/NodeHandlerHelper.ts

@@ -1,6 +1,6 @@
 import { ArrayUtils, SyntaxKind, ts } from "@ts-morph/common";
 import { Node, SourceFile } from "../../compiler";
-import { ExtendedParser, hasParsedTokens } from "../../compiler/ast/utils";
+import { ExtendedParser } from "../../compiler/ast/utils";
 import { CompilerFactory } from "../../factories";
 import { AdvancedIterator } from "../../utils";
 import { NodeHandler } from "./NodeHandler";
@@ -36,7 +36,7 @@ export class NodeHandlerHelper {
  ];
  }
 
- getCompilerChildren(currentNode: Node, newNode: ts.Node, newSourceFile: ts.SourceFile): [ts.Node[], ts.Node[]] {
+ getCompilerChildren(currentNode: Node, newNode: ts.Node, newSourceFile: ts.SourceFile): [readonly ts.Node[], readonly ts.Node[]] {
  const currentCompilerNode = currentNode.compilerNode;
  const currentSourceFile = currentNode._sourceFile.compilerNode;
 
@@ -49,10 +49,10 @@ export class NodeHandlerHelper {
  /**
  * Gets the children of the node according to whether the tokens have previously been parsed.
  */
- getChildrenFast(currentNode: Node, newNode: ts.Node, newSourceFile: ts.SourceFile): [ts.Node[], ts.Node[]] {
+ getChildrenFast(currentNode: Node, newNode: ts.Node, newSourceFile: ts.SourceFile): [readonly ts.Node[], readonly ts.Node[]] {
  const currentCompilerNode = currentNode.compilerNode;
  const currentSourceFile = currentNode._sourceFile.compilerNode;
- if (hasParsedTokens(currentCompilerNode)) {
+ if (ExtendedParser.hasParsedTokens(currentCompilerNode)) {
  return [
  ExtendedParser.getCompilerChildren(currentCompilerNode, currentSourceFile),
  ExtendedParser.getCompilerChildren(newNode, newSourceFile),