@rimelight/seo 0.0.5 → 0.0.7

package/dist/assets.d.mts

@@ -0,0 +1,39 @@
+//#region src/assets.d.ts
+export interface GeneratePngOptions {
+  width: number;
+  height: number;
+  background?: string;
+}
+export interface GenerateMaskableOptions {
+  size?: number;
+  background?: string;
+  paddingRatio?: number;
+}
+export interface GenerateOgCardOptions {
+  width?: number;
+  height?: number;
+  background?: string;
+  logoBuffer?: Buffer | Uint8Array | string | null;
+}
+/**
+ * Generate a PNG buffer resized to specific dimensions from an SVG or image buffer.
+ */
+export declare function generatePng(source: Buffer | Uint8Array | string, options: {
+  width: number;
+  height: number;
+}): Promise<Buffer>;
+/**
+ * Generate a maskable PWA PNG icon with safe-zone padding and solid background. The standard
+ * recommendation is to place the master icon in the inner 80% safe zone.
+ */
+export declare function generateMaskablePng(source: Buffer | Uint8Array | string, options?: GenerateMaskableOptions): Promise<Buffer>;
+/**
+ * Generate a valid .ico buffer containing a 32x32 PNG image according to the Windows ICO
+ * specification.
+ */
+export declare function generateIco(source: Buffer | Uint8Array | string, size?: number): Promise<Buffer>;
+/**
+ * Generate a standard 1200x630 branded Open Graph card from a master logo and background color.
+ */
+export declare function generateOgCard(options?: GenerateOgCardOptions): Promise<Buffer>;
+//#endregion

package/dist/assets.mjs

@@ -0,0 +1,96 @@
+import sharp from "sharp";
+//#region src/assets.ts
+/**
+* Generate a PNG buffer resized to specific dimensions from an SVG or image buffer.
+*/
+async function generatePng(source, options) {
+	return sharp(source).resize(options.width, options.height, {
+		fit: "contain",
+		background: {
+			r: 0,
+			g: 0,
+			b: 0,
+			alpha: 0
+		}
+	}).png().toBuffer();
+}
+/**
+* Generate a maskable PWA PNG icon with safe-zone padding and solid background. The standard
+* recommendation is to place the master icon in the inner 80% safe zone.
+*/
+async function generateMaskablePng(source, options = {}) {
+	const { size = 512, background = "#ffffff", paddingRatio = .15 } = options;
+	const innerSize = Math.round(size * (1 - paddingRatio * 2));
+	const pad = Math.floor((size - innerSize) / 2);
+	const innerPng = await sharp(source).resize(innerSize, innerSize, {
+		fit: "contain",
+		background: {
+			r: 0,
+			g: 0,
+			b: 0,
+			alpha: 0
+		}
+	}).png().toBuffer();
+	return sharp(innerPng).extend({
+		top: pad,
+		bottom: size - innerSize - pad,
+		left: pad,
+		right: size - innerSize - pad,
+		background
+	}).png().toBuffer();
+}
+/**
+* Generate a valid .ico buffer containing a 32x32 PNG image according to the Windows ICO
+* specification.
+*/
+async function generateIco(source, size = 32) {
+	const pngBuffer = await generatePng(source, {
+		width: size,
+		height: size
+	});
+	const header = Buffer.alloc(22);
+	header.writeUInt16LE(0, 0);
+	header.writeUInt16LE(1, 2);
+	header.writeUInt16LE(1, 4);
+	header.writeUInt8(size === 256 ? 0 : size, 6);
+	header.writeUInt8(size === 256 ? 0 : size, 7);
+	header.writeUInt8(0, 8);
+	header.writeUInt8(0, 9);
+	header.writeUInt16LE(1, 10);
+	header.writeUInt16LE(32, 12);
+	header.writeUInt32LE(pngBuffer.length, 14);
+	header.writeUInt32LE(22, 18);
+	return Buffer.concat([header, pngBuffer]);
+}
+/**
+* Generate a standard 1200x630 branded Open Graph card from a master logo and background color.
+*/
+async function generateOgCard(options = {}) {
+	const { width = 1200, height = 630, background = "#0a0a0a", logoBuffer } = options;
+	if (logoBuffer) {
+		const logoSize = Math.min(Math.round(height * .45), 280);
+		const logoPng = await generatePng(logoBuffer, {
+			width: logoSize,
+			height: logoSize
+		});
+		const topPad = Math.floor((height - logoSize) / 2);
+		const bottomPad = height - logoSize - topPad;
+		const leftPad = Math.floor((width - logoSize) / 2);
+		const rightPad = width - logoSize - leftPad;
+		return sharp(logoPng).extend({
+			top: topPad,
+			bottom: bottomPad,
+			left: leftPad,
+			right: rightPad,
+			background
+		}).png().toBuffer();
+	}
+	return sharp({ create: {
+		width,
+		height,
+		channels: 4,
+		background
+	} }).png().toBuffer();
+}
+//#endregion
+export { generateIco, generateMaskablePng, generateOgCard, generatePng };

