@ttsc/factory 0.15.6 → 0.15.7

package/lib/ast/jsx/JsxOpeningElement.d.ts

@@ -0,0 +1,20 @@
+import type { TypeNode } from "../types/TypeNode";
+import type { JsxAttributes } from "./JsxAttributes";
+import type { JsxTagName } from "./JsxTagName";
+/**
+ * The opening element of a {@link JsxElement}, e.g. `<Tag attr="x">`.
+ *
+ * Built by {@link factory.createJsxOpeningElement}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface JsxOpeningElement {
+    /** Discriminant tag; always `"JsxOpeningElement"`. */
+    kind: "JsxOpeningElement";
+    /** The tag name. */
+    tagName: JsxTagName;
+    /** The generic type arguments, if any. */
+    typeArguments?: readonly TypeNode[];
+    /** The attributes. */
+    attributes: JsxAttributes;
+}

package/lib/ast/jsx/JsxOpeningElement.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=JsxOpeningElement.js.map

package/lib/ast/jsx/JsxOpeningElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsxOpeningElement.js","sourceRoot":"","sources":["../../../src/ast/jsx/JsxOpeningElement.ts"],"names":[],"mappings":""}

package/lib/ast/jsx/JsxOpeningElement.mjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=JsxOpeningElement.mjs.map

package/lib/ast/jsx/JsxOpeningElement.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsxOpeningElement.mjs","sources":["JsxOpeningElement.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\n//# sourceMappingURL=JsxOpeningElement.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC"}

package/lib/ast/jsx/JsxOpeningFragment.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The opening fragment of a {@link JsxFragment}, i.e. `<>`.
+ *
+ * Built by {@link factory.createJsxOpeningFragment}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface JsxOpeningFragment {
+    /** Discriminant tag; always `"JsxOpeningFragment"`. */
+    kind: "JsxOpeningFragment";
+}

package/lib/ast/jsx/JsxOpeningFragment.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=JsxOpeningFragment.js.map

package/lib/ast/jsx/JsxOpeningFragment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsxOpeningFragment.js","sourceRoot":"","sources":["../../../src/ast/jsx/JsxOpeningFragment.ts"],"names":[],"mappings":""}

package/lib/ast/jsx/JsxOpeningFragment.mjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=JsxOpeningFragment.mjs.map

package/lib/ast/jsx/JsxOpeningFragment.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsxOpeningFragment.mjs","sources":["JsxOpeningFragment.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\n//# sourceMappingURL=JsxOpeningFragment.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC"}

package/lib/ast/jsx/JsxSelfClosingElement.d.ts

@@ -0,0 +1,20 @@
+import type { TypeNode } from "../types/TypeNode";
+import type { JsxAttributes } from "./JsxAttributes";
+import type { JsxTagName } from "./JsxTagName";
+/**
+ * A self-closing JSX element, e.g. `<Tag attr="x" />`.
+ *
+ * Built by {@link factory.createJsxSelfClosingElement}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface JsxSelfClosingElement {
+    /** Discriminant tag; always `"JsxSelfClosingElement"`. */
+    kind: "JsxSelfClosingElement";
+    /** The tag name. */
+    tagName: JsxTagName;
+    /** The generic type arguments, if any. */
+    typeArguments?: readonly TypeNode[];
+    /** The attributes. */
+    attributes: JsxAttributes;
+}

package/lib/ast/jsx/JsxSelfClosingElement.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=JsxSelfClosingElement.js.map

package/lib/ast/jsx/JsxSelfClosingElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsxSelfClosingElement.js","sourceRoot":"","sources":["../../../src/ast/jsx/JsxSelfClosingElement.ts"],"names":[],"mappings":""}

package/lib/ast/jsx/JsxSelfClosingElement.mjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=JsxSelfClosingElement.mjs.map

package/lib/ast/jsx/JsxSelfClosingElement.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsxSelfClosingElement.mjs","sources":["JsxSelfClosingElement.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\n//# sourceMappingURL=JsxSelfClosingElement.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC"}

package/lib/ast/jsx/JsxSpreadAttribute.d.ts

