tensum 0.1.0

package/dist/support/keyframes.d.ts

@@ -0,0 +1,34 @@
+import type { SettlingResult, SpringParameters, SpringSettleInput, SpringSolution, SpringState, SpringTiming, SpringTimingInput } from '../types.js';
+export interface SpringKeyframe {
+    value: number;
+    startVelocity?: number;
+    parameters?: Partial<SpringParameters>;
+    settle?: SpringSettleInput;
+    timing?: SpringTimingInput;
+}
+export interface SpringKeyframesOptions {
+    from: number;
+    keyframes: readonly SpringKeyframe[];
+    parameters: SpringParameters;
+    velocity?: number;
+    settle?: SpringSettleInput;
+    timing?: SpringTimingInput;
+}
+export interface SpringKeyframeSegment {
+    readonly index: number;
+    readonly startTime: number;
+    readonly endTime: number;
+    readonly solution: SpringSolution;
+}
+export interface SpringKeyframeSequence {
+    readonly duration: number;
+    readonly settled: boolean;
+    readonly timing: Readonly<SpringTiming>;
+    readonly segments: readonly Readonly<SpringKeyframeSegment>[];
+    positionAt(time: number): number;
+    velocityAt(time: number): number;
+    stateAt(time: number): SpringState;
+    getSettlingResult(): SettlingResult;
+}
+export declare function createSpringKeyframes(options: SpringKeyframesOptions): SpringKeyframeSequence;
+//# sourceMappingURL=keyframes.d.ts.map

package/dist/support/keyframes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyframes.d.ts","sourceRoot":"","sources":["../../src/support/keyframes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IACrC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;IAC9D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IACnC,iBAAiB,IAAI,cAAc,CAAC;CACrC;AAiBD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,GAC9B,sBAAsB,CA4HxB"}

package/dist/support/keyframes.js

@@ -0,0 +1,117 @@
+import { createSpring } from '../spring.js';
+function assertFinite(name, value) {
+    if (!Number.isFinite(value)) {
+        throw new RangeError(`${name} must be a finite number`);
+    }
+}
+function assertOptionalObject(name, value) {
+    if (value !== undefined &&
+        (typeof value !== 'object' || value === null || Array.isArray(value))) {
+        throw new TypeError(`${name} must be an object when provided`);
+    }
+}
+export function createSpringKeyframes(options) {
+    assertFinite('from', options.from);
+    if (options.keyframes.length === 0) {
+        throw new RangeError('spring keyframes require at least one destination');
+    }
+    const segments = [];
+    let from = options.from;
+    let startTime = 0;
+    let perceptualDuration = 0;
+    if (options.velocity !== undefined) {
+        assertFinite('velocity', options.velocity);
+    }
+    assertOptionalObject('settle', options.settle);
+    assertOptionalObject('timing', options.timing);
+    for (let index = 0; index < options.keyframes.length; index += 1) {
+        const keyframe = options.keyframes[index];
+        assertFinite(`keyframes[${index}].value`, keyframe.value);
+        assertOptionalObject(`keyframes[${index}].parameters`, keyframe.parameters);
+        assertOptionalObject(`keyframes[${index}].settle`, keyframe.settle);
+        assertOptionalObject(`keyframes[${index}].timing`, keyframe.timing);
+        const frameVelocity = keyframe.startVelocity === undefined
+            ? index === 0
+                ? options.velocity === undefined
+                    ? 0
+                    : options.velocity
+                : 0
+            : keyframe.startVelocity;
+        assertFinite(`keyframes[${index}].startVelocity`, frameVelocity);
+        const parameters = {
+            mass: keyframe.parameters?.mass === undefined
+                ? options.parameters.mass
+                : keyframe.parameters.mass,
+            stiffness: keyframe.parameters?.stiffness === undefined
+                ? options.parameters.stiffness
+                : keyframe.parameters.stiffness,
+            damping: keyframe.parameters?.damping === undefined
+                ? options.parameters.damping
+                : keyframe.parameters.damping,
+        };
+        const settle = options.settle || keyframe.settle
+            ? { ...options.settle, ...keyframe.settle }
+            : undefined;
+        const timing = keyframe.timing === undefined ? options.timing : keyframe.timing;
+        const solution = createSpring({
+            from,
+            to: keyframe.value,
+            velocity: frameVelocity,
+            ...parameters,
+            ...(settle === undefined ? {} : { settle }),
+            ...(timing === undefined ? {} : { timing }),
+        });
+        const result = solution.getSettlingResult();
+        if (!result.settled && index < options.keyframes.length - 1) {
+            throw new RangeError(`keyframes[${index}] is unsettled and cannot define the next segment start`);
+        }
+        const endTime = startTime + result.duration;
+        assertFinite('duration', endTime);
+        segments.push(Object.freeze({ index, startTime, endTime, solution }));
+        perceptualDuration += solution.timing.perceptualDuration;
+        assertFinite('perceptualDuration', perceptualDuration);
+        startTime = endTime;
+        from = keyframe.value;
+    }
+    const frozenSegments = Object.freeze(segments);
+    const duration = frozenSegments.at(-1).endTime;
+    const settled = frozenSegments.every((segment) => segment.solution.timing.settled);
+    const timing = Object.freeze({
+        perceptualDuration,
+        settlingDuration: duration,
+        settled,
+    });
+    const stateAt = (time) => {
+        assertFinite('time', time);
+        if (time < 0)
+            throw new RangeError('time must be greater than or equal to 0');
+        const segment = frozenSegments.find((candidate) => time < candidate.endTime) ??
+            frozenSegments.at(-1);
+        const localTime = Math.min(Math.max(0, time - segment.startTime), segment.solution.getSettlingDuration());
+        if (time >= duration && segment.solution.timing.settled) {
+            return { position: segment.solution.initialState.target, velocity: 0 };
+        }
+        return segment.solution.stateAt(localTime);
+    };
+    return Object.freeze({
+        duration,
+        settled,
+        timing,
+        segments: frozenSegments,
+        positionAt(time) {
+            return stateAt(time).position;
+        },
+        velocityAt(time) {
+            return stateAt(time).velocity;
+        },
+        stateAt,
+        getSettlingResult() {
+            return {
+                duration,
+                iterations: frozenSegments.reduce((total, segment) => total + segment.solution.getSettlingResult().iterations, 0),
+                settled,
+            };
+        },
+    });
+}
+//# sourceMappingURL=keyframes.js.map

