Rename TUI app files: drop 'demo', use 'app' suffix; rename tui_common to common

data_structures/tui/:
  stack_demo_tui.py  → stack_app.py
  queue_demo_tui.py  → queue_app.py
  deque_demo_tui.py  → deque_app.py
  list_demo_tui.py   → list_app.py
  singly_linked_list_tui.py  → singly_linked_list_app.py
  doubly_linked_list_tui.py  → doubly_linked_list_app.py
  tui_common.py      → common.py

Tests renamed to match; Makefile run-*-tui → run-*-app, test-*-tui → test-*-app.
Internal imports updated; docs and AGENTS.md paths updated.

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

Author: gkthiruvathukal

AGENTS.md

@@ -38,7 +38,7 @@ Several data structures have an interactive terminal UI built with [Textual](htt
 
 ### Base-class TUIs (`tui_common.py`)
 
-All other linear-structure TUIs inherit from `BaseLinearStructureTUI` in `data_structures/tui/tui_common.py`. The base class provides:
+All other linear-structure TUIs inherit from `BaseLinearStructureTUI` in `data_structures/tui/common.py`. The base class provides:
 
 - the Textual widget layout (`LinearPanel`, `RichLog`, `Input`, `Header`, `Footer`)
 - the shared command dispatcher (`_dispatch`) covering `/random`, `/clear`, `/save`, `/load`, `/undo`, `/redo`, `/show`, `/type`, scroll commands, and `/help`

Makefile

@@ -5,11 +5,11 @@ PYTEST  = .venv/bin/pytest
 RUN_ALIASES  = run-bst run-deque run-dict run-dll run-graph run-heap \
                run-list run-networkx run-queue run-set run-sll run-stack run-trie
 TEST_ALIASES = test-bst test-deque test-dict test-dll test-graph test-heap \
-               test-list test-networkx test-queue test-set test-sll test-stack test-stack-tui \
-               test-queue-tui test-deque-tui test-list-tui test-sll-tui test-dll-tui test-trie
+               test-list test-networkx test-queue test-set test-sll test-stack test-stack-app \
+               test-queue-app test-deque-app test-list-app test-sll-app test-dll-app test-trie
 
 .PHONY: install test $(RUN_ALIASES) $(TEST_ALIASES) \
-        run-stack-tui run-queue-tui run-deque-tui run-list-tui run-sll-tui run-dll-tui
+        run-stack-app run-queue-app run-deque-app run-list-app run-sll-app run-dll-app
 
 # Create the virtual environment
 .venv:
@@ -38,24 +38,24 @@ run-sll:     run-singly_linked_list
 run-stack:   run-stack_demo
 run-trie:    run-trie_demo
 
-# TUI run targets (data_structures.tui.*)
-run-stack-tui:
-	$(PYTHON) -m data_structures.tui.stack_demo_tui
+# App run targets (data_structures.tui.*)
+run-stack-app:
+	$(PYTHON) -m data_structures.tui.stack_app
 
-run-queue-tui:
-	$(PYTHON) -m data_structures.tui.queue_demo_tui
+run-queue-app:
+	$(PYTHON) -m data_structures.tui.queue_app
 
-run-deque-tui:
-	$(PYTHON) -m data_structures.tui.deque_demo_tui
+run-deque-app:
+	$(PYTHON) -m data_structures.tui.deque_app
 
-run-list-tui:
-	$(PYTHON) -m data_structures.tui.list_demo_tui
+run-list-app:
+	$(PYTHON) -m data_structures.tui.list_app
 
-run-sll-tui:
-	$(PYTHON) -m data_structures.tui.singly_linked_list_tui
+run-sll-app:
+	$(PYTHON) -m data_structures.tui.singly_linked_list_app
 
-run-dll-tui:
-	$(PYTHON) -m data_structures.tui.doubly_linked_list_tui
+run-dll-app:
+	$(PYTHON) -m data_structures.tui.doubly_linked_list_app
 
 # Test aliases
 test-bst:     test-binary_search_tree_demo
@@ -67,15 +67,15 @@ test-heap:    test-heap_demo
 test-list:    test-list_demo
 test-networkx: test-networkx_graph_demo
 test-queue:   test-queue_demo
-test-queue-tui: test-queue_demo_tui
+test-queue-app: test-queue_app
 test-set:     test-set_demo
 test-sll:     test-singly_linked_list
-test-sll-tui: test-singly_linked_list_tui
+test-sll-app: test-singly_linked_list_app
 test-stack:   test-stack_demo
-test-stack-tui: test-stack_demo_tui
-test-deque-tui: test-deque_demo_tui
-test-list-tui: test-list_demo_tui
-test-dll-tui: test-doubly_linked_list_tui
+test-stack-app: test-stack_app
+test-deque-app: test-deque_app
+test-list-app: test-list_app
+test-dll-app: test-doubly_linked_list_app
 test-trie:    test-trie_demo
 
 # Run a single non-TUI demo module:  make run-<name>
@@ -93,13 +93,13 @@ run-%:
 
 # Run a single test module:  make test-<name>
 #
-#   Valid names (same list as above, plus tui variants):
+#   Valid names (same list as above, plus app variants):
 #     binary_search_tree_demo   deque_demo         dictionary_demo
 #     doubly_linked_list        graph_demo         heap_demo
 #     list_demo                 networkx_graph_demo  queue_demo
-#     queue_demo_tui            deque_demo_tui     list_demo_tui
-#     singly_linked_list        singly_linked_list_tui
-#     doubly_linked_list_tui    set_demo           stack_demo
-#     stack_demo_tui            trie_demo
+#     queue_app                 deque_app          list_app
+#     singly_linked_list        singly_linked_list_app
+#     doubly_linked_list_app    set_demo           stack_demo
+#     stack_app                 trie_demo
 test-%:
 	$(PYTEST) tests/test_$*.py -v

README.md

@@ -34,7 +34,7 @@ The repo now includes interactive Textual TUIs for:
 - `singly_linked_list_tui`
 - `doubly_linked_list_tui`
 
-Use targets such as `make run-stack-tui`, `make run-queue-tui`, or `make run-dll-tui`. Other demo modules do not yet have a `__main__` block, so their `run-*` targets verify a clean import but produce no output.
+Use targets such as `make run-stack-app`, `make run-queue-app`, or `make run-dll-app`. Other demo modules do not yet have a `__main__` block, so their `run-*` targets verify a clean import but produce no output.
 
 For walkthroughs of the interactive apps, see:
 - `docs/StackTUI.md`
@@ -66,13 +66,13 @@ Valid `<name>` values (short alias or full name both work):
 | `list` | `list_demo` | `data_structures/list_demo.py` | `tests/test_list_demo.py` |
 | `networkx` | `networkx_graph_demo` | `data_structures/networkx_graph_demo.py` | `tests/test_networkx_graph_demo.py` |
 | `queue` | `queue_demo` | `data_structures/queue_demo.py` | `tests/test_queue_demo.py` |
-| `queue-tui` | `queue_demo_tui` | `data_structures/tui/queue_demo_tui.py` | `tests/test_queue_demo_tui.py` |
+| `queue-tui` | `queue_demo_tui` | `data_structures/tui/queue_app.py` | `tests/test_queue_demo_tui.py` |
 | `set` | `set_demo` | `data_structures/set_demo.py` | `tests/test_set_demo.py` |
 | `sll` | `singly_linked_list` | `data_structures/singly_linked_list.py` | `tests/test_singly_linked_list.py` |
-| `sll-tui` | `singly_linked_list_tui` | `data_structures/tui/singly_linked_list_tui.py` | `tests/test_singly_linked_list_tui.py` |
+| `sll-tui` | `singly_linked_list_tui` | `data_structures/tui/singly_linked_list_app.py` | `tests/test_singly_linked_list_tui.py` |
 | `stack` | `stack_demo` | `data_structures/stack_demo.py` | `tests/test_stack_demo.py` |
-| `stack-tui` | `stack_demo_tui` | `data_structures/tui/stack_demo_tui.py` | `tests/test_stack_demo_tui.py` |
-| `deque-tui` | `deque_demo_tui` | `data_structures/tui/deque_demo_tui.py` | `tests/test_deque_demo_tui.py` |
-| `list-tui` | `list_demo_tui` | `data_structures/tui/list_demo_tui.py` | `tests/test_list_demo_tui.py` |
-| `dll-tui` | `doubly_linked_list_tui` | `data_structures/tui/doubly_linked_list_tui.py` | `tests/test_doubly_linked_list_tui.py` |
+| `stack-tui` | `stack_demo_tui` | `data_structures/tui/stack_app.py` | `tests/test_stack_demo_tui.py` |
+| `deque-tui` | `deque_demo_tui` | `data_structures/tui/deque_app.py` | `tests/test_deque_demo_tui.py` |
+| `list-tui` | `list_demo_tui` | `data_structures/tui/list_app.py` | `tests/test_list_demo_tui.py` |
+| `dll-tui` | `doubly_linked_list_tui` | `data_structures/tui/doubly_linked_list_app.py` | `tests/test_doubly_linked_list_tui.py` |
 | `trie` | `trie_demo` | `data_structures/trie_demo.py` | `tests/test_trie_demo.py` |

data_structures/tui/tui_common.py data_structures/tui/common.pydata_structures/tui/tui_common.py renamed to data_structures/tui/common.py

@@ -4,7 +4,7 @@
 from textual.widgets import Footer, Header, Input, RichLog
 
 from data_structures.deque_demo import DequeDemo
-from .tui_common import (
+from .common import (
     BaseLinearStructureTUI,
     LinearPanel,
     build_linear_view,

data_structures/tui/deque_demo_tui.py data_structures/tui/deque_app.pydata_structures/tui/deque_demo_tui.py renamed to data_structures/tui/deque_app.py

@@ -4,7 +4,7 @@
 from textual.widgets import Footer, Header, Input, RichLog, Static
 
 from data_structures.doubly_linked_list import DoublyLinkedList
-from .tui_common import (
+from .common import (
     BaseLinearStructureTUI,
     build_linear_parser,
     format_display_value,

…structures/tui/doubly_linked_list_tui.py …structures/tui/doubly_linked_list_app.pydata_structures/tui/doubly_linked_list_tui.py renamed to data_structures/tui/doubly_linked_list_app.py data_structures/tui/doubly_linked_list_tui.py renamed to data_structures/tui/doubly_linked_list_app.py

@@ -3,7 +3,7 @@
 from textual.widgets import RichLog
 
 from data_structures.list_demo import ListDemo
-from .tui_common import (
+from .common import (
     BaseLinearStructureTUI,
     build_linear_parser,
     format_value_batch,

data_structures/tui/list_demo_tui.py data_structures/tui/list_app.pydata_structures/tui/list_demo_tui.py renamed to data_structures/tui/list_app.py

@@ -1,7 +1,7 @@
 from textual.widgets import RichLog
 
 from data_structures.queue_demo import QueueDemo
-from .tui_common import (
+from .common import (
     BaseLinearStructureTUI,
     build_linear_parser,
     format_value_batch,

data_structures/tui/queue_demo_tui.py data_structures/tui/queue_app.pydata_structures/tui/queue_demo_tui.py renamed to data_structures/tui/queue_app.py

@@ -4,7 +4,7 @@
 from textual.widgets import Footer, Header, Input, RichLog, Static
 
 from data_structures.singly_linked_list import SinglyLinkedList
-from .tui_common import (
+from .common import (
     BaseLinearStructureTUI,
     build_linear_parser,
     format_display_value,

…structures/tui/singly_linked_list_tui.py …structures/tui/singly_linked_list_app.pydata_structures/tui/singly_linked_list_tui.py renamed to data_structures/tui/singly_linked_list_app.py data_structures/tui/singly_linked_list_tui.py renamed to data_structures/tui/singly_linked_list_app.py

@@ -5,7 +5,7 @@
 from textual.app import ComposeResult
 from textual.widgets import Footer, Header, Input, RichLog, Static
 
-from .tui_common import (
+from .common import (
     BaseLinearStructureTUI,
     build_linear_parser,
     build_random_values,