@ttsc/factory 0.15.6 → 0.15.8

package/lib/factory/expressions/createCallChain.d.ts

@@ -1,12 +1,26 @@
 import type { CallChain, Expression, Token, TypeNode } from "../../ast";
 /**
- * Create a {@link CallChain}.
+ * Create a {@link CallChain}: a call that participates in an optional chain.
+ *
+ * The `questionDotToken` is the `?.` token. When it sits directly before the
+ * argument list the printer emits an optional call `fn?.(args)`; when the
+ * callee is a property-access chain the `?.` appears at that link and the call
+ * itself uses plain parentheses. The optional `typeArguments` are printed in
+ * `<...>` before the arguments, and a missing `argumentsArray` is treated as an
+ * empty list.
+ *
+ * Given a property-access chain `obj?.fn` and one argument `a`, the printer
+ * emits:
+ *
+ * ```ts
+ * obj?.fn(a);
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
- * @param questionDotToken The questionDotToken.
- * @param typeArguments The typeArguments.
- * @param argumentsArray The argumentsArray.
- * @returns The created node.
+ * @param expression The callee expression.
+ * @param questionDotToken The `?.` token, if the call link is optional.
+ * @param typeArguments The generic type arguments, if any.
+ * @param argumentsArray The call arguments.
+ * @returns The created {@link CallChain}.
  */
 export declare const createCallChain: (expression: Expression, questionDotToken: Token | undefined, typeArguments: readonly TypeNode[] | undefined, argumentsArray: readonly Expression[] | undefined) => CallChain;

package/lib/factory/expressions/createCallChain.js

