cjm-transcript-source-select 0.0.14__tar.gz → 0.0.16__tar.gz

{cjm_transcript_source_select-0.0.14/cjm_transcript_source_select.egg-info → cjm_transcript_source_select-0.0.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: cjm-transcript-source-select
-Version: 0.0.14
+Version: 0.0.16
 Summary: FastHTML source selection component for transcript decomposition workflows, with federated database browsing, drag-drop ordering, and keyboard navigation.
 Home-page: https://github.com/cj-mills/cjm-transcript-source-select
 Author: Christian J. Mills
@@ -106,52 +106,52 @@ graph LR
     utils[utils<br/>utils]
 
     components_helpers --> models
-    components_local_files --> components_helpers
     components_local_files --> html_ids
+    components_local_files --> components_helpers
     components_preview_panel --> html_ids
     components_source_browser --> services_source_utils
     components_source_browser --> utils
     components_source_browser --> html_ids
-    components_step_renderer --> components_preview_panel
-    components_step_renderer --> models
-    components_step_renderer --> utils
     components_step_renderer --> components_source_browser
+    components_step_renderer --> html_ids
+    components_step_renderer --> utils
     components_step_renderer --> components_selection_queue
+    components_step_renderer --> models
+    components_step_renderer --> components_preview_panel
     components_step_renderer --> components_local_files
-    components_step_renderer --> html_ids
-    routes_core --> models
     routes_core --> components_step_renderer
+    routes_core --> models
     routes_core --> html_ids
     routes_core --> components_selection_queue
     routes_core --> services_source
-    routes_filtering --> models
     routes_filtering --> routes_core
     routes_filtering --> services_source_utils
+    routes_filtering --> models
     routes_filtering --> services_source
-    routes_init --> routes_core
     routes_init --> routes_queue
+    routes_init --> routes_core
     routes_init --> models
-    routes_init --> routes_local_files
-    routes_init --> routes_source_browser
     routes_init --> routes_filtering
     routes_init --> routes_tabs
     routes_init --> services_source
+    routes_init --> routes_source_browser
+    routes_init --> routes_local_files
     routes_local_files --> components_local_files
-    routes_local_files --> models
-    routes_local_files --> services_source
     routes_local_files --> routes_core
-    routes_queue --> services_source_utils
+    routes_local_files --> services_source
+    routes_local_files --> models
     routes_queue --> routes_core
-    routes_queue --> components_preview_panel
+    routes_queue --> services_source_utils
     routes_queue --> models
+    routes_queue --> components_preview_panel
     routes_queue --> services_source
     routes_source_browser --> routes_core
-    routes_source_browser --> components_preview_panel
+    routes_source_browser --> html_ids
     routes_source_browser --> models
     routes_source_browser --> components_source_browser
-    routes_source_browser --> services_source_utils
+    routes_source_browser --> components_preview_panel
     routes_source_browser --> services_source
-    routes_source_browser --> html_ids
+    routes_source_browser --> services_source_utils
     routes_tabs --> routes_core
     routes_tabs --> services_source_utils
     routes_tabs --> models
@@ -426,7 +426,7 @@ def init_selection_routers(
     source_service: SourceService,  # The source service for queries
     workflow_id: str,  # The workflow identifier
     prefix: str,  # Base prefix for selection routes (e.g., "/workflow/selection")
-) -> Tuple[List[APIRouter], SelectionUrls, Dict[str, Callable], Callable, "SourceBrowserRouterState"]
+) -> SelectionResult:  # Selection router result with routers, urls, routes, and restore
     "Initialize and return all selection routers with URL bundle."
 ```
 
@@ -528,8 +528,9 @@ def _handle_remove_external_source(
     external_db_paths_ref: List[str],  # Shared external paths list (mutated in place)
     fb_routers: FileBrowserRouters,  # File browser routers (for targeted OOB)
     remove_url: str,  # URL for remove button in external sources list
-):  # Tuple of OOB elements (external sources list + checkbox cells)
-    "Remove an external database source from the Added Sources list."
+    urls: SelectionUrls,  # Full URL bundle for queue re-rendering
+):  # Tuple of OOB elements (external sources list + checkbox cells + queue + stats)
+    "Remove an external database source and clean up orphaned queue items."
 ```
 
 ``` python
@@ -539,7 +540,7 @@ def init_local_files_router(
     source_service: SourceService,  # The source service for external db ops
     prefix: str,  # Route prefix (e.g., "/workflow/selection/local_files")
     urls: SelectionUrls,  # URL bundle for rendering
-) -> Tuple[List, Dict[str, Callable], Callable]:  # (routers, route_dict, render_panel_fn)
+) -> LocalFilesResult:  # Router result with routers, routes, render, restore, and reset
     "Initialize local files browser routes with new file browser API."
 ```
 
@@ -558,10 +559,33 @@ _local_files_provider: Optional[LocalFileSystemProvider] = None
 ``` python
 from cjm_transcript_source_select.models import (
     SelectionStepState,
-    SelectionUrls
+    SelectionUrls,
+    LocalFilesResult,
+    SelectionResult
 )
 ```
 
+#### Functions
+
+``` python
+def _no_op_restore(session_id: str) -> None:
+    """Default no-op for restore_state."""
+    pass
+
+def _no_op_reset() -> None
+    "Default no-op for restore_state."
+```
+
+``` python
+def _no_op_reset() -> None:
+    """Default no-op for reset_state."""
+    pass
+
+@dataclass
+class LocalFilesResult
+    "Default no-op for reset_state."
+```
+
 #### Classes
 
 ``` python
@@ -591,6 +615,32 @@ class SelectionUrls:
     tab_switch: str = ''  # Switch source tabs
 ```
 
