@powerlines/plugin-env 0.16.83 → 0.16.84

package/dist/components/docs.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"docs.mjs","names":[],"sources":["../../src/components/docs.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, Show } from \"@alloy-js/core\";\nimport { Heading, Link } from \"@alloy-js/markdown\";\nimport {\n  ReflectionClass,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport {\n  MarkdownFile,\n  MarkdownFileProps\n} from \"@powerlines/plugin-alloy/markdown/components/markdown-file\";\nimport { MarkdownTable } from \"@powerlines/plugin-alloy/markdown/components/markdown-table\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { getDocsOutputPath } from \"../helpers/docs-helper\";\nimport { EnvPluginContext } from \"../types/plugin\";\n\nexport interface EnvDocsFileProps extends Partial<MarkdownFileProps> {\n  /**\n   * The heading level offset to apply to the generated documentation.\n   *\n   * @remarks\n   * This is useful when nesting the documentation within other markdown files.\n   *\n   * @defaultValue 0\n   */\n  levelOffset?: number;\n\n  reflection: ReflectionClass<any>;\n}\n\n/**\n * Generates the environment configuration markdown documentation for the Powerlines project.\n */\nexport function EnvDocsFile(props: EnvDocsFileProps) {\n  const { levelOffset = 0, reflection, ...rest } = props;\n\n  const context = usePowerlines<EnvPluginContext>();\n\n  return (\n    <MarkdownFile\n      path={joinPaths(getDocsOutputPath(context), \"env.md\")}\n      {...rest}>\n      <Heading level={1 + levelOffset}>Environment Configuration</Heading>\n      {code`Below is a list of environment variables used by the`}\n      <Show when={!!context.packageJson.name}>\n        <Link\n          href={`https://www.npmjs.com/package/${context.packageJson.name}`}\n          title={context.packageJson.name!}\n        />\n      </Show>\n      {code`package. These values can be updated in the \\`.env\\` file in the root of the project.`}\n      <Spacing />\n      <Heading level={2 + levelOffset}>Environment Variables</Heading>\n      <Spacing />\n      {code`The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.`}\n      <Spacing />\n      <MarkdownTable\n        data={\n          reflection\n            ?.getProperties()\n            .filter(\n              property =>\n                property.getNameAsString() !== \"__POWERLINES_INJECTED__\"\n            )\n            .sort((a, b) =>\n              a.getNameAsString().localeCompare(b.getNameAsString())\n            )\n            .map(reflectionProperty => {\n              return {\n                name: reflectionProperty.getNameAsString().trim(),\n                description: (reflectionProperty.getDescription() ?? \"\").trim(),\n                type: stringifyType(reflectionProperty.getType())\n                  .trim()\n                  .replaceAll(\" | \", \", or \"),\n                defaultValue: reflectionProperty.hasDefault()\n                  ? String(reflectionProperty.getDefaultValue())?.includes('\"')\n                    ? reflectionProperty.getDefaultValue()\n                    : `\\`${reflectionProperty.getDefaultValue()}\\``\n                  : \"\",\n                required: reflectionProperty.isValueRequired() ? \"\" : \"✔\"\n              };\n            }) ?? []\n        }\n      />\n    </MarkdownFile>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;CA8CE,MAAA,EACF,cAAA,eAEE,GAAA,SACC;CACD,MAAA,UAAA,eAAA;AACF,QAAO,gBAAoB,cAAQ,WAAkB,EACnD,IAAM,OAAE;;cAIR,IAAM,WAAC;AACJ,SAAA;GAAA,gBAAA,SAAA;IACC,OAAM,IAAA;IACJ,UAAO;IACR,CAAA;GAAA,IAAO;GAAoD,gBAAO,MAAA;IAClE,IAAK,OAAM;AACX,YAAU,CAAC,CAAC,QAAQ,YAAY;;IAE/B,IAAE,WAAa;AACb,YAAO,gBAAQ,MAAgB;MAChC,IAAA,OAAA;AACG,cAAA,iCAAA,QAAA,YAAA;;MAEL,IAAS,QAAA;AACF,cAAO,QAAK,YAAa;;MAE5B,CAAC;;IAEL,CAAA;GAAA,IAAA;GAAA,gBAAA,SAAA,EAAA,CAAA;GAAA,gBAAA,SAAA;IACC,OAAK,IAAA;IACL,UAAE;IACH,CAAC;GAAE,gBAAkB,SAAA,EAAA,CAAA;GAAA,IAAA;GAAA,gBAAA,SAAA,EAAA,CAAA;GAAA,gBAAA,eAAA,EACpB,IAAI,OAAO;AACT,WAAI,YAAU,eAAA,CAAA,QAAA,aAAA,SAAA,iBAAA,KAAA,0BAAA,CAAA,MAAA,GAAA,MAAA,EAAA,iBAAA,CAAA,cAAA,EAAA,iBAAA,CAAA,CAAA,CAAA,KAAA,uBAAA;AACZ,YAAI;MACJ,MAAA,mBAAA,iBAAA,CAAA,MAAA;MACC,cAAa,mBAAA,gBAAA,IAAA,IAAA,MAAA;MACZ,MAAE,cAAkB,mBAAgB,SAAA,CAAA,CAAA,MAAiB,CAAA,WAAA,OAAA,QAAA;MACvD,cAAA,mBAAA,YAAA,GAAA,OAAA,mBAAA,iBAAA,CAAA,EAAA,SAAA,KAAA,GAAA,mBAAA,iBAAA,GAAA,KAAA,mBAAA,iBAAA,CAAA,MAAA;MACC,UAAI,mBAAsB,iBAAA,GAAA,KAAA;MAC1B;MACD,IAAI,EAAA;MAET,CAAC;GAAC;IAEN,CAAC,CAAC"}

