tsc-ts 0.0.3 → 0.0.5

package/dist/api/compiler/printer/printer.d.ts

@@ -0,0 +1,411 @@
+import { type Node, SourceFile } from '../ast.js';
+import { ScriptTarget } from '../options.js';
+import type { SourceMapGenerator } from '../sourcemap.js';
+import { EmitContext } from './emit-context.js';
+import { NameGenerator, NameGeneratorHost } from './name-generator.js';
+import { TextWriter } from './text-writer.js';
+export declare class PrinterOptions {
+    removeComments: boolean;
+    /** `"\n"` or `"\r\n"`. */
+    newLine: string;
+    noEmitHelpers: boolean;
+    target: ScriptTarget;
+    sourceMap: boolean;
+    inlineSourceMap: boolean;
+    inlineSources: boolean;
+    omitBraceSourceMapPositions: boolean;
+    /** Only keep JSDoc-style and pinned comments (declaration emit). */
+    onlyPrintJSDocStyle: boolean;
+    neverAsciiEscape: boolean;
+    preserveSourceNewlines: boolean;
+    terminateUnterminatedLiterals: boolean;
+    constructor();
+}
+export declare const enum ListFormat {
+    None = 0,
+    MultiLine = 1,
+    PreserveLines = 2,
+    LinesMask = 3,
+    BarDelimited = 4,
+    AmpersandDelimited = 8,
+    CommaDelimited = 16,
+    AsteriskDelimited = 32,
+    DelimitersMask = 60,
+    AllowTrailingComma = 64,
+    Indented = 128,
+    SpaceBetweenBraces = 256,
+    SpaceBetweenSiblings = 512,
+    Braces = 1024,
+    Parenthesis = 2048,
+    AngleBrackets = 4096,
+    SquareBrackets = 8192,
+    BracketsMask = 15360,
+    OptionalIfNil = 16384,
+    OptionalIfEmpty = 32768,
+    Optional = 49152,
+    PreferNewLine = 65536,
+    NoTrailingNewLine = 131072,
+    NoInterveningComments = 262144,
+    NoSpaceIfEmpty = 524288,
+    SingleElement = 1048576,
+    SpaceAfterList = 2097152,
+    Modifiers = 2359808,
+    HeritageClauses = 512,
+    SingleLineTypeLiteralMembers = 768,
+    MultiLineTypeLiteralMembers = 32897,
+    SingleLineTupleTypeElements = 528,
+    MultiLineTupleTypeElements = 657,
+    UnionTypeConstituents = 516,
+    IntersectionTypeConstituents = 520,
+    ObjectBindingPatternElements = 525136,
+    ArrayBindingPatternElements = 524880,
+    ObjectLiteralExpressionProperties = 526226,
+    ImportAttributes = 526226,
+    ArrayLiteralExpressionElements = 8914,
+    CommaListElements = 528,
+    CallExpressionArguments = 2576,
+    NewExpressionArguments = 18960,
+    TemplateExpressionSpans = 262144,
+    SingleLineBlockStatements = 768,
+    MultiLineBlockStatements = 129,
+    VariableDeclarationList = 528,
+    SingleLineFunctionBodyStatements = 768,
+    MultiLineFunctionBodyStatements = 1,
+    ClassHeritageClauses = 0,
+    ClassMembers = 129,
+    InterfaceMembers = 129,
+    EnumMembers = 145,
+    CaseBlockClauses = 129,
+    NamedImportsOrExportsElements = 525136,
+    JsxElementOrFragmentChildren = 262144,
+    JsxElementAttributes = 262656,
+    CaseOrDefaultClauseStatements = 163969,
+    HeritageClauseTypes = 528,
+    SourceFileStatements = 131073,
+    Decorators = 2146305,
+    TypeArguments = 53776,
+    TypeParameters = 53776,
+    Parameters = 2576,
+    SingleArrowParameter = 528,
+    IndexSignatureParameters = 8848,
+    JSDocComment = 33
+}
+export declare class Printer extends NameGeneratorHost {
+    readonly options: PrinterOptions;
+    readonly context: EmitContext;
+    /**
+     * Generates the names of the printed file, created when first needed: it refers back to the printer (its host),
+     * and printing a type node never generates names.
+     */
+    private nameGeneratorStore;
+    currentSourceFile: SourceFile | undefined;
+    private sourceText;
+    private lineStarts;
+    private writer;
+    private ownWriter;
+    private uniqueHelperNames;
+    private externalHelpersModuleName;
+    private nextListElementPos;
+    private containerPos;
+    private containerEnd;
+    private declarationListContainerEnd;
+    /** Pairs of (node pos, end of its detached comments). */
+    private readonly detachedComments;
+    private commentsDisabled;
+    /** Emitting the `extends` clause of a conditional or infer type. */
+    private inExtends;
+    /** Saved comment state: emit flags, comment pos, comment end, container pos, container end, declaration list end. */
+    private readonly commentStack;
+    /** Saved source map state: emit flags, pos, end, has token range. */
+    private readonly sourceMapStack;
+    /** The token position after `enterToken` skipped trivia. */
+    private tokenPos;
+    private sourceMapsDisabled;
+    private sourceMapGenerator;
+    private sourceMapSource;
+    private sourceMapSourceIndex;
+    private sourceMapSourceIsJson;
+    private sourceMapLineStarts;
+    /** The line of the last source map position, where finding the next one's starts. */
+    private sourceMapLine;
+    private mostRecentSourceMapSource;
+    private mostRecentSourceMapSourceIndex;
+    get nameGenerator(): NameGenerator;
+    constructor(options: PrinterOptions, context: EmitContext | undefined);
+    /** Prints `node` (in the context of `sourceFile`, if given) and returns the text. */
+    emit(node: Node, sourceFile: SourceFile | undefined): string;
+    emitSourceFile(sourceFile: SourceFile): string;
+    private setSourceFile;
+    private setCurrentSourceFile;
+    /** Prints `node` into `writer`, adding mappings to `sourceMapGenerator` if given. */
+    write(node: Node, sourceFile: SourceFile | undefined, writer: TextWriter, sourceMapGenerator: SourceMapGenerator | undefined): boolean;
+    isFileLevelUniqueName(name: string): boolean;
+    private getLiteralTextOfNode;
+    /** The text of an identifier, private identifier, literal or JSX namespaced name as printed. */
+    getTextOfNode(node: Node): string;
+    private isInCurrentSourceFile;
+    private write1;
+    private space;
+    private line;
+    private lines;
+    private indentIf;
+    private writeLinesOfText;
+    private writeLineOrSpace;
+    private writeLinesAndIndent;
+    private writeLineSeparatorsAndIndentBefore;
+    private writeLineSeparatorsAfter;
+    private positionsAreOnSameLine;
+    private rangeStart;
+    private rangeIsOnSingleLine;
+    private rangeEndIsOnSameLineAsRangeStart;
+    private getEffectiveLinesBetweenEndAndStart;
+    private getLinesBetweenNodes;
+    private linesToPrecedingNonWhitespace;
+    private linesToNextNonWhitespace;
+    private getLeadingLineTerminatorCount;
+    private getSeparatingLineTerminatorCount;
+    private getClosingLineTerminatorCount;
+    private siblingNodePositionsAreComparable;
+    private originalNodesHaveSameParent;
+    private writeCommentRange;
+    private writeCommentText;
+    private shouldEmitComments;
+    private shouldWriteComment;
+    private hasEmitFlag;
+    private shouldEmitIndented;
+    private shouldElideIndentation;
+    private shouldEmitOnSingleLine;
+    private shouldEmitOnNewLine;
+    private shouldEmitBlockFunctionBodyOnSingleLine;
+    private shouldEmitSourceMaps;
+    private shouldAllowTrailingComma;
+    private hasCommentsAtPosition;
+    private writeTokenText;
+    private emitToken;
+    private emitTokenEx;
+    private emitOptionalToken;
+    private emitTokenNode;
+    private emitTokenNodeEx;
+    private emitLiteral;
+    private emitIdentifierText;
+    private emitIdentifierName;
+    private getUniqueHelperName;
+    private emitIdentifierReference;
+    private emitBindingIdentifier;
+    private emitPrivateIdentifier;
+    private emitQualifiedName;
+    private emitComputedPropertyName;
+    private emitEntityName;
+    private emitBindingName;
+    private emitPropertyName;
+    private emitMemberName;
+    /** Module names, module export names, import attribute names and nested module names. */
+    private emitIdentifierOrString;
+    private emitModifierList;
+    private emitTypeParameter;
+    private emitParameter;
+    private emitDecorator;
+    private emitTypeParameters;
+    private emitTypeAnnotation;
+    private emitInitializer;
+    private emitParameters;
+    private canEmitSimpleArrowHead;
+    private emitParametersForArrow;
+    private emitSignature;
+    private emitFunctionBody;
+    private emitFunctionBodyNode;
+    private emitPropertySignature;
+    private emitPropertyDeclaration;
+    /** Emits a signature in its own name scope, indented if the node asks for it. */
+    private emitScopedSignature;
+    private emitMethodSignature;
+    private emitMethodDeclaration;
+    private emitClassStaticBlockDeclaration;
+    private emitConstructor;
+    private emitAccessor;
+    private emitGetAccessor;
+    private emitSetAccessor;
+    private emitCallSignature;
+    private emitConstructSignature;
+    private emitIndexSignature;
+    private emitClassElement;
+    private emitTypeElement;
+    private emitObjectLiteralElement;
+    /** A node printed as fixed text, such as `;` for a semicolon class element. */
+    private emitSimpleNode;
+    private emitTypePredicate;
+    private emitTypeArguments;
+    private emitReturnType;
+    private emitFunctionType;
+    private emitConstructorType;
+    private emitTypeLiteral;
+    /** The operand of a postfix type; a parsed `typeof X` operand keeps no parentheses. */
+    private emitPostfixTypeOperand;
+    private emitTupleType;
+    private emitNamedTupleMember;
+    private emitConditionalType;
+    private emitInferType;
+    private emitTypeOperator;
+    private emitMappedType;
+    private emitTemplateType;
+    private emitTemplateTypeSpan;
+    private emitImportType;
+    private emitTypeNodeInExtends;
+    private emitTypeNodeOutsideExtends;
+    private emitTypeNode;
+    private emitTypeNodeWorker;
+    private emitJSDocPrefixType;
+    private emitBindingPattern;
+    private emitBindingElement;
+    private emitArrayLiteralExpression;
+    private emitObjectLiteralExpression;
+    /** `1..toString()`: a decimal integer literal needs a second dot before a property access. */
+    private mayNeedDotDotForPropertyAccess;
+    private emitPropertyAccessExpression;
+    private emitElementAccessExpression;
+    private emitCallee;
+    private emitCallExpression;
+    private emitNewExpression;
+    private emitTaggedTemplateExpression;
+    private emitParenthesizedExpression;
+    private emitFunctionExpression;
+    private emitConciseBody;
+    private emitArrowFunction;
+    /** `delete`, `typeof`, `void` and `await` expressions. */
+    private emitKeywordUnary;
+    private emitPrefixUnaryExpression;
+    private emitPostfixUnaryExpression;
+    /** The literal kind shared by all operands of a chain of `+`, or Unknown. */
+    private getLiteralKindOfBinaryPlusOperand;
+    /** The precedence the right operand of a binary expression needs; the left's is `getExpressionPrecedence`. */
+    private getBinaryRightPrecedence;
+    private emitBinaryExpression;
+    private emitConditionalExpression;
+    private emitTemplateExpression;
+    private emitYieldExpression;
+    private emitSpreadElement;
+    private emitClassLike;
+    private emitExpressionWithTypeArguments;
+    /** `as` and `satisfies` expressions. */
+    private emitTypeRelation;
+    private emitPartiallyEmittedExpression;
+    private commentWillEmitNewLine;
+    private willEmitLeadingNewLine;
+    /** Parenthesizes an expression whose leading comments would put a line break after `return` or `throw`. */
+    private parenthesizeExpressionForNoAsi;
+    private emitExpressionNoASI;
+    private emitExpression;
+    private emitExpressionWorker;
+    private isEmptyBlock;
+    private emitBlock;
+    private emitVariableStatement;
+    private emitExpressionStatement;
+    /** `if`/`while`/`with`/`switch` heads: keyword, `(`, expression, `)`. */
+    private emitKeywordAndParenthesizedExpression;
+    private emitIfStatement;
+    private emitDoStatement;
+    private emitForInitializer;
+    private emitForStatement;
+    private emitForInOrOfStatement;
+    /** `break`, `continue` and `return` with their optional operand. */
+    private emitJumpStatement;
+    private emitTryStatement;
+    private emitEmbeddedStatement;
+    private emitVariableDeclaration;
+    private emitVariableDeclarationList;
+    private emitFunctionDeclaration;
+    private emitInterfaceDeclaration;
+    private emitTypeAliasDeclaration;
+    private emitEnumDeclaration;
+    private emitModuleDeclaration;
+    /** Module blocks and case blocks: braces around a statement or clause list. */
+    private emitBlockLike;
+    private emitImportEqualsDeclaration;
+    private emitImportDeclaration;
+    private emitImportClause;
+    /** Import and export specifiers. */
+    private emitSpecifier;
+    private emitExportAssignment;
+    private emitExportDeclaration;
+    private emitImportAttributes;
+    private emitImportAttribute;
+    private emitNamespaceExportDeclaration;
+    private emitStatement;
+    private emitJsxElement;
+    private emitJsxSelfClosingElement;
+    private emitJsxFragment;
+    private emitJsxOpeningElement;
+    private emitJsxClosingElement;
+    private emitJsxAttributes;
+    private emitJsxAttribute;
+    private emitJsxExpression;
+    private emitJsxName;
+    private emitJsxTagName;
+    private emitJsxChild;
+    private emitCaseOrDefaultClause;
+    private emitHeritageClause;
+    private emitCatchClause;
+    private emitPropertyAssignment;
+    private emitShorthandPropertyAssignment;
+    private emitSpreadAssignment;
+    private emitEnumMember;
+    private emitPrologueDirectives;
+    private emitHelpers;
+    private emitSourceFileNode;
+    private emitTripleSlashDirectives;
+    private emitDirectives;
+    private emitListItem;
+    private emitList;
+    private emitListRange;
+    /** Whether to keep a list's trailing comma; for transformed nodes, as in the original list. */
+    private hasTrailingComma;
+    private writeDelimiter;
+    private emitListItems;
+    private emitAnyNode;
+    private emitCommentsBeforeNode;
+    private emitCommentsAfterNode;
+    /** Emits comments before a token; returns whether `emitCommentsAfterToken` applies, with the token's position in `tokenPos`. */
+    private emitCommentsBeforeToken;
+    private emitCommentsAfterToken;
+    private emitDetachedCommentsBeforeStatementList;
+    /** `flags` is what `emitDetachedCommentsBeforeStatementList` returned; -1 if it emitted nothing. */
+    private emitDetachedCommentsAfterStatementList;
+    private emitLeadingCommentsOfNode;
+    private emitTrailingCommentsOfNode;
+    private emitLeadingSynthesizedComment;
+    private emitTrailingSynthesizedComment;
+    private writeSynthesizedComment;
+    private emitLeadingComments;
+    private shouldEmitNewLineBeforeLeadingComment;
+    private emitLeadingCommentsOfPosition;
+    private emitTrailingComments;
+    private emitTrailingCommentsOfPosition;
+    private emitDetachedCommentsAndUpdateCommentsInfo;
+    /** Emits a leading copyright-style comment block; returns its end, or -1 if there is none. */
+    private emitDetachedComments;
+    private emitComments;
+    private emitComment;
+    private setSourceMapSource;
+    private emitPos;
+    /**
+     * The line of `pos` in the source map source, as `computeLineOfPosition` finds it. Positions mostly
+     * increase, so the line of the last position and the few after it are tried first.
+     */
+    private sourceMapLineOf;
+    private emitSourceMapsBeforeNode;
+    private emitSourceMapsAfterNode;
+    private emitSourceMapsBeforeToken;
+    private emitSourceMapsAfterToken;
+    private pushNameGenerationScope;
+    private popNameGenerationScope;
+    private generateAllNames;
+    private generateNames;
+    private generateAllMemberNames;
+    private generateNameIfNeeded;
+    private enterNode;
+    private exitNode;
+    private enterTokenNode;
+    private exitTokenNode;
+    private enterToken;
+    private exitToken;
+}