@ttsc/factory 0.15.9 → 0.15.10

package/lib/factory/jsdoc/createJSDocOverloadTag.mjs

@@ -0,0 +1,35 @@
+import { make } from '../internal/make.mjs';
+import { createIdentifier } from '../names/createIdentifier.mjs';
+
+/**
+ * Create a {@link JSDocOverloadTag}: an `@overload` JSDoc tag.
+ *
+ * The `tagName` defaults to an identifier named `overload` when omitted. The
+ * `typeExpression` is the {@link JSDocSignature} describing the overload, and
+ * `comment` is the trailing description. The printer prints the tag on the
+ * first line, then the signature's `@param` and `@returns` tags on their own
+ * lines.
+ *
+ * With the default tag name and a signature taking `{number} x` and returning
+ * `{void}`, the printer emits:
+ *
+ * ```ts
+ * @overload
+ * @param {number} x
+ * @returns {void}
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param tagName The tag name; defaults to `overload`.
+ * @param typeExpression The overload signature.
+ * @param comment The trailing comment, if any.
+ * @returns The created {@link JSDocOverloadTag}.
+ */
+const createJSDocOverloadTag = (tagName, typeExpression, comment) => make("JSDocOverloadTag", {
+    tagName: tagName ?? createIdentifier("overload"),
+    typeExpression,
+    comment,
+});
+
+export { createJSDocOverloadTag };
+//# sourceMappingURL=createJSDocOverloadTag.mjs.map

package/lib/factory/jsdoc/createJSDocOverloadTag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocOverloadTag.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocOverloadTag.js"],"sourcesContent":["import { make } from \"../internal/make\";\nimport { createIdentifier } from \"../names/createIdentifier\";\n/**\n * Create a {@link JSDocOverloadTag}: an `@overload` JSDoc tag.\n *\n * The `tagName` defaults to an identifier named `overload` when omitted. The\n * `typeExpression` is the {@link JSDocSignature} describing the overload, and\n * `comment` is the trailing description. The printer prints the tag on the\n * first line, then the signature's `@param` and `@returns` tags on their own\n * lines.\n *\n * With the default tag name and a signature taking `{number} x` and returning\n * `{void}`, the printer emits:\n *\n * ```ts\n * @overload\n * @param {number} x\n * @returns {void}\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param tagName The tag name; defaults to `overload`.\n * @param typeExpression The overload signature.\n * @param comment The trailing comment, if any.\n * @returns The created {@link JSDocOverloadTag}.\n */\nexport const createJSDocOverloadTag = (tagName, typeExpression, comment) => make(\"JSDocOverloadTag\", {\n    tagName: tagName ?? createIdentifier(\"overload\"),\n    typeExpression,\n    comment,\n});\n//# sourceMappingURL=createJSDocOverloadTag.js.map"],"names":[],"mappings":";;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,sBAAsB,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC,kBAAkB,EAAE;AACrG,IAAI,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC,UAAU,CAAC;AACpD,IAAI,cAAc;AAClB,IAAI,OAAO;AACX,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocOverrideTag.mjs

@@ -0,0 +1,27 @@
+import { make } from '../internal/make.mjs';
+import { createIdentifier } from '../names/createIdentifier.mjs';
+
+/**
+ * Create a {@link JSDocOverrideTag}: an `@override` JSDoc tag.
+ *
+ * The `tagName` defaults to an identifier named `override` when omitted. The
+ * `comment` is the trailing description, if any.
+ *
+ * With the default tag name and no comment, the printer emits:
+ *
+ * ```ts
+ * @override
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param tagName The tag name; defaults to `override`.
+ * @param comment The trailing comment, if any.
+ * @returns The created {@link JSDocOverrideTag}.
+ */
+const createJSDocOverrideTag = (tagName, comment) => make("JSDocOverrideTag", {
+    tagName: tagName ?? createIdentifier("override"),
+    comment,
+});
+
+export { createJSDocOverrideTag };
+//# sourceMappingURL=createJSDocOverrideTag.mjs.map

package/lib/factory/jsdoc/createJSDocOverrideTag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocOverrideTag.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocOverrideTag.js"],"sourcesContent":["import { make } from \"../internal/make\";\nimport { createIdentifier } from \"../names/createIdentifier\";\n/**\n * Create a {@link JSDocOverrideTag}: an `@override` JSDoc tag.\n *\n * The `tagName` defaults to an identifier named `override` when omitted. The\n * `comment` is the trailing description, if any.\n *\n * With the default tag name and no comment, the printer emits:\n *\n * ```ts\n * @override\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param tagName The tag name; defaults to `override`.\n * @param comment The trailing comment, if any.\n * @returns The created {@link JSDocOverrideTag}.\n */\nexport const createJSDocOverrideTag = (tagName, comment) => make(\"JSDocOverrideTag\", {\n    tagName: tagName ?? createIdentifier(\"override\"),\n    comment,\n});\n//# sourceMappingURL=createJSDocOverrideTag.js.map"],"names":[],"mappings":";;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,sBAAsB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC,kBAAkB,EAAE;AACrF,IAAI,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC,UAAU,CAAC;AACpD,IAAI,OAAO;AACX,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocParameterTag.mjs

