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

package/dist/decoration.js

@@ -0,0 +1,155 @@
+import { preserveZeroShadow } from './driver/ios-shadow.js';
+import { Color, Utils, isAndroid } from '@nativescript/core';
+export const decorationProperties = [
+    'borderRadius',
+    'borderWidth',
+    'shadowOpacity',
+    'shadowRadius',
+    'shadowOffsetX',
+    'shadowOffsetY',
+    'elevation',
+    'translationZ',
+];
+export const radiusKeys = [
+    'borderTopLeftRadius',
+    'borderTopRightRadius',
+    'borderBottomRightRadius',
+    'borderBottomLeftRadius',
+];
+export const widthKeys = [
+    'borderTopWidth',
+    'borderRightWidth',
+    'borderBottomWidth',
+    'borderLeftWidth',
+];
+const writing = new WeakSet();
+export const isWritingDecoration = (view) => writing.has(view);
+export const isDecorationProperty = (key) => decorationProperties.includes(key);
+/** Core lengths may be numbers, px strings or parsed { value, unit } lengths. */
+export function dip(value) {
+    if (value === undefined || value === null)
+        return 0;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string') {
+        const match = /^(-?(?:\d+(?:\.\d*)?|\.\d+))(dip|px)?$/.exec(value.trim());
+        if (match)
+            return Number(match[1]) / (match[2] === 'px' ? Utils.layout.getDisplayDensity() : 1);
+    }
+    if (typeof value === 'object' && 'value' in value && 'unit' in value) {
+        const length = value;
+        if (Number.isFinite(length.value) && (length.unit === 'dip' || length.unit === 'px'))
+            return length.value / (length.unit === 'px' ? Utils.layout.getDisplayDensity() : 1);
+    }
+    throw new TypeError('Decoration animations require finite DIP or px lengths.');
+}
+export function singleShadow(view) {
+    const shadows = view.boxShadow;
+    if (!Array.isArray(shadows) || shadows.length !== 1 || shadows[0].inset)
+        throw new TypeError('Shadow animation requires one existing outer boxShadow.');
+    return shadows[0];
+}
+export function validateDecorationTarget(view, property) {
+    const shadow = property.startsWith('shadow');
+    const z = property === 'elevation' || property === 'translationZ';
+    if ((shadow && isAndroid) || (z && !isAndroid))
+        throw new TypeError(`"${property}" is only supported on ${z ? 'Android' : 'iOS'}.`);
+    if (z)
+        return;
+    if (view.style.clipPath || view.style.cornerShape === 'squircle')
+        throw new TypeError('Decoration animations require circular corners without a clipPath.');
+    for (const keys of [radiusKeys, widthKeys]) {
+        const values = keys.map((key) => dip(view[key]));
+        if (values.some((value) => value !== values[0]))
+            throw new TypeError('Decoration animations require uniform border widths and radii.');
+    }
+    const colors = [
+        view.borderTopColor,
+        view.borderRightColor,
+        view.borderBottomColor,
+        view.borderLeftColor,
+    ].map((color) => color?.argb ?? 0);
+    if (colors.some((color) => color !== colors[0]))
+        throw new TypeError('Decoration animations require uniform border colors.');
+    if (shadow) {
+        const value = singleShadow(view);
+        for (const length of [
+            value.offsetX,
+            value.offsetY,
+            value.blurRadius,
+            value.spreadRadius,
+        ])
+            dip(length);
+    }
+    if (property === 'borderRadius' &&
+        isAndroid &&
+        view.boxShadow &&
+        (!Array.isArray(view.boxShadow) || view.boxShadow.length))
+        throw new TypeError('Animate Android radius with elevation shadows; CSS boxShadow caches its shape.');
+}
+export function validateDecorationFrames(property, frames) {
+    if (frames.some((value) => value !== null && clampDecoration(property, value) !== value))
+        throw new RangeError(`Invalid keyframes for "${property}".`);
+}
+export function clampDecoration(property, value) {
+    if (property === 'shadowOpacity')
+        return Math.max(0, Math.min(1, value));
+    return property === 'borderRadius' ||
+        property === 'borderWidth' ||
+        property === 'shadowRadius' ||
+        property === 'elevation'
+        ? Math.max(0, value)
+        : value;
+}
+export function readDecoration(view, property) {
+    if (property === 'borderRadius') {
+        const radius = !isAndroid ? view.nativeViewProtected?.layer?.cornerRadius : undefined;
+        return typeof radius === 'number' ? radius : dip(view.borderTopLeftRadius);
+    }
+    if (property === 'borderWidth')
+        return dip(view.borderTopWidth);
+    if (property === 'elevation')
+        return view.nativeViewProtected?.getElevation
+            ? view.nativeViewProtected.getElevation() / Utils.layout.getDisplayDensity()
+            : view.androidElevation || 0;
+    if (property === 'translationZ')
+        return (view.nativeViewProtected?.getTranslationZ?.() / Utils.layout.getDisplayDensity() ||
+            0);
+    const shadow = singleShadow(view);
+    if (property === 'shadowOpacity')
+        return ((shadow.color?.argb ?? 0xff000000) >>> 24) / 255;
+    return property === 'shadowRadius'
+        ? dip(shadow.blurRadius) / 2
+        : dip(property === 'shadowOffsetX' ? shadow.offsetX : shadow.offsetY);
+}
+export function writeDecoration(view, property, raw) {
+    const value = clampDecoration(property, raw);
+    writing.add(view);
+    try {
+        if (property === 'borderRadius' || property === 'borderWidth')
+            view[property] = value;
+        else if (property === 'elevation')
+            view.androidElevation = value;
+        else if (property === 'translationZ')
+            view.nativeViewProtected?.setTranslationZ?.(value * Utils.layout.getDisplayDensity());
+        else {
+            const shadow = { ...singleShadow(view) };
+            if (property === 'shadowOpacity')
+                shadow.color = new Color(((Math.round(value * 255) << 24) | ((shadow.color?.argb ?? 0) & 0xffffff)) >>>
+                    0);
+            else if (property === 'shadowRadius')
+                shadow.blurRadius = value * 2;
+            else if (property === 'shadowOffsetX')
+                shadow.offsetX = value;
+            else
+                shadow.offsetY = value;
+            view.boxShadow = [shadow];
+            if (!isAndroid)
+                preserveZeroShadow(view);
+        }
+    }
+    finally {
+        writing.delete(view);
+    }
+}
+//# sourceMappingURL=decoration.js.map

