@powerlines/plugin-env 0.16.234 → 0.16.236

package/dist/components/env-builtin.mjs

@@ -1,19 +1,17 @@
 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 { getProperties } from "@powerlines/schema/helpers";
+import { createComponent, createIntrinsic, 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 { ElseIfClause, FunctionDeclaration, IfStatement, InterfaceDeclaration, InterfaceMember, 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 { TSDoc, TSDocParam, TSDocRemarks, TSDocReturns } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
+import { TSDocSchemaProperty } from "@powerlines/plugin-alloy/typescript/components/tsdoc-schema";
 import { getUnique } from "@stryke/helpers/get-unique";
 
 //#region src/components/env-builtin.tsx
@@ -44,14 +42,14 @@ function __assignType(fn, args) {
 /**
 * Generates the environment configuration typescript definition for the Powerlines project.
 */
-function EnvTypeDefinition(props) {
-	const [{ defaultValue, reflection }] = splitProps(props, ["defaultValue", "reflection"]);
+function EnvTypeDefinition() {
 	const context = (usePowerlines.Ω = [[() => __ΩEnvPluginContext, "n!"]], usePowerlines());
 	return [
 		createComponent(InterfaceDeclaration$1, {
 			name: "UnprefixedEnv",
-			defaultValue,
-			reflection,
+			get schema() {
+				return context.env.vars.schema;
+			},
 			"export": true
 		}),
 		createComponent(Spacing, {}),
@@ -78,7 +76,7 @@ function EnvTypeDefinition(props) {
 					get children() {
 						return __assignType((prefix) => createComponent(For, {
 							get each() {
-								return reflection?.getProperties().filter(__assignType((property) => !property.isIgnored(), [
+								return Object.values(getProperties(context.env.vars.schema)).filter(__assignType((property) => !property.metadata?.isIgnored, [
 									"property",
 									"",
 									"P\"2!\"/\""
@@ -86,15 +84,15 @@ function EnvTypeDefinition(props) {
 							},
 							doubleHardline: true,
 							get children() {
-								return __assignType((property) => [createComponent(TSDocReflectionProperty, { reflection: property }), createComponent(InterfaceMember, {
+								return __assignType((property) => [createComponent(TSDocSchemaProperty, { schema: property }), createComponent(InterfaceMember, {
 									get name() {
-										return `${prefix}_${property.getNameAsString()}`;
+										return `${prefix}_${property.metadata?.name}`;
 									},
 									get type() {
-										return `UnprefixedEnv["${property.getNameAsString()}"]`;
+										return `UnprefixedEnv["${property.metadata?.name}"]`;
 									},
-									get readonly() {
-										return property.isReadonly();
+									get isReadonly() {
+										return property.metadata?.isReadonly;
 									}
 								})], [
 									"property",
@@ -115,12 +113,9 @@ function EnvTypeDefinition(props) {
 	];
 }
 EnvTypeDefinition.__type = [
-	() => __ΩOmit,
-	"name",
-	"props",
 	"EnvTypeDefinition",
 	"Generates the environment configuration typescript definition for the Powerlines project.",
-	"P!.\"o!#2#\"/$?%"
+	"P\"/!?\""
 ];
 const __ΩConfigPropertyConditionalProps = [
 	() => __ΩEnvPluginContext,
@@ -152,31 +147,31 @@ const __ΩConfigPropertyProps = [
 	"index",
 	() => __ΩEnvPluginContext,
 	"context",
+	"name",
 	"property",
 	"ConfigPropertyProps",
-	"P!'4!n\"4#!4$Mw%y"
+	"P!'4!n\"4#&4$!4%Mw&y"
 ];
 function ConfigPropertyGet(props) {
-	const [{ context, property, index }] = splitProps(props, [
+	const [{ context, name, property, index }] = splitProps(props, [
 		"context",
+		"name",
 		"property",
 		"index"
 	]);
 	return [index === 0 ? createComponent(IfStatement, {
 		get condition() {
 			return [createComponent(ConfigPropertyConditional, {
-				get name() {
-					return property.getNameAsString();
-				},
+				name,
 				context
 			}), createComponent(Show, {
 				get when() {
-					return memo(() => !!property.getAlias())() && property.getAlias().length > 0;
+					return property.metadata?.alias && property.metadata?.alias.length > 0;
 				},
 				get children() {
 					return [code` || `, createComponent(For, {
 						get each() {
-							return property.getAlias();
+							return property.metadata?.alias ?? [];
 						},
 						joiner: code` || `,
 						get children() {
@@ -193,24 +188,20 @@ function ConfigPropertyGet(props) {
 				}
 			})];
 		},
-		get children() {
-			return code`return target["${property.getNameAsString()}"];`;
-		}
+		children: code`return target["${name}"];`
 	}) : createComponent(ElseIfClause, {
 		get condition() {
 			return [createComponent(ConfigPropertyConditional, {
-				get name() {
-					return property.getNameAsString();
-				},
+				name,
 				context
 			}), createComponent(Show, {
 				get when() {
-					return memo(() => !!property.getAlias())() && property.getAlias().length > 0;
+					return property.metadata?.alias && property.metadata?.alias.length > 0;
 				},
 				get children() {
 					return [code` || `, createComponent(For, {
 						get each() {
-							return property.getAlias();
+							return property.metadata?.alias ?? [];
 						},
 						joiner: code` || `,
 						get children() {
@@ -227,9 +218,7 @@ function ConfigPropertyGet(props) {
 				}
 			})];
 		},
-		get children() {
-			return code`return target["${property.getNameAsString()}"];`;
-		}
+		children: code`return target["${name}"];`
 	})];
 }
 ConfigPropertyGet.__type = [
@@ -239,26 +228,25 @@ ConfigPropertyGet.__type = [
 	"Pn!2\"\"/#"
 ];
 function ConfigPropertySet(props) {
-	const [{ context, property, index }] = splitProps(props, [
+	const [{ context, name, property, index }] = splitProps(props, [
 		"context",
+		"name",
 		"property",
 		"index"
 	]);
 	return [index === 0 ? createComponent(IfStatement, {
 		get condition() {
 			return [createComponent(ConfigPropertyConditional, {
-				get name() {
-					return property.getNameAsString();
-				},
+				name,
 				context
 			}), createComponent(Show, {
 				get when() {
-					return memo(() => !!property.getAlias())() && property.getAlias().length > 0;
+					return property.metadata?.alias && property.metadata?.alias.length > 0;
 				},
 				get children() {
 					return [code` || `, createComponent(For, {
 						get each() {
-							return property.getAlias();
+							return property.metadata?.alias ?? [];
 						},
 						joiner: code` || `,
 						get children() {
@@ -275,27 +263,23 @@ function ConfigPropertySet(props) {
 				}
 			})];
 		},
-		get children() {
-			return code`
-    target["${property.getNameAsString()}"] = newValue;
+		children: code`
+    target["${name}"] = newValue;
     return true;
-`;
-		}
+`
 	}) : createComponent(ElseIfClause, {
 		get condition() {
 			return [createComponent(ConfigPropertyConditional, {
-				get name() {
-					return property.getNameAsString();
-				},
+				name,
 				context
 			}), createComponent(Show, {
 				get when() {
-					return memo(() => !!property.getAlias())() && property.getAlias().length > 0;
+					return property.metadata?.alias && property.metadata?.alias.length > 0;
 				},
 				get children() {
 					return [code` || `, createComponent(For, {
 						get each() {
-							return property.getAlias();
+							return property.metadata?.alias ?? [];
 						},
 						joiner: code` || `,
 						get children() {
@@ -312,12 +296,10 @@ function ConfigPropertySet(props) {
 				}
 			})];
 		},
-		get children() {
-			return code`
-    target["${property.getNameAsString()}"] = newValue;
+		children: code`
+    target["${name}"] = newValue;
     return true;
-`;
-		}
+`
 	})];
 }
 ConfigPropertySet.__type = [
@@ -331,58 +313,33 @@ const __ΩEnvBuiltinProps = [
 	"id",
 	"Children",
 	"defaultConfig",
-	"reflection",
 	"EnvBuiltinProps",
-	"P!.\"o!#\"w#4$8!4%Mw&y"
+	"P!.\"o!#\"w#4$8Mw%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 [{ defaultConfig, children }, rest] = splitProps(props, ["defaultConfig", "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(), [
+	const reflectionGetProperties = computed(() => Object.values(getProperties(context.env.vars.schema)).filter(__assignType((property) => !property.metadata?.isIgnored, [
 		"property",
 		"",
 		"P\"2!\"/\""
-	])).sort(__assignType((a, b) => a.getNameAsString().localeCompare(b.getNameAsString()), [
+	])).sort(__assignType((a, b) => !a.metadata?.name && !b.metadata?.name ? 0 : !a.metadata?.name ? 1 : !b.metadata?.name ? -1 : a.metadata?.name.localeCompare(b.metadata?.name), [
 		"a",
 		"b",
 		"",
 		"P\"2!\"2\"\"/#"
 	])) ?? []);
-	const reflectionSetProperties = computed(() => reflection?.getProperties().filter(__assignType((property) => !property.isIgnored() && !property.isReadonly(), [
+	const reflectionSetProperties = computed(() => Object.values(getProperties(context.env.vars.schema)).filter(__assignType((property) => !property.metadata?.isIgnored && !property.metadata?.isReadonly, [
 		"property",
 		"",
 		"P\"2!\"/\""
-	])).sort(__assignType((a, b) => a.getNameAsString().localeCompare(b.getNameAsString()), [
+	])).sort(__assignType((a, b) => !a.metadata?.name && !b.metadata?.name ? 0 : !a.metadata?.name ? 1 : !b.metadata?.name ? -1 : a.metadata?.name.localeCompare(b.metadata?.name), [
 		"a",
 		"b",
 		"",
@@ -391,219 +348,60 @@ function EnvBuiltin(props) {
 	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,
-            (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()}\`
-              );
-            }
-          ); `
-						});
-					}
-				}),
-				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");
-                    }
-
-                    getPropertyName(type: TypeProperty | TypePropertySignature, forSerializer: string): string | undefined {
-                      const name = super.getPropertyName(type, forSerializer);
-                      if (!name) {
-                        return name;
-                      }
-
-                      return name.replace(/^(${getUnique(context.config.env.prefix).map(__assignType((prefix) => prefix.replace(/_$/, ""), [
-							"prefix",
-							"",
-							"P\"2!\"/\""
-						])).join("|")})_/, "");
-                    }
-                  }; `;
-					}
-				}),
-				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`
+	}, rest, { get children() {
+		return [
+			createComponent(Show, {
+				get when() {
+					return Boolean(context.env.vars.schema);
+				},
+				get children() {
+					return [createComponent(EnvTypeDefinition, { defaultValue }), createComponent(Spacing, {})];
+				}
+			}),
+			createComponent(ObjectDeclaration, {
+				name: "initialEnv",
+				type: "Partial<Env>",
+				get schema() {
+					return context.env.vars.schema;
+				},
+				"export": true,
+				"const": true,
+				doc: "The initial environment configuration object values for the runtime."
+			}),
+			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,
@@ -611,80 +409,91 @@ function EnvBuiltin(props) {
     } as Env),
     {
       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`
+								createIntrinsic("hbr", {}),
+								createComponent(For, {
+									get each() {
+										return reflectionGetProperties.value;
+									},
+									get children() {
+										return __assignType((property, index) => createComponent(ConfigPropertyGet, {
+											index,
+											context,
+											get name() {
+												return property.name;
+											},
+											property
+										}), [
+											"name",
+											"property",
+											"index",
+											"",
+											"PP!P&4!MK2\"'2#\"/$"
+										]);
+									}
+								}),
+								code`
             return undefined;
           }, `,
-									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;
+								createComponent(Spacing, {}),
+								code` set: (target: UnprefixedEnv, propertyName: string, newValue: any) => { `,
+								createIntrinsic("hbr", {}),
+								createComponent(For, {
+									get each() {
+										return reflectionSetProperties.value;
+									},
+									ender: code` else `,
+									get children() {
+										return __assignType((property, index) => createComponent(ConfigPropertySet, {
+											index,
+											context,
+											get name() {
+												return property.name;
+											},
+											property
+										}), [
+											"name",
+											"property",
+											"index",
+											"",
+											"PP!P&4!MK2\"'2#\"/$"
+										]);
+									}
+								}),
+								createIntrinsic("hbr", {}),
+								code`return false;
       }
     }
   );
 `
-								];
-							}
-						});
-					}
-				}),
-				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(
+							];
+						}
+					});
+				}
+			}),
+			createComponent(Spacing, {}),
+			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 ||
@@ -737,66 +546,65 @@ function EnvBuiltin(props) {
           env.CI_XCODE_PROJECT ||
           env.XCS || false
         ); `
-				}),
-				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:
+			}),
+			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\`
           ` });
-					}
-				}),
-				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
-				})
-			];
-		}
-	}));
+				}
+			}),
+			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,