@getvitops/astro 8.2.0-alpha.0 → 8.2.0

package/dist/config-adapters-CbTywgEY.mjs

@@ -0,0 +1,71 @@
+import { t } from "@getvitops/utils/content";
+
+// src/routes/config-adapters.ts
+/**
+* Resolves the one display name for a site's organization — `organization.name`
+* (localizable; `locale` picks which one, defaulting to `site.defaultLocale`,
+* which is also the fallback if the pick has no entry), falling back to
+* `legalName` when `name` isn't set at all, and to `undefined` (never `''`)
+* when neither resolves to anything — `t()` returns `''` for a genuinely
+* missing translation, and an empty name is worse than none.
+*
+* This is the one place that fallback chain is written. An EmDash site's own
+* `getSiteSettings().title` is a separate, runtime-only fact (EmDash's
+* settings aren't readable at Astro build/config time at all — see
+* AGENTS.md's "EmDash plugin as the design-system editing surface") and stays
+* authoritative for what it drives (the rendered page chrome); this helper is
+* for the build-time-only consumers that can't reach EmDash at all — favicon
+* generation, generated legal documents, notification emails — so a scaffold
+* needing a name in `astro.config.mjs` has one real source instead of a third
+* hardcoded string.
+*/
+function resolveOrganizationName(config, locale) {
+	const org = config.organization;
+	const resolvedLocale = locale ?? config.site.defaultLocale;
+	return (org?.name != null ? t(org.name, resolvedLocale, config.site.defaultLocale) || void 0 : void 0) ?? org?.legalName;
+}
+/**
+* Builds the `context` option `createConversionRoute()` expects, straight from a
+* resolved `Config` — instead of every consumer hand-writing a `NotifyContext`
+* literal.
+*
+* `locationEmails` is primary-first, then every other location with an `email`,
+* in `organization.locations`' own key order — `planNotifications` picks the
+* first that's set, so order here is the whole precedence.
+*/
+function toNotifyContext(config, locale) {
+	const org = config.organization;
+	const primaryKey = org?.primaryLocation;
+	const locationEmails = Object.entries(org?.locations ?? {}).sort(([a], [b]) => a === primaryKey ? -1 : b === primaryKey ? 1 : 0).map(([, loc]) => loc.email).filter((email) => !!email);
+	return {
+		notifications: config.site.notifications,
+		canonical: config.site.domains?.canonical,
+		organizationName: resolveOrganizationName(config, locale),
+		locationEmails
+	};
+}
+/**
+* `site.crm` IS `CrmConfig` — both are the schema's inferred type from `@getvitops/config` — so
+* this returns its argument's field unchanged.
+*
+* @deprecated Pass `config.site.crm` directly. Kept so existing callers keep compiling; it
+* stopped being an adapter when the type stopped being a copy.
+*/
+function toCrmConfig(config) {
+	return config.site.crm;
+}
+/**
+* `site.ads.google`'s three server-side-relevant fields, for
+* `createConversionRoute`'s `googleAdsOffline.config`. Undefined when the site has no Google Ads
+* property configured at all, which `createConversionRoute` reads the same way `crm` being
+* omitted does: the upload never runs.
+*
+* @deprecated Pass `config.site.ads?.google` directly — it is already assignable. Kept so existing
+* callers keep compiling.
+*/
+function toGoogleAdsConfig(config) {
+	return config.site.ads?.google;
+}
+
+export { toNotifyContext as i, toCrmConfig as n, toGoogleAdsConfig as r, resolveOrganizationName as t };
+//# sourceMappingURL=config-adapters-CbTywgEY.mjs.map