package/dist/support/keyframes.js.map

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

package/dist/support/spring-value.d.ts

@@ -0,0 +1,38 @@
+import type { SpringParameters, SpringSettleInput, SpringTimingInput } from '../types.js';
+export interface FrameDriver {
+    /** Monotonic time in seconds. */
+    now(): number;
+    /** Schedule one frame. The callback receives monotonic time in seconds. */
+    schedule(callback: (time: number) => void): () => void;
+}
+export interface SpringValueOptions {
+    settle?: SpringSettleInput;
+    timing?: SpringTimingInput;
+}
+export interface SpringValueSnapshot {
+    value: number;
+    velocity: number;
+    target: number;
+    animating: boolean;
+}
+export interface SpringValueRetargetOptions {
+    parameters?: SpringParameters;
+    blendDuration?: number;
+}
+export type SpringValueEvent = 'change' | 'logicalComplete' | 'settle' | 'unsettled';
+export type SpringValueListener = (snapshot: Readonly<SpringValueSnapshot>) => void;
+export interface SpringValue {
+    get(): number;
+    getVelocity(): number;
+    getTarget(): number;
+    getParameters(): Readonly<SpringParameters>;
+    getSnapshot(): Readonly<SpringValueSnapshot>;
+    setTarget(target: number, options?: SpringValueRetargetOptions): void;
+    setParameters(parameters: SpringParameters, options?: Pick<SpringValueRetargetOptions, 'blendDuration'>): void;
+    jump(value: number): void;
+    stop(): void;
+    on(event: SpringValueEvent, listener: SpringValueListener): () => void;
+    destroy(): void;
+}
+export declare function createSpringValue(initialValue: number, parameters: SpringParameters, driver: FrameDriver, options?: SpringValueOptions): SpringValue;
+//# sourceMappingURL=spring-value.d.ts.map

package/dist/support/spring-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring-value.d.ts","sourceRoot":"","sources":["../../src/support/spring-value.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAGjB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,GAAG,IAAI,MAAM,CAAC;IACd,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACxD;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,iBAAiB,GACjB,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,mBAAmB,CAAC,KAAK,IAAI,CAAC;AAEpF,MAAM,WAAW,WAAW;IAC1B,GAAG,IAAI,MAAM,CAAC;IACd,WAAW,IAAI,MAAM,CAAC;IACtB,SAAS,IAAI,MAAM,CAAC;IACpB,aAAa,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC5C,WAAW,IAAI,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IAC7C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACtE,aAAa,CACX,UAAU,EAAE,gBAAgB,EAC5B,OAAO,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,eAAe,CAAC,GAC1D,IAAI,CAAC;IACR,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,IAAI,IAAI,CAAC;IACb,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAAC;IACvE,OAAO,IAAI,IAAI,CAAC;CACjB;AAyBD,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAsTb"}