@@ -0,0 +1,14 @@
+import type { Expression } from "../expressions/Expression";
+/**
+ * A spread attribute in a JSX element, e.g. `{...props}`.
+ *
+ * Built by {@link factory.createJsxSpreadAttribute}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface JsxSpreadAttribute {
+    /** Discriminant tag; always `"JsxSpreadAttribute"`. */
+    kind: "JsxSpreadAttribute";
+    /** The expression. */
+    expression: Expression;
+}

package/lib/ast/jsx/JsxSpreadAttribute.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=JsxSpreadAttribute.js.map

package/lib/ast/jsx/JsxSpreadAttribute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsxSpreadAttribute.js","sourceRoot":"","sources":["../../../src/ast/jsx/JsxSpreadAttribute.ts"],"names":[],"mappings":""}

package/lib/ast/jsx/JsxSpreadAttribute.mjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=JsxSpreadAttribute.mjs.map

package/lib/ast/jsx/JsxSpreadAttribute.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsxSpreadAttribute.mjs","sources":["JsxSpreadAttribute.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\n//# sourceMappingURL=JsxSpreadAttribute.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC"}

package/lib/ast/jsx/JsxTagName.d.ts

@@ -0,0 +1,12 @@
+import type { PropertyAccessExpression } from "../expressions/PropertyAccessExpression";
+import type { Identifier } from "../names/Identifier";
+import type { Token } from "../names/Token";
+import type { JsxNamespacedName } from "./JsxNamespacedName";
+/**
+ * The tag name of a JSX element — an {@link Identifier}, a `this` keyword
+ * {@link Token}, a dotted {@link PropertyAccessExpression}, or a
+ * {@link JsxNamespacedName}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export type JsxTagName = Identifier | Token | PropertyAccessExpression | JsxNamespacedName;

package/lib/ast/jsx/JsxTagName.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=JsxTagName.js.map

package/lib/ast/jsx/JsxTagName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsxTagName.js","sourceRoot":"","sources":["../../../src/ast/jsx/JsxTagName.ts"],"names":[],"mappings":""}

package/lib/ast/jsx/JsxTagName.mjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=JsxTagName.mjs.map

package/lib/ast/jsx/JsxTagName.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsxTagName.mjs","sources":["JsxTagName.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\n//# sourceMappingURL=JsxTagName.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC"}

package/lib/ast/jsx/JsxText.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Literal text appearing as a child of a {@link JsxElement} or
+ * {@link JsxFragment}.
+ *
+ * Built by {@link factory.createJsxText}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface JsxText {
+    /** Discriminant tag; always `"JsxText"`. */
+    kind: "JsxText";
+    /** The text. */
+    text: string;
+    /** Whether the text contains only trivia whitespace. */
+    containsOnlyTriviaWhiteSpaces: boolean;
+}

package/lib/ast/jsx/JsxText.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=JsxText.js.map

package/lib/ast/jsx/JsxText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsxText.js","sourceRoot":"","sources":["../../../src/ast/jsx/JsxText.ts"],"names":[],"mappings":""}

package/lib/ast/jsx/JsxText.mjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=JsxText.mjs.map

package/lib/ast/jsx/JsxText.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsxText.mjs","sources":["JsxText.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\n//# sourceMappingURL=JsxText.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC"}

package/lib/ast/statements/NotEmittedStatement.d.ts

@@ -0,0 +1,14 @@
+import type { Node } from "../Node";
+/**
+ * A statement placeholder that is intentionally not emitted. It emits nothing.
+ *
+ * Built by {@link factory.createNotEmittedStatement}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface NotEmittedStatement {
+    /** Discriminant tag; always `"NotEmittedStatement"`. */
+    kind: "NotEmittedStatement";
+    /** The original node this placeholder replaces, if any. */
+    original?: Node;
+}

package/lib/ast/statements/NotEmittedStatement.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=NotEmittedStatement.js.map

package/lib/ast/statements/NotEmittedStatement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotEmittedStatement.js","sourceRoot":"","sources":["../../../src/ast/statements/NotEmittedStatement.ts"],"names":[],"mappings":""}

