@powerlines/plugin-env 0.15.4 → 0.15.6

package/dist/components/env.cjs

@@ -1,5 +1,575 @@
-require('../create-reflection-resource-BWYhmX7O.cjs');
-const require_env = require('../env-cO4BUDn1.cjs');
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_context = require('../plugin-alloy/src/core/contexts/context.cjs');
+const require_refkey = require('../plugin-alloy/src/helpers/refkey.cjs');
+const require_tsdoc = require('../plugin-alloy/src/typescript/components/tsdoc.cjs');
+const require_builtin_file = require('../plugin-alloy/src/typescript/components/builtin-file.cjs');
+const require_typescript_interface = require('../plugin-alloy/src/typescript/components/typescript-interface.cjs');
+const require_typescript_object = require('../plugin-alloy/src/typescript/components/typescript-object.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 __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+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");
 
-exports.EnvBuiltin = require_env.EnvBuiltin;
-exports.EnvTypeDefinition = require_env.EnvTypeDefinition;
+//#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 = require_context.usePowerlines();
+	return [
+		(0, __alloy_js_core_jsx_runtime.createComponent)(require_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 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, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.ElseIfClause, {
+		get condition() {
+			return [(0, __alloy_js_core_jsx_runtime.createComponent)(ConfigPropertyConditional, {
+				get name() {
+					return property.getNameAsString();
+				},
+				context
+			}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+				get when() {
+					return (0, __alloy_js_core_jsx_runtime.memo)(() => !!property.getAlias())() && property.getAlias().length > 0;
+				},
+				get children() {
+					return [__alloy_js_core.code` || `, (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+						get each() {
+							return property.getAlias();
+						},
+						joiner: __alloy_js_core.code` || `,
+						children: (alias) => (0, __alloy_js_core_jsx_runtime.createComponent)(ConfigPropertyConditional, {
+							name: alias,
+							context
+						})
+					})];
+				}
+			})];
+		},
+		get children() {
+			return __alloy_js_core.code`
+    target["${property.getNameAsString()}"] = newValue;
+    return true;
+`;
+		}
+	})];
+}
+const createEnvRefkey = require_refkey.refkey("createEnv");
+const envRefkey = require_refkey.refkey("env");
+const envSerializerRefkey = require_refkey.refkey("EnvSerializer");
+/**
+* Generates the environment configuration module for the Powerlines project.
+*/
+function EnvBuiltin(props) {
+	const [{ defaultConfig, children }, rest] = (0, __alloy_js_core.splitProps)(props, ["defaultConfig", "children"]);
+	const context = require_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 __powerlines_deepkit_vendor_type.ReflectionClass({
+			kind: __powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral,
+			description: `The initial environment configuration state for the ${(0, __stryke_string_format_title_case.titleCase)(context?.config?.name)} project.`,
+			types: []
+		}, reflection.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)(require_builtin_file.BuiltinFile, (0, __alloy_js_core_jsx_runtime.mergeProps)({
+		id: "env",
+		description: "The Powerlines environment configuration module provides an interface to define environment configuration parameters."
+	}, rest, {
+		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)(require_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)(require_tsdoc.TSDoc, {
+					heading: "The environment configuration serializer for the Powerlines application.",
+					get children() {
+						return [
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocLink, { children: `https://deepkit.io/docs/serialization/serializers` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocLink, { children: `https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_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(
+      ReflectionKind.boolean,
+      (type: Type, state: TemplateState) => {
+        state.addSetter(
+          \`typeof \${state.accessor.toString()} !== "boolean" ? \${state.accessor.toString()} === 1 || \${state.accessor.toString()} === "1" || \${state.accessor.toString()}.toLowerCase() === "t" || \${state.accessor.toString()}.toLowerCase() === "true" || \${state.accessor.toString()}.toLowerCase() === "y" || \${state.accessor.toString()}.toLowerCase() === "yes" : \${state.accessor.toString()}\`
+        );
+      }
+    );
+`
+						});
+					}
+				}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDoc, {
+					heading: "A {@link EnvSerializer | environment configuration serializer} instance for the Powerlines application.",
+					get children() {
+						return [
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocLink, { children: `https://deepkit.io/docs/serialization/serializers` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocLink, { children: `https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_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)(require_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)(require_tsdoc.TSDocRemarks, { children: `The resulting JSON object can be stringified using JSON.stringify().` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocExample, { children: `const json = serializeEnv(env);` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_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)(require_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)(require_tsdoc.TSDocRemarks, { children: `Types that are already correct will be used as-is.` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocExample, { children: `const env = deserializeEnv(json);` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_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)(require_tsdoc.TSDoc, {
+					heading: "Initializes the Powerlines environment configuration module.",
+					get children() {
+						return [
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocRemarks, { children: `This function initializes the Powerlines environment configuration object.` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_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)(require_tsdoc.TSDocReturns, { children: `The initialized Powerlines configuration object.` })
+						];
+					}
+				}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+					get when() {
+						return Boolean(context?.entryPath);
+					},
+					get children() {
+						return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.FunctionDeclaration, {
+							refkey: createEnvRefkey,
+							async: false,
+							"export": true,
+							name: "createEnv",
+							parameters: [{
+								name: "environmentConfig",
+								type: `Partial<Env>`,
+								optional: false,
+								default: "{}"
+							}],
+							returnType: "Env",
+							get children() {
+								return [
+									__alloy_js_core.code`
+  return new Proxy<Env>(
+    deserializeEnv({
+      ...initialEnv,
+      ...environmentConfig
+    }) as Env,
+    {
+      get: (target: EnvBase, propertyName: string) => { `,
+									(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+									(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+										each: reflectionGetProperties,
+										children: (property, index) => (0, __alloy_js_core_jsx_runtime.createComponent)(ConfigPropertyGet, {
+											index,
+											context,
+											property
+										})
+									}),
+									__alloy_js_core.code`
+            return undefined;
+          }, `,
+									(0, __alloy_js_core_jsx_runtime.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, __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 || "{}"} as Partial<Env>);`];
+					}
+				}),
+				(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, {
+					"export": true,
+					"const": true,
+					name: "isCI",
+					doc: "Detect if the application is running in a CI environment.",
+					initializer: __alloy_js_core.code`Boolean(
+          env.CI ||
+          env.RUN_ID ||
+          env.AGOLA_GIT_REF ||
+          env.AC_APPCIRCLE ||
+          env.APPVEYOR ||
+          env.CODEBUILD ||
+          env.TF_BUILD ||
+          env.bamboo_planKey ||
+          env.BITBUCKET_COMMIT ||
+          env.BITRISE_IO ||
+          env.BUDDY_WORKSPACE_ID ||
+          env.BUILDKITE ||
+          env.CIRCLECI ||
+          env.CIRRUS_CI ||
+          env.CF_BUILD_ID ||
+          env.CM_BUILD_ID ||
+          env.CI_NAME ||
+          env.DRONE ||
+          env.DSARI ||
+          env.EARTHLY_CI ||
+          env.EAS_BUILD ||
+          env.GERRIT_PROJECT ||
+          env.GITEA_ACTIONS ||
+          env.GITHUB_ACTIONS ||
+          env.GITLAB_CI ||
+          env.GOCD ||
+          env.BUILDER_OUTPUT ||
+          env.HARNESS_BUILD_ID ||
+          env.JENKINS_URL ||
+          env.LAYERCI ||
+          env.MAGNUM ||
+          env.NETLIFY ||
+          env.NEVERCODE ||
+          env.PROW_JOB_ID ||
+          env.RELEASE_BUILD_ID ||
+          env.RENDER ||
+          env.SAILCI ||
+          env.HUDSON ||
+          env.SCREWDRIVER ||
+          env.SEMAPHORE ||
+          env.SOURCEHUT ||
+          env.STRIDER ||
+          env.TASK_ID ||
+          env.RUN_ID ||
+          env.TEAMCITY_VERSION ||
+          env.TRAVIS ||
+          env.VELA ||
+          env.NOW_BUILDER ||
+          env.APPCENTER_BUILD_ID ||
+          env.CI_XCODE_PROJECT ||
+          env.XCS || false
+        );
+        `
+				}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDoc, {
+					heading: "Detect the \\`mode\\` of the current runtime environment.",
+					get children() {
+						return (0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocRemarks, { children: __alloy_js_core.code`The \`mode\` is determined by the \`MODE\` environment variable, or falls back to the \`NEXT_PUBLIC_VERCEL_ENV\`, \`NODE_ENV\`, or defaults to \`production\`. While the value can potentially be any string, Storm Software generally only allows a value in the following list:
+- \`production\`
+- \`test\`
+- \`development\`` });
+					}
+				}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "mode",
+					initializer: __alloy_js_core.code`String(env.MODE) || "production"; `
+				}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "isProduction",
+					doc: "Detect if the application is running in \\\"production\\\\\" mode",
+					initializer: __alloy_js_core.code`["prd", "prod", "production"].includes(mode.toLowerCase()); `
+				}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "isTest",
+					doc: "Detect if the application is running in \"test\" mode",
+					initializer: __alloy_js_core.code`["tst", "test", "testing", "stg", "stage", "staging"].includes(mode.toLowerCase()) || env.TEST; `
+				}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "isDevelopment",
+					doc: "Detect if the application is running in \"development\" mode",
+					initializer: __alloy_js_core.code`["dev", "development"].includes(mode.toLowerCase()); `
+				}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "isDebug",
+					doc: "Detect if the application is running in \"debug\" mode",
+					initializer: __alloy_js_core.code`Boolean(isDevelopment && env.DEBUG); `
+				}),
+				(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_core.Show, {
+					get when() {
+						return Boolean(children);
+					},
+					children
+				})
+			];
+		}
+	}));
+}
+
+//#endregion
+exports.EnvBuiltin = EnvBuiltin;
+exports.EnvTypeDefinition = EnvTypeDefinition;

