@powerlines/plugin-env 0.16.125 → 0.16.126

package/dist/babel/plugin.cjs

@@ -1,7 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_types_plugin = require('../types/plugin.cjs');
-let _babel_core = require("@babel/core");
 let _powerlines_deepkit_utilities = require("@powerlines/deepkit/utilities");
 let _powerlines_plugin_babel_helpers_create_plugin = require("@powerlines/plugin-babel/helpers/create-plugin");
 let _powerlines_plugin_babel_helpers_module_helpers = require("@powerlines/plugin-babel/helpers/module-helpers");
@@ -115,11 +114,11 @@ const envBabelPlugin = (_powerlines_plugin_babel_helpers_create_plugin.createBab
 			extractEnv(identifier, pass, false, true);
 		}
 	}, [
-		() => _babel_core.NodePath,
+		"NodePath",
 		"path",
 		"pass",
 		"MemberExpression",
-		"PP!7!2\"!2#\"/$"
+		"P\"w!2\"!2#\"/$"
 	]) } };
 }, [
 	"param0",

package/dist/babel/plugin.d.cts

@@ -2,7 +2,7 @@ import { EnvPluginContext, EnvPluginResolvedConfig } from "../types/plugin.cjs";
 import * as _$_powerlines_plugin_babel0 from "@powerlines/plugin-babel";
 
 //#region src/babel/plugin.d.ts
-declare const envBabelPlugin: _$_powerlines_plugin_babel0.DeclareBabelTransformPluginReturn<EnvPluginContext<EnvPluginResolvedConfig>, Record<string, any>>;
+declare const envBabelPlugin: _$_powerlines_plugin_babel0.DeclareBabelTransformPluginReturn<EnvPluginContext<EnvPluginResolvedConfig>, object>;
 //#endregion
 export { envBabelPlugin };
 //# sourceMappingURL=plugin.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/babel/plugin.ts"],"mappings":";;;;cAiCa,cAAA,EAAc,2BAAA,CAAA,iCAAA,CAAA,gBAAA,CAgM1B,uBAAA,GAhM0B,MAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/babel/plugin.ts"],"mappings":";;;;cAiCa,cAAA,EAAc,2BAAA,CAAA,iCAAA,CAAA,gBAAA,CAgM1B,uBAAA"}

package/dist/babel/plugin.d.mts

@@ -2,7 +2,7 @@ import { EnvPluginContext, EnvPluginResolvedConfig } from "../types/plugin.mjs";
 import * as _$_powerlines_plugin_babel0 from "@powerlines/plugin-babel";
 
 //#region src/babel/plugin.d.ts
-declare const envBabelPlugin: _$_powerlines_plugin_babel0.DeclareBabelTransformPluginReturn<EnvPluginContext<EnvPluginResolvedConfig>, Record<string, any>>;
+declare const envBabelPlugin: _$_powerlines_plugin_babel0.DeclareBabelTransformPluginReturn<EnvPluginContext<EnvPluginResolvedConfig>, object>;
 //#endregion
 export { envBabelPlugin };
 //# sourceMappingURL=plugin.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/babel/plugin.ts"],"mappings":";;;;cAiCa,cAAA,EAAc,2BAAA,CAAA,iCAAA,CAAA,gBAAA,CAgM1B,uBAAA,GAhM0B,MAAA"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/babel/plugin.ts"],"mappings":";;;;cAiCa,cAAA,EAAc,2BAAA,CAAA,iCAAA,CAAA,gBAAA,CAgM1B,uBAAA"}

package/dist/babel/plugin.mjs

@@ -1,5 +1,4 @@
 import { __ΩEnvPluginContext } from "../types/plugin.mjs";
-import { NodePath } from "@babel/core";
 import { stringifyDefaultValue } from "@powerlines/deepkit/utilities";
 import { createBabelPlugin } from "@powerlines/plugin-babel/helpers/create-plugin";
 import { addImport } from "@powerlines/plugin-babel/helpers/module-helpers";
@@ -113,11 +112,11 @@ const envBabelPlugin = (createBabelPlugin.Ω = [[() => __ΩEnvPluginContext, "n!
 			extractEnv(identifier, pass, false, true);
 		}
 	}, [
-		() => NodePath,
+		"NodePath",
 		"path",
 		"pass",
 		"MemberExpression",
-		"PP!7!2\"!2#\"/$"
+		"P\"w!2\"!2#\"/$"
 	]) } };
 }, [
 	"param0",

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 name = node.name.replace(\n          new RegExp(`^(${context.config.env.prefix.join(\"|\")})_`),\n          \"\"\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 name = node.name.replace(\n          new RegExp(`^(${context.config.env.prefix.join(\"|\")})_`),\n          \"\"\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

@@ -37,65 +37,55 @@ const __ΩEnvDocsFileProps = [
 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)(require_helpers_docs_helper.getDocsOutputPath(context), "env.md");
-	} }, rest, { get children() {
-		return [
-			(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+	return (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: [
+			(0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_markdown.Heading, {
 				level: 1 + levelOffset,
 				children: "Environment Configuration"
 			}),
 			_alloy_js_core.code`Below is a list of environment variables used by the`,
-			(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-				get when() {
-					return !!context.packageJson.name;
-				},
-				get children() {
-					return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Link, {
-						get href() {
-							return `https://www.npmjs.com/package/${context.packageJson.name}`;
-						},
-						get title() {
-							return context.packageJson.name;
-						}
-					});
-				}
+			(0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_core.Show, {
+				when: !!context.packageJson.name,
+				children: (0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_markdown.Link, {
+					href: `https://www.npmjs.com/package/${context.packageJson.name}`,
+					title: context.packageJson.name
+				})
 			}),
 			_alloy_js_core.code`package. These values can be updated in the \`.env\` file in the root of the project.`,
-			(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-			(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_markdown.Heading, {
+			(0, _alloy_js_core_jsx_runtime.jsx)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+			(0, _alloy_js_core_jsx_runtime.jsx)(_alloy_js_markdown.Heading, {
 				level: 2 + levelOffset,
 				children: "Environment Variables"
 			}),
-			(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+			(0, _alloy_js_core_jsx_runtime.jsx)(_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!\"/\""
-				])) ?? [];
-			} })
-		];
-	} }));
+			(0, _alloy_js_core_jsx_runtime.jsx)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+			(0, _alloy_js_core_jsx_runtime.jsx)(_powerlines_plugin_alloy_markdown_components_markdown_table.MarkdownTable, { data: 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,

package/dist/components/docs.mjs

@@ -2,7 +2,7 @@ import { __ΩEnvPluginContext } from "../types/plugin.mjs";
 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 { jsx, jsxs } 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";
@@ -35,65 +35,55 @@ const __ΩEnvDocsFileProps = [
 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), "env.md");
-	} }, rest, { get children() {
-		return [
-			createComponent(Heading, {
+	return jsxs(MarkdownFile, {
+		path: joinPaths(getDocsOutputPath(context), "env.md"),
+		...rest,
+		children: [
+			jsx(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;
-						}
-					});
-				}
+			jsx(Show, {
+				when: !!context.packageJson.name,
+				children: jsx(Link, {
+					href: `https://www.npmjs.com/package/${context.packageJson.name}`,
+					title: context.packageJson.name
+				})
 			}),
 			code`package. These values can be updated in the \`.env\` file in the root of the project.`,
-			createComponent(Spacing, {}),
-			createComponent(Heading, {
+			jsx(Spacing, {}),
+			jsx(Heading, {
 				level: 2 + levelOffset,
 				children: "Environment Variables"
 			}),
-			createComponent(Spacing, {}),
+			jsx(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!\"/\""
-				])) ?? [];
-			} })
-		];
-	} }));
+			jsx(Spacing, {}),
+			jsx(MarkdownTable, { data: 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,

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.`}\n      <Spacing />\n      <MarkdownTable\n        data={\n          reflection\n            ?.getProperties()\n            .filter(\n              property =>\n                !property.isHidden() &&\n                !property.isIgnored() &&\n                !property.isReadonly() &&\n                !property.isInternal()\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(/\\s*(?:\\||&)\\s*/g, \", 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":";;;;;;;;;;;;;;;;;;AAIA,SAAM,aAAS,IAAW,MAAM;AAC/B,IAAG,SAAU;AACb,QAAQ;;;;;;;;;;;;;;AAiCT,SAAM,YAAA,OAAA;CACJ,MAAG,EACF,cAAA,GACC,YACA,GAAA,SACF;;AAEA,QAAA,gBAAY,cAAoB,WAAA,EAClC,IAAA,OAAA;;IAGG,EAAA,MAAA,EACD,IAAA,WAAA;AACI,SAAC;GAAA,gBAAqB,SAAO;IAC3B,OAAE,IAAA;;IAEH,CAAC;GAAA,IAAA;GAA2C,gBAAA,MAAA;;AAE1C,YAAA,CAAA,CAAA,QAAA,YAAA;;IAEH,IAAM,WAAU;AACZ,YAAK,gBAAA,MAAA;MACR,IAAQ,OAAQ;AACX,cAAS,iCAAgC,QAAQ,YAAI;;MAExD,IAAA,QAAA;AACK,cAAG,QAAY,YAAU;;MAE9B,CAAA;;IAEF,CAAA;GAAA,IAAK;GAAsF,gBAAA,SAAA,EAAA,CAAA;GAAA,gBAAA,SAAA;IAC3F,OAAQ,IAAC;IACT,UAAQ;IACR,CAAA;GAAA,gBAAS,SAAA,EAAA,CAAA;GAAA,IAAA;GAAA,gBAAA,SAAA,EAAA,CAAA;GAAA,gBAAA,eAAA,EACT,IAAK,OAAI;AACT,WAAS,YAAA,eAAA,CAAA,OAAA,cAAA,aAAA,CAAA,SAAA,UAAA,IAAA,CAAA,SAAA,WAAA,IAAA,CAAA,SAAA,YAAA,IAAA,CAAA,SAAA,YAAA,EAAA;KAAA;KAAA;KAAA;KAAA,CAAA,CAAA,CAAA,KAAA,cAAA,GAAA,MAAA,EAAA,iBAAA,CAAA,cAAA,EAAA,iBAAA,CAAA,EAAA;KAAA;KAAA;KAAA;KAAA;KAAA,CAAA,CAAA,CAAA,IAAA,cAAA,uBAAA;AACT,YAAA;MACM,MAAA,mBAAA,iBAAA,CAAA,MAAA;MACH,cAAA,mBAAA,gBAAA,IAAA,IAAA,MAAA;MACI,MAAA,cAAc,mBAAA,SAAA,CAAA,CAAA,MAAA,CAAA,WAAA,mBAAA,QAAA;MACf,cAAM,mBAAA,YAAA,GAAA,OAAA,mBAAA,iBAAA,CAAA,EAAA,SAAA,KAAA,GAAA,mBAAA,iBAAA,GAAA,KAAA,mBAAA,iBAAA,CAAA,MAAA;MACL,UAAU,mBAAA,iBAAA,GAAA,KAAA;MACX;OACA;KAAC;KAAsB;KAAG;KAAA,CAAA,CAAA,IAAA,EAAA;MAEhC,CAAC;GAAC;IAEN,CAAC,CAAC;;AAEL,YAAY,SAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}
+{"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.`}\n      <Spacing />\n      <MarkdownTable\n        data={\n          reflection\n            ?.getProperties()\n            .filter(\n              property =>\n                !property.isHidden() &&\n                !property.isIgnored() &&\n                !property.isReadonly() &&\n                !property.isInternal()\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(/\\s*(?:\\||&)\\s*/g, \", 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":";;;;;;;;;;;;;;;;;;AAIA,SAAM,aAAS,IAAW,MAAM;AAC5B,IAAA,SAAW;AACd,QAAS;;;;;;;;;;;;;;AAiCV,SAAM,YAAA,OAAA;CACF,MAAM,EAAE,cAAa,GAAA,YAAY,GAAA,SAAc;CAChD,MAAA,WAAA,cAAA,IAAA,CAAA,OAAA,qBAAA,KAAA,CAAA,EAAA,eAAA;AACC,QAAE,KAAY,cAAC;EAAA,MAAA,UAAA,kBAAA,QAAA,EAAA,SAAA;EAAA,GAAA;EAAA,UAAA;GAAA,IAAA,SAAA;IAAA,OAAA,IAAA;IAAA,UAAA;IAAA,CAAA;GAAA,IAAA;GAAA,IAAA,MAAA;IAAA,MAAA,CAAA,CAAA,QAAA,YAAA;IAAA,UAAA,IAAA,MAAA;KAAA,MAAA,iCAAA,QAAA,YAAA;KAAA,OAAA,QAAA,YAAA;KAAA,CAAA;IAAA,CAAA;GAAA,IAAA;GAAA,IAAA,SAAA,EAAA,CAAA;GAAA,IAAA,SAAA;IAAA,OAAA,IAAA;IAAA,UAAA;IAAA,CAAA;GAAA,IAAA,SAAA,EAAA,CAAA;GAAA,IAAA;GAAA,IAAA,SAAA,EAAA,CAAA;GAAA,IAAA,eAAA,EAAA,MAAA,YACf,eAAA,CACY,OAAM,cAAA,aAAA,CAAA,SAAA,UAAA,6BAER,CAAA,SAAgB,YAAI,IAClC,CAAA,SAAA,YAAA,EAAA;IAAA;IAAA;IAAA;IAAA,CAAA,CAAA;;;;;OAEE,IAAA,cAAA,uBAAA;AACe,WAAA;KACf,MAAA,mBAAA,iBAAA,CAAA,MAAA;KACc,cAAmB,mBAAkB,gBAAA,IAAA,IAAA,MAAA;KAC7B,MAAG,cAAe,mBAAc,SAAA,CAAA,QAEtC,WAAc,mBAAmB,QAAA;qDAE1C,OAAA,mBAAA,iBAAA,CAAA,EAAA,SAAA,KAAA,GACJ,mBAAA,iBAAA,GACiB,KAAiB,mBAAmB,iBAAC,CAAA,MAC5C;KACS,UAAE,mBAAyB,iBAAe,GAAO,KAAA;KACpD;MACF;IAAC;IAAoB;IAAK;IAAA,CAAA,CAAA,IAAA,EAAA,EAAA,CAAA;GAAA;EAAA,CAAA;;AAE7C,YAAU,SAAO;OAAW;CAAqB;CAAQ;CAAgB;CAAE;CAAA"}