Improve type hints for generated properties.

[junkmd]

This change improves the accuracy and PEP 570 compliance of type hints generated by comtypes.
Specifically, it refines the signature generation for named properties, especially those taking multiple arguments (like propput and propputref).
It also adds syntax validation tests for generated interface members.

Note

The following code is an excerpt from the definitions of the Range property of _Worksheet and the Value property of Range in Excel.
With this implementation, Pylance can successfully resolve the type definitions and display them in the hover tooltip.

from comtypes import GUID
from comtypes.automation import IDispatch

if TYPE_CHECKING:
    from comtypes import hints


class Range(IDispatch):
    _case_insensitive_ = True
    _iid_ = GUID("{00020846-0000-0000-C000-000000000046}")
    _idlflags_ = []
    _methods_ = []

    if TYPE_CHECKING:  # dispmembers

        def _get_Value(
            self, RangeValueDataType: hints.Incomplete = ..., /
        ) -> hints.Incomplete: ...
        def _set_Value(
            self,
            RangeValueDataType: hints.Incomplete = ...,
            /,
            *args: hints.Unpack[tuple[hints.Incomplete]],
        ) -> hints.Incomplete: ...

        Value = hints.named_property("Value", _get_Value, _set_Value)


class _Worksheet(IDispatch):
    _case_insensitive_ = True
    _iid_ = GUID("{000208D8-0000-0000-C000-000000000046}")
    _idlflags_ = ["dual", "nonextensible", "oleautomation"]

    if TYPE_CHECKING:  # commembers

        def _get_Range(
            self, Cell1: hints.Incomplete, Cell2: hints.Incomplete = ...
        ) -> "Range": ...

        Range = hints.named_property("Range", _get_Range)


ws: _Worksheet = ...  # type: ignore
ws.Range("A1").Value
a = ws.Range("A1").Value[:]
ws.Range("A1").Value[:] = "foo"

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 85.02%. Comparing base (9126c8c) to head (0c95ef4).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #889      +/-   ##
==========================================
+ Coverage   85.00%   85.02%   +0.02%     
==========================================
  Files         126      126              
  Lines       11699    11716      +17     
==========================================
+ Hits         9945     9962      +17     
  Misses       1754     1754              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.