@voltro/content 0.54.0 → 0.56.0

package/dist/get-BZwQfLp6.js

@@ -0,0 +1,105 @@
+import { Schema as e } from "effect";
+//#region \0rolldown/runtime.js
+var t = Object.defineProperty, n = /* @__PURE__ */ ((e, n) => {
+	let r = {};
+	for (var i in e) t(r, i, {
+		get: e[i],
+		enumerable: !0
+	});
+	return n || t(r, Symbol.toStringTag, { value: "Module" }), r;
+})({
+	ReferenceTarget: () => u,
+	defineCollection: () => a,
+	reference: () => d,
+	referenceFieldsOf: () => p,
+	referenceTargetOf: () => f,
+	registeredCollection: () => s,
+	registeredCollections: () => o,
+	resetCollectionsForTest: () => c,
+	slugFromRelativePath: () => l
+}), r = Symbol.for("@voltro/content:collections"), i = () => {
+	let e = globalThis;
+	return e[r] ??= /* @__PURE__ */ new Map();
+}, a = (e) => {
+	let t = i().get(e.name);
+	if (t !== void 0 && t.directory !== e.directory) throw Error(`defineCollection('${e.name}') is declared twice with different directories ('${t.directory}' vs '${e.directory}') — collection names are global.`);
+	return i().set(e.name, e), e;
+}, o = () => [...i().values()], s = (e) => i().get(e), c = () => {
+	i().clear();
+}, l = (e) => e.replace(/\\/g, "/").replace(/\.(md|mdx|json)$/i, ""), u = Symbol.for("@voltro/content:reference-target"), d = (t) => e.String.annotations({ [u]: t }), f = (e) => {
+	let t = e.annotations?.[u];
+	return typeof t == "string" ? t : void 0;
+}, p = (e) => {
+	let t = /* @__PURE__ */ new Map(), n = e.schema.ast;
+	for (let e of n?.propertySignatures ?? []) {
+		let n = [e.type, ...e.type.types ?? []];
+		for (let r of n) {
+			let n = f(r);
+			n !== void 0 && typeof e.name == "string" && t.set(e.name, n);
+		}
+	}
+	return t;
+}, m = typeof globalThis.process?.versions?.node == "string", h = Symbol.for("@voltro/content:root"), g = (e) => {
+	let t = globalThis;
+	t[h] = e;
+}, _ = () => globalThis[h] ?? null, v = Symbol.for("@voltro/content:assetResolver"), y = (e) => {
+	let t = globalThis;
+	t[v] = e;
+}, b = () => globalThis[v] ?? null, x = Symbol.for("@voltro/content:cache"), S = () => {
+	let e = globalThis;
+	return e[x] ??= /* @__PURE__ */ new Map();
+}, C = (e) => {
+	if (e === void 0) {
+		S().clear();
+		return;
+	}
+	for (let t of [...S().keys()]) (t === e || t.startsWith(`${e}|`)) && S().delete(t);
+}, w = (e, t) => {
+	let n = t === void 0 ? e.name : `${e.name}|${t}`, r = S().get(n);
+	return r === void 0 && 
+	// @vite-ignore keeps the whole render pipeline (marked + shiki grammars)
+	(r = import(
+		/* @vite-ignore */
+		"./serverLoad"
+).then(({ loadServerCollection: n }) => n(e, t)), S().set(n, r)), r;
+}, T = (e, t, n) => {
+	let r = t === void 0 ? e : `${e}.${t}`;
+	return n === void 0 ? `/assets/content/${r}/index.json` : `/assets/content/${r}/${n}.json`;
+}, E = async (e) => {
+	let t = await fetch(e);
+	return t.ok ? await t.json() : null;
+}, D = (e, t) => {
+	let n = s(e);
+	return n?.i18n === void 0 ? t : t ?? n.i18n.defaultLocale;
+}, O = async (e, t = {}) => {
+	if (m) {
+		let n = s(e);
+		if (n === void 0) throw Error(`getCollection('${e}'): no such collection is defined — export a defineCollection({ name: '${e}', … }) from a *.collection.ts.`);
+		return (await w(n, t.locale)).entries;
+	}
+	return await E(T(e, D(e, t.locale))) ?? [];
+}, k = async (e, t, n = {}) => {
+	if (m) {
+		let r = s(e);
+		if (r === void 0) throw Error(`getEntry('${e}'): no such collection is defined.`);
+		return (await w(r, n.locale)).bySlug.get(t) ?? null;
+	}
+	return await E(T(e, D(e, n.locale), t));
+}, A = async () => {
+	let { referenceFieldsOf: e, registeredCollections: t } = await Promise.resolve().then(() => n), r = [];
+	for (let n of t()) {
+		let t = e(n);
+		if (t.size === 0) continue;
+		let i = n.i18n?.locales ?? [void 0];
+		for (let e of i) {
+			let i = await O(n.name, e === void 0 ? {} : { locale: e });
+			for (let e of i) for (let [i, a] of t) {
+				let t = e.data[i];
+				typeof t == "string" && t !== "" && await k(a, t) === null && r.push(`collection '${n.name}', entry '${e.slug}': field '${i}' references '${t}' in collection '${a}' — no such entry.`);
+			}
+		}
+	}
+	if (r.length > 0) throw Error(`dangling content reference(s):\n${r.join("\n")}`);
+};
+//#endregion
+export { c as _, k as a, g as c, a as d, d as f, o as g, s as h, O as i, A as l, f as m, b as n, C as o, p, _ as r, y as s, T as t, u, l as v };

