@powerlines/plugin-env 0.16.183 → 0.16.184

package/dist/components/env-builtin.mjs

@@ -1,7 +1,458 @@
-import{__ΩEnvPluginContext as e}from"../types/plugin.mjs";import{loadEnvFromContext as t}from"../helpers/load.mjs";import{titleCase as n}from"@stryke/string-format/title-case";import{ReflectionClass as r,ReflectionKind as i}from"@powerlines/deepkit/vendor/type";import a from"defu";import{createComponent as o,createIntrinsic as s,memo as c,mergeProps as l}from"@alloy-js/core/jsx-runtime";import{For as u,Show as d,code as f,computed as p,splitProps as m}from"@alloy-js/core";import{Spacing as h}from"@powerlines/plugin-alloy/core/components/spacing";import{usePowerlines as g}from"@powerlines/plugin-alloy/core/contexts/context";import{ClassDeclaration as _,ClassMethod as v,ElseIfClause as y,FunctionDeclaration as b,IfStatement as x,InterfaceDeclaration as S,InterfaceMember as C,NewExpression as w,VarDeclaration as T}from"@alloy-js/typescript";import{refkey as E}from"@powerlines/plugin-alloy/helpers/refkey";import{BuiltinFile as D}from"@powerlines/plugin-alloy/typescript/components/builtin-file";import{InterfaceDeclaration as O}from"@powerlines/plugin-alloy/typescript/components/interface-declaration";import{ObjectDeclaration as k}from"@powerlines/plugin-alloy/typescript/components/object-declaration";import{TSDoc as A,TSDocExample as j,TSDocLink as M,TSDocParam as N,TSDocRemarks as P,TSDocReturns as F,TSDocThrows as I}from"@powerlines/plugin-alloy/typescript/components/tsdoc";import{TSDocReflectionProperty as L}from"@powerlines/plugin-alloy/typescript/components/tsdoc-reflection";import{getUnique as R}from"@stryke/helpers/get-unique";const z=[`T`,`K`,()=>B,()=>V,`Omit`,`b!b"e!!e!!ge!"o$#o##w%y`],B=[`T`,`K`,`Pick`,`l+e#!e"!fRb!b"Pde""N#!w#y`],V=[`T`,`U`,`Exclude`,`l6!Re$!RPe#!e$"qk#%QRb!b"Pde"!p)w#y`];function H(e,t){return e.__type=t,e}function U(t){let[{defaultValue:n,reflection:r}]=m(t,[`defaultValue`,`reflection`]),i=(g.Ω=[[()=>e,`n!`]],g());return[o(O,{name:`UnprefixedEnv`,defaultValue:n,reflection:r,export:!0}),o(h,{}),o(A,{heading:`The environment configuration object with prefixed keys.`,get children(){return o(P,{children:"The `Env` type extends the `UnprefixedEnv` 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."})}}),o(S,{name:`Env`,export:!0,extends:`UnprefixedEnv`,get children(){return o(u,{get each(){return R(i.config.env.prefix).map(H(e=>e.replace(/_$/,``),[`prefix`,``,`P"2!"/"`]))},doubleHardline:!0,get children(){return H(e=>o(u,{get each(){return r?.getProperties().filter(H(e=>!e.isIgnored(),[`property`,``,`P"2!"/"`]))??[]},doubleHardline:!0,get children(){return H(t=>[o(L,{reflection:t}),o(C,{get name(){return`${e}_${t.getNameAsString()}`},get type(){return`UnprefixedEnv["${t.getNameAsString()}"]`},get readonly(){return t.isReadonly()}})],[`property`,``,`P"2!"/"`])}}),[`prefix`,``,`P"2!"/"`])}})}}),o(h,{})]}U.__type=[()=>z,`name`,`props`,`EnvTypeDefinition`,`Generates the environment configuration typescript definition for the Powerlines project.`,`P!."o!#2#"/$?%`];const W=[()=>e,`context`,`name`,`ConfigPropertyConditionalProps`,`P!n!4"&4#Mw$y`];function G(e){let[{context:t,name:n}]=m(e,[`context`,`name`]);return f`propertyName === "${n}" || propertyName.replace(/^(${R(t.config.env.prefix.sort(H((e,t)=>e.startsWith(t)?-1:t.startsWith(e)?1:e.localeCompare(t),[`a`,`b`,``,`P"2!"2""/#`])).map(H(e=>`${e.replace(/_$/,``)}_`,[`prefix`,``,`P"2!"/"`]))).join(`|`)})/g, "").toLowerCase().replace(/[\\s\\-_]+/g, "") === "${n.toLowerCase().replace(/[\s\-_]+/g,``)}"`}G.__type=[()=>W,`props`,`ConfigPropertyConditional`,`Pn!2""/#`];const K=[`index`,()=>e,`context`,`property`,`ConfigPropertyProps`,`P!'4!n"4#!4$Mw%y`];function q(e){let[{context:t,property:n,index:r}]=m(e,[`context`,`property`,`index`]);return[o(r===0?x:y,{get condition(){return[o(G,{get name(){return n.getNameAsString()},context:t}),o(d,{get when(){return c(()=>!!n.getAlias())()&&n.getAlias().length>0},get children(){return[f` || `,o(u,{get each(){return n.getAlias()},joiner:f` || `,get children(){return H(e=>o(G,{name:e,context:t}),[`alias`,``,`P"2!"/"`])}})]}})]},get children(){return f`return target["${n.getNameAsString()}"];`}})]}q.__type=[()=>K,`props`,`ConfigPropertyGet`,`Pn!2""/#`];function J(e){let[{context:t,property:n,index:r}]=m(e,[`context`,`property`,`index`]);return[o(r===0?x:y,{get condition(){return[o(G,{get name(){return n.getNameAsString()},context:t}),o(d,{get when(){return c(()=>!!n.getAlias())()&&n.getAlias().length>0},get children(){return[f` || `,o(u,{get each(){return n.getAlias()},joiner:f` || `,get children(){return H(e=>o(G,{name:e,context:t}),[`alias`,``,`P"2!"/"`])}})]}})]},get children(){return f`
-    target["${n.getNameAsString()}"] = newValue;
+import { __ΩEnvPluginContext } from "../types/plugin.mjs";
+import { loadEnvFromContext } from "../helpers/load.mjs";
+import { titleCase } from "@stryke/string-format/title-case";
+import { ReflectionClass, ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import defu from "defu";
+import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { For, Show, code, computed, splitProps } from "@alloy-js/core";
+import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { ClassDeclaration, ClassMethod, ElseIfClause, FunctionDeclaration, IfStatement, InterfaceDeclaration, InterfaceMember, NewExpression, VarDeclaration } from "@alloy-js/typescript";
+import { refkey } from "@powerlines/plugin-alloy/helpers/refkey";
+import { BuiltinFile } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
+import { InterfaceDeclaration as InterfaceDeclaration$1 } from "@powerlines/plugin-alloy/typescript/components/interface-declaration";
+import { ObjectDeclaration } from "@powerlines/plugin-alloy/typescript/components/object-declaration";
+import { TSDoc, TSDocExample, TSDocLink, TSDocParam, TSDocRemarks, TSDocReturns, TSDocThrows } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
+import { TSDocReflectionProperty } from "@powerlines/plugin-alloy/typescript/components/tsdoc-reflection";
+import { getUnique } from "@stryke/helpers/get-unique";
+
+//#region src/components/env-builtin.tsx
+const __ΩOmit = [
+	"T",
+	"K",
+	() => __ΩPick,
+	() => __ΩExclude,
+	"Omit",
+	"b!b\"e!!e!!ge!\"o$#o##w%y"
+];
+const __ΩPick = [
+	"T",
+	"K",
+	"Pick",
+	"l+e#!e\"!fRb!b\"Pde\"\"N#!w#y"
+];
+const __ΩExclude = [
+	"T",
+	"U",
+	"Exclude",
+	"l6!Re$!RPe#!e$\"qk#%QRb!b\"Pde\"!p)w#y"
+];
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+/**
+* Generates the environment configuration typescript definition for the Powerlines project.
+*/
+function EnvTypeDefinition(props) {
+	const [{ defaultValue, reflection }] = splitProps(props, ["defaultValue", "reflection"]);
+	const context = (usePowerlines.Ω = [[() => __ΩEnvPluginContext, "n!"]], usePowerlines());
+	return [
+		createComponent(InterfaceDeclaration$1, {
+			name: "UnprefixedEnv",
+			defaultValue,
+			reflection,
+			"export": true
+		}),
+		createComponent(Spacing, {}),
+		createComponent(TSDoc, {
+			heading: "The environment configuration object with prefixed keys.",
+			get children() {
+				return createComponent(TSDocRemarks, { children: `The \`Env\` type extends the \`UnprefixedEnv\` 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.` });
+			}
+		}),
+		createComponent(InterfaceDeclaration, {
+			name: "Env",
+			"export": true,
+			"extends": "UnprefixedEnv",
+			get children() {
+				return createComponent(For, {
+					get each() {
+						return getUnique(context.config.env.prefix).map(__assignType((prefix) => prefix.replace(/_$/, ""), [
+							"prefix",
+							"",
+							"P\"2!\"/\""
+						]));
+					},
+					doubleHardline: true,
+					get children() {
+						return __assignType((prefix) => createComponent(For, {
+							get each() {
+								return reflection?.getProperties().filter(__assignType((property) => !property.isIgnored(), [
+									"property",
+									"",
+									"P\"2!\"/\""
+								])) ?? [];
+							},
+							doubleHardline: true,
+							get children() {
+								return __assignType((property) => [createComponent(TSDocReflectionProperty, { reflection: property }), createComponent(InterfaceMember, {
+									get name() {
+										return `${prefix}_${property.getNameAsString()}`;
+									},
+									get type() {
+										return `UnprefixedEnv["${property.getNameAsString()}"]`;
+									},
+									get readonly() {
+										return property.isReadonly();
+									}
+								})], [
+									"property",
+									"",
+									"P\"2!\"/\""
+								]);
+							}
+						}), [
+							"prefix",
+							"",
+							"P\"2!\"/\""
+						]);
+					}
+				});
+			}
+		}),
+		createComponent(Spacing, {})
+	];
+}
+EnvTypeDefinition.__type = [
+	() => __ΩOmit,
+	"name",
+	"props",
+	"EnvTypeDefinition",
+	"Generates the environment configuration typescript definition for the Powerlines project.",
+	"P!.\"o!#2#\"/$?%"
+];
+const __ΩConfigPropertyConditionalProps = [
+	() => __ΩEnvPluginContext,
+	"context",
+	"name",
+	"ConfigPropertyConditionalProps",
+	"P!n!4\"&4#Mw$y"
+];
+function ConfigPropertyConditional(props) {
+	const [{ context, name }] = splitProps(props, ["context", "name"]);
+	return code`propertyName === "${name}" || propertyName.replace(/^(${getUnique(context.config.env.prefix.sort(__assignType((a, b) => a.startsWith(b) ? -1 : b.startsWith(a) ? 1 : a.localeCompare(b), [
+		"a",
+		"b",
+		"",
+		"P\"2!\"2\"\"/#"
+	])).map(__assignType((prefix) => `${prefix.replace(/_$/, "")}_`, [
+		"prefix",
+		"",
+		"P\"2!\"/\""
+	]))).join("|")})/g, "").toLowerCase().replace(/[\\s\\-_]+/g, "") === "${name.toLowerCase().replace(/[\s\-_]+/g, "")}"`;
+}
+ConfigPropertyConditional.__type = [
+	() => __ΩConfigPropertyConditionalProps,
+	"props",
+	"ConfigPropertyConditional",
+	"Pn!2\"\"/#"
+];
+const __ΩConfigPropertyProps = [
+	"index",
+	() => __ΩEnvPluginContext,
+	"context",
+	"property",
+	"ConfigPropertyProps",
+	"P!'4!n\"4#!4$Mw%y"
+];
+function ConfigPropertyGet(props) {
+	const [{ context, property, index }] = splitProps(props, [
+		"context",
+		"property",
+		"index"
+	]);
+	return [index === 0 ? createComponent(IfStatement, {
+		get condition() {
+			return [createComponent(ConfigPropertyConditional, {
+				get name() {
+					return property.getNameAsString();
+				},
+				context
+			}), createComponent(Show, {
+				get when() {
+					return memo(() => !!property.getAlias())() && property.getAlias().length > 0;
+				},
+				get children() {
+					return [code` || `, createComponent(For, {
+						get each() {
+							return property.getAlias();
+						},
+						joiner: code` || `,
+						get children() {
+							return __assignType((alias) => createComponent(ConfigPropertyConditional, {
+								name: alias,
+								context
+							}), [
+								"alias",
+								"",
+								"P\"2!\"/\""
+							]);
+						}
+					})];
+				}
+			})];
+		},
+		get children() {
+			return code`return target["${property.getNameAsString()}"];`;
+		}
+	}) : createComponent(ElseIfClause, {
+		get condition() {
+			return [createComponent(ConfigPropertyConditional, {
+				get name() {
+					return property.getNameAsString();
+				},
+				context
+			}), createComponent(Show, {
+				get when() {
+					return memo(() => !!property.getAlias())() && property.getAlias().length > 0;
+				},
+				get children() {
+					return [code` || `, createComponent(For, {
+						get each() {
+							return property.getAlias();
+						},
+						joiner: code` || `,
+						get children() {
+							return __assignType((alias) => createComponent(ConfigPropertyConditional, {
+								name: alias,
+								context
+							}), [
+								"alias",
+								"",
+								"P\"2!\"/\""
+							]);
+						}
+					})];
+				}
+			})];
+		},
+		get children() {
+			return code`return target["${property.getNameAsString()}"];`;
+		}
+	})];
+}
+ConfigPropertyGet.__type = [
+	() => __ΩConfigPropertyProps,
+	"props",
+	"ConfigPropertyGet",
+	"Pn!2\"\"/#"
+];
+function ConfigPropertySet(props) {
+	const [{ context, property, index }] = splitProps(props, [
+		"context",
+		"property",
+		"index"
+	]);
+	return [index === 0 ? createComponent(IfStatement, {
+		get condition() {
+			return [createComponent(ConfigPropertyConditional, {
+				get name() {
+					return property.getNameAsString();
+				},
+				context
+			}), createComponent(Show, {
+				get when() {
+					return memo(() => !!property.getAlias())() && property.getAlias().length > 0;
+				},
+				get children() {
+					return [code` || `, createComponent(For, {
+						get each() {
+							return property.getAlias();
+						},
+						joiner: code` || `,
+						get children() {
+							return __assignType((alias) => createComponent(ConfigPropertyConditional, {
+								name: alias,
+								context
+							}), [
+								"alias",
+								"",
+								"P\"2!\"/\""
+							]);
+						}
+					})];
+				}
+			})];
+		},
+		get children() {
+			return code`
+    target["${property.getNameAsString()}"] = newValue;
+    return true;
+`;
+		}
+	}) : createComponent(ElseIfClause, {
+		get condition() {
+			return [createComponent(ConfigPropertyConditional, {
+				get name() {
+					return property.getNameAsString();
+				},
+				context
+			}), createComponent(Show, {
+				get when() {
+					return memo(() => !!property.getAlias())() && property.getAlias().length > 0;
+				},
+				get children() {
+					return [code` || `, createComponent(For, {
+						get each() {
+							return property.getAlias();
+						},
+						joiner: code` || `,
+						get children() {
+							return __assignType((alias) => createComponent(ConfigPropertyConditional, {
+								name: alias,
+								context
+							}), [
+								"alias",
+								"",
+								"P\"2!\"/\""
+							]);
+						}
+					})];
+				}
+			})];
+		},
+		get children() {
+			return code`
+    target["${property.getNameAsString()}"] = newValue;
     return true;
-`}})]}J.__type=[()=>K,`props`,`ConfigPropertySet`,`Pn!2""/#`];const Y=[()=>z,`id`,`Children`,`defaultConfig`,`reflection`,`EnvBuiltinProps`,`P!."o!#"w#4$8!4%Mw&y`],X=E(`createEnv`),Z=E(`env`),Q=E(`EnvSerializer`);function $(c){let[{defaultConfig:y,reflection:x,children:S},C]=m(c,[`defaultConfig`,`reflection`,`children`]),E=(g.Ω=[[()=>e,`n!`]],g()),O=p(()=>E&&t(E,process.env)),L=p(()=>{let e=new r({kind:i.objectLiteral,description:`The initial environment configuration state for the ${n(E?.config?.name)} project.`,types:[]},x);return e.getProperties().filter(H(e=>e.isRuntime()||e.getTags().runtime===!0,[`property`,``,`P"2!"/"`])).forEach(H(t=>{e.removeProperty(t.getNameAsString())},[`property`,``,`P"2!"/"`])),e}),z=p(()=>x?.getProperties().filter(H(e=>!e.isIgnored(),[`property`,``,`P"2!"/"`])).sort(H((e,t)=>e.getNameAsString().localeCompare(t.getNameAsString()),[`a`,`b`,``,`P"2!"2""/#`]))??[]),B=p(()=>x?.getProperties().filter(H(e=>!e.isIgnored()&&!e.isReadonly(),[`property`,``,`P"2!"/"`])).sort(H((e,t)=>e.getNameAsString().localeCompare(t.getNameAsString()),[`a`,`b`,``,`P"2!"2""/#`]))??[]);return o(D,l({id:`env`,description:`The environment configuration module provides an interface to define environment configuration parameters.`},C,{get imports(){return a({"@powerlines/deepkit/vendor/type":[`serializeFunction`,`deserializeFunction`,`ReflectionKind`,`Serializer`,`NamingStrategy`,`TemplateState`,`Type`,`TypeProperty`,`TypePropertySignature`]},C.imports??{})},get children(){return[o(d,{get when(){return!!x},get children(){return[o(U,{defaultValue:O,reflection:x}),s(`hbr`,{}),s(`hbr`,{})]}}),o(k,{name:`initialEnv`,type:`Partial<Env>`,defaultValue:O,reflection:L,export:!0,const:!0,doc:`The initial environment configuration object values for the runtime.`}),o(h,{}),o(A,{heading:`The environment configuration serializer for the Powerlines application.`,get children(){return[o(M,{children:`https://deepkit.io/docs/serialization/serializers`}),o(M,{children:`https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918`}),o(P,{children:`This serializer is used to serialize and deserialize the Powerlines environment configuration.`})]}}),o(_,{refkey:Q,name:`EnvSerializer`,extends:`Serializer`,export:!0,get children(){return o(v,{name:`constructor`,public:!0,doc:"Initializes a new instance of the `EnvSerializer` class.",children:f`super("env");
+`;
+		}
+	})];
+}
+ConfigPropertySet.__type = [
+	() => __ΩConfigPropertyProps,
+	"props",
+	"ConfigPropertySet",
+	"Pn!2\"\"/#"
+];
+const __ΩEnvBuiltinProps = [
+	() => __ΩOmit,
+	"id",
+	"Children",
+	"defaultConfig",
+	"reflection",
+	"EnvBuiltinProps",
+	"P!.\"o!#\"w#4$8!4%Mw&y"
+];
+const createEnvRefkey = refkey("createEnv");
+const envRefkey = refkey("env");
+const envSerializerRefkey = refkey("EnvSerializer");
+/**
+* Generates the environment configuration module for the Powerlines project.
+*/
+function EnvBuiltin(props) {
+	const [{ defaultConfig, reflection, children }, rest] = splitProps(props, [
+		"defaultConfig",
+		"reflection",
+		"children"
+	]);
+	const context = (usePowerlines.Ω = [[() => __ΩEnvPluginContext, "n!"]], usePowerlines());
+	const defaultValue = computed(() => context && loadEnvFromContext(context, process.env));
+	const envInstance = computed(() => {
+		const result = new ReflectionClass({
+			kind: ReflectionKind.objectLiteral,
+			description: `The initial environment configuration state for the ${titleCase(context?.config?.name)} project.`,
+			types: []
+		}, reflection);
+		result.getProperties().filter(__assignType((property) => property.isRuntime() || property.getTags().runtime === true, [
+			"property",
+			"",
+			"P\"2!\"/\""
+		])).forEach(__assignType((property) => {
+			result.removeProperty(property.getNameAsString());
+		}, [
+			"property",
+			"",
+			"P\"2!\"/\""
+		]));
+		return result;
+	});
+	const reflectionGetProperties = computed(() => reflection?.getProperties().filter(__assignType((property) => !property.isIgnored(), [
+		"property",
+		"",
+		"P\"2!\"/\""
+	])).sort(__assignType((a, b) => a.getNameAsString().localeCompare(b.getNameAsString()), [
+		"a",
+		"b",
+		"",
+		"P\"2!\"2\"\"/#"
+	])) ?? []);
+	const reflectionSetProperties = computed(() => reflection?.getProperties().filter(__assignType((property) => !property.isIgnored() && !property.isReadonly(), [
+		"property",
+		"",
+		"P\"2!\"/\""
+	])).sort(__assignType((a, b) => a.getNameAsString().localeCompare(b.getNameAsString()), [
+		"a",
+		"b",
+		"",
+		"P\"2!\"2\"\"/#"
+	])) ?? []);
+	return createComponent(BuiltinFile, mergeProps({
+		id: "env",
+		description: "The environment configuration module provides an interface to define environment configuration parameters."
+	}, rest, {
+		get imports() {
+			return defu({ "@powerlines/deepkit/vendor/type": [
+				"serializeFunction",
+				"deserializeFunction",
+				"ReflectionKind",
+				"Serializer",
+				"NamingStrategy",
+				"TemplateState",
+				"Type",
+				"TypeProperty",
+				"TypePropertySignature"
+			] }, rest.imports ?? {});
+		},
+		get children() {
+			return [
+				createComponent(Show, {
+					get when() {
+						return Boolean(reflection);
+					},
+					get children() {
+						return [
+							createComponent(EnvTypeDefinition, {
+								defaultValue,
+								reflection
+							}),
+							createIntrinsic("hbr", {}),
+							createIntrinsic("hbr", {})
+						];
+					}
+				}),
+				createComponent(ObjectDeclaration, {
+					name: "initialEnv",
+					type: "Partial<Env>",
+					defaultValue,
+					reflection: envInstance,
+					"export": true,
+					"const": true,
+					doc: "The initial environment configuration object values for the runtime."
+				}),
+				createComponent(Spacing, {}),
+				createComponent(TSDoc, {
+					heading: "The environment configuration serializer for the Powerlines application.",
+					get children() {
+						return [
+							createComponent(TSDocLink, { children: `https://deepkit.io/docs/serialization/serializers` }),
+							createComponent(TSDocLink, { children: `https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918` }),
+							createComponent(TSDocRemarks, { children: `This serializer is used to serialize and deserialize the Powerlines environment configuration.` })
+						];
+					}
+				}),
+				createComponent(ClassDeclaration, {
+					refkey: envSerializerRefkey,
+					name: "EnvSerializer",
+					"extends": "Serializer",
+					"export": true,
+					get children() {
+						return createComponent(ClassMethod, {
+							name: "constructor",
+							"public": true,
+							doc: "Initializes a new instance of the `EnvSerializer` class.",
+							children: code`super("env");
 
           this.deserializeRegistry.register(
             ReflectionKind.boolean,
@@ -10,7 +461,17 @@ import{__ΩEnvPluginContext as e}from"../types/plugin.mjs";import{loadEnvFromCon
                 \`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()}\`
               );
             }
-          ); `})}}),o(h,{}),o(T,{name:`envNamingStrategy`,const:!0,doc:`The environment naming strategy for the runtime.`,get initializer(){return f`new class extends NamingStrategy {
+          ); `
+						});
+					}
+				}),
+				createComponent(Spacing, {}),
+				createComponent(VarDeclaration, {
+					name: "envNamingStrategy",
+					"const": true,
+					doc: "The environment naming strategy for the runtime.",
+					get initializer() {
+						return code`new class extends NamingStrategy {
                     constructor() {
                         super("env");
                     }
@@ -21,22 +482,209 @@ import{__ΩEnvPluginContext as e}from"../types/plugin.mjs";import{loadEnvFromCon
                         return name;
                       }
 
-                      return name.replace(/^(${R(E.config.env.prefix).map(H(e=>e.replace(/_$/,``),[`prefix`,``,`P"2!"/"`])).join(`|`)})_/, "");
+                      return name.replace(/^(${getUnique(context.config.env.prefix).map(__assignType((prefix) => prefix.replace(/_$/, ""), [
+							"prefix",
+							"",
+							"P\"2!\"/\""
+						])).join("|")})_/, "");
                     }
-                  }; `}}),o(h,{}),o(A,{heading:`A {@link EnvSerializer | environment configuration serializer} instance for the Powerlines application.`,get children(){return[o(M,{children:`https://deepkit.io/docs/serialization/serializers`}),o(M,{children:`https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918`}),o(P,{children:`This serializer is used to serialize and deserialize the Powerlines environment configuration.`})]}}),o(T,{name:`envSerializer`,const:!0,get initializer(){return o(w,{args:[],target:`EnvSerializer`})}}),o(h,{}),o(T,{name:`_serializeEnv`,const:!0,initializer:`serializeFunction<Env>(envSerializer, envNamingStrategy)`}),o(h,{}),o(A,{heading:`Serialize a environment configuration object to JSON data objects (not a JSON string).`,get children(){return[o(P,{children:"The resulting JSON object can be stringified using `JSON.stringify()`."}),o(j,{children:`const json = serializeEnv(env);`}),o(h,{}),o(N,{name:`input`,children:`The environment configuration object to serialize.`}),o(F,{children:`The serialized environment configuration as JSON data objects.`}),o(I,{children:`ValidationError when serialization or validation fails.`})]}}),o(b,{name:`serializeEnv`,export:!0,parameters:[{name:`input`,type:`Env`}],children:f` return _serializeEnv(input, { loosely: true }); `}),o(h,{}),o(T,{name:`_deserializeEnv`,const:!0,initializer:`deserializeFunction<Env>(envSerializer, envNamingStrategy)`}),o(h,{}),o(A,{heading:`Deserialize a environment configuration object from JSON data objects to JavaScript objects, without running any validators.`,get children(){return[o(P,{children:`Types that are already correct will be used as-is.`}),o(j,{children:`const env = deserializeEnv(json);`}),o(I,{children:`ValidationError when deserialization fails.`})]}}),o(b,{name:`deserializeEnv`,export:!0,parameters:[{name:`input`,type:`Env`}],children:f` return _deserializeEnv(input, { loosely: true }); `}),o(h,{}),o(A,{heading:`Initializes the Powerlines environment configuration module.`,get children(){return[o(P,{children:`This function initializes the Powerlines environment configuration object.`}),o(N,{name:`environmentConfig`,children:`The dynamic/runtime configuration - this could include the current environment variables or any other environment-specific settings provided by the runtime.`}),o(F,{children:`The initialized Powerlines configuration object.`})]}}),o(d,{get when(){return!!E?.entryPath},get children(){return o(b,{refkey:X,async:!1,export:!0,name:`createEnv`,parameters:[{name:`environmentConfig`,type:`Partial<Env>`,optional:!1,default:`{}`}],returnType:`Env`,get children(){return[f`
+                  }; `;
+					}
+				}),
+				createComponent(Spacing, {}),
+				createComponent(TSDoc, {
+					heading: "A {@link EnvSerializer | environment configuration serializer} instance for the Powerlines application.",
+					get children() {
+						return [
+							createComponent(TSDocLink, { children: `https://deepkit.io/docs/serialization/serializers` }),
+							createComponent(TSDocLink, { children: `https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918` }),
+							createComponent(TSDocRemarks, { children: `This serializer is used to serialize and deserialize the Powerlines environment configuration.` })
+						];
+					}
+				}),
+				createComponent(VarDeclaration, {
+					name: "envSerializer",
+					"const": true,
+					get initializer() {
+						return createComponent(NewExpression, {
+							args: [],
+							target: "EnvSerializer"
+						});
+					}
+				}),
+				createComponent(Spacing, {}),
+				createComponent(VarDeclaration, {
+					name: "_serializeEnv",
+					"const": true,
+					initializer: "serializeFunction<Env>(envSerializer, envNamingStrategy)"
+				}),
+				createComponent(Spacing, {}),
+				createComponent(TSDoc, {
+					heading: "Serialize a environment configuration object to JSON data objects (not a JSON string).",
+					get children() {
+						return [
+							createComponent(TSDocRemarks, { children: `The resulting JSON object can be stringified using \`JSON.stringify()\`.` }),
+							createComponent(TSDocExample, { children: `const json = serializeEnv(env);` }),
+							createComponent(Spacing, {}),
+							createComponent(TSDocParam, {
+								name: "input",
+								children: `The environment configuration object to serialize.`
+							}),
+							createComponent(TSDocReturns, { children: `The serialized environment configuration as JSON data objects.` }),
+							createComponent(TSDocThrows, { children: `ValidationError when serialization or validation fails.` })
+						];
+					}
+				}),
+				createComponent(FunctionDeclaration, {
+					name: "serializeEnv",
+					"export": true,
+					parameters: [{
+						name: "input",
+						type: "Env"
+					}],
+					children: code` return _serializeEnv(input, { loosely: true }); `
+				}),
+				createComponent(Spacing, {}),
+				createComponent(VarDeclaration, {
+					name: "_deserializeEnv",
+					"const": true,
+					initializer: "deserializeFunction<Env>(envSerializer, envNamingStrategy)"
+				}),
+				createComponent(Spacing, {}),
+				createComponent(TSDoc, {
+					heading: "Deserialize a environment configuration object from JSON data objects to JavaScript objects, without running any validators.",
+					get children() {
+						return [
+							createComponent(TSDocRemarks, { children: `Types that are already correct will be used as-is.` }),
+							createComponent(TSDocExample, { children: `const env = deserializeEnv(json);` }),
+							createComponent(TSDocThrows, { children: `ValidationError when deserialization fails.` })
+						];
+					}
+				}),
+				createComponent(FunctionDeclaration, {
+					name: "deserializeEnv",
+					"export": true,
+					parameters: [{
+						name: "input",
+						type: "Env"
+					}],
+					children: code` return _deserializeEnv(input, { loosely: true }); `
+				}),
+				createComponent(Spacing, {}),
+				createComponent(TSDoc, {
+					heading: "Initializes the Powerlines environment configuration module.",
+					get children() {
+						return [
+							createComponent(TSDocRemarks, { children: `This function initializes the Powerlines environment configuration object.` }),
+							createComponent(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.`
+							}),
+							createComponent(TSDocReturns, { children: `The initialized Powerlines configuration object.` })
+						];
+					}
+				}),
+				createComponent(Show, {
+					get when() {
+						return Boolean(context?.entryPath);
+					},
+					get children() {
+						return createComponent(FunctionDeclaration, {
+							refkey: createEnvRefkey,
+							async: false,
+							"export": true,
+							name: "createEnv",
+							parameters: [{
+								name: "environmentConfig",
+								type: `Partial<Env>`,
+								optional: false,
+								default: "{}"
+							}],
+							returnType: "Env",
+							get children() {
+								return [
+									code`
   return new Proxy<Env>(
     deserializeEnv({
       ...initialEnv,
       ...environmentConfig
     } as Env),
     {
-      get: (target: UnprefixedEnv, propertyName: string) => { `,s(`hbr`,{}),o(u,{each:z,get children(){return H((e,t)=>o(q,{index:t,context:E,property:e}),[`property`,`index`,``,`P!2!'2""/#`])}}),f`
+      get: (target: UnprefixedEnv, propertyName: string) => { `,
+									createIntrinsic("hbr", {}),
+									createComponent(For, {
+										each: reflectionGetProperties,
+										get children() {
+											return __assignType((property, index) => createComponent(ConfigPropertyGet, {
+												index,
+												context,
+												property
+											}), [
+												"property",
+												"index",
+												"",
+												"P!2!'2\"\"/#"
+											]);
+										}
+									}),
+									code`
             return undefined;
-          }, `,o(h,{}),f` set: (target: UnprefixedEnv, propertyName: string, newValue: any) => { `,s(`hbr`,{}),o(u,{each:B,ender:f` else `,get children(){return H((e,t)=>o(J,{index:t,context:E,property:e}),[`property`,`index`,``,`P!2!'2""/#`])}}),s(`hbr`,{}),f`return false;
+          }, `,
+									createComponent(Spacing, {}),
+									code` set: (target: UnprefixedEnv, propertyName: string, newValue: any) => { `,
+									createIntrinsic("hbr", {}),
+									createComponent(For, {
+										each: reflectionSetProperties,
+										ender: code` else `,
+										get children() {
+											return __assignType((property, index) => createComponent(ConfigPropertySet, {
+												index,
+												context,
+												property
+											}), [
+												"property",
+												"index",
+												"",
+												"P!2!'2\"\"/#"
+											]);
+										}
+									}),
+									createIntrinsic("hbr", {}),
+									code`return false;
       }
     }
   );
-`]}})}}),o(h,{}),s(`hbr`,{}),o(A,{heading:`The environment configuration object.`,get children(){return o(P,{children:`This object provides access to the environment configuration parameters in the application runtime.`})}}),o(T,{refkey:Z,name:`env`,type:`Env`,export:!0,const:!0,get initializer(){return[f`createEnv(${y||`{}`} as Partial<Env>);`]}}),o(h,{}),o(T,{export:!0,const:!0,name:`isCI`,doc:`Detect if the application is running in a continuous integration (CI) environment.`,initializer:f`Boolean(
+`
+								];
+							}
+						});
+					}
+				}),
+				createComponent(Spacing, {}),
+				createIntrinsic("hbr", {}),
+				createComponent(TSDoc, {
+					heading: "The environment configuration object.",
+					get children() {
+						return createComponent(TSDocRemarks, { children: `This object provides access to the environment configuration parameters in the application runtime.` });
+					}
+				}),
+				createComponent(VarDeclaration, {
+					refkey: envRefkey,
+					name: "env",
+					type: "Env",
+					"export": true,
+					"const": true,
+					get initializer() {
+						return [code`createEnv(${defaultConfig || "{}"} as Partial<Env>);`];
+					}
+				}),
+				createComponent(Spacing, {}),
+				createComponent(VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "isCI",
+					doc: "Detect if the application is running in a continuous integration (CI) environment.",
+					initializer: code`Boolean(
           env.CI ||
           env.RUN_ID ||
           env.AGOLA_GIT_REF ||
@@ -88,9 +736,76 @@ import{__ΩEnvPluginContext as e}from"../types/plugin.mjs";import{loadEnvFromCon
           env.APPCENTER_BUILD_ID ||
           env.CI_XCODE_PROJECT ||
           env.XCS || false
-        ); `}),o(h,{}),o(A,{heading:"Detect the \\`mode\\` of the current runtime environment.",get children(){return o(P,{children:f`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:
+        ); `
+				}),
+				createComponent(Spacing, {}),
+				createComponent(TSDoc, {
+					heading: "Detect the \\`mode\\` of the current runtime environment.",
+					get children() {
+						return createComponent(TSDocRemarks, { children: 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\`
-          `})}}),o(T,{export:!0,const:!0,name:`mode`,initializer:f`String(env.MODE) || "production"; `}),o(h,{}),o(T,{export:!0,const:!0,name:`isProduction`,doc:'Detect if the application is running in `"production"` mode',initializer:f`["prd", "prod", "production"].includes(mode.toLowerCase()); `}),o(h,{}),o(T,{export:!0,const:!0,name:`isTest`,doc:'Detect if the application is running in `"test"` mode',initializer:f`["tst", "test", "testing", "stg", "stage", "staging"].includes(mode.toLowerCase()) || env.TEST; `}),o(h,{}),o(T,{export:!0,const:!0,name:`isDevelopment`,doc:'Detect if the application is running in `"development"` mode',initializer:f`["dev", "development"].includes(mode.toLowerCase()); `}),o(h,{}),o(T,{export:!0,const:!0,name:`isDebug`,doc:`Detect if the application is currently being debugged`,initializer:f`Boolean(isDevelopment && env.DEBUG); `}),o(h,{}),o(d,{get when(){return!!S},children:S})]}}))}$.__type=[()=>Y,`props`,`EnvBuiltin`,`Generates the environment configuration module for the Powerlines project.`,`Pn!2""/#?$`];export{$ as EnvBuiltin,U as EnvTypeDefinition,Y as __ΩEnvBuiltinProps};
+          ` });
+					}
+				}),
+				createComponent(VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "mode",
+					initializer: code`String(env.MODE) || "production"; `
+				}),
+				createComponent(Spacing, {}),
+				createComponent(VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "isProduction",
+					doc: "Detect if the application is running in `\"production\"` mode",
+					initializer: code`["prd", "prod", "production"].includes(mode.toLowerCase()); `
+				}),
+				createComponent(Spacing, {}),
+				createComponent(VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "isTest",
+					doc: "Detect if the application is running in `\"test\"` mode",
+					initializer: code`["tst", "test", "testing", "stg", "stage", "staging"].includes(mode.toLowerCase()) || env.TEST; `
+				}),
+				createComponent(Spacing, {}),
+				createComponent(VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "isDevelopment",
+					doc: "Detect if the application is running in `\"development\"` mode",
+					initializer: code`["dev", "development"].includes(mode.toLowerCase()); `
+				}),
+				createComponent(Spacing, {}),
+				createComponent(VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "isDebug",
+					doc: "Detect if the application is currently being debugged",
+					initializer: code`Boolean(isDevelopment && env.DEBUG); `
+				}),
+				createComponent(Spacing, {}),
+				createComponent(Show, {
+					get when() {
+						return Boolean(children);
+					},
+					children
+				})
+			];
+		}
+	}));
+}
+EnvBuiltin.__type = [
+	() => __ΩEnvBuiltinProps,
+	"props",
+	"EnvBuiltin",
+	"Generates the environment configuration module for the Powerlines project.",
+	"Pn!2\"\"/#?$"
+];
+
+//#endregion
+export { EnvBuiltin, EnvTypeDefinition, __ΩEnvBuiltinProps };
 //# sourceMappingURL=env-builtin.mjs.map