@powerlines/plugin-date 0.12.136 → 0.12.138

package/dist/plugin-alloy/src/typescript/components/tsdoc-reflection.mjs

@@ -0,0 +1,73 @@
+import { TSDoc, TSDocAttributesTags } from "./tsdoc.mjs";
+import { useReflectionClass, useReflectionProperty } from "../../core/contexts/reflection.mjs";
+import { List, Show, childrenArray, code, computed, splitProps } from "@alloy-js/core";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { titleCase } from "@stryke/string-format/title-case";
+import { isString } from "@stryke/type-checks/is-string";
+import { isUndefined } from "@stryke/type-checks/is-undefined";
+
+//#region ../plugin-alloy/src/typescript/components/tsdoc-reflection.tsx
+/**
+* Generates a TypeScript interface property for the given reflection class.
+*/
+function TSDocReflectionClass(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	const reflectionClass = useReflectionClass();
+	const title = computed(() => reflectionClass.reflection.getTitle() || titleCase(reflectionClass.reflection.getName()));
+	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());
+	if (!reflectionClass.reflection.getName()) return null;
+	return /* @__PURE__ */ jsxs(TSDoc, {
+		...rest,
+		heading: reflectionClass.reflection.getDescription(),
+		children: [/* @__PURE__ */ jsx(Show, {
+			when: 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),
+			children: /* @__PURE__ */ jsx(TSDocAttributesTags, {
+				title: title.value,
+				alias: alias.value,
+				domain: domain.value,
+				permission: permission.value,
+				readonly: readonly.value,
+				internal: internal.value,
+				ignore: ignore.value,
+				hidden: hidden.value
+			})
+		}), /* @__PURE__ */ jsx(Show, {
+			when: Boolean(children) && childrenArray(() => children).length > 0,
+			children: /* @__PURE__ */ jsx(List, { children: childrenArray(() => children) })
+		})]
+	});
+}
+/**
+* Generates a TypeScript interface property for the given reflection class.
+*/
+function TSDocReflectionProperty(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	const context = useReflectionProperty();
+	return /* @__PURE__ */ jsxs(TSDoc, {
+		heading: context.getDescription(),
+		...rest,
+		children: [/* @__PURE__ */ jsx(TSDocAttributesTags, {
+			title: context.getTitle(),
+			alias: context.getAlias(),
+			domain: context.getDomain(),
+			permission: context.getPermission(),
+			readonly: context.isReadonly(),
+			internal: context.isInternal(),
+			ignore: context.isIgnored(),
+			hidden: context.isHidden()
+		}), /* @__PURE__ */ jsx(Show, {
+			when: Boolean(children) && childrenArray(() => children).length > 0,
+			children: /* @__PURE__ */ jsx(List, { children: childrenArray(() => children) })
+		})]
+	});
+}
+
+//#endregion
+export { TSDocReflectionClass, TSDocReflectionProperty };

package/dist/plugin-alloy/src/typescript/components/tsdoc.cjs

