@rafaelaugusto/jolt 0.1.0-beta.1 → 0.1.0-beta.10

package/dist/zoomable.js

@@ -0,0 +1,249 @@
+import { Application, Image, isIOS } from '@nativescript/core';
+import { stop, toView } from './animate.js';
+import { reducedMotion } from './config.js';
+import { ownImage } from './image-owner.js';
+import { createZoomDriver } from './zoom-native.js';
+/** Makes an Image interactive without per-frame JS. Owns its transforms until disposed. */
+export function zoomable(target, options = {}) {
+    const image = toView(target);
+    if (!(image instanceof Image))
+        throw new TypeError('zoomable() expects a NativeScript Image.');
+    if (!options || typeof options !== 'object')
+        throw new TypeError('Zoom options must be an object.');
+    const viewport = options.viewport
+        ? toView(options.viewport)
+        : image.parent;
+    if (!viewport)
+        throw new TypeError('A zoom viewport is required before the image has a parent.');
+    const scale = options.scale ?? [1, 5];
+    if (!Array.isArray(scale) ||
+        scale.length !== 2 ||
+        !scale.every(Number.isFinite) ||
+        scale[0] < 1 ||
+        scale[1] < scale[0])
+        throw new RangeError('Zoom scale must be [minimum, maximum], with 1 <= minimum <= maximum.');
+    const doubleTap = options.doubleTap ?? 2.5;
+    if (!Number.isFinite(doubleTap) || doubleTap < 1)
+        throw new RangeError('Double-tap zoom must be a finite number >= 1.');
+    if (options.dismiss !== undefined &&
+        options.dismiss !== false &&
+        options.dismiss !== 'vertical')
+        throw new TypeError("Dismiss must be 'vertical' or false.");
+    for (const callback of [options.onDismiss, options.onSettled, options.onError])
+        if (callback !== undefined && typeof callback !== 'function')
+            throw new TypeError('Zoom callbacks must be functions.');
+    const backdrop = options.backdrop ? toView(options.backdrop) : undefined;
+    const chrome = options.chrome ? toView(options.chrome) : undefined;
+    if (backdrop === image ||
+        chrome === image ||
+        backdrop === viewport ||
+        chrome === viewport)
+        throw new TypeError('Dismissal backdrop/chrome must be separate from the image and viewport.');
+    if (image.parent && image.parent !== viewport)
+        throw new TypeError('The zoom viewport must be the image’s direct parent.');
+    if (image.rotate ||
+        image.rotateX ||
+        image.rotateY ||
+        image.scaleX <= 0 ||
+        image.scaleY <= 0)
+        throw new TypeError('Zoom supports positive axis-aligned image transforms; rotate an ancestor instead.');
+    return new Photo(image, viewport, { ...options, doubleTap, scale, backdrop, chrome });
+}
+class Photo {
+    image;
+    viewport;
+    options;
+    failure;
+    suspended = false;
+    driver;
+    stopped = false;
+    queued = false;
+    releaseOwnership = () => { };
+    generation = 0;
+    reduceObserver;
+    latest;
+    constructor(image, viewport, options) {
+        this.image = image;
+        this.viewport = viewport;
+        this.options = options;
+        this.latest = { x: 0, y: 0, scale: options.scale[0], progress: 0, pending: false };
+        this.releaseOwnership = ownImage(image, this.dispose);
+        stop(image, ['x', 'y', 'scaleX', 'scaleY']);
+        for (const view of [image, viewport]) {
+            view.on('loaded', this.schedule);
+            view.on('layoutChanged', this.schedule);
+            view.on('unloaded', this.dispose);
+        }
+        image.on('imageSourceChange', this.sourceChanged);
+        image.on('stretchChange', this.sourceChanged);
+        Application.on(Application.suspendEvent, this.suspend);
+        Application.on(Application.resumeEvent, this.resume);
+        if (isIOS)
+            this.reduceObserver = Application.ios.addNotificationObserver(UIAccessibilityReduceMotionStatusDidChangeNotification, this.preferences);
+        this.schedule();
+    }
+    get ready() {
+        return !!this.driver;
+    }
+    get error() {
+        return this.failure;
+    }
+    get state() {
+        return { ...(this.driver?.state ?? this.latest) };
+    }
+    get nativeController() {
+        return this.driver?.native;
+    }
+    zoomTo(value, focus, animated = true) {
+        if (!Number.isFinite(value) ||
+            value < this.options.scale[0] ||
+            value > this.options.scale[1])
+            throw new RangeError('Zoom must be within the configured scale range.');
+        if (focus && (!Number.isFinite(focus.x) || !Number.isFinite(focus.y)))
+            throw new RangeError('Zoom focus must be finite.');
+        if (this.stopped)
+            return;
+        const size = this.viewport.getActualSize();
+        this.driver?.zoom(value, focus?.x ?? size.width / 2, focus?.y ?? size.height / 2, animated);
+    }
+    reset(animated = true) {
+        this.generation++;
+        this.driver?.reset(animated);
+    }
+    requestDismiss() {
+        this.driver?.requestDismiss();
+    }
+    cancelDismiss() {
+        this.reset(true);
+    }
+    dispose = () => {
+        if (this.stopped)
+            return;
+        this.stopped = true;
+        this.generation++;
+        this.latest = {
+            x: 0,
+            y: 0,
+            scale: this.options.scale[0],
+            progress: 0,
+            pending: false,
+        };
+        this.driver?.stop();
+        this.driver = undefined;
+        this.releaseOwnership();
+        for (const view of [this.image, this.viewport]) {
+            view.off('loaded', this.schedule);
+            view.off('layoutChanged', this.schedule);
+            view.off('unloaded', this.dispose);
+        }
+        this.image.off('imageSourceChange', this.sourceChanged);
+        this.image.off('stretchChange', this.sourceChanged);
+        Application.off(Application.suspendEvent, this.suspend);
+        Application.off(Application.resumeEvent, this.resume);
+        if (this.reduceObserver)
+            Application.ios.removeNotificationObserver(this.reduceObserver, UIAccessibilityReduceMotionStatusDidChangeNotification);
+        this.reduceObserver = undefined;
+    };
+    dismissed = (x, y, scale, velocity, progress) => {
+        if (this.stopped)
+            return;
+        const generation = ++this.generation;
+        const valid = () => !this.stopped && generation === this.generation;
+        const dismissal = {
+            state: { x, y, scale, progress, pending: true },
+            velocity,
+            cancel: () => {
+                if (!valid())
+                    return false;
+                this.cancelDismiss();
+                return true;
+            },
+            complete: () => {
+                if (!valid())
+                    return false;
+                this.dispose();
+                return true;
+            },
+        };
+        if (this.options.onDismiss)
+            this.options.onDismiss(dismissal);
+        else
+            dismissal.cancel();
+    };
+    settled = (x, y, scale) => {
+        if (this.stopped)
+            return;
+        this.generation++;
+        this.latest = { x, y, scale, progress: 0, pending: false };
+        this.options.onSettled?.({ ...this.latest });
+    };
+    sourceChanged = () => {
+        this.generation++;
+        this.driver?.stop();
+        this.driver = undefined;
+        this.schedule();
+    };
+    suspend = () => {
+        this.suspended = true;
+        this.generation++;
+        this.driver?.setActive(false);
+    };
+    resume = () => {
+        this.suspended = false;
+        this.preferences();
+        this.driver?.setActive(true);
+        this.schedule();
+    };
+    preferences = () => this.driver?.setReduced(reducedMotion());
+    schedule = () => {
+        if (this.stopped || this.queued)
+            return;
+        this.queued = true;
+        void Promise.resolve()
+            .then(() => {
+            this.queued = false;
+            if (this.stopped ||
+                this.suspended ||
+                !this.image.isLoaded ||
+                !this.viewport.isLoaded)
+                return;
+            if (this.driver) {
+                this.driver.layout();
+                return;
+            }
+            if (this.image.parent !== this.viewport)
+                throw new TypeError('Zoom viewport must remain the direct image parent.');
+            const size = this.viewport.getActualSize();
+            const imageSize = this.image.getActualSize(), source = this.image.imageSource;
+            if (size.width <= 0 ||
+                size.height <= 0 ||
+                imageSize.width <= 0 ||
+                imageSize.height <= 0 ||
+                !source ||
+                !Number.isFinite(source.width) ||
+                !Number.isFinite(source.height) ||
+                source.width <= 0 ||
+                source.height <= 0)
+                return;
+            if (isIOS && typeof JoltPhotoZoom === 'undefined')
+                throw new Error('Rebuild the native app to install Jolt photo gestures.');
+            this.driver = createZoomDriver(this.image, this.viewport, {
+                minimum: this.options.scale[0],
+                maximum: this.options.scale[1],
+                doubleTap: this.options.doubleTap,
+                dismiss: this.options.dismiss === 'vertical',
+                reduced: reducedMotion(),
+                backdrop: this.options.backdrop,
+                chrome: this.options.chrome,
+            }, this.dismissed, this.settled);
+        })
+            .catch((error) => {
+            if (this.stopped)
+                return;
+            this.failure = error instanceof Error ? error : new Error(String(error));
+            this.dispose();
+            this.options.onError?.(this.failure);
+        });
+    };
+}
+//# sourceMappingURL=zoomable.js.map

