@powerlines/plugin-env 0.14.26 → 0.14.27

package/dist/components/docs.cjs

@@ -1,23 +1,23 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 const require_type = require('../deepkit/src/vendor/type.cjs');
+const require_context = require('../plugin-alloy/src/core/contexts/context.cjs');
 const require_create_reflection_resource = require('../helpers/create-reflection-resource.cjs');
+const require_markdown_file = require('../plugin-alloy/src/markdown/components/markdown-file.cjs');
+const require_markdown_table = require('../plugin-alloy/src/markdown/components/markdown-table.cjs');
 let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let __alloy_js_core = require("@alloy-js/core");
 let __stryke_path_join = require("@stryke/path/join");
-let __powerlines_alloy_core_contexts_context = require("@powerlines/alloy/core/contexts/context");
 let __alloy_js_markdown = require("@alloy-js/markdown");
-let __powerlines_alloy_markdown_components_markdown_file = require("@powerlines/alloy/markdown/components/markdown-file");
-let __powerlines_alloy_markdown_components_markdown_table = require("@powerlines/alloy/markdown/components/markdown-table");
 
 //#region src/components/docs.tsx
 /**
 * Generates the environment configuration markdown documentation for the Powerlines project.
 */
 function EnvDocs() {
-	const context = (0, __powerlines_alloy_core_contexts_context.usePowerlines)();
+	const context = require_context.usePowerlines();
 	if (!context) return null;
 	const reflection = require_create_reflection_resource.createReflectionResource(context);
-	return (0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_markdown_components_markdown_file.MarkdownFile, {
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(require_markdown_file.MarkdownFile, {
 		get path() {
 			return (0, __stryke_path_join.joinPaths)(context.config.projectRoot, "docs", "generated", "env.md");
 		},
@@ -51,7 +51,7 @@ function EnvDocs() {
 				}),
 				__alloy_js_core.code`The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.`,
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_markdown_components_markdown_table.MarkdownTable, { get data() {
+				(0, __alloy_js_core_jsx_runtime.createComponent)(require_markdown_table.MarkdownTable, { get data() {
 					return reflection.data?.getProperties().filter((property) => property.getNameAsString() !== "__STORM_INJECTED__").sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())).map((reflectionProperty) => {
 						return {
 							name: reflectionProperty.getNameAsString().trim(),

package/dist/components/docs.mjs

@@ -1,12 +1,12 @@
 import { type_exports } from "../deepkit/src/vendor/type.mjs";
+import { usePowerlines } from "../plugin-alloy/src/core/contexts/context.mjs";
 import { createReflectionResource } from "../helpers/create-reflection-resource.mjs";
+import { MarkdownFile } from "../plugin-alloy/src/markdown/components/markdown-file.mjs";
+import { MarkdownTable } from "../plugin-alloy/src/markdown/components/markdown-table.mjs";
 import { createComponent, createIntrinsic } from "@alloy-js/core/jsx-runtime";
 import { Show, code } from "@alloy-js/core";
 import { joinPaths } from "@stryke/path/join";
-import { usePowerlines } from "@powerlines/alloy/core/contexts/context";
 import { Heading, Link } from "@alloy-js/markdown";
-import { MarkdownFile } from "@powerlines/alloy/markdown/components/markdown-file";
-import { MarkdownTable } from "@powerlines/alloy/markdown/components/markdown-table";
 
 //#region src/components/docs.tsx
 /**

package/dist/components/env.cjs

@@ -1,5 +1,11 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 const require_type = require('../deepkit/src/vendor/type.cjs');
+const require_context = require('../plugin-alloy/src/core/contexts/context.cjs');
+const require_refkey = require('../plugin-alloy/src/helpers/refkey.cjs');
+const require_tsdoc = require('../plugin-alloy/src/typescript/components/tsdoc.cjs');
+const require_builtin_file = require('../plugin-alloy/src/typescript/components/builtin-file.cjs');
+const require_typescript_interface = require('../plugin-alloy/src/typescript/components/typescript-interface.cjs');
+const require_typescript_object = require('../plugin-alloy/src/typescript/components/typescript-object.cjs');
 const require_load = require('../helpers/load.cjs');
 const require_create_reflection_resource = require('../helpers/create-reflection-resource.cjs');
 let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
@@ -9,12 +15,6 @@ defu = require_rolldown_runtime.__toESM(defu);
 let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
 let __stryke_type_checks_is_null = require("@stryke/type-checks/is-null");
 let __alloy_js_typescript = require("@alloy-js/typescript");
-let __powerlines_alloy_core_contexts_context = require("@powerlines/alloy/core/contexts/context");
-let __powerlines_alloy_helpers_refkey = require("@powerlines/alloy/helpers/refkey");
-let __powerlines_alloy_typescript_components_builtin_file = require("@powerlines/alloy/typescript/components/builtin-file");
-let __powerlines_alloy_typescript_components_tsdoc = require("@powerlines/alloy/typescript/components/tsdoc");
-let __powerlines_alloy_typescript_components_typescript_interface = require("@powerlines/alloy/typescript/components/typescript-interface");
-let __powerlines_alloy_typescript_components_typescript_object = require("@powerlines/alloy/typescript/components/typescript-object");
 
 //#region src/components/env.tsx
 /**
@@ -22,9 +22,9 @@ let __powerlines_alloy_typescript_components_typescript_object = require("@power
 */
 function EnvTypeDefinition(props) {
 	const [{ defaultValue, reflection }] = (0, __alloy_js_core.splitProps)(props, ["defaultValue", "reflection"]);
-	const context = (0, __powerlines_alloy_core_contexts_context.usePowerlines)();
+	const context = require_context.usePowerlines();
 	return [
-		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_typescript_interface.TypeScriptInterface, {
+		(0, __alloy_js_core_jsx_runtime.createComponent)(require_typescript_interface.TypeScriptInterface, {
 			name: " EnvBase",
 			"extends": ["EnvInterface"],
 			defaultValue,
@@ -186,15 +186,15 @@ function ConfigPropertySet(props) {
 		}
 	})];
 }
-const createEnvRefkey = (0, __powerlines_alloy_helpers_refkey.refkey)("createEnv");
-const envRefkey = (0, __powerlines_alloy_helpers_refkey.refkey)("env");
-const envSerializerRefkey = (0, __powerlines_alloy_helpers_refkey.refkey)("EnvSerializer");
+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 }, rest] = (0, __alloy_js_core.splitProps)(props, ["defaultConfig"]);
-	const context = (0, __powerlines_alloy_core_contexts_context.usePowerlines)();
+	const context = require_context.usePowerlines();
 	const defaultValue = (0, __alloy_js_core.computed)(() => context && require_load.loadEnvFromContext(context, process.env));
 	const reflection = require_create_reflection_resource.createReflectionResource(context);
 	const envInstance = (0, __alloy_js_core.computed)(() => {
@@ -206,7 +206,7 @@ function EnvBuiltin(props) {
 	});
 	const reflectionGetProperties = (0, __alloy_js_core.computed)(() => reflection.data?.getProperties().filter((property) => !property.isIgnored()).sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())) ?? []);
 	const reflectionSetProperties = (0, __alloy_js_core.computed)(() => reflection.data?.getProperties().filter((property) => !property.isIgnored() && !property.isReadonly()).sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())) ?? []);
-	return (0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_builtin_file.BuiltinFile, (0, __alloy_js_core_jsx_runtime.mergeProps)(rest, {
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(require_builtin_file.BuiltinFile, (0, __alloy_js_core_jsx_runtime.mergeProps)(rest, {
 		id: "env",
 		description: "The Powerlines environment configuration module provides an interface to define environment configuration parameters.",
 		get imports() {
@@ -247,7 +247,7 @@ function EnvBuiltin(props) {
 						];
 					}
 				}),
-				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_typescript_object.TypescriptObject, {
+				(0, __alloy_js_core_jsx_runtime.createComponent)(require_typescript_object.TypescriptObject, {
 					name: "initialEnv",
 					type: "Partial<EnvBase>",
 					defaultValue,
@@ -257,13 +257,13 @@ function EnvBuiltin(props) {
 				}),
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDoc, {
+				(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDoc, {
 					heading: "The environment configuration serializer for the Powerlines application.",
 					get children() {
 						return [
-							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocLink, { children: `https://deepkit.io/docs/serialization/serializers` }),
-							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocLink, { children: `https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918` }),
-							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `This serializer is used to serialize and deserialize the Powerlines environment configuration.` })
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocLink, { children: `https://deepkit.io/docs/serialization/serializers` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocLink, { children: `https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocRemarks, { children: `This serializer is used to serialize and deserialize the Powerlines environment configuration.` })
 						];
 					}
 				}),
@@ -293,13 +293,13 @@ function EnvBuiltin(props) {
 				}),
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDoc, {
+				(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDoc, {
 					heading: "A {@link EnvSerializer | environment configuration serializer} instance for the Powerlines application.",
 					get children() {
 						return [
-							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocLink, { children: `https://deepkit.io/docs/serialization/serializers` }),
-							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocLink, { children: `https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918` }),
-							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `This serializer is used to serialize and deserialize the Powerlines environment configuration.` })
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocLink, { children: `https://deepkit.io/docs/serialization/serializers` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocLink, { children: `https://github.com/marcj/untitled-code/blob/master/packages/type/src/serializer.ts#L1918` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocRemarks, { children: `This serializer is used to serialize and deserialize the Powerlines environment configuration.` })
 						];
 					}
 				}),
@@ -316,13 +316,13 @@ function EnvBuiltin(props) {
 				}),
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDoc, {
+				(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDoc, {
 					heading: "Serialize a environment configuration object to JSON data objects (not a JSON string).",
 					get children() {
 						return [
-							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `The resulting JSON object can be stringified using JSON.stringify().` }),
-							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocExample, { children: `const json = serializeEnv(env);` }),
-							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocThrows, { children: `ValidationError when serialization or validation fails.` })
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocRemarks, { children: `The resulting JSON object can be stringified using JSON.stringify().` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocExample, { children: `const json = serializeEnv(env);` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocThrows, { children: `ValidationError when serialization or validation fails.` })
 						];
 					}
 				}),
@@ -334,13 +334,13 @@ function EnvBuiltin(props) {
 				}),
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDoc, {
+				(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDoc, {
 					heading: "Deserialize a environment configuration object from JSON data objects to JavaScript objects, without running any validators.",
 					get children() {
 						return [
-							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `Types that are already correct will be used as-is.` }),
-							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocExample, { children: `const env = deserializeEnv(json);` }),
-							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocThrows, { children: `ValidationError when deserialization fails.` })
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocRemarks, { children: `Types that are already correct will be used as-is.` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocExample, { children: `const env = deserializeEnv(json);` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocThrows, { children: `ValidationError when deserialization fails.` })
 						];
 					}
 				}),
@@ -352,16 +352,16 @@ function EnvBuiltin(props) {
 				}),
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
-				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDoc, {
+				(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDoc, {
 					heading: "Initializes the Powerlines environment configuration module.",
 					get children() {
 						return [
-							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `This function initializes the Powerlines environment configuration object.` }),
-							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocParam, {
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocRemarks, { children: `This function initializes the Powerlines environment configuration object.` }),
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocParam, {
 								name: "environmentConfig",
 								children: `The dynamic/runtime configuration - this could include the current environment variables or any other environment-specific settings provided by the runtime.`
 							}),
-							(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_typescript_components_tsdoc.TSDocReturns, { children: `The initialized Powerlines configuration object.` })
+							(0, __alloy_js_core_jsx_runtime.createComponent)(require_tsdoc.TSDocReturns, { children: `The initialized Powerlines configuration object.` })
 						];
 					}
 				}),
