@powerlines/plugin-env 0.15.112 → 0.15.114

package/dist/components/docs.cjs

@@ -1,6 +1,7 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 const require_join_paths = require('../node_modules/.pnpm/@stryke_path@0.26.0/node_modules/@stryke/path/dist/join-paths.cjs');
 const require_helpers_create_reflection_resource = require('../helpers/create-reflection-resource.cjs');
+const require_helpers_docs_helper = require('../helpers/docs-helper.cjs');
 let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
 let __alloy_js_core = require("@alloy-js/core");
 let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
@@ -13,59 +14,57 @@ let __powerlines_plugin_alloy_markdown_components_markdown_table = require("@pow
 /**
 * Generates the environment configuration markdown documentation for the Powerlines project.
 */
-function EnvDocs() {
+function EnvDocsFile(props) {
+	const { levelOffset = 0, ...rest } = props;
 	const context = (0, __powerlines_plugin_alloy_core_contexts_context.usePowerlinesSafe)();
 	if (!context) return null;
 	const reflection = require_helpers_create_reflection_resource.createReflectionResource(context);
-	return (0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_markdown_components_markdown_file.MarkdownFile, {
-		get path() {
-			return require_join_paths.joinPaths(context.config.projectRoot, "docs", "generated", "env.md");
-		},
-		get children() {
-			return [
-				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Heading, {
-					level: 1,
-					children: "Environment Configuration"
-				}),
-				__alloy_js_core.code`Below is a list of environment variables used by the`,
-				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
-					get when() {
-						return !!context?.packageJson.name;
-					},
-					get children() {
-						return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Link, {
-							get href() {
-								return `https://www.npmjs.com/package/${context?.packageJson.name}`;
-							},
-							get title() {
-								return context.packageJson.name;
-							}
-						});
-					}
-				}),
-				__alloy_js_core.code`package. These values can be updated in the \`.env\` file in the root of the project.`,
-				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Heading, {
-					level: 2,
-					children: "Environment Variables"
-				}),
-				__alloy_js_core.code`The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.`,
-				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_markdown_components_markdown_table.MarkdownTable, { get data() {
-					return reflection.data?.getProperties().filter((property) => property.getNameAsString() !== "__STORM_INJECTED__").sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())).map((reflectionProperty) => {
-						return {
-							name: reflectionProperty.getNameAsString().trim(),
-							description: (reflectionProperty.getDescription() ?? "").trim(),
-							type: (0, __powerlines_deepkit_vendor_type.stringifyType)(reflectionProperty.getType()).trim().replaceAll(" | ", ", or "),
-							defaultValue: reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : "",
-							required: reflectionProperty.isValueRequired() ? "" : "✔"
-						};
-					}) ?? [];
-				} })
-			];
-		}
-	});
+	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 require_join_paths.joinPaths(require_helpers_docs_helper.getDocsOutputPath(context), "env.md");
+	} }, rest, { get children() {
+		return [
+			(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Heading, {
+				level: 1 + levelOffset,
+				children: "Environment Configuration"
+			}),
+			__alloy_js_core.code`Below is a list of environment variables used by the`,
+			(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+				get when() {
+					return !!context?.packageJson.name;
+				},
+				get children() {
+					return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Link, {
+						get href() {
+							return `https://www.npmjs.com/package/${context?.packageJson.name}`;
+						},
+						get title() {
+							return context.packageJson.name;
+						}
+					});
+				}
+			}),
+			__alloy_js_core.code`package. These values can be updated in the \`.env\` file in the root of the project.`,
+			(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+			(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Heading, {
+				level: 2 + levelOffset,
+				children: "Environment Variables"
+			}),
+			__alloy_js_core.code`The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.`,
+			(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+			(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_markdown_components_markdown_table.MarkdownTable, { get data() {
+				return reflection.data?.getProperties().filter((property) => property.getNameAsString() !== "__STORM_INJECTED__").sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())).map((reflectionProperty) => {
+					return {
+						name: reflectionProperty.getNameAsString().trim(),
+						description: (reflectionProperty.getDescription() ?? "").trim(),
+						type: (0, __powerlines_deepkit_vendor_type.stringifyType)(reflectionProperty.getType()).trim().replaceAll(" | ", ", or "),
+						defaultValue: reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : "",
+						required: reflectionProperty.isValueRequired() ? "" : "✔"
+					};
+				}) ?? [];
+			} })
+		];
+	} }));
 }
 
 //#endregion
-exports.EnvDocs = EnvDocs;
+exports.EnvDocsFile = EnvDocsFile;

package/dist/components/docs.d.cts

@@ -1,9 +1,22 @@
+import { MarkdownFileProps } from "../plugin-alloy/src/markdown/components/markdown-file.cjs";
 import * as _alloy_js_core0 from "@alloy-js/core";
 
 //#region src/components/docs.d.ts
