@ttsc/factory 0.15.6

package/src/ast/declarations/MethodDeclaration.ts

@@ -0,0 +1,43 @@
+import type { ParameterDeclaration } from "../clauses/ParameterDeclaration";
+import type { ModifierLike } from "../names/ModifierLike";
+import type { PropertyName } from "../names/PropertyName";
+import type { Token } from "../names/Token";
+import type { Block } from "../statements/Block";
+import type { TypeNode } from "../types/TypeNode";
+import type { TypeParameterDeclaration } from "../types/TypeParameterDeclaration";
+
+/**
+ * A class method declaration.
+ *
+ * Built by {@link factory.createMethodDeclaration}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface MethodDeclaration {
+  /** Discriminant tag; always `"MethodDeclaration"`. */
+  kind: "MethodDeclaration";
+
+  /** The leading modifiers and decorators, if any. */
+  modifiers?: readonly ModifierLike[];
+
+  /** The generator marker (`*`), if any. */
+  asteriskToken?: Token;
+
+  /** The name. */
+  name: PropertyName;
+
+  /** The optional marker (`?`), if any. */
+  questionToken?: Token;
+
+  /** The generic type parameters, if any. */
+  typeParameters?: readonly TypeParameterDeclaration[];
+
+  /** The parameters. */
+  parameters: readonly ParameterDeclaration[];
+
+  /** The type. */
+  type?: TypeNode;
+
+  /** The body. */
+  body?: Block;
+}

package/src/ast/declarations/ModuleBlock.ts

@@ -0,0 +1,16 @@
+import type { Statement } from "../statements/Statement";
+
+/**
+ * The `{ ... }` body of a namespace / module.
+ *
+ * Built by {@link factory.createModuleBlock}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface ModuleBlock {
+  /** Discriminant tag; always `"ModuleBlock"`. */
+  kind: "ModuleBlock";
+
+  /** Statements. */
+  statements: readonly Statement[];
+}

package/src/ast/declarations/ModuleBody.ts

@@ -0,0 +1,9 @@
+import type { ModuleBlock } from "./ModuleBlock";
+import type { ModuleDeclaration } from "./ModuleDeclaration";
+
+/**
+ * The body of a namespace / module declaration.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export type ModuleBody = ModuleBlock | ModuleDeclaration;

package/src/ast/declarations/ModuleDeclaration.ts

@@ -0,0 +1,28 @@
+import type { NodeFlags } from "../../syntax";
+import type { ModifierLike } from "../names/ModifierLike";
+import type { ModuleBody } from "./ModuleBody";
+import type { ModuleName } from "./ModuleName";
+
+/**
+ * A `namespace` / `module` declaration.
+ *
+ * Built by {@link factory.createModuleDeclaration}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface ModuleDeclaration {
+  /** Discriminant tag; always `"ModuleDeclaration"`. */
+  kind: "ModuleDeclaration";
+
+  /** Modifiers. */
+  modifiers?: readonly ModifierLike[];
+
+  /** Name. */
+  name: ModuleName;
+
+  /** Body. */
+  body?: ModuleBody;
+
+  /** Flags. */
+  flags: NodeFlags;
+}

package/src/ast/declarations/ModuleName.ts

@@ -0,0 +1,9 @@
+import type { StringLiteral } from "../expressions/StringLiteral";
+import type { Identifier } from "../names/Identifier";
+
+/**
+ * The name of a namespace / module declaration.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export type ModuleName = Identifier | StringLiteral;

package/src/ast/declarations/ModuleReference.ts

@@ -0,0 +1,9 @@
+import type { EntityName } from "../names/EntityName";
+import type { ExternalModuleReference } from "./ExternalModuleReference";
+
+/**
+ * The reference of an import-equals declaration.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export type ModuleReference = EntityName | ExternalModuleReference;

package/src/ast/declarations/NamespaceExportDeclaration.ts

@@ -0,0 +1,16 @@
+import type { Identifier } from "../names/Identifier";
+
+/**
+ * An `export as namespace X` declaration.
+ *
+ * Built by {@link factory.createNamespaceExportDeclaration}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface NamespaceExportDeclaration {
+  /** Discriminant tag; always `"NamespaceExportDeclaration"`. */
+  kind: "NamespaceExportDeclaration";
+
+  /** Name. */
+  name: Identifier;
+}