package/dist/catalog.d.mts

@@ -0,0 +1,7 @@
+import { ApiCatalog, ApiCatalogOptions } from "./types.mjs";
+//#region src/catalog.d.ts
+/**
+ * Build RFC 9652 Application Linkset API Catalog. https://www.rfc-editor.org/rfc/rfc9652
+ */
+export declare function buildApiCatalog(options: ApiCatalogOptions): ApiCatalog;
+//#endregion

package/dist/catalog.mjs

@@ -0,0 +1,10 @@
+//#region src/catalog.ts
+/**
+* Build RFC 9652 Application Linkset API Catalog. https://www.rfc-editor.org/rfc/rfc9652
+*/
+function buildApiCatalog(options) {
+	const { items } = options;
+	return { "api-catalog": items };
+}
+//#endregion
+export { buildApiCatalog };

package/dist/index.d.mts

@@ -1,8 +1,14 @@
+import { generateIco, generateMaskablePng, generateOgCard, generatePng } from "./assets.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, LocaleConfig, OGImage, OpenGraphMeta, RSSFeed, RobotsOptions, SeoEntry, SiteConfig, SitemapAlternate, SitemapUrl, TwitterMeta, UserAgentRule } from "./types.mjs";
+import { ApiCatalog, ApiCatalogItem, ApiCatalogOptions, ApiCatalogRouteOptions, AssetRouteOptions, ChangeFreq, HeadProps, LlmsFullRouteOptions, LlmsRouteOptions, LocaleConfig, ManifestRouteOptions, OGImage, OpenGraphMeta, RSSFeed, RimelightSeoOptions, RobotsOptions, RobotsRouteOptions, RssCollectionConfig, RssFeedOptions, RssItem, RssOptions, SecurityRouteOptions, SecurityTxtOptions, SeoEntry, SiteConfig, SitemapAlternate, SitemapOptions, SitemapUrl, TwitterMeta, UserAgentRule, WebManifest, WebManifestIcon, WebManifestOptions, WebManifestShortcut } from "./types.mjs";
+import { buildApiCatalog } from "./catalog.mjs";
 import { buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, chunkSitemapUrls } from "./sitemap.mjs";
 import { buildRobotsTxt } from "./robots.mjs";
+import { buildRssXml, escapeXml } from "./rss.mjs";
 import { buildCanonicalUrl, buildPageTitle, buildRobotsMetaContent, buildSafeDescription, buildWebSiteSchema, deepMerge } from "./meta.mjs";
-import { RimelightSeoOptions, rimelightSeo } from "./integration.mjs";
-export { type ArticleSchemaOptions, type BreadcrumbItem, type ChangeFreq, type HeadProps, type LlmsFullTxtOptions, type LlmsPage, type LlmsTxtOptions, type LocaleConfig, type OGImage, type OpenGraphMeta, type RSSFeed, type RimelightSeoOptions, type RobotsOptions, type SeoEntry, type SiteConfig, type SitemapAlternate, type SitemapUrl, type TwitterMeta, type UserAgentRule, buildArticleSchema, buildBreadcrumbSchema, buildCanonicalUrl, buildLlmsFullTxt, buildLlmsTxt, buildPageTitle, buildRobotsMetaContent, buildRobotsTxt, buildSafeDescription, buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, buildWebSiteSchema, chunkSitemapUrls, deepMerge, rimelightSeo };
+import { buildSecurityTxt } from "./security.mjs";
+import { buildWebManifest } from "./manifest.mjs";
+import { OgFontConfig, OgLayoutOptions, OgRenderConfig } from "./og.mjs";
+import rimelightSeo from "./integration.mjs";
+export { type ApiCatalog, type ApiCatalogItem, type ApiCatalogOptions, type ApiCatalogRouteOptions, type ArticleSchemaOptions, type AssetRouteOptions, type BreadcrumbItem, type ChangeFreq, type HeadProps, type LlmsFullRouteOptions, type LlmsFullTxtOptions, type LlmsPage, type LlmsRouteOptions, type LlmsTxtOptions, type LocaleConfig, type ManifestRouteOptions, type OGImage, type OgFontConfig, type OgLayoutOptions, type OgRenderConfig, type OpenGraphMeta, type RSSFeed, type RimelightSeoOptions, type RobotsOptions, type RobotsRouteOptions, type RssCollectionConfig, type RssFeedOptions, type RssItem, type RssOptions, type SecurityRouteOptions, type SecurityTxtOptions, type SeoEntry, type SiteConfig, type SitemapAlternate, type SitemapOptions, type SitemapUrl, type TwitterMeta, type UserAgentRule, type WebManifest, type WebManifestIcon, type WebManifestOptions, type WebManifestShortcut, buildApiCatalog, buildArticleSchema, buildBreadcrumbSchema, buildCanonicalUrl, buildLlmsFullTxt, buildLlmsTxt, buildPageTitle, buildRobotsMetaContent, buildRobotsTxt, buildRssXml, buildSafeDescription, buildSecurityTxt, buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, buildWebManifest, buildWebSiteSchema, chunkSitemapUrls, deepMerge, rimelightSeo as default, rimelightSeo, escapeXml, generateIco, generateMaskablePng, generateOgCard, generatePng };

