tensum 0.1.0

package/dist/parameters.js

@@ -0,0 +1,124 @@
+import { angularFrequency, assertFinite, classifyDamping, dampingRatio, } from './math.js';
+import { validateSpringParameters } from './solver.js';
+const DEFAULT_MASS = 1;
+const TWO_PI = 2 * Math.PI;
+function assertPositive(name, value) {
+    assertFinite(name, value);
+    if (value <= 0)
+        throw new RangeError(`${name} must be greater than 0`);
+}
+function assertNonNegative(name, value) {
+    assertFinite(name, value);
+    if (value < 0)
+        throw new RangeError(`${name} must be greater than or equal to 0`);
+}
+function resolvedMass(mass) {
+    const value = mass === undefined ? DEFAULT_MASS : mass;
+    assertPositive('mass', value);
+    return value;
+}
+function freezeParameters(parameters) {
+    validateSpringParameters(parameters);
+    const frequency = angularFrequency(parameters);
+    const ratio = dampingRatio(parameters);
+    assertPositive('angularFrequency', frequency);
+    assertFinite('dampingRatio', ratio);
+    return Object.freeze({ ...parameters });
+}
+function fromFrequency(frequency, ratio, mass) {
+    assertPositive('angularFrequency', frequency);
+    assertNonNegative('dampingRatio', ratio);
+    const stiffness = mass * frequency * frequency;
+    let damping = 2 * ratio * mass * frequency;
+    if (!Number.isFinite(damping) || damping === 0) {
+        const candidates = [
+            2 * mass * ratio * frequency,
+            2 * frequency * mass * ratio,
+            2 * mass * (ratio * frequency),
+        ];
+        const representable = candidates.find((candidate) => Number.isFinite(candidate) && candidate > 0);
+        if (representable !== undefined)
+            damping = representable;
+    }
+    return freezeParameters({ mass, stiffness, damping });
+}
+function bounceToDampingRatio(bounce) {
+    assertFinite('bounce', bounce);
+    if (bounce <= -1) {
+        throw new RangeError('bounce must be greater than -1 for finite spring parameters');
+    }
+    if (bounce >= 0)
+        return 1 - Math.min(bounce, 1);
+    return 1 / (1 + bounce);
+}
+function dampingRatioToBounce(ratio) {
+    return ratio <= 1 ? 1 - ratio : 1 / ratio - 1;
+}
+export function springCharacteristics(parameters) {
+    validateSpringParameters(parameters);
+    const frequency = angularFrequency(parameters);
+    const ratio = dampingRatio(parameters);
+    assertPositive('angularFrequency', frequency);
+    assertFinite('dampingRatio', ratio);
+    const response = TWO_PI / frequency;
+    assertPositive('response', response);
+    return Object.freeze({
+        angularFrequency: frequency,
+        dampingRatio: ratio,
+        regime: classifyDamping(ratio),
+        response,
+        bounce: dampingRatioToBounce(ratio),
+        perceptualDuration: response,
+    });
+}
+export const springParameters = Object.freeze({
+    fromPhysics(parameters) {
+        return freezeParameters({
+            mass: parameters.mass,
+            stiffness: parameters.stiffness,
+            damping: parameters.damping,
+        });
+    },
+    fromResponse({ response, dampingRatio: ratio, mass, }) {
+        assertPositive('response', response);
+        return fromFrequency(TWO_PI / response, ratio, resolvedMass(mass));
+    },
+    fromPerceptualDuration({ duration, bounce, mass, }) {
+        assertPositive('duration', duration);
+        return fromFrequency(TWO_PI / duration, bounceToDampingRatio(bounce), resolvedMass(mass));
+    },
+    fromSettlingDuration({ duration, dampingRatio: ratio, epsilon, mass, }) {
+        assertPositive('duration', duration);
+        assertPositive('dampingRatio', ratio);
+        assertFinite('epsilon', epsilon);
+        if (epsilon <= 0 || epsilon >= 1) {
+            throw new RangeError('epsilon must be greater than 0 and less than 1');
+        }
+        const frequency = -Math.log(epsilon) / (ratio * duration);
+        return fromFrequency(frequency, ratio, resolvedMass(mass));
+    },
+    fromVisualDuration({ visualDuration, bounce, mass, }) {
+        return springParameters.fromPerceptualDuration({
+            duration: visualDuration,
+            bounce,
+            ...(mass === undefined ? {} : { mass }),
+        });
+    },
+});
+function createPreset(baseBounce) {
+    return (options = {}) => {
+        const extraBounce = options.extraBounce === undefined ? 0 : options.extraBounce;
+        assertFinite('extraBounce', extraBounce);
+        return springParameters.fromPerceptualDuration({
+            duration: options.duration === undefined ? 0.5 : options.duration,
+            bounce: baseBounce + extraBounce,
+            ...(options.mass === undefined ? {} : { mass: options.mass }),
+        });
+    };
+}
+export const springPresets = Object.freeze({
+    smooth: createPreset(0),
+    snappy: createPreset(0.15),
+    bouncy: createPreset(0.3),
+});
+//# sourceMappingURL=parameters.js.map