package/dist/components/env-builtin.cjs

@@ -1,568 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-const require_helpers_load = require('../helpers/load.cjs');
-let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
-let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
-let defu = require("defu");
-defu = require_runtime.__toESM(defu);
-let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
-let _alloy_js_core = require("@alloy-js/core");
-let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
-let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
-let _alloy_js_typescript = require("@alloy-js/typescript");
-let _powerlines_plugin_alloy_helpers_refkey = require("@powerlines/plugin-alloy/helpers/refkey");
-let _powerlines_plugin_alloy_typescript_components_builtin_file = require("@powerlines/plugin-alloy/typescript/components/builtin-file");
-let _powerlines_plugin_alloy_typescript_components_interface_declaration = require("@powerlines/plugin-alloy/typescript/components/interface-declaration");
-let _powerlines_plugin_alloy_typescript_components_object_declaration = require("@powerlines/plugin-alloy/typescript/components/object-declaration");
-let _powerlines_plugin_alloy_typescript_components_tsdoc = require("@powerlines/plugin-alloy/typescript/components/tsdoc");
-
-//#region src/components/env-builtin.tsx
-/**
-* Generates the environment configuration typescript definition for the Powerlines project.
-*/
-function EnvTypeDefinition(props) {
-	const [{ defaultValue, reflection }] = (0, _alloy_js_core.splitProps)(props, ["defaultValue", "reflection"]);
-	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	return [
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_interface_declaration.InterfaceDeclaration, {
-			name: " EnvBase",
-			defaultValue,
-			reflection,
-			"export": true
-		}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
-			heading: "The environment configuration object with prefixed keys.",
-			get children() {
-				return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `The \`Env\` type extends the \`EnvBase\` interface by including additional keys that are prefixed according to the project's configuration. This allows for flexibility in accessing environment variables with different naming conventions.` });
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.TypeDeclaration, {
-			name: "Env",
-			"export": true,
-			get children() {
-				return _alloy_js_core.code` {
-    [Key in keyof EnvBase as Key ${context.config.env.prefix.map((prefix) => `| \`${prefix.replace(/_$/g, "")}_\${Key}\``).join(" ")}]: EnvBase[Key];
-}
-`;
-			}
-		}),
-		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {})
-	];
-}
-function ConfigPropertyConditional(props) {
-	const [{ context, name }] = (0, _alloy_js_core.splitProps)(props, ["context", "name"]);
-	return _alloy_js_core.code`propertyName === "${name}" || propertyName.replace(/^(${context.config.env.prefix.sort((a, b) => a.startsWith(b) ? -1 : b.startsWith(a) ? 1 : a.localeCompare(b)).map((prefix) => `${prefix.replace(/_$/, "")}_`).join("|")})/g, "").toLowerCase().replace(/[\\s\\-_]+/g, "") === "${name.toLowerCase().replace(/[\s\-_]+/g, "")}"`;
-}
-function ConfigPropertyGet(props) {
-	const [{ context, property, index }] = (0, _alloy_js_core.splitProps)(props, [
-		"context",
-		"property",
-		"index"
-	]);
-	return [index === 0 ? (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
-		get condition() {
-			return [(0, _alloy_js_core_jsx_runtime.createComponent)(ConfigPropertyConditional, {
-				get name() {
-					return property.getNameAsString();
-				},
-				context
-			}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-				get when() {
-					return (0, _alloy_js_core_jsx_runtime.memo)(() => !!property.getAlias())() && property.getAlias().length > 0;
-				},
-				get children() {
-					return [_alloy_js_core.code` || `, (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
-						get each() {
-							return property.getAlias();
-						},
-						joiner: _alloy_js_core.code` || `,
-						children: (alias) => (0, _alloy_js_core_jsx_runtime.createComponent)(ConfigPropertyConditional, {
-							name: alias,
-							context
-						})
-					})];
-				}
-			})];
-		},
-		get children() {
-			return _alloy_js_core.code`return target["${property.getNameAsString()}"];`;
-		}
-	}) : (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseIfClause, {
-		get condition() {
-			return [(0, _alloy_js_core_jsx_runtime.createComponent)(ConfigPropertyConditional, {
-				get name() {
-					return property.getNameAsString();
-				},
-				context
-			}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-				get when() {
-					return (0, _alloy_js_core_jsx_runtime.memo)(() => !!property.getAlias())() && property.getAlias().length > 0;
-				},
-				get children() {
-					return [_alloy_js_core.code` || `, (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
-						get each() {
-							return property.getAlias();
-						},
-						joiner: _alloy_js_core.code` || `,
-						children: (alias) => (0, _alloy_js_core_jsx_runtime.createComponent)(ConfigPropertyConditional, {
-							name: alias,
-							context
-						})
-					})];
-				}
-			})];
-		},
-		get children() {
-			return _alloy_js_core.code`return target["${property.getNameAsString()}"];`;
-		}
-	})];
-}
-function ConfigPropertySet(props) {
-	const [{ context, property, index }] = (0, _alloy_js_core.splitProps)(props, [
-		"context",
-		"property",
-		"index"
-	]);
-	return [index === 0 ? (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
-		get condition() {
-			return [(0, _alloy_js_core_jsx_runtime.createComponent)(ConfigPropertyConditional, {
-				get name() {
-					return property.getNameAsString();
-				},
-				context
-			}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-				get when() {
-					return (0, _alloy_js_core_jsx_runtime.memo)(() => !!property.getAlias())() && property.getAlias().length > 0;
-				},
-				get children() {
-					return [_alloy_js_core.code` || `, (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
-						get each() {
-							return property.getAlias();
-						},
-						joiner: _alloy_js_core.code` || `,
-						children: (alias) => (0, _alloy_js_core_jsx_runtime.createComponent)(ConfigPropertyConditional, {
-							name: alias,
-							context
-						})
-					})];
-				}
-			})];
-		},
-		get children() {
-			return _alloy_js_core.code`
-    target["${property.getNameAsString()}"] = newValue;
-    return true;
-`;
-		}
-	}) : (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseIfClause, {
-		get condition() {
-			return [(0, _alloy_js_core_jsx_runtime.createComponent)(ConfigPropertyConditional, {
-				get name() {
-					return property.getNameAsString();
-				},
-				context
-			}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-				get when() {
-					return (0, _alloy_js_core_jsx_runtime.memo)(() => !!property.getAlias())() && property.getAlias().length > 0;
-				},
-				get children() {
-					return [_alloy_js_core.code` || `, (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
-						get each() {
-							return property.getAlias();
-						},
-						joiner: _alloy_js_core.code` || `,
-						children: (alias) => (0, _alloy_js_core_jsx_runtime.createComponent)(ConfigPropertyConditional, {
-							name: alias,
-							context
-						})
-					})];
-				}
-			})];
-		},
-		get children() {
-			return _alloy_js_core.code`
-    target["${property.getNameAsString()}"] = newValue;
-    return true;
-`;
-		}
-	})];
-}
-const createEnvRefkey = (0, _powerlines_plugin_alloy_helpers_refkey.refkey)("createEnv");
-const envRefkey = (0, _powerlines_plugin_alloy_helpers_refkey.refkey)("env");
-const envSerializerRefkey = (0, _powerlines_plugin_alloy_helpers_refkey.refkey)("EnvSerializer");
-/**
-* Generates the environment configuration module for the Powerlines project.
-*/
-function EnvBuiltin(props) {
-	const [{ defaultConfig, reflection, children }, rest] = (0, _alloy_js_core.splitProps)(props, [
-		"defaultConfig",
-		"reflection",
-		"children"
-	]);
-	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
-	const defaultValue = (0, _alloy_js_core.computed)(() => context && require_helpers_load.loadEnvFromContext(context, process.env));
-	const envInstance = (0, _alloy_js_core.computed)(() => {
-		return new _powerlines_deepkit_vendor_type.ReflectionClass({
-			kind: _powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral,
-			description: `The initial environment configuration state for the ${(0, _stryke_string_format_title_case.titleCase)(context?.config?.name)} project.`,
-			types: []
-		}, reflection);
-	});
-	const reflectionGetProperties = (0, _alloy_js_core.computed)(() => reflection?.getProperties().filter((property) => !property.isIgnored()).sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())) ?? []);
-	const reflectionSetProperties = (0, _alloy_js_core.computed)(() => reflection?.getProperties().filter((property) => !property.isIgnored() && !property.isReadonly()).sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())) ?? []);
-	return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_builtin_file.BuiltinFile, (0, _alloy_js_core_jsx_runtime.mergeProps)({
-		id: "env",
-		description: "The environment configuration module provides an interface to define environment configuration parameters."
-	}, rest, {
-		get imports() {
-			return (0, defu.default)({ "@powerlines/deepkit/vendor/type": [
-				"stringify",
-				"serializer",
-				"serializeFunction",
-				"deserializeFunction",
-				"ReflectionKind",
-				"Serializer",
-				"TemplateState",
-				"Type",
-				"TypeProperty",
-				"TypePropertySignature"
-			] }, rest.imports ?? {});
-		},
-		get children() {
-			return [
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-					get when() {
-						return Boolean(reflection);
-					},
-					get children() {
-						return [
-							(0, _alloy_js_core_jsx_runtime.createComponent)(EnvTypeDefinition, {
-								get defaultValue() {
-									return defaultValue.value;
-								},
-								reflection
-							}),
-							(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-							(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
-						];
-					}
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_object_declaration.ObjectDeclaration, {
-					name: "initialEnv",
-					type: "Partial<EnvBase>",
-					defaultValue,
-					reflection: envInstance,
-					"export": true,
-					"const": true,
-					doc: "The initial environment configuration object values for the runtime."
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
-					heading: "The environment configuration serializer for the Powerlines application.",
-					get children() {
-						return [
-							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocLink, { children: `https://deepkit.io/docs/serialization/serializers` }),
-							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocLink, { children: `https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918` }),
-							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `This serializer is used to serialize and deserialize the Powerlines environment configuration.` })
-						];
-					}
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ClassDeclaration, {
-					refkey: envSerializerRefkey,
-					name: "EnvSerializer",
-					"extends": "Serializer",
-					"export": true,
-					get children() {
-						return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ClassMethod, {
-							name: "constructor",
-							"public": true,
-							doc: "Initializes a new instance of the `EnvSerializer` class.",
-							children: _alloy_js_core.code`super("env");
-
-          this.deserializeRegistry.register(
-            ReflectionKind.boolean,
-            (type: Type, state: TemplateState) => {
-              state.addSetter(
-                \`typeof \${state.accessor.toString()} !== "boolean" ? \${state.accessor.toString()} === 1 || \${state.accessor.toString()} === "1" || \${state.accessor.toString()}.toLowerCase() === "t" || \${state.accessor.toString()}.toLowerCase() === "true" || \${state.accessor.toString()}.toLowerCase() === "y" || \${state.accessor.toString()}.toLowerCase() === "yes" : \${state.accessor.toString()}\`
-              );
-            }
-          ); `
-						});
-					}
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
-					heading: "A {@link EnvSerializer | environment configuration serializer} instance for the Powerlines application.",
-					get children() {
-						return [
-							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocLink, { children: `https://deepkit.io/docs/serialization/serializers` }),
-							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocLink, { children: `https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918` }),
-							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `This serializer is used to serialize and deserialize the Powerlines environment configuration.` })
-						];
-					}
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
-					name: "envSerializer",
-					"export": false,
-					"const": true,
-					get initializer() {
-						return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.NewExpression, {
-							args: [],
-							target: "EnvSerializer"
-						});
-					}
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
-					heading: "Serialize a environment configuration object to JSON data objects (not a JSON string).",
-					get children() {
-						return [
-							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `The resulting JSON object can be stringified using \`JSON.stringify()\`.` }),
-							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocExample, { children: `const json = serializeEnv(env);` }),
-							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocThrows, { children: `ValidationError when serialization or validation fails.` })
-						];
-					}
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
-					name: "serializeEnv",
-					"export": true,
-					"const": true,
-					initializer: "serializeFunction<EnvBase>(envSerializer)"
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
-					heading: "Deserialize a environment configuration object from JSON data objects to JavaScript objects, without running any validators.",
-					get children() {
-						return [
-							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `Types that are already correct will be used as-is.` }),
-							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocExample, { children: `const env = deserializeEnv(json);` }),
-							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocThrows, { children: `ValidationError when deserialization fails.` })
-						];
-					}
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
-					name: "deserializeEnv",
-					"export": true,
-					"const": true,
-					initializer: "deserializeFunction<EnvBase>(envSerializer)"
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
-					heading: "Initializes the Powerlines environment configuration module.",
-					get children() {
-						return [
-							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `This function initializes the Powerlines environment configuration object.` }),
-							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
-								name: "environmentConfig",
-								children: `The dynamic/runtime configuration - this could include the current environment variables or any other environment-specific settings provided by the runtime.`
-							}),
-							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: `The initialized Powerlines configuration object.` })
-						];
-					}
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-					get when() {
-						return Boolean(context?.entryPath);
-					},
-					get children() {
-						return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
-							refkey: createEnvRefkey,
-							async: false,
-							"export": true,
-							name: "createEnv",
-							parameters: [{
-								name: "environmentConfig",
-								type: `Partial<Env>`,
-								optional: false,
-								default: "{}"
-							}],
-							returnType: "Env",
-							get children() {
-								return [
-									_alloy_js_core.code`
-  return new Proxy<Env>(
-    deserializeEnv({
-      ...initialEnv,
-      ...environmentConfig
-    }) as Env,
-    {
-      get: (target: EnvBase, propertyName: string) => { `,
-									(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-									(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
-										each: reflectionGetProperties,
-										children: (property, index) => (0, _alloy_js_core_jsx_runtime.createComponent)(ConfigPropertyGet, {
-											index,
-											context,
-											property
-										})
-									}),
-									_alloy_js_core.code`
-            return undefined;
-          }, `,
-									(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-									_alloy_js_core.code` set: (target: EnvBase, propertyName: string, newValue: any) => { `,
-									(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-									(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
-										each: reflectionSetProperties,
-										ender: _alloy_js_core.code` else `,
-										children: (property, index) => (0, _alloy_js_core_jsx_runtime.createComponent)(ConfigPropertySet, {
-											index,
-											context,
-											property
-										})
-									}),
-									(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-									_alloy_js_core.code`return false;
-      }
-    }
-  );
-`
-								];
-							}
-						});
-					}
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
-					heading: "The environment configuration object.",
-					get children() {
-						return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `This object provides access to the environment configuration parameters in the application runtime.` });
-					}
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
-					refkey: envRefkey,
-					name: "env",
-					type: "Env",
-					"export": true,
-					"const": true,
-					get initializer() {
-						return [_alloy_js_core.code`createEnv(${defaultConfig || "{}"} as Partial<Env>);`];
-					}
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
-					"export": true,
-					"const": true,
-					name: "isCI",
-					doc: "Detect if the application is running in a continuous integration (CI) environment.",
-					initializer: _alloy_js_core.code`Boolean(
-          env.CI ||
-          env.RUN_ID ||
-          env.AGOLA_GIT_REF ||
-          env.AC_APPCIRCLE ||
-          env.APPVEYOR ||
-          env.CODEBUILD ||
-          env.TF_BUILD ||
-          env.bamboo_planKey ||
-          env.BITBUCKET_COMMIT ||
-          env.BITRISE_IO ||
-          env.BUDDY_WORKSPACE_ID ||
-          env.BUILDKITE ||
-          env.CIRCLECI ||
-          env.CIRRUS_CI ||
-          env.CF_BUILD_ID ||
-          env.CM_BUILD_ID ||
-          env.CI_NAME ||
-          env.DRONE ||
-          env.DSARI ||
-          env.EARTHLY_CI ||
-          env.EAS_BUILD ||
-          env.GERRIT_PROJECT ||
-          env.GITEA_ACTIONS ||
-          env.GITHUB_ACTIONS ||
-          env.GITLAB_CI ||
-          env.GOCD ||
-          env.BUILDER_OUTPUT ||
-          env.HARNESS_BUILD_ID ||
-          env.JENKINS_URL ||
-          env.LAYERCI ||
-          env.MAGNUM ||
-          env.NETLIFY ||
-          env.NEVERCODE ||
-          env.PROW_JOB_ID ||
-          env.RELEASE_BUILD_ID ||
-          env.RENDER ||
-          env.SAILCI ||
-          env.HUDSON ||
-          env.SCREWDRIVER ||
-          env.SEMAPHORE ||
-          env.SOURCEHUT ||
-          env.STRIDER ||
-          env.TASK_ID ||
-          env.RUN_ID ||
-          env.TEAMCITY_VERSION ||
-          env.TRAVIS ||
-          env.VELA ||
-          env.NOW_BUILDER ||
-          env.APPCENTER_BUILD_ID ||
-          env.CI_XCODE_PROJECT ||
-          env.XCS || false
-        );
-        `
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
-					heading: "Detect the \\`mode\\` of the current runtime environment.",
-					get children() {
-						return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { children: _alloy_js_core.code`The \`mode\` is determined by the \`MODE\` environment variable, or falls back to the \`NEXT_PUBLIC_VERCEL_ENV\`, \`NODE_ENV\`, or defaults to \`production\`. While the value can potentially be any string, it is generally recommended to only allow a value in the following list:
-          - \`production\`
-          - \`test\`
-          - \`development\`
-          ` });
-					}
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
-					"export": true,
-					"const": true,
-					name: "mode",
-					initializer: _alloy_js_core.code`String(env.MODE) || "production"; `
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
-					"export": true,
-					"const": true,
-					name: "isProduction",
-					doc: "Detect if the application is running in `\"production\"` mode",
-					initializer: _alloy_js_core.code`["prd", "prod", "production"].includes(mode.toLowerCase()); `
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
-					"export": true,
-					"const": true,
-					name: "isTest",
-					doc: "Detect if the application is running in `\"test\"` mode",
-					initializer: _alloy_js_core.code`["tst", "test", "testing", "stg", "stage", "staging"].includes(mode.toLowerCase()) || env.TEST; `
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
-					"export": true,
-					"const": true,
-					name: "isDevelopment",
-					doc: "Detect if the application is running in `\"development\"` mode",
-					initializer: _alloy_js_core.code`["dev", "development"].includes(mode.toLowerCase()); `
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
-					"export": true,
-					"const": true,
-					name: "isDebug",
-					doc: "Detect if the application is currently being debugged",
-					initializer: _alloy_js_core.code`Boolean(isDevelopment && env.DEBUG); `
-				}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
-				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
-					get when() {
-						return Boolean(children);
-					},
-					children
-				})
-			];
-		}
-	}));
-}
-
-//#endregion
-exports.EnvBuiltin = EnvBuiltin;
-exports.EnvTypeDefinition = EnvTypeDefinition;