@@ -0,0 +1,46 @@
+import { make } from '../internal/make.mjs';
+import { createIdentifier } from '../names/createIdentifier.mjs';
+
+/**
+ * Create a {@link JSDocParameterTag}: a `@param` JSDoc tag.
+ *
+ * The `tagName` defaults to an identifier named `param` when omitted. The
+ * `name` is the documented parameter, `isBracketed` wraps that name in square
+ * brackets to mark it optional, and `typeExpression` supplies the brace-wrapped
+ * type. The `isNameFirst` flag controls ordering: when `true` the name prints
+ * before the type, when `false` the type prints first. The `comment` is the
+ * trailing description.
+ *
+ * With the default tag name, name `x`, a `{number}` type expression, and a `the
+ * x` comment, `isNameFirst` of `true` prints the name ahead of the type:
+ *
+ * ```ts
+ * @param x {number} the x
+ * ```
+ *
+ * The same inputs with `isNameFirst` of `false` print the type first:
+ *
+ * ```ts
+ * @param {number} x the x
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param tagName The tag name; defaults to `param`.
+ * @param name The parameter name.
+ * @param isBracketed Whether the name was wrapped in brackets.
+ * @param typeExpression The type expression, if any.
+ * @param isNameFirst Whether the name was written before the type.
+ * @param comment The trailing comment, if any.
+ * @returns The created {@link JSDocParameterTag}.
+ */
+const createJSDocParameterTag = (tagName, name, isBracketed, typeExpression, isNameFirst = false, comment) => make("JSDocParameterTag", {
+    tagName: tagName ?? createIdentifier("param"),
+    name,
+    isBracketed,
+    typeExpression,
+    isNameFirst: !!isNameFirst,
+    comment,
+});
+
+export { createJSDocParameterTag };
+//# sourceMappingURL=createJSDocParameterTag.mjs.map

package/lib/factory/jsdoc/createJSDocParameterTag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocParameterTag.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocParameterTag.js"],"sourcesContent":["import { make } from \"../internal/make\";\nimport { createIdentifier } from \"../names/createIdentifier\";\n/**\n * Create a {@link JSDocParameterTag}: a `@param` JSDoc tag.\n *\n * The `tagName` defaults to an identifier named `param` when omitted. The\n * `name` is the documented parameter, `isBracketed` wraps that name in square\n * brackets to mark it optional, and `typeExpression` supplies the brace-wrapped\n * type. The `isNameFirst` flag controls ordering: when `true` the name prints\n * before the type, when `false` the type prints first. The `comment` is the\n * trailing description.\n *\n * With the default tag name, name `x`, a `{number}` type expression, and a `the\n * x` comment, `isNameFirst` of `true` prints the name ahead of the type:\n *\n * ```ts\n * @param x {number} the x\n * ```\n *\n * The same inputs with `isNameFirst` of `false` print the type first:\n *\n * ```ts\n * @param {number} x the x\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param tagName The tag name; defaults to `param`.\n * @param name The parameter name.\n * @param isBracketed Whether the name was wrapped in brackets.\n * @param typeExpression The type expression, if any.\n * @param isNameFirst Whether the name was written before the type.\n * @param comment The trailing comment, if any.\n * @returns The created {@link JSDocParameterTag}.\n */\nexport const createJSDocParameterTag = (tagName, name, isBracketed, typeExpression, isNameFirst = false, comment) => make(\"JSDocParameterTag\", {\n    tagName: tagName ?? createIdentifier(\"param\"),\n    name,\n    isBracketed,\n    typeExpression,\n    isNameFirst: !!isNameFirst,\n    comment,\n});\n//# sourceMappingURL=createJSDocParameterTag.js.map"],"names":[],"mappings":";;;AAEA;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;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,uBAAuB,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,GAAG,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,mBAAmB,EAAE;AAC/I,IAAI,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC,OAAO,CAAC;AACjD,IAAI,IAAI;AACR,IAAI,WAAW;AACf,IAAI,cAAc;AAClB,IAAI,WAAW,EAAE,CAAC,CAAC,WAAW;AAC9B,IAAI,OAAO;AACX,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocPrivateTag.mjs

@@ -0,0 +1,27 @@
+import { make } from '../internal/make.mjs';
+import { createIdentifier } from '../names/createIdentifier.mjs';
+
+/**
+ * Create a {@link JSDocPrivateTag}: a `@private` JSDoc tag.
+ *
+ * The `tagName` defaults to an identifier named `private` when omitted. The
+ * `comment` is the trailing description, if any.
+ *
+ * With the default tag name and no comment, the printer emits:
+ *
+ * ```ts
+ * @private
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param tagName The tag name; defaults to `private`.
+ * @param comment The trailing comment, if any.
+ * @returns The created {@link JSDocPrivateTag}.
+ */
+const createJSDocPrivateTag = (tagName, comment) => make("JSDocPrivateTag", {
+    tagName: tagName ?? createIdentifier("private"),
+    comment,
+});
+
+export { createJSDocPrivateTag };
+//# sourceMappingURL=createJSDocPrivateTag.mjs.map

package/lib/factory/jsdoc/createJSDocPrivateTag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocPrivateTag.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocPrivateTag.js"],"sourcesContent":["import { make } from \"../internal/make\";\nimport { createIdentifier } from \"../names/createIdentifier\";\n/**\n * Create a {@link JSDocPrivateTag}: a `@private` JSDoc tag.\n *\n * The `tagName` defaults to an identifier named `private` when omitted. The\n * `comment` is the trailing description, if any.\n *\n * With the default tag name and no comment, the printer emits:\n *\n * ```ts\n * @private\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param tagName The tag name; defaults to `private`.\n * @param comment The trailing comment, if any.\n * @returns The created {@link JSDocPrivateTag}.\n */\nexport const createJSDocPrivateTag = (tagName, comment) => make(\"JSDocPrivateTag\", {\n    tagName: tagName ?? createIdentifier(\"private\"),\n    comment,\n});\n//# sourceMappingURL=createJSDocPrivateTag.js.map"],"names":[],"mappings":";;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,qBAAqB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC,iBAAiB,EAAE;AACnF,IAAI,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC,SAAS,CAAC;AACnD,IAAI,OAAO;AACX,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocPropertyTag.mjs

@@ -0,0 +1,40 @@
+import { make } from '../internal/make.mjs';
+import { createIdentifier } from '../names/createIdentifier.mjs';
+
+/**
+ * Create a {@link JSDocPropertyTag}: a `@prop` JSDoc tag.
+ *
+ * The `tagName` defaults to an identifier named `prop` when omitted. The `name`
+ * is the documented property, `isBracketed` wraps that name in square brackets
+ * to mark it optional, and `typeExpression` supplies the brace-wrapped type.
+ * The `isNameFirst` flag controls ordering: when `true` the name prints before
+ * the type, when `false` the type prints first. The `comment` is the trailing
+ * description.
+ *
+ * With the default tag name, name `x`, a `{number}` type expression, `the x`
+ * comment, and `isNameFirst` of `true`, the printer emits:
+ *
+ * ```ts
+ * @prop x {number} the x
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param tagName The tag name; defaults to `prop`.
+ * @param name The property name.
+ * @param isBracketed Whether the name was wrapped in brackets.
+ * @param typeExpression The type expression, if any.
+ * @param isNameFirst Whether the name was written before the type.
+ * @param comment The trailing comment, if any.
+ * @returns The created {@link JSDocPropertyTag}.
+ */
+const createJSDocPropertyTag = (tagName, name, isBracketed, typeExpression, isNameFirst = false, comment) => make("JSDocPropertyTag", {
+    tagName: tagName ?? createIdentifier("prop"),
+    name,
+    isBracketed,
+    typeExpression,
+    isNameFirst: !!isNameFirst,
+    comment,
+});
+
+export { createJSDocPropertyTag };
+//# sourceMappingURL=createJSDocPropertyTag.mjs.map

package/lib/factory/jsdoc/createJSDocPropertyTag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocPropertyTag.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocPropertyTag.js"],"sourcesContent":["import { make } from \"../internal/make\";\nimport { createIdentifier } from \"../names/createIdentifier\";\n/**\n * Create a {@link JSDocPropertyTag}: a `@prop` JSDoc tag.\n *\n * The `tagName` defaults to an identifier named `prop` when omitted. The `name`\n * is the documented property, `isBracketed` wraps that name in square brackets\n * to mark it optional, and `typeExpression` supplies the brace-wrapped type.\n * The `isNameFirst` flag controls ordering: when `true` the name prints before\n * the type, when `false` the type prints first. The `comment` is the trailing\n * description.\n *\n * With the default tag name, name `x`, a `{number}` type expression, `the x`\n * comment, and `isNameFirst` of `true`, the printer emits:\n *\n * ```ts\n * @prop x {number} the x\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param tagName The tag name; defaults to `prop`.\n * @param name The property name.\n * @param isBracketed Whether the name was wrapped in brackets.\n * @param typeExpression The type expression, if any.\n * @param isNameFirst Whether the name was written before the type.\n * @param comment The trailing comment, if any.\n * @returns The created {@link JSDocPropertyTag}.\n */\nexport const createJSDocPropertyTag = (tagName, name, isBracketed, typeExpression, isNameFirst = false, comment) => make(\"JSDocPropertyTag\", {\n    tagName: tagName ?? createIdentifier(\"prop\"),\n    name,\n    isBracketed,\n    typeExpression,\n    isNameFirst: !!isNameFirst,\n    comment,\n});\n//# sourceMappingURL=createJSDocPropertyTag.js.map"],"names":[],"mappings":";;;AAEA;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;AACY,MAAC,sBAAsB,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,GAAG,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,kBAAkB,EAAE;AAC7I,IAAI,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC;AAChD,IAAI,IAAI;AACR,IAAI,WAAW;AACf,IAAI,cAAc;AAClB,IAAI,WAAW,EAAE,CAAC,CAAC,WAAW;AAC9B,IAAI,OAAO;AACX,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocProtectedTag.mjs

@@ -0,0 +1,27 @@
+import { make } from '../internal/make.mjs';
+import { createIdentifier } from '../names/createIdentifier.mjs';
+
+/**
+ * Create a {@link JSDocProtectedTag}: a `@protected` JSDoc tag.
+ *
+ * The `tagName` defaults to an identifier named `protected` when omitted. The
+ * `comment` is the trailing description, if any.
+ *
+ * With the default tag name and no comment, the printer emits:
+ *
+ * ```ts
+ * @protected
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param tagName The tag name; defaults to `protected`.
+ * @param comment The trailing comment, if any.
+ * @returns The created {@link JSDocProtectedTag}.
+ */
+const createJSDocProtectedTag = (tagName, comment) => make("JSDocProtectedTag", {
+    tagName: tagName ?? createIdentifier("protected"),
+    comment,
+});
+
+export { createJSDocProtectedTag };
+//# sourceMappingURL=createJSDocProtectedTag.mjs.map

