@powerlines/plugin-env 0.16.136 → 0.16.138

package/dist/components/docs.cjs

@@ -1,9 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_types_plugin = require('../types/plugin.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 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");
@@ -12,6 +11,7 @@ let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin
 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 = [
@@ -39,7 +39,7 @@ 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");
+		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, {

package/dist/components/docs.mjs

@@ -1,7 +1,6 @@
 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 { 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";
@@ -10,6 +9,7 @@ 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 = [
@@ -37,7 +37,7 @@ 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");
+		return joinPaths(getDocsOutputPath(context.config.root), "env.md");
 	} }, rest, { get children() {
 		return [
 			createComponent(Heading, {

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 { 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 { Heading } from \"@powerlines/plugin-alloy/markdown/components/heading\";\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;;;;;;;;;;;;;;AAkCT,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 { 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 { Heading } from \"@powerlines/plugin-alloy/markdown/components/heading\";\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 \"powerlines/plugin-utils\";\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.config.root), \"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;;;;;;;;;;;;;;AAkCT,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"}

package/dist/helpers/automd-generator.cjs

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 let _stryke_path_join_paths = require("@stryke/path/join-paths");
 let automd = require("automd");
+let powerlines_plugin_utils = require("powerlines/plugin-utils");
 
 //#region src/helpers/automd-generator.ts
 function __assignType(fn, args) {
@@ -17,7 +18,7 @@ function __assignType(fn, args) {
 const env = __assignType((context) => (0, automd.defineGenerator)({
 	name: "env",
 	generate: __assignType(async function generate() {
-		const envDocFile = (0, _stryke_path_join_paths.joinPaths)(context.config.root, "docs", "generated", "env.md");
+		const envDocFile = (0, _stryke_path_join_paths.joinPaths)((0, powerlines_plugin_utils.getDocsOutputPath)(context.config.root), "env.md");
 		if (!context.fs.existsSync(envDocFile)) return { contents: "" };
 		return { contents: await context.fs.read(envDocFile) || "" };
 	}, ["generate", "P\"/!"])

package/dist/helpers/automd-generator.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"automd-generator.d.cts","names":[],"sources":["../../src/helpers/automd-generator.ts"],"mappings":";;;;;;;AA4BA;;;cAAa,GAAA,GAAO,OAAA,EAAS,iBAAA,KAAiB,QAAA,CAAA,SAAA"}
+{"version":3,"file":"automd-generator.d.cts","names":[],"sources":["../../src/helpers/automd-generator.ts"],"mappings":";;;;;;;AA6BA;;;cAAa,GAAA,GAAO,OAAA,EAAS,iBAAA,KAAiB,QAAA,CAAA,SAAA"}

package/dist/helpers/automd-generator.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"automd-generator.d.mts","names":[],"sources":["../../src/helpers/automd-generator.ts"],"mappings":";;;;;;;AA4BA;;;cAAa,GAAA,GAAO,OAAA,EAAS,iBAAA,KAAiB,QAAA,CAAA,SAAA"}
+{"version":3,"file":"automd-generator.d.mts","names":[],"sources":["../../src/helpers/automd-generator.ts"],"mappings":";;;;;;;AA6BA;;;cAAa,GAAA,GAAO,OAAA,EAAS,iBAAA,KAAiB,QAAA,CAAA,SAAA"}

package/dist/helpers/automd-generator.mjs

@@ -1,5 +1,6 @@
 import { joinPaths } from "@stryke/path/join-paths";
 import { defineGenerator } from "automd";
+import { getDocsOutputPath } from "powerlines/plugin-utils";
 
 //#region src/helpers/automd-generator.ts
 function __assignType(fn, args) {
@@ -15,7 +16,7 @@ function __assignType(fn, args) {
 const env = __assignType((context) => defineGenerator({
 	name: "env",
 	generate: __assignType(async function generate() {
-		const envDocFile = joinPaths(context.config.root, "docs", "generated", "env.md");
+		const envDocFile = joinPaths(getDocsOutputPath(context.config.root), "env.md");
 		if (!context.fs.existsSync(envDocFile)) return { contents: "" };
 		return { contents: await context.fs.read(envDocFile) || "" };
 	}, ["generate", "P\"/!"])

package/dist/helpers/automd-generator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"automd-generator.mjs","names":[],"sources":["../../src/helpers/automd-generator.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 { joinPaths } from \"@stryke/path/join-paths\";\nimport { defineGenerator } from \"automd\";\nimport { UnresolvedContext } from \"powerlines\";\n\n/**\n * AutoMD generator to generate environment variable documentation\n *\n * @param context - The generator context.\n * @returns The generated documentation content.\n */\nexport const env = (context: UnresolvedContext) =>\n  defineGenerator({\n    name: \"env\",\n    async generate() {\n      const envDocFile = joinPaths(\n        context.config.root,\n        \"docs\",\n        \"generated\",\n        \"env.md\"\n      );\n\n      if (!context.fs.existsSync(envDocFile)) {\n        return {\n          contents: \"\"\n        };\n      }\n\n      const contents = await context.fs.read(envDocFile);\n\n      return {\n        contents: contents || \"\"\n      };\n    }\n  });\n"],"mappings":";;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE9B,QAAO;;;;;;;;AA2BT,MAAE,MAAgB,cAAA,YAAA,gBAAA;CAChB,MAAM;CACN,UAAQ,aAAW,eAAA,WAAA;EACjB,MAAE,aAAiB,UAAE,QAAS,OAAA,MAAA,QAAA,aAAA,SAAA;AAC9B,MAAI,CAAA,QAAQ,GAAA,WAAW,WAAA,CACrB,QAAO,EACL,UAAU,IACX;AAGH,SAAO,EACL,UAAS,qCAAA,IACV;IACA,CAAC,YAAG,QAAA,CAAA;CACR,CAAC,EAAE;CAAC;CAAC;CAAA;CAAA,CAAA"}
+{"version":3,"file":"automd-generator.mjs","names":[],"sources":["../../src/helpers/automd-generator.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 { joinPaths } from \"@stryke/path/join-paths\";\nimport { defineGenerator } from \"automd\";\nimport { UnresolvedContext } from \"powerlines\";\nimport { getDocsOutputPath } from \"powerlines/plugin-utils\";\n\n/**\n * AutoMD generator to generate environment variable documentation\n *\n * @param context - The generator context.\n * @returns The generated documentation content.\n */\nexport const env = (context: UnresolvedContext) =>\n  defineGenerator({\n    name: \"env\",\n    async generate() {\n      const envDocFile = joinPaths(\n        getDocsOutputPath(context.config.root),\n        \"env.md\"\n      );\n\n      if (!context.fs.existsSync(envDocFile)) {\n        return {\n          contents: \"\"\n        };\n      }\n\n      const contents = await context.fs.read(envDocFile);\n\n      return {\n        contents: contents || \"\"\n      };\n    }\n  });\n"],"mappings":";;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE9B,QAAO;;;;;;;;AA4BT,MAAE,MAAgB,cAAA,YAAA,gBAAA;CAChB,MAAM;CACN,UAAQ,aAAW,eAAA,WAAA;EACjB,MAAE,aAAiB,UAAE,kBAAS,QAAA,OAAA,KAAA,EAAA,SAAA;AAC9B,MAAI,CAAA,QAAA,GAAA,WAAkB,WAAe,CACnC,QAAO,EACN,UAAA;AAIH,SAAM,EACJ,UAAG,MAFM,QAAA,GAAA,KAAA,WAAA,IAEN,IACJ;;CAEJ,CAAC,EAAE;CAAC;CAAO;CAAQ;CAAS,CAAA"}

package/dist/index.cjs

@@ -4,7 +4,6 @@ const require_types_plugin = require('./types/plugin.cjs');
 const require_helpers_reflect = require('./helpers/reflect.cjs');
 const require_helpers_persistence = require('./helpers/persistence.cjs');
 const require_helpers_load = require('./helpers/load.cjs');
-const require_helpers_docs_helper = require('./helpers/docs-helper.cjs');
 const require_helpers_automd_generator = require('./helpers/automd-generator.cjs');
 const require_components_docs = require('./components/docs.cjs');
 const require_components_env_builtin = require('./components/env-builtin.cjs');
@@ -13,8 +12,9 @@ let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type")
 let defu = require("defu");
 defu = require_runtime.__toESM(defu);
 let powerlines_constants = require("powerlines/constants");
-let _stryke_path_join = require("@stryke/path/join");
+let powerlines_plugin_utils = require("powerlines/plugin-utils");
 let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _stryke_path_join = require("@stryke/path/join");
 let _stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
 let _powerlines_plugin_alloy_render = require("@powerlines/plugin-alloy/render");
 let _powerlines_plugin_automd = require("@powerlines/plugin-automd");
@@ -196,7 +196,7 @@ const plugin = __assignType((options = {}) => {
 				}, ["handler", "P\"/!"])
 			},
 			docs: __assignType(async function docs() {
-				this.debug(`Documenting environment variables configuration values in "${(0, _stryke_path_join.joinPaths)(require_helpers_docs_helper.getDocsOutputPath(this), "env.md")}"`);
+				this.debug(`Documenting environment variables configuration values in "${(0, _stryke_path_join.joinPaths)((0, powerlines_plugin_utils.getDocsOutputPath)(this.config.root), "env.md")}"`);
 				const result = await require_helpers_persistence.readEnvTypeReflection(this, "env");
 				return (0, _powerlines_plugin_alloy_render.render)(this, (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_docs.EnvDocsFile, {
 					levelOffset: 0,

package/dist/index.mjs

@@ -2,7 +2,6 @@ import { __ΩEnvPluginContext, __ΩEnvPluginOptions } from "./types/plugin.mjs";
 import { reflectEnv, reflectSecrets } from "./helpers/reflect.mjs";
 import { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, writeEnvReflection, writeEnvTypeReflection } from "./helpers/persistence.mjs";
 import { loadEnv } from "./helpers/load.mjs";
-import { getDocsOutputPath } from "./helpers/docs-helper.mjs";
 import { env } from "./helpers/automd-generator.mjs";
 import { EnvDocsFile } from "./components/docs.mjs";
 import { EnvBuiltin } from "./components/env-builtin.mjs";
@@ -10,8 +9,9 @@ import { envBabelPlugin } from "./babel/plugin.mjs";
 import { ReflectionClass, ReflectionKind } from "@powerlines/deepkit/vendor/type";
 import defu from "defu";
 import { VIRTUAL_MODULE_PREFIX } from "powerlines/constants";
-import { joinPaths } from "@stryke/path/join";
+import { getDocsOutputPath } from "powerlines/plugin-utils";
 import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { joinPaths } from "@stryke/path/join";
 import { getUnique } from "@stryke/helpers/get-unique";
 import { render } from "@powerlines/plugin-alloy/render";
 import automd from "@powerlines/plugin-automd";
@@ -190,7 +190,7 @@ const plugin = __assignType((options = {}) => {
 				}, ["handler", "P\"/!"])
 			},
 			docs: __assignType(async function docs() {
-				this.debug(`Documenting environment variables configuration values in "${joinPaths(getDocsOutputPath(this), "env.md")}"`);
+				this.debug(`Documenting environment variables configuration values in "${joinPaths(getDocsOutputPath(this.config.root), "env.md")}"`);
 				const result = await readEnvTypeReflection(this, "env");
 				return render(this, createComponent(EnvDocsFile, {
 					levelOffset: 0,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.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 {\n  ReflectionClass,\n  ReflectionKind\n} from \"@powerlines/deepkit/vendor/type\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport automd from \"@powerlines/plugin-automd\";\nimport babel from \"@powerlines/plugin-babel\";\nimport deepkit from \"@powerlines/plugin-deepkit\";\nimport { TypeScriptCompilerPluginUserConfig } from \"@powerlines/plugin-tsc\";\nimport { parseTypeDefinition } from \"@stryke/convert/parse-type-definition\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { existsSync } from \"@stryke/fs/exists\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport {\n  TypeDefinition,\n  TypeDefinitionParameter\n} from \"@stryke/types/configuration\";\nimport defu from \"defu\";\nimport { Plugin } from \"powerlines\";\nimport { VIRTUAL_MODULE_PREFIX } from \"powerlines/constants\";\nimport type { UserConfig as ViteUserConfig } from \"vite\";\nimport { envBabelPlugin } from \"./babel/plugin\";\nimport { EnvDocsFile } from \"./components/docs\";\nimport { EnvBuiltin } from \"./components/env-builtin\";\nimport { env } from \"./helpers/automd-generator\";\nimport { getDocsOutputPath } from \"./helpers/docs-helper\";\nimport { loadEnv } from \"./helpers/load\";\nimport {\n  getEnvDefaultTypeDefinition,\n  getEnvReflectionsPath,\n  getEnvTypeReflectionsPath,\n  getSecretsDefaultTypeDefinition,\n  readEnvReflection,\n  readEnvTypeReflection,\n  readSecretsReflection,\n  writeEnvReflection,\n  writeEnvTypeReflection\n} from \"./helpers/persistence\";\nimport { reflectEnv, reflectSecrets } from \"./helpers/reflect\";\nimport { EnvPluginContext, EnvPluginOptions } from \"./types/plugin\";\n\nexport type * from \"./types\";\n\ndeclare module \"powerlines\" {\n  interface Config {\n    env?: EnvPluginOptions;\n  }\n}\n\n/**\n * A Powerlines plugin to inject environment variables into the source code.\n */\nexport const plugin = <TContext extends EnvPluginContext = EnvPluginContext>(\n  options: EnvPluginOptions = {}\n) => {\n  return [\n    deepkit(options.deepkit),\n    babel(options.babel),\n    {\n      name: \"env:core\",\n      async config() {\n        this.debug(\n          \"Providing default configuration for the Powerlines `env` build plugin.\"\n        );\n\n        const config = {\n          env: defu(options, {\n            types: {} as TypeDefinitionParameter,\n            validate: false,\n            inject: false,\n            prefix: []\n          }),\n          babel: {\n            plugins: [envBabelPlugin]\n          },\n          deepkit: {\n            reflection: \"default\",\n            level: \"all\"\n          },\n          tsc: {} as TypeScriptCompilerPluginUserConfig[\"tsc\"]\n        };\n\n        if (\n          isSetString(config.env.types) ||\n          (config.env.types && isSetString(config.env.types.file))\n        ) {\n          config.env.types = parseTypeDefinition(\n            config.env.types\n          ) as TypeDefinition;\n\n          const file = await this.fs.resolve(config.env.types.file);\n          if (file) {\n            config.env.types.file = file;\n          }\n        } else {\n          this.warn(\n            \"The `env.types` configuration parameter was not provided. Please ensure this is expected.\"\n          );\n\n          const envDefaultTypeDefinition =\n            await getEnvDefaultTypeDefinition(this);\n\n          const file = await this.fs.resolve(envDefaultTypeDefinition.file);\n          if (file) {\n            config.env.types = parseTypeDefinition(\n              `${file}#${envDefaultTypeDefinition.name}`\n            ) as TypeDefinition;\n          }\n        }\n\n        if (\n          isSetString(config.env.secrets) ||\n          (config.env.secrets && isSetString(config.env.secrets.file))\n        ) {\n          config.env.secrets = parseTypeDefinition(config.env.secrets);\n\n          const file = await this.fs.resolve(config.env.secrets.file);\n          if (file) {\n            config.env.secrets.file = file;\n          }\n        } else {\n          const secretsDefaultTypeDefinition =\n            await getSecretsDefaultTypeDefinition(this);\n\n          const file = await this.fs.resolve(secretsDefaultTypeDefinition.file);\n          if (file) {\n            config.env.secrets = parseTypeDefinition(\n              `${file}#${secretsDefaultTypeDefinition.name}`\n            );\n          }\n        }\n\n        if (config.env.types || config.env.secrets) {\n          config.tsc.filter = {\n            id: [\n              new RegExp(\n                `^(${VIRTUAL_MODULE_PREFIX})?${joinPaths(\n                  this.builtinsPath,\n                  \"env.ts\"\n                )\n                  .replace(/\\\\/g, \"\\\\\\\\\")\n                  .replace(/\\//g, \"\\\\/\")\n                  .replace(/\\./g, \"\\\\.\")\n                  .replace(/\\$/g, \"\\\\$\")}$`\n              )\n            ]\n          };\n        }\n\n        config.env.prefix = toArray(\n          (config.env.prefix ?? []) as string[]\n        ).reduce(\n          (ret: string[], prefix: string) => {\n            const formattedPrefix = constantCase(prefix);\n            if (!ret.includes(formattedPrefix)) {\n              ret.push(formattedPrefix);\n            }\n\n            return ret;\n          },\n          [\n            \"POWERLINES_\",\n            this.config.framework &&\n              this.config.framework !== \"powerlines\" &&\n              `${constantCase(this.config.framework)}_`\n          ].filter(Boolean) as string[]\n        );\n\n        config.env.prefix = getUnique(\n          toArray(config.env.prefix).reduce((ret, prefix) => {\n            if (!ret.includes(prefix.replace(/_$/g, \"\"))) {\n              ret.push(prefix.replace(/_$/g, \"\"));\n            }\n            return ret;\n          }, [] as string[])\n        );\n\n        return config;\n      },\n      async configResolved() {\n        this.debug(\n          `Environment plugin configuration has been resolved for the Powerlines project.`\n        );\n\n        this.env = defu(\n          {\n            parsed: await loadEnv(this, this.config.env)\n          },\n          this.env ?? {},\n          {\n            types: {\n              env: {}\n            },\n            used: {\n              env: {},\n              secrets: {}\n            },\n            parsed: {},\n            injected: {}\n          }\n        );\n\n        if (\n          this.config.command !== \"prepare\" &&\n          !this.config.skipCache &&\n          this.persistedMeta?.checksum === this.meta.checksum &&\n          existsSync(getEnvTypeReflectionsPath(this, \"env\"))\n        ) {\n          this.debug(\n            `Skipping reflection initialization as the meta checksum has not changed.`\n          );\n\n          this.env.types.env = await readEnvTypeReflection(this, \"env\");\n\n          if (existsSync(getEnvReflectionsPath(this, \"env\"))) {\n            this.env.used.env = await readEnvReflection(this);\n          }\n\n          if (existsSync(getEnvTypeReflectionsPath(this, \"secrets\"))) {\n            this.env.types.secrets = await readEnvTypeReflection(\n              this,\n              \"secrets\"\n            );\n          }\n\n          if (existsSync(getEnvReflectionsPath(this, \"secrets\"))) {\n            this.env.used.secrets = await readSecretsReflection(this);\n          }\n        } else {\n          this.debug(\n            `Starting environment configuration reflection initialization.`\n          );\n\n          this.env.types.env = await reflectEnv(\n            this,\n            this.config.env.types?.file,\n            this.config.env.types?.name\n          );\n          if (!this.env.types.env) {\n            throw new Error(\n              \"Failed to find the environment configuration type reflection in the context.\"\n            );\n          }\n\n          await writeEnvTypeReflection(this, this.env.types.env, \"env\");\n\n          this.env.types.secrets = await reflectSecrets(\n            this,\n            this.config.env.secrets?.file,\n            this.config.env.secrets?.name\n          );\n          if (!this.env.types.secrets) {\n            throw new Error(\n              \"Failed to find the secrets configuration type reflection in the context.\"\n            );\n          }\n\n          await writeEnvTypeReflection(this, this.env.types.secrets, \"secrets\");\n\n          this.debug(\n            `Resolved ${\n              this.env.types.env.getProperties().length ?? 0\n            } environment configuration parameters and ${\n              this.env.types.secrets?.getProperties().length ?? 0\n            } secret configuration parameters`\n          );\n\n          const envWithAlias = this.env.types.env\n            .getProperties()\n            .filter(prop => prop.getAlias().length > 0);\n\n          Object.entries(await loadEnv(this, this.config.env)).forEach(\n            ([key, value]) => {\n              const unprefixedKey = this.config.env.prefix.reduce(\n                (ret, prefix) => {\n                  if (key.replace(/_$/g, \"\").startsWith(prefix)) {\n                    return key.replace(/_$/g, \"\").slice(prefix.length);\n                  }\n                  return ret;\n                },\n                key\n              );\n\n              const aliasKey = envWithAlias.find(prop =>\n                prop?.getAlias().reverse().includes(unprefixedKey)\n              );\n              if (this.env.types.env?.hasProperty(unprefixedKey) || aliasKey) {\n                this.env.types.env\n                  .getProperty(unprefixedKey)\n                  .setDefaultValue(value);\n              }\n            }\n          );\n\n          this.env.used.env = new ReflectionClass(\n            {\n              kind: ReflectionKind.objectLiteral,\n              typeName: \"Env\",\n              description: `An object containing the environment configuration parameters used by the ${\n                this.config.name\n                  ? `${this.config.name} application`\n                  : \"application\"\n              }.`,\n              types: []\n            },\n            this.env.types.env\n          );\n\n          await writeEnvReflection(this, this.env.used.env, \"env\");\n\n          if (this.env.types.secrets) {\n            await writeEnvTypeReflection(\n              this,\n              this.env.types.secrets,\n              \"secrets\"\n            );\n\n            this.env.used.secrets = new ReflectionClass(\n              {\n                kind: ReflectionKind.objectLiteral,\n                typeName: \"Secrets\",\n                description: `An object containing the secret configuration parameters used by the ${\n                  this.config.name\n                    ? `${this.config.name} application`\n                    : \"application\"\n                }.`,\n                types: []\n              },\n              this.env.types.secrets\n            );\n            await writeEnvReflection(this, this.env.used.secrets, \"secrets\");\n          }\n        }\n      },\n      async prepare() {\n        this.debug(\n          `Preparing the Environment runtime artifacts for the Powerlines project.`\n        );\n\n        const result = await readEnvTypeReflection(this, \"env\");\n\n        return render(\n          this,\n          <EnvBuiltin\n            defaultConfig={this.config.env.defaultConfig}\n            reflection={result}\n          />\n        );\n      },\n      transform: {\n        order: \"post\",\n        async handler() {\n          if (this.env.used.env.getProperties().length > 0) {\n            this.trace(\n              `Persisting used environment configuration reflections to ${getEnvReflectionsPath(\n                this,\n                \"env\"\n              )}.`\n            );\n            await writeEnvReflection(this, this.env.used.env, \"env\");\n          }\n\n          if (this.env.used.secrets.getProperties().length > 0) {\n            this.trace(\n              `Persisting used secret configuration reflections to ${getEnvReflectionsPath(\n                this,\n                \"secrets\"\n              )}.`\n            );\n            await writeEnvReflection(this, this.env.used.secrets, \"secrets\");\n          }\n        }\n      },\n      async docs() {\n        this.debug(\n          `Documenting environment variables configuration values in \"${joinPaths(\n            getDocsOutputPath(this),\n            \"env.md\"\n          )}\"`\n        );\n\n        const result = await readEnvTypeReflection(this, \"env\");\n\n        return render(\n          this,\n          <EnvDocsFile levelOffset={0} reflection={result} />\n        );\n      },\n      async buildEnd() {\n        const reflectionPath = getEnvReflectionsPath(this, \"env\");\n\n        this.debug(`Writing env reflection types to ${reflectionPath}.`);\n\n        await writeEnvReflection(this, this.env.used.env, \"env\");\n      }\n    },\n    {\n      name: \"env:automd-generator\",\n      config() {\n        return {\n          automd: defu(options.automd ?? {}, {\n            generators: {\n              env: env(this)\n            }\n          })\n        };\n      }\n    },\n    {\n      name: \"env:vite\",\n      vite: {\n        configResolved(this: TContext) {\n          return {\n            envPrefix: this.config?.env?.prefix\n          } as ViteUserConfig;\n        }\n      }\n    },\n    automd(options.automd)\n  ] as Plugin<TContext>[];\n};\n\nexport default plugin;\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.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 {\n  ReflectionClass,\n  ReflectionKind\n} from \"@powerlines/deepkit/vendor/type\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport automd from \"@powerlines/plugin-automd\";\nimport babel from \"@powerlines/plugin-babel\";\nimport deepkit from \"@powerlines/plugin-deepkit\";\nimport { TypeScriptCompilerPluginUserConfig } from \"@powerlines/plugin-tsc\";\nimport { parseTypeDefinition } from \"@stryke/convert/parse-type-definition\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { existsSync } from \"@stryke/fs/exists\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport {\n  TypeDefinition,\n  TypeDefinitionParameter\n} from \"@stryke/types/configuration\";\nimport defu from \"defu\";\nimport { Plugin } from \"powerlines\";\nimport { VIRTUAL_MODULE_PREFIX } from \"powerlines/constants\";\nimport { getDocsOutputPath } from \"powerlines/plugin-utils\";\nimport type { UserConfig as ViteUserConfig } from \"vite\";\nimport { envBabelPlugin } from \"./babel/plugin\";\nimport { EnvDocsFile } from \"./components/docs\";\nimport { EnvBuiltin } from \"./components/env-builtin\";\nimport { env } from \"./helpers/automd-generator\";\nimport { loadEnv } from \"./helpers/load\";\nimport {\n  getEnvDefaultTypeDefinition,\n  getEnvReflectionsPath,\n  getEnvTypeReflectionsPath,\n  getSecretsDefaultTypeDefinition,\n  readEnvReflection,\n  readEnvTypeReflection,\n  readSecretsReflection,\n  writeEnvReflection,\n  writeEnvTypeReflection\n} from \"./helpers/persistence\";\nimport { reflectEnv, reflectSecrets } from \"./helpers/reflect\";\nimport { EnvPluginContext, EnvPluginOptions } from \"./types/plugin\";\n\nexport type * from \"./types\";\n\ndeclare module \"powerlines\" {\n  interface Config {\n    env?: EnvPluginOptions;\n  }\n}\n\n/**\n * A Powerlines plugin to inject environment variables into the source code.\n */\nexport const plugin = <TContext extends EnvPluginContext = EnvPluginContext>(\n  options: EnvPluginOptions = {}\n) => {\n  return [\n    deepkit(options.deepkit),\n    babel(options.babel),\n    {\n      name: \"env:core\",\n      async config() {\n        this.debug(\n          \"Providing default configuration for the Powerlines `env` build plugin.\"\n        );\n\n        const config = {\n          env: defu(options, {\n            types: {} as TypeDefinitionParameter,\n            validate: false,\n            inject: false,\n            prefix: []\n          }),\n          babel: {\n            plugins: [envBabelPlugin]\n          },\n          deepkit: {\n            reflection: \"default\",\n            level: \"all\"\n          },\n          tsc: {} as TypeScriptCompilerPluginUserConfig[\"tsc\"]\n        };\n\n        if (\n          isSetString(config.env.types) ||\n          (config.env.types && isSetString(config.env.types.file))\n        ) {\n          config.env.types = parseTypeDefinition(\n            config.env.types\n          ) as TypeDefinition;\n\n          const file = await this.fs.resolve(config.env.types.file);\n          if (file) {\n            config.env.types.file = file;\n          }\n        } else {\n          this.warn(\n            \"The `env.types` configuration parameter was not provided. Please ensure this is expected.\"\n          );\n\n          const envDefaultTypeDefinition =\n            await getEnvDefaultTypeDefinition(this);\n\n          const file = await this.fs.resolve(envDefaultTypeDefinition.file);\n          if (file) {\n            config.env.types = parseTypeDefinition(\n              `${file}#${envDefaultTypeDefinition.name}`\n            ) as TypeDefinition;\n          }\n        }\n\n        if (\n          isSetString(config.env.secrets) ||\n          (config.env.secrets && isSetString(config.env.secrets.file))\n        ) {\n          config.env.secrets = parseTypeDefinition(config.env.secrets);\n\n          const file = await this.fs.resolve(config.env.secrets!.file);\n          if (file) {\n            config.env.secrets!.file = file;\n          }\n        } else {\n          const secretsDefaultTypeDefinition =\n            await getSecretsDefaultTypeDefinition(this);\n\n          const file = await this.fs.resolve(secretsDefaultTypeDefinition.file);\n          if (file) {\n            config.env.secrets = parseTypeDefinition(\n              `${file}#${secretsDefaultTypeDefinition.name}`\n            );\n          }\n        }\n\n        if (config.env.types || config.env.secrets) {\n          config.tsc.filter = {\n            id: [\n              new RegExp(\n                `^(${VIRTUAL_MODULE_PREFIX})?${joinPaths(\n                  this.builtinsPath,\n                  \"env.ts\"\n                )\n                  .replace(/\\\\/g, \"\\\\\\\\\")\n                  .replace(/\\//g, \"\\\\/\")\n                  .replace(/\\./g, \"\\\\.\")\n                  .replace(/\\$/g, \"\\\\$\")}$`\n              )\n            ]\n          };\n        }\n\n        config.env.prefix = toArray(\n          (config.env.prefix ?? []) as string[]\n        ).reduce(\n          (ret: string[], prefix: string) => {\n            const formattedPrefix = constantCase(prefix);\n            if (!ret.includes(formattedPrefix)) {\n              ret.push(formattedPrefix);\n            }\n\n            return ret;\n          },\n          [\n            \"POWERLINES_\",\n            this.config.framework &&\n              this.config.framework !== \"powerlines\" &&\n              `${constantCase(this.config.framework)}_`\n          ].filter(Boolean) as string[]\n        );\n\n        config.env.prefix = getUnique(\n          toArray(config.env.prefix).reduce((ret, prefix) => {\n            if (!ret.includes(prefix.replace(/_$/g, \"\"))) {\n              ret.push(prefix.replace(/_$/g, \"\"));\n            }\n            return ret;\n          }, [] as string[])\n        );\n\n        return config;\n      },\n      async configResolved() {\n        this.debug(\n          `Environment plugin configuration has been resolved for the Powerlines project.`\n        );\n\n        this.env = defu(\n          {\n            parsed: await loadEnv(this, this.config.env)\n          },\n          this.env ?? {},\n          {\n            types: {\n              env: {}\n            },\n            used: {\n              env: {},\n              secrets: {}\n            },\n            parsed: {},\n            injected: {}\n          }\n        );\n\n        if (\n          this.config.command !== \"prepare\" &&\n          !this.config.skipCache &&\n          this.persistedMeta?.checksum === this.meta.checksum &&\n          existsSync(getEnvTypeReflectionsPath(this, \"env\"))\n        ) {\n          this.debug(\n            `Skipping reflection initialization as the meta checksum has not changed.`\n          );\n\n          this.env.types.env = await readEnvTypeReflection(this, \"env\");\n\n          if (existsSync(getEnvReflectionsPath(this, \"env\"))) {\n            this.env.used.env = await readEnvReflection(this);\n          }\n\n          if (existsSync(getEnvTypeReflectionsPath(this, \"secrets\"))) {\n            this.env.types.secrets = await readEnvTypeReflection(\n              this,\n              \"secrets\"\n            );\n          }\n\n          if (existsSync(getEnvReflectionsPath(this, \"secrets\"))) {\n            this.env.used.secrets = await readSecretsReflection(this);\n          }\n        } else {\n          this.debug(\n            `Starting environment configuration reflection initialization.`\n          );\n\n          this.env.types.env = await reflectEnv(\n            this,\n            this.config.env.types?.file,\n            this.config.env.types?.name\n          );\n          if (!this.env.types.env) {\n            throw new Error(\n              \"Failed to find the environment configuration type reflection in the context.\"\n            );\n          }\n\n          await writeEnvTypeReflection(this, this.env.types.env, \"env\");\n\n          this.env.types.secrets = await reflectSecrets(\n            this,\n            this.config.env.secrets?.file,\n            this.config.env.secrets?.name\n          );\n          if (!this.env.types.secrets) {\n            throw new Error(\n              \"Failed to find the secrets configuration type reflection in the context.\"\n            );\n          }\n\n          await writeEnvTypeReflection(this, this.env.types.secrets, \"secrets\");\n\n          this.debug(\n            `Resolved ${\n              this.env.types.env.getProperties().length ?? 0\n            } environment configuration parameters and ${\n              this.env.types.secrets?.getProperties().length ?? 0\n            } secret configuration parameters`\n          );\n\n          const envWithAlias = this.env.types.env\n            .getProperties()\n            .filter(prop => prop.getAlias().length > 0);\n\n          Object.entries(await loadEnv(this, this.config.env)).forEach(\n            ([key, value]) => {\n              const unprefixedKey = this.config.env.prefix.reduce(\n                (ret, prefix) => {\n                  if (key.replace(/_$/g, \"\").startsWith(prefix)) {\n                    return key.replace(/_$/g, \"\").slice(prefix.length);\n                  }\n                  return ret;\n                },\n                key\n              );\n\n              const aliasKey = envWithAlias.find(prop =>\n                prop?.getAlias().reverse().includes(unprefixedKey)\n              );\n              if (this.env.types.env?.hasProperty(unprefixedKey) || aliasKey) {\n                this.env.types.env\n                  .getProperty(unprefixedKey)\n                  .setDefaultValue(value);\n              }\n            }\n          );\n\n          this.env.used.env = new ReflectionClass(\n            {\n              kind: ReflectionKind.objectLiteral,\n              typeName: \"Env\",\n              description: `An object containing the environment configuration parameters used by the ${\n                this.config.name\n                  ? `${this.config.name} application`\n                  : \"application\"\n              }.`,\n              types: []\n            },\n            this.env.types.env\n          );\n\n          await writeEnvReflection(this, this.env.used.env, \"env\");\n\n          if (this.env.types.secrets) {\n            await writeEnvTypeReflection(\n              this,\n              this.env.types.secrets,\n              \"secrets\"\n            );\n\n            this.env.used.secrets = new ReflectionClass(\n              {\n                kind: ReflectionKind.objectLiteral,\n                typeName: \"Secrets\",\n                description: `An object containing the secret configuration parameters used by the ${\n                  this.config.name\n                    ? `${this.config.name} application`\n                    : \"application\"\n                }.`,\n                types: []\n              },\n              this.env.types.secrets\n            );\n            await writeEnvReflection(this, this.env.used.secrets, \"secrets\");\n          }\n        }\n      },\n      async prepare() {\n        this.debug(\n          `Preparing the Environment runtime artifacts for the Powerlines project.`\n        );\n\n        const result = await readEnvTypeReflection(this, \"env\");\n\n        return render(\n          this,\n          <EnvBuiltin\n            defaultConfig={this.config.env.defaultConfig}\n            reflection={result}\n          />\n        );\n      },\n      transform: {\n        order: \"post\",\n        async handler() {\n          if (this.env.used.env.getProperties().length > 0) {\n            this.trace(\n              `Persisting used environment configuration reflections to ${getEnvReflectionsPath(\n                this,\n                \"env\"\n              )}.`\n            );\n            await writeEnvReflection(this, this.env.used.env, \"env\");\n          }\n\n          if (this.env.used.secrets.getProperties().length > 0) {\n            this.trace(\n              `Persisting used secret configuration reflections to ${getEnvReflectionsPath(\n                this,\n                \"secrets\"\n              )}.`\n            );\n            await writeEnvReflection(this, this.env.used.secrets, \"secrets\");\n          }\n        }\n      },\n      async docs() {\n        this.debug(\n          `Documenting environment variables configuration values in \"${joinPaths(\n            getDocsOutputPath(this.config.root),\n            \"env.md\"\n          )}\"`\n        );\n\n        const result = await readEnvTypeReflection(this, \"env\");\n\n        return render(\n          this,\n          <EnvDocsFile levelOffset={0} reflection={result} />\n        );\n      },\n      async buildEnd() {\n        const reflectionPath = getEnvReflectionsPath(this, \"env\");\n\n        this.debug(`Writing env reflection types to ${reflectionPath}.`);\n\n        await writeEnvReflection(this, this.env.used.env, \"env\");\n      }\n    },\n    {\n      name: \"env:automd-generator\",\n      config() {\n        return {\n          automd: defu(options.automd ?? {}, {\n            generators: {\n              env: env(this)\n            }\n          })\n        };\n      }\n    },\n    {\n      name: \"env:vite\",\n      vite: {\n        configResolved(this: TContext) {\n          return {\n            envPrefix: this.config?.env?.prefix\n          } as ViteUserConfig;\n        }\n      }\n    },\n    automd(options.automd)\n  ] as Plugin<TContext>[];\n};\n\nexport default plugin;\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-env",
-  "version": "0.16.136",
+  "version": "0.16.138",
   "private": false,
   "description": "A package containing a Powerlines plugin for injecting static .env configuration values to the code so that they're accessible at runtime.",
   "keywords": ["dotenv", "powerlines", "storm-software", "powerlines-plugin"],
@@ -166,20 +166,6 @@
         "default": "./dist/helpers/create-reflection-resource.mjs"
       }
     },
-    "./helpers/docs-helper": {
-      "require": {
-        "types": "./dist/helpers/docs-helper.d.cts",
-        "default": "./dist/helpers/docs-helper.cjs"
-      },
-      "import": {
-        "types": "./dist/helpers/docs-helper.d.mts",
-        "default": "./dist/helpers/docs-helper.mjs"
-      },
-      "default": {
-        "types": "./dist/helpers/docs-helper.d.mts",
-        "default": "./dist/helpers/docs-helper.mjs"
-      }
-    },
     "./helpers/load": {
       "require": {
         "types": "./dist/helpers/load.d.cts",
@@ -306,12 +292,12 @@
     "@alloy-js/typescript": "0.23.0-dev.4",
     "@babel/core": "8.0.0-rc.3",
     "@babel/types": "8.0.0-rc.3",
-    "@powerlines/plugin-alloy": "^0.26.29",
-    "@powerlines/plugin-automd": "^0.1.411",
-    "@powerlines/plugin-babel": "^0.12.405",
-    "@powerlines/plugin-plugin": "^0.12.362",
-    "@powerlines/deepkit": "^0.8.13",
-    "@powerlines/plugin-deepkit": "^0.11.292",
+    "@powerlines/plugin-alloy": "^0.26.31",
+    "@powerlines/plugin-automd": "^0.1.413",
+    "@powerlines/plugin-babel": "^0.12.407",
+    "@powerlines/plugin-plugin": "^0.12.364",
+    "@powerlines/deepkit": "^0.8.15",
+    "@powerlines/plugin-deepkit": "^0.11.294",
     "@storm-software/config-tools": "^1.189.77",
     "@stryke/capnp": "^0.12.92",
     "@stryke/convert": "^0.6.58",
@@ -325,10 +311,10 @@
     "@stryke/types": "^0.11.3",
     "automd": "^0.4.3",
     "defu": "^6.1.7",
-    "powerlines": "^0.43.10",
+    "powerlines": "^0.43.12",
     "c12": "^3.3.4"
   },
   "devDependencies": { "@types/node": "^25.6.0", "vite": "^8.0.10" },
   "publishConfig": { "access": "public" },
-  "gitHead": "713163d802aa1d7c282a417119df058b4f151781"
+  "gitHead": "38520490a931e823de74962179f663502a83c4ea"
 }

package/dist/helpers/docs-helper.cjs

@@ -1,25 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-const require_types_plugin = require('../types/plugin.cjs');
-let _stryke_path_join = require("@stryke/path/join");
-
-//#region src/helpers/docs-helper.ts
-/**
-* Gets the output path for the generated environment documentation.
-*
-* @param context - The environment plugin context.
-* @returns The output path for the generated environment documentation.
-*/
-function getDocsOutputPath(context) {
-	return (0, _stryke_path_join.joinPaths)(context.config.root, "docs", "reference");
-}
-getDocsOutputPath.__type = [
-	() => require_types_plugin.__ΩEnvPluginContext,
-	"context",
-	"getDocsOutputPath",
-	"Gets the output path for the generated environment documentation.",
-	"Pn!2\"&/#?$"
-];
-
-//#endregion
-exports.getDocsOutputPath = getDocsOutputPath;

package/dist/helpers/docs-helper.d.cts

@@ -1,13 +0,0 @@
-import { EnvPluginContext } from "../types/plugin.cjs";
-
-//#region src/helpers/docs-helper.d.ts
-/**
- * Gets the output path for the generated environment documentation.
- *
- * @param context - The environment plugin context.
- * @returns The output path for the generated environment documentation.
- */
-declare function getDocsOutputPath(context: EnvPluginContext): string;
-//#endregion
-export { getDocsOutputPath };
-//# sourceMappingURL=docs-helper.d.cts.map

package/dist/helpers/docs-helper.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"docs-helper.d.cts","names":[],"sources":["../../src/helpers/docs-helper.ts"],"mappings":";;;;;AA2BA;;;;iBAAgB,iBAAA,CAAkB,OAAA,EAAS,gBAAA"}

package/dist/helpers/docs-helper.d.mts

@@ -1,13 +0,0 @@
-import { EnvPluginContext } from "../types/plugin.mjs";
-
-//#region src/helpers/docs-helper.d.ts
-/**
- * Gets the output path for the generated environment documentation.
- *
- * @param context - The environment plugin context.
- * @returns The output path for the generated environment documentation.
- */
-declare function getDocsOutputPath(context: EnvPluginContext): string;
-//#endregion
-export { getDocsOutputPath };
-//# sourceMappingURL=docs-helper.d.mts.map

package/dist/helpers/docs-helper.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"docs-helper.d.mts","names":[],"sources":["../../src/helpers/docs-helper.ts"],"mappings":";;;;;AA2BA;;;;iBAAgB,iBAAA,CAAkB,OAAA,EAAS,gBAAA"}

package/dist/helpers/docs-helper.mjs

@@ -1,24 +0,0 @@
-import { __ΩEnvPluginContext } from "../types/plugin.mjs";
-import { joinPaths } from "@stryke/path/join";
-
-//#region src/helpers/docs-helper.ts
-/**
-* Gets the output path for the generated environment documentation.
-*
-* @param context - The environment plugin context.
-* @returns The output path for the generated environment documentation.
-*/
-function getDocsOutputPath(context) {
-	return joinPaths(context.config.root, "docs", "reference");
-}
-getDocsOutputPath.__type = [
-	() => __ΩEnvPluginContext,
-	"context",
-	"getDocsOutputPath",
-	"Gets the output path for the generated environment documentation.",
-	"Pn!2\"&/#?$"
-];
-
-//#endregion
-export { getDocsOutputPath };
-//# sourceMappingURL=docs-helper.mjs.map

package/dist/helpers/docs-helper.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"docs-helper.mjs","names":[],"sources":["../../src/helpers/docs-helper.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 { joinPaths } from \"@stryke/path/join\";\nimport { EnvPluginContext } from \"../types/plugin\";\n\n/**\n * Gets the output path for the generated environment documentation.\n *\n * @param context - The environment plugin context.\n * @returns The output path for the generated environment documentation.\n */\nexport function getDocsOutputPath(context: EnvPluginContext): string {\n  return joinPaths(context.config.root, \"docs\", \"reference\");\n}\n"],"mappings":";;;;;;;;;;AA0BA,SAAE,kBAAA,SAAA;AACF,QAAO,UAAS,QAAA,OAAkB,MAAA,QAAS,YAAiB;;AAE5D,kBAAA,SAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}