package/dist/components/env.d.cts

@@ -1,3 +1,20 @@
-import "../resolved-BZG2cwRG.cjs";
-import { i as __ΩEnvBuiltinProps, n as EnvBuiltinProps, r as EnvTypeDefinition, t as EnvBuiltin } from "../env-BPodCdD1.cjs";
+import { BuiltinFileProps } from "../plugin-alloy/src/typescript/components/builtin-file.cjs";
+import { TypeScriptInterfaceProps } from "../plugin-alloy/src/typescript/components/typescript-interface.cjs";
+import { Children } from "@alloy-js/core";
+
+//#region src/components/env.d.ts
+
+/**
+ * Generates the environment configuration typescript definition for the Powerlines project.
+ */
+declare function EnvTypeDefinition(props: Omit<TypeScriptInterfaceProps, "name">): Children;
+interface EnvBuiltinProps extends Omit<BuiltinFileProps, "id"> {
+  defaultConfig?: Children;
+}
+/**
+ * Generates the environment configuration module for the Powerlines project.
+ */
+declare function EnvBuiltin(props: EnvBuiltinProps): Children;
+declare type __ΩEnvBuiltinProps = any[];
+//#endregion
 export { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps };

package/dist/components/env.d.mts

@@ -1,4 +1,20 @@
-import "../resolved-V5COsfDu.mjs";
-import "../components-8W0Zgj0y.mjs";
-import { i as __ΩEnvBuiltinProps, n as EnvBuiltinProps, r as EnvTypeDefinition, t as EnvBuiltin } from "../env-zhzvpUI5.mjs";
+import { BuiltinFileProps } from "../plugin-alloy/src/typescript/components/builtin-file.mjs";
+import { TypeScriptInterfaceProps } from "../plugin-alloy/src/typescript/components/typescript-interface.mjs";
+import { Children } from "@alloy-js/core";
+
+//#region src/components/env.d.ts
+
+/**
+ * Generates the environment configuration typescript definition for the Powerlines project.
+ */
+declare function EnvTypeDefinition(props: Omit<TypeScriptInterfaceProps, "name">): Children;
+interface EnvBuiltinProps extends Omit<BuiltinFileProps, "id"> {
+  defaultConfig?: Children;
+}
+/**
+ * Generates the environment configuration module for the Powerlines project.
+ */
+declare function EnvBuiltin(props: EnvBuiltinProps): Children;
+declare type __ΩEnvBuiltinProps = any[];
+//#endregion
 export { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps };