@powerlines/plugin-alloy 0.26.76 → 0.26.78

package/dist/typescript/components/tsdoc.cjs

@@ -1 +1,497 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../core/contexts/context.cjs`),t=require(`../../core/components/spacing.cjs`);let n=require(`@alloy-js/core/jsx-runtime`),r=require(`@alloy-js/core`),i=require(`@powerlines/deepkit/utilities`),a=require(`@stryke/type-checks/is-undefined`),o=require(`@stryke/type-checks/is-set-string`);function s(e){let[{children:i,heading:o}]=(0,r.splitProps)(e,[`children`,`heading`]);return[`/**`,(0,n.createIntrinsic)(`align`,{string:` * `,get children(){return[(0,n.createIntrinsic)(`hbr`,{}),(0,n.createComponent)(r.Show,{get when(){return!(0,a.isUndefined)(o)},children:o}),(0,n.createComponent)(r.Show,{get when(){return(0,n.memo)(()=>!(0,a.isUndefined)(i))()&&(0,r.childrenArray)(()=>i).filter(Boolean).length>0},get children(){return[(0,n.createComponent)(r.Show,{get when(){return!(0,a.isUndefined)(o)},get children(){return(0,n.createComponent)(t.Spacing,{})}}),(0,n.createComponent)(r.List,{hardline:!1,softline:!0,get children(){return(0,r.childrenArray)(()=>i)}})]}})]}}),(0,n.createIntrinsic)(`hbr`,{}),`*/`,(0,n.createIntrinsic)(`hbr`,{})]}function c(e){let[{children:t,tag:i}]=(0,r.splitProps)(e,[`children`,`tag`]);return[`@${i} `,(0,n.createComponent)(r.Show,{get when(){return!!t},get children(){return(0,n.createIntrinsic)(`align`,{width:2,get children(){return(0,n.createComponent)(r.Prose,{children:t})}})}}),(0,n.createIntrinsic)(`sbr`,{})]}function l(e){return(0,n.createComponent)(r.For,{each:u(e.parameters),children:e=>(0,n.createComponent)(T,{get name(){return e.name},get optional(){return e.optional},get children(){return e.doc}})})}function u(e){return e.some(e=>typeof e==`string`)?[]:e}function d(e){let[{children:t},i]=(0,r.splitProps)(e,[`children`]);return(0,n.createComponent)(c,(0,n.mergeProps)(i,{tag:`title`,children:t}))}function f(e){let[{children:t},i]=(0,r.splitProps)(e,[`children`]);return(0,n.createComponent)(c,(0,n.mergeProps)(i,{tag:`domain`,children:t}))}function p(e){let[{children:t},i]=(0,r.splitProps)(e,[`children`]);return(0,n.createComponent)(c,(0,n.mergeProps)(i,{tag:`alias`,children:t}))}function m(e){let[{children:t},i]=(0,r.splitProps)(e,[`children`]);return(0,n.createComponent)(c,(0,n.mergeProps)(i,{tag:`permission`,children:t}))}function h(e){let[{type:t,defaultValue:o}]=(0,r.splitProps)(e,[`type`,`defaultValue`]);return[`@defaultValue `,(0,n.createComponent)(r.Show,{get when(){return!(0,a.isUndefined)(o)},get children(){return(0,n.createIntrinsic)(`align`,{width:2,get children(){return(0,n.createComponent)(r.Prose,{get children(){return(0,i.stringifyDefaultValue)(t,o)}})}})}})]}function g(e){return[`@remarks `,(0,n.createIntrinsic)(`hbr`,{}),(0,n.createComponent)(r.List,{hardline:!1,softline:!0,get children(){return(0,r.childrenArray)(()=>e.children)}})]}function _(e){return(0,n.createComponent)(c,(0,n.mergeProps)(e,{tag:`see`}))}function v(e){let[{tsx:t,fenced:i=!0,language:a,children:o}]=(0,r.splitProps)(e,[`tsx`,`fenced`,`language`,`children`]);return[`@example `,(0,n.createIntrinsic)(`hbr`,{}),(0,n.createComponent)(r.Show,{when:i,get children(){return["```",a||(t?`tsx`:`ts`),(0,n.createIntrinsic)(`hbr`,{})]}}),o,(0,n.createComponent)(r.Show,{when:i,get children(){return[(0,n.createIntrinsic)(`hbr`,{}),"```"]}})]}function y(){return(0,n.createComponent)(c,{tag:`readonly`})}function b(){return(0,n.createComponent)(c,{tag:`internal`})}function x(){return(0,n.createComponent)(c,{tag:`ignore`})}function S(){return(0,n.createComponent)(c,{tag:`hidden`})}function C(){return(0,n.createComponent)(c,{tag:`runtime`})}function w(e){let[{type:t,alias:i,permission:s,readonly:c,internal:l,ignore:u,hidden:g,runtime:_,defaultValue:v}]=(0,r.splitProps)(e,[`type`,`alias`,`permission`,`readonly`,`internal`,`ignore`,`hidden`,`runtime`,`defaultValue`]),w=(0,r.computed)(()=>e.title?.trim()||``),T=(0,r.computed)(()=>e.domain?.trim()||``);return[(0,n.createComponent)(r.Show,{get when(){return(0,o.isSetString)(w.value)},get children(){return(0,n.createComponent)(d,{get children(){return w.value}})}}),(0,n.createComponent)(r.Show,{get when(){return(0,n.memo)(()=>!(0,a.isUndefined)(i)&&i.length>0)()&&i.some(e=>(0,o.isSetString)(e?.trim()))},get children(){return(0,n.createComponent)(r.For,{get each(){return i?.filter(e=>(0,o.isSetString)(e?.trim()))??[]},children:e=>(0,n.createComponent)(p,{children:e})})}}),(0,n.createComponent)(r.Show,{get when(){return(0,o.isSetString)(T.value)},get children(){return(0,n.createComponent)(f,{get children(){return T.value}})}}),(0,n.createComponent)(r.Show,{get when(){return(0,n.memo)(()=>!(0,a.isUndefined)(s)&&s.length>0)()&&s.some(e=>(0,o.isSetString)(e?.trim()))},get children(){return(0,n.createComponent)(r.For,{get each(){return s?.filter(e=>(0,o.isSetString)(e?.trim()))??[]},children:e=>(0,n.createComponent)(m,{children:e})})}}),(0,n.createComponent)(r.Show,{when:c===!0,get children(){return(0,n.createComponent)(y,{})}}),(0,n.createComponent)(r.Show,{when:l===!0,get children(){return(0,n.createComponent)(b,{})}}),(0,n.createComponent)(r.Show,{when:u===!0,get children(){return(0,n.createComponent)(x,{})}}),(0,n.createComponent)(r.Show,{when:g===!0,get children(){return(0,n.createComponent)(S,{})}}),(0,n.createComponent)(r.Show,{when:_===!0,get children(){return(0,n.createComponent)(C,{})}}),(0,n.createComponent)(r.Show,{get when(){return(0,n.memo)(()=>_!==!0&&!(0,a.isUndefined)(t))()&&!(0,a.isUndefined)(v)},get children(){return(0,n.createComponent)(h,{type:t,defaultValue:v})}})]}function T(e){return[`@param `,(0,n.createComponent)(E,{get name(){return e.name},get optional(){return e.optional},get defaultValue(){return e.defaultValue}}),(0,n.createComponent)(D,{get children(){return e.children}})]}function E(e){return[(0,n.createComponent)(r.Show,{get when(){return e.optional},children:`[`}),(0,n.memo)(()=>e.name),(0,n.createComponent)(r.Show,{get when(){return!!e.defaultValue},get children(){return[`=`,(0,n.memo)(()=>e.defaultValue)]}}),(0,n.createComponent)(r.Show,{get when(){return e.optional},children:`]`})]}function D(e){return(0,n.createComponent)(r.Show,{get when(){return!!e.children},get children(){return[` - `,(0,n.createIntrinsic)(`align`,{width:2,get children(){return(0,n.createComponent)(r.Prose,{get children(){return e.children}})}})]}})}function O(e){return(0,n.createComponent)(c,(0,n.mergeProps)(e,{tag:`returns`}))}function k(e){return(0,n.createComponent)(c,(0,n.mergeProps)(e,{tag:`throws`}))}function A(i){let[{children:a,name:o,prefix:s}]=(0,r.splitProps)(i,[`children`,`name`,`prefix`]),c=e.usePowerlinesSafe();return[`/**`,(0,n.createIntrinsic)(`align`,{string:` * `,get children(){return[(0,n.createIntrinsic)(`hbr`,{}),(0,n.createComponent)(r.Show,{get when(){return!!a},get children(){return[(0,n.createComponent)(r.List,{hardline:!1,softline:!0,get children(){return(0,r.childrenArray)(()=>a)}}),(0,n.createComponent)(t.Spacing,{})]}}),`@module `,(0,n.memo)(()=>s||c?.config?.framework||`powerlines`),`:`,o]}}),(0,n.createIntrinsic)(`hbr`,{}),` */`]}exports.TSDoc=s,exports.TSDocAlias=p,exports.TSDocAttributesTags=w,exports.TSDocDefaultValue=h,exports.TSDocDomain=f,exports.TSDocExample=v,exports.TSDocHidden=S,exports.TSDocIgnore=x,exports.TSDocInternal=b,exports.TSDocLink=_,exports.TSDocModule=A,exports.TSDocParam=T,exports.TSDocParams=l,exports.TSDocPermission=m,exports.TSDocReadonly=y,exports.TSDocRemarks=g,exports.TSDocReturns=O,exports.TSDocRuntime=C,exports.TSDocTag=c,exports.TSDocThrows=k,exports.TSDocTitle=d;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_core_contexts_context = require('../../core/contexts/context.cjs');
+const require_core_components_spacing = require('../../core/components/spacing.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");
+
+//#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);
+						},
+						children: heading
+					}),
+					(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).filter(Boolean).length > 0;
+						},
+						get children() {
+							return [(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 (0, _alloy_js_core_jsx_runtime.createComponent)(require_core_components_spacing.Spacing, {});
+								}
+							}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.List, {
+								hardline: false,
+								softline: 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", {})
+	];
+}
+/**
+* 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)("sbr", {})
+	];
+}
+/**
+* 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);
+					} });
+				}
+			});
+		}
+	})];
+}
+/**
+* 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: false,
+			softline: 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" });
+}
+/**
+* Create a TSDoc `@runtime` tag.
+*/
+function TSDocRuntime() {
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocTag, { tag: "runtime" });
+}
+/**
+* Generates a TypeScript interface property for the given reflection class.
+*/
+function TSDocAttributesTags(props) {
+	const [{ type, alias, permission, readonly, internal, ignore, hidden, runtime, defaultValue }] = (0, _alloy_js_core.splitProps)(props, [
+		"type",
+		"alias",
+		"permission",
+		"readonly",
+		"internal",
+		"ignore",
+		"hidden",
+		"runtime",
+		"defaultValue"
+	]);
+	const title = (0, _alloy_js_core.computed)(() => props.title?.trim() || "");
+	const domain = (0, _alloy_js_core.computed)(() => props.domain?.trim() || "");
+	return [
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			get when() {
+				return (0, _stryke_type_checks_is_set_string.isSetString)(title.value);
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocTitle, { get children() {
+					return title.value;
+				} });
+			}
+		}),
+		(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) => (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocAlias, { children: alias })
+				});
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			get when() {
+				return (0, _stryke_type_checks_is_set_string.isSetString)(domain.value);
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocDomain, { get children() {
+					return domain.value;
+				} });
+			}
+		}),
+		(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) => (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocPermission, { children: permission })
+				});
+			}
+		}),
+		(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, {
+			when: runtime === true,
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocRuntime, {});
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			get when() {
+				return (0, _alloy_js_core_jsx_runtime.memo)(() => !!(runtime !== true && !(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: false,
+								softline: true,
+								get children() {
+									return (0, _alloy_js_core.childrenArray)(() => children);
+								}
+							}), (0, _alloy_js_core_jsx_runtime.createComponent)(require_core_components_spacing.Spacing, {})];
+						}
+					}),
+					"@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.TSDocRuntime = TSDocRuntime;
+exports.TSDocTag = TSDocTag;
+exports.TSDocThrows = TSDocThrows;
+exports.TSDocTitle = TSDocTitle;