@getvitops/astro 0.8.0 → 1.0.0

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@getvitops/astro",
-  "version": "0.8.0",
+  "version": "1.0.0",
   "description": "Astro integration for the Vitops design system — favicons/PWA, web-component scripts, and CSS, via a getvitops() integration + <Head /> component.",
   "license": "MIT",
   "files": [
     "dist",
     "src/components/Head.astro",
+    "src/components/Seo.astro",
+    "src/seo.ts",
     "src/components/Subgrid.astro",
     "src/components/Cards.astro",
     "src/components/NodeRenderer.astro",
@@ -25,6 +27,7 @@
       "import": "./dist/index.mjs"
     },
     "./Head.astro": "./src/components/Head.astro",
+    "./Seo.astro": "./src/components/Seo.astro",
     "./components/Subgrid.astro": "./src/components/Subgrid.astro",
     "./components/Cards.astro": "./src/components/Cards.astro",
     "./components/NodeRenderer.astro": "./src/components/NodeRenderer.astro",
@@ -39,24 +42,37 @@
     "access": "public"
   },
   "dependencies": {
-    "@tailwindcss/vite": "^4.3.3",
-    "tailwindcss": "^4.3.3",
-    "@getvitops/core": "0.8.0",
-    "@getvitops/vite": "0.8.0",
-    "@getvitops/generator": "0.8.0",
-    "@getvitops/utils": "0.8.0"
+    "@getvitops/core": "1.0.0",
+    "@getvitops/utils": "1.0.0",
+    "@getvitops/generator": "1.0.0",
+    "@getvitops/vite": "1.0.0"
   },
   "devDependencies": {
+    "@astrojs/sitemap": "^3.7.3",
+    "@tailwindcss/vite": "^4.3.3",
     "astro": "^7.1.2",
+    "tailwindcss": "^4.3.3",
     "vitest": "^4.1.9"
   },
   "peerDependencies": {
+    "@astrojs/sitemap": ">=3.6",
+    "@tailwindcss/vite": ">=4",
     "astro": ">=7",
-    "astro-icon": ">=1"
+    "astro-icon": ">=1",
+    "tailwindcss": ">=4"
   },
   "peerDependenciesMeta": {
+    "@astrojs/sitemap": {
+      "optional": true
+    },
+    "@tailwindcss/vite": {
+      "optional": true
+    },
     "astro-icon": {
       "optional": true
+    },
+    "tailwindcss": {
+      "optional": true
     }
   }
 }

package/src/components/Cards.astro

@@ -1,32 +1,34 @@
 ---
+/**
+ * Cards — a `Subgrid` whose items are `card`s. The child's own class and style
+ * ride along, so `<article class="bg-surface-muted">` becomes `<li class="card bg-surface-muted">`.
+ *
+ * The class has to be put on the `<li>` we hand to Subgrid rather than written
+ * into the slotted element: `serialize()` returns a node's *inner* HTML, so the
+ * element carrying the attribute is discarded on the way through.
+ */
 import type { HTMLAttributes } from 'astro/types';
 import Subgrid from './Subgrid.astro';
-import { parseRenderedSlots, serialize } from '@getvitops/utils';
+import { parseRenderedSlots, getAttribute, serialize } from '@getvitops/utils';
 
 export interface Props extends HTMLAttributes<'ul'> {}
 
 const { class: className, ...rest } = Astro.props;
 
 const nodes = parseRenderedSlots(await Astro.slots.render('default'));
-const slots = nodes.filter(node => 'tagName' in node).map(node => {
-  const cls = node.attrs?.find(attr => attr.name === 'class');
-  const value = `card${cls ? ' ' + cls.value : ''}`;
-  if (cls) {
-    cls.value = value;
-  } else {
-    node.attrs.push({ name: 'class', value });
-  }
-  
-  return { html: serialize(node), attrs: node.attrs };
-});
+const slots = nodes.filter(node => 'tagName' in node).map(node => ({
+  html: serialize(node),
+  class: getAttribute(node, 'class'),
+  style: getAttribute(node, 'style'),
+}));
 ---
 
 <Subgrid
   role="list"
