Upgrade pyright, improve pyright config files (#8072)

stubs/SQLAlchemy/@tests/stubtest_allowlist.txt

@@ -125,6 +125,15 @@ sqlalchemy.engine.url.URL.normalized_query
 # runtime has extra internal arguments that are inconsistent across micro versions
 sqlalchemy.testing.engines.testing_engine
 
+# __new__ signature conflicts with __init__ signature (which is more precise),
+# so __new__ is deliberately omitted in the stub
+sqlalchemy.sql.annotation.Annotated.__new__
+
+# At runtime __new__ is defined, but we define __init__ in the stub
+# because otherwise all subclasses would be identified by pyright
+# as having conflicting __new__/__init__ methods
+sqlalchemy.orm.unitofwork.PostSortRec.__new__
+
 # unclear problems
 sqlalchemy.sql.elements.quoted_name.lower
 sqlalchemy.sql.elements.quoted_name.upper

stubs/SQLAlchemy/sqlalchemy/orm/unitofwork.pyi

@@ -49,7 +49,10 @@ class Preprocess(IterateMappersMixin):
 
 class PostSortRec:
     disabled: Any
-    def __new__(cls, uow, *args): ...
+    # At runtime __new__ is defined, not __init__,
+    # But if we define __new__ here then all subclasses are identified by pyright
+    # as having __init__ methods that are inconsistent with their __new__ methods
+    def __init__(self, uow, *args) -> None: ...
     def execute_aggregate(self, uow, recs) -> None: ...
 
 class ProcessAll(IterateMappersMixin, PostSortRec):

stubs/SQLAlchemy/sqlalchemy/sql/annotation.pyi

@@ -7,7 +7,6 @@ class SupportsCloneAnnotations(SupportsAnnotations): ...
 class SupportsWrappingAnnotations(SupportsAnnotations): ...
 
 class Annotated:
-    def __new__(cls, *args): ...
     __dict__: Any
     def __init__(self, element, values) -> None: ...
     def __reduce__(self): ...