`simvx.core.ui.autocomplete`¶

Autocomplete popup widget for code completion suggestions.

Module Contents¶

Classes¶

AutocompletePopup

Floating completion popup that shows filtered suggestions near the cursor.

Data¶

`log`
`MAX_VISIBLE`
`ITEM_HEIGHT`
`POPUP_WIDTH`
`KIND_COL_WIDTH`
`SCROLLBAR_WIDTH`
`TEXT_SCALE`
`PADDING_X`
`PADDING_Y`
`BORDER`

API¶

simvx.core.ui.autocomplete.log¶: ‘getLogger(…)’

simvx.core.ui.autocomplete.MAX_VISIBLE¶: 10

simvx.core.ui.autocomplete.ITEM_HEIGHT¶: 22.0

simvx.core.ui.autocomplete.POPUP_WIDTH¶: 350.0

simvx.core.ui.autocomplete.KIND_COL_WIDTH¶: 36.0

simvx.core.ui.autocomplete.SCROLLBAR_WIDTH¶: 8.0

simvx.core.ui.autocomplete.TEXT_SCALE¶: 0.55

simvx.core.ui.autocomplete.PADDING_X¶: 6.0

simvx.core.ui.autocomplete.PADDING_Y¶: 2.0

simvx.core.ui.autocomplete.BORDER¶: 1.0

class simvx.core.ui.autocomplete.AutocompletePopup(**kwargs)[source]¶

Bases: simvx.core.ui.core.Control

Floating completion popup that shows filtered suggestions near the cursor.

Non-capturing overlay (modality="none"): the popup draws on top via the overlay layer but does NOT scope input, so the host editor keeps keyboard focus and keeps receiving typed characters while the popup is up. Consumers forward navigation keys (Up/Down/Tab/Enter/Esc/PageUp/PageDown/Home/End) to

Meth:: forward_key while typed characters keep flowing to the editor for live filter updates. Matches every IDE in the wild (VS Code, JetBrains, Sublime, Emacs corfu).

Initialization

property is_visible: bool[source]¶

show(items: list[simvx.core.ui.completion_types.CompletionItem], x: float, y: float)[source]¶

hide()[source]¶

update_filter(text: str)[source]¶

NAV_KEYS¶: ‘frozenset(…)’

forward_key(event: simvx.core.ui.core.UIInputEvent) → bool[source]¶

Consumer-side hook: forward a navigation key to the popup.

Returns True if the popup consumed the key (caller should suppress its own handling). Mark the event handled by setting event.handled.

Editors call this before processing typed characters in their own _on_gui_input::

def _on_gui_input(self, event):
    if self._autocomplete.is_visible and self._autocomplete.forward_key(event):
        return
    # ... usual editor key handling ...

is_point_inside(point) → bool[source]¶

on_draw(renderer)[source]¶

size_x¶: ‘Property(…)’

size_y¶: ‘Property(…)’

anchor_left¶: ‘Property(…)’

anchor_top¶: ‘Property(…)’

anchor_right¶: ‘Property(…)’

anchor_bottom¶: ‘Property(…)’

margin_left¶: ‘Property(…)’

margin_top¶: ‘Property(…)’

margin_right¶: ‘Property(…)’

margin_bottom¶: ‘Property(…)’

dismiss_on_outside_click¶: ‘Property(…)’

property size: simvx.core.math.types.Vec2¶

touch_mode: str¶: ‘mouse’

property theme: simvx.core.ui.types.Theme | None¶

property mouse_over: bool¶

property focused: bool¶

property disabled: bool¶

get_theme() → simvx.core.ui.types.Theme¶

queue_redraw()¶

get_minimum_size() → simvx.core.math.types.Vec2¶

get_rect() → tuple[float, float, float, float]¶

get_global_rect() → tuple[float, float, float, float]¶

place_bottom_strip(height: float) → None¶

place_top_strip(height: float) → None¶

set_anchor_preset(preset: simvx.core.ui.enums.AnchorPreset)¶

set_focus()¶

grab_focus()¶

release_focus()¶

has_focus() → bool¶

focus_next_control()¶

focus_previous_control()¶

grab_mouse()¶

release_mouse()¶

set_drag_preview(control: simvx.core.ui.core.Control)¶

property is_overlay_open: bool¶

show_overlay(modality: str = 'light', *, dim: bool | None = None, dismiss: bool | None = None, inert: bool | None = None, owner: simvx.core.ui.core.Control | None = None, initial_focus: simvx.core.ui.core.Control | None = None) → None¶