package/lib/ast/statements/NotEmittedStatement.mjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=NotEmittedStatement.mjs.map

package/lib/ast/statements/NotEmittedStatement.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotEmittedStatement.mjs","sources":["NotEmittedStatement.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\n//# sourceMappingURL=NotEmittedStatement.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC"}

package/lib/ast/statements/VariableDeclaration.d.ts

@@ -1,5 +1,5 @@
+import type { BindingName } from "../expressions/BindingName";
 import type { Expression } from "../expressions/Expression";
-import type { Identifier } from "../names/Identifier";
 import type { Token } from "../names/Token";
 import type { TypeNode } from "../types/TypeNode";
 /**
@@ -12,8 +12,8 @@ import type { TypeNode } from "../types/TypeNode";
 export interface VariableDeclaration {
     /** Discriminant tag; always `"VariableDeclaration"`. */
     kind: "VariableDeclaration";
-    /** The name. */
-    name: Identifier;
+    /** The name; a {@link BindingName} allows array / object destructuring. */
+    name: BindingName;
     /** The definite-assignment marker (`!`), if any. */
     exclamationToken?: Token;
     /** The type. */

package/lib/ast/types/LiteralTypeNode.d.ts

@@ -1,9 +1,10 @@
 import type { BigIntLiteral } from "../expressions/BigIntLiteral";
 import type { NumericLiteral } from "../expressions/NumericLiteral";
+import type { PrefixUnaryExpression } from "../expressions/PrefixUnaryExpression";
 import type { StringLiteral } from "../expressions/StringLiteral";
 import type { Token } from "../names/Token";
 /**
- * A literal type, e.g. `"red"` or `42`.
+ * A literal type, e.g. `"red"`, `42` or `-1`.
  *
  * Built by {@link factory.createLiteralTypeNode}.
  *
@@ -12,6 +13,6 @@ import type { Token } from "../names/Token";
 export interface LiteralTypeNode {
     /** Discriminant tag; always `"LiteralTypeNode"`. */
     kind: "LiteralTypeNode";
-    /** The literal. */
-    literal: StringLiteral | NumericLiteral | BigIntLiteral | Token;
+    /** The literal (a {@link PrefixUnaryExpression} covers negative numbers). */
+    literal: StringLiteral | NumericLiteral | BigIntLiteral | PrefixUnaryExpression | Token;
 }

package/lib/ast/types/NotEmittedTypeElement.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A type element placeholder that is intentionally not emitted. It emits
+ * nothing.
+ *
+ * Built by {@link factory.createNotEmittedTypeElement}.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface NotEmittedTypeElement {
+    /** Discriminant tag; always `"NotEmittedTypeElement"`. */
+    kind: "NotEmittedTypeElement";
+}

package/lib/ast/types/NotEmittedTypeElement.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=NotEmittedTypeElement.js.map

package/lib/ast/types/NotEmittedTypeElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotEmittedTypeElement.js","sourceRoot":"","sources":["../../../src/ast/types/NotEmittedTypeElement.ts"],"names":[],"mappings":""}

package/lib/ast/types/NotEmittedTypeElement.mjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=NotEmittedTypeElement.mjs.map

package/lib/ast/types/NotEmittedTypeElement.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotEmittedTypeElement.mjs","sources":["NotEmittedTypeElement.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\n//# sourceMappingURL=NotEmittedTypeElement.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC"}

