"""Windows namespace: ``b.windows.*``."""
from __future__ import annotations

from browser_cli.sdk.base import Namespace

class WindowsNS(Namespace):
    """List, open, close, and rename browser windows."""

    def list(self) -> list[dict]:
        """Return browser windows.

        In implicit multi-browser mode each window dict includes a ``browser`` key.
        """
        return self._c._multi_list("windows.list", {}, self._c._tag_browser)

    def open(self, url: str | None = None) -> dict:
        """Open a new browser window, optionally on a URL."""
        return self._c._cmd("windows.open", {"url": url}) or {}

    def close(self, window_id: int) -> None:
        self._c._cmd("windows.close", {"windowId": window_id})

    def rename(self, window_id: int, name: str) -> None:
        self._c._cmd("windows.rename", {"windowId": window_id, "name": name})