@powerlines/plugin-env 0.15.4 → 0.15.6

package/dist/deepkit/src/utilities.cjs

@@ -0,0 +1,182 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __stryke_json_storm_json = require("@stryke/json/storm-json");
+let __stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
+let __stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
+let __stryke_type_checks_is_null = require("@stryke/type-checks/is-null");
+let __stryke_type_checks_is_undefined = require("@stryke/type-checks/is-undefined");
+
+//#region ../deepkit/src/utilities.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+/**
+* 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());
+}
+stringifyDefaultValue.__type = [
+	() => __powerlines_deepkit_vendor_type.ReflectionProperty,
+	() => __powerlines_deepkit_vendor_type.ReflectionParameter,
+	"property",
+	"value",
+	"stringifyDefaultValue",
+	"Converts any {@link ReflectionProperty} or {@link ReflectionParameter}'s value to string representation.",
+	"PPP7!P7\"J2#\"2$8&/%?&"
+];
+/**
+* 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("\"", "\\\"")}"`;
+}
+stringifyStringValue.__type = [
+	"value",
+	"stringifyStringValue",
+	"Stringifies a value as a string.",
+	"P\"2!8&/\"?#"
+];
+/**
+* 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 (0, __stryke_type_checks_is_undefined.isUndefined)(value) ? "undefined" : (0, __stryke_type_checks_is_null.isNull)(value) ? "null" : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? String(value).trim().toLowerCase() === "true" ? "true" : "false" : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.literal && (0, __stryke_type_checks_is_string.isString)(type.literal) ? stringifyStringValue(value) : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.enum ? getEnumReflectionType(type).kind === __powerlines_deepkit_vendor_type.ReflectionKind.string ? stringifyStringValue(value) : `${String(value)}` : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.union ? isStringUnion(type) ? stringifyStringValue(value) : `${String(value)}` : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array ? stringifyStringValue(__stryke_json_storm_json.StormJSON.stringify(value)) : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.object || type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral ? __stryke_json_storm_json.StormJSON.stringify(value) : type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.property || type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.parameter ? stringifyValue(type.type, value) : String(value);
+}
+stringifyValue.__type = [
+	"Type",
+	"type",
+	"value",
+	"stringifyValue",
+	"Converts any {@link Type}'s actual value to string representation.",
+	"P\"w!2\"\"2#&/$?%"
+];
+/**
+* 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 !== __powerlines_deepkit_vendor_type.ReflectionKind.enum) throw new Error(`Expected a TypeEnum, but received ${type.kind}.`);
+	const unique = (0, __stryke_helpers_get_unique.getUniqueBy)(type.values.filter(__assignType((value) => value !== void 0 && value !== null, [
+		"value",
+		"",
+		"P\"2!\"/\""
+	])), __assignType((enumMember) => (0, __stryke_type_checks_is_string.isString)(enumMember) ? { kind: __powerlines_deepkit_vendor_type.ReflectionKind.string } : { kind: __powerlines_deepkit_vendor_type.ReflectionKind.number }, [
+		"enumMember",
+		"",
+		"P\"2!\"/\""
+	]));
+	if (unique.length === 0) throw new Error(`No valid enum members could be found.`);
+	return unique[0] && (0, __stryke_type_checks_is_string.isString)(unique[0]) ? { kind: __powerlines_deepkit_vendor_type.ReflectionKind.string } : { kind: __powerlines_deepkit_vendor_type.ReflectionKind.number };
+}
+getEnumReflectionType.__type = [
+	"Type",
+	"type",
+	() => __powerlines_deepkit_vendor_type.__ΩTypeString,
+	() => __powerlines_deepkit_vendor_type.__ΩTypeNumber,
+	"getEnumReflectionType",
+	"Converts a {@link TypeEnum} to its underlying primitive type representation.",
+	"P\"w!2\"Pn#n$J/%?&"
+];
+/**
+* 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 === __powerlines_deepkit_vendor_type.ReflectionKind.union && type.types.length > 0) return (0, __stryke_helpers_get_unique.getUniqueBy)(type.types, __assignType((member) => member.kind, [
+		"member",
+		"",
+		"P\"2!\"/\""
+	]));
+	throw new Error(`Expected a TypeUnion, but received ${type.kind}.`);
+}
+getUnionTypes.__type = [
+	"Type",
+	"type",
+	"getUnionTypes",
+	"Converts a {@link TypeUnion} to its underlying primitive type representation.",
+	"P\"w!2\"\"w!F/#?$"
+];
+function isStringUnion(type) {
+	return getUnionTypes(type).some(__assignType((member) => member.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || member.kind === __powerlines_deepkit_vendor_type.ReflectionKind.literal && (0, __stryke_type_checks_is_string.isString)(member.literal), [
+		"member",
+		"",
+		"P\"2!\"/\""
+	]));
+}
+isStringUnion.__type = [
+	"Type",
+	"type",
+	"isStringUnion",
+	"P\"w!2\")/#"
+];
+/**
+* Converts a ReflectionKind to its string representation.
+*
+* @param kind - The {@link ReflectionKind} to convert.
+* @returns A string representation of the kind.
+*/
+function kindToName(kind) {
+	if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.void) return "void";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.never) return "never";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.null) return "null";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.undefined) return "undefined";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.symbol) return "symbol";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.bigint) return "bigint";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.number) return "number";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.string) return "string";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean) return "boolean";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.literal) return "literal";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.class) return "class";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.array) return "array";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.object) return "object";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral) return "objectLiteral";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.union) return "union";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.enum) return "enum";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.regexp) return "regexp";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.templateLiteral) return "templateLiteral";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.property) return "property";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.method) return "method";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.function) return "function";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.parameter) return "parameter";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.promise) return "promise";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.typeParameter) return "typeParameter";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.tuple) return "tuple";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.tupleMember) return "tupleMember";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.enumMember) return "enumMember";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.rest) return "rest";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.indexSignature) return "indexSignature";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.propertySignature) return "propertySignature";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.methodSignature) return "methodSignature";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.infer) return "infer";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.callSignature) return "callSignature";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.any) return "any";
+	else if (kind === __powerlines_deepkit_vendor_type.ReflectionKind.intersection) return "intersection";
+	return "unknown";
+}
+kindToName.__type = [
+	() => __powerlines_deepkit_vendor_type.__ΩReflectionKind,
+	"kind",
+	"kindToName",
+	"Converts a ReflectionKind to its string representation.",
+	"Pn!2\"&/#?$"
+];
+
+//#endregion
+exports.stringifyDefaultValue = stringifyDefaultValue;

