@powerlines/plugin-alloy 0.25.30 → 0.25.31

package/dist/typescript/components/tsdoc.mjs

@@ -1,6 +1,7 @@
 import { usePowerlinesSafe } from "../../core/contexts/context.mjs";
 import { Spacing } from "../../core/components/spacing.mjs";
 import { For, List, Prose, Show, childrenArray, computed, splitProps } from "@alloy-js/core";
+import { Fragment, jsx, jsxs } from "@alloy-js/core/jsx-runtime";
 import { stringifyDefaultValue } from "@powerlines/deepkit/utilities";
 import { isUndefined } from "@stryke/type-checks/is-undefined";
 import { isSetString } from "@stryke/type-checks/is-set-string";
@@ -11,48 +12,59 @@ import { isSetString } from "@stryke/type-checks/is-set-string";
 */
 function TSDoc(props) {
 	const [{ children, heading }] = splitProps(props, ["children", "heading"]);
-	return <>
-      /**
-      <align string=" * ">
-        <hbr />
-        <Show when={!isUndefined(heading)}>{heading}</Show>
-        <Show when={!isUndefined(children) && childrenArray(() => children).filter(Boolean).length > 0}>
-          <Show when={!isUndefined(heading)}>
-            <Spacing />
-          </Show>
-          <List>{childrenArray(() => children)}</List>
-        </Show>
-      </align>
-      <hbr />
-      {`*/`}
-      <hbr />
-    </>;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		"/**",
+		/* @__PURE__ */ jsxs("align", {
+			string: " * ",
+			children: [
+				/* @__PURE__ */ jsx("hbr", {}),
+				/* @__PURE__ */ jsx(Show, {
+					when: !isUndefined(heading),
+					children: heading
+				}),
+				/* @__PURE__ */ jsxs(Show, {
+					when: !isUndefined(children) && childrenArray(() => children).filter(Boolean).length > 0,
+					children: [/* @__PURE__ */ jsx(Show, {
+						when: !isUndefined(heading),
+						children: /* @__PURE__ */ jsx(Spacing, {})
+					}), /* @__PURE__ */ jsx(List, { children: childrenArray(() => children) })]
+				})
+			]
+		}),
+		/* @__PURE__ */ jsx("hbr", {}),
+		`*/`,
+		/* @__PURE__ */ jsx("hbr", {})
+	] });
 }
 /**
 * Create a TSDoc `@<props.tag>` tag.
 */
 function TSDocTag(props) {
 	const [{ children, tag }] = splitProps(props, ["children", "tag"]);
-	return <>
-      {`@${tag} `}
-      <Show when={Boolean(children)}>
-        <align width={2}>
-          <Prose>{children}</Prose>
-        </align>
-      </Show>
-      <sbr />
-    </>;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		`@${tag} `,
+		/* @__PURE__ */ jsx(Show, {
+			when: Boolean(children),
+			children: /* @__PURE__ */ jsx("align", {
+				width: 2,
+				children: /* @__PURE__ */ jsx(Prose, { children })
+			})
+		}),
+		/* @__PURE__ */ jsx("sbr", {})
+	] });
 }
 /**
 * A component that creates a TSDoc block with `@param` tags for each parameter.
 */
 function TSDocParams(props) {
-	const parameters = normalizeParametersForDoc(props.parameters);
-	return <For each={parameters}>
-      {(param) => <TSDocParam name={param.name} optional={param.optional}>
-          {param.doc}
-        </TSDocParam>}
-    </For>;
+	return /* @__PURE__ */ jsx(For, {
+		each: normalizeParametersForDoc(props.parameters),
+		children: (param) => /* @__PURE__ */ jsx(TSDocParam, {
+			name: param.name,
+			optional: param.optional,
+			children: param.doc
+		})
+	});
 }
 function normalizeParametersForDoc(parameters) {
 	if (parameters.some((p) => typeof p === "string")) return [];
@@ -63,66 +75,79 @@ function normalizeParametersForDoc(parameters) {
 */
 function TSDocTitle(props) {
 	const [{ children }, rest] = splitProps(props, ["children"]);
-	return <TSDocTag {...rest} tag="title">
-      {children}
-    </TSDocTag>;
+	return /* @__PURE__ */ jsx(TSDocTag, {
+		...rest,
+		tag: "title",
+		children
+	});
 }
 /**
 * Create a TSDoc `@domain` tag.
 */
 function TSDocDomain(props) {
 	const [{ children }, rest] = splitProps(props, ["children"]);
-	return <TSDocTag {...rest} tag="domain">
-      {children}
-    </TSDocTag>;
+	return /* @__PURE__ */ jsx(TSDocTag, {
+		...rest,
+		tag: "domain",
+		children
+	});
 }
 /**
 * Create a TSDoc `@alias` tag.
 */
 function TSDocAlias(props) {
 	const [{ children }, rest] = splitProps(props, ["children"]);
-	return <TSDocTag {...rest} tag="alias">
-      {children}
-    </TSDocTag>;
+	return /* @__PURE__ */ jsx(TSDocTag, {
+		...rest,
+		tag: "alias",
+		children
+	});
 }
 /**
 * Create a TSDoc `@permission` tag.
 */
 function TSDocPermission(props) {
 	const [{ children }, rest] = splitProps(props, ["children"]);
-	return <TSDocTag {...rest} tag="permission">
-      {children}
-    </TSDocTag>;
+	return /* @__PURE__ */ jsx(TSDocTag, {
+		...rest,
+		tag: "permission",
+		children
+	});
 }
 /**
 * Create a TSDoc `@defaultValue` tag.
 */
 function TSDocDefaultValue(props) {
 	const [{ type, defaultValue }] = splitProps(props, ["type", "defaultValue"]);
-	return <>
-      {"@defaultValue "}
-      <Show when={!isUndefined(defaultValue)}>
-        <align width={2}>
-          <Prose>{stringifyDefaultValue(type, defaultValue)}</Prose>
-        </align>
-      </Show>
-    </>;
+	return /* @__PURE__ */ jsxs(Fragment, { children: ["@defaultValue ", /* @__PURE__ */ jsx(Show, {
+		when: !isUndefined(defaultValue),
+		children: /* @__PURE__ */ jsx("align", {
+			width: 2,
+			children: /* @__PURE__ */ jsx(Prose, { children: stringifyDefaultValue(type, defaultValue) })
+		})
+	})] });
 }
 /**
 * Create a TSDoc `@remarks` tag.
 */
 function TSDocRemarks(props) {
-	return <>
-      {"@remarks "}
-      <hbr />
-      <List hardline={true}>{childrenArray(() => props.children)}</List>
-    </>;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		"@remarks ",
+		/* @__PURE__ */ jsx("hbr", {}),
+		/* @__PURE__ */ jsx(List, {
+			hardline: true,
+			children: childrenArray(() => props.children)
+		})
+	] });
 }
 /**
 * Create a TSDoc `@see` tag.
 */
 function TSDocLink(props) {
-	return <TSDocTag {...props} tag="see" />;
+	return /* @__PURE__ */ jsx(TSDocTag, {
+		...props,
+		tag: "see"
+	});
 }
 /**
 * Create a TSDoc `@example` tag.
@@ -134,43 +159,47 @@ function TSDocExample(props) {
 		"language",
 		"children"
 	]);
-	return <>
-      {"@example "}
-      <hbr />
-      <Show when={fenced}>
-        ```{language || (tsx ? "tsx" : "ts")}
-        <hbr />
-      </Show>
-      {children}
-      <Show when={fenced}>
-        <hbr />
-        ```
-      </Show>
-    </>;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		"@example ",
+		/* @__PURE__ */ jsx("hbr", {}),
+		/* @__PURE__ */ jsxs(Show, {
+			when: fenced,
+			children: [
+				"```",
+				language || (tsx ? "tsx" : "ts"),
+				/* @__PURE__ */ jsx("hbr", {})
+			]
+		}),
+		children,
+		/* @__PURE__ */ jsxs(Show, {
+			when: fenced,
+			children: [/* @__PURE__ */ jsx("hbr", {}), "```"]
+		})
+	] });
 }
 /**
 * Create a TSDoc `@readonly` tag.
 */
 function TSDocReadonly() {
-	return <TSDocTag tag="readonly" />;
+	return /* @__PURE__ */ jsx(TSDocTag, { tag: "readonly" });
 }
 /**
 * Create a TSDoc `@internal` tag.
 */
 function TSDocInternal() {
-	return <TSDocTag tag="internal" />;
+	return /* @__PURE__ */ jsx(TSDocTag, { tag: "internal" });
 }
 /**
 * Create a TSDoc `@ignore` tag.
 */
 function TSDocIgnore() {
-	return <TSDocTag tag="ignore" />;
+	return /* @__PURE__ */ jsx(TSDocTag, { tag: "ignore" });
 }
 /**
 * Create a TSDoc `@hidden` tag.
 */
 function TSDocHidden() {
-	return <TSDocTag tag="hidden" />;
+	return /* @__PURE__ */ jsx(TSDocTag, { tag: "hidden" });
 }
 /**
 * Generates a TypeScript interface property for the given reflection class.
@@ -188,77 +217,111 @@ function TSDocAttributesTags(props) {
 	]);
 	const title = computed(() => props.title?.trim() || "");
 	const domain = computed(() => props.domain?.trim() || "");
-	return <>
-      <Show when={isSetString(title.value)}>
-        <TSDocTitle>{title.value}</TSDocTitle>
-      </Show>
-      <Show when={!isUndefined(alias) && alias.length > 0 && alias.some((a) => isSetString(a?.trim()))}>
-        <For each={alias?.filter((a) => isSetString(a?.trim())) ?? []}>
-          {(alias) => <TSDocAlias>{alias}</TSDocAlias>}
-        </For>
-      </Show>
-      <Show when={isSetString(domain.value)}>
-        <TSDocDomain>{domain.value}</TSDocDomain>
-      </Show>
-      <Show when={!isUndefined(permission) && permission.length > 0 && permission.some((p) => isSetString(p?.trim()))}>
-        <For each={permission?.filter((p) => isSetString(p?.trim())) ?? []}>
-          {(permission) => <TSDocPermission>{permission}</TSDocPermission>}
-        </For>
-      </Show>
-      <Show when={readonly === true}>
-        <TSDocReadonly />
-      </Show>
-      <Show when={internal === true}>
-        <TSDocInternal />
-      </Show>
-      <Show when={ignore === true}>
-        <TSDocIgnore />
-      </Show>
-      <Show when={hidden === true}>
-        <TSDocHidden />
-      </Show>
-      <Show when={!isUndefined(type) && !isUndefined(defaultValue)}>
-        <TSDocDefaultValue type={type} defaultValue={defaultValue} />
-      </Show>
-    </>;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		/* @__PURE__ */ jsx(Show, {
+			when: isSetString(title.value),
+			children: /* @__PURE__ */ jsx(TSDocTitle, { children: title.value })
+		}),
+		/* @__PURE__ */ jsx(Show, {
+			when: !isUndefined(alias) && alias.length > 0 && alias.some((a) => isSetString(a?.trim())),
+			children: /* @__PURE__ */ jsx(For, {
+				each: alias?.filter((a) => isSetString(a?.trim())) ?? [],
+				children: (alias) => /* @__PURE__ */ jsx(TSDocAlias, { children: alias })
+			})
+		}),
+		/* @__PURE__ */ jsx(Show, {
+			when: isSetString(domain.value),
+			children: /* @__PURE__ */ jsx(TSDocDomain, { children: domain.value })
+		}),
+		/* @__PURE__ */ jsx(Show, {
+			when: !isUndefined(permission) && permission.length > 0 && permission.some((p) => isSetString(p?.trim())),
+			children: /* @__PURE__ */ jsx(For, {
+				each: permission?.filter((p) => isSetString(p?.trim())) ?? [],
+				children: (permission) => /* @__PURE__ */ jsx(TSDocPermission, { children: permission })
+			})
+		}),
+		/* @__PURE__ */ jsx(Show, {
+			when: readonly === true,
+			children: /* @__PURE__ */ jsx(TSDocReadonly, {})
+		}),
+		/* @__PURE__ */ jsx(Show, {
+			when: internal === true,
+			children: /* @__PURE__ */ jsx(TSDocInternal, {})
+		}),
+		/* @__PURE__ */ jsx(Show, {
+			when: ignore === true,
+			children: /* @__PURE__ */ jsx(TSDocIgnore, {})
+		}),
+		/* @__PURE__ */ jsx(Show, {
+			when: hidden === true,
+			children: /* @__PURE__ */ jsx(TSDocHidden, {})
+		}),
+		/* @__PURE__ */ jsx(Show, {
+			when: !isUndefined(type) && !isUndefined(defaultValue),
+			children: /* @__PURE__ */ jsx(TSDocDefaultValue, {
+				type,
+				defaultValue
+			})
+		})
+	] });
 }
 /**
 * Create a TSDoc parameter set off with `@param`.
 */
 function TSDocParam(props) {
-	return <>
-      {"@param "}
-      <TSDocParamName name={props.name} optional={props.optional} defaultValue={props.defaultValue} />
-      <TSDocParamDescription children={props.children} />
-    </>;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		"@param ",
+		/* @__PURE__ */ jsx(TSDocParamName, {
+			name: props.name,
+			optional: props.optional,
+			defaultValue: props.defaultValue
+		}),
+		/* @__PURE__ */ jsx(TSDocParamDescription, { children: props.children })
+	] });
 }
 function TSDocParamName(props) {
-	return <>
-      <Show when={props.optional}>{"["}</Show>
-      {props.name}
-      <Show when={Boolean(props.defaultValue)}>={props.defaultValue}</Show>
-      <Show when={props.optional}>{"]"}</Show>
-    </>;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		/* @__PURE__ */ jsx(Show, {
+			when: props.optional,
+			children: "["
+		}),
+		props.name,
+		/* @__PURE__ */ jsxs(Show, {
+			when: Boolean(props.defaultValue),
+			children: ["=", props.defaultValue]
+		}),
+		/* @__PURE__ */ jsx(Show, {
+			when: props.optional,
+			children: "]"
+		})
+	] });
 }
 function TSDocParamDescription(props) {
-	return <Show when={Boolean(props.children)}>
-      {" - "}
-      <align width={2}>
-        <Prose>{props.children}</Prose>
-      </align>
-    </Show>;
+	return /* @__PURE__ */ jsxs(Show, {
+		when: Boolean(props.children),
+		children: [" - ", /* @__PURE__ */ jsx("align", {
+			width: 2,
+			children: /* @__PURE__ */ jsx(Prose, { children: props.children })
+		})]
+	});
 }
 /**
 * Create a TSDoc `@returns` tag.
 */
 function TSDocReturns(props) {
-	return <TSDocTag {...props} tag="returns" />;
+	return /* @__PURE__ */ jsx(TSDocTag, {
+		...props,
+		tag: "returns"
+	});
 }
 /**
 * Create a TSDoc `@throws` tag.
 */
 function TSDocThrows(props) {
-	return <TSDocTag {...props} tag="throws" />;
+	return /* @__PURE__ */ jsx(TSDocTag, {
+		...props,
+		tag: "throws"
+	});
 }
 /**
 * Generates a TSDoc `@module` tag for the given module name.
@@ -270,20 +333,28 @@ function TSDocModule(props) {
 		"prefix"
 	]);
 	const context = usePowerlinesSafe();
-	return <>
-      /**
-      <align string=" * ">
-        <hbr />
-        <Show when={Boolean(children)}>
-          <List hardline={true}>{childrenArray(() => children)}</List>
-          <Spacing />
-        </Show>
-        {"@module "}
-        {prefix || context?.config?.framework || "powerlines"}:{name}
-      </align>
-      <hbr />
-      {` */`}
-    </>;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		"/**",
+		/* @__PURE__ */ jsxs("align", {
+			string: " * ",
+			children: [
+				/* @__PURE__ */ jsx("hbr", {}),
+				/* @__PURE__ */ jsxs(Show, {
+					when: Boolean(children),
+					children: [/* @__PURE__ */ jsx(List, {
+						hardline: true,
+						children: childrenArray(() => children)
+					}), /* @__PURE__ */ jsx(Spacing, {})]
+				}),
+				"@module ",
+				prefix || context?.config?.framework || "powerlines",
+				":",
+				name
+			]
+		}),
+		/* @__PURE__ */ jsx("hbr", {}),
+		` */`
+	] });
 }
 
 //#endregion

package/dist/typescript/components/tsdoc.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tsdoc.mjs","names":[],"sources":["../../../src/typescript/components/tsdoc.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport {\n  Children,\n  childrenArray,\n  computed,\n  For,\n  List,\n  Prose,\n  Show,\n  splitProps\n} from \"@alloy-js/core\";\nimport { JSDocExampleProps, ParameterDescriptor } from \"@alloy-js/typescript\";\nimport { stringifyDefaultValue } from \"@powerlines/deepkit/utilities\";\nimport {\n  ReflectionKind,\n  ReflectionParameter,\n  ReflectionProperty\n} from \"@powerlines/deepkit/vendor/type\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isUndefined } from \"@stryke/type-checks/is-undefined\";\nimport { Spacing } from \"../../core/components/spacing\";\nimport { usePowerlinesSafe } from \"../../core/contexts/context\";\nimport { ComponentProps } from \"../../types/components\";\n\nexport interface TSDocProps extends ComponentProps {\n  heading?: Children;\n}\n\n/**\n * Generates a TypeScript interface for the given reflection class.\n */\nexport function TSDoc(props: TSDocProps) {\n  const [{ children, heading }] = splitProps(props, [\"children\", \"heading\"]);\n\n  return (\n    <>\n      /**\n      <align string=\" * \">\n        <hbr />\n        <Show when={!isUndefined(heading)}>{heading}</Show>\n        <Show\n          when={\n            !isUndefined(children) &&\n            childrenArray(() => children).filter(Boolean).length > 0\n          }>\n          <Show when={!isUndefined(heading)}>\n            <Spacing />\n          </Show>\n          <List>{childrenArray(() => children)}</List>\n        </Show>\n      </align>\n      <hbr />\n      {`*/`}\n      <hbr />\n    </>\n  );\n}\n\nexport interface TSDocTagProps extends ComponentProps {\n  tag: string;\n}\n\n/**\n * Create a TSDoc `@<props.tag>` tag.\n */\nexport function TSDocTag(props: TSDocTagProps) {\n  const [{ children, tag }] = splitProps(props, [\"children\", \"tag\"]);\n\n  return (\n    <>\n      {`@${tag} `}\n      <Show when={Boolean(children)}>\n        <align width={2}>\n          <Prose>{children}</Prose>\n        </align>\n      </Show>\n      <sbr />\n    </>\n  );\n}\n\nexport interface TSDocParamsProps {\n  parameters: ParameterDescriptor[] | string[];\n}\n\n/**\n * A component that creates a TSDoc block with `@param` tags for each parameter.\n */\nexport function TSDocParams(props: TSDocParamsProps) {\n  const parameters = normalizeParametersForDoc(props.parameters);\n\n  return (\n    <For each={parameters}>\n      {param => (\n        <TSDocParam name={param.name} optional={param.optional}>\n          {param.doc}\n        </TSDocParam>\n      )}\n    </For>\n  );\n}\n\nfunction normalizeParametersForDoc(\n  parameters: ParameterDescriptor[] | string[]\n): ParameterDescriptor[] {\n  if (parameters.some(p => typeof p === \"string\")) {\n    return [];\n  }\n\n  return parameters as ParameterDescriptor[];\n}\n\n/**\n * Create a TSDoc `@title` tag.\n */\nexport function TSDocTitle(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"title\">\n      {children}\n    </TSDocTag>\n  );\n}\n\n/**\n * Create a TSDoc `@domain` tag.\n */\nexport function TSDocDomain(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"domain\">\n      {children}\n    </TSDocTag>\n  );\n}\n\n/**\n * Create a TSDoc `@alias` tag.\n */\nexport function TSDocAlias(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"alias\">\n      {children}\n    </TSDocTag>\n  );\n}\n\n/**\n * Create a TSDoc `@permission` tag.\n */\nexport function TSDocPermission(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"permission\">\n      {children}\n    </TSDocTag>\n  );\n}\n\nexport interface TSDocDefaultValueProps extends ComponentProps {\n  type: ReflectionKind | ReflectionProperty | ReflectionParameter;\n  defaultValue: any;\n}\n\n/**\n * Create a TSDoc `@defaultValue` tag.\n */\nexport function TSDocDefaultValue(props: TSDocDefaultValueProps) {\n  const [{ type, defaultValue }] = splitProps(props, [\"type\", \"defaultValue\"]);\n\n  return (\n    <>\n      {\"@defaultValue \"}\n      <Show when={!isUndefined(defaultValue)}>\n        <align width={2}>\n          <Prose>{stringifyDefaultValue(type, defaultValue)}</Prose>\n        </align>\n      </Show>\n    </>\n  );\n}\n\n/**\n * Create a TSDoc `@remarks` tag.\n */\nexport function TSDocRemarks(props: ComponentProps) {\n  return (\n    <>\n      {\"@remarks \"}\n      <hbr />\n      <List hardline={true}>{childrenArray(() => props.children)}</List>\n    </>\n  );\n}\n\n/**\n * Create a TSDoc `@see` tag.\n */\nexport function TSDocLink(props: ComponentProps) {\n  return <TSDocTag {...props} tag=\"see\" />;\n}\n\nexport interface TSDocExampleProps extends JSDocExampleProps {\n  /**\n   * Whether the file is a TSX file.\n   *\n   * @defaultValue false\n   */\n  tsx?: boolean;\n}\n\n/**\n * Create a TSDoc `@example` tag.\n */\nexport function TSDocExample(props: TSDocExampleProps) {\n  const [{ tsx, fenced = true, language, children }] = splitProps(props, [\n    \"tsx\",\n    \"fenced\",\n    \"language\",\n    \"children\"\n  ]);\n\n  return (\n    <>\n      {\"@example \"}\n      <hbr />\n      <Show when={fenced}>\n        ```{language || (tsx ? \"tsx\" : \"ts\")}\n        <hbr />\n      </Show>\n      {children}\n      <Show when={fenced}>\n        <hbr />\n        ```\n      </Show>\n    </>\n  );\n}\n\n/**\n * Create a TSDoc `@readonly` tag.\n */\nexport function TSDocReadonly() {\n  return <TSDocTag tag=\"readonly\" />;\n}\n\n/**\n * Create a TSDoc `@internal` tag.\n */\nexport function TSDocInternal() {\n  return <TSDocTag tag=\"internal\" />;\n}\n\n/**\n * Create a TSDoc `@ignore` tag.\n */\nexport function TSDocIgnore() {\n  return <TSDocTag tag=\"ignore\" />;\n}\n\n/**\n * Create a TSDoc `@hidden` tag.\n */\nexport function TSDocHidden() {\n  return <TSDocTag tag=\"hidden\" />;\n}\n\nexport interface TSDocAttributesTagsProps {\n  type?: ReflectionKind | ReflectionProperty | ReflectionParameter;\n  title?: string;\n  alias?: string[];\n  permission?: string[];\n  domain?: string;\n  readonly?: boolean;\n  internal?: boolean;\n  ignore?: boolean;\n  hidden?: boolean;\n  defaultValue?: any;\n}\n\n/**\n * Generates a TypeScript interface property for the given reflection class.\n */\nexport function TSDocAttributesTags(props: TSDocAttributesTagsProps) {\n  const [\n    {\n      type,\n      alias,\n      permission,\n      readonly,\n      internal,\n      ignore,\n      hidden,\n      defaultValue\n    }\n  ] = splitProps(props, [\n    \"type\",\n    \"alias\",\n    \"permission\",\n    \"readonly\",\n    \"internal\",\n    \"ignore\",\n    \"hidden\",\n    \"defaultValue\"\n  ]);\n\n  const title = computed(() => props.title?.trim() || \"\");\n  const domain = computed(() => props.domain?.trim() || \"\");\n\n  return (\n    <>\n      <Show when={isSetString(title.value)}>\n        <TSDocTitle>{title.value}</TSDocTitle>\n      </Show>\n      <Show\n        when={\n          !isUndefined(alias) &&\n          alias.length > 0 &&\n          alias.some(a => isSetString(a?.trim()))\n        }>\n        <For each={alias?.filter(a => isSetString(a?.trim())) ?? []}>\n          {alias => <TSDocAlias>{alias}</TSDocAlias>}\n        </For>\n      </Show>\n      <Show when={isSetString(domain.value)}>\n        <TSDocDomain>{domain.value}</TSDocDomain>\n      </Show>\n      <Show\n        when={\n          !isUndefined(permission) &&\n          permission.length > 0 &&\n          permission.some(p => isSetString(p?.trim()))\n        }>\n        <For each={permission?.filter(p => isSetString(p?.trim())) ?? []}>\n          {permission => <TSDocPermission>{permission}</TSDocPermission>}\n        </For>\n      </Show>\n      <Show when={readonly === true}>\n        <TSDocReadonly />\n      </Show>\n      <Show when={internal === true}>\n        <TSDocInternal />\n      </Show>\n      <Show when={ignore === true}>\n        <TSDocIgnore />\n      </Show>\n      <Show when={hidden === true}>\n        <TSDocHidden />\n      </Show>\n      <Show when={!isUndefined(type) && !isUndefined(defaultValue)}>\n        <TSDocDefaultValue\n          type={\n            type as ReflectionKind | ReflectionProperty | ReflectionParameter\n          }\n          defaultValue={defaultValue}\n        />\n      </Show>\n    </>\n  );\n}\n\nexport interface TSDocParamProps {\n  name: Children;\n  children?: Children;\n  optional?: boolean;\n  defaultValue?: Children;\n}\n\n/**\n * Create a TSDoc parameter set off with `@param`.\n */\nexport function TSDocParam(props: TSDocParamProps) {\n  return (\n    <>\n      {\"@param \"}\n      <TSDocParamName\n        name={props.name}\n        optional={props.optional}\n        defaultValue={props.defaultValue}\n      />\n      <TSDocParamDescription children={props.children} />\n    </>\n  );\n}\n\ninterface TSDocParamNameProps {\n  name: Children;\n  optional?: boolean;\n  defaultValue?: Children;\n}\n\nfunction TSDocParamName(props: TSDocParamNameProps) {\n  return (\n    <>\n      <Show when={props.optional}>{\"[\"}</Show>\n      {props.name}\n      <Show when={Boolean(props.defaultValue)}>={props.defaultValue}</Show>\n      <Show when={props.optional}>{\"]\"}</Show>\n    </>\n  );\n}\n\ninterface TSDocParamDescriptionProps {\n  children?: Children;\n}\n\nfunction TSDocParamDescription(props: TSDocParamDescriptionProps) {\n  return (\n    <Show when={Boolean(props.children)}>\n      {\" - \"}\n      <align width={2}>\n        <Prose>{props.children}</Prose>\n      </align>\n    </Show>\n  );\n}\n\n/**\n * Create a TSDoc `@returns` tag.\n */\nexport function TSDocReturns(props: ComponentProps) {\n  return <TSDocTag {...props} tag=\"returns\" />;\n}\n\n/**\n * Create a TSDoc `@throws` tag.\n */\nexport function TSDocThrows(props: ComponentProps) {\n  return <TSDocTag {...props} tag=\"throws\" />;\n}\n\nexport interface TSDocModuleProps extends ComponentProps {\n  /**\n   * The prefix for the builtin module name\n   *\n   * @remarks\n   * This value is populated from the Powerlines configuration output builtin prefix by default.\n   *\n   * @example\n   * ```ts\n   * /**\n   *  @module powerlines:my-module\n   *  \\/\n   * ```\n   */\n  prefix?: string;\n\n  /**\n   * The name of the module\n   *\n   * @remarks\n   * This will be used in the `@module` tag as well as the import path for the module, e.g. `storm:<name>`.\n   *\n   * @example\n   * ```ts\n   * import { MyModule } from \"powerlines:my-module\";\n   * ```\n   */\n  name: Children;\n}\n\n/**\n * Generates a TSDoc `@module` tag for the given module name.\n */\nexport function TSDocModule(props: TSDocModuleProps) {\n  const [{ children, name, prefix }] = splitProps(props, [\n    \"children\",\n    \"name\",\n    \"prefix\"\n  ]);\n\n  const context = usePowerlinesSafe();\n\n  return (\n    <>\n      /**\n      <align string=\" * \">\n        <hbr />\n        <Show when={Boolean(children)}>\n          <List hardline={true}>{childrenArray(() => children)}</List>\n          <Spacing />\n        </Show>\n        {\"@module \"}\n        {prefix || context?.config?.framework || \"powerlines\"}:{name}\n      </align>\n      <hbr />\n      {` */`}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;AAgDA,SAAgB,MAAM,OAAmB;CACvC,MAAM,CAAC,EAAE,UAAU,aAAa,WAAW,OAAO,CAAC,YAAY,UAAU,CAAC;AAE1E,QACE,EAAE;;MAEA,CAAC,MAAM,aAAa;QAClB,CAAC,MAAM;QACP,CAAC,KAAK,MAAM,CAAC,YAAY,QAAQ,GAAG,QAAQ,EAAE,KAAK;QACnD,CAAC,KACC,MACE,CAAC,YAAY,SAAS,IACtB,oBAAoB,SAAS,CAAC,OAAO,QAAQ,CAAC,SAAS,GACvD;UACF,CAAC,KAAK,MAAM,CAAC,YAAY,QAAQ,EAAE;YACjC,CAAC,UAAU;UACb,EAAE,KAAK;UACP,CAAC,MAAM,oBAAoB,SAAS,CAAC,EAAE,KAAK;QAC9C,EAAE,KAAK;MACT,EAAE,MAAM;MACR,CAAC,MAAM;OACN,KAAK;MACN,CAAC,MAAM;IACT;;;;;AAWJ,SAAgB,SAAS,OAAsB;CAC7C,MAAM,CAAC,EAAE,UAAU,SAAS,WAAW,OAAO,CAAC,YAAY,MAAM,CAAC;AAElE,QACE,EAAE;OACC,IAAI,IAAI,GAAG;MACZ,CAAC,KAAK,MAAM,QAAQ,SAAS,EAAE;QAC7B,CAAC,MAAM,OAAO,GAAG;UACf,CAAC,OAAO,SAAS,EAAE,MAAM;QAC3B,EAAE,MAAM;MACV,EAAE,KAAK;MACP,CAAC,MAAM;IACT;;;;;AAWJ,SAAgB,YAAY,OAAyB;CACnD,MAAM,aAAa,0BAA0B,MAAM,WAAW;AAE9D,QACE,CAAC,IAAI,MAAM,YAAY;QACpB,UACC,CAAC,WAAW,MAAM,MAAM,MAAM,UAAU,MAAM,UAAU;WACrD,MAAM,IAAI;QACb,EAAE,YACF;IACJ,EAAE;;AAIN,SAAS,0BACP,YACuB;AACvB,KAAI,WAAW,MAAK,MAAK,OAAO,MAAM,SAAS,CAC7C,QAAO,EAAE;AAGX,QAAO;;;;;AAMT,SAAgB,WAAW,OAAuB;CAChD,MAAM,CAAC,EAAE,YAAY,QAAQ,WAAW,OAAO,CAAC,WAAW,CAAC;AAE5D,QACE,CAAC,aAAa,MAAM,YAAY;OAC7B,SAAS;IACZ,EAAE;;;;;AAON,SAAgB,YAAY,OAAuB;CACjD,MAAM,CAAC,EAAE,YAAY,QAAQ,WAAW,OAAO,CAAC,WAAW,CAAC;AAE5D,QACE,CAAC,aAAa,MAAM,aAAa;OAC9B,SAAS;IACZ,EAAE;;;;;AAON,SAAgB,WAAW,OAAuB;CAChD,MAAM,CAAC,EAAE,YAAY,QAAQ,WAAW,OAAO,CAAC,WAAW,CAAC;AAE5D,QACE,CAAC,aAAa,MAAM,YAAY;OAC7B,SAAS;IACZ,EAAE;;;;;AAON,SAAgB,gBAAgB,OAAuB;CACrD,MAAM,CAAC,EAAE,YAAY,QAAQ,WAAW,OAAO,CAAC,WAAW,CAAC;AAE5D,QACE,CAAC,aAAa,MAAM,iBAAiB;OAClC,SAAS;IACZ,EAAE;;;;;AAYN,SAAgB,kBAAkB,OAA+B;CAC/D,MAAM,CAAC,EAAE,MAAM,kBAAkB,WAAW,OAAO,CAAC,QAAQ,eAAe,CAAC;AAE5E,QACE,EAAE;OACC,iBAAiB;MAClB,CAAC,KAAK,MAAM,CAAC,YAAY,aAAa,EAAE;QACtC,CAAC,MAAM,OAAO,GAAG;UACf,CAAC,OAAO,sBAAsB,MAAM,aAAa,CAAC,EAAE,MAAM;QAC5D,EAAE,MAAM;MACV,EAAE,KAAK;IACT;;;;;AAOJ,SAAgB,aAAa,OAAuB;AAClD,QACE,EAAE;OACC,YAAY;MACb,CAAC,MAAM;MACP,CAAC,KAAK,UAAU,OAAO,oBAAoB,MAAM,SAAS,CAAC,EAAE,KAAK;IACpE;;;;;AAOJ,SAAgB,UAAU,OAAuB;AAC/C,QAAO,CAAC,aAAa,OAAO;;;;;AAe9B,SAAgB,aAAa,OAA0B;CACrD,MAAM,CAAC,EAAE,KAAK,SAAS,MAAM,UAAU,cAAc,WAAW,OAAO;EACrE;EACA;EACA;EACA;EACD,CAAC;AAEF,QACE,EAAE;OACC,YAAY;MACb,CAAC,MAAM;MACP,CAAC,KAAK,MAAM,QAAQ;YACd,aAAa,MAAM,QAAQ,MAAM;QACrC,CAAC,MAAM;MACT,EAAE,KAAK;OACN,SAAS;MACV,CAAC,KAAK,MAAM,QAAQ;QAClB,CAAC,MAAM;;MAET,EAAE,KAAK;IACT;;;;;AAOJ,SAAgB,gBAAgB;AAC9B,QAAO,CAAC,SAAS;;;;;AAMnB,SAAgB,gBAAgB;AAC9B,QAAO,CAAC,SAAS;;;;;AAMnB,SAAgB,cAAc;AAC5B,QAAO,CAAC,SAAS;;;;;AAMnB,SAAgB,cAAc;AAC5B,QAAO,CAAC,SAAS;;;;;AAmBnB,SAAgB,oBAAoB,OAAiC;CACnE,MAAM,CACJ,EACE,MACA,OACA,YACA,UACA,UACA,QACA,QACA,kBAEA,WAAW,OAAO;EACpB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC;CAEF,MAAM,QAAQ,eAAe,MAAM,OAAO,MAAM,IAAI,GAAG;CACvD,MAAM,SAAS,eAAe,MAAM,QAAQ,MAAM,IAAI,GAAG;AAEzD,QACE,EAAE;MACA,CAAC,KAAK,MAAM,YAAY,MAAM,MAAM,EAAE;QACpC,CAAC,YAAY,MAAM,MAAM,EAAE,WAAW;MACxC,EAAE,KAAK;MACP,CAAC,KACC,MACE,CAAC,YAAY,MAAM,IACnB,MAAM,SAAS,KACf,MAAM,MAAK,MAAK,YAAY,GAAG,MAAM,CAAC,CAAC,EACvC;QACF,CAAC,IAAI,MAAM,OAAO,QAAO,MAAK,YAAY,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YAC1D,UAAS,CAAC,YAAY,MAAM,EAAE,YAAY;QAC7C,EAAE,IAAI;MACR,EAAE,KAAK;MACP,CAAC,KAAK,MAAM,YAAY,OAAO,MAAM,EAAE;QACrC,CAAC,aAAa,OAAO,MAAM,EAAE,YAAY;MAC3C,EAAE,KAAK;MACP,CAAC,KACC,MACE,CAAC,YAAY,WAAW,IACxB,WAAW,SAAS,KACpB,WAAW,MAAK,MAAK,YAAY,GAAG,MAAM,CAAC,CAAC,EAC5C;QACF,CAAC,IAAI,MAAM,YAAY,QAAO,MAAK,YAAY,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YAC/D,eAAc,CAAC,iBAAiB,WAAW,EAAE,iBAAiB;QACjE,EAAE,IAAI;MACR,EAAE,KAAK;MACP,CAAC,KAAK,MAAM,aAAa,MAAM;QAC7B,CAAC,gBAAgB;MACnB,EAAE,KAAK;MACP,CAAC,KAAK,MAAM,aAAa,MAAM;QAC7B,CAAC,gBAAgB;MACnB,EAAE,KAAK;MACP,CAAC,KAAK,MAAM,WAAW,MAAM;QAC3B,CAAC,cAAc;MACjB,EAAE,KAAK;MACP,CAAC,KAAK,MAAM,WAAW,MAAM;QAC3B,CAAC,cAAc;MACjB,EAAE,KAAK;MACP,CAAC,KAAK,MAAM,CAAC,YAAY,KAAK,IAAI,CAAC,YAAY,aAAa,EAAE;QAC5D,CAAC,kBACC,MACE,MAEF,cAAc,gBACd;MACJ,EAAE,KAAK;IACT;;;;;AAcJ,SAAgB,WAAW,OAAwB;AACjD,QACE,EAAE;OACC,UAAU;MACX,CAAC,eACC,MAAM,MAAM,MACZ,UAAU,MAAM,UAChB,cAAc,MAAM,gBACpB;MACF,CAAC,sBAAsB,UAAU,MAAM,YAAY;IACrD;;AAUJ,SAAS,eAAe,OAA4B;AAClD,QACE,EAAE;MACA,CAAC,KAAK,MAAM,MAAM,WAAW,IAAI,EAAE,KAAK;OACvC,MAAM,KAAK;MACZ,CAAC,KAAK,MAAM,QAAQ,MAAM,aAAa,EAAE,EAAE,MAAM,aAAa,EAAE,KAAK;MACrE,CAAC,KAAK,MAAM,MAAM,WAAW,IAAI,EAAE,KAAK;IAC1C;;AAQJ,SAAS,sBAAsB,OAAmC;AAChE,QACE,CAAC,KAAK,MAAM,QAAQ,MAAM,SAAS,EAAE;OAClC,MAAM;MACP,CAAC,MAAM,OAAO,GAAG;QACf,CAAC,OAAO,MAAM,SAAS,EAAE,MAAM;MACjC,EAAE,MAAM;IACV,EAAE;;;;;AAON,SAAgB,aAAa,OAAuB;AAClD,QAAO,CAAC,aAAa,OAAO;;;;;AAM9B,SAAgB,YAAY,OAAuB;AACjD,QAAO,CAAC,aAAa,OAAO;;;;;AAoC9B,SAAgB,YAAY,OAAyB;CACnD,MAAM,CAAC,EAAE,UAAU,MAAM,YAAY,WAAW,OAAO;EACrD;EACA;EACA;EACD,CAAC;CAEF,MAAM,UAAU,mBAAmB;AAEnC,QACE,EAAE;;MAEA,CAAC,MAAM,aAAa;QAClB,CAAC,MAAM;QACP,CAAC,KAAK,MAAM,QAAQ,SAAS,EAAE;UAC7B,CAAC,KAAK,UAAU,OAAO,oBAAoB,SAAS,CAAC,EAAE,KAAK;UAC5D,CAAC,UAAU;QACb,EAAE,KAAK;SACN,WAAW;SACX,UAAU,SAAS,QAAQ,aAAa,aAAa,EAAE,KAAK;MAC/D,EAAE,MAAM;MACR,CAAC,MAAM;OACN,MAAM;IACT"}
+{"version":3,"file":"tsdoc.mjs","names":[],"sources":["../../../src/typescript/components/tsdoc.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport {\n  Children,\n  childrenArray,\n  computed,\n  For,\n  List,\n  Prose,\n  Show,\n  splitProps\n} from \"@alloy-js/core\";\nimport { JSDocExampleProps, ParameterDescriptor } from \"@alloy-js/typescript\";\nimport { stringifyDefaultValue } from \"@powerlines/deepkit/utilities\";\nimport {\n  ReflectionKind,\n  ReflectionParameter,\n  ReflectionProperty\n} from \"@powerlines/deepkit/vendor/type\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isUndefined } from \"@stryke/type-checks/is-undefined\";\nimport { Spacing } from \"../../core/components/spacing\";\nimport { usePowerlinesSafe } from \"../../core/contexts/context\";\nimport { ComponentProps } from \"../../types/components\";\n\nexport interface TSDocProps extends ComponentProps {\n  heading?: Children;\n}\n\n/**\n * Generates a TypeScript interface for the given reflection class.\n */\nexport function TSDoc(props: TSDocProps) {\n  const [{ children, heading }] = splitProps(props, [\"children\", \"heading\"]);\n\n  return (\n    <>\n      /**\n      <align string=\" * \">\n        <hbr />\n        <Show when={!isUndefined(heading)}>{heading}</Show>\n        <Show\n          when={\n            !isUndefined(children) &&\n            childrenArray(() => children).filter(Boolean).length > 0\n          }>\n          <Show when={!isUndefined(heading)}>\n            <Spacing />\n          </Show>\n          <List>{childrenArray(() => children)}</List>\n        </Show>\n      </align>\n      <hbr />\n      {`*/`}\n      <hbr />\n    </>\n  );\n}\n\nexport interface TSDocTagProps extends ComponentProps {\n  tag: string;\n}\n\n/**\n * Create a TSDoc `@<props.tag>` tag.\n */\nexport function TSDocTag(props: TSDocTagProps) {\n  const [{ children, tag }] = splitProps(props, [\"children\", \"tag\"]);\n\n  return (\n    <>\n      {`@${tag} `}\n      <Show when={Boolean(children)}>\n        <align width={2}>\n          <Prose>{children}</Prose>\n        </align>\n      </Show>\n      <sbr />\n    </>\n  );\n}\n\nexport interface TSDocParamsProps {\n  parameters: ParameterDescriptor[] | string[];\n}\n\n/**\n * A component that creates a TSDoc block with `@param` tags for each parameter.\n */\nexport function TSDocParams(props: TSDocParamsProps) {\n  const parameters = normalizeParametersForDoc(props.parameters);\n\n  return (\n    <For each={parameters}>\n      {param => (\n        <TSDocParam name={param.name} optional={param.optional}>\n          {param.doc}\n        </TSDocParam>\n      )}\n    </For>\n  );\n}\n\nfunction normalizeParametersForDoc(\n  parameters: ParameterDescriptor[] | string[]\n): ParameterDescriptor[] {\n  if (parameters.some(p => typeof p === \"string\")) {\n    return [];\n  }\n\n  return parameters as ParameterDescriptor[];\n}\n\n/**\n * Create a TSDoc `@title` tag.\n */\nexport function TSDocTitle(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"title\">\n      {children}\n    </TSDocTag>\n  );\n}\n\n/**\n * Create a TSDoc `@domain` tag.\n */\nexport function TSDocDomain(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"domain\">\n      {children}\n    </TSDocTag>\n  );\n}\n\n/**\n * Create a TSDoc `@alias` tag.\n */\nexport function TSDocAlias(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"alias\">\n      {children}\n    </TSDocTag>\n  );\n}\n\n/**\n * Create a TSDoc `@permission` tag.\n */\nexport function TSDocPermission(props: ComponentProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <TSDocTag {...rest} tag=\"permission\">\n      {children}\n    </TSDocTag>\n  );\n}\n\nexport interface TSDocDefaultValueProps extends ComponentProps {\n  type: ReflectionKind | ReflectionProperty | ReflectionParameter;\n  defaultValue: any;\n}\n\n/**\n * Create a TSDoc `@defaultValue` tag.\n */\nexport function TSDocDefaultValue(props: TSDocDefaultValueProps) {\n  const [{ type, defaultValue }] = splitProps(props, [\"type\", \"defaultValue\"]);\n\n  return (\n    <>\n      {\"@defaultValue \"}\n      <Show when={!isUndefined(defaultValue)}>\n        <align width={2}>\n          <Prose>{stringifyDefaultValue(type, defaultValue)}</Prose>\n        </align>\n      </Show>\n    </>\n  );\n}\n\n/**\n * Create a TSDoc `@remarks` tag.\n */\nexport function TSDocRemarks(props: ComponentProps) {\n  return (\n    <>\n      {\"@remarks \"}\n      <hbr />\n      <List hardline={true}>{childrenArray(() => props.children)}</List>\n    </>\n  );\n}\n\n/**\n * Create a TSDoc `@see` tag.\n */\nexport function TSDocLink(props: ComponentProps) {\n  return <TSDocTag {...props} tag=\"see\" />;\n}\n\nexport interface TSDocExampleProps extends JSDocExampleProps {\n  /**\n   * Whether the file is a TSX file.\n   *\n   * @defaultValue false\n   */\n  tsx?: boolean;\n}\n\n/**\n * Create a TSDoc `@example` tag.\n */\nexport function TSDocExample(props: TSDocExampleProps) {\n  const [{ tsx, fenced = true, language, children }] = splitProps(props, [\n    \"tsx\",\n    \"fenced\",\n    \"language\",\n    \"children\"\n  ]);\n\n  return (\n    <>\n      {\"@example \"}\n      <hbr />\n      <Show when={fenced}>\n        ```{language || (tsx ? \"tsx\" : \"ts\")}\n        <hbr />\n      </Show>\n      {children}\n      <Show when={fenced}>\n        <hbr />\n        ```\n      </Show>\n    </>\n  );\n}\n\n/**\n * Create a TSDoc `@readonly` tag.\n */\nexport function TSDocReadonly() {\n  return <TSDocTag tag=\"readonly\" />;\n}\n\n/**\n * Create a TSDoc `@internal` tag.\n */\nexport function TSDocInternal() {\n  return <TSDocTag tag=\"internal\" />;\n}\n\n/**\n * Create a TSDoc `@ignore` tag.\n */\nexport function TSDocIgnore() {\n  return <TSDocTag tag=\"ignore\" />;\n}\n\n/**\n * Create a TSDoc `@hidden` tag.\n */\nexport function TSDocHidden() {\n  return <TSDocTag tag=\"hidden\" />;\n}\n\nexport interface TSDocAttributesTagsProps {\n  type?: ReflectionKind | ReflectionProperty | ReflectionParameter;\n  title?: string;\n  alias?: string[];\n  permission?: string[];\n  domain?: string;\n  readonly?: boolean;\n  internal?: boolean;\n  ignore?: boolean;\n  hidden?: boolean;\n  defaultValue?: any;\n}\n\n/**\n * Generates a TypeScript interface property for the given reflection class.\n */\nexport function TSDocAttributesTags(props: TSDocAttributesTagsProps) {\n  const [\n    {\n      type,\n      alias,\n      permission,\n      readonly,\n      internal,\n      ignore,\n      hidden,\n      defaultValue\n    }\n  ] = splitProps(props, [\n    \"type\",\n    \"alias\",\n    \"permission\",\n    \"readonly\",\n    \"internal\",\n    \"ignore\",\n    \"hidden\",\n    \"defaultValue\"\n  ]);\n\n  const title = computed(() => props.title?.trim() || \"\");\n  const domain = computed(() => props.domain?.trim() || \"\");\n\n  return (\n    <>\n      <Show when={isSetString(title.value)}>\n        <TSDocTitle>{title.value}</TSDocTitle>\n      </Show>\n      <Show\n        when={\n          !isUndefined(alias) &&\n          alias.length > 0 &&\n          alias.some(a => isSetString(a?.trim()))\n        }>\n        <For each={alias?.filter(a => isSetString(a?.trim())) ?? []}>\n          {alias => <TSDocAlias>{alias}</TSDocAlias>}\n        </For>\n      </Show>\n      <Show when={isSetString(domain.value)}>\n        <TSDocDomain>{domain.value}</TSDocDomain>\n      </Show>\n      <Show\n        when={\n          !isUndefined(permission) &&\n          permission.length > 0 &&\n          permission.some(p => isSetString(p?.trim()))\n        }>\n        <For each={permission?.filter(p => isSetString(p?.trim())) ?? []}>\n          {permission => <TSDocPermission>{permission}</TSDocPermission>}\n        </For>\n      </Show>\n      <Show when={readonly === true}>\n        <TSDocReadonly />\n      </Show>\n      <Show when={internal === true}>\n        <TSDocInternal />\n      </Show>\n      <Show when={ignore === true}>\n        <TSDocIgnore />\n      </Show>\n      <Show when={hidden === true}>\n        <TSDocHidden />\n      </Show>\n      <Show when={!isUndefined(type) && !isUndefined(defaultValue)}>\n        <TSDocDefaultValue\n          type={\n            type as ReflectionKind | ReflectionProperty | ReflectionParameter\n          }\n          defaultValue={defaultValue}\n        />\n      </Show>\n    </>\n  );\n}\n\nexport interface TSDocParamProps {\n  name: Children;\n  children?: Children;\n  optional?: boolean;\n  defaultValue?: Children;\n}\n\n/**\n * Create a TSDoc parameter set off with `@param`.\n */\nexport function TSDocParam(props: TSDocParamProps) {\n  return (\n    <>\n      {\"@param \"}\n      <TSDocParamName\n        name={props.name}\n        optional={props.optional}\n        defaultValue={props.defaultValue}\n      />\n      <TSDocParamDescription children={props.children} />\n    </>\n  );\n}\n\ninterface TSDocParamNameProps {\n  name: Children;\n  optional?: boolean;\n  defaultValue?: Children;\n}\n\nfunction TSDocParamName(props: TSDocParamNameProps) {\n  return (\n    <>\n      <Show when={props.optional}>{\"[\"}</Show>\n      {props.name}\n      <Show when={Boolean(props.defaultValue)}>={props.defaultValue}</Show>\n      <Show when={props.optional}>{\"]\"}</Show>\n    </>\n  );\n}\n\ninterface TSDocParamDescriptionProps {\n  children?: Children;\n}\n\nfunction TSDocParamDescription(props: TSDocParamDescriptionProps) {\n  return (\n    <Show when={Boolean(props.children)}>\n      {\" - \"}\n      <align width={2}>\n        <Prose>{props.children}</Prose>\n      </align>\n    </Show>\n  );\n}\n\n/**\n * Create a TSDoc `@returns` tag.\n */\nexport function TSDocReturns(props: ComponentProps) {\n  return <TSDocTag {...props} tag=\"returns\" />;\n}\n\n/**\n * Create a TSDoc `@throws` tag.\n */\nexport function TSDocThrows(props: ComponentProps) {\n  return <TSDocTag {...props} tag=\"throws\" />;\n}\n\nexport interface TSDocModuleProps extends ComponentProps {\n  /**\n   * The prefix for the builtin module name\n   *\n   * @remarks\n   * This value is populated from the Powerlines configuration output builtin prefix by default.\n   *\n   * @example\n   * ```ts\n   * /**\n   *  @module powerlines:my-module\n   *  \\/\n   * ```\n   */\n  prefix?: string;\n\n  /**\n   * The name of the module\n   *\n   * @remarks\n   * This will be used in the `@module` tag as well as the import path for the module, e.g. `storm:<name>`.\n   *\n   * @example\n   * ```ts\n   * import { MyModule } from \"powerlines:my-module\";\n   * ```\n   */\n  name: Children;\n}\n\n/**\n * Generates a TSDoc `@module` tag for the given module name.\n */\nexport function TSDocModule(props: TSDocModuleProps) {\n  const [{ children, name, prefix }] = splitProps(props, [\n    \"children\",\n    \"name\",\n    \"prefix\"\n  ]);\n\n  const context = usePowerlinesSafe();\n\n  return (\n    <>\n      /**\n      <align string=\" * \">\n        <hbr />\n        <Show when={Boolean(children)}>\n          <List hardline={true}>{childrenArray(() => children)}</List>\n          <Spacing />\n        </Show>\n        {\"@module \"}\n        {prefix || context?.config?.framework || \"powerlines\"}:{name}\n      </align>\n      <hbr />\n      {` */`}\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/typescript/components/type-declaration.cjs

@@ -3,6 +3,7 @@ const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
 const require_typescript_components_tsdoc = require('./tsdoc.cjs');
 const require_typescript_components_type_parameters = require('./type-parameters.cjs');
 let _alloy_js_core = require("@alloy-js/core");
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let _alloy_js_typescript = require("@alloy-js/typescript");
 
 //#region src/typescript/components/type-declaration.tsx
@@ -11,15 +12,22 @@ let _alloy_js_typescript = require("@alloy-js/typescript");
 */
 const TypeDeclaration = (0, _alloy_js_typescript.ensureTypeRefContext)(function TypeDeclaration(props) {
 	const { children, doc, typeParameters, ...rest } = props;
-	return <>
-      <_alloy_js_core.Show when={Boolean(doc)}>
-        <require_typescript_components_tsdoc.TSDoc heading={doc} />
-      </_alloy_js_core.Show>
-      <_alloy_js_typescript.Declaration {...rest} kind="type" nameKind="type">
-        type <_alloy_js_core.Name />
-        {typeParameters && <require_typescript_components_type_parameters.TypeParameters parameters={typeParameters} />} = {children};
-      </_alloy_js_typescript.Declaration>
-    </>;
+	return /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(_alloy_js_core_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.Show, {
+		when: Boolean(doc),
+		children: /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(require_typescript_components_tsdoc.TSDoc, { heading: doc })
+	}), /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(_alloy_js_typescript.Declaration, {
+		...rest,
+		kind: "type",
+		nameKind: "type",
+		children: [
+			"type ",
+			/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.Name, {}),
+			typeParameters && /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(require_typescript_components_type_parameters.TypeParameters, { parameters: typeParameters }),
+			" = ",
+			children,
+			";"
+		]
+	})] });
 });
 
 //#endregion

