@flighthq/easing 0.3.0-next.1783.cd11ab1 → 0.3.0-next.1848.58f06fb

package/dist/contract.d.ts

@@ -6,6 +6,7 @@ export * from './easeCircular';
 export * from './easeCombinators';
 export * from './easeCubic';
 export * from './easeCubicBezier';
+export * from './easeDampedSine';
 export * from './easeElastic';
 export * from './easeExponential';
 export * from './easeLinear';

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC"}

package/dist/contract.js

@@ -6,6 +6,7 @@ export * from './easeCircular';
 export * from './easeCombinators';
 export * from './easeCubic';
 export * from './easeCubicBezier';
+export * from './easeDampedSine';
 export * from './easeElastic';
 export * from './easeExponential';
 export * from './easeLinear';

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC"}

package/dist/easeDampedSine.d.ts

@@ -0,0 +1,34 @@
+import type { EasingFunction } from '@flighthq/types/contract';
+/**
+ * The parameterized form of `easeInElastic`: a decaying sine that winds up before departing, with the
+ * overshoot and wavelength stated rather than fixed.
+ */
+export declare function easeInDampedSine(amplitude: number, period: number): EasingFunction;
+/**
+ * The parameterized form of `easeInOutElastic`: a decaying sine that winds up, crosses, and settles,
+ * with the overshoot and wavelength stated rather than fixed.
+ */
+export declare function easeInOutDampedSine(amplitude: number, period: number): EasingFunction;
+/**
+ * The parameterized form of `easeOutElastic`: a decaying sine that overshoots the target and settles
+ * back onto it.
+ *
+ * `easeInElastic` / `easeOutElastic` / `easeInOutElastic` are this same published curve with the two
+ * parameters fixed. They stay the right choice when those constants suit; this family exists for a
+ * caller that states its own — an importer whose source file names an amplitude and a period, where
+ * substituting the fixed curve would be confidently wrong rather than approximately right.
+ *
+ * **Both degenerate cases are Flight's own choices, not anyone else's**, and both are stated here
+ * because they are the only places this can differ from another implementation of the same curve:
+ *
+ * - **An amplitude below 1 is raised to 1.** The phase term is `asin(1 / amplitude)`, which has no real
+ *   solution below unit amplitude, so the published curve is simply not defined there. Rather than
+ *   invent a shape for it we take the smallest curve the form does define, which also keeps the
+ *   endpoints exact. An elastic with less than unit overshoot is a contradiction in terms.
+ * - **A non-positive period falls back to 0.4.** It divides the wave, so zero has no meaning. 0.4 is the
+ *   constant our own `easeOutElastic` already uses, so a caller who states nothing gets the curve this
+ *   package's preset would have given — the least surprising answer available, and one that keeps the
+ *   two families consistent with each other.
+ */
+export declare function easeOutDampedSine(amplitude: number, period: number): EasingFunction;
+//# sourceMappingURL=easeDampedSine.d.ts.map

package/dist/easeDampedSine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easeDampedSine.d.ts","sourceRoot":"","sources":["../src/easeDampedSine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CASlF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAYrF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAQnF"}

package/dist/easeDampedSine.js