package/lib/comments.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Synthetic comment attachment, mirroring the legacy
+ * `ts.addSyntheticLeadingComment` family of helpers.
+ *
+ * The legacy TypeScript compiler stores synthesized comments on a side-band
+ * `node.emitNode` slot rather than on the node itself; this module reproduces
+ * that behaviour with a {@link WeakMap} so the {@link import("./ast").Node}
+ * interfaces stay free of printer-only metadata. {@link TsPrinter} consults
+ * these stores while emitting and renders the comments verbatim — a leading
+ * comment is printed before the node, a trailing comment after it.
+ *
+ * ```typescript
+ * import factory, {
+ *   SyntaxKind,
+ *   TsPrinter,
+ *   addSyntheticLeadingComment,
+ * } from "@ttsc/factory";
+ *
+ * const node = addSyntheticLeadingComment(
+ *   factory.createTypeAliasDeclaration(
+ *     undefined,
+ *     "ID",
+ *     undefined,
+ *     factory.createKeywordTypeNode(SyntaxKind.StringKeyword),
+ *   ),
+ *   SyntaxKind.MultiLineCommentTrivia,
+ *   "*\n * The identifier.\n ",
+ *   true,
+ * );
+ * new TsPrinter().print(node);
+ * // /**
+ * //  * The identifier.
+ * //  *\/
+ * // type ID = string;
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+import type { Node } from "./ast";
+import { SyntaxKind } from "./syntax";
+/**
+ * A synthesized comment attached to a {@link Node}.
+ *
+ * Mirrors the legacy `ts.SynthesizedComment`. The {@link text} is the raw
+ * content placed between the comment delimiters — without the leading `//` of a
+ * single-line comment or the surrounding `/*` / `*\/` of a multi-line comment.
+ */
+export interface SynthesizedComment {
+    /** Whether the comment renders as `//` (single-line) or `/* *\/` (multi-line). */
+    kind: SyntaxKind.SingleLineCommentTrivia | SyntaxKind.MultiLineCommentTrivia;
+    /** The raw comment body, excluding the delimiters. */
+    text: string;
+    /** Emit a line break after the comment. Always implied for single-line. */
+    hasTrailingNewLine?: boolean;
+    /** Emit a line break before a trailing comment instead of a space. */
+    hasLeadingNewLine?: boolean;
+}
+/**
+ * Attach a synthesized leading comment to a node.
+ *
+ * Drop-in replacement for the legacy `ts.addSyntheticLeadingComment`. The
+ * comment is rendered by {@link TsPrinter} immediately before the node. The node
+ * is returned for call chaining.
+ *
+ * @param node The target node.
+ * @param kind Single-line (`//`) or multi-line (`/* *\/`) comment.
+ * @param text The raw comment body, excluding the delimiters.
+ * @param hasTrailingNewLine Whether to break the line after the comment.
+ * @returns The same `node`.
+ */
+export declare const addSyntheticLeadingComment: <T extends Node>(node: T, kind: SynthesizedComment["kind"], text: string, hasTrailingNewLine?: boolean) => T;
+/**
+ * Attach a synthesized trailing comment to a node.
+ *
+ * Drop-in replacement for the legacy `ts.addSyntheticTrailingComment`. The
+ * comment is rendered by {@link TsPrinter} immediately after the node. The node
+ * is returned for call chaining.
+ *
+ * @param node The target node.
+ * @param kind Single-line (`//`) or multi-line (`/* *\/`) comment.
+ * @param text The raw comment body, excluding the delimiters.
+ * @param hasTrailingNewLine Whether to break the line after the comment.
+ * @returns The same `node`.
+ */
+export declare const addSyntheticTrailingComment: <T extends Node>(node: T, kind: SynthesizedComment["kind"], text: string, hasTrailingNewLine?: boolean) => T;
+/** Read the synthesized leading comments attached to `node`, if any. */
+export declare const getSyntheticLeadingComments: (node: Node) => SynthesizedComment[] | undefined;
+/** Read the synthesized trailing comments attached to `node`, if any. */
+export declare const getSyntheticTrailingComments: (node: Node) => SynthesizedComment[] | undefined;
+/**
+ * Replace the synthesized leading comments of `node`.
+ *
+ * Passing `undefined` (or an empty list) clears them. The node is returned for
+ * call chaining.
+ */
+export declare const setSyntheticLeadingComments: <T extends Node>(node: T, comments: readonly SynthesizedComment[] | undefined) => T;
+/**
+ * Replace the synthesized trailing comments of `node`.
+ *
+ * Passing `undefined` (or an empty list) clears them. The node is returned for
+ * call chaining.
+ */
+export declare const setSyntheticTrailingComments: <T extends Node>(node: T, comments: readonly SynthesizedComment[] | undefined) => T;

