@powerlines/plugin-alloy 0.19.10 → 0.19.12

package/dist/{chunk-CbDLau6x.cjs → _virtual/rolldown_runtime.cjs}

@@ -26,9 +26,4 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 //#endregion
 
-Object.defineProperty(exports, '__toESM', {
-  enumerable: true,
-  get: function () {
-    return __toESM;
-  }
-});
+exports.__toESM = __toESM;

package/dist/core/components/index.cjs

@@ -1,12 +1,7 @@
-const require_output = require('../../output-CQXrGP3y.cjs');
-require('../../unctx-BhYL7EYu.cjs');
-const require_single_line_comment = require('../../single-line-comment-COZ9RWsm.cjs');
-require('../../context-Dxe_Fumh.cjs');
-require('../../reflection-DHpdhvwI.cjs');
-require('../../contexts-DezKayEz.cjs');
-const require_source_file = require('../../source-file-DWvB6bux.cjs');
-require('../../components-B0evB5xd.cjs');
+const require_core_components_output = require('./output.cjs');
+const require_core_components_single_line_comment = require('./single-line-comment.cjs');
+const require_core_components_source_file = require('./source-file.cjs');
 
-exports.Output = require_output.Output;
-exports.SingleLineComment = require_single_line_comment.SingleLineComment;
-exports.SourceFile = require_source_file.SourceFile;
+exports.Output = require_core_components_output.Output;
+exports.SingleLineComment = require_core_components_single_line_comment.SingleLineComment;
+exports.SourceFile = require_core_components_source_file.SourceFile;

package/dist/core/components/index.d.cts

@@ -1,7 +1,4 @@
-import "../../context-Gqs3Ru42.cjs";
-import { n as OutputProps, r as __ΩOutputProps, t as Output } from "../../output-__DECiJi.cjs";
-import "../../components-IRVnipN0.cjs";
-import { a as __ΩSingleLineCommentVariant, i as __ΩSingleLineCommentProps, n as SingleLineCommentProps, r as SingleLineCommentVariant, t as SingleLineComment } from "../../single-line-comment-C-XZILtX.cjs";
-import { n as SourceFileProps, r as __ΩSourceFileProps, t as SourceFile } from "../../source-file-CE5xdm7N.cjs";
-import "../../index-BUYyA1Xh.cjs";
+import { Output, OutputProps, __ΩOutputProps } from "./output.cjs";
+import { SingleLineComment, SingleLineCommentProps, SingleLineCommentVariant, __ΩSingleLineCommentProps, __ΩSingleLineCommentVariant } from "./single-line-comment.cjs";
+import { SourceFile, SourceFileProps, __ΩSourceFileProps } from "./source-file.cjs";
 export { Output, OutputProps, SingleLineComment, SingleLineCommentProps, SingleLineCommentVariant, SourceFile, SourceFileProps, __ΩOutputProps, __ΩSingleLineCommentProps, __ΩSingleLineCommentVariant, __ΩSourceFileProps };

package/dist/core/components/index.d.mts

@@ -1,7 +1,4 @@
-import "../../context-Du_bVzRZ.mjs";
-import { n as OutputProps, r as __ΩOutputProps, t as Output } from "../../output-CMC94bm-.mjs";
-import "../../components-oHSM7vmp.mjs";
-import { a as __ΩSingleLineCommentVariant, i as __ΩSingleLineCommentProps, n as SingleLineCommentProps, r as SingleLineCommentVariant, t as SingleLineComment } from "../../single-line-comment-PMv_zrfe.mjs";
-import { n as SourceFileProps, r as __ΩSourceFileProps, t as SourceFile } from "../../source-file-CQl0UCgf.mjs";
-import "../../index-CzItj62a.mjs";
+import { Output, OutputProps, __ΩOutputProps } from "./output.mjs";
+import { SingleLineComment, SingleLineCommentProps, SingleLineCommentVariant, __ΩSingleLineCommentProps, __ΩSingleLineCommentVariant } from "./single-line-comment.mjs";
+import { SourceFile, SourceFileProps, __ΩSourceFileProps } from "./source-file.mjs";
 export { Output, OutputProps, SingleLineComment, SingleLineCommentProps, SingleLineCommentVariant, SourceFile, SourceFileProps, __ΩOutputProps, __ΩSingleLineCommentProps, __ΩSingleLineCommentVariant, __ΩSourceFileProps };