package/dist/index.js

@@ -1,119 +1,19 @@
-import { Schema as e } from "effect";
-//#region \0rolldown/runtime.js
-var t = Object.defineProperty, n = /* @__PURE__ */ ((e, n) => {
-	let r = {};
-	for (var i in e) t(r, i, {
-		get: e[i],
-		enumerable: !0
-	});
-	return n || t(r, Symbol.toStringTag, { value: "Module" }), r;
-})({
-	ReferenceTarget: () => u,
-	defineCollection: () => a,
-	reference: () => d,
-	referenceFieldsOf: () => p,
-	referenceTargetOf: () => f,
-	registeredCollection: () => s,
-	registeredCollections: () => o,
-	resetCollectionsForTest: () => c,
-	slugFromRelativePath: () => l
-}), r = Symbol.for("@voltro/content:collections"), i = () => {
-	let e = globalThis;
-	return e[r] ??= /* @__PURE__ */ new Map();
-}, a = (e) => {
-	let t = i().get(e.name);
-	if (t !== void 0 && t.directory !== e.directory) throw Error(`defineCollection('${e.name}') is declared twice with different directories ('${t.directory}' vs '${e.directory}') — collection names are global.`);
-	return i().set(e.name, e), e;
-}, o = () => [...i().values()], s = (e) => i().get(e), c = () => {
-	i().clear();
-}, l = (e) => e.replace(/\\/g, "/").replace(/\.(md|mdx|json)$/i, ""), u = Symbol.for("@voltro/content:reference-target"), d = (t) => e.String.annotations({ [u]: t }), f = (e) => {
-	let t = e.annotations?.[u];
-	return typeof t == "string" ? t : void 0;
-}, p = (e) => {
-	let t = /* @__PURE__ */ new Map(), n = e.schema.ast;
-	for (let e of n?.propertySignatures ?? []) {
-		let n = [e.type, ...e.type.types ?? []];
-		for (let r of n) {
-			let n = f(r);
-			n !== void 0 && typeof e.name == "string" && t.set(e.name, n);
-		}
-	}
-	return t;
-}, m = typeof globalThis.process?.versions?.node == "string", h = Symbol.for("@voltro/content:root"), g = (e) => {
-	let t = globalThis;
-	t[h] = e;
-}, _ = () => globalThis[h] ?? null, v = Symbol.for("@voltro/content:assetResolver"), y = (e) => {
-	let t = globalThis;
-	t[v] = e;
-}, b = () => globalThis[v] ?? null, x = Symbol.for("@voltro/content:cache"), S = () => {
-	let e = globalThis;
-	return e[x] ??= /* @__PURE__ */ new Map();
-}, C = (e) => {
-	if (e === void 0) {
-		S().clear();
-		return;
-	}
-	for (let t of [...S().keys()]) (t === e || t.startsWith(`${e}|`)) && S().delete(t);
-}, w = (e, t) => {
-	let n = t === void 0 ? e.name : `${e.name}|${t}`, r = S().get(n);
-	return r === void 0 && 
-	// @vite-ignore keeps the whole render pipeline (marked + shiki grammars)
-	(r = import(
-		/* @vite-ignore */
-		"./serverLoad"
-).then(({ loadServerCollection: n }) => n(e, t)), S().set(n, r)), r;
-}, T = (e, t, n) => {
-	let r = t === void 0 ? e : `${e}.${t}`;
-	return n === void 0 ? `/assets/content/${r}/index.json` : `/assets/content/${r}/${n}.json`;
-}, E = async (e) => {
-	let t = await fetch(e);
-	return t.ok ? await t.json() : null;
-}, D = (e, t) => {
-	let n = s(e);
-	return n?.i18n === void 0 ? t : t ?? n.i18n.defaultLocale;
-}, O = async (e, t = {}) => {
-	if (m) {
-		let n = s(e);
-		if (n === void 0) throw Error(`getCollection('${e}'): no such collection is defined — export a defineCollection({ name: '${e}', … }) from a *.collection.ts.`);
-		return (await w(n, t.locale)).entries;
-	}
-	return await E(T(e, D(e, t.locale))) ?? [];
-}, k = async (e, t, n = {}) => {
-	if (m) {
-		let r = s(e);
-		if (r === void 0) throw Error(`getEntry('${e}'): no such collection is defined.`);
-		return (await w(r, n.locale)).bySlug.get(t) ?? null;
-	}
-	return await E(T(e, D(e, n.locale), t));
-}, A = async () => {
-	let { referenceFieldsOf: e, registeredCollections: t } = await Promise.resolve().then(() => n), r = [];
-	for (let n of t()) {
-		let t = e(n);
-		if (t.size === 0) continue;
-		let i = n.i18n?.locales ?? [void 0];
-		for (let e of i) {
-			let i = await O(n.name, e === void 0 ? {} : { locale: e });
-			for (let e of i) for (let [i, a] of t) {
-				let t = e.data[i];
-				typeof t == "string" && t !== "" && await k(a, t) === null && r.push(`collection '${n.name}', entry '${e.slug}': field '${i}' references '${t}' in collection '${a}' — no such entry.`);
-			}
-		}
-	}
-	if (r.length > 0) throw Error(`dangling content reference(s):\n${r.join("\n")}`);
-}, j = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;"), M = (e) => {
+import { _ as e, a as t, c as n, d as r, f as i, g as a, h as o, i as s, l as c, m as l, n as u, o as d, p as f, r as p, s as m, t as h, u as g, v as _ } from "./get-BZwQfLp6.js";
+//#region src/feed.ts
+var v = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;"), y = (e) => {
 	let t = e instanceof Date ? e : new Date(e);
 	return Number.isNaN(t.getTime()) ? String(e) : t.toUTCString();
