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

package/dist/native/index.d.ts

@@ -0,0 +1,6 @@
+export { registerNativeProperty, checkNativeProperty } from '../native-property.js';
+export type { NativeProperty, NativePropertyDefinition } from '../native-property.js';
+export type { NativeSink } from '../native-property-driver.js';
+export { mapKitCoordinate, mapKitCamera, mapLibreCoordinate, mapLibreCamera, sceneKitPose, } from '../native-properties.js';
+export type { Coordinate, MapKitCamera, MapLibreCamera, ScenePose, } from '../native-properties.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/native/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/native/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AACnF,YAAY,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAA;AACrF,YAAY,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAC9D,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,YAAY,GACb,MAAM,yBAAyB,CAAA;AAChC,YAAY,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,SAAS,GACV,MAAM,yBAAyB,CAAA"}

package/dist/native/index.js

@@ -0,0 +1,3 @@
+export { registerNativeProperty, checkNativeProperty } from '../native-property.js';
+export { mapKitCoordinate, mapKitCamera, mapLibreCoordinate, mapLibreCamera, sceneKitPose, } from '../native-properties.js';
+//# sourceMappingURL=index.js.map

package/dist/native/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/native/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAGnF,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,YAAY,GACb,MAAM,yBAAyB,CAAA"}

package/dist/native-properties.d.ts

@@ -0,0 +1,28 @@
+export interface Coordinate {
+    latitude: number;
+    longitude: number;
+}
+export interface MapKitCamera extends Coordinate {
+    altitude: number;
+    pitch: number;
+    heading: number;
+}
+export interface MapLibreCamera extends Coordinate {
+    zoom: number;
+    tilt: number;
+    bearing: number;
+}
+export interface ScenePose {
+    position: readonly [number, number, number];
+    orientation: readonly [number, number, number, number];
+}
+/** Shortest longitude/heading interpolation. Coordinates use a local linear path, not a geodesic. */
+export declare function shortestAngle(from: number, to: number, fraction: number): number;
+export declare const mapKitCoordinate: (target: object) => import("./native-property.js").NativeProperty<Coordinate>;
+export declare const mapKitCamera: (target: object) => import("./native-property.js").NativeProperty<MapKitCamera>;
+export declare const mapLibreCoordinate: (target: object) => import("./native-property.js").NativeProperty<Coordinate>;
+export declare const mapLibreCamera: (target: object) => import("./native-property.js").NativeProperty<MapLibreCamera>;
+/** Unit quaternion slerp; q and -q describe the same orientation. */
+export declare function interpolatePose(a: ScenePose, b: ScenePose, t: number): ScenePose;
+export declare const sceneKitPose: (target: object) => import("./native-property.js").NativeProperty<ScenePose>;
+//# sourceMappingURL=native-properties.d.ts.map

package/dist/native-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-properties.d.ts","sourceRoot":"","sources":["../src/native-properties.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB;AACD,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AACD,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AACD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3C,WAAW,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CACvD;AAED,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAGvE;AAmBD,eAAO,MAAM,gBAAgB,+EAU3B,CAAA;AACF,eAAO,MAAM,YAAY,iFA+BvB,CAAA;AACF,eAAO,MAAM,kBAAkB,+EAU7B,CAAA;AACF,eAAO,MAAM,cAAc,mFA+BzB,CAAA;AAEF,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CA0BhF;AACD,eAAO,MAAM,YAAY,8EA4BvB,CAAA"}

package/dist/native-properties.js