@@ -0,0 +1,81 @@
+/**
+ * The parameterized form of `easeInElastic`: a decaying sine that winds up before departing, with the
+ * overshoot and wavelength stated rather than fixed.
+ */
+export function easeInDampedSine(amplitude, period) {
+    const wavelength = toDampedSineWavelength(period);
+    const overshoot = toDampedSineOvershoot(amplitude);
+    const phase = toDampedSinePhase(overshoot, wavelength);
+    return (t) => {
+        if (t === 0 || t === 1)
+            return t;
+        const time = t - 1;
+        return -(overshoot * Math.pow(2, 10 * time) * Math.sin(((time - phase) * TAU) / wavelength));
+    };
+}
+/**
+ * The parameterized form of `easeInOutElastic`: a decaying sine that winds up, crosses, and settles,
+ * with the overshoot and wavelength stated rather than fixed.
+ */
+export function easeInOutDampedSine(amplitude, period) {
+    const wavelength = toDampedSineWavelength(period);
+    const overshoot = toDampedSineOvershoot(amplitude);
+    const phase = toDampedSinePhase(overshoot, wavelength);
+    return (t) => {
+        if (t === 0 || t === 1)
+            return t;
+        const time = t * 2 - 1;
+        if (time < 0) {
+            return -0.5 * overshoot * Math.pow(2, 10 * time) * Math.sin(((time - phase) * TAU) / wavelength);
+        }
+        return 0.5 * overshoot * Math.pow(2, -10 * time) * Math.sin(((time - phase) * TAU) / wavelength) + 1;
+    };
+}
+/**
+ * The parameterized form of `easeOutElastic`: a decaying sine that overshoots the target and settles
+ * back onto it.
+ *
+ * `easeInElastic` / `easeOutElastic` / `easeInOutElastic` are this same published curve with the two
+ * parameters fixed. They stay the right choice when those constants suit; this family exists for a
+ * caller that states its own — an importer whose source file names an amplitude and a period, where
+ * substituting the fixed curve would be confidently wrong rather than approximately right.
+ *
+ * **Both degenerate cases are Flight's own choices, not anyone else's**, and both are stated here
+ * because they are the only places this can differ from another implementation of the same curve:
+ *
+ * - **An amplitude below 1 is raised to 1.** The phase term is `asin(1 / amplitude)`, which has no real
+ *   solution below unit amplitude, so the published curve is simply not defined there. Rather than
+ *   invent a shape for it we take the smallest curve the form does define, which also keeps the
+ *   endpoints exact. An elastic with less than unit overshoot is a contradiction in terms.
+ * - **A non-positive period falls back to 0.4.** It divides the wave, so zero has no meaning. 0.4 is the
+ *   constant our own `easeOutElastic` already uses, so a caller who states nothing gets the curve this
+ *   package's preset would have given — the least surprising answer available, and one that keeps the
+ *   two families consistent with each other.
+ */
+export function easeOutDampedSine(amplitude, period) {
+    const wavelength = toDampedSineWavelength(period);
+    const overshoot = toDampedSineOvershoot(amplitude);
+    const phase = toDampedSinePhase(overshoot, wavelength);
+    return (t) => {
+        if (t === 0 || t === 1)
+            return t;
+        return overshoot * Math.pow(2, -10 * t) * Math.sin(((t - phase) * TAU) / wavelength) + 1;
+    };
+}
+// Where the decaying sine crosses its endpoint, which is what makes t=0 land exactly on 0.
+function toDampedSinePhase(overshoot, wavelength) {
+    return (wavelength / TAU) * Math.asin(1 / overshoot);
+}
+// Below unit overshoot the phase term has no real solution, so the curve is undefined rather than
+// merely small. Clamping is Flight's choice: the smallest defined curve beats an invented one.
+function toDampedSineOvershoot(amplitude) {
+    return amplitude < 1 ? 1 : amplitude;
+}
+// A period divides the wave, so a non-positive one is meaningless. Flight's choice is the constant its
+// own fixed elastic already uses, so the two families agree with each other.
+function toDampedSineWavelength(period) {
+    return period > 0 ? period : DEFAULT_DAMPED_SINE_PERIOD;
+}
+const TAU = 2 * Math.PI;
+const DEFAULT_DAMPED_SINE_PERIOD = 0.4;
+//# sourceMappingURL=easeDampedSine.js.map