package/dist/support/spring-value.js

@@ -0,0 +1,289 @@
+import { springParameters } from '../parameters.js';
+import { resolveSettlingOptions } from '../settling.js';
+import { createSpring, resolveSpringTimingInput } from '../spring.js';
+function assertFinite(name, value) {
+    if (!Number.isFinite(value)) {
+        throw new RangeError(`${name} must be a finite number`);
+    }
+}
+export function createSpringValue(initialValue, parameters, driver, options = {}) {
+    assertFinite('initialValue', initialValue);
+    let currentParameters = springParameters.fromPhysics(parameters);
+    const settling = resolveSettlingOptions(options.settle);
+    const settleInput = {
+        position: settling.positionEpsilon,
+        velocity: settling.velocityEpsilon,
+        maxDuration: settling.maxDuration,
+        refinementIterations: settling.refinementIterations,
+    };
+    const timingInput = resolveSpringTimingInput(options.timing);
+    const listeners = {
+        change: new Set(),
+        logicalComplete: new Set(),
+        settle: new Set(),
+        unsettled: new Set(),
+    };
+    let value = initialValue;
+    let velocity = 0;
+    let target = initialValue;
+    let pending;
+    let active;
+    let cancelFrame;
+    let destroyed = false;
+    let lastFrameTime = Number.NEGATIVE_INFINITY;
+    let revision = 0;
+    const snapshot = () => Object.freeze({
+        value,
+        velocity,
+        target: pending?.target ?? target,
+        animating: active !== undefined || pending !== undefined,
+    });
+    const emit = (event) => {
+        if (destroyed || listeners[event].size === 0)
+            return;
+        const current = snapshot();
+        for (const listener of [...listeners[event]])
+            listener(current);
+    };
+    const write = (nextValue, nextVelocity) => {
+        assertFinite('value', nextValue);
+        assertFinite('velocity', nextVelocity);
+        const changed = !Object.is(value, nextValue) || !Object.is(velocity, nextVelocity);
+        value = nextValue;
+        velocity = nextVelocity;
+        if (changed)
+            emit('change');
+    };
+    const stateAt = (sampled, elapsed) => {
+        const next = sampled.solution.stateAt(elapsed);
+        if (!sampled.blendFrom || elapsed >= sampled.blendDuration)
+            return next;
+        const previous = sampled.blendFrom.stateAt(elapsed);
+        const progress = elapsed / sampled.blendDuration;
+        const weight = progress * progress * (3 - 2 * progress);
+        const weightVelocity = (6 * progress * (1 - progress)) / sampled.blendDuration;
+        return {
+            position: previous.position + (next.position - previous.position) * weight,
+            velocity: previous.velocity +
+                (next.velocity - previous.velocity) * weight +
+                (next.position - previous.position) * weightVelocity,
+        };
+    };
+    const sampleActive = (time) => {
+        if (!active)
+            return;
+        const sampled = active;
+        const sampledRevision = revision;
+        const elapsed = Math.max(0, time - sampled.startedAt);
+        const { solution } = sampled;
+        if (solution.timing.settled && elapsed >= sampled.settlingBoundary) {
+            active = undefined;
+            write(solution.initialState.target, 0);
+            if (revision !== sampledRevision)
+                return;
+            if (!sampled.logicalComplete &&
+                elapsed >= sampled.logicalDuration) {
+                sampled.logicalComplete = true;
+                emit('logicalComplete');
+                if (revision !== sampledRevision)
+                    return;
+            }
+            emit('settle');
+            return;
+        }
+        const state = stateAt(sampled, elapsed);
+        write(state.position, state.velocity);
+        if (revision !== sampledRevision || active !== sampled)
+            return;
+        if (!sampled.logicalComplete &&
+            elapsed >= sampled.logicalDuration) {
+            sampled.logicalComplete = true;
+            emit('logicalComplete');
+            if (revision !== sampledRevision || active !== sampled)
+                return;
+        }
+        if (!solution.timing.settled &&
+            !sampled.unsettledNotified &&
+            elapsed >= sampled.settlingBoundary) {
+            sampled.unsettledNotified = true;
+            emit('unsettled');
+        }
+    };
+    const createActiveSpring = (time, request, previousParameters) => {
+        target = request.target;
+        currentParameters = request.parameters;
+        if (Object.is(value, target) && velocity === 0) {
+            active = undefined;
+            emit('settle');
+            return;
+        }
+        const solution = createSpring({
+            from: value,
+            to: target,
+            velocity,
+            ...currentParameters,
+            settle: settleInput,
+            ...(timingInput === undefined ? {} : { timing: timingInput }),
+        });
+        const parametersChanged = previousParameters.mass !== currentParameters.mass ||
+            previousParameters.stiffness !== currentParameters.stiffness ||
+            previousParameters.damping !== currentParameters.damping;
+        const blendFrom = request.blendDuration > 0 && parametersChanged
+            ? createSpring({
+                from: value,
+                to: target,
+                velocity,
+                ...previousParameters,
+                settle: settleInput,
+                ...(timingInput === undefined ? {} : { timing: timingInput }),
+            })
+            : undefined;
+        active = {
+            solution,
+            ...(blendFrom === undefined ? {} : { blendFrom }),
+            blendDuration: blendFrom ? request.blendDuration : 0,
+            logicalDuration: Math.max(solution.timing.perceptualDuration, blendFrom ? request.blendDuration : 0),
+            settlingBoundary: Math.max(solution.timing.settlingDuration, blendFrom ? request.blendDuration : 0),
+            startedAt: time,
+            logicalComplete: false,
+            unsettledNotified: false,
+        };
+    };
+    const validateFrameTime = (time) => {
+        assertFinite('frame time', time);
+        if (time < lastFrameTime) {
+            throw new RangeError('frame time must be monotonic');
+        }
+        lastFrameTime = time;
+    };
+    let requestFrame;
+    const frame = (time) => {
+        cancelFrame = undefined;
+        if (destroyed)
+            return;
+        validateFrameTime(time);
+        if (pending !== undefined) {
+            // Sample the interrupted trajectory at the exact retarget time before
+            // replacing it, preserving analytical rather than frame-difference velocity.
+            sampleActive(time);
+            const request = pending;
+            const previousParameters = currentParameters;
+            pending = undefined;
+            createActiveSpring(time, request, previousParameters);
+        }
+        else {
+            sampleActive(time);
+        }
+        if (active || pending !== undefined)
+            requestFrame();
+    };
+    requestFrame = () => {
+        if (destroyed || cancelFrame)
+            return;
+        cancelFrame = driver.schedule(frame);
+    };
+    const stopAt = (time) => {
+        revision += 1;
+        validateFrameTime(time);
+        sampleActive(time);
+        active = undefined;
+        pending = undefined;
+        cancelFrame?.();
+        cancelFrame = undefined;
+        write(value, 0);
+        target = value;
+    };
+    const queueTarget = (nextTarget, retargetOptions = {}) => {
+        if (destroyed)
+            return;
+        assertFinite('target', nextTarget);
+        const nextParameters = retargetOptions.parameters === undefined
+            ? pending?.parameters ?? currentParameters
+            : springParameters.fromPhysics(retargetOptions.parameters);
+        const blendDuration = retargetOptions.blendDuration === undefined
+            ? pending?.blendDuration ?? 0
+            : retargetOptions.blendDuration;
+        assertFinite('blendDuration', blendDuration);
+        if (blendDuration < 0) {
+            throw new RangeError('blendDuration must be greater than or equal to 0');
+        }
+        const currentRequestTarget = pending?.target ?? target;
+        const currentRequestParameters = pending?.parameters ?? currentParameters;
+        const sameParameters = currentRequestParameters.mass === nextParameters.mass &&
+            currentRequestParameters.stiffness === nextParameters.stiffness &&
+            currentRequestParameters.damping === nextParameters.damping;
+        if (Object.is(nextTarget, currentRequestTarget) && sameParameters)
+            return;
+        revision += 1;
+        pending = { target: nextTarget, parameters: nextParameters, blendDuration };
+        requestFrame();
+    };
+    return Object.freeze({
+        get() {
+            return value;
+        },
+        getVelocity() {
+            return velocity;
+        },
+        getTarget() {
+            return pending?.target ?? target;
+        },
+        getParameters() {
+            return pending?.parameters ?? currentParameters;
+        },
+        getSnapshot() {
+            return snapshot();
+        },
+        setTarget(nextTarget, retargetOptions = {}) {
+            queueTarget(nextTarget, retargetOptions);
+        },
+        setParameters(nextParameters, retargetOptions = {}) {
+            if (destroyed)
+                return;
+            queueTarget(pending?.target ?? target, {
+                parameters: nextParameters,
+                ...(retargetOptions.blendDuration === undefined
+                    ? {}
+                    : { blendDuration: retargetOptions.blendDuration }),
+            });
+        },
+        jump(nextValue) {
+            if (destroyed)
+                return;
+            assertFinite('value', nextValue);
+            revision += 1;
+            active = undefined;
+            pending = undefined;
+            target = nextValue;
+            cancelFrame?.();
+            cancelFrame = undefined;
+            write(nextValue, 0);
+        },
+        stop() {
+            if (destroyed)
+                return;
+            stopAt(driver.now());
+        },
+        on(event, listener) {
+            if (destroyed)
+                return () => { };
+            listeners[event].add(listener);
+            let subscribed = true;
+            return () => {
+                if (!subscribed)
+                    return;
+                subscribed = false;
+                listeners[event].delete(listener);
+            };
+        },
+        destroy() {
+            if (destroyed)
+                return;
+            destroyed = true;
+            stopAt(driver.now());
+            for (const eventListeners of Object.values(listeners))
+                eventListeners.clear();
+        },
+    });
+}
+//# sourceMappingURL=spring-value.js.map

