@aranova/tracking-react 0.24.1 → 0.26.0

package/dist/index.d.ts

@@ -1,61 +1,12 @@
-import * as react from 'react';
-import { ReactNode, CSSProperties, InputHTMLAttributes, ChangeEvent, FocusEvent } from 'react';
-import { T as TrackingParams, a as TrackingInstallSurface, b as TrackingEnvironment, c as TrackingClientContext, d as TrackingEventCreatePayload, e as TrackingSessionUpsertPayload, F as FormSubmitConfig, f as FormSubmitMetadata, G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, C as ConsentState, g as ConsentChoiceState, h as ConsentSource, P as PhoneConfig, i as ParsedPhone, j as PhoneDisplayFormat } from './phone-utils-B6TYgiYT.js';
-export { k as ConsentChoice, D as DEFAULT_DECLINE_TTL_DAYS, l as DEFAULT_PHONE_COUNTRY, J as JsonValue, S as SetConsentOptions, m as TrackedField, n as TrackingInitConfig, o as formSubmitConfigSchema, p as formSubmitMetadataSchema, q as formatPhone, r as formatPhoneAsTyped, s as getConsentChoice, t as getConsentState, u as jsonValueSchema, v as onConsentChange, w as optIn, x as optOut, y as parsePhone, z as phoneField, A as resetConsent, B as setConsentState, E as toE164 } from './phone-utils-B6TYgiYT.js';
-import { T as TrackingConfigReference, C as ConversionConfig } from './sales-BwWnvl8L.js';
-export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, c as CompareTo, d as ConversionConfigStore, e as ConversionUserData, f as CurrencyRevenue, g as CustomerCurrencyDelta, h as CustomerCurrencyTotal, i as CustomerGetOptions, j as CustomerGetResult, k as CustomerKpis, l as CustomerKpisDeltas, m as CustomerKpisPrevious, n as CustomerListPage, o as CustomerListQuery, p as CustomerProfile, q as CustomerSegment, r as CustomerSegmentCount, s as CustomerSortField, t as CustomerSummary, u as CustomerSummaryQuery, D as DistinctCustomersByCurrency, G as Granularity, N as NAMED_RANGES, v as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, w as Sale, x as SaleCursorPage, y as SaleFilters, z as SaleInput, E as SaleItem, F as SaleItemInput, H as SaleKeysetSortField, I as SaleListPage, J as SaleListQuery, K as SaleListQueryV2, L as SaleService, M as SaleServiceInput, O as SaleSortField, Q as SaleSortOrder, R as SaleSummary, U as SaleSummaryPrevious, V as SaleSummaryQuery, W as SaleSummaryQueryV2, X as SaleSummaryV2, Y as SaleUpdateInput, Z as SalesBusinessClient, _ as SalesCategoryBreakdown, $ as SalesClient, a0 as SalesClientConfig, a1 as SalesCustomersClient, a2 as SalesServiceBreakdown, a3 as SalesTransportConfig, a4 as SalesTrendPoint, a5 as SummaryCurrencyDelta, a6 as SummaryDeltas, a7 as SummaryWindow, a8 as SupportedCurrency, a9 as TRACKING_RANGES, aa as TrackingOverviewRange, ab as clearStashedUserData, ac as createSalesClient, ad as fetchServices, ae as formatDateInTz, af as formatMoney, ag as fromMinor, ah as getTrackingConfigRuntime, ai as resolveConversionConfig, aj as resolveTrackingConfigUrl, ak as saleCreateSchema, al as saleItemSchema, am as saleServiceSchema, an as saleUpdateSchema, ao as salesRequest, ap as stashUserData, aq as toMinor } from './sales-BwWnvl8L.js';
-import * as src from 'src';
-import { z } from 'zod';
-import { CountryCode } from 'libphonenumber-js';
+export { AdPlatformTracking, AdPlatformTrackingProps, ConsentBanner, ConsentBannerProps, CreateTrackingOptions, CreateTrackingResult, GoogleAdsTracking, GoogleAdsTrackingProps, PhoneField, PhoneFieldApi, PhoneFieldProps, PhoneInputProps, TrackingProviderProps, UseConsentResult, UseCookiePreferencesOptions, UseCookiePreferencesResult, UsePhoneFieldOptions, createTracking, useConsent, useConsentState, useCookiePreferences, useGclid, usePhoneConfig, usePhoneField, useTrackingParams } from '@aranova/tracking-react/client';
+import { T as TrackingParams, a as TrackingInstallSurface, b as TrackingEnvironment, c as TrackingClientContext, d as TrackingEventCreatePayload, e as TrackingSessionUpsertPayload } from './phone-utils-BVzSNBf1.js';
+export { C as ConsentChoice, f as ConsentChoiceState, g as ConsentSource, h as ConsentState, D as DEFAULT_DECLINE_TTL_DAYS, i as DEFAULT_PHONE_COUNTRY, F as FormSubmitConfig, j as FormSubmitMetadata, G as GtagEnvironmentMap, J as JsonValue, M as MetaPixelEnvironmentMap, P as ParsedPhone, k as PhoneConfig, l as PhoneDisplayFormat, S as SetConsentOptions, m as TrackedField, n as TrackingInitConfig, o as formSubmitConfigSchema, p as formSubmitMetadataSchema, q as formatPhone, r as formatPhoneAsTyped, s as getConsentChoice, t as getConsentState, u as jsonValueSchema, v as onConsentChange, w as optIn, x as optOut, y as parsePhone, z as phoneField, A as resetConsent, B as setConsentState, E as toE164 } from './phone-utils-BVzSNBf1.js';
+export { A as AranovaApiError, B as BusinessConfig, a as BusinessConfigFeatures, b as BusinessConfigService, C as CompareTo, c as ConversionUserData, d as CurrencyRevenue, e as CustomerCurrencyDelta, f as CustomerCurrencyTotal, g as CustomerGetOptions, h as CustomerGetResult, i as CustomerKpis, j as CustomerKpisDeltas, k as CustomerKpisPrevious, l as CustomerListPage, m as CustomerListQuery, n as CustomerProfile, o as CustomerSegment, p as CustomerSegmentCount, q as CustomerSortField, r as CustomerSummary, s as CustomerSummaryQuery, D as DistinctCustomersByCurrency, E as EffectiveSaleProperty, G as Granularity, N as NAMED_RANGES, t as NamedRange, P as PublicServiceItem, S as SUPPORTED_CURRENCIES, u as Sale, v as SaleBuiltinRequirableField, w as SaleCursorPage, x as SaleFilters, y as SaleInput, z as SaleItem, F as SaleItemInput, H as SaleKeysetSortField, I as SaleListPage, J as SaleListQuery, K as SaleListQueryV2, L as SalePropertyOption, M as SalePropertyType, O as SaleService, Q as SaleServiceInput, R as SaleSortField, T as SaleSortOrder, U as SaleSummary, V as SaleSummaryPrevious, W as SaleSummaryQuery, X as SaleSummaryQueryV2, Y as SaleSummaryV2, Z as SaleUpdateInput, _ as SalesBusinessClient, $ as SalesCategoryBreakdown, a0 as SalesClient, a1 as SalesClientConfig, a2 as SalesCustomersClient, a3 as SalesServiceBreakdown, a4 as SalesTransportConfig, a5 as SalesTrendPoint, a6 as SummaryCurrencyDelta, a7 as SummaryDeltas, a8 as SummaryWindow, a9 as SupportedCurrency, aa as TRACKING_RANGES, ab as TrackingOverviewRange, ac as clearStashedUserData, ad as createSalesClient, ae as fetchServices, af as formatDateInTz, ag as formatMoney, ah as fromMinor, ai as saleCreateSchema, aj as saleItemSchema, ak as saleServiceSchema, al as saleUpdateSchema, am as salesRequest, an as stashUserData, ao as toMinor } from './sales-1J-Z4AvL.js';
+export { C as ConversionConfig, a as ConversionConfigStore, T as TrackingConfigReference, g as getTrackingConfigRuntime, r as resolveConversionConfig, b as resolveTrackingConfigUrl } from './tracking-config-runtime-BnUlS_Ae.js';
+export { A as ALL_AUTOMATIC_EVENT_NAMES, a as ALL_LEAD_EVENT_NAMES, b as ALL_MANUAL_EVENT_NAMES, c as AutomaticEventName, C as CtaClickConfig, d as CtaClickMetadata, E as EVENT_REGISTRY, e as EVENT_SEMANTICS, f as EventCategory, g as EventClientVisibility, h as EventConfig, i as EventKind, j as EventMetadata, k as EventName, l as EventOutcomeRole, m as EventSemantics, F as FormStartConfig, n as FormStartMetadata, M as ManualEventName, o as MultiPageSessionConfig, p as MultiPageSessionMetadata, P as PAGE_IDENTITY_MAX_LENGTH, q as PAGE_IDENTITY_PATTERN, r as PageExitConfig, s as PageExitMetadata, t as PageIdentity, u as PageViewConfig, v as PageViewMetadata, w as PhoneClickConfig, x as PhoneClickMetadata, R as RegisteredAutomaticEvents, y as RegisteredManualEvents, S as SPECIFIC_PAGE_NAMES, z as ScrollDepthConfig, B as ScrollDepthMetadata, D as SdkHeartbeatConfig, G as SdkHeartbeatMetadata, H as SpecificPageName, I as SpecificPageVisitConfig, J as SpecificPageVisitMetadata, T as TimeOnSiteConfig, K as TimeOnSiteMetadata, L as TrackableEvent, N as TriggerRegistryConfig, O as TypedTrackEventOptions, Q as TypedTrackingClient, U as ctaClickConfigSchema, V as ctaClickMetadataSchema, W as formStartConfigSchema, X as formStartMetadataSchema, Y as getEventDefinition, Z as getEventSemantics, _ as multiPageSessionConfigSchema, $ as multiPageSessionMetadataSchema, a0 as pageExitConfigSchema, a1 as pageExitMetadataSchema, a2 as pageIdentitySchema, a3 as pageViewConfigSchema, a4 as pageViewMetadataSchema, a5 as phoneClickConfigSchema, a6 as phoneClickMetadataSchema, a7 as scrollDepthConfigSchema, a8 as scrollDepthMetadataSchema, a9 as sdkHeartbeatConfigSchema, aa as sdkHeartbeatMetadataSchema, ab as sdkHeartbeatTriggersSchema, ac as specificPageNameSchema, ad as specificPageVisitConfigSchema, ae as specificPageVisitMetadataSchema, af as timeOnSiteConfigSchema, ag as timeOnSiteMetadataSchema } from './ingest-typed-C-SPiigr.js';
 export { CountryCode } from 'libphonenumber-js';