package/dist/deepkit/src/utilities.mjs

@@ -0,0 +1,181 @@
+import { ReflectionKind, ReflectionParameter, ReflectionProperty, __ΩReflectionKind, __ΩTypeNumber, __ΩTypeString } from "@powerlines/deepkit/vendor/type";
+import { StormJSON } from "@stryke/json/storm-json";
+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";
+
+//#region ../deepkit/src/utilities.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+/**
+* 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());
+}
+stringifyDefaultValue.__type = [
+	() => ReflectionProperty,
+	() => ReflectionParameter,
+	"property",
+	"value",
+	"stringifyDefaultValue",
+	"Converts any {@link ReflectionProperty} or {@link ReflectionParameter}'s value to string representation.",
+	"PPP7!P7\"J2#\"2$8&/%?&"
+];
+/**
+* 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("\"", "\\\"")}"`;
+}
+stringifyStringValue.__type = [
+	"value",
+	"stringifyStringValue",
+	"Stringifies a value as a string.",
+	"P\"2!8&/\"?#"
+];
+/**
+* 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);
+}
+stringifyValue.__type = [
+	"Type",
+	"type",
+	"value",
+	"stringifyValue",
+	"Converts any {@link Type}'s actual value to string representation.",
+	"P\"w!2\"\"2#&/$?%"
+];
+/**
+* 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(__assignType((value) => value !== void 0 && value !== null, [
+		"value",
+		"",
+		"P\"2!\"/\""
+	])), __assignType((enumMember) => isString(enumMember) ? { kind: ReflectionKind.string } : { kind: ReflectionKind.number }, [
+		"enumMember",
+		"",
+		"P\"2!\"/\""
+	]));
+	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 };
+}
+getEnumReflectionType.__type = [
+	"Type",
+	"type",
+	() => __ΩTypeString,
+	() => __ΩTypeNumber,
+	"getEnumReflectionType",
+	"Converts a {@link TypeEnum} to its underlying primitive type representation.",
+	"P\"w!2\"Pn#n$J/%?&"
+];
+/**
+* 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, __assignType((member) => member.kind, [
+		"member",
+		"",
+		"P\"2!\"/\""
+	]));
+	throw new Error(`Expected a TypeUnion, but received ${type.kind}.`);
+}
+getUnionTypes.__type = [
+	"Type",
+	"type",
+	"getUnionTypes",
+	"Converts a {@link TypeUnion} to its underlying primitive type representation.",
+	"P\"w!2\"\"w!F/#?$"
+];
+function isStringUnion(type) {
+	return getUnionTypes(type).some(__assignType((member) => member.kind === ReflectionKind.string || member.kind === ReflectionKind.literal && isString(member.literal), [
+		"member",
+		"",
+		"P\"2!\"/\""
+	]));
+}
+isStringUnion.__type = [
+	"Type",
+	"type",
+	"isStringUnion",
+	"P\"w!2\")/#"
+];
+/**
+* Converts a ReflectionKind to its string representation.
+*
+* @param kind - The {@link ReflectionKind} to convert.
+* @returns A string representation of the kind.
+*/
+function kindToName(kind) {
+	if (kind === ReflectionKind.void) return "void";
+	else if (kind === ReflectionKind.never) return "never";
+	else if (kind === ReflectionKind.null) return "null";
+	else if (kind === ReflectionKind.undefined) return "undefined";
+	else if (kind === ReflectionKind.symbol) return "symbol";
+	else if (kind === ReflectionKind.bigint) return "bigint";
+	else if (kind === ReflectionKind.number) return "number";
+	else if (kind === ReflectionKind.string) return "string";
+	else if (kind === ReflectionKind.boolean) return "boolean";
+	else if (kind === ReflectionKind.literal) return "literal";
+	else if (kind === ReflectionKind.class) return "class";
+	else if (kind === ReflectionKind.array) return "array";
+	else if (kind === ReflectionKind.object) return "object";
+	else if (kind === ReflectionKind.objectLiteral) return "objectLiteral";
+	else if (kind === ReflectionKind.union) return "union";
+	else if (kind === ReflectionKind.enum) return "enum";
+	else if (kind === ReflectionKind.regexp) return "regexp";
+	else if (kind === ReflectionKind.templateLiteral) return "templateLiteral";
+	else if (kind === ReflectionKind.property) return "property";
+	else if (kind === ReflectionKind.method) return "method";
+	else if (kind === ReflectionKind.function) return "function";
+	else if (kind === ReflectionKind.parameter) return "parameter";
+	else if (kind === ReflectionKind.promise) return "promise";
+	else if (kind === ReflectionKind.typeParameter) return "typeParameter";
+	else if (kind === ReflectionKind.tuple) return "tuple";
+	else if (kind === ReflectionKind.tupleMember) return "tupleMember";
+	else if (kind === ReflectionKind.enumMember) return "enumMember";
+	else if (kind === ReflectionKind.rest) return "rest";
+	else if (kind === ReflectionKind.indexSignature) return "indexSignature";
+	else if (kind === ReflectionKind.propertySignature) return "propertySignature";
+	else if (kind === ReflectionKind.methodSignature) return "methodSignature";
+	else if (kind === ReflectionKind.infer) return "infer";
+	else if (kind === ReflectionKind.callSignature) return "callSignature";
+	else if (kind === ReflectionKind.any) return "any";
+	else if (kind === ReflectionKind.intersection) return "intersection";
+	return "unknown";
+}
+kindToName.__type = [
+	() => __ΩReflectionKind,
+	"kind",
+	"kindToName",
+	"Converts a ReflectionKind to its string representation.",
+	"Pn!2\"&/#?$"
+];
+
+//#endregion
+export { stringifyDefaultValue };

