@rafaelaugusto/jolt 0.1.0-beta.8 → 0.1.0-rc.1

package/dist/interactive-navigation/index.d.ts

@@ -0,0 +1,44 @@
+import { type Frame, type NavigationTransition } from '@nativescript/core';
+import { type SharedReturnTarget } from '../shared-navigation/return-target.js';
+import { springs, type Spring } from '../transition.js';
+export type InteractiveNavigationState = 'ready' | 'animating' | 'idle' | 'dragging' | 'finishing' | 'cancelling' | 'disposed';
+export interface InteractiveNavigationEvent {
+    state: InteractiveNavigationState;
+    outcome?: 'completed' | 'cancelled';
+    shared?: {
+        status: 'ready' | 'unavailable';
+        reason?: string;
+    };
+    /** Present on finishing/cancelling. Velocity is page widths per second. */
+    release?: Readonly<{
+        progress: number;
+        velocity: number;
+    }>;
+}
+export interface InteractiveNavigationOptions {
+    /** Optional stable image/card identity in the two pages. Unsupported pairs use normal page motion. */
+    shared?: {
+        tag: string;
+        maxSnapshotPixels?: number;
+        returnTarget?: SharedReturnTarget;
+    };
+    /** Same physics as Jolt's live springs. Default smooth; settling is bounded at 3 s. */
+    spring?: keyof typeof springs | Pick<Spring, 'duration' | 'bounce' | 'stiffness' | 'damping' | 'mass'>;
+    /** Synchronous extra gate. Page.enableSwipeBackNavigation is always respected. */
+    canBegin?: () => boolean;
+    /** Lifecycle only. Finger updates and spring playback stay in Objective-C. */
+    onState?: (event: InteractiveNavigationEvent) => void;
+}
+export interface InteractiveNavigation {
+    readonly supported: boolean;
+    /** Use for ONE pushed Frame entry. Pass to Frame.navigate or router.push. */
+    readonly transition: NavigationTransition | undefined;
+    readonly state: InteractiveNavigationState;
+    /** Rolls back a held drag. A release already committed to UIKit finishes normally. */
+    cancel(): void;
+    /** Detaches the gesture; future programmatic back uses UIKit's default transition. */
+    dispose(): void;
+}
+/** Interactive iOS page navigation using Core's existing UINavigationController delegate. */
+export declare function interactiveNavigation(frame: Frame, options?: InteractiveNavigationOptions): InteractiveNavigation;
+//# sourceMappingURL=index.d.ts.map

package/dist/interactive-navigation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interactive-navigation/index.ts"],"names":[],"mappings":"AACA,OAAO,EAQL,KAAK,KAAK,EACV,KAAK,oBAAoB,EAG1B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,uCAAuC,CAAA;AAI9C,OAAO,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEvD,MAAM,MAAM,0BAA0B,GACpC,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,CAAA;AACvF,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,0BAA0B,CAAA;IACjC,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,CAAA;IACnC,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,OAAO,GAAG,aAAa,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7D,2EAA2E;IAC3E,OAAO,CAAC,EAAE,QAAQ,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC3D;AACD,MAAM,WAAW,4BAA4B;IAC3C,sGAAsG;IACtG,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,kBAAkB,CAAA;KAAE,CAAA;IACvF,uFAAuF;IACvF,MAAM,CAAC,EACH,MAAM,OAAO,OAAO,GACpB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC,CAAA;IAC1E,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAA;IACxB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,CAAA;CACtD;AACD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,oBAAoB,GAAG,SAAS,CAAA;IACrD,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAA;IAC1C,sFAAsF;IACtF,MAAM,IAAI,IAAI,CAAA;IACd,sFAAsF;IACtF,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,6FAA6F;AAC7F,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,4BAAiC,GACzC,qBAAqB,CAgVvB"}

package/dist/interactive-navigation/index.js

