ts-morph
TypeScript compiler wrapper for static analysis and code manipulation.
Last updated 22 days ago by dsherret .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install ts-morph 
SYNC missed versions from official npm registry.

ts-morph

npm version Build Status Coverage Status stable

TypeScript Compiler API wrapper. Provides an easier way to programmatically navigate and manipulate TypeScript and JavaScript code.

Formerly ts-simple-ast.

Overview

Main Features

  1. Wraps the compiler API objects to provide helper methods for getting information and programmatically changing files.
  2. Allows falling back to the compiler API objects if necessary (ex. classDeclaration.compilerNode or typeChecker.compilerObject).
  3. All changes are kept in memory (including file and directory moves) until specifying to save to the underlying file system.
  4. Changes are made to the text and wrapped nodes can be held onto between manipulations.

Getting Started

  1. Installing
  2. Instantiating
  3. Adding source files
  4. Getting source files
  5. Navigating
  6. Manipulating

Library Progress

This library is still under active development. Most common code manipulation/generation use cases are implemented, but there's still a lot of work to do. Please open an issue if you find a feature missing, bug, or question that isn't in the issue tracker.

Example

import { Project, StructureKind } from "ts-morph";

// initialize
const project = new Project({
    // Optionally specify compiler options, tsconfig.json, in-memory file system, and more here.
    // If you initialize with a tsconfig.json, then it will automatically populate the project
    // with the associated source files.
    // Read more: https://ts-morph.com/setup/
});

// add source files
project.addSourceFilesAtPaths("src/**/*.ts");
const myClassFile = project.createSourceFile("src/MyClass.ts", "export class MyClass {}");
const myEnumFile = project.createSourceFile("src/MyEnum.ts", {
    statements: [{
        kind: StructureKind.Enum,
        name: "MyEnum",
        isExported: true,
        members: [{ name: "member" }]
    }]
});

// get information
const myClass = myClassFile.getClassOrThrow("MyClass");
myClass.getName();          // returns: "MyClass"
myClass.hasExportKeyword(); // returns: true
myClass.isDefaultExport();  // returns: false

// manipulate
const myInterface = myClassFile.addInterface({
    name: "IMyInterface",
    isExported: true,
    properties: [{
        name: "myProp",
        type: "number"
    }]
});

myClass.rename("NewName");
myClass.addImplements(myInterface.getName());
myClass.addProperty({
    name: "myProp",
    initializer: "5"
});

project.getSourceFileOrThrow("src/ExistingFile.ts").delete();

// asynchronously save all the changes above
await project.save();

// get underlying compiler node from the typescript AST from any node
const compilerNode = myClassFile.compilerNode;

Or navigate existing compiler nodes created with the TypeScript compiler (the ts named export is the TypeScript compiler):

import { createWrappedNode, ClassDeclaration, ts } from "ts-morph";

// some code that creates a class declaration using the ts object
const classNode: ts.ClassDeclaration = ...;

// create and use a wrapped node
const classDec = createWrappedNode(classNode) as ClassDeclaration;
const firstProperty = classDec.getProperties()[0];

// ... do more stuff here ...

Current Tags

  • 7.1.2                                ...           latest (22 days ago)
  • 2.0.4-rc                                ...           rc (a year ago)

45 Versions

  • 7.1.2                                ...           22 days ago
  • 7.1.1                                ...           a month ago
  • 7.1.0                                ...           2 months ago
  • 7.0.3                                ...           2 months ago
  • 7.0.2                                ...           3 months ago
  • 7.0.1                                ...           3 months ago
  • 7.0.0                                ...           5 months ago
  • 6.0.3                                ...           5 months ago
  • 1.3.5                                ...           5 months ago
  • 6.0.2                                ...           7 months ago
  • 6.0.1                                ...           7 months ago
  • 5.0.0                                ...           8 months ago
  • 4.3.3                                ...           8 months ago
  • 4.3.2                                ...           9 months ago
  • 4.3.1                                ...           9 months ago
  • 4.3.0                                ...           9 months ago
  • 4.2.0                                ...           9 months ago
  • 4.1.1                                ...           9 months ago
  • 4.1.0                                ...           9 months ago
  • 4.0.1                                ...           10 months ago
  • 4.0.0                                ...           10 months ago
  • 3.1.3                                ...           a year ago
  • 3.1.2                                ...           a year ago
  • 3.1.1                                ...           a year ago
  • 3.1.0                                ...           a year ago
  • 3.0.0                                ...           a year ago
  • 2.3.0                                ...           a year ago
  • 1.3.4                                ...           a year ago
  • 2.2.0                                ...           a year ago
  • 2.1.2                                ...           a year ago
  • 2.1.1                                ...           a year ago
  • 2.1.0                                ...           a year ago
  • 2.0.1                                ...           a year ago
  • 2.0.4-rc                                ...           a year ago
  • 2.0.3-rc                                ...           a year ago
  • 2.0.2-rc                                ...           a year ago
  • 2.0.1-rc                                ...           a year ago
  • 2.0.0-rc                                ...           a year ago
  • 1.3.3                                ...           a year ago
  • 1.3.2                                ...           a year ago
  • 1.3.1                                ...           a year ago
  • 1.3.0                                ...           a year ago
  • 1.2.0                                ...           a year ago
  • 1.1.0                                ...           a year ago
  • 1.0.0                                ...           a year ago
Maintainers (1)
Downloads
Today 176
This Week 1,150
This Month 2,491
Last Day 244
Last Week 1,983
Last Month 7,294
Dependencies (3)
Dev Dependencies (22)
Dependents (268)

Copyright 2014 - 2016 © taobao.org |