package/dist/decoration.js.map

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

package/dist/drag-input.d.ts

@@ -0,0 +1,15 @@
+import { type PanGestureEventData, type View } from '@nativescript/core';
+/** Android's raw coordinates avoid feedback from translating the touched view. */
+export declare class DragInput {
+    private samples;
+    private lastMoved;
+    reset(): void;
+    read(event: PanGestureEventData, view: View): {
+        x: number;
+        y: number;
+        velocityX: number;
+        velocityY: number;
+        cancelled: boolean;
+    };
+}
+//# sourceMappingURL=drag-input.d.ts.map

package/dist/drag-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag-input.d.ts","sourceRoot":"","sources":["../src/drag-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,mBAAmB,EAAE,KAAK,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAS/E,kFAAkF;AAClF,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,SAAS,CAAI;IACrB,KAAK,SAGJ;IACD,IAAI,CAAC,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,IAAI;QA4CvC,CAAC;QACD,CAAC;QACD,SAAS;QACT,SAAS;QACT,SAAS;MAOZ;CACF"}

package/dist/drag-input.js

@@ -0,0 +1,66 @@
+import { Utils } from '@nativescript/core';
+import { getDriver } from './driver/index.js';
+/** Android's raw coordinates avoid feedback from translating the touched view. */
+export class DragInput {
+    samples = [];
+    lastMoved = 0;
+    reset() {
+        this.samples = [];
+        this.lastMoved = 0;
+    }
+    read(event, view) {
+        const ios = event.ios;
+        const android = event.android?.current;
+        const parent = view.parent?.nativeViewProtected ?? view.nativeViewProtected;
+        const delta = ios
+            ? ios.translationInView(parent)
+            : { x: event.deltaX, y: event.deltaY };
+        const density = Utils.layout.getDisplayDensity();
+        const sample = android
+            ? {
+                x: android.getRawX() / density,
+                y: android.getRawY() / density,
+                time: Number(android.getEventTime()),
+            }
+            : { ...delta, time: getDriver().now() };
+        if (Number.isFinite(sample.x) &&
+            Number.isFinite(sample.y) &&
+            Number.isFinite(sample.time)) {
+            const previous = this.samples.at(-1);
+            if (!previous || sample.x !== previous.x || sample.y !== previous.y)
+                this.lastMoved = sample.time;
+            // Replace duplicate times (Android sends began + changed for the same event).
+            if (this.samples.at(-1)?.time === sample.time)
+                this.samples.pop();
+            this.samples.push(sample);
+            while (this.samples.length > 2 && this.samples[1].time < sample.time - 100)
+                this.samples.shift();
+        }
+        const first = this.samples[0];
+        const elapsed = first ? sample.time - first.time : 0;
+        // UIKit may retain its last movement velocity when the finger holds still
+        // before lifting. A stale velocity must not turn that hold into a fling.
+        const nativeVelocity = ios
+            ? sample.time - this.lastMoved > 100
+                ? { x: 0, y: 0 }
+                : ios.velocityInView(parent)
+            : undefined;
+        const velocity = nativeVelocity ?? {
+            x: elapsed > 0 && elapsed <= 150 ? ((sample.x - first.x) * 1000) / elapsed : 0,
+            y: elapsed > 0 && elapsed <= 150 ? ((sample.y - first.y) * 1000) / elapsed : 0,
+        };
+        const action = android?.getActionMasked();
+        return {
+            x: delta.x,
+            y: delta.y,
+            velocityX: Number.isFinite(velocity.x) ? velocity.x : 0,
+            velocityY: Number.isFinite(velocity.y) ? velocity.y : 0,
+            cancelled: event.state === 0 ||
+                action === 3 ||
+                action === 5 ||
+                action === 6 ||
+                (android ? android.getPointerCount() > 1 : (ios?.numberOfTouches ?? 1) > 1),
+        };
+    }
+}
+//# sourceMappingURL=drag-input.js.map

