@getvitops/astro 8.1.0 → 8.2.0

package/src/schemas/Article.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 import { articleGraph } from '@getvitops/utils/schema';
 import type { ArticleGraphOptions } from '@getvitops/utils/schema';
 
@@ -7,5 +8,5 @@ export type Props = ArticleGraphOptions;
 const jsonLd = articleGraph(Astro.props);
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/BookActions.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Props {
   name: string;
   author: string | string[];
@@ -77,5 +78,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/Breadcrumb.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 import { breadcrumbGraph } from '@getvitops/utils/schema';
 import type { BreadcrumbGraphOptions, BreadcrumbItem } from '@getvitops/utils/schema';
 
@@ -8,5 +9,5 @@ export type Props = BreadcrumbGraphOptions;
 const jsonLd = breadcrumbGraph(Astro.props);
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/Carousel.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 import { itemListGraph } from '@getvitops/utils/schema';
 import type { ItemListEntry, ItemListGraphOptions } from '@getvitops/utils/schema';
 
@@ -9,5 +10,5 @@ export type Props = ItemListGraphOptions;
 const jsonLd = itemListGraph(Astro.props);
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/CourseList.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface CourseInstance {
   courseMode: 'online' | 'onsite' | 'blended';
   startDate?: string;
@@ -118,5 +119,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/Dataset.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Props {
   name: string;
   description: string;
@@ -123,5 +124,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/DiscussionForum.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface ForumPost {
   headline: string;
   text: string;
@@ -78,5 +79,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/EducationQA.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Props {
   mainEntity: {
     question: string;
@@ -59,5 +60,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/EmployerAggregateRating.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Props {
   name: string;
   url?: string;
@@ -50,5 +51,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/Event.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Props {
   name: string;
   description?: string;
@@ -111,5 +112,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/FAQ.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 /**
  * FAQ Schema Component
  *
@@ -14,5 +15,5 @@ export type Props = FAQGraphOptions;
 const jsonLd = faqGraph(Astro.props);
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/FactCheck.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Props {
   claimReviewed: string;
   url: string;
@@ -80,5 +81,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/ImageMetadata.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Props {
   contentUrl: string;
   creditText?: string;
@@ -52,5 +53,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/JobPosting.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Props {
   title: string;
   description: string;
@@ -134,5 +135,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/LocalBusiness.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 import { localBusinessGraph } from '@getvitops/utils/schema';
 import type { LocalBusinessGraphOptions } from '@getvitops/utils/schema';
 
@@ -7,5 +8,5 @@ export type Props = LocalBusinessGraphOptions;
 const jsonLd = localBusinessGraph(Astro.props);
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/MathSolver.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Props {
   name: string;
   url: string;
@@ -50,5 +51,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/MovieCarousel.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Movie {
   name: string;
   url: string;
@@ -88,5 +89,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/Organization.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 import { organizationGraph } from '@getvitops/utils/schema';
 import type { OrganizationGraphOptions } from '@getvitops/utils/schema';
 
@@ -7,5 +8,5 @@ export type Props = OrganizationGraphOptions;
 const jsonLd = organizationGraph(Astro.props);
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/Product.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Props {
   name: string;
   description?: string;
@@ -246,5 +247,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/ProfilePage.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Props {
   name: string;
   alternateName?: string;
@@ -143,5 +144,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/QAPage.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Answer {
   text: string;
   dateCreated: string;
@@ -67,5 +68,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/Recipe.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Props {
   name: string;
   description?: string;
@@ -174,5 +175,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/Review.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Props {
   itemReviewed: {
     type: 'Product' | 'LocalBusiness' | 'Organization' | 'Book' | 'Movie' | 'Restaurant' | 'Event' | 'CreativeWork' | 'SoftwareApplication' | 'MusicRecording' | 'Recipe';
@@ -134,5 +135,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/schemas/SoftwareApp.astro

@@ -1,4 +1,5 @@
 ---
+import { jsonLdScript } from '../json-ld.ts';
 export interface Props {
   name: string;
   description?: string;
@@ -168,5 +169,5 @@ const jsonLd = {
 };
 ---
 
-<script is:inline type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+<script is:inline type="application/ld+json" set:html={jsonLdScript(jsonLd)} />
 <slot />

package/src/scripts/tracking.ts

@@ -1,8 +1,10 @@
 // Ad conversion tracking: capture click IDs from the landing URL, track tel:
-// clicks. Form submission itself goes through `createConversionRoute()`
-// (`@getvitops/astro/routes`), which handles both the no-JS `<form
-// method="post">` path and a fetch-based one — there is no separate
-// form-enhancement script here.
+// and mailto: clicks. Form submission itself goes through
+// `createConversionRoute()` (`@getvitops/astro/routes`), which handles both
+// the no-JS `<form method="post">` path and a fetch-based one — there is no
+// form-enhancement script here, only `window.vitopsFormConversion()` (below),
+// which a consumer's own fetch-based submit handler may call once that POST
+// succeeds, to report the `form` Google Ads conversion action client-side.
 //
 // Runs early and ungated on purpose. Reading the query string is not storage and
 // needs nobody's permission; *keeping* it does. So the capture is synchronous —
@@ -27,9 +29,12 @@
 
 const COOKIE_NAME = '_ac';
 const COOKIE_DAYS = 90;
-const AB_COOKIE = '_ab';
+// Default when no experiment is configured, or the marker (below) carries no
+// `data-ab-cookie` override — kept as a literal fallback so a site with no
+// `site.experiments` behaves exactly as before.
+const DEFAULT_AB_COOKIE = '_ab';
 
-// Where the `tel:` conversion beacon goes. Mirrors TRACKING_ENDPOINT in
+// Where the `tel:`/`mailto:` conversion beacons go. Mirrors TRACKING_ENDPOINT in
 // ../tracking.ts (pinned by `tracking.test.ts`), copied for the same reason as
 // the parameter lists below — this file is inlined into the document.
 //
@@ -70,17 +75,35 @@ for (const key of [...CLICK_ID_PARAMS, ...UTM_PARAMS]) {
   if (value) trackingData[key] = value;
 }
 
-// Include A/B variant if assigned by the router Worker. A cookie present but
-// valueless yields undefined, which must not be written into the record.
-const abMatch = document.cookie.split(';').find((c) => c.trim().startsWith(`${AB_COOKIE}=`));
-const abVariant = abMatch?.split('=')[1]?.trim();
+/**
+ * Reads a raw cookie value by name. Splits on the *first* `=` only (a prior
+ * version split on every `=`, silently truncating any value containing one)
+ * and URL-decodes the result — a prior version didn't, so a variant name or
+ * attribution value containing a reserved character came back mangled.
+ */
+function rawCookie(name: string): string | undefined {
+  const match = document.cookie.split(';').find((c) => c.trim().startsWith(`${name}=`));
+  if (!match) return undefined;
+  const eq = match.indexOf('=');
+  const value = match.slice(eq + 1).trim();
+  return value ? decodeURIComponent(value) : undefined;
+}
+
+// <Tracking /> writes the experiment cookie name onto this marker (the first
+// *enabled* `site.experiments` entry — see `readSiteExperiments`'s own
+// docblock for why only one reaches the lead-attribution pipeline), so a
+// site with no experiments configured falls back to the same default this
+// always used.
+const trackingMarker = document.querySelector('[data-vitops-tracking]');
+const abCookieName = trackingMarker?.getAttribute('data-ab-cookie') || DEFAULT_AB_COOKIE;
+const abVariant = rawCookie(abCookieName);
 if (abVariant) trackingData['ab_variant'] = abVariant;
 
 function readCookie(): Record<string, unknown> | null {
-  const match = document.cookie.split(';').find((c) => c.trim().startsWith(`${COOKIE_NAME}=`));
-  if (!match) return null;
+  const raw = rawCookie(COOKIE_NAME);
+  if (!raw) return null;
   try {
-    const data: unknown = JSON.parse(decodeURIComponent(match.split('=').slice(1).join('=')));
+    const data: unknown = JSON.parse(raw);
     return typeof data === 'object' && data !== null && !Array.isArray(data)
       ? (data as Record<string, unknown>)
       : null;
@@ -121,10 +144,9 @@ const gate = (): ConsentLike | undefined =>
   (window as unknown as { vitopsConsent?: ConsentLike }).vitopsConsent;
 
 if (Object.keys(trackingData).length > 0) {
-  // <Tracking /> writes the category onto this marker, which also carries
-  // `data-consent-cookies` so revoking clears `_ac`.
-  const marker = document.querySelector('[data-vitops-tracking]');
-  const category = marker?.getAttribute('data-consent') ?? 'marketing';
+  // <Tracking /> writes the category onto this marker (looked up once,
+  // above), which also carries `data-consent-cookies` so revoking clears `_ac`.
+  const category = trackingMarker?.getAttribute('data-consent') ?? 'marketing';
 
   if (!gate()) {
     // No gate on this site: behave as it always has.
@@ -147,15 +169,86 @@ if (Object.keys(trackingData).length > 0) {
 }
 
 // ---------------------------------------------------------------------------
-// 2. Tel: click tracking via sendBeacon
+// 2. Tel:/mailto: click tracking via sendBeacon, plus a Google Ads conversion
 // ---------------------------------------------------------------------------
 
+/**
+ * Typed locally, matching `ConsentLike` above: a global augmentation here
+ * would widen `Window` package-wide for a shape only this file uses.
+ *
+ * `gtag` is a plain function global — it's declared inside the classic
+ * (non-module) inline `<script>` `gtagBootstrap` emits (`@getvitops/utils/ads`),
+ * which attaches it to `window`. This file runs as a module (`<Tracking />`
+ * imports it), so it must go through `window.gtag`, not a bare `gtag(...)` call.
+ * `vitopsAdsConversions.google` is the same bootstrap's per-action `send_to`
+ * map (`{call?, email?, form?}`) — each action carries its own target, so a
+ * call, an email click and a form submission report as distinct Google Ads
+ * conversion actions instead of all three sharing one.
+ */
+interface AdsGlobal {
+  gtag?: (...args: unknown[]) => void;
+  vitopsAdsConversions?: Record<string, Partial<Record<'call' | 'email' | 'form', string>>>;
+}
+const adsGlobal = (): AdsGlobal => window as unknown as AdsGlobal;
+
 document.addEventListener('click', (e) => {
-  const link = (e.target as Element).closest?.('a[href^="tel:"]') as HTMLAnchorElement | null;
+  const link = (e.target as Element).closest?.(
+    'a[href^="tel:"], a[href^="mailto:"]',
+  ) as HTMLAnchorElement | null;
   if (!link) return;
 
-  // Fire-and-forget beacon; don't block the tel: navigation
+  const isEmail = link.href.startsWith('mailto:');
+
+  // Fire-and-forget beacon; don't block the tel:/mailto: navigation.
   if (navigator.sendBeacon) {
-    navigator.sendBeacon(TRACK_ENDPOINT, JSON.stringify({ event: 'call', phone: link.href }));
+    const body = isEmail
+      ? { event: 'email', email: link.href }
+      : { event: 'call', phone: link.href };
+    navigator.sendBeacon(TRACK_ENDPOINT, JSON.stringify(body));
+  }
+
+  // Report the same click as a Google Ads conversion, when that action's
+  // `conversionLabel` is configured. `sendTo` is absent whenever the tag never
+  // loaded (gated and undecided, or `site.ads.google` unset) or that specific
+  // action has no label — silently skipped, same as every other
+  // optional-runtime check in this file.
+  const sendTo = adsGlobal().vitopsAdsConversions?.['google']?.[isEmail ? 'email' : 'call'];
+  if (sendTo && typeof adsGlobal().gtag === 'function') {
+    adsGlobal().gtag!('event', 'conversion', { send_to: sendTo });
   }
 });
+
+// ---------------------------------------------------------------------------
+// 3. Form-submission conversion, for a consumer's own fetch-based submit handler
+// ---------------------------------------------------------------------------
+
+const CONVERTED_ATTR = 'data-vitops-converted';
+
+/**
+ * Fires the Google Ads `form` conversion action (see `AdsGlobal` above) for a
+ * consumer's own fetch-based submit handler to call once its own POST to
+ * `createConversionRoute()` has succeeded — mirroring the tel:/mailto: click
+ * handler above, but for a form, which has no click to hook.
+ *
+ * Idempotent per element (`data-vitops-converted`): a handler that fires this
+ * more than once for the same submission (a retried network call, a
+ * double-invoked effect) reports the conversion once, not twice.
+ *
+ * There is deliberately no server-side equivalent for a no-JS
+ * `<form method="post">` submission — that path is a full-page redirect with no
+ * script execution to fire from, and reporting a Google-Ads-labelled
+ * conversion from the server needs the Google Ads API's click-conversion
+ * upload (developer token + MCC access), not a client-side pixel call. See the
+ * vNext backlog's §16 for that follow-up.
+ */
+function vitopsFormConversion(formEl: HTMLFormElement): void {
+  if (formEl.hasAttribute(CONVERTED_ATTR)) return;
+  formEl.setAttribute(CONVERTED_ATTR, '');
+  const sendTo = adsGlobal().vitopsAdsConversions?.['google']?.['form'];
+  if (sendTo && typeof adsGlobal().gtag === 'function') {
+    adsGlobal().gtag!('event', 'conversion', { send_to: sendTo });
+  }
+}
+
+(window as unknown as { vitopsFormConversion?: typeof vitopsFormConversion }).vitopsFormConversion =
+  vitopsFormConversion;

package/src/seo.ts

@@ -20,11 +20,12 @@ export 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).
  */
 export interface GetvitopsSeoOptions {
   /** `og:site_name`, and the `<title>` when a page passes none. */

package/src/tracking.ts

@@ -12,23 +12,19 @@
  * under `analytics`, and that is the consumer's call to make, not ours to guess.
  */
 
+import type { TrackingConfig } from '@getvitops/config';
+
 /** Which consent category the attribution cookie waits on. */
-export type TrackingCategory = 'marketing' | 'analytics';
+export type TrackingCategory = NonNullable<TrackingConfig['category']>;
 
-export interface GetvitopsTrackingOptions {
-  /** Capture ad click IDs and UTMs into `_ac`. */
-  enabled?: boolean;
-  /** Default `marketing`. */
-  category?: TrackingCategory;
-  /** Informational; capture recognises every known click-ID parameter regardless. */
-  platforms?: string[];
-}
+/** The `site.tracking` block — the schema's own type from `@getvitops/config`, not a copy. */
+export type GetvitopsTrackingOptions = TrackingConfig;
 
 /** The cookie the capture script writes. Mirrors `TRACKING_COOKIE` in utils. */
 export const TRACKING_COOKIE = '_ac';
 
 /**
- * Where the capture script sends its `tel:` conversion beacon.
+ * Where the capture script sends its `tel:`/`mailto:` conversion beacons.
  *
  * The route itself is the consumer's to write (`createConversionRoute()` in
  * `@getvitops/astro/routes`), so this is the one place the two halves agree on

package/virtual.d.ts

@@ -11,6 +11,17 @@ declare module 'virtual:getvitops/head' {
     cssVariable: string;
     preload: boolean | { weight?: string | number; style?: string }[];
   }
+  /**
+   * Mirrors `HeadTrackingData` in src/integration.ts. Its own named interface
+   * (not inlined into `HeadData` below) so the drift guard's line-by-line key
+   * regex doesn't pick up its fields as false top-level `HeadData` matches.
+   */
+  interface HeadTrackingData {
+    enabled: boolean;
+    category: string;
+    cookies: string[];
+    abVariantCookie: string | null;
+  }
   // 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.
@@ -40,7 +51,12 @@ declare module 'virtual:getvitops/head' {
     // integration rather than the component because its warnings belong beside
     // the others, and the offered consent categories it checks against are known
     // only there.
-    tracking: { enabled: boolean; category: string; cookies: string[] } | null;
+    tracking: HeadTrackingData | null;
+    // Enabled `site.experiments`, keyed the same way, resolved to their cookie
+    // names — re-typed by <Analytics /> on the way into `resolveAnalytics`.
+    experiments: Record<string, { cookieName: string }>;
+    // `site.analytics.matomo.abVariantDimensions`, passed through unchanged.
+    matomoAbVariantDimensions: Record<string, number>;
     // The site config's `site.ads` block plus this environment's switch —
     // structurally `{ enabled, properties }` (src/ads.ts), re-typed by <Ads /> on
     // the way into `resolveAds`. Read in the integration because that is where the

package/dist/tracking-CmSfxWC3.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracking-CmSfxWC3.mjs","names":[],"sources":["../src/tracking.ts"],"sourcesContent":["/**\n * The `<Tracking />` resolution layer — tracking config in, what to emit out.\n *\n * Separate from `Tracking.astro` for the same reason `analytics.ts` is separate\n * from `Analytics.astro`: everything decidable is a pure function asserted in\n * `tracking.test.ts`, and the component only renders what this returns.\n *\n * The one decision here is **which consent category the `_ac` cookie waits on**,\n * and it is stated rather than inferred. `_ac` is a 90-day identifier tying a\n * visitor to the ad that brought them, so `marketing` is the default — but a site\n * using click IDs purely for its own campaign reporting may reasonably file it\n * under `analytics`, and that is the consumer's call to make, not ours to guess.\n */\n\n/** Which consent category the attribution cookie waits on. */\nexport type TrackingCategory = 'marketing' | 'analytics';\n\nexport interface GetvitopsTrackingOptions {\n  /** Capture ad click IDs and UTMs into `_ac`. */\n  enabled?: boolean;\n  /** Default `marketing`. */\n  category?: TrackingCategory;\n  /** Informational; capture recognises every known click-ID parameter regardless. */\n  platforms?: string[];\n}\n\n/** The cookie the capture script writes. Mirrors `TRACKING_COOKIE` in utils. */\nexport const TRACKING_COOKIE = '_ac';\n\n/**\n * Where the capture script sends its `tel:` conversion beacon.\n *\n * The route itself is the consumer's to write (`createConversionRoute()` in\n * `@getvitops/astro/routes`), so this is the one place the two halves agree on\n * a path. It was a bare literal inside the inlined script: a consumer who named\n * the file anything else got a silent 404 on every beacon and lost conversions\n * with no error anywhere to explain it. Exported so a consumer can assert\n * against it, mirrored in `scripts/tracking.ts` because that file is inlined\n * into the document and cannot import, and pinned by `tracking.test.ts`.\n */\nexport const TRACKING_ENDPOINT = '/api/track';\n\nexport interface ResolvedTracking {\n  enabled: boolean;\n  category: TrackingCategory;\n  /** Cookie names to clear on revoke — rides on `data-consent-cookies`. */\n  cookies: string[];\n  /** Configuration problems, as prose. The integration logs these. */\n  warnings: string[];\n}\n\nexport interface ResolveTrackingContext {\n  /** Is the consent gate enabled on this site (`vitops({ consent })`)? */\n  consent?: boolean;\n  /** Categories the banner offers, so we can catch a demand with no row. */\n  consentCategories?: readonly string[];\n}\n\n/**\n * Resolve the tracking config into what the component emits.\n *\n * Two warnings, both about the same failure — a persistent identifier written\n * with no way for the visitor to decline, or a permission asked for with no way\n * to answer. Returned as data rather than logged here so the check is a test\n * rather than a line someone might scroll past, exactly as `resolveAnalytics`\n * does.\n */\nexport function resolveTracking(\n  opts: GetvitopsTrackingOptions | undefined,\n  ctx: ResolveTrackingContext = {},\n): ResolvedTracking {\n  const warnings: string[] = [];\n  const category: TrackingCategory = opts?.category ?? 'marketing';\n  const enabled = opts?.enabled === true;\n\n  if (!enabled) return { enabled: false, category, cookies: [], warnings };\n\n  if (!ctx.consent) {\n    warnings.push(\n      `tracking is on, so this site writes the \\`${TRACKING_COOKIE}\\` cookie — a 90-day ` +\n        'identifier tying a visitor to the ad that brought them — and `consent` is off, so it ' +\n        'is written for every visitor with no way to decline. Set `consent: true`.',\n    );\n  } else if (ctx.consentCategories && !ctx.consentCategories.includes(category)) {\n    // The banner would be raised for a category it renders no row for: the\n    // visitor is asked a question the form does not show them.\n    warnings.push(\n      `tracking demands the \\`${category}\\` consent category, but the banner offers ` +\n        `${ctx.consentCategories.join(', ') || 'nothing'}. Add \\`${category}\\` to ` +\n        '`consent.categories`, or the visitor is asked about something the banner never names.',\n    );\n  }\n\n  return { enabled, category, cookies: [TRACKING_COOKIE], warnings };\n}\n"],"mappings":";;AA2BA,MAAa,kBAAkB;;;;;;;;;;;;AAa/B,MAAa,oBAAoB;;;;;;;;;;AA2BjC,SAAgB,gBACd,MACA,MAA8B,CAAC,GACb;CAClB,MAAM,WAAqB,CAAC;CAC5B,MAAM,WAA6B,MAAM,YAAY;CACrD,MAAM,UAAU,MAAM,YAAY;CAElC,IAAI,CAAC,SAAS,OAAO;EAAE,SAAS;EAAO;EAAU,SAAS,CAAC;EAAG;CAAS;CAEvE,IAAI,CAAC,IAAI,SACP,SAAS,KACP,mDAA6D,wLAG/D;MACK,IAAI,IAAI,qBAAqB,CAAC,IAAI,kBAAkB,SAAS,QAAQ,GAG1E,SAAS,KACP,0BAA0B,SAAS,6CAC9B,IAAI,kBAAkB,KAAK,IAAI,KAAK,UAAU,UAAU,SAAS,8FAExE;CAGF,OAAO;EAAE;EAAS;EAAU,SAAS,MAAgB;EAAG;CAAS;AACnE"}

package/dist/tracking-DdEKExlE.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracking-DdEKExlE.d.mts","names":[],"sources":["../src/tracking.ts"],"mappings":";;AAeA;;;;AAA4B;AAE5B;;;;;;;;KAFY,gBAAA;AAAA,UAEK,wBAAA;EAUJ;EARX,OAAA;;EAEA,QAAA,GAAW,gBAAgB;EAMD;EAJ1B,SAAA;AAAA;;cAIW,eAAA;AAaiB;AAE9B;;;;;;;;;;AAF8B,cAAjB,iBAAA;AAAA,UAEI,gBAAA;EACf,OAAA;EACA,QAAA,EAAU,gBAAgB;EAS1B;EAPA,OAAA;EAqBc;EAnBd,QAAA;AAAA;AAAA,UAGe,sBAAA;EAkBV;EAhBL,OAAA;EAiBiB;EAfjB,iBAAiB;AAAA;;;;;;AAeA;;;;iBAHH,eAAA,CACd,IAAA,EAAM,wBAAA,cACN,GAAA,GAAK,sBAAA,GACJ,gBAAA"}