LazyColumnTileSchema

Renders a Compose LazyColumn over tiles — one lazy item per child, keyed by the child's id — spaced by arrangement and aligned horizontally by alignment. Only visible children are composed, which makes this the tile to use for long or paginated lists.

Child scope: each item publishes its LazyItemScope as a CompositionLocal (and clears the column scope), so children can use lazy-item modifiers such as animateItem and fillParentMaxSize — but not ColumnScope.weight.

Filtering: when filterChildrenByTerm is non-null and non-empty, only children whose searchableTerms contain that term (case-insensitive, substring match) are rendered. Children without searchableTerms are filtered out.

Pagination: when scrollThreshold is set, the tile fires its threshold trigger as soon as fewer than or exactly scrollThreshold items remain past the last visible one. It fires at most once per item count, so it will not fire again until the list actually grows — considerLoadingItemAtEndOnThresholdReached (default true) additionally requires the list to have grown by more than one item, which accounts for a loading placeholder appended at the end while the next page is in flight.

Scroll control: the tile listens to the screen broadcast channel and reacts to scroll-to-top, scroll-to-bottom and scroll-to-item commands addressed to its id, each optionally animated. The scroll-to variant takes a child index.

Triggers dispatched:

• OnDisplayEventTrigger — fired once when the tile enters composition (keyed by tile id).

• OnClickEventTrigger — fired when the list itself is tapped, but only if an OnClick event is declared on this tile.

• OnScrolledEventTrigger — fired when the scroll direction changes, carrying ScrollDirection.Bottom when scrolling forward and ScrollDirection.Top when scrolling backward.

• OnScrollThresholdReachedEventTrigger — fired as described above; never fired when scrollThreshold is null.

Scrollbar: when displayScrollbar is true the tile draws a vertical scrollbar on its trailing edge. It defaults to false and is honoured on every platform — enable it where a pointer-driven scrollbar makes sense, typically desktop and web.