camera-ui-sdk 1.4.2__tar.gz → 1.4.4__tar.gz

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: camera-ui-sdk
-Version: 1.4.2
+Version: 1.4.4
 Summary: camera.ui sdk
 Author-email: seydx <hi@seydx.dev>
 Maintainer-email: seydx <hi@seydx.dev>
@@ -28,10 +28,10 @@ Provides-Extra: dev
 Requires-Dist: build>=1.6.1; extra == "dev"
 Requires-Dist: twine>=7.0.0; extra == "dev"
 Requires-Dist: mypy>=2.4.0; extra == "dev"
-Requires-Dist: ruff>=0.17.1; extra == "dev"
+Requires-Dist: ruff>=0.17.2; extra == "dev"
 Provides-Extra: docs
-Requires-Dist: mkdocs-material>=9.7.7; extra == "docs"
-Requires-Dist: mkdocstrings[python]>=1.0.7; extra == "docs"
+Requires-Dist: mkdocs-material>=9.8.0; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=1.0.8; extra == "docs"
 Requires-Dist: mkdocs>=1.6.1; extra == "docs"
 Requires-Dist: mkdocs-exclude>=1.0.2; extra == "docs"
 Dynamic: license-file

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk/camera/device.py

@@ -245,7 +245,7 @@ class CameraDevice(Protocol):
 
     @property
     def snapshotSource(self) -> CameraSource | None:
-        """Snapshot source (if available)."""
+        """Source that getSnapshot uses: the snapshot source or the one marked for snapshots, otherwise the low, mid or high resolution source."""
         ...
 
     @property
@@ -296,6 +296,21 @@ class CameraDevice(Protocol):
         """
         ...
 
+    async def getSnapshot(self, forceNew: bool = False) -> bytes | None:
+        """
+        Get a snapshot from the snapshot source, see ``snapshotSource``.
+
+        Args:
+            forceNew: Force fresh snapshot (ignore cache).
+
+        Returns:
+            JPEG image data, or None if the camera has no source or no picture.
+
+        Example:
+            jpeg = await camera.getSnapshot()
+        """
+        ...
+
     def createStorage(self, schemas: list[JsonSchema]) -> DeviceStorage:
         """
         Create storage for plugin-specific camera configuration.

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk/internal/__init__.py

@@ -20,33 +20,25 @@ if TYPE_CHECKING:
     from .streaming_internal import IceServer
 
 __all__ = [
-    # Events
     "AsyncEventEmitter",
-    # Manager
     "ConnectionStatus",
     "DiscoveredCameraWithState",
-    # Sensor wire-format / RPC
     "SensorJSON",
     "PropertyChangedEvent",
     "PropertyUpdateFn",
     "CapabilityUpdateFn",
     "SensorSourcePatch",
     "SourceUpdateFn",
-    # Camera wire-format
     "DetectionEventMessage",
-    # Streaming
     "IceServer",
-    # Camera enums
     "FrameType",
     "CameraFrameWorkerDecoder",
-    # Camera config
     "CameraInputSettings",
     "CameraConfigPartial",
-    # Utils
     "is_equal",
 ]
 