+interface EnvDocsFileProps extends Partial<MarkdownFileProps> {
+  /**
+   * The heading level offset to apply to the generated documentation.
+   *
+   * @remarks
+   * This is useful when nesting the documentation within other markdown files.
+   *
+   * @defaultValue 0
+   */
+  levelOffset?: number;
+}
 /**
  * Generates the environment configuration markdown documentation for the Powerlines project.
  */
-declare function EnvDocs(): _alloy_js_core0.Children;
+declare function EnvDocsFile(props: EnvDocsFileProps): _alloy_js_core0.Children;
+declare type __ΩEnvDocsFileProps = any[];
 //#endregion
-export { EnvDocs };
+export { EnvDocsFile, EnvDocsFileProps, __ΩEnvDocsFileProps };

package/dist/components/docs.d.mts

@@ -1,9 +1,22 @@
+import { MarkdownFileProps } from "../packages/plugin-alloy/src/markdown/components/markdown-file.mjs";
 import * as _alloy_js_core0 from "@alloy-js/core";
 
 //#region src/components/docs.d.ts
+interface EnvDocsFileProps extends Partial<MarkdownFileProps> {
+  /**
+   * The heading level offset to apply to the generated documentation.
+   *
+   * @remarks
+   * This is useful when nesting the documentation within other markdown files.
+   *
+   * @defaultValue 0
+   */
+  levelOffset?: number;
+}
 /**
  * Generates the environment configuration markdown documentation for the Powerlines project.
  */
-declare function EnvDocs(): _alloy_js_core0.Children;
+declare function EnvDocsFile(props: EnvDocsFileProps): _alloy_js_core0.Children;
+declare type __ΩEnvDocsFileProps = any[];
 //#endregion
-export { EnvDocs };
+export { EnvDocsFile, EnvDocsFileProps, __ΩEnvDocsFileProps };

package/dist/components/docs.mjs

@@ -1,8 +1,9 @@
 import { joinPaths } from "../node_modules/.pnpm/@stryke_path@0.26.0/node_modules/@stryke/path/dist/join-paths.mjs";
 import { createReflectionResource } from "../helpers/create-reflection-resource.mjs";
+import { getDocsOutputPath } from "../helpers/docs-helper.mjs";
 import { stringifyType } from "@powerlines/deepkit/vendor/type";
 import { Show, code } from "@alloy-js/core";
-import { createComponent, createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { createComponent, createIntrinsic, mergeProps } from "@alloy-js/core/jsx-runtime";
 import { Heading, Link } from "@alloy-js/markdown";
 import { usePowerlinesSafe } from "@powerlines/plugin-alloy/core/contexts/context";
 import { MarkdownFile } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
@@ -12,59 +13,57 @@ import { MarkdownTable } from "@powerlines/plugin-alloy/markdown/components/mark
 /**
 * Generates the environment configuration markdown documentation for the Powerlines project.
 */
-function EnvDocs() {
+function EnvDocsFile(props) {
+	const { levelOffset = 0, ...rest } = props;
 	const context = usePowerlinesSafe();
 	if (!context) return null;
 	const reflection = createReflectionResource(context);
-	return createComponent(MarkdownFile, {
-		get path() {
-			return joinPaths(context.config.projectRoot, "docs", "generated", "env.md");
-		},
-		get children() {
-			return [
-				createComponent(Heading, {
-					level: 1,
-					children: "Environment Configuration"
-				}),
-				code`Below is a list of environment variables used by the`,
-				createComponent(Show, {
-					get when() {
-						return !!context?.packageJson.name;
-					},
-					get children() {
-						return createComponent(Link, {
-							get href() {
-								return `https://www.npmjs.com/package/${context?.packageJson.name}`;
-							},
-							get title() {
-								return context.packageJson.name;
-							}
-						});
-					}
-				}),
-				code`package. These values can be updated in the \`.env\` file in the root of the project.`,
-				createIntrinsic("hbr", {}),
-				createComponent(Heading, {
-					level: 2,
-					children: "Environment Variables"
-				}),
-				code`The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.`,
-				createIntrinsic("hbr", {}),
-				createComponent(MarkdownTable, { get data() {
-					return reflection.data?.getProperties().filter((property) => property.getNameAsString() !== "__STORM_INJECTED__").sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())).map((reflectionProperty) => {
-						return {
-							name: reflectionProperty.getNameAsString().trim(),
-							description: (reflectionProperty.getDescription() ?? "").trim(),
-							type: stringifyType(reflectionProperty.getType()).trim().replaceAll(" | ", ", or "),
-							defaultValue: reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : "",
-							required: reflectionProperty.isValueRequired() ? "" : "✔"
-						};
-					}) ?? [];
-				} })
-			];
-		}
-	});
+	return createComponent(MarkdownFile, mergeProps({ get path() {
+		return joinPaths(getDocsOutputPath(context), "env.md");
+	} }, rest, { get children() {
+		return [
+			createComponent(Heading, {
+				level: 1 + levelOffset,
+				children: "Environment Configuration"
+			}),
+			code`Below is a list of environment variables used by the`,
+			createComponent(Show, {
+				get when() {
+					return !!context?.packageJson.name;
+				},
+				get children() {
+					return createComponent(Link, {
+						get href() {
+							return `https://www.npmjs.com/package/${context?.packageJson.name}`;
+						},
+						get title() {
+							return context.packageJson.name;
+						}
+					});
+				}
+			}),
+			code`package. These values can be updated in the \`.env\` file in the root of the project.`,
+			createIntrinsic("hbr", {}),
+			createComponent(Heading, {
+				level: 2 + levelOffset,
+				children: "Environment Variables"
+			}),
+			code`The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.`,
+			createIntrinsic("hbr", {}),
+			createComponent(MarkdownTable, { get data() {
+				return reflection.data?.getProperties().filter((property) => property.getNameAsString() !== "__STORM_INJECTED__").sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())).map((reflectionProperty) => {
+					return {
+						name: reflectionProperty.getNameAsString().trim(),
+						description: (reflectionProperty.getDescription() ?? "").trim(),
+						type: stringifyType(reflectionProperty.getType()).trim().replaceAll(" | ", ", or "),
+						defaultValue: reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : "",
+						required: reflectionProperty.isValueRequired() ? "" : "✔"
+					};
+				}) ?? [];
+			} })
+		];
+	} }));
 }
 
 //#endregion
