@ikijs/engine 0.2.0 → 0.3.1

package/dist/index.mjs

@@ -1037,7 +1037,10 @@ var FixedStepClock = class {
 // src/idle-motion.ts
 var BLINK_INTERVAL_MIN_MS = 1500;
 var BLINK_INTERVAL_MAX_MS = 6e3;
-var BLINK_DURATION_MS = 120;
+var BLINK_CLOSE_MS = 60;
+var BLINK_HOLD_MS = 20;
+var BLINK_OPEN_MS = 100;
+var BLINK_DURATION_MS = BLINK_CLOSE_MS + BLINK_HOLD_MS + BLINK_OPEN_MS;
 var BREATH_PERIOD_MS = 3500;
 var GAZE_RADIUS = 0.3;
 var GAZE_RETARGET_MIN_MS = 1200;
@@ -1055,7 +1058,18 @@ function lerp(a, b, t) {
   return a + (b - a) * t;
 }
 function blinkEnvelope(phase) {
-  return 2 * Math.abs(phase - 0.5);
+  const ms = phase * BLINK_DURATION_MS;
+  if (ms <= 0) return 1;
+  if (ms < BLINK_CLOSE_MS) {
+    const t = ms / BLINK_CLOSE_MS;
+    return 1 - t * t * (3 - 2 * t);
+  }
+  if (ms <= BLINK_CLOSE_MS + BLINK_HOLD_MS) return 0;
+  if (ms < BLINK_DURATION_MS) {
+    const t = (ms - BLINK_CLOSE_MS - BLINK_HOLD_MS) / BLINK_OPEN_MS;
+    return 1 - (1 - t) * (1 - t);
+  }
+  return 1;
 }
 function randomInDisk(rng, radius) {
   const r = Math.sqrt(rng()) * radius;
@@ -1063,6 +1077,22 @@ function randomInDisk(rng, radius) {
   return [r * Math.cos(theta), r * Math.sin(theta)];
 }
 var IdleMotion = class {
+  /**
+   * Every parameter id {@link update} and `emitRestingPose` write, in write
+   * order. Published so a host (or IkiMotion) can restore them after it
+   * stops driving — keep in step with those two methods; the test suite
+   * pins this list to the actual emissions.
+   */
+  drivenParameterIds = [
+    StandardParameter.EyeOpenLeft,
+    StandardParameter.EyeOpenRight,
+    StandardParameter.Breath,
+    StandardParameter.EyeballX,
+    StandardParameter.EyeballY,
+    StandardParameter.AngleX,
+    StandardParameter.AngleY,
+    StandardParameter.AngleZ
+  ];
   sink;
   rng;
   // Internal clock: advances by clamped dt, NOT by raw wall-clock jumps.
@@ -1195,6 +1225,8 @@ function signedNormalized(value, param) {
   return clamp((value - rest) / den, -1, 1);
 }
 var PhysicsMotion = class {
+  /** The output parameter of every rig, in rig order — what `emit` writes. */
+  drivenParameterIds;
   rigs;
   read;
   sink;
@@ -1208,6 +1240,7 @@ var PhysicsMotion = class {
     this.sink = sink;
     this.params = new Map(params.map((p) => [p.id, p]));
     this.state = rigs.map(() => ({ x: 0, v: 0 }));
+    this.drivenParameterIds = rigs.map((rig) => rig.output.parameter);
   }
   /**
    * Advance every rig to the given wall-clock timestamp (milliseconds).
@@ -1278,6 +1311,8 @@ var PhysicsMotion = class {
 var DEG2RAD = Math.PI / 180;
 var RAD2DEG = 180 / Math.PI;
 var HairChainMotion = class {
+  /** Every segment's output, chain by chain — what `emitSegment` writes. */
+  drivenParameterIds;
   chainData;
   params;
   deformers;
@@ -1298,6 +1333,9 @@ var HairChainMotion = class {
       ),
       state: chain.segments.map(() => ({ angle: 0, angularVelocity: 0 }))
     }));
+    this.drivenParameterIds = chains.flatMap(
+      (c) => c.segments.map((s) => s.output.parameter)
+    );
   }
   /**
    * Advance every chain to the given wall-clock timestamp (milliseconds).
@@ -1410,9 +1448,58 @@ var HairChainMotion = class {
     );
   }
 };
+
+// src/iki-motion.ts
+var IkiMotion = class {
+  /**
+   * Idle ids, then rig outputs, then chain-segment outputs, deduplicated and
+   * insertion-ordered. May name ids the model lacks (the player silently
+   * drops writes to unknown ids) — intersect with the model's parameters if
+   * you mirror into your own store.
+   */
+  drivenParameterIds;
+  idle;
+  physics;
+  chains;
+  constructor(model, read, sink) {
+    const rigs = model.physics ?? [];
+    const chains = model.physicsChains ?? [];
+    this.idle = new IdleMotion(sink);
+    this.physics = new PhysicsMotion(rigs, model.parameters, read, sink);
+    this.chains = new HairChainMotion(
+      chains,
+      model.parameters,
+      model.deformers ?? [],
+      read,
+      sink
+    );
+    this.drivenParameterIds = [
+      .../* @__PURE__ */ new Set([
+        ...this.idle.drivenParameterIds,
+        ...this.physics.drivenParameterIds,
+        ...this.chains.drivenParameterIds
+      ])
+    ];
+  }
+  /**
+   * Advance idle, then physics, then chains to the same wall-clock timestamp
+   * (milliseconds). Order is load-bearing: `PhysicsMotion` reads its input
+   * parameters (typically `ParamAngleX/Z`) through `read`, and the head sway
+   * idle wrote THIS frame is what the springs must lag behind; `HairChainMotion`
+   * then resolves its anchor deformer's world rotation from that same
+   * just-written pose (which may include a physics output). One timestamp for
+   * all three keeps their dt in lockstep.
+   */
+  update(nowMs) {
+    this.idle.update(nowMs);
+    this.physics.update(nowMs);
+    this.chains.update(nowMs);
+  }
+};
 export {
   HairChainMotion,
   IdleMotion,
+  IkiMotion,
   IkiPlayer,
   ParameterStore,
   PhysicsMotion,