@powerlines/plugin-env 0.15.4 → 0.15.6

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

@@ -0,0 +1,110 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+const require_components = require('../../types/components.cjs');
+let __alloy_js_core = require("@alloy-js/core");
+
+//#region ../plugin-alloy/src/core/contexts/reflection.ts
+const __ΩRecord = [
+	"K",
+	"T",
+	"Record",
+	"l'e#\"Rb!b\"Pde\"!N#!w#y"
+];
+const __ΩReflectionClassContextInterface = [
+	() => __ΩRecord,
+	"T",
+	"ReflectionClass",
+	"reflection",
+	() => require_components.__ΩReflectionOverrideInterface,
+	"override",
+	"ReflectionClassContextInterface",
+	"&\"o!#c\"P\"w#4$e\"!o%\"4&8Mw'y"
+];
+/**
+* The reflection class context used in template rendering.
+*/
+const ReflectionClassContext = (__alloy_js_core.createContext.Ω = [[() => __ΩReflectionClassContextInterface, "\"o!\""]], (0, __alloy_js_core.createContext)());
+/**
+* Hook to access the Reflection context.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useReflectionClass() {
+	const context = (__alloy_js_core.useContext.Ω = [[
+		() => __ΩReflectionClassContextInterface,
+		() => __ΩRecord,
+		"&\"o\"#o!\""
+	]], (0, __alloy_js_core.useContext)(ReflectionClassContext));
+	if (!context) throw new Error("Powerlines - ReflectionClass 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 context;
+}
+useReflectionClass.__type = [
+	"useReflectionClass",
+	"Hook to access the Reflection context.",
+	"P\"/!?\""
+];
+/**
+* The reflection property context used in template rendering.
+*/
+const ReflectionPropertyContext = (__alloy_js_core.createNamedContext.Ω = [["ReflectionProperty", "\"w!"]], (0, __alloy_js_core.createNamedContext)("reflection-property"));
+/**
+* Hook to access the Reflection Property context.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useReflectionProperty() {
+	const context = (__alloy_js_core.useContext.Ω = [["ReflectionProperty", "\"w!"]], (0, __alloy_js_core.useContext)(ReflectionPropertyContext));
+	if (!context) throw new Error("Powerlines - Reflection Property 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 context;
+}
+useReflectionProperty.__type = [
+	"useReflectionProperty",
+	"Hook to access the Reflection Property context.",
+	"P\"/!?\""
+];
+/**
+* The reflection method context used in template rendering.
+*/
+const ReflectionMethodContext = (__alloy_js_core.createNamedContext.Ω = [["ReflectionMethod", "\"w!"]], (0, __alloy_js_core.createNamedContext)("reflection-method"));
+/**
+* Hook to access the Reflection Method context.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useReflectionMethod() {
+	const context = (__alloy_js_core.useContext.Ω = [["ReflectionMethod", "\"w!"]], (0, __alloy_js_core.useContext)(ReflectionMethodContext));
+	if (!context) throw new Error("Powerlines - Reflection Method 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 context;
+}
+useReflectionMethod.__type = [
+	"useReflectionMethod",
+	"Hook to access the Reflection Method context.",
+	"P\"/!?\""
+];
+/**
+* The reflection parameter context used in template rendering.
+*/
+const ReflectionParameterContext = (__alloy_js_core.createNamedContext.Ω = [["ReflectionParameter", "\"w!"]], (0, __alloy_js_core.createNamedContext)("reflection-parameter"));
+/**
+* Hook to access the Reflection Parameter context.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useReflectionParameter() {
+	return __alloy_js_core.useContext.Ω = [["ReflectionParameter", "\"w!"]], (0, __alloy_js_core.useContext)(ReflectionParameterContext);
+}
+useReflectionParameter.__type = [
+	"useReflectionParameter",
+	"Hook to access the Reflection Parameter context.",
+	"P\"/!?\""
+];
+
+//#endregion
+exports.ReflectionClassContext = ReflectionClassContext;
+exports.ReflectionMethodContext = ReflectionMethodContext;
+exports.ReflectionParameterContext = ReflectionParameterContext;
+exports.ReflectionPropertyContext = ReflectionPropertyContext;
+exports.__ΩReflectionClassContextInterface = __ΩReflectionClassContextInterface;
+exports.useReflectionClass = useReflectionClass;
+exports.useReflectionMethod = useReflectionMethod;
+exports.useReflectionParameter = useReflectionParameter;
+exports.useReflectionProperty = useReflectionProperty;

package/dist/plugin-alloy/src/core/contexts/reflection.mjs

@@ -0,0 +1,101 @@
+import { __ΩReflectionOverrideInterface } from "../../types/components.mjs";
+import { createContext, createNamedContext, useContext } from "@alloy-js/core";
+
+//#region ../plugin-alloy/src/core/contexts/reflection.ts
+const __ΩRecord = [
+	"K",
+	"T",
+	"Record",
+	"l'e#\"Rb!b\"Pde\"!N#!w#y"
+];
+const __ΩReflectionClassContextInterface = [
+	() => __ΩRecord,
+	"T",
+	"ReflectionClass",
+	"reflection",
+	() => __ΩReflectionOverrideInterface,
+	"override",
+	"ReflectionClassContextInterface",
+	"&\"o!#c\"P\"w#4$e\"!o%\"4&8Mw'y"
+];
+/**
+* The reflection class context used in template rendering.
+*/
+const ReflectionClassContext = (createContext.Ω = [[() => __ΩReflectionClassContextInterface, "\"o!\""]], createContext());
+/**
+* Hook to access the Reflection context.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useReflectionClass() {
+	const context = (useContext.Ω = [[
+		() => __ΩReflectionClassContextInterface,
+		() => __ΩRecord,
+		"&\"o\"#o!\""
+	]], useContext(ReflectionClassContext));
+	if (!context) throw new Error("Powerlines - ReflectionClass 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 context;
+}
+useReflectionClass.__type = [
+	"useReflectionClass",
+	"Hook to access the Reflection context.",
+	"P\"/!?\""
+];
+/**
+* The reflection property context used in template rendering.
+*/
+const ReflectionPropertyContext = (createNamedContext.Ω = [["ReflectionProperty", "\"w!"]], createNamedContext("reflection-property"));
+/**
+* Hook to access the Reflection Property context.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useReflectionProperty() {
+	const context = (useContext.Ω = [["ReflectionProperty", "\"w!"]], useContext(ReflectionPropertyContext));
+	if (!context) throw new Error("Powerlines - Reflection Property 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 context;
+}
+useReflectionProperty.__type = [
+	"useReflectionProperty",
+	"Hook to access the Reflection Property context.",
+	"P\"/!?\""
+];
+/**
+* The reflection method context used in template rendering.
+*/
+const ReflectionMethodContext = (createNamedContext.Ω = [["ReflectionMethod", "\"w!"]], createNamedContext("reflection-method"));
+/**
+* Hook to access the Reflection Method context.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useReflectionMethod() {
+	const context = (useContext.Ω = [["ReflectionMethod", "\"w!"]], useContext(ReflectionMethodContext));
+	if (!context) throw new Error("Powerlines - Reflection Method 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 context;
+}
+useReflectionMethod.__type = [
+	"useReflectionMethod",
+	"Hook to access the Reflection Method context.",
+	"P\"/!?\""
+];
+/**
+* The reflection parameter context used in template rendering.
+*/
+const ReflectionParameterContext = (createNamedContext.Ω = [["ReflectionParameter", "\"w!"]], createNamedContext("reflection-parameter"));
+/**
+* Hook to access the Reflection Parameter context.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useReflectionParameter() {
+	return useContext.Ω = [["ReflectionParameter", "\"w!"]], useContext(ReflectionParameterContext);
+}
+useReflectionParameter.__type = [
+	"useReflectionParameter",
+	"Hook to access the Reflection Parameter context.",
+	"P\"/!?\""
+];
+
+//#endregion
+export { ReflectionClassContext, ReflectionMethodContext, ReflectionParameterContext, ReflectionPropertyContext, __ΩReflectionClassContextInterface, useReflectionClass, useReflectionMethod, useReflectionParameter, useReflectionProperty };

package/dist/plugin-alloy/src/helpers/refkey.cjs

@@ -0,0 +1,23 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+let __alloy_js_core = require("@alloy-js/core");
+
+//#region ../plugin-alloy/src/helpers/refkey.ts
+/**
+* Create a refkey for the provided arguments. Passing no arguments returns a fresh refkey that is guaranteed to be unique. Otherwise, the arguments passed will be used to create a refkey for those values. Providing the same arguments will always return the same refkey.
+*
+* @remarks
+* Values are compared using the SameValueZero algorithm, which considers objects the same if they are reference identical, and primitives the same if they are the same value, with the exception of `NaN`, which is always considered equal to other `NaN` values, and `-0`, which is considered identical to `+0`
+*/
+function refkey(...args) {
+	return (0, __alloy_js_core.refkey)("powerlines", ...args);
+}
+refkey.__type = [
+	"args",
+	"Refkey",
+	"refkey",
+	"Create a refkey for the provided arguments. Passing no arguments returns a fresh refkey that is guaranteed to be unique. Otherwise, the arguments passed will be used to create a refkey for those values. Providing the same arguments will always return the same refkey.",
+	"P#@2!\"w\"/#?$"
+];
+
+//#endregion
+exports.refkey = refkey;