package/dist/easeDampedSine.js.map

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

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { createEasingSamples, easeClamp, easeClampOutput, easeCubicBezier, easeInBack, easeInBounce, easeInCircular, easeInCubic, easeInElastic, easeInExponential, easeInOutBack, easeInOutBounce, easeInOutCircular, easeInOutCubic, easeInOutElastic, easeInOutExponential, easeInOutPower, easeInOutQuadratic, easeInOutQuartic, easeInOutQuintic, easeInOutSine, easeInPower, easeInQuadratic, easeInQuartic, easeInQuintic, easeInSine, easeInvert, easeLinear, easeMirror, easeOutBack, easeOutBounce, easeOutCircular, easeOutCubic, easeOutElastic, easeOutExponential, easeOutPower, easeOutQuadratic, easeOutQuartic, easeOutQuintic, easeOutSine, easePiecewise, easeReverse, easeScaleOutput, easeSmootherstep, easeSmoothstep, easeSmoothstepRange, easeSteps, getEasingDerivative, } from './contract';
+export { createEasingSamples, easeClamp, easeClampOutput, easeCubicBezier, easeInBack, easeInBounce, easeInCircular, easeInCubic, easeInDampedSine, easeInElastic, easeInExponential, easeInOutBack, easeInOutBounce, easeInOutCircular, easeInOutCubic, easeInOutDampedSine, easeInOutElastic, easeInOutExponential, easeInOutPower, easeInOutQuadratic, easeInOutQuartic, easeInOutQuintic, easeInOutSine, easeInPower, easeInQuadratic, easeInQuartic, easeInQuintic, easeInSine, easeInvert, easeLinear, easeMirror, easeOutBack, easeOutBounce, easeOutCircular, easeOutCubic, easeOutDampedSine, easeOutElastic, easeOutExponential, easeOutPower, easeOutQuadratic, easeOutQuartic, easeOutQuintic, easeOutSine, easePiecewise, easeReverse, easeScaleOutput, easeSmootherstep, easeSmoothstep, easeSmoothstepRange, easeSteps, getEasingDerivative, } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,eAAe,EACf,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,eAAe,EACf,aAAa,EACb,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,eAAe,EACf,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,eAAe,EACf,aAAa,EACb,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { createEasingSamples, easeClamp, easeClampOutput, easeCubicBezier, easeInBack, easeInBounce, easeInCircular, easeInCubic, easeInElastic, easeInExponential, easeInOutBack, easeInOutBounce, easeInOutCircular, easeInOutCubic, easeInOutElastic, easeInOutExponential, easeInOutPower, easeInOutQuadratic, easeInOutQuartic, easeInOutQuintic, easeInOutSine, easeInPower, easeInQuadratic, easeInQuartic, easeInQuintic, easeInSine, easeInvert, easeLinear, easeMirror, easeOutBack, easeOutBounce, easeOutCircular, easeOutCubic, easeOutElastic, easeOutExponential, easeOutPower, easeOutQuadratic, easeOutQuartic, easeOutQuintic, easeOutSine, easePiecewise, easeReverse, easeScaleOutput, easeSmootherstep, easeSmoothstep, easeSmoothstepRange, easeSteps, getEasingDerivative, } from './contract';
+export { createEasingSamples, easeClamp, easeClampOutput, easeCubicBezier, easeInBack, easeInBounce, easeInCircular, easeInCubic, easeInDampedSine, easeInElastic, easeInExponential, easeInOutBack, easeInOutBounce, easeInOutCircular, easeInOutCubic, easeInOutDampedSine, easeInOutElastic, easeInOutExponential, easeInOutPower, easeInOutQuadratic, easeInOutQuartic, easeInOutQuintic, easeInOutSine, easeInPower, easeInQuadratic, easeInQuartic, easeInQuintic, easeInSine, easeInvert, easeLinear, easeMirror, easeOutBack, easeOutBounce, easeOutCircular, easeOutCubic, easeOutDampedSine, easeOutElastic, easeOutExponential, easeOutPower, easeOutQuadratic, easeOutQuartic, easeOutQuintic, easeOutSine, easePiecewise, easeReverse, easeScaleOutput, easeSmootherstep, easeSmoothstep, easeSmoothstepRange, easeSteps, getEasingDerivative, } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,eAAe,EACf,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,eAAe,EACf,aAAa,EACb,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,eAAe,EACf,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,eAAe,EACf,aAAa,EACb,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/easing",
-  "version": "0.3.0-next.1783.cd11ab1",
+  "version": "0.3.0-next.1848.58f06fb",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,8 +38,8 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/log": "0.3.0-next.1783.cd11ab1",
-    "@flighthq/types": "0.3.0-next.1783.cd11ab1"
+    "@flighthq/log": "0.3.0-next.1848.58f06fb",
+    "@flighthq/types": "0.3.0-next.1848.58f06fb"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/easeDampedSine.test.ts

