Fix typing stub for new classmethod-only declaration.

Author: coleifer

peewee-stubs/__init__.pyi

@@ -1842,6 +1842,12 @@ class _BoundModelsContext(_callable_context_manager):
         self, exc_type: type[BaseException] | None, exc_val: BaseException | None, exc_tb: TracebackType | None
     ) -> None: ...
 
+# Mirrors the runtime classmethod_only descriptor: no instance overload, so
+# instance access is an error rather than the TypeError it raises at runtime.
+@type_check_only
+class _classmethod_only(Generic[_F]):
+    def __get__(self, instance: None, owner: type) -> _F: ...
+
 class Model(metaclass=ModelBase):
     __data__: Incomplete
     __rel__: Incomplete
@@ -1867,8 +1873,7 @@ class Model(metaclass=ModelBase):
     def replace_many(cls, rows, fields=None): ...
     @classmethod
     def raw(cls, sql, *params) -> ModelRaw: ...
-    @classmethod
-    def delete(cls) -> ModelDelete: ...
+    delete: _classmethod_only[Callable[[], ModelDelete]]
     @classmethod
     def create(cls, **query) -> Self: ...
     @classmethod

typecheck/check_stub.py

@@ -14,6 +14,7 @@
     IntegerField,
     Model,
     ModelAlias,
+    ModelDelete,
     ModelSelect,
     NodeList,
     NoopModelSelect,
@@ -88,6 +89,12 @@ class Event(Model):
 assert_type(User.select().get(), User)
 assert_type(User.select().get_or_none(), User | None)
 
+# delete() constructs a DELETE query and resolves only on the class. On an
+# instance it raises TypeError at runtime (delete_instance() is the instance
+# path), and the descriptor makes that a type error as well.
+assert_type(User.delete(), ModelDelete)
+User().delete()  # type: ignore
+
 
 # A `database=` argument accepts a real Database or a DatabaseProxy stand-in.
 proxy = DatabaseProxy()