Use :class: role in :type:/:rtype: directives for Sphinx cross-references

Aligns with existing codebase convention and ensures clickable
hyperlinks in generated API documentation.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: tpellissier

src/PowerPlatform/Dataverse/operations/query.py

@@ -61,32 +61,32 @@ def get(
 
         :param table: Schema name of the table (e.g. ``"account"`` or
             ``"new_MyTestTable"``).
-        :type table: str
+        :type table: :class:`str`
         :param select: Optional list of column logical names to include.
             Column names are automatically lowercased.
-        :type select: list[str] | None
+        :type select: :class:`list` of :class:`str` or None
         :param filter: Optional OData ``$filter`` expression (e.g.
             ``"name eq 'Contoso'"``). Column names in filter expressions must
             use exact lowercase logical names. Passed directly without
             transformation.
-        :type filter: str | None
+        :type filter: :class:`str` or None
         :param orderby: Optional list of sort expressions (e.g.
             ``["name asc", "createdon desc"]``). Column names are automatically
             lowercased.
-        :type orderby: list[str] | None
+        :type orderby: :class:`list` of :class:`str` or None
         :param top: Optional maximum total number of records to return.
-        :type top: int | None
+        :type top: :class:`int` or None
         :param expand: Optional list of navigation properties to expand (e.g.
             ``["primarycontactid"]``). Case-sensitive; must match server-defined
             names exactly.
-        :type expand: list[str] | None
+        :type expand: :class:`list` of :class:`str` or None
         :param page_size: Optional per-page size hint sent via
             ``Prefer: odata.maxpagesize``.
-        :type page_size: int | None
+        :type page_size: :class:`int` or None
 
         :return: Generator yielding pages, where each page is a list of record
             dictionaries.
-        :rtype: Iterable[list[dict[str, Any]]]
+        :rtype: :class:`collections.abc.Iterable` of :class:`list` of :class:`dict`
 
         Example:
             Query with filtering and pagination::
@@ -134,11 +134,11 @@ def sql(self, sql: str) -> List[Dict[str, Any]]:
         names only), and a simple table alias after FROM.
 
         :param sql: Supported SQL SELECT statement.
-        :type sql: str
+        :type sql: :class:`str`
 
         :return: List of result row dictionaries. Returns an empty list when no
             rows match.
-        :rtype: list[dict[str, Any]]
+        :rtype: :class:`list` of :class:`dict`
 
         :raises ~PowerPlatform.Dataverse.core.errors.ValidationError:
             If ``sql`` is not a string or is empty.

src/PowerPlatform/Dataverse/operations/records.py

