@ttsc/factory 0.15.6 → 0.15.8

package/lib/factory/types/createTypePredicateNode.mjs

@@ -3,13 +3,26 @@ exports.createTypePredicateNode = void 0;
 const make_1 = require("../internal/make");
 const createIdentifier_1 = require("../names/createIdentifier");
 /**
- * Create a {@link TypePredicateNode}.
+ * Create a {@link TypePredicateNode}: a `x is T` type guard return type, or an
+ * `asserts x is T` / `asserts x` assertion form.
+ *
+ * A leading `asserts ` prints when the asserts modifier is present, then the
+ * parameter name, then ` is Type` when a type is present. The assertion form
+ * with no type (just `asserts x`) is produced by passing the modifier and
+ * omitting the type. A string parameter name is normalized to an identifier.
+ *
+ * Given no asserts modifier, parameter `x`, and a `string` type, the printer
+ * renders:
+ *
+ * ```ts
+ * x is string
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param assertsModifier The assertsModifier.
- * @param parameterName The parameterName.
- * @param type The type.
- * @returns The created node.
+ * @param assertsModifier The `asserts` modifier, if any.
+ * @param parameterName The guarded parameter name, or `this`.
+ * @param type The narrowed type, if any.
+ * @returns The created {@link TypePredicateNode}.
  */
 const createTypePredicateNode = (assertsModifier, parameterName, type) => (0, make_1.make)("TypePredicateNode", {
     assertsModifier,

package/lib/factory/types/createTypePredicateNode.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createTypePredicateNode.mjs","sources":["createTypePredicateNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTypePredicateNode = void 0;\nconst make_1 = require(\"../internal/make\");\nconst createIdentifier_1 = require(\"../names/createIdentifier\");\n/**\n * Create a {@link TypePredicateNode}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param assertsModifier The assertsModifier.\n * @param parameterName The parameterName.\n * @param type The type.\n * @returns The created node.\n */\nconst createTypePredicateNode = (assertsModifier, parameterName, type) => (0, make_1.make)(\"TypePredicateNode\", {\n    assertsModifier,\n    parameterName: typeof parameterName === \"string\"\n        ? (0, createIdentifier_1.createIdentifier)(parameterName)\n        : parameterName,\n    type,\n});\nexports.createTypePredicateNode = createTypePredicateNode;\n//# sourceMappingURL=createTypePredicateNode.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,uBAAuB,GAAG,MAAM;AACxC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C,MAAM,kBAAkB,GAAG,OAAO,CAAC,2BAA2B,CAAC;AAC/D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,uBAAuB,GAAG,CAAC,eAAe,EAAE,aAAa,EAAE,IAAI,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE;AAChH,IAAI,eAAe;AACnB,IAAI,aAAa,EAAE,OAAO,aAAa,KAAK;AAC5C,UAAU,IAAI,kBAAkB,CAAC,gBAAgB,EAAE,aAAa;AAChE,UAAU,aAAa;AACvB,IAAI,IAAI;AACR,CAAC,CAAC;AACF,OAAO,CAAC,uBAAuB,GAAG,uBAAuB"}
+{"version":3,"file":"createTypePredicateNode.mjs","sources":["createTypePredicateNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTypePredicateNode = void 0;\nconst make_1 = require(\"../internal/make\");\nconst createIdentifier_1 = require(\"../names/createIdentifier\");\n/**\n * Create a {@link TypePredicateNode}: a `x is T` type guard return type, or an\n * `asserts x is T` / `asserts x` assertion form.\n *\n * A leading `asserts ` prints when the asserts modifier is present, then the\n * parameter name, then ` is Type` when a type is present. The assertion form\n * with no type (just `asserts x`) is produced by passing the modifier and\n * omitting the type. A string parameter name is normalized to an identifier.\n *\n * Given no asserts modifier, parameter `x`, and a `string` type, the printer\n * renders:\n *\n * ```ts\n * x is string\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param assertsModifier The `asserts` modifier, if any.\n * @param parameterName The guarded parameter name, or `this`.\n * @param type The narrowed type, if any.\n * @returns The created {@link TypePredicateNode}.\n */\nconst createTypePredicateNode = (assertsModifier, parameterName, type) => (0, make_1.make)(\"TypePredicateNode\", {\n    assertsModifier,\n    parameterName: typeof parameterName === \"string\"\n        ? (0, createIdentifier_1.createIdentifier)(parameterName)\n        : parameterName,\n    type,\n});\nexports.createTypePredicateNode = createTypePredicateNode;\n//# sourceMappingURL=createTypePredicateNode.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,uBAAuB,GAAG,MAAM;AACxC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C,MAAM,kBAAkB,GAAG,OAAO,CAAC,2BAA2B,CAAC;AAC/D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,uBAAuB,GAAG,CAAC,eAAe,EAAE,aAAa,EAAE,IAAI,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE;AAChH,IAAI,eAAe;AACnB,IAAI,aAAa,EAAE,OAAO,aAAa,KAAK;AAC5C,UAAU,IAAI,kBAAkB,CAAC,gBAAgB,EAAE,aAAa;AAChE,UAAU,aAAa;AACvB,IAAI,IAAI;AACR,CAAC,CAAC;AACF,OAAO,CAAC,uBAAuB,GAAG,uBAAuB"}

package/lib/factory/types/createTypeQueryNode.d.ts

@@ -1,6 +1,16 @@
 import type { EntityName, TypeQueryNode } from "../../ast";
 /**
- * Create a {@link TypeQueryNode}.
+ * Create a {@link TypeQueryNode}: a `typeof x` type query.
+ *
+ * The `typeof ` keyword prints in front of the queried entity name, which may
+ * be a qualified name such as `typeof ns.value`. This yields the type of a
+ * value rather than referencing a type directly.
+ *
+ * Given the entity name `foo`, the printer renders:
+ *
+ * ```ts
+ * typeof foo;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param exprName The queried entity name.

package/lib/factory/types/createTypeQueryNode.js

@@ -3,7 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTypeQueryNode = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link TypeQueryNode}.
+ * Create a {@link TypeQueryNode}: a `typeof x` type query.
+ *
+ * The `typeof ` keyword prints in front of the queried entity name, which may
+ * be a qualified name such as `typeof ns.value`. This yields the type of a
+ * value rather than referencing a type directly.
+ *
+ * Given the entity name `foo`, the printer renders:
+ *
+ * ```ts
+ * typeof foo;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param exprName The queried entity name.

package/lib/factory/types/createTypeQueryNode.js.map

@@ -1 +1 @@
-{"version":3,"file":"createTypeQueryNode.js","sourceRoot":"","sources":["../../../src/factory/types/createTypeQueryNode.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;GAMG;AACI,MAAM,mBAAmB,GAAG,CAAC,QAAoB,EAAiB,EAAE,CACzE,IAAA,WAAI,EAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AADzB,QAAA,mBAAmB,GAAnB,mBAAmB,CACM"}
+{"version":3,"file":"createTypeQueryNode.js","sourceRoot":"","sources":["../../../src/factory/types/createTypeQueryNode.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;;GAgBG;AACI,MAAM,mBAAmB,GAAG,CAAC,QAAoB,EAAiB,EAAE,CACzE,IAAA,WAAI,EAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AADzB,QAAA,mBAAmB,GAAnB,mBAAmB,CACM"}

package/lib/factory/types/createTypeQueryNode.mjs

@@ -2,7 +2,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTypeQueryNode = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link TypeQueryNode}.
+ * Create a {@link TypeQueryNode}: a `typeof x` type query.
+ *
+ * The `typeof ` keyword prints in front of the queried entity name, which may
+ * be a qualified name such as `typeof ns.value`. This yields the type of a
+ * value rather than referencing a type directly.
+ *
+ * Given the entity name `foo`, the printer renders:
+ *
+ * ```ts
+ * typeof foo;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param exprName The queried entity name.

package/lib/factory/types/createTypeQueryNode.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createTypeQueryNode.mjs","sources":["createTypeQueryNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTypeQueryNode = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link TypeQueryNode}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param exprName The queried entity name.\n * @returns The created {@link TypeQueryNode}.\n */\nconst createTypeQueryNode = (exprName) => (0, make_1.make)(\"TypeQueryNode\", { exprName });\nexports.createTypeQueryNode = createTypeQueryNode;\n//# sourceMappingURL=createTypeQueryNode.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,mBAAmB,GAAG,MAAM;AACpC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,mBAAmB,GAAG,CAAC,QAAQ,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,CAAC;AACzF,OAAO,CAAC,mBAAmB,GAAG,mBAAmB"}
+{"version":3,"file":"createTypeQueryNode.mjs","sources":["createTypeQueryNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTypeQueryNode = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link TypeQueryNode}: a `typeof x` type query.\n *\n * The `typeof ` keyword prints in front of the queried entity name, which may\n * be a qualified name such as `typeof ns.value`. This yields the type of a\n * value rather than referencing a type directly.\n *\n * Given the entity name `foo`, the printer renders:\n *\n * ```ts\n * typeof foo;\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param exprName The queried entity name.\n * @returns The created {@link TypeQueryNode}.\n */\nconst createTypeQueryNode = (exprName) => (0, make_1.make)(\"TypeQueryNode\", { exprName });\nexports.createTypeQueryNode = createTypeQueryNode;\n//# sourceMappingURL=createTypeQueryNode.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,mBAAmB,GAAG,MAAM;AACpC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,mBAAmB,GAAG,CAAC,QAAQ,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,CAAC;AACzF,OAAO,CAAC,mBAAmB,GAAG,mBAAmB"}

package/lib/factory/types/createTypeReferenceNode.d.ts

@@ -1,6 +1,18 @@
 import type { EntityName, TypeNode, TypeReferenceNode } from "../../ast";
 /**
- * Create a {@link TypeReferenceNode}.
+ * Create a {@link TypeReferenceNode}: a named type reference such as
+ * `Array<string>` or `ns.Foo`.
+ *
+ * The type name prints first and may be a qualified name, followed by the type
+ * arguments as `<...>` when present. With no type arguments only the bare name
+ * prints. A string name is normalized to an entity name.
+ *
+ * Given the name `Array` and a single `string` type argument, the printer
+ * renders:
+ *
+ * ```ts
+ * Array<string>;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param typeName The referenced type name.

package/lib/factory/types/createTypeReferenceNode.js

@@ -4,7 +4,19 @@ exports.createTypeReferenceNode = void 0;
 const asEntityName_1 = require("../internal/asEntityName");
 const make_1 = require("../internal/make");
 /**
- * Create a {@link TypeReferenceNode}.
+ * Create a {@link TypeReferenceNode}: a named type reference such as
+ * `Array<string>` or `ns.Foo`.
+ *
+ * The type name prints first and may be a qualified name, followed by the type
+ * arguments as `<...>` when present. With no type arguments only the bare name
+ * prints. A string name is normalized to an entity name.
+ *
+ * Given the name `Array` and a single `string` type argument, the printer
+ * renders:
+ *
+ * ```ts
+ * Array<string>;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param typeName The referenced type name.

package/lib/factory/types/createTypeReferenceNode.js.map

@@ -1 +1 @@
-{"version":3,"file":"createTypeReferenceNode.js","sourceRoot":"","sources":["../../../src/factory/types/createTypeReferenceNode.ts"],"names":[],"mappings":";;;AACA,2DAAwD;AACxD,2CAAwC;AAExC;;;;;;;GAOG;AACI,MAAM,uBAAuB,GAAG,CACrC,QAA6B,EAC7B,aAAmC,EAChB,EAAE,CACrB,IAAA,WAAI,EAAC,mBAAmB,EAAE;IACxB,QAAQ,EAAE,IAAA,2BAAY,EAAC,QAAQ,CAAC;IAChC,aAAa;CACd,CAAC,CAAC;AAPQ,QAAA,uBAAuB,GAAvB,uBAAuB,CAO/B"}
+{"version":3,"file":"createTypeReferenceNode.js","sourceRoot":"","sources":["../../../src/factory/types/createTypeReferenceNode.ts"],"names":[],"mappings":";;;AACA,2DAAwD;AACxD,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;;GAmBG;AACI,MAAM,uBAAuB,GAAG,CACrC,QAA6B,EAC7B,aAAmC,EAChB,EAAE,CACrB,IAAA,WAAI,EAAC,mBAAmB,EAAE;IACxB,QAAQ,EAAE,IAAA,2BAAY,EAAC,QAAQ,CAAC;IAChC,aAAa;CACd,CAAC,CAAC;AAPQ,QAAA,uBAAuB,GAAvB,uBAAuB,CAO/B"}

package/lib/factory/types/createTypeReferenceNode.mjs

@@ -3,7 +3,19 @@ exports.createTypeReferenceNode = void 0;
 const asEntityName_1 = require("../internal/asEntityName");
 const make_1 = require("../internal/make");
 /**
- * Create a {@link TypeReferenceNode}.
+ * Create a {@link TypeReferenceNode}: a named type reference such as
+ * `Array<string>` or `ns.Foo`.
+ *
+ * The type name prints first and may be a qualified name, followed by the type
+ * arguments as `<...>` when present. With no type arguments only the bare name
+ * prints. A string name is normalized to an entity name.
+ *
+ * Given the name `Array` and a single `string` type argument, the printer
+ * renders:
+ *
+ * ```ts
+ * Array<string>;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param typeName The referenced type name.

package/lib/factory/types/createTypeReferenceNode.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createTypeReferenceNode.mjs","sources":["createTypeReferenceNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTypeReferenceNode = void 0;\nconst asEntityName_1 = require(\"../internal/asEntityName\");\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link TypeReferenceNode}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param typeName The referenced type name.\n * @param typeArguments The generic type arguments, if any.\n * @returns The created {@link TypeReferenceNode}.\n */\nconst createTypeReferenceNode = (typeName, typeArguments) => (0, make_1.make)(\"TypeReferenceNode\", {\n    typeName: (0, asEntityName_1.asEntityName)(typeName),\n    typeArguments,\n});\nexports.createTypeReferenceNode = createTypeReferenceNode;\n//# sourceMappingURL=createTypeReferenceNode.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,uBAAuB,GAAG,MAAM;AACxC,MAAM,cAAc,GAAG,OAAO,CAAC,0BAA0B,CAAC;AAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,uBAAuB,GAAG,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE;AACnG,IAAI,QAAQ,EAAE,IAAI,cAAc,CAAC,YAAY,EAAE,QAAQ,CAAC;AACxD,IAAI,aAAa;AACjB,CAAC,CAAC;AACF,OAAO,CAAC,uBAAuB,GAAG,uBAAuB"}
+{"version":3,"file":"createTypeReferenceNode.mjs","sources":["createTypeReferenceNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTypeReferenceNode = void 0;\nconst asEntityName_1 = require(\"../internal/asEntityName\");\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link TypeReferenceNode}: a named type reference such as\n * `Array<string>` or `ns.Foo`.\n *\n * The type name prints first and may be a qualified name, followed by the type\n * arguments as `<...>` when present. With no type arguments only the bare name\n * prints. A string name is normalized to an entity name.\n *\n * Given the name `Array` and a single `string` type argument, the printer\n * renders:\n *\n * ```ts\n * Array<string>;\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param typeName The referenced type name.\n * @param typeArguments The generic type arguments, if any.\n * @returns The created {@link TypeReferenceNode}.\n */\nconst createTypeReferenceNode = (typeName, typeArguments) => (0, make_1.make)(\"TypeReferenceNode\", {\n    typeName: (0, asEntityName_1.asEntityName)(typeName),\n    typeArguments,\n});\nexports.createTypeReferenceNode = createTypeReferenceNode;\n//# sourceMappingURL=createTypeReferenceNode.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,uBAAuB,GAAG,MAAM;AACxC,MAAM,cAAc,GAAG,OAAO,CAAC,0BAA0B,CAAC;AAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,uBAAuB,GAAG,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE;AACnG,IAAI,QAAQ,EAAE,IAAI,cAAc,CAAC,YAAY,EAAE,QAAQ,CAAC;AACxD,IAAI,aAAa;AACjB,CAAC,CAAC;AACF,OAAO,CAAC,uBAAuB,GAAG,uBAAuB"}

package/lib/factory/types/createUnionTypeNode.d.ts

@@ -1,6 +1,17 @@
 import type { TypeNode, UnionTypeNode } from "../../ast";
 /**
- * Create a {@link UnionTypeNode}.
+ * Create a {@link UnionTypeNode}: an `A | B` type.
+ *
+ * The constituents are joined with `|`. The printer is width-aware: when the
+ * whole union fits on one line it stays inline as `A | B`, and when it has to
+ * break it indents and puts each constituent on its own line with a leading
+ * `|`, including a leading `|` before the first member.
+ *
+ * Given the constituents `string` and `number`, the printer renders:
+ *
+ * ```ts
+ * string | number;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param types The constituent types.

package/lib/factory/types/createUnionTypeNode.js

@@ -3,7 +3,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createUnionTypeNode = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link UnionTypeNode}.
+ * Create a {@link UnionTypeNode}: an `A | B` type.
+ *
+ * The constituents are joined with `|`. The printer is width-aware: when the
+ * whole union fits on one line it stays inline as `A | B`, and when it has to
+ * break it indents and puts each constituent on its own line with a leading
+ * `|`, including a leading `|` before the first member.
+ *
+ * Given the constituents `string` and `number`, the printer renders:
+ *
+ * ```ts
+ * string | number;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param types The constituent types.

package/lib/factory/types/createUnionTypeNode.js.map

@@ -1 +1 @@
-{"version":3,"file":"createUnionTypeNode.js","sourceRoot":"","sources":["../../../src/factory/types/createUnionTypeNode.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;GAMG;AACI,MAAM,mBAAmB,GAAG,CACjC,KAA0B,EACX,EAAE,CAAC,IAAA,WAAI,EAAC,eAAe,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAFxC,QAAA,mBAAmB,GAAnB,mBAAmB,CAEqB"}
+{"version":3,"file":"createUnionTypeNode.js","sourceRoot":"","sources":["../../../src/factory/types/createUnionTypeNode.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;;;GAiBG;AACI,MAAM,mBAAmB,GAAG,CACjC,KAA0B,EACX,EAAE,CAAC,IAAA,WAAI,EAAC,eAAe,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAFxC,QAAA,mBAAmB,GAAnB,mBAAmB,CAEqB"}

package/lib/factory/types/createUnionTypeNode.mjs

@@ -2,7 +2,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createUnionTypeNode = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link UnionTypeNode}.
+ * Create a {@link UnionTypeNode}: an `A | B` type.
+ *
+ * The constituents are joined with `|`. The printer is width-aware: when the
+ * whole union fits on one line it stays inline as `A | B`, and when it has to
+ * break it indents and puts each constituent on its own line with a leading
+ * `|`, including a leading `|` before the first member.
+ *
+ * Given the constituents `string` and `number`, the printer renders:
+ *
+ * ```ts
+ * string | number;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param types The constituent types.

package/lib/factory/types/createUnionTypeNode.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createUnionTypeNode.mjs","sources":["createUnionTypeNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createUnionTypeNode = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link UnionTypeNode}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param types The constituent types.\n * @returns The created {@link UnionTypeNode}.\n */\nconst createUnionTypeNode = (types) => (0, make_1.make)(\"UnionTypeNode\", { types });\nexports.createUnionTypeNode = createUnionTypeNode;\n//# sourceMappingURL=createUnionTypeNode.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,mBAAmB,GAAG,MAAM;AACpC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,mBAAmB,GAAG,CAAC,KAAK,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,CAAC;AACnF,OAAO,CAAC,mBAAmB,GAAG,mBAAmB"}
+{"version":3,"file":"createUnionTypeNode.mjs","sources":["createUnionTypeNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createUnionTypeNode = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link UnionTypeNode}: an `A | B` type.\n *\n * The constituents are joined with `|`. The printer is width-aware: when the\n * whole union fits on one line it stays inline as `A | B`, and when it has to\n * break it indents and puts each constituent on its own line with a leading\n * `|`, including a leading `|` before the first member.\n *\n * Given the constituents `string` and `number`, the printer renders:\n *\n * ```ts\n * string | number;\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param types The constituent types.\n * @returns The created {@link UnionTypeNode}.\n */\nconst createUnionTypeNode = (types) => (0, make_1.make)(\"UnionTypeNode\", { types });\nexports.createUnionTypeNode = createUnionTypeNode;\n//# sourceMappingURL=createUnionTypeNode.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,mBAAmB,GAAG,MAAM;AACpC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,mBAAmB,GAAG,CAAC,KAAK,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,CAAC;AACnF,OAAO,CAAC,mBAAmB,GAAG,mBAAmB"}

package/lib/index.d.ts

@@ -1,3 +1,4 @@
+import * as factory from "./factory/index";
 /**
  * Hand-written, dependency-free re-implementation of the legacy TypeScript AST
  * factory (`ts.factory`) and printer (`ts.Printer`).
@@ -9,6 +10,7 @@
  * - `factory` — the node factory namespace (also the default export).
  * - {@link TsPrinter} — renders factory nodes to TypeScript source text.
  * - {@link SyntaxKind} / {@link NodeFlags} — token & flag enums.
+ * - {@link addSyntheticLeadingComment} — attach `//` / `/* *\/` comments.
  * - Outline AST types (`Expression`, `Statement`, `TypeNode`, ...).
  *
  * No `typescript` module is imported anywhere; the logic is implemented
@@ -17,11 +19,12 @@
  * @author Jeongho Nam - https://github.com/samchon
  */
 export * as factory from "./factory/index";
-export { SyntaxKind, NodeFlags, tokenToString } from "./syntax";
+export { SyntaxKind, NodeFlags } from "./syntax";
 export { TsPrinter } from "./TsPrinter";
 export type { TsPrinterOptions } from "./TsPrinter";
+export { addSyntheticLeadingComment, addSyntheticTrailingComment, getSyntheticLeadingComments, getSyntheticTrailingComments, setSyntheticLeadingComments, setSyntheticTrailingComments, } from "./comments";
+export type { SynthesizedComment } from "./comments";
 export type * from "./ast";
-import * as factory from "./factory/index";
 /** Outline of the legacy `ts.NodeFactory`. */
 export type NodeFactory = typeof factory;
 export default factory;

package/lib/index.js

@@ -33,7 +33,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TsPrinter = exports.tokenToString = exports.NodeFlags = exports.SyntaxKind = exports.factory = void 0;
+exports.setSyntheticTrailingComments = exports.setSyntheticLeadingComments = exports.getSyntheticTrailingComments = exports.getSyntheticLeadingComments = exports.addSyntheticTrailingComment = exports.addSyntheticLeadingComment = exports.TsPrinter = exports.NodeFlags = exports.SyntaxKind = exports.factory = void 0;
+const factory = __importStar(require("./factory/index"));
 /**
  * Hand-written, dependency-free re-implementation of the legacy TypeScript AST
  * factory (`ts.factory`) and printer (`ts.Printer`).
@@ -45,6 +46,7 @@ exports.TsPrinter = exports.tokenToString = exports.NodeFlags = exports.SyntaxKi
  * - `factory` — the node factory namespace (also the default export).
  * - {@link TsPrinter} — renders factory nodes to TypeScript source text.
  * - {@link SyntaxKind} / {@link NodeFlags} — token & flag enums.
+ * - {@link addSyntheticLeadingComment} — attach `//` / `/* *\/` comments.
  * - Outline AST types (`Expression`, `Statement`, `TypeNode`, ...).
  *
  * No `typescript` module is imported anywhere; the logic is implemented
@@ -56,9 +58,14 @@ exports.factory = __importStar(require("./factory/index"));
 var syntax_1 = require("./syntax");
 Object.defineProperty(exports, "SyntaxKind", { enumerable: true, get: function () { return syntax_1.SyntaxKind; } });
 Object.defineProperty(exports, "NodeFlags", { enumerable: true, get: function () { return syntax_1.NodeFlags; } });
-Object.defineProperty(exports, "tokenToString", { enumerable: true, get: function () { return syntax_1.tokenToString; } });
 var TsPrinter_1 = require("./TsPrinter");
 Object.defineProperty(exports, "TsPrinter", { enumerable: true, get: function () { return TsPrinter_1.TsPrinter; } });
-const factory = __importStar(require("./factory/index"));
+var comments_1 = require("./comments");
+Object.defineProperty(exports, "addSyntheticLeadingComment", { enumerable: true, get: function () { return comments_1.addSyntheticLeadingComment; } });
+Object.defineProperty(exports, "addSyntheticTrailingComment", { enumerable: true, get: function () { return comments_1.addSyntheticTrailingComment; } });
+Object.defineProperty(exports, "getSyntheticLeadingComments", { enumerable: true, get: function () { return comments_1.getSyntheticLeadingComments; } });
+Object.defineProperty(exports, "getSyntheticTrailingComments", { enumerable: true, get: function () { return comments_1.getSyntheticTrailingComments; } });
+Object.defineProperty(exports, "setSyntheticLeadingComments", { enumerable: true, get: function () { return comments_1.setSyntheticLeadingComments; } });
+Object.defineProperty(exports, "setSyntheticTrailingComments", { enumerable: true, get: function () { return comments_1.setSyntheticTrailingComments; } });
 exports.default = factory;
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAY,OAAO,4CAAwB;AAC3C,mCAAgE;AAAvD,oGAAA,UAAU,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,uGAAA,aAAa,OAAA;AAC7C,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAIlB,MAAY,OAAO,4CAAwB;kBAK5B,OAAO"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,MAAY,OAAO,4CAAwB;AAE3C;;;;;;;;;;;;;;;;;;GAkBG;AACH,QAAY,OAAO,4CAAwB;AAC3C,mCAAiD;AAAxC,oGAAA,UAAU,OAAA;AAAE,mGAAA,SAAS,OAAA;AAC9B,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAElB,uCAOoB;AANlB,sHAAA,0BAA0B,OAAA;AAC1B,uHAAA,2BAA2B,OAAA;AAC3B,uHAAA,2BAA2B,OAAA;AAC3B,wHAAA,4BAA4B,OAAA;AAC5B,uHAAA,2BAA2B,OAAA;AAC3B,wHAAA,4BAA4B,OAAA;kBAQf,OAAO"}

package/lib/index.mjs

@@ -32,7 +32,8 @@ var __importStar = (undefined && undefined.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TsPrinter = exports.tokenToString = exports.NodeFlags = exports.SyntaxKind = exports.factory = void 0;
+exports.setSyntheticTrailingComments = exports.setSyntheticLeadingComments = exports.getSyntheticTrailingComments = exports.getSyntheticLeadingComments = exports.addSyntheticTrailingComment = exports.addSyntheticLeadingComment = exports.TsPrinter = exports.NodeFlags = exports.SyntaxKind = exports.factory = void 0;
+const factory = __importStar(require("./factory/index"));
 /**
  * Hand-written, dependency-free re-implementation of the legacy TypeScript AST
  * factory (`ts.factory`) and printer (`ts.Printer`).
@@ -44,6 +45,7 @@ exports.TsPrinter = exports.tokenToString = exports.NodeFlags = exports.SyntaxKi
  * - `factory` — the node factory namespace (also the default export).
  * - {@link TsPrinter} — renders factory nodes to TypeScript source text.
  * - {@link SyntaxKind} / {@link NodeFlags} — token & flag enums.
+ * - {@link addSyntheticLeadingComment} — attach `//` / `/* *\/` comments.
  * - Outline AST types (`Expression`, `Statement`, `TypeNode`, ...).
  *
  * No `typescript` module is imported anywhere; the logic is implemented
@@ -55,9 +57,14 @@ exports.factory = __importStar(require("./factory/index"));
 var syntax_1 = require("./syntax");
 Object.defineProperty(exports, "SyntaxKind", { enumerable: true, get: function () { return syntax_1.SyntaxKind; } });
 Object.defineProperty(exports, "NodeFlags", { enumerable: true, get: function () { return syntax_1.NodeFlags; } });
-Object.defineProperty(exports, "tokenToString", { enumerable: true, get: function () { return syntax_1.tokenToString; } });
 var TsPrinter_1 = require("./TsPrinter");
 Object.defineProperty(exports, "TsPrinter", { enumerable: true, get: function () { return TsPrinter_1.TsPrinter; } });
-const factory = __importStar(require("./factory/index"));
+var comments_1 = require("./comments");
+Object.defineProperty(exports, "addSyntheticLeadingComment", { enumerable: true, get: function () { return comments_1.addSyntheticLeadingComment; } });
+Object.defineProperty(exports, "addSyntheticTrailingComment", { enumerable: true, get: function () { return comments_1.addSyntheticTrailingComment; } });
+Object.defineProperty(exports, "getSyntheticLeadingComments", { enumerable: true, get: function () { return comments_1.getSyntheticLeadingComments; } });
+Object.defineProperty(exports, "getSyntheticTrailingComments", { enumerable: true, get: function () { return comments_1.getSyntheticTrailingComments; } });
+Object.defineProperty(exports, "setSyntheticLeadingComments", { enumerable: true, get: function () { return comments_1.setSyntheticLeadingComments; } });
+Object.defineProperty(exports, "setSyntheticTrailingComments", { enumerable: true, get: function () { return comments_1.setSyntheticTrailingComments; } });
 exports.default = factory;
 //# sourceMappingURL=index.mjs.map

package/lib/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["index.js"],"sourcesContent":["\"use strict\";\nvar __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {\n    if (k2 === undefined) k2 = k;\n    var desc = Object.getOwnPropertyDescriptor(m, k);\n    if (!desc || (\"get\" in desc ? !m.__esModule : desc.writable || desc.configurable)) {\n      desc = { enumerable: true, get: function() { return m[k]; } };\n    }\n    Object.defineProperty(o, k2, desc);\n}) : (function(o, m, k, k2) {\n    if (k2 === undefined) k2 = k;\n    o[k2] = m[k];\n}));\nvar __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {\n    Object.defineProperty(o, \"default\", { enumerable: true, value: v });\n}) : function(o, v) {\n    o[\"default\"] = v;\n});\nvar __importStar = (this && this.__importStar) || (function () {\n    var ownKeys = function(o) {\n        ownKeys = Object.getOwnPropertyNames || function (o) {\n            var ar = [];\n            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;\n            return ar;\n        };\n        return ownKeys(o);\n    };\n    return function (mod) {\n        if (mod && mod.__esModule) return mod;\n        var result = {};\n        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== \"default\") __createBinding(result, mod, k[i]);\n        __setModuleDefault(result, mod);\n        return result;\n    };\n})();\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.TsPrinter = exports.tokenToString = exports.NodeFlags = exports.SyntaxKind = exports.factory = void 0;\n/**\n * Hand-written, dependency-free re-implementation of the legacy TypeScript AST\n * factory (`ts.factory`) and printer (`ts.Printer`).\n *\n * ```typescript\n * import factory, { SyntaxKind, TsPrinter } from \"@ttsc/factory\";\n * ```\n *\n * - `factory` — the node factory namespace (also the default export).\n * - {@link TsPrinter} — renders factory nodes to TypeScript source text.\n * - {@link SyntaxKind} / {@link NodeFlags} — token & flag enums.\n * - Outline AST types (`Expression`, `Statement`, `TypeNode`, ...).\n *\n * No `typescript` module is imported anywhere; the logic is implemented\n * directly, so this keeps working in the TypeScript-Go (tsgo) era.\n *\n * @author Jeongho Nam - https://github.com/samchon\n */\nexports.factory = __importStar(require(\"./factory/index\"));\nvar syntax_1 = require(\"./syntax\");\nObject.defineProperty(exports, \"SyntaxKind\", { enumerable: true, get: function () { return syntax_1.SyntaxKind; } });\nObject.defineProperty(exports, \"NodeFlags\", { enumerable: true, get: function () { return syntax_1.NodeFlags; } });\nObject.defineProperty(exports, \"tokenToString\", { enumerable: true, get: function () { return syntax_1.tokenToString; } });\nvar TsPrinter_1 = require(\"./TsPrinter\");\nObject.defineProperty(exports, \"TsPrinter\", { enumerable: true, get: function () { return TsPrinter_1.TsPrinter; } });\nconst factory = __importStar(require(\"./factory/index\"));\nexports.default = factory;\n//# sourceMappingURL=index.js.map"],"names":["this"],"mappings":"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"}
+{"version":3,"file":"index.mjs","sources":["index.js"],"sourcesContent":["\"use strict\";\nvar __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {\n    if (k2 === undefined) k2 = k;\n    var desc = Object.getOwnPropertyDescriptor(m, k);\n    if (!desc || (\"get\" in desc ? !m.__esModule : desc.writable || desc.configurable)) {\n      desc = { enumerable: true, get: function() { return m[k]; } };\n    }\n    Object.defineProperty(o, k2, desc);\n}) : (function(o, m, k, k2) {\n    if (k2 === undefined) k2 = k;\n    o[k2] = m[k];\n}));\nvar __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {\n    Object.defineProperty(o, \"default\", { enumerable: true, value: v });\n}) : function(o, v) {\n    o[\"default\"] = v;\n});\nvar __importStar = (this && this.__importStar) || (function () {\n    var ownKeys = function(o) {\n        ownKeys = Object.getOwnPropertyNames || function (o) {\n            var ar = [];\n            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;\n            return ar;\n        };\n        return ownKeys(o);\n    };\n    return function (mod) {\n        if (mod && mod.__esModule) return mod;\n        var result = {};\n        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== \"default\") __createBinding(result, mod, k[i]);\n        __setModuleDefault(result, mod);\n        return result;\n    };\n})();\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.setSyntheticTrailingComments = exports.setSyntheticLeadingComments = exports.getSyntheticTrailingComments = exports.getSyntheticLeadingComments = exports.addSyntheticTrailingComment = exports.addSyntheticLeadingComment = exports.TsPrinter = exports.NodeFlags = exports.SyntaxKind = exports.factory = void 0;\nconst factory = __importStar(require(\"./factory/index\"));\n/**\n * Hand-written, dependency-free re-implementation of the legacy TypeScript AST\n * factory (`ts.factory`) and printer (`ts.Printer`).\n *\n * ```typescript\n * import factory, { SyntaxKind, TsPrinter } from \"@ttsc/factory\";\n * ```\n *\n * - `factory` — the node factory namespace (also the default export).\n * - {@link TsPrinter} — renders factory nodes to TypeScript source text.\n * - {@link SyntaxKind} / {@link NodeFlags} — token & flag enums.\n * - {@link addSyntheticLeadingComment} — attach `//` / `/* *\\/` comments.\n * - Outline AST types (`Expression`, `Statement`, `TypeNode`, ...).\n *\n * No `typescript` module is imported anywhere; the logic is implemented\n * directly, so this keeps working in the TypeScript-Go (tsgo) era.\n *\n * @author Jeongho Nam - https://github.com/samchon\n */\nexports.factory = __importStar(require(\"./factory/index\"));\nvar syntax_1 = require(\"./syntax\");\nObject.defineProperty(exports, \"SyntaxKind\", { enumerable: true, get: function () { return syntax_1.SyntaxKind; } });\nObject.defineProperty(exports, \"NodeFlags\", { enumerable: true, get: function () { return syntax_1.NodeFlags; } });\nvar TsPrinter_1 = require(\"./TsPrinter\");\nObject.defineProperty(exports, \"TsPrinter\", { enumerable: true, get: function () { return TsPrinter_1.TsPrinter; } });\nvar comments_1 = require(\"./comments\");\nObject.defineProperty(exports, \"addSyntheticLeadingComment\", { enumerable: true, get: function () { return comments_1.addSyntheticLeadingComment; } });\nObject.defineProperty(exports, \"addSyntheticTrailingComment\", { enumerable: true, get: function () { return comments_1.addSyntheticTrailingComment; } });\nObject.defineProperty(exports, \"getSyntheticLeadingComments\", { enumerable: true, get: function () { return comments_1.getSyntheticLeadingComments; } });\nObject.defineProperty(exports, \"getSyntheticTrailingComments\", { enumerable: true, get: function () { return comments_1.getSyntheticTrailingComments; } });\nObject.defineProperty(exports, \"setSyntheticLeadingComments\", { enumerable: true, get: function () { return comments_1.setSyntheticLeadingComments; } });\nObject.defineProperty(exports, \"setSyntheticTrailingComments\", { enumerable: true, get: function () { return comments_1.setSyntheticTrailingComments; } });\nexports.default = factory;\n//# sourceMappingURL=index.js.map"],"names":["this"],"mappings":"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"}

package/lib/syntax/NodeFlags.d.ts

@@ -1,12 +1,19 @@
 /**
- * Flags for {@link factory.createVariableDeclarationList}.
+ * Flags for {@link factory.createVariableDeclarationList} and
+ * {@link factory.createModuleDeclaration}.
  *
- * Outline of the relevant subset of the legacy `ts.NodeFlags`.
+ * An outline of the relevant subset of the legacy `ts.NodeFlags`. Each member's
+ * value is the keyword it implies (`Let = "let"`, `Const = "const"`), so the
+ * printer reads it directly. `Namespace` is accepted for API parity — the
+ * printer renders the `module` / `namespace` keyword from the module name kind,
+ * not from this flag. A string-valued enum (deliberately not `const enum`, so
+ * consumers compiled with `isolatedModules` can still reference its members).
  *
  * @author Jeongho Nam - https://github.com/samchon
  */
 export declare enum NodeFlags {
-    None = 0,
-    Let = 1,
-    Const = 2
+    None = "",
+    Let = "let",
+    Const = "const",
+    Namespace = "namespace"
 }

package/lib/syntax/NodeFlags.js

@@ -2,16 +2,23 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodeFlags = void 0;
 /**
- * Flags for {@link factory.createVariableDeclarationList}.
+ * Flags for {@link factory.createVariableDeclarationList} and
+ * {@link factory.createModuleDeclaration}.
  *
- * Outline of the relevant subset of the legacy `ts.NodeFlags`.
+ * An outline of the relevant subset of the legacy `ts.NodeFlags`. Each member's
+ * value is the keyword it implies (`Let = "let"`, `Const = "const"`), so the
+ * printer reads it directly. `Namespace` is accepted for API parity — the
+ * printer renders the `module` / `namespace` keyword from the module name kind,
+ * not from this flag. A string-valued enum (deliberately not `const enum`, so
+ * consumers compiled with `isolatedModules` can still reference its members).
  *
  * @author Jeongho Nam - https://github.com/samchon
  */
 var NodeFlags;
 (function (NodeFlags) {
-    NodeFlags[NodeFlags["None"] = 0] = "None";
-    NodeFlags[NodeFlags["Let"] = 1] = "Let";
-    NodeFlags[NodeFlags["Const"] = 2] = "Const";
+    NodeFlags["None"] = "";
+    NodeFlags["Let"] = "let";
+    NodeFlags["Const"] = "const";
+    NodeFlags["Namespace"] = "namespace";
 })(NodeFlags || (exports.NodeFlags = NodeFlags = {}));
 //# sourceMappingURL=NodeFlags.js.map

package/lib/syntax/NodeFlags.js.map

@@ -1 +1 @@
-{"version":3,"file":"NodeFlags.js","sourceRoot":"","sources":["../../src/syntax/NodeFlags.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,yCAAQ,CAAA;IACR,uCAAO,CAAA;IACP,2CAAS,CAAA;AACX,CAAC,EAJW,SAAS,aAAT,SAAS,GAAT,SAAS,QAIpB"}
+{"version":3,"file":"NodeFlags.js","sourceRoot":"","sources":["../../src/syntax/NodeFlags.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,sBAAS,CAAA;IACT,wBAAW,CAAA;IACX,4BAAe,CAAA;IACf,oCAAuB,CAAA;AACzB,CAAC,EALW,SAAS,aAAT,SAAS,GAAT,SAAS,QAKpB"}

package/lib/syntax/NodeFlags.mjs

@@ -1,16 +1,23 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodeFlags = void 0;
 /**
- * Flags for {@link factory.createVariableDeclarationList}.
+ * Flags for {@link factory.createVariableDeclarationList} and
+ * {@link factory.createModuleDeclaration}.
  *
- * Outline of the relevant subset of the legacy `ts.NodeFlags`.
+ * An outline of the relevant subset of the legacy `ts.NodeFlags`. Each member's
+ * value is the keyword it implies (`Let = "let"`, `Const = "const"`), so the
+ * printer reads it directly. `Namespace` is accepted for API parity — the
+ * printer renders the `module` / `namespace` keyword from the module name kind,
+ * not from this flag. A string-valued enum (deliberately not `const enum`, so
+ * consumers compiled with `isolatedModules` can still reference its members).
  *
  * @author Jeongho Nam - https://github.com/samchon
  */
 var NodeFlags;
 (function (NodeFlags) {
-    NodeFlags[NodeFlags["None"] = 0] = "None";
-    NodeFlags[NodeFlags["Let"] = 1] = "Let";
-    NodeFlags[NodeFlags["Const"] = 2] = "Const";
+    NodeFlags["None"] = "";
+    NodeFlags["Let"] = "let";
+    NodeFlags["Const"] = "const";
+    NodeFlags["Namespace"] = "namespace";
 })(NodeFlags || (exports.NodeFlags = NodeFlags = {}));
 //# sourceMappingURL=NodeFlags.mjs.map

package/lib/syntax/NodeFlags.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"NodeFlags.mjs","sources":["NodeFlags.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.NodeFlags = void 0;\n/**\n * Flags for {@link factory.createVariableDeclarationList}.\n *\n * Outline of the relevant subset of the legacy `ts.NodeFlags`.\n *\n * @author Jeongho Nam - https://github.com/samchon\n */\nvar NodeFlags;\n(function (NodeFlags) {\n    NodeFlags[NodeFlags[\"None\"] = 0] = \"None\";\n    NodeFlags[NodeFlags[\"Let\"] = 1] = \"Let\";\n    NodeFlags[NodeFlags[\"Const\"] = 2] = \"Const\";\n})(NodeFlags || (exports.NodeFlags = NodeFlags = {}));\n//# sourceMappingURL=NodeFlags.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,SAAS,GAAG,MAAM;AAC1B;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,SAAS;AACb,CAAC,UAAU,SAAS,EAAE;AACtB,IAAI,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM;AAC7C,IAAI,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK;AAC3C,IAAI,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO;AAC/C,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,EAAE,CAAC,CAAC"}
+{"version":3,"file":"NodeFlags.mjs","sources":["NodeFlags.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.NodeFlags = void 0;\n/**\n * Flags for {@link factory.createVariableDeclarationList} and\n * {@link factory.createModuleDeclaration}.\n *\n * An outline of the relevant subset of the legacy `ts.NodeFlags`. Each member's\n * value is the keyword it implies (`Let = \"let\"`, `Const = \"const\"`), so the\n * printer reads it directly. `Namespace` is accepted for API parity — the\n * printer renders the `module` / `namespace` keyword from the module name kind,\n * not from this flag. A string-valued enum (deliberately not `const enum`, so\n * consumers compiled with `isolatedModules` can still reference its members).\n *\n * @author Jeongho Nam - https://github.com/samchon\n */\nvar NodeFlags;\n(function (NodeFlags) {\n    NodeFlags[\"None\"] = \"\";\n    NodeFlags[\"Let\"] = \"let\";\n    NodeFlags[\"Const\"] = \"const\";\n    NodeFlags[\"Namespace\"] = \"namespace\";\n})(NodeFlags || (exports.NodeFlags = NodeFlags = {}));\n//# sourceMappingURL=NodeFlags.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,SAAS,GAAG,MAAM;AAC1B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,SAAS;AACb,CAAC,UAAU,SAAS,EAAE;AACtB,IAAI,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE;AAC1B,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,KAAK;AAC5B,IAAI,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO;AAChC,IAAI,SAAS,CAAC,WAAW,CAAC,GAAG,WAAW;AACxC,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,EAAE,CAAC,CAAC"}