@ttsc/factory 0.15.6 → 0.15.8

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

@@ -1,6 +1,17 @@
 import type { ConditionalExpression, Expression, Token } from "../../ast";
 /**
- * Create a {@link ConditionalExpression}.
+ * Create a {@link ConditionalExpression}: a ternary `condition ? whenTrue :
+ * whenFalse`.
+ *
+ * The `_questionToken` and `_colonToken` parameters exist only for signature
+ * parity with the legacy factory and are ignored: the printer always emits `?`
+ * and `:`, each surrounded by a single space.
+ *
+ * Given condition `cond` and branches `a` and `b`, the printer emits:
+ *
+ * ```ts
+ * cond ? a : b;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param condition The condition.

package/lib/factory/expressions/createConditionalExpression.js

@@ -3,7 +3,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createConditionalExpression = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link ConditionalExpression}.
+ * Create a {@link ConditionalExpression}: a ternary `condition ? whenTrue :
+ * whenFalse`.
+ *
+ * The `_questionToken` and `_colonToken` parameters exist only for signature
+ * parity with the legacy factory and are ignored: the printer always emits `?`
+ * and `:`, each surrounded by a single space.
+ *
+ * Given condition `cond` and branches `a` and `b`, the printer emits:
+ *
+ * ```ts
+ * cond ? a : b;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param condition The condition.

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

@@ -1 +1 @@
-{"version":3,"file":"createConditionalExpression.js","sourceRoot":"","sources":["../../../src/factory/expressions/createConditionalExpression.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;GAUG;AACI,MAAM,2BAA2B,GAAG,CACzC,SAAqB,EACrB,cAAiC,EACjC,QAAoB,EACpB,WAA8B,EAC9B,SAAqB,EACE,EAAE,CACzB,IAAA,WAAI,EAAC,uBAAuB,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;AAPvD,QAAA,2BAA2B,GAA3B,2BAA2B,CAO4B"}
+{"version":3,"file":"createConditionalExpression.js","sourceRoot":"","sources":["../../../src/factory/expressions/createConditionalExpression.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,MAAM,2BAA2B,GAAG,CACzC,SAAqB,EACrB,cAAiC,EACjC,QAAoB,EACpB,WAA8B,EAC9B,SAAqB,EACE,EAAE,CACzB,IAAA,WAAI,EAAC,uBAAuB,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;AAPvD,QAAA,2BAA2B,GAA3B,2BAA2B,CAO4B"}

package/lib/factory/expressions/createConditionalExpression.mjs

@@ -2,7 +2,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createConditionalExpression = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link ConditionalExpression}.
+ * Create a {@link ConditionalExpression}: a ternary `condition ? whenTrue :
+ * whenFalse`.
+ *
+ * The `_questionToken` and `_colonToken` parameters exist only for signature
+ * parity with the legacy factory and are ignored: the printer always emits `?`
+ * and `:`, each surrounded by a single space.
+ *
+ * Given condition `cond` and branches `a` and `b`, the printer emits:
+ *
+ * ```ts
+ * cond ? a : b;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param condition The condition.

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

@@ -1 +1 @@
-{"version":3,"file":"createConditionalExpression.mjs","sources":["createConditionalExpression.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createConditionalExpression = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link ConditionalExpression}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param condition The condition.\n * @param _questionToken Ignored; present only to mirror the legacy signature.\n * @param whenTrue The value when the condition holds.\n * @param _colonToken Ignored; present only to mirror the legacy signature.\n * @param whenFalse The value otherwise.\n * @returns The created {@link ConditionalExpression}.\n */\nconst createConditionalExpression = (condition, _questionToken, whenTrue, _colonToken, whenFalse) => (0, make_1.make)(\"ConditionalExpression\", { condition, whenTrue, whenFalse });\nexports.createConditionalExpression = createConditionalExpression;\n//# sourceMappingURL=createConditionalExpression.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,2BAA2B,GAAG,MAAM;AAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,2BAA2B,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,uBAAuB,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AAClL,OAAO,CAAC,2BAA2B,GAAG,2BAA2B"}
+{"version":3,"file":"createConditionalExpression.mjs","sources":["createConditionalExpression.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createConditionalExpression = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link ConditionalExpression}: a ternary `condition ? whenTrue :\n * whenFalse`.\n *\n * The `_questionToken` and `_colonToken` parameters exist only for signature\n * parity with the legacy factory and are ignored: the printer always emits `?`\n * and `:`, each surrounded by a single space.\n *\n * Given condition `cond` and branches `a` and `b`, the printer emits:\n *\n * ```ts\n * cond ? a : b;\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param condition The condition.\n * @param _questionToken Ignored; present only to mirror the legacy signature.\n * @param whenTrue The value when the condition holds.\n * @param _colonToken Ignored; present only to mirror the legacy signature.\n * @param whenFalse The value otherwise.\n * @returns The created {@link ConditionalExpression}.\n */\nconst createConditionalExpression = (condition, _questionToken, whenTrue, _colonToken, whenFalse) => (0, make_1.make)(\"ConditionalExpression\", { condition, whenTrue, whenFalse });\nexports.createConditionalExpression = createConditionalExpression;\n//# sourceMappingURL=createConditionalExpression.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,2BAA2B,GAAG,MAAM;AAC5C,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,2BAA2B,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,uBAAuB,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AAClL,OAAO,CAAC,2BAA2B,GAAG,2BAA2B"}

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

@@ -1,9 +1,18 @@
 import type { DeleteExpression, Expression } from "../../ast";
 /**
- * Create a {@link DeleteExpression}.
+ * Create a {@link DeleteExpression}: a `delete` of an operand.
+ *
+ * The printer writes the `delete` keyword followed by a single space and the
+ * operand expression.
+ *
+ * Given operand `obj.prop`, the printer emits:
+ *
+ * ```ts
+ * delete obj.prop;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
- * @returns The created node.
+ * @param expression The expression to delete.
+ * @returns The created {@link DeleteExpression}.
  */
 export declare const createDeleteExpression: (expression: Expression) => DeleteExpression;

package/lib/factory/expressions/createDeleteExpression.js

@@ -3,11 +3,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDeleteExpression = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link DeleteExpression}.
+ * Create a {@link DeleteExpression}: a `delete` of an operand.
+ *
+ * The printer writes the `delete` keyword followed by a single space and the
+ * operand expression.
+ *
+ * Given operand `obj.prop`, the printer emits:
+ *
+ * ```ts
+ * delete obj.prop;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
- * @returns The created node.
+ * @param expression The expression to delete.
+ * @returns The created {@link DeleteExpression}.
  */
 const createDeleteExpression = (expression) => (0, make_1.make)("DeleteExpression", { expression });
 exports.createDeleteExpression = createDeleteExpression;

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

@@ -1 +1 @@
-{"version":3,"file":"createDeleteExpression.js","sourceRoot":"","sources":["../../../src/factory/expressions/createDeleteExpression.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;GAMG;AACI,MAAM,sBAAsB,GAAG,CACpC,UAAsB,EACJ,EAAE,CAAC,IAAA,WAAI,EAAC,kBAAkB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;AAFnD,QAAA,sBAAsB,GAAtB,sBAAsB,CAE6B"}
+{"version":3,"file":"createDeleteExpression.js","sourceRoot":"","sources":["../../../src/factory/expressions/createDeleteExpression.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;GAeG;AACI,MAAM,sBAAsB,GAAG,CACpC,UAAsB,EACJ,EAAE,CAAC,IAAA,WAAI,EAAC,kBAAkB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;AAFnD,QAAA,sBAAsB,GAAtB,sBAAsB,CAE6B"}

package/lib/factory/expressions/createDeleteExpression.mjs

@@ -2,11 +2,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDeleteExpression = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link DeleteExpression}.
+ * Create a {@link DeleteExpression}: a `delete` of an operand.
+ *
+ * The printer writes the `delete` keyword followed by a single space and the
+ * operand expression.
+ *
+ * Given operand `obj.prop`, the printer emits:
+ *
+ * ```ts
+ * delete obj.prop;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
- * @returns The created node.
+ * @param expression The expression to delete.
+ * @returns The created {@link DeleteExpression}.
  */
 const createDeleteExpression = (expression) => (0, make_1.make)("DeleteExpression", { expression });
 exports.createDeleteExpression = createDeleteExpression;

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