package/dist/drag-input.js.map

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

package/dist/drag-physics.d.ts

@@ -0,0 +1,20 @@
+export interface DragCurve {
+    type: 'drag';
+    velocity: number;
+    friction: number;
+    bounds: readonly [number, number];
+    snap?: readonly number[];
+    rubberband: boolean;
+}
+export declare const clampDrag: (value: number, [min, max]: readonly [number, number]) => number;
+/** Bounded resistance; coordinates and the resistance length are DIPs. */
+export declare function resistDrag(value: number, bounds: readonly [number, number], length: number): number;
+/** Recover the finger-space origin when grabbing an already rubberbanded pose. */
+export declare function resumeDrag(value: number, bounds: readonly [number, number], length: number): {
+    origin: number;
+    length: number;
+};
+export declare function dragDestination(from: number, curve: DragCurve): number;
+/** One precomputed motion. Native keyframes play both the coast and edge recovery. */
+export declare function solveDragRelease(from: number, curve: DragCurve): import("./decay.js").DecayMotion;
+//# sourceMappingURL=drag-physics.d.ts.map

package/dist/drag-physics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag-physics.d.ts","sourceRoot":"","sources":["../src/drag-physics.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,eAAO,MAAM,SAAS,UAAW,MAAM,cAAc,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,WACzC,CAAA;AAErC,0EAA0E;AAC1E,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,MAAM,EAAE,MAAM,UAKf;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,MAAM,EAAE,MAAM;;;EAQf;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,UAO7D;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,oCA2D9D"}

package/dist/drag-physics.js

@@ -0,0 +1,75 @@
+import { solveDecay } from './decay.js';
+import { solveSpring, springPhysics } from './spring.js';
+export const clampDrag = (value, [min, max]) => Math.max(min, Math.min(max, value));
+/** Bounded resistance; coordinates and the resistance length are DIPs. */
+export function resistDrag(value, bounds, length) {
+    const edge = clampDrag(value, bounds);
+    const distance = value - edge;
+    return edge + (distance / (1 + Math.abs(distance) / length)) * 0.55;
+}
+/** Recover the finger-space origin when grabbing an already rubberbanded pose. */
+export function resumeDrag(value, bounds, length) {
+    const edge = clampDrag(value, bounds);
+    const distance = value - edge;
+    // A native edge spring or external owner can exceed the usual resistance range.
+    // Expand it for this gesture so every finite visible pose has a stable inverse.
+    length = Math.max(length, Math.abs(distance) * 4);
+    return { origin: edge + distance / (0.55 - Math.abs(distance) / length), length };
+}
+export function dragDestination(from, curve) {
+    const projected = solveDecay(from, curve.velocity, curve.friction, 0.25).to;
+    if (curve.snap)
+        return curve.snap.reduce((best, point) => Math.abs(point - projected) < Math.abs(best - projected) ? point : best);
+    return clampDrag(projected, curve.bounds);
+}
+/** One precomputed motion. Native keyframes play both the coast and edge recovery. */
+export function solveDragRelease(from, curve) {
+    const to = dragDestination(from, curve);
+    const coast = solveDecay(from, curve.velocity, curve.friction, 0.25);
+    const edge = clampDrag(from, curve.bounds);
+    const springTo = (start, target, velocity) => {
+        const motion = solveSpring(springPhysics({ duration: 500, bounce: 0 }), start, target, velocity, 0.25);
+        const position = (time) => {
+            const value = time >= motion.duration ? target : motion.position(time);
+            return curve.rubberband ? value : clampDrag(value, curve.bounds);
+        };
+        return {
+            ...motion,
+            position,
+            velocity: (time) => {
+                const raw = motion.position(time);
+                return time >= motion.duration ||
+                    (!curve.rubberband && raw !== clampDrag(raw, curve.bounds))
+                    ? 0
+                    : motion.velocity(time);
+            },
+        };
+    };
+    if (curve.snap || from !== edge)
+        return {
+            ...springTo(from, curve.snap ? to : edge, curve.velocity),
+            to: curve.snap ? to : edge,
+        };
+    if (to === coast.to)
+        return coast;
+    // Reach the boundary with the decay's actual velocity, then absorb that velocity.
+    const rate = -Math.log(curve.friction);
+    const collision = Math.max(0, -Math.log1p((-(to - from) * rate * 1000) / curve.velocity) / rate);
+    const recovery = springTo(to, to, coast.velocity(collision));
+    const duration = collision + (curve.rubberband ? recovery.duration : 0);
+    return {
+        to,
+        duration,
+        position: (time) => time >= duration
+            ? to
+            : time < collision
+                ? coast.position(time)
+                : recovery.position(time - collision),
+        velocity: (time) => time >= duration
+            ? 0
+            : time < collision
+                ? coast.velocity(time)
+                : recovery.velocity(time - collision),
+    };
+}
+//# sourceMappingURL=drag-physics.js.map

