@vistagenic/vista 0.3.6 → 0.3.8

package/dist/metadata/generate.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MetadataRenderer = MetadataRenderer;
 exports.generateMetadataHtml = generateMetadataHtml;
 const jsx_runtime_1 = require("react/jsx-runtime");
+const merge_1 = require("./merge");
 // ============================================================================
 // Helper Functions
 // ============================================================================
@@ -19,9 +20,10 @@ function resolveTitle(title, template) {
     if (title.absolute) {
         return title.absolute;
     }
-    const baseTitle = title.default;
-    if (title.template) {
-        return title.template.replace('%s', baseTitle);
+    const baseTitle = title.default ?? '';
+    const activeTemplate = title.template || template;
+    if (activeTemplate && baseTitle) {
+        return activeTemplate.replace('%s', baseTitle);
     }
     return baseTitle;
 }
@@ -98,12 +100,7 @@ function generateAuthorMeta(authors) {
     });
     return elements;
 }
-function generateRobotsMeta(robots) {
-    if (!robots)
-        return [];
-    if (typeof robots === 'string') {
-        return [(0, jsx_runtime_1.jsx)("meta", { name: "robots", content: robots }, "robots")];
-    }
+function robotsDirectives(robots) {
     const directives = [];
     if (robots.index !== undefined)
         directives.push(robots.index ? 'index' : 'noindex');
@@ -117,21 +114,37 @@ function generateRobotsMeta(robots) {
         directives.push('noimageindex');
     if (robots.nocache)
         directives.push('nocache');
+    if (robots.notranslate)
+        directives.push('notranslate');
     if (robots['max-snippet'] !== undefined)
         directives.push(`max-snippet:${robots['max-snippet']}`);
     if (robots['max-image-preview'])
         directives.push(`max-image-preview:${robots['max-image-preview']}`);
     if (robots['max-video-preview'] !== undefined)
         directives.push(`max-video-preview:${robots['max-video-preview']}`);
+    return directives;
+}
+function generateRobotsMeta(robots) {
+    if (!robots)
+        return [];
+    if (typeof robots === 'string') {
+        return [(0, jsx_runtime_1.jsx)("meta", { name: "robots", content: robots }, "robots")];
+    }
     const elements = [];
+    const directives = robotsDirectives(robots);
     if (directives.length > 0) {
         elements.push((0, jsx_runtime_1.jsx)("meta", { name: "robots", content: directives.join(', ') }, "robots"));
     }
-    // GoogleBot specific
     if (robots.googleBot) {
         if (typeof robots.googleBot === 'string') {
             elements.push((0, jsx_runtime_1.jsx)("meta", { name: "googlebot", content: robots.googleBot }, "googlebot"));
         }
+        else {
+            const googleDirectives = robotsDirectives(robots.googleBot);
+            if (googleDirectives.length > 0) {
+                elements.push((0, jsx_runtime_1.jsx)("meta", { name: "googlebot", content: googleDirectives.join(', ') }, "googlebot"));
+            }
+        }
     }
     return elements;
 }
@@ -184,44 +197,108 @@ function generateOpenGraphMeta(og, base) {
                 if (image.alt) {
                     elements.push((0, jsx_runtime_1.jsx)("meta", { property: "og:image:alt", content: image.alt }, `og:image:alt:${index}`));
                 }
+                if (image.type) {
+                    elements.push((0, jsx_runtime_1.jsx)("meta", { property: "og:image:type", content: image.type }, `og:image:type:${index}`));
+                }
             }
         });
     }
+    if ('article' in og && og.article) {
+        const article = og.article;
+        if (article.publishedTime) {
+            elements.push((0, jsx_runtime_1.jsx)("meta", { property: "article:published_time", content: article.publishedTime }, "og:article:published_time"));
+        }
+        if (article.modifiedTime) {
+            elements.push((0, jsx_runtime_1.jsx)("meta", { property: "article:modified_time", content: article.modifiedTime }, "og:article:modified_time"));
+        }
+        if (article.section) {
+            elements.push((0, jsx_runtime_1.jsx)("meta", { property: "article:section", content: article.section }, "og:article:section"));
+        }
+        if (article.tags) {
+            const tags = Array.isArray(article.tags) ? article.tags : [article.tags];
+            tags.forEach((tag, index) => {
+                elements.push((0, jsx_runtime_1.jsx)("meta", { property: "article:tag", content: tag }, `og:article:tag:${index}`));
+            });
+        }
+    }
     return elements;
 }
