@powerlines/plugin-env 0.15.161 → 0.15.162

package/dist/{chunk-CNVrAnJR.cjs → _virtual/rolldown_runtime.cjs}

@@ -28,21 +28,6 @@ var __toDynamicImportESM = (isNodeMode) => (mod) => __toESM(mod.default, isNodeM
 
 //#endregion
 
-Object.defineProperty(exports, '__commonJSMin', {
-  enumerable: true,
-  get: function () {
-    return __commonJSMin;
-  }
-});
-Object.defineProperty(exports, '__toDynamicImportESM', {
-  enumerable: true,
-  get: function () {
-    return __toDynamicImportESM;
-  }
-});
-Object.defineProperty(exports, '__toESM', {
-  enumerable: true,
-  get: function () {
-    return __toESM;
-  }
-});
+exports.__commonJSMin = __commonJSMin;
+exports.__toDynamicImportESM = __toDynamicImportESM;
+exports.__toESM = __toESM;

package/dist/{chunk-CsF2CmBJ.mjs → _virtual/rolldown_runtime.mjs}

@@ -30,4 +30,4 @@ var __toDynamicImportESM = (isNodeMode) => (mod) => __toESM(mod.default, isNodeM
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 //#endregion
-export { __toESM as i, __require as n, __toDynamicImportESM as r, __commonJSMin as t };
+export { __commonJSMin, __require, __toDynamicImportESM, __toESM };

package/dist/babel/index.cjs

@@ -1,6 +1,3 @@
-require('../runtime-g0TEIoZK.cjs');
-require('../plugin-CM1TSv1B.cjs');
-const require_plugin$1 = require('../plugin-CSVnrdpE.cjs');
-require('../babel-BZqmdVF4.cjs');
+const require_babel_plugin = require('./plugin.cjs');
 
-exports.envBabelPlugin = require_plugin$1.envBabelPlugin;
+exports.envBabelPlugin = require_babel_plugin.envBabelPlugin;

package/dist/babel/index.d.cts

@@ -1,15 +1,2 @@
-import "../runtime-BDzzR4wH.cjs";
-import "../plugin-CSe5f2cD.cjs";
-import "../docs-BAKwE4PJ.cjs";
-import "../env-DwM7pJm7.cjs";
-import "../index-uTS5iDq_.cjs";
-import "../create-reflection-resource-3svZm2rY.cjs";
-import "../load-PHGmxX_X.cjs";
-import "../persistence-BR4cUaN6.cjs";
-import "../reflect-Dm8a3c29.cjs";
-import "../source-file-env-Brfopjyr.cjs";
-import "../template-helpers-zyitPfMz.cjs";
-import "../index-CEDY7cmG.cjs";
-import "../index-DSiHnMH2.cjs";
-import { t as envBabelPlugin } from "../index-Bdi8CvaN.cjs";
+import { envBabelPlugin } from "./plugin.cjs";
 export { envBabelPlugin };

package/dist/babel/index.d.mts

@@ -1,15 +1,2 @@
-import "../runtime-lYSIZdMn.mjs";
-import "../plugin-DMbVjdcQ.mjs";
-import "../docs-CVf-w8oz.mjs";
-import "../env-D0KBPuAd.mjs";
-import "../index-BNRXMhlr.mjs";
-import "../create-reflection-resource-CCpA76Yq.mjs";
-import "../load-GpP6cojj.mjs";
-import "../persistence-DrKQZNCv.mjs";
-import "../reflect-Dpz8ifa0.mjs";
-import "../source-file-env-DWejSP2U.mjs";
-import "../template-helpers-1SKodHKt.mjs";
-import "../index-dhjtMp5F.mjs";
-import "../index-CREkvfw9.mjs";
-import { t as envBabelPlugin } from "../index-Drhzdkqe.mjs";
+import { envBabelPlugin } from "./plugin.mjs";
 export { envBabelPlugin };

package/dist/babel/index.mjs

@@ -1,6 +1,3 @@
-import "../runtime-C5ukCv3P.mjs";
-import "../plugin-eBjQJP6x.mjs";
-import { t as envBabelPlugin } from "../plugin-Vyvy9w9Z.mjs";
-import "../babel-DgietUY3.mjs";
+import { envBabelPlugin } from "./plugin.mjs";
 
 export { envBabelPlugin };

package/dist/babel/plugin.cjs

@@ -1,5 +1,141 @@
-require('../runtime-g0TEIoZK.cjs');
-require('../plugin-CM1TSv1B.cjs');
-const require_plugin$1 = require('../plugin-CSVnrdpE.cjs');
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_types_plugin = require('../types/plugin.cjs');
+let powerlines_types_babel = require("powerlines/types/babel");
+let __babel_core = require("@babel/core");
+let __powerlines_deepkit_utilities = require("@powerlines/deepkit/utilities");
+let __powerlines_plugin_babel_helpers_create_plugin = require("@powerlines/plugin-babel/helpers/create-plugin");
+let __powerlines_plugin_babel_helpers_module_helpers = require("@powerlines/plugin-babel/helpers/module-helpers");
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
 
-exports.envBabelPlugin = require_plugin$1.envBabelPlugin;
+//#region src/babel/plugin.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+const envBabelPlugin = (__powerlines_plugin_babel_helpers_create_plugin.createBabelPlugin.Ω = [[() => require_types_plugin.__ΩEnvPluginContext, "n!"]], (0, __powerlines_plugin_babel_helpers_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)) {
+					log(__storm_software_config_tools_types.LogLevelLabel.DEBUG, `Adding "${name}" environment variables found in "${pass.filename || "unknown file"}" to used environment configuration reflection object.`);
+					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 (0, __powerlines_deepkit_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",
+		() => powerlines_types_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: "process" }) && path.get("property")?.isIdentifier()) {
+			const identifier = path.get("property")?.node;
+			if (!identifier.name) return;
+			extractEnv(identifier, pass, false);
+			path.replaceWithSourceString(`env.${identifier.name}`);
+			(0, __powerlines_plugin_babel_helpers_module_helpers.addImport)(path, {
+				module: `${context.config.framework || "powerlines"}: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}`);
+			(0, __powerlines_plugin_babel_helpers_module_helpers.addImport)(path, {
+				module: `${context.config.framework || "powerlines"}:env`,
+				name: "env",
+				imported: "env"
+			});
+		} else if (path.get("object")?.isIdentifier({ name: "env" }) && path.get("property")?.isIdentifier()) {
+			const identifier = path.get("property")?.node;
+			if (!identifier.name) return;
+			extractEnv(identifier, pass, false);
+		}
+	}, [
+		() => __babel_core.NodePath,
+		"path",
+		() => powerlines_types_babel.__ΩBabelPluginPass,
+		"pass",
+		"MemberExpression",
+		"PP!7!2\"n#2$\"/%"
+	]) } };
+}, [
+	"param0",
+	"",
+	"P\"2!\"/\""
+])));
+
+//#endregion
+exports.envBabelPlugin = envBabelPlugin;

