SelectableListPrompt<T> class

SelectableListPrompt – composable system for list-based selection prompts.

Eliminates boilerplate by composing:

• ListNavigator for viewport navigation
• SelectionController for selection state
• KeyBindings for input handling
• FrameView for rendering
• PromptRunner for the interactive loop

Design principles:

• Composition over inheritance
• Separation of concerns (each component remains independent)
• Builder pattern for flexible configuration
• DRY: Centralizes common prompt/view patterns
• Backward compatible: Individual components still work standalone

Before SelectableListPrompt:

final nav = ListNavigator(itemCount: items.length, maxVisible: 10);
final selection = SelectionController.multi();
bool cancelled = false;

final bindings = KeyBindings.verticalNavigation(
  onUp: () => nav.moveUp(),
  onDown: () => nav.moveDown(),
) + KeyBindings.toggle(
  onToggle: () => selection.toggle(nav.selectedIndex),
) + KeyBindings.prompt(onCancel: () => cancelled = true);

final frame = FrameView(title: title, theme: theme, bindings: bindings);

void render(RenderOutput out) {
  frame.render(out, (ctx) {
    final window = nav.visibleWindow(items);
    ctx.listWindow(window, selectedIndex: nav.selectedIndex, ...);
  });
}

final runner = PromptRunner(hideCursor: true);
final result = runner.runWithBindings(render: render, bindings: bindings);

if (cancelled || result == PromptResult.cancelled) return [];
return selection.getSelectedMany(items, fallbackIndex: nav.selectedIndex);

After SelectableListPrompt:

final prompt = SelectableListPrompt(
  title: title,
  items: items,
  theme: theme,
  multiSelect: true,
);

final result = prompt.run(
  renderItem: (ctx, item, index, focused, selected) {
    ctx.checkboxItem(item, focused: focused, checked: selected);
  },
);

Advanced usage with custom content:

final prompt = SelectableListPrompt(
  title: title,
  items: items,
  theme: theme,
);

final result = prompt.runCustom(
  beforeItems: (ctx) => ctx.searchLine(query),
  renderItem: (ctx, item, index, focused, selected) { ... },
  afterItems: (ctx) => ctx.summaryLine(selection.count, items.length),
);