@brandlab-digital/site-next 3.8.0 → 3.9.0

package/dist/instrumentation-client.d.ts

@@ -1,5 +1,5 @@
 import { type ContactAttributionSummary } from '@brandlab-digital/site-core/contact';
-import { type BrandlabAnalytics, type PhoneCallPlacement } from './analytics.js';
+import { type BrandlabAnalytics, type LeadCtaPlacement, type PhoneCallPlacement } from './analytics.js';
 export type PhoneCallLocation = PhoneCallPlacement;
 export interface LastPhoneCallEvent {
     key: string;
@@ -35,15 +35,34 @@ export declare function installPhoneClickListener(options: {
     win?: Window;
     dedupeWindowMs?: number;
 }): () => void;
+/**
+ * The single delegated listener for lead calls to action: a click on an
+ * element carrying `data-bl-cta` (the ui-kit `QuoteButton`) sends one
+ * `lead_cta_click` with its cta id and its `data-bl-cta-placement`. Elements
+ * without an id or with a placement outside `LEAD_CTA_PLACEMENTS` send nothing.
+ * Rapid repeats of the same call to action on the same page are de-duplicated
+ * with the phone listener's window.
+ */
+export declare function installLeadCtaClickListener(options: {
+    trackLeadCtaClick: (context: {
+        pagePath: string;
+        ctaId: string;
+        placement: LeadCtaPlacement;
+    }) => void;
+    win?: Window;
+    dedupeWindowMs?: number;
+}): () => void;
 /**
  * The whole of `src/instrumentation-client.ts`:
  * `installBrandlabInstrumentation(analytics)`. Stores the privacy-safe landing
  * path and visit source for contact attribution, and installs the single
  * telephone-link listener that sends one `phone_link_click` per tap (rapid
- * repeats of the same link are de-duplicated). Installing twice in one window
- * is a no-op; the returned function removes the listener.
+ * repeats of the same link are de-duplicated). With the binding's
+ * `trackLeadCtaClick`, it also installs the `data-bl-cta` listener, which sends
+ * `lead_cta_click` only while lead diagnostics are on. Installing twice in one
+ * window is a no-op; the returned function removes the listeners.
  */
-export declare function installBrandlabInstrumentation(analytics: Pick<BrandlabAnalytics, 'trackPhoneLinkClick'>, options?: {
+export declare function installBrandlabInstrumentation(analytics: Pick<BrandlabAnalytics, 'trackPhoneLinkClick'> & Partial<Pick<BrandlabAnalytics, 'trackLeadCtaClick'>>, options?: {
     win?: Window;
     dedupeWindowMs?: number;
 }): () => void;

package/dist/instrumentation-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentation-client.d.ts","sourceRoot":"","sources":["../src/instrumentation-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAA;AAMvB,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAA;AAElD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,EAAE,EAAE,MAAM,CAAA;CACX;AAED,eAAO,MAAM,8BAA8B,6BAA6B,CAAA;AACxE,eAAO,MAAM,mCAAmC,OAAO,CAAA;AAEvD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,UAe9E;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAEtE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,WAOA;AAED,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAe,QAgCzD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAe,sBAOzD;AAED,wBAAgB,4BAA4B,CAAC,GAAG,GAAE,MAAe,GAAG,yBAAyB,CAkB5F;AASD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,CAc/E;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,mBAAmB,EAAE,CAAC,OAAO,EAAE;QAC7B,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,iBAAiB,CAAA;QAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAC5B,KAAK,IAAI,CAAA;IACV,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,cA4CA;AAID;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,EACzD,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,MAAM,IAAI,CA2BZ"}
+{"version":3,"file":"instrumentation-client.d.ts","sourceRoot":"","sources":["../src/instrumentation-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAA;AAMvB,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAA;AAElD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,EAAE,EAAE,MAAM,CAAA;CACX;AAED,eAAO,MAAM,8BAA8B,6BAA6B,CAAA;AACxE,eAAO,MAAM,mCAAmC,OAAO,CAAA;AAEvD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,UAe9E;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAEtE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,WAOA;AAED,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAe,QAgCzD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAe,sBAOzD;AAED,wBAAgB,4BAA4B,CAAC,GAAG,GAAE,MAAe,GAAG,yBAAyB,CAkB5F;AASD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,CAc/E;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,mBAAmB,EAAE,CAAC,OAAO,EAAE;QAC7B,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,iBAAiB,CAAA;QAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAC5B,KAAK,IAAI,CAAA;IACV,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,cA4CA;AASD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,iBAAiB,EAAE,CAAC,OAAO,EAAE;QAC3B,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,EAAE,gBAAgB,CAAA;KAC5B,KAAK,IAAI,CAAA;IACV,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,cA8BA;AAID;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,GACvD,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EACvD,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,MAAM,IAAI,CAyCZ"}

package/dist/instrumentation-client.js

@@ -1,5 +1,5 @@
 import { isContactVisitSource, } from '@brandlab-digital/site-core/contact';
-import { PHONE_CALL_PLACEMENTS, } from './analytics.js';
+import { LEAD_CTA_PLACEMENTS, PHONE_CALL_PLACEMENTS, } from './analytics.js';
 import { classifyContactAttribution, normalizeContactAttributionSummary, } from './contact/attribution.js';
 export const INITIAL_LANDING_STORAGE_PREFIX = 'brandlab.initialLanding.';
 export const DEFAULT_PHONE_CALL_DEDUPE_WINDOW_MS = 1200;
@@ -152,14 +152,61 @@ export function installPhoneClickListener(options) {
         win.document.removeEventListener('click', handlePhoneClick, true);
     };
 }
+function leadCtaPlacementValue(value) {
+    const normalized = value?.trim().toLowerCase();
+    return LEAD_CTA_PLACEMENTS.includes(normalized)
+        ? normalized
+        : undefined;
+}
+/**
+ * The single delegated listener for lead calls to action: a click on an
+ * element carrying `data-bl-cta` (the ui-kit `QuoteButton`) sends one
+ * `lead_cta_click` with its cta id and its `data-bl-cta-placement`. Elements
+ * without an id or with a placement outside `LEAD_CTA_PLACEMENTS` send nothing.
+ * Rapid repeats of the same call to action on the same page are de-duplicated
+ * with the phone listener's window.
+ */
+export function installLeadCtaClickListener(options) {
+    const win = options.win ?? window;
+    const trackLeadCtaClick = options.trackLeadCtaClick;
+    if (!trackLeadCtaClick) {
+        throw new Error('installLeadCtaClickListener requires trackLeadCtaClick.');
+    }
+    let lastEvent;
+    const handleCtaClick = (event) => {
+        const target = event.target;
+        if (!(target instanceof Element))
+            return;
+        const cta = target.closest('[data-bl-cta]');
+        if (!cta)
+            return;
+        const ctaId = cta.getAttribute('data-bl-cta')?.trim();
+        const placement = leadCtaPlacementValue(cta.getAttribute('data-bl-cta-placement'));
+        if (!ctaId || !placement)
+            return;
+        const pagePath = win.location.pathname || '/';
+        const key = `${pagePath}|${ctaId}|${placement}`;
+        const now = Date.now();
+        if (!shouldTrackPhoneCallClick({ key, now, lastEvent, dedupeWindowMs: options.dedupeWindowMs }))
+            return;
+        lastEvent = { key, at: now };
+        trackLeadCtaClick({ pagePath, ctaId, placement });
+    };
+    win.document.addEventListener('click', handleCtaClick, true);
+    return () => {
+        win.document.removeEventListener('click', handleCtaClick, true);
+    };
+}
 const installedInstrumentation = new WeakMap();
 /**
  * The whole of `src/instrumentation-client.ts`:
  * `installBrandlabInstrumentation(analytics)`. Stores the privacy-safe landing
  * path and visit source for contact attribution, and installs the single
  * telephone-link listener that sends one `phone_link_click` per tap (rapid
- * repeats of the same link are de-duplicated). Installing twice in one window
- * is a no-op; the returned function removes the listener.
+ * repeats of the same link are de-duplicated). With the binding's
+ * `trackLeadCtaClick`, it also installs the `data-bl-cta` listener, which sends
+ * `lead_cta_click` only while lead diagnostics are on. Installing twice in one
+ * window is a no-op; the returned function removes the listeners.
  */
 export function installBrandlabInstrumentation(analytics, options = {}) {
     if (!analytics || typeof analytics.trackPhoneLinkClick !== 'function') {
@@ -184,8 +231,23 @@ export function installBrandlabInstrumentation(analytics, options = {}) {
             }
         },
     });
+    const removeCtaListener = typeof analytics.trackLeadCtaClick === 'function'
+        ? installLeadCtaClickListener({
+            win,
+            ...(options.dedupeWindowMs !== undefined ? { dedupeWindowMs: options.dedupeWindowMs } : {}),
+            trackLeadCtaClick: (input) => {
+                try {
+                    analytics.trackLeadCtaClick?.(input);
+                }
+                catch {
+                    // Tracking must never block the call to action.
+                }
+            },
+        })
+        : () => undefined;
     const teardown = () => {
         removeListener();
+        removeCtaListener();
         if (installedInstrumentation.get(win) === teardown)
             installedInstrumentation.delete(win);
     };

package/dist/instrumentation-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentation-client.js","sourceRoot":"","sources":["../src/instrumentation-client.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  isContactVisitSource,\n  type ContactAttributionSummary,\n} from '@brandlab-digital/site-core/contact'\nimport {\n  PHONE_CALL_PLACEMENTS,\n  type BrandlabAnalytics,\n  type PhoneCallPlacement,\n} from './analytics.js'\nimport {\n  classifyContactAttribution,\n  normalizeContactAttributionSummary,\n} from './contact/attribution.js'\n\nexport type PhoneCallLocation = PhoneCallPlacement\n\nexport interface LastPhoneCallEvent {\n  key: string\n  at: number\n}\n\nexport const INITIAL_LANDING_STORAGE_PREFIX = 'brandlab.initialLanding.'\nexport const DEFAULT_PHONE_CALL_DEDUPE_WINDOW_MS = 1200\n\nexport function normalizeInitialLandingPath(pathname: string | null | undefined) {\n  const trimmed = pathname?.trim() || '/'\n  if (\n    !trimmed.startsWith('/') ||\n    trimmed.startsWith('//') ||\n    trimmed.includes('\\\\') ||\n    /%(?:2f|5c)/i.test(trimmed) ||\n    /[\\u0000-\\u001f\\u007f]/.test(trimmed) ||\n    trimmed.includes('?') ||\n    trimmed.includes('#')\n  ) {\n    return '/'\n  }\n  const normalized = trimmed.replace(/\\/{2,}/g, '/')\n  return normalized === '/' ? '/' : normalized.replace(/\\/+$/, '')\n}\n\nexport function createPhoneCallDedupeKey(pagePath: string, href: string) {\n  return `${pagePath}|${href}`\n}\n\nexport function shouldTrackPhoneCallClick(options: {\n  key: string\n  now: number\n  lastEvent?: LastPhoneCallEvent\n  dedupeWindowMs?: number\n}) {\n  const windowMs = options.dedupeWindowMs ?? DEFAULT_PHONE_CALL_DEDUPE_WINDOW_MS\n  return !(\n    options.lastEvent &&\n    options.lastEvent.key === options.key &&\n    options.now - options.lastEvent.at < windowMs\n  )\n}\n\nexport function persistInitialLanding(win: Window = window) {\n  try {\n    const pathKey = `${INITIAL_LANDING_STORAGE_PREFIX}path`\n    const sourceKey = `${INITIAL_LANDING_STORAGE_PREFIX}source`\n    const detailKey = `${INITIAL_LANDING_STORAGE_PREFIX}sourceDetail`\n    const existingPath = win.sessionStorage.getItem(pathKey)\n    const safePath = normalizeInitialLandingPath(existingPath ?? win.location.pathname)\n    if (existingPath !== safePath) {\n      win.sessionStorage.setItem(pathKey, safePath)\n    }\n    const existingSource = win.sessionStorage.getItem(sourceKey)\n    if (!isContactVisitSource(existingSource)) {\n      const attribution = classifyContactAttribution({\n        initialLandingPath: safePath,\n        search: win.location.search,\n        referrer: win.document.referrer,\n        siteOrigin: win.location.origin,\n      })\n      win.sessionStorage.setItem(sourceKey, attribution.visitSource)\n      if (attribution.visitSourceDetail) {\n        win.sessionStorage.setItem(detailKey, attribution.visitSourceDetail)\n      } else {\n        win.sessionStorage.removeItem(detailKey)\n      }\n    }\n    // Remove values written by the pre-RC privacy contract. Query strings and\n    // referrers are not needed for canonical lead measurement.\n    win.sessionStorage.removeItem(`${INITIAL_LANDING_STORAGE_PREFIX}url`)\n    win.sessionStorage.removeItem(`${INITIAL_LANDING_STORAGE_PREFIX}referrer`)\n  } catch {\n    // Storage failures must not affect navigation or lead tracking.\n  }\n}\n\nexport function getInitialLandingPath(win: Window = window) {\n  try {\n    const value = win.sessionStorage.getItem(`${INITIAL_LANDING_STORAGE_PREFIX}path`)\n    return value ? normalizeInitialLandingPath(value) : undefined\n  } catch {\n    return undefined\n  }\n}\n\nexport function getInitialContactAttribution(win: Window = window): ContactAttributionSummary {\n  const fallbackPath = normalizeInitialLandingPath(win.location.pathname)\n  try {\n    const initialLandingPath = normalizeInitialLandingPath(\n      win.sessionStorage.getItem(`${INITIAL_LANDING_STORAGE_PREFIX}path`) ?? fallbackPath,\n    )\n    const visitSource = win.sessionStorage.getItem(`${INITIAL_LANDING_STORAGE_PREFIX}source`)\n    const visitSourceDetail = win.sessionStorage.getItem(\n      `${INITIAL_LANDING_STORAGE_PREFIX}sourceDetail`,\n    )\n    return normalizeContactAttributionSummary({\n      initialLandingPath,\n      visitSource: isContactVisitSource(visitSource) ? visitSource : 'direct-or-unknown',\n      ...(visitSourceDetail ? { visitSourceDetail } : {}),\n    })\n  } catch {\n    return { initialLandingPath: fallbackPath, visitSource: 'direct-or-unknown' }\n  }\n}\n\nfunction placementValue(value: string | null | undefined): PhoneCallLocation | undefined {\n  const normalized = value?.trim().toLowerCase()\n  return PHONE_CALL_PLACEMENTS.includes(normalized as PhoneCallLocation)\n    ? normalized as PhoneCallLocation\n    : undefined\n}\n\n/**\n * Placement of a telephone link: its own `data-phone-location`, then a\n * `<header>` or `<footer>` ancestor, then the nearest ancestor declaring a\n * valid `data-phone-location` (for example a hero or call-to-action section),\n * otherwise `page`. Unrecognised values are ignored, so every tap still\n * produces exactly one event.\n */\nexport function getPhoneCallLocation(link: HTMLAnchorElement): PhoneCallLocation {\n  const explicit = placementValue(link.getAttribute('data-phone-location'))\n  if (explicit) return explicit\n  if (link.closest('header')) return 'header'\n  if (link.closest('footer')) return 'footer'\n  for (\n    let ancestor = link.parentElement?.closest('[data-phone-location]');\n    ancestor;\n    ancestor = ancestor.parentElement?.closest('[data-phone-location]')\n  ) {\n    const placement = placementValue(ancestor.getAttribute('data-phone-location'))\n    if (placement) return placement\n  }\n  return 'page'\n}\n\nexport function installPhoneClickListener(options: {\n  trackPhoneLinkClick: (context: {\n    pagePath: string\n    location: PhoneCallLocation\n    initialLandingPath?: string\n  }) => void\n  win?: Window\n  dedupeWindowMs?: number\n}) {\n  const win = options.win ?? window\n  const trackPhoneLinkClick = options.trackPhoneLinkClick\n  if (!trackPhoneLinkClick) {\n    throw new Error('installPhoneClickListener requires trackPhoneLinkClick.')\n  }\n  let lastEvent: LastPhoneCallEvent | undefined\n\n  const handlePhoneClick = (event: MouseEvent) => {\n    const target = event.target\n    if (!(target instanceof Element)) return\n\n    const link = target.closest<HTMLAnchorElement>('a[href^=\"tel:\"]')\n    if (!link) return\n\n    const pagePath = win.location.pathname || '/'\n    const href = link.getAttribute('href') || link.href\n    const key = createPhoneCallDedupeKey(pagePath, href)\n    const now = Date.now()\n\n    if (\n      !shouldTrackPhoneCallClick({\n        key,\n        now,\n        lastEvent,\n        dedupeWindowMs: options.dedupeWindowMs,\n      })\n    ) {\n      return\n    }\n\n    lastEvent = { key, at: now }\n    trackPhoneLinkClick({\n      pagePath,\n      location: getPhoneCallLocation(link),\n      initialLandingPath: getInitialLandingPath(win),\n    })\n  }\n\n  win.document.addEventListener('click', handlePhoneClick, true)\n\n  return () => {\n    win.document.removeEventListener('click', handlePhoneClick, true)\n  }\n}\n\nconst installedInstrumentation = new WeakMap<Window, () => void>()\n\n/**\n * The whole of `src/instrumentation-client.ts`:\n * `installBrandlabInstrumentation(analytics)`. Stores the privacy-safe landing\n * path and visit source for contact attribution, and installs the single\n * telephone-link listener that sends one `phone_link_click` per tap (rapid\n * repeats of the same link are de-duplicated). Installing twice in one window\n * is a no-op; the returned function removes the listener.\n */\nexport function installBrandlabInstrumentation(\n  analytics: Pick<BrandlabAnalytics, 'trackPhoneLinkClick'>,\n  options: { win?: Window; dedupeWindowMs?: number } = {},\n): () => void {\n  if (!analytics || typeof analytics.trackPhoneLinkClick !== 'function') {\n    throw new TypeError('installBrandlabInstrumentation requires the defineBrandlabAnalytics binding.')\n  }\n  const win = options.win ?? (typeof window === 'undefined' ? undefined : window)\n  if (!win) return () => undefined\n  const existing = installedInstrumentation.get(win)\n  if (existing) return existing\n\n  persistInitialLanding(win)\n  const removeListener = installPhoneClickListener({\n    win,\n    ...(options.dedupeWindowMs !== undefined ? { dedupeWindowMs: options.dedupeWindowMs } : {}),\n    trackPhoneLinkClick: ({ pagePath, location }) => {\n      try {\n        analytics.trackPhoneLinkClick({ pagePath, placement: location })\n      } catch {\n        // Tracking must never block the telephone action.\n      }\n    },\n  })\n  const teardown = () => {\n    removeListener()\n    if (installedInstrumentation.get(win) === teardown) installedInstrumentation.delete(win)\n  }\n  installedInstrumentation.set(win, teardown)\n  return teardown\n}\n"]}
+{"version":3,"file":"instrumentation-client.js","sourceRoot":"","sources":["../src/instrumentation-client.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  isContactVisitSource,\n  type ContactAttributionSummary,\n} from '@brandlab-digital/site-core/contact'\nimport {\n  LEAD_CTA_PLACEMENTS,\n  PHONE_CALL_PLACEMENTS,\n  type BrandlabAnalytics,\n  type LeadCtaPlacement,\n  type PhoneCallPlacement,\n} from './analytics.js'\nimport {\n  classifyContactAttribution,\n  normalizeContactAttributionSummary,\n} from './contact/attribution.js'\n\nexport type PhoneCallLocation = PhoneCallPlacement\n\nexport interface LastPhoneCallEvent {\n  key: string\n  at: number\n}\n\nexport const INITIAL_LANDING_STORAGE_PREFIX = 'brandlab.initialLanding.'\nexport const DEFAULT_PHONE_CALL_DEDUPE_WINDOW_MS = 1200\n\nexport function normalizeInitialLandingPath(pathname: string | null | undefined) {\n  const trimmed = pathname?.trim() || '/'\n  if (\n    !trimmed.startsWith('/') ||\n    trimmed.startsWith('//') ||\n    trimmed.includes('\\\\') ||\n    /%(?:2f|5c)/i.test(trimmed) ||\n    /[\\u0000-\\u001f\\u007f]/.test(trimmed) ||\n    trimmed.includes('?') ||\n    trimmed.includes('#')\n  ) {\n    return '/'\n  }\n  const normalized = trimmed.replace(/\\/{2,}/g, '/')\n  return normalized === '/' ? '/' : normalized.replace(/\\/+$/, '')\n}\n\nexport function createPhoneCallDedupeKey(pagePath: string, href: string) {\n  return `${pagePath}|${href}`\n}\n\nexport function shouldTrackPhoneCallClick(options: {\n  key: string\n  now: number\n  lastEvent?: LastPhoneCallEvent\n  dedupeWindowMs?: number\n}) {\n  const windowMs = options.dedupeWindowMs ?? DEFAULT_PHONE_CALL_DEDUPE_WINDOW_MS\n  return !(\n    options.lastEvent &&\n    options.lastEvent.key === options.key &&\n    options.now - options.lastEvent.at < windowMs\n  )\n}\n\nexport function persistInitialLanding(win: Window = window) {\n  try {\n    const pathKey = `${INITIAL_LANDING_STORAGE_PREFIX}path`\n    const sourceKey = `${INITIAL_LANDING_STORAGE_PREFIX}source`\n    const detailKey = `${INITIAL_LANDING_STORAGE_PREFIX}sourceDetail`\n    const existingPath = win.sessionStorage.getItem(pathKey)\n    const safePath = normalizeInitialLandingPath(existingPath ?? win.location.pathname)\n    if (existingPath !== safePath) {\n      win.sessionStorage.setItem(pathKey, safePath)\n    }\n    const existingSource = win.sessionStorage.getItem(sourceKey)\n    if (!isContactVisitSource(existingSource)) {\n      const attribution = classifyContactAttribution({\n        initialLandingPath: safePath,\n        search: win.location.search,\n        referrer: win.document.referrer,\n        siteOrigin: win.location.origin,\n      })\n      win.sessionStorage.setItem(sourceKey, attribution.visitSource)\n      if (attribution.visitSourceDetail) {\n        win.sessionStorage.setItem(detailKey, attribution.visitSourceDetail)\n      } else {\n        win.sessionStorage.removeItem(detailKey)\n      }\n    }\n    // Remove values written by the pre-RC privacy contract. Query strings and\n    // referrers are not needed for canonical lead measurement.\n    win.sessionStorage.removeItem(`${INITIAL_LANDING_STORAGE_PREFIX}url`)\n    win.sessionStorage.removeItem(`${INITIAL_LANDING_STORAGE_PREFIX}referrer`)\n  } catch {\n    // Storage failures must not affect navigation or lead tracking.\n  }\n}\n\nexport function getInitialLandingPath(win: Window = window) {\n  try {\n    const value = win.sessionStorage.getItem(`${INITIAL_LANDING_STORAGE_PREFIX}path`)\n    return value ? normalizeInitialLandingPath(value) : undefined\n  } catch {\n    return undefined\n  }\n}\n\nexport function getInitialContactAttribution(win: Window = window): ContactAttributionSummary {\n  const fallbackPath = normalizeInitialLandingPath(win.location.pathname)\n  try {\n    const initialLandingPath = normalizeInitialLandingPath(\n      win.sessionStorage.getItem(`${INITIAL_LANDING_STORAGE_PREFIX}path`) ?? fallbackPath,\n    )\n    const visitSource = win.sessionStorage.getItem(`${INITIAL_LANDING_STORAGE_PREFIX}source`)\n    const visitSourceDetail = win.sessionStorage.getItem(\n      `${INITIAL_LANDING_STORAGE_PREFIX}sourceDetail`,\n    )\n    return normalizeContactAttributionSummary({\n      initialLandingPath,\n      visitSource: isContactVisitSource(visitSource) ? visitSource : 'direct-or-unknown',\n      ...(visitSourceDetail ? { visitSourceDetail } : {}),\n    })\n  } catch {\n    return { initialLandingPath: fallbackPath, visitSource: 'direct-or-unknown' }\n  }\n}\n\nfunction placementValue(value: string | null | undefined): PhoneCallLocation | undefined {\n  const normalized = value?.trim().toLowerCase()\n  return PHONE_CALL_PLACEMENTS.includes(normalized as PhoneCallLocation)\n    ? normalized as PhoneCallLocation\n    : undefined\n}\n\n/**\n * Placement of a telephone link: its own `data-phone-location`, then a\n * `<header>` or `<footer>` ancestor, then the nearest ancestor declaring a\n * valid `data-phone-location` (for example a hero or call-to-action section),\n * otherwise `page`. Unrecognised values are ignored, so every tap still\n * produces exactly one event.\n */\nexport function getPhoneCallLocation(link: HTMLAnchorElement): PhoneCallLocation {\n  const explicit = placementValue(link.getAttribute('data-phone-location'))\n  if (explicit) return explicit\n  if (link.closest('header')) return 'header'\n  if (link.closest('footer')) return 'footer'\n  for (\n    let ancestor = link.parentElement?.closest('[data-phone-location]');\n    ancestor;\n    ancestor = ancestor.parentElement?.closest('[data-phone-location]')\n  ) {\n    const placement = placementValue(ancestor.getAttribute('data-phone-location'))\n    if (placement) return placement\n  }\n  return 'page'\n}\n\nexport function installPhoneClickListener(options: {\n  trackPhoneLinkClick: (context: {\n    pagePath: string\n    location: PhoneCallLocation\n    initialLandingPath?: string\n  }) => void\n  win?: Window\n  dedupeWindowMs?: number\n}) {\n  const win = options.win ?? window\n  const trackPhoneLinkClick = options.trackPhoneLinkClick\n  if (!trackPhoneLinkClick) {\n    throw new Error('installPhoneClickListener requires trackPhoneLinkClick.')\n  }\n  let lastEvent: LastPhoneCallEvent | undefined\n\n  const handlePhoneClick = (event: MouseEvent) => {\n    const target = event.target\n    if (!(target instanceof Element)) return\n\n    const link = target.closest<HTMLAnchorElement>('a[href^=\"tel:\"]')\n    if (!link) return\n\n    const pagePath = win.location.pathname || '/'\n    const href = link.getAttribute('href') || link.href\n    const key = createPhoneCallDedupeKey(pagePath, href)\n    const now = Date.now()\n\n    if (\n      !shouldTrackPhoneCallClick({\n        key,\n        now,\n        lastEvent,\n        dedupeWindowMs: options.dedupeWindowMs,\n      })\n    ) {\n      return\n    }\n\n    lastEvent = { key, at: now }\n    trackPhoneLinkClick({\n      pagePath,\n      location: getPhoneCallLocation(link),\n      initialLandingPath: getInitialLandingPath(win),\n    })\n  }\n\n  win.document.addEventListener('click', handlePhoneClick, true)\n\n  return () => {\n    win.document.removeEventListener('click', handlePhoneClick, true)\n  }\n}\n\nfunction leadCtaPlacementValue(value: string | null | undefined): LeadCtaPlacement | undefined {\n  const normalized = value?.trim().toLowerCase()\n  return LEAD_CTA_PLACEMENTS.includes(normalized as LeadCtaPlacement)\n    ? normalized as LeadCtaPlacement\n    : undefined\n}\n\n/**\n * The single delegated listener for lead calls to action: a click on an\n * element carrying `data-bl-cta` (the ui-kit `QuoteButton`) sends one\n * `lead_cta_click` with its cta id and its `data-bl-cta-placement`. Elements\n * without an id or with a placement outside `LEAD_CTA_PLACEMENTS` send nothing.\n * Rapid repeats of the same call to action on the same page are de-duplicated\n * with the phone listener's window.\n */\nexport function installLeadCtaClickListener(options: {\n  trackLeadCtaClick: (context: {\n    pagePath: string\n    ctaId: string\n    placement: LeadCtaPlacement\n  }) => void\n  win?: Window\n  dedupeWindowMs?: number\n}) {\n  const win = options.win ?? window\n  const trackLeadCtaClick = options.trackLeadCtaClick\n  if (!trackLeadCtaClick) {\n    throw new Error('installLeadCtaClickListener requires trackLeadCtaClick.')\n  }\n\n  let lastEvent: LastPhoneCallEvent | undefined\n\n  const handleCtaClick = (event: MouseEvent) => {\n    const target = event.target\n    if (!(target instanceof Element)) return\n    const cta = target.closest<HTMLElement>('[data-bl-cta]')\n    if (!cta) return\n    const ctaId = cta.getAttribute('data-bl-cta')?.trim()\n    const placement = leadCtaPlacementValue(cta.getAttribute('data-bl-cta-placement'))\n    if (!ctaId || !placement) return\n    const pagePath = win.location.pathname || '/'\n    const key = `${pagePath}|${ctaId}|${placement}`\n    const now = Date.now()\n    if (!shouldTrackPhoneCallClick({ key, now, lastEvent, dedupeWindowMs: options.dedupeWindowMs })) return\n    lastEvent = { key, at: now }\n    trackLeadCtaClick({ pagePath, ctaId, placement })\n  }\n\n  win.document.addEventListener('click', handleCtaClick, true)\n\n  return () => {\n    win.document.removeEventListener('click', handleCtaClick, true)\n  }\n}\n\nconst installedInstrumentation = new WeakMap<Window, () => void>()\n\n/**\n * The whole of `src/instrumentation-client.ts`:\n * `installBrandlabInstrumentation(analytics)`. Stores the privacy-safe landing\n * path and visit source for contact attribution, and installs the single\n * telephone-link listener that sends one `phone_link_click` per tap (rapid\n * repeats of the same link are de-duplicated). With the binding's\n * `trackLeadCtaClick`, it also installs the `data-bl-cta` listener, which sends\n * `lead_cta_click` only while lead diagnostics are on. Installing twice in one\n * window is a no-op; the returned function removes the listeners.\n */\nexport function installBrandlabInstrumentation(\n  analytics: Pick<BrandlabAnalytics, 'trackPhoneLinkClick'> &\n    Partial<Pick<BrandlabAnalytics, 'trackLeadCtaClick'>>,\n  options: { win?: Window; dedupeWindowMs?: number } = {},\n): () => void {\n  if (!analytics || typeof analytics.trackPhoneLinkClick !== 'function') {\n    throw new TypeError('installBrandlabInstrumentation requires the defineBrandlabAnalytics binding.')\n  }\n  const win = options.win ?? (typeof window === 'undefined' ? undefined : window)\n  if (!win) return () => undefined\n  const existing = installedInstrumentation.get(win)\n  if (existing) return existing\n\n  persistInitialLanding(win)\n  const removeListener = installPhoneClickListener({\n    win,\n    ...(options.dedupeWindowMs !== undefined ? { dedupeWindowMs: options.dedupeWindowMs } : {}),\n    trackPhoneLinkClick: ({ pagePath, location }) => {\n      try {\n        analytics.trackPhoneLinkClick({ pagePath, placement: location })\n      } catch {\n        // Tracking must never block the telephone action.\n      }\n    },\n  })\n  const removeCtaListener = typeof analytics.trackLeadCtaClick === 'function'\n    ? installLeadCtaClickListener({\n      win,\n      ...(options.dedupeWindowMs !== undefined ? { dedupeWindowMs: options.dedupeWindowMs } : {}),\n      trackLeadCtaClick: (input) => {\n        try {\n          analytics.trackLeadCtaClick?.(input)\n        } catch {\n          // Tracking must never block the call to action.\n        }\n      },\n    })\n    : () => undefined\n  const teardown = () => {\n    removeListener()\n    removeCtaListener()\n    if (installedInstrumentation.get(win) === teardown) installedInstrumentation.delete(win)\n  }\n  installedInstrumentation.set(win, teardown)\n  return teardown\n}\n"]}

package/dist/navigation/constants.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The shell's timings, breakpoints and hooks as plain values (no React), so server components can read them. A site
+ * can't change them.
+ */
+/** F3: a fine mouse opens a panel 100 ms after it enters an item and closes it 200 ms after it leaves. */
+export declare const NAV_HOVER_OPEN_DELAY_MS = 100;
+export declare const NAV_HOVER_CLOSE_DELAY_MS = 200;
+/** Only a fine mouse pointer that can hover opens panels on hover. */
+export declare const NAV_HOVER_MEDIA_QUERY = "(hover: hover) and (pointer: fine)";
+/** F2: header modes by the header's own width. */
+export declare const HEADER_DESKTOP_MIN_WIDTH = 1280;
+export declare const HEADER_COMPACT_MIN_WIDTH = 1024;
+/** With `compactAfterScroll`, the header compacts once the page has scrolled this far. */
+export declare const HEADER_COMPACT_AFTER_SCROLL_PX = 80;
+export type HeaderMode = 'phone' | 'compact' | 'desktop';
+export declare function headerModeFor(width: number): HeaderMode;
+/** F6: the call bar shows below this viewport width. */
+export declare const CALL_BAR_MEDIA_QUERY = "(max-width: 1023.98px)";
+/** F6: the hero's own call and quote buttons (and any other call path) carry this marker. */
+export declare const CALL_PATH_SELECTOR = "[data-bl-call-path]";
+/** F7: back-to-top shows after this many screens of scrolling. */
+export declare const BACK_TO_TOP_AFTER_SCREENS = 1.5;
+/** F12: the skip-link target, which back-to-top also focuses. */
+export declare const MAIN_CONTENT_ID = "main";
+//# sourceMappingURL=constants.d.ts.map

package/dist/navigation/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/navigation/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0GAA0G;AAC1G,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAC1C,eAAO,MAAM,wBAAwB,MAAM,CAAA;AAC3C,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,uCAAuC,CAAA;AAEzE,kDAAkD;AAClD,eAAO,MAAM,wBAAwB,OAAO,CAAA;AAC5C,eAAO,MAAM,wBAAwB,OAAO,CAAA;AAC5C,0FAA0F;AAC1F,eAAO,MAAM,8BAA8B,KAAK,CAAA;AAEhD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAA;AAExD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAIvD;AAED,wDAAwD;AACxD,eAAO,MAAM,oBAAoB,2BAA2B,CAAA;AAC5D,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,wBAAwB,CAAA;AAEvD,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAC5C,iEAAiE;AACjE,eAAO,MAAM,eAAe,SAAS,CAAA"}

package/dist/navigation/constants.js

@@ -0,0 +1,30 @@
+/**
+ * The shell's timings, breakpoints and hooks as plain values (no React), so server components can read them. A site
+ * can't change them.
+ */
+/** F3: a fine mouse opens a panel 100 ms after it enters an item and closes it 200 ms after it leaves. */
+export const NAV_HOVER_OPEN_DELAY_MS = 100;
+export const NAV_HOVER_CLOSE_DELAY_MS = 200;
+/** Only a fine mouse pointer that can hover opens panels on hover. */
+export const NAV_HOVER_MEDIA_QUERY = '(hover: hover) and (pointer: fine)';
+/** F2: header modes by the header's own width. */
+export const HEADER_DESKTOP_MIN_WIDTH = 1280;
+export const HEADER_COMPACT_MIN_WIDTH = 1024;
+/** With `compactAfterScroll`, the header compacts once the page has scrolled this far. */
+export const HEADER_COMPACT_AFTER_SCROLL_PX = 80;
+export function headerModeFor(width) {
+    if (width >= HEADER_DESKTOP_MIN_WIDTH)
+        return 'desktop';
+    if (width >= HEADER_COMPACT_MIN_WIDTH)
+        return 'compact';
+    return 'phone';
+}
+/** F6: the call bar shows below this viewport width. */
+export const CALL_BAR_MEDIA_QUERY = '(max-width: 1023.98px)';
+/** F6: the hero's own call and quote buttons (and any other call path) carry this marker. */
+export const CALL_PATH_SELECTOR = '[data-bl-call-path]';
+/** F7: back-to-top shows after this many screens of scrolling. */
+export const BACK_TO_TOP_AFTER_SCREENS = 1.5;
+/** F12: the skip-link target, which back-to-top also focuses. */
+export const MAIN_CONTENT_ID = 'main';
+//# sourceMappingURL=constants.js.map

package/dist/navigation/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/navigation/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0GAA0G;AAC1G,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAA;AAC1C,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAA;AAC3C,sEAAsE;AACtE,MAAM,CAAC,MAAM,qBAAqB,GAAG,oCAAoC,CAAA;AAEzE,kDAAkD;AAClD,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAA;AAC5C,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAA;AAC5C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAA;AAIhD,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,KAAK,IAAI,wBAAwB;QAAE,OAAO,SAAS,CAAA;IACvD,IAAI,KAAK,IAAI,wBAAwB;QAAE,OAAO,SAAS,CAAA;IACvD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,wBAAwB,CAAA;AAC5D,6FAA6F;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAG,qBAAqB,CAAA;AAEvD,kEAAkE;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAA;AAC5C,iEAAiE;AACjE,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAA","sourcesContent":["/**\n * The shell's timings, breakpoints and hooks as plain values (no React), so server components can read them. A site\n * can't change them.\n */\n\n/** F3: a fine mouse opens a panel 100 ms after it enters an item and closes it 200 ms after it leaves. */\nexport const NAV_HOVER_OPEN_DELAY_MS = 100\nexport const NAV_HOVER_CLOSE_DELAY_MS = 200\n/** Only a fine mouse pointer that can hover opens panels on hover. */\nexport const NAV_HOVER_MEDIA_QUERY = '(hover: hover) and (pointer: fine)'\n\n/** F2: header modes by the header's own width. */\nexport const HEADER_DESKTOP_MIN_WIDTH = 1280\nexport const HEADER_COMPACT_MIN_WIDTH = 1024\n/** With `compactAfterScroll`, the header compacts once the page has scrolled this far. */\nexport const HEADER_COMPACT_AFTER_SCROLL_PX = 80\n\nexport type HeaderMode = 'phone' | 'compact' | 'desktop'\n\nexport function headerModeFor(width: number): HeaderMode {\n  if (width >= HEADER_DESKTOP_MIN_WIDTH) return 'desktop'\n  if (width >= HEADER_COMPACT_MIN_WIDTH) return 'compact'\n  return 'phone'\n}\n\n/** F6: the call bar shows below this viewport width. */\nexport const CALL_BAR_MEDIA_QUERY = '(max-width: 1023.98px)'\n/** F6: the hero's own call and quote buttons (and any other call path) carry this marker. */\nexport const CALL_PATH_SELECTOR = '[data-bl-call-path]'\n\n/** F7: back-to-top shows after this many screens of scrolling. */\nexport const BACK_TO_TOP_AFTER_SCREENS = 1.5\n/** F12: the skip-link target, which back-to-top also focuses. */\nexport const MAIN_CONTENT_ID = 'main'\n"]}

package/dist/navigation/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `@brandlab-digital/site-next/navigation`: the client hooks behind the ui-kit shell, and its timings and breakpoints.
+ * The ui-kit components use the hooks; a site uses them directly only in a recorded bespoke header. The hook modules
+ * are client modules; the constants are plain values a server component can read.
+ */
+export { BACK_TO_TOP_AFTER_SCREENS, CALL_BAR_MEDIA_QUERY, CALL_PATH_SELECTOR, HEADER_COMPACT_AFTER_SCROLL_PX, HEADER_COMPACT_MIN_WIDTH, HEADER_DESKTOP_MIN_WIDTH, MAIN_CONTENT_ID, NAV_HOVER_CLOSE_DELAY_MS, NAV_HOVER_MEDIA_QUERY, NAV_HOVER_OPEN_DELAY_MS, headerModeFor, type HeaderMode, } from './constants.js';
+export { useNavigationMenu, type NavigationMenu, type NavigationOpenedBy } from './use-navigation-menu.js';
+export { useHeaderMetrics, type HeaderMetrics } from './use-header-metrics.js';
+export { useStickyCallBar } from './use-sticky-call-bar.js';
+export { useBackToTop } from './use-back-to-top.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/navigation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,8BAA8B,EAC9B,wBAAwB,EACxB,wBAAwB,EACxB,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,EACb,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAC1G,OAAO,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/navigation/index.js

@@ -0,0 +1,11 @@
+/**
+ * `@brandlab-digital/site-next/navigation`: the client hooks behind the ui-kit shell, and its timings and breakpoints.
+ * The ui-kit components use the hooks; a site uses them directly only in a recorded bespoke header. The hook modules
+ * are client modules; the constants are plain values a server component can read.
+ */
+export { BACK_TO_TOP_AFTER_SCREENS, CALL_BAR_MEDIA_QUERY, CALL_PATH_SELECTOR, HEADER_COMPACT_AFTER_SCROLL_PX, HEADER_COMPACT_MIN_WIDTH, HEADER_DESKTOP_MIN_WIDTH, MAIN_CONTENT_ID, NAV_HOVER_CLOSE_DELAY_MS, NAV_HOVER_MEDIA_QUERY, NAV_HOVER_OPEN_DELAY_MS, headerModeFor, } from './constants.js';
+export { useNavigationMenu } from './use-navigation-menu.js';
+export { useHeaderMetrics } from './use-header-metrics.js';
+export { useStickyCallBar } from './use-sticky-call-bar.js';
+export { useBackToTop } from './use-back-to-top.js';
+//# sourceMappingURL=index.js.map

package/dist/navigation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,8BAA8B,EAC9B,wBAAwB,EACxB,wBAAwB,EACxB,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,GAEd,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAAgD,MAAM,0BAA0B,CAAA;AAC1G,OAAO,EAAE,gBAAgB,EAAsB,MAAM,yBAAyB,CAAA;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA","sourcesContent":["/**\n * `@brandlab-digital/site-next/navigation`: the client hooks behind the ui-kit shell, and its timings and breakpoints.\n * The ui-kit components use the hooks; a site uses them directly only in a recorded bespoke header. The hook modules\n * are client modules; the constants are plain values a server component can read.\n */\nexport {\n  BACK_TO_TOP_AFTER_SCREENS,\n  CALL_BAR_MEDIA_QUERY,\n  CALL_PATH_SELECTOR,\n  HEADER_COMPACT_AFTER_SCROLL_PX,\n  HEADER_COMPACT_MIN_WIDTH,\n  HEADER_DESKTOP_MIN_WIDTH,\n  MAIN_CONTENT_ID,\n  NAV_HOVER_CLOSE_DELAY_MS,\n  NAV_HOVER_MEDIA_QUERY,\n  NAV_HOVER_OPEN_DELAY_MS,\n  headerModeFor,\n  type HeaderMode,\n} from './constants.js'\nexport { useNavigationMenu, type NavigationMenu, type NavigationOpenedBy } from './use-navigation-menu.js'\nexport { useHeaderMetrics, type HeaderMetrics } from './use-header-metrics.js'\nexport { useStickyCallBar } from './use-sticky-call-bar.js'\nexport { useBackToTop } from './use-back-to-top.js'\n"]}

package/dist/navigation/use-back-to-top.d.ts

@@ -0,0 +1,5 @@
+export declare function useBackToTop(): {
+    readonly shown: boolean;
+    scrollToTop(): void;
+};
+//# sourceMappingURL=use-back-to-top.d.ts.map

package/dist/navigation/use-back-to-top.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-back-to-top.d.ts","sourceRoot":"","sources":["../../src/navigation/use-back-to-top.ts"],"names":[],"mappings":"AASA,wBAAgB,YAAY,IAAI;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,WAAW,IAAI,IAAI,CAAA;CAAE,CAwB/E"}

package/dist/navigation/use-back-to-top.js

@@ -0,0 +1,32 @@
+'use client';
+/**
+ * F7: back-to-top. It shows after one and a half screens of scrolling; it scrolls smoothly unless the visitor prefers
+ * reduced motion, and moves focus to the skip-link target (`#main`), so keyboard users start again at the top.
+ */
+import { useCallback, useEffect, useState } from 'react';
+import { BACK_TO_TOP_AFTER_SCREENS, MAIN_CONTENT_ID } from './constants.js';
+export function useBackToTop() {
+    const [shown, setShown] = useState(false);
+    useEffect(() => {
+        const update = () => setShown(window.scrollY > window.innerHeight * BACK_TO_TOP_AFTER_SCREENS);
+        update();
+        window.addEventListener('scroll', update, { passive: true });
+        window.addEventListener('resize', update);
+        return () => {
+            window.removeEventListener('scroll', update);
+            window.removeEventListener('resize', update);
+        };
+    }, []);
+    const scrollToTop = useCallback(() => {
+        const reduced = typeof window.matchMedia === 'function' && window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+        window.scrollTo({ top: 0, behavior: reduced ? 'auto' : 'smooth' });
+        const main = document.getElementById(MAIN_CONTENT_ID);
+        if (!main)
+            return;
+        if (!main.hasAttribute('tabindex'))
+            main.setAttribute('tabindex', '-1');
+        main.focus({ preventScroll: true });
+    }, []);
+    return { shown, scrollToTop };
+}
+//# sourceMappingURL=use-back-to-top.js.map

package/dist/navigation/use-back-to-top.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-back-to-top.js","sourceRoot":"","sources":["../../src/navigation/use-back-to-top.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AACxD,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAE3E,MAAM,UAAU,YAAY;IAC1B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,WAAW,GAAG,yBAAyB,CAAC,CAAA;QAC9F,MAAM,EAAE,CAAA;QACR,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QAC5D,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QACzC,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;YAC5C,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC9C,CAAC,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,MAAM,OAAO,GAAG,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO,CAAA;QACxH,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAA;QAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,cAAc,CAAC,eAAe,CAAC,CAAA;QACrD,IAAI,CAAC,IAAI;YAAE,OAAM;QACjB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;YAAE,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QACvE,IAAI,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;IACrC,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAA;AAC/B,CAAC","sourcesContent":["'use client'\n\n/**\n * F7: back-to-top. It shows after one and a half screens of scrolling; it scrolls smoothly unless the visitor prefers\n * reduced motion, and moves focus to the skip-link target (`#main`), so keyboard users start again at the top.\n */\nimport { useCallback, useEffect, useState } from 'react'\nimport { BACK_TO_TOP_AFTER_SCREENS, MAIN_CONTENT_ID } from './constants.js'\n\nexport function useBackToTop(): { readonly shown: boolean; scrollToTop(): void } {\n  const [shown, setShown] = useState(false)\n\n  useEffect(() => {\n    const update = () => setShown(window.scrollY > window.innerHeight * BACK_TO_TOP_AFTER_SCREENS)\n    update()\n    window.addEventListener('scroll', update, { passive: true })\n    window.addEventListener('resize', update)\n    return () => {\n      window.removeEventListener('scroll', update)\n      window.removeEventListener('resize', update)\n    }\n  }, [])\n\n  const scrollToTop = useCallback(() => {\n    const reduced = typeof window.matchMedia === 'function' && window.matchMedia('(prefers-reduced-motion: reduce)').matches\n    window.scrollTo({ top: 0, behavior: reduced ? 'auto' : 'smooth' })\n    const main = document.getElementById(MAIN_CONTENT_ID)\n    if (!main) return\n    if (!main.hasAttribute('tabindex')) main.setAttribute('tabindex', '-1')\n    main.focus({ preventScroll: true })\n  }, [])\n\n  return { shown, scrollToTop }\n}\n"]}

package/dist/navigation/use-header-metrics.d.ts

@@ -0,0 +1,17 @@
+/**
+ * F2: the header's measured state. The mode follows the header's own width (so a framed specimen behaves like a real
+ * window): 1280 px and up `desktop`, 1024 to 1279 px `compact`, below 1024 px `phone`. The hook writes the frozen
+ * hooks on the header root (`data-mode`, `data-hydrated`, `data-compact`) and `--bl-header-height` on the document,
+ * which drives `scroll-padding-top` (WCAG 2.4.11).
+ */
+import { type RefObject } from 'react';
+import { type HeaderMode } from './constants.js';
+export interface HeaderMetrics {
+    /** Null until the header has been measured after hydration. */
+    readonly mode: HeaderMode | null;
+    readonly hydrated: boolean;
+}
+export declare function useHeaderMetrics(rootRef: RefObject<HTMLElement | null>, options?: {
+    compactAfterScroll?: boolean;
+}): HeaderMetrics;
+//# sourceMappingURL=use-header-metrics.d.ts.map

package/dist/navigation/use-header-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-header-metrics.d.ts","sourceRoot":"","sources":["../../src/navigation/use-header-metrics.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC3D,OAAO,EAAiD,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE/F,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC3B;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,OAAO,GAAE;IAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,aAAa,CAyCtI"}

package/dist/navigation/use-header-metrics.js

@@ -0,0 +1,52 @@
+'use client';
+/**
+ * F2: the header's measured state. The mode follows the header's own width (so a framed specimen behaves like a real
+ * window): 1280 px and up `desktop`, 1024 to 1279 px `compact`, below 1024 px `phone`. The hook writes the frozen
+ * hooks on the header root (`data-mode`, `data-hydrated`, `data-compact`) and `--bl-header-height` on the document,
+ * which drives `scroll-padding-top` (WCAG 2.4.11).
+ */
+import { useEffect, useState } from 'react';
+import { HEADER_COMPACT_AFTER_SCROLL_PX, headerModeFor } from './constants.js';
+export function useHeaderMetrics(rootRef, options = {}) {
+    const compactAfterScroll = options.compactAfterScroll ?? false;
+    const [metrics, setMetrics] = useState({ mode: null, hydrated: false });
+    useEffect(() => {
+        const root = rootRef.current;
+        if (!root)
+            return;
+        const html = document.documentElement;
+        const measure = () => {
+            const box = root.getBoundingClientRect();
+            const mode = headerModeFor(box.width);
+            root.dataset.mode = mode;
+            html.style.setProperty('--bl-header-height', `${Math.round(box.height)}px`);
+            setMetrics((current) => (current.mode === mode && current.hydrated ? current : { mode, hydrated: true }));
+        };
+        const onScroll = () => {
+            root.dataset.compact = window.scrollY > HEADER_COMPACT_AFTER_SCROLL_PX ? 'true' : 'false';
+        };
+        root.dataset.hydrated = 'true';
+        measure();
+        let observer;
+        if (typeof ResizeObserver === 'function') {
+            observer = new ResizeObserver(measure);
+            observer.observe(root);
+        }
+        else {
+            window.addEventListener('resize', measure);
+        }
+        if (compactAfterScroll) {
+            onScroll();
+            window.addEventListener('scroll', onScroll, { passive: true });
+        }
+        return () => {
+            observer?.disconnect();
+            window.removeEventListener('resize', measure);
+            window.removeEventListener('scroll', onScroll);
+            delete root.dataset.compact;
+            html.style.removeProperty('--bl-header-height');
+        };
+    }, [rootRef, compactAfterScroll]);
+    return metrics;
+}
+//# sourceMappingURL=use-header-metrics.js.map

package/dist/navigation/use-header-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-header-metrics.js","sourceRoot":"","sources":["../../src/navigation/use-header-metrics.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAA;AAC3D,OAAO,EAAE,8BAA8B,EAAE,aAAa,EAAmB,MAAM,gBAAgB,CAAA;AAQ/F,MAAM,UAAU,gBAAgB,CAAC,OAAsC,EAAE,UAA4C,EAAE;IACrH,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,KAAK,CAAA;IAC9D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAA;IAEtF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAA;QAC5B,IAAI,CAAC,IAAI;YAAE,OAAM;QACjB,MAAM,IAAI,GAAG,QAAQ,CAAC,eAAe,CAAA;QACrC,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,MAAM,GAAG,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAA;YACxC,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACrC,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAA;YACxB,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,oBAAoB,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAC3E,UAAU,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QAC3G,CAAC,CAAA;QACD,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,GAAG,8BAA8B,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAA;QAC3F,CAAC,CAAA;QACD,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAA;QAC9B,OAAO,EAAE,CAAA;QACT,IAAI,QAAoC,CAAA;QACxC,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;YACzC,QAAQ,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,CAAA;YACtC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACxB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAC5C,CAAC;QACD,IAAI,kBAAkB,EAAE,CAAC;YACvB,QAAQ,EAAE,CAAA;YACV,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QAChE,CAAC;QACD,OAAO,GAAG,EAAE;YACV,QAAQ,EAAE,UAAU,EAAE,CAAA;YACtB,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YAC7C,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;YAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAA;YAC3B,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAA;QACjD,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAA;IAEjC,OAAO,OAAO,CAAA;AAChB,CAAC","sourcesContent":["'use client'\n\n/**\n * F2: the header's measured state. The mode follows the header's own width (so a framed specimen behaves like a real\n * window): 1280 px and up `desktop`, 1024 to 1279 px `compact`, below 1024 px `phone`. The hook writes the frozen\n * hooks on the header root (`data-mode`, `data-hydrated`, `data-compact`) and `--bl-header-height` on the document,\n * which drives `scroll-padding-top` (WCAG 2.4.11).\n */\nimport { useEffect, useState, type RefObject } from 'react'\nimport { HEADER_COMPACT_AFTER_SCROLL_PX, headerModeFor, type HeaderMode } from './constants.js'\n\nexport interface HeaderMetrics {\n  /** Null until the header has been measured after hydration. */\n  readonly mode: HeaderMode | null\n  readonly hydrated: boolean\n}\n\nexport function useHeaderMetrics(rootRef: RefObject<HTMLElement | null>, options: { compactAfterScroll?: boolean } = {}): HeaderMetrics {\n  const compactAfterScroll = options.compactAfterScroll ?? false\n  const [metrics, setMetrics] = useState<HeaderMetrics>({ mode: null, hydrated: false })\n\n  useEffect(() => {\n    const root = rootRef.current\n    if (!root) return\n    const html = document.documentElement\n    const measure = () => {\n      const box = root.getBoundingClientRect()\n      const mode = headerModeFor(box.width)\n      root.dataset.mode = mode\n      html.style.setProperty('--bl-header-height', `${Math.round(box.height)}px`)\n      setMetrics((current) => (current.mode === mode && current.hydrated ? current : { mode, hydrated: true }))\n    }\n    const onScroll = () => {\n      root.dataset.compact = window.scrollY > HEADER_COMPACT_AFTER_SCROLL_PX ? 'true' : 'false'\n    }\n    root.dataset.hydrated = 'true'\n    measure()\n    let observer: ResizeObserver | undefined\n    if (typeof ResizeObserver === 'function') {\n      observer = new ResizeObserver(measure)\n      observer.observe(root)\n    } else {\n      window.addEventListener('resize', measure)\n    }\n    if (compactAfterScroll) {\n      onScroll()\n      window.addEventListener('scroll', onScroll, { passive: true })\n    }\n    return () => {\n      observer?.disconnect()\n      window.removeEventListener('resize', measure)\n      window.removeEventListener('scroll', onScroll)\n      delete root.dataset.compact\n      html.style.removeProperty('--bl-header-height')\n    }\n  }, [rootRef, compactAfterScroll])\n\n  return metrics\n}\n"]}

package/dist/navigation/use-navigation-menu.d.ts

@@ -0,0 +1,39 @@
+/**
+ * F3: the dropdown engine. The WAI-ARIA disclosure navigation pattern with top-level links and separate disclosure
+ * buttons, and the whole v1 §5.6 state table. Timings and rules are constants of the library; a site can't change
+ * them. The engine reads the DOM by hooks only (`data-slot="trigger"` and `data-slot="panel"` with `data-menu-id`),
+ * so the links and panels stay server-rendered.
+ */
+import { type FocusEvent, type KeyboardEvent, type MouseEvent, type PointerEvent, type RefObject } from 'react';
+export type NavigationOpenedBy = 'hover' | 'click' | 'touch' | 'keyboard';
+export interface NavigationMenu {
+    /** The open panel's menu id, or null. One panel is open at a time. */
+    readonly openId: string | null;
+    readonly openedBy: NavigationOpenedBy | null;
+    close(): void;
+    /** Spread on the item (`<li>`): hover intent and Tab out. */
+    itemHandlers(id: string): {
+        onPointerEnter(event: PointerEvent): void;
+        onPointerLeave(event: PointerEvent): void;
+        onPointerDown(event: PointerEvent): void;
+        onBlur(event: FocusEvent<HTMLElement>): void;
+    };
+    /** Spread on the disclosure button: click, Enter and Space toggle; Arrow Down opens and enters the panel. */
+    triggerHandlers(id: string): {
+        onClick(event: MouseEvent<HTMLButtonElement>): void;
+        onKeyDown(event: KeyboardEvent<HTMLButtonElement>): void;
+    };
+    /** Spread on the panel: Arrow Up, Arrow Down, Home and End move between its links; a link click closes. */
+    panelHandlers(id: string): {
+        onKeyDown(event: KeyboardEvent<HTMLElement>): void;
+        onClick(event: MouseEvent<HTMLElement>): void;
+    };
+}
+/**
+ * The menu state for one navigation. `navRef` is the `<nav>`; a change of `resetKey` (route or breakpoint) closes
+ * every panel, as does `popstate`, Escape (focus returns to the chevron), a pointer down outside, Tab out of an item
+ * and a link click. A mouse opens a panel 100 ms after it enters an item and closes it 200 ms after it leaves, even
+ * after a click; the first click on a hover-opened chevron confirms the panel instead of closing it.
+ */
+export declare function useNavigationMenu(navRef: RefObject<HTMLElement | null>, resetKey: unknown): NavigationMenu;
+//# sourceMappingURL=use-navigation-menu.d.ts.map

package/dist/navigation/use-navigation-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-navigation-menu.d.ts","sourceRoot":"","sources":["../../src/navigation/use-navigation-menu.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,OAAO,EAA4C,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAGzJ,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAA;AAezE,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAC5C,KAAK,IAAI,IAAI,CAAA;IACb,6DAA6D;IAC7D,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG;QACxB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;QACzC,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;QACzC,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;QACxC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,IAAI,CAAA;KAC7C,CAAA;IACD,6GAA6G;IAC7G,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG;QAC3B,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;QACnD,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;KACzD,CAAA;IACD,2GAA2G;IAC3G,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG;QACzB,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,IAAI,CAAA;QAClD,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,IAAI,CAAA;KAC9C,CAAA;CACF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,cAAc,CA6K1G"}