package/dist/drag-physics.js.map

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

package/dist/drag.d.ts

@@ -0,0 +1,58 @@
+import type { PlaybackAnimation } from './playback.js';
+import type { Target } from './types.js';
+export interface DragPoint {
+    readonly x: number;
+    readonly y: number;
+}
+export interface DragEvent extends DragPoint {
+    /** DIPs per second, in the same coordinates as the translation. */
+    readonly velocityX: number;
+    readonly velocityY: number;
+}
+export interface DragRelease extends DragEvent {
+    readonly target: DragPoint;
+    /** False on interruption/cancellation. Check before applying completion effects. */
+    readonly animation: PlaybackAnimation;
+}
+export interface DragOptions {
+    /** Defaults to both. One finger only. */
+    axis?: 'x' | 'y' | 'both';
+    /** Absolute translateX/translateY limits in DIPs; omitted edges are unbounded. */
+    bounds?: {
+        left?: number;
+        right?: number;
+        top?: number;
+        bottom?: number;
+    };
+    /** Closest stop to the projected landing. Arrays apply to every enabled axis. */
+    snap?: readonly number[] | {
+        x?: readonly number[];
+        y?: readonly number[];
+    };
+    /** Resist beyond bounds and spring back. Defaults to false (hard limits). */
+    rubberband?: boolean;
+    /** Decay retention per millisecond. Defaults to 0.998. */
+    friction?: number;
+    onStart?: (event: DragEvent) => void;
+    onMove?: (event: DragEvent) => void;
+    onRelease?: (event: DragRelease) => void;
+    onCancel?: (event: DragEvent) => void;
+    onSettle?: (position: DragPoint) => void;
+}
+export interface Drag {
+    readonly dragging: boolean;
+    readonly settling: boolean;
+    readonly paused: boolean;
+    readonly disposed: boolean;
+    /** Current presentation, including a native release animation in flight. */
+    readonly position: DragPoint;
+    /** Cancel contact/release at its visible position, keeping the subscription. */
+    cancel(): void;
+    /** Cancel and detach input. play() accepts new gestures; cancelled work stays cancelled. */
+    pause(): void;
+    play(): void;
+    dispose(): void;
+}
+/** Main-thread pan updates; release physics play through Jolt's native animation drivers. */
+export declare function drag(target: Target, options?: DragOptions): Drag;
+//# sourceMappingURL=drag.d.ts.map

package/dist/drag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag.d.ts","sourceRoot":"","sources":["../src/drag.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CACnB;AACD,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AACD,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,oFAAoF;IACpF,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAA;CACtC;AACD,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,IAAI,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,MAAM,CAAA;IACzB,kFAAkF;IAClF,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACzE,iFAAiF;IACjF,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG;QAAE,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAA;IAC3E,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;IACpC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;IACnC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IACxC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;IACrC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,IAAI,CAAA;CACzC;AACD,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,gFAAgF;IAChF,MAAM,IAAI,IAAI,CAAA;IACd,4FAA4F;IAC5F,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,IAAI,IAAI,CAAA;IACZ,OAAO,IAAI,IAAI,CAAA;CAChB;AAkGD,6FAA6F;AAC7F,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,IAAI,CAcpE"}