Сокращение декоратора класса данных без потери IntelliSense

Сценарий

Предположим, я хочу создать псевдоним для декоратора dataclasses.dataclass с конкретными аргументами. Например:

# Instead of repeating this decorator all the time:
@dataclasses.dataclass(frozen=True, kw_only=True)
class Entity:
    ...

# I just write something like this:
@struct
class Entity:
    ...

Я использую статический анализатор Pylance в Visual Studio Code.

Я использую Python 3.11.

Попытка 1: Прямое присвоение (время выполнения ✅, статический анализ ❌)

Моим первым инстинктом было воспользоваться тем фактом, что функции являются первоклассными гражданами, и просто присвоить созданной функции-декоратору собственное имя. Это работает во время выполнения, но Pylance больше не распознает Entity как класс данных, о чем свидетельствует ошибка статического анализа:

struct = dataclasses.dataclass(frozen=True, kw_only=True)

@struct
class Entity:
    name: str
    value: int

# STATIC ANALYZER:
# Expected no arguments to "Entity" constructor Pylance(reportCallIssue)
valid_entity = Entity(name = "entity", value=42)

# RUNTIME:
# Entity(name='entity', value=42)
print(valid_entity)

Попытка 2: перенос (время выполнения ❌, статический анализ ❌)

Затем я подумал, что, возможно, некоторая информация каким-то образом потеряется, если я просто назначу другое имя (хотя я не понимаю, почему это так), поэтому я решил обернуть ее с помощью functools. Однако в статическом анализе это по-прежнему ведет себя так же и даже вызывает ошибку во время выполнения, когда я применяю @struct:

import dataclasses
import functools

def struct(cls):
    decorator = dataclasses.dataclass(frozen=True, kw_only=True)
    decorated_cls = decorator(cls)
    functools.update_wrapper(decorated_cls, cls)
    return decorated_cls

# No error reported by static analyzer, but runtime error at `@struct`:
# AttributeError: 'mappingproxy' object has no attribute 'update'
@struct
class Entity:
    name: str
    value: int

# STATIC ANALYZER:
# Expected no arguments to "Entity" constructor Pylance(reportCallIssue)
# RUNTIME:
# (this line doesn't even get reached)
valid_entity = Entity(name = "entity", value=42)

Полная трассировка:

Traceback (most recent call last):
  File "C:\Users\***\temp.py", line 12, in <module>
    @struct
     ^^^^^^
  File "C:\Users\***\temp.py", line 7, in struct
    functools.update_wrapper(decorated_cls, cls)
  File "C:\Users\***\AppData\Local\Programs\Python\Python311\Lib\functools.py", line 58, in update_wrapper
    getattr(wrapper, attr).update(getattr(wrapped, attr, {}))
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
AttributeError: 'mappingproxy' object has no attribute 'update'

Попытка 3: Фабрика оберток (время выполнения ✅, статический анализ ❌)

Затем я попытался создать struct фабрику декораторов и использовал functools.wraps() для функции закрытия, которая просто перенаправляет функцию класса данных. Теперь это работает во время выполнения, но Pylance по-прежнему сообщает о той же ошибке, что и в попытке 1:

def struct():
    decorator = dataclasses.dataclass(frozen=True, kw_only=True)

    @functools.wraps(decorator)
    def decorator_wrapper(*args, **kwargs):
        return decorator(*args, **kwargs)
    return decorator_wrapper

@struct()
class Entity:
    name: str
    value: int

# STATIC ANALYZER:
# Expected no arguments to "Entity" constructor Pylance(reportCallIssue)
valid_entity = Entity(name = "entity", value=42)

# RUNTIME:
# Entity(name='entity', value=42)
print(valid_entity)

Я также обнаружил, что использование самой простой функции dataclasses.dataclass (нет ()) приводит к одной и той же проблеме во всех трех попытках.

Есть ли способ заставить это работать, не испортив IntelliSense?

Дополнительное дополнение: почему попытка 2 не удалась во время выполнения?