package/src/ast/declarations/PropertyDeclaration.ts

@@ -0,0 +1,32 @@
+import type { Expression } from "../expressions/Expression";
+import type { ModifierLike } from "../names/ModifierLike";
+import type { PropertyName } from "../names/PropertyName";
+import type { Token } from "../names/Token";
+import type { TypeNode } from "../types/TypeNode";
+
+/**
+ * A class property declaration.
+ *
+ * Built by {@link factory.createPropertyDeclaration}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface PropertyDeclaration {
+  /** Discriminant tag; always `"PropertyDeclaration"`. */
+  kind: "PropertyDeclaration";
+
+  /** The leading modifiers and decorators, if any. */
+  modifiers?: readonly ModifierLike[];
+
+  /** The name. */
+  name: PropertyName;
+
+  /** The optional (`?`) or definite-assignment (`!`) marker, if any. */
+  questionOrExclamationToken?: Token;
+
+  /** The type. */
+  type?: TypeNode;
+
+  /** The initializer, if any. */
+  initializer?: Expression;
+}

package/src/ast/declarations/SemicolonClassElement.ts

@@ -0,0 +1,11 @@
+/**
+ * A stray `;` in a class body.
+ *
+ * Built by {@link factory.createSemicolonClassElement}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface SemicolonClassElement {
+  /** Discriminant tag; always `"SemicolonClassElement"`. */
+  kind: "SemicolonClassElement";
+}

package/src/ast/declarations/SetAccessorDeclaration.ts

@@ -0,0 +1,28 @@
+import type { ParameterDeclaration } from "../clauses/ParameterDeclaration";
+import type { ModifierLike } from "../names/ModifierLike";
+import type { PropertyName } from "../names/PropertyName";
+import type { Block } from "../statements/Block";
+
+/**
+ * A class setter declaration.
+ *
+ * Built by {@link factory.createSetAccessorDeclaration}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface SetAccessorDeclaration {
+  /** Discriminant tag; always `"SetAccessorDeclaration"`. */
+  kind: "SetAccessorDeclaration";
+
+  /** The leading modifiers and decorators, if any. */
+  modifiers?: readonly ModifierLike[];
+
+  /** The name. */
+  name: PropertyName;
+
+  /** The parameters. */
+  parameters: readonly ParameterDeclaration[];
+
+  /** The body. */
+  body?: Block;
+}

package/src/ast/declarations/TypeAliasDeclaration.ts

@@ -0,0 +1,28 @@
+import type { Identifier } from "../names/Identifier";
+import type { ModifierLike } from "../names/ModifierLike";
+import type { TypeNode } from "../types/TypeNode";
+import type { TypeParameterDeclaration } from "../types/TypeParameterDeclaration";
+
+/**
+ * A type alias declaration.
+ *
+ * Built by {@link factory.createTypeAliasDeclaration}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface TypeAliasDeclaration {
+  /** Discriminant tag; always `"TypeAliasDeclaration"`. */
+  kind: "TypeAliasDeclaration";
+
+  /** The leading modifiers and decorators, if any. */
+  modifiers?: readonly ModifierLike[];
+
+  /** The name. */
+  name: Identifier;
+
+  /** The generic type parameters, if any. */
+  typeParameters?: readonly TypeParameterDeclaration[];
+
+  /** The type. */
+  type: TypeNode;
+}

package/src/ast/expressions/ArrayBindingElement.ts