package/dist/parameters.js.map

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

package/dist/settling.d.ts

@@ -0,0 +1,12 @@
+import type { AnalyticalSolver } from './solver.js';
+import type { SettlingResult, SpringSettleInput, SpringSettlingOptions } from './types.js';
+export declare const DEFAULT_SETTLING_OPTIONS: Readonly<SpringSettlingOptions>;
+export declare function resolveSettlingOptions(input?: SpringSettleInput): Readonly<SpringSettlingOptions>;
+export declare function validateSettlingOptions(options: SpringSettlingOptions): void;
+/**
+ * Finds the first time at which analytical tail envelopes are below both
+ * tolerances. The envelopes bound every future position error and velocity,
+ * so an underdamped zero-crossing cannot be mistaken for settlement.
+ */
+export declare function getSettlingResult(solver: AnalyticalSolver, options: SpringSettlingOptions): SettlingResult;
+//# sourceMappingURL=settling.d.ts.map

package/dist/settling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settling.d.ts","sourceRoot":"","sources":["../src/settling.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,qBAAqB,CAKpE,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,KAAK,GAAE,iBAAsB,GAC5B,QAAQ,CAAC,qBAAqB,CAAC,CAwBjC;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAqB5E;AAaD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAuDhB"}

package/dist/settling.js