@@ -0,0 +1,314 @@
+import { ReturnScope } from '../shared-navigation/return-signal.js';
+import { Application, Image, isIOS, SharedTransition, Transition, Trace, } from '@nativescript/core';
+import { resolveReturnTarget, validateReturnTarget, focusReturnTarget, } from '../shared-navigation/return-target.js';
+import { find, radius, supportedImage } from '../shared-navigation/targets.js';
+import { onReducedMotion, reducedMotion, timeScale } from '../config.js';
+import { springPhysics } from '../spring.js';
+import { springs } from '../transition.js';
+/** Interactive iOS page navigation using Core's existing UINavigationController delegate. */
+export function interactiveNavigation(frame, options = {}) {
+    if (options.shared &&
+        (typeof options.shared.tag !== 'string' || !options.shared.tag.trim()))
+        throw new TypeError('A nonempty sharedTransitionTag is required.');
+    validateReturnTarget(options.shared?.returnTarget);
+    const budget = options.shared?.maxSnapshotPixels ?? 8_000_000;
+    if (!Number.isSafeInteger(budget) || budget <= 0 || budget > 32_000_000)
+        throw new RangeError('maxSnapshotPixels must be a positive integer at most 32000000.');
+    const input = typeof options.spring === 'string' ? springs[options.spring] : options.spring;
+    if (options.spring !== undefined && !input)
+        throw new TypeError('Unknown navigation spring.');
+    for (const [key, value] of Object.entries(input ?? {})) {
+        if (!['type', 'duration', 'bounce', 'stiffness', 'damping', 'mass'].includes(key))
+            throw new TypeError(`Unsupported navigation spring option: ${key}.`);
+        if (key === 'type' && value !== 'spring')
+            throw new TypeError('Interactive navigation requires a spring.');
+        if (key !== 'type' && (typeof value !== 'number' || !Number.isFinite(value)))
+            throw new RangeError(`${key} must be finite.`);
+        if (['duration', 'stiffness', 'mass'].includes(key) && value <= 0)
+            throw new RangeError(`${key} must be positive.`);
+        if (key === 'damping' && value < 0)
+            throw new RangeError('damping must be nonnegative.');
+    }
+    const physics = springPhysics(input ?? springs.smooth);
+    if (Object.values(physics).some((value) => !Number.isFinite(value)))
+        throw new RangeError('Navigation spring physics must be finite.');
+    const supported = isIOS && typeof JoltInteractiveNavigation !== 'undefined';
+    let state = 'ready';
+    let native, page;
+    let candidate;
+    let start;
+    let transitioning = false;
+    let fromPage, toPage;
+    let shared;
+    let targetScope;
+    let detachTarget;
+    let resolvedReturn;
+    let returning = false;
+    const originalPage = frame.currentPage;
+    function prepareShared() {
+        if (!native || !options.shared)
+            return;
+        if (returning && options.shared.returnTarget && toPage) {
+            targetScope?.abort();
+            detachTarget?.();
+            detachTarget = undefined;
+            const scope = (targetScope = new ReturnScope());
+            resolvedReturn = undefined;
+            const targetPage = toPage, owner = native, sharedOptions = options.shared;
+            void resolveReturnTarget(sharedOptions.returnTarget, sharedOptions.tag, targetPage, scope.signal).then((result) => {
+                if (scope.signal.aborted || state === 'disposed' || native !== owner)
+                    return;
+                if (result.view) {
+                    resolvedReturn = result.view;
+                    installShared();
+                    const target = result.view;
+                    const invalidated = () => {
+                        shared = { status: 'unavailable', reason: 'target-invalidated' };
+                        owner.cancel();
+                    };
+                    const events = [
+                        'bindingContextChange',
+                        'sharedTransitionTagChange',
+                        'imageSourceChange',
+                        'unloaded',
+                    ];
+                    for (const event of events)
+                        target.on(event, invalidated);
+                    detachTarget = () => {
+                        for (const event of events)
+                            target.off(event, invalidated);
+                    };
+                }
+                else
+                    shared = { status: 'unavailable', reason: result.reason };
+                owner.completeSharedPreparation();
+            });
+            return;
+        }
+        installShared();
+    }
+    function installShared() {
+        if (!native || !options.shared)
+            return;
+        const unavailable = (reason) => {
+            shared = { status: 'unavailable', reason };
+        };
+        if (reducedMotion())
+            return unavailable('reduced-motion');
+        const sources = find(fromPage, options.shared.tag, true), targets = find(toPage, options.shared.tag, true);
+        if (sources.length !== 1)
+            return unavailable(sources.length ? 'duplicate-source' : 'missing-source');
+        if (targets.length !== 1)
+            return unavailable(targets.length ? 'duplicate-target' : 'missing-target');
+        const source = sources[0], target = targets[0], image = source instanceof Image;
+        if (image &&
+            (!supportedImage(source) ||
+                !supportedImage(target) ||
+                (source.src !== target.src && source.imageSource !== target.imageSource)))
+            return unavailable('unsupported-image');
+        if (!image && target instanceof Image)
+            return unavailable('content-mismatch');
+        try {
+            shared = native.prepareSharedFromToImageFromRadiusToRadiusMaxPixels(source.nativeViewProtected, target.nativeViewProtected, image, radius(source), radius(target), budget)
+                ? { status: 'ready' }
+                : { status: 'unavailable', reason: 'unsupported-geometry' };
+        }
+        catch {
+            unavailable('native-unavailable');
+        }
+    }
+    let transition;
+    let releaseMotion;
+    const emit = (next, outcome, release) => {
+        if (state === 'disposed')
+            return;
+        state = next;
+        try {
+            options.onState?.({
+                state,
+                ...(shared ? { shared } : {}),
+                ...(outcome ? { outcome } : {}),
+                ...(release ? { release } : {}),
+            });
+        }
+        catch (error) {
+            Trace.write(`Interactive navigation observer failed: ${String(error)}`, 'Jolt', Trace.messageType.error);
+        }
+    };
+    const cancel = () => {
+        targetScope?.abort();
+        native?.cancel();
+    };
+    const unload = () => control.dispose();
+    const shown = () => native?.sync();
+    const swipeChanged = () => {
+        void Promise.resolve().then(shown);
+    };
+    const arrived = () => {
+        if (transitioning)
+            return;
+        // clearHistory/replace/programmatic pop also release the entry's recognizer.
+        if (page &&
+            frame.currentPage !== page &&
+            !frame.backStack.some((entry) => entry.resolvedPage === page))
+            void Promise.resolve().then(() => control.dispose());
+        else
+            shown();
+    };
+    const entering = (args) => {
+        const event = args;
+        if (!page && !event.isBack)
+            candidate = event.entry?.resolvedPage;
+    };
+    class PageMotion extends Transition {
+        setupInteractiveGesture(callback) {
+            start = callback;
+        }
+        iosNavigatedController(nav, operation, from, to) {
+            if (state === 'disposed' || nav !== frame.ios.controller)
+                return undefined;
+            if (operation === 1) {
+                // An entry owns one transition. Reusing its instance never steals another page.
+                if (page || candidate?.ios !== to)
+                    return undefined;
+                page = candidate;
+                page.on('enableSwipeBackNavigationChange', swipeChanged);
+            }
+            if (!page)
+                return undefined;
+            const pages = [
+                originalPage,
+                page,
+                ...frame.backStack.map((entry) => entry.resolvedPage),
+            ];
+            fromPage = pages.find((candidate) => candidate?.ios === from);
+            toPage = pages.find((candidate) => candidate?.ios === to);
+            shared = undefined;
+            returning = operation !== 1;
+            transitioning = true;
+            if (!native) {
+                native = JoltInteractiveNavigation.attachStiffnessDampingMassShouldBeginOnEvent(nav, physics.stiffness, physics.damping, physics.mass, () => {
+                    try {
+                        return (state === 'idle' &&
+                            !!start &&
+                            !reducedMotion() &&
+                            !!page &&
+                            frame.currentPage === page &&
+                            page.enableSwipeBackNavigation &&
+                            frame.canGoBack() &&
+                            (options.canBegin?.() ?? true) === true);
+                    }
+                    catch {
+                        return false;
+                    }
+                }, (event) => {
+                    if (state === 'disposed')
+                        return;
+                    if (event === 8) {
+                        prepareShared();
+                        return;
+                    }
+                    if (event === 2) {
+                        transitioning = true;
+                        frame.transitionId = this.id;
+                        SharedTransition.updateState(this.id, {
+                            interactiveBegan: true,
+                            interactiveCancelled: false,
+                        });
+                        emit('dragging');
+                        start?.();
+                    }
+                    else if (event === 3 || event === 4) {
+                        emit(event === 3 ? 'finishing' : 'cancelling', undefined, native && { progress: native.progress, velocity: native.velocity });
+                    }
+                    else if (event === 0)
+                        emit('animating');
+                    else {
+                        targetScope?.abort();
+                        targetScope = undefined;
+                        detachTarget?.();
+                        detachTarget = undefined;
+                        if (returning && event !== 6 && toPage && options.shared?.returnTarget) {
+                            let focus = resolvedReturn;
+                            if (!focus)
+                                try {
+                                    focus = options.shared.returnTarget.fallbackFocus?.(toPage);
+                                }
+                                catch { }
+                            focusReturnTarget(toPage, focus);
+                        }
+                        transitioning = false;
+                        SharedTransition.updateState(this.id, {
+                            interactiveBegan: false,
+                            interactiveCancelled: event === 6,
+                        });
+                        emit('idle', event === 5 ? 'completed' : event === 6 ? 'cancelled' : undefined);
+                        arrived();
+                    }
+                });
+            }
+            if (options.shared)
+                native.sharedEnabled = true;
+            native.sharedDeferred = !!(returning && options.shared?.returnTarget);
+            native.prepareOperationPresentedReducedTimeScale(operation, page.ios, reducedMotion(), timeScale());
+            return native;
+        }
+        iosInteractionDismiss() {
+            return native?.interactive ? native : undefined;
+        }
+    }
+    const control = {
+        supported,
+        get transition() {
+            return transition;
+        },
+        get state() {
+            return state;
+        },
+        cancel,
+        dispose() {
+            if (state === 'disposed')
+                return;
+            targetScope?.abort();
+            targetScope = undefined;
+            detachTarget?.();
+            detachTarget = undefined;
+            // Complete UIKit's context before releasing Core's interactive state.
+            native?.disposeRestoringSwipe(!!page?.enableSwipeBackNavigation && frame.canGoBack());
+            native = undefined;
+            emit('disposed');
+            releaseMotion?.();
+            frame.off('unloaded', unload);
+            frame.off('navigatingTo', entering);
+            frame.off('navigatedTo', arrived);
+            frame.off('viewControllerShown', shown);
+            Application.off(Application.suspendEvent, cancel);
+            if (transition?.instance)
+                SharedTransition.finishState(transition.instance.id);
+            page?.off('enableSwipeBackNavigationChange', swipeChanged);
+            start = undefined;
+            page = undefined;
+            candidate = undefined;
+            fromPage = undefined;
+            toPage = undefined;
+        },
+    };
+    if (supported) {
+        if (!frame.isLoaded || !frame.ios?.controller)
+            throw new Error('Create interactiveNavigation after the Frame is loaded.');
+        transition = SharedTransition.custom(new PageMotion(), {
+            interactive: { dismiss: {} },
+        });
+        frame.on('navigatingTo', entering);
+        frame.on('navigatedTo', arrived);
+        frame.on('viewControllerShown', shown);
+        frame.on('unloaded', unload);
+        Application.on(Application.suspendEvent, cancel);
+        releaseMotion = onReducedMotion((value) => {
+            if (value)
+                cancel();
+        });
+    }
+    return control;
+}
+//# sourceMappingURL=index.js.map

