@powerlines/plugin-env 0.15.121 → 0.15.122

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

@@ -0,0 +1,442 @@
+import { usePowerlinesSafe } from "../../core/contexts/context.mjs";
+import { stringifyDefaultValue } from "../../../../deepkit/src/utilities.mjs";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { For, List, Prose, Show, childrenArray, splitProps } from "@alloy-js/core";
+import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { isUndefined } from "@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 }] = splitProps(props, ["children", "heading"]);
+	return [
+		"/**",
+		createIntrinsic("align", {
+			string: " * ",
+			get children() {
+				return [
+					createIntrinsic("hbr", {}),
+					createComponent(Show, {
+						get when() {
+							return !isUndefined(heading);
+						},
+						get children() {
+							return [
+								heading,
+								createIntrinsic("hbr", {}),
+								createComponent(Show, {
+									get when() {
+										return memo(() => !!!isUndefined(children))() && childrenArray(() => children).length > 0;
+									},
+									get children() {
+										return createIntrinsic("hbr", {});
+									}
+								})
+							];
+						}
+					}),
+					createComponent(Show, {
+						get when() {
+							return memo(() => !!!isUndefined(children))() && childrenArray(() => children).length > 0;
+						},
+						get children() {
+							return createComponent(List, { get children() {
+								return childrenArray(() => children);
+							} });
+						}
+					})
+				];
+			}
+		}),
+		createIntrinsic("hbr", {}),
+		` */`,
+		createIntrinsic("hbr", {})
+	];
+}
+/**
+* Create a TSDoc `@<props.tag>` tag.
+*/
+function TSDocTag(props) {
+	const [{ children, tag }] = splitProps(props, ["children", "tag"]);
+	return [
+		`@${tag} `,
+		createComponent(Show, {
+			get when() {
+				return Boolean(children);
+			},
+			get children() {
+				return createIntrinsic("align", {
+					width: 2,
+					get children() {
+						return createComponent(Prose, { children });
+					}
+				});
+			}
+		}),
+		createIntrinsic("hbr", {})
+	];
+}
+/**
+* Create a TSDoc `@title` tag.
+*/
+function TSDocTitle(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "title",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@domain` tag.
+*/
+function TSDocDomain(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "domain",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@alias` tag.
+*/
+function TSDocAlias(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "alias",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@permission` tag.
+*/
+function TSDocPermission(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "permission",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@defaultValue` tag.
+*/
+function TSDocDefaultValue(props) {
+	const [{ type, defaultValue }] = splitProps(props, ["type", "defaultValue"]);
+	return [
+		"@defaultValue ",
+		createComponent(Show, {
+			get when() {
+				return !isUndefined(defaultValue);
+			},
+			get children() {
+				return createIntrinsic("align", {
+					width: 2,
+					get children() {
+						return createComponent(Prose, { get children() {
+							return stringifyDefaultValue(type, defaultValue);
+						} });
+					}
+				});
+			}
+		}),
+		createIntrinsic("hbr", {})
+	];
+}
+/**
+* Create a TSDoc `@remarks` tag.
+*/
+function TSDocRemarks(props) {
+	return [
+		"@remarks ",
+		createIntrinsic("hbr", {}),
+		createComponent(List, {
+			hardline: true,
+			get children() {
+				return childrenArray(() => props.children);
+			}
+		})
+	];
+}
+/**
+* Create a TSDoc `@see` tag.
+*/
+function TSDocLink(props) {
+	return createComponent(TSDocTag, mergeProps(props, { tag: "see" }));
+}
+/**
+* Create a TSDoc `@example` tag.
+*/
+function TSDocExample(props) {
+	const [{ tsx, fenced = true, language, children }] = splitProps(props, [
+		"tsx",
+		"fenced",
+		"language",
+		"children"
+	]);
+	return [
+		"@example ",
+		createIntrinsic("hbr", {}),
+		createComponent(Show, {
+			when: fenced,
+			get children() {
+				return [
+					"```",
+					language || (tsx ? "tsx" : "ts"),
+					createIntrinsic("hbr", {})
+				];
+			}
+		}),
+		children,
+		createComponent(Show, {
+			when: fenced,
+			get children() {
+				return [createIntrinsic("hbr", {}), "```"];
+			}
+		})
+	];
+}
+/**
+* Create a TSDoc `@readonly` tag.
+*/
+function TSDocReadonly() {
+	return createComponent(TSDocTag, { tag: "readonly" });
+}
+/**
+* Create a TSDoc `@internal` tag.
+*/
+function TSDocInternal() {
+	return createComponent(TSDocTag, { tag: "internal" });
+}
+/**
+* Create a TSDoc `@ignore` tag.
+*/
+function TSDocIgnore() {
+	return createComponent(TSDocTag, { tag: "ignore" });
+}
+/**
+* Create a TSDoc `@hidden` tag.
+*/
+function TSDocHidden() {
+	return createComponent(TSDocTag, { tag: "hidden" });
+}
+/**
+* Generates a TypeScript interface property for the given reflection class.
+*/
+function TSDocAttributesTags(props) {
+	const [{ type, title, alias, permission, domain, readonly, internal, ignore, hidden, defaultValue }] = splitProps(props, [
+		"type",
+		"title",
+		"alias",
+		"permission",
+		"domain",
+		"readonly",
+		"internal",
+		"ignore",
+		"hidden",
+		"defaultValue"
+	]);
+	return [
+		createComponent(Show, {
+			get when() {
+				return isSetString(title?.trim());
+			},
+			get children() {
+				return createComponent(TSDocTitle, { children: title });
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return memo(() => !!(!isUndefined(alias) && alias.length > 0))() && alias.some((a) => isSetString(a?.trim()));
+			},
+			get children() {
+				return createComponent(For, {
+					get each() {
+						return alias?.filter((a) => isSetString(a?.trim())) ?? [];
+					},
+					children: (alias$1) => createComponent(TSDocAlias, { children: alias$1 })
+				});
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return isSetString(domain?.trim());
+			},
+			get children() {
+				return createComponent(TSDocDomain, { children: domain });
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return memo(() => !!(!isUndefined(permission) && permission.length > 0))() && permission.some((p) => isSetString(p?.trim()));
+			},
+			get children() {
+				return createComponent(For, {
+					get each() {
+						return permission?.filter((p) => isSetString(p?.trim())) ?? [];
+					},
+					children: (permission$1) => createComponent(TSDocPermission, { children: permission$1 })
+				});
+			}
+		}),
+		createComponent(Show, {
+			when: readonly === true,
+			get children() {
+				return createComponent(TSDocReadonly, {});
+			}
+		}),
+		createComponent(Show, {
+			when: internal === true,
+			get children() {
+				return createComponent(TSDocInternal, {});
+			}
+		}),
+		createComponent(Show, {
+			when: ignore === true,
+			get children() {
+				return createComponent(TSDocIgnore, {});
+			}
+		}),
+		createComponent(Show, {
+			when: hidden === true,
+			get children() {
+				return createComponent(TSDocHidden, {});
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return memo(() => !!!isUndefined(type))() && !isUndefined(defaultValue);
+			},
+			get children() {
+				return createComponent(TSDocDefaultValue, {
+					type,
+					defaultValue
+				});
+			}
+		})
+	];
+}
+/**
+* Create a TSDoc parameter set off with `@param`.
+*/
+function TSDocParam(props) {
+	return [
+		"@param ",
+		createComponent(TSDocParamName, {
+			get name() {
+				return props.name;
+			},
+			get optional() {
+				return props.optional;
+			},
+			get defaultValue() {
+				return props.defaultValue;
+			}
+		}),
+		createComponent(TSDocParamDescription, { get children() {
+			return props.children;
+		} })
+	];
+}
+function TSDocParamName(props) {
+	return [
+		createComponent(Show, {
+			get when() {
+				return props.optional;
+			},
+			children: "["
+		}),
+		memo(() => props.name),
+		createComponent(Show, {
+			get when() {
+				return Boolean(props.defaultValue);
+			},
+			get children() {
+				return ["=", memo(() => props.defaultValue)];
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return props.optional;
+			},
+			children: "]"
+		})
+	];
+}
+function TSDocParamDescription(props) {
+	return createComponent(Show, {
+		get when() {
+			return Boolean(props.children);
+		},
+		get children() {
+			return [" - ", createIntrinsic("align", {
+				width: 2,
+				get children() {
+					return createComponent(Prose, { get children() {
+						return props.children;
+					} });
+				}
+			})];
+		}
+	});
+}
+/**
+* Create a TSDoc `@returns` tag.
+*/
+function TSDocReturns(props) {
+	return createComponent(TSDocTag, mergeProps(props, { tag: "returns" }));
+}
+/**
+* Create a TSDoc `@throws` tag.
+*/
+function TSDocThrows(props) {
+	return createComponent(TSDocTag, mergeProps(props, { tag: "throws" }));
+}
+/**
+* Generates a TSDoc `@module` tag for the given module name.
+*/
+function TSDocModule(props) {
+	const [{ children, name, prefix }] = splitProps(props, [
+		"children",
+		"name",
+		"prefix"
+	]);
+	const context = usePowerlinesSafe();
+	return [
+		"/**",
+		createIntrinsic("align", {
+			string: " * ",
+			get children() {
+				return [
+					createIntrinsic("hbr", {}),
+					createComponent(Show, {
+						get when() {
+							return Boolean(children);
+						},
+						get children() {
+							return [
+								createComponent(List, {
+									hardline: true,
+									get children() {
+										return childrenArray(() => children);
+									}
+								}),
+								createIntrinsic("hbr", {}),
+								createIntrinsic("hbr", {})
+							];
+						}
+					}),
+					"@module ",
+					memo(() => prefix || context?.config?.framework || "powerlines"),
+					":",
+					name
+				];
+			}
+		}),
+		createIntrinsic("hbr", {}),
+		` */`
+	];
+}
+
+//#endregion
+export { TSDoc, TSDocAttributesTags, TSDocExample, TSDocLink, TSDocModule, TSDocParam, TSDocRemarks, TSDocReturns, TSDocThrows };

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

@@ -0,0 +1,216 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+const require_context = require('../../core/contexts/context.cjs');
+const require_single_line_comment = require('../../core/components/single-line-comment.cjs');
+const require_source_file = require('../../core/components/source-file.cjs');
+let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
+let __stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
+let __stryke_path_append = require("@stryke/path/append");
+let __alloy_js_core = require("@alloy-js/core");
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_typescript = require("@alloy-js/typescript");
+let __stryke_type_checks_is_boolean = require("@stryke/type-checks/is-boolean");
+
+//#region ../plugin-alloy/src/typescript/components/typescript-file.tsx
+/**
+* A base component representing a Powerlines generated Typescript source file.
+*
+* @param props - The properties for the source file.
+* @returns The rendered source file component.
+*/
+function TypescriptFile(props) {
+	const [{ children, path, imports, builtinImports, tsx, header, hashbang }, rest] = (0, __alloy_js_core.splitProps)(props, [
+		"children",
+		"path",
+		"imports",
+		"builtinImports",
+		"tsx",
+		"header",
+		"hashbang"
+	]);
+	const directoryContext = (0, __alloy_js_core.useContext)(__alloy_js_core.SourceDirectoryContext);
+	const sdData = (0, __alloy_js_typescript.getSourceDirectoryData)(directoryContext);
+	const modulePath = (0, __stryke_path_append.appendPath)(path, directoryContext.path);
+	const scope = new __alloy_js_typescript.TSModuleScope(modulePath, (0, __alloy_js_core.useScope)());
+	sdData.modules.add(scope);
+	const pkg = (0, __alloy_js_core.useContext)(__alloy_js_typescript.PackageContext);
+	if (pkg) pkg.scope.addModule(scope);
+	if (props.export) {
+		if (pkg) if ((0, __stryke_type_checks_is_boolean.isBoolean)(props.export)) pkg.scope.addExport(modulePath, scope);
+		else pkg.scope.addExport(props.export, scope);
+	}
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.SourceFileContext.Provider, {
+		value: { scope },
+		get children() {
+			return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Scope, {
+				value: scope,
+				get children() {
+					return (0, __alloy_js_core_jsx_runtime.createComponent)(require_source_file.SourceFile, (0, __alloy_js_core_jsx_runtime.mergeProps)(rest, {
+						path: modulePath,
+						get header() {
+							return header ?? (0, __alloy_js_core_jsx_runtime.createComponent)(TypescriptFileHeader, {
+								hashbang,
+								get children() {
+									return (0, __alloy_js_core_jsx_runtime.createComponent)(TypescriptFileHeaderImports, {
+										imports,
+										builtinImports,
+										scope
+									});
+								}
+							});
+						},
+						filetype: tsx ? "tsx" : "typescript",
+						children
+					}));
+				}
+			});
+		}
+	});
+}
+/**
+* Renders the header for a Powerlines Typescript source file.
+*
+* @param props - The properties for the source file header.
+* @returns The rendered source file header.
+*/
+function TypescriptFileHeader(props) {
+	const { header, hashbang, disableEslint = true, disableBiome = true, disablePrettier = false, children } = props;
+	const context = require_context.usePowerlinesSafe();
+	return [
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Boolean(hashbang);
+			},
+			get children() {
+				return [(0, __alloy_js_core_jsx_runtime.memo)(() => hashbang === true ? __alloy_js_core.code`#!/usr/bin/env ${context?.config.mode === "development" ? "-S NODE_OPTIONS=--enable-source-maps" : ""} node` : hashbang), (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Boolean(header);
+			},
+			get children() {
+				return [header, (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Boolean(disableEslint);
+			},
+			get children() {
+				return [(0, __alloy_js_core_jsx_runtime.createComponent)(require_single_line_comment.SingleLineComment, {
+					variant: "slash-star",
+					children: "eslint-disable"
+				}), (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Boolean(disablePrettier);
+			},
+			get children() {
+				return [(0, __alloy_js_core_jsx_runtime.createComponent)(require_single_line_comment.SingleLineComment, {
+					variant: "slash-star",
+					children: "prettier-ignore"
+				}), (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Boolean(disableBiome);
+			},
+			get children() {
+				return [(0, __alloy_js_core_jsx_runtime.createComponent)(require_single_line_comment.SingleLineComment, { children: "biome-ignore lint: disable" }), (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Boolean(disableEslint) || Boolean(disablePrettier) || Boolean(disableBiome);
+			},
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {});
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Boolean(children);
+			},
+			get children() {
+				return [children, (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(require_single_line_comment.SingleLineComment, { get children() {
+			return `Generated by ${(0, __stryke_string_format_title_case.titleCase)(context?.config?.framework) || "Powerlines"}`;
+		} }),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(require_single_line_comment.SingleLineComment, { children: __alloy_js_core.code`NOTE: Do not edit this file manually - it will be overwritten automatically` }),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+	];
+}
+/**
+* Renders the header for a Powerlines Typescript source file.
+*
+* @param props - The properties for the source file header.
+* @returns The rendered source file header.
+*/
+function TypescriptFileHeaderImports(props) {
+	const { imports, builtinImports } = props;
+	const context = require_context.usePowerlinesSafe();
+	const sourceFile = (0, __alloy_js_typescript.useSourceFile)();
+	const scope = props.scope ?? sourceFile.scope;
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+		get when() {
+			return scope.importedModules.size > 0 || !!imports && Object.keys(imports).length > 0 || !!builtinImports && Object.keys(builtinImports).length > 0;
+		},
+		get children() {
+			return [
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+					get when() {
+						return !!imports && Object.keys(imports).length > 0;
+					},
+					get children() {
+						return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+							get each() {
+								return Object.entries(imports ?? {});
+							},
+							hardline: true,
+							children: ([module$1, importItem]) => {
+								return [(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`import ${importItem === null ? "" : (0, __stryke_type_checks_is_string.isString)(importItem) ? importItem : ` ${importItem.filter((i) => !(0, __stryke_type_checks_is_string.isString)(i) && i.default).map((i) => i.alias ? i.alias : i.name).join(", ") + (importItem.filter((i) => !(0, __stryke_type_checks_is_string.isString)(i) && i.default).length > 0 && importItem.filter((i) => (0, __stryke_type_checks_is_string.isString)(i) || !i.default).length > 0 ? ", " : "") + (importItem.filter((i) => (0, __stryke_type_checks_is_string.isString)(i) || !i.default).length > 0 ? `{ ${importItem.map((i) => (0, __stryke_type_checks_is_string.isString)(i) ? i : i.alias ? `${i.name} as ${i.alias}` : i.name).join(", ")} }` : "")} `} from "${module$1}";`)];
+							}
+						});
+					}
+				}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+					get when() {
+						return builtinImports && Object.keys(builtinImports).length > 0;
+					},
+					get children() {
+						return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+							get each() {
+								return Object.entries(builtinImports ?? {});
+							},
+							hardline: true,
+							children: ([module$1, importItem]) => __alloy_js_core.code`import ${importItem === null ? "" : (0, __stryke_type_checks_is_string.isString)(importItem) ? importItem : ` ${importItem.filter((i) => !(0, __stryke_type_checks_is_string.isString)(i) && i.default).map((i) => i.alias ? i.alias : i.name).join(", ") + (importItem.filter((i) => !(0, __stryke_type_checks_is_string.isString)(i) && i.default).length > 0 && importItem.filter((i) => (0, __stryke_type_checks_is_string.isString)(i) || !i.default).length > 0 ? ", " : "") + (importItem.filter((i) => (0, __stryke_type_checks_is_string.isString)(i) || !i.default).length > 0 ? `{ ${importItem.map((i) => (0, __stryke_type_checks_is_string.isString)(i) ? i : i.alias ? `${i.name} as ${i.alias}` : i.name).join(", ")} }` : "")} `} from "${module$1.includes(":") ? module$1 : `${context?.config?.framework || "powerlines"}:${module$1}`}";`
+						});
+					}
+				}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+					get when() {
+						return scope.importedModules.size > 0;
+					},
+					get children() {
+						return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.ImportStatements, { get records() {
+							return scope.importedModules;
+						} });
+					}
+				}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+			];
+		}
+	});
+}
+
+//#endregion
+exports.TypescriptFile = TypescriptFile;
+exports.TypescriptFileHeader = TypescriptFileHeader;
+exports.TypescriptFileHeaderImports = TypescriptFileHeaderImports;

package/dist/{packages/plugin-alloy → plugin-alloy}/src/typescript/components/typescript-file.d.mts

@@ -1,7 +1,7 @@
 import { ComponentProps, TypescriptFileImports } from "../../types/components.mjs";
 import { SourceFileProps as SourceFileProps$1 } from "../../core/components/source-file.mjs";
 import { Children } from "@alloy-js/core";
-import "@alloy-js/typescript";
+import { TSModuleScope } from "@alloy-js/typescript";
 
 //#region ../plugin-alloy/src/typescript/components/typescript-file.d.ts
 type TypescriptFileProps = Omit<SourceFileProps$1, "filetype"> & ComponentProps & {