@prudentbird/voxx-core 1.0.0

package/dist/dev.mjs

@@ -0,0 +1,82 @@
+import { loadConfigEffect } from "./config.mjs";
+import { Effect } from "effect";
+import { NodeContext } from "@effect/platform-node";
+import { existsSync, mkdirSync, readdirSync, watch, writeFileSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+//#region src/dev.ts
+const run = (effect) => Effect.runPromise(Effect.provide(effect, NodeContext.layer));
+const SKIP_DIRS = new Set([
+	"node_modules",
+	".next",
+	".git",
+	".turbo",
+	"dist",
+	"out"
+]);
+const VERSION_FILE = "content-version.ts";
+function writeVersion(file, value) {
+	mkdirSync(dirname(file), { recursive: true });
+	writeFileSync(file, `export const CONTENT_VERSION = ${value};\n`);
+}
+function findVersionModules(root, depth = 6) {
+	const found = [];
+	const walk = (dir, left) => {
+		let entries;
+		try {
+			entries = readdirSync(dir, { withFileTypes: true });
+		} catch {
+			return;
+		}
+		for (const entry of entries) if (entry.isDirectory()) {
+			if (SKIP_DIRS.has(entry.name) || entry.name.startsWith(".")) continue;
+			if (left > 0) walk(join(dir, entry.name), left - 1);
+		} else if (entry.name === VERSION_FILE && basename(dir) === "_voxx") found.push(join(dir, entry.name));
+	};
+	walk(root, depth);
+	return found;
+}
+let registered = false;
+/**
+* Watches content directories and `voxx.json` for changes, then bumps a
+* `CONTENT_VERSION` timestamp in each discovered `_voxx/content-version.ts`
+* file to trigger Next.js hot reload.
+*
+* No-ops outside `NODE_ENV=development` and in non-Node runtimes (e.g. Edge).
+* Safe to call multiple times — only the first call registers watchers.
+*
+* @param opts - Optional cwd, explicit version module paths, and debounce delay.
+*/
+async function registerContentWatcher(opts = {}) {
+	if (process.env["NEXT_RUNTIME"] && process.env["NEXT_RUNTIME"] !== "nodejs") return;
+	if (process.env.NODE_ENV !== "development") return;
+	if (registered) return;
+	registered = true;
+	const cwd = opts.cwd ?? process.cwd();
+	const versionModules = opts.versionModules && opts.versionModules.length > 0 ? opts.versionModules : findVersionModules(cwd);
+	if (versionModules.length === 0) return;
+	const dirs = /* @__PURE__ */ new Set();
+	try {
+		const config = await run(loadConfigEffect({ cwd }));
+		for (const collection of config.collections) dirs.add(collection.dir);
+	} catch {}
+	const paths = new Set([join(cwd, "voxx.json"), ...dirs]);
+	let timer;
+	const bump = () => {
+		clearTimeout(timer);
+		timer = setTimeout(() => {
+			const value = Date.now();
+			for (const file of versionModules) writeVersion(file, value);
+		}, opts.debounceMs ?? 80);
+	};
+	const watchers = [];
+	for (const path of paths) {
+		if (!existsSync(path)) continue;
+		try {
+			watchers.push(watch(path, { recursive: true }, bump));
+		} catch {}
+	}
+}
+//#endregion
+export { registerContentWatcher };
+
+//# sourceMappingURL=dev.mjs.map

package/dist/dev.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.mjs","names":[],"sources":["../src/dev.ts"],"sourcesContent":["import {\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  watch,\n  writeFileSync,\n  type Dirent,\n  type FSWatcher,\n} from \"node:fs\";\nimport { basename, dirname, join } from \"node:path\";\nimport { Effect } from \"effect\";\nimport { FileSystem, Path } from \"@effect/platform\";\nimport { NodeContext } from \"@effect/platform-node\";\nimport { loadConfigEffect } from \"./config\";\n\ntype Services = FileSystem.FileSystem | Path.Path;\n\nconst run = <A, E>(effect: Effect.Effect<A, E, Services>): Promise<A> =>\n  Effect.runPromise(Effect.provide(effect, NodeContext.layer));\n\n/** Options for `registerContentWatcher`. */\nexport interface ContentWatcherOptions {\n  /** Working directory used to locate `voxx.json` and content dirs. Defaults to `process.cwd()`. */\n  cwd?: string;\n  /** Explicit paths to `content-version.ts` files to bump on change. Auto-discovered when omitted. */\n  versionModules?: string[];\n  /** Milliseconds to wait before writing after the last change event. Defaults to `80`. */\n  debounceMs?: number;\n}\n\nconst SKIP_DIRS = new Set([\n  \"node_modules\",\n  \".next\",\n  \".git\",\n  \".turbo\",\n  \"dist\",\n  \"out\",\n]);\nconst VERSION_FILE = \"content-version.ts\";\n\nfunction writeVersion(file: string, value: number): void {\n  mkdirSync(dirname(file), { recursive: true });\n  writeFileSync(file, `export const CONTENT_VERSION = ${value};\\n`);\n}\n\nfunction findVersionModules(root: string, depth = 6): string[] {\n  const found: string[] = [];\n  const walk = (dir: string, left: number): void => {\n    let entries: Dirent<string>[];\n    try {\n      entries = readdirSync(dir, { withFileTypes: true });\n    } catch {\n      return;\n    }\n    for (const entry of entries) {\n      if (entry.isDirectory()) {\n        if (SKIP_DIRS.has(entry.name) || entry.name.startsWith(\".\")) continue;\n        if (left > 0) walk(join(dir, entry.name), left - 1);\n      } else if (entry.name === VERSION_FILE && basename(dir) === \"_voxx\") {\n        found.push(join(dir, entry.name));\n      }\n    }\n  };\n  walk(root, depth);\n  return found;\n}\n\nlet registered = false;\n\n/**\n * Watches content directories and `voxx.json` for changes, then bumps a\n * `CONTENT_VERSION` timestamp in each discovered `_voxx/content-version.ts`\n * file to trigger Next.js hot reload.\n *\n * No-ops outside `NODE_ENV=development` and in non-Node runtimes (e.g. Edge).\n * Safe to call multiple times — only the first call registers watchers.\n *\n * @param opts - Optional cwd, explicit version module paths, and debounce delay.\n */\nexport async function registerContentWatcher(\n  opts: ContentWatcherOptions = {},\n): Promise<void> {\n  if (process.env[\"NEXT_RUNTIME\"] && process.env[\"NEXT_RUNTIME\"] !== \"nodejs\") {\n    return;\n  }\n  if (process.env.NODE_ENV !== \"development\") return;\n  if (registered) return;\n  registered = true;\n\n  const cwd = opts.cwd ?? process.cwd();\n\n  const versionModules =\n    opts.versionModules && opts.versionModules.length > 0\n      ? opts.versionModules\n      : findVersionModules(cwd);\n  if (versionModules.length === 0) return;\n\n  const dirs = new Set<string>();\n  try {\n    const config = await run(loadConfigEffect({ cwd }));\n    for (const collection of config.collections) dirs.add(collection.dir);\n  } catch {}\n\n  const paths = new Set<string>([join(cwd, \"voxx.json\"), ...dirs]);\n\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const bump = () => {\n    clearTimeout(timer);\n    timer = setTimeout(() => {\n      const value = Date.now();\n      for (const file of versionModules) writeVersion(file, value);\n    }, opts.debounceMs ?? 80);\n  };\n\n  const watchers: FSWatcher[] = [];\n  for (const path of paths) {\n    if (!existsSync(path)) continue;\n    try {\n      watchers.push(watch(path, { recursive: true }, bump));\n    } catch {}\n  }\n}\n"],"mappings":";;;;;;AAiBA,MAAM,OAAa,WACjB,OAAO,WAAW,OAAO,QAAQ,QAAQ,YAAY,KAAK,CAAC;AAY7D,MAAM,YAAY,IAAI,IAAI;CACxB;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AACD,MAAM,eAAe;AAErB,SAAS,aAAa,MAAc,OAAqB;CACvD,UAAU,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;CAC5C,cAAc,MAAM,kCAAkC,MAAM,IAAI;AAClE;AAEA,SAAS,mBAAmB,MAAc,QAAQ,GAAa;CAC7D,MAAM,QAAkB,CAAC;CACzB,MAAM,QAAQ,KAAa,SAAuB;EAChD,IAAI;EACJ,IAAI;GACF,UAAU,YAAY,KAAK,EAAE,eAAe,KAAK,CAAC;EACpD,QAAQ;GACN;EACF;EACA,KAAK,MAAM,SAAS,SAClB,IAAI,MAAM,YAAY,GAAG;GACvB,IAAI,UAAU,IAAI,MAAM,IAAI,KAAK,MAAM,KAAK,WAAW,GAAG,GAAG;GAC7D,IAAI,OAAO,GAAG,KAAK,KAAK,KAAK,MAAM,IAAI,GAAG,OAAO,CAAC;EACpD,OAAO,IAAI,MAAM,SAAS,gBAAgB,SAAS,GAAG,MAAM,SAC1D,MAAM,KAAK,KAAK,KAAK,MAAM,IAAI,CAAC;CAGtC;CACA,KAAK,MAAM,KAAK;CAChB,OAAO;AACT;AAEA,IAAI,aAAa;;;;;;;;;;;AAYjB,eAAsB,uBACpB,OAA8B,CAAC,GAChB;CACf,IAAI,QAAQ,IAAI,mBAAmB,QAAQ,IAAI,oBAAoB,UACjE;CAEF,IAAI,QAAQ,IAAI,aAAa,eAAe;CAC5C,IAAI,YAAY;CAChB,aAAa;CAEb,MAAM,MAAM,KAAK,OAAO,QAAQ,IAAI;CAEpC,MAAM,iBACJ,KAAK,kBAAkB,KAAK,eAAe,SAAS,IAChD,KAAK,iBACL,mBAAmB,GAAG;CAC5B,IAAI,eAAe,WAAW,GAAG;CAEjC,MAAM,uBAAO,IAAI,IAAY;CAC7B,IAAI;EACF,MAAM,SAAS,MAAM,IAAI,iBAAiB,EAAE,IAAI,CAAC,CAAC;EAClD,KAAK,MAAM,cAAc,OAAO,aAAa,KAAK,IAAI,WAAW,GAAG;CACtE,QAAQ,CAAC;CAET,MAAM,QAAQ,IAAI,IAAY,CAAC,KAAK,KAAK,WAAW,GAAG,GAAG,IAAI,CAAC;CAE/D,IAAI;CACJ,MAAM,aAAa;EACjB,aAAa,KAAK;EAClB,QAAQ,iBAAiB;GACvB,MAAM,QAAQ,KAAK,IAAI;GACvB,KAAK,MAAM,QAAQ,gBAAgB,aAAa,MAAM,KAAK;EAC7D,GAAG,KAAK,cAAc,EAAE;CAC1B;CAEA,MAAM,WAAwB,CAAC;CAC/B,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,CAAC,WAAW,IAAI,GAAG;EACvB,IAAI;GACF,SAAS,KAAK,MAAM,MAAM,EAAE,WAAW,KAAK,GAAG,IAAI,CAAC;EACtD,QAAQ,CAAC;CACX;AACF"}