-# public name → (submodule, attribute), resolved lazily to avoid circular imports during SDK bootstrap
+# resolved lazily to avoid circular imports during SDK bootstrap
 _LAZY: dict[str, tuple[str, str]] = {
     "AsyncEventEmitter": (".event_emitter", "AsyncEventEmitter"),
     "ConnectionStatus": (".manager_rpc", "ConnectionStatus"),

camera_ui_sdk-1.4.4/camera_ui_sdk/internal/camera_config_internal.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+from typing import NotRequired, TypedDict
+
+from ..camera.config import CameraConfigInputSettings, CameraInformation
+from ..camera.enums import CameraRole, StreamingRole
+
+
+class CameraInputSettings(TypedDict):
+    _id: str
+    name: str
+    role: CameraRole
+    useForSnapshot: bool
+    hotMode: bool
+    preload: bool
+    muted: NotRequired[bool]
+    urls: list[str]
+    childSourceId: NotRequired[str]
+    childCameraId: NotRequired[str]
+    childCameraRole: NotRequired[StreamingRole]
+
+
+class CameraConfigPartial(TypedDict, total=False):
+    name: str
+    nativeId: str
+    isCloud: bool
+    disabled: bool
+    info: CameraInformation
+    sources: list[CameraConfigInputSettings]

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk/internal/camera_enums.py

@@ -3,7 +3,5 @@ from __future__ import annotations
 from typing import Literal
 
 FrameType = Literal["stream", "motion"]
-"""Frame type identifier for frame workers."""
 
 CameraFrameWorkerDecoder = Literal["wasm", "rust"]
-"""Frame worker decoder implementation."""

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk/internal/camera_wire.py

@@ -7,9 +7,5 @@ from ..camera.events import DetectionEvent
 
 
 class DetectionEventMessage(TypedDict):
-    """Detection event message published via NATS."""
-
     type: DetectionEventType
-    """Event lifecycle type."""
     data: DetectionEvent
-    """Full event data."""

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk/internal/event_emitter.py

@@ -7,18 +7,11 @@ from typing import Any
 
 
 class AsyncEventEmitter:
-    """Event-listener registry that accepts sync and async handlers.
-
-    Listeners are keyed by event name and invoked in registration order. Async
-    handlers are scheduled fire-and-forget and tracked so :meth:`cancel` can stop them.
-    """
-
     def __init__(self) -> None:
         self._events: dict[str, OrderedDict[Callable[..., Any], Callable[..., Any]]] = {}
         self._waiting: set[asyncio.Future[Any]] = set()
 
     def on(self, event: str, f: Callable[..., Any]) -> Callable[..., Any]:
-        """Register a listener (sync or async) that is invoked for every emission of *event*."""
         event = self._normalize_event(event)
         listeners = self._events.get(event)
         if listeners is None:
@@ -28,7 +21,6 @@ class AsyncEventEmitter:
         return f
 
     def once(self, event: str, f: Callable[..., Any]) -> Callable[..., Any]:
-        """Register a one-shot listener that runs on the next emission of *event*, then removes itself."""
         event = self._normalize_event(event)
 
         def wrapper(*args: Any, **kwargs: Any) -> Any:
@@ -43,11 +35,6 @@ class AsyncEventEmitter:
         return f
 
     def emit(self, event: str, *args: Any, **kwargs: Any) -> bool:
-        """Invoke every listener registered for *event* with the given arguments.
-
-        Returns ``True`` if *event* had listeners, ``False`` otherwise.
-        Async handlers are scheduled as fire-and-forget tasks.
-        """
         event = self._normalize_event(event)
         listeners = self._events.get(event)
         if not listeners:
@@ -70,13 +57,6 @@ class AsyncEventEmitter:
         on_error: Callable[[BaseException], None] | None = None,
         **kwargs: Any,
     ) -> bool:
-        """Invoke every listener registered for *event* and wait for async handlers to settle.
-
-        Handler exceptions go to *on_error* instead of propagating, so one failing
-        listener never blocks the others. Returns ``False`` if handlers were still
-        pending after *timeout* seconds, they keep running and stay cancellable
-        via :meth:`cancel`.
-        """
         event = self._normalize_event(event)
         listeners = self._events.get(event)
 
@@ -107,7 +87,6 @@ class AsyncEventEmitter:
         return not still_pending
 
     def remove_listener(self, event: str, f: Callable[..., Any]) -> None:
-        """Remove a previously registered listener *f* from *event*. No-op if it is not registered."""
         event = self._normalize_event(event)
         listeners = self._events.get(event)
         if listeners is not None:
@@ -116,19 +95,16 @@ class AsyncEventEmitter:
                 del self._events[event]
 
     def remove_all_listeners(self, event: str | None = None) -> None:
-        """Remove every listener for *event*, or every listener for every event when *event* is ``None``."""
         if event is not None:
             self._events.pop(self._normalize_event(event), None)
         else:
             self._events.clear()
 
     def cancel(self) -> None:
-        """Cancel all pending async tasks."""
         for future in self._waiting:
             future.cancel()
         self._waiting.clear()
 
     @staticmethod
     def _normalize_event(event: Any) -> str:
-        """Accept both plain event names and enum members."""
         return event.value if hasattr(event, "value") else str(event)

camera_ui_sdk-1.4.4/camera_ui_sdk/internal/manager_rpc.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from typing import Literal, NotRequired
+
+from ..manager import DiscoveredCamera
+
+ConnectionStatus = Literal["idle", "connecting", "connected", "error"]
+
+
+class DiscoveredCameraWithState(DiscoveredCamera):
+    provider: str
+
+    connectionStatus: ConnectionStatus
+
+    errorMessage: NotRequired[str]

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk/internal/sensor_rpc.py

@@ -54,68 +54,39 @@ if TYPE_CHECKING:
 
 
 class PropertyChangedEvent(TypedDict):
-    """Emitted when a sensor property value changes."""
-
     sensorId: str
-    """Sensor that changed."""
     sensorType: SensorType
-    """Type of the sensor that changed."""
     property: str
-    """Property key that changed."""
     value: object
-    """New value."""
-    previousValue: NotRequired[object]
-    """Not sent by the server, keep the last value yourself if you need it."""
-    timestamp: int
-    """Change time in epoch milliseconds."""
+    previousValue: NotRequired[object]  # never sent by the server
+    timestamp: int  # epoch ms
 
 
 PropertyUpdateFn = Callable[[dict[str, Any]], None]
-"""Receives a partial-state delta, one call per ``_write_state``."""
 
 CapabilityUpdateFn = Callable[[list[str]], None]
-"""Receives the full capability list whenever it changes."""
 
 
 class SensorSourcePatch(TypedDict):
-    """Source fields a sensor reports to the registry, only the changed ones."""
-
     sourceState: NotRequired[SensorSourceState]
     address: NotRequired[str]
 
 
 SourceUpdateFn = Callable[[SensorSourcePatch], None]
-"""Receives a source patch, one call per ``setSourceState`` / ``setAddress``."""
 
 
 class SensorJSON(TypedDict):
-    """JSON-serializable representation of a sensor for RPC transport."""
-
     id: str
-    """Sensor ID."""
     type: SensorType
-    """Sensor type."""
     name: str
-    """Internal name."""
     displayName: str
-    """Name shown in the UI."""
     category: SensorCategory
-    """Category the sensor belongs to."""
     nativeId: NotRequired[str]
-    """Device ID assigned by the plugin."""
     origin: NotRequired[str]
-    """Source system the sensor was imported from, e.g. ``'homeassistant'``."""
     pluginId: NotRequired[str]
-    """Plugin that owns the sensor."""
     properties: dict[str, Any]
-    """Current property values."""
     capabilities: NotRequired[list[str]]
-    """Capability keys the sensor reports."""
     requiresFrames: NotRequired[bool]
-    """Sensor needs a frame feed to work."""
     modelSpec: NotRequired[ModelSpec]
-    """Model the sensor runs, for ML-backed sensors."""
     sourceState: NotRequired[SensorSourceState]
-    """The plugin's view of the source behind an adopted sensor."""
     address: NotRequired[str]
-    """Current address at the source, e.g. a Home Assistant entity id."""

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk/internal/shared_utils.py

@@ -4,21 +4,6 @@ from typing import Any
 
 
 def is_equal(first: Any, second: Any, ignore_order: bool = False) -> bool:
-    """Deep equality for primitives, lists, and dicts. Dict key order never matters.
-
-    Args:
-        first: First value to compare.
-        second: Second value to compare.
-        ignore_order: Compare lists as multisets instead of position by position.
-
-    Returns:
-        ``True`` if the values are deeply equal.
-
-    Example:
-        ```python
-        is_equal({"a": 1, "b": 2}, {"b": 2, "a": 1})  # True
-        ```
-    """
     if first is second:
         return True
 

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk/internal/streaming_internal.py

