@powerlines/plugin-env 0.15.5 → 0.15.6

package/dist/_virtual/rolldown_runtime.cjs

@@ -0,0 +1,29 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__toESM = __toESM;

package/dist/babel/index.cjs

@@ -0,0 +1 @@
+const require_plugin = require('./plugin.cjs');

package/dist/babel/index.d.cts

@@ -0,0 +1 @@
+import { envBabelPlugin } from "./plugin.cjs";

package/dist/babel/index.d.mts

@@ -0,0 +1 @@
+import { envBabelPlugin } from "./plugin.mjs";

package/dist/babel/index.mjs

@@ -0,0 +1,3 @@
+import { envBabelPlugin } from "./plugin.mjs";
+
+export {  };

package/dist/babel/plugin.cjs

@@ -0,0 +1,200 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_babel = require('../powerlines/src/types/babel.cjs');
+const require_create_plugin = require('../plugin-babel/src/helpers/create-plugin.cjs');
+const require_module_helpers = require('../plugin-babel/src/helpers/module-helpers.cjs');
+const require_types_plugin = require('../types/plugin.cjs');
+const require_capnp = require('../deepkit/src/capnp.cjs');
+const require_reflection = require('../deepkit/schemas/reflection2.cjs');
+const require_utilities = require('../deepkit/src/utilities.cjs');
+const require_persistence = require('../helpers/persistence.cjs');
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __babel_core = require("@babel/core");
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
+let __stryke_capnp = require("@stryke/capnp");
+__stryke_capnp = require_rolldown_runtime.__toESM(__stryke_capnp);
+let __stryke_fs_buffer = require("@stryke/fs/buffer");
+let node_fs = require("node:fs");
+
+//#region src/babel/plugin.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+const envBabelPlugin = (require_create_plugin.createBabelPlugin.Ω = [[() => require_types_plugin.__ΩEnvPluginContext, "n!"]], require_create_plugin.createBabelPlugin("env", __assignType(({ log, context }) => {
+	function extractEnv(node, pass, isInjectable = false) {
+		const envTypesAliasProperties = context.env.types.env?.getProperties().filter(__assignType((prop) => prop.getAlias().length > 0, [
+			"prop",
+			"",
+			"P\"2!\"/\""
+		]));
+		if (node.name) {
+			const prefix = context.config.env.prefix.find(__assignType((pre) => node.name && node.name.startsWith(pre) && (context.env.types.env?.hasProperty(node.name.replace(`${pre}_`, "")) || envTypesAliasProperties.some(__assignType((prop) => prop.getAlias().includes(node.name.replace(`${pre}_`, "")), [
+				"prop",
+				"",
+				"P\"2!\"/\""
+			]))), [
+				"pre",
+				"",
+				"P\"2!\"/\""
+			]));
+			let name = node.name;
+			if (prefix) name = node.name.replace(`${prefix}_`, "");
+			log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Environment variable ${name} found in ${pass.filename || "unknown file"}.`);
+			if (context.env.types.env?.hasProperty(name) || envTypesAliasProperties.some(__assignType((prop) => prop.getAlias().includes(name), [
+				"prop",
+				"",
+				"P\"2!\"/\""
+			]))) {
+				const envProperty = context.env.types.env.hasProperty(name) ? context.env.types.env.getProperty(name) : envTypesAliasProperties.find(__assignType((prop) => prop.getAlias().includes(name), [
+					"prop",
+					"",
+					"P\"2!\"/\""
+				]));
+				if (!envProperty || envProperty.isIgnored()) return;
+				if (!context.env.used.env.hasProperty(name)) context.env.used.env.addProperty(envProperty.property);
+				if (context.config.env.inject && isInjectable) {
+					let value = context.env.parsed?.[name];
+					if (value === void 0) {
+						const prefix$1 = context.config.env.prefix.find(__assignType((pre) => {
+							return context.env.parsed[`${pre.replace(/_$/g, "")}_${name}`];
+						}, [
+							"pre",
+							"",
+							"P\"2!\"/\""
+						]));
+						if (prefix$1) value = context.env.parsed[`${prefix$1.replace(/_$/g, "")}_${name}`];
+					}
+					value ??= envProperty.getDefaultValue();
+					if (envProperty.isValueRequired() && value === void 0) throw new Error(`Environment variable \`${name}\` is not defined in the .env configuration files`);
+					return require_utilities.stringifyDefaultValue(envProperty, value);
+				}
+			} else throw new Error(`The "${name}" environment variable is not defined in the \`env\` type definition, but is used in the source code file ${pass.filename ? pass.filename : "unknown"}.
+
+          The following environment configuration names are defined in the \`env\` type definition: \n${context.env.types.env?.getPropertyNames().sort(__assignType((a, b) => String(a).localeCompare(String(b)), [
+				"a",
+				"b",
+				"",
+				"P\"2!\"2\"\"/#"
+			])).map(__assignType((typeDef) => ` - ${String(typeDef)} ${envTypesAliasProperties.some(__assignType((prop) => prop.getNameAsString() === String(typeDef) && prop.getAlias().length > 0, [
+				"prop",
+				"",
+				"P\"2!\"/\""
+			])) ? `(Alias: ${envTypesAliasProperties?.find(__assignType((prop) => prop.getNameAsString() === String(typeDef), [
+				"prop",
+				"",
+				"P\"2!\"/\""
+			]))?.getAlias().join(", ")})` : ""}`, [
+				"typeDef",
+				"",
+				"P\"2!\"/\""
+			])).join("\n")} \n\nUsing the following env prefix: \n${context.config.env.prefix.map(__assignType((prefix$1) => ` - ${prefix$1}`, [
+				"prefix",
+				"",
+				"P\"2!\"/\""
+			])).join("\n")} \n\nPlease check your \`env\` configuration option. If you are using a custom dotenv type definition, please make sure that the configuration names match the ones in the code. \n\n`);
+		}
+	}
+	extractEnv.__type = [
+		"node",
+		() => require_babel.__ΩBabelPluginPass,
+		"pass",
+		"isInjectable",
+		"extractEnv",
+		"P!2!n\"2#\"2$\"/%"
+	];
+	return {
+		visitor: { MemberExpression: __assignType(function MemberExpression(path, pass) {
+			if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isIdentifier({ name: "$storm" }) && path.get("property")?.isIdentifier()) {
+				const identifier = path.get("property")?.node;
+				extractEnv(identifier, pass, false);
+				path.replaceWithSourceString(`env.${identifier.name}`);
+				require_module_helpers.addImport(path, {
+					module: "storm:env",
+					name: "env",
+					imported: "env"
+				});
+			} else if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isCallExpression({ callee: {
+				name: "useStorm",
+				type: "Identifier"
+			} }) && path.get("property")?.isIdentifier()) {
+				const identifier = path.get("property")?.node;
+				extractEnv(identifier, pass, false);
+				path.replaceWithSourceString(`env.${identifier.name}`);
+				require_module_helpers.addImport(path, {
+					module: "storm:env",
+					name: "env",
+					imported: "env"
+				});
+			} else if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isIdentifier({ name: "process" }) && path.get("property")?.isIdentifier()) {
+				const identifier = path.get("property")?.node;
+				if (!identifier.name) return;
+				extractEnv(identifier, pass, false);
+				path.replaceWithSourceString(`env.${identifier.name}`);
+				require_module_helpers.addImport(path, {
+					module: "storm:env",
+					name: "env",
+					imported: "env"
+				});
+			} else if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isMetaProperty() && path.get("property")?.isIdentifier()) {
+				const identifier = path.get("property")?.node;
+				if (!identifier.name) return;
+				extractEnv(identifier, pass, false);
+				path.replaceWithSourceString(`env.${identifier.name}`);
+				require_module_helpers.addImport(path, {
+					module: "storm:env",
+					name: "env",
+					imported: "env"
+				});
+			}
+		}, [
+			() => __babel_core.NodePath,
+			"path",
+			() => require_babel.__ΩBabelPluginPass,
+			"pass",
+			"MemberExpression",
+			"PP!7!2\"n#2$\"/%"
+		]) },
+		post() {
+			log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Adding environment variables from ${this.filename || "unknown file"} to env.json.`);
+			let persistedEnv = __powerlines_deepkit_vendor_type.ReflectionClass.from({
+				kind: __powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral,
+				description: `An object containing the environment variables used by the application.`,
+				types: []
+			});
+			const reflectionPath = require_persistence.getEnvReflectionsPath(context, "env");
+			if (reflectionPath && (0, node_fs.existsSync)(reflectionPath)) {
+				log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Environment reflection file found at ${reflectionPath}, reading existing reflection.`);
+				persistedEnv = (0, __powerlines_deepkit_vendor_type.resolveClassType)((0, __powerlines_deepkit_vendor_type.deserializeType)(require_capnp.convertFromCapnp(new __stryke_capnp.Message((0, __stryke_fs_buffer.readFileBufferSync)(reflectionPath), false).getRoot(require_reflection.SerializedTypes).types)));
+			}
+			log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Adding new variables to env reflection at ${reflectionPath}.`);
+			persistedEnv.getProperties().filter(__assignType((property) => property.getNameAsString() && !context.env.used.env.hasProperty(property.getNameAsString()), [
+				"property",
+				"",
+				"P\"2!\"/\""
+			])).forEach(__assignType((property) => {
+				context.env.used.env.addProperty({
+					...property,
+					name: property.getNameAsString(),
+					description: property.getDescription() ?? `The ${property.getNameAsString()} variable.`,
+					default: property.getDefaultValue(),
+					optional: property.isOptional() ? true : void 0,
+					readonly: property.isReadonly() ? true : void 0,
+					visibility: property.getVisibility(),
+					type: property.getType(),
+					tags: property.getTags()
+				});
+			}, [
+				"property",
+				"",
+				"P\"2!\"/\""
+			]));
+		}
+	};
+}, [
+	"param0",
+	"",
+	"P\"2!\"/\""
+])));
+
+//#endregion
+exports.envBabelPlugin = envBabelPlugin;

package/dist/babel/plugin.d.cts

@@ -0,0 +1,8 @@
+import { DeclareBabelTransformPluginReturn } from "../powerlines/src/types/babel.cjs";
+import { EnvPluginContext, EnvPluginResolvedConfig } from "../types/plugin.cjs";
+import "../index.cjs";
+
+//#region src/babel/plugin.d.ts
+declare const envBabelPlugin: DeclareBabelTransformPluginReturn<EnvPluginContext<EnvPluginResolvedConfig>, Record<string, any>>;
+//#endregion
+export { envBabelPlugin };

package/dist/babel/plugin.d.mts

@@ -0,0 +1,9 @@
+import { DeclareBabelTransformPluginReturn } from "../powerlines/src/types/babel.mjs";
+import "../powerlines/src/index.mjs";
+import { EnvPluginContext, EnvPluginResolvedConfig } from "../types/plugin.mjs";
+import "../index.mjs";
+
+//#region src/babel/plugin.d.ts
+declare const envBabelPlugin: DeclareBabelTransformPluginReturn<EnvPluginContext<EnvPluginResolvedConfig>, Record<string, any>>;
+//#endregion
+export { envBabelPlugin };

package/dist/babel/plugin.mjs

@@ -0,0 +1,198 @@
+import { __ΩBabelPluginPass } from "../powerlines/src/types/babel.mjs";
+import { createBabelPlugin } from "../plugin-babel/src/helpers/create-plugin.mjs";
+import { addImport } from "../plugin-babel/src/helpers/module-helpers.mjs";
+import { __ΩEnvPluginContext } from "../types/plugin.mjs";
+import { convertFromCapnp } from "../deepkit/src/capnp.mjs";
+import { SerializedTypes } from "../deepkit/schemas/reflection2.mjs";
+import { stringifyDefaultValue } from "../deepkit/src/utilities.mjs";
+import { getEnvReflectionsPath } from "../helpers/persistence.mjs";
+import { ReflectionClass, ReflectionKind, deserializeType, resolveClassType } from "@powerlines/deepkit/vendor/type";
+import { NodePath } from "@babel/core";
+import { LogLevelLabel } from "@storm-software/config-tools/types";
+import * as capnp from "@stryke/capnp";
+import { readFileBufferSync } from "@stryke/fs/buffer";
+import { existsSync } from "node:fs";
+
+//#region src/babel/plugin.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+const envBabelPlugin = (createBabelPlugin.Ω = [[() => __ΩEnvPluginContext, "n!"]], createBabelPlugin("env", __assignType(({ log, context }) => {
+	function extractEnv(node, pass, isInjectable = false) {
+		const envTypesAliasProperties = context.env.types.env?.getProperties().filter(__assignType((prop) => prop.getAlias().length > 0, [
+			"prop",
+			"",
+			"P\"2!\"/\""
+		]));
+		if (node.name) {
+			const prefix = context.config.env.prefix.find(__assignType((pre) => node.name && node.name.startsWith(pre) && (context.env.types.env?.hasProperty(node.name.replace(`${pre}_`, "")) || envTypesAliasProperties.some(__assignType((prop) => prop.getAlias().includes(node.name.replace(`${pre}_`, "")), [
+				"prop",
+				"",
+				"P\"2!\"/\""
+			]))), [
+				"pre",
+				"",
+				"P\"2!\"/\""
+			]));
+			let name = node.name;
+			if (prefix) name = node.name.replace(`${prefix}_`, "");
+			log(LogLevelLabel.TRACE, `Environment variable ${name} found in ${pass.filename || "unknown file"}.`);
+			if (context.env.types.env?.hasProperty(name) || envTypesAliasProperties.some(__assignType((prop) => prop.getAlias().includes(name), [
+				"prop",
+				"",
+				"P\"2!\"/\""
+			]))) {
+				const envProperty = context.env.types.env.hasProperty(name) ? context.env.types.env.getProperty(name) : envTypesAliasProperties.find(__assignType((prop) => prop.getAlias().includes(name), [
+					"prop",
+					"",
+					"P\"2!\"/\""
+				]));
+				if (!envProperty || envProperty.isIgnored()) return;
+				if (!context.env.used.env.hasProperty(name)) context.env.used.env.addProperty(envProperty.property);
+				if (context.config.env.inject && isInjectable) {
+					let value = context.env.parsed?.[name];
+					if (value === void 0) {
+						const prefix$1 = context.config.env.prefix.find(__assignType((pre) => {
+							return context.env.parsed[`${pre.replace(/_$/g, "")}_${name}`];
+						}, [
+							"pre",
+							"",
+							"P\"2!\"/\""
+						]));
+						if (prefix$1) value = context.env.parsed[`${prefix$1.replace(/_$/g, "")}_${name}`];
+					}
+					value ??= envProperty.getDefaultValue();
+					if (envProperty.isValueRequired() && value === void 0) throw new Error(`Environment variable \`${name}\` is not defined in the .env configuration files`);
+					return stringifyDefaultValue(envProperty, value);
+				}
+			} else throw new Error(`The "${name}" environment variable is not defined in the \`env\` type definition, but is used in the source code file ${pass.filename ? pass.filename : "unknown"}.
+
+          The following environment configuration names are defined in the \`env\` type definition: \n${context.env.types.env?.getPropertyNames().sort(__assignType((a, b) => String(a).localeCompare(String(b)), [
+				"a",
+				"b",
+				"",
+				"P\"2!\"2\"\"/#"
+			])).map(__assignType((typeDef) => ` - ${String(typeDef)} ${envTypesAliasProperties.some(__assignType((prop) => prop.getNameAsString() === String(typeDef) && prop.getAlias().length > 0, [
+				"prop",
+				"",
+				"P\"2!\"/\""
+			])) ? `(Alias: ${envTypesAliasProperties?.find(__assignType((prop) => prop.getNameAsString() === String(typeDef), [
+				"prop",
+				"",
+				"P\"2!\"/\""
+			]))?.getAlias().join(", ")})` : ""}`, [
+				"typeDef",
+				"",
+				"P\"2!\"/\""
+			])).join("\n")} \n\nUsing the following env prefix: \n${context.config.env.prefix.map(__assignType((prefix$1) => ` - ${prefix$1}`, [
+				"prefix",
+				"",
+				"P\"2!\"/\""
+			])).join("\n")} \n\nPlease check your \`env\` configuration option. If you are using a custom dotenv type definition, please make sure that the configuration names match the ones in the code. \n\n`);
+		}
+	}
+	extractEnv.__type = [
+		"node",
+		() => __ΩBabelPluginPass,
+		"pass",
+		"isInjectable",
+		"extractEnv",
+		"P!2!n\"2#\"2$\"/%"
+	];
+	return {
+		visitor: { MemberExpression: __assignType(function MemberExpression(path, pass) {
+			if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isIdentifier({ name: "$storm" }) && path.get("property")?.isIdentifier()) {
+				const identifier = path.get("property")?.node;
+				extractEnv(identifier, pass, false);
+				path.replaceWithSourceString(`env.${identifier.name}`);
+				addImport(path, {
+					module: "storm:env",
+					name: "env",
+					imported: "env"
+				});
+			} else if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isCallExpression({ callee: {
+				name: "useStorm",
+				type: "Identifier"
+			} }) && path.get("property")?.isIdentifier()) {
+				const identifier = path.get("property")?.node;
+				extractEnv(identifier, pass, false);
+				path.replaceWithSourceString(`env.${identifier.name}`);
+				addImport(path, {
+					module: "storm:env",
+					name: "env",
+					imported: "env"
+				});
+			} else if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isIdentifier({ name: "process" }) && path.get("property")?.isIdentifier()) {
+				const identifier = path.get("property")?.node;
+				if (!identifier.name) return;
+				extractEnv(identifier, pass, false);
+				path.replaceWithSourceString(`env.${identifier.name}`);
+				addImport(path, {
+					module: "storm:env",
+					name: "env",
+					imported: "env"
+				});
+			} else if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isMetaProperty() && path.get("property")?.isIdentifier()) {
+				const identifier = path.get("property")?.node;
+				if (!identifier.name) return;
+				extractEnv(identifier, pass, false);
+				path.replaceWithSourceString(`env.${identifier.name}`);
+				addImport(path, {
+					module: "storm:env",
+					name: "env",
+					imported: "env"
+				});
+			}
+		}, [
+			() => NodePath,
+			"path",
+			() => __ΩBabelPluginPass,
+			"pass",
+			"MemberExpression",
+			"PP!7!2\"n#2$\"/%"
+		]) },
+		post() {
+			log(LogLevelLabel.TRACE, `Adding environment variables from ${this.filename || "unknown file"} to env.json.`);
+			let persistedEnv = ReflectionClass.from({
+				kind: ReflectionKind.objectLiteral,
+				description: `An object containing the environment variables used by the application.`,
+				types: []
+			});
+			const reflectionPath = getEnvReflectionsPath(context, "env");
+			if (reflectionPath && existsSync(reflectionPath)) {
+				log(LogLevelLabel.TRACE, `Environment reflection file found at ${reflectionPath}, reading existing reflection.`);
+				persistedEnv = resolveClassType(deserializeType(convertFromCapnp(new capnp.Message(readFileBufferSync(reflectionPath), false).getRoot(SerializedTypes).types)));
+			}
+			log(LogLevelLabel.TRACE, `Adding new variables to env reflection at ${reflectionPath}.`);
+			persistedEnv.getProperties().filter(__assignType((property) => property.getNameAsString() && !context.env.used.env.hasProperty(property.getNameAsString()), [
+				"property",
+				"",
+				"P\"2!\"/\""
+			])).forEach(__assignType((property) => {
+				context.env.used.env.addProperty({
+					...property,
+					name: property.getNameAsString(),
+					description: property.getDescription() ?? `The ${property.getNameAsString()} variable.`,
+					default: property.getDefaultValue(),
+					optional: property.isOptional() ? true : void 0,
+					readonly: property.isReadonly() ? true : void 0,
+					visibility: property.getVisibility(),
+					type: property.getType(),
+					tags: property.getTags()
+				});
+			}, [
+				"property",
+				"",
+				"P\"2!\"/\""
+			]));
+		}
+	};
+}, [
+	"param0",
+	"",
+	"P\"2!\"/\""
+])));
+
+//#endregion
+export { envBabelPlugin };