-  class:list={["no-list-markers", className]}
+  class={className}
   {...rest}
 >
   {slots.map((slot) => (
-    <li class="card-wrapper" style={slot.attrs?.find(attr => attr.name === 'style')?.value} set:html={slot.html}></li>
+    <li class:list={["card", slot.class]} style={slot.style} set:html={slot.html}></li>
   ))}
 </Subgrid>

package/src/components/Drawer.astro

@@ -49,8 +49,8 @@ const { class: dialogAttrClass, style: dialogAttrStyle, ...dialogRestAttrs } = a
     aria-label={trigger?.label || 'Open drawer'}
     {...triggerRestAttrs}
   >
-    <span class={trigger?.icon ? 'sr-only' : ''}>{trigger?.label || 'Open'}</span>
-    {trigger?.icon && <Icon name={iconResolver(trigger.icon)} class="not-sr-only" />}
+    <span class:list={[trigger?.icon && 'visually-hidden']}>{trigger?.label || 'Open'}</span>
+    {trigger?.icon && <Icon name={iconResolver(trigger.icon)} />}
   </button>
 </slot>
 
@@ -63,3 +63,20 @@ const { class: dialogAttrClass, style: dialogAttrStyle, ...dialogRestAttrs } = a
 >
   <slot />
 </dialog>
+
+<style>
+  /* Icon-only triggers keep their label for screen readers. Component-scoped
+     rather than the framework's `sr-only`: that one is in the generator's
+     TW_CLASH list, so the tailwind format ships no rule for it. */
+  .visually-hidden {
+    position: absolute;
+    inline-size: 1px;
+    block-size: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+    border: 0;
+  }
+</style>

package/src/components/Head.astro

@@ -41,6 +41,9 @@ const THEME_SCRIPT =
 ))}
 {favicons && head.themeColor && <meta name="theme-color" content={head.themeColor} />}
 