package/lib/comments.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setSyntheticTrailingComments = exports.setSyntheticLeadingComments = exports.getSyntheticTrailingComments = exports.getSyntheticLeadingComments = exports.addSyntheticTrailingComment = exports.addSyntheticLeadingComment = void 0;
+const leadingStore = new WeakMap();
+const trailingStore = new WeakMap();
+const append = (store, node, comment) => {
+    const list = store.get(node);
+    if (list !== undefined)
+        list.push(comment);
+    else
+        store.set(node, [comment]);
+};
+/**
+ * Attach a synthesized leading comment to a node.
+ *
+ * Drop-in replacement for the legacy `ts.addSyntheticLeadingComment`. The
+ * comment is rendered by {@link TsPrinter} immediately before the node. The node
+ * is returned for call chaining.
+ *
+ * @param node The target node.
+ * @param kind Single-line (`//`) or multi-line (`/* *\/`) comment.
+ * @param text The raw comment body, excluding the delimiters.
+ * @param hasTrailingNewLine Whether to break the line after the comment.
+ * @returns The same `node`.
+ */
+const addSyntheticLeadingComment = (node, kind, text, hasTrailingNewLine) => {
+    append(leadingStore, node, { kind, text, hasTrailingNewLine });
+    return node;
+};
+exports.addSyntheticLeadingComment = addSyntheticLeadingComment;
+/**
+ * Attach a synthesized trailing comment to a node.
+ *
+ * Drop-in replacement for the legacy `ts.addSyntheticTrailingComment`. The
+ * comment is rendered by {@link TsPrinter} immediately after the node. The node
+ * is returned for call chaining.
+ *
+ * @param node The target node.
+ * @param kind Single-line (`//`) or multi-line (`/* *\/`) comment.
+ * @param text The raw comment body, excluding the delimiters.
+ * @param hasTrailingNewLine Whether to break the line after the comment.
+ * @returns The same `node`.
+ */
+const addSyntheticTrailingComment = (node, kind, text, hasTrailingNewLine) => {
+    append(trailingStore, node, { kind, text, hasTrailingNewLine });
+    return node;
+};
+exports.addSyntheticTrailingComment = addSyntheticTrailingComment;
+/** Read the synthesized leading comments attached to `node`, if any. */
+const getSyntheticLeadingComments = (node) => leadingStore.get(node);
+exports.getSyntheticLeadingComments = getSyntheticLeadingComments;
+/** Read the synthesized trailing comments attached to `node`, if any. */
+const getSyntheticTrailingComments = (node) => trailingStore.get(node);
+exports.getSyntheticTrailingComments = getSyntheticTrailingComments;
+/**
+ * Replace the synthesized leading comments of `node`.
+ *
+ * Passing `undefined` (or an empty list) clears them. The node is returned for
+ * call chaining.
+ */
+const setSyntheticLeadingComments = (node, comments) => {
+    if (comments !== undefined && comments.length !== 0)
+        leadingStore.set(node, comments.slice());
+    else
+        leadingStore.delete(node);
+    return node;
+};
+exports.setSyntheticLeadingComments = setSyntheticLeadingComments;
+/**
+ * Replace the synthesized trailing comments of `node`.
+ *
+ * Passing `undefined` (or an empty list) clears them. The node is returned for
+ * call chaining.
+ */
+const setSyntheticTrailingComments = (node, comments) => {
+    if (comments !== undefined && comments.length !== 0)
+        trailingStore.set(node, comments.slice());
+    else
+        trailingStore.delete(node);
+    return node;
+};
+exports.setSyntheticTrailingComments = setSyntheticTrailingComments;
+//# sourceMappingURL=comments.js.map