package/dist/effect.cjs

@@ -0,0 +1,23 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_schema = require("./schema.cjs");
+const require_errors = require("./errors.cjs");
+const require_types = require("./types.cjs");
+const require_config = require("./config.cjs");
+const require_frontmatter = require("./frontmatter.cjs");
+const require_render = require("./render.cjs");
+const require_content = require("./content.cjs");
+exports.ConfigError = require_errors.ConfigError;
+exports.ConfigInput = require_schema.ConfigInput;
+exports.ContentDirMissing = require_errors.ContentDirMissing;
+exports.DEFAULT_CONFIG = require_types.DEFAULT_CONFIG;
+exports.Frontmatter = require_schema.Frontmatter;
+exports.InvalidFrontmatter = require_errors.InvalidFrontmatter;
+exports.PostNotFound = require_errors.PostNotFound;
+exports.RenderError = require_errors.RenderError;
+exports.findPost = require_content.findPost;
+exports.getPostEffect = require_content.getPostEffect;
+exports.getPostsEffect = require_content.getPostsEffect;
+exports.loadConfigEffect = require_config.loadConfigEffect;
+exports.parseFrontmatter = require_frontmatter.parseFrontmatter;
+exports.renderMarkdownEffect = require_render.renderMarkdownEffect;
+exports.resolveConfig = require_config.resolveConfig;

package/dist/effect.d.cts

@@ -0,0 +1,8 @@
+import { ConfigError, ContentDirMissing, InvalidFrontmatter, PostNotFound, RenderError, VoxxError } from "./errors.cjs";
+import { ConfigInput, Frontmatter, FrontmatterData, VoxxConfigInput } from "./schema.cjs";
+import { CollectionConfig, ContentType, DEFAULT_CONFIG, NavNode, Post, SeoData, TocItem, VoxxAuthor, VoxxConfig } from "./types.cjs";
+import { LoadConfigOptions, loadConfigEffect, resolveConfig } from "./config.cjs";
+import { GetPostsEffectOptions, findPost, getPostEffect, getPostsEffect } from "./content.cjs";
+import { RenderResult, renderMarkdownEffect } from "./render.cjs";
+import { ParsedFile, parseFrontmatter } from "./frontmatter.cjs";
+export { type CollectionConfig, ConfigError, ConfigInput, ContentDirMissing, type ContentType, DEFAULT_CONFIG, Frontmatter, type FrontmatterData, type GetPostsEffectOptions, InvalidFrontmatter, type LoadConfigOptions, type NavNode, type ParsedFile, type Post, PostNotFound, RenderError, type RenderResult, type SeoData, type TocItem, type VoxxAuthor, type VoxxConfig, type VoxxConfigInput, VoxxError, findPost, getPostEffect, getPostsEffect, loadConfigEffect, parseFrontmatter, renderMarkdownEffect, resolveConfig };

package/dist/effect.d.mts

@@ -0,0 +1,8 @@
+import { ConfigError, ContentDirMissing, InvalidFrontmatter, PostNotFound, RenderError, VoxxError } from "./errors.mjs";
+import { ConfigInput, Frontmatter, FrontmatterData, VoxxConfigInput } from "./schema.mjs";
+import { CollectionConfig, ContentType, DEFAULT_CONFIG, NavNode, Post, SeoData, TocItem, VoxxAuthor, VoxxConfig } from "./types.mjs";
+import { LoadConfigOptions, loadConfigEffect, resolveConfig } from "./config.mjs";
+import { GetPostsEffectOptions, findPost, getPostEffect, getPostsEffect } from "./content.mjs";
+import { RenderResult, renderMarkdownEffect } from "./render.mjs";
+import { ParsedFile, parseFrontmatter } from "./frontmatter.mjs";
+export { type CollectionConfig, ConfigError, ConfigInput, ContentDirMissing, type ContentType, DEFAULT_CONFIG, Frontmatter, type FrontmatterData, type GetPostsEffectOptions, InvalidFrontmatter, type LoadConfigOptions, type NavNode, type ParsedFile, type Post, PostNotFound, RenderError, type RenderResult, type SeoData, type TocItem, type VoxxAuthor, type VoxxConfig, type VoxxConfigInput, VoxxError, findPost, getPostEffect, getPostsEffect, loadConfigEffect, parseFrontmatter, renderMarkdownEffect, resolveConfig };

package/dist/effect.mjs

