@aranova/tracking-react 1.13.0 → 1.14.1

package/dist/{ingest-typed-sCDoPInT.d.ts → ingest-typed-BO6Arbw-.d.mts}

@@ -1,103 +1,6 @@
-import { p as BookingDayWindows, h as BookingMode, q as ConversionIntegrations } from './bookings-C1HMPjQl.js';
 import * as zod_v4_core from 'zod/v4/core';
 import * as z from 'zod/mini';
-import { J as JsonValue, F as FormSubmitConfig, a as FormSubmitMetadata } from './form-submit-CX-CxJjQ.js';
-import './phone-utils-D12FW8tT.js';
-
-type BookingProvider = "autoleap";
-/** One service choice on the booking form, by the site's own key. */
-interface BookingOption {
-    key: string;
-    label: string;
-    /** The shop's service category, for a heading over its choices; null when it has none. */
-    group: string | null;
-    /** Optional helper text to show under the label. */
-    description: string | null;
-}
-/** One heading on the form and the choices under it; `group` null holds the ungrouped ones. */
-interface BookingOptionGroup {
-    group: string | null;
-    options: BookingOption[];
-}
-/** The booking rules in camelCase, all in the shop's wall time. */
-interface BookingRules {
-    minDaysAhead: number;
-    maxDaysAhead: number;
-    /** Start hours per weekday, `monday` … `sunday`; both lists empty = closed. */
-    hours: Record<string, BookingDayWindows>;
-    /** `YYYY-MM-DD` shop dates with no bookings although the weekday is open. */
-    closedDates: string[];
-    /** `YYYY-MM-DD` shop dates whose start hours replace their weekday's. */
-    specialHours: Record<string, BookingDayWindows>;
-    vehicleRequired: boolean;
-    /** The vehicle may come after booking: send it with `bookings.updateBooking`. */
-    vehicleDeferred: boolean;
-    /** `waitForIt` / `dropOff`; empty when the shop hides the question. */
-    dropOffOptions: string[];
-}
-interface BookingIntegration {
-    provider: BookingProvider;
-    /** False: render only the handoff link. Never block the customer on it. */
-    enabled: boolean;
-    /** The shop's own booking page. */
-    fallbackUrl: string;
-    /** True when the site may post a booking: `enabled`, rules captured and options mapped. */
-    acceptsBookings: boolean;
-    /** The shop's IANA timezone; every date and hour here is its wall time. */
-    timezone: string;
-    /** Sent back with each booking; a stale one is refused and the config refetched. */
-    configVersion: number | null;
-    rules: BookingRules | null;
-    options: BookingOption[];
-    /**
-     * Where a booking from this page goes: `live` in production; on a development config `test`
-     * (the shop's test lead source) or `simulated` (never sent). Show a banner when not `live`.
-     */
-    mode: BookingMode;
-}
-/** What the visitor already typed, carried onto the shop's booking page. */
-interface BookingHandoffPrefill {
-    /** A single full-name field; split on the first space when `firstName` is not given. */
-    name?: string | null;
-    firstName?: string | null;
-    lastName?: string | null;
-    /** Any format; sent as national digits (no country code), as the shop's portal stores it. */
-    phone?: string | null;
-    email?: string | null;
-}
-/** The enabled-or-fallback booking provider in a config's integrations, if any. */
-declare function getBookingIntegration(integrations: ConversionIntegrations | null | undefined): BookingIntegration | null;
-/** One bookable day: its start hours split as the shop's portal shows them. */
-interface BookableDay {
-    /** `YYYY-MM-DD`, shop-local. */
-    date: string;
-    /** `monday` … `sunday`. */
-    weekday: string;
-    /** Start hours before noon (8 = 08:00). */
-    morning: number[];
-    /** Start hours from noon on. */
-    afternoon: number[];
-}
-/** Today's date in `timeZone` as `YYYY-MM-DD`; the server judges notice by the same date. */
-declare function shopToday(timeZone: string, now?: Date): string;
-/**
- * Every day a customer may book, from the minimum notice to the end of the window, with its
- * start hours. Exactly what the server accepts: closed dates removed, special hours applied.
- */
-declare function bookableSlots(rules: BookingRules, { timeZone, now }: {
-    timeZone: string;
-    now?: Date;
-}): BookableDay[];
-/**
- * The handoff URL with the visitor's details prefilled, or null when `fallbackUrl` is not an
- * https link on the shop's booking host (a config value never becomes an arbitrary redirect).
- */
-declare function buildBookingHandoffUrl(fallbackUrl: string, prefill?: BookingHandoffPrefill): string | null;
-/**
- * The options as headed sections, in published order: one per category, choices in order
- * under it. The API saves them grouped, so a category is never split; this keeps the first run.
- */
-declare function groupBookingOptions(options: readonly BookingOption[]): BookingOptionGroup[];
+import { J as JsonValue, j as FormSubmitConfig, k as FormSubmitMetadata } from './phone-utils-CYr6AmEP.mjs';
 
 /**
  * Metadata for a manually fired `cta_click` event.
@@ -779,6 +682,10 @@ declare const EVENT_REGISTRY: {
                     label: z.ZodMiniString<string>;
                     value: z.ZodMiniType<JsonValue, unknown, zod_v4_core.$ZodTypeInternals<JsonValue, unknown>>;
                 }, zod_v4_core.$strict>>>>;
+                contract_violations: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniArray<z.ZodMiniObject<{
+                    role: z.ZodMiniNullable<z.ZodMiniString<string>>;
+                    rule: z.ZodMiniString<string>;
+                }, zod_v4_core.$strict>>>>;
             }, zod_v4_core.$strict>;
             page: z.ZodMiniObject<{
                 path: z.ZodMiniString<string>;
@@ -1026,4 +933,4 @@ interface TypedTrackingClient<TRegistry extends TriggerRegistryConfig> {
     getVisitorId(): string;
 }
 
-export { buildBookingHandoffUrl as $, type AutomaticEventName as A, type BookableDay as B, type CtaClickConfig as C, type RegisteredManualEvents as D, EVENT_SEMANTICS as E, type FormStartConfig as F, type ScrollDepthMetadata as G, type SdkHeartbeatConfig as H, type SdkHeartbeatMetadata as I, type SiteLinkArrivalConfig as J, type SiteLinkArrivalMetadata as K, type SiteLinkClickConfig as L, type ManualEventName as M, type SiteLinkClickMetadata as N, type SpecificPageName as O, type PageExitConfig as P, type SpecificPageVisitConfig as Q, type RegisteredAutomaticEvents as R, type ScrollDepthConfig as S, type SpecificPageVisitMetadata as T, type TimeOnSiteConfig as U, type TimeOnSiteMetadata as V, type TrackableEvent as W, type TriggerRegistryConfig as X, type TypedTrackEventOptions as Y, type TypedTrackingClient as Z, bookableSlots as _, type BookingHandoffPrefill as a, getBookingIntegration as a0, getEventSemantics as a1, groupBookingOptions as a2, shopToday as a3, type BookingIntegration as b, type BookingOption as c, type BookingOptionGroup as d, type BookingProvider as e, type BookingRules as f, type CtaClickMetadata as g, type EventCategory as h, type EventClientVisibility as i, type EventConfig as j, type EventKind as k, type EventMetadata as l, type EventName as m, type EventOutcomeRole as n, type EventSemantics as o, type FormStartMetadata as p, type FormStepConfig as q, type FormStepMetadata as r, type MultiPageSessionConfig as s, type MultiPageSessionMetadata as t, type PageExitMetadata as u, type PageIdentity as v, type PageViewConfig as w, type PageViewMetadata as x, type PhoneClickConfig as y, type PhoneClickMetadata as z };
+export { type AutomaticEventName as A, type SiteLinkClickConfig as B, type CtaClickConfig as C, type SiteLinkClickMetadata as D, EVENT_SEMANTICS as E, type FormStartConfig as F, type SpecificPageName as G, type SpecificPageVisitConfig as H, type SpecificPageVisitMetadata as I, type TimeOnSiteMetadata as J, type TrackableEvent as K, type TriggerRegistryConfig as L, type ManualEventName as M, type TypedTrackEventOptions as N, type TypedTrackingClient as O, type PageExitConfig as P, getEventSemantics as Q, type RegisteredAutomaticEvents as R, type ScrollDepthConfig as S, type TimeOnSiteConfig as T, type CtaClickMetadata as a, type EventCategory as b, type EventClientVisibility as c, type EventConfig as d, type EventKind as e, type EventMetadata as f, type EventName as g, type EventOutcomeRole as h, type EventSemantics as i, type FormStartMetadata as j, type FormStepConfig as k, type FormStepMetadata as l, type MultiPageSessionConfig as m, type MultiPageSessionMetadata as n, type PageExitMetadata as o, type PageIdentity as p, type PageViewConfig as q, type PageViewMetadata as r, type PhoneClickConfig as s, type PhoneClickMetadata as t, type RegisteredManualEvents as u, type ScrollDepthMetadata as v, type SdkHeartbeatConfig as w, type SdkHeartbeatMetadata as x, type SiteLinkArrivalConfig as y, type SiteLinkArrivalMetadata as z };

package/dist/{ingest-typed-Ckt4R731.d.mts → ingest-typed-D7I4aQ7p.d.ts}

@@ -1,103 +1,6 @@
-import { p as BookingDayWindows, h as BookingMode, q as ConversionIntegrations } from './bookings-CHpplXU7.mjs';
 import * as zod_v4_core from 'zod/v4/core';
 import * as z from 'zod/mini';
-import { J as JsonValue, F as FormSubmitConfig, a as FormSubmitMetadata } from './form-submit-CX-CxJjQ.mjs';
-import './phone-utils-BNiSqeF7.mjs';
-
-type BookingProvider = "autoleap";
-/** One service choice on the booking form, by the site's own key. */
-interface BookingOption {
-    key: string;
-    label: string;
-    /** The shop's service category, for a heading over its choices; null when it has none. */
-    group: string | null;
-    /** Optional helper text to show under the label. */
-    description: string | null;
-}
-/** One heading on the form and the choices under it; `group` null holds the ungrouped ones. */
-interface BookingOptionGroup {
-    group: string | null;
-    options: BookingOption[];
-}
-/** The booking rules in camelCase, all in the shop's wall time. */
-interface BookingRules {
-    minDaysAhead: number;
-    maxDaysAhead: number;
-    /** Start hours per weekday, `monday` … `sunday`; both lists empty = closed. */
-    hours: Record<string, BookingDayWindows>;
-    /** `YYYY-MM-DD` shop dates with no bookings although the weekday is open. */
-    closedDates: string[];
-    /** `YYYY-MM-DD` shop dates whose start hours replace their weekday's. */
-    specialHours: Record<string, BookingDayWindows>;
-    vehicleRequired: boolean;
-    /** The vehicle may come after booking: send it with `bookings.updateBooking`. */
-    vehicleDeferred: boolean;
-    /** `waitForIt` / `dropOff`; empty when the shop hides the question. */
-    dropOffOptions: string[];
-}
-interface BookingIntegration {
-    provider: BookingProvider;
-    /** False: render only the handoff link. Never block the customer on it. */
-    enabled: boolean;
-    /** The shop's own booking page. */
-    fallbackUrl: string;
-    /** True when the site may post a booking: `enabled`, rules captured and options mapped. */
-    acceptsBookings: boolean;
-    /** The shop's IANA timezone; every date and hour here is its wall time. */
-    timezone: string;
-    /** Sent back with each booking; a stale one is refused and the config refetched. */
-    configVersion: number | null;
-    rules: BookingRules | null;
-    options: BookingOption[];
-    /**
-     * Where a booking from this page goes: `live` in production; on a development config `test`
-     * (the shop's test lead source) or `simulated` (never sent). Show a banner when not `live`.
-     */
-    mode: BookingMode;
-}
-/** What the visitor already typed, carried onto the shop's booking page. */
-interface BookingHandoffPrefill {
-    /** A single full-name field; split on the first space when `firstName` is not given. */
-    name?: string | null;
-    firstName?: string | null;
-    lastName?: string | null;
-    /** Any format; sent as national digits (no country code), as the shop's portal stores it. */
-    phone?: string | null;
-    email?: string | null;
-}
-/** The enabled-or-fallback booking provider in a config's integrations, if any. */
-declare function getBookingIntegration(integrations: ConversionIntegrations | null | undefined): BookingIntegration | null;
-/** One bookable day: its start hours split as the shop's portal shows them. */
-interface BookableDay {
-    /** `YYYY-MM-DD`, shop-local. */
-    date: string;
-    /** `monday` … `sunday`. */
-    weekday: string;
-    /** Start hours before noon (8 = 08:00). */
-    morning: number[];
-    /** Start hours from noon on. */
-    afternoon: number[];
-}
-/** Today's date in `timeZone` as `YYYY-MM-DD`; the server judges notice by the same date. */
-declare function shopToday(timeZone: string, now?: Date): string;
-/**
- * Every day a customer may book, from the minimum notice to the end of the window, with its
- * start hours. Exactly what the server accepts: closed dates removed, special hours applied.
- */
-declare function bookableSlots(rules: BookingRules, { timeZone, now }: {
-    timeZone: string;
-    now?: Date;
-}): BookableDay[];
-/**
- * The handoff URL with the visitor's details prefilled, or null when `fallbackUrl` is not an
- * https link on the shop's booking host (a config value never becomes an arbitrary redirect).
- */
-declare function buildBookingHandoffUrl(fallbackUrl: string, prefill?: BookingHandoffPrefill): string | null;
-/**
- * The options as headed sections, in published order: one per category, choices in order
- * under it. The API saves them grouped, so a category is never split; this keeps the first run.
- */
-declare function groupBookingOptions(options: readonly BookingOption[]): BookingOptionGroup[];
+import { J as JsonValue, j as FormSubmitConfig, k as FormSubmitMetadata } from './phone-utils-CYr6AmEP.js';
 
 /**
  * Metadata for a manually fired `cta_click` event.
@@ -779,6 +682,10 @@ declare const EVENT_REGISTRY: {
                     label: z.ZodMiniString<string>;
                     value: z.ZodMiniType<JsonValue, unknown, zod_v4_core.$ZodTypeInternals<JsonValue, unknown>>;
                 }, zod_v4_core.$strict>>>>;
+                contract_violations: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniArray<z.ZodMiniObject<{
+                    role: z.ZodMiniNullable<z.ZodMiniString<string>>;
+                    rule: z.ZodMiniString<string>;
+                }, zod_v4_core.$strict>>>>;
             }, zod_v4_core.$strict>;
             page: z.ZodMiniObject<{
                 path: z.ZodMiniString<string>;
@@ -1026,4 +933,4 @@ interface TypedTrackingClient<TRegistry extends TriggerRegistryConfig> {
     getVisitorId(): string;
 }
 
-export { buildBookingHandoffUrl as $, type AutomaticEventName as A, type BookableDay as B, type CtaClickConfig as C, type RegisteredManualEvents as D, EVENT_SEMANTICS as E, type FormStartConfig as F, type ScrollDepthMetadata as G, type SdkHeartbeatConfig as H, type SdkHeartbeatMetadata as I, type SiteLinkArrivalConfig as J, type SiteLinkArrivalMetadata as K, type SiteLinkClickConfig as L, type ManualEventName as M, type SiteLinkClickMetadata as N, type SpecificPageName as O, type PageExitConfig as P, type SpecificPageVisitConfig as Q, type RegisteredAutomaticEvents as R, type ScrollDepthConfig as S, type SpecificPageVisitMetadata as T, type TimeOnSiteConfig as U, type TimeOnSiteMetadata as V, type TrackableEvent as W, type TriggerRegistryConfig as X, type TypedTrackEventOptions as Y, type TypedTrackingClient as Z, bookableSlots as _, type BookingHandoffPrefill as a, getBookingIntegration as a0, getEventSemantics as a1, groupBookingOptions as a2, shopToday as a3, type BookingIntegration as b, type BookingOption as c, type BookingOptionGroup as d, type BookingProvider as e, type BookingRules as f, type CtaClickMetadata as g, type EventCategory as h, type EventClientVisibility as i, type EventConfig as j, type EventKind as k, type EventMetadata as l, type EventName as m, type EventOutcomeRole as n, type EventSemantics as o, type FormStartMetadata as p, type FormStepConfig as q, type FormStepMetadata as r, type MultiPageSessionConfig as s, type MultiPageSessionMetadata as t, type PageExitMetadata as u, type PageIdentity as v, type PageViewConfig as w, type PageViewMetadata as x, type PhoneClickConfig as y, type PhoneClickMetadata as z };
+export { type AutomaticEventName as A, type SiteLinkClickConfig as B, type CtaClickConfig as C, type SiteLinkClickMetadata as D, EVENT_SEMANTICS as E, type FormStartConfig as F, type SpecificPageName as G, type SpecificPageVisitConfig as H, type SpecificPageVisitMetadata as I, type TimeOnSiteMetadata as J, type TrackableEvent as K, type TriggerRegistryConfig as L, type ManualEventName as M, type TypedTrackEventOptions as N, type TypedTrackingClient as O, type PageExitConfig as P, getEventSemantics as Q, type RegisteredAutomaticEvents as R, type ScrollDepthConfig as S, type TimeOnSiteConfig as T, type CtaClickMetadata as a, type EventCategory as b, type EventClientVisibility as c, type EventConfig as d, type EventKind as e, type EventMetadata as f, type EventName as g, type EventOutcomeRole as h, type EventSemantics as i, type FormStartMetadata as j, type FormStepConfig as k, type FormStepMetadata as l, type MultiPageSessionConfig as m, type MultiPageSessionMetadata as n, type PageExitMetadata as o, type PageIdentity as p, type PageViewConfig as q, type PageViewMetadata as r, type PhoneClickConfig as s, type PhoneClickMetadata as t, type RegisteredManualEvents as u, type ScrollDepthMetadata as v, type SdkHeartbeatConfig as w, type SdkHeartbeatMetadata as x, type SiteLinkArrivalConfig as y, type SiteLinkArrivalMetadata as z };

package/dist/{phone-utils-BNiSqeF7.d.mts → phone-utils-CYr6AmEP.d.mts}

@@ -1,6 +1,231 @@
-import { J as JsonValue } from './form-submit-CX-CxJjQ.mjs';
+import * as z from 'zod/mini';
 import { CountryCode } from 'libphonenumber-js';
 
+/**
+ * JSON-serializable value accepted by `form_submit.fields[].value`.
+ *
+ * This intentionally excludes `undefined`, functions, symbols, `Date`
+ * instances, and non-finite numbers. Values are stored in PostgreSQL JSONB, so
+ * consumers should send only data that has a stable JSON representation.
+ */
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/** What the SDK's ladder found wrong with a submit it sent anyway (ADR-0024 §6). */
+declare const contractViolationSchema: z.ZodMiniObject<{
+    role: z.ZodMiniNullable<z.ZodMiniString<string>>;
+    rule: z.ZodMiniString<string>;
+}, z.core.$strict>;
+type FormContractViolation = z.infer<typeof contractViolationSchema>;
+declare const formSubmitMetadataSchema: z.ZodMiniObject<{
+    form: z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        action: z.ZodMiniNullable<z.ZodMiniString<string>>;
+        fields: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
+            name: z.ZodMiniString<string>;
+            type: z.ZodMiniString<string>;
+            label: z.ZodMiniNullable<z.ZodMiniString<string>>;
+            value: z.ZodMiniType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+            role: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+        }, z.core.$strict>>>;
+        kind: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+        contract_version: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniInt>>;
+        contract_hash: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+        extra: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniArray<z.ZodMiniObject<{
+            key: z.ZodMiniString<string>;
+            label: z.ZodMiniString<string>;
+            value: z.ZodMiniType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+        }, z.core.$strict>>>>;
+        contract_violations: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniArray<z.ZodMiniObject<{
+            role: z.ZodMiniNullable<z.ZodMiniString<string>>;
+            rule: z.ZodMiniString<string>;
+        }, z.core.$strict>>>>;
+    }, z.core.$strict>;
+    page: z.ZodMiniObject<{
+        path: z.ZodMiniString<string>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type FormSubmitMetadata = z.infer<typeof formSubmitMetadataSchema>;
+/**
+ * Registration config for `form_submit`.
+ *
+ * This event is manual-only and currently has no registration options. The
+ * empty object enables typed `trackEvent('form_submit', ...)` calls.
+ */
+declare const formSubmitConfigSchema: z.ZodMiniObject<{}, z.core.$strict>;
+type FormSubmitConfig = z.infer<typeof formSubmitConfigSchema>;
+
+/** Bump-on-change registry version; travels on every contract-typed form_submit. */
+declare const LEAD_FORM_REGISTRY_VERSION = 2;
+declare const LEAD_FORM_KINDS: readonly ["booking", "quote", "contact", "consult", "callback"];
+/** What a form is for; `form_id` stays the instance handle. */
+type LeadFormKind = (typeof LEAD_FORM_KINDS)[number];
+declare const LEAD_FORM_ROLES: readonly ["given_name", "family_name", "phone", "email", "service", "preferred_date", "preferred_time", "note", "visit", "intent", "vehicle", "drop_off", "address", "patient_type", "matter", "language", "products", "goal", "business_type", "lead_volume", "attribution"];
+/** A role from the registry, or `add_on:<key>` for a yes/no extra with its own label. */
+type LeadFormRole = (typeof LEAD_FORM_ROLES)[number] | `add_on:${string}`;
+declare const LEAD_FORM_PRIMITIVES: readonly ["string", "text", "enum", "multi_enum", "bool", "date", "time_window", "phone", "email", "address", "number"];
+type LeadFormPrimitive = (typeof LEAD_FORM_PRIMITIVES)[number];
+/** The wire schema of each primitive's value. */
+declare const leadFormPrimitiveSchemas: {
+    readonly string: z.ZodMiniString<string>;
+    readonly text: z.ZodMiniString<string>;
+    readonly enum: z.ZodMiniString<string>;
+    readonly multi_enum: z.ZodMiniArray<z.ZodMiniString<string>>;
+    readonly bool: z.ZodMiniBoolean<boolean>;
+    readonly date: z.ZodMiniString<string>;
+    readonly time_window: z.ZodMiniObject<{
+        start: z.ZodMiniString<string>;
+        end: z.ZodMiniNullable<z.ZodMiniString<string>>;
+        label: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strict>;
+    readonly phone: z.ZodMiniString<string>;
+    readonly email: z.ZodMiniString<string>;
+    readonly address: z.ZodMiniObject<{
+        line1: z.ZodMiniString<string>;
+        line2: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        city: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        region: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        postal_code: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        country: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strict>;
+    readonly number: z.ZodMiniNumber<number>;
+};
+interface LeadFormRoleOption {
+    key: string;
+    label: string;
+    isNonAnswer?: true;
+}
+interface LeadFormRoleSpec {
+    primitive: LeadFormPrimitive;
+    smsLabel: string;
+    contactIdentity?: true;
+    uninteresting?: true;
+    options?: readonly LeadFormRoleOption[];
+}
+/** Every role's primitive and text label; `add_on` is the template for `add_on:<key>`. */
+declare const LEAD_FORM_ROLE_SPECS: {
+    readonly given_name: {
+        readonly primitive: "string";
+        readonly smsLabel: "";
+        readonly contactIdentity: true;
+    };
+    readonly family_name: {
+        readonly primitive: "string";
+        readonly smsLabel: "";
+        readonly contactIdentity: true;
+    };
+    readonly phone: {
+        readonly primitive: "phone";
+        readonly smsLabel: "";
+        readonly contactIdentity: true;
+    };
+    readonly email: {
+        readonly primitive: "email";
+        readonly smsLabel: "";
+        readonly contactIdentity: true;
+    };
+    readonly service: {
+        readonly primitive: "multi_enum";
+        readonly smsLabel: "Service";
+    };
+    readonly preferred_date: {
+        readonly primitive: "date";
+        readonly smsLabel: "Date";
+    };
+    readonly preferred_time: {
+        readonly primitive: "time_window";
+        readonly smsLabel: "Time";
+    };
+    readonly note: {
+        readonly primitive: "text";
+        readonly smsLabel: "Note";
+    };
+    readonly visit: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Visit";
+        readonly options: readonly [{
+            readonly key: "in-shop";
+            readonly label: "In shop";
+        }, {
+            readonly key: "in-home";
+            readonly label: "In home";
+        }, {
+            readonly key: "remote";
+            readonly label: "Remote";
+        }, {
+            readonly key: "on-site";
+            readonly label: "On site";
+        }];
+    };
+    readonly intent: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Wants";
+        readonly options: readonly [{
+            readonly key: "book";
+            readonly label: "Book";
+        }, {
+            readonly key: "quote";
+            readonly label: "Quote";
+        }];
+    };
+    readonly vehicle: {
+        readonly primitive: "string";
+        readonly smsLabel: "Vehicle";
+    };
+    readonly drop_off: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Drop-off";
+        readonly options: readonly [{
+            readonly key: "wait-for-it";
+            readonly label: "Waiting";
+        }, {
+            readonly key: "drop-off";
+            readonly label: "Dropping off";
+        }];
+    };
+    readonly address: {
+        readonly primitive: "address";
+        readonly smsLabel: "Address";
+    };
+    readonly patient_type: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Patient";
+    };
+    readonly matter: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Matter";
+    };
+    readonly language: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Language";
+    };
+    readonly products: {
+        readonly primitive: "multi_enum";
+        readonly smsLabel: "Products";
+    };
+    readonly goal: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Goal";
+    };
+    readonly business_type: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Business";
+    };
+    readonly lead_volume: {
+        readonly primitive: "enum";
+        readonly smsLabel: "Lead volume";
+    };
+    readonly add_on: {
+        readonly primitive: "bool";
+        readonly smsLabel: "";
+    };
+    readonly attribution: {
+        readonly primitive: "enum";
+        readonly smsLabel: "";
+        readonly uninteresting: true;
+    };
+};
+
 /**
  * How a phone number is shown in the UI. The transmitted value is always E.164
  * and is deliberately NOT part of this — only the display format is configurable.
@@ -44,14 +269,17 @@ interface TrackedField {
     name: string;
     type: string;
     value: JsonValue;
+    /** `null` when the field has no visible label; the wire requires the key. */
     label?: string | null;
