@powerlines/plugin-alloy 0.23.40 → 0.24.1

package/dist/typescript/components/tsdoc-reflection.d.cts

@@ -1,19 +1,44 @@
 import { TSDocProps } from "./tsdoc.cjs";
-import * as _alloy_js_core0 from "@alloy-js/core";
+import * as _alloy_js_core9 from "@alloy-js/core";
+import { ReflectionClass, ReflectionMethod, ReflectionProperty } from "@powerlines/deepkit/vendor/type";
 
 //#region src/typescript/components/tsdoc-reflection.d.ts
+interface TSDocReflectionClassProps<T extends Record<string, any> = Record<string, any>> extends TSDocProps {
+  reflection: ReflectionClass<T>;
+}
 /**
- * Generates a TypeScript interface property for the given reflection class.
+ * Generates a TSDoc documentation block for the given reflection class. This component will render the description of the reflection as the main content of the documentation block, and will render any additional attributes (such as title, alias, domain, permission, etc.) as tags in the documentation block. If there are child elements provided, they will be rendered as a list below the main content of the documentation block. This is useful for rendering additional details about the reflection that may not be included in the description, such as information about properties or methods of a class.
  */
-declare function TSDocReflectionClass<T extends Record<string, any> = Record<string, any>>(props: TSDocProps): _alloy_js_core0.Children;
+declare function TSDocReflectionClass<T extends Record<string, any> = Record<string, any>>(props: TSDocReflectionClassProps<T>): _alloy_js_core9.Children;
 /**
- * Generates a TypeScript interface property for the given reflection class.
+ * 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.
  */
-declare function TSDocReflectionProperty(props: TSDocProps): _alloy_js_core0.Children;
+declare function TSDocContextClass<T extends Record<string, any> = Record<string, any>>(props: TSDocProps): _alloy_js_core9.Children;
+interface TSDocReflectionPropertyProps extends TSDocProps {
+  reflection: ReflectionProperty;
+}
 /**
- * Generates a TypeScript interface property for the given reflection class.
+ * Generates a TSDoc documentation block for the given reflection property. This component will render the description of the reflection as the main content of the documentation block, and will render any additional attributes (such as title, alias, domain, permission, etc.) as tags in the documentation block. If there are child elements provided, they will be rendered as a list below the main content of the documentation block. This is useful for rendering additional details about the reflection that may not be included in the description, such as information about parameters of a method or properties of a class.
  */
-declare function TSDocReflectionMethod(props: TSDocProps): _alloy_js_core0.Children;
+declare function TSDocReflectionProperty(props: TSDocReflectionPropertyProps): _alloy_js_core9.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.
+ */
+declare function TSDocContextProperty(props: TSDocProps): _alloy_js_core9.Children;
+interface TSDocReflectionMethodProps extends TSDocProps {
+  reflection: ReflectionMethod;
+}
+/**
+ * Generates a TSDoc documentation block for the given reflection method. This component will render the description of the reflection as the main content of the documentation block, and will render any additional attributes (such as title, alias, domain, permission, etc.) as tags in the documentation block. If there are child elements provided, they will be rendered as a list below the main content of the documentation block. Additionally, this component will render information about the parameters and return type of the method, if available.
+ */
+declare function TSDocReflectionMethod(props: TSDocReflectionMethodProps): _alloy_js_core9.Children;
+/**
+ * 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.
+ */
+declare function TSDocContextMethod(props: TSDocProps): _alloy_js_core9.Children;
+declare type __ΩTSDocReflectionClassProps = any[];
+declare type __ΩTSDocReflectionPropertyProps = any[];
+declare type __ΩTSDocReflectionMethodProps = any[];
 //#endregion
-export { TSDocReflectionClass, TSDocReflectionMethod, TSDocReflectionProperty };
+export { TSDocContextClass, TSDocContextMethod, TSDocContextProperty, TSDocReflectionClass, TSDocReflectionClassProps, TSDocReflectionMethod, TSDocReflectionMethodProps, TSDocReflectionProperty, TSDocReflectionPropertyProps, __ΩTSDocReflectionClassProps, __ΩTSDocReflectionMethodProps, __ΩTSDocReflectionPropertyProps };
 //# sourceMappingURL=tsdoc-reflection.d.cts.map

package/dist/typescript/components/tsdoc-reflection.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"tsdoc-reflection.d.cts","names":[],"sources":["../../../src/typescript/components/tsdoc-reflection.tsx"],"sourcesContent":[],"mappings":";;;;;;;AAwCgB,iBAAA,oBAAoB,CAAA,UACxB,MADwB,CAAA,MAAA,EAAA,GAAA,CAAA,GACF,MADE,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,CAAA,KAAA,EAE3B,UAF2B,CAAA,EAEjB,eAAA,CAAA,QAFiB;;;;AAEjB,iBAyEH,uBAAA,CAzEG,KAAA,EAyE4B,UAzE5B,CAAA,EAyEsC,eAAA,CAAA,QAzEtC;;AAyEnB;AA8BA;iBAAgB,qBAAA,QAA6B,aAAU,eAAA,CAAA"}
+{"version":3,"file":"tsdoc-reflection.d.cts","names":[],"sources":["../../../src/typescript/components/tsdoc-reflection.tsx"],"sourcesContent":[],"mappings":";;;;;UAqDiB,oCACL,sBAAsB,6BACxB;cACI,gBAAgB;;AAH9B;;;AAG8B,iBAMd,oBANc,CAAA,UAOlB,MAPkB,CAAA,MAAA,EAAA,GAAA,CAAA,GAOI,MAPJ,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,CAAA,KAAA,EAQrB,yBARqB,CAQK,CARL,CAAA,CAAA,EAQI,eAAA,CAAG,QARP;;;;AAMd,iBAoFA,iBApFoB,CAAA,UAqFxB,MArFwB,CAAA,MAAA,EAAA,GAAA,CAAA,GAqFF,MArFE,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,CAAA,KAAA,EAsF3B,UAtF2B,CAAA,EAsFjB,eAAA,CAAA,QAtFiB;AACxB,UAkGK,4BAAA,SAAqC,UAlG1C,CAAA;EAAsB,UAAA,EAmGpB,kBAnGoB;;;;;AAmFlB,iBAsBA,uBAAA,CAtBiB,KAAA,EAsBc,4BAtBd,CAAA,EAsB0C,eAAA,CAAA,QAtB1C;;;;AAEd,iBA8EH,oBAAA,CA9EG,KAAA,EA8EyB,UA9EzB,CAAA,EA8EmC,eAAA,CAAA,QA9EnC;AAAA,UAwFF,0BAAA,SAAmC,UAxFjC,CAAA;EAaF,UAAA,EA4EH,gBA5EG;AAOjB;AA0DA;AAUA;AAOA;AAoEgB,iBApEA,qBAAA,CAoE0B,KAAU,EApEP,0BAoEO,CAAA,EApEmB,eAAA,CAAA,QAoEnB;;;;iBAApC,kBAAA,QAA0B,aAAU,eAAA,CAAA"}

