@powerlines/plugin-env 0.16.84 → 0.16.86

package/dist/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1,29 @@
+//#region \0rolldown/runtime.js
+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/_virtual/_rolldown/runtime.mjs

@@ -0,0 +1,3 @@
+import "node:module";
+
+export {  };

package/dist/babel/index.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_babel_plugin = require('./plugin.cjs');
+
+exports.envBabelPlugin = require_babel_plugin.envBabelPlugin;

package/dist/babel/index.d.cts

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

package/dist/babel/index.d.mts

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

package/dist/babel/index.mjs

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

package/dist/babel/plugin.cjs

@@ -0,0 +1,144 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_types_plugin = require('../types/plugin.cjs');
+let _powerlines_plugin_babel_types_config = require("@powerlines/plugin-babel/types/config");
+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");
+
+//#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, isUsingBuiltin = 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 = context.config.env.prefix.find(__assignType((pre) => {
+							return context.env.parsed[`${pre.replace(/_$/g, "")}_${name}`];
+						}, [
+							"pre",
+							"",
+							"P\"2!\"/\""
+						]));
+						if (prefix) value = context.env.parsed[`${prefix.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 if (context.config.env.validate) 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) => ` - ${prefix}`, [
+				"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`);
+			else if (pass.filename && isUsingBuiltin) context.warn(`The "${name}" environment variable is used in the source code file ${pass.filename}, but is not defined in the \`env\` type definition. If this is intentional, you can ignore this warning. Otherwise, please 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.`);
+		}
+	}
+	extractEnv.__type = [
+		"node",
+		() => _powerlines_plugin_babel_types_config.__ΩBabelPluginPass,
+		"pass",
+		"isInjectable",
+		"isUsingBuiltin",
+		"extractEnv",
+		"P!2!n\"2#\"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, 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, 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, true);
+		}
+	}, [
+		() => _babel_core.NodePath,
+		"path",
+		() => _powerlines_plugin_babel_types_config.__ΩBabelPluginPass,
+		"pass",
+		"MemberExpression",
+		"PP!7!2\"n#2$\"/%"
+	]) } };
+}, [
+	"param0",
+	"",
+	"P\"2!\"/\""
+])));
+
+//#endregion
+exports.envBabelPlugin = envBabelPlugin;

package/dist/babel/plugin.d.cts

@@ -0,0 +1,8 @@
+import { EnvPluginContext, EnvPluginResolvedConfig } from "../types/plugin.cjs";
+import * as _powerlines_plugin_babel0 from "@powerlines/plugin-babel";
+
+//#region src/babel/plugin.d.ts
+declare const envBabelPlugin: _powerlines_plugin_babel0.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"],"mappings":";;;;cAiCa,cAAA,EAAc,yBAAA,CAAA,iCAAA,CAAA,gBAAA,CA4M1B,uBAAA,GA5M0B,MAAA"}

package/dist/babel/plugin.d.mts

@@ -0,0 +1,8 @@
+import { EnvPluginContext, EnvPluginResolvedConfig } from "../types/plugin.mjs";
+import * as _powerlines_plugin_babel0 from "@powerlines/plugin-babel";
+
+//#region src/babel/plugin.d.ts
+declare const envBabelPlugin: _powerlines_plugin_babel0.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"],"mappings":";;;;cAiCa,cAAA,EAAc,yBAAA,CAAA,iCAAA,CAAA,gBAAA,CA4M1B,uBAAA,GA5M0B,MAAA"}

package/dist/babel/plugin.mjs

@@ -0,0 +1,143 @@
+import { __ΩEnvPluginContext } from "../types/plugin.mjs";
+import { __ΩBabelPluginPass } from "@powerlines/plugin-babel/types/config";
+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";
+
+//#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, isUsingBuiltin = 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 = context.config.env.prefix.find(__assignType((pre) => {
+							return context.env.parsed[`${pre.replace(/_$/g, "")}_${name}`];
+						}, [
+							"pre",
+							"",
+							"P\"2!\"/\""
+						]));
+						if (prefix) value = context.env.parsed[`${prefix.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 if (context.config.env.validate) 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) => ` - ${prefix}`, [
+				"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`);
+			else if (pass.filename && isUsingBuiltin) context.warn(`The "${name}" environment variable is used in the source code file ${pass.filename}, but is not defined in the \`env\` type definition. If this is intentional, you can ignore this warning. Otherwise, please 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.`);
+		}
+	}
+	extractEnv.__type = [
+		"node",
+		() => __ΩBabelPluginPass,
+		"pass",
+		"isInjectable",
+		"isUsingBuiltin",
+		"extractEnv",
+		"P!2!n\"2#\"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, 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, 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, true);
+		}
+	}, [
+		() => 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\";\nimport { createBabelPlugin } from \"@powerlines/plugin-babel/helpers/create-plugin\";\nimport { addImport } from \"@powerlines/plugin-babel/helpers/module-helpers\";\nimport { BabelPluginPass } from \"@powerlines/plugin-babel/types/config\";\nimport { LogLevelLabel } from \"@storm-software/config-tools/types\";\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      isUsingBuiltin = 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 if (context.config.env.validate) {\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        } else if (pass.filename && isUsingBuiltin) {\n          context.warn(\n            `The \"${\n              name\n            }\" environment variable is used in the source code file ${\n              pass.filename\n            }, but is not defined in the \\`env\\` type definition. If this is intentional, you can ignore this warning. Otherwise, please 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      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, 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, 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, true);\n          }\n        }\n      }\n    };\n  }\n);\n"],"mappings":"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"}

