@ttsc/factory 0.15.6 → 0.15.7

package/lib/factory/names/createUniqueName.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUniqueName = void 0;
+const createIdentifier_1 = require("./createIdentifier");
+/**
+ * Create a unique identifier name as a plain {@link Identifier}.
+ *
+ * The legacy compiler uses a stateful name generator that guarantees the
+ * returned identifier is unique within its scope. This package is stateless, so
+ * this is a simplified placeholder: it does not guarantee uniqueness, it just
+ * returns the given `text` with the optional `prefix` and `suffix` wrapped
+ * around it.
+ *
+ * The `flags` parameter belongs to the stateful generator and is accepted for
+ * signature parity but ignored. Two calls with the same arguments produce the
+ * same name, so the caller is responsible for avoiding collisions.
+ *
+ * With `text` of `base` and no prefix or suffix, this prints:
+ *
+ * ```ts
+ * base;
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param text The base name text.
+ * @param _flags Ignored; kept for signature parity.
+ * @param prefix An optional name prefix.
+ * @param suffix An optional name suffix.
+ * @returns The created {@link Identifier}.
+ */
+const createUniqueName = (text, _flags, prefix, suffix) => (0, createIdentifier_1.createIdentifier)(`${prefix ?? ""}${text}${suffix ?? ""}`);
+exports.createUniqueName = createUniqueName;
+//# sourceMappingURL=createUniqueName.js.map

package/lib/factory/names/createUniqueName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUniqueName.js","sourceRoot":"","sources":["../../../src/factory/names/createUniqueName.ts"],"names":[],"mappings":";;;AACA,yDAAsD;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACI,MAAM,gBAAgB,GAAG,CAC9B,IAAY,EACZ,MAAe,EACf,MAAe,EACf,MAAe,EACH,EAAE,CAAC,IAAA,mCAAgB,EAAC,GAAG,MAAM,IAAI,EAAE,GAAG,IAAI,GAAG,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC;AAL9D,QAAA,gBAAgB,GAAhB,gBAAgB,CAK8C"}

package/lib/factory/names/createUniqueName.mjs

@@ -0,0 +1,32 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUniqueName = void 0;
+const createIdentifier_1 = require("./createIdentifier");
+/**
+ * Create a unique identifier name as a plain {@link Identifier}.
+ *
+ * The legacy compiler uses a stateful name generator that guarantees the
+ * returned identifier is unique within its scope. This package is stateless, so
+ * this is a simplified placeholder: it does not guarantee uniqueness, it just
+ * returns the given `text` with the optional `prefix` and `suffix` wrapped
+ * around it.
+ *
+ * The `flags` parameter belongs to the stateful generator and is accepted for
+ * signature parity but ignored. Two calls with the same arguments produce the
+ * same name, so the caller is responsible for avoiding collisions.
+ *
+ * With `text` of `base` and no prefix or suffix, this prints:
+ *
+ * ```ts
+ * base;
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param text The base name text.
+ * @param _flags Ignored; kept for signature parity.
+ * @param prefix An optional name prefix.
+ * @param suffix An optional name suffix.
+ * @returns The created {@link Identifier}.
+ */
+const createUniqueName = (text, _flags, prefix, suffix) => (0, createIdentifier_1.createIdentifier)(`${prefix ?? ""}${text}${suffix ?? ""}`);
+exports.createUniqueName = createUniqueName;
+//# sourceMappingURL=createUniqueName.mjs.map

package/lib/factory/names/createUniqueName.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUniqueName.mjs","sources":["createUniqueName.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createUniqueName = void 0;\nconst createIdentifier_1 = require(\"./createIdentifier\");\n/**\n * Create a unique identifier name as a plain {@link Identifier}.\n *\n * The legacy compiler uses a stateful name generator that guarantees the\n * returned identifier is unique within its scope. This package is stateless, so\n * this is a simplified placeholder: it does not guarantee uniqueness, it just\n * returns the given `text` with the optional `prefix` and `suffix` wrapped\n * around it.\n *\n * The `flags` parameter belongs to the stateful generator and is accepted for\n * signature parity but ignored. Two calls with the same arguments produce the\n * same name, so the caller is responsible for avoiding collisions.\n *\n * With `text` of `base` and no prefix or suffix, this prints:\n *\n * ```ts\n * base;\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param text The base name text.\n * @param _flags Ignored; kept for signature parity.\n * @param prefix An optional name prefix.\n * @param suffix An optional name suffix.\n * @returns The created {@link Identifier}.\n */\nconst createUniqueName = (text, _flags, prefix, suffix) => (0, createIdentifier_1.createIdentifier)(`${prefix ?? \"\"}${text}${suffix ?? \"\"}`);\nexports.createUniqueName = createUniqueName;\n//# sourceMappingURL=createUniqueName.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,gBAAgB,GAAG,MAAM;AACjC,MAAM,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;AACxD;AACA;AACA;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,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,kBAAkB,CAAC,gBAAgB,EAAE,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5I,OAAO,CAAC,gBAAgB,GAAG,gBAAgB"}

