@octane-xplat/ui 0.9.0 → 0.10.0

package/dist/native/VirtualList.tsrx.js

@@ -5,7 +5,7 @@ import { VirtualListSizeIndex, createVirtualListEntries, estimateVirtualListSize
 import { VirtualListCellPool } from "./virtual-list-cell-pool.js";
 import { defineUniversalComponent, hookSlots, universalFor, universalPlan, universalProps, universalValue, useEffect, useMemo, useRef, useState } from "@nativescript-community/octane";
 //#region src/VirtualList.tsrx
-var _hs$ = /* @__PURE__ */ hookSlots(32);
+var _hs$ = /* @__PURE__ */ hookSlots(35);
 var _h$0 = /* @__PURE__ */ Symbol(_hs$);
 var _h$1 = /* @__PURE__ */ Symbol(_hs$ + 1);
 var _h$2 = /* @__PURE__ */ Symbol(_hs$ + 2);
@@ -38,6 +38,9 @@ var _h$28 = /* @__PURE__ */ Symbol(_hs$ + 28);
 var _h$29 = /* @__PURE__ */ Symbol(_hs$ + 29);
 var _h$30 = /* @__PURE__ */ Symbol(_hs$ + 30);
 var _h$31 = /* @__PURE__ */ Symbol(_hs$ + 31);
+var _h$32 = /* @__PURE__ */ Symbol(_hs$ + 32);
+var _h$33 = /* @__PURE__ */ Symbol(_hs$ + 33);
+var _h$34 = /* @__PURE__ */ Symbol(_hs$ + 34);
 var __octaneUniversalPlan0 = universalPlan("nativescript", {
 	"kind": "host",
 	"type": "flexboxlayout",
@@ -46,7 +49,7 @@ var __octaneUniversalPlan0 = universalPlan("nativescript", {
 		"className": "vx-virtual-list-header",
 		"flexShrink": 0
 	},
-	"bindings": [["onLayoutChanged", 0]],
+	"bindings": [["ref", 0]],
 	"children": [{
 		"kind": "slot",
 		"slot": 1
@@ -106,12 +109,11 @@ var __octaneUniversalPlan4 = universalPlan("nativescript", {
 		["className", 1],
 		["visibility", 2],
 		["top", 3],
-		["width", 4],
-		["onLayoutChanged", 5]
+		["width", 4]
 	],
 	"children": [{
 		"kind": "slot",
-		"slot": 6
+		"slot": 5
 	}]
 });
 var __octaneUniversalPlan5 = universalPlan("nativescript", {
@@ -145,7 +147,7 @@ var __octaneUniversalPlan7 = universalPlan("nativescript", {
 		"kind": "host",
 		"type": "flexboxlayout",
 		"props": { "flexDirection": "column" },
-		"bindings": [["className", 1], ["onLayoutChanged", 2]],
+		"bindings": [["className", 1], ["ref", 2]],
 		"children": [
 			{
 				"kind": "slot",
@@ -199,37 +201,40 @@ var VirtualList = defineUniversalComponent("nativescript", function VirtualList(
 	const sizeIndexRef = useRef(new VirtualListSizeIndex(), _h$2);
 	const cellsRef = useRef(new VirtualListCellPool(), _h$3);
 	const cellNodesRef = useRef(/* @__PURE__ */ new Map(), _h$4);
-	const cellCallbacksRef = useRef(/* @__PURE__ */ new Map(), _h$5);
-	const measuredAssignmentsRef = useRef(/* @__PURE__ */ new Map(), _h$6);
-	const sizeCacheRef = useRef(/* @__PURE__ */ new Map(), _h$7);
-	const typeSamplesRef = useRef(/* @__PURE__ */ new Map(), _h$8);
-	const appliedEstimatesRef = useRef(/* @__PURE__ */ new Map(), _h$9);
-	const estimateDirtyTypesRef = useRef(/* @__PURE__ */ new Set(), _h$10);
-	const entriesRef = useRef([], _h$11);
-	const indexByRowKeyRef = useRef(/* @__PURE__ */ new Map(), _h$12);
-	const scrollRef = useRef(null, _h$13);
-	const scrollOffsetRef = useRef(0, _h$14);
-	const viewportHeightRef = useRef(0, _h$15);
-	const viewportWidthRef = useRef(0, _h$16);
-	const contentWidthRef = useRef(0, _h$17);
-	const headerHeightRef = useRef(0, _h$18);
-	const estimateTimerRef = useRef(null, _h$19);
-	const frameCancelRef = useRef(null, _h$20);
-	const disposedRef = useRef(false, _h$21);
-	const pendingOffsetDeltaRef = useRef(0, _h$22);
-	const measurementsRef = useRef(/* @__PURE__ */ new Map(), _h$23);
+	const layoutListenersRef = useRef(/* @__PURE__ */ new Map(), _h$5);
+	const cellCallbacksRef = useRef(/* @__PURE__ */ new Map(), _h$6);
+	const measuredAssignmentsRef = useRef(/* @__PURE__ */ new Map(), _h$7);
+	const sizeCacheRef = useRef(/* @__PURE__ */ new Map(), _h$8);
+	const typeSamplesRef = useRef(/* @__PURE__ */ new Map(), _h$9);
+	const appliedEstimatesRef = useRef(/* @__PURE__ */ new Map(), _h$10);
+	const estimateDirtyTypesRef = useRef(/* @__PURE__ */ new Set(), _h$11);
+	const entriesRef = useRef([], _h$12);
+	const indexByRowKeyRef = useRef(/* @__PURE__ */ new Map(), _h$13);
+	const scrollRef = useRef(null, _h$14);
+	const scrollOffsetRef = useRef(0, _h$15);
+	const viewportHeightRef = useRef(0, _h$16);
+	const viewportWidthRef = useRef(0, _h$17);
+	const contentWidthRef = useRef(0, _h$18);
+	const headerHeightRef = useRef(0, _h$19);
+	const estimateTimerRef = useRef(null, _h$20);
+	const frameCancelRef = useRef(null, _h$21);
+	const viewportFrameCancelRef = useRef(null, _h$22);
+	const disposedRef = useRef(false, _h$23);
+	const pendingOffsetDeltaRef = useRef(0, _h$24);
+	const measurementsRef = useRef(/* @__PURE__ */ new Map(), _h$25);
 	const rangeRef = useRef({
 		start: -1,
 		end: -1,
 		top: -1,
 		bottom: -1
-	}, _h$24);
-	const pendingAnchorRef = useRef(null, _h$25);
-	const pendingAnchorRowsRef = useRef(/* @__PURE__ */ new Set(), _h$26);
-	const anchorRestoreScheduledRef = useRef(false, _h$27);
-	const anchorRestoreTimerRef = useRef(null, _h$28);
+	}, _h$26);
+	const geometryDirtyRef = useRef(false, _h$27);
+	const pendingAnchorRef = useRef(null, _h$28);
+	const pendingAnchorRowsRef = useRef(/* @__PURE__ */ new Set(), _h$29);
+	const anchorRestoreScheduledRef = useRef(false, _h$30);
+	const anchorRestoreTimerRef = useRef(null, _h$31);
 	const hasSeparator = Boolean(props.renderSeparator);
-	const hasSeparatorRef = useRef(hasSeparator, _h$29);
+	const hasSeparatorRef = useRef(hasSeparator, _h$32);
 	const separatorChanged = hasSeparatorRef.current !== hasSeparator;
 	hasSeparatorRef.current = hasSeparator;
 	function rebuildLayout(nextEntries, width) {
@@ -279,8 +284,9 @@ var VirtualList = defineUniversalComponent("nativescript", function VirtualList(
 	function commitWindow() {
 		const next = currentRange();
 		const previous = rangeRef.current;
-		if (next.start !== previous.start || next.end !== previous.end || !sameSize(next.top, previous.top) || !sameSize(next.bottom, previous.bottom)) {
+		if (geometryDirtyRef.current || next.start !== previous.start || next.end !== previous.end || !sameSize(next.top, previous.top) || !sameSize(next.bottom, previous.bottom)) {
 			rangeRef.current = next;
+			geometryDirtyRef.current = false;
 			setWindowVersion((version) => version + 1);
 		}
 	}
@@ -404,6 +410,7 @@ var VirtualList = defineUniversalComponent("nativescript", function VirtualList(
 		const estimateChanged = sample.count >= 4 && Math.abs(sample.sum / sample.count - applied) > Math.max(1, applied * .02);
 		const delta = sizeIndexRef.current.set(index, height);
 		if (Math.abs(delta) >= .5) {
+			geometryDirtyRef.current = true;
 			const anchorIndex = anchor ? indexByRowKeyRef.current.get(anchor.rowKey) : void 0;
 			if (anchor && anchorIndex !== void 0 && index < anchorIndex) restoreAnchor(anchor);
 		}
@@ -423,7 +430,7 @@ var VirtualList = defineUniversalComponent("nativescript", function VirtualList(
 		}
 	}
 	function syncViewport(view = scrollRef.current) {
-		if (!view) return;
+		if (!view || view.isLoaded === false || view.isLayoutValid === false) return;
 		const size = view.getActualSize?.();
 		if (!size) return;
 		const initialViewport = viewportHeightRef.current <= 0;
@@ -438,6 +445,13 @@ var VirtualList = defineUniversalComponent("nativescript", function VirtualList(
 		if (initialViewport) commitWindow();
 		else refreshWindow();
 	}
+	function scheduleViewport() {
+		if (disposedRef.current || viewportFrameCancelRef.current) return;
+		viewportFrameCancelRef.current = scheduleListFrame(() => {
+			viewportFrameCancelRef.current = null;
+			if (!disposedRef.current) syncViewport();
+		});
+	}
 	function onScroll(event) {
 		const view = event.object ?? scrollRef.current;
 		const nextOffset = Number(view?.verticalOffset ?? 0);
@@ -467,14 +481,26 @@ var VirtualList = defineUniversalComponent("nativescript", function VirtualList(
 		restoreAnchor(anchor);
 		refreshWindow();
 	}
+	function observeLayout(slot, view, listener) {
+		layoutListenersRef.current.get(slot)?.();
+		layoutListenersRef.current.delete(slot);
+		if (!view) return;
+		view.on?.("layoutChanged", listener);
+		layoutListenersRef.current.set(slot, () => view.off?.("layoutChanged", listener));
+	}
 	function cellCallback(id) {
 		let callback = cellCallbacksRef.current.get(id);
 		if (!callback) {
 			callback = (view) => {
 				if (view) {
+					observeLayout("cell:" + id, view, (event) => {
+						const cell = cellsRef.current.get(id);
+						if (cell) onRowLayout(cell, event);
+					});
 					view.reusable = true;
 					cellNodesRef.current.set(id, view);
 				} else {
+					observeLayout("cell:" + id, null, () => {});
 					cellNodesRef.current.get(id)?.destroyNode?.(true);
 					cellNodesRef.current.delete(id);
 					cellCallbacksRef.current.delete(id);
@@ -493,7 +519,8 @@ var VirtualList = defineUniversalComponent("nativescript", function VirtualList(
 			width: size.width,
 			height: size.height,
 			cellId: cell.id,
-			generation: cell.generation
+			generation: cell.generation,
+			view: event.object
 		});
 		refreshWindow();
 	}
@@ -502,17 +529,21 @@ var VirtualList = defineUniversalComponent("nativescript", function VirtualList(
 		return () => {
 			disposedRef.current = true;
 			frameCancelRef.current?.();
+			viewportFrameCancelRef.current?.();
+			viewportFrameCancelRef.current = null;
 			if (estimateTimerRef.current != null) clearTimeout(estimateTimerRef.current);
 			frameCancelRef.current = null;
 			estimateTimerRef.current = null;
 			measurementsRef.current.clear();
+			for (const detach of layoutListenersRef.current.values()) detach();
+			layoutListenersRef.current.clear();
 			cellsRef.current.clear();
 			cellNodesRef.current.clear();
 			cellCallbacksRef.current.clear();
 			measuredAssignmentsRef.current.clear();
 			cancelAnchorRestore();
 		};
-	}, [], _h$30);
+	}, [], _h$33);
 	const range = currentRange();
 	rangeRef.current = range;
 	const cells = cellsRef.current.update(entries.slice(range.start, range.end)).map((cell) => ({
@@ -537,7 +568,7 @@ var VirtualList = defineUniversalComponent("nativescript", function VirtualList(
 			refreshWindow();
 		}
 		for (const id of measuredAssignmentsRef.current.keys()) if (!cellNodesRef.current.has(id)) measuredAssignmentsRef.current.delete(id);
-	}, [cells], _h$31);
+	}, [cells], _h$34);
 	const style = {
 		...props.style,
 		minHeight: props.style?.minHeight ?? 0
@@ -549,6 +580,8 @@ var VirtualList = defineUniversalComponent("nativescript", function VirtualList(
 				"ref",
 				(view) => {
 					scrollRef.current = view;
+					observeLayout("viewport", view, scheduleViewport);
+					if (view) scheduleViewport();
 					if (view) applyEscapeProps(view, props);
 				}
 			],
@@ -611,12 +644,7 @@ var VirtualList = defineUniversalComponent("nativescript", function VirtualList(
 			[
 				"set",
 				"onLoaded",
-				(event) => syncViewport(event.object)
-			],
-			[
-				"set",
-				"onLayoutChanged",
-				(event) => syncViewport(event.object)
+				scheduleViewport
 			],
 			[
 				"set",
@@ -625,8 +653,8 @@ var VirtualList = defineUniversalComponent("nativescript", function VirtualList(
 			]
 		]),
 		cx("vx-virtual-list-content"),
-		onContentLayout,
-		props.renderHeader ? universalValue(__octaneUniversalPlan0, [onHeaderLayout, props.renderHeader()]) : null,
+		(view) => observeLayout("content", view, onContentLayout),
+		props.renderHeader ? universalValue(__octaneUniversalPlan0, [(view) => observeLayout("header", view, onHeaderLayout), props.renderHeader()]) : null,
 		entries.length === 0 ? props.renderEmpty ? universalValue(__octaneUniversalPlan1, [props.renderEmpty()]) : null : universalValue(__octaneUniversalPlan5, [{
 			height: contentHeight,
 			flexShrink: 0
@@ -637,7 +665,6 @@ var VirtualList = defineUniversalComponent("nativescript", function VirtualList(
 				cell.entry ? "visible" : "collapse",
 				cell.top,
 				contentWidthRef.current || viewportWidthRef.current || "100%",
-				(event) => onRowLayout(cell, event),
 				universalFor(cell.rows, (entry, __octaneUniversalIndex$) => entry.rowKey, (entry, __octaneUniversalIndex$) => {
 					return universalValue(__octaneUniversalPlan3, [props.renderItem(entry.item, entry.index), hasSeparator && entry.index < entries.length - 1 ? universalValue(__octaneUniversalPlan2, [props.renderSeparator?.()]) : null]);
 				})

package/dist/native/VisuallyHidden.tsrx.js

@@ -0,0 +1,49 @@
+import { refList } from "./ref-list.js";
+import { applyEscapeProps } from "./escape-props.js";
+import { defineUniversalComponent, hookSlots, universalPlan, universalValue, useMemo } from "@nativescript-community/octane";
+//#region src/VisuallyHidden.tsrx
+var _h$0 = /* @__PURE__ */ Symbol(/* @__PURE__ */ hookSlots(1));
+var __octaneUniversalPlan0 = universalPlan("nativescript", {
+	"kind": "host",
+	"type": "flexboxlayout",
+	"props": { "className": "vx-visually-hidden" },
+	"bindings": [
+		["id", 0],
+		["ref", 1],
+		["accessible", 2],
+		["accessibilityLabel", 3],
+		["accessibilityRole", 4],
+		["accessibilityHint", 5],
+		["accessibilityValue", 6],
+		["accessibilityState", 7],
+		["accessibilityLiveRegion", 8]
+	],
+	"children": [{
+		"kind": "slot",
+		"slot": 9
+	}]
+});
+var VisuallyHidden = defineUniversalComponent("nativescript", function VisuallyHidden(props) {
+	const forwardedRef = useMemo(() => refList((v) => {
+		if (v) applyEscapeProps(v, props);
+	}, props.ref), [
+		props.ref,
+		props.ios,
+		props.android,
+		props.web
+	], _h$0);
+	return universalValue(__octaneUniversalPlan0, [
+		props.id,
+		forwardedRef,
+		props.accessible,
+		props.accessibilityLabel,
+		props.accessibilityRole,
+		props.accessibilityHint,
+		props.accessibilityValue,
+		props.accessibilityState,
+		props.accessibilityLiveRegion,
+		props.children
+	]);
+}, { "module": "@nativescript-community/octane" });
+//#endregion
+export { VisuallyHidden };

package/dist/native/WebView.tsrx.js

@@ -1,13 +1,14 @@
 import { cx } from "./cx.js";
 import { applyEscapeProps, nativeAccessibilityRole, nativeAccessibilityState } from "./escape-props.js";
 import { layoutChildProps } from "./layout-child.js";
-import { defineUniversalComponent, hookSlots, universalPlan, universalProps, universalValue, useEffect, useRef } from "@nativescript-community/octane";
+import { defineUniversalComponent, hookSlots, universalPlan, universalProps, universalValue, useEffect, useImperativeHandle, useRef } from "@nativescript-community/octane";
 import { isAndroid, isIOS } from "@nativescript/core";
 //#region src/WebView.tsrx
-var _hs$ = /* @__PURE__ */ hookSlots(3);
+var _hs$ = /* @__PURE__ */ hookSlots(4);
 var _h$0 = /* @__PURE__ */ Symbol(_hs$);
 var _h$1 = /* @__PURE__ */ Symbol(_hs$ + 1);
 var _h$2 = /* @__PURE__ */ Symbol(_hs$ + 2);
+var _h$3 = /* @__PURE__ */ Symbol(_hs$ + 3);
 var __octaneUniversalPlan0 = universalPlan("nativescript", {
 	"kind": "host",
 	"type": "webview",
@@ -50,6 +51,13 @@ var WebView = defineUniversalComponent("nativescript", function WebView(props) {
 		applyNativeScrollEnabled(v, props.scrollEnabled);
 		if (props.matchContents && loaded.current) reportContentLayout(v, props);
 	}, [props.scrollEnabled, props.matchContents], _h$2);
+	useImperativeHandle(props.ref, () => ({
+		reload: () => el.current.reload(),
+		goBack: () => el.current.goBack(),
+		goForward: () => el.current.goForward(),
+		stopLoading: () => el.current.stopLoading(),
+		native: el.current
+	}), [], _h$3);
 	return universalValue(__octaneUniversalPlan0, [universalProps([
 		[
 			"set",
@@ -58,13 +66,6 @@ var WebView = defineUniversalComponent("nativescript", function WebView(props) {
 				el.current = v;
 				if (!v) return;
 				applyEscapeProps(v, props);
-				props.bind?.({
-					reload: () => v.reload(),
-					goBack: () => v.goBack(),
-					goForward: () => v.goForward(),
-					stopLoading: () => v.stopLoading(),
-					native: v
-				});
 			}
 		],
 		[

package/dist/native/aliases.tsrx.js

@@ -5,34 +5,25 @@ var __octaneUniversalPlan0 = universalPlan("nativescript", {
 	"kind": "slot",
 	"slot": 0
 });
-var __octaneUniversalPlan1 = universalPlan("nativescript", {
-	"kind": "slot",
-	"slot": 0
-});
-var __octaneUniversalPlan2 = universalPlan("nativescript", {
-	"kind": "slot",
-	"slot": 0
-});
 var SelectMenu = defineUniversalComponent("nativescript", function SelectMenu(props) {
-	return universalValue(__octaneUniversalPlan0, [universalComponent("nativescript", Select, universalProps([["spread", props], [
-		"set",
-		"multiple",
-		true
-	]]))]);
-}, { "module": "@nativescript-community/octane" });
-var Combobox = defineUniversalComponent("nativescript", function Combobox(props) {
-	return universalValue(__octaneUniversalPlan1, [universalComponent("nativescript", Select, universalProps([["spread", props], [
-		"set",
-		"searchable",
-		true
-	]]))]);
-}, { "module": "@nativescript-community/octane" });
-var InputMenu = defineUniversalComponent("nativescript", function InputMenu(props) {
-	return universalValue(__octaneUniversalPlan2, [universalComponent("nativescript", Select, universalProps([["spread", props], [
-		"set",
-		"searchable",
-		true
-	]]))]);
+	return universalValue(__octaneUniversalPlan0, [universalComponent("nativescript", Select, universalProps([
+		["spread", props],
+		[
+			"set",
+			"multiple",
+			true
+		],
+		[
+			"set",
+			"onValueChange",
+			(value) => props.onValueChange?.(Array.isArray(value) ? value : [])
+		],
+		[
+			"set",
+			"changeAction",
+			props.changeAction ? (value) => props.changeAction?.(Array.isArray(value) ? value : []) : void 0
+		]
+	]))]);
 }, { "module": "@nativescript-community/octane" });
 //#endregion
-export { Combobox, InputMenu, SelectMenu };
+export { SelectMenu };

package/dist/native/android/BottomNavigationView.android.tsrx.js

@@ -5,9 +5,9 @@ import "../Pressable.tsrx.js";
 import { getIcon } from "../icons.js";
 import "../Icon.tsrx.js";
 import { registerStack } from "../stacks.js";
-import { RouteHost, screenParamsFor } from "../RouteHost.mobile.tsrx.js";
-import "../route-host.mobile.js";
-import { layoutsForRoute, screenFor, useRoute } from "../route.js";
+import { RouteHost, screenParamsFor } from "../RouteHost.tsrx.js";
+import "../route-host.js";
+import { errorBoundaryFor, layoutsForRoute, screenFor, useRoute } from "../route.js";
 import { createNativeScriptRoot, defineUniversalComponent, hookSlots, markWarm, memo, universalComponent, universalIf, universalPlan, universalProps, universalValue, useBatch, warmChild, withSlot } from "@nativescript-community/octane";
 import { Frame, GridLayout, Page, TabViewItem } from "@nativescript/core";
 //#region src/android/BottomNavigationView.android.tsrx
@@ -64,6 +64,16 @@ var TabPane = defineUniversalComponent("nativescript", function TabPane(props) {
 				"set",
 				"params",
 				screenParamsFor(route)
+			],
+			[
+				"set",
+				"boundary",
+				errorBoundaryFor(route.name)
+			],
+			[
+				"set",
+				"route",
+				route
 			]
 		]))]);
 	}, () => {

package/dist/native/android/MaterialDialog.android.tsrx.js

@@ -1,5 +1,5 @@
 import { applyThemeClasses } from "../theme/theme-scheme.js";
-import { modalPresenter } from "../modal-presenter.mobile.js";
+import { modalPresenter } from "../modal-presenter.js";
 import { createNativeScriptRoot, defineUniversalComponent, hookSlots, universalPlan, universalValue, useEffect, useRef } from "@nativescript-community/octane";
 import { Frame, GridLayout } from "@nativescript/core";
 //#region src/android/MaterialDialog.android.tsrx

package/dist/native/android/RecyclerView.android.tsrx.js

@@ -2,10 +2,13 @@ import { cx } from "../cx.js";
 import { applyEscapeProps } from "../escape-props.js";
 import { ActivityIndicator } from "../ActivityIndicator.tsrx.js";
 import { createPullToRefresh } from "../refresh.js";
-import { defineUniversalComponent, hookSlots, memo, universalComponent, universalIf, universalPlan, universalProps, universalValue, useEffect, useRef } from "@nativescript-community/octane";
+import { createListViewabilityTracker } from "../list-viewability-core.js";
+import { createInitialListScrollRestorer, scrollListToIndex } from "../list-viewability-runtime.js";
+import { observeListViewability } from "../list-viewability-observer.android.js";
+import { defineUniversalComponent, hookSlots, memo, universalComponent, universalIf, universalPlan, universalProps, universalValue, useCallback, useEffect, useImperativeHandle, useRef } from "@nativescript-community/octane";
 import { ScrollView } from "@nativescript/core";
 //#region src/android/RecyclerView.android.tsrx
-var _hs$ = /* @__PURE__ */ hookSlots(7);
+var _hs$ = /* @__PURE__ */ hookSlots(16);
 var _h$0 = /* @__PURE__ */ Symbol(_hs$);
 var _h$1 = /* @__PURE__ */ Symbol(_hs$ + 1);
 var _h$2 = /* @__PURE__ */ Symbol(_hs$ + 2);
@@ -13,6 +16,15 @@ var _h$3 = /* @__PURE__ */ Symbol(_hs$ + 3);
 var _h$4 = /* @__PURE__ */ Symbol(_hs$ + 4);
 var _h$5 = /* @__PURE__ */ Symbol(_hs$ + 5);
 var _h$6 = /* @__PURE__ */ Symbol(_hs$ + 6);
+var _h$7 = /* @__PURE__ */ Symbol(_hs$ + 7);
+var _h$8 = /* @__PURE__ */ Symbol(_hs$ + 8);
+var _h$9 = /* @__PURE__ */ Symbol(_hs$ + 9);
+var _h$10 = /* @__PURE__ */ Symbol(_hs$ + 10);
+var _h$11 = /* @__PURE__ */ Symbol(_hs$ + 11);
+var _h$12 = /* @__PURE__ */ Symbol(_hs$ + 12);
+var _h$13 = /* @__PURE__ */ Symbol(_hs$ + 13);
+var _h$14 = /* @__PURE__ */ Symbol(_hs$ + 14);
+var _h$15 = /* @__PURE__ */ Symbol(_hs$ + 15);
 var __octaneUniversalPlan0 = universalPlan("nativescript", {
 	"kind": "host",
 	"type": "gridlayout",
@@ -73,12 +85,37 @@ var __octaneUniversalPlan6 = universalPlan("nativescript", {
 function rejectNestedScrollView(event) {
 	let parent = event.object?.parent;
 	while (parent) {
-		if (parent instanceof ScrollView) throw new Error("[RecyclerView] cannot be nested inside native ScrollView. Use ScrollBox so the list owns scrolling.");
+		if (parent instanceof ScrollView) throw new Error("[RecyclerView] cannot be nested inside native ScrollView. Use ScrollableArea axis=\"both\" so the list owns scrolling.");
 		parent = parent.parent;
 	}
 }
 var RecyclerViewInner = defineUniversalComponent("nativescript", function RecyclerViewInner(props) {
 	const lv = useRef(null, _h$0);
+	const renderCell = useCallback((item, index) => universalValue(__octaneUniversalPlan0, [props.renderItem(item, index)]), [props.renderItem], _h$1);
+	const visibility = useRef(null, _h$2);
+	const tracker = useRef(createListViewabilityTracker(), _h$3);
+	const initialScroll = useRef(createInitialListScrollRestorer(), _h$4);
+	const tryInitialScroll = () => initialScroll.current.tryScroll(props.runtime.list.current, props.initialScrollIndex, props.items.length);
+	useEffect(() => {
+		const list = props.runtime.list.current;
+		if (!list) return;
+		visibility.current = observeListViewability(list, () => ({
+			items: props.runtime.items.current,
+			config: props.runtime.config.current,
+			update: (rows, items, config) => tracker.current.update(rows, items, config, props.runtime.onChange.current)
+		}), () => tracker.current.reset());
+		return () => {
+			visibility.current?.dispose();
+			visibility.current = null;
+			tracker.current.dispose();
+		};
+	}, [], _h$5);
+	useEffect(() => {
+		visibility.current?.refresh();
+	}, [props.items, props.viewabilityConfig], _h$6);
+	useEffect(() => {
+		tryInitialScroll();
+	}, [props.initialScrollIndex, props.items.length], _h$7);
 	useEffect(() => {
 		const bag = props.refresh;
 		if (!bag || !lv.current) return;
@@ -92,14 +129,16 @@ var RecyclerViewInner = defineUniversalComponent("nativescript", function Recycl
 			bag.ctl.current?.detach();
 			bag.ctl.current = null;
 		};
-	}, [], _h$1);
+	}, [], _h$8);
 	return universalValue(__octaneUniversalPlan1, [universalProps([
 		[
 			"set",
 			"ref",
 			(v) => {
 				lv.current = v;
+				props.runtime.list.current = v;
 				applyEscapeProps(v, props);
+				if (v) tryInitialScroll();
 			}
 		],
 		[
@@ -130,35 +169,48 @@ var RecyclerViewInner = defineUniversalComponent("nativescript", function Recycl
 		[
 			"set",
 			"onLoaded",
-			rejectNestedScrollView
+			(event) => {
+				rejectNestedScrollView(event);
+				tryInitialScroll();
+			}
 		],
 		[
 			"set",
 			"renderItem",
-			(item, index) => universalValue(__octaneUniversalPlan0, [props.renderItem(item, index)])
+			renderCell
 		],
 		["spread", props.android]
 	])]);
 }, { "module": "@nativescript-community/octane" });
-var MemoListView = memo(RecyclerViewInner, (a, b) => a.items === b.items && a.className === b.className && a.style === b.style && a.id === b.id && a.onEndReached === b.onEndReached && a.android === b.android && a.modifiers === b.modifiers && a.refresh === b.refresh);
+var MemoListView = memo(RecyclerViewInner, (a, b) => a.items === b.items && a.initialScrollIndex === b.initialScrollIndex && a.viewabilityConfig?.itemVisiblePercentThreshold === b.viewabilityConfig?.itemVisiblePercentThreshold && a.viewabilityConfig?.minimumViewTime === b.viewabilityConfig?.minimumViewTime && a.runtime === b.runtime && a.className === b.className && a.style === b.style && a.id === b.id && a.onEndReached === b.onEndReached && a.android === b.android && a.modifiers === b.modifiers && a.refresh === b.refresh);
 var RecyclerView = defineUniversalComponent("nativescript", function RecyclerView(props) {
+	const runtime = useRef({
+		list: { current: null },
+		items: { current: props.items },
+		config: { current: props.viewabilityConfig },
+		onChange: { current: props.onViewableItemsChanged }
+	}, _h$9);
+	runtime.current.items.current = props.items;
+	runtime.current.config.current = props.viewabilityConfig;
+	runtime.current.onChange.current = props.onViewableItemsChanged;
+	useImperativeHandle(props.ref, () => ({ scrollToIndex: (index, options) => scrollListToIndex(runtime.current.list.current, index, runtime.current.items.current.length, options?.animated) }), [props.ref], _h$10);
 	const refreshCapable = props.onRefresh != null || props.refreshing != null;
-	const cfg = useRef({}, _h$2);
+	const cfg = useRef({}, _h$11);
 	cfg.current = {
 		onRefresh: props.onRefresh,
 		refreshing: props.refreshing,
 		threshold: props.refreshThreshold
 	};
-	const indicator = useRef(null, _h$3);
-	const ctl = useRef(null, _h$4);
+	const indicator = useRef(null, _h$12);
+	const ctl = useRef(null, _h$13);
 	const refresh = useRef({
 		cfg,
 		indicator,
 		ctl
-	}, _h$5);
+	}, _h$14);
 	useEffect(() => {
 		ctl.current?.sync();
-	}, [props.refreshing], _h$6);
+	}, [props.refreshing], _h$15);
 	return universalValue(__octaneUniversalPlan6, [universalIf(props.items.length > 0, () => {
 		return universalValue(__octaneUniversalPlan4, [universalIf(refreshCapable, () => {
 			return universalValue(__octaneUniversalPlan2, [
@@ -199,6 +251,21 @@ var RecyclerView = defineUniversalComponent("nativescript", function RecyclerVie
 						"set",
 						"refresh",
 						refresh.current
+					],
+					[
+						"set",
+						"initialScrollIndex",
+						props.initialScrollIndex
+					],
+					[
+						"set",
+						"viewabilityConfig",
+						props.viewabilityConfig
+					],
+					[
+						"set",
+						"runtime",
+						runtime.current
 					]
 				])),
 				(v) => {
@@ -249,6 +316,21 @@ var RecyclerView = defineUniversalComponent("nativescript", function RecyclerVie
 					"set",
 					"modifiers",
 					props.modifiers
+				],
+				[
+					"set",
+					"initialScrollIndex",
+					props.initialScrollIndex
+				],
+				[
+					"set",
+					"viewabilityConfig",
+					props.viewabilityConfig
+				],
+				[
+					"set",
+					"runtime",
+					runtime.current
 				]
 			]))]);
 		})]);

package/dist/native/android/openModal.android.js

@@ -1,5 +1,5 @@
 import { applyThemeClasses } from "../theme/theme-scheme.js";
-import { modalPresenter } from "../modal-presenter.mobile.js";
+import { modalPresenter } from "../modal-presenter.js";
 import { createNativeScriptRoot } from "@nativescript-community/octane";
 import { Frame, GridLayout } from "@nativescript/core";
 //#region src/android/openModal.android.ts