package/dist/babel/plugin.d.cts

@@ -1,15 +1,9 @@
-import "../runtime-BDzzR4wH.cjs";
-import "../plugin-CSe5f2cD.cjs";
-import "../docs-BAKwE4PJ.cjs";
-import "../env-DwM7pJm7.cjs";
-import "../index-uTS5iDq_.cjs";
-import "../create-reflection-resource-3svZm2rY.cjs";
-import "../load-PHGmxX_X.cjs";
-import "../persistence-BR4cUaN6.cjs";
-import "../reflect-Dm8a3c29.cjs";
-import "../source-file-env-Brfopjyr.cjs";
-import "../template-helpers-zyitPfMz.cjs";
-import "../index-CEDY7cmG.cjs";
-import "../index-DSiHnMH2.cjs";
-import { t as envBabelPlugin } from "../index-Bdi8CvaN.cjs";
-export { envBabelPlugin };
+import { EnvPluginContext, EnvPluginResolvedConfig } from "../types/plugin.cjs";
+import "../index.cjs";
+import * as powerlines_types0 from "powerlines/types";
+
+//#region src/babel/plugin.d.ts
+declare const envBabelPlugin: powerlines_types0.DeclareBabelTransformPluginReturn<EnvPluginContext<EnvPluginResolvedConfig>, Record<string, any>>;
+//#endregion
+export { envBabelPlugin };
+//# sourceMappingURL=plugin.d.cts.map

