Widgets, State, Configuration, Security, and Distribution

Use this skill when a TUI needs product-level interaction patterns, robust application state, secure terminal handling, user customization, or shipping guidance.

Widget design principles

• Every widget has state, focus rules, keyboard behavior, mouse behavior if supported, validation, accessibility fallback, and snapshot tests.
• Keep interactions predictable: lists navigate, tables sort/filter/page, forms validate near fields, dialogs trap focus, command palettes search commands, and scrollbars indicate position without being required.
• Virtualize large lists/tables/trees and keep viewport offset, selection, and expanded nodes in state.
• For charts, progress bars, spinners, and dashboards, provide textual summaries and reduced-motion/no-animation modes.

State and event architecture

Prefer an explicit model-update-view or reducer architecture: