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

package/dist/motion-states.js

@@ -1,21 +1,29 @@
-import { prepareAnimation, toView } from './animate.js';
+import { endingValues, prepareAnimation, set, toView } from './animate.js';
 import { isColorProperty } from './color.js';
 import { isProperty } from './properties.js';
+import { mergeTransitions, springs } from './transition.js';
 /** Coordinated named targets. Omitted properties freeze when leaving their previous state. */
 export function motionStates(targets, definitions, options = {}) {
-    const views = new Map(Object.entries(targets).map(([name, target]) => [name, toView(target)]));
-    if (new Set(views.values()).size !== views.size)
+    const views = new Map(Object.entries(targets).map(([name, target]) => [
+        name,
+        target === null ? null : toView(target),
+    ]));
+    const assigned = [...views.values()].filter(Boolean);
+    if (new Set(assigned).size !== assigned.length)
         throw new TypeError('Motion state targets must refer to distinct views.');
+    for (const name of views.keys())
+        if (curveKeys.has(name))
+            throw new TypeError(`A motion target can't be named "${name}", like a transition option.`);
     const states = new Map();
-    const defaults = normalize(options.transition);
+    const defaults = normalize(options.transition, views);
     for (const [name, state] of Object.entries(definitions)) {
         if (!state || typeof state !== 'object' || Array.isArray(state))
             throw new TypeError(`Invalid motion state "${name}".`);
         const rows = [];
         for (const [target, values] of Object.entries(state)) {
-            const view = views.get(target);
-            if (!view)
+            if (!views.has(target))
                 throw new TypeError(`Unknown motion target "${target}".`);
+            const view = views.get(target);
             if (!values || typeof values !== 'object' || Array.isArray(values))
                 throw new TypeError(`Invalid motion values for "${target}".`);
             const frames = {};
@@ -32,8 +40,11 @@ export function motionStates(targets, definitions, options = {}) {
                 Object.assign(frames, { [property]: value });
             }
             // Validate every definition up front without claiming any native property.
-            prepareAnimation(view, frames, defaults);
-            rows.push([view, frames]);
+            if (view)
+                prepareAnimation(view, frames, timingFor(defaults, target));
+            else
+                endingValues(frames, timingFor(defaults, target));
+            rows.push([target, frames]);
         }
         states.set(name, rows);
     }
@@ -42,6 +53,10 @@ export function motionStates(targets, definitions, options = {}) {
     let disposed = false;
     let paused = false;
     let active;
+    const refs = new Map();
+    const framesFor = (state, target) => state === undefined
+        ? undefined
+        : states.get(state).find(([slot]) => slot === target)?.[1];
     const controller = {
         get current() {
             return current;
@@ -61,8 +76,11 @@ export function motionStates(targets, definitions, options = {}) {
             const rows = states.get(name);
             if (!rows)
                 throw new TypeError(`Unknown motion state "${name}".`);
-            const timing = transition === undefined ? defaults : normalize(transition);
-            const prepared = rows.map(([view, frames]) => prepareAnimation(view, frames, timing));
+            const timing = normalize(transition, views, defaults);
+            const prepared = rows.flatMap(([target, frames]) => {
+                const view = views.get(target);
+                return view ? [prepareAnimation(view, frames, timingFor(timing, target))] : [];
+            });
             const previous = active;
             const children = [];
             // Start replacements first: the engine transfers visible position AND velocity.
@@ -98,12 +116,53 @@ export function motionStates(targets, definitions, options = {}) {
                 },
                 then: (resolve, reject) => finished.then(resolve, reject),
             };
-            active = { handle, children };
+            active = { handle, children, timing };
             current = name;
             // Also cancels old, omitted properties, without touching the new owners.
             previous?.handle.stop();
             return handle;
         },
+        attach(target, next) {
+            if (disposed)
+                throw new Error('Motion states controller is disposed.');
+            if (!views.has(target))
+                throw new TypeError(`Unknown motion target "${target}".`);
+            const view = next === null ? null : toView(next);
+            if (views.get(target) === view)
+                return;
+            if (view)
+                for (const [other, assignedView] of views)
+                    if (other !== target && assignedView === view)
+                        throw new TypeError('Motion state targets must refer to distinct views.');
+            if (view)
+                for (const [, rows] of states)
+                    for (const [slot, frames] of rows)
+                        if (slot === target)
+                            prepareAnimation(view, frames, timingFor(defaults, target));
+            views.set(target, view);
+            const frames = view ? framesFor(current, target) : undefined;
+            if (!view || !frames)
+                return;
+            if (active) {
+                const child = prepareAnimation(view, frames, timingFor(active.timing, target))();
+                active.children.push(child);
+                if (paused)
+                    child.pause();
+            }
+            else
+                set(view, frames);
+        },
+        ref(target) {
+            let callback = refs.get(target);
+            if (!callback) {
+                callback = (view) => {
+                    if (!disposed)
+                        controller.attach(target, view);
+                };
+                refs.set(target, callback);
+            }
+            return callback;
+        },
         pause() {
             if (disposed || paused)
                 return;
@@ -129,9 +188,52 @@ export function motionStates(targets, definitions, options = {}) {
     };
     return options.scope ? options.scope.add(controller) : controller;
 }
-function normalize(transition) {
+const curveKeys = new Set([
+    'type',
+    'delay',
+    'duration',
+    'ease',
+    'times',
+    'stiffness',
+    'damping',
+    'mass',
+    'bounce',
+    'velocity',
+    'acceleration',
+    'restitution',
+]);
+/** The transition one target plays: its own merged over the main one, or the main one. */
+function timingFor(timing, target) {
+    const own = timing.targets.get(target);
+    if (own === undefined)
+        return timing.main;
+    const main = typeof timing.main === 'string' ? springs[timing.main] : timing.main;
+    return mergeTransitions(main, typeof own === 'string' ? springs[own] : own);
+}
+const snappy = { main: 'snappy', targets: new Map() };
+/** A transition that only names targets keeps the fallback for everything else. */
+function normalize(transition, targets, fallback = snappy) {
     if (transition === undefined)
-        return 'snappy';
+        return fallback;
+    if (typeof transition === 'string')
+        return { main: curve(transition), targets: new Map() };
+    if (!transition || typeof transition !== 'object')
+        throw new TypeError('Invalid state transition.');
+    const main = {};
+    const own = new Map();
+    for (const [key, value] of Object.entries(transition)) {
+        if (targets.has(key)) {
+            if (value !== undefined)
+                own.set(key, curve(value));
+        }
+        else
+            main[key] = value;
+    }
+    if (own.size && !Object.keys(main).length)
+        return { main: fallback.main, targets: new Map([...fallback.targets, ...own]) };
+    return { main: curve(main), targets: own };
+}
+function curve(transition) {
     if (typeof transition === 'string') {
         if (!['smooth', 'snappy', 'bouncy'].includes(transition))
             throw new TypeError('Unknown state spring.');
@@ -139,20 +241,8 @@ function normalize(transition) {
     }
     if (!transition || typeof transition !== 'object')
         throw new TypeError('Invalid state transition.');
-    const allowed = new Set([
-        'type',
-        'delay',
-        'duration',
-        'ease',
-        'times',
-        'stiffness',
-        'damping',
-        'mass',
-        'bounce',
-        'velocity',
-    ]);
     for (const key of Object.keys(transition))
-        if (!allowed.has(key))
+        if (!curveKeys.has(key))
             throw new TypeError(`State transitions do not support "${key}".`);
     if (transition.duration !== undefined &&
         (!Number.isFinite(transition.duration) || transition.duration < 0))

package/dist/motion-states.js.map

@@ -1 +1 @@
-{"version":3,"file":"motion-states.js","sourceRoot":"","sources":["../src/motion-states.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,EAAE,eAAe,EAAmB,MAAM,YAAY,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAyC5C,8FAA8F;AAC9F,MAAM,UAAU,YAAY,CAI1B,OAAU,EACV,WAAoC,EACpC,OAAO,GAAwB,EAAE;IAGjC,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CACxE,CAAA;IACD,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;QAC7C,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAA;IAC3E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiC,CAAA;IACvD,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IAC9C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAC7D,MAAM,IAAI,SAAS,CAAC,yBAAyB,IAAI,IAAI,CAAC,CAAA;QACxD,MAAM,IAAI,GAA0B,EAAE,CAAA;QACtC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YAC9B,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,SAAS,CAAC,0BAA0B,MAAM,IAAI,CAAC,CAAA;YACpE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAChE,MAAM,IAAI,SAAS,CAAC,8BAA8B,MAAM,IAAI,CAAC,CAAA;YAC/D,MAAM,MAAM,GAAc,EAAE,CAAA;YAC5B,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvD,IAAI,KAAK,KAAK,SAAS;oBAAE,SAAQ;gBACjC,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;oBAC/C,MAAM,IAAI,SAAS,CAAC,kCAAkC,QAAQ,IAAI,CAAC,CAAA;gBACrE,IACE,CAAC,eAAe,CAAC,QAAQ,CAAC;oBAC1B,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;oBAEtD,MAAM,IAAI,SAAS,CAAC,iBAAiB,QAAQ,+BAA+B,CAAC,CAAA;gBAC/E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI;oBACxC,MAAM,IAAI,SAAS,CAAC,iBAAiB,QAAQ,+BAA+B,CAAC,CAAA;gBAC/E,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;YAC9C,CAAC;YACD,2EAA2E;YAC3E,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;YACxC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;QAC3B,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACxB,CAAC;IACD,IAAI,OAAyB,CAAA;IAC7B,IAAI,OAAyB,CAAA;IAC7B,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,IAAI,MAAwE,CAAA;IAC5E,MAAM,UAAU,GAAuB;QACrC,IAAI,OAAO;YACT,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,IAAI,OAAO;YACT,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,IAAI,QAAQ;YACV,OAAO,QAAQ,CAAA;QACjB,CAAC;QACD,IAAI,MAAM;YACR,OAAO,MAAM,CAAA;QACf,CAAC;QACD,EAAE,CAAC,IAAI,EAAE,UAAU;YACjB,IAAI,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;YACtE,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YAC7B,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,SAAS,CAAC,yBAAyB,IAAI,IAAI,CAAC,CAAA;YACjE,MAAM,MAAM,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;YAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAC3C,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CACvC,CAAA;YACD,MAAM,QAAQ,GAAG,MAAM,CAAA;YACvB,MAAM,QAAQ,GAAwB,EAAE,CAAA;YACxC,gFAAgF;YAChF,IAAI,CAAC;gBACH,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;oBAC7B,MAAM,KAAK,GAAG,KAAK,EAAE,CAAA;oBACrB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;oBACpB,IAAI,MAAM;wBAAE,KAAK,CAAC,KAAK,EAAE,CAAA;gBAC3B,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;gBACzC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,CAAA;gBACvB,MAAM,GAAG,SAAS,CAAA;gBAClB,MAAM,KAAK,CAAA;YACb,CAAC;YACD,IAAI,SAAS,GAAG,KAAK,CAAA;YACrB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CACxE,CAAC,OAAO,EAAE,EAAE;gBACV,MAAM,SAAS,GACb,CAAC,SAAS,IAAI,CAAC,QAAQ,IAAI,MAAM,EAAE,MAAM,KAAK,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;gBAChF,IAAI,MAAM,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;oBAC9B,MAAM,GAAG,SAAS,CAAA;oBAClB,IAAI,SAAS;wBAAE,OAAO,GAAG,IAAI,CAAA;gBAC/B,CAAC;gBACD,OAAO,SAAS,CAAA;YAClB,CAAC,CACF,CAAA;YACD,MAAM,MAAM,GAAc;gBACxB,QAAQ;gBACR,IAAI;oBACF,SAAS,GAAG,IAAI,CAAA;oBAChB,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;gBAC3C,CAAC;gBACD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;aAC1D,CAAA;YACD,MAAM,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;YAC7B,OAAO,GAAG,IAAI,CAAA;YACd,yEAAyE;YACzE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,CAAA;YACvB,OAAO,MAAM,CAAA;QACf,CAAC;QACD,KAAK;YACH,IAAI,QAAQ,IAAI,MAAM;gBAAE,OAAM;YAC9B,MAAM,GAAG,IAAI,CAAA;YACb,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;QACpD,CAAC;QACD,IAAI;YACF,IAAI,QAAQ,IAAI,CAAC,MAAM;gBAAE,OAAM;YAC/B,MAAM,GAAG,KAAK,CAAA;YACd,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QACnD,CAAC;QACD,IAAI;YACF,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAA;YACrB,MAAM,GAAG,SAAS,CAAA;QACpB,CAAC;QACD,OAAO;YACL,IAAI,QAAQ;gBAAE,OAAM;YACpB,QAAQ,GAAG,IAAI,CAAA;YACf,UAAU,CAAC,IAAI,EAAE,CAAA;QACnB,CAAC;KACF,CAAA;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAA;AACnE,CAAC;AAED,SAAS,SAAS,CAAC,UAAuC;IACxD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAA;IAC7C,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;YACtD,MAAM,IAAI,SAAS,CAAC,uBAAuB,CAAC,CAAA;QAC9C,OAAO,UAAU,CAAA;IACnB,CAAC;IACD,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ;QAC/C,MAAM,IAAI,SAAS,CAAC,2BAA2B,CAAC,CAAA;IAClD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC;QACtB,MAAM;QACN,OAAO;QACP,UAAU;QACV,MAAM;QACN,OAAO;QACP,WAAW;QACX,SAAS;QACT,MAAM;QACN,QAAQ;QACR,UAAU;KACX,CAAC,CAAA;IACF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YACnB,MAAM,IAAI,SAAS,CAAC,qCAAqC,GAAG,IAAI,CAAC,CAAA;IACrE,IACE,UAAU,CAAC,QAAQ,KAAK,SAAS;QACjC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,GAAG,CAAC,CAAC;QAElE,MAAM,IAAI,UAAU,CAAC,2DAA2D,CAAC,CAAA;IACnF,IACE,UAAU,CAAC,KAAK,KAAK,SAAS;QAC9B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC;QAE5D,MAAM,IAAI,UAAU,CAAC,wDAAwD,CAAC,CAAA;IAChF,OAAO,EAAE,GAAG,UAAU,EAAE,CAAA;AAC1B,CAAC"}
+{"version":3,"file":"motion-states.js","sourceRoot":"","sources":["../src/motion-states.ts"],"names":[],"mappings":"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"}

package/dist/motion-value.d.ts

@@ -0,0 +1,227 @@
+import { Color, type View } from '@nativescript/core';
+import { type ColorValue } from './color.js';
+import { type SpringParams } from './spring.js';
+import { type LiveNode, type LiveMapping } from './live-spring-driver.js';
+import { ViewAnimation, type Animation, type Plan } from './engine.js';
+import { type Property } from './properties.js';
+import { type Track } from './track.js';
+import { type SpringName, type Transition } from './transition.js';
+import type { KeyframeProperty, Target } from './types.js';
+import { type PlaybackAnimation } from './playback.js';
+import { ValueObservers, type SubscribeOptions, type ValueListener } from './value-observers.js';
+export interface MapOptions {
+    /** Hold the first and last outputs outside the input range. Defaults to `true`. */
+    clamp?: boolean;
+}
+/** Named motion value layers add scalar offsets before derived mappings. */
+export type ValueAnimationOptions = Transition & {
+    layer?: string;
+};
+declare const motionValueBrand: unique symbol;
+/** A number derived from a motion value, ready to bind to a view. */
+export interface DerivedValue {
+    /** The value now, while it animates too. */
+    get(): number;
+    /** Observe changes in JavaScript on the native frame clock. Unsubscribe when finished. */
+    subscribe(listener: ValueListener<number>, options?: SubscribeOptions): () => void;
+    /** Maps through ascending or descending input ranges, like React Native's `interpolate`. */
+    to(input: readonly number[], output: readonly number[], options?: MapOptions): DerivedValue;
+    to(input: readonly number[], output: readonly ColorValue[]): DerivedColor;
+}
+/** A color derived from a motion value, for `backgroundColor`, `borderColor` or `color`. */
+export interface DerivedColor {
+    get(): Color;
+    /** Observe mapped color changes in JavaScript on the native frame clock. */
+    subscribe(listener: ValueListener<Color>, options?: SubscribeOptions): () => void;
+}
+/** A number that animates natively and drives every view property bound to it. */
+export interface MotionValue extends DerivedValue {
+    readonly [motionValueBrand]: true;
+}
+type ColorKey = 'backgroundColor' | 'borderColor' | 'color';
+export type Bindings = {
+    [K in Exclude<KeyframeProperty, ColorKey>]?: DerivedValue;
+} & {
+    [K in ColorKey]?: DerivedColor;
+};
+interface Binding {
+    readonly view: View;
+    readonly property: Property;
+    readonly root: Root;
+    readonly source?: Derived;
+    readonly read: (value: number) => number;
+    animation?: ViewAnimation;
+    cleanup?: () => void;
+    sync(): void;
+}
+declare class Derived {
+    private readonly source;
+    readonly read: (value: number) => number;
+    readonly color: boolean;
+    readonly mappings: readonly LiveMapping[];
+    constructor(source: Root | undefined, read: (value: number) => number, color: boolean, mappings?: readonly LiveMapping[]);
+    get root(): Root;
+    get(): number | Color;
+    subscribe(listener: ValueListener<number | Color>, options?: SubscribeOptions): () => void;
+    to(input: readonly number[], output: readonly (number | ColorValue)[], options?: MapOptions): Derived;
+}
+declare class Root extends Derived {
+    private consumers;
+    readonly demandListeners: Set<(active: boolean) => void>;
+    get demanded(): boolean;
+    retainConsumer(): () => void;
+    protected demandChanged(): void;
+    readonly bindings: Set<Binding>;
+    readonly listeners: Set<() => void>;
+    readonly observers: ValueObservers;
+    private readonly rests;
+    private readonly runs;
+    private presentation;
+    private cancelPresentation;
+    constructor(initial: number);
+    raw(time?: number): number;
+    /** Drag input owns only the base; bounds and snap points stay in base units. */
+    base(): number;
+    private part;
+    private runTime;
+    /** Internal development snapshot; reading it installs no observers. */
+    inspect(): {
+        velocity: number;
+        resources: number;
+    };
+    private velocity;
+    animate(target: number | readonly (number | null)[], transition?: ValueAnimationOptions | SpringName): PlaybackAnimation;
+    /** Plays a track sampled in the value's own units, such as a drag release. */
+    playTrack(track: Track): PlaybackAnimation;
+    private jump;
+    private start;
+    set(value: number): void;
+    setBase(value: number): void;
+    stopBase(): void;
+    stop(layer?: string): void;
+    private stopChannel;
+    private sync;
+    protected changed(): void;
+    /** The plan that plays this value's run, mapped, on one bound property. */
+    plan(binding: Binding): Plan;
+    /** Capture the current native presentation clock, even if a later command replaces it. */
+    captureTime(): () => number;
+    elapsed(): number;
+    get paused(): boolean;
+    get running(): boolean;
+    private halt;
+}
+export interface SpringValueOptions extends SpringParams {
+    /** Initial follower position. Defaults to the source's current value. */
+    initial?: number;
+    /** Absolute source units. Defaults to 0.001. */
+    restDelta?: number;
+    /** Source units per second. Defaults to 0.01. */
+    restSpeed?: number;
+}
+/** A retained native follower. Settling does not dispose its source subscription. */
+export interface SpringValue extends DerivedValue {
+    readonly disposed: boolean;
+    readonly moving: boolean;
+    readonly paused: boolean;
+    /** Hold position and velocity while retaining the current source target. */
+    pause(): void;
+    /** Resume from the held state toward the current source. */
+    play(): void;
+    /** Current velocity in source units per second. */
+    getVelocity(): number;
+    dispose(): void;
+}
+/** Follow changing targets without rebuilding sampled animation tracks. Dispose with the owning scope. */
+export declare function springValue(source: DerivedValue, options?: SpringValueOptions): SpringValue;
+/** Internal boundary notification for values driven directly by native input. */
+export declare function liveValueInput(value: DerivedValue): {
+    node: LiveNode;
+    changed: () => void;
+    active(value: boolean): void;
+    demand(listener: (active: boolean) => void): () => void;
+};
+/**
+ * A number that animates natively and drives the view properties bound to it.
+ *
+ * ```ts
+ * const progress = motionValue(0)
+ * bind(sheet, { y: progress.to([0, 1], [600, 0]) })
+ * animate(progress, 1, 'snappy')
+ * ```
+ */
+export declare function motionValue(initial?: number): MotionValue;
+export declare function isMotionValue(target: unknown): target is MotionValue;
+export declare function asRoot(value: MotionValue): Root;
+/**
+ * Lets motion values drive a view's properties. The view takes their current values
+ * at once and follows every change on the same native clock. Returns a cleanup function.
+ *
+ * ```ts
+ * const release = bind(backdrop, { opacity: progress.to([0, 1], [0, 0.4]) })
+ * ```
+ */
+export declare function bind(target: Target | readonly Target[], bindings: Bindings): () => void;
+/** A read-only value on an existing finite animation's clock. No second animation or timer. */
+export declare function playbackProgress(animation: Animation): DerivedValue;
+/** Internal compound-binding bridge. One raw snapshot per root keeps sibling mappings coherent. */
+export declare function valueSource(source: DerivedValue | DerivedColor, color: boolean): {
+    identity: Root;
+    read: (value: number) => number;
+    snapshot(): {
+        track: Track;
+        elapsed: number;
+        time: () => number;
+        running: boolean;
+        value: number;
+    };
+    subscribe(listener: () => void): () => void;
+};
+/** Treat values as opaque identities in declarative option comparisons. */
+export declare function isDerived(value: unknown): value is DerivedValue | DerivedColor;
+/** Internal native-adapter bridge. Mappings are sampled at boundaries, never per frame. */
+export declare function valuePlayback(source: DerivedValue): {
+    snapshot(): {
+        track: Track;
+        elapsed: number;
+        paused: boolean;
+        running: boolean;
+        value: number;
+    };
+    subscribe(listener: () => void): () => void;
+};
+/** A regular animation on a bound property takes it over; the value keeps its other bindings. */
+export declare function detachBindings(view: View, properties: readonly Property[]): void;
+interface InspectedSource {
+    identity: object;
+    kind: string;
+    value: number;
+    mappings: readonly LiveMapping[];
+    input?: InspectedSource;
+}
+/** Read existing binding topology without subscribing or constructing new tracks. */
+export declare function inspectViewBindings(view: View): {
+    property: Property;
+    source: InspectedSource;
+    value: number;
+}[];
+/** A number that follows a scroll view's offset. Bind it like a motion value. */
+export interface ScrollValue extends DerivedValue {
+    /** Follows this scroll view instead, or none with `null`. Stable, so it works as a template ref. */
+    readonly ref: (scrollView: Target | null) => void;
+    /** Stops following; bound views stay where they are. */
+    dispose(): void;
+}
+/**
+ * The scroll offset of a ScrollView, in DIPs, as a value that bindings follow.
+ *
+ * ```ts
+ * const offset = scrollValue(scroll)
+ * bind(header, { y: offset.to([0, 120], [0, -60]), opacity: offset.to([0, 80], [1, 0]) })
+ * ```
+ */
+export declare function scrollValue(scrollView?: Target | null, options?: {
+    axis?: 'x' | 'y';
+}): ScrollValue;
+export {};
+//# sourceMappingURL=motion-value.d.ts.map

package/dist/motion-value.d.ts.map

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