@powerlines/plugin-env 0.16.183 → 0.16.184

package/dist/_virtual/_rolldown/runtime.cjs

@@ -1 +1,29 @@
-var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));exports.__toESM=s;
+//#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/babel/index.cjs

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

package/dist/babel/index.mjs

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

package/dist/babel/plugin.cjs

@@ -1,5 +1,138 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../types/plugin.cjs`);let t=require(`@powerlines/deepkit/utilities`),n=require(`@powerlines/plugin-babel/helpers/create-plugin`),r=require(`@powerlines/plugin-babel/helpers/module-helpers`);function i(e,t){return e.__type=t,e}const a=(n.createBabelPlugin.Ω=[[()=>e.__ΩEnvPluginContext,`n!`]],(0,n.createBabelPlugin)(`env`,i(({logger:e,context:n})=>{function a(r,a,o=!1,s=!1){let c=n.env.types.env?.getProperties().filter(i(e=>e.getAlias().length>0,[`prop`,``,`P"2!"/"`]));if(r.name){let l=r.name.replace(RegExp(`^(${n.config.env.prefix.join(`|`)})_`),``);if(e.trace({meta:{category:`env`},message:`Environment variable ${l} found in ${a.filename||`unknown file`}.`}),n.env.types.env?.hasProperty(l)||c.some(i(e=>e.getAlias().includes(l),[`prop`,``,`P"2!"/"`]))){let r=n.env.types.env.hasProperty(l)?n.env.types.env.getProperty(l):c.find(i(e=>e.getAlias().includes(l),[`prop`,``,`P"2!"/"`]));if(!r||r.isIgnored())return;if(n.env.used.env.hasProperty(l)||(e.debug({meta:{category:`env`},message:`Adding "${l}" environment variables found in "${a.filename||`unknown file`}" to used environment configuration reflection object.`}),n.env.used.env.addProperty(r.property)),n.config.env.inject&&o){let e=n.env.parsed?.[l];if(e===void 0){let t=n.config.env.prefix.find(i(e=>n.env.parsed[`${e.replace(/_$/g,``)}_${l}`],[`pre`,``,`P"2!"/"`]));t&&(e=n.env.parsed[`${t.replace(/_$/g,``)}_${l}`])}if(e??=r.getDefaultValue(),r.isValueRequired()&&e===void 0)throw Error(`Environment variable \`${l}\` is not defined in the .env configuration files`);return(0,t.stringifyDefaultValue)(r,e)}}else if(n.config.env.validate)throw Error(`The "${l}" environment variable is not defined in the \`env\` type definition, but is used in the source code file ${a.filename?a.filename:`unknown`}.
+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_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");
 
-          The following environment configuration names are defined in the \`env\` type definition: \n${n.env.types.env?.getPropertyNames().sort(i((e,t)=>String(e).localeCompare(String(t)),[`a`,`b`,``,`P"2!"2""/#`])).map(i(e=>` - ${String(e)} ${c.some(i(t=>t.getNameAsString()===String(e)&&t.getAlias().length>0,[`prop`,``,`P"2!"/"`]))?`(Alias: ${c?.find(i(t=>t.getNameAsString()===String(e),[`prop`,``,`P"2!"/"`]))?.getAlias().join(`, `)})`:``}`,[`typeDef`,``,`P"2!"/"`])).join(`
-`)} \n\nUsing the following env prefix: \n${n.config.env.prefix.map(i(e=>` - ${e}`,[`prefix`,``,`P"2!"/"`])).join(`
-`)} \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 a.filename&&s&&e.warn({meta:{category:`env`},message:`The "${l}" environment variable is used in the source code file ${a.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.`})}}return a.__type=[`node`,`pass`,`isInjectable`,`isUsingBuiltin`,`extractEnv`,`P!2!!2""2#"2$"/%`],{visitor:{MemberExpression:i(function(e,t){if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isIdentifier({name:`process`})&&e.get(`property`)?.isIdentifier()){let i=e.get(`property`)?.node;if(!i.name)return;a(i,t,!1,!1),e.replaceWithSourceString(`env.${i.name}`),(0,r.addImport)(e,{module:`${n.config.framework||`powerlines`}:env`,name:`env`,imported:`env`})}else if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isMetaProperty()&&e.get(`property`)?.isIdentifier()){let i=e.get(`property`)?.node;if(!i.name)return;a(i,t,!1,!1),e.replaceWithSourceString(`env.${i.name}`),(0,r.addImport)(e,{module:`${n.config.framework||`powerlines`}:env`,name:`env`,imported:`env`})}else if(e.get(`object`)?.isIdentifier({name:`env`})&&e.get(`property`)?.isIdentifier()){let n=e.get(`property`)?.node;if(!n.name)return;a(n,t,!1,!0)}},[`NodePath`,`path`,`pass`,`MemberExpression`,`P"w!2"!2#"/$`])}}},[`param0`,``,`P"2!"/"`])));exports.envBabelPlugin=a;
+//#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(({ logger, 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 name = node.name.replace(new RegExp(`^(${context.config.env.prefix.join("|")})_`), "");
+			logger.trace({
+				meta: { category: "env" },
+				message: `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)) {
+					logger.debug({
+						meta: { category: "env" },
+						message: `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) logger.warn({
+				meta: { category: "env" },
+				message: `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",
+		"pass",
+		"isInjectable",
+		"isUsingBuiltin",
+		"extractEnv",
+		"P!2!!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);
+		}
+	}, [
+		"NodePath",
+		"path",
+		"pass",
+		"MemberExpression",
+		"P\"w!2\"!2#\"/$"
+	]) } };
+}, [
+	"param0",
+	"",
+	"P\"2!\"/\""
+])));
+
+//#endregion
+exports.envBabelPlugin = envBabelPlugin;

package/dist/babel/plugin.mjs

@@ -1,6 +1,137 @@
-import{__ΩEnvPluginContext as e}from"../types/plugin.mjs";import{stringifyDefaultValue as t}from"@powerlines/deepkit/utilities";import{createBabelPlugin as n}from"@powerlines/plugin-babel/helpers/create-plugin";import{addImport as r}from"@powerlines/plugin-babel/helpers/module-helpers";function i(e,t){return e.__type=t,e}const a=(n.Ω=[[()=>e,`n!`]],n(`env`,i(({logger:e,context:n})=>{function a(r,a,o=!1,s=!1){let c=n.env.types.env?.getProperties().filter(i(e=>e.getAlias().length>0,[`prop`,``,`P"2!"/"`]));if(r.name){let l=r.name.replace(RegExp(`^(${n.config.env.prefix.join(`|`)})_`),``);if(e.trace({meta:{category:`env`},message:`Environment variable ${l} found in ${a.filename||`unknown file`}.`}),n.env.types.env?.hasProperty(l)||c.some(i(e=>e.getAlias().includes(l),[`prop`,``,`P"2!"/"`]))){let r=n.env.types.env.hasProperty(l)?n.env.types.env.getProperty(l):c.find(i(e=>e.getAlias().includes(l),[`prop`,``,`P"2!"/"`]));if(!r||r.isIgnored())return;if(n.env.used.env.hasProperty(l)||(e.debug({meta:{category:`env`},message:`Adding "${l}" environment variables found in "${a.filename||`unknown file`}" to used environment configuration reflection object.`}),n.env.used.env.addProperty(r.property)),n.config.env.inject&&o){let e=n.env.parsed?.[l];if(e===void 0){let t=n.config.env.prefix.find(i(e=>n.env.parsed[`${e.replace(/_$/g,``)}_${l}`],[`pre`,``,`P"2!"/"`]));t&&(e=n.env.parsed[`${t.replace(/_$/g,``)}_${l}`])}if(e??=r.getDefaultValue(),r.isValueRequired()&&e===void 0)throw Error(`Environment variable \`${l}\` is not defined in the .env configuration files`);return t(r,e)}}else if(n.config.env.validate)throw Error(`The "${l}" environment variable is not defined in the \`env\` type definition, but is used in the source code file ${a.filename?a.filename:`unknown`}.
+import { __ΩEnvPluginContext } from "../types/plugin.mjs";
+import { stringifyDefaultValue } from "@powerlines/deepkit/utilities";
+import { createBabelPlugin } from "@powerlines/plugin-babel/helpers/create-plugin";
+import { addImport } from "@powerlines/plugin-babel/helpers/module-helpers";
 
-          The following environment configuration names are defined in the \`env\` type definition: \n${n.env.types.env?.getPropertyNames().sort(i((e,t)=>String(e).localeCompare(String(t)),[`a`,`b`,``,`P"2!"2""/#`])).map(i(e=>` - ${String(e)} ${c.some(i(t=>t.getNameAsString()===String(e)&&t.getAlias().length>0,[`prop`,``,`P"2!"/"`]))?`(Alias: ${c?.find(i(t=>t.getNameAsString()===String(e),[`prop`,``,`P"2!"/"`]))?.getAlias().join(`, `)})`:``}`,[`typeDef`,``,`P"2!"/"`])).join(`
-`)} \n\nUsing the following env prefix: \n${n.config.env.prefix.map(i(e=>` - ${e}`,[`prefix`,``,`P"2!"/"`])).join(`
-`)} \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 a.filename&&s&&e.warn({meta:{category:`env`},message:`The "${l}" environment variable is used in the source code file ${a.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.`})}}return a.__type=[`node`,`pass`,`isInjectable`,`isUsingBuiltin`,`extractEnv`,`P!2!!2""2#"2$"/%`],{visitor:{MemberExpression:i(function(e,t){if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isIdentifier({name:`process`})&&e.get(`property`)?.isIdentifier()){let i=e.get(`property`)?.node;if(!i.name)return;a(i,t,!1,!1),e.replaceWithSourceString(`env.${i.name}`),r(e,{module:`${n.config.framework||`powerlines`}:env`,name:`env`,imported:`env`})}else if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isMetaProperty()&&e.get(`property`)?.isIdentifier()){let i=e.get(`property`)?.node;if(!i.name)return;a(i,t,!1,!1),e.replaceWithSourceString(`env.${i.name}`),r(e,{module:`${n.config.framework||`powerlines`}:env`,name:`env`,imported:`env`})}else if(e.get(`object`)?.isIdentifier({name:`env`})&&e.get(`property`)?.isIdentifier()){let n=e.get(`property`)?.node;if(!n.name)return;a(n,t,!1,!0)}},[`NodePath`,`path`,`pass`,`MemberExpression`,`P"w!2"!2#"/$`])}}},[`param0`,``,`P"2!"/"`])));export{a as envBabelPlugin};
+//#region src/babel/plugin.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+const envBabelPlugin = (createBabelPlugin.Ω = [[() => __ΩEnvPluginContext, "n!"]], createBabelPlugin("env", __assignType(({ logger, 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 name = node.name.replace(new RegExp(`^(${context.config.env.prefix.join("|")})_`), "");
+			logger.trace({
+				meta: { category: "env" },
+				message: `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)) {
+					logger.debug({
+						meta: { category: "env" },
+						message: `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) logger.warn({
+				meta: { category: "env" },
+				message: `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",
+		"pass",
+		"isInjectable",
+		"isUsingBuiltin",
+		"extractEnv",
+		"P!2!!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",
+		"pass",
+		"MemberExpression",
+		"P\"w!2\"!2#\"/$"
+	]) } };
+}, [
+	"param0",
+	"",
+	"P\"2!\"/\""
+])));
+
+//#endregion
+export { envBabelPlugin };
 //# sourceMappingURL=plugin.mjs.map

package/dist/babel/plugin.mjs.map

@@ -1 +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 { 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  ({ logger, 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 name = node.name.replace(\n          new RegExp(`^(${context.config.env.prefix.join(\"|\")})_`),\n          \"\"\n        );\n\n        logger.trace({\n          meta: {\n            category: \"env\"\n          },\n          message: `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            logger.debug({\n              meta: {\n                category: \"env\"\n              },\n              message: `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          logger.warn({\n            meta: {\n              category: \"env\"\n            },\n            message: `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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"}
+{"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 { 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  ({ logger, 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 name = node.name.replace(\n          new RegExp(`^(${context.config.env.prefix.join(\"|\")})_`),\n          \"\"\n        );\n\n        logger.trace({\n          meta: {\n            category: \"env\"\n          },\n          message: `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            logger.debug({\n              meta: {\n                category: \"env\"\n              },\n              message: `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          logger.warn({\n            meta: {\n              category: \"env\"\n            },\n            message: `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

@@ -1 +1,111 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../types/plugin.cjs`);let t=require(`@powerlines/deepkit/vendor/type`),n=require(`powerlines/plugin-utils`),r=require(`@alloy-js/core/jsx-runtime`),i=require(`@alloy-js/core`),a=require(`@alloy-js/markdown`),o=require(`@powerlines/plugin-alloy/core/components/spacing`),s=require(`@powerlines/plugin-alloy/core/contexts/context`),c=require(`@powerlines/plugin-alloy/markdown/components/heading`),l=require(`@powerlines/plugin-alloy/markdown/components/markdown-file`),u=require(`@powerlines/plugin-alloy/markdown/components/markdown-table`),d=require(`@stryke/path/join`);const f=[`T`,`Partial`,`l+e#!e"!fRb!Pde"!gN#"w"y`];function p(e,t){return e.__type=t,e}const m=[()=>f,`levelOffset`,0,`The heading level offset to apply to the generated documentation.`,`reflection`,`EnvDocsFileProps`,`P!o!"'4"8>#?$!4%Mw&y`];function h(f){let{levelOffset:m=0,reflection:h,...g}=f,_=(s.usePowerlines.Ω=[[()=>e.__ΩEnvPluginContext,`n!`]],(0,s.usePowerlines)());return(0,r.createComponent)(l.MarkdownFile,(0,r.mergeProps)({get path(){return(0,d.joinPaths)((0,n.getDocsOutputPath)(_.config.root),`env.md`)}},g,{get children(){return[(0,r.createComponent)(c.Heading,{level:1+m,children:`Environment Configuration`}),i.code`Below is a list of environment variables used by the`,(0,r.createComponent)(i.Show,{get when(){return!!_.packageJson.name},get children(){return(0,r.createComponent)(a.Link,{get href(){return`https://www.npmjs.com/package/${_.packageJson.name}`},get title(){return _.packageJson.name}})}}),i.code`package. These values can be updated in the \`.env\` file in the root of the project.`,(0,r.createComponent)(o.Spacing,{}),(0,r.createComponent)(c.Heading,{level:2+m,children:`Environment Variables`}),(0,r.createComponent)(o.Spacing,{}),i.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.`,(0,r.createComponent)(o.Spacing,{}),(0,r.createComponent)(u.MarkdownTable,{get data(){return h?.getProperties().filter(p(e=>!e.isHidden()&&!e.isIgnored()&&!e.isReadonly()&&!e.isInternal(),[`property`,``,`P"2!"/"`])).sort(p((e,t)=>e.getNameAsString().localeCompare(t.getNameAsString()),[`a`,`b`,``,`P"2!"2""/#`])).map(p(e=>({name:e.getNameAsString().trim(),description:(e.getDescription()??``).trim(),type:(0,t.stringifyType)(e.getType()).trim().replaceAll(/\s*(?:\||&)\s*/g,`, or `),defaultValue:e.hasDefault()?String(e.getDefaultValue())?.includes(`"`)?e.getDefaultValue():`\`${e.getDefaultValue()}\``:``,required:e.isValueRequired()?``:`✔`}),[`reflectionProperty`,``,`P"2!"/"`]))??[]}})]}}))}h.__type=[()=>m,`props`,`EnvDocsFile`,`Generates the environment configuration markdown documentation for the Powerlines project.`,`Pn!2""/#?$`],exports.EnvDocsFile=h,exports.__ΩEnvDocsFileProps=m;
+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_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let powerlines_plugin_utils = require("powerlines/plugin-utils");
+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_heading = require("@powerlines/plugin-alloy/markdown/components/heading");
+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");
+let _stryke_path_join = require("@stryke/path/join");
+
+//#region src/components/docs.tsx
+const __ΩPartial = [
+	"T",
+	"Partial",
+	"l+e#!e\"!fRb!Pde\"!gN#\"w\"y"
+];
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+const __ΩEnvDocsFileProps = [
+	() => __ΩPartial,
+	"levelOffset",
+	0,
+	"The heading level offset to apply to the generated documentation.",
+	"reflection",
+	"EnvDocsFileProps",
+	"P!o!\"'4\"8>#?$!4%Mw&y"
+];
+/**
+* Generates the environment configuration markdown documentation for the Powerlines project.
+*/
+function EnvDocsFile(props) {
+	const { levelOffset = 0, reflection, ...rest } = props;
+	const context = (_powerlines_plugin_alloy_core_contexts_context.usePowerlines.Ω = [[() => require_types_plugin.__ΩEnvPluginContext, "n!"]], (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)((0, powerlines_plugin_utils.getDocsOutputPath)(context.config.root), "env.md");
+	} }, rest, { get children() {
+		return [
+			(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_markdown_components_heading.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)(_powerlines_plugin_alloy_markdown_components_heading.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.`,
+			(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(__assignType((property) => !property.isHidden() && !property.isIgnored() && !property.isReadonly() && !property.isInternal(), [
+					"property",
+					"",
+					"P\"2!\"/\""
+				])).sort(__assignType((a, b) => a.getNameAsString().localeCompare(b.getNameAsString()), [
+					"a",
+					"b",
+					"",
+					"P\"2!\"2\"\"/#"
+				])).map(__assignType((reflectionProperty) => {
+					return {
+						name: reflectionProperty.getNameAsString().trim(),
+						description: (reflectionProperty.getDescription() ?? "").trim(),
+						type: (0, _powerlines_deepkit_vendor_type.stringifyType)(reflectionProperty.getType()).trim().replaceAll(/\s*(?:\||&)\s*/g, ", or "),
+						defaultValue: reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : "",
+						required: reflectionProperty.isValueRequired() ? "" : "✔"
+					};
+				}, [
+					"reflectionProperty",
+					"",
+					"P\"2!\"/\""
+				])) ?? [];
+			} })
+		];
+	} }));
+}
+EnvDocsFile.__type = [
+	() => __ΩEnvDocsFileProps,
+	"props",
+	"EnvDocsFile",
+	"Generates the environment configuration markdown documentation for the Powerlines project.",
+	"Pn!2\"\"/#?$"
+];
+
+//#endregion
+exports.EnvDocsFile = EnvDocsFile;
+exports.__ΩEnvDocsFileProps = __ΩEnvDocsFileProps;

package/dist/components/docs.mjs

@@ -1,2 +1,109 @@
-import{__ΩEnvPluginContext as e}from"../types/plugin.mjs";import{stringifyType as t}from"@powerlines/deepkit/vendor/type";import{getDocsOutputPath as n}from"powerlines/plugin-utils";import{createComponent as r,mergeProps as i}from"@alloy-js/core/jsx-runtime";import{Show as a,code as o}from"@alloy-js/core";import{Link as s}from"@alloy-js/markdown";import{Spacing as c}from"@powerlines/plugin-alloy/core/components/spacing";import{usePowerlines as l}from"@powerlines/plugin-alloy/core/contexts/context";import{Heading as u}from"@powerlines/plugin-alloy/markdown/components/heading";import{MarkdownFile as d}from"@powerlines/plugin-alloy/markdown/components/markdown-file";import{MarkdownTable as f}from"@powerlines/plugin-alloy/markdown/components/markdown-table";import{joinPaths as p}from"@stryke/path/join";const m=[`T`,`Partial`,`l+e#!e"!fRb!Pde"!gN#"w"y`];function h(e,t){return e.__type=t,e}const g=[()=>m,`levelOffset`,0,`The heading level offset to apply to the generated documentation.`,`reflection`,`EnvDocsFileProps`,`P!o!"'4"8>#?$!4%Mw&y`];function _(m){let{levelOffset:g=0,reflection:_,...v}=m,y=(l.Ω=[[()=>e,`n!`]],l());return r(d,i({get path(){return p(n(y.config.root),`env.md`)}},v,{get children(){return[r(u,{level:1+g,children:`Environment Configuration`}),o`Below is a list of environment variables used by the`,r(a,{get when(){return!!y.packageJson.name},get children(){return r(s,{get href(){return`https://www.npmjs.com/package/${y.packageJson.name}`},get title(){return y.packageJson.name}})}}),o`package. These values can be updated in the \`.env\` file in the root of the project.`,r(c,{}),r(u,{level:2+g,children:`Environment Variables`}),r(c,{}),o`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.`,r(c,{}),r(f,{get data(){return _?.getProperties().filter(h(e=>!e.isHidden()&&!e.isIgnored()&&!e.isReadonly()&&!e.isInternal(),[`property`,``,`P"2!"/"`])).sort(h((e,t)=>e.getNameAsString().localeCompare(t.getNameAsString()),[`a`,`b`,``,`P"2!"2""/#`])).map(h(e=>({name:e.getNameAsString().trim(),description:(e.getDescription()??``).trim(),type:t(e.getType()).trim().replaceAll(/\s*(?:\||&)\s*/g,`, or `),defaultValue:e.hasDefault()?String(e.getDefaultValue())?.includes(`"`)?e.getDefaultValue():`\`${e.getDefaultValue()}\``:``,required:e.isValueRequired()?``:`✔`}),[`reflectionProperty`,``,`P"2!"/"`]))??[]}})]}}))}_.__type=[()=>g,`props`,`EnvDocsFile`,`Generates the environment configuration markdown documentation for the Powerlines project.`,`Pn!2""/#?$`];export{_ as EnvDocsFile,g as __ΩEnvDocsFileProps};
+import { __ΩEnvPluginContext } from "../types/plugin.mjs";
+import { stringifyType } from "@powerlines/deepkit/vendor/type";
+import { getDocsOutputPath } from "powerlines/plugin-utils";
+import { createComponent, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { Show, code } from "@alloy-js/core";
+import { Link } from "@alloy-js/markdown";
+import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { Heading } from "@powerlines/plugin-alloy/markdown/components/heading";
+import { MarkdownFile } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
+import { MarkdownTable } from "@powerlines/plugin-alloy/markdown/components/markdown-table";
+import { joinPaths } from "@stryke/path/join";
+
+//#region src/components/docs.tsx
+const __ΩPartial = [
+	"T",
+	"Partial",
+	"l+e#!e\"!fRb!Pde\"!gN#\"w\"y"
+];
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+const __ΩEnvDocsFileProps = [
+	() => __ΩPartial,
+	"levelOffset",
+	0,
+	"The heading level offset to apply to the generated documentation.",
+	"reflection",
+	"EnvDocsFileProps",
+	"P!o!\"'4\"8>#?$!4%Mw&y"
+];
+/**
+* Generates the environment configuration markdown documentation for the Powerlines project.
+*/
+function EnvDocsFile(props) {
+	const { levelOffset = 0, reflection, ...rest } = props;
+	const context = (usePowerlines.Ω = [[() => __ΩEnvPluginContext, "n!"]], usePowerlines());
+	return createComponent(MarkdownFile, mergeProps({ get path() {
+		return joinPaths(getDocsOutputPath(context.config.root), "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.`,
+			createComponent(Spacing, {}),
+			createComponent(MarkdownTable, { get data() {
+				return reflection?.getProperties().filter(__assignType((property) => !property.isHidden() && !property.isIgnored() && !property.isReadonly() && !property.isInternal(), [
+					"property",
+					"",
+					"P\"2!\"/\""
+				])).sort(__assignType((a, b) => a.getNameAsString().localeCompare(b.getNameAsString()), [
+					"a",
+					"b",
+					"",
+					"P\"2!\"2\"\"/#"
+				])).map(__assignType((reflectionProperty) => {
+					return {
+						name: reflectionProperty.getNameAsString().trim(),
+						description: (reflectionProperty.getDescription() ?? "").trim(),
+						type: stringifyType(reflectionProperty.getType()).trim().replaceAll(/\s*(?:\||&)\s*/g, ", or "),
+						defaultValue: reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : "",
+						required: reflectionProperty.isValueRequired() ? "" : "✔"
+					};
+				}, [
+					"reflectionProperty",
+					"",
+					"P\"2!\"/\""
+				])) ?? [];
+			} })
+		];
+	} }));
+}
+EnvDocsFile.__type = [
+	() => __ΩEnvDocsFileProps,
+	"props",
+	"EnvDocsFile",
+	"Generates the environment configuration markdown documentation for the Powerlines project.",
+	"Pn!2\"\"/#?$"
+];
+
+//#endregion
+export { EnvDocsFile, __ΩEnvDocsFileProps };
 //# sourceMappingURL=docs.mjs.map