@powerlines/plugin-env 0.16.62 → 0.16.63

package/dist/components/env-builtin.mjs

@@ -1,8 +1,7 @@
 import { loadEnvFromContext } from "../helpers/load.mjs";
-import { ReflectionClass, ReflectionKind } from "@powerlines/deepkit/vendor/type";
 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";
@@ -20,32 +19,22 @@ import { TSDoc, TSDocExample, TSDocLink, TSDocParam, TSDocRemarks, TSDocReturns,
 function EnvTypeDefinition(props) {
 	const [{ defaultValue, reflection }] = splitProps(props, ["defaultValue", "reflection"]);
 	const context = usePowerlines();
-	return [
-		createComponent(InterfaceDeclaration, {
-			name: " EnvBase",
-			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 \`EnvBase\` interface by including additional keys that are prefixed according to the project's configuration. This allows for flexibility in accessing environment variables with different naming conventions.` });
-			}
-		}),
-		createComponent(TypeDeclaration, {
-			name: "Env",
-			"export": true,
-			get children() {
-				return code` {
+	return <>
+      <InterfaceDeclaration name=" EnvBase" defaultValue={defaultValue} reflection={reflection} export={true} />
+      <Spacing />
+      <TSDoc heading="The environment configuration object with prefixed keys.">
+        <TSDocRemarks>
+          {`The \`Env\` type extends the \`EnvBase\` interface by including additional keys that are prefixed according to the project's configuration. This allows for flexibility in accessing environment variables with different naming conventions.`}
+        </TSDocRemarks>
+      </TSDoc>
+      <TypeDeclaration name="Env" export={true}>
+        {code` {
     [Key in keyof EnvBase as Key ${context.config.env.prefix.map((prefix) => `| \`${prefix.replace(/_$/g, "")}_\${Key}\``).join(" ")}]: EnvBase[Key];
 }
-`;
-			}
-		}),
-		createComponent(Spacing, {})
-	];
+`}
+      </TypeDeclaration>
+      <Spacing />
+    </>;
 }
 function ConfigPropertyConditional(props) {
 	const [{ context, name }] = splitProps(props, ["context", "name"]);
@@ -57,63 +46,29 @@ function ConfigPropertyGet(props) {
 		"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` || `,
-						children: (alias) => createComponent(ConfigPropertyConditional, {
-							name: alias,
-							context
-						})
-					})];
-				}
-			})];
-		},
-		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` || `,
-						children: (alias) => createComponent(ConfigPropertyConditional, {
-							name: alias,
-							context
-						})
-					})];
-				}
-			})];
-		},
-		get children() {
-			return code`return target["${property.getNameAsString()}"];`;
-		}
-	})];
+	return <>
+      {index === 0 ? <IfStatement condition={<>
+              <ConfigPropertyConditional name={property.getNameAsString()} context={context} />
+              <Show when={property.getAlias() && property.getAlias().length > 0}>
+                {code` || `}
+                <For each={property.getAlias()} joiner={code` || `}>
+                  {(alias) => <ConfigPropertyConditional name={alias} context={context} />}
+                </For>
+              </Show>
+            </>}>
+          {code`return target["${property.getNameAsString()}"];`}
+        </IfStatement> : <ElseIfClause condition={<>
+              <ConfigPropertyConditional name={property.getNameAsString()} context={context} />
+              <Show when={property.getAlias() && property.getAlias().length > 0}>
+                {code` || `}
+                <For each={property.getAlias()} joiner={code` || `}>
+                  {(alias) => <ConfigPropertyConditional name={alias} context={context} />}
+                </For>
+              </Show>
+            </>}>
+          {code`return target["${property.getNameAsString()}"];`}
+        </ElseIfClause>}
+    </>;
 }
 function ConfigPropertySet(props) {
 	const [{ context, property, index }] = splitProps(props, [
@@ -121,69 +76,35 @@ function ConfigPropertySet(props) {
 		"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` || `,
-						children: (alias) => createComponent(ConfigPropertyConditional, {
-							name: alias,
-							context
-						})
-					})];
-				}
-			})];
-		},
-		get children() {
-			return code`
+	return <>
+      {index === 0 ? <IfStatement condition={<>
+              <ConfigPropertyConditional name={property.getNameAsString()} context={context} />
+              <Show when={property.getAlias() && property.getAlias().length > 0}>
+                {code` || `}
+                <For each={property.getAlias()} joiner={code` || `}>
+                  {(alias) => <ConfigPropertyConditional name={alias} context={context} />}
+                </For>
+              </Show>
+            </>}>
+          {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` || `,
-						children: (alias) => createComponent(ConfigPropertyConditional, {
-							name: alias,
-							context
-						})
-					})];
-				}
-			})];
-		},
-		get children() {
-			return code`
+`}
+        </IfStatement> : <ElseIfClause condition={<>
+              <ConfigPropertyConditional name={property.getNameAsString()} context={context} />
+              <Show when={property.getAlias() && property.getAlias().length > 0}>
+                {code` || `}
+                <For each={property.getAlias()} joiner={code` || `}>
+                  {(alias) => <ConfigPropertyConditional name={alias} context={context} />}
+                </For>
+              </Show>
+            </>}>
+          {code`
     target["${property.getNameAsString()}"] = newValue;
     return true;
-`;
-		}
-	})];
+`}
+        </ElseIfClause>}
+    </>;
 }
 const createEnvRefkey = refkey("createEnv");
 const envRefkey = refkey("env");