package/dist/babel/plugin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/babel/plugin.ts"],"sourcesContent":[],"mappings":";;;;;cAkCa,gBAAc,iBAAA,CAAA,kCAAA,iBAmM1B,uBAAA,GAnM0B"}

package/dist/babel/plugin.d.mts

@@ -1,15 +1,9 @@
-import "../runtime-lYSIZdMn.mjs";
-import "../plugin-DMbVjdcQ.mjs";
-import "../docs-CVf-w8oz.mjs";
-import "../env-D0KBPuAd.mjs";
-import "../index-BNRXMhlr.mjs";
-import "../create-reflection-resource-CCpA76Yq.mjs";
-import "../load-GpP6cojj.mjs";
-import "../persistence-DrKQZNCv.mjs";
-import "../reflect-Dpz8ifa0.mjs";
-import "../source-file-env-DWejSP2U.mjs";
-import "../template-helpers-1SKodHKt.mjs";
-import "../index-dhjtMp5F.mjs";
-import "../index-CREkvfw9.mjs";
-import { t as envBabelPlugin } from "../index-Drhzdkqe.mjs";
-export { envBabelPlugin };
+import { EnvPluginContext, EnvPluginResolvedConfig } from "../types/plugin.mjs";
+import "../index.mjs";
+import * as powerlines_types0 from "powerlines/types";
+
+//#region src/babel/plugin.d.ts
+declare const envBabelPlugin: powerlines_types0.DeclareBabelTransformPluginReturn<EnvPluginContext<EnvPluginResolvedConfig>, Record<string, any>>;
+//#endregion
+export { envBabelPlugin };
+//# sourceMappingURL=plugin.d.mts.map

package/dist/babel/plugin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/babel/plugin.ts"],"sourcesContent":[],"mappings":";;;;;cAkCa,gBAAc,iBAAA,CAAA,kCAAA,iBAmM1B,uBAAA,GAnM0B"}

package/dist/babel/plugin.mjs

@@ -1,5 +1,141 @@
-import "../runtime-C5ukCv3P.mjs";
-import "../plugin-eBjQJP6x.mjs";
-import { t as envBabelPlugin } from "../plugin-Vyvy9w9Z.mjs";
+import { __ΩEnvPluginContext } from "../types/plugin.mjs";
+import { __ΩBabelPluginPass } from "powerlines/types/babel";
+import { NodePath } from "@babel/core";
+import { stringifyDefaultValue } from "@powerlines/deepkit/utilities";
+import { createBabelPlugin } from "@powerlines/plugin-babel/helpers/create-plugin";
+import { addImport } from "@powerlines/plugin-babel/helpers/module-helpers";
+import { LogLevelLabel } from "@storm-software/config-tools/types";
 
-export { envBabelPlugin };
+//#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)) {
+					log(LogLevelLabel.DEBUG, `Adding "${name}" environment variables found in "${pass.filename || "unknown file"}" to used environment configuration reflection object.`);
+					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: "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: `${context.config.framework || "powerlines"}: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: `${context.config.framework || "powerlines"}:env`,
+				name: "env",
+				imported: "env"
+			});
+		} else if (path.get("object")?.isIdentifier({ name: "env" }) && path.get("property")?.isIdentifier()) {
+			const identifier = path.get("property")?.node;
+			if (!identifier.name) return;
+			extractEnv(identifier, pass, false);
+		}
+	}, [
+		() => NodePath,
+		"path",
+		() => __ΩBabelPluginPass,
+		"pass",
+		"MemberExpression",
+		"PP!7!2\"n#2$\"/%"
+	]) } };
+}, [
+	"param0",
+	"",
+	"P\"2!\"/\""
+])));
+
+//#endregion
+export { envBabelPlugin };
+//# sourceMappingURL=plugin.mjs.map

