yera.runtime.blocks.tree_selector

Emit a correlated request for selections from a nested tree.

Nested mappings become explicit branch and leaf nodes while leaf values remain the canonical submitted values. The request carries selection limits and an optional cancellation action, and its block identity correlates the response with the waiting app.

Symbols

def request_input_tree_selector — Request selections from the leaves of a nested tree.

request_input_tree_selector

request_input_tree_selector(
    tree: Mapping[str, object],
    label: str | None = None,
    min_selections: int = 1,
    max_selections: int | None = None,
    cancel_label: str | None = None,
) → str

Request selections from the leaves of a nested tree.

Parameters

tree
type: Mapping[str, object]

Normalized nested branches and canonical leaf values.

label
type: str | None = None

Optional prompt shown above the tree.

min_selections
type: int = 1

Minimum number of leaves that must be selected.

max_selections
type: int | None = None

Optional maximum number of leaves that may be selected.

cancel_label
type: str | None = None

Optional label for an action that cancels the request.

Returns

type: str

Block ID identifying the input request.