@flighthq/easing 0.3.0-next.1220.6982c21 → 0.3.0-next.1272.222de94

package/dist/easeSteps.d.ts

@@ -1,3 +1,4 @@
-import type { EasingFunction, StepPosition } from '@flighthq/types/contract';
+import type { EasingFunction, EasingStepsGuard, StepPosition } from '@flighthq/types/contract';
 export declare function easeSteps(count: number, position?: StepPosition): EasingFunction;
+export declare function setEasingStepsGuard(guard: EasingStepsGuard | null): void;
 //# sourceMappingURL=easeSteps.d.ts.map

package/dist/easeSteps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"easeSteps.d.ts","sourceRoot":"","sources":["../src/easeSteps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAc7E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,YAAwB,GAAG,cAAc,CAc3F"}
+{"version":3,"file":"easeSteps.d.ts","sourceRoot":"","sources":["../src/easeSteps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAe/F,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,YAAwB,GAAG,cAAc,CAe3F;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAExE"}

package/dist/easeSteps.js

@@ -6,11 +6,14 @@
 //   jumpBoth  - jump at both edges; count+1 levels from 0 to 1 inclusive.
 // Follows the CSS Easing Level 1 step algorithm.
 //
-// Sharp edge: easeSteps(1, 'jumpNone') has jumps = count - 1 = 0, so the returned
-// function divides by zero and yields NaN. This mirrors the CSS spec, which forbids
-// steps(1, jump-none) for the same reason. Callers must pass count >= 2 with
-// 'jumpNone'; every other position is well-defined for count >= 1.
+// Sharp edge: easeSteps(1, 'jumpNone') has jumps = count - 1 = 0, so the returned function divides by
+// zero and yields NaN for every input. This mirrors the CSS spec, which forbids steps(1, jump-none) for
+// the same reason; `count >= 2` is required with 'jumpNone', while every other position is well-defined
+// for count >= 1. The failure is SILENT — NaN propagates into whatever the easing drives — so the
+// degenerate call routes through the guard seam below, which enableEasingGuards turns into a warning.
 export function easeSteps(count, position = 'jumpEnd') {
+    if (position === 'jumpNone' && count < 2)
+        _stepsGuard?.(count, position);
     const jumps = position === 'jumpNone' ? count - 1 : position === 'jumpBoth' ? count + 1 : count;
     const startOffset = position === 'jumpStart' || position === 'jumpBoth' ? 1 : 0;
     return (t) => {
@@ -24,4 +27,12 @@ export function easeSteps(count, position = 'jumpEnd') {
         return step / jumps;
     };
 }
+// The diagnostics seam for the degenerate `easeSteps` call, not the caller-facing entry point — use
+// `enableEasingGuards`, which installs the @flighthq/log reporter through here. Null uninstalls it, and a
+// null slot is what production sees: the check above is one comparison and the message text plus the
+// @flighthq/log dependency live only in the separately-imported guard module.
+export function setEasingStepsGuard(guard) {
+    _stepsGuard = guard;
+}
+let _stepsGuard = null;
 //# sourceMappingURL=easeSteps.js.map

package/dist/easeSteps.js.map

@@ -1 +1 @@
-{"version":3,"file":"easeSteps.js","sourceRoot":"","sources":["../src/easeSteps.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,gEAAgE;AAChE,yEAAyE;AACzE,+EAA+E;AAC/E,uFAAuF;AACvF,0EAA0E;AAC1E,iDAAiD;AACjD,EAAE;AACF,kFAAkF;AAClF,oFAAoF;AACpF,6EAA6E;AAC7E,mEAAmE;AACnE,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,WAAyB,SAAS;IACzE,MAAM,KAAK,GAAG,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAChG,MAAM,WAAW,GAAG,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhF,OAAO,CAAC,CAAC,EAAE,EAAE;QACX,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,WAAW,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;YAC3B,IAAI,GAAG,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,GAAG,KAAK,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"easeSteps.js","sourceRoot":"","sources":["../src/easeSteps.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,gEAAgE;AAChE,yEAAyE;AACzE,+EAA+E;AAC/E,uFAAuF;AACvF,0EAA0E;AAC1E,iDAAiD;AACjD,EAAE;AACF,sGAAsG;AACtG,wGAAwG;AACxG,wGAAwG;AACxG,kGAAkG;AAClG,sGAAsG;AACtG,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,WAAyB,SAAS;IACzE,IAAI,QAAQ,KAAK,UAAU,IAAI,KAAK,GAAG,CAAC;QAAE,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAChG,MAAM,WAAW,GAAG,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhF,OAAO,CAAC,CAAC,EAAE,EAAE;QACX,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,WAAW,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;YAC3B,IAAI,GAAG,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,GAAG,KAAK,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC;AAED,oGAAoG;AACpG,0GAA0G;AAC1G,qGAAqG;AACrG,8EAA8E;AAC9E,MAAM,UAAU,mBAAmB,CAAC,KAA8B;IAChE,WAAW,GAAG,KAAK,CAAC;AACtB,CAAC;AAED,IAAI,WAAW,GAA4B,IAAI,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/easing",
-  "version": "0.3.0-next.1220.6982c21",
+  "version": "0.3.0-next.1272.222de94",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -36,7 +36,7 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/types": "0.3.0-next.1220.6982c21"
+    "@flighthq/types": "0.3.0-next.1272.222de94"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/easeStepsGuard.test.ts

@@ -0,0 +1,34 @@
+import type { StepPosition } from '@flighthq/types/contract';
+import { describe, expect, it } from 'vitest';
+
+import { easeSteps, setEasingStepsGuard } from './easeSteps';
+
+describe('setEasingStepsGuard', () => {
+  it('reports the degenerate jumpNone call that silently returns NaN', () => {
+    const seen: [number, StepPosition][] = [];
+    setEasingStepsGuard((count, position) => seen.push([count, position]));
+    try {
+      // The failure being reported: one step with no edge jump leaves zero jumps to divide by.
+      expect(Number.isNaN(easeSteps(1, 'jumpNone')(0.5))).toBe(true);
+    } finally {
+      setEasingStepsGuard(null);
+    }
+    expect(seen).toEqual([[1, 'jumpNone']]);
+  });
+
+  it('stays silent for well-defined calls, and when no guard is installed', () => {
+    const seen: number[] = [];
+    setEasingStepsGuard((count) => seen.push(count));
+    try {
+      easeSteps(2, 'jumpNone')(0.5); // count >= 2 is the documented minimum for jumpNone
+      easeSteps(1, 'jumpEnd')(0.5); // every edge-jumping position is defined for count >= 1
+      easeSteps(1, 'jumpStart')(0.5);
+      easeSteps(1, 'jumpBoth')(0.5);
+    } finally {
+      setEasingStepsGuard(null);
+    }
+    expect(seen).toEqual([]);
+    // Production default: still NaN, but nothing is reported.
+    expect(Number.isNaN(easeSteps(1, 'jumpNone')(0.5))).toBe(true);
+  });
+});