package/dist/typescript/components/type-declaration.mjs

@@ -1,6 +1,7 @@
 import { TSDoc } from "./tsdoc.mjs";
 import { TypeParameters } from "./type-parameters.mjs";
 import { Name, Show } from "@alloy-js/core";
+import { Fragment, jsx, jsxs } from "@alloy-js/core/jsx-runtime";
 import { Declaration as Declaration$1, ensureTypeRefContext } from "@alloy-js/typescript";
 
 //#region src/typescript/components/type-declaration.tsx
@@ -9,15 +10,22 @@ import { Declaration as Declaration$1, ensureTypeRefContext } from "@alloy-js/ty
 */
 const TypeDeclaration = ensureTypeRefContext(function TypeDeclaration(props) {
 	const { children, doc, typeParameters, ...rest } = props;
-	return <>
-      <Show when={Boolean(doc)}>
-        <TSDoc heading={doc} />
-      </Show>
-      <Declaration$1 {...rest} kind="type" nameKind="type">
-        type <Name />
-        {typeParameters && <TypeParameters parameters={typeParameters} />} = {children};
-      </Declaration$1>
-    </>;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Show, {
+		when: Boolean(doc),
+		children: /* @__PURE__ */ jsx(TSDoc, { heading: doc })
+	}), /* @__PURE__ */ jsxs(Declaration$1, {
+		...rest,
+		kind: "type",
+		nameKind: "type",
+		children: [
+			"type ",
+			/* @__PURE__ */ jsx(Name, {}),
+			typeParameters && /* @__PURE__ */ jsx(TypeParameters, { parameters: typeParameters }),
+			" = ",
+			children,
+			";"
+		]
+	})] });
 });
 
 //#endregion