package/dist/components/docs.cjs

@@ -0,0 +1,70 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_helpers_docs_helper = require('../helpers/docs-helper.cjs');
+let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let _stryke_path_join = require("@stryke/path/join");
+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_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
+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");
+
+//#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 (0, _stryke_path_join.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.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+			(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+				level: 2 + levelOffset,
+				children: "Environment Variables"
+			}),
+			(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+			_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.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+			(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_markdown_components_markdown_table.MarkdownTable, { get data() {
+				return reflection?.getProperties().filter((property) => property.getNameAsString() !== "__POWERLINES_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

@@ -0,0 +1,25 @@
+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"],"mappings":";;;;;UAmCiB,gBAAA,SAAyB,OAAA,CAAQ,iBAAA;;;AAAlD;;;;;;EASE,WAAA;EAEA,UAAA,EAAY,eAAA;AAAA;;;;iBAME,WAAA,CAAY,KAAA,EAAO,gBAAA,GAAgB,eAAA,CAAA,QAAA;AAAA"}

package/dist/components/docs.d.mts

@@ -0,0 +1,25 @@
+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"],"mappings":";;;;;UAmCiB,gBAAA,SAAyB,OAAA,CAAQ,iBAAA;;;AAAlD;;;;;;EASE,WAAA;EAEA,UAAA,EAAY,eAAA;AAAA;;;;iBAME,WAAA,CAAY,KAAA,EAAO,gBAAA,GAAgB,eAAA,CAAA,QAAA;AAAA"}

package/dist/components/docs.mjs

@@ -0,0 +1,69 @@
+import { getDocsOutputPath } from "../helpers/docs-helper.mjs";
+import { stringifyType } from "@powerlines/deepkit/vendor/type";
+import { joinPaths } from "@stryke/path/join";
+import { createComponent, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { Show, code } from "@alloy-js/core";
+import { Heading, Link } from "@alloy-js/markdown";
+import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { MarkdownFile } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
+import { MarkdownTable } from "@powerlines/plugin-alloy/markdown/components/markdown-table";
+
+//#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 = usePowerlines();
+	return createComponent(MarkdownFile, mergeProps({ get path() {
+		return joinPaths(getDocsOutputPath(context), "env.md");
+	} }, rest, { get children() {
+		return [
+			createComponent(Heading, {
+				level: 1 + levelOffset,
+				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.`,
+			createComponent(Spacing, {}),
+			createComponent(Heading, {
+				level: 2 + levelOffset,
+				children: "Environment Variables"
+			}),
+			createComponent(Spacing, {}),
+			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.`,
+			createComponent(Spacing, {}),
+			createComponent(MarkdownTable, { get data() {
+				return reflection?.getProperties().filter((property) => property.getNameAsString() !== "__POWERLINES_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 { EnvDocsFile };
+//# sourceMappingURL=docs.mjs.map

package/dist/components/docs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.mjs","names":[],"sources":["../../src/components/docs.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, Show } from \"@alloy-js/core\";\nimport { Heading, Link } from \"@alloy-js/markdown\";\nimport {\n  ReflectionClass,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport {\n  MarkdownFile,\n  MarkdownFileProps\n} from \"@powerlines/plugin-alloy/markdown/components/markdown-file\";\nimport { MarkdownTable } from \"@powerlines/plugin-alloy/markdown/components/markdown-table\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { getDocsOutputPath } from \"../helpers/docs-helper\";\nimport { EnvPluginContext } from \"../types/plugin\";\n\nexport interface EnvDocsFileProps extends Partial<MarkdownFileProps> {\n  /**\n   * The heading level offset to apply to the generated documentation.\n   *\n   * @remarks\n   * This is useful when nesting the documentation within other markdown files.\n   *\n   * @defaultValue 0\n   */\n  levelOffset?: number;\n\n  reflection: ReflectionClass<any>;\n}\n\n/**\n * Generates the environment configuration markdown documentation for the Powerlines project.\n */\nexport function EnvDocsFile(props: EnvDocsFileProps) {\n  const { levelOffset = 0, reflection, ...rest } = props;\n\n  const context = usePowerlines<EnvPluginContext>();\n\n  return (\n    <MarkdownFile\n      path={joinPaths(getDocsOutputPath(context), \"env.md\")}\n      {...rest}>\n      <Heading level={1 + levelOffset}>Environment Configuration</Heading>\n      {code`Below is a list of environment variables used by the`}\n      <Show when={!!context.packageJson.name}>\n        <Link\n          href={`https://www.npmjs.com/package/${context.packageJson.name}`}\n          title={context.packageJson.name!}\n        />\n      </Show>\n      {code`package. These values can be updated in the \\`.env\\` file in the root of the project.`}\n      <Spacing />\n      <Heading level={2 + levelOffset}>Environment Variables</Heading>\n      <Spacing />\n      {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.`}\n      <Spacing />\n      <MarkdownTable\n        data={\n          reflection\n            ?.getProperties()\n            .filter(\n              property =>\n                property.getNameAsString() !== \"__POWERLINES_INJECTED__\"\n            )\n            .sort((a, b) =>\n              a.getNameAsString().localeCompare(b.getNameAsString())\n            )\n            .map(reflectionProperty => {\n              return {\n                name: reflectionProperty.getNameAsString().trim(),\n                description: (reflectionProperty.getDescription() ?? \"\").trim(),\n                type: stringifyType(reflectionProperty.getType())\n                  .trim()\n                  .replaceAll(\" | \", \", or \"),\n                defaultValue: reflectionProperty.hasDefault()\n                  ? String(reflectionProperty.getDefaultValue())?.includes('\"')\n                    ? reflectionProperty.getDefaultValue()\n                    : `\\`${reflectionProperty.getDefaultValue()}\\``\n                  : \"\",\n                required: reflectionProperty.isValueRequired() ? \"\" : \"✔\"\n              };\n            }) ?? []\n        }\n      />\n    </MarkdownFile>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;CA8CE,MAAA,EACF,cAAA,eAEE,GAAA,SACC;CACD,MAAA,UAAA,eAAA;AACF,QAAO,gBAAoB,cAAQ,WAAkB,EACnD,IAAM,OAAE;;cAIR,IAAM,WAAC;AACJ,SAAA;GAAA,gBAAA,SAAA;IACC,OAAM,IAAA;IACJ,UAAO;IACR,CAAA;GAAA,IAAO;GAAoD,gBAAO,MAAA;IAClE,IAAK,OAAM;AACX,YAAU,CAAC,CAAC,QAAQ,YAAY;;IAE/B,IAAE,WAAa;AACb,YAAO,gBAAQ,MAAgB;MAChC,IAAA,OAAA;AACG,cAAA,iCAAA,QAAA,YAAA;;MAEL,IAAS,QAAA;AACF,cAAO,QAAK,YAAa;;MAE5B,CAAC;;IAEL,CAAA;GAAA,IAAA;GAAA,gBAAA,SAAA,EAAA,CAAA;GAAA,gBAAA,SAAA;IACC,OAAK,IAAA;IACL,UAAE;IACH,CAAC;GAAE,gBAAkB,SAAA,EAAA,CAAA;GAAA,IAAA;GAAA,gBAAA,SAAA,EAAA,CAAA;GAAA,gBAAA,eAAA,EACpB,IAAI,OAAO;AACT,WAAI,YAAU,eAAA,CAAA,QAAA,aAAA,SAAA,iBAAA,KAAA,0BAAA,CAAA,MAAA,GAAA,MAAA,EAAA,iBAAA,CAAA,cAAA,EAAA,iBAAA,CAAA,CAAA,CAAA,KAAA,uBAAA;AACZ,YAAI;MACJ,MAAA,mBAAA,iBAAA,CAAA,MAAA;MACC,cAAa,mBAAA,gBAAA,IAAA,IAAA,MAAA;MACZ,MAAE,cAAkB,mBAAgB,SAAA,CAAA,CAAA,MAAiB,CAAA,WAAA,OAAA,QAAA;MACvD,cAAA,mBAAA,YAAA,GAAA,OAAA,mBAAA,iBAAA,CAAA,EAAA,SAAA,KAAA,GAAA,mBAAA,iBAAA,GAAA,KAAA,mBAAA,iBAAA,CAAA,MAAA;MACC,UAAI,mBAAsB,iBAAA,GAAA,KAAA;MAC1B;MACD,IAAI,EAAA;MAET,CAAC;GAAC;IAEN,CAAC,CAAC"}