@powerlines/plugin-date 0.12.258 → 0.12.260

package/dist/plugin-env/src/components/env.cjs

@@ -0,0 +1,497 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_context = require('../../../plugin-alloy/src/core/contexts/context.cjs');
+const require_load = require('../helpers/load.cjs');
+const require_create_reflection_resource = require('../helpers/create-reflection-resource.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');
+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 react_jsx_runtime = require("react/jsx-runtime");
+let __stryke_type_checks_is_null = require("@stryke/type-checks/is-null");
+let __alloy_js_typescript = require("@alloy-js/typescript");
+
+//#region ../plugin-env/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.usePowerlinesSafe();
+	if (!context) return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_typescript_interface.TypeScriptInterface, {
+			name: " EnvBase",
+			defaultValue,
+			reflection,
+			export: true
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDoc, {
+			heading: "The environment configuration object with prefixed keys.",
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.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.` })
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_typescript.TypeDeclaration, {
+			name: "Env",
+			export: true,
+			children: __alloy_js_core.code` {
+    [Key in keyof EnvBase as Key ${context.config.env.prefix.map((prefix) => `| \`${prefix.replace(/_$/g, "")}_\${Key}\``).join(" ")}]: EnvBase[Key];
+}
+`
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {})
+	] });
+}
+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 /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: index === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_typescript.IfStatement, {
+		condition: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConfigPropertyConditional, {
+			name: property.getNameAsString(),
+			context
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__alloy_js_core.Show, {
+			when: property.getAlias() && property.getAlias().length > 0,
+			children: [__alloy_js_core.code` || `, /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.For, {
+				each: property.getAlias(),
+				joiner: __alloy_js_core.code` || `,
+				children: (alias) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConfigPropertyConditional, {
+					name: alias,
+					context
+				})
+			})]
+		})] }),
+		children: __alloy_js_core.code`return target["${property.getNameAsString()}"];`
+	}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_typescript.ElseIfClause, {
+		condition: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConfigPropertyConditional, {
+			name: property.getNameAsString(),
+			context
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__alloy_js_core.Show, {
+			when: property.getAlias() && property.getAlias().length > 0,
+			children: [__alloy_js_core.code` || `, /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.For, {
+				each: property.getAlias(),
+				joiner: __alloy_js_core.code` || `,
+				children: (alias) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConfigPropertyConditional, {
+					name: alias,
+					context
+				})
+			})]
+		})] }),
+		children: __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 /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: index === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_typescript.IfStatement, {
+		condition: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConfigPropertyConditional, {
+			name: property.getNameAsString(),
+			context
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__alloy_js_core.Show, {
+			when: property.getAlias() && property.getAlias().length > 0,
+			children: [__alloy_js_core.code` || `, /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.For, {
+				each: property.getAlias(),
+				joiner: __alloy_js_core.code` || `,
+				children: (alias) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConfigPropertyConditional, {
+					name: alias,
+					context
+				})
+			})]
+		})] }),
+		children: __alloy_js_core.code`
+    target["${property.getNameAsString()}"] = newValue;
+    return true;
+`
+	}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_typescript.ElseIfClause, {
+		condition: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConfigPropertyConditional, {
+			name: property.getNameAsString(),
+			context
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__alloy_js_core.Show, {
+			when: property.getAlias() && property.getAlias().length > 0,
+			children: [__alloy_js_core.code` || `, /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.For, {
+				each: property.getAlias(),
+				joiner: __alloy_js_core.code` || `,
+				children: (alias) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConfigPropertyConditional, {
+					name: alias,
+					context
+				})
+			})]
+		})] }),
+		children: __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.usePowerlinesSafe();
+	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 /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_builtin_file.BuiltinFile, {
+		id: "env",
+		description: "The environment configuration module provides an interface to define environment configuration parameters.",
+		...rest,
+		imports: (0, defu.default)({ "@powerlines/deepkit/vendor/type": [
+			"stringify",
+			"serializer",
+			"serializeFunction",
+			"deserializeFunction",
+			"ReflectionKind",
+			"Serializer",
+			"TemplateState",
+			"Type",
+			"TypeProperty",
+			"TypePropertySignature"
+		] }, rest.imports ?? {}),
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__alloy_js_core.Show, {
+				when: !(0, __stryke_type_checks_is_null.isNull)(reflection.data),
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(EnvTypeDefinition, {
+						defaultValue: defaultValue.value,
+						reflection: reflection.data
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {})
+				]
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_typescript_object.TypescriptObject, {
+				name: "initialEnv",
+				type: "Partial<EnvBase>",
+				defaultValue,
+				reflection: envInstance,
+				export: true,
+				const: true,
+				doc: "The initial environment configuration object values for the runtime."
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_tsdoc.TSDoc, {
+				heading: "The environment configuration serializer for the Powerlines application.",
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDocLink, { children: `https://deepkit.io/docs/serialization/serializers` }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDocLink, { children: `https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918` }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDocRemarks, { children: `This serializer is used to serialize and deserialize the Powerlines environment configuration.` })
+				]
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_typescript.ClassDeclaration, {
+				refkey: envSerializerRefkey,
+				name: "EnvSerializer",
+				extends: "Serializer",
+				export: true,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_typescript.ClassMethod, {
+					name: "constructor",
+					public: true,
+					doc: "Initializes a new instance of the `EnvSerializer` class.",
+					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()}\`
+        );
+      }
+    );
+`
+				})
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_tsdoc.TSDoc, {
+				heading: "A {@link EnvSerializer | environment configuration serializer} instance for the Powerlines application.",
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDocLink, { children: `https://deepkit.io/docs/serialization/serializers` }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDocLink, { children: `https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918` }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDocRemarks, { children: `This serializer is used to serialize and deserialize the Powerlines environment configuration.` })
+				]
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_typescript.VarDeclaration, {
+				name: "envSerializer",
+				export: false,
+				const: true,
+				initializer: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_typescript.NewExpression, {
+					args: [],
+					target: "EnvSerializer"
+				})
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_tsdoc.TSDoc, {
+				heading: "Serialize a environment configuration object to JSON data objects (not a JSON string).",
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDocRemarks, { children: `The resulting JSON object can be stringified using \`JSON.stringify()\`.` }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDocExample, { children: `const json = serializeEnv(env);` }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDocThrows, { children: `ValidationError when serialization or validation fails.` })
+				]
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_typescript.VarDeclaration, {
+				name: "serializeEnv",
+				export: true,
+				const: true,
+				initializer: "serializeFunction<EnvBase>(envSerializer)"
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_tsdoc.TSDoc, {
+				heading: "Deserialize a environment configuration object from JSON data objects to JavaScript objects, without running any validators.",
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDocRemarks, { children: `Types that are already correct will be used as-is.` }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDocExample, { children: `const env = deserializeEnv(json);` }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDocThrows, { children: `ValidationError when deserialization fails.` })
+				]
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_typescript.VarDeclaration, {
+				name: "deserializeEnv",
+				export: true,
+				const: true,
+				initializer: "deserializeFunction<EnvBase>(envSerializer)"
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_tsdoc.TSDoc, {
+				heading: "Initializes the Powerlines environment configuration module.",
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDocRemarks, { children: `This function initializes the Powerlines environment configuration object.` }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(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.`
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDocReturns, { children: `The initialized Powerlines configuration object.` })
+				]
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+				when: Boolean(context?.entryPath),
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__alloy_js_typescript.FunctionDeclaration, {
+					refkey: createEnvRefkey,
+					async: false,
+					export: true,
+					name: "createEnv",
+					parameters: [{
+						name: "environmentConfig",
+						type: `Partial<Env>`,
+						optional: false,
+						default: "{}"
+					}],
+					returnType: "Env",
+					children: [
+						__alloy_js_core.code`
+  return new Proxy<Env>(
+    deserializeEnv({
+      ...initialEnv,
+      ...environmentConfig
+    }) as Env,
+    {
+      get: (target: EnvBase, propertyName: string) => { `,
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.For, {
+							each: reflectionGetProperties,
+							children: (property, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConfigPropertyGet, {
+								index,
+								context,
+								property
+							})
+						}),
+						__alloy_js_core.code`
+            return undefined;
+          }, `,
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+						__alloy_js_core.code` set: (target: EnvBase, propertyName: string, newValue: any) => { `,
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.For, {
+							each: reflectionSetProperties,
+							ender: __alloy_js_core.code` else `,
+							children: (property, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConfigPropertySet, {
+								index,
+								context,
+								property
+							})
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+						__alloy_js_core.code`return false;
+      }
+    }
+  );
+`
+					]
+				})
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDoc, {
+				heading: "The environment configuration object.",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDocRemarks, { children: `This object provides access to the environment configuration parameters in the application runtime.` })
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_typescript.VarDeclaration, {
+				refkey: envRefkey,
+				name: "env",
+				type: "Env",
+				export: true,
+				const: true,
+				initializer: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: __alloy_js_core.code`createEnv(${defaultConfig || "{}"} as Partial<Env>);` })
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_typescript.VarDeclaration, {
+				export: true,
+				const: true,
+				name: "isCI",
+				doc: "Detect if the application is running in a continuous integration (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
+        );
+        `
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_tsdoc.TSDoc, {
+				heading: "Detect the \\`mode\\` of the current runtime environment.",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(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, it is generally recommended to only allow a value in the following list:
+          - \`production\`
+          - \`test\`
+          - \`development\`
+          ` })
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_typescript.VarDeclaration, {
+				export: true,
+				const: true,
+				name: "mode",
+				initializer: __alloy_js_core.code`String(env.MODE) || "production"; `
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__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()); `
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__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; `
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__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()); `
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_typescript.VarDeclaration, {
+				export: true,
+				const: true,
+				name: "isDebug",
+				doc: "Detect if the application is currently being debugged",
+				initializer: __alloy_js_core.code`Boolean(isDevelopment && env.DEBUG); `
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("hbr", {}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__alloy_js_core.Show, {
+				when: Boolean(children),
+				children
+			})
+		]
+	});
+}
+
+//#endregion
+exports.EnvBuiltin = EnvBuiltin;
+exports.EnvTypeDefinition = EnvTypeDefinition;