-function generateTwitterMeta(twitter) {
+function generateTwitterMeta(twitter, base) {
     if (!twitter)
         return [];
     const elements = [];
-    // Card type
     if (twitter.card) {
         elements.push((0, jsx_runtime_1.jsx)("meta", { name: "twitter:card", content: twitter.card }, "twitter:card"));
     }
-    // Site
     if (twitter.site) {
         elements.push((0, jsx_runtime_1.jsx)("meta", { name: "twitter:site", content: twitter.site }, "twitter:site"));
     }
-    // Creator
     if (twitter.creator) {
         elements.push((0, jsx_runtime_1.jsx)("meta", { name: "twitter:creator", content: twitter.creator }, "twitter:creator"));
     }
-    // Title
     if (twitter.title) {
         elements.push((0, jsx_runtime_1.jsx)("meta", { name: "twitter:title", content: twitter.title }, "twitter:title"));
     }
-    // Description
     if (twitter.description) {
         elements.push((0, jsx_runtime_1.jsx)("meta", { name: "twitter:description", content: twitter.description }, "twitter:description"));
     }
-    // Images
     if (twitter.images) {
         const images = Array.isArray(twitter.images) ? twitter.images : [twitter.images];
         images.forEach((image, index) => {
-            elements.push((0, jsx_runtime_1.jsx)("meta", { name: "twitter:image", content: image.toString() }, `twitter:image:${index}`));
+            elements.push((0, jsx_runtime_1.jsx)("meta", { name: "twitter:image", content: resolveUrl(image, base) || image.toString() }, `twitter:image:${index}`));
         });
     }
     return elements;
 }
+function generateOtherMeta(other) {
+    if (!other)
+        return [];
+    const elements = [];
+    Object.entries(other).forEach(([name, value]) => {
+        const values = Array.isArray(value) ? value : [value];
+        values.forEach((entry, index) => {
+            elements.push((0, jsx_runtime_1.jsx)("meta", { name: name, content: String(entry) }, `other-${name}-${index}`));
+        });
+    });
+    return elements;
+}
+function generateAppleWebAppMeta(appleWebApp) {
+    if (appleWebApp === null || appleWebApp === undefined)
+        return [];
+    const elements = [];
+    if (appleWebApp === true) {
+        elements.push((0, jsx_runtime_1.jsx)("meta", { name: "apple-mobile-web-app-capable", content: "yes" }, "apple-mobile-web-app-capable"));
+        return elements;
+    }
+    if (appleWebApp === false)
+        return elements;
+    if (appleWebApp.capable !== undefined) {
+        elements.push((0, jsx_runtime_1.jsx)("meta", { name: "apple-mobile-web-app-capable", content: appleWebApp.capable ? 'yes' : 'no' }, "apple-mobile-web-app-capable"));
+    }
+    if (appleWebApp.title) {
+        elements.push((0, jsx_runtime_1.jsx)("meta", { name: "apple-mobile-web-app-title", content: appleWebApp.title }, "apple-mobile-web-app-title"));
+    }
+    if (appleWebApp.statusBarStyle) {
+        elements.push((0, jsx_runtime_1.jsx)("meta", { name: "apple-mobile-web-app-status-bar-style", content: appleWebApp.statusBarStyle }, "apple-mobile-web-app-status-bar-style"));
+    }
+    return elements;
+}
+function generateFormatDetectionMeta(formatDetection) {
+    if (!formatDetection)
+        return [];
+    const parts = [];
+    ['telephone', 'date', 'address', 'email', 'url'].forEach((key) => {
+        if (formatDetection[key] === false)
+            parts.push(`${key}=no`);
+        if (formatDetection[key] === true)
+            parts.push(`${key}=yes`);
+    });
+    if (parts.length === 0)
+        return [];
+    return [
+        (0, jsx_runtime_1.jsx)("meta", { name: "format-detection", content: parts.join(', ') }, "format-detection"),
+    ];
+}
 function generateIconLinks(icons) {
     if (!icons)
         return [];
@@ -305,6 +382,22 @@ function generateAlternateLinks(alternates, base) {
             });
         });
     }