package/dist/support/spring-value.js.map

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

package/dist/support/velocity.d.ts

@@ -0,0 +1,14 @@
+export interface VelocitySample<TValue> {
+    value: TValue;
+    /** Monotonic time in seconds. */
+    time: number;
+}
+export interface VelocityFromSamplesOptions {
+    /** Samples older than this many seconds resolve to zero velocity. */
+    maxSampleAge?: number;
+}
+export declare function velocityFromSamples(previous: VelocitySample<number>, current: VelocitySample<number>, options?: VelocityFromSamplesOptions): number;
+export declare function velocityFromSamples(previous: VelocitySample<readonly number[]>, current: VelocitySample<readonly number[]>, options?: VelocityFromSamplesOptions): readonly number[];
+export declare function normalizedVelocity(velocity: number, from: number, to: number): number;
+export declare function physicalVelocity(velocity: number, from: number, to: number): number;
+//# sourceMappingURL=velocity.d.ts.map

package/dist/support/velocity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"velocity.d.ts","sourceRoot":"","sources":["../../src/support/velocity.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc,CAAC,MAAM;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,0BAA0B;IACzC,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA4BD,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,EAChC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,0BAA0B,GACnC,MAAM,CAAC;AACV,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,CAAC,SAAS,MAAM,EAAE,CAAC,EAC3C,OAAO,EAAE,cAAc,CAAC,SAAS,MAAM,EAAE,CAAC,EAC1C,OAAO,CAAC,EAAE,0BAA0B,GACnC,SAAS,MAAM,EAAE,CAAC;AA2CrB,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,MAAM,CAYR;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,MAAM,CAOR"}