package/lib/factory/names/createUniquePrivateName.d.ts

@@ -0,0 +1,25 @@
+import type { PrivateIdentifier } from "../../ast";
+/**
+ * Create a unique private identifier name as a plain {@link PrivateIdentifier}.
+ *
+ * The legacy compiler uses a stateful name generator that guarantees the
+ * returned private identifier is unique within its scope. This package is
+ * stateless, so this is a simplified placeholder: it does not guarantee
+ * uniqueness, it assembles a name from the optional `prefix`, the `text` (or
+ * the fallback `_unique` when omitted), and the optional `suffix`, then
+ * delegates to {@link createPrivateIdentifier}. Any leading `#` on `text` is
+ * stripped first so the delegate adds exactly one.
+ *
+ * With no arguments, the fallback applies and this prints:
+ *
+ * ```ts
+ * #_unique;
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param text The base name text, if any.
+ * @param prefix An optional name prefix.
+ * @param suffix An optional name suffix.
+ * @returns The created {@link PrivateIdentifier}.
+ */
+export declare const createUniquePrivateName: (text?: string, prefix?: string, suffix?: string) => PrivateIdentifier;

package/lib/factory/names/createUniquePrivateName.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUniquePrivateName = void 0;
+const createPrivateIdentifier_1 = require("./createPrivateIdentifier");
+/**
+ * Create a unique private identifier name as a plain {@link PrivateIdentifier}.
+ *
+ * The legacy compiler uses a stateful name generator that guarantees the
+ * returned private identifier is unique within its scope. This package is
+ * stateless, so this is a simplified placeholder: it does not guarantee
+ * uniqueness, it assembles a name from the optional `prefix`, the `text` (or
+ * the fallback `_unique` when omitted), and the optional `suffix`, then
+ * delegates to {@link createPrivateIdentifier}. Any leading `#` on `text` is
+ * stripped first so the delegate adds exactly one.
+ *
+ * With no arguments, the fallback applies and this prints:
+ *
+ * ```ts
+ * #_unique;
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param text The base name text, if any.
+ * @param prefix An optional name prefix.
+ * @param suffix An optional name suffix.
+ * @returns The created {@link PrivateIdentifier}.
+ */
+const createUniquePrivateName = (text, prefix, suffix) => (0, createPrivateIdentifier_1.createPrivateIdentifier)(`#${prefix ?? ""}${text ? text.replace(/^#/, "") : "_unique"}${suffix ?? ""}`);
+exports.createUniquePrivateName = createUniquePrivateName;
+//# sourceMappingURL=createUniquePrivateName.js.map

package/lib/factory/names/createUniquePrivateName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUniquePrivateName.js","sourceRoot":"","sources":["../../../src/factory/names/createUniquePrivateName.ts"],"names":[],"mappings":";;;AACA,uEAAoE;AAEpE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACI,MAAM,uBAAuB,GAAG,CACrC,IAAa,EACb,MAAe,EACf,MAAe,EACI,EAAE,CACrB,IAAA,iDAAuB,EACrB,IAAI,MAAM,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,IAAI,EAAE,EAAE,CAC9E,CAAC;AAPS,QAAA,uBAAuB,GAAvB,uBAAuB,CAOhC"}

package/lib/factory/names/createUniquePrivateName.mjs

@@ -0,0 +1,29 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUniquePrivateName = void 0;
+const createPrivateIdentifier_1 = require("./createPrivateIdentifier");
+/**
+ * Create a unique private identifier name as a plain {@link PrivateIdentifier}.
+ *
+ * The legacy compiler uses a stateful name generator that guarantees the
+ * returned private identifier is unique within its scope. This package is
+ * stateless, so this is a simplified placeholder: it does not guarantee
+ * uniqueness, it assembles a name from the optional `prefix`, the `text` (or
+ * the fallback `_unique` when omitted), and the optional `suffix`, then
+ * delegates to {@link createPrivateIdentifier}. Any leading `#` on `text` is
+ * stripped first so the delegate adds exactly one.
+ *
+ * With no arguments, the fallback applies and this prints:
+ *
+ * ```ts
+ * #_unique;
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param text The base name text, if any.
+ * @param prefix An optional name prefix.
+ * @param suffix An optional name suffix.
+ * @returns The created {@link PrivateIdentifier}.
+ */
+const createUniquePrivateName = (text, prefix, suffix) => (0, createPrivateIdentifier_1.createPrivateIdentifier)(`#${prefix ?? ""}${text ? text.replace(/^#/, "") : "_unique"}${suffix ?? ""}`);
+exports.createUniquePrivateName = createUniquePrivateName;
+//# sourceMappingURL=createUniquePrivateName.mjs.map