@@ -438,11 +438,7 @@ function EnvBuiltin(props) {
 					"export": true,
 					"const": true,
 					get initializer() {
-						return [
-							__alloy_js_core.code`createEnv(`,
-							defaultConfig || "{}",
-							__alloy_js_core.code` as Partial<Env>)`
-						];
+						return [__alloy_js_core.code`createEnv(${defaultConfig || "{}"} as Partial<Env>);`];
 					}
 				})
 			];

package/dist/components/env.d.cts

@@ -1,6 +1,6 @@
+import { BuiltinFileProps } from "../plugin-alloy/src/typescript/components/builtin-file.cjs";
+import { TypeScriptInterfaceProps } from "../plugin-alloy/src/typescript/components/typescript-interface.cjs";
 import { Children } from "@alloy-js/core";
-import { BuiltinFileProps } from "@powerlines/alloy/typescript/components/builtin-file";
-import { TypeScriptInterfaceProps } from "@powerlines/alloy/typescript/components/typescript-interface";
 
 //#region src/components/env.d.ts
 

package/dist/components/env.d.mts

@@ -1,6 +1,6 @@
+import { BuiltinFileProps } from "../plugin-alloy/src/typescript/components/builtin-file.mjs";
+import { TypeScriptInterfaceProps } from "../plugin-alloy/src/typescript/components/typescript-interface.mjs";
 import { Children } from "@alloy-js/core";
