@powerlines/plugin-alloy 0.18.119 → 0.19.0

package/dist/core/components/index.cjs

@@ -1,7 +1,7 @@
-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_output = require('./output.cjs');
+const require_single_line_comment = require('./single-line-comment.cjs');
+const require_source_file = require('./source-file.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.Output = require_output.Output;
+exports.SingleLineComment = require_single_line_comment.SingleLineComment;
+exports.SourceFile = require_source_file.SourceFile;

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

@@ -1,10 +1,10 @@
 import { MetaItem } from "../contexts/context.cjs";
-import * as _alloy_js_core7 from "@alloy-js/core";
-import { OutputProps as OutputProps$1 } from "@alloy-js/core";
+import * as _alloy_js_core0 from "@alloy-js/core";
+import { OutputProps } 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 {
+interface OutputProps$1<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>> extends OutputProps {
   /**
    * The current Powerlines process context.
    */
@@ -17,7 +17,7 @@ interface OutputProps<TContext extends PluginContext = PluginContext, TMeta exte
 /**
  * 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_core7.Children;
+declare function Output<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(props: OutputProps$1<TContext, TMeta>): _alloy_js_core0.Children;
 declare type __ΩOutputProps = any[];
 //#endregion
-export { Output, OutputProps, __ΩOutputProps };
+export { Output, OutputProps$1 as OutputProps, __ΩOutputProps };

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

@@ -1,10 +1,10 @@
 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 * as _alloy_js_core0 from "@alloy-js/core";
+import { OutputProps } 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 {
+interface OutputProps$1<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>> extends OutputProps {
   /**
    * The current Powerlines process context.
    */
@@ -17,7 +17,7 @@ interface OutputProps<TContext extends PluginContext = PluginContext, TMeta exte
 /**
  * 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 function Output$1<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(props: OutputProps$1<TContext, TMeta>): _alloy_js_core0.Children;
 declare type __ΩOutputProps = any[];
 //#endregion
-export { Output, OutputProps, __ΩOutputProps };
+export { Output$1 as Output, OutputProps$1 as OutputProps, __ΩOutputProps };

package/dist/core/components/output.mjs

@@ -1,19 +1,19 @@
 import { createComponent, mergeProps } from "@alloy-js/core/jsx-runtime";
-import { Output as Output$1, Show, computed, splitProps } from "@alloy-js/core";
+import { Output, 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) {
+function Output$1(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, {
+	return createComponent(Output, mergeProps(rest, {
 		get basePath() {
 			return basePathRef.value;
 		},
@@ -29,4 +29,4 @@ function Output(props) {
 }
 
 //#endregion
-export { Output };
+export { Output$1 as Output };

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

@@ -1,5 +1,5 @@
 import { ComponentProps } from "../../types/components.cjs";
-import * as _alloy_js_core8 from "@alloy-js/core";
+import * as _alloy_js_core1 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";
@@ -15,7 +15,7 @@ interface SingleLineCommentProps extends ComponentProps {
  * 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_core8.Children;
+declare function SingleLineComment(props: SingleLineCommentProps): _alloy_js_core1.Children;
 declare type __ΩSingleLineCommentVariant = any[];
 declare type __ΩSingleLineCommentProps = any[];
 //#endregion

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

@@ -1,5 +1,5 @@
 import { ComponentProps } from "../../types/components.mjs";
-import * as _alloy_js_core0 from "@alloy-js/core";
+import * as _alloy_js_core1 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";
@@ -15,7 +15,7 @@ interface SingleLineCommentProps extends ComponentProps {
  * 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 function SingleLineComment(props: SingleLineCommentProps): _alloy_js_core1.Children;
 declare type __ΩSingleLineCommentVariant = any[];
 declare type __ΩSingleLineCommentProps = any[];
 //#endregion

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

@@ -1,10 +1,10 @@
 import { ComponentProps } from "../../types/components.cjs";
-import * as _alloy_js_core4 from "@alloy-js/core";
-import { SourceFileProps as SourceFileProps$1 } from "@alloy-js/core";
+import * as _alloy_js_core0 from "@alloy-js/core";
+import { SourceFileProps } from "@alloy-js/core";
 import { StoragePreset } from "powerlines/types/fs";
 
 //#region src/core/components/source-file.d.ts
-type SourceFileProps = SourceFileProps$1 & ComponentProps & {
+type SourceFileProps$1 = SourceFileProps & ComponentProps & {
   /**
    * The storage preset for the output files.
    *
@@ -26,7 +26,7 @@ type SourceFileProps = SourceFileProps$1 & ComponentProps & {
  * @param props - The properties for the source file.
  * @returns The rendered source file component.
  */
-declare function SourceFile(props: SourceFileProps): _alloy_js_core4.Children;
+declare function SourceFile(props: SourceFileProps$1): _alloy_js_core0.Children;
 declare type __ΩSourceFileProps = any[];
 //#endregion
-export { SourceFile, SourceFileProps, __ΩSourceFileProps };
+export { SourceFile, SourceFileProps$1 as SourceFileProps, __ΩSourceFileProps };

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

@@ -1,10 +1,10 @@
 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 { SourceFileProps } from "@alloy-js/core";
 import { StoragePreset } from "powerlines/types/fs";
 
 //#region src/core/components/source-file.d.ts
-type SourceFileProps = SourceFileProps$1 & ComponentProps & {
+type SourceFileProps$1 = SourceFileProps & ComponentProps & {
   /**
    * The storage preset for the output files.
    *
@@ -26,7 +26,7 @@ type SourceFileProps = SourceFileProps$1 & ComponentProps & {
  * @param props - The properties for the source file.
  * @returns The rendered source file component.
  */
-declare function SourceFile(props: SourceFileProps): _alloy_js_core0.Children;
+declare function SourceFile(props: SourceFileProps$1): _alloy_js_core0.Children;
 declare type __ΩSourceFileProps = any[];
 //#endregion
-export { SourceFile, SourceFileProps, __ΩSourceFileProps };
+export { SourceFile, SourceFileProps$1 as SourceFileProps, __ΩSourceFileProps };

package/dist/core/contexts/context.cjs

@@ -7,15 +7,15 @@ const require_unctx = require('../../internal/unctx.cjs');
 * @returns The Context.
 */
 function usePowerlinesContext() {
-	return require_unctx.unctx.use();
+	return require_unctx.unctx.tryUse();
 }
 /**
 * Hook to safely access the {@link PluginContext | Powerlines context}.
 *
-* @returns The Powerlines context or undefined if not set.
+* @returns The Powerlines context or null if not set.
 */
 function usePowerlinesSafe() {
-	return usePowerlinesContext()?.value;
+	return usePowerlinesContext()?.value ?? null;
 }
 /**
 * Hook to access the {@link PluginContext | Powerlines context}.
@@ -30,10 +30,10 @@ function usePowerlines() {
 /**
 * Hook to safely access the render context's metadata.
 *
-* @returns The Powerlines context or undefined if not set.
+* @returns The Powerlines context or null if not set.
 */
 function useMetaSafe() {
-	return usePowerlinesContext()?.meta;
+	return usePowerlinesContext()?.meta ?? null;
 }
 /**
 * Hook to access the render context's metadata.

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

@@ -35,13 +35,13 @@ interface PowerlinesContextInterface<TContext extends PluginContext = PluginCont
  *
  * @returns The Context.
  */
-declare function usePowerlinesContext<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): PowerlinesContextInterface<TContext, TMeta> | undefined;
+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 undefined if not set.
+ * @returns The Powerlines context or null if not set.
  */
-declare function usePowerlinesSafe<TContext extends PluginContext = PluginContext>(): TContext | undefined;
+declare function usePowerlinesSafe<TContext extends PluginContext = PluginContext>(): TContext | null;
 /**
  * Hook to access the {@link PluginContext | Powerlines context}.
  *
@@ -51,9 +51,9 @@ declare function usePowerlines<TContext extends PluginContext = PluginContext>()
 /**
  * Hook to safely access the render context's metadata.
  *
- * @returns The Powerlines context or undefined if not set.
+ * @returns The Powerlines context or null if not set.
  */
-declare function useMetaSafe<TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): TMeta | undefined;
+declare function useMetaSafe<TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): TMeta | null;
 /**
  * Hook to access the render context's metadata.
  *

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

@@ -35,13 +35,13 @@ interface PowerlinesContextInterface<TContext extends PluginContext = PluginCont
  *
  * @returns The Context.
  */
-declare function usePowerlinesContext<TContext extends PluginContext = PluginContext, TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): PowerlinesContextInterface<TContext, TMeta> | undefined;
+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 undefined if not set.
+ * @returns The Powerlines context or null if not set.
  */
-declare function usePowerlinesSafe<TContext extends PluginContext = PluginContext>(): TContext | undefined;
+declare function usePowerlinesSafe<TContext extends PluginContext = PluginContext>(): TContext | null;
 /**
  * Hook to access the {@link PluginContext | Powerlines context}.
  *
@@ -51,9 +51,9 @@ declare function usePowerlines<TContext extends PluginContext = PluginContext>()
 /**
  * Hook to safely access the render context's metadata.
  *
- * @returns The Powerlines context or undefined if not set.
+ * @returns The Powerlines context or null if not set.
  */
-declare function useMetaSafe<TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): TMeta | undefined;
+declare function useMetaSafe<TMeta extends Record<string, MetaItem> = Record<string, MetaItem>>(): TMeta | null;
 /**
  * Hook to access the render context's metadata.
  *

package/dist/core/contexts/context.mjs

@@ -7,15 +7,15 @@ import { unctx } from "../../internal/unctx.mjs";
 * @returns The Context.
 */
 function usePowerlinesContext() {
-	return unctx.use();
+	return unctx.tryUse();
 }
 /**
 * Hook to safely access the {@link PluginContext | Powerlines context}.
 *
-* @returns The Powerlines context or undefined if not set.
+* @returns The Powerlines context or null if not set.
 */
 function usePowerlinesSafe() {
-	return usePowerlinesContext()?.value;
+	return usePowerlinesContext()?.value ?? null;
 }
 /**
 * Hook to access the {@link PluginContext | Powerlines context}.
@@ -30,10 +30,10 @@ function usePowerlines() {
 /**
 * Hook to safely access the render context's metadata.
 *
-* @returns The Powerlines context or undefined if not set.
+* @returns The Powerlines context or null if not set.
 */
 function useMetaSafe() {
-	return usePowerlinesContext()?.meta;
+	return usePowerlinesContext()?.meta ?? null;
 }
 /**
 * Hook to access the render context's metadata.

package/dist/core/index.cjs

@@ -1,18 +1,18 @@
-const require_core_components_output = require('./components/output.cjs');
-const require_core_components_single_line_comment = require('./components/single-line-comment.cjs');
+const require_output = require('./components/output.cjs');
+const require_single_line_comment = require('./components/single-line-comment.cjs');
 const require_core_contexts_context = require('./contexts/context.cjs');
 const require_core_contexts_reflection = require('./contexts/reflection.cjs');
 require('./contexts/index.cjs');
-const require_core_components_source_file = require('./components/source-file.cjs');
+const require_source_file = require('./components/source-file.cjs');
 require('./components/index.cjs');
 
-exports.Output = require_core_components_output.Output;
+exports.Output = require_output.Output;
 exports.ReflectionClassContext = require_core_contexts_reflection.ReflectionClassContext;
 exports.ReflectionMethodContext = require_core_contexts_reflection.ReflectionMethodContext;
 exports.ReflectionParameterContext = require_core_contexts_reflection.ReflectionParameterContext;
 exports.ReflectionPropertyContext = require_core_contexts_reflection.ReflectionPropertyContext;
-exports.SingleLineComment = require_core_components_single_line_comment.SingleLineComment;
-exports.SourceFile = require_core_components_source_file.SourceFile;
+exports.SingleLineComment = require_single_line_comment.SingleLineComment;
+exports.SourceFile = require_source_file.SourceFile;
 exports.useMeta = require_core_contexts_context.useMeta;
 exports.useMetaSafe = require_core_contexts_context.useMetaSafe;
 exports.usePowerlines = require_core_contexts_context.usePowerlines;

package/dist/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
-const require_core_components_output = require('./core/components/output.cjs');
+const require_output = require('./core/components/output.cjs');
 const require_unctx = require('./internal/unctx.cjs');
 let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let __alloy_js_babel_preset = require("@alloy-js/babel-preset");
@@ -58,44 +58,44 @@ const plugin = (options = {}) => {
 				async handler() {
 					this.debug("Attaching the `render` method to the context object.");
 					this.render = async (children) => {
+						const _self$ = this;
 						const meta = {};
-						await require_unctx.unctx.callAsync({
+						require_unctx.unctx.set({
 							value: this,
 							meta
-						}, async () => {
-							const _self$ = this;
-							await (0, __alloy_js_core.traverseOutput)(await (0, __alloy_js_core.renderAsync)((0, __alloy_js_core_jsx_runtime.createComponent)(require_core_components_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, {
-												skipFormat: metadata.skipFormat,
-												storage: metadata.storage,
-												extension: (0, __stryke_path_file_path_fns.findFileExtension)(file.path)
-											});
-										} else if (metadata.kind === "entry") this.emitEntrySync(file.contents, file.path, {
+						});
+						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, {
 											skipFormat: metadata.skipFormat,
 											storage: metadata.storage,
-											...metadata.typeDefinition ?? {}
+											extension: (0, __stryke_path_file_path_fns.findFileExtension)(file.path)
 										});
-										else this.emitSync(file.contents, file.path, metadata);
-									} else this.fs.copySync(file.sourcePath, file.path);
-								}
-							});
+									} 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);
+							}
 						});
+						require_unctx.unctx.unset();
 					};
 				}
 			}

package/dist/index.mjs

@@ -54,44 +54,44 @@ const plugin = (options = {}) => {
 				async handler() {
 					this.debug("Attaching the `render` method to the context object.");
 					this.render = async (children) => {
+						const _self$ = this;
 						const meta = {};
-						await unctx.callAsync({
+						unctx.set({
 							value: this,
 							meta
-						}, async () => {
-							const _self$ = this;
-							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, {
-												skipFormat: metadata.skipFormat,
-												storage: metadata.storage,
-												extension: findFileExtension(file.path)
-											});
-										} else if (metadata.kind === "entry") this.emitEntrySync(file.contents, file.path, {
+						});
+						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, {
 											skipFormat: metadata.skipFormat,
 											storage: metadata.storage,
-											...metadata.typeDefinition ?? {}
+											extension: findFileExtension(file.path)
 										});
-										else this.emitSync(file.contents, file.path, metadata);
-									} else this.fs.copySync(file.sourcePath, file.path);
-								}
-							});
+									} 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);
+							}
 						});
+						unctx.unset();
 					};
 				}
 			}

package/dist/internal/unctx.cjs

@@ -1,12 +1,8 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
-let node_async_hooks = require("node:async_hooks");
 let unctx = require("unctx");
 
 //#region src/internal/unctx.ts
-const unctx$1 = (0, unctx.createContext)({
-	asyncContext: true,
-	AsyncLocalStorage: node_async_hooks.AsyncLocalStorage
-});
+const unctx$1 = (0, unctx.createContext)();
 
 //#endregion
 exports.unctx = unctx$1;

package/dist/internal/unctx.mjs

@@ -1,11 +1,7 @@
-import { AsyncLocalStorage } from "node:async_hooks";
 import { createContext } from "unctx";
 
 //#region src/internal/unctx.ts
-const unctx = createContext({
-	asyncContext: true,
-	AsyncLocalStorage
-});
+const unctx = createContext();
 
 //#endregion
 export { unctx };

package/dist/markdown/components/front-matter.cjs

@@ -0,0 +1,28 @@
+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 src/markdown/components/front-matter.tsx
+/**
+* Renders YAML front matter for a markdown file.
+*
+* @see https://jekyllrb.com/docs/front-matter/
+*/
+function FrontMatter(props) {
+	return [
+		"---",
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+			get each() {
+				return Object.entries(props.data);
+			},
+			hardline: true,
+			children: ([key, value]) => __alloy_js_core.code`${key}: ${JSON.stringify(value)}`
+		}),
+		"---",
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})
+	];
+}
+
+//#endregion
+exports.FrontMatter = FrontMatter;

