import type { EnumItemInit, EnumItemLabel, EnumKey, EnumValue, LocalizeInterface, ValueTypeFromSingleInit } from './types';
import { IS_ENUM_ITEM } from './utils';
export type EnumItemInterface<T extends EnumItemInit<V>, K extends EnumKey<any> = string, V extends EnumValue = ValueTypeFromSingleInit<T, K>, LP = any> = EnumItemClass<T, K, V, LP> & {
    [key in Exclude<keyof T, 'value' | 'label' | 'key'>]: T[key];
};
/**
 * - **EN:** Represents a single item in an enumeration collection.
 * - **CN:** 表示枚举集合中的单个枚举项
 *
 * @template T Represents the type of the enum item's initialization object | 表示枚举项初始化对象的类型
 * @template V Represents the type of the enum item's value (usually string or number) |
 *   表示枚举项值的类型（通常是字符串或数字）
 * @template K Represents the type of the enum item's key | 表示枚举项键的类型
 * @template LP Represents the type of the enum item's label prefix | 表示枚举项标签的前缀值
 */
export declare class EnumItemClass<const T extends EnumItemInit<V>, K extends EnumKey<any> = string, V extends EnumValue = ValueTypeFromSingleInit<T, K>, const LP = any> {
    private _options?;
    private _label;
    /**
     * - **EN:** Creates an instance of EnumItemClass.
     * - **CN:** 创建 EnumItemClass 的实例
     *
     * @param key The key of the enum item | 枚举项键
     * @param value The value of the enum item | 枚举项值
     * @param label The display name of the enum item | 枚举项显示名称
     * @param raw The original initialization object | 原始初始化对象
     * @param options Optional settings for the enum item | 枚举项的可选设置
     */
    constructor(key: K, value: V, label: EnumItemLabel, raw: T, options?: EnumItemOptions<T, K, V, LP>);
    /**
     * - **EN:** The value of the enum item
     * - **CN:** 枚举项的值
     */
    readonly value: V;
    /**
     * - **EN:** The label of the enum item (also known as display name)
     * - **CN:** 枚举项的标签（亦称显示名称）
     */
    readonly label: string;
    /**
     * - **EN:** The key of the enum item, which is the key in the initialization object when creating
     *   the enum collection.
     * - **CN:** 枚举项的键，即创建枚举集合时初始化对象中的键
     */
    readonly key: K;
    /**
     * - **EN:** The original initialization object of the enum item, which is the sub-object of a
     *   single enum item when creating the enum collection.
     * - **CN:** 枚举项的原始初始化对象，即创建枚举集合时单个枚举项的子对象
     */
    readonly raw: T;
    /**
     * - **EN:** A boolean value indicates that this is an enum item instance.
     * - **CN:** 布尔值，表示这是一个枚举项实例
     */
    get [IS_ENUM_ITEM](): true;
    /**
     * - **EN:** Auto convert to a correct primitive type. This method is called when the object is used
     *   in a context that requires a primitive value.
     *
     * > The priority of this method is higher than both `valueOf` and `toString` methods.
     *
     * - **CN:** 自动转换为正确的原始类型。当对象被用在需要原始值的上下文中时会调用此方法。
     *
     * > 此方法的优先级高于 `valueOf` 和 `toString` 方法。
     *
     * @param hint {'number' | 'string' | 'default'} - A string indicating the preferred type of the
     *   result | 指示结果的首选类型
     *
     * @returns The primitive value of the enum item, either its value or label based on the hint |
     *   枚举项的原始值，根据提示返回其值或标签
     */
    private [Symbol.toPrimitive];
    /**
     * - **EN:** Returns the string representation of the enum item, which is its label. This method is
     *   called when the object is used in a context that requires a string value, such as string
     *   concatenation or template literals.
     *
     * > The priority of this method is lower than the `valueOf` method
     *
     * - **CN:** 返回枚举项的字符串表示形式，即其显示名称。当对象被用在需要字符串值的上下文中时会调用此方法，例如字符串连接或模板字面量。
     *
     * > 此方法的优先级低于 `valueOf` 方法
     *
     * @returns The display name of the enum item | 枚举项的显示名称
     */
    toString(): string;
    /**
     * - **EN:** Returns the localized string representation of the enum item, which is its label. This
     *   method is called when the object is used in a context that requires a localized string value,
     *   such as `toLocaleString` method.
     * - **CN:** 返回枚举项的本地化字符串表示形式，即其显示名称。当对象被用在需要本地化字符串值的上下文中时会调用此方法，例如 `toLocaleString` 方法。
     *
     * @returns The localized display name of the enum item | 枚举项的本地化显示名称
     */
    toLocaleString(): string;
    /**
     * - **EN:** Returns the primitive value of the enum item, which is its value. This method is called
     *   when the object is used in a context that requires a primitive value, such as mathematical
     *   operations.
     *
     * > The priority of this method is higher than the `toString` method
     *
     * - **CN:** 返回枚举项的原始值，即其值。当对象被用在需要原始值的上下文中时会调用此方法，例如数学运算。
     *
     * > 此方法的优先级高于 `toString` 方法
     *
     * @returns The value of the enum item | 枚举项的值
     */
    valueOf(): V;
    private _localize;
    private _localizeResource;
}
export interface EnumItemOptions<T extends EnumItemInit<V>, K extends EnumKey<any> = string, V extends EnumValue = ValueTypeFromSingleInit<T, K>, LP = any> {
    /**
     * - **EN:** Localization function, used to convert the text of the enumeration item to localized
     *   text
     * - **CN:** 本地化函数，用于把枚举项文本转换为本地化文本
     */
    localize?: LocalizeInterface;
    /**
     * - **EN:** The label prefix for each enum item, which can be a string or an object. This option
     *   can simplify or even omit the label definition of enum items, and is only effective when
     *   internationalization is enabled.
     * - **CN:** 每个枚举项的label前缀，可以是字符串，也可以是一个对象。此选项可以简化甚至省略枚举项的label定义，只有当开启国际化时才需要此选项。
     */
    labelPrefix?: LP;
    /**
     * - **EN:** Allow setting a label prefix for enum items, simplifying or even omitting the label
     *   definition of enum items. This option is only needed when internationalization is enabled.
     *   The prefix is set through `options.labelPrefix` when creating the Enum, which can be a string
     *   or an object.
     *
     *   - `true` - Default value. Enable automatic concatenation of enum item localeKey in
     *       `options.labelPrefix` + `label` format. `labelPrefix` only supports string in this case.
     *   - `Function` - Dynamically generate the localeKey for enum items. `labelPrefix` supports any type
     *       in this case.
     *   - `false` - Disable automatic label generation, completely relying on the `label` field defined
     *       in the enum item.
     *
     * > This option has the same effect as `Enum.config.autoLabel`, but has a higher priority than the
     * > global configuration, and only takes effect for the current enum instance.
     *
     * - **CN:** 允许为枚举项设置label前缀，简化甚至可以省略枚举项的label定义，只有当开启国际化时才需要此选项。创建Enum时通过 `options.labelPrefix`
     *   设置前缀，可以是字符串，也可以是一个对象。
     *
     *   - `true` - 默认值，启用自动拼接，`options.labelPrefix` + `label` 自动拼接生成标签，这种情况下 `labelPrefix` 只支持字符串形式
     *   - `Function` - 动态生成枚举项localeKey，这种情况下 `labelPrefix` 支持任意类型
     *   - `false` - 禁用自动生成标签，完全依赖枚举项中定义的 `label` 字段
     *
     * > 此选项与 `Enum.config.autoLabel` 作用相同，但优先级高于全局配置，仅对当前枚举实例生效。
     */
    autoLabel?: boolean | ((options: {
        item: EnumItemClass<T, K, V, LP>;
        labelPrefix: LP;
    }) => string);
    /**
     * - **EN:** Set the array of meta information fields to be automatically localized, similar to the
     *   handling of `label`.
     *
     *   - `true` - Automatically localize all meta information fields.
     *   - `false` - The default value. Do not automatically localize meta information fields.
     *   - `string[]` - Specify the meta field names to be automatically localized.
     * - **CN:** 设置自动本地化的元信息字段数组，类似`label`的处理方式。
     *
     *   - `true` - 自动本地化所有元信息字段。
     *   - `false` - 默认值，不自动本地化元信息字段。
     *   - `string[]` - 指定要自动本地化的元信息字段名。
     */
    autoLocalizeMeta?: boolean | Exclude<keyof T, 'key' | 'value' | 'label'>[];
}