package/dist/core/components/index.mjs

@@ -1,10 +1,5 @@
-import { t as Output } from "../../output-D3UQ5nZo.mjs";
-import "../../unctx-D-zVwWnS.mjs";
-import { t as SingleLineComment } from "../../single-line-comment-mOQtfhWt.mjs";
-import "../../context-Cf8tpe50.mjs";
-import "../../reflection-B-NMNIoB.mjs";
-import "../../contexts-juWSyBfb.mjs";
-import { t as SourceFile } from "../../source-file-DIVz8Z5n.mjs";
-import "../../components-CyQi7RHT.mjs";
+import { Output } from "./output.mjs";
+import { SingleLineComment } from "./single-line-comment.mjs";
+import { SourceFile } from "./source-file.mjs";
 
 export { Output, SingleLineComment, SourceFile };

package/dist/core/components/output.cjs

@@ -1,3 +1,33 @@
-const require_output = require('../../output-CQXrGP3y.cjs');
+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");
+let __stryke_path_replace = require("@stryke/path/replace");
 
-exports.Output = require_output.Output;
+//#region src/core/components/output.tsx
+/**
+* Output component for rendering the Powerlines plugin's output files via templates.
+*/
+function Output(props) {
+	const [{ children, context, basePath }, rest] = (0, __alloy_js_core.splitProps)(props, [
+		"children",
+		"context",
+		"basePath"
+	]);
+	const basePathRef = (0, __alloy_js_core.computed)(() => basePath ? (0, __stryke_path_replace.replacePath)(basePath, context.workspaceConfig.workspaceRoot) : context.workspaceConfig.workspaceRoot);
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Output, (0, __alloy_js_core_jsx_runtime.mergeProps)(rest, {
+		get basePath() {
+			return basePathRef.value;
+		},
+		get children() {
+			return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+				get when() {
+					return Boolean(context);
+				},
+				children
+			});
+		}
+	}));
+}
+
+//#endregion
+exports.Output = Output;

package/dist/core/components/output.d.cts

@@ -1,3 +1,23 @@
-import "../../context-Gqs3Ru42.cjs";
-import { n as OutputProps, r as __ΩOutputProps, t as Output } from "../../output-__DECiJi.cjs";
+import { MetaItem } from "../contexts/context.cjs";
+import * as _alloy_js_core3 from "@alloy-js/core";
+import { OutputProps as OutputProps$1 } from "@alloy-js/core";
+import { PluginContext } from "powerlines/types/context";
+
+//#region src/core/components/output.d.ts
+interface OutputProps<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>> extends OutputProps$1 {
+  /**
+   * The current Powerlines process context.
+   */
+  context: TContext;
+  /**
+   * Metadata for the current render.
+   */
+  meta?: TMeta;
+}
+/**
+ * Output component for rendering the Powerlines plugin's output files via templates.
+ */
+declare function Output<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(props: OutputProps<TContext, TMeta>): _alloy_js_core3.Children;
+declare type __ΩOutputProps = any[];
+//#endregion
 export { Output, OutputProps, __ΩOutputProps };

package/dist/core/components/output.d.mts

@@ -1,3 +1,23 @@
-import "../../context-Du_bVzRZ.mjs";
-import { n as OutputProps, r as __ΩOutputProps, t as Output } from "../../output-CMC94bm-.mjs";
+import { MetaItem } from "../contexts/context.mjs";
+import * as _alloy_js_core1 from "@alloy-js/core";
+import { OutputProps as OutputProps$1 } from "@alloy-js/core";
+import { PluginContext } from "powerlines/types/context";
+
+//#region src/core/components/output.d.ts
+interface OutputProps<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>> extends OutputProps$1 {
+  /**
+   * The current Powerlines process context.
+   */
+  context: TContext;
+  /**
+   * Metadata for the current render.
+   */
+  meta?: TMeta;
+}
+/**
+ * Output component for rendering the Powerlines plugin's output files via templates.
+ */
+declare function Output<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(props: OutputProps<TContext, TMeta>): _alloy_js_core1.Children;
+declare type __ΩOutputProps = any[];
+//#endregion
 export { Output, OutputProps, __ΩOutputProps };