package/dist/markdown/components/front-matter.d.cts

@@ -0,0 +1,15 @@
+import * as _alloy_js_core2 from "@alloy-js/core";
+
+//#region src/markdown/components/front-matter.d.ts
+interface FrontMatterProps {
+  data: Record<string, any>;
+}
+/**
+ * Renders YAML front matter for a markdown file.
+ *
+ * @see https://jekyllrb.com/docs/front-matter/
+ */
+declare function FrontMatter(props: FrontMatterProps): _alloy_js_core2.Children;
+declare type __ΩFrontMatterProps = any[];
+//#endregion
+export { FrontMatter, FrontMatterProps, __ΩFrontMatterProps };

package/dist/markdown/components/front-matter.d.mts

@@ -0,0 +1,15 @@
+import * as _alloy_js_core5 from "@alloy-js/core";
+
+//#region src/markdown/components/front-matter.d.ts
+interface FrontMatterProps {
+  data: Record<string, any>;
+}
+/**
+ * Renders YAML front matter for a markdown file.
+ *
+ * @see https://jekyllrb.com/docs/front-matter/
+ */
+declare function FrontMatter(props: FrontMatterProps): _alloy_js_core5.Children;
+declare type __ΩFrontMatterProps = any[];
+//#endregion
+export { FrontMatter, FrontMatterProps, __ΩFrontMatterProps };