@@ -0,0 +1,9 @@
+import type { BindingElement } from "./BindingElement";
+import type { OmittedExpression } from "./OmittedExpression";
+
+/**
+ * An element of an array binding pattern (or an elision).
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export type ArrayBindingElement = BindingElement | OmittedExpression;

package/src/ast/expressions/ArrayBindingPattern.ts

@@ -0,0 +1,16 @@
+import type { ArrayBindingElement } from "./ArrayBindingElement";
+
+/**
+ * An array destructuring pattern, e.g. `[a, b]`.
+ *
+ * Built by {@link factory.createArrayBindingPattern}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface ArrayBindingPattern {
+  /** Discriminant tag; always `"ArrayBindingPattern"`. */
+  kind: "ArrayBindingPattern";
+
+  /** Elements. */
+  elements: readonly ArrayBindingElement[];
+}

package/src/ast/expressions/ArrayLiteralExpression.ts

@@ -0,0 +1,19 @@
+import type { Expression } from "./Expression";
+
+/**
+ * An array literal, e.g. `[1, 2, 3]`.
+ *
+ * Built by {@link factory.createArrayLiteralExpression}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface ArrayLiteralExpression {
+  /** Discriminant tag; always `"ArrayLiteralExpression"`. */
+  kind: "ArrayLiteralExpression";
+
+  /** The array elements. */
+  elements: readonly Expression[];
+
+  /** When `true`, print one entry per line. */
+  multiLine?: boolean;
+}

package/src/ast/expressions/ArrowFunction.ts

@@ -0,0 +1,33 @@
+import type { ParameterDeclaration } from "../clauses/ParameterDeclaration";
+import type { ModifierLike } from "../names/ModifierLike";
+import type { Block } from "../statements/Block";
+import type { TypeNode } from "../types/TypeNode";
+import type { TypeParameterDeclaration } from "../types/TypeParameterDeclaration";
+import type { Expression } from "./Expression";
+
+/**
+ * An arrow function expression.
+ *
+ * Built by {@link factory.createArrowFunction}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface ArrowFunction {
+  /** Discriminant tag; always `"ArrowFunction"`. */
+  kind: "ArrowFunction";
+
+  /** The leading modifiers and decorators, if any. */
+  modifiers?: readonly ModifierLike[];
+
+  /** The generic type parameters, if any. */
+  typeParameters?: readonly TypeParameterDeclaration[];
+
+  /** The parameters. */
+  parameters: readonly ParameterDeclaration[];
+
+  /** The type. */
+  type?: TypeNode;
+
+  /** The body. */
+  body: Block | Expression;
+}

package/src/ast/expressions/AsExpression.ts

@@ -0,0 +1,20 @@
+import type { TypeNode } from "../types/TypeNode";
+import type { Expression } from "./Expression";
+
+/**
+ * A type assertion, e.g. `value as T`.
+ *
+ * Built by {@link factory.createAsExpression}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface AsExpression {
+  /** Discriminant tag; always `"AsExpression"`. */
+  kind: "AsExpression";
+
+  /** The expression. */
+  expression: Expression;
+
+  /** The type. */
+  type: TypeNode;
+}

package/src/ast/expressions/AwaitExpression.ts

@@ -0,0 +1,16 @@
+import type { Expression } from "./Expression";
+
+/**
+ * An `await` expression.
+ *
+ * Built by {@link factory.createAwaitExpression}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface AwaitExpression {
+  /** Discriminant tag; always `"AwaitExpression"`. */
+  kind: "AwaitExpression";
+
+  /** The expression. */
+  expression: Expression;
+}

package/src/ast/expressions/BigIntLiteral.ts

@@ -0,0 +1,14 @@
+/**
+ * A BigInt literal expression.
+ *
+ * Built by {@link factory.createBigIntLiteral}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface BigIntLiteral {
+  /** Discriminant tag; always `"BigIntLiteral"`. */
+  kind: "BigIntLiteral";
+
+  /** The BigInt literal text, including the trailing `n`. */
+  text: string;
+}

