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

package/dist/size.js

@@ -0,0 +1,251 @@
+import { Application } from '@nativescript/core';
+import { toView } from './animate.js';
+import { onReducedMotion, reducedMotion } from './config.js';
+import { getDriver } from './driver/index.js';
+import { createClock } from './playback.js';
+import { createTrack } from './track.js';
+import { resolveTransition, springs, } from './transition.js';
+import { dimension, sizeLayout, } from './size-layout.js';
+const owners = new WeakMap();
+export function animateSize(target, dimensions, changeOrOptions, options) {
+    const view = toView(target);
+    if (!dimensions || typeof dimensions !== 'object' || Array.isArray(dimensions))
+        throw new TypeError('animateSize takes a width/height object.');
+    const axes = Object.keys(dimensions);
+    if (!axes.length || axes.some((axis) => axis !== 'width' && axis !== 'height'))
+        throw new TypeError('animateSize needs width and/or height.');
+    for (const axis of axes)
+        dimension(dimensions[axis], axis);
+    const destination = { ...dimensions };
+    const change = typeof changeOrOptions === 'function' ? changeOrOptions : undefined;
+    if (change?.constructor.name === 'AsyncFunction')
+        throw new TypeError('animateSize changes must be synchronous.');
+    const transition = normalize(change ? options : changeOrOptions);
+    // Solve before ownership changes, including custom easing/physical-spring validation.
+    const validation = createTrack('x', [0, 100], transition, 0);
+    if (!Number.isFinite(validation.end) || !validation.values.every(Number.isFinite))
+        throw new RangeError('animateSize needs a finite curve with finite samples.');
+    const previous = owners.get(view);
+    const driver = getDriver();
+    const layout = sizeLayout(view, axes, previous?.axes, () => {
+        const frame = driver.layoutFrame?.(view);
+        return frame ? { width: frame.width, height: frame.height } : view.getActualSize();
+    });
+    // Release the previous overlay only after every caller-supplied input was validated.
+    const start = layout.read();
+    previous?.animation.stop({ restore: true });
+    let resolve;
+    let reject;
+    const finished = new Promise((done, fail) => {
+        resolve = done;
+        reject = fail;
+    });
+    let settled = false;
+    let paused = false;
+    let initialized = false;
+    let cancelFrame;
+    let unwatch;
+    let clock;
+    let tracks = new Map();
+    let endpoint;
+    const cleanup = () => {
+        cancelFrame?.();
+        cancelFrame = undefined;
+        clock?.cancel();
+        clock = undefined;
+        unwatch?.();
+        layout.dispose();
+        view.off('unloaded', unloaded);
+        Application.off(Application.suspendEvent, unloaded);
+        if (owners.get(view)?.animation === animation)
+            owners.delete(view);
+    };
+    const finish = (success, error) => {
+        if (settled)
+            return;
+        settled = true;
+        cleanup();
+        if (error !== undefined)
+            reject(error);
+        else
+            resolve(success);
+    };
+    const complete = () => {
+        layout.commit(destination);
+        layout.layout();
+        finish(true);
+    };
+    const stop = (restore = false) => {
+        if (settled)
+            return;
+        layout.commit(restore ? undefined : layout.read());
+        finish(false);
+        view.requestLayout();
+    };
+    function unloaded() {
+        stop(true);
+    }
+    const schedule = () => {
+        if (!cancelFrame && !settled && !paused)
+            cancelFrame = driver.frame(tick);
+    };
+    function tick() {
+        cancelFrame = undefined;
+        if (settled || paused)
+            return;
+        try {
+            if (!view.isLoaded || view.visibility === 'collapse' || !view.nativeViewProtected) {
+                stop(true);
+                return;
+            }
+            const next = layout.measure(destination);
+            if (settled)
+                return;
+            if (axes.some((axis) => !Number.isFinite(next[axis]) || next[axis] < 0))
+                throw new Error('animateSize measured an invalid native size.');
+            if (reducedMotion()) {
+                complete();
+                return;
+            }
+            if (!initialized &&
+                axes.every((axis) => Math.abs(next[axis] - start[axis]) < 0.5)) {
+                complete();
+                return;
+            }
+            const elapsed = clock?.time() ?? 0;
+            if (!endpoint ||
+                axes.some((axis) => Math.abs(next[axis] - endpoint[axis]) > 0.5)) {
+                const from = initialized ? layout.read() : start;
+                const fresh = new Map();
+                for (const axis of axes)
+                    fresh.set(axis, createTrack('x', [from[axis], next[axis]], initialized ? { ...transition, delay: 0 } : transition, tracks.get(axis)?.velocityAt(elapsed) ?? 0));
+                tracks = fresh;
+                endpoint = next;
+                clock?.cancel();
+                const end = Math.max(...[...tracks.values()].map((track) => track.end));
+                clock = driver.clock?.(end) ?? createClock(() => driver.now());
+                initialized = true;
+            }
+            const time = clock.time();
+            if ([...tracks.values()].every((track) => time >= track.end)) {
+                complete();
+                return;
+            }
+            const values = {};
+            for (const [axis, track] of tracks)
+                values[axis] = Math.max(0, track.valueAt(time));
+            layout.write(values);
+            layout.layout();
+            if (settled)
+                return;
+            schedule();
+        }
+        catch (error) {
+            layout.commit();
+            view.requestLayout();
+            finish(false, error);
+        }
+    }
+    const animation = {
+        finished,
+        then: (done, fail) => finished.then(done, fail),
+        get paused() {
+            return paused;
+        },
+        stop: (options) => stop(options?.restore === true),
+        pause() {
+            if (settled || paused)
+                return;
+            paused = true;
+            clock?.pause();
+            cancelFrame?.();
+            cancelFrame = undefined;
+        },
+        play() {
+            if (settled || !paused)
+                return;
+            paused = false;
+            clock?.play();
+            schedule();
+        },
+    };
+    owners.set(view, { animation, axes });
+    try {
+        layout.watch(() => stop(true));
+        layout.write(start);
+        view.on('unloaded', unloaded);
+        Application.on(Application.suspendEvent, unloaded);
+        unwatch = onReducedMotion((reduced) => {
+            if (reduced && !settled) {
+                try {
+                    complete();
+                }
+                catch (error) {
+                    finish(false, error);
+                }
+            }
+        });
+        const result = change?.();
+        if (result && typeof result.then === 'function')
+            throw new TypeError('animateSize changes must be synchronous.');
+        if (!view.isLoaded || view.visibility === 'collapse' || !layout.ready()) {
+            layout.commit(destination);
+            finish(false);
+        }
+        else
+            schedule();
+    }
+    catch (error) {
+        stop(true);
+        throw error;
+    }
+    return animation;
+}
+function normalize(input) {
+    if (typeof input === 'string') {
+        if (!Object.hasOwn(springs, input))
+            throw new TypeError(`Unknown size spring "${input}".`);
+        input = springs[input];
+    }
+    if (input !== undefined &&
+        (!input || typeof input !== 'object' || Array.isArray(input)))
+        throw new TypeError('Invalid animateSize options.');
+    const allowed = new Set([
+        'type',
+        'duration',
+        'ease',
+        'stiffness',
+        'damping',
+        'mass',
+        'bounce',
+        'velocity',
+        'delay',
+    ]);
+    for (const [key, value] of Object.entries(input ?? {})) {
+        if (!allowed.has(key))
+            throw new TypeError(`Unsupported animateSize option "${key}"; repeat and seek are not supported.`);
+        if (value === undefined)
+            continue;
+        if (key !== 'type' &&
+            key !== 'ease' &&
+            (typeof value !== 'number' || !Number.isFinite(value)))
+            throw new RangeError(`animateSize ${key} must be finite.`);
+        if (key === 'type' && value !== 'spring' && value !== 'tween')
+            throw new TypeError('Invalid size transition type.');
+        if (typeof value === 'number') {
+            if (['duration', 'delay', 'damping'].includes(key) && value < 0)
+                throw new RangeError(`${key} must be nonnegative.`);
+            if (['mass', 'stiffness'].includes(key) && value <= 0)
+                throw new RangeError(`${key} must be positive.`);
+            if (key === 'bounce' && (value < -1 || value > 1))
+                throw new RangeError('bounce must be between -1 and 1.');
+        }
+    }
+    const resolved = resolveTransition(input ?? {}, 'x', 2);
+    if (resolved.curve.type === 'spring' &&
+        input?.duration === 0 &&
+        !('stiffness' in input || 'damping' in input || 'mass' in input))
+        throw new RangeError('Use a zero-duration tween for immediate sizing.');
+    return resolved;
+}
+//# sourceMappingURL=size.js.map

