import type { EventPayload } from './types';
export type ParseMapWebViewMessageFailure = {
    reason: 'invalid_json';
} | {
    reason: 'invalid_shape';
} | {
    reason: 'unknown_action';
    action: string;
};
export type ParseMapWebViewMessageResult = {
    ok: true;
    payload: EventPayload;
} | {
    ok: false;
    failure: ParseMapWebViewMessageFailure;
};
/**
 * Parses and validates JSON posted from the embedded Mechanic Map WebView.
 * Rejects malformed JSON, non-objects, and unknown `action` values.
 */
export declare function parseMapWebViewMessage(raw: string): ParseMapWebViewMessageResult;