Preliminary support for class decorators #2752

class ActorHandle[T]:
    """Wrapper returned by the @remote decorator."""
    def remote(self) -> T: ...
    def options(self, num_cpus: int) -> "ActorHandle[T]": ...

def remote[T](cls: type[T]) -> ActorHandle[T]:
    """Decorator that replaces a class with an ActorHandle wrapper."""
    return ActorHandle()

@remote
class Worker:
    def compute(self) -> int:
        return 42

# After decoration, Worker is ActorHandle[Worker], so .remote() is valid
Worker.remote()  # pyrefly: Class `Worker` has no class attribute `remote`
Worker.options(num_cpus=2)  # pyrefly: Class `Worker` has no class attribute `options`