androidx.compose.ui.tooling.data

@UiToolingDataApi
fun CompositionData.asTree(): Group

Return a group tree for for the slot table that represents the entire content of the slot table.

@UiToolingDataApi
fun CompositionGroup.findParameters(cache: ContextCache? = null): List<ParameterInformation>

Return the parameters found for this CompositionGroup.

@UiToolingDataApi
fun <T : Any?, R : Any?> Set<CompositionData>.makeTree(
    prepareResult: (CompositionInstance) -> Unit,
    createNode: (CompositionGroup, SourceContext, List<T>, List<R>) -> T?,
    createResult: (CompositionInstance, T?, List<CompositionInstance>) -> R?,
    cache: ContextCache = ContextCache()
): List<R>

Processes a set of CompositionData instances and constructs a list of trees of custom nodes.

This function builds a hierarchy from the provided compositions and then uses the mapTree to transform each root composition into a custom tree structure defined by the createNode. Results from mapTree that are null will be excluded from the final list.

The processing involves:

1. Building a lookup map from CompositionInstance to CompositionData.

2. Constructing a parent-to-children hierarchy of CompositionInstances.

3. Recursively traversing the hierarchy to map each composition using the provided createNode, potentially stitching children processed from sub-compositions.

@UiToolingDataApi
fun <T : Any?> CompositionData.mapTree(
    factory: (CompositionGroup, SourceContext, List<T>) -> T?,
    cache: ContextCache = ContextCache()
): T?

Return a tree of custom nodes for the slot table.

The factory method will be called for every CompositionGroup in the slot tree and can be used to create custom nodes based on the passed arguments. The SourceContext argument gives access to additional information encoded in the CompositionGroup.sourceInfo. A return of null from factory means that the entire subtree will be ignored.

A cache can optionally be specified. If a client is calling mapTree multiple times, this can save some time if the values of CompositionGroup.sourceInfo are not unique.

@UiToolingDataApi
val Group.position: String?

The source position of the group extracted from the key, if one exists for the group.