package/src/ast/expressions/BinaryExpression.ts

@@ -0,0 +1,23 @@
+import type { SyntaxKind } from "../../syntax";
+import type { Expression } from "./Expression";
+
+/**
+ * A binary expression, e.g. `a + b` or `a === b`.
+ *
+ * Built by {@link factory.createBinaryExpression}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface BinaryExpression {
+  /** Discriminant tag; always `"BinaryExpression"`. */
+  kind: "BinaryExpression";
+
+  /** The left-hand operand. */
+  left: Expression;
+
+  /** The operator token. */
+  operator: SyntaxKind;
+
+  /** The right-hand operand. */
+  right: Expression;
+}

package/src/ast/expressions/BindingElement.ts

@@ -0,0 +1,28 @@
+import type { PropertyName } from "../names/PropertyName";
+import type { Token } from "../names/Token";
+import type { BindingName } from "./BindingName";
+import type { Expression } from "./Expression";
+
+/**
+ * An element of a destructuring binding pattern.
+ *
+ * Built by {@link factory.createBindingElement}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface BindingElement {
+  /** Discriminant tag; always `"BindingElement"`. */
+  kind: "BindingElement";
+
+  /** DotDotDotToken. */
+  dotDotDotToken?: Token;
+
+  /** PropertyName. */
+  propertyName?: PropertyName;
+
+  /** Name. */
+  name: BindingName;
+
+  /** Initializer. */
+  initializer?: Expression;
+}

package/src/ast/expressions/BindingName.ts

@@ -0,0 +1,13 @@
+import type { Identifier } from "../names/Identifier";
+import type { ArrayBindingPattern } from "./ArrayBindingPattern";
+import type { ObjectBindingPattern } from "./ObjectBindingPattern";
+
+/**
+ * A binding name — an identifier or a destructuring pattern.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export type BindingName =
+  | Identifier
+  | ObjectBindingPattern
+  | ArrayBindingPattern;

package/src/ast/expressions/CallChain.ts

@@ -0,0 +1,27 @@
+import type { Token } from "../names/Token";
+import type { TypeNode } from "../types/TypeNode";
+import type { Expression } from "./Expression";
+
+/**
+ * An optional call, e.g. `a?.()`.
+ *
+ * Built by {@link factory.createCallChain}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface CallChain {
+  /** Discriminant tag; always `"CallChain"`. */
+  kind: "CallChain";
+
+  /** Expression. */
+  expression: Expression;
+
+  /** QuestionDotToken. */
+  questionDotToken?: Token;
+
+  /** TypeArguments. */
+  typeArguments?: readonly TypeNode[];
+
+  /** Arguments. */
+  arguments: readonly Expression[];
+}

package/src/ast/expressions/CallExpression.ts

@@ -0,0 +1,23 @@
+import type { TypeNode } from "../types/TypeNode";
+import type { Expression } from "./Expression";
+
+/**
+ * A function/method call, e.g. `fn(a, b)`.
+ *
+ * Built by {@link factory.createCallExpression}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface CallExpression {
+  /** Discriminant tag; always `"CallExpression"`. */
+  kind: "CallExpression";
+
+  /** The expression. */
+  expression: Expression;
+
+  /** The generic type arguments, if any. */
+  typeArguments?: readonly TypeNode[];
+
+  /** The arguments. */
+  arguments: readonly Expression[];
+}

package/src/ast/expressions/ClassExpression.ts

