KSLCore/ksl.utilities.editor/SelectionState

SelectionState

Observable single + multi selection model used by the editor's master pane (scenario workflow §6) and any other list-or-table surface that wants standard click semantics:

Click → select — replaces the selection with the clicked item; sets the anchor for future range extends.
⌘ / Ctrl-click → toggle — adds or removes the item; resets the anchor.
Shift-click → extend — selects the range between the current anchor and the target within the provided ordered list. When no anchor is set, falls back to select.

Generic in T: any equatable selection-element type works. Scenarios identify rows by name or by ScenarioId; bundle-ref panels identify rows by bundleId.

Survives data mutations through pruneRemoved: when the underlying list drops items, the editor passes the removed set to drop them from the selection in one shot.

Constructors

SelectionState

constructor()

Properties

anchor

val anchor: T?

The most recently anchored item, or null when the selection was cleared.

selection

val selection: StateFlow<List<T>>

Observable selection, in the order items were added.

Functions

clear

fun clear()

Empties the selection and clears the anchor.

extend

fun extend(target: T, orderedItems: List<T>)

Selects the contiguous range between the current anchor and target within orderedItems. When no anchor is set or either endpoint isn't in the ordered list, falls back to select. The anchor stays put so subsequent shift-clicks re-extend from the same starting point.

isSelected

fun isSelected(item: T): Boolean

Whether item is currently selected.

pruneRemoved

fun pruneRemoved(removed: Collection<T>)

Drops every entry in removed from the selection in one shot. When the anchor is among the removed items, falls back to the most recent surviving selection (or null if the selection emptied). Called by editors when their underlying list mutates.

select

fun select(item: T)

Replaces the selection with just item and sets the anchor. Standard click semantics.

set

fun set(items: List<T>)

Replaces the selection wholesale. The anchor is set to the last item in items, or null when items is empty.

toggle

fun toggle(item: T)

Toggles whether item is selected and resets the anchor to item (or to null if the item was deselected to empty). Standard ⌘ / Ctrl-click semantics.