-import { BuiltinFileProps } from "@powerlines/alloy/typescript/components/builtin-file";
-import { TypeScriptInterfaceProps } from "@powerlines/alloy/typescript/components/typescript-interface";
 
 //#region src/components/env.d.ts
 

package/dist/components/env.mjs

@@ -1,4 +1,10 @@
 import { type_exports } from "../deepkit/src/vendor/type.mjs";
+import { usePowerlines } from "../plugin-alloy/src/core/contexts/context.mjs";
+import { refkey as refkey$1 } from "../plugin-alloy/src/helpers/refkey.mjs";
+import { TSDoc, TSDocExample, TSDocLink, TSDocParam, TSDocRemarks, TSDocReturns, TSDocThrows } from "../plugin-alloy/src/typescript/components/tsdoc.mjs";
+import { BuiltinFile } from "../plugin-alloy/src/typescript/components/builtin-file.mjs";
+import { TypeScriptInterface } from "../plugin-alloy/src/typescript/components/typescript-interface.mjs";
+import { TypescriptObject } from "../plugin-alloy/src/typescript/components/typescript-object.mjs";
 import { loadEnvFromContext } from "../helpers/load.mjs";
 import { createReflectionResource } from "../helpers/create-reflection-resource.mjs";
 import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
@@ -7,12 +13,6 @@ import defu from "defu";
 import { titleCase } from "@stryke/string-format/title-case";
 import { isNull } from "@stryke/type-checks/is-null";
 import { ClassDeclaration, ClassMethod, ElseIfClause, FunctionDeclaration, IfStatement, NewExpression, TypeDeclaration, VarDeclaration } from "@alloy-js/typescript";
