import type { InjectionKey, MaybeRef } from 'vue'

import { Awaitable } from './typed.js'

/** 字典唯一标志 */
export type DictTypeKey<T extends object = object> = string & {
    __T?: T
}

/** 字典项基础 */
export interface _DictItemBase {
    /** 标签 */
    label: string
    /** 值 */
    value: string
    /** 备注 */
    remark?: string
    /** 禁用 */
    disabled?: boolean
}

/** 字典项 */
export type DictItem<T extends object = object> = T & _DictItemBase

/** Options for {@link plugin} */
export interface DictOptions {
    /** 获取字典项 */
    fetch: (params: (Omit<UseDictOptions, 'onGet'> & { dictType: string })[]) => Awaitable<(DictItem[] | undefined)[]>

    /** 缓存的存活时长，单位 ms */
    ttl?: MaybeRef<number>

    /** 缓存附加的 key，应存在于 {@link UseDictOptions} */
    cacheKeys?: (keyof UseDictOptions)[]
    /** 缓存附加的 key 默认值 */
    cacheKeysDefaultValue?: { [Key in keyof UseDictOptions]?: UseDictOptions[Key] | (() => UseDictOptions[Key]) | undefined }
}

/**
 * 字典插件
 * - vue-plugin
 */
export declare function plugin(
    app: {
        provide<T, K = InjectionKey<T> | string | number>(key: K, value: K extends InjectionKey<infer V> ? V : T): void
    },
    options: DictOptions,
): void
export default plugin

/** 取消注册 */
type Unregister = () => void

/**
 * 注册字典
 *
 * @param dictType - 字典类型
 * @param getter - 获取字典项
 * @param cached - 是否缓存，默认 true
 * @returns 取消注册的 handler
 */
export declare function registerDict<T extends object>(
    dictType: DictTypeKey<T>,
    getter: (options: UseDictOptions<T>, getDict?: <F extends object>(dictType: DictTypeKey<F>, options?: UseDictOptions<F>) => Promise<DictItem<F>[]>) => Promise<DictItem<T>[]>,
    cached?: boolean,
): Unregister

/**
 * 取消注册字典
 *
 * @param dictType - 字典类型
 */
export declare function unregisterDict<T extends object>(dictType: DictTypeKey<T>): void

/**
 * Options for {@link useDict} & {@link useDictMap}
 *
 * 可以增加参数，会在调用 {@link DictOptions.fetch} 时传递
 */
export interface UseDictOptions<T extends object = object> {
    onGet?: (dicts: DictItem<T>[]) => Awaitable<void | DictItem<T>[]>
}

/** Return for {@link useDict} & {@link useDictMap} */
export type UseDictReturn<Result> = Result & {
    loading: boolean
}

/** 字典项映射 map，key 为 字典值 {@link DictItem.value} */
export type DictValueMap<T extends object = object> = Map<string, DictItem<T>>

/**
 * 获取字典项
 * - vue-composable
 *
 * @param dictType - 字典类型
 * @param options - 选项
 */
export declare function useDict<T extends object>(
    dictType: MaybeRef<DictTypeKey<T>>,
    options?: UseDictOptions<T>,
): UseDictReturn<DictItem<T>[]>

/**
 * 获取字典项映射
 * - vue-composable
 *
 * @param dictType - 字典类型
 * @param options - 选项
 */
export declare function useDictMap<T extends object>(
    dictType: MaybeRef<DictTypeKey<T>>,
    options?: UseDictOptions<T>,
): UseDictReturn<DictValueMap<T>>