@powerlines/plugin-alloy 0.26.76 → 0.26.78

package/dist/typescript/components/tsdoc.mjs

@@ -1,2 +1,476 @@
-import{usePowerlinesSafe as e}from"../../core/contexts/context.mjs";import{Spacing as t}from"../../core/components/spacing.mjs";import{createComponent as n,createIntrinsic as r,memo as i,mergeProps as a}from"@alloy-js/core/jsx-runtime";import{For as o,List as s,Prose as c,Show as l,childrenArray as u,computed as d,splitProps as f}from"@alloy-js/core";import{stringifyDefaultValue as p}from"@powerlines/deepkit/utilities";import{isUndefined as m}from"@stryke/type-checks/is-undefined";import{isSetString as h}from"@stryke/type-checks/is-set-string";function g(e){let[{children:a,heading:o}]=f(e,[`children`,`heading`]);return[`/**`,r(`align`,{string:` * `,get children(){return[r(`hbr`,{}),n(l,{get when(){return!m(o)},children:o}),n(l,{get when(){return i(()=>!m(a))()&&u(()=>a).filter(Boolean).length>0},get children(){return[n(l,{get when(){return!m(o)},get children(){return n(t,{})}}),n(s,{hardline:!1,softline:!0,get children(){return u(()=>a)}})]}})]}}),r(`hbr`,{}),`*/`,r(`hbr`,{})]}function _(e){let[{children:t,tag:i}]=f(e,[`children`,`tag`]);return[`@${i} `,n(l,{get when(){return!!t},get children(){return r(`align`,{width:2,get children(){return n(c,{children:t})}})}}),r(`sbr`,{})]}function v(e){return n(o,{each:y(e.parameters),children:e=>n(P,{get name(){return e.name},get optional(){return e.optional},get children(){return e.doc}})})}function y(e){return e.some(e=>typeof e==`string`)?[]:e}function b(e){let[{children:t},r]=f(e,[`children`]);return n(_,a(r,{tag:`title`,children:t}))}function x(e){let[{children:t},r]=f(e,[`children`]);return n(_,a(r,{tag:`domain`,children:t}))}function S(e){let[{children:t},r]=f(e,[`children`]);return n(_,a(r,{tag:`alias`,children:t}))}function C(e){let[{children:t},r]=f(e,[`children`]);return n(_,a(r,{tag:`permission`,children:t}))}function w(e){let[{type:t,defaultValue:i}]=f(e,[`type`,`defaultValue`]);return[`@defaultValue `,n(l,{get when(){return!m(i)},get children(){return r(`align`,{width:2,get children(){return n(c,{get children(){return p(t,i)}})}})}})]}function T(e){return[`@remarks `,r(`hbr`,{}),n(s,{hardline:!1,softline:!0,get children(){return u(()=>e.children)}})]}function E(e){return n(_,a(e,{tag:`see`}))}function D(e){let[{tsx:t,fenced:i=!0,language:a,children:o}]=f(e,[`tsx`,`fenced`,`language`,`children`]);return[`@example `,r(`hbr`,{}),n(l,{when:i,get children(){return["```",a||(t?`tsx`:`ts`),r(`hbr`,{})]}}),o,n(l,{when:i,get children(){return[r(`hbr`,{}),"```"]}})]}function O(){return n(_,{tag:`readonly`})}function k(){return n(_,{tag:`internal`})}function A(){return n(_,{tag:`ignore`})}function j(){return n(_,{tag:`hidden`})}function M(){return n(_,{tag:`runtime`})}function N(e){let[{type:t,alias:r,permission:a,readonly:s,internal:c,ignore:u,hidden:p,runtime:g,defaultValue:_}]=f(e,[`type`,`alias`,`permission`,`readonly`,`internal`,`ignore`,`hidden`,`runtime`,`defaultValue`]),v=d(()=>e.title?.trim()||``),y=d(()=>e.domain?.trim()||``);return[n(l,{get when(){return h(v.value)},get children(){return n(b,{get children(){return v.value}})}}),n(l,{get when(){return i(()=>!m(r)&&r.length>0)()&&r.some(e=>h(e?.trim()))},get children(){return n(o,{get each(){return r?.filter(e=>h(e?.trim()))??[]},children:e=>n(S,{children:e})})}}),n(l,{get when(){return h(y.value)},get children(){return n(x,{get children(){return y.value}})}}),n(l,{get when(){return i(()=>!m(a)&&a.length>0)()&&a.some(e=>h(e?.trim()))},get children(){return n(o,{get each(){return a?.filter(e=>h(e?.trim()))??[]},children:e=>n(C,{children:e})})}}),n(l,{when:s===!0,get children(){return n(O,{})}}),n(l,{when:c===!0,get children(){return n(k,{})}}),n(l,{when:u===!0,get children(){return n(A,{})}}),n(l,{when:p===!0,get children(){return n(j,{})}}),n(l,{when:g===!0,get children(){return n(M,{})}}),n(l,{get when(){return i(()=>g!==!0&&!m(t))()&&!m(_)},get children(){return n(w,{type:t,defaultValue:_})}})]}function P(e){return[`@param `,n(F,{get name(){return e.name},get optional(){return e.optional},get defaultValue(){return e.defaultValue}}),n(I,{get children(){return e.children}})]}function F(e){return[n(l,{get when(){return e.optional},children:`[`}),i(()=>e.name),n(l,{get when(){return!!e.defaultValue},get children(){return[`=`,i(()=>e.defaultValue)]}}),n(l,{get when(){return e.optional},children:`]`})]}function I(e){return n(l,{get when(){return!!e.children},get children(){return[` - `,r(`align`,{width:2,get children(){return n(c,{get children(){return e.children}})}})]}})}function L(e){return n(_,a(e,{tag:`returns`}))}function R(e){return n(_,a(e,{tag:`throws`}))}function z(a){let[{children:o,name:c,prefix:d}]=f(a,[`children`,`name`,`prefix`]),p=e();return[`/**`,r(`align`,{string:` * `,get children(){return[r(`hbr`,{}),n(l,{get when(){return!!o},get children(){return[n(s,{hardline:!1,softline:!0,get children(){return u(()=>o)}}),n(t,{})]}}),`@module `,i(()=>d||p?.config?.framework||`powerlines`),`:`,c]}}),r(`hbr`,{}),` */`]}export{g as TSDoc,S as TSDocAlias,N as TSDocAttributesTags,w as TSDocDefaultValue,x as TSDocDomain,D as TSDocExample,j as TSDocHidden,A as TSDocIgnore,k as TSDocInternal,E as TSDocLink,z as TSDocModule,P as TSDocParam,v as TSDocParams,C as TSDocPermission,O as TSDocReadonly,T as TSDocRemarks,L as TSDocReturns,M as TSDocRuntime,_ as TSDocTag,R as TSDocThrows,b as TSDocTitle};
+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";
+import { isSetString } from "@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 }] = 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, {
+								hardline: false,
+								softline: true,
+								get children() {
+									return childrenArray(() => children);
+								}
+							})];
+						}
+					})
+				];
+			}
+		}),
+		createIntrinsic("hbr", {}),
+		`*/`,
+		createIntrinsic("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", {})
+	];
+}
+/**
+* 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;
+			}
+		})
+	});
+}
+function normalizeParametersForDoc(parameters) {
+	if (parameters.some((p) => typeof p === "string")) return [];
+	return parameters;
+}
+/**
+* Create a TSDoc `@title` tag.
+*/
+function TSDocTitle(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "title",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@domain` tag.
+*/
+function TSDocDomain(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "domain",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@alias` tag.
+*/
+function TSDocAlias(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "alias",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@permission` tag.
+*/
+function TSDocPermission(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "permission",
+		children
+	}));
+}
+/**
+* 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);
+					} });
+				}
+			});
+		}
+	})];
+}
+/**
+* Create a TSDoc `@remarks` tag.
+*/
+function TSDocRemarks(props) {
+	return [
+		"@remarks ",
+		createIntrinsic("hbr", {}),
+		createComponent(List, {
+			hardline: false,
+			softline: true,
+			get children() {
+				return childrenArray(() => props.children);
+			}
+		})
+	];
+}
+/**
+* Create a TSDoc `@see` tag.
+*/
+function TSDocLink(props) {
+	return createComponent(TSDocTag, mergeProps(props, { tag: "see" }));
+}
+/**
+* Create a TSDoc `@example` tag.
+*/
+function TSDocExample(props) {
+	const [{ tsx, fenced = true, language, children }] = splitProps(props, [
+		"tsx",
+		"fenced",
+		"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", {}), "```"];
+			}
+		})
+	];
+}
+/**
+* Create a TSDoc `@readonly` tag.
+*/
+function TSDocReadonly() {
+	return createComponent(TSDocTag, { tag: "readonly" });
+}
+/**
+* Create a TSDoc `@internal` tag.
+*/
+function TSDocInternal() {
+	return createComponent(TSDocTag, { tag: "internal" });
+}
+/**
+* Create a TSDoc `@ignore` tag.
+*/
+function TSDocIgnore() {
+	return createComponent(TSDocTag, { tag: "ignore" });
+}
+/**
+* Create a TSDoc `@hidden` tag.
+*/
+function TSDocHidden() {
+	return createComponent(TSDocTag, { tag: "hidden" });
+}
+/**
+* Create a TSDoc `@runtime` tag.
+*/
+function TSDocRuntime() {
+	return 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 }] = splitProps(props, [
+		"type",
+		"alias",
+		"permission",
+		"readonly",
+		"internal",
+		"ignore",
+		"hidden",
+		"runtime",
+		"defaultValue"
+	]);
+	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, {
+			when: runtime === true,
+			get children() {
+				return createComponent(TSDocRuntime, {});
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return memo(() => !!(runtime !== true && !isUndefined(type)))() && !isUndefined(defaultValue);
+			},
+			get children() {
+				return createComponent(TSDocDefaultValue, {
+					type,
+					defaultValue
+				});
+			}
+		})
+	];
+}
+/**
+* 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;
+		} })
+	];
+}
+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: "]"
+		})
+	];
+}
+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;
+					} });
+				}
+			})];
+		}
+	});
+}
+/**
+* Create a TSDoc `@returns` tag.
+*/
+function TSDocReturns(props) {
+	return createComponent(TSDocTag, mergeProps(props, { tag: "returns" }));
+}
+/**
+* Create a TSDoc `@throws` tag.
+*/
+function TSDocThrows(props) {
+	return createComponent(TSDocTag, mergeProps(props, { tag: "throws" }));
+}
+/**
+* Generates a TSDoc `@module` tag for the given module name.
+*/
+function TSDocModule(props) {
+	const [{ children, name, prefix }] = splitProps(props, [
+		"children",
+		"name",
+		"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: false,
+								softline: true,
+								get children() {
+									return childrenArray(() => children);
+								}
+							}), createComponent(Spacing, {})];
+						}
+					}),
+					"@module ",
+					memo(() => prefix || context?.config?.framework || "powerlines"),
+					":",
+					name
+				];
+			}
+		}),
+		createIntrinsic("hbr", {}),
+		` */`
+	];
+}
+
+//#endregion
+export { TSDoc, TSDocAlias, TSDocAttributesTags, TSDocDefaultValue, TSDocDomain, TSDocExample, TSDocHidden, TSDocIgnore, TSDocInternal, TSDocLink, TSDocModule, TSDocParam, TSDocParams, TSDocPermission, TSDocReadonly, TSDocRemarks, TSDocReturns, TSDocRuntime, TSDocTag, TSDocThrows, TSDocTitle };
 //# sourceMappingURL=tsdoc.mjs.map

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 hardline={false} softline={true}>\n            {childrenArray(() => children)}\n          </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={false} softline={true}>\n        {childrenArray(() => props.children)}\n      </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\n/**\n * Create a TSDoc `@runtime` tag.\n */\nexport function TSDocRuntime() {\n  return <TSDocTag tag=\"runtime\" />;\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  runtime?: 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      runtime,\n      defaultValue\n    }\n  ] = splitProps(props, [\n    \"type\",\n    \"alias\",\n    \"permission\",\n    \"readonly\",\n    \"internal\",\n    \"ignore\",\n    \"hidden\",\n    \"runtime\",\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={runtime === true}>\n        <TSDocRuntime />\n      </Show>\n      <Show\n        when={\n          runtime !== true && !isUndefined(type) && !isUndefined(defaultValue)\n        }>\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={false} softline={true}>\n            {childrenArray(() => children)}\n          </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 hardline={false} softline={true}>\n            {childrenArray(() => children)}\n          </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={false} softline={true}>\n        {childrenArray(() => props.children)}\n      </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\n/**\n * Create a TSDoc `@runtime` tag.\n */\nexport function TSDocRuntime() {\n  return <TSDocTag tag=\"runtime\" />;\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  runtime?: 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      runtime,\n      defaultValue\n    }\n  ] = splitProps(props, [\n    \"type\",\n    \"alias\",\n    \"permission\",\n    \"readonly\",\n    \"internal\",\n    \"ignore\",\n    \"hidden\",\n    \"runtime\",\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={runtime === true}>\n        <TSDocRuntime />\n      </Show>\n      <Show\n        when={\n          runtime !== true && !isUndefined(type) && !isUndefined(defaultValue)\n        }>\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={false} softline={true}>\n            {childrenArray(() => children)}\n          </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

@@ -1 +1,39 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`./tsdoc.cjs`),t=require(`./type-parameters.cjs`);let n=require(`@alloy-js/core/jsx-runtime`),r=require(`@alloy-js/core`),i=require(`@alloy-js/typescript`);const a=(0,i.ensureTypeRefContext)(function(a){let{children:o,doc:s,typeParameters:c,...l}=a;return[(0,n.createComponent)(r.Show,{get when(){return!!s},get children(){return(0,n.createComponent)(e.TSDoc,{heading:s})}}),(0,n.createComponent)(i.Declaration,(0,n.mergeProps)(l,{kind:`type`,nameKind:`type`,get children(){return[`type `,(0,n.createComponent)(r.Name,{}),(0,n.memo)(()=>c&&(0,n.createComponent)(t.TypeParameters,{parameters:c})),` = `,o,`;`]}}))]});exports.TypeDeclaration=a;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+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_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
+let _alloy_js_typescript = require("@alloy-js/typescript");
+
+//#region src/typescript/components/type-declaration.tsx
+/**
+* Renders a TypeScript type declaration, including its name, optional TSDoc comment, and generic type parameters.
+*/
+const TypeDeclaration = (0, _alloy_js_typescript.ensureTypeRefContext)(function TypeDeclaration(props) {
+	const { children, doc, typeParameters, ...rest } = props;
+	return [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+		get when() {
+			return Boolean(doc);
+		},
+		get children() {
+			return (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc.TSDoc, { heading: doc });
+		}
+	}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.Declaration, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
+		kind: "type",
+		nameKind: "type",
+		get children() {
+			return [
+				"type ",
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Name, {}),
+				(0, _alloy_js_core_jsx_runtime.memo)(() => typeParameters && (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_type_parameters.TypeParameters, { parameters: typeParameters })),
+				" = ",
+				children,
+				";"
+			];
+		}
+	}))];
+});
+
+//#endregion
+exports.TypeDeclaration = TypeDeclaration;

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

