@powerlines/plugin-env 0.16.67 → 0.16.69

package/README.md

@@ -27,7 +27,7 @@ This package is part of the <b>🔌 Powerlines</b> monorepo. Powerlines is the "
 
 <h3 align="center">💻 Visit <a href="https://stormsoftware.com" target="_blank">stormsoftware.com</a> to stay up to date with this developer</h3><br />
 
-[![Version](https://img.shields.io/badge/version-0.16.60-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://stormsoftware.com/projects/powerlines)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/powerlines/release.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
+[![Version](https://img.shields.io/badge/version-0.16.68-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://stormsoftware.com/projects/powerlines)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/powerlines/release.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
 
 <!-- prettier-ignore-start -->
 <!-- markdownlint-disable -->

package/dist/_virtual/_rolldown/runtime.cjs

@@ -5,7 +5,6 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 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++) {
@@ -27,5 +26,4 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 //#endregion
 
-exports.__commonJSMin = __commonJSMin;
 exports.__toESM = __toESM;

package/dist/_virtual/_rolldown/runtime.mjs

@@ -1,32 +1,3 @@
-import { createRequire } from "node:module";
+import "node:module";
 
-//#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 __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
-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));
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
-//#endregion
-export { __commonJSMin, __require, __toESM };
+export {  };

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 { 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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"}
+{"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

@@ -3,13 +3,13 @@ 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");
-let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 
 //#region src/components/docs.tsx
 /**
@@ -18,42 +18,52 @@ let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 function EnvDocsFile(props) {
 	const { levelOffset = 0, reflection, ...rest } = props;
 	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	return /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsxs)(_powerlines_plugin_alloy_markdown_components_markdown_file.MarkdownFile, {
-		path: (0, _stryke_path_join.joinPaths)(require_helpers_docs_helper.getDocsOutputPath(context), "env.md"),
-		...rest,
-		children: [
-			/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_markdown.Heading, {
+	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`,
-			/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.Show, {
-				when: !!context.packageJson.name,
-				children: /* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_markdown.Link, {
-					href: `https://www.npmjs.com/package/${context.packageJson.name}`,
-					title: context.packageJson.name
-				})
+			(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.`,
-			/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-			/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_markdown.Heading, {
+			(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"
 			}),
-			/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+			(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.`,
-			/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-			/* @__PURE__ */ (0, _alloy_js_core_jsx_runtime.jsx)(_powerlines_plugin_alloy_markdown_components_markdown_table.MarkdownTable, { data: 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() ? "" : "✔"
-				};
-			}) ?? [] })
-		]
-	});
+			(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

package/dist/components/docs.mjs

@@ -1,13 +1,13 @@
 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";
-import { jsx, jsxs } from "@alloy-js/core/jsx-runtime";
 
 //#region src/components/docs.tsx
 /**
@@ -16,42 +16,52 @@ import { jsx, jsxs } from "@alloy-js/core/jsx-runtime";
 function EnvDocsFile(props) {
 	const { levelOffset = 0, reflection, ...rest } = props;
 	const context = usePowerlines();
-	return /* @__PURE__ */ jsxs(MarkdownFile, {
-		path: joinPaths(getDocsOutputPath(context), "env.md"),
-		...rest,
-		children: [
-			/* @__PURE__ */ jsx(Heading, {
+	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`,
-			/* @__PURE__ */ jsx(Show, {
-				when: !!context.packageJson.name,
-				children: /* @__PURE__ */ jsx(Link, {
-					href: `https://www.npmjs.com/package/${context.packageJson.name}`,
-					title: context.packageJson.name
-				})
+			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.`,
-			/* @__PURE__ */ jsx(Spacing, {}),
-			/* @__PURE__ */ jsx(Heading, {
+			createComponent(Spacing, {}),
+			createComponent(Heading, {
 				level: 2 + levelOffset,
 				children: "Environment Variables"
 			}),
-			/* @__PURE__ */ jsx(Spacing, {}),
+			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.`,
-			/* @__PURE__ */ jsx(Spacing, {}),
-			/* @__PURE__ */ jsx(MarkdownTable, { data: 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() ? "" : "✔"
-				};
-			}) ?? [] })
-		]
-	});
+			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

package/dist/components/docs.mjs.map

@@ -1 +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":";;;;;;;;;;;;;;;AAoDA,SAAgB,YAAY,OAAyB;CACnD,MAAM,EAAE,cAAc,GAAG,YAAY,GAAG,SAAS;CAEjD,MAAM,UAAU,eAAiC;AAEjD,QACE,qBAAC,cAAD;EACE,MAAM,UAAU,kBAAkB,QAAQ,EAAE,SAAS;EACrD,GAAI;YAFN;GAGE,oBAAC,SAAD;IAAS,OAAO,IAAI;cAAa;IAAmC;GACnE,IAAI;GACL,oBAAC,MAAD;IAAM,MAAM,CAAC,CAAC,QAAQ,YAAY;cAChC,oBAAC,MAAD;KACE,MAAM,iCAAiC,QAAQ,YAAY;KAC3D,OAAO,QAAQ,YAAY;KAC3B;IACG;GACN,IAAI;GACL,oBAAC,SAAD,EAAW;GACX,oBAAC,SAAD;IAAS,OAAO,IAAI;cAAa;IAA+B;GAChE,oBAAC,SAAD,EAAW;GACV,IAAI;GACL,oBAAC,SAAD,EAAW;GACX,oBAAC,eAAD,EACE,MACE,YACI,eAAe,CAChB,QACC,aACE,SAAS,iBAAiB,KAAK,0BAClC,CACA,MAAM,GAAG,MACR,EAAE,iBAAiB,CAAC,cAAc,EAAE,iBAAiB,CAAC,CACvD,CACA,KAAI,uBAAsB;AACzB,WAAO;KACL,MAAM,mBAAmB,iBAAiB,CAAC,MAAM;KACjD,cAAc,mBAAmB,gBAAgB,IAAI,IAAI,MAAM;KAC/D,MAAM,cAAc,mBAAmB,SAAS,CAAC,CAC9C,MAAM,CACN,WAAW,OAAO,QAAQ;KAC7B,cAAc,mBAAmB,YAAY,GACzC,OAAO,mBAAmB,iBAAiB,CAAC,EAAE,SAAS,KAAI,GACzD,mBAAmB,iBAAiB,GACpC,KAAK,mBAAmB,iBAAiB,CAAC,MAC5C;KACJ,UAAU,mBAAmB,iBAAiB,GAAG,KAAK;KACvD;KACD,IAAI,EAAE,EAEZ;GACW"}
+{"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"}