package/dist/zoomable.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rafaelaugusto/jolt",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.10",
   "description": "Native animations for NativeScript: presets, springs, keyframes and stagger in one call.",
   "keywords": [
     "nativescript",
@@ -10,7 +10,8 @@
     "spring",
     "keyframes",
     "ios",
-    "android"
+    "android",
+    "vue"
   ],
   "author": "Rafael Augusto",
   "license": "MIT",
@@ -28,17 +29,26 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./vue": {
+      "types": "./dist/vue/index.d.ts",
+      "default": "./dist/vue/index.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "platforms/ios",
+    "platforms/android/java",
+    "platforms/android/include.gradle",
+    "platforms/android/proguard-rules.pro"
   ],
   "sideEffects": false,
   "scripts": {
     "build": "node -e \"fs.rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.build.json",
     "dev": "tsc -p tsconfig.build.json --watch",
     "typecheck": "tsc --noEmit",
+    "benchmark:typecheck": "tsc -p benchmarks/tsconfig.json",
     "test": "vitest run",
     "test:watch": "vitest",
     "format": "prettier --write .",
@@ -46,15 +56,23 @@
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs",
-    "prepack": "npm run build"
+    "prepack": "npm run build",
+    "docs:check-media": "node scripts/check-docs-media.mjs"
   },
   "peerDependencies": {
-    "@nativescript/core": ">=8.9.0"
+    "@nativescript/core": ">=8.9.0",
+    "nativescript-vue": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "nativescript-vue": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@nativescript/core": "^9.1.3",
     "@nativescript/types-android": "^9.1.1",
     "@nativescript/types-ios": "^9.1.3",
+    "nativescript-vue": "3.1.2",
     "prettier": "^3.9.10",
     "typescript": "^7.0.2",
     "vitepress": "^1.6.4",
@@ -65,5 +83,11 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "nativescript": {
+    "platforms": {
+      "android": "8.9.0",
+      "ios": "8.9.0"
+    }
   }
 }