+    if (alternates.media) {
+        Object.entries(alternates.media).forEach(([media, url]) => {
+            const urls = Array.isArray(url) ? url : [url];
+            urls.forEach((u, index) => {
+                elements.push((0, jsx_runtime_1.jsx)("link", { rel: "alternate", media: media, href: resolveUrl(u, base) || '' }, `alternate-media-${media}-${index}`));
+            });
+        });
+    }
+    if (alternates.types) {
+        Object.entries(alternates.types).forEach(([type, url]) => {
+            const urls = Array.isArray(url) ? url : [url];
+            urls.forEach((u, index) => {
+                elements.push((0, jsx_runtime_1.jsx)("link", { rel: "alternate", type: type, href: resolveUrl(u, base) || '' }, `alternate-type-${type}-${index}`));
+            });
+        });
+    }
     return elements;
 }
 /**
@@ -313,16 +406,19 @@ function generateAlternateLinks(alternates, base) {
  */
 function MetadataRenderer({ metadata, parentTemplate, }) {
     const base = metadata.metadataBase;
-    const title = resolveTitle(metadata.title, parentTemplate);
-    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [title && (0, jsx_runtime_1.jsx)("title", { children: title }), generateBasicMeta(metadata), generateAuthorMeta(metadata.authors), generateRobotsMeta(metadata.robots), generateOpenGraphMeta(metadata.openGraph, base), generateTwitterMeta(metadata.twitter), generateIconLinks(metadata.icons), generateVerificationMeta(metadata.verification), generateAlternateLinks(metadata.alternates, base), metadata.manifest && ((0, jsx_runtime_1.jsx)("link", { rel: "manifest", href: resolveUrl(metadata.manifest, base) || '' }))] }));
+    const inheritedTemplate = parentTemplate ?? (0, merge_1.resolveParentTitleTemplate)(metadata);
+    const title = resolveTitle(metadata.title, inheritedTemplate);
+    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [title && (0, jsx_runtime_1.jsx)("title", { children: title }), generateBasicMeta(metadata), generateAuthorMeta(metadata.authors), generateRobotsMeta(metadata.robots), generateOpenGraphMeta(metadata.openGraph, base), generateTwitterMeta(metadata.twitter, base), generateIconLinks(metadata.icons), generateVerificationMeta(metadata.verification), generateAlternateLinks(metadata.alternates, base), generateAppleWebAppMeta(metadata.appleWebApp), generateFormatDetectionMeta(metadata.formatDetection), generateOtherMeta(metadata.other), metadata.manifest && ((0, jsx_runtime_1.jsx)("link", { rel: "manifest", href: resolveUrl(metadata.manifest, base) || '' })), metadata.classification && ((0, jsx_runtime_1.jsx)("meta", { name: "classification", content: metadata.classification }))] }));
 }
 /**
  * Converts metadata to HTML string for SSR injection.
+ * Applies title template from merged metadata when parentTemplate is omitted.
  */
 function generateMetadataHtml(metadata, parentTemplate) {
     if (!metadata || typeof metadata !== 'object')
         return '';
     const { renderToStaticMarkup } = require('react-dom/server');
-    return renderToStaticMarkup((0, jsx_runtime_1.jsx)(MetadataRenderer, { metadata: metadata, parentTemplate: parentTemplate }));
+    const template = parentTemplate ?? (0, merge_1.resolveParentTitleTemplate)(metadata);
+    return renderToStaticMarkup((0, jsx_runtime_1.jsx)(MetadataRenderer, { metadata: metadata, parentTemplate: template }));
 }
 exports.default = MetadataRenderer;

package/dist/metadata/index.d.ts

@@ -5,3 +5,8 @@
  */
 export * from './types';
 export { MetadataRenderer, generateMetadataHtml } from './generate';
+export { deepMergeMetadata, mergeMetadataChain, resolveParentTitleTemplate } from './merge';
+export { robots, sitemap, manifest, serializeRobots, serializeSitemap, metadataRouteToResponse, MetadataRoute, } from './routes';
+export type { RobotsFile, RobotsRule, SitemapFile, SitemapEntry, ManifestFile, ManifestIcon, } from './routes';
+export { jsonLd, JsonLd } from './json-ld';
+export type { JsonLdProps } from './json-ld';