package/lib/factory/names/createUniquePrivateName.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUniquePrivateName.mjs","sources":["createUniquePrivateName.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createUniquePrivateName = void 0;\nconst createPrivateIdentifier_1 = require(\"./createPrivateIdentifier\");\n/**\n * Create a unique private identifier name as a plain {@link PrivateIdentifier}.\n *\n * The legacy compiler uses a stateful name generator that guarantees the\n * returned private identifier is unique within its scope. This package is\n * stateless, so this is a simplified placeholder: it does not guarantee\n * uniqueness, it assembles a name from the optional `prefix`, the `text` (or\n * the fallback `_unique` when omitted), and the optional `suffix`, then\n * delegates to {@link createPrivateIdentifier}. Any leading `#` on `text` is\n * stripped first so the delegate adds exactly one.\n *\n * With no arguments, the fallback applies and this prints:\n *\n * ```ts\n * #_unique;\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param text The base name text, if any.\n * @param prefix An optional name prefix.\n * @param suffix An optional name suffix.\n * @returns The created {@link PrivateIdentifier}.\n */\nconst createUniquePrivateName = (text, prefix, suffix) => (0, createPrivateIdentifier_1.createPrivateIdentifier)(`#${prefix ?? \"\"}${text ? text.replace(/^#/, \"\") : \"_unique\"}${suffix ?? \"\"}`);\nexports.createUniquePrivateName = createUniquePrivateName;\n//# sourceMappingURL=createUniquePrivateName.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,uBAAuB,GAAG,MAAM;AACxC,MAAM,yBAAyB,GAAG,OAAO,CAAC,2BAA2B,CAAC;AACtE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,uBAAuB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,yBAAyB,CAAC,uBAAuB,EAAE,CAAC,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;AAC/L,OAAO,CAAC,uBAAuB,GAAG,uBAAuB"}

package/lib/factory/statements/createBlock.d.ts