package/dist/core/components/output.mjs

@@ -1,3 +1,32 @@
-import { t as Output } from "../../output-D3UQ5nZo.mjs";
+import { createComponent, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { Output as Output$1, Show, computed, splitProps } from "@alloy-js/core";
+import { replacePath } from "@stryke/path/replace";
 
+//#region src/core/components/output.tsx
+/**
+* Output component for rendering the Powerlines plugin's output files via templates.
+*/
+function Output(props) {
+	const [{ children, context, basePath }, rest] = splitProps(props, [
+		"children",
+		"context",
+		"basePath"
+	]);
+	const basePathRef = computed(() => basePath ? replacePath(basePath, context.workspaceConfig.workspaceRoot) : context.workspaceConfig.workspaceRoot);
+	return createComponent(Output$1, mergeProps(rest, {
+		get basePath() {
+			return basePathRef.value;
+		},
+		get children() {
+			return createComponent(Show, {
+				get when() {
+					return Boolean(context);
+				},
+				children
+			});
+		}
+	}));
+}
+
+//#endregion
 export { Output };

package/dist/core/components/single-line-comment.cjs

@@ -1,3 +1,22 @@
-const require_single_line_comment = require('../../single-line-comment-COZ9RWsm.cjs');
+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");
 
-exports.SingleLineComment = require_single_line_comment.SingleLineComment;
+//#region 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/core/components/single-line-comment.d.cts

@@ -1,3 +1,22 @@
-import "../../components-IRVnipN0.cjs";
-import { a as __ΩSingleLineCommentVariant, i as __ΩSingleLineCommentProps, n as SingleLineCommentProps, r as SingleLineCommentVariant, t as SingleLineComment } from "../../single-line-comment-C-XZILtX.cjs";
+import { ComponentProps } from "../../types/components.cjs";
+import * as _alloy_js_core4 from "@alloy-js/core";
+
+//#region src/core/components/single-line-comment.d.ts
+type SingleLineCommentVariant = "double-slash" | "triple-slash" | "slash-star" | "slash-star-star" | "markdown";
+interface SingleLineCommentProps extends ComponentProps {
+  /**
+   * The variant of the single line comment.
+   *
+   * @defaultValue "double-slash"
+   */
+  variant?: SingleLineCommentVariant;
+}
+/**
+ * A single line comment block. The children are rendered as a prose element, which means that they
+ * are broken into multiple lines
+ */
+declare function SingleLineComment(props: SingleLineCommentProps): _alloy_js_core4.Children;
+declare type __ΩSingleLineCommentVariant = any[];
+declare type __ΩSingleLineCommentProps = any[];
+//#endregion
 export { SingleLineComment, SingleLineCommentProps, SingleLineCommentVariant, __ΩSingleLineCommentProps, __ΩSingleLineCommentVariant };

package/dist/core/components/single-line-comment.d.mts

@@ -1,3 +1,22 @@
-import "../../components-oHSM7vmp.mjs";
-import { a as __ΩSingleLineCommentVariant, i as __ΩSingleLineCommentProps, n as SingleLineCommentProps, r as SingleLineCommentVariant, t as SingleLineComment } from "../../single-line-comment-PMv_zrfe.mjs";
+import { ComponentProps } from "../../types/components.mjs";
+import * as _alloy_js_core0 from "@alloy-js/core";
+
+//#region src/core/components/single-line-comment.d.ts
+type SingleLineCommentVariant = "double-slash" | "triple-slash" | "slash-star" | "slash-star-star" | "markdown";
+interface SingleLineCommentProps extends ComponentProps {
+  /**
+   * The variant of the single line comment.
+   *
+   * @defaultValue "double-slash"
+   */
+  variant?: SingleLineCommentVariant;
+}
+/**
+ * A single line comment block. The children are rendered as a prose element, which means that they
+ * are broken into multiple lines
+ */
+declare function SingleLineComment(props: SingleLineCommentProps): _alloy_js_core0.Children;
+declare type __ΩSingleLineCommentVariant = any[];
+declare type __ΩSingleLineCommentProps = any[];
+//#endregion
 export { SingleLineComment, SingleLineCommentProps, SingleLineCommentVariant, __ΩSingleLineCommentProps, __ΩSingleLineCommentVariant };

package/dist/core/components/single-line-comment.mjs

@@ -1,3 +1,21 @@
-import { t as SingleLineComment } from "../../single-line-comment-mOQtfhWt.mjs";
+import { createComponent, createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { Prose } from "@alloy-js/core";
 
+//#region 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/core/components/source-file.cjs

@@ -1,7 +1,64 @@
-require('../../unctx-BhYL7EYu.cjs');
-require('../../context-Dxe_Fumh.cjs');
-require('../../reflection-DHpdhvwI.cjs');
-require('../../contexts-DezKayEz.cjs');
-const require_source_file = require('../../source-file-DWvB6bux.cjs');
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_core_contexts_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);
 
-exports.SourceFile = require_source_file.SourceFile;
+//#region 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_core_contexts_context.useMetaSafe();
+	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 ?? {});
+	if (metadata) 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/core/components/source-file.d.cts