package/dist/interactive-navigation/index.js.map

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

package/dist/keyboard.d.ts

@@ -1,8 +1,32 @@
+import type { Transition } from './transition.js';
 import type { Target } from './types.js';
 export interface KeyboardOptions {
     /** DIPs kept between the view's bottom edge and the keyboard. Defaults to zero. */
     offset?: number;
 }
+export interface KeyboardState {
+    /** Whether a docked software keyboard covers part of the window. */
+    readonly visible: boolean;
+    /** DIPs of the window the keyboard covers, from its bottom edge. Zero when hidden or floating. */
+    readonly height: number;
+    /** Milliseconds the keyboard takes to get there. Zero when it changes at once. */
+    readonly duration: number;
+    /** The keyboard's own timing, to pass to `animate()` and move in step with it. */
+    readonly transition: Transition;
+}
+/**
+ * Calls back whenever the keyboard shows, hides or changes height, with how much
+ * of the window it covers and its timing. Returns a cleanup function.
+ *
+ * ```ts
+ * const off = onKeyboard(({ visible, transition }) => {
+ *   animate(header, { scale: visible ? 0.8 : 1 }, transition)
+ * })
+ * ```
+ */
+export declare function onKeyboard(callback: (keyboard: KeyboardState) => void): () => void;
+/** The last state reported while someone listens. */
+export declare function currentKeyboard(): KeyboardState;
 /**
  * Lifts the view by its overlap with the software keyboard, at the keyboard's
  * own speed and curve, and lets it back down when the keyboard hides.

package/dist/keyboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../src/keyboard.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAID;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC5B,MAAM,IAAI,CAOZ"}
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../src/keyboard.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAU,UAAU,EAAS,MAAM,iBAAiB,CAAA;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,kGAAkG;IAClG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;CAChC;AA6BD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAclF;AAED,qDAAqD;AACrD,wBAAgB,eAAe,IAAI,aAAa,CAE/C;AA4GD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC5B,MAAM,IAAI,CAOZ"}

package/dist/keyboard.js

@@ -1,6 +1,148 @@
 import { Application, Utils, isAndroid, isIOS } from '@nativescript/core';
-import { stop, toView } from './animate.js';
+import { animate, stop, toView } from './animate.js';
 const BEGIN_FROM_CURRENT_STATE = 4;
+const IOS_KEYBOARD_CURVE = 7;
+// Measured: Core Animation plays the keyboard's spring (stiffness 1000, mass 3) critically damped in 500 ms.
+const iosKeyboard = {
+    type: 'spring',
+    stiffness: 1000,
+    mass: 3,
+    damping: 2 * Math.sqrt(3000),
+};
+const iosCurves = ['easeInOut', 'easeIn', 'easeOut', 'linear'];
+// Before Android 11 nothing reports the keyboard's timing. Measured on an Android 9 emulator,
+// its window fades and slides into place in about 150 ms, decelerating, and leaves as quickly.
+const LEGACY_DURATION = 150;
+const legacyShow = { duration: LEGACY_DURATION, ease: 'quadOut' };
+const legacyHide = { duration: LEGACY_DURATION, ease: 'quadIn' };
+const legacy = () => isAndroid && android.os.Build.VERSION.SDK_INT < 30;
+const hidden = Object.freeze({
+    visible: false,
+    height: 0,
+    duration: 0,
+    transition: { duration: 0 },
+});
+const listeners = new Set();
+let state = hidden;
+let unwatch;
+/**
+ * Calls back whenever the keyboard shows, hides or changes height, with how much
+ * of the window it covers and its timing. Returns a cleanup function.
+ *
+ * ```ts
+ * const off = onKeyboard(({ visible, transition }) => {
+ *   animate(header, { scale: visible ? 0.8 : 1 }, transition)
+ * })
+ * ```
+ */
+export function onKeyboard(callback) {
+    if (typeof callback !== 'function')
+        throw new TypeError('onKeyboard() takes a callback.');
+    const listener = (keyboard) => callback(keyboard);
+    if (listeners.size === 0) {
+        state = hidden;
+        unwatch = isIOS ? watchIOS() : isAndroid ? watchAndroid() : undefined;
+    }
+    listeners.add(listener);
+    return () => {
+        if (!listeners.delete(listener) || listeners.size > 0)
+            return;
+        unwatch?.();
+        unwatch = undefined;
+    };
+}
+/** The last state reported while someone listens. */
+export function currentKeyboard() {
+    return state;
+}
+function update(height, duration, transition) {
+    if (height === state.height)
+        return;
+    state = Object.freeze({ visible: height > 0, height, duration, transition });
+    for (const listener of [...listeners])
+        listener(state);
+}
+function watchIOS() {
+    const name = UIKeyboardWillChangeFrameNotification;
+    const observer = Application.ios.addNotificationObserver(name, (notification) => {
+        const info = notification.userInfo;
+        const window = Application.ios.window;
+        const end = info?.objectForKey(UIKeyboardFrameEndUserInfoKey)?.CGRectValue;
+        if (!info || !window || !end)
+            return;
+        const frame = window.convertRectFromWindow(end, null);
+        const bottom = window.bounds.size.height;
+        const docked = frame.size.height > 0 &&
+            frame.origin.y < bottom &&
+            frame.origin.y + frame.size.height >= bottom - 0.5;
+        const reported = numberIn(info, UIKeyboardAnimationDurationUserInfoKey) * 1000;
+        const curve = numberIn(info, UIKeyboardAnimationCurveUserInfoKey);
+        const height = docked ? bottom - frame.origin.y : 0;
+        if (!reported)
+            return update(height, 0, { duration: 0 });
+        if (curve === IOS_KEYBOARD_CURVE)
+            return update(height, 500, iosKeyboard);
+        update(height, reported, {
+            duration: reported,
+            ease: iosCurves[curve] ?? 'easeInOut',
+        });
+    });
+    return () => Application.ios.removeNotificationObserver(observer, name);
+}
+function watchAndroid() {
+    const density = Utils.layout.getDisplayDensity();
+    let observer;
+    let stopped = false;
+    const attach = () => {
+        Application.off(Application.launchEvent, attach);
+        if (stopped || observer)
+            return;
+        const activity = Application.android.foregroundActivity ?? Application.android.startActivity;
+        const root = activity?.getWindow()?.getDecorView();
+        if (!root)
+            return;
+        try {
+            observer = legacy()
+                ? new org.rafaelaugusto.jolt.KeyboardFrame(root, new org.rafaelaugusto.jolt.KeyboardFrame.Listener({
+                    onChange: (height) => update(height / density, LEGACY_DURATION, height ? legacyShow : legacyHide),
+                }))
+                : new org.rafaelaugusto.jolt.KeyboardObserver(root, new org.rafaelaugusto.jolt.KeyboardObserver.Listener({
+                    onChange: (height, duration, curve) => update(height / density, duration, duration
+                        ? { duration, ease: curve ? sampled(curve) : 'linear' }
+                        : { duration: 0 }),
+                }));
+        }
+        catch {
+            // A JS-only update cannot install the native plugin.
+            return;
+        }
+        observer.attach();
+        const height = observer.height() / density;
+        if (height > 0)
+            state = Object.freeze({ ...hidden, visible: true, height });
+    };
+    if (Application.android.foregroundActivity ?? Application.android.startActivity)
+        attach();
+    else
+        Application.on(Application.launchEvent, attach);
+    return () => {
+        stopped = true;
+        Application.off(Application.launchEvent, attach);
+        observer?.detach();
+        observer = undefined;
+    };
+}
+function sampled(curve) {
+    const values = Array.from({ length: curve.length }, (_, i) => curve[i]);
+    const last = values.length - 1;
+    if (last < 1)
+        return (progress) => progress;
+    return (progress) => {
+        const position = Math.min(Math.max(progress, 0), 1) * last;
+        const index = Math.min(Math.floor(position), last - 1);
+        return values[index] + (values[index + 1] - values[index]) * (position - index);
+    };
+}
 /**
  * Lifts the view by its overlap with the software keyboard, at the keyboard's
  * own speed and curve, and lets it back down when the keyboard hides.
@@ -48,11 +190,10 @@ function followIOS(view, offset) {
         const apply = () => {
             view.translateY = overlap ? -overlap : 0;
         };
-        const duration = info.objectForKey(UIKeyboardAnimationDurationUserInfoKey)
-            ?.doubleValue;
+        const duration = numberIn(info, UIKeyboardAnimationDurationUserInfoKey);
         if (!duration)
             return apply();
-        const curve = info.objectForKey(UIKeyboardAnimationCurveUserInfoKey)?.integerValue ?? 0;
+        const curve = numberIn(info, UIKeyboardAnimationCurveUserInfoKey);
         // The keyboard's curve is private; shifted into the options it still applies.
         UIView.animateWithDurationDelayOptionsAnimationsCompletion(duration, 0, ((curve << 16) | BEGIN_FROM_CURRENT_STATE), apply, () => { });
     };
@@ -70,8 +211,8 @@ function followIOS(view, offset) {
     return cleanup;
 }
 function followAndroid(view, offset) {
-    if (android.os.Build.VERSION.SDK_INT < 30)
-        return () => { };
+    if (legacy())
+        return followLegacy(view, offset);
     const density = Utils.layout.getDisplayDensity();
     let disposed = false;
     let follower;
@@ -113,4 +254,56 @@ function followAndroid(view, offset) {
         attach();
     return cleanup;
 }
+/** Android 7 to 10: no frame-by-frame progress, so the view animates with the keyboard's usual timing. */
+function followLegacy(view, offset) {
+    const density = Utils.layout.getDisplayDensity();
+    let disposed = false;
+    let follower;
+    const attach = () => {
+        if (disposed || follower)
+            return;
+        const native = view.nativeViewProtected;
+        if (!native)
+            return;
+        try {
+            follower = new org.rafaelaugusto.jolt.KeyboardFrameFollower(native, offset * density, new org.rafaelaugusto.jolt.KeyboardFrameFollower.Listener({
+                onMove: (from, to, keyboard) => {
+                    stop(view, ['y']);
+                    view.translateY = from / density;
+                    animate(view, { y: to / density }, keyboard ? legacyShow : legacyHide);
+                },
+            }));
+        }
+        catch {
+            // A JS-only update cannot install the native plugin. Leave the platform's resize in place.
+            return;
+        }
+        follower.attach();
+    };
+    const cleanup = () => {
+        if (disposed)
+            return;
+        disposed = true;
+        view.off('loaded', attach);
+        view.off('unloaded', cleanup);
+        if (follower) {
+            follower.detach();
+            follower = undefined;
+            stop(view, ['y']);
+            view.translateY = 0;
+        }
+    };
+    view.on('loaded', attach);
+    view.on('unloaded', cleanup);
+    if (view.isLoaded)
+        attach();
+    return cleanup;
+}
+/** The runtime hands NSNumber values over as plain numbers. */
+function numberIn(info, key) {
+    const value = info.objectForKey(key);
+    if (typeof value === 'number')
+        return value;
+    return value?.doubleValue ?? 0;
+}
 //# sourceMappingURL=keyboard.js.map