# (C) Copyright 2020-2025 Enthought, Inc., Austin, TX
# All rights reserved.
#
# This software is provided without warranty under the terms of the BSD
# license included in LICENSE.txt and may be redistributed only under
# the conditions described in the aforementioned license. The license
# is also available online at http://www.enthought.com/licenses/BSD.txt
#
# Thanks for using Enthought open source!

import datetime
from pathlib import PurePath as _PurePath
from typing import (
    Any as _Any,
    Callable as _CallableType,
    Dict as _DictType,
    List as _ListType,
    Literal,
    Optional,
    Sequence as _Sequence,
    Set as _SetType,
    SupportsFloat,
    SupportsIndex,
    Tuple as _Tuple,
    Type as _Type,
    TypeVar,
    Union as _Union,
    overload,
)
from uuid import UUID as _UUID

from .trait_type import _TraitType

SetTypes: _Any
bool_fast_validate: _Any


def default_text_editor(trait: _Any, type: Optional[_Any] = ...) -> _Any:
    ...


_S = TypeVar("_S")
_T = TypeVar("_T")
_U = TypeVar("_U")
_V = TypeVar("_V")


_Trait = _Union[_TraitType[_S, _T], _Type[_TraitType[_S, _T]]]


class Any(_TraitType[_Any, _Any]):
    def __init__(
        self,
        default_value: _Any = ...,
        *,
        factory: _CallableType[..., _Any] = ...,
        args: _Tuple[_Any, ...] = ...,
        kw: _DictType[str, _Any] = ...,
        **metadata: _Any,
    ) -> None:
        ...


class _BaseInt(_TraitType[_T, int]):
    ...


class BaseInt(_TraitType[SupportsIndex, int]):
    ...


class Int(BaseInt):
    ...


class _BaseFloat(_TraitType[_T, float]):
    ...


class BaseFloat(_TraitType[_Union[SupportsFloat, SupportsIndex], float]):
    ...


class Float(BaseFloat):
    ...


class _BaseComplex(_TraitType[_T, complex]):
    ...


class BaseComplex(_BaseComplex[complex]):
    ...


class Complex(BaseComplex):
    ...


class _BaseStr(_TraitType[_T, str]):
    ...


class BaseStr(_BaseStr[str]):
    ...


class Str(BaseStr):
    ...


class Title(Str):
    ...


class _BaseBytes(_TraitType[_T, bytes]):
    ...


class BaseBytes(_BaseBytes[bytes]):
    ...


class Bytes(BaseBytes):
    ...


class _BaseBool(_TraitType[_T, bool]):
    ...


class BaseBool(_BaseBool[bool]):
    default_value: bool = ...


class Bool(BaseBool):
    default_value: bool = ...


class _BaseCInt(_BaseInt[_Any]):
    default_value: _Any = ...


class BaseCInt(_BaseCInt):
    ...


class CInt(_BaseCInt):
    ...


class BaseCFloat(_BaseFloat[_Any]):
    ...


class CFloat(BaseCFloat):
    ...


class BaseCComplex(_BaseComplex[_Any]):
    ...


class CComplex(BaseCComplex):
    ...


class _BaseCStr(_BaseStr[_Any]):
    ...


class BaseCStr(_BaseCStr):
    ...


class CStr(_BaseCStr):
    ...


class BaseCBytes(_BaseBytes[_Any]):
    ...


class CBytes(BaseCBytes):
    ...


class BaseCBool(_BaseBool[_Any]):
    ...


class CBool(BaseCBool):
    ...


class _String(_TraitType[_T, str]):
    ...


class String(_String[str]):
    def __init__(
        self,
        value: str = ...,
        minlen: int = ...,
        maxlen: int = ...,
        regex: str = ...,
        **metadata: _Any
    ) -> None:
        ...


class Regex(String):
    ...


class Code(String):
    ...


class HTML(String):
    ...


class Password(String):
    ...


_OptionalCallable = Optional[_CallableType[..., _Any]]


class _BaseCallable(_TraitType[_OptionalCallable, _OptionalCallable]):
    ...


class BaseCallable(_BaseCallable):
    ...


class Callable(BaseCallable):
    ...


class BaseType(_TraitType[_Any, _Any]):
    ...


class This(BaseType):
    ...


class self(This):
    ...


class Module(_TraitType[_Any, _Any]):
    ...


class Python(_TraitType[_Any, _Any]):
    ...


class ReadOnly(_TraitType[_Any, _Any]):
    ...


class Disallow(_TraitType[_Any, _Any]):
    ...


