import { MetaEntry, SelectorMixin } from '../types';
import { AsyncState, AsyncMode, AsyncHandler, AsyncOptions, AsyncActions } from './types';
import { Abortable } from './abortable';

/**
 * Options for creating an async selector mixin.
 */
export interface AsyncMixinOptions<T, M extends AsyncMode = "fresh"> extends AsyncOptions {
    /**
     * Initial async state. Defaults to `async.fresh<T>()`.
     */
    initial?: AsyncState<T, M>;
    /**
     * Name of store for the async state. Defaults to `async:${handler.name || "anonymous"}`.
     */
    name?: string;
    /**
     * Metadata for the async state.
     * - Single meta: `meta: persist()`
     * - Multiple metas: `meta: meta.of(persist(), notPersisted.for("result"))`
     */
    meta?: MetaEntry<"result"> | {
        metas: MetaEntry<"result">[];
    };
}
/**
 * Result tuple from async selector mixin: [state, actions]
 */
export type AsyncMixinResult<T, M extends AsyncMode, TArgs extends any[]> = [
    AsyncState<T, M>,
    AsyncActions<T, M, TArgs>
];
/**
 * Create an async selector mixin for component-local async state.
 * Uses `scoped()` internally, so state is isolated per component and auto-disposed.
 *
 * @example
 * const submitMutation = async.mixin(async (ctx, data: FormData) => {
 *   const res = await fetch('/api/submit', {
 *     method: 'POST',
 *     body: JSON.stringify(data),
 *     signal: ctx.signal,
 *   });
 *   return res.json();
 * });
 *
 * function ContactForm() {
 *   const [state, { dispatch }] = useStore(({ mixin }) => mixin(submitMutation));
 *   return <button onClick={() => dispatch(formData)}>Submit</button>;
 * }
 */
export declare function mixin<T, TArgs extends any[]>(handler: AsyncHandler<T, TArgs>, options?: AsyncMixinOptions<T, "fresh">): SelectorMixin<AsyncMixinResult<T, "fresh", TArgs>>;
/**
 * Create an async selector mixin with stale mode.
 */
export declare function mixin<T, TArgs extends any[]>(handler: AsyncHandler<T, TArgs>, options: AsyncMixinOptions<T, "stale"> & {
    initial: AsyncState<T, "stale">;
}): SelectorMixin<AsyncMixinResult<T, "stale", TArgs>>;
/**
 * Create an async selector mixin with an Abortable (signal auto-injected).
 */
export declare function mixin<T, TArgs extends any[]>(abortableFn: Abortable<TArgs, T>, options?: AsyncMixinOptions<T, "fresh">): SelectorMixin<AsyncMixinResult<T, "fresh", TArgs>>;
/**
 * Create an async selector mixin with an Abortable and stale mode.
 */
export declare function mixin<T, TArgs extends any[]>(abortableFn: Abortable<TArgs, T>, options: AsyncMixinOptions<T, "stale"> & {
    initial: AsyncState<T, "stale">;
}): SelectorMixin<AsyncMixinResult<T, "stale", TArgs>>;
//# sourceMappingURL=mixin.d.ts.map