@@ -0,0 +1,154 @@
+import { registerNativeProperty } from './native-property.js';
+/** Shortest longitude/heading interpolation. Coordinates use a local linear path, not a geodesic. */
+export function shortestAngle(from, to, fraction) {
+    const delta = ((((to - from + 180) % 360) + 360) % 360) - 180;
+    return from + delta * fraction;
+}
+function validateCoordinate(value) {
+    if (!Number.isFinite(value.latitude) ||
+        Math.abs(value.latitude) > 90 ||
+        !Number.isFinite(value.longitude))
+        throw new RangeError('Coordinates need latitude in -90..90 and a finite longitude.');
+}
+function coordinate(from, to, t) {
+    return {
+        latitude: Math.max(-90, Math.min(90, from.latitude + (to.latitude - from.latitude) * t)),
+        longitude: shortestAngle(from.longitude, to.longitude, t),
+    };
+}
+export const mapKitCoordinate = registerNativeProperty({
+    name: 'jolt.mapkit/coordinate',
+    units: ['latitude degrees', 'longitude degrees'],
+    platforms: ['ios'],
+    spatial: true,
+    encode: (v) => [v.latitude, v.longitude],
+    decode: (v) => ({ latitude: v[0], longitude: v[1] }),
+    validate: validateCoordinate,
+    interpolate: coordinate,
+    create: (target) => JoltReferenceProperties.mapCoordinate(target),
+});
+export const mapKitCamera = registerNativeProperty({
+    name: 'jolt.mapkit/camera',
+    units: [
+        'latitude degrees',
+        'longitude degrees',
+        'altitude meters',
+        'pitch degrees',
+        'heading degrees',
+    ],
+    platforms: ['ios'],
+    spatial: true,
+    encode: (v) => [v.latitude, v.longitude, v.altitude, v.pitch, v.heading],
+    decode: (v) => ({
+        latitude: v[0],
+        longitude: v[1],
+        altitude: v[2],
+        pitch: v[3],
+        heading: v[4],
+    }),
+    validate(v) {
+        validateCoordinate(v);
+        if (v.altitude < 1 || v.pitch < 0 || v.pitch > 80)
+            throw new RangeError('MapKit camera needs altitude >= 1m and pitch 0..80 degrees.');
+    },
+    interpolate: (a, b, t) => ({
+        ...coordinate(a, b, t),
+        altitude: Math.max(1, a.altitude + (b.altitude - a.altitude) * t),
+        pitch: Math.max(0, Math.min(80, a.pitch + (b.pitch - a.pitch) * t)),
+        heading: shortestAngle(a.heading, b.heading, t),
+    }),
+    create: (target) => JoltReferenceProperties.mapCamera(target),
+});
+export const mapLibreCoordinate = registerNativeProperty({
+    name: 'jolt.maplibre/coordinate',
+    units: ['latitude degrees', 'longitude degrees'],
+    platforms: ['android'],
+    spatial: true,
+    encode: (v) => [v.latitude, v.longitude],
+    decode: (v) => ({ latitude: v[0], longitude: v[1] }),
+    validate: validateCoordinate,
+    interpolate: coordinate,
+    create: (target) => new org.rafaelaugusto.jolt.MapLibrePropertySink(target, false),
+});
+export const mapLibreCamera = registerNativeProperty({
+    name: 'jolt.maplibre/camera',
+    units: [
+        'latitude degrees',
+        'longitude degrees',
+        'zoom level',
+        'tilt degrees',
+        'bearing degrees',
+    ],
+    platforms: ['android'],
+    spatial: true,
+    encode: (v) => [v.latitude, v.longitude, v.zoom, v.tilt, v.bearing],
+    decode: (v) => ({
+        latitude: v[0],
+        longitude: v[1],
+        zoom: v[2],
+        tilt: v[3],
+        bearing: v[4],
+    }),
+    validate(v) {
+        validateCoordinate(v);
+        if (v.zoom < 0 || v.zoom > 24 || v.tilt < 0 || v.tilt > 60)
+            throw new RangeError('MapLibre camera needs zoom 0..24 and tilt 0..60 degrees.');
+    },
+    interpolate: (a, b, t) => ({
+        ...coordinate(a, b, t),
+        zoom: Math.max(0, Math.min(24, a.zoom + (b.zoom - a.zoom) * t)),
+        tilt: Math.max(0, Math.min(60, a.tilt + (b.tilt - a.tilt) * t)),
+        bearing: shortestAngle(a.bearing, b.bearing, t),
+    }),
+    create: (target) => new org.rafaelaugusto.jolt.MapLibrePropertySink(target, true),
+});
+/** Unit quaternion slerp; q and -q describe the same orientation. */
+export function interpolatePose(a, b, t) {
+    const normalize = (q) => {
+        const length = Math.hypot(...q);
+        if (!Number.isFinite(length) || length < 1e-12)
+            throw new RangeError('Orientation must be a nonzero finite quaternion.');
+        return q.map((v) => v / length);
+    };
+    const from = normalize(a.orientation), to = normalize(b.orientation);
+    let dot = from.reduce((sum, v, i) => sum + v * to[i], 0);
+    if (dot < 0) {
+        dot = -dot;
+        for (let i = 0; i < 4; i++)
+            to[i] = -to[i];
+    }
+    const theta = Math.acos(Math.min(1, dot)), sine = Math.sin(theta);
+    const x = sine < 1e-6 ? 1 - t : Math.sin((1 - t) * theta) / sine, y = sine < 1e-6 ? t : Math.sin(t * theta) / sine;
+    return {
+        position: a.position.map((v, i) => v + (b.position[i] - v) * t),
+        orientation: normalize(from.map((v, i) => v * x + to[i] * y)),
+    };
+}
+export const sceneKitPose = registerNativeProperty({
+    name: 'jolt.scenekit/pose',
+    units: [
+        'x scene units',
+        'y scene units',
+        'z scene units',
+        'quaternion x',
+        'quaternion y',
+        'quaternion z',
+        'quaternion w',
+    ],
+    platforms: ['ios'],
+    spatial: true,
+    encode: (v) => [...v.position, ...v.orientation],
+    decode: (v) => ({
+        position: [v[0], v[1], v[2]],
+        orientation: [v[3], v[4], v[5], v[6]],
+    }),
+    validate(v) {
+        if (v.position.length !== 3 ||
+            v.orientation.length !== 4 ||
+            Math.hypot(...v.orientation) < 1e-12)
+            throw new RangeError('Scene pose needs a 3D position and a nonzero quaternion.');
+    },
+    interpolate: interpolatePose,
+    create: (target) => JoltReferenceProperties.scenePose(target),
+});
+//# sourceMappingURL=native-properties.js.map