+{/* Set by getvitops({ sitemap }); null when no sitemap was registered. */}
+{head.sitemap && <link rel="sitemap" type="application/xml" href={head.sitemap} />}
+
 {webComponents && (
   <>
     {/*

package/src/components/Popover.astro

@@ -48,8 +48,8 @@ const { class: triggerAttrClass, ...triggerRestAttrs } = trigger?.attrs ?? {};
     aria-label={trigger?.label || 'Open'}
     {...triggerRestAttrs}
   >
-  <span class={trigger?.icon ? 'sr-only' : ''}>{trigger?.label || 'Open'}</span>
-    {trigger?.icon && <Icon name={iconResolver(trigger.icon)} class="not-sr-only" />}
+  <span class:list={[trigger?.icon && 'visually-hidden']}>{trigger?.label || 'Open'}</span>
+    {trigger?.icon && <Icon name={iconResolver(trigger.icon)} />}
   </button>
 </slot>
 
@@ -87,4 +87,19 @@ const { class: triggerAttrClass, ...triggerRestAttrs } = trigger?.attrs ?? {};
     font-family: inherit;
     color: inherit;
   }
+
+  /* Icon-only triggers keep their label for screen readers. Component-scoped
+     rather than the framework's `sr-only`: that one is in the generator's
+     TW_CLASH list, so the tailwind format ships no rule for it. */
+  .visually-hidden {
+    position: absolute;
+    inline-size: 1px;
+    block-size: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+    border: 0;
+  }
 </style>

package/src/components/Seo.astro

@@ -0,0 +1,68 @@
+---
+/**
+ * <Seo /> — the page's SEO <head> tags. Place inside your layout's <head>,
+ * alongside <Head /> (which owns favicons, theme-color and the web-component
+ * runtime — the two don't overlap).
+ *
+ * Site-level defaults come from `getvitops({ seo: … })` via the
+ * `virtual:getvitops/head` module; the props here override them per page.
+ *
+ * It owns <title> and <meta name="description">, so **remove them from your
+ * layout** when you adopt it. That is not tidiness: this component already
+ * computes the resolved title for `og:title`/`twitter:title`, and the previous
+ * version of it emitted those while leaving <title> to the layout — so the two
+ * drifted. Whoever computes the title emits it.
+ *
+ * It emits no JSON-LD. The structured-data components in `../schemas/` take
+ * entity data; this takes page data. Compose them:
+ *   <Seo title={title} description={description} />
+ *   <Organization {...org} />
+ *
+ * On an EmDash site use <EmDashHead> instead — it covers the same tags from the
+ * CMS. Using both double-emits every og:/twitter: tag.
+ */
+// @ts-ignore — virtual module provided by the getvitops() integration at build time
+import head from 'virtual:getvitops/head';
+import { resolveSeo, type SeoProps } from '../seo.ts';
+
+export type Props = SeoProps;
+
+// `Astro.site` is `URL | undefined`; `head.site` is the `config.site` string the
+// integration captured. Same value, different types — the fallback is there so a
+// render context without `Astro.site` still resolves absolute URLs.
+const site: URL | undefined = Astro.site ?? (head.site ? new URL(head.site) : undefined);
+
+/*
+ * `Astro.url.pathname` already includes `base`, and being an absolute path it
+ * replaces any path in `site` — so `site: 'https://x.com'` + `base: '/docs'`
+ * yields `https://x.com/docs/page/`. Do not prepend `base` by hand; that
+ * double-prefixes.
+ *
+ * The pathname follows whatever `trailingSlash`/`build.format` produced. Under
+ * the default `trailingSlash: 'ignore'` dev and build can disagree, so pin
+ * `'always'` or `'never'` if you need a byte-stable canonical. We deliberately
+ * don't normalise it here — rewriting the URL Astro actually serves is how you
+ * end up with a canonical that redirects.
+ */
+const seo = resolveSeo(head.seo ?? {}, Astro.props, {
+  site,
+  pathname: Astro.url.pathname,
+});
+---
+
+{seo.title && <title set:text={seo.title} />}
+{seo.description && <meta name="description" content={seo.description} />}
+{seo.canonical && <link rel="canonical" href={seo.canonical} />}
+{/* Omitted when it would only restate `index, follow`, which crawlers assume. */}
+{seo.robots && <meta name="robots" content={seo.robots} />}
+
+{seo.openGraph.map((t) => <meta property={t.property} content={t.content} />)}
+{seo.twitter.map((t) => <meta name={t.name} content={t.content} />)}
+
+{/*
+  Explicit only — see SeoProps.alternates. Nothing is inferred from a locale list,
+  because only the page knows where its own translations live.
+*/}
+{seo.alternates.map((a) => <link rel="alternate" hreflang={a.hreflang} href={a.href} />)}
+
+{seo.verification.map((t) => <meta name={t.name} content={t.content} />)}

package/src/components/Subgrid.astro

@@ -1,4 +1,19 @@
 ---
+/**
+ * Subgrid — re-emits slotted children as `<li>` items of a `.subgrid` grid, so
+ * the tranches inside each one align on shared row lines. Every declaration
+ * lives in the framework's `subgrid` pattern (patterns/subgrid.css), which is
+ * emitted in all three output formats; this file is markup only.
+ *
+ * Nothing here may reach for a Tailwind utility: Tailwind doesn't scan
+ * node_modules, so a class only it can emit is silently never generated — and
+ * classes in the generator's TW_CLASH list are stripped from the framework's
+ * own tailwind bundle by design.
+ *
+ * Size it from the consumer's own CSS, which keeps media-query overrides
+ * working: `--subgrid-cols`, `--subgrid-row-span`, `--subgrid-gap`,
+ * `--subgrid-row-gap`. `--num-items` is set here for nth-child-style maths.
+ */
 import type { HTMLAttributes } from 'astro/types';
 import { parseRenderedSlots, getAttribute, serialize, styleList } from '@getvitops/utils';
 
@@ -10,23 +25,8 @@ const nodes = parseRenderedSlots(await Astro.slots.render('default'));
 const slots = nodes.filter(node => 'tagName' in node).map(node  => ({ html: serialize(node), attrs: node.attrs }));
 ---
 
-<style>
-  ul {
-    grid-template-columns: repeat(var(--cols, var(--_cols, 1)), minmax(0, 1fr));
-  }
-
-  li {
-    --current-row: round(down, calc((sibling-index() - 1) / var(--cols)), 1);
-      
-      /* Apply the extra gap ONLY if the row index is > 0.
-         We use clamp to ensure the multiplier is either 0 or 1.
-      */
-      --row-gap-multiplier: clamp(0, var(--current-row), 1);
-      margin-block-start: calc(var(--row-gap-multiplier) * var(--row-margin));
-  }
-</style>
-<ul class:list={["grid", className]} style={styleList({'--num-items': slots.length}, style)}>
+<ul class:list={["subgrid", className]} style={styleList({'--num-items': slots.length}, style)}>
   {slots.map((slot) => (
-    <li class:list={["grid grid-rows-subgrid row-span-(--row-span)", getAttribute(slot, 'class')]} style={styleList(getAttribute(slot, 'style'))} set:html={slot.html}></li>
+    <li class:list={[getAttribute(slot, 'class')]} style={styleList(getAttribute(slot, 'style'))} set:html={slot.html}></li>
   ))}
-</ul>
+</ul>

package/src/seo.ts

@@ -0,0 +1,307 @@
+/**
+ * The `<Seo />` resolution layer — site-level defaults merged with per-page props
+ * into the exact tags to emit.
+ *
+ * Kept separate from `Seo.astro` deliberately. The component this replaces
+ * (`SEO.astro`, deleted in c949cae) fused resolution with markup, which is why it
+ * was never unit-tested and why its title handling drifted: it computed a title
+ * for `og:title` but left `<title>` to the layout, so the two could disagree.
+ * Everything decidable lives here and is asserted in `seo.test.ts`; the component
+ * only renders what this returns.
+ */
+
+/** Twitter card types, per <https://developer.x.com/en/docs/twitter-for-websites/cards>. */
+export type SeoTwitterCard = 'summary' | 'summary_large_image' | 'app' | 'player';
+
+/** Open Graph object types this component knows how to describe. */
+export type SeoOgType = 'website' | 'article' | 'profile';
+
+/**
+ * Site-level SEO defaults, passed to `getvitops({ seo })` and baked into the
+ * `virtual:getvitops/head` module. Per-page `<Seo />` props override these.
+ *
+ * The vocabulary mirrors the site-config schema's `seo` block
+ * (`@getvitops/generator`, `src/site.ts`) so a `SiteConfig` → these adapter would
+ * be a flat field map — but it is not imported from there. This is the
+ * integration's own option surface, and it must stay JSON-serialisable: it is
+ * `JSON.stringify`d into the virtual module, so no functions, no `URL`s, no dates.
+ */
+export interface GetvitopsSeoOptions {
+  /** `og:site_name`, and the `<title>` when a page passes none. */
+  siteName?: string;
+  /**
+   * Page-title pattern; `%s` is the page's own title. e.g. `'%s · Acme'`.
+   *
+   * Skipped when a page's title already equals `siteName` — a homepage titled
+   * "Acme" emits `Acme`, not `Acme · Acme` — and never applied to `defaultTitle`.
+   */
+  titleTemplate?: string;
+  /** `<title>` for pages that pass none. Used verbatim — the template is not applied. */
+  defaultTitle?: string;
+  /** `<meta name="description">` for pages that pass none. */
+  defaultDescription?: string;
+  /** Site-wide robots directive, e.g. `'index,follow,max-image-preview:large'`. */
+  robots?: string;
+  /** Google Search Console verification token. */
+  googleSiteVerification?: string;
+  /** Bing Webmaster Tools verification token. */
+  bingSiteVerification?: string;
+  openGraph?: {
+    /** Default `og:type` (default `'website'`). */
+    type?: SeoOgType;
+    /** `og:locale`. Written either way — `en-CA` and `en_CA` both emit `en_CA`. */
+    locale?: string;
+    /** Additional locales the same content exists in → `og:locale:alternate`. */
+    localeAlternates?: string[];
+    /** Fallback share image. Relative URLs resolve against `site`. */
+    image?: { url: string; alt?: string; width?: number; height?: number; type?: string };
+  };
+  twitter?: {
+    /** Card type when no image resolves (default `'summary'`). */
+    card?: SeoTwitterCard;
+    /** The site's own handle, `@acme`. */
+    site?: string;
+    /** Default author handle, `@ada`. */
+    creator?: string;
+  };
+}
+
+/** Per-page `<Seo />` props. Everything is optional; defaults fill the gaps. */
+export interface SeoProps {
+  /** Page title, before `titleTemplate` is applied. */
+  title?: string;
+  description?: string;
+  /** Overrides the computed canonical. Relative values resolve against `site`. */
+  canonical?: string;
+  /** Overrides `og:site_name` and the title fallback. */
+  siteName?: string;
+  /** Share image for this page. Relative URLs resolve against `site`. */
+  image?: string;
+  imageAlt?: string;
+  imageWidth?: number;
+  imageHeight?: number;
+  /** MIME type of the share image, e.g. `'image/png'`. */
+  imageType?: string;
+  noindex?: boolean;
+  nofollow?: boolean;
+  noarchive?: boolean;
+  nocache?: boolean;
+  /** Extra robots directives, e.g. `'max-snippet:-1'`. Appended to the composed value. */
+  robotsExtras?: string;
+  /** Full robots override. Wins over the flags above and the site default. */
+  robots?: string;
+  /** `og:type` for this page (default: the site default, else `'website'`). */
+  type?: SeoOgType;
+  /** Emitted only when `type` is `'article'`. */
+  article?: {
+    publishedTime?: string;
+    modifiedTime?: string;
+    expirationTime?: string;
+    authors?: string[];
+    section?: string;
+    tags?: string[];
+  };
+  /** `og:locale` for this page. */
+  locale?: string;
+  /** Twitter author handle for this page, `@ada`. */
+  twitterCreator?: string;
+  /**
+   * Translations of *this* page, as `<link rel="alternate" hreflang>`.
+   *
+   * Explicit only, and it must include the current page. Nothing is inferred:
+   * the deleted component derived alternates from the site's locale list and
+   * pointed every one of them at that locale's homepage, so every page on the
+   * site claimed the homepage as its translation. Only the page knows its own
+   * translated URLs. Pass `hreflang: 'x-default'` for the fallback entry.
+   */
+  alternates?: { hreflang: string; href: string }[];
+}
+
+/** A `<meta property>` tag (Open Graph uses `property`, not `name`). */
+export interface SeoPropertyTag {
+  property: string;
+  content: string;
+}
+
+/** A `<meta name>` tag. */
+export interface SeoNameTag {
+  name: string;
+  content: string;
+}
+
+/** Everything `<Seo />` renders, already decided. `null` means "emit nothing". */
+export interface ResolvedSeo {
+  title: string | null;
+  description: string | null;
+  canonical: string | null;
+  robots: string | null;
+  openGraph: SeoPropertyTag[];
+  twitter: SeoNameTag[];
+  verification: SeoNameTag[];
+  alternates: { hreflang: string; href: string }[];
+}
+
+/** Render context supplied by the component from `Astro`. */
+export interface SeoContext {
+  /**
+   * The deployed origin — `Astro.site`, or `config.site` via the virtual module.
+   *
+   * `undefined` when neither is set, and then every absolute-URL tag is dropped
+   * rather than being derived from the request. `astro-seo` falls back to
+   * `Astro.url` here; on a static build that is `http://localhost:4321`, which
+   * would bake a localhost canonical into production HTML.
+   */
+  site?: URL | undefined;
+  /** `Astro.url.pathname` — already includes `base`. */
+  pathname: string;
+  /** `Astro.url.search`, if the canonical should keep the query string. */
+  search?: string;
+}
+
+/** `en-CA` → `en_CA`; Open Graph wants the underscore form. */
+const ogLocale = (locale: string) => locale.replace('-', '_');
+
+/**
+ * Absolute URLs pass through; relative ones resolve against `site`, or are
+ * dropped when there is no `site` to resolve them against. A relative `og:image`
+ * or canonical is worse than none — crawlers resolve it against whatever origin
+ * served the page.
+ */
+function absolute(url: string | undefined, site: URL | undefined): string | null {
+  if (!url) return null;
+  try {
+    return new URL(url).href;
+  } catch {
+    return site ? new URL(url, site).href : null;
+  }
+}
+
+/** Composes the robots directive, or null when nothing meaningful was asked for. */
+function resolveRobots(props: SeoProps, defaults: GetvitopsSeoOptions): string | null {
+  if (props.robots) return props.robots;
+  const { noindex, nofollow, noarchive, nocache, robotsExtras } = props;
+  if (noindex || nofollow || noarchive || nocache || robotsExtras) {
+    return [
+      noindex ? 'noindex' : 'index',
+      nofollow ? 'nofollow' : 'follow',
+      ...(noarchive ? ['noarchive'] : []),
+      ...(nocache ? ['nocache'] : []),
+      ...(robotsExtras ? [robotsExtras] : []),
+    ].join(', ');
+  }
+  // No explicit default either: emit nothing. `index, follow` is what crawlers
+  // already assume, so stating it adds bytes and no meaning.
+  return defaults.robots ?? null;
+}
+
+/**
+ * Merges site defaults with page props into the final tag set.
+ *
+ * Pure — no `Astro`, no filesystem, no config lookup. Everything it needs comes
+ * through its three arguments, which is what makes it testable and what keeps the
+ * package free of the consumer-global coupling that sank the previous site model.
+ */
+export function resolveSeo(
+  defaults: GetvitopsSeoOptions,
+  props: SeoProps,
+  ctx: SeoContext,
+): ResolvedSeo {
+  const { site } = ctx;
+  const siteName = props.siteName ?? defaults.siteName ?? null;
+
+  // The template applies to a page's own title only, and only when that title
+  // isn't already the site name. Two ways to get "Acme · Acme" otherwise: running
+  // it over `defaultTitle`, and a homepage whose own title happens to equal the
+  // site name — which is the common case, not an edge case.
+  const templated = props.title && defaults.titleTemplate && props.title !== siteName;
+  const title = props.title
+    ? templated
+      ? String(defaults.titleTemplate).replaceAll('%s', props.title)
+      : props.title
+    : (defaults.defaultTitle ?? siteName);
+
+  const description = props.description ?? defaults.defaultDescription ?? null;
+
+  const canonical = props.canonical
+    ? absolute(props.canonical, site)
+    : site
+      ? new URL(ctx.pathname + (ctx.search ?? ''), site).href
+      : null;
+
+  const image = absolute(props.image, site) ?? absolute(defaults.openGraph?.image?.url, site);
+  // Only inherit the default image's metadata when the page didn't bring its own
+  // image — otherwise a page's image would carry the default's alt text.
+  const usingDefaultImage = !props.image;
+  const defaultImage = defaults.openGraph?.image;
+  const imageAlt = props.imageAlt ?? (usingDefaultImage ? defaultImage?.alt : undefined);
+  const imageWidth = props.imageWidth ?? (usingDefaultImage ? defaultImage?.width : undefined);
+  const imageHeight = props.imageHeight ?? (usingDefaultImage ? defaultImage?.height : undefined);
+  const imageType = props.imageType ?? (usingDefaultImage ? defaultImage?.type : undefined);
+
+  const type = props.type ?? defaults.openGraph?.type ?? 'website';
+  const locale = props.locale ?? defaults.openGraph?.locale;
+
+  const openGraph: SeoPropertyTag[] = [];
+  const og = (property: string, content: string | number | null | undefined) => {
+    if (content !== null && content !== undefined && content !== '')
+      openGraph.push({ property, content: String(content) });
+  };
+
+  og('og:type', type);
+  og('og:title', title);
+  og('og:description', description);
+  og('og:url', canonical);
+  og('og:site_name', siteName);
+  og('og:locale', locale ? ogLocale(locale) : null);
+  for (const alt of defaults.openGraph?.localeAlternates ?? [])
+    og('og:locale:alternate', ogLocale(alt));
+  og('og:image', image);
+  if (image) {
+    og('og:image:alt', imageAlt);
+    og('og:image:width', imageWidth);
+    og('og:image:height', imageHeight);
+    og('og:image:type', imageType);
+  }
+  if (type === 'article' && props.article) {
+    const a = props.article;
+    og('article:published_time', a.publishedTime);
+    og('article:modified_time', a.modifiedTime);
+    og('article:expiration_time', a.expirationTime);
+    for (const author of a.authors ?? []) og('article:author', author);
+    og('article:section', a.section);
+    for (const tag of a.tags ?? []) og('article:tag', tag);
+  }
+
+  const twitter: SeoNameTag[] = [];
+  const tw = (name: string, content: string | null | undefined) => {
+    if (content) twitter.push({ name, content });
+  };
+  // A card with a large image is only honoured if there *is* an image.
+  tw('twitter:card', image ? 'summary_large_image' : (defaults.twitter?.card ?? 'summary'));
+  tw('twitter:site', defaults.twitter?.site);
+  tw('twitter:creator', props.twitterCreator ?? defaults.twitter?.creator);
+  tw('twitter:title', title);
+  tw('twitter:description', description);
+  tw('twitter:image', image);
+  tw('twitter:image:alt', image ? imageAlt : null);
+
+  const verification: SeoNameTag[] = [];
+  if (defaults.googleSiteVerification)
+    verification.push({
+      name: 'google-site-verification',
+      content: defaults.googleSiteVerification,
+    });
+  if (defaults.bingSiteVerification)
+    verification.push({ name: 'msvalidate.01', content: defaults.bingSiteVerification });
+
+  return {
+    title,
+    description,
+    canonical,
+    robots: resolveRobots(props, defaults),
+    openGraph,
+    twitter,
+    verification,
+    alternates: props.alternates ?? [],
+  };
+}

package/virtual.d.ts

@@ -6,12 +6,22 @@ declare module 'virtual:getvitops/head' {
     type?: string;
     sizes?: string;
   }
+  // Keep these keys in step with `HeadData` in src/integration.ts — the two are
+  // hand-duplicated (an ambient `declare module` in a shipped .d.ts cannot import
+  // from src), and `head.test.ts` asserts the key sets match.
   interface HeadData {
     favicons: boolean;
     faviconLinks: FaviconLink[];
     themeColor: string | null;
     webComponents: boolean;
     wcBase: string;
+    editor: boolean;
+    sitemap: string | null;
+    site: string | null;
+    // Structurally `GetvitopsSeoOptions` (src/seo.ts). Left loose here because
+    // this file can't import from src, and <Seo /> re-types it on the way into
+    // `resolveSeo`, which is where the real contract is enforced.
+    seo: Record<string, unknown>;
   }
   const data: HeadData;
   export default data;