chain-functions-behavior 1.0.0 → 1.0.1

package/dist/index.d.cts

@@ -0,0 +1,334 @@
+type BehaviorInput = Record<string, unknown>;
+type BehaviorProps = Record<string, unknown>;
+type BehaviorConfig = {
+    version?: 1;
+    strategies: Record<string, BehaviorStrategy>;
+    entrypoints?: Record<string, string>;
+};
+type BehaviorStrategy = {
+    fn: string;
+    props?: BehaviorProps;
+    when?: BehaviorConditionExpression;
+    then?: BehaviorNext[];
+    catch?: BehaviorNext[];
+    mode?: BehaviorMode;
+    terminal?: boolean;
+    tags?: string[];
+    description?: string;
+};
+type BehaviorMode = 'sequence' | 'selector' | 'parallel';
+type BehaviorNext = string | {
+    id?: string;
+    strategy: string;
+    props?: BehaviorProps;
+    when?: BehaviorConditionExpression;
+};
+type BehaviorConditionExpression = boolean | [operator: string, ...args: unknown[]];
+type BehaviorAction<TContext, TPatch = unknown> = (args: BehaviorActionArgs<TContext>) => BehaviorActionResult<TContext, TPatch> | Promise<BehaviorActionResult<TContext, TPatch>>;
+type BehaviorActionArgs<TContext> = {
+    context: TContext;
+    props: BehaviorProps;
+    input: BehaviorInput;
+    signal: AbortSignal;
+    runtime: BehaviorRuntime;
+};
+type BehaviorActionResult<TContext, TPatch = unknown> = void | false | BehaviorActionSuccess<TContext, TPatch> | BehaviorActionSkip | BehaviorActionStop<TPatch> | BehaviorActionFail;
+type BehaviorActionSuccess<TContext, TPatch> = {
+    type?: 'success';
+    context?: TContext;
+    data?: Record<string, unknown>;
+    patch?: TPatch | TPatch[];
+    events?: BehaviorEvent[];
+    continue?: boolean;
+};
+type BehaviorActionSkip = {
+    type: 'skip';
+    reason?: string;
+    data?: Record<string, unknown>;
+};
+type BehaviorActionStop<TPatch> = {
+    type: 'stop';
+    reason?: string;
+    patch?: TPatch | TPatch[];
+    events?: BehaviorEvent[];
+};
+type BehaviorActionFail = {
+    type: 'fail';
+    reason?: string;
+    error?: unknown;
+    data?: Record<string, unknown>;
+};
+type BehaviorEvent = {
+    type: string;
+    payload?: unknown;
+};
+type BehaviorEventMap = Record<string, unknown>;
+type BehaviorEventName<TEvents extends object> = Extract<keyof TEvents, string>;
+type BehaviorBusEvent<TPayload = unknown> = {
+    id: string;
+    topic: string;
+    occurredAt: number;
+    origin?: string;
+    parsed: TPayload;
+    serialized: string;
+};
+type BehaviorEventHandler<TEvents extends object, TEvent extends BehaviorEventName<TEvents>> = (event: BehaviorBusEvent<TEvents[TEvent]>) => void;
+type BehaviorBusErrorEvent<TEvents extends object> = {
+    type: 'serialization';
+    topic: BehaviorEventName<TEvents>;
+    payload: TEvents[BehaviorEventName<TEvents>];
+    origin?: string;
+    error: unknown;
+} | {
+    type: 'subscriber';
+    event: BehaviorBusEvent<TEvents[BehaviorEventName<TEvents>]>;
+    error: unknown;
+};
+type BehaviorBusEmitOptions = {
+    origin?: string;
+};
+type BehaviorBusOptions<TEvents extends object> = {
+    onError?: (event: BehaviorBusErrorEvent<TEvents>) => void;
+};
+type BehaviorBus<TEvents extends object = BehaviorEventMap> = {
+    on<TEvent extends BehaviorEventName<TEvents>>(event: TEvent, handler: BehaviorEventHandler<TEvents, TEvent>): () => void;
+    off<TEvent extends BehaviorEventName<TEvents>>(event: TEvent, handler?: BehaviorEventHandler<TEvents, TEvent>): void;
+    emit<TEvent extends BehaviorEventName<TEvents>>(topic: TEvent, payload: TEvents[TEvent], options?: BehaviorBusEmitOptions): BehaviorBusEvent<TEvents[TEvent]>;
+    dispatch(event: unknown): BehaviorBusEvent | undefined;
+};
+type BehaviorWsSocket = {
+    readyState: number;
+    send(data: string): void;
+    close(): void;
+    addEventListener(type: 'open' | 'close' | 'error' | 'message', listener: EventListener): void;
+    removeEventListener(type: 'open' | 'close' | 'error' | 'message', listener: EventListener): void;
+};
+type BehaviorWsRetryOptions = {
+    initialDelay?: number;
+    maxDelay?: number;
+    multiplier?: number;
+    jitter?: boolean;
+};
+type BehaviorWsOptions<TEvents extends object = BehaviorEventMap> = {
+    bus: BehaviorBus<TEvents>;
+    createSocket: () => BehaviorWsSocket;
+    inboundTopics?: BehaviorEventName<TEvents>[];
+    outboundTopics?: BehaviorEventName<TEvents>[];
+    origin?: string;
+    retry?: BehaviorWsRetryOptions;
+};
+type BehaviorWsStatus = 'idle' | 'connecting' | 'connected' | 'retrying' | 'stopped';
+type BehaviorWs = {
+    start(): void;
+    stop(): void;
+    reconnect(): void;
+    status(): BehaviorWsStatus;
+};
+type BehaviorBindingEventMap = Record<string, BehaviorInput>;
+type BehaviorBusBindingKey<TEvents extends object> = {
+    [TEvent in BehaviorEventName<TEvents>]: TEvents[TEvent] extends BehaviorInput ? `[bus] ${TEvent}` : never;
+}[BehaviorEventName<TEvents>];
+type BehaviorConcurrencyMode = 'parallel' | 'latest' | 'queue' | 'drop';
+type BehaviorQueueOverflow = 'drop-oldest' | 'drop-newest';
+type BehaviorConcurrencyOptions<TPayload = BehaviorInput> = {
+    mode?: BehaviorConcurrencyMode;
+    key?: (payload: TPayload) => string;
+    maxQueueSize?: number;
+    overflow?: BehaviorQueueOverflow;
+};
+type BehaviorBusBinding<TPayload = BehaviorInput> = {
+    entrypoint: string;
+    options?: {
+        concurrency?: BehaviorConcurrencyOptions<TPayload>;
+    };
+};
+type BehaviorBusBindings<TEvents extends object> = {
+    [TBinding in BehaviorBusBindingKey<TEvents>]?: BehaviorBusBinding<TEvents[Extract<TBinding extends `[bus] ${infer TEvent}` ? TEvent : never, BehaviorEventName<TEvents>>]>;
+};
+type BehaviorDomBindingKey = `[dom] ${string}:${string}`;
+type BehaviorDomForm = Record<string, FormDataEntryValue | FormDataEntryValue[]>;
+type BehaviorDomInput = BehaviorInput & {
+    type: string;
+    value?: string;
+    dataset: Record<string, string>;
+    form?: BehaviorDomForm;
+};
+type BehaviorDomBinding = {
+    entrypoint: string;
+    options?: {
+        preventDefault?: boolean;
+        stopPropagation?: boolean;
+        capture?: boolean;
+        once?: boolean;
+        input?: (scope: {
+            event: Event;
+            element: Element;
+            defaultInput: BehaviorDomInput;
+        }) => BehaviorInput;
+        concurrency?: BehaviorConcurrencyOptions<BehaviorDomInput>;
+    };
+};
+type BehaviorDomBindings = Partial<Record<BehaviorDomBindingKey, BehaviorDomBinding>>;
+type ChainBehaviorDefinition<TContext, TPatch = unknown, TEvents extends object = BehaviorBindingEventMap> = {
+    config: BehaviorConfig;
+    actions?: Record<string, BehaviorAction<TContext, TPatch>>;
+    conditions?: Record<string, BehaviorConditionFn<TContext>>;
+    events?: BehaviorBusBindings<TEvents> & BehaviorDomBindings;
+};
+type ChainBehaviorOptions<TContext, TPatch = unknown, TEvents extends object = BehaviorBindingEventMap> = BehaviorRunnerOptions<TContext, TPatch> & {
+    context: TContext | (() => TContext);
+    bus?: BehaviorBus<TEvents>;
+    root?: Document | Element;
+    concurrency?: BehaviorConcurrencyOptions;
+    onRunnerError?: (event: BehaviorRunnerErrorEvent<TContext, TPatch>) => void;
+};
+type BehaviorRunnerErrorEvent<TContext, TPatch = unknown> = {
+    error: BehaviorError;
+    result: BehaviorRunResult<TContext, TPatch>;
+    binding: string;
+    entrypoint: string;
+    runId: string;
+    key?: string;
+};
+type BehaviorInactiveBinding = {
+    binding: string;
+    reason: 'unsupported-source' | 'dom-unavailable';
+};
+type BehaviorStartResult = {
+    active: string[];
+    inactive: BehaviorInactiveBinding[];
+    validation: BehaviorValidationResult;
+};
+type ChainBehavior<TContext, TPatch = unknown> = {
+    runner: BehaviorRunner<TContext, TPatch>;
+    start(): BehaviorStartResult;
+    stop(options?: {
+        force?: boolean;
+    }): void;
+};
+type BehaviorRunResult<TContext, TPatch = unknown> = {
+    status: 'success' | 'stopped' | 'failed' | 'skipped';
+    context: TContext;
+    data: Record<string, unknown>;
+    patches: TPatch[];
+    events: BehaviorEvent[];
+    error?: BehaviorError;
+    trace?: BehaviorTraceEntry[];
+    steps: number;
+};
+type BehaviorRuntime = {
+    get(path: string): unknown;
+    getData(path: string): unknown;
+    setData(path: string, value: unknown): void;
+    resolve(value: unknown): unknown;
+    signal: AbortSignal;
+    emit(event: BehaviorEvent): void;
+    patch(patch: unknown): void;
+    stop(reason?: string): BehaviorActionStop<unknown>;
+    fail(reason?: string, data?: Record<string, unknown>): BehaviorActionFail;
+};
+type BehaviorRunnerOptions<TContext, TPatch> = {
+    maxSteps?: number;
+    maxDepth?: number;
+    timeoutMs?: number;
+    trace?: boolean | BehaviorTraceSink;
+    onError?: BehaviorErrorReporter<TContext, TPatch>;
+    mergeData?: (current: Record<string, unknown>, next: Record<string, unknown>) => Record<string, unknown>;
+};
+type BehaviorRunOptions = {
+    signal?: AbortSignal;
+};
+type BehaviorTraceSink = {
+    push(entry: BehaviorTraceEntry): void;
+    entries?(): BehaviorTraceEntry[];
+};
+type BehaviorTraceEntry = {
+    step: number;
+    depth: number;
+    strategy: string;
+    fn: string;
+    mode: BehaviorMode | undefined;
+    status: 'matched' | 'skipped' | 'success' | 'stopped' | 'failed';
+    input: BehaviorInput;
+    props: BehaviorProps;
+    dataBefore: Record<string, unknown>;
+    dataAfter: Record<string, unknown>;
+    durationMs: number;
+    reason?: string;
+};
+type BehaviorError = {
+    code: string;
+    message: string;
+    strategy?: string;
+    fn?: string;
+    stage?: BehaviorErrorStage;
+    cause?: unknown;
+};
+type BehaviorErrorStage = {
+    phase: 'entrypoint' | 'condition' | 'action' | 'catch' | 'limit';
+    entrypoint?: string | undefined;
+    strategy?: string | undefined;
+    fn?: string | undefined;
+    mode?: BehaviorMode | undefined;
+    step?: number | undefined;
+    depth?: number | undefined;
+};
+type BehaviorErrorEvent<TContext, TPatch = unknown> = {
+    error: BehaviorError;
+    context: TContext;
+    input: BehaviorInput;
+    data: Record<string, unknown>;
+    patches: TPatch[];
+    events: BehaviorEvent[];
+    trace?: BehaviorTraceEntry[];
+};
+type BehaviorErrorReporter<TContext, TPatch = unknown> = (event: BehaviorErrorEvent<TContext, TPatch>) => void;
+type BehaviorErrorReporterHandlers<TContext, TPatch = unknown> = {
+    report: BehaviorErrorReporter<TContext, TPatch>;
+};
+type BehaviorValidationResult = {
+    ok: boolean;
+    errors: BehaviorValidationIssue[];
+    warnings: BehaviorValidationIssue[];
+};
+type BehaviorValidationIssue = {
+    code: string;
+    message: string;
+    path?: string;
+    strategy?: string;
+};
+type BehaviorConditionFn<TContext> = (context: {
+    context: TContext;
+    input: BehaviorInput;
+    data: Record<string, unknown>;
+    runtime: Pick<BehaviorRuntime, 'resolve' | 'get' | 'getData'>;
+}, ...conditionArgs: unknown[]) => boolean;
+type BehaviorRunner<TContext, TPatch = unknown> = {
+    registerAction(name: string, action: BehaviorAction<TContext, TPatch>): void;
+    registerActions(actions: Record<string, BehaviorAction<TContext, TPatch>>): void;
+    registerCondition(name: string, condition: BehaviorConditionFn<TContext>): void;
+    registerConditions(conditions: Record<string, BehaviorConditionFn<TContext>>): void;
+    loadConfig(config: BehaviorConfig): BehaviorValidationResult;
+    validateConfig(config?: BehaviorConfig): BehaviorValidationResult;
+    run(entrypoint: string, context: TContext, input?: BehaviorInput, options?: BehaviorRunOptions): Promise<BehaviorRunResult<TContext, TPatch>>;
+    runSync(entrypoint: string, context: TContext, input?: BehaviorInput, options?: BehaviorRunOptions): BehaviorRunResult<TContext, TPatch>;
+};
+
+declare const defineBehaviorConfig: <TConfig extends BehaviorConfig>(config: TConfig) => TConfig;
+
+declare const createBehaviorRunner: <TContext, TPatch = unknown>(options?: BehaviorRunnerOptions<TContext, TPatch>) => BehaviorRunner<TContext, TPatch>;
+
+declare const createMemoryTraceSink: () => BehaviorTraceSink;
+
+declare const defineErrorReporter: <TContext, TPatch = unknown>(handlers: BehaviorErrorReporterHandlers<TContext, TPatch> | BehaviorErrorReporter<TContext, TPatch>) => BehaviorErrorReporter<TContext, TPatch>;
+
+declare const createPubSubBehavior: <TEvents extends object = BehaviorEventMap>(options?: BehaviorBusOptions<TEvents>) => BehaviorBus<TEvents>;
+declare const PubSubBehavior: BehaviorBus<BehaviorEventMap>;
+
+declare const createChainBehavior: <TContext, TPatch = unknown, TEvents extends object = BehaviorBindingEventMap>(definition: ChainBehaviorDefinition<TContext, TPatch, TEvents>, options: ChainBehaviorOptions<TContext, TPatch, TEvents>) => ChainBehavior<TContext, TPatch>;
+
+declare const createBehaviorWs: <TEvents extends object = BehaviorEventMap>(options: BehaviorWsOptions<TEvents>) => BehaviorWs;
+
+declare const catchError: <T>(callback: () => T | PromiseLike<T>) => Promise<T>;
+
+export { type BehaviorAction, type BehaviorActionArgs, type BehaviorActionFail, type BehaviorActionResult, type BehaviorActionSkip, type BehaviorActionStop, type BehaviorActionSuccess, type BehaviorBindingEventMap, type BehaviorBus, type BehaviorBusBinding, type BehaviorBusBindingKey, type BehaviorBusBindings, type BehaviorBusEmitOptions, type BehaviorBusErrorEvent, type BehaviorBusEvent, type BehaviorBusOptions, type BehaviorConcurrencyMode, type BehaviorConcurrencyOptions, type BehaviorConditionExpression, type BehaviorConditionFn, type BehaviorConfig, type BehaviorDomBinding, type BehaviorDomBindingKey, type BehaviorDomBindings, type BehaviorDomForm, type BehaviorDomInput, type BehaviorError, type BehaviorErrorEvent, type BehaviorErrorReporter, type BehaviorErrorReporterHandlers, type BehaviorErrorStage, type BehaviorEvent, type BehaviorEventHandler, type BehaviorEventMap, type BehaviorEventName, type BehaviorInactiveBinding, type BehaviorInput, type BehaviorMode, type BehaviorNext, type BehaviorProps, type BehaviorQueueOverflow, type BehaviorRunOptions, type BehaviorRunResult, type BehaviorRunner, type BehaviorRunnerErrorEvent, type BehaviorRunnerOptions, type BehaviorRuntime, type BehaviorStartResult, type BehaviorStrategy, type BehaviorTraceEntry, type BehaviorTraceSink, type BehaviorValidationIssue, type BehaviorValidationResult, type BehaviorWs, type BehaviorWsOptions, type BehaviorWsRetryOptions, type BehaviorWsSocket, type BehaviorWsStatus, type ChainBehavior, type ChainBehaviorDefinition, type ChainBehaviorOptions, PubSubBehavior, catchError, createBehaviorRunner, createBehaviorWs, createChainBehavior, createMemoryTraceSink, createPubSubBehavior, defineBehaviorConfig, defineErrorReporter };