package/dist/native-properties.js.map

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

package/dist/native-property-driver.d.ts

@@ -0,0 +1,19 @@
+import type { Track } from './track.js';
+/** Opaque compiled JoltPropertySink / PropertySink instance. */
+export type NativeSink = object;
+export interface NativePlayer {
+    control(time: number, paused: boolean): void;
+    cancel(): void;
+}
+export interface NativePropertyDriver {
+    validate(sink: NativeSink, dimensions: number): void;
+    alive(sink: NativeSink): boolean;
+    read(sink: NativeSink): number[];
+    write(sink: NativeSink, values: readonly number[]): void;
+    dispose(sink: NativeSink): void;
+    play(sink: NativeSink, track: Track, samples: readonly (readonly number[])[], final: readonly number[], end: (completed: boolean) => void): NativePlayer;
+}
+/** Test injection; not part of the public package entry. */
+export declare function setNativePropertyDriver(driver: NativePropertyDriver | undefined): void;
+export declare function nativePropertyDriver(): NativePropertyDriver;
+//# sourceMappingURL=native-property-driver.d.ts.map

package/dist/native-property-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-property-driver.d.ts","sourceRoot":"","sources":["../src/native-property-driver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAA;AAC/B,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5C,MAAM,IAAI,IAAI,CAAA;CACf;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACpD,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAA;IAChC,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,CAAA;IAChC,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;IACxD,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;IAC/B,IAAI,CACF,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,EACvC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,GAAG,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,GAChC,YAAY,CAAA;CAChB;AAED,4DAA4D;AAC5D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,QAE/E;AACD,wBAAgB,oBAAoB,IAAI,oBAAoB,CAW3D"}

package/dist/native-property-driver.js