-}, N = (e, t) => {
+}, b = (e, t) => {
 	let n = t.siteUrl.replace(/\/+$/, ""), r = e.map((e) => t.item(e)).filter((e) => e !== null).sort((e, t) => new Date(t.date).getTime() - new Date(e.date).getTime()).map((e) => {
 		let t = e.link.startsWith("http") ? e.link : `${n}/${e.link.replace(/^\/+/, "")}`;
 		return [
 			"    <item>",
-			`      <title>${j(e.title)}</title>`,
-			`      <link>${j(t)}</link>`,
-			`      <guid isPermaLink="${e.guid === void 0 ? "true" : "false"}">${j(e.guid ?? t)}</guid>`,
-			`      <pubDate>${j(M(e.date))}</pubDate>`,
-			...e.description === void 0 ? [] : [`      <description>${j(e.description)}</description>`],
-			...(e.categories ?? []).map((e) => `      <category>${j(e)}</category>`),
+			`      <title>${v(e.title)}</title>`,
+			`      <link>${v(t)}</link>`,
+			`      <guid isPermaLink="${e.guid === void 0 ? "true" : "false"}">${v(e.guid ?? t)}</guid>`,
+			`      <pubDate>${v(y(e.date))}</pubDate>`,
+			...e.description === void 0 ? [] : [`      <description>${v(e.description)}</description>`],
+			...(e.categories ?? []).map((e) => `      <category>${v(e)}</category>`),
 			"    </item>"
 		].join("\n");
 	}).join("\n");
@@ -121,10 +21,10 @@ var t = Object.defineProperty, n = /* @__PURE__ */ ((e, n) => {
 		"<?xml version=\"1.0\" encoding=\"UTF-8\"?>",
 		"<rss version=\"2.0\" xmlns:atom=\"http://www.w3.org/2005/Atom\">",
 		"  <channel>",
-		`    <title>${j(t.title)}</title>`,
-		`    <link>${j(n)}</link>`,
-		...t.description === void 0 ? ["    <description></description>"] : [`    <description>${j(t.description)}</description>`],
-		`    <atom:link href="${j(`${n}${t.feedPath ?? "/rss.xml"}`)}" rel="self" type="application/rss+xml" />`,
+		`    <title>${v(t.title)}</title>`,
+		`    <link>${v(n)}</link>`,
+		...t.description === void 0 ? ["    <description></description>"] : [`    <description>${v(t.description)}</description>`],
+		`    <atom:link href="${v(`${n}${t.feedPath ?? "/rss.xml"}`)}" rel="self" type="application/rss+xml" />`,
 		...r === "" ? [] : [r],
 		"  </channel>",
 		"</rss>",
@@ -132,4 +32,4 @@ var t = Object.defineProperty, n = /* @__PURE__ */ ((e, n) => {
 	].join("\n");
 };
 //#endregion
-export { u as ReferenceTarget, N as buildFeed, T as contentArtifactPath, b as contentAssetResolver, _ as contentRoot, a as defineCollection, O as getCollection, k as getEntry, C as invalidateContentCache, d as reference, p as referenceFieldsOf, f as referenceTargetOf, s as registeredCollection, o as registeredCollections, c as resetCollectionsForTest, y as setContentAssetResolver, g as setContentRoot, l as slugFromRelativePath, A as validateReferences };
+export { g as ReferenceTarget, b as buildFeed, h as contentArtifactPath, u as contentAssetResolver, p as contentRoot, r as defineCollection, s as getCollection, t as getEntry, d as invalidateContentCache, i as reference, f as referenceFieldsOf, l as referenceTargetOf, o as registeredCollection, a as registeredCollections, e as resetCollectionsForTest, m as setContentAssetResolver, n as setContentRoot, _ as slugFromRelativePath, c as validateReferences };

package/dist/markdown.js

@@ -40,12 +40,38 @@ var t = typeof globalThis.process?.versions?.node == "string", n = (e) => {
 	"diff",
 	"text",
 	"txt"
-], u = () => t ? (c ??= import("shiki").then((e) => e.createHighlighter({
-	themes: ["github-light", "github-dark-dimmed"],
-	langs: [...l]
-})).catch(() => null), c) : Promise.resolve(null), d = async (t, n = {}) => {
-	let r = [], c = /* @__PURE__ */ new Map(), d = n.highlight === !1 ? null : await u(), f = new e.Renderer();
-	if (f.heading = ({ depth: t, tokens: n }) => {
+], u = (e) => import(e), d = (e) => e.default ?? e, f = () => t ? (c ??= (async () => {
+	let [e, t, n, r, i, ...a] = await Promise.all([
+		u("shiki/core"),
+		u("shiki/engine/oniguruma"),
+		u("shiki/wasm"),
+		u("@shikijs/themes/github-light"),
+		u("@shikijs/themes/github-dark-dimmed"),
+		...[
+			"typescript",
+			"tsx",
+			"javascript",
+			"jsx",
+			"json",
+			"bash",
+			"css",
+			"html",
+			"sql",
+			"yaml",
+			"toml",
+			"markdown",
+			"mdx",
+			"diff"
+		].map((e) => u(`@shikijs/langs/${e}`))
+	]), o = e.createHighlighterCore, s = t.createOnigurumaEngine;
+	return o({
+		themes: [d(r), d(i)],
+		langs: a.map(d),
+		engine: s(d(n))
+	});
+})().catch(() => null), c) : Promise.resolve(null), p = async (t, n = {}) => {
+	let r = [], c = /* @__PURE__ */ new Map(), u = n.highlight === !1 ? null : await f(), d = new e.Renderer();
+	if (d.heading = ({ depth: t, tokens: n }) => {
 		let a = e.Parser.parseInline(n), o = i(n), l = s(o), u = c.get(l) ?? 0;
 		c.set(l, u + 1);
 		let d = u === 0 ? l : `${l}-${u}`;
@@ -56,22 +82,22 @@ var t = typeof globalThis.process?.versions?.node == "string", n = (e) => {
 		}), `<h${t} id="${d}"><a class="heading-anchor" href="#${d}" aria-hidden="true">#</a>${a}</h${t}>\n`;
 	}, n.resolveLink !== void 0) {
 		let t = n.resolveLink;
-		f.link = ({ href: n, title: r, tokens: i }) => {
+		d.link = ({ href: n, title: r, tokens: i }) => {
 			let a = e.Parser.parseInline(i);
 			return `<a href="${t(n)}"${r ? ` title="${r}"` : ""}>${a}</a>`;
 		};
 	}
 	if (n.resolveImage !== void 0) {
 		let e = n.resolveImage;
-		f.image = ({ href: t, title: n, text: r }) => {
+		d.image = ({ href: t, title: n, text: r }) => {
 			let i = a(t) ? e(t) : t, s = n ? ` title="${o(n)}"` : "";
 			return `<img src="${o(i)}" alt="${o(r ?? "")}"${s} loading="lazy" decoding="async">`;
 		};
 	}
-	return f.code = ({ text: e, lang: t }) => {
+	return d.code = ({ text: e, lang: t }) => {
 		let r = (t ?? "").trim(), i = (r.split(/\s+/)[0] ?? "").toLowerCase(), a;
-		if (d !== null && l.includes(i)) try {
-			a = d.codeToHtml(e, {
+		if (u !== null && l.includes(i)) try {
+			a = u.codeToHtml(e, {
 				lang: i,
 				themes: {
 					light: "github-light",
@@ -92,12 +118,12 @@ var t = typeof globalThis.process?.versions?.node == "string", n = (e) => {
 		html: await e.parse(t, {
 			async: !0,
 			gfm: !0,
-			renderer: f
+			renderer: d
 		}),
 		headings: r
 	};
-}, f = async (e, t) => {
-	let n = await u(), r = (t ?? "").trim().split(/\s+/)[0]?.toLowerCase() ?? "";
+}, m = async (e, t) => {
+	let n = await f(), r = (t ?? "").trim().split(/\s+/)[0]?.toLowerCase() ?? "";
 	if (n !== null && l.includes(r)) try {
 		return n.codeToHtml(e, {
 			lang: r,
@@ -108,7 +134,7 @@ var t = typeof globalThis.process?.versions?.node == "string", n = (e) => {
 		});
 	} catch {}
 	return `<pre><code>${e.replace(/&/g, "&amp;").replace(/</g, "&lt;")}</code></pre>`;
-}, p = (t) => {
+}, h = (t) => {
 	let n = [], r = /* @__PURE__ */ new Map();
 	for (let a of e.lexer(t)) {
 		if (a.type !== "heading") continue;
@@ -122,4 +148,4 @@ var t = typeof globalThis.process?.versions?.node == "string", n = (e) => {
 	return n;
 };
 //#endregion
-export { p as extractHeadings, f as highlightCode, a as isRelativeAsset, r as parseFrontmatter, d as renderMarkdown, s as slugifyHeading };
+export { h as extractHeadings, m as highlightCode, a as isRelativeAsset, r as parseFrontmatter, p as renderMarkdown, s as slugifyHeading };

package/dist/serverLoad.d.ts

@@ -0,0 +1,98 @@
+import { Schema } from 'effect';
+
+declare interface CollectionDefinition<A = Record<string, unknown>> {
+    readonly name: string;
+    /** App-root-relative content directory (`content/posts`). */
+    readonly directory: string;
+    /** Frontmatter schema (markdown collections) or file schema (data
+     *  collections). Violations are BUILD/BOOT errors naming file + field. */
+    readonly schema: Schema.Schema<A, any, never>;
+    /** `'markdown'` (default): every `.md` under the directory, frontmatter +
+     *  rendered body. `'data'`: every `.json`, decoded whole — the
+     *  authors.json case, no render path. */
+    readonly kind?: 'markdown' | 'data';
+    readonly i18n?: CollectionLocales;
+    /** Render options for this collection's markdown bodies (link rewriting,
+     *  a code-fence hook, …) — applied wherever the SERVER renders an entry. */
+    readonly markdown?: RenderMarkdownOptions;
+}
+
+declare interface CollectionLocales {
+    /** The locale trees this collection carries (first path segment). */
+    readonly locales: ReadonlyArray<string>;
+    /**
+     * What a missing translation does: `'fallback'` (default) serves the
+     * defaultLocale's entry under the requested locale; `'missing'` omits it
+     * (the page 404s). Incomplete translations are the normal case — decide
+     * per collection instead of improvising per page.
+     */
+    readonly missing?: 'fallback' | 'missing';
+    readonly defaultLocale: string;
+}
+
+declare interface ContentEntry<A = Record<string, unknown>> {
+    readonly slug: string;
+    /** The locale tree this entry came from (localized collections only). When
+     *  the missing-policy substituted the default locale's entry, `locale` is
+     *  the REQUESTED locale and `fallback` is true. */
+    readonly locale?: string;
+    readonly fallback?: boolean;
+    readonly data: A;
+    /** Markdown collections: the rendered HTML (shiki included, server-rendered). */
+    readonly html?: string;
+    readonly headings?: ReadonlyArray<ContentHeading>;
+    /** Raw markdown body (server side; omitted from client artifacts by default). */
+    readonly body?: string;
+}
+
+declare interface ContentHeading {
+    readonly depth: number;
+    readonly slug: string;
+    readonly text: string;
+}
+
+export declare interface LoadedCollection {
+    readonly entries: ReadonlyArray<ContentEntry>;
+    readonly bySlug: ReadonlyMap<string, ContentEntry>;
+}
+
+export declare const loadServerCollection: (definition: CollectionDefinition, locale: string | undefined) => Promise<LoadedCollection>;
+
+declare interface RenderMarkdownOptions {
+    /** Rewrite relative links (`./sibling.md`, `../other/page.md`) into route
+     *  paths. Receives the raw href; return the replacement (or the input). */
+    readonly resolveLink?: (href: string) => string;
+    /**
+     * Rewrite a relative IMAGE source (`./cover.png`, `../img/x.jpg`) into a URL
+     * the built site can serve. Receives the raw src; return the replacement.
+     *
+     * Separate from `resolveLink` because the two answer different questions: a
+     * link resolves to a ROUTE, an image resolves to an ASSET that has to exist
+     * under `dist` — and without this hook a relative reference was emitted
+     * verbatim into the HTML, pointing at a path that is never copied. A built
+     * blog rendered broken images while the docs said the content pipeline copied
+     * and hashed them.
+     *
+     * Absolute (`/x.png`) and remote (`https://…`) sources are passed through
+     * untouched by the renderer and never reach this hook.
+     */
+    readonly resolveImage?: (src: string) => string;
+    /** Highlight code fences with shiki (node only; a browser call renders
+     *  plain `<pre>`). Default true. */
+    readonly highlight?: boolean;
+    /**
+     * Post-process one rendered code fence. Receives the raw code, the resolved
+     * language (first info-string token, lowercased), the FULL info string
+     * (` ```ts preview=data-table ` ⇒ `'ts preview=data-table'`), and the
+     * rendered html. Return the replacement html — e.g. append a live-demo
+     * mount point derived from the info string.
+     */
+    readonly codeFence?: (fence: {
+        readonly text: string;
+        readonly lang: string;
+        readonly info: string;
+        readonly html: string;
+    }) => string;
+}
+
+export { }

package/dist/serverLoad.js

@@ -0,0 +1,78 @@
+import { n as e, r as t, v as n } from "./get-BZwQfLp6.js";
+import { parseFrontmatter as r, renderMarkdown as i } from "./markdown.js";
+import { Schema as a } from "effect";
+//#region src/serverLoad.ts
+var o = (e, t, n) => {
+	let r = a.decodeUnknownEither(e.schema)(n);
+	if (r._tag === "Left") throw Error(`collection '${e.name}': ${t} does not match the declared schema:\n` + String(r.left));
+	return r.right;
+}, s = async (e) => {
+	let { readdir: t } = await import("node:fs/promises"), n = [], r = async (e, i) => {
+		let a;
+		try {
+			a = await t(e, { withFileTypes: !0 });
+		} catch {
+			return;
+		}
+		for (let t of a) t.name.startsWith(".") || (t.isDirectory() ? await r(`${e}/${t.name}`, `${i}${t.name}/`) : n.push(`${i}${t.name}`));
+	};
+	return await r(e, ""), n.sort();
+}, c = async (a, c) => {
+	let l = t();
+	if (l === null) throw Error(`getCollection('${a.name}') ran on the server without a registered content root — the boot path calls setContentRoot(appRoot). If you see this, the wiring is broken; report it.`);
+	let { readFile: u } = await import("node:fs/promises"), { join: d } = await import("node:path"), f = a.kind ?? "markdown", p = f === "data" ? /\.json$/i : /\.(md|mdx)$/i, m = d(l, a.directory), h = (await s(m)).filter((e) => p.test(e)), g = a.i18n === void 0 ? void 0 : c ?? a.i18n.defaultLocale, _ = [], v = /* @__PURE__ */ new Map(), y = /* @__PURE__ */ new Map();
+	for (let t of h) {
+		let s, c = t;
+		if (a.i18n !== void 0) {
+			let [e, ...n] = t.split("/");
+			if (e === void 0 || !a.i18n.locales.includes(e)) continue;
+			s = e, c = n.join("/");
+		}
+		if (a.i18n !== void 0 && s !== g && s !== a.i18n.defaultLocale) continue;
+		let l = n(c), p = await u(d(m, t), "utf8"), h;
+		if (f === "data") {
+			let e = o(a, t, JSON.parse(p));
+			h = {
+				slug: l,
+				...s === void 0 ? {} : { locale: s },
+				data: e
+			};
+		} else {
+			let { data: n, body: c } = r(p), u = o(a, t, n), f = e(), g = d(m, t), _ = await i(c, {
+				...a.markdown ?? {},
+				...f !== null && a.markdown?.resolveImage === void 0 ? { resolveImage: (e) => f({
+					src: e,
+					entryFile: g
+				}) } : {}
+			});
+			h = {
+				slug: l,
+				...s === void 0 ? {} : { locale: s },
+				data: u,
+				html: _.html,
+				headings: _.headings,
+				body: c
+			};
+		}
+		if (a.i18n !== void 0 && s === a.i18n.defaultLocale && y.set(l, h), a.i18n === void 0 || s === g) {
+			if (v.get(l) !== void 0) throw Error(`collection '${a.name}': duplicate slug '${l}' — two files resolve to one slug (a rename left both, or two extensions share a name). Every slug must be unique.`);
+			v.set(l, h), _.push(h);
+		}
+	}
+	if (a.i18n !== void 0 && g !== a.i18n.defaultLocale && (a.i18n.missing ?? "fallback") === "fallback") {
+		for (let [e, t] of y) if (!v.has(e)) {
+			let n = {
+				...t,
+				locale: g,
+				fallback: !0
+			};
+			v.set(e, n), _.push(n);
+		}
+	}
+	return _.sort((e, t) => e.slug < t.slug ? -1 : +(e.slug > t.slug)), {
+		entries: _,
+		bySlug: v
+	};
+};
+//#endregion
+export { c as loadServerCollection };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/content",
-  "version": "0.54.0",
+  "version": "0.56.0",
   "description": "Content collections — file-based, schema-typed markdown content (defineCollection over content/<name>/**/*.md with effect/Schema frontmatter), an isomorphic getCollection/getEntry (server: FS + rendered HTML with node-gated shiki; client: fetches the build-emitted JSON artifacts), heading extraction, locale trees with fallback, data collections, and a generic feed builder.",
   "keywords": [
     "voltro",
@@ -38,7 +38,9 @@
     "marked": "^18.0.9"
   },
   "optionalDependencies": {
-    "shiki": "^4.4.3"
+    "shiki": "^4.4.3",
+    "@shikijs/langs": "^4.4.3",
+    "@shikijs/themes": "^4.4.3"
   },
   "peerDependencies": {
     "effect": "^3.22.0"