package/dist/markdown/components/front-matter.mjs

@@ -0,0 +1,27 @@
+import { createComponent, createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { For, code } from "@alloy-js/core";
+
+//#region src/markdown/components/front-matter.tsx
+/**
+* Renders YAML front matter for a markdown file.
+*
+* @see https://jekyllrb.com/docs/front-matter/
+*/
+function FrontMatter(props) {
+	return [
+		"---",
+		createIntrinsic("hbr", {}),
+		createComponent(For, {
+			get each() {
+				return Object.entries(props.data);
+			},
+			hardline: true,
+			children: ([key, value]) => code`${key}: ${JSON.stringify(value)}`
+		}),
+		"---",
+		createIntrinsic("hbr", {})
+	];
+}
+
+//#endregion
+export { FrontMatter };

package/dist/markdown/components/index.cjs

@@ -1,8 +1,10 @@
-const require_markdown_components_markdown_file = require('./markdown-file.cjs');
-const require_markdown_components_markdown_table = require('./markdown-table.cjs');
+const require_front_matter = require('./front-matter.cjs');
+const require_markdown_file = require('./markdown-file.cjs');
+const require_markdown_table = require('./markdown-table.cjs');
 
-exports.MarkdownFile = require_markdown_components_markdown_file.MarkdownFile;
-exports.MarkdownFileHeader = require_markdown_components_markdown_file.MarkdownFileHeader;
-exports.MarkdownTable = require_markdown_components_markdown_table.MarkdownTable;
-exports.MarkdownTableColumn = require_markdown_components_markdown_table.MarkdownTableColumn;
-exports.MarkdownTableColumnHeader = require_markdown_components_markdown_table.MarkdownTableColumnHeader;
+exports.FrontMatter = require_front_matter.FrontMatter;
+exports.MarkdownFile = require_markdown_file.MarkdownFile;
+exports.MarkdownFileHeader = require_markdown_file.MarkdownFileHeader;
+exports.MarkdownTable = require_markdown_table.MarkdownTable;
+exports.MarkdownTableColumn = require_markdown_table.MarkdownTableColumn;
+exports.MarkdownTableColumnHeader = require_markdown_table.MarkdownTableColumnHeader;

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

@@ -1,3 +1,4 @@
-import { MarkdownFile, MarkdownFileHeader, MarkdownFileProps, __ΩMarkdownFileProps } from "./markdown-file.cjs";
+import { FrontMatter, FrontMatterProps, __ΩFrontMatterProps } from "./front-matter.cjs";
+import { MarkdownFile, MarkdownFileHeader, MarkdownFileHeaderProps, MarkdownFileProps, __ΩMarkdownFileHeaderProps, __ΩMarkdownFileProps } from "./markdown-file.cjs";
 import { MarkdownTable, MarkdownTableColumn, MarkdownTableColumnHeader, MarkdownTableColumnProps, MarkdownTableProps, __ΩMarkdownTableColumnProps, __ΩMarkdownTableProps } from "./markdown-table.cjs";
-export { MarkdownFile, MarkdownFileHeader, MarkdownFileProps, MarkdownTable, MarkdownTableColumn, MarkdownTableColumnHeader, MarkdownTableColumnProps, MarkdownTableProps, __ΩMarkdownFileProps, __ΩMarkdownTableColumnProps, __ΩMarkdownTableProps };
+export { FrontMatter, FrontMatterProps, MarkdownFile, MarkdownFileHeader, MarkdownFileHeaderProps, MarkdownFileProps, MarkdownTable, MarkdownTableColumn, MarkdownTableColumnHeader, MarkdownTableColumnProps, MarkdownTableProps, __ΩFrontMatterProps, __ΩMarkdownFileHeaderProps, __ΩMarkdownFileProps, __ΩMarkdownTableColumnProps, __ΩMarkdownTableProps };