package/dist/typescript/components/tsdoc-reflection.d.mts

@@ -1,19 +1,44 @@
 import { TSDocProps } from "./tsdoc.mjs";
 import * as _alloy_js_core11 from "@alloy-js/core";
+import { ReflectionClass, ReflectionMethod, ReflectionProperty } from "@powerlines/deepkit/vendor/type";
 
 //#region src/typescript/components/tsdoc-reflection.d.ts
+interface TSDocReflectionClassProps<T extends Record<string, any> = Record<string, any>> extends TSDocProps {
+  reflection: ReflectionClass<T>;
+}
 /**
- * Generates a TypeScript interface property for the given reflection class.
+ * Generates a TSDoc documentation block for the given reflection class. This component will render the description of the reflection as the main content of the documentation block, and will render any additional attributes (such as title, alias, domain, permission, etc.) as tags in the documentation block. If there are child elements provided, they will be rendered as a list below the main content of the documentation block. This is useful for rendering additional details about the reflection that may not be included in the description, such as information about properties or methods of a class.
  */
-declare function TSDocReflectionClass<T extends Record<string, any> = Record<string, any>>(props: TSDocProps): _alloy_js_core11.Children;
+declare function TSDocReflectionClass<T extends Record<string, any> = Record<string, any>>(props: TSDocReflectionClassProps<T>): _alloy_js_core11.Children;
 /**
- * Generates a TypeScript interface property for the given reflection class.
+ * 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.
  */
-declare function TSDocReflectionProperty(props: TSDocProps): _alloy_js_core11.Children;
+declare function TSDocContextClass<T extends Record<string, any> = Record<string, any>>(props: TSDocProps): _alloy_js_core11.Children;
+interface TSDocReflectionPropertyProps extends TSDocProps {
+  reflection: ReflectionProperty;
+}
 /**
- * Generates a TypeScript interface property for the given reflection class.
+ * Generates a TSDoc documentation block for the given reflection property. This component will render the description of the reflection as the main content of the documentation block, and will render any additional attributes (such as title, alias, domain, permission, etc.) as tags in the documentation block. If there are child elements provided, they will be rendered as a list below the main content of the documentation block. This is useful for rendering additional details about the reflection that may not be included in the description, such as information about parameters of a method or properties of a class.
  */
-declare function TSDocReflectionMethod(props: TSDocProps): _alloy_js_core11.Children;
+declare function TSDocReflectionProperty(props: TSDocReflectionPropertyProps): _alloy_js_core11.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.
+ */
+declare function TSDocContextProperty(props: TSDocProps): _alloy_js_core11.Children;
+interface TSDocReflectionMethodProps extends TSDocProps {
+  reflection: ReflectionMethod;
+}
+/**
+ * Generates a TSDoc documentation block for the given reflection method. This component will render the description of the reflection as the main content of the documentation block, and will render any additional attributes (such as title, alias, domain, permission, etc.) as tags in the documentation block. If there are child elements provided, they will be rendered as a list below the main content of the documentation block. Additionally, this component will render information about the parameters and return type of the method, if available.
+ */
+declare function TSDocReflectionMethod(props: TSDocReflectionMethodProps): _alloy_js_core11.Children;
+/**
+ * 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.
+ */
+declare function TSDocContextMethod(props: TSDocProps): _alloy_js_core11.Children;
+declare type __ΩTSDocReflectionClassProps = any[];
+declare type __ΩTSDocReflectionPropertyProps = any[];
+declare type __ΩTSDocReflectionMethodProps = any[];
 //#endregion
-export { TSDocReflectionClass, TSDocReflectionMethod, TSDocReflectionProperty };
+export { TSDocContextClass, TSDocContextMethod, TSDocContextProperty, TSDocReflectionClass, TSDocReflectionClassProps, TSDocReflectionMethod, TSDocReflectionMethodProps, TSDocReflectionProperty, TSDocReflectionPropertyProps, __ΩTSDocReflectionClassProps, __ΩTSDocReflectionMethodProps, __ΩTSDocReflectionPropertyProps };
 //# sourceMappingURL=tsdoc-reflection.d.mts.map

