import { isString, TypedMap } from '@kraftr/common';
import type { Binding } from './binding';
export declare type BindingFilter = {
    (binding: Readonly<Binding<unknown>>): boolean;
};
/**
 * A function to check if a given tag value match for `filterByTag`
 */
export declare type TagValueMatcher<Value extends Tags[keyof Tags], Name extends keyof Tags & string, Tags extends Record<string, unknown>> = {
    /**
     * Check if the given tag value matches the search criteria
     * @param tagValue - Tag value from the binding
     * @param tagName - Tag name
     * @param tagMap - Tag map from the binding
     */
    (tagValue: Value, tagName: Name, tagMap: TypedMap<Tags>): boolean;
};
/**
 * A symbol that can be used to match binding tags by name regardless of the
 * value.
 *
 * @example
 *
 * The following code matches bindings with tag `{controller: 'A'}` or
 * `{controller: 'controller'}`. But if the tag name 'controller' does not
 * exist for a binding, the binding will NOT be included.
 *
 * ```ts
 * ctx.findByTag({controller: ANY_TAG_VALUE})
 * ```
 */
export declare const ANY_TAG_VALUE: TagValueMatcher<any, string, any>;
export declare type UnionOf<T> = T extends unknown[] ? T[number] : T;
/**
 * Create a tag value matcher function that returns `true` if the target tag
 * value equals to the item value or is an array that includes the item value.
 * @param itemValues - A list of tag item value
 */
export declare function includesTagValue<Value, Key extends string>(...items: [...UnionOf<Value>[]]): TagValueMatcher<Value | Value[], Key, any>;
export declare function filterByTag<Tags extends Record<string, unknown>>(tagMap: {
    [Key in keyof Tags]?: TagValueMatcher<Tags[Key], isString<Key & string, any>, Tags> | Tags[Key];
}): BindingFilter;