/**
 * PrefabApp — Root application wrapper.
 *
 * Wraps a component tree with state, theme, defs, and key bindings.
 * Serializes to the $prefab wire format compatible with the Python version.
 */
import { type Component } from './core/component.js';
import type { ComponentJSON } from './core/component.js';
import type { Action, ActionJSON } from './actions/types.js';
import type { PipeFn } from './rx/pipes.js';
/** Package version — injected by build script, updated at release time. */
export declare const VERSION = "0.3.0";
/**
 * Wire protocol version emitted in `$prefab.version`.
 *
 * `0.3` matches upstream PrefectHQ/prefab: the theme is folded into the
 * `css` array, `stylesheets` carries external URLs, and `mode` forces a
 * color scheme (PR #431, "Wire Transfer"). The renderer still accepts `0.2`
 * payloads for backward compatibility.
 */
export declare const PROTOCOL_VERSION = "0.3";
export interface Theme {
    light?: Record<string, string>;
    dark?: Record<string, string>;
}
/** Forced color scheme for the renderer, independent of OS preference. */
export type ColorMode = 'light' | 'dark';
/** Declarative size hints for the host container (iframe, panel, etc.). */
export interface LayoutHints {
    /** Preferred height in pixels — host should allocate this before first paint. */
    preferredHeight?: number;
    /** Minimum usable height in pixels. */
    minHeight?: number;
    /** Maximum height in pixels — content scrolls beyond this. */
    maxHeight?: number;
}
export interface PrefabWireFormat {
    $prefab: {
        version: string;
    };
    view: ComponentJSON;
    state?: Record<string, unknown>;
    defs?: Record<string, ComponentJSON>;
    keyBindings?: Record<string, ActionJSON | ActionJSON[]>;
    onMount?: ActionJSON | ActionJSON[];
    /** Inline CSS blocks injected as `<style>` (protocol 0.3). Includes the compiled theme. */
    css?: string[];
    /** External CSS URLs loaded as `<link rel="stylesheet">` (protocol 0.3). */
    stylesheets?: string[];
    /** Forced color scheme, independent of OS preference (protocol 0.3). */
    mode?: ColorMode;
    /** Custom pipe source code — hydrated by the renderer on mount. */
    pipes?: Record<string, string>;
    /** Size hints for the host container. */
    layout?: LayoutHints;
}
export interface PrefabAppOptions {
    title?: string;
    view: Component;
    state?: Record<string, unknown>;
    theme?: Theme;
    defs?: Record<string, Component>;
    /** Inline CSS blocks injected as `<style>`. Merged after the compiled theme. */
    css?: string[];
    /** External CSS URLs loaded as `<link rel="stylesheet">`. */
    stylesheets?: string[];
    scripts?: string[];
    /** Forced color scheme, independent of OS preference. */
    mode?: ColorMode;
    onMount?: Action | Action[];
    keyBindings?: Record<string, Action | Action[]>;
    cssClass?: string;
    /** Custom pipes to serialize in the wire format. Functions are converted to source strings. */
    pipes?: Record<string, PipeFn>;
    /** Size hints for the host container. */
    layout?: LayoutHints;
}
export declare class PrefabApp {
    readonly title: string;
    readonly view: Component;
    readonly state?: Record<string, unknown>;
    readonly theme?: Theme;
    readonly defs?: Record<string, Component>;
    readonly css?: string[];
    readonly stylesheets?: string[];
    readonly scripts?: string[];
    readonly mode?: ColorMode;
    readonly onMount?: Action | Action[];
    readonly keyBindings?: Record<string, Action | Action[]>;
    readonly cssClass?: string;
    readonly pipes?: Record<string, PipeFn>;
    readonly layout?: LayoutHints;
    constructor(opts: PrefabAppOptions);
    /**
     * Serialize to the $prefab wire format (JSON).
     * This is what gets sent over MCP or stored as a resource.
     */
    toJSON(): PrefabWireFormat;
    /**
     * Serialize as a ready-to-return MCP tool result.
     *
     * Includes both `content` (LLM text fallback) and `structuredContent`
     * (forwarded to MCP Apps iframes via `ui/notifications/tool-result`).
     *
     * @example
     * ```ts
     * mcp.registerTool('browse', schema, async (args) => app.toMcpResult())
     * ```
     */
    toMcpResult(): {
        content: {
            type: 'text';
            text: string;
        }[];
        structuredContent: Record<string, unknown>;
    };
    /**
     * Serialize to a self-contained HTML page.
     * The page embeds the JSON wire format and a script tag
     * that loads the prefab renderer from a CDN.
     *
     * @param opts.includeStyles  Inject a `<link>` to the prefab base theme CSS
     *   from the CDN.  Defaults to `true`.  Set `false` to BYO CSS.
     */
    toHTML(opts?: {
        cdnVersion?: string;
        pretty?: boolean;
        includeStyles?: boolean;
    }): string;
}
//# sourceMappingURL=app.d.ts.map