package/lib/factory/jsdoc/createJSDocProtectedTag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocProtectedTag.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocProtectedTag.js"],"sourcesContent":["import { make } from \"../internal/make\";\nimport { createIdentifier } from \"../names/createIdentifier\";\n/**\n * Create a {@link JSDocProtectedTag}: a `@protected` JSDoc tag.\n *\n * The `tagName` defaults to an identifier named `protected` when omitted. The\n * `comment` is the trailing description, if any.\n *\n * With the default tag name and no comment, the printer emits:\n *\n * ```ts\n * @protected\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param tagName The tag name; defaults to `protected`.\n * @param comment The trailing comment, if any.\n * @returns The created {@link JSDocProtectedTag}.\n */\nexport const createJSDocProtectedTag = (tagName, comment) => make(\"JSDocProtectedTag\", {\n    tagName: tagName ?? createIdentifier(\"protected\"),\n    comment,\n});\n//# sourceMappingURL=createJSDocProtectedTag.js.map"],"names":[],"mappings":";;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,uBAAuB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC,mBAAmB,EAAE;AACvF,IAAI,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC,WAAW,CAAC;AACrD,IAAI,OAAO;AACX,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocPublicTag.mjs

@@ -0,0 +1,27 @@
+import { make } from '../internal/make.mjs';
+import { createIdentifier } from '../names/createIdentifier.mjs';
+
+/**
+ * Create a {@link JSDocPublicTag}: a `@public` JSDoc tag.
+ *
+ * The `tagName` defaults to an identifier named `public` when omitted. The
+ * `comment` is the trailing description, if any.
+ *
+ * With the default tag name and no comment, the printer emits:
+ *
+ * ```ts
+ * @public
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param tagName The tag name; defaults to `public`.
+ * @param comment The trailing comment, if any.
+ * @returns The created {@link JSDocPublicTag}.
+ */
+const createJSDocPublicTag = (tagName, comment) => make("JSDocPublicTag", {
+    tagName: tagName ?? createIdentifier("public"),
+    comment,
+});
+
+export { createJSDocPublicTag };
+//# sourceMappingURL=createJSDocPublicTag.mjs.map

package/lib/factory/jsdoc/createJSDocPublicTag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocPublicTag.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocPublicTag.js"],"sourcesContent":["import { make } from \"../internal/make\";\nimport { createIdentifier } from \"../names/createIdentifier\";\n/**\n * Create a {@link JSDocPublicTag}: a `@public` JSDoc tag.\n *\n * The `tagName` defaults to an identifier named `public` when omitted. The\n * `comment` is the trailing description, if any.\n *\n * With the default tag name and no comment, the printer emits:\n *\n * ```ts\n * @public\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param tagName The tag name; defaults to `public`.\n * @param comment The trailing comment, if any.\n * @returns The created {@link JSDocPublicTag}.\n */\nexport const createJSDocPublicTag = (tagName, comment) => make(\"JSDocPublicTag\", {\n    tagName: tagName ?? createIdentifier(\"public\"),\n    comment,\n});\n//# sourceMappingURL=createJSDocPublicTag.js.map"],"names":[],"mappings":";;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,oBAAoB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC,gBAAgB,EAAE;AACjF,IAAI,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC,QAAQ,CAAC;AAClD,IAAI,OAAO;AACX,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocReadonlyTag.mjs

@@ -0,0 +1,27 @@
+import { make } from '../internal/make.mjs';
+import { createIdentifier } from '../names/createIdentifier.mjs';
+
+/**
+ * Create a {@link JSDocReadonlyTag}: a `@readonly` JSDoc tag.
+ *
+ * The `tagName` defaults to an identifier named `readonly` when omitted. The
+ * `comment` is the trailing description, if any.
+ *
+ * With the default tag name and no comment, the printer emits:
+ *
+ * ```ts
+ * @readonly
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param tagName The tag name; defaults to `readonly`.
+ * @param comment The trailing comment, if any.
+ * @returns The created {@link JSDocReadonlyTag}.
+ */
+const createJSDocReadonlyTag = (tagName, comment) => make("JSDocReadonlyTag", {
+    tagName: tagName ?? createIdentifier("readonly"),
+    comment,
+});
+
+export { createJSDocReadonlyTag };
+//# sourceMappingURL=createJSDocReadonlyTag.mjs.map

package/lib/factory/jsdoc/createJSDocReadonlyTag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocReadonlyTag.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocReadonlyTag.js"],"sourcesContent":["import { make } from \"../internal/make\";\nimport { createIdentifier } from \"../names/createIdentifier\";\n/**\n * Create a {@link JSDocReadonlyTag}: a `@readonly` JSDoc tag.\n *\n * The `tagName` defaults to an identifier named `readonly` when omitted. The\n * `comment` is the trailing description, if any.\n *\n * With the default tag name and no comment, the printer emits:\n *\n * ```ts\n * @readonly\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param tagName The tag name; defaults to `readonly`.\n * @param comment The trailing comment, if any.\n * @returns The created {@link JSDocReadonlyTag}.\n */\nexport const createJSDocReadonlyTag = (tagName, comment) => make(\"JSDocReadonlyTag\", {\n    tagName: tagName ?? createIdentifier(\"readonly\"),\n    comment,\n});\n//# sourceMappingURL=createJSDocReadonlyTag.js.map"],"names":[],"mappings":";;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,sBAAsB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC,kBAAkB,EAAE;AACrF,IAAI,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC,UAAU,CAAC;AACpD,IAAI,OAAO;AACX,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocReturnTag.mjs

