@powerlines/plugin-alloy 0.26.25 → 0.26.27

package/dist/typescript/components/tsdoc.mjs

@@ -1,7 +1,7 @@
 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 { Fragment, jsx, jsxs } from "@alloy-js/core/jsx-runtime";
 import { stringifyDefaultValue } from "@powerlines/deepkit/utilities";
 import { isUndefined } from "@stryke/type-checks/is-undefined";
 import { isSetString } from "@stryke/type-checks/is-set-string";
@@ -12,61 +12,87 @@ import { isSetString } from "@stryke/type-checks/is-set-string";
 */
 function TSDoc(props) {
 	const [{ children, heading }] = splitProps(props, ["children", "heading"]);
-	return /* @__PURE__ */ jsxs(Fragment, { children: [
+	return [
 		"/**",
-		/* @__PURE__ */ jsxs("align", {
+		createIntrinsic("align", {
 			string: " * ",
-			children: [
-				/* @__PURE__ */ jsx("hbr", {}),
-				/* @__PURE__ */ jsx(Show, {
-					when: !isUndefined(heading),
-					children: heading
-				}),
-				/* @__PURE__ */ jsxs(Show, {
-					when: !isUndefined(children) && childrenArray(() => children).filter(Boolean).length > 0,
-					children: [/* @__PURE__ */ jsx(Show, {
-						when: !isUndefined(heading),
-						children: /* @__PURE__ */ jsx(Spacing, {})
-					}), /* @__PURE__ */ jsx(List, {
-						hardline: false,
-						softline: true,
-						children: childrenArray(() => children)
-					})]
-				})
-			]
+			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);
+								}
+							})];
+						}
+					})
+				];
+			}
 		}),
-		/* @__PURE__ */ jsx("hbr", {}),
+		createIntrinsic("hbr", {}),
 		`*/`,