package/dist/babel/plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/babel/plugin.ts"],"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 { NodePath } from \"@babel/core\";\nimport * as t from \"@babel/types\";\nimport { stringifyDefaultValue } from \"@powerlines/deepkit/utilities\";\n\nimport { createBabelPlugin } from \"@powerlines/plugin-babel/helpers/create-plugin\";\nimport { addImport } from \"@powerlines/plugin-babel/helpers/module-helpers\";\nimport { LogLevelLabel } from \"@storm-software/config-tools/types\";\nimport { BabelPluginPass } from \"powerlines/types/babel\";\nimport { EnvPluginContext } from \"../types/plugin\";\n\n/*\n * The Powerlines - Environment Configuration Babel Plugin\n *\n * @param babel - The Babel core module\n * @returns The Babel plugin object\n */\nexport const envBabelPlugin = createBabelPlugin<EnvPluginContext>(\n  \"env\",\n  ({ log, context }) => {\n    function extractEnv(\n      node: t.Identifier,\n      pass: BabelPluginPass,\n      isInjectable = false\n    ) {\n      const envTypesAliasProperties = context.env.types.env\n        ?.getProperties()\n        .filter(prop => prop.getAlias().length > 0);\n\n      if (node.name) {\n        const prefix = context.config.env.prefix.find(\n          pre =>\n            node.name &&\n            node.name.startsWith(pre) &&\n            (context.env.types.env?.hasProperty(\n              node.name.replace(`${pre}_`, \"\")\n            ) ||\n              envTypesAliasProperties.some(prop =>\n                prop.getAlias().includes(node.name.replace(`${pre}_`, \"\"))\n              ))\n        );\n\n        let name = node.name;\n        if (prefix) {\n          name = node.name.replace(`${prefix}_`, \"\");\n        }\n\n        log(\n          LogLevelLabel.TRACE,\n          `Environment variable ${name} found in ${\n            pass.filename || \"unknown file\"\n          }.`\n        );\n\n        if (\n          context.env.types.env?.hasProperty(name) ||\n          envTypesAliasProperties.some(prop => prop.getAlias().includes(name))\n        ) {\n          const envProperty = context.env.types.env.hasProperty(name)\n            ? context.env.types.env.getProperty(name)\n            : envTypesAliasProperties.find(prop =>\n                prop.getAlias().includes(name)\n              );\n          if (!envProperty || envProperty.isIgnored()) {\n            return;\n          }\n\n          if (!context.env.used.env.hasProperty(name)) {\n            log(\n              LogLevelLabel.DEBUG,\n              `Adding \"${name}\" environment variables found in \"${\n                pass.filename || \"unknown file\"\n              }\" to used environment configuration reflection object.`\n            );\n\n            context.env.used.env.addProperty(envProperty.property);\n          }\n\n          if (context.config.env.inject && isInjectable) {\n            let value = context.env.parsed?.[name];\n            if (value === undefined) {\n              const prefix = context.config.env.prefix.find(pre => {\n                return context.env.parsed[`${pre.replace(/_$/g, \"\")}_${name}`];\n              });\n              if (prefix) {\n                value =\n                  context.env.parsed[`${prefix.replace(/_$/g, \"\")}_${name}`];\n              }\n            }\n\n            value ??= envProperty.getDefaultValue();\n\n            if (envProperty.isValueRequired() && value === undefined) {\n              throw new Error(\n                `Environment variable \\`${name}\\` is not defined in the .env configuration files`\n              );\n            }\n\n            return stringifyDefaultValue(envProperty, value);\n          }\n        } else {\n          throw new Error(\n            `The \"${name}\" environment variable is not defined in the \\`env\\` type definition, but is used in the source code file ${\n              pass.filename ? pass.filename : \"unknown\"\n            }.\n\n          The following environment configuration names are defined in the \\`env\\` type definition: \\n${context.env.types.env\n            ?.getPropertyNames()\n            .sort((a, b) => String(a).localeCompare(String(b)))\n            .map(\n              typeDef =>\n                ` - ${String(typeDef)} ${\n                  envTypesAliasProperties.some(\n                    prop =>\n                      prop.getNameAsString() === String(typeDef) &&\n                      prop.getAlias().length > 0\n                  )\n                    ? `(Alias: ${envTypesAliasProperties\n                        ?.find(\n                          prop => prop.getNameAsString() === String(typeDef)\n                        )\n                        ?.getAlias()\n                        .join(\", \")})`\n                    : \"\"\n                }`\n            )\n            .join(\n              \"\\n\"\n            )} \\n\\nUsing the following env prefix: \\n${context.config.env.prefix\n            .map(prefix => ` - ${prefix}`)\n            .join(\n              \"\\n\"\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`\n          );\n        }\n      }\n\n      return undefined;\n    }\n\n    return {\n      visitor: {\n        MemberExpression(\n          path: NodePath<t.MemberExpression>,\n          pass: BabelPluginPass\n        ) {\n          if (\n            path\n              .get(\"object\")\n              ?.get(\"property\")\n              ?.isIdentifier({ name: \"env\" }) &&\n            path\n              .get(\"object\")\n              ?.get(\"object\")\n              ?.isIdentifier({ name: \"process\" }) &&\n            path.get(\"property\")?.isIdentifier()\n          ) {\n            // process.env.CONFIG_NAME\n\n            const identifier = path.get(\"property\")?.node as t.Identifier;\n            if (!identifier.name) {\n              return;\n            }\n\n            extractEnv(identifier, pass, false);\n\n            path.replaceWithSourceString(`env.${identifier.name}`);\n            addImport(path, {\n              module: `${context.config.framework || \"powerlines\"}:env`,\n              name: \"env\",\n              imported: \"env\"\n            });\n          } else if (\n            path\n              .get(\"object\")\n              ?.get(\"property\")\n              ?.isIdentifier({ name: \"env\" }) &&\n            path.get(\"object\")?.get(\"object\")?.isMetaProperty() &&\n            path.get(\"property\")?.isIdentifier()\n          ) {\n            // import.meta.env.CONFIG_NAME\n\n            const identifier = path.get(\"property\")?.node as t.Identifier;\n            if (!identifier.name) {\n              return;\n            }\n\n            extractEnv(identifier, pass, false);\n\n            path.replaceWithSourceString(`env.${identifier.name}`);\n            addImport(path, {\n              module: `${context.config.framework || \"powerlines\"}:env`,\n              name: \"env\",\n              imported: \"env\"\n            });\n          } else if (\n            path.get(\"object\")?.isIdentifier({ name: \"env\" }) &&\n            path.get(\"property\")?.isIdentifier()\n          ) {\n            // env.CONFIG_NAME\n\n            const identifier = path.get(\"property\")?.node as t.Identifier;\n            if (!identifier.name) {\n              return;\n            }\n\n            extractEnv(identifier, pass, false);\n          }\n        }\n      }\n    };\n  }\n);\n"],"mappings":"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"}

