🗑️ mark NBitBase as deprecated in type stubs (#425)

* 🗑️ mark`NBitBase` as deprecated in type stubs

* 🗑️ update deprecation message for `NBitBase`

Co-Authored-By: Joren Hammudoglu <[email protected]>

* 📝 add documentation link for `NBitBase` deprecation

Co-Authored-By: Joren Hammudoglu <[email protected]>

---------

Co-authored-by: Joren Hammudoglu <[email protected]>

Author: guan404ming

src/numpy-stubs/__init__.pyi

@@ -670,9 +670,9 @@ _SignedIntegerT = TypeVar("_SignedIntegerT", bound=signedinteger)
 _UnsignedIntegerT = TypeVar("_UnsignedIntegerT", bound=unsignedinteger)
 _CharT = TypeVar("_CharT", bound=character)
 
-_BitT = TypeVar("_BitT", bound=NBitBase, default=Any)
-_BitT1 = TypeVar("_BitT1", bound=NBitBase, default=Any)
-_BitT2 = TypeVar("_BitT2", bound=NBitBase, default=_BitT1)
+_BitT = TypeVar("_BitT", bound=NBitBase, default=Any)  # pyright: ignore[reportDeprecated]
+_BitT1 = TypeVar("_BitT1", bound=NBitBase, default=Any)  # pyright: ignore[reportDeprecated]
+_BitT2 = TypeVar("_BitT2", bound=NBitBase, default=_BitT1)  # pyright: ignore[reportDeprecated]
 
 _ItemT_co = TypeVar("_ItemT_co", default=Any, covariant=True)
 _BoolItemT_co = TypeVar("_BoolItemT_co", bound=py_bool, default=py_bool, covariant=True)

src/numpy-stubs/_typing/_nbit_base.pyi

@@ -1,17 +1,24 @@
 # mypy: disable-error-code="misc"
 from typing import final, type_check_only
+from typing_extensions import deprecated
 
 # exported as numpy.typing.NBitBase
 
+# Documentation: https://numpy.org/numtype/user_guide/differences/#no-more-nbitbase
 @final
+@deprecated(
+    "NBitBase is deprecated and should not be used. "
+    "NumPy scalar types are now concrete and no longer accept generic bounds like np.floating[T]. "
+    "Use abstract types (e.g., np.floating) as bounds instead."
+)
 class NBitBase: ...
 
 ###
 #
 
 # long double
 @type_check_only
-class _64L(NBitBase): ...  # pyright: ignore[reportGeneralTypeIssues]
+class _64L(NBitBase): ...  # pyright: ignore[reportDeprecated, reportGeneralTypeIssues]
 
 @type_check_only
 class _64(_64L): ...