Fix docstring type annotations for Microsoft Learn compatibility

Replace Sphinx-style ':class:\list\ of :class:\str\' patterns with
Python bracket notation (list[str], dict[str, Any], etc.) in :type: and
:rtype: directives.

The Learn doc pipeline treats each word between :class: references as a
separate cross-reference (<xref:word>), causing connector words like
'of', 'mapping', and 'to' to produce broken <xref:of>, <xref:mapping>,
<xref:to> links that cannot be resolved.

Files fixed:
- client.py (14 occurrences)
- operations/records.py (14 occurrences)
- operations/tables.py (7 occurrences)
- operations/dataframe.py (3 occurrences)
- operations/query.py (1 occurrence)
- models/table_info.py (3 occurrences)

This reverts to the bracket notation style that was originally used
before the Sphinx docstring conversion in commit f0e8987.

Author: Saurabh Badenkal

src/PowerPlatform/Dataverse/client.py

@@ -208,10 +208,10 @@ def create(self, table_schema_name: str, records: Union[Dict[str, Any], List[Dic
         :type table_schema_name: :class:`str`
         :param records: A single record dictionary or a list of record dictionaries.
             Each dictionary should contain column schema names as keys.
-        :type records: :class:`dict` or :class:`list` of :class:`dict`
+        :type records: dict or list[dict]
 
         :return: List of created record GUIDs. Returns a single-element list for a single input.
-        :rtype: :class:`list` of :class:`str`
+        :rtype: list[str]
 
         :raises TypeError: If ``records`` is not a dict or list[dict], or if the internal
             client returns an unexpected type.
@@ -260,12 +260,12 @@ def update(
         :param table_schema_name:  Schema name of the table (e.g. ``"account"`` or ``"new_MyTestTable"``).
         :type table_schema_name: :class:`str`
         :param ids: Single GUID string or list of GUID strings to update.
-        :type ids: :class:`str` or :class:`list` of :class:`str`
+        :type ids: str or list[str]
         :param changes: Dictionary of changes for single/broadcast mode, or list of dictionaries
             for paired mode. When ``ids`` is a list and ``changes`` is a single dict,
             the same changes are broadcast to all records. When both are lists, they must
             have equal length for one-to-one mapping.
-        :type changes: :class:`dict` or :class:`list` of :class:`dict`
+        :type changes: dict or list[dict]
 
         :raises TypeError: If ``ids`` is not str or list[str], or if ``changes`` type doesn't match usage pattern.
 
@@ -312,7 +312,7 @@ def delete(
         :param table_schema_name: Schema name of the table (e.g. ``"account"`` or ``"new_MyTestTable"``).
         :type table_schema_name: :class:`str`
         :param ids: Single GUID string or list of GUID strings to delete.
-        :type ids: :class:`str` or :class:`list` of :class:`str`
+        :type ids: str or list[str]
         :param use_bulk_delete: When ``True`` (default) and ``ids`` is a list, execute the BulkDelete action and
             return its async job identifier. When ``False`` each record is deleted sequentially.
         :type use_bulk_delete: :class:`bool`
@@ -367,21 +367,21 @@ def get(
         :param record_id: Optional GUID to fetch a specific record. If None, queries multiple records.
         :type record_id: :class:`str` or None
         :param select: Optional list of attribute logical names to retrieve. Column names are case-insensitive and automatically lowercased (e.g. ``["new_Title", "new_Amount"]`` becomes ``"new_title,new_amount"``).
-        :type select: :class:`list` of :class:`str` or None
+        :type select: list[str] or None
         :param filter: Optional OData filter string, e.g. ``"name eq 'Contoso'"`` or ``"new_quantity gt 5"``. Column names in filter expressions must use exact lowercase logical names (e.g. ``"new_quantity"``, not ``"new_Quantity"``). The filter string is passed directly to the Dataverse Web API without transformation.
         :type filter: :class:`str` or None
         :param orderby: Optional list of attributes to sort by, e.g. ``["name asc", "createdon desc"]``. Column names are automatically lowercased.
-        :type orderby: :class:`list` of :class:`str` or None
+        :type orderby: list[str] or None
         :param top: Optional maximum number of records to return.
         :type top: :class:`int` or None
         :param expand: Optional list of navigation properties to expand, e.g. ``["primarycontactid"]``. Navigation property names are case-sensitive and must match the server-defined  names exactly. These are NOT automatically transformed. Consult entity metadata for correct casing.
-        :type expand: :class:`list` of :class:`str` or None
+        :type expand: list[str] or None
         :param page_size: Optional number of records per page for pagination.
         :type page_size: :class:`int` or None
 
         :return: Single record dict if ``record_id`` is provided, otherwise a generator
             yielding lists of record dictionaries (one list per page).
-        :rtype: :class:`dict` or :class:`collections.abc.Iterable` of :class:`list` of :class:`dict`
+        :rtype: dict or collections.abc.Iterable[list[dict]]
 
         :raises TypeError: If ``record_id`` is provided but not a string.
 
@@ -456,7 +456,7 @@ def query_sql(self, sql: str) -> List[Dict[str, Any]]:
         :type sql: :class:`str`
 
         :return: List of result row dictionaries. Returns an empty list if no rows match.
-        :rtype: :class:`list` of :class:`dict`
+        :rtype: list[dict]
 
         :raises ~PowerPlatform.Dataverse.core.errors.SQLParseError: If the SQL query uses unsupported syntax.
         :raises ~PowerPlatform.Dataverse.core.errors.HttpError: If the Web API returns an error.
@@ -545,7 +545,7 @@ class ItemStatus(IntEnum):
                           1036: {"Active": "Actif", "Inactive": "Inactif"}
                       }
 
-        :type columns: :class:`dict` mapping :class:`str` to :class:`typing.Any`
+        :type columns: dict[str, typing.Any]
         :param solution_unique_name: Optional solution unique name that should own the new table. When omitted the table is created in the default solution.
         :type solution_unique_name: :class:`str` or None
         :param primary_column_schema_name: Optional primary name column schema name with customization prefix value (e.g. ``"new_MyTestTable"``). If not provided, defaults to ``"{customization prefix value}_Name"``.
@@ -634,7 +634,7 @@ def list_tables(self) -> list[dict[str, Any]]:
         List all non-private tables in the Dataverse environment.
 
         :return: List of EntityDefinition metadata dictionaries.
-        :rtype: :class:`list` of :class:`dict`
+        :rtype: list[dict]
 
         Example:
             List all non-private tables and print their logical names::
@@ -666,9 +666,9 @@ def create_columns(
         :param columns: Mapping of column schema names (with customization prefix value) to supported types. All custom column names must include the customization prefix value** (e.g. ``"new_Notes"``). Primitive types include
             ``"string"`` (alias: ``"text"``), ``"int"`` (alias: ``"integer"``), ``"decimal"`` (alias: ``"money"``), ``"float"`` (alias: ``"double"``), ``"datetime"`` (alias: ``"date"``), ``"bool"`` (alias: ``"boolean"``), and ``"file"``. Enum subclasses (IntEnum preferred)
             generate a local option set and can specify localized labels via ``__labels__``.
-        :type columns: :class:`dict` mapping :class:`str` to :class:`typing.Any`
+        :type columns: dict[str, typing.Any]
         :returns: Schema names for the columns that were created.
-        :rtype: :class:`list` of :class:`str`
+        :rtype: list[str]
         Example:
             Create multiple columns on the custom table::
 
@@ -703,9 +703,9 @@ def delete_columns(
         :param table_schema_name: Schema name of the table (e.g. ``"new_MyTestTable"``).
         :type table_schema_name: :class:`str`
         :param columns: Column name or list of column names to remove. Must include customization prefix value (e.g. ``"new_TestColumn"``).
-        :type columns: :class:`str` or :class:`list` of :class:`str`
+        :type columns: str or list[str]
         :returns: Schema names for the columns that were removed.
-        :rtype: :class:`list` of :class:`str`
+        :rtype: list[str]
         Example:
             Remove two custom columns by schema name:
 

src/PowerPlatform/Dataverse/models/table_info.py

@@ -97,9 +97,9 @@ class TableInfo:
     :param description: Table description.
     :type description: :class:`str` or None
     :param columns: Column metadata (when retrieved).
-    :type columns: :class:`list` of :class:`ColumnInfo` or None
+    :type columns: list[ColumnInfo] or None
     :param columns_created: Column schema names created with the table.
-    :type columns_created: :class:`list` of :class:`str` or None
+    :type columns_created: list[str] or None
 
     Example::
 
@@ -241,7 +241,7 @@ class AlternateKeyInfo:
     :param schema_name: Key schema name.
     :type schema_name: :class:`str`
     :param key_attributes: List of column logical names that compose the key.
-    :type key_attributes: :class:`list` of :class:`str`
+    :type key_attributes: list[str]
     :param status: Index creation status (``"Active"``, ``"Pending"``, ``"InProgress"``, ``"Failed"``).
     :type status: :class:`str`
     """

src/PowerPlatform/Dataverse/operations/dataframe.py

@@ -75,15 +75,15 @@ def get(
         :param record_id: Optional GUID to fetch a specific record. If None, queries multiple records.
         :type record_id: :class:`str` or None
         :param select: Optional list of attribute logical names to retrieve.
-        :type select: :class:`list` of :class:`str` or None
+        :type select: list[str] or None
         :param filter: Optional OData filter string. Column names must use exact lowercase logical names.
         :type filter: :class:`str` or None
         :param orderby: Optional list of attributes to sort by.
-        :type orderby: :class:`list` of :class:`str` or None
+        :type orderby: list[str] or None
         :param top: Optional maximum number of records to return.
         :type top: :class:`int` or None
         :param expand: Optional list of navigation properties to expand (case-sensitive).
-        :type expand: :class:`list` of :class:`str` or None
+        :type expand: list[str] or None
         :param page_size: Optional number of records per page for pagination.
         :type page_size: :class:`int` or None
 

src/PowerPlatform/Dataverse/operations/query.py

@@ -51,8 +51,7 @@ def sql(self, sql: str) -> List[Record]:
 
         :return: List of :class:`~PowerPlatform.Dataverse.models.record.Record`
             objects. Returns an empty list when no rows match.
-        :rtype: :class:`list` of
-            :class:`~PowerPlatform.Dataverse.models.record.Record`
+        :rtype: list[~PowerPlatform.Dataverse.models.record.Record]
 
         :raises ~PowerPlatform.Dataverse.core.errors.ValidationError:
             If ``sql`` is not a string or is empty.

src/PowerPlatform/Dataverse/operations/records.py

@@ -69,11 +69,11 @@ def create(
         :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: :class:`dict` or :class:`list` of :class:`dict`
+        :type data: dict or list[dict]
 
         :return: A single GUID string for a single record, or a list of GUID
             strings for bulk creation.
-        :rtype: :class:`str` or :class:`list` of :class:`str`
+        :rtype: str or list[str]
 
         :raises TypeError: If ``data`` is not a dict or list[dict].
 
@@ -127,10 +127,10 @@ def update(
         :param table: Schema name of the table (e.g. ``"account"``).
         :type table: :class:`str`
         :param ids: A single GUID string, or a list of GUID strings.
-        :type ids: :class:`str` or :class:`list` of :class:`str`
+        :type ids: str or list[str]
         :param changes: A dictionary of field changes (single/broadcast), or a
             list of dictionaries (paired, one per ID).
-        :type changes: :class:`dict` or :class:`list` of :class:`dict`
+        :type changes: dict or list[dict]
 
         :raises TypeError: If ``ids`` is not str or list[str], or if ``changes``
             does not match the expected pattern.
@@ -187,7 +187,7 @@ def delete(
         :param table: Schema name of the table (e.g. ``"account"``).
         :type table: :class:`str`
         :param ids: A single GUID string, or a list of GUID strings.
-        :type ids: :class:`str` or :class:`list` of :class:`str`
+        :type ids: str or list[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.
@@ -241,7 +241,7 @@ def get(
         :type record_id: :class:`str`
         :param select: Optional list of column logical names to include in the
             response.
-        :type select: :class:`list` of :class:`str` or None
+        :type select: list[str] or None
 
         :return: Typed record with dict-like access for backward compatibility.
         :rtype: :class:`~PowerPlatform.Dataverse.models.record.Record`
@@ -282,29 +282,28 @@ def get(
         :type table: :class:`str`
         :param select: Optional list of column logical names to include.
             Column names are automatically lowercased.
-        :type select: :class:`list` of :class:`str` or None
+        :type select: list[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.
         :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: :class:`list` of :class:`str` or None
+        :type orderby: list[str] or None
         :param top: Optional maximum total number of records to return.
         :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: :class:`list` of :class:`str` or None
+        :type expand: list[str] or None
         :param page_size: Optional per-page size hint sent via
             ``Prefer: odata.maxpagesize``.
         :type page_size: :class:`int` or None
 
         :return: Generator yielding pages, where each page is a list of
             :class:`~PowerPlatform.Dataverse.models.record.Record` objects.
-        :rtype: :class:`collections.abc.Iterable` of :class:`list` of
-            :class:`~PowerPlatform.Dataverse.models.record.Record`
+        :rtype: collections.abc.Iterable[list[~PowerPlatform.Dataverse.models.record.Record]]
 
         Example:
             Fetch with filtering and pagination::
@@ -356,7 +355,7 @@ def get(
         :type record_id: :class:`str` or None
         :param select: Optional list of column logical names to include.
             Column names are automatically lowercased.
-        :type select: :class:`list` of :class:`str` or None
+        :type select: list[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. Only used for multi-record
@@ -365,23 +364,22 @@ def get(
         :param orderby: Optional list of sort expressions (e.g.
             ``["name asc", "createdon desc"]``). Column names are
             automatically lowercased. Only used for multi-record queries.
-        :type orderby: :class:`list` of :class:`str` or None
+        :type orderby: list[str] or None
         :param top: Optional maximum total number of records to return. Only
             used for multi-record queries.
         :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. Only used for multi-record queries.
-        :type expand: :class:`list` of :class:`str` or None
+        :type expand: list[str] or None
         :param page_size: Optional per-page size hint sent via
             ``Prefer: odata.maxpagesize``. Only used for multi-record queries.
         :type page_size: :class:`int` or None
 
         :return: A single record dict when ``record_id`` is provided, or a
             generator yielding pages (lists of record dicts) when fetching
             multiple records.
-        :rtype: :class:`dict` or :class:`collections.abc.Iterable` of
-            :class:`list` of :class:`dict`
+        :rtype: dict or collections.abc.Iterable[list[dict]]
 
         :raises TypeError: If ``record_id`` is provided but not a string.
         :raises ValueError: If query parameters are provided alongside

src/PowerPlatform/Dataverse/operations/tables.py

@@ -213,10 +213,10 @@ def list(
             ``["LogicalName", "SchemaName", "DisplayName"]``).
             When ``None`` (the default) or an empty list, all properties are
             returned.
-        :type select: :class:`list` of :class:`str` or None
+        :type select: list[str] or None
 
         :return: List of EntityDefinition metadata dictionaries.
-        :rtype: :class:`list` of :class:`dict`
+        :rtype: list[dict]
 
         Example::
 
@@ -255,7 +255,7 @@ def add_columns(
         :type columns: :class:`dict`
 
         :return: Schema names of the columns that were created.
-        :rtype: :class:`list` of :class:`str`
+        :rtype: list[str]
 
         :raises ~PowerPlatform.Dataverse.core.errors.MetadataError:
             If the table does not exist.
@@ -285,10 +285,10 @@ def remove_columns(
         :param columns: Column schema name or list of column schema names to
             remove. Must include the customization prefix (e.g.
             ``"new_TestColumn"``).
-        :type columns: :class:`str` or :class:`list` of :class:`str`
+        :type columns: str or list[str]
 
         :return: Schema names of the columns that were removed.
-        :rtype: :class:`list` of :class:`str`
+        :rtype: list[str]
 
         :raises ~PowerPlatform.Dataverse.core.errors.MetadataError:
             If the table or a specified column does not exist.
@@ -612,7 +612,7 @@ def create_alternate_key(
         :type key_name: :class:`str`
         :param columns: List of column logical names that compose the key
             (e.g. ``["new_productcode"]``).
-        :type columns: :class:`list` of :class:`str`
+        :type columns: list[str]
         :param display_name: Display name for the key. Defaults to
             ``key_name`` if not provided.
         :type display_name: :class:`str` or None
@@ -660,7 +660,7 @@ def get_alternate_keys(self, table: str) -> List[AlternateKeyInfo]:
 
         :return: List of alternate key metadata objects. May be empty if no
             alternate keys are defined.
-        :rtype: :class:`list` of :class:`~PowerPlatform.Dataverse.models.table_info.AlternateKeyInfo`
+        :rtype: list[~PowerPlatform.Dataverse.models.table_info.AlternateKeyInfo]
 
         :raises ~PowerPlatform.Dataverse.core.errors.MetadataError:
             If the table does not exist.