@powerlines/plugin-alloy 0.25.27 → 0.25.28

package/dist/typescript/components/tsdoc.mjs

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

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

@@ -1 +1 @@
-{"version":3,"file":"tsdoc.mjs","names":["childrenArray","computed","For","List","Prose","Show","splitProps","stringifyDefaultValue","isSetString","isUndefined","Spacing","usePowerlinesSafe","TSDoc","props","children","heading","_$createIntrinsic","string","_$createComponent","when","_$memo","filter","Boolean","length","TSDocTag","tag","width","TSDocParams","parameters","normalizeParametersForDoc","each","param","TSDocParam","name","optional","doc","some","p","TSDocTitle","rest","_$mergeProps","TSDocDomain","TSDocAlias","TSDocPermission","TSDocDefaultValue","type","defaultValue","TSDocRemarks","hardline","TSDocLink","TSDocExample","tsx","fenced","language","TSDocReadonly","TSDocInternal","TSDocIgnore","TSDocHidden","TSDocAttributesTags","alias","permission","readonly","internal","ignore","hidden","title","trim","domain","value","a","TSDocParamName","TSDocParamDescription","TSDocReturns","TSDocThrows","TSDocModule","prefix","context","config","framework"],"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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"}
+{"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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"}