package/lib/comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../src/comments.ts"],"names":[],"mappings":";;;AA2DA,MAAM,YAAY,GAAG,IAAI,OAAO,EAAgC,CAAC;AACjE,MAAM,aAAa,GAAG,IAAI,OAAO,EAAgC,CAAC;AAElE,MAAM,MAAM,GAAG,CACb,KAA4C,EAC5C,IAAY,EACZ,OAA2B,EACrB,EAAE;IACR,MAAM,IAAI,GAAqC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/D,IAAI,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;;QACtC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACI,MAAM,0BAA0B,GAAG,CACxC,IAAO,EACP,IAAgC,EAChC,IAAY,EACZ,kBAA4B,EACzB,EAAE;IACL,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AARW,QAAA,0BAA0B,GAA1B,0BAA0B,CAQrC;AAEF;;;;;;;;;;;;GAYG;AACI,MAAM,2BAA2B,GAAG,CACzC,IAAO,EACP,IAAgC,EAChC,IAAY,EACZ,kBAA4B,EACzB,EAAE;IACL,MAAM,CAAC,aAAa,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAChE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AARW,QAAA,2BAA2B,GAA3B,2BAA2B,CAQtC;AAEF,wEAAwE;AACjE,MAAM,2BAA2B,GAAG,CACzC,IAAU,EACwB,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAFjD,QAAA,2BAA2B,GAA3B,2BAA2B,CAEsB;AAE9D,yEAAyE;AAClE,MAAM,4BAA4B,GAAG,CAC1C,IAAU,EACwB,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAFlD,QAAA,4BAA4B,GAA5B,4BAA4B,CAEsB;AAE/D;;;;;GAKG;AACI,MAAM,2BAA2B,GAAG,CACzC,IAAO,EACP,QAAmD,EAChD,EAAE;IACL,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QACjD,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;;QACtC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AARW,QAAA,2BAA2B,GAA3B,2BAA2B,CAQtC;AAEF;;;;;GAKG;AACI,MAAM,4BAA4B,GAAG,CAC1C,IAAO,EACP,QAAmD,EAChD,EAAE;IACL,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QACjD,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;;QACvC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AARW,QAAA,4BAA4B,GAA5B,4BAA4B,CAQvC"}

package/lib/comments.mjs

@@ -0,0 +1,82 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setSyntheticTrailingComments = exports.setSyntheticLeadingComments = exports.getSyntheticTrailingComments = exports.getSyntheticLeadingComments = exports.addSyntheticTrailingComment = exports.addSyntheticLeadingComment = void 0;
+const leadingStore = new WeakMap();
+const trailingStore = new WeakMap();
+const append = (store, node, comment) => {
+    const list = store.get(node);
+    if (list !== undefined)
+        list.push(comment);
+    else
+        store.set(node, [comment]);
+};
+/**
+ * Attach a synthesized leading comment to a node.
+ *
+ * Drop-in replacement for the legacy `ts.addSyntheticLeadingComment`. The
+ * comment is rendered by {@link TsPrinter} immediately before the node. The node
+ * is returned for call chaining.
+ *
+ * @param node The target node.
+ * @param kind Single-line (`//`) or multi-line (`/* *\/`) comment.
+ * @param text The raw comment body, excluding the delimiters.
+ * @param hasTrailingNewLine Whether to break the line after the comment.
+ * @returns The same `node`.
+ */
+const addSyntheticLeadingComment = (node, kind, text, hasTrailingNewLine) => {
+    append(leadingStore, node, { kind, text, hasTrailingNewLine });
+    return node;
+};
+exports.addSyntheticLeadingComment = addSyntheticLeadingComment;
+/**
+ * Attach a synthesized trailing comment to a node.
+ *
+ * Drop-in replacement for the legacy `ts.addSyntheticTrailingComment`. The
+ * comment is rendered by {@link TsPrinter} immediately after the node. The node
+ * is returned for call chaining.
+ *
+ * @param node The target node.
+ * @param kind Single-line (`//`) or multi-line (`/* *\/`) comment.
+ * @param text The raw comment body, excluding the delimiters.
+ * @param hasTrailingNewLine Whether to break the line after the comment.
+ * @returns The same `node`.
+ */
+const addSyntheticTrailingComment = (node, kind, text, hasTrailingNewLine) => {
+    append(trailingStore, node, { kind, text, hasTrailingNewLine });
+    return node;
+};
+exports.addSyntheticTrailingComment = addSyntheticTrailingComment;
+/** Read the synthesized leading comments attached to `node`, if any. */
+const getSyntheticLeadingComments = (node) => leadingStore.get(node);
+exports.getSyntheticLeadingComments = getSyntheticLeadingComments;
+/** Read the synthesized trailing comments attached to `node`, if any. */
+const getSyntheticTrailingComments = (node) => trailingStore.get(node);
+exports.getSyntheticTrailingComments = getSyntheticTrailingComments;
+/**
+ * Replace the synthesized leading comments of `node`.
+ *
+ * Passing `undefined` (or an empty list) clears them. The node is returned for
+ * call chaining.
+ */
+const setSyntheticLeadingComments = (node, comments) => {
+    if (comments !== undefined && comments.length !== 0)
+        leadingStore.set(node, comments.slice());
+    else
+        leadingStore.delete(node);
+    return node;
+};
+exports.setSyntheticLeadingComments = setSyntheticLeadingComments;
+/**
+ * Replace the synthesized trailing comments of `node`.
+ *
+ * Passing `undefined` (or an empty list) clears them. The node is returned for
+ * call chaining.
+ */
+const setSyntheticTrailingComments = (node, comments) => {
+    if (comments !== undefined && comments.length !== 0)
+        trailingStore.set(node, comments.slice());
+    else
+        trailingStore.delete(node);
+    return node;
+};
+exports.setSyntheticTrailingComments = setSyntheticTrailingComments;
+//# sourceMappingURL=comments.mjs.map