@@ -1,6 +1,21 @@
 import type { Block, Statement } from "../../ast";
 /**
- * Create a {@link Block}.
+ * Create a {@link Block}: a `{ ... }` statement block.
+ *
+ * The `statements` become the body, in order. The `multiLine` flag controls how
+ * the printer lays the block out: when `true` (the default here), each
+ * statement sits on its own indented line between braces; when `false`, the
+ * printer keeps the body compact on a single line.
+ *
+ * With `statements` printing `a()` and `b()` and `multiLine` left at its
+ * default, the result is:
+ *
+ * ```ts
+ * {
+ *   a();
+ *   b();
+ * }
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param statements The statements.

package/lib/factory/statements/createBlock.js

@@ -3,7 +3,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBlock = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link Block}.
+ * Create a {@link Block}: a `{ ... }` statement block.
+ *
+ * The `statements` become the body, in order. The `multiLine` flag controls how
+ * the printer lays the block out: when `true` (the default here), each
+ * statement sits on its own indented line between braces; when `false`, the
+ * printer keeps the body compact on a single line.
+ *
+ * With `statements` printing `a()` and `b()` and `multiLine` left at its
+ * default, the result is:
+ *
+ * ```ts
+ * {
+ *   a();
+ *   b();
+ * }
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param statements The statements.

package/lib/factory/statements/createBlock.js.map

@@ -1 +1 @@
-{"version":3,"file":"createBlock.js","sourceRoot":"","sources":["../../../src/factory/statements/createBlock.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;GAOG;AACI,MAAM,WAAW,GAAG,CACzB,UAAgC,EAChC,SAAmB,EACZ,EAAE,CAAC,IAAA,WAAI,EAAC,OAAO,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC;AAH3D,QAAA,WAAW,GAAX,WAAW,CAGgD"}
+{"version":3,"file":"createBlock.js","sourceRoot":"","sources":["../../../src/factory/statements/createBlock.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACI,MAAM,WAAW,GAAG,CACzB,UAAgC,EAChC,SAAmB,EACZ,EAAE,CAAC,IAAA,WAAI,EAAC,OAAO,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC;AAH3D,QAAA,WAAW,GAAX,WAAW,CAGgD"}

package/lib/factory/statements/createBlock.mjs

@@ -2,7 +2,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBlock = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link Block}.
+ * Create a {@link Block}: a `{ ... }` statement block.
+ *
+ * The `statements` become the body, in order. The `multiLine` flag controls how
+ * the printer lays the block out: when `true` (the default here), each
+ * statement sits on its own indented line between braces; when `false`, the
+ * printer keeps the body compact on a single line.
+ *
+ * With `statements` printing `a()` and `b()` and `multiLine` left at its
+ * default, the result is:
+ *
+ * ```ts
+ * {
+ *   a();
+ *   b();
+ * }
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param statements The statements.

package/lib/factory/statements/createBlock.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createBlock.mjs","sources":["createBlock.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createBlock = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link Block}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param statements The statements.\n * @param multiLine When `true`, print one entry per line.\n * @returns The created {@link Block}.\n */\nconst createBlock = (statements, multiLine) => (0, make_1.make)(\"Block\", { statements, multiLine: multiLine ?? true });\nexports.createBlock = createBlock;\n//# sourceMappingURL=createBlock.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,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,SAAS,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,IAAI,IAAI,EAAE,CAAC;AACtH,OAAO,CAAC,WAAW,GAAG,WAAW"}
+{"version":3,"file":"createBlock.mjs","sources":["createBlock.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createBlock = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link Block}: a `{ ... }` statement block.\n *\n * The `statements` become the body, in order. The `multiLine` flag controls how\n * the printer lays the block out: when `true` (the default here), each\n * statement sits on its own indented line between braces; when `false`, the\n * printer keeps the body compact on a single line.\n *\n * With `statements` printing `a()` and `b()` and `multiLine` left at its\n * default, the result is:\n *\n * ```ts\n * {\n *   a();\n *   b();\n * }\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param statements The statements.\n * @param multiLine When `true`, print one entry per line.\n * @returns The created {@link Block}.\n */\nconst createBlock = (statements, multiLine) => (0, make_1.make)(\"Block\", { statements, multiLine: multiLine ?? true });\nexports.createBlock = createBlock;\n//# sourceMappingURL=createBlock.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,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,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,SAAS,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,IAAI,IAAI,EAAE,CAAC;AACtH,OAAO,CAAC,WAAW,GAAG,WAAW"}

package/lib/factory/statements/createBreakStatement.d.ts

@@ -1,6 +1,21 @@
 import type { BreakStatement, Identifier } from "../../ast";
 /**
- * Create a {@link BreakStatement}.
+ * Create a {@link BreakStatement}: a `break;` statement.
+ *
+ * The optional `label` names an enclosing labeled statement to break out of. A
+ * string is wrapped into an identifier; pass nothing for a plain `break`.
+ *
+ * With no label the result is:
+ *
+ * ```ts
+ * break;
+ * ```
+ *
+ * With `label` of `outer` the result is:
+ *
+ * ```ts
+ * break outer;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param label The label.

package/lib/factory/statements/createBreakStatement.js

@@ -4,7 +4,22 @@ exports.createBreakStatement = void 0;
 const asName_1 = require("../internal/asName");
 const make_1 = require("../internal/make");
 /**
- * Create a {@link BreakStatement}.
+ * Create a {@link BreakStatement}: a `break;` statement.
+ *
+ * The optional `label` names an enclosing labeled statement to break out of. A
+ * string is wrapped into an identifier; pass nothing for a plain `break`.
+ *
+ * With no label the result is:
+ *
+ * ```ts
+ * break;
+ * ```
+ *
+ * With `label` of `outer` the result is:
+ *
+ * ```ts
+ * break outer;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param label The label.

package/lib/factory/statements/createBreakStatement.js.map

@@ -1 +1 @@
-{"version":3,"file":"createBreakStatement.js","sourceRoot":"","sources":["../../../src/factory/statements/createBreakStatement.ts"],"names":[],"mappings":";;;AACA,+CAA4C;AAC5C,2CAAwC;AAExC;;;;;;GAMG;AACI,MAAM,oBAAoB,GAAG,CAClC,KAA2B,EACX,EAAE,CAClB,IAAA,WAAI,EAAC,gBAAgB,EAAE;IACrB,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,eAAM,EAAC,KAAK,CAAC;CACvD,CAAC,CAAC;AALQ,QAAA,oBAAoB,GAApB,oBAAoB,CAK5B"}
+{"version":3,"file":"createBreakStatement.js","sourceRoot":"","sources":["../../../src/factory/statements/createBreakStatement.ts"],"names":[],"mappings":";;;AACA,+CAA4C;AAC5C,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,MAAM,oBAAoB,GAAG,CAClC,KAA2B,EACX,EAAE,CAClB,IAAA,WAAI,EAAC,gBAAgB,EAAE;IACrB,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,eAAM,EAAC,KAAK,CAAC;CACvD,CAAC,CAAC;AALQ,QAAA,oBAAoB,GAApB,oBAAoB,CAK5B"}

package/lib/factory/statements/createBreakStatement.mjs

@@ -3,7 +3,22 @@ exports.createBreakStatement = void 0;
 const asName_1 = require("../internal/asName");
 const make_1 = require("../internal/make");
 /**
- * Create a {@link BreakStatement}.
+ * Create a {@link BreakStatement}: a `break;` statement.
+ *
+ * The optional `label` names an enclosing labeled statement to break out of. A
+ * string is wrapped into an identifier; pass nothing for a plain `break`.
+ *
+ * With no label the result is:
+ *
+ * ```ts
+ * break;
+ * ```
+ *
+ * With `label` of `outer` the result is:
+ *
+ * ```ts
+ * break outer;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param label The label.

package/lib/factory/statements/createBreakStatement.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createBreakStatement.mjs","sources":["createBreakStatement.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createBreakStatement = void 0;\nconst asName_1 = require(\"../internal/asName\");\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link BreakStatement}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param label The label.\n * @returns The created {@link BreakStatement}.\n */\nconst createBreakStatement = (label) => (0, make_1.make)(\"BreakStatement\", {\n    label: label === undefined ? undefined : (0, asName_1.asName)(label),\n});\nexports.createBreakStatement = createBreakStatement;\n//# sourceMappingURL=createBreakStatement.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,QAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC;AAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,oBAAoB,GAAG,CAAC,KAAK,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE;AAC3E,IAAI,KAAK,EAAE,KAAK,KAAK,SAAS,GAAG,SAAS,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;AACxE,CAAC,CAAC;AACF,OAAO,CAAC,oBAAoB,GAAG,oBAAoB"}
+{"version":3,"file":"createBreakStatement.mjs","sources":["createBreakStatement.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createBreakStatement = void 0;\nconst asName_1 = require(\"../internal/asName\");\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link BreakStatement}: a `break;` statement.\n *\n * The optional `label` names an enclosing labeled statement to break out of. A\n * string is wrapped into an identifier; pass nothing for a plain `break`.\n *\n * With no label the result is:\n *\n * ```ts\n * break;\n * ```\n *\n * With `label` of `outer` the result is:\n *\n * ```ts\n * break outer;\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param label The label.\n * @returns The created {@link BreakStatement}.\n */\nconst createBreakStatement = (label) => (0, make_1.make)(\"BreakStatement\", {\n    label: label === undefined ? undefined : (0, asName_1.asName)(label),\n});\nexports.createBreakStatement = createBreakStatement;\n//# sourceMappingURL=createBreakStatement.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,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,oBAAoB,GAAG,CAAC,KAAK,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE;AAC3E,IAAI,KAAK,EAAE,KAAK,KAAK,SAAS,GAAG,SAAS,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;AACxE,CAAC,CAAC;AACF,OAAO,CAAC,oBAAoB,GAAG,oBAAoB"}

package/lib/factory/statements/createCaseBlock.d.ts

@@ -1,6 +1,23 @@
 import type { CaseBlock, CaseOrDefaultClause } from "../../ast";
 /**
- * Create a {@link CaseBlock}.
+ * Create a {@link CaseBlock}: the braced body of a switch statement.
+ *
+ * The `clauses` are the `case` and `default` arms, printed in the given order
+ * between braces. This is the body you hand to {@link createSwitchStatement}; on
+ * its own it carries no switch subject.
+ *
+ * With `clauses` of a `case 1:` arm (calling `a()` then `break`) and a
+ * `default:` arm (calling `b()`), the result is:
+ *
+ * ```ts
+ * {
+ *   case 1:
+ *     a();
+ *     break;
+ *   default:
+ *     b();
+ * }
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param clauses The clauses.

package/lib/factory/statements/createCaseBlock.js

@@ -3,7 +3,24 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCaseBlock = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link CaseBlock}.
+ * Create a {@link CaseBlock}: the braced body of a switch statement.
+ *
+ * The `clauses` are the `case` and `default` arms, printed in the given order
+ * between braces. This is the body you hand to {@link createSwitchStatement}; on
+ * its own it carries no switch subject.
+ *
+ * With `clauses` of a `case 1:` arm (calling `a()` then `break`) and a
+ * `default:` arm (calling `b()`), the result is:
+ *
+ * ```ts
+ * {
+ *   case 1:
+ *     a();
+ *     break;
+ *   default:
+ *     b();
+ * }
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param clauses The clauses.

package/lib/factory/statements/createCaseBlock.js.map

@@ -1 +1 @@
-{"version":3,"file":"createCaseBlock.js","sourceRoot":"","sources":["../../../src/factory/statements/createCaseBlock.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;GAMG;AACI,MAAM,eAAe,GAAG,CAC7B,OAAuC,EAC5B,EAAE,CAAC,IAAA,WAAI,EAAC,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAFlC,QAAA,eAAe,GAAf,eAAe,CAEmB"}
+{"version":3,"file":"createCaseBlock.js","sourceRoot":"","sources":["../../../src/factory/statements/createCaseBlock.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,MAAM,eAAe,GAAG,CAC7B,OAAuC,EAC5B,EAAE,CAAC,IAAA,WAAI,EAAC,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAFlC,QAAA,eAAe,GAAf,eAAe,CAEmB"}

package/lib/factory/statements/createCaseBlock.mjs

@@ -2,7 +2,24 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCaseBlock = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link CaseBlock}.
+ * Create a {@link CaseBlock}: the braced body of a switch statement.
+ *
+ * The `clauses` are the `case` and `default` arms, printed in the given order
+ * between braces. This is the body you hand to {@link createSwitchStatement}; on
+ * its own it carries no switch subject.
+ *
+ * With `clauses` of a `case 1:` arm (calling `a()` then `break`) and a
+ * `default:` arm (calling `b()`), the result is:
+ *
+ * ```ts
+ * {
+ *   case 1:
+ *     a();
+ *     break;
+ *   default:
+ *     b();
+ * }
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param clauses The clauses.

package/lib/factory/statements/createCaseBlock.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createCaseBlock.mjs","sources":["createCaseBlock.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createCaseBlock = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link CaseBlock}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param clauses The clauses.\n * @returns The created {@link CaseBlock}.\n */\nconst createCaseBlock = (clauses) => (0, make_1.make)(\"CaseBlock\", { clauses });\nexports.createCaseBlock = createCaseBlock;\n//# sourceMappingURL=createCaseBlock.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,MAAM,eAAe,GAAG,CAAC,OAAO,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC;AAC/E,OAAO,CAAC,eAAe,GAAG,eAAe"}
+{"version":3,"file":"createCaseBlock.mjs","sources":["createCaseBlock.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createCaseBlock = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link CaseBlock}: the braced body of a switch statement.\n *\n * The `clauses` are the `case` and `default` arms, printed in the given order\n * between braces. This is the body you hand to {@link createSwitchStatement}; on\n * its own it carries no switch subject.\n *\n * With `clauses` of a `case 1:` arm (calling `a()` then `break`) and a\n * `default:` arm (calling `b()`), the result is:\n *\n * ```ts\n * {\n *   case 1:\n *     a();\n *     break;\n *   default:\n *     b();\n * }\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param clauses The clauses.\n * @returns The created {@link CaseBlock}.\n */\nconst createCaseBlock = (clauses) => (0, make_1.make)(\"CaseBlock\", { clauses });\nexports.createCaseBlock = createCaseBlock;\n//# sourceMappingURL=createCaseBlock.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,OAAO,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC;AAC/E,OAAO,CAAC,eAAe,GAAG,eAAe"}

package/lib/factory/statements/createCaseClause.d.ts

@@ -1,6 +1,20 @@
 import type { CaseClause, Expression, Statement } from "../../ast";
 /**
- * Create a {@link CaseClause}.
+ * Create a {@link CaseClause}: one `case ...:` arm of a switch.
+ *
+ * The `expression` is the value matched against the switch subject, and
+ * `statements` is the body that runs on a match. Fall-through is the default,
+ * so include an explicit `break` in `statements` when you want the arm to
+ * stop.
+ *
+ * With `expression` of `1` and `statements` of `a()` followed by a `break`, the
+ * result is:
+ *
+ * ```ts
+ * case 1:
+ *   a();
+ *   break;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param expression The expression.

package/lib/factory/statements/createCaseClause.js

@@ -3,7 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCaseClause = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link CaseClause}.
+ * Create a {@link CaseClause}: one `case ...:` arm of a switch.
+ *
+ * The `expression` is the value matched against the switch subject, and
+ * `statements` is the body that runs on a match. Fall-through is the default,
+ * so include an explicit `break` in `statements` when you want the arm to
+ * stop.
+ *
+ * With `expression` of `1` and `statements` of `a()` followed by a `break`, the
+ * result is:
+ *
+ * ```ts
+ * case 1:
+ *   a();
+ *   break;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param expression The expression.

package/lib/factory/statements/createCaseClause.js.map

@@ -1 +1 @@
-{"version":3,"file":"createCaseClause.js","sourceRoot":"","sources":["../../../src/factory/statements/createCaseClause.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;GAOG;AACI,MAAM,gBAAgB,GAAG,CAC9B,UAAsB,EACtB,UAAgC,EACpB,EAAE,CAAC,IAAA,WAAI,EAAC,YAAY,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;AAHnD,QAAA,gBAAgB,GAAhB,gBAAgB,CAGmC"}
+{"version":3,"file":"createCaseClause.js","sourceRoot":"","sources":["../../../src/factory/statements/createCaseClause.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,MAAM,gBAAgB,GAAG,CAC9B,UAAsB,EACtB,UAAgC,EACpB,EAAE,CAAC,IAAA,WAAI,EAAC,YAAY,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;AAHnD,QAAA,gBAAgB,GAAhB,gBAAgB,CAGmC"}

package/lib/factory/statements/createCaseClause.mjs

@@ -2,7 +2,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCaseClause = void 0;
 const make_1 = require("../internal/make");
 /**
- * Create a {@link CaseClause}.
+ * Create a {@link CaseClause}: one `case ...:` arm of a switch.
+ *
+ * The `expression` is the value matched against the switch subject, and
+ * `statements` is the body that runs on a match. Fall-through is the default,
+ * so include an explicit `break` in `statements` when you want the arm to
+ * stop.
+ *
+ * With `expression` of `1` and `statements` of `a()` followed by a `break`, the
+ * result is:
+ *
+ * ```ts
+ * case 1:
+ *   a();
+ *   break;
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param expression The expression.

package/lib/factory/statements/createCaseClause.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createCaseClause.mjs","sources":["createCaseClause.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createCaseClause = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link CaseClause}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param expression The expression.\n * @param statements The statements.\n * @returns The created {@link CaseClause}.\n */\nconst createCaseClause = (expression, statements) => (0, make_1.make)(\"CaseClause\", { expression, statements });\nexports.createCaseClause = createCaseClause;\n//# sourceMappingURL=createCaseClause.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,gBAAgB,GAAG,MAAM;AACjC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AAC/G,OAAO,CAAC,gBAAgB,GAAG,gBAAgB"}
+{"version":3,"file":"createCaseClause.mjs","sources":["createCaseClause.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createCaseClause = void 0;\nconst make_1 = require(\"../internal/make\");\n/**\n * Create a {@link CaseClause}: one `case ...:` arm of a switch.\n *\n * The `expression` is the value matched against the switch subject, and\n * `statements` is the body that runs on a match. Fall-through is the default,\n * so include an explicit `break` in `statements` when you want the arm to\n * stop.\n *\n * With `expression` of `1` and `statements` of `a()` followed by a `break`, the\n * result is:\n *\n * ```ts\n * case 1:\n *   a();\n *   break;\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param expression The expression.\n * @param statements The statements.\n * @returns The created {@link CaseClause}.\n */\nconst createCaseClause = (expression, statements) => (0, make_1.make)(\"CaseClause\", { expression, statements });\nexports.createCaseClause = createCaseClause;\n//# sourceMappingURL=createCaseClause.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,gBAAgB,GAAG,MAAM;AACjC,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,gBAAgB,GAAG,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AAC/G,OAAO,CAAC,gBAAgB,GAAG,gBAAgB"}

package/lib/factory/statements/createCatchClause.d.ts

@@ -1,6 +1,21 @@
 import type { Block, CatchClause, VariableDeclaration } from "../../ast";
 /**
- * Create a {@link CatchClause}.
+ * Create a {@link CatchClause}: the `catch (...) { ... }` arm of a try.
+ *
+ * The `variableDeclaration` binds the caught value. Pass a string for the
+ * common `catch (e)` case and it is turned into a bare binding; pass a full
+ * {@link VariableDeclaration} when you need a type or destructuring pattern;
+ * pass `undefined` for the binding-less `catch { ... }` form. The `block` is
+ * the handler body.
+ *
+ * With `variableDeclaration` of `e` and a `block` calling `handle(e)`, the
+ * result is:
+ *
+ * ```ts
+ * catch (e) {
+ *   handle(e);
+ * }
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param variableDeclaration The variableDeclaration.

package/lib/factory/statements/createCatchClause.js

@@ -4,7 +4,22 @@ exports.createCatchClause = void 0;
 const make_1 = require("../internal/make");
 const createVariableDeclaration_1 = require("./createVariableDeclaration");
 /**
- * Create a {@link CatchClause}.
+ * Create a {@link CatchClause}: the `catch (...) { ... }` arm of a try.
+ *
+ * The `variableDeclaration` binds the caught value. Pass a string for the
+ * common `catch (e)` case and it is turned into a bare binding; pass a full
+ * {@link VariableDeclaration} when you need a type or destructuring pattern;
+ * pass `undefined` for the binding-less `catch { ... }` form. The `block` is
+ * the handler body.
+ *
+ * With `variableDeclaration` of `e` and a `block` calling `handle(e)`, the
+ * result is:
+ *
+ * ```ts
+ * catch (e) {
+ *   handle(e);
+ * }
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param variableDeclaration The variableDeclaration.

package/lib/factory/statements/createCatchClause.js.map

@@ -1 +1 @@
-{"version":3,"file":"createCatchClause.js","sourceRoot":"","sources":["../../../src/factory/statements/createCatchClause.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AACxC,2EAAwE;AAExE;;;;;;;GAOG;AACI,MAAM,iBAAiB,GAAG,CAC/B,mBAA6D,EAC7D,KAAY,EACC,EAAE,CACf,IAAA,WAAI,EAAC,aAAa,EAAE;IAClB,mBAAmB,EACjB,OAAO,mBAAmB,KAAK,QAAQ;QACrC,CAAC,CAAC,IAAA,qDAAyB,EACvB,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,SAAS,CACV;QACH,CAAC,CAAC,mBAAmB;IACzB,KAAK;CACN,CAAC,CAAC;AAfQ,QAAA,iBAAiB,GAAjB,iBAAiB,CAezB"}
+{"version":3,"file":"createCatchClause.js","sourceRoot":"","sources":["../../../src/factory/statements/createCatchClause.ts"],"names":[],"mappings":";;;AACA,2CAAwC;AACxC,2EAAwE;AAExE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACI,MAAM,iBAAiB,GAAG,CAC/B,mBAA6D,EAC7D,KAAY,EACC,EAAE,CACf,IAAA,WAAI,EAAC,aAAa,EAAE;IAClB,mBAAmB,EACjB,OAAO,mBAAmB,KAAK,QAAQ;QACrC,CAAC,CAAC,IAAA,qDAAyB,EACvB,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,SAAS,CACV;QACH,CAAC,CAAC,mBAAmB;IACzB,KAAK;CACN,CAAC,CAAC;AAfQ,QAAA,iBAAiB,GAAjB,iBAAiB,CAezB"}

package/lib/factory/statements/createCatchClause.mjs

@@ -3,7 +3,22 @@ exports.createCatchClause = void 0;
 const make_1 = require("../internal/make");
 const createVariableDeclaration_1 = require("./createVariableDeclaration");
 /**
- * Create a {@link CatchClause}.
+ * Create a {@link CatchClause}: the `catch (...) { ... }` arm of a try.
+ *
+ * The `variableDeclaration` binds the caught value. Pass a string for the
+ * common `catch (e)` case and it is turned into a bare binding; pass a full
+ * {@link VariableDeclaration} when you need a type or destructuring pattern;
+ * pass `undefined` for the binding-less `catch { ... }` form. The `block` is
+ * the handler body.
+ *
+ * With `variableDeclaration` of `e` and a `block` calling `handle(e)`, the
+ * result is:
+ *
+ * ```ts
+ * catch (e) {
+ *   handle(e);
+ * }
+ * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
  * @param variableDeclaration The variableDeclaration.

package/lib/factory/statements/createCatchClause.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createCatchClause.mjs","sources":["createCatchClause.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createCatchClause = void 0;\nconst make_1 = require(\"../internal/make\");\nconst createVariableDeclaration_1 = require(\"./createVariableDeclaration\");\n/**\n * Create a {@link CatchClause}.\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param variableDeclaration The variableDeclaration.\n * @param block The block.\n * @returns The created {@link CatchClause}.\n */\nconst createCatchClause = (variableDeclaration, block) => (0, make_1.make)(\"CatchClause\", {\n    variableDeclaration: typeof variableDeclaration === \"string\"\n        ? (0, createVariableDeclaration_1.createVariableDeclaration)(variableDeclaration, undefined, undefined, undefined)\n        : variableDeclaration,\n    block,\n});\nexports.createCatchClause = createCatchClause;\n//# sourceMappingURL=createCatchClause.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,iBAAiB,GAAG,MAAM;AAClC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C,MAAM,2BAA2B,GAAG,OAAO,CAAC,6BAA6B,CAAC;AAC1E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,iBAAiB,GAAG,CAAC,mBAAmB,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE;AAC1F,IAAI,mBAAmB,EAAE,OAAO,mBAAmB,KAAK;AACxD,UAAU,IAAI,2BAA2B,CAAC,yBAAyB,EAAE,mBAAmB,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS;AACzH,UAAU,mBAAmB;AAC7B,IAAI,KAAK;AACT,CAAC,CAAC;AACF,OAAO,CAAC,iBAAiB,GAAG,iBAAiB"}
+{"version":3,"file":"createCatchClause.mjs","sources":["createCatchClause.js"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.createCatchClause = void 0;\nconst make_1 = require(\"../internal/make\");\nconst createVariableDeclaration_1 = require(\"./createVariableDeclaration\");\n/**\n * Create a {@link CatchClause}: the `catch (...) { ... }` arm of a try.\n *\n * The `variableDeclaration` binds the caught value. Pass a string for the\n * common `catch (e)` case and it is turned into a bare binding; pass a full\n * {@link VariableDeclaration} when you need a type or destructuring pattern;\n * pass `undefined` for the binding-less `catch { ... }` form. The `block` is\n * the handler body.\n *\n * With `variableDeclaration` of `e` and a `block` calling `handle(e)`, the\n * result is:\n *\n * ```ts\n * catch (e) {\n *   handle(e);\n * }\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param variableDeclaration The variableDeclaration.\n * @param block The block.\n * @returns The created {@link CatchClause}.\n */\nconst createCatchClause = (variableDeclaration, block) => (0, make_1.make)(\"CatchClause\", {\n    variableDeclaration: typeof variableDeclaration === \"string\"\n        ? (0, createVariableDeclaration_1.createVariableDeclaration)(variableDeclaration, undefined, undefined, undefined)\n        : variableDeclaration,\n    block,\n});\nexports.createCatchClause = createCatchClause;\n//# sourceMappingURL=createCatchClause.js.map"],"names":[],"mappings":"AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,iBAAiB,GAAG,MAAM;AAClC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC1C,MAAM,2BAA2B,GAAG,OAAO,CAAC,6BAA6B,CAAC;AAC1E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,iBAAiB,GAAG,CAAC,mBAAmB,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE;AAC1F,IAAI,mBAAmB,EAAE,OAAO,mBAAmB,KAAK;AACxD,UAAU,IAAI,2BAA2B,CAAC,yBAAyB,EAAE,mBAAmB,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS;AACzH,UAAU,mBAAmB;AAC7B,IAAI,KAAK;AACT,CAAC,CAAC;AACF,OAAO,CAAC,iBAAiB,GAAG,iBAAiB"}