@wular/pnext 0.0.4 → 0.0.7

package/src/render/metadata.ts

@@ -10,58 +10,58 @@ import type {
   ResourceHint,
   MetadataTwitter,
   Viewport,
-} from '../types';
+} from '../types'
 import {
   metadataHasOwnImages,
   staticMetadataLink,
   type StaticMetadataForPath,
-} from '../routing/metadata';
-import { escapeHtml, stringifyHtmlValue } from '../utils/html';
-import { getTrailingSlashUrls, withBasePath } from '../routing/href';
+} from '../routing/metadata-files'
+import { escapeHtml, stringifyHtmlValue } from '../utils/html'
+import { getTrailingSlashUrls, withBasePath } from '../routing/href'
 
-export type MetadataExport = Metadata | (() => Metadata | Promise<Metadata>);
+export type MetadataExport = Metadata | (() => Metadata | Promise<Metadata>)
 
-export type ViewportExport = Viewport | (() => Viewport | Promise<Viewport>);
+export type ViewportExport = Viewport | (() => Viewport | Promise<Viewport>)
 
 export interface MetadataEntry {
-  metadata: Metadata;
-  dir?: string;
-  kind?: 'layout' | 'page';
-  root?: boolean;
+  metadata: Metadata
+  dir?: string
+  kind?: 'layout' | 'page'
+  root?: boolean
 }
 
 export interface MetadataContext {
-  url?: URL;
-  metadataBase?: URL;
+  url?: URL
+  metadataBase?: URL
 }
 
 export interface MetadataRenderPage {
-  metadata: Metadata;
-  metadataUrl?: string;
-  fontPreloads: MetadataLink[];
-  resourceHints?: ResourceHint[];
-  stylesheets: StylesheetLink[];
-  modulePreloads?: string[];
-  dynamicScriptPreloads?: string[];
-  staticMetadata?: StaticMetadataForPath;
-  suppressIconLinks?: boolean;
+  metadata: Metadata
+  metadataUrl?: string
+  fontPreloads: MetadataLink[]
+  resourceHints?: ResourceHint[]
+  stylesheets: StylesheetLink[]
+  modulePreloads?: string[]
+  dynamicScriptPreloads?: string[]
+  staticMetadata?: StaticMetadataForPath
+  suppressIconLinks?: boolean
 }
 
 export interface StylesheetLink {
-  url: string | string[];
-  dataPrecedence?: string;
+  url: string | string[]
+  dataPrecedence?: string
 }
 
 export function metadataContext(page: MetadataRenderPage): MetadataContext {
-  const url = page.metadataUrl ? new URL(page.metadataUrl) : undefined;
+  const url = page.metadataUrl ? new URL(page.metadataUrl) : undefined
   return {
     url,
     metadataBase: coerceMetadataBase(page.metadata.metadataBase, url),
-  };
+  }
 }
 
 export function headLinks(page: MetadataRenderPage, context: MetadataContext) {
-  const canonical = coerceCanonical(page.metadata.alternates, context);
+  const canonical = coerceCanonical(page.metadata.alternates, context)
   const links: (MetadataLink | ResourceHint)[] = [
     ...page.fontPreloads,
     ...(page.resourceHints ?? []),
@@ -85,8 +85,8 @@ export function headLinks(page: MetadataRenderPage, context: MetadataContext) {
     ...appleStartupLinks(page.metadata.appleWebApp, context),
     ...coerceIcons(page.metadata.icons, context),
     ...(page.metadata.links ?? []),
-  ];
-  return links.map(link => `    <link ${linkAttrs(link)}/>`).join('\n');
+  ]
+  return links.map(link => `    <link ${linkAttrs(link)}/>`).join('\n')
 }
 
 function stylesheetLinks(stylesheets: StylesheetLink[]): MetadataLink[] {
@@ -96,25 +96,25 @@ function stylesheetLinks(stylesheets: StylesheetLink[]): MetadataLink[] {
       url: href,
       ...(dataPrecedence ? { dataPrecedence } : {}),
     })),
-  );
+  )
 }
 
 export function metadataIconLinks(metadata: Metadata, context: MetadataContext, indent = '    ') {
   return coerceIcons(metadata.icons, context)
     .map(link => `${indent}<link ${linkAttrs(link)}/>`)
-    .join('\n');
+    .join('\n')
 }
 
 function staticMetadataLinks(page: MetadataRenderPage): MetadataLink[] {
-  const metadata = page.staticMetadata;
-  if (!metadata) return [];
-  const hasExplicitIcons = page.metadata.icons !== undefined;
-  const hasExplicitManifest = page.metadata.manifest !== undefined;
+  const metadata = page.staticMetadata
+  if (!metadata) return []
+  const hasExplicitIcons = page.metadata.icons !== undefined
+  const hasExplicitManifest = page.metadata.manifest !== undefined
   if (page.suppressIconLinks) {
     return prefixLinks([
       ...(!hasExplicitManifest && metadata.manifestLink ? [metadata.manifestLink] : []),
       ...(!hasExplicitManifest && metadata.manifest ? [staticMetadataLink(metadata.manifest)] : []),
-    ]);
+    ])
   }
   return prefixLinks([
     ...(metadata.favicon ? [staticMetadataLink(metadata.favicon)] : []),
@@ -127,25 +127,25 @@ function staticMetadataLinks(page: MetadataRenderPage): MetadataLink[] {
     ...(!hasExplicitIcons && metadata.icons.length === 0
       ? metadata.rootIcons.map(staticMetadataLink)
       : []),
-  ]);
+  ])
 }
 
 // File-convention metadata assets (favicon, icons, manifest, ...) are served
 // under the configured basePath, so their hrefs carry the prefix. A no-basePath
 // app leaves every href untouched (withBasePath is a no-op).
 function prefixLinks(links: MetadataLink[]): MetadataLink[] {
-  return links.map(link => ({ ...link, url: withBasePath(link.url) }));
+  return links.map(link => ({ ...link, url: withBasePath(link.url) }))
 }
 
 export function applyStaticMetadata(
   metadata: Metadata,
   staticMetadata: StaticMetadataForPath,
 ): Metadata {
-  let next = metadata;
+  let next = metadata
   const openGraphImages = [
     ...(staticMetadata.openGraphImage ? [staticMetadata.openGraphImage] : []),
     ...(staticMetadata.dynamicOpenGraphImages ?? []),
-  ].map(prefixImageBasePath);
+  ].map(prefixImageBasePath)
   if (openGraphImages.length > 0 && !metadataHasOwnImages(metadata, 'openGraph')) {
     next = {
       ...next,
@@ -153,12 +153,12 @@ export function applyStaticMetadata(
         ...(next.openGraph ?? {}),
         images: openGraphImages.length === 1 ? openGraphImages[0] : openGraphImages,
       },
-    };
+    }
   }
   const twitterImages = [
     ...(staticMetadata.twitterImage ? [staticMetadata.twitterImage] : []),
     ...(staticMetadata.dynamicTwitterImages ?? []),
-  ].map(prefixImageBasePath);
+  ].map(prefixImageBasePath)
   if (twitterImages.length > 0 && !metadataHasOwnImages(metadata, 'twitter')) {
     next = {
       ...next,
@@ -166,9 +166,9 @@ export function applyStaticMetadata(
         ...(next.twitter ?? {}),
         images: twitterImages.length === 1 ? twitterImages[0] : twitterImages,
       },
-    };
+    }
   }