-import { usePowerlines } from "@powerlines/alloy/core/contexts/context";
-import { refkey } from "@powerlines/alloy/helpers/refkey";
-import { BuiltinFile } from "@powerlines/alloy/typescript/components/builtin-file";
-import { TSDoc, TSDocExample, TSDocLink, TSDocParam, TSDocRemarks, TSDocReturns, TSDocThrows } from "@powerlines/alloy/typescript/components/tsdoc";
-import { TypeScriptInterface } from "@powerlines/alloy/typescript/components/typescript-interface";
-import { TypescriptObject } from "@powerlines/alloy/typescript/components/typescript-object";
 
 //#region src/components/env.tsx
 /**
@@ -184,9 +184,9 @@ function ConfigPropertySet(props) {
 		}
 	})];
 }
-const createEnvRefkey = refkey("createEnv");
-const envRefkey = refkey("env");
-const envSerializerRefkey = refkey("EnvSerializer");
+const createEnvRefkey = refkey$1("createEnv");
+const envRefkey = refkey$1("env");
+const envSerializerRefkey = refkey$1("EnvSerializer");
 /**
 * Generates the environment configuration module for the Powerlines project.
 */
@@ -436,11 +436,7 @@ function EnvBuiltin(props) {
 					"export": true,
 					"const": true,
 					get initializer() {
-						return [
-							code`createEnv(`,
-							defaultConfig || "{}",
-							code` as Partial<Env>)`
-						];
+						return [code`createEnv(${defaultConfig || "{}"} as Partial<Env>);`];
 					}
 				})
 			];

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

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

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

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

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { EnvDocs } from "./components/docs.cjs";
-import { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps } from "./components/env.cjs";
 import { Plugin } from "./powerlines/src/types/plugin.cjs";