@@ -1,2 +1,38 @@
-import{TSDoc as e}from"./tsdoc.mjs";import{TypeParameters as t}from"./type-parameters.mjs";import{createComponent as n,memo as r,mergeProps as i}from"@alloy-js/core/jsx-runtime";import{Name as a,Show as o}from"@alloy-js/core";import{Declaration as s,ensureTypeRefContext as c}from"@alloy-js/typescript";const l=c(function(c){let{children:l,doc:u,typeParameters:d,...f}=c;return[n(o,{get when(){return!!u},get children(){return n(e,{heading:u})}}),n(s,i(f,{kind:`type`,nameKind:`type`,get children(){return[`type `,n(a,{}),r(()=>d&&n(t,{parameters:d})),` = `,l,`;`]}}))]});export{l as TypeDeclaration};
+import { TSDoc } from "./tsdoc.mjs";
+import { TypeParameters } from "./type-parameters.mjs";
+import { createComponent, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { Name, Show } from "@alloy-js/core";
+import { Declaration as Declaration$1, ensureTypeRefContext } from "@alloy-js/typescript";
+
+//#region src/typescript/components/type-declaration.tsx
+/**
+* Renders a TypeScript type declaration, including its name, optional TSDoc comment, and generic type parameters.
+*/
+const TypeDeclaration = ensureTypeRefContext(function TypeDeclaration(props) {
+	const { children, doc, typeParameters, ...rest } = props;
+	return [createComponent(Show, {
+		get when() {
+			return Boolean(doc);
+		},
+		get children() {
+			return createComponent(TSDoc, { heading: doc });
+		}
+	}), createComponent(Declaration$1, mergeProps(rest, {
+		kind: "type",
+		nameKind: "type",
+		get children() {
+			return [
+				"type ",
+				createComponent(Name, {}),
+				memo(() => typeParameters && createComponent(TypeParameters, { parameters: typeParameters })),
+				" = ",
+				children,
+				";"
+			];
+		}
+	}))];
+});
+
+//#endregion
+export { TypeDeclaration };
 //# sourceMappingURL=type-declaration.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"type-declaration.mjs","names":[],"sources":["../../../src/typescript/components/type-declaration.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 { Name, Show } from \"@alloy-js/core\";\nimport {\n  CommonDeclarationProps,\n  Declaration,\n  ensureTypeRefContext,\n  TypeParameterDescriptor\n} from \"@alloy-js/typescript\";\nimport { TSDoc } from \"./tsdoc\";\nimport { TypeParameters } from \"./type-parameters\";\n\nexport interface TypeDeclarationProps extends CommonDeclarationProps {\n  /**\n   * The generic type parameters of the interface.\n   */\n  typeParameters?: TypeParameterDescriptor[] | string[];\n}\n\n/**\n * Renders a TypeScript type declaration, including its name, optional TSDoc comment, and generic type parameters.\n */\nexport const TypeDeclaration = ensureTypeRefContext(function TypeDeclaration(\n  props: TypeDeclarationProps\n) {\n  const { children, doc, typeParameters, ...rest } = props;\n\n  return (\n    <>\n      <Show when={Boolean(doc)}>\n        <TSDoc heading={doc} />\n      </Show>\n      <Declaration {...rest} kind=\"type\" nameKind=\"type\">\n        type <Name />\n        {typeParameters && (\n          <TypeParameters parameters={typeParameters} />\n        )} = {children};\n      </Declaration>\n    </>\n  );\n});\n"],"mappings":"+SA0BA,MAAS,EAAsB,EAAmB,SAAA,EAAA,KAElD,WACI,MACA,iBACA,GAAA,GACF,EACF,MAAA,CAAA,EAAA,EAAA,YAEE,MAAA,EAAA,GAEA,IAAA,UAAA,CACI,OAAO,EAAkB,EAAA,CACvB,QAAC,EACP,CAAA,aAGA,KAAO,OACL,SAAC,OACD,IAAG,UAAW,CACZ,MAAG,CAAK,QAAS,EAAO,EAAA,EAAA,CAAA,CAAA,MAAA,GAAA,EAAA,EAAA,CACtB,WAAI,EACL,CAAA,CAAA,CAAA,MAAW,EAAU,IAAC,EAE1B,CAAC,CAAC,CAAC,EACJ"}
+{"version":3,"file":"type-declaration.mjs","names":[],"sources":["../../../src/typescript/components/type-declaration.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 { Name, Show } from \"@alloy-js/core\";\nimport {\n  CommonDeclarationProps,\n  Declaration,\n  ensureTypeRefContext,\n  TypeParameterDescriptor\n} from \"@alloy-js/typescript\";\nimport { TSDoc } from \"./tsdoc\";\nimport { TypeParameters } from \"./type-parameters\";\n\nexport interface TypeDeclarationProps extends CommonDeclarationProps {\n  /**\n   * The generic type parameters of the interface.\n   */\n  typeParameters?: TypeParameterDescriptor[] | string[];\n}\n\n/**\n * Renders a TypeScript type declaration, including its name, optional TSDoc comment, and generic type parameters.\n */\nexport const TypeDeclaration = ensureTypeRefContext(function TypeDeclaration(\n  props: TypeDeclarationProps\n) {\n  const { children, doc, typeParameters, ...rest } = props;\n\n  return (\n    <>\n      <Show when={Boolean(doc)}>\n        <TSDoc heading={doc} />\n      </Show>\n      <Declaration {...rest} kind=\"type\" nameKind=\"type\">\n        type <Name />\n        {typeParameters && (\n          <TypeParameters parameters={typeParameters} />\n        )} = {children};\n      </Declaration>\n    </>\n  );\n});\n"],"mappings":";;;;;;;;;;AA0BA,MAAS,kBAAsB,qBAAmB,SAAA,gBAAA,OAAA;SAElD,UACI,KACA,gBACA,GAAA,SACF;AACF,QAAA,CAAA,gBAAA,MAAA;;AAEE,UAAA,QAAA,IAAA;;EAEA,IAAA,WAAA;AACI,UAAO,gBAAkB,OAAA,EACvB,SAAC,KACP,CAAA;;;EAGA,MAAO;EACL,UAAC;EACD,IAAG,WAAW;AACZ,UAAG;IAAK;IAAS,gBAAO,MAAA,EAAA,CAAA;IAAA,WAAA,kBAAA,gBAAA,gBAAA,EACtB,YAAI,gBACL,CAAA,CAAA;IAAA;IAAW;IAAU;IAAC;;EAE1B,CAAC,CAAC,CAAC;EACJ"}