@@ -0,0 +1,69 @@
+import { isAndroid } from '@nativescript/core';
+let override;
+/** Test injection; not part of the public package entry. */
+export function setNativePropertyDriver(driver) {
+    override = driver;
+}
+export function nativePropertyDriver() {
+    if (override)
+        return override;
+    const available = isAndroid
+        ? typeof org !== 'undefined' &&
+            typeof org.rafaelaugusto.jolt.PropertySink?.scalar === 'function'
+        : typeof JoltPropertySink !== 'undefined';
+    if (!available)
+        throw new Error('Native property adapters require the optional @rafaelaugusto/jolt-native plugin. Install it and rebuild the native app.');
+    return isAndroid ? androidDriver : iosDriver;
+}
+function array(values) {
+    const result = Array.create('double', values.length);
+    values.forEach((value, i) => {
+        result[i] = value;
+    });
+    return result;
+}
+const androidDriver = {
+    validate(sink, dimensions) {
+        if (!(sink instanceof org.rafaelaugusto.jolt.PropertySink) ||
+            sink.getDimensions() !== dimensions ||
+            !sink.isCompiled())
+            throw new TypeError('Native adapters require a compiled PropertySink with matching dimensions, not a JavaScript setter.');
+    },
+    alive: (sink) => sink.isAlive(),
+    read(sink) {
+        const values = sink.read();
+        return Array.from({ length: values.length }, (_, i) => values[i]);
+    },
+    write: (sink, values) => sink.write(array(values)),
+    dispose: (sink) => sink.dispose(),
+    play(sink, track, samples, final, end) {
+        const player = new org.rafaelaugusto.jolt.PropertyPlayer(sink, array(track.times), array(samples.flat()), array(final), track.duration, track.delay, Number.isFinite(track.repeat) ? track.repeat : -1, track.reverse, new org.rafaelaugusto.jolt.PropertyPlayer.Listener({ onEnd: end }));
+        return {
+            control: (time, paused) => player.control(time, paused),
+            cancel: () => player.cancel(),
+        };
+    },
+};
+const iosDriver = {
+    validate(sink, dimensions) {
+        if (!(sink instanceof JoltPropertySink) ||
+            sink.dimensions !== dimensions ||
+            !sink.compiled)
+            throw new TypeError('Native adapters require a compiled JoltPropertySink with matching dimensions, not a JavaScript setter.');
+    },
+    alive: (sink) => sink.alive,
+    read(sink) {
+        const values = sink.read();
+        return Array.from({ length: values.count }, (_, i) => values.objectAtIndex(i));
+    },
+    write: (sink, values) => sink.write(NSArray.arrayWithArray([...values])),
+    dispose: (sink) => sink.dispose(),
+    play(sink, track, samples, final, end) {
+        const player = JoltPropertyPlayer.startSinkTimesValuesFinalValueDurationDelayRepeatReverseCompletion(sink, NSArray.arrayWithArray([...track.times]), NSArray.arrayWithArray(samples.flat()), NSArray.arrayWithArray([...final]), track.duration, track.delay, track.repeat, track.reverse, end);
+        return {
+            control: (time, paused) => player.controlPaused(time, paused),
+            cancel: () => player.cancel(),
+        };
+    },
+};
+//# sourceMappingURL=native-property-driver.js.map

package/dist/native-property-driver.js.map

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

package/dist/native-property.d.ts

