@powerlines/plugin-alloy 0.25.49 → 0.25.51

package/dist/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1,29 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__toESM = __toESM;

package/dist/_virtual/_rolldown/runtime.mjs

@@ -0,0 +1,3 @@
+import "node:module";
+
+export {  };

package/dist/core/components/index.cjs

@@ -0,0 +1,10 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+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');
+const require_core_components_spacing = require('./spacing.cjs');
+
+exports.Output = require_core_components_output.Output;
+exports.SingleLineComment = require_core_components_single_line_comment.SingleLineComment;
+exports.SourceFile = require_core_components_source_file.SourceFile;
+exports.Spacing = require_core_components_spacing.Spacing;

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

@@ -0,0 +1,5 @@
+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";
+import { Spacing, SpacingProps, __ΩSpacingProps } from "./spacing.cjs";
+export { Output, OutputProps, SingleLineComment, SingleLineCommentProps, SingleLineCommentVariant, SourceFile, SourceFileProps, Spacing, SpacingProps, __ΩOutputProps, __ΩSingleLineCommentProps, __ΩSingleLineCommentVariant, __ΩSourceFileProps, __ΩSpacingProps };

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

@@ -0,0 +1,5 @@
+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";
+import { Spacing, SpacingProps, __ΩSpacingProps } from "./spacing.mjs";
+export { Output, OutputProps, SingleLineComment, SingleLineCommentProps, SingleLineCommentVariant, SourceFile, SourceFileProps, Spacing, SpacingProps, __ΩOutputProps, __ΩSingleLineCommentProps, __ΩSingleLineCommentVariant, __ΩSourceFileProps, __ΩSpacingProps };

package/dist/core/components/index.mjs

@@ -0,0 +1,6 @@
+import { Output } from "./output.mjs";
+import { SingleLineComment } from "./single-line-comment.mjs";
+import { SourceFile } from "./source-file.mjs";
+import { Spacing } from "./spacing.mjs";
+
+export { Output, SingleLineComment, SourceFile, Spacing };

package/dist/core/components/output.cjs

@@ -0,0 +1,41 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_core_contexts_context = require('../contexts/context.cjs');
+const require_core_contexts_meta = require('../contexts/meta.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");
+
+//#region src/core/components/output.tsx
+/**
+* Output component for rendering the Powerlines plugin's output files via templates.
+*/
+function Output(props) {
+	const [{ children, context, meta = {} }, rest] = (0, _alloy_js_core.splitProps)(props, [
+		"children",
+		"context",
+		"meta"
+	]);
+	const contextRef = (0, _alloy_js_core.computed)(() => context);
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(require_core_contexts_meta.MetaContext.Provider, {
+		value: meta,
+		get children() {
+			return (0, _alloy_js_core_jsx_runtime.createComponent)(require_core_contexts_context.PowerlinesContext.Provider, {
+				get value() {
+					return contextRef.value;
+				},
+				get children() {
+					return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Output, (0, _alloy_js_core_jsx_runtime.mergeProps)(rest, {
+						get basePath() {
+							return contextRef.value.workspaceConfig.workspaceRoot;
+						},
+						children
+					}));
+				}
+			});
+		}
+	});
+}
+
+//#endregion
+exports.Output = Output;

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

@@ -0,0 +1,24 @@
+import { MetaItem } from "../contexts/meta.cjs";
+import * as _alloy_js_core0 from "@alloy-js/core";
+import { OutputProps as OutputProps$1 } from "@alloy-js/core";
+import { PluginContext } from "@powerlines/core";
+
+//#region src/core/components/output.d.ts
+interface OutputProps<TContext extends PluginContext = PluginContext> extends Omit<OutputProps$1, "basePath"> {
+  /**
+   * The current Powerlines process context.
+   */
+  context: TContext;
+  /**
+   * The file metadata collected during rendering.
+   */
+  meta?: Record<string, MetaItem>;
+}
+/**
+ * Output component for rendering the Powerlines plugin's output files via templates.
+ */
+declare function Output<TContext extends PluginContext = PluginContext>(props: OutputProps<TContext>): _alloy_js_core0.Children;
+declare type __ΩOutputProps = any[];
+//#endregion
+export { Output, OutputProps, __ΩOutputProps };
+//# sourceMappingURL=output.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.cts","names":[],"sources":["../../../src/core/components/output.tsx"],"mappings":";;;;;;UAwBiB,WAAA,kBACE,aAAA,GAAgB,aAAA,UACzB,IAAA,CAAK,aAAA;;;;EAIb,OAAA,EAAS,QAAA;EANiB;;;EAW1B,IAAA,GAAO,MAAA,SAAe,QAAA;AAAA;;;;iBAMR,MAAA,kBAAwB,aAAA,GAAgB,aAAA,CAAA,CACtD,KAAA,EAAO,WAAA,CAAY,QAAA,IAAD,eAAA,CAAU,QAAA;AAAA"}

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

