@rafaelaugusto/jolt 0.1.0-beta.15 → 0.1.0-beta.17

package/README.md

@@ -31,7 +31,7 @@ NativeScript's `view.animate()` covers the basics and stops there: one curve for
 
 Jolt computes the motion once, in JavaScript, when the animation starts, and hands it to the platform as keyframes: Core Animation on iOS, `ObjectAnimator` on Android. Those default view tracks play without per-frame JavaScript. Real-size layout, opt-in subscribers, gesture input and timeline step activation retain their documented [execution limits](https://jolt.rafaelaugusto.dev/guide/how-it-works). Springs follow real physics, and an animation that interrupts another one starts from where the view is, at the speed it was going.
 
-The [beta.15 release](https://github.com/rafaelaugustos/jolt/releases/tag/v0.1.0-beta.15) adds real width/height/auto animation and SceneKit camera field of view. Install `@rafaelaugusto/jolt@0.1.0-beta.15`; for external native properties, also install matching `@rafaelaugusto/jolt-native@0.1.0-beta.15` and rebuild the native app.
+The [beta.17 release](https://github.com/rafaelaugustos/jolt/releases/tag/v0.1.0-beta.17) adds a bottom sheet with native scroll handoff, native list reordering, and SceneKit environment/shader inputs. The redesigned preview includes 55 examples, English/Portuguese and light/dark themes. Install `@rafaelaugusto/jolt@0.1.0-beta.17` and rebuild the native app. For external native properties, also install matching `@rafaelaugusto/jolt-native@0.1.0-beta.17`.
 
 ## Features
 
@@ -41,6 +41,11 @@ The [beta.15 release](https://github.com/rafaelaugustos/jolt/releases/tag/v0.1.0
 - [Motion paths](#motion-along-a-path) with optional tangent orientation on iOS and Android.
 - [Colors](#colors) for backgrounds, borders and text, interpolated in OKLab on iOS and Android.
 - [Motion values](#motion-values): one value driving several properties and views, mapped like `interpolate`.
+- [Live springs](https://jolt.rafaelaugusto.dev/guide/live-springs): retained native followers with position and velocity that continue through target changes.
+- [Native gestures](https://jolt.rafaelaugusto.dev/guide/gestures): simultaneous pan/pinch/rotation, tap arbitration, axis competition and vertical Core ScrollView handoff.
+- [Bottom sheet](https://jolt.rafaelaugusto.dev/guide/bottom-sheet): native drag/scroll handoff, content and percentage stops, keyboard following and dismissal.
+- [List reordering](https://jolt.rafaelaugusto.dev/guide/reorder): stable keys, native drag snapshots, neighbour springs and edge scrolling through recycled cells.
+- [SceneKit environment and shaders](https://jolt.rafaelaugusto.dev/guide/scene-shaders): native environment intensity and typed scalar/vector shader inputs on iOS.
 - [Layered motion](#layered-motion): several animations on one property, added or multiplied.
 - [Gradients](#gradients): native linear, radial and conic gradients with animated colors, angle, center and radius.
 - [Motion scopes and states](https://jolt.rafaelaugusto.dev/guide/motion-controllers) for component cleanup and coordinated visual states, with a transition per target.
@@ -674,7 +679,9 @@ Each running property remembers its curve and start time. On Android, interrupti
 
 ## Demo
 
-[`demo/`](./demo) opens an interactive assistant on iOS and Android: a fan of document tools, a voice screen with letter-by-letter text, and a staged conversation with document previews and a rolling countdown, with the screens cross-fading through the Vue entry. Open **Help → Watch demo** to replay the flow. The orb is an animated illustration; speech, documents and audio are sample data.
+[`demo/`](./demo) now opens **Jolt Motion Studio**: a branded animated splash, a moving home, and 55 searchable experiments with category filters and native page navigation through Vue Router NS. The iOS preview includes the Jolt name and icon; launching normally always opens the collection. See the [native walkthrough](./docs/guide/demo.md).
+
+The assistant remains available through `--screen=home` on iOS or `--es screen home` on Android: a fan of document tools, a voice screen with letter-by-letter text, and a staged conversation with document previews and a rolling countdown, with the screens cross-fading through the Vue entry. Open **Help → Watch demo** to replay the flow. The orb is an animated illustration; speech, documents and audio are sample data.
 
 |                                                                             Assistant                                                                              |                                                                      Presets                                                                       |                                                                                       Springs                                                                                       |                                                                        Stagger                                                                        |
 | :----------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------: |

package/dist/bottom-sheet/geometry.d.ts

@@ -0,0 +1,18 @@
+export type SheetSnap = number | `${number}%` | 'content';
+export interface SheetStop {
+    point: SheetSnap;
+    height: number;
+    y: number;
+}
+export interface SheetGeometry {
+    height: number;
+    closedY: number;
+    top: number;
+    stops: SheetStop[];
+}
+export declare function validateSnaps(points: readonly SheetSnap[]): void;
+/** Keyboard overlap is relative to the host, so adjustResize is not subtracted twice. */
+export declare function sheetGeometry(points: readonly SheetSnap[], hostHeight: number, hostBottom: number, windowHeight: number, keyboardHeight: number, safeTop: number, safeBottom: number, contentHeight: number): SheetGeometry;
+/** Projection selects a stop; the native spring retains the actual release velocity. */
+export declare function releaseStop(geometry: SheetGeometry, y: number, velocity: number, dismissible: boolean): SheetStop | undefined;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/bottom-sheet/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/bottom-sheet/geometry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,GAAG,MAAM,GAAG,GAAG,SAAS,CAAA;AAEzD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,SAAS,EAAE,CAAA;CACnB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,CAgBhE;AAED,yFAAyF;AACzF,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,aAAa,CAoBf;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CACzB,QAAQ,EAAE,aAAa,EACvB,CAAC,EAAE,MAAM,EACT,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,OAAO,GACnB,SAAS,GAAG,SAAS,CAYvB"}

package/dist/bottom-sheet/geometry.js

@@ -0,0 +1,51 @@
+export function validateSnaps(points) {
+    if (!Array.isArray(points) || !points.length)
+        throw new TypeError('bottomSheet() needs at least one snap point.');
+    for (const point of points) {
+        if (point === 'content')
+            continue;
+        if (typeof point === 'number' && Number.isFinite(point) && point > 0)
+            continue;
+        if (typeof point === 'string' && /^(?:\d+(?:\.\d+)?|\.\d+)%$/.test(point)) {
+            const percent = Number.parseFloat(point);
+            if (percent > 0 && percent <= 100)
+                continue;
+        }
+        throw new RangeError('Sheet snaps must be positive DIPs, 0–100% (exclusive of 0), or content.');
+    }
+    if (new Set(points).size !== points.length)
+        throw new RangeError('Sheet snap points must not repeat.');
+}
+/** Keyboard overlap is relative to the host, so adjustResize is not subtracted twice. */
+export function sheetGeometry(points, hostHeight, hostBottom, windowHeight, keyboardHeight, safeTop, safeBottom, contentHeight) {
+    const top = Math.max(0, safeTop);
+    const overlap = Math.max(0, Math.min(hostHeight, hostBottom - (windowHeight - keyboardHeight)));
+    const bottom = Math.max(Math.max(0, safeBottom), overlap);
+    const height = Math.max(1, hostHeight - top - bottom);
+    const closedY = Math.max(height, hostHeight - top);
+    const stops = points.map((point) => {
+        const desired = point === 'content'
+            ? contentHeight
+            : typeof point === 'number'
+                ? point
+                : (Number.parseFloat(point) / 100) * height;
+        const visible = Math.max(1, Math.min(height, desired));
+        return { point, height: visible, y: height - visible };
+    });
+    return { height, closedY, top, stops };
+}
+/** Projection selects a stop; the native spring retains the actual release velocity. */
+export function releaseStop(geometry, y, velocity, dismissible) {
+    const projected = y + Math.max(-4000, Math.min(4000, velocity)) * 0.2;
+    let distance = dismissible ? Math.abs(projected - geometry.closedY) : Infinity;
+    let result;
+    for (const stop of geometry.stops) {
+        const next = Math.abs(projected - stop.y);
+        if (next <= distance) {
+            distance = next;
+            result = stop;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=geometry.js.map

package/dist/bottom-sheet/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../../src/bottom-sheet/geometry.ts"],"names":[],"mappings":"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"}

package/dist/bottom-sheet/index.d.ts

@@ -0,0 +1,56 @@
+import { ScrollView, View } from '@nativescript/core';
+import { type SpringValueOptions } from '../motion-value.js';
+import { GestureSurface } from '../gestures/index.js';
+import { type SheetSnap } from './geometry.js';
+export { GestureSurface };
+export type { SheetSnap };
+export interface BottomSheetOptions {
+    /** A separate, focusable drag handle inside the panel; receives native accessibility actions. */
+    handle: View;
+    snap: readonly SheetSnap[];
+    /** A descendant vertical ScrollView. Native list plugins need their own integration. */
+    scrollView?: ScrollView;
+    /** Measured content for the content snap; defaults to scrollView.content. */
+    content?: View;
+    /** A sibling behind the panel, filling the same one-cell GridLayout. */
+    backdrop?: View;
+    backdropOpacity?: number;
+    /** Follow temporarily expands above the keyboard, then restores the selected snap. */
+    keyboard?: 'follow' | 'none';
+    /** Whether dragging, the backdrop, back and accessibility can dismiss. Defaults to true. */
+    dismissible?: boolean;
+    safeArea?: {
+        top?: number;
+        bottom?: number;
+    };
+    returnFocus?: View;
+    spring?: Pick<SpringValueOptions, 'stiffness' | 'damping' | 'mass'>;
+    accessibility?: {
+        label?: string;
+        expand?: string;
+        collapse?: string;
+        dismiss?: string;
+    };
+    onChange?: (point: SheetSnap | null) => void;
+    /** Called after a close settles; interrupted closes do not dismiss. */
+    onDismiss?: () => void;
+}
+export interface BottomSheet {
+    readonly isOpen: boolean;
+    readonly snapPoint: SheetSnap | null;
+    readonly visibleHeight: number;
+    readonly paused: boolean;
+    readonly disposed: boolean;
+    open(point?: SheetSnap): void;
+    snapTo(point: SheetSnap): void;
+    expand(): void;
+    collapse(): void;
+    dismiss(): void;
+    remeasure(): void;
+    pause(): void;
+    play(): void;
+    dispose(): void;
+}
+/** An in-page sheet, built from native gestures and live spring bindings. */
+export declare function bottomSheet(panel: GestureSurface, options: BottomSheetOptions): BottomSheet;
+//# sourceMappingURL=index.d.ts.map

package/dist/bottom-sheet/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bottom-sheet/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,UAAU,EAEV,IAAI,EAEL,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAQ,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,EAAE,cAAc,EAA2B,MAAM,sBAAsB,CAAA;AAE9E,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,eAAe,CAAA;AAStB,OAAO,EAAE,cAAc,EAAE,CAAA;AACzB,YAAY,EAAE,SAAS,EAAE,CAAA;AAEzB,MAAM,WAAW,kBAAkB;IACjC,iGAAiG;IACjG,MAAM,EAAE,IAAI,CAAA;IACZ,IAAI,EAAE,SAAS,SAAS,EAAE,CAAA;IAC1B,wFAAwF;IACxF,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,wEAAwE;IACxE,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;IAC5B,4FAA4F;IAC5F,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,MAAM,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC,CAAA;IACnE,aAAa,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACxF,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAA;IAC5C,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;IAC7B,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IAC9B,MAAM,IAAI,IAAI,CAAA;IACd,QAAQ,IAAI,IAAI,CAAA;IAChB,OAAO,IAAI,IAAI,CAAA;IACf,SAAS,IAAI,IAAI,CAAA;IACjB,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,IAAI,IAAI,CAAA;IACZ,OAAO,IAAI,IAAI,CAAA;CAChB;AAoBD,6EAA6E;AAC7E,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,kBAAkB,GAC1B,WAAW,CA2bb"}

package/dist/bottom-sheet/index.js

@@ -0,0 +1,462 @@
+import { Application, GridLayout, ScrollView, Trace, View, isAndroid, } from '@nativescript/core';
+import { bind } from '../motion-value.js';
+import { GestureSurface, gestures } from '../gestures/index.js';
+import { currentKeyboard, onKeyboard } from '../keyboard.js';
+import { releaseStop, sheetGeometry, validateSnaps, } from './geometry.js';
+import { captureFocus, dismissKeyboard, revealFocusedField, sheetActions, windowHeight, } from './native.js';
+export { GestureSurface };
+const owners = new WeakMap();
+const descendant = (child, parent) => {
+    for (let current = child.parent; current; current = current.parent)
+        if (current === parent)
+            return true;
+    return false;
+};
+const report = (callback) => {
+    try {
+        callback?.();
+    }
+    catch (error) {
+        Trace.write(`Jolt bottom sheet callback failed: ${String(error)}`, Trace.categories.Error, Trace.messageType.error);
+    }
+};
+/** An in-page sheet, built from native gestures and live spring bindings. */
+export function bottomSheet(panel, options) {
+    if (!(panel instanceof GestureSurface) || !(panel.parent instanceof GridLayout))
+        throw new TypeError('bottomSheet() needs a GestureSurface inside an overlay GridLayout.');
+    if (!options || typeof options !== 'object')
+        throw new TypeError('Sheet options are required.');
+    validateSnaps(options.snap);
+    const points = [...options.snap], host = panel.parent;
+    if (!(options.handle instanceof View) || !descendant(options.handle, panel))
+        throw new TypeError('Provide a separate accessibility handle inside the sheet.');
+    const handle = options.handle, scroll = options.scrollView;
+    if (scroll &&
+        (!(scroll instanceof ScrollView) ||
+            scroll.orientation !== 'vertical' ||
+            !descendant(scroll, panel)))
+        throw new TypeError('Sheet scrolling needs a descendant vertical ScrollView.');
+    const content = options.content ?? scroll?.content;
+    if (content && (!(content instanceof View) || !descendant(content, panel)))
+        throw new TypeError('Sheet content must be a descendant of its panel.');
+    if (points.includes('content') && !content)
+        throw new TypeError('A content snap needs scrollView.content or an explicit content view.');
+    const backdrop = options.backdrop;
+    if (backdrop &&
+        (!(backdrop instanceof View) || backdrop.parent !== host || backdrop === panel))
+        throw new TypeError('The backdrop must be a sibling behind the sheet.');
+    const opacity = options.backdropOpacity ?? 0.45;
+    if (!Number.isFinite(opacity) || opacity < 0 || opacity > 1)
+        throw new RangeError('Backdrop opacity must be between zero and one.');
+    if (options.keyboard !== undefined && !['follow', 'none'].includes(options.keyboard))
+        throw new TypeError('Sheet keyboard behavior must be follow or none.');
+    for (const inset of Object.values(options.safeArea ?? {}))
+        if (!Number.isFinite(inset) || inset < 0)
+            throw new RangeError('Safe-area insets must be finite and nonnegative.');
+    if (options.dismissible !== undefined && typeof options.dismissible !== 'boolean')
+        throw new TypeError('dismissible must be boolean.');
+    for (const callback of [options.onChange, options.onDismiss])
+        if (callback !== undefined && typeof callback !== 'function')
+            throw new TypeError('Sheet callbacks must be functions.');
+    owners.get(panel)?.dispose();
+    const original = {
+        contentAlignment: content?.verticalAlignment,
+        height: panel.height,
+        marginTop: panel.marginTop,
+        marginBottom: panel.marginBottom,
+        alignment: panel.verticalAlignment,
+        visibility: panel.visibility,
+        y: panel.translateY,
+        clipping: host.clipToBounds,
+        backdropOpacity: backdrop?.opacity,
+        backdropVisibility: backdrop?.visibility,
+        accessible: handle.accessible,
+        label: handle.accessibilityLabel,
+        value: handle.accessibilityValue,
+    };
+    let geometry, input;
+    let opened = false, point = points[0], ended = false, held = false, changing = false, pendingDismiss = false, contactSettled = false, focusCaptured = false;
+    let keyboard = currentKeyboard(), timer;
+    let releasePanel = () => { }, releaseBackdrop = () => { }, releaseActions = () => { }, releaseKeyboard = () => { };
+    let releaseClose = () => { }, restoreFocus = () => { };
+    const dismissible = options.dismissible !== false;
+    const followKeyboard = options.keyboard !== 'none';
+    const keyboardOpen = () => followKeyboard && keyboard.visible;
+    const targetY = () => !opened
+        ? geometry.closedY
+        : keyboardOpen()
+            ? 0
+            : geometry.stops.find((stop) => stop.point === point).y;
+    const minimum = () => keyboardOpen() ? 0 : Math.min(...geometry.stops.map((stop) => stop.y));
+    function finishClose() {
+        releaseClose();
+        releaseClose = () => { };
+        if (ended || opened)
+            return;
+        panel.visibility = 'hidden';
+        if (backdrop)
+            backdrop.visibility = 'hidden';
+        input?.pause();
+        if (pendingDismiss) {
+            pendingDismiss = false;
+            const restore = restoreFocus;
+            restoreFocus = () => { };
+            focusCaptured = false;
+            restore();
+            report(options.onDismiss);
+        }
+    }
+    function move() {
+        if (!input || !geometry || held || ended)
+            return;
+        changing = true;
+        try {
+            input.updateBounds({
+                top: minimum(),
+                bottom: !opened || dismissible
+                    ? geometry.closedY
+                    : Math.max(...geometry.stops.map((stop) => stop.y)),
+            });
+            input.settleTo({ y: targetY() });
+        }
+        finally {
+            changing = false;
+        }
+        if (!opened) {
+            releaseClose();
+            const check = () => {
+                if (!opened &&
+                    geometry &&
+                    input &&
+                    Math.abs(input.y.get() - geometry.closedY) < 0.01)
+                    finishClose();
+            };
+            releaseClose = input.y.subscribe(check, { immediate: false });
+            check();
+        }
+    }
+    function setTarget(next) {
+        if (ended)
+            return;
+        if (next !== null && !points.includes(next))
+            throw new RangeError('Choose one of the configured sheet snap points.');
+        const wasOpen = opened, changed = (next !== null) !== opened || (next !== null && next !== point);
+        releaseClose();
+        releaseClose = () => { };
+        if (next !== null) {
+            if (!opened && !pendingDismiss && panel.isLoaded) {
+                restoreFocus = captureFocus(panel, options.returnFocus);
+                focusCaptured = true;
+            }
+            opened = true;
+            pendingDismiss = false;
+            point = next;
+            panel.visibility = 'visible';
+            if (backdrop)
+                backdrop.visibility = 'visible';
+            if (!held)
+                input?.play();
+        }
+        else {
+            opened = false;
+            pendingDismiss ||= wasOpen;
+            dismissKeyboard(panel);
+        }
+        handle.accessibilityValue = opened ? String(point) : 'Closed';
+        move();
+        if (changed)
+            report(() => options.onChange?.(next));
+    }
+    function adjacent(expand) {
+        if (ended)
+            return;
+        if (!opened) {
+            if (expand)
+                setTarget(point);
+            return;
+        }
+        if (!geometry)
+            return;
+        const current = geometry.stops.find((stop) => stop.point === point);
+        const candidates = geometry.stops
+            .filter((stop) => expand
+            ? stop.height > current.height + 0.01
+            : stop.height < current.height - 0.01)
+            .sort((a, b) => (expand ? a.height - b.height : b.height - a.height));
+        if (candidates[0])
+            setTarget(candidates[0].point);
+        else if (!expand && dismissible)
+            setTarget(null);
+    }
+    function remeasure() {
+        if (ended || !panel.isLoaded || !handle.isLoaded || (scroll && !scroll.isLoaded))
+            return;
+        const size = host.getActualSize();
+        if (!(size.height > 0))
+            return;
+        const safe = host.getSafeAreaInsets();
+        const top = options.safeArea?.top ?? safe.top;
+        const bottom = options.safeArea?.bottom ?? safe.bottom;
+        const chrome = scroll
+            ? Math.max(0, panel.getActualSize().height - scroll.getActualSize().height)
+            : 0;
+        const contentHeight = (content?.getActualSize().height ?? 0) + chrome;
+        const next = sheetGeometry(points, size.height, (host.getLocationInWindow()?.y ?? 0) + size.height, windowHeight(host), followKeyboard ? keyboard.height : 0, top, bottom, contentHeight);
+        const previous = geometry;
+        geometry = next;
+        const panelHeight = keyboardOpen()
+            ? next.height
+            : Math.max(...next.stops.map((stop) => stop.height));
+        if (panel.height !== panelHeight)
+            panel.height = panelHeight;
+        if (panel.marginTop !== next.top)
+            panel.marginTop = next.top;
+        if (!input) {
+            input = gestures(panel, {
+                pan: { axis: 'y', bounds: { top: minimum(), bottom: next.closedY } },
+                initial: { y: next.closedY },
+                scrollView: scroll,
+                spring: options.spring,
+                onContactStart() {
+                    const wasOpen = opened;
+                    contactSettled = false;
+                    releaseClose();
+                    releaseClose = () => { };
+                    opened = true;
+                    pendingDismiss = false;
+                    handle.accessibilityValue = String(point);
+                    if (!wasOpen)
+                        report(() => options.onChange?.(point));
+                },
+                onContactEnd(event) {
+                    if (contactSettled || changing || held || ended || !geometry)
+                        return;
+                    const stop = releaseStop(geometry, event.y, 0, dismissible);
+                    setTarget(stop?.point ?? null);
+                },
+                onStart() {
+                    releaseClose();
+                    releaseClose = () => { };
+                    opened = true;
+                    pendingDismiss = false;
+                },
+                onEnd(event) {
+                    contactSettled = true;
+                    if (!geometry)
+                        return;
+                    const stop = releaseStop(geometry, event.y, event.velocityY, dismissible);
+                    setTarget(stop?.point ?? null);
+                },
+                onCancel() {
+                    contactSettled = true;
+                    if (!changing && !held && !ended)
+                        move();
+                },
+            });
+            releasePanel = bind(panel, { y: input.y });
+            if (held || !opened)
+                input.pause();
+        }
+        if (!previous ||
+            previous.closedY !== next.closedY ||
+            previous.height !== next.height ||
+            previous.stops.some((stop, i) => stop.y !== next.stops[i].y)) {
+            releaseBackdrop();
+            releaseBackdrop = backdrop
+                ? bind(backdrop, { opacity: input.y.to([minimum(), next.closedY], [opacity, 0]) })
+                : () => { };
+            if (!input.active)
+                move();
+            else
+                input.updateBounds({
+                    top: minimum(),
+                    bottom: dismissible
+                        ? next.closedY
+                        : Math.max(...next.stops.map((stop) => stop.y)),
+                });
+        }
+        if (opened && keyboardOpen())
+            revealFocusedField(panel, scroll);
+    }
+    function queueMeasure() {
+        if (ended || timer !== undefined)
+            return;
+        timer = setTimeout(() => {
+            timer = undefined;
+            remeasure();
+        }, 0);
+    }
+    function back(event) {
+        if (opened && panel.isLoaded && dismissible) {
+            event.cancel = true;
+            setTarget(null);
+        }
+    }
+    function backdropTap() {
+        if (opened && dismissible)
+            setTarget(null);
+    }
+    function attach() {
+        if (ended || !panel.isLoaded || !handle.isLoaded || (scroll && !scroll.isLoaded))
+            return;
+        if (opened) {
+            panel.visibility = 'visible';
+            if (backdrop)
+                backdrop.visibility = 'visible';
+        }
+        if (opened && !focusCaptured) {
+            restoreFocus = captureFocus(panel, options.returnFocus);
+            focusCaptured = true;
+        }
+        releaseActions();
+        const labels = options.accessibility;
+        releaseActions = sheetActions(handle, [
+            { label: labels?.expand ?? 'Expand', run: () => adjacent(true) },
+            { label: labels?.collapse ?? 'Collapse', run: () => adjacent(false) },
+            ...(dismissible
+                ? [{ label: labels?.dismiss ?? 'Dismiss', run: () => setTarget(null) }]
+                : []),
+        ]);
+        releaseKeyboard();
+        releaseKeyboard = onKeyboard((state) => {
+            keyboard = state;
+            remeasure();
+            if (opened)
+                move();
+            queueMeasure();
+        });
+        keyboard = currentKeyboard();
+        remeasure();
+        queueMeasure();
+    }
+    function detach() {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        timer = undefined;
+        releaseClose();
+        releaseClose = () => { };
+        if (backdrop)
+            backdrop.visibility = 'hidden';
+        releaseActions();
+        releaseActions = () => { };
+        releaseKeyboard();
+        releaseKeyboard = () => { };
+        releasePanel();
+        releasePanel = () => { };
+        releaseBackdrop();
+        releaseBackdrop = () => { };
+        changing = true;
+        input?.dispose();
+        input = undefined;
+        geometry = undefined;
+        changing = false;
+    }
+    const control = {
+        get isOpen() {
+            return opened;
+        },
+        get snapPoint() {
+            return opened ? point : null;
+        },
+        get visibleHeight() {
+            return geometry && input
+                ? Math.max(0, Math.min(geometry.height, geometry.height - input.y.get()))
+                : 0;
+        },
+        get paused() {
+            return held;
+        },
+        get disposed() {
+            return ended;
+        },
+        open: (next = point) => setTarget(next),
+        snapTo: (next) => setTarget(next),
+        expand: () => adjacent(true),
+        collapse: () => adjacent(false),
+        dismiss: () => setTarget(null),
+        remeasure,
+        pause() {
+            held = true;
+            input?.pause();
+        },
+        play() {
+            if (ended)
+                return;
+            held = false;
+            input?.play();
+            move();
+        },
+        dispose() {
+            if (ended)
+                return;
+            ended = true;
+            detach();
+            for (const view of [panel, handle, ...(scroll ? [scroll] : [])])
+                view.off('loaded', attach);
+            panel.off('unloaded', detach);
+            for (const view of new Set([
+                host,
+                panel,
+                ...(content ? [content] : []),
+                ...(scroll ? [scroll] : []),
+            ]))
+                view.off('layoutChanged', queueMeasure);
+            backdrop?.off('tap', backdropTap);
+            if (isAndroid)
+                Application.android.off(Application.android.activityBackPressedEvent, back);
+            if (content)
+                content.verticalAlignment = original.contentAlignment;
+            panel.height = original.height;
+            panel.marginTop = original.marginTop;
+            panel.marginBottom = original.marginBottom;
+            panel.verticalAlignment = original.alignment;
+            panel.visibility = original.visibility;
+            panel.translateY = original.y;
+            host.clipToBounds = original.clipping;
+            handle.accessible = original.accessible;
+            handle.accessibilityLabel = original.label;
+            handle.accessibilityValue = original.value;
+            if (backdrop) {
+                backdrop.opacity = original.backdropOpacity;
+                backdrop.visibility = original.backdropVisibility;
+            }
+            if (owners.get(panel) === control)
+                owners.delete(panel);
+        },
+    };
+    owners.set(panel, control);
+    if (content && points.includes('content'))
+        content.verticalAlignment = 'top';
+    panel.verticalAlignment = 'top';
+    panel.marginBottom = 0;
+    panel.visibility = 'hidden';
+    host.clipToBounds = true;
+    handle.accessible = true;
+    handle.accessibilityLabel =
+        options.accessibility?.label ?? (handle.accessibilityLabel || 'Bottom sheet');
+    handle.accessibilityValue = 'Closed';
+    if (backdrop)
+        backdrop.visibility = 'hidden';
+    for (const view of [panel, handle, ...(scroll ? [scroll] : [])])
+        view.on('loaded', attach);
+    panel.on('unloaded', detach);
+    for (const view of new Set([
+        host,
+        panel,
+        ...(content ? [content] : []),
+        ...(scroll ? [scroll] : []),
+    ]))
+        view.on('layoutChanged', queueMeasure);
+    backdrop?.on('tap', backdropTap);
+    if (isAndroid)
+        Application.android.on(Application.android.activityBackPressedEvent, back);
+    try {
+        attach();
+    }
+    catch (error) {
+        control.dispose();
+        throw error;
+    }
+    return control;
+}
+//# sourceMappingURL=index.js.map