package/dist/typescript/components/tsdoc-reflection.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"tsdoc-reflection.d.mts","names":[],"sources":["../../../src/typescript/components/tsdoc-reflection.tsx"],"sourcesContent":[],"mappings":";;;;;;;AAwCgB,iBAAA,oBAAoB,CAAA,UACxB,MADwB,CAAA,MAAA,EAAA,GAAA,CAAA,GACF,MADE,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,CAAA,KAAA,EAE3B,UAF2B,CAAA,EAEjB,gBAAA,CAAA,QAFiB;;;;AAEjB,iBAyEH,uBAAA,CAzEG,KAAA,EAyE4B,UAzE5B,CAAA,EAyEsC,gBAAA,CAAA,QAzEtC;;AAyEnB;AA8BA;iBAAgB,qBAAA,QAA6B,aAAU,gBAAA,CAAA"}
+{"version":3,"file":"tsdoc-reflection.d.mts","names":[],"sources":["../../../src/typescript/components/tsdoc-reflection.tsx"],"sourcesContent":[],"mappings":";;;;;UAqDiB,oCACL,sBAAsB,6BACxB;cACI,gBAAgB;;AAH9B;;;AAG8B,iBAMd,oBANc,CAAA,UAOlB,MAPkB,CAAA,MAAA,EAAA,GAAA,CAAA,GAOI,MAPJ,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,CAAA,KAAA,EAQrB,yBARqB,CAQK,CARL,CAAA,CAAA,EAQI,gBAAA,CAAG,QARP;;;;AAMd,iBAoFA,iBApFoB,CAAA,UAqFxB,MArFwB,CAAA,MAAA,EAAA,GAAA,CAAA,GAqFF,MArFE,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,CAAA,KAAA,EAsF3B,UAtF2B,CAAA,EAsFjB,gBAAA,CAAA,QAtFiB;AACxB,UAkGK,4BAAA,SAAqC,UAlG1C,CAAA;EAAsB,UAAA,EAmGpB,kBAnGoB;;;;;AAmFlB,iBAsBA,uBAAA,CAtBiB,KAAA,EAsBc,4BAtBd,CAAA,EAsB0C,gBAAA,CAAA,QAtB1C;;;;AAEd,iBA8EH,oBAAA,CA9EG,KAAA,EA8EyB,UA9EzB,CAAA,EA8EmC,gBAAA,CAAA,QA9EnC;AAAA,UAwFF,0BAAA,SAAmC,UAxFjC,CAAA;EAaF,UAAA,EA4EH,gBA5EG;AAOjB;AA0DA;AAUA;AAOA;AAoEgB,iBApEA,qBAAA,CAoE0B,KAAU,EApEP,0BAoEO,CAAA,EApEmB,gBAAA,CAAA,QAoEnB;;;;iBAApC,kBAAA,QAA0B,aAAU,gBAAA,CAAA"}

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

@@ -1,29 +1,37 @@
 import { useReflectionClass, useReflectionMethod, useReflectionProperty } from "../../core/contexts/reflection.mjs";
