Add audio sources as first-class entities, add mapped CSS type, simplify target editor for mapped sources

- Audio sources moved to separate tab with dedicated CRUD API, store, and editor modal
- New "mapped" color strip source type: assigns different CSS sources to distinct LED sub-ranges (zones)
- Mapped stream runtime with per-zone sub-streams, auto-sizing, hot-update support
- Target editor auto-collapses segments UI when mapped CSS is selected
- Delete protection for CSS sources referenced by mapped zones
- Compact header/footer layout

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

server/src/wled_controller/api/routes/audio_sources.py

@@ -0,0 +1,139 @@
+"""Audio source routes: CRUD for audio sources."""
+
+from typing import Optional
+
+from fastapi import APIRouter, Depends, HTTPException, Query
+
+from wled_controller.api.auth import AuthRequired
+from wled_controller.api.dependencies import (
+    get_audio_source_store,
+    get_color_strip_store,
+)
+from wled_controller.api.schemas.audio_sources import (
+    AudioSourceCreate,
+    AudioSourceListResponse,
+    AudioSourceResponse,
+    AudioSourceUpdate,
+)
+from wled_controller.storage.audio_source import AudioSource
+from wled_controller.storage.audio_source_store import AudioSourceStore
+from wled_controller.storage.color_strip_store import ColorStripStore
+from wled_controller.utils import get_logger
+
+logger = get_logger(__name__)
+
+router = APIRouter()
+
+
+def _to_response(source: AudioSource) -> AudioSourceResponse:
+    """Convert an AudioSource to an AudioSourceResponse."""
+    return AudioSourceResponse(
+        id=source.id,
+        name=source.name,
+        source_type=source.source_type,
+        device_index=getattr(source, "device_index", None),
+        is_loopback=getattr(source, "is_loopback", None),
+        audio_source_id=getattr(source, "audio_source_id", None),
+        channel=getattr(source, "channel", None),
+        description=source.description,
+        created_at=source.created_at,
+        updated_at=source.updated_at,
+    )
+
+
+@router.get("/api/v1/audio-sources", response_model=AudioSourceListResponse, tags=["Audio Sources"])
+async def list_audio_sources(
+    _auth: AuthRequired,
+    source_type: Optional[str] = Query(None, description="Filter by source_type: multichannel or mono"),
+    store: AudioSourceStore = Depends(get_audio_source_store),
+):
+    """List all audio sources, optionally filtered by type."""
+    sources = store.get_all_sources()
+    if source_type:
+        sources = [s for s in sources if s.source_type == source_type]
+    return AudioSourceListResponse(
+        sources=[_to_response(s) for s in sources],
+        count=len(sources),
+    )
+
+
+@router.post("/api/v1/audio-sources", response_model=AudioSourceResponse, status_code=201, tags=["Audio Sources"])
+async def create_audio_source(
+    data: AudioSourceCreate,
+    _auth: AuthRequired,
+    store: AudioSourceStore = Depends(get_audio_source_store),
+):
+    """Create a new audio source."""
+    try:
+        source = store.create_source(
+            name=data.name,
+            source_type=data.source_type,
+            device_index=data.device_index,
+            is_loopback=data.is_loopback,
+            audio_source_id=data.audio_source_id,
+            channel=data.channel,
+            description=data.description,
+        )
+        return _to_response(source)
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+
+
+@router.get("/api/v1/audio-sources/{source_id}", response_model=AudioSourceResponse, tags=["Audio Sources"])
+async def get_audio_source(
+    source_id: str,
+    _auth: AuthRequired,
+    store: AudioSourceStore = Depends(get_audio_source_store),
+):
+    """Get an audio source by ID."""
+    try:
+        source = store.get_source(source_id)
+        return _to_response(source)
+    except ValueError as e:
+        raise HTTPException(status_code=404, detail=str(e))
+
+
+@router.put("/api/v1/audio-sources/{source_id}", response_model=AudioSourceResponse, tags=["Audio Sources"])
+async def update_audio_source(
+    source_id: str,
+    data: AudioSourceUpdate,
+    _auth: AuthRequired,
+    store: AudioSourceStore = Depends(get_audio_source_store),
+):
+    """Update an existing audio source."""
+    try:
+        source = store.update_source(
+            source_id=source_id,
+            name=data.name,
+            device_index=data.device_index,
+            is_loopback=data.is_loopback,
+            audio_source_id=data.audio_source_id,
+            channel=data.channel,
+            description=data.description,
+        )
+        return _to_response(source)
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+
+
+@router.delete("/api/v1/audio-sources/{source_id}", tags=["Audio Sources"])
+async def delete_audio_source(
+    source_id: str,
+    _auth: AuthRequired,
+    store: AudioSourceStore = Depends(get_audio_source_store),
+    css_store: ColorStripStore = Depends(get_color_strip_store),
+):
+    """Delete an audio source."""
+    try:
+        # Check if any CSS entities reference this audio source
+        from wled_controller.storage.color_strip_source import AudioColorStripSource
+        for css in css_store.get_all_sources():
+            if isinstance(css, AudioColorStripSource) and getattr(css, "audio_source_id", None) == source_id:
+                raise ValueError(
+                    f"Cannot delete: referenced by color strip source '{css.name}'"
+                )
+
+        store.delete_source(source_id)
+        return {"status": "deleted", "id": source_id}
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))