cjm-transcript-segment-align 0.0.8__tar.gz → 0.0.10__tar.gz

{cjm_transcript_segment_align-0.0.8/cjm_transcript_segment_align.egg-info → cjm_transcript_segment_align-0.0.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: cjm-transcript-segment-align
-Version: 0.0.8
+Version: 0.0.10
 Summary: FastHTML dual-column text segmentation & VAD alignment UI for transcript decomposition workflows with forced alignment-based text splitting for aligning text segments with VAD chunks.
 Home-page: https://github.com/cj-mills/cjm-transcript-segment-align
 Author: Christian J. Mills
@@ -48,11 +48,13 @@ pip install cjm_transcript_segment_align
 ## Project Structure
 
     nbs/
-    ├── components/ (4)
+    ├── components/ (6)
     │   ├── handlers.ipynb         # Handler wrappers for cross-domain coordination (alignment status updates)
     │   ├── helpers.ipynb          # State extraction helpers for cross-domain coordination in Phase 2 combined step
     │   ├── keyboard_config.ipynb  # Shared keyboard navigation configuration for the combined Phase 2 step
-    │   └── step_renderer.ipynb    # Phase 2 combined step renderer: dual-column layout for Segment & Align
+    │   ├── step_renderer.ipynb    # Phase 2 combined step renderer: dual-column layout for Segment & Align
+    │   ├── sync_controls.ipynb    # Synced navigation toggle for the combined Phase 2 dual-column step
+    │   └── toolbar_state.ipynb    # Centralized client-side toolbar state restoration after HTMX settles
     ├── routes/ (3)
     │   ├── chrome.ipynb            # Shared chrome switching route handlers for the combined Phase 2 step
     │   ├── forced_alignment.ipynb  # Routes for toggling between NLTK and force-aligned pre-splits, plus rendering helpers for FA UI controls. Trigger and progress are handled by `cjm-fasthtml-job-monitor`.
@@ -62,7 +64,7 @@ pip install cjm_transcript_segment_align
     ├── html_ids.ipynb  # HTML ID constants for Phase 2 Shell: Dual-Column Layout shared chrome
     └── models.ipynb    # Data types and result containers for the segment-align integration surface
 
-Total: 10 notebooks across 3 directories
+Total: 12 notebooks across 3 directories
 
 ## Module Dependencies
 
@@ -72,6 +74,8 @@ graph LR
     components_helpers[components.helpers<br/>helpers]
     components_keyboard_config[components.keyboard_config<br/>keyboard_config]
     components_step_renderer[components.step_renderer<br/>step_combined]
+    components_sync_controls[components.sync_controls<br/>sync_controls]
+    components_toolbar_state[components.toolbar_state<br/>toolbar_state]
     html_ids[html_ids<br/>html_ids]
     models[models<br/>models]
     routes_chrome[routes.chrome<br/>chrome]
@@ -79,31 +83,39 @@ graph LR
     routes_init[routes.init<br/>routes/init]
     services_forced_alignment[services.forced_alignment<br/>forced_alignment]
 
+    components_handlers --> html_ids
     components_handlers --> components_keyboard_config
-    components_handlers --> services_forced_alignment
     components_handlers --> components_step_renderer
-    components_handlers --> html_ids
+    components_handlers --> services_forced_alignment
+    components_handlers --> components_sync_controls
     components_handlers --> routes_forced_alignment
     components_keyboard_config --> html_ids
-    components_step_renderer --> components_keyboard_config
+    components_keyboard_config --> components_sync_controls
     components_step_renderer --> html_ids
     components_step_renderer --> components_helpers
+    components_step_renderer --> components_sync_controls
+    components_step_renderer --> components_keyboard_config
+    components_step_renderer --> components_toolbar_state
+    components_toolbar_state --> components_sync_controls
+    routes_chrome --> html_ids
     routes_chrome --> components_handlers
+    routes_chrome --> components_sync_controls
     routes_chrome --> components_step_renderer
-    routes_chrome --> html_ids
-    routes_forced_alignment --> components_step_renderer
     routes_forced_alignment --> html_ids
-    routes_init --> components_step_renderer
-    routes_init --> components_handlers
-    routes_init --> routes_chrome
+    routes_forced_alignment --> components_step_renderer
+    routes_forced_alignment --> components_sync_controls
     routes_init --> components_keyboard_config
     routes_init --> html_ids
-    routes_init --> routes_forced_alignment
+    routes_init --> components_handlers
     routes_init --> models
     routes_init --> services_forced_alignment
+    routes_init --> components_sync_controls
+    routes_init --> components_step_renderer
+    routes_init --> routes_forced_alignment
+    routes_init --> routes_chrome
 ```
 
-*22 cross-module dependencies detected*
+*30 cross-module dependencies detected*
 
 ## CLI Reference
 
@@ -128,17 +140,6 @@ from cjm_transcript_segment_align.routes.chrome import (
 
 #### Functions
 
-``` python
-def _restore_align_auto_nav_js() -> str
-    """
-    Generate JS to sync the auto-navigate toggle checkbox and color classes with the Web Audio state.
-    
-    After chrome switch re-renders the toolbar, the checkbox starts unchecked with bg-error.
-    This reads the JS state (source of truth) and restores the checkbox + color classes.
-    Included inside the toolbar OOB so it runs after HTMX inserts the new content.
-    """
-```
-
 ``` python
 async def _handle_switch_chrome(
     state_store:SQLiteWorkflowStateStore,  # State store instance
@@ -151,7 +152,12 @@ async def _handle_switch_chrome(
     fa_toggle_url:str="",  # URL for FA toggle route
     fa_available:bool=False,  # Whether FA plugin is available
 ) -> tuple:  # OOB swaps for shared chrome containers
-    "Switch shared chrome content based on active column."
+    """
+    Switch shared chrome content based on active column.
+    
+    Client-side toolbar state restoration (sync button, auto-play toggle)
+    is handled by the centralized settle handler from toolbar_state.py.
+    """
 ```
 
 ``` python
@@ -507,26 +513,9 @@ def create_seg_init_chrome_wrapper(
 ```
 
 ``` python
-def create_align_init_chrome_wrapper() -> Callable:  # Wrapped handler that adds alignment status
-    """Create a wrapper for align init that adds mini-stats and alignment status.
-    
-    Returns a footer OOB (not a standalone alignment status badge) to avoid
-    a race condition: both seg and align init auto-trigger on load, and the
-    alignment status badge only exists inside the footer after seg init's
-    footer OOB is processed. Using a footer OOB is safe because the footer
-    container always exists in the DOM.
-    """
-    async def wrapped_align_init(
-        state_store:WorkflowStateStore,
-        workflow_id:str,
-        source_service:SourceService,
-        alignment_service:AlignmentService,
-        request:Any,
-        sess:Any,
-        urls:AlignmentUrls,
-        visible_count:int=5,
-        card_width:int=40,
-    )
+def create_align_init_chrome_wrapper(
+    should_play_fn:str="",  # Consumer-defined play guard function name
+) -> Callable:  # Wrapped handler that adds alignment status
     """
     Create a wrapper for align init that adds mini-stats and alignment status.
     
@@ -851,7 +840,7 @@ def _render_shared_chrome(
     seg_state:dict=None,  # Extracted segmentation state (None = show placeholders)
     align_state:dict=None,  # Extracted alignment state (None = no VAD data yet)
     urls:SegmentationUrls=None,  # Segmentation URL bundle (required when seg_state provided)
-    fa_extra_actions:Any=None,  # FA controls for toolbar extra_actions slot
+    extra_actions:tuple=(),  # Extra toolbar elements (FA controls, sync toggle, etc.)
     nltk_split_disabled:bool=False,  # Whether NLTK Split button is disabled
 ) -> tuple:  # (toolbar, controls, footer)
     """
@@ -919,3 +908,120 @@ _FOOTER_INNER_CLS
 _SEG_COLUMN_CLS
 _ALIGNMENT_COLUMN_CLS
 ```
+
+### sync_controls (`sync_controls.ipynb`)
+
+> Synced navigation toggle for the combined Phase 2 dual-column step
+
+#### Import
+
+``` python
+from cjm_transcript_segment_align.components.sync_controls import (
+    SYNC_TOGGLE_FN,
+    SYNC_KEY,
+    SYNC_BTN_ID,
+    SHOULD_PLAY_FN,
+    render_sync_toggle_button,
+    generate_sync_script,
+    generate_sync_key_toggle_js,
+    generate_should_play_js,
+    generate_sync_restore_js,
+    build_extra_actions
+)
+```
+
+#### Functions
+
+``` python
+def render_sync_toggle_button() -> Any:  # Sync toggle button element
+    "Render the synced navigation toggle button for the seg toolbar."
+```
+
+``` python
+def generate_sync_script(
+    source_input_id:str,  # Seg card stack's focused_index hidden input ID
+    target_nav_url:str,  # Align card stack's nav_to_index URL
+) -> Any:  # Script element with sync JS
+    "Generate the sync JS Script element for the combined step."
+```
+
+``` python
+def generate_sync_key_toggle_js() -> str:  # JS defining window._segAlignSyncKeyToggle
+    "Generate JS for the S key sync toggle wrapper function."
+```
+
+``` python
+def generate_should_play_js() -> str:  # JS defining window.shouldAlignPlay
+    """
+    Generate JS for the custom play guard function.
+    
+    Returns true when audio should play:
+    - Zone is active (direct align navigation), OR
+    - Auto-navigate is on (auto-play through align stack), OR
+    - Sync is enabled (seg navigation driving align)
+    """
+```
+
+``` python
+def generate_sync_restore_js() -> str:  # JS to restore sync button styling from client state
+    """
+    Generate JS to sync the toolbar button styling with the client-side sync state.
+    
+    After chrome switch re-renders the seg toolbar, the sync button starts
+    with btn-outline. This reads the JS state and restores btn-primary if
+    sync is enabled.
+    """
+```
+
+``` python
+def build_extra_actions(
+    fa_extra:Any=None,  # FA controls element (from build_fa_extra_actions, or None)
+) -> tuple:  # Tuple of toolbar extra action elements
+    """
+    Build the extra_actions tuple for the seg toolbar.
+    
+    Combines FA controls (if available) with the sync toggle button.
+    Client-side state restoration (sync button styling) is handled by
+    the centralized toolbar restore settle handler in toolbar_state.py.
+    Returns a tuple compatible with render_toolbar(extra_actions=...).
+    """
+```
+
+#### Variables
+
+``` python
+SYNC_TOGGLE_FN = 'toggleSegAlignSync'
+SYNC_KEY = '_segAlignSync'
+SYNC_BTN_ID = 'sd-sync-toggle-btn'
+SHOULD_PLAY_FN = 'shouldAlignPlay'
+```
+
+### toolbar_state (`toolbar_state.ipynb`)
+
+> Centralized client-side toolbar state restoration after HTMX settles
+
+#### Import
+
+``` python
+from cjm_transcript_segment_align.components.toolbar_state import (
+    generate_toolbar_restore_js
+)
+```
+
+#### Functions
+
+``` python
+def generate_toolbar_restore_js() -> Script:  # Script element with settle handler
+    """
+    Generate the centralized toolbar state restore settle handler.
+    
+    Restores client-side state for all toolbar toggles/buttons after any
+    HTMX settle that re-renders the toolbar. Runs once per settle event.
+    """
+```
+
+#### Variables
+
+``` python
+_TOOLBAR_RESTORE_KEY = '_sdToolbarRestoreHandler'
+```

{cjm_transcript_segment_align-0.0.8 → cjm_transcript_segment_align-0.0.10}/README.md

@@ -12,11 +12,13 @@ pip install cjm_transcript_segment_align
 ## Project Structure
 
     nbs/
-    ├── components/ (4)
+    ├── components/ (6)
     │   ├── handlers.ipynb         # Handler wrappers for cross-domain coordination (alignment status updates)
     │   ├── helpers.ipynb          # State extraction helpers for cross-domain coordination in Phase 2 combined step
     │   ├── keyboard_config.ipynb  # Shared keyboard navigation configuration for the combined Phase 2 step
-    │   └── step_renderer.ipynb    # Phase 2 combined step renderer: dual-column layout for Segment & Align
+    │   ├── step_renderer.ipynb    # Phase 2 combined step renderer: dual-column layout for Segment & Align
+    │   ├── sync_controls.ipynb    # Synced navigation toggle for the combined Phase 2 dual-column step
+    │   └── toolbar_state.ipynb    # Centralized client-side toolbar state restoration after HTMX settles
     ├── routes/ (3)
     │   ├── chrome.ipynb            # Shared chrome switching route handlers for the combined Phase 2 step
     │   ├── forced_alignment.ipynb  # Routes for toggling between NLTK and force-aligned pre-splits, plus rendering helpers for FA UI controls. Trigger and progress are handled by `cjm-fasthtml-job-monitor`.
@@ -26,7 +28,7 @@ pip install cjm_transcript_segment_align
     ├── html_ids.ipynb  # HTML ID constants for Phase 2 Shell: Dual-Column Layout shared chrome
     └── models.ipynb    # Data types and result containers for the segment-align integration surface
 
-Total: 10 notebooks across 3 directories
+Total: 12 notebooks across 3 directories
 
 ## Module Dependencies
 
@@ -36,6 +38,8 @@ graph LR
     components_helpers[components.helpers<br/>helpers]
     components_keyboard_config[components.keyboard_config<br/>keyboard_config]
     components_step_renderer[components.step_renderer<br/>step_combined]
+    components_sync_controls[components.sync_controls<br/>sync_controls]
+    components_toolbar_state[components.toolbar_state<br/>toolbar_state]
     html_ids[html_ids<br/>html_ids]
     models[models<br/>models]
     routes_chrome[routes.chrome<br/>chrome]
@@ -43,31 +47,39 @@ graph LR
     routes_init[routes.init<br/>routes/init]
     services_forced_alignment[services.forced_alignment<br/>forced_alignment]
 
+    components_handlers --> html_ids
     components_handlers --> components_keyboard_config
-    components_handlers --> services_forced_alignment
     components_handlers --> components_step_renderer
-    components_handlers --> html_ids
+    components_handlers --> services_forced_alignment
+    components_handlers --> components_sync_controls
     components_handlers --> routes_forced_alignment
     components_keyboard_config --> html_ids
-    components_step_renderer --> components_keyboard_config
+    components_keyboard_config --> components_sync_controls
     components_step_renderer --> html_ids
     components_step_renderer --> components_helpers
+    components_step_renderer --> components_sync_controls
+    components_step_renderer --> components_keyboard_config
+    components_step_renderer --> components_toolbar_state
+    components_toolbar_state --> components_sync_controls
+    routes_chrome --> html_ids
     routes_chrome --> components_handlers
+    routes_chrome --> components_sync_controls
     routes_chrome --> components_step_renderer
-    routes_chrome --> html_ids
-    routes_forced_alignment --> components_step_renderer
     routes_forced_alignment --> html_ids
-    routes_init --> components_step_renderer
-    routes_init --> components_handlers
-    routes_init --> routes_chrome
+    routes_forced_alignment --> components_step_renderer
+    routes_forced_alignment --> components_sync_controls
     routes_init --> components_keyboard_config
     routes_init --> html_ids
-    routes_init --> routes_forced_alignment
+    routes_init --> components_handlers
     routes_init --> models
     routes_init --> services_forced_alignment
+    routes_init --> components_sync_controls
+    routes_init --> components_step_renderer
+    routes_init --> routes_forced_alignment
+    routes_init --> routes_chrome
 ```
 
-*22 cross-module dependencies detected*
+*30 cross-module dependencies detected*
 
 ## CLI Reference
 
@@ -92,17 +104,6 @@ from cjm_transcript_segment_align.routes.chrome import (
 
 #### Functions
 
-``` python
-def _restore_align_auto_nav_js() -> str
-    """
-    Generate JS to sync the auto-navigate toggle checkbox and color classes with the Web Audio state.
-    
-    After chrome switch re-renders the toolbar, the checkbox starts unchecked with bg-error.
-    This reads the JS state (source of truth) and restores the checkbox + color classes.
-    Included inside the toolbar OOB so it runs after HTMX inserts the new content.
-    """
-```
-
 ``` python
 async def _handle_switch_chrome(
     state_store:SQLiteWorkflowStateStore,  # State store instance
@@ -115,7 +116,12 @@ async def _handle_switch_chrome(
     fa_toggle_url:str="",  # URL for FA toggle route
     fa_available:bool=False,  # Whether FA plugin is available
 ) -> tuple:  # OOB swaps for shared chrome containers
-    "Switch shared chrome content based on active column."
+    """
+    Switch shared chrome content based on active column.
+    
+    Client-side toolbar state restoration (sync button, auto-play toggle)
+    is handled by the centralized settle handler from toolbar_state.py.
+    """
 ```
 
 ``` python
@@ -471,26 +477,9 @@ def create_seg_init_chrome_wrapper(
 ```
 
 ``` python
-def create_align_init_chrome_wrapper() -> Callable:  # Wrapped handler that adds alignment status
-    """Create a wrapper for align init that adds mini-stats and alignment status.
-    
-    Returns a footer OOB (not a standalone alignment status badge) to avoid
-    a race condition: both seg and align init auto-trigger on load, and the
-    alignment status badge only exists inside the footer after seg init's
-    footer OOB is processed. Using a footer OOB is safe because the footer
-    container always exists in the DOM.
-    """
-    async def wrapped_align_init(
-        state_store:WorkflowStateStore,
-        workflow_id:str,
-        source_service:SourceService,
-        alignment_service:AlignmentService,
-        request:Any,
-        sess:Any,
-        urls:AlignmentUrls,
-        visible_count:int=5,
-        card_width:int=40,
-    )
+def create_align_init_chrome_wrapper(
+    should_play_fn:str="",  # Consumer-defined play guard function name
+) -> Callable:  # Wrapped handler that adds alignment status
     """
     Create a wrapper for align init that adds mini-stats and alignment status.
     
@@ -815,7 +804,7 @@ def _render_shared_chrome(
     seg_state:dict=None,  # Extracted segmentation state (None = show placeholders)
     align_state:dict=None,  # Extracted alignment state (None = no VAD data yet)
     urls:SegmentationUrls=None,  # Segmentation URL bundle (required when seg_state provided)
-    fa_extra_actions:Any=None,  # FA controls for toolbar extra_actions slot
+    extra_actions:tuple=(),  # Extra toolbar elements (FA controls, sync toggle, etc.)
     nltk_split_disabled:bool=False,  # Whether NLTK Split button is disabled
 ) -> tuple:  # (toolbar, controls, footer)
     """
@@ -883,3 +872,120 @@ _FOOTER_INNER_CLS
 _SEG_COLUMN_CLS
 _ALIGNMENT_COLUMN_CLS
 ```
+
+### sync_controls (`sync_controls.ipynb`)
+
+> Synced navigation toggle for the combined Phase 2 dual-column step
+
+#### Import
+
+``` python
+from cjm_transcript_segment_align.components.sync_controls import (
+    SYNC_TOGGLE_FN,
+    SYNC_KEY,
+    SYNC_BTN_ID,
+    SHOULD_PLAY_FN,
+    render_sync_toggle_button,
+    generate_sync_script,
+    generate_sync_key_toggle_js,
+    generate_should_play_js,
+    generate_sync_restore_js,
+    build_extra_actions
+)
+```
+
+#### Functions
+
+``` python
+def render_sync_toggle_button() -> Any:  # Sync toggle button element
+    "Render the synced navigation toggle button for the seg toolbar."
+```
+
+``` python
+def generate_sync_script(
+    source_input_id:str,  # Seg card stack's focused_index hidden input ID
+    target_nav_url:str,  # Align card stack's nav_to_index URL
+) -> Any:  # Script element with sync JS
+    "Generate the sync JS Script element for the combined step."
+```
+
+``` python
+def generate_sync_key_toggle_js() -> str:  # JS defining window._segAlignSyncKeyToggle
+    "Generate JS for the S key sync toggle wrapper function."
+```
+
+``` python
+def generate_should_play_js() -> str:  # JS defining window.shouldAlignPlay
+    """
+    Generate JS for the custom play guard function.
+    
+    Returns true when audio should play:
+    - Zone is active (direct align navigation), OR
+    - Auto-navigate is on (auto-play through align stack), OR
+    - Sync is enabled (seg navigation driving align)
+    """
+```
+
+``` python
+def generate_sync_restore_js() -> str:  # JS to restore sync button styling from client state
+    """
+    Generate JS to sync the toolbar button styling with the client-side sync state.
+    
+    After chrome switch re-renders the seg toolbar, the sync button starts
+    with btn-outline. This reads the JS state and restores btn-primary if
+    sync is enabled.
+    """
+```
+
+``` python
+def build_extra_actions(
+    fa_extra:Any=None,  # FA controls element (from build_fa_extra_actions, or None)
+) -> tuple:  # Tuple of toolbar extra action elements
+    """
+    Build the extra_actions tuple for the seg toolbar.
+    
+    Combines FA controls (if available) with the sync toggle button.
+    Client-side state restoration (sync button styling) is handled by
+    the centralized toolbar restore settle handler in toolbar_state.py.
+    Returns a tuple compatible with render_toolbar(extra_actions=...).
+    """
+```
+
+#### Variables
+
+``` python
+SYNC_TOGGLE_FN = 'toggleSegAlignSync'
+SYNC_KEY = '_segAlignSync'
+SYNC_BTN_ID = 'sd-sync-toggle-btn'
+SHOULD_PLAY_FN = 'shouldAlignPlay'
+```
+
+### toolbar_state (`toolbar_state.ipynb`)
+
+> Centralized client-side toolbar state restoration after HTMX settles
+
+#### Import
+
+``` python
+from cjm_transcript_segment_align.components.toolbar_state import (
+    generate_toolbar_restore_js
+)
+```
+
+#### Functions
+
+``` python
+def generate_toolbar_restore_js() -> Script:  # Script element with settle handler
+    """
+    Generate the centralized toolbar state restore settle handler.
+    
+    Restores client-side state for all toolbar toggles/buttons after any
+    HTMX settle that re-renders the toolbar. Runs once per settle event.
+    """
+```
+
+#### Variables
+
+``` python
+_TOOLBAR_RESTORE_KEY = '_sdToolbarRestoreHandler'
+```

cjm_transcript_segment_align-0.0.10/cjm_transcript_segment_align/__init__.py

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

{cjm_transcript_segment_align-0.0.8 → cjm_transcript_segment_align-0.0.10}/cjm_transcript_segment_align/_modidx.py

@@ -63,6 +63,20 @@ d = { 'settings': { 'branch': 'main',
                                                                                                                                                               'cjm_transcript_segment_align/components/step_renderer.py'),
                                                                        'cjm_transcript_segment_align.components.step_renderer.render_seg_mini_stats_badge': ( 'components/step_renderer.html#render_seg_mini_stats_badge',
                                                                                                                                                               'cjm_transcript_segment_align/components/step_renderer.py')},
+            'cjm_transcript_segment_align.components.sync_controls': { 'cjm_transcript_segment_align.components.sync_controls.build_extra_actions': ( 'components/sync_controls.html#build_extra_actions',
+                                                                                                                                                      'cjm_transcript_segment_align/components/sync_controls.py'),
+                                                                       'cjm_transcript_segment_align.components.sync_controls.generate_should_play_js': ( 'components/sync_controls.html#generate_should_play_js',
+                                                                                                                                                          'cjm_transcript_segment_align/components/sync_controls.py'),
+                                                                       'cjm_transcript_segment_align.components.sync_controls.generate_sync_key_toggle_js': ( 'components/sync_controls.html#generate_sync_key_toggle_js',
+                                                                                                                                                              'cjm_transcript_segment_align/components/sync_controls.py'),
+                                                                       'cjm_transcript_segment_align.components.sync_controls.generate_sync_restore_js': ( 'components/sync_controls.html#generate_sync_restore_js',
+                                                                                                                                                           'cjm_transcript_segment_align/components/sync_controls.py'),
+                                                                       'cjm_transcript_segment_align.components.sync_controls.generate_sync_script': ( 'components/sync_controls.html#generate_sync_script',
+                                                                                                                                                       'cjm_transcript_segment_align/components/sync_controls.py'),
+                                                                       'cjm_transcript_segment_align.components.sync_controls.render_sync_toggle_button': ( 'components/sync_controls.html#render_sync_toggle_button',
+                                                                                                                                                            'cjm_transcript_segment_align/components/sync_controls.py')},
+            'cjm_transcript_segment_align.components.toolbar_state': { 'cjm_transcript_segment_align.components.toolbar_state.generate_toolbar_restore_js': ( 'components/toolbar_state.html#generate_toolbar_restore_js',
+                                                                                                                                                              'cjm_transcript_segment_align/components/toolbar_state.py')},
             'cjm_transcript_segment_align.html_ids': { 'cjm_transcript_segment_align.html_ids.CombinedHtmlIds': ( 'html_ids.html#combinedhtmlids',
                                                                                                                   'cjm_transcript_segment_align/html_ids.py'),
                                                        'cjm_transcript_segment_align.html_ids.CombinedHtmlIds.as_selector': ( 'html_ids.html#combinedhtmlids.as_selector',
@@ -73,8 +87,6 @@ d = { 'settings': { 'branch': 'main',
                                                                                                                'cjm_transcript_segment_align/models.py')},
             'cjm_transcript_segment_align.routes.chrome': { 'cjm_transcript_segment_align.routes.chrome._handle_switch_chrome': ( 'routes/chrome.html#_handle_switch_chrome',
                                                                                                                                   'cjm_transcript_segment_align/routes/chrome.py'),
-                                                            'cjm_transcript_segment_align.routes.chrome._restore_align_auto_nav_js': ( 'routes/chrome.html#_restore_align_auto_nav_js',
-                                                                                                                                       'cjm_transcript_segment_align/routes/chrome.py'),
                                                             'cjm_transcript_segment_align.routes.chrome.init_chrome_router': ( 'routes/chrome.html#init_chrome_router',
                                                                                                                                'cjm_transcript_segment_align/routes/chrome.py')},
             'cjm_transcript_segment_align.routes.forced_alignment': { 'cjm_transcript_segment_align.routes.forced_alignment._handle_fa_toggle': ( 'routes/forced_alignment.html#_handle_fa_toggle',

{cjm_transcript_segment_align-0.0.8 → cjm_transcript_segment_align-0.0.10}/cjm_transcript_segment_align/components/handlers.py

@@ -31,6 +31,7 @@ from cjm_transcript_segment_align.components.keyboard_config import (
     build_combined_kb_system,
     generate_zone_change_js, SWITCH_CHROME_BTN_ID,
 )
+from .sync_controls import build_extra_actions
 from cjm_transcript_segmentation.models import TextSegment, SegmentationUrls
 from cjm_transcript_segmentation.routes.core import WorkflowStateStore
 from cjm_transcript_segmentation.routes.handlers import (
@@ -249,7 +250,7 @@ def build_fa_on_complete(
             visible_count=seg_state.get("visible_count", DEFAULT_VISIBLE_COUNT),
             history_depth=0,
             urls=seg_urls,
-            extra_actions=fa_toggle,
+            extra_actions=build_extra_actions(fa_toggle),
             nltk_split_disabled=False,
         )
 
@@ -333,13 +334,14 @@ def create_seg_mutation_wrapper(
         seg_oob = build_mutation_response(
             result.segment_dicts, result.focused_index, result.visible_count,
             result.history_depth, urls, is_auto_mode=result.is_auto_mode,
-            extra_actions=fa_extra, nltk_split_disabled=nltk_disabled,
+            extra_actions=build_extra_actions(fa_extra), nltk_split_disabled=nltk_disabled,
         )
 
         return (*seg_oob, *result.extra_oob, *alignment_status_oob, *mini_stats_oob)
 
     return wrapped
 
+
 # %% ../../nbs/components/handlers.ipynb #f6a7b8c9
 def wrap_align_mutation_handler(
     handler: Callable,  # Handler function to wrap
@@ -460,7 +462,7 @@ def create_seg_init_chrome_wrapper(
                 can_undo=(result.history_depth > 0),
                 visible_count=result.visible_count,
                 is_auto_mode=result.is_auto_mode,
-                extra_actions=fa_extra,
+                extra_actions=build_extra_actions(fa_extra),
                 nltk_split_disabled=True,
             ),
             id=CombinedHtmlIds.SHARED_TOOLBAR,
@@ -502,8 +504,11 @@ def create_seg_init_chrome_wrapper(
     
     return wrapped_seg_init
 
+
 # %% ../../nbs/components/handlers.ipynb #ecvyiypdxk
-def create_align_init_chrome_wrapper() -> Callable:  # Wrapped handler that adds alignment status
+def create_align_init_chrome_wrapper(
+    should_play_fn:str="",  # Consumer-defined play guard function name
+) -> Callable:  # Wrapped handler that adds alignment status
     """Create a wrapper for align init that adds mini-stats and alignment status.
     
     Returns a footer OOB (not a standalone alignment status badge) to avoid
@@ -528,6 +533,7 @@ def create_align_init_chrome_wrapper() -> Callable:  # Wrapped handler that adds
         result: AlignInitResult = await _handle_align_init(
             state_store, workflow_id, source_service, alignment_service,
             request, sess, urls, visible_count, card_width,
+            should_play_fn=should_play_fn,
         )
         
         session_id = get_session_id(sess)
@@ -558,6 +564,7 @@ def create_align_init_chrome_wrapper() -> Callable:  # Wrapped handler that adds
     
     return wrapped_align_init
 
+
 # %% ../../nbs/components/handlers.ipynb #b8c9d0e1
 def create_seg_mutation_wrappers(
     jm_trigger: Any = None,  # Pre-rendered job monitor trigger element