package/platforms/android/include.gradle

@@ -0,0 +1,7 @@
+// Applied by the NativeScript app. Preserve fields used by the native color target.
+def joltDependency = nativescriptDependencies.find { it.name == '@rafaelaugusto/jolt' }
+if (joltDependency != null) {
+    android.buildTypes.all {
+        proguardFile new File(rootDir, "${joltDependency.directory}/platforms/android/proguard-rules.pro")
+    }
+}

package/platforms/android/java/org/rafaelaugusto/jolt/ColorTarget.java

@@ -0,0 +1,102 @@
+package org.rafaelaugusto.jolt;
+
+import android.graphics.PorterDuff;
+import android.graphics.drawable.ColorDrawable;
+import android.graphics.drawable.Drawable;
+import android.view.View;
+import android.widget.TextView;
+import java.lang.ref.WeakReference;
+import java.lang.reflect.Field;
+import java.lang.reflect.Method;
+
+/** ObjectAnimator target. All frame updates stay in native code. */
+public final class ColorTarget {
+    private static final String BORDER = "org.nativescript.widgets.BorderDrawable";
+    static final Field[] FIELDS = fields();
+    private static final String SHADOW = "org.nativescript.widgets.BoxShadowDrawable";
+    private static final Method UNWRAP = unwrapMethod();
+    private final WeakReference<View> view;
+    private final int property;
+    private int color;
+
+    // 0 = background, 1 = uniform border, 2 = text.
+    public ColorTarget(View view, int property, int initialColor) {
+        this.view = new WeakReference<>(view);
+        this.property = property;
+        this.color = initialColor;
+    }
+
+    private static Field[] fields() {
+        try {
+            Class<?> type = Class.forName(BORDER);
+            String[] names = {"backgroundColor", "borderTopColor", "borderRightColor", "borderBottomColor", "borderLeftColor"};
+            Field[] result = new Field[names.length];
+            for (int i = 0; i < names.length; i++) {
+                result[i] = type.getDeclaredField(names[i]);
+                result[i].setAccessible(true);
+            }
+            return result;
+        } catch (ReflectiveOperationException | SecurityException exception) {
+            return null;
+        }
+    }
+
+    private static Method unwrapMethod() {
+        try {
+            return Class.forName(SHADOW).getMethod("getWrappedDrawable");
+        } catch (ReflectiveOperationException exception) {
+            return null;
+        }
+    }
+
+    static Drawable background(View nativeView) {
+        Drawable drawable = nativeView.getBackground();
+        // Avoid reflective method lookups and exceptions in the frame loop.
+        if (drawable != null && drawable.getClass().getName().equals(SHADOW) && UNWRAP != null) {
+            try {
+                return (Drawable) UNWRAP.invoke(drawable);
+            } catch (ReflectiveOperationException exception) {
+                return drawable;
+            }
+        }
+        return drawable;
+    }
+
+    public boolean isSupported() {
+        View nativeView = view.get();
+        if (nativeView == null) return false;
+        if (property == 2) return nativeView instanceof TextView;
+        Drawable drawable = background(nativeView);
+        if (drawable == null) return true;
+        if (drawable.getClass().getName().equals(SHADOW)) return false;
+        return !drawable.getClass().getName().equals(BORDER) || FIELDS != null;
+    }
+
+    public int getColor() { return color; }
+
+    public void setColor(int value) {
+        View nativeView = view.get();
+        if (nativeView == null) return;
+        color = value;
+        if (property == 2) {
+            ((TextView) nativeView).setTextColor(value);
+            return;
+        }
+        // Resolve on every frame: a Core style update may replace the drawable.
+        Drawable drawable = background(nativeView);
+        if (drawable == null || drawable.getClass().getName().equals(SHADOW)) return;
+        if (drawable.getClass().getName().equals(BORDER)) {
+            if (FIELDS == null) return;
+            try {
+                if (property == 0) FIELDS[0].setInt(drawable, value);
+                else for (int i = 1; i < FIELDS.length; i++) FIELDS[i].setInt(drawable, value);
+                drawable.invalidateSelf();
+            } catch (IllegalAccessException exception) {
+                // Unsupported Core versions keep the final model color.
+            }
+        } else if (property == 0) {
+            if (drawable instanceof ColorDrawable) ((ColorDrawable) drawable).setColor(value);
+            else drawable.setColorFilter(value, PorterDuff.Mode.SRC_IN);
+        }
+    }
+}

