# SPDX-FileCopyrightText: © 2026 Tenstorrent USA, Inc.
# SPDX-License-Identifier: Apache-2.0

"""Device side of the GR00T N1.5 / N1.6 / N1.7 port (``docs/plan/IMPLEMENTATION_PLAN.md`` §2).

Every module in this package imports ``ttnn`` lazily (inside functions / constructors), never at module import time,
so the configuration tables (``tt.layers.MATMUL_CONFIGS``, ``tt.layers.SDPA_CHUNKS``, the compute-kernel presets of
``tt.device``) and the shape validation of ``tt.blocks`` can be unit-tested on a CPU without a device
(IMPLEMENTATION_PLAN.md §2.1 rules, §7.1 "CPU unit" tier).

Wave-1 modules (WP-01):

* :mod:`tt.device` -- ``open_gr00t_device`` / ``close_gr00t_device`` (11x10 grid, 8 DRAM banks asserted),
  compute-kernel-config presets, ``L1`` / ``DRAM`` memory presets, ``dram_worker_cores``.
* :mod:`tt.layers` -- the op vocabulary with exactly one fixed configuration per call (plan §3.4): the matmul
  program-config table seeded from mb1, the SDPA chunk allowlist seeded from mb1 Table 3 + mb2 §B.1 / k320 sweep,
  HiFi4-fp32acc norms, head split / concat, RoPE, activations, row splicing.
* :mod:`tt.blocks` -- ``EncoderBlockTT``, the unified SigLIP / VL-SA encoder block built from :mod:`tt.layers`.
"""