@getvitops/astro 8.0.1 → 8.2.0-alpha.0

package/dist/index.d.mts

@@ -1,11 +1,10 @@
-import { i as TRACKING_COOKIE, n as ResolveTrackingContext, o as TrackingCategory, r as ResolvedTracking, s as resolveTracking, t as GetvitopsTrackingOptions } from "./tracking-DdEKExlE.mjs";
+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 { generateIconInclude } from "@getvitops/utils";
-import { AdProvider } from "@getvitops/utils/ads";
+import { AdProvider, ConversionLabelMap } from "@getvitops/utils/ads";
 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
@@ -152,6 +151,19 @@ interface ResolvedAnalytics {
 interface ResolveAnalyticsContext {
   /** Is the consent gate enabled on this site (`vitops({ consent })`)? */
   consent?: boolean;
+  /**
+   * Enabled `site.experiments` entries, keyed the same way, each carrying the
+   * resolved cookie name `vitopsAbTesting()`'s middleware assigns
+   * (`_ab_<key>` unless overridden). When set, each provider's bootstrap
+   * reads these cookies client-side and reports the assignment via that
+   * provider's own custom-dimension/property mechanism — a no-op when this
+   * is empty, so a site not using experiments sees no behavior change.
+   */
+  experiments?: Record<string, {
+    cookieName: string;
+  }>;
+  /** `site.analytics.matomo.abVariantDimensions` — Matomo's pre-created custom-dimension index per experiment key. */
+  matomoAbVariantDimensions?: Record<string, number>;
 }
 /**
  * Resolve the configured providers into the tags to emit.
@@ -160,9 +172,9 @@ interface ResolveAnalyticsContext {
  * malformed ID should not take down a build, and a missing tag is visible in the
  * output while a failed build is just a red wall.
  */
-declare function resolveAnalytics(opts: GetvitopsAnalyticsOptions | undefined, ctx?: ResolveAnalyticsContext): ResolvedAnalytics;
+export declare function resolveAnalytics(opts: GetvitopsAnalyticsOptions | undefined, ctx?: ResolveAnalyticsContext): ResolvedAnalytics;
 /** Which optional categories a set of tags actually needs a visitor to decide. */
-declare function consentCategories(tags: GatedTag[]): OptionalConsentCategory[];
+export declare function consentCategories(tags: GatedTag[]): OptionalConsentCategory[];
 //#endregion
 //#region src/seo.d.ts
 /**
@@ -216,9 +228,13 @@ interface GetvitopsSeoOptions {
   /** 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`. */
+    /** 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;
@@ -228,8 +244,11 @@ interface GetvitopsSeoOptions {
     };
   };
   twitter?: {
-    /** Card type when no image resolves (default `'summary'`). */card?: SeoTwitterCard; /** The site's own handle, `@acme`. */
-    site?: string; /** Default author handle, `@ada`. */
+    /** Card type when no image resolves (default `'summary'`). */
+    card?: SeoTwitterCard;
+    /** The site's own handle, `@acme`. */
+    site?: string;
+    /** Default author handle, `@ada`. */
     creator?: string;
   };
 }
