@ttsc/factory 0.15.6 → 0.15.8

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

@@ -1,10 +1,23 @@
 import type { TemplateLiteralTypeSpan, TemplateMiddle, TemplateTail, TypeNode } from "../../ast";
 /**
- * Create a {@link TemplateLiteralTypeSpan}.
+ * Create a {@link TemplateLiteralTypeSpan}: one interpolation of a template
+ * literal type, an interpolated type plus the literal text that follows it.
+ *
+ * The type prints first, then the trailing literal. The literal is a
+ * {@link TemplateMiddle} when another span follows and a {@link TemplateTail}
+ * when it closes the template. A span only renders meaningfully inside a
+ * template literal type; on its own it is just a fragment.
+ *
+ * Given a `number` type and a `px` tail inside a ``width:${...}`` template, the
+ * printer renders:
+ *
+ * ```ts
+ * `width:${number}px`;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param type The type.
- * @param literal The literal.
- * @returns The created node.
+ * @param type The interpolated type.
+ * @param literal The trailing middle or tail literal.
+ * @returns The created {@link TemplateLiteralTypeSpan}.
  */
 export declare const createTemplateLiteralTypeSpan: (type: TypeNode, literal: TemplateMiddle | TemplateTail) => TemplateLiteralTypeSpan;

package/lib/factory/types/createTemplateLiteralTypeSpan.js

@@ -3,12 +3,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTemplateLiteralTypeSpan = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link TemplateLiteralTypeSpan}.
+ * Create a {@link TemplateLiteralTypeSpan}: one interpolation of a template
+ * literal type, an interpolated type plus the literal text that follows it.
+ *
+ * The type prints first, then the trailing literal. The literal is a
+ * {@link TemplateMiddle} when another span follows and a {@link TemplateTail}
+ * when it closes the template. A span only renders meaningfully inside a
+ * template literal type; on its own it is just a fragment.
+ *
+ * Given a `number` type and a `px` tail inside a ``width:${...}`` template, the
+ * printer renders:
+ *
+ * ```ts
+ * `width:${number}px`;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param type The type.
- * @param literal The literal.
- * @returns The created node.
+ * @param type The interpolated type.
+ * @param literal The trailing middle or tail literal.
+ * @returns The created {@link TemplateLiteralTypeSpan}.
  */
 const createTemplateLiteralTypeSpan = (type, literal) => (0, make_1.make)("TemplateLiteralTypeSpan", { type, literal });
 exports.createTemplateLiteralTypeSpan = createTemplateLiteralTypeSpan;

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

@@ -1 +1 @@
-{"version":3,"file":"createTemplateLiteralTypeSpan.js","sourceRoot":"","sources":["../../../src/factory/types/createTemplateLiteralTypeSpan.ts"],"names":[],"mappings":";;;AAMA,2CAAwC;AAExC;;;;;;;GAOG;AACI,MAAM,6BAA6B,GAAG,CAC3C,IAAc,EACd,OAAsC,EACb,EAAE,CAC3B,IAAA,WAAI,EAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAJxC,QAAA,6BAA6B,GAA7B,6BAA6B,CAIW"}
+{"version":3,"file":"createTemplateLiteralTypeSpan.js","sourceRoot":"","sources":["../../../src/factory/types/createTemplateLiteralTypeSpan.ts"],"names":[],"mappings":";;;AAMA,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,MAAM,6BAA6B,GAAG,CAC3C,IAAc,EACd,OAAsC,EACb,EAAE,CAC3B,IAAA,WAAI,EAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAJxC,QAAA,6BAA6B,GAA7B,6BAA6B,CAIW"}

package/lib/factory/types/createTemplateLiteralTypeSpan.mjs

@@ -2,12 +2,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTemplateLiteralTypeSpan = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link TemplateLiteralTypeSpan}.
+ * Create a {@link TemplateLiteralTypeSpan}: one interpolation of a template
+ * literal type, an interpolated type plus the literal text that follows it.
+ *
+ * The type prints first, then the trailing literal. The literal is a
+ * {@link TemplateMiddle} when another span follows and a {@link TemplateTail}
+ * when it closes the template. A span only renders meaningfully inside a
+ * template literal type; on its own it is just a fragment.
+ *
+ * Given a `number` type and a `px` tail inside a ``width:${...}`` template, the
+ * printer renders:
+ *
+ * ```ts
+ * `width:${number}px`;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param type The type.
- * @param literal The literal.
- * @returns The created node.
+ * @param type The interpolated type.
+ * @param literal The trailing middle or tail literal.
+ * @returns The created {@link TemplateLiteralTypeSpan}.
  */
 const createTemplateLiteralTypeSpan = (type, literal) => (0, make_1.make)("TemplateLiteralTypeSpan", { type, literal });
 exports.createTemplateLiteralTypeSpan = createTemplateLiteralTypeSpan;

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

