@powerlines/plugin-alloy 0.19.32 → 0.19.34

package/dist/typescript/components/tsdoc.cjs

@@ -1,23 +1,485 @@
-require('../../context-DNdlL_gp.cjs');
-const require_tsdoc = require('../../tsdoc-BufL8muf.cjs');
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_core_contexts_context = require('../../core/contexts/context.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+let __powerlines_deepkit_utilities = require("@powerlines/deepkit/utilities");
+let __stryke_type_checks_is_undefined = require("@stryke/type-checks/is-undefined");
+let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
 
-exports.TSDoc = require_tsdoc.TSDoc;
-exports.TSDocAlias = require_tsdoc.TSDocAlias;
-exports.TSDocAttributesTags = require_tsdoc.TSDocAttributesTags;
-exports.TSDocDefaultValue = require_tsdoc.TSDocDefaultValue;
-exports.TSDocDomain = require_tsdoc.TSDocDomain;
-exports.TSDocExample = require_tsdoc.TSDocExample;
-exports.TSDocHidden = require_tsdoc.TSDocHidden;
-exports.TSDocIgnore = require_tsdoc.TSDocIgnore;
-exports.TSDocInternal = require_tsdoc.TSDocInternal;
-exports.TSDocLink = require_tsdoc.TSDocLink;
-exports.TSDocModule = require_tsdoc.TSDocModule;
-exports.TSDocParam = require_tsdoc.TSDocParam;
-exports.TSDocParams = require_tsdoc.TSDocParams;
-exports.TSDocPermission = require_tsdoc.TSDocPermission;
-exports.TSDocReadonly = require_tsdoc.TSDocReadonly;
-exports.TSDocRemarks = require_tsdoc.TSDocRemarks;
-exports.TSDocReturns = require_tsdoc.TSDocReturns;
-exports.TSDocTag = require_tsdoc.TSDocTag;
-exports.TSDocThrows = require_tsdoc.TSDocThrows;
-exports.TSDocTitle = require_tsdoc.TSDocTitle;
+//#region src/typescript/components/tsdoc.tsx
+/**
+* Generates a TypeScript interface for the given reflection class.
+*/
+function TSDoc(props) {
+	const [{ children, heading }] = (0, __alloy_js_core.splitProps)(props, ["children", "heading"]);
+	return [
+		"/**",
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("align", {
+			string: " * ",
+			get children() {
+				return [
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+						get when() {
+							return !(0, __stryke_type_checks_is_undefined.isUndefined)(heading);
+						},
+						get children() {
+							return [
+								heading,
+								(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+								(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+									get when() {
+										return (0, __alloy_js_core_jsx_runtime.memo)(() => !!!(0, __stryke_type_checks_is_undefined.isUndefined)(children))() && (0, __alloy_js_core.childrenArray)(() => children).length > 0;
+									},
+									get children() {
+										return (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {});
+									}
+								})
+							];
+						}
+					}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+						get when() {
+							return (0, __alloy_js_core_jsx_runtime.memo)(() => !!!(0, __stryke_type_checks_is_undefined.isUndefined)(children))() && (0, __alloy_js_core.childrenArray)(() => children).length > 0;
+						},
+						get children() {
+							return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.List, { get children() {
+								return (0, __alloy_js_core.childrenArray)(() => children);
+							} });
+						}
+					})
+				];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		` */`,
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+	];
+}
+/**
+* Create a TSDoc `@<props.tag>` tag.
+*/
+function TSDocTag(props) {
+	const [{ children, tag }] = (0, __alloy_js_core.splitProps)(props, ["children", "tag"]);
+	return [
+		`@${tag} `,
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Boolean(children);
+			},
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createIntrinsic)("align", {
+					width: 2,
+					get children() {
+						return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Prose, { children });
+					}
+				});
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+	];
+}
+/**
+* A component that creates a TSDoc block with `@param` tags for each parameter.
+*/
+function TSDocParams(props) {
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+		each: normalizeParametersForDoc(props.parameters),
+		children: (param) => (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocParam, {
+			get name() {
+				return param.name;
+			},
+			get optional() {
+				return param.optional;
+			},
+			get children() {
+				return param.doc;
+			}
+		})
+	});
+}
+function normalizeParametersForDoc(parameters) {
+	if (parameters.some((p) => typeof p === "string")) return [];
+	return parameters;
+}
+/**
+* Create a TSDoc `@title` tag.
+*/
+function TSDocTitle(props) {
+	const [{ children }, rest] = (0, __alloy_js_core.splitProps)(props, ["children"]);
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocTag, (0, __alloy_js_core_jsx_runtime.mergeProps)(rest, {
+		tag: "title",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@domain` tag.
+*/
+function TSDocDomain(props) {
+	const [{ children }, rest] = (0, __alloy_js_core.splitProps)(props, ["children"]);
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocTag, (0, __alloy_js_core_jsx_runtime.mergeProps)(rest, {
+		tag: "domain",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@alias` tag.
+*/
+function TSDocAlias(props) {
+	const [{ children }, rest] = (0, __alloy_js_core.splitProps)(props, ["children"]);
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocTag, (0, __alloy_js_core_jsx_runtime.mergeProps)(rest, {
+		tag: "alias",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@permission` tag.
+*/
+function TSDocPermission(props) {
+	const [{ children }, rest] = (0, __alloy_js_core.splitProps)(props, ["children"]);
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocTag, (0, __alloy_js_core_jsx_runtime.mergeProps)(rest, {
+		tag: "permission",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@defaultValue` tag.
+*/
+function TSDocDefaultValue(props) {
+	const [{ type, defaultValue }] = (0, __alloy_js_core.splitProps)(props, ["type", "defaultValue"]);
+	return [
+		"@defaultValue ",
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return !(0, __stryke_type_checks_is_undefined.isUndefined)(defaultValue);
+			},
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createIntrinsic)("align", {
+					width: 2,
+					get children() {
+						return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Prose, { get children() {
+							return (0, __powerlines_deepkit_utilities.stringifyDefaultValue)(type, defaultValue);
+						} });
+					}
+				});
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+	];
+}
+/**
+* Create a TSDoc `@remarks` tag.
+*/
+function TSDocRemarks(props) {
+	return [
+		"@remarks ",
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.List, {
+			hardline: true,
+			get children() {
+				return (0, __alloy_js_core.childrenArray)(() => props.children);
+			}
+		})
+	];
+}
+/**
+* Create a TSDoc `@see` tag.
+*/
+function TSDocLink(props) {
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocTag, (0, __alloy_js_core_jsx_runtime.mergeProps)(props, { tag: "see" }));
+}
+/**
+* Create a TSDoc `@example` tag.
+*/
+function TSDocExample(props) {
+	const [{ tsx, fenced = true, language, children }] = (0, __alloy_js_core.splitProps)(props, [
+		"tsx",
+		"fenced",
+		"language",
+		"children"
+	]);
+	return [
+		"@example ",
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			when: fenced,
+			get children() {
+				return [
+					"```",
+					language || (tsx ? "tsx" : "ts"),
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+				];
+			}
+		}),
+		children,
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			when: fenced,
+			get children() {
+				return [(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}), "```"];
+			}
+		})
+	];
+}
+/**
+* Create a TSDoc `@readonly` tag.
+*/
+function TSDocReadonly() {
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocTag, { tag: "readonly" });
+}
+/**
+* Create a TSDoc `@internal` tag.
+*/
+function TSDocInternal() {
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocTag, { tag: "internal" });
+}
+/**
+* Create a TSDoc `@ignore` tag.
+*/
+function TSDocIgnore() {
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocTag, { tag: "ignore" });
+}
+/**
+* Create a TSDoc `@hidden` tag.
+*/
+function TSDocHidden() {
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocTag, { tag: "hidden" });
+}
+/**
+* Generates a TypeScript interface property for the given reflection class.
+*/
+function TSDocAttributesTags(props) {
+	const [{ type, title, alias, permission, domain, readonly, internal, ignore, hidden, defaultValue }] = (0, __alloy_js_core.splitProps)(props, [
+		"type",
+		"title",
+		"alias",
+		"permission",
+		"domain",
+		"readonly",
+		"internal",
+		"ignore",
+		"hidden",
+		"defaultValue"
+	]);
+	return [
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return (0, __stryke_type_checks_is_set_string.isSetString)(title?.trim());
+			},
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocTitle, { children: title });
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return (0, __alloy_js_core_jsx_runtime.memo)(() => !!(!(0, __stryke_type_checks_is_undefined.isUndefined)(alias) && alias.length > 0))() && alias.some((a) => (0, __stryke_type_checks_is_set_string.isSetString)(a?.trim()));
+			},
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+					get each() {
+						return alias?.filter((a) => (0, __stryke_type_checks_is_set_string.isSetString)(a?.trim())) ?? [];
+					},
+					children: (alias$1) => (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocAlias, { children: alias$1 })
+				});
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return (0, __stryke_type_checks_is_set_string.isSetString)(domain?.trim());
+			},
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocDomain, { children: domain });
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return (0, __alloy_js_core_jsx_runtime.memo)(() => !!(!(0, __stryke_type_checks_is_undefined.isUndefined)(permission) && permission.length > 0))() && permission.some((p) => (0, __stryke_type_checks_is_set_string.isSetString)(p?.trim()));
+			},
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+					get each() {
+						return permission?.filter((p) => (0, __stryke_type_checks_is_set_string.isSetString)(p?.trim())) ?? [];
+					},
+					children: (permission$1) => (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocPermission, { children: permission$1 })
+				});
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			when: readonly === true,
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocReadonly, {});
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			when: internal === true,
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocInternal, {});
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			when: ignore === true,
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocIgnore, {});
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			when: hidden === true,
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocHidden, {});
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return (0, __alloy_js_core_jsx_runtime.memo)(() => !!!(0, __stryke_type_checks_is_undefined.isUndefined)(type))() && !(0, __stryke_type_checks_is_undefined.isUndefined)(defaultValue);
+			},
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocDefaultValue, {
+					type,
+					defaultValue
+				});
+			}
+		})
+	];
+}
+/**
+* Create a TSDoc parameter set off with `@param`.
+*/
+function TSDocParam(props) {
+	return [
+		"@param ",
+		(0, __alloy_js_core_jsx_runtime.createComponent)(TSDocParamName, {
+			get name() {
+				return props.name;
+			},
+			get optional() {
+				return props.optional;
+			},
+			get defaultValue() {
+				return props.defaultValue;
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(TSDocParamDescription, { get children() {
+			return props.children;
+		} })
+	];
+}
+function TSDocParamName(props) {
+	return [
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return props.optional;
+			},
+			children: "["
+		}),
+		(0, __alloy_js_core_jsx_runtime.memo)(() => props.name),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Boolean(props.defaultValue);
+			},
+			get children() {
+				return ["=", (0, __alloy_js_core_jsx_runtime.memo)(() => props.defaultValue)];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return props.optional;
+			},
+			children: "]"
+		})
+	];
+}
+function TSDocParamDescription(props) {
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+		get when() {
+			return Boolean(props.children);
+		},
+		get children() {
+			return [" - ", (0, __alloy_js_core_jsx_runtime.createIntrinsic)("align", {
+				width: 2,
+				get children() {
+					return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Prose, { get children() {
+						return props.children;
+					} });
+				}
+			})];
+		}
+	});
+}
+/**
+* Create a TSDoc `@returns` tag.
+*/
+function TSDocReturns(props) {
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocTag, (0, __alloy_js_core_jsx_runtime.mergeProps)(props, { tag: "returns" }));
+}
+/**
+* Create a TSDoc `@throws` tag.
+*/
+function TSDocThrows(props) {
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocTag, (0, __alloy_js_core_jsx_runtime.mergeProps)(props, { tag: "throws" }));
+}
+/**
+* Generates a TSDoc `@module` tag for the given module name.
+*/
+function TSDocModule(props) {
+	const [{ children, name, prefix }] = (0, __alloy_js_core.splitProps)(props, [
+		"children",
+		"name",
+		"prefix"
+	]);
+	const context = require_core_contexts_context.usePowerlinesSafe();
+	return [
+		"/**",
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("align", {
+			string: " * ",
+			get children() {
+				return [
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+						get when() {
+							return Boolean(children);
+						},
+						get children() {
+							return [
+								(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.List, {
+									hardline: true,
+									get children() {
+										return (0, __alloy_js_core.childrenArray)(() => children);
+									}
+								}),
+								(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+								(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+							];
+						}
+					}),
+					"@module ",
+					(0, __alloy_js_core_jsx_runtime.memo)(() => prefix || context?.config?.framework || "powerlines"),
+					":",
+					name
+				];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		` */`
+	];
+}
+
+//#endregion
+exports.TSDoc = TSDoc;
+exports.TSDocAlias = TSDocAlias;
+exports.TSDocAttributesTags = TSDocAttributesTags;
+exports.TSDocDefaultValue = TSDocDefaultValue;
+exports.TSDocDomain = TSDocDomain;
+exports.TSDocExample = TSDocExample;
+exports.TSDocHidden = TSDocHidden;
+exports.TSDocIgnore = TSDocIgnore;
+exports.TSDocInternal = TSDocInternal;
+exports.TSDocLink = TSDocLink;
+exports.TSDocModule = TSDocModule;
+exports.TSDocParam = TSDocParam;
+exports.TSDocParams = TSDocParams;
+exports.TSDocPermission = TSDocPermission;
+exports.TSDocReadonly = TSDocReadonly;
+exports.TSDocRemarks = TSDocRemarks;
+exports.TSDocReturns = TSDocReturns;
+exports.TSDocTag = TSDocTag;
+exports.TSDocThrows = TSDocThrows;
+exports.TSDocTitle = TSDocTitle;

package/dist/typescript/components/tsdoc.d.cts

@@ -1,3 +1,164 @@
-import "../../components-CvqTz7Q9.cjs";
-import { A as __ΩTSDocDefaultValueProps, C as TSDocRemarks, D as TSDocThrows, E as TSDocTagProps, F as __ΩTSDocProps, I as __ΩTSDocTagProps, M as __ΩTSDocModuleProps, N as __ΩTSDocParamProps, O as TSDocTitle, P as __ΩTSDocParamsProps, S as TSDocReadonly, T as TSDocTag, _ as TSDocParamProps, a as TSDocDefaultValue, b as TSDocPermission, c as TSDocExample, d as TSDocIgnore, f as TSDocInternal, g as TSDocParam, h as TSDocModuleProps, i as TSDocAttributesTagsProps, j as __ΩTSDocExampleProps, k as __ΩTSDocAttributesTagsProps, l as TSDocExampleProps, m as TSDocModule, n as TSDocAlias, o as TSDocDefaultValueProps, p as TSDocLink, r as TSDocAttributesTags, s as TSDocDomain, t as TSDoc, u as TSDocHidden, v as TSDocParams, w as TSDocReturns, x as TSDocProps, y as TSDocParamsProps } from "../../tsdoc-DiBR7m1J.cjs";
-export { TSDoc, TSDocAlias, TSDocAttributesTags, TSDocAttributesTagsProps, TSDocDefaultValue, TSDocDefaultValueProps, TSDocDomain, TSDocExample, TSDocExampleProps, TSDocHidden, TSDocIgnore, TSDocInternal, TSDocLink, TSDocModule, TSDocModuleProps, TSDocParam, TSDocParamProps, TSDocParams, TSDocParamsProps, TSDocPermission, TSDocProps, TSDocReadonly, TSDocRemarks, TSDocReturns, TSDocTag, TSDocTagProps, TSDocThrows, TSDocTitle, __ΩTSDocAttributesTagsProps, __ΩTSDocDefaultValueProps, __ΩTSDocExampleProps, __ΩTSDocModuleProps, __ΩTSDocParamProps, __ΩTSDocParamsProps, __ΩTSDocProps, __ΩTSDocTagProps };
+import { ComponentProps } from "../../types/components.cjs";
+import { Children } from "@alloy-js/core";
+import { ReflectionKind, ReflectionParameter, ReflectionProperty } from "@powerlines/deepkit/vendor/type";
+import { JSDocExampleProps, ParameterDescriptor } from "@alloy-js/typescript";
+
+//#region src/typescript/components/tsdoc.d.ts
+interface TSDocProps extends ComponentProps {
+  heading?: Children;
+}
+/**
+ * Generates a TypeScript interface for the given reflection class.
+ */
+declare function TSDoc(props: TSDocProps): Children;
+interface TSDocTagProps extends ComponentProps {
+  tag: string;
+}
+/**
+ * Create a TSDoc `@<props.tag>` tag.
+ */
+declare function TSDocTag(props: TSDocTagProps): Children;
+interface TSDocParamsProps {
+  parameters: ParameterDescriptor[] | string[];
+}
+/**
+ * A component that creates a TSDoc block with `@param` tags for each parameter.
+ */
+declare function TSDocParams(props: TSDocParamsProps): Children;
+/**
+ * Create a TSDoc `@title` tag.
+ */
+declare function TSDocTitle(props: ComponentProps): Children;
+/**
+ * Create a TSDoc `@domain` tag.
+ */
+declare function TSDocDomain(props: ComponentProps): Children;
+/**
+ * Create a TSDoc `@alias` tag.
+ */
+declare function TSDocAlias(props: ComponentProps): Children;
+/**
+ * Create a TSDoc `@permission` tag.
+ */
+declare function TSDocPermission(props: ComponentProps): Children;
+interface TSDocDefaultValueProps extends ComponentProps {
+  type: ReflectionKind | ReflectionProperty | ReflectionParameter;
+  defaultValue: any;
+}
+/**
+ * Create a TSDoc `@defaultValue` tag.
+ */
+declare function TSDocDefaultValue(props: TSDocDefaultValueProps): Children;
+/**
+ * Create a TSDoc `@remarks` tag.
+ */
+declare function TSDocRemarks(props: ComponentProps): Children;
+/**
+ * Create a TSDoc `@see` tag.
+ */
+declare function TSDocLink(props: ComponentProps): Children;
+interface TSDocExampleProps extends JSDocExampleProps {
+  /**
+   * Whether the file is a TSX file.
+   *
+   * @defaultValue false
+   */
+  tsx?: boolean;
+}
+/**
+ * Create a TSDoc `@example` tag.
+ */
+declare function TSDocExample(props: TSDocExampleProps): Children;
+/**
+ * Create a TSDoc `@readonly` tag.
+ */
+declare function TSDocReadonly(): Children;
+/**
+ * Create a TSDoc `@internal` tag.
+ */
+declare function TSDocInternal(): Children;
+/**
+ * Create a TSDoc `@ignore` tag.
+ */
+declare function TSDocIgnore(): Children;
+/**
+ * Create a TSDoc `@hidden` tag.
+ */
+declare function TSDocHidden(): Children;
+interface TSDocAttributesTagsProps {
+  type?: ReflectionKind | ReflectionProperty | ReflectionParameter;
+  title?: string;
+  alias?: string[];
+  permission?: string[];
+  domain?: string;
+  readonly?: boolean;
+  internal?: boolean;
+  ignore?: boolean;
+  hidden?: boolean;
+  defaultValue?: any;
+}
+/**
+ * Generates a TypeScript interface property for the given reflection class.
+ */
+declare function TSDocAttributesTags(props: TSDocAttributesTagsProps): Children;
+interface TSDocParamProps {
+  name: Children;
+  children?: Children;
+  optional?: boolean;
+  defaultValue?: Children;
+}
+/**
+ * Create a TSDoc parameter set off with `@param`.
+ */
+declare function TSDocParam(props: TSDocParamProps): Children;
+/**
+ * Create a TSDoc `@returns` tag.
+ */
+declare function TSDocReturns(props: ComponentProps): Children;
+/**
+ * Create a TSDoc `@throws` tag.
+ */
+declare function TSDocThrows(props: ComponentProps): Children;
+interface TSDocModuleProps extends ComponentProps {
+  /**
+   * The prefix for the builtin module name
+   *
+   * @remarks
+   * This value is populated from the Powerlines configuration output builtin prefix by default.
+   *
+   * @example
+   * ```ts
+   * /**
+   *  @module powerlines:my-module
+   *  \/
+   * ```
+   */
+  prefix?: string;
+  /**
+   * The name of the module
+   *
+   * @remarks
+   * This will be used in the `@module` tag as well as the import path for the module, e.g. `storm:<name>`.
+   *
+   * @example
+   * ```ts
+   * import { MyModule } from "powerlines:my-module";
+   * ```
+   */
+  name: Children;
+}
+/**
+ * Generates a TSDoc `@module` tag for the given module name.
+ */
+declare function TSDocModule(props: TSDocModuleProps): Children;
+declare type __ΩTSDocProps = any[];
+declare type __ΩTSDocTagProps = any[];
+declare type __ΩTSDocParamsProps = any[];
+declare type __ΩTSDocDefaultValueProps = any[];
+declare type __ΩTSDocExampleProps = any[];
+declare type __ΩTSDocAttributesTagsProps = any[];
+declare type __ΩTSDocParamProps = any[];
+declare type __ΩTSDocModuleProps = any[];
+//#endregion
+export { TSDoc, TSDocAlias, TSDocAttributesTags, TSDocAttributesTagsProps, TSDocDefaultValue, TSDocDefaultValueProps, TSDocDomain, TSDocExample, TSDocExampleProps, TSDocHidden, TSDocIgnore, TSDocInternal, TSDocLink, TSDocModule, TSDocModuleProps, TSDocParam, TSDocParamProps, TSDocParams, TSDocParamsProps, TSDocPermission, TSDocProps, TSDocReadonly, TSDocRemarks, TSDocReturns, TSDocTag, TSDocTagProps, TSDocThrows, TSDocTitle, __ΩTSDocAttributesTagsProps, __ΩTSDocDefaultValueProps, __ΩTSDocExampleProps, __ΩTSDocModuleProps, __ΩTSDocParamProps, __ΩTSDocParamsProps, __ΩTSDocProps, __ΩTSDocTagProps };
+//# sourceMappingURL=tsdoc.d.cts.map

package/dist/typescript/components/tsdoc.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsdoc.d.cts","names":[],"sources":["../../../src/typescript/components/tsdoc.tsx"],"sourcesContent":[],"mappings":";;;;;;UAuCiB,UAAA,SAAmB;YACxB;AADZ;AAOA;AAgCA;AAOA;AAgBiB,iBAvDD,KAAA,CAuDiB,KACnB,EAxDe,UAwDf,CAAA,EAxDyB,QAwDN;AAMjB,UA9BC,aAAA,SAAsB,cA8BY,CAAA;EA2BnC,GAAA,EAAA,MAAA;AAahB;AAaA;AAaA;AAUA;AACQ,iBApGQ,QAAA,CAoGR,KAAA,EApGwB,aAoGxB,CAAA,EApGqC,QAoGrC;AAAiB,UApFR,gBAAA,CAoFQ;EAAqB,UAAA,EAnFhC,mBAmFgC,EAAA,GAAA,MAAA,EAAA;;;AAO9C;AAmBA;AAagB,iBApHA,WAAA,CAoHiB,KAAA,EApHE,gBAoHY,CAAA,EApHI,QAoHJ;AAI/C;AAYA;AA4BA;AAOgB,iBA5IA,UAAA,CA4Ia,KAAA,EA5IK,cA4IL,CAAA,EA5ImB,QA4InB;AAO7B;AAOA;AAIA;AACS,iBAlJO,WAAA,CAkJP,KAAA,EAlJ0B,cAkJ1B,CAAA,EAlJwC,QAkJxC;;;;AAeO,iBApJA,UAAA,CAoJmB,KAAQ,EApJT,cAoJS,CAAA,EApJK,QAoJmB;AA+EnE;;;AAIiB,iBA1ND,eAAA,CA0NC,KAAA,EA1NsB,cA0NtB,CAAA,EA1NoC,QA0NpC;AAAQ,UAhNR,sBAAA,SAA+B,cAgNvB,CAAA;EAMT,IAAA,EArNR,cAqNkB,GArND,kBAqNS,GArNY,mBAqNG;EAiDjC,YAAA,EAAA,GAAY;AAO5B;AAIA;AAiCA;;iBA3SgB,iBAAA,QAAyB,yBAAsB;;;;iBAmB/C,YAAA,QAAoB,iBAAc;;;;iBAalC,SAAA,QAAiB,iBAAc;UAI9B,iBAAA,SAA0B;;;;;;;;;;;iBAY3B,YAAA,QAAoB,oBAAiB;;;;iBA4BrC,aAAA,CAAA,GAAa;;;;iBAOb,aAAA,CAAA,GAAa;;;;iBAOb,WAAA,CAAA,GAAW;;;;iBAOX,WAAA,CAAA,GAAW;UAIV,wBAAA;SACR,iBAAiB,qBAAqB;;;;;;;;;;;;;;iBAe/B,mBAAA,QAA2B,2BAAwB;UA+ElD,eAAA;QACT;aACK;;iBAEI;;;;;iBAMD,UAAA,QAAkB,kBAAe;;;;iBAiDjC,YAAA,QAAoB,iBAAc;;;;iBAOlC,WAAA,QAAmB,iBAAc;UAIhC,gBAAA,SAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;QA2BlC;;;;;iBAMQ,WAAA,QAAmB,mBAAgB"}