-		/* @__PURE__ */ jsx("hbr", {})
-	] });
+		createIntrinsic("hbr", {})
+	];
 }
 /**
 * Create a TSDoc `@<props.tag>` tag.
 */
 function TSDocTag(props) {
 	const [{ children, tag }] = splitProps(props, ["children", "tag"]);
-	return /* @__PURE__ */ jsxs(Fragment, { children: [
+	return [
 		`@${tag} `,
-		/* @__PURE__ */ jsx(Show, {
-			when: Boolean(children),
-			children: /* @__PURE__ */ jsx("align", {
-				width: 2,
-				children: /* @__PURE__ */ jsx(Prose, { children })
-			})
+		createComponent(Show, {
+			get when() {
+				return Boolean(children);
+			},
+			get children() {
+				return createIntrinsic("align", {
+					width: 2,
+					get children() {
+						return createComponent(Prose, { children });
+					}
+				});
+			}
 		}),
-		/* @__PURE__ */ jsx("sbr", {})
-	] });
+		createIntrinsic("sbr", {})
+	];
 }
 /**
 * A component that creates a TSDoc block with `@param` tags for each parameter.
 */
 function TSDocParams(props) {
-	return /* @__PURE__ */ jsx(For, {
+	return createComponent(For, {
 		each: normalizeParametersForDoc(props.parameters),
-		children: (param) => /* @__PURE__ */ jsx(TSDocParam, {
-			name: param.name,
-			optional: param.optional,
-			children: param.doc
+		children: (param) => createComponent(TSDocParam, {
+			get name() {
+				return param.name;
+			},
+			get optional() {
+				return param.optional;
+			},
+			get children() {
+				return param.doc;
+			}
 		})
 	});
 }
@@ -79,80 +105,83 @@ function normalizeParametersForDoc(parameters) {
 */
 function TSDocTitle(props) {
 	const [{ children }, rest] = splitProps(props, ["children"]);
-	return /* @__PURE__ */ jsx(TSDocTag, {
-		...rest,
+	return createComponent(TSDocTag, mergeProps(rest, {
 		tag: "title",
 		children
-	});
+	}));
 }
 /**
 * Create a TSDoc `@domain` tag.
 */
 function TSDocDomain(props) {
 	const [{ children }, rest] = splitProps(props, ["children"]);
-	return /* @__PURE__ */ jsx(TSDocTag, {
-		...rest,
+	return createComponent(TSDocTag, mergeProps(rest, {
 		tag: "domain",
 		children
-	});
+	}));
 }
 /**
 * Create a TSDoc `@alias` tag.
 */
 function TSDocAlias(props) {
 	const [{ children }, rest] = splitProps(props, ["children"]);
-	return /* @__PURE__ */ jsx(TSDocTag, {
-		...rest,
+	return createComponent(TSDocTag, mergeProps(rest, {
 		tag: "alias",
 		children
-	});
+	}));
 }
 /**
 * Create a TSDoc `@permission` tag.
 */
 function TSDocPermission(props) {
 	const [{ children }, rest] = splitProps(props, ["children"]);
-	return /* @__PURE__ */ jsx(TSDocTag, {
-		...rest,
+	return createComponent(TSDocTag, mergeProps(rest, {
 		tag: "permission",
 		children
-	});
+	}));
 }
 /**
 * Create a TSDoc `@defaultValue` tag.
 */
 function TSDocDefaultValue(props) {
 	const [{ type, defaultValue }] = splitProps(props, ["type", "defaultValue"]);
-	return /* @__PURE__ */ jsxs(Fragment, { children: ["@defaultValue ", /* @__PURE__ */ jsx(Show, {
-		when: !isUndefined(defaultValue),
-		children: /* @__PURE__ */ jsx("align", {
-			width: 2,
-			children: /* @__PURE__ */ jsx(Prose, { children: stringifyDefaultValue(type, defaultValue) })
-		})
-	})] });
+	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 /* @__PURE__ */ jsxs(Fragment, { children: [
+	return [
 		"@remarks ",
-		/* @__PURE__ */ jsx("hbr", {}),
-		/* @__PURE__ */ jsx(List, {
+		createIntrinsic("hbr", {}),
+		createComponent(List, {
 			hardline: false,
 			softline: true,
-			children: childrenArray(() => props.children)
+			get children() {
+				return childrenArray(() => props.children);
+			}
 		})
-	] });
+	];
 }
 /**
 * Create a TSDoc `@see` tag.
 */
 function TSDocLink(props) {
-	return /* @__PURE__ */ jsx(TSDocTag, {
-		...props,
-		tag: "see"
-	});
+	return createComponent(TSDocTag, mergeProps(props, { tag: "see" }));
 }
 /**
 * Create a TSDoc `@example` tag.
@@ -164,53 +193,57 @@ function TSDocExample(props) {
 		"language",
 		"children"
 	]);
-	return /* @__PURE__ */ jsxs(Fragment, { children: [
+	return [
 		"@example ",
-		/* @__PURE__ */ jsx("hbr", {}),
-		/* @__PURE__ */ jsxs(Show, {
+		createIntrinsic("hbr", {}),
+		createComponent(Show, {
 			when: fenced,
-			children: [
-				"```",
-				language || (tsx ? "tsx" : "ts"),
-				/* @__PURE__ */ jsx("hbr", {})
-			]
+			get children() {
+				return [
+					"```",
+					language || (tsx ? "tsx" : "ts"),
+					createIntrinsic("hbr", {})
+				];
+			}
 		}),
 		children,
-		/* @__PURE__ */ jsxs(Show, {
+		createComponent(Show, {
 			when: fenced,
-			children: [/* @__PURE__ */ jsx("hbr", {}), "```"]
+			get children() {
+				return [createIntrinsic("hbr", {}), "```"];
+			}
 		})
-	] });
+	];
 }
 /**
 * Create a TSDoc `@readonly` tag.
 */
 function TSDocReadonly() {
-	return /* @__PURE__ */ jsx(TSDocTag, { tag: "readonly" });
+	return createComponent(TSDocTag, { tag: "readonly" });
 }
 /**
 * Create a TSDoc `@internal` tag.
 */
 function TSDocInternal() {
-	return /* @__PURE__ */ jsx(TSDocTag, { tag: "internal" });
+	return createComponent(TSDocTag, { tag: "internal" });
 }
 /**
 * Create a TSDoc `@ignore` tag.
 */
 function TSDocIgnore() {
-	return /* @__PURE__ */ jsx(TSDocTag, { tag: "ignore" });
+	return createComponent(TSDocTag, { tag: "ignore" });
 }
 /**
 * Create a TSDoc `@hidden` tag.
 */
 function TSDocHidden() {
-	return /* @__PURE__ */ jsx(TSDocTag, { tag: "hidden" });
+	return createComponent(TSDocTag, { tag: "hidden" });
 }
 /**
 * Create a TSDoc `@runtime` tag.
 */
 function TSDocRuntime() {
-	return /* @__PURE__ */ jsx(TSDocTag, { tag: "runtime" });
+	return createComponent(TSDocTag, { tag: "runtime" });
 }
 /**
 * Generates a TypeScript interface property for the given reflection class.
@@ -229,115 +262,171 @@ function TSDocAttributesTags(props) {
 	]);
 	const title = computed(() => props.title?.trim() || "");
 	const domain = computed(() => props.domain?.trim() || "");
-	return /* @__PURE__ */ jsxs(Fragment, { children: [
-		/* @__PURE__ */ jsx(Show, {
-			when: isSetString(title.value),
-			children: /* @__PURE__ */ jsx(TSDocTitle, { children: title.value })
+	return [
+		createComponent(Show, {
+			get when() {
+				return isSetString(title.value);
+			},
+			get children() {
+				return createComponent(TSDocTitle, { get children() {
+					return title.value;
+				} });
+			}
 		}),
-		/* @__PURE__ */ jsx(Show, {
-			when: !isUndefined(alias) && alias.length > 0 && alias.some((a) => isSetString(a?.trim())),
-			children: /* @__PURE__ */ jsx(For, {
-				each: alias?.filter((a) => isSetString(a?.trim())) ?? [],
-				children: (alias) => /* @__PURE__ */ jsx(TSDocAlias, { children: alias })
-			})
+		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 })
+				});
+			}
 		}),
-		/* @__PURE__ */ jsx(Show, {
-			when: isSetString(domain.value),
-			children: /* @__PURE__ */ jsx(TSDocDomain, { children: domain.value })
+		createComponent(Show, {
+			get when() {
+				return isSetString(domain.value);
+			},
+			get children() {
+				return createComponent(TSDocDomain, { get children() {
+					return domain.value;
+				} });
+			}
 		}),
-		/* @__PURE__ */ jsx(Show, {
-			when: !isUndefined(permission) && permission.length > 0 && permission.some((p) => isSetString(p?.trim())),
-			children: /* @__PURE__ */ jsx(For, {
-				each: permission?.filter((p) => isSetString(p?.trim())) ?? [],
-				children: (permission) => /* @__PURE__ */ jsx(TSDocPermission, { children: permission })
-			})
+		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 })
+				});
+			}
 		}),
-		/* @__PURE__ */ jsx(Show, {
+		createComponent(Show, {
 			when: readonly === true,
-			children: /* @__PURE__ */ jsx(TSDocReadonly, {})
+			get children() {
+				return createComponent(TSDocReadonly, {});
+			}
 		}),
-		/* @__PURE__ */ jsx(Show, {
+		createComponent(Show, {
 			when: internal === true,
-			children: /* @__PURE__ */ jsx(TSDocInternal, {})
+			get children() {
+				return createComponent(TSDocInternal, {});
+			}
 		}),
-		/* @__PURE__ */ jsx(Show, {
+		createComponent(Show, {
 			when: ignore === true,
-			children: /* @__PURE__ */ jsx(TSDocIgnore, {})
+			get children() {
+				return createComponent(TSDocIgnore, {});
+			}
 		}),
-		/* @__PURE__ */ jsx(Show, {
+		createComponent(Show, {
 			when: hidden === true,
-			children: /* @__PURE__ */ jsx(TSDocHidden, {})
+			get children() {
+				return createComponent(TSDocHidden, {});
+			}
 		}),
-		/* @__PURE__ */ jsx(Show, {
+		createComponent(Show, {
 			when: runtime === true,
-			children: /* @__PURE__ */ jsx(TSDocRuntime, {})
+			get children() {
+				return createComponent(TSDocRuntime, {});
+			}
 		}),
-		/* @__PURE__ */ jsx(Show, {
-			when: runtime !== true && !isUndefined(type) && !isUndefined(defaultValue),
-			children: /* @__PURE__ */ jsx(TSDocDefaultValue, {
-				type,
-				defaultValue
-			})
+		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 /* @__PURE__ */ jsxs(Fragment, { children: [
+	return [
 		"@param ",
-		/* @__PURE__ */ jsx(TSDocParamName, {
-			name: props.name,
-			optional: props.optional,
-			defaultValue: props.defaultValue
+		createComponent(TSDocParamName, {
+			get name() {
+				return props.name;
+			},
+			get optional() {
+				return props.optional;
+			},
+			get defaultValue() {
+				return props.defaultValue;
+			}
 		}),
-		/* @__PURE__ */ jsx(TSDocParamDescription, { children: props.children })
-	] });
+		createComponent(TSDocParamDescription, { get children() {
+			return props.children;
+		} })
+	];
 }
 function TSDocParamName(props) {
-	return /* @__PURE__ */ jsxs(Fragment, { children: [
-		/* @__PURE__ */ jsx(Show, {
-			when: props.optional,
+	return [
+		createComponent(Show, {
+			get when() {
+				return props.optional;
+			},
 			children: "["
 		}),
-		props.name,
-		/* @__PURE__ */ jsxs(Show, {
-			when: Boolean(props.defaultValue),
-			children: ["=", props.defaultValue]
+		memo(() => props.name),
+		createComponent(Show, {
+			get when() {
+				return Boolean(props.defaultValue);
+			},
+			get children() {
+				return ["=", memo(() => props.defaultValue)];
+			}
 		}),
-		/* @__PURE__ */ jsx(Show, {
-			when: props.optional,
+		createComponent(Show, {
+			get when() {
+				return props.optional;
+			},
 			children: "]"
 		})
-	] });
+	];
 }
 function TSDocParamDescription(props) {
-	return /* @__PURE__ */ jsxs(Show, {
-		when: Boolean(props.children),
-		children: [" - ", /* @__PURE__ */ jsx("align", {
-			width: 2,
-			children: /* @__PURE__ */ jsx(Prose, { children: props.children })
-		})]
+	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 /* @__PURE__ */ jsx(TSDocTag, {
-		...props,
-		tag: "returns"
-	});
+	return createComponent(TSDocTag, mergeProps(props, { tag: "returns" }));
 }
 /**
 * Create a TSDoc `@throws` tag.
 */
 function TSDocThrows(props) {
-	return /* @__PURE__ */ jsx(TSDocTag, {
-		...props,
-		tag: "throws"
-	});
+	return createComponent(TSDocTag, mergeProps(props, { tag: "throws" }));
 }
 /**
 * Generates a TSDoc `@module` tag for the given module name.
@@ -349,29 +438,37 @@ function TSDocModule(props) {
 		"prefix"
 	]);
 	const context = usePowerlinesSafe();
-	return /* @__PURE__ */ jsxs(Fragment, { children: [
+	return [
 		"/**",
-		/* @__PURE__ */ jsxs("align", {
+		createIntrinsic("align", {
 			string: " * ",
-			children: [
-				/* @__PURE__ */ jsx("hbr", {}),
-				/* @__PURE__ */ jsxs(Show, {
-					when: Boolean(children),
-					children: [/* @__PURE__ */ jsx(List, {
-						hardline: false,
-						softline: true,
-						children: childrenArray(() => children)
-					}), /* @__PURE__ */ jsx(Spacing, {})]
-				}),
-				"@module ",
-				prefix || context?.config?.framework || "powerlines",
-				":",
-				name
-			]
+			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
+				];
+			}
 		}),
-		/* @__PURE__ */ jsx("hbr", {}),
+		createIntrinsic("hbr", {}),
 		` */`
-	] });
+	];
 }
 
 //#endregion