package/lib/comments.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.mjs","sources":["comments.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.setSyntheticTrailingComments = exports.setSyntheticLeadingComments = exports.getSyntheticTrailingComments = exports.getSyntheticLeadingComments = exports.addSyntheticTrailingComment = exports.addSyntheticLeadingComment = void 0;\nconst leadingStore = new WeakMap();\nconst trailingStore = new WeakMap();\nconst append = (store, node, comment) => {\n    const list = store.get(node);\n    if (list !== undefined)\n        list.push(comment);\n    else\n        store.set(node, [comment]);\n};\n/**\n * Attach a synthesized leading comment to a node.\n *\n * Drop-in replacement for the legacy `ts.addSyntheticLeadingComment`. The\n * comment is rendered by {@link TsPrinter} immediately before the node. The node\n * is returned for call chaining.\n *\n * @param node The target node.\n * @param kind Single-line (`//`) or multi-line (`/* *\\/`) comment.\n * @param text The raw comment body, excluding the delimiters.\n * @param hasTrailingNewLine Whether to break the line after the comment.\n * @returns The same `node`.\n */\nconst addSyntheticLeadingComment = (node, kind, text, hasTrailingNewLine) => {\n    append(leadingStore, node, { kind, text, hasTrailingNewLine });\n    return node;\n};\nexports.addSyntheticLeadingComment = addSyntheticLeadingComment;\n/**\n * Attach a synthesized trailing comment to a node.\n *\n * Drop-in replacement for the legacy `ts.addSyntheticTrailingComment`. The\n * comment is rendered by {@link TsPrinter} immediately after the node. The node\n * is returned for call chaining.\n *\n * @param node The target node.\n * @param kind Single-line (`//`) or multi-line (`/* *\\/`) comment.\n * @param text The raw comment body, excluding the delimiters.\n * @param hasTrailingNewLine Whether to break the line after the comment.\n * @returns The same `node`.\n */\nconst addSyntheticTrailingComment = (node, kind, text, hasTrailingNewLine) => {\n    append(trailingStore, node, { kind, text, hasTrailingNewLine });\n    return node;\n};\nexports.addSyntheticTrailingComment = addSyntheticTrailingComment;\n/** Read the synthesized leading comments attached to `node`, if any. */\nconst getSyntheticLeadingComments = (node) => leadingStore.get(node);\nexports.getSyntheticLeadingComments = getSyntheticLeadingComments;\n/** Read the synthesized trailing comments attached to `node`, if any. */\nconst getSyntheticTrailingComments = (node) => trailingStore.get(node);\nexports.getSyntheticTrailingComments = getSyntheticTrailingComments;\n/**\n * Replace the synthesized leading comments of `node`.\n *\n * Passing `undefined` (or an empty list) clears them. The node is returned for\n * call chaining.\n */\nconst setSyntheticLeadingComments = (node, comments) => {\n    if (comments !== undefined && comments.length !== 0)\n        leadingStore.set(node, comments.slice());\n    else\n        leadingStore.delete(node);\n    return node;\n};\nexports.setSyntheticLeadingComments = setSyntheticLeadingComments;\n/**\n * Replace the synthesized trailing comments of `node`.\n *\n * Passing `undefined` (or an empty list) clears them. The node is returned for\n * call chaining.\n */\nconst setSyntheticTrailingComments = (node, comments) => {\n    if (comments !== undefined && comments.length !== 0)\n        trailingStore.set(node, comments.slice());\n    else\n        trailingStore.delete(node);\n    return node;\n};\nexports.setSyntheticTrailingComments = setSyntheticTrailingComments;\n//# sourceMappingURL=comments.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,4BAA4B,GAAG,OAAO,CAAC,2BAA2B,GAAG,OAAO,CAAC,4BAA4B,GAAG,OAAO,CAAC,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,GAAG,OAAO,CAAC,0BAA0B,GAAG,MAAM;AAC3O,MAAM,YAAY,GAAG,IAAI,OAAO,EAAE;AAClC,MAAM,aAAa,GAAG,IAAI,OAAO,EAAE;AACnC,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,KAAK;AACzC,IAAI,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;AAChC,IAAI,IAAI,IAAI,KAAK,SAAS;AAC1B,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;AAC1B;AACA,QAAQ,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,0BAA0B,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,KAAK;AAC7E,IAAI,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;AAClE,IAAI,OAAO,IAAI;AACf,CAAC;AACD,OAAO,CAAC,0BAA0B,GAAG,0BAA0B;AAC/D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,2BAA2B,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,KAAK;AAC9E,IAAI,MAAM,CAAC,aAAa,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;AACnE,IAAI,OAAO,IAAI;AACf,CAAC;AACD,OAAO,CAAC,2BAA2B,GAAG,2BAA2B;AACjE;AACA,MAAM,2BAA2B,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;AACpE,OAAO,CAAC,2BAA2B,GAAG,2BAA2B;AACjE;AACA,MAAM,4BAA4B,GAAG,CAAC,IAAI,KAAK,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;AACtE,OAAO,CAAC,4BAA4B,GAAG,4BAA4B;AACnE;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,2BAA2B,GAAG,CAAC,IAAI,EAAE,QAAQ,KAAK;AACxD,IAAI,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;AACvD,QAAQ,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;AAChD;AACA,QAAQ,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;AACjC,IAAI,OAAO,IAAI;AACf,CAAC;AACD,OAAO,CAAC,2BAA2B,GAAG,2BAA2B;AACjE;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,4BAA4B,GAAG,CAAC,IAAI,EAAE,QAAQ,KAAK;AACzD,IAAI,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;AACvD,QAAQ,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;AACjD;AACA,QAAQ,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC;AAClC,IAAI,OAAO,IAAI;AACf,CAAC;AACD,OAAO,CAAC,4BAA4B,GAAG,4BAA4B"}

package/lib/factory/clauses/createHeritageClause.d.ts

@@ -1,10 +1,22 @@
 import type { ExpressionWithTypeArguments, HeritageClause } from "../../ast";
 import { SyntaxKind } from "../../syntax";
 /**
- * Create a {@link HeritageClause}.
+ * Create a {@link HeritageClause}: an `extends` or `implements` clause.
+ *
+ * This is the supertype list attached to a class or interface header. The
+ * `token` selects the keyword the printer emits, either the `extends` or the
+ * `implements` syntax kind. The `types` are the referenced supertypes, printed
+ * after the keyword and separated by commas.
+ *
+ * Given the `implements` token and the types `IAnimal` and `ISerializable`, the
+ * printed clause is:
+ *
+ * ```ts
+ * implements IAnimal, ISerializable
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param token The token.
+ * @param token The `extends` or `implements` keyword.
  * @param types The constituent types.
  * @returns The created {@link HeritageClause}.
  */