package/dist/index.d.ts

@@ -0,0 +1,334 @@
+type BehaviorInput = Record<string, unknown>;
+type BehaviorProps = Record<string, unknown>;
+type BehaviorConfig = {
+    version?: 1;
+    strategies: Record<string, BehaviorStrategy>;
+    entrypoints?: Record<string, string>;
+};
+type BehaviorStrategy = {
+    fn: string;
+    props?: BehaviorProps;
+    when?: BehaviorConditionExpression;
+    then?: BehaviorNext[];
+    catch?: BehaviorNext[];
+    mode?: BehaviorMode;
+    terminal?: boolean;
+    tags?: string[];
+    description?: string;
+};
+type BehaviorMode = 'sequence' | 'selector' | 'parallel';
+type BehaviorNext = string | {
+    id?: string;
+    strategy: string;
+    props?: BehaviorProps;
+    when?: BehaviorConditionExpression;
+};
+type BehaviorConditionExpression = boolean | [operator: string, ...args: unknown[]];
+type BehaviorAction<TContext, TPatch = unknown> = (args: BehaviorActionArgs<TContext>) => BehaviorActionResult<TContext, TPatch> | Promise<BehaviorActionResult<TContext, TPatch>>;
+type BehaviorActionArgs<TContext> = {
+    context: TContext;
+    props: BehaviorProps;
+    input: BehaviorInput;
+    signal: AbortSignal;
+    runtime: BehaviorRuntime;
+};
+type BehaviorActionResult<TContext, TPatch = unknown> = void | false | BehaviorActionSuccess<TContext, TPatch> | BehaviorActionSkip | BehaviorActionStop<TPatch> | BehaviorActionFail;
+type BehaviorActionSuccess<TContext, TPatch> = {
+    type?: 'success';
+    context?: TContext;
+    data?: Record<string, unknown>;
+    patch?: TPatch | TPatch[];
+    events?: BehaviorEvent[];
+    continue?: boolean;
+};
+type BehaviorActionSkip = {
+    type: 'skip';
+    reason?: string;
+    data?: Record<string, unknown>;
+};
+type BehaviorActionStop<TPatch> = {
+    type: 'stop';
+    reason?: string;
+    patch?: TPatch | TPatch[];
+    events?: BehaviorEvent[];
+};
+type BehaviorActionFail = {
+    type: 'fail';
+    reason?: string;
+    error?: unknown;
+    data?: Record<string, unknown>;
+};
+type BehaviorEvent = {
+    type: string;
+    payload?: unknown;
+};
+type BehaviorEventMap = Record<string, unknown>;
+type BehaviorEventName<TEvents extends object> = Extract<keyof TEvents, string>;
+type BehaviorBusEvent<TPayload = unknown> = {
+    id: string;
+    topic: string;
+    occurredAt: number;
+    origin?: string;
+    parsed: TPayload;
+    serialized: string;
+};
+type BehaviorEventHandler<TEvents extends object, TEvent extends BehaviorEventName<TEvents>> = (event: BehaviorBusEvent<TEvents[TEvent]>) => void;
+type BehaviorBusErrorEvent<TEvents extends object> = {
+    type: 'serialization';
+    topic: BehaviorEventName<TEvents>;
+    payload: TEvents[BehaviorEventName<TEvents>];
+    origin?: string;
+    error: unknown;
+} | {
+    type: 'subscriber';
+    event: BehaviorBusEvent<TEvents[BehaviorEventName<TEvents>]>;
+    error: unknown;
+};
+type BehaviorBusEmitOptions = {
+    origin?: string;
+};
+type BehaviorBusOptions<TEvents extends object> = {
+    onError?: (event: BehaviorBusErrorEvent<TEvents>) => void;
+};
+type BehaviorBus<TEvents extends object = BehaviorEventMap> = {
+    on<TEvent extends BehaviorEventName<TEvents>>(event: TEvent, handler: BehaviorEventHandler<TEvents, TEvent>): () => void;
+    off<TEvent extends BehaviorEventName<TEvents>>(event: TEvent, handler?: BehaviorEventHandler<TEvents, TEvent>): void;
+    emit<TEvent extends BehaviorEventName<TEvents>>(topic: TEvent, payload: TEvents[TEvent], options?: BehaviorBusEmitOptions): BehaviorBusEvent<TEvents[TEvent]>;
+    dispatch(event: unknown): BehaviorBusEvent | undefined;
+};
+type BehaviorWsSocket = {
+    readyState: number;
+    send(data: string): void;
+    close(): void;
+    addEventListener(type: 'open' | 'close' | 'error' | 'message', listener: EventListener): void;
+    removeEventListener(type: 'open' | 'close' | 'error' | 'message', listener: EventListener): void;
+};
+type BehaviorWsRetryOptions = {
+    initialDelay?: number;
+    maxDelay?: number;
+    multiplier?: number;
+    jitter?: boolean;
+};
+type BehaviorWsOptions<TEvents extends object = BehaviorEventMap> = {
+    bus: BehaviorBus<TEvents>;
+    createSocket: () => BehaviorWsSocket;
+    inboundTopics?: BehaviorEventName<TEvents>[];
+    outboundTopics?: BehaviorEventName<TEvents>[];
+    origin?: string;
+    retry?: BehaviorWsRetryOptions;
+};
+type BehaviorWsStatus = 'idle' | 'connecting' | 'connected' | 'retrying' | 'stopped';
+type BehaviorWs = {
+    start(): void;
+    stop(): void;
+    reconnect(): void;
+    status(): BehaviorWsStatus;
+};
+type BehaviorBindingEventMap = Record<string, BehaviorInput>;
+type BehaviorBusBindingKey<TEvents extends object> = {
+    [TEvent in BehaviorEventName<TEvents>]: TEvents[TEvent] extends BehaviorInput ? `[bus] ${TEvent}` : never;
+}[BehaviorEventName<TEvents>];
+type BehaviorConcurrencyMode = 'parallel' | 'latest' | 'queue' | 'drop';
+type BehaviorQueueOverflow = 'drop-oldest' | 'drop-newest';
+type BehaviorConcurrencyOptions<TPayload = BehaviorInput> = {
+    mode?: BehaviorConcurrencyMode;
+    key?: (payload: TPayload) => string;
+    maxQueueSize?: number;
+    overflow?: BehaviorQueueOverflow;
+};
+type BehaviorBusBinding<TPayload = BehaviorInput> = {
+    entrypoint: string;
+    options?: {
+        concurrency?: BehaviorConcurrencyOptions<TPayload>;
+    };
+};
+type BehaviorBusBindings<TEvents extends object> = {
+    [TBinding in BehaviorBusBindingKey<TEvents>]?: BehaviorBusBinding<TEvents[Extract<TBinding extends `[bus] ${infer TEvent}` ? TEvent : never, BehaviorEventName<TEvents>>]>;
+};
+type BehaviorDomBindingKey = `[dom] ${string}:${string}`;
+type BehaviorDomForm = Record<string, FormDataEntryValue | FormDataEntryValue[]>;
+type BehaviorDomInput = BehaviorInput & {
+    type: string;
+    value?: string;
+    dataset: Record<string, string>;
+    form?: BehaviorDomForm;
+};
+type BehaviorDomBinding = {
+    entrypoint: string;
+    options?: {
+        preventDefault?: boolean;
+        stopPropagation?: boolean;
+        capture?: boolean;
+        once?: boolean;
+        input?: (scope: {
+            event: Event;
+            element: Element;
+            defaultInput: BehaviorDomInput;
+        }) => BehaviorInput;
+        concurrency?: BehaviorConcurrencyOptions<BehaviorDomInput>;
+    };
+};
+type BehaviorDomBindings = Partial<Record<BehaviorDomBindingKey, BehaviorDomBinding>>;
+type ChainBehaviorDefinition<TContext, TPatch = unknown, TEvents extends object = BehaviorBindingEventMap> = {
+    config: BehaviorConfig;
+    actions?: Record<string, BehaviorAction<TContext, TPatch>>;
+    conditions?: Record<string, BehaviorConditionFn<TContext>>;
+    events?: BehaviorBusBindings<TEvents> & BehaviorDomBindings;
+};
+type ChainBehaviorOptions<TContext, TPatch = unknown, TEvents extends object = BehaviorBindingEventMap> = BehaviorRunnerOptions<TContext, TPatch> & {
+    context: TContext | (() => TContext);
+    bus?: BehaviorBus<TEvents>;
+    root?: Document | Element;
+    concurrency?: BehaviorConcurrencyOptions;
+    onRunnerError?: (event: BehaviorRunnerErrorEvent<TContext, TPatch>) => void;
+};
+type BehaviorRunnerErrorEvent<TContext, TPatch = unknown> = {
+    error: BehaviorError;
+    result: BehaviorRunResult<TContext, TPatch>;
+    binding: string;
+    entrypoint: string;
+    runId: string;
+    key?: string;
+};
+type BehaviorInactiveBinding = {
+    binding: string;
+    reason: 'unsupported-source' | 'dom-unavailable';
+};
+type BehaviorStartResult = {
+    active: string[];
+    inactive: BehaviorInactiveBinding[];
+    validation: BehaviorValidationResult;
+};
+type ChainBehavior<TContext, TPatch = unknown> = {
+    runner: BehaviorRunner<TContext, TPatch>;
+    start(): BehaviorStartResult;
+    stop(options?: {
+        force?: boolean;
+    }): void;
+};
+type BehaviorRunResult<TContext, TPatch = unknown> = {
+    status: 'success' | 'stopped' | 'failed' | 'skipped';
+    context: TContext;
+    data: Record<string, unknown>;
+    patches: TPatch[];
+    events: BehaviorEvent[];
+    error?: BehaviorError;
+    trace?: BehaviorTraceEntry[];
+    steps: number;
+};
+type BehaviorRuntime = {
+    get(path: string): unknown;
+    getData(path: string): unknown;
+    setData(path: string, value: unknown): void;
+    resolve(value: unknown): unknown;
+    signal: AbortSignal;
+    emit(event: BehaviorEvent): void;
+    patch(patch: unknown): void;
+    stop(reason?: string): BehaviorActionStop<unknown>;
+    fail(reason?: string, data?: Record<string, unknown>): BehaviorActionFail;
+};
+type BehaviorRunnerOptions<TContext, TPatch> = {
+    maxSteps?: number;
+    maxDepth?: number;
+    timeoutMs?: number;
+    trace?: boolean | BehaviorTraceSink;
+    onError?: BehaviorErrorReporter<TContext, TPatch>;
+    mergeData?: (current: Record<string, unknown>, next: Record<string, unknown>) => Record<string, unknown>;
+};
+type BehaviorRunOptions = {
+    signal?: AbortSignal;
+};
+type BehaviorTraceSink = {
+    push(entry: BehaviorTraceEntry): void;
+    entries?(): BehaviorTraceEntry[];
+};
+type BehaviorTraceEntry = {
+    step: number;
+    depth: number;
+    strategy: string;
+    fn: string;
+    mode: BehaviorMode | undefined;
+    status: 'matched' | 'skipped' | 'success' | 'stopped' | 'failed';
+    input: BehaviorInput;
+    props: BehaviorProps;
+    dataBefore: Record<string, unknown>;
+    dataAfter: Record<string, unknown>;
+    durationMs: number;
+    reason?: string;
+};
+type BehaviorError = {
+    code: string;
+    message: string;
+    strategy?: string;
+    fn?: string;
+    stage?: BehaviorErrorStage;
+    cause?: unknown;
+};
+type BehaviorErrorStage = {
+    phase: 'entrypoint' | 'condition' | 'action' | 'catch' | 'limit';
+    entrypoint?: string | undefined;
+    strategy?: string | undefined;
+    fn?: string | undefined;
+    mode?: BehaviorMode | undefined;
+    step?: number | undefined;
+    depth?: number | undefined;
+};
+type BehaviorErrorEvent<TContext, TPatch = unknown> = {
+    error: BehaviorError;
+    context: TContext;
+    input: BehaviorInput;
+    data: Record<string, unknown>;
+    patches: TPatch[];
+    events: BehaviorEvent[];
+    trace?: BehaviorTraceEntry[];
+};
+type BehaviorErrorReporter<TContext, TPatch = unknown> = (event: BehaviorErrorEvent<TContext, TPatch>) => void;
+type BehaviorErrorReporterHandlers<TContext, TPatch = unknown> = {
+    report: BehaviorErrorReporter<TContext, TPatch>;
+};
+type BehaviorValidationResult = {
+    ok: boolean;
+    errors: BehaviorValidationIssue[];
+    warnings: BehaviorValidationIssue[];
+};
+type BehaviorValidationIssue = {
+    code: string;
+    message: string;
+    path?: string;
+    strategy?: string;
+};
+type BehaviorConditionFn<TContext> = (context: {
+    context: TContext;
+    input: BehaviorInput;
+    data: Record<string, unknown>;
+    runtime: Pick<BehaviorRuntime, 'resolve' | 'get' | 'getData'>;
+}, ...conditionArgs: unknown[]) => boolean;
+type BehaviorRunner<TContext, TPatch = unknown> = {
+    registerAction(name: string, action: BehaviorAction<TContext, TPatch>): void;
+    registerActions(actions: Record<string, BehaviorAction<TContext, TPatch>>): void;
+    registerCondition(name: string, condition: BehaviorConditionFn<TContext>): void;
+    registerConditions(conditions: Record<string, BehaviorConditionFn<TContext>>): void;
+    loadConfig(config: BehaviorConfig): BehaviorValidationResult;
+    validateConfig(config?: BehaviorConfig): BehaviorValidationResult;
+    run(entrypoint: string, context: TContext, input?: BehaviorInput, options?: BehaviorRunOptions): Promise<BehaviorRunResult<TContext, TPatch>>;
+    runSync(entrypoint: string, context: TContext, input?: BehaviorInput, options?: BehaviorRunOptions): BehaviorRunResult<TContext, TPatch>;
+};
+
+declare const defineBehaviorConfig: <TConfig extends BehaviorConfig>(config: TConfig) => TConfig;
+
+declare const createBehaviorRunner: <TContext, TPatch = unknown>(options?: BehaviorRunnerOptions<TContext, TPatch>) => BehaviorRunner<TContext, TPatch>;
+
+declare const createMemoryTraceSink: () => BehaviorTraceSink;
+
+declare const defineErrorReporter: <TContext, TPatch = unknown>(handlers: BehaviorErrorReporterHandlers<TContext, TPatch> | BehaviorErrorReporter<TContext, TPatch>) => BehaviorErrorReporter<TContext, TPatch>;
+
+declare const createPubSubBehavior: <TEvents extends object = BehaviorEventMap>(options?: BehaviorBusOptions<TEvents>) => BehaviorBus<TEvents>;
+declare const PubSubBehavior: BehaviorBus<BehaviorEventMap>;
+
+declare const createChainBehavior: <TContext, TPatch = unknown, TEvents extends object = BehaviorBindingEventMap>(definition: ChainBehaviorDefinition<TContext, TPatch, TEvents>, options: ChainBehaviorOptions<TContext, TPatch, TEvents>) => ChainBehavior<TContext, TPatch>;
+
+declare const createBehaviorWs: <TEvents extends object = BehaviorEventMap>(options: BehaviorWsOptions<TEvents>) => BehaviorWs;
+
+declare const catchError: <T>(callback: () => T | PromiseLike<T>) => Promise<T>;
+
+export { type BehaviorAction, type BehaviorActionArgs, type BehaviorActionFail, type BehaviorActionResult, type BehaviorActionSkip, type BehaviorActionStop, type BehaviorActionSuccess, type BehaviorBindingEventMap, type BehaviorBus, type BehaviorBusBinding, type BehaviorBusBindingKey, type BehaviorBusBindings, type BehaviorBusEmitOptions, type BehaviorBusErrorEvent, type BehaviorBusEvent, type BehaviorBusOptions, type BehaviorConcurrencyMode, type BehaviorConcurrencyOptions, type BehaviorConditionExpression, type BehaviorConditionFn, type BehaviorConfig, type BehaviorDomBinding, type BehaviorDomBindingKey, type BehaviorDomBindings, type BehaviorDomForm, type BehaviorDomInput, type BehaviorError, type BehaviorErrorEvent, type BehaviorErrorReporter, type BehaviorErrorReporterHandlers, type BehaviorErrorStage, type BehaviorEvent, type BehaviorEventHandler, type BehaviorEventMap, type BehaviorEventName, type BehaviorInactiveBinding, type BehaviorInput, type BehaviorMode, type BehaviorNext, type BehaviorProps, type BehaviorQueueOverflow, type BehaviorRunOptions, type BehaviorRunResult, type BehaviorRunner, type BehaviorRunnerErrorEvent, type BehaviorRunnerOptions, type BehaviorRuntime, type BehaviorStartResult, type BehaviorStrategy, type BehaviorTraceEntry, type BehaviorTraceSink, type BehaviorValidationIssue, type BehaviorValidationResult, type BehaviorWs, type BehaviorWsOptions, type BehaviorWsRetryOptions, type BehaviorWsSocket, type BehaviorWsStatus, type ChainBehavior, type ChainBehaviorDefinition, type ChainBehaviorOptions, PubSubBehavior, catchError, createBehaviorRunner, createBehaviorWs, createChainBehavior, createMemoryTraceSink, createPubSubBehavior, defineBehaviorConfig, defineErrorReporter };