@@ -1,3 +1,32 @@
-import "../../components-IRVnipN0.cjs";
-import { n as SourceFileProps, r as __ΩSourceFileProps, t as SourceFile } from "../../source-file-CE5xdm7N.cjs";
+import { ComponentProps } from "../../types/components.cjs";
+import * as _alloy_js_core2 from "@alloy-js/core";
+import { SourceFileProps as SourceFileProps$1 } from "@alloy-js/core";
+import { StoragePreset } from "powerlines/types/fs";
+
+//#region src/core/components/source-file.d.ts
+type SourceFileProps = SourceFileProps$1 & 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>;
+};
+/**
+ * A base component representing a Powerlines generated source file.
+ *
+ * @param props - The properties for the source file.
+ * @returns The rendered source file component.
+ */
+declare function SourceFile(props: SourceFileProps): _alloy_js_core2.Children;
+declare type __ΩSourceFileProps = any[];
+//#endregion
 export { SourceFile, SourceFileProps, __ΩSourceFileProps };

package/dist/core/components/source-file.d.mts

@@ -1,3 +1,32 @@
-import "../../components-oHSM7vmp.mjs";
-import { n as SourceFileProps, r as __ΩSourceFileProps, t as SourceFile } from "../../source-file-CQl0UCgf.mjs";
+import { ComponentProps } from "../../types/components.mjs";
+import * as _alloy_js_core0 from "@alloy-js/core";
+import { SourceFileProps as SourceFileProps$1 } from "@alloy-js/core";
+import { StoragePreset } from "powerlines/types/fs";
+
+//#region src/core/components/source-file.d.ts
+type SourceFileProps = SourceFileProps$1 & 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>;
+};
+/**
+ * A base component representing a Powerlines generated source file.
+ *
+ * @param props - The properties for the source file.
+ * @returns The rendered source file component.
+ */
+declare function SourceFile(props: SourceFileProps): _alloy_js_core0.Children;
+declare type __ΩSourceFileProps = any[];
+//#endregion
 export { SourceFile, SourceFileProps, __ΩSourceFileProps };

package/dist/core/components/source-file.mjs

@@ -1,7 +1,62 @@
-import "../../unctx-D-zVwWnS.mjs";
-import "../../context-Cf8tpe50.mjs";
-import "../../reflection-B-NMNIoB.mjs";
-import "../../contexts-juWSyBfb.mjs";
-import { t as SourceFile } from "../../source-file-DIVz8Z5n.mjs";
+import { useMetaSafe } 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 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 = useMetaSafe();
+	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 ?? {});
+	if (metadata) 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/core/contexts/context.cjs