package/dist/support/velocity.js

@@ -0,0 +1,75 @@
+function assertFinite(name, value) {
+    if (!Number.isFinite(value)) {
+        throw new RangeError(`${name} must be a finite number`);
+    }
+}
+function validateDeltaTime(previousTime, currentTime, maxSampleAge) {
+    assertFinite('previous.time', previousTime);
+    assertFinite('current.time', currentTime);
+    const deltaTime = currentTime - previousTime;
+    if (deltaTime < 0)
+        throw new RangeError('sample times must be monotonic');
+    if (deltaTime === 0 || deltaTime > maxSampleAge)
+        return undefined;
+    return deltaTime;
+}
+function resolvedMaxSampleAge(value) {
+    if (value === undefined)
+        return Number.POSITIVE_INFINITY;
+    assertFinite('maxSampleAge', value);
+    if (value <= 0)
+        throw new RangeError('maxSampleAge must be greater than 0');
+    return value;
+}
+export function velocityFromSamples(previous, current, options = {}) {
+    const deltaTime = validateDeltaTime(previous.time, current.time, resolvedMaxSampleAge(options.maxSampleAge));
+    if (typeof previous.value === 'number' && typeof current.value === 'number') {
+        assertFinite('previous.value', previous.value);
+        assertFinite('current.value', current.value);
+        if (deltaTime === undefined)
+            return 0;
+        const velocity = (current.value - previous.value) / deltaTime;
+        assertFinite('velocity', velocity);
+        return velocity;
+    }
+    if (Array.isArray(previous.value) && Array.isArray(current.value)) {
+        const previousValues = previous.value;
+        const currentValues = current.value;
+        if (previousValues.length !== currentValues.length) {
+            throw new RangeError('sample vectors must have the same number of components');
+        }
+        return Object.freeze(previousValues.map((previousValue, index) => {
+            const currentValue = currentValues[index];
+            assertFinite(`previous.value[${index}]`, previousValue);
+            assertFinite(`current.value[${index}]`, currentValue);
+            if (deltaTime === undefined)
+                return 0;
+            const velocity = (currentValue - previousValue) / deltaTime;
+            assertFinite(`velocity[${index}]`, velocity);
+            return velocity;
+        }));
+    }
+    throw new TypeError('sample values must both be numbers or numeric vectors');
+}
+export function normalizedVelocity(velocity, from, to) {
+    assertFinite('velocity', velocity);
+    assertFinite('from', from);
+    assertFinite('to', to);
+    const distance = to - from;
+    assertFinite('distance', distance);
+    if (distance === 0) {
+        throw new RangeError('normalized velocity requires a non-zero distance');
+    }
+    const result = velocity / distance;
+    assertFinite('normalizedVelocity', result);
+    return result;
+}
+export function physicalVelocity(velocity, from, to) {
+    assertFinite('normalizedVelocity', velocity);
+    assertFinite('from', from);
+    assertFinite('to', to);
+    const result = velocity * (to - from);
+    assertFinite('physicalVelocity', result);
+    return result;
+}
+//# sourceMappingURL=velocity.js.map

