export interface HTMLTrustedScriptElement extends Omit<HTMLScriptElement, "src"> {
    src: TrustedScriptURL | string;
}
export interface InitSettings {
    /**
     * Matomo base URL.
     *
     * When using the server-side proxy (`withMatomoProxy()`), you can omit this
     * and the library will automatically use `NEXT_PUBLIC_MATOMO_PROXY_PATH` when
     * available (so browser requests go to your own domain).
     */
    url?: string;
    siteId: string;
    jsTrackerFile?: string;
    phpTrackerFile?: string;
    /**
     * When `true` (default), and if `NEXT_PUBLIC_MATOMO_PROXY_PATH` is defined,
     * the tracker will use the proxy path instead of the provided `url`.
     *
     * Set to `false` to force direct calls to the Matomo instance URL.
     *
     * @default true
     */
    useProxy?: boolean;
    excludeUrlsPatterns?: RegExp[];
    disableCookies?: boolean;
    onRouteChangeStart?: (path: string) => void;
    onRouteChangeComplete?: (path: string) => void;
    onInitialization?: () => void;
    onScriptLoadingError?: () => void;
    nonce?: string;
    trustedPolicyName?: string;
    debug?: boolean;
    pathname?: string;
    searchParams?: URLSearchParams;
    searchKeyword?: string;
    searchRoutes?: string[];
    enableHeatmapSessionRecording?: boolean;
    enableHeartBeatTimer?: boolean;
    heartBeatTimerInterval?: number;
    heatmapConfig?: HeatmapConfig;
    cleanUrl?: boolean;
    /**
     * A/B tests to register automatically during initialization.
     * When provided, `initABTesting()` is called automatically — no need to
     * use `onInitialization` manually.
     *
     * @example
     * ```ts
     * trackAppRouter({
     *   url: "https://matomo.example.com",
     *   siteId: "1",
     *   pathname,
     *   searchParams,
     *   abTests: [
     *     {
     *       name: "homepage-hero",
     *       percentage: 100,
     *       variations: [{ name: "original" }, { name: "new-hero" }],
     *     },
     *   ],
     * });
     * ```
     */
    abTests?: import("./ab-testing").ABTestDefinition[];
}
export interface HeatmapConfig {
    /**
     * Enable/disable keystroke capture (default: false)
     * Since v3.2.0, keystrokes are disabled by default
     */
    captureKeystrokes?: boolean;
    /**
     * Enable/disable recording of mouse and touch movements (default: true)
     * Set to false to disable the "Move Heatmap" feature
     */
    recordMovements?: boolean;
    /**
     * Maximum capture time in seconds (default: 600 = 10 minutes)
     * Set to less than 29 minutes to avoid creating new visits
     */
    maxCaptureTime?: number;
    /**
     * Disable automatic detection of new page views (default: false)
     * Set to true if you track "virtual" page views for events/downloads
     */
    disableAutoDetectNewPageView?: boolean;
    /**
     * Custom trigger function to control when recording happens
     * Return true to record, false to skip
     * @param config - Configuration object with heatmap/session ID
     */
    trigger?: (config: {
        id?: number;
    }) => boolean;
    /**
     * Manually add heatmap/session configuration
     * Use this to manually configure specific heatmaps or sessions
     */
    addConfig?: {
        heatmap?: {
            id: number;
        };
        sessionRecording?: {
            id: number;
        };
    };
}
/**
 * Custom Dimensions object that can be passed as the last argument of many tracking calls
 * (action-scoped dimensions).
 *
 * Examples:
 * - `["trackEvent", "Video", "Play", "Intro", 42, { dimension1: "Premium" }]`
 * - `["trackSiteSearch", "keyword", "category", 12, { dimension4: "Test" }]`
 * - `["trackPageView", "My title", { dimension7: "Value" }]`
 *
 * Note: keys are expected to be `"dimension1"`, `"dimension2"`, etc.
 * We intentionally keep this type compatible with older TS/ESLint parsers.
 */
export type Dimensions = {
    dimension1?: string;
    dimension2?: string;
    dimension3?: string;
    dimension4?: string;
    dimension5?: string;
    dimension6?: string;
    dimension7?: string;
    dimension8?: string;
    dimension9?: string;
    dimension10?: string;
};
/**
 * A single value inside a Matomo command pushed to the queue.
 * Kept as a separate exported type for consumers that want to model custom commands.
 */