@@ -1 +1 @@
-{"version":3,"file":"createDeleteExpression.mjs","sources":["createDeleteExpression.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createDeleteExpression = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link DeleteExpression}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param expression The expression.\n * @returns The created node.\n */\nconst createDeleteExpression = (expression) => (0, make_1.make)(\"DeleteExpression\", { expression });\nexports.createDeleteExpression = createDeleteExpression;\n//# sourceMappingURL=createDeleteExpression.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,MAAM,sBAAsB,GAAG,CAAC,UAAU,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,EAAE,UAAU,EAAE,CAAC;AACnG,OAAO,CAAC,sBAAsB,GAAG,sBAAsB"}
+{"version":3,"file":"createDeleteExpression.mjs","sources":["createDeleteExpression.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createDeleteExpression = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link DeleteExpression}: a `delete` of an operand.\n *\n * The printer writes the `delete` keyword followed by a single space and the\n * operand expression.\n *\n * Given operand `obj.prop`, the printer emits:\n *\n * ```ts\n * delete obj.prop;\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param expression The expression to delete.\n * @returns The created {@link DeleteExpression}.\n */\nconst createDeleteExpression = (expression) => (0, make_1.make)(\"DeleteExpression\", { expression });\nexports.createDeleteExpression = createDeleteExpression;\n//# sourceMappingURL=createDeleteExpression.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,MAAM,sBAAsB,GAAG,CAAC,UAAU,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,EAAE,UAAU,EAAE,CAAC;AACnG,OAAO,CAAC,sBAAsB,GAAG,sBAAsB"}

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

@@ -1,10 +1,19 @@
 import type { BinaryExpression, Expression } from "../../ast";
 /**
- * Convenience wrapper that builds the corresponding expression node.
+ * Create a {@link BinaryExpression} with the `/` operator: division.
+ *
+ * Shorthand for {@link createBinaryExpression} with the `SlashToken` operator.
+ * The printer surrounds the operator with a single space on each side.
+ *
+ * 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 createDivide: (left: Expression, right: Expression) => BinaryExpression;

package/lib/factory/expressions/createDivide.js

@@ -4,12 +4,21 @@ exports.createDivide = 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: division.
+ *
+ * Shorthand for {@link createBinaryExpression} with the `SlashToken` operator.
+ * The printer surrounds the operator with a single space on each side.
+ *
+ * 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 createDivide = (left, right) => (0, createBinaryExpression_1.createBinaryExpression)(left, syntax_1.SyntaxKind.SlashToken, right);
 exports.createDivide = createDivide;

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

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

package/lib/factory/expressions/createDivide.mjs

@@ -3,12 +3,21 @@ exports.createDivide = 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: division.
+ *
+ * Shorthand for {@link createBinaryExpression} with the `SlashToken` operator.
+ * The printer surrounds the operator with a single space on each side.
+ *
+ * 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 createDivide = (left, right) => (0, createBinaryExpression_1.createBinaryExpression)(left, syntax_1.SyntaxKind.SlashToken, right);
 exports.createDivide = createDivide;

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

@@ -1 +1 @@
-{"version":3,"file":"createDivide.mjs","sources":["createDivide.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createDivide = 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 createDivide = (left, right) => (0, createBinaryExpression_1.createBinaryExpression)(left, syntax_1.SyntaxKind.SlashToken, right);\nexports.createDivide = createDivide;\n//# sourceMappingURL=createDivide.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,YAAY,GAAG,MAAM;AAC7B,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,YAAY,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,wBAAwB,CAAC,sBAAsB,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC;AACvI,OAAO,CAAC,YAAY,GAAG,YAAY"}
+{"version":3,"file":"createDivide.mjs","sources":["createDivide.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createDivide = void 0;\nconst syntax_1 = require(\"../../syntax\");\nconst createBinaryExpression_1 = require(\"./createBinaryExpression\");\n/**\n * Create a {@link BinaryExpression} with the `/` operator: division.\n *\n * Shorthand for {@link createBinaryExpression} with the `SlashToken` operator.\n * The printer surrounds the operator with a single space on each side.\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 createDivide = (left, right) => (0, createBinaryExpression_1.createBinaryExpression)(left, syntax_1.SyntaxKind.SlashToken, right);\nexports.createDivide = createDivide;\n//# sourceMappingURL=createDivide.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,YAAY,GAAG,MAAM;AAC7B,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,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,wBAAwB,CAAC,sBAAsB,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC;AACvI,OAAO,CAAC,YAAY,GAAG,YAAY"}

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

@@ -1,11 +1,23 @@
 import type { ElementAccessChain, Expression, Token } from "../../ast";
 /**
- * Create a {@link ElementAccessChain}.
+ * Create an {@link ElementAccessChain}: a bracket access that participates in an
+ * optional chain.
+ *
+ * The `questionDotToken` is the `?.` token printed before the brackets. A
+ * numeric `index` is wrapped with {@link createNumericLiteral}; any other
+ * expression is used as the key directly. The printer wraps the key in square
+ * brackets.
+ *
+ * Given object `obj`, an optional `?.` token and index `0`, the printer emits:
+ *
+ * ```ts
+ * obj?.[0];
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
- * @param questionDotToken The questionDotToken.
- * @param index The index.
- * @returns The created node.
+ * @param expression The object expression.
+ * @param questionDotToken The `?.` token, if this link is optional.
+ * @param index The index or key.
+ * @returns The created {@link ElementAccessChain}.
  */
 export declare const createElementAccessChain: (expression: Expression, questionDotToken: Token | undefined, index: number | Expression) => ElementAccessChain;

package/lib/factory/expressions/createElementAccessChain.js

@@ -4,13 +4,25 @@ exports.createElementAccessChain = void 0;
 const make_1 = require("../internal/make");
 const createNumericLiteral_1 = require("../literals/createNumericLiteral");
 /**
- * Create a {@link ElementAccessChain}.
+ * Create an {@link ElementAccessChain}: a bracket access that participates in an
+ * optional chain.
+ *
+ * The `questionDotToken` is the `?.` token printed before the brackets. A
+ * numeric `index` is wrapped with {@link createNumericLiteral}; any other
+ * expression is used as the key directly. The printer wraps the key in square
+ * brackets.
+ *
+ * Given object `obj`, an optional `?.` token and index `0`, the printer emits:
+ *
+ * ```ts
+ * obj?.[0];
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
- * @param questionDotToken The questionDotToken.
- * @param index The index.
- * @returns The created node.
+ * @param expression The object expression.
+ * @param questionDotToken The `?.` token, if this link is optional.
+ * @param index The index or key.
+ * @returns The created {@link ElementAccessChain}.
  */
 const createElementAccessChain = (expression, questionDotToken, index) => (0, make_1.make)("ElementAccessChain", {
     expression,

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

@@ -1 +1 @@
-{"version":3,"file":"createElementAccessChain.js","sourceRoot":"","sources":["../../../src/factory/expressions/createElementAccessChain.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AACxC,2EAAwE;AAExE;;;;;;;;GAQG;AACI,MAAM,wBAAwB,GAAG,CACtC,UAAsB,EACtB,gBAAmC,EACnC,KAA0B,EACN,EAAE,CACtB,IAAA,WAAI,EAAC,oBAAoB,EAAE;IACzB,UAAU;IACV,gBAAgB;IAChB,kBAAkB,EAChB,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAA,2CAAoB,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;CAClE,CAAC,CAAC;AAVQ,QAAA,wBAAwB,GAAxB,wBAAwB,CAUhC"}
+{"version":3,"file":"createElementAccessChain.js","sourceRoot":"","sources":["../../../src/factory/expressions/createElementAccessChain.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AACxC,2EAAwE;AAExE;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,MAAM,wBAAwB,GAAG,CACtC,UAAsB,EACtB,gBAAmC,EACnC,KAA0B,EACN,EAAE,CACtB,IAAA,WAAI,EAAC,oBAAoB,EAAE;IACzB,UAAU;IACV,gBAAgB;IAChB,kBAAkB,EAChB,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAA,2CAAoB,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;CAClE,CAAC,CAAC;AAVQ,QAAA,wBAAwB,GAAxB,wBAAwB,CAUhC"}

package/lib/factory/expressions/createElementAccessChain.mjs

@@ -3,13 +3,25 @@ exports.createElementAccessChain = void 0;
 const make_1 = require("../internal/make");
 const createNumericLiteral_1 = require("../literals/createNumericLiteral");
 /**
- * Create a {@link ElementAccessChain}.
+ * Create an {@link ElementAccessChain}: a bracket access that participates in an
+ * optional chain.
+ *
+ * The `questionDotToken` is the `?.` token printed before the brackets. A
+ * numeric `index` is wrapped with {@link createNumericLiteral}; any other
+ * expression is used as the key directly. The printer wraps the key in square
+ * brackets.
+ *
+ * Given object `obj`, an optional `?.` token and index `0`, the printer emits:
+ *
+ * ```ts
+ * obj?.[0];
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
- * @param questionDotToken The questionDotToken.
- * @param index The index.
- * @returns The created node.
+ * @param expression The object expression.
+ * @param questionDotToken The `?.` token, if this link is optional.
+ * @param index The index or key.
+ * @returns The created {@link ElementAccessChain}.
  */
 const createElementAccessChain = (expression, questionDotToken, index) => (0, make_1.make)("ElementAccessChain", {
     expression,

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

@@ -1 +1 @@
-{"version":3,"file":"createElementAccessChain.mjs","sources":["createElementAccessChain.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createElementAccessChain = void 0;\nconst make_1 = require(\"../internal/make\");\nconst createNumericLiteral_1 = require(\"../literals/createNumericLiteral\");\n/**\n * Create a {@link ElementAccessChain}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param expression The expression.\n * @param questionDotToken The questionDotToken.\n * @param index The index.\n * @returns The created node.\n */\nconst createElementAccessChain = (expression, questionDotToken, index) => (0, make_1.make)(\"ElementAccessChain\", {\n    expression,\n    questionDotToken,\n    argumentExpression: typeof index === \"number\" ? (0, createNumericLiteral_1.createNumericLiteral)(index) : index,\n});\nexports.createElementAccessChain = createElementAccessChain;\n//# sourceMappingURL=createElementAccessChain.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,wBAAwB,GAAG,MAAM;AACzC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C,MAAM,sBAAsB,GAAG,OAAO,CAAC,kCAAkC,CAAC;AAC1E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,wBAAwB,GAAG,CAAC,UAAU,EAAE,gBAAgB,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,oBAAoB,EAAE;AACjH,IAAI,UAAU;AACd,IAAI,gBAAgB;AACpB,IAAI,kBAAkB,EAAE,OAAO,KAAK,KAAK,QAAQ,GAAG,IAAI,sBAAsB,CAAC,oBAAoB,EAAE,KAAK,CAAC,GAAG,KAAK;AACnH,CAAC,CAAC;AACF,OAAO,CAAC,wBAAwB,GAAG,wBAAwB"}
+{"version":3,"file":"createElementAccessChain.mjs","sources":["createElementAccessChain.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createElementAccessChain = void 0;\nconst make_1 = require(\"../internal/make\");\nconst createNumericLiteral_1 = require(\"../literals/createNumericLiteral\");\n/**\n * Create an {@link ElementAccessChain}: a bracket access that participates in an\n * optional chain.\n *\n * The `questionDotToken` is the `?.` token printed before the brackets. A\n * numeric `index` is wrapped with {@link createNumericLiteral}; any other\n * expression is used as the key directly. The printer wraps the key in square\n * brackets.\n *\n * Given object `obj`, an optional `?.` token and index `0`, the printer emits:\n *\n * ```ts\n * obj?.[0];\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param expression The object expression.\n * @param questionDotToken The `?.` token, if this link is optional.\n * @param index The index or key.\n * @returns The created {@link ElementAccessChain}.\n */\nconst createElementAccessChain = (expression, questionDotToken, index) => (0, make_1.make)(\"ElementAccessChain\", {\n    expression,\n    questionDotToken,\n    argumentExpression: typeof index === \"number\" ? (0, createNumericLiteral_1.createNumericLiteral)(index) : index,\n});\nexports.createElementAccessChain = createElementAccessChain;\n//# sourceMappingURL=createElementAccessChain.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,wBAAwB,GAAG,MAAM;AACzC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C,MAAM,sBAAsB,GAAG,OAAO,CAAC,kCAAkC,CAAC;AAC1E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,wBAAwB,GAAG,CAAC,UAAU,EAAE,gBAAgB,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,oBAAoB,EAAE;AACjH,IAAI,UAAU;AACd,IAAI,gBAAgB;AACpB,IAAI,kBAAkB,EAAE,OAAO,KAAK,KAAK,QAAQ,GAAG,IAAI,sBAAsB,CAAC,oBAAoB,EAAE,KAAK,CAAC,GAAG,KAAK;AACnH,CAAC,CAAC;AACF,OAAO,CAAC,wBAAwB,GAAG,wBAAwB"}

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

@@ -1,9 +1,19 @@
 import type { ElementAccessExpression, Expression } from "../../ast";
 /**
- * Create a {@link ElementAccessExpression}.
+ * Create an {@link ElementAccessExpression}: a `object[key]` bracket access.
+ *
+ * A numeric `index` is wrapped with {@link createNumericLiteral}; any other
+ * expression is used as the key directly. The printer wraps the key in square
+ * brackets, so a string key prints quoted (for example `obj["key"]`).
+ *
+ * Given object `obj` and index `0`, the printer emits:
+ *
+ * ```ts
+ * obj[0];
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
+ * @param expression The object expression.
  * @param index The index or key.
  * @returns The created {@link ElementAccessExpression}.
  */

package/lib/factory/expressions/createElementAccessExpression.js

@@ -4,10 +4,20 @@ exports.createElementAccessExpression = void 0;
 const make_1 = require("../internal/make");
 const createNumericLiteral_1 = require("../literals/createNumericLiteral");
 /**
- * Create a {@link ElementAccessExpression}.
+ * Create an {@link ElementAccessExpression}: a `object[key]` bracket access.
+ *
+ * A numeric `index` is wrapped with {@link createNumericLiteral}; any other
+ * expression is used as the key directly. The printer wraps the key in square
+ * brackets, so a string key prints quoted (for example `obj["key"]`).
+ *
+ * Given object `obj` and index `0`, the printer emits:
+ *
+ * ```ts
+ * obj[0];
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
+ * @param expression The object expression.
  * @param index The index or key.
  * @returns The created {@link ElementAccessExpression}.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"createElementAccessExpression.js","sourceRoot":"","sources":["../../../src/factory/expressions/createElementAccessExpression.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AACxC,2EAAwE;AAExE;;;;;;;GAOG;AACI,MAAM,6BAA6B,GAAG,CAC3C,UAAsB,EACtB,KAA0B,EACD,EAAE,CAC3B,IAAA,WAAI,EAAC,yBAAyB,EAAE;IAC9B,UAAU;IACV,kBAAkB,EAChB,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAA,2CAAoB,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;CAClE,CAAC,CAAC;AARQ,QAAA,6BAA6B,GAA7B,6BAA6B,CAQrC"}
+{"version":3,"file":"createElementAccessExpression.js","sourceRoot":"","sources":["../../../src/factory/expressions/createElementAccessExpression.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AACxC,2EAAwE;AAExE;;;;;;;;;;;;;;;;;GAiBG;AACI,MAAM,6BAA6B,GAAG,CAC3C,UAAsB,EACtB,KAA0B,EACD,EAAE,CAC3B,IAAA,WAAI,EAAC,yBAAyB,EAAE;IAC9B,UAAU;IACV,kBAAkB,EAChB,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAA,2CAAoB,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;CAClE,CAAC,CAAC;AARQ,QAAA,6BAA6B,GAA7B,6BAA6B,CAQrC"}

package/lib/factory/expressions/createElementAccessExpression.mjs

@@ -3,10 +3,20 @@ exports.createElementAccessExpression = void 0;
 const make_1 = require("../internal/make");
 const createNumericLiteral_1 = require("../literals/createNumericLiteral");
 /**
- * Create a {@link ElementAccessExpression}.
+ * Create an {@link ElementAccessExpression}: a `object[key]` bracket access.
+ *
+ * A numeric `index` is wrapped with {@link createNumericLiteral}; any other
+ * expression is used as the key directly. The printer wraps the key in square
+ * brackets, so a string key prints quoted (for example `obj["key"]`).
+ *
+ * Given object `obj` and index `0`, the printer emits:
+ *
+ * ```ts
+ * obj[0];
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param expression The expression.
+ * @param expression The object expression.
  * @param index The index or key.
  * @returns The created {@link ElementAccessExpression}.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"createElementAccessExpression.mjs","sources":["createElementAccessExpression.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createElementAccessExpression = void 0;\nconst make_1 = require(\"../internal/make\");\nconst createNumericLiteral_1 = require(\"../literals/createNumericLiteral\");\n/**\n * Create a {@link ElementAccessExpression}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param expression The expression.\n * @param index The index or key.\n * @returns The created {@link ElementAccessExpression}.\n */\nconst createElementAccessExpression = (expression, index) => (0, make_1.make)(\"ElementAccessExpression\", {\n    expression,\n    argumentExpression: typeof index === \"number\" ? (0, createNumericLiteral_1.createNumericLiteral)(index) : index,\n});\nexports.createElementAccessExpression = createElementAccessExpression;\n//# sourceMappingURL=createElementAccessExpression.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,MAAM,sBAAsB,GAAG,OAAO,CAAC,kCAAkC,CAAC;AAC1E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,6BAA6B,GAAG,CAAC,UAAU,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,yBAAyB,EAAE;AACzG,IAAI,UAAU;AACd,IAAI,kBAAkB,EAAE,OAAO,KAAK,KAAK,QAAQ,GAAG,IAAI,sBAAsB,CAAC,oBAAoB,EAAE,KAAK,CAAC,GAAG,KAAK;AACnH,CAAC,CAAC;AACF,OAAO,CAAC,6BAA6B,GAAG,6BAA6B"}
+{"version":3,"file":"createElementAccessExpression.mjs","sources":["createElementAccessExpression.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createElementAccessExpression = void 0;\nconst make_1 = require(\"../internal/make\");\nconst createNumericLiteral_1 = require(\"../literals/createNumericLiteral\");\n/**\n * Create an {@link ElementAccessExpression}: a `object[key]` bracket access.\n *\n * A numeric `index` is wrapped with {@link createNumericLiteral}; any other\n * expression is used as the key directly. The printer wraps the key in square\n * brackets, so a string key prints quoted (for example `obj[\"key\"]`).\n *\n * Given object `obj` and index `0`, the printer emits:\n *\n * ```ts\n * obj[0];\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param expression The object expression.\n * @param index The index or key.\n * @returns The created {@link ElementAccessExpression}.\n */\nconst createElementAccessExpression = (expression, index) => (0, make_1.make)(\"ElementAccessExpression\", {\n    expression,\n    argumentExpression: typeof index === \"number\" ? (0, createNumericLiteral_1.createNumericLiteral)(index) : index,\n});\nexports.createElementAccessExpression = createElementAccessExpression;\n//# sourceMappingURL=createElementAccessExpression.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,MAAM,sBAAsB,GAAG,OAAO,CAAC,kCAAkC,CAAC;AAC1E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,6BAA6B,GAAG,CAAC,UAAU,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,yBAAyB,EAAE;AACzG,IAAI,UAAU;AACd,IAAI,kBAAkB,EAAE,OAAO,KAAK,KAAK,QAAQ,GAAG,IAAI,sBAAsB,CAAC,oBAAoB,EAAE,KAAK,CAAC,GAAG,KAAK;AACnH,CAAC,CAAC;AACF,OAAO,CAAC,6BAA6B,GAAG,6BAA6B"}

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

@@ -1,10 +1,21 @@
 import type { BinaryExpression, Expression } from "../../ast";
 /**
- * Convenience wrapper that builds the corresponding expression node.
+ * Create a {@link BinaryExpression} with the `==` operator: loose equality with
+ * type coercion.
+ *
+ * Shorthand for {@link createBinaryExpression} with the `EqualsEqualsToken`
+ * operator. The printer surrounds the operator with a single space on each
+ * side.
+ *
+ * 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 createEquality: (left: Expression, right: Expression) => BinaryExpression;

package/lib/factory/expressions/createEquality.js

@@ -4,12 +4,23 @@ exports.createEquality = 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: loose equality with
+ * type coercion.
+ *
+ * Shorthand for {@link createBinaryExpression} with the `EqualsEqualsToken`
+ * operator. The printer surrounds the operator with a single space on each
+ * side.
+ *
+ * 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 createEquality = (left, right) => (0, createBinaryExpression_1.createBinaryExpression)(left, syntax_1.SyntaxKind.EqualsEqualsToken, right);
 exports.createEquality = createEquality;

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

@@ -1 +1 @@
-{"version":3,"file":"createEquality.js","sourceRoot":"","sources":["../../../src/factory/expressions/createEquality.ts"],"names":[],"mappings":";;;AACA,yCAA0C;AAC1C,qEAAkE;AAElE;;;;;;;GAOG;AACI,MAAM,cAAc,GAAG,CAC5B,IAAgB,EAChB,KAAiB,EACC,EAAE,CACpB,IAAA,+CAAsB,EAAC,IAAI,EAAE,mBAAU,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;AAJvD,QAAA,cAAc,GAAd,cAAc,CAIyC"}
+{"version":3,"file":"createEquality.js","sourceRoot":"","sources":["../../../src/factory/expressions/createEquality.ts"],"names":[],"mappings":";;;AACA,yCAA0C;AAC1C,qEAAkE;AAElE;;;;;;;;;;;;;;;;;;GAkBG;AACI,MAAM,cAAc,GAAG,CAC5B,IAAgB,EAChB,KAAiB,EACC,EAAE,CACpB,IAAA,+CAAsB,EAAC,IAAI,EAAE,mBAAU,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;AAJvD,QAAA,cAAc,GAAd,cAAc,CAIyC"}

package/lib/factory/expressions/createEquality.mjs

@@ -3,12 +3,23 @@ exports.createEquality = 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: loose equality with
+ * type coercion.
+ *
+ * Shorthand for {@link createBinaryExpression} with the `EqualsEqualsToken`
+ * operator. The printer surrounds the operator with a single space on each
+ * side.
+ *
+ * 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 createEquality = (left, right) => (0, createBinaryExpression_1.createBinaryExpression)(left, syntax_1.SyntaxKind.EqualsEqualsToken, right);
 exports.createEquality = createEquality;

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

@@ -1 +1 @@
-{"version":3,"file":"createEquality.mjs","sources":["createEquality.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createEquality = 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 createEquality = (left, right) => (0, createBinaryExpression_1.createBinaryExpression)(left, syntax_1.SyntaxKind.EqualsEqualsToken, right);\nexports.createEquality = createEquality;\n//# sourceMappingURL=createEquality.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,cAAc,GAAG,MAAM;AAC/B,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,cAAc,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,wBAAwB,CAAC,sBAAsB,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,iBAAiB,EAAE,KAAK,CAAC;AAChJ,OAAO,CAAC,cAAc,GAAG,cAAc"}
+{"version":3,"file":"createEquality.mjs","sources":["createEquality.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createEquality = void 0;\nconst syntax_1 = require(\"../../syntax\");\nconst createBinaryExpression_1 = require(\"./createBinaryExpression\");\n/**\n * Create a {@link BinaryExpression} with the `==` operator: loose equality with\n * type coercion.\n *\n * Shorthand for {@link createBinaryExpression} with the `EqualsEqualsToken`\n * operator. The printer surrounds the operator with a single space on each\n * side.\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 createEquality = (left, right) => (0, createBinaryExpression_1.createBinaryExpression)(left, syntax_1.SyntaxKind.EqualsEqualsToken, right);\nexports.createEquality = createEquality;\n//# sourceMappingURL=createEquality.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,cAAc,GAAG,MAAM;AAC/B,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,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,wBAAwB,CAAC,sBAAsB,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,iBAAiB,EAAE,KAAK,CAAC;AAChJ,OAAO,CAAC,cAAc,GAAG,cAAc"}

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

@@ -1,10 +1,20 @@
 import type { BinaryExpression, Expression } from "../../ast";
 /**
- * Convenience wrapper that builds the corresponding expression node.
+ * Create a {@link BinaryExpression} with the `**` operator: exponentiation.
+ *
+ * Shorthand for {@link createBinaryExpression} with the `AsteriskAsteriskToken`
+ * operator. The printer surrounds the operator with a single space on each
+ * side.
+ *
+ * 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 base operand.
+ * @param right The exponent operand.
+ * @returns The created {@link BinaryExpression}.
  */
 export declare const createExponent: (left: Expression, right: Expression) => BinaryExpression;

package/lib/factory/expressions/createExponent.js

@@ -4,12 +4,22 @@ exports.createExponent = 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: exponentiation.
+ *
+ * Shorthand for {@link createBinaryExpression} with the `AsteriskAsteriskToken`
+ * operator. The printer surrounds the operator with a single space on each
+ * side.
+ *
+ * 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 base operand.
+ * @param right The exponent operand.
+ * @returns The created {@link BinaryExpression}.
  */
 const createExponent = (left, right) => (0, createBinaryExpression_1.createBinaryExpression)(left, syntax_1.SyntaxKind.AsteriskAsteriskToken, right);
 exports.createExponent = createExponent;

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

@@ -1 +1 @@
-{"version":3,"file":"createExponent.js","sourceRoot":"","sources":["../../../src/factory/expressions/createExponent.ts"],"names":[],"mappings":";;;AACA,yCAA0C;AAC1C,qEAAkE;AAElE;;;;;;;GAOG;AACI,MAAM,cAAc,GAAG,CAC5B,IAAgB,EAChB,KAAiB,EACC,EAAE,CACpB,IAAA,+CAAsB,EAAC,IAAI,EAAE,mBAAU,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;AAJ3D,QAAA,cAAc,GAAd,cAAc,CAI6C"}
+{"version":3,"file":"createExponent.js","sourceRoot":"","sources":["../../../src/factory/expressions/createExponent.ts"],"names":[],"mappings":";;;AACA,yCAA0C;AAC1C,qEAAkE;AAElE;;;;;;;;;;;;;;;;;GAiBG;AACI,MAAM,cAAc,GAAG,CAC5B,IAAgB,EAChB,KAAiB,EACC,EAAE,CACpB,IAAA,+CAAsB,EAAC,IAAI,EAAE,mBAAU,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;AAJ3D,QAAA,cAAc,GAAd,cAAc,CAI6C"}