| import * as ts from 'typescript'; | |
| /** Wraps an AST node. Can be used as a tree using `children` or a linked list using `next` and `skip`. */ | |
| export interface NodeWrap { | |
| /** The real AST node. */ | |
| node: ts.Node; | |
| /** The SyntaxKind of `node`. */ | |
| kind: ts.SyntaxKind; | |
| /** All immediate children of `node` that would be visited by `ts.forEachChild(node, cb)`. */ | |
| children: NodeWrap[]; | |
| /** Link to the next NodeWrap, depth-first. */ | |
| next?: NodeWrap; | |
| /** Link to the next NodeWrap skipping all children of the current node. */ | |
| skip?: NodeWrap; | |
| /** Link to the parent NodeWrap */ | |
| parent?: NodeWrap; | |
| } | |
| export interface WrappedAst extends NodeWrap { | |
| node: ts.SourceFile; | |
| next: NodeWrap; | |
| skip: undefined; | |
| parent: undefined; | |
| } | |
| export interface ConvertedAst { | |
| /** nodes wrapped in a data structure with useful links */ | |
| wrapped: WrappedAst; | |
| /** depth-first array of all nodes excluding SourceFile */ | |
| flat: ReadonlyArray<ts.Node>; | |
| } | |
| /** | |
| * Takes a `ts.SourceFile` and creates data structures that are easier (or more performant) to traverse. | |
| * Note that there is only a performance gain if you can reuse these structures. It's not recommended for one-time AST walks. | |
| */ | |
| export declare function convertAst(sourceFile: ts.SourceFile): ConvertedAst; |