PhiaUiDesign.Mcp.BatchGet (phia_ui v0.1.17)

Pattern-based search and batch retrieval of nodes from the scene graph.

Supports searching by type, name (regex), component name, and specific node IDs. Results are returned with configurable depth for child expansion.

Summary

Execute a batch_get query against the scene.

@spec execute(reference(), map()) :: {:ok, [map()]}

Execute a batch_get query against the scene.

patterns — list of pattern maps: %{"type" => ..., "name" => ..., "component" => ...}
node_ids — list of specific node IDs to read
parent_id — scope search to a subtree
read_depth — how deep to expand match children (default 1; 0 = node only)
search_depth — how deep to search for matches (default unlimited)

Returns {:ok, results} where results is a list of serialized node maps.