@esengine/network 9.0.0 → 10.0.0

package/dist/index.d.ts

@@ -25,7 +25,7 @@ export type { NetworkPredictionConfig, MovementInput, PredictedTransform, } from
 export { NetworkAOISystem, createNetworkAOISystem, } from './systems/NetworkAOISystem';
 export type { NetworkAOIConfig, NetworkAOIEvent, NetworkAOIEventType, NetworkAOIEventListener, } from './systems/NetworkAOISystem';
 export type { IStateSnapshot, ITransformState, ITransformStateWithVelocity, ISnapshotBufferConfig, ISnapshotBuffer, } from './sync';
-export type { IInterpolator, IExtrapolator, IInputSnapshot, IPredictedState, IPredictor, ClientPredictionConfig, EntityDeltaState, DeltaSyncData, DeltaCompressionConfig, ComponentSyncEventType, ComponentSyncEvent, ComponentSyncEventListener, ComponentSyncConfig, } from './sync';
-export { lerp, lerpAngle, smoothDamp, SnapshotBuffer, createSnapshotBuffer, TransformInterpolator, HermiteTransformInterpolator, createTransformInterpolator, createHermiteTransformInterpolator, ClientPrediction, createClientPrediction, DeltaFlags, StateDeltaCompressor, createStateDeltaCompressor, ComponentSyncSystem, createComponentSyncSystem, } from './sync';
+export type { IInterpolator, IExtrapolator, IInputSnapshot, IPredictedState, IPredictor, ClientPredictionConfig, EntityDeltaState, DeltaSyncData, DeltaCompressionConfig, ComponentSyncEventType, ComponentSyncEvent, ComponentSyncEventListener, ComponentSyncConfig, IFixedTransformStateRaw, IFixedTransformStateWithVelocityRaw, IFixedInterpolator, IFixedExtrapolator, } from './sync';
+export { lerp, lerpAngle, smoothDamp, SnapshotBuffer, createSnapshotBuffer, TransformInterpolator, HermiteTransformInterpolator, createTransformInterpolator, createHermiteTransformInterpolator, ClientPrediction, createClientPrediction, DeltaFlags, StateDeltaCompressor, createStateDeltaCompressor, ComponentSyncSystem, createComponentSyncSystem, FixedTransformState, FixedTransformStateWithVelocity, createZeroFixedTransformState, createZeroFixedTransformStateWithVelocity, FixedTransformInterpolator, FixedHermiteTransformInterpolator, createFixedTransformInterpolator, createFixedHermiteTransformInterpolator, } from './sync';
 export { IsLocalPlayerTemplate, IsServerTemplate, HasAuthorityTemplate, GetNetworkIdTemplate, GetLocalPlayerIdTemplate, IsLocalPlayerExecutor, IsServerExecutor, HasAuthorityExecutor, GetNetworkIdExecutor, GetLocalPlayerIdExecutor, NetworkNodeDefinitions, } from './nodes';
 //# 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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1307,6 +1307,225 @@ function createComponentSyncSystem(config, isServer = false) {
 }
 __name(createComponentSyncSystem, "createComponentSyncSystem");
 