@@ -0,0 +1,32 @@
+import { make } from '../internal/make.mjs';
+import { createIdentifier } from '../names/createIdentifier.mjs';
+
+/**
+ * Create a {@link JSDocReturnTag}: a `@returns` JSDoc tag.
+ *
+ * The `tagName` defaults to an identifier named `returns` when omitted. The
+ * `typeExpression` supplies the brace-wrapped return type, and `comment` is the
+ * trailing description. When the type expression is omitted, the printer drops
+ * the braces and emits only the tag name and comment.
+ *
+ * With the default tag name, a `{number}` type expression, and a `the count`
+ * comment, the printer emits:
+ *
+ * ```ts
+ * @returns {number} the count
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param tagName The tag name; defaults to `returns`.
+ * @param typeExpression The type expression, if any.
+ * @param comment The trailing comment, if any.
+ * @returns The created {@link JSDocReturnTag}.
+ */
+const createJSDocReturnTag = (tagName, typeExpression, comment) => make("JSDocReturnTag", {
+    tagName: tagName ?? createIdentifier("returns"),
+    typeExpression,
+    comment,
+});
+
+export { createJSDocReturnTag };
+//# sourceMappingURL=createJSDocReturnTag.mjs.map

package/lib/factory/jsdoc/createJSDocReturnTag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocReturnTag.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocReturnTag.js"],"sourcesContent":["import { make } from \"../internal/make\";\nimport { createIdentifier } from \"../names/createIdentifier\";\n/**\n * Create a {@link JSDocReturnTag}: a `@returns` JSDoc tag.\n *\n * The `tagName` defaults to an identifier named `returns` when omitted. The\n * `typeExpression` supplies the brace-wrapped return type, and `comment` is the\n * trailing description. When the type expression is omitted, the printer drops\n * the braces and emits only the tag name and comment.\n *\n * With the default tag name, a `{number}` type expression, and a `the count`\n * comment, the printer emits:\n *\n * ```ts\n * @returns {number} the count\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param tagName The tag name; defaults to `returns`.\n * @param typeExpression The type expression, if any.\n * @param comment The trailing comment, if any.\n * @returns The created {@link JSDocReturnTag}.\n */\nexport const createJSDocReturnTag = (tagName, typeExpression, comment) => make(\"JSDocReturnTag\", {\n    tagName: tagName ?? createIdentifier(\"returns\"),\n    typeExpression,\n    comment,\n});\n//# sourceMappingURL=createJSDocReturnTag.js.map"],"names":[],"mappings":";;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,oBAAoB,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC,gBAAgB,EAAE;AACjG,IAAI,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC,SAAS,CAAC;AACnD,IAAI,cAAc;AAClB,IAAI,OAAO;AACX,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocSatisfiesTag.mjs

@@ -0,0 +1,31 @@
+import { make } from '../internal/make.mjs';
+import { createIdentifier } from '../names/createIdentifier.mjs';
+
+/**
+ * Create a {@link JSDocSatisfiesTag}: a `@satisfies` JSDoc tag.
+ *
+ * The `tagName` defaults to an identifier named `satisfies` when omitted. The
+ * `typeExpression` supplies the brace-wrapped target type, and `comment` is the
+ * trailing description.
+ *
+ * With the default tag name, a `{Foo}` type expression, and an `ok` comment,
+ * the printer emits:
+ *
+ * ```ts
+ * @satisfies {Foo} ok
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param tagName The tag name; defaults to `satisfies`.
+ * @param typeExpression The type expression.
+ * @param comment The trailing comment, if any.
+ * @returns The created {@link JSDocSatisfiesTag}.
+ */
+const createJSDocSatisfiesTag = (tagName, typeExpression, comment) => make("JSDocSatisfiesTag", {
+    tagName: tagName ?? createIdentifier("satisfies"),
+    typeExpression,
+    comment,
+});
+
+export { createJSDocSatisfiesTag };
+//# sourceMappingURL=createJSDocSatisfiesTag.mjs.map

package/lib/factory/jsdoc/createJSDocSatisfiesTag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocSatisfiesTag.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocSatisfiesTag.js"],"sourcesContent":["import { make } from \"../internal/make\";\nimport { createIdentifier } from \"../names/createIdentifier\";\n/**\n * Create a {@link JSDocSatisfiesTag}: a `@satisfies` JSDoc tag.\n *\n * The `tagName` defaults to an identifier named `satisfies` when omitted. The\n * `typeExpression` supplies the brace-wrapped target type, and `comment` is the\n * trailing description.\n *\n * With the default tag name, a `{Foo}` type expression, and an `ok` comment,\n * the printer emits:\n *\n * ```ts\n * @satisfies {Foo} ok\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param tagName The tag name; defaults to `satisfies`.\n * @param typeExpression The type expression.\n * @param comment The trailing comment, if any.\n * @returns The created {@link JSDocSatisfiesTag}.\n */\nexport const createJSDocSatisfiesTag = (tagName, typeExpression, comment) => make(\"JSDocSatisfiesTag\", {\n    tagName: tagName ?? createIdentifier(\"satisfies\"),\n    typeExpression,\n    comment,\n});\n//# sourceMappingURL=createJSDocSatisfiesTag.js.map"],"names":[],"mappings":";;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,uBAAuB,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC,mBAAmB,EAAE;AACvG,IAAI,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC,WAAW,CAAC;AACrD,IAAI,cAAc;AAClB,IAAI,OAAO;AACX,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocSeeTag.mjs

