@getvitops/astro 8.3.0-alpha.3 → 8.3.0-alpha.5

package/CHANGELOG.md

@@ -1,5 +1,68 @@
 # @getvitops/astro
 
+## 8.3.0-alpha.5
+
+### Minor Changes
+
+- bb61a35: **Call tracking numbers: show an ad visitor a number that attributes the phone call.** Two additive config blocks, no CSS, no breaking change — all formats unaffected.
+
+  - **`site.ads.google.callTracking`** — Google Ads _website call conversions_. `{ label, number, cache? }` makes the consent-gated Google tag fetch a Google forwarding number (Canada supported) and swap it in for visitors who arrived from a Google ad. Google replaces text only, so the capture script also rewrites the matching `tel:` href. Needs `pixelId` and `site.tracking.enabled`; rejected on any other platform (only Google can put a number on the website — Microsoft's exist only inside the ad, in the US/UK/AU).
+  - **`site.tracking.phoneNumbers`** — per-platform numbers for every other platform: the real `number`, `sources` keyed by `site.ads` platform (plus `default-paid`), and an informational `provider`. You provision the numbers with a call-tracking service (Twilio, CallRail, …). The landing URL decides first, then the `_ac` cookie, so a visitor who declines `marketing` sees a tracking number on the landing page only. An organic visitor is never swapped, and the server-rendered HTML always carries the real number.
+  - The `tel:` tap beacon now carries which number was shown (`phoneSource`), and the conversion notification says so.
+  - `vitops ads lint` flags a call-tracking provider that is not in `site.legal.privacyPolicy.processors`, and notes that `callTracking` plus `conversionLabel.call` can count one call twice (make one secondary in Google Ads).
+  - `@getvitops/utils/tracking` exports the pure `selectPhoneNumber()` and helpers; the capture script mirrors it and `tracking.test.ts` pins the two.
+  - `@getvitops/skills` gains a **`vitops-ads`** skill (overview plus a `call-tracking.md` topic). The templates gitignore synced skills by prefix (`vitops-*`, `emdash-*`), so it needs no `.gitignore` line of its own.
+
+  `@getvitops/core`, `@getvitops/vite` and `@getvitops/emdash` — no consumer-facing change in these packages.
+
+- 4d94c8b: **Added: `site.chrome` — a configurable masthead and nav behaviour.** Non-breaking.
+
+  - `site.chrome.masthead` (new `@getvitops/config` schema): `position` (`static|sticky|fixed`), `behavior` (`always|hide-on-scroll`), `surface` (`solid|glass|transparent|transparent-until-scrolled`), `tone` (a `colors.roles` key), `layout` (`full|inset|floating`), `width`, `elevation` (`shadow`, `border`, `onScroll`), `height` and `inset`. `height` and `inset` take fluid lengths (`calc()`, `clamp()`, `min()`, `max()`, with `cqi`/`vw`/… units), checked against a closed grammar because they are written into CSS. `validateConfig` rejects a `tone` or `shadow` the design system does not define (only when the default theme states them directly, not via `extends`).
+  - `site.chrome.nav`: `compact` (`drawer|dropdown`), `drawerSide`, `breakpoint`/`mobileBreakpoint`/`megaBreakpoint`, `depth`, `megaDepth`.
+  - `<Masthead config={site}>` (`@getvitops/astro`, slots `brand`/default/`actions`) and `resolveMasthead()` / `resolveNavOptions()`. A prop overrides one field per layout. The key is `chrome`/`masthead` on purpose: `<header>` is valid in any section and `banner` already means the announcement bar and the landmark role.
+  - `<SiteNav>` gains `compact="dropdown"` (a columnar panel anchored under the toggle), `drawerSide` (previously hardcoded to the end edge in Astro), `megaDepth` and `megaPanel`. `.sitenav--mega` now styles second-level items as column headings and has an optional featured column.
+  - `@getvitops/emdash`: `VitopsMegaPanel` fills that column from the widget area `mega-<item url slug>` (or a `mega-area:<name>` class on the menu item). No area means no column.
+  - `@getvitops/create` (emdash template): the layout renders through `<Masthead>`; `site.json` ships a sticky glass masthead with a shadow once scrolled. The hand-written `.navbar { block-size: 64px }` is gone (use `masthead.height`).
+  - CSS (`patterns/masthead.css`, `patterns/sitenav.css`): **all formats**, including tailwind, where the patterns are inlined into `@layer components`. Hide-on-scroll and the `*-on-scroll` states are `scroll-state()` container queries that only subtract from a settled (solid, elevated, visible) bar, so a browser without them (Firefox today) shows that bar rather than a transparent one. A sticky or fixed masthead sets `--header-offset` / `--top-offset` so anchors land below it.
+  - `@getvitops/generator`: new `TIERS.masthead`; `TIERS.sitenav` documents the new props.
+
+### Patch Changes
+
+- 785b8b3: Docs only: the `site.ads.google.conversionLabel` field descriptions and `vitops ads` now state which Google Ads category each conversion action needs (`call` → Phone call lead, `email` → Contact, `form` → Submit lead form). The category is set on the action in Google Ads, not by the tag, so a wrong one reports under the wrong goal with no code-side signal. `vitopsFormConversion()`'s docblock also warns against firing a form conversion from a success-page query parameter. No behaviour change.
+- Updated dependencies [785b8b3]
+- Updated dependencies [bb61a35]
+- Updated dependencies [4d94c8b]
+  - @getvitops/config@8.3.0-alpha.5
+  - @getvitops/utils@8.3.0-alpha.5
+  - @getvitops/generator@8.3.0-alpha.5
+  - @getvitops/core@8.3.0-alpha.5
+  - @getvitops/vite@8.3.0-alpha.5
+
+## 8.3.0-alpha.4
+
+### Minor Changes
+
+- 322dd6a: Block fixes from the vitops.ca build (findings 11–13, 15, 17, 18, 21).
+
+  - **Steps.** The marker is an outlined disc in the tone (number and ring in `--tone-solid`, falling back to `currentColor`), so a steps block with no tone no longer shows black discs with no number. Items keep `align-content: start` and no `.rhythm li + li` margin, so markers in a row line up. Two modifiers through the block's `className`: `steps--cards` (each step in a card) and `steps--animated` (the connector draws and the marker fills as each step scrolls in; static under reduced motion or without scroll-driven animations). `steps` is now a config pattern: `patterns.items.steps` in `site.json` owns the card geometry (`content` group tokens) and the marker size (`--steps-marker-size`, `--steps-line-width`); both templates and the reference config ship an entry. all formats.
+  - **Stats.** `<wc-counter>` leaves a figure it cannot count as authored (`"1 in 6"`, `"24/7"`, `"—"`) instead of counting down from zero to a wrong value. `animate: false` on the block still turns the count-up off for a whole block.
+  - **Logos.** `vitops_logos` takes an optional `kicker`, `note` and `linkLabel`/`linkHref`; with any of them set, the row is wrapped in `.logos-block`. The list keeps the block's attributes either way.
+  - **Pricing.** Plans take `yearly` (a second price line) and `note` (under the plan name).
+  - **`<SiteFooter>`** has a `brand` named slot, rendered as the first column (`.sitefooter__brand`) in the site's own markup.
+
+### Patch Changes
+
+- Updated dependencies [99e66a2]
+- Updated dependencies [00a9d86]
+- Updated dependencies [d64fb20]
+- Updated dependencies [322dd6a]
+- Updated dependencies [322dd6a]
+  - @getvitops/core@8.3.0-alpha.4
+  - @getvitops/generator@8.3.0-alpha.4
+  - @getvitops/utils@8.3.0-alpha.4
+  - @getvitops/vite@8.3.0-alpha.4
+  - @getvitops/config@8.3.0-alpha.4
+
 ## 8.3.0-alpha.3
 
 ### Patch Changes

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import { i as TRACKING_COOKIE, n as ResolveTrackingContext, o as TrackingCategor
 import { Config, LegalOutput, SiteFont, StylesheetFormat } from "@getvitops/generator";
 import { generateIconInclude } from "@getvitops/utils";
 import { AdProvider } from "@getvitops/utils/ads";
-import { AdPropertyConfig } from "@getvitops/config";
+import { AdPropertyConfig, ChromeNavConfig, MastheadBehavior, MastheadConfig, MastheadLayout, MastheadPosition, MastheadSurface, MastheadWidth } from "@getvitops/config";
 import { OutputKind } from "@getvitops/utils/media";
 import { AstroIntegration } from "astro";
 export * from "@getvitops/utils";
@@ -787,7 +787,7 @@ export default function vitops(opts?: GetvitopsOptions): AstroIntegration;
  * 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`.
  */
-type GetvitopsAdProperty = Pick<AdPropertyConfig, 'accountId' | 'pixelId' | 'conversionLabel' | 'conversionActionId' | 'reporting' | 'category' | 'enabled'>;
+type GetvitopsAdProperty = Pick<AdPropertyConfig, 'accountId' | 'pixelId' | 'conversionLabel' | 'conversionActionId' | 'callTracking' | '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 {
@@ -878,6 +878,75 @@ export declare function slugFromContent(file: string): string | undefined;
  * flip presented as a fact.
  */
 export declare function gitLastmod(options?: GitLastmodOptions): Promise<(item: GetvitopsSitemapEntry) => GetvitopsSitemapEntry>;
+/**
+ * Pure decisions behind `<SiteNav />` / `<SiteFooter />` — which menus render, to what
+ * depth, at which container breakpoint, and how an item reads. Kept out of the `.astro`
+ * files so they are asserted in `sitenav.test.ts` without rendering (the same split
+ * `tree.ts` makes for `<Tree />`).
+ *
+ * The item shape is structural, not imported from `emdash`: `@getvitops/astro` has no
+ * dependency on the CMS, and an EmDash `MenuItem` already satisfies it.
+ */
+type NavBreakpoint = 'sm' | 'md' | 'lg' | 'xl';
+/** What the toggle opens below a nav's breakpoint. */
+type NavCompactMode = 'drawer' | 'dropdown';
+type NavDrawerSide = 'start' | 'end';
+/** A masthead override: any `site.chrome.masthead` field, plus `elevation` merged key-by-key. */
+type MastheadOptions = MastheadConfig;
+interface ResolvedMasthead {
+  position: MastheadPosition;
+  behavior: MastheadBehavior;
+  surface: MastheadSurface;
+  tone: string | undefined;
+  layout: MastheadLayout;
+  width: MastheadWidth;
+  shadow: string | undefined;
+  border: boolean;
+  elevateOnScroll: boolean;
+  height: string | undefined;
+  inset: string | undefined;
+}
+/**
+ * What `resolveMasthead` needs from a config — a whole `Config`, or just `{ site: { chrome } }`.
+ * Deliberately loose: a plain `import site from './site.json'` types every enum as `string`, which
+ * the strict `ChromeConfig` would reject (the same trap `resolveOrganizationName` fell into). The
+ * values are checked at runtime instead, with the names of the allowed ones in the error.
+ */
+interface ChromeSource {
+  site?: {
+    chrome?: {
+      masthead?: Record<string, any>;
+      nav?: Record<string, any>;
+    };
+  };
+}
+export declare function resolveMasthead(config: ChromeSource | undefined, override?: MastheadOptions): ResolvedMasthead;
+/** Modifier classes on `.masthead`. */
+export declare function mastheadClass(m: ResolvedMasthead): string[];
+/**
+ * The `.tone` custom properties for a role, as a `style` string. Each is a `var()` chain that
+ * degrades to the surface role, so a role the site never defined is a neutral bar, not a
+ * transparent one. `<role>:solid` fills with the role's solid and its computed foreground.
+ */
+export declare function mastheadStyle(m: ResolvedMasthead): string | undefined;
+/**
+ * Page-level rule for a custom height and inset — `--header-offset` reads both from `:root`, and
+ * the vars inherit down to the masthead. The inset is written only for a layout that has one (a
+ * full-width bar sits flush) and then always, defaulted to the same `0.75rem` the element falls
+ * back to, since `--header-offset` adds `--masthead-inset` unconditionally.
+ */
+export declare function mastheadRootCss(m: ResolvedMasthead): string | undefined;
+/** `<SiteNav>` props from `site.chrome.nav`, with an optional override. */
+interface ResolvedNavOptions {
+  breakpoint?: NavBreakpoint;
+  mobileBreakpoint?: NavBreakpoint;
+  megaBreakpoint?: NavBreakpoint;
+  depth?: number;
+  megaDepth?: number;
+  compact?: NavCompactMode;
+  drawerSide?: NavDrawerSide;
+}
+export declare function resolveNavOptions(config: ChromeSource | undefined, override?: ChromeNavConfig): ResolvedNavOptions;
 interface ResolveSeoDefaultsOptions {
   /** Build locale. Default `site.defaultLocale`; a value with no entry falls back to the default. */
   locale?: string;
@@ -890,5 +959,5 @@ export declare function resolveSeoDefaults(config: Config, options?: ResolveSeoD
  * 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 ContentSecurityPolicyOptions, 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 InlineScriptOptions, 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 };
+export { type AnalyticsStrategy, type ClarityOptions, type ConsentCategory, type ContentSecurityPolicyOptions, 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 InlineScriptOptions, type MastheadOptions, type MatomoOptions, type OptionalConsentCategory, type PlausibleOptions, type ResolveAdsContext, type ResolveAnalyticsContext, type ResolveSeoDefaultsOptions, type ResolveTrackingContext, type ResolvedAdTag, type ResolvedAds, type ResolvedAnalytics, type ResolvedMasthead, type ResolvedNavOptions, 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/csp.ts","../src/lastmod.ts","../src/seo-defaults.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA2BY;;;;;;;KAQA;KAEA,0BAA0B,QAAQ;UAE7B;;EAEf;;;;;EAKA,WAAW;;EAEX,SAAS;;UAGM;;EAEf;EACA,WAAW;;UAGI;;EAEf;;EAEA;;;;;;;;;EASA;;UAGe;;EAEf;;EAEA;;UAGe;EACf,2BAA2B;EAC3B,mBAAmB;EACnB,SAAS;EACT,qBAAqB;;EAErB,WAAW;;;;;;;;;;UAWI;;;;;EAKf,aAAa;;EAEb;;;;;;;;;;;;;;;;;UAkBe;;EAEf;EACA,UAAU;EACV;;EAEA;EACA,UAAU;;;;;;EAMV;;EAEA;EACA;EACA,OAAO;;;UAIQ,oBAAoB;EACnC;;UAGe;EACf,MAAM;;EAEN;;EAEA;;UAGe;;EAEf;;;;;;;;;EASA,cAAc;IAAiB;;;EAE/B,4BAA4B;;;;;;;;;wBAiNd,iBACd,MAAM,uCACN,MAAK,0BACJ;;wBA2Ca,kBAAkB,MAAM,aAAa;;;;;;;;;;;;;KC1ZzC;;KAGA;;;;;;;;;;;;UAaK;;EAEf;;;;;;;;;;;;EAYA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;EACA;;IAEE,OAAO;;IAEP;;IAEA;;IAEA;MAAU;MAAa;MAAc;MAAgB;MAAiB;;;EAExE;;IAEE,OAAO;;IAEP;;IAEA;;;;UAKa;;EAEf;;;;;;EAMA;EACA;;EAEA;;EAEA;;EAEA;EACA;EACA;EACA;;EAEA;EACA;EACA;EACA;EACA;;EAEA;;EAEA;;EAEA,OAAO;;EAEP;IACE;IACA;IACA;IACA;IACA;IACA;;;EAGF;;EAEA;;;;;;;;;;EAUA;IAAe;IAAkB;;;;UAIlB;EACf;EACA;;;UAIe;EACf;EACA;;;UAIe;EACf;;EAEA;EACA;EACA;EACA;EACA,WAAW;EACX,SAAS;EACT,cAAc;EACd;IAAc;IAAkB;;;;UAIjB;;;;;;;;;EASf,OAAO;;EAEP;;EAEA;;;;;;;;;wBA8Cc,WACd,UAAU,qBACV,OAAO,UACP,KAAK,aACJ;UC9Kc;;EAEf;EACA;;EAEA;;EAEA;EACA;;;;;;;;UASe;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,UAAUA;;EAEV;;UAGe;;;;;;;;;;EAUf;;;;;EAKA;;;;;;;EAOA,SAAS;;EAET;;;;;;;;EAQA;;;;;;;;;;;;;;;;EAgBA;;UAGe;;EAEf;;EAEA;;UAGe;;;;;;EAMf;;;;;;;EAOA;;EAEA,SAAS;;EAET;;;KAIU;;UAUK;EACf;EACA;EACA,aAAa;EACb;;EAEA;IAAU;IAAc;IAAmB;;;;;;;;;;;;;;;UAe5B;;EAEf,UAAU;;EAEV;;EAEA;;EAEA;;EAEA;EACA,aAAa;EACb,UAAU;EACV;;EAEA,aACE,MAAM,0BACH,wBAAwB,QAAQ;;EAErC;IAAS;IAAuB,SAAS;;;EAEzC;;EAEA;IAAe;IAAgB;IAAiB;IAAiB;;;UAGlD;;;;;;;;;;;;;EAaf,OAAO;EACP,UAAU;;;;;;;;;;;;;;;;;;;;;;;;EAwBV,QAAQ;;EAER;;EAEA,MAAM;;;;;;;;;;;;EAYN;;;;;;;;;;;EAWA;;;;;;;;;;EAUA,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BR,2BAA2B,aAAa;;;;;;;;;;;;;EAaxC,oBAAoB;;;;;;;;;;;;;;;;EAgBpB,MAAM;;;;;;;;;;;;;;;;;;;;;;EAsBN,kBAAkB;;;;;;;;;;;;EAYlB,YAAY;;;;;;;;;;;;;EAaZ,oBAAoB;;;;;;;;;;;;;;;EAepB,qBAAqB;;UAGN;;EAEf;;EAEA,WAAW;;EAEX;;UAGe;;EAEf;;EAEA;;;;;EAKA;;;;;;;;;EASA,UAAU,kBAAkB;;;;;;;;;;;;EAY5B;;;;;;EAMA;;EAEA;;EAEA;;EAEA,YAAY;;wBA+hBU,OAAO,OAAM,mBAAwB;;;;;;;KC58BjD,sBAAsB,KAChC;KAUU,sBAAsB,QAAQ,OAAO,YAAY;;UAG5C,sBAAsB;EACrC,KAAK;;UAGU;EACf,MAAM;;EAEN;;EAEA;;UAGe;;EAEf;;EAEA;;EAEA;;EAEA,WAAW;;;wBAYG,WACd,KAAK,iCACL,MAAK,oBACJ;;wBCjEa,cAAc;UAIb;;EAEf;;EAEA;;;;;;;;wBASc,mBAAmB,OAAM;UAOxB;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,SAAS;;;;;;;;;;;wBAYK,sBAAsB,OAAM;UCpC3B;;EAEf;;EAEA;;EAEA,UAAU;;;;;;;;;wBAUI,cAAc;;wBAad,gBAAgB;;;;;;;;;wBAoDV,WACpB,UAAS,oBACR,SAAS,MAAM,0BAA0B;UC1G3B;;EAEf;;EAEA;;wBAUc,mBACd,QAAQ,QACR,UAAS,4BACR;;;;;wBAmDa,iBACd,YAAY,qBACZ,UAAU,kCACT"}
+{"version":3,"file":"index.d.mts","names":["MediaOutputKind"],"sources":["../src/analytics.ts","../src/seo.ts","../src/integration.ts","../src/ads.ts","../src/csp.ts","../src/lastmod.ts","../src/components/sitenav.ts","../src/components/masthead.ts","../src/seo-defaults.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -14,6 +14,7 @@ import { t } from "@getvitops/utils/content";
 import { createHash } from "node:crypto";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
+import { MASTHEAD_BEHAVIORS, MASTHEAD_LAYOUTS, MASTHEAD_POSITIONS, MASTHEAD_SURFACES, MASTHEAD_WIDTHS, NAV_BREAKPOINTS, NAV_COMPACT_MODES, NAV_DRAWER_SIDES } from "@getvitops/config";
 
 export * from "@getvitops/utils"
 
@@ -235,6 +236,8 @@ function consentCategories(tags) {
 * config file is not a plausible thing to allow either.
 */
 const SAFE_ID = /^[\w.-]+$/;
+/** A displayed phone number: digits and the punctuation people write around them. */
+const SAFE_PHONE = /^\+?[\d\s().-]{7,20}$/;
 /** Resolve the configured ad properties into the tags `<Ads />` emits. */
 function resolveAds(ads, ctx = {}) {
 	const warnings = [];
@@ -276,6 +279,15 @@ function resolveAds(ads, ctx = {}) {
 				conversionLabel: cleanLabels
 			} : rest;
 		}
+		if (entry.callTracking) {
+			const { label, number } = entry.callTracking;
+			const bad = !SAFE_ID.test(label) ? `callTracking.label "${label}" is not a valid label` : !SAFE_PHONE.test(number) ? `callTracking.number "${number}" is not a valid phone number` : !platform.websiteCallTracking ? `${platform.name} has no website call tracking` : null;
+			if (bad) {
+				warnings.push(`ads: ${provider} ${bad}. Website call tracking skipped.`);
+				const { callTracking: _drop, ...rest } = safeEntry;
+				safeEntry = rest;
+			}
+		}
 		const category = entry.category ?? "marketing";
 		tags.push({
 			key: provider,
@@ -1132,7 +1144,9 @@ function vitops(opts = {}) {
 							enabled: true,
 							category: tracking.category,
 							cookies: tracking.cookies,
-							abVariantCookie: experimentsConfig?.primaryCookie ?? null
+							abVariantCookie: experimentsConfig?.primaryCookie ?? null,
+							phoneNumbers: trackingOpts?.phoneNumbers ?? null,
+							googleCallTracking: !!adsConfig?.properties?.google?.callTracking
 						} : null,
 						experiments: experimentsConfig?.experiments ?? {},
 						matomoAbVariantDimensions: experimentsConfig?.matomoAbVariantDimensions ?? {},
@@ -1583,5 +1597,155 @@ function resolveSeo(defaults, props, ctx) {
 	};
 }
 
-export { TRACKING_COOKIE, consentCategories, contentSecurityPolicy, cspScriptHash, vitops as default, gitLastmod, inlineScriptHashes, mergeSeoDefaults, resolveAds, resolveAnalytics, resolveSeo, resolveSeoDefaults, resolveTracking, routeFromPage, slugFromContent };
+// src/components/masthead.ts
+/**
+* Pure decisions behind `<Masthead />` and the `<SiteNav />` options: merge `site.chrome` with a
+* per-layout override, and turn the result into classes, custom properties and `SiteNav` props.
+* Kept out of the `.astro` file so it is asserted without rendering (the `sitenav.ts` split). It
+* imports the schema's literal lists as values from `@getvitops/config` (a zod-free-at-runtime
+* leaf for these constants) and nothing from the generator, so it cannot drag it into a Worker bundle.
+*/
+function oneOf(value, allowed, field) {
+	if (value === void 0) return void 0;
+	if (!allowed.includes(value)) throw new Error(`site.chrome ${field}: "${String(value)}" is not one of ${allowed.join(" | ")}.`);
+	return value;
+}
+const LENGTH_FUNCTIONS = /* @__PURE__ */ new Set([
+	"calc",
+	"clamp",
+	"min",
+	"max"
+]);
+const LENGTH_UNITS = /* @__PURE__ */ new Set([
+	"px",
+	"rem",
+	"em",
+	"ch",
+	"%",
+	"vw",
+	"vh",
+	"vi",
+	"vb",
+	"svw",
+	"svh",
+	"dvw",
+	"dvh",
+	"lvw",
+	"lvh",
+	"cqw",
+	"cqh",
+	"cqi",
+	"cqb"
+]);
+/**
+* A CSS length written into a `<style>` — so a closed grammar, not a blocklist. Numbers must carry
+* a unit from `LENGTH_UNITS` (or be a bare `0`), functions are limited to `calc|clamp|min|max`,
+* parentheses must balance, and nothing else is admitted: no `var()`, `url()`, `;`, braces or quotes.
+* `4rem`, `clamp(3.5rem, 8cqi, 4.5rem)` and `min(100%, 80rem)` pass; `4rem;}body{…` does not.
+*/
+function isSafeLength(value) {
+	if (!/^[0-9a-z%.,+\-*/() ]+$/.test(value)) return false;
+	let depth = 0;
+	for (const ch of value) if (ch === "(") depth++;
+	else if (ch === ")" && --depth < 0) return false;
+	if (depth !== 0) return false;
+	for (const [, name] of value.matchAll(/([a-z]+)\(/g)) if (!LENGTH_FUNCTIONS.has(name)) return false;
+	const tokens = value.replace(/[a-z]+\(/g, "(").split(/[\s,()+*/]+|(?<=\d)-(?=\d)|\s-\s/).filter(Boolean);
+	if (tokens.length === 0) return false;
+	return tokens.every((t) => {
+		if (t === "0" || t === "-") return true;
+		const m = /^-?(?:\d+\.?\d*|\.\d+)([a-z%]*)$/.exec(t);
+		return m !== null && m[1] !== void 0 && LENGTH_UNITS.has(m[1]);
+	});
+}
+const ROLE = /^[a-z][a-z0-9-]*$/;
+const SHADOW = /^[a-z0-9][a-z0-9-]*$/;
+function resolveMasthead(config, override = {}) {
+	const base = config?.site?.chrome?.masthead ?? {};
+	const pick = (k) => override[k] !== void 0 ? override[k] : base[k];
+	const elevation = {
+		...base.elevation,
+		...override.elevation
+	};
+	const position = oneOf(pick("position"), MASTHEAD_POSITIONS, "masthead.position") ?? "static";
+	const height = pick("height");
+	if (height !== void 0 && !isSafeLength(height)) throw new Error(`Masthead: height "${height}" is not a plain CSS length (e.g. "4rem" or "clamp(3.5rem, 8cqi, 4.5rem)").`);
+	const inset = pick("inset");
+	if (inset !== void 0 && !isSafeLength(inset)) throw new Error(`Masthead: inset "${inset}" is not a plain CSS length (e.g. "0.75rem" or "clamp(0.5rem, 2cqi, 1.5rem)").`);
+	const tone = pick("tone");
+	if (tone !== void 0 && !ROLE.test(tone.replace(/:solid$/, ""))) throw new Error(`Masthead: tone "${tone}" must be a role name, optionally "<role>:solid".`);
+	if (elevation.shadow !== void 0 && !SHADOW.test(elevation.shadow)) throw new Error(`Masthead: elevation.shadow "${elevation.shadow}" is not a shadow name.`);
+	return {
+		position,
+		behavior: position === "static" ? "always" : oneOf(pick("behavior"), MASTHEAD_BEHAVIORS, "masthead.behavior") ?? "always",
+		surface: oneOf(pick("surface"), MASTHEAD_SURFACES, "masthead.surface") ?? "solid",
+		tone,
+		layout: oneOf(pick("layout"), MASTHEAD_LAYOUTS, "masthead.layout") ?? "full",
+		width: oneOf(pick("width"), MASTHEAD_WIDTHS, "masthead.width") ?? "content",
+		shadow: elevation.shadow,
+		border: elevation.border ?? false,
+		elevateOnScroll: elevation.onScroll ?? false,
+		height,
+		inset
+	};
+}
+/** Modifier classes on `.masthead`. */
+function mastheadClass(m) {
+	const scrollOnly = m.elevateOnScroll;
+	return [
+		"masthead",
+		...m.position !== "static" ? [`masthead--${m.position}`] : [],
+		...m.behavior === "hide-on-scroll" ? ["masthead--hide-on-scroll"] : [],
+		m.surface !== "solid" ? `masthead--${m.surface}` : "",
+		m.layout !== "full" ? `masthead--${m.layout}` : "",
+		...m.shadow ? ["masthead--shadow", ...scrollOnly ? ["masthead--shadow-on-scroll"] : []] : [],
+		...m.border ? ["masthead--border", ...scrollOnly ? ["masthead--border-on-scroll"] : []] : [],
+		...m.tone ? ["tone"] : []
+	].filter(Boolean);
+}
+/**
+* The `.tone` custom properties for a role, as a `style` string. Each is a `var()` chain that
+* degrades to the surface role, so a role the site never defined is a neutral bar, not a
+* transparent one. `<role>:solid` fills with the role's solid and its computed foreground.
+*/
+function mastheadStyle(m) {
+	const parts = [];
+	if (m.tone) {
+		const solid = m.tone.endsWith(":solid");
+		const r = m.tone.replace(/:solid$/, "");
+		parts.push(solid ? `--tone-bg: var(--color-bg-${r}-solid, var(--color-bg-${r}, var(--color-bg-surface)))` : `--tone-bg: var(--color-bg-${r}, var(--color-bg-${r}-muted, var(--color-bg-surface)))`, solid ? `--tone-fg: var(--color-text-on-${r}, var(--color-text-surface))` : `--tone-fg: var(--color-text-${r}, var(--color-text-surface))`, `--tone-border: var(--color-border-${r}, var(--color-border-surface))`);
+	}
+	if (m.shadow) parts.push(`--masthead-shadow: var(--shadow-${m.shadow})`);
+	return parts.length ? parts.join("; ") : void 0;
+}
+/**
+* Page-level rule for a custom height and inset — `--header-offset` reads both from `:root`, and
+* the vars inherit down to the masthead. The inset is written only for a layout that has one (a
+* full-width bar sits flush) and then always, defaulted to the same `0.75rem` the element falls
+* back to, since `--header-offset` adds `--masthead-inset` unconditionally.
+*/
+function mastheadRootCss(m) {
+	const decls = [m.height ? `--masthead-height:${m.height}` : "", m.layout !== "full" ? `--masthead-inset:${m.inset ?? "0.75rem"}` : ""].filter(Boolean);
+	return decls.length ? `:root{${decls.join(";")}}` : void 0;
+}
+function resolveNavOptions(config, override = {}) {
+	const m = stripUndefined({
+		...config?.site?.chrome?.nav,
+		...stripUndefined(override)
+	});
+	return stripUndefined({
+		breakpoint: oneOf(m.breakpoint, NAV_BREAKPOINTS, "nav.breakpoint"),
+		mobileBreakpoint: oneOf(m.mobileBreakpoint, NAV_BREAKPOINTS, "nav.mobileBreakpoint"),
+		megaBreakpoint: oneOf(m.megaBreakpoint, NAV_BREAKPOINTS, "nav.megaBreakpoint"),
+		depth: m.depth,
+		megaDepth: m.megaDepth,
+		compact: oneOf(m.compact, NAV_COMPACT_MODES, "nav.compact"),
+		drawerSide: oneOf(m.drawerSide, NAV_DRAWER_SIDES, "nav.drawerSide")
+	});
+}
+function stripUndefined(o) {
+	return Object.fromEntries(Object.entries(o).filter(([, v]) => v !== void 0));
+}
+
+export { TRACKING_COOKIE, consentCategories, contentSecurityPolicy, cspScriptHash, vitops as default, gitLastmod, inlineScriptHashes, mastheadClass, mastheadRootCss, mastheadStyle, mergeSeoDefaults, resolveAds, resolveAnalytics, resolveMasthead, resolveNavOptions, resolveSeo, resolveSeoDefaults, resolveTracking, routeFromPage, slugFromContent };
 //# sourceMappingURL=index.mjs.map