@rimelight/seo 0.0.4 → 0.0.6

package/dist/index.d.mts

@@ -1,40 +1,10 @@
-import { _ as ArticleSchemaOptions, a as RSSFeed, b as buildBreadcrumbSchema, c as SiteConfig, d as UserAgentRule, f as LlmsFullTxtOptions, g as buildLlmsTxt, h as buildLlmsFullTxt, i as OGImage, l as SitemapAlternate, m as LlmsTxtOptions, n as HeadProps, o as RobotsOptions, p as LlmsPage, r as LocaleConfig, s as SeoEntry, t as ChangeFreq, u as SitemapUrl, v as BreadcrumbItem, y as buildArticleSchema } from "./types-e7gqYZwc.mjs";
+import { i as buildBreadcrumbSchema, n as BreadcrumbItem, r as buildArticleSchema, t as ArticleSchemaOptions } from "./schema-C8v69blQ.mjs";
+import { a as buildLlmsTxt, i as buildLlmsFullTxt, n as LlmsPage, r as LlmsTxtOptions, t as LlmsFullTxtOptions } from "./llms-BVLxzjr-.mjs";
+import { ChangeFreq, HeadProps, LlmsFullRouteOptions, LlmsRouteOptions, LocaleConfig, OGImage, OpenGraphMeta, RSSFeed, RimelightSeoOptions, RobotsOptions, RobotsRouteOptions, RssFeedOptions, RssItem, RssOptions, SeoEntry, SiteConfig, SitemapAlternate, SitemapOptions, SitemapUrl, TwitterMeta, UserAgentRule } from "./types.mjs";
 import { buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, chunkSitemapUrls } from "./sitemap.mjs";
 import { buildRobotsTxt } from "./robots.mjs";
-//#region src/meta.d.ts
-/**
- * Build a canonical URL from a page URL and site base. - Strips trailing slash unless the path has
- * query params (where trailing slash is removed too). - Returns undefined-safe: pass Astro.url and
- * Astro.site directly.
- */
-declare function buildCanonicalUrl(url: string | URL, base: string | URL): string;
-/**
- * Build a page title using a site's title template. Falls back to siteName for untitled pages; uses
- * a 404 label for error pages.
- */
-declare function buildPageTitle(opts: {
-  title?: string;
-  siteName: string;
-  titleTemplate: string;
-  is404?: boolean;
-}): string;
-/**
- * Truncate a description to a maximum character length, appending "…" if trimmed.
- */
-declare function buildSafeDescription(description: string, maxLength: number): string;
-/**
- * Build the value for the <meta name="robots"> tag. Returns the full directive string including
- * max-image-preview for indexable pages.
- */
-declare function buildRobotsMetaContent(opts: {
-  noindex?: boolean;
-  is404?: boolean;
-  override?: string;
-}): string;
-/**
- * \n * Build a Schema.org WebSite JSON-LD object.\n * Pass the result to JSON.stringify and emit
- * via <script type="application/ld+json">.\n
- */
-declare function buildWebSiteSchema(config: Pick<SiteConfig, "name" | "url" | "description">, site?: string): Record<string, unknown>;
-//#endregion
-export { type ArticleSchemaOptions, type BreadcrumbItem, type ChangeFreq, type HeadProps, type LlmsFullTxtOptions, type LlmsPage, type LlmsTxtOptions, type LocaleConfig, type OGImage, type RSSFeed, type RobotsOptions, type SeoEntry, type SiteConfig, type SitemapAlternate, type SitemapUrl, type UserAgentRule, buildArticleSchema, buildBreadcrumbSchema, buildCanonicalUrl, buildLlmsFullTxt, buildLlmsTxt, buildPageTitle, buildRobotsMetaContent, buildRobotsTxt, buildSafeDescription, buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, buildWebSiteSchema, chunkSitemapUrls };
+import { buildRssXml, escapeXml } from "./rss.mjs";
+import { buildCanonicalUrl, buildPageTitle, buildRobotsMetaContent, buildSafeDescription, buildWebSiteSchema, deepMerge } from "./meta.mjs";
+import { OgFontConfig, OgLayoutOptions, OgRenderConfig } from "./og.mjs";
+import rimelightSeo from "./integration.mjs";
+export { type ArticleSchemaOptions, type BreadcrumbItem, type ChangeFreq, type HeadProps, type LlmsFullRouteOptions, type LlmsFullTxtOptions, type LlmsPage, type LlmsRouteOptions, type LlmsTxtOptions, type LocaleConfig, type OGImage, type OgFontConfig, type OgLayoutOptions, type OgRenderConfig, type OpenGraphMeta, type RSSFeed, type RimelightSeoOptions, type RobotsOptions, type RobotsRouteOptions, type RssFeedOptions, type RssItem, type RssOptions, type SeoEntry, type SiteConfig, type SitemapAlternate, type SitemapOptions, type SitemapUrl, type TwitterMeta, type UserAgentRule, buildArticleSchema, buildBreadcrumbSchema, buildCanonicalUrl, buildLlmsFullTxt, buildLlmsTxt, buildPageTitle, buildRobotsMetaContent, buildRobotsTxt, buildRssXml, buildSafeDescription, buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, buildWebSiteSchema, chunkSitemapUrls, deepMerge, rimelightSeo as default, rimelightSeo, escapeXml };

