@aranova/tracking-react 1.18.0 → 1.19.0

package/dist/{bookings-CCGpXhYE.d.ts → bookings-BDLyF70h.d.ts}

@@ -14,6 +14,22 @@ interface ConfigTriggerSpec {
     threshold_seconds?: number;
     page_threshold?: number;
     page_name?: string;
+    metric?: "percent" | "seconds";
+    threshold?: number;
+    video_id?: string | null;
+}
+interface TrackedVideoSourcesConfig {
+    desktop: string;
+    mobile?: string | null;
+}
+interface TrackedVideoConfig {
+    key: string;
+    title: string;
+    host: string;
+    sources: TrackedVideoSourcesConfig;
+    poster_time?: number;
+    poster_time_s?: number;
+    duration_s?: number | null;
 }
 /** One unified conversion goal: a revenue `sale` or an on-page `event`. */
 interface ConversionGoal {
@@ -47,6 +63,8 @@ interface ConversionConfig {
     integrations?: ConversionIntegrations;
     /** The lead-form contract (ADR-0024); null from an API that predates it. */
     lead_forms?: LeadFormsConfig | null;
+    /** Cloudflare Stream tracked videos configured for this site (ADR-0042). */
+    videos?: Record<string, TrackedVideoConfig>;
 }
 interface LeadFormsConfig {
     /** The registry version the object was published under. */
@@ -305,6 +323,10 @@ declare class TrackingConfigRuntime {
     integrations(): ConversionIntegrations | null;
     /** The lead-form contracts, from the cached object like `integrations()`. */
     leadForms(): LeadFormsConfig | null;
+    /** Configured Cloudflare Stream tracked videos for this site. */
+    videos(): Record<string, TrackedVideoConfig>;
+    /** Look up one configured Cloudflare Stream tracked video by key. */
+    getVideo(key: string): TrackedVideoConfig | null;
     private revalidateNow;
     private expireAuthority;
     private confirm;
@@ -795,4 +817,4 @@ interface SalesBookingsClient {
 /** A fresh per-submit key. Keep it for retries of the same submit; mint a new one after. */
 declare const newBookingAttemptKey: typeof uuidV4;
 
-export { slotFields as $, type LeadFormDetailsResult as A, type BookableDay as B, type ConversionConfig as C, type LeadFormExtraField as D, type LeadFormFields as E, type FormSubmitField as F, type LeadFormKindDecl as G, type LeadFormRequirementDecl as H, type LeadFormSubmission as I, type LeadFormSubmitInput as J, type LeadFormSubmitOptions as K, type LeadFormAddress as L, type LeadFormSubmitter as M, type LeadFormTimeWindow as N, type LeadFormTracking as O, type LeadFormValue as P, bookableSlots as Q, buildBookingHandoffUrl as R, type SalesBookingsClient as S, type TrackingConfigReference as T, getBookingIntegration as U, getTrackingConfigRuntime as V, groupBookingOptions as W, newBookingAttemptKey as X, resolveConversionConfig as Y, resolveTrackingConfigUrl as Z, shopToday as _, type BookingDetailsFailure as a, timeWindow as a0, createLeadFormSubmit as a1, TrackingConfigRuntime as a2, type BookingDetailsInput as b, type BookingDetailsOptions as c, type BookingDetailsOutcome as d, type BookingDetailsStatus as e, type BookingDropOff as f, type BookingFormSubmit as g, type BookingHandoffPrefill as h, type BookingInput as i, type BookingInputFor as j, type BookingIntegration as k, type BookingMode as l, type BookingOption as m, type BookingOptionGroup as n, type BookingOptionKey as o, type BookingOutcome as p, type BookingProvider as q, type BookingRules as r, type BookingServiceKey as s, type BookingSimulation as t, type BookingSubmitOptions as u, type BookingVehicle as v, type ConversionConfigStore as w, type LeadFormContracts as x, type LeadFormDetailsFields as y, type LeadFormDetailsInput as z };
+export { resolveTrackingConfigUrl as $, type LeadFormDetailsResult as A, type BookableDay as B, type ConversionConfig as C, type LeadFormExtraField as D, type LeadFormFields as E, type FormSubmitField as F, type LeadFormKindDecl as G, type LeadFormRequirementDecl as H, type LeadFormSubmission as I, type LeadFormSubmitInput as J, type LeadFormSubmitOptions as K, type LeadFormAddress as L, type LeadFormSubmitter as M, type LeadFormTimeWindow as N, type LeadFormTracking as O, type LeadFormValue as P, type TrackedVideoSourcesConfig as Q, type TrackingConfigReference as R, type SalesBookingsClient as S, type TrackedVideoConfig as T, bookableSlots as U, buildBookingHandoffUrl as V, getBookingIntegration as W, getTrackingConfigRuntime as X, groupBookingOptions as Y, newBookingAttemptKey as Z, resolveConversionConfig as _, type BookingDetailsFailure as a, shopToday as a0, slotFields as a1, timeWindow as a2, createLeadFormSubmit as a3, TrackingConfigRuntime as a4, type BookingDetailsInput as b, type BookingDetailsOptions as c, type BookingDetailsOutcome as d, type BookingDetailsStatus as e, type BookingDropOff as f, type BookingFormSubmit as g, type BookingHandoffPrefill as h, type BookingInput as i, type BookingInputFor as j, type BookingIntegration as k, type BookingMode as l, type BookingOption as m, type BookingOptionGroup as n, type BookingOptionKey as o, type BookingOutcome as p, type BookingProvider as q, type BookingRules as r, type BookingServiceKey as s, type BookingSimulation as t, type BookingSubmitOptions as u, type BookingVehicle as v, type ConversionConfigStore as w, type LeadFormContracts as x, type LeadFormDetailsFields as y, type LeadFormDetailsInput as z };

package/dist/{bookings-CVvpj_8K.d.mts → bookings-v3HA8gsC.d.mts}

@@ -14,6 +14,22 @@ interface ConfigTriggerSpec {
     threshold_seconds?: number;
     page_threshold?: number;
     page_name?: string;
+    metric?: "percent" | "seconds";
+    threshold?: number;
+    video_id?: string | null;
+}
+interface TrackedVideoSourcesConfig {
+    desktop: string;
+    mobile?: string | null;
+}
+interface TrackedVideoConfig {
+    key: string;
+    title: string;
+    host: string;
+    sources: TrackedVideoSourcesConfig;
+    poster_time?: number;
+    poster_time_s?: number;
+    duration_s?: number | null;
 }
 /** One unified conversion goal: a revenue `sale` or an on-page `event`. */
 interface ConversionGoal {
@@ -47,6 +63,8 @@ interface ConversionConfig {
     integrations?: ConversionIntegrations;
     /** The lead-form contract (ADR-0024); null from an API that predates it. */
     lead_forms?: LeadFormsConfig | null;
+    /** Cloudflare Stream tracked videos configured for this site (ADR-0042). */
+    videos?: Record<string, TrackedVideoConfig>;
 }
 interface LeadFormsConfig {
     /** The registry version the object was published under. */
@@ -305,6 +323,10 @@ declare class TrackingConfigRuntime {
     integrations(): ConversionIntegrations | null;
     /** The lead-form contracts, from the cached object like `integrations()`. */
     leadForms(): LeadFormsConfig | null;
+    /** Configured Cloudflare Stream tracked videos for this site. */
+    videos(): Record<string, TrackedVideoConfig>;
+    /** Look up one configured Cloudflare Stream tracked video by key. */
+    getVideo(key: string): TrackedVideoConfig | null;
     private revalidateNow;
     private expireAuthority;
     private confirm;
@@ -795,4 +817,4 @@ interface SalesBookingsClient {
 /** A fresh per-submit key. Keep it for retries of the same submit; mint a new one after. */
 declare const newBookingAttemptKey: typeof uuidV4;
 
-export { slotFields as $, type LeadFormDetailsResult as A, type BookableDay as B, type ConversionConfig as C, type LeadFormExtraField as D, type LeadFormFields as E, type FormSubmitField as F, type LeadFormKindDecl as G, type LeadFormRequirementDecl as H, type LeadFormSubmission as I, type LeadFormSubmitInput as J, type LeadFormSubmitOptions as K, type LeadFormAddress as L, type LeadFormSubmitter as M, type LeadFormTimeWindow as N, type LeadFormTracking as O, type LeadFormValue as P, bookableSlots as Q, buildBookingHandoffUrl as R, type SalesBookingsClient as S, type TrackingConfigReference as T, getBookingIntegration as U, getTrackingConfigRuntime as V, groupBookingOptions as W, newBookingAttemptKey as X, resolveConversionConfig as Y, resolveTrackingConfigUrl as Z, shopToday as _, type BookingDetailsFailure as a, timeWindow as a0, createLeadFormSubmit as a1, TrackingConfigRuntime as a2, type BookingDetailsInput as b, type BookingDetailsOptions as c, type BookingDetailsOutcome as d, type BookingDetailsStatus as e, type BookingDropOff as f, type BookingFormSubmit as g, type BookingHandoffPrefill as h, type BookingInput as i, type BookingInputFor as j, type BookingIntegration as k, type BookingMode as l, type BookingOption as m, type BookingOptionGroup as n, type BookingOptionKey as o, type BookingOutcome as p, type BookingProvider as q, type BookingRules as r, type BookingServiceKey as s, type BookingSimulation as t, type BookingSubmitOptions as u, type BookingVehicle as v, type ConversionConfigStore as w, type LeadFormContracts as x, type LeadFormDetailsFields as y, type LeadFormDetailsInput as z };
+export { resolveTrackingConfigUrl as $, type LeadFormDetailsResult as A, type BookableDay as B, type ConversionConfig as C, type LeadFormExtraField as D, type LeadFormFields as E, type FormSubmitField as F, type LeadFormKindDecl as G, type LeadFormRequirementDecl as H, type LeadFormSubmission as I, type LeadFormSubmitInput as J, type LeadFormSubmitOptions as K, type LeadFormAddress as L, type LeadFormSubmitter as M, type LeadFormTimeWindow as N, type LeadFormTracking as O, type LeadFormValue as P, type TrackedVideoSourcesConfig as Q, type TrackingConfigReference as R, type SalesBookingsClient as S, type TrackedVideoConfig as T, bookableSlots as U, buildBookingHandoffUrl as V, getBookingIntegration as W, getTrackingConfigRuntime as X, groupBookingOptions as Y, newBookingAttemptKey as Z, resolveConversionConfig as _, type BookingDetailsFailure as a, shopToday as a0, slotFields as a1, timeWindow as a2, createLeadFormSubmit as a3, TrackingConfigRuntime as a4, type BookingDetailsInput as b, type BookingDetailsOptions as c, type BookingDetailsOutcome as d, type BookingDetailsStatus as e, type BookingDropOff as f, type BookingFormSubmit as g, type BookingHandoffPrefill as h, type BookingInput as i, type BookingInputFor as j, type BookingIntegration as k, type BookingMode as l, type BookingOption as m, type BookingOptionGroup as n, type BookingOptionKey as o, type BookingOutcome as p, type BookingProvider as q, type BookingRules as r, type BookingServiceKey as s, type BookingSimulation as t, type BookingSubmitOptions as u, type BookingVehicle as v, type ConversionConfigStore as w, type LeadFormContracts as x, type LeadFormDetailsFields as y, type LeadFormDetailsInput as z };

package/dist/client.d.mts

@@ -1,9 +1,9 @@
 import * as react from 'react';
 import { ReactNode, CSSProperties, InputHTMLAttributes, ChangeEvent, FocusEvent, AnchorHTMLAttributes } from 'react';
 import { G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, h as ConsentState, f as ConsentChoiceState, g as ConsentSource, T as TrackingParams, b as TrackingEnvironment, u as PhoneConfig, P as ParsedPhone, v as PhoneDisplayFormat } from './phone-utils-BlWj8oxq.mjs';
-import { T as TrackingConfigReference, C as ConversionConfig, h as BookingHandoffPrefill, i as BookingInput, p as BookingOutcome, b as BookingDetailsInput, d as BookingDetailsOutcome, k as BookingIntegration, B as BookableDay, x as LeadFormContracts, S as SalesBookingsClient, g as BookingFormSubmit, t as BookingSimulation, j as BookingInputFor } from './bookings-CVvpj_8K.mjs';
-export { a1 as createLeadFormSubmit } from './bookings-CVvpj_8K.mjs';
-import { O as TriggerRegistryConfig, U as TypedTrackingClient } from './ingest-typed-CoCjTqJs.mjs';
+import { R as TrackingConfigReference, C as ConversionConfig, h as BookingHandoffPrefill, i as BookingInput, p as BookingOutcome, b as BookingDetailsInput, d as BookingDetailsOutcome, k as BookingIntegration, B as BookableDay, x as LeadFormContracts, S as SalesBookingsClient, g as BookingFormSubmit, t as BookingSimulation, j as BookingInputFor, T as TrackedVideoConfig } from './bookings-v3HA8gsC.mjs';
+export { a3 as createLeadFormSubmit } from './bookings-v3HA8gsC.mjs';
+import { Q as TriggerRegistryConfig, V as TypedTrackingClient, $ as VideoVariant, a0 as VideoWatchRange, O as TrackingClient } from './ingest-typed-BEFQd3WM.mjs';
 import { CountryCode } from 'libphonenumber-js';
 import 'zod/mini';
 import 'zod/v4/core';
@@ -439,4 +439,121 @@ declare function useBookingSubmit<C extends LeadFormContracts | undefined = unde
     contracts?: C;
 }): BookingSubmitState<C extends LeadFormContracts ? BookingInputFor<C> : BookingInput>;
 
-export { AdPlatformTracking, type AdPlatformTrackingProps, type BookedAttempt, BookingHandoffLink, type BookingHandoffLinkProps, type BookingHandoffOptions, type BookingSubmitState, type BookingSubmitStatus, ConsentBanner, type ConsentBannerProps, type CreateTrackingOptions, type CreateTrackingResult, GoogleAdsTracking, type GoogleAdsTrackingProps, PhoneField, type PhoneFieldApi, type PhoneFieldProps, type PhoneInputProps, type TrackingProviderProps, type UseConsentResult, type UseCookiePreferencesOptions, type UseCookiePreferencesResult, type UsePhoneFieldOptions, createTracking, useBookingHandoffUrl, useBookingIntegration, useBookingSlots, useBookingSubmit, useConsent, useConsentState, useCookiePreferences, useGclid, usePhoneConfig, usePhoneField, useTrackingParams };
+/** A rendition height in pixels (e.g. 720, 1080), or "auto" for adaptive bitrate. */
+type VideoQuality = number | "auto";
+interface TrackedVideoEvent {
+    /** Logical video key, e.g. "qlt-case-study-v6". */
+    id: string;
+    /** Variant-qualified DOM id, e.g. "qlt-case-study-v6-16x9". */
+    videoId: string;
+    variant: VideoVariant;
+    currentTime: number;
+    duration: number;
+    watchedSeconds: number;
+    watchedPercent: number;
+    maxPercent: number;
+    ranges: VideoWatchRange[];
+}
+interface TrackedVideoCallbacks {
+    onPlay?: (e: TrackedVideoEvent) => void;
+    onPause?: (e: TrackedVideoEvent) => void;
+    /** A finished seek: where playback was and where it landed, in seconds. */
+    onSeek?: (e: TrackedVideoEvent & {
+        from: number;
+        to: number;
+    }) => void;
+    onTimeUpdate?: (e: TrackedVideoEvent) => void;
+    onEnded?: (e: TrackedVideoEvent) => void;
+    onWaiting?: (e: TrackedVideoEvent) => void;
+    /** Every quality change: a manual pick or an automatic ABR switch. */
+    onQualityChange?: (e: TrackedVideoEvent & {
+        from: VideoQuality;
+        to: VideoQuality;
+        source: "manual" | "auto";
+    }) => void;
+    onFullscreenChange?: (e: TrackedVideoEvent & {
+        fullscreen: boolean;
+    }) => void;
+    /** Fired once per checkpoint (default 25, 50, 75, 90, 100) as playback crosses it. */
+    onCheckpoint?: (e: TrackedVideoEvent & {
+        checkpoint: number;
+    }) => void;
+}
+interface TrackedVideoSources {
+    /** 16:9 Stream UID for desktop / landscape viewports. */
+    desktop: string;
+    /** Optional 9:16 Stream UID for mobile / portrait viewports. Falls back to `desktop` if omitted. */
+    mobile?: string | null;
+}
+interface TrackedVideoProps extends TrackedVideoCallbacks {
+    /** Logical video key (e.g. `"qlt-case-study-v6"`), resolved from R2 `trackingConfig` or `fallbackConfig`. */
+    id?: string;
+    /** Alias for `id` when referencing a key from `aranova-services.ts` (`videos`). */
+    video?: string;
+    /** Cloudflare Stream customer subdomain host (e.g. `"customer-xxxx.cloudflarestream.com"`). */
+    host?: string;
+    /** Stream UIDs for the desktop (16:9) and optional mobile (9:16) cuts. */
+    sources?: TrackedVideoSources;
+    /** Accessible title for the video player. */
+    title?: string;
+    /** Poster frame timestamp in seconds (Cloudflare Stream thumbnail parameter). Default: `4`. */
+    posterTime?: number;
+    /** Optional custom poster URL override. */
+    posterUrl?: string;
+    /** Optional custom renderer for the poster image (e.g. `next/image`). */
+    renderPoster?: (props: {
+        src: string;
+        variant: VideoVariant;
+        title: string;
+        width: number;
+        height: number;
+    }) => ReactNode;
+    /** Desktop theater state (controlled). */
+    theater?: boolean;
+    /** Initial desktop theater state when uncontrolled. */
+    defaultTheater?: boolean;
+    /** Callback when desktop theater expand/shrink is toggled or triggered on first play. */
+    onTheaterChange?: (next: boolean) => void;
+    /** Desktop expansion mode (`"theater"`, `"inline"`, or `"none"`). */
+    expandMode?: "theater" | "inline" | "none";
+    /** Whether clicking Play on desktop automatically expands into theater mode. Default: `true`. */
+    autoExpandOnPlay?: boolean;
+    /** Max width when expanded inline on desktop without an external `<TrackedVideoStage>`. Default: `1100`. */
+    expandedMaxWidth?: number | string;
+    /** Percentage checkpoints that trigger an immediate `video_progress` flush. Default: `[25, 50, 75, 90, 100]`. */
+    checkpoints?: readonly number[];
+    /** Optional R2 config reference override (defaults to the one passed to `createTracking`). */
+    trackingConfig?: TrackingConfigReference;
+    /** Optional baked video config fallback (e.g. `videos["qlt-case-study-v6"]` from `aranova-services.ts`). */
+    fallbackConfig?: TrackedVideoConfig | null;
+    /** Optional custom tracking client override (defaults to the active provider's client). */
+    client?: TrackingClient | null;
+    /** Optional custom loader for Media Chrome and HLS player libraries. */
+    loadPlayerLibs?: () => Promise<{
+        hls?: unknown;
+    } | void>;
+    className?: string;
+    style?: CSSProperties;
+}
+declare const DEFAULT_VIDEO_CHECKPOINTS: readonly number[];
+declare const streamManifestUrl: (host: string, uid: string) => string;
+declare const streamPosterUrl: (host: string, uid: string, time?: number) => string;
+/** Look up a configured Cloudflare Stream tracked video by key from R2 runtime or `fallbackConfig`. */
+declare function useTrackedVideoConfig(videoKey: string | undefined, trackingConfig?: TrackingConfigReference, fallbackConfig?: TrackedVideoConfig | null): TrackedVideoConfig | null;
+/** Cloudflare Stream HLS player with watch-range telemetry, checkpoint flushing, and Theater mode. */
+declare function TrackedVideo(props: TrackedVideoProps): ReactNode;
+interface TrackedVideoStageProps {
+    /** Props forwarded to the `<TrackedVideo>` inside the stage. */
+    video: TrackedVideoProps;
+    /** Accompanying copy/content rendered beside the player at rest and below it in theater mode. */
+    children: ReactNode;
+    /** Maximum width of the expanded theater player on desktop. Default: `1100`. */
+    expandedMaxWidth?: number | string;
+    /** Maximum width of the accompanying copy when stacked below the theater player. Default: `760`. */
+    collapsedTextMaxWidth?: number | string;
+    className?: string;
+}
+/** Two-column desktop stage that FLIP-animates `<TrackedVideo>` into full-width theater layout. */
+declare function TrackedVideoStage({ video, children, expandedMaxWidth, collapsedTextMaxWidth, className, }: TrackedVideoStageProps): ReactNode;
+
+export { AdPlatformTracking, type AdPlatformTrackingProps, type BookedAttempt, BookingHandoffLink, type BookingHandoffLinkProps, type BookingHandoffOptions, type BookingSubmitState, type BookingSubmitStatus, ConsentBanner, type ConsentBannerProps, type CreateTrackingOptions, type CreateTrackingResult, DEFAULT_VIDEO_CHECKPOINTS, GoogleAdsTracking, type GoogleAdsTrackingProps, PhoneField, type PhoneFieldApi, type PhoneFieldProps, type PhoneInputProps, TrackedVideo, type TrackedVideoCallbacks, type TrackedVideoEvent, type TrackedVideoProps, type TrackedVideoSources, TrackedVideoStage, type TrackedVideoStageProps, type TrackingProviderProps, type UseConsentResult, type UseCookiePreferencesOptions, type UseCookiePreferencesResult, type UsePhoneFieldOptions, type VideoQuality, createTracking, streamManifestUrl, streamPosterUrl, useBookingHandoffUrl, useBookingIntegration, useBookingSlots, useBookingSubmit, useConsent, useConsentState, useCookiePreferences, useGclid, usePhoneConfig, usePhoneField, useTrackedVideoConfig, useTrackingParams };

package/dist/client.d.ts

@@ -1,9 +1,9 @@
 import * as react from 'react';
 import { ReactNode, CSSProperties, InputHTMLAttributes, ChangeEvent, FocusEvent, AnchorHTMLAttributes } from 'react';
 import { G as GtagEnvironmentMap, M as MetaPixelEnvironmentMap, h as ConsentState, f as ConsentChoiceState, g as ConsentSource, T as TrackingParams, b as TrackingEnvironment, u as PhoneConfig, P as ParsedPhone, v as PhoneDisplayFormat } from './phone-utils-BlWj8oxq.js';
-import { T as TrackingConfigReference, C as ConversionConfig, h as BookingHandoffPrefill, i as BookingInput, p as BookingOutcome, b as BookingDetailsInput, d as BookingDetailsOutcome, k as BookingIntegration, B as BookableDay, x as LeadFormContracts, S as SalesBookingsClient, g as BookingFormSubmit, t as BookingSimulation, j as BookingInputFor } from './bookings-CCGpXhYE.js';
-export { a1 as createLeadFormSubmit } from './bookings-CCGpXhYE.js';
-import { O as TriggerRegistryConfig, U as TypedTrackingClient } from './ingest-typed-C3XAjHlH.js';
+import { R as TrackingConfigReference, C as ConversionConfig, h as BookingHandoffPrefill, i as BookingInput, p as BookingOutcome, b as BookingDetailsInput, d as BookingDetailsOutcome, k as BookingIntegration, B as BookableDay, x as LeadFormContracts, S as SalesBookingsClient, g as BookingFormSubmit, t as BookingSimulation, j as BookingInputFor, T as TrackedVideoConfig } from './bookings-BDLyF70h.js';
+export { a3 as createLeadFormSubmit } from './bookings-BDLyF70h.js';
+import { Q as TriggerRegistryConfig, V as TypedTrackingClient, $ as VideoVariant, a0 as VideoWatchRange, O as TrackingClient } from './ingest-typed-DChvvgwd.js';
 import { CountryCode } from 'libphonenumber-js';
 import 'zod/mini';
 import 'zod/v4/core';
@@ -439,4 +439,121 @@ declare function useBookingSubmit<C extends LeadFormContracts | undefined = unde
     contracts?: C;
 }): BookingSubmitState<C extends LeadFormContracts ? BookingInputFor<C> : BookingInput>;
 
-export { AdPlatformTracking, type AdPlatformTrackingProps, type BookedAttempt, BookingHandoffLink, type BookingHandoffLinkProps, type BookingHandoffOptions, type BookingSubmitState, type BookingSubmitStatus, ConsentBanner, type ConsentBannerProps, type CreateTrackingOptions, type CreateTrackingResult, GoogleAdsTracking, type GoogleAdsTrackingProps, PhoneField, type PhoneFieldApi, type PhoneFieldProps, type PhoneInputProps, type TrackingProviderProps, type UseConsentResult, type UseCookiePreferencesOptions, type UseCookiePreferencesResult, type UsePhoneFieldOptions, createTracking, useBookingHandoffUrl, useBookingIntegration, useBookingSlots, useBookingSubmit, useConsent, useConsentState, useCookiePreferences, useGclid, usePhoneConfig, usePhoneField, useTrackingParams };
+/** A rendition height in pixels (e.g. 720, 1080), or "auto" for adaptive bitrate. */
+type VideoQuality = number | "auto";
+interface TrackedVideoEvent {
+    /** Logical video key, e.g. "qlt-case-study-v6". */
+    id: string;
+    /** Variant-qualified DOM id, e.g. "qlt-case-study-v6-16x9". */
+    videoId: string;
+    variant: VideoVariant;
+    currentTime: number;
+    duration: number;
+    watchedSeconds: number;
+    watchedPercent: number;
+    maxPercent: number;
+    ranges: VideoWatchRange[];
+}
+interface TrackedVideoCallbacks {
+    onPlay?: (e: TrackedVideoEvent) => void;
+    onPause?: (e: TrackedVideoEvent) => void;
+    /** A finished seek: where playback was and where it landed, in seconds. */
+    onSeek?: (e: TrackedVideoEvent & {
+        from: number;
+        to: number;
+    }) => void;
+    onTimeUpdate?: (e: TrackedVideoEvent) => void;
+    onEnded?: (e: TrackedVideoEvent) => void;
+    onWaiting?: (e: TrackedVideoEvent) => void;
+    /** Every quality change: a manual pick or an automatic ABR switch. */
+    onQualityChange?: (e: TrackedVideoEvent & {
+        from: VideoQuality;
+        to: VideoQuality;
+        source: "manual" | "auto";
+    }) => void;
+    onFullscreenChange?: (e: TrackedVideoEvent & {
+        fullscreen: boolean;
+    }) => void;
+    /** Fired once per checkpoint (default 25, 50, 75, 90, 100) as playback crosses it. */
+    onCheckpoint?: (e: TrackedVideoEvent & {
+        checkpoint: number;
+    }) => void;
+}
+interface TrackedVideoSources {
+    /** 16:9 Stream UID for desktop / landscape viewports. */
+    desktop: string;
+    /** Optional 9:16 Stream UID for mobile / portrait viewports. Falls back to `desktop` if omitted. */
+    mobile?: string | null;
+}
+interface TrackedVideoProps extends TrackedVideoCallbacks {
+    /** Logical video key (e.g. `"qlt-case-study-v6"`), resolved from R2 `trackingConfig` or `fallbackConfig`. */
+    id?: string;
+    /** Alias for `id` when referencing a key from `aranova-services.ts` (`videos`). */
+    video?: string;
+    /** Cloudflare Stream customer subdomain host (e.g. `"customer-xxxx.cloudflarestream.com"`). */
+    host?: string;
+    /** Stream UIDs for the desktop (16:9) and optional mobile (9:16) cuts. */
+    sources?: TrackedVideoSources;
+    /** Accessible title for the video player. */
+    title?: string;
+    /** Poster frame timestamp in seconds (Cloudflare Stream thumbnail parameter). Default: `4`. */
+    posterTime?: number;
+    /** Optional custom poster URL override. */
+    posterUrl?: string;
+    /** Optional custom renderer for the poster image (e.g. `next/image`). */
+    renderPoster?: (props: {
+        src: string;
+        variant: VideoVariant;
+        title: string;
+        width: number;
+        height: number;
+    }) => ReactNode;
+    /** Desktop theater state (controlled). */
+    theater?: boolean;
+    /** Initial desktop theater state when uncontrolled. */
+    defaultTheater?: boolean;
+    /** Callback when desktop theater expand/shrink is toggled or triggered on first play. */
+    onTheaterChange?: (next: boolean) => void;
+    /** Desktop expansion mode (`"theater"`, `"inline"`, or `"none"`). */
+    expandMode?: "theater" | "inline" | "none";
+    /** Whether clicking Play on desktop automatically expands into theater mode. Default: `true`. */
+    autoExpandOnPlay?: boolean;
+    /** Max width when expanded inline on desktop without an external `<TrackedVideoStage>`. Default: `1100`. */
+    expandedMaxWidth?: number | string;
+    /** Percentage checkpoints that trigger an immediate `video_progress` flush. Default: `[25, 50, 75, 90, 100]`. */
+    checkpoints?: readonly number[];
+    /** Optional R2 config reference override (defaults to the one passed to `createTracking`). */
+    trackingConfig?: TrackingConfigReference;
+    /** Optional baked video config fallback (e.g. `videos["qlt-case-study-v6"]` from `aranova-services.ts`). */
+    fallbackConfig?: TrackedVideoConfig | null;
+    /** Optional custom tracking client override (defaults to the active provider's client). */
+    client?: TrackingClient | null;
+    /** Optional custom loader for Media Chrome and HLS player libraries. */
+    loadPlayerLibs?: () => Promise<{
+        hls?: unknown;
+    } | void>;
+    className?: string;
+    style?: CSSProperties;
+}
+declare const DEFAULT_VIDEO_CHECKPOINTS: readonly number[];
+declare const streamManifestUrl: (host: string, uid: string) => string;
+declare const streamPosterUrl: (host: string, uid: string, time?: number) => string;
+/** Look up a configured Cloudflare Stream tracked video by key from R2 runtime or `fallbackConfig`. */
+declare function useTrackedVideoConfig(videoKey: string | undefined, trackingConfig?: TrackingConfigReference, fallbackConfig?: TrackedVideoConfig | null): TrackedVideoConfig | null;
+/** Cloudflare Stream HLS player with watch-range telemetry, checkpoint flushing, and Theater mode. */
+declare function TrackedVideo(props: TrackedVideoProps): ReactNode;
+interface TrackedVideoStageProps {
+    /** Props forwarded to the `<TrackedVideo>` inside the stage. */
+    video: TrackedVideoProps;
+    /** Accompanying copy/content rendered beside the player at rest and below it in theater mode. */
+    children: ReactNode;
+    /** Maximum width of the expanded theater player on desktop. Default: `1100`. */
+    expandedMaxWidth?: number | string;
+    /** Maximum width of the accompanying copy when stacked below the theater player. Default: `760`. */
+    collapsedTextMaxWidth?: number | string;
+    className?: string;
+}
+/** Two-column desktop stage that FLIP-animates `<TrackedVideo>` into full-width theater layout. */
+declare function TrackedVideoStage({ video, children, expandedMaxWidth, collapsedTextMaxWidth, className, }: TrackedVideoStageProps): ReactNode;
+
+export { AdPlatformTracking, type AdPlatformTrackingProps, type BookedAttempt, BookingHandoffLink, type BookingHandoffLinkProps, type BookingHandoffOptions, type BookingSubmitState, type BookingSubmitStatus, ConsentBanner, type ConsentBannerProps, type CreateTrackingOptions, type CreateTrackingResult, DEFAULT_VIDEO_CHECKPOINTS, GoogleAdsTracking, type GoogleAdsTrackingProps, PhoneField, type PhoneFieldApi, type PhoneFieldProps, type PhoneInputProps, TrackedVideo, type TrackedVideoCallbacks, type TrackedVideoEvent, type TrackedVideoProps, type TrackedVideoSources, TrackedVideoStage, type TrackedVideoStageProps, type TrackingProviderProps, type UseConsentResult, type UseCookiePreferencesOptions, type UseCookiePreferencesResult, type UsePhoneFieldOptions, type VideoQuality, createTracking, streamManifestUrl, streamPosterUrl, useBookingHandoffUrl, useBookingIntegration, useBookingSlots, useBookingSubmit, useConsent, useConsentState, useCookiePreferences, useGclid, usePhoneConfig, usePhoneField, useTrackedVideoConfig, useTrackingParams };