/**
 * Vite transformIndexHtml() hook
 *
 * Injects a PostHog session replay snippet into game HTML at build time.
 * This enables cross-origin iframe recording: the game iframe's PostHog
 * instance posts its recording data (DOM snapshots, console logs, network
 * requests) to the parent platform's PostHog instance, producing a single
 * unified session replay.
 *
 * The snippet loads before any game JS, so it captures the full boot
 * sequence including asset downloads and JS parse/execute timing — even
 * if the game bundle never finishes loading.
 *
 * Uses a named instance to avoid conflicting with any PostHog instance
 * a game developer may have initialized on the default `window.posthog`.
 *
 * Only injected in production builds.
 */
import type { HtmlTagDescriptor } from 'vite';
import type { PluginContext } from '../types';
/**
 * Transform index.html to inject PostHog cross-origin iframe recording.
 *
 * Returns an array of HTML tag descriptors that Vite injects into the
 * built HTML. The script is placed in `<head>` so it loads before any
 * game scripts in `<body>`.
 *
 * Skipped when running the dev server (not a production build).
 */
export declare function transformIndexHtmlHook(context: PluginContext): HtmlTagDescriptor[] | undefined;