@@ -0,0 +1,359 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+const require_context = require('../../core/contexts/context.cjs');
+const require_utilities = require('../../../../deepkit/src/utilities.cjs');
+let __alloy_js_core = require("@alloy-js/core");
+let react_jsx_runtime = require("react/jsx-runtime");
+let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let __stryke_type_checks_is_undefined = require("@stryke/type-checks/is-undefined");
+
+//#region ../plugin-alloy/src/typescript/components/tsdoc.tsx
+/**
+* Generates a TypeScript interface for the given reflection class.
+*/
+function TSDoc(props) {
+	const [{ children, heading }] = (0, __alloy_js_core.splitProps)(props, ["children", "heading"]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+		"/**",
+		/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("align", {
+			string: " * ",
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__alloy_js_core.Show, {
+					when: !(0, __stryke_type_checks_is_undefined.isUndefined)(heading),
+					children: [
+						heading,
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+							when: !(0, __stryke_type_checks_is_undefined.isUndefined)(children) && (0, __alloy_js_core.childrenArray)(() => children).length > 0,
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {})
+						})
+					]
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+					when: !(0, __stryke_type_checks_is_undefined.isUndefined)(children) && (0, __alloy_js_core.childrenArray)(() => children).length > 0,
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.List, { children: (0, __alloy_js_core.childrenArray)(() => children) })
+				})
+			]
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+		` */`,
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {})
+	] });
+}
+/**
+* Create a TSDoc `@<props.tag>` tag.
+*/
+function TSDocTag(props) {
+	const [{ children, tag }] = (0, __alloy_js_core.splitProps)(props, ["children", "tag"]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+		`@${tag} `,
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+			when: Boolean(children),
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("align", {
+				width: 2,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Prose, { children })
+			})
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {})
+	] });
+}
+/**
+* Create a TSDoc `@title` tag.
+*/
+function TSDocTitle(props) {
+	const [{ children }, rest] = (0, __alloy_js_core.splitProps)(props, ["children"]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocTag, {
+		...rest,
+		tag: "title",
+		children
+	});
+}
+/**
+* Create a TSDoc `@domain` tag.
+*/
+function TSDocDomain(props) {
+	const [{ children }, rest] = (0, __alloy_js_core.splitProps)(props, ["children"]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocTag, {
+		...rest,
+		tag: "domain",
+		children
+	});
+}
+/**
+* Create a TSDoc `@alias` tag.
+*/
+function TSDocAlias(props) {
+	const [{ children }, rest] = (0, __alloy_js_core.splitProps)(props, ["children"]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocTag, {
+		...rest,
+		tag: "alias",
+		children
+	});
+}
+/**
+* Create a TSDoc `@permission` tag.
+*/
+function TSDocPermission(props) {
+	const [{ children }, rest] = (0, __alloy_js_core.splitProps)(props, ["children"]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocTag, {
+		...rest,
+		tag: "permission",
+		children
+	});
+}
+/**
+* Create a TSDoc `@defaultValue` tag.
+*/
+function TSDocDefaultValue(props) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+		"@defaultValue ",
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+			when: !(0, __stryke_type_checks_is_undefined.isUndefined)(props.value),
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("align", {
+				width: 2,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Prose, { children: require_utilities.stringifyDefaultValue(props.value) })
+			})
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {})
+	] });
+}
+/**
+* Create a TSDoc `@remarks` tag.
+*/
+function TSDocRemarks(props) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+		"@remarks ",
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.List, {
+			hardline: true,
+			children: (0, __alloy_js_core.childrenArray)(() => props.children)
+		})
+	] });
+}
+/**
+* Create a TSDoc `@see` tag.
+*/
+function TSDocLink(props) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocTag, {
+		...props,
+		tag: "see"
+	});
+}
+/**
+* Create a TSDoc `@example` tag.
+*/
+function TSDocExample(props) {
+	const [{ tsx, fenced = true, language, children }] = (0, __alloy_js_core.splitProps)(props, [
+		"tsx",
+		"fenced",
+		"language",
+		"children"
+	]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+		"@example ",
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__alloy_js_core.Show, {
+			when: fenced,
+			children: [
+				"```",
+				language || (tsx ? "tsx" : "ts"),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {})
+			]
+		}),
+		children,
+		/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__alloy_js_core.Show, {
+			when: fenced,
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}), "```"]
+		})
+	] });
+}
+/**
+* Create a TSDoc `@readonly` tag.
+*/
+function TSDocReadonly() {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocTag, { tag: "readonly" });
+}
+/**
+* Create a TSDoc `@internal` tag.
+*/
+function TSDocInternal() {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocTag, { tag: "internal" });
+}
+/**
+* Create a TSDoc `@ignore` tag.
+*/
+function TSDocIgnore() {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocTag, { tag: "ignore" });
+}
+/**
+* Create a TSDoc `@hidden` tag.
+*/
+function TSDocHidden() {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocTag, { tag: "hidden" });
+}
+/**
+* Generates a TypeScript interface property for the given reflection class.
+*/
+function TSDocAttributesTags(props) {
+	const [{ title, alias, permission, domain, readonly, internal, ignore, hidden, defaultValue }] = (0, __alloy_js_core.splitProps)(props, [
+		"title",
+		"alias",
+		"permission",
+		"domain",
+		"readonly",
+		"internal",
+		"ignore",
+		"hidden",
+		"defaultValue"
+	]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+			when: (0, __stryke_type_checks_is_set_string.isSetString)(title),
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocTitle, { children: title })
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+			when: !(0, __stryke_type_checks_is_undefined.isUndefined)(alias) && alias.length > 0,
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.For, {
+				each: alias ?? [],
+				children: (alias$1) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocAlias, { children: alias$1 })
+			})
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+			when: (0, __stryke_type_checks_is_set_string.isSetString)(domain),
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocDomain, { children: domain })
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+			when: !(0, __stryke_type_checks_is_undefined.isUndefined)(permission) && permission.length > 0,
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.For, {
+				each: permission ?? [],
+				children: (permission$1) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocPermission, { children: permission$1 })
+			})
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+			when: readonly === true,
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocReadonly, {})
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+			when: internal === true,
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocInternal, {})
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+			when: ignore === true,
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocIgnore, {})
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+			when: hidden === true,
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocHidden, {})
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+			when: !(0, __stryke_type_checks_is_undefined.isUndefined)(defaultValue),
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocDefaultValue, { value: defaultValue })
+		})
+	] });
+}
+/**
+* Create a TSDoc parameter set off with `@param`.
+*/
+function TSDocParam(props) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+		"@param ",
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocParamName, {
+			name: props.name,
+			optional: props.optional,
+			defaultValue: props.defaultValue
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocParamDescription, { children: props.children })
+	] });
+}
+function TSDocParamName(props) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+			when: props.optional,
+			children: "["
+		}),
+		props.name,
+		/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__alloy_js_core.Show, {
+			when: Boolean(props.defaultValue),
+			children: ["=", props.defaultValue]
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+			when: props.optional,
+			children: "]"
+		})
+	] });
+}
+function TSDocParamDescription(props) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__alloy_js_core.Show, {
+		when: Boolean(props.children),
+		children: [" - ", /* @__PURE__ */ (0, react_jsx_runtime.jsx)("align", {
+			width: 2,
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Prose, { children: props.children })
+		})]
+	});
+}
+/**
+* Create a TSDoc `@returns` tag.
+*/
+function TSDocReturns(props) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocTag, {
+		...props,
+		tag: "returns"
+	});
+}
+/**
+* Create a TSDoc `@throws` tag.
+*/
+function TSDocThrows(props) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TSDocTag, {
+		...props,
+		tag: "throws"
+	});
+}
+/**
+* Generates a TSDoc `@module` tag for the given module name.
+*/
+function TSDocModule(props) {
+	const [{ children, name, prefix }] = (0, __alloy_js_core.splitProps)(props, [
+		"children",
+		"name",
+		"prefix"
+	]);
+	const context = require_context.usePowerlines();
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+		"/**",
+		/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("align", {
+			string: " * ",
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__alloy_js_core.Show, {
+					when: Boolean(children),
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.List, {
+							hardline: true,
+							children: (0, __alloy_js_core.childrenArray)(() => children)
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {})
+					]
+				}),
+				"@module ",
+				prefix || context?.config.output.builtinPrefix,
+				":",
+				name
+			]
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+		` */`
+	] });
+}
+
+//#endregion
+exports.TSDoc = TSDoc;
+exports.TSDocAttributesTags = TSDocAttributesTags;
+exports.TSDocExample = TSDocExample;
+exports.TSDocLink = TSDocLink;
+exports.TSDocModule = TSDocModule;
+exports.TSDocParam = TSDocParam;
+exports.TSDocRemarks = TSDocRemarks;
+exports.TSDocReturns = TSDocReturns;
+exports.TSDocThrows = TSDocThrows;