export type PushArg = string | number | boolean | null | undefined | Record<string, unknown> | readonly unknown[] | ((...args: any[]) => unknown);
/**
 * Strict Matomo `trackEvent` typing.
 *
 * Notes:
 * - `name` and `value` are optional
 * - `value` (when present) must be numeric
 * - `value` requires `name` to be provided (no "hole" argument)
 */
export type MatomoTrackEventCommand = readonly ["trackEvent", string, string] | readonly ["trackEvent", string, string, Dimensions] | readonly ["trackEvent", string, string, string] | readonly ["trackEvent", string, string, string, Dimensions] | readonly ["trackEvent", string, string, string, number] | readonly ["trackEvent", string, string, string, number, Dimensions];
/**
 * Core commands used by this library (and/or documented in docs).
 * This list is intentionally limited: any unknown command is still allowed via `MatomoCustomCommand`.
 */
export type MatomoCoreCommand = readonly ["trackPageView"] | readonly ["trackPageView", string] | readonly ["trackPageView", Dimensions] | readonly ["trackPageView", string, Dimensions] | readonly ["enableLinkTracking"] | readonly ["disableCookies"] | readonly ["setTrackerUrl", string] | readonly ["setSiteId", string] | readonly ["setReferrerUrl", string] | readonly ["setCustomUrl", string] | readonly ["deleteCustomVariables", string] | readonly ["setDocumentTitle", string] | readonly ["trackSiteSearch", string] | readonly ["trackSiteSearch", string, Dimensions] | readonly ["trackSiteSearch", string, string] | readonly ["trackSiteSearch", string, string, Dimensions] | readonly ["trackSiteSearch", string, string, number] | readonly ["trackSiteSearch", string, string, number, Dimensions] | readonly ["enableHeartBeatTimer"] | readonly ["enableHeartBeatTimer", number] | readonly ["setCustomDimension", number, string] | readonly ["trackGoal", number] | readonly ["trackGoal", number, Dimensions] | readonly ["trackGoal", number, number] | readonly ["trackGoal", number, number, Dimensions] | readonly ["trackLink", string, string] | readonly ["trackLink", string, string, Dimensions] | readonly ["setUserId", string];
/**
 * Heatmap & Session Recording plugin commands used by this library.
 */
export type HeatmapSessionRecordingCommand = readonly ["HeatmapSessionRecording::enableDebugMode"] | readonly ["HeatmapSessionRecording::disableCaptureKeystrokes"] | readonly ["HeatmapSessionRecording::disableRecordMovements"] | readonly ["HeatmapSessionRecording::setMaxCaptureTime", number] | readonly ["HeatmapSessionRecording::disableAutoDetectNewPageView"] | readonly [
    "HeatmapSessionRecording::setTrigger",
    NonNullable<HeatmapConfig["trigger"]>
] | readonly [
    "HeatmapSessionRecording::addConfig",
    NonNullable<HeatmapConfig["addConfig"]>
] | readonly ["HeatmapSessionRecording::enable"];
export type MatomoKnownCommand = MatomoTrackEventCommand | MatomoCoreCommand | HeatmapSessionRecordingCommand;
export type MatomoKnownCommandName = MatomoKnownCommand[0];
/**
 * Fallback for any command we don't type explicitly.
 *
 * Important: we exclude known command names so that if you use e.g. `"trackEvent"`,
 * TypeScript will enforce the strict signature from `MatomoTrackEventCommand`.
 *
 * This is also required for backward compatibility: consumers can push their own
 * custom commands (see tests using `onInitialization`, `onRouteChangeStart`, etc.).
 */
export type MatomoCustomCommand = readonly [
    Exclude<string, MatomoKnownCommandName>,
    ...PushArg[]
];
/**
 * Matomo also supports queueing functions executed once the tracker is ready.
 */
export type MatomoCallbackCommand = readonly [(...args: any[]) => unknown];
export type PushArgs = MatomoKnownCommand | MatomoCustomCommand | MatomoCallbackCommand;
export interface MatomoState {
    isInitialPageview: boolean;
    previousUrl: string;
    matomoInitialized: boolean;
}
//# sourceMappingURL=types.d.ts.map