import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';export type LyraZoomableFrameLoading='eager'|'lazy';export interface LyraZoomableFrameEventMap{load:Event;error:Event;blur:FocusEvent;focus:FocusEvent;}
/**
* `<lr-zoomable-frame>` — a sandboxed iframe preview with discrete zoom controls. Its public
* surface mirrors Web Awesome's `wa-zoomable-frame`; Lyra's former slotted/image inspection
* surface now lives at `<lr-pan-zoom>`.
*
* Security defaults are deliberately restrictive: iframe navigation accepts only relative,
* `http:`, `https:`, `blob:`, and exact `about:blank` URLs; the iframe always carries a sandbox; and the default
* `allow-same-origin` token supports same-origin `contentDocument`/theme synchronization while
* scripts, forms, popups, downloads, and top navigation remain blocked. Consumer-provided sandbox
* tokens are allowlisted, and `allow-scripts` is never combined with `allow-same-origin`.
*
* The scaled iframe is a physical pixel canvas, so its origin stays at physical top-left in both
* directions. The zoom-control group remains logical interface chrome and therefore appears at
* inline-end (physical left in RTL). Its two native buttons remain independent Tab stops; the
* group does not claim the roving-arrow-key contract of an ARIA toolbar.
* `withoutInteraction` makes the browsing context genuinely unavailable: the iframe is native
* `inert`, leaves sequential focus, refuses pointer and programmatic activation, and carries no
* unsupported `aria-disabled` claim. Focus entry through Tab, pointer, or `focus()` is tracked on
* the host as `data-frame-focused` so the shared focus ring remains visible across the browsing-
* context boundary. Zoom-control focus does not enter that browsing context; transitions between
* a zoom control and the iframe retain one balanced native focus/blur relay pair.
*
* @customElement lr-zoomable-frame
* @slot zoom-in-icon - Override for the decorative zoom-in glyph. Its flattened subtree is inert
*   and hidden from assistive technology; the native zoom-in button remains the sole action.
* @slot zoom-out-icon - Override for the decorative zoom-out glyph. Its flattened subtree is inert
*   and hidden from assistive technology; the native zoom-out button remains the sole action.
* @event load - Relayed native iframe load event; non-bubbling and non-composed.
* @event error - Relayed native iframe error event; non-bubbling and non-composed.
* @event {FocusEvent} focus - Relayed once from the internal iframe as a bubbling, composed native
*   event.
* @event {FocusEvent} blur - Relayed once from the internal iframe as a bubbling, composed native
*   event.
* @csspart iframe - The internal `<iframe>` element.
* @csspart controls - The labelled zoom-control group.
* @csspart zoom-in-button - The zoom-in button.
* @csspart zoom-out-button - The zoom-out button.
* @cssprop [--lr-zoomable-frame-control-hover-background=var(--lr-color-brand-quiet)] - Zoom
*   control hover background; its active background derives from the same value.
* @cssprop [--lr-zoomable-frame-zoom=1] - Read-only resolved iframe scale written from `zoom`.
* @status stable
* @since 4.0.0
*/
export declare class LyraZoomableFrame extends LyraElement<LyraZoomableFrameEventMap>{static styles:import("lit").CSSResultGroup[];
/** The URL of the content to display. Active/non-embeddable schemes are rejected. */
src:string;
/** Inline HTML to display. A present `srcdoc` wins over `src`, including an empty attribute. */
srcdoc:string;
/** Forwards the native fullscreen opt-in to the iframe. */
allowfullscreen:boolean;
/** Controls native iframe loading behavior. Invalid runtime values fall back to `eager`. */
loading:LyraZoomableFrameLoading;
/** Native iframe referrer policy. Invalid non-empty values fail closed to `no-referrer`. */
referrerpolicy:string;
/** Iframe sandbox tokens. The attribute is always rendered; the script/same-origin pair is
* narrowed to scripts in a unique origin. */
sandbox:string;
/** Current iframe scale. Programmatic values need not appear in `zoomLevels`. */
zoom:number;
/** Space-separated decimal and percentage stops used only by `zoomIn()`/`zoomOut()`. The
* normalized projection reads at most 16,384 UTF-16 code units and 256 whitespace-delimited
* tokens, ignores a token cut by the source ceiling, and is cached until this string changes. */
zoomLevels:string;
/** Removes the zoom-control group. */
withoutControls:boolean;
/** Removes the iframe from sequential focus and disables pointer interaction. */
withoutInteraction:boolean;
/** Best-effort sync of Lyra theme classes, attributes, and `--lr-theme-*` values into a
* same-origin iframe document. Turning it off restores only the iframe state this component
* changed; cross-origin access remains untouched. */
withThemeSync:boolean;
/** Accessible-name input. A declarative `aria-label` remains on the host while the iframe keeps
* a localized purpose title; a property-only value names the iframe. An explicitly empty host
* name is preserved as an empty iframe title instead of being replaced through truthiness. */
accessibleLabel:string|null;
/** The internal iframe; replaced whenever navigation policy changes. An explicit `get` (rather
*  than `@query`) so the generated manifest marks it readonly, not merely by convention. */
get iframe():HTMLIFrameElement|undefined;private cachedZoomLevelsSource;private cachedZoomLevels;
/** Focus the internal iframe when interaction is enabled and a live frame is connected. */
focus(options?:FocusOptions):void;
/** Blur the internal iframe. Does not blur a focused zoom control. */
blur():void;
/** Activate the internal iframe only while interaction is enabled. */
click():void;
/** Whether a host-level `focus` has been emitted without a matching `blur` yet. Guarantees the
*  re-dispatched pair stays balanced when both the native listener and the overridden method fire
*  for one focus change (Chromium/WebKit) and when only one of them does (Firefox). */
private hasEmittedFocus;private frameIsActive;private frameOwnsFocus;private setFrameFocused;private dispatchHostFocusEvent;private emitHostFocus;private emitHostBlur;private onFrameFocus;private onFrameBlur;private focusReconciliationGeneration;private scheduleFrameFocusReconciliation;private focusBoundaryDocument?;private onFocusBoundaryKeyDown;private resetFocusBoundaryDocument;private bindFocusBoundaryDocument;private navigationGeneration;private needsReconnectFrame;private syncedThemeClasses;private syncedThemeProperties;private themeSyncState?;private lyraThemeObserver?;constructor();connectedCallback():void;disconnectedCallback():void;attributeChangedCallback(name:string,oldValue:string|null,value:string|null):void;protected willUpdate(changed:PropertyValues<this>):void;protected updated(changed:PropertyValues<this>):void;
/** Returns the current iframe window while connected. Cross-origin windows are still opaque. */
get contentWindow():Window|null;
/** Returns the current same-origin iframe document, or `null` when detached/cross-origin. */
get contentDocument():Document|null;private get safeZoom();private get availableZoomLevels();private get hasInlineDocument();private get hasNavigation();private navigationSignature;
/** Zooms to the smallest configured stop above the current programmatic value. */
zoomIn():void;
/** Zooms to the largest configured stop below the current programmatic value. */
zoomOut():void;private isZoomInDisabled;private isZoomOutDisabled;private onControlsKeyDown;private dispatchFrameEvent;private onFrameEvent;private syncTheme;private themeStateFor;private setSyncedThemeClass;private setSyncedThemeAttribute;private setSyncedThemeProperty;private restoreTheme;private resetThemeSyncState;private renderControls;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-zoomable-frame':LyraZoomableFrame;}}