@@ -3,14 +3,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCallChain = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link CallChain}.
+ * Create a {@link CallChain}: a call that participates in an optional chain.
+ *
+ * The `questionDotToken` is the `?.` token. When it sits directly before the
+ * argument list the printer emits an optional call `fn?.(args)`; when the
+ * callee is a property-access chain the `?.` appears at that link and the call
+ * itself uses plain parentheses. The optional `typeArguments` are printed in
+ * `<...>` before the arguments, and a missing `argumentsArray` is treated as an
+ * empty list.
+ *
+ * Given a property-access chain `obj?.fn` and one argument `a`, the printer
+ * emits:
+ *
+ * ```ts
+ * obj?.fn(a);
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
- * @param questionDotToken The questionDotToken.
- * @param typeArguments The typeArguments.
- * @param argumentsArray The argumentsArray.
- * @returns The created node.
+ * @param expression The callee expression.
+ * @param questionDotToken The `?.` token, if the call link is optional.
+ * @param typeArguments The generic type arguments, if any.
+ * @param argumentsArray The call arguments.
+ * @returns The created {@link CallChain}.
  */
 const createCallChain = (expression, questionDotToken, typeArguments, argumentsArray) => (0, make_1.make)("CallChain", {
     expression,

package/lib/factory/expressions/createCallChain.js.map

@@ -1 +1 @@
-{"version":3,"file":"createCallChain.js","sourceRoot":"","sources":["../../../src/factory/expressions/createCallChain.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;GASG;AACI,MAAM,eAAe,GAAG,CAC7B,UAAsB,EACtB,gBAAmC,EACnC,aAA8C,EAC9C,cAAiD,EACtC,EAAE,CACb,IAAA,WAAI,EAAC,WAAW,EAAE;IAChB,UAAU;IACV,gBAAgB;IAChB,aAAa;IACb,SAAS,EAAE,cAAc,IAAI,EAAE;CAChC,CAAC,CAAC;AAXQ,QAAA,eAAe,GAAf,eAAe,CAWvB"}
+{"version":3,"file":"createCallChain.js","sourceRoot":"","sources":["../../../src/factory/expressions/createCallChain.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,MAAM,eAAe,GAAG,CAC7B,UAAsB,EACtB,gBAAmC,EACnC,aAA8C,EAC9C,cAAiD,EACtC,EAAE,CACb,IAAA,WAAI,EAAC,WAAW,EAAE;IAChB,UAAU;IACV,gBAAgB;IAChB,aAAa;IACb,SAAS,EAAE,cAAc,IAAI,EAAE;CAChC,CAAC,CAAC;AAXQ,QAAA,eAAe,GAAf,eAAe,CAWvB"}

package/lib/factory/expressions/createCallChain.mjs

@@ -2,14 +2,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCallChain = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link CallChain}.
+ * Create a {@link CallChain}: a call that participates in an optional chain.
+ *
+ * The `questionDotToken` is the `?.` token. When it sits directly before the
+ * argument list the printer emits an optional call `fn?.(args)`; when the
+ * callee is a property-access chain the `?.` appears at that link and the call
+ * itself uses plain parentheses. The optional `typeArguments` are printed in
+ * `<...>` before the arguments, and a missing `argumentsArray` is treated as an
+ * empty list.
+ *
+ * Given a property-access chain `obj?.fn` and one argument `a`, the printer
+ * emits:
+ *
+ * ```ts
+ * obj?.fn(a);
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
- * @param questionDotToken The questionDotToken.
- * @param typeArguments The typeArguments.
- * @param argumentsArray The argumentsArray.
- * @returns The created node.
+ * @param expression The callee expression.
+ * @param questionDotToken The `?.` token, if the call link is optional.
+ * @param typeArguments The generic type arguments, if any.
+ * @param argumentsArray The call arguments.
+ * @returns The created {@link CallChain}.
  */
 const createCallChain = (expression, questionDotToken, typeArguments, argumentsArray) => (0, make_1.make)("CallChain", {
     expression,

package/lib/factory/expressions/createCallChain.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createCallChain.mjs","sources":["createCallChain.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createCallChain = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link CallChain}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param expression The expression.\n * @param questionDotToken The questionDotToken.\n * @param typeArguments The typeArguments.\n * @param argumentsArray The argumentsArray.\n * @returns The created node.\n */\nconst createCallChain = (expression, questionDotToken, typeArguments, argumentsArray) => (0, make_1.make)(\"CallChain\", {\n    expression,\n    questionDotToken,\n    typeArguments,\n    arguments: argumentsArray ?? [],\n});\nexports.createCallChain = createCallChain;\n//# sourceMappingURL=createCallChain.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,eAAe,GAAG,MAAM;AAChC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE;AACvH,IAAI,UAAU;AACd,IAAI,gBAAgB;AACpB,IAAI,aAAa;AACjB,IAAI,SAAS,EAAE,cAAc,IAAI,EAAE;AACnC,CAAC,CAAC;AACF,OAAO,CAAC,eAAe,GAAG,eAAe"}
+{"version":3,"file":"createCallChain.mjs","sources":["createCallChain.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createCallChain = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link CallChain}: a call that participates in an optional chain.\n *\n * The `questionDotToken` is the `?.` token. When it sits directly before the\n * argument list the printer emits an optional call `fn?.(args)`; when the\n * callee is a property-access chain the `?.` appears at that link and the call\n * itself uses plain parentheses. The optional `typeArguments` are printed in\n * `<...>` before the arguments, and a missing `argumentsArray` is treated as an\n * empty list.\n *\n * Given a property-access chain `obj?.fn` and one argument `a`, the printer\n * emits:\n *\n * ```ts\n * obj?.fn(a);\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param expression The callee expression.\n * @param questionDotToken The `?.` token, if the call link is optional.\n * @param typeArguments The generic type arguments, if any.\n * @param argumentsArray The call arguments.\n * @returns The created {@link CallChain}.\n */\nconst createCallChain = (expression, questionDotToken, typeArguments, argumentsArray) => (0, make_1.make)(\"CallChain\", {\n    expression,\n    questionDotToken,\n    typeArguments,\n    arguments: argumentsArray ?? [],\n});\nexports.createCallChain = createCallChain;\n//# sourceMappingURL=createCallChain.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,eAAe,GAAG,MAAM;AAChC,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;AACA;AACA,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE;AACvH,IAAI,UAAU;AACd,IAAI,gBAAgB;AACpB,IAAI,aAAa;AACjB,IAAI,SAAS,EAAE,cAAc,IAAI,EAAE;AACnC,CAAC,CAAC;AACF,OAAO,CAAC,eAAe,GAAG,eAAe"}

package/lib/factory/expressions/createCallExpression.d.ts

@@ -1,11 +1,21 @@
 import type { CallExpression, Expression, TypeNode } from "../../ast";
 /**
- * Create a {@link CallExpression}.
+ * Create a {@link CallExpression}: a function or method call.
+ *
+ * The optional `typeArguments` are printed in `<...>` before the argument list.
+ * The arguments are printed comma separated inside the parentheses, and a
+ * missing `argumentsArray` is treated as an empty list.
+ *
+ * Given callee `fn` and arguments `a`, `b`, the printer emits:
+ *
+ * ```ts
+ * fn(a, b);
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
+ * @param expression The callee expression.
  * @param typeArguments The generic type arguments, if any.
- * @param argumentsArray The arguments.
+ * @param argumentsArray The call arguments.
  * @returns The created {@link CallExpression}.
  */
 export declare const createCallExpression: (expression: Expression, typeArguments: readonly TypeNode[] | undefined, argumentsArray: readonly Expression[] | undefined) => CallExpression;

package/lib/factory/expressions/createCallExpression.js

@@ -3,12 +3,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCallExpression = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link CallExpression}.
+ * Create a {@link CallExpression}: a function or method call.
+ *
+ * The optional `typeArguments` are printed in `<...>` before the argument list.
+ * The arguments are printed comma separated inside the parentheses, and a
+ * missing `argumentsArray` is treated as an empty list.
+ *
+ * Given callee `fn` and arguments `a`, `b`, the printer emits:
+ *
+ * ```ts
+ * fn(a, b);
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
+ * @param expression The callee expression.
  * @param typeArguments The generic type arguments, if any.
- * @param argumentsArray The arguments.
+ * @param argumentsArray The call arguments.
  * @returns The created {@link CallExpression}.
  */
 const createCallExpression = (expression, typeArguments, argumentsArray) => (0, make_1.make)("CallExpression", {

package/lib/factory/expressions/createCallExpression.js.map

@@ -1 +1 @@
-{"version":3,"file":"createCallExpression.js","sourceRoot":"","sources":["../../../src/factory/expressions/createCallExpression.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;GAQG;AACI,MAAM,oBAAoB,GAAG,CAClC,UAAsB,EACtB,aAA8C,EAC9C,cAAiD,EACjC,EAAE,CAClB,IAAA,WAAI,EAAC,gBAAgB,EAAE;IACrB,UAAU;IACV,aAAa;IACb,SAAS,EAAE,cAAc,IAAI,EAAE;CAChC,CAAC,CAAC;AATQ,QAAA,oBAAoB,GAApB,oBAAoB,CAS5B"}
+{"version":3,"file":"createCallExpression.js","sourceRoot":"","sources":["../../../src/factory/expressions/createCallExpression.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;GAkBG;AACI,MAAM,oBAAoB,GAAG,CAClC,UAAsB,EACtB,aAA8C,EAC9C,cAAiD,EACjC,EAAE,CAClB,IAAA,WAAI,EAAC,gBAAgB,EAAE;IACrB,UAAU;IACV,aAAa;IACb,SAAS,EAAE,cAAc,IAAI,EAAE;CAChC,CAAC,CAAC;AATQ,QAAA,oBAAoB,GAApB,oBAAoB,CAS5B"}

package/lib/factory/expressions/createCallExpression.mjs

@@ -2,12 +2,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCallExpression = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link CallExpression}.
+ * Create a {@link CallExpression}: a function or method call.
+ *
+ * The optional `typeArguments` are printed in `<...>` before the argument list.
+ * The arguments are printed comma separated inside the parentheses, and a
+ * missing `argumentsArray` is treated as an empty list.
+ *
+ * Given callee `fn` and arguments `a`, `b`, the printer emits:
+ *
+ * ```ts
+ * fn(a, b);
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
+ * @param expression The callee expression.
  * @param typeArguments The generic type arguments, if any.
- * @param argumentsArray The arguments.
+ * @param argumentsArray The call arguments.
  * @returns The created {@link CallExpression}.
  */
 const createCallExpression = (expression, typeArguments, argumentsArray) => (0, make_1.make)("CallExpression", {

package/lib/factory/expressions/createCallExpression.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createCallExpression.mjs","sources":["createCallExpression.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createCallExpression = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link CallExpression}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param expression The expression.\n * @param typeArguments The generic type arguments, if any.\n * @param argumentsArray The arguments.\n * @returns The created {@link CallExpression}.\n */\nconst createCallExpression = (expression, typeArguments, argumentsArray) => (0, make_1.make)(\"CallExpression\", {\n    expression,\n    typeArguments,\n    arguments: argumentsArray ?? [],\n});\nexports.createCallExpression = createCallExpression;\n//# sourceMappingURL=createCallExpression.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,oBAAoB,GAAG,MAAM;AACrC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,oBAAoB,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,cAAc,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE;AAC/G,IAAI,UAAU;AACd,IAAI,aAAa;AACjB,IAAI,SAAS,EAAE,cAAc,IAAI,EAAE;AACnC,CAAC,CAAC;AACF,OAAO,CAAC,oBAAoB,GAAG,oBAAoB"}
+{"version":3,"file":"createCallExpression.mjs","sources":["createCallExpression.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createCallExpression = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link CallExpression}: a function or method call.\n *\n * The optional `typeArguments` are printed in `<...>` before the argument list.\n * The arguments are printed comma separated inside the parentheses, and a\n * missing `argumentsArray` is treated as an empty list.\n *\n * Given callee `fn` and arguments `a`, `b`, the printer emits:\n *\n * ```ts\n * fn(a, b);\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param expression The callee expression.\n * @param typeArguments The generic type arguments, if any.\n * @param argumentsArray The call arguments.\n * @returns The created {@link CallExpression}.\n */\nconst createCallExpression = (expression, typeArguments, argumentsArray) => (0, make_1.make)(\"CallExpression\", {\n    expression,\n    typeArguments,\n    arguments: argumentsArray ?? [],\n});\nexports.createCallExpression = createCallExpression;\n//# sourceMappingURL=createCallExpression.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,oBAAoB,GAAG,MAAM;AACrC,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,oBAAoB,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,cAAc,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE;AAC/G,IAAI,UAAU;AACd,IAAI,aAAa;AACjB,IAAI,SAAS,EAAE,cAAc,IAAI,EAAE;AACnC,CAAC,CAAC;AACF,OAAO,CAAC,oBAAoB,GAAG,oBAAoB"}

package/lib/factory/expressions/createClassExpression.d.ts

@@ -1,13 +1,23 @@
 import type { ClassElement, ClassExpression, HeritageClause, Identifier, ModifierLike, TypeParameterDeclaration } from "../../ast";
 /**
- * Create a {@link ClassExpression}.
+ * Create a {@link ClassExpression}: a `class` used as an expression.
+ *
+ * A string `name` is normalized with {@link asName}; the name is optional, as
+ * are the `modifiers`, `typeParameters` and `heritageClauses` (the `extends` /
+ * `implements` clauses). The `members` are printed inside the class body.
+ *
+ * Given name `C` and no members, the printer emits:
+ *
+ * ```ts
+ * class C {}
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param modifiers The modifiers.
- * @param name The name.
- * @param typeParameters The typeParameters.
- * @param heritageClauses The heritageClauses.
- * @param members The members.
- * @returns The created node.
+ * @param modifiers The leading modifiers, if any.
+ * @param name The class name, if any.
+ * @param typeParameters The generic type parameters, if any.
+ * @param heritageClauses The extends and implements clauses, if any.
+ * @param members The class members.
+ * @returns The created {@link ClassExpression}.
  */
 export declare const createClassExpression: (modifiers: readonly ModifierLike[] | undefined, name: string | Identifier | undefined, typeParameters: readonly TypeParameterDeclaration[] | undefined, heritageClauses: readonly HeritageClause[] | undefined, members: readonly ClassElement[]) => ClassExpression;

package/lib/factory/expressions/createClassExpression.js

@@ -4,15 +4,25 @@ exports.createClassExpression = void 0;
 const asName_1 = require("../internal/asName");
 const make_1 = require("../internal/make");
 /**
- * Create a {@link ClassExpression}.
+ * Create a {@link ClassExpression}: a `class` used as an expression.
+ *
+ * A string `name` is normalized with {@link asName}; the name is optional, as
+ * are the `modifiers`, `typeParameters` and `heritageClauses` (the `extends` /
+ * `implements` clauses). The `members` are printed inside the class body.
+ *
+ * Given name `C` and no members, the printer emits:
+ *
+ * ```ts
+ * class C {}
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param modifiers The modifiers.
- * @param name The name.
- * @param typeParameters The typeParameters.
- * @param heritageClauses The heritageClauses.
- * @param members The members.
- * @returns The created node.
+ * @param modifiers The leading modifiers, if any.
+ * @param name The class name, if any.
+ * @param typeParameters The generic type parameters, if any.
+ * @param heritageClauses The extends and implements clauses, if any.
+ * @param members The class members.
+ * @returns The created {@link ClassExpression}.
  */
 const createClassExpression = (modifiers, name, typeParameters, heritageClauses, members) => (0, make_1.make)("ClassExpression", {
     modifiers,

package/lib/factory/expressions/createClassExpression.js.map

@@ -1 +1 @@
-{"version":3,"file":"createClassExpression.js","sourceRoot":"","sources":["../../../src/factory/expressions/createClassExpression.ts"],"names":[],"mappings":";;;AAQA,+CAA4C;AAC5C,2CAAwC;AAExC;;;;;;;;;;GAUG;AACI,MAAM,qBAAqB,GAAG,CACnC,SAA8C,EAC9C,IAAqC,EACrC,cAA+D,EAC/D,eAAsD,EACtD,OAAgC,EACf,EAAE,CACnB,IAAA,WAAI,EAAC,iBAAiB,EAAE;IACtB,SAAS;IACT,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,eAAM,EAAC,IAAI,CAAC;IACnD,cAAc;IACd,eAAe;IACf,OAAO;CACR,CAAC,CAAC;AAbQ,QAAA,qBAAqB,GAArB,qBAAqB,CAa7B"}
+{"version":3,"file":"createClassExpression.js","sourceRoot":"","sources":["../../../src/factory/expressions/createClassExpression.ts"],"names":[],"mappings":";;;AAQA,+CAA4C;AAC5C,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,MAAM,qBAAqB,GAAG,CACnC,SAA8C,EAC9C,IAAqC,EACrC,cAA+D,EAC/D,eAAsD,EACtD,OAAgC,EACf,EAAE,CACnB,IAAA,WAAI,EAAC,iBAAiB,EAAE;IACtB,SAAS;IACT,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,eAAM,EAAC,IAAI,CAAC;IACnD,cAAc;IACd,eAAe;IACf,OAAO;CACR,CAAC,CAAC;AAbQ,QAAA,qBAAqB,GAArB,qBAAqB,CAa7B"}

package/lib/factory/expressions/createClassExpression.mjs

@@ -3,15 +3,25 @@ exports.createClassExpression = void 0;
 const asName_1 = require("../internal/asName");
 const make_1 = require("../internal/make");
 /**
- * Create a {@link ClassExpression}.
+ * Create a {@link ClassExpression}: a `class` used as an expression.
+ *
+ * A string `name` is normalized with {@link asName}; the name is optional, as
+ * are the `modifiers`, `typeParameters` and `heritageClauses` (the `extends` /
+ * `implements` clauses). The `members` are printed inside the class body.
+ *
+ * Given name `C` and no members, the printer emits:
+ *
+ * ```ts
+ * class C {}
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param modifiers The modifiers.
- * @param name The name.
- * @param typeParameters The typeParameters.
- * @param heritageClauses The heritageClauses.
- * @param members The members.
- * @returns The created node.
+ * @param modifiers The leading modifiers, if any.
+ * @param name The class name, if any.
+ * @param typeParameters The generic type parameters, if any.
+ * @param heritageClauses The extends and implements clauses, if any.
+ * @param members The class members.
+ * @returns The created {@link ClassExpression}.
  */
 const createClassExpression = (modifiers, name, typeParameters, heritageClauses, members) => (0, make_1.make)("ClassExpression", {
     modifiers,

package/lib/factory/expressions/createClassExpression.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createClassExpression.mjs","sources":["createClassExpression.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createClassExpression = void 0;\nconst asName_1 = require(\"../internal/asName\");\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link ClassExpression}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param modifiers The modifiers.\n * @param name The name.\n * @param typeParameters The typeParameters.\n * @param heritageClauses The heritageClauses.\n * @param members The members.\n * @returns The created node.\n */\nconst createClassExpression = (modifiers, name, typeParameters, heritageClauses, members) => (0, make_1.make)(\"ClassExpression\", {\n    modifiers,\n    name: name === undefined ? undefined : (0, asName_1.asName)(name),\n    typeParameters,\n    heritageClauses,\n    members,\n});\nexports.createClassExpression = createClassExpression;\n//# sourceMappingURL=createClassExpression.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,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,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,eAAe,EAAE,OAAO,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE;AACjI,IAAI,SAAS;AACb,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS,GAAG,SAAS,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;AACrE,IAAI,cAAc;AAClB,IAAI,eAAe;AACnB,IAAI,OAAO;AACX,CAAC,CAAC;AACF,OAAO,CAAC,qBAAqB,GAAG,qBAAqB"}
+{"version":3,"file":"createClassExpression.mjs","sources":["createClassExpression.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createClassExpression = void 0;\nconst asName_1 = require(\"../internal/asName\");\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link ClassExpression}: a `class` used as an expression.\n *\n * A string `name` is normalized with {@link asName}; the name is optional, as\n * are the `modifiers`, `typeParameters` and `heritageClauses` (the `extends` /\n * `implements` clauses). The `members` are printed inside the class body.\n *\n * Given name `C` and no members, the printer emits:\n *\n * ```ts\n * class C {}\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param modifiers The leading modifiers, if any.\n * @param name The class name, if any.\n * @param typeParameters The generic type parameters, if any.\n * @param heritageClauses The extends and implements clauses, if any.\n * @param members The class members.\n * @returns The created {@link ClassExpression}.\n */\nconst createClassExpression = (modifiers, name, typeParameters, heritageClauses, members) => (0, make_1.make)(\"ClassExpression\", {\n    modifiers,\n    name: name === undefined ? undefined : (0, asName_1.asName)(name),\n    typeParameters,\n    heritageClauses,\n    members,\n});\nexports.createClassExpression = createClassExpression;\n//# sourceMappingURL=createClassExpression.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,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,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,eAAe,EAAE,OAAO,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE;AACjI,IAAI,SAAS;AACb,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS,GAAG,SAAS,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;AACrE,IAAI,cAAc;AAClB,IAAI,eAAe;AACnB,IAAI,OAAO;AACX,CAAC,CAAC;AACF,OAAO,CAAC,qBAAqB,GAAG,qBAAqB"}

package/lib/factory/expressions/createComma.d.ts

@@ -1,10 +1,22 @@
 import type { BinaryExpression, Expression } from "../../ast";
 /**
- * Convenience wrapper that builds the corresponding expression node.
+ * Create a {@link BinaryExpression} with the `,` operator: the comma operator,
+ * which evaluates both operands and yields the right one.
+ *
+ * Shorthand for {@link createBinaryExpression} with the `CommaToken` operator.
+ * The printer treats the comma like any other binary operator and surrounds it
+ * with a single space on each side, so the output has a space before the
+ * comma.
+ *
+ * Given operands `a` and `b`, the printer emits:
+ *
+ * ```ts
+ * (a, b);
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param left The left.
- * @param right The right.
- * @returns The created expression.
+ * @param left The left-hand operand.
+ * @param right The right-hand operand.
+ * @returns The created {@link BinaryExpression}.
  */
 export declare const createComma: (left: Expression, right: Expression) => BinaryExpression;

package/lib/factory/expressions/createComma.js

@@ -4,12 +4,24 @@ exports.createComma = void 0;
 const syntax_1 = require("../../syntax");
 const createBinaryExpression_1 = require("./createBinaryExpression");
 /**
- * Convenience wrapper that builds the corresponding expression node.
+ * Create a {@link BinaryExpression} with the `,` operator: the comma operator,
+ * which evaluates both operands and yields the right one.
+ *
+ * Shorthand for {@link createBinaryExpression} with the `CommaToken` operator.
+ * The printer treats the comma like any other binary operator and surrounds it
+ * with a single space on each side, so the output has a space before the
+ * comma.
+ *
+ * Given operands `a` and `b`, the printer emits:
+ *
+ * ```ts
+ * (a, b);
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param left The left.
- * @param right The right.
- * @returns The created expression.
+ * @param left The left-hand operand.
+ * @param right The right-hand operand.
+ * @returns The created {@link BinaryExpression}.
  */
 const createComma = (left, right) => (0, createBinaryExpression_1.createBinaryExpression)(left, syntax_1.SyntaxKind.CommaToken, right);
 exports.createComma = createComma;

package/lib/factory/expressions/createComma.js.map

@@ -1 +1 @@
-{"version":3,"file":"createComma.js","sourceRoot":"","sources":["../../../src/factory/expressions/createComma.ts"],"names":[],"mappings":";;;AACA,yCAA0C;AAC1C,qEAAkE;AAElE;;;;;;;GAOG;AACI,MAAM,WAAW,GAAG,CACzB,IAAgB,EAChB,KAAiB,EACC,EAAE,CACpB,IAAA,+CAAsB,EAAC,IAAI,EAAE,mBAAU,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAJhD,QAAA,WAAW,GAAX,WAAW,CAIqC"}
+{"version":3,"file":"createComma.js","sourceRoot":"","sources":["../../../src/factory/expressions/createComma.ts"],"names":[],"mappings":";;;AACA,yCAA0C;AAC1C,qEAAkE;AAElE;;;;;;;;;;;;;;;;;;;GAmBG;AACI,MAAM,WAAW,GAAG,CACzB,IAAgB,EAChB,KAAiB,EACC,EAAE,CACpB,IAAA,+CAAsB,EAAC,IAAI,EAAE,mBAAU,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAJhD,QAAA,WAAW,GAAX,WAAW,CAIqC"}

package/lib/factory/expressions/createComma.mjs

@@ -3,12 +3,24 @@ exports.createComma = void 0;
 const syntax_1 = require("../../syntax");
 const createBinaryExpression_1 = require("./createBinaryExpression");
 /**
- * Convenience wrapper that builds the corresponding expression node.
+ * Create a {@link BinaryExpression} with the `,` operator: the comma operator,
+ * which evaluates both operands and yields the right one.
+ *
+ * Shorthand for {@link createBinaryExpression} with the `CommaToken` operator.
+ * The printer treats the comma like any other binary operator and surrounds it
+ * with a single space on each side, so the output has a space before the
+ * comma.
+ *
+ * Given operands `a` and `b`, the printer emits:
+ *
+ * ```ts
+ * (a, b);
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param left The left.
- * @param right The right.
- * @returns The created expression.
+ * @param left The left-hand operand.
+ * @param right The right-hand operand.
+ * @returns The created {@link BinaryExpression}.
  */
 const createComma = (left, right) => (0, createBinaryExpression_1.createBinaryExpression)(left, syntax_1.SyntaxKind.CommaToken, right);
 exports.createComma = createComma;

package/lib/factory/expressions/createComma.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createComma.mjs","sources":["createComma.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createComma = void 0;\nconst syntax_1 = require(\"../../syntax\");\nconst createBinaryExpression_1 = require(\"./createBinaryExpression\");\n/**\n * Convenience wrapper that builds the corresponding expression node.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param left The left.\n * @param right The right.\n * @returns The created expression.\n */\nconst createComma = (left, right) => (0, createBinaryExpression_1.createBinaryExpression)(left, syntax_1.SyntaxKind.CommaToken, right);\nexports.createComma = createComma;\n//# sourceMappingURL=createComma.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,WAAW,GAAG,MAAM;AAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC;AACxC,MAAM,wBAAwB,GAAG,OAAO,CAAC,0BAA0B,CAAC;AACpE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,wBAAwB,CAAC,sBAAsB,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC;AACtI,OAAO,CAAC,WAAW,GAAG,WAAW"}
+{"version":3,"file":"createComma.mjs","sources":["createComma.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createComma = void 0;\nconst syntax_1 = require(\"../../syntax\");\nconst createBinaryExpression_1 = require(\"./createBinaryExpression\");\n/**\n * Create a {@link BinaryExpression} with the `,` operator: the comma operator,\n * which evaluates both operands and yields the right one.\n *\n * Shorthand for {@link createBinaryExpression} with the `CommaToken` operator.\n * The printer treats the comma like any other binary operator and surrounds it\n * with a single space on each side, so the output has a space before the\n * comma.\n *\n * Given operands `a` and `b`, the printer emits:\n *\n * ```ts\n * (a, b);\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param left The left-hand operand.\n * @param right The right-hand operand.\n * @returns The created {@link BinaryExpression}.\n */\nconst createComma = (left, right) => (0, createBinaryExpression_1.createBinaryExpression)(left, syntax_1.SyntaxKind.CommaToken, right);\nexports.createComma = createComma;\n//# sourceMappingURL=createComma.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,WAAW,GAAG,MAAM;AAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC;AACxC,MAAM,wBAAwB,GAAG,OAAO,CAAC,0BAA0B,CAAC;AACpE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,wBAAwB,CAAC,sBAAsB,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC;AACtI,OAAO,CAAC,WAAW,GAAG,WAAW"}

package/lib/factory/expressions/createCommaListExpression.d.ts

@@ -1,9 +1,19 @@
 import type { CommaListExpression, Expression } from "../../ast";
 /**
- * Create a {@link CommaListExpression}.
+ * Create a {@link CommaListExpression}: a synthetic list of expressions joined
+ * by commas, used where several expressions are emitted in sequence.
+ *
+ * Unlike a chain of comma {@link BinaryExpression} nodes, this is a flat list.
+ * The printer separates the elements with a comma and a space.
+ *
+ * Given elements `a`, `b`, `c`, the printer emits:
+ *
+ * ```ts
+ * (a, b, c);
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param elements The elements.
- * @returns The created node.
+ * @param elements The element expressions.
+ * @returns The created {@link CommaListExpression}.
  */
 export declare const createCommaListExpression: (elements: readonly Expression[]) => CommaListExpression;

package/lib/factory/expressions/createCommaListExpression.js

@@ -3,11 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCommaListExpression = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link CommaListExpression}.
+ * Create a {@link CommaListExpression}: a synthetic list of expressions joined
+ * by commas, used where several expressions are emitted in sequence.
+ *
+ * Unlike a chain of comma {@link BinaryExpression} nodes, this is a flat list.
+ * The printer separates the elements with a comma and a space.
+ *
+ * Given elements `a`, `b`, `c`, the printer emits:
+ *
+ * ```ts
+ * (a, b, c);
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param elements The elements.
- * @returns The created node.
+ * @param elements The element expressions.
+ * @returns The created {@link CommaListExpression}.
  */
 const createCommaListExpression = (elements) => (0, make_1.make)("CommaListExpression", { elements });
 exports.createCommaListExpression = createCommaListExpression;

package/lib/factory/expressions/createCommaListExpression.js.map

@@ -1 +1 @@
-{"version":3,"file":"createCommaListExpression.js","sourceRoot":"","sources":["../../../src/factory/expressions/createCommaListExpression.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;GAMG;AACI,MAAM,yBAAyB,GAAG,CACvC,QAA+B,EACV,EAAE,CAAC,IAAA,WAAI,EAAC,qBAAqB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAFvD,QAAA,yBAAyB,GAAzB,yBAAyB,CAE8B"}
+{"version":3,"file":"createCommaListExpression.js","sourceRoot":"","sources":["../../../src/factory/expressions/createCommaListExpression.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;;GAgBG;AACI,MAAM,yBAAyB,GAAG,CACvC,QAA+B,EACV,EAAE,CAAC,IAAA,WAAI,EAAC,qBAAqB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAFvD,QAAA,yBAAyB,GAAzB,yBAAyB,CAE8B"}

package/lib/factory/expressions/createCommaListExpression.mjs

@@ -2,11 +2,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCommaListExpression = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link CommaListExpression}.
+ * Create a {@link CommaListExpression}: a synthetic list of expressions joined
+ * by commas, used where several expressions are emitted in sequence.
+ *
+ * Unlike a chain of comma {@link BinaryExpression} nodes, this is a flat list.
+ * The printer separates the elements with a comma and a space.
+ *
+ * Given elements `a`, `b`, `c`, the printer emits:
+ *
+ * ```ts
+ * (a, b, c);
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param elements The elements.
- * @returns The created node.
+ * @param elements The element expressions.
+ * @returns The created {@link CommaListExpression}.
  */
 const createCommaListExpression = (elements) => (0, make_1.make)("CommaListExpression", { elements });
 exports.createCommaListExpression = createCommaListExpression;

package/lib/factory/expressions/createCommaListExpression.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createCommaListExpression.mjs","sources":["createCommaListExpression.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createCommaListExpression = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link CommaListExpression}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param elements The elements.\n * @returns The created node.\n */\nconst createCommaListExpression = (elements) => (0, make_1.make)(\"CommaListExpression\", { elements });\nexports.createCommaListExpression = createCommaListExpression;\n//# sourceMappingURL=createCommaListExpression.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,yBAAyB,GAAG,MAAM;AAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,yBAAyB,GAAG,CAAC,QAAQ,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,qBAAqB,EAAE,EAAE,QAAQ,EAAE,CAAC;AACrG,OAAO,CAAC,yBAAyB,GAAG,yBAAyB"}
+{"version":3,"file":"createCommaListExpression.mjs","sources":["createCommaListExpression.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createCommaListExpression = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link CommaListExpression}: a synthetic list of expressions joined\n * by commas, used where several expressions are emitted in sequence.\n *\n * Unlike a chain of comma {@link BinaryExpression} nodes, this is a flat list.\n * The printer separates the elements with a comma and a space.\n *\n * Given elements `a`, `b`, `c`, the printer emits:\n *\n * ```ts\n * (a, b, c);\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param elements The element expressions.\n * @returns The created {@link CommaListExpression}.\n */\nconst createCommaListExpression = (elements) => (0, make_1.make)(\"CommaListExpression\", { elements });\nexports.createCommaListExpression = createCommaListExpression;\n//# sourceMappingURL=createCommaListExpression.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,yBAAyB,GAAG,MAAM;AAC1C,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,yBAAyB,GAAG,CAAC,QAAQ,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,qBAAqB,EAAE,EAAE,QAAQ,EAAE,CAAC;AACrG,OAAO,CAAC,yBAAyB,GAAG,yBAAyB"}

package/lib/factory/expressions/createComputedPropertyName.d.ts

@@ -1,9 +1,19 @@
 import type { ComputedPropertyName, Expression } from "../../ast";
 /**
- * Create a {@link ComputedPropertyName}.
+ * Create a {@link ComputedPropertyName}: a `[expression]` property key.
+ *
+ * Used as the name of an object-literal member, class member or signature so
+ * the key is computed at runtime. The printer wraps the expression in square
+ * brackets.
+ *
+ * Given expression `key`, the printer emits the key:
+ *
+ * ```ts
+ * [key];
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
- * @returns The created node.
+ * @param expression The key expression.
+ * @returns The created {@link ComputedPropertyName}.
  */
 export declare const createComputedPropertyName: (expression: Expression) => ComputedPropertyName;

package/lib/factory/expressions/createComputedPropertyName.js

@@ -3,11 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createComputedPropertyName = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link ComputedPropertyName}.
+ * Create a {@link ComputedPropertyName}: a `[expression]` property key.
+ *
+ * Used as the name of an object-literal member, class member or signature so
+ * the key is computed at runtime. The printer wraps the expression in square
+ * brackets.
+ *
+ * Given expression `key`, the printer emits the key:
+ *
+ * ```ts
+ * [key];
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
- * @returns The created node.
+ * @param expression The key expression.
+ * @returns The created {@link ComputedPropertyName}.
  */
 const createComputedPropertyName = (expression) => (0, make_1.make)("ComputedPropertyName", { expression });
 exports.createComputedPropertyName = createComputedPropertyName;

package/lib/factory/expressions/createComputedPropertyName.js.map

@@ -1 +1 @@
-{"version":3,"file":"createComputedPropertyName.js","sourceRoot":"","sources":["../../../src/factory/expressions/createComputedPropertyName.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;GAMG;AACI,MAAM,0BAA0B,GAAG,CACxC,UAAsB,EACA,EAAE,CAAC,IAAA,WAAI,EAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;AAF3D,QAAA,0BAA0B,GAA1B,0BAA0B,CAEiC"}
+{"version":3,"file":"createComputedPropertyName.js","sourceRoot":"","sources":["../../../src/factory/expressions/createComputedPropertyName.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;;GAgBG;AACI,MAAM,0BAA0B,GAAG,CACxC,UAAsB,EACA,EAAE,CAAC,IAAA,WAAI,EAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;AAF3D,QAAA,0BAA0B,GAA1B,0BAA0B,CAEiC"}

package/lib/factory/expressions/createComputedPropertyName.mjs

@@ -2,11 +2,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createComputedPropertyName = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link ComputedPropertyName}.
+ * Create a {@link ComputedPropertyName}: a `[expression]` property key.
+ *
+ * Used as the name of an object-literal member, class member or signature so
+ * the key is computed at runtime. The printer wraps the expression in square
+ * brackets.
+ *
+ * Given expression `key`, the printer emits the key:
+ *
+ * ```ts
+ * [key];
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
- * @returns The created node.
+ * @param expression The key expression.
+ * @returns The created {@link ComputedPropertyName}.
  */
 const createComputedPropertyName = (expression) => (0, make_1.make)("ComputedPropertyName", { expression });
 exports.createComputedPropertyName = createComputedPropertyName;

package/lib/factory/expressions/createComputedPropertyName.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createComputedPropertyName.mjs","sources":["createComputedPropertyName.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createComputedPropertyName = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link ComputedPropertyName}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param expression The expression.\n * @returns The created node.\n */\nconst createComputedPropertyName = (expression) => (0, make_1.make)(\"ComputedPropertyName\", { expression });\nexports.createComputedPropertyName = createComputedPropertyName;\n//# sourceMappingURL=createComputedPropertyName.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,0BAA0B,GAAG,MAAM;AAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,0BAA0B,GAAG,CAAC,UAAU,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,sBAAsB,EAAE,EAAE,UAAU,EAAE,CAAC;AAC3G,OAAO,CAAC,0BAA0B,GAAG,0BAA0B"}
+{"version":3,"file":"createComputedPropertyName.mjs","sources":["createComputedPropertyName.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createComputedPropertyName = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link ComputedPropertyName}: a `[expression]` property key.\n *\n * Used as the name of an object-literal member, class member or signature so\n * the key is computed at runtime. The printer wraps the expression in square\n * brackets.\n *\n * Given expression `key`, the printer emits the key:\n *\n * ```ts\n * [key];\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param expression The key expression.\n * @returns The created {@link ComputedPropertyName}.\n */\nconst createComputedPropertyName = (expression) => (0, make_1.make)(\"ComputedPropertyName\", { expression });\nexports.createComputedPropertyName = createComputedPropertyName;\n//# sourceMappingURL=createComputedPropertyName.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,0BAA0B,GAAG,MAAM;AAC3C,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,0BAA0B,GAAG,CAAC,UAAU,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,sBAAsB,EAAE,EAAE,UAAU,EAAE,CAAC;AAC3G,OAAO,CAAC,0BAA0B,GAAG,0BAA0B"}