@powerlines/plugin-alloy 0.25.27 → 0.25.29

package/dist/typescript/components/tsdoc.cjs

@@ -2,7 +2,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
 const require_core_contexts_context = require('../../core/contexts/context.cjs');
 const require_core_components_spacing = require('../../core/components/spacing.cjs');
-let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let _alloy_js_core = require("@alloy-js/core");
 let _powerlines_deepkit_utilities = require("@powerlines/deepkit/utilities");
 let _stryke_type_checks_is_undefined = require("@stryke/type-checks/is-undefined");
@@ -14,85 +13,48 @@ let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-stri
 */
 function TSDoc(props) {
 	const [{ children, heading }] = (0, _alloy_js_core.splitProps)(props, ["children", "heading"]);
-	return [
-		"/**",
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("align", {
-			string: " * ",
-			get children() {
-				return [
-					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-						get when() {
-							return !(0, _stryke_type_checks_is_undefined.isUndefined)(heading);
-						},
-						children: heading
-					}),
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-						get when() {
-							return (0, _alloy_js_core_jsx_runtime.memo)(() => !!!(0, _stryke_type_checks_is_undefined.isUndefined)(children))() && (0, _alloy_js_core.childrenArray)(() => children).filter(Boolean).length > 0;
-						},
-						get children() {
-							return [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-								get when() {
-									return !(0, _stryke_type_checks_is_undefined.isUndefined)(heading);
-								},
-								get children() {
-									return (0, _alloy_js_core_jsx_runtime.createComponent)(require_core_components_spacing.Spacing, {});
-								}
-							}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.List, { get children() {
-								return (0, _alloy_js_core.childrenArray)(() => children);
-							} })];
-						}
-					})
-				];
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		`*/`,
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
-	];
+	return <>
+      /**
+      <align string=" * ">
+        <hbr />
+        <_alloy_js_core.Show when={!(0, _stryke_type_checks_is_undefined.isUndefined)(heading)}>{heading}</_alloy_js_core.Show>
+        <_alloy_js_core.Show when={!(0, _stryke_type_checks_is_undefined.isUndefined)(children) && (0, _alloy_js_core.childrenArray)(() => children).filter(Boolean).length > 0}>
+          <_alloy_js_core.Show when={!(0, _stryke_type_checks_is_undefined.isUndefined)(heading)}>
+            <require_core_components_spacing.Spacing />
+          </_alloy_js_core.Show>
+          <_alloy_js_core.List>{(0, _alloy_js_core.childrenArray)(() => children)}</_alloy_js_core.List>
+        </_alloy_js_core.Show>
+      </align>
+      <hbr />
+      {`*/`}
+      <hbr />
+    </>;
 }
 /**
 * Create a TSDoc `@<props.tag>` tag.
 */
 function TSDocTag(props) {
 	const [{ children, tag }] = (0, _alloy_js_core.splitProps)(props, ["children", "tag"]);
-	return [
-		`@${tag} `,
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			get when() {
-				return Boolean(children);
-			},
-			get children() {
-				return (0, _alloy_js_core_jsx_runtime.createIntrinsic)("align", {
-					width: 2,
-					get children() {
-						return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Prose, { children });
-					}
-				});
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("sbr", {})
-	];
+	return <>
+      {`@${tag} `}
+      <_alloy_js_core.Show when={Boolean(children)}>
+        <align width={2}>
+          <_alloy_js_core.Prose>{children}</_alloy_js_core.Prose>
+        </align>
+      </_alloy_js_core.Show>
+      <sbr />
+    </>;
 }
 /**
 * A component that creates a TSDoc block with `@param` tags for each parameter.
 */
 function TSDocParams(props) {
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
-		each: normalizeParametersForDoc(props.parameters),
-		children: (param) => (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocParam, {
-			get name() {
-				return param.name;
-			},
-			get optional() {
-				return param.optional;
-			},
-			get children() {
-				return param.doc;
-			}
-		})
-	});
+	const parameters = normalizeParametersForDoc(props.parameters);
+	return <_alloy_js_core.For each={parameters}>
+      {(param) => <TSDocParam name={param.name} optional={param.optional}>
+          {param.doc}
+        </TSDocParam>}
+    </_alloy_js_core.For>;
 }
 function normalizeParametersForDoc(parameters) {
 	if (parameters.some((p) => typeof p === "string")) return [];
@@ -103,82 +65,66 @@ function normalizeParametersForDoc(parameters) {
 */
 function TSDocTitle(props) {
 	const [{ children }, rest] = (0, _alloy_js_core.splitProps)(props, ["children"]);
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocTag, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
-		tag: "title",
-		children
-	}));
+	return <TSDocTag {...rest} tag="title">
+      {children}
+    </TSDocTag>;
 }
 /**
 * Create a TSDoc `@domain` tag.
 */
 function TSDocDomain(props) {
 	const [{ children }, rest] = (0, _alloy_js_core.splitProps)(props, ["children"]);
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocTag, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
-		tag: "domain",
-		children
-	}));
+	return <TSDocTag {...rest} tag="domain">
+      {children}
+    </TSDocTag>;
 }
 /**
 * Create a TSDoc `@alias` tag.
 */
 function TSDocAlias(props) {
 	const [{ children }, rest] = (0, _alloy_js_core.splitProps)(props, ["children"]);
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocTag, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
-		tag: "alias",
-		children
-	}));
+	return <TSDocTag {...rest} tag="alias">
+      {children}
+    </TSDocTag>;
 }
 /**
 * Create a TSDoc `@permission` tag.
 */
 function TSDocPermission(props) {
 	const [{ children }, rest] = (0, _alloy_js_core.splitProps)(props, ["children"]);
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocTag, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
-		tag: "permission",
-		children
-	}));
+	return <TSDocTag {...rest} tag="permission">
+      {children}
+    </TSDocTag>;
 }
 /**
 * Create a TSDoc `@defaultValue` tag.
 */
 function TSDocDefaultValue(props) {
 	const [{ type, defaultValue }] = (0, _alloy_js_core.splitProps)(props, ["type", "defaultValue"]);
-	return ["@defaultValue ", (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-		get when() {
-			return !(0, _stryke_type_checks_is_undefined.isUndefined)(defaultValue);
-		},
-		get children() {
-			return (0, _alloy_js_core_jsx_runtime.createIntrinsic)("align", {
-				width: 2,
-				get children() {
-					return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Prose, { get children() {
-						return (0, _powerlines_deepkit_utilities.stringifyDefaultValue)(type, defaultValue);
-					} });
-				}
-			});
-		}
-	})];
+	return <>
+      {"@defaultValue "}
+      <_alloy_js_core.Show when={!(0, _stryke_type_checks_is_undefined.isUndefined)(defaultValue)}>
+        <align width={2}>
+          <_alloy_js_core.Prose>{(0, _powerlines_deepkit_utilities.stringifyDefaultValue)(type, defaultValue)}</_alloy_js_core.Prose>
+        </align>
+      </_alloy_js_core.Show>
+    </>;
 }
 /**
 * Create a TSDoc `@remarks` tag.
 */
 function TSDocRemarks(props) {
-	return [
-		"@remarks ",
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.List, {
-			hardline: true,
-			get children() {
-				return (0, _alloy_js_core.childrenArray)(() => props.children);
-			}
-		})
-	];
+	return <>
+      {"@remarks "}
+      <hbr />
+      <_alloy_js_core.List hardline={true}>{(0, _alloy_js_core.childrenArray)(() => props.children)}</_alloy_js_core.List>
+    </>;
 }
 /**
 * Create a TSDoc `@see` tag.
 */
 function TSDocLink(props) {
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocTag, (0, _alloy_js_core_jsx_runtime.mergeProps)(props, { tag: "see" }));
+	return <TSDocTag {...props} tag="see" />;
 }
 /**
 * Create a TSDoc `@example` tag.
@@ -190,51 +136,43 @@ function TSDocExample(props) {
 		"language",
 		"children"
 	]);
-	return [
-		"@example ",
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			when: fenced,
-			get children() {
-				return [
-					"```",
-					language || (tsx ? "tsx" : "ts"),
-					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
-				];
-			}
-		}),
-		children,
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			when: fenced,
-			get children() {
-				return [(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}), "```"];
-			}
-		})
-	];
+	return <>
+      {"@example "}
+      <hbr />
+      <_alloy_js_core.Show when={fenced}>
+        ```{language || (tsx ? "tsx" : "ts")}
+        <hbr />
+      </_alloy_js_core.Show>
+      {children}
+      <_alloy_js_core.Show when={fenced}>
+        <hbr />
+        ```
+      </_alloy_js_core.Show>
+    </>;
 }
 /**
 * Create a TSDoc `@readonly` tag.
 */
 function TSDocReadonly() {
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocTag, { tag: "readonly" });
+	return <TSDocTag tag="readonly" />;
 }
 /**
 * Create a TSDoc `@internal` tag.
 */
 function TSDocInternal() {
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocTag, { tag: "internal" });
+	return <TSDocTag tag="internal" />;
 }
 /**
 * Create a TSDoc `@ignore` tag.
 */
 function TSDocIgnore() {
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocTag, { tag: "ignore" });
+	return <TSDocTag tag="ignore" />;
 }
 /**
 * Create a TSDoc `@hidden` tag.
 */
 function TSDocHidden() {
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocTag, { tag: "hidden" });
+	return <TSDocTag tag="hidden" />;
 }
 /**
 * Generates a TypeScript interface property for the given reflection class.
@@ -252,165 +190,77 @@ function TSDocAttributesTags(props) {
 	]);
 	const title = (0, _alloy_js_core.computed)(() => props.title?.trim() || "");
 	const domain = (0, _alloy_js_core.computed)(() => props.domain?.trim() || "");
-	return [
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			get when() {
-				return (0, _stryke_type_checks_is_set_string.isSetString)(title.value);
-			},
-			get children() {
-				return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocTitle, { get children() {
-					return title.value;
-				} });
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			get when() {
-				return (0, _alloy_js_core_jsx_runtime.memo)(() => !!(!(0, _stryke_type_checks_is_undefined.isUndefined)(alias) && alias.length > 0))() && alias.some((a) => (0, _stryke_type_checks_is_set_string.isSetString)(a?.trim()));
-			},
-			get children() {
-				return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
-					get each() {
-						return alias?.filter((a) => (0, _stryke_type_checks_is_set_string.isSetString)(a?.trim())) ?? [];
-					},
-					children: (alias) => (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocAlias, { children: alias })
-				});
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			get when() {
-				return (0, _stryke_type_checks_is_set_string.isSetString)(domain.value);
-			},
-			get children() {
-				return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocDomain, { get children() {
-					return domain.value;
-				} });
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			get when() {
-				return (0, _alloy_js_core_jsx_runtime.memo)(() => !!(!(0, _stryke_type_checks_is_undefined.isUndefined)(permission) && permission.length > 0))() && permission.some((p) => (0, _stryke_type_checks_is_set_string.isSetString)(p?.trim()));
-			},
-			get children() {
-				return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
-					get each() {
-						return permission?.filter((p) => (0, _stryke_type_checks_is_set_string.isSetString)(p?.trim())) ?? [];
-					},
-					children: (permission) => (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocPermission, { children: permission })
-				});
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			when: readonly === true,
-			get children() {
-				return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocReadonly, {});
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			when: internal === true,
-			get children() {
-				return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocInternal, {});
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			when: ignore === true,
-			get children() {
-				return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocIgnore, {});
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			when: hidden === true,
-			get children() {
-				return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocHidden, {});
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			get when() {
-				return (0, _alloy_js_core_jsx_runtime.memo)(() => !!!(0, _stryke_type_checks_is_undefined.isUndefined)(type))() && !(0, _stryke_type_checks_is_undefined.isUndefined)(defaultValue);
-			},
-			get children() {
-				return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocDefaultValue, {
-					type,
-					defaultValue
-				});
-			}
-		})
-	];
+	return <>
+      <_alloy_js_core.Show when={(0, _stryke_type_checks_is_set_string.isSetString)(title.value)}>
+        <TSDocTitle>{title.value}</TSDocTitle>
+      </_alloy_js_core.Show>
+      <_alloy_js_core.Show when={!(0, _stryke_type_checks_is_undefined.isUndefined)(alias) && alias.length > 0 && alias.some((a) => (0, _stryke_type_checks_is_set_string.isSetString)(a?.trim()))}>
+        <_alloy_js_core.For each={alias?.filter((a) => (0, _stryke_type_checks_is_set_string.isSetString)(a?.trim())) ?? []}>
+          {(alias) => <TSDocAlias>{alias}</TSDocAlias>}
+        </_alloy_js_core.For>
+      </_alloy_js_core.Show>
+      <_alloy_js_core.Show when={(0, _stryke_type_checks_is_set_string.isSetString)(domain.value)}>
+        <TSDocDomain>{domain.value}</TSDocDomain>
+      </_alloy_js_core.Show>
+      <_alloy_js_core.Show when={!(0, _stryke_type_checks_is_undefined.isUndefined)(permission) && permission.length > 0 && permission.some((p) => (0, _stryke_type_checks_is_set_string.isSetString)(p?.trim()))}>
+        <_alloy_js_core.For each={permission?.filter((p) => (0, _stryke_type_checks_is_set_string.isSetString)(p?.trim())) ?? []}>
+          {(permission) => <TSDocPermission>{permission}</TSDocPermission>}
+        </_alloy_js_core.For>
+      </_alloy_js_core.Show>
+      <_alloy_js_core.Show when={readonly === true}>
+        <TSDocReadonly />
+      </_alloy_js_core.Show>
+      <_alloy_js_core.Show when={internal === true}>
+        <TSDocInternal />
+      </_alloy_js_core.Show>
+      <_alloy_js_core.Show when={ignore === true}>
+        <TSDocIgnore />
+      </_alloy_js_core.Show>
+      <_alloy_js_core.Show when={hidden === true}>
+        <TSDocHidden />
+      </_alloy_js_core.Show>
+      <_alloy_js_core.Show when={!(0, _stryke_type_checks_is_undefined.isUndefined)(type) && !(0, _stryke_type_checks_is_undefined.isUndefined)(defaultValue)}>
+        <TSDocDefaultValue type={type} defaultValue={defaultValue} />
+      </_alloy_js_core.Show>
+    </>;
 }
 /**
 * Create a TSDoc parameter set off with `@param`.
 */
 function TSDocParam(props) {
-	return [
-		"@param ",
-		(0, _alloy_js_core_jsx_runtime.createComponent)(TSDocParamName, {
-			get name() {
-				return props.name;
-			},
-			get optional() {
-				return props.optional;
-			},
-			get defaultValue() {
-				return props.defaultValue;
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(TSDocParamDescription, { get children() {
-			return props.children;
-		} })
-	];
+	return <>
+      {"@param "}
+      <TSDocParamName name={props.name} optional={props.optional} defaultValue={props.defaultValue} />
+      <TSDocParamDescription children={props.children} />
+    </>;
 }
 function TSDocParamName(props) {
-	return [
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			get when() {
-				return props.optional;
-			},
-			children: "["
-		}),
-		(0, _alloy_js_core_jsx_runtime.memo)(() => props.name),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			get when() {
-				return Boolean(props.defaultValue);
-			},
-			get children() {
-				return ["=", (0, _alloy_js_core_jsx_runtime.memo)(() => props.defaultValue)];
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-			get when() {
-				return props.optional;
-			},
-			children: "]"
-		})
-	];
+	return <>
+      <_alloy_js_core.Show when={props.optional}>{"["}</_alloy_js_core.Show>
+      {props.name}
+      <_alloy_js_core.Show when={Boolean(props.defaultValue)}>={props.defaultValue}</_alloy_js_core.Show>
+      <_alloy_js_core.Show when={props.optional}>{"]"}</_alloy_js_core.Show>
+    </>;
 }
 function TSDocParamDescription(props) {
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-		get when() {
-			return Boolean(props.children);
-		},
-		get children() {
-			return [" - ", (0, _alloy_js_core_jsx_runtime.createIntrinsic)("align", {
-				width: 2,
-				get children() {
-					return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Prose, { get children() {
-						return props.children;
-					} });
-				}
-			})];
-		}
-	});
+	return <_alloy_js_core.Show when={Boolean(props.children)}>
+      {" - "}
+      <align width={2}>
+        <_alloy_js_core.Prose>{props.children}</_alloy_js_core.Prose>
+      </align>
+    </_alloy_js_core.Show>;
 }
 /**
 * Create a TSDoc `@returns` tag.
 */
 function TSDocReturns(props) {
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocTag, (0, _alloy_js_core_jsx_runtime.mergeProps)(props, { tag: "returns" }));
+	return <TSDocTag {...props} tag="returns" />;
 }
 /**
 * Create a TSDoc `@throws` tag.
 */
 function TSDocThrows(props) {
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocTag, (0, _alloy_js_core_jsx_runtime.mergeProps)(props, { tag: "throws" }));
+	return <TSDocTag {...props} tag="throws" />;
 }
 /**
 * Generates a TSDoc `@module` tag for the given module name.
@@ -422,36 +272,20 @@ function TSDocModule(props) {
 		"prefix"
 	]);
 	const context = require_core_contexts_context.usePowerlinesSafe();
-	return [
-		"/**",
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("align", {
-			string: " * ",
-			get children() {
-				return [
-					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-						get when() {
-							return Boolean(children);
-						},
-						get children() {
-							return [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.List, {
-								hardline: true,
-								get children() {
-									return (0, _alloy_js_core.childrenArray)(() => children);
-								}
-							}), (0, _alloy_js_core_jsx_runtime.createComponent)(require_core_components_spacing.Spacing, {})];
-						}
-					}),
-					"@module ",
-					(0, _alloy_js_core_jsx_runtime.memo)(() => prefix || context?.config?.framework || "powerlines"),
-					":",
-					name
-				];
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-		` */`
-	];
+	return <>
+      /**
+      <align string=" * ">
+        <hbr />
+        <_alloy_js_core.Show when={Boolean(children)}>
+          <_alloy_js_core.List hardline={true}>{(0, _alloy_js_core.childrenArray)(() => children)}</_alloy_js_core.List>
+          <require_core_components_spacing.Spacing />
+        </_alloy_js_core.Show>
+        {"@module "}
+        {prefix || context?.config?.framework || "powerlines"}:{name}
+      </align>
+      <hbr />
+      {` */`}
+    </>;
 }
 
 //#endregion