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
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,
) → strRequest 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.