+// src/sync/fixed/FixedTransformState.ts
+import { Fixed32, FixedVector2 } from "@esengine/ecs-framework-math";
+var _FixedTransformState = class _FixedTransformState {
+  constructor(position, rotation) {
+    __publicField(this, "position");
+    __publicField(this, "rotation");
+    this.position = position;
+    this.rotation = rotation;
+  }
+  /**
+   * @zh 从原始值创建
+   * @en Create from raw values
+   */
+  static fromRaw(raw) {
+    return new _FixedTransformState(FixedVector2.fromRaw(raw.x, raw.y), Fixed32.fromRaw(raw.rotation));
+  }
+  /**
+   * @zh 从浮点数创建
+   * @en Create from floating-point numbers
+   */
+  static from(x, y, rotation) {
+    return new _FixedTransformState(FixedVector2.from(x, y), Fixed32.from(rotation));
+  }
+  /**
+   * @zh 转换为原始值（用于网络传输）
+   * @en Convert to raw values (for network transmission)
+   */
+  toRaw() {
+    return {
+      x: this.position.x.toRaw(),
+      y: this.position.y.toRaw(),
+      rotation: this.rotation.toRaw()
+    };
+  }
+  /**
+   * @zh 转换为浮点数对象（用于渲染）
+   * @en Convert to floating-point object (for rendering)
+   */
+  toFloat() {
+    return {
+      x: this.position.x.toNumber(),
+      y: this.position.y.toNumber(),
+      rotation: this.rotation.toNumber()
+    };
+  }
+  /**
+   * @zh 检查是否相等
+   * @en Check equality
+   */
+  equals(other) {
+    return this.position.equals(other.position) && this.rotation.eq(other.rotation);
+  }
+};
+__name(_FixedTransformState, "FixedTransformState");
+var FixedTransformState = _FixedTransformState;
+var _FixedTransformStateWithVelocity = class _FixedTransformStateWithVelocity {
+  constructor(position, rotation, velocity, angularVelocity) {
+    __publicField(this, "position");
+    __publicField(this, "rotation");
+    __publicField(this, "velocity");
+    __publicField(this, "angularVelocity");
+    this.position = position;
+    this.rotation = rotation;
+    this.velocity = velocity;
+    this.angularVelocity = angularVelocity;
+  }
+  /**
+   * @zh 从原始值创建
+   * @en Create from raw values
+   */
+  static fromRaw(raw) {
+    return new _FixedTransformStateWithVelocity(FixedVector2.fromRaw(raw.x, raw.y), Fixed32.fromRaw(raw.rotation), FixedVector2.fromRaw(raw.velocityX, raw.velocityY), Fixed32.fromRaw(raw.angularVelocity));
+  }
+  /**
+   * @zh 从浮点数创建
+   * @en Create from floating-point numbers
+   */
+  static from(x, y, rotation, velocityX, velocityY, angularVelocity) {
+    return new _FixedTransformStateWithVelocity(FixedVector2.from(x, y), Fixed32.from(rotation), FixedVector2.from(velocityX, velocityY), Fixed32.from(angularVelocity));
+  }
+  /**
+   * @zh 转换为原始值
+   * @en Convert to raw values
+   */
+  toRaw() {
+    return {
+      x: this.position.x.toRaw(),
+      y: this.position.y.toRaw(),
+      rotation: this.rotation.toRaw(),
+      velocityX: this.velocity.x.toRaw(),
+      velocityY: this.velocity.y.toRaw(),
+      angularVelocity: this.angularVelocity.toRaw()
+    };
+  }
+  /**
+   * @zh 转换为浮点数对象
+   * @en Convert to floating-point object
+   */
+  toFloat() {
+    return {
+      x: this.position.x.toNumber(),
+      y: this.position.y.toNumber(),
+      rotation: this.rotation.toNumber(),
+      velocityX: this.velocity.x.toNumber(),
+      velocityY: this.velocity.y.toNumber(),
+      angularVelocity: this.angularVelocity.toNumber()
+    };
+  }
+  /**
+   * @zh 检查是否相等
+   * @en Check equality
+   */
+  equals(other) {
+    return this.position.equals(other.position) && this.rotation.eq(other.rotation) && this.velocity.equals(other.velocity) && this.angularVelocity.eq(other.angularVelocity);
+  }
+};
+__name(_FixedTransformStateWithVelocity, "FixedTransformStateWithVelocity");
+var FixedTransformStateWithVelocity = _FixedTransformStateWithVelocity;
+function createZeroFixedTransformState() {
+  return new FixedTransformState(FixedVector2.ZERO, Fixed32.ZERO);
+}
+__name(createZeroFixedTransformState, "createZeroFixedTransformState");
+function createZeroFixedTransformStateWithVelocity() {
+  return new FixedTransformStateWithVelocity(FixedVector2.ZERO, Fixed32.ZERO, FixedVector2.ZERO, Fixed32.ZERO);
+}
+__name(createZeroFixedTransformStateWithVelocity, "createZeroFixedTransformStateWithVelocity");
+
+// src/sync/fixed/FixedTransformInterpolator.ts
+import { Fixed32 as Fixed322, FixedVector2 as FixedVector22, FixedMath } from "@esengine/ecs-framework-math";
+var _FixedTransformInterpolator = class _FixedTransformInterpolator {
+  /**
+   * @zh 在两个变换状态之间插值
+   * @en Interpolate between two transform states
+   */
+  interpolate(from, to, t) {
+    return new FixedTransformState(from.position.lerp(to.position, t), FixedMath.lerpAngle(from.rotation, to.rotation, t));
+  }
+  /**
+   * @zh 基于速度外推变换状态
+   * @en Extrapolate transform state based on velocity
+   */
+  extrapolate(state, deltaTime) {
+    return new FixedTransformStateWithVelocity(state.position.add(state.velocity.mul(deltaTime)), state.rotation.add(state.angularVelocity.mul(deltaTime)), state.velocity, state.angularVelocity);
+  }
+  /**
+   * @zh 使用原始值进行插值
+   * @en Interpolate using raw values
+   */
+  interpolateRaw(from, to, t) {
+    const fromState = FixedTransformState.fromRaw(from);
+    const toState = FixedTransformState.fromRaw(to);
+    const tFixed = Fixed322.from(t);
+    return this.interpolate(fromState, toState, tFixed).toRaw();
+  }
+  /**
+   * @zh 使用原始值进行外推
+   * @en Extrapolate using raw values
+   */
+  extrapolateRaw(state, deltaTimeMs) {
+    const fixedState = FixedTransformStateWithVelocity.fromRaw(state);
+    const deltaTime = Fixed322.from(deltaTimeMs / 1e3);
+    return this.extrapolate(fixedState, deltaTime).toRaw();
+  }
+};
+__name(_FixedTransformInterpolator, "FixedTransformInterpolator");
+var FixedTransformInterpolator = _FixedTransformInterpolator;
+var _FixedHermiteTransformInterpolator = class _FixedHermiteTransformInterpolator {
+  constructor(snapshotIntervalMs = 100) {
+    /**
+     * @zh 快照间隔时间（秒）
+     * @en Snapshot interval in seconds
+     */
+    __publicField(this, "snapshotInterval");
+    this.snapshotInterval = Fixed322.from(snapshotIntervalMs / 1e3);
+  }
+  /**
+   * @zh 使用赫尔米特插值
+   * @en Use Hermite interpolation
+   */
+  interpolate(from, to, t) {
+    const t2 = t.mul(t);
+    const t3 = t2.mul(t);
+    const two = Fixed322.from(2);
+    const three = Fixed322.from(3);
+    const six = Fixed322.from(6);
+    const four = Fixed322.from(4);
+    const h00 = two.mul(t3).sub(three.mul(t2)).add(Fixed322.ONE);
+    const h10 = t3.sub(two.mul(t2)).add(t);
+    const h01 = two.neg().mul(t3).add(three.mul(t2));
+    const h11 = t3.sub(t2);
+    const dt = this.snapshotInterval;
+    const x = h00.mul(from.position.x).add(h10.mul(from.velocity.x).mul(dt)).add(h01.mul(to.position.x)).add(h11.mul(to.velocity.x).mul(dt));
+    const y = h00.mul(from.position.y).add(h10.mul(from.velocity.y).mul(dt)).add(h01.mul(to.position.y)).add(h11.mul(to.velocity.y).mul(dt));
+    const dh00 = six.mul(t2).sub(six.mul(t));
+    const dh10 = three.mul(t2).sub(four.mul(t)).add(Fixed322.ONE);
+    const dh01 = six.neg().mul(t2).add(six.mul(t));
+    const dh11 = three.mul(t2).sub(two.mul(t));
+    const velocityX = dh00.mul(from.position.x).add(dh10.mul(from.velocity.x).mul(dt)).add(dh01.mul(to.position.x)).add(dh11.mul(to.velocity.x).mul(dt)).div(dt);
+    const velocityY = dh00.mul(from.position.y).add(dh10.mul(from.velocity.y).mul(dt)).add(dh01.mul(to.position.y)).add(dh11.mul(to.velocity.y).mul(dt)).div(dt);
+    return new FixedTransformStateWithVelocity(new FixedVector22(x, y), FixedMath.lerpAngle(from.rotation, to.rotation, t), new FixedVector22(velocityX, velocityY), Fixed322.lerp(from.angularVelocity, to.angularVelocity, t));
+  }
+};
+__name(_FixedHermiteTransformInterpolator, "FixedHermiteTransformInterpolator");
+var FixedHermiteTransformInterpolator = _FixedHermiteTransformInterpolator;
+function createFixedTransformInterpolator() {
+  return new FixedTransformInterpolator();
+}
+__name(createFixedTransformInterpolator, "createFixedTransformInterpolator");
+function createFixedHermiteTransformInterpolator(snapshotIntervalMs) {
+  return new FixedHermiteTransformInterpolator(snapshotIntervalMs);
+}
+__name(createFixedHermiteTransformInterpolator, "createFixedHermiteTransformInterpolator");
+
+// src/sync/fixed/FixedSnapshotBuffer.ts
+import { Fixed32 as Fixed323 } from "@esengine/ecs-framework-math";
+
+// src/sync/fixed/FixedClientPrediction.ts
+import { Fixed32 as Fixed324, FixedVector2 as FixedVector23 } from "@esengine/ecs-framework-math";
+
 // src/systems/NetworkSyncSystem.ts
 var DEFAULT_CONFIG3 = {
   bufferSize: 30,
@@ -2957,6 +3176,10 @@ export {
   ClientPrediction,
   ComponentSyncSystem,
   DeltaFlags,
+  FixedHermiteTransformInterpolator,
+  FixedTransformInterpolator,
+  FixedTransformState,
+  FixedTransformStateWithVelocity,
   GameNetworkService,
   GetLocalPlayerIdExecutor,
   GetLocalPlayerIdTemplate,
@@ -2992,6 +3215,8 @@ export {
   TransformInterpolator,
   createClientPrediction,
   createComponentSyncSystem,
+  createFixedHermiteTransformInterpolator,
+  createFixedTransformInterpolator,
   createHermiteTransformInterpolator,
   createNetworkAOISystem,
   createNetworkInputSystem,
@@ -3000,6 +3225,8 @@ export {
   createSnapshotBuffer,
   createStateDeltaCompressor,
   createTransformInterpolator,
+  createZeroFixedTransformState,
+  createZeroFixedTransformStateWithVelocity,
   gameProtocol,
   lerp,
   lerpAngle,