-  return next;
+  return next
 }
 
 // File-convention og/twitter images resolve to a root-relative asset path
@@ -176,153 +176,153 @@ export function applyStaticMetadata(
 // served with that prefix, so the href carries it. String/URL images and a
 // no-basePath app are left untouched.
 function prefixImageBasePath(image: MetadataImage): MetadataImage {
-  if (typeof image === 'string') return withBasePath(image);
-  if (image instanceof URL) return image;
+  if (typeof image === 'string') return withBasePath(image)
+  if (image instanceof URL) return image
   if (typeof image === 'object' && image !== null && typeof image.url === 'string') {
-    return { ...image, url: withBasePath(image.url) };
+    return { ...image, url: withBasePath(image.url) }
   }
-  return image;
+  return image
 }
 
 // Emits the common metadata <meta> tags. Every value passes through
 // escapeHtml (which itself coerces via String()), so no value shape can throw.
 export function metadataTags(metadata: Metadata, context: MetadataContext): string {
-  const meta = metadata;
-  const tags: string[] = [];
+  const meta = metadata
+  const tags: string[] = []
   const push = (name: string, content: string | undefined) => {
-    if (content) tags.push(`<meta name="${escapeHtml(name)}" content="${escapeHtml(content)}"/>`);
-  };
+    if (content) tags.push(`<meta name="${escapeHtml(name)}" content="${escapeHtml(content)}"/>`)
+  }
   const pushProperty = (property: string, content: string | undefined) => {
     if (content)
-      tags.push(`<meta property="${escapeHtml(property)}" content="${escapeHtml(content)}"/>`);
-  };
-
-  push('description', meta.description);
-  push('keywords', coerceKeywords(meta.keywords));
-  for (const author of coerceAuthors(meta.authors)) push('author', author);
-  push('generator', meta.generator);
-  push('application-name', meta.applicationName);
-  push('referrer', meta.referrer);
-  push('creator', meta.creator);
-  push('publisher', meta.publisher);
-  push('robots', coerceRobots(meta.robots));
+      tags.push(`<meta property="${escapeHtml(property)}" content="${escapeHtml(content)}"/>`)
+  }
+
+  push('description', meta.description)
+  push('keywords', coerceKeywords(meta.keywords))
+  for (const author of coerceAuthors(meta.authors)) push('author', author)
+  push('generator', meta.generator)
+  push('application-name', meta.applicationName)
+  push('referrer', meta.referrer)
+  push('creator', meta.creator)
+  push('publisher', meta.publisher)
+  push('robots', coerceRobots(meta.robots))
   push(
     'googlebot',
     coerceRobots(isRecord(meta.robots) ? (meta.robots.googleBot as MetadataRobots) : undefined),
-  );
-  push('format-detection', coerceFormatDetection(meta.formatDetection));
-  for (const [name, value] of verificationTags(meta.verification)) push(name, value);
-  for (const value of list(meta.verification?.other?.me)) push('me', value);
+  )
+  push('format-detection', coerceFormatDetection(meta.formatDetection))
+  for (const [name, value] of verificationTags(meta.verification)) push(name, value)
+  for (const value of list(meta.verification?.other?.me)) push('me', value)
   for (const [name, values] of Object.entries(meta.other ?? {})) {
-    for (const value of list(values)) push(name, value);
+    for (const value of list(values)) push(name, value)
   }
-  const itunes = itunesContent(meta.itunes);
-  push('apple-itunes-app', itunes);
-  const apple = meta.appleWebApp;
+  const itunes = itunesContent(meta.itunes)
+  push('apple-itunes-app', itunes)
+  const apple = meta.appleWebApp
   if (apple) {
-    push('mobile-web-app-capable', appleWebAppCapable(apple) ? 'yes' : undefined);
+    push('mobile-web-app-capable', appleWebAppCapable(apple) ? 'yes' : undefined)
     if (typeof apple === 'object') {
-      push('apple-mobile-web-app-title', apple.title);
-      push('apple-mobile-web-app-status-bar-style', apple.statusBarStyle);
+      push('apple-mobile-web-app-title', apple.title)
+      push('apple-mobile-web-app-status-bar-style', apple.statusBarStyle)
     }
   }
