@utsp/core 0.14.0 → 0.14.1

package/dist/benchmark.d.ts

@@ -7265,38 +7265,22 @@ declare class Core {
      *
      * This method:
      * 1. Encodes displays and layers of each user into binary packets
-     * 2. Increments tick counter
-     * 3. Returns a Map with packets ready to send
+     * 2. Only sends layers that have called commit() (optimization)
+     * 3. Separates static and dynamic layers for network optimization
+     * 4. Increments tick counter
+     * 5. Returns a Map with split packets ready to send
      *
-     * Server/client can then send these packets over the network
-     *
-     * @returns Map<userId, packet> - Encoded packets for each user
-     *
-     * @example
-     * ```typescript
-     * const packets = engine.endTick();
-     * packets.forEach((packet, userId) => {
-     *   networkSend(userId, packet);
-     * });
-     * ```
-     */
-    endTick(): Map<string, Uint8Array>;
-    /**
-     * Ends tick and generates SEPARATE packets for static and dynamic layers
-     *
-     * This method allows sending:
-     * - STATIC Layers on a reliable Socket.IO channel (guaranteed delivery)
-     * - DYNAMIC Layers on a volatile Socket.IO channel (can drop packets)
-     *
-     * Optimization: Static layers (background, pattern) must arrive,
-     * but dynamic layers (particles, trail) can skip frames.
+     * Network strategy:
+     * - STATIC Layers → Reliable channel (guaranteed delivery)
+     * - DYNAMIC Layers → Volatile channel (can drop packets for performance)
+     * - Audio/Vibration/Macro/PostProcess orders → Only in dynamic packet
      *
      * @returns Map<userId, { static: Uint8Array | null, dynamic: Uint8Array | null }>
      *
      * @example
      * ```typescript
-     * const splitPackets = engine.endTickSplit();
-     * splitPackets.forEach(({ static: staticPacket, dynamic: dynamicPacket }, userId) => {
+     * const packets = engine.endTick();
+     * packets.forEach(({ static: staticPacket, dynamic: dynamicPacket }, userId) => {
      *   if (staticPacket) {
      *     network.sendToClient(userId, 'update-static', staticPacket); // Reliable
      *   }
@@ -7306,7 +7290,7 @@ declare class Core {
      * });
      * ```
      */
-    endTickSplit(): Map<string, {
+    endTick(): Map<string, {
         static: Uint8Array | null;
         dynamic: Uint8Array | null;
     }>;
@@ -7589,6 +7573,25 @@ declare class Core {
      * @returns Array of encoded MacroLoad packets
      */
     generateMacroLoadPackets(userId: string): Uint8Array[];
+    /**
+     * Generates an initial update packet for a specific user (SERVER-SIDE)
+     *
+     * This is used to send any pending PostProcessCommands (like switchPalette)
+     * that were created during initUser() but before the first regular tick.
+     *
+     * @param userId - Target user ID
+     * @returns Encoded update packet, or null if no pending commands
+     *
+     * @example
+     * ```typescript
+     * // Server side - after initUser and load packets
+     * const initialPacket = core.generateInitialUpdatePacket(clientId);
+     * if (initialPacket) {
+     *   socket.emit('update', initialPacket);
+     * }
+     * ```
+     */
+    generateInitialUpdatePacket(userId: string): Uint8Array | null;
     /**
      * Applies Input Bindings to a user (CLIENT-SIDE)
      *
@@ -8763,14 +8766,19 @@ declare class Layer {
      * ```
      */
     commit(): void;
+    /**
+     * Returns a breakdown of order types for debugging
+     * @internal
+     */
+    private getOrdersBreakdown;
     /**
      * Checks if layer needs to be sent
-     * @internal - Used by Core.endTickSplit()
+     * @internal - Used by Core.endTick()
      */
     getNeedsCommit(): boolean;
     /**
      * Resets commit flag after sending
-     * @internal - Used by Core.endTickSplit()
+     * @internal - Used by Core.endTick()
      */
     resetCommit(): void;
 }