@@ -208,74 +129,41 @@ function EnvBuiltin(props) {
 	});
 	const reflectionGetProperties = computed(() => reflection?.getProperties().filter((property) => !property.isIgnored()).sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())) ?? []);
 	const reflectionSetProperties = computed(() => reflection?.getProperties().filter((property) => !property.isIgnored() && !property.isReadonly()).sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())) ?? []);
-	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": [
-				"stringify",
-				"serializer",
-				"serializeFunction",
-				"deserializeFunction",
-				"ReflectionKind",
-				"Serializer",
-				"TemplateState",
-				"Type",
-				"TypeProperty",
-				"TypePropertySignature"
-			] }, rest.imports ?? {});
-		},
-		get children() {
-			return [
-				createComponent(Show, {
-					get when() {
-						return Boolean(reflection);
-					},
-					get children() {
-						return [
-							createComponent(EnvTypeDefinition, {
-								get defaultValue() {
-									return defaultValue.value;
-								},
-								reflection
-							}),
-							createIntrinsic("hbr", {}),
-							createIntrinsic("hbr", {})
-						];
-					}
-				}),
-				createComponent(ObjectDeclaration, {
-					name: "initialEnv",
-					type: "Partial<EnvBase>",
-					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");
+	return <BuiltinFile id="env" description="The environment configuration module provides an interface to define environment configuration parameters." {...rest} imports={defu({ "@powerlines/deepkit/vendor/type": [
+		"stringify",
+		"serializer",
+		"serializeFunction",
+		"deserializeFunction",
+		"ReflectionKind",
+		"Serializer",
+		"TemplateState",
+		"Type",
+		"TypeProperty",
+		"TypePropertySignature"
+	] }, rest.imports ?? {})}>
+      <Show when={Boolean(reflection)}>
+        <EnvTypeDefinition defaultValue={defaultValue.value} reflection={reflection} />
+        <hbr />
+        <hbr />
+      </Show>
+
+      <ObjectDeclaration name="initialEnv" type="Partial<EnvBase>" defaultValue={defaultValue} reflection={envInstance} export={true} const={true} doc="The initial environment configuration object values for the runtime." />
+      <Spacing />
+
+      <TSDoc heading="The environment configuration serializer for the Powerlines application.">
+        <TSDocLink>
+          {`https://deepkit.io/docs/serialization/serializers`}
+        </TSDocLink>
+        <TSDocLink>
+          {`https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918`}
+        </TSDocLink>
+        <TSDocRemarks>
+          {`This serializer is used to serialize and deserialize the Powerlines environment configuration.`}
+        </TSDocRemarks>
+      </TSDoc>
+      <ClassDeclaration refkey={envSerializerRefkey} name="EnvSerializer" extends="Serializer" export={true}>
+        <ClassMethod name="constructor" public={true} doc="Initializes a new instance of the `EnvSerializer` class.">
+          {code`super("env");
 
           this.deserializeRegistry.register(
             ReflectionKind.boolean,
@@ -284,167 +172,112 @@ function EnvBuiltin(props) {
                 \`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(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",
-					"export": false,
-					"const": true,
-					get initializer() {
-						return createComponent(NewExpression, {
-							args: [],
-							target: "EnvSerializer"
-						});
-					}
-				}),
-				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(TSDocThrows, { children: `ValidationError when serialization or validation fails.` })
-						];
-					}
-				}),
-				createComponent(VarDeclaration, {
-					name: "serializeEnv",
-					"export": true,
-					"const": true,
-					initializer: "serializeFunction<EnvBase>(envSerializer)"
-				}),
-				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(VarDeclaration, {
-					name: "deserializeEnv",
-					"export": true,
-					"const": true,
-					initializer: "deserializeFunction<EnvBase>(envSerializer)"
-				}),
-				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`
+          ); `}
+        </ClassMethod>
+      </ClassDeclaration>
+      <Spacing />
+
+      <TSDoc heading="A {@link EnvSerializer | environment configuration serializer} instance for the Powerlines application.">
+        <TSDocLink>
+          {`https://deepkit.io/docs/serialization/serializers`}
+        </TSDocLink>
+        <TSDocLink>
+          {`https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918`}
+        </TSDocLink>
+        <TSDocRemarks>
+          {`This serializer is used to serialize and deserialize the Powerlines environment configuration.`}
+        </TSDocRemarks>
+      </TSDoc>
+      <VarDeclaration name="envSerializer" export={false} const={true} initializer={<NewExpression args={[]} target="EnvSerializer" />} />
+      <Spacing />
+
+      <TSDoc heading="Serialize a environment configuration object to JSON data objects (not a JSON string).">
+        <TSDocRemarks>
+          {`The resulting JSON object can be stringified using \`JSON.stringify()\`.`}
+        </TSDocRemarks>
+        <TSDocExample>{`const json = serializeEnv(env);`}</TSDocExample>
+        <TSDocThrows>
+          {`ValidationError when serialization or validation fails.`}
+        </TSDocThrows>
+      </TSDoc>
+      <VarDeclaration name="serializeEnv" export={true} const={true} initializer={"serializeFunction<EnvBase>(envSerializer)"} />
+      <Spacing />
+
+      <TSDoc heading="Deserialize a environment configuration object from JSON data objects to JavaScript objects, without running any validators.">
+        <TSDocRemarks>
+          {`Types that are already correct will be used as-is.`}
+        </TSDocRemarks>
+        <TSDocExample>{`const env = deserializeEnv(json);`}</TSDocExample>
+        <TSDocThrows>
+          {`ValidationError when deserialization fails.`}
+        </TSDocThrows>
+      </TSDoc>
+      <VarDeclaration name="deserializeEnv" export={true} const={true} initializer="deserializeFunction<EnvBase>(envSerializer)" />
+      <Spacing />
+
+      <TSDoc heading="Initializes the Powerlines environment configuration module.">
+        <TSDocRemarks>
+          {`This function initializes the Powerlines environment configuration object.`}
+        </TSDocRemarks>
+        <TSDocParam name="environmentConfig">
+          {`The dynamic/runtime configuration - this could include the current environment variables or any other environment-specific settings provided by the runtime.`}
+        </TSDocParam>
+        <TSDocReturns>
+          {`The initialized Powerlines configuration object.`}
+        </TSDocReturns>
+      </TSDoc>
+      <Show when={Boolean(context?.entryPath)}>
+        <FunctionDeclaration refkey={createEnvRefkey} async={false} export={true} name="createEnv" parameters={[{
+		name: "environmentConfig",
+		type: `Partial<Env>`,
+		optional: false,
+		default: "{}"
+	}]} returnType="Env">
+          {code`
   return new Proxy<Env>(
     deserializeEnv({
       ...initialEnv,
       ...environmentConfig
     }) as Env,
     {
-      get: (target: EnvBase, propertyName: string) => { `,
-									createIntrinsic("hbr", {}),
-									createComponent(For, {
-										each: reflectionGetProperties,
-										children: (property, index) => createComponent(ConfigPropertyGet, {
-											index,
-											context,
-											property
-										})
-									}),
-									code`
+      get: (target: EnvBase, propertyName: string) => { `}
+          <hbr />
+
+          <For each={reflectionGetProperties}>
+            {(property, index) => <ConfigPropertyGet index={index} context={context} property={property} />}
+          </For>
+          {code`
             return undefined;
-          }, `,
-									createComponent(Spacing, {}),
-									code` set: (target: EnvBase, propertyName: string, newValue: any) => { `,
-									createIntrinsic("hbr", {}),
-									createComponent(For, {
-										each: reflectionSetProperties,
-										ender: code` else `,
-										children: (property, index) => createComponent(ConfigPropertySet, {
-											index,
-											context,
-											property
-										})
-									}),
-									createIntrinsic("hbr", {}),
-									code`return false;
+          }, `}
+
+          <Spacing />
+          {code` set: (target: EnvBase, propertyName: string, newValue: any) => { `}
+          <hbr />
+
+          <For each={reflectionSetProperties} ender={code` else `}>
+            {(property, index) => <ConfigPropertySet index={index} context={context} property={property} />}
+          </For>
+
+          <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(
+`}
+        </FunctionDeclaration>
+      </Show>
+      <Spacing />
+      <hbr />
+
+      <TSDoc heading="The environment configuration object.">
+        <TSDocRemarks>
+          {`This object provides access to the environment configuration parameters in the application runtime.`}
+        </TSDocRemarks>
+      </TSDoc>
+      <VarDeclaration refkey={envRefkey} name="env" type="Env" export={true} const={true} initializer={<>{code`createEnv(${defaultConfig || "{}"} as Partial<Env>);`}</>} />
+      <Spacing />
+
+      <VarDeclaration export const 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 ||
@@ -497,67 +330,34 @@ 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:
+        `} />
+      <Spacing />
+
+      <TSDoc heading="Detect the \`mode\` of the current runtime environment.">
+        <TSDocRemarks>
+          {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
-				})
-			];
-		}
-	}));
+          `}
+        </TSDocRemarks>
+      </TSDoc>
+      <VarDeclaration export const name="mode" initializer={code`String(env.MODE) || "production"; `} />
+      <Spacing />
+
+      <VarDeclaration export const name="isProduction" doc='Detect if the application is running in `"production"` mode' initializer={code`["prd", "prod", "production"].includes(mode.toLowerCase()); `} />
+      <Spacing />
+
+      <VarDeclaration export const 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; `} />
+      <Spacing />
+
+      <VarDeclaration export const name="isDevelopment" doc='Detect if the application is running in `"development"` mode' initializer={code`["dev", "development"].includes(mode.toLowerCase()); `} />
+      <Spacing />
+
+      <VarDeclaration export const name="isDebug" doc="Detect if the application is currently being debugged" initializer={code`Boolean(isDevelopment && env.DEBUG); `} />
+      <Spacing />
+      <Show when={Boolean(children)}>{children}</Show>
+    </BuiltinFile>;
 }
 
 //#endregion