@duffcloudservices/cms 0.3.17 → 0.4.0

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import * as vue from 'vue';
 import { ComputedRef, MaybeRefOrGetter } from 'vue';
+import { U as UseSeoReturn, G as GlobalSeoConfig, S as SeoConfiguration, R as ResolvedPageSeo, a as SeoSchemaConfig, b as SeoOpenGraphConfig, c as SeoTwitterConfig } from './seo-DsJjfI1p.js';
+export { H as HeadOverrides, P as PageSeoConfig, g as SeoAlternateConfig, d as SeoAuthorConfig, f as SeoImagesConfig, e as SeoSocialConfig, h as SeoVerificationConfig, i as UseSeoConfig } from './seo-DsJjfI1p.js';
 import { ImageContext, ResponsiveImageResult } from '@duffcloudservices/cms-core';
 export { ImageContext, ResponsiveImageOptions, ResponsiveImageResult, ResponsiveSource, isCdnAssetUrl, resolveResponsiveImage } from '@duffcloudservices/cms-core';
 
@@ -106,274 +108,16 @@ interface TextContentReturn {
  */
 declare function useTextContent(config: TextContentConfig): TextContentReturn;
 
-/**
- * Types for .dcs/seo.yaml structure
- * Matches contracts/generated/schemas/seo.json
- */
-/**
- * Root structure of .dcs/seo.yaml
- */
-interface SeoConfiguration {
-    /** Schema version */
-    version: number;
-    /** ISO timestamp of last update */
-    lastUpdated?: string;
-    /** Email or identifier of who made the update */
-    updatedBy?: string;
-    /** Global/site-wide SEO defaults */
-    global?: GlobalSeoConfig;
-    /** Page-specific SEO configurations keyed by page slug */
-    pages?: Record<string, PageSeoConfig>;
-}
-/**
- * Global/site-wide SEO configuration
- */
-interface GlobalSeoConfig {
-    /** Site name used in titles and structured data */
-    siteName?: string;
-    /** Base URL of the site (e.g., https://example.com) */
-    siteUrl?: string;
-    /** Locale for Open Graph (e.g., en_US) */
-    locale?: string;
-    /** Default page title */
-    defaultTitle?: string;
-    /** Default meta description */
-    defaultDescription?: string;
-    /** Title template with %s placeholder (e.g., "%s | Site Name") */
-    titleTemplate?: string;
-    /** Author information for structured data */
-    author?: SeoAuthorConfig;
-    /** Social media handles */
-    social?: SeoSocialConfig;
-    /** Default images for social sharing */
-    images?: SeoImagesConfig;
-    /** Default robots directive (e.g., "index, follow") */
-    robots?: string;
-    /** Global JSON-LD schemas (Organization, WebSite, etc.) */
-    schemas?: SeoSchemaConfig[];
-    /** Search engine verification codes */
-    verification?: SeoVerificationConfig;
-}
-/**
- * Page-specific SEO configuration
- */
-interface PageSeoConfig {
-    /** Page title */
-    title?: string;
-    /** Meta description */
-    description?: string;
-    /** Meta keywords (comma-separated) */
-    keywords?: string;
-    /** Canonical URL */
-    canonical?: string;
-    /** Page-specific robots directive */
-    robots?: string;
-    /** Open Graph configuration */
-    openGraph?: SeoOpenGraphConfig;
-    /** Twitter Card configuration */
-    twitter?: SeoTwitterConfig;
-    /** Page-specific JSON-LD schemas */
-    schemas?: SeoSchemaConfig[];
-    /** Alternate language links */
-    alternates?: SeoAlternateConfig[];
-    /** If true, don't apply titleTemplate to this page */
-    noTitleTemplate?: boolean;
-}
-/**
- * Author information for structured data
- */
-interface SeoAuthorConfig {
-    /** Author name */
-    name?: string;
-    /** Author email */
-    email?: string;
-    /** Author image URL */
-    image?: string;
-    /** Job title */
-    jobTitle?: string;
-    /** Social profile URLs */
-    sameAs?: string[];
-}
-/**
- * Social media handles
- */
-interface SeoSocialConfig {
-    /** Twitter handle (without @) */
-    twitter?: string;
-    /** LinkedIn company or profile slug */
-    linkedin?: string;
-    /** GitHub username */
-    github?: string;
-    /** Facebook page name */
-    facebook?: string;
-    /** Instagram username */
-    instagram?: string;
-    /** YouTube channel */
-    youtube?: string;
-}
-/**
- * Default images for social sharing
- */
-interface SeoImagesConfig {
-    /** Logo image URL */
-    logo?: string;
-    /** Default Open Graph image */
-    ogDefault?: string;
-    /** Default Twitter Card image */
-    twitterDefault?: string;
-    /** Favicon URL */
-    favicon?: string;
-}
-/**
- * Open Graph meta configuration
- */
-interface SeoOpenGraphConfig {
-    /** OG title (defaults to page title) */
-    title?: string;
-    /** OG description (defaults to page description) */
-    description?: string;
-    /** OG image URL */
-    image?: string;
-    /** Alt text for OG image */
-    imageAlt?: string;
-    /** OG image width in pixels */
-    imageWidth?: number;
-    /** OG image height in pixels */
-    imageHeight?: number;
-    /** OG type */
-    type?: 'website' | 'article' | 'profile' | 'book' | 'music.song' | 'music.album' | 'video.movie' | 'video.episode' | 'video.tv_show' | 'video.other';
-    /** OG URL (defaults to canonical) */
-    url?: string;
-    /** Article published time (ISO 8601) */
-    publishedTime?: string;
-    /** Article modified time (ISO 8601) */
-    modifiedTime?: string;
-    /** Article author */
-    author?: string;
-    /** Article section/category */
-    section?: string;
-    /** Article tags */
-    tags?: string[];
-}
-/**
- * Twitter Card configuration
- */
-interface SeoTwitterConfig {
-    /** Card type */
-    card?: 'summary' | 'summary_large_image' | 'app' | 'player';
-    /** Twitter title */
-    title?: string;
-    /** Twitter description */
-    description?: string;
-    /** Twitter image URL */
-    image?: string;
-    /** Alt text for Twitter image */
-    imageAlt?: string;
-    /** Site's Twitter handle (without @) */
-    site?: string;
-    /** Content creator's Twitter handle (without @) */
-    creator?: string;
-}
-/**
- * JSON-LD schema configuration
- */
-interface SeoSchemaConfig {
-    /** Schema.org type (e.g., "WebSite", "Organization", "Article") */
-    type: string;
-    /** Schema properties */
-    properties?: Record<string, unknown>;
-}
-/**
- * Alternate language link
- */
-interface SeoAlternateConfig {
-    /** Language code (e.g., "en", "es", "x-default") */
-    hreflang: string;
-    /** URL of alternate version */
-    href: string;
-}
-/**
- * Search engine verification codes
- */
-interface SeoVerificationConfig {
-    /** Google Search Console verification code */
-    google?: string;
-    /** Bing Webmaster Tools verification code */
-    bing?: string;
-    /** DuckDuckGo verification (reserved for future use) */
-    duckduckgo?: string;
-}
-/**
- * Resolved page SEO configuration (after merging global + page)
- */
-interface ResolvedPageSeo {
-    /** Final page title */
-    title: string;
-    /** Final meta description */
-    description: string;
-    /** Final canonical URL */
-    canonical: string;
-    /** Final robots directive */
-    robots: string;
-    /** Merged Open Graph configuration */
-    openGraph: Required<Pick<SeoOpenGraphConfig, 'title' | 'description' | 'type'>> & SeoOpenGraphConfig;
-    /** Merged Twitter configuration */
-    twitter: Required<Pick<SeoTwitterConfig, 'card'>> & SeoTwitterConfig;
-    /** All schemas (global + page) */
-    schemas: SeoSchemaConfig[];
-    /** Alternate links */
-    alternates: SeoAlternateConfig[];
-}
-/**
- * Configuration for useSEO composable
- */
-interface UseSeoConfig {
-    /** Page slug matching entry in seo.yaml */
-    pageSlug: string;
-    /** Optional page path for canonical URL generation */
-    pagePath?: string;
-}
-/**
- * Return type of useSEO composable
- */
-interface UseSeoReturn {
-    /** Computed page SEO configuration */
-    config: vue.ComputedRef<ResolvedPageSeo>;
-    /** Apply all meta tags via useHead */
-    applyHead: (overrides?: HeadOverrides) => void;
-    /** Get JSON-LD schema objects for the page */
-    getSchema: () => object[];
-    /** Get canonical URL for the page */
-    getCanonical: () => string;
-    /** Whether SEO config was loaded from build-time */
-    hasBuildTimeSeo: boolean;
-}
-/**
- * Overrides that can be passed to applyHead
- */
-interface HeadOverrides {
-    /** Override title */
-    title?: string;
-    /** Override description */
-    description?: string;
-    /** Override keywords meta tag */
-    keywords?: string;
-    /** Additional or replacement schemas */
-    schemas?: object[];
-    /** Additional meta tags */
-    meta?: Array<{
-        name?: string;
-        property?: string;
-        content: string;
-    }>;
-}
-
 /**
  * useSEO Composable
  *
  * Provides SEO configuration with build-time injection support from .dcs/seo.yaml.
  * Generates meta tags, Open Graph, Twitter Cards, and JSON-LD structured data.
  *
+ * The actual tag resolution lives in the framework-agnostic `../seo/headTags`
+ * module so that the build-time static-HTML emitter (`dcsSeoPlugin`) produces
+ * byte-identical output. This composable is a thin Vue/unhead wrapper over it.
+ *
  * @example
  * ```vue
  * <script setup lang="ts">
@@ -418,6 +162,198 @@ declare function useSEO(pageSlug: string, pagePath?: string): UseSeoReturn;
  */
 declare function createSiteSEO(_siteDefaults: Partial<GlobalSeoConfig>): (pageSlug: string, pagePath?: string) => UseSeoReturn;
 
+/**
+ * Framework-agnostic SEO head-tag resolution.
+ *
+ * This module is the single source of truth for turning a
+ * (`pageSlug`, `pagePath`, `SeoConfiguration`) triple into a plain,
+ * serialisable description of the `<head>` tags a page should carry:
+ * resolved title, meta[], link[], and JSON-LD script[].
+ *
+ * It is consumed by:
+ *   - `useSEO` (runtime, via `@unhead/vue`) — see `../composables/useSEO.ts`
+ *   - `dcsSeoPlugin`'s build-time static-HTML emitter — see
+ *     `../plugins/dcsSeoPlugin.ts`
+ *
+ * Keeping the resolution here (rather than inside the Vue composable) means
+ * the runtime and the build-time emitter produce byte-identical tags from the
+ * same `seo.yaml`, with no Vue/unhead dependency required at build time.
+ *
+ * Runtime behaviour is intentionally identical to the previous in-composable
+ * logic **except** for one corrected bug: `og:title` now falls back to the
+ * fully-resolved (template-applied) page title instead of the raw, untemplated
+ * `page.title`. Previously `og:title` could diverge from the `<title>` element
+ * (e.g. `<title>Iron Oak Contractors | Our Services</title>` but
+ * `og:title = "Our Services"`).
+ */
+
+/** A `<meta>` tag — either a `name=`/`content=` or `property=`/`content=` pair. */
+interface HeadMetaTag {
+    name?: string;
+    property?: string;
+    content: string;
+}
+/** A `<link>` tag (canonical, alternate, etc.). */
+interface HeadLinkTag {
+    rel: string;
+    href: string;
+    hreflang?: string;
+}
+/** A `<script type="application/ld+json">` tag carrying serialised JSON-LD. */
+interface HeadScriptTag {
+    type: string;
+    /** Pre-serialised JSON-LD string (already `JSON.stringify`-ed). */
+    children: string;
+}
+/**
+ * The complete, framework-agnostic set of resolved `<head>` tags for a page.
+ *
+ * - `title` is the final, template-applied title (what goes in `<title>`).
+ * - `meta` covers description, keywords, robots, verification, OG, Twitter.
+ * - `link` covers canonical + hreflang alternates.
+ * - `script` covers JSON-LD (global + page schemas).
+ * - `jsonLd` is the same JSON-LD as parsed objects, for callers that want the
+ *   structured form (e.g. `useSEO().getSchema()`).
+ */
+interface ResolvedHeadTags {
+    title: string;
+    meta: HeadMetaTag[];
+    link: HeadLinkTag[];
+    script: HeadScriptTag[];
+    jsonLd: object[];
+    /** The fully-resolved page SEO (merged global + page) used to build tags. */
+    resolved: ResolvedPageSeo;
+}
+/** Optional overrides applied on top of the resolved config when building tags. */
+interface HeadTagOverrides {
+    /** Override the resolved `<title>`. */
+    title?: string;
+    /**
+     * Page-specific title fallback used when `seo.yaml` has no `title` for this
+     * page (e.g. the route `title` from `pages.yaml`). Unlike `global.defaultTitle`
+     * this IS run through `titleTemplate`, so un-configured routes (blog posts,
+     * etc.) get unique titles rather than the global default.
+     */
+    fallbackTitle?: string;
+    /** Override the resolved meta description. */
+    description?: string;
+    /** Override the meta keywords value. */
+    keywords?: string;
+    /**
+     * Force the robots directive (e.g. `'noindex, nofollow'`). When supplied this
+     * wins over both page- and global-level robots.
+     */
+    robots?: string;
+    /** Replace the JSON-LD schema objects entirely (already-built objects). */
+    schemas?: object[];
+    /** Extra meta tags appended after the generated ones. */
+    meta?: HeadMetaTag[];
+    /**
+     * Emit a `<meta name="keywords">` tag from the page's `keywords` field.
+     *
+     * Defaults to `false` so the `useSEO` runtime path stays byte-identical to
+     * its historical output (which never emitted keywords). The static-HTML
+     * emitter opts in (`true`) to surface page keywords in the baked `<head>`.
+     */
+    includeKeywords?: boolean;
+}
+/**
+ * Generate Open Graph meta tags from config.
+ *
+ * @param resolvedTitle - the final, template-applied page title. Used as the
+ *   `og:title` fallback so OG stays consistent with `<title>`.
+ */
+declare function generateOpenGraphMeta(og: SeoOpenGraphConfig, global: GlobalSeoConfig, resolvedTitle: string, pageDescription: string, canonical: string): Array<{
+    property: string;
+    content: string;
+}>;
+/**
+ * Generate Twitter Card meta tags from config.
+ *
+ * @param resolvedTitle - the final, template-applied page title (Twitter title
+ *   fallback), mirroring the OG behaviour.
+ */
+declare function generateTwitterMeta(twitter: SeoTwitterConfig, global: GlobalSeoConfig, resolvedTitle: string, pageDescription: string): Array<{
+    name: string;
+    content: string;
+}>;
+/**
+ * Generate JSON-LD schema objects from schema configs, auto-populating common
+ * WebSite properties from global config.
+ */
+declare function generateJsonLd(schemas: SeoSchemaConfig[], global: GlobalSeoConfig): object[];
+/**
+ * Resolve page SEO by merging global defaults with page-specific config.
+ *
+ * Behavioural changes from the historical in-composable version (both bug
+ * fixes):
+ *   1. `openGraph.title` falls back to the **template-applied** page title, not
+ *      the raw `page.title`, so `og:title` matches `<title>`.
+ *   2. The `titleTemplate` is applied **only** to a page-specific title
+ *      (`page.title`, or the `fallbackTitle` arg). It is no longer applied to
+ *      `global.defaultTitle`, which is already the complete brand title —
+ *      templating it produced `"Brand | Default Title | Brand"` doubling on any
+ *      page without its own `seo.yaml` entry.
+ *
+ * @param fallbackTitle - a page-specific title to use when `seo.yaml` has no
+ *   `title` for this page (e.g. the route `title` from `pages.yaml`). It IS run
+ *   through `titleTemplate`; `global.defaultTitle` is the last resort and is not.
+ */
+declare function resolvePageSeo(pageSlug: string, pagePath: string | undefined, seoConfig: SeoConfiguration | undefined, fallbackTitle?: string): ResolvedPageSeo;
+/**
+ * Build the complete, framework-agnostic set of `<head>` tags for a page.
+ *
+ * This is the function both the `useSEO` runtime and the build-time emitter
+ * call, guaranteeing identical output. Pass `overrides` to mirror the
+ * composable's `applyHead(overrides)` behaviour, or to force `robots` (used by
+ * the emitter's `noindex` option).
+ */
+declare function buildHeadTags(pageSlug: string, pagePath: string | undefined, seoConfig: SeoConfiguration | undefined, overrides?: HeadTagOverrides): ResolvedHeadTags;
+
+/**
+ * Pure, framework-free `<head>` splicing for the build-time SEO emitter.
+ *
+ * Given a built `index.html` shell and a set of resolved head tags (from
+ * `buildHeadTags`), this produces a new HTML string where the SEO-managed
+ * tags — `<title>`, `description`, `keywords`, `robots`, `canonical`,
+ * verification, all `og:*` / `article:*` properties, all `twitter:*` names,
+ * and `application/ld+json` scripts — have been **replaced** (not duplicated)
+ * with the resolved set.
+ *
+ * Design goals:
+ *   - **Idempotent**: running it twice yields the same output (it strips the
+ *     managed tags first, then re-inserts the canonical set).
+ *   - **Deterministic**: tag order is fixed by `renderHeadTags`.
+ *   - **Conservative**: only tags we own are touched. Charset, viewport, CSP,
+ *     theme-color, favicons, stylesheets, and the app script are left intact.
+ *
+ * This is intentionally regex-based (no DOM dependency) to mirror the existing
+ * `dcsCdnImagePlugin` post-build HTML rewriting and to keep the emitter free of
+ * heavy parser deps at build time.
+ */
+
+/**
+ * Render the resolved head tags to a deterministic HTML fragment.
+ * Order: title, meta (in the order produced by buildHeadTags), link, script.
+ */
+declare function renderHeadTags(tags: ResolvedHeadTags, indent?: string): string;
+/**
+ * Strip the SEO-managed tags from a `<head>` block so they can be re-inserted
+ * without duplication. Operates only within `<head>...</head>` to avoid
+ * touching body content.
+ */
+declare function stripManagedHeadTags(html: string): string;
+/**
+ * Splice resolved SEO head tags into an HTML document.
+ *
+ * Strips the existing managed tags, then inserts the rendered canonical set
+ * immediately before `</head>`. If no `<head>` is present the HTML is returned
+ * unchanged (defensive — the emitter logs and no-ops in that case).
+ *
+ * Idempotent: applying twice produces identical output.
+ */
+declare function spliceHeadHtml(html: string, tags: ResolvedHeadTags): string;
+
 /**
  * Types for release notes API
  */
@@ -723,4 +659,4 @@ interface UseReviewContentReturn {
 }
 declare function useReviewContent(config: UseReviewContentConfig): UseReviewContentReturn;
 
-export { type DcsContentFile, type GlobalSeoConfig, type HeadOverrides, type MediaCarouselItem, type PageSeoConfig, type ReleaseNote, type ReleaseNotesReturn, type ResolvedPageSeo, type ReviewItem, type SeoAlternateConfig, type SeoAuthorConfig, type SeoConfiguration, type SeoImagesConfig, type SeoOpenGraphConfig, type SeoSchemaConfig, type SeoSocialConfig, type SeoTwitterConfig, type SeoVerificationConfig, type SiteVersionReturn, type TextContentConfig, type TextContentReturn, type UseMediaCarouselConfig, type UseMediaCarouselReturn, type UseReviewContentConfig, type UseReviewContentReturn, type UseSeoConfig, type UseSeoReturn, createSiteSEO, useMediaCarousel, useReleaseNotes, useResponsiveImage, useReviewContent, useSEO, useSiteVersion, useTextContent };
+export { type DcsContentFile, GlobalSeoConfig, type HeadLinkTag, type HeadMetaTag, type HeadScriptTag, type HeadTagOverrides, type MediaCarouselItem, type ReleaseNote, type ReleaseNotesReturn, type ResolvedHeadTags, ResolvedPageSeo, type ReviewItem, SeoConfiguration, SeoOpenGraphConfig, SeoSchemaConfig, SeoTwitterConfig, type SiteVersionReturn, type TextContentConfig, type TextContentReturn, type UseMediaCarouselConfig, type UseMediaCarouselReturn, type UseReviewContentConfig, type UseReviewContentReturn, UseSeoReturn, buildHeadTags, createSiteSEO, generateJsonLd, generateOpenGraphMeta, generateTwitterMeta, renderHeadTags, resolvePageSeo, spliceHeadHtml, stripManagedHeadTags, useMediaCarousel, useReleaseNotes, useResponsiveImage, useReviewContent, useSEO, useSiteVersion, useTextContent };

package/dist/index.js

@@ -1,9 +1,10 @@
+import { resolvePageSeo, generateJsonLd, buildHeadTags } from './chunk-RDYVYYTC.js';
+export { buildHeadTags, generateJsonLd, generateOpenGraphMeta, generateTwitterMeta, renderHeadTags, resolvePageSeo, spliceHeadHtml, stripManagedHeadTags } from './chunk-RDYVYYTC.js';
 import { shallowRef, ref, computed, onMounted, readonly, toValue, onUnmounted } from 'vue';
 import { useHead } from '@unhead/vue';
 import { isCdnAssetUrl, resolveResponsiveImage } from '@duffcloudservices/cms-core';
 export { isCdnAssetUrl, resolveResponsiveImage } from '@duffcloudservices/cms-core';
 
-// src/composables/useTextContent.ts
 var fetchCache = /* @__PURE__ */ new Map();
 function getBuildTimeContent() {
   try {
@@ -161,128 +162,6 @@ function getBuildTimeSeo() {
   }
   return void 0;
 }
-function generateOpenGraphMeta(og, global, pageTitle, pageDescription, canonical) {
-  const tags = [];
-  tags.push({ property: "og:title", content: og.title || pageTitle });
-  tags.push({ property: "og:description", content: og.description || pageDescription });
-  tags.push({ property: "og:url", content: og.url || canonical });
-  tags.push({ property: "og:type", content: og.type || "website" });
-  const image = og.image || global.images?.ogDefault;
-  if (image) {
-    tags.push({ property: "og:image", content: image });
-    if (og.imageAlt || pageTitle) {
-      tags.push({ property: "og:image:alt", content: og.imageAlt || pageTitle });
-    }
-    if (og.imageWidth) {
-      tags.push({ property: "og:image:width", content: String(og.imageWidth) });
-    }
-    if (og.imageHeight) {
-      tags.push({ property: "og:image:height", content: String(og.imageHeight) });
-    }
-  }
-  if (global.siteName) {
-    tags.push({ property: "og:site_name", content: global.siteName });
-  }
-  if (global.locale) {
-    tags.push({ property: "og:locale", content: global.locale });
-  }
-  if (og.type === "article") {
-    if (og.publishedTime) {
-      tags.push({ property: "article:published_time", content: og.publishedTime });
-    }
-    if (og.modifiedTime) {
-      tags.push({ property: "article:modified_time", content: og.modifiedTime });
-    }
-    if (og.author) {
-      tags.push({ property: "article:author", content: og.author });
-    }
-    if (og.section) {
-      tags.push({ property: "article:section", content: og.section });
-    }
-    if (og.tags) {
-      og.tags.forEach((tag) => {
-        tags.push({ property: "article:tag", content: tag });
-      });
-    }
-  }
-  return tags;
-}
-function generateTwitterMeta(twitter, global, pageTitle, pageDescription) {
-  const tags = [];
-  tags.push({ name: "twitter:card", content: twitter.card || "summary_large_image" });
-  tags.push({ name: "twitter:title", content: twitter.title || pageTitle });
-  tags.push({ name: "twitter:description", content: twitter.description || pageDescription });
-  const image = twitter.image || global.images?.twitterDefault;
-  if (image) {
-    tags.push({ name: "twitter:image", content: image });
-    if (twitter.imageAlt || pageTitle) {
-      tags.push({ name: "twitter:image:alt", content: twitter.imageAlt || pageTitle });
-    }
-  }
-  const site = twitter.site || global.social?.twitter;
-  if (site) {
-    tags.push({ name: "twitter:site", content: site.startsWith("@") ? site : `@${site}` });
-  }
-  if (twitter.creator) {
-    tags.push({
-      name: "twitter:creator",
-      content: twitter.creator.startsWith("@") ? twitter.creator : `@${twitter.creator}`
-    });
-  }
-  return tags;
-}
-function generateJsonLd(schemas, global) {
-  return schemas.map((schema) => {
-    const base = {
-      "@context": "https://schema.org",
-      "@type": schema.type
-    };
-    if (schema.properties) {
-      Object.assign(base, schema.properties);
-    }
-    if (schema.type === "WebSite" && global.siteUrl && !base.url) {
-      base.url = global.siteUrl;
-    }
-    if (schema.type === "WebSite" && global.siteName && !base.name) {
-      base.name = global.siteName;
-    }
-    return base;
-  });
-}
-function resolvePageSeo(pageSlug, pagePath, seoConfig) {
-  const global = seoConfig?.global ?? {};
-  const page = seoConfig?.pages?.[pageSlug] ?? {};
-  let canonical = page.canonical || "";
-  if (!canonical && global.siteUrl) {
-    const path = pagePath ?? (pageSlug === "home" ? "/" : `/${pageSlug}`);
-    canonical = `${global.siteUrl.replace(/\/$/, "")}${path}`;
-  }
-  let title = page.title || global.defaultTitle || pageSlug;
-  if (!page.noTitleTemplate && global.titleTemplate) {
-    title = global.titleTemplate.replace("%s", title);
-  }
-  const openGraph = {
-    type: page.openGraph?.type || "website",
-    title: page.openGraph?.title || page.title || global.defaultTitle || "",
-    description: page.openGraph?.description || page.description || global.defaultDescription || "",
-    ...page.openGraph
-  };
-  const twitter = {
-    card: page.twitter?.card || "summary_large_image",
-    ...page.twitter
-  };
-  const schemas = [...global.schemas ?? [], ...page.schemas ?? []];
-  return {
-    title,
-    description: page.description || global.defaultDescription || "",
-    canonical,
-    robots: page.robots || global.robots || "index, follow",
-    openGraph,
-    twitter,
-    schemas,
-    alternates: page.alternates ?? []
-  };
-}
 function useSEO(pageSlug, pagePath) {
   const seoConfig = getBuildTimeSeo();
   const hasBuildTimeSeo = seoConfig !== void 0;
@@ -296,46 +175,13 @@ function useSEO(pageSlug, pagePath) {
     return config.value.canonical;
   }
   function applyHead(overrides) {
-    const resolved = config.value;
-    const global = seoConfig?.global ?? {};
-    const title = overrides?.title ?? resolved.title;
-    const description = overrides?.description ?? resolved.description;
-    const meta = [];
-    meta.push({ name: "description", content: description });
-    if (resolved.robots) {
-      meta.push({ name: "robots", content: resolved.robots });
-    }
-    if (global.verification?.google) {
-      meta.push({ name: "google-site-verification", content: global.verification.google });
-    }
-    if (global.verification?.bing) {
-      meta.push({ name: "msvalidate.01", content: global.verification.bing });
-    }
-    const ogMeta = generateOpenGraphMeta(
-      resolved.openGraph,
-      global,
-      title,
-      description,
-      resolved.canonical
-    );
-    meta.push(...ogMeta.map((t) => ({ property: t.property, content: t.content })));
-    const twitterMeta = generateTwitterMeta(resolved.twitter, global, title, description);
-    meta.push(...twitterMeta.map((t) => ({ name: t.name, content: t.content })));
-    if (overrides?.meta) {
-      meta.push(...overrides.meta);
-    }
-    const link = [];
-    if (resolved.canonical) {
-      link.push({ rel: "canonical", href: resolved.canonical });
-    }
-    resolved.alternates.forEach((alt) => {
-      link.push({ rel: "alternate", href: alt.href, hreflang: alt.hreflang });
+    const { title, meta, link, script } = buildHeadTags(pageSlug, pagePath, seoConfig, {
+      title: overrides?.title,
+      description: overrides?.description,
+      keywords: overrides?.keywords,
+      schemas: overrides?.schemas,
+      meta: overrides?.meta
     });
-    const schemas = overrides?.schemas ?? getSchema();
-    const script = schemas.map((schema) => ({
-      type: "application/ld+json",
-      children: JSON.stringify(schema)
-    }));
     useHead({
       title,
       meta,