@@ -0,0 +1,24 @@
+import { MetaItem } from "../contexts/meta.mjs";
+import * as _alloy_js_core0 from "@alloy-js/core";
+import { OutputProps as OutputProps$1 } from "@alloy-js/core";
+import { PluginContext } from "@powerlines/core";
+
+//#region src/core/components/output.d.ts
+interface OutputProps<TContext extends PluginContext = PluginContext> extends Omit<OutputProps$1, "basePath"> {
+  /**
+   * The current Powerlines process context.
+   */
+  context: TContext;
+  /**
+   * The file metadata collected during rendering.
+   */
+  meta?: Record<string, MetaItem>;
+}
+/**
+ * Output component for rendering the Powerlines plugin's output files via templates.
+ */
+declare function Output<TContext extends PluginContext = PluginContext>(props: OutputProps<TContext>): _alloy_js_core0.Children;
+declare type __ΩOutputProps = any[];
+//#endregion
+export { Output, OutputProps, __ΩOutputProps };
+//# sourceMappingURL=output.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.mts","names":[],"sources":["../../../src/core/components/output.tsx"],"mappings":";;;;;;UAwBiB,WAAA,kBACE,aAAA,GAAgB,aAAA,UACzB,IAAA,CAAK,aAAA;;;;EAIb,OAAA,EAAS,QAAA;EANiB;;;EAW1B,IAAA,GAAO,MAAA,SAAe,QAAA;AAAA;;;;iBAMR,MAAA,kBAAwB,aAAA,GAAgB,aAAA,CAAA,CACtD,KAAA,EAAO,WAAA,CAAY,QAAA,IAAD,eAAA,CAAU,QAAA;AAAA"}

package/dist/core/components/output.mjs