package/dist/components/env-builtin.d.cts

@@ -1,22 +0,0 @@
-import { Children } from "@alloy-js/core";
-import { ReflectionClass } from "@powerlines/deepkit/vendor/type";
-import { BuiltinFileProps } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
-import { InterfaceDeclarationProps } from "@powerlines/plugin-alloy/typescript/components/interface-declaration";
-
-//#region src/components/env-builtin.d.ts
-/**
- * Generates the environment configuration typescript definition for the Powerlines project.
- */
-declare function EnvTypeDefinition(props: Omit<InterfaceDeclarationProps, "name">): Children;
-interface EnvBuiltinProps extends Omit<BuiltinFileProps, "id"> {
-  defaultConfig?: Children;
-  reflection: ReflectionClass<any>;
-}
-/**
- * Generates the environment configuration module for the Powerlines project.
- */
-declare function EnvBuiltin(props: EnvBuiltinProps): Children;
-declare type __ΩEnvBuiltinProps = any[];
-//#endregion
-export { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps };
-//# sourceMappingURL=env-builtin.d.cts.map

package/dist/components/env-builtin.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"env-builtin.d.cts","names":[],"sources":["../../src/components/env-builtin.tsx"],"mappings":";;;;;;;;AAqEA;iBAAgB,iBAAA,CACd,KAAA,EAAO,IAAA,CAAK,yBAAA,YAAkC,QAAA;AAAA,UAkL/B,eAAA,SAAwB,IAAA,CAAK,gBAAA;EAC5C,aAAA,GAAgB,QAAA;EAChB,UAAA,EAAY,eAAA;AAAA;;;;iBAUE,UAAA,CAAW,KAAA,EAAO,eAAA,GAAe,QAAA;AAAA"}