package/dist/index.mjs

@@ -1,7 +1,15 @@
+import { generateIco, generateMaskablePng, generateOgCard, generatePng } from "./assets.mjs";
+import { buildApiCatalog } from "./catalog.mjs";
 import { buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, chunkSitemapUrls } from "./sitemap.mjs";
 import { buildRobotsTxt } from "./robots.mjs";
+import { buildRssXml, escapeXml } from "./rss.mjs";
 import { buildCanonicalUrl, buildPageTitle, buildRobotsMetaContent, buildSafeDescription, buildWebSiteSchema, deepMerge } from "./meta.mjs";
 import { buildLlmsFullTxt, buildLlmsTxt } from "./llms.mjs";
+import { buildSecurityTxt } from "./security.mjs";
+import { buildWebManifest } from "./manifest.mjs";
 import { buildArticleSchema, buildBreadcrumbSchema } from "./schema.mjs";
-import { rimelightSeo } from "./integration.mjs";
-export { buildArticleSchema, buildBreadcrumbSchema, buildCanonicalUrl, buildLlmsFullTxt, buildLlmsTxt, buildPageTitle, buildRobotsMetaContent, buildRobotsTxt, buildSafeDescription, buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, buildWebSiteSchema, chunkSitemapUrls, deepMerge, rimelightSeo };
+import rimelightSeo from "./integration.mjs";
+//#region src/index.ts
+var src_default = rimelightSeo;
+//#endregion
+export { buildApiCatalog, buildArticleSchema, buildBreadcrumbSchema, buildCanonicalUrl, buildLlmsFullTxt, buildLlmsTxt, buildPageTitle, buildRobotsMetaContent, buildRobotsTxt, buildRssXml, buildSafeDescription, buildSecurityTxt, buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, buildWebManifest, buildWebSiteSchema, chunkSitemapUrls, deepMerge, src_default as default, escapeXml, generateIco, generateMaskablePng, generateOgCard, generatePng, rimelightSeo };

package/dist/integration.d.mts

@@ -1,23 +1,6 @@
-import { r as LlmsTxtOptions } from "./llms-BVLxzjr-.mjs";
-import { RobotsOptions, SitemapUrl } from "./types.mjs";
+import { RimelightSeoOptions } from "./types.mjs";
 import { AstroIntegration } from "astro";
 //#region src/integration.d.ts
-export interface RimelightSeoOptions {
-  /**
-   * Sitemap configuration or false to disable automatic /sitemap.xml
-   */
-  sitemap?: boolean | {
-    urls?: SitemapUrl[];
-    [key: string]: any;
-  };
-  /**
-   * Robots.txt configuration or false to disable automatic /robots.txt
-   */
-  robots?: boolean | RobotsOptions;
-  /**
-   * LLMs.txt configuration or false to disable automatic /llms.txt
-   */
-  llms?: boolean | LlmsTxtOptions;
-}
 export declare function rimelightSeo(options?: RimelightSeoOptions): AstroIntegration;
-//#endregion
+//#endregion
+export { type RimelightSeoOptions, rimelightSeo as default };

package/dist/integration.mjs