package/dist/components/docs.cjs

@@ -1,4 +1,71 @@
-require('../create-reflection-resource-BWYhmX7O.cjs');
-const require_docs = require('../docs-hBlKCRWK.cjs');
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_context = require('../plugin-alloy/src/core/contexts/context.cjs');
+const require_create_reflection_resource = require('../helpers/create-reflection-resource.cjs');
+const require_markdown_file = require('../plugin-alloy/src/markdown/components/markdown-file.cjs');
+const require_markdown_table = require('../plugin-alloy/src/markdown/components/markdown-table.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __alloy_js_core = require("@alloy-js/core");
+let __stryke_path_join = require("@stryke/path/join");
+let __alloy_js_markdown = require("@alloy-js/markdown");
 
-exports.EnvDocs = require_docs.EnvDocs;
+//#region src/components/docs.tsx
+/**
+* Generates the environment configuration markdown documentation for the Powerlines project.
+*/
+function EnvDocs() {
+	const context = require_context.usePowerlines();
+	if (!context) return null;
+	const reflection = require_create_reflection_resource.createReflectionResource(context);
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(require_markdown_file.MarkdownFile, {
+		get path() {
+			return (0, __stryke_path_join.joinPaths)(context.config.projectRoot, "docs", "generated", "env.md");
+		},
+		get children() {
+			return [
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Heading, {
+					level: 1,
+					children: "Environment Configuration"
+				}),
+				__alloy_js_core.code`Below is a list of environment variables used by the`,
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+					get when() {
+						return !!context?.packageJson.name;
+					},
+					get children() {
+						return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Link, {
+							get href() {
+								return `https://www.npmjs.com/package/${context?.packageJson.name}`;
+							},
+							get title() {
+								return context.packageJson.name;
+							}
+						});
+					}
+				}),
+				__alloy_js_core.code`package. These values can be updated in the \`.env\` file in the root of the project.`,
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Heading, {
+					level: 2,
+					children: "Environment Variables"
+				}),
+				__alloy_js_core.code`The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.`,
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(require_markdown_table.MarkdownTable, { get data() {
+					return reflection.data?.getProperties().filter((property) => property.getNameAsString() !== "__STORM_INJECTED__").sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())).map((reflectionProperty) => {
+						return {
+							name: reflectionProperty.getNameAsString().trim(),
+							description: (reflectionProperty.getDescription() ?? "").trim(),
+							type: (0, __powerlines_deepkit_vendor_type.stringifyType)(reflectionProperty.getType()).trim().replaceAll(" | ", ", or "),
+							defaultValue: reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : "",
+							required: reflectionProperty.isValueRequired() ? "" : "✔"
+						};
+					}) ?? [];
+				} })
+			];
+		}
+	});
+}
+
+//#endregion
+exports.EnvDocs = EnvDocs;

