@esengine/network 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ESEngine Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/NetworkPlugin.d.ts

@@ -0,0 +1,100 @@
+import { type IPlugin, Core, type ServiceContainer } from '@esengine/ecs-framework';
+import { NetworkService } from './services/NetworkService';
+import { NetworkSyncSystem } from './systems/NetworkSyncSystem';
+import { NetworkSpawnSystem, type PrefabFactory } from './systems/NetworkSpawnSystem';
+import { NetworkInputSystem } from './systems/NetworkInputSystem';
+/**
+ * 网络插件
+ * Network plugin
+ *
+ * 提供基于 TSRPC 的网络同步功能。
+ * Provides TSRPC-based network synchronization.
+ *
+ * @example
+ * ```typescript
+ * import { Core } from '@esengine/ecs-framework';
+ * import { NetworkPlugin } from '@esengine/network';
+ *
+ * const networkPlugin = new NetworkPlugin();
+ * await Core.installPlugin(networkPlugin);
+ *
+ * // 连接到服务器 | Connect to server
+ * await networkPlugin.connect('ws://localhost:3000', 'Player1');
+ *
+ * // 注册预制体 | Register prefab
+ * networkPlugin.registerPrefab('player', (scene, spawn) => {
+ *     const entity = scene.createEntity('Player');
+ *     return entity;
+ * });
+ * ```
+ */
+export declare class NetworkPlugin implements IPlugin {
+    readonly name = "@esengine/network";
+    readonly version = "1.0.0";
+    private _networkService;
+    private _syncSystem;
+    private _spawnSystem;
+    private _inputSystem;
+    /**
+     * 网络服务
+     * Network service
+     */
+    get networkService(): NetworkService;
+    /**
+     * 同步系统
+     * Sync system
+     */
+    get syncSystem(): NetworkSyncSystem;
+    /**
+     * 生成系统
+     * Spawn system
+     */
+    get spawnSystem(): NetworkSpawnSystem;
+    /**
+     * 输入系统
+     * Input system
+     */
+    get inputSystem(): NetworkInputSystem;
+    /**
+     * 是否已连接
+     * Is connected
+     */
+    get isConnected(): boolean;
+    /**
+     * 安装插件
+     * Install plugin
+     */
+    install(_core: Core, _services: ServiceContainer): void;
+    /**
+     * 卸载插件
+     * Uninstall plugin
+     */
+    uninstall(): void;
+    private _setupSystems;
+    /**
+     * 连接到服务器
+     * Connect to server
+     */
+    connect(serverUrl: string, playerName: string, roomId?: string): Promise<boolean>;
+    /**
+     * 断开连接
+     * Disconnect
+     */
+    disconnect(): Promise<void>;
+    /**
+     * 注册预制体工厂
+     * Register prefab factory
+     */
+    registerPrefab(prefabType: string, factory: PrefabFactory): void;
+    /**
+     * 发送移动输入
+     * Send move input
+     */
+    sendMoveInput(x: number, y: number): void;
+    /**
+     * 发送动作输入
+     * Send action input
+     */
+    sendActionInput(action: string): void;
+}
+//# sourceMappingURL=NetworkPlugin.d.ts.map

package/dist/NetworkPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkPlugin.d.ts","sourceRoot":"","sources":["../src/NetworkPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,KAAK,gBAAgB,EAAc,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,aAAc,YAAW,OAAO;IACzC,SAAgB,IAAI,uBAAuB;IAC3C,SAAgB,OAAO,WAAW;IAElC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,YAAY,CAAsB;IAE1C;;;OAGG;IACH,IAAI,cAAc,IAAI,cAAc,CAEnC;IAED;;;OAGG;IACH,IAAI,UAAU,IAAI,iBAAiB,CAElC;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,kBAAkB,CAEpC;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,kBAAkB,CAEpC;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAWvD;;;OAGG;IACH,SAAS,IAAI,IAAI;IAIjB,OAAO,CAAC,aAAa;IAUrB;;;OAGG;IACU,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9F;;;OAGG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC;;;OAGG;IACI,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAIvE;;;OAGG;IACI,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAIhD;;;OAGG;IACI,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAG/C"}