@@ -1,28 +1,278 @@
+import { generateIco, generateMaskablePng, generateOgCard, generatePng } from "./assets.mjs";
+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 }) => {
+		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"
+			]);
+			const assetOpts = typeof options.assets === "object" ? options.assets : {};
+			const explicitIcon = assetOpts.icon ? path.resolve(rootDir, assetOpts.icon) : null;
+			const masterIconPath = explicitIcon && fs.existsSync(explicitIcon) ? explicitIcon : findFile([
+				"src/assets/logos/logomark_color.svg",
+				"src/assets/logos/logo_color.svg",
+				"src/assets/logos/logomark.svg",
+				"src/assets/logos/logo.svg",
+				"src/assets/icon.svg",
+				"src/assets/logo.svg",
+				"src/assets/icon.png",
+				"public/favicon.svg"
+			]);
+			let masterIconBuffer = null;
+			let isSvg = false;
+			if (masterIconPath && fs.existsSync(masterIconPath)) {
+				masterIconBuffer = fs.readFileSync(masterIconPath);
+				isSvg = masterIconPath.endsWith(".svg");
+			}
+			const bgColor = assetOpts.backgroundColor || "#ffffff";
 			if (options.robots !== false) injectRoute({
-				pattern: "/robots.txt",
+				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: "/sitemap.xml",
+				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: "/llms.txt",
+				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"
+			});
+			if (options.security !== false) {
+				const pattern = typeof options.security === "object" && options.security.path ? options.security.path : "/.well-known/security.txt";
+				injectRoute({
+					pattern,
+					entrypoint: "@rimelight/seo/routes/security.txt.ts"
+				});
+				if ((typeof options.security === "object" ? options.security.legacyRoute !== false : true) && pattern === "/.well-known/security.txt") injectRoute({
+					pattern: "/security.txt",
+					entrypoint: "@rimelight/seo/routes/security.txt.ts"
+				});
+			}
+			if (options.apiCatalog !== false) injectRoute({
+				pattern: typeof options.apiCatalog === "object" && options.apiCatalog.path ? options.apiCatalog.path : "/.well-known/api-catalog",
+				entrypoint: "@rimelight/seo/routes/api-catalog.ts"
+			});
+			if (options.manifest !== false) injectRoute({
+				pattern: typeof options.manifest === "object" && options.manifest.path ? options.manifest.path : "/site.webmanifest",
+				entrypoint: "@rimelight/seo/routes/site.webmanifest.ts"
+			});
 			updateConfig({ vite: { plugins: [{
+				name: "vite-plugin-rimelight-seo-assets",
+				configureServer(server) {
+					if (!masterIconBuffer) return;
+					server.middlewares.use(async (req, res, next) => {
+						const url = req.url?.split("?")[0];
+						if (url === "/favicon.ico" && assetOpts.faviconIco !== false) {
+							const ico = await generateIco(masterIconBuffer, 32);
+							res.setHeader("Content-Type", "image/x-icon");
+							res.setHeader("Cache-Control", "no-cache");
+							res.end(ico);
+							return;
+						}
+						if (url === "/apple-touch-icon.png" && assetOpts.appleTouchIcon !== false) {
+							const png = await generatePng(masterIconBuffer, {
+								width: 180,
+								height: 180
+							});
+							res.setHeader("Content-Type", "image/png");
+							res.setHeader("Cache-Control", "no-cache");
+							res.end(png);
+							return;
+						}
+						if (url === "/icon-192.png" && assetOpts.icon192 !== false) {
+							const png = await generatePng(masterIconBuffer, {
+								width: 192,
+								height: 192
+							});
+							res.setHeader("Content-Type", "image/png");
+							res.setHeader("Cache-Control", "no-cache");
+							res.end(png);
+							return;
+						}
+						if (url === "/icon-512.png" && assetOpts.icon512 !== false) {
+							const png = await generatePng(masterIconBuffer, {
+								width: 512,
+								height: 512
+							});
+							res.setHeader("Content-Type", "image/png");
+							res.setHeader("Cache-Control", "no-cache");
+							res.end(png);
+							return;
+						}
+						if (url === "/icon-maskable-512.png" && assetOpts.iconMaskable !== false) {
+							const png = await generateMaskablePng(masterIconBuffer, {
+								size: 512,
+								background: bgColor
+							});
+							res.setHeader("Content-Type", "image/png");
+							res.setHeader("Cache-Control", "no-cache");
+							res.end(png);
+							return;
+						}
+						if (url === "/favicon.svg" && isSvg) {
+							res.setHeader("Content-Type", "image/svg+xml");
+							res.setHeader("Cache-Control", "no-cache");
+							res.end(masterIconBuffer);
+							return;
+						}
+						if (url === "/og.png" && assetOpts.ogImage !== false) {
+							const og = await generateOgCard({
+								logoBuffer: masterIconBuffer,
+								background: bgColor
+							});
+							res.setHeader("Content-Type", "image/png");
+							res.setHeader("Cache-Control", "no-cache");
+							res.end(og);
+							return;
+						}
+						next();
+					});
+				},
+				async generateBundle() {
+					if (options.assets === false || !masterIconBuffer) return;
+					if (assetOpts.faviconIco !== false) {
+						const ico = await generateIco(masterIconBuffer, 32);
+						this.emitFile({
+							type: "asset",
+							fileName: "favicon.ico",
+							source: ico
+						});
+					}
+					if (assetOpts.appleTouchIcon !== false) {
+						const png = await generatePng(masterIconBuffer, {
+							width: 180,
+							height: 180
+						});
+						this.emitFile({
+							type: "asset",
+							fileName: "apple-touch-icon.png",
+							source: png
+						});
+					}
+					if (assetOpts.icon192 !== false) {
+						const png = await generatePng(masterIconBuffer, {
+							width: 192,
+							height: 192
+						});
+						this.emitFile({
+							type: "asset",
+							fileName: "icon-192.png",
+							source: png
+						});
+					}
+					if (assetOpts.icon512 !== false) {
+						const png = await generatePng(masterIconBuffer, {
+							width: 512,
+							height: 512
+						});
+						this.emitFile({
+							type: "asset",
+							fileName: "icon-512.png",
+							source: png
+						});
+					}
+					if (assetOpts.iconMaskable !== false) {
+						const png = await generateMaskablePng(masterIconBuffer, {
+							size: 512,
+							background: bgColor
+						});
+						this.emitFile({
+							type: "asset",
+							fileName: "icon-maskable-512.png",
+							source: png
+						});
+					}
+					if (assetOpts.ogImage !== false) {
+						const og = await generateOgCard({
+							logoBuffer: masterIconBuffer,
+							background: bgColor
+						});
+						this.emitFile({
+							type: "asset",
+							fileName: "og.png",
+							source: og
+						});
+					}
+					if (isSvg) this.emitFile({
+						type: "asset",
+						fileName: "favicon.svg",
+						source: masterIconBuffer
+					});
+				}
+			}, {
 				name: "vite-plugin-rimelight-seo",
 				resolveId(id) {
-					if (id === "virtual:rimelight-seo-config") return "\0virtual:rimelight-seo-config";
+					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-config") return `export default ${JSON.stringify(options)};`;
+					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;
 				}
 			}] } });