@@ -0,0 +1,107 @@
+import { assertFinite } from './math.js';
+export const DEFAULT_SETTLING_OPTIONS = {
+    positionEpsilon: 0.1,
+    velocityEpsilon: 0.1,
+    maxDuration: 60,
+    refinementIterations: 48,
+};
+export function resolveSettlingOptions(input = {}) {
+    if (typeof input !== 'object' || input === null || Array.isArray(input)) {
+        throw new TypeError('settle must be an object when provided');
+    }
+    const options = {
+        positionEpsilon: input.position === undefined
+            ? DEFAULT_SETTLING_OPTIONS.positionEpsilon
+            : input.position,
+        velocityEpsilon: input.velocity === undefined
+            ? DEFAULT_SETTLING_OPTIONS.velocityEpsilon
+            : input.velocity,
+        maxDuration: input.maxDuration === undefined
+            ? DEFAULT_SETTLING_OPTIONS.maxDuration
+            : input.maxDuration,
+        refinementIterations: input.refinementIterations === undefined
+            ? DEFAULT_SETTLING_OPTIONS.refinementIterations
+            : input.refinementIterations,
+    };
+    validateSettlingOptions(options);
+    return Object.freeze(options);
+}
+export function validateSettlingOptions(options) {
+    assertFinite('positionEpsilon', options.positionEpsilon);
+    assertFinite('velocityEpsilon', options.velocityEpsilon);
+    assertFinite('maxDuration', options.maxDuration);
+    assertFinite('refinementIterations', options.refinementIterations);
+    if (options.positionEpsilon <= 0) {
+        throw new RangeError('positionEpsilon must be greater than 0');
+    }
+    if (options.velocityEpsilon <= 0) {
+        throw new RangeError('velocityEpsilon must be greater than 0');
+    }
+    if (options.maxDuration <= 0) {
+        throw new RangeError('maxDuration must be greater than 0');
+    }
+    if (!Number.isInteger(options.refinementIterations)) {
+        throw new RangeError('refinementIterations must be an integer');
+    }
+    if (options.refinementIterations <= 0) {
+        throw new RangeError('refinementIterations must be greater than 0');
+    }
+}
+function boundsMeetThresholds(solver, time, options) {
+    const bounds = solver.tailBoundsAt(time);
+    return (bounds.position <= options.positionEpsilon && bounds.velocity <= options.velocityEpsilon);
+}
+/**
+ * Finds the first time at which analytical tail envelopes are below both
+ * tolerances. The envelopes bound every future position error and velocity,
+ * so an underdamped zero-crossing cannot be mistaken for settlement.
+ */
+export function getSettlingResult(solver, options) {
+    validateSettlingOptions(options);
+    const { maxDuration, refinementIterations } = options;
+    const initialBounds = solver.tailBoundsAt(0);
+    if (initialBounds.position === 0 && initialBounds.velocity === 0) {
+        return { duration: 0, iterations: 0, settled: true };
+    }
+    if (boundsMeetThresholds(solver, 0, options) && solver.tailBoundsMonotonicAfter === 0) {
+        return { duration: 0, iterations: 0, settled: true };
+    }
+    // An undamped non-equilibrium oscillator has a constant analytical envelope.
+    if (solver.dampingRatio === 0) {
+        return { duration: maxDuration, iterations: 0, settled: false };
+    }
+    if (solver.tailBoundsMonotonicAfter > maxDuration) {
+        return { duration: maxDuration, iterations: 0, settled: false };
+    }
+    let iterations = 0;
+    let lower = solver.tailBoundsMonotonicAfter;
+    let upper = Math.max(lower, Math.min(maxDuration, Math.max(1 / solver.angularFrequency, 1 / 120)));
+    if (boundsMeetThresholds(solver, lower, options)) {
+        // Critical-damping polynomial envelopes can grow before this point. Using
+        // the monotonic boundary is conservative and avoids an invalid binary
+        // search across that non-monotonic interval.
+        return { duration: lower, iterations, settled: true };
+    }
+    else {
+        while (upper < maxDuration && !boundsMeetThresholds(solver, upper, options)) {
+            lower = upper;
+            upper = Math.min(maxDuration, upper * 2);
+            iterations += 1;
+        }
+    }
+    if (!boundsMeetThresholds(solver, upper, options)) {
+        return { duration: maxDuration, iterations, settled: false };
+    }
+    for (let index = 0; index < refinementIterations; index += 1) {
+        const midpoint = lower + (upper - lower) / 2;
+        if (midpoint === lower || midpoint === upper)
+            break;
+        if (boundsMeetThresholds(solver, midpoint, options))
+            upper = midpoint;
+        else
+            lower = midpoint;
+        iterations += 1;
+    }
+    return { duration: upper, iterations, settled: true };
+}
+//# sourceMappingURL=settling.js.map

package/dist/settling.js.map

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

package/dist/solver.d.ts

@@ -0,0 +1,17 @@
+import type { SpringInitialState, SpringParameters, SpringRegime, SpringState } from './types.js';
+export interface AnalyticalSolver {
+    readonly angularFrequency: number;
+    readonly dampingRatio: number;
+    readonly regime: SpringRegime;
+    stateAt(time: number): SpringState;
+    tailBoundsAt(time: number): SpringState;
+    tailBoundsMonotonicAfter: number;
+}
+export declare function validateSpringParameters(parameters: SpringParameters): void;
+export declare function validateInitialState(initial: SpringInitialState): void;
+/**
+ * Solves m·x″ + c·x′ + k·(x - target) = 0 in closed form.
+ * Every sample is calculated from the initial conditions and absolute time.
+ */
+export declare function createAnalyticalSolver(parameters: SpringParameters, initial: SpringInitialState): AnalyticalSolver;
+//# sourceMappingURL=solver.d.ts.map