-
-/**
- * Legacy opt-in-era consent banner.
- *
- * @deprecated PERMANENTLY INERT since consent v2 (opt-out model): it renders
- * only while consent is `pending`, and the effective state is never `pending`
- * anymore, so this component always returns `null`. Tracking is on by default;
- * replace the banner with a footer "cookie preferences" control built on
- * {@link useCookiePreferences} (see the package README). Kept exported so
- * existing integrations keep compiling; scheduled for removal.
- */
-interface ConsentBannerProps {
-    /** Body text. Defaults to the standard cookies-for-ad-performance message. */
-    message?: ReactNode;
-    /** Optional bold title above the body text. */
-    title?: ReactNode;
-    /** Label for the accept button. Default: `"Accept"`. */
-    acceptLabel?: string;
-    /** Label for the decline button. Default: `"Decline"`. */
-    declineLabel?: string;
-    /** Optional link inline with the message (e.g. to a privacy policy). */
-    policyHref?: string;
-    /** Visible text for {@link policyHref}. Default: `"Learn more"`. */
-    policyLabel?: string;
-    /**
-     * Fires after the consent state is persisted + propagated to gtag. Useful
-     * for emitting your own analytics event on the choice.
-     */
-    onAccept?: () => void;
-    onDecline?: () => void;
-    /** Where the banner docks. Default: `"bottom"`. */
-    position?: "top" | "bottom";
-    /**
-     * Visual theme. `"auto"` follows `prefers-color-scheme`. Default: `"light"`.
-     */
-    theme?: "light" | "dark" | "auto";
-    /** Class added to the outer wrapper for additional styling hooks. */
-    className?: string;
-    /** Inline style overrides applied to the outer wrapper after the defaults. */
-    style?: CSSProperties;
-}
-/**
- * @deprecated Permanently inert since consent v2 — always renders `null`
- * because the effective consent state is never `pending`. Use a footer
- * control built on {@link useCookiePreferences} instead. See
- * {@link ConsentBannerProps} for details.
- */
-declare function ConsentBanner({ message, title, acceptLabel, declineLabel, policyHref, policyLabel, onAccept, onDecline, position, theme, className, style, }?: ConsentBannerProps): ReactNode;
+import 'zod';
+import 'src';
 
 /**
  * Attribution query/cookie keys captured by the SDK.
@@ -110,1322 +61,6 @@ declare function createTrackingSessionUpsertPayload(trackingParams: TrackingPara
  */
 declare function createTrackingEventCreatePayload(trackingParams: TrackingParams, input: TrackingEventInput, context: TrackingClientContext): TrackingEventCreatePayload;
 