package/dist/helpers/automd-generator.cjs

@@ -0,0 +1,32 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_context = require('../powerlines/src/types/context.cjs');
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
+let automd = require("automd");
+
+//#region src/helpers/automd-generator.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+/**
+* AutoMD generator to generate environment variable documentation
+*
+* @param context - The generator context.
+* @returns The generated documentation content.
+*/
+const env = __assignType((context) => (0, automd.defineGenerator)({
+	name: "env",
+	generate: __assignType(async function generate() {
+		const envDocFile = (0, __stryke_path_join_paths.joinPaths)(context.config.projectRoot, "docs", "generated", "env.md");
+		if (!context.fs.existsSync(envDocFile)) return { contents: "" };
+		return { contents: await context.fs.read(envDocFile) || "" };
+	}, ["generate", "P\"/!"])
+}), [
+	() => require_context.__ΩUnresolvedContext,
+	"context",
+	"",
+	"Pn!2\"\"/#"
+]);
+
+//#endregion
+exports.env = env;

package/dist/helpers/automd-generator.mjs

@@ -0,0 +1,31 @@
+import { __ΩUnresolvedContext } from "../powerlines/src/types/context.mjs";
+import { joinPaths } from "@stryke/path/join-paths";
+import { defineGenerator } from "automd";
+
+//#region src/helpers/automd-generator.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+/**
+* AutoMD generator to generate environment variable documentation
+*
+* @param context - The generator context.
+* @returns The generated documentation content.
+*/
+const env = __assignType((context) => defineGenerator({
+	name: "env",
+	generate: __assignType(async function generate() {
+		const envDocFile = joinPaths(context.config.projectRoot, "docs", "generated", "env.md");
+		if (!context.fs.existsSync(envDocFile)) return { contents: "" };
+		return { contents: await context.fs.read(envDocFile) || "" };
+	}, ["generate", "P\"/!"])
+}), [
+	() => __ΩUnresolvedContext,
+	"context",
+	"",
+	"Pn!2\"\"/#"
+]);
+
+//#endregion
+export { env };