@@ -0,0 +1,35 @@
+import type { DerivedValue } from './motion-value.js';
+import type { PlaybackAnimation } from './playback.js';
+import { type Transition, type SpringName } from './transition.js';
+import { type NativeSink } from './native-property-driver.js';
+export interface NativePropertyDefinition<T> {
+    /** Namespaced identity, e.g. 'acme.chart/reveal'. One registration per name. */
+    readonly name: string;
+    readonly units: readonly string[];
+    readonly platforms: readonly ('ios' | 'android')[];
+    /** Spatial properties jump to their destination under reduced motion. */
+    readonly spatial?: boolean;
+    encode(value: T): readonly number[];
+    decode(value: readonly number[]): T;
+    /** Called once per sampled keyframe in JS, never per native frame. */
+    interpolate?(from: T, to: T, fraction: number): T;
+    validate?(value: T): void;
+    /** Must return a compiled native sink, not a JavaScript implementation of its methods. */
+    create(target: object): NativeSink;
+}
+export interface NativeProperty<T> {
+    readonly name: string;
+    get(): T;
+    set(value: T): void;
+    animate(to: T, options?: Transition | SpringName): PlaybackAnimation;
+    /** Sample a pure mapping at setup/boundaries, then write the property entirely in native code. */
+    bind(value: DerivedValue, map: (value: number) => T): () => void;
+    stop(): void;
+    /** Release this owner's native resources. Call before destroying the SDK target. */
+    dispose(): void;
+}
+/** Optional plugin registry. No SDK is loaded until its adapter creates a target. */
+export declare function registerNativeProperty<T>(definition: NativePropertyDefinition<T>): (target: object) => NativeProperty<T>;
+/** Reusable conformance checks for setup/command behavior; frame/lifecycle checks require a native app. */
+export declare function checkNativeProperty<T>(property: NativeProperty<T>, value: T): T;
+//# sourceMappingURL=native-property.d.ts.map

package/dist/native-property.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-property.d.ts","sourceRoot":"","sources":["../src/native-property.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAGtD,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,6BAA6B,CAAA;AAEpC,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,GAAG,SAAS,CAAC,EAAE,CAAA;IAClD,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,MAAM,EAAE,CAAA;IACnC,MAAM,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,CAAA;IACnC,sEAAsE;IACtE,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAA;IACjD,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;IACzB,0FAA0F;IAC1F,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;CACnC;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,GAAG,IAAI,CAAC,CAAA;IACR,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;IACnB,OAAO,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,iBAAiB,CAAA;IACpE,kGAAkG;IAClG,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,GAAG,MAAM,IAAI,CAAA;IAChE,IAAI,IAAI,IAAI,CAAA;IACZ,oFAAoF;IACpF,OAAO,IAAI,IAAI,CAAA;CAChB;AASD,qFAAqF;AACrF,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,UAAU,EAAE,wBAAwB,CAAC,CAAC,CAAC,GACtC,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,CAAC,CAAC,CAAC,CAuBvC;AAgPD,2GAA2G;AAC3G,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAQ3E"}

package/dist/native-property.js