package/dist/index.mjs

@@ -1,178 +1,11 @@
 import { buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, chunkSitemapUrls } from "./sitemap.mjs";
 import { buildRobotsTxt } from "./robots.mjs";
-//#region src/meta.ts
-/**
-* Build a canonical URL from a page URL and site base. - Strips trailing slash unless the path has
-* query params (where trailing slash is removed too). - Returns undefined-safe: pass Astro.url and
-* Astro.site directly.
-*/
-function buildCanonicalUrl(url, base) {
-	const path = new URL(url, base).toString();
-	return path.includes("?") ? path.replace(/\/?$/, "") : path.replace(/\/?$/, "/");
-}
-/**
-* Build a page title using a site's title template. Falls back to siteName for untitled pages; uses
-* a 404 label for error pages.
-*/
-function buildPageTitle(opts) {
-	const { title, siteName, titleTemplate, is404 } = opts;
-	if (is404) return `404 - Not Found | ${siteName}`;
-	if (!title) return siteName;
-	return titleTemplate.replace("%s", title);
-}
-/**
-* Truncate a description to a maximum character length, appending "…" if trimmed.
-*/
-function buildSafeDescription(description, maxLength) {
-	if (!description) return description;
-	if (description.length <= maxLength) return description;
-	return description.slice(0, maxLength - 3) + "...";
-}
-/**
-* Build the value for the <meta name="robots"> tag. Returns the full directive string including
-* max-image-preview for indexable pages.
-*/
-function buildRobotsMetaContent(opts) {
-	if (opts.override) return opts.override;
-	return !opts.noindex && !opts.is404 ? "index, follow, max-image-preview:large" : "noindex, nofollow";
-}
-/**
-* \n * Build a Schema.org WebSite JSON-LD object.\n * Pass the result to JSON.stringify and emit
-* via <script type="application/ld+json">.\n
-*/
-function buildWebSiteSchema(config, site) {
-	return {
-		"@context": "https://schema.org",
-		"@type": "WebSite",
-		"name": config.name,
-		"url": site ?? config.url,
-		"description": config.description
-	};
-}
+import { buildRssXml, escapeXml } from "./rss.mjs";
+import { buildCanonicalUrl, buildPageTitle, buildRobotsMetaContent, buildSafeDescription, buildWebSiteSchema, deepMerge } from "./meta.mjs";
+import { buildLlmsFullTxt, buildLlmsTxt } from "./llms.mjs";
+import { buildArticleSchema, buildBreadcrumbSchema } from "./schema.mjs";
+import rimelightSeo from "./integration.mjs";
+//#region src/index.ts
+var src_default = rimelightSeo;
 //#endregion