-  if (meta.facebook?.appId) pushProperty('fb:app_id', meta.facebook.appId);
-  for (const admin of list(meta.facebook?.admins)) pushProperty('fb:admins', admin);
+  if (meta.facebook?.appId) pushProperty('fb:app_id', meta.facebook.appId)
+  for (const admin of list(meta.facebook?.admins)) pushProperty('fb:admins', admin)
   if (meta.pinterest?.richPin !== undefined) {
-    pushProperty('pinterest-rich-pin', meta.pinterest.richPin ? 'true' : 'false');
+    pushProperty('pinterest-rich-pin', meta.pinterest.richPin ? 'true' : 'false')
   }
-  for (const [property, value] of appLinkTags(meta.appLinks)) pushProperty(property, value);
+  for (const [property, value] of appLinkTags(meta.appLinks)) pushProperty(property, value)
 
-  tags.push(...openGraphTags(meta.openGraph, context));
-  tags.push(...twitterTags(meta.twitter ?? twitterFromOpenGraph(meta.openGraph), context));
+  tags.push(...openGraphTags(meta.openGraph, context))
+  tags.push(...twitterTags(meta.twitter ?? twitterFromOpenGraph(meta.openGraph), context))
 
-  return tags.join('\n    ');
+  return tags.join('\n    ')
 }
 
 function openGraphTags(og: MetadataOpenGraph | undefined, context: MetadataContext): string[] {
-  if (!og) return [];
-  const tags: string[] = [];
+  if (!og) return []
+  const tags: string[] = []
   const push = (property: string, content: string | undefined) => {
     if (content)
-      tags.push(`<meta property="${escapeHtml(property)}" content="${escapeHtml(content)}"/>`);
-  };
-  push('og:title', og.title === undefined ? undefined : resolveTitleChain([{ title: og.title }]));
-  push('og:description', og.description);
-  push('og:url', og.url === undefined ? undefined : resolveMetadataUrl(og.url, context));
-  push('og:site_name', og.siteName);
-  push('og:locale', og.locale);
-  push('og:type', og.type);
+      tags.push(`<meta property="${escapeHtml(property)}" content="${escapeHtml(content)}"/>`)
+  }
+  push('og:title', og.title === undefined ? undefined : resolveTitleChain([{ title: og.title }]))
+  push('og:description', og.description)
+  push('og:url', og.url === undefined ? undefined : resolveMetadataUrl(og.url, context))
+  push('og:site_name', og.siteName)
+  push('og:locale', og.locale)
+  push('og:type', og.type)
   for (const image of coerceImages(og.images, context)) {
-    push('og:image', image.url);
-    push('og:image:secure_url', image.secureUrl);
-    push('og:image:width', image.width);
-    push('og:image:height', image.height);
-    push('og:image:alt', image.alt);
-    push('og:image:type', image.type);
+    push('og:image', image.url)
+    push('og:image:secure_url', image.secureUrl)
+    push('og:image:width', image.width)
+    push('og:image:height', image.height)
+    push('og:image:alt', image.alt)
+    push('og:image:type', image.type)
   }
   for (const video of coerceImages(og.videos, context)) {
-    push('og:video', video.url);
-    push('og:video:width', video.width);
-    push('og:video:height', video.height);
+    push('og:video', video.url)
+    push('og:video:width', video.width)
+    push('og:video:height', video.height)
   }
-  for (const audio of coerceImages(og.audio, context)) push('og:audio', audio.url);
-  push('article:published_time', og.publishedTime);
-  for (const author of list(og.authors)) push('article:author', author);
-  for (const email of list(og.emails)) push('og:email', email);
-  for (const phone of list(og.phoneNumbers)) push('og:phone_number', phone);
-  for (const fax of list(og.faxNumbers)) push('og:fax_number', fax);
-  return tags;
+  for (const audio of coerceImages(og.audio, context)) push('og:audio', audio.url)
+  push('article:published_time', og.publishedTime)
+  for (const author of list(og.authors)) push('article:author', author)
+  for (const email of list(og.emails)) push('og:email', email)
+  for (const phone of list(og.phoneNumbers)) push('og:phone_number', phone)
+  for (const fax of list(og.faxNumbers)) push('og:fax_number', fax)
+  return tags
 }
 
 function twitterTags(twitter: MetadataTwitter | undefined, context: MetadataContext): string[] {
-  if (!twitter) return [];
-  const tags: string[] = [];
+  if (!twitter) return []
+  const tags: string[] = []
   const push = (name: string, content: string | undefined) => {
-    if (content) tags.push(`<meta name="${escapeHtml(name)}" content="${escapeHtml(content)}"/>`);
-  };
-  push('twitter:card', twitterCard(twitter));
-  push('twitter:site', twitter.site);
-  push('twitter:site:id', twitter.siteId);
-  push('twitter:creator', twitter.creator);
-  push('twitter:creator:id', twitter.creatorId);
+    if (content) tags.push(`<meta name="${escapeHtml(name)}" content="${escapeHtml(content)}"/>`)
+  }
+  push('twitter:card', twitterCard(twitter))
+  push('twitter:site', twitter.site)
+  push('twitter:site:id', twitter.siteId)
+  push('twitter:creator', twitter.creator)
+  push('twitter:creator:id', twitter.creatorId)
   push(
     'twitter:title',
     twitter.title === undefined ? undefined : resolveTitleChain([{ title: twitter.title }]),
-  );
-  push('twitter:description', twitter.description);
+  )
+  push('twitter:description', twitter.description)
   for (const image of coerceImages(twitter.images, context)) {
-    push('twitter:image', image.url);
-    push('twitter:image:secure_url', image.secureUrl);
-    push('twitter:image:width', image.width);
-    push('twitter:image:height', image.height);
-    push('twitter:image:alt', image.alt);
-    push('twitter:image:type', image.type);
+    push('twitter:image', image.url)
+    push('twitter:image:secure_url', image.secureUrl)
+    push('twitter:image:width', image.width)
+    push('twitter:image:height', image.height)
+    push('twitter:image:alt', image.alt)
+    push('twitter:image:type', image.type)
   }
