export type PluginType = 'attribute' | 'watcher' | 'action';
export type Requirement = 'allowed' | 'must' | 'denied' | 'exclusive';
export type OnRemovalFn = () => void;
export type DatastarPlugin = AttributePlugin | WatcherPlugin | ActionPlugin;
export declare const DATASTAR_SIGNAL_PATCH_EVENT = "datastar-signal-patch";
export type JSONPatch = Record<string, any>;
export interface CustomEventMap {
    [DATASTAR_SIGNAL_PATCH_EVENT]: CustomEvent<JSONPatch>;
}
export type WatcherFn<K extends keyof CustomEventMap> = (this: Document, ev: CustomEventMap[K]) => void;
declare global {
    interface Document {
        dispatchEvent<K extends keyof CustomEventMap>(ev: CustomEventMap[K]): void;
        addEventListener<K extends keyof CustomEventMap>(type: K, listener: WatcherFn<K>): void;
        removeEventListener<K extends keyof CustomEventMap>(type: K, listener: WatcherFn<K>): void;
    }
}
export type AttributePlugin = {
    type: 'attribute';
    name: string;
    onGlobalInit?: (ctx: InitContext) => void;
    onLoad: (ctx: RuntimeContext) => OnRemovalFn | void;
    keyReq?: Requirement;
    valReq?: Requirement;
    returnsValue?: boolean;
    shouldEvaluate?: boolean;
    argNames?: string[];
};
export type WatcherPlugin = {
    type: 'watcher';
    name: string;
    onGlobalInit?: (ctx: InitContext) => void;
};
export type ActionPlugins = Record<string, ActionPlugin>;
export type ActionMethod = (ctx: RuntimeContext, ...args: any[]) => any;
export type ActionPlugin = {
    type: 'action';
    name: string;
    fn: ActionMethod;
};
export type GlobalInitializer = (ctx: InitContext) => void;
export type InitContext = {
    plugin: DatastarPlugin;
    actions: Readonly<ActionPlugins>;
    root: Record<string, any>;
    filtered: (opts?: SignalFilterOptions, obj?: JSONPatch) => Record<string, any>;
    signal<T>(initialValue?: T | undefined): Signal<T>;
    computed<T>(getter: (previousValue?: T) => T): Computed<T>;
    effect(fn: (...args: any[]) => void): OnRemovalFn;
    mergePatch: (patch: any, args?: {
        ifMissing?: boolean;
    }) => any;
    peek: <T>(fn: () => T) => T;
    getPath: <T = any>(path: string) => T | undefined;
    startBatch: () => void;
    endBatch: () => void;
    initErr: (reason: string, metadata?: object) => Error;
};
export type HTMLOrSVG = Element & (HTMLElement | SVGElement);
export type Modifiers = Map<string, Set<string>>;
export type ReactiveExpressionFn = <T>(...argsThenDeps: any[]) => T;
export type RuntimeContext = InitContext & {
    el: HTMLOrSVG;
    rawKey: Readonly<string>;
    key: Readonly<string>;
    value: Readonly<string>;
    mods: Modifiers;
    rx: ReactiveExpressionFn;
    fnContent?: string;
    evt?: Event;
    runtimeErr: (reason: string, metadata?: object) => Error;
};
export type RuntimeExpressionFunction = (ctx: RuntimeContext, ...args: any[]) => any;
export type EventCallbackHandler = (...args: any[]) => void;
export type SignalFilter = RegExp;
export type SignalFilterOptions = {
    include?: RegExp | string;
    exclude?: RegExp | string;
};
export type Signal<T = any> = {
    (): T;
    (value: T): boolean;
};
export type Computed<T = any> = () => T;
export type Effect = () => void;