"""Type aliases for working with parsed OpenAPI documents.

We operate on raw dicts from the YAML/JSON parser rather than
strict dataclasses, since the OpenAPI structure is deeply nested
and we only need to read specific paths.
"""

from typing import Any

OpenAPIDict = dict[str, Any]
"""A parsed OpenAPI document represented as a nested dict."""

SchemaDict = dict[str, Any]
"""A single OpenAPI schema object."""

PathItemDict = dict[str, Any]
"""A single path item from ``paths``."""

OperationDict = dict[str, Any]
"""A single operation object (get, post, etc.)."""

ParameterDict = dict[str, Any]
"""A single parameter object."""

ResponseDict = dict[str, Any]
"""A single response object."""