package/dist/metadata/index.js

@@ -19,8 +19,22 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateMetadataHtml = exports.MetadataRenderer = void 0;
+exports.JsonLd = exports.jsonLd = exports.metadataRouteToResponse = exports.serializeSitemap = exports.serializeRobots = exports.manifest = exports.sitemap = exports.robots = exports.resolveParentTitleTemplate = exports.mergeMetadataChain = exports.deepMergeMetadata = exports.generateMetadataHtml = exports.MetadataRenderer = void 0;
 __exportStar(require("./types"), exports);
 var generate_1 = require("./generate");
 Object.defineProperty(exports, "MetadataRenderer", { enumerable: true, get: function () { return generate_1.MetadataRenderer; } });
 Object.defineProperty(exports, "generateMetadataHtml", { enumerable: true, get: function () { return generate_1.generateMetadataHtml; } });
+var merge_1 = require("./merge");
+Object.defineProperty(exports, "deepMergeMetadata", { enumerable: true, get: function () { return merge_1.deepMergeMetadata; } });
+Object.defineProperty(exports, "mergeMetadataChain", { enumerable: true, get: function () { return merge_1.mergeMetadataChain; } });
+Object.defineProperty(exports, "resolveParentTitleTemplate", { enumerable: true, get: function () { return merge_1.resolveParentTitleTemplate; } });
+var routes_1 = require("./routes");
+Object.defineProperty(exports, "robots", { enumerable: true, get: function () { return routes_1.robots; } });
+Object.defineProperty(exports, "sitemap", { enumerable: true, get: function () { return routes_1.sitemap; } });
+Object.defineProperty(exports, "manifest", { enumerable: true, get: function () { return routes_1.manifest; } });
+Object.defineProperty(exports, "serializeRobots", { enumerable: true, get: function () { return routes_1.serializeRobots; } });
+Object.defineProperty(exports, "serializeSitemap", { enumerable: true, get: function () { return routes_1.serializeSitemap; } });
+Object.defineProperty(exports, "metadataRouteToResponse", { enumerable: true, get: function () { return routes_1.metadataRouteToResponse; } });
+var json_ld_1 = require("./json-ld");
+Object.defineProperty(exports, "jsonLd", { enumerable: true, get: function () { return json_ld_1.jsonLd; } });
+Object.defineProperty(exports, "JsonLd", { enumerable: true, get: function () { return json_ld_1.JsonLd; } });

package/dist/metadata/json-ld.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SSR-safe JSON-LD helpers for structured data.
+ */
+import * as React from 'react';
+/** Serialize structured data for embedding in a script tag. */
+export declare function jsonLd(data: unknown): string;
+export interface JsonLdProps {
+    data: unknown;
+    id?: string;
+}
+/**
+ * Renders `<script type="application/ld+json">` with XSS-safe serialization.
+ * Prefer this over hand-rolling dangerouslySetInnerHTML.
+ */
+export declare function JsonLd({ data, id }: JsonLdProps): React.ReactElement;

package/dist/metadata/json-ld.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonLd = jsonLd;
+exports.JsonLd = JsonLd;
+const jsx_runtime_1 = require("react/jsx-runtime");
+function serializeJsonLd(data) {
+    return JSON.stringify(data).replace(/</g, '\\u003c');
+}
+/** Serialize structured data for embedding in a script tag. */
+function jsonLd(data) {
+    return serializeJsonLd(data);
+}
+/**
+ * Renders `<script type="application/ld+json">` with XSS-safe serialization.
+ * Prefer this over hand-rolling dangerouslySetInnerHTML.
+ */
+function JsonLd({ data, id }) {
+    return ((0, jsx_runtime_1.jsx)("script", { id: id, type: "application/ld+json", dangerouslySetInnerHTML: { __html: serializeJsonLd(data) } }));
+}

package/dist/metadata/merge.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Next.js-compatible deep merge for Metadata objects.
+ * Nested openGraph / twitter / robots / alternates / icons merge instead of replace.
+ * Title templates inherit from parent layouts.
+ */
+import type { Metadata } from './types';
+/**
+ * Deep-merge parent layout metadata with child page/layout metadata.
+ * Child wins on scalar fields; nested objects merge.
+ */
+export declare function deepMergeMetadata(parent: Metadata | null | undefined, child: Metadata | null | undefined): Metadata;
+/** Fold a chain of metadata objects (root → … → page). */
+export declare function mergeMetadataChain(chain: Array<Metadata | null | undefined>): Metadata;
+/**
+ * Resolve the active title template string from merged metadata (for generateMetadataHtml).
+ */
+export declare function resolveParentTitleTemplate(metadata: Metadata | null | undefined): string | undefined;

