@powerlines/plugin-env 0.14.21 → 0.14.22

package/dist/components/env.cjs

@@ -1,13 +1,282 @@
-const e=require(`../_virtual/rolldown_runtime.cjs`),t=require(`../deepkit/src/vendor/type.cjs`),n=require(`../helpers/load.cjs`),r=require(`../helpers/create-reflection-resource.cjs`);let i=require(`@alloy-js/core/jsx-runtime`),a=require(`@alloy-js/core`),o=require(`defu`);o=e.__toESM(o);let s=require(`@stryke/string-format/title-case`),c=require(`@stryke/type-checks/is-null`),l=require(`@alloy-js/typescript`),u=require(`@powerlines/alloy/core/contexts/context`),d=require(`@powerlines/alloy/helpers/refkey`),f=require(`@powerlines/alloy/typescript/components/builtin-file`),p=require(`@powerlines/alloy/typescript/components/tsdoc`),m=require(`@powerlines/alloy/typescript/components/typescript-interface`),h=require(`@powerlines/alloy/typescript/components/typescript-object`);function g(e){let[{defaultValue:t,reflection:n}]=(0,a.splitProps)(e,[`defaultValue`,`reflection`]),r=(0,u.usePowerlines)();return[(0,i.createComponent)(m.TypeScriptInterface,{name:` EnvBase`,extends:[`EnvInterface`],defaultValue:t,reflection:n,export:!0}),(0,i.createIntrinsic)(`hbr`,{}),(0,i.createIntrinsic)(`hbr`,{}),(0,i.createComponent)(l.TypeDeclaration,{name:`Env`,export:!0,get children(){return a.code` {
-    [Key in keyof EnvBase as Key ${r?.config.env.prefix.map(e=>`| \`${e.replace(/_$/g,``)}_\${Key}\``).join(` `)}]: EnvBase[Key];
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_type = require('../deepkit/src/vendor/type.cjs');
+const require_load = require('../helpers/load.cjs');
+const require_create_reflection_resource = require('../helpers/create-reflection-resource.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
+let __stryke_type_checks_is_null = require("@stryke/type-checks/is-null");
+let __alloy_js_typescript = require("@alloy-js/typescript");
+let __powerlines_alloy_core_contexts_context = require("@powerlines/alloy/core/contexts/context");
+let __powerlines_alloy_helpers_refkey = require("@powerlines/alloy/helpers/refkey");
+let __powerlines_alloy_typescript_components_builtin_file = require("@powerlines/alloy/typescript/components/builtin-file");
+let __powerlines_alloy_typescript_components_tsdoc = require("@powerlines/alloy/typescript/components/tsdoc");
+let __powerlines_alloy_typescript_components_typescript_interface = require("@powerlines/alloy/typescript/components/typescript-interface");
+let __powerlines_alloy_typescript_components_typescript_object = require("@powerlines/alloy/typescript/components/typescript-object");
+
+//#region src/components/env.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_alloy_core_contexts_context.usePowerlines)();
+	return [
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_typescript_interface.TypeScriptInterface, {
+			name: " EnvBase",
+			"extends": ["EnvInterface"],
+			defaultValue,
+			reflection,
+			"export": true
+		}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(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];
+}
+`;
+			}
+		})
+	];
+}
+function ConfigPropertyConditional(props) {
+	const [{ context, name }] = (0, __alloy_js_core.splitProps)(props, ["context", "name"]);
+	if (!context) return null;
+	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"
+	]);
+	if (!context) return null;
+	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 _(e){let[{context:t,name:n}]=(0,a.splitProps)(e,[`context`,`name`]);return t?a.code`propertyName === "${n}" || propertyName.replace(/^(${t.config.env.prefix.sort((e,t)=>e.startsWith(t)?-1:t.startsWith(e)?1:e.localeCompare(t)).map(e=>`${e.replace(/_$/,``)}_`).join(`|`)})/g, "").toLowerCase().replace(/[\\s\\-_]+/g, "") === "${n.toLowerCase().replace(/[\s\-_]+/g,``)}"`:null}function v(e){let[{context:t,property:n,index:r}]=(0,a.splitProps)(e,[`context`,`property`,`index`]);return t?[r===0?(0,i.createComponent)(l.IfStatement,{get condition(){return[(0,i.createComponent)(_,{get name(){return n.getNameAsString()},context:t}),(0,i.createComponent)(a.Show,{get when(){return(0,i.memo)(()=>!!n.getAlias())()&&n.getAlias().length>0},get children(){return[a.code` || `,(0,i.createComponent)(a.For,{get each(){return n.getAlias()},joiner:a.code` || `,children:e=>(0,i.createComponent)(_,{name:e,context:t})})]}})]},get children(){return a.code`return target["${n.getNameAsString()}"];`}}):(0,i.createComponent)(l.ElseIfClause,{get condition(){return[(0,i.createComponent)(_,{get name(){return n.getNameAsString()},context:t}),(0,i.createComponent)(a.Show,{get when(){return(0,i.memo)(()=>!!n.getAlias())()&&n.getAlias().length>0},get children(){return[a.code` || `,(0,i.createComponent)(a.For,{get each(){return n.getAlias()},joiner:a.code` || `,children:e=>(0,i.createComponent)(_,{name:e,context:t})})]}})]},get children(){return a.code`return target["${n.getNameAsString()}"];`}})]:null}function y(e){let[{context:t,property:n,index:r}]=(0,a.splitProps)(e,[`context`,`property`,`index`]);return t?[r===0?(0,i.createComponent)(l.IfStatement,{get condition(){return[(0,i.createComponent)(_,{get name(){return n.getNameAsString()},context:t}),(0,i.createComponent)(a.Show,{get when(){return(0,i.memo)(()=>!!n.getAlias())()&&n.getAlias().length>0},get children(){return[a.code` || `,(0,i.createComponent)(a.For,{get each(){return n.getAlias()},joiner:a.code` || `,children:e=>(0,i.createComponent)(_,{name:e,context:t})})]}})]},get children(){return a.code`
-    target["${n.getNameAsString()}"] = newValue;
+function ConfigPropertySet(props) {
+	const [{ context, property, index }] = (0, __alloy_js_core.splitProps)(props, [
+		"context",
+		"property",
+		"index"
+	]);
+	if (!context) return null;
+	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,i.createComponent)(l.ElseIfClause,{get condition(){return[(0,i.createComponent)(_,{get name(){return n.getNameAsString()},context:t}),(0,i.createComponent)(a.Show,{get when(){return(0,i.memo)(()=>!!n.getAlias())()&&n.getAlias().length>0},get children(){return[a.code` || `,(0,i.createComponent)(a.For,{get each(){return n.getAlias()},joiner:a.code` || `,children:e=>(0,i.createComponent)(_,{name:e,context:t})})]}})]},get children(){return a.code`
-    target["${n.getNameAsString()}"] = newValue;
+`;
+		}
+	}) : (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;
-`}})]:null}const b=(0,d.refkey)(`createEnv`),x=(0,d.refkey)(`env`),S=(0,d.refkey)(`EnvSerializer`);function C(e){let[{defaultConfig:d},m]=(0,a.splitProps)(e,[`defaultConfig`]),_=(0,u.usePowerlines)(),C=(0,a.computed)(()=>_&&n.loadEnvFromContext(_,process.env)),w=r.createReflectionResource(_),T=(0,a.computed)(()=>new t.type_exports.ReflectionClass({kind:t.type_exports.ReflectionKind.objectLiteral,description:`The initial environment configuration state for the ${(0,s.titleCase)(_?.config?.name)} project.`,types:[]},w.data??void 0)),E=(0,a.computed)(()=>w.data?.getProperties().filter(e=>!e.isIgnored()).sort((e,t)=>e.getNameAsString().localeCompare(t.getNameAsString()))??[]),D=(0,a.computed)(()=>w.data?.getProperties().filter(e=>!e.isIgnored()&&!e.isReadonly()).sort((e,t)=>e.getNameAsString().localeCompare(t.getNameAsString()))??[]);return(0,i.createComponent)(f.BuiltinFile,(0,i.mergeProps)(m,{id:`env`,description:`The Powerlines environment configuration module provides an interface to define environment configuration parameters.`,get imports(){return(0,o.default)({"@powerlines/deepkit/vendor/type":[`Type`,`stringify`,`serializer`,`serializeFunction`,`deserializeFunction`,`ReflectionKind`,`TemplateState`,`Serializer`,`TypeProperty`,`TypePropertySignature`],"@powerlines/plugin-env/types/runtime":[{name:`EnvInterface`}]},m.imports??{})},get children(){return[(0,i.createComponent)(a.Show,{get when(){return!(0,c.isNull)(w.data)},get children(){return[(0,i.createComponent)(g,{get defaultValue(){return C.value},get reflection(){return w.data}}),(0,i.createIntrinsic)(`hbr`,{}),(0,i.createIntrinsic)(`hbr`,{})]}}),(0,i.createComponent)(h.TypescriptObject,{name:`initialEnv`,type:`Partial<EnvBase>`,defaultValue:C,reflection:T,export:!0,const:!0}),(0,i.createIntrinsic)(`hbr`,{}),(0,i.createIntrinsic)(`hbr`,{}),(0,i.createComponent)(p.TSDoc,{heading:`The environment configuration serializer for the Powerlines application.`,get children(){return[(0,i.createComponent)(p.TSDocLink,{children:`https://deepkit.io/docs/serialization/serializers`}),(0,i.createComponent)(p.TSDocLink,{children:`https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918`}),(0,i.createComponent)(p.TSDocRemarks,{children:`This serializer is used to serialize and deserialize the Powerlines environment configuration.`})]}}),(0,i.createComponent)(l.ClassDeclaration,{refkey:S,name:`EnvSerializer`,extends:`Serializer`,export:!0,get children(){return(0,i.createComponent)(l.ClassMethod,{name:`constructor`,public:!0,children:a.code`
+`;
+		}
+	})];
+}
+const createEnvRefkey = (0, __powerlines_alloy_helpers_refkey.refkey)("createEnv");
+const envRefkey = (0, __powerlines_alloy_helpers_refkey.refkey)("env");
+const envSerializerRefkey = (0, __powerlines_alloy_helpers_refkey.refkey)("EnvSerializer");
+/**
+* Generates the environment configuration module for the Powerlines project.
+*/
+function EnvBuiltin(props) {
+	const [{ defaultConfig }, rest] = (0, __alloy_js_core.splitProps)(props, ["defaultConfig"]);
+	const context = (0, __powerlines_alloy_core_contexts_context.usePowerlines)();
+	const defaultValue = (0, __alloy_js_core.computed)(() => context && require_load.loadEnvFromContext(context, process.env));
+	const reflection = require_create_reflection_resource.createReflectionResource(context);
+	const envInstance = (0, __alloy_js_core.computed)(() => {
+		return new require_type.type_exports.ReflectionClass({
+			kind: require_type.type_exports.ReflectionKind.objectLiteral,
+			description: `The initial environment configuration state for the ${(0, __stryke_string_format_title_case.titleCase)(context?.config?.name)} project.`,
+			types: []
+		}, reflection.data ?? void 0);
+	});
+	const reflectionGetProperties = (0, __alloy_js_core.computed)(() => reflection.data?.getProperties().filter((property) => !property.isIgnored()).sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())) ?? []);
+	const reflectionSetProperties = (0, __alloy_js_core.computed)(() => reflection.data?.getProperties().filter((property) => !property.isIgnored() && !property.isReadonly()).sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())) ?? []);
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_builtin_file.BuiltinFile, (0, __alloy_js_core_jsx_runtime.mergeProps)(rest, {
+		id: "env",
+		description: "The Powerlines environment configuration module provides an interface to define environment configuration parameters.",
+		get imports() {
+			return (0, defu.default)({
+				"@powerlines/deepkit/vendor/type": [
+					"Type",
+					"stringify",
+					"serializer",
+					"serializeFunction",
+					"deserializeFunction",
+					"ReflectionKind",
+					"TemplateState",
+					"Serializer",
+					"TypeProperty",
+					"TypePropertySignature"
+				],
+				"@powerlines/plugin-env/types/runtime": [{ name: "EnvInterface" }]
+			}, rest.imports ?? {});
+		},
+		get children() {
+			return [
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+					get when() {
+						return !(0, __stryke_type_checks_is_null.isNull)(reflection.data);
+					},
+					get children() {
+						return [
+							(0, __alloy_js_core_jsx_runtime.createComponent)(EnvTypeDefinition, {
+								get defaultValue() {
+									return defaultValue.value;
+								},
+								get reflection() {
+									return reflection.data;
+								}
+							}),
+							(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+							(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+						];
+					}
+				}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_typescript_object.TypescriptObject, {
+					name: "initialEnv",
+					type: "Partial<EnvBase>",
+					defaultValue,
+					reflection: envInstance,
+					"export": true,
+					"const": true
+				}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_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_alloy_typescript_components_tsdoc.TSDocLink, { children: `https://deepkit.io/docs/serialization/serializers` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_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_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,
+							children: __alloy_js_core.code`
     super("env");
 
     this.deserializeRegistry.register(
@@ -18,17 +287,169 @@ const e=require(`../_virtual/rolldown_runtime.cjs`),t=require(`../deepkit/src/ve
         );
       }
     );
-`})}}),(0,i.createIntrinsic)(`hbr`,{}),(0,i.createIntrinsic)(`hbr`,{}),(0,i.createComponent)(p.TSDoc,{heading:`A {@link EnvSerializer | environment configuration serializer} instance for the Powerlines application.`,get children(){return[(0,i.createComponent)(p.TSDocLink,{children:`https://deepkit.io/docs/serialization/serializers`}),(0,i.createComponent)(p.TSDocLink,{children:`https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918`}),(0,i.createComponent)(p.TSDocRemarks,{children:`This serializer is used to serialize and deserialize the Powerlines environment configuration.`})]}}),(0,i.createComponent)(l.VarDeclaration,{name:`envSerializer`,export:!1,const:!0,get initializer(){return(0,i.createComponent)(l.NewExpression,{args:[],target:`EnvSerializer`})}}),(0,i.createIntrinsic)(`hbr`,{}),(0,i.createIntrinsic)(`hbr`,{}),(0,i.createComponent)(p.TSDoc,{heading:`Serialize a environment configuration object to JSON data objects (not a JSON string).`,get children(){return[(0,i.createComponent)(p.TSDocRemarks,{children:`The resulting JSON object can be stringified using JSON.stringify().`}),(0,i.createComponent)(p.TSDocExample,{children:`const json = serializeEnv(env);`}),(0,i.createComponent)(p.TSDocThrows,{children:`ValidationError when serialization or validation fails.`})]}}),(0,i.createComponent)(l.VarDeclaration,{name:`serializeEnv`,export:!0,const:!0,initializer:`serializeFunction<EnvBase>(envSerializer)`}),(0,i.createIntrinsic)(`hbr`,{}),(0,i.createIntrinsic)(`hbr`,{}),(0,i.createComponent)(p.TSDoc,{heading:`Deserialize a environment configuration object from JSON data objects to JavaScript objects, without running any validators.`,get children(){return[(0,i.createComponent)(p.TSDocRemarks,{children:`Types that are already correct will be used as-is.`}),(0,i.createComponent)(p.TSDocExample,{children:`const env = deserializeEnv(json);`}),(0,i.createComponent)(p.TSDocThrows,{children:`ValidationError when deserialization fails.`})]}}),(0,i.createComponent)(l.VarDeclaration,{name:`deserializeEnv`,export:!0,const:!0,initializer:`deserializeFunction<EnvBase>(envSerializer)`}),(0,i.createIntrinsic)(`hbr`,{}),(0,i.createIntrinsic)(`hbr`,{}),(0,i.createComponent)(p.TSDoc,{heading:`Initializes the Powerlines environment configuration module.`,get children(){return[(0,i.createComponent)(p.TSDocRemarks,{children:`This function initializes the Powerlines environment configuration object.`}),(0,i.createComponent)(p.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,i.createComponent)(p.TSDocReturns,{children:`The initialized Powerlines configuration object.`})]}}),(0,i.createComponent)(a.Show,{get when(){return!!_?.entryPath},get children(){return(0,i.createComponent)(l.FunctionDeclaration,{refkey:b,async:!1,export:!0,name:`createEnv`,parameters:[{name:`environmentConfig`,type:`Partial<Env>`,optional:!1,default:`{}`}],returnType:`Env`,get children(){return[a.code`
+`
+						});
+					}
+				}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_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_alloy_typescript_components_tsdoc.TSDocLink, { children: `https://deepkit.io/docs/serialization/serializers` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_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_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.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_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_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `The resulting JSON object can be stringified using JSON.stringify().` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocExample, { children: `const json = serializeEnv(env);` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_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.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_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_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `Types that are already correct will be used as-is.` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocExample, { children: `const env = deserializeEnv(json);` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_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.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDoc, {
+					heading: "Initializes the Powerlines environment configuration module.",
+					get children() {
+						return [
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `This function initializes the Powerlines environment configuration object.` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_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_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,i.createIntrinsic)(`hbr`,{}),(0,i.createComponent)(a.For,{each:E,children:(e,t)=>(0,i.createComponent)(v,{index:t,context:_,property:e})}),a.code`
+      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,i.createIntrinsic)(`hbr`,{}),(0,i.createIntrinsic)(`hbr`,{}),a.code` set: (target: EnvBase, propertyName: string, newValue: any) => { `,(0,i.createIntrinsic)(`hbr`,{}),(0,i.createComponent)(a.For,{each:D,ender:a.code` else `,children:(e,t)=>(0,i.createComponent)(y,{index:t,context:_,property:e})}),(0,i.createIntrinsic)(`hbr`,{}),a.code`return false;
+          }, `,
+									(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+									(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+									__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,i.createIntrinsic)(`hbr`,{}),(0,i.createIntrinsic)(`hbr`,{}),(0,i.createIntrinsic)(`hbr`,{}),(0,i.createComponent)(l.VarDeclaration,{refkey:x,name:`env`,type:`Env`,export:!0,const:!0,get initializer(){return[a.code`createEnv(`,d||`{}`,a.code` as Partial<Env>)`]}})]}}))}exports.EnvBuiltin=C,exports.EnvTypeDefinition=g;
+`
+								];
+							}
+						});
+					}
+				}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(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 || "{}",
+							__alloy_js_core.code` as Partial<Env>)`
+						];
+					}
+				})
+			];
+		}
+	}));
+}
+
+//#endregion
+exports.EnvBuiltin = EnvBuiltin;
+exports.EnvTypeDefinition = EnvTypeDefinition;