Overview
========

The Python layer in QXel is organized around a small set of subsystems:

- ``QXel.provider.braket`` adapts the simulators to the AWS Braket
  ``LocalSimulator`` interface and translates Braket IR into internal QXel
  operators, observables, and result descriptors.
- ``QXel.simulator``, ``QXel.simulation``, and ``QXel.transpiler`` implement
  the high-level execution flow from circuit lowering through backend-specific
  execution plans.
- ``QXel.operator``, ``QXel.observable``, ``QXel.result``, ``QXel.tensor``,
  and ``QXel.types`` expose the typed building blocks backed by the native
  extension.
- ``QXel.core``, ``QXel.distributed``, ``QXel.functional``, and
  ``QXel.logging`` provide runtime services such as device selection, MPI
  collectives, kernel dispatch, and rank-aware logging.
- ``QXel.benchmark`` contains benchmark runners and helper scripts used to
  exercise the package against external circuit suites.

Reference generation notes
--------------------------

The Sphinx reference intentionally excludes two categories of source:

- ``src/QXel/benchmark/mqt-bench/``, which vendors an external benchmark
  project that already carries its own documentation.
- ``src/QXel/provider/braket/openqasm/parser/generated/``, which contains
  ANTLR-generated parser modules better treated as build artifacts than
  hand-authored API surfaces.