@@ -0,0 +1,40 @@
+import { PowerlinesContext } from "../contexts/context.mjs";
+import { MetaContext } from "../contexts/meta.mjs";
+import "../contexts/index.mjs";
+import { createComponent, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { Output as Output$1, computed, splitProps } from "@alloy-js/core";
+
+//#region src/core/components/output.tsx
+/**
+* Output component for rendering the Powerlines plugin's output files via templates.
+*/
+function Output(props) {
+	const [{ children, context, meta = {} }, rest] = splitProps(props, [
+		"children",
+		"context",
+		"meta"
+	]);
+	const contextRef = computed(() => context);
+	return createComponent(MetaContext.Provider, {
+		value: meta,
+		get children() {
+			return createComponent(PowerlinesContext.Provider, {
+				get value() {
+					return contextRef.value;
+				},
+				get children() {
+					return createComponent(Output$1, mergeProps(rest, {
+						get basePath() {
+							return contextRef.value.workspaceConfig.workspaceRoot;
+						},
+						children
+					}));
+				}
+			});
+		}
+	});
+}
+
+//#endregion
+export { Output };
+//# sourceMappingURL=output.mjs.map

package/dist/core/components/output.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.mjs","names":[],"sources":["../../../src/core/components/output.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { OutputProps as OutputPropsExternal } from \"@alloy-js/core\";\nimport { computed, Output as OutputExternal, splitProps } from \"@alloy-js/core\";\nimport type { PluginContext } from \"@powerlines/core\";\nimport { MetaContext, MetaItem } from \"../contexts\";\nimport { PowerlinesContext } from \"../contexts/context\";\n\nexport interface OutputProps<\n  TContext extends PluginContext = PluginContext\n> extends Omit<OutputPropsExternal, \"basePath\"> {\n  /**\n   * The current Powerlines process context.\n   */\n  context: TContext;\n\n  /**\n   * The file metadata collected during rendering.\n   */\n  meta?: Record<string, MetaItem>;\n}\n\n/**\n * Output component for rendering the Powerlines plugin's output files via templates.\n */\nexport function Output<TContext extends PluginContext = PluginContext>(\n  props: OutputProps<TContext>\n) {\n  const [{ children, context, meta = {} }, rest] = splitProps(props, [\n    \"children\",\n    \"context\",\n    \"meta\"\n  ]);\n\n  const contextRef = computed(() => context);\n\n  return (\n    <MetaContext.Provider value={meta}>\n      <PowerlinesContext.Provider value={contextRef.value}>\n        <OutputExternal\n          {...rest}\n          basePath={contextRef.value.workspaceConfig.workspaceRoot}>\n          {children}\n        </OutputExternal>\n      </PowerlinesContext.Provider>\n    </MetaContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;AAuCA,SAAU,OAA6D,OAAa;CAClF,MAAA,CAAA,EACF,UACE,SACA,OAAA,EAAA,IACA,QAAS,WAAU,OAAS;EAAA;EAAa;EAAQ;EAAW,CAAA;CAC5D,MAAG,aAAS,eAAA,QAAA;AACZ,QAAG,gBAAQ,YAAA,UAAA;EACT,OAAK;EACL,IAAA,WAAA;;IAEI,IAAA,QAAY;;;IAGf,IAAA,WAAY;AACV,YAAA,gBAA2B,UAAiB,WAAO,MAAA;MACjD,IAAA,WAAA;AACK,cAAI,WAAA,MAAA,gBAAA;;MAEC;MACT,CAAA,CAAA;;IAEJ,CAAA;;EAEN,CAAA"}

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

@@ -0,0 +1,23 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_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 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" ? "<!-- " : variant === "yaml" ? "# " : "// ";
+	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

@@ -0,0 +1,23 @@
+import { ComponentProps } from "../../types/components.cjs";
+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" | "yaml";
+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 };
+//# sourceMappingURL=single-line-comment.d.cts.map

package/dist/core/components/single-line-comment.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-line-comment.d.cts","names":[],"sources":["../../../src/core/components/single-line-comment.tsx"],"mappings":";;;;KAqBY,wBAAA;AAAA,UAQK,sBAAA,SAA+B,cAAA;;AARhD;;;;EAcE,OAAA,GAAU,wBAAA;AAAA;;;;;iBAOI,iBAAA,CAAkB,KAAA,EAAO,sBAAA,GAAsB,eAAA,CAAA,QAAA;AAAA"}

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

@@ -0,0 +1,23 @@
+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" | "yaml";
+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 };
+//# sourceMappingURL=single-line-comment.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"single-line-comment.d.mts","names":[],"sources":["../../../src/core/components/single-line-comment.tsx"],"mappings":";;;;KAqBY,wBAAA;AAAA,UAQK,sBAAA,SAA+B,cAAA;;AARhD;;;;EAcE,OAAA,GAAU,wBAAA;AAAA;;;;;iBAOI,iBAAA,CAAkB,KAAA,EAAO,sBAAA,GAAsB,eAAA,CAAA,QAAA;AAAA"}

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