-/**
- * Metadata for a manually fired `cta_click` event.
- *
- * Use this for non-phone calls to action such as directions, appointment
- * buttons, downloads, or external booking links.
- */
-declare const ctaClickMetadataSchema: z.ZodObject<{
-    cta_name: z.ZodString;
-    page: z.ZodObject<{
-        path: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        path: string;
-    }, {
-        path: string;
-    }>;
-    section: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    destination_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    href: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    element: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "strict", z.ZodTypeAny, {
-    page: {
-        path: string;
-    };
-    cta_name: string;
-    section?: string | null | undefined;
-    href?: string | null | undefined;
-    destination_url?: string | null | undefined;
-    element?: string | null | undefined;
-}, {
-    page: {
-        path: string;
-    };
-    cta_name: string;
-    section?: string | null | undefined;
-    href?: string | null | undefined;
-    destination_url?: string | null | undefined;
-    element?: string | null | undefined;
-}>;
-type CtaClickMetadata = z.infer<typeof ctaClickMetadataSchema>;
-/**
- * Registration config for `cta_click`.
- *
- * The event stays manually fireable; `autoCapture` additionally attaches a
- * delegated click listener that fires it for any element matching `selector`
- * (default `[data-aranova-cta]`) — tag your CTAs, get analytics for free.
- */
-declare const ctaClickConfigSchema: z.ZodObject<{
-    autoCapture: z.ZodOptional<z.ZodObject<{
-        selector: z.ZodOptional<z.ZodString>;
-    }, "strict", z.ZodTypeAny, {
-        selector?: string | undefined;
-    }, {
-        selector?: string | undefined;
-    }>>;
-}, "strict", z.ZodTypeAny, {
-    autoCapture?: {
-        selector?: string | undefined;
-    } | undefined;
-}, {
-    autoCapture?: {
-        selector?: string | undefined;
-    } | undefined;
-}>;
-type CtaClickConfig = z.infer<typeof ctaClickConfigSchema>;
-
-/**
- * Registered trigger names reported by the SDK heartbeat.
- */
-declare const sdkHeartbeatTriggersSchema: z.ZodObject<{
-    automatic: z.ZodArray<z.ZodString, "many">;
-    manual: z.ZodArray<z.ZodString, "many">;
-}, "strict", z.ZodTypeAny, {
-    automatic: string[];
-    manual: string[];
-}, {
-    automatic: string[];
-    manual: string[];
-}>;
-/**
- * Metadata for the SDK-internal `sdk_heartbeat` event.
- *
- * The SDK fires this once per new session so the dashboard can show which SDK
- * version, install surface, and trigger registry a client site is running.
- * Consumers do not manually register or fire this event.
- */
-declare const sdkHeartbeatMetadataSchema: z.ZodObject<{
-    sdk_version: z.ZodString;
-    package_name: z.ZodNullable<z.ZodString>;
-    surface: z.ZodEnum<["next", "react", "script"]>;
-    triggers: z.ZodObject<{
-        automatic: z.ZodArray<z.ZodString, "many">;
-        manual: z.ZodArray<z.ZodString, "many">;
-    }, "strict", z.ZodTypeAny, {
-        automatic: string[];
-        manual: string[];
-    }, {
-        automatic: string[];
-        manual: string[];
-    }>;
-    trigger_config: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
-    configured_gtag_ids: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-}, "strict", z.ZodTypeAny, {
-    sdk_version: string;
-    package_name: string | null;
-    surface: "next" | "react" | "script";
-    triggers: {
-        automatic: string[];
-        manual: string[];
-    };
-    trigger_config?: Record<string, Record<string, unknown>> | null | undefined;
-    configured_gtag_ids?: Record<string, string> | null | undefined;
-}, {
-    sdk_version: string;
-    package_name: string | null;
-    surface: "next" | "react" | "script";
-    triggers: {
-        automatic: string[];
-        manual: string[];
-    };
-    trigger_config?: Record<string, Record<string, unknown>> | null | undefined;
-    configured_gtag_ids?: Record<string, string> | null | undefined;
-}>;
-type SdkHeartbeatMetadata = z.infer<typeof sdkHeartbeatMetadataSchema>;
-/**
- * Internal registration config for `sdk_heartbeat`.
- *
- * This event has no consumer-facing options.
- */
-declare const sdkHeartbeatConfigSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
-type SdkHeartbeatConfig = z.infer<typeof sdkHeartbeatConfigSchema>;
-
-/**
- * Metadata for the automatic `form_start` event.
- *
- * The SDK emits this once per form when the visitor first focuses a field.
- */
-declare const formStartMetadataSchema: z.ZodObject<{
-    form: z.ZodObject<{
-        id: z.ZodString;
-        action: z.ZodNullable<z.ZodString>;
-    }, "strict", z.ZodTypeAny, {
-        id: string;
-        action: string | null;
-    }, {
-        id: string;
-        action: string | null;
-    }>;
-    page: z.ZodObject<{
-        path: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        path: string;
-    }, {
-        path: string;
-    }>;
-}, "strict", z.ZodTypeAny, {
-    form: {
-        id: string;
-        action: string | null;
-    };
-    page: {
-        path: string;
-    };
-}, {
-    form: {
-        id: string;
-        action: string | null;
-    };
-    page: {
-        path: string;
-    };
-}>;
-type FormStartMetadata = z.infer<typeof formStartMetadataSchema>;
-/**
- * Registration config for automatic `form_start`.
- *
- * Use `selector` to narrow which forms can trigger the event. When omitted,
- * the SDK observes all `<form>` elements.
- */
-declare const formStartConfigSchema: z.ZodObject<{
-    selector: z.ZodOptional<z.ZodString>;
-}, "strict", z.ZodTypeAny, {
-    selector?: string | undefined;
-}, {
-    selector?: string | undefined;
-}>;
-type FormStartConfig = z.infer<typeof formStartConfigSchema>;
-
-/**
- * Metadata for the automatic `multi_page_session` event.
- *
- * Fired when the visitor reaches the configured distinct-page threshold in a
- * single tracking session.
- */
-declare const multiPageSessionMetadataSchema: z.ZodObject<{
-    page_count: z.ZodNumber;
-    page: z.ZodObject<{
-        path: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        path: string;
-    }, {
-        path: string;
-    }>;
-}, "strict", z.ZodTypeAny, {
-    page: {
-        path: string;
-    };
-    page_count: number;
-}, {
-    page: {
-        path: string;
-    };
-    page_count: number;
-}>;
-type MultiPageSessionMetadata = z.infer<typeof multiPageSessionMetadataSchema>;
-/**
- * Registration config for automatic `multi_page_session`.
- */
-declare const multiPageSessionConfigSchema: z.ZodObject<{
-    pageThreshold: z.ZodNumber;
-}, "strict", z.ZodTypeAny, {
-    pageThreshold: number;
-}, {
-    pageThreshold: number;
-}>;
-type MultiPageSessionConfig = z.infer<typeof multiPageSessionConfigSchema>;
-
-/**
- * Metadata for the automatic `page_exit` event.
- *
- * Fired when the user leaves a page (SPA navigation away, tab hidden, or
- * pagehide). `dwell_ms` is the ACTIVE (visible) time spent on the page segment
- * being closed — hidden time never counts, matching `time_on_site` semantics.
- * A page revisited after being hidden emits another `page_exit` for the next
- * visible segment, so summing `dwell_ms` per page/session yields total active
- * dwell without double counting.
- */
-declare const pageExitMetadataSchema: z.ZodObject<{
-    dwell_ms: z.ZodNumber;
-    max_scroll_percent: z.ZodNullable<z.ZodNumber>;
-    scroll_baseline_percent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    page: z.ZodObject<{
-        path: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        path: string;
-    }, {
-        path: string;
-    }>;
-}, "strict", z.ZodTypeAny, {
-    page: {
-        path: string;
-    };
-    dwell_ms: number;
-    max_scroll_percent: number | null;
-    scroll_baseline_percent?: number | null | undefined;
-}, {
-    page: {
-        path: string;
-    };
-    dwell_ms: number;
-    max_scroll_percent: number | null;
-    scroll_baseline_percent?: number | null | undefined;
-}>;
-type PageExitMetadata = z.infer<typeof pageExitMetadataSchema>;
-/**
- * Registration config for automatic `page_exit`.
- *
- * SDK-internal: attached unconditionally (like `sdk_heartbeat`), so there are
- * no registration options.
- */
-declare const pageExitConfigSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
-type PageExitConfig = z.infer<typeof pageExitConfigSchema>;
-
-/**
- * Metadata for the automatic `page_view` event.
- *
- * The SDK emits this on initial load, SPA route changes, and bfcache restores.
- * Consumers do not call `trackEvent('page_view', ...)`; registering
- * `automatic: { page_view: {} }` enables the SDK-owned trigger.
- */
-declare const pageViewMetadataSchema: z.ZodObject<{
-    page: z.ZodObject<{
-        title: z.ZodNullable<z.ZodString>;
-        path: z.ZodString;
-        search: z.ZodString;
-        hash: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        path: string;
-        search: string;
-        title: string | null;
-        hash: string;
-    }, {
-        path: string;
-        search: string;
-        title: string | null;
-        hash: string;
-    }>;
-    referrer: z.ZodNullable<z.ZodString>;
-    viewport: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        w: z.ZodNumber;
-        h: z.ZodNumber;
-    }, "strict", z.ZodTypeAny, {
-        w: number;
-        h: number;
-    }, {
-        w: number;
-        h: number;
-    }>>>;
-}, "strict", z.ZodTypeAny, {
-    page: {
-        path: string;
-        search: string;
-        title: string | null;
-        hash: string;
-    };
-    referrer: string | null;
-    viewport?: {
-        w: number;
-        h: number;
-    } | null | undefined;
-}, {
-    page: {
-        path: string;
-        search: string;
-        title: string | null;
-        hash: string;
-    };
-    referrer: string | null;
-    viewport?: {
-        w: number;
-        h: number;
-    } | null | undefined;
-}>;
-type PageViewMetadata = z.infer<typeof pageViewMetadataSchema>;
-/**
- * Registration config for automatic `page_view`.
- *
- * `page_view` is required in every trigger registry and currently has no
- * options. Use `{ page_view: {} }`.
- */
-declare const pageViewConfigSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
-type PageViewConfig = z.infer<typeof pageViewConfigSchema>;
-
-/**
- * Metadata for a manually fired `phone_click` event.
- *
- * `phone_number` should be the business phone number from the clicked `tel:`
- * link, not a visitor-entered phone number. `section` can distinguish header,
- * footer, hero, or contact-page links.
- */
-declare const phoneClickMetadataSchema: z.ZodObject<{
-    phone_number: z.ZodString;
-    page: z.ZodObject<{
-        path: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        path: string;
-    }, {
-        path: string;
-    }>;
-    section: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "strict", z.ZodTypeAny, {
-    page: {
-        path: string;
-    };
-    phone_number: string;
-    section?: string | null | undefined;
-}, {
-    page: {
-        path: string;
-    };
-    phone_number: string;
-    section?: string | null | undefined;
-}>;
-type PhoneClickMetadata = z.infer<typeof phoneClickMetadataSchema>;
-/**
- * Registration config for `phone_click`.
- *
- * The event stays manually fireable; `autoCapture` additionally attaches a
- * delegated click listener that fires it for any `tel:` link matching
- * `selector` (default `a[href^="tel:"]`) — link your phone number, get the
- * analytics event (and, for a linked phone-click goal, the conversion) for free.
- */
-declare const phoneClickConfigSchema: z.ZodObject<{
-    autoCapture: z.ZodOptional<z.ZodObject<{
-        selector: z.ZodOptional<z.ZodString>;
-    }, "strict", z.ZodTypeAny, {
-        selector?: string | undefined;
-    }, {
-        selector?: string | undefined;
-    }>>;
-}, "strict", z.ZodTypeAny, {
-    autoCapture?: {
-        selector?: string | undefined;
-    } | undefined;
-}, {
-    autoCapture?: {
-        selector?: string | undefined;
-    } | undefined;
-}>;
-type PhoneClickConfig = z.infer<typeof phoneClickConfigSchema>;
-
-/**
- * Metadata for the automatic `scroll_depth` event.
- *
- * Fired once per configured threshold per page.
- */
-declare const scrollDepthMetadataSchema: z.ZodObject<{
-    depth_percent: z.ZodNumber;
-    page: z.ZodObject<{
-        path: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        path: string;
-    }, {
-        path: string;
-    }>;
-}, "strict", z.ZodTypeAny, {
-    page: {
-        path: string;
-    };
-    depth_percent: number;
-}, {
-    page: {
-        path: string;
-    };
-    depth_percent: number;
-}>;
-type ScrollDepthMetadata = z.infer<typeof scrollDepthMetadataSchema>;
-/**
- * Registration config for automatic `scroll_depth`.
- *
- * `thresholds` are integer percentages from 1 to 100.
- */
-declare const scrollDepthConfigSchema: z.ZodObject<{
-    thresholds: z.ZodArray<z.ZodNumber, "many">;
-}, "strict", z.ZodTypeAny, {
-    thresholds: number[];
-}, {
-    thresholds: number[];
-}>;
-type ScrollDepthConfig = z.infer<typeof scrollDepthConfigSchema>;
-
-declare const PAGE_IDENTITY_MAX_LENGTH = 64;
-declare const PAGE_IDENTITY_PATTERN: RegExp;
-/** Common page identities offered as presets by operator tooling. */
-declare const SPECIFIC_PAGE_NAMES: readonly ["contact_page", "about_page", "services_page", "booking_page", "location_page", "pricing_page", "faq_page", "testimonials_page"];
-declare const pageIdentitySchema: z.ZodString;
-type PageIdentity = z.infer<typeof pageIdentitySchema>;
-/** @deprecated Use PageIdentity. Kept as a compatibility alias for existing consumers. */
-type SpecificPageName = PageIdentity;
-/** @deprecated Use pageIdentitySchema. Kept for source compatibility. */
-declare const specificPageNameSchema: z.ZodString;
-/**
- * Metadata for the automatic `specific_page_visit` event.
- *
- * The SDK emits this when the current pathname matches one of the configured
- * named page patterns.
- */
-declare const specificPageVisitMetadataSchema: z.ZodObject<{
-    page_name: z.ZodString;
-    page: z.ZodObject<{
-        path: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        path: string;
-    }, {
-        path: string;
-    }>;
-}, "strict", z.ZodTypeAny, {
-    page: {
-        path: string;
-    };
-    page_name: string;
-}, {
-    page: {
-        path: string;
-    };
-    page_name: string;
-}>;
-type SpecificPageVisitMetadata = z.infer<typeof specificPageVisitMetadataSchema>;
-/**
- * Registration config for automatic `specific_page_visit`.
- *
- * Each page entry pairs a stable, validated identity with a `RegExp` that
- * matches the pathname. The identity can use a preset above or a client-specific
- * lowercase snake-case slug.
- */
-declare const specificPageVisitConfigSchema: z.ZodObject<{
-    pages: z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        pathPattern: z.ZodType<RegExp, z.ZodTypeDef, RegExp>;
-    }, "strict", z.ZodTypeAny, {
-        name: string;
-        pathPattern: RegExp;
-    }, {
-        name: string;
-        pathPattern: RegExp;
-    }>, "many">;
-}, "strict", z.ZodTypeAny, {
-    pages: {
-        name: string;
-        pathPattern: RegExp;
-    }[];
-}, {
-    pages: {
-        name: string;
-        pathPattern: RegExp;
-    }[];
-}>;
-type SpecificPageVisitConfig = z.infer<typeof specificPageVisitConfigSchema>;
-
-/**
- * Metadata for the automatic `time_on_site` event.
- *
- * The SDK starts a visibility-aware timer and fires once when visible
- * engagement crosses the configured threshold.
- */
-declare const timeOnSiteMetadataSchema: z.ZodObject<{
-    duration_ms: z.ZodNumber;
-    page: z.ZodObject<{
-        path: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        path: string;
-    }, {
-        path: string;
-    }>;
-}, "strict", z.ZodTypeAny, {
-    page: {
-        path: string;
-    };
-    duration_ms: number;
-}, {
-    page: {
-        path: string;
-    };
-    duration_ms: number;
-}>;
-type TimeOnSiteMetadata = z.infer<typeof timeOnSiteMetadataSchema>;
-/**
- * Registration config for automatic `time_on_site`.
- */
-declare const timeOnSiteConfigSchema: z.ZodObject<{
-    thresholdSeconds: z.ZodNumber;
-}, "strict", z.ZodTypeAny, {
-    thresholdSeconds: number;
-}, {
-    thresholdSeconds: number;
-}>;
-type TimeOnSiteConfig = z.infer<typeof timeOnSiteConfigSchema>;
-
-type EventOutcomeRole = "lead" | "engagement" | "navigation" | "diagnostic";
-type EventCategory = "page" | "engagement" | "lead" | "commerce" | "system";
-type EventClientVisibility = "simple" | "detailed" | "hidden";
-interface EventSemantics {
-    label: string;
-    category: EventCategory;
-    outcomeRole: EventOutcomeRole;
-    clientVisibility: EventClientVisibility;
-}
-/**
- * Lightweight runtime event metadata. This module intentionally imports no
- * Zod schemas so dashboards and framework adapters can consume it without
- * pulling the validation registry into their bundles.
- */
-declare const EVENT_SEMANTICS: {
-    readonly page_view: {
-        readonly label: "Page view";
-        readonly category: "page";
-        readonly outcomeRole: "navigation";
-        readonly clientVisibility: "simple";
-    };
-    readonly time_on_site: {
-        readonly label: "Time on site";
-        readonly category: "engagement";
-        readonly outcomeRole: "engagement";
-        readonly clientVisibility: "detailed";
-    };
-    readonly specific_page_visit: {
-        readonly label: "Key page visit";
-        readonly category: "engagement";
-        readonly outcomeRole: "engagement";
-        readonly clientVisibility: "detailed";
-    };
-    readonly scroll_depth: {
-        readonly label: "Scroll depth";
-        readonly category: "engagement";
-        readonly outcomeRole: "engagement";
-        readonly clientVisibility: "detailed";
-    };
-    readonly multi_page_session: {
-        readonly label: "Multi-page session";
-        readonly category: "engagement";
-        readonly outcomeRole: "engagement";
-        readonly clientVisibility: "detailed";
-    };
-    readonly form_start: {
-        readonly label: "Form started";
-        readonly category: "engagement";
-        readonly outcomeRole: "engagement";
-        readonly clientVisibility: "simple";
-    };
-    readonly sdk_heartbeat: {
-        readonly label: "SDK heartbeat";
-        readonly category: "system";
-        readonly outcomeRole: "diagnostic";
-        readonly clientVisibility: "hidden";
-    };
-    readonly page_exit: {
-        readonly label: "Page exit";
-        readonly category: "engagement";
-        readonly outcomeRole: "diagnostic";
-        readonly clientVisibility: "detailed";
-    };
-    readonly form_submit: {
-        readonly label: "Form submitted";
-        readonly category: "lead";
-        readonly outcomeRole: "lead";
-        readonly clientVisibility: "simple";
-    };
-    readonly phone_click: {
-        readonly label: "Phone click";
-        readonly category: "lead";
-        readonly outcomeRole: "lead";
-        readonly clientVisibility: "simple";
-    };
-    readonly cta_click: {
-        readonly label: "CTA click";
-        readonly category: "engagement";
-        readonly outcomeRole: "engagement";
-        readonly clientVisibility: "simple";
-    };
-};
-type EventName = keyof typeof EVENT_SEMANTICS;
-declare function getEventSemantics(eventName: string): EventSemantics | null;
-
-type EventKind = "automatic" | "manual";
-declare const EVENT_REGISTRY: {
-    readonly page_view: {
-        readonly kind: "automatic";
-        readonly semantics: {
-            readonly label: "Page view";
-            readonly category: "page";
-            readonly outcomeRole: "navigation";
-            readonly clientVisibility: "simple";
-        };
-        readonly metadataSchema: z.ZodObject<{
-            page: z.ZodObject<{
-                title: z.ZodNullable<z.ZodString>;
-                path: z.ZodString;
-                search: z.ZodString;
-                hash: z.ZodString;
-            }, "strict", z.ZodTypeAny, {
-                path: string;
-                search: string;
-                title: string | null;
-                hash: string;
-            }, {
-                path: string;
-                search: string;
-                title: string | null;
-                hash: string;
-            }>;
-            referrer: z.ZodNullable<z.ZodString>;
-            viewport: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                w: z.ZodNumber;
-                h: z.ZodNumber;
-            }, "strict", z.ZodTypeAny, {
-                w: number;
-                h: number;
-            }, {
-                w: number;
-                h: number;
-            }>>>;
-        }, "strict", z.ZodTypeAny, {
-            page: {
-                path: string;
-                search: string;
-                title: string | null;
-                hash: string;
-            };
-            referrer: string | null;
-            viewport?: {
-                w: number;
-                h: number;
-            } | null | undefined;
-        }, {
-            page: {
-                path: string;
-                search: string;
-                title: string | null;
-                hash: string;
-            };
-            referrer: string | null;
-            viewport?: {
-                w: number;
-                h: number;
-            } | null | undefined;
-        }>;
-        readonly configSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
-    };
-    readonly time_on_site: {
-        readonly kind: "automatic";
-        readonly semantics: {
-            readonly label: "Time on site";
-            readonly category: "engagement";
-            readonly outcomeRole: "engagement";
-            readonly clientVisibility: "detailed";
-        };
-        readonly metadataSchema: z.ZodObject<{
-            duration_ms: z.ZodNumber;
-            page: z.ZodObject<{
-                path: z.ZodString;
-            }, "strict", z.ZodTypeAny, {
-                path: string;
-            }, {
-                path: string;
-            }>;
-        }, "strict", z.ZodTypeAny, {
-            page: {
-                path: string;
-            };
-            duration_ms: number;
-        }, {
-            page: {
-                path: string;
-            };
-            duration_ms: number;
-        }>;
-        readonly configSchema: z.ZodObject<{
-            thresholdSeconds: z.ZodNumber;
-        }, "strict", z.ZodTypeAny, {
-            thresholdSeconds: number;
-        }, {
-            thresholdSeconds: number;
-        }>;
-    };
-    readonly specific_page_visit: {
-        readonly kind: "automatic";
-        readonly semantics: {
-            readonly label: "Key page visit";
-            readonly category: "engagement";
-            readonly outcomeRole: "engagement";
-            readonly clientVisibility: "detailed";
-        };
-        readonly metadataSchema: z.ZodObject<{
-            page_name: z.ZodString;
-            page: z.ZodObject<{
-                path: z.ZodString;
-            }, "strict", z.ZodTypeAny, {
-                path: string;
-            }, {
-                path: string;
-            }>;
-        }, "strict", z.ZodTypeAny, {
-            page: {
-                path: string;
-            };
-            page_name: string;
-        }, {
-            page: {
-                path: string;
-            };
-            page_name: string;
-        }>;
-        readonly configSchema: z.ZodObject<{
-            pages: z.ZodArray<z.ZodObject<{
-                name: z.ZodString;
-                pathPattern: z.ZodType<RegExp, z.ZodTypeDef, RegExp>;
-            }, "strict", z.ZodTypeAny, {
-                name: string;
-                pathPattern: RegExp;
-            }, {
-                name: string;
-                pathPattern: RegExp;
-            }>, "many">;
-        }, "strict", z.ZodTypeAny, {
-            pages: {
-                name: string;
-                pathPattern: RegExp;
-            }[];
-        }, {
-            pages: {
-                name: string;
-                pathPattern: RegExp;
-            }[];
-        }>;
-    };
-    readonly scroll_depth: {
-        readonly kind: "automatic";
-        readonly semantics: {
-            readonly label: "Scroll depth";
-            readonly category: "engagement";
-            readonly outcomeRole: "engagement";
-            readonly clientVisibility: "detailed";
-        };
-        readonly metadataSchema: z.ZodObject<{
-            depth_percent: z.ZodNumber;
-            page: z.ZodObject<{
-                path: z.ZodString;
-            }, "strict", z.ZodTypeAny, {
-                path: string;
-            }, {
-                path: string;
-            }>;
-        }, "strict", z.ZodTypeAny, {
-            page: {
-                path: string;
-            };
-            depth_percent: number;
-        }, {
-            page: {
-                path: string;
-            };
-            depth_percent: number;
-        }>;
-        readonly configSchema: z.ZodObject<{
-            thresholds: z.ZodArray<z.ZodNumber, "many">;
-        }, "strict", z.ZodTypeAny, {
-            thresholds: number[];
-        }, {
-            thresholds: number[];
-        }>;
-    };
-    readonly multi_page_session: {
-        readonly kind: "automatic";
-        readonly semantics: {
-            readonly label: "Multi-page session";
-            readonly category: "engagement";
-            readonly outcomeRole: "engagement";
-            readonly clientVisibility: "detailed";
-        };
-        readonly metadataSchema: z.ZodObject<{
-            page_count: z.ZodNumber;
-            page: z.ZodObject<{
-                path: z.ZodString;
-            }, "strict", z.ZodTypeAny, {
-                path: string;
-            }, {
-                path: string;
-            }>;
-        }, "strict", z.ZodTypeAny, {
-            page: {
-                path: string;
-            };
-            page_count: number;
-        }, {
-            page: {
-                path: string;
-            };
-            page_count: number;
-        }>;
-        readonly configSchema: z.ZodObject<{
-            pageThreshold: z.ZodNumber;
-        }, "strict", z.ZodTypeAny, {
-            pageThreshold: number;
-        }, {
-            pageThreshold: number;
-        }>;
-    };
-    readonly form_start: {
-        readonly kind: "automatic";
-        readonly semantics: {
-            readonly label: "Form started";
-            readonly category: "engagement";
-            readonly outcomeRole: "engagement";
-            readonly clientVisibility: "simple";
-        };
-        readonly metadataSchema: z.ZodObject<{
-            form: z.ZodObject<{
-                id: z.ZodString;
-                action: z.ZodNullable<z.ZodString>;
-            }, "strict", z.ZodTypeAny, {
-                id: string;
-                action: string | null;
-            }, {
-                id: string;
-                action: string | null;
-            }>;
-            page: z.ZodObject<{
-                path: z.ZodString;
-            }, "strict", z.ZodTypeAny, {
-                path: string;
-            }, {
-                path: string;
-            }>;
-        }, "strict", z.ZodTypeAny, {
-            form: {
-                id: string;
-                action: string | null;
-            };
-            page: {
-                path: string;
-            };
-        }, {
-            form: {
-                id: string;
-                action: string | null;
-            };
-            page: {
-                path: string;
-            };
-        }>;
-        readonly configSchema: z.ZodObject<{
-            selector: z.ZodOptional<z.ZodString>;
-        }, "strict", z.ZodTypeAny, {
-            selector?: string | undefined;
-        }, {
-            selector?: string | undefined;
-        }>;
-    };
-    readonly sdk_heartbeat: {
-        readonly kind: "automatic";
-        readonly semantics: {
-            readonly label: "SDK heartbeat";
-            readonly category: "system";
-            readonly outcomeRole: "diagnostic";
-            readonly clientVisibility: "hidden";
-        };
-        readonly metadataSchema: z.ZodObject<{
-            sdk_version: z.ZodString;
-            package_name: z.ZodNullable<z.ZodString>;
-            surface: z.ZodEnum<["next", "react", "script"]>;
-            triggers: z.ZodObject<{
-                automatic: z.ZodArray<z.ZodString, "many">;
-                manual: z.ZodArray<z.ZodString, "many">;
-            }, "strict", z.ZodTypeAny, {
-                automatic: string[];
-                manual: string[];
-            }, {
-                automatic: string[];
-                manual: string[];
-            }>;
-            trigger_config: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
-            configured_gtag_ids: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-        }, "strict", z.ZodTypeAny, {
-            sdk_version: string;
-            package_name: string | null;
-            surface: "next" | "react" | "script";
-            triggers: {
-                automatic: string[];
-                manual: string[];
-            };
-            trigger_config?: Record<string, Record<string, unknown>> | null | undefined;
-            configured_gtag_ids?: Record<string, string> | null | undefined;
-        }, {
-            sdk_version: string;
-            package_name: string | null;
-            surface: "next" | "react" | "script";
-            triggers: {
-                automatic: string[];
-                manual: string[];
-            };
-            trigger_config?: Record<string, Record<string, unknown>> | null | undefined;
-            configured_gtag_ids?: Record<string, string> | null | undefined;
-        }>;
-        readonly configSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
-    };
-    readonly page_exit: {
-        readonly kind: "automatic";
-        readonly semantics: {
-            readonly label: "Page exit";
-            readonly category: "engagement";
-            readonly outcomeRole: "diagnostic";
-            readonly clientVisibility: "detailed";
-        };
-        readonly metadataSchema: z.ZodObject<{
-            dwell_ms: z.ZodNumber;
-            max_scroll_percent: z.ZodNullable<z.ZodNumber>;
-            scroll_baseline_percent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-            page: z.ZodObject<{
-                path: z.ZodString;
-            }, "strict", z.ZodTypeAny, {
-                path: string;
-            }, {
-                path: string;
-            }>;
-        }, "strict", z.ZodTypeAny, {
-            page: {
-                path: string;
-            };
-            dwell_ms: number;
-            max_scroll_percent: number | null;
-            scroll_baseline_percent?: number | null | undefined;
-        }, {
-            page: {
-                path: string;
-            };
-            dwell_ms: number;
-            max_scroll_percent: number | null;
-            scroll_baseline_percent?: number | null | undefined;
-        }>;
-        readonly configSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
-    };
-    readonly form_submit: {
-        readonly kind: "manual";
-        readonly semantics: {
-            readonly label: "Form submitted";
-            readonly category: "lead";
-            readonly outcomeRole: "lead";
-            readonly clientVisibility: "simple";
-        };
-        readonly metadataSchema: z.ZodObject<{
-            form: z.ZodObject<{
-                id: z.ZodString;
-                action: z.ZodNullable<z.ZodString>;
-                fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                    name: z.ZodString;
-                    type: z.ZodString;
-                    label: z.ZodNullable<z.ZodString>;
-                    value: z.ZodType<src.JsonValue, z.ZodTypeDef, src.JsonValue>;
-                }, "strict", z.ZodTypeAny, {
-                    value: src.JsonValue;
-                    type: string;
-                    name: string;
-                    label: string | null;
-                }, {
-                    value: src.JsonValue;
-                    type: string;
-                    name: string;
-                    label: string | null;
-                }>, "many">>;
-            }, "strict", z.ZodTypeAny, {
-                id: string;
-                action: string | null;
-                fields?: {
-                    value: src.JsonValue;
-                    type: string;
-                    name: string;
-                    label: string | null;
-                }[] | undefined;
-            }, {
-                id: string;
-                action: string | null;
-                fields?: {
-                    value: src.JsonValue;
-                    type: string;
-                    name: string;
-                    label: string | null;
-                }[] | undefined;
-            }>;
-            page: z.ZodObject<{
-                path: z.ZodString;
-            }, "strict", z.ZodTypeAny, {
-                path: string;
-            }, {
-                path: string;
-            }>;
-        }, "strict", z.ZodTypeAny, {
-            form: {
-                id: string;
-                action: string | null;
-                fields?: {
-                    value: src.JsonValue;
-                    type: string;
-                    name: string;
-                    label: string | null;
-                }[] | undefined;
-            };
-            page: {
-                path: string;
-            };
-        }, {
-            form: {
-                id: string;
-                action: string | null;
-                fields?: {
-                    value: src.JsonValue;
-                    type: string;
-                    name: string;
-                    label: string | null;
-                }[] | undefined;
-            };
-            page: {
-                path: string;
-            };
-        }>;
-        readonly configSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
-    };
-    readonly phone_click: {
-        readonly kind: "manual";
-        readonly semantics: {
-            readonly label: "Phone click";
-            readonly category: "lead";
-            readonly outcomeRole: "lead";
-            readonly clientVisibility: "simple";
-        };
-        readonly metadataSchema: z.ZodObject<{
-            phone_number: z.ZodString;
-            page: z.ZodObject<{
-                path: z.ZodString;
-            }, "strict", z.ZodTypeAny, {
-                path: string;
-            }, {
-                path: string;
-            }>;
-            section: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        }, "strict", z.ZodTypeAny, {
-            page: {
-                path: string;
-            };
-            phone_number: string;
-            section?: string | null | undefined;
-        }, {
-            page: {
-                path: string;
-            };
-            phone_number: string;
-            section?: string | null | undefined;
-        }>;
-        readonly configSchema: z.ZodObject<{
-            autoCapture: z.ZodOptional<z.ZodObject<{
-                selector: z.ZodOptional<z.ZodString>;
-            }, "strict", z.ZodTypeAny, {
-                selector?: string | undefined;
-            }, {
-                selector?: string | undefined;
-            }>>;
-        }, "strict", z.ZodTypeAny, {
-            autoCapture?: {
-                selector?: string | undefined;
-            } | undefined;
-        }, {
-            autoCapture?: {
-                selector?: string | undefined;
-            } | undefined;
-        }>;
-    };
-    readonly cta_click: {
-        readonly kind: "manual";
-        readonly semantics: {
-            readonly label: "CTA click";
-            readonly category: "engagement";
-            readonly outcomeRole: "engagement";
-            readonly clientVisibility: "simple";
-        };
-        readonly metadataSchema: z.ZodObject<{
-            cta_name: z.ZodString;
-            page: z.ZodObject<{
-                path: z.ZodString;
-            }, "strict", z.ZodTypeAny, {
-                path: string;
-            }, {
-                path: string;
-            }>;
-            section: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            destination_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            href: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            element: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        }, "strict", z.ZodTypeAny, {
-            page: {
-                path: string;
-            };
-            cta_name: string;
-            section?: string | null | undefined;
-            href?: string | null | undefined;
-            destination_url?: string | null | undefined;
-            element?: string | null | undefined;
-        }, {
-            page: {
-                path: string;
-            };
-            cta_name: string;
-            section?: string | null | undefined;
-            href?: string | null | undefined;
-            destination_url?: string | null | undefined;
-            element?: string | null | undefined;
-        }>;
-        readonly configSchema: z.ZodObject<{
-            autoCapture: z.ZodOptional<z.ZodObject<{
-                selector: z.ZodOptional<z.ZodString>;
-            }, "strict", z.ZodTypeAny, {
-                selector?: string | undefined;
-            }, {
-                selector?: string | undefined;
-            }>>;
-        }, "strict", z.ZodTypeAny, {
-            autoCapture?: {
-                selector?: string | undefined;
-            } | undefined;
-        }, {
-            autoCapture?: {
-                selector?: string | undefined;
-            } | undefined;
-        }>;
-    };
-};
-/**
- * Event names that are fired by the SDK when their configured signal occurs.
- *
- * Automatic events are not accepted by the typed `trackEvent()` API.
- */
-type AutomaticEventName = {
-    [K in EventName]: (typeof EVENT_REGISTRY)[K]["kind"] extends "automatic" ? K : never;
-}[EventName];
-/**
- * Event names that consumer code can fire manually after registering them.
- */
-type ManualEventName = {
-    [K in EventName]: (typeof EVENT_REGISTRY)[K]["kind"] extends "manual" ? K : never;
-}[EventName];
-type MetadataByName = {
-    page_view: PageViewMetadata;
-    time_on_site: TimeOnSiteMetadata;
-    specific_page_visit: SpecificPageVisitMetadata;
-    scroll_depth: ScrollDepthMetadata;
-    multi_page_session: MultiPageSessionMetadata;
-    form_start: FormStartMetadata;
-    sdk_heartbeat: SdkHeartbeatMetadata;
-    page_exit: PageExitMetadata;
-    form_submit: FormSubmitMetadata;
-    phone_click: PhoneClickMetadata;
-    cta_click: CtaClickMetadata;
-};
-type ConfigByName = {
-    page_view: PageViewConfig;
-    time_on_site: TimeOnSiteConfig;
-    specific_page_visit: SpecificPageVisitConfig;
-    scroll_depth: ScrollDepthConfig;
-    multi_page_session: MultiPageSessionConfig;
-    form_start: FormStartConfig;
-    sdk_heartbeat: SdkHeartbeatConfig;
-    page_exit: PageExitConfig;
-    form_submit: FormSubmitConfig;
-    phone_click: PhoneClickConfig;
-    cta_click: CtaClickConfig;
-};
-/**
- * Metadata payload type for a specific tracking event.
- *
- * @example
- * ```ts
- * type SubmitMetadata = EventMetadata<'form_submit'>;
- * ```
- */
-type EventMetadata<K extends EventName> = MetadataByName[K];
-/**
- * Trigger registration config type for a specific tracking event.
- */
-type EventConfig<K extends EventName> = ConfigByName[K];
-/**
- * Runtime list of automatic event names.
- */
-declare const ALL_AUTOMATIC_EVENT_NAMES: readonly AutomaticEventName[];
-/**
- * Runtime list of manual event names.
- */
-declare const ALL_MANUAL_EVENT_NAMES: readonly ManualEventName[];
-/**
- * Events that represent a lead/outcome in first-party tracking projections.
- */
-declare const ALL_LEAD_EVENT_NAMES: readonly EventName[];
-/**
- * Trigger registry passed to `createTracking({ triggers })`.
- *
- * `automatic.page_view` is required because every install should capture page
- * views. Other automatic events are opt-in. Manual events must be registered
- * here before the typed client accepts `trackEvent()` calls for them.
- *
- * @example
- * ```ts
- * createTracking({
- *   apiKey,
- *   endpoint,
- *   triggers: {
- *     automatic: {
- *       page_view: {},
- *       time_on_site: { thresholdSeconds: 60 },
- *     },
- *     manual: {
- *       form_submit: {},
- *       phone_click: {},
- *     },
- *   },
- * });
- * ```
- */
-type TriggerRegistryConfig = {
-    automatic: {
-        page_view: EventConfig<"page_view">;
-    } & Partial<{
-        time_on_site: EventConfig<"time_on_site">;
-        specific_page_visit: EventConfig<"specific_page_visit">;
-        scroll_depth: EventConfig<"scroll_depth">;
-        multi_page_session: EventConfig<"multi_page_session">;
-        form_start: EventConfig<"form_start">;
-    }>;
-    manual?: Partial<{
-        form_submit: EventConfig<"form_submit">;
-        phone_click: EventConfig<"phone_click">;
-        cta_click: EventConfig<"cta_click">;
-    }>;
-};
-/**
- * Manual event names registered in a concrete trigger registry.
- *
- * Used by `TypedTrackingClient` so `trackEvent()` only accepts events the
- * consumer explicitly enabled.
- */
-type RegisteredManualEvents<TRegistry extends TriggerRegistryConfig> = Extract<keyof NonNullable<TRegistry["manual"]>, ManualEventName>;
-/**
- * Automatic event names registered in a concrete trigger registry.
- */
-type RegisteredAutomaticEvents<TRegistry extends TriggerRegistryConfig> = Extract<keyof TRegistry["automatic"], AutomaticEventName>;
-/**
- * Discriminated union of valid manual tracking calls for a registry.
- */
-type TrackableEvent<TRegistry extends TriggerRegistryConfig> = {
-    [K in RegisteredManualEvents<TRegistry>]: {
-        eventType: K;
-        metadata: EventMetadata<K>;
-    };
-}[RegisteredManualEvents<TRegistry>];
-declare function getEventDefinition(name: EventName): {
-    kind: EventKind;
-    semantics: EventSemantics;
-    metadataSchema: z.ZodTypeAny;
-    configSchema: z.ZodTypeAny;
-};
-
 /**
  * Input accepted by the low-level stringly-typed client.
  *
@@ -1464,356 +99,4 @@ interface TrackingClient {
     destroy: () => void;
 }
 
-interface TypedTrackEventOptions {
-    /**
-     * Override the page URL associated with this event.
-     *
-     * Omit this for normal browser usage; the SDK captures `window.location.href`.
-     */
-    pageUrl?: string | null;
-    /**
-     * Override the event timestamp.
-     *
-     * Defaults to the time the event is queued. Accepts a `Date` or ISO string.
-     */
-    occurredAt?: Date | string | null;
-}
-/**
- * Typed tracking client returned by `useTracking()`.
- *
- * The accepted event names and metadata shapes are narrowed from the concrete
- * trigger registry supplied to `createTracking()`.
- */
-interface TypedTrackingClient<TRegistry extends TriggerRegistryConfig> {
-    /**
-     * Fire a manually-registered event. The event name must be present in
-     * the registry's `manual` map and the metadata must match that event's
-     * canonical Zod-derived shape.
-     */
-    trackEvent<K extends RegisteredManualEvents<TRegistry>>(eventType: K, metadata: EventMetadata<K>, options?: TypedTrackEventOptions): void;
-    /**
-     * Immediately flush queued events to the ingest endpoint.
-     *
-     * Normal consumers rarely need this because the SDK flushes on a debounce,
-     * when the queue reaches the batch threshold, and on `pagehide`.
-     */
-    flush(): Promise<void>;
-    /**
-     * Return the current rolling session id.
-     */
-    getSessionId(): string;
-    /**
-     * Return the persistent visitor id for this browser profile.
-     */
-    getVisitorId(): string;
-}
-
-/**
- * Props for the combined ad-platform tag loader.
- *
- * Every field is optional and independent: pass the Google fields, the Meta
- * fields, or both. For each platform a labelled `*Ids` map (ALL loaded) takes
- * precedence over the single `*Id` shortcut.
- */
-interface AdPlatformTrackingProps {
-    /** Single Google Ads tag id, e.g. `AW-123456789`. */
-    gtagId?: string;
-    /** Labelled Google Ads tag map — ALL loaded; wins over `gtagId`. */
-    gtagIds?: GtagEnvironmentMap;
-    /** R2-authoritative Google tracking config. When set, static gtagId(s) are ignored. */
-    trackingConfig?: TrackingConfigReference;
-    /** Fire a Google page view from this standalone loader. Leave false when using TrackingProvider. */
-    standalonePageView?: boolean;
-    /** Single Meta Pixel id, e.g. `123456789012345`. */
-    metaPixelId?: string;
-    /** Labelled Meta Pixel map — ALL loaded; wins over `metaPixelId`. */
-    metaPixelIds?: MetaPixelEnvironmentMap;
-}
-/**
- * Client component that loads the configured ad-platform tags — the Google tag
- * (`gtag`) and/or the Meta Pixel (`fbq`) — each with the visitor's effective
- * consent applied as the default (opt-out model). One mount handles both
- * platforms; omit a platform's props to skip it. Renders nothing.
- *
- * On React you usually don't need this at all — `<TrackingProvider>` already
- * accepts the same `gtagId/gtagIds` + `metaPixelId/metaPixelIds` props. Use this
- * standalone component when you want the ad tags WITHOUT the event-ingest SDK.
- */
-declare function AdPlatformTracking({ gtagId, gtagIds, trackingConfig, standalonePageView, metaPixelId, metaPixelIds, }: AdPlatformTrackingProps): null;
-
-/**
- * Props for the Google Ads tracking component.
- *
- * Accepts either a single `gtagId` (legacy) or a labelled `gtagIds` map
- * where ALL entries are loaded simultaneously via `gtag('config', ...)`.
- */
-type GoogleAdsTrackingProps = {
-    gtagId: string;
-    gtagIds?: undefined;
-} | {
-    gtagId?: undefined;
-    gtagIds: GtagEnvironmentMap;
-};
-/**
- * Client component that loads Google Ads gtag with the visitor's effective
- * consent applied as the Consent Mode default (opt-out model — granted unless
- * an unexpired stored decline exists).
- *
- * Render once near the application root when the client site runs paid Google
- * Ads. The component renders nothing.
- */
-declare function GoogleAdsTracking(props: GoogleAdsTrackingProps): null;
-
-/**
- * Read the captured Google Ads click id from first-party cookies.
- *
- * Returns `null` during SSR and before the client has mounted.
- */
-declare function useGclid(): string | null;
-/**
- * Read all captured attribution parameters from first-party cookies.
- *
- * Values are loaded after mount, so the initial render returns all `null`s.
- */
-declare function useTrackingParams(): TrackingParams;
-/** Options for {@link useCookiePreferences}. */
-interface UseCookiePreferencesOptions {
-    /** Days an explicit decline is honored. Defaults to 90. */
-    declineTtlDays?: number;
-}
-/**
- * The headless cookie-preferences surface returned by
- * {@link useCookiePreferences}.
- */
-interface UseCookiePreferencesResult {
-    /** Effective consent — `granted` unless an unexpired explicit decline exists. */
-    state: ConsentChoiceState;
-    /** `default` = no valid explicit choice stored; `explicit` = visitor chose. */
-    source: ConsentSource;
-    /** True when the visitor has made no (valid, unexpired) explicit choice. */
-    isDefault: boolean;
-    isGranted: boolean;
-    isDenied: boolean;
-    /** ISO timestamp of the explicit choice; null for the default state. */
-    updatedAt: string | null;
-    /** ISO expiry of an unexpired decline; null otherwise. */
-    expiresAt: string | null;
-    /** Explicitly opt out of ad tracking (honored for 90 days by default). */
-    optOut: () => void;
-    /** Explicitly opt in (never expires). */
-    optIn: () => void;
-    /** Clear the explicit choice — back to default-granted. */
-    reset: () => void;
-}
-/**
- * Headless cookie-preferences hook for the opt-out consent model (consent v2).
- *
- * Tracking is ON by default; this hook is how each client site wires its own
- * footer "Cookie preferences" control (button, dialog, toggle — the packages
- * ship no consent UI). State stays in sync with actions from other components
- * in the same tab (via `onConsentChange`) and other tabs (via `storage`
- * events).
- *
- * ```tsx
- * function CookiePreferences() {
- *   const { isDenied, optOut, optIn } = useCookiePreferences();
- *   return isDenied ? (
- *     <button onClick={optIn}>Enable ad measurement</button>
- *   ) : (
- *     <button onClick={optOut}>Opt out of ad measurement</button>
- *   );
- * }
- * ```
- */
-declare function useCookiePreferences(options?: UseCookiePreferencesOptions): UseCookiePreferencesResult;
-/**
- * Read the current visitor consent state.
- *
- * @deprecated Since consent v2 (opt-out model) the state is never `pending`.
- * Use {@link useCookiePreferences} — it exposes the effective state plus
- * `source` so you can tell a default grant from an explicit one.
- */
-declare function useConsentState(): ConsentState;
-/**
- * Result shape of the deprecated {@link useConsent} hook.
- *
- * @deprecated Use {@link UseCookiePreferencesResult} via
- * {@link useCookiePreferences}. `isPending` is always `false` since consent v2.
- */
-interface UseConsentResult {
-    state: ConsentState;
-    isPending: boolean;
-    isGranted: boolean;
-    isDenied: boolean;
-    accept: () => void;
-    decline: () => void;
-    reset: () => void;
-}
-/**
- * Legacy opt-in-era consent hook.
- *
- * @deprecated Since consent v2 tracking defaults ON (opt-out model): the state
- * is never `pending`, so banner UIs gated on `isPending` never render. Use
- * {@link useCookiePreferences} for footer "cookie preferences" controls.
- * `accept` / `decline` still work and map to `optIn` / `optOut`.
- */
-declare function useConsent(): UseConsentResult;
-
-interface CreateTrackingOptions<TRegistry extends TriggerRegistryConfig> {
-    /**
-     * Public tracking API key issued for this business.
-     *
-     * This key is safe to expose in browser code. Abuse is bounded by the
-     * server-side origin allowlist and rate limits.
-     */
-    apiKey: string;
-    /**
-     * Tracking endpoint base URL, usually ending in `/tracking`.
-     *
-     * The client posts events to `${endpoint}/events`.
-     */
-    endpoint: string;
-    /**
-     * Trigger registry. Determines which events the SDK fires automatically
-     * and which ones the consumer can fire manually via `trackEvent()`.
-     * `automatic.page_view` is required — every tracking install needs it.
-     */
-    triggers: TRegistry;
-    /**
-     * Deployment environment label reported in session context.
-     *
-     * Does not affect which gtag IDs are loaded — all configured IDs are
-     * loaded simultaneously. This value is purely for event tagging so the
-     * dashboard can filter by environment.
-     */
-    environment?: TrackingEnvironment;
-    /**
-     * When true, the typed client validates every `trackEvent()` metadata
-     * payload through the Zod schema before forwarding. Errors are thrown
-     * loudly. Leave off in prod; turn on in dev to catch shape bugs early.
-     */
-    debug?: boolean;
-    /**
-     * Phone-field display + default-country config, read by `usePhoneField` /
-     * `<PhoneField>`. Display is customizable; the transmitted value is always E.164.
-     */
-    phone?: PhoneConfig;
-    /**
-     * GAP28 / unified-goal: enable real-time on-site conversion firing. When set, the SDK
-     * fetches the per-business config from `cdnUrl` (optional offline `baked` fallback) and
-     * AUTOMATICALLY fires `gtag('event','conversion')` for any automatic event-goal
-     * (scroll/time/page-view/…) whose trigger threshold a detector crosses. Omit to keep events
-     * analytics-only. (Sale + manual-event firing lives in the server/browser sales client.)
-     */
-    conversionConfig?: {
-        cdnUrl: string;
-        baked?: ConversionConfig | null;
-    };
-    /**
-     * R2-authoritative config reference — `ARANOVA_TRACKING_CONFIG` from
-     * `tracking-cli gen`. Wins over `conversionConfig`. The object URL is composed
-     * from `businessId` + `environment` against the production CDN; spread in a
-     * `cdnBaseUrl` to read it from somewhere else, e.g.
-     * `{ ...ARANOVA_TRACKING_CONFIG, cdnBaseUrl: import.meta.env.VITE_ARANOVA_CDN_BASE_URL }`.
-     */
-    trackingConfig?: TrackingConfigReference;
-}
-interface TrackingProviderProps {
-    /**
-     * Optional Google Ads tag id, for example `AW-123456789`.
-     *
-     * If omitted and `gtagIds` is also omitted, no gtag script is loaded.
-     */
-    gtagId?: string;
-    /**
-     * Labelled map of Google Ads tag IDs. ALL are loaded simultaneously.
-     * When provided, `gtagId` is ignored.
-     */
-    gtagIds?: GtagEnvironmentMap;
-    /** Optional Meta Pixel id, for example `123456789012345`. */
-    metaPixelId?: string;
-    /**
-     * Labelled map of Meta Pixel IDs. ALL are loaded simultaneously.
-     * When provided, `metaPixelId` is ignored.
-     */
-    metaPixelIds?: MetaPixelEnvironmentMap;
-    /**
-     * Application tree that should have access to the scoped tracking client.
-     */
-    children: ReactNode;
-}
-interface CreateTrackingResult<TRegistry extends TriggerRegistryConfig> {
-    /**
-     * Provider component that initializes the page-level tracking client.
-     *
-     * Mount this once near the root of the React tree.
-     */
-    TrackingProvider: (props: TrackingProviderProps) => ReactNode;
-    /**
-     * Hook that returns the registry-typed tracking client.
-     *
-     * Import this hook from your local tracking module, not directly from the
-     * package root, so TypeScript preserves your trigger registry.
-     */
-    useTracking: () => TypedTrackingClient<TRegistry>;
-}
-declare function createTracking<TRegistry extends TriggerRegistryConfig>(options: CreateTrackingOptions<TRegistry>): CreateTrackingResult<TRegistry>;
-
-/** Resolve the effective phone config (provider value or built-in defaults). */
-declare function usePhoneConfig(): {
-    defaultCountry: CountryCode;
-    display: PhoneDisplayFormat;
-};
-interface UsePhoneFieldOptions {
-    defaultValue?: string;
-    /** Overrides the provider's `defaultCountry`. */
-    country?: CountryCode;
-    /** Overrides the provider's `display` (applied to the settled value on blur). */
-    display?: PhoneDisplayFormat;
-    /** Notified with the canonical E.164 (or `null`) on every change. */
-    onValueChange?: (e164: string | null) => void;
-}
-interface PhoneInputProps {
-    value: string;
-    onChange: (event: ChangeEvent<HTMLInputElement>) => void;
-    onBlur: (event: FocusEvent<HTMLInputElement>) => void;
-    type: "tel";
-    inputMode: "tel";
-    autoComplete: "tel";
-}
-interface PhoneFieldApi {
-    /** Display value for the `<input>` (live `AsYouType` while typing). */
-    value: string;
-    /** Canonical E.164 — what gets transmitted. `null` while invalid/incomplete. */
-    e164: string | null;
-    isValid: boolean;
-    /** Validation message, surfaced only after blur with non-empty invalid input. */
-    error: string | null;
-    parsed: ParsedPhone;
-    /** Spread onto an `<input>`: pre-wires value/onChange/onBlur/type/inputMode/autoComplete. */
-    inputProps: PhoneInputProps;
-}
-/** Headless phone field — the client owns the markup. */
-declare function usePhoneField(opts?: UsePhoneFieldOptions): PhoneFieldApi;
-interface PhoneFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "value" | "onChange"> {
-    country?: CountryCode;
-    /** Controlled display value. */
-    value?: string;
-    /** Uncontrolled initial value. */
-    defaultValue?: string;
-    /** Receives the native change event (RHF `register().onChange` or your own); the
-     *  event's `target.value` is already `AsYouType`-formatted. */
-    onChange?: (event: ChangeEvent<HTMLInputElement>) => void;
-    /** Receives the canonical E.164 (or `null`) on every change. */
-    onE164Change?: (e164: string | null) => void;
-}
-/**
- * Batteries-included phone input. Composes identically with react-hook-form
- * `{...register('phone')}` and with controlled state — the `AsYouType` +
- * mutate-`e.target.value`-before-`onChange` technique lives inside, so RHF and
- * controlled parents both receive the formatted value, and the wire value stays
- * E.164.
- */
-declare const PhoneField: react.ForwardRefExoticComponent<PhoneFieldProps & react.RefAttributes<HTMLInputElement>>;
-
-export { ALL_AUTOMATIC_EVENT_NAMES, ALL_LEAD_EVENT_NAMES, ALL_MANUAL_EVENT_NAMES, AdPlatformTracking, type AdPlatformTrackingProps, type AutomaticEventName, ConsentBanner, type ConsentBannerProps, ConsentChoiceState, ConsentSource, ConsentState, ConversionConfig, type CreateTrackingOptions, type CreateTrackingResult, type CtaClickConfig, type CtaClickMetadata, EVENT_REGISTRY, EVENT_SEMANTICS, type EventCategory, type EventClientVisibility, type EventConfig, type EventKind, type EventMetadata, type EventName, type EventOutcomeRole, type EventSemantics, type FormStartConfig, type FormStartMetadata, FormSubmitConfig, FormSubmitMetadata, GoogleAdsTracking, type GoogleAdsTrackingProps, GtagEnvironmentMap, type ManualEventName, MetaPixelEnvironmentMap, type MultiPageSessionConfig, type MultiPageSessionMetadata, PAGE_IDENTITY_MAX_LENGTH, PAGE_IDENTITY_PATTERN, type PageExitConfig, type PageExitMetadata, type PageIdentity, type PageViewConfig, type PageViewMetadata, ParsedPhone, type PhoneClickConfig, type PhoneClickMetadata, PhoneConfig, PhoneDisplayFormat, PhoneField, type PhoneFieldApi, type PhoneFieldProps, type PhoneInputProps, type RegisteredAutomaticEvents, type RegisteredManualEvents, SPECIFIC_PAGE_NAMES, type ScrollDepthConfig, type ScrollDepthMetadata, type SdkHeartbeatConfig, type SdkHeartbeatMetadata, type SpecificPageName, type SpecificPageVisitConfig, type SpecificPageVisitMetadata, TRACKING_PARAM_KEYS, type TimeOnSiteConfig, type TimeOnSiteMetadata, type TrackableEvent, type TrackingClient, TrackingClientContext, TrackingConfigReference, TrackingEventCreatePayload, TrackingInstallSurface, TrackingParams, type TrackingProviderProps, TrackingSessionUpsertPayload, type TriggerRegistryConfig, type TypedTrackEventOptions, type TypedTrackingClient, type UseConsentResult, type UseCookiePreferencesOptions, type UseCookiePreferencesResult, type UsePhoneFieldOptions, captureTrackingParamsFromLocation, createTracking, createTrackingClientContext, createTrackingEventCreatePayload, createTrackingSessionUpsertPayload, ctaClickConfigSchema, ctaClickMetadataSchema, formStartConfigSchema, formStartMetadataSchema, getEventDefinition, getEventSemantics, multiPageSessionConfigSchema, multiPageSessionMetadataSchema, pageExitConfigSchema, pageExitMetadataSchema, pageIdentitySchema, pageViewConfigSchema, pageViewMetadataSchema, phoneClickConfigSchema, phoneClickMetadataSchema, scrollDepthConfigSchema, scrollDepthMetadataSchema, sdkHeartbeatConfigSchema, sdkHeartbeatMetadataSchema, sdkHeartbeatTriggersSchema, specificPageNameSchema, specificPageVisitConfigSchema, specificPageVisitMetadataSchema, timeOnSiteConfigSchema, timeOnSiteMetadataSchema, useConsent, useConsentState, useCookiePreferences, useGclid, usePhoneConfig, usePhoneField, useTrackingParams };
+export { TRACKING_PARAM_KEYS, type TrackingClient, TrackingClientContext, TrackingEventCreatePayload, TrackingInstallSurface, TrackingParams, TrackingSessionUpsertPayload, captureTrackingParamsFromLocation, createTrackingClientContext, createTrackingEventCreatePayload, createTrackingSessionUpsertPayload };