-//#region src/llms.ts
-/**
-* Builds standard /llms.txt document format for AI discovery.
-*/
-function buildLlmsTxt(options) {
-	const { site, title, description, fullCorpusUrl = `${site.replace(/\/$/, "")}/llms-full.txt`, pages, sections = [] } = options;
-	const lines = [
-		`# ${title}`,
-		"",
-		description || "Documentation index for AI agents.",
-		"",
-		`Full corpus (all pages, one document): ${fullCorpusUrl}`,
-		""
-	];
-	if (sections.length > 0) {
-		lines.push("## Sections", "");
-		for (const sec of sections) lines.push(`- [${sec.label}](${sec.url})`);
-		lines.push("");
-	}
-	lines.push("## Pages", "");
-	const grouped = /* @__PURE__ */ new Map();
-	for (const page of pages) {
-		const sec = page.section || "General";
-		if (!grouped.has(sec)) grouped.set(sec, []);
-		grouped.get(sec).push(page);
-	}
-	if (grouped.size === 1 && grouped.has("General")) for (const page of pages) {
-		const pageUrl = page.markdownUrl || page.url;
-		const desc = page.description ? ` — ${page.description}` : "";
-		lines.push(`- [${page.title}](${pageUrl})${desc}`);
-	}
-	else for (const [secName, secPages] of grouped.entries()) {
-		lines.push(`### ${secName}`, "");
-		for (const page of secPages) {
-			const pageUrl = page.markdownUrl || page.url;
-			const desc = page.description ? ` — ${page.description}` : "";
-			lines.push(`- [${page.title}](${pageUrl})${desc}`);
-		}
-		lines.push("");
-	}
-	lines.push("");
-	return lines.join("\n");
-}
-/**
-* Builds concatenated /llms-full.txt single corpus document for AI agents.
-*/
-function buildLlmsFullTxt(options) {
-	const { title, description, pages } = options;
-	const parts = [
-		`# ${title} — Full Documentation Corpus`,
-		"",
-		description || "Complete documentation corpus for AI agents.",
-		"",
-		"---",
-		""
-	];
-	for (const page of pages) {
-		const metaHeader = [
-			`## ${page.title}`,
-			"",
-			`URL: ${page.url}`,
-			...page.description ? [`Description: ${page.description}`] : [],
-			...page.version ? [`Version: ${page.version}`] : [],
-			"",
-			page.markdown.trim(),
-			"",
-			"---",
-			""
-		];
-		parts.push(...metaHeader);
-	}
-	return parts.join("\n");
-}
-//#endregion
-//#region src/schema.ts
-/**
-* Builds Schema.org Article / TechArticle / BlogPosting JSON-LD.
-*/
-function buildArticleSchema(options) {
-	const { type = "TechArticle", title, description, url, datePublished, dateModified, authorName, authorUrl, image, publisherName = "Rimelight Entertainment", publisherLogo } = options;
-	const schema = {
-		"@context": "https://schema.org",
-		"@type": type,
-		"headline": title,
-		"mainEntityOfPage": {
-			"@type": "WebPage",
-			"@id": url
-		}
-	};
-	if (description) schema["description"] = description;
-	if (image) schema["image"] = image;
-	if (datePublished) schema["datePublished"] = datePublished instanceof Date ? datePublished.toISOString() : datePublished;
-	if (dateModified) schema["dateModified"] = dateModified instanceof Date ? dateModified.toISOString() : dateModified;
-	else if (datePublished) schema["dateModified"] = schema["datePublished"];
-	if (authorName) schema["author"] = {
-		"@type": "Person",
-		"name": authorName,
-		...authorUrl ? { url: authorUrl } : {}
-	};
-	if (publisherName) schema["publisher"] = {
-		"@type": "Organization",
-		"name": publisherName,
-		...publisherLogo ? { logo: {
-			"@type": "ImageObject",
-			"url": publisherLogo
-		} } : {}
-	};
-	return schema;
-}
-/**
-* Builds Schema.org BreadcrumbList JSON-LD.
-*/
-function buildBreadcrumbSchema(items) {
-	return {
-		"@context": "https://schema.org",
-		"@type": "BreadcrumbList",
-		"itemListElement": items.map((item, index) => ({
-			"@type": "ListItem",
-			"position": index + 1,
-			"name": item.name,
-			"item": item.url
-		}))
-	};
-}
-//#endregion
-export { buildArticleSchema, buildBreadcrumbSchema, buildCanonicalUrl, buildLlmsFullTxt, buildLlmsTxt, buildPageTitle, buildRobotsMetaContent, buildRobotsTxt, buildSafeDescription, buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, buildWebSiteSchema, chunkSitemapUrls };
+export { buildArticleSchema, buildBreadcrumbSchema, buildCanonicalUrl, buildLlmsFullTxt, buildLlmsTxt, buildPageTitle, buildRobotsMetaContent, buildRobotsTxt, buildRssXml, buildSafeDescription, buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, buildWebSiteSchema, chunkSitemapUrls, deepMerge, src_default as default, escapeXml, rimelightSeo };