@@ -0,0 +1,22 @@
+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" ? "<!-- " : variant === "yaml" ? "# " : "// ";
+	return [commentStart, createIntrinsic("align", {
+		string: commentStart,
+		get children() {
+			return [createComponent(Prose, { children }), variant === "slash-star" || variant === "slash-star-star" ? " */ " : variant === "markdown" ? " -->" : ""];
+		}
+	})];
+}
+
+//#endregion
+export { SingleLineComment };
+//# sourceMappingURL=single-line-comment.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"single-line-comment.mjs","names":[],"sources":["../../../src/core/components/single-line-comment.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Prose } from \"@alloy-js/core\";\nimport { ComponentProps } from \"../../types/components\";\n\nexport type SingleLineCommentVariant =\n  | \"double-slash\"\n  | \"triple-slash\"\n  | \"slash-star\"\n  | \"slash-star-star\"\n  | \"markdown\"\n  | \"yaml\";\n\nexport interface SingleLineCommentProps extends ComponentProps {\n  /**\n   * The variant of the single line comment.\n   *\n   * @defaultValue \"double-slash\"\n   */\n  variant?: SingleLineCommentVariant;\n}\n\n/**\n * A single line comment block. The children are rendered as a prose element, which means that they\n * are broken into multiple lines\n */\nexport function SingleLineComment(props: SingleLineCommentProps) {\n  const { variant = \"double-slash\", children } = props;\n\n  const commentStart =\n    variant === \"slash-star\"\n      ? \"/* \"\n      : variant === \"slash-star-star\"\n        ? \"/** \"\n        : variant === \"triple-slash\"\n          ? \"/// \"\n          : variant === \"markdown\"\n            ? \"<!-- \"\n            : variant === \"yaml\"\n              ? \"# \"\n              : \"// \";\n\n  return (\n    <>\n      {commentStart}\n      <align string={commentStart}>\n        <Prose>{children}</Prose>\n\n        {variant === \"slash-star\" || variant === \"slash-star-star\"\n          ? \" */ \"\n          : variant === \"markdown\"\n            ? \" -->\"\n            : \"\"}\n      </align>\n    </>\n  );\n}\n"],"mappings":";;;;;;;;AAmCA,SAAY,kBAAA,OAAwB;CACpC,MAAA,4BAEE,aACG;CACH,MAAK,eAAY,YAAS,eAAA,QAAA,YAAA,oBAAA,SAAA,YAAA,iBAAA,SAAA,YAAA,aAAA,UAAA,YAAA,SAAA,OAAA;AAC1B,QAAA,CAAA,cAAA,gBAAA,SAAA;EACF,QAAO;EACL,IAAM,WAAW;oCAEX,UACJ,CAAA,EAAA,YAAkB,gBAAK,YAAA,oBAAA,SAAA,YAAA,aAAA,SAAA,GAAA;;EAExB,CAAC,CAAC"}

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

@@ -0,0 +1,64 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_core_contexts_meta = require('../contexts/meta.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_runtime.__toESM(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 }] = (0, _alloy_js_core.splitProps)(props, [
+		"children",
+		"meta",
+		"path",
+		"header",
+		"storage",
+		"filetype",
+		"reference"
+	]);
+	const metadata = require_core_contexts_meta.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 ?? {});
+	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

@@ -0,0 +1,33 @@
+import { ComponentProps } from "../../types/components.cjs";
+import * as _alloy_js_core0 from "@alloy-js/core";
+import { SourceFileProps as SourceFileProps$1 } from "@alloy-js/core";
+import { StoragePreset } from "powerlines";
+
+//#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 };
+//# sourceMappingURL=source-file.d.cts.map

package/dist/core/components/source-file.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-file.d.cts","names":[],"sources":["../../../src/core/components/source-file.tsx"],"mappings":";;;;;;KAkCY,eAAA,GAAkB,iBAAA,GAC5B,cAAA;;;AADF;;;;EAQI,OAAA,GAAU,aAAA;EAAA;;;;;;EAQV,IAAA,GAAO,MAAA;AAAA;;;;;AASX;;iBAAgB,UAAA,CAAW,KAAA,EAAO,eAAA,GAAe,eAAA,CAAA,QAAA;AAAA"}

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

@@ -0,0 +1,33 @@
+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";
+
+//#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 };
+//# sourceMappingURL=source-file.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-file.d.mts","names":[],"sources":["../../../src/core/components/source-file.tsx"],"mappings":";;;;;;KAkCY,eAAA,GAAkB,iBAAA,GAC5B,cAAA;;;AADF;;;;EAQI,OAAA,GAAU,aAAA;EAAA;;;;;;EAQV,IAAA,GAAO,MAAA;AAAA;;;;;AASX;;iBAAgB,UAAA,CAAW,KAAA,EAAO,eAAA,GAAe,eAAA,CAAA,QAAA;AAAA"}

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

