@powerlines/plugin-env 0.15.2 → 0.15.4

package/dist/env-IQvgnabX.mjs

@@ -0,0 +1,1578 @@
+import { P as usePowerlines, c as ReflectionPropertyContext, d as SingleLineComment, l as useReflectionClass, o as SourceFile, r as loadEnvFromContext, s as ReflectionClassContext, t as createReflectionResource, u as useReflectionProperty } from "./create-reflection-resource-BNYxBgW2.mjs";
+import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { ReflectionClass, ReflectionKind, stringifyType } from "@powerlines/deepkit/vendor/type";
+import { Declaration, For, List, Name, Prose, Scope, Show, SourceDirectoryContext, childrenArray, code, computed, createSymbolSlot, refkey, splitProps, useContext, useScope } from "@alloy-js/core";
+import { StormJSON } from "@stryke/json/storm-json";
+import { replaceExtension, replacePath } from "@stryke/path/replace";
+import { appendPath } from "@stryke/path/append";
+import defu from "defu";
+import { hasFileExtension } from "@stryke/path/file-path-fns";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { titleCase } from "@stryke/string-format/title-case";
+import { isString } from "@stryke/type-checks/is-string";
+import { getUniqueBy } from "@stryke/helpers/get-unique";
+import { isNull } from "@stryke/type-checks/is-null";
+import { isUndefined } from "@stryke/type-checks/is-undefined";
+import { camelCase } from "@stryke/string-format/camel-case";
+import { ClassDeclaration, ClassMethod, ElseIfClause, FunctionDeclaration, IfStatement, ImportStatements, InterfaceDeclaration, InterfaceMember, NewExpression, ObjectExpression, ObjectProperty, PackageContext, SourceFileContext as SourceFileContext$1, TSModuleScope, TSSymbolFlags, TypeDeclaration, TypeRefContext, VarDeclaration, createValueSymbol, getSourceDirectoryData, useSourceFile, useTSNamePolicy } from "@alloy-js/typescript";
+import { isSet } from "@stryke/type-checks/is-set";
+import { isBoolean } from "@stryke/type-checks/is-boolean";
+import { pascalCase } from "@stryke/string-format/pascal-case";
+
+//#region ../deepkit/src/utilities.ts
+/**
+* Converts any {@link ReflectionProperty} or {@link ReflectionParameter}'s value to string representation.
+*
+* @param property - The {@link ReflectionProperty} or {@link ReflectionParameter} containing the value to stringify.
+* @param value - The value to stringify.
+* @returns A string representation of the value.
+*/
+function stringifyDefaultValue(property, value) {
+	return stringifyValue(property.type, value ?? property.getDefaultValue());
+}
+/**
+* Stringifies a value as a string.
+*
+* @param value - The value to stringify.
+* @returns A string representation of the value.
+*/
+function stringifyStringValue(value) {
+	return `"${String(value).replaceAll("\"", "\\\"")}"`;
+}
+/**
+* Converts any {@link Type}'s actual value to string representation.
+*
+* @param type - The {@link Type} of the value to stringify.
+* @param value - The value to stringify.
+* @returns A string representation of the value.
+*/
+function stringifyValue(type, value) {
+	return isUndefined(value) ? "undefined" : isNull(value) ? "null" : type.kind === ReflectionKind.boolean ? String(value).trim().toLowerCase() === "true" ? "true" : "false" : type.kind === ReflectionKind.string || type.kind === ReflectionKind.literal && isString(type.literal) ? stringifyStringValue(value) : type.kind === ReflectionKind.enum ? getEnumReflectionType(type).kind === ReflectionKind.string ? stringifyStringValue(value) : `${String(value)}` : type.kind === ReflectionKind.union ? isStringUnion(type) ? stringifyStringValue(value) : `${String(value)}` : type.kind === ReflectionKind.array ? stringifyStringValue(StormJSON.stringify(value)) : type.kind === ReflectionKind.object || type.kind === ReflectionKind.objectLiteral ? StormJSON.stringify(value) : type.kind === ReflectionKind.property || type.kind === ReflectionKind.parameter ? stringifyValue(type.type, value) : String(value);
+}
+/**
+* Converts a {@link TypeEnum} to its underlying primitive type representation.
+*
+* @param type - The {@link TypeEnum} to evaluate.
+* @returns A string representation of the primitive type.
+*/
+function getEnumReflectionType(type) {
+	if (type.kind !== ReflectionKind.enum) throw new Error(`Expected a TypeEnum, but received ${type.kind}.`);
+	const unique = getUniqueBy(type.values.filter((value) => value !== void 0 && value !== null), (enumMember) => isString(enumMember) ? { kind: ReflectionKind.string } : { kind: ReflectionKind.number });
+	if (unique.length === 0) throw new Error(`No valid enum members could be found.`);
+	return unique[0] && isString(unique[0]) ? { kind: ReflectionKind.string } : { kind: ReflectionKind.number };
+}
+/**
+* Converts a {@link TypeUnion} to its underlying primitive type representation.
+*
+* @param type - The {@link TypeUnion} to evaluate.
+* @returns A string representation of the primitive type.
+*/
+function getUnionTypes(type) {
+	if (type.kind === ReflectionKind.union && type.types.length > 0) return getUniqueBy(type.types, (member) => member.kind);
+	throw new Error(`Expected a TypeUnion, but received ${type.kind}.`);
+}
+function isStringUnion(type) {
+	return getUnionTypes(type).some((member) => member.kind === ReflectionKind.string || member.kind === ReflectionKind.literal && isString(member.literal));
+}
+
+//#endregion
+//#region ../plugin-alloy/src/helpers/refkey.ts
+/**
+* Create a refkey for the provided arguments. Passing no arguments returns a fresh refkey that is guaranteed to be unique. Otherwise, the arguments passed will be used to create a refkey for those values. Providing the same arguments will always return the same refkey.
+*
+* @remarks
+* Values are compared using the SameValueZero algorithm, which considers objects the same if they are reference identical, and primitives the same if they are the same value, with the exception of `NaN`, which is always considered equal to other `NaN` values, and `-0`, which is considered identical to `+0`
+*/
+function refkey$1(...args) {
+	return refkey("powerlines", ...args);
+}
+
+//#endregion
+//#region ../plugin-alloy/src/typescript/components/tsdoc.tsx
+/**
+* Generates a TypeScript interface for the given reflection class.
+*/
+function TSDoc(props) {
+	const [{ children, heading }] = splitProps(props, ["children", "heading"]);
+	return [
+		"/**",
+		createIntrinsic("align", {
+			string: " * ",
+			get children() {
+				return [
+					createIntrinsic("hbr", {}),
+					createComponent(Show, {
+						get when() {
+							return !isUndefined(heading);
+						},
+						get children() {
+							return [
+								heading,
+								createIntrinsic("hbr", {}),
+								createComponent(Show, {
+									get when() {
+										return memo(() => !!!isUndefined(children))() && childrenArray(() => children).length > 0;
+									},
+									get children() {
+										return createIntrinsic("hbr", {});
+									}
+								})
+							];
+						}
+					}),
+					createComponent(Show, {
+						get when() {
+							return memo(() => !!!isUndefined(children))() && childrenArray(() => children).length > 0;
+						},
+						get children() {
+							return createComponent(List, { get children() {
+								return childrenArray(() => children);
+							} });
+						}
+					})
+				];
+			}
+		}),
+		createIntrinsic("hbr", {}),
+		` */`,
+		createIntrinsic("hbr", {})
+	];
+}
+/**
+* Create a TSDoc `@<props.tag>` tag.
+*/
+function TSDocTag(props) {
+	const [{ children, tag }] = splitProps(props, ["children", "tag"]);
+	return [
+		`@${tag} `,
+		createComponent(Show, {
+			get when() {
+				return Boolean(children);
+			},
+			get children() {
+				return createIntrinsic("align", {
+					width: 2,
+					get children() {
+						return createComponent(Prose, { children });
+					}
+				});
+			}
+		}),
+		createIntrinsic("hbr", {})
+	];
+}
+/**
+* Create a TSDoc `@title` tag.
+*/
+function TSDocTitle(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "title",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@domain` tag.
+*/
+function TSDocDomain(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "domain",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@alias` tag.
+*/
+function TSDocAlias(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "alias",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@permission` tag.
+*/
+function TSDocPermission(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "permission",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@defaultValue` tag.
+*/
+function TSDocDefaultValue(props) {
+	return [
+		"@defaultValue ",
+		createComponent(Show, {
+			get when() {
+				return !isUndefined(props.value);
+			},
+			get children() {
+				return createIntrinsic("align", {
+					width: 2,
+					get children() {
+						return createComponent(Prose, { get children() {
+							return stringifyDefaultValue(props.value);
+						} });
+					}
+				});
+			}
+		}),
+		createIntrinsic("hbr", {})
+	];
+}
+/**
+* Create a TSDoc `@remarks` tag.
+*/
+function TSDocRemarks(props) {
+	return [
+		"@remarks ",
+		createIntrinsic("hbr", {}),
+		createComponent(List, {
+			hardline: true,
+			get children() {
+				return childrenArray(() => props.children);
+			}
+		})
+	];
+}
+/**
+* Create a TSDoc `@see` tag.
+*/
+function TSDocLink(props) {
+	return createComponent(TSDocTag, mergeProps(props, { tag: "see" }));
+}
+/**
+* Create a TSDoc `@example` tag.
+*/
+function TSDocExample(props) {
+	const [{ tsx, fenced = true, language, children }] = splitProps(props, [
+		"tsx",
+		"fenced",
+		"language",
+		"children"
+	]);
+	return [
+		"@example ",
+		createIntrinsic("hbr", {}),
+		createComponent(Show, {
+			when: fenced,
+			get children() {
+				return [
+					"```",
+					language || (tsx ? "tsx" : "ts"),
+					createIntrinsic("hbr", {})
+				];
+			}
+		}),
+		children,
+		createComponent(Show, {
+			when: fenced,
+			get children() {
+				return [createIntrinsic("hbr", {}), "```"];
+			}
+		})
+	];
+}
+/**
+* Create a TSDoc `@readonly` tag.
+*/
+function TSDocReadonly() {
+	return createComponent(TSDocTag, { tag: "readonly" });
+}
+/**
+* Create a TSDoc `@internal` tag.
+*/
+function TSDocInternal() {
+	return createComponent(TSDocTag, { tag: "internal" });
+}
+/**
+* Create a TSDoc `@ignore` tag.
+*/
+function TSDocIgnore() {
+	return createComponent(TSDocTag, { tag: "ignore" });
+}
+/**
+* Create a TSDoc `@hidden` tag.
+*/
+function TSDocHidden() {
+	return createComponent(TSDocTag, { tag: "hidden" });
+}
+/**
+* Generates a TypeScript interface property for the given reflection class.
+*/
+function TSDocAttributesTags(props) {
+	const [{ title, alias, permission, domain, readonly, internal, ignore, hidden, defaultValue }] = splitProps(props, [
+		"title",
+		"alias",
+		"permission",
+		"domain",
+		"readonly",
+		"internal",
+		"ignore",
+		"hidden",
+		"defaultValue"
+	]);
+	return [
+		createComponent(Show, {
+			get when() {
+				return isSetString(title);
+			},
+			get children() {
+				return createComponent(TSDocTitle, { children: title });
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return !isUndefined(alias) && alias.length > 0;
+			},
+			get children() {
+				return createComponent(For, {
+					each: alias ?? [],
+					children: (alias$1) => createComponent(TSDocAlias, { children: alias$1 })
+				});
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return isSetString(domain);
+			},
+			get children() {
+				return createComponent(TSDocDomain, { children: domain });
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return !isUndefined(permission) && permission.length > 0;
+			},
+			get children() {
+				return createComponent(For, {
+					each: permission ?? [],
+					children: (permission$1) => createComponent(TSDocPermission, { children: permission$1 })
+				});
+			}
+		}),
+		createComponent(Show, {
+			when: readonly === true,
+			get children() {
+				return createComponent(TSDocReadonly, {});
+			}
+		}),
+		createComponent(Show, {
+			when: internal === true,
+			get children() {
+				return createComponent(TSDocInternal, {});
+			}
+		}),
+		createComponent(Show, {
+			when: ignore === true,
+			get children() {
+				return createComponent(TSDocIgnore, {});
+			}
+		}),
+		createComponent(Show, {
+			when: hidden === true,
+			get children() {
+				return createComponent(TSDocHidden, {});
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return !isUndefined(defaultValue);
+			},
+			get children() {
+				return createComponent(TSDocDefaultValue, { value: defaultValue });
+			}
+		})
+	];
+}
+/**
+* Create a TSDoc parameter set off with `@param`.
+*/
+function TSDocParam(props) {
+	return [
+		"@param ",
+		createComponent(TSDocParamName, {
+			get name() {
+				return props.name;
+			},
+			get optional() {
+				return props.optional;
+			},
+			get defaultValue() {
+				return props.defaultValue;
+			}
+		}),
+		createComponent(TSDocParamDescription, { get children() {
+			return props.children;
+		} })
+	];
+}
+function TSDocParamName(props) {
+	return [
+		createComponent(Show, {
+			get when() {
+				return props.optional;
+			},
+			children: "["
+		}),
+		memo(() => props.name),
+		createComponent(Show, {
+			get when() {
+				return Boolean(props.defaultValue);
+			},
+			get children() {
+				return ["=", memo(() => props.defaultValue)];
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return props.optional;
+			},
+			children: "]"
+		})
+	];
+}
+function TSDocParamDescription(props) {
+	return createComponent(Show, {
+		get when() {
+			return Boolean(props.children);
+		},
+		get children() {
+			return [" - ", createIntrinsic("align", {
+				width: 2,
+				get children() {
+					return createComponent(Prose, { get children() {
+						return props.children;
+					} });
+				}
+			})];
+		}
+	});
+}
+/**
+* Create a TSDoc `@returns` tag.
+*/
+function TSDocReturns(props) {
+	return createComponent(TSDocTag, mergeProps(props, { tag: "returns" }));
+}
+/**
+* Create a TSDoc `@throws` tag.
+*/
+function TSDocThrows(props) {
+	return createComponent(TSDocTag, mergeProps(props, { tag: "throws" }));
+}
+/**
+* Generates a TSDoc `@module` tag for the given module name.
+*/
+function TSDocModule(props) {
+	const [{ children, name, prefix }] = splitProps(props, [
+		"children",
+		"name",
+		"prefix"
+	]);
+	const context = usePowerlines();
+	return [
+		"/**",
+		createIntrinsic("align", {
+			string: " * ",
+			get children() {
+				return [
+					createIntrinsic("hbr", {}),
+					createComponent(Show, {
+						get when() {
+							return Boolean(children);
+						},
+						get children() {
+							return [
+								createComponent(List, {
+									hardline: true,
+									get children() {
+										return childrenArray(() => children);
+									}
+								}),
+								createIntrinsic("hbr", {}),
+								createIntrinsic("hbr", {})
+							];
+						}
+					}),
+					"@module ",
+					memo(() => prefix || context?.config.output.builtinPrefix),
+					":",
+					name
+				];
+			}
+		}),
+		createIntrinsic("hbr", {}),
+		` */`
+	];
+}
+
+//#endregion
+//#region ../plugin-alloy/src/typescript/components/typescript-file.tsx
+/**
+* A base component representing a Powerlines generated Typescript source file.
+*
+* @param props - The properties for the source file.
+* @returns The rendered source file component.
+*/
+function TypescriptFile(props) {
+	const [{ children, path, imports, tsx, header, hashbang }, rest] = splitProps(props, [
+		"children",
+		"path",
+		"imports",
+		"tsx",
+		"header",
+		"hashbang"
+	]);
+	const directoryContext = useContext(SourceDirectoryContext);
+	const sdData = getSourceDirectoryData(directoryContext);
+	const modulePath = appendPath(path, directoryContext.path);
+	const scope = new TSModuleScope(modulePath, useScope());
+	sdData.modules.add(scope);
+	const pkg = useContext(PackageContext);
+	if (pkg) pkg.scope.addModule(scope);
+	if (props.export) {
+		if (pkg) if (isBoolean(props.export)) pkg.scope.addExport(modulePath, scope);
+		else pkg.scope.addExport(props.export, scope);
+	}
+	return createComponent(SourceFileContext$1.Provider, {
+		value: { scope },
+		get children() {
+			return createComponent(Scope, {
+				value: scope,
+				get children() {
+					return createComponent(SourceFile, mergeProps(rest, {
+						path: modulePath,
+						get header() {
+							return header ?? createComponent(TypescriptFileHeader, {
+								hashbang,
+								get children() {
+									return createComponent(TypescriptFileHeaderImports, {
+										imports,
+										scope
+									});
+								}
+							});
+						},
+						filetype: tsx ? "tsx" : "typescript",
+						children
+					}));
+				}
+			});
+		}
+	});
+}
+/**
+* Renders the header for a Powerlines Typescript source file.
+*
+* @param props - The properties for the source file header.
+* @returns The rendered source file header.
+*/
+function TypescriptFileHeader(props) {
+	const { header, hashbang, disableEslint = true, disableBiome = true, disablePrettier = false, children } = props;
+	const context = usePowerlines();
+	return [
+		createComponent(Show, {
+			get when() {
+				return Boolean(hashbang);
+			},
+			get children() {
+				return [memo(() => hashbang === true ? code`#!/usr/bin/env ${context?.config.mode === "development" ? "-S NODE_OPTIONS=--enable-source-maps" : ""} node` : hashbang), createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(header);
+			},
+			get children() {
+				return [header, createIntrinsic("hbr", {})];
+			}
+		}),
+		createIntrinsic("hbr", {}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(disableEslint);
+			},
+			get children() {
+				return [createComponent(SingleLineComment, {
+					variant: "slash-star",
+					children: "eslint-disable"
+				}), createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(disablePrettier);
+			},
+			get children() {
+				return [createComponent(SingleLineComment, {
+					variant: "slash-star",
+					children: "prettier-ignore"
+				}), createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(disableBiome);
+			},
+			get children() {
+				return [createComponent(SingleLineComment, { children: "biome-ignore lint: disable" }), createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(disableEslint) || Boolean(disablePrettier) || Boolean(disableBiome);
+			},
+			get children() {
+				return createIntrinsic("hbr", {});
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(children);
+			},
+			get children() {
+				return [children, createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(SingleLineComment, { get children() {
+			return code`Generated by ${titleCase(context?.config.framework) || "Powerlines"}`;
+		} }),
+		createIntrinsic("hbr", {}),
+		createComponent(SingleLineComment, { children: code`NOTE: Do not edit this file manually - it will be overwritten automatically by the "prepare" command` }),
+		createIntrinsic("hbr", {})
+	];
+}
+/**
+* Renders the header for a Powerlines Typescript source file.
+*
+* @param props - The properties for the source file header.
+* @returns The rendered source file header.
+*/
+function TypescriptFileHeaderImports(props) {
+	const { imports } = props;
+	const context = usePowerlines();
+	const sourceFile = useSourceFile();
+	const scope = props.scope ?? sourceFile.scope;
+	return createComponent(Show, {
+		get when() {
+			return scope.importedModules.size > 0 || !!imports && Object.keys(imports).length > 0;
+		},
+		get children() {
+			return [
+				createComponent(Show, {
+					get when() {
+						return !!imports && Object.keys(imports).length > 0;
+					},
+					get children() {
+						return Object.entries(imports ?? {}).filter(([key]) => key !== "$builtins").concat(imports && imports.$builtins ? Object.entries(imports.$builtins).map(([key, entry]) => [key.includes(":") ? key : `${context.config.output.builtinPrefix}:${key}`, entry]) : []).map(([module, imported]) => {
+							return code`import ${imported === null ? "" : imported.filter((i) => !isString(i) && i.default).map((i) => i.alias ? i.alias : i.name).join(", ") + (imported.filter((i) => !isString(i) && i.default).length > 0 && imported.filter((i) => isString(i) || !i.default).length > 0 ? ", " : "") + (imported.filter((i) => isString(i) || !i.default).length > 0 ? `{ ${imported.map((i) => isString(i) ? i : i.alias ? `${i.name} as ${i.alias}` : i.name).join(", ")} }` : "")} from "${module}";`;
+						});
+					}
+				}),
+				createComponent(Show, {
+					get when() {
+						return scope.importedModules.size > 0;
+					},
+					get children() {
+						return createComponent(ImportStatements, { get records() {
+							return scope.importedModules;
+						} });
+					}
+				}),
+				createIntrinsic("hbr", {})
+			];
+		}
+	});
+}
+
+//#endregion
+//#region ../plugin-alloy/src/typescript/components/builtin-file.tsx
+/**
+* A base component representing a Powerlines generated Typescript source file.
+*
+* @param props - The properties for the source file.
+* @returns The rendered source file component.
+*/
+function BuiltinFile(props) {
+	const [{ children, imports, id, description, tsx }, rest] = splitProps(props, [
+		"children",
+		"imports",
+		"id",
+		"description",
+		"tsx"
+	]);
+	const context = usePowerlines();
+	const path = computed(() => replacePath(`${!isSet(tsx) ? id : replaceExtension(id)}${hasFileExtension(id) && !isSet(tsx) ? "" : tsx ? ".tsx" : ".ts"}`, context.builtinsPath));
+	return createComponent(TypescriptFile, mergeProps({
+		get header() {
+			return createComponent(TypescriptFileHeader, {
+				get header() {
+					return createComponent(TSDocModule, {
+						name: id,
+						children: description
+					});
+				},
+				get children() {
+					return createComponent(TypescriptFileHeaderImports, { imports });
+				}
+			});
+		},
+		get meta() {
+			return {
+				kind: "builtin",
+				id: replaceExtension(id)
+			};
+		}
+	}, rest, {
+		get path() {
+			return path.value;
+		},
+		children
+	}));
+}
+
+//#endregion
+//#region ../plugin-alloy/src/typescript/components/tsdoc-reflection.tsx
+/**
+* Generates a TypeScript interface property for the given reflection class.
+*/
+function TSDocReflectionClass(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	const reflectionClass = useReflectionClass();
+	const title = computed(() => reflectionClass.reflection.getTitle() || titleCase(reflectionClass.reflection.getName()));
+	const alias = computed(() => reflectionClass.reflection.getAlias());
+	const domain = computed(() => reflectionClass.reflection.getDomain());
+	const permission = computed(() => reflectionClass.reflection.getPermission());
+	const readonly = computed(() => reflectionClass.reflection.isReadonly());
+	const internal = computed(() => reflectionClass.reflection.isInternal());
+	const ignore = computed(() => reflectionClass.reflection.isIgnored());
+	const hidden = computed(() => reflectionClass.reflection.isHidden());
+	if (!reflectionClass.reflection.getName()) return null;
+	return createComponent(TSDoc, mergeProps(rest, {
+		get heading() {
+			return reflectionClass.reflection.getDescription();
+		},
+		get children() {
+			return [createComponent(Show, {
+				get when() {
+					return isSetString(title.value) || !isUndefined(alias.value) && alias.value.length > 0 || !isUndefined(permission.value) && permission.value.length > 0 || isSetString(domain.value) || !isUndefined(readonly.value) || !isUndefined(internal.value) || !isUndefined(ignore.value) || !isUndefined(hidden.value);
+				},
+				get children() {
+					return createComponent(TSDocAttributesTags, {
+						get title() {
+							return title.value;
+						},
+						get alias() {
+							return alias.value;
+						},
+						get domain() {
+							return domain.value;
+						},
+						get permission() {
+							return permission.value;
+						},
+						get readonly() {
+							return readonly.value;
+						},
+						get internal() {
+							return internal.value;
+						},
+						get ignore() {
+							return ignore.value;
+						},
+						get hidden() {
+							return hidden.value;
+						}
+					});
+				}
+			}), createComponent(Show, {
+				get when() {
+					return memo(() => !!Boolean(children))() && childrenArray(() => children).length > 0;
+				},
+				get children() {
+					return createComponent(List, { get children() {
+						return childrenArray(() => children);
+					} });
+				}
+			})];
+		}
+	}));
+}
+/**
+* Generates a TypeScript interface property for the given reflection class.
+*/
+function TSDocReflectionProperty(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	const context = useReflectionProperty();
+	return createComponent(TSDoc, mergeProps({ get heading() {
+		return context.getDescription();
+	} }, rest, { get children() {
+		return [createComponent(TSDocAttributesTags, {
+			get title() {
+				return context.getTitle();
+			},
+			get alias() {
+				return context.getAlias();
+			},
+			get domain() {
+				return context.getDomain();
+			},
+			get permission() {
+				return context.getPermission();
+			},
+			get readonly() {
+				return context.isReadonly();
+			},
+			get internal() {
+				return context.isInternal();
+			},
+			get ignore() {
+				return context.isIgnored();
+			},
+			get hidden() {
+				return context.isHidden();
+			}
+		}), createComponent(Show, {
+			get when() {
+				return memo(() => !!Boolean(children))() && childrenArray(() => children).length > 0;
+			},
+			get children() {
+				return createComponent(List, { get children() {
+					return childrenArray(() => children);
+				} });
+			}
+		})];
+	} }));
+}
+
+//#endregion
+//#region ../plugin-alloy/src/typescript/components/typescript-interface.tsx
+/**
+* Generates a TypeScript interface for the given reflection class.
+*/
+function TypeScriptInterface(props) {
+	const [{ name, reflection }, rest] = splitProps(props, ["name", "reflection"]);
+	const interfaceName = computed(() => pascalCase((isString(name) ? name : name.toString()) || reflection.getName()));
+	const properties = reflection.getProperties().filter((item) => !item.isIgnored()).sort((a, b) => a.isReadonly() && b.isReadonly() || !a.isReadonly() && !b.isReadonly() ? a.getNameAsString().localeCompare(b.getNameAsString()) : a.isReadonly() ? 1 : -1);
+	return createComponent(ReflectionClassContext.Provider, {
+		value: { reflection },
+		get children() {
+			return [createComponent(TSDocReflectionClass, {}), createComponent(InterfaceDeclaration, mergeProps({
+				"export": true,
+				get name() {
+					return interfaceName.value;
+				}
+			}, rest, { get children() {
+				return createComponent(For, {
+					each: properties,
+					doubleHardline: true,
+					semicolon: true,
+					children: (prop) => createComponent(TypescriptInterfaceProperty, { property: prop })
+				});
+			} }))];
+		}
+	});
+}
+/**
+* Generates a TypeScript interface property for the given reflection class.
+*/
+function TypescriptInterfaceProperty(props) {
+	const [{ property }, rest] = splitProps(props, ["property"]);
+	return createComponent(ReflectionPropertyContext.Provider, {
+		value: property,
+		get children() {
+			return [createComponent(TSDocReflectionProperty, {}), createComponent(InterfaceMember, mergeProps({
+				get name() {
+					return property.getNameAsString();
+				},
+				get readonly() {
+					return property.isReadonly();
+				},
+				get optional() {
+					return property.isOptional();
+				},
+				get nullish() {
+					return property.isNullable();
+				},
+				get type() {
+					return stringifyType(property.getType());
+				}
+			}, rest))];
+		}
+	});
+}
+
+//#endregion
+//#region ../plugin-alloy/src/typescript/components/typescript-object.tsx
+/**
+* Generates a TypeScript object for the given reflection class.
+*/
+function TypescriptObject(props) {
+	if (!props.reflection?.value) return null;
+	const objectName = computed(() => camelCase((isString(props.name) ? props.name : props.name.toString()) || props.reflection.value.getName()));
+	const objectType = computed(() => props.type || pascalCase(props.reflection.value.getName()));
+	const properties = computed(() => props.reflection.value.getProperties().filter((item) => !item.isIgnored() && !isUndefined(props.defaultValue?.value?.[item.getNameAsString()] ?? item.getAlias().reduce((ret, alias) => {
+		if (isUndefined(ret) && !isUndefined(props.defaultValue?.value?.[alias])) return props.defaultValue?.value?.[alias];
+		return ret;
+	}, void 0) ?? item.getDefaultValue())).sort((a, b) => a.isReadonly() && b.isReadonly() || !a.isReadonly() && !b.isReadonly() ? a.getNameAsString().localeCompare(b.getNameAsString()) : a.isReadonly() ? 1 : -1));
+	const TypeSymbolSlot = createSymbolSlot();
+	const ValueTypeSymbolSlot = createSymbolSlot();
+	const sym = createValueSymbol(props.name, {
+		refkeys: props.refkey,
+		default: props.default,
+		export: props.export,
+		metadata: props.metadata,
+		tsFlags: props.nullish ? TSSymbolFlags.Nullish : TSSymbolFlags.None,
+		type: props.type ? TypeSymbolSlot.firstSymbol : void 0,
+		namePolicy: useTSNamePolicy().for("variable")
+	});
+	if (!props.type) ValueTypeSymbolSlot.moveMembersTo(sym);
+	const keyword = props.var ? "var" : props.let ? "let" : "const";
+	const type = props.type ? createComponent(TypeRefContext, { get children() {
+		return [": ", createComponent(TypeSymbolSlot, { get children() {
+			return props.type;
+		} })];
+	} }) : void 0;
+	return createComponent(Show, {
+		get when() {
+			return !!props.reflection.value;
+		},
+		get children() {
+			return createComponent(ReflectionClassContext.Provider, {
+				get value() {
+					return {
+						reflection: props.reflection.value,
+						override: {
+							name: objectName.value,
+							type: objectType.value,
+							defaultValue: props.defaultValue?.value
+						}
+					};
+				},
+				get children() {
+					return [createComponent(Show, {
+						get when() {
+							return !!objectName.value && !!objectType.value;
+						},
+						get children() {
+							return [createComponent(TSDocReflectionClass, {}), createComponent(Declaration, {
+								symbol: sym,
+								get children() {
+									return [
+										memo(() => props.export ? "export " : ""),
+										memo(() => props.default ? "default " : ""),
+										keyword,
+										" ",
+										createComponent(Name, {}),
+										type,
+										" =",
+										" ",
+										createComponent(ValueTypeSymbolSlot, { get children() {
+											return props.initializer ?? props.children ?? createComponent(ObjectExpression, { get children() {
+												return createComponent(For, {
+													get each() {
+														return properties.value ?? [];
+													},
+													comma: true,
+													doubleHardline: true,
+													children: (prop) => createComponent(TypescriptObjectProperty, { property: prop })
+												});
+											} });
+										} })
+									];
+								}
+							})];
+						}
+					}), createIntrinsic("hbr", {})];
+				}
+			});
+		}
+	});
+}
+/**
+* Generates a TypeScript object property for the given reflection class.
+*/
+function TypescriptObjectProperty(props) {
+	const [{ property }] = splitProps(props, ["property"]);
+	return createComponent(ReflectionPropertyContext.Provider, {
+		value: property,
+		get children() {
+			return [
+				createComponent(TSDocReflectionProperty, {}),
+				createComponent(ObjectProperty, {
+					get name() {
+						return property.getNameAsString();
+					},
+					get value() {
+						return stringifyDefaultValue(property);
+					}
+				}),
+				createIntrinsic("hbr", {})
+			];
+		}
+	});
+}
+
+//#endregion
+//#region src/components/env.tsx
+/**
+* Generates the environment configuration typescript definition for the Powerlines project.
+*/
+function EnvTypeDefinition(props) {
+	const [{ defaultValue, reflection }] = splitProps(props, ["defaultValue", "reflection"]);
+	const context = usePowerlines();
+	return [
+		createComponent(TypeScriptInterface, {
+			name: " EnvBase",
+			"extends": ["EnvInterface"],
+			defaultValue,
+			reflection,
+			"export": true
+		}),
+		createIntrinsic("hbr", {}),
+		createIntrinsic("hbr", {}),
+		createComponent(TypeDeclaration, {
+			name: "Env",
+			"export": true,
+			get children() {
+				return 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 }] = splitProps(props, ["context", "name"]);
+	if (!context) return null;
+	return 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 }] = splitProps(props, [
+		"context",
+		"property",
+		"index"
+	]);
+	if (!context) return null;
+	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()}"];`;
+		}
+	})];
+}
+function ConfigPropertySet(props) {
+	const [{ context, property, index }] = splitProps(props, [
+		"context",
+		"property",
+		"index"
+	]);
+	if (!context) return null;
+	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`
+    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`
+    target["${property.getNameAsString()}"] = newValue;
+    return true;
+`;
+		}
+	})];
+}
+const createEnvRefkey = refkey$1("createEnv");
+const envRefkey = refkey$1("env");
+const envSerializerRefkey = refkey$1("EnvSerializer");
+/**
+* Generates the environment configuration module for the Powerlines project.
+*/
+function EnvBuiltin(props) {
+	const [{ defaultConfig, children }, rest] = splitProps(props, ["defaultConfig", "children"]);
+	const context = usePowerlines();
+	const defaultValue = computed(() => context && loadEnvFromContext(context, process.env));
+	const reflection = createReflectionResource(context);
+	const envInstance = computed(() => {
+		return new ReflectionClass({
+			kind: ReflectionKind.objectLiteral,
+			description: `The initial environment configuration state for the ${titleCase(context?.config?.name)} project.`,
+			types: []
+		}, reflection.data ?? void 0);
+	});
+	const reflectionGetProperties = computed(() => reflection.data?.getProperties().filter((property) => !property.isIgnored()).sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())) ?? []);
+	const reflectionSetProperties = computed(() => reflection.data?.getProperties().filter((property) => !property.isIgnored() && !property.isReadonly()).sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())) ?? []);
+	return createComponent(BuiltinFile, mergeProps({
+		id: "env",
+		description: "The Powerlines environment configuration module provides an interface to define environment configuration parameters."
+	}, rest, {
+		get imports() {
+			return defu({
+				"@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 [
+				createComponent(Show, {
+					get when() {
+						return !isNull(reflection.data);
+					},
+					get children() {
+						return [
+							createComponent(EnvTypeDefinition, {
+								get defaultValue() {
+									return defaultValue.value;
+								},
+								get reflection() {
+									return reflection.data;
+								}
+							}),
+							createIntrinsic("hbr", {}),
+							createIntrinsic("hbr", {})
+						];
+					}
+				}),
+				createComponent(TypescriptObject, {
+					name: "initialEnv",
+					type: "Partial<EnvBase>",
+					defaultValue,
+					reflection: envInstance,
+					"export": true,
+					"const": true
+				}),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				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,
+							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()}\`
+        );
+      }
+    );
+`
+						});
+					}
+				}),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				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"
+						});
+					}
+				}),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				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)"
+				}),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				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)"
+				}),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				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,
+      ...environmentConfig
+    }) as Env,
+    {
+      get: (target: EnvBase, propertyName: string) => { `,
+									createIntrinsic("hbr", {}),
+									createComponent(For, {
+										each: reflectionGetProperties,
+										children: (property, index) => createComponent(ConfigPropertyGet, {
+											index,
+											context,
+											property
+										})
+									}),
+									code`
+            return undefined;
+          }, `,
+									createIntrinsic("hbr", {}),
+									createIntrinsic("hbr", {}),
+									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;
+      }
+    }
+  );
+`
+								];
+							}
+						});
+					}
+				}),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				createComponent(VarDeclaration, {
+					refkey: envRefkey,
+					name: "env",
+					type: "Env",
+					"export": true,
+					"const": true,
+					get initializer() {
+						return [code`createEnv(${defaultConfig || "{}"} as Partial<Env>);`];
+					}
+				}),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				createComponent(VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "isCI",
+					doc: "Detect if the application is running in a CI environment.",
+					initializer: 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
+        );
+        `
+				}),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				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, Storm Software generally only allows a value in the following list:
+- \`production\`
+- \`test\`
+- \`development\`` });
+					}
+				}),
+				createComponent(VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "mode",
+					initializer: code`String(env.MODE) || "production"; `
+				}),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				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()); `
+				}),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				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; `
+				}),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				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()); `
+				}),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				createComponent(VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "isDebug",
+					doc: "Detect if the application is running in \"debug\" mode",
+					initializer: code`Boolean(isDevelopment && env.DEBUG); `
+				}),
+				createIntrinsic("hbr", {}),
+				createIntrinsic("hbr", {}),
+				createComponent(Show, {
+					get when() {
+						return Boolean(children);
+					},
+					children
+				})
+			];
+		}
+	}));
+}
+
+//#endregion
+export { EnvTypeDefinition as n, stringifyDefaultValue as r, EnvBuiltin as t };