"""Side-channel trace loading.

This module ONLY provides ChipWhisperer trace loading for integration
into Oscura workflows.

For actual side-channel attacks, use ChipWhisperer directly:
https://chipwhisperer.com/

What's here:
- ChipWhisperer .npy/.trs trace loading via oscura.loaders.chipwhisperer

What's NOT here (use ChipWhisperer instead):
- DPA/CPA attacks
- Key recovery
- Leakage assessment
- Template attacks
- Hardware interfacing

Example:
    >>> from oscura.loaders.chipwhisperer import load_chipwhisperer
    >>> traceset = load_chipwhisperer("capture_data.npy")
    >>> print(f"Loaded {traceset.n_traces} traces")

References:
    ChipWhisperer Project: https://chipwhisperer.com/
    ChipWhisperer Documentation: https://chipwhisperer.readthedocs.io/
"""

from __future__ import annotations

# Re-export ChipWhisperer loader for convenience
from oscura.loaders.chipwhisperer import (
    ChipWhispererTraceSet,
    load_chipwhisperer,
    load_chipwhisperer_npy,
    load_chipwhisperer_trs,
)

__all__ = [
    "ChipWhispererTraceSet",
    "load_chipwhisperer",
    "load_chipwhisperer_npy",
    "load_chipwhisperer_trs",
]