package/dist/solver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solver.d.ts","sourceRoot":"","sources":["../src/solver.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IACnC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IACxC,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAQ3E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAItE;AAyBD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,kBAAkB,GAC1B,gBAAgB,CA+LlB"}

package/dist/solver.js

@@ -0,0 +1,190 @@
+import { angularFrequency, assertFinite, assertNonNegativeTime, classifyDamping, dampingDecayRate, dampingRatio, } from './math.js';
+export function validateSpringParameters(parameters) {
+    assertFinite('mass', parameters.mass);
+    assertFinite('stiffness', parameters.stiffness);
+    assertFinite('damping', parameters.damping);
+    if (parameters.mass <= 0)
+        throw new RangeError('mass must be greater than 0');
+    if (parameters.stiffness <= 0)
+        throw new RangeError('stiffness must be greater than 0');
+    if (parameters.damping < 0)
+        throw new RangeError('damping must be greater than or equal to 0');
+}
+export function validateInitialState(initial) {
+    assertFinite('position', initial.position);
+    assertFinite('velocity', initial.velocity);
+    assertFinite('target', initial.target);
+}
+function finiteState(position, velocity, suffix = '') {
+    assertFinite(`position${suffix}`, position);
+    assertFinite(`velocity${suffix}`, velocity);
+    return { position, velocity };
+}
+function multiplyDivide(first, second, divisor) {
+    const firstQuotient = (first / divisor) * second;
+    const secondQuotient = first * (second / divisor);
+    if (Number.isFinite(firstQuotient)) {
+        if (firstQuotient !== 0 || secondQuotient === 0)
+            return firstQuotient;
+    }
+    return secondQuotient;
+}
+/**
+ * Solves m·x″ + c·x′ + k·(x - target) = 0 in closed form.
+ * Every sample is calculated from the initial conditions and absolute time.
+ */
+export function createAnalyticalSolver(parameters, initial) {
+    validateSpringParameters(parameters);
+    validateInitialState(initial);
+    // Keep the public solver deterministic if the caller later reuses and
+    // mutates its input object.
+    const initialPosition = initial.position;
+    const initialVelocity = initial.velocity;
+    const target = initial.target;
+    const omega0 = angularFrequency(parameters);
+    const alpha = dampingDecayRate(parameters);
+    const zeta = dampingRatio(parameters);
+    assertFinite('angularFrequency', omega0);
+    assertFinite('dampingDecayRate', alpha);
+    assertFinite('dampingRatio', zeta);
+    if (omega0 <= 0) {
+        throw new RangeError('spring parameters must produce a positive angularFrequency');
+    }
+    const regime = classifyDamping(zeta);
+    const y0 = initialPosition - target;
+    const v0 = initialVelocity;
+    assertFinite('initial displacement', y0);
+    if (regime === 'underdamped') {
+        const omegaD = omega0 * Math.sqrt(Math.max(0, (1 - zeta) * (1 + zeta)));
+        const a = y0;
+        const b = (v0 + alpha * y0) / omegaD;
+        const velocityCos = -alpha * a + omegaD * b;
+        const velocitySin = -alpha * b - omegaD * a;
+        const positionAmplitude = Math.hypot(a, b);
+        const velocityAmplitude = Math.hypot(velocityCos, velocitySin);
+        for (const [name, value] of [
+            ['dampedAngularFrequency', omegaD],
+            ['positionCoefficient', b],
+            ['velocityCosCoefficient', velocityCos],
+            ['velocitySinCoefficient', velocitySin],
+            ['positionAmplitude', positionAmplitude],
+            ['velocityAmplitude', velocityAmplitude],
+        ]) {
+            assertFinite(name, value);
+        }
+        return {
+            angularFrequency: omega0,
+            dampingRatio: zeta,
+            regime,
+            stateAt(time) {
+                assertNonNegativeTime(time);
+                if (time === 0) {
+                    return { position: initialPosition, velocity: initialVelocity };
+                }
+                const decay = Math.exp(-alpha * time);
+                if (decay === 0)
+                    return { position: target, velocity: 0 };
+                const rawPhase = omegaD * time;
+                const phase = Number.isFinite(rawPhase)
+                    ? rawPhase
+                    : (time % ((2 * Math.PI) / omegaD)) * omegaD;
+                const cosine = Math.cos(phase);
+                const sine = Math.sin(phase);
+                return finiteState(target + decay * (a * cosine + b * sine), decay * (velocityCos * cosine + velocitySin * sine));
+            },
+            tailBoundsAt(time) {
+                assertNonNegativeTime(time);
+                const decay = Math.exp(-alpha * time);
+                return finiteState(decay * positionAmplitude, decay * velocityAmplitude, ' bound');
+            },
+            tailBoundsMonotonicAfter: 0,
+        };
+    }
+    if (regime === 'critical') {
+        const a = y0;
+        const b = v0 + omega0 * y0;
+        const velocityConstant = b - omega0 * a;
+        const velocityLinear = -omega0 * b;
+        for (const [name, value] of [
+            ['positionCoefficient', b],
+            ['velocityConstant', velocityConstant],
+            ['velocityLinear', velocityLinear],
+        ]) {
+            assertFinite(name, value);
+        }
+        return {
+            angularFrequency: omega0,
+            dampingRatio: zeta,
+            regime,
+            stateAt(time) {
+                assertNonNegativeTime(time);
+                if (time === 0) {
+                    return { position: initialPosition, velocity: initialVelocity };
+                }
+                const decay = Math.exp(-omega0 * time);
+                if (decay === 0)
+                    return { position: target, velocity: 0 };
+                const timeDecay = time * decay;
+                return finiteState(target + decay * a + timeDecay * b, decay * velocityConstant + timeDecay * velocityLinear);
+            },
+            tailBoundsAt(time) {
+                assertNonNegativeTime(time);
+                const decay = Math.exp(-omega0 * time);
+                if (decay === 0)
+                    return { position: 0, velocity: 0 };
+                const timeDecay = time * decay;
+                return finiteState(decay * Math.abs(a) + timeDecay * Math.abs(b), decay * Math.abs(velocityConstant) +
+                    timeDecay * Math.abs(velocityLinear), ' bound');
+            },
+            // Every t·exp(-ωt) term decreases after t = 1/ω.
+            tailBoundsMonotonicAfter: 1 / omega0,
+        };
+    }
+    const normalizedFrequency = omega0 / alpha;
+    const normalizedOffset = Math.sqrt(Math.max(0, (1 - normalizedFrequency) * (1 + normalizedFrequency)));
+    const rootFastMagnitude = alpha * (1 + normalizedOffset);
+    const rootFast = -rootFastMagnitude;
+    // Vieta's relation avoids subtracting two almost equal values in
+    // -alpha + sqrt(alpha² - omega0²).
+    const rootSlow = -omega0 * (omega0 / rootFastMagnitude);
+    const rootSeparation = rootSlow - rootFast;
+    const normalizedVelocity = v0 / rootSeparation;
+    const coefficientSlow = normalizedVelocity - multiplyDivide(rootFast, y0, rootSeparation);
+    const coefficientFast = multiplyDivide(rootSlow, y0, rootSeparation) - normalizedVelocity;
+    for (const [name, value] of [
+        ['overdampedSlowRoot', rootSlow],
+        ['overdampedFastRoot', rootFast],
+        ['overdampedRootSeparation', rootSeparation],
+        ['slowModeCoefficient', coefficientSlow],
+        ['fastModeCoefficient', coefficientFast],
+    ]) {
+        assertFinite(name, value);
+    }
+    if (rootSlow >= 0 || rootFast >= 0 || rootSeparation <= 0) {
+        throw new RangeError('overdamped roots must be distinct negative finite numbers');
+    }
+    return {
+        angularFrequency: omega0,
+        dampingRatio: zeta,
+        regime,
+        stateAt(time) {
+            assertNonNegativeTime(time);
+            if (time === 0) {
+                return { position: initialPosition, velocity: initialVelocity };
+            }
+            const slow = coefficientSlow * Math.exp(rootSlow * time);
+            const fast = coefficientFast * Math.exp(rootFast * time);
+            return finiteState(target + slow + fast, rootSlow * slow + rootFast * fast);
+        },
+        tailBoundsAt(time) {
+            assertNonNegativeTime(time);
+            const slowDecay = Math.exp(rootSlow * time);
+            const fastDecay = Math.exp(rootFast * time);
+            return finiteState(Math.abs(coefficientSlow) * slowDecay +
+                Math.abs(coefficientFast) * fastDecay, Math.abs(rootSlow * coefficientSlow) * slowDecay +
+                Math.abs(rootFast * coefficientFast) * fastDecay, ' bound');
+        },
+        tailBoundsMonotonicAfter: 0,
+    };
+}
+//# sourceMappingURL=solver.js.map

