cjm-transcript-source-select 0.0.15__tar.gz → 0.0.17__tar.gz

{cjm_transcript_source_select-0.0.15/cjm_transcript_source_select.egg-info → cjm_transcript_source_select-0.0.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: cjm-transcript-source-select
-Version: 0.0.15
+Version: 0.0.17
 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
@@ -109,53 +109,53 @@ graph LR
     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 --> services_source_utils
     components_source_browser --> html_ids
-    components_step_renderer --> components_preview_panel
-    components_step_renderer --> components_selection_queue
-    components_step_renderer --> utils
-    components_step_renderer --> components_local_files
     components_step_renderer --> html_ids
-    components_step_renderer --> models
     components_step_renderer --> components_source_browser
+    components_step_renderer --> components_local_files
+    components_step_renderer --> components_selection_queue
+    components_step_renderer --> models
+    components_step_renderer --> components_preview_panel
+    components_step_renderer --> utils
+    routes_core --> components_step_renderer
     routes_core --> models
-    routes_core --> services_source
     routes_core --> components_selection_queue
-    routes_core --> components_step_renderer
+    routes_core --> services_source
     routes_core --> html_ids
-    routes_filtering --> routes_core
     routes_filtering --> services_source_utils
-    routes_filtering --> services_source
+    routes_filtering --> routes_core
     routes_filtering --> models
-    routes_init --> routes_core
+    routes_filtering --> services_source
     routes_init --> routes_queue
+    routes_init --> routes_core
     routes_init --> routes_tabs
-    routes_init --> routes_filtering
-    routes_init --> services_source
-    routes_init --> routes_source_browser
     routes_init --> routes_local_files
     routes_init --> models
-    routes_local_files --> models
-    routes_local_files --> routes_core
+    routes_init --> services_source
+    routes_init --> routes_source_browser
+    routes_init --> routes_filtering
     routes_local_files --> components_local_files
+    routes_local_files --> models
     routes_local_files --> services_source
-    routes_queue --> routes_core
+    routes_local_files --> routes_core
     routes_queue --> services_source_utils
+    routes_queue --> routes_core
+    routes_queue --> models
     routes_queue --> components_preview_panel
     routes_queue --> services_source
-    routes_queue --> models
+    routes_source_browser --> html_ids
     routes_source_browser --> components_source_browser
-    routes_source_browser --> components_preview_panel
-    routes_source_browser --> services_source_utils
-    routes_source_browser --> services_source
     routes_source_browser --> routes_core
-    routes_source_browser --> html_ids
     routes_source_browser --> models
+    routes_source_browser --> components_preview_panel
+    routes_source_browser --> services_source
+    routes_source_browser --> services_source_utils
+    routes_tabs --> routes_core
     routes_tabs --> models
     routes_tabs --> components_step_renderer
     routes_tabs --> services_source
-    routes_tabs --> routes_core
     routes_tabs --> services_source_utils
 ```
 
@@ -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
-) -> LocalFilesResult:  # Router result with routers, routes, render, and restore
+) -> LocalFilesResult:  # Router result with routers, routes, render, restore, and reset
     "Initialize local files browser routes with new file browser API."
 ```
 
@@ -571,9 +572,18 @@ 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 restore_state."
+    "Default no-op for reset_state."
 ```
 
 #### Classes
@@ -614,6 +624,7 @@ class LocalFilesResult:
     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
@@ -627,6 +638,7 @@ class SelectionResult:
     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`)
