import { type PreviewScrollPosition } from './previewScroll.js';
import type { DesignScreenInteraction } from './designImport.js';
export interface PreparedShadowPreview {
    bodyHtml: string;
    sharedCssText: string;
    stylesheetLinksHtml: string;
    /** Size-dependent `<style media>` the preview could not scope to the frame. */
    mediaIssues?: string[];
}
export interface ShadowPreviewMountInput {
    /** Local viewer positions applied after the authored recipe, never serialized. */
    scrollPositions?: readonly PreviewScrollPosition[];
    /** A complete script-less document snapshot. */
    snapshot?: string;
    /** A body fragment to use instead of a complete snapshot. */
    bodyHtml?: string;
    /** Common CSS that is pooled with styles extracted from the snapshot. */
    sharedCssText?: string;
    /** Content-addressed styles attached independently without frame-level concatenation. */
    sharedStylesheets?: readonly {
        key: string;
        cssText: string;
    }[];
    /** Serialized document attributes used by compact body-only artifacts. */
    htmlAttributes?: string;
    bodyAttributes?: string;
    /** External stylesheet links retained by compact body-only artifacts. */
    stylesheetLinksHtml?: string;
    /** An optional verified cache identity for sharedCssText. */
    sharedCssHash?: string;
    /** A stable channel shared by related previews. */
    overrideKey?: string;
    /** CSS that can change without rebuilding or parsing the common stylesheet. */
    overrideCssText?: string;
    /** Resolves relative element and CSS resource URLs. */
    baseUrl?: string;
    /** Recipe whose terminal pseudo gestures must remain visible in frozen DOM. */
    interactions?: readonly DesignScreenInteraction[];
}
export interface ShadowPreviewHandle {
    readonly root: ShadowRoot;
    readonly contentElement: HTMLElement;
    readonly sharedCssHash: string;
    readonly overrideKey: string;
    /** Held pseudo, scroll and size-media conditions the frozen document could not reproduce. */
    readonly heldPseudoIssues: readonly string[];
    /** Rebuilds held pseudo rules from external stylesheets after their links load. */
    refreshLinkedHeldPseudoCss(): void;
    /** Reapplies deterministic scroll endpoints after frozen layout settles. */
    restoreScrollInteractions(): readonly string[];
    /**
     * Holds every animation at its capture baseline: finite motion at its end,
     * repeating motion at the start of its cycle. The frozen preview is a still
     * image; a running screen is what a live frame is for.
     */
    settleMotion(): void;
    updateBodyHtml(bodyHtml: string, baseUrl?: string): void;
    updateOverrideCss(cssText: string): void;
    updateSharedCss(cssText: string): void;
    teardown(): void;
}
export interface ShadowDomMutation {
    key: string;
    selector: string;
    text?: string;
    textNodeOrdinal?: number;
    hidden?: boolean;
    attributes?: Record<string, string | null>;
    replaceChildrenHtml?: string;
    staleReason?: string;
}
export interface ShadowDomMutationResult {
    cleanup(): void;
    issues: string[];
}
interface AcquiredStyle {
    release(): void;
}
/** A deterministic content hash suitable for in-memory stylesheet pooling. */
export declare function hashShadowPreviewCss(cssText: string): string;
/** Rejects active content before it reaches a live document or ShadowRoot. */
export declare function assertSafeShadowPreviewMarkup(markup: string): void;
/**
 * Splits a safe document snapshot into the lightweight parts needed by a
 * ShadowRoot. Inline styles become one pooled stylesheet instead of being
 * repeated in every preview.
 */
export declare function prepareShadowPreview(input: Pick<ShadowPreviewMountInput, 'snapshot' | 'bodyHtml' | 'sharedCssText'>): PreparedShadowPreview;
/** Resolves CSS url() and @import references without touching data/blob/hash URLs. */
export declare function rebaseShadowPreviewCss(cssText: string, baseUrl: string | undefined): string;
/**
 * Prepares captured CSS for a shadow root: `:root` becomes the document root,
 * relative URLs resolve against the screen, and viewport units and size media
 * queries answer to the frame instead of the editor window. `issues` lists the
 * size-dependent media that had to stay as written.
 */
export declare function scopeShadowPreviewCss(cssText: string, baseUrl: string | undefined): {
    cssText: string;
    issues: string[];
};
/**
 * Applies serializable DOM edits to a frozen preview. The returned cleanup
 * restores the exact previous DOM state in reverse mutation order.
 */
export declare function applyShadowDomMutations(root: ParentNode, mutations: readonly ShadowDomMutation[], options?: {
    baseUrl?: string;
}): ShadowDomMutationResult;
/**
 * Owns content-addressed common styles and mutable override channels.
 * Constructable stylesheets are shared by reference. Browsers without them
 * receive one synchronized style element per mounted root.
 */
export declare class ShadowPreviewStylePool {
    private readonly sharedStyles;
    private readonly overrideStyles;
    private acquire;
    private replaceEntryText;
    acquireShared(root: ShadowRoot, hash: string, cssText: string): AcquiredStyle;
    acquireSharedMany(root: ShadowRoot, styles: readonly {
        key: string;
        cssText: string;
    }[]): AcquiredStyle;
    acquireOverride(root: ShadowRoot, key: string, cssText: string): AcquiredStyle;
    /** Updates every root using this shared style without rebuilding its DOM. */
    updateSharedCss(hash: string, cssText: string): boolean;
    /** Updates every mounted preview subscribed to the same override channel. */
    updateOverrideCss(key: string, cssText: string): boolean;
    dispose(): void;
}
export declare const defaultShadowPreviewStylePool: ShadowPreviewStylePool;
/** Mounts a script-less, non-interactive preview with pooled common styles. */
export declare function mountFrozenShadowPreview(host: HTMLElement, input: ShadowPreviewMountInput, stylePool?: ShadowPreviewStylePool): ShadowPreviewHandle;
export {};