package/dist/components/docs.cjs

@@ -1,7 +1,67 @@
-require('../runtime-g0TEIoZK.cjs');
-require('../plugin-CM1TSv1B.cjs');
-require('../join-paths-B0RBTuuw.cjs');
-require('../docs-helper-BWe1dt1m.cjs');
-const require_docs = require('../docs-E0aCTO7H.cjs');
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_join_paths = require('../node_modules/.pnpm/@stryke_path@0.26.4/node_modules/@stryke/path/dist/join-paths.cjs');
+const require_helpers_docs_helper = require('../helpers/docs-helper.cjs');
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+let __alloy_js_markdown = require("@alloy-js/markdown");
+let __powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let __powerlines_plugin_alloy_markdown_components_markdown_file = require("@powerlines/plugin-alloy/markdown/components/markdown-file");
+let __powerlines_plugin_alloy_markdown_components_markdown_table = require("@powerlines/plugin-alloy/markdown/components/markdown-table");
 
-exports.EnvDocsFile = require_docs.EnvDocsFile;
+//#region src/components/docs.tsx
+/**
+* Generates the environment configuration markdown documentation for the Powerlines project.
+*/
+function EnvDocsFile(props) {
+	const { levelOffset = 0, reflection, ...rest } = props;
+	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_markdown_components_markdown_file.MarkdownFile, (0, __alloy_js_core_jsx_runtime.mergeProps)({ get path() {
+		return require_join_paths.joinPaths(require_helpers_docs_helper.getDocsOutputPath(context), "env.md");
+	} }, rest, { get children() {
+		return [
+			(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Heading, {
+				level: 1 + levelOffset,
+				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 + levelOffset,
+				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)(__powerlines_plugin_alloy_markdown_components_markdown_table.MarkdownTable, { get data() {
+				return reflection?.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.EnvDocsFile = EnvDocsFile;

package/dist/components/docs.d.cts

@@ -1,2 +1,25 @@
-import { n as EnvDocsFileProps, r as __ΩEnvDocsFileProps, t as EnvDocsFile } from "../docs-BAKwE4PJ.cjs";
-export { EnvDocsFile, EnvDocsFileProps, __ΩEnvDocsFileProps };
+import * as _alloy_js_core0 from "@alloy-js/core";
+import { ReflectionClass } from "@powerlines/deepkit/vendor/type";
+import { MarkdownFileProps } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
+
+//#region src/components/docs.d.ts
+interface EnvDocsFileProps extends Partial<MarkdownFileProps> {
+  /**
+   * The heading level offset to apply to the generated documentation.
+   *
+   * @remarks
+   * This is useful when nesting the documentation within other markdown files.
+   *
+   * @defaultValue 0
+   */
+  levelOffset?: number;
+  reflection: ReflectionClass<any>;
+}
+/**
+ * Generates the environment configuration markdown documentation for the Powerlines project.
+ */
+declare function EnvDocsFile(props: EnvDocsFileProps): _alloy_js_core0.Children;
+declare type __ΩEnvDocsFileProps = any[];
+//#endregion
+export { EnvDocsFile, EnvDocsFileProps, __ΩEnvDocsFileProps };
+//# sourceMappingURL=docs.d.cts.map

package/dist/components/docs.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.cts","names":[],"sources":["../../src/components/docs.tsx"],"sourcesContent":[],"mappings":";;;;;UAkCiB,gBAAA,SAAyB,QAAQ;;;AAAlD;;;;;AAiBA;;cANc;;;;;iBAME,WAAA,QAAmB,mBAAgB,eAAA,CAAA"}

package/dist/components/docs.d.mts

@@ -1,2 +1,25 @@
-import { n as EnvDocsFileProps, r as __ΩEnvDocsFileProps, t as EnvDocsFile } from "../docs-CVf-w8oz.mjs";
-export { EnvDocsFile, EnvDocsFileProps, __ΩEnvDocsFileProps };
+import { ReflectionClass } from "@powerlines/deepkit/vendor/type";
+import * as _alloy_js_core0 from "@alloy-js/core";
+import { MarkdownFileProps } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
+
+//#region src/components/docs.d.ts
+interface EnvDocsFileProps extends Partial<MarkdownFileProps> {
+  /**
+   * The heading level offset to apply to the generated documentation.
+   *
+   * @remarks
+   * This is useful when nesting the documentation within other markdown files.
+   *
+   * @defaultValue 0
+   */
+  levelOffset?: number;
+  reflection: ReflectionClass<any>;
+}
+/**
+ * Generates the environment configuration markdown documentation for the Powerlines project.
+ */
+declare function EnvDocsFile(props: EnvDocsFileProps): _alloy_js_core0.Children;
+declare type __ΩEnvDocsFileProps = any[];
+//#endregion
+export { EnvDocsFile, EnvDocsFileProps, __ΩEnvDocsFileProps };
+//# sourceMappingURL=docs.d.mts.map

package/dist/components/docs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.mts","names":[],"sources":["../../src/components/docs.tsx"],"sourcesContent":[],"mappings":";;;;;UAkCiB,gBAAA,SAAyB,QAAQ;;;AAAlD;;;;;AAiBA;;cANc;;;;;iBAME,WAAA,QAAmB,mBAAgB,eAAA,CAAA"}