@powerlines/plugin-alloy 0.26.26 → 0.26.27

package/dist/typescript/components/tsdoc-reflection.cjs

@@ -3,8 +3,8 @@ const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
 const require_core_contexts_reflection = require('../../core/contexts/reflection.cjs');
 const require_core_components_spacing = require('../../core/components/spacing.cjs');
 const require_typescript_components_tsdoc = require('./tsdoc.cjs');
-let _alloy_js_core = require("@alloy-js/core");
 let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
 let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
 let _stryke_type_checks_is_undefined = require("@stryke/type-checks/is-undefined");
 let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
@@ -35,42 +35,80 @@ function TSDocReflectionClass(props) {
 	const hidden = (0, _alloy_js_core.computed)(() => reflection.isHidden());
 	if (!computedHeading.value || (0, _stryke_type_checks_is_set_string.isSetString)(computedHeading.value) && computedHeading.value.trim() === "") return null;
 	const hasAttributes = (0, _alloy_js_core.computed)(() => (0, _stryke_type_checks_is_set_string.isSetString)(title.value) || !(0, _stryke_type_checks_is_undefined.isUndefined)(alias.value) && alias.value.length > 0 || !(0, _stryke_type_checks_is_undefined.isUndefined)(permission.value) && permission.value.length > 0 || (0, _stryke_type_checks_is_set_string.isSetString)(domain.value) || !(0, _stryke_type_checks_is_undefined.isUndefined)(readonly.value) || !(0, _stryke_type_checks_is_undefined.isUndefined)(internal.value) || !(0, _stryke_type_checks_is_undefined.isUndefined)(runtime.value) || !(0, _stryke_type_checks_is_undefined.isUndefined)(ignore.value) || !(0, _stryke_type_checks_is_undefined.isUndefined)(hidden.value));
-	return /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(require_typescript_components_tsdoc.TSDoc, {
-		...rest,
-		heading: (0, _stryke_type_checks_is_set_string.isSetString)(computedHeading.value) ? computedHeading.value.trim() : computedHeading.value,
-		children: [/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.Show, {
-			when: hasAttributes.value,
-			children: /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(require_typescript_components_tsdoc.TSDocAttributesTags, {
-				title: title.value,
-				alias: alias.value,
-				domain: domain.value,
-				permission: permission.value,
-				readonly: readonly.value,
-				internal: internal.value,
-				runtime: runtime.value,
-				ignore: ignore.value,
-				hidden: hidden.value
-			})
-		}), /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(_alloy_js_core.Show, {
-			when: !(0, _stryke_type_checks_is_undefined.isUndefined)(children) && (0, _alloy_js_core.childrenArray)(() => children).filter(Boolean).length > 0,
-			children: [/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.Show, {
-				when: hasAttributes.value,
-				children: /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(require_core_components_spacing.Spacing, {})
-			}), /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.List, { children: (0, _alloy_js_core.childrenArray)(() => children) })]
-		})]
-	});
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc.TSDoc, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
+		get heading() {
+			return (0, _alloy_js_core_jsx_runtime.memo)(() => !!(0, _stryke_type_checks_is_set_string.isSetString)(computedHeading.value))() ? computedHeading.value.trim() : computedHeading.value;
+		},
+		get children() {
+			return [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+				get when() {
+					return hasAttributes.value;
+				},
+				get children() {
+					return (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc.TSDocAttributesTags, {
+						get title() {
+							return title.value;
+						},
+						get alias() {
+							return alias.value;
+						},
+						get domain() {
+							return domain.value;
+						},
+						get permission() {
+							return permission.value;
+						},
+						get readonly() {
+							return readonly.value;
+						},
+						get internal() {
+							return internal.value;
+						},
+						get runtime() {
+							return runtime.value;
+						},
+						get ignore() {
+							return ignore.value;
+						},
+						get hidden() {
+							return hidden.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)(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 hasAttributes.value;
+						},
+						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);
+					} })];
+				}
+			})];
+		}
+	}));
 }
 /**
 * Uses the `useReflectionClass` hook to retrieve the reflection class from the context, and then renders a `TSDocReflectionClass` component with the retrieved reflection class. This is a convenience component that allows you to easily render a TSDoc documentation block for the current reflection class without having to manually retrieve the reflection class from the context.
 */
 function TSDocContextClass(props) {
 	const reflectionClass = require_core_contexts_reflection.useReflectionClass();
-	return /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.Show, {
-		when: (0, _stryke_type_checks.isSetObject)(reflectionClass.reflection),
-		children: /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(TSDocReflectionClass, {
-			...props,
-			reflection: reflectionClass.reflection
-		})
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+		get when() {
+			return (0, _stryke_type_checks.isSetObject)(reflectionClass.reflection);
+		},
+		get children() {
+			return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocReflectionClass, (0, _alloy_js_core_jsx_runtime.mergeProps)(props, { get reflection() {
+				return reflectionClass.reflection;
+			} }));
+		}
 	});
 }
 /**
@@ -84,45 +122,86 @@ function TSDocReflectionProperty(props) {
 	]);
 	if (!(0, _stryke_type_checks.isSetObject)(reflection)) return null;
 	const hasAttributes = (0, _alloy_js_core.computed)(() => (0, _stryke_type_checks_is_set_string.isSetString)(reflection.getTitle()) || !(0, _stryke_type_checks_is_undefined.isUndefined)(reflection.getAlias()) && reflection.getAlias().length > 0 || !(0, _stryke_type_checks_is_undefined.isUndefined)(reflection.getPermission()) && reflection.getPermission().length > 0 || (0, _stryke_type_checks_is_set_string.isSetString)(reflection.getDomain()) || !(0, _stryke_type_checks_is_undefined.isUndefined)(reflection.isReadonly()) || !(0, _stryke_type_checks_is_undefined.isUndefined)(reflection.isInternal()) || !(0, _stryke_type_checks_is_undefined.isUndefined)(reflection.isRuntime()) || !(0, _stryke_type_checks_is_undefined.isUndefined)(reflection.isIgnored()) || !(0, _stryke_type_checks_is_undefined.isUndefined)(reflection.isHidden()) || reflection.hasDefault() && !(0, _stryke_type_checks_is_undefined.isUndefined)(reflection.getDefaultValue()));
-	return /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(require_typescript_components_tsdoc.TSDoc, {
-		heading: reflection.getDescription(),
-		...rest,
-		children: [/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.Show, {
-			when: hasAttributes.value,
-			children: /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(require_typescript_components_tsdoc.TSDocAttributesTags, {
-				type: reflection,
-				title: reflection.getTitle(),
-				alias: reflection.getAlias(),
-				domain: reflection.getDomain(),
-				permission: reflection.getPermission(),
-				readonly: reflection.isReadonly(),
-				internal: reflection.isInternal(),
-				runtime: reflection.isRuntime(),
-				ignore: reflection.isIgnored(),
-				hidden: reflection.isHidden(),
-				defaultValue: defaultValue ?? reflection.getDefaultValue()
-			})
-		}), /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(_alloy_js_core.Show, {
-			when: !(0, _stryke_type_checks_is_undefined.isUndefined)(children) && (0, _alloy_js_core.childrenArray)(() => children).filter(Boolean).length > 0,
-			children: [/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.Show, {
-				when: hasAttributes.value,
-				children: /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(require_core_components_spacing.Spacing, {})
-			}), /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.List, { children: (0, _alloy_js_core.childrenArray)(() => children) })]
-		})]
-	});
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc.TSDoc, (0, _alloy_js_core_jsx_runtime.mergeProps)({ get heading() {
+		return reflection.getDescription();
+	} }, rest, { get children() {
+		return [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+			get when() {
+				return hasAttributes.value;
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc.TSDocAttributesTags, {
+					type: reflection,
+					get title() {
+						return reflection.getTitle();
+					},
+					get alias() {
+						return reflection.getAlias();
+					},
+					get domain() {
+						return reflection.getDomain();
+					},
+					get permission() {
+						return reflection.getPermission();
+					},
+					get readonly() {
+						return reflection.isReadonly();
+					},
+					get internal() {
+						return reflection.isInternal();
+					},
+					get runtime() {
+						return reflection.isRuntime();
+					},
+					get ignore() {
+						return reflection.isIgnored();
+					},
+					get hidden() {
+						return reflection.isHidden();
+					},
+					get defaultValue() {
+						return defaultValue ?? reflection.getDefaultValue();
+					}
+				});
+			}
+		}), (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 hasAttributes.value;
+					},
+					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);
+				} })];
+			}
+		})];
+	} }));
 }
 /**
 * Uses the `useReflectionProperty` hook to retrieve the reflection property from the context, and then renders a `TSDocReflectionProperty` component with the retrieved reflection property. This is a convenience component that allows you to easily render a TSDoc documentation block for the current reflection property without having to manually retrieve the reflection property from the context.
 */
 function TSDocContextProperty(props) {
 	const reflection = require_core_contexts_reflection.useReflectionPropertyContext();
-	return /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.Show, {
-		when: (0, _stryke_type_checks.isSetObject)(reflection),
-		children: /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(TSDocReflectionProperty, {
-			...props,
-			reflection: reflection.property,
-			defaultValue: reflection.defaultValue
-		})
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+		get when() {
+			return (0, _stryke_type_checks.isSetObject)(reflection);
+		},
+		get children() {
+			return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocReflectionProperty, (0, _alloy_js_core_jsx_runtime.mergeProps)(props, {
+				get reflection() {
+					return reflection.property;
+				},
+				get defaultValue() {
+					return reflection.defaultValue;
+				}
+			}));
+		}
 	});
 }
 /**
@@ -131,61 +210,115 @@ function TSDocContextProperty(props) {
 function TSDocReflectionMethod(props) {
 	const [{ children, reflection }, rest] = (0, _alloy_js_core.splitProps)(props, ["children", "reflection"]);
 	if (!(0, _stryke_type_checks.isSetObject)(reflection)) return null;
-	return /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(require_typescript_components_tsdoc.TSDoc, {
-		heading: (0, _alloy_js_core.computed)(() => reflection.getDescription() || ((0, _stryke_type_checks_is_string.isString)(reflection.getName()) ? _alloy_js_core.code`${String(reflection.getName())} method definition` : void 0)).value,
-		...rest,
-		children: [
-			/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(require_typescript_components_tsdoc.TSDocAttributesTags, {
-				title: reflection.getTitle(),
-				alias: reflection.getAlias(),
-				domain: reflection.getDomain(),
-				permission: reflection.getPermission(),
-				readonly: reflection.isReadonly(),
-				internal: reflection.isInternal(),
-				runtime: reflection.isRuntime(),
-				ignore: reflection.isIgnored(),
-				hidden: reflection.isHidden()
+	const heading = (0, _alloy_js_core.computed)(() => reflection.getDescription() || ((0, _stryke_type_checks_is_string.isString)(reflection.getName()) ? _alloy_js_core.code`${String(reflection.getName())} method definition` : void 0));
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc.TSDoc, (0, _alloy_js_core_jsx_runtime.mergeProps)({ get heading() {
+		return heading.value;
+	} }, rest, { get children() {
+		return [
+			(0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc.TSDocAttributesTags, {
+				get title() {
+					return reflection.getTitle();
+				},
+				get alias() {
+					return reflection.getAlias();
+				},
+				get domain() {
+					return reflection.getDomain();
+				},
+				get permission() {
+					return reflection.getPermission();
+				},
+				get readonly() {
+					return reflection.isReadonly();
+				},
+				get internal() {
+					return reflection.isInternal();
+				},
+				get runtime() {
+					return reflection.isRuntime();
+				},
+				get ignore() {
+					return reflection.isIgnored();
+				},
+				get hidden() {
+					return reflection.isHidden();
+				}
 			}),
-			/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.Show, {
-				when: Boolean(children) && (0, _alloy_js_core.childrenArray)(() => children).length > 0,
-				children: /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.List, { children: (0, _alloy_js_core.childrenArray)(() => children) })
+			(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+				get when() {
+					return (0, _alloy_js_core_jsx_runtime.memo)(() => !!Boolean(children))() && (0, _alloy_js_core.childrenArray)(() => children).length > 0;
+				},
+				get children() {
+					return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.List, { get children() {
+						return (0, _alloy_js_core.childrenArray)(() => children);
+					} });
+				}
 			}),
-			/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(_alloy_js_core.Show, {
-				when: reflection.getParameters().length > 0,
-				children: [/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(require_core_components_spacing.Spacing, {}), /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.For, {
-					each: reflection.getParameters(),
-					hardline: true,
-					ender: /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)("hbr", {}),
-					children: (param) => /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(require_typescript_components_tsdoc.TSDocParam, {
-						name: param.getName(),
-						optional: param.isOptional(),
-						defaultValue: param.hasDefault() ? param.getDefaultValue() : void 0,
-						children: /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.Show, {
-							when: Boolean(param.parameter.description),
-							fallback: _alloy_js_core.code`A parameter to provide a ${param.getName()} value to the function.`,
-							children: param.parameter.description
+			(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+				get when() {
+					return reflection.getParameters().length > 0;
+				},
+				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.For, {
+						get each() {
+							return reflection.getParameters();
+						},
+						hardline: true,
+						get ender() {
+							return (0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {});
+						},
+						children: (param) => (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc.TSDocParam, {
+							get name() {
+								return param.getName();
+							},
+							get optional() {
+								return param.isOptional();
+							},
+							get defaultValue() {
+								return (0, _alloy_js_core_jsx_runtime.memo)(() => !!param.hasDefault())() ? param.getDefaultValue() : void 0;
+							},
+							get children() {
+								return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+									get when() {
+										return Boolean(param.parameter.description);
+									},
+									get fallback() {
+										return _alloy_js_core.code`A parameter to provide a ${param.getName()} value to the function.`;
+									},
+									get children() {
+										return param.parameter.description;
+									}
+								});
+							}
 						})
-					})
-				})]
+					})];
+				}
 			}),
-			/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(_alloy_js_core.Show, {
-				when: reflection.getReturnType().kind !== _powerlines_deepkit_vendor_type.ReflectionKind.void,
-				children: [/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(require_core_components_spacing.Spacing, {}), /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(require_typescript_components_tsdoc.TSDocReturns, { children: _alloy_js_core.code`The return value of the function, which is of type ${(0, _powerlines_deepkit_vendor_type.stringifyType)(reflection.getReturnType())}.` })]
+			(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+				get when() {
+					return reflection.getReturnType().kind !== _powerlines_deepkit_vendor_type.ReflectionKind.void;
+				},
+				get children() {
+					return [(0, _alloy_js_core_jsx_runtime.createComponent)(require_core_components_spacing.Spacing, {}), (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc.TSDocReturns, { get children() {
+						return _alloy_js_core.code`The return value of the function, which is of type ${(0, _powerlines_deepkit_vendor_type.stringifyType)(reflection.getReturnType())}.`;
+					} })];
+				}
 			})
-		]
-	});
+		];
+	} }));
 }
 /**
 * Uses the `useReflectionMethod` hook to retrieve the reflection method from the context, and then renders a `TSDocReflectionMethod` component with the retrieved reflection method. This is a convenience component that allows you to easily render a TSDoc documentation block for the current reflection method without having to manually retrieve the reflection method from the context.
 */
 function TSDocContextMethod(props) {
 	const reflection = require_core_contexts_reflection.useReflectionMethod();
-	return /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.Show, {
-		when: (0, _stryke_type_checks.isSetObject)(reflection),
-		children: /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(TSDocReflectionMethod, {
-			...props,
-			reflection
-		})
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+		get when() {
+			return (0, _stryke_type_checks.isSetObject)(reflection);
+		},
+		get children() {
+			return (0, _alloy_js_core_jsx_runtime.createComponent)(TSDocReflectionMethod, (0, _alloy_js_core_jsx_runtime.mergeProps)(props, { reflection }));
+		}
 	});
 }