package/dist/plugin-alloy/src/helpers/refkey.mjs

@@ -0,0 +1,22 @@
+import { refkey } from "@alloy-js/core";
+
+//#region ../plugin-alloy/src/helpers/refkey.ts
+/**
+* Create a refkey for the provided arguments. Passing no arguments returns a fresh refkey that is guaranteed to be unique. Otherwise, the arguments passed will be used to create a refkey for those values. Providing the same arguments will always return the same refkey.
+*
+* @remarks
+* Values are compared using the SameValueZero algorithm, which considers objects the same if they are reference identical, and primitives the same if they are the same value, with the exception of `NaN`, which is always considered equal to other `NaN` values, and `-0`, which is considered identical to `+0`
+*/
+function refkey$1(...args) {
+	return refkey("powerlines", ...args);
+}
+refkey$1.__type = [
+	"args",
+	"Refkey",
+	"refkey",
+	"Create a refkey for the provided arguments. Passing no arguments returns a fresh refkey that is guaranteed to be unique. Otherwise, the arguments passed will be used to create a refkey for those values. Providing the same arguments will always return the same refkey.",
+	"P#@2!\"w\"/#?$"
+];
+
+//#endregion
+export { refkey$1 as refkey };

package/dist/plugin-alloy/src/index.cjs