package/dist/components/NetworkIdentity.d.ts

@@ -0,0 +1,51 @@
+import { Component } from '@esengine/ecs-framework';
+/**
+ * 网络身份组件
+ * Network identity component
+ *
+ * 标识一个实体在网络上的唯一身份。
+ * Identifies an entity's unique identity on the network.
+ */
+export declare class NetworkIdentity extends Component {
+    /**
+     * 网络实体 ID
+     * Network entity ID
+     */
+    netId: number;
+    /**
+     * 所有者客户端 ID
+     * Owner client ID
+     */
+    ownerId: number;
+    /**
+     * 是否为本地玩家拥有
+     * Is owned by local player
+     */
+    bIsLocalPlayer: boolean;
+    /**
+     * 是否有权限控制
+     * Has authority
+     */
+    bHasAuthority: boolean;
+    /**
+     * 预制体类型
+     * Prefab type
+     */
+    prefabType: string;
+    /**
+     * 同步间隔 (ms)
+     * Sync interval in milliseconds
+     */
+    syncInterval: number;
+    /**
+     * 上次同步时间
+     * Last sync time
+     */
+    lastSyncTime: number;
+    /**
+     * 检查是否需要同步
+     * Check if sync is needed
+     */
+    needsSync(now: number): boolean;
+}
+//# sourceMappingURL=NetworkIdentity.d.ts.map

package/dist/components/NetworkIdentity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkIdentity.d.ts","sourceRoot":"","sources":["../../src/components/NetworkIdentity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAmD,MAAM,yBAAyB,CAAC;AAErG;;;;;;GAMG;AACH,qBAEa,eAAgB,SAAQ,SAAS;IAC1C;;;OAGG;IAGI,KAAK,EAAE,MAAM,CAAK;IAEzB;;;OAGG;IAGI,OAAO,EAAE,MAAM,CAAK;IAE3B;;;OAGG;IACI,cAAc,EAAE,OAAO,CAAS;IAEvC;;;OAGG;IACI,aAAa,EAAE,OAAO,CAAS;IAEtC;;;OAGG;IAGI,UAAU,EAAE,MAAM,CAAM;IAE/B;;;OAGG;IAGI,YAAY,EAAE,MAAM,CAAO;IAElC;;;OAGG;IACI,YAAY,EAAE,MAAM,CAAK;IAEhC;;;OAGG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAGzC"}

package/dist/components/NetworkTransform.d.ts

@@ -0,0 +1,71 @@
+import { Component } from '@esengine/ecs-framework';
+/**
+ * 网络变换组件
+ * Network transform component
+ *
+ * 同步实体的位置和旋转。支持插值平滑。
+ * Syncs entity position and rotation with interpolation smoothing.
+ */
+export declare class NetworkTransform extends Component {
+    /**
+     * 目标位置 X
+     * Target position X
+     */
+    targetX: number;
+    /**
+     * 目标位置 Y
+     * Target position Y
+     */
+    targetY: number;
+    /**
+     * 目标旋转
+     * Target rotation
+     */
+    targetRotation: number;
+    /**
+     * 当前位置 X
+     * Current position X
+     */
+    currentX: number;
+    /**
+     * 当前位置 Y
+     * Current position Y
+     */
+    currentY: number;
+    /**
+     * 当前旋转
+     * Current rotation
+     */
+    currentRotation: number;
+    /**
+     * 插值速度
+     * Interpolation speed
+     */
+    lerpSpeed: number;
+    /**
+     * 是否启用插值
+     * Enable interpolation
+     */
+    bInterpolate: boolean;
+    /**
+     * 同步间隔 (ms)
+     * Sync interval in milliseconds
+     */
+    syncInterval: number;
+    /**
+     * 上次同步时间
+     * Last sync time
+     */
+    lastSyncTime: number;
+    /**
+     * 设置目标位置
+     * Set target position
+     */
+    setTarget(x: number, y: number, rotation?: number): void;
+    /**
+     * 立即跳转到目标位置
+     * Snap to target position immediately
+     */
+    snap(): void;
+}
+//# sourceMappingURL=NetworkTransform.d.ts.map

