/**
 * Client Effect Handlers Factory
 *
 * Creates the standard effect handler set for client-side trait execution.
 *
 * @packageDocumentation
 */
import type { EventPayload, ServiceParams } from '@almadar/core';
import type { EffectHandlers } from '@almadar/runtime';
export interface ClientEventBus {
    emit: (type: string, payload?: EventPayload) => void;
}
export interface SlotSetter {
    addPattern: (slot: string, pattern: unknown, props?: Record<string, unknown>) => void;
    clearSlot: (slot: string) => void;
}
export interface CreateClientEffectHandlersOptions {
    eventBus: ClientEventBus;
    slotSetter: SlotSetter;
    navigate?: (path: string, params?: Record<string, unknown>) => void;
    notify?: (message: string, type: 'success' | 'error' | 'warning' | 'info') => void;
    /**
     * Optional consumer-supplied call-service handler. When set, it runs
     * instead of the default mock fallback — use to wire the playground
     * to real backends. When omitted, `callService` returns a synthetic
     * mock result so service-atom chains advance end-to-end in offline /
     * standalone-preview mode (see OrbitalServerRuntime's mock parallel).
     */
    callService?: (service: string, action: string, params?: ServiceParams) => Promise<unknown>;
}
export declare function createClientEffectHandlers(options: CreateClientEffectHandlersOptions): EffectHandlers;