@@ -0,0 +1,31 @@
+import { make } from '../internal/make.mjs';
+import { createIdentifier } from '../names/createIdentifier.mjs';
+
+/**
+ * Create a {@link JSDocSeeTag}: a `@see` JSDoc tag.
+ *
+ * The `tagName` defaults to an identifier named `see` when omitted. The
+ * `nameExpression` is the referenced name, if any, and `comment` is the
+ * trailing description.
+ *
+ * With the default tag name, a `Foo` name reference, and a `more` comment, the
+ * printer emits:
+ *
+ * ```ts
+ * @see Foo more
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param tagName The tag name; defaults to `see`.
+ * @param nameExpression The referenced name, if any.
+ * @param comment The trailing comment, if any.
+ * @returns The created {@link JSDocSeeTag}.
+ */
+const createJSDocSeeTag = (tagName, nameExpression, comment) => make("JSDocSeeTag", {
+    tagName: tagName ?? createIdentifier("see"),
+    name: nameExpression,
+    comment,
+});
+
+export { createJSDocSeeTag };
+//# sourceMappingURL=createJSDocSeeTag.mjs.map

package/lib/factory/jsdoc/createJSDocSeeTag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocSeeTag.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocSeeTag.js"],"sourcesContent":["import { make } from \"../internal/make\";\nimport { createIdentifier } from \"../names/createIdentifier\";\n/**\n * Create a {@link JSDocSeeTag}: a `@see` JSDoc tag.\n *\n * The `tagName` defaults to an identifier named `see` when omitted. The\n * `nameExpression` is the referenced name, if any, and `comment` is the\n * trailing description.\n *\n * With the default tag name, a `Foo` name reference, and a `more` comment, the\n * printer emits:\n *\n * ```ts\n * @see Foo more\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param tagName The tag name; defaults to `see`.\n * @param nameExpression The referenced name, if any.\n * @param comment The trailing comment, if any.\n * @returns The created {@link JSDocSeeTag}.\n */\nexport const createJSDocSeeTag = (tagName, nameExpression, comment) => make(\"JSDocSeeTag\", {\n    tagName: tagName ?? createIdentifier(\"see\"),\n    name: nameExpression,\n    comment,\n});\n//# sourceMappingURL=createJSDocSeeTag.js.map"],"names":[],"mappings":";;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,iBAAiB,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC,aAAa,EAAE;AAC3F,IAAI,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC,KAAK,CAAC;AAC/C,IAAI,IAAI,EAAE,cAAc;AACxB,IAAI,OAAO;AACX,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocSignature.mjs

@@ -0,0 +1,32 @@
+import { make } from '../internal/make.mjs';
+
+/**
+ * Create a {@link JSDocSignature}: the synthetic signature behind `@callback`
+ * and `@overload` tags.
+ *
+ * The `typeParameters` are the `@template` tags, `parameters` are the `@param`
+ * tags, and `type` is the `@returns` tag. The printer emits each on its own
+ * line, in that order.
+ *
+ * With no type parameters, a single `@param {number} x the x` tag, and an
+ * `@returns {boolean}` tag, the printer emits:
+ *
+ * ```ts
+ * @param {number} x the x
+ * @returns {boolean}
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param typeParameters The `@template` type parameters, if any.
+ * @param parameters The `@param` tags.
+ * @param type The `@return` tag, if any.
+ * @returns The created {@link JSDocSignature}.
+ */
+const createJSDocSignature = (typeParameters, parameters, type) => make("JSDocSignature", {
+    typeParameters,
+    parameters,
+    type,
+});
+
+export { createJSDocSignature };
+//# sourceMappingURL=createJSDocSignature.mjs.map

package/lib/factory/jsdoc/createJSDocSignature.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocSignature.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocSignature.js"],"sourcesContent":["import { make } from \"../internal/make\";\n/**\n * Create a {@link JSDocSignature}: the synthetic signature behind `@callback`\n * and `@overload` tags.\n *\n * The `typeParameters` are the `@template` tags, `parameters` are the `@param`\n * tags, and `type` is the `@returns` tag. The printer emits each on its own\n * line, in that order.\n *\n * With no type parameters, a single `@param {number} x the x` tag, and an\n * `@returns {boolean}` tag, the printer emits:\n *\n * ```ts\n * @param {number} x the x\n * @returns {boolean}\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param typeParameters The `@template` type parameters, if any.\n * @param parameters The `@param` tags.\n * @param type The `@return` tag, if any.\n * @returns The created {@link JSDocSignature}.\n */\nexport const createJSDocSignature = (typeParameters, parameters, type) => make(\"JSDocSignature\", {\n    typeParameters,\n    parameters,\n    type,\n});\n//# sourceMappingURL=createJSDocSignature.js.map"],"names":[],"mappings":";;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,oBAAoB,GAAG,CAAC,cAAc,EAAE,UAAU,EAAE,IAAI,KAAK,IAAI,CAAC,gBAAgB,EAAE;AACjG,IAAI,cAAc;AAClB,IAAI,UAAU;AACd,IAAI,IAAI;AACR,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocTemplateTag.mjs