-  push('twitter:player', resolveMetadataUrl(twitter.players?.playerUrl, context));
-  push('twitter:player:stream', resolveMetadataUrl(twitter.players?.streamUrl, context));
-  push('twitter:player:width', coerceString(twitter.players?.width) || undefined);
-  push('twitter:player:height', coerceString(twitter.players?.height) || undefined);
+  push('twitter:player', resolveMetadataUrl(twitter.players?.playerUrl, context))
+  push('twitter:player:stream', resolveMetadataUrl(twitter.players?.streamUrl, context))
+  push('twitter:player:width', coerceString(twitter.players?.width) || undefined)
+  push('twitter:player:height', coerceString(twitter.players?.height) || undefined)
   for (const [device, id] of Object.entries(twitter.app?.id ?? {})) {
-    push(`twitter:app:id:${device}`, id);
+    push(`twitter:app:id:${device}`, id)
   }
   for (const [device, url] of Object.entries(twitter.app?.url ?? {})) {
-    push(`twitter:app:url:${device}`, resolveMetadataUrl(url, context));
+    push(`twitter:app:url:${device}`, resolveMetadataUrl(url, context))
   }
-  return tags;
+  return tags
 }
 
 // theme-color: string | { color, media } | array of those.
 export function themeColorTags(value: Viewport['themeColor']): string {
-  if (value === undefined) return '';
-  const list = Array.isArray(value) ? value : [value];
+  if (value === undefined) return ''
+  const list = Array.isArray(value) ? value : [value]
   return list
     .map(entry => {
       if (typeof entry === 'string')
-        return `<meta name="theme-color" content="${escapeHtml(entry)}"/>`;
-      const media = entry.media ? ` media="${escapeHtml(entry.media)}"` : '';
-      return `<meta name="theme-color"${media} content="${escapeHtml(entry.color)}"/>`;
+        return `<meta name="theme-color" content="${escapeHtml(entry)}"/>`
+      const media = entry.media ? ` media="${escapeHtml(entry.media)}"` : ''
+      return `<meta name="theme-color"${media} content="${escapeHtml(entry.color)}"/>`
     })
-    .join('\n    ');
+    .join('\n    ')
 }
 
 function linkAttrs(link: MetadataLink | ResourceHint) {
@@ -341,12 +341,12 @@ function linkAttrs(link: MetadataLink | ResourceHint) {
     ['nonce', link.nonce],
   ]
     .filter((attr): attr is [string, string] => typeof attr[1] === 'string')
-    .map(([key, value]) => `${key}="${escapeHtml(value)}"`);
-  const attributes = 'attributes' in link ? link.attributes : undefined;
+    .map(([key, value]) => `${key}="${escapeHtml(value)}"`)
+  const attributes = 'attributes' in link ? link.attributes : undefined
   for (const [key, value] of Object.entries(attributes ?? {})) {
-    attrs.push(`${escapeHtml(key)}="${escapeHtml(value)}"`);
+    attrs.push(`${escapeHtml(key)}="${escapeHtml(value)}"`)
   }
-  return attrs.join(' ');
+  return attrs.join(' ')
 }
 
 export function viewportContent(viewport: Viewport) {
@@ -364,34 +364,34 @@ export function viewportContent(viewport: Viewport) {
     ],
     ['viewport-fit', viewport.viewportFit],
     ['interactive-widget', viewport.interactiveWidget],
-  ];
+  ]
 
   return entries
     .filter((entry): entry is [string, string | number | boolean] => entry[1] !== undefined)
     .map(([key, value]) => `${key}=${value}`)