package/dist/integration.d.mts

@@ -0,0 +1,6 @@
+import { RimelightSeoOptions } from "./types.mjs";
+import { AstroIntegration } from "astro";
+//#region src/integration.d.ts
+export declare function rimelightSeo(options?: RimelightSeoOptions): AstroIntegration;
+//#endregion
+export { type RimelightSeoOptions, rimelightSeo as default };

package/dist/integration.mjs

@@ -0,0 +1,101 @@
+import path from "node:path";
+import fs from "node:fs";
+import { fileURLToPath } from "node:url";
+//#region src/integration.ts
+function rimelightSeo(options = {}) {
+	return {
+		name: "@rimelight/seo",
+		hooks: { "astro:config:setup": ({ injectRoute, updateConfig, config }) => {
+			const rootDir = fileURLToPath(config.root);
+			const findFile = (candidates) => {
+				for (const c of candidates) {
+					const resolved = path.resolve(rootDir, c);
+					if (fs.existsSync(resolved)) return resolved;
+				}
+				return null;
+			};
+			const seoConfigPath = findFile([
+				"src/config/seo.config.ts",
+				"src/config/seo.config.js",
+				"src/config/seo.config.mjs"
+			]);
+			const siteConfigPath = findFile([
+				"src/config/site.config.ts",
+				"src/config/site.config.js",
+				"src/config/site.config.mjs"
+			]);
+			const dbPath = findFile([
+				"src/db/index.ts",
+				"src/db/index.js",
+				"src/db/index.mjs"
+			]);
+			const corpusPath = findFile([
+				"src/config/llms.corpus.ts",
+				"src/config/llms.corpus.js",
+				"src/config/llms.corpus.mjs"
+			]);
+			if (options.robots !== false) injectRoute({
+				pattern: typeof options.robots === "object" && options.robots.path ? options.robots.path : "/robots.txt",
+				entrypoint: "@rimelight/seo/routes/robots.txt.ts"
+			});
+			if (options.sitemap !== false) injectRoute({
+				pattern: typeof options.sitemap === "object" && options.sitemap.path ? options.sitemap.path : "/sitemap.xml",
+				entrypoint: "@rimelight/seo/routes/sitemap.xml.ts"
+			});
+			if (options.rss !== false) injectRoute({
+				pattern: typeof options.rss === "object" && options.rss.path ? options.rss.path : "/rss.xml",
+				entrypoint: "@rimelight/seo/routes/rss.xml.ts"
+			});
+			if (options.llms !== false) injectRoute({
+				pattern: typeof options.llms === "object" && options.llms.path ? options.llms.path : "/llms.txt",
+				entrypoint: "@rimelight/seo/routes/llms.txt.ts"
+			});
+			if (options.llmsFull !== false) injectRoute({
+				pattern: typeof options.llmsFull === "object" && options.llmsFull.path ? options.llmsFull.path : "/llms-full.txt",
+				entrypoint: "@rimelight/seo/routes/llms-full.txt.ts"
+			});
+			updateConfig({ vite: { plugins: [{
+				name: "vite-plugin-rimelight-seo",
+				resolveId(id) {
+					if (id === "virtual:rimelight-seo-config" || id === "virtual:rimelight-seo/options") return "\0virtual:rimelight-seo/options";
+					if (id === "virtual:rimelight-seo/config") return "\0virtual:rimelight-seo/config";
+					if (id === "virtual:rimelight-seo/site-config") return "\0virtual:rimelight-seo/site-config";
+					if (id === "virtual:rimelight-seo/db") return "\0virtual:rimelight-seo/db";
+					if (id === "virtual:rimelight-seo/corpus") return "\0virtual:rimelight-seo/corpus";
+					return null;
+				},
+				load(id) {
+					if (id === "\0virtual:rimelight-seo/options") return `export default ${JSON.stringify(options)};`;
+					if (id === "\0virtual:rimelight-seo/config") {
+						if (seoConfigPath) return `import * as customConfig from ${JSON.stringify(seoConfigPath)};
+export const SEO_LOCALES = customConfig.SEO_LOCALES;
+export const PRIVATE_PATH_PREFIXES = customConfig.PRIVATE_PATH_PREFIXES || [];
+export const seoEntries = customConfig.seoEntries;
+export const rssEntries = customConfig.rssEntries;
+export default customConfig;`;
+						return `export const SEO_LOCALES = undefined;
+export const PRIVATE_PATH_PREFIXES = [];
+export const seoEntries = async () => [];
+export const rssEntries = undefined;`;
+					}
+					if (id === "\0virtual:rimelight-seo/site-config") {
+						if (siteConfigPath) return `export * from ${JSON.stringify(siteConfigPath)};`;
+						return `export const siteConfig = { name: "Site", description: "", url: "" };`;
+					}
+					if (id === "\0virtual:rimelight-seo/db") {
+						if (dbPath) return `export * from ${JSON.stringify(dbPath)};`;
+						return `export const db = null;
+export const pages = null;`;
+					}
+					if (id === "\0virtual:rimelight-seo/corpus") {
+						if (corpusPath) return `export * from ${JSON.stringify(corpusPath)};`;
+						return `export const corpusPages = [];`;
+					}
+					return null;
+				}
+			}] } });
+		} }
+	};
+}
+//#endregion
+export { rimelightSeo as default, rimelightSeo };

