执行命令并返回 (returncode, stdout, stderr)

yieldMessages validates and appends messages to the final output list.

AddMsgType adds a message type if not already present.

AnalyzeTopology analyzes the component tree topology and returns reachable IDs.

Creates a result with BITMAP format.

collectA2UIMessages extracts all A2UI JSON messages from response parts.

collectText extracts all text from response parts.

Creates an error result. @param error Human-readable error message

deepCopyMap creates a deep copy of a map[string]any using recursive traversal.

Convert dp to px

Helper: extract the content inside calc(...)

Reads the default style config shipped for a component type.

Returns the singleton instance. @return ImageLoaderConfig singleton

Checks whether the Engine has been initialized @return true if the Engine is initialized

Helper: check if a string is a valid CSS color interpolation space

Creates a network error.

Returns the `styles` object from the snapshot JSON when present.

Parses a dimension value as a float (used for shadow offsets, etc.). Note: the px unit is converted following dp conversion rules.

parseJSON parses the payload and returns a list of A2UI JSON objects.

Helper: parse percentage value (e.g. "50%" -> 0.5)

Releases resources

Calculates the text area width left after subtracting fixed-width accessory UI.

* Set a custom shadow, matching CSS drop-shadow / box-shadow semantics. * NODE_CUSTOM_SHADOW parameters: * [0] blur - blur radius in px

Sets the day/night mode @param mode Mode value: "light" or "dark"

Synchronizes a component UI state change to the Native data model. <p> Custom components should call this when their UI state changes (e.g. text input

ValidateRecursionAndPaths validates recursion depth limits and path syntax.

Starts a layout transaction. Until {@link #endTransaction()} is called, incoming layout updates are buffered instead of being flushed immediately.

Builds a compact text-style JSON object that can be fed back into {@link TextMeasurer}.

findRootID finds the root ID from A2UI messages for a given surface.

Finds the first parseable dimension from a list of candidate keys.

Returns the component type @return Component type name (e.g. "Text", "Button", "Row")

Returns the container (internally created root view; always non-null). <p> Callers obtain the Surface's root view via this method and add it to their

Returns the number of registered component types @return Number of registered component types

* @brief Get the component snapshot * @return Snapshot pointer; nullptr if no snapshot exists */

Invalidate both cache levels. Called when the data that feeds frame extraction changes: children list swap, direction change, child property update (f

Returns whether this is a cancellation error. @return true if the task was cancelled

Load payloads from one markdown file or two JSON files.

Helper: parse alpha value - float (0.0-1.0) or percentage (0%-100% -> 0.0-1.0)

Replace surfaceId in JSON @param json Original JSON string @param newSurfaceId New surfaceId @return Replaced JSON string

Convert a single parsed edge value into a2ui-px. Only `px` (and unitless, which the C++ parser normalizes to px) is honored; every other CSS unit coll

Sets the checked state

Sets a custom logger delegate to receive log callbacks from the engine. This method should be called BEFORE initialize() to ensure all engine logs ar