@@ -0,0 +1,34 @@
+import { make } from '../internal/make.mjs';
+import { createIdentifier } from '../names/createIdentifier.mjs';
+
+/**
+ * Create a {@link JSDocTemplateTag}: a `@template` JSDoc tag.
+ *
+ * The `tagName` defaults to an identifier named `template` when omitted. The
+ * `constraint` is the shared brace-wrapped bound applied to every declared
+ * parameter, if any. The `typeParameters` are the declared names, and `comment`
+ * is the trailing description.
+ *
+ * With the default tag name, a `{string}` constraint, and a single `T` type
+ * parameter, the printer emits:
+ *
+ * ```ts
+ * @template {string} T
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param tagName The tag name; defaults to `template`.
+ * @param constraint The shared constraint, if any.
+ * @param typeParameters The declared type parameters.
+ * @param comment The trailing comment, if any.
+ * @returns The created {@link JSDocTemplateTag}.
+ */
+const createJSDocTemplateTag = (tagName, constraint, typeParameters, comment) => make("JSDocTemplateTag", {
+    tagName: tagName ?? createIdentifier("template"),
+    constraint,
+    typeParameters,
+    comment,
+});
+
+export { createJSDocTemplateTag };
+//# sourceMappingURL=createJSDocTemplateTag.mjs.map

package/lib/factory/jsdoc/createJSDocTemplateTag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocTemplateTag.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocTemplateTag.js"],"sourcesContent":["import { make } from \"../internal/make\";\nimport { createIdentifier } from \"../names/createIdentifier\";\n/**\n * Create a {@link JSDocTemplateTag}: a `@template` JSDoc tag.\n *\n * The `tagName` defaults to an identifier named `template` when omitted. The\n * `constraint` is the shared brace-wrapped bound applied to every declared\n * parameter, if any. The `typeParameters` are the declared names, and `comment`\n * is the trailing description.\n *\n * With the default tag name, a `{string}` constraint, and a single `T` type\n * parameter, the printer emits:\n *\n * ```ts\n * @template {string} T\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param tagName The tag name; defaults to `template`.\n * @param constraint The shared constraint, if any.\n * @param typeParameters The declared type parameters.\n * @param comment The trailing comment, if any.\n * @returns The created {@link JSDocTemplateTag}.\n */\nexport const createJSDocTemplateTag = (tagName, constraint, typeParameters, comment) => make(\"JSDocTemplateTag\", {\n    tagName: tagName ?? createIdentifier(\"template\"),\n    constraint,\n    typeParameters,\n    comment,\n});\n//# sourceMappingURL=createJSDocTemplateTag.js.map"],"names":[],"mappings":";;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,sBAAsB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC,kBAAkB,EAAE;AACjH,IAAI,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC,UAAU,CAAC;AACpD,IAAI,UAAU;AACd,IAAI,cAAc;AAClB,IAAI,OAAO;AACX,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocText.mjs

@@ -0,0 +1,25 @@
+import { make } from '../internal/make.mjs';
+
+/**
+ * Create a {@link JSDocText}: a run of plain text inside a JSDoc comment.
+ *
+ * The `text` is the literal content. The printer emits it verbatim, with no
+ * decoration. This node holds the prose that sits between inline tags in a
+ * comment body.
+ *
+ * With a `hello world` text, the printer emits:
+ *
+ * ```ts
+ * hello world
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param text The textual content.
+ * @returns The created {@link JSDocText}.
+ */
+const createJSDocText = (text) => make("JSDocText", {
+    text,
+});
+
+export { createJSDocText };
+//# sourceMappingURL=createJSDocText.mjs.map

package/lib/factory/jsdoc/createJSDocText.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocText.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocText.js"],"sourcesContent":["import { make } from \"../internal/make\";\n/**\n * Create a {@link JSDocText}: a run of plain text inside a JSDoc comment.\n *\n * The `text` is the literal content. The printer emits it verbatim, with no\n * decoration. This node holds the prose that sits between inline tags in a\n * comment body.\n *\n * With a `hello world` text, the printer emits:\n *\n * ```ts\n * hello world\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param text The textual content.\n * @returns The created {@link JSDocText}.\n */\nexport const createJSDocText = (text) => make(\"JSDocText\", {\n    text,\n});\n//# sourceMappingURL=createJSDocText.js.map"],"names":[],"mappings":";;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,eAAe,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE;AAC3D,IAAI,IAAI;AACR,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocThisTag.mjs

