import type { ActionResultInput, ScreenTreeInput, SurfaceDefinition } from './schema.js';
export type ScreenParams = Record<string, string>;
export type LoadHandler<Ctx> = (ctx: Ctx, params: ScreenParams) => ScreenTreeInput | Promise<ScreenTreeInput>;
export type ActionHandler<Ctx> = (ctx: Ctx, input: Record<string, unknown>, params: ScreenParams) => ActionResultInput | Promise<ActionResultInput>;
export interface ScreenDefinition<Ctx = unknown> {
    load: LoadHandler<Ctx>;
    actions?: Record<string, ActionHandler<Ctx>>;
}
/**
 * Identity function (the defineProvider pattern): exists for inference and
 * cheap authoring-time validation, not runtime behavior.
 */
export declare function defineScreen<Ctx = unknown>(screen: ScreenDefinition<Ctx>): ScreenDefinition<Ctx>;
/** Define surface metadata. The filesystem supplies its key, root screen, and child ownership. */
export declare function defineSurface(surface: SurfaceDefinition): SurfaceDefinition;