package/dist/llms-BVLxzjr-.d.mts

@@ -0,0 +1,41 @@
+//#region src/llms.d.ts
+interface LlmsPage {
+  title: string;
+  url: string;
+  description?: string;
+  markdownUrl?: string;
+  section?: string;
+}
+interface LlmsTxtOptions {
+  site: string;
+  title: string;
+  description?: string;
+  fullCorpusUrl?: string;
+  pages: LlmsPage[];
+  sections?: Array<{
+    label: string;
+    url: string;
+  }>;
+}
+interface LlmsFullTxtOptions {
+  site: string;
+  title: string;
+  description?: string;
+  pages: Array<{
+    title: string;
+    url: string;
+    description?: string;
+    markdown: string;
+    version?: string;
+  }>;
+}
+/**
+ * Builds standard /llms.txt document format for AI discovery.
+ */
+declare function buildLlmsTxt(options: LlmsTxtOptions): string;
+/**
+ * Builds concatenated /llms-full.txt single corpus document for AI agents.
+ */
+declare function buildLlmsFullTxt(options: LlmsFullTxtOptions): string;
+//#endregion
+export { buildLlmsTxt as a, buildLlmsFullTxt as i, LlmsPage as n, LlmsTxtOptions as r, LlmsFullTxtOptions as t };