package/dist/helpers/create-reflection-resource.cjs

@@ -0,0 +1,98 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_types_plugin = require('../types/plugin.cjs');
+const require_persistence = require('./persistence.cjs');
+const require_load = require('./load.cjs');
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __alloy_js_core = require("@alloy-js/core");
+let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
+
+//#region src/helpers/create-reflection-resource.ts
+const __ΩRecord = [
+	"K",
+	"T",
+	"Record",
+	"l'e#\"Rb!b\"Pde\"!N#!w#y"
+];
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+/**
+* Creates a reflection resource for the environment configuration.
+*
+* @param context - The environment plugin context.
+* @returns A resource that provides the reflection of the environment configuration.
+*/
+function createReflectionResource(context) {
+	const defaultValue = (0, __alloy_js_core.computed)(() => context && require_load.loadEnvFromContext(context, process.env));
+	return __alloy_js_core.createResource.Ω = [[
+		() => __ΩRecord,
+		() => __powerlines_deepkit_vendor_type.ReflectionClass,
+		"P&\"o!#7\""
+	]], (0, __alloy_js_core.createResource)(async () => {
+		if (!context) return new __powerlines_deepkit_vendor_type.ReflectionClass({
+			kind: __powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral,
+			description: `The initial environment configuration state for the Powerlines project.`,
+			types: []
+		});
+		const result = await require_persistence.readEnvTypeReflection(context, "env");
+		result.getProperties().forEach(__assignType((prop) => {
+			prop.getAlias().filter(Boolean).forEach(__assignType((alias) => {
+				result.addProperty({
+					name: alias,
+					optional: prop.isOptional() ? true : void 0,
+					readonly: prop.isReadonly() ? true : void 0,
+					description: prop.getDescription(),
+					visibility: prop.getVisibility(),
+					type: prop.getType(),
+					default: prop.getDefaultValue(),
+					tags: {
+						hidden: prop.isHidden(),
+						ignore: prop.isIgnored(),
+						internal: prop.isInternal(),
+						alias: prop.getAlias().filter(__assignType((a) => a !== alias, [
+							"a",
+							"",
+							"P\"2!\"/\""
+						])).concat(prop.name),
+						title: prop.getTitle() || (0, __stryke_string_format_title_case.titleCase)(prop.name),
+						readonly: prop.isReadonly(),
+						permission: prop.getPermission(),
+						domain: prop.getDomain()
+					}
+				});
+			}, [
+				"alias",
+				"",
+				"P\"2!\"/\""
+			]));
+		}, [
+			"prop",
+			"",
+			"P\"2!\"/\""
+		]));
+		result.getProperties().forEach(__assignType((prop) => {
+			prop.setDefaultValue(defaultValue.value?.[prop.getNameAsString()] ?? prop.getAlias().reduce(__assignType((ret, alias) => ret ?? defaultValue.value?.[alias], [
+				"ret",
+				"alias",
+				"",
+				"P\"2!\"2\"\"/#"
+			]), void 0) ?? prop.getDefaultValue());
+		}, [
+			"prop",
+			"",
+			"P\"2!\"/\""
+		]));
+		return result;
+	});
+}
+createReflectionResource.__type = [
+	() => require_types_plugin.__ΩEnvPluginContext,
+	"context",
+	"createReflectionResource",
+	"Creates a reflection resource for the environment configuration.",
+	"Pn!2\"8\"/#?$"
+];
+
+//#endregion
+exports.createReflectionResource = createReflectionResource;