@@ -341,7 +360,7 @@ interface SeoContext {
  * 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.
  */
-declare function resolveSeo(defaults: GetvitopsSeoOptions, props: SeoProps, ctx: SeoContext): ResolvedSeo;
+export declare function resolveSeo(defaults: GetvitopsSeoOptions, props: SeoProps, ctx: SeoContext): ResolvedSeo;
 //#endregion
 //#region src/integration.d.ts
 interface GetvitopsFaviconOptions {
@@ -750,7 +769,7 @@ interface GetvitopsIconsOptions {
   /** Aliases applied before the semantic map — legacy names, or values stored in CMS content. */
   overrides?: Record<string, string>;
 }
-declare function vitops(opts?: GetvitopsOptions): AstroIntegration;
+export default function vitops(opts?: GetvitopsOptions): AstroIntegration;
 //#endregion
 //#region src/ads.d.ts
 /**
@@ -763,7 +782,15 @@ declare function vitops(opts?: GetvitopsOptions): AstroIntegration;
 interface GetvitopsAdProperty {
   accountId?: string;
   pixelId?: string;
-  conversionLabel?: 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. */
@@ -792,7 +819,7 @@ interface ResolveAdsContext {
   strategy?: AnalyticsStrategy;
 }
 /** Resolve the configured ad properties into the tags `<Ads />` emits. */
-declare function resolveAds(ads: GetvitopsAdsOptions | undefined, ctx?: ResolveAdsContext): ResolvedAds;
+export declare function resolveAds(ads: GetvitopsAdsOptions | undefined, ctx?: ResolveAdsContext): ResolvedAds;
 //#endregion
 //#region src/lastmod.d.ts
 interface GitLastmodOptions {
@@ -810,9 +837,9 @@ interface GitLastmodOptions {
  * commit date describes the template rather than any of them. Stamping every
  * generated page with the template's date is exactly the "wrong date" case above.
  */
-declare function routeFromPage(file: string): string | undefined;
+export declare function routeFromPage(file: string): string | undefined;
 /** The slug a content entry is most likely published under. */
-declare function slugFromContent(file: string): string | undefined;
+export declare function slugFromContent(file: string): string | undefined;
 /**
  * Build a `serialize` function that stamps `lastmod` from git history.
  *
@@ -821,7 +848,7 @@ declare function slugFromContent(file: string): string | undefined;
  * is dropped rather than guessed at, since picking either one would be a coin
  * flip presented as a fact.
  */
-declare function gitLastmod(options?: GitLastmodOptions): Promise<(item: GetvitopsSitemapEntry) => GetvitopsSitemapEntry>;
+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, consentCategories, vitops as default, gitLastmod, resolveAds, resolveAnalytics, resolveSeo, resolveTracking, routeFromPage, slugFromContent };
+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 };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/analytics.ts","../src/seo.ts","../src/integration.ts","../src/ads.ts","../src/lastmod.ts"],"mappings":";;;;;;;;;;;;;;;;;;;AA2BA;;;;AAA6B;AAQ7B;;;;AAA2B;AAE3B;;;;AAA6D;AAE7D;KAZY,iBAAA;;;;;;;KAQA,eAAA;AAAA,KAEA,uBAAA,GAA0B,OAAO,CAAC,eAAA;AAAA,UAE7B,sBAAA;EAYA;EAVf,EAAA;;;;;EAKA,QAAA,GAAW,uBAAA;EAQuB;EANlC,MAAA,GAAS,MAAM;AAAA;AAAA,UAGA,cAAA;;EAEf,EAAA;EACA,QAAA,GAAW,uBAAuB;AAAA;AAAA,UAGnB,aAAA;EAaR;EAXP,GAAA;EAce;EAZf,MAAA;;;AAgBG;AAGL;;;;;EAVE,OAAA;AAAA;AAAA,UAGe,gBAAA;EAaa;EAX5B,MAAA;EAMA;EAJA,GAAG;AAAA;AAAA,UAGY,yBAAA;EACf,eAAA,YAA2B,sBAAA;EAC3B,OAAA,YAAmB,cAAA;EACnB,MAAA,GAAS,aAAA;EACT,SAAA,YAAqB,gBAAA;EAErB;EAAA,QAAA,GAAW,iBAAA;AAAA;AAAiB;AAW9B;;;;;;;AAX8B,UAWb,uBAAA;EAON;AAkBX;;;EApBE,UAAA,GAAa,uBAAuB;EA2B1B;EAzBV,SAAA;AAAA;;;;;;;;;;;;;;;AAmCa;UAjBE,QAAA;EAqBY;EAnB3B,QAAA;EACA,QAAA,EAAU,eAAA;EACV,WAAA;EAqBe;EAnBf,OAAA;EACA,QAAA,EAAU,iBAAA;EAmBO;;;;;EAbjB,KAAA;EAiBQ;EAfR,MAAA;EACA,GAAA;EACA,KAAA,EAAO,MAAA;AAAA;AAkBA;AAAA,UAdQ,WAAA,SAAoB,QAAQ;EAC3C,GAAG;AAAA;AAAA,UAGY,iBAAA;EACf,IAAA,EAAM,WAAW;EAoJhB;EAlJD,YAAA;EAkJkB;EAhJlB,QAAA;AAAA;AAAA,UAGe,uBAAA;EA4If;EA1IA,OAAO;AAAA;AA2IW;AAwCpB;;;;;;AAxCoB,iBAHJ,gBAAA,CACd,IAAA,EAAM,yBAAA,cACN,GAAA,GAAK,uBAAA,GACJ,iBAAA;;iBAwCa,iBAAA,CAAkB,IAAA,EAAM,QAAA,KAAa,uBAAuB;;;;;;;;;;;;;AArT5E;;KCdY,cAAA;;KAGA,SAAA;ADmBZ;;;;AAA2B;AAE3B;;;;AAA6D;AAF7D,UCPiB,mBAAA;EDWsB;ECTrC,QAAA;EDkBe;;;;;;;AAAA;AAGjB;;;ECTE,aAAA;EDWA;ECTA,YAAA;EDUW;ECRX,kBAAA;EDQkC;ECNlC,MAAA;EDS4B;ECP5B,sBAAA;EDO4B;ECL5B,oBAAA;EACA,SAAA;IDiBA,+CCfE,IAAA,GAAO,SAAA,EDeF;ICbL,MAAA,WDgB6B;ICd7B,gBAAA,aDkBC;IChBD,KAAA;MAAU,GAAA;MAAa,GAAA;MAAc,KAAA;MAAgB,MAAA;MAAiB,IAAA;IAAA;EAAA;EAExE,OAAA;IDuB4B,8DCrB1B,IAAA,GAAO,cAAc,EDgBvB;ICdE,IAAA,WDeF;ICbE,OAAA;EAAA;AAAA;;UAKa,QAAA;EDYf;ECVA,KAAA;EDU4B;AAAA;AAW9B;;;ECfE,OAAA;EACA,WAAA;EDmBa;ECjBb,SAAA;EDmBS;ECjBT,QAAA;EDmCe;ECjCf,KAAA;EACA,QAAA;EACA,UAAA;EACA,WAAA;ED+CO;EC7CP,SAAA;EACA,OAAA;EACA,QAAA;EACA,SAAA;EACA,OAAA;ED4BA;EC1BA,YAAA;ED6BA;EC3BA,MAAA;EDiCA;EC/BA,IAAA,GAAO,SAAS;EDkChB;EChCA,OAAA;IACE,aAAA;IACA,YAAA;IACA,cAAA;IACA,OAAA;IACA,OAAA;IACA,IAAA;EAAA;EDgCC;EC7BH,MAAA;EDgCgC;EC9BhC,cAAA;ED+BiB;;;;;;AAIT;AAGV;;EC5BE,UAAA;IAAe,QAAA;IAAkB,IAAA;EAAA;AAAA;;UAIlB,cAAA;EACf,QAAA;EACA,OAAO;AAAA;;UAIQ,UAAA;EACf,IAAA;EACA,OAAO;AAAA;;UAIQ,WAAA;EACf,KAAA;EDgMc;EC9Ld,WAAA;EACA,WAAA;EACA,SAAA;EACA,MAAA;EACA,SAAA,EAAW,cAAA;EACX,OAAA,EAAS,UAAA;EACT,YAAA,EAAc,UAAA;EACd,UAAA;IAAc,QAAA;IAAkB,IAAA;EAAA;AAAA;;UAIjB,UAAA;EAhJS;AAAA;AAG1B;;;;AAAqB;AAYrB;EA0IE,IAAA,GAAO,GAAG;;EAEV,QAAA;EA1IA;EA4IA,MAAA;AAAA;;;;;;;;iBA8Cc,UAAA,CACd,QAAA,EAAU,mBAAA,EACV,KAAA,EAAO,QAAA,EACP,GAAA,EAAK,UAAA,GACJ,WAAA;;;UClLc,uBAAA;;EAEf,MAAA;EACA,YAAA;EFlB2B;EEoB3B,IAAA;EFpB2B;EEsB3B,UAAA;EACA,eAAA;AAAA;;;AFfyB;AAE3B;;;UEsBiB,qBAAA;EFtB4C;EEwB3D,GAAA;EFtBqC;EEwBrC,GAAA;EFfe;EEiBf,QAAA;EFnBA;EEqBA,GAAA;EFnBA;EEqBA,UAAA;EFrBe;EEuBf,KAAA;EFpBe;EEsBf,UAAA;;EAEA,OAAA,GAAU,UAAe;EFtBzB;EEwBA,QAAA;AAAA;AAAA,UAGe,mBAAA;EF1BmB;AAGpC;;;;;;;;EEiCE,KAAA;EFjBe;;;;EEsBf,KAAA;EFfe;;;;;;EEsBf,MAAA,GAAS,gBAAgB;EFhBd;EEkBX,GAAA;EFlB4B;;;;;;;EE0B5B,MAAA;EF5BqB;;;;AAEO;AAW9B;;;;;;;;AAOW;AAkBX;EEME,iBAAA;AAAA;AAAA,UAGe,oBAAA;EFFL;EEIV,KAAA;EFMa;EEJb,OAAO;AAAA;AAAA,UAGQ,qBAAA;EFbL;;;;;EEmBV,KAAA;EFPA;;;;;AAEa;EEYb,GAAA;EFR2B;EEU3B,MAAA,GAAS,WAAW;EFVe;EEYnC,OAAA;AAAA;;KAIU,0BAAA;;UAUK,qBAAA;EACf,GAAA;EACA,OAAA;EACA,UAAA,GAAa,0BAA0B;EACvC,QAAA;EFrBQ;EEuBR,KAAA;IAAU,IAAA;IAAc,QAAA;IAAmB,GAAA;EAAA;AAAA;;;;;;;;;;;;;UAe5B,uBAAA;EF0GG;EExGlB,MAAA,IAAU,IAAA;EFgJqB;EE9I/B,WAAA;EF8I0E;EE5I1E,cAAA;EF4IgC;EE1IhC,UAAA;EF0I0E;EExI1E,YAAA;EACA,UAAA,GAAa,0BAAA;EACb,OAAA,GAAU,IAAA;EACV,QAAA;ED9LU;ECgMV,SAAA,IACE,IAAA,EAAM,qBAAA,KACH,qBAAA,GAAwB,OAAA,CAAQ,qBAAA;;EAErC,IAAA;IAAS,aAAA;IAAuB,OAAA,EAAS,MAAA;EAAA;;EAEzC,MAAA;EDnMmB;ECqMnB,UAAA;IAAe,IAAA;IAAgB,KAAA;IAAiB,KAAA;IAAiB,KAAA;EAAA;AAAA;AAAA,UAGlD,gBAAA;EDxKf;;;;;;;;;;;;ECqLA,IAAA,GAAO,oBAAA;EACP,OAAA,GAAU,uBAAA;EDvKV;;;;;;AAMS;AAKX;;;;;;;;;;;;;;;;ECoLE,KAAA,GAAQ,qBAAA;ED5JR;EC8JA,aAAA;ED1JA;EC4JA,GAAA,GAAM,mBAAA;ED1JC;;;;;;;;;;;ECsKP,MAAA;ED/IiC;;AAAI;AAIvC;;;;AAES;AAIT;EC+IE,KAAA,GAAQ,qBAAA;;;AD7ID;AAIT;;;;;;;;;;;;;;;;;;;;;;;AAUsC;AAItC;;;EC0JE,KAAA,sBAA2B,QAAA,KAAa,qBAAA;EDjJxC;;;;;AAIM;AA8CR;;;;;;EC4GE,OAAA,aAAoB,uBAAA;EDxGR;;;;;;;;;;AAAA;;ECqHZ,GAAA,GAAM,mBAAA;;AAvSR;;;;;;;;;;AAQiB;AASjB;;;;;;;;;EA4SE,KAAA,aAAkB,qBAAA;EA9RlB;;;;;AAIQ;AAGV;;;;;EAmSE,SAAA,GAAY,yBAAA;EA7QZ;;;;;;AA0BiB;AAGnB;;;;AAIS;EAyPP,OAAA,aAAoB,uBAAA;EAtPgB;;;;;;;;;AAiB7B;AAIT;;;;EAgPE,QAAA,aAAqB,wBAAA;AAAA;AAAA,UAGN,qBAAA;;EAEf,KAAA;EA1OA;EA4OA,QAAA,GAAW,QAAQ;EA1OnB;EA4OA,OAAA;AAAA;AAAA,UAGe,qBAAA;EA5OL;EA8OV,EAAA;EA9O2C;EAgP3C,KAAA;EAhP8C;AAehD;;;EAsOE,MAAA;EA1NU;;;;;;;;EAmOV,OAAA,GAAU,UAAA,QAAkB,mBAAA;EA7OlB;;;;;;;;;;;EAyPV,MAAA;EA3OE;;;;;EAiPF,QAAA;EA9OgC;EAgPhC,IAAA;EA9OA;EAgPA,MAAA;EA9Oe;EAgPf,SAAA,GAAY,MAAA;AAAA;AAAA,iBAwUU,MAAA,CAAO,IAAA,GAAM,gBAAA,GAAwB,gBAAgB;;;;;;;;;AF7tB5D;UGXA,mBAAA;EACf,SAAA;EACA,OAAA;EACA,eAAA;EHaA;EGXA,QAAA;EHYW;EGVX,OAAA;AAAA;AAAA,KAGU,mBAAA,GAAsB,OAAA,CAAQ,MAAA,CAAO,UAAA,EAAY,mBAAA;;UAG5C,aAAA,SAAsB,QAAQ;EAC7C,GAAA,EAAK,UAAA;AAAA;AAAA,UAGU,WAAA;EACf,IAAA,EAAM,aAAa;EHeZ;EGbP,YAAA;EHgBe;EGdf,QAAA;AAAA;AAAA,UAGe,iBAAA;EHeZ;EGbH,OAAA;EHgBwC;EGdxC,iBAAA;EHe2B;EGb3B,OAAA;EHeS;EGbT,QAAA,GAAW,iBAAiB;AAAA;;iBAYd,UAAA,CACd,GAAA,EAAK,mBAAA,cACL,GAAA,GAAK,iBAAA,GACJ,WAAA;;;UC9Cc,iBAAA;;EAEf,IAAA;;EAEA,GAAA;;EAEA,MAAA,IAAU,OAAA;AAAA;;AJlBZ;;;;AAA6B;AAQ7B;iBIoBgB,aAAA,CAAc,IAAY;;iBAa1B,eAAA,CAAgB,IAAY;AJjCjB;AAE3B;;;;AAA6D;AAE7D;;AAJ2B,iBIqFL,UAAA,CACpB,OAAA,GAAS,iBAAA,GACR,OAAA,EAAS,IAAA,EAAM,qBAAA,KAA0B,qBAAA"}
+{"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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"}

package/dist/index.mjs

@@ -1,11 +1,11 @@
-import { n as TRACKING_ENDPOINT, r as resolveTracking, t as TRACKING_COOKIE } from "./tracking-CmSfxWC3.mjs";
+import { n as TRACKING_ENDPOINT, r as resolveTracking, t as TRACKING_COOKIE } from "./tracking-M2PqlMpw.mjs";
 import { cpSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { isConfig, renderRobotsTxt, resolveConfig } from "@getvitops/generator";
 import { collectIconRefs, faviconLinks, generateFavicons, generateIconInclude, resolveIcon, scanFiles, writeFaviconManifest } from "@getvitops/utils";
 import vitopsPlugin from "@getvitops/vite";
-import { AD_PLATFORMS, AD_PROVIDER_KEYS } from "@getvitops/utils/ads";
+import { AD_PLATFORMS, AD_PROVIDER_KEYS, normalizeConversionLabels } from "@getvitops/utils/ads";
 import { fontProviders } from "astro/config";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
@@ -14,6 +14,20 @@ export * from "@getvitops/utils"
 
 //#region 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
+* assigned, or the experiment disabled after this page was cached). Shared
+* across providers so the cookie-parsing logic — and its `SAFE_ID` guard on
+* both the experiment key and cookie name, the same discipline `bad()`
+* already applies to provider IDs landing in an inline `<script>` — exists
+* exactly once.
+*/
+function experimentCookieReads(experiments) {
+	const entries = Object.entries(experiments).filter(([key, e]) => !bad(key) && !bad(e.cookieName));
+	if (!entries.length) return "";
+	return "function _abrc(n){var m=document.cookie.match(new RegExp('(?:^|; )'+n+'=([^;]*)'));return m?decodeURIComponent(m[1]):null;}var _ab={};" + entries.map(([key, e]) => `_ab[${JSON.stringify(key)}]=_abrc(${JSON.stringify(e.cookieName)});`).join("") + `for(var _k in _ab){if(_ab[_k]==null)delete _ab[_k];}`;
+}
+/**
 * IDs land inside an inline `<script>`, so they are checked rather than trusted.
 * A `<\/script>` in a measurement ID is not a plausible accident, but the cost of
 * the guard is one regex and the cost of not having it is arbitrary script
@@ -27,10 +41,12 @@ function bad(value) {
 function literal(value) {
 	return JSON.stringify(value).replaceAll("<", "\\u003c");
 }
-function googleAnalytics(input) {
+function googleAnalytics(input, experiments = {}) {
 	const opts = typeof input === "string" ? { id: input } : input;
 	if (bad(opts.id)) return `googleAnalytics: "${opts.id}" is not a valid measurement ID. Skipped.`;
-	const config = opts.config ? `,${literal(opts.config)}` : "";
+	const staticConfig = opts.config ?? {};
+	const reads = experimentCookieReads(experiments);
+	const gtagConfig = reads ? `${reads}gtag('config','${opts.id}',Object.assign(${literal(staticConfig)},_ab));` : `gtag('config','${opts.id}'${opts.config ? `,${literal(staticConfig)}` : ""});`;
 	return {
 		key: "googleAnalytics",
 		provider: "Google Analytics",
@@ -45,7 +61,7 @@ function googleAnalytics(input) {
 		],
 		strategy: "idle",
 		gated: true,
-		inline: `window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments)}gtag('js',new Date());gtag('config','${opts.id}'${config});`,
+		inline: "window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments)}gtag('js',new Date());" + gtagConfig,
 		src: `https://www.googletagmanager.com/gtag/js?id=${encodeURIComponent(opts.id)}`,
 		attrs: {}
 	};
@@ -74,7 +90,7 @@ function clarity(input) {
 		attrs: {}
 	};
 }
-function matomo(opts) {
+function matomo(opts, experiments = {}, dimensions = {}) {
 	const siteId = String(opts.siteId);
 	if (bad(siteId)) return `matomo: "${siteId}" is not a valid site ID. Skipped.`;
 	let base;
@@ -85,6 +101,9 @@ function matomo(opts) {
 	}
 	const url = `${base.origin}${base.pathname.replace(/\/*$/, "")}/`;
 	const cookies = opts.cookies === true;
+	const dimensionEntries = Object.entries(experiments).filter(([key]) => dimensions[key] != null);
+	const reads = experimentCookieReads(Object.fromEntries(dimensionEntries));
+	const dimensionPushes = reads ? reads + dimensionEntries.map(([key]) => `if(_ab[${JSON.stringify(key)}]!=null)_paq.push(['setCustomDimension',${dimensions[key]},_ab[${JSON.stringify(key)}]]);`).join("") : "";
 	return {
 		key: "matomo",
 		provider: "Matomo",
@@ -99,14 +118,15 @@ function matomo(opts) {
 		] : [],
 		strategy: "idle",
 		gated: true,
-		inline: `var _paq=window._paq=window._paq||[];` + (cookies ? "" : `_paq.push(['disableCookies']);`) + `_paq.push(['trackPageView']);_paq.push(['enableLinkTracking']);(function(){var u="${url}";_paq.push(['setTrackerUrl',u+'matomo.php']);_paq.push(['setSiteId','${siteId}']);var d=document,g=d.createElement('script'),s=d.getElementsByTagName('script')[0];g.async=true;g.src=u+'matomo.js';s.parentNode.insertBefore(g,s)})();`,
+		inline: `var _paq=window._paq=window._paq||[];` + (cookies ? "" : `_paq.push(['disableCookies']);`) + dimensionPushes + `_paq.push(['trackPageView']);_paq.push(['enableLinkTracking']);(function(){var u="${url}";_paq.push(['setTrackerUrl',u+'matomo.php']);_paq.push(['setSiteId','${siteId}']);var d=document,g=d.createElement('script'),s=d.getElementsByTagName('script')[0];g.async=true;g.src=u+'matomo.js';s.parentNode.insertBefore(g,s)})();`,
 		src: null,
 		attrs: {}
 	};
 }
-function plausible(input) {
+function plausible(input, experiments = {}) {
 	const opts = typeof input === "string" ? { domain: input } : input;
 	if (bad(opts.domain)) return `plausible: "${opts.domain}" is not a valid domain. Skipped.`;
+	const reads = experimentCookieReads(experiments);
 	return {
 		key: "plausible",
 		provider: "Plausible Analytics",
@@ -115,7 +135,7 @@ function plausible(input) {
 		cookies: [],
 		strategy: "idle",
 		gated: true,
-		inline: "",
+		inline: reads ? `window.plausible=window.plausible||function(){(window.plausible.q=window.plausible.q||[]).push(arguments)};plausible.init({customProperties:function(){${reads}return _ab;}});` : "",
 		src: opts.src ?? "https://plausible.io/js/script.js",
 		attrs: { "data-domain": opts.domain }
 	};
@@ -136,11 +156,12 @@ function resolveAnalytics(opts, ctx = {}) {
 		warnings
 	};
 	const strategy = opts.strategy ?? "idle";
+	const experiments = ctx.experiments ?? {};
 	const results = [
-		opts.googleAnalytics === void 0 ? null : googleAnalytics(opts.googleAnalytics),
+		opts.googleAnalytics === void 0 ? null : googleAnalytics(opts.googleAnalytics, experiments),
 		opts.clarity === void 0 ? null : clarity(opts.clarity),
-		opts.matomo === void 0 ? null : matomo(opts.matomo),
-		opts.plausible === void 0 ? null : plausible(opts.plausible)
+		opts.matomo === void 0 ? null : matomo(opts.matomo, experiments, ctx.matomoAbVariantDimensions ?? {}),
+		opts.plausible === void 0 ? null : plausible(opts.plausible, experiments)
 	];
 	for (const result of results) {
 		if (result === null) continue;
@@ -239,6 +260,18 @@ function resolveAds(ads, ctx = {}) {
 			warnings.push(`ads: ${provider} ${platform.tag.needs} "${id}" is not a valid ID. Skipped.`);
 			continue;
 		}
+		let safeEntry = entry;
+		const labels = normalizeConversionLabels(entry.conversionLabel);
+		const invalidActions = Object.entries(labels).filter(([, label]) => label && !SAFE_ID.test(label)).map(([action]) => action);
+		if (invalidActions.length) {
+			for (const action of invalidActions) warnings.push(`ads: ${provider} conversionLabel.${action} "${labels[action]}" is not a valid label. Conversion firing skipped for that action.`);
+			const cleanLabels = Object.fromEntries(Object.entries(labels).filter(([action]) => !invalidActions.includes(action)));
+			const { conversionLabel: _drop, ...rest } = entry;
+			safeEntry = Object.keys(cleanLabels).length ? {
+				...rest,
+				conversionLabel: cleanLabels
+			} : rest;
+		}
 		const category = entry.category ?? "marketing";
 		tags.push({
 			key: provider,
@@ -250,7 +283,7 @@ function resolveAds(ads, ctx = {}) {
 			gated: ctx.consent === true,
 			inline: platform.tag.bootstrap(id, {
 				provider,
-				...entry
+				...safeEntry
 			}),
 			src: platform.tag.src ? platform.tag.src(id) : null,
 			attrs: {}
@@ -291,7 +324,7 @@ const PROVIDERS = new Set(Object.keys(fontProviders));
 * key into a committed file or inventing an interpolation syntax, so Adobe families are
 * declared in `astro.config` directly — see the error thrown below.
 */
-const NEEDS_OPTIONS = new Set(["adobe"]);
+const NEEDS_OPTIONS = /* @__PURE__ */ new Set(["adobe"]);
 /**
 * Map declarations onto Astro's `fonts:` entries.
 *
@@ -326,6 +359,31 @@ function resolveFonts(decls) {
 	};
 }
 
+//#endregion
+//#region src/i18n.ts
+function codesOf(entry) {
+	return typeof entry === "string" ? [entry] : entry.codes;
+}
+/** Every BCP-47 code Astro's `i18n` block actually recognises. */
+function astroLocaleCodes(i18n) {
+	return new Set(i18n.locales.flatMap(codesOf));
+}
+/**
+* Warning strings for a mismatch — `[]` when either side is absent (nothing
+* to reconcile) or the two agree.
+*/
+function localeConsistencyWarnings(site, i18n) {
+	if (!site || !i18n) return [];
+	const warnings = [];
+	const astroCodes = astroLocaleCodes(i18n);
+	const siteCodes = new Set(Object.keys(site.locales));
+	const onlyInSite = [...siteCodes].filter((c) => !astroCodes.has(c));
+	const onlyInAstro = [...astroCodes].filter((c) => !siteCodes.has(c));
+	if (onlyInSite.length || onlyInAstro.length) warnings.push(`i18n: site.locales and astro.config.mjs's i18n.locales disagree` + (onlyInSite.length ? ` — site.locales has ${onlyInSite.map((c) => `"${c}"`).join(", ")} that astro's i18n doesn't` : "") + (onlyInAstro.length ? `${onlyInSite.length ? ", and" : " —"} astro's i18n has ${onlyInAstro.map((c) => `"${c}"`).join(", ")} that site.locales doesn't` : "") + ". EmDash reads locales from astro.config.mjs directly, so a locale missing there never reaches its admin regardless of what site.locales says.");
+	if (i18n.defaultLocale !== site.defaultLocale) warnings.push(`i18n: astro.config.mjs's i18n.defaultLocale ("${i18n.defaultLocale}") does not match site.defaultLocale ("${site.defaultLocale}") — SEO/legal prose renders in one locale by default while EmDash's own routing defaults to the other.`);
+	return warnings;
+}
+
 //#endregion
 //#region src/integration.ts
 /**
@@ -367,6 +425,25 @@ function undisclosedProviders(configPath, analytics) {
 	return Object.keys(SITE_CONFIG_KEYS).filter((key) => analytics[key] !== void 0 && !declared[SITE_CONFIG_KEYS[key]]);
 }
 /**
+* Read `site.locales`/`site.defaultLocale` out of the site config, for
+* `localeConsistencyWarnings` to check against Astro's own `i18n` block.
+*
+* Best-effort, matching `readSiteAds`'s shape exactly: a malformed or missing
+* config is silence here, since every other consumer of this file already
+* validates it loudly elsewhere in the same hook.
+*/
+function readSiteLocales(configPath, siteEnv) {
+	try {
+		const cfg = resolveConfig(JSON.parse(readFileSync(configPath, "utf8")), siteEnv);
+		return {
+			locales: cfg.site.locales,
+			defaultLocale: cfg.site.defaultLocale
+		};
+	} catch {
+		return null;
+	}
+}
+/**
 * Read `site.ads` and this environment's ads switch out of the site config.
 *
 * Best-effort, like `undisclosedProviders`: every other consumer of this file
@@ -395,6 +472,55 @@ function readSiteAds(configPath, siteEnv) {
 	}
 }
 /**
+* Read `site.experiments` + `site.analytics.matomo.abVariantDimensions` out of
+* the site config, resolving each experiment's cookie name (default
+* `_ab_<key>`, matching `vitopsAbTesting()`'s own default) so `<Analytics />`
+* doesn't need to know the fallback rule itself.
+*
+* Mirrors `readSiteAds`'s shape: best-effort, only enabled experiments
+* (a disabled one has no cookie to read and shouldn't cost every provider's
+* bootstrap a no-op check), `null` when nothing's configured.
+*/
+function readSiteExperiments(configPath, siteEnv) {
+	try {
+		const cfg = resolveConfig(JSON.parse(readFileSync(configPath, "utf8")), siteEnv);
+		const configured = cfg.site.experiments;
+		if (!configured || Object.keys(configured).length === 0) return null;
+		const experiments = {};
+		let primaryCookie = null;
+		for (const [key, experiment] of Object.entries(configured)) {
+			if (!experiment.enabled) continue;
+			const cookieName = experiment.cookieName ?? `_ab_${key}`;
+			experiments[key] = { cookieName };
+			primaryCookie ??= cookieName;
+		}
+		if (Object.keys(experiments).length === 0) return null;
+		return {
+			experiments,
+			matomoAbVariantDimensions: cfg.site.analytics?.matomo?.abVariantDimensions ?? {},
+			primaryCookie
+		};
+	} catch {
+		return null;
+	}
+}
+/**
+* Is `site.crm` configured and not explicitly disabled?
+*
+* Mirrors `readSiteAds`'s "read the config, decide nothing else" shape — this
+* only answers the one question `hasConversionRoute`'s warning needs, not the
+* whole `CrmConfig`, which the consumer's own route file builds from the same
+* config however it likes.
+*/
+function siteCrmEnabled(configPath, siteEnv) {
+	try {
+		const cfg = resolveConfig(JSON.parse(readFileSync(configPath, "utf8")), siteEnv);
+		return Boolean(cfg.site.crm && cfg.site.crm.enabled !== false);
+	} catch {
+		return false;
+	}
+}
+/**
 * The consent + tracking facts a site config already states.
 *
 * These were the one pair the integration did not read. `site.tracking` and
@@ -547,6 +673,10 @@ function vitops(opts = {}) {
 			if (opts.site && !opts.css) logger.warn("site: needs a `css` config — it is read during generation, which runs in the Vite plugin that `css` registers. Without it the site config changes nothing here.");
 			const legalInput = opts.legal?.input ?? siteInput;
 			if (opts.legal && !legalInput) throw new Error("[vitops] legal: needs `legal.input` (a site config path), the top-level `site` option, or a `css.input` that is itself a site config.");
+			if (siteInput) {
+				const siteLocales = readSiteLocales(resolve(root, siteInput), opts.site?.siteEnv ?? "production");
+				for (const warning of localeConsistencyWarnings(siteLocales, config.i18n)) logger.warn(warning);
+			}
 			if (opts.seo) {
 				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.");
@@ -561,6 +691,7 @@ function vitops(opts = {}) {
 			const analytics = resolveAnalytics(opts.analytics, { consent: consentEnabled });
 			const trackingOpts = opts.tracking === true ? { enabled: true } : opts.tracking || (siteConsent?.tracking?.enabled ? siteConsent.tracking : void 0);
 			const adsConfig = siteInput ? readSiteAds(resolve(root, siteInput), opts.site?.siteEnv ?? "production") : null;
+			const experimentsConfig = siteInput ? readSiteExperiments(resolve(root, siteInput), opts.site?.siteEnv ?? "production") : null;
 			const detectedCategories = consentCategories([...analytics.tags, ...resolveAds(adsConfig?.properties, {
 				consent: consentEnabled,
 				enabled: true
@@ -576,6 +707,7 @@ function vitops(opts = {}) {
 			});
 			for (const warning of tracking.warnings) logger.warn(warning);
 			if (tracking.enabled && !hasConversionRoute(root)) logger.warn(`tracking is on, so the capture script beacons \`tel:\` conversions to ${TRACKING_ENDPOINT}, but no route answers that path. Add \`src/pages/api/track.ts\` exporting \`createConversionRoute(...)\` from \`@getvitops/astro/routes\` — otherwise every call conversion is silently lost.`);
+			if (siteInput && siteCrmEnabled(resolve(root, siteInput), opts.site?.siteEnv ?? "production") && !hasConversionRoute(root)) logger.warn(`site.crm is configured, but no route answers ${TRACKING_ENDPOINT}. Add \`src/pages/api/track.ts\` exporting \`createConversionRoute({ crm: {...}, ... })\` from \`@getvitops/astro/routes\` — otherwise submissions never reach the CRM.`);
 			const ads = resolveAds(adsConfig?.properties, {
 				consent: consentEnabled,
 				consentCategories: offeredCategories,
@@ -633,7 +765,8 @@ function vitops(opts = {}) {
 			}
 			const consentRuntime = consentEnabled || analytics.needsRuntime;
 			if (webComponents || consentRuntime) {
-				const coreDist = join(dirname(fileURLToPath(import.meta.resolve("@getvitops/core/package.json"))), "dist");
+				const corePkg = fileURLToPath(import.meta.resolve("@getvitops/core/package.json"));
+				const coreDist = join(dirname(corePkg), "dist");
 				const dest = join(publicDir, "vitops");
 				if (existsSync(coreDist)) {
 					const bundles = webComponents ? [
@@ -790,8 +923,11 @@ function vitops(opts = {}) {
 				tracking: tracking.enabled ? {
 					enabled: true,
 					category: tracking.category,
-					cookies: tracking.cookies
+					cookies: tracking.cookies,
+					abVariantCookie: experimentsConfig?.primaryCookie ?? null
 				} : null,
+				experiments: experimentsConfig?.experiments ?? {},
+				matomoAbVariantDimensions: experimentsConfig?.matomoAbVariantDimensions ?? {},
 				ads: adsConfig
 			})] } });
 			if (opts.css) {
@@ -924,7 +1060,7 @@ async function commitDates(dirs, cwd) {
 		...dirs
 	], {
 		cwd,
-		maxBuffer: 64 * 1024 * 1024
+		maxBuffer: 67108864
 	});
 	let current;
 	for (const line of stdout.split("\n")) {