@@ -0,0 +1,32 @@
+import type { HeritageClause } from "../clauses/HeritageClause";
+import type { ClassElement } from "../declarations/ClassElement";
+import type { Identifier } from "../names/Identifier";
+import type { ModifierLike } from "../names/ModifierLike";
+import type { TypeParameterDeclaration } from "../types/TypeParameterDeclaration";
+
+/**
+ * A class expression.
+ *
+ * Built by {@link factory.createClassExpression}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface ClassExpression {
+  /** Discriminant tag; always `"ClassExpression"`. */
+  kind: "ClassExpression";
+
+  /** Modifiers. */
+  modifiers?: readonly ModifierLike[];
+
+  /** Name. */
+  name?: Identifier;
+
+  /** TypeParameters. */
+  typeParameters?: readonly TypeParameterDeclaration[];
+
+  /** HeritageClauses. */
+  heritageClauses?: readonly HeritageClause[];
+
+  /** Members. */
+  members: readonly ClassElement[];
+}

package/src/ast/expressions/CommaListExpression.ts

@@ -0,0 +1,16 @@
+import type { Expression } from "./Expression";
+
+/**
+ * A comma-separated expression list, e.g. `(a, b, c)`.
+ *
+ * Built by {@link factory.createCommaListExpression}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface CommaListExpression {
+  /** Discriminant tag; always `"CommaListExpression"`. */
+  kind: "CommaListExpression";
+
+  /** Elements. */
+  elements: readonly Expression[];
+}

package/src/ast/expressions/ComputedPropertyName.ts

@@ -0,0 +1,16 @@
+import type { Expression } from "./Expression";
+
+/**
+ * A computed member name, e.g. `[Symbol.iterator]`.
+ *
+ * Built by {@link factory.createComputedPropertyName}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface ComputedPropertyName {
+  /** Discriminant tag; always `"ComputedPropertyName"`. */
+  kind: "ComputedPropertyName";
+
+  /** Expression. */
+  expression: Expression;
+}

package/src/ast/expressions/ConditionalExpression.ts

@@ -0,0 +1,22 @@
+import type { Expression } from "./Expression";
+
+/**
+ * A ternary conditional, e.g. `cond ? a : b`.
+ *
+ * Built by {@link factory.createConditionalExpression}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface ConditionalExpression {
+  /** Discriminant tag; always `"ConditionalExpression"`. */
+  kind: "ConditionalExpression";
+
+  /** The condition. */
+  condition: Expression;
+
+  /** The value when the condition holds. */
+  whenTrue: Expression;
+
+  /** The value otherwise. */
+  whenFalse: Expression;
+}

package/src/ast/expressions/DeleteExpression.ts

@@ -0,0 +1,16 @@
+import type { Expression } from "./Expression";
+
+/**
+ * A `delete` expression.
+ *
+ * Built by {@link factory.createDeleteExpression}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface DeleteExpression {
+  /** Discriminant tag; always `"DeleteExpression"`. */
+  kind: "DeleteExpression";
+
+  /** Expression. */
+  expression: Expression;
+}

package/src/ast/expressions/ElementAccessChain.ts

@@ -0,0 +1,23 @@
+import type { Token } from "../names/Token";
+import type { Expression } from "./Expression";
+
+/**
+ * An optional element access, e.g. `a?.[k]`.
+ *
+ * Built by {@link factory.createElementAccessChain}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface ElementAccessChain {
+  /** Discriminant tag; always `"ElementAccessChain"`. */
+  kind: "ElementAccessChain";
+
+  /** Expression. */
+  expression: Expression;
+
+  /** QuestionDotToken. */
+  questionDotToken?: Token;
+
+  /** ArgumentExpression. */
+  argumentExpression: Expression;
+}

package/src/ast/expressions/ElementAccessExpression.ts

@@ -0,0 +1,19 @@
+import type { Expression } from "./Expression";
+
+/**
+ * An element access, e.g. `object[key]`.
+ *
+ * Built by {@link factory.createElementAccessExpression}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface ElementAccessExpression {
+  /** Discriminant tag; always `"ElementAccessExpression"`. */
+  kind: "ElementAccessExpression";
+
+  /** The expression. */
+  expression: Expression;
+
+  /** The index or key expression. */
+  argumentExpression: Expression;
+}