-    .join(', ');
+    .join(', ')
 }
 
 // Core metadata is static for a route render: object exports are read as-is and
 // function exports run without request data. Compat registers the Next
 // generateMetadata/generateViewport resolver separately.
 export async function readModuleMetadata(module: {
-  metadata?: MetadataExport;
+  metadata?: MetadataExport
 }): Promise<Metadata | undefined> {
-  return typeof module.metadata === 'function' ? module.metadata() : module.metadata;
+  return typeof module.metadata === 'function' ? module.metadata() : module.metadata
 }
 
 export async function readModuleViewport(module: {
-  viewport?: ViewportExport;
+  viewport?: ViewportExport
 }): Promise<Viewport | undefined> {
-  return typeof module.viewport === 'function' ? module.viewport() : module.viewport;
+  return typeof module.viewport === 'function' ? module.viewport() : module.viewport
 }
 
 export function mergeMetadataEntries(
   ...entryGroups: (MetadataEntry | MetadataEntry[])[]
 ): Metadata {
-  const entries = entryGroups.flat();
-  const items = entries.map(entry => entry.metadata);
+  const entries = entryGroups.flat()
+  const items = entries.map(entry => entry.metadata)
   const merged = items.reduce<Metadata>(
     (metadata, item) => ({
       ...metadata,
@@ -400,41 +400,41 @@ export function mergeMetadataEntries(
       links: [...(metadata.links ?? []), ...(item.links ?? [])],
     }),
     {},
-  );
-  merged.title = resolveTitleEntries(entries);
-  return merged;
+  )
+  merged.title = resolveTitleEntries(entries)
+  return merged
 }
 
 function mergeIcons(base: Metadata['icons'], next: Metadata['icons']): Metadata['icons'] {
-  if (next === undefined) return base;
-  if (Array.isArray(base) && Array.isArray(next)) return [...base, ...next];
-  return next;
+  if (next === undefined) return base
+  if (Array.isArray(base) && Array.isArray(next)) return [...base, ...next]
+  return next
 }
 
 interface TitleTemplateState {
-  template: string | null;
-  previous: string | null;
-  dir?: string;
-  root?: boolean;
+  template: string | null
+  previous: string | null
+  dir?: string
+  root?: boolean
 }
 
 function resolveTitleEntries(entries: MetadataEntry[]): string | undefined {
-  let template: TitleTemplateState = { template: null, previous: null };
-  let resolved: string | undefined;
+  let template: TitleTemplateState = { template: null, previous: null }
+  let resolved: string | undefined
 
   for (const entry of entries) {
-    const title = entry.metadata.title;
-    if (title === undefined) continue;
+    const title = entry.metadata.title
+    if (title === undefined) continue
     const activeTemplate =
       entry.kind === 'page' && entry.dir && entry.dir === template.dir && !template.root
         ? template.previous
-        : template.template;
+        : template.template
 
     if (typeof title === 'object' && title !== null) {
       if (typeof title.absolute === 'string') {
-        resolved = title.absolute;
+        resolved = title.absolute
       } else if (typeof title.default === 'string') {
-        resolved = applyTitleTemplate(activeTemplate, title.default);
+        resolved = applyTitleTemplate(activeTemplate, title.default)
       }
       if ('template' in title) {
         template = {
@@ -442,68 +442,68 @@ function resolveTitleEntries(entries: MetadataEntry[]): string | undefined {
           previous: activeTemplate,
           dir: entry.dir,
           root: entry.root,
-        };
+        }
       }
     } else {
-      resolved = applyTitleTemplate(activeTemplate, coerceString(title));
+      resolved = applyTitleTemplate(activeTemplate, coerceString(title))
     }
   }
-  return resolved;
+  return resolved
 }
 
 // Walks the chain root->page tracking the last-seen template. A child's plain
 // string title is wrapped by the nearest ancestor template; an `absolute`
 // bypasses the template; a `default` supplies a title when the child has none.
 function resolveTitleChain(items: Metadata[]): string | undefined {
-  return resolveTitleEntries(items.map(metadata => ({ metadata })));
+  return resolveTitleEntries(items.map(metadata => ({ metadata })))
 }
 
 function applyTitleTemplate(template: string | null, value: string): string {
-  return template ? template.replace('%s', value) : value;
+  return template ? template.replace('%s', value) : value
 }
 
 // Coerces any metadata scalar (string | number | URL | unknown) into a string.
 // Numbers go through String(); undefined/null collapse to ''. This is the guard
 // that keeps emission from ever crashing on an unexpected value shape.
 export function coerceString(value: unknown): string {
-  return stringifyHtmlValue(value);
+  return stringifyHtmlValue(value)
 }
 
 // keywords: string | number | Array -> comma-joined string.
 function coerceKeywords(value: Metadata['keywords']): string | undefined {
-  const list = normalizeKeywordList(value);
-  if (list === undefined) return undefined;
-  const joined = list.map(coerceString).filter(Boolean).join(',');
-  return joined || undefined;
+  const list = normalizeKeywordList(value)
+  if (list === undefined) return undefined
+  const joined = list.map(coerceString).filter(Boolean).join(',')
+  return joined || undefined
 }
 
 function normalizeKeywordList(value: Metadata['keywords']): (string | number)[] | undefined {
-  if (value === undefined) return undefined;
-  return Array.isArray(value) ? value : [value];
+  if (value === undefined) return undefined
+  return Array.isArray(value) ? value : [value]
 }
 
 // authors -> list of display names for meta[name=author].
 function coerceAuthors(value: Metadata['authors']): string[] {
-  if (value === undefined) return [];
-  const list = Array.isArray(value) ? value : [value];
+  if (value === undefined) return []
+  const list = Array.isArray(value) ? value : [value]
   return list
     .map(author => (typeof author === 'string' ? author : author.name))
     .map(name => coerceString(name))
-    .filter(Boolean);
+    .filter(Boolean)
 }
 
 // robots: string passthrough, or object -> "index, follow, noarchive" style.
 function coerceRobots(value: Metadata['robots']): string | undefined {
-  if (value === undefined) return undefined;
-  if (typeof value === 'string') return value;
-  const flags: string[] = [];
-  const r = value;
-  if (r.index !== undefined) flags.push(r.index ? 'index' : 'noindex');
-  if (r.follow !== undefined) flags.push(r.follow ? 'follow' : 'nofollow');
-  if (r.noarchive) flags.push('noarchive');
-  if (r.nosnippet) flags.push('nosnippet');
-  if (r.noimageindex) flags.push('noimageindex');
-  if (r.nocache) flags.push('nocache');
+  if (value === undefined) return undefined
+  if (typeof value === 'string') return value
+  const flags: string[] = []
+  const r = value
+  if (r.index !== undefined) flags.push(r.index ? 'index' : 'noindex')
+  if (r.follow !== undefined) flags.push(r.follow ? 'follow' : 'nofollow')
+  if (r.noarchive) flags.push('noarchive')
+  if (r.nosnippet) flags.push('nosnippet')
+  if (r.noimageindex) flags.push('noimageindex')
+  if (r.nocache) flags.push('nocache')
   for (const [key, item] of Object.entries(r)) {
     if (
       item === undefined ||
@@ -516,36 +516,36 @@ function coerceRobots(value: Metadata['robots']): string | undefined {
       key === 'nocache' ||
       key === 'googleBot'
     ) {
-      continue;
+      continue
     }
-    if (item === true) flags.push(key);
-    else flags.push(`${key}:${String(item)}`);
+    if (item === true) flags.push(key)
+    else flags.push(`${key}:${String(item)}`)
   }
-  return flags.length ? flags.join(', ') : undefined;
+  return flags.length ? flags.join(', ') : undefined
 }
 
 interface ResolvedImage {
-  url: string;
-  secureUrl?: string;
-  width?: string;
-  height?: string;
-  alt?: string;
-  type?: string;
+  url: string
+  secureUrl?: string
+  width?: string
+  height?: string
+  alt?: string
+  type?: string
 }
 
 function coerceImages(
   value: MetadataImage | MetadataImage[] | undefined,
   context: MetadataContext,
 ): ResolvedImage[] {
-  if (value === undefined) return [];
-  const list = Array.isArray(value) ? value : [value];
+  if (value === undefined) return []
+  const list = Array.isArray(value) ? value : [value]
   return list
     .map((image): ResolvedImage | undefined => {
       if (typeof image === 'string')
-        return { url: resolveMetadataUrl(image, context, true) ?? image };
-      if (image instanceof URL) return { url: image.href };
+        return { url: resolveMetadataUrl(image, context, true) ?? image }
+      if (image instanceof URL) return { url: image.href }
       if (typeof image === 'object' && image !== null && 'url' in image) {
-        const img = image;
+        const img = image
         return {
           url: resolveMetadataUrl(img.url, context, true) ?? coerceString(img.url),
           secureUrl: resolveMetadataUrl(img.secureUrl, context, true),
@@ -553,36 +553,36 @@ function coerceImages(
           height: img.height === undefined ? undefined : coerceString(img.height),
           alt: img.alt,
           type: img.type,
-        };
+        }
       }
-      return undefined;
+      return undefined
     })
-    .filter((image): image is ResolvedImage => image !== undefined && Boolean(image.url));
+    .filter((image): image is ResolvedImage => image !== undefined && Boolean(image.url))
 }
 
 function coerceCanonical(
   value: Metadata['alternates'],
   context: MetadataContext,
 ): string | undefined {
-  const canonical = value?.canonical;
-  if (canonical === undefined) return undefined;
-  if (typeof canonical === 'string') return resolveMetadataUrl(canonical, context);
-  if (canonical instanceof URL) return canonical.href;
+  const canonical = value?.canonical
+  if (canonical === undefined) return undefined
+  if (typeof canonical === 'string') return resolveMetadataUrl(canonical, context)
+  if (canonical instanceof URL) return canonical.href
   if (typeof canonical === 'object' && 'url' in canonical)
-    return resolveMetadataUrl(canonical.url, context);
-  return undefined;
+    return resolveMetadataUrl(canonical.url, context)
+  return undefined
 }
 
 function coerceMetadataBase(value: Metadata['metadataBase'], url?: URL): URL | undefined {
-  if (value instanceof URL) return value;
+  if (value instanceof URL) return value
   if (typeof value === 'string' && value) {
     try {
-      return new URL(value);
+      return new URL(value)
     } catch {
-      return url ? new URL(value, url) : undefined;
+      return url ? new URL(value, url) : undefined
     }
   }
-  return undefined;
+  return undefined
 }
 
 function resolveMetadataUrl(
@@ -590,35 +590,35 @@ function resolveMetadataUrl(
   context: MetadataContext,
   fallbackToRequestUrl = false,
 ): string | undefined {
-  if (value === undefined || value === null) return undefined;
-  if (value instanceof URL) return value.href;
-  const raw = coerceString(value);
-  if (!raw) return undefined;
-  if (/^[a-z][a-z\d+.-]*:/i.test(raw)) return raw;
+  if (value === undefined || value === null) return undefined
+  if (value instanceof URL) return value.href
+  const raw = coerceString(value)
+  if (!raw) return undefined
+  if (/^[a-z][a-z\d+.-]*:/i.test(raw)) return raw
   const base =
-    context.metadataBase ?? (fallbackToRequestUrl ? requestFallbackBase(context.url) : undefined);
-  if (!base) return raw;
-  const origin = base.origin;
-  const prefix = base.pathname === '/' ? '' : `/${base.pathname.replace(/^\/+|\/+$/g, '')}`;
+    context.metadataBase ?? (fallbackToRequestUrl ? requestFallbackBase(context.url) : undefined)
+  if (!base) return raw
+  const origin = base.origin
+  const prefix = base.pathname === '/' ? '' : `/${base.pathname.replace(/^\/+|\/+$/g, '')}`
   if (raw.startsWith('./') && context.url) {
-    const requestPath = joinUrlPath(prefix, context.url.pathname);
-    const directory = requestPath.endsWith('/') ? requestPath : `${requestPath}/`;
-    const resolved = new URL(raw, `${origin}${directory}`).pathname;
+    const requestPath = joinUrlPath(prefix, context.url.pathname)
+    const directory = requestPath.endsWith('/') ? requestPath : `${requestPath}/`
+    const resolved = new URL(raw, `${origin}${directory}`).pathname
     const pathname =
-      resolved.length > 1 && resolved.endsWith('/') ? resolved.slice(0, -1) : resolved;
-    return joinMetadataUrl(origin, pathname);
+      resolved.length > 1 && resolved.endsWith('/') ? resolved.slice(0, -1) : resolved
+    return joinMetadataUrl(origin, pathname)
   }
-  const relative = metadataRelativePath(raw);
-  const resolvedPath = joinUrlPath(prefix, relative);
-  return joinMetadataUrl(origin, resolvedPath);
+  const relative = metadataRelativePath(raw)
+  const resolvedPath = joinUrlPath(prefix, relative)
+  return joinMetadataUrl(origin, resolvedPath)
 }
 
 function requestFallbackBase(url?: URL) {
-  if (!url) return undefined;
-  if (url.hostname !== 'pnext.local') return new URL(url.origin);
+  if (!url) return undefined
+  if (url.hostname !== 'pnext.local') return new URL(url.origin)
   // eslint-disable-next-line turbo/no-undeclared-env-vars
-  const port = process.env.PORT;
-  return port && port !== '0' ? new URL(`http://localhost:${port}`) : undefined;
+  const port = process.env.PORT
+  return port && port !== '0' ? new URL(`http://localhost:${port}`) : undefined
 }
 
 // Join a resolved origin + pathname into an absolute metadata URL, honoring the
@@ -627,46 +627,46 @@ function requestFallbackBase(url?: URL) {
 // bare path, and `/metadata?query=string` must not become `/metadata/?...`.
 function joinMetadataUrl(origin: string, pathname: string) {
   if (/[?#]/.test(pathname)) {
-    return pathname === '/' ? origin : `${origin}${pathname}`;
+    return pathname === '/' ? origin : `${origin}${pathname}`
   }
   if (getTrailingSlashUrls()) {
-    if (pathname === '/') return `${origin}/`;
-    return pathname.endsWith('/') ? `${origin}${pathname}` : `${origin}${pathname}/`;
+    if (pathname === '/') return `${origin}/`
+    return pathname.endsWith('/') ? `${origin}${pathname}` : `${origin}${pathname}/`
   }
-  return pathname === '/' ? origin : `${origin}${pathname}`;
+  return pathname === '/' ? origin : `${origin}${pathname}`
 }
 
 function metadataRelativePath(value: string) {
-  let next = value;
-  while (next.startsWith('./')) next = next.slice(2);
-  while (next.startsWith('../')) next = next.slice(3);
-  while (next.startsWith('/')) next = next.slice(1);
-  return next;
+  let next = value
+  while (next.startsWith('./')) next = next.slice(2)
+  while (next.startsWith('../')) next = next.slice(3)
+  while (next.startsWith('/')) next = next.slice(1)
+  return next
 }
 
 function joinUrlPath(...parts: string[]) {
-  const path = parts.filter(Boolean).join('/').replace(/\/+/g, '/');
-  return path.startsWith('/') ? path : `/${path}`;
+  const path = parts.filter(Boolean).join('/').replace(/\/+/g, '/')
+  return path.startsWith('/') ? path : `/${path}`
 }
 
 // Normalizes every icon form (string | URL | object | group) into <link> descriptors.
 function coerceIcons(value: Metadata['icons'], context: MetadataContext): MetadataLink[] {
-  if (value === undefined) return [];
+  if (value === undefined) return []
   if (isIconGroups(value)) {
     return [
       ...iconList(value.icon, 'icon', context),
       ...iconList(value.shortcut, 'shortcut icon', context),
       ...iconList(value.apple, 'apple-touch-icon', context),
       ...iconList(value.other, 'icon', context),
-    ];
+    ]
   }
-  return iconList(value, 'icon', context);
+  return iconList(value, 'icon', context)
 }
 
 function isIconGroups(value: NonNullable<Metadata['icons']>): value is MetadataIconGroups {
-  if (Array.isArray(value) || typeof value === 'string' || value instanceof URL) return false;
-  if (typeof value !== 'object') return false;
-  return 'icon' in value || 'shortcut' in value || 'apple' in value || 'other' in value;
+  if (Array.isArray(value) || typeof value === 'string' || value instanceof URL) return false
+  if (typeof value !== 'object') return false
+  return 'icon' in value || 'shortcut' in value || 'apple' in value || 'other' in value
 }
 
 function iconList(
@@ -674,33 +674,33 @@ function iconList(
   rel: string,
   context: MetadataContext,
 ): MetadataLink[] {
-  if (value === undefined) return [];
-  const list = Array.isArray(value) ? value : [value];
+  if (value === undefined) return []
+  const list = Array.isArray(value) ? value : [value]
   return list.map((icon): MetadataLink => {
-    if (typeof icon === 'string') return { rel, url: resolveMetadataUrl(icon, context) ?? icon };
-    if (icon instanceof URL) return { rel, url: icon.href };
-    const obj = icon;
+    if (typeof icon === 'string') return { rel, url: resolveMetadataUrl(icon, context) ?? icon }
+    if (icon instanceof URL) return { rel, url: icon.href }
+    const obj = icon
     return {
       ...obj,
       rel: obj.rel ?? rel,
       url: resolveMetadataUrl(obj.url, context) ?? coerceString(obj.url),
-    };
-  });
+    }
+  })
 }
 
 function authorLinks(value: Metadata['authors'], context: MetadataContext): MetadataLink[] {
-  if (value === undefined) return [];
+  if (value === undefined) return []
   return (Array.isArray(value) ? value : [value])
     .filter((author): author is MetadataAuthor => typeof author === 'object' && author !== null)
     .flatMap(author => {
-      const url = resolveMetadataUrl(author.url, context);
-      return url ? [{ rel: 'author', url }] : [];
-    });
+      const url = resolveMetadataUrl(author.url, context)
+      return url ? [{ rel: 'author', url }] : []
+    })
 }
 
 function manifestLink(value: Metadata['manifest'], context: MetadataContext): MetadataLink[] {
-  const url = resolveMetadataUrl(value, context);
-  return url ? [{ rel: 'manifest', url }] : [];
+  const url = resolveMetadataUrl(value, context)
+  return url ? [{ rel: 'manifest', url }] : []
 }
 
 function paginationLinks(value: Metadata['pagination'], context: MetadataContext): MetadataLink[] {
@@ -716,130 +716,130 @@ function paginationLinks(value: Metadata['pagination'], context: MetadataContext
     ...(value?.next
       ? [{ rel: 'next', url: resolveMetadataUrl(value.next, context) ?? coerceString(value.next) }]
       : []),
-  ];
+  ]
 }
 
 function alternateLinks(value: Metadata['alternates'], context: MetadataContext): MetadataLink[] {
-  if (!value) return [];
-  const links: MetadataLink[] = [];
+  if (!value) return []
+  const links: MetadataLink[] = []
   for (const [hrefLang, url] of Object.entries(value.languages ?? {})) {
     links.push({
       rel: 'alternate',
       url: resolveMetadataUrl(url, context) ?? coerceString(url),
       hrefLang,
-    });
+    })
   }
   for (const [media, url] of Object.entries(value.media ?? {})) {
     links.push({
       rel: 'alternate',
       media,
       url: resolveMetadataUrl(url, context) ?? coerceString(url),
-    });
+    })
   }
   for (const [type, entries] of Object.entries(value.types ?? {})) {
-    const listEntries = Array.isArray(entries) ? entries : [entries];
+    const listEntries = Array.isArray(entries) ? entries : [entries]
     for (const entry of listEntries) {
       const record =
         typeof entry === 'object' && !(entry instanceof URL) && entry !== null && 'url' in entry
           ? entry
-          : { url: entry };
+          : { url: entry }
       links.push({
         rel: 'alternate',
         type,
         ...(record.title ? { title: record.title } : {}),
         url: resolveMetadataUrl(record.url, context) ?? coerceString(record.url),
-      });
+      })
     }
   }