package/dist/components/env-builtin.d.mts

@@ -1,22 +0,0 @@
-import { ReflectionClass } from "@powerlines/deepkit/vendor/type";
-import { Children } from "@alloy-js/core";
-import { BuiltinFileProps } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
-import { InterfaceDeclarationProps } from "@powerlines/plugin-alloy/typescript/components/interface-declaration";
-
-//#region src/components/env-builtin.d.ts
-/**
- * Generates the environment configuration typescript definition for the Powerlines project.
- */
-declare function EnvTypeDefinition(props: Omit<InterfaceDeclarationProps, "name">): Children;
-interface EnvBuiltinProps extends Omit<BuiltinFileProps, "id"> {
-  defaultConfig?: Children;
-  reflection: ReflectionClass<any>;
-}
-/**
- * Generates the environment configuration module for the Powerlines project.
- */
-declare function EnvBuiltin(props: EnvBuiltinProps): Children;
-declare type __ΩEnvBuiltinProps = any[];
-//#endregion
-export { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps };
-//# sourceMappingURL=env-builtin.d.mts.map

package/dist/components/env-builtin.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"env-builtin.d.mts","names":[],"sources":["../../src/components/env-builtin.tsx"],"mappings":";;;;;;;;AAqEA;iBAAgB,iBAAA,CACd,KAAA,EAAO,IAAA,CAAK,yBAAA,YAAkC,QAAA;AAAA,UAkL/B,eAAA,SAAwB,IAAA,CAAK,gBAAA;EAC5C,aAAA,GAAgB,QAAA;EAChB,UAAA,EAAY,eAAA;AAAA;;;;iBAUE,UAAA,CAAW,KAAA,EAAO,eAAA,GAAe,QAAA;AAAA"}