+``` python
+@dataclass
+class LocalFilesResult:
+    "Return type from init_local_files_router."
+    
+    routers: List[APIRouter]  # Routers to register (custom + file browser + VC)
+    routes: Dict[str, Callable]  # Named route handlers
+    render_panel: Callable  # (error_message?, session_id?) -> rendered panel
+    restore_state: Callable = field(...)  # (session_id) -> None, restore persisted state
+    reset_state: Callable = field(...)  # () -> None, reset in-memory caches
+```
+
+``` python
+@dataclass
+class SelectionResult:
+    "Return type from init_selection_routers."
+    
+    routers: List[APIRouter]  # All selection routers to register
+    urls: 'SelectionUrls' = field(...)  # URL bundle
+    routes: Dict[str, Callable] = field(...)  # All named route handlers
+    render_local_files_panel: Optional[Callable]  # Render fn for local files tab
+    sb_state: Any  # SourceBrowserRouterState
+    restore_state: Callable = field(...)  # (session_id) -> None, restore persisted state
+    reset_state: Callable = field(...)  # () -> None, reset in-memory caches
+```
+
 ### preview_panel (`preview_panel.ipynb`)
 
 > Collapsible preview panel for displaying selected content
@@ -1434,15 +1484,16 @@ from cjm_transcript_source_select.routes.tabs import (
 
 ``` python
 def _handle_tab_switch(
-    state_store: WorkflowStateStore,  # The workflow state store
-    workflow_id: str,  # The workflow identifier
     source_service: SourceService,  # The source service for queries
     request,  # FastHTML request object
     sess,  # FastHTML session object
     direction: str,  # Direction: "prev", "next", "db", or "files"
     urls: SelectionUrls,  # URL bundle for rendering
+    current_tab_ref: List[str],  # Mutable ref [current_tab] for closure-based tracking
     render_local_files_panel: Optional[Callable] = None,  # Render fn for Files tab
     sb_state: Any = None,  # SourceBrowserRouterState for DB tab VC rendering
+    state_store: WorkflowStateStore = None,  # State store (for reading step state)
+    workflow_id: str = "",  # Workflow ID (for reading step state)
 ):  # Tuple of inner content, OOB tab headers, and tab switch script
     "Switch between Plugin DB and Local Files tabs."
 ```

{cjm_transcript_source_select-0.0.14 → cjm_transcript_source_select-0.0.16}/README.md

@@ -60,52 +60,52 @@ graph LR
     utils[utils<br/>utils]
 
     components_helpers --> models
-    components_local_files --> components_helpers
     components_local_files --> html_ids
+    components_local_files --> components_helpers
     components_preview_panel --> html_ids
     components_source_browser --> services_source_utils
     components_source_browser --> utils
     components_source_browser --> html_ids
-    components_step_renderer --> components_preview_panel
-    components_step_renderer --> models
-    components_step_renderer --> utils
     components_step_renderer --> components_source_browser
+    components_step_renderer --> html_ids
+    components_step_renderer --> utils
     components_step_renderer --> components_selection_queue
+    components_step_renderer --> models
+    components_step_renderer --> components_preview_panel
     components_step_renderer --> components_local_files
-    components_step_renderer --> html_ids
-    routes_core --> models
     routes_core --> components_step_renderer
+    routes_core --> models
     routes_core --> html_ids
     routes_core --> components_selection_queue
     routes_core --> services_source
-    routes_filtering --> models
     routes_filtering --> routes_core
     routes_filtering --> services_source_utils
+    routes_filtering --> models
     routes_filtering --> services_source
-    routes_init --> routes_core
     routes_init --> routes_queue
+    routes_init --> routes_core
     routes_init --> models
-    routes_init --> routes_local_files
-    routes_init --> routes_source_browser
     routes_init --> routes_filtering
     routes_init --> routes_tabs
     routes_init --> services_source
+    routes_init --> routes_source_browser
+    routes_init --> routes_local_files
     routes_local_files --> components_local_files
-    routes_local_files --> models
-    routes_local_files --> services_source
     routes_local_files --> routes_core
-    routes_queue --> services_source_utils
+    routes_local_files --> services_source
+    routes_local_files --> models
     routes_queue --> routes_core
-    routes_queue --> components_preview_panel
+    routes_queue --> services_source_utils
     routes_queue --> models
+    routes_queue --> components_preview_panel
     routes_queue --> services_source
     routes_source_browser --> routes_core
-    routes_source_browser --> components_preview_panel
+    routes_source_browser --> html_ids
     routes_source_browser --> models
     routes_source_browser --> components_source_browser
-    routes_source_browser --> services_source_utils
+    routes_source_browser --> components_preview_panel
     routes_source_browser --> services_source
-    routes_source_browser --> html_ids
+    routes_source_browser --> services_source_utils
     routes_tabs --> routes_core
     routes_tabs --> services_source_utils
     routes_tabs --> models
@@ -380,7 +380,7 @@ def init_selection_routers(
     source_service: SourceService,  # The source service for queries
     workflow_id: str,  # The workflow identifier
     prefix: str,  # Base prefix for selection routes (e.g., "/workflow/selection")
-) -> Tuple[List[APIRouter], SelectionUrls, Dict[str, Callable], Callable, "SourceBrowserRouterState"]
+) -> SelectionResult:  # Selection router result with routers, urls, routes, and restore
     "Initialize and return all selection routers with URL bundle."
 ```
 
@@ -482,8 +482,9 @@ def _handle_remove_external_source(
     external_db_paths_ref: List[str],  # Shared external paths list (mutated in place)
     fb_routers: FileBrowserRouters,  # File browser routers (for targeted OOB)
     remove_url: str,  # URL for remove button in external sources list
-):  # Tuple of OOB elements (external sources list + checkbox cells)
-    "Remove an external database source from the Added Sources list."
+    urls: SelectionUrls,  # Full URL bundle for queue re-rendering
+):  # Tuple of OOB elements (external sources list + checkbox cells + queue + stats)
+    "Remove an external database source and clean up orphaned queue items."
 ```
 
 ``` python
@@ -493,7 +494,7 @@ def init_local_files_router(
     source_service: SourceService,  # The source service for external db ops
     prefix: str,  # Route prefix (e.g., "/workflow/selection/local_files")
     urls: SelectionUrls,  # URL bundle for rendering
-) -> Tuple[List, Dict[str, Callable], Callable]:  # (routers, route_dict, render_panel_fn)
+) -> LocalFilesResult:  # Router result with routers, routes, render, restore, and reset
     "Initialize local files browser routes with new file browser API."
 ```
 