@@ -6,11 +6,6 @@ from typing_extensions import TypedDict
 
 
 class IceServer(TypedDict):
-    """WebRTC ICE server configuration."""
-
     urls: list[str]
-    """STUN/TURN server URLs."""
     username: NotRequired[str]
-    """Authentication username."""
     credential: NotRequired[str]
-    """Authentication credential."""

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk/manager/__init__.py

@@ -48,6 +48,8 @@ class AssistantAskRequest(TypedDict, total=False):
     images: list[AssistantAskImage]
     outputSchema: dict[str, Any]
     timeoutMs: int
+    modelId: str
+    """Id of a configured model to answer with instead of the assigned one. The plugin still needs access, an unknown id falls back to the assigned model."""
 
 
 class AssistantAskResult(TypedDict, total=False):

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk/observable/__init__.py

@@ -269,7 +269,6 @@ class Subject(Generic[T]):
         return Observable(lambda cb: self.subscribe(cb))
 
     def _on_complete(self, handler: Callable[[], None]) -> Disposable:
-        """Register a handler run once on completion, immediately if already completed."""
         if self._completed:
             handler()
             return Disposable(lambda: None)

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk/sensor/base.py

@@ -583,10 +583,6 @@ class Sensor(ABC, Generic[TProperties, TStorage, TCapability]):
             self._write_state({"modelSpec": spec})
 
     def _write_state(self, partial: Mapping[str, Any]) -> None:
-        """Write changed properties, fire one batched RPC update and notify listeners.
-
-        Used by the semantic helpers on each sensor type, not by plugin code.
-        """
         delta: dict[str, Any] = {}
         changes: list[tuple[str, Any, Any]] = []
 
@@ -616,18 +612,10 @@ class Sensor(ABC, Generic[TProperties, TStorage, TCapability]):
         fallback_label: str,
         fallback_extra: dict[str, Any] | None = None,
     ) -> list[dict[str, Any]]:
-        """Normalize the arguments of a `reportDetections(detected, detections)` call.
-
-        - `detected` is False: returns `[]` (clear).
-        - `detected` is True with detections: returns them, substituting a full-frame box where missing.
-        - `detected` is True without detections: returns one synthesized full-frame
-          detection carrying `fallback_label` and `fallback_extra`.
-        """
         if not detected:
             return []
         if detections:
-            # smart-camera plugins report labels without coordinates, downstream
-            # consumers (coordinator, zone matching) require a box on every detection
+            # smart-camera plugins report labels without coordinates, consumers need a box on every detection
             return [
                 detection
                 if detection.get("box")
@@ -647,7 +635,6 @@ class Sensor(ABC, Generic[TProperties, TStorage, TCapability]):
         self._storage = storage
 
     def _fire_lifecycle(self, active: bool) -> None:
-        """Invoke the lifecycle hook and schedule it if the override is async."""
         try:
             result = self.on_start() if active else self.on_stop()
         except Exception:  # noqa: BLE001 - lifecycle errors must not break bookkeeping

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk/sensor/classifier.py

@@ -152,8 +152,7 @@ class ClassifierSensor(Sensor[ClassifierSensorProperties, TStorage, str], Generi
             "motion",
             {"attribute": "", "subAttribute": ""},
         )
-        # the specific answer wins (subAttribute, e.g. the bird species), and labels
-        # accumulate while the classifier keeps firing, so automations don't flap
+        # the specific answer (subAttribute) wins, labels accumulate while firing so automations don't flap
         recognized = [
             label for d in list_ if (label := d.get("subAttribute") or d.get("attribute") or d.get("label"))
         ]

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk/sensor/face.py

@@ -150,8 +150,7 @@ class FaceSensor(Sensor[FaceSensorProperties, TStorage, str], Generic[TStorage])
             "person",
             {"attribute": "face"},
         )
