SwingShellSuggestionTarget
Host-owned request and presentation lifecycle for optional automatic suggestions.
Calls run on the EDT. The target owns source collection and presentation; the supplied interaction owns selection, admission, and feedback. The terminal owns focus, eligibility, debounce, invalidation, and session termination. Capture occurs before target work begins. Native popups obtain component-local anchors through io.github.ketraterm.ui.swing.api.SwingTerminal.copyCellBounds. Target exceptions propagate to the calling operation or component observation scope. Changing the target or disposing the view never disposes host-owned target resources.
Functions
Cancels source work and hides the surface; must tolerate repeated calls. The terminal closes active interactions. Hiding during acceptance must not close its captured editing capability or report preference feedback.
Replaces automatic work for interaction; cancel and close any previous request first.