package/dist/solver.js.map

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

package/dist/spring.d.ts

@@ -0,0 +1,9 @@
+import type { SpringInitialState, SpringOptions, SpringParameters, SpringSettleInput, SpringSolution, SpringTimingInput } from './types.js';
+export interface SpringSolutionOptions {
+    settle?: SpringSettleInput;
+    timing?: SpringTimingInput;
+}
+export declare function resolveSpringTimingInput(input: SpringTimingInput | undefined): Readonly<SpringTimingInput> | undefined;
+export declare function createSpringSolution(parameters: SpringParameters, initialState: SpringInitialState, options?: SpringSolutionOptions): SpringSolution;
+export declare function createSpring(options: SpringOptions): SpringSolution;
+//# sourceMappingURL=spring.d.ts.map

package/dist/spring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring.d.ts","sourceRoot":"","sources":["../src/spring.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EAGd,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,iBAAiB,GAAG,SAAS,GACnC,QAAQ,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAWzC;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,gBAAgB,EAC5B,YAAY,EAAE,kBAAkB,EAChC,OAAO,GAAE,qBAA0B,GAClC,cAAc,CA6DhB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAiBnE"}

package/dist/spring.js

@@ -0,0 +1,91 @@
+import { assertFinite } from './math.js';
+import { getSettlingResult, resolveSettlingOptions } from './settling.js';
+import { createAnalyticalSolver } from './solver.js';
+export function resolveSpringTimingInput(input) {
+    if (input === undefined)
+        return undefined;
+    if (typeof input !== 'object' || input === null || Array.isArray(input)) {
+        throw new TypeError('timing must be an object when provided');
+    }
+    if (input.perceptualDuration === undefined)
+        return Object.freeze({});
+    assertFinite('perceptualDuration', input.perceptualDuration);
+    if (input.perceptualDuration < 0) {
+        throw new RangeError('perceptualDuration must be greater than or equal to 0');
+    }
+    return Object.freeze({ perceptualDuration: input.perceptualDuration });
+}
+export function createSpringSolution(parameters, initialState, options = {}) {
+    const resolvedTiming = resolveSpringTimingInput(options.timing);
+    const settling = resolveSettlingOptions(options.settle);
+    const solver = createAnalyticalSolver(parameters, initialState);
+    const settlingResult = getSettlingResult(solver, settling);
+    const requestedPerceptualDuration = resolvedTiming?.perceptualDuration;
+    const perceptualDuration = requestedPerceptualDuration === undefined
+        ? (2 * Math.PI) / solver.angularFrequency
+        : requestedPerceptualDuration;
+    assertFinite('perceptualDuration', perceptualDuration);
+    if (perceptualDuration < 0) {
+        throw new RangeError('perceptualDuration must be greater than or equal to 0');
+    }
+    const timing = {
+        perceptualDuration,
+        settlingDuration: settlingResult.duration,
+        settled: settlingResult.settled,
+    };
+    const stateAt = (time) => solver.stateAt(time);
+    return Object.freeze({
+        dampingRatio: solver.dampingRatio,
+        angularFrequency: solver.angularFrequency,
+        regime: solver.regime,
+        parameters: Object.freeze({ ...parameters }),
+        initialState: Object.freeze({ ...initialState }),
+        settling,
+        timing: Object.freeze(timing),
+        positionAt(time) {
+            return stateAt(time).position;
+        },
+        velocityAt(time) {
+            return stateAt(time).velocity;
+        },
+        stateAt,
+        getSettlingDuration() {
+            return settlingResult.duration;
+        },
+        getSettlingResult() {
+            return { ...settlingResult };
+        },
+        retarget(target, time) {
+            assertFinite('target', target);
+            const current = stateAt(time);
+            return createSpringSolution(parameters, {
+                position: current.position,
+                velocity: current.velocity,
+                target,
+            }, {
+                settle: {
+                    position: settling.positionEpsilon,
+                    velocity: settling.velocityEpsilon,
+                    maxDuration: settling.maxDuration,
+                    refinementIterations: settling.refinementIterations,
+                },
+                timing: { perceptualDuration: timing.perceptualDuration },
+            });
+        },
+    });
+}
+export function createSpring(options) {
+    return createSpringSolution({
+        mass: options.mass,
+        stiffness: options.stiffness,
+        damping: options.damping,
+    }, {
+        position: options.from,
+        velocity: options.velocity === undefined ? 0 : options.velocity,
+        target: options.to,
+    }, {
+        ...(options.settle === undefined ? {} : { settle: options.settle }),
+        ...(options.timing === undefined ? {} : { timing: options.timing }),
+    });
+}
+//# sourceMappingURL=spring.js.map