package/dist/components/docs.d.cts

@@ -1,2 +1,9 @@
-import { t as EnvDocs } from "../docs-_MmTNBQX.cjs";
+import * as _alloy_js_core0 from "@alloy-js/core";
+
+//#region src/components/docs.d.ts
+/**
+ * Generates the environment configuration markdown documentation for the Powerlines project.
+ */
+declare function EnvDocs(): _alloy_js_core0.Children;
+//#endregion
 export { EnvDocs };

package/dist/components/docs.d.mts

@@ -1,2 +1,9 @@
-import { t as EnvDocs } from "../docs-5r844zC1.mjs";
+import * as _alloy_js_core0 from "@alloy-js/core";
+
+//#region src/components/docs.d.ts
+/**
+ * Generates the environment configuration markdown documentation for the Powerlines project.
+ */
+declare function EnvDocs(): _alloy_js_core0.Children;
+//#endregion
 export { EnvDocs };

package/dist/components/docs.mjs

@@ -1,4 +1,70 @@
-import "../create-reflection-resource-BNYxBgW2.mjs";
-import { t as EnvDocs } from "../docs-B66b9li3.mjs";
+import { usePowerlines } from "../plugin-alloy/src/core/contexts/context.mjs";
+import { createReflectionResource } from "../helpers/create-reflection-resource.mjs";
+import { MarkdownFile } from "../plugin-alloy/src/markdown/components/markdown-file.mjs";
+import { MarkdownTable } from "../plugin-alloy/src/markdown/components/markdown-table.mjs";
+import { createComponent, createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { stringifyType } from "@powerlines/deepkit/vendor/type";
+import { Show, code } from "@alloy-js/core";
+import { joinPaths } from "@stryke/path/join";
+import { Heading, Link } from "@alloy-js/markdown";
 
+//#region src/components/docs.tsx
+/**
+* Generates the environment configuration markdown documentation for the Powerlines project.
+*/
+function EnvDocs() {
+	const context = usePowerlines();
+	if (!context) return null;
+	const reflection = createReflectionResource(context);
+	return createComponent(MarkdownFile, {
+		get path() {
+			return joinPaths(context.config.projectRoot, "docs", "generated", "env.md");
+		},
+		get children() {
+			return [
+				createComponent(Heading, {
+					level: 1,
+					children: "Environment Configuration"
+				}),
+				code`Below is a list of environment variables used by the`,
+				createComponent(Show, {
+					get when() {
+						return !!context?.packageJson.name;
+					},
+					get children() {
+						return createComponent(Link, {
+							get href() {
+								return `https://www.npmjs.com/package/${context?.packageJson.name}`;
+							},
+							get title() {
+								return context.packageJson.name;
+							}
+						});
+					}
+				}),
+				code`package. These values can be updated in the \`.env\` file in the root of the project.`,
+				createIntrinsic("hbr", {}),
+				createComponent(Heading, {
+					level: 2,
+					children: "Environment Variables"
+				}),
+				code`The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.`,
+				createIntrinsic("hbr", {}),
+				createComponent(MarkdownTable, { get data() {
+					return reflection.data?.getProperties().filter((property) => property.getNameAsString() !== "__STORM_INJECTED__").sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())).map((reflectionProperty) => {
+						return {
+							name: reflectionProperty.getNameAsString().trim(),
+							description: (reflectionProperty.getDescription() ?? "").trim(),
+							type: stringifyType(reflectionProperty.getType()).trim().replaceAll(" | ", ", or "),
+							defaultValue: reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : "",
+							required: reflectionProperty.isValueRequired() ? "" : "✔"
+						};
+					}) ?? [];
+				} })
+			];
+		}
+	});
+}
+
+//#endregion
 export { EnvDocs };