@@ -0,0 +1,62 @@
+import { useMeta } from "../contexts/meta.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 = 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 ?? {});
+	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 };
+//# sourceMappingURL=source-file.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-file.mjs","names":[],"sources":["../../../src/core/components/source-file.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport {\n  getContext,\n  Show,\n  SourceDirectoryContext,\n  SourceFileContext,\n  SourceFileProps as SourceFilePropsExternal,\n  splitProps,\n  useContext,\n  useFormatOptions\n} from \"@alloy-js/core\";\nimport { appendPath } from \"@stryke/path/append\";\nimport defu from \"defu\";\nimport type { StoragePreset } from \"powerlines\";\nimport { ComponentProps } from \"../../types/components\";\nimport { useMeta } from \"../contexts/meta\";\n\nexport type SourceFileProps = SourceFilePropsExternal &\n  ComponentProps & {\n    /**\n     * The storage preset for the output files.\n     *\n     * @remarks\n     * If not specified, the output mode will be determined by the provided `output.mode` value.\n     */\n    storage?: StoragePreset;\n\n    /**\n     * The metadata associated with the source file.\n     *\n     * @remarks\n     * The values stored in the metadata will be available in the rendering context.\n     */\n    meta?: Record<string, any>;\n  };\n\n/**\n * A base component representing a Powerlines generated source file.\n *\n * @param props - The properties for the source file.\n * @returns The rendered source file component.\n */\nexport function SourceFile(props: SourceFileProps) {\n  const [{ children, meta, path, header, storage, filetype, reference }] =\n    splitProps(props, [\n      \"children\",\n      \"meta\",\n      \"path\",\n      \"header\",\n      \"storage\",\n      \"filetype\",\n      \"reference\"\n    ]);\n\n  const metadata = useMeta();\n  const parentDirectory = useContext(SourceDirectoryContext)!;\n\n  const sourceFile: SourceFileContext = {\n    path: appendPath(path, parentDirectory.path),\n    filetype,\n    reference\n  };\n  parentDirectory?.addContent(sourceFile);\n\n  const printOptions = useFormatOptions({\n    printWidth: props.printWidth,\n    tabWidth: props.tabWidth,\n    useTabs: props.useTabs,\n    insertFinalNewLine: props.insertFinalNewLine\n  });\n\n  const nodeContext = getContext()!;\n  nodeContext.meta = defu(\n    {\n      sourceFile,\n      printOptions\n    },\n    meta ?? {}\n  );\n\n  if (metadata) {\n    metadata[sourceFile.path] = {\n      storage,\n      ...(meta ?? {})\n    };\n  }\n\n  return (\n    <SourceFileContext.Provider value={sourceFile}>\n      <Show when={header !== undefined}>\n        {header}\n        <hbr />\n      </Show>\n      {children}\n    </SourceFileContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAiDA,SAAM,WAAA,OAAA;CACJ,MAAM,CAAC,EACN,gBAED,MACE,QACH,SACG,UACA,eACF,WAAA,OAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA;CACF,MAAO,WAAS,SAAW;CACzB,MAAM,kBAAkB,WAAO,uBAA2B;CAC1D,MAAE,aAAkB;EAClB,MAAG,WAAS,MAAA,gBAAA,KAAA;EACZ;EACA;EACD;AACD,kBAAa,WAAA,WAAA;CACb,MAAK,eAAS,iBAAA;EACZ,YAAY,MAAA;EACZ,UAAE,MAAA;;EAEJ,oBAAiB,MAAS;EAC1B,CAAA;;AAEA,aAAM,OAAY,KAAA;EAChB;EACA;EACD,EAAC,QAAA,EAAA,CAAA;AACF,KAAC,SACD,UAAA,WAAiB,QAAW;;EAE5B,GAAM,QAAA,EAAY;EAChB;AAEF,QAAE,gBAAsB,kBAAA,UAAA;EACtB,OAAA;EACA,IAAA,WAAA;;IAEI,MAAA,WAAc;IACpB,IAAA,WAAmB;AACjB,YAAA,CAAA,QAAA,gBAAA,OAAA,EAAA,CAAA,CAAA;;IAEE,CAAA,EAAA,SAAA;;EAEH,CAAC"}