package/dist/helpers/create-reflection-resource.d.cts

@@ -0,0 +1,15 @@
+import { EnvPluginContext } from "../types/plugin.cjs";
+import * as _alloy_js_core3 from "@alloy-js/core";
+import { ReflectionClass } from "@powerlines/deepkit/vendor/type";
+
+//#region src/helpers/create-reflection-resource.d.ts
+
+/**
+ * Creates a reflection resource for the environment configuration.
+ *
+ * @param context - The environment plugin context.
+ * @returns A resource that provides the reflection of the environment configuration.
+ */
+declare function createReflectionResource(context?: EnvPluginContext): _alloy_js_core3.Resource<ReflectionClass<Record<string, any>>>;
+//#endregion
+export { createReflectionResource };

package/dist/helpers/create-reflection-resource.d.mts

@@ -0,0 +1,15 @@
+import { EnvPluginContext } from "../types/plugin.mjs";
+import { ReflectionClass } from "@powerlines/deepkit/vendor/type";
+import * as _alloy_js_core4 from "@alloy-js/core";
+
+//#region src/helpers/create-reflection-resource.d.ts
+
+/**
+ * Creates a reflection resource for the environment configuration.
+ *
+ * @param context - The environment plugin context.
+ * @returns A resource that provides the reflection of the environment configuration.
+ */
+declare function createReflectionResource(context?: EnvPluginContext): _alloy_js_core4.Resource<ReflectionClass<Record<string, any>>>;
+//#endregion
+export { createReflectionResource };

package/dist/helpers/create-reflection-resource.mjs

