@flighthq/motionpath 0.5.0-next.1944.cd6b6e7 → 0.5.1-edge.1047.858b9b6

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/motionpath`. The `@f
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/motionpath@0.5.0-next.1944.cd6b6e7](https://github.com/flighthq/flight/tree/cd6b6e71eb472b3a4249830a7743333f019fa7b7/packages/motionpath)
-- [License](https://github.com/flighthq/flight/blob/cd6b6e71eb472b3a4249830a7743333f019fa7b7/LICENSE.md)
+- [Source for @flighthq/motionpath@0.5.1-edge.1047.858b9b6](https://github.com/flighthq/flight/tree/858b9b601de814f6b6940cbb1ffff0916b903268/packages/motionpath)
+- [License](https://github.com/flighthq/flight/blob/858b9b601de814f6b6940cbb1ffff0916b903268/LICENSE.md)

package/dist/contract.d.ts

@@ -1,2 +1,3 @@
 export * from './motionPath';
+export { initializeMotionPath } from './motionPath';
 //# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/contract.js

@@ -1,2 +1,3 @@
 export * from './motionPath';
+export { initializeMotionPath } from './motionPath';
 //# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { createMotionPath, getMotionPathHeading, getMotionPathPosition, getMotionPathProgress, setMotionPathDistance, setMotionPathProgress, updateMotionPath, } from './contract';
+export { createMotionPath, getMotionPathHeading, getMotionPathPosition, getMotionPathProgress, isMotionPathAtEnd, setMotionPathDistance, setMotionPathProgress, setMotionPathDirection, updateMotionPath, } 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,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { createMotionPath, getMotionPathHeading, getMotionPathPosition, getMotionPathProgress, setMotionPathDistance, setMotionPathProgress, updateMotionPath, } from './contract';
+export { createMotionPath, getMotionPathHeading, getMotionPathPosition, getMotionPathProgress, isMotionPathAtEnd, setMotionPathDistance, setMotionPathProgress, setMotionPathDirection, updateMotionPath, } 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,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/motionPath.d.ts

@@ -1,8 +1,11 @@
-import type { MotionPath, MotionPathLoopMode, Path, Vector2Like } from '@flighthq/types/contract';
+import type { EntityConstruction, MotionPath, MotionPathLoopMode, Path, Vector2Like } from '@flighthq/types/contract';
 export declare function createMotionPath(path: Path, speed?: number, loopMode?: MotionPathLoopMode, tolerance?: number): MotionPath;
 export declare function getMotionPathHeading(mp: Readonly<MotionPath>): number;
 export declare function getMotionPathPosition(mp: Readonly<MotionPath>, pointOut: Vector2Like, tangentOut: Vector2Like): boolean;
 export declare function getMotionPathProgress(mp: Readonly<MotionPath>): number;
+export declare function initializeMotionPath(out: EntityConstruction<MotionPath>, path: Path, speed?: number, loopMode?: MotionPathLoopMode, tolerance?: number): void;
+export declare function isMotionPathAtEnd(mp: Readonly<MotionPath>): boolean;
+export declare function setMotionPathDirection(mp: MotionPath, direction: 1 | -1): void;
 export declare function setMotionPathDistance(mp: MotionPath, distance: number): void;
 export declare function setMotionPathProgress(mp: MotionPath, t: number): void;
 export declare function updateMotionPath(mp: MotionPath, deltaTime: number): void;

package/dist/motionPath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"motionPath.d.ts","sourceRoot":"","sources":["../src/motionPath.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AASlG,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,KAAK,SAAI,EACT,QAAQ,GAAE,kBAA4B,EACtC,SAAS,CAAC,EAAE,MAAM,GACjB,UAAU,CASZ;AAMD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,CAGrE;AAQD,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC,EACxB,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,WAAW,GACtB,OAAO,CAET;AAID,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,CAEtE;AAID,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAM5E;AAID,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAKrE;AAMD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAQxE"}
+{"version":3,"file":"motionPath.d.ts","sourceRoot":"","sources":["../src/motionPath.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,kBAAkB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEtH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,KAAK,SAAI,EACT,QAAQ,GAAE,kBAA4B,EACtC,SAAS,CAAC,EAAE,MAAM,GACjB,UAAU,CAIZ;AAMD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,CAGrE;AAMD,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC,EACxB,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,WAAW,GACtB,OAAO,CAET;AAID,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,CAEtE;AASD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACnC,IAAI,EAAE,IAAI,EACV,KAAK,SAAI,EACT,QAAQ,GAAE,kBAA4B,EACtC,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAON;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,OAAO,CAEnE;AAED,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAE9E;AAID,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAM5E;AAID,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAKrE;AAMD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAQxE"}

package/dist/motionPath.js

@@ -1,21 +1,10 @@
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import { createVector2 } from '@flighthq/geometry/contract';
 import { getPathLength, getPathPositionAtDistance, getPathTangentAtDistance } from '@flighthq/path/contract';
-// Allocate a `MotionPath` marker at the start of `path` (`distance` 0, `direction` forward).
-// `speed` is the traversal rate in path units per second (a magnitude; default 0 = stationary),
-// `loopMode` the end behavior (default `clamp`). The path's total arc length is measured once here
-// with `getPathLength(path, tolerance)` and cached in `length`; per-frame updates reuse it rather
-// than re-measuring. `tolerance` is the curve-flattening tolerance forwarded to the arc-length
-// measurement. This is the only allocating function; `updateMotionPath` and the seek helpers write
-// into an existing marker.
 export function createMotionPath(path, speed = 0, loopMode = 'clamp', tolerance) {
-    return {
-        direction: 1,
-        distance: 0,
-        length: getPathLength(path, tolerance),
-        loopMode,
-        path,
-        speed,
-    };
+    const out = allocateEntity();
+    initializeMotionPath(out, path, speed, loopMode, tolerance);
+    return finishEntity(out);
 }
 // Return the marker's heading angle in radians — `atan2(tangentY, tangentX)` of the path tangent at
 // the current `distance` — for orienting an object along the curve. Samples the tangent into a
@@ -25,7 +14,6 @@ export function getMotionPathHeading(mp) {
     getPathTangentAtDistance(mp.path, mp.distance, scratchTangent);
     return Math.atan2(scratchTangent.y, scratchTangent.x);
 }
-const scratchTangent = createVector2();
 // Sample the marker's current world position and unit tangent, writing them into `pointOut` and
 // `tangentOut`. Returns `true` on success, `false` for an empty/degenerate path (in which case the
 // outputs are left unchanged). Delegates to `@flighthq/path`'s `getPathPositionAtDistance` at the
@@ -38,6 +26,27 @@ export function getMotionPathPosition(mp, pointOut, tangentOut) {
 export function getMotionPathProgress(mp) {
     return mp.length > 0 ? mp.distance / mp.length : 0;
 }
+// Allocate a `MotionPath` marker at the start of `path` (`distance` 0, `direction` forward).
+// `speed` is the traversal rate in path units per second (a magnitude; default 0 = stationary),
+// `loopMode` the end behavior (default `clamp`). The path's total arc length is measured once here
+// with `getPathLength(path, tolerance)` and cached in `length`; per-frame updates reuse it rather
+// than re-measuring. `tolerance` is the curve-flattening tolerance forwarded to the arc-length
+// measurement. This is the only allocating function; `updateMotionPath` and the seek helpers write
+// into an existing marker.
+export function initializeMotionPath(out, path, speed = 0, loopMode = 'clamp', tolerance) {
+    out.direction = 1;
+    out.distance = 0;
+    out.length = getPathLength(path, tolerance);
+    out.loopMode = loopMode;
+    out.path = path;
+    out.speed = speed;
+}
+export function isMotionPathAtEnd(mp) {
+    return mp.direction > 0 ? mp.distance >= mp.length : mp.distance <= 0;
+}
+export function setMotionPathDirection(mp, direction) {
+    mp.direction = direction;
+}
 // Seek the marker to an absolute arc-length `distance`, clamping to the valid `[0, length]` range.
 // Does not change `direction` or `speed`.
 export function setMotionPathDistance(mp, distance) {
@@ -118,4 +127,5 @@ function applyMotionPathLoopMode(mp, move, length) {
         clamped = length;
     mp.distance = clamped;
 }
+const scratchTangent = createVector2();
 //# sourceMappingURL=motionPath.js.map

package/dist/motionPath.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/motionpath",
-  "version": "0.5.0-next.1944.cd6b6e7",
+  "version": "0.5.1-edge.1047.858b9b6",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,9 +38,10 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/geometry": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/path": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/types": "0.5.0-next.1944.cd6b6e7"
+    "@flighthq/entity": "0.5.1-edge.1047.858b9b6",
+    "@flighthq/geometry": "0.5.1-edge.1047.858b9b6",
+    "@flighthq/path": "0.5.1-edge.1047.858b9b6",
+    "@flighthq/types": "0.5.1-edge.1047.858b9b6"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/motionPath.test.ts

@@ -7,8 +7,11 @@ import {
   getMotionPathHeading,
   getMotionPathPosition,
   getMotionPathProgress,
+  isMotionPathAtEnd,
+  initializeMotionPath,
   setMotionPathDistance,
   setMotionPathProgress,
+  setMotionPathDirection,
   updateMotionPath,
 } from './motionPath';
 
@@ -93,6 +96,35 @@ describe('getMotionPathProgress', () => {
   });
 });
 
+describe('initializeMotionPath', () => {
+  it('is the construction initializer of createMotionPath', () => {
+    expect(typeof initializeMotionPath).toBe('function');
+  });
+});
+
+describe('isMotionPathAtEnd', () => {
+  it('reports the terminal edge in the current direction', () => {
+    const mp = createMotionPath(line());
+    expect(isMotionPathAtEnd(mp)).toBe(false);
+    setMotionPathDistance(mp, 100);
+    expect(isMotionPathAtEnd(mp)).toBe(true);
+    setMotionPathDirection(mp, -1);
+    expect(isMotionPathAtEnd(mp)).toBe(false);
+    setMotionPathDistance(mp, 0);
+    expect(isMotionPathAtEnd(mp)).toBe(true);
+  });
+});
+
+describe('setMotionPathDirection', () => {
+  it('changes traversal direction without changing distance', () => {
+    const mp = createMotionPath(line());
+    setMotionPathDistance(mp, 25);
+    setMotionPathDirection(mp, -1);
+    expect(mp.direction).toBe(-1);
+    expect(mp.distance).toBe(25);
+  });
+});
+
 // A straight horizontal line from (0,0) to (100,0): arc length 100.
 describe('setMotionPathDistance', () => {
   it('seeks to an absolute arc-length distance', () => {
@@ -135,6 +167,25 @@ describe('setMotionPathProgress', () => {
   });
 });
 
+// A straight horizontal line from (0,0) to (100,0): arc length 100.
+function line(): Path {
+  const path = createPath();
+  appendPathMoveTo(path, 0, 0);
+  appendPathLineTo(path, 100, 0);
+  return path;
+}
+
+function corner(): Path {
+  const path = createPath();
+  appendPathMoveTo(path, 0, 0);
+  appendPathLineTo(path, 100, 0);
+  appendPathLineTo(path, 100, 100);
+  return path;
+}
+
+function empty(): Path {
+  return createPath();
+}
 // A straight horizontal line from (0,0) to (100,0): arc length 100.
 describe('updateMotionPath', () => {
   it('advances distance by speed * deltaTime', () => {
@@ -220,23 +271,3 @@ describe('updateMotionPath', () => {
     expect(mp.distance).toBe(0);
   });
 });
-
-// A straight horizontal line from (0,0) to (100,0): arc length 100.
-function line(): Path {
-  const path = createPath();
-  appendPathMoveTo(path, 0, 0);
-  appendPathLineTo(path, 100, 0);
-  return path;
-}
-
-function corner(): Path {
-  const path = createPath();
-  appendPathMoveTo(path, 0, 0);
-  appendPathLineTo(path, 100, 0);
-  appendPathLineTo(path, 100, 100);
-  return path;
-}
-
-function empty(): Path {
-  return createPath();
-}