@@ -0,0 +1,93 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_output = require('./core/components/output.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+let __alloy_js_rollup_plugin = require("@alloy-js/rollup-plugin");
+__alloy_js_rollup_plugin = require_rolldown_runtime.__toESM(__alloy_js_rollup_plugin);
+let __stryke_json_storm_json = require("@stryke/json/storm-json");
+
+//#region ../plugin-alloy/src/index.tsx
+/**
+* Alloy-js plugin for Powerlines.
+*
+* @param options - The Alloy-js plugin user configuration options.
+* @returns A Powerlines plugin that integrates Alloy-js transformations.
+*/
+const plugin = (options = {}) => {
+	return [{
+		name: "alloy:config",
+		config() {
+			return {
+				alloy: {
+					typescript: true,
+					...options
+				},
+				build: {
+					inputOptions: { transform: { jsx: {
+						runtime: "classic",
+						pragma: "Alloy.createElement",
+						importSource: "@alloy-js/core"
+					} } },
+					plugins: [(0, __alloy_js_rollup_plugin.default)()]
+				}
+			};
+		},
+		async configResolved() {
+			if (this.tsconfig.tsconfigJson.compilerOptions?.jsx !== "preserve" || this.tsconfig.tsconfigJson.compilerOptions?.jsxImportSource !== "@alloy-js/core") {
+				this.tsconfig.tsconfigJson.compilerOptions ??= {};
+				if (this.tsconfig.tsconfigJson.compilerOptions.jsx !== "preserve") this.tsconfig.tsconfigJson.compilerOptions.jsx = "preserve";
+				if (this.tsconfig.tsconfigJson.compilerOptions.jsxImportSource !== "@alloy-js/core") this.tsconfig.tsconfigJson.compilerOptions.jsxImportSource = "@alloy-js/core";
+				await this.fs.write(this.tsconfig.tsconfigFilePath, __stryke_json_storm_json.StormJSON.stringify(this.tsconfig.tsconfigJson));
+			}
+			this.dependencies["@alloy-js/core"] = "^0.22.0";
+			if (this.config.alloy?.typescript !== false) this.dependencies["@alloy-js/typescript"] = "^0.22.0";
+			if (this.config.alloy?.json === true) this.dependencies["@alloy-js/json"] = "^0.22.0";
+			if (this.config.alloy?.markdown === true) this.dependencies["@alloy-js/markdown"] = "^0.22.0";
+		}
+	}, {
+		name: "alloy:update-context",
+		configResolved: {
+			order: "pre",
+			async handler() {
+				this.render = async (children) => {
+					const _self$ = this;
+					const meta = {};
+					await (0, __alloy_js_core.traverseOutput)(await (0, __alloy_js_core.renderAsync)((0, __alloy_js_core_jsx_runtime.createComponent)(require_output.Output, {
+						context: _self$,
+						meta,
+						get basePath() {
+							return _self$.workspaceConfig.workspaceRoot;
+						},
+						children
+					})), {
+						visitDirectory: (directory) => {
+							if (this.fs.existsSync(directory.path)) return;
+							this.fs.mkdirSync(directory.path);
+						},
+						visitFile: (file) => {
+							if ("contents" in file) {
+								const metadata = meta[file.path] ?? {};
+								if (metadata.kind === "builtin") {
+									if (!metadata.id) throw new Error(`Built-in file "${file.path}" is missing its ID in the render metadata.`);
+									this.emitBuiltinSync(file.contents, metadata.id, file.path, {
+										skipFormat: metadata.skipFormat,
+										storage: metadata.storage
+									});
+								} else if (metadata.kind === "entry") this.emitEntrySync(file.contents, file.path, {
+									skipFormat: metadata.skipFormat,
+									storage: metadata.storage,
+									...metadata.typeDefinition ?? {}
+								});
+								else this.emitSync(file.contents, file.path, metadata);
+							} else this.fs.copySync(file.sourcePath, file.path);
+						}
+					});
+				};
+			}
+		}
+	}];
+};
+var src_default = plugin;
+
+//#endregion
+exports.default = src_default;

package/dist/plugin-alloy/src/index.mjs

@@ -0,0 +1,91 @@
+import { Output as Output$1 } from "./core/components/output.mjs";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { renderAsync, traverseOutput } from "@alloy-js/core";
+import alloy from "@alloy-js/rollup-plugin";
+import { StormJSON } from "@stryke/json/storm-json";
+
+//#region ../plugin-alloy/src/index.tsx
+/**
+* Alloy-js plugin for Powerlines.
+*
+* @param options - The Alloy-js plugin user configuration options.
+* @returns A Powerlines plugin that integrates Alloy-js transformations.
+*/
+const plugin = (options = {}) => {
+	return [{
+		name: "alloy:config",
+		config() {
+			return {
+				alloy: {
+					typescript: true,
+					...options
+				},
+				build: {
+					inputOptions: { transform: { jsx: {
+						runtime: "classic",
+						pragma: "Alloy.createElement",
+						importSource: "@alloy-js/core"
+					} } },
+					plugins: [alloy()]
+				}
+			};
+		},
+		async configResolved() {
+			if (this.tsconfig.tsconfigJson.compilerOptions?.jsx !== "preserve" || this.tsconfig.tsconfigJson.compilerOptions?.jsxImportSource !== "@alloy-js/core") {
+				this.tsconfig.tsconfigJson.compilerOptions ??= {};
+				if (this.tsconfig.tsconfigJson.compilerOptions.jsx !== "preserve") this.tsconfig.tsconfigJson.compilerOptions.jsx = "preserve";
+				if (this.tsconfig.tsconfigJson.compilerOptions.jsxImportSource !== "@alloy-js/core") this.tsconfig.tsconfigJson.compilerOptions.jsxImportSource = "@alloy-js/core";
+				await this.fs.write(this.tsconfig.tsconfigFilePath, StormJSON.stringify(this.tsconfig.tsconfigJson));
+			}
+			this.dependencies["@alloy-js/core"] = "^0.22.0";
+			if (this.config.alloy?.typescript !== false) this.dependencies["@alloy-js/typescript"] = "^0.22.0";
+			if (this.config.alloy?.json === true) this.dependencies["@alloy-js/json"] = "^0.22.0";
+			if (this.config.alloy?.markdown === true) this.dependencies["@alloy-js/markdown"] = "^0.22.0";
+		}
+	}, {
+		name: "alloy:update-context",
+		configResolved: {
+			order: "pre",
+			async handler() {
+				this.render = async (children) => {
+					const _self$ = this;
+					const meta = {};
+					await traverseOutput(await renderAsync(createComponent(Output$1, {
+						context: _self$,
+						meta,
+						get basePath() {
+							return _self$.workspaceConfig.workspaceRoot;
+						},
+						children
+					})), {
+						visitDirectory: (directory) => {
+							if (this.fs.existsSync(directory.path)) return;
+							this.fs.mkdirSync(directory.path);
+						},
+						visitFile: (file) => {
+							if ("contents" in file) {
+								const metadata = meta[file.path] ?? {};
+								if (metadata.kind === "builtin") {
+									if (!metadata.id) throw new Error(`Built-in file "${file.path}" is missing its ID in the render metadata.`);
+									this.emitBuiltinSync(file.contents, metadata.id, file.path, {
+										skipFormat: metadata.skipFormat,
+										storage: metadata.storage
+									});
+								} else if (metadata.kind === "entry") this.emitEntrySync(file.contents, file.path, {
+									skipFormat: metadata.skipFormat,
+									storage: metadata.storage,
+									...metadata.typeDefinition ?? {}
+								});
+								else this.emitSync(file.contents, file.path, metadata);
+							} else this.fs.copySync(file.sourcePath, file.path);
+						}
+					});
+				};
+			}
+		}
+	}];
+};
+var src_default = plugin;
+
+//#endregion
+export { src_default as default };

package/dist/plugin-alloy/src/markdown/components/markdown-file.cjs

@@ -0,0 +1,115 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+const require_context = require('../../core/contexts/context.cjs');
+const require_single_line_comment = require('../../core/components/single-line-comment.cjs');
+const require_source_file = require('../../core/components/source-file.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
+let __alloy_js_markdown = require("@alloy-js/markdown");
+
+//#region ../plugin-alloy/src/markdown/components/markdown-file.tsx
+/**
+* A base component representing a Powerlines generated markdown source file.
+*
+* @param props - The properties for the source file.
+* @returns The rendered source file component.
+*/
+function MarkdownFile(props) {
+	const [{ children, storage }, rest] = (0, __alloy_js_core.splitProps)(props, ["children", "storage"]);
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(require_source_file.SourceFile, (0, __alloy_js_core_jsx_runtime.mergeProps)({ get header() {
+		return (0, __alloy_js_core_jsx_runtime.createComponent)(MarkdownFileHeader, {});
+	} }, rest, {
+		filetype: "md",
+		reference: __alloy_js_markdown.Link,
+		storage,
+		get children() {
+			return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+				get when() {
+					return Boolean(children);
+				},
+				children
+			});
+		}
+	}));
+}
+/**
+* Renders the header for a Powerlines Typescript source file.
+*
+* @param props - The properties for the source file header.
+* @returns The rendered source file header.
+*/
+function MarkdownFileHeader(props) {
+	const [{ children, disableEslint = true, disableBiome = true, disablePrettier = false }] = (0, __alloy_js_core.splitProps)(props, [
+		"children",
+		"disableEslint",
+		"disableBiome",
+		"disablePrettier"
+	]);
+	const context = require_context.usePowerlines();
+	return [
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Boolean(disableEslint);
+			},
+			get children() {
+				return [(0, __alloy_js_core_jsx_runtime.createComponent)(require_single_line_comment.SingleLineComment, {
+					variant: "markdown",
+					children: "eslint-disable"
+				}), (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Boolean(disablePrettier);
+			},
+			get children() {
+				return [(0, __alloy_js_core_jsx_runtime.createComponent)(require_single_line_comment.SingleLineComment, {
+					variant: "markdown",
+					children: "prettier-ignore"
+				}), (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Boolean(disableBiome);
+			},
+			get children() {
+				return [(0, __alloy_js_core_jsx_runtime.createComponent)(require_single_line_comment.SingleLineComment, {
+					variant: "markdown",
+					children: "biome-ignore lint: disable"
+				}), (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Boolean(disableEslint) || Boolean(disablePrettier) || Boolean(disableBiome);
+			},
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {});
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+			get when() {
+				return Boolean(children);
+			},
+			get children() {
+				return [children, (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(require_single_line_comment.SingleLineComment, {
+			variant: "markdown",
+			get children() {
+				return __alloy_js_core.code`Generated by ${(0, __stryke_string_format_title_case.titleCase)(context?.config.framework) || "Powerlines"}`;
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(require_single_line_comment.SingleLineComment, {
+			variant: "markdown",
+			children: __alloy_js_core.code`NOTE: Do not edit this file manually - it will be overwritten automatically by the "prepare" command`
+		}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+	];
+}
+
+//#endregion
+exports.MarkdownFile = MarkdownFile;

package/dist/plugin-alloy/src/markdown/components/markdown-file.mjs

@@ -0,0 +1,114 @@
+import { usePowerlines } from "../../core/contexts/context.mjs";
+import { SingleLineComment } from "../../core/components/single-line-comment.mjs";
+import { SourceFile } from "../../core/components/source-file.mjs";
+import { createComponent, createIntrinsic, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { Show, code, splitProps } from "@alloy-js/core";
+import { titleCase } from "@stryke/string-format/title-case";
+import { Link } from "@alloy-js/markdown";
+
+//#region ../plugin-alloy/src/markdown/components/markdown-file.tsx
+/**
+* A base component representing a Powerlines generated markdown source file.
+*
+* @param props - The properties for the source file.
+* @returns The rendered source file component.
+*/
+function MarkdownFile(props) {
+	const [{ children, storage }, rest] = splitProps(props, ["children", "storage"]);
+	return createComponent(SourceFile, mergeProps({ get header() {
+		return createComponent(MarkdownFileHeader, {});
+	} }, rest, {
+		filetype: "md",
+		reference: Link,
+		storage,
+		get children() {
+			return createComponent(Show, {
+				get when() {
+					return Boolean(children);
+				},
+				children
+			});
+		}
+	}));
+}
+/**
+* Renders the header for a Powerlines Typescript source file.
+*
+* @param props - The properties for the source file header.
+* @returns The rendered source file header.
+*/
+function MarkdownFileHeader(props) {
+	const [{ children, disableEslint = true, disableBiome = true, disablePrettier = false }] = splitProps(props, [
+		"children",
+		"disableEslint",
+		"disableBiome",
+		"disablePrettier"
+	]);
+	const context = usePowerlines();
+	return [
+		createComponent(Show, {
+			get when() {
+				return Boolean(disableEslint);
+			},
+			get children() {
+				return [createComponent(SingleLineComment, {
+					variant: "markdown",
+					children: "eslint-disable"
+				}), createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(disablePrettier);
+			},
+			get children() {
+				return [createComponent(SingleLineComment, {
+					variant: "markdown",
+					children: "prettier-ignore"
+				}), createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(disableBiome);
+			},
+			get children() {
+				return [createComponent(SingleLineComment, {
+					variant: "markdown",
+					children: "biome-ignore lint: disable"
+				}), createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(disableEslint) || Boolean(disablePrettier) || Boolean(disableBiome);
+			},
+			get children() {
+				return createIntrinsic("hbr", {});
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(children);
+			},
+			get children() {
+				return [children, createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(SingleLineComment, {
+			variant: "markdown",
+			get children() {
+				return code`Generated by ${titleCase(context?.config.framework) || "Powerlines"}`;
+			}
+		}),
+		createIntrinsic("hbr", {}),
+		createComponent(SingleLineComment, {
+			variant: "markdown",
+			children: code`NOTE: Do not edit this file manually - it will be overwritten automatically by the "prepare" command`
+		}),
+		createIntrinsic("hbr", {})
+	];
+}
+
+//#endregion
+export { MarkdownFile };