@ox-content/vite-plugin 3.0.0-alpha.4 → 3.0.0-alpha.6

package/dist/index.mjs

@@ -11,14 +11,15 @@ import fs, { createReadStream, existsSync, readFileSync } from "node:fs";
 import * as path$1 from "node:path";
 import path, { dirname, extname, join, relative, resolve, sep } from "node:path";
 import * as fs$2 from "node:fs/promises";
-import { access, copyFile, cp, mkdir, mkdtemp, readFile, rm, stat, writeFile } from "node:fs/promises";
+import { access, copyFile, cp, mkdir, mkdtemp, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
 import { Buffer as Buffer$1 } from "node:buffer";
+import { createHash, randomBytes } from "node:crypto";
 import { tmpdir } from "node:os";
 import { promisify } from "node:util";
 import { execFile, spawn } from "node:child_process";
 import * as fs$3 from "fs/promises";
 import * as crypto from "crypto";
-import { createHash } from "node:crypto";
+import { lookup } from "node:dns/promises";
 import { deflateSync, inflateSync } from "node:zlib";
 import * as fs$1 from "fs";
 import { glob } from "glob";
@@ -449,7 +450,8 @@ async function transformPm(html, options) {
 * YouTube Plugin - Privacy-enhanced iframe embedding
 *
 * Transforms <YouTube> components into responsive iframe embeds using
-* youtube-nocookie.com for enhanced privacy.
+* youtube-nocookie.com for enhanced privacy. A digits-only `start` attribute
+* becomes `?start=` on the iframe URL.
 *
 * The HTML rewrite is performed in Rust (`transformYoutubeEmbeds` in
 * @ox-content/napi), replacing the previous rehype parse/stringify
@@ -480,7 +482,7 @@ async function transformYouTube(html, options) {
 }
 //#endregion
 //#region src/plugins/twitter/url.ts
-const STATUS_PATH = /^\/(?:[^/]+|i\/web)\/status\/(\d+)(?:\/.*)?$/;
+const STATUS_PATH$1 = /^\/(?:[^/]+|i\/web)\/status\/(\d+)(?:\/.*)?$/;
 function createSyndicationToken(id) {
 	return (Number(id) / 0x38d7ea4c68000 * Math.PI).toString(36).replaceAll(/(0+|\.)/g, "");
 }
@@ -494,7 +496,7 @@ function parseTweetReference(value) {
 		const url = new URL(trimmed);
 		const hostname = url.hostname.toLowerCase().replace(/^(?:www\.|mobile\.)/, "");
 		if (url.protocol !== "https:" || hostname !== "x.com" && hostname !== "twitter.com") return null;
-		const match = url.pathname.match(STATUS_PATH);
+		const match = url.pathname.match(STATUS_PATH$1);
 		if (!match) return null;
 		const screenName = url.pathname.startsWith("/i/web/status/") ? "i/web" : url.pathname.split("/")[1];
 		return {
@@ -505,10 +507,164 @@ function parseTweetReference(value) {
 		return null;
 	}
 }
-function referenceFromAttributes(attributes) {
+function tweetElementAttributes(attributes) {
 	const values = /* @__PURE__ */ new Map();
-	for (const match of attributes.matchAll(/\b(url|href|id)\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/gi)) values.set(match[1].toLowerCase(), match[2] ?? match[3] ?? match[4] ?? "");
-	return parseTweetReference(values.get("url") ?? values.get("href") ?? values.get("id") ?? "");
+	for (const match of attributes.matchAll(/\b(url|href|id|appearance)\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/gi)) values.set(match[1].toLowerCase(), match[2] ?? match[3] ?? match[4] ?? "");
+	const appearance = values.get("appearance");
+	return {
+		reference: parseTweetReference(values.get("url") ?? values.get("href") ?? values.get("id") ?? ""),
+		appearance: appearance === "full" || appearance === "compact" ? appearance : void 0
+	};
+}
+//#endregion
+//#region src/plugins/twitter/validate.ts
+const SCREEN_NAME = /^[A-Za-z0-9_]{1,15}$/;
+const STATUS_ID = /^\d+$/;
+const STATUS_PATH = /(?:x\.com|twitter\.com)\/(?:[^/]+|i\/web)\/status\/(\d+)/i;
+const TCO = /^https?:\/\/t\.co\/[A-Za-z0-9]+$/i;
+function isTweetData(data) {
+	return isTweetBodyData(data);
+}
+function parseTweetData(data) {
+	return isTweetData(data) ? normalizeTweetData(data) : null;
+}
+function isTweetBodyData(data) {
+	if (!data || typeof data !== "object") return false;
+	const value = data;
+	return typeof value.text === "string" && isTweetUser(value.user);
+}
+function isTweetUser(value) {
+	if (!value || typeof value !== "object") return false;
+	const user = value;
+	return typeof user.name === "string" && typeof user.screen_name === "string";
+}
+function normalizeTweetData(data) {
+	const handle = sanitizeScreenName(data.in_reply_to_screen_name);
+	return {
+		...data,
+		quoted_tweet: isTweetBodyData(data.quoted_tweet) ? stripNestedQuote(data.quoted_tweet) : void 0,
+		in_reply_to_screen_name: handle,
+		in_reply_to_status_id_str: handle ? sanitizeStatusId(data.in_reply_to_status_id_str) : void 0
+	};
+}
+function stripNestedQuote(data) {
+	const { quoted_tweet: _nested, ...quoted } = data;
+	return quoted;
+}
+function sanitizeScreenName(value) {
+	return value && SCREEN_NAME.test(value) ? value : void 0;
+}
+function sanitizeStatusId(value) {
+	return value && STATUS_ID.test(value) ? value : void 0;
+}
+function quotedPermalink(quoted) {
+	const id = sanitizeStatusId(quoted.id_str);
+	if (!id) return void 0;
+	return `https://x.com/${sanitizeScreenName(quoted.user.screen_name) ?? "i/web"}/status/${id}`;
+}
+function replyPermalink(data) {
+	const handle = sanitizeScreenName(data.in_reply_to_screen_name);
+	if (!handle) return void 0;
+	const id = sanitizeStatusId(data.in_reply_to_status_id_str);
+	return id ? `https://x.com/${handle}/status/${id}` : `https://x.com/${handle}`;
+}
+function visibleTextRange(data, omitTrailingQuoteUrl = false) {
+	const start = Math.max(0, data.display_text_range?.[0] ?? 0);
+	let end = Math.min(data.text.length, data.display_text_range?.[1] ?? data.text.length);
+	if (!omitTrailingQuoteUrl || start >= end) return [start, end];
+	const quoted = "quoted_tweet" in data ? data.quoted_tweet : void 0;
+	for (const entity of data.entities?.urls ?? []) {
+		const indices = entity.indices;
+		if (!indices || !isQuoteUrlEntity(entity, quoted)) continue;
+		const [entityStart, entityEnd] = indices;
+		if (entityStart >= start && isTrailingEntity(entityEnd, end, data.text)) end = Math.min(end, entityStart);
+	}
+	while (end > start && isUtf16Space(data.text, end - 1)) end -= 1;
+	return [start, end];
+}
+function isQuoteUrlEntity(entity, quoted) {
+	for (const href of [
+		entity.expanded_url,
+		entity.url,
+		entity.display_url
+	]) {
+		if (!href) continue;
+		const match = href.match(STATUS_PATH);
+		if (match) return !quoted?.id_str || match[1] === quoted.id_str;
+		if (TCO.test(href)) return true;
+	}
+	return false;
+}
+function isTrailingEntity(entityEnd, rangeEnd, text) {
+	if (entityEnd >= rangeEnd || entityEnd === text.length) return true;
+	return entityEnd > 0 && /^[\t\n\r ]*$/.test(text.slice(entityEnd, rangeEnd));
+}
+function isUtf16Space(text, index) {
+	const char = text[index];
+	return char === " " || char === "\n" || char === "	" || char === "\r";
+}
+//#endregion
+//#region src/plugins/twitter/video.ts
+const VIDEO_HOSTS = /* @__PURE__ */ new Set(["pbs.twimg.com", "video.twimg.com"]);
+function selectBestMp4Url(variants) {
+	const candidates = (variants ?? []).filter((variant) => isVideoMp4Type(variant.content_type) && isAllowedVideoUrl(variant.url));
+	if (candidates.length === 0) return void 0;
+	return candidates.reduce((best, variant) => {
+		const bestBitrate = best.bitrate ?? Number.NEGATIVE_INFINITY;
+		const nextBitrate = variant.bitrate ?? Number.NEGATIVE_INFINITY;
+		if (nextBitrate > bestBitrate) return variant;
+		if (nextBitrate === bestBitrate && variant.url < best.url) return variant;
+		return best;
+	}).url;
+}
+function isVideoMp4Type(value) {
+	return (value ?? "").split(";", 1)[0].trim().toLowerCase() === "video/mp4";
+}
+function isAllowedVideoUrl(value) {
+	if (!value) return false;
+	try {
+		const url = new URL(value);
+		return url.protocol === "https:" && VIDEO_HOSTS.has(url.hostname.toLowerCase());
+	} catch {
+		return false;
+	}
+}
+async function downloadVideoAsset(source, basename, options) {
+	if (!isAllowedVideoUrl(source)) return void 0;
+	const filename = `${sanitizeFilename(basename)}.mp4`;
+	const output = path.join(options.mediaOutputDir, filename);
+	const publicPath = joinPublicPath$1(options.mediaPublicPath, filename);
+	try {
+		await access(output);
+		return publicPath;
+	} catch {}
+	const controller = new AbortController();
+	const timeout = setTimeout(() => controller.abort(), options.timeout);
+	try {
+		const response = await fetch(source, {
+			headers: { Accept: "video/mp4" },
+			signal: controller.signal
+		});
+		if (!response.ok) return void 0;
+		if (!isVideoMp4Type(response.headers?.get("content-type"))) return void 0;
+		const declared = Number(response.headers?.get("content-length"));
+		if (Number.isFinite(declared) && declared > options.maxVideoBytes) return void 0;
+		const bytes = new Uint8Array(await response.arrayBuffer());
+		if (bytes.byteLength > options.maxVideoBytes) return void 0;
+		await mkdir(options.mediaOutputDir, { recursive: true });
+		await writeFile(output, bytes);
+		return publicPath;
+	} catch {
+		return;
+	} finally {
+		clearTimeout(timeout);
+	}
+}
+function sanitizeFilename(value) {
+	return value.replaceAll(/[^a-zA-Z0-9_-]/g, "-") || "video";
+}
+function joinPublicPath$1(prefix, filename) {
+	return `${prefix.replace(/\/$/, "")}/${filename}`;
 }
 //#endregion
 //#region src/plugins/twitter/fetch.ts
@@ -536,8 +692,8 @@ async function fetchTweetData(id, options) {
 			signal: controller.signal
 		});
 		if (!response.ok) return null;
-		const data = await response.json();
-		if (!isTweetData(data)) return null;
+		const data = parseTweetData(await response.json());
+		if (!data) return null;
 		if (options.cache) {
 			tweetCache.set(key, data);
 			await writeCachedTweet(key, data, options.cacheDir);
@@ -550,15 +706,29 @@ async function fetchTweetData(id, options) {
 	}
 }
 async function materializeTweetAssets(id, data, options) {
+	const assets = await materializeBodyAssets(id, data, options);
+	if (data.quoted_tweet) assets.quoted = await materializeBodyAssets(`${id}-quoted`, data.quoted_tweet, options);
+	return assets;
+}
+async function materializeBodyAssets(id, data, options) {
 	const assets = { media: [] };
 	const avatarUrl = data.user.profile_image_url_https?.replace(/_normal(?=\.[^.]+$)/, "_bigger");
 	if (avatarUrl) assets.avatar = await downloadAsset(avatarUrl, `${id}-avatar`, options);
 	const media = data.mediaDetails ?? data.entities?.media ?? [];
 	for (const [index, item] of media.entries()) {
-		if (item.type && item.type !== "photo") continue;
-		if (!item.media_url_https) continue;
-		const src = await downloadAsset(item.media_url_https, `${id}-media-${index + 1}`, options);
-		if (src) assets.media.push(assetRecord(src, item));
+		const kind = item.type === "video" || item.type === "animated_gif" ? item.type : "photo";
+		const basename = `${id}-media-${index + 1}`;
+		if (kind === "photo") {
+			if (item.type && item.type !== "photo") continue;
+			if (!item.media_url_https) continue;
+			const src = await downloadAsset(item.media_url_https, basename, options);
+			if (src) assets.media.push(assetRecord("photo", src, item));
+			continue;
+		}
+		const poster = item.media_url_https ? await downloadAsset(item.media_url_https, `${basename}-poster`, options) : void 0;
+		const videoUrl = options.downloadVideo ? selectBestMp4Url(item.video_info?.variants) : void 0;
+		const src = videoUrl ? await downloadVideoAsset(videoUrl, basename, options) : void 0;
+		assets.media.push(assetRecord(kind, src, item, poster));
 	}
 	return assets;
 }
@@ -588,8 +758,7 @@ async function downloadAsset(source, basename, options) {
 }
 async function readCachedTweet(key, directory) {
 	try {
-		const data = JSON.parse(await readFile(path.join(directory, `${key}.json`), "utf8"));
-		return isTweetData(data) ? data : null;
+		return parseTweetData(JSON.parse(await readFile(path.join(directory, `${key}.json`), "utf8")));
 	} catch {
 		return null;
 	}
@@ -600,11 +769,6 @@ async function writeCachedTweet(key, data, directory) {
 		await writeFile(path.join(directory, `${key}.json`), `${JSON.stringify(data)}\n`);
 	} catch {}
 }
-function isTweetData(data) {
-	if (!data || typeof data !== "object") return false;
-	const value = data;
-	return typeof value.text === "string" && Boolean(value.user) && typeof value.user?.name === "string" && typeof value.user.screen_name === "string";
-}
 function extensionFromUrl(url) {
 	const match = url.pathname.match(/\.(jpe?g|png|webp|gif)$/i);
 	return match ? `.${match[1].toLowerCase().replace("jpeg", "jpg")}` : ".jpg";
@@ -615,39 +779,64 @@ function joinPublicPath(prefix, filename) {
 function sanitizeSegment(value) {
 	return value.replaceAll(/[^a-zA-Z0-9_-]/g, "-");
 }
-function assetRecord(src, media) {
+function assetRecord(kind, src, media, poster) {
 	return {
+		kind,
 		src,
+		poster,
 		alt: media.ext_alt_text,
 		width: media.original_info?.width,
 		height: media.original_info?.height
 	};
 }
 //#endregion
-//#region src/plugins/twitter/render.ts
-function renderFetchedTweet(permalink, data, assets, options) {
-	const profile = `https://x.com/${encodeURIComponent(data.user.screen_name)}`;
-	const author = escapeHtml$6(data.user.name);
-	const handle = escapeHtml$6(data.user.screen_name);
-	const avatar = assets.avatar ? `<img class="ox-tweet__avatar" src="${escapeAttribute$2(assets.avatar)}" alt="" width="48" height="48" loading="lazy" decoding="async">` : "";
-	const media = renderMedia(assets);
-	const footer = renderFooter(permalink, data.created_at, options.lang);
-	return [
-		"<figure class=\"ox-tweet ox-tweet--fetched\">",
-		"<header class=\"ox-tweet__header\">",
-		`<a class="ox-tweet__profile" href="${escapeAttribute$2(profile)}" target="_blank" rel="noopener noreferrer">`,
-		avatar,
-		`<span class="ox-tweet__author-name">${author}</span>`,
-		`<span class="ox-tweet__author-handle">@${handle}</span>`,
-		"</a></header>",
-		`<div class="ox-tweet__body">${renderTweetText(data)}</div>`,
-		media,
-		footer,
-		"</figure>"
-	].join("");
+//#region src/plugins/twitter/html.ts
+function escapeText(value) {
+	return escapeHtml$6(value).replaceAll("\n", "<br>");
+}
+function escapeAttribute$3(value) {
+	return escapeHtml$6(value).replaceAll("`", "&#96;");
+}
+function escapeHtml$6(value) {
+	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
 }
-function renderTweetText(data) {
-	const [start, end] = data.display_text_range ?? [0, data.text.length];
+//#endregion
+//#region src/plugins/twitter/markup.ts
+function renderMedia(assets, permalink) {
+	if (assets.media.length === 0) return "";
+	const items = assets.media.map((item) => renderMediaItem(item, permalink)).join("");
+	return `<div class="ox-tweet__media" data-count="${assets.media.length}">${items}</div>`;
+}
+function renderMediaItem(item, permalink) {
+	if (item.kind === "video" || item.kind === "animated_gif") return renderVideoItem(item, permalink);
+	const size = sizeAttributes(item);
+	return `<img class="ox-tweet__media-item" src="${escapeAttribute$3(item.src ?? "")}" alt="${escapeAttribute$3(item.alt ?? "")}"${size} loading="lazy" decoding="async">`;
+}
+function renderVideoItem(item, permalink) {
+	const watch = watchOnX(permalink);
+	const size = sizeAttributes(item);
+	const src = selfHostedMediaSrc(item.src);
+	if (src) {
+		const poster = item.poster ? ` poster="${escapeAttribute$3(item.poster)}"` : "";
+		const gif = item.kind === "animated_gif" ? " muted loop" : "";
+		return `<video class="ox-tweet__media-item" src="${escapeAttribute$3(src)}"${poster}${size} controls playsinline preload="none"${gif}>${watch}</video>`;
+	}
+	return `<div class="ox-tweet__media-item ox-tweet__media-fallback">${item.poster ? `<img src="${escapeAttribute$3(item.poster)}" alt="${escapeAttribute$3(item.alt ?? "")}"${size} loading="lazy" decoding="async">` : ""}${watch}</div>`;
+}
+function selfHostedMediaSrc(src) {
+	return src && !src.includes("video.twimg.com") ? src : void 0;
+}
+function sizeAttributes(item) {
+	return [item.width ? ` width="${item.width}"` : "", item.height ? ` height="${item.height}"` : ""].join("");
+}
+function watchOnX(permalink) {
+	if (!permalink) return "";
+	return `<a class="ox-tweet__watch" href="${escapeAttribute$3(permalink)}" target="_blank" rel="noopener noreferrer">Watch on X</a>`;
+}
+//#endregion
+//#region src/plugins/twitter/text.ts
+function renderTweetText(data, options) {
+	const [start, end] = visibleTextRange(data, options?.omitTrailingQuoteUrl === true);
 	const entities = collectEntities(data).filter((entity) => validRange(entity.indices, start, end)).sort((left, right) => left.indices[0] - right.indices[0]);
 	let cursor = start;
 	let output = "";
@@ -655,10 +844,9 @@ function renderTweetText(data) {
 		const [entityStart, entityEnd] = entity.indices;
 		if (entityStart < cursor) continue;
 		output += escapeText(data.text.slice(cursor, entityStart));
-		if (entity.kind === "url") {
-			const href = entity.expanded_url ?? entity.url;
-			const label = entity.display_url ?? href;
-			output += `<a href="${escapeAttribute$2(href)}" target="_blank" rel="noopener noreferrer">${escapeHtml$6(label)}</a>`;
+		if (entity.href) {
+			const label = entity.label ?? data.text.slice(entityStart, entityEnd);
+			output += `<a href="${escapeAttribute$3(entity.href)}" target="_blank" rel="noopener noreferrer">${escapeHtml$6(label)}</a>`;
 		}
 		cursor = entityEnd;
 	}
@@ -666,27 +854,228 @@ function renderTweetText(data) {
 	return output.trim();
 }
 function collectEntities(data) {
-	return [...(data.entities?.urls ?? []).map((entity) => ({
-		...entity,
-		kind: "url"
-	})), ...(data.entities?.media ?? []).map((entity) => ({
-		...entity,
-		kind: "media"
-	}))];
+	const collected = [];
+	for (const entity of data.entities?.urls ?? []) collected.push({
+		kind: "url",
+		indices: entity.indices,
+		href: entity.expanded_url ?? entity.url,
+		label: entity.display_url ?? entity.expanded_url ?? entity.url
+	});
+	for (const entity of data.entities?.media ?? []) collected.push({
+		kind: "media",
+		indices: entity.indices
+	});
+	for (const entity of data.entities?.hashtags ?? []) {
+		if (!entity.text) continue;
+		collected.push({
+			kind: "hashtag",
+			indices: entity.indices,
+			href: `https://x.com/hashtag/${encodeURIComponent(entity.text)}`
+		});
+	}
+	for (const entity of data.entities?.user_mentions ?? []) {
+		const screen = sanitizeScreenName(entity.screen_name);
+		if (!screen) continue;
+		collected.push({
+			kind: "mention",
+			indices: entity.indices,
+			href: `https://x.com/${encodeURIComponent(screen)}`
+		});
+	}
+	for (const entity of data.entities?.symbols ?? []) {
+		if (!entity.text) continue;
+		collected.push({
+			kind: "symbol",
+			indices: entity.indices,
+			href: `https://x.com/search?q=%24${encodeURIComponent(entity.text)}`
+		});
+	}
+	return collected;
 }
 function validRange(indices, start, end) {
 	return Boolean(indices && indices[0] >= start && indices[1] <= end && indices[0] < indices[1]);
 }
-function renderMedia(assets) {
-	if (assets.media.length === 0) return "";
-	const images = assets.media.map((item) => {
-		const size = [item.width ? ` width="${item.width}"` : "", item.height ? ` height="${item.height}"` : ""].join("");
-		return `<img class="ox-tweet__media-item" src="${escapeAttribute$2(item.src)}" alt="${escapeAttribute$2(item.alt ?? "")}"${size} loading="lazy" decoding="async">`;
-	}).join("");
-	return `<div class="ox-tweet__media" data-count="${assets.media.length}">${images}</div>`;
+//#endregion
+//#region src/plugins/twitter/full.ts
+const HELP_HREF = "https://help.x.com/en/x-for-websites-ads-info-and-privacy";
+function renderFullTweet(permalink, data, assets) {
+	const quote = data.quoted_tweet ? renderFullQuote(data.quoted_tweet, assets.quoted) : "";
+	return [
+		"<figure class=\"ox-tweet ox-tweet--fetched ox-tweet--full\">",
+		renderFullHeader(data.user, assets.avatar, permalink),
+		renderReply$1(data),
+		`<div class="ox-tweet__body">${renderTweetText(data, { omitTrailingQuoteUrl: Boolean(quote) })}</div>`,
+		renderMedia(assets, permalink),
+		quote,
+		renderInfo(permalink, data.created_at),
+		renderActions(permalink, data),
+		renderReplies(permalink, data.conversation_count),
+		"</figure>"
+	].join("");
+}
+function renderFullQuote(data, assets) {
+	const permalink = quotedPermalink(data) ?? "";
+	return [
+		"<blockquote class=\"ox-tweet__quote\">",
+		renderQuoteHeader(data.user, assets?.avatar, permalink),
+		`<div class="ox-tweet__quote-body">${renderTweetText(data)}</div>`,
+		renderMedia(assets ?? { media: [] }, permalink),
+		"</blockquote>"
+	].join("");
+}
+function renderFullHeader(user, avatarSrc, permalink) {
+	const profile = profileHref(user);
+	const follow = followHref(user);
+	return [
+		"<header class=\"ox-tweet__header\">",
+		`<a class="ox-tweet__avatar-link" href="${escapeAttribute$3(profile)}" target="_blank" rel="noopener noreferrer">`,
+		avatar(avatarSrc, 48),
+		"</a>",
+		"<div class=\"ox-tweet__author\">",
+		`<a class="ox-tweet__author-name" href="${escapeAttribute$3(profile)}" target="_blank" rel="noopener noreferrer">${escapeHtml$6(user.name)}${verifiedBadge(user)}</a>`,
+		"<div class=\"ox-tweet__author-meta\">",
+		`<a class="ox-tweet__author-handle" href="${escapeAttribute$3(profile)}" target="_blank" rel="noopener noreferrer">@${escapeHtml$6(user.screen_name)}</a>`,
+		follow ? `<span class="ox-tweet__sep" aria-hidden="true">·</span><a class="ox-tweet__follow" href="${escapeAttribute$3(follow)}" target="_blank" rel="noopener noreferrer">Follow</a>` : "",
+		"</div></div>",
+		`<a class="ox-tweet__brand" href="${escapeAttribute$3(permalink)}" target="_blank" rel="noopener noreferrer" aria-label="View on X"><span class="ox-tweet__icon ox-tweet__icon--x"></span></a>`,
+		"</header>"
+	].join("");
+}
+function renderQuoteHeader(user, avatarSrc, permalink) {
+	return [
+		"<header class=\"ox-tweet__quote-header\">",
+		`<a class="ox-tweet__profile" href="${escapeAttribute$3(permalink || profileHref(user))}" target="_blank" rel="noopener noreferrer">`,
+		avatar(avatarSrc, 20),
+		`<span class="ox-tweet__author-name">${escapeHtml$6(user.name)}${verifiedBadge(user)}</span>`,
+		`<span class="ox-tweet__author-handle">@${escapeHtml$6(user.screen_name)}</span>`,
+		"</a></header>"
+	].join("");
+}
+function renderReply$1(data) {
+	const href = replyPermalink(data);
+	const handle = data.in_reply_to_screen_name;
+	if (!href || !handle) return "";
+	return `<p class="ox-tweet__reply"><a class="ox-tweet__reply-link" href="${escapeAttribute$3(href)}" target="_blank" rel="noopener noreferrer">Replying to @${escapeHtml$6(handle)}</a></p>`;
+}
+function renderInfo(permalink, createdAt) {
+	const formatted = formatFullDate(createdAt);
+	return `<div class="ox-tweet__info">${formatted ? `<a class="ox-tweet__permalink" href="${escapeAttribute$3(permalink)}" target="_blank" rel="noopener noreferrer"><time datetime="${formatted.iso}">${escapeHtml$6(formatted.label)}</time></a>` : `<a class="ox-tweet__permalink" href="${escapeAttribute$3(permalink)}" target="_blank" rel="noopener noreferrer">View on X</a>`}<a class="ox-tweet__info-help" href="${HELP_HREF}" target="_blank" rel="noopener noreferrer" aria-label="X for Websites, Ads Information and Privacy"><span class="ox-tweet__icon ox-tweet__icon--info"></span></a></div>`;
+}
+function renderActions(permalink, data) {
+	const id = statusId(data, permalink);
+	if (!id) return "";
+	return [
+		"<div class=\"ox-tweet__actions\">",
+		`<a class="ox-tweet__action ox-tweet__action--like" href="https://x.com/intent/like?tweet_id=${id}" target="_blank" rel="noopener noreferrer"><span class="ox-tweet__icon ox-tweet__icon--like"></span><span>${formatCount(data.favorite_count)}</span></a>`,
+		`<a class="ox-tweet__action ox-tweet__action--reply" href="https://x.com/intent/tweet?in_reply_to=${id}" target="_blank" rel="noopener noreferrer"><span class="ox-tweet__icon ox-tweet__icon--reply"></span>Reply</a>`,
+		"</div>"
+	].join("");
+}
+function renderReplies(permalink, conversationCount) {
+	return `<p class="ox-tweet__replies"><a class="ox-tweet__replies-link" href="${escapeAttribute$3(permalink)}" target="_blank" rel="noopener noreferrer">${escapeHtml$6(repliesLabel(conversationCount))}</a></p>`;
+}
+function avatar(src, size) {
+	return src ? `<img class="ox-tweet__avatar" src="${escapeAttribute$3(src)}" alt="" width="${size}" height="${size}" loading="lazy" decoding="async">` : "";
+}
+function verifiedBadge(user) {
+	const kind = verifiedKind(user);
+	return kind ? `<span class="ox-tweet__badge ox-tweet__badge--${kind}" title="Verified"></span>` : "";
+}
+function verifiedKind(user) {
+	if (user.verified_type === "Government") return "gray";
+	if (user.verified_type === "Business") return "gold";
+	if (user.is_blue_verified) return "blue";
+	if (user.verified) return "gray";
+}
+function profileHref(user) {
+	const screen = sanitizeScreenName(user.screen_name) ?? user.screen_name;
+	return `https://x.com/${encodeURIComponent(screen)}`;
+}
+function followHref(user) {
+	const screen = sanitizeScreenName(user.screen_name);
+	return screen ? `https://x.com/intent/follow?screen_name=${encodeURIComponent(screen)}` : void 0;
+}
+function statusId(data, permalink) {
+	return sanitizeStatusId(data.id_str) ?? permalink.match(/\/status\/(\d+)/)?.[1];
+}
+function formatCount(value) {
+	const n = typeof value === "number" && Number.isFinite(value) && value >= 0 ? Math.floor(value) : 0;
+	if (n > 999999) return `${(n / 1e6).toFixed(1)}M`;
+	if (n > 999) return `${(n / 1e3).toFixed(1)}K`;
+	return String(n);
+}
+function repliesLabel(value) {
+	const n = typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : 0;
+	if (n === 0) return "Read more on X";
+	if (n === 1) return "Read 1 reply";
+	return `Read ${formatCount(n)} replies`;
+}
+function formatFullDate(createdAt) {
+	if (!createdAt) return void 0;
+	const date = new Date(createdAt);
+	if (Number.isNaN(date.valueOf())) return void 0;
+	const parts = new Intl.DateTimeFormat("en-US", {
+		hour: "numeric",
+		minute: "2-digit",
+		hour12: true,
+		month: "short",
+		day: "numeric",
+		year: "numeric",
+		timeZone: "UTC"
+	}).formatToParts(date);
+	const get = (type) => parts.find((part) => part.type === type)?.value ?? "";
+	return {
+		iso: date.toISOString(),
+		label: `${get("hour")}:${get("minute")} ${get("dayPeriod")} · ${get("month")} ${get("day")}, ${get("year")}`
+	};
+}
+//#endregion
+//#region src/plugins/twitter/render.ts
+function renderFetchedTweet(permalink, data, assets, options) {
+	if (options.appearance === "full") return renderFullTweet(permalink, data, assets);
+	const quote = data.quoted_tweet ? renderQuotedTweet(data.quoted_tweet, assets.quoted) : "";
+	return [
+		"<figure class=\"ox-tweet ox-tweet--fetched\">",
+		renderHeader(data.user, assets.avatar),
+		renderReply(data),
+		`<div class="ox-tweet__body">${renderTweetText(data, { omitTrailingQuoteUrl: Boolean(quote) })}</div>`,
+		renderMedia(assets, permalink),
+		quote,
+		renderFooter(permalink, data.created_at, options.lang),
+		"</figure>"
+	].join("");
+}
+function renderQuotedTweet(data, assets) {
+	const permalink = quotedPermalink(data) ?? "";
+	return [
+		"<blockquote class=\"ox-tweet__quote\">",
+		renderHeader(data.user, assets?.avatar, permalink || void 0, "ox-tweet__quote-header"),
+		`<div class="ox-tweet__quote-body">${renderTweetText(data)}</div>`,
+		renderMedia(assets ?? { media: [] }, permalink),
+		"</blockquote>"
+	].join("");
+}
+function renderHeader(user, avatarSrc, href, headerClass = "ox-tweet__header") {
+	const screen = sanitizeScreenName(user.screen_name) ?? user.screen_name;
+	const profile = href ?? `https://x.com/${encodeURIComponent(screen)}`;
+	const avatar = avatarSrc ? `<img class="ox-tweet__avatar" src="${escapeAttribute$3(avatarSrc)}" alt="" width="48" height="48" loading="lazy" decoding="async">` : "";
+	return [
+		`<header class="${headerClass}">`,
+		`<a class="ox-tweet__profile" href="${escapeAttribute$3(profile)}" target="_blank" rel="noopener noreferrer">`,
+		avatar,
+		`<span class="ox-tweet__author-name">${escapeHtml$6(user.name)}</span>`,
+		`<span class="ox-tweet__author-handle">@${escapeHtml$6(user.screen_name)}</span>`,
+		"</a></header>"
+	].join("");
+}
+function renderReply(data) {
+	const href = replyPermalink(data);
+	const handle = data.in_reply_to_screen_name;
+	if (!href || !handle) return "";
+	return `<p class="ox-tweet__reply"><a class="ox-tweet__reply-link" href="${escapeAttribute$3(href)}" target="_blank" rel="noopener noreferrer">Replying to @${escapeHtml$6(handle)}</a></p>`;
 }
 function renderFooter(permalink, createdAt, lang) {
-	if (!createdAt) return `<footer class="ox-tweet__footer"><a class="ox-tweet__permalink" href="${escapeAttribute$2(permalink)}" target="_blank" rel="noopener noreferrer">View on X</a></footer>`;
+	if (!createdAt) return `<footer class="ox-tweet__footer"><a class="ox-tweet__permalink" href="${escapeAttribute$3(permalink)}" target="_blank" rel="noopener noreferrer">View on X</a></footer>`;
 	const date = new Date(createdAt);
 	if (Number.isNaN(date.valueOf())) return renderFooter(permalink, void 0, lang);
 	const iso = date.toISOString();
@@ -702,16 +1091,7 @@ function renderFooter(permalink, createdAt, lang) {
 			timeZone: "UTC"
 		}).format(date);
 	}
-	return `<footer class="ox-tweet__footer"><a class="ox-tweet__permalink" href="${escapeAttribute$2(permalink)}" target="_blank" rel="noopener noreferrer"><time datetime="${iso}">${escapeHtml$6(label)}</time></a></footer>`;
-}
-function escapeText(value) {
-	return escapeHtml$6(value).replaceAll("\n", "<br>");
-}
-function escapeAttribute$2(value) {
-	return escapeHtml$6(value).replaceAll("`", "&#96;");
-}
-function escapeHtml$6(value) {
-	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
+	return `<footer class="ox-tweet__footer"><a class="ox-tweet__permalink" href="${escapeAttribute$3(permalink)}" target="_blank" rel="noopener noreferrer"><time datetime="${iso}">${escapeHtml$6(label)}</time></a></footer>`;
 }
 //#endregion
 //#region src/plugins/twitter/transform.ts
@@ -724,7 +1104,10 @@ function resolveTwitterEmbedOptions$1(options) {
 		cache: options.cache ?? true,
 		cacheDir: path.resolve(options.cacheDir ?? ".cache/ox-content/twitter"),
 		mediaOutputDir: path.resolve(options.mediaOutputDir ?? "public/ox-content/twitter"),
-		mediaPublicPath: options.mediaPublicPath ?? "/ox-content/twitter"
+		mediaPublicPath: options.mediaPublicPath ?? "/ox-content/twitter",
+		downloadVideo: options.downloadVideo ?? false,
+		maxVideoBytes: options.maxVideoBytes ?? 8388608,
+		appearance: options.appearance === "full" ? "full" : "compact"
 	};
 }
 async function transformFetchedTweets(html, options) {
@@ -735,20 +1118,23 @@ async function transformFetchedTweets(html, options) {
 	for (const match of html.matchAll(TWEET_ELEMENT)) {
 		const index = match.index ?? 0;
 		output += html.slice(cursor, index);
-		const reference = referenceFromAttributes(match[2]);
-		if (!reference) {
+		const attrs = tweetElementAttributes(match[2]);
+		if (!attrs.reference) {
 			output += match[0];
 			cursor = index + match[0].length;
 			continue;
 		}
-		const data = await fetchTweetData(reference.id, resolved);
+		const data = await fetchTweetData(attrs.reference.id, resolved);
 		if (!data) {
 			output += match[0];
 			cursor = index + match[0].length;
 			continue;
 		}
-		const assets = await materializeTweetAssets(reference.id, data, resolved);
-		output += renderFetchedTweet(reference.url, data, assets, resolved);
+		const assets = await materializeTweetAssets(attrs.reference.id, data, resolved);
+		output += renderFetchedTweet(attrs.reference.url, data, assets, {
+			...resolved,
+			appearance: attrs.appearance ?? resolved.appearance
+		});
 		cursor = index + match[0].length;
 	}
 	return output + html.slice(cursor);
@@ -891,7 +1277,7 @@ function inferLanguage(path) {
 }
 //#endregion
 //#region src/plugins/github/types.ts
-const defaultOptions$1 = {
+const defaultOptions = {
 	token: "",
 	cache: true,
 	cacheTTL: 36e5,
@@ -1001,7 +1387,7 @@ async function fetchGitHubSource(source, options) {
 */
 async function prefetchGitHubRepos(repos, options) {
 	const mergedOptions = {
-		...defaultOptions$1,
+		...defaultOptions,
 		...options
 	};
 	const results = /* @__PURE__ */ new Map();
@@ -1016,7 +1402,7 @@ async function prefetchGitHubRepos(repos, options) {
 */
 async function prefetchGitHubSources(sources, options) {
 	const mergedOptions = {
-		...defaultOptions$1,
+		...defaultOptions,
 		...options
 	};
 	const results = /* @__PURE__ */ new Map();
@@ -1433,7 +1819,7 @@ function rehypeGitHub(repoDataMap, sourceDataMap, options) {
 */
 async function transformGitHub(html, repoDataMap, options) {
 	const mergedOptions = {
-		...defaultOptions$1,
+		...defaultOptions,
 		...options
 	};
 	let dataMap = repoDataMap;
@@ -1446,29 +1832,111 @@ async function transformGitHub(html, repoDataMap, options) {
 //#region src/plugins/github.ts
 var github_exports = /* @__PURE__ */ __exportAll({ transformGitHub: () => transformGitHub });
 //#endregion
-//#region src/plugins/ogp.ts
-/**
-* OGP Card Plugin - Link card embedding
-*
-* Transforms <OgCard> components into static link preview cards
-* by fetching OGP metadata at build time.
-*/
-var ogp_exports = /* @__PURE__ */ __exportAll({
-	collectOgpUrls: () => collectOgpUrls,
-	fetchOgpData: () => fetchOgpData,
-	isSafeOgpUrl: () => isSafeOgpUrl,
-	prefetchOgpData: () => prefetchOgpData,
-	transformOgp: () => transformOgp
-});
-const rehypeParse$1 = interopDefault(rehypeParsePlugin);
-const rehypeStringify$1 = interopDefault(rehypeStringifyPlugin);
-const defaultOptions = {
-	timeout: 1e4,
-	cache: true,
-	cacheTTL: 36e5,
-	userAgent: "ox-content-ogp-bot/1.0 (compatible; +https://github.com/ubugeeei-prod/ox-content)"
-};
-const ogpCache = /* @__PURE__ */ new Map();
+//#region src/plugins/ogp/cache.ts
+const memoryCache = /* @__PURE__ */ new Map();
+function ogpCacheFilePath(directory, key) {
+	return path.join(directory, `${key}.json`);
+}
+function isFreshOgpEntry(cachedAt, ttl, now) {
+	return now - cachedAt < ttl;
+}
+function parseOgpCacheEntry(value) {
+	if (!value || typeof value !== "object") return null;
+	const entry = value;
+	if (entry.v !== 1) return null;
+	if (typeof entry.url !== "string" || entry.url.length === 0) return null;
+	if (typeof entry.cachedAt !== "number" || !Number.isFinite(entry.cachedAt)) return null;
+	if (entry.data !== null && !isOgpData(entry.data)) return null;
+	return {
+		v: 1,
+		url: entry.url,
+		cachedAt: entry.cachedAt,
+		data: entry.data
+	};
+}
+function readMemoryOgp(key, options, now) {
+	const cached = memoryCache.get(key);
+	if (!cached || !isFreshOgpEntry(cached.timestamp, options.cacheTTL, now)) return;
+	return cached.data;
+}
+function writeMemoryOgp(key, data, timestamp, options) {
+	if (data === null && !options.persistCache) return;
+	memoryCache.set(key, {
+		data,
+		timestamp
+	});
+}
+async function readDiskOgp(key, options, now) {
+	const file = ogpCacheFilePath(options.cacheDir, key);
+	try {
+		const entry = parseOgpCacheEntry(JSON.parse(await readFile(file, "utf8")));
+		if (!entry) {
+			await discardCorruptEntry(file);
+			return;
+		}
+		if (!isFreshOgpEntry(entry.cachedAt, options.cacheTTL, now)) return void 0;
+		return entry.data;
+	} catch (error) {
+		if (isEnoent(error)) return void 0;
+		await discardCorruptEntry(file);
+		return;
+	}
+}
+async function writeDiskOgp(key, url, data, options, cachedAt) {
+	const directory = options.cacheDir;
+	const target = ogpCacheFilePath(directory, key);
+	const temp = path.join(directory, `.${key}.${process.pid}.${randomBytes(8).toString("hex")}.tmp`);
+	const entry = {
+		v: 1,
+		url,
+		cachedAt,
+		data
+	};
+	try {
+		await mkdir(directory, { recursive: true });
+		await writeFile(temp, `${JSON.stringify(entry)}\n`);
+		try {
+			await rename(temp, target);
+		} catch {
+			await writeFile(target, `${JSON.stringify(entry)}\n`);
+			await rm(temp, { force: true });
+		}
+	} catch {
+		await rm(temp, { force: true }).catch(() => void 0);
+	}
+}
+function isOgpData(value) {
+	if (!value || typeof value !== "object") return false;
+	const data = value;
+	if (typeof data.url !== "string" || typeof data.title !== "string") return false;
+	for (const field of [
+		"description",
+		"image",
+		"siteName",
+		"favicon"
+	]) if (data[field] !== void 0 && typeof data[field] !== "string") return false;
+	return true;
+}
+async function discardCorruptEntry(file) {
+	console.warn(`Ignoring corrupt Open Graph cache entry ${file}`);
+	await rm(file, { force: true }).catch(() => void 0);
+}
+function isEnoent(error) {
+	return Boolean(error && typeof error === "object" && "code" in error && error.code === "ENOENT");
+}
+function resolveOgpOptions(options = {}) {
+	return {
+		timeout: options.timeout ?? 1e4,
+		cache: options.cache ?? true,
+		cacheTTL: options.cacheTTL ?? 36e5,
+		persistCache: options.persistCache ?? false,
+		cacheDir: path.resolve(options.cacheDir ?? ".cache/ox-content/ogp"),
+		refresh: options.refresh ?? false,
+		userAgent: options.userAgent ?? "ox-content-ogp-bot/1.0 (compatible; +https://github.com/ubugeeei-prod/ox-content)"
+	};
+}
+//#endregion
+//#region src/plugins/ogp/url.ts
 function isPrivateIPv4(hostname) {
 	const parts = hostname.split(".").map(Number);
 	if (parts.length !== 4 || parts.some((part) => !Number.isInteger(part) || part < 0 || part > 255)) return false;
@@ -1488,17 +1956,6 @@ function isSafeOgpUrl(value) {
 		return false;
 	}
 }
-/**
-* Get element attribute value.
-*/
-function getAttribute$1(el, name) {
-	const value = el.properties?.[name];
-	if (typeof value === "string") return value;
-	if (Array.isArray(value)) return value.join(" ");
-}
-/**
-* Extract domain from URL.
-*/
 function extractDomain(url) {
 	try {
 		return new URL(url).hostname;
@@ -1506,9 +1963,6 @@ function extractDomain(url) {
 		return url;
 	}
 }
-/**
-* Get favicon URL for a domain.
-*/
 function getFaviconUrl(url) {
 	try {
 		return `https://www.google.com/s2/favicons?domain=${new URL(url).hostname}&sz=32`;
@@ -1517,40 +1971,60 @@ function getFaviconUrl(url) {
 	}
 }
 /**
-* Parse OGP metadata from HTML.
+* Normalize a URL for cache keys: lowercase host, drop default ports and
+* fragments, and strip a trailing slash that is not the root path.
 */
-function parseOgpFromHtml(html, url) {
-	const result = {
-		url,
-		title: ""
-	};
-	const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
-	result.title = (html.match(/<meta[^>]*property=["']og:title["'][^>]*content=["']([^"']+)["']/i) || html.match(/<meta[^>]*content=["']([^"']+)["'][^>]*property=["']og:title["']/i))?.[1] || titleMatch?.[1] || extractDomain(url);
-	const descMatch = html.match(/<meta[^>]*property=["']og:description["'][^>]*content=["']([^"']+)["']/i) || html.match(/<meta[^>]*content=["']([^"']+)["'][^>]*property=["']og:description["']/i) || html.match(/<meta[^>]*name=["']description["'][^>]*content=["']([^"']+)["']/i) || html.match(/<meta[^>]*content=["']([^"']+)["'][^>]*name=["']description["']/i);
-	if (descMatch) result.description = descMatch[1];
-	const imageMatch = html.match(/<meta[^>]*property=["']og:image["'][^>]*content=["']([^"']+)["']/i) || html.match(/<meta[^>]*content=["']([^"']+)["'][^>]*property=["']og:image["']/i);
-	if (imageMatch) {
-		let imageUrl = imageMatch[1];
-		if (imageUrl.startsWith("/")) try {
-			const urlObj = new URL(url);
-			imageUrl = `${urlObj.protocol}//${urlObj.host}${imageUrl}`;
-		} catch {}
-		result.image = imageUrl;
+function normalizeOgpUrl(url) {
+	try {
+		const parsed = new URL(url);
+		parsed.hash = "";
+		parsed.hostname = parsed.hostname.toLowerCase();
+		if (parsed.protocol === "https:" && parsed.port === "443" || parsed.protocol === "http:" && parsed.port === "80") parsed.port = "";
+		if (parsed.pathname.length > 1 && parsed.pathname.endsWith("/")) parsed.pathname = parsed.pathname.slice(0, -1);
+		return parsed.href;
+	} catch {
+		return url;
 	}
-	const siteNameMatch = html.match(/<meta[^>]*property=["']og:site_name["'][^>]*content=["']([^"']+)["']/i) || html.match(/<meta[^>]*content=["']([^"']+)["'][^>]*property=["']og:site_name["']/i);
-	if (siteNameMatch) result.siteName = siteNameMatch[1];
-	result.favicon = getFaviconUrl(url);
-	return result;
 }
-/**
-* Fetch OGP data for a URL.
-*/
-async function fetchOgpData(url, options) {
+function ogpCacheKey(url) {
+	return createHash("sha256").update(normalizeOgpUrl(url)).digest("hex");
+}
+//#endregion
+//#region src/plugins/ogp/fetch.ts
+const inflight = /* @__PURE__ */ new Map();
+async function fetchOgpData(url, options = {}) {
 	if (!isSafeOgpUrl(url)) return null;
+	const resolved = resolveOgpOptions(options);
+	const key = ogpCacheKey(url);
+	const pending = inflight.get(key);
+	if (pending) return pending;
+	const request = loadOgpData(url, key, resolved).finally(() => {
+		if (inflight.get(key) === request) inflight.delete(key);
+	});
+	inflight.set(key, request);
+	return request;
+}
+async function loadOgpData(url, key, options) {
+	const now = Date.now();
+	if (options.cache && !options.refresh) {
+		const memory = readMemoryOgp(key, options, now);
+		if (memory !== void 0) return memory;
+		if (options.persistCache) {
+			const disk = await readDiskOgp(key, options, now);
+			if (disk !== void 0) {
+				writeMemoryOgp(key, disk, now, options);
+				return disk;
+			}
+		}
+	}
+	const data = await requestOgpData(url, options);
 	if (options.cache) {
-		const cached = ogpCache.get(url);
-		if (cached && Date.now() - cached.timestamp < options.cacheTTL) return cached.data;
+		writeMemoryOgp(key, data, now, options);
+		if (options.persistCache) await writeDiskOgp(key, normalizeOgpUrl(url), data, options, now);
 	}
+	return data;
+}
+async function requestOgpData(url, options) {
 	try {
 		const controller = new AbortController();
 		const timeoutId = setTimeout(() => controller.abort(), options.timeout);
@@ -1566,21 +2040,38 @@ async function fetchOgpData(url, options) {
 			console.warn(`Failed to fetch OGP for ${url}: ${response.status}`);
 			return null;
 		}
-		const data = parseOgpFromHtml(await response.text(), url);
-		if (options.cache) ogpCache.set(url, {
-			data,
-			timestamp: Date.now()
-		});
-		return data;
+		return parseOgpFromHtml(await response.text(), url);
 	} catch (error) {
 		if (error instanceof Error && error.name === "AbortError") console.warn(`Timeout fetching OGP for ${url}`);
 		else console.warn(`Error fetching OGP for ${url}:`, error);
 		return null;
 	}
 }
-/**
-* Create OGP card element.
-*/
+function parseOgpFromHtml(html, url) {
+	const result = {
+		url,
+		title: ""
+	};
+	const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
+	result.title = (html.match(/<meta[^>]*property=["']og:title["'][^>]*content=["']([^"']+)["']/i) || html.match(/<meta[^>]*content=["']([^"']+)["'][^>]*property=["']og:title["']/i))?.[1] || titleMatch?.[1] || extractDomain(url);
+	const descMatch = html.match(/<meta[^>]*property=["']og:description["'][^>]*content=["']([^"']+)["']/i) || html.match(/<meta[^>]*content=["']([^"']+)["'][^>]*property=["']og:description["']/i) || html.match(/<meta[^>]*name=["']description["'][^>]*content=["']([^"']+)["']/i) || html.match(/<meta[^>]*content=["']([^"']+)["'][^>]*name=["']description["']/i);
+	if (descMatch) result.description = descMatch[1];
+	const imageMatch = html.match(/<meta[^>]*property=["']og:image["'][^>]*content=["']([^"']+)["']/i) || html.match(/<meta[^>]*content=["']([^"']+)["'][^>]*property=["']og:image["']/i);
+	if (imageMatch) {
+		let imageUrl = imageMatch[1];
+		if (imageUrl.startsWith("/")) try {
+			const urlObj = new URL(url);
+			imageUrl = `${urlObj.protocol}//${urlObj.host}${imageUrl}`;
+		} catch {}
+		result.image = imageUrl;
+	}
+	const siteNameMatch = html.match(/<meta[^>]*property=["']og:site_name["'][^>]*content=["']([^"']+)["']/i) || html.match(/<meta[^>]*content=["']([^"']+)["'][^>]*property=["']og:site_name["']/i);
+	if (siteNameMatch) result.siteName = siteNameMatch[1];
+	result.favicon = getFaviconUrl(url);
+	return result;
+}
+//#endregion
+//#region src/plugins/ogp/render.ts
 function createOgpCard(data) {
 	const children = [];
 	const contentChildren = [];
@@ -1658,9 +2149,6 @@ function createOgpCard(data) {
 		children
 	};
 }
-/**
-* Create fallback element when OGP data is unavailable.
-*/
 function createFallbackCard(url) {
 	return {
 		type: "element",
@@ -1692,9 +2180,15 @@ function createFallbackCard(url) {
 		}]
 	};
 }
-/**
-* Collect all OGP URLs from HTML for pre-fetching.
-*/
+//#endregion
+//#region src/plugins/ogp/transform.ts
+const rehypeParse$1 = interopDefault(rehypeParsePlugin);
+const rehypeStringify$1 = interopDefault(rehypeStringifyPlugin);
+function getAttribute$1(el, name) {
+	const value = el.properties?.[name];
+	if (typeof value === "string") return value;
+	if (Array.isArray(value)) return value.join(" ");
+}
 async function collectOgpUrls(html) {
 	const urls = [];
 	const urlPattern = /<ogcard[^>]*\s+url=["']([^"']+)["']/gi;
@@ -1702,24 +2196,13 @@ async function collectOgpUrls(html) {
 	while ((match = urlPattern.exec(html)) !== null) if (isSafeOgpUrl(match[1])) urls.push(match[1]);
 	return urls;
 }
-/**
-* Pre-fetch all OGP data.
-*/
 async function prefetchOgpData(urls, options) {
-	const mergedOptions = {
-		...defaultOptions,
-		...options
-	};
 	const results = /* @__PURE__ */ new Map();
 	await Promise.all(urls.map(async (url) => {
-		const data = await fetchOgpData(url, mergedOptions);
-		results.set(url, data);
+		results.set(url, await fetchOgpData(url, options));
 	}));
 	return results;
 }
-/**
-* Rehype plugin to transform OgCard components.
-*/
 function rehypeOgp(ogpDataMap) {
 	return (tree) => {
 		const visit = (node) => {
@@ -1730,8 +2213,7 @@ function rehypeOgp(ogpDataMap) {
 						const url = getAttribute$1(child, "url");
 						if (url) {
 							const ogpData = ogpDataMap.get(url);
-							const cardElement = ogpData ? createOgpCard(ogpData) : createFallbackCard(url);
-							node.children[i] = cardElement;
+							node.children[i] = ogpData ? createOgpCard(ogpData) : createFallbackCard(url);
 						}
 					} else visit(child);
 				}
@@ -1740,9 +2222,6 @@ function rehypeOgp(ogpDataMap) {
 		visit(tree);
 	};
 }
-/**
-* Transform OgCard components in HTML.
-*/
 async function transformOgp(html, ogpDataMap, options) {
 	let dataMap = ogpDataMap;
 	if (!dataMap) dataMap = await prefetchOgpData(await collectOgpUrls(html), options);
@@ -1750,6 +2229,9 @@ async function transformOgp(html, ogpDataMap, options) {
 	return String(result);
 }
 //#endregion
+//#region src/plugins/ogp.ts
+var ogp_exports = /* @__PURE__ */ __exportAll({ transformOgp: () => transformOgp });
+//#endregion
 //#region src/plugins/index.ts
 const SELF_CLOSING_EMBED_TAG = /<(GitHub|OgCard|Tweet|XPost|Bluesky|Spotify|StackBlitz|WebContainer|YouTube)((?:[^>"']|"[^"]*"|'[^']*')*?)\s*\/>/gi;
 /**
@@ -2424,6 +2906,7 @@ async function transformMarkdown(source, filePath, options, ssgOptions) {
 		gfm: options.gfm,
 		mdx: resolveMdxForFilePath(filePath, options.mdx),
 		footnotes: options.footnotes,
+		semanticFootnotes: options.semanticFootnotes ?? false,
 		taskLists: options.taskLists,
 		tables: options.tables,
 		strikethrough: options.strikethrough,
@@ -2431,6 +2914,7 @@ async function transformMarkdown(source, filePath, options, ssgOptions) {
 		autolinkUrls: options.autolinks,
 		frontmatter: options.frontmatter,
 		tocMaxDepth: options.tocMaxDepth,
+		headingPermalinks: options.headingPermalinks?.enabled ?? false,
 		convertMdLinks: ssgOptions?.convertMdLinks,
 		baseUrl: ssgOptions?.baseUrl,
 		sourcePath: ssgOptions?.sourcePath ?? filePath,
@@ -2448,6 +2932,13 @@ async function transformMarkdown(source, filePath, options, ssgOptions) {
 		} : void 0,
 		attributes: options.attrs?.enabled ? { enabled: true } : void 0,
 		badges: options.badges?.enabled ? { enabled: true } : void 0,
+		magicLinks: options.magicLinks?.enabled ? {
+			enabled: true,
+			aliases: options.magicLinks.aliases,
+			favicon: options.magicLinks.favicon,
+			faviconTemplate: options.magicLinks.faviconTemplate,
+			imageOverrides: options.magicLinks.imageOverrides
+		} : void 0,
 		containers: options.containers?.enabled ? {
 			enabled: true,
 			types: options.containers.types
@@ -3931,6 +4422,108 @@ initIslands((el, props) => {
 `;
 }
 //#endregion
+//#region src/versions-html.ts
+function versionSwitcherMarkup(links, badge) {
+	if (links.length === 0) return "";
+	const current = links.find((link) => link.current) ?? links[0];
+	const items = links.map((link) => {
+		const label = `${escapeHtml$4(link.label)}${badgeMarkup(link, badge)}`;
+		if (link.current || !isSafeHref(link.href)) return `<li><span aria-current="page">${label}</span></li>`;
+		return `<li><a href="${escapeHtml$4(link.href)}">${label}</a></li>`;
+	}).join("");
+	return `<nav class="ox-header-select ox-version-switcher" aria-label="Version"><button type="button" aria-expanded="false" aria-haspopup="true">${escapeHtml$4(current.label)}${badgeMarkup(current, badge)}</button><ul class="ox-header-select-menu">${items}</ul></nav><script>(function(){var n=document.currentScript&&document.currentScript.previousElementSibling;if(!n||!n.classList.contains("ox-version-switcher"))return;var b=n.querySelector("button");if(!b)return;function closeOthers(){document.querySelectorAll(".header-nav-dropdown > button[aria-expanded='true'], .ox-locale-switcher > button[aria-expanded='true']").forEach(function(btn){btn.setAttribute("aria-expanded","false");});}b.addEventListener("click",function(e){e.stopPropagation();var o=b.getAttribute("aria-expanded")==="true";closeOthers();b.setAttribute("aria-expanded",o?"false":"true");});document.addEventListener("click",function(e){if(!n.contains(e.target))b.setAttribute("aria-expanded","false");});document.addEventListener("keydown",function(e){if(e.key==="Escape"){b.setAttribute("aria-expanded","false");b.focus();}});})()<\/script>`;
+}
+function versionBannerMarkup(kind) {
+	if (kind === "unreleased") return `<aside class="ox-version-banner ox-version-banner--unreleased" role="status">This documentation describes an unreleased version.</aside>`;
+	if (kind === "unmaintained") return `<aside class="ox-version-banner ox-version-banner--unmaintained" role="status">This documentation is unmaintained.</aside>`;
+	return "";
+}
+function injectVersionChrome(html, switcher, banner, searchFrom, searchTo) {
+	let next = html;
+	if (banner) next = next.replace(/<body([^>]*)>/, `<body$1>${banner}`);
+	if (switcher) {
+		if (next.includes("<div class=\"header-actions\">")) next = next.replace("<div class=\"header-actions\">", `<div class="header-actions">${switcher}`);
+		else if (next.includes("</header>")) next = next.replace("</header>", `${switcher}</header>`);
+	}
+	if (searchTo && isSafeHref(searchTo)) next = next.replace(/<html([^>]*)>/i, (match, attrs) => {
+		if (/\sdata-ox-search-index=/.test(attrs)) return match;
+		return `<html${attrs} data-ox-search-index="${escapeHtml$4(searchTo)}">`;
+	});
+	if (searchFrom && searchTo && searchFrom !== searchTo && isSafeHref(searchTo)) {
+		next = next.split(searchFrom).join(searchTo);
+		const script = `<script>(function(){var f=${JSON.stringify(searchFrom)},t=${JSON.stringify(searchTo)};var o=window.fetch;window.fetch=function(i,n){if(typeof i==="string"&&i.indexOf(f)!==-1)i=i.split(f).join(t);return o.call(this,i,n);};})()<\/script>`;
+		next = next.includes("</body>") ? next.replace("</body>", `${script}</body>`) : `${next}${script}`;
+	}
+	return next;
+}
+function searchIndexUrl(base, prefix) {
+	const root = !base || base === "/" ? "/" : base.endsWith("/") ? base : `${base}/`;
+	return prefix ? `${root}${prefix}/search-index.json` : `${root}search-index.json`;
+}
+function isSafeHref(href) {
+	const trimmed = href.trim();
+	if (!trimmed || trimmed.startsWith("//")) return false;
+	const lower = trimmed.replace(/\s+/g, "").toLowerCase();
+	if (lower.startsWith("javascript:") || lower.startsWith("data:") || lower.startsWith("vbscript:")) return false;
+	return trimmed.startsWith("/") || trimmed.startsWith("./") || !trimmed.includes(":");
+}
+function escapeHtml$4(value) {
+	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
+}
+function badgeMarkup(link, badge) {
+	if (!badge || !link.banner) return "";
+	return `<span class="ox-version-badge">${link.banner === "unreleased" ? "unreleased" : "unmaintained"}</span>`;
+}
+//#endregion
+//#region src/search-filters.ts
+/**
+* Language and version filters for the default search dialog.
+*/
+const RESULTS_MARKUP = "<div class=\"search-results\"></div>";
+function injectSearchLocaleFilters(html, input) {
+	const locales = input.locales.filter((locale) => locale.code.trim() && locale.name.trim());
+	if (locales.length < 2) return html;
+	const next = ensureSearchFilters(html);
+	const select = selectMarkup(next, "locale");
+	if (!select) return next;
+	const defaultLocale = input.defaultLocale.trim() || locales[0].code;
+	const selected = locales.some((locale) => locale.code === input.current) ? input.current : defaultLocale;
+	const options = [`<option value="">All languages</option>`, ...locales.map((locale) => {
+		return `<option value="${escapeHtml$4(locale.code)}"${locale.code === selected ? " selected" : ""}>${escapeHtml$4(locale.name)}</option>`;
+	})].join("");
+	return revealFilter(next.replace(select.markup, `<select class="search-filter-select" data-search-filter="locale" data-default-locale="${escapeHtml$4(defaultLocale)}" aria-label="Language">${options}</select>`), "locale");
+}
+function injectSearchVersionFilters(html, versions) {
+	const safe = versions.filter((version) => version.id.trim() && version.label.trim() && isSafeHref(version.indexUrl));
+	if (safe.length < 2) return html;
+	const next = ensureSearchFilters(html);
+	const select = selectMarkup(next, "version");
+	if (!select) return next;
+	const current = safe.find((version) => version.current) ?? safe[0];
+	const options = safe.map((version) => {
+		const selected = version.id === current.id ? " selected" : "";
+		return `<option value="${escapeHtml$4(version.id)}" data-prefix="${escapeHtml$4(version.prefix)}" data-index="${escapeHtml$4(version.indexUrl)}"${selected}>${escapeHtml$4(version.label)}</option>`;
+	}).join("");
+	return revealFilter(next.replace(select.markup, `<select class="search-filter-select" data-search-filter="version" aria-label="Version">${options}</select>`), "version");
+}
+function ensureSearchFilters(html) {
+	if (html.includes("class=\"search-filters\"") || !html.includes(RESULTS_MARKUP)) return html;
+	return html.replace(RESULTS_MARKUP, `${searchFiltersMarkup()}${RESULTS_MARKUP}`);
+}
+function searchFiltersMarkup() {
+	return `${searchFiltersStyle()}<div class="search-filters"><label class="search-filter" data-search-filter-label="locale" hidden><span class="search-filter-label">Language</span><select class="search-filter-select" data-search-filter="locale" data-default-locale="" aria-label="Language"></select></label><label class="search-filter" data-search-filter-label="version" hidden><span class="search-filter-label">Version</span><select class="search-filter-select" data-search-filter="version" aria-label="Version"></select></label></div>`;
+}
+function searchFiltersStyle() {
+	return `<style class="ox-search-filters-style">.search-filters{display:flex;flex-wrap:wrap;gap:.75rem;align-items:center;padding:.65rem 1rem;border-bottom:1px solid var(--octc-color-border);background:var(--octc-color-bg-alt)}.search-filter{display:flex;align-items:center;gap:.4rem;min-width:0}.search-filter[hidden]{display:none}.search-filter-label{font-size:.75rem;color:var(--octc-color-text-muted);white-space:nowrap}.search-filter-select{min-width:8rem;max-width:12rem;padding:.25rem .4rem;border:1px solid var(--octc-color-border);border-radius:4px;background:var(--octc-color-bg);color:var(--octc-color-text);font:inherit;font-size:.8125rem}.search-filter-select:focus{outline:2px solid var(--octc-color-primary);outline-offset:1px}</style>`;
+}
+function selectMarkup(html, kind) {
+	const match = html.match(new RegExp(`<select class="search-filter-select" data-search-filter="${kind}"[^>]*>[\\s\\S]*?<\\/select>`));
+	return match?.[0] ? { markup: match[0] } : void 0;
+}
+function revealFilter(html, kind) {
+	return html.replace(`data-search-filter-label="${kind}" hidden`, `data-search-filter-label="${kind}"`);
+}
+//#endregion
 //#region src/locale-switcher.ts
 /**
 * Resolves `ssg.localeSwitcher`. Omitted / `false` stay off. `true` or an
@@ -4130,6 +4723,22 @@ function stripLocalePrefix(sitePath, locales) {
 	return normalized;
 }
 //#endregion
+//#region src/page-head.ts
+/** Resolve descriptors to escaped `<head>` markup. Build-time only. */
+function renderHead(input) {
+	return importNapiModuleSync().renderHead(JSON.stringify(input));
+}
+function resolveHeadValidation(value) {
+	if (value === "warn" || value === "strict") return value;
+	return false;
+}
+function reportHeadDiagnostics(diagnostics, validation) {
+	if (!validation || diagnostics.length === 0) return;
+	const fatal = diagnostics.filter((item) => item.strict);
+	if (validation === "strict" && fatal.length > 0) throw new Error(`[ox-content] ${fatal[0].message}`);
+	if (validation === "warn") for (const item of diagnostics) console.warn(`[ox-content] ${item.message}`);
+}
+//#endregion
 //#region src/page-context.ts
 var page_context_exports = /* @__PURE__ */ __exportAll({
 	clearRenderContext: () => clearRenderContext,
@@ -4347,6 +4956,7 @@ function renderPage(page, options) {
 			contributors: page.contributors,
 			path: page.path,
 			url: page.url,
+			markdownSource: page.markdownSource,
 			frontmatter: page.frontmatter,
 			layout: page.layout
 		},
@@ -4363,6 +4973,7 @@ function renderPage(page, options) {
 				contributors: p.contributors,
 				path: p.path,
 				url: p.url,
+				markdownSource: p.markdownSource,
 				frontmatter: p.frontmatter,
 				layout: p.layout
 			}))
@@ -4421,8 +5032,8 @@ function DefaultTheme({ children }) {
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${escapeHtml$4(page.title)} - ${escapeHtml$4(site.name)}</title>
-  ${page.description ? `<meta name="description" content="${escapeHtml$4(page.description)}">` : ""}
+  <title>${escapeHtml$3(page.title)} - ${escapeHtml$3(site.name)}</title>
+  ${page.description ? `<meta name="description" content="${escapeHtml$3(page.description)}">` : ""}
   <style>
     :root {
       --octc-color-primary: #4f6fae;
@@ -4446,7 +5057,7 @@ function DefaultTheme({ children }) {
 </head>
 <body>
   <header>
-    <h1>${escapeHtml$4(site.name)}</h1>
+    <h1>${escapeHtml$3(site.name)}</h1>
   </header>
   <main>
     ${children.__html}
@@ -4454,7 +5065,7 @@ function DefaultTheme({ children }) {
 </body>
 </html>` };
 }
-function escapeHtml$4(str) {
+function escapeHtml$3(str) {
 	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
 /**
@@ -4554,6 +5165,13 @@ async function writeSiteMapFiles(input) {
 	}
 	return { files };
 }
+/** UTC `YYYY-MM-DD` for W3C lastmod. Invalid or negative timestamps are dropped. */
+function formatLastmod(timestampMs) {
+	if (timestampMs == null || !Number.isFinite(timestampMs) || timestampMs < 0) return;
+	const date = new Date(timestampMs);
+	if (Number.isNaN(date.getTime())) return;
+	return date.toISOString().slice(0, 10);
+}
 function hasSiteUrl$2(siteUrl) {
 	return Boolean(siteUrl && siteUrl.trim());
 }
@@ -4566,7 +5184,14 @@ function generateSitemapXml(pages) {
 	for (const page of pages) {
 		xml += "  <url>\n    <loc>";
 		xml += escapeXml$1(page.loc);
-		xml += "</loc>\n  </url>\n";
+		xml += "</loc>\n";
+		const lastmod = formatLastmod(page.lastUpdated);
+		if (lastmod) {
+			xml += "    <lastmod>";
+			xml += lastmod;
+			xml += "</lastmod>\n";
+		}
+		xml += "  </url>\n";
 	}
 	xml += "</urlset>\n";
 	return xml;
@@ -4627,6 +5252,168 @@ function escapeLlmsUrl(value) {
 	return escaped;
 }
 //#endregion
+//#region src/permalinks.ts
+const RESERVED_CASCADE_KEYS = /* @__PURE__ */ new Set(["permalink", "slug"]);
+/** Resolves `permalinks`. `false` / omitted stays off. `true` / `{}` enables. */
+function resolvePermalinksOptions(value) {
+	return resolveFlag(value);
+}
+/** Resolves `cascade`. `false` / omitted stays off. `true` / `{}` enables. */
+function resolveCascadeOptions(value) {
+	return resolveFlag(value);
+}
+/**
+* Applies cascade (when on) then permalink / slug rewriting (when on).
+*
+* Collisions skip the later page and keep the first. Rejected permalinks stay
+* on the file-tree URL. Hostile non-string values are ignored.
+*/
+function resolvePageRoutes(input) {
+	const cascaded = applyCascade(input.pages, input.cascade);
+	if (!input.permalinks?.enabled) return {
+		pages: cascaded.map((page) => ({
+			source: page.source,
+			urlPath: normalizeUrlPath$1(page.fileUrl),
+			frontmatter: page.frontmatter
+		})),
+		errors: []
+	};
+	const pages = [];
+	const errors = [];
+	const claimed = /* @__PURE__ */ new Map();
+	for (const page of cascaded) {
+		const { urlPath, error } = resolveOne(page);
+		if (error) errors.push(error);
+		const owner = claimed.get(urlPath);
+		if (owner) {
+			errors.push(`[ox-content] URL collision at "${urlPath}": ${owner} kept, ${page.source} skipped`);
+			continue;
+		}
+		claimed.set(urlPath, page.source);
+		pages.push({
+			source: page.source,
+			urlPath,
+			frontmatter: page.frontmatter
+		});
+	}
+	return {
+		pages,
+		errors
+	};
+}
+/** Escapes a value for use in an HTML attribute. */
+function escapeAttribute$2(value) {
+	return value.replace(/[&<>"']/gu, (ch) => {
+		switch (ch) {
+			case "&": return "&amp;";
+			case "<": return "&lt;";
+			case ">": return "&gt;";
+			case "\"": return "&quot;";
+			default: return "&#39;";
+		}
+	});
+}
+function normalizeUrlPath$1(value) {
+	const segments = pathSegments(value);
+	return segments.length === 0 ? "/" : segments.join("/");
+}
+function resolveFlag(value) {
+	if (!value) return { enabled: false };
+	if (value === true) return { enabled: true };
+	return { enabled: value.enabled !== false };
+}
+function applyCascade(pages, options) {
+	if (!options?.enabled) return pages.map((page) => ({
+		...page,
+		frontmatter: { ...page.frontmatter }
+	}));
+	const indexes = /* @__PURE__ */ new Map();
+	for (const page of pages) {
+		const source = normalizeSeparators(page.source);
+		if (isIndexFile(source)) indexes.set(directoryOf(source), { ...page.frontmatter });
+	}
+	return pages.map((page) => {
+		const source = normalizeSeparators(page.source);
+		const frontmatter = { ...page.frontmatter };
+		for (const dir of ancestorDirs(source)) {
+			const defaults = indexes.get(dir);
+			if (!defaults || isIndexFile(source) && directoryOf(source) === dir) continue;
+			for (const [key, value] of Object.entries(defaults)) if (!RESERVED_CASCADE_KEYS.has(key) && !(key in frontmatter)) frontmatter[key] = value;
+		}
+		return {
+			...page,
+			frontmatter
+		};
+	});
+}
+function resolveOne(page) {
+	const fileUrl = normalizeUrlPath$1(page.fileUrl);
+	const permalink = readString(page.frontmatter.permalink);
+	if (permalink !== void 0) {
+		const url = isSafePermalink(permalink) ? normalizeUrlPath$1(permalink) : void 0;
+		return url ? { urlPath: url } : {
+			urlPath: fileUrl,
+			error: `[ox-content] rejected permalink ${JSON.stringify(permalink)} on ${page.source} (path escape); using the file-tree URL`
+		};
+	}
+	const slug = readString(page.frontmatter.slug);
+	if (slug !== void 0) {
+		const url = rewriteSlug(fileUrl, slug);
+		return url ? { urlPath: url } : {
+			urlPath: fileUrl,
+			error: `[ox-content] rejected slug ${JSON.stringify(slug)} on ${page.source} (path escape); using the file-tree URL`
+		};
+	}
+	return { urlPath: fileUrl };
+}
+function rewriteSlug(fileUrl, slug) {
+	const trimmed = slug.trim();
+	if (trimmed.includes("/") || !isSafePermalink(trimmed)) return;
+	const normalized = normalizeUrlPath$1(trimmed);
+	if (normalized === "/") return;
+	if (fileUrl === "/") return normalized;
+	const segments = fileUrl.split("/").filter(Boolean);
+	segments.pop();
+	segments.push(normalized);
+	return segments.join("/");
+}
+function isSafePermalink(value) {
+	const trimmed = value.trim();
+	if (!trimmed || /[\n\r\0]/u.test(trimmed) || trimmed.includes("\\") || trimmed.startsWith("//")) return false;
+	if (/^[A-Za-z]:/u.test(trimmed)) return false;
+	const lower = trimmed.toLowerCase();
+	if (lower.includes("javascript:") || lower.includes("data:") || lower.includes("vbscript:") || lower.includes("file:") || lower.includes("://")) return false;
+	return pathSegments(trimmed).every((segment) => segment !== ".." && segment !== ".");
+}
+function pathSegments(value) {
+	return value.trim().replace(/^\/+|\/+$/gu, "").split("/").filter(Boolean);
+}
+function readString(value) {
+	return typeof value === "string" ? value : void 0;
+}
+function normalizeSeparators(value) {
+	return value.replaceAll("\\", "/");
+}
+function isIndexFile(source) {
+	const name = source.split("/").pop() ?? source;
+	return (name.includes(".") ? name.slice(0, name.lastIndexOf(".")) : name).toLowerCase() === "_index";
+}
+function directoryOf(source) {
+	const index = source.lastIndexOf("/");
+	return index === -1 ? "" : source.slice(0, index);
+}
+function ancestorDirs(source) {
+	const dir = directoryOf(source);
+	const dirs = [""];
+	if (!dir) return dirs;
+	let acc = "";
+	for (const segment of dir.split("/")) {
+		acc = acc ? `${acc}/${segment}` : segment;
+		dirs.push(acc);
+	}
+	return dirs;
+}
+//#endregion
 //#region src/publish-state.ts
 /**
 * Opt-in draft / unlisted / scheduled page classification.
@@ -4717,160 +5504,202 @@ function hiddenNavKeys(pages, listed) {
 function toNapiPublishState(options) {
 	if (!options) return;
 	return {
-		enabled: options.enabled,
-		now: options.now,
-		includeDrafts: options.includeDrafts
+		enabled: options.enabled,
+		now: options.now,
+		includeDrafts: options.includeDrafts
+	};
+}
+//#endregion
+//#region src/markdown-source.ts
+/**
+* Opt-in Markdown source companions written beside generated HTML.
+*
+* Copies already-read source bytes. Does not re-parse Markdown to emit them.
+*/
+/**
+* Resolves `ssg.markdownSource` with defaults.
+*
+* `false` / omitted stays off. `true` enables companions and the alternate
+* link. An object enables the feature and overrides only the fields set.
+*/
+function resolveMarkdownSourceOptions(value) {
+	if (!value) return {
+		enabled: false,
+		alternate: true
+	};
+	if (value === true) return {
+		enabled: true,
+		alternate: true
+	};
+	return {
+		enabled: true,
+		alternate: value.alternate !== false
 	};
 }
-//#endregion
-//#region src/permalinks.ts
-const RESERVED_CASCADE_KEYS = /* @__PURE__ */ new Set(["permalink", "slug"]);
-/** Resolves `permalinks`. `false` / omitted stays off. `true` / `{}` enables. */
-function resolvePermalinksOptions(value) {
-	return resolveFlag(value);
+/** Companion href for one page after permalink / publish-state checks. */
+function markdownSourceHrefForPage(input) {
+	if (!shouldPublishMarkdownSource(input.frontmatter, input.publishState)) return;
+	return markdownSourceHref(resolvePageRoutes({
+		pages: [{
+			source: input.source,
+			fileUrl: input.fileUrl,
+			frontmatter: input.frontmatter
+		}],
+		permalinks: input.permalinks,
+		cascade: input.cascade
+	}).pages[0]?.urlPath ?? input.fileUrl, input.base);
 }
-/** Resolves `cascade`. `false` / omitted stays off. `true` / `{}` enables. */
-function resolveCascadeOptions(value) {
-	return resolveFlag(value);
+/** Public companion href, including `base`. Always ends in `.md`. */
+function markdownSourceHref(urlPath, base) {
+	const relative = companionRelativePath(urlPath);
+	if (!relative) return;
+	return `${normalizeBase$1(base)}${relative}`;
+}
+/** Filesystem path for a companion, or `undefined` when it would escape `outDir`. */
+function markdownSourceOutputPath(outDir, urlPath) {
+	const relative = companionRelativePath(urlPath);
+	if (!relative) return;
+	return containedPath$3(outDir, ...relative.split("/"));
 }
 /**
-* Applies cascade (when on) then permalink / slug rewriting (when on).
+* Whether this page may publish a companion.
 *
-* Collisions skip the later page and keep the first. Rejected permalinks stay
-* on the file-tree URL. Hostile non-string values are ignored.
-*/
-function resolvePageRoutes(input) {
-	const cascaded = applyCascade(input.pages, input.cascade);
-	if (!input.permalinks?.enabled) return {
-		pages: cascaded.map((page) => ({
-			source: page.source,
-			urlPath: normalizeUrlPath$1(page.fileUrl),
-			frontmatter: page.frontmatter
-		})),
+* Draft and unlisted source is never emitted. When `publishState` is on,
+* scheduled / expired pages follow that filter and `includeDrafts` is ignored
+* so preview HTML cannot leak source.
+*/
+function shouldPublishMarkdownSource(frontmatter, publishState) {
+	if (frontmatter.draft === true || frontmatter.unlisted === true) return false;
+	if (!publishState?.enabled) return true;
+	return classifyPublishState(frontmatter, {
+		...publishState,
+		includeDrafts: false
+	}).output;
+}
+/** Inserts `<link rel="alternate" type="text/markdown">` before `</head>`. */
+function injectMarkdownSourceAlternate(html, href) {
+	if (!href || !/<\/head>/i.test(html)) return html;
+	const tag = `<link rel="alternate" type="text/markdown" href="${escapeAttribute$2(href)}">`;
+	const index = html.toLowerCase().lastIndexOf("</head>");
+	return `${html.slice(0, index)}  ${tag}\n${html.slice(index)}`;
+}
+/** Writes enabled companions from already-read source bytes. */
+async function writeMarkdownSourceFiles(input) {
+	if (!input.options?.enabled) return {
+		files: [],
 		errors: []
 	};
-	const pages = [];
+	const files = [];
 	const errors = [];
-	const claimed = /* @__PURE__ */ new Map();
-	for (const page of cascaded) {
-		const { urlPath, error } = resolveOne(page);
-		if (error) errors.push(error);
-		const owner = claimed.get(urlPath);
-		if (owner) {
-			errors.push(`[ox-content] URL collision at "${urlPath}": ${owner} kept, ${page.source} skipped`);
+	const seen = /* @__PURE__ */ new Map();
+	for (const page of input.pages) {
+		if (page.source == null || !shouldPublishMarkdownSource(page.frontmatter, input.publishState)) continue;
+		const outputPath = markdownSourceOutputPath(input.outDir, page.urlPath);
+		if (!outputPath) {
+			errors.push(`[ox-content] markdownSource skipped path-escape for ${page.inputPath}`);
 			continue;
 		}
-		claimed.set(urlPath, page.source);
-		pages.push({
-			source: page.source,
-			urlPath,
-			frontmatter: page.frontmatter
-		});
+		const previous = seen.get(outputPath);
+		if (previous) {
+			errors.push(`[ox-content] markdownSource collision: ${page.inputPath} and ${previous} both map to ${outputPath}`);
+			continue;
+		}
+		seen.set(outputPath, page.inputPath);
+		await fs$2.mkdir(path$1.dirname(outputPath), { recursive: true });
+		await fs$2.writeFile(outputPath, page.source);
+		files.push(outputPath);
 	}
 	return {
-		pages,
+		files,
 		errors
 	};
 }
-function normalizeUrlPath$1(value) {
-	const segments = pathSegments(value);
-	return segments.length === 0 ? "/" : segments.join("/");
-}
-function resolveFlag(value) {
-	if (!value) return { enabled: false };
-	if (value === true) return { enabled: true };
-	return { enabled: value.enabled !== false };
+/** True when the request pathname is a `.md` companion URL. */
+function isMarkdownSourceRequest(pathname) {
+	const clean = stripSearch(pathname);
+	return clean.toLowerCase().endsWith(".md") && !clean.includes("\\");
 }
-function applyCascade(pages, options) {
-	if (!options?.enabled) return pages.map((page) => ({
-		...page,
-		frontmatter: { ...page.frontmatter }
-	}));
-	const indexes = /* @__PURE__ */ new Map();
-	for (const page of pages) {
-		const source = normalizeSeparators(page.source);
-		if (isIndexFile(source)) indexes.set(directoryOf(source), { ...page.frontmatter });
-	}
-	return pages.map((page) => {
-		const source = normalizeSeparators(page.source);
-		const frontmatter = { ...page.frontmatter };
-		for (const dir of ancestorDirs(source)) {
-			const defaults = indexes.get(dir);
-			if (!defaults || isIndexFile(source) && directoryOf(source) === dir) continue;
-			for (const [key, value] of Object.entries(defaults)) if (!RESERVED_CASCADE_KEYS.has(key) && !(key in frontmatter)) frontmatter[key] = value;
-		}
+/** Builds a companion index from source files without transforming Markdown. */
+async function buildMarkdownSourceIndex(input) {
+	const loaded = await Promise.all(input.files.map(async (file) => {
+		const source = await fs$2.readFile(file, "utf8");
 		return {
-			...page,
-			frontmatter
+			source: file,
+			fileUrl: importNapiModuleSync().getSsgUrlPath(file, input.srcDir),
+			frontmatter: parseSourceFrontmatter(source),
+			body: source
 		};
+	}));
+	const routed = resolvePageRoutes({
+		pages: loaded.map(({ source, fileUrl, frontmatter }) => ({
+			source,
+			fileUrl,
+			frontmatter
+		})),
+		permalinks: input.permalinks,
+		cascade: input.cascade
 	});
-}
-function resolveOne(page) {
-	const fileUrl = normalizeUrlPath$1(page.fileUrl);
-	const permalink = readString(page.frontmatter.permalink);
-	if (permalink !== void 0) {
-		const url = isSafePermalink(permalink) ? normalizeUrlPath$1(permalink) : void 0;
-		return url ? { urlPath: url } : {
-			urlPath: fileUrl,
-			error: `[ox-content] rejected permalink ${JSON.stringify(permalink)} on ${page.source} (path escape); using the file-tree URL`
-		};
-	}
-	const slug = readString(page.frontmatter.slug);
-	if (slug !== void 0) {
-		const url = rewriteSlug(fileUrl, slug);
-		return url ? { urlPath: url } : {
-			urlPath: fileUrl,
-			error: `[ox-content] rejected slug ${JSON.stringify(slug)} on ${page.source} (path escape); using the file-tree URL`
-		};
+	const bodies = new Map(loaded.map((page) => [page.source, page.body]));
+	const index = /* @__PURE__ */ new Map();
+	for (const page of routed.pages) {
+		const href = markdownSourceHref(page.urlPath, "/");
+		const body = bodies.get(page.source);
+		if (!href || body == null) continue;
+		index.set(normalizePathname(href), {
+			source: body,
+			allowed: shouldPublishMarkdownSource(page.frontmatter, input.publishState)
+		});
 	}
-	return { urlPath: fileUrl };
+	return index;
 }
-function rewriteSlug(fileUrl, slug) {
-	const trimmed = slug.trim();
-	if (trimmed.includes("/") || !isSafePermalink(trimmed)) return;
-	const normalized = normalizeUrlPath$1(trimmed);
-	if (normalized === "/") return;
-	if (fileUrl === "/") return normalized;
-	const segments = fileUrl.split("/").filter(Boolean);
-	segments.pop();
-	segments.push(normalized);
-	return segments.join("/");
+/** Looks up a companion after the site `base` has been stripped. */
+function resolveMarkdownSourceRequest(pathname, index) {
+	if (!isMarkdownSourceRequest(pathname)) return;
+	return index.get(normalizePathname(stripSearch(pathname)));
 }
-function isSafePermalink(value) {
-	const trimmed = value.trim();
-	if (!trimmed || /[\n\r\0]/u.test(trimmed) || trimmed.includes("\\") || trimmed.startsWith("//")) return false;
-	if (/^[A-Za-z]:/u.test(trimmed)) return false;
-	const lower = trimmed.toLowerCase();
-	if (lower.includes("javascript:") || lower.includes("data:") || lower.includes("vbscript:") || lower.includes("file:") || lower.includes("://")) return false;
-	return pathSegments(trimmed).every((segment) => segment !== ".." && segment !== ".");
+/** Frontmatter keys only — not a Markdown parse. */
+function parseSourceFrontmatter(source) {
+	const match = source.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+	if (!match?.[1]) return {};
+	const result = {};
+	for (const line of match[1].split("\n")) {
+		const kv = line.match(/^([A-Za-z_][\w-]*)\s*:\s*(.*)$/);
+		if (!kv) continue;
+		result[kv[1]] = parseFrontmatterScalar(kv[2].trim());
+	}
+	return result;
 }
-function pathSegments(value) {
-	return value.trim().replace(/^\/+|\/+$/gu, "").split("/").filter(Boolean);
+function parseFrontmatterScalar(value) {
+	if (value === "true") return true;
+	if (value === "false") return false;
+	if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) return value.slice(1, -1);
+	return value;
 }
-function readString(value) {
-	return typeof value === "string" ? value : void 0;
+function companionRelativePath(urlPath) {
+	const trimmed = urlPath === "/" || !urlPath ? "index" : urlPath.replace(/^\/+|\/+$/gu, "");
+	if (!trimmed) return;
+	if (trimmed.split("/").some((segment) => !segment || segment === "." || segment === "..")) return;
+	return `${trimmed}.md`;
 }
-function normalizeSeparators(value) {
-	return value.replaceAll("\\", "/");
+function containedPath$3(outDir, ...segments) {
+	const root = path$1.resolve(outDir);
+	const resolved = path$1.resolve(root, ...segments);
+	const prefix = root.endsWith(path$1.sep) ? root : `${root}${path$1.sep}`;
+	if (resolved === root || !resolved.startsWith(prefix)) return;
+	return resolved;
 }
-function isIndexFile(source) {
-	const name = source.split("/").pop() ?? source;
-	return (name.includes(".") ? name.slice(0, name.lastIndexOf(".")) : name).toLowerCase() === "_index";
+function normalizeBase$1(base) {
+	if (!base || base === "/") return "/";
+	return base.endsWith("/") ? base : `${base}/`;
 }
-function directoryOf(source) {
-	const index = source.lastIndexOf("/");
-	return index === -1 ? "" : source.slice(0, index);
+function stripSearch(pathname) {
+	return pathname.split("?")[0]?.split("#")[0] ?? pathname;
 }
-function ancestorDirs(source) {
-	const dir = directoryOf(source);
-	const dirs = [""];
-	if (!dir) return dirs;
-	let acc = "";
-	for (const segment of dir.split("/")) {
-		acc = acc ? `${acc}/${segment}` : segment;
-		dirs.push(acc);
-	}
-	return dirs;
+function normalizePathname(pathname) {
+	const clean = stripSearch(pathname);
+	if (!clean || clean === "/") return "/";
+	const withSlash = clean.startsWith("/") ? clean : `/${clean}`;
+	return withSlash.length > 1 && withSlash.endsWith("/") ? withSlash.slice(0, -1) : withSlash;
 }
 //#endregion
 //#region src/apply-permalinks.ts
@@ -5102,7 +5931,7 @@ async function writeRedirectFiles(input) {
 }
 /** Static HTML redirect body. `dest` is escaped. */
 function generateRedirectHtml(dest) {
-	const escaped = escapeHtml$3(dest);
+	const escaped = escapeHtml$2(dest);
 	return `\
 <!DOCTYPE html>
 <html lang="en">
@@ -5187,7 +6016,7 @@ function upsert(files, index, occupied, from, to, base) {
 		html
 	});
 }
-function escapeHtml$3(value) {
+function escapeHtml$2(value) {
 	return value.replace(/[&<>"']/g, (ch) => {
 		switch (ch) {
 			case "&": return "&amp;";
@@ -5545,6 +6374,7 @@ function createNativeTransformOptions(options) {
 	return {
 		gfm: options.gfm,
 		footnotes: options.footnotes,
+		semanticFootnotes: options.semanticFootnotes ?? false,
 		taskLists: options.taskLists,
 		tables: options.tables,
 		strikethrough: options.strikethrough,
@@ -5552,6 +6382,7 @@ function createNativeTransformOptions(options) {
 		autolinkUrls: options.autolinks,
 		frontmatter: options.frontmatter,
 		tocMaxDepth: options.tocMaxDepth,
+		headingPermalinks: options.headingPermalinks?.enabled ?? false,
 		codeAnnotations: options.codeAnnotations?.enabled ?? false,
 		codeAnnotationMetaKey: options.codeAnnotations?.metaKey ?? "annotate",
 		codeAnnotationSyntax: options.codeAnnotations?.notation ?? "attribute",
@@ -5566,6 +6397,13 @@ function createNativeTransformOptions(options) {
 		} : void 0,
 		attributes: options.attrs?.enabled ? { enabled: true } : void 0,
 		badges: options.badges?.enabled ? { enabled: true } : void 0,
+		magicLinks: options.magicLinks?.enabled ? {
+			enabled: true,
+			aliases: options.magicLinks.aliases,
+			favicon: options.magicLinks.favicon,
+			faviconTemplate: options.magicLinks.faviconTemplate,
+			imageOverrides: options.magicLinks.imageOverrides
+		} : void 0,
 		containers: options.containers?.enabled ? {
 			enabled: true,
 			types: options.containers.types
@@ -5990,6 +6828,7 @@ function isExcludedFromFeed(item, publishState) {
 	const frontmatter = item.frontmatter ?? {};
 	if (item.draft === true || frontmatter.draft === true) return true;
 	if (item.unlisted === true || frontmatter.unlisted === true) return true;
+	if (frontmatter.external === true) return true;
 	if (!publishState?.enabled) return false;
 	return !classifyPublishState({
 		...frontmatter,
@@ -6230,14 +7069,14 @@ function relatedMarkup(pages) {
 }
 function listPageContent(terms, base, urlName) {
 	const items = terms.map((term) => listItem$1(siteHref$3(base, urlName, term.slug), term.label)).join("");
-	return `<h1>${escapeHtml$2(displayTaxonomyName(urlName))}</h1><ul class="ox-taxonomy">${items}</ul>`;
+	return `<h1>${escapeHtml$1(displayTaxonomyName(urlName))}</h1><ul class="ox-taxonomy">${items}</ul>`;
 }
 function termPageContent(term) {
 	const items = [...term.pages].sort((left, right) => {
 		const titleCmp = left.title.localeCompare(right.title);
 		return titleCmp !== 0 ? titleCmp : left.routePaths.href.localeCompare(right.routePaths.href);
 	}).map((page) => listItem$1(page.routePaths.href, page.title)).join("");
-	return `<h1>${escapeHtml$2(term.label)}</h1><ul class="ox-taxonomy-term">${items}</ul>`;
+	return `<h1>${escapeHtml$1(term.label)}</h1><ul class="ox-taxonomy-term">${items}</ul>`;
 }
 function displayTaxonomyName(name) {
 	return name.charAt(0).toUpperCase() + name.slice(1);
@@ -6255,9 +7094,9 @@ function containedPath$2(outDir, ...segments) {
 	return resolved;
 }
 function listItem$1(href, label) {
-	return `<li><a href="${escapeHtml$2(href)}">${escapeHtml$2(label)}</a></li>`;
+	return `<li><a href="${escapeHtml$1(href)}">${escapeHtml$1(label)}</a></li>`;
 }
-function escapeHtml$2(value) {
+function escapeHtml$1(value) {
 	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
 }
 //#endregion
@@ -6531,96 +7370,441 @@ function resolveBlogOptions(value) {
 	if (!value) return {
 		enabled: false,
 		authors: {},
-		pageSize: DEFAULT_PAGE_SIZE
+		pageSize: DEFAULT_PAGE_SIZE,
+		feeds: []
 	};
 	if (value === true) return {
 		enabled: true,
 		authors: {},
-		pageSize: DEFAULT_PAGE_SIZE
+		pageSize: DEFAULT_PAGE_SIZE,
+		feeds: []
+	};
+	return {
+		enabled: true,
+		collection: value.collection,
+		authors: normalizeAuthors(value.authors),
+		pageSize: normalizePageSize(value.pageSize),
+		feeds: normalizeFeeds(value.feeds)
 	};
+}
+/**
+* Picks a collection named `blog`, else the only configured collection.
+*
+* An explicit name always wins. Several collections and no `blog` name
+* require `blog.collection`.
+*/
+function resolveBlogCollectionName(requested, collectionNames) {
+	if (requested) return requested;
+	if (collectionNames.includes("blog")) return "blog";
+	if (collectionNames.length === 1) return collectionNames[0];
+}
+function normalizeAuthors(authors) {
+	if (!authors || typeof authors !== "object") return {};
+	const resolved = {};
+	for (const [key, value] of Object.entries(authors)) {
+		if (!value || typeof value.name !== "string") continue;
+		resolved[key] = {
+			name: value.name,
+			bio: typeof value.bio === "string" ? value.bio : void 0,
+			url: typeof value.url === "string" ? value.url : void 0
+		};
+	}
+	return resolved;
+}
+function normalizePageSize(value) {
+	if (typeof value === "number" && Number.isFinite(value) && value >= 1) return Math.floor(value);
+	return DEFAULT_PAGE_SIZE;
+}
+function normalizeFeeds(feeds) {
+	if (!Array.isArray(feeds)) return [];
+	const resolved = [];
+	for (const entry of feeds) {
+		if (typeof entry === "string") {
+			const url = entry.trim();
+			if (url) resolved.push({
+				url,
+				onError: "warn"
+			});
+			continue;
+		}
+		if (!entry || typeof entry !== "object" || typeof entry.url !== "string") continue;
+		const url = entry.url.trim();
+		if (!url) continue;
+		const language = trimOptional(entry.language);
+		const author = trimOptional(entry.author);
+		resolved.push({
+			url,
+			...language ? { language } : {},
+			...author ? { author } : {},
+			onError: entry.onError === "error" ? "error" : "warn"
+		});
+	}
+	return resolved;
+}
+function trimOptional(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+//#endregion
+//#region src/blog-feed-date.ts
+/**
+* Publication dates from RSS / Atom items.
+*/
+const MONTHS = {
+	jan: 1,
+	feb: 2,
+	mar: 3,
+	apr: 4,
+	may: 5,
+	jun: 6,
+	jul: 7,
+	aug: 8,
+	sep: 9,
+	oct: 10,
+	nov: 11,
+	dec: 12
+};
+const RFC822 = /^(?:[A-Za-z]{3},\s+)?(\d{1,2})\s+([A-Za-z]{3})\s+(\d{4})\s+(\d{2}):(\d{2})(?::(\d{2}))?\s+(?:GMT|UTC|UT|([+-]\d{4}))$/;
+function parseFeedDate(value) {
+	const trimmed = value?.trim();
+	if (!trimmed) return;
+	return parseDate(trimmed) ?? parseRfc822(trimmed);
+}
+function feedDateLabel(date) {
+	return `${String(date.year).padStart(4, "0")}-${String(date.month).padStart(2, "0")}-${String(date.day).padStart(2, "0")}`;
+}
+function feedDateIso(date) {
+	return `${feedDateLabel(date)}T${String(date.hour).padStart(2, "0")}:${String(date.minute).padStart(2, "0")}:${String(date.second).padStart(2, "0")}Z`;
+}
+function parseRfc822(value) {
+	const match = value.match(RFC822);
+	if (!match) return;
+	const month = MONTHS[match[2]?.toLowerCase() ?? ""];
+	if (!month) return;
+	const day = match[1]?.padStart(2, "0");
+	const year = match[3];
+	const hour = match[4];
+	const minute = match[5];
+	const second = (match[6] ?? "00").padStart(2, "0");
+	const zone = match[7];
+	const tz = zone ? `${zone.slice(0, 3)}:${zone.slice(3)}` : "Z";
+	return parseDate(`${year}-${String(month).padStart(2, "0")}-${day}T${hour}:${minute}:${second}${tz}`);
+}
+//#endregion
+//#region src/blog-feed-url.ts
+/**
+* Safe-URL checks for configured external blog feeds.
+*/
+const CONTROL_CHARS = /[\n\r\t\0]/;
+function isSafeFeedUrl(value) {
+	const trimmed = value.trim();
+	if (!trimmed || CONTROL_CHARS.test(trimmed)) return false;
+	try {
+		const url = new URL(trimmed);
+		if (url.protocol !== "https:") return false;
+		if (url.username || url.password) return false;
+		return !isBlockedFeedHost(url.hostname);
+	} catch {
+		return false;
+	}
+}
+function canonicalizeFeedItemUrl(value) {
+	if (!isSafeFeedUrl(value)) return;
+	const url = new URL(value.trim());
+	url.hash = "";
+	url.username = "";
+	url.password = "";
+	if (url.port === "443") url.port = "";
+	url.hostname = url.hostname.toLowerCase();
+	let href = url.href;
+	if (url.pathname !== "/" && href.endsWith("/")) href = href.slice(0, -1);
+	return href;
+}
+function isBlockedFeedHost(hostname) {
+	const host = hostname.toLowerCase().replace(/^\[|\]$/g, "");
+	if (!host || host === "localhost" || host.endsWith(".localhost") || host.endsWith(".local")) return true;
+	if (host.includes(":")) return isBlockedIPv6(host);
+	return isIPv4(host) ? isBlockedIPv4(host) : false;
+}
+function isBlockedFeedAddress(address) {
+	const value = address.toLowerCase().replace(/^\[|\]$/g, "");
+	if (value.includes(":")) return isBlockedIPv6(value);
+	return isIPv4(value) ? isBlockedIPv4(value) : true;
+}
+function isIPv4(value) {
+	const parts = value.split(".");
+	if (parts.length !== 4) return false;
+	return parts.every((part) => {
+		const n = Number(part);
+		return Number.isInteger(n) && n >= 0 && n <= 255 && String(n) === part;
+	});
+}
+function isBlockedIPv4(ip) {
+	const [a, b] = ip.split(".").map(Number);
+	return a === 0 || a === 10 || a === 127 || a === 169 && b === 254 || a === 172 && b >= 16 && b <= 31 || a === 192 && b === 168;
+}
+function isBlockedIPv6(ip) {
+	if (ip === "::" || ip === "::1") return true;
+	if (ip.startsWith("::ffff:")) {
+		const mapped = ip.slice(7);
+		return isIPv4(mapped) ? isBlockedIPv4(mapped) : true;
+	}
+	const first = Number.parseInt(ip.split(":")[0] ?? "", 16);
+	if (!Number.isFinite(first)) return true;
+	if (first >= 65152 && first <= 65215) return true;
+	return (first & 65024) === 64512;
+}
+let installedNetwork = {};
+async function fetchBlogFeedBody(url, network = {}) {
+	const timeoutMs = network.limits?.timeoutMs ?? installedNetwork.limits?.timeoutMs ?? 1e4;
+	const maxBytes = network.limits?.maxBytes ?? installedNetwork.limits?.maxBytes ?? 1048576;
+	const maxRedirects = network.limits?.maxRedirects ?? installedNetwork.limits?.maxRedirects ?? 5;
+	const fetchFn = network.fetch ?? installedNetwork.fetch ?? defaultFetch;
+	const lookup = network.lookup ?? installedNetwork.lookup ?? defaultLookup;
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(), timeoutMs);
+	try {
+		return await followFeed(url, fetchFn, lookup, controller.signal, maxBytes, maxRedirects);
+	} catch (error) {
+		if (isAbortError(error)) throw new Error("timeout");
+		throw error instanceof Error ? error : new Error(String(error));
+	} finally {
+		clearTimeout(timer);
+	}
+}
+async function followFeed(startUrl, fetchFn, lookup, signal, maxBytes, maxRedirects) {
+	const seen = /* @__PURE__ */ new Set();
+	let current = startUrl;
+	for (let hops = 0; hops <= maxRedirects; hops += 1) {
+		await assertSafeFeedTarget(current, lookup);
+		if (seen.has(current)) throw new Error("too many redirects");
+		seen.add(current);
+		const response = await fetchFn(current, {
+			method: "GET",
+			redirect: "manual",
+			signal,
+			headers: {
+				Accept: "application/rss+xml, application/atom+xml, application/xml, text/xml;q=0.9",
+				"User-Agent": "ox-content-blog-feeds/1.0"
+			}
+		});
+		if (isRedirect(response.status)) {
+			current = resolveRedirect(current, response.headers.get("location"));
+			continue;
+		}
+		if (!response.ok) throw new Error(`HTTP ${response.status}`);
+		assertFeedContentType(response.headers.get("content-type"));
+		return readBoundedBody(response, maxBytes);
+	}
+	throw new Error("too many redirects");
+}
+async function assertSafeFeedTarget(url, lookup) {
+	if (!isSafeFeedUrl(url)) throw new Error("unsafe URL");
+	const hostname = new URL(url).hostname;
+	const addresses = await lookup(hostname);
+	if (addresses.length === 0 || addresses.some((address) => isBlockedFeedAddress(address))) throw new Error("private network");
+}
+async function defaultLookup(hostname) {
+	return (await lookup(hostname, {
+		all: true,
+		verbatim: true
+	})).map((record) => record.address);
+}
+function defaultFetch(input, init) {
+	return fetch(input, init);
+}
+function isRedirect(status) {
+	return status === 301 || status === 302 || status === 303 || status === 307 || status === 308;
+}
+function resolveRedirect(current, location) {
+	if (!location?.trim()) throw new Error("too many redirects");
+	try {
+		return new URL(location, current).href;
+	} catch {
+		throw new Error("unsafe URL");
+	}
+}
+function assertFeedContentType(value) {
+	if (!value) return;
+	const type = value.split(";")[0]?.trim().toLowerCase() ?? "";
+	if (type === "text/html" || type === "application/xhtml+xml" || type === "application/json") throw new Error("not a feed");
+}
+async function readBoundedBody(response, maxBytes) {
+	const length = Number(response.headers.get("content-length"));
+	if (Number.isFinite(length) && length > maxBytes) throw new Error("oversized");
+	const reader = response.body?.getReader();
+	if (!reader) {
+		const text = await response.text();
+		if (new TextEncoder().encode(text).byteLength > maxBytes) throw new Error("oversized");
+		return text;
+	}
+	const chunks = [];
+	let total = 0;
+	while (true) {
+		const { done, value } = await reader.read();
+		if (done) break;
+		if (!value) continue;
+		total += value.byteLength;
+		if (total > maxBytes) {
+			await reader.cancel();
+			throw new Error("oversized");
+		}
+		chunks.push(value);
+	}
+	return new TextDecoder("utf-8").decode(concatBytes(chunks, total));
+}
+function concatBytes(chunks, total) {
+	const out = new Uint8Array(total);
+	let offset = 0;
+	for (const chunk of chunks) {
+		out.set(chunk, offset);
+		offset += chunk.byteLength;
+	}
+	return out;
+}
+function isAbortError(error) {
+	return error instanceof Error && (error.name === "AbortError" || error.message === "timeout");
+}
+//#endregion
+//#region src/blog-feed-parse.ts
+/**
+* RSS 2.0 / Atom 1.0 item extraction. HTML documents are rejected.
+*/
+const ITEM_BLOCK = /<(?:[\w.-]+:)?item\b[^>]*>([\s\S]*?)<\/(?:[\w.-]+:)?item>/gi;
+const ENTRY_BLOCK = /<(?:[\w.-]+:)?entry\b[^>]*>([\s\S]*?)<\/(?:[\w.-]+:)?entry>/gi;
+function parseBlogFeed(body, feedLanguage) {
+	const xml = stripBom(body);
+	if (looksLikeHtml(xml)) throw new Error("not a feed");
+	if (!looksLikeXmlFeed(xml)) throw new Error("malformed XML");
+	const channelLanguage = textChild(xml, ["language", "dc:language"]) ?? xmlLang(xml) ?? feedLanguage;
+	const items = collectBlocks(xml, ITEM_BLOCK).map((block) => normalizeRssItem(block, channelLanguage));
+	if (items.length > 0 || /<(?:[\w.-]+:)?rss\b/i.test(xml)) return items.filter((item) => item != null);
+	return collectBlocks(xml, ENTRY_BLOCK).map((block) => normalizeAtomEntry(block, channelLanguage)).filter((item) => item != null);
+}
+function normalizeRssItem(block, fallbackLanguage) {
+	const title = textChild(block, ["title"]);
+	const guid = guidChild(block);
+	const link = canonicalizeFeedItemUrl(textChild(block, ["link"]) ?? "") ?? (guid?.permalink ? canonicalizeFeedItemUrl(guid.value) : void 0);
+	if (!title || !link) return;
 	return {
-		enabled: true,
-		collection: value.collection,
-		authors: normalizeAuthors(value.authors),
-		pageSize: normalizePageSize(value.pageSize)
-	};
+		title,
+		link,
+		id: guid?.value || link,
+		date: parseFeedDate(textChild(block, [
+			"pubDate",
+			"dc:date",
+			"published",
+			"updated"
+		])),
+		language: textChild(block, ["language", "dc:language"]) ?? xmlLang(block) ?? fallbackLanguage,
+		summary: textChild(block, [
+			"description",
+			"summary",
+			"content:encoded",
+			"content"
+		])
+	};
+}
+function normalizeAtomEntry(block, fallbackLanguage) {
+	const title = textChild(block, ["title"]);
+	const link = canonicalizeFeedItemUrl(atomLink(block) ?? "");
+	if (!title || !link) return;
+	return {
+		title,
+		link,
+		id: textChild(block, ["id"]) || link,
+		date: parseFeedDate(textChild(block, [
+			"published",
+			"updated",
+			"dc:date"
+		])),
+		language: xmlLang(block) ?? textChild(block, ["language", "dc:language"]) ?? fallbackLanguage,
+		summary: textChild(block, [
+			"summary",
+			"content",
+			"description"
+		])
+	};
+}
+function collectBlocks(xml, pattern) {
+	return [...xml.matchAll(pattern)].flatMap((match) => match[1] ? [match[1]] : []);
+}
+function textChild(block, names) {
+	for (const name of names) {
+		const pattern = new RegExp(`<(?:[\\w.-]+:)?${escapeRegExp$1(localName(name))}(?:\\s[^>]*)?>([\\s\\S]*?)</(?:[\\w.-]+:)?${escapeRegExp$1(localName(name))}>`, "i");
+		const match = block.match(pattern);
+		if (match?.[1] != null) {
+			const text = decodeXmlText(match[1]);
+			if (text) return text;
+		}
+	}
 }
-/**
-* Picks a collection named `blog`, else the only configured collection.
-*
-* An explicit name always wins. Several collections and no `blog` name
-* require `blog.collection`.
-*/
-function resolveBlogCollectionName(requested, collectionNames) {
-	if (requested) return requested;
-	if (collectionNames.includes("blog")) return "blog";
-	if (collectionNames.length === 1) return collectionNames[0];
+function guidChild(block) {
+	const match = block.match(/<(?:[\w.-]+:)?guid\b([^>]*)>([\s\S]*?)<\/(?:[\w.-]+:)?guid>/i);
+	if (!match?.[2]) return;
+	const value = decodeXmlText(match[2]);
+	if (!value) return;
+	const attrs = match[1] ?? "";
+	return {
+		value,
+		permalink: !/isPermaLink\s*=\s*(['"]?)false\1/i.test(attrs)
+	};
 }
-function normalizeAuthors(authors) {
-	if (!authors || typeof authors !== "object") return {};
-	const resolved = {};
-	for (const [key, value] of Object.entries(authors)) {
-		if (!value || typeof value.name !== "string") continue;
-		resolved[key] = {
-			name: value.name,
-			bio: typeof value.bio === "string" ? value.bio : void 0,
-			url: typeof value.url === "string" ? value.url : void 0
-		};
+function atomLink(block) {
+	const links = [];
+	for (const match of block.matchAll(/<(?:[\w.-]+:)?link\b([^>]*)\/?>/gi)) {
+		const href = attrValue(match[1] ?? "", "href");
+		if (!href) continue;
+		links.push({
+			href,
+			rel: (attrValue(match[1] ?? "", "rel") ?? "alternate").toLowerCase()
+		});
 	}
-	return resolved;
+	return links.find((link) => link.rel === "alternate")?.href ?? links[0]?.href;
 }
-function normalizePageSize(value) {
-	if (typeof value === "number" && Number.isFinite(value) && value >= 1) return Math.floor(value);
-	return DEFAULT_PAGE_SIZE;
+function xmlLang(block) {
+	return block.match(/\bxml:lang\s*=\s*(['"])([^'"]+)\1/i)?.[2]?.trim() || void 0;
 }
-//#endregion
-//#region src/blog-reading.ts
-/**
-* Deterministic blog reading-time estimates.
-*/
-const LATIN_WORDS_PER_MINUTE = 200;
-const CJK_CHARS_PER_MINUTE = 500;
-function readingTimeMinutes(markdown) {
-	const body = stripInlineCode(stripFences(stripFrontmatter(markdown)));
-	let latin = 0;
-	let cjk = 0;
-	let latinRun = false;
-	for (const char of body) {
-		const code = char.codePointAt(0) ?? 0;
-		if (isCjkCodePoint(code)) {
-			cjk += 1;
-			latinRun = false;
-			continue;
+function attrValue(attrs, name) {
+	return attrs.match(new RegExp(`(?:^|\\s)${name}\\s*=\\s*(['"])([\\s\\S]*?)\\1`, "i"))?.[2]?.trim() || void 0;
+}
+function decodeXmlText(value) {
+	return decodeEntities(value.replace(/<!\[CDATA\[([\s\S]*?)]]>/g, "$1").replace(/<[^>]+>/g, " ")).replace(/\s+/g, " ").trim();
+}
+function decodeEntities(value) {
+	return value.replace(/&(#x?[0-9a-f]+|[a-z]+);/gi, (entity, name) => {
+		const lower = name.toLowerCase();
+		if (lower === "amp") return "&";
+		if (lower === "lt") return "<";
+		if (lower === "gt") return ">";
+		if (lower === "quot") return "\"";
+		if (lower === "apos") return "'";
+		if (lower.startsWith("#x")) {
+			const code = Number.parseInt(lower.slice(2), 16);
+			return Number.isFinite(code) ? String.fromCodePoint(code) : entity;
 		}
-		if (isLatinWordChar(code)) {
-			if (!latinRun) {
-				latin += 1;
-				latinRun = true;
-			}
-			continue;
+		if (lower.startsWith("#")) {
+			const code = Number.parseInt(lower.slice(1), 10);
+			return Number.isFinite(code) ? String.fromCodePoint(code) : entity;
 		}
-		if (char === "'" || char === "’") continue;
-		latinRun = false;
-	}
-	if (latin === 0 && cjk === 0) return 0;
-	return Math.max(1, Math.ceil(latin / LATIN_WORDS_PER_MINUTE + cjk / CJK_CHARS_PER_MINUTE));
+		return entity;
+	});
 }
-function stripFrontmatter(markdown) {
-	if (!markdown.startsWith("---")) return markdown;
-	const match = markdown.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/);
-	return match ? markdown.slice(match[0].length) : markdown;
+function looksLikeHtml(body) {
+	const start = body.trim().slice(0, 256).toLowerCase();
+	return start.startsWith("<!doctype html") || start.startsWith("<html");
 }
-function stripFences(text) {
-	return text.replace(/```[\s\S]*?(?:```|$)/g, " ");
+function looksLikeXmlFeed(body) {
+	return /<(?:[\w.-]+:)?(?:rss|feed|rdf:RDF|item|entry)\b/i.test(body);
 }
-function stripInlineCode(text) {
-	return text.replace(/`[^`\n]*`/g, " ");
+function stripBom(value) {
+	return value.charCodeAt(0) === 65279 ? value.slice(1) : value;
 }
-function isCjkCodePoint(code) {
-	return code >= 12352 && code <= 12543 || code >= 12784 && code <= 12799 || code >= 13312 && code <= 19903 || code >= 19968 && code <= 40959 || code >= 63744 && code <= 64255 || code >= 44032 && code <= 55215 || code >= 4352 && code <= 4607;
+function localName(name) {
+	const index = name.indexOf(":");
+	return index === -1 ? name : name.slice(index + 1);
 }
-function isLatinWordChar(code) {
-	return code >= 48 && code <= 57 || code >= 65 && code <= 90 || code >= 97 && code <= 122;
+function escapeRegExp$1(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 //#endregion
 //#region src/blog-html.ts
@@ -6636,13 +7820,13 @@ function isSafeBlogUrl(value) {
 	return trimmed.toLowerCase().startsWith("https:");
 }
 function postMetaMarkup(meta) {
-	const parts = [`<p class="ox-blog-meta__reading-time">${escapeHtml$1(String(meta.minutes))} min read</p>`];
+	const parts = [`<p class="ox-blog-meta__reading-time">${escapeHtml(String(meta.minutes))} min read</p>`];
 	if (meta.authors.length > 0) {
 		const items = meta.authors.map((author) => authorMarkup(author)).join("");
 		parts.push(`<ul class="ox-blog-meta__authors">${items}</ul>`);
 	}
 	if (meta.tags.length > 0) {
-		const items = meta.tags.map((tag) => `<li><a href="${escapeHtml$1(tag.href)}">${escapeHtml$1(tag.label)}</a></li>`).join("");
+		const items = meta.tags.map((tag) => `<li><a href="${escapeHtml(tag.href)}">${escapeHtml(tag.label)}</a></li>`).join("");
 		parts.push(`<ul class="ox-blog-meta__tags">${items}</ul>`);
 	}
 	return `<aside class="ox-blog-meta">${parts.join("")}</aside>\n`;
@@ -6650,25 +7834,25 @@ function postMetaMarkup(meta) {
 function indexPageContent(items, pager) {
 	const list = items.map((item) => listItem(item)).join("");
 	const links = [];
-	if (pager.newerHref) links.push(`<a href="${escapeHtml$1(pager.newerHref)}" rel="prev">Newer</a>`);
-	if (pager.olderHref) links.push(`<a href="${escapeHtml$1(pager.olderHref)}" rel="next">Older</a>`);
+	if (pager.newerHref) links.push(`<a href="${escapeHtml(pager.newerHref)}" rel="prev">Newer</a>`);
+	if (pager.olderHref) links.push(`<a href="${escapeHtml(pager.olderHref)}" rel="next">Older</a>`);
 	return `<h1>Blog</h1><ul class="ox-blog">${list}</ul>${links.length > 0 ? `<nav class="ox-blog-pager">${links.join("")}</nav>` : ""}`;
 }
 function tagPageContent(label, items) {
 	const list = items.map((item) => listItem(item)).join("");
-	return `<h1>${escapeHtml$1(label)}</h1><ul class="ox-blog-tag">${list}</ul>`;
+	return `<h1>${escapeHtml(label)}</h1><ul class="ox-blog-tag">${list}</ul>`;
 }
 function archiveIndexContent(years) {
-	return `<h1>Archive</h1><ul class="ox-blog-archive">${years.map((entry) => `<li><a href="${escapeHtml$1(entry.href)}">${escapeHtml$1(entry.year)}</a></li>`).join("")}</ul>`;
+	return `<h1>Archive</h1><ul class="ox-blog-archive">${years.map((entry) => `<li><a href="${escapeHtml(entry.href)}">${escapeHtml(entry.year)}</a></li>`).join("")}</ul>`;
 }
 function archiveYearContent(year, months, items) {
-	const monthList = months.map((entry) => `<li><a href="${escapeHtml$1(entry.href)}">${escapeHtml$1(entry.month)}</a></li>`).join("");
+	const monthList = months.map((entry) => `<li><a href="${escapeHtml(entry.href)}">${escapeHtml(entry.month)}</a></li>`).join("");
 	const posts = items.map((item) => listItem(item)).join("");
-	return `<h1>${escapeHtml$1(year)}</h1><ul class="ox-blog-archive-months">${monthList}</ul><ul class="ox-blog">${posts}</ul>`;
+	return `<h1>${escapeHtml(year)}</h1><ul class="ox-blog-archive-months">${monthList}</ul><ul class="ox-blog">${posts}</ul>`;
 }
 function archiveMonthContent(label, items) {
 	const list = items.map((item) => listItem(item)).join("");
-	return `<h1>${escapeHtml$1(label)}</h1><ul class="ox-blog">${list}</ul>`;
+	return `<h1>${escapeHtml(label)}</h1><ul class="ox-blog">${list}</ul>`;
 }
 function siteHref$2(base, ...segments) {
 	const prefix = !base || base === "/" ? "/" : base.endsWith("/") ? base : `${base}/`;
@@ -6682,17 +7866,18 @@ function containedPath$1(outDir, ...segments) {
 	if (resolved === root || !resolved.startsWith(prefix)) return;
 	return resolved;
 }
-function escapeHtml$1(value) {
+function escapeHtml(value) {
 	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
 }
 function authorMarkup(author) {
-	const name = escapeHtml$1(author.name);
+	const name = escapeHtml(author.name);
 	const url = author.url?.trim();
-	return `<li>${url && isSafeBlogUrl(url) ? `<a class="ox-blog-meta__name" href="${escapeHtml$1(url)}">${name}</a>` : `<span class="ox-blog-meta__name">${name}</span>`}${author.bio && author.bio.length > 0 ? `<p class="ox-blog-meta__bio">${escapeHtml$1(author.bio)}</p>` : ""}</li>`;
+	return `<li>${url && isSafeBlogUrl(url) ? `<a class="ox-blog-meta__name" href="${escapeHtml(url)}">${name}</a>` : `<span class="ox-blog-meta__name">${name}</span>`}${author.bio && author.bio.length > 0 ? `<p class="ox-blog-meta__bio">${escapeHtml(author.bio)}</p>` : ""}</li>`;
 }
 function listItem(item) {
-	const time = item.dateLabel ? ` <time datetime="${escapeHtml$1(item.dateLabel)}">${escapeHtml$1(item.dateLabel)}</time>` : "";
-	return `<li><a href="${escapeHtml$1(item.href)}">${escapeHtml$1(item.title)}</a>${time}</li>`;
+	const time = item.dateLabel ? ` <time datetime="${escapeHtml(item.dateLabel)}">${escapeHtml(item.dateLabel)}</time>` : "";
+	if (item.external) return `<li class="ox-blog-external" data-ox-blog-external="true"><a href="${escapeHtml(item.href)}" rel="external noopener noreferrer">${escapeHtml(item.title)}</a>${time}</li>`;
+	return `<li><a href="${escapeHtml(item.href)}">${escapeHtml(item.title)}</a>${time}</li>`;
 }
 //#endregion
 //#region src/blog-posts.ts
@@ -6798,7 +7983,8 @@ function toListItem(page) {
 	return {
 		title: page.title,
 		href: page.routePaths.href,
-		dateLabel: parsed ? `${String(parsed.year).padStart(4, "0")}-${String(parsed.month).padStart(2, "0")}-${String(parsed.day).padStart(2, "0")}` : void 0
+		dateLabel: parsed ? `${String(parsed.year).padStart(4, "0")}-${String(parsed.month).padStart(2, "0")}-${String(parsed.day).padStart(2, "0")}` : void 0,
+		...page.external || page.frontmatter.external === true ? { external: true } : {}
 	};
 }
 function resolvePostAuthors(frontmatter, map) {
@@ -6858,6 +8044,158 @@ function dateField(value) {
 	if (value instanceof Date && !Number.isNaN(value.getTime())) return value.toISOString();
 }
 //#endregion
+//#region src/blog-feeds.ts
+var BlogFeedError = class extends Error {
+	issues;
+	constructor(issues) {
+		super(issues.join("\n"));
+		this.name = "BlogFeedError";
+		this.issues = issues;
+	}
+};
+async function loadExternalBlogPosts(sources, network = {}) {
+	const pages = [];
+	const warnings = [];
+	const fatals = [];
+	if (sources.length === 0) return {
+		pages,
+		warnings,
+		fatals
+	};
+	const bodies = /* @__PURE__ */ new Map();
+	const results = await Promise.all(sources.map(async (source) => {
+		try {
+			return {
+				source,
+				pages: parseBlogFeed(await cachedBody(source.url, bodies, network), source.language).map((item) => toExternalPage(item, source)).filter((page) => page != null)
+			};
+		} catch (error) {
+			const detail = error instanceof Error ? error.message : String(error);
+			return {
+				source,
+				message: `[ox-content] blog feed ${source.url}: ${detail}`
+			};
+		}
+	}));
+	for (const result of results) {
+		if ("pages" in result) {
+			pages.push(...result.pages);
+			continue;
+		}
+		if (result.source.onError === "error") fatals.push(result.message);
+		else warnings.push(result.message);
+	}
+	return {
+		pages,
+		warnings,
+		fatals
+	};
+}
+function mergeBlogPosts(local, external) {
+	const seenUrls = /* @__PURE__ */ new Set();
+	const seenIds = /* @__PURE__ */ new Set();
+	const merged = [];
+	for (const page of [...local, ...external]) {
+		const keys = identityKeys(page);
+		if (seenUrls.has(keys.url) || seenIds.has(keys.id)) continue;
+		seenUrls.add(keys.url);
+		seenIds.add(keys.id);
+		merged.push(page);
+	}
+	return sortPosts(merged);
+}
+function cachedBody(url, cache, network) {
+	const existing = cache.get(url);
+	if (existing) return existing;
+	const pending = fetchBlogFeedBody(url, network);
+	cache.set(url, pending);
+	return pending;
+}
+function toExternalPage(item, source) {
+	const link = canonicalizeFeedItemUrl(item.link);
+	if (!link) return;
+	const id = item.id.trim() || link;
+	const language = item.language ?? source.language;
+	const author = source.author;
+	return {
+		title: item.title,
+		inputPath: `external:${id}`,
+		transformedHtml: "",
+		external: true,
+		routePaths: { href: link },
+		frontmatter: {
+			external: true,
+			id,
+			date: item.date ? feedDateIso(item.date) : void 0,
+			language,
+			author,
+			summary: item.summary
+		}
+	};
+}
+function identityKeys(page) {
+	const explicitId = stringField(page.frontmatter.id);
+	const canonical = stringField(page.frontmatter.canonical);
+	const href = page.routePaths.href;
+	const url = canonicalizeFeedItemUrl(canonical ?? "") ?? canonicalizeFeedItemUrl(href) ?? href;
+	return {
+		url,
+		id: explicitId || url
+	};
+}
+function stringField(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+//#endregion
+//#region src/blog-reading.ts
+/**
+* Deterministic blog reading-time estimates.
+*/
+const LATIN_WORDS_PER_MINUTE = 200;
+const CJK_CHARS_PER_MINUTE = 500;
+function readingTimeMinutes(markdown) {
+	const body = stripInlineCode(stripFences(stripFrontmatter(markdown)));
+	let latin = 0;
+	let cjk = 0;
+	let latinRun = false;
+	for (const char of body) {
+		const code = char.codePointAt(0) ?? 0;
+		if (isCjkCodePoint(code)) {
+			cjk += 1;
+			latinRun = false;
+			continue;
+		}
+		if (isLatinWordChar(code)) {
+			if (!latinRun) {
+				latin += 1;
+				latinRun = true;
+			}
+			continue;
+		}
+		if (char === "'" || char === "’") continue;
+		latinRun = false;
+	}
+	if (latin === 0 && cjk === 0) return 0;
+	return Math.max(1, Math.ceil(latin / LATIN_WORDS_PER_MINUTE + cjk / CJK_CHARS_PER_MINUTE));
+}
+function stripFrontmatter(markdown) {
+	if (!markdown.startsWith("---")) return markdown;
+	const match = markdown.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/);
+	return match ? markdown.slice(match[0].length) : markdown;
+}
+function stripFences(text) {
+	return text.replace(/```[\s\S]*?(?:```|$)/g, " ");
+}
+function stripInlineCode(text) {
+	return text.replace(/`[^`\n]*`/g, " ");
+}
+function isCjkCodePoint(code) {
+	return code >= 12352 && code <= 12543 || code >= 12784 && code <= 12799 || code >= 13312 && code <= 19903 || code >= 19968 && code <= 40959 || code >= 63744 && code <= 64255 || code >= 44032 && code <= 55215 || code >= 4352 && code <= 4607;
+}
+function isLatinWordChar(code) {
+	return code >= 48 && code <= 57 || code >= 65 && code <= 90 || code >= 97 && code <= 122;
+}
+//#endregion
 //#region src/blog-pages.ts
 /**
 * Generated blog index, tag, and archive pages.
@@ -6869,7 +8207,7 @@ async function injectBlogPostMeta(input) {
 	if (posts === void 0) return;
 	const listedPaths = new Set(posts.map((page) => page.inputPath));
 	for (const page of input.pages) {
-		if (!listedPaths.has(page.inputPath)) continue;
+		if (!listedPaths.has(page.inputPath) || page.external === true) continue;
 		const markdown = await readMarkdown(page.inputPath);
 		page.transformedHtml = postMetaMarkup({
 			authors: resolvePostAuthors(page.frontmatter, input.options.authors),
@@ -6902,8 +8240,9 @@ async function appendBlogPages(input) {
 		input.errors.push(AMBIGUOUS_COLLECTION);
 		return;
 	}
-	const posts = selectBlogPosts(input.listedPages, input.options, input.srcDir, input.collections);
-	if (posts === void 0) return;
+	const local = selectBlogPosts(input.listedPages, input.options, input.srcDir, input.collections);
+	if (local === void 0) return;
+	const posts = await collectIndexPosts(local, input.options, input.errors, input.feedNetwork);
 	for (const spec of blogPageSpecs(posts, input.options, input.outDir, input.base)) try {
 		input.generatedPages.push({
 			inputPath: spec.outputPath,
@@ -6998,6 +8337,14 @@ function blogPageSpecs(posts, options, outDir, base) {
 	}
 	return pages;
 }
+async function collectIndexPosts(local, options, errors, network) {
+	if (options.feeds.length === 0) return local;
+	const loaded = await loadExternalBlogPosts(options.feeds, network);
+	errors.push(...loaded.warnings);
+	for (const warning of loaded.warnings) console.warn(warning);
+	if (loaded.fatals.length > 0) throw new BlogFeedError(loaded.fatals);
+	return mergeBlogPosts(local, loaded.pages);
+}
 async function readMarkdown(inputPath) {
 	try {
 		return await fs$2.readFile(inputPath, "utf8");
@@ -7510,59 +8857,6 @@ function generateSearchModule(options, indexPath) {
 	return importNapiModuleSync().generateSearchModuleFromOptions(toLocalSearchRuntimeOptions(options), indexPath);
 }
 //#endregion
-//#region src/versions-html.ts
-function versionSwitcherMarkup(links, badge) {
-	if (links.length === 0) return "";
-	const current = links.find((link) => link.current) ?? links[0];
-	const items = links.map((link) => {
-		const label = `${escapeHtml(link.label)}${badgeMarkup(link, badge)}`;
-		if (link.current || !isSafeHref(link.href)) return `<li><span aria-current="page">${label}</span></li>`;
-		return `<li><a href="${escapeHtml(link.href)}">${label}</a></li>`;
-	}).join("");
-	return `<nav class="ox-header-select ox-version-switcher" aria-label="Version"><button type="button" aria-expanded="false" aria-haspopup="true">${escapeHtml(current.label)}${badgeMarkup(current, badge)}</button><ul class="ox-header-select-menu">${items}</ul></nav><script>(function(){var n=document.currentScript&&document.currentScript.previousElementSibling;if(!n||!n.classList.contains("ox-version-switcher"))return;var b=n.querySelector("button");if(!b)return;function closeOthers(){document.querySelectorAll(".header-nav-dropdown > button[aria-expanded='true'], .ox-locale-switcher > button[aria-expanded='true']").forEach(function(btn){btn.setAttribute("aria-expanded","false");});}b.addEventListener("click",function(e){e.stopPropagation();var o=b.getAttribute("aria-expanded")==="true";closeOthers();b.setAttribute("aria-expanded",o?"false":"true");});document.addEventListener("click",function(e){if(!n.contains(e.target))b.setAttribute("aria-expanded","false");});document.addEventListener("keydown",function(e){if(e.key==="Escape"){b.setAttribute("aria-expanded","false");b.focus();}});})()<\/script>`;
-}
-function versionBannerMarkup(kind) {
-	if (kind === "unreleased") return `<aside class="ox-version-banner ox-version-banner--unreleased" role="status">This documentation describes an unreleased version.</aside>`;
-	if (kind === "unmaintained") return `<aside class="ox-version-banner ox-version-banner--unmaintained" role="status">This documentation is unmaintained.</aside>`;
-	return "";
-}
-function injectVersionChrome(html, switcher, banner, searchFrom, searchTo) {
-	let next = html;
-	if (banner) next = next.replace(/<body([^>]*)>/, `<body$1>${banner}`);
-	if (switcher) {
-		if (next.includes("<div class=\"header-actions\">")) next = next.replace("<div class=\"header-actions\">", `<div class="header-actions">${switcher}`);
-		else if (next.includes("</header>")) next = next.replace("</header>", `${switcher}</header>`);
-	}
-	if (searchTo && isSafeHref(searchTo)) next = next.replace(/<html([^>]*)>/i, (match, attrs) => {
-		if (/\sdata-ox-search-index=/.test(attrs)) return match;
-		return `<html${attrs} data-ox-search-index="${escapeHtml(searchTo)}">`;
-	});
-	if (searchFrom && searchTo && searchFrom !== searchTo && isSafeHref(searchTo)) {
-		next = next.split(searchFrom).join(searchTo);
-		const script = `<script>(function(){var f=${JSON.stringify(searchFrom)},t=${JSON.stringify(searchTo)};var o=window.fetch;window.fetch=function(i,n){if(typeof i==="string"&&i.indexOf(f)!==-1)i=i.split(f).join(t);return o.call(this,i,n);};})()<\/script>`;
-		next = next.includes("</body>") ? next.replace("</body>", `${script}</body>`) : `${next}${script}`;
-	}
-	return next;
-}
-function searchIndexUrl(base, prefix) {
-	const root = !base || base === "/" ? "/" : base.endsWith("/") ? base : `${base}/`;
-	return prefix ? `${root}${prefix}/search-index.json` : `${root}search-index.json`;
-}
-function isSafeHref(href) {
-	const trimmed = href.trim();
-	if (!trimmed || trimmed.startsWith("//")) return false;
-	const lower = trimmed.replace(/\s+/g, "").toLowerCase();
-	if (lower.startsWith("javascript:") || lower.startsWith("data:") || lower.startsWith("vbscript:")) return false;
-	return trimmed.startsWith("/") || trimmed.startsWith("./") || !trimmed.includes(":");
-}
-function escapeHtml(value) {
-	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
-}
-function badgeMarkup(link, badge) {
-	if (!badge || !link.banner) return "";
-	return `<span class="ox-version-badge">${link.banner === "unreleased" ? "unreleased" : "unmaintained"}</span>`;
-}
-//#endregion
 //#region src/versions.ts
 /**
 * Opt-in documentation versioning: prefixes, snapshots, and header chrome.
@@ -7693,7 +8987,13 @@ async function writeSnapshotSearchIndex(input) {
 function applyVersionChrome(html, options, activeId, siblingPath, base, existingHrefs) {
 	if (!options.enabled) return html;
 	const active = options.entries.find((entry) => entry.id === activeId);
-	return injectVersionChrome(html, options.switcher ? versionSwitcherMarkup(versionLinks(options, activeId, siblingPath, base, existingHrefs), options.badge) : "", versionBannerMarkup(active?.banner), searchIndexUrl(base, currentVersionPrefix(options)), searchIndexUrl(base, active?.prefix ?? ""));
+	return injectSearchVersionFilters(injectVersionChrome(html, options.switcher ? versionSwitcherMarkup(versionLinks(options, activeId, siblingPath, base, existingHrefs), options.badge) : "", versionBannerMarkup(active?.banner), searchIndexUrl(base, currentVersionPrefix(options)), searchIndexUrl(base, active?.prefix ?? "")), options.entries.map((entry) => ({
+		id: entry.id,
+		label: entry.label,
+		prefix: entry.prefix,
+		indexUrl: searchIndexUrl(base, entry.prefix),
+		current: entry.id === activeId
+	})));
 }
 function sanitizePrefix(prefix) {
 	const trimmed = prefix.trim().replace(/^\/+|\/+$/g, "");
@@ -7730,21 +9030,182 @@ function normalizeEntries(entries) {
 			banner: normalizeBanner(entry.banner)
 		});
 	}
-	return resolved;
+	return resolved;
+}
+function normalizeBanner(value) {
+	return value === "unreleased" || value === "unmaintained" ? value : false;
+}
+function siteHref$1(base, prefix, rest) {
+	const root = !base || base === "/" ? "/" : base.endsWith("/") ? base : `${base}/`;
+	const parts = [prefix, rest].filter((part) => part && part !== "/");
+	return parts.length === 0 ? root : `${root}${parts.join("/")}/`;
+}
+function relativeUrl(outputPath, outDir) {
+	const rel = path$1.posix.normalize(path$1.relative(path$1.resolve(outDir), path$1.resolve(outputPath)).replaceAll(path$1.sep, "/"));
+	if (rel.startsWith("..")) return "";
+	const dir = rel.endsWith("/index.html") ? rel.slice(0, -11) : rel.replace(/\.html$/, "");
+	return dir === "." ? "" : dir;
+}
+//#endregion
+//#region src/resources-dedupe.ts
+/**
+* Site-wide content-addressed emit for identical page-resource bytes.
+*
+* Hashing streams the file. The first digest+extension pair writes once;
+* later pages reuse that path. Image decode is never used here.
+*/
+const DEDUPE_ASSET_DIR = path$1.join("assets", "content");
+const TRANSFORM_QUERY_KEYS = /* @__PURE__ */ new Set([
+	"width",
+	"w",
+	"height",
+	"h",
+	"crop",
+	"format"
+]);
+function createResourceDedupeStore() {
+	return {
+		canonical: /* @__PURE__ */ new Map(),
+		hashes: /* @__PURE__ */ new Map()
+	};
+}
+function normalizeDedupeExt(ext) {
+	const value = ext.replace(/^\./, "").trim().toLowerCase();
+	if (value === "jpeg") return "jpg";
+	return value || "bin";
+}
+function canonicalPublicPath(base, digest, ext) {
+	return `${!base || base === "/" ? "/" : base.endsWith("/") ? base : `${base}/`}${DEDUPE_ASSET_DIR.split(path$1.sep).join("/")}/${digest}.${ext}`;
+}
+function canonicalAbsolutePath(outDir, digest, ext) {
+	return path$1.join(outDir, DEDUPE_ASSET_DIR, `${digest}.${ext}`);
+}
+/**
+* SHA-256 of emitted bytes plus a NUL and the serving extension so the
+* same payload cannot be served under an incompatible media type.
+*/
+async function hashResourceFile(filePath, ext, store, reuseKey) {
+	const cached = store.hashes.get(reuseKey);
+	if (cached) return cached;
+	const hash = createHash("sha256");
+	for await (const chunk of createReadStream(filePath)) hash.update(chunk);
+	hash.update("\0");
+	hash.update(ext);
+	const digest = hash.digest("hex");
+	store.hashes.set(reuseKey, digest);
+	return digest;
+}
+async function emitCanonicalResource(store, input) {
+	const key = `${input.digest}\0${input.ext}`;
+	const existing = store.canonical.get(key);
+	const publicPath = canonicalPublicPath(input.base, input.digest, input.ext);
+	if (existing) return {
+		asset: {
+			digest: input.digest,
+			ext: input.ext,
+			absolutePath: existing,
+			publicPath
+		},
+		wrote: false
+	};
+	const absolutePath = canonicalAbsolutePath(input.outDir, input.digest, input.ext);
+	await fs$2.mkdir(path$1.dirname(absolutePath), { recursive: true });
+	await fs$2.copyFile(input.sourcePath, absolutePath);
+	store.canonical.set(key, absolutePath);
+	return {
+		asset: {
+			digest: input.digest,
+			ext: input.ext,
+			absolutePath,
+			publicPath
+		},
+		wrote: true
+	};
+}
+/**
+* Prefer a hard link at the original output path. `link` failure removes
+* any stale alias and copies so a shared inode is never overwritten.
+*/
+async function linkOrCopyAlias(canonical, alias, linker = fs$2.link) {
+	await fs$2.mkdir(path$1.dirname(alias), { recursive: true });
+	try {
+		await linker(canonical, alias);
+		return "link";
+	} catch {
+		await fs$2.rm(alias, { force: true });
+	}
+	try {
+		await linker(canonical, alias);
+		return "link";
+	} catch {
+		await fs$2.copyFile(canonical, alias);
+		return "copy";
+	}
 }
-function normalizeBanner(value) {
-	return value === "unreleased" || value === "unmaintained" ? value : false;
+/** Keep leftover search/hash; drop consumed transform params. */
+function rewriteToCanonicalUrl(originalSrc, canonicalPath) {
+	const hashIndex = originalSrc.indexOf("#");
+	const hash = hashIndex === -1 ? "" : originalSrc.slice(hashIndex);
+	const withoutHash = hashIndex === -1 ? originalSrc : originalSrc.slice(0, hashIndex);
+	const queryIndex = withoutHash.indexOf("?");
+	return `${canonicalPath}${leftoverQuery(queryIndex === -1 ? "" : withoutHash.slice(queryIndex + 1))}${hash}`;
 }
-function siteHref$1(base, prefix, rest) {
-	const root = !base || base === "/" ? "/" : base.endsWith("/") ? base : `${base}/`;
-	const parts = [prefix, rest].filter((part) => part && part !== "/");
-	return parts.length === 0 ? root : `${root}${parts.join("/")}/`;
+function leftoverQuery(query) {
+	if (!query) return "";
+	const params = new URLSearchParams(query);
+	for (const key of TRANSFORM_QUERY_KEYS) params.delete(key);
+	const next = params.toString();
+	return next ? `?${next}` : "";
 }
-function relativeUrl(outputPath, outDir) {
-	const rel = path$1.posix.normalize(path$1.relative(path$1.resolve(outDir), path$1.resolve(outputPath)).replaceAll(path$1.sep, "/"));
-	if (rel.startsWith("..")) return "";
-	const dir = rel.endsWith("/index.html") ? rel.slice(0, -11) : rel.replace(/\.html$/, "");
-	return dir === "." ? "" : dir;
+//#endregion
+//#region src/resources-html.ts
+/**
+* Collect local `src`, `poster`, and relevant `href` values from HTML tags.
+*/
+const RESOURCE_TAG = /<(?:img|video|audio|source|track|a)\b[^>]*>/gi;
+const RESOURCE_ATTR = /\b(src|poster|href)\s*=\s*(?:"([^"]*)"|'([^']*)')/gi;
+function collectResourceTags(html) {
+	return (html.match(RESOURCE_TAG) ?? []).map((tag) => ({
+		tag,
+		refs: collectResourceRefs(tag)
+	})).filter((entry) => entry.refs.length > 0);
+}
+function collectResourceRefs(tag) {
+	const name = /^<([a-z]+)/i.exec(tag)?.[1]?.toLowerCase();
+	if (!name) return [];
+	const refs = [];
+	RESOURCE_ATTR.lastIndex = 0;
+	let match = RESOURCE_ATTR.exec(tag);
+	while (match) {
+		const attr = match[1].toLowerCase();
+		if (isRelevantAttr(name, attr)) {
+			const raw = match[2] ?? match[3] ?? "";
+			refs.push({
+				attr,
+				raw,
+				value: unescapeHtml(raw)
+			});
+		}
+		match = RESOURCE_ATTR.exec(tag);
+	}
+	return refs;
+}
+function isRelevantAttr(tagName, attr) {
+	if (tagName === "a") return attr === "href";
+	if (attr === "href") return false;
+	if (attr === "poster") return tagName === "video";
+	return attr === "src";
+}
+function unescapeHtml(value) {
+	return value.replaceAll("&amp;", "&").replaceAll("&quot;", "\"").replaceAll("&#39;", "'").replaceAll("&lt;", "<").replaceAll("&gt;", ">");
+}
+function escapeAttribute(value) {
+	return value.replaceAll("&", "&amp;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function replaceAttributeRaw(tag, raw, nextRaw) {
+	const index = tag.indexOf(raw);
+	if (index === -1) return tag;
+	return tag.slice(0, index) + nextRaw + tag.slice(index + raw.length);
 }
 //#endregion
 //#region src/resources-jpeg.ts
@@ -8787,129 +10248,23 @@ function coverCrop(image, width, height) {
 	return cropImage(scaled, Math.max(0, Math.floor((scaled.width - width) / 2)), Math.max(0, Math.floor((scaled.height - height) / 2)), width, height);
 }
 //#endregion
-//#region src/resources-process.ts
+//#region src/resources-write.ts
 /**
-* Page-resource HTML rewriting and transform writes.
+* Transform cache writes for page resources.
 */
-const IMG_TAG = /<img\b[^>]*>/gi;
-const SRC_ATTR = /\bsrc\s*=\s*(?:"([^"]*)"|'([^']*)')/i;
-async function processPageResources(input) {
-	if (!input.options.enabled) return {
-		html: input.html,
-		files: [],
-		errors: [],
-		fatal: []
-	};
-	const bundleRoot = path$1.dirname(input.inputPath);
-	const outputDir = path$1.dirname(input.outputPath);
-	const files = [];
-	const errors = [];
-	const fatal = [];
-	let html = input.html;
-	const tags = input.html.match(IMG_TAG) ?? [];
-	for (const tag of tags) {
-		const srcMatch = tag.match(SRC_ATTR);
-		const rawSrc = srcMatch?.[1] ?? srcMatch?.[2];
-		if (!rawSrc) continue;
-		const src = unescapeHtml(rawSrc);
-		const parsed = parseResourceSrc(src);
-		if (!parsed) continue;
-		const resolved = resolveBundlePath(parsed.pathname, bundleRoot, input.srcDir);
-		if (!resolved.ok) {
-			const message = `[ox-content] page resource ${JSON.stringify(src)} on ${input.inputPath} is outside the page bundle`;
-			errors.push(message);
-			fatal.push(message);
-			continue;
-		}
-		let stat;
-		try {
-			stat = await fs$2.stat(resolved.absolute);
-		} catch {
-			const message = `[ox-content] missing page resource ${JSON.stringify(parsed.pathname)} on ${input.inputPath}`;
-			errors.push(message);
-			if (input.options.missing === "error") fatal.push(message);
-			continue;
-		}
-		const transformError = validateTransform(parsed.transform, input.options);
-		if (transformError) {
-			const message = `[ox-content] ${transformError} for ${JSON.stringify(src)} on ${input.inputPath}`;
-			errors.push(message);
-			fatal.push(message);
-			continue;
-		}
-		const hasTransform = hasPixelOrFormatTransform(parsed.transform);
-		const outputName = hasTransform ? transformedFileName(parsed.pathname, parsed.transform, resourceCacheKey(resolved.absolute, stat.mtimeMs, parsed.transform)) : path$1.basename(resolved.absolute);
-		const outputFile = path$1.join(outputDir, outputName);
-		try {
-			if (hasTransform) await writeTransformedResource({
-				sourcePath: resolved.absolute,
-				outputFile,
-				cacheDir: input.cacheDir,
-				mtimeMs: stat.mtimeMs,
-				transform: parsed.transform
-			});
-			else {
-				await fs$2.mkdir(outputDir, { recursive: true });
-				await fs$2.copyFile(resolved.absolute, outputFile);
-			}
-			files.push(outputFile);
-			const rewritten = tag.replace(rawSrc, escapeAttribute(outputName));
-			html = html.replace(tag, rewritten);
-		} catch (error) {
-			const detail = error instanceof Error ? error.message : String(error);
-			const message = `[ox-content] failed to process page resource ${JSON.stringify(src)} on ${input.inputPath}: ${detail}`;
-			errors.push(message);
-			fatal.push(message);
-		}
-	}
-	return {
-		html,
-		files,
-		errors,
-		fatal
-	};
-}
-function resolveBundlePath(pathname, bundleRoot, contentRoot) {
-	if (path$1.isAbsolute(pathname) || pathname.includes("\0")) return { ok: false };
-	const absolute = path$1.resolve(bundleRoot, pathname);
-	if (!isInsideRoot$1(bundleRoot, absolute) || !isInsideRoot$1(contentRoot, absolute)) return { ok: false };
-	return {
-		ok: true,
-		absolute
-	};
-}
-function validateTransform(transform, options) {
-	if (transform.width && options.widths.length > 0 && !options.widths.includes(transform.width)) return `width ${transform.width} is not in resources.widths`;
-	if (transform.format && !options.formats.includes(transform.format)) return `format ${transform.format} is not in resources.formats`;
-}
-function hasPixelOrFormatTransform(transform) {
-	return Boolean(transform.width || transform.height || transform.crop || transform.format);
-}
-function transformedFileName(pathname, transform, cacheKey) {
-	const stem = path$1.basename(pathname).replace(/\.[^.]+$/, "") || "resource";
-	const ext = outputExtension(pathname, transform.format);
-	return `${stem}.${cacheKey.slice(0, 12)}.${ext}`;
-}
-function outputExtension(pathname, format) {
-	if (format === "jpeg") return "jpg";
-	if (format) return format;
-	const ext = path$1.extname(pathname).slice(1).toLowerCase();
-	return ext === "jpeg" ? "jpg" : ext || "png";
-}
-async function writeTransformedResource(input) {
+async function ensureTransformedCache(input) {
 	const key = resourceCacheKey(input.sourcePath, input.mtimeMs, input.transform);
 	const ext = path$1.extname(input.outputFile);
 	const cacheFile = path$1.join(input.cacheDir, `${key}${ext}`);
 	try {
-		await fs$2.copyFile(cacheFile, input.outputFile);
-		return;
+		await fs$2.access(cacheFile);
+		return cacheFile;
 	} catch {}
 	const output = transformResourceBuffer(await fs$2.readFile(input.sourcePath), input.sourcePath, input.transform);
 	if (output.length > 8388608) throw new Error("transform produced an oversized file");
-	await fs$2.mkdir(path$1.dirname(input.outputFile), { recursive: true });
 	await fs$2.mkdir(input.cacheDir, { recursive: true });
 	await fs$2.writeFile(cacheFile, output);
-	await fs$2.writeFile(input.outputFile, output);
+	return cacheFile;
 }
 function transformResourceBuffer(source, sourcePath, transform) {
 	const needsPixels = Boolean(transform.width || transform.height || transform.crop);
@@ -8952,11 +10307,221 @@ function formatFromPath(filePath) {
 	const ext = path$1.extname(filePath).slice(1).toLowerCase();
 	return ext === "jpg" ? "jpeg" : ext;
 }
-function unescapeHtml(value) {
-	return value.replaceAll("&amp;", "&").replaceAll("&quot;", "\"").replaceAll("&#39;", "'").replaceAll("&lt;", "<").replaceAll("&gt;", ">");
+//#endregion
+//#region src/resources-process.ts
+/**
+* Page-resource HTML rewriting and transform writes.
+*/
+const PAGE_EXTS = /* @__PURE__ */ new Set([
+	".md",
+	".markdown",
+	".mdx",
+	".html",
+	".htm"
+]);
+async function processPageResources(input) {
+	if (!input.options.enabled) return {
+		html: input.html,
+		files: [],
+		errors: [],
+		fatal: []
+	};
+	if (input.options.dedupe && !input.outDir) {
+		const message = "[ox-content] resources.dedupe requires outDir";
+		return {
+			html: input.html,
+			files: [],
+			errors: [message],
+			fatal: [message]
+		};
+	}
+	const bundleRoot = path$1.dirname(input.inputPath);
+	const outputDir = path$1.dirname(input.outputPath);
+	const files = [];
+	const errors = [];
+	const fatal = [];
+	let html = input.html;
+	const store = input.options.dedupe ? input.dedupeStore ?? createResourceDedupeStore() : void 0;
+	for (const { tag, refs } of collectResourceTags(input.html)) {
+		let nextTag = tag;
+		for (const ref of refs) {
+			const result = await processResourceRef(input, {
+				bundleRoot,
+				outputDir,
+				ref: ref.attr,
+				src: ref.value,
+				store
+			});
+			errors.push(...result.errors);
+			fatal.push(...result.fatal);
+			files.push(...result.files);
+			if (result.rewrite) nextTag = replaceAttributeRaw(nextTag, ref.raw, escapeAttribute(result.rewrite));
+		}
+		if (nextTag !== tag) html = html.replace(tag, nextTag);
+	}
+	return {
+		html,
+		files,
+		errors,
+		fatal
+	};
 }
-function escapeAttribute(value) {
-	return value.replaceAll("&", "&amp;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+async function processResourceRef(input, ctx) {
+	const parsed = parseResourceSrc(ctx.src);
+	if (!parsed) return {
+		files: [],
+		errors: [],
+		fatal: []
+	};
+	const resolved = resolveBundlePath(parsed.pathname, ctx.bundleRoot, input.srcDir);
+	if (!resolved.ok) {
+		if (ctx.ref === "href") return {
+			files: [],
+			errors: [],
+			fatal: []
+		};
+		const message = `[ox-content] page resource ${JSON.stringify(ctx.src)} on ${input.inputPath} is outside the page bundle`;
+		return {
+			files: [],
+			errors: [message],
+			fatal: [message]
+		};
+	}
+	let stat;
+	try {
+		stat = await fs$2.stat(resolved.absolute);
+	} catch {
+		if (ctx.ref === "href") return {
+			files: [],
+			errors: [],
+			fatal: []
+		};
+		const message = `[ox-content] missing page resource ${JSON.stringify(parsed.pathname)} on ${input.inputPath}`;
+		return {
+			files: [],
+			errors: [message],
+			fatal: input.options.missing === "error" ? [message] : []
+		};
+	}
+	const hrefToPage = ctx.ref === "href" && PAGE_EXTS.has(path$1.extname(resolved.absolute).toLowerCase());
+	if (!stat.isFile() || hrefToPage) return {
+		files: [],
+		errors: [],
+		fatal: []
+	};
+	const transformError = validateTransform(parsed.transform, input.options);
+	if (transformError) {
+		const message = `[ox-content] ${transformError} for ${JSON.stringify(ctx.src)} on ${input.inputPath}`;
+		return {
+			files: [],
+			errors: [message],
+			fatal: [message]
+		};
+	}
+	const hasTransform = hasPixelOrFormatTransform(parsed.transform);
+	const outputName = hasTransform ? transformedFileName(parsed.pathname, parsed.transform, resourceCacheKey(resolved.absolute, stat.mtimeMs, parsed.transform)) : decodedBasename(parsed.pathname) || path$1.basename(resolved.absolute);
+	const outputFile = path$1.join(ctx.outputDir, outputName);
+	try {
+		const materialized = hasTransform ? await ensureTransformedCache({
+			sourcePath: resolved.absolute,
+			outputFile,
+			cacheDir: input.cacheDir,
+			mtimeMs: stat.mtimeMs,
+			transform: parsed.transform
+		}) : resolved.absolute;
+		if (ctx.store && input.outDir) return await emitDedupedResource({
+			store: ctx.store,
+			materialized,
+			outputFile,
+			src: ctx.src,
+			sourcePath: resolved.absolute,
+			mtimeMs: stat.mtimeMs,
+			transform: parsed.transform,
+			hasTransform,
+			outDir: input.outDir,
+			base: input.base ?? "/"
+		});
+		if (hasTransform) {
+			await fs$2.mkdir(ctx.outputDir, { recursive: true });
+			await fs$2.copyFile(materialized, outputFile);
+		} else {
+			await fs$2.mkdir(ctx.outputDir, { recursive: true });
+			await fs$2.copyFile(resolved.absolute, outputFile);
+		}
+		return {
+			files: [outputFile],
+			errors: [],
+			fatal: [],
+			rewrite: outputName
+		};
+	} catch (error) {
+		const detail = error instanceof Error ? error.message : String(error);
+		const message = `[ox-content] failed to process page resource ${JSON.stringify(ctx.src)} on ${input.inputPath}: ${detail}`;
+		return {
+			files: [],
+			errors: [message],
+			fatal: [message]
+		};
+	}
+}
+async function emitDedupedResource(input) {
+	const ext = normalizeDedupeExt(path$1.extname(input.outputFile));
+	const reuseKey = input.hasTransform ? resourceCacheKey(input.sourcePath, input.mtimeMs, input.transform) : `${input.sourcePath}\0${input.mtimeMs}\0copy`;
+	const digest = await hashResourceFile(input.materialized, ext, input.store, reuseKey);
+	const { asset, wrote } = await emitCanonicalResource(input.store, {
+		digest,
+		ext,
+		sourcePath: input.materialized,
+		outDir: input.outDir,
+		base: input.base
+	});
+	await linkOrCopyAlias(asset.absolutePath, input.outputFile);
+	return {
+		files: wrote ? [asset.absolutePath, input.outputFile] : [input.outputFile],
+		errors: [],
+		fatal: [],
+		rewrite: rewriteToCanonicalUrl(input.src, asset.publicPath)
+	};
+}
+function resolveBundlePath(pathname, bundleRoot, contentRoot) {
+	let decoded;
+	try {
+		decoded = decodeURIComponent(pathname);
+	} catch {
+		decoded = pathname;
+	}
+	if (path$1.isAbsolute(decoded) || decoded.includes("\0")) return { ok: false };
+	const absolute = path$1.resolve(bundleRoot, decoded);
+	if (!isInsideRoot$1(bundleRoot, absolute) || !isInsideRoot$1(contentRoot, absolute)) return { ok: false };
+	return {
+		ok: true,
+		absolute
+	};
+}
+function validateTransform(transform, options) {
+	if (transform.width && options.widths.length > 0 && !options.widths.includes(transform.width)) return `width ${transform.width} is not in resources.widths`;
+	if (transform.format && !options.formats.includes(transform.format)) return `format ${transform.format} is not in resources.formats`;
+}
+function hasPixelOrFormatTransform(transform) {
+	return Boolean(transform.width || transform.height || transform.crop || transform.format);
+}
+function transformedFileName(pathname, transform, cacheKey) {
+	const stem = path$1.basename(pathname).replace(/\.[^.]+$/, "") || "resource";
+	const ext = outputExtension(pathname, transform.format);
+	return `${stem}.${cacheKey.slice(0, 12)}.${ext}`;
+}
+function outputExtension(pathname, format) {
+	if (format === "jpeg") return "jpg";
+	if (format) return format;
+	const ext = path$1.extname(pathname).slice(1).toLowerCase();
+	return ext === "jpeg" ? "jpg" : ext || "png";
+}
+function decodedBasename(pathname) {
+	try {
+		return path$1.basename(decodeURIComponent(pathname));
+	} catch {
+		return path$1.basename(pathname);
+	}
 }
 //#endregion
 //#region src/resources.ts
@@ -8991,19 +10556,22 @@ function resolveResourcesOptions(value) {
 		enabled: false,
 		formats: [...DEFAULT_FORMATS],
 		widths: [],
-		missing: "error"
+		missing: "error",
+		dedupe: false
 	};
 	if (value === true) return {
 		enabled: true,
 		formats: [...DEFAULT_FORMATS],
 		widths: [],
-		missing: "error"
+		missing: "error",
+		dedupe: false
 	};
 	return {
 		enabled: true,
 		formats: normalizeFormats(value.formats),
 		widths: normalizeWidths(value.widths),
-		missing: value.missing === "warn" ? "warn" : "error"
+		missing: value.missing === "warn" ? "warn" : "error",
+		dedupe: value.dedupe === true
 	};
 }
 /**
@@ -9249,10 +10817,12 @@ function resolveSsgOptions(ssg) {
 		pagination: false,
 		breadcrumbs: false,
 		jsonLd: false,
+		headValidation: false,
 		readerChrome: false,
 		localeSwitcher: false,
 		a11y: false,
 		pageChrome: false,
+		markdownSource: resolveMarkdownSourceOptions(void 0),
 		notFound: resolveNotFoundOptions(void 0),
 		team: resolveTeamOptions(void 0),
 		blog: resolveBlogOptions(void 0),
@@ -9269,10 +10839,12 @@ function resolveSsgOptions(ssg) {
 		pagination: false,
 		breadcrumbs: false,
 		jsonLd: false,
+		headValidation: false,
 		readerChrome: false,
 		localeSwitcher: false,
 		a11y: false,
 		pageChrome: false,
+		markdownSource: resolveMarkdownSourceOptions(void 0),
 		notFound: resolveNotFoundOptions(void 0),
 		team: resolveTeamOptions(void 0),
 		blog: resolveBlogOptions(void 0),
@@ -9297,10 +10869,12 @@ function resolveSsgOptions(ssg) {
 		pagination: resolvePaginationOption(ssg.pagination),
 		breadcrumbs: resolvePaginationOption(ssg.breadcrumbs),
 		jsonLd: resolveJsonLdOption(ssg.jsonLd),
+		headValidation: resolveHeadValidation(ssg.headValidation),
 		readerChrome: resolveReaderChromeOption(ssg.readerChrome),
 		localeSwitcher: resolveLocaleSwitcherOption(ssg.localeSwitcher),
 		a11y: resolveA11yOption(ssg.a11y),
 		pageChrome: resolvePageChromeOption(ssg.pageChrome),
+		markdownSource: resolveMarkdownSourceOptions(ssg.markdownSource),
 		notFound: resolveNotFoundOptions(ssg.notFound),
 		team: resolveTeamOptions(ssg.team),
 		blog: resolveBlogOptions(ssg.blog),
@@ -9328,7 +10902,9 @@ function resolveJsonLdOption(value) {
 		const publisher = resolveJsonLdPublisher(value.publisher);
 		return {
 			breadcrumbs: value.breadcrumbs !== false,
-			...publisher ? { publisher } : {}
+			...publisher ? { publisher } : {},
+			...value.type ? { type: value.type } : {},
+			...value.graph ? { graph: value.graph } : {}
 		};
 	}
 	return false;
@@ -9471,7 +11047,7 @@ function localeCodesFor(locales) {
 async function generateHtmlPage(pageData, navGroups, siteName, base, ogImage, theme, locale, availableLocales, pagination = false, readerChrome = false, breadcrumbs = false, localeSwitcher = false, localePaths, a11y = false, team = {
 	enabled: false,
 	members: []
-}, pageChrome = false, breadcrumbRootHref, jsonLd = false, siteUrl) {
+}, pageChrome = false, breadcrumbRootHref, jsonLd = false, siteUrl, headValidation = false, defaultLocale) {
 	const mod = await importNapiModule();
 	const tocForRust = pageData.toc.map(toRustTocEntry);
 	const navGroupsForRust = convertNavGroupsForRust(navGroups);
@@ -9507,7 +11083,7 @@ async function generateHtmlPage(pageData, navGroups, siteName, base, ogImage, th
 			linkText: f.linkText
 		}))
 	} : void 0;
-	return mod.generateSsgHtml({
+	const result = mod.generateSsgHtml({
 		title: pageData.title,
 		description: pageData.description,
 		content: pageData.content,
@@ -9520,12 +11096,16 @@ async function generateHtmlPage(pageData, navGroups, siteName, base, ogImage, th
 		next: pageData.next,
 		breadcrumbs: pageData.breadcrumbs,
 		layout: typeof pageData.frontmatter.layout === "string" ? pageData.frontmatter.layout : void 0,
-		chrome: pageData.chrome
+		chrome: pageData.chrome,
+		robots: typeof pageData.frontmatter.robots === "string" ? pageData.frontmatter.robots : void 0,
+		canonical: typeof pageData.frontmatter.canonical === "string" ? pageData.frontmatter.canonical : void 0
 	}, navGroupsForRust, {
 		siteName,
 		base,
 		breadcrumbRootHref,
 		ogImage,
+		siteUrl,
+		headValidation: headValidation || void 0,
 		theme: themeForRust,
 		locale,
 		availableLocales: availableLocales ? toRustLocales(availableLocales) : void 0,
@@ -9544,9 +11124,18 @@ async function generateHtmlPage(pageData, navGroups, siteName, base, ogImage, th
 		jsonLd: jsonLd ? {
 			breadcrumbs: jsonLd.breadcrumbs,
 			publisher: jsonLd.publisher,
-			siteUrl
+			siteUrl,
+			pageType: jsonLd.type,
+			graph: jsonLd.graph?.map((node) => JSON.stringify(node))
 		} : void 0
 	});
+	const html = typeof result === "string" ? result : result.html;
+	reportHeadDiagnostics(typeof result === "string" ? [] : result.diagnostics ?? [], headValidation);
+	return injectSearchLocaleFilters(html, {
+		locales: availableLocales ?? [],
+		current: locale,
+		defaultLocale: defaultLocale ?? availableLocales?.[0]?.code ?? "en"
+	});
 }
 async function externalizeSharedPageAssets(pages, outDir, base) {
 	const optimized = (await importNapiModule()).externalizeSsgAssets(pages, outDir, base);
@@ -9631,6 +11220,7 @@ async function buildSsg(options, root) {
 	applyPermalinkRoutes(context, collected);
 	errors.push(...collected.errors);
 	const { outputPages, listedPages } = applyPublishState(context, collected);
+	context.markdownSourcePages.push(...outputPages);
 	remapPermalinkNav(context, listedPages);
 	await applyPageResources(context, outputPages, generatedFiles, errors);
 	await generateOgImageAssets(context, collected, generatedFiles, errors);
@@ -9708,7 +11298,8 @@ async function createBuildSsgContext(options, root, srcDir, outDir, markdownFile
 		navItems: resolveNavigationGroups(ssgOptions.navigation, base, ssgOptions.extension) ?? (ssgOptions.theme?.sidebar.length ? buildThemeNavItems(ssgOptions.theme.sidebar, base, ssgOptions.extension) : buildNavItems(markdownFiles, srcDir, base, ssgOptions.extension)),
 		siteName: await resolveSiteName$1(root, ssgOptions),
 		shouldGenerateOgImages: shouldGenerateOgImages(options),
-		napi: ssgOptions.lastUpdated || ssgOptions.contributors ? await importNapiModule() : void 0
+		markdownSourcePages: [],
+		napi: ssgOptions.lastUpdated || ssgOptions.contributors || options.siteMaps?.enabled ? await importNapiModule() : void 0
 	};
 }
 /**
@@ -9738,6 +11329,7 @@ async function applyPageResources(context, pages, generatedFiles, errors) {
 	if (!options?.enabled) return;
 	const cacheDir = path$2.join(context.root, ".cache", "ox-content-resources");
 	const fatal = [];
+	const dedupeStore = options.dedupe ? createResourceDedupeStore() : void 0;
 	for (const page of pages) {
 		const processed = await processPageResources({
 			html: page.transformedHtml,
@@ -9745,7 +11337,10 @@ async function applyPageResources(context, pages, generatedFiles, errors) {
 			outputPath: page.routePaths.outputPath,
 			srcDir: context.srcDir,
 			options,
-			cacheDir
+			cacheDir,
+			outDir: context.outDir,
+			base: context.base,
+			dedupeStore
 		});
 		page.transformedHtml = processed.html;
 		generatedFiles.push(...processed.files);
@@ -9819,7 +11414,8 @@ function applyPublishState(context, collected) {
 	};
 }
 async function transformSsgPage(context, inputPath) {
-	const result = await transformMarkdown(await fs$3.readFile(inputPath, "utf-8"), inputPath, context.options, {
+	const content = await fs$3.readFile(inputPath, "utf-8");
+	const result = await transformMarkdown(content, inputPath, context.options, {
 		convertMdLinks: true,
 		baseUrl: context.base,
 		sourcePath: inputPath
@@ -9829,11 +11425,12 @@ async function transformSsgPage(context, inputPath) {
 	const title = extractTitle$1(transformedHtml, frontmatter);
 	return {
 		inputPath,
+		source: content,
 		routePaths: getRoutePaths(inputPath, context.srcDir, context.outDir, context.base, context.ssgOptions.extension, context.ssgOptions.siteUrl),
 		transformedHtml,
 		title,
 		description: frontmatter.description,
-		lastUpdated: context.ssgOptions.lastUpdated ? context.napi?.getGitLastUpdated(inputPath, context.root) ?? void 0 : void 0,
+		lastUpdated: context.ssgOptions.lastUpdated || context.options.siteMaps?.enabled ? context.napi?.getGitLastUpdated(inputPath, context.root) ?? void 0 : void 0,
 		contributors: contributorsForPage(context, inputPath),
 		frontmatter,
 		toc: result.toc
@@ -9924,17 +11521,18 @@ async function generateHtmlPages(context, pageResults, collected, errors) {
 async function renderSsgPage(context, pageResult, collected, allPageResults) {
 	const { ogImageUrlMap } = collected;
 	const pageOgImage = context.shouldGenerateOgImages && ogImageUrlMap.has(pageResult.inputPath) ? ogImageUrlMap.get(pageResult.inputPath) : context.ssgOptions.ogImage;
+	const markdownSource = pageMarkdownSourceHref(context, pageResult);
 	if (context.ssgOptions.render) {
 		const nav = context.versionNavigation ? rewriteVersionedNavGroups(context.navItems, context.versionNavigation) : context.navItems;
-		return renderPage(toThemePageData(pageResult), {
+		return applyMarkdownSourceAlternate(context, renderPage(toThemePageData(pageResult, markdownSource), {
 			theme: context.ssgOptions.render,
 			siteName: context.siteName,
 			base: context.base,
 			nav,
-			pages: allPageResults.map(toThemePageData)
-		});
+			pages: allPageResults.map((page) => toThemePageData(page, pageMarkdownSourceHref(context, page)))
+		}), markdownSource);
 	}
-	if (context.ssgOptions.bare) return generateBarePage({
+	if (context.ssgOptions.bare) return applyMarkdownSourceAlternate(context, generateBarePage({
 		title: pageResult.title,
 		content: pageResult.transformedHtml,
 		lang: context.ssgOptions.lang ?? getPageLocale(pageResult.routePaths.urlPath, context.options.i18n),
@@ -9945,7 +11543,7 @@ async function renderSsgPage(context, pageResult, collected, allPageResults) {
 		head: context.ssgOptions.head,
 		bodyStart: context.ssgOptions.bodyStart,
 		bodyEnd: context.ssgOptions.bodyEnd
-	});
+	}), markdownSource);
 	const pageData = createSsgPageData(pageResult);
 	const versionNavigation = context.versionNavigation;
 	if (versionNavigation) {
@@ -9986,10 +11584,18 @@ async function renderSsgPage(context, pageResult, collected, allPageResults) {
 		base: context.base,
 		roots: versionNavigation ? versionedLocaleRoots(versionNavigation, i18n.locales, i18n.defaultLocale, i18n.hideDefaultLocale) : void 0
 	}) : void 0;
-	return generateHtmlPage(pageData, navItems, context.siteName, context.base, pageOgImage, theme, locale, i18n ? i18n.locales : void 0, context.ssgOptions.pagination, context.ssgOptions.readerChrome, context.ssgOptions.breadcrumbs, context.ssgOptions.localeSwitcher, localePaths, context.ssgOptions.a11y, context.ssgOptions.team ?? {
+	return applyMarkdownSourceAlternate(context, await generateHtmlPage(pageData, navItems, context.siteName, context.base, pageOgImage, theme, locale, i18n ? i18n.locales : void 0, context.ssgOptions.pagination, context.ssgOptions.readerChrome, context.ssgOptions.breadcrumbs, context.ssgOptions.localeSwitcher, localePaths, context.ssgOptions.a11y, context.ssgOptions.team ?? {
 		enabled: false,
 		members: []
-	}, context.ssgOptions.pageChrome, versionNavigation?.root.href, context.ssgOptions.jsonLd, context.ssgOptions.siteUrl);
+	}, context.ssgOptions.pageChrome, versionNavigation?.root.href, context.ssgOptions.jsonLd, context.ssgOptions.siteUrl, context.ssgOptions.headValidation, i18n?.defaultLocale), markdownSource);
+}
+function pageMarkdownSourceHref(context, page) {
+	if (!context.ssgOptions.markdownSource?.enabled || !shouldPublishMarkdownSource(page.frontmatter, context.options.publishState)) return;
+	return markdownSourceHref(page.routePaths.urlPath, context.base);
+}
+function applyMarkdownSourceAlternate(context, html, href) {
+	if (!href || !context.ssgOptions.markdownSource?.alternate) return html;
+	return injectMarkdownSourceAlternate(html, href);
 }
 function rewritePagerOverride(pager, context) {
 	return pager?.href ? {
@@ -9998,7 +11604,7 @@ function rewritePagerOverride(pager, context) {
 	} : pager;
 }
 /** Maps an internal page result onto the theme renderer's page shape. */
-function toThemePageData(pageResult) {
+function toThemePageData(pageResult, markdownSource) {
 	return {
 		title: pageResult.title,
 		description: pageResult.description,
@@ -10008,6 +11614,7 @@ function toThemePageData(pageResult) {
 		contributors: pageResult.contributors,
 		path: pageResult.inputPath,
 		url: pageResult.routePaths.href,
+		markdownSource,
 		frontmatter: pageResult.frontmatter,
 		layout: typeof pageResult.frontmatter.layout === "string" ? pageResult.frontmatter.layout : void 0
 	};
@@ -10120,6 +11727,7 @@ async function applyDocumentationVersions(generatedPages, context, errors) {
 			...page.routePaths,
 			...prefixRoutePaths(page.routePaths, entry.prefix, context.outDir, context.base)
 		};
+		context.markdownSourcePages.push(...outputPages);
 		snapContext.versionNavigation = createVersionNavigationContext({
 			prefix: entry.prefix,
 			base: context.base,
@@ -10232,6 +11840,20 @@ async function writeGeneratedPages(generatedPages, context, generatedFiles, list
 		errors.push(feeds.warning);
 		console.warn(feeds.warning);
 	}
+	const markdownSource = await writeMarkdownSourceFiles({
+		outDir: context.outDir,
+		base: context.base,
+		options: context.ssgOptions.markdownSource,
+		publishState: context.options.publishState,
+		pages: context.markdownSourcePages.map((page) => ({
+			inputPath: page.inputPath,
+			source: page.source,
+			urlPath: page.routePaths.urlPath,
+			frontmatter: page.frontmatter
+		}))
+	});
+	generatedFiles.push(...markdownSource.files);
+	errors.push(...markdownSource.errors);
 }
 /** Turns an SSG `urlPath` (`guide` or `/`) into a same-origin dest (`/guide`). */
 function sitePathFromUrlPath(urlPath) {
@@ -10245,6 +11867,7 @@ function sitemapPages(context, listedPages, outputPages) {
 		loc: canonicalPageUrl(context, page.routePaths.urlPath) ?? "",
 		title: page.title,
 		description: page.description,
+		lastUpdated: page.lastUpdated,
 		draft: page.frontmatter.draft === true,
 		unlisted: Boolean(context.options.publishState?.enabled) && !listedPaths.has(page.inputPath)
 	}));
@@ -10342,7 +11965,8 @@ function createDevServerCache() {
 		navGroups: null,
 		localePages: null,
 		pages: /* @__PURE__ */ new Map(),
-		siteName: null
+		siteName: null,
+		markdownSourceIndex: null
 	};
 }
 /**
@@ -10351,6 +11975,7 @@ function createDevServerCache() {
 function invalidateNavCache(cache) {
 	cache.navGroups = null;
 	cache.localePages = null;
+	cache.markdownSourceIndex = null;
 	cache.pages.clear();
 }
 /**
@@ -10358,6 +11983,7 @@ function invalidateNavCache(cache) {
 */
 function invalidatePageCache(cache, filePath) {
 	cache.pages.delete(filePath);
+	cache.markdownSourceIndex = null;
 }
 /**
 * Resolve site name from options or package.json.
@@ -10447,13 +12073,35 @@ async function renderPage$1(filePath, options, navGroups, siteName, base, root,
 		pages: localePages,
 		base
 	}) : void 0;
+	const markdownSource = options.ssg.markdownSource?.enabled ? markdownSourceHrefForPage({
+		source: filePath,
+		fileUrl: pageData.path,
+		frontmatter,
+		base,
+		permalinks: options.permalinks,
+		cascade: options.cascade,
+		publishState: options.publishState
+	}) : void 0;
 	let html = await generateHtmlPage(pageData, localizedNav, siteName, base, options.ssg.ogImage, theme, locale, i18n ? i18n.locales : void 0, options.ssg.pagination, options.ssg.readerChrome, options.ssg.breadcrumbs, options.ssg.localeSwitcher, localePaths, options.ssg.a11y, options.ssg.team ?? {
 		enabled: false,
 		members: []
-	}, options.ssg.pageChrome, void 0, options.ssg.jsonLd, options.ssg.siteUrl);
+	}, options.ssg.pageChrome, void 0, options.ssg.jsonLd, options.ssg.siteUrl, options.ssg.headValidation, i18n?.defaultLocale);
+	if (markdownSource && options.ssg.markdownSource?.alternate) html = injectMarkdownSourceAlternate(html, markdownSource);
 	html = injectViteHmrClient(html);
 	return html;
 }
+async function serveMarkdownSource(routeUrl, options, srcDir, cache) {
+	if (!cache.markdownSourceIndex) cache.markdownSourceIndex = await buildMarkdownSourceIndex({
+		files: await collectMarkdownFiles(srcDir, options.extensions),
+		srcDir,
+		permalinks: options.permalinks,
+		cascade: options.cascade,
+		publishState: options.publishState
+	});
+	const entry = resolveMarkdownSourceRequest(routeUrl, cache.markdownSourceIndex);
+	if (!entry) return "missing";
+	return entry.allowed ? entry.source : "hidden";
+}
 /**
 * Create the dev server middleware for SSG page serving.
 */
@@ -10466,6 +12114,19 @@ function createDevServerMiddleware(options, root, cache) {
 		let routeUrl = url;
 		if (base !== "/" && routeUrl.startsWith(base)) routeUrl = "/" + routeUrl.slice(base.length);
 		if (shouldSkip(routeUrl)) return next();
+		if (options.ssg.markdownSource?.enabled && isMarkdownSourceRequest(routeUrl)) {
+			const served = await serveMarkdownSource(routeUrl, options, srcDir, cache);
+			if (served === "missing") return next();
+			if (served === "hidden") {
+				res.statusCode = 404;
+				res.end();
+				return;
+			}
+			res.setHeader("Content-Type", "text/markdown; charset=utf-8");
+			res.setHeader("Cache-Control", "no-cache");
+			res.end(served);
+			return;
+		}
 		const filePath = await resolveMarkdownFile(routeUrl, srcDir, options.extensions);
 		if (!filePath) return next();
 		try {
@@ -10982,6 +12643,43 @@ function resolveCardOptions(options) {
 	return { enabled: options.enabled ?? true };
 }
 //#endregion
+//#region src/heading-permalinks-options.ts
+function resolveHeadingPermalinksOptions(options) {
+	if (!options) return { enabled: false };
+	if (options === true) return { enabled: true };
+	return { enabled: options.enabled ?? true };
+}
+//#endregion
+//#region src/magic-link-options.ts
+function resolveMagicLinkOptions(options) {
+	if (!options) return {
+		enabled: false,
+		aliases: {},
+		favicon: false,
+		imageOverrides: []
+	};
+	if (options === true) return {
+		enabled: true,
+		aliases: {},
+		favicon: false,
+		imageOverrides: []
+	};
+	const favicon = options.favicon === true || typeof options.favicon === "object" && options.favicon != null;
+	const faviconTemplate = typeof options.favicon === "object" ? options.favicon.template : void 0;
+	return {
+		enabled: options.enabled ?? true,
+		aliases: normalizeAliases(options.aliases),
+		favicon,
+		faviconTemplate,
+		imageOverrides: options.imageOverrides ?? []
+	};
+}
+function normalizeAliases(aliases) {
+	const normalized = {};
+	for (const [key, value] of Object.entries(aliases ?? {})) normalized[key] = typeof value === "string" ? { href: value } : value;
+	return normalized;
+}
+//#endregion
 //#region src/include-options.ts
 function resolveIncludeOptions(options) {
 	if (!options) return { enabled: false };
@@ -11556,6 +13254,12 @@ function createFrameworkMarkdownOptions(options) {
 		},
 		attrs: { enabled: false },
 		badges: { enabled: false },
+		magicLinks: {
+			enabled: false,
+			aliases: {},
+			favicon: false,
+			imageOverrides: []
+		},
 		containers: {
 			enabled: false,
 			types: {}
@@ -12555,7 +14259,7 @@ function createSsgPlugin(resolvedOptions, getRoot, ssgDevCache) {
 				for (const error of result.errors) console.warn(`[ox-content] ${error}`);
 			} catch (err) {
 				console.error("[ox-content] SSG build failed:", err);
-				if (err instanceof PageResourceError) throw err;
+				if (err instanceof PageResourceError || err instanceof BlogFeedError) throw err;
 			}
 		}
 	};
@@ -12670,6 +14374,7 @@ function resolveOptions(options) {
 		gfm: options.gfm ?? true,
 		mdx: options.mdx,
 		footnotes: options.footnotes ?? true,
+		semanticFootnotes: options.semanticFootnotes ?? false,
 		tables: options.tables ?? true,
 		taskLists: options.taskLists ?? true,
 		strikethrough: options.strikethrough ?? true,
@@ -12680,6 +14385,7 @@ function resolveOptions(options) {
 		emojiShortcodes: resolveEmojiShortcodeOptions(options.emojiShortcodes),
 		attrs: resolveAttrsOptions(options.attrs),
 		badges: resolveBadgeOptions(options.badges),
+		magicLinks: resolveMagicLinkOptions(options.magicLinks),
 		containers: resolveContainerOptions(options.containers),
 		images: resolveImageOptions(options.images),
 		codeImports: resolveCodeImportOptions(options.codeImports),
@@ -12699,6 +14405,7 @@ function resolveOptions(options) {
 		frontmatter: options.frontmatter ?? true,
 		toc: options.toc ?? true,
 		tocMaxDepth: options.tocMaxDepth ?? 3,
+		headingPermalinks: resolveHeadingPermalinksOptions(options.headingPermalinks),
 		ogImage: options.ogImage ?? false,
 		ogImageOptions: resolveOgImageOptions(options.ogImageOptions),
 		transformers: options.transformers ?? [],
@@ -12989,6 +14696,6 @@ function normalizeRuntimeBase(base) {
 	return withLeading.endsWith("/") ? withLeading : `${withLeading}/`;
 }
 //#endregion
-export { DEFAULT_HTML_TEMPLATE, DEFAULT_MARKDOWN_EXTENSIONS, DefaultTheme, DocsTestRunError, Fragment, IncrementalMarkdownParser, IncrementalMarkdownRenderer, PageResourceError, applyIslandSsrHtml, buildCollectionManifest, buildSearchIndex, buildSsg, classifyPublishState, clearRenderContext, collectDocsTests, collectGitHubRepos, collectGitHubSources, collectMdxIslandNamesFromHtml, collectMdxJsxNamesFromAst, collectOgpUrls, convertVitePressNav, convertVitePressSidebar, createFrameworkMarkdownOptions, createI18nPlugin, createIncrementalMarkdownParser, createIncrementalMarkdownRenderer, createMarkdownEnvironment, createTheme, defaultTheme, defineCollection, defineCollections, defineTheme, discoverDocumentMdxIslands, discoverRegisteredMdxComponents, each, escapeSvelteMarkup, extractCodeBlocks, extractDocs, extractDocsTests, extractIslandInfo, extractVideoId, fetchGitHubSource, fetchOgpData, fetchRepoData, fromVitePressConfig, generateCollectionsVirtualModule, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, generateTabsCSS, generateTypes, generateVirtualModule, generateVitePressMigrationConfig, hasIslands, inferType, intersectHydratableComponentNames, intersectRegisteredComponentNames, isMarkdownFilePath, isMdxFilePath, isRegisteredComponent, jsx, jsxs, lintCodeBlocks, lintMarkdown, lintMarkdownAsync, lintMarkdownFile, lintMarkdownFiles, mergeThemes, mermaidClientScript, normalizeMarkdownExtensions, normalizeVitePressFrontmatter, oxContent, parseGitHubLineRange, parseGitHubPermalink, parsePageChromeFlags, partitionPublishedPages, prefetchGitHubRepos, prefetchGitHubSources, prefetchOgpData, raw, readingTimeMinutes, renderAllPages, renderHtmlToFrameworkCode, renderHtmlToReactComponent, renderHtmlToReactCreateElement, renderHtmlToSvelteComponent, renderHtmlToVueComponent, renderHtmlToVueH, renderIslandComponentImports, renderMarkdownStream, renderPage, renderToString, resolveBadgeOptions, resolveBlogCollectionName, resolveBlogOptions, resolveBuiltinEmbedOptions, resolveCardOptions, resolveCascadeOptions, resolveCollectionsOptions, resolveContentRootPath, resolveDocsOptions, resolveDocumentComponentImports, resolveFeedsOptions, resolveFileTreeOptions, resolveHeaderNavItems, resolveI18nOptions, resolveImageOptions, resolveIncludeOptions, resolveLocaleLabel, resolveMathOptions, resolveMdxForFilePath, resolveNotFoundOptions, resolveOgImageOptions, resolvePageChromeOption, resolvePermalinksOptions, resolvePublishStateOptions, resolvePwaOptions, resolveRedirectsOptions, resolveResourcesOptions, resolveSearchOptions, resolveSectionIndexOptions, resolveSiteMapsOptions, resolveSsgOptions, resolveStepsOptions, resolveTaxonomiesOptions, resolveTeamOptions, resolveTheme, resolveTypedHoverOptions, resolveVersionsOptions, runDocsTests, setRenderContext, shouldLintMarkdownFile, stripMarkdownExtension, stripViteQuery, transformAllPlugins, transformGitHub, transformIslands, transformMarkdown, transformMermaidStatic, transformOgp, transformTabs, transformYouTube, typecheckCodeBlocks, useIsActive, useNav, usePageProps, useRenderContext, useSiteConfig, when, writeDocs, writeDocsTestFiles, writeSearchIndex };
+export { BlogFeedError, DEFAULT_HTML_TEMPLATE, DEFAULT_MARKDOWN_EXTENSIONS, DefaultTheme, DocsTestRunError, Fragment, IncrementalMarkdownParser, IncrementalMarkdownRenderer, PageResourceError, applyIslandSsrHtml, buildCollectionManifest, buildSearchIndex, buildSsg, classifyPublishState, clearRenderContext, collectDocsTests, collectGitHubRepos, collectGitHubSources, collectMdxIslandNamesFromHtml, collectMdxJsxNamesFromAst, collectOgpUrls, convertVitePressNav, convertVitePressSidebar, createFrameworkMarkdownOptions, createI18nPlugin, createIncrementalMarkdownParser, createIncrementalMarkdownRenderer, createMarkdownEnvironment, createTheme, defaultTheme, defineCollection, defineCollections, defineTheme, discoverDocumentMdxIslands, discoverRegisteredMdxComponents, each, escapeSvelteMarkup, extractCodeBlocks, extractDocs, extractDocsTests, extractIslandInfo, extractVideoId, fetchGitHubSource, fetchOgpData, fetchRepoData, fromVitePressConfig, generateCollectionsVirtualModule, generateFrontmatterTypes, generateHydrationScript, generateMarkdown, generateOgImages, generateTabsCSS, generateTypes, generateVirtualModule, generateVitePressMigrationConfig, hasIslands, inferType, intersectHydratableComponentNames, intersectRegisteredComponentNames, isMarkdownFilePath, isMdxFilePath, isRegisteredComponent, jsx, jsxs, lintCodeBlocks, lintMarkdown, lintMarkdownAsync, lintMarkdownFile, lintMarkdownFiles, mergeThemes, mermaidClientScript, normalizeMarkdownExtensions, normalizeVitePressFrontmatter, oxContent, parseGitHubLineRange, parseGitHubPermalink, parsePageChromeFlags, partitionPublishedPages, prefetchGitHubRepos, prefetchGitHubSources, prefetchOgpData, raw, readingTimeMinutes, renderAllPages, renderHead, renderHtmlToFrameworkCode, renderHtmlToReactComponent, renderHtmlToReactCreateElement, renderHtmlToSvelteComponent, renderHtmlToVueComponent, renderHtmlToVueH, renderIslandComponentImports, renderMarkdownStream, renderPage, renderToString, resolveBadgeOptions, resolveBlogCollectionName, resolveBlogOptions, resolveBuiltinEmbedOptions, resolveCardOptions, resolveCascadeOptions, resolveCollectionsOptions, resolveContentRootPath, resolveDocsOptions, resolveDocumentComponentImports, resolveFeedsOptions, resolveFileTreeOptions, resolveHeadValidation, resolveHeaderNavItems, resolveHeadingPermalinksOptions, resolveI18nOptions, resolveImageOptions, resolveIncludeOptions, resolveLocaleLabel, resolveMarkdownSourceOptions, resolveMathOptions, resolveMdxForFilePath, resolveNotFoundOptions, resolveOgImageOptions, resolvePageChromeOption, resolvePermalinksOptions, resolvePublishStateOptions, resolvePwaOptions, resolveRedirectsOptions, resolveResourcesOptions, resolveSearchOptions, resolveSectionIndexOptions, resolveSiteMapsOptions, resolveSsgOptions, resolveStepsOptions, resolveTaxonomiesOptions, resolveTeamOptions, resolveTheme, resolveTypedHoverOptions, resolveVersionsOptions, runDocsTests, setRenderContext, shouldLintMarkdownFile, stripMarkdownExtension, stripViteQuery, transformAllPlugins, transformGitHub, transformIslands, transformMarkdown, transformMermaidStatic, transformOgp, transformTabs, transformYouTube, typecheckCodeBlocks, useIsActive, useNav, usePageProps, useRenderContext, useSiteConfig, when, writeDocs, writeDocsTestFiles, writeSearchIndex };
 
 //# sourceMappingURL=index.mjs.map