class Constant(_TraitType[_Any, _Any]):
    ...


class Delegate(_TraitType[_Any, _Any]):
    def __init__(
        self,
        delegate: str = ...,
        prefix: str = ...,
        modify: bool = ...,
        listenable: bool = ...,
        **metadata: _Any
    ) -> None:
        ...


class DelegatesTo(Delegate):
    ...


class PrototypedFrom(Delegate):
    ...


class Expression(_TraitType[_Any, _Any]):
    ...


class PythonValue(Any):
    ...


class BaseFile(_TraitType[_Union[str, _PurePath], str]):
    def __init__(
        self,
        value: str = ...,
        filter: str = ...,
        auto_set: bool = ...,
        entries: int = ...,
        exists: bool = ...,
        **metadata: _Any
    ) -> None:
        ...


class File(BaseFile):
    ...


class BaseDirectory(_TraitType[_Union[str, _PurePath], str]):
    ...


class Directory(BaseDirectory):
    ...


# ----------------BaseRange---------------------
class _BaseRange(_TraitType[_T, _Union[int, float]]):
    def __init__(
        self,
        low: _Union[int, float, str] = ...,
        high: _Union[int, float, str] = ...,
        value: _Union[int, float, str] = ...,
        exclude_low: bool = ...,
        exclude_high: bool = ...,
        **metadata: _Any
    ) -> None:
        ...


class BaseRange(_BaseRange[_Union[int, float]]):
    ...


class Range(BaseRange):
    ...


class _BaseEnum(_TraitType[_T, _Any]):
    def __init__(
        self,
        *args: _Any,
        **metadata: _Any,
    ) -> None:
        ...


class BaseEnum(_BaseEnum[_Any]):
    ...


class Enum(BaseEnum):
    ...


class _BaseTuple(_TraitType[_T, _Tuple[_Any, ...]]):
    def __init__(
        self,
        *types: _Any,
        **metadata: _Any,
    ) -> None:
        ...


class BaseTuple(_BaseTuple[_Tuple[_Any, ...]]):
    ...


class Tuple(BaseTuple):
    ...


class ValidatedTuple(BaseTuple):
    def __init__(
        self,
        *types: _Any,
        fvalidate: _OptionalCallable = ...,
        fvalidate_info: Optional[str] = ...,
        **metadata: _Any
    ) -> None:
        ...


class _List(_TraitType[_Sequence[_S], _ListType[_T]]):
    def __init__(
        self,
        trait: _Union[_TraitType[_S, _T], _Type[_TraitType[_S, _T]]] = ...,
        value: _Sequence[_S] = ...,
        minlen: int = ...,
        maxlen: int = ...,
        items: bool = ...,
        **metadata: _Any
    ) -> None:
        ...


class List(_List[_S, _T]):
    ...


class CList(_List[_S, _T]):
    ...


class PrefixList(BaseStr):
    def __init__(
        self,
        values: _Sequence[str],
        **metadata: _Any,
    ) -> None:
        ...


class _Set(_TraitType[_SetType[_S], _SetType[_T]]):
    def __init__(
        self,
        trait: _Union[_TraitType[_S, _T], _Type[_TraitType[_S, _T]]] = ...,
        value: _Sequence[_S] = ...,
        items: bool = ...,
        **metadata: _Any
    ) -> None:
        ...


class Set(_Set[_S, _T]):
    ...


class CSet(Set[_S, _T]):
    ...


# _Dict accepts a dictionary with key type _S and value type _T,
# and stores a dictionary with key type _U and value type _V.

class _Dict(_TraitType[_DictType[_S, _T], _DictType[_U, _V]]):
    def __init__(
        self,
        key_trait: _Union[
            _TraitType[_S, _U], _Type[_TraitType[_S, _U]]] = ...,
        value_trait: _Union[
            _TraitType[_T, _V], _Type[_TraitType[_T, _V]]] = ...,
        value: _DictType[_S, _T] = ...,
        items: bool = ...,
        **metadata: _Any
    ) -> None:
        ...


class Dict(_Dict[_S, _T, _U, _V]):
    ...


class _Map(_TraitType[_S, _T]):
    def __init__(
        self,
        map: _DictType[_S, _T],
        **metadata: _Any
    ) -> None:
        ...


class Map(_Map[_Any, _Any]):
    ...


class _PrefixMap(_TraitType[_S, _T]):
    def __init__(
        self,
        map: _DictType[_S, _T],
        **metadata: _Any
    ) -> None:
        ...


class PrefixMap(_PrefixMap[_Any, _Any]):
    ...