@@ -1 +1 @@
-{"version":3,"file":"createTemplateLiteralTypeSpan.mjs","sources":["createTemplateLiteralTypeSpan.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTemplateLiteralTypeSpan = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link TemplateLiteralTypeSpan}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param type The type.\n * @param literal The literal.\n * @returns The created node.\n */\nconst createTemplateLiteralTypeSpan = (type, literal) => (0, make_1.make)(\"TemplateLiteralTypeSpan\", { type, literal });\nexports.createTemplateLiteralTypeSpan = createTemplateLiteralTypeSpan;\n//# sourceMappingURL=createTemplateLiteralTypeSpan.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,6BAA6B,GAAG,MAAM;AAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,6BAA6B,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,yBAAyB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACvH,OAAO,CAAC,6BAA6B,GAAG,6BAA6B"}
+{"version":3,"file":"createTemplateLiteralTypeSpan.mjs","sources":["createTemplateLiteralTypeSpan.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTemplateLiteralTypeSpan = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link TemplateLiteralTypeSpan}: one interpolation of a template\n * literal type, an interpolated type plus the literal text that follows it.\n *\n * The type prints first, then the trailing literal. The literal is a\n * {@link TemplateMiddle} when another span follows and a {@link TemplateTail}\n * when it closes the template. A span only renders meaningfully inside a\n * template literal type; on its own it is just a fragment.\n *\n * Given a `number` type and a `px` tail inside a ``width:${...}`` template, the\n * printer renders:\n *\n * ```ts\n * `width:${number}px`;\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param type The interpolated type.\n * @param literal The trailing middle or tail literal.\n * @returns The created {@link TemplateLiteralTypeSpan}.\n */\nconst createTemplateLiteralTypeSpan = (type, literal) => (0, make_1.make)(\"TemplateLiteralTypeSpan\", { type, literal });\nexports.createTemplateLiteralTypeSpan = createTemplateLiteralTypeSpan;\n//# sourceMappingURL=createTemplateLiteralTypeSpan.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,6BAA6B,GAAG,MAAM;AAC9C,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;AACA,MAAM,6BAA6B,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,yBAAyB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACvH,OAAO,CAAC,6BAA6B,GAAG,6BAA6B"}

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

@@ -1,8 +1,18 @@
 import type { ThisTypeNode } from "../../ast";
 /**
- * Create a {@link ThisTypeNode}.
+ * Create a {@link ThisTypeNode}: the `this` type.
+ *
+ * It takes no inputs and the printer always emits the single keyword `this`,
+ * the polymorphic this-type used in fluent method return positions and type
+ * predicates.
+ *
+ * The printer renders:
+ *
+ * ```ts
+ * this;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @returns The created node.
+ * @returns The created {@link ThisTypeNode}.
  */
 export declare const createThisTypeNode: () => ThisTypeNode;

package/lib/factory/types/createThisTypeNode.js

@@ -3,10 +3,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createThisTypeNode = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link ThisTypeNode}.
+ * Create a {@link ThisTypeNode}: the `this` type.
+ *
+ * It takes no inputs and the printer always emits the single keyword `this`,
+ * the polymorphic this-type used in fluent method return positions and type
+ * predicates.
+ *
+ * The printer renders:
+ *
+ * ```ts
+ * this;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @returns The created node.
+ * @returns The created {@link ThisTypeNode}.
  */
 const createThisTypeNode = () => (0, make_1.make)("ThisTypeNode", {});
 exports.createThisTypeNode = createThisTypeNode;

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

@@ -1 +1 @@
-{"version":3,"file":"createThisTypeNode.js","sourceRoot":"","sources":["../../../src/factory/types/createThisTypeNode.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;GAKG;AACI,MAAM,kBAAkB,GAAG,GAAiB,EAAE,CAAC,IAAA,WAAI,EAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AAAlE,QAAA,kBAAkB,GAAlB,kBAAkB,CAAgD"}
+{"version":3,"file":"createThisTypeNode.js","sourceRoot":"","sources":["../../../src/factory/types/createThisTypeNode.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;GAeG;AACI,MAAM,kBAAkB,GAAG,GAAiB,EAAE,CAAC,IAAA,WAAI,EAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AAAlE,QAAA,kBAAkB,GAAlB,kBAAkB,CAAgD"}

package/lib/factory/types/createThisTypeNode.mjs

@@ -2,10 +2,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createThisTypeNode = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link ThisTypeNode}.
+ * Create a {@link ThisTypeNode}: the `this` type.
+ *
+ * It takes no inputs and the printer always emits the single keyword `this`,
+ * the polymorphic this-type used in fluent method return positions and type
+ * predicates.
+ *
+ * The printer renders:
+ *
+ * ```ts
+ * this;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @returns The created node.
+ * @returns The created {@link ThisTypeNode}.
  */
 const createThisTypeNode = () => (0, make_1.make)("ThisTypeNode", {});
 exports.createThisTypeNode = createThisTypeNode;

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

@@ -1 +1 @@
-{"version":3,"file":"createThisTypeNode.mjs","sources":["createThisTypeNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createThisTypeNode = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link ThisTypeNode}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @returns The created node.\n */\nconst createThisTypeNode = () => (0, make_1.make)(\"ThisTypeNode\", {});\nexports.createThisTypeNode = createThisTypeNode;\n//# sourceMappingURL=createThisTypeNode.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,kBAAkB,GAAG,MAAM;AACnC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,kBAAkB,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,CAAC;AACrE,OAAO,CAAC,kBAAkB,GAAG,kBAAkB"}
+{"version":3,"file":"createThisTypeNode.mjs","sources":["createThisTypeNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createThisTypeNode = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link ThisTypeNode}: the `this` type.\n *\n * It takes no inputs and the printer always emits the single keyword `this`,\n * the polymorphic this-type used in fluent method return positions and type\n * predicates.\n *\n * The printer renders:\n *\n * ```ts\n * this;\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @returns The created {@link ThisTypeNode}.\n */\nconst createThisTypeNode = () => (0, make_1.make)(\"ThisTypeNode\", {});\nexports.createThisTypeNode = createThisTypeNode;\n//# sourceMappingURL=createThisTypeNode.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,kBAAkB,GAAG,MAAM;AACnC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,kBAAkB,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,CAAC;AACrE,OAAO,CAAC,kBAAkB,GAAG,kBAAkB"}

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

@@ -1,9 +1,20 @@
 import type { TupleTypeNode, TypeNode } from "../../ast";
 /**
- * Create a {@link TupleTypeNode}.
+ * Create a {@link TupleTypeNode}: a `[A, B]` tuple type.
+ *
+ * The elements print inside `[...]`, comma separated. The list is width-aware:
+ * inline it stays on one line with no trailing comma, and when it breaks each
+ * element goes on its own line with a trailing comma after the last. Elements
+ * may include named, optional, and rest members.
+ *
+ * Given the elements `string` and `number`, the printer renders:
+ *
+ * ```ts
+ * [string, number];
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param elements The elements.
+ * @param elements The tuple element types.
  * @returns The created {@link TupleTypeNode}.
  */
 export declare const createTupleTypeNode: (elements: readonly TypeNode[]) => TupleTypeNode;

package/lib/factory/types/createTupleTypeNode.js

@@ -3,10 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTupleTypeNode = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link TupleTypeNode}.
+ * Create a {@link TupleTypeNode}: a `[A, B]` tuple type.
+ *
+ * The elements print inside `[...]`, comma separated. The list is width-aware:
+ * inline it stays on one line with no trailing comma, and when it breaks each
+ * element goes on its own line with a trailing comma after the last. Elements
+ * may include named, optional, and rest members.
+ *
+ * Given the elements `string` and `number`, the printer renders:
+ *
+ * ```ts
+ * [string, number];
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param elements The elements.
+ * @param elements The tuple element types.
  * @returns The created {@link TupleTypeNode}.
  */
 const createTupleTypeNode = (elements) => (0, make_1.make)("TupleTypeNode", { elements });

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

@@ -1 +1 @@
-{"version":3,"file":"createTupleTypeNode.js","sourceRoot":"","sources":["../../../src/factory/types/createTupleTypeNode.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;GAMG;AACI,MAAM,mBAAmB,GAAG,CACjC,QAA6B,EACd,EAAE,CAAC,IAAA,WAAI,EAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAF3C,QAAA,mBAAmB,GAAnB,mBAAmB,CAEwB"}
+{"version":3,"file":"createTupleTypeNode.js","sourceRoot":"","sources":["../../../src/factory/types/createTupleTypeNode.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;;;GAiBG;AACI,MAAM,mBAAmB,GAAG,CACjC,QAA6B,EACd,EAAE,CAAC,IAAA,WAAI,EAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAF3C,QAAA,mBAAmB,GAAnB,mBAAmB,CAEwB"}

package/lib/factory/types/createTupleTypeNode.mjs

@@ -2,10 +2,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTupleTypeNode = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link TupleTypeNode}.
+ * Create a {@link TupleTypeNode}: a `[A, B]` tuple type.
+ *
+ * The elements print inside `[...]`, comma separated. The list is width-aware:
+ * inline it stays on one line with no trailing comma, and when it breaks each
+ * element goes on its own line with a trailing comma after the last. Elements
+ * may include named, optional, and rest members.
+ *
+ * Given the elements `string` and `number`, the printer renders:
+ *
+ * ```ts
+ * [string, number];
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param elements The elements.
+ * @param elements The tuple element types.
  * @returns The created {@link TupleTypeNode}.
  */
 const createTupleTypeNode = (elements) => (0, make_1.make)("TupleTypeNode", { elements });

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

@@ -1 +1 @@
-{"version":3,"file":"createTupleTypeNode.mjs","sources":["createTupleTypeNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTupleTypeNode = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link TupleTypeNode}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param elements The elements.\n * @returns The created {@link TupleTypeNode}.\n */\nconst createTupleTypeNode = (elements) => (0, make_1.make)(\"TupleTypeNode\", { elements });\nexports.createTupleTypeNode = createTupleTypeNode;\n//# sourceMappingURL=createTupleTypeNode.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":"createTupleTypeNode.mjs","sources":["createTupleTypeNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTupleTypeNode = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link TupleTypeNode}: a `[A, B]` tuple type.\n *\n * The elements print inside `[...]`, comma separated. The list is width-aware:\n * inline it stays on one line with no trailing comma, and when it breaks each\n * element goes on its own line with a trailing comma after the last. Elements\n * may include named, optional, and rest members.\n *\n * Given the elements `string` and `number`, the printer renders:\n *\n * ```ts\n * [string, number];\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param elements The tuple element types.\n * @returns The created {@link TupleTypeNode}.\n */\nconst createTupleTypeNode = (elements) => (0, make_1.make)(\"TupleTypeNode\", { elements });\nexports.createTupleTypeNode = createTupleTypeNode;\n//# sourceMappingURL=createTupleTypeNode.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,QAAQ,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,CAAC;AACzF,OAAO,CAAC,mBAAmB,GAAG,mBAAmB"}

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

@@ -1,9 +1,21 @@
 import type { TypeElement, TypeLiteralNode } from "../../ast";
 /**
- * Create a {@link TypeLiteralNode}.
+ * Create a {@link TypeLiteralNode}: an inline object type such as `{ name:
+ * string }`.
+ *
+ * The members print inside `{ ... }` and may be any type element: property and
+ * method signatures, index and call signatures, and so on. The member block is
+ * width-aware, staying inline when it fits and breaking onto separate lines
+ * when it does not. The member list defaults to empty, which renders as `{}`.
+ *
+ * Given a single `name: string` property, the printer renders:
+ *
+ * ```ts
+ * { name: string }
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param members The members.
+ * @param members The type members.
  * @returns The created {@link TypeLiteralNode}.
  */
 export declare const createTypeLiteralNode: (members?: readonly TypeElement[]) => TypeLiteralNode;

package/lib/factory/types/createTypeLiteralNode.js

@@ -3,10 +3,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTypeLiteralNode = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link TypeLiteralNode}.
+ * Create a {@link TypeLiteralNode}: an inline object type such as `{ name:
+ * string }`.
+ *
+ * The members print inside `{ ... }` and may be any type element: property and
+ * method signatures, index and call signatures, and so on. The member block is
+ * width-aware, staying inline when it fits and breaking onto separate lines
+ * when it does not. The member list defaults to empty, which renders as `{}`.
+ *
+ * Given a single `name: string` property, the printer renders:
+ *
+ * ```ts
+ * { name: string }
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param members The members.
+ * @param members The type members.
  * @returns The created {@link TypeLiteralNode}.
  */
 const createTypeLiteralNode = (members = []) => (0, make_1.make)("TypeLiteralNode", { members });

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

@@ -1 +1 @@
-{"version":3,"file":"createTypeLiteralNode.js","sourceRoot":"","sources":["../../../src/factory/types/createTypeLiteralNode.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;GAMG;AACI,MAAM,qBAAqB,GAAG,CACnC,OAAO,GAA2B,EAAE,EACnB,EAAE,CAAC,IAAA,WAAI,EAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAF9C,QAAA,qBAAqB,GAArB,qBAAqB,CAEyB"}
+{"version":3,"file":"createTypeLiteralNode.js","sourceRoot":"","sources":["../../../src/factory/types/createTypeLiteralNode.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;GAkBG;AACI,MAAM,qBAAqB,GAAG,CACnC,OAAO,GAA2B,EAAE,EACnB,EAAE,CAAC,IAAA,WAAI,EAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAF9C,QAAA,qBAAqB,GAArB,qBAAqB,CAEyB"}

package/lib/factory/types/createTypeLiteralNode.mjs

@@ -2,10 +2,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTypeLiteralNode = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link TypeLiteralNode}.
+ * Create a {@link TypeLiteralNode}: an inline object type such as `{ name:
+ * string }`.
+ *
+ * The members print inside `{ ... }` and may be any type element: property and
+ * method signatures, index and call signatures, and so on. The member block is
+ * width-aware, staying inline when it fits and breaking onto separate lines
+ * when it does not. The member list defaults to empty, which renders as `{}`.
+ *
+ * Given a single `name: string` property, the printer renders:
+ *
+ * ```ts
+ * { name: string }
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param members The members.
+ * @param members The type members.
  * @returns The created {@link TypeLiteralNode}.
  */
 const createTypeLiteralNode = (members = []) => (0, make_1.make)("TypeLiteralNode", { members });

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

@@ -1 +1 @@
-{"version":3,"file":"createTypeLiteralNode.mjs","sources":["createTypeLiteralNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTypeLiteralNode = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link TypeLiteralNode}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param members The members.\n * @returns The created {@link TypeLiteralNode}.\n */\nconst createTypeLiteralNode = (members = []) => (0, make_1.make)(\"TypeLiteralNode\", { members });\nexports.createTypeLiteralNode = createTypeLiteralNode;\n//# sourceMappingURL=createTypeLiteralNode.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,qBAAqB,GAAG,MAAM;AACtC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,qBAAqB,GAAG,CAAC,OAAO,GAAG,EAAE,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC;AAChG,OAAO,CAAC,qBAAqB,GAAG,qBAAqB"}
+{"version":3,"file":"createTypeLiteralNode.mjs","sources":["createTypeLiteralNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTypeLiteralNode = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link TypeLiteralNode}: an inline object type such as `{ name:\n * string }`.\n *\n * The members print inside `{ ... }` and may be any type element: property and\n * method signatures, index and call signatures, and so on. The member block is\n * width-aware, staying inline when it fits and breaking onto separate lines\n * when it does not. The member list defaults to empty, which renders as `{}`.\n *\n * Given a single `name: string` property, the printer renders:\n *\n * ```ts\n * { name: string }\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param members The type members.\n * @returns The created {@link TypeLiteralNode}.\n */\nconst createTypeLiteralNode = (members = []) => (0, make_1.make)(\"TypeLiteralNode\", { members });\nexports.createTypeLiteralNode = createTypeLiteralNode;\n//# sourceMappingURL=createTypeLiteralNode.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,qBAAqB,GAAG,MAAM;AACtC,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,MAAM,qBAAqB,GAAG,CAAC,OAAO,GAAG,EAAE,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC;AAChG,OAAO,CAAC,qBAAqB,GAAG,qBAAqB"}

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

@@ -1,11 +1,23 @@
 import type { TypeNode, TypeOperatorNode } from "../../ast";
 import { SyntaxKind } from "../../syntax";
 /**
- * Create a {@link TypeOperatorNode}.
+ * Create a {@link TypeOperatorNode}: a prefix type operator such as `keyof T`,
+ * `typeof x`, `readonly T[]`, or `unique symbol`.
+ *
+ * The operator keyword prints first, then a space, then the operand type. In
+ * postfix and array positions the surrounding printer wraps the operator type
+ * in parentheses so the operator does not bind to the postfix instead of the
+ * operand.
+ *
+ * Given the `KeyOfKeyword` operator and a `T` operand, the printer renders:
+ *
+ * ```ts
+ * keyof T
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param operator The operator token.
- * @param type The type.
+ * @param type The operand type.
  * @returns The created {@link TypeOperatorNode}.
  */
 export declare const createTypeOperatorNode: (operator: SyntaxKind, type: TypeNode) => TypeOperatorNode;

package/lib/factory/types/createTypeOperatorNode.js

@@ -3,11 +3,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTypeOperatorNode = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link TypeOperatorNode}.
+ * Create a {@link TypeOperatorNode}: a prefix type operator such as `keyof T`,
+ * `typeof x`, `readonly T[]`, or `unique symbol`.
+ *
+ * The operator keyword prints first, then a space, then the operand type. In
+ * postfix and array positions the surrounding printer wraps the operator type
+ * in parentheses so the operator does not bind to the postfix instead of the
+ * operand.
+ *
+ * Given the `KeyOfKeyword` operator and a `T` operand, the printer renders:
+ *
+ * ```ts
+ * keyof T
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param operator The operator token.
- * @param type The type.
+ * @param type The operand type.
  * @returns The created {@link TypeOperatorNode}.
  */
 const createTypeOperatorNode = (operator, type) => (0, make_1.make)("TypeOperatorNode", { operator, type });

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

@@ -1 +1 @@
-{"version":3,"file":"createTypeOperatorNode.js","sourceRoot":"","sources":["../../../src/factory/types/createTypeOperatorNode.ts"],"names":[],"mappings":";;;AAEA,2CAAwC;AAExC;;;;;;;GAOG;AACI,MAAM,sBAAsB,GAAG,CACpC,QAAoB,EACpB,IAAc,EACI,EAAE,CAAC,IAAA,WAAI,EAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAHvD,QAAA,sBAAsB,GAAtB,sBAAsB,CAGiC"}
+{"version":3,"file":"createTypeOperatorNode.js","sourceRoot":"","sources":["../../../src/factory/types/createTypeOperatorNode.ts"],"names":[],"mappings":";;;AAEA,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;;GAmBG;AACI,MAAM,sBAAsB,GAAG,CACpC,QAAoB,EACpB,IAAc,EACI,EAAE,CAAC,IAAA,WAAI,EAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAHvD,QAAA,sBAAsB,GAAtB,sBAAsB,CAGiC"}

package/lib/factory/types/createTypeOperatorNode.mjs

@@ -2,11 +2,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTypeOperatorNode = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link TypeOperatorNode}.
+ * Create a {@link TypeOperatorNode}: a prefix type operator such as `keyof T`,
+ * `typeof x`, `readonly T[]`, or `unique symbol`.
+ *
+ * The operator keyword prints first, then a space, then the operand type. In
+ * postfix and array positions the surrounding printer wraps the operator type
+ * in parentheses so the operator does not bind to the postfix instead of the
+ * operand.
+ *
+ * Given the `KeyOfKeyword` operator and a `T` operand, the printer renders:
+ *
+ * ```ts
+ * keyof T
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param operator The operator token.
- * @param type The type.
+ * @param type The operand type.
  * @returns The created {@link TypeOperatorNode}.
  */
 const createTypeOperatorNode = (operator, type) => (0, make_1.make)("TypeOperatorNode", { operator, type });

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

@@ -1 +1 @@
-{"version":3,"file":"createTypeOperatorNode.mjs","sources":["createTypeOperatorNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTypeOperatorNode = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link TypeOperatorNode}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param operator The operator token.\n * @param type The type.\n * @returns The created {@link TypeOperatorNode}.\n */\nconst createTypeOperatorNode = (operator, type) => (0, make_1.make)(\"TypeOperatorNode\", { operator, type });\nexports.createTypeOperatorNode = createTypeOperatorNode;\n//# sourceMappingURL=createTypeOperatorNode.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,sBAAsB,GAAG,MAAM;AACvC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,IAAI,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC3G,OAAO,CAAC,sBAAsB,GAAG,sBAAsB"}
+{"version":3,"file":"createTypeOperatorNode.mjs","sources":["createTypeOperatorNode.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTypeOperatorNode = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link TypeOperatorNode}: a prefix type operator such as `keyof T`,\n * `typeof x`, `readonly T[]`, or `unique symbol`.\n *\n * The operator keyword prints first, then a space, then the operand type. In\n * postfix and array positions the surrounding printer wraps the operator type\n * in parentheses so the operator does not bind to the postfix instead of the\n * operand.\n *\n * Given the `KeyOfKeyword` operator and a `T` operand, the printer renders:\n *\n * ```ts\n * keyof T\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param operator The operator token.\n * @param type The operand type.\n * @returns The created {@link TypeOperatorNode}.\n */\nconst createTypeOperatorNode = (operator, type) => (0, make_1.make)(\"TypeOperatorNode\", { operator, type });\nexports.createTypeOperatorNode = createTypeOperatorNode;\n//# sourceMappingURL=createTypeOperatorNode.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,sBAAsB,GAAG,MAAM;AACvC,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,sBAAsB,GAAG,CAAC,QAAQ,EAAE,IAAI,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC3G,OAAO,CAAC,sBAAsB,GAAG,sBAAsB"}

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

@@ -1,10 +1,22 @@
 import type { Identifier, ModifierLike, TypeNode, TypeParameterDeclaration } from "../../ast";
 /**
- * Create a {@link TypeParameterDeclaration}.
+ * Create a {@link TypeParameterDeclaration}: a generic parameter such as `T
+ * extends string = number`.
+ *
+ * Any modifiers print first (for example `const`, `in`, `out`), then the name.
+ * A constraint adds ` extends Type` and a default adds ` = Type`, each only
+ * when present. A string name is normalized to an identifier.
+ *
+ * Given the name `T`, a `string` constraint, and a `number` default, the
+ * printer renders:
+ *
+ * ```ts
+ * T extends string = number
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param modifiers The leading modifiers and decorators, if any.
- * @param name The name.
+ * @param name The parameter name.
  * @param constraint The `extends` constraint, if any.
  * @param defaultType The default type, if any.
  * @returns The created {@link TypeParameterDeclaration}.

package/lib/factory/types/createTypeParameterDeclaration.js

@@ -4,11 +4,23 @@ exports.createTypeParameterDeclaration = void 0;
 const asName_1 = require("../internal/asName");
 const make_1 = require("../internal/make");
 /**
- * Create a {@link TypeParameterDeclaration}.
+ * Create a {@link TypeParameterDeclaration}: a generic parameter such as `T
+ * extends string = number`.
+ *
+ * Any modifiers print first (for example `const`, `in`, `out`), then the name.
+ * A constraint adds ` extends Type` and a default adds ` = Type`, each only
+ * when present. A string name is normalized to an identifier.
+ *
+ * Given the name `T`, a `string` constraint, and a `number` default, the
+ * printer renders:
+ *
+ * ```ts
+ * T extends string = number
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param modifiers The leading modifiers and decorators, if any.
- * @param name The name.
+ * @param name The parameter name.
  * @param constraint The `extends` constraint, if any.
  * @param defaultType The default type, if any.
  * @returns The created {@link TypeParameterDeclaration}.

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

@@ -1 +1 @@
-{"version":3,"file":"createTypeParameterDeclaration.js","sourceRoot":"","sources":["../../../src/factory/types/createTypeParameterDeclaration.ts"],"names":[],"mappings":";;;AAMA,+CAA4C;AAC5C,2CAAwC;AAExC;;;;;;;;;GASG;AACI,MAAM,8BAA8B,GAAG,CAC5C,SAA8C,EAC9C,IAAyB,EACzB,UAAqB,EACrB,WAAsB,EACI,EAAE,CAC5B,IAAA,WAAI,EAAC,0BAA0B,EAAE;IAC/B,SAAS;IACT,IAAI,EAAE,IAAA,eAAM,EAAC,IAAI,CAAC;IAClB,UAAU;IACV,OAAO,EAAE,WAAW;CACrB,CAAC,CAAC;AAXQ,QAAA,8BAA8B,GAA9B,8BAA8B,CAWtC"}
+{"version":3,"file":"createTypeParameterDeclaration.js","sourceRoot":"","sources":["../../../src/factory/types/createTypeParameterDeclaration.ts"],"names":[],"mappings":";;;AAMA,+CAA4C;AAC5C,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,MAAM,8BAA8B,GAAG,CAC5C,SAA8C,EAC9C,IAAyB,EACzB,UAAqB,EACrB,WAAsB,EACI,EAAE,CAC5B,IAAA,WAAI,EAAC,0BAA0B,EAAE;IAC/B,SAAS;IACT,IAAI,EAAE,IAAA,eAAM,EAAC,IAAI,CAAC;IAClB,UAAU;IACV,OAAO,EAAE,WAAW;CACrB,CAAC,CAAC;AAXQ,QAAA,8BAA8B,GAA9B,8BAA8B,CAWtC"}

package/lib/factory/types/createTypeParameterDeclaration.mjs

@@ -3,11 +3,23 @@ exports.createTypeParameterDeclaration = void 0;
 const asName_1 = require("../internal/asName");
 const make_1 = require("../internal/make");
 /**
- * Create a {@link TypeParameterDeclaration}.
+ * Create a {@link TypeParameterDeclaration}: a generic parameter such as `T
+ * extends string = number`.
+ *
+ * Any modifiers print first (for example `const`, `in`, `out`), then the name.
+ * A constraint adds ` extends Type` and a default adds ` = Type`, each only
+ * when present. A string name is normalized to an identifier.
+ *
+ * Given the name `T`, a `string` constraint, and a `number` default, the
+ * printer renders:
+ *
+ * ```ts
+ * T extends string = number
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param modifiers The leading modifiers and decorators, if any.
- * @param name The name.
+ * @param name The parameter name.
  * @param constraint The `extends` constraint, if any.
  * @param defaultType The default type, if any.
  * @returns The created {@link TypeParameterDeclaration}.

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

@@ -1 +1 @@
-{"version":3,"file":"createTypeParameterDeclaration.mjs","sources":["createTypeParameterDeclaration.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTypeParameterDeclaration = void 0;\nconst asName_1 = require(\"../internal/asName\");\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link TypeParameterDeclaration}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param modifiers The leading modifiers and decorators, if any.\n * @param name The name.\n * @param constraint The `extends` constraint, if any.\n * @param defaultType The default type, if any.\n * @returns The created {@link TypeParameterDeclaration}.\n */\nconst createTypeParameterDeclaration = (modifiers, name, constraint, defaultType) => (0, make_1.make)(\"TypeParameterDeclaration\", {\n    modifiers,\n    name: (0, asName_1.asName)(name),\n    constraint,\n    default: defaultType,\n});\nexports.createTypeParameterDeclaration = createTypeParameterDeclaration;\n//# sourceMappingURL=createTypeParameterDeclaration.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,8BAA8B,GAAG,MAAM;AAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC;AAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,8BAA8B,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,0BAA0B,EAAE;AAClI,IAAI,SAAS;AACb,IAAI,IAAI,EAAE,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;AACpC,IAAI,UAAU;AACd,IAAI,OAAO,EAAE,WAAW;AACxB,CAAC,CAAC;AACF,OAAO,CAAC,8BAA8B,GAAG,8BAA8B"}
+{"version":3,"file":"createTypeParameterDeclaration.mjs","sources":["createTypeParameterDeclaration.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createTypeParameterDeclaration = void 0;\nconst asName_1 = require(\"../internal/asName\");\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link TypeParameterDeclaration}: a generic parameter such as `T\n * extends string = number`.\n *\n * Any modifiers print first (for example `const`, `in`, `out`), then the name.\n * A constraint adds ` extends Type` and a default adds ` = Type`, each only\n * when present. A string name is normalized to an identifier.\n *\n * Given the name `T`, a `string` constraint, and a `number` default, the\n * printer renders:\n *\n * ```ts\n * T extends string = number\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param modifiers The leading modifiers and decorators, if any.\n * @param name The parameter name.\n * @param constraint The `extends` constraint, if any.\n * @param defaultType The default type, if any.\n * @returns The created {@link TypeParameterDeclaration}.\n */\nconst createTypeParameterDeclaration = (modifiers, name, constraint, defaultType) => (0, make_1.make)(\"TypeParameterDeclaration\", {\n    modifiers,\n    name: (0, asName_1.asName)(name),\n    constraint,\n    default: defaultType,\n});\nexports.createTypeParameterDeclaration = createTypeParameterDeclaration;\n//# sourceMappingURL=createTypeParameterDeclaration.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,8BAA8B,GAAG,MAAM;AAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC;AAC9C,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;AACA;AACA,MAAM,8BAA8B,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,0BAA0B,EAAE;AAClI,IAAI,SAAS;AACb,IAAI,IAAI,EAAE,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;AACpC,IAAI,UAAU;AACd,IAAI,OAAO,EAAE,WAAW;AACxB,CAAC,CAAC;AACF,OAAO,CAAC,8BAA8B,GAAG,8BAA8B"}

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

@@ -1,11 +1,24 @@
 import type { Identifier, ThisTypeNode, Token, TypeNode, TypePredicateNode } from "../../ast";
 /**
- * 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}.
  */
 export declare const createTypePredicateNode: (assertsModifier: Token | undefined, parameterName: string | Identifier | ThisTypeNode, type: TypeNode | undefined) => TypePredicateNode;

package/lib/factory/types/createTypePredicateNode.js

@@ -4,13 +4,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.js.map

@@ -1 +1 @@
-{"version":3,"file":"createTypePredicateNode.js","sourceRoot":"","sources":["../../../src/factory/types/createTypePredicateNode.ts"],"names":[],"mappings":";;;AAOA,2CAAwC;AACxC,gEAA6D;AAE7D;;;;;;;;GAQG;AACI,MAAM,uBAAuB,GAAG,CACrC,eAAkC,EAClC,aAAiD,EACjD,IAA0B,EACP,EAAE,CACrB,IAAA,WAAI,EAAC,mBAAmB,EAAE;IACxB,eAAe;IACf,aAAa,EACX,OAAO,aAAa,KAAK,QAAQ;QAC/B,CAAC,CAAC,IAAA,mCAAgB,EAAC,aAAa,CAAC;QACjC,CAAC,CAAC,aAAa;IACnB,IAAI;CACL,CAAC,CAAC;AAZQ,QAAA,uBAAuB,GAAvB,uBAAuB,CAY/B"}
+{"version":3,"file":"createTypePredicateNode.js","sourceRoot":"","sources":["../../../src/factory/types/createTypePredicateNode.ts"],"names":[],"mappings":";;;AAOA,2CAAwC;AACxC,gEAA6D;AAE7D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,MAAM,uBAAuB,GAAG,CACrC,eAAkC,EAClC,aAAiD,EACjD,IAA0B,EACP,EAAE,CACrB,IAAA,WAAI,EAAC,mBAAmB,EAAE;IACxB,eAAe;IACf,aAAa,EACX,OAAO,aAAa,KAAK,QAAQ;QAC/B,CAAC,CAAC,IAAA,mCAAgB,EAAC,aAAa,CAAC;QACjC,CAAC,CAAC,aAAa;IACnB,IAAI;CACL,CAAC,CAAC;AAZQ,QAAA,uBAAuB,GAAvB,uBAAuB,CAY/B"}