-        # recognized names accumulate while faces stay visible, so automations
-        # don't flap when a face is momentarily unrecognized mid-presence
+        # names accumulate while faces stay visible, so automations don't flap on a missed recognition
         recognized = [d["identity"] for d in list_ if d.get("identity")]
         state: dict[str, Any] = {
             FaceProperty.Detected.value: detected,

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk/sensor/license_plate.py

@@ -156,8 +156,7 @@ class LicensePlateSensor(Sensor[LicensePlateSensorProperties, TStorage, str], Ge
             "vehicle",
             {"attribute": "license_plate", "plateText": ""},
         )
-        # recognized plates accumulate while plates stay visible, so automations
-        # don't flap when the OCR misses a frame mid-presence
+        # plates accumulate while visible, so automations don't flap when the OCR misses a frame
         recognized = [d["plateText"] for d in list_ if d.get("plateText")]
         state: dict[str, Any] = {
             LicensePlateProperty.Detected.value: detected,

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: camera-ui-sdk
-Version: 1.4.2
+Version: 1.4.4
 Summary: camera.ui sdk
 Author-email: seydx <hi@seydx.dev>
 Maintainer-email: seydx <hi@seydx.dev>
@@ -28,10 +28,10 @@ Provides-Extra: dev
 Requires-Dist: build>=1.6.1; extra == "dev"
 Requires-Dist: twine>=7.0.0; extra == "dev"
 Requires-Dist: mypy>=2.4.0; extra == "dev"
-Requires-Dist: ruff>=0.17.1; extra == "dev"
+Requires-Dist: ruff>=0.17.2; extra == "dev"
 Provides-Extra: docs
-Requires-Dist: mkdocs-material>=9.7.7; extra == "docs"
-Requires-Dist: mkdocstrings[python]>=1.0.7; extra == "docs"
+Requires-Dist: mkdocs-material>=9.8.0; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=1.0.8; extra == "docs"
 Requires-Dist: mkdocs>=1.6.1; extra == "docs"
 Requires-Dist: mkdocs-exclude>=1.0.2; extra == "docs"
 Dynamic: license-file

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/camera_ui_sdk.egg-info/requires.txt

@@ -4,11 +4,11 @@ typing_extensions>=4.16.0
 build>=1.6.1
 twine>=7.0.0
 mypy>=2.4.0
-ruff>=0.17.1
+ruff>=0.17.2
 
 [docs]
-mkdocs-material>=9.7.7
-mkdocstrings[python]>=1.0.7
+mkdocs-material>=9.8.0
+mkdocstrings[python]>=1.0.8
 mkdocs>=1.6.1
 mkdocs-exclude>=1.0.2
 

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["setuptools>=84.0.0"]
+requires = ["setuptools>=84.2.1"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "camera-ui-sdk"
-version = "1.4.2"
+version = "1.4.4"
 description = "camera.ui sdk"
 keywords = ["camera.ui", "python", "sdk"]
 readme = "README.md"
@@ -32,11 +32,11 @@ dev = [
     "build>=1.6.1",
     "twine>=7.0.0",
     "mypy>=2.4.0",
-    "ruff>=0.17.1",
+    "ruff>=0.17.2",
 ]
 docs = [
-    "mkdocs-material>=9.7.7",
-    "mkdocstrings[python]>=1.0.7",
+    "mkdocs-material>=9.8.0",
+    "mkdocstrings[python]>=1.0.8",
     "mkdocs>=1.6.1",
     "mkdocs-exclude>=1.0.2",
 ]

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/tests/test_event_emitter.py

@@ -1,5 +1,3 @@
-"""Tests for AsyncEventEmitter."""
-
 from __future__ import annotations
 
 import asyncio
@@ -8,8 +6,6 @@ import pytest
 
 from camera_ui_sdk.internal import AsyncEventEmitter
 
-# ── on + emit (sync) ─────────────────────────────────────────────────
-
 
 class TestOnEmitSync:
     def test_sync_handler_called(self) -> None:
@@ -30,9 +26,6 @@ class TestOnEmitSync:
         assert results == [1, 2]
 
 
-# ── on + emit (async) ────────────────────────────────────────────────
-
-
 class TestOnEmitAsync:
     @pytest.mark.asyncio
     async def test_async_handler_fire_and_forget(self) -> None:
@@ -45,14 +38,10 @@ class TestOnEmitAsync:
         ee.on("test", handler)
         ee.emit("test", "async_val")
 
-        # Give the scheduled coroutine a chance to run
         await asyncio.sleep(0)
         assert results == ["async_val"]
 
 
-# ── once ──────────────────────────────────────────────────────────────
-
-
 class TestOnce:
     def test_fires_only_once(self) -> None:
         ee = AsyncEventEmitter()
@@ -80,9 +69,6 @@ class TestOnce:
         assert results == ["once", "on", "on"]
 
 
-# ── remove_listener ──────────────────────────────────────────────────
-
-
 class TestRemoveListener:
     def test_removes_specific_handler(self) -> None:
         ee = AsyncEventEmitter()
@@ -103,7 +89,7 @@ class TestRemoveListener:
 
     def test_remove_nonexistent_is_noop(self) -> None:
         ee = AsyncEventEmitter()
-        ee.remove_listener("no_such_event", lambda: None)  # should not raise
+        ee.remove_listener("no_such_event", lambda: None)
 
     def test_remove_once_listener(self) -> None:
         ee = AsyncEventEmitter()
@@ -120,9 +106,6 @@ class TestRemoveListener:
         assert count == 0
 
 
-# ── remove_all_listeners ─────────────────────────────────────────────
-
-
 class TestRemoveAllListeners:
     def test_removes_for_specific_event(self) -> None:
         ee = AsyncEventEmitter()
@@ -153,9 +136,6 @@ class TestRemoveAllListeners:
         assert results == []
 
 
-# ── emit return value ────────────────────────────────────────────────
-
-
 class TestEmitReturn:
     def test_returns_true_with_listeners(self) -> None:
         ee = AsyncEventEmitter()
@@ -167,9 +147,6 @@ class TestEmitReturn:
         assert ee.emit("evt") is False
 
 
-# ── cancel ────────────────────────────────────────────────────────────
-
-
 class TestCancel:
     @pytest.mark.asyncio
     async def test_cancels_pending_tasks(self) -> None:
@@ -184,7 +161,6 @@ class TestCancel:
         ee.on("evt", long_handler)
         ee.emit("evt")
 
-        # Let the task start
         await asyncio.sleep(0)
         assert started is True
         assert len(ee._waiting) == 1  # pyright: ignore[reportPrivateUsage]
@@ -202,7 +178,7 @@ class TestCancel:
         ee.on("evt", quick_handler)
         ee.emit("evt")
 
-        # Let the task complete + done callback fire
+        # one tick for the task, one for its done callback
         await asyncio.sleep(0)
         await asyncio.sleep(0)
         assert len(ee._waiting) == 0  # pyright: ignore[reportPrivateUsage]

{camera_ui_sdk-1.4.2 → camera_ui_sdk-1.4.4}/tests/test_observable.py

@@ -1,5 +1,3 @@
-"""Tests for lightweight reactive primitives."""
-
 from __future__ import annotations
 
 import asyncio
@@ -21,8 +19,6 @@ from camera_ui_sdk.observable import (
     share,
 )
 
-# ── Disposable ────────────────────────────────────────────────────────
-
 
 class TestDisposable:
     def test_calls_teardown_once(self) -> None:
@@ -55,9 +51,6 @@ class TestDisposable:
         assert d.closed is True
 
 
-# ── Subject ───────────────────────────────────────────────────────────
-
-
 class TestSubject:
     def test_emits_values(self) -> None:
         subject: Subject[int] = Subject()
@@ -126,9 +119,6 @@ class TestSubject:
         assert isinstance(obs, Observable)
 
 
-# ── BehaviorSubject ───────────────────────────────────────────────────
-
-
 class TestBehaviorSubject:
     def test_emits_current_value_on_subscribe(self) -> None:
         subject = BehaviorSubject(42)
@@ -176,9 +166,6 @@ class TestBehaviorSubject:
         assert values == []
 
 
-# ── ReplaySubject ─────────────────────────────────────────────────────
-
-
 class TestReplaySubject:
     def test_replays_buffered_values(self) -> None:
         subject: ReplaySubject[int] = ReplaySubject(2)
@@ -224,9 +211,6 @@ class TestReplaySubject:
         assert values == [1]
 
 
-# ── Observable ────────────────────────────────────────────────────────
-
-
 class TestObservable:
     def test_subscribe_calls_factory(self) -> None:
         called = False
@@ -252,9 +236,6 @@ class TestObservable:
         assert values == [1]
 
 
-# ── Operators ─────────────────────────────────────────────────────────
-
-
 class TestFilterOp:
     def test_filters_values(self) -> None:
         subject: Subject[int] = Subject()
@@ -428,9 +409,6 @@ class TestShare:
         assert subscribe_count == 2
 
 
-# ── Pipe chaining ─────────────────────────────────────────────────────
-
-
 class TestPipeChaining:
     def test_chains_multiple_operators(self) -> None:
         subject: Subject[int] = Subject()
@@ -465,9 +443,6 @@ class TestPipeChaining:
         assert values == [0, 1, 2]
 
 
-# ── firstValueFrom ───────────────────────────────────────────────────
-
-
 class TestFirstValueFrom:
     @pytest.mark.asyncio
     async def test_resolves_with_first_value(self) -> None:

camera_ui_sdk-1.4.2/camera_ui_sdk/internal/camera_config_internal.py

@@ -1,50 +0,0 @@
-from __future__ import annotations
-
-from typing import NotRequired, TypedDict
-
-from ..camera.config import CameraConfigInputSettings, CameraInformation
-from ..camera.enums import CameraRole, StreamingRole
-
-
-class CameraInputSettings(TypedDict):
-    """Camera input settings (user configuration)."""
-
-    _id: str
-    """Unique source ID."""
-    name: str
-    """Source display name."""
-    role: CameraRole
-    """Resolution role."""
-    useForSnapshot: bool
-    """Use this source for snapshots."""
-    hotMode: bool
-    """Keep connection always active."""
-    preload: bool
-    """Keep a keyframe cache for this source, so the view opens faster. Use ``hotMode`` to keep the stream connected."""
-    muted: NotRequired[bool]
-    """Strip the audio track from this source (defaults to False)."""
-    urls: list[str]
-    """User-provided stream URLs."""
-    childSourceId: NotRequired[str]
-    """Child source ID (for snapshot fallback)."""
-    childCameraId: NotRequired[str]
-    """Camera whose stream shows in the picture-in-picture overlay, instead of a source of this camera."""
-    childCameraRole: NotRequired[StreamingRole]
-    """Role of the ``childCameraId`` stream shown in the overlay."""
-
-
-class CameraConfigPartial(TypedDict, total=False):
-    """Camera configuration subset for partial updates."""
-
-    name: str
-    """Camera display name."""
-    nativeId: str
-    """Native device ID from plugin."""
-    isCloud: bool
-    """Whether camera streams from cloud."""
-    disabled: bool
-    """Disable this camera."""
-    info: CameraInformation
-    """Camera hardware information."""
-    sources: list[CameraConfigInputSettings]
-    """Video input sources."""

camera_ui_sdk-1.4.2/camera_ui_sdk/internal/manager_rpc.py

@@ -1,24 +0,0 @@
-from __future__ import annotations
-
-from typing import Literal, NotRequired
-
-from ..manager import DiscoveredCamera
-
-ConnectionStatus = Literal["idle", "connecting", "connected", "error"]
-"""Connection status for discovered cameras."""
-
-
-class DiscoveredCameraWithState(DiscoveredCamera):
-    """Discovered camera plus the provider that found it and its live connection state.
-
-    Used by the UI to render the adoption list.
-    """
-
-    provider: str
-    """Name of the provider plugin that discovered this camera."""
-
-    connectionStatus: ConnectionStatus
-    """Current connection status reported by the provider."""
-
-    errorMessage: NotRequired[str]
-    """Last error message when ``connectionStatus`` is ``error``."""