@@ -1,8 +1,54 @@
-require('../../unctx-BhYL7EYu.cjs');
-const require_context = require('../../context-Dxe_Fumh.cjs');
+const require_unctx = require('../../internal/unctx.cjs');
 
-exports.useMeta = require_context.useMeta;
-exports.useMetaSafe = require_context.useMetaSafe;
-exports.usePowerlines = require_context.usePowerlines;
-exports.usePowerlinesContext = require_context.usePowerlinesContext;
-exports.usePowerlinesSafe = require_context.usePowerlinesSafe;
+//#region src/core/contexts/context.ts
+/**
+* Hook to access the Powerlines Context.
+*
+* @returns The Context.
+*/
+function usePowerlinesContext() {
+	return require_unctx.unctx.tryUse();
+}
+/**
+* Hook to safely access the {@link PluginContext | Powerlines context}.
+*
+* @returns The Powerlines context or null if not set.
+*/
+function usePowerlinesSafe() {
+	return usePowerlinesContext()?.value ?? null;
+}
+/**
+* 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 null if not set.
+*/
+function useMetaSafe() {
+	return usePowerlinesContext()?.meta ?? null;
+}
+/**
+* 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.useMeta = useMeta;
+exports.useMetaSafe = useMetaSafe;
+exports.usePowerlines = usePowerlines;
+exports.usePowerlinesContext = usePowerlinesContext;
+exports.usePowerlinesSafe = usePowerlinesSafe;

package/dist/core/contexts/context.d.cts

@@ -1,2 +1,66 @@
-import { a as useMeta, c as usePowerlinesContext, i as __ΩPowerlinesContextInterface, l as usePowerlinesSafe, n as PowerlinesContextInterface, o as useMetaSafe, r as __ΩMetaItem, s as usePowerlines, t as MetaItem } from "../../context-Gqs3Ru42.cjs";
+import { PluginContext } from "powerlines/types/context";
+import { StoragePreset } from "powerlines/types/fs";
+
+//#region src/core/contexts/context.d.ts
+interface MetaItem {
+  /**
+   * The kind of metadata item.
+   */
+  kind?: "builtin" | "entry" | string;
+  /**
+   * Whether to skip formatting for this output.
+   */
+  skipFormat?: boolean;
+  /**
+   * The storage preset or adapter name for the output files.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset | string;
+  [key: string]: any;
+}
+interface PowerlinesContextInterface<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>> {
+  /**
+   * The current Powerlines context.
+   */
+  value: TContext;
+  /**
+   * The current render metadata.
+   */
+  meta: TMeta;
+}
+/**
+ * Hook to access the Powerlines Context.
+ *
+ * @returns The Context.
+ */
+declare function usePowerlinesContext<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): PowerlinesContextInterface<TContext, TMeta> | null;
+/**
+ * Hook to safely access the {@link PluginContext | Powerlines context}.
+ *
+ * @returns The Powerlines context or null if not set.
+ */
+declare function usePowerlinesSafe<TContext extends PluginContext = PluginContext>(): TContext | null;
+/**
+ * Hook to access the {@link PluginContext | Powerlines context}.
+ *
+ * @returns The Powerlines context.
+ */
+declare function usePowerlines<TContext extends PluginContext = PluginContext>(): TContext;
+/**
+ * Hook to safely access the render context's metadata.
+ *
+ * @returns The Powerlines context or null if not set.
+ */
+declare function useMetaSafe<TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): TMeta | null;
+/**
+ * Hook to access the render context's metadata.
+ *
+ * @returns The Powerlines context.
+ */
+declare function useMeta<TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): TMeta;
+declare type __ΩMetaItem = any[];
+declare type __ΩPowerlinesContextInterface = any[];
+//#endregion
 export { MetaItem, PowerlinesContextInterface, __ΩMetaItem, __ΩPowerlinesContextInterface, useMeta, useMetaSafe, usePowerlines, usePowerlinesContext, usePowerlinesSafe };