package/dist/core/components/spacing.cjs

@@ -0,0 +1,20 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_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 src/core/components/spacing.tsx
+/**
+* A simple component that renders two horizontal breaks to create vertical spacing between elements.
+*/
+function Spacing({ scale = 1 }) {
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
+		get each() {
+			return Array.from({ length: scale });
+		},
+		children: (_) => [(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}), (0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})]
+	});
+}
+
+//#endregion
+exports.Spacing = Spacing;

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

@@ -0,0 +1,24 @@
+import * as _alloy_js_core0 from "@alloy-js/core";
+
+//#region src/core/components/spacing.d.ts
+interface SpacingProps {
+  /**
+   * A scale factor that determines the amount of vertical space to be added.
+   *
+   * @remarks
+   * The default value is 1, which corresponds to a standard spacing. A value of 2 would double the spacing, while a value of 0.5 would halve it.
+   *
+   * @defaultValue 1
+   */
+  scale?: number;
+}
+/**
+ * A simple component that renders two horizontal breaks to create vertical spacing between elements.
+ */
+declare function Spacing({
+  scale
+}: SpacingProps): _alloy_js_core0.Children;
+declare type __ΩSpacingProps = any[];
+//#endregion
+export { Spacing, SpacingProps, __ΩSpacingProps };
+//# sourceMappingURL=spacing.d.cts.map

package/dist/core/components/spacing.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.d.cts","names":[],"sources":["../../../src/core/components/spacing.tsx"],"mappings":";;;UAoBiB,YAAA;;;AAAjB;;;;;AAeA;EANE,KAAA;AAAA;;;;iBAMc,OAAA,CAAA;EAAU;AAAA,GAAa,YAAA,GAAY,eAAA,CAAA,QAAA;AAAA"}

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

@@ -0,0 +1,24 @@
+import * as _alloy_js_core0 from "@alloy-js/core";
+
+//#region src/core/components/spacing.d.ts
+interface SpacingProps {
+  /**
+   * A scale factor that determines the amount of vertical space to be added.
+   *
+   * @remarks
+   * The default value is 1, which corresponds to a standard spacing. A value of 2 would double the spacing, while a value of 0.5 would halve it.
+   *
+   * @defaultValue 1
+   */
+  scale?: number;
+}
+/**
+ * A simple component that renders two horizontal breaks to create vertical spacing between elements.
+ */
+declare function Spacing({
+  scale
+}: SpacingProps): _alloy_js_core0.Children;
+declare type __ΩSpacingProps = any[];
+//#endregion
+export { Spacing, SpacingProps, __ΩSpacingProps };
+//# sourceMappingURL=spacing.d.mts.map

package/dist/core/components/spacing.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.d.mts","names":[],"sources":["../../../src/core/components/spacing.tsx"],"mappings":";;;UAoBiB,YAAA;;;AAAjB;;;;;AAeA;EANE,KAAA;AAAA;;;;iBAMc,OAAA,CAAA;EAAU;AAAA,GAAa,YAAA,GAAY,eAAA,CAAA,QAAA;AAAA"}

package/dist/core/components/spacing.mjs

@@ -0,0 +1,19 @@
+import { createComponent, createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { For } from "@alloy-js/core";
+
+//#region src/core/components/spacing.tsx
+/**
+* A simple component that renders two horizontal breaks to create vertical spacing between elements.
+*/
+function Spacing({ scale = 1 }) {
+	return createComponent(For, {
+		get each() {
+			return Array.from({ length: scale });
+		},
+		children: (_) => [createIntrinsic("hbr", {}), createIntrinsic("hbr", {})]
+	});
+}
+
+//#endregion
+export { Spacing };
+//# sourceMappingURL=spacing.mjs.map