-export { EnvDocs };
+export { EnvDocsFile };

package/dist/components/index.cjs

@@ -2,5 +2,5 @@ const require_components_docs = require('./docs.cjs');
 const require_components_env = require('./env.cjs');
 
 exports.EnvBuiltin = require_components_env.EnvBuiltin;
-exports.EnvDocs = require_components_docs.EnvDocs;
+exports.EnvDocsFile = require_components_docs.EnvDocsFile;
 exports.EnvTypeDefinition = require_components_env.EnvTypeDefinition;

package/dist/components/index.d.cts

@@ -1,3 +1,3 @@
-import { EnvDocs } from "./docs.cjs";
+import { EnvDocsFile, EnvDocsFileProps, __ΩEnvDocsFileProps } from "./docs.cjs";
 import { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps } from "./env.cjs";
-export { EnvBuiltin, EnvBuiltinProps, EnvDocs, EnvTypeDefinition, __ΩEnvBuiltinProps };
+export { EnvBuiltin, EnvBuiltinProps, EnvDocsFile, EnvDocsFileProps, EnvTypeDefinition, __ΩEnvBuiltinProps, __ΩEnvDocsFileProps };

package/dist/components/index.d.mts

@@ -1,3 +1,3 @@
-import { EnvDocs } from "./docs.mjs";
+import { EnvDocsFile, EnvDocsFileProps, __ΩEnvDocsFileProps } from "./docs.mjs";
 import { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps } from "./env.mjs";
-export { EnvBuiltin, EnvBuiltinProps, EnvDocs, EnvTypeDefinition, __ΩEnvBuiltinProps };
+export { EnvBuiltin, EnvBuiltinProps, EnvDocsFile, EnvDocsFileProps, EnvTypeDefinition, __ΩEnvBuiltinProps, __ΩEnvDocsFileProps };

package/dist/components/index.mjs

@@ -1,4 +1,4 @@
-import { EnvDocs } from "./docs.mjs";
+import { EnvDocsFile } from "./docs.mjs";
 import { EnvBuiltin, EnvTypeDefinition } from "./env.mjs";
 
-export { EnvBuiltin, EnvDocs, EnvTypeDefinition };
+export { EnvBuiltin, EnvDocsFile, EnvTypeDefinition };

package/dist/helpers/docs-helper.cjs

@@ -0,0 +1,23 @@
+const require_types_plugin = require('../types/plugin.cjs');
+const require_join_paths = require('../node_modules/.pnpm/@stryke_path@0.26.0/node_modules/@stryke/path/dist/join-paths.cjs');
+
+//#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 require_join_paths.joinPaths(context.config.projectRoot, "docs", "generated");
+}
+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

@@ -0,0 +1,13 @@
+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 };

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

@@ -0,0 +1,13 @@
+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 };

package/dist/helpers/docs-helper.mjs

@@ -0,0 +1,23 @@
+import { __ΩEnvPluginContext } from "../types/plugin.mjs";
+import { joinPaths } from "../node_modules/.pnpm/@stryke_path@0.26.0/node_modules/@stryke/path/dist/join-paths.mjs";
+
+//#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.projectRoot, "docs", "generated");
+}
+getDocsOutputPath.__type = [
+	() => __ΩEnvPluginContext,
+	"context",
+	"getDocsOutputPath",
+	"Gets the output path for the generated environment documentation.",
+	"Pn!2\"&/#?$"
+];
+
+//#endregion
+export { getDocsOutputPath };

package/dist/helpers/reflect.cjs

