/**
 * @nexart/ui-renderer - Preview Runtime Types
 * Version: 0.9.0
 *
 * ╔══════════════════════════════════════════════════════════════════════════╗
 * ║  PREVIEW RUNTIME — NON-AUTHORITATIVE                                     ║
 * ║                                                                          ║
 * ║  This renderer is a preview-only runtime.                                ║
 * ║  It does not guarantee determinism or protocol compliance.               ║
 * ║                                                                          ║
 * ║  For minting, export, or validation: use @nexart/codemode-sdk            ║
 * ╚══════════════════════════════════════════════════════════════════════════╝
 */
/**
 * Runtime profile - this renderer is preview-only.
 * Canonical execution remains SDK-only.
 */
export type RuntimeProfile = 'preview';
/**
 * FPS cap for preview rendering.
 * Replaced time/frame budget with simple FPS throttling for continuous animation.
 */
export declare const PREVIEW_FPS: {
    /** Target FPS for loop animations (lower = better performance) */
    readonly TARGET_FPS: 8;
    /** Minimum milliseconds between frames */
    readonly FRAME_INTERVAL_MS: 125;
};
/**
 * Canvas resolution limits.
 * Preview renderer does not render at full mint resolution.
 */
export declare const CANVAS_LIMITS: {
    /** Maximum dimension for preview canvas */
    readonly MAX_DIMENSION: 900;
    /** Minimum dimension */
    readonly MIN_DIMENSION: 100;
};
/**
 * Preview budget limits (v0.9.0)
 * Enforced optionally to prevent runaway previews.
 */
export declare const PREVIEW_BUDGET: {
    /** Maximum frames before budget exceeded (default: 1800) */
    readonly MAX_FRAMES: 1800;
    /** Maximum execution time in ms (default: 5 minutes) */
    readonly MAX_TOTAL_TIME_MS: 300000;
    /** Default stride when degrading (skip every N frames) */
    readonly DEGRADE_STRIDE: 2;
};
/**
 * Preview mode options
 */
export type PreviewMode = 'static' | 'loop';
/**
 * Budget exceed reason
 */
export type BudgetExceedReason = 'frame_limit' | 'time_limit';
/**
 * Budget exceeded info (passed to callbacks)
 */
export interface BudgetExceededInfo {
    reason: BudgetExceedReason;
    framesRendered: number;
    totalTimeMs: number;
    stride: number;
    scale: number;
}
/**
 * Budget behavior options
 */
export type BudgetBehavior = 'degrade' | 'stop';
/**
 * Preview engine configuration (v0.9.0)
 */
export interface PreviewEngineConfig {
    /** Canvas element to render to */
    canvas: HTMLCanvasElement;
    /** Source code to execute */
    source: string;
    /** Preview mode */
    mode: PreviewMode;
    /** Original width (will be scaled down) */
    width: number;
    /** Original height (will be scaled down) */
    height: number;
    /** Random seed for deterministic preview */
    seed?: number;
    /** VAR array (0-10 elements, 0-100 range) */
    vars?: number[];
    /** Total frames for loop mode (for t calculation) */
    totalFrames?: number;
    /** Callback when budget is exceeded */
    onBudgetExceeded?: (info: BudgetExceededInfo) => void;
    /** Behavior when budget exceeded: 'degrade' (skip frames) or 'stop' (halt + overlay) */
    budgetBehavior?: BudgetBehavior;
    /** Show overlay when budget exceeded (default: true for 'stop' behavior) */
    showOverlay?: boolean;
    /** Maximum frames before budget exceeded (default: 1800) */
    maxFrames?: number;
    /** Maximum execution time in ms (default: 300000) */
    maxTimeMs?: number;
}
/**
 * Preview stats (v0.9.0)
 * Exposes runtime state for observability.
 */
export interface PreviewStats {
    mode: 'preview';
    scale: number;
    semanticWidth: number;
    semanticHeight: number;
    bufferWidth: number;
    bufferHeight: number;
    frames: number;
    stride: number;
    totalTimeMs: number;
    budgetExceeded?: {
        reason: BudgetExceedReason;
    };
}
/**
 * Preview render result
 */
export interface PreviewRenderResult {
    /** Whether rendering completed successfully */
    success: boolean;
    /** Frames rendered */
    framesRendered: number;
    /** Total execution time in ms */
    executionTimeMs: number;
    /** Whether execution was terminated early due to limits */
    terminatedEarly: boolean;
    /** Termination reason if applicable */
    terminationReason?: 'frame_limit' | 'time_limit' | 'user_stop' | 'error';
    /** Error message if any (non-throwing) */
    errorMessage?: string;
}
/**
 * Preview renderer interface (v0.9.0)
 */
export interface PreviewRenderer {
    /** Render a single frame (static mode) */
    renderStatic: () => PreviewRenderResult;
    /** Start loop rendering */
    startLoop: () => void;
    /** Stop loop rendering */
    stopLoop: () => void;
    /** Destroy renderer and clean up */
    destroy: () => void;
    /** Check if currently rendering */
    isRendering: () => boolean;
    /** Get current preview stats (v0.9.0) */
    getPreviewStats: () => PreviewStats;
    /** Current scale factor (v0.9.0) */
    readonly previewScale: number;
    /** This renderer is NOT canonical */
    readonly isCanonical: false;
    /** This renderer is NOT archival */
    readonly isArchival: false;
}
/**
 * FPS throttle state for continuous animation
 */
export interface FpsThrottleState {
    /** Timestamp of last rendered frame */
    lastFrameTimeMs: number;
}
/**
 * Canonical request for handoff to @nexart/codemode-sdk (v0.9.0)
 */
export interface CanonicalRequest {
    seed: number;
    vars: number[];
    code: string;
    settings?: {
        width: number;
        height: number;
        mode: PreviewMode;
        totalFrames?: number;
    };
    renderer: 'preview';
    uiRendererVersion: string;
}
//# sourceMappingURL=preview-types.d.ts.map