@@ -512,10 +513,33 @@ _local_files_provider: Optional[LocalFileSystemProvider] = None
 ``` python
 from cjm_transcript_source_select.models import (
     SelectionStepState,
-    SelectionUrls
+    SelectionUrls,
+    LocalFilesResult,
+    SelectionResult
 )
 ```
 
+#### Functions
+
+``` python
+def _no_op_restore(session_id: str) -> None:
+    """Default no-op for restore_state."""
+    pass
+
+def _no_op_reset() -> None
+    "Default no-op for restore_state."
+```
+
+``` python
+def _no_op_reset() -> None:
+    """Default no-op for reset_state."""
+    pass
+
+@dataclass
+class LocalFilesResult
+    "Default no-op for reset_state."
+```
+
 #### Classes
 
 ``` python
@@ -545,6 +569,32 @@ class SelectionUrls:
     tab_switch: str = ''  # Switch source tabs
 ```
 
+``` python
+@dataclass
+class LocalFilesResult:
+    "Return type from init_local_files_router."
+    
+    routers: List[APIRouter]  # Routers to register (custom + file browser + VC)
+    routes: Dict[str, Callable]  # Named route handlers
+    render_panel: Callable  # (error_message?, session_id?) -> rendered panel
+    restore_state: Callable = field(...)  # (session_id) -> None, restore persisted state
+    reset_state: Callable = field(...)  # () -> None, reset in-memory caches
+```
+
+``` python
+@dataclass
+class SelectionResult:
+    "Return type from init_selection_routers."
+    
+    routers: List[APIRouter]  # All selection routers to register
+    urls: 'SelectionUrls' = field(...)  # URL bundle
+    routes: Dict[str, Callable] = field(...)  # All named route handlers
+    render_local_files_panel: Optional[Callable]  # Render fn for local files tab
+    sb_state: Any  # SourceBrowserRouterState
+    restore_state: Callable = field(...)  # (session_id) -> None, restore persisted state
+    reset_state: Callable = field(...)  # () -> None, reset in-memory caches
+```
+
 ### preview_panel (`preview_panel.ipynb`)
 
 > Collapsible preview panel for displaying selected content