@@ -0,0 +1,100 @@
+import { easeInDampedSine, easeInOutDampedSine, easeOutDampedSine } from './easeDampedSine';
+import { easeInElastic, easeInOutElastic, easeOutElastic } from './easeElastic';
+
+describe('easeInDampedSine', () => {
+  it('returns 0 at t=0 and 1 at t=1', () => {
+    const ease = easeInDampedSine(1, 0.4);
+
+    expect(ease(0)).toBe(0);
+    expect(ease(1)).toBe(1);
+  });
+
+  it('winds up below 0 before departing', () => {
+    expect(easeInDampedSine(1, 0.4)(0.8)).toBeLessThan(0);
+  });
+
+  it('matches the fixed easeInElastic at the constants that one hardcodes', () => {
+    // The fixed curve is this one at amplitude 1, period 0.4 — the check that the general form is
+    // right rather than merely plausible.
+    const ease = easeInDampedSine(1, 0.4);
+    for (const t of [0.1, 0.25, 0.4, 0.6, 0.75, 0.9]) {
+      expect(ease(t)).toBeCloseTo(easeInElastic(t), 10);
+    }
+  });
+});
+
+describe('easeInOutDampedSine', () => {
+  it('returns 0 at t=0 and 1 at t=1', () => {
+    const ease = easeInOutDampedSine(1, 0.45);
+
+    expect(ease(0)).toBe(0);
+    expect(ease(1)).toBe(1);
+  });
+
+  it('matches the fixed easeInOutElastic at the constants that one hardcodes', () => {
+    const ease = easeInOutDampedSine(1, 0.45);
+    for (const t of [0.1, 0.3, 0.5, 0.7, 0.9]) {
+      expect(ease(t)).toBeCloseTo(easeInOutElastic(t), 10);
+    }
+  });
+});
+
+describe('easeOutDampedSine', () => {
+  it('returns 0 at t=0 and 1 at t=1', () => {
+    const ease = easeOutDampedSine(1, 0.4);
+
+    expect(ease(0)).toBe(0);
+    expect(ease(1)).toBe(1);
+  });
+
+  it('overshoots past 1 near the start', () => {
+    expect(easeOutDampedSine(1, 0.4)(0.6)).toBeGreaterThan(1);
+  });
+
+  it('matches the fixed easeOutElastic at the constants that one hardcodes', () => {
+    const ease = easeOutDampedSine(1, 0.4);
+    for (const t of [0.1, 0.25, 0.4, 0.6, 0.75, 0.9]) {
+      expect(ease(t)).toBeCloseTo(easeOutElastic(t), 10);
+    }
+  });
+
+  it('separates the curves that the fixed form collapses together', () => {
+    // The whole reason this family exists: a source stating its own period gets a materially
+    // different curve, so substituting the fixed one is wrong rather than approximate. Measured as
+    // the widest gap across the curve — any single sample can land where two curves happen to cross.
+    const wide = easeOutDampedSine(1, 0.9);
+    const narrow = easeOutDampedSine(1, 0.2);
+    const widest = Math.max(
+      ...Array.from({ length: 99 }, (_, index) => Math.abs(wide((index + 1) / 100) - narrow((index + 1) / 100))),
+    );
+
+    expect(widest).toBeGreaterThan(0.5);
+  });
+
+  it('overshoots further as amplitude grows', () => {
+    const peak = (amplitude: number): number =>
+      Math.max(...Array.from({ length: 99 }, (_, index) => easeOutDampedSine(amplitude, 0.4)((index + 1) / 100)));
+
+    expect(peak(3)).toBeGreaterThan(peak(1));
+  });
+
+  it('raises an amplitude below 1 to the smallest defined curve', () => {
+    // The phase term is asin(1 / amplitude), which has no real solution below unit amplitude, so the
+    // curve is undefined there rather than merely small. Flight clamps rather than inventing a shape.
+    const clamped = easeOutDampedSine(0.5, 0.4);
+    const unit = easeOutDampedSine(1, 0.4);
+
+    for (const t of [0.2, 0.5, 0.8]) expect(clamped(t)).toBeCloseTo(unit(t), 10);
+    expect(Number.isFinite(clamped(0.3))).toBe(true);
+  });
+
+  it('falls back to this package own fixed period when the period is not positive', () => {
+    // A period divides the wave, so zero has no meaning. Flight's choice is 0.4 — the constant
+    // easeOutElastic already uses — so the parameterized and fixed families agree with each other.
+    for (const period of [0, -1]) {
+      const ease = easeOutDampedSine(1, period);
+      expect(Number.isFinite(ease(0.5))).toBe(true);
+      expect(ease(0.5)).toBeCloseTo(easeOutDampedSine(1, 0.4)(0.5), 10);
+    }
+  });
+});