package/dist/llms.d.mts

@@ -0,0 +1,2 @@
+import { a as buildLlmsTxt, i as buildLlmsFullTxt, n as LlmsPage, r as LlmsTxtOptions, t as LlmsFullTxtOptions } from "./llms-BVLxzjr-.mjs";
+export { LlmsFullTxtOptions, LlmsPage, LlmsTxtOptions, buildLlmsFullTxt, buildLlmsTxt };

package/dist/llms.mjs

@@ -0,0 +1,75 @@
+//#region src/llms.ts
+/**
+* Builds standard /llms.txt document format for AI discovery.
+*/
+function buildLlmsTxt(options) {
+	const { site, title, description, fullCorpusUrl = `${site.replace(/\/$/, "")}/llms-full.txt`, pages, sections = [] } = options;
+	const lines = [
+		`# ${title}`,
+		"",
+		description || "Documentation index for AI agents.",
+		"",
+		`Full corpus (all pages, one document): ${fullCorpusUrl}`,
+		""
+	];
+	if (sections.length > 0) {
+		lines.push("## Sections", "");
+		for (const sec of sections) lines.push(`- [${sec.label}](${sec.url})`);
+		lines.push("");
+	}
+	lines.push("## Pages", "");
+	const grouped = /* @__PURE__ */ new Map();
+	for (const page of pages) {
+		const sec = page.section || "General";
+		if (!grouped.has(sec)) grouped.set(sec, []);
+		grouped.get(sec).push(page);
+	}
+	if (grouped.size === 1 && grouped.has("General")) for (const page of pages) {
+		const pageUrl = page.markdownUrl || page.url;
+		const desc = page.description ? ` — ${page.description}` : "";
+		lines.push(`- [${page.title}](${pageUrl})${desc}`);
+	}
+	else for (const [secName, secPages] of grouped.entries()) {
+		lines.push(`### ${secName}`, "");
+		for (const page of secPages) {
+			const pageUrl = page.markdownUrl || page.url;
+			const desc = page.description ? ` — ${page.description}` : "";
+			lines.push(`- [${page.title}](${pageUrl})${desc}`);
+		}
+		lines.push("");
+	}
+	lines.push("");
+	return lines.join("\n");
+}
+/**
+* Builds concatenated /llms-full.txt single corpus document for AI agents.
+*/
+function buildLlmsFullTxt(options) {
+	const { title, description, pages } = options;
+	const parts = [
+		`# ${title} — Full Documentation Corpus`,
+		"",
+		description || "Complete documentation corpus for AI agents.",
+		"",
+		"---",
+		""
+	];
+	for (const page of pages) {
+		const metaHeader = [
+			`## ${page.title}`,
+			"",
+			`URL: ${page.url}`,
+			...page.description ? [`Description: ${page.description}`] : [],
+			...page.version ? [`Version: ${page.version}`] : [],
+			"",
+			page.markdown.trim(),
+			"",
+			"---",
+			""
+		];
+		parts.push(...metaHeader);
+	}
+	return parts.join("\n");
+}
+//#endregion
+export { buildLlmsFullTxt, buildLlmsTxt };

package/dist/meta.d.mts