+import { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps } from "./components/env.cjs";
 import { EnvInterface, SecretsInterface, __ΩEnvInterface, __ΩSecretsInterface } from "./types/runtime.cjs";
 import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType } from "./types/plugin.cjs";
 import { envBabelPlugin } from "./babel/plugin.cjs";

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { EnvDocs } from "./components/docs.mjs";
+import { Plugin } from "./powerlines/src/types/plugin.mjs";
 import { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps } from "./components/env.mjs";
 import "./components/index.mjs";
-import { Plugin } from "./powerlines/src/types/plugin.mjs";
 import "./powerlines/src/index.mjs";
 import { EnvInterface, SecretsInterface, __ΩEnvInterface, __ΩSecretsInterface } from "./types/runtime.mjs";
 import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType } from "./types/plugin.mjs";

package/dist/plugin-alloy/src/core/components/single-line-comment.cjs

@@ -0,0 +1,22 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+
+//#region ../plugin-alloy/src/core/components/single-line-comment.tsx
+/**
+* A single line comment block. The children are rendered as a prose element, which means that they
+* are broken into multiple lines
+*/
+function SingleLineComment(props) {
+	const { variant = "double-slash", children } = props;
+	const commentStart = variant === "slash-star" ? "/* " : variant === "slash-star-star" ? "/** " : variant === "triple-slash" ? "/// " : variant === "markdown" ? "<!-- " : "// ";
+	return [commentStart, (0, __alloy_js_core_jsx_runtime.createIntrinsic)("align", {
+		string: commentStart,
+		get children() {
+			return [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Prose, { children }), variant === "slash-star" || variant === "slash-star-star" ? " */ " : variant === "markdown" ? " -->" : ""];
+		}
+	})];
+}
+
+//#endregion
+exports.SingleLineComment = SingleLineComment;

package/dist/plugin-alloy/src/core/components/single-line-comment.mjs