class _BaseClass(_TraitType[_Union[_T, str, None], _Union[_T, str, None]]):
    ...


class BaseClass(_BaseClass[_Type[_Any]]):
    ...


class BaseInstance(_TraitType[_S, _S]):

    # simplified signatures

    @overload
    def __init__(
        self: BaseInstance[Optional[_T]],
        klass: _Type[_T],
        *args: _Any,
        allow_none: Literal[True] = ...,
        **metadata: _Any,
    ) -> None:
        ...

    @overload
    def __init__(
        self: BaseInstance[_T],
        klass: _Type[_T],
        *args: _Any,
        allow_none: Literal[False] = ...,
        **metadata: _Any,
    ) -> None:
        ...

    @overload
    def __init__(
        self: BaseInstance[_Any],
        klass: str,
        *args: _Any,
        **metadata: _Any,
    ) -> None:
        ...


class Instance(BaseInstance[_S]):

    @overload
    def __init__(
        self: Instance[Optional[_T]],
        klass: _Type[_T],
        *args: _Any,
        allow_none: Literal[True] = ...,
        **metadata: _Any,
    ) -> None:
        ...

    @overload
    def __init__(
        self: Instance[_T],
        klass: _Type[_T],
        *args: _Any,
        allow_none: Literal[False] = ...,
        **metadata: _Any,
    ) -> None:
        ...

    @overload
    def __init__(
        self: Instance[_Any],
        klass: str,
        *args: _Any,
        **metadata: _Any,
    ) -> None:
        ...


class Supports(Instance):
    ...


class AdaptsTo(Supports):
    ...


class Type(BaseClass):
    def __init__(
        self,
        value: Optional[_Type[_Any]] = ...,
        klass: Optional[_Union[_Type[_Any], str]] = ...,
        allow_none: bool = ...,
        **metadata: _Any
    ) -> None:
        ...


class Subclass(Type):
    ...


class Event(_TraitType[_Any, _Any]):
    ...


class Button(Event):
    def __init__(
        self,
        label: str = ...,
        image: _Any = ...,
        style: str = ...,
        values_trait: str = ...,
        orientation: str = ...,
        width_padding: int = ...,
        height_padding: int = ...,
        view: Optional[_Any] = ...,
        **metadata: _Any
    ) -> None:
        ...


class ToolbarButton(Button):
    def __init__(
        self,
        label: str = ...,
        image: _Any = ...,
        style: str = ...,
        orientation: str = ...,
        width_padding: int = ...,
        height_padding: int = ...,
        **metadata: _Any
    ) -> None:
        ...


class Either(_TraitType[_Any, _Any]):
    def __init__(
        self,
        *traits: _Any,
        **metadata: _Any
    ) -> None:
        ...


class Union(_TraitType[_Any, _Any]):
    def __init__(
        self,
        *traits: _Any,
        **metadata: _Any
    ) -> None:
        ...


class UUID(_TraitType[_Union[str, _UUID], _UUID]):
    def __init__(
        self,
        can_init: bool = ...,
        **metadata: _Any
    ) -> None:
        ...


class WeakRef(Instance):
    def __init__(
        self,
        klass: _Any = ...,
        allow_none: bool = ...,
        adapt: str = ...,
        **metadata: _Any
    ) -> None:
        ...


_OptionalDate = Optional[datetime.date]


class Date(_TraitType[_OptionalDate, _OptionalDate]):
    def __init__(
        self,
        default_value: datetime.date = ...,
        *,
        allow_datetime: bool = ...,
        allow_none: bool = ...,
        **metadata: _Any,
    ) -> None:
        ...


_OptionalDatetime = Optional[datetime.datetime]


class Datetime(_TraitType[_OptionalDatetime, _OptionalDatetime]):
    def __init__(
        self,
        default_value: datetime.datetime = ...,
        *,
        allow_none: bool = ...,
        **metadata: _Any,
    ) -> None:
        ...


_OptionalTime = Optional[datetime.time]


class Time(_TraitType[_OptionalTime, _OptionalTime]):
    def __init__(
        self,
        default_value: datetime.time = ...,
        *,
        allow_none: bool = ...,
        **metadata: _Any,
    ) -> None:
        ...


class AdaptedTo(Supports):
    ...


class BaseUnicode(BaseStr):
    ...


class Unicode(Str):
    ...


class BaseCUnicode(BaseStr):
    ...


class CUnicode(CStr):
    ...


class false(Bool):
    ...


class true(Bool):
    ...


undefined = _Any