@@ -0,0 +1,42 @@
+import { SiteConfig } from "./types.mjs";
+//#region src/meta.d.ts
+/**
+ * Build a canonical URL from a page URL and site base. - Strips trailing slash unless the path has
+ * query params (where trailing slash is removed too). - Returns undefined-safe: pass Astro.url and
+ * Astro.site directly.
+ */
+export declare function buildCanonicalUrl(url: string | URL, base: string | URL): string;
+/**
+ * Deep merge two metadata or configuration objects.
+ */
+export declare function deepMerge<T extends Record<string, any>>(base: T, override?: Record<string, any>): T;
+/**
+ * Build a page title using a site's title template. Falls back to siteName for untitled pages; uses
+ * a 404 label for error pages. Supports absolute title bypass.
+ */
+export declare function buildPageTitle(opts: {
+  title?: string;
+  siteName: string;
+  titleTemplate: string;
+  is404?: boolean;
+  absolute?: boolean;
+}): string;
+/**
+ * Truncate a description to a maximum character length, appending "…" if trimmed.
+ */
+export declare function buildSafeDescription(description: string, maxLength: number): string;
+/**
+ * Build the value for the <meta name="robots"> tag. Returns the full directive string including
+ * max-image-preview for indexable pages.
+ */
+export declare function buildRobotsMetaContent(opts: {
+  noindex?: boolean;
+  is404?: boolean;
+  override?: string;
+}): string;
+/**
+ * \n * Build a Schema.org WebSite JSON-LD object.\n * Pass the result to JSON.stringify and emit
+ * via <script type="application/ld+json">.\n
+ */
+export declare function buildWebSiteSchema(config: Pick<SiteConfig, "name" | "url" | "description">, site?: string): Record<string, unknown>;
+//#endregion

package/dist/meta.mjs

@@ -0,0 +1,66 @@
+//#region src/meta.ts
+/**
+* Build a canonical URL from a page URL and site base. - Strips trailing slash unless the path has
+* query params (where trailing slash is removed too). - Returns undefined-safe: pass Astro.url and
+* Astro.site directly.
+*/
+function buildCanonicalUrl(url, base) {
+	const path = new URL(url, base).toString();
+	return path.includes("?") ? path.replace(/\/?$/, "") : path.replace(/\/?$/, "/");
+}
+/**
+* Deep merge two metadata or configuration objects.
+*/
+function deepMerge(base, override) {
+	if (!override) return { ...base };
+	const result = { ...base };
+	for (const key of Object.keys(override)) {
+		const baseVal = base[key];
+		const overrideVal = override[key];
+		if (baseVal && overrideVal && typeof baseVal === "object" && typeof overrideVal === "object" && !Array.isArray(baseVal) && !Array.isArray(overrideVal)) result[key] = deepMerge(baseVal, overrideVal);
+		else if (overrideVal !== void 0) result[key] = overrideVal;
+	}
+	return result;
+}
+/**
+* Build a page title using a site's title template. Falls back to siteName for untitled pages; uses
+* a 404 label for error pages. Supports absolute title bypass.
+*/
+function buildPageTitle(opts) {
+	const { title, siteName, titleTemplate, is404, absolute } = opts;
+	if (is404) return `404 - Not Found | ${siteName}`;
+	if (!title) return siteName;
+	if (absolute) return title;
+	return titleTemplate.replace("%s", title);
+}
+/**
+* Truncate a description to a maximum character length, appending "…" if trimmed.
+*/
+function buildSafeDescription(description, maxLength) {
+	if (!description) return description;
+	if (description.length <= maxLength) return description;
+	return description.slice(0, maxLength - 3) + "...";
+}
+/**
+* Build the value for the <meta name="robots"> tag. Returns the full directive string including
+* max-image-preview for indexable pages.
+*/
+function buildRobotsMetaContent(opts) {
+	if (opts.override) return opts.override;
+	return !opts.noindex && !opts.is404 ? "index, follow, max-image-preview:large" : "noindex, nofollow";
+}
+/**
+* \n * Build a Schema.org WebSite JSON-LD object.\n * Pass the result to JSON.stringify and emit
+* via <script type="application/ld+json">.\n
+*/
+function buildWebSiteSchema(config, site) {
+	return {
+		"@context": "https://schema.org",
+		"@type": "WebSite",
+		"name": config.name,
+		"url": site ?? config.url,
+		"description": config.description
+	};
+}
+//#endregion
+export { buildCanonicalUrl, buildPageTitle, buildRobotsMetaContent, buildSafeDescription, buildWebSiteSchema, deepMerge };