package/dist/metadata/merge.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * Next.js-compatible deep merge for Metadata objects.
+ * Nested openGraph / twitter / robots / alternates / icons merge instead of replace.
+ * Title templates inherit from parent layouts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepMergeMetadata = deepMergeMetadata;
+exports.mergeMetadataChain = mergeMetadataChain;
+exports.resolveParentTitleTemplate = resolveParentTitleTemplate;
+const types_1 = require("./types");
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) && !(value instanceof URL);
+}
+function mergeTitle(parent, child) {
+    if (child === null)
+        return null;
+    if (child === undefined)
+        return parent;
+    const parentTemplate = (0, types_1.isTemplateString)(parent) && parent.template
+        ? parent.template
+        : typeof parent === 'object' && parent && 'template' in parent
+            ? parent.template
+            : undefined;
+    if (typeof child === 'string') {
+        if (parentTemplate) {
+            return { default: child, template: parentTemplate };
+        }
+        return child;
+    }
+    if ((0, types_1.isTemplateString)(child)) {
+        if (child.absolute) {
+            return {
+                absolute: child.absolute,
+                default: child.default ?? child.absolute,
+                template: child.template ?? parentTemplate,
+            };
+        }
+        return {
+            default: child.default ?? '',
+            absolute: child.absolute,
+            template: child.template ?? parentTemplate,
+        };
+    }
+    return child;
+}
+function mergeRobots(parent, child) {
+    if (child === null)
+        return null;
+    if (child === undefined)
+        return parent;
+    if (typeof child === 'string' || typeof parent === 'string')
+        return child;
+    if (!parent || typeof parent !== 'object')
+        return child;
+    const merged = { ...parent, ...child };
+    if (isPlainObject(parent.googleBot) && isPlainObject(child.googleBot)) {
+        merged.googleBot = { ...parent.googleBot, ...child.googleBot };
+    }
+    return merged;
+}
+function mergeOpenGraph(parent, child) {
+    if (child === null)
+        return null;
+    if (child === undefined)
+        return parent;
+    if (!parent)
+        return child;
+    return { ...parent, ...child };
+}
+function mergeTwitter(parent, child) {
+    if (child === null)
+        return null;
+    if (child === undefined)
+        return parent;
+    if (!parent)
+        return child;
+    return { ...parent, ...child };
+}
+function mergeIcons(parent, child) {
+    if (child === null)
+        return null;
+    if (child === undefined)
+        return parent;
+    if (!parent || typeof parent !== 'object' || Array.isArray(parent) || parent instanceof URL) {
+        return child;
+    }
+    if (!child || typeof child !== 'object' || Array.isArray(child) || child instanceof URL) {
+        return child;
+    }
+    if ('url' in child)
+        return child;
+    return { ...parent, ...child };
+}
+function mergeAlternates(parent, child) {
+    if (child === null)
+        return null;
+    if (child === undefined)
+        return parent;
+    if (!parent)
+        return child;
+    return {
+        ...parent,
+        ...child,
+        languages: { ...(parent.languages || {}), ...(child.languages || {}) },
+        media: { ...(parent.media || {}), ...(child.media || {}) },
+        types: { ...(parent.types || {}), ...(child.types || {}) },
+    };
+}
+/**
+ * Deep-merge parent layout metadata with child page/layout metadata.
+ * Child wins on scalar fields; nested objects merge.
+ */
+function deepMergeMetadata(parent, child) {
+    const base = parent && typeof parent === 'object' ? { ...parent } : {};
+    if (!child || typeof child !== 'object')
+        return base;
+    const next = { ...base, ...child };
+    next.title = mergeTitle(base.title, child.title);
+    next.robots = mergeRobots(base.robots, child.robots);
+    next.openGraph = mergeOpenGraph(base.openGraph, child.openGraph);
+    next.twitter = mergeTwitter(base.twitter, child.twitter);
+    next.icons = mergeIcons(base.icons, child.icons);
+    next.alternates = mergeAlternates(base.alternates, child.alternates);
+    if (isPlainObject(base.other) || isPlainObject(child.other)) {
+        next.other = { ...(base.other || {}), ...(child.other || {}) };
+    }
+    if (isPlainObject(base.verification) || isPlainObject(child.verification)) {
+        next.verification = { ...(base.verification || {}), ...(child.verification || {}) };
+    }
+    if (isPlainObject(base.formatDetection) || isPlainObject(child.formatDetection)) {
+        next.formatDetection = { ...(base.formatDetection || {}), ...(child.formatDetection || {}) };
+    }
+    if ((isPlainObject(base.appleWebApp) || typeof base.appleWebApp === 'boolean') &&
+        (isPlainObject(child.appleWebApp) || typeof child.appleWebApp === 'boolean')) {
+        if (typeof child.appleWebApp === 'boolean' || typeof base.appleWebApp === 'boolean') {
+            next.appleWebApp = child.appleWebApp !== undefined ? child.appleWebApp : base.appleWebApp;
+        }
+        else {
+            next.appleWebApp = { ...base.appleWebApp, ...child.appleWebApp };
+        }
+    }
+    if (base.metadataBase && child.metadataBase === undefined) {
+        next.metadataBase = base.metadataBase;
+    }
+    return next;
+}
+/** Fold a chain of metadata objects (root → … → page). */
+function mergeMetadataChain(chain) {
+    return chain.reduce((acc, item) => deepMergeMetadata(acc, item), {});
+}
+/**
+ * Resolve the active title template string from merged metadata (for generateMetadataHtml).
+ */
+function resolveParentTitleTemplate(metadata) {
+    if (!metadata?.title)
+        return undefined;
+    if ((0, types_1.isTemplateString)(metadata.title))
+        return metadata.title.template;
+    return undefined;
+}