-import { TSDoc, TSDocAttributesTags } from "./tsdoc.mjs";
-import { createComponent, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
-import { List, Show, childrenArray, code, computed, splitProps } from "@alloy-js/core";
+import { Spacing } from "../../core/components/spacing.mjs";
+import { TSDoc, TSDocAttributesTags, TSDocParam, TSDocReturns } from "./tsdoc.mjs";
+import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { For, List, Show, childrenArray, code, computed, splitProps } from "@alloy-js/core";
 import { titleCase } from "@stryke/string-format/title-case";
 import { isUndefined } from "@stryke/type-checks/is-undefined";
+import { ReflectionKind, stringifyType } from "@powerlines/deepkit/vendor/type";
 import { isString } from "@stryke/type-checks/is-string";
+import { isSetObject } from "@stryke/type-checks";
 import { isSetString } from "@stryke/type-checks/is-set-string";
 
 //#region src/typescript/components/tsdoc-reflection.tsx
 /**
-* Generates a TypeScript interface property for the given reflection class.
+* Generates a TSDoc documentation block for the given reflection class. This component will render the description of the reflection as the main content of the documentation block, and will render any additional attributes (such as title, alias, domain, permission, etc.) as tags in the documentation block. If there are child elements provided, they will be rendered as a list below the main content of the documentation block. This is useful for rendering additional details about the reflection that may not be included in the description, such as information about properties or methods of a class.
 */
 function TSDocReflectionClass(props) {
-	const [{ children, heading }, rest] = splitProps(props, ["heading", "children"]);
-	const reflectionClass = useReflectionClass();
-	const title = computed(() => reflectionClass.reflection.getTitle() || titleCase(reflectionClass.reflection.getName()));
-	const computedHeading = computed(() => heading || reflectionClass.reflection.getDescription() || title.value);
-	const alias = computed(() => reflectionClass.reflection.getAlias());
-	const domain = computed(() => reflectionClass.reflection.getDomain());
-	const permission = computed(() => reflectionClass.reflection.getPermission());
-	const readonly = computed(() => reflectionClass.reflection.isReadonly());
-	const internal = computed(() => reflectionClass.reflection.isInternal());
-	const ignore = computed(() => reflectionClass.reflection.isIgnored());
-	const hidden = computed(() => reflectionClass.reflection.isHidden());
+	const [{ children, heading, reflection }, rest] = splitProps(props, [
+		"heading",
+		"children",
+		"reflection"
+	]);
+	if (!isSetObject(reflection)) return null;
+	const title = computed(() => reflection.getTitle() || titleCase(reflection.getName()));
+	const computedHeading = computed(() => heading || reflection.getDescription() || title.value);
+	const alias = computed(() => reflection.getAlias());
+	const domain = computed(() => reflection.getDomain());
+	const permission = computed(() => reflection.getPermission());
+	const readonly = computed(() => reflection.isReadonly());
+	const internal = computed(() => reflection.isInternal());
+	const ignore = computed(() => reflection.isIgnored());
+	const hidden = computed(() => reflection.isHidden());
 	if (!computedHeading.value || isSetString(computedHeading.value) && computedHeading.value.trim() === "") return null;
+	const hasAttributes = computed(() => isSetString(title.value) || !isUndefined(alias.value) && alias.value.length > 0 || !isUndefined(permission.value) && permission.value.length > 0 || isSetString(domain.value) || !isUndefined(readonly.value) || !isUndefined(internal.value) || !isUndefined(ignore.value) || !isUndefined(hidden.value));
 	return createComponent(TSDoc, mergeProps(rest, {
 		get heading() {
 			return memo(() => !!isSetString(computedHeading.value))() ? computedHeading.value.trim() : computedHeading.value;
@@ -31,7 +39,7 @@ function TSDocReflectionClass(props) {
 		get children() {
 			return [createComponent(Show, {
 				get when() {
-					return isSetString(title.value) || !isUndefined(alias.value) && alias.value.length > 0 || !isUndefined(permission.value) && permission.value.length > 0 || isSetString(domain.value) || !isUndefined(readonly.value) || !isUndefined(internal.value) || !isUndefined(ignore.value) || !isUndefined(hidden.value);
+					return hasAttributes.value;
 				},
 				get children() {
 					return createComponent(TSDocAttributesTags, {
@@ -63,114 +71,234 @@ function TSDocReflectionClass(props) {
 				}
 			}), createComponent(Show, {
 				get when() {
-					return memo(() => !!Boolean(children))() && childrenArray(() => children).length > 0;
+					return memo(() => !!!isUndefined(children))() && childrenArray(() => children).filter(Boolean).length > 0;
 				},
 				get children() {
-					return createComponent(List, { get children() {
+					return [createComponent(Show, {
+						get when() {
+							return hasAttributes.value;
+						},
+						get children() {
+							return createComponent(Spacing, {});
+						}
+					}), createComponent(List, { get children() {
 						return childrenArray(() => children);
-					} });
+					} })];
 				}
 			})];
 		}
 	}));
 }
 /**
-* Generates a TypeScript interface property for the given reflection class.
+* 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 = useReflectionClass();
+	return createComponent(Show, {
+		get when() {
+			return isSetObject(reflectionClass.reflection);
+		},
+		get children() {
+			return createComponent(TSDocReflectionClass, mergeProps(props, { get reflection() {
+				return reflectionClass.reflection;
+			} }));
+		}
+	});
+}
+/**
+* Generates a TSDoc documentation block for the given reflection property. This component will render the description of the reflection as the main content of the documentation block, and will render any additional attributes (such as title, alias, domain, permission, etc.) as tags in the documentation block. If there are child elements provided, they will be rendered as a list below the main content of the documentation block. This is useful for rendering additional details about the reflection that may not be included in the description, such as information about parameters of a method or properties of a class.
 */
 function TSDocReflectionProperty(props) {
-	const [{ children }, rest] = splitProps(props, ["children"]);
-	const context = useReflectionProperty();
+	const [{ children, reflection }, rest] = splitProps(props, ["children", "reflection"]);
+	if (!isSetObject(reflection)) return null;
+	const hasAttributes = computed(() => isSetString(reflection.getTitle()) || !isUndefined(reflection.getAlias()) && reflection.getAlias().length > 0 || !isUndefined(reflection.getPermission()) && reflection.getPermission().length > 0 || isSetString(reflection.getDomain()) || !isUndefined(reflection.isReadonly()) || !isUndefined(reflection.isInternal()) || !isUndefined(reflection.isIgnored()) || !isUndefined(reflection.isHidden()) || reflection.hasDefault() && !isUndefined(reflection.getDefaultValue()));
 	return createComponent(TSDoc, mergeProps({ get heading() {
-		return context.getDescription();
+		return reflection.getDescription();
 	} }, rest, { get children() {
-		return [createComponent(TSDocAttributesTags, {
-			type: context,
-			get title() {
-				return context.getTitle();
-			},
-			get alias() {
-				return context.getAlias();
-			},
-			get domain() {
-				return context.getDomain();
-			},
-			get permission() {
-				return context.getPermission();
-			},
-			get readonly() {
-				return context.isReadonly();
-			},
-			get internal() {
-				return context.isInternal();
-			},
-			get ignore() {
-				return context.isIgnored();
-			},
-			get hidden() {
-				return context.isHidden();
+		return [createComponent(Show, {
+			get when() {
+				return hasAttributes.value;
 			},
-			get defaultValue() {
-				return context.getDefaultValue();
+			get children() {
+				return createComponent(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 ignore() {
+						return reflection.isIgnored();
+					},
+					get hidden() {
+						return reflection.isHidden();
+					},
+					get defaultValue() {
+						return reflection.getDefaultValue();
+					}
+				});
 			}
 		}), createComponent(Show, {
 			get when() {
-				return memo(() => !!Boolean(children))() && childrenArray(() => children).length > 0;
+				return memo(() => !!!isUndefined(children))() && childrenArray(() => children).filter(Boolean).length > 0;
 			},
 			get children() {
-				return createComponent(List, { get children() {
+				return [createComponent(Show, {
+					get when() {
+						return hasAttributes.value;
+					},
+					get children() {
+						return createComponent(Spacing, {});
+					}
+				}), createComponent(List, { get children() {
 					return childrenArray(() => children);
-				} });
+				} })];
 			}
 		})];
 	} }));
 }
 /**
-* Generates a TypeScript interface property for the given reflection class.
+* 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 = useReflectionProperty();
+	return createComponent(Show, {
+		get when() {
+			return isSetObject(reflection);
+		},
+		get children() {
+			return createComponent(TSDocReflectionProperty, mergeProps(props, { reflection }));
+		}
+	});
+}
+/**
+* Generates a TSDoc documentation block for the given reflection method. This component will render the description of the reflection as the main content of the documentation block, and will render any additional attributes (such as title, alias, domain, permission, etc.) as tags in the documentation block. If there are child elements provided, they will be rendered as a list below the main content of the documentation block. Additionally, this component will render information about the parameters and return type of the method, if available.
 */
 function TSDocReflectionMethod(props) {
-	const [{ children }, rest] = splitProps(props, ["children"]);
-	const context = useReflectionMethod();
+	const [{ children, reflection }, rest] = splitProps(props, ["children", "reflection"]);
+	if (!isSetObject(reflection)) return null;
+	const heading = computed(() => reflection.getDescription() || (isString(reflection.getName()) ? code`${String(reflection.getName())} method definition` : void 0));
 	return createComponent(TSDoc, mergeProps({ get heading() {
-		return context.getDescription() || (isString(context.getName()) ? code`${String(context.getName())} method definition` : void 0);
+		return heading.value;
 	} }, rest, { get children() {
-		return [createComponent(TSDocAttributesTags, {
-			get title() {
-				return context.getTitle();
-			},
-			get alias() {
-				return context.getAlias();
-			},
-			get domain() {
-				return context.getDomain();
-			},
-			get permission() {
-				return context.getPermission();
-			},
-			get readonly() {
-				return context.isReadonly();
-			},
-			get internal() {
-				return context.isInternal();
-			},
-			get ignore() {
-				return context.isIgnored();
-			},
-			get hidden() {
-				return context.isHidden();
-			}
-		}), createComponent(Show, {
-			get when() {
-				return memo(() => !!Boolean(children))() && childrenArray(() => children).length > 0;
-			},
-			get children() {
-				return createComponent(List, { get children() {
-					return childrenArray(() => children);
-				} });
-			}
-		})];
+		return [
+			createComponent(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 ignore() {
+					return reflection.isIgnored();
+				},
+				get hidden() {
+					return reflection.isHidden();
+				}
+			}),
+			createComponent(Show, {
+				get when() {
+					return memo(() => !!Boolean(children))() && childrenArray(() => children).length > 0;
+				},
+				get children() {
+					return createComponent(List, { get children() {
+						return childrenArray(() => children);
+					} });
+				}
+			}),
+			createComponent(Show, {
+				get when() {
+					return reflection.getParameters().length > 0;
+				},
+				get children() {
+					return [createComponent(Spacing, {}), createComponent(For, {
+						get each() {
+							return reflection.getParameters();
+						},
+						hardline: true,
+						get ender() {
+							return createIntrinsic("hbr", {});
+						},
+						children: (param) => createComponent(TSDocParam, {
+							get name() {
+								return param.getName();
+							},
+							get optional() {
+								return param.isOptional();
+							},
+							get defaultValue() {
+								return memo(() => !!param.hasDefault())() ? param.getDefaultValue() : void 0;
+							},
+							get children() {
+								return createComponent(Show, {
+									get when() {
+										return Boolean(param.parameter.description);
+									},
+									get fallback() {
+										return code`A parameter to provide a ${param.getName()} value to the function.`;
+									},
+									get children() {
+										return param.parameter.description;
+									}
+								});
+							}
+						})
+					})];
+				}
+			}),
+			createComponent(Show, {
+				get when() {
+					return reflection.getReturnType().kind !== ReflectionKind.void;
+				},
+				get children() {
+					return [createComponent(Spacing, {}), createComponent(TSDocReturns, { get children() {
+						return code`The return value of the function, which is of 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 = useReflectionMethod();
+	return createComponent(Show, {
+		get when() {
+			return isSetObject(reflection);
+		},
+		get children() {
+			return createComponent(TSDocReflectionMethod, mergeProps(props, { reflection }));
+		}
+	});
+}
 
 //#endregion
-export { TSDocReflectionClass, TSDocReflectionMethod, TSDocReflectionProperty };
+export { TSDocContextClass, TSDocContextMethod, TSDocContextProperty, TSDocReflectionClass, TSDocReflectionMethod, TSDocReflectionProperty };
 //# sourceMappingURL=tsdoc-reflection.mjs.map

package/dist/typescript/components/tsdoc-reflection.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tsdoc-reflection.mjs","names":["childrenArray","code","computed","List","Show","splitProps","titleCase","isSetString","isString","isUndefined","useReflectionClass","useReflectionMethod","useReflectionProperty","TSDoc","TSDocAttributesTags","TSDocReflectionClass","props","children","heading","rest","reflectionClass","title","reflection","getTitle","getName","computedHeading","getDescription","value","alias","getAlias","domain","getDomain","permission","getPermission","readonly","isReadonly","internal","isInternal","ignore","isIgnored","hidden","isHidden","trim","_$createComponent","_$mergeProps","_$memo","when","length","Boolean","TSDocReflectionProperty","context","type","defaultValue","getDefaultValue","TSDocReflectionMethod","String","undefined"],"sources":["../../../src/typescript/components/tsdoc-reflection.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  childrenArray,\n  code,\n  computed,\n  List,\n  Show,\n  splitProps\n} from \"@alloy-js/core\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { isUndefined } from \"@stryke/type-checks/is-undefined\";\nimport {\n  useReflectionClass,\n  useReflectionMethod,\n  useReflectionProperty\n} from \"../../core/contexts/reflection\";\nimport { TSDoc, TSDocAttributesTags, TSDocProps } from \"./tsdoc\";\n\n/**\n * Generates a TypeScript interface property for the given reflection class.\n */\nexport function TSDocReflectionClass<\n  T extends Record<string, any> = Record<string, any>\n>(props: TSDocProps) {\n  const [{ children, heading }, rest] = splitProps(props, [\n    \"heading\",\n    \"children\"\n  ]);\n\n  const reflectionClass = useReflectionClass<T>();\n\n  const title = computed(\n    () =>\n      reflectionClass.reflection.getTitle() ||\n      titleCase(reflectionClass.reflection.getName())\n  );\n  const computedHeading = computed(\n    () => heading || reflectionClass.reflection.getDescription() || title.value\n  );\n\n  const alias = computed(() => reflectionClass.reflection.getAlias());\n  const domain = computed(() => reflectionClass.reflection.getDomain());\n  const permission = computed(() => reflectionClass.reflection.getPermission());\n  const readonly = computed(() => reflectionClass.reflection.isReadonly());\n  const internal = computed(() => reflectionClass.reflection.isInternal());\n  const ignore = computed(() => reflectionClass.reflection.isIgnored());\n  const hidden = computed(() => reflectionClass.reflection.isHidden());\n\n  if (\n    !computedHeading.value ||\n    (isSetString(computedHeading.value) && computedHeading.value.trim() === \"\")\n  ) {\n    return null;\n  }\n\n  return (\n    <TSDoc\n      {...rest}\n      heading={\n        isSetString(computedHeading.value)\n          ? computedHeading.value.trim()\n          : computedHeading.value\n      }>\n      <Show\n        when={\n          isSetString(title.value) ||\n          (!isUndefined(alias.value) && alias.value.length > 0) ||\n          (!isUndefined(permission.value) && permission.value.length > 0) ||\n          isSetString(domain.value) ||\n          !isUndefined(readonly.value) ||\n          !isUndefined(internal.value) ||\n          !isUndefined(ignore.value) ||\n          !isUndefined(hidden.value)\n        }>\n        <TSDocAttributesTags\n          title={title.value}\n          alias={alias.value}\n          domain={domain.value}\n          permission={permission.value}\n          readonly={readonly.value}\n          internal={internal.value}\n          ignore={ignore.value}\n          hidden={hidden.value}\n        />\n      </Show>\n      <Show\n        when={Boolean(children) && childrenArray(() => children).length > 0}>\n        <List>{childrenArray(() => children)}</List>\n      </Show>\n    </TSDoc>\n  );\n}\n\n/**\n * Generates a TypeScript interface property for the given reflection class.\n */\nexport function TSDocReflectionProperty(props: TSDocProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  const context = useReflectionProperty();\n\n  return (\n    <TSDoc heading={context.getDescription()} {...rest}>\n      <TSDocAttributesTags\n        type={context}\n        title={context.getTitle()}\n        alias={context.getAlias()}\n        domain={context.getDomain()}\n        permission={context.getPermission()}\n        readonly={context.isReadonly()}\n        internal={context.isInternal()}\n        ignore={context.isIgnored()}\n        hidden={context.isHidden()}\n        defaultValue={context.getDefaultValue()}\n      />\n      <Show\n        when={Boolean(children) && childrenArray(() => children).length > 0}>\n        <List>{childrenArray(() => children)}</List>\n      </Show>\n    </TSDoc>\n  );\n}\n\n/**\n * Generates a TypeScript interface property for the given reflection class.\n */\nexport function TSDocReflectionMethod(props: TSDocProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  const context = useReflectionMethod();\n\n  return (\n    <TSDoc\n      heading={\n        context.getDescription() ||\n        (isString(context.getName())\n          ? code`${String(context.getName())} method definition`\n          : undefined)\n      }\n      {...rest}>\n      <TSDocAttributesTags\n        title={context.getTitle()}\n        alias={context.getAlias()}\n        domain={context.getDomain()}\n        permission={context.getPermission()}\n        readonly={context.isReadonly()}\n        internal={context.isInternal()}\n        ignore={context.isIgnored()}\n        hidden={context.isHidden()}\n      />\n      <Show\n        when={Boolean(children) && childrenArray(() => children).length > 0}>\n        <List>{childrenArray(() => children)}</List>\n      </Show>\n    </TSDoc>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"tsdoc-reflection.mjs","names":["childrenArray","code","computed","For","List","Show","splitProps","ReflectionKind","stringifyType","titleCase","isSetObject","isSetString","isString","isUndefined","Spacing","useReflectionClass","useReflectionMethod","useReflectionProperty","TSDoc","TSDocAttributesTags","TSDocParam","TSDocReturns","TSDocReflectionClass","props","children","heading","reflection","rest","title","getTitle","getName","computedHeading","getDescription","value","alias","getAlias","domain","getDomain","permission","getPermission","readonly","isReadonly","internal","isInternal","ignore","isIgnored","hidden","isHidden","trim","hasAttributes","length","_$createComponent","_$mergeProps","_$memo","when","filter","Boolean","TSDocContextClass","reflectionClass","TSDocReflectionProperty","hasDefault","getDefaultValue","type","defaultValue","TSDocContextProperty","TSDocReflectionMethod","String","undefined","getParameters","each","hardline","ender","_$createIntrinsic","param","name","optional","isOptional","parameter","description","fallback","getReturnType","kind","void","TSDocContextMethod"],"sources":["../../../src/typescript/components/tsdoc-reflection.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  childrenArray,\n  code,\n  computed,\n  For,\n  List,\n  Show,\n  splitProps\n} from \"@alloy-js/core\";\nimport {\n  ReflectionClass,\n  ReflectionKind,\n  ReflectionMethod,\n  ReflectionProperty,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { isUndefined } from \"@stryke/type-checks/is-undefined\";\nimport { Spacing } from \"../../core/components/spacing\";\nimport {\n  useReflectionClass,\n  useReflectionMethod,\n  useReflectionProperty\n} from \"../../core/contexts/reflection\";\nimport {\n  TSDoc,\n  TSDocAttributesTags,\n  TSDocParam,\n  TSDocProps,\n  TSDocReturns\n} from \"./tsdoc\";\n\nexport interface TSDocReflectionClassProps<\n  T extends Record<string, any> = Record<string, any>\n> extends TSDocProps {\n  reflection: ReflectionClass<T>;\n}\n\n/**\n * Generates a TSDoc documentation block for the given reflection class. This component will render the description of the reflection as the main content of the documentation block, and will render any additional attributes (such as title, alias, domain, permission, etc.) as tags in the documentation block. If there are child elements provided, they will be rendered as a list below the main content of the documentation block. This is useful for rendering additional details about the reflection that may not be included in the description, such as information about properties or methods of a class.\n */\nexport function TSDocReflectionClass<\n  T extends Record<string, any> = Record<string, any>\n>(props: TSDocReflectionClassProps<T>) {\n  const [{ children, heading, reflection }, rest] = splitProps(props, [\n    \"heading\",\n    \"children\",\n    \"reflection\"\n  ]);\n\n  if (!isSetObject(reflection)) {\n    return null;\n  }\n\n  const title = computed(\n    () => reflection.getTitle() || titleCase(reflection.getName())\n  );\n  const computedHeading = computed(\n    () => heading || reflection.getDescription() || title.value\n  );\n\n  const alias = computed(() => reflection.getAlias());\n  const domain = computed(() => reflection.getDomain());\n  const permission = computed(() => reflection.getPermission());\n  const readonly = computed(() => reflection.isReadonly());\n  const internal = computed(() => reflection.isInternal());\n  const ignore = computed(() => reflection.isIgnored());\n  const hidden = computed(() => reflection.isHidden());\n\n  if (\n    !computedHeading.value ||\n    (isSetString(computedHeading.value) && computedHeading.value.trim() === \"\")\n  ) {\n    return null;\n  }\n\n  const hasAttributes = computed(\n    () =>\n      isSetString(title.value) ||\n      (!isUndefined(alias.value) && alias.value.length > 0) ||\n      (!isUndefined(permission.value) && permission.value.length > 0) ||\n      isSetString(domain.value) ||\n      !isUndefined(readonly.value) ||\n      !isUndefined(internal.value) ||\n      !isUndefined(ignore.value) ||\n      !isUndefined(hidden.value)\n  );\n\n  return (\n    <TSDoc\n      {...rest}\n      heading={\n        isSetString(computedHeading.value)\n          ? computedHeading.value.trim()\n          : computedHeading.value\n      }>\n      <Show when={hasAttributes.value}>\n        <TSDocAttributesTags\n          title={title.value}\n          alias={alias.value}\n          domain={domain.value}\n          permission={permission.value}\n          readonly={readonly.value}\n          internal={internal.value}\n          ignore={ignore.value}\n          hidden={hidden.value}\n        />\n      </Show>\n      <Show\n        when={\n          !isUndefined(children) &&\n          childrenArray(() => children).filter(Boolean).length > 0\n        }>\n        <Show when={hasAttributes.value}>\n          <Spacing />\n        </Show>\n        <List>{childrenArray(() => children)}</List>\n      </Show>\n    </TSDoc>\n  );\n}\n\n/**\n * 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.\n */\nexport function TSDocContextClass<\n  T extends Record<string, any> = Record<string, any>\n>(props: TSDocProps) {\n  const reflectionClass = useReflectionClass<T>();\n\n  return (\n    <Show when={isSetObject(reflectionClass.reflection)}>\n      <TSDocReflectionClass\n        {...props}\n        reflection={reflectionClass.reflection}\n      />\n    </Show>\n  );\n}\n\nexport interface TSDocReflectionPropertyProps extends TSDocProps {\n  reflection: ReflectionProperty;\n}\n\n/**\n * Generates a TSDoc documentation block for the given reflection property. This component will render the description of the reflection as the main content of the documentation block, and will render any additional attributes (such as title, alias, domain, permission, etc.) as tags in the documentation block. If there are child elements provided, they will be rendered as a list below the main content of the documentation block. This is useful for rendering additional details about the reflection that may not be included in the description, such as information about parameters of a method or properties of a class.\n */\nexport function TSDocReflectionProperty(props: TSDocReflectionPropertyProps) {\n  const [{ children, reflection }, rest] = splitProps(props, [\n    \"children\",\n    \"reflection\"\n  ]);\n\n  if (!isSetObject(reflection)) {\n    return null;\n  }\n\n  const hasAttributes = computed(\n    () =>\n      isSetString(reflection.getTitle()) ||\n      (!isUndefined(reflection.getAlias()) &&\n        reflection.getAlias().length > 0) ||\n      (!isUndefined(reflection.getPermission()) &&\n        reflection.getPermission().length > 0) ||\n      isSetString(reflection.getDomain()) ||\n      !isUndefined(reflection.isReadonly()) ||\n      !isUndefined(reflection.isInternal()) ||\n      !isUndefined(reflection.isIgnored()) ||\n      !isUndefined(reflection.isHidden()) ||\n      (reflection.hasDefault() && !isUndefined(reflection.getDefaultValue()))\n  );\n\n  return (\n    <TSDoc heading={reflection.getDescription()} {...rest}>\n      <Show when={hasAttributes.value}>\n        <TSDocAttributesTags\n          type={reflection}\n          title={reflection.getTitle()}\n          alias={reflection.getAlias()}\n          domain={reflection.getDomain()}\n          permission={reflection.getPermission()}\n          readonly={reflection.isReadonly()}\n          internal={reflection.isInternal()}\n          ignore={reflection.isIgnored()}\n          hidden={reflection.isHidden()}\n          defaultValue={reflection.getDefaultValue()}\n        />\n      </Show>\n      <Show\n        when={\n          !isUndefined(children) &&\n          childrenArray(() => children).filter(Boolean).length > 0\n        }>\n        <Show when={hasAttributes.value}>\n          <Spacing />\n        </Show>\n        <List>{childrenArray(() => children)}</List>\n      </Show>\n    </TSDoc>\n  );\n}\n\n/**\n * 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.\n */\nexport function TSDocContextProperty(props: TSDocProps) {\n  const reflection = useReflectionProperty();\n\n  return (\n    <Show when={isSetObject(reflection)}>\n      <TSDocReflectionProperty {...props} reflection={reflection} />\n    </Show>\n  );\n}\n\nexport interface TSDocReflectionMethodProps extends TSDocProps {\n  reflection: ReflectionMethod;\n}\n\n/**\n * Generates a TSDoc documentation block for the given reflection method. This component will render the description of the reflection as the main content of the documentation block, and will render any additional attributes (such as title, alias, domain, permission, etc.) as tags in the documentation block. If there are child elements provided, they will be rendered as a list below the main content of the documentation block. Additionally, this component will render information about the parameters and return type of the method, if available.\n */\nexport function TSDocReflectionMethod(props: TSDocReflectionMethodProps) {\n  const [{ children, reflection }, rest] = splitProps(props, [\n    \"children\",\n    \"reflection\"\n  ]);\n\n  if (!isSetObject(reflection)) {\n    return null;\n  }\n\n  const heading = computed(\n    () =>\n      reflection.getDescription() ||\n      (isString(reflection.getName())\n        ? code`${String(reflection.getName())} method definition`\n        : undefined)\n  );\n\n  return (\n    <TSDoc heading={heading.value} {...rest}>\n      <TSDocAttributesTags\n        title={reflection.getTitle()}\n        alias={reflection.getAlias()}\n        domain={reflection.getDomain()}\n        permission={reflection.getPermission()}\n        readonly={reflection.isReadonly()}\n        internal={reflection.isInternal()}\n        ignore={reflection.isIgnored()}\n        hidden={reflection.isHidden()}\n      />\n      <Show\n        when={Boolean(children) && childrenArray(() => children).length > 0}>\n        <List>{childrenArray(() => children)}</List>\n      </Show>\n      <Show when={reflection.getParameters().length > 0}>\n        <Spacing />\n        <For each={reflection.getParameters()} hardline ender={<hbr />}>\n          {param => (\n            <TSDocParam\n              name={param.getName()}\n              optional={param.isOptional()}\n              defaultValue={\n                param.hasDefault() ? param.getDefaultValue() : undefined\n              }>\n              <Show\n                when={Boolean(param.parameter.description)}\n                fallback={code`A parameter to provide a ${param.getName()} value to the function.`}>\n                {param.parameter.description}\n              </Show>\n            </TSDocParam>\n          )}\n        </For>\n      </Show>\n      <Show when={reflection.getReturnType().kind !== ReflectionKind.void}>\n        <Spacing />\n        <TSDocReturns>\n          {code`The return value of the function, which is of type ${stringifyType(\n            reflection.getReturnType()\n          )}.`}\n        </TSDocReturns>\n      </Show>\n    </TSDoc>\n  );\n}\n\n/**\n * 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.\n */\nexport function TSDocContextMethod(props: TSDocProps) {\n  const reflection = useReflectionMethod();\n\n  return (\n    <Show when={isSetObject(reflection)}>\n      <TSDocReflectionMethod {...props} reflection={reflection} />\n    </Show>\n  );\n}\n"],"mappings":"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"}

package/dist/typescript/components/tsdoc.cjs

@@ -239,25 +239,27 @@ function TSDocHidden() {
 * Generates a TypeScript interface property for the given reflection class.
 */
 function TSDocAttributesTags(props) {
-	const [{ type, title, alias, permission, domain, readonly, internal, ignore, hidden, defaultValue }] = (0, __alloy_js_core.splitProps)(props, [
+	const [{ type, alias, permission, readonly, internal, ignore, hidden, defaultValue }] = (0, __alloy_js_core.splitProps)(props, [
 		"type",
-		"title",
 		"alias",
 		"permission",
-		"domain",
 		"readonly",
 		"internal",
 		"ignore",
 		"hidden",
 		"defaultValue"
 	]);
+	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?.trim());
+				return (0, __stryke_type_checks_is_set_string.isSetString)(title.value);
 			},
 			get children() {
-				return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocTitle, { children: title });
+				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, {
@@ -275,10 +277,12 @@ function TSDocAttributesTags(props) {
 		}),
 		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
 			get when() {
-				return (0, __stryke_type_checks_is_set_string.isSetString)(domain?.trim());
+				return (0, __stryke_type_checks_is_set_string.isSetString)(domain.value);
 			},
 			get children() {
-				return (0, __alloy_js_core_jsx_runtime.createComponent)(TSDocDomain, { children: domain });
+				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, {

package/dist/typescript/components/tsdoc.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"tsdoc.d.cts","names":[],"sources":["../../../src/typescript/components/tsdoc.tsx"],"sourcesContent":[],"mappings":";;;;;;UAwCiB,UAAA,SAAmB;YACxB;AADZ;AAOA;AA2BA;AAOA;AAgBiB,iBAlDD,KAAA,CAkDiB,KACnB,EAnDe,UAmDf,CAAA,EAnDyB,QAmDN;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;AAkBA;AAagB,iBAnHA,WAAA,CAmHiB,KAAA,EAnHE,gBAmHY,CAAA,EAnHI,QAmHJ;AAI/C;AAYA;AA4BA;AAOgB,iBA3IA,UAAA,CA2Ia,KAAA,EA3IK,cA2IL,CAAA,EA3ImB,QA2InB;AAO7B;AAOA;AAIA;AACS,iBAjJO,WAAA,CAiJP,KAAA,EAjJ0B,cAiJ1B,CAAA,EAjJwC,QAiJxC;;;;AAeO,iBAnJA,UAAA,CAmJmB,KAAQ,EAnJT,cAmJS,CAAA,EAnJK,QAmJmB;AA+EnE;;;AAIiB,iBAzND,eAAA,CAyNC,KAAA,EAzNsB,cAyNtB,CAAA,EAzNoC,QAyNpC;AAAQ,UA/MR,sBAAA,SAA+B,cA+MvB,CAAA;EAMT,IAAA,EApNR,cAoNkB,GApND,kBAoNS,GApNY,mBAoNG;EAiDjC,YAAA,EAAA,GAAY;AAO5B;AAIA;AAiCA;;iBA1SgB,iBAAA,QAAyB,yBAAsB;;;;iBAkB/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"}
+{"version":3,"file":"tsdoc.d.cts","names":[],"sources":["../../../src/typescript/components/tsdoc.tsx"],"sourcesContent":[],"mappings":";;;;;;UAyCiB,UAAA,SAAmB;YACxB;AADZ;AAOA;AA2BA;AAOA;AAgBiB,iBAlDD,KAAA,CAkDiB,KACnB,EAnDe,UAmDf,CAAA,EAnDyB,QAmDN;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;AAkBA;AAagB,iBAnHA,WAAA,CAmHiB,KAAA,EAnHE,gBAmHY,CAAA,EAnHI,QAmHJ;AAI/C;AAYA;AA4BA;AAOgB,iBA3IA,UAAA,CA2Ia,KAAA,EA3IK,cA2IL,CAAA,EA3ImB,QA2InB;AAO7B;AAOA;AAIA;AACS,iBAjJO,WAAA,CAiJP,KAAA,EAjJ0B,cAiJ1B,CAAA,EAjJwC,QAiJxC;;;;AAeO,iBAnJA,UAAA,CAmJmB,KAAQ,EAnJT,cAmJS,CAAA,EAnJK,QAmJmB;AA8EnE;;;AAIiB,iBAxND,eAAA,CAwNC,KAAA,EAxNsB,cAwNtB,CAAA,EAxNoC,QAwNpC;AAAQ,UA9MR,sBAAA,SAA+B,cA8MvB,CAAA;EAMT,IAAA,EAnNR,cAmNkB,GAnND,kBAmNS,GAnNY,mBAmNG;EAiDjC,YAAA,EAAA,GAAY;AAO5B;AAIA;AAiCA;;iBAzSgB,iBAAA,QAAyB,yBAAsB;;;;iBAkB/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;UA8ElD,eAAA;QACT;aACK;;iBAEI;;;;;iBAMD,UAAA,QAAkB,kBAAe;;;;iBAiDjC,YAAA,QAAoB,iBAAc;;;;iBAOlC,WAAA,QAAmB,iBAAc;UAIhC,gBAAA,SAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;QA2BlC;;;;;iBAMQ,WAAA,QAAmB,mBAAgB"}