package/dist/config-adapters-CbTywgEY.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-adapters-CbTywgEY.mjs","names":[],"sources":["../src/routes/config-adapters.ts"],"sourcesContent":["/**\n * Adapts a resolved `Config` (`@getvitops/generator`) into the structural shapes\n * `createConversionRoute()` expects — `context: NotifyContext` and `crm.config:\n * CrmConfig`. Neither of those types can import `Config` themselves (they live in\n * `@getvitops/utils`, which the generator already depends on — importing back\n * would be a cycle), which is why `conversion.ts`'s own docblock used to describe\n * `toNotifyContext(config)` as a helper that \"does not exist.\" This package\n * already depends on both the generator and utils, so it's the one place the\n * adapter can live.\n *\n * `import type` only — erased at build, so pulling in `Config`'s type costs\n * nothing at runtime and doesn't drag the generator's `node:fs`/lightningcss\n * entry point into a Worker bundle.\n */\nimport type { Config } from '@getvitops/generator';\n// The `/content` subpath, not the root barrel: the root re-exports `favicon` (sharp), and a\n// Worker route should not depend on tree-shaking to keep it out.\nimport { t, type Localizable } from '@getvitops/utils/content';\nimport type { AdPropertySetup } from '@getvitops/utils/ads';\nimport type { CrmConfig } from '@getvitops/utils/crm';\nimport type { NotifyContext } from '@getvitops/utils/notify';\n\n/**\n * The slice of a `Config` that `resolveOrganizationName` reads. Structural on\n * purpose: `import config from './site.json'` types its literals widened\n * (`colors.utilities` becomes `string[]`, not the schema's union), so it is not\n * assignable to the full `Config`, and every scaffolded site calls this with\n * exactly such an import. A resolved `Config` still satisfies it.\n */\nexport interface OrganizationNameSource {\n  organization?: { name?: Localizable | undefined; legalName?: string | undefined } | undefined;\n  site: { defaultLocale: string };\n}\n\n/**\n * Resolves the one display name for a site's organization — `organization.name`\n * (localizable; `locale` picks which one, defaulting to `site.defaultLocale`,\n * which is also the fallback if the pick has no entry), falling back to\n * `legalName` when `name` isn't set at all, and to `undefined` (never `''`)\n * when neither resolves to anything — `t()` returns `''` for a genuinely\n * missing translation, and an empty name is worse than none.\n *\n * This is the one place that fallback chain is written. An EmDash site's own\n * `getSiteSettings().title` is a separate, runtime-only fact (EmDash's\n * settings aren't readable at Astro build/config time at all — see\n * AGENTS.md's \"EmDash plugin as the design-system editing surface\") and stays\n * authoritative for what it drives (the rendered page chrome); this helper is\n * for the build-time-only consumers that can't reach EmDash at all — favicon\n * generation, generated legal documents, notification emails — so a scaffold\n * needing a name in `astro.config.mjs` has one real source instead of a third\n * hardcoded string.\n */\nexport function resolveOrganizationName(\n  config: OrganizationNameSource,\n  locale?: string,\n): string | undefined {\n  const org = config.organization;\n  const resolvedLocale = locale ?? config.site.defaultLocale;\n  const name =\n    org?.name != null\n      ? t(org.name, resolvedLocale, config.site.defaultLocale) || undefined\n      : undefined;\n  return name ?? org?.legalName;\n}\n\n/**\n * Builds the `context` option `createConversionRoute()` expects, straight from a\n * resolved `Config` — instead of every consumer hand-writing a `NotifyContext`\n * literal.\n *\n * `locationEmails` is primary-first, then every other location with an `email`,\n * in `organization.locations`' own key order — `planNotifications` picks the\n * first that's set, so order here is the whole precedence.\n */\nexport function toNotifyContext(config: Config, locale?: string): NotifyContext {\n  const org = config.organization;\n  const primaryKey = org?.primaryLocation;\n  const locationEmails = Object.entries(org?.locations ?? {})\n    .sort(([a], [b]) => (a === primaryKey ? -1 : b === primaryKey ? 1 : 0))\n    .map(([, loc]) => loc.email)\n    .filter((email): email is string => !!email);\n\n  return {\n    notifications: config.site.notifications,\n    canonical: config.site.domains?.canonical,\n    organizationName: resolveOrganizationName(config, locale),\n    locationEmails,\n  };\n}\n\n/**\n * `site.crm` IS `CrmConfig` — both are the schema's inferred type from `@getvitops/config` — so\n * this returns its argument's field unchanged.\n *\n * @deprecated Pass `config.site.crm` directly. Kept so existing callers keep compiling; it\n * stopped being an adapter when the type stopped being a copy.\n */\nexport function toCrmConfig(config: Config): CrmConfig | undefined {\n  return config.site.crm;\n}\n\n/**\n * `site.ads.google`'s three server-side-relevant fields, for\n * `createConversionRoute`'s `googleAdsOffline.config`. Undefined when the site has no Google Ads\n * property configured at all, which `createConversionRoute` reads the same way `crm` being\n * omitted does: the upload never runs.\n *\n * @deprecated Pass `config.site.ads?.google` directly — it is already assignable. Kept so existing\n * callers keep compiling.\n */\nexport function toGoogleAdsConfig(\n  config: Config,\n): Pick<AdPropertySetup, 'accountId' | 'conversionActionId' | 'reporting'> | undefined {\n  return config.site.ads?.google;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoDA,SAAgB,wBACd,QACA,QACoB;CACpB,MAAM,MAAM,OAAO;CACnB,MAAM,iBAAiB,UAAU,OAAO,KAAK;CAK7C,QAHE,KAAK,QAAQ,OACT,EAAE,IAAI,MAAM,gBAAgB,OAAO,KAAK,aAAa,KAAK,SAC1D,WACS,KAAK;AACtB;;;;;;;;;;AAWA,SAAgB,gBAAgB,QAAgB,QAAgC;CAC9E,MAAM,MAAM,OAAO;CACnB,MAAM,aAAa,KAAK;CACxB,MAAM,iBAAiB,OAAO,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,CACxD,MAAM,CAAC,IAAI,CAAC,OAAQ,MAAM,aAAa,KAAK,MAAM,aAAa,IAAI,CAAE,CAAC,CACtE,KAAK,GAAG,SAAS,IAAI,KAAK,CAAC,CAC3B,QAAQ,UAA2B,CAAC,CAAC,KAAK;CAE7C,OAAO;EACL,eAAe,OAAO,KAAK;EAC3B,WAAW,OAAO,KAAK,SAAS;EAChC,kBAAkB,wBAAwB,QAAQ,MAAM;EACxD;CACF;AACF;;;;;;;;AASA,SAAgB,YAAY,QAAuC;CACjE,OAAO,OAAO,KAAK;AACrB;;;;;;;;;;AAWA,SAAgB,kBACd,QACqF;CACrF,OAAO,OAAO,KAAK,KAAK;AAC1B"}