@@ -55,8 +55,17 @@ const __ΩCreateEnvReflectionOptions = [
 	"PPn!n\"J4#8P\"7$4%8Mw&y"
 ];
 var BaseEnv = class {
+	APP_NAME;
+	APP_VERSION;
+	BUILD_ID;
+	BUILD_TIMESTAMP;
+	BUILD_CHECKSUM;
+	RELEASE_ID;
+	RELEASE_TAG;
+	ORGANIZATION;
 	PLATFORM = "neutral";
 	MODE = "production";
+	ENVIRONMENT;
 	DEBUG = false;
 	TEST = false;
 	MINIMAL = false;
@@ -65,6 +74,9 @@ var BaseEnv = class {
 	FORCE_HYPERLINK = false;
 	STACKTRACE = false;
 	INCLUDE_ERROR_DATA = false;
+	ERROR_URL;
+	DEFAULT_TIMEZONE;
+	DEFAULT_LOCALE;
 	CI = false;
 	static __type = [
 		"APP_NAME",
@@ -135,6 +147,7 @@ var BaseEnv = class {
 	];
 };
 var BaseSecrets = class {
+	ENCRYPTION_KEY;
 	static __type = [
 		"ENCRYPTION_KEY",
 		() => require_types_runtime.__ΩSecretsInterface,

package/dist/helpers/reflect.mjs

@@ -54,8 +54,17 @@ const __ΩCreateEnvReflectionOptions = [
 	"PPn!n\"J4#8P\"7$4%8Mw&y"
 ];
 var BaseEnv = class {
+	APP_NAME;
+	APP_VERSION;
+	BUILD_ID;
+	BUILD_TIMESTAMP;
+	BUILD_CHECKSUM;
+	RELEASE_ID;
+	RELEASE_TAG;
+	ORGANIZATION;
 	PLATFORM = "neutral";
 	MODE = "production";
+	ENVIRONMENT;
 	DEBUG = false;
 	TEST = false;
 	MINIMAL = false;
@@ -64,6 +73,9 @@ var BaseEnv = class {
 	FORCE_HYPERLINK = false;
 	STACKTRACE = false;
 	INCLUDE_ERROR_DATA = false;
+	ERROR_URL;
+	DEFAULT_TIMEZONE;
+	DEFAULT_LOCALE;
 	CI = false;
 	static __type = [
 		"APP_NAME",
@@ -134,6 +146,7 @@ var BaseEnv = class {
 	];
 };
 var BaseSecrets = class {
+	ENCRYPTION_KEY;
 	static __type = [
 		"ENCRYPTION_KEY",
 		() => __ΩSecretsInterface,

package/dist/index.cjs

@@ -13,6 +13,7 @@ const require_defu = require('./node_modules/.pnpm/defu@6.1.4/node_modules/defu/
 const require_helpers_load = require('./helpers/load.cjs');
 const require_helpers_create_reflection_resource = require('./helpers/create-reflection-resource.cjs');
 require('./helpers/index.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 = require('./components/env.cjs');
@@ -22,7 +23,6 @@ require('./babel/index.cjs');
 const require_parse_type_definition = require('./node_modules/.pnpm/@stryke_convert@0.6.35/node_modules/@stryke/convert/dist/parse-type-definition.cjs');
 const require_to_array = require('./node_modules/.pnpm/@stryke_convert@0.6.35/node_modules/@stryke/convert/dist/to-array.cjs');
 let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
-let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
 let __stryke_env_types = require("@stryke/env/types");
 let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let __powerlines_plugin_alloy = require("@powerlines/plugin-alloy");
@@ -32,7 +32,6 @@ __powerlines_plugin_automd = require_rolldown_runtime.__toESM(__powerlines_plugi
 let __powerlines_plugin_babel = require("@powerlines/plugin-babel");
 __powerlines_plugin_babel = require_rolldown_runtime.__toESM(__powerlines_plugin_babel);
 let __stryke_fs_exists = require("@stryke/fs/exists");
-let __stryke_fs_helpers = require("@stryke/fs/helpers");
 let __stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
 
 //#region src/index.tsx
@@ -155,22 +154,8 @@ const plugin = (options = {}) => {
 				}
 			},
 			async docs() {
-				this.debug("Writing Environment documentation for the Powerlines project artifacts.");
-				const outputPath = require_join_paths.joinPaths(this.config.projectRoot, "docs", "generated");
-				if (!(0, __stryke_fs_exists.existsSync)(outputPath)) await (0, __stryke_fs_helpers.createDirectory)(outputPath);
-				const reflection = await require_helpers_persistence.readEnvTypeReflection(this, "env");
-				const envDocFile = require_join_paths.joinPaths(outputPath, "env.md");
-				this.debug(`Documenting environment variables configuration in "${envDocFile}"`);
-				await this.fs.write(envDocFile, `<!-- Generated by ${(0, __stryke_string_format_title_case.titleCase)(this.config.framework) || "Powerlines"} -->
-
-Below is a list of environment variables used by the [${this.packageJson.name}](https://www.npmjs.com/package/${this.packageJson.name}) package. These values can be updated in the \`.env\` file in the root of the project. The variables in the list below are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.
-
-| Name | Description | Type | Default Value | Required |
-| ---- | ----------- | ---- | ------------- | :------: |
-${reflection.getProperties().filter((property) => property.getNameAsString() !== "__POWERLINES_INJECTED__").sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())).map((reflectionProperty) => {
-					return `| ${reflectionProperty.getNameAsString().trim()} | ${(reflectionProperty.getDescription()?.replaceAll("\r", "")?.replaceAll("\n", "") ?? "").trim()} | ${(0, __powerlines_deepkit_vendor_type.stringifyType)(reflectionProperty.getType()).trim().replaceAll(" | ", ", or ")} | ${reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : ""} | ${reflectionProperty.isValueRequired() ? "" : "✔"} |`;
-				}).join("\n")}
-`);
+				this.debug(`Documenting environment variables configuration values in "${require_join_paths.joinPaths(require_helpers_docs_helper.getDocsOutputPath(this), "env.md")}"`);
+				return this.render((0, __alloy_js_core_jsx_runtime.createComponent)(require_components_docs.EnvDocsFile, { levelOffset: 0 }));
 			},
 			async buildEnd() {
 				const reflectionPath = require_helpers_persistence.getEnvReflectionsPath(this, "env");
@@ -199,7 +184,7 @@ var src_default = plugin;
 exports.BaseEnv = require_helpers_reflect.BaseEnv;
 exports.BaseSecrets = require_helpers_reflect.BaseSecrets;
 exports.EnvBuiltin = require_components_env.EnvBuiltin;
-exports.EnvDocs = require_components_docs.EnvDocs;
+exports.EnvDocsFile = require_components_docs.EnvDocsFile;
 exports.EnvTypeDefinition = require_components_env.EnvTypeDefinition;
 exports.__ΩCreateEnvReflectionOptions = require_helpers_reflect.__ΩCreateEnvReflectionOptions;
 exports.__ΩEnvInterface = require_types_runtime.__ΩEnvInterface;

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { Plugin } from "./powerlines/src/types/plugin.cjs";
 import { EnvInterface, SecretsInterface, __ΩEnvInterface, __ΩSecretsInterface } from "./types/runtime.cjs";
 import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType } from "./types/plugin.cjs";
-import { EnvDocs } from "./components/docs.cjs";
+import { EnvDocsFile, EnvDocsFileProps, __ΩEnvDocsFileProps } from "./components/docs.cjs";
 import { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps } from "./components/env.cjs";
 import "./components/index.cjs";
 import { createReflectionResource } from "./helpers/create-reflection-resource.cjs";
@@ -21,4 +21,4 @@ import "./babel/index.cjs";
  */
 declare const plugin: <TContext extends EnvPluginContext = EnvPluginContext>(options?: EnvPluginOptions) => Plugin<TContext>[];
 //#endregion
-export { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, EnvBuiltin, EnvBuiltinProps, EnvDocs, EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, EnvTypeDefinition, SecretsInterface, __ΩCreateEnvReflectionOptions, __ΩEnvBuiltinProps, __ΩEnvInterface, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType, __ΩSecretsInterface, createEnvReflection, createReflectionResource, createSecretsReflection, createTemplateReflection, plugin as default, plugin, envBabelPlugin, formatEnvField, getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, loadEnv, loadEnvFromContext, mergeEnvReflections, mergeSecretsReflections, readEnvReflection, readEnvTypeReflection, readSecretsReflection, reflectEnv, reflectSecrets, removeEnvPrefix, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection };
+export { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, EnvBuiltin, EnvBuiltinProps, EnvDocsFile, EnvDocsFileProps, EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, EnvTypeDefinition, SecretsInterface, __ΩCreateEnvReflectionOptions, __ΩEnvBuiltinProps, __ΩEnvDocsFileProps, __ΩEnvInterface, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType, __ΩSecretsInterface, createEnvReflection, createReflectionResource, createSecretsReflection, createTemplateReflection, plugin as default, plugin, envBabelPlugin, formatEnvField, getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, loadEnv, loadEnvFromContext, mergeEnvReflections, mergeSecretsReflections, readEnvReflection, readEnvTypeReflection, readSecretsReflection, reflectEnv, reflectSecrets, removeEnvPrefix, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection };

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { Plugin } from "./packages/powerlines/src/types/plugin.mjs";
 import { EnvInterface, SecretsInterface, __ΩEnvInterface, __ΩSecretsInterface } from "./types/runtime.mjs";
 import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType } from "./types/plugin.mjs";
-import { EnvDocs } from "./components/docs.mjs";
+import { EnvDocsFile, EnvDocsFileProps, __ΩEnvDocsFileProps } from "./components/docs.mjs";
 import { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps } from "./components/env.mjs";
 import "./components/index.mjs";
 import { createReflectionResource } from "./helpers/create-reflection-resource.mjs";
@@ -21,4 +21,4 @@ import "./babel/index.mjs";
  */
 declare const plugin: <TContext extends EnvPluginContext = EnvPluginContext>(options?: EnvPluginOptions) => Plugin<TContext>[];
 //#endregion
-export { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, EnvBuiltin, EnvBuiltinProps, EnvDocs, EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, EnvTypeDefinition, SecretsInterface, __ΩCreateEnvReflectionOptions, __ΩEnvBuiltinProps, __ΩEnvInterface, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType, __ΩSecretsInterface, createEnvReflection, createReflectionResource, createSecretsReflection, createTemplateReflection, plugin as default, plugin, envBabelPlugin, formatEnvField, getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, loadEnv, loadEnvFromContext, mergeEnvReflections, mergeSecretsReflections, readEnvReflection, readEnvTypeReflection, readSecretsReflection, reflectEnv, reflectSecrets, removeEnvPrefix, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection };
+export { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, EnvBuiltin, EnvBuiltinProps, EnvDocsFile, EnvDocsFileProps, EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, EnvTypeDefinition, SecretsInterface, __ΩCreateEnvReflectionOptions, __ΩEnvBuiltinProps, __ΩEnvDocsFileProps, __ΩEnvInterface, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType, __ΩSecretsInterface, createEnvReflection, createReflectionResource, createSecretsReflection, createTemplateReflection, plugin as default, plugin, envBabelPlugin, formatEnvField, getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, loadEnv, loadEnvFromContext, mergeEnvReflections, mergeSecretsReflections, readEnvReflection, readEnvTypeReflection, readSecretsReflection, reflectEnv, reflectSecrets, removeEnvPrefix, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection };

package/dist/index.mjs

@@ -11,23 +11,22 @@ import { defu } from "./node_modules/.pnpm/defu@6.1.4/node_modules/defu/dist/def
 import { loadEnv, loadEnvFromContext } from "./helpers/load.mjs";
 import { createReflectionResource } from "./helpers/create-reflection-resource.mjs";
 import "./helpers/index.mjs";
+import { getDocsOutputPath } from "./helpers/docs-helper.mjs";
 import { env } from "./helpers/automd-generator.mjs";
-import { EnvDocs } from "./components/docs.mjs";
+import { EnvDocsFile } from "./components/docs.mjs";
 import { EnvBuiltin, EnvTypeDefinition } from "./components/env.mjs";
 import "./components/index.mjs";
 import { envBabelPlugin } from "./babel/plugin.mjs";
 import "./babel/index.mjs";
 import { parseTypeDefinition } from "./node_modules/.pnpm/@stryke_convert@0.6.35/node_modules/@stryke/convert/dist/parse-type-definition.mjs";
 import { toArray } from "./node_modules/.pnpm/@stryke_convert@0.6.35/node_modules/@stryke/convert/dist/to-array.mjs";
-import { ReflectionClass, ReflectionKind, stringifyType } from "@powerlines/deepkit/vendor/type";
-import { titleCase } from "@stryke/string-format/title-case";
+import { ReflectionClass, ReflectionKind } from "@powerlines/deepkit/vendor/type";
 import { ENV_PREFIXES } from "@stryke/env/types";
 import { createComponent } from "@alloy-js/core/jsx-runtime";
 import alloy from "@powerlines/plugin-alloy";
 import automd from "@powerlines/plugin-automd";
 import babel from "@powerlines/plugin-babel";
 import { existsSync } from "@stryke/fs/exists";
-import { createDirectory } from "@stryke/fs/helpers";
 import { constantCase } from "@stryke/string-format/constant-case";
 
 //#region src/index.tsx
@@ -150,22 +149,8 @@ const plugin = (options = {}) => {
 				}
 			},
 			async docs() {
-				this.debug("Writing Environment documentation for the Powerlines project artifacts.");
-				const outputPath = joinPaths(this.config.projectRoot, "docs", "generated");
-				if (!existsSync(outputPath)) await createDirectory(outputPath);
-				const reflection = await readEnvTypeReflection(this, "env");
-				const envDocFile = joinPaths(outputPath, "env.md");
-				this.debug(`Documenting environment variables configuration in "${envDocFile}"`);
-				await this.fs.write(envDocFile, `<!-- Generated by ${titleCase(this.config.framework) || "Powerlines"} -->
-
-Below is a list of environment variables used by the [${this.packageJson.name}](https://www.npmjs.com/package/${this.packageJson.name}) package. These values can be updated in the \`.env\` file in the root of the project. The variables in the list below are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.
-
-| Name | Description | Type | Default Value | Required |
-| ---- | ----------- | ---- | ------------- | :------: |
-${reflection.getProperties().filter((property) => property.getNameAsString() !== "__POWERLINES_INJECTED__").sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())).map((reflectionProperty) => {
-					return `| ${reflectionProperty.getNameAsString().trim()} | ${(reflectionProperty.getDescription()?.replaceAll("\r", "")?.replaceAll("\n", "") ?? "").trim()} | ${stringifyType(reflectionProperty.getType()).trim().replaceAll(" | ", ", or ")} | ${reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : ""} | ${reflectionProperty.isValueRequired() ? "" : "✔"} |`;
-				}).join("\n")}
-`);
+				this.debug(`Documenting environment variables configuration values in "${joinPaths(getDocsOutputPath(this), "env.md")}"`);
+				return this.render(createComponent(EnvDocsFile, { levelOffset: 0 }));
 			},
 			async buildEnd() {
 				const reflectionPath = getEnvReflectionsPath(this, "env");
@@ -191,4 +176,4 @@ ${reflection.getProperties().filter((property) => property.getNameAsString() !==
 var src_default = plugin;
 
 //#endregion
-export { BaseEnv, BaseSecrets, EnvBuiltin, EnvDocs, EnvTypeDefinition, __ΩCreateEnvReflectionOptions, __ΩEnvInterface, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType, __ΩSecretsInterface, createEnvReflection, createReflectionResource, createSecretsReflection, createTemplateReflection, src_default as default, envBabelPlugin, formatEnvField, getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, loadEnv, loadEnvFromContext, mergeEnvReflections, mergeSecretsReflections, plugin, readEnvReflection, readEnvTypeReflection, readSecretsReflection, reflectEnv, reflectSecrets, removeEnvPrefix, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection };
+export { BaseEnv, BaseSecrets, EnvBuiltin, EnvDocsFile, EnvTypeDefinition, __ΩCreateEnvReflectionOptions, __ΩEnvInterface, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType, __ΩSecretsInterface, createEnvReflection, createReflectionResource, createSecretsReflection, createTemplateReflection, src_default as default, envBabelPlugin, formatEnvField, getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, loadEnv, loadEnvFromContext, mergeEnvReflections, mergeSecretsReflections, plugin, readEnvReflection, readEnvTypeReflection, readSecretsReflection, reflectEnv, reflectSecrets, removeEnvPrefix, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection };

package/dist/packages/plugin-alloy/src/markdown/components/markdown-file.d.mts

@@ -0,0 +1,8 @@
+import { ComponentProps } from "../../types/components.mjs";
+import { SourceFileProps as SourceFileProps$1 } from "../../core/components/source-file.mjs";
+import "@alloy-js/core";
+
+//#region ../plugin-alloy/src/markdown/components/markdown-file.d.ts
+type MarkdownFileProps = Omit<SourceFileProps$1, "filetype"> & ComponentProps;
+//#endregion
+export { MarkdownFileProps };

package/dist/packages/plugin-alloy/src/types/plugin.d.mts

@@ -1,6 +1,5 @@
-import { UserConfig } from "../../../powerlines/src/types/config.mjs";
-import { ResolvedConfig } from "../../../powerlines/src/types/resolved.mjs";
 import { PluginContext } from "../../../powerlines/src/types/context.mjs";
+import { BabelPluginResolvedConfig, BabelPluginUserConfig } from "../../../plugin-babel/src/types/plugin.mjs";
 import { Children, PrintTreeOptions } from "@alloy-js/core";
 
 //#region ../plugin-alloy/src/types/plugin.d.ts
@@ -24,10 +23,10 @@ type AlloyPluginOptions = Partial<PrintTreeOptions> & {
    */
   markdown?: boolean;
 };
-type AlloyPluginUserConfig = UserConfig & {
+type AlloyPluginUserConfig = BabelPluginUserConfig & {
   alloy?: AlloyPluginOptions;
 };
-type AlloyPluginResolvedConfig = ResolvedConfig & {
+type AlloyPluginResolvedConfig = BabelPluginResolvedConfig & {
   alloy: AlloyPluginOptions;
 };
 type AlloyPluginContext<TResolvedConfig extends AlloyPluginResolvedConfig = AlloyPluginResolvedConfig> = PluginContext<TResolvedConfig> & {

package/dist/plugin-alloy/src/markdown/components/markdown-file.d.cts

@@ -0,0 +1,8 @@
+import { ComponentProps } from "../../types/components.cjs";
+import { SourceFileProps as SourceFileProps$1 } from "../../core/components/source-file.cjs";
+import "@alloy-js/core";
+
+//#region ../plugin-alloy/src/markdown/components/markdown-file.d.ts
+type MarkdownFileProps = Omit<SourceFileProps$1, "filetype"> & ComponentProps;
+//#endregion
+export { MarkdownFileProps };

package/dist/plugin-alloy/src/types/plugin.d.cts

@@ -1,6 +1,5 @@
-import { UserConfig } from "../../../powerlines/src/types/config.cjs";
-import { ResolvedConfig } from "../../../powerlines/src/types/resolved.cjs";
 import { PluginContext } from "../../../powerlines/src/types/context.cjs";
+import { BabelPluginResolvedConfig, BabelPluginUserConfig } from "../../../plugin-babel/src/types/plugin.cjs";
 import { Children, PrintTreeOptions } from "@alloy-js/core";
 
 //#region ../plugin-alloy/src/types/plugin.d.ts
@@ -24,10 +23,10 @@ type AlloyPluginOptions = Partial<PrintTreeOptions> & {
    */
   markdown?: boolean;
 };
-type AlloyPluginUserConfig = UserConfig & {
+type AlloyPluginUserConfig = BabelPluginUserConfig & {
   alloy?: AlloyPluginOptions;
 };
-type AlloyPluginResolvedConfig = ResolvedConfig & {
+type AlloyPluginResolvedConfig = BabelPluginResolvedConfig & {
   alloy: AlloyPluginOptions;
 };
 type AlloyPluginContext<TResolvedConfig extends AlloyPluginResolvedConfig = AlloyPluginResolvedConfig> = PluginContext<TResolvedConfig> & {

package/dist/types/plugin.d.cts

@@ -1,8 +1,8 @@
 import { Reflection } from "../deepkit/src/types.cjs";
+import { BabelPluginContext, BabelPluginOptions, BabelPluginResolvedConfig, BabelPluginUserConfig } from "../plugin-babel/src/types/plugin.cjs";
 import { AlloyPluginContext, AlloyPluginOptions, AlloyPluginResolvedConfig, AlloyPluginUserConfig } from "../plugin-alloy/src/types/plugin.cjs";
 import "../plugin-alloy/src/types/index.cjs";
 import { AutoMDPluginOptions } from "../plugin-automd/src/types/plugin.cjs";
-import { BabelPluginContext, BabelPluginOptions, BabelPluginResolvedConfig, BabelPluginUserConfig } from "../plugin-babel/src/types/plugin.cjs";
 import { EnvInterface, SecretsInterface } from "./runtime.cjs";
 import { DotenvConfiguration, TypeDefinition, TypeDefinitionParameter } from "@stryke/types/configuration";
 import { Children } from "@alloy-js/core";

package/dist/types/plugin.d.mts

@@ -1,8 +1,8 @@
 import { Reflection } from "../packages/deepkit/src/types.mjs";
+import { BabelPluginContext, BabelPluginOptions, BabelPluginResolvedConfig, BabelPluginUserConfig } from "../packages/plugin-babel/src/types/plugin.mjs";
 import { AlloyPluginContext, AlloyPluginOptions, AlloyPluginResolvedConfig, AlloyPluginUserConfig } from "../packages/plugin-alloy/src/types/plugin.mjs";
 import "../packages/plugin-alloy/src/types/index.mjs";
 import { AutoMDPluginOptions } from "../packages/plugin-automd/src/types/plugin.mjs";
-import { BabelPluginContext, BabelPluginOptions, BabelPluginResolvedConfig, BabelPluginUserConfig } from "../packages/plugin-babel/src/types/plugin.mjs";
 import "../packages/plugin-babel/src/types/index.mjs";
 import { EnvInterface, SecretsInterface } from "./runtime.mjs";
 import { DotenvParseOutput } from "@stryke/env/types";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-env",
-  "version": "0.15.112",
+  "version": "0.15.114",
   "type": "module",
   "description": "A package containing a Powerlines plugin for injecting static .env configuration values to the code so that they're accessible at runtime.",
   "repository": {
@@ -201,10 +201,10 @@
     "@alloy-js/typescript": "^0.22.0",
     "@babel/core": "^7.28.6",
     "@babel/types": "^7.28.6",
-    "@powerlines/plugin-alloy": "^0.18.105",
-    "@powerlines/plugin-automd": "^0.1.215",
-    "@powerlines/plugin-babel": "^0.12.224",
-    "@powerlines/plugin-plugin": "^0.12.166",
+    "@powerlines/plugin-alloy": "^0.18.106",
+    "@powerlines/plugin-automd": "^0.1.216",
+    "@powerlines/plugin-babel": "^0.12.225",
+    "@powerlines/plugin-plugin": "^0.12.167",
     "@storm-software/config-tools": "^1.189.0",
     "@stryke/capnp": "^0.12.61",
     "@stryke/env": "^0.20.53",
@@ -214,14 +214,14 @@
     "@stryke/type-checks": "^0.5.20",
     "@stryke/types": "^0.10.34",
     "automd": "^0.4.2",
-    "powerlines": "^0.37.88"
+    "powerlines": "^0.37.89"
   },
   "devDependencies": {
-    "@powerlines/deepkit": "^0.5.132",
-    "@powerlines/plugin-deepkit": "^0.11.94",
+    "@powerlines/deepkit": "^0.5.133",
+    "@powerlines/plugin-deepkit": "^0.11.95",
     "@types/node": "^24.10.9",
     "vite": "8.0.0-beta.2"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "d041e2aa4cd8b8cb4c77536083271b56c9e75443"
+  "gitHead": "fb3079ccb0361ffe89bb357f7a526b6281f8bf71"
 }