package/dist/size.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rafaelaugusto/jolt",
-  "version": "0.1.0-beta.14",
+  "version": "0.1.0-beta.15",
   "description": "Native animations for NativeScript: presets, springs, keyframes and stagger in one call.",
   "keywords": [
     "nativescript",

package/src/index.ts

@@ -104,3 +104,5 @@ export type {
 
 export { animateLayout } from './layout.js'
 export type { LayoutOptions } from './layout.js'
+export { animateSize } from './size.js'
+export type { SizeAnimation, SizeDimensions, SizeOptions } from './size.js'

package/src/ios-plugin.d.ts

@@ -108,6 +108,9 @@ declare class JoltPropertyPlayer extends NSObject {
   cancel(): void
 }
 declare class JoltReferenceProperties extends NSObject {
+  static sceneFieldOfView(camera: NSObject): JoltPropertySink
+  static sceneCameraSinkCount(): number
+  static sceneCameraWriteCount(): number
   static mapCoordinate(target: NSObject): JoltPropertySink
   static mapCamera(target: NSObject): JoltPropertySink
   static scenePose(target: NSObject): JoltPropertySink

package/src/motion-scope.ts

@@ -3,6 +3,7 @@ import { press } from './press.js'
 import { drag } from './drag.js'
 import { gradient } from './gradient.js'
 import { animateLayout, type LayoutOptions } from './layout.js'
+import { animateSize, type SizeDimensions, type SizeOptions } from './size.js'
 import type { SpringName } from './transition.js'
 import { sequence, timeline } from './sequence.js'
 import {
@@ -35,6 +36,7 @@ export interface MotionScope {
   /** Owned handles/subscriptions, including suspended subscription factories. */
   readonly size: number
   animateLayout: typeof animateLayout
+  animateSize: typeof animateSize
   animate: typeof animate
   decay: typeof decay
   sequence: typeof sequence
@@ -195,6 +197,18 @@ export function motionScope(): MotionScope {
     },
     animate: ((...args: Parameters<typeof animate>) =>
       startOwned(() => animate(...args))) as typeof animate,
+    animateSize(
+      target: Target,
+      dimensions: SizeDimensions,
+      changeOrOptions?: (() => void) | SizeOptions | SpringName,
+      options?: SizeOptions | SpringName,
+    ) {
+      return startOwned(() =>
+        typeof changeOrOptions === 'function'
+          ? animateSize(target, dimensions, changeOrOptions, options)
+          : animateSize(target, dimensions, changeOrOptions),
+      )
+    },
     decay(...args) {
       return startOwned(() => decay(...args))
     },

package/src/native/index.ts

@@ -1,6 +1,7 @@
 export { registerNativeProperty, checkNativeProperty } from '../native-property.js'
 export type { NativeProperty, NativePropertyDefinition } from '../native-property.js'
 export type { NativeSink } from '../native-property-driver.js'
+export { sceneKitFieldOfView } from '../scene-camera.js'
 export {
   mapKitCoordinate,
   mapKitCamera,

package/src/scene-camera.ts

@@ -0,0 +1,30 @@
+/// <reference types="@nativescript/types-ios/lib/ios/objc-x86_64/objc!SceneKit" preserve="true" />
+import { registerNativeProperty, type NativeProperty } from './native-property.js'
+
+/** Perspective SCNCamera field of view in degrees (1..179), on its projectionDirection axis. */
+export const sceneKitFieldOfView: (camera: SCNCamera) => NativeProperty<number> =
+  registerNativeProperty<number>({
+    name: 'jolt.scenekit/field-of-view',
+    units: ['degrees on the camera projectionDirection axis'],
+    platforms: ['ios'],
+    spatial: true,
+    encode: (value) => [value],
+    decode: (values) => values[0]!,
+    validate(value) {
+      if (!Number.isFinite(value) || value < 1 || value > 179)
+        throw new RangeError(
+          'SceneKit field of view needs a finite angle in 1..179 degrees.',
+        )
+    },
+    interpolate: (a, b, t) => Math.max(1, Math.min(179, a + (b - a) * t)),
+    create(target) {
+      if (
+        typeof JoltReferenceProperties === 'undefined' ||
+        typeof JoltReferenceProperties.sceneFieldOfView !== 'function'
+      )
+        throw new Error(
+          'SceneKit field of view requires an updated @rafaelaugusto/jolt-native plugin. Update both packages and rebuild the native app.',
+        )
+      return JoltReferenceProperties.sceneFieldOfView(target as NSObject)
+    },
+  })

package/src/size-layout.ts

@@ -0,0 +1,237 @@
+import { GridLayout, StackLayout, Utils, View, unsetValue } from '@nativescript/core'
+
+export type SizeAxis = 'width' | 'height'
+export type SizeValue = number | 'auto'
+export type SizeValues = Partial<Record<SizeAxis, SizeValue>>
+export type SizePixels = Record<SizeAxis, number>
+
+type MeasuredView = View & {
+  _currentWidthMeasureSpec?: number
+  _currentHeightMeasureSpec?: number
+  _oldLeft?: number
+  _oldTop?: number
+  _oldRight?: number
+  _oldBottom?: number
+}
+const overlays = new WeakMap<View, Map<SizeAxis, object>>()
+
+/** One live tree: speculative measurement never lays out or duplicates its views. */
+export function sizeLayout(
+  view: View,
+  axes: readonly SizeAxis[],
+  replacing: readonly SizeAxis[] = [],
+  read: () => SizePixels = () => view.getActualSize(),
+) {
+  const parent = view.parent
+  if (
+    view.isLoaded &&
+    !(parent instanceof StackLayout) &&
+    !(parent instanceof GridLayout)
+  )
+    throw new TypeError('animateSize needs a child of StackLayout or GridLayout.')
+  const style = view.style as unknown as Record<string, unknown>
+  for (const axis of axes) {
+    const initial = view[axis]
+    if (
+      typeof initial === 'object' &&
+      initial !== null &&
+      (initial.unit === 'dip' || initial.unit === 'px')
+    )
+      dimension(initial.value, `initial ${axis}`)
+    else dimension(initial, `initial ${axis}`)
+    const key = `keyframe:${axis}`
+    if (
+      !replacing.includes(axis) &&
+      style[key] !== unsetValue &&
+      style[key] !== undefined
+    )
+      throw new Error(`animateSize cannot own ${axis} during a CSS keyframe animation.`)
+  }
+  let writing = false
+  let disposed = false
+  let claimed = false
+  const identity = {}
+  const claim = () => {
+    if (claimed || disposed) return
+    claimed = true
+    const current = overlays.get(view) ?? new Map<SizeAxis, object>()
+    for (const axis of axes) current.set(axis, identity)
+    overlays.set(view, current)
+  }
+  const owns = (axis: SizeAxis) => overlays.get(view)?.get(axis) === identity
+  let releaseHooks = () => {}
+  const write = (values: SizeValues) => {
+    if (disposed) return
+    claim()
+    writing = true
+    try {
+      for (const axis of axes)
+        if (owns(axis) && values[axis] !== undefined)
+          style[`keyframe:${axis}`] = bounded(view, axis, values[axis]!)
+    } finally {
+      writing = false
+    }
+  }
+  const clear = () => {
+    writing = true
+    try {
+      for (const axis of axes) if (owns(axis)) style[`keyframe:${axis}`] = unsetValue
+    } finally {
+      writing = false
+    }
+  }
+  const root = () => {
+    let node = view as MeasuredView
+    while (node.parent instanceof View && node.parent.typeName !== 'Page')
+      node = node.parent as MeasuredView
+    return node
+  }
+  const specs = (node: MeasuredView) => {
+    // Core's last layout allocation excludes transforms; UIView.frame does not.
+    const cached = [node._oldLeft, node._oldTop, node._oldRight, node._oldBottom]
+    const bounds =
+      cached.every((value) => Number.isFinite(value)) &&
+      cached[2]! > cached[0]! &&
+      cached[3]! > cached[1]!
+        ? { left: cached[0]!, top: cached[1]!, right: cached[2]!, bottom: cached[3]! }
+        : node._getCurrentLayoutBounds()
+    const layout = Utils.layout
+    return {
+      bounds,
+      width:
+        node._currentWidthMeasureSpec ??
+        layout.makeMeasureSpec(Math.max(0, bounds.right - bounds.left), layout.EXACTLY),
+      height:
+        node._currentHeightMeasureSpec ??
+        layout.makeMeasureSpec(Math.max(0, bounds.bottom - bounds.top), layout.EXACTLY),
+    }
+  }
+  const measure = () => {
+    const node = root()
+    const spec = specs(node)
+    view.requestLayout()
+    node.measure(spec.width, spec.height)
+    return { node, ...spec }
+  }
+  return {
+    read,
+    write,
+    ready() {
+      const { bounds } = specs(root())
+      return bounds.right > bounds.left && bounds.bottom > bounds.top
+    },
+    measure(destination: SizeValues): SizePixels {
+      const held = Object.fromEntries(
+        axes.map((axis) => [axis, style[`keyframe:${axis}`]]),
+      )
+      try {
+        write(destination)
+        measure()
+        const dip = Utils.layout.toDeviceIndependentPixels
+        return {
+          width: dip(view.getMeasuredWidth()),
+          height: dip(view.getMeasuredHeight()),
+        }
+      } finally {
+        writing = true
+        try {
+          for (const axis of axes)
+            if (!disposed && owns(axis)) style[`keyframe:${axis}`] = held[axis]
+        } finally {
+          writing = false
+        }
+      }
+    },
+    /** Flush the restored/current declarations before any draw can see probe measurements. */
+    layout() {
+      const { node, bounds } = measure()
+      node.layout(bounds.left, bounds.top, bounds.right, bounds.bottom)
+    },
+    commit(values?: SizeValues) {
+      writing = true
+      try {
+        if (values)
+          for (const axis of axes)
+            if (owns(axis) && values[axis] !== undefined)
+              view[axis] = bounded(view, axis, values[axis]!)
+      } finally {
+        writing = false
+        clear()
+      }
+    },
+    watch(takeover: () => void) {
+      claim()
+      const undo: (() => void)[] = []
+      releaseHooks = () =>
+        undo
+          .splice(0)
+          .reverse()
+          .forEach((off) => off())
+      // A local/CSS write hidden under the animation override still takes ownership.
+      for (const axis of axes)
+        for (const name of [axis, `css:${axis}`, `keyframe:${axis}`]) {
+          const own = Object.getOwnPropertyDescriptor(style, name)
+          let source: object | null = style
+          let descriptor: PropertyDescriptor | undefined
+          while (source && !descriptor) {
+            descriptor = Object.getOwnPropertyDescriptor(source, name)
+            source = Object.getPrototypeOf(source)
+          }
+          if (!descriptor?.set || !descriptor.get || own?.configurable === false)
+            throw new Error(`animateSize cannot observe ownership of ${name}.`)
+          const original = descriptor
+          const set = function (this: object, value: unknown) {
+            if (!writing) takeover()
+            original.set!.call(this, value)
+          }
+          Object.defineProperty(style, name, {
+            configurable: true,
+            get: original.get,
+            set,
+          })
+          undo.push(() => {
+            if (Object.getOwnPropertyDescriptor(style, name)?.set !== set) return
+            if (own) Object.defineProperty(style, name, own)
+            else delete style[name]
+          })
+        }
+    },
+    dispose() {
+      disposed = true
+      releaseHooks()
+      clear()
+      const current = overlays.get(view)
+      for (const axis of axes) if (owns(axis)) current!.delete(axis)
+      if (!current?.size) overlays.delete(view)
+    },
+  }
+}
+
+function bounded(view: View, axis: SizeAxis, value: SizeValue): SizeValue {
+  if (value === 'auto') return value
+  const minimum = axis === 'width' ? view.minWidth : view.minHeight
+  const maximum = axis === 'width' ? view.maxWidth : view.maxHeight
+  const dip = Utils.layout.toDeviceIndependentPixels
+  const min =
+    typeof minimum === 'number'
+      ? minimum
+      : dip((axis === 'width' ? view.effectiveMinWidth : view.effectiveMinHeight) ?? 0)
+  const max =
+    typeof maximum === 'number'
+      ? maximum
+      : dip(
+          (axis === 'width' ? view.effectiveMaxWidth : view.effectiveMaxHeight) ??
+            Infinity,
+        )
+  return Math.min(max, Math.max(0, min, value))
+}
+
+export function dimension(value: unknown, label: string): asserts value is SizeValue {
+  if (
+    value !== 'auto' &&
+    (typeof value !== 'number' || !Number.isFinite(value) || value < 0)
+  )
+    throw new RangeError(
+      `animateSize ${label} must be a nonnegative finite DIP number or "auto"; percentages and unit objects are unsupported.`,
+    )
+}