@@ -1382,13 +1394,6 @@ def _create_parent_keyboard_manager() -> ZoneManager:  # Parent keyboard manager
     "Create the parent keyboard manager with two ghost zones for column switching."
 ```
 
-``` python
-def _render_selection_keyboard_hints(
-    manager: ZoneManager,  # Keyboard zone manager with actions configured
-) -> Any:  # Collapsible keyboard hints component
-    "Render keyboard shortcut hints in a collapsible container."
-```
-
 ``` python
 def _render_selection_stats(
     selected_sources: List[Dict[str, str]],  # Selected sources

{cjm_transcript_source_select-0.0.15 → cjm_transcript_source_select-0.0.17}/README.md

@@ -63,53 +63,53 @@ graph LR
     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 --> services_source_utils
     components_source_browser --> html_ids
-    components_step_renderer --> components_preview_panel
-    components_step_renderer --> components_selection_queue
-    components_step_renderer --> utils
-    components_step_renderer --> components_local_files
     components_step_renderer --> html_ids
-    components_step_renderer --> models
     components_step_renderer --> components_source_browser
+    components_step_renderer --> components_local_files
+    components_step_renderer --> components_selection_queue
+    components_step_renderer --> models
+    components_step_renderer --> components_preview_panel
+    components_step_renderer --> utils
+    routes_core --> components_step_renderer
     routes_core --> models
-    routes_core --> services_source
     routes_core --> components_selection_queue
-    routes_core --> components_step_renderer
+    routes_core --> services_source
     routes_core --> html_ids
-    routes_filtering --> routes_core
     routes_filtering --> services_source_utils
-    routes_filtering --> services_source
+    routes_filtering --> routes_core
     routes_filtering --> models
-    routes_init --> routes_core
+    routes_filtering --> services_source
     routes_init --> routes_queue
+    routes_init --> routes_core
     routes_init --> routes_tabs
-    routes_init --> routes_filtering
-    routes_init --> services_source
-    routes_init --> routes_source_browser
     routes_init --> routes_local_files
     routes_init --> models
-    routes_local_files --> models
-    routes_local_files --> routes_core
+    routes_init --> services_source
+    routes_init --> routes_source_browser
+    routes_init --> routes_filtering
     routes_local_files --> components_local_files
+    routes_local_files --> models
     routes_local_files --> services_source
-    routes_queue --> routes_core
+    routes_local_files --> routes_core
     routes_queue --> services_source_utils
+    routes_queue --> routes_core
+    routes_queue --> models
     routes_queue --> components_preview_panel
     routes_queue --> services_source
-    routes_queue --> models
+    routes_source_browser --> html_ids
     routes_source_browser --> components_source_browser
-    routes_source_browser --> components_preview_panel
-    routes_source_browser --> services_source_utils
-    routes_source_browser --> services_source
     routes_source_browser --> routes_core
-    routes_source_browser --> html_ids
     routes_source_browser --> models
+    routes_source_browser --> components_preview_panel
+    routes_source_browser --> services_source
+    routes_source_browser --> services_source_utils
+    routes_tabs --> routes_core
     routes_tabs --> models
     routes_tabs --> components_step_renderer
     routes_tabs --> services_source
-    routes_tabs --> routes_core
     routes_tabs --> services_source_utils
 ```
 
@@ -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
-) -> LocalFilesResult:  # Router result with routers, routes, render, and restore
+) -> LocalFilesResult:  # Router result with routers, routes, render, restore, and reset
     "Initialize local files browser routes with new file browser API."
 ```
 
@@ -525,9 +526,18 @@ 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 restore_state."
+    "Default no-op for reset_state."
 ```
 
 #### Classes
@@ -568,6 +578,7 @@ class LocalFilesResult:
     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
@@ -581,6 +592,7 @@ class SelectionResult:
     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`)