package/platforms/android/java/org/rafaelaugusto/jolt/DecorationTarget.java

@@ -0,0 +1,154 @@
+package org.rafaelaugusto.jolt;
+
+import android.animation.StateListAnimator;
+import android.graphics.drawable.Drawable;
+import android.graphics.drawable.ColorDrawable;
+import android.view.View;
+import java.lang.ref.WeakReference;
+import java.lang.reflect.Constructor;
+import java.lang.reflect.Field;
+import java.util.WeakHashMap;
+
+/** ObjectAnimator's float target. No JavaScript enters the native frame loop. */
+public final class DecorationTarget {
+    private static final String BORDER = "org.nativescript.widgets.BorderDrawable";
+    private static final Field[][] FIELDS = fields();
+    private static final Constructor<?> CONSTRUCTOR = constructor();
+    private static final WeakHashMap<View, BackgroundLease> BACKGROUNDS = new WeakHashMap<>();
+    private static final WeakHashMap<View, Lease> LEASES = new WeakHashMap<>();
+    private final WeakReference<View> view;
+    private final int property;
+    private final int borderColor;
+    private float value;
+    private boolean acquired;
+
+    // 0 = uniform radius, 1 = uniform width, 2 = elevation, 3 = translationZ.
+    public DecorationTarget(View view, int property, float value, int borderColor) {
+        this.view = new WeakReference<>(view);
+        this.property = property;
+        this.value = value;
+        this.borderColor = borderColor;
+    }
+    private static Field[][] fields() {
+        try {
+            Class<?> type = Class.forName(BORDER);
+            String[][] names = {
+                {"borderTopLeftRadius", "borderTopRightRadius", "borderBottomRightRadius", "borderBottomLeftRadius"},
+                {"borderTopWidth", "borderRightWidth", "borderBottomWidth", "borderLeftWidth"}
+            };
+            Field[][] result = new Field[2][4];
+            for (int i = 0; i < 2; i++) for (int j = 0; j < 4; j++) {
+                result[i][j] = type.getDeclaredField(names[i][j]);
+                result[i][j].setAccessible(true);
+            }
+            return result;
+        } catch (ReflectiveOperationException | SecurityException exception) { return null; }
+    }
+    private static Constructor<?> constructor() {
+        try { return Class.forName(BORDER).getConstructor(float.class); }
+        catch (ReflectiveOperationException | SecurityException exception) { return null; }
+    }
+    public boolean isSupported() {
+        View nativeView = view.get();
+        if (nativeView == null) return false;
+        if (property >= 2) return true;
+        Drawable drawable = ColorTarget.background(nativeView);
+        return FIELDS != null && ((drawable != null && drawable.getClass().getName().equals(BORDER)) ||
+            ((drawable == null || drawable.getClass() == ColorDrawable.class) && CONSTRUCTOR != null && ColorTarget.FIELDS != null));
+    }
+    public float getValue() { return value; }
+    public void setValue(float next) {
+        View nativeView = view.get();
+        if (nativeView == null) return;
+        value = next;
+        if (property >= 2) suspendStateAnimator(nativeView);
+        if (property == 2) { nativeView.setElevation(next); return; }
+        if (property == 3) { nativeView.setTranslationZ(next); return; }
+        ensureBackground(nativeView);
+        Drawable drawable = ColorTarget.background(nativeView);
+        if (drawable == null || !drawable.getClass().getName().equals(BORDER) || FIELDS == null) return;
+        try {
+            // Core rebuilds the paths from these fields in draw() and getOutline().
+            // Keep its bitmap, gradient, color and all other state on the same drawable.
+            for (Field field : FIELDS[property]) field.setFloat(drawable, next);
+            drawable.invalidateSelf();
+            nativeView.invalidateOutline();
+        } catch (IllegalAccessException exception) { /* Keep Core's final model. */ }
+    }
+    public void acquire() {
+        View nativeView = view.get();
+        if (nativeView == null || acquired) return;
+        acquired = true;
+        if (property < 2) {
+            BackgroundLease lease = BACKGROUNDS.get(nativeView);
+            if (lease == null) { lease = new BackgroundLease(); BACKGROUNDS.put(nativeView, lease); }
+            lease.count++;
+            ensureBackground(nativeView);
+            return;
+        }
+        Lease lease = LEASES.get(nativeView);
+        if (lease == null) {
+            lease = new Lease(nativeView.getStateListAnimator());
+            LEASES.put(nativeView, lease);
+            nativeView.setStateListAnimator(null);
+        }
+        lease.count++;
+        suspendStateAnimator(nativeView);
+    }
+    public void release() {
+        View nativeView = view.get();
+        if (!acquired || nativeView == null) return;
+        acquired = false;
+        if (property < 2) {
+            BackgroundLease lease = BACKGROUNDS.get(nativeView);
+            if (lease != null && --lease.count == 0) {
+                BACKGROUNDS.remove(nativeView);
+                if (lease.drawable != null && nativeView.getBackground() == lease.drawable) nativeView.setBackground(lease.original);
+            }
+            return;
+        }
+        suspendStateAnimator(nativeView);
+        Lease lease = LEASES.get(nativeView);
+        if (lease != null && --lease.count == 0) {
+            LEASES.remove(nativeView);
+            if (nativeView.getStateListAnimator() == null) {
+                float elevation = nativeView.getElevation(), z = nativeView.getTranslationZ();
+                nativeView.setStateListAnimator(lease.animator);
+                if (lease.animator != null) lease.animator.jumpToCurrentState();
+                nativeView.setElevation(elevation);
+                nativeView.setTranslationZ(z);
+            }
+        }
+    }
+    private void ensureBackground(View nativeView) {
+        BackgroundLease lease = BACKGROUNDS.get(nativeView);
+        Drawable original = nativeView.getBackground();
+        if (lease == null || (original != null && original.getClass() != ColorDrawable.class) || CONSTRUCTOR == null || ColorTarget.FIELDS == null) return;
+        try {
+            Drawable drawable = (Drawable) CONSTRUCTOR.newInstance(nativeView.getResources().getDisplayMetrics().density);
+            ColorTarget.FIELDS[0].setInt(drawable, original == null ? 0 : ((ColorDrawable) original).getColor());
+            for (int i = 1; i < ColorTarget.FIELDS.length; i++) ColorTarget.FIELDS[i].setInt(drawable, borderColor);
+            lease.original = original;
+            lease.drawable = drawable;
+            nativeView.setBackground(drawable);
+        } catch (ReflectiveOperationException exception) { /* Unsupported Core. */ }
+    }
+    private static final class BackgroundLease {
+        Drawable original, drawable;
+        int count;
+    }
+    private static void suspendStateAnimator(View view) {
+        Lease lease = LEASES.get(view);
+        StateListAnimator current = view.getStateListAnimator();
+        if (lease != null && current != null) {
+            // A Core model write may have installed an updated state animator.
+            lease.animator = current;
+            view.setStateListAnimator(null);
+        }
+    }
+    private static final class Lease {
+        StateListAnimator animator;
+        int count;
+        Lease(StateListAnimator animator) { this.animator = animator; }
+    }
+}