package/dist/spring.js.map

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

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

@@ -0,0 +1,39 @@
+import type { SpringParameters, SpringSettleInput, SpringTimingInput } from '../types.js';
+import type { FrameDriver } from './spring-value.js';
+export interface AdditiveSpringOptions {
+    settle?: SpringSettleInput;
+    timing?: SpringTimingInput;
+}
+export interface AdditiveSpringContributionOptions {
+    parameters?: SpringParameters;
+    settle?: SpringSettleInput;
+    timing?: SpringTimingInput;
+    velocity?: number;
+}
+export interface AdditiveSpringSnapshot {
+    value: number;
+    velocity: number;
+    target: number;
+    animating: boolean;
+    contributions: number;
+}
+export type AdditiveSpringEvent = 'change' | 'settle' | 'unsettled';
+export type AdditiveSpringListener = (snapshot: Readonly<AdditiveSpringSnapshot>) => void;
+export interface AdditiveSpringValue {
+    get(): number;
+    getVelocity(): number;
+    getTarget(): number;
+    getSnapshot(): Readonly<AdditiveSpringSnapshot>;
+    animateBy(delta: number, options?: AdditiveSpringContributionOptions): number;
+    cancel(contribution: number): void;
+    jump(value: number): void;
+    stop(): void;
+    on(event: AdditiveSpringEvent, listener: AdditiveSpringListener): () => void;
+    destroy(): void;
+}
+/**
+ * Composes overlapping spring effects as independent additive contributions.
+ * Use createSpringValue when each new target should replace the previous one.
+ */
+export declare function createAdditiveSpringValue(initialValue: number, parameters: SpringParameters, driver: FrameDriver, options?: AdditiveSpringOptions): AdditiveSpringValue;
+//# sourceMappingURL=additive-spring-value.d.ts.map