@@ -0,0 +1,30 @@
+import { make } from '../internal/make.mjs';
+import { createIdentifier } from '../names/createIdentifier.mjs';
+
+/**
+ * Create a {@link JSDocThisTag}: a `@this` JSDoc tag.
+ *
+ * The `tagName` defaults to an identifier named `this` when omitted. The
+ * `typeExpression` supplies the brace-wrapped `this` type, and `comment` is the
+ * trailing description, if any.
+ *
+ * With the default tag name and a `{Foo}` type expression, the printer emits:
+ *
+ * ```ts
+ * @this {Foo}
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param tagName The tag name; defaults to `this`.
+ * @param typeExpression The type expression.
+ * @param comment The trailing comment, if any.
+ * @returns The created {@link JSDocThisTag}.
+ */
+const createJSDocThisTag = (tagName, typeExpression, comment) => make("JSDocThisTag", {
+    tagName: tagName ?? createIdentifier("this"),
+    typeExpression,
+    comment,
+});
+
+export { createJSDocThisTag };
+//# sourceMappingURL=createJSDocThisTag.mjs.map

package/lib/factory/jsdoc/createJSDocThisTag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocThisTag.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocThisTag.js"],"sourcesContent":["import { make } from \"../internal/make\";\nimport { createIdentifier } from \"../names/createIdentifier\";\n/**\n * Create a {@link JSDocThisTag}: a `@this` JSDoc tag.\n *\n * The `tagName` defaults to an identifier named `this` when omitted. The\n * `typeExpression` supplies the brace-wrapped `this` type, and `comment` is the\n * trailing description, if any.\n *\n * With the default tag name and a `{Foo}` type expression, the printer emits:\n *\n * ```ts\n * @this {Foo}\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param tagName The tag name; defaults to `this`.\n * @param typeExpression The type expression.\n * @param comment The trailing comment, if any.\n * @returns The created {@link JSDocThisTag}.\n */\nexport const createJSDocThisTag = (tagName, typeExpression, comment) => make(\"JSDocThisTag\", {\n    tagName: tagName ?? createIdentifier(\"this\"),\n    typeExpression,\n    comment,\n});\n//# sourceMappingURL=createJSDocThisTag.js.map"],"names":[],"mappings":";;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,kBAAkB,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC,cAAc,EAAE;AAC7F,IAAI,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC;AAChD,IAAI,cAAc;AAClB,IAAI,OAAO;AACX,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocThrowsTag.mjs

@@ -0,0 +1,30 @@
+import { make } from '../internal/make.mjs';
+
+/**
+ * Create a {@link JSDocThrowsTag}: a `@throws` JSDoc tag.
+ *
+ * The `tagName` is the identifier after the `@`, such as `throws`. The
+ * `typeExpression` supplies the brace-wrapped thrown type, and `comment` is the
+ * trailing description.
+ *
+ * With a tag name of `throws`, an `{Error}` type expression, and an `on
+ * failure` comment, the printer emits:
+ *
+ * ```ts
+ * @throws {Error} on failure
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param tagName The tag name.
+ * @param typeExpression The type expression, if any.
+ * @param comment The trailing comment, if any.
+ * @returns The created {@link JSDocThrowsTag}.
+ */
+const createJSDocThrowsTag = (tagName, typeExpression, comment) => make("JSDocThrowsTag", {
+    tagName,
+    typeExpression,
+    comment,
+});
+
+export { createJSDocThrowsTag };
+//# sourceMappingURL=createJSDocThrowsTag.mjs.map

package/lib/factory/jsdoc/createJSDocThrowsTag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJSDocThrowsTag.mjs","sources":["../../../esm-tmp/factory/jsdoc/createJSDocThrowsTag.js"],"sourcesContent":["import { make } from \"../internal/make\";\n/**\n * Create a {@link JSDocThrowsTag}: a `@throws` JSDoc tag.\n *\n * The `tagName` is the identifier after the `@`, such as `throws`. The\n * `typeExpression` supplies the brace-wrapped thrown type, and `comment` is the\n * trailing description.\n *\n * With a tag name of `throws`, an `{Error}` type expression, and an `on\n * failure` comment, the printer emits:\n *\n * ```ts\n * @throws {Error} on failure\n * ```\n *\n * @author Jeongho Nam - https://github.com/samchon\n * @param tagName The tag name.\n * @param typeExpression The type expression, if any.\n * @param comment The trailing comment, if any.\n * @returns The created {@link JSDocThrowsTag}.\n */\nexport const createJSDocThrowsTag = (tagName, typeExpression, comment) => make(\"JSDocThrowsTag\", {\n    tagName,\n    typeExpression,\n    comment,\n});\n//# sourceMappingURL=createJSDocThrowsTag.js.map"],"names":[],"mappings":";;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,oBAAoB,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC,gBAAgB,EAAE;AACjG,IAAI,OAAO;AACX,IAAI,cAAc;AAClB,IAAI,OAAO;AACX,CAAC;;;;"}

package/lib/factory/jsdoc/createJSDocTypeExpression.mjs

@@ -0,0 +1,24 @@
+import { make } from '../internal/make.mjs';
+
+/**
+ * Create a {@link JSDocTypeExpression}: a brace-wrapped JSDoc type.
+ *
+ * The `type` is the wrapped type. The printer surrounds it with curly braces,
+ * producing the `{Type}` form that JSDoc tags use to carry their type.
+ *
+ * With a `number` type, the printer emits:
+ *
+ * ```ts
+ * {number}
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param type The wrapped type.
+ * @returns The created {@link JSDocTypeExpression}.
+ */
+const createJSDocTypeExpression = (type) => make("JSDocTypeExpression", {
+    type,
+});
+
+export { createJSDocTypeExpression };
+//# sourceMappingURL=createJSDocTypeExpression.mjs.map