"""Mobile surface stub — reserved for future android/ios dump."""

from __future__ import annotations

from typing import Any, Optional

import target
from .base import DumpResult


class MobileDriver:
    def __init__(self, *, surface: str = target.SURFACE_ANDROID) -> None:
        self.surface = surface
        self.driver_name = "mobile_stub"

    def dump(
        self,
        *,
        info: Any,
        selection_meta: dict[str, Any],
        max_depth: int = 16,
        max_nodes: int = 8000,
        warmup_mode: str = "full",
        merge_same_pid_if_sparse: bool = True,
        warmed_pids: Optional[set[int]] = None,
    ) -> DumpResult:
        raise RuntimeError(
            f"ERROR:SURFACE_UNSUPPORTED 手机端拾取尚未实现（surface={self.surface}）。"
            "请先用桌面或浏览器目标。"
        )