@@ -0,0 +1,8 @@
+import { ConfigInput, Frontmatter } from "./schema.mjs";
+import { ConfigError, ContentDirMissing, InvalidFrontmatter, PostNotFound, RenderError } from "./errors.mjs";
+import { DEFAULT_CONFIG } from "./types.mjs";
+import { loadConfigEffect, resolveConfig } from "./config.mjs";
+import { parseFrontmatter } from "./frontmatter.mjs";
+import { renderMarkdownEffect } from "./render.mjs";
+import { findPost, getPostEffect, getPostsEffect } from "./content.mjs";
+export { ConfigError, ConfigInput, ContentDirMissing, DEFAULT_CONFIG, Frontmatter, InvalidFrontmatter, PostNotFound, RenderError, findPost, getPostEffect, getPostsEffect, loadConfigEffect, parseFrontmatter, renderMarkdownEffect, resolveConfig };

package/dist/errors.cjs

@@ -0,0 +1,20 @@
+let effect = require("effect");
+//#region src/errors.ts
+/** Thrown when `voxx.json` is missing, unreadable, or fails schema validation. */
+var ConfigError = class extends effect.Data.TaggedError("ConfigError") {};
+/** Thrown when a Markdown file's frontmatter cannot be parsed or is invalid. */
+var InvalidFrontmatter = class extends effect.Data.TaggedError("InvalidFrontmatter") {};
+/** Thrown when a requested slug does not match any loaded post. */
+var PostNotFound = class extends effect.Data.TaggedError("PostNotFound") {};
+/** Thrown when the configured content directory does not exist. */
+var ContentDirMissing = class extends effect.Data.TaggedError("ContentDirMissing") {};
+/** Thrown when the Markdown-to-HTML pipeline fails. */
+var RenderError = class extends effect.Data.TaggedError("RenderError") {};
+//#endregion
+exports.ConfigError = ConfigError;
+exports.ContentDirMissing = ContentDirMissing;
+exports.InvalidFrontmatter = InvalidFrontmatter;
+exports.PostNotFound = PostNotFound;
+exports.RenderError = RenderError;
+
+//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","names":["Data"],"sources":["../src/errors.ts"],"sourcesContent":["import { Data } from \"effect\";\n\n/** Thrown when `voxx.json` is missing, unreadable, or fails schema validation. */\nexport class ConfigError extends Data.TaggedError(\"ConfigError\")<{\n  readonly message: string;\n  readonly cause?: unknown;\n}> {}\n\n/** Thrown when a Markdown file's frontmatter cannot be parsed or is invalid. */\nexport class InvalidFrontmatter extends Data.TaggedError(\"InvalidFrontmatter\")<{\n  readonly file: string;\n  readonly message: string;\n  readonly cause?: unknown;\n}> {}\n\n/** Thrown when a requested slug does not match any loaded post. */\nexport class PostNotFound extends Data.TaggedError(\"PostNotFound\")<{\n  readonly slug: string;\n}> {}\n\n/** Thrown when the configured content directory does not exist. */\nexport class ContentDirMissing extends Data.TaggedError(\"ContentDirMissing\")<{\n  readonly dir: string;\n}> {}\n\n/** Thrown when the Markdown-to-HTML pipeline fails. */\nexport class RenderError extends Data.TaggedError(\"RenderError\")<{\n  readonly message: string;\n  readonly cause?: unknown;\n}> {}\n\n/** Union of all typed errors that Voxx can surface. */\nexport type VoxxError =\n  | ConfigError\n  | InvalidFrontmatter\n  | PostNotFound\n  | ContentDirMissing\n  | RenderError;\n"],"mappings":";;;AAGA,IAAa,cAAb,cAAiCA,OAAAA,KAAK,YAAY,aAAa,CAAC,CAG7D,CAAC;;AAGJ,IAAa,qBAAb,cAAwCA,OAAAA,KAAK,YAAY,oBAAoB,CAAC,CAI3E,CAAC;;AAGJ,IAAa,eAAb,cAAkCA,OAAAA,KAAK,YAAY,cAAc,CAAC,CAE/D,CAAC;;AAGJ,IAAa,oBAAb,cAAuCA,OAAAA,KAAK,YAAY,mBAAmB,CAAC,CAEzE,CAAC;;AAGJ,IAAa,cAAb,cAAiCA,OAAAA,KAAK,YAAY,aAAa,CAAC,CAG7D,CAAC"}

package/dist/errors.d.cts

@@ -0,0 +1,45 @@
+//#region src/errors.d.ts
+declare const ConfigError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "ConfigError";
+} & Readonly<A>;
+/** Thrown when `voxx.json` is missing, unreadable, or fails schema validation. */
+declare class ConfigError extends ConfigError_base<{
+  readonly message: string;
+  readonly cause?: unknown;
+}> {}
+declare const InvalidFrontmatter_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "InvalidFrontmatter";
+} & Readonly<A>;
+/** Thrown when a Markdown file's frontmatter cannot be parsed or is invalid. */
+declare class InvalidFrontmatter extends InvalidFrontmatter_base<{
+  readonly file: string;
+  readonly message: string;
+  readonly cause?: unknown;
+}> {}
+declare const PostNotFound_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "PostNotFound";
+} & Readonly<A>;
+/** Thrown when a requested slug does not match any loaded post. */
+declare class PostNotFound extends PostNotFound_base<{
+  readonly slug: string;
+}> {}
+declare const ContentDirMissing_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "ContentDirMissing";
+} & Readonly<A>;
+/** Thrown when the configured content directory does not exist. */
+declare class ContentDirMissing extends ContentDirMissing_base<{
+  readonly dir: string;
+}> {}
+declare const RenderError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "RenderError";
+} & Readonly<A>;
+/** Thrown when the Markdown-to-HTML pipeline fails. */
+declare class RenderError extends RenderError_base<{
+  readonly message: string;
+  readonly cause?: unknown;
+}> {}
+/** Union of all typed errors that Voxx can surface. */
+type VoxxError = ConfigError | InvalidFrontmatter | PostNotFound | ContentDirMissing | RenderError;
+//#endregion
+export { ConfigError, ContentDirMissing, InvalidFrontmatter, PostNotFound, RenderError, VoxxError };
+//# sourceMappingURL=errors.d.cts.map

package/dist/errors.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.cts","names":[],"sources":["../src/errors.ts"],"mappings":";;;;;cAGa,WAAA,SAAoB,gBAAA;EAAA,SACtB,OAAA;EAAA,SACA,KAAA;AAAA;AAAA,cACN,uBAAA;;;;cAGQ,kBAAA,SAA2B,uBAAA;EAAA,SAC7B,IAAA;EAAA,SACA,OAAA;EAAA,SACA,KAAA;AAAA;AAAA,cACN,iBAAA;;;;cAGQ,YAAA,SAAqB,iBAAA;EAAA,SACvB,IAAI;AAAA;AAAA,cACV,sBAAA;;;AAfL;AAAA,cAkBa,iBAAA,SAA0B,sBAAA;EAAA,SAC5B,GAAG;AAAA;AAAA,cACT,gBAAA;;;AAlBW;AAAA,cAqBH,WAAA,SAAoB,gBAAA;EAAA,SACtB,OAAA;EAAA,SACA,KAAA;AAAA;;KAIC,SAAA,GACR,WAAA,GACA,kBAAA,GACA,YAAA,GACA,iBAAA,GACA,WAAA"}

package/dist/errors.d.mts

@@ -0,0 +1,45 @@
+//#region src/errors.d.ts
+declare const ConfigError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "ConfigError";
+} & Readonly<A>;
+/** Thrown when `voxx.json` is missing, unreadable, or fails schema validation. */
+declare class ConfigError extends ConfigError_base<{
+  readonly message: string;
+  readonly cause?: unknown;
+}> {}
+declare const InvalidFrontmatter_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "InvalidFrontmatter";
+} & Readonly<A>;
+/** Thrown when a Markdown file's frontmatter cannot be parsed or is invalid. */
+declare class InvalidFrontmatter extends InvalidFrontmatter_base<{
+  readonly file: string;
+  readonly message: string;
+  readonly cause?: unknown;
+}> {}
+declare const PostNotFound_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "PostNotFound";
+} & Readonly<A>;
+/** Thrown when a requested slug does not match any loaded post. */
+declare class PostNotFound extends PostNotFound_base<{
+  readonly slug: string;
+}> {}
+declare const ContentDirMissing_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "ContentDirMissing";
+} & Readonly<A>;
+/** Thrown when the configured content directory does not exist. */
+declare class ContentDirMissing extends ContentDirMissing_base<{
+  readonly dir: string;
+}> {}
+declare const RenderError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "RenderError";
+} & Readonly<A>;
+/** Thrown when the Markdown-to-HTML pipeline fails. */
+declare class RenderError extends RenderError_base<{
+  readonly message: string;
+  readonly cause?: unknown;
+}> {}
+/** Union of all typed errors that Voxx can surface. */
+type VoxxError = ConfigError | InvalidFrontmatter | PostNotFound | ContentDirMissing | RenderError;
+//#endregion
+export { ConfigError, ContentDirMissing, InvalidFrontmatter, PostNotFound, RenderError, VoxxError };
+//# sourceMappingURL=errors.d.mts.map

package/dist/errors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.mts","names":[],"sources":["../src/errors.ts"],"mappings":";;;;;cAGa,WAAA,SAAoB,gBAAA;EAAA,SACtB,OAAA;EAAA,SACA,KAAA;AAAA;AAAA,cACN,uBAAA;;;;cAGQ,kBAAA,SAA2B,uBAAA;EAAA,SAC7B,IAAA;EAAA,SACA,OAAA;EAAA,SACA,KAAA;AAAA;AAAA,cACN,iBAAA;;;;cAGQ,YAAA,SAAqB,iBAAA;EAAA,SACvB,IAAI;AAAA;AAAA,cACV,sBAAA;;;AAfL;AAAA,cAkBa,iBAAA,SAA0B,sBAAA;EAAA,SAC5B,GAAG;AAAA;AAAA,cACT,gBAAA;;;AAlBW;AAAA,cAqBH,WAAA,SAAoB,gBAAA;EAAA,SACtB,OAAA;EAAA,SACA,KAAA;AAAA;;KAIC,SAAA,GACR,WAAA,GACA,kBAAA,GACA,YAAA,GACA,iBAAA,GACA,WAAA"}

package/dist/errors.mjs

@@ -0,0 +1,16 @@
+import { Data } from "effect";
+//#region src/errors.ts
+/** Thrown when `voxx.json` is missing, unreadable, or fails schema validation. */
+var ConfigError = class extends Data.TaggedError("ConfigError") {};
+/** Thrown when a Markdown file's frontmatter cannot be parsed or is invalid. */
+var InvalidFrontmatter = class extends Data.TaggedError("InvalidFrontmatter") {};
+/** Thrown when a requested slug does not match any loaded post. */
+var PostNotFound = class extends Data.TaggedError("PostNotFound") {};
+/** Thrown when the configured content directory does not exist. */
+var ContentDirMissing = class extends Data.TaggedError("ContentDirMissing") {};
+/** Thrown when the Markdown-to-HTML pipeline fails. */
+var RenderError = class extends Data.TaggedError("RenderError") {};
+//#endregion
+export { ConfigError, ContentDirMissing, InvalidFrontmatter, PostNotFound, RenderError };
+
+//# sourceMappingURL=errors.mjs.map

package/dist/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["import { Data } from \"effect\";\n\n/** Thrown when `voxx.json` is missing, unreadable, or fails schema validation. */\nexport class ConfigError extends Data.TaggedError(\"ConfigError\")<{\n  readonly message: string;\n  readonly cause?: unknown;\n}> {}\n\n/** Thrown when a Markdown file's frontmatter cannot be parsed or is invalid. */\nexport class InvalidFrontmatter extends Data.TaggedError(\"InvalidFrontmatter\")<{\n  readonly file: string;\n  readonly message: string;\n  readonly cause?: unknown;\n}> {}\n\n/** Thrown when a requested slug does not match any loaded post. */\nexport class PostNotFound extends Data.TaggedError(\"PostNotFound\")<{\n  readonly slug: string;\n}> {}\n\n/** Thrown when the configured content directory does not exist. */\nexport class ContentDirMissing extends Data.TaggedError(\"ContentDirMissing\")<{\n  readonly dir: string;\n}> {}\n\n/** Thrown when the Markdown-to-HTML pipeline fails. */\nexport class RenderError extends Data.TaggedError(\"RenderError\")<{\n  readonly message: string;\n  readonly cause?: unknown;\n}> {}\n\n/** Union of all typed errors that Voxx can surface. */\nexport type VoxxError =\n  | ConfigError\n  | InvalidFrontmatter\n  | PostNotFound\n  | ContentDirMissing\n  | RenderError;\n"],"mappings":";;;AAGA,IAAa,cAAb,cAAiC,KAAK,YAAY,aAAa,CAAC,CAG7D,CAAC;;AAGJ,IAAa,qBAAb,cAAwC,KAAK,YAAY,oBAAoB,CAAC,CAI3E,CAAC;;AAGJ,IAAa,eAAb,cAAkC,KAAK,YAAY,cAAc,CAAC,CAE/D,CAAC;;AAGJ,IAAa,oBAAb,cAAuC,KAAK,YAAY,mBAAmB,CAAC,CAEzE,CAAC;;AAGJ,IAAa,cAAb,cAAiC,KAAK,YAAY,aAAa,CAAC,CAG7D,CAAC"}

package/dist/feeds.cjs