-  return links;
+  return links
 }
 
 function appleStartupLinks(
   value: Metadata['appleWebApp'],
   context: MetadataContext,
 ): MetadataLink[] {
-  if (!value || typeof value !== 'object' || value.startupImage === undefined) return [];
-  const images = Array.isArray(value.startupImage) ? value.startupImage : [value.startupImage];
+  if (!value || typeof value !== 'object' || value.startupImage === undefined) return []
+  const images = Array.isArray(value.startupImage) ? value.startupImage : [value.startupImage]
   return images.map(image => {
     if (typeof image === 'string' || image instanceof URL) {
       return {
         rel: 'apple-touch-startup-image',
         url: resolveMetadataUrl(image, context) ?? coerceString(image),
-      };
+      }
     }
     return {
       rel: 'apple-touch-startup-image',
       url: resolveMetadataUrl(image.url, context) ?? coerceString(image.url),
       media: image.media,
-    };
-  });
+    }
+  })
 }
 
 function list(value: unknown): string[] {
-  if (value === undefined) return [];
-  return Array.isArray(value) ? value.map(coerceString) : [coerceString(value)];
+  if (value === undefined) return []
+  return Array.isArray(value) ? value.map(coerceString) : [coerceString(value)]
 }
 
 function coerceFormatDetection(value: Metadata['formatDetection']): string | undefined {
-  if (!value) return undefined;
-  const entries: string[] = [];
-  if (value.telephone === false) entries.push('telephone=no');
-  if (value.address === false) entries.push('address=no');
-  if (value.email === false) entries.push('email=no');
-  if (value.url === false) entries.push('url=no');
-  return entries.length ? entries.join(', ') : undefined;
+  if (!value) return undefined
+  const entries: string[] = []
+  if (value.telephone === false) entries.push('telephone=no')
+  if (value.address === false) entries.push('address=no')
+  if (value.email === false) entries.push('email=no')
+  if (value.url === false) entries.push('url=no')
+  return entries.length ? entries.join(', ') : undefined
 }
 
 function verificationTags(value: Metadata['verification']): [string, string][] {
-  if (!value) return [];
+  if (!value) return []
   return [
     ...list(value.google).map(item => ['google-site-verification', item] as [string, string]),
     ...list(value.yahoo).map(item => ['y_key', item] as [string, string]),
     ...list(value.yandex).map(item => ['yandex-verification', item] as [string, string]),
-  ];
+  ]
 }
 
 function itunesContent(value: Metadata['itunes']): string | undefined {
-  if (!value?.appId) return undefined;
+  if (!value?.appId) return undefined
   return [
     `app-id=${value.appId}`,
     value.appArgument ? `app-argument=${value.appArgument}` : undefined,
   ]
     .filter(Boolean)
-    .join(', ');
+    .join(', ')
 }
 
 function appleWebAppCapable(value: NonNullable<Metadata['appleWebApp']>) {
-  return typeof value === 'boolean' ? value : (value.capable ?? true);
+  return typeof value === 'boolean' ? value : (value.capable ?? true)
 }
 
 function appLinkTags(value: Metadata['appLinks']): [string, string][] {
-  if (!value) return [];
-  const tags: [string, string][] = [];
+  if (!value) return []
+  const tags: [string, string][] = []
   for (const [platform, entries] of Object.entries(value)) {
     for (const [name, item] of Object.entries(entries)) {
-      if (item !== undefined) tags.push([`al:${platform}:${name}`, String(item)]);
+      if (item !== undefined) tags.push([`al:${platform}:${name}`, String(item)])
     }
   }
-  return tags;
+  return tags
 }
 
 function twitterCard(twitter: MetadataTwitter) {
-  if (twitter.card) return twitter.card;
-  if (twitter.players) return 'player';
-  if (twitter.app) return 'app';
-  return twitter.images === undefined ? 'summary' : 'summary_large_image';
+  if (twitter.card) return twitter.card
+  if (twitter.players) return 'player'
+  if (twitter.app) return 'app'
+  return twitter.images === undefined ? 'summary' : 'summary_large_image'
 }
 
 function twitterFromOpenGraph(
   openGraph: MetadataOpenGraph | undefined,
 ): MetadataTwitter | undefined {
-  if (!openGraph) return undefined;
+  if (!openGraph) return undefined
   return {
     title: openGraph.title,
     description: openGraph.description,
     images: openGraph.images,
-  };
+  }
 }
 
 export function mergeViewport(...items: Viewport[]) {
@@ -849,9 +849,9 @@ export function mergeViewport(...items: Viewport[]) {
       ...item,
     }),
     {},
-  );
+  )
 }
 
 function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null;
+  return typeof value === 'object' && value !== null
 }