package/dist/components/NetworkTransform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkTransform.d.ts","sourceRoot":"","sources":["../../src/components/NetworkTransform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAmD,MAAM,yBAAyB,CAAC;AAErG;;;;;;GAMG;AACH,qBAEa,gBAAiB,SAAQ,SAAS;IAC3C;;;OAGG;IACI,OAAO,EAAE,MAAM,CAAK;IAE3B;;;OAGG;IACI,OAAO,EAAE,MAAM,CAAK;IAE3B;;;OAGG;IACI,cAAc,EAAE,MAAM,CAAK;IAElC;;;OAGG;IACI,QAAQ,EAAE,MAAM,CAAK;IAE5B;;;OAGG;IACI,QAAQ,EAAE,MAAM,CAAK;IAE5B;;;OAGG;IACI,eAAe,EAAE,MAAM,CAAK;IAEnC;;;OAGG;IAGI,SAAS,EAAE,MAAM,CAAM;IAE9B;;;OAGG;IAGI,YAAY,EAAE,OAAO,CAAQ;IAEpC;;;OAGG;IAGI,YAAY,EAAE,MAAM,CAAM;IAEjC;;;OAGG;IACI,YAAY,EAAE,MAAM,CAAK;IAEhC;;;OAGG;IACI,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ/D;;;OAGG;IACI,IAAI,IAAI,IAAI;CAKtB"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @esengine/network
+ *
+ * 基于 TSRPC 的网络同步模块（客户端）
+ * TSRPC-based network synchronization module (client)
+ */
+export type { ServiceType, Vec2, IEntityState, IPlayerInput, MsgSync, MsgInput, MsgSpawn, MsgDespawn, ReqJoin, ResJoin } from '@esengine/network-protocols';
+export { serviceProto } from '@esengine/network-protocols';
+export { NetworkServiceToken, NetworkSyncSystemToken, NetworkSpawnSystemToken, NetworkInputSystemToken } from './tokens';
+export { NetworkPlugin } from './NetworkPlugin';
+export { NetworkService, ENetworkState } from './services/NetworkService';
+export type { INetworkCallbacks } from './services/NetworkService';
+export { NetworkIdentity } from './components/NetworkIdentity';
+export { NetworkTransform } from './components/NetworkTransform';
+export { NetworkSyncSystem } from './systems/NetworkSyncSystem';
+export { NetworkSpawnSystem } from './systems/NetworkSpawnSystem';
+export type { PrefabFactory } from './systems/NetworkSpawnSystem';
+export { NetworkInputSystem } from './systems/NetworkInputSystem';
+export type { IStateSnapshot, ITransformState, ITransformStateWithVelocity, ISnapshotBufferConfig, ISnapshotBuffer } from './sync';
+export type { IInterpolator, IExtrapolator, IInputSnapshot, IPredictedState, IPredictor, ClientPredictionConfig } from './sync';
+export { lerp, lerpAngle, smoothDamp, SnapshotBuffer, createSnapshotBuffer, TransformInterpolator, HermiteTransformInterpolator, createTransformInterpolator, createHermiteTransformInterpolator, ClientPrediction, createClientPrediction } 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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,YAAY,EACR,WAAW,EACX,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,OAAO,EACP,OAAO,EACV,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAM3D,OAAO,EACH,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EAC1B,MAAM,UAAU,CAAC;AAMlB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1E,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAMnE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAMjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAMlE,YAAY,EACR,cAAc,EACd,eAAe,EACf,2BAA2B,EAC3B,qBAAqB,EACrB,eAAe,EAClB,MAAM,QAAQ,CAAC;AAEhB,YAAY,EACR,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,UAAU,EACV,sBAAsB,EACzB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EACH,IAAI,EACJ,SAAS,EACT,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,kCAAkC,EAClC,gBAAgB,EAChB,sBAAsB,EACzB,MAAM,QAAQ,CAAC;AAMhB,OAAO,EACH,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACzB,MAAM,SAAS,CAAC"}