package/dist/support/velocity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"velocity.js","sourceRoot":"","sources":["../../src/support/velocity.ts"],"names":[],"mappings":"AAWA,SAAS,YAAY,CAAC,IAAY,EAAE,KAAa;IAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,0BAA0B,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,YAAoB,EACpB,WAAmB,EACnB,YAAoB;IAEpB,YAAY,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IAC5C,YAAY,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC;IAC7C,IAAI,SAAS,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,gCAAgC,CAAC,CAAC;IAC1E,IAAI,SAAS,KAAK,CAAC,IAAI,SAAS,GAAG,YAAY;QAAE,OAAO,SAAS,CAAC;IAClE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAyB;IACrD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,iBAAiB,CAAC;IACzD,YAAY,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACpC,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;IAC5E,OAAO,KAAK,CAAC;AACf,CAAC;AAYD,MAAM,UAAU,mBAAmB,CACjC,QAAoD,EACpD,OAAmD,EACnD,UAAsC,EAAE;IAExC,MAAM,SAAS,GAAG,iBAAiB,CACjC,QAAQ,CAAC,IAAI,EACb,OAAO,CAAC,IAAI,EACZ,oBAAoB,CAAC,OAAO,CAAC,YAAY,CAAC,CAC3C,CAAC;IAEF,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5E,YAAY,CAAC,gBAAgB,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/C,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;QAC9D,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACnC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClE,MAAM,cAAc,GAAG,QAAQ,CAAC,KAA0B,CAAC;QAC3D,MAAM,aAAa,GAAG,OAAO,CAAC,KAA0B,CAAC;QACzD,IAAI,cAAc,CAAC,MAAM,KAAK,aAAa,CAAC,MAAM,EAAE,CAAC;YACnD,MAAM,IAAI,UAAU,CAAC,wDAAwD,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAClB,cAAc,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,KAAK,EAAE,EAAE;YAC1C,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,CAAE,CAAC;YAC3C,YAAY,CAAC,kBAAkB,KAAK,GAAG,EAAE,aAAa,CAAC,CAAC;YACxD,YAAY,CAAC,iBAAiB,KAAK,GAAG,EAAE,YAAY,CAAC,CAAC;YACtD,IAAI,SAAS,KAAK,SAAS;gBAAE,OAAO,CAAC,CAAC;YACtC,MAAM,QAAQ,GAAG,CAAC,YAAY,GAAG,aAAa,CAAC,GAAG,SAAS,CAAC;YAC5D,YAAY,CAAC,YAAY,KAAK,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC7C,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,SAAS,CAAC,uDAAuD,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,IAAY,EACZ,EAAU;IAEV,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACnC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3B,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvB,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,UAAU,CAAC,kDAAkD,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACnC,YAAY,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IAC3C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,IAAY,EACZ,EAAU;IAEV,YAAY,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IAC7C,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3B,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvB,MAAM,MAAM,GAAG,QAAQ,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,YAAY,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC;AAChB,CAAC"}