package/dist/exports/tracking.d.mts

@@ -1,3 +1,3 @@
-import { a as TRACKING_ENDPOINT } from "../tracking-BNKKBqOe.mjs";
+import { a as TRACKING_ENDPOINT } from "../tracking-D2xOzjFD.mjs";
 export * from "@getvitops/utils/tracking";
 export { TRACKING_ENDPOINT };

package/dist/exports/tracking.mjs

@@ -1,4 +1,4 @@
-import { n as TRACKING_ENDPOINT } from "../tracking-M2PqlMpw.mjs";
+import { n as TRACKING_ENDPOINT } from "../tracking-Cb3A0BrC.mjs";
 
 export * from "@getvitops/utils/tracking"
 

package/dist/index.d.mts

@@ -1,11 +1,11 @@
-import { i as TRACKING_COOKIE, n as ResolveTrackingContext, o as TrackingCategory, r as ResolvedTracking, s as resolveTracking, t as GetvitopsTrackingOptions } from "./tracking-BNKKBqOe.mjs";
-import { LegalOutput, SiteFont, StylesheetFormat } from "@getvitops/generator";
+import { i as TRACKING_COOKIE, n as ResolveTrackingContext, o as TrackingCategory, r as ResolvedTracking, s as resolveTracking, t as GetvitopsTrackingOptions } from "./tracking-D2xOzjFD.mjs";
+import { Config, LegalOutput, SiteFont, StylesheetFormat } from "@getvitops/generator";
 import { generateIconInclude } from "@getvitops/utils";
-import { AdProvider, ConversionLabelMap } from "@getvitops/utils/ads";
+import { AdProvider } from "@getvitops/utils/ads";
+import { AdPropertyConfig } from "@getvitops/config";
 import { OutputKind } from "@getvitops/utils/media";
 import { AstroIntegration } from "astro";
 export * from "@getvitops/utils";
-//#region src/analytics.d.ts
 /**
  * The `<Analytics />` resolution layer — provider config in, the exact tags to
  * emit out.
@@ -175,8 +175,6 @@ interface ResolveAnalyticsContext {
 export declare function resolveAnalytics(opts: GetvitopsAnalyticsOptions | undefined, ctx?: ResolveAnalyticsContext): ResolvedAnalytics;
 /** Which optional categories a set of tags actually needs a visitor to decide. */
 export declare function consentCategories(tags: GatedTag[]): OptionalConsentCategory[];
