build_tools.syllable_walk_tui.core.app

Main Textual application for Syllable Walker TUI.

This module contains the primary App class, modal screens, and layout widgets for the interactive terminal interface.

Architecture: - Main view: Side-by-side patch configuration (always visible) - Modal screens: Blended Walk (v) and Analysis (a) views - Keyboard-first navigation with configurable keybindings

Classes

SyllableWalkerApp

Main Textual application for Syllable Walker TUI.

Module Contents

class build_tools.syllable_walk_tui.core.app.SyllableWalkerApp

Bases: textual.app.App

Main Textual application for Syllable Walker TUI.

Provides interactive interface for exploring phonetic space through side-by-side patch configuration and real-time generation.

Default Keybindings:

q, Ctrl+Q: Quit application ?, F1: Show help v: View blended walk (modal screen) a: View analysis (modal screen) 1: Select corpus for Patch A 2: Select corpus for Patch B

Note

All keybindings are user-configurable via ~/.config/pipeworks_tui/keybindings.toml

Initialize application with default state.

BINDINGS

The default key bindings.

CSS_PATH = 'styles.tcss'

File paths to load CSS from.

state

keybindings

theme = 'nord'

The name of the currently active theme.

compose()

Create application layout.

on_mount()

Handle app mount event.

NOTE: Previously disabled focus on ALL container widgets, but this broke tab order. Now we only disable focus on the StatsPanel container since it has no focusable children and shouldn’t be in the tab navigation path.

on_button_select_corpus_a()

Handle Patch A corpus selection button press.

on_button_select_corpus_b()

Handle Patch B corpus selection button press.

on_button_generate_a()

Generate walks for patch A.

on_button_generate_b()

Generate walks for patch B.

on_button_generate_candidates_a()

Generate candidates for Patch A using name_combiner (mirrors CLI behavior).

on_button_generate_candidates_b()

Generate candidates for Patch B using name_combiner (mirrors CLI behavior).

on_button_select_names_a()

Select names for Patch A using name_selector (mirrors CLI behavior).

on_button_select_names_b()

Select names for Patch B using name_selector (mirrors CLI behavior).

on_button_export_txt_a()

Export selected names to TXT file for Patch A.

on_button_export_txt_b()

Export selected names to TXT file for Patch B.

action_select_corpus_a()

Action: Open corpus selector for Patch A (keybinding: 1).

action_select_corpus_b()

Action: Open corpus selector for Patch B (keybinding: 2).

action_view_blended()

Action: Open blended walk modal screen (keybinding: v).

action_view_analysis()

Action: Open analysis modal screen (keybinding: a).

action_view_render()

Action: Open render screen for styled name display (keybinding: r).

action_view_package()

Action: Open package screen for bundling selections (keybinding: p).

action_view_database_a()

Action: Open database viewer for Patch A (keybinding: d).

action_view_database_b()

Action: Open database viewer for Patch B (keybinding: D).

action_help()

Show help information.

action_quit()

Quit the application.

on_int_spinner_changed(event)

Handle integer spinner value changes.

on_float_slider_changed(event)

Handle float slider value changes.

on_seed_changed(event)

Handle seed input changes.

on_select_changed(event)

Handle Select widget changes (e.g., name class dropdown).

on_profile_selected(event)

Handle profile option selection (radio button click).