@@ -30,4 +280,4 @@ function rimelightSeo(options = {}) {
 	};
 }
 //#endregion
-export { rimelightSeo };
+export { rimelightSeo as default, rimelightSeo };

package/dist/manifest.d.mts

@@ -0,0 +1,7 @@
+import { WebManifest, WebManifestOptions } from "./types.mjs";
+//#region src/manifest.d.ts
+/**
+ * Build web app manifest (site.webmanifest) compliant with W3C Web App Manifest.
+ */
+export declare function buildWebManifest(options: WebManifestOptions): WebManifest;
+//#endregion

package/dist/manifest.mjs

@@ -0,0 +1,44 @@
+//#region src/manifest.ts
+/**
+* Build web app manifest (site.webmanifest) compliant with W3C Web App Manifest.
+*/
+function buildWebManifest(options) {
+	const { name, shortName = name, description = "", startUrl = "/", display = "standalone", backgroundColor = "#ffffff", themeColor = "#ffffff", icons = [
+		{
+			src: "/icon-192.png",
+			sizes: "192x192",
+			type: "image/png",
+			purpose: "any"
+		},
+		{
+			src: "/icon-512.png",
+			sizes: "512x512",
+			type: "image/png",
+			purpose: "any"
+		},
+		{
+			src: "/icon-maskable-512.png",
+			sizes: "512x512",
+			type: "image/png",
+			purpose: "maskable"
+		}
+	], shortcuts, categories, lang, dir, orientation, scope } = options;
+	return {
+		name,
+		short_name: shortName,
+		...description ? { description } : {},
+		start_url: startUrl,
+		display,
+		background_color: backgroundColor,
+		theme_color: themeColor,
+		icons,
+		...shortcuts ? { shortcuts } : {},
+		...categories ? { categories } : {},
+		...lang ? { lang } : {},
+		...dir ? { dir } : {},
+		...orientation ? { orientation } : {},
+		...scope ? { scope } : {}
+	};
+}
+//#endregion
+export { buildWebManifest };