@@ -1388,15 +1438,16 @@ from cjm_transcript_source_select.routes.tabs import (
 
 ``` python
 def _handle_tab_switch(
-    state_store: WorkflowStateStore,  # The workflow state store
-    workflow_id: str,  # The workflow identifier
     source_service: SourceService,  # The source service for queries
     request,  # FastHTML request object
     sess,  # FastHTML session object
     direction: str,  # Direction: "prev", "next", "db", or "files"
     urls: SelectionUrls,  # URL bundle for rendering
+    current_tab_ref: List[str],  # Mutable ref [current_tab] for closure-based tracking
     render_local_files_panel: Optional[Callable] = None,  # Render fn for Files tab
     sb_state: Any = None,  # SourceBrowserRouterState for DB tab VC rendering
+    state_store: WorkflowStateStore = None,  # State store (for reading step state)
+    workflow_id: str = "",  # Workflow ID (for reading step state)
 ):  # Tuple of inner content, OOB tab headers, and tab switch script
     "Switch between Plugin DB and Local Files tabs."
 ```

cjm_transcript_source_select-0.0.16/cjm_transcript_source_select/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.0.16"

{cjm_transcript_source_select-0.0.14 → cjm_transcript_source_select-0.0.16}/cjm_transcript_source_select/_modidx.py

@@ -81,10 +81,18 @@ d = { 'settings': { 'branch': 'main',
                                                                                                                                    'cjm_transcript_source_select/html_ids.py'),
                                                        'cjm_transcript_source_select.html_ids.SelectionHtmlIds.source_row': ( 'html_ids.html#selectionhtmlids.source_row',
                                                                                                                               'cjm_transcript_source_select/html_ids.py')},
-            'cjm_transcript_source_select.models': { 'cjm_transcript_source_select.models.SelectionStepState': ( 'models.html#selectionstepstate',
+            'cjm_transcript_source_select.models': { 'cjm_transcript_source_select.models.LocalFilesResult': ( 'models.html#localfilesresult',
+                                                                                                               'cjm_transcript_source_select/models.py'),
+                                                     'cjm_transcript_source_select.models.SelectionResult': ( 'models.html#selectionresult',
+                                                                                                              'cjm_transcript_source_select/models.py'),
+                                                     'cjm_transcript_source_select.models.SelectionStepState': ( 'models.html#selectionstepstate',
                                                                                                                  'cjm_transcript_source_select/models.py'),
                                                      'cjm_transcript_source_select.models.SelectionUrls': ( 'models.html#selectionurls',
-                                                                                                            'cjm_transcript_source_select/models.py')},
+                                                                                                            'cjm_transcript_source_select/models.py'),
+                                                     'cjm_transcript_source_select.models._no_op_reset': ( 'models.html#_no_op_reset',
+                                                                                                           'cjm_transcript_source_select/models.py'),
+                                                     'cjm_transcript_source_select.models._no_op_restore': ( 'models.html#_no_op_restore',
+                                                                                                             'cjm_transcript_source_select/models.py')},
             'cjm_transcript_source_select.routes.core': { 'cjm_transcript_source_select.routes.core._build_queue_response': ( 'routes/core.html#_build_queue_response',
                                                                                                                               'cjm_transcript_source_select/routes/core.py'),
                                                           'cjm_transcript_source_select.routes.core._find_duplicate_media_source': ( 'routes/core.html#_find_duplicate_media_source',

{cjm_transcript_source_select-0.0.14 → cjm_transcript_source_select-0.0.16}/cjm_transcript_source_select/models.py

@@ -3,12 +3,14 @@
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/models.ipynb.
 
 # %% auto #0
-__all__ = ['SelectionStepState', 'SelectionUrls']
+__all__ = ['SelectionStepState', 'SelectionUrls', 'LocalFilesResult', 'SelectionResult']
 
 # %% ../nbs/models.ipynb #selection-models-imports
-from typing import List, Dict, Any
+from typing import List, Dict, Any, Callable, Optional
 from typing_extensions import TypedDict
-from dataclasses import dataclass
+from dataclasses import dataclass, field
+
+from fasthtml.common import APIRouter
 
 from cjm_source_provider.models import SelectedSource
 
@@ -51,3 +53,32 @@ class SelectionUrls:
 
     # Tab switching
     tab_switch: str = ""  # Switch source tabs
+
+# %% ../nbs/models.ipynb #gxc6wl5o4mn
+def _no_op_restore(session_id: str) -> None:
+    """Default no-op for restore_state."""
+    pass
+
+def _no_op_reset() -> None:
+    """Default no-op for reset_state."""
+    pass
+
+@dataclass
+class LocalFilesResult:
+    """Return type from init_local_files_router."""
+    routers: List[APIRouter]              # Routers to register (custom + file browser + VC)
+    routes: Dict[str, Callable]           # Named route handlers
+    render_panel: Callable                # (error_message?, session_id?) -> rendered panel
+    restore_state: Callable = field(default=_no_op_restore)  # (session_id) -> None, restore persisted state
+    reset_state: Callable = field(default=_no_op_reset)  # () -> None, reset in-memory caches
+
+@dataclass
+class SelectionResult:
+    """Return type from init_selection_routers."""
+    routers: List[APIRouter]              # All selection routers to register
+    urls: "SelectionUrls" = field(default_factory=lambda: SelectionUrls())  # URL bundle
+    routes: Dict[str, Callable] = field(default_factory=dict)  # All named route handlers
+    render_local_files_panel: Optional[Callable] = None  # Render fn for local files tab
+    sb_state: Any = None                  # SourceBrowserRouterState
+    restore_state: Callable = field(default=_no_op_restore)  # (session_id) -> None, restore persisted state
+    reset_state: Callable = field(default=_no_op_reset)  # () -> None, reset in-memory caches

{cjm_transcript_source_select-0.0.14 → cjm_transcript_source_select-0.0.16}/cjm_transcript_source_select/routes/init.py

@@ -12,7 +12,7 @@ from fasthtml.common import APIRouter
 
 from cjm_fasthtml_interactions.core.state_store import get_session_id
 
-from ..models import SelectionUrls
+from ..models import SelectionUrls, SelectionResult
 from cjm_transcript_source_select.routes.core import (
     WorkflowStateStore,
     _rebuild_and_render_ref, _sync_items_ref,
@@ -32,7 +32,7 @@ def init_selection_routers(
     source_service: SourceService,  # The source service for queries
     workflow_id: str,  # The workflow identifier
     prefix: str,  # Base prefix for selection routes (e.g., "/workflow/selection")
-) -> Tuple[List[APIRouter], SelectionUrls, Dict[str, Callable], Callable, "SourceBrowserRouterState"]:
+) -> SelectionResult:  # Selection router result with routers, urls, routes, and restore
     """Initialize and return all selection routers with URL bundle."""
     urls = SelectionUrls()
 
@@ -42,7 +42,7 @@ def init_selection_routers(
     filtering_router, filtering_routes = init_filtering_router(
         state_store, workflow_id, source_service, f"{prefix}/filtering", urls
     )
-    local_files_routers, local_files_routes, render_local_files_panel = init_local_files_router(
+    local_files = init_local_files_router(
         state_store, workflow_id, source_service, f"{prefix}/local_files", urls
     )
     sb_state = init_source_browser_router(
@@ -92,7 +92,7 @@ def init_selection_routers(
 
     tabs_router, tabs_routes = init_tabs_router(
         state_store, workflow_id, source_service, f"{prefix}/tabs", urls,
-        render_local_files_panel=render_local_files_panel,
+        render_local_files_panel=local_files.render_panel,
         sb_state=sb_state,
     )
 
@@ -108,16 +108,24 @@ def init_selection_routers(
     urls.keyboard_reorder = filtering_routes["keyboard_reorder"].to()
     urls.filter = filtering_routes["filter"].to()
     urls.grouping_change = filtering_routes["grouping_change"].to()
-    urls.remove_external = local_files_routes["remove_external"].to()
+    urls.remove_external = local_files.routes["remove_external"].to()
     urls.tab_switch = tabs_routes["tab_switch"].to()
 
     merged_routes = {
         **queue_routes,
         **filtering_routes,
-        **local_files_routes,
+        **local_files.routes,
         **tabs_routes,
     }
 
-    routers = [queue_router, filtering_router, *local_files_routers, tabs_router, sb_state.router]
+    routers = [queue_router, filtering_router, *local_files.routers, tabs_router, sb_state.router]
 
-    return routers, urls, merged_routes, render_local_files_panel, sb_state
+    return SelectionResult(
+        routers=routers,
+        urls=urls,
+        routes=merged_routes,
+        render_local_files_panel=local_files.render_panel,
+        sb_state=sb_state,
+        restore_state=local_files.restore_state,
+        reset_state=local_files.reset_state,
+    )

{cjm_transcript_source_select-0.0.14 → cjm_transcript_source_select-0.0.16}/cjm_transcript_source_select/routes/local_files.py

@@ -17,9 +17,10 @@ from cjm_fasthtml_file_browser.routes.handlers import init_router as init_fb_rou
 
 from cjm_fasthtml_interactions.core.state_store import get_session_id
 
-from ..models import SelectionUrls
+from ..models import SelectionUrls, LocalFilesResult
 from cjm_transcript_source_select.routes.core import (
-    WorkflowStateStore, _get_step_state, _update_step_state
+    WorkflowStateStore, _get_step_state, _update_step_state,
+    _build_queue_response,
 )
 from cjm_transcript_source_select.components.local_files import (
     _render_local_files_browser,
@@ -54,12 +55,15 @@ def _handle_remove_external_source(
     external_db_paths_ref: List[str],  # Shared external paths list (mutated in place)
     fb_routers: FileBrowserRouters,  # File browser routers (for targeted OOB)
     remove_url: str,  # URL for remove button in external sources list
-):  # Tuple of OOB elements (external sources list + checkbox cells)
-    """Remove an external database source from the Added Sources list."""
+    urls: SelectionUrls,  # Full URL bundle for queue re-rendering
+):  # Tuple of OOB elements (external sources list + checkbox cells + queue + stats)
+    """Remove an external database source and clean up orphaned queue items."""
     session_id = get_session_id(sess)
 
     # Remove the path if it exists
+    removed_provider_id = None
     if db_path in external_db_paths_ref:
+        removed_provider_id = f"external:{db_path}"
         external_db_paths_ref.remove(db_path)
         _update_step_state(state_store, workflow_id, session_id, external_db_paths=list(external_db_paths_ref))
         source_service.set_external_paths(list(external_db_paths_ref))
@@ -69,7 +73,28 @@ def _handle_remove_external_source(
     external_list_oob = _render_external_sources_list(
         list(external_db_paths_ref), remove_url, oob=True,
     )
-    return (external_list_oob, *checkbox_oobs)
+
+    parts = [external_list_oob, *checkbox_oobs]
+
+    # Remove orphaned queue items from the deleted provider
+    if removed_provider_id is not None:
+        step_state = _get_step_state(state_store, workflow_id, session_id)
+        selected_sources = step_state.get("selected_sources", [])
+        filtered = [s for s in selected_sources if s.get("provider_id") != removed_provider_id]
+        if len(filtered) != len(selected_sources):
+            _update_step_state(state_store, workflow_id, session_id, selected_sources=filtered)
+            # Re-render queue + stats as OOB
+            queue_response = _build_queue_response(
+                state_store, workflow_id, source_service, session_id,
+                filtered, urls, include_checkbox_oobs=False,
+            )
+            queue_parts = queue_response if isinstance(queue_response, tuple) else (queue_response,)
+            for part in queue_parts:
+                if hasattr(part, 'attrs') and 'hx-swap-oob' not in part.attrs and 'id' in part.attrs:
+                    part.attrs['hx-swap-oob'] = 'outerHTML'
+            parts.extend(queue_parts)
+
+    return tuple(parts)
 
 # %% ../../nbs/routes/local_files.ipynb #rdrpw4jrxpc
 def init_local_files_router(
@@ -78,7 +103,7 @@ def init_local_files_router(
     source_service: SourceService,  # The source service for external db ops
     prefix: str,  # Route prefix (e.g., "/workflow/selection/local_files")
     urls: SelectionUrls,  # URL bundle for rendering
-) -> Tuple[List, Dict[str, Callable], Callable]:  # (routers, route_dict, render_panel_fn)
+) -> LocalFilesResult:  # Router result with routers, routes, render, restore, and reset
     """Initialize local files browser routes with new file browser API."""
     provider = _get_local_files_provider()
     config = _create_db_browser_config()
@@ -90,18 +115,57 @@ def init_local_files_router(
     # --- File browser state accessors (shared, non-per-session) ---
     _browser_state = BrowserState(current_path=home_path)
 
+    # --- Lazy state restoration from persisted store ---
+    _state_restored = [False]
+
+    def _restore_from_persisted(session_id: str) -> None:
+        """Load persisted external_db_paths and file_browser_state on first call."""
+        if _state_restored[0]:
+            return
+        step_state = _get_step_state(state_store, workflow_id, session_id)
+
+        # Restore external_db_paths
+        persisted_paths = step_state.get("external_db_paths", [])
+        if persisted_paths:
+            _external_db_paths[:] = persisted_paths
+            source_service.set_external_paths(list(_external_db_paths))
+
+        # Restore browser state (current_path, sort)
+        persisted_browser = step_state.get("file_browser_state", {})
+        if persisted_browser:
+            restored = BrowserState.from_dict(persisted_browser)
+            _browser_state.current_path = restored.current_path
+            _browser_state.sort_by = restored.sort_by
+            _browser_state.sort_descending = restored.sort_descending
+            # Selection synced from _external_db_paths via _fb_state_getter
+
+        _state_restored[0] = True
+
     def _fb_state_getter() -> BrowserState:
         """Get browser state with selection synced to external_db_paths."""
         _browser_state.selection.selected_paths = list(_external_db_paths)
         return _browser_state
 
-    def _fb_state_setter(state: BrowserState) -> None:
-        """Save browser state from file browser."""
+    def _fb_state_setter(state: BrowserState, request=None) -> None:
+        """Save browser state from file browser and persist to state store."""
+        # Lazy restore on first request
+        if request is not None and not _state_restored[0]:
+            _restore_from_persisted(get_session_id(request.session))
+
         _browser_state.current_path = state.current_path
         _browser_state.sort_by = state.sort_by
         _browser_state.sort_descending = state.sort_descending
         _browser_state.selection = state.selection
 
+        # Persist browser state
+        if request is not None:
+            session_id = get_session_id(request.session)
+            _update_step_state(
+                state_store, workflow_id, session_id,
+                file_browser_state=state.to_dict(),
+                current_browse_path=state.current_path,
+            )
+
     # --- Callbacks for file browser ---
     def _validate_selection(path: str) -> Tuple[bool, str]:
         """Validate .db schema before allowing selection (checkbox click path)."""
@@ -111,10 +175,16 @@ def init_local_files_router(
             return (False, error)
         return (True, "")
 
-    def _on_selection_change(selected_paths: List[str]) -> Tuple:
+    def _on_selection_change(selected_paths: List[str], request=None) -> Tuple:
         """Sync external_db_paths with validation and return OOB updates."""
-        # Validate any newly added paths
+        # Lazy restore on first request
+        if request is not None and not _state_restored[0]:
+            _restore_from_persisted(get_session_id(request.session))
+
+        # Detect removed paths before validation
         old_set = set(_external_db_paths)
+
+        # Validate any newly added paths
         validated_paths = []
         error_message = None
         for path in selected_paths:
@@ -134,10 +204,40 @@ def init_local_files_router(
         _external_db_paths[:] = validated_paths
         source_service.set_external_paths(list(_external_db_paths))
 
-        return (
+        # Persist external_db_paths
+        if request is not None:
+            session_id = get_session_id(request.session)
+            _update_step_state(
+                state_store, workflow_id, session_id,
+                external_db_paths=list(_external_db_paths),
+            )
+
+        parts = [
             _render_external_sources_list(list(_external_db_paths), urls.remove_external, oob=True),
             _render_error_alert(error_message, oob=True),
-        )
+        ]
+
+        # Clean up orphaned queue items for removed external DBs
+        removed_paths = old_set - set(validated_paths)
+        if removed_paths and request is not None:
+            session_id = get_session_id(request.session)
+            removed_provider_ids = {f"external:{p}" for p in removed_paths}
+            step_state = _get_step_state(state_store, workflow_id, session_id)
+            selected_sources = step_state.get("selected_sources", [])
+            filtered = [s for s in selected_sources if s.get("provider_id") not in removed_provider_ids]
+            if len(filtered) != len(selected_sources):
+                _update_step_state(state_store, workflow_id, session_id, selected_sources=filtered)
+                queue_response = _build_queue_response(
+                    state_store, workflow_id, source_service, session_id,
+                    filtered, urls, include_checkbox_oobs=False,
+                )
+                queue_parts = queue_response if isinstance(queue_response, tuple) else (queue_response,)
+                for part in queue_parts:
+                    if hasattr(part, 'attrs') and 'hx-swap-oob' not in part.attrs and 'id' in part.attrs:
+                        part.attrs['hx-swap-oob'] = 'outerHTML'
+                parts.extend(queue_parts)
+
+        return tuple(parts)
 
     fb_callbacks = FileBrowserCallbacks(
         validate_selection=_validate_selection,
@@ -156,8 +256,12 @@ def init_local_files_router(
     )
 
     # --- Render function for the full local files panel ---
-    def _render_panel(error_message: Optional[str] = None) -> Any:
+    def _render_panel(error_message: Optional[str] = None, session_id: Optional[str] = None) -> Any:
         """Render the complete local files panel (file browser + external sources list)."""
+        # Restore persisted state and rebuild items before rendering
+        if session_id is not None and not _state_restored[0]:
+            _restore_from_persisted(session_id)
+            fb_routers.sync_items()
         return _render_local_files_browser(
             render_fn=fb_routers.render,
             external_paths=list(_external_db_paths),
@@ -165,6 +269,23 @@ def init_local_files_router(
             error_message=error_message,
         )
 
+    # --- Restore callable for eager state restoration ---
+    def _restore_state(session_id: str) -> None:
+        """Restore persisted local files state (external_db_paths + browser state)."""
+        _restore_from_persisted(session_id)
+        fb_routers.sync_items()
+
+    # --- Reset callable for clearing in-memory caches ---
+    def _reset_state() -> None:
+        """Reset in-memory state so next restore re-reads from DB."""
+        _external_db_paths[:] = []
+        _state_restored[0] = False
+        _browser_state.current_path = home_path
+        _browser_state.sort_by = "name"
+        _browser_state.sort_descending = False
+        _browser_state.selection.selected_paths = []
+        source_service.set_external_paths([])
+
     # --- Custom router for remove_external (needs session context) ---
     custom_router = APIRouter(prefix=prefix)
 
@@ -177,6 +298,7 @@ def init_local_files_router(
             external_db_paths_ref=_external_db_paths,
             fb_routers=fb_routers,
             remove_url=urls.remove_external,
+            urls=urls,
         )
 
     # All routers to register
@@ -186,4 +308,10 @@ def init_local_files_router(
         "remove_external": remove_external,
     }
 
-    return all_routers, routes, _render_panel
+    return LocalFilesResult(
+        routers=all_routers,
+        routes=routes,
+        render_panel=_render_panel,
+        restore_state=_restore_state,
+        reset_state=_reset_state,
+    )

{cjm_transcript_source_select-0.0.14 → cjm_transcript_source_select-0.0.16}/cjm_transcript_source_select/routes/tabs.py

@@ -6,7 +6,7 @@
 __all__ = ['init_tabs_router']
 
 # %% ../../nbs/routes/tabs.ipynb #ca31d3ff
-from typing import Any, Optional, Tuple, Dict, Callable
+from typing import Any, Optional, Tuple, Dict, List, Callable
 
 from fasthtml.common import APIRouter, Script
 
@@ -24,15 +24,16 @@ from ..services.source_utils import calculate_next_tab
 
 # %% ../../nbs/routes/tabs.ipynb #4d0109d3
 def _handle_tab_switch(
-    state_store: WorkflowStateStore,  # The workflow state store
-    workflow_id: str,  # The workflow identifier
     source_service: SourceService,  # The source service for queries
     request,  # FastHTML request object
     sess,  # FastHTML session object
     direction: str,  # Direction: "prev", "next", "db", or "files"
     urls: SelectionUrls,  # URL bundle for rendering
+    current_tab_ref: List[str],  # Mutable ref [current_tab] for closure-based tracking
     render_local_files_panel: Optional[Callable] = None,  # Render fn for Files tab
     sb_state: Any = None,  # SourceBrowserRouterState for DB tab VC rendering
+    state_store: WorkflowStateStore = None,  # State store (for reading step state)
+    workflow_id: str = "",  # Workflow ID (for reading step state)
 ):  # Tuple of inner content, OOB tab headers, and tab switch script
     """Switch between Plugin DB and Local Files tabs."""
     session_id = get_session_id(sess)
@@ -41,14 +42,10 @@ def _handle_tab_switch(
     selected_sources = step_state.get("selected_sources", [])
     grouping_mode = step_state.get("grouping_mode", "media_path")
 
-    # Determine new tab
-    workflow_state = state_store.get_state(workflow_id, session_id)
-    current_tab = workflow_state.get("source_tab", "db")
+    # Determine new tab from closure-based tracking (not persisted)
+    current_tab = current_tab_ref[0]
     new_tab = calculate_next_tab(direction, current_tab, ["db", "files"])
-
-    # Save new tab state
-    workflow_state["source_tab"] = new_tab
-    state_store.update_state(workflow_id, session_id, workflow_state)
+    current_tab_ref[0] = new_tab
 
     # Render the content for the new active tab
     if new_tab == "db":
@@ -56,7 +53,7 @@ def _handle_tab_switch(
         content = sb_state.rebuild_and_render(all_transcriptions, selected_sources, grouping_mode)
     else:
         if render_local_files_panel is not None:
-            content = render_local_files_panel()
+            content = render_local_files_panel(session_id=session_id)
         else:
             from cjm_transcript_source_select.components.local_files import _render_local_files_browser
             content = _render_local_files_browser()
@@ -85,14 +82,20 @@ def init_tabs_router(
     """Initialize tab switching routes."""
     router = APIRouter(prefix=prefix)
 
+    # Closure-based tab tracking (not persisted across restarts)
+    _current_tab: List[str] = ["db"]
+
     @router
     def tab_switch(request, sess, direction: str):
         """Switch between source tabs."""
         return _handle_tab_switch(
-            state_store, workflow_id, source_service,
-            request, sess, direction, urls=urls,
+            source_service=source_service,
+            request=request, sess=sess, direction=direction, urls=urls,
+            current_tab_ref=_current_tab,
             render_local_files_panel=render_local_files_panel,
             sb_state=sb_state,
+            state_store=state_store,
+            workflow_id=workflow_id,
         )
 
     routes = {

{cjm_transcript_source_select-0.0.14 → cjm_transcript_source_select-0.0.16/cjm_transcript_source_select.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: cjm-transcript-source-select
-Version: 0.0.14
+Version: 0.0.16
 Summary: FastHTML source selection component for transcript decomposition workflows, with federated database browsing, drag-drop ordering, and keyboard navigation.
 Home-page: https://github.com/cj-mills/cjm-transcript-source-select
 Author: Christian J. Mills
@@ -106,52 +106,52 @@ graph LR
     utils[utils<br/>utils]
 
     components_helpers --> models
-    components_local_files --> components_helpers
     components_local_files --> html_ids
+    components_local_files --> components_helpers
     components_preview_panel --> html_ids
     components_source_browser --> services_source_utils
     components_source_browser --> utils
     components_source_browser --> html_ids
-    components_step_renderer --> components_preview_panel
-    components_step_renderer --> models
-    components_step_renderer --> utils
     components_step_renderer --> components_source_browser
+    components_step_renderer --> html_ids
+    components_step_renderer --> utils
     components_step_renderer --> components_selection_queue
+    components_step_renderer --> models
+    components_step_renderer --> components_preview_panel
     components_step_renderer --> components_local_files
-    components_step_renderer --> html_ids
-    routes_core --> models
     routes_core --> components_step_renderer
+    routes_core --> models
     routes_core --> html_ids
     routes_core --> components_selection_queue
     routes_core --> services_source
-    routes_filtering --> models
     routes_filtering --> routes_core
     routes_filtering --> services_source_utils
+    routes_filtering --> models
     routes_filtering --> services_source
-    routes_init --> routes_core
     routes_init --> routes_queue
+    routes_init --> routes_core
     routes_init --> models
-    routes_init --> routes_local_files
-    routes_init --> routes_source_browser
     routes_init --> routes_filtering
     routes_init --> routes_tabs
     routes_init --> services_source
+    routes_init --> routes_source_browser
+    routes_init --> routes_local_files
     routes_local_files --> components_local_files
-    routes_local_files --> models
-    routes_local_files --> services_source
     routes_local_files --> routes_core
-    routes_queue --> services_source_utils
+    routes_local_files --> services_source
+    routes_local_files --> models
     routes_queue --> routes_core
-    routes_queue --> components_preview_panel
+    routes_queue --> services_source_utils
     routes_queue --> models
+    routes_queue --> components_preview_panel
     routes_queue --> services_source
     routes_source_browser --> routes_core
-    routes_source_browser --> components_preview_panel
+    routes_source_browser --> html_ids
     routes_source_browser --> models
     routes_source_browser --> components_source_browser
-    routes_source_browser --> services_source_utils
+    routes_source_browser --> components_preview_panel
     routes_source_browser --> services_source
-    routes_source_browser --> html_ids
+    routes_source_browser --> services_source_utils
     routes_tabs --> routes_core
     routes_tabs --> services_source_utils
     routes_tabs --> models
@@ -426,7 +426,7 @@ def init_selection_routers(
     source_service: SourceService,  # The source service for queries
     workflow_id: str,  # The workflow identifier
     prefix: str,  # Base prefix for selection routes (e.g., "/workflow/selection")
-) -> Tuple[List[APIRouter], SelectionUrls, Dict[str, Callable], Callable, "SourceBrowserRouterState"]
+) -> SelectionResult:  # Selection router result with routers, urls, routes, and restore
     "Initialize and return all selection routers with URL bundle."
 ```
 
@@ -528,8 +528,9 @@ def _handle_remove_external_source(
     external_db_paths_ref: List[str],  # Shared external paths list (mutated in place)
     fb_routers: FileBrowserRouters,  # File browser routers (for targeted OOB)
     remove_url: str,  # URL for remove button in external sources list
-):  # Tuple of OOB elements (external sources list + checkbox cells)
-    "Remove an external database source from the Added Sources list."
+    urls: SelectionUrls,  # Full URL bundle for queue re-rendering
+):  # Tuple of OOB elements (external sources list + checkbox cells + queue + stats)
+    "Remove an external database source and clean up orphaned queue items."
 ```
 
 ``` python
@@ -539,7 +540,7 @@ def init_local_files_router(
     source_service: SourceService,  # The source service for external db ops
     prefix: str,  # Route prefix (e.g., "/workflow/selection/local_files")
     urls: SelectionUrls,  # URL bundle for rendering
-) -> Tuple[List, Dict[str, Callable], Callable]:  # (routers, route_dict, render_panel_fn)
+) -> LocalFilesResult:  # Router result with routers, routes, render, restore, and reset
     "Initialize local files browser routes with new file browser API."
 ```
 
@@ -558,10 +559,33 @@ _local_files_provider: Optional[LocalFileSystemProvider] = None
 ``` python
 from cjm_transcript_source_select.models import (
     SelectionStepState,
-    SelectionUrls
+    SelectionUrls,
+    LocalFilesResult,
+    SelectionResult
 )
 ```
 
+#### Functions
+
+``` python
+def _no_op_restore(session_id: str) -> None:
+    """Default no-op for restore_state."""
+    pass
+
+def _no_op_reset() -> None
+    "Default no-op for restore_state."
+```
+
+``` python
+def _no_op_reset() -> None:
+    """Default no-op for reset_state."""
+    pass
+
+@dataclass
+class LocalFilesResult
+    "Default no-op for reset_state."
+```
+
 #### Classes
 
 ``` python
@@ -591,6 +615,32 @@ class SelectionUrls:
     tab_switch: str = ''  # Switch source tabs
 ```
 
+``` python
+@dataclass
+class LocalFilesResult:
+    "Return type from init_local_files_router."
+    
+    routers: List[APIRouter]  # Routers to register (custom + file browser + VC)
+    routes: Dict[str, Callable]  # Named route handlers
+    render_panel: Callable  # (error_message?, session_id?) -> rendered panel
+    restore_state: Callable = field(...)  # (session_id) -> None, restore persisted state
+    reset_state: Callable = field(...)  # () -> None, reset in-memory caches
+```
+
+``` python
+@dataclass
+class SelectionResult:
+    "Return type from init_selection_routers."
+    
+    routers: List[APIRouter]  # All selection routers to register
+    urls: 'SelectionUrls' = field(...)  # URL bundle
+    routes: Dict[str, Callable] = field(...)  # All named route handlers
+    render_local_files_panel: Optional[Callable]  # Render fn for local files tab
+    sb_state: Any  # SourceBrowserRouterState
+    restore_state: Callable = field(...)  # (session_id) -> None, restore persisted state
+    reset_state: Callable = field(...)  # () -> None, reset in-memory caches
+```
+
 ### preview_panel (`preview_panel.ipynb`)
 
 > Collapsible preview panel for displaying selected content
@@ -1434,15 +1484,16 @@ from cjm_transcript_source_select.routes.tabs import (
 
 ``` python
 def _handle_tab_switch(
-    state_store: WorkflowStateStore,  # The workflow state store
-    workflow_id: str,  # The workflow identifier
     source_service: SourceService,  # The source service for queries
     request,  # FastHTML request object
     sess,  # FastHTML session object
     direction: str,  # Direction: "prev", "next", "db", or "files"
     urls: SelectionUrls,  # URL bundle for rendering
+    current_tab_ref: List[str],  # Mutable ref [current_tab] for closure-based tracking
     render_local_files_panel: Optional[Callable] = None,  # Render fn for Files tab
     sb_state: Any = None,  # SourceBrowserRouterState for DB tab VC rendering
+    state_store: WorkflowStateStore = None,  # State store (for reading step state)
+    workflow_id: str = "",  # Workflow ID (for reading step state)
 ):  # Tuple of inner content, OOB tab headers, and tab switch script
     "Switch between Plugin DB and Local Files tabs."
 ```

{cjm_transcript_source_select-0.0.14 → cjm_transcript_source_select-0.0.16}/settings.ini

@@ -1,7 +1,7 @@
 [DEFAULT]
 repo = cjm-transcript-source-select
 lib_name = cjm-transcript-source-select
-version = 0.0.14
+version = 0.0.16
 min_python = 3.12
 license = apache2
 black_formatting = False

cjm_transcript_source_select-0.0.14/cjm_transcript_source_select/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.0.14"