@@ -0,0 +1,97 @@
+import { __ΩEnvPluginContext } from "../types/plugin.mjs";
+import { readEnvTypeReflection } from "./persistence.mjs";
+import { loadEnvFromContext } from "./load.mjs";
+import { ReflectionClass, ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { computed, createResource } from "@alloy-js/core";
+import { titleCase } from "@stryke/string-format/title-case";
+
+//#region src/helpers/create-reflection-resource.ts
+const __ΩRecord = [
+	"K",
+	"T",
+	"Record",
+	"l'e#\"Rb!b\"Pde\"!N#!w#y"
+];
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+/**
+* Creates a reflection resource for the environment configuration.
+*
+* @param context - The environment plugin context.
+* @returns A resource that provides the reflection of the environment configuration.
+*/
+function createReflectionResource(context) {
+	const defaultValue = computed(() => context && loadEnvFromContext(context, process.env));
+	return createResource.Ω = [[
+		() => __ΩRecord,
+		() => ReflectionClass,
+		"P&\"o!#7\""
+	]], createResource(async () => {
+		if (!context) return new ReflectionClass({
+			kind: ReflectionKind.objectLiteral,
+			description: `The initial environment configuration state for the Powerlines project.`,
+			types: []
+		});
+		const result = await readEnvTypeReflection(context, "env");
+		result.getProperties().forEach(__assignType((prop) => {
+			prop.getAlias().filter(Boolean).forEach(__assignType((alias) => {
+				result.addProperty({
+					name: alias,
+					optional: prop.isOptional() ? true : void 0,
+					readonly: prop.isReadonly() ? true : void 0,
+					description: prop.getDescription(),
+					visibility: prop.getVisibility(),
+					type: prop.getType(),
+					default: prop.getDefaultValue(),
+					tags: {
+						hidden: prop.isHidden(),
+						ignore: prop.isIgnored(),
+						internal: prop.isInternal(),
+						alias: prop.getAlias().filter(__assignType((a) => a !== alias, [
+							"a",
+							"",
+							"P\"2!\"/\""
+						])).concat(prop.name),
+						title: prop.getTitle() || titleCase(prop.name),
+						readonly: prop.isReadonly(),
+						permission: prop.getPermission(),
+						domain: prop.getDomain()
+					}
+				});
+			}, [
+				"alias",
+				"",
+				"P\"2!\"/\""
+			]));
+		}, [
+			"prop",
+			"",
+			"P\"2!\"/\""
+		]));
+		result.getProperties().forEach(__assignType((prop) => {
+			prop.setDefaultValue(defaultValue.value?.[prop.getNameAsString()] ?? prop.getAlias().reduce(__assignType((ret, alias) => ret ?? defaultValue.value?.[alias], [
+				"ret",
+				"alias",
+				"",
+				"P\"2!\"2\"\"/#"
+			]), void 0) ?? prop.getDefaultValue());
+		}, [
+			"prop",
+			"",
+			"P\"2!\"/\""
+		]));
+		return result;
+	});
+}
+createReflectionResource.__type = [
+	() => __ΩEnvPluginContext,
+	"context",
+	"createReflectionResource",
+	"Creates a reflection resource for the environment configuration.",
+	"Pn!2\"8\"/#?$"
+];
+
+//#endregion
+export { createReflectionResource };

package/dist/helpers/index.cjs

@@ -0,0 +1,6 @@
+const require_reflect = require('./reflect.cjs');
+const require_persistence = require('./persistence.cjs');
+const require_source_file_env = require('./source-file-env.cjs');
+const require_load = require('./load.cjs');
+const require_create_reflection_resource = require('./create-reflection-resource.cjs');
+const require_template_helpers = require('./template-helpers.cjs');

package/dist/helpers/index.d.cts

@@ -0,0 +1,6 @@
+import { createReflectionResource } from "./create-reflection-resource.cjs";
+import { loadEnv, loadEnvFromContext } from "./load.cjs";
+import { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection } from "./persistence.cjs";
+import { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, __ΩCreateEnvReflectionOptions, createEnvReflection, createSecretsReflection, mergeEnvReflections, mergeSecretsReflections, reflectEnv, reflectSecrets } from "./reflect.cjs";
+import { formatEnvField, removeEnvPrefix } from "./source-file-env.cjs";
+import { createTemplateReflection } from "./template-helpers.cjs";