@@ -63,14 +63,14 @@ def create(
         records via the ``CreateMultiple`` action and returns a list of GUIDs.
 
         :param table: Schema name of the table (e.g. ``"account"`` or ``"new_MyTestTable"``).
-        :type table: str
+        :type table: :class:`str`
         :param data: A single record dictionary or a list of record dictionaries.
             Each dictionary maps column schema names to values.
-        :type data: dict[str, Any] | list[dict[str, Any]]
+        :type data: :class:`dict` or :class:`list` of :class:`dict`
 
         :return: A single GUID string for a single record, or a list of GUID
             strings for bulk creation.
-        :rtype: str | list[str]
+        :rtype: :class:`str` or :class:`list` of :class:`str`
 
         :raises TypeError: If ``data`` is not a dict or list[dict].
 
@@ -122,12 +122,12 @@ def update(
            equal length).
 
         :param table: Schema name of the table (e.g. ``"account"``).
-        :type table: str
+        :type table: :class:`str`
         :param ids: A single GUID string, or a list of GUID strings.
-        :type ids: str | list[str]
+        :type ids: :class:`str` or :class:`list` of :class:`str`
         :param changes: A dictionary of field changes (single/broadcast), or a
             list of dictionaries (paired, one per ID).
-        :type changes: dict[str, Any] | list[dict[str, Any]]
+        :type changes: :class:`dict` or :class:`list` of :class:`dict`
 
         :raises TypeError: If ``ids`` is not str or list[str], or if ``changes``
             does not match the expected pattern.
@@ -182,16 +182,16 @@ def delete(
         ID) or deletes each record sequentially depending on ``use_bulk_delete``.
 
         :param table: Schema name of the table (e.g. ``"account"``).
-        :type table: str
+        :type table: :class:`str`
         :param ids: A single GUID string, or a list of GUID strings.
-        :type ids: str | list[str]
+        :type ids: :class:`str` or :class:`list` of :class:`str`
         :param use_bulk_delete: When True (default) and ``ids`` is a list, use
             the BulkDelete action and return its async job ID. When False, delete
             records one at a time.
-        :type use_bulk_delete: bool
+        :type use_bulk_delete: :class:`bool`
 
         :return: The BulkDelete job ID when bulk-deleting; otherwise None.
-        :rtype: str | None
+        :rtype: :class:`str` or None
 
         :raises TypeError: If ``ids`` is not str or list[str].
 
@@ -232,15 +232,15 @@ def get(
         """Fetch a single record by its GUID.
 
         :param table: Schema name of the table (e.g. ``"account"``).
-        :type table: str
+        :type table: :class:`str`
         :param record_id: GUID of the record to retrieve.
-        :type record_id: str
+        :type record_id: :class:`str`
         :param select: Optional list of column logical names to include in the
             response.
-        :type select: list[str] | None
+        :type select: :class:`list` of :class:`str` or None
 
         :return: Record dictionary with the requested attributes.
-        :rtype: dict[str, Any]
+        :rtype: :class:`dict`
 
         :raises TypeError: If ``record_id`` is not a string.
 

src/PowerPlatform/Dataverse/operations/tables.py

@@ -67,27 +67,27 @@ def create(
 
         :param table: Schema name of the table with customization prefix
             (e.g. ``"new_MyTestTable"``).
-        :type table: str
+        :type table: :class:`str`
         :param columns: Mapping of column schema names (with customization
             prefix) to their types. Supported types include ``"string"``
             (or ``"text"``), ``"int"`` (or ``"integer"``), ``"decimal"``
             (or ``"money"``), ``"float"`` (or ``"double"``), ``"datetime"``
             (or ``"date"``), ``"bool"`` (or ``"boolean"``), ``"file"``, and
             ``Enum`` subclasses
             (for local option sets).
-        :type columns: dict[str, Any]
+        :type columns: :class:`dict`
         :param solution: Optional solution unique name that should own the new
             table. When omitted the table is created in the default solution.
-        :type solution: str | None
+        :type solution: :class:`str` or None
         :param primary_column: Optional primary name column schema name with
             customization prefix (e.g. ``"new_ProductName"``). If not provided,
             defaults to ``"{prefix}_Name"``.
-        :type primary_column: str | None
+        :type primary_column: :class:`str` or None
 
         :return: Dictionary containing table metadata including
             ``table_schema_name``, ``entity_set_name``, ``table_logical_name``,
             ``metadata_id``, and ``columns_created``.
-        :rtype: dict[str, Any]
+        :rtype: :class:`dict`
 
         :raises ~PowerPlatform.Dataverse.core.errors.MetadataError:
             If table creation fails or the table already exists.
@@ -127,7 +127,7 @@ def delete(self, table: str) -> None:
         """Delete a custom table by schema name.
 
         :param table: Schema name of the table (e.g. ``"new_MyTestTable"``).
-        :type table: str
+        :type table: :class:`str`
 
         :raises ~PowerPlatform.Dataverse.core.errors.MetadataError:
             If the table does not exist or deletion fails.
@@ -150,12 +150,12 @@ def get(self, table: str) -> Optional[Dict[str, Any]]:
 
         :param table: Schema name of the table (e.g. ``"new_MyTestTable"``
             or ``"account"``).
-        :type table: str
+        :type table: :class:`str`
 
         :return: Dictionary containing ``table_schema_name``,
             ``table_logical_name``, ``entity_set_name``, and ``metadata_id``.
             Returns None if the table is not found.
-        :rtype: dict[str, Any] | None
+        :rtype: :class:`dict` or None
 
         Example::
 
@@ -173,7 +173,7 @@ def list(self) -> List[Dict[str, Any]]:
         """List all non-private tables in the Dataverse environment.
 
         :return: List of EntityDefinition metadata dictionaries.
-        :rtype: list[dict[str, Any]]
+        :rtype: :class:`list` of :class:`dict`
 
         Example::
 
@@ -194,14 +194,14 @@ def add_columns(
         """Add one or more columns to an existing table.
 
         :param table: Schema name of the table (e.g. ``"new_MyTestTable"``).
-        :type table: str
+        :type table: :class:`str`
         :param columns: Mapping of column schema names (with customization
             prefix) to their types. Supported types are the same as for
             :meth:`create`.
-        :type columns: dict[str, Any]
+        :type columns: :class:`dict`
 
         :return: Schema names of the columns that were created.
-        :rtype: list[str]
+        :rtype: :class:`list` of :class:`str`
 
         :raises ~PowerPlatform.Dataverse.core.errors.MetadataError:
             If the table does not exist.
@@ -227,14 +227,14 @@ def remove_columns(
         """Remove one or more columns from a table.
 
         :param table: Schema name of the table (e.g. ``"new_MyTestTable"``).
-        :type table: str
+        :type table: :class:`str`
         :param columns: Column schema name or list of column schema names to
             remove. Must include the customization prefix (e.g.
             ``"new_TestColumn"``).
-        :type columns: str | list[str]
+        :type columns: :class:`str` or :class:`list` of :class:`str`
 
         :return: Schema names of the columns that were removed.
-        :rtype: list[str]
+        :rtype: :class:`list` of :class:`str`
 
         :raises ~PowerPlatform.Dataverse.core.errors.MetadataError:
             If the table or a specified column does not exist.