@@ -0,0 +1,21 @@
+import { createComponent, createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { Prose } from "@alloy-js/core";
+
+//#region ../plugin-alloy/src/core/components/single-line-comment.tsx
+/**
+* A single line comment block. The children are rendered as a prose element, which means that they
+* are broken into multiple lines
+*/
+function SingleLineComment(props) {
+	const { variant = "double-slash", children } = props;
+	const commentStart = variant === "slash-star" ? "/* " : variant === "slash-star-star" ? "/** " : variant === "triple-slash" ? "/// " : variant === "markdown" ? "<!-- " : "// ";
+	return [commentStart, createIntrinsic("align", {
+		string: commentStart,
+		get children() {
+			return [createComponent(Prose, { children }), variant === "slash-star" || variant === "slash-star-star" ? " */ " : variant === "markdown" ? " -->" : ""];
+		}
+	})];
+}
+
+//#endregion
+export { SingleLineComment };

package/dist/plugin-alloy/src/core/components/source-file.cjs

@@ -0,0 +1,64 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+const require_context = require('../contexts/context.cjs');
+require('../contexts/index.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+let __stryke_path_append = require("@stryke/path/append");
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+
+//#region ../plugin-alloy/src/core/components/source-file.tsx
+/**
+* A base component representing a Powerlines generated source file.
+*
+* @param props - The properties for the source file.
+* @returns The rendered source file component.
+*/
+function SourceFile(props) {
+	const [{ children, meta, path, header, storage, filetype, reference }] = (0, __alloy_js_core.splitProps)(props, [
+		"children",
+		"meta",
+		"path",
+		"header",
+		"storage",
+		"filetype",
+		"reference"
+	]);
+	const metadata = require_context.useMeta();
+	const parentDirectory = (0, __alloy_js_core.useContext)(__alloy_js_core.SourceDirectoryContext);
+	const sourceFile = {
+		path: (0, __stryke_path_append.appendPath)(path, parentDirectory.path),
+		filetype,
+		reference
+	};
+	parentDirectory?.addContent(sourceFile);
+	const printOptions = (0, __alloy_js_core.useFormatOptions)({
+		printWidth: props.printWidth,
+		tabWidth: props.tabWidth,
+		useTabs: props.useTabs,
+		insertFinalNewLine: props.insertFinalNewLine
+	});
+	const nodeContext = (0, __alloy_js_core.getContext)();
+	nodeContext.meta = (0, defu.default)({
+		sourceFile,
+		printOptions
+	}, meta ?? {});
+	metadata[sourceFile.path] = {
+		storage,
+		...meta ?? {}
+	};
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.SourceFileContext.Provider, {
+		value: sourceFile,
+		get children() {
+			return [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+				when: header !== void 0,
+				get children() {
+					return [header, (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
+				}
+			}), children];
+		}
+	});
+}
+
+//#endregion
+exports.SourceFile = SourceFile;

package/dist/plugin-alloy/src/core/components/source-file.d.cts

@@ -0,0 +1,23 @@
+import { StoragePreset } from "../../../../powerlines/src/types/fs.cjs";
+import { ComponentProps } from "../../types/components.cjs";
+import { SourceFileProps } from "@alloy-js/core";
+
+//#region ../plugin-alloy/src/core/components/source-file.d.ts
+type SourceFileProps$1 = SourceFileProps & ComponentProps & {
+  /**
+   * The storage preset for the output files.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset;
+  /**
+   * The metadata associated with the source file.
+   *
+   * @remarks
+   * The values stored in the metadata will be available in the rendering context.
+   */
+  meta?: Record<string, any>;
+};
+//#endregion
+export { SourceFileProps$1 as SourceFileProps };

package/dist/plugin-alloy/src/core/components/source-file.d.mts

@@ -0,0 +1,23 @@
+import { StoragePreset } from "../../../../powerlines/src/types/fs.mjs";
+import { ComponentProps } from "../../types/components.mjs";
+import { SourceFileProps } from "@alloy-js/core";
+
+//#region ../plugin-alloy/src/core/components/source-file.d.ts
+type SourceFileProps$1 = SourceFileProps & ComponentProps & {
+  /**
+   * The storage preset for the output files.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset;
+  /**
+   * The metadata associated with the source file.
+   *
+   * @remarks
+   * The values stored in the metadata will be available in the rendering context.
+   */
+  meta?: Record<string, any>;
+};
+//#endregion
+export { SourceFileProps$1 as SourceFileProps };

package/dist/plugin-alloy/src/core/components/source-file.mjs

@@ -0,0 +1,62 @@
+import { useMeta } from "../contexts/context.mjs";
+import "../contexts/index.mjs";
+import { createComponent, createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { Show, SourceDirectoryContext, SourceFileContext, getContext, splitProps, useContext, useFormatOptions } from "@alloy-js/core";
+import { appendPath } from "@stryke/path/append";
+import defu from "defu";
+
+//#region ../plugin-alloy/src/core/components/source-file.tsx
+/**
+* A base component representing a Powerlines generated source file.
+*
+* @param props - The properties for the source file.
+* @returns The rendered source file component.
+*/
+function SourceFile(props) {
+	const [{ children, meta, path, header, storage, filetype, reference }] = splitProps(props, [
+		"children",
+		"meta",
+		"path",
+		"header",
+		"storage",
+		"filetype",
+		"reference"
+	]);
+	const metadata = useMeta();
+	const parentDirectory = useContext(SourceDirectoryContext);
+	const sourceFile = {
+		path: appendPath(path, parentDirectory.path),
+		filetype,
+		reference
+	};
+	parentDirectory?.addContent(sourceFile);
+	const printOptions = useFormatOptions({
+		printWidth: props.printWidth,
+		tabWidth: props.tabWidth,
+		useTabs: props.useTabs,
+		insertFinalNewLine: props.insertFinalNewLine
+	});
+	const nodeContext = getContext();
+	nodeContext.meta = defu({
+		sourceFile,
+		printOptions
+	}, meta ?? {});
+	metadata[sourceFile.path] = {
+		storage,
+		...meta ?? {}
+	};
+	return createComponent(SourceFileContext.Provider, {
+		value: sourceFile,
+		get children() {
+			return [createComponent(Show, {
+				when: header !== void 0,
+				get children() {
+					return [header, createIntrinsic("hbr", {})];
+				}
+			}), children];
+		}
+	});
+}
+
+//#endregion
+export { SourceFile };

package/dist/plugin-alloy/src/core/contexts/context.cjs

@@ -6,6 +6,55 @@ let __alloy_js_core = require("@alloy-js/core");
 * The Powerlines context used in template rendering.
 */
 const PowerlinesContext = (0, __alloy_js_core.createNamedContext)("powerlines");
+/**
+* Hook to access the Powerlines Context.
+*
+* @returns The Context.
+*/
+function usePowerlinesContext() {
+	return (0, __alloy_js_core.useContext)(PowerlinesContext);
+}
+/**
+* Hook to safely access the {@link PluginContext | Powerlines context}.
+*
+* @returns The Powerlines context or undefined if not set.
+*/
+function usePowerlinesSafe() {
+	return usePowerlinesContext()?.ref?.value;
+}
+/**
+* Hook to access the {@link PluginContext | Powerlines context}.
+*
+* @returns The Powerlines context.
+*/
+function usePowerlines() {
+	const powerlines = usePowerlinesSafe();
+	if (!powerlines) throw new Error("Powerlines - Context is not set. Please make sure the Alloy components are being provided to an invocation of the `render` function added to plugins by `@powerlines/plugin-alloy`.");
+	return powerlines;
+}
+/**
+* Hook to safely access the render context's metadata.
+*
+* @returns The Powerlines context or undefined if not set.
+*/
+function useMetaSafe() {
+	return usePowerlinesContext()?.meta?.value;
+}
+/**
+* Hook to access the render context's metadata.
+*
+* @returns The Powerlines context.
+*/
+function useMeta() {
+	const meta = useMetaSafe();
+	if (!meta) throw new Error("Powerlines metadata is not available in the rendering context. Please make sure the Alloy components are being provided to an invocation of the `render` function added to plugins by `@powerlines/plugin-alloy`.");
+	return meta;
+}
 
 //#endregion
-exports.PowerlinesContext = PowerlinesContext;
+exports.PowerlinesContext = PowerlinesContext;
+exports.useMeta = useMeta;
+exports.useMetaSafe = useMetaSafe;
+exports.usePowerlines = usePowerlines;
+exports.usePowerlinesContext = usePowerlinesContext;
+exports.usePowerlinesSafe = usePowerlinesSafe;