@@ -1336,13 +1348,6 @@ def _create_parent_keyboard_manager() -> ZoneManager:  # Parent keyboard manager
     "Create the parent keyboard manager with two ghost zones for column switching."
 ```
 
-``` python
-def _render_selection_keyboard_hints(
-    manager: ZoneManager,  # Keyboard zone manager with actions configured
-) -> Any:  # Collapsible keyboard hints component
-    "Render keyboard shortcut hints in a collapsible container."
-```
-
 ``` python
 def _render_selection_stats(
     selected_sources: List[Dict[str, str]],  # Selected sources

cjm_transcript_source_select-0.0.17/cjm_transcript_source_select/__init__.py

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

{cjm_transcript_source_select-0.0.15 → cjm_transcript_source_select-0.0.17}/cjm_transcript_source_select/_modidx.py

@@ -59,8 +59,6 @@ d = { 'settings': { 'branch': 'main',
                                                                                                                                                          'cjm_transcript_source_select/components/step_renderer.py'),
                                                                        'cjm_transcript_source_select.components.step_renderer._render_selection_footer': ( 'components/step_renderer.html#_render_selection_footer',
                                                                                                                                                            'cjm_transcript_source_select/components/step_renderer.py'),
-                                                                       'cjm_transcript_source_select.components.step_renderer._render_selection_keyboard_hints': ( 'components/step_renderer.html#_render_selection_keyboard_hints',
-                                                                                                                                                                   'cjm_transcript_source_select/components/step_renderer.py'),
                                                                        'cjm_transcript_source_select.components.step_renderer._render_selection_stats': ( 'components/step_renderer.html#_render_selection_stats',
                                                                                                                                                           'cjm_transcript_source_select/components/step_renderer.py'),
                                                                        'cjm_transcript_source_select.components.step_renderer._render_source_tabs': ( 'components/step_renderer.html#_render_source_tabs',
@@ -89,6 +87,8 @@ d = { 'settings': { 'branch': 'main',
                                                                                                                  '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._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-0.0.15 → cjm_transcript_source_select-0.0.17}/cjm_transcript_source_select/components/step_renderer.py

@@ -9,14 +9,11 @@ __all__ = ['SD_TAB_PREV_BTN', 'SD_TAB_NEXT_BTN', 'SD_PREVIEW_BTN', 'FB_SYSTEM_ID
 from typing import Any, Callable, Dict, List, Optional
 
 from fasthtml.common import (
-    Div, H2, P, Span, Input, Script, Details, Summary
+    Div, H2, P, Span, Input, Script
 )
 
 # DaisyUI components
 from cjm_fasthtml_daisyui.components.data_display.badge import badge, badge_colors, badge_sizes
-from cjm_fasthtml_daisyui.components.data_display.collapse import (
-    collapse, collapse_title, collapse_content, collapse_modifiers
-)
 from cjm_fasthtml_daisyui.components.navigation.tabs import tabs, tabs_styles, tab
 from cjm_fasthtml_daisyui.utilities.semantic_colors import bg_dui, text_dui, border_dui, ring_dui, shadow_dui
 from cjm_fasthtml_daisyui.utilities.border_radius import border_radius
@@ -49,7 +46,7 @@ from cjm_fasthtml_keyboard_navigation.core.actions import KeyAction
 from cjm_fasthtml_keyboard_navigation.core.manager import ZoneManager
 from cjm_fasthtml_keyboard_navigation.core.navigation import ScrollOnly
 from cjm_fasthtml_keyboard_navigation.components.system import render_keyboard_system
-from cjm_fasthtml_keyboard_navigation.components.hints import render_keyboard_hints
+from cjm_fasthtml_keyboard_navigation.components.hints_modal import render_keyboard_hints_modal
 
 # Source browser system ID (for hierarchy wiring)
 from .source_browser import SB_SYSTEM_ID
@@ -148,32 +145,6 @@ def _create_parent_keyboard_manager() -> ZoneManager:  # Parent keyboard manager
         state_hidden_inputs=True,
     )
 
-# %% ../../nbs/components/step_renderer.ipynb #52i7b5ddglt
-def _render_selection_keyboard_hints(
-    manager: ZoneManager,  # Keyboard zone manager with actions configured
-) -> Any:  # Collapsible keyboard hints component
-    """Render keyboard shortcut hints in a collapsible container."""
-    hints = render_keyboard_hints(
-        manager,
-        include_navigation=True,
-        include_zone_switch=True,
-        badge_style="outline",
-        container_id="sd-keyboard-hints",
-        use_icons=False
-    )
-    
-    return Details(
-        Summary(
-            "Keyboard Shortcuts",
-            cls=combine_classes(collapse_title, font_size.sm, font_weight.medium)
-        ),
-        Div(
-            hints,
-            cls=collapse_content
-        ),
-        cls=combine_classes(collapse, collapse_modifiers.arrow, bg_dui.base_200)
-    )
-
 # %% ../../nbs/components/step_renderer.ipynb #8d397d19
 def _render_selection_stats(
     selected_sources: List[Dict[str, str]],  # Selected sources
@@ -499,16 +470,21 @@ def render_selection_step(
     # Hierarchy wiring script (must come after all keyboard systems are rendered)
     hierarchy_js = _generate_hierarchy_js(active_tab)
 
+    # Keyboard hints modal
+    hints_modal, hints_trigger, hints_script = render_keyboard_hints_modal(kb_manager)
+
     return Div(
-        # Header with keyboard hints
+        # Header with keyboard hints trigger
         Div(
-            H2("Select Source Material", cls=combine_classes(font_size._3xl, font_weight.bold)),
-            P(
-                "Choose transcription sources to decompose into a structural spine.",
-                cls=combine_classes(text_dui.base_content.opacity(70), m.b(4))
+            Div(
+                H2("Select Source Material", cls=combine_classes(font_size._3xl, font_weight.bold)),
+                P(
+                    "Choose transcription sources to decompose into a structural spine.",
+                    cls=combine_classes(text_dui.base_content.opacity(70), m.b(4))
+                ),
             ),
-            _render_selection_keyboard_hints(kb_manager),
-            cls=combine_classes(m.b(4))
+            hints_trigger,
+            cls=combine_classes(flex_display, items.start, justify.between, m.b(4))
         ),
 
         # Main content area (two columns: tabs + queue)
@@ -571,6 +547,10 @@ def render_selection_step(
         # Script runner for OOB-triggered JS (duplicate rejection flash)
         Div(id=SelectionHtmlIds.SCRIPT_RUNNER),
 
+        # Keyboard hints modal + ? key listener
+        hints_modal,
+        hints_script,
+
         id=SelectionHtmlIds.SOURCE_SELECTOR,
         cls=combine_classes(
             w.full,

{cjm_transcript_source_select-0.0.15 → cjm_transcript_source_select-0.0.17}/cjm_transcript_source_select/models.py

@@ -59,6 +59,10 @@ 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."""
@@ -66,6 +70,7 @@ class LocalFilesResult:
     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:
@@ -76,3 +81,4 @@ class SelectionResult:
     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.15 → cjm_transcript_source_select-0.0.17}/cjm_transcript_source_select/routes/init.py

@@ -127,4 +127,5 @@ def init_selection_routers(
         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.15 → cjm_transcript_source_select-0.0.17}/cjm_transcript_source_select/routes/local_files.py

@@ -19,7 +19,8 @@ from cjm_fasthtml_interactions.core.state_store import get_session_id
 
 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
-) -> LocalFilesResult:  # Router result with routers, routes, render, and restore
+) -> 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()
@@ -156,8 +181,10 @@ def init_local_files_router(
         if request is not None and not _state_restored[0]:
             _restore_from_persisted(get_session_id(request.session))
 
-        # Validate any newly added paths
+        # 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:
@@ -185,10 +212,32 @@ def init_local_files_router(
                 external_db_paths=list(_external_db_paths),
             )
 
-        return (
+        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,
@@ -226,6 +275,17 @@ def init_local_files_router(
         _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)
 
@@ -238,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
@@ -252,4 +313,5 @@ def init_local_files_router(
         routes=routes,
         render_panel=_render_panel,
         restore_state=_restore_state,
+        reset_state=_reset_state,
     )

{cjm_transcript_source_select-0.0.15 → cjm_transcript_source_select-0.0.17/cjm_transcript_source_select.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: cjm-transcript-source-select
-Version: 0.0.15
+Version: 0.0.17
 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
@@ -109,53 +109,53 @@ graph LR
     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 --> services_source_utils
     components_source_browser --> html_ids
-    components_step_renderer --> components_preview_panel
-    components_step_renderer --> components_selection_queue
-    components_step_renderer --> utils
-    components_step_renderer --> components_local_files
     components_step_renderer --> html_ids
-    components_step_renderer --> models
     components_step_renderer --> components_source_browser
+    components_step_renderer --> components_local_files
+    components_step_renderer --> components_selection_queue
+    components_step_renderer --> models
+    components_step_renderer --> components_preview_panel
+    components_step_renderer --> utils
+    routes_core --> components_step_renderer
     routes_core --> models
-    routes_core --> services_source
     routes_core --> components_selection_queue
-    routes_core --> components_step_renderer
+    routes_core --> services_source
     routes_core --> html_ids
-    routes_filtering --> routes_core
     routes_filtering --> services_source_utils
-    routes_filtering --> services_source
+    routes_filtering --> routes_core
     routes_filtering --> models
-    routes_init --> routes_core
+    routes_filtering --> services_source
     routes_init --> routes_queue
+    routes_init --> routes_core
     routes_init --> routes_tabs
-    routes_init --> routes_filtering
-    routes_init --> services_source
-    routes_init --> routes_source_browser
     routes_init --> routes_local_files
     routes_init --> models
-    routes_local_files --> models
-    routes_local_files --> routes_core
+    routes_init --> services_source
+    routes_init --> routes_source_browser
+    routes_init --> routes_filtering
     routes_local_files --> components_local_files
+    routes_local_files --> models
     routes_local_files --> services_source
-    routes_queue --> routes_core
+    routes_local_files --> routes_core
     routes_queue --> services_source_utils
+    routes_queue --> routes_core
+    routes_queue --> models
     routes_queue --> components_preview_panel
     routes_queue --> services_source
-    routes_queue --> models
+    routes_source_browser --> html_ids
     routes_source_browser --> components_source_browser
-    routes_source_browser --> components_preview_panel
-    routes_source_browser --> services_source_utils
-    routes_source_browser --> services_source
     routes_source_browser --> routes_core
-    routes_source_browser --> html_ids
     routes_source_browser --> models
+    routes_source_browser --> components_preview_panel
+    routes_source_browser --> services_source
+    routes_source_browser --> services_source_utils
+    routes_tabs --> routes_core
     routes_tabs --> models
     routes_tabs --> components_step_renderer
     routes_tabs --> services_source
-    routes_tabs --> routes_core
     routes_tabs --> services_source_utils
 ```
 
@@ -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
-) -> LocalFilesResult:  # Router result with routers, routes, render, and restore
+) -> LocalFilesResult:  # Router result with routers, routes, render, restore, and reset
     "Initialize local files browser routes with new file browser API."
 ```
 
@@ -571,9 +572,18 @@ 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 restore_state."
+    "Default no-op for reset_state."
 ```
 
 #### Classes
@@ -614,6 +624,7 @@ class LocalFilesResult:
     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
@@ -627,6 +638,7 @@ class SelectionResult:
     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`)
@@ -1382,13 +1394,6 @@ def _create_parent_keyboard_manager() -> ZoneManager:  # Parent keyboard manager
     "Create the parent keyboard manager with two ghost zones for column switching."
 ```
 
-``` python
-def _render_selection_keyboard_hints(
-    manager: ZoneManager,  # Keyboard zone manager with actions configured
-) -> Any:  # Collapsible keyboard hints component
-    "Render keyboard shortcut hints in a collapsible container."
-```
-
 ``` python
 def _render_selection_stats(
     selected_sources: List[Dict[str, str]],  # Selected sources

{cjm_transcript_source_select-0.0.15 → cjm_transcript_source_select-0.0.17}/settings.ini

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

cjm_transcript_source_select-0.0.15/cjm_transcript_source_select/__init__.py

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