@@ -0,0 +1,97 @@
+const require_util = require("./util.cjs");
+//#region src/feeds.ts
+const cdata = (value) => `<![CDATA[${value.replace(/\]\]>/g, "]]]]><![CDATA[>")}]]>`;
+/**
+* Returns the default RSS feed path for the active content collection.
+*
+* @param config - Resolved Voxx config.
+* @returns URL path string, e.g. `/blog/rss.xml`.
+*/
+function rssPath(config) {
+	return require_util.joinPath(config.content.basePath, "rss.xml");
+}
+/**
+* Renders a valid RSS 2.0 feed with `content:encoded` for all posts.
+*
+* @param posts - Ordered list of posts (most recent first).
+* @param config - Resolved Voxx config.
+* @param opts - Optional feed path override.
+* @returns RSS XML string.
+*/
+function renderRss(posts, config, opts = {}) {
+	const self = require_util.absoluteUrl(config.site.url, opts.path ?? rssPath(config));
+	const items = posts.map((p) => {
+		const link = require_util.absoluteUrl(config.site.url, p.url);
+		const categories = config.features.tags ? p.tags.map((t) => `      <category>${require_util.escapeXml(t)}</category>`).join("\n") : "";
+		return [
+			"    <item>",
+			`      <title>${require_util.escapeXml(p.title)}</title>`,
+			`      <link>${require_util.escapeXml(link)}</link>`,
+			`      <guid isPermaLink="true">${require_util.escapeXml(link)}</guid>`,
+			`      <pubDate>${require_util.rfc822(p.date)}</pubDate>`,
+			`      <description>${require_util.escapeXml(p.description ?? p.excerpt)}</description>`,
+			`      <content:encoded>${cdata(p.html)}</content:encoded>`,
+			categories,
+			"    </item>"
+		].filter((l) => l !== "").join("\n");
+	}).join("\n");
+	return `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+  <channel>
+    <title>${require_util.escapeXml(config.site.title)}</title>
+    <link>${require_util.escapeXml(config.site.url)}</link>
+    <description>${require_util.escapeXml(config.site.description)}</description>
+    <language>${require_util.escapeXml(config.site.locale)}</language>
+    <lastBuildDate>${require_util.rfc822(posts[0]?.date ?? (/* @__PURE__ */ new Date()).toISOString())}</lastBuildDate>
+    <atom:link href="${require_util.escapeXml(self)}" rel="self" type="application/rss+xml"/>
+${items}
+  </channel>
+</rss>
+`;
+}
+/**
+* Renders an XML sitemap for all posts.
+*
+* @param posts - List of posts to include.
+* @param config - Resolved Voxx config.
+* @param opts - Optional extra index paths.
+* @returns Sitemap XML string.
+*/
+function renderSitemap(posts, config, opts = {}) {
+	const lastmod = require_util.isoDate(posts[0]?.updated ?? posts[0]?.date ?? (/* @__PURE__ */ new Date()).toISOString());
+	return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${[...(opts.indexPaths ?? [config.content.basePath]).map((p) => ({
+		loc: require_util.absoluteUrl(config.site.url, p),
+		lastmod
+	})), ...posts.map((p) => ({
+		loc: require_util.absoluteUrl(config.site.url, p.url),
+		lastmod: require_util.isoDate(p.updated ?? p.date)
+	}))].map((u) => [
+		"  <url>",
+		`    <loc>${require_util.escapeXml(u.loc)}</loc>`,
+		`    <lastmod>${u.lastmod}</lastmod>`,
+		"  </url>"
+	].join("\n")).join("\n")}
+</urlset>
+`;
+}
+/**
+* Renders a `robots.txt` that allows all crawlers and optionally
+* references the sitemap when `features.sitemap` is enabled.
+*
+* @param config - Resolved Voxx config.
+* @returns `robots.txt` content string.
+*/
+function renderRobotsTxt(config) {
+	const lines = ["User-agent: *", "Allow: /"];
+	if (config.features.sitemap) lines.push("", `Sitemap: ${require_util.absoluteUrl(config.site.url, "/sitemap.xml")}`);
+	return `${lines.join("\n")}\n`;
+}
+//#endregion
+exports.renderRobotsTxt = renderRobotsTxt;
+exports.renderRss = renderRss;
+exports.renderSitemap = renderSitemap;
+exports.rssPath = rssPath;
+
+//# sourceMappingURL=feeds.cjs.map

package/dist/feeds.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"feeds.cjs","names":["joinPath","absoluteUrl","escapeXml","rfc822","isoDate"],"sources":["../src/feeds.ts"],"sourcesContent":["import { absoluteUrl, escapeXml, isoDate, joinPath, rfc822 } from \"./util\";\nimport type { Post, VoxxConfig } from \"./types\";\n\n/** Options for `renderRss`. */\nexport interface RenderRssOptions {\n  /** Override the default RSS feed path (`<basePath>/rss.xml`). */\n  path?: string;\n}\n\nconst cdata = (value: string) =>\n  `<![CDATA[${value.replace(/\\]\\]>/g, \"]]]]><![CDATA[>\")}]]>`;\n\n/**\n * Returns the default RSS feed path for the active content collection.\n *\n * @param config - Resolved Voxx config.\n * @returns URL path string, e.g. `/blog/rss.xml`.\n */\nexport function rssPath(config: VoxxConfig): string {\n  return joinPath(config.content.basePath, \"rss.xml\");\n}\n\n/**\n * Renders a valid RSS 2.0 feed with `content:encoded` for all posts.\n *\n * @param posts - Ordered list of posts (most recent first).\n * @param config - Resolved Voxx config.\n * @param opts - Optional feed path override.\n * @returns RSS XML string.\n */\nexport function renderRss(\n  posts: Post[],\n  config: VoxxConfig,\n  opts: RenderRssOptions = {},\n): string {\n  const self = absoluteUrl(config.site.url, opts.path ?? rssPath(config));\n  const items = posts\n    .map((p) => {\n      const link = absoluteUrl(config.site.url, p.url);\n      const categories = config.features.tags\n        ? p.tags\n            .map((t) => `      <category>${escapeXml(t)}</category>`)\n            .join(\"\\n\")\n        : \"\";\n      return [\n        \"    <item>\",\n        `      <title>${escapeXml(p.title)}</title>`,\n        `      <link>${escapeXml(link)}</link>`,\n        `      <guid isPermaLink=\"true\">${escapeXml(link)}</guid>`,\n        `      <pubDate>${rfc822(p.date)}</pubDate>`,\n        `      <description>${escapeXml(p.description ?? p.excerpt)}</description>`,\n        `      <content:encoded>${cdata(p.html)}</content:encoded>`,\n        categories,\n        \"    </item>\",\n      ]\n        .filter((l) => l !== \"\")\n        .join(\"\\n\");\n    })\n    .join(\"\\n\");\n\n  return `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<rss version=\"2.0\" xmlns:atom=\"http://www.w3.org/2005/Atom\" xmlns:content=\"http://purl.org/rss/1.0/modules/content/\">\n  <channel>\n    <title>${escapeXml(config.site.title)}</title>\n    <link>${escapeXml(config.site.url)}</link>\n    <description>${escapeXml(config.site.description)}</description>\n    <language>${escapeXml(config.site.locale)}</language>\n    <lastBuildDate>${rfc822(posts[0]?.date ?? new Date().toISOString())}</lastBuildDate>\n    <atom:link href=\"${escapeXml(self)}\" rel=\"self\" type=\"application/rss+xml\"/>\n${items}\n  </channel>\n</rss>\n`;\n}\n\n/** Options for `renderSitemap`. */\nexport interface RenderSitemapOptions {\n  /** Additional index paths to include before the post entries. */\n  indexPaths?: string[];\n}\n\n/**\n * Renders an XML sitemap for all posts.\n *\n * @param posts - List of posts to include.\n * @param config - Resolved Voxx config.\n * @param opts - Optional extra index paths.\n * @returns Sitemap XML string.\n */\nexport function renderSitemap(\n  posts: Post[],\n  config: VoxxConfig,\n  opts: RenderSitemapOptions = {},\n): string {\n  const lastmod = isoDate(\n    posts[0]?.updated ?? posts[0]?.date ?? new Date().toISOString(),\n  );\n  const entries = [\n    ...(opts.indexPaths ?? [config.content.basePath]).map((p) => ({\n      loc: absoluteUrl(config.site.url, p),\n      lastmod,\n    })),\n    ...posts.map((p) => ({\n      loc: absoluteUrl(config.site.url, p.url),\n      lastmod: isoDate(p.updated ?? p.date),\n    })),\n  ];\n\n  const body = entries\n    .map((u) =>\n      [\n        \"  <url>\",\n        `    <loc>${escapeXml(u.loc)}</loc>`,\n        `    <lastmod>${u.lastmod}</lastmod>`,\n        \"  </url>\",\n      ].join(\"\\n\"),\n    )\n    .join(\"\\n\");\n\n  return `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n${body}\n</urlset>\n`;\n}\n\n/**\n * Renders a `robots.txt` that allows all crawlers and optionally\n * references the sitemap when `features.sitemap` is enabled.\n *\n * @param config - Resolved Voxx config.\n * @returns `robots.txt` content string.\n */\nexport function renderRobotsTxt(config: VoxxConfig): string {\n  const lines = [\"User-agent: *\", \"Allow: /\"];\n  if (config.features.sitemap) {\n    lines.push(\"\", `Sitemap: ${absoluteUrl(config.site.url, \"/sitemap.xml\")}`);\n  }\n  return `${lines.join(\"\\n\")}\\n`;\n}\n"],"mappings":";;AASA,MAAM,SAAS,UACb,YAAY,MAAM,QAAQ,UAAU,iBAAiB,EAAE;;;;;;;AAQzD,SAAgB,QAAQ,QAA4B;CAClD,OAAOA,aAAAA,SAAS,OAAO,QAAQ,UAAU,SAAS;AACpD;;;;;;;;;AAUA,SAAgB,UACd,OACA,QACA,OAAyB,CAAC,GAClB;CACR,MAAM,OAAOC,aAAAA,YAAY,OAAO,KAAK,KAAK,KAAK,QAAQ,QAAQ,MAAM,CAAC;CACtE,MAAM,QAAQ,MACX,KAAK,MAAM;EACV,MAAM,OAAOA,aAAAA,YAAY,OAAO,KAAK,KAAK,EAAE,GAAG;EAC/C,MAAM,aAAa,OAAO,SAAS,OAC/B,EAAE,KACC,KAAK,MAAM,mBAAmBC,aAAAA,UAAU,CAAC,EAAE,YAAY,CAAC,CACxD,KAAK,IAAI,IACZ;EACJ,OAAO;GACL;GACA,gBAAgBA,aAAAA,UAAU,EAAE,KAAK,EAAE;GACnC,eAAeA,aAAAA,UAAU,IAAI,EAAE;GAC/B,kCAAkCA,aAAAA,UAAU,IAAI,EAAE;GAClD,kBAAkBC,aAAAA,OAAO,EAAE,IAAI,EAAE;GACjC,sBAAsBD,aAAAA,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE;GAC5D,0BAA0B,MAAM,EAAE,IAAI,EAAE;GACxC;GACA;EACF,CAAC,CACE,QAAQ,MAAM,MAAM,EAAE,CAAC,CACvB,KAAK,IAAI;CACd,CAAC,CAAC,CACD,KAAK,IAAI;CAEZ,OAAO;;;aAGIA,aAAAA,UAAU,OAAO,KAAK,KAAK,EAAE;YAC9BA,aAAAA,UAAU,OAAO,KAAK,GAAG,EAAE;mBACpBA,aAAAA,UAAU,OAAO,KAAK,WAAW,EAAE;gBACtCA,aAAAA,UAAU,OAAO,KAAK,MAAM,EAAE;qBACzBC,aAAAA,OAAO,MAAM,EAAE,EAAE,yBAAQ,IAAI,KAAK,EAAA,CAAE,YAAY,CAAC,EAAE;uBACjDD,aAAAA,UAAU,IAAI,EAAE;EACrC,MAAM;;;;AAIR;;;;;;;;;AAgBA,SAAgB,cACd,OACA,QACA,OAA6B,CAAC,GACtB;CACR,MAAM,UAAUE,aAAAA,QACd,MAAM,EAAE,EAAE,WAAW,MAAM,EAAE,EAAE,yBAAQ,IAAI,KAAK,EAAA,CAAE,YAAY,CAChE;CAuBA,OAAO;;EAXM,CAVX,IAAI,KAAK,cAAc,CAAC,OAAO,QAAQ,QAAQ,EAAA,CAAG,KAAK,OAAO;EAC5D,KAAKH,aAAAA,YAAY,OAAO,KAAK,KAAK,CAAC;EACnC;CACF,EAAE,GACF,GAAG,MAAM,KAAK,OAAO;EACnB,KAAKA,aAAAA,YAAY,OAAO,KAAK,KAAK,EAAE,GAAG;EACvC,SAASG,aAAAA,QAAQ,EAAE,WAAW,EAAE,IAAI;CACtC,EAAE,CAGe,CAAC,CACjB,KAAK,MACJ;EACE;EACA,YAAYF,aAAAA,UAAU,EAAE,GAAG,EAAE;EAC7B,gBAAgB,EAAE,QAAQ;EAC1B;CACF,CAAC,CAAC,KAAK,IAAI,CACb,CAAC,CACA,KAAK,IAIL,EAAE;;;AAGP;;;;;;;;AASA,SAAgB,gBAAgB,QAA4B;CAC1D,MAAM,QAAQ,CAAC,iBAAiB,UAAU;CAC1C,IAAI,OAAO,SAAS,SAClB,MAAM,KAAK,IAAI,YAAYD,aAAAA,YAAY,OAAO,KAAK,KAAK,cAAc,GAAG;CAE3E,OAAO,GAAG,MAAM,KAAK,IAAI,EAAE;AAC7B"}

package/dist/feeds.d.cts

@@ -0,0 +1,49 @@
+import { Post, VoxxConfig } from "./types.cjs";
+
+//#region src/feeds.d.ts
+/** Options for `renderRss`. */
+interface RenderRssOptions {
+  /** Override the default RSS feed path (`<basePath>/rss.xml`). */
+  path?: string;
+}
+/**
+ * Returns the default RSS feed path for the active content collection.
+ *
+ * @param config - Resolved Voxx config.
+ * @returns URL path string, e.g. `/blog/rss.xml`.
+ */
+declare function rssPath(config: VoxxConfig): string;
+/**
+ * Renders a valid RSS 2.0 feed with `content:encoded` for all posts.
+ *
+ * @param posts - Ordered list of posts (most recent first).
+ * @param config - Resolved Voxx config.
+ * @param opts - Optional feed path override.
+ * @returns RSS XML string.
+ */
+declare function renderRss(posts: Post[], config: VoxxConfig, opts?: RenderRssOptions): string;
+/** Options for `renderSitemap`. */
+interface RenderSitemapOptions {
+  /** Additional index paths to include before the post entries. */
+  indexPaths?: string[];
+}
+/**
+ * Renders an XML sitemap for all posts.
+ *
+ * @param posts - List of posts to include.
+ * @param config - Resolved Voxx config.
+ * @param opts - Optional extra index paths.
+ * @returns Sitemap XML string.
+ */
+declare function renderSitemap(posts: Post[], config: VoxxConfig, opts?: RenderSitemapOptions): string;
+/**
+ * Renders a `robots.txt` that allows all crawlers and optionally
+ * references the sitemap when `features.sitemap` is enabled.
+ *
+ * @param config - Resolved Voxx config.
+ * @returns `robots.txt` content string.
+ */
+declare function renderRobotsTxt(config: VoxxConfig): string;
+//#endregion
+export { RenderRssOptions, RenderSitemapOptions, renderRobotsTxt, renderRss, renderSitemap, rssPath };
+//# sourceMappingURL=feeds.d.cts.map

package/dist/feeds.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feeds.d.cts","names":[],"sources":["../src/feeds.ts"],"mappings":";;;;UAIiB,gBAAA;EAAA;EAEf,IAAI;AAAA;;AAAA;AAYN;;;;iBAAgB,OAAA,CAAQ,MAAkB,EAAV,UAAU;AAY1C;;;;;;;;AAAA,iBAAgB,SAAA,CACd,KAAA,EAAO,IAAA,IACP,MAAA,EAAQ,UAAA,EACR,IAAA,GAAM,gBAAA;;UA2CS,oBAAA;EA5Cf;EA8CA,UAAU;AAAA;;AA7CiB;AA2C7B;;;;AAEY;AAWZ;iBAAgB,aAAA,CACd,KAAA,EAAO,IAAA,IACP,MAAA,EAAQ,UAAA,EACR,IAAA,GAAM,oBAAA;;;;;;;;iBAyCQ,eAAA,CAAgB,MAAkB,EAAV,UAAU"}

package/dist/feeds.d.mts

@@ -0,0 +1,49 @@
+import { Post, VoxxConfig } from "./types.mjs";
+
+//#region src/feeds.d.ts
+/** Options for `renderRss`. */
+interface RenderRssOptions {
+  /** Override the default RSS feed path (`<basePath>/rss.xml`). */
+  path?: string;
+}
+/**
+ * Returns the default RSS feed path for the active content collection.
+ *
+ * @param config - Resolved Voxx config.
+ * @returns URL path string, e.g. `/blog/rss.xml`.
+ */
+declare function rssPath(config: VoxxConfig): string;
+/**
+ * Renders a valid RSS 2.0 feed with `content:encoded` for all posts.
+ *
+ * @param posts - Ordered list of posts (most recent first).
+ * @param config - Resolved Voxx config.
+ * @param opts - Optional feed path override.
+ * @returns RSS XML string.
+ */
+declare function renderRss(posts: Post[], config: VoxxConfig, opts?: RenderRssOptions): string;
+/** Options for `renderSitemap`. */
+interface RenderSitemapOptions {
+  /** Additional index paths to include before the post entries. */
+  indexPaths?: string[];
+}
+/**
+ * Renders an XML sitemap for all posts.
+ *
+ * @param posts - List of posts to include.
+ * @param config - Resolved Voxx config.
+ * @param opts - Optional extra index paths.
+ * @returns Sitemap XML string.
+ */
+declare function renderSitemap(posts: Post[], config: VoxxConfig, opts?: RenderSitemapOptions): string;
+/**
+ * Renders a `robots.txt` that allows all crawlers and optionally
+ * references the sitemap when `features.sitemap` is enabled.
+ *
+ * @param config - Resolved Voxx config.
+ * @returns `robots.txt` content string.
+ */
+declare function renderRobotsTxt(config: VoxxConfig): string;
+//#endregion
+export { RenderRssOptions, RenderSitemapOptions, renderRobotsTxt, renderRss, renderSitemap, rssPath };
+//# sourceMappingURL=feeds.d.mts.map

package/dist/feeds.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feeds.d.mts","names":[],"sources":["../src/feeds.ts"],"mappings":";;;;UAIiB,gBAAA;EAAA;EAEf,IAAI;AAAA;;AAAA;AAYN;;;;iBAAgB,OAAA,CAAQ,MAAkB,EAAV,UAAU;AAY1C;;;;;;;;AAAA,iBAAgB,SAAA,CACd,KAAA,EAAO,IAAA,IACP,MAAA,EAAQ,UAAA,EACR,IAAA,GAAM,gBAAA;;UA2CS,oBAAA;EA5Cf;EA8CA,UAAU;AAAA;;AA7CiB;AA2C7B;;;;AAEY;AAWZ;iBAAgB,aAAA,CACd,KAAA,EAAO,IAAA,IACP,MAAA,EAAQ,UAAA,EACR,IAAA,GAAM,oBAAA;;;;;;;;iBAyCQ,eAAA,CAAgB,MAAkB,EAAV,UAAU"}

package/dist/feeds.mjs

@@ -0,0 +1,94 @@
+import { absoluteUrl, escapeXml, isoDate, joinPath, rfc822 } from "./util.mjs";
+//#region src/feeds.ts
+const cdata = (value) => `<![CDATA[${value.replace(/\]\]>/g, "]]]]><![CDATA[>")}]]>`;
+/**
+* Returns the default RSS feed path for the active content collection.
+*
+* @param config - Resolved Voxx config.
+* @returns URL path string, e.g. `/blog/rss.xml`.
+*/
+function rssPath(config) {
+	return joinPath(config.content.basePath, "rss.xml");
+}
+/**
+* Renders a valid RSS 2.0 feed with `content:encoded` for all posts.
+*
+* @param posts - Ordered list of posts (most recent first).
+* @param config - Resolved Voxx config.
+* @param opts - Optional feed path override.
+* @returns RSS XML string.
+*/
+function renderRss(posts, config, opts = {}) {
+	const self = absoluteUrl(config.site.url, opts.path ?? rssPath(config));
+	const items = posts.map((p) => {
+		const link = absoluteUrl(config.site.url, p.url);
+		const categories = config.features.tags ? p.tags.map((t) => `      <category>${escapeXml(t)}</category>`).join("\n") : "";
+		return [
+			"    <item>",
+			`      <title>${escapeXml(p.title)}</title>`,
+			`      <link>${escapeXml(link)}</link>`,
+			`      <guid isPermaLink="true">${escapeXml(link)}</guid>`,
+			`      <pubDate>${rfc822(p.date)}</pubDate>`,
+			`      <description>${escapeXml(p.description ?? p.excerpt)}</description>`,
+			`      <content:encoded>${cdata(p.html)}</content:encoded>`,
+			categories,
+			"    </item>"
+		].filter((l) => l !== "").join("\n");
+	}).join("\n");
+	return `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+  <channel>
+    <title>${escapeXml(config.site.title)}</title>
+    <link>${escapeXml(config.site.url)}</link>
+    <description>${escapeXml(config.site.description)}</description>
+    <language>${escapeXml(config.site.locale)}</language>
+    <lastBuildDate>${rfc822(posts[0]?.date ?? (/* @__PURE__ */ new Date()).toISOString())}</lastBuildDate>
+    <atom:link href="${escapeXml(self)}" rel="self" type="application/rss+xml"/>
+${items}
+  </channel>
+</rss>
+`;
+}
+/**
+* Renders an XML sitemap for all posts.
+*
+* @param posts - List of posts to include.
+* @param config - Resolved Voxx config.
+* @param opts - Optional extra index paths.
+* @returns Sitemap XML string.
+*/
+function renderSitemap(posts, config, opts = {}) {
+	const lastmod = isoDate(posts[0]?.updated ?? posts[0]?.date ?? (/* @__PURE__ */ new Date()).toISOString());
+	return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${[...(opts.indexPaths ?? [config.content.basePath]).map((p) => ({
+		loc: absoluteUrl(config.site.url, p),
+		lastmod
+	})), ...posts.map((p) => ({
+		loc: absoluteUrl(config.site.url, p.url),
+		lastmod: isoDate(p.updated ?? p.date)
+	}))].map((u) => [
+		"  <url>",
+		`    <loc>${escapeXml(u.loc)}</loc>`,
+		`    <lastmod>${u.lastmod}</lastmod>`,
+		"  </url>"
+	].join("\n")).join("\n")}
+</urlset>
+`;
+}
+/**
+* Renders a `robots.txt` that allows all crawlers and optionally
+* references the sitemap when `features.sitemap` is enabled.
+*
+* @param config - Resolved Voxx config.
+* @returns `robots.txt` content string.
+*/
+function renderRobotsTxt(config) {
+	const lines = ["User-agent: *", "Allow: /"];
+	if (config.features.sitemap) lines.push("", `Sitemap: ${absoluteUrl(config.site.url, "/sitemap.xml")}`);
+	return `${lines.join("\n")}\n`;
+}
+//#endregion
+export { renderRobotsTxt, renderRss, renderSitemap, rssPath };
+
+//# sourceMappingURL=feeds.mjs.map

package/dist/feeds.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"feeds.mjs","names":[],"sources":["../src/feeds.ts"],"sourcesContent":["import { absoluteUrl, escapeXml, isoDate, joinPath, rfc822 } from \"./util\";\nimport type { Post, VoxxConfig } from \"./types\";\n\n/** Options for `renderRss`. */\nexport interface RenderRssOptions {\n  /** Override the default RSS feed path (`<basePath>/rss.xml`). */\n  path?: string;\n}\n\nconst cdata = (value: string) =>\n  `<![CDATA[${value.replace(/\\]\\]>/g, \"]]]]><![CDATA[>\")}]]>`;\n\n/**\n * Returns the default RSS feed path for the active content collection.\n *\n * @param config - Resolved Voxx config.\n * @returns URL path string, e.g. `/blog/rss.xml`.\n */\nexport function rssPath(config: VoxxConfig): string {\n  return joinPath(config.content.basePath, \"rss.xml\");\n}\n\n/**\n * Renders a valid RSS 2.0 feed with `content:encoded` for all posts.\n *\n * @param posts - Ordered list of posts (most recent first).\n * @param config - Resolved Voxx config.\n * @param opts - Optional feed path override.\n * @returns RSS XML string.\n */\nexport function renderRss(\n  posts: Post[],\n  config: VoxxConfig,\n  opts: RenderRssOptions = {},\n): string {\n  const self = absoluteUrl(config.site.url, opts.path ?? rssPath(config));\n  const items = posts\n    .map((p) => {\n      const link = absoluteUrl(config.site.url, p.url);\n      const categories = config.features.tags\n        ? p.tags\n            .map((t) => `      <category>${escapeXml(t)}</category>`)\n            .join(\"\\n\")\n        : \"\";\n      return [\n        \"    <item>\",\n        `      <title>${escapeXml(p.title)}</title>`,\n        `      <link>${escapeXml(link)}</link>`,\n        `      <guid isPermaLink=\"true\">${escapeXml(link)}</guid>`,\n        `      <pubDate>${rfc822(p.date)}</pubDate>`,\n        `      <description>${escapeXml(p.description ?? p.excerpt)}</description>`,\n        `      <content:encoded>${cdata(p.html)}</content:encoded>`,\n        categories,\n        \"    </item>\",\n      ]\n        .filter((l) => l !== \"\")\n        .join(\"\\n\");\n    })\n    .join(\"\\n\");\n\n  return `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<rss version=\"2.0\" xmlns:atom=\"http://www.w3.org/2005/Atom\" xmlns:content=\"http://purl.org/rss/1.0/modules/content/\">\n  <channel>\n    <title>${escapeXml(config.site.title)}</title>\n    <link>${escapeXml(config.site.url)}</link>\n    <description>${escapeXml(config.site.description)}</description>\n    <language>${escapeXml(config.site.locale)}</language>\n    <lastBuildDate>${rfc822(posts[0]?.date ?? new Date().toISOString())}</lastBuildDate>\n    <atom:link href=\"${escapeXml(self)}\" rel=\"self\" type=\"application/rss+xml\"/>\n${items}\n  </channel>\n</rss>\n`;\n}\n\n/** Options for `renderSitemap`. */\nexport interface RenderSitemapOptions {\n  /** Additional index paths to include before the post entries. */\n  indexPaths?: string[];\n}\n\n/**\n * Renders an XML sitemap for all posts.\n *\n * @param posts - List of posts to include.\n * @param config - Resolved Voxx config.\n * @param opts - Optional extra index paths.\n * @returns Sitemap XML string.\n */\nexport function renderSitemap(\n  posts: Post[],\n  config: VoxxConfig,\n  opts: RenderSitemapOptions = {},\n): string {\n  const lastmod = isoDate(\n    posts[0]?.updated ?? posts[0]?.date ?? new Date().toISOString(),\n  );\n  const entries = [\n    ...(opts.indexPaths ?? [config.content.basePath]).map((p) => ({\n      loc: absoluteUrl(config.site.url, p),\n      lastmod,\n    })),\n    ...posts.map((p) => ({\n      loc: absoluteUrl(config.site.url, p.url),\n      lastmod: isoDate(p.updated ?? p.date),\n    })),\n  ];\n\n  const body = entries\n    .map((u) =>\n      [\n        \"  <url>\",\n        `    <loc>${escapeXml(u.loc)}</loc>`,\n        `    <lastmod>${u.lastmod}</lastmod>`,\n        \"  </url>\",\n      ].join(\"\\n\"),\n    )\n    .join(\"\\n\");\n\n  return `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n${body}\n</urlset>\n`;\n}\n\n/**\n * Renders a `robots.txt` that allows all crawlers and optionally\n * references the sitemap when `features.sitemap` is enabled.\n *\n * @param config - Resolved Voxx config.\n * @returns `robots.txt` content string.\n */\nexport function renderRobotsTxt(config: VoxxConfig): string {\n  const lines = [\"User-agent: *\", \"Allow: /\"];\n  if (config.features.sitemap) {\n    lines.push(\"\", `Sitemap: ${absoluteUrl(config.site.url, \"/sitemap.xml\")}`);\n  }\n  return `${lines.join(\"\\n\")}\\n`;\n}\n"],"mappings":";;AASA,MAAM,SAAS,UACb,YAAY,MAAM,QAAQ,UAAU,iBAAiB,EAAE;;;;;;;AAQzD,SAAgB,QAAQ,QAA4B;CAClD,OAAO,SAAS,OAAO,QAAQ,UAAU,SAAS;AACpD;;;;;;;;;AAUA,SAAgB,UACd,OACA,QACA,OAAyB,CAAC,GAClB;CACR,MAAM,OAAO,YAAY,OAAO,KAAK,KAAK,KAAK,QAAQ,QAAQ,MAAM,CAAC;CACtE,MAAM,QAAQ,MACX,KAAK,MAAM;EACV,MAAM,OAAO,YAAY,OAAO,KAAK,KAAK,EAAE,GAAG;EAC/C,MAAM,aAAa,OAAO,SAAS,OAC/B,EAAE,KACC,KAAK,MAAM,mBAAmB,UAAU,CAAC,EAAE,YAAY,CAAC,CACxD,KAAK,IAAI,IACZ;EACJ,OAAO;GACL;GACA,gBAAgB,UAAU,EAAE,KAAK,EAAE;GACnC,eAAe,UAAU,IAAI,EAAE;GAC/B,kCAAkC,UAAU,IAAI,EAAE;GAClD,kBAAkB,OAAO,EAAE,IAAI,EAAE;GACjC,sBAAsB,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE;GAC5D,0BAA0B,MAAM,EAAE,IAAI,EAAE;GACxC;GACA;EACF,CAAC,CACE,QAAQ,MAAM,MAAM,EAAE,CAAC,CACvB,KAAK,IAAI;CACd,CAAC,CAAC,CACD,KAAK,IAAI;CAEZ,OAAO;;;aAGI,UAAU,OAAO,KAAK,KAAK,EAAE;YAC9B,UAAU,OAAO,KAAK,GAAG,EAAE;mBACpB,UAAU,OAAO,KAAK,WAAW,EAAE;gBACtC,UAAU,OAAO,KAAK,MAAM,EAAE;qBACzB,OAAO,MAAM,EAAE,EAAE,yBAAQ,IAAI,KAAK,EAAA,CAAE,YAAY,CAAC,EAAE;uBACjD,UAAU,IAAI,EAAE;EACrC,MAAM;;;;AAIR;;;;;;;;;AAgBA,SAAgB,cACd,OACA,QACA,OAA6B,CAAC,GACtB;CACR,MAAM,UAAU,QACd,MAAM,EAAE,EAAE,WAAW,MAAM,EAAE,EAAE,yBAAQ,IAAI,KAAK,EAAA,CAAE,YAAY,CAChE;CAuBA,OAAO;;EAXM,CAVX,IAAI,KAAK,cAAc,CAAC,OAAO,QAAQ,QAAQ,EAAA,CAAG,KAAK,OAAO;EAC5D,KAAK,YAAY,OAAO,KAAK,KAAK,CAAC;EACnC;CACF,EAAE,GACF,GAAG,MAAM,KAAK,OAAO;EACnB,KAAK,YAAY,OAAO,KAAK,KAAK,EAAE,GAAG;EACvC,SAAS,QAAQ,EAAE,WAAW,EAAE,IAAI;CACtC,EAAE,CAGe,CAAC,CACjB,KAAK,MACJ;EACE;EACA,YAAY,UAAU,EAAE,GAAG,EAAE;EAC7B,gBAAgB,EAAE,QAAQ;EAC1B;CACF,CAAC,CAAC,KAAK,IAAI,CACb,CAAC,CACA,KAAK,IAIL,EAAE;;;AAGP;;;;;;;;AASA,SAAgB,gBAAgB,QAA4B;CAC1D,MAAM,QAAQ,CAAC,iBAAiB,UAAU;CAC1C,IAAI,OAAO,SAAS,SAClB,MAAM,KAAK,IAAI,YAAY,YAAY,OAAO,KAAK,KAAK,cAAc,GAAG;CAE3E,OAAO,GAAG,MAAM,KAAK,IAAI,EAAE;AAC7B"}