+    /** The ADR-0024 registry role this field answers, e.g. `phone`. */
+    role?: LeadFormRole;
 }
 /**
  * Build a tracked field whose wire value is ALWAYS E.164. The client keeps its
  * own display value for UI/email; this puts `+E.164` on the wire (or `null` when
  * the input isn't a valid number).
  */
-declare function phoneField(name: string, raw: string, country?: CountryCode): TrackedField;
+declare function phoneField(name: string, raw: string, country?: CountryCode, label?: string | null): TrackedField;
 
 /**
  * Visitor consent state as reported by `getConsentState()`.
@@ -394,4 +622,4 @@ declare function optOut(options?: SetConsentOptions): void;
  */
 declare function resetConsent(): void;
 
-export { type ConsentChoice as C, DEFAULT_DECLINE_TTL_DAYS as D, type GtagEnvironmentMap as G, type MetaPixelEnvironmentMap as M, type ParsedPhone as P, type SetConsentOptions as S, type TrackingParams as T, type TrackingInstallSurface as a, type TrackingEnvironment as b, type TrackingClientContext as c, type TrackingEventCreatePayload as d, type TrackingSessionUpsertPayload as e, type ConsentChoiceState as f, type ConsentSource as g, type ConsentState as h, DEFAULT_PHONE_COUNTRY as i, type PhoneConfig as j, type PhoneDisplayFormat as k, type TrackedField as l, type TrackingInitConfig as m, formatPhone as n, formatPhoneAsTyped as o, getConsentChoice as p, getConsentState as q, onConsentChange as r, optIn as s, optOut as t, parsePhone as u, phoneField as v, resetConsent as w, setConsentState as x, toE164 as y };
+export { getConsentChoice as A, getConsentState as B, type ConsentChoice as C, DEFAULT_DECLINE_TTL_DAYS as D, leadFormPrimitiveSchemas as E, type FormContractViolation as F, type GtagEnvironmentMap as G, onConsentChange as H, optIn as I, type JsonValue as J, optOut as K, LEAD_FORM_KINDS as L, type MetaPixelEnvironmentMap as M, parsePhone as N, phoneField as O, type ParsedPhone as P, resetConsent as Q, setConsentState as R, type SetConsentOptions as S, type TrackingParams as T, toE164 as U, type TrackingInstallSurface as a, type TrackingEnvironment as b, type TrackingClientContext as c, type TrackingEventCreatePayload as d, type TrackingSessionUpsertPayload as e, type ConsentChoiceState as f, type ConsentSource as g, type ConsentState as h, DEFAULT_PHONE_COUNTRY as i, type FormSubmitConfig as j, type FormSubmitMetadata as k, LEAD_FORM_PRIMITIVES as l, LEAD_FORM_REGISTRY_VERSION as m, LEAD_FORM_ROLES as n, LEAD_FORM_ROLE_SPECS as o, type LeadFormKind as p, type LeadFormPrimitive as q, type LeadFormRole as r, type LeadFormRoleOption as s, type LeadFormRoleSpec as t, type PhoneConfig as u, type PhoneDisplayFormat as v, type TrackedField as w, type TrackingInitConfig as x, formatPhone as y, formatPhoneAsTyped as z };