-//#endregion
-//#region src/seo.d.ts
 /**
  * The `<Seo />` resolution layer — site-level defaults merged with per-page props
  * into the exact tags to emit.
@@ -196,11 +194,12 @@ type SeoOgType = 'website' | 'article' | 'profile';
  * Site-level SEO defaults, passed to `vitops({ 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/config.ts`) so a `Config` → 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.
+ * `site.seo` in the site config is the source (`@getvitops/config`'s `SeoSchema`);
+ * `resolveSeoDefaults()` turns it into this shape for a build locale, and `vitops({ seo })` is merged
+ * over the result as an override. This interface is therefore the *resolved* shape — plain strings,
+ * `Localizable` already picked — and must stay JSON-serialisable: it is `JSON.stringify`d into the
+ * virtual module, so no functions, no `URL`s, no dates. `seo-defaults.test.ts` fails when a
+ * `site.seo` field is added to the schema and not read here (ADR-0002).
  */
 interface GetvitopsSeoOptions {
   /** `og:site_name`, and the `<title>` when a page passes none. */
@@ -361,8 +360,6 @@ interface SeoContext {
  * package free of the consumer-global coupling that sank the previous site model.
  */
 export declare function resolveSeo(defaults: GetvitopsSeoOptions, props: SeoProps, ctx: SeoContext): ResolvedSeo;
-//#endregion
-//#region src/integration.d.ts
 interface GetvitopsFaviconOptions {
   /** Source SVG or PNG. */
   source: string;
@@ -643,8 +640,11 @@ interface GetvitopsOptions {
   sitemap?: boolean | GetvitopsSitemapOptions;
   /**
    * Site-level defaults for `<Seo />` (`@getvitops/astro/Seo.astro`) — site name,
-   * title template, Open Graph + Twitter defaults, verification tokens. Off unless
-   * provided; per-page props override every field.
+   * title template, Open Graph + Twitter defaults, verification tokens.
+   *
+   * These come from `site.seo` in the site config (with `organization.name` as the site
+   * name); this option is an **override** merged over that, field by field, for a value
+   * an app wants to set in code. Per-page props override both.
    *
    * Needs the `site` astro.config option for canonical and `og:url`; without it
    * `<Seo />` omits every absolute-URL tag rather than deriving one from the
@@ -770,32 +770,13 @@ interface GetvitopsIconsOptions {
   overrides?: Record<string, string>;
 }
 export default function vitops(opts?: GetvitopsOptions): AstroIntegration;
-//#endregion
-//#region src/ads.d.ts
 /**
- * One ad property, mirroring a `site.ads` entry field for field.
- *
- * Structural rather than `SiteAdProperty` imported from the generator, matching
- * how `GetvitopsSeoOptions` and `GetvitopsTrackingOptions` already work: the
- * component surface must stay usable by a consumer who passes a plain object.
+ * One ad property, as `<Ads />` reads it: the fields of a `site.ads` entry that decide what is
+ * emitted. A subset of `AdPropertyConfig` from `@getvitops/config` — the schema's own inferred
+ * type, not a copy — so a plain object is still enough for a consumer to pass, and a field the
+ * schema renames fails here instead of silently reading `undefined`.
  */
-interface GetvitopsAdProperty {
-  accountId?: string;
-  pixelId?: string;
-  /**
-   * Google Ads only: the conversion action label(s) paired with `pixelId` (the
-   * `AW-…` conversion id) — a bare string (back-compat, treated as `call`) or a
-   * map of action → label. `<Tracking />`'s tel:/mailto: click handler and
-   * `vitopsFormConversion()` each fire `gtag('event', 'conversion', …)` for
-   * their own action at the moment of the interaction — see `gtagBootstrap` in
-   * `@getvitops/utils/ads`.
-   */
-  conversionLabel?: string | ConversionLabelMap;
-  /** Default `marketing`. `analytics` for a property used purely for measurement. */
-  category?: 'marketing' | 'analytics';
-  /** False keeps the property on record without emitting its tag. */
-  enabled?: boolean;
-}
+type GetvitopsAdProperty = Pick<AdPropertyConfig, 'accountId' | 'pixelId' | 'conversionLabel' | 'conversionActionId' | 'reporting' | 'category' | 'enabled'>;
 type GetvitopsAdsOptions = Partial<Record<AdProvider, GetvitopsAdProperty>>;
 /** One ad tag. `key` is the platform, so a caller can find one without matching prose. */
 interface ResolvedAdTag extends GatedTag {
@@ -820,8 +801,6 @@ interface ResolveAdsContext {
 }
 /** Resolve the configured ad properties into the tags `<Ads />` emits. */
 export declare function resolveAds(ads: GetvitopsAdsOptions | undefined, ctx?: ResolveAdsContext): ResolvedAds;
-//#endregion
-//#region src/lastmod.d.ts
 interface GitLastmodOptions {
   /** Directories to read history from (default `src/pages`, `src/content`, `src/data`). */
   dirs?: string[];
@@ -849,6 +828,17 @@ export declare function slugFromContent(file: string): string | undefined;
  * flip presented as a fact.
  */
 export declare function gitLastmod(options?: GitLastmodOptions): Promise<(item: GetvitopsSitemapEntry) => GetvitopsSitemapEntry>;
-//#endregion
-export { type AnalyticsStrategy, type ClarityOptions, type ConsentCategory, type GatedTag, type GetvitopsAdProperty, type GetvitopsAdsOptions, type GetvitopsAnalyticsOptions, type GetvitopsConsentOptions, type GetvitopsCssOptions, type GetvitopsFaviconOptions, type GetvitopsMediaOptions, type GetvitopsOptions, type GetvitopsSeoOptions, type GetvitopsSitemapChangeFreq, type GetvitopsSitemapEntry, type GetvitopsSitemapOptions, type GetvitopsTrackingOptions, type GitLastmodOptions, type GoogleAnalyticsOptions, type MatomoOptions, type OptionalConsentCategory, type PlausibleOptions, type ResolveAdsContext, type ResolveAnalyticsContext, type ResolveTrackingContext, type ResolvedAdTag, type ResolvedAds, type ResolvedAnalytics, type ResolvedSeo, type ResolvedTag, type ResolvedTracking, type SeoContext, type SeoNameTag, type SeoOgType, type SeoPropertyTag, type SeoProps, type SeoTwitterCard, TRACKING_COOKIE, type TrackingCategory, resolveTracking };
+interface ResolveSeoDefaultsOptions {
+  /** Build locale. Default `site.defaultLocale`; a value with no entry falls back to the default. */
+  locale?: string;
+  /** Which `site.environments` entry to read `robots` from. Default `'production'`. */
+  env?: string;
+}
+export declare function resolveSeoDefaults(config: Config, options?: ResolveSeoDefaultsOptions): GetvitopsSeoOptions;
+/**
+ * Merge `vitops({ seo })` over config-derived defaults. The two nested objects merge key by key, so
+ * setting `openGraph.locale` in code doesn't discard the config's fallback image.
+ */
+export declare function mergeSeoDefaults(fromConfig: GetvitopsSeoOptions, override: GetvitopsSeoOptions | undefined): GetvitopsSeoOptions;
+export { type AnalyticsStrategy, type ClarityOptions, type ConsentCategory, type GatedTag, type GetvitopsAdProperty, type GetvitopsAdsOptions, type GetvitopsAnalyticsOptions, type GetvitopsConsentOptions, type GetvitopsCssOptions, type GetvitopsFaviconOptions, type GetvitopsMediaOptions, type GetvitopsOptions, type GetvitopsSeoOptions, type GetvitopsSitemapChangeFreq, type GetvitopsSitemapEntry, type GetvitopsSitemapOptions, type GetvitopsTrackingOptions, type GitLastmodOptions, type GoogleAnalyticsOptions, type MatomoOptions, type OptionalConsentCategory, type PlausibleOptions, type ResolveAdsContext, type ResolveAnalyticsContext, type ResolveSeoDefaultsOptions, type ResolveTrackingContext, type ResolvedAdTag, type ResolvedAds, type ResolvedAnalytics, type ResolvedSeo, type ResolvedTag, type ResolvedTracking, type SeoContext, type SeoNameTag, type SeoOgType, type SeoPropertyTag, type SeoProps, type SeoTwitterCard, TRACKING_COOKIE, type TrackingCategory, resolveTracking };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":["MediaOutputKind"],"sources":["../src/analytics.ts","../src/seo.ts","../src/integration.ts","../src/ads.ts","../src/lastmod.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":["MediaOutputKind"],"sources":["../src/analytics.ts","../src/seo.ts","../src/integration.ts","../src/ads.ts","../src/lastmod.ts","../src/seo-defaults.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -1,4 +1,5 @@
-import { n as TRACKING_ENDPOINT, r as resolveTracking, t as TRACKING_COOKIE } from "./tracking-M2PqlMpw.mjs";
+import { t as resolveOrganizationName } from "./config-adapters-CbTywgEY.mjs";
+import { n as TRACKING_ENDPOINT, r as resolveTracking, t as TRACKING_COOKIE } from "./tracking-Cb3A0BrC.mjs";
 import { cpSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -7,12 +8,13 @@ import { collectIconRefs, faviconLinks, generateFavicons, generateIconInclude, r
 import vitopsPlugin from "@getvitops/vite";
 import { AD_PLATFORMS, AD_PROVIDER_KEYS, normalizeConversionLabels } from "@getvitops/utils/ads";
 import { fontProviders } from "astro/config";
+import { t } from "@getvitops/utils/content";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 
 export * from "@getvitops/utils"
 
-//#region src/analytics.ts
+// src/analytics.ts
 /**
 * A small inline snippet reading each experiment's cookie into a plain
 * object, skipping any experiment whose cookie isn't set (visitor not yet
@@ -195,8 +197,7 @@ function consentCategories(tags) {
 	].filter((c) => used.has(c));
 }
 
-//#endregion
-//#region src/ads.ts
+// src/ads.ts
 /**
 * The `<Ads />` resolution layer — the site's ad properties in, the exact tags to
 * emit out.
@@ -306,8 +307,7 @@ function resolveAds(ads, ctx = {}) {
 	};
 }
 
-//#endregion
-//#region src/fonts.ts
+// src/fonts.ts
 /**
 * Provider names, matching `fontProviders`' keys 1:1 (verified against astro@7.1.2).
 * The generator's `SiteFontSchema` enumerates the same set, so a mismatch is a
@@ -359,8 +359,7 @@ function resolveFonts(decls) {
 	};
 }
 
-//#endregion
-//#region src/i18n.ts
+// src/i18n.ts
 function codesOf(entry) {
 	return typeof entry === "string" ? [entry] : entry.codes;
 }
@@ -384,8 +383,69 @@ function localeConsistencyWarnings(site, i18n) {
 	return warnings;
 }
 
-//#endregion
-//#region src/integration.ts
+// src/seo-defaults.ts
+/** Drop `undefined`/empty-string keys so the result carries only what the config actually states. */
+function compact(value) {
+	return Object.fromEntries(Object.entries(value).filter(([, v]) => v !== void 0 && v !== ""));
+}
+function resolveSeoDefaults(config, options = {}) {
+	const seo = config.site.seo;
+	const defaultLocale = config.site.defaultLocale;
+	const locale = options.locale ?? defaultLocale;
+	const text = (value) => t(value, locale, defaultLocale) || void 0;
+	const robots = config.site.environments?.[options.env ?? "production"]?.robots ?? seo?.robots;
+	const image = seo?.openGraph?.image;
+	const openGraph = compact({
+		type: seo?.openGraph?.type,
+		locale: seo?.openGraph?.locale,
+		localeAlternates: seo?.openGraph?.localeAlternates,
+		image: image === void 0 ? void 0 : typeof image === "string" ? { url: image } : compact({
+			url: image.src,
+			alt: image.alt,
+			width: image.width,
+			height: image.height,
+			type: image.type
+		})
+	});
+	const twitter = compact({
+		card: seo?.twitter?.card,
+		site: seo?.twitter?.site,
+		creator: seo?.twitter?.creator
+	});
+	return compact({
+		siteName: text(seo?.siteName) ?? resolveOrganizationName(config, locale),
+		titleTemplate: text(seo?.titleTemplate),
+		defaultTitle: text(seo?.defaultTitle),
+		defaultDescription: text(seo?.defaultDescription),
+		robots,
+		googleSiteVerification: seo?.googleSiteVerification,
+		bingSiteVerification: seo?.bingSiteVerification,
+		...Object.keys(openGraph).length ? { openGraph } : {},
+		...Object.keys(twitter).length ? { twitter } : {}
+	});
+}
+/**
+* Merge `vitops({ seo })` over config-derived defaults. The two nested objects merge key by key, so
+* setting `openGraph.locale` in code doesn't discard the config's fallback image.
+*/
+function mergeSeoDefaults(fromConfig, override) {
+	if (!override) return fromConfig;
+	const merged = {
+		...fromConfig,
+		...override
+	};
+	if (fromConfig.openGraph || override.openGraph) merged.openGraph = {
+		...fromConfig.openGraph,
+		...override.openGraph
+	};
+	if (fromConfig.twitter || override.twitter) merged.twitter = {
+		...fromConfig.twitter,
+		...override.twitter
+	};
+	return merged;
+}
+
+// src/integration.ts
 /**
 * @getvitops/astro — the Astro integration. One entry wires the design system's
 * `<head>` contributions into a consumer site:
@@ -444,6 +504,20 @@ function readSiteLocales(configPath, siteEnv) {
 	}
 }
 /**
+* Resolve `site.seo` (plus `organization.name` as the site-name fallback) out of the site config.
+*
+* Best-effort, like `readSiteLocales`: a malformed or missing config is silence here, since every
+* other consumer of the file validates it loudly in the same hook. An empty object means "the
+* config states no SEO defaults", which is also what no site config at all means.
+*/
+function readSiteSeo(configPath, siteEnv) {
+	try {
+		return resolveSeoDefaults(resolveConfig(JSON.parse(readFileSync(configPath, "utf8")), siteEnv), { env: siteEnv });
+	} catch {
+		return {};
+	}
+}
+/**
 * Read `site.ads` and this environment's ads switch out of the site config.
 *
 * Best-effort, like `undisclosedProviders`: every other consumer of this file
@@ -677,7 +751,8 @@ function vitops(opts = {}) {
 				const siteLocales = readSiteLocales(resolve(root, siteInput), opts.site?.siteEnv ?? "production");
 				for (const warning of localeConsistencyWarnings(siteLocales, config.i18n)) logger.warn(warning);
 			}
-			if (opts.seo) {
+			const seoDefaults = mergeSeoDefaults(siteInput ? readSiteSeo(resolve(root, siteInput), opts.site?.siteEnv ?? "production") : {}, opts.seo);
+			if (opts.seo || Object.keys(seoDefaults).some((k) => k !== "siteName")) {
 				if (!config.site) logger.warn("seo: needs the `site` astro.config option (your deployed URL) — without it <Seo /> omits canonical, og:url and any relative og:image rather than guessing an origin.");
 				if (config.integrations.some((i) => i.name === "emdash")) logger.warn("seo: emdash() is registered, and its <EmDashHead> emits the same title/description/canonical/og tags from the CMS. Use one or the other — rendering both duplicates every tag.");
 			}
@@ -914,7 +989,7 @@ function vitops(opts = {}) {
 				sitemap: sitemapHref,
 				fonts: headFonts,
 				site: config.site ?? null,
-				seo: opts.seo ?? {},
+				seo: seoDefaults,
 				analytics: opts.analytics ?? {},
 				consent: consentEnabled,
 				consentCategories: offeredCategories,
@@ -973,8 +1048,7 @@ function vitops(opts = {}) {
 	};
 }
 
-//#endregion
-//#region src/lastmod.ts
+// src/lastmod.ts
 /**
 * Real per-page `<lastmod>` for the sitemap, derived from git.
 *
@@ -1133,8 +1207,7 @@ async function gitLastmod(options = {}) {
 	};
 }
 
-//#endregion
-//#region src/seo.ts
+// src/seo.ts
 /** `en-CA` → `en_CA`; Open Graph wants the underscore form. */
 const ogLocale = (locale) => locale.replace("-", "_");
 /**
@@ -1255,6 +1328,5 @@ function resolveSeo(defaults, props, ctx) {
 	};
 }
 
-//#endregion
-export { TRACKING_COOKIE, consentCategories, vitops as default, gitLastmod, resolveAds, resolveAnalytics, resolveSeo, resolveTracking, routeFromPage, slugFromContent };
+export { TRACKING_COOKIE, consentCategories, vitops as default, gitLastmod, mergeSeoDefaults, resolveAds, resolveAnalytics, resolveSeo, resolveSeoDefaults, resolveTracking, routeFromPage, slugFromContent };
 //# sourceMappingURL=index.mjs.map