@@ -0,0 +1,277 @@
+import { isAndroid, Trace } from '@nativescript/core';
+import { reducedMotion } from './config.js';
+import { valuePlayback } from './motion-value.js';
+import { TimedAnimation } from './timed-animation.js';
+import { createTrack, instantTrack } from './track.js';
+import { resolveTransition, springs, } from './transition.js';
+import { nativePropertyDriver, } from './native-property-driver.js';
+const definitions = new Set();
+const owners = new WeakMap();
+/** Optional plugin registry. No SDK is loaded until its adapter creates a target. */
+export function registerNativeProperty(definition) {
+    if (!/^[\w.-]+\/[\w.-]+$/.test(definition.name))
+        throw new TypeError('Native property names must be namespaced: plugin/property.');
+    if (definitions.has(definition.name))
+        throw new Error(`Native property "${definition.name}" is already registered.`);
+    if (!definition.units.length ||
+        definition.units.some((unit) => typeof unit !== 'string' || !unit))
+        throw new TypeError('Describe the units of every native property component.');
+    if (!definition.platforms.length ||
+        definition.platforms.some((p) => p !== 'ios' && p !== 'android'))
+        throw new TypeError('Declare supported native platforms.');
+    if (typeof definition.create !== 'function' ||
+        typeof definition.encode !== 'function' ||
+        typeof definition.decode !== 'function')
+        throw new TypeError('A native property needs create(), encode() and decode().');
+    definitions.add(definition.name);
+    return (target) => new PropertyTarget(target, definition);
+}
+class PropertyTarget {
+    target;
+    definition;
+    sink;
+    owned = new Set();
+    disposed = false;
+    name;
+    constructor(target, definition) {
+        this.target = target;
+        this.definition = definition;
+        this.name = definition.name;
+        if (!target || (typeof target !== 'object' && typeof target !== 'function'))
+            throw new TypeError('A native property needs a native target.');
+        const platform = isAndroid ? 'android' : 'ios';
+        if (!definition.platforms.includes(platform))
+            throw new Error(`${this.name} is unavailable on ${platform}.`);
+        const driver = nativePropertyDriver();
+        this.sink = definition.create(target);
+        try {
+            driver.validate(this.sink, definition.units.length);
+        }
+        catch (error) {
+            try {
+                driver.dispose(this.sink);
+            }
+            catch { }
+            throw error;
+        }
+    }
+    alive() {
+        if (this.disposed)
+            throw new Error(`${this.name} has been disposed.`);
+        if (!nativePropertyDriver().alive(this.sink))
+            throw new Error(`${this.name} has lost its native target.`);
+    }
+    vector(value) {
+        this.definition.validate?.(value);
+        const numbers = [...this.definition.encode(value)];
+        if (numbers.length !== this.definition.units.length ||
+            numbers.some((n) => !Number.isFinite(n)))
+            throw new TypeError(`${this.name} expects ${this.definition.units.length} finite components.`);
+        return numbers;
+    }
+    get() {
+        this.alive();
+        return this.definition.decode(nativePropertyDriver().read(this.sink));
+    }
+    set(value) {
+        this.alive();
+        const vector = this.vector(value);
+        this.owner()?.stop();
+        nativePropertyDriver().write(this.sink, vector);
+    }
+    owner() {
+        return this.target ? owners.get(this.target)?.get(this.name) : undefined;
+    }
+    claim(owner) {
+        this.owner()?.stop();
+        let map = owners.get(this.target);
+        if (!map)
+            owners.set(this.target, (map = new Map()));
+        map.set(this.name, owner);
+        this.owned.add(owner);
+    }
+    release(owner) {
+        if (this.target && this.owner() === owner)
+            owners.get(this.target)?.delete(this.name);
+        this.owned.delete(owner);
+    }
+    animate(to, options = {}) {
+        this.alive();
+        const from = this.get(), first = this.vector(from), last = this.vector(to);
+        if (typeof options === 'object' && 'layer' in options)
+            throw new TypeError('Native property adapters do not support layers; bind a layered scalar value instead.');
+        if (typeof options === 'string' && !Object.hasOwn(springs, options))
+            throw new TypeError(`Unknown spring "${options}".`);
+        const transition = resolveTransition(typeof options === 'string' ? springs[options] : options, 'opacity', 2);
+        const velocity = this.owner()?.velocity();
+        const delta = last.map((v, i) => v - first[i]);
+        const length = delta.reduce((s, v) => s + v * v, 0);
+        const speed = length && velocity
+            ? delta.reduce((s, v, i) => s + v * (velocity[i] ?? 0), 0) / length
+            : 0;
+        const track = dense(this.definition.spatial && reducedMotion()
+            ? instantTrack('opacity', 1)
+            : createTrack('opacity', [0, 1], transition, speed));
+        const at = (fraction) => this.vector(this.definition.interpolate
+            ? this.definition.interpolate(from, to, fraction)
+            : this.definition.decode(first.map((v, i) => v + delta[i] * fraction)));
+        const samples = track.values.map(at);
+        const final = at(track.to);
+        let player;
+        const animation = new TimedAnimation(track.end, track.arrival, (time, paused) => {
+            player?.control(time, paused);
+        }, (completed) => {
+            try {
+                if (completed && nativePropertyDriver().alive(this.sink))
+                    nativePropertyDriver().write(this.sink, final);
+            }
+            finally {
+                player?.cancel();
+                player = undefined;
+                this.release(owner);
+            }
+        });
+        const owner = {
+            stop: () => animation.stop(),
+            velocity: () => animation.paused
+                ? first.map(() => 0)
+                : at(track.valueAt(animation.time + 0.5)).map((v, i) => (v - at(track.valueAt(animation.time - 0.5))[i]) * 1000),
+        };
+        this.claim(owner);
+        try {
+            if (track.end > 0) {
+                player = nativePropertyDriver().play(this.sink, track, samples, final, (completed) => {
+                    if (!completed)
+                        animation.stop();
+                });
+                if (animation.done) {
+                    player.cancel();
+                    player = undefined;
+                }
+                else
+                    player.control(animation.time, false);
+            }
+            animation.start();
+        }
+        catch (error) {
+            animation.stop();
+            throw error;
+        }
+        return animation;
+    }
+    bind(value, map) {
+        this.alive();
+        if (typeof map !== 'function')
+            throw new TypeError('A native binding needs a pure value mapping.');
+        const source = valuePlayback(value);
+        let player;
+        let off = () => { };
+        let stopped = false;
+        const prepare = () => {
+            const state = source.snapshot();
+            state.track = dense(state.track);
+            const spatial = this.definition.spatial && reducedMotion();
+            const samples = state.track.values.map((v) => this.vector(map(v)));
+            const current = this.vector(map(spatial ? state.track.to : state.value));
+            const final = this.vector(map(state.track.to));
+            return { ...state, samples, current, final, running: state.running && !spatial };
+        };
+        const initial = prepare(); // Validate all samples before interrupting another owner.
+        const owner = {
+            stop: () => {
+                if (stopped)
+                    return;
+                stopped = true;
+                off();
+                player?.cancel();
+                player = undefined;
+                this.release(owner);
+            },
+            velocity: () => this.definition.units.map(() => 0),
+        };
+        const apply = (state) => {
+            player?.cancel();
+            player = undefined;
+            if (!state.running)
+                nativePropertyDriver().write(this.sink, state.current);
+            else {
+                player = nativePropertyDriver().play(this.sink, state.track, state.samples, state.final, (completed) => {
+                    if (!completed)
+                        owner.stop();
+                });
+                if (stopped) {
+                    player.cancel();
+                    player = undefined;
+                }
+                else
+                    player.control(source.snapshot().elapsed, state.paused);
+            }
+        };
+        this.claim(owner);
+        try {
+            off = source.subscribe(() => {
+                if (stopped)
+                    return;
+                try {
+                    this.alive();
+                    apply(prepare());
+                }
+                catch (error) {
+                    owner.stop();
+                    Trace.write(`Jolt native binding failed: ${String(error)}`, Trace.categories.Error, Trace.messageType.error);
+                }
+            });
+            apply(initial);
+        }
+        catch (error) {
+            owner.stop();
+            throw error;
+        }
+        return owner.stop;
+    }
+    stop() {
+        for (const owner of [...this.owned])
+            owner.stop();
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.stop();
+        this.disposed = true;
+        nativePropertyDriver().dispose(this.sink);
+        this.target = undefined;
+    }
+}
+/** Reusable conformance checks for setup/command behavior; frame/lifecycle checks require a native app. */
+export function checkNativeProperty(property, value) {
+    const previous = property.get();
+    try {
+        property.set(value);
+        return property.get();
+    }
+    finally {
+        property.set(previous);
+    }
+}
+/** Uniform samples also capture nonlinear compound interpolation and pure binding maps. */
+function dense(track) {
+    if (track.duration === 0)
+        return track;
+    const count = Math.max(1, Math.min(6000, Math.ceil((track.duration * 60) / 1000)));
+    const times = [
+        ...new Set([
+            ...track.times,
+            ...Array.from({ length: count + 1 }, (_, i) => i / count),
+        ]),
+    ].sort((a, b) => a - b);
+    return {
+        ...track,
+        times,
+        values: times.map((time) => time === 1
+            ? track.values.at(-1)
+            : time === 0
+                ? track.values[0]
+                : track.valueAt(track.delay + time * track.duration)),
+    };
+}
+//# sourceMappingURL=native-property.js.map