ml_switcheroo.utils.doc_context
===============================

.. py:module:: ml_switcheroo.utils.doc_context

.. autoapi-nested-parse::

   Documentation Context Builder.

   This module provides the logic to transform internal semantic definitions
   (from the ``SemanticsManager``) into a structured View Model suitable for
   rendering documentation pages (ReStructuredText/HTML).

   It handles:
   - formatting argument lists.
   - resolving implementation strategies (Direct vs Plugin vs Macro).
   - resolving documentation URLs via Framework Adapters.



Classes
-------

.. autoapisummary::

   ml_switcheroo.utils.doc_context.DocContextBuilder


Module Contents
---------------

.. py:class:: DocContextBuilder(semantics: ml_switcheroo.semantics.manager.SemanticsManager)

   Prepares view data for operation documentation pages.


   .. py:attribute:: semantics


   .. py:method:: build(op_name: str, definition: Dict[str, Any]) -> Dict[str, Any]

      Constructs the documentation context for a single operation.

      :param op_name: The abstract operation ID (e.g. "Linear").
      :param definition: The raw dictionary definition from the SemanticsManager.

      :returns:

                A structural dictionary containing:
                    - name (str)
                    - description (str)
                    - args (List[str]): Formatted signature strings.
                    - variants (List[Dict]): Implementation details per framework.
      :rtype: Dict