package/dist/metadata/routes.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Next-compatible MetadataRoute helpers for robots.txt, sitemap.xml, and web manifests.
+ */
+export type RobotsRule = {
+    userAgent?: string | string[];
+    allow?: string | string[];
+    disallow?: string | string[];
+    crawlDelay?: number;
+    other?: Record<string, string | number | Array<string | number>>;
+};
+export type RobotsFile = {
+    rules: RobotsRule | RobotsRule[];
+    sitemap?: string | string[];
+    host?: string;
+};
+export type SitemapEntry = {
+    url: string;
+    lastModified?: string | Date;
+    changeFrequency?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+    priority?: number;
+    alternates?: {
+        languages?: Record<string, string>;
+    };
+    images?: string[];
+    videos?: Array<{
+        title: string;
+        thumbnail_loc: string;
+        description: string;
+    }>;
+};
+export type SitemapFile = SitemapEntry[];
+export type ManifestIcon = {
+    src: string;
+    sizes?: string;
+    type?: string;
+    purpose?: string;
+};
+export type ManifestFile = {
+    name?: string;
+    short_name?: string;
+    description?: string;
+    start_url?: string;
+    display?: 'fullscreen' | 'standalone' | 'minimal-ui' | 'browser';
+    background_color?: string;
+    theme_color?: string;
+    icons?: ManifestIcon[];
+    [key: string]: unknown;
+};
+/** Namespace mirroring Next.js `MetadataRoute`. */
+export declare namespace MetadataRoute {
+    type Robots = RobotsFile;
+    type Sitemap = SitemapFile;
+    type Manifest = ManifestFile;
+}
+/** Serialize a Robots object to robots.txt body text. */
+export declare function serializeRobots(data: RobotsFile): string;
+/** Serialize sitemap entries to XML. */
+export declare function serializeSitemap(entries: SitemapFile): string;
+/** Build a robots.txt Response. */
+export declare function robots(data: RobotsFile): Response;
+/** Build a sitemap.xml Response. */
+export declare function sitemap(entries: SitemapFile): Response;
+/** Build a webmanifest JSON Response. */
+export declare function manifest(data: ManifestFile): Response;
+/** Convert a MetadataRoute default-export payload into a Response. */
+export declare function metadataRouteToResponse(stem: 'robots' | 'sitemap' | 'manifest', payload: unknown): Response | null;