@powerlines/plugin-alloy 0.19.13 → 0.19.15

package/dist/tsdoc-CfvwK4Ml.d.cts

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

package/dist/tsdoc-CfvwK4Ml.d.cts.map

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

package/dist/tsdoc-Crv526i6.mjs

@@ -0,0 +1,466 @@
+import { a as usePowerlinesSafe } from "./context-e2kZWEFW.mjs";
+import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { For, List, Prose, Show, childrenArray, 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);
+						},
+						get children() {
+							return [
+								heading,
+								createIntrinsic("hbr", {}),
+								createComponent(Show, {
+									get when() {
+										return memo(() => !!!isUndefined(children))() && childrenArray(() => children).length > 0;
+									},
+									get children() {
+										return createIntrinsic("hbr", {});
+									}
+								})
+							];
+						}
+					}),
+					createComponent(Show, {
+						get when() {
+							return memo(() => !!!isUndefined(children))() && childrenArray(() => children).length > 0;
+						},
+						get children() {
+							return createComponent(List, { 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("hbr", {})
+	];
+}
+/**
+* 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);
+						} });
+					}
+				});
+			}
+		}),
+		createIntrinsic("hbr", {})
+	];
+}
+/**
+* Create a TSDoc `@remarks` tag.
+*/
+function TSDocRemarks(props) {
+	return [
+		"@remarks ",
+		createIntrinsic("hbr", {}),
+		createComponent(List, {
+			hardline: 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" });
+}
+/**
+* Generates a TypeScript interface property for the given reflection class.
+*/
+function TSDocAttributesTags(props) {
+	const [{ type, title, alias, permission, domain, readonly, internal, ignore, hidden, defaultValue }] = splitProps(props, [
+		"type",
+		"title",
+		"alias",
+		"permission",
+		"domain",
+		"readonly",
+		"internal",
+		"ignore",
+		"hidden",
+		"defaultValue"
+	]);
+	return [
+		createComponent(Show, {
+			get when() {
+				return isSetString(title?.trim());
+			},
+			get children() {
+				return createComponent(TSDocTitle, { children: title });
+			}
+		}),
+		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$1) => createComponent(TSDocAlias, { children: alias$1 })
+				});
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return isSetString(domain?.trim());
+			},
+			get children() {
+				return createComponent(TSDocDomain, { children: domain });
+			}
+		}),
+		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$1) => createComponent(TSDocPermission, { children: permission$1 })
+				});
+			}
+		}),
+		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
+				});
+			}
+		})
+	];
+}
+/**
+* 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: true,
+									get children() {
+										return childrenArray(() => children);
+									}
+								}),
+								createIntrinsic("hbr", {}),
+								createIntrinsic("hbr", {})
+							];
+						}
+					}),
+					"@module ",
+					memo(() => prefix || context?.config?.framework || "powerlines"),
+					":",
+					name
+				];
+			}
+		}),
+		createIntrinsic("hbr", {}),
+		` */`
+	];
+}
+
+//#endregion
+export { TSDocReturns as _, TSDocDomain as a, TSDocTitle as b, TSDocIgnore as c, TSDocModule as d, TSDocParam as f, TSDocRemarks as g, TSDocReadonly as h, TSDocDefaultValue as i, TSDocInternal as l, TSDocPermission as m, TSDocAlias as n, TSDocExample as o, TSDocParams as p, TSDocAttributesTags as r, TSDocHidden as s, TSDoc as t, TSDocLink as u, TSDocTag as v, TSDocThrows as y };
+//# sourceMappingURL=tsdoc-Crv526i6.mjs.map

package/dist/tsdoc-Crv526i6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsdoc-Crv526i6.mjs","names":["childrenArray","For","List","Prose","Show","splitProps","stringifyDefaultValue","isSetString","isUndefined","usePowerlinesSafe","TSDoc","props","children","heading","_$createIntrinsic","string","_$createComponent","when","_$memo","length","TSDocTag","tag","Boolean","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","title","alias","permission","domain","readonly","internal","ignore","hidden","trim","a","filter","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  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 { 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)}>\n          {heading}\n          <hbr />\n          <Show\n            when={\n              !isUndefined(children) && childrenArray(() => children).length > 0\n            }>\n            <hbr />\n          </Show>\n        </Show>\n        <Show\n          when={\n            !isUndefined(children) && childrenArray(() => children).length > 0\n          }>\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      <hbr />\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      <hbr />\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      title,\n      alias,\n      permission,\n      domain,\n      readonly,\n      internal,\n      ignore,\n      hidden,\n      defaultValue\n    }\n  ] = splitProps(props, [\n    \"type\",\n    \"title\",\n    \"alias\",\n    \"permission\",\n    \"domain\",\n    \"readonly\",\n    \"internal\",\n    \"ignore\",\n    \"hidden\",\n    \"defaultValue\"\n  ]);\n\n  return (\n    <>\n      <Show when={isSetString(title?.trim())}>\n        <TSDocTitle>{title}</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?.trim())}>\n        <TSDocDomain>{domain}</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          <hbr />\n          <hbr />\n        </Show>\n        {\"@module \"}\n        {prefix || context?.config?.framework || \"powerlines\"}:{name}\n      </align>\n      <hbr />\n      {` */`}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;SA+GE,MAAA,OAAA;UAAA,UAAA,aAAA,WAAA,OAAA,CAAA,YAAA,UAAA,CAAA;;;;;;;;;;mCAgBA;;MAAA,IAAA,WAAA;AAAA,cAAA;;QAAA,gBAAA,OAAA,EAAA,CAAA;QAAA,sBAAA;SAAA,IAAA,OAAA;AAAA,iBAAA,WAAA,CAAA,CAAA,CAAA,YAAA,SAAA,CAAA,EAAA,IAAA,oBAAA,SAAA,CAAA,SAAA;;SAAA,IAAA,WAAA;AAAA,iBAAA,gBAAA,OAAA,EAAA,CAAA;;SAAA,CAAA;QAAA;;MAAA,CAAA;KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAiHc+C;;;;;;;;;;oBA6Bd/B,OAAAA;OAAAA,CAAAA,EAAAA,YAAAA,QAAAA,WAAAA,OAAAA,CAAAA,WAAAA,CAAAA;AAAAA,QAAAA;;;;;;;;gCAqBoB;OAAA,CAAA,EAAA,YAAA,QAAA,WAAA,OAAA,CAAA,WAAA,CAAA;wBAAA,UAAA,WAAA,MAAA;EAAA,KAAA;EAAA;EAAA,CAAA,CAAA;;;;;;;;;kBAgDsB,MAAA;GAAA,IAAA,OAAA;AAAA,WAAA,CAAA,YAAA,aAAA;;GAAA,IAAA,WAAA;AAAA,WAAA,gBAAA,SAAA;KAAA,OAAA;KAAA,IAAA,WAAA;AAAA,aAAA,gBAAA,OAAA,EAAA,IAAA,WAAA;AAAA,cAAA,sBAAA,MAAA,aAAA;SAAA,CAAA;;KAAA,CAAA;;GAAA,CAAA;EAAA,gBAAA,OAAA,EAAA,CAAA;EAAA;;;;;;;;;kBA6BjC,MAAA;GAAA,UAAA;GAAA,IAAA,WAAA;AAAA,WAAA,oBAAA,MAAA,SAAA;;GAAA,CAAA;EAAA;;;;;;;;;;;SA8BX,aAAA,OAAA;OAAA,CAAA,EAAA,KAAA,SAAA,MAAA,UAAA,cAAA,WAAA,OAAA;EAAA;;;;;;EAOgB;EAAA,gBAAA,OAAA,EAAA,CAAA;EAAA;;;;;;;;;;;kBAAQe,MAAAA;GAAAA,MAAAA;GAAAA,IAAAA,WAAAA;AAAAA,WAAAA,CAAAA,gBAAAA,OAAAA,EAAAA,CAAAA,EAAAA,MAAAA;;GAAAA,CAAAA;EAAAA;;;;;;;;;;;SAuBxB,gBAAA;wBAAA,UAAA,EAAA,KAAA,YAAA,CAAA;;;;;SAAA,cAAA;wBAAA,UAAA,EAAA,KAAA,UAAA,CAAA;;;;;;;;;;;SAmBA,oBAAA,OAAA;CAAA,MAAA,CAAA,EAAA,MAAA,OAAA,OAAA,oBAAA,UAAA,UAAA;;;;;;;;;EAMA;EAAA;;;;;;;;;;;;OAoCA,OAAA;AAAA,WAAA,WAAA,CAAA,EAAA,CAAA,YAAA"}