@rpgjs/client 5.0.0-beta.25 → 5.0.0-beta.27

package/CHANGELOG.md

@@ -1,5 +1,73 @@
 # @rpgjs/client
 
+## 5.0.0-beta.27
+
+### Patch Changes
+
+- dc6aed5: Initialize recursively nested RPGJS provider lists in client and server setup so
+  sample and consumer configurations register every provider at runtime.
+- e5ad24a: Establish the stable RPGJS-owned boundary for reactive gameplay properties,
+  dependency-injection providers, Node room storage, and Cloudflare room hosting.
+  Remove accidental Signe re-exports from the client and server roots, keep
+  direct Signe imports as an explicitly advanced plugin path, and protect every
+  published TypeScript entry with declaration reachability snapshots in CI.
+  Keep provider creation strategies mutually exclusive, support asynchronous
+  provider factories, and preserve strict member checking on the server engine.
+  Enforce these public contracts in CI, test the RPGJS-owned Node storage
+  lifecycle, and document complete stable migration examples.
+- Updated dependencies [dc6aed5]
+- Updated dependencies [e5ad24a]
+  - @rpgjs/server@5.0.0-beta.27
+  - @rpgjs/common@5.0.0-beta.26
+
+## 5.0.0-beta.26
+
+### Minor Changes
+
+- 83fc2b7: Add production Signe room adapters for persistent Node servers and Cloudflare Durable Objects, plus remote Vite map publication for trusted editor workflows with transient-only retries. Resolve local TMX files and their external tilesets when publishing maps, recreate configured events safely during live map updates, and restore player and event graphics after clients reload the Tiled scene.
+
+  Add provider-neutral authoritative map streaming with progressive render/physics chunks, client prediction barriers, and spatial interest management for players, NPCs, events, and projectiles. Keep complete Tiled TMX/TSX sources server-side in MMORPG mode while sharing the same game module between Node.js, local Wrangler, and Cloudflare Durable Object hosts.
+
+  Use the physics broad-phase index when resolving synchronized entities in each player's retained chunks, avoiding full-room player and event scans on every sync packet.
+
+  Assign Tiled collision geometry to every streamed chunk it intersects, and preserve the generated client reference for action, dash, pointer, and interaction APIs with a dedicated interactions guide.
+
+  Preserve initial room synchronization on older local Workerd runtimes that expose an accepted Durable Object WebSocket with a transient `CONNECTING` ready state.
+
+  Prevent CanvasEngine rain layers from retaining tick subscriptions when an asynchronous mount overlaps destruction or another mount.
+
+  Keep component-ready standalone Studio maps intact when sharing the in-memory server, and select the Cloudflare publisher independently from the generic MMORPG entry so local Node.js development does not require a Worker secret.
+
+  Add Studio v2 authoritative map preparation and progressive chunk streaming, including server physics, nearby rendering data, and provider-neutral entity synchronization. Trusted Vite publishers can now resolve a complete Studio payload before sending it to Node or Cloudflare map rooms, while raw Studio map structure, events, database records, and global collision data stay server-side.
+
+  Make initial map streaming explicit and hibernation-safe: clients request a fresh manifest after joining, trusted map updates are durably stored before acknowledgement, and recreated Durable Object room instances rebuild their transient streaming runtime. Stream Studio terrain control masks per chunk so transition rendering and prediction physics work without disclosing the complete map, and reset spatial visibility on reconnect so existing clients receive newly joined players.
+
+  Preserve custom streaming providers when Studio's built-in streaming is disabled, refresh cached client controllers after Durable Object hibernation, and key terrain-control buffers by their complete streamed region content to prevent stale masks.
+
+  Suppress projectile lifecycle packets that fall outside a player's disclosed interest window, clear client prediction barriers after the final streamed chunk is evicted, and coalesce concurrent requests for the same map stream. Exercise these paths with server, client, and real Workerd WebSocket tests, and run the Cloudflare MMORPG and Studio runtime suites in CI.
+
+  Avoid dereferencing an empty Studio weather state while switching maps.
+
+  Publish authenticated world topology updates to every map room, persist them across Durable Object hibernation, and refresh automatic world-map transitions without restarting the MMORPG server.
+
+  Document the Durable Object room model, map-and-world publication flow, hibernation recovery, production deployment, and common Cloudflare diagnostics.
+
+  Correct the documented default runtime to standalone RPG and add a beginner deployment path that takes the v5 starter through explicit MMORPG development, private map bundling, authenticated map publication, a persistent Node Docker deployment, or a Cloudflare Durable Object deployment. Include an executable production map publisher in the Cloudflare sample and make the production pages discoverable from both documentation navigations.
+
+  Declare the RPGJS Durable Object binding explicitly in Wrangler staging and production environments so isolated deployments keep their room namespace.
+
+  Cover the previous Studio scene before unmounting it during World transfers, preserve recent directional movement into the destination room, then reveal the new map through a full-screen dark transition with a centered, delayed localized loader and a bounded asset wait so stale or white frames cannot flash while fast local transitions stay unobtrusive.
+
+### Patch Changes
+
+- b6ab003: Establish `defineModule()` as the canonical runtime module authoring API, export it from the client and server packages, keep `createModule()` for advanced provider composition, and align runtime-specific module installation documentation and examples.
+- Updated dependencies [b6ab003]
+- Updated dependencies [777541a]
+- Updated dependencies [48fcd25]
+- Updated dependencies [83fc2b7]
+  - @rpgjs/common@5.0.0-beta.25
+  - @rpgjs/server@5.0.0-beta.26
+
 ## 5.0.0-beta.25
 
 ### Minor Changes

package/dist/Game/Map.d.ts

@@ -9,6 +9,7 @@ export declare class RpgClientMap extends RpgCommonMap<any> {
     currentPlayer: import('canvasengine').ComputedSignal<RpgClientPlayer>;
     weatherState: import('canvasengine').WritableSignal<WeatherState | null>;
     localWeatherOverride: import('canvasengine').WritableSignal<WeatherState | null>;
+    private localWeatherValue;
     lightingState: import('canvasengine').WritableSignal<LightingState | null>;
     localLightSpots: import('canvasengine').WritableObjectSignal<Record<string, LightSpot>>;
     weather: import('canvasengine').ComputedSignal<WeatherState | null>;

package/dist/Game/Map.js

@@ -25,6 +25,7 @@ var RpgClientMap = class extends RpgCommonMap {
 		this.currentPlayer = computed(() => this.players()[this.engine.playerIdSignal()]);
 		this.weatherState = signal(null);
 		this.localWeatherOverride = signal(null);
+		this.localWeatherValue = null;
 		this.lightingState = signal(null);
 		this.localLightSpots = signal({});
 		this.weather = computed(() => {
@@ -72,6 +73,7 @@ var RpgClientMap = class extends RpgCommonMap {
 		this.players.set(currentPlayerId && currentPlayer ? { [currentPlayerId]: currentPlayer } : {});
 		this.events.set({});
 		this.weatherState.set(null);
+		this.localWeatherValue = null;
 		this.localWeatherOverride.set(null);
 		this.lightingState.set(null);
 		this.localLightSpots.set({});
@@ -81,9 +83,12 @@ var RpgClientMap = class extends RpgCommonMap {
 		return this.weather();
 	}
 	setLocalWeather(next) {
+		if (this.localWeatherValue === next) return;
+		this.localWeatherValue = next;
 		this.localWeatherOverride.set(next);
 	}
 	clearLocalWeather() {
+		this.localWeatherValue = null;
 		this.localWeatherOverride.set(null);
 	}
 	getLighting() {

package/dist/Game/Map.js.map

@@ -1 +1 @@
-{"version":3,"file":"Map.js","names":[],"sources":["../../src/Game/Map.ts"],"sourcesContent":["import {\n  RpgCommonMap,\n  cloneLightingState,\n  normalizeLightingState,\n  type LightSpot,\n  type LightingState,\n  type WeatherState,\n  type MapPhysicsInitContext,\n  type MapPhysicsEntityContext,\n} from \"@rpgjs/common\";\nimport { sync, users } from \"@signe/sync\";\nimport { RpgClientPlayer } from \"./Player\";\nimport { Signal, signal, computed, effect } from \"canvasengine\";\nimport { RpgClientEvent } from \"./Event\";\nimport { RpgClientEngine } from \"../RpgClientEngine\";\nimport { inject } from \"../core/inject\";\n\ntype TestGlobalScope = typeof globalThis & {\n  process?: {\n    env?: {\n      TEST?: string;\n    };\n  };\n  __RPGJS_TEST__?: boolean;\n};\n\nconst lightingColorsEqual = (\n  left: LightSpot[\"color\"],\n  right: LightSpot[\"color\"],\n): boolean => {\n  if (Array.isArray(left) || Array.isArray(right)) {\n    return Array.isArray(left)\n      && Array.isArray(right)\n      && left.length === right.length\n      && left.every((value, index) => value === right[index]);\n  }\n  return left === right;\n};\n\nconst lightSpotsEqual = (left: LightSpot | undefined, right: LightSpot): boolean => {\n  if (!left) return false;\n  return left.id === right.id\n    && left.x === right.x\n    && left.y === right.y\n    && left.radius === right.radius\n    && left.intensity === right.intensity\n    && lightingColorsEqual(left.color, right.color)\n    && left.flicker === right.flicker\n    && left.flickerSpeed === right.flickerSpeed\n    && left.pulse === right.pulse\n    && left.pulseSpeed === right.pulseSpeed\n    && left.phase === right.phase;\n};\n\nexport class RpgClientMap extends RpgCommonMap<any> {\n  engine: RpgClientEngine = inject(RpgClientEngine)\n  @users(RpgClientPlayer) players = signal<Record<string, RpgClientPlayer>>({});\n  @sync(RpgClientEvent) events = signal<Record<string, RpgClientEvent>>({});\n  currentPlayer = computed(() => this.players()[this.engine.playerIdSignal()!])\n  weatherState = signal<WeatherState | null>(null);\n  localWeatherOverride = signal<WeatherState | null>(null);\n  lightingState = signal<LightingState | null>(null);\n  localLightSpots = signal<Record<string, LightSpot>>({});\n  weather = computed<WeatherState | null>(() => {\n    const local = this.localWeatherOverride() \n    const state = this.weatherState()\n    return local ?? state\n  });\n  lighting = computed<LightingState | null>(() => {\n    const state = cloneLightingState(this.lightingState());\n    const localSpots = Object.entries(this.localLightSpots()).map(([id, spot]) => ({\n      ...spot,\n      id: spot.id ?? id,\n    }));\n\n    if (!state && localSpots.length === 0) {\n      return null;\n    }\n\n    const next: LightingState = { ...(state ?? {}) };\n    if (!state?.ambient) {\n      delete next.ambient;\n    }\n    next.spots = [\n      ...(state?.spots ?? []),\n      ...localSpots,\n    ];\n    return next;\n  });\n  private manualClientPhysicsTick = false;\n  private readonly isTestEnvironment: boolean;\n\n  constructor() {\n    super();\n    // Détecter l'environnement de test\n    const testGlobal = globalThis as TestGlobalScope;\n    const isTest = testGlobal.process?.env?.TEST === 'true'\n      || testGlobal.__RPGJS_TEST__ === true;\n    this.isTestEnvironment = isTest;\n    if (isTest) {\n      this.autoTickEnabled = false;\n    }\n  }\n\n  configureClientPrediction(enabled: boolean): void {\n    this.manualClientPhysicsTick = enabled;\n    this.autoTickEnabled = enabled ? false : !this.isTestEnvironment;\n  }\n\n  getCurrentPlayer() {\n    return this.currentPlayer()\n  }\n\n  reset(force = false) {\n    const currentPlayerId = this.engine.playerIdSignal();\n    const currentPlayer = !force && currentPlayerId\n      ? this.players()[currentPlayerId]\n      : undefined;\n    const players = this.players();\n    const events = this.events();\n\n    Object.entries(players).forEach(([id, player]) => {\n      if (!player || (!force && id === currentPlayerId)) return;\n      (player as any).resetAnimationState?.();\n    });\n    Object.values(events).forEach((event) => {\n      (event as any)?.resetAnimationState?.();\n    });\n\n    this.players.set(\n      currentPlayerId && currentPlayer ? { [currentPlayerId]: currentPlayer } : {}\n    );\n    this.events.set({})\n    this.weatherState.set(null);\n    this.localWeatherOverride.set(null);\n    this.lightingState.set(null);\n    this.localLightSpots.set({});\n    this.clearPhysic()\n  }\n\n  getWeather(): WeatherState | null {\n    return this.weather();\n  }\n\n  setLocalWeather(next: WeatherState | null): void {\n    this.localWeatherOverride.set(next);\n  }\n\n  clearLocalWeather(): void {\n    this.localWeatherOverride.set(null);\n  }\n\n  getLighting(): LightingState | null {\n    return this.lighting();\n  }\n\n  addLightSpot(id: string, spot: LightSpot): void {\n    const normalized = normalizeLightingState({ spots: [{ ...spot, id }] });\n    const nextSpot = normalized?.spots?.[0];\n    if (!nextSpot) {\n      return;\n    }\n    this.localLightSpots.update((spots) => {\n      if (lightSpotsEqual(spots[id], nextSpot)) {\n        return spots;\n      }\n      return {\n        ...spots,\n        [id]: nextSpot,\n      };\n    });\n  }\n\n  patchLightSpot(id: string, patch: Partial<LightSpot>): void {\n    this.localLightSpots.update((spots) => {\n      const current = spots[id];\n      if (!current) {\n        return spots;\n      }\n      return {\n        ...spots,\n        [id]: {\n          ...current,\n          ...patch,\n          id,\n          x: patch.x ?? current.x,\n          y: patch.y ?? current.y,\n        },\n      };\n    });\n  }\n\n  removeLightSpot(id: string): void {\n    this.localLightSpots.update((spots) => {\n      if (!(id in spots)) {\n        return spots;\n      }\n      const next = { ...spots };\n      delete next[id];\n      return next;\n    });\n  }\n\n  clearLightSpots(): void {\n    this.localLightSpots.set({});\n  }\n\n  stepClientPhysics(deltaMs: number): number {\n    if (!this.manualClientPhysicsTick) {\n      return 0;\n    }\n    return this.nextTick(deltaMs);\n  }\n\n  stepPredictionTick(): void {\n    this.forceSingleTick();\n  }\n\n  protected emitPhysicsInit(context: MapPhysicsInitContext): void {\n    this.engine?.emitSceneMapHook?.(\"onPhysicsInit\", this, context);\n  }\n\n  protected emitPhysicsEntityAdd(context: MapPhysicsEntityContext): void {\n    this.engine?.emitSceneMapHook?.(\"onPhysicsEntityAdd\", this, context);\n  }\n\n  protected emitPhysicsEntityRemove(context: MapPhysicsEntityContext): void {\n    this.engine?.emitSceneMapHook?.(\"onPhysicsEntityRemove\", this, context);\n  }\n\n  protected emitPhysicsReset(): void {\n    this.engine?.emitSceneMapHook?.(\"onPhysicsReset\", this);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"Map.js","names":[],"sources":["../../src/Game/Map.ts"],"sourcesContent":["import {\n  RpgCommonMap,\n  cloneLightingState,\n  normalizeLightingState,\n  type LightSpot,\n  type LightingState,\n  type WeatherState,\n  type MapPhysicsInitContext,\n  type MapPhysicsEntityContext,\n} from \"@rpgjs/common\";\nimport { sync, users } from \"@signe/sync\";\nimport { RpgClientPlayer } from \"./Player\";\nimport { Signal, signal, computed, effect } from \"canvasengine\";\nimport { RpgClientEvent } from \"./Event\";\nimport { RpgClientEngine } from \"../RpgClientEngine\";\nimport { inject } from \"../core/inject\";\n\ntype TestGlobalScope = typeof globalThis & {\n  process?: {\n    env?: {\n      TEST?: string;\n    };\n  };\n  __RPGJS_TEST__?: boolean;\n};\n\nconst lightingColorsEqual = (\n  left: LightSpot[\"color\"],\n  right: LightSpot[\"color\"],\n): boolean => {\n  if (Array.isArray(left) || Array.isArray(right)) {\n    return Array.isArray(left)\n      && Array.isArray(right)\n      && left.length === right.length\n      && left.every((value, index) => value === right[index]);\n  }\n  return left === right;\n};\n\nconst lightSpotsEqual = (left: LightSpot | undefined, right: LightSpot): boolean => {\n  if (!left) return false;\n  return left.id === right.id\n    && left.x === right.x\n    && left.y === right.y\n    && left.radius === right.radius\n    && left.intensity === right.intensity\n    && lightingColorsEqual(left.color, right.color)\n    && left.flicker === right.flicker\n    && left.flickerSpeed === right.flickerSpeed\n    && left.pulse === right.pulse\n    && left.pulseSpeed === right.pulseSpeed\n    && left.phase === right.phase;\n};\n\nexport class RpgClientMap extends RpgCommonMap<any> {\n  engine: RpgClientEngine = inject(RpgClientEngine)\n  @users(RpgClientPlayer) players = signal<Record<string, RpgClientPlayer>>({});\n  @sync(RpgClientEvent) events = signal<Record<string, RpgClientEvent>>({});\n  currentPlayer = computed(() => this.players()[this.engine.playerIdSignal()!])\n  weatherState = signal<WeatherState | null>(null);\n  localWeatherOverride = signal<WeatherState | null>(null);\n  private localWeatherValue: WeatherState | null = null;\n  lightingState = signal<LightingState | null>(null);\n  localLightSpots = signal<Record<string, LightSpot>>({});\n  weather = computed<WeatherState | null>(() => {\n    const local = this.localWeatherOverride() \n    const state = this.weatherState()\n    return local ?? state\n  });\n  lighting = computed<LightingState | null>(() => {\n    const state = cloneLightingState(this.lightingState());\n    const localSpots = Object.entries(this.localLightSpots()).map(([id, spot]) => ({\n      ...spot,\n      id: spot.id ?? id,\n    }));\n\n    if (!state && localSpots.length === 0) {\n      return null;\n    }\n\n    const next: LightingState = { ...(state ?? {}) };\n    if (!state?.ambient) {\n      delete next.ambient;\n    }\n    next.spots = [\n      ...(state?.spots ?? []),\n      ...localSpots,\n    ];\n    return next;\n  });\n  private manualClientPhysicsTick = false;\n  private readonly isTestEnvironment: boolean;\n\n  constructor() {\n    super();\n    // Détecter l'environnement de test\n    const testGlobal = globalThis as TestGlobalScope;\n    const isTest = testGlobal.process?.env?.TEST === 'true'\n      || testGlobal.__RPGJS_TEST__ === true;\n    this.isTestEnvironment = isTest;\n    if (isTest) {\n      this.autoTickEnabled = false;\n    }\n  }\n\n  configureClientPrediction(enabled: boolean): void {\n    this.manualClientPhysicsTick = enabled;\n    this.autoTickEnabled = enabled ? false : !this.isTestEnvironment;\n  }\n\n  getCurrentPlayer() {\n    return this.currentPlayer()\n  }\n\n  reset(force = false) {\n    const currentPlayerId = this.engine.playerIdSignal();\n    const currentPlayer = !force && currentPlayerId\n      ? this.players()[currentPlayerId]\n      : undefined;\n    const players = this.players();\n    const events = this.events();\n\n    Object.entries(players).forEach(([id, player]) => {\n      if (!player || (!force && id === currentPlayerId)) return;\n      (player as any).resetAnimationState?.();\n    });\n    Object.values(events).forEach((event) => {\n      (event as any)?.resetAnimationState?.();\n    });\n\n    this.players.set(\n      currentPlayerId && currentPlayer ? { [currentPlayerId]: currentPlayer } : {}\n    );\n    this.events.set({})\n    this.weatherState.set(null);\n    this.localWeatherValue = null;\n    this.localWeatherOverride.set(null);\n    this.lightingState.set(null);\n    this.localLightSpots.set({});\n    this.clearPhysic()\n  }\n\n  getWeather(): WeatherState | null {\n    return this.weather();\n  }\n\n  setLocalWeather(next: WeatherState | null): void {\n    if (this.localWeatherValue === next) {\n      return;\n    }\n    this.localWeatherValue = next;\n    this.localWeatherOverride.set(next);\n  }\n\n  clearLocalWeather(): void {\n    this.localWeatherValue = null;\n    this.localWeatherOverride.set(null);\n  }\n\n  getLighting(): LightingState | null {\n    return this.lighting();\n  }\n\n  addLightSpot(id: string, spot: LightSpot): void {\n    const normalized = normalizeLightingState({ spots: [{ ...spot, id }] });\n    const nextSpot = normalized?.spots?.[0];\n    if (!nextSpot) {\n      return;\n    }\n    this.localLightSpots.update((spots) => {\n      if (lightSpotsEqual(spots[id], nextSpot)) {\n        return spots;\n      }\n      return {\n        ...spots,\n        [id]: nextSpot,\n      };\n    });\n  }\n\n  patchLightSpot(id: string, patch: Partial<LightSpot>): void {\n    this.localLightSpots.update((spots) => {\n      const current = spots[id];\n      if (!current) {\n        return spots;\n      }\n      return {\n        ...spots,\n        [id]: {\n          ...current,\n          ...patch,\n          id,\n          x: patch.x ?? current.x,\n          y: patch.y ?? current.y,\n        },\n      };\n    });\n  }\n\n  removeLightSpot(id: string): void {\n    this.localLightSpots.update((spots) => {\n      if (!(id in spots)) {\n        return spots;\n      }\n      const next = { ...spots };\n      delete next[id];\n      return next;\n    });\n  }\n\n  clearLightSpots(): void {\n    this.localLightSpots.set({});\n  }\n\n  stepClientPhysics(deltaMs: number): number {\n    if (!this.manualClientPhysicsTick) {\n      return 0;\n    }\n    return this.nextTick(deltaMs);\n  }\n\n  stepPredictionTick(): void {\n    this.forceSingleTick();\n  }\n\n  protected emitPhysicsInit(context: MapPhysicsInitContext): void {\n    this.engine?.emitSceneMapHook?.(\"onPhysicsInit\", this, context);\n  }\n\n  protected emitPhysicsEntityAdd(context: MapPhysicsEntityContext): void {\n    this.engine?.emitSceneMapHook?.(\"onPhysicsEntityAdd\", this, context);\n  }\n\n  protected emitPhysicsEntityRemove(context: MapPhysicsEntityContext): void {\n    this.engine?.emitSceneMapHook?.(\"onPhysicsEntityRemove\", this, context);\n  }\n\n  protected emitPhysicsReset(): void {\n    this.engine?.emitSceneMapHook?.(\"onPhysicsReset\", this);\n  }\n}\n"],"mappings":"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"}

package/dist/Game/Object.js.map

@@ -1 +1 @@
-{"version":3,"file":"Object.js","names":[],"sources":["../../src/Game/Object.ts"],"sourcesContent":["import { Hooks, ModulesToken, RpgCommonPlayer } from \"@rpgjs/common\";\nimport { trigger, signal, type Trigger } from \"canvasengine\";\nimport { combineLatest, from, map, of, startWith, Subscription, switchMap } from \"rxjs\";\nimport { inject } from \"../core/inject\";\nimport { RpgClientEngine } from \"../RpgClientEngine\";\ntype Frame = { x: number; y: number; ts: number };\n\ntype AnimationRestoreOptions = {\n  restoreAnimationName?: string;\n  restoreGraphics?: any[];\n  timeoutMs?: number;\n};\n\ntype FlashType = 'alpha' | 'tint' | 'both';\n\ntype FlashOptions = {\n  type?: FlashType;\n  duration?: number;\n  cycles?: number;\n  alpha?: number;\n  tint?: number | string;\n};\n\ntype FlashTriggerOptions = Omit<FlashOptions, \"tint\"> & {\n  tint: number;\n};\n\ntype ConfigurableTrigger<T> = Omit<Trigger<T>, \"start\"> & {\n  start(config?: T): Promise<void>;\n};\n\nconst toFiniteScale = (value: unknown, fallback: number): number => {\n  if (typeof value === \"number\" && Number.isFinite(value)) return value;\n  if (typeof value === \"string\" && value.trim()) {\n    const parsed = Number(value);\n    return Number.isFinite(parsed) ? parsed : fallback;\n  }\n  return fallback;\n};\n\nconst normalizeGraphicScale = (value: unknown, fallback: [number, number] = [1, 1]): [number, number] => {\n  if (typeof value === \"number\" || typeof value === \"string\") {\n    const scale = toFiniteScale(value, fallback[0]);\n    return [scale, scale];\n  }\n  if (Array.isArray(value)) {\n    const x = toFiniteScale(value[0], fallback[0]);\n    const y = toFiniteScale(value[1] ?? value[0], x);\n    return [x, y];\n  }\n  if (value && typeof value === \"object\") {\n    const scale = value as { x?: unknown; y?: unknown };\n    const x = toFiniteScale(scale.x, fallback[0]);\n    const y = toFiniteScale(scale.y ?? scale.x, x);\n    return [x, y];\n  }\n  return fallback;\n};\n\nexport const multiplyGraphicDisplayScale = (\n  baseScale: unknown,\n  instanceScale: unknown,\n): [number, number] => {\n  const base = normalizeGraphicScale(baseScale);\n  const instance = normalizeGraphicScale(instanceScale);\n  return [base[0] * instance[0], base[1] * instance[1]];\n};\n\nexport const withGraphicDisplayScale = (spritesheet: any, scale: unknown): any => {\n  if (!spritesheet || typeof spritesheet !== \"object\") return spritesheet;\n  if (scale === undefined || scale === null) return spritesheet;\n  return {\n    ...spritesheet,\n    displayScale: multiplyGraphicDisplayScale(spritesheet.displayScale, scale),\n  };\n};\n\nexport const appendFramePayload = (current: unknown, items: unknown): Frame[] => {\n  const frameItems = Array.isArray(items) ? items : items ? [items] : [];\n  const nextFrames = frameItems.flatMap((item): Frame[] =>\n    Array.isArray(item) ? item : [item as Frame]\n  );\n  const currentFrames = Array.isArray(current) ? current as Frame[] : [];\n  return currentFrames.concat(nextFrames);\n};\n\nexport const getFrameTimestamp = (frame: Frame): number => {\n  const timestamp = Number(frame.ts);\n  return Number.isFinite(timestamp) ? timestamp : 0;\n};\n\nexport const mergeFreshFramePayload = (\n  current: unknown,\n  items: unknown,\n  lastAppliedFrameTs = 0,\n): Frame[] => {\n  return appendFramePayload(current, items)\n    .filter((frame) => {\n      const timestamp = getFrameTimestamp(frame);\n      return timestamp === 0 || timestamp > lastAppliedFrameTs;\n    })\n    .sort((a, b) => getFrameTimestamp(a) - getFrameTimestamp(b));\n};\n\nexport abstract class RpgClientObject extends RpgCommonPlayer {\n  abstract _type: string;\n  emitParticleTrigger = trigger();\n  particleName = signal(\"\");\n  animationCurrentIndex = signal(0);\n  animationIsPlaying = signal(false);\n  _param = signal({});\n  frames: Frame[] = [];\n  graphicsSignals = signal<any[]>([]);\n  flashTrigger: ConfigurableTrigger<FlashTriggerOptions> = trigger<FlashTriggerOptions>();\n  private lastAppliedFrameTs = 0;\n  private animationRestoreState?: {\n    animationName: string;\n    graphics: any[];\n  };\n\n  constructor() {\n    super();\n    const engine = this.engine;\n    this.hooks.callHooks(\"client-sprite-onInit\", this).subscribe();\n\n    this._frames.observable.subscribe(({ items }) => {\n      if (!this.id) return;\n      //if (this.id == this.engine.playerIdSignal()!) return;\n      this.frames = mergeFreshFramePayload(\n        this.frames,\n        items,\n        this.lastAppliedFrameTs,\n      );\n    });\n\n    const graphics$ = this.graphics.observable.pipe(map(({ items }) => items));\n    const graphicScale$ = this._graphicScale.observable.pipe(\n      startWith({ value: this._graphicScale() }),\n      map((payload: any) => payload?.value ?? payload),\n    );\n\n    combineLatest([graphics$, graphicScale$])\n    .pipe(\n      switchMap(([graphics, scale]) => {\n        const graphicRefs = Array.isArray(graphics) ? graphics : [];\n        if (graphicRefs.length === 0) return of([]);\n        return from(Promise.all(graphicRefs.map(async (graphic) => {\n          const spritesheet = await engine.getSpriteSheet(graphic);\n          return withGraphicDisplayScale(spritesheet, scale);\n        })));\n      })\n    )\n    .subscribe((sheets) => {  \n      this.graphicsSignals.set(sheets);\n    });\n\n    engine.tick\n      .pipe\n      //throttleTime(10)\n      ()\n      .subscribe(() => {\n        const frame = this.frames.shift();\n        if (frame) {\n          if (typeof frame.x !== \"number\" || typeof frame.y !== \"number\") return;\n          const frameTs = this.getFrameTimestamp(frame);\n          if (frameTs > 0 && frameTs <= this.lastAppliedFrameTs) return;\n          engine.scene.setBodyPosition(\n            this.id,\n            frame.x,\n            frame.y,\n            \"top-left\"\n          );\n          if (frameTs > this.lastAppliedFrameTs) {\n            this.lastAppliedFrameTs = frameTs;\n          }\n        }\n      });\n  }\n\n  private getFrameTimestamp(frame: Frame): number {\n    return getFrameTimestamp(frame);\n  }\n\n  /**\n   * Access the shared client hook registry.\n   *\n   * @returns The hook service used to register and trigger client-side hooks.\n   */\n  get hooks() {\n    return inject<Hooks>(ModulesToken);\n  }\n\n  /**\n   * Access the current client engine instance.\n   *\n   * @returns The active {@link RpgClientEngine} instance.\n   */\n  get engine() {\n    return inject(RpgClientEngine);\n  }\n\n  setHitbox(width: number, height: number): void {\n    if (typeof width !== \"number\" || width <= 0) {\n      throw new Error(\"setHitbox: width must be a positive number\");\n    }\n    if (typeof height !== \"number\" || height <= 0) {\n      throw new Error(\"setHitbox: height must be a positive number\");\n    }\n\n    this.hitbox.set({\n      w: width,\n      h: height,\n    });\n\n    const sceneMap = (this.engine as any)?.sceneMap;\n    if (sceneMap && this.id) {\n      sceneMap.updateHitbox?.(this.id, this.x(), this.y(), width, height);\n    }\n  }\n\n  private animationSubscription?: Subscription;\n  private animationResetTimeout?: ReturnType<typeof setTimeout>;\n  private animationWaitResolve?: () => void;\n\n  private clearAnimationControls() {\n    if (this.animationSubscription) {\n      this.animationSubscription.unsubscribe();\n      this.animationSubscription = undefined;\n    }\n    if (this.animationResetTimeout) {\n      clearTimeout(this.animationResetTimeout);\n      this.animationResetTimeout = undefined;\n    }\n  }\n\n  private resolveAnimationWait() {\n    const resolve = this.animationWaitResolve;\n    this.animationWaitResolve = undefined;\n    resolve?.();\n  }\n\n  private finishTemporaryAnimation() {\n    const restoreState = this.animationRestoreState;\n    this.clearAnimationControls();\n    this.animationCurrentIndex.set(0);\n    this.animationRestoreState = undefined;\n    this.animationIsPlaying.set(false);\n    if (restoreState) {\n      this.animationName.set(restoreState.animationName);\n      this.graphics.set([...restoreState.graphics]);\n    }\n    this.resolveAnimationWait();\n  }\n\n  /**\n   * Trigger a flash animation on this sprite\n   * \n   * This method triggers a flash effect using CanvasEngine's flash directive.\n   * The flash can be configured with various options including type (alpha, tint, or both),\n   * duration, cycles, and color.\n   * \n   * ## Design\n   * \n   * The flash uses a trigger system that is connected to the flash directive in the\n   * character component. This allows for flexible configuration and can be triggered\n   * from both server events and client-side code.\n   * \n   * @param options - Flash configuration options\n   * @param options.type - Type of flash effect: 'alpha' (opacity), 'tint' (color), or 'both' (default: 'alpha')\n   * @param options.duration - Duration of the flash animation in milliseconds (default: 300)\n   * @param options.cycles - Number of flash cycles (flash on/off) (default: 1)\n   * @param options.alpha - Alpha value when flashing, from 0 to 1 (default: 0.3)\n   * @param options.tint - Tint color when flashing as hex value or color name (default: 0xffffff - white)\n   * \n   * @example\n   * ```ts\n   * // Simple flash with default settings (alpha flash)\n   * player.flash();\n   * \n   * // Flash with red tint\n   * player.flash({ type: 'tint', tint: 0xff0000 });\n   * \n   * // Flash with both alpha and tint\n   * player.flash({ \n   *   type: 'both', \n   *   alpha: 0.5, \n   *   tint: 0xff0000,\n   *   duration: 200,\n   *   cycles: 2\n   * });\n   * \n   * // Quick damage flash\n   * player.flash({ \n   *   type: 'tint', \n   *   tint: 0xff0000, \n   *   duration: 150,\n   *   cycles: 1\n   * });\n   * ```\n   */\n  flash(options?: FlashOptions): void {\n    const flashOptions = {\n      type: options?.type || 'alpha',\n      duration: options?.duration ?? 300,\n      cycles: options?.cycles ?? 1,\n      alpha: options?.alpha ?? 0.3,\n      tint: options?.tint ?? 0xffffff,\n    };\n    \n    // Convert color name to hex if needed\n    let tintValue = flashOptions.tint;\n    if (typeof tintValue === 'string') {\n      // Common color name to hex mapping\n      const colorMap: Record<string, number> = {\n        'white': 0xffffff,\n        'red': 0xff0000,\n        'green': 0x00ff00,\n        'blue': 0x0000ff,\n        'yellow': 0xffff00,\n        'cyan': 0x00ffff,\n        'magenta': 0xff00ff,\n        'black': 0x000000,\n      };\n      tintValue = colorMap[tintValue.toLowerCase()] ?? 0xffffff;\n    }\n    \n    this.flashTrigger.start({\n      ...flashOptions,\n      tint: tintValue,\n    });\n  }\n\n  /**\n   * Reset animation state when animation changes externally\n   *\n   * This method should be called when the animation changes due to movement\n   * or other external factors to ensure the animation system doesn't get stuck\n   *\n   * @example\n   * ```ts\n   * // Reset when player starts moving\n   * player.resetAnimationState();\n   * ```\n   */\n  resetAnimationState() {\n    if (this.animationRestoreState) {\n      this.finishTemporaryAnimation();\n      return;\n    }\n    this.animationIsPlaying.set(false);\n    this.animationCurrentIndex.set(0);\n    this.clearAnimationControls();\n    this.resolveAnimationWait();\n  }\n\n  /**\n   * Set a custom animation for a specific number of times\n   *\n   * Plays a custom animation for the specified number of repetitions.\n   * The animation system prevents overlapping animations and automatically\n   * returns to the previous animation when complete.\n   *\n   * @param animationName - Name of the animation to play\n   * @param nbTimes - Number of times to repeat the animation (default: Infinity for continuous)\n   * @param options - Restore and timeout options\n   * @returns A promise resolved when a finite animation finishes, is interrupted, or times out\n   *\n   * @example\n   * ```ts\n   * // Play attack animation 3 times\n   * await player.setAnimation('attack', 3);\n   *\n   * // Play continuous spell animation\n   * player.setAnimation('spell');\n   * ```\n   */\n  setAnimation(animationName: string, nbTimes?: number, options?: AnimationRestoreOptions): Promise<void>;\n  /**\n   * Set a custom animation with temporary graphic change\n   *\n   * Plays a custom animation for the specified number of repetitions and temporarily\n   * changes the player's graphic (sprite sheet) during the animation. The graphic\n   * is automatically reset when the animation finishes.\n   *\n   * @param animationName - Name of the animation to play\n   * @param graphic - The graphic(s) to temporarily use during the animation\n   * @param nbTimes - Number of times to repeat the animation (default: Infinity for continuous)\n   * @param options - Restore and timeout options\n   * @returns A promise resolved when a finite animation finishes, is interrupted, or times out\n   *\n   * @example\n   * ```ts\n   * // Play attack animation with temporary graphic change\n   * await player.setAnimation('attack', 'hero_attack', 3);\n   * ```\n   */\n  setAnimation(animationName: string, graphic?: string | string[], nbTimes?: number, options?: AnimationRestoreOptions): Promise<void>;\n  setAnimation(\n    animationName: string,\n    graphicOrNbTimes?: string | string[] | number,\n    nbTimesOrOptions?: number | AnimationRestoreOptions,\n    options?: AnimationRestoreOptions\n  ): Promise<void> {\n    let graphic: string | string[] | undefined;\n    let finalNbTimes: number = Infinity;\n    let restoreOptions: AnimationRestoreOptions | undefined = options;\n\n    // Handle overloads\n    if (typeof graphicOrNbTimes === 'number') {\n      // setAnimation(animationName, nbTimes)\n      finalNbTimes = graphicOrNbTimes;\n      restoreOptions = typeof nbTimesOrOptions === 'object' ? nbTimesOrOptions : options;\n    } else if (graphicOrNbTimes !== undefined) {\n      // setAnimation(animationName, graphic, nbTimes)\n      graphic = graphicOrNbTimes;\n      if (typeof nbTimesOrOptions === 'number') {\n        finalNbTimes = nbTimesOrOptions;\n      } else {\n        finalNbTimes = Infinity;\n        restoreOptions = nbTimesOrOptions ?? options;\n      }\n    } else {\n      // setAnimation(animationName) - nbTimes remains Infinity\n      finalNbTimes = Infinity;\n    }\n\n    if (this.animationIsPlaying()) {\n      this.finishTemporaryAnimation();\n    }\n\n    const waitPromise =\n      finalNbTimes === Infinity\n        ? Promise.resolve()\n        : new Promise<void>((resolve) => {\n            this.animationWaitResolve = resolve;\n          });\n\n    this.animationIsPlaying.set(true);\n    const previousAnimationName =\n      restoreOptions?.restoreAnimationName ?? this.animationName();\n    const previousGraphics = restoreOptions?.restoreGraphics\n      ? [...restoreOptions.restoreGraphics]\n      : [...this.graphics()];\n    this.animationRestoreState = {\n      animationName: previousAnimationName,\n      graphics: previousGraphics,\n    };\n    this.animationCurrentIndex.set(0);\n\n    // Temporarily change graphic if provided\n    if (graphic !== undefined) {\n      if (Array.isArray(graphic)) {\n        this.graphics.set(graphic);\n      } else {\n        this.graphics.set([graphic]);\n      }\n    }\n\n    this.clearAnimationControls();\n\n    this.animationSubscription =\n      this.animationCurrentIndex.observable.subscribe((index) => {\n        if (index >= finalNbTimes) {\n          this.finishTemporaryAnimation();\n        }\n      });\n\n    if (finalNbTimes !== Infinity) {\n      this.animationResetTimeout = setTimeout(() => {\n        if (this.animationIsPlaying()) {\n          this.finishTemporaryAnimation();\n        }\n      }, restoreOptions?.timeoutMs ?? Math.max(1000, finalNbTimes * 1000));\n    }\n\n    this.animationName.set(animationName);\n\n    return waitPromise;\n  }\n\n  /**\n   * Display a registered component animation effect on this object.\n   *\n   * @param id - Identifier of the component animation to play.\n   * @param params - Parameters forwarded to the animation effect.\n   * @returns A promise resolved when the animation component calls `onFinish`.\n   */\n  showComponentAnimation(id: string, params: any): Promise<void> {\n    const engine = inject(RpgClientEngine);\n    return engine.getComponentAnimation(id).displayEffect(params, this);\n  }\n\n  /**\n   * Display a registered spritesheet animation effect on this object.\n   *\n   * @param graphic - Identifier of the spritesheet to use.\n   * @param animationName - Name of the animation inside the spritesheet.\n   * @returns A promise resolved when the animation component calls `onFinish`.\n   */\n  showAnimation(graphic: string, animationName: string = 'default'): Promise<void> {\n    return this.showComponentAnimation('animation', {\n      graphic,\n      animationName,\n    });\n  }\n  \n  /**\n   * Check whether this client object represents an event.\n   *\n   * @returns `true` if the object type is `event`, otherwise `false`.\n   */\n  isEvent(): boolean {\n    return this._type === 'event';\n  }\n\n  /**\n   * Check whether this client object represents a player.\n   *\n   * @returns `true` if the object type is `player`, otherwise `false`.\n   */\n  isPlayer(): boolean {\n    return this._type === 'player';\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"Object.js","names":[],"sources":["../../src/Game/Object.ts"],"sourcesContent":["import { Hooks, ModulesToken, RpgCommonPlayer } from \"@rpgjs/common\";\nimport { trigger, signal, type Trigger } from \"canvasengine\";\nimport { combineLatest, from, map, of, startWith, Subscription, switchMap, type Observable } from \"rxjs\";\nimport { inject } from \"../core/inject\";\nimport { RpgClientEngine } from \"../RpgClientEngine\";\ntype Frame = { x: number; y: number; ts: number };\n\ntype AnimationRestoreOptions = {\n  restoreAnimationName?: string;\n  restoreGraphics?: any[];\n  timeoutMs?: number;\n};\n\ntype FlashType = 'alpha' | 'tint' | 'both';\n\ntype FlashOptions = {\n  type?: FlashType;\n  duration?: number;\n  cycles?: number;\n  alpha?: number;\n  tint?: number | string;\n};\n\ntype FlashTriggerOptions = Omit<FlashOptions, \"tint\"> & {\n  tint: number;\n};\n\ntype ConfigurableTrigger<T> = Omit<Trigger<T>, \"start\"> & {\n  start(config?: T): Promise<void>;\n};\n\nconst toFiniteScale = (value: unknown, fallback: number): number => {\n  if (typeof value === \"number\" && Number.isFinite(value)) return value;\n  if (typeof value === \"string\" && value.trim()) {\n    const parsed = Number(value);\n    return Number.isFinite(parsed) ? parsed : fallback;\n  }\n  return fallback;\n};\n\nconst normalizeGraphicScale = (value: unknown, fallback: [number, number] = [1, 1]): [number, number] => {\n  if (typeof value === \"number\" || typeof value === \"string\") {\n    const scale = toFiniteScale(value, fallback[0]);\n    return [scale, scale];\n  }\n  if (Array.isArray(value)) {\n    const x = toFiniteScale(value[0], fallback[0]);\n    const y = toFiniteScale(value[1] ?? value[0], x);\n    return [x, y];\n  }\n  if (value && typeof value === \"object\") {\n    const scale = value as { x?: unknown; y?: unknown };\n    const x = toFiniteScale(scale.x, fallback[0]);\n    const y = toFiniteScale(scale.y ?? scale.x, x);\n    return [x, y];\n  }\n  return fallback;\n};\n\nexport const multiplyGraphicDisplayScale = (\n  baseScale: unknown,\n  instanceScale: unknown,\n): [number, number] => {\n  const base = normalizeGraphicScale(baseScale);\n  const instance = normalizeGraphicScale(instanceScale);\n  return [base[0] * instance[0], base[1] * instance[1]];\n};\n\nexport const withGraphicDisplayScale = (spritesheet: any, scale: unknown): any => {\n  if (!spritesheet || typeof spritesheet !== \"object\") return spritesheet;\n  if (scale === undefined || scale === null) return spritesheet;\n  return {\n    ...spritesheet,\n    displayScale: multiplyGraphicDisplayScale(spritesheet.displayScale, scale),\n  };\n};\n\nexport const appendFramePayload = (current: unknown, items: unknown): Frame[] => {\n  const frameItems = Array.isArray(items) ? items : items ? [items] : [];\n  const nextFrames = frameItems.flatMap((item): Frame[] =>\n    Array.isArray(item) ? item : [item as Frame]\n  );\n  const currentFrames = Array.isArray(current) ? current as Frame[] : [];\n  return currentFrames.concat(nextFrames);\n};\n\nexport const getFrameTimestamp = (frame: Frame): number => {\n  const timestamp = Number(frame.ts);\n  return Number.isFinite(timestamp) ? timestamp : 0;\n};\n\nexport const mergeFreshFramePayload = (\n  current: unknown,\n  items: unknown,\n  lastAppliedFrameTs = 0,\n): Frame[] => {\n  return appendFramePayload(current, items)\n    .filter((frame) => {\n      const timestamp = getFrameTimestamp(frame);\n      return timestamp === 0 || timestamp > lastAppliedFrameTs;\n    })\n    .sort((a, b) => getFrameTimestamp(a) - getFrameTimestamp(b));\n};\n\nexport abstract class RpgClientObject extends RpgCommonPlayer {\n  abstract _type: string;\n  emitParticleTrigger = trigger();\n  particleName = signal(\"\");\n  animationCurrentIndex = signal(0);\n  animationIsPlaying = signal(false);\n  _param = signal({});\n  frames: Frame[] = [];\n  graphicsSignals = signal<any[]>([]);\n  flashTrigger: ConfigurableTrigger<FlashTriggerOptions> = trigger<FlashTriggerOptions>();\n  private lastAppliedFrameTs = 0;\n  private animationRestoreState?: {\n    animationName: string;\n    graphics: any[];\n  };\n\n  constructor() {\n    super();\n    const engine = this.engine;\n    this.hooks.callHooks(\"client-sprite-onInit\", this).subscribe();\n\n    (this._frames as any).observable.subscribe(({ items }) => {\n      if (!this.id) return;\n      //if (this.id == this.engine.playerIdSignal()!) return;\n      this.frames = mergeFreshFramePayload(\n        this.frames,\n        items,\n        this.lastAppliedFrameTs,\n      );\n    });\n\n    const graphics$: Observable<unknown> = (this.graphics as any).observable.pipe(map(({ items }) => items));\n    const graphicScale$: Observable<unknown> = (this._graphicScale as any).observable.pipe(\n      startWith({ value: this._graphicScale() }),\n      map((payload: any) => payload?.value ?? payload),\n    );\n\n    combineLatest([graphics$, graphicScale$])\n    .pipe(\n      switchMap(([graphics, scale]) => {\n        const graphicRefs = Array.isArray(graphics) ? graphics : [];\n        if (graphicRefs.length === 0) return of([]);\n        return from(Promise.all(graphicRefs.map(async (graphic) => {\n          const spritesheet = await engine.getSpriteSheet(graphic);\n          return withGraphicDisplayScale(spritesheet, scale);\n        })));\n      })\n    )\n    .subscribe((sheets) => {  \n      this.graphicsSignals.set(sheets);\n    });\n\n    engine.tick\n      .pipe\n      //throttleTime(10)\n      ()\n      .subscribe(() => {\n        const frame = this.frames.shift();\n        if (frame) {\n          if (typeof frame.x !== \"number\" || typeof frame.y !== \"number\") return;\n          const frameTs = this.getFrameTimestamp(frame);\n          if (frameTs > 0 && frameTs <= this.lastAppliedFrameTs) return;\n          engine.scene.setBodyPosition(\n            this.id,\n            frame.x,\n            frame.y,\n            \"top-left\"\n          );\n          if (frameTs > this.lastAppliedFrameTs) {\n            this.lastAppliedFrameTs = frameTs;\n          }\n        }\n      });\n  }\n\n  private getFrameTimestamp(frame: Frame): number {\n    return getFrameTimestamp(frame);\n  }\n\n  /**\n   * Access the shared client hook registry.\n   *\n   * @returns The hook service used to register and trigger client-side hooks.\n   */\n  get hooks() {\n    return inject<Hooks>(ModulesToken);\n  }\n\n  /**\n   * Access the current client engine instance.\n   *\n   * @returns The active {@link RpgClientEngine} instance.\n   */\n  get engine() {\n    return inject(RpgClientEngine);\n  }\n\n  setHitbox(width: number, height: number): void {\n    if (typeof width !== \"number\" || width <= 0) {\n      throw new Error(\"setHitbox: width must be a positive number\");\n    }\n    if (typeof height !== \"number\" || height <= 0) {\n      throw new Error(\"setHitbox: height must be a positive number\");\n    }\n\n    this.hitbox.set({\n      w: width,\n      h: height,\n    });\n\n    const sceneMap = (this.engine as any)?.sceneMap;\n    if (sceneMap && this.id) {\n      sceneMap.updateHitbox?.(this.id, this.x(), this.y(), width, height);\n    }\n  }\n\n  private animationSubscription?: Subscription;\n  private animationResetTimeout?: ReturnType<typeof setTimeout>;\n  private animationWaitResolve?: () => void;\n\n  private clearAnimationControls() {\n    if (this.animationSubscription) {\n      this.animationSubscription.unsubscribe();\n      this.animationSubscription = undefined;\n    }\n    if (this.animationResetTimeout) {\n      clearTimeout(this.animationResetTimeout);\n      this.animationResetTimeout = undefined;\n    }\n  }\n\n  private resolveAnimationWait() {\n    const resolve = this.animationWaitResolve;\n    this.animationWaitResolve = undefined;\n    resolve?.();\n  }\n\n  private finishTemporaryAnimation() {\n    const restoreState = this.animationRestoreState;\n    this.clearAnimationControls();\n    this.animationCurrentIndex.set(0);\n    this.animationRestoreState = undefined;\n    this.animationIsPlaying.set(false);\n    if (restoreState) {\n      this.animationName.set(restoreState.animationName);\n      this.graphics.set([...restoreState.graphics]);\n    }\n    this.resolveAnimationWait();\n  }\n\n  /**\n   * Trigger a flash animation on this sprite\n   * \n   * This method triggers a flash effect using CanvasEngine's flash directive.\n   * The flash can be configured with various options including type (alpha, tint, or both),\n   * duration, cycles, and color.\n   * \n   * ## Design\n   * \n   * The flash uses a trigger system that is connected to the flash directive in the\n   * character component. This allows for flexible configuration and can be triggered\n   * from both server events and client-side code.\n   * \n   * @param options - Flash configuration options\n   * @param options.type - Type of flash effect: 'alpha' (opacity), 'tint' (color), or 'both' (default: 'alpha')\n   * @param options.duration - Duration of the flash animation in milliseconds (default: 300)\n   * @param options.cycles - Number of flash cycles (flash on/off) (default: 1)\n   * @param options.alpha - Alpha value when flashing, from 0 to 1 (default: 0.3)\n   * @param options.tint - Tint color when flashing as hex value or color name (default: 0xffffff - white)\n   * \n   * @example\n   * ```ts\n   * // Simple flash with default settings (alpha flash)\n   * player.flash();\n   * \n   * // Flash with red tint\n   * player.flash({ type: 'tint', tint: 0xff0000 });\n   * \n   * // Flash with both alpha and tint\n   * player.flash({ \n   *   type: 'both', \n   *   alpha: 0.5, \n   *   tint: 0xff0000,\n   *   duration: 200,\n   *   cycles: 2\n   * });\n   * \n   * // Quick damage flash\n   * player.flash({ \n   *   type: 'tint', \n   *   tint: 0xff0000, \n   *   duration: 150,\n   *   cycles: 1\n   * });\n   * ```\n   */\n  flash(options?: FlashOptions): void {\n    const flashOptions = {\n      type: options?.type || 'alpha',\n      duration: options?.duration ?? 300,\n      cycles: options?.cycles ?? 1,\n      alpha: options?.alpha ?? 0.3,\n      tint: options?.tint ?? 0xffffff,\n    };\n    \n    // Convert color name to hex if needed\n    let tintValue = flashOptions.tint;\n    if (typeof tintValue === 'string') {\n      // Common color name to hex mapping\n      const colorMap: Record<string, number> = {\n        'white': 0xffffff,\n        'red': 0xff0000,\n        'green': 0x00ff00,\n        'blue': 0x0000ff,\n        'yellow': 0xffff00,\n        'cyan': 0x00ffff,\n        'magenta': 0xff00ff,\n        'black': 0x000000,\n      };\n      tintValue = colorMap[tintValue.toLowerCase()] ?? 0xffffff;\n    }\n    \n    this.flashTrigger.start({\n      ...flashOptions,\n      tint: tintValue,\n    });\n  }\n\n  /**\n   * Reset animation state when animation changes externally\n   *\n   * This method should be called when the animation changes due to movement\n   * or other external factors to ensure the animation system doesn't get stuck\n   *\n   * @example\n   * ```ts\n   * // Reset when player starts moving\n   * player.resetAnimationState();\n   * ```\n   */\n  resetAnimationState() {\n    if (this.animationRestoreState) {\n      this.finishTemporaryAnimation();\n      return;\n    }\n    this.animationIsPlaying.set(false);\n    this.animationCurrentIndex.set(0);\n    this.clearAnimationControls();\n    this.resolveAnimationWait();\n  }\n\n  /**\n   * Set a custom animation for a specific number of times\n   *\n   * Plays a custom animation for the specified number of repetitions.\n   * The animation system prevents overlapping animations and automatically\n   * returns to the previous animation when complete.\n   *\n   * @param animationName - Name of the animation to play\n   * @param nbTimes - Number of times to repeat the animation (default: Infinity for continuous)\n   * @param options - Restore and timeout options\n   * @returns A promise resolved when a finite animation finishes, is interrupted, or times out\n   *\n   * @example\n   * ```ts\n   * // Play attack animation 3 times\n   * await player.setAnimation('attack', 3);\n   *\n   * // Play continuous spell animation\n   * player.setAnimation('spell');\n   * ```\n   */\n  setAnimation(animationName: string, nbTimes?: number, options?: AnimationRestoreOptions): Promise<void>;\n  /**\n   * Set a custom animation with temporary graphic change\n   *\n   * Plays a custom animation for the specified number of repetitions and temporarily\n   * changes the player's graphic (sprite sheet) during the animation. The graphic\n   * is automatically reset when the animation finishes.\n   *\n   * @param animationName - Name of the animation to play\n   * @param graphic - The graphic(s) to temporarily use during the animation\n   * @param nbTimes - Number of times to repeat the animation (default: Infinity for continuous)\n   * @param options - Restore and timeout options\n   * @returns A promise resolved when a finite animation finishes, is interrupted, or times out\n   *\n   * @example\n   * ```ts\n   * // Play attack animation with temporary graphic change\n   * await player.setAnimation('attack', 'hero_attack', 3);\n   * ```\n   */\n  setAnimation(animationName: string, graphic?: string | string[], nbTimes?: number, options?: AnimationRestoreOptions): Promise<void>;\n  setAnimation(\n    animationName: string,\n    graphicOrNbTimes?: string | string[] | number,\n    nbTimesOrOptions?: number | AnimationRestoreOptions,\n    options?: AnimationRestoreOptions\n  ): Promise<void> {\n    let graphic: string | string[] | undefined;\n    let finalNbTimes: number = Infinity;\n    let restoreOptions: AnimationRestoreOptions | undefined = options;\n\n    // Handle overloads\n    if (typeof graphicOrNbTimes === 'number') {\n      // setAnimation(animationName, nbTimes)\n      finalNbTimes = graphicOrNbTimes;\n      restoreOptions = typeof nbTimesOrOptions === 'object' ? nbTimesOrOptions : options;\n    } else if (graphicOrNbTimes !== undefined) {\n      // setAnimation(animationName, graphic, nbTimes)\n      graphic = graphicOrNbTimes;\n      if (typeof nbTimesOrOptions === 'number') {\n        finalNbTimes = nbTimesOrOptions;\n      } else {\n        finalNbTimes = Infinity;\n        restoreOptions = nbTimesOrOptions ?? options;\n      }\n    } else {\n      // setAnimation(animationName) - nbTimes remains Infinity\n      finalNbTimes = Infinity;\n    }\n\n    if (this.animationIsPlaying()) {\n      this.finishTemporaryAnimation();\n    }\n\n    const waitPromise =\n      finalNbTimes === Infinity\n        ? Promise.resolve()\n        : new Promise<void>((resolve) => {\n            this.animationWaitResolve = resolve;\n          });\n\n    this.animationIsPlaying.set(true);\n    const previousAnimationName =\n      restoreOptions?.restoreAnimationName ?? this.animationName();\n    const previousGraphics = restoreOptions?.restoreGraphics\n      ? [...restoreOptions.restoreGraphics]\n      : [...this.graphics()];\n    this.animationRestoreState = {\n      animationName: previousAnimationName,\n      graphics: previousGraphics,\n    };\n    this.animationCurrentIndex.set(0);\n\n    // Temporarily change graphic if provided\n    if (graphic !== undefined) {\n      if (Array.isArray(graphic)) {\n        this.graphics.set(graphic);\n      } else {\n        this.graphics.set([graphic]);\n      }\n    }\n\n    this.clearAnimationControls();\n\n    this.animationSubscription =\n      this.animationCurrentIndex.observable.subscribe((index) => {\n        if (index >= finalNbTimes) {\n          this.finishTemporaryAnimation();\n        }\n      });\n\n    if (finalNbTimes !== Infinity) {\n      this.animationResetTimeout = setTimeout(() => {\n        if (this.animationIsPlaying()) {\n          this.finishTemporaryAnimation();\n        }\n      }, restoreOptions?.timeoutMs ?? Math.max(1000, finalNbTimes * 1000));\n    }\n\n    this.animationName.set(animationName);\n\n    return waitPromise;\n  }\n\n  /**\n   * Display a registered component animation effect on this object.\n   *\n   * @param id - Identifier of the component animation to play.\n   * @param params - Parameters forwarded to the animation effect.\n   * @returns A promise resolved when the animation component calls `onFinish`.\n   */\n  showComponentAnimation(id: string, params: any): Promise<void> {\n    const engine = inject(RpgClientEngine);\n    return engine.getComponentAnimation(id).displayEffect(params, this);\n  }\n\n  /**\n   * Display a registered spritesheet animation effect on this object.\n   *\n   * @param graphic - Identifier of the spritesheet to use.\n   * @param animationName - Name of the animation inside the spritesheet.\n   * @returns A promise resolved when the animation component calls `onFinish`.\n   */\n  showAnimation(graphic: string, animationName: string = 'default'): Promise<void> {\n    return this.showComponentAnimation('animation', {\n      graphic,\n      animationName,\n    });\n  }\n  \n  /**\n   * Check whether this client object represents an event.\n   *\n   * @returns `true` if the object type is `event`, otherwise `false`.\n   */\n  isEvent(): boolean {\n    return this._type === 'event';\n  }\n\n  /**\n   * Check whether this client object represents a player.\n   *\n   * @returns `true` if the object type is `player`, otherwise `false`.\n   */\n  isPlayer(): boolean {\n    return this._type === 'player';\n  }\n}\n"],"mappings":"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"}

package/dist/Gui/Gui.d.ts

@@ -1,6 +1,6 @@
-import { Context } from '@signe/di';
 import { Signal, WritableSignal } from 'canvasengine';
 import { Subscription } from 'rxjs';
+import { RpgContext } from '@rpgjs/common';
 interface GuiOptions {
     name?: string;
     id?: string;
@@ -60,7 +60,7 @@ export declare class RpgGui {
      * Key: player ID, Value: boolean (true = show, false = hide)
      */
     attachedGuiDisplayState: import('canvasengine').WritableObjectSignal<Record<string, boolean>>;
-    constructor(context: Context);
+    constructor(context: RpgContext);
     _initialize(): Promise<void>;
     /**
      * Set the VueGui instance reference for Vue component management

package/dist/Gui/Gui.js.map

@@ -1 +1 @@
-{"version":3,"file":"Gui.js","names":[],"sources":["../../src/Gui/Gui.ts"],"sourcesContent":["import { Context, inject } from \"@signe/di\";\nimport { signal, Signal, WritableSignal } from \"canvasengine\";\nimport { AbstractWebsocket, WebSocketToken } from \"../services/AbstractSocket\";\nimport { DialogboxComponent, ShopComponent, SaveLoadComponent, MainMenuComponent, NotificationComponent, TitleScreenComponent, GameoverComponent, InputComponent } from \"../components/gui\";\nimport { combineLatest, Subscription } from \"rxjs\";\nimport { PrebuiltGui } from \"@rpgjs/common\";\n\ninterface GuiOptions {\n  name?: string;\n  id?: string;\n  component?: any;\n  display?: boolean;\n  data?: any;\n  /**\n   * Auto display the GUI when added to the system\n   * @default false\n   */\n  autoDisplay?: boolean;\n  /**\n   * Function that returns an array of Signal dependencies\n   * The GUI will only display when all dependencies are resolved (!= undefined)\n   * @returns Array of Signal dependencies\n   */\n  dependencies?: () => Signal[];\n  /**\n   * Attach the GUI to sprites instead of displaying globally\n   * When true, the GUI will be rendered in character.ce for each sprite\n   * @default false\n   */\n  attachToSprite?: boolean;\n  /**\n   * Vue v4 compatibility flag. Prefer attachToSprite in v5 projects.\n   */\n  rpgAttachToSprite?: boolean;\n}\n\nexport interface GuiInstance {\n  name: string;\n  component: any;\n  display: WritableSignal<boolean>;\n  data: WritableSignal<any>;\n  openId?: string;\n  autoDisplay: boolean;\n  dependencies?: Signal[];\n  subscription?: Subscription;\n  attachToSprite?: boolean;\n}\n\ntype GuiState = {\n  name: string;\n  component: any;\n  display: boolean;\n  data: any;\n  openId?: string;\n  attachToSprite: boolean;\n};\n\ntype VueGuiBridge = {\n  updateGuiState?: (state: GuiState) => void;\n  initializeGuiStates?: (states: GuiState[]) => void;\n};\n\ninterface GuiAction {\n  guiId: string;\n  name: string;\n  data: any;\n  clientActionId: string;\n}\n\ntype OptimisticReducer = (data: any, action: GuiAction) => any;\n\nconst throwError = (id: string) => {\n  throw `The GUI named ${id} is non-existent. Please add the component in the gui property of the decorator @RpgClient`;\n};\n\nconst updateItemQuantity = (items: any[], id: string) => {\n  const index = items.findIndex((item) => item?.id === id);\n  if (index === -1) return items;\n  const item = items[index];\n  if (item?.usable === false) return items;\n  if (item?.consumable === false) return items;\n  const quantity = typeof item?.quantity === \"number\" ? item.quantity : 1;\n  const nextQuantity = Math.max(0, quantity - 1);\n  if (nextQuantity === quantity) return items;\n  if (nextQuantity <= 0) {\n    return items.filter((_, idx) => idx !== index);\n  }\n  const nextItems = items.slice();\n  nextItems[index] = { ...item, quantity: nextQuantity };\n  return nextItems;\n};\n\nconst updateEquippedFlag = (items: any[], id: string, equip: boolean) => {\n  const index = items.findIndex((item) => item?.id === id);\n  if (index === -1) return items;\n  const item = items[index];\n  if (item?.equipped === equip) return items;\n  const nextItems = items.slice();\n  nextItems[index] = { ...item, equipped: equip };\n  return nextItems;\n};\n\nconst mainMenuOptimisticReducer: OptimisticReducer = (data, action) => {\n  if (!data || typeof data !== \"object\") return data;\n  if (action.name === \"useItem\") {\n    if (!Array.isArray(data.items)) return data;\n    const id = action.data?.id;\n    if (!id) return data;\n    const nextItems = updateItemQuantity(data.items, id);\n    if (nextItems === data.items) return data;\n    return { ...data, items: nextItems };\n  }\n  if (action.name === \"equipItem\") {\n    const id = action.data?.id;\n    if (!id || typeof action.data?.equip !== \"boolean\") return data;\n    const equip = action.data.equip;\n    let nextItems = data.items;\n    let nextEquips = data.equips;\n    if (Array.isArray(data.items)) {\n      nextItems = updateEquippedFlag(data.items, id, equip);\n    }\n    if (Array.isArray(data.equips)) {\n      nextEquips = updateEquippedFlag(data.equips, id, equip);\n    }\n    if (nextItems === data.items && nextEquips === data.equips) return data;\n    return {\n      ...data,\n      ...(nextItems !== data.items ? { items: nextItems } : {}),\n      ...(nextEquips !== data.equips ? { equips: nextEquips } : {})\n    };\n  }\n  return data;\n};\n\nexport class RpgGui {\n  private webSocket: AbstractWebsocket;\n  gui = signal<Record<string, GuiInstance>>({});\n  extraGuis: GuiInstance[] = [];\n  private vueGuiInstance: VueGuiBridge | null = null;\n  private optimisticReducers = new Map<string, OptimisticReducer[]>();\n  private pendingActions = new Map<string, GuiAction[]>();\n  /**\n   * Signal tracking which player IDs should display attached GUIs\n   * Key: player ID, Value: boolean (true = show, false = hide)\n   */\n  attachedGuiDisplayState = signal<Record<string, boolean>>({});\n\n  constructor(private context: Context) {\n    this.webSocket = inject(context, WebSocketToken);\n    this.add({\n      name: \"rpg-dialog\",\n      component: DialogboxComponent,\n    });\n    this.add({\n      name: PrebuiltGui.MainMenu,\n      component: MainMenuComponent,\n    });\n    this.add({\n      name: PrebuiltGui.Shop,\n      component: ShopComponent,\n    });\n    this.add({\n      name: PrebuiltGui.Notification,\n      component: NotificationComponent,\n      autoDisplay: true,\n    });\n    this.add({\n      name: PrebuiltGui.Save,\n      component: SaveLoadComponent,\n    });\n    this.add({\n      name: PrebuiltGui.TitleScreen,\n      component: TitleScreenComponent,\n    });\n    this.add({\n      name: PrebuiltGui.Gameover,\n      component: GameoverComponent,\n    });\n    this.add({\n      name: PrebuiltGui.Input,\n      component: InputComponent,\n    });\n\n    this.registerOptimisticReducer(PrebuiltGui.MainMenu, mainMenuOptimisticReducer);\n  }\n\n  async _initialize() {\n    this.webSocket.on(\"gui.open\", (data: { guiId: string; data: any; guiOpenId?: string }) => {\n      this.clearPendingActions(data.guiId);\n      this.display(data.guiId, data.data, [], data.guiOpenId);\n    });\n\n    this.webSocket.on(\"gui.exit\", (payload: string | { guiId: string; guiOpenId?: string }) => {\n      const guiId = typeof payload === \"string\" ? payload : payload.guiId;\n      const guiOpenId = typeof payload === \"string\" ? undefined : payload.guiOpenId;\n      const current = this.get(guiId);\n      if (guiOpenId && current?.openId && current.openId !== guiOpenId) {\n        return;\n      }\n      this.hide(guiId);\n    });\n\n    this.webSocket.on(\"gui.update\", (payload: { guiId: string; data: any; clientActionId?: string }) => {\n      this.applyServerUpdate(payload.guiId, payload.data, payload.clientActionId);\n    });\n\n    /**\n     * Listen for tooltip display state changes from server\n     * This is triggered by showAttachedGui/hideAttachedGui on the server\n     */\n    this.webSocket.on(\"gui.tooltip\", (data: { players: string[]; display: boolean }) => {\n      const currentState = { ...this.attachedGuiDisplayState() };\n      data.players.forEach((playerId) => {\n        currentState[playerId] = data.display;\n      });\n      this.attachedGuiDisplayState.set(currentState);\n    });\n  }\n\n  /**\n   * Set the VueGui instance reference for Vue component management\n   * This is called by VueGui when it's initialized\n   * \n   * @param vueGuiInstance - The VueGui instance\n   */\n  _setVueGuiInstance(vueGuiInstance: any) {\n    this.vueGuiInstance = vueGuiInstance;\n    this._initializeVueComponents();\n  }\n\n  /**\n   * Notify VueGui about GUI state changes\n   * This synchronizes the Vue component display state\n   * \n   * @param guiId - The GUI component ID\n   * @param display - Display state\n   * @param data - Component data\n   */\n  private _notifyVueGui(guiId: string, display: boolean, data: any = {}) {\n    const extraGui = this.extraGuis.find(gui => gui.name === guiId);\n    if (!extraGui) return;\n    this.vueGuiInstance?.updateGuiState?.(this.toGuiState(extraGui, display, data));\n  }\n\n  /**\n   * Initialize Vue components in the VueGui instance\n   * This should be called after VueGui is mounted\n   */\n  _initializeVueComponents() {\n    this.vueGuiInstance?.initializeGuiStates?.(\n      this.extraGuis.map(gui => this.toGuiState(gui))\n    );\n  }\n\n  guiInteraction(guiId: string, name: string, data: any) {\n    const clientActionId = globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random()}`;\n    const actionData = { ...(data || {}), clientActionId };\n    this.applyOptimisticAction({\n      guiId,\n      name,\n      data: actionData,\n      clientActionId\n    });\n    this.webSocket.emit(\"gui.interaction\", {\n      guiId,\n      name,\n      data: actionData,\n    });\n  }\n\n  guiClose(guiId: string, data?: any, guiOpenId?: unknown) {\n    const normalizedOpenId =\n      typeof guiOpenId === \"string\" && guiOpenId.length > 0 ? guiOpenId : undefined;\n    this.webSocket.emit(\"gui.exit\", {\n      guiId,\n      guiOpenId: normalizedOpenId,\n      data,\n    });\n  }\n\n  /**\n   * Add a GUI component to the system\n   * \n   * By default, only CanvasEngine components (.ce files) are accepted.\n   * Vue components should be handled by the @rpgjs/vue package.\n   * \n   * @param gui - GUI configuration options\n   * @param gui.name - Name or ID of the GUI component\n   * @param gui.id - Alternative ID if name is not provided\n   * @param gui.component - The component to render (must be a CanvasEngine component)\n   * @param gui.display - Initial display state (default: false)\n   * @param gui.data - Initial data for the component\n   * @param gui.autoDisplay - Auto display when added (default: false)\n   * @param gui.dependencies - Function returning Signal dependencies\n   * @param gui.attachToSprite - Attach GUI to sprites instead of global display (default: false)\n   * \n   * @example\n   * ```ts\n   * gui.add({\n   *   name: 'inventory',\n   *   component: InventoryComponent, // Must be a .ce component\n   *   autoDisplay: true,\n   *   dependencies: () => [playerSignal, inventorySignal]\n   * });\n   * \n   * // Attach to sprites\n   * gui.add({\n   *   name: 'tooltip',\n   *   component: TooltipComponent,\n   *   attachToSprite: true\n   * });\n   * ```\n   */\n  add(gui: GuiOptions | any) {\n    const component = this.resolveComponent(gui);\n    const guiId = this.resolveGuiId(gui, component);\n    if (!guiId) {\n      throw new Error(\"GUI must have a name or id\");\n    }\n    const attachToSprite = this.resolveAttachToSprite(gui, component);\n    const guiInstance: GuiInstance = {\n      name: guiId,\n      component,\n      display: signal<boolean>(gui.display || false),\n      data: signal<any>(gui.data || {}),\n      openId: undefined,\n      autoDisplay: gui.autoDisplay || false,\n      dependencies: gui.dependencies ? gui.dependencies() : [],\n      attachToSprite,\n    };\n\n    if (this.isVueComponentInstance(guiInstance)) {\n      this.removeCanvasGui(guiId);\n      const existingIndex = this.extraGuis.findIndex(existing => existing.name === guiId);\n      if (existingIndex >= 0) {\n        this.extraGuis[existingIndex].subscription?.unsubscribe();\n        this.extraGuis[existingIndex] = guiInstance;\n      } else {\n        this.extraGuis.push(guiInstance);\n      }\n\n      this._initializeVueComponents();\n      \n      if (guiInstance.autoDisplay) {\n        this.display(guiId, gui.data);\n      } else {\n        this._notifyVueGui(guiId, guiInstance.display(), guiInstance.data());\n      }\n      return;\n    }\n\n    this.removeVueGui(guiId);\n    this.gui()[guiId] = guiInstance;\n    this._initializeVueComponents();\n\n    // Auto display if enabled and it's a CanvasEngine component\n    if (guiInstance.autoDisplay && typeof gui.component === 'function') {\n      this.display(guiId, gui.data);\n    }\n  }\n\n  registerOptimisticReducer(guiId: string, reducer: OptimisticReducer) {\n    const existing = this.optimisticReducers.get(guiId) || [];\n    this.optimisticReducers.set(guiId, existing.concat(reducer));\n  }\n\n  /**\n   * Get all attached GUI components (attachToSprite: true)\n   * \n   * Returns all GUI instances that are configured to be attached to sprites.\n   * These GUIs should be rendered in character.ce instead of canvas.ce.\n   * \n   * @returns Array of GUI instances with attachToSprite: true\n   * \n   * @example\n   * ```ts\n   * const attachedGuis = gui.getAttachedGuis();\n   * // Use in character.ce to render tooltips\n   * ```\n   */\n  getAttachedGuis(): GuiInstance[] {\n    return Object.values(this.gui()).filter(gui => gui.attachToSprite === true);\n  }\n\n  getVueGuis(): GuiInstance[] {\n    return [...this.extraGuis];\n  }\n\n  getAttachedVueGuis(): GuiInstance[] {\n    return this.extraGuis.filter(gui => gui.attachToSprite === true);\n  }\n\n  /**\n   * Check if a player should display attached GUIs\n   * \n   * @param playerId - The player ID to check\n   * @returns true if attached GUIs should be displayed for this player\n   */\n  shouldDisplayAttachedGui(playerId: string): boolean {\n    return this.attachedGuiDisplayState()[playerId] === true;\n  }\n\n  get(id: string): GuiInstance | undefined {\n    // Check CanvasEngine GUIs first\n    const canvasGui = this.gui()[id];\n    if (canvasGui) {\n      return canvasGui;\n    }\n    \n    // Check Vue GUIs in extraGuis\n    return this.extraGuis.find(gui => gui.name === id);\n  }\n\n  exists(id: string): boolean {\n    return !!this.get(id);\n  }\n\n  getAll(): Record<string, GuiInstance> {\n    const allGuis = { ...this.gui() };\n    \n    // Add extraGuis to the result\n    this.extraGuis.forEach(gui => {\n      allGuis[gui.name] = gui;\n    });\n    \n    return allGuis;\n  }\n\n  /**\n   * Display a GUI component\n   * \n   * Displays the GUI immediately if no dependencies are configured,\n   * or waits for all dependencies to be resolved if dependencies are present.\n   * Automatically manages subscriptions to prevent memory leaks.\n   * Works with both CanvasEngine components and Vue components.\n   * \n   * @param id - The GUI component ID\n   * @param data - Data to pass to the component\n   * @param dependencies - Optional runtime dependencies (overrides config dependencies)\n   * \n   * @example\n   * ```ts\n   * // Display immediately\n   * gui.display('inventory', { items: [] });\n   * \n   * // Display with runtime dependencies\n   * gui.display('shop', { shopId: 1 }, [playerSignal, shopSignal]);\n   * ```\n   */\n  display(id: string, data = {}, dependencies: Signal[] = [], openId?: string) {\n    if (!this.exists(id)) {\n      throw throwError(id);\n    }\n\n    const guiInstance = this.get(id)!;\n    const isVueComponent = this.extraGuis.some(gui => gui.name === id);\n\n    if (guiInstance.subscription) {\n      guiInstance.subscription.unsubscribe();\n      guiInstance.subscription = undefined;\n    }\n\n    const show = () => {\n      guiInstance.openId = openId;\n      guiInstance.data.set(data);\n      guiInstance.display.set(true);\n      if (isVueComponent) {\n        this._notifyVueGui(id, true, data);\n      }\n    };\n\n    const deps = dependencies.length > 0\n      ? dependencies\n      : (guiInstance.dependencies ?? []);\n\n    if (deps.length > 0) {\n      const values = deps.map(dependency => dependency());\n      const subscription = new Subscription();\n      const showIfReady = () => {\n        if (values.every(value => value !== undefined)) {\n          show();\n        }\n      };\n\n      deps.forEach((dependency, index) => {\n        subscription.add(dependency.observable.subscribe((value) => {\n          values[index] = value;\n          showIfReady();\n        }));\n      });\n\n      guiInstance.subscription = subscription;\n      showIfReady();\n      return;\n    }\n\n    show();\n  }\n\n  isDisplaying(id: string): boolean {\n    const guiInstance = this.get(id);\n    if (!guiInstance) return false;\n    return guiInstance.display();\n  }\n\n  /**\n   * Handle Vue component display logic\n   * \n   * @param id - GUI component ID\n   * @param data - Component data\n   * @param dependencies - Runtime dependencies\n   * @param guiInstance - GUI instance\n   */\n  private _handleVueComponentDisplay(id: string, data: any, dependencies: Signal[], guiInstance: GuiInstance, openId?: string) {\n    // Unsubscribe from previous subscription if exists\n    if (guiInstance.subscription) {\n      guiInstance.subscription.unsubscribe();\n      guiInstance.subscription = undefined;\n    }\n\n    // Use runtime dependencies or config dependencies\n    const deps = dependencies.length > 0 \n      ? dependencies \n      : (guiInstance.dependencies ?? []);\n\n    if (deps.length > 0) {\n      const values = deps.map(dependency => dependency());\n      const subscription = new Subscription();\n      const showIfReady = () => {\n        if (values.every(value => value !== undefined)) {\n          guiInstance.openId = openId;\n          guiInstance.data.set(data);\n          guiInstance.display.set(true);\n          this._notifyVueGui(id, true, data);\n        }\n      };\n\n      deps.forEach((dependency, index) => {\n        subscription.add(dependency.observable.subscribe((value) => {\n          values[index] = value;\n          showIfReady();\n        }));\n      });\n\n      guiInstance.subscription = subscription;\n      showIfReady();\n      return;\n    }\n\n    // No dependencies, display immediately\n    guiInstance.openId = openId;\n    guiInstance.data.set(data);\n    guiInstance.display.set(true);\n    this._notifyVueGui(id, true, data);\n  }\n\n  /**\n   * Hide a GUI component\n   * \n   * Hides the GUI and cleans up any active subscriptions.\n   * Works with both CanvasEngine components and Vue components.\n   * \n   * @param id - The GUI component ID\n   * \n   * @example\n   * ```ts\n   * gui.hide('inventory');\n   * ```\n   */\n  hide(id: string) {\n    if (!this.exists(id)) {\n      throw throwError(id);\n    }\n\n    const guiInstance = this.get(id)!;\n    \n    // Unsubscribe if there's an active subscription\n    if (guiInstance.subscription) {\n      guiInstance.subscription.unsubscribe();\n      guiInstance.subscription = undefined;\n    }\n\n    guiInstance.display.set(false)\n    guiInstance.openId = undefined;\n    \n    // Check if it's a Vue component and notify VueGui\n    const isVueComponent = this.extraGuis.some(gui => gui.name === id);\n    if (isVueComponent) {\n      this._notifyVueGui(id, false);\n    }\n  }\n\n  private isVueComponent(id: string) {\n    return this.extraGuis.some(gui => gui.name === id);\n  }\n\n  private isVueComponentInstance(gui: GuiInstance) {\n    return typeof gui.component !== \"function\";\n  }\n\n  private removeCanvasGui(guiId: string) {\n    const current = this.gui();\n    if (!(guiId in current)) return;\n    const next = { ...current };\n    delete next[guiId];\n    this.gui.set(next);\n  }\n\n  private removeVueGui(guiId: string) {\n    const removed = this.extraGuis.filter(existing => existing.name === guiId);\n    removed.forEach(gui => gui.subscription?.unsubscribe());\n    if (removed.length > 0) {\n      this.extraGuis = this.extraGuis.filter(existing => existing.name !== guiId);\n    }\n  }\n\n  private resolveComponent(gui: GuiOptions | any) {\n    return gui?.component ?? gui;\n  }\n\n  private resolveGuiId(gui: GuiOptions | any, component: any) {\n    return gui?.name || gui?.id || component?.name || component?.__name;\n  }\n\n  private resolveAttachToSprite(gui: GuiOptions | any, component: any) {\n    return !!(gui?.attachToSprite || gui?.rpgAttachToSprite || component?.attachToSprite || component?.rpgAttachToSprite);\n  }\n\n  private toGuiState(gui: GuiInstance, display = gui.display(), data = gui.data()): GuiState {\n    return {\n      name: gui.name,\n      component: gui.component,\n      display,\n      data,\n      openId: gui.openId,\n      attachToSprite: gui.attachToSprite || false,\n    };\n  }\n\n  private clearPendingActions(guiId: string) {\n    this.pendingActions.delete(guiId);\n  }\n\n  private applyReducers(guiId: string, data: any, actions: GuiAction[]) {\n    const reducers = this.optimisticReducers.get(guiId);\n    if (!reducers || reducers.length === 0) return data;\n    let next = data;\n    for (const action of actions) {\n      for (const reducer of reducers) {\n        const updated = reducer(next, action);\n        if (updated !== undefined && updated !== null && updated !== next) {\n          next = updated;\n        }\n      }\n    }\n    return next;\n  }\n\n  private applyOptimisticAction(action: GuiAction) {\n    const guiInstance = this.get(action.guiId);\n    if (!guiInstance) return;\n    const reducers = this.optimisticReducers.get(action.guiId);\n    if (!reducers || reducers.length === 0) return;\n    const currentData = guiInstance.data();\n    const nextData = this.applyReducers(action.guiId, currentData, [action]);\n    if (nextData === currentData) return;\n    guiInstance.data.set(nextData);\n    const pending = this.pendingActions.get(action.guiId) || [];\n    pending.push(action);\n    this.pendingActions.set(action.guiId, pending);\n    if (this.isVueComponent(action.guiId)) {\n      this._notifyVueGui(action.guiId, guiInstance.display(), nextData);\n    }\n  }\n\n  private applyServerUpdate(guiId: string, data: any, clientActionId?: string) {\n    const guiInstance = this.get(guiId);\n    if (!guiInstance) return;\n    let pending = this.pendingActions.get(guiId) || [];\n    if (clientActionId) {\n      pending = pending.filter(action => action.clientActionId !== clientActionId);\n    } else {\n      pending = [];\n    }\n    let nextData = data;\n    if (pending.length) {\n      nextData = this.applyReducers(guiId, nextData, pending);\n    }\n    guiInstance.data.set(nextData);\n    this.pendingActions.set(guiId, pending);\n    if (this.isVueComponent(guiId)) {\n      this._notifyVueGui(guiId, guiInstance.display(), nextData);\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"Gui.js","names":[],"sources":["../../src/Gui/Gui.ts"],"sourcesContent":["import { Context, inject } from \"@signe/di\";\nimport { signal, Signal, WritableSignal } from \"canvasengine\";\nimport { AbstractWebsocket, WebSocketToken } from \"../services/AbstractSocket\";\nimport { DialogboxComponent, ShopComponent, SaveLoadComponent, MainMenuComponent, NotificationComponent, TitleScreenComponent, GameoverComponent, InputComponent } from \"../components/gui\";\nimport { combineLatest, Subscription } from \"rxjs\";\nimport { PrebuiltGui, type RpgContext } from \"@rpgjs/common\";\n\ninterface GuiOptions {\n  name?: string;\n  id?: string;\n  component?: any;\n  display?: boolean;\n  data?: any;\n  /**\n   * Auto display the GUI when added to the system\n   * @default false\n   */\n  autoDisplay?: boolean;\n  /**\n   * Function that returns an array of Signal dependencies\n   * The GUI will only display when all dependencies are resolved (!= undefined)\n   * @returns Array of Signal dependencies\n   */\n  dependencies?: () => Signal[];\n  /**\n   * Attach the GUI to sprites instead of displaying globally\n   * When true, the GUI will be rendered in character.ce for each sprite\n   * @default false\n   */\n  attachToSprite?: boolean;\n  /**\n   * Vue v4 compatibility flag. Prefer attachToSprite in v5 projects.\n   */\n  rpgAttachToSprite?: boolean;\n}\n\nexport interface GuiInstance {\n  name: string;\n  component: any;\n  display: WritableSignal<boolean>;\n  data: WritableSignal<any>;\n  openId?: string;\n  autoDisplay: boolean;\n  dependencies?: Signal[];\n  subscription?: Subscription;\n  attachToSprite?: boolean;\n}\n\ntype GuiState = {\n  name: string;\n  component: any;\n  display: boolean;\n  data: any;\n  openId?: string;\n  attachToSprite: boolean;\n};\n\ntype VueGuiBridge = {\n  updateGuiState?: (state: GuiState) => void;\n  initializeGuiStates?: (states: GuiState[]) => void;\n};\n\ninterface GuiAction {\n  guiId: string;\n  name: string;\n  data: any;\n  clientActionId: string;\n}\n\ntype OptimisticReducer = (data: any, action: GuiAction) => any;\n\nconst throwError = (id: string) => {\n  throw `The GUI named ${id} is non-existent. Please add the component in the gui property of the decorator @RpgClient`;\n};\n\nconst updateItemQuantity = (items: any[], id: string) => {\n  const index = items.findIndex((item) => item?.id === id);\n  if (index === -1) return items;\n  const item = items[index];\n  if (item?.usable === false) return items;\n  if (item?.consumable === false) return items;\n  const quantity = typeof item?.quantity === \"number\" ? item.quantity : 1;\n  const nextQuantity = Math.max(0, quantity - 1);\n  if (nextQuantity === quantity) return items;\n  if (nextQuantity <= 0) {\n    return items.filter((_, idx) => idx !== index);\n  }\n  const nextItems = items.slice();\n  nextItems[index] = { ...item, quantity: nextQuantity };\n  return nextItems;\n};\n\nconst updateEquippedFlag = (items: any[], id: string, equip: boolean) => {\n  const index = items.findIndex((item) => item?.id === id);\n  if (index === -1) return items;\n  const item = items[index];\n  if (item?.equipped === equip) return items;\n  const nextItems = items.slice();\n  nextItems[index] = { ...item, equipped: equip };\n  return nextItems;\n};\n\nconst mainMenuOptimisticReducer: OptimisticReducer = (data, action) => {\n  if (!data || typeof data !== \"object\") return data;\n  if (action.name === \"useItem\") {\n    if (!Array.isArray(data.items)) return data;\n    const id = action.data?.id;\n    if (!id) return data;\n    const nextItems = updateItemQuantity(data.items, id);\n    if (nextItems === data.items) return data;\n    return { ...data, items: nextItems };\n  }\n  if (action.name === \"equipItem\") {\n    const id = action.data?.id;\n    if (!id || typeof action.data?.equip !== \"boolean\") return data;\n    const equip = action.data.equip;\n    let nextItems = data.items;\n    let nextEquips = data.equips;\n    if (Array.isArray(data.items)) {\n      nextItems = updateEquippedFlag(data.items, id, equip);\n    }\n    if (Array.isArray(data.equips)) {\n      nextEquips = updateEquippedFlag(data.equips, id, equip);\n    }\n    if (nextItems === data.items && nextEquips === data.equips) return data;\n    return {\n      ...data,\n      ...(nextItems !== data.items ? { items: nextItems } : {}),\n      ...(nextEquips !== data.equips ? { equips: nextEquips } : {})\n    };\n  }\n  return data;\n};\n\nexport class RpgGui {\n  private webSocket: AbstractWebsocket;\n  gui = signal<Record<string, GuiInstance>>({});\n  extraGuis: GuiInstance[] = [];\n  private vueGuiInstance: VueGuiBridge | null = null;\n  private optimisticReducers = new Map<string, OptimisticReducer[]>();\n  private pendingActions = new Map<string, GuiAction[]>();\n  /**\n   * Signal tracking which player IDs should display attached GUIs\n   * Key: player ID, Value: boolean (true = show, false = hide)\n   */\n  attachedGuiDisplayState = signal<Record<string, boolean>>({});\n\n  constructor(private context: RpgContext) {\n    this.webSocket = inject(context as Context, WebSocketToken);\n    this.add({\n      name: \"rpg-dialog\",\n      component: DialogboxComponent,\n    });\n    this.add({\n      name: PrebuiltGui.MainMenu,\n      component: MainMenuComponent,\n    });\n    this.add({\n      name: PrebuiltGui.Shop,\n      component: ShopComponent,\n    });\n    this.add({\n      name: PrebuiltGui.Notification,\n      component: NotificationComponent,\n      autoDisplay: true,\n    });\n    this.add({\n      name: PrebuiltGui.Save,\n      component: SaveLoadComponent,\n    });\n    this.add({\n      name: PrebuiltGui.TitleScreen,\n      component: TitleScreenComponent,\n    });\n    this.add({\n      name: PrebuiltGui.Gameover,\n      component: GameoverComponent,\n    });\n    this.add({\n      name: PrebuiltGui.Input,\n      component: InputComponent,\n    });\n\n    this.registerOptimisticReducer(PrebuiltGui.MainMenu, mainMenuOptimisticReducer);\n  }\n\n  async _initialize() {\n    this.webSocket.on(\"gui.open\", (data: { guiId: string; data: any; guiOpenId?: string }) => {\n      this.clearPendingActions(data.guiId);\n      this.display(data.guiId, data.data, [], data.guiOpenId);\n    });\n\n    this.webSocket.on(\"gui.exit\", (payload: string | { guiId: string; guiOpenId?: string }) => {\n      const guiId = typeof payload === \"string\" ? payload : payload.guiId;\n      const guiOpenId = typeof payload === \"string\" ? undefined : payload.guiOpenId;\n      const current = this.get(guiId);\n      if (guiOpenId && current?.openId && current.openId !== guiOpenId) {\n        return;\n      }\n      this.hide(guiId);\n    });\n\n    this.webSocket.on(\"gui.update\", (payload: { guiId: string; data: any; clientActionId?: string }) => {\n      this.applyServerUpdate(payload.guiId, payload.data, payload.clientActionId);\n    });\n\n    /**\n     * Listen for tooltip display state changes from server\n     * This is triggered by showAttachedGui/hideAttachedGui on the server\n     */\n    this.webSocket.on(\"gui.tooltip\", (data: { players: string[]; display: boolean }) => {\n      const currentState = { ...this.attachedGuiDisplayState() };\n      data.players.forEach((playerId) => {\n        currentState[playerId] = data.display;\n      });\n      this.attachedGuiDisplayState.set(currentState);\n    });\n  }\n\n  /**\n   * Set the VueGui instance reference for Vue component management\n   * This is called by VueGui when it's initialized\n   * \n   * @param vueGuiInstance - The VueGui instance\n   */\n  _setVueGuiInstance(vueGuiInstance: any) {\n    this.vueGuiInstance = vueGuiInstance;\n    this._initializeVueComponents();\n  }\n\n  /**\n   * Notify VueGui about GUI state changes\n   * This synchronizes the Vue component display state\n   * \n   * @param guiId - The GUI component ID\n   * @param display - Display state\n   * @param data - Component data\n   */\n  private _notifyVueGui(guiId: string, display: boolean, data: any = {}) {\n    const extraGui = this.extraGuis.find(gui => gui.name === guiId);\n    if (!extraGui) return;\n    this.vueGuiInstance?.updateGuiState?.(this.toGuiState(extraGui, display, data));\n  }\n\n  /**\n   * Initialize Vue components in the VueGui instance\n   * This should be called after VueGui is mounted\n   */\n  _initializeVueComponents() {\n    this.vueGuiInstance?.initializeGuiStates?.(\n      this.extraGuis.map(gui => this.toGuiState(gui))\n    );\n  }\n\n  guiInteraction(guiId: string, name: string, data: any) {\n    const clientActionId = globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random()}`;\n    const actionData = { ...(data || {}), clientActionId };\n    this.applyOptimisticAction({\n      guiId,\n      name,\n      data: actionData,\n      clientActionId\n    });\n    this.webSocket.emit(\"gui.interaction\", {\n      guiId,\n      name,\n      data: actionData,\n    });\n  }\n\n  guiClose(guiId: string, data?: any, guiOpenId?: unknown) {\n    const normalizedOpenId =\n      typeof guiOpenId === \"string\" && guiOpenId.length > 0 ? guiOpenId : undefined;\n    this.webSocket.emit(\"gui.exit\", {\n      guiId,\n      guiOpenId: normalizedOpenId,\n      data,\n    });\n  }\n\n  /**\n   * Add a GUI component to the system\n   * \n   * By default, only CanvasEngine components (.ce files) are accepted.\n   * Vue components should be handled by the @rpgjs/vue package.\n   * \n   * @param gui - GUI configuration options\n   * @param gui.name - Name or ID of the GUI component\n   * @param gui.id - Alternative ID if name is not provided\n   * @param gui.component - The component to render (must be a CanvasEngine component)\n   * @param gui.display - Initial display state (default: false)\n   * @param gui.data - Initial data for the component\n   * @param gui.autoDisplay - Auto display when added (default: false)\n   * @param gui.dependencies - Function returning Signal dependencies\n   * @param gui.attachToSprite - Attach GUI to sprites instead of global display (default: false)\n   * \n   * @example\n   * ```ts\n   * gui.add({\n   *   name: 'inventory',\n   *   component: InventoryComponent, // Must be a .ce component\n   *   autoDisplay: true,\n   *   dependencies: () => [playerSignal, inventorySignal]\n   * });\n   * \n   * // Attach to sprites\n   * gui.add({\n   *   name: 'tooltip',\n   *   component: TooltipComponent,\n   *   attachToSprite: true\n   * });\n   * ```\n   */\n  add(gui: GuiOptions | any) {\n    const component = this.resolveComponent(gui);\n    const guiId = this.resolveGuiId(gui, component);\n    if (!guiId) {\n      throw new Error(\"GUI must have a name or id\");\n    }\n    const attachToSprite = this.resolveAttachToSprite(gui, component);\n    const guiInstance: GuiInstance = {\n      name: guiId,\n      component,\n      display: signal<boolean>(gui.display || false),\n      data: signal<any>(gui.data || {}),\n      openId: undefined,\n      autoDisplay: gui.autoDisplay || false,\n      dependencies: gui.dependencies ? gui.dependencies() : [],\n      attachToSprite,\n    };\n\n    if (this.isVueComponentInstance(guiInstance)) {\n      this.removeCanvasGui(guiId);\n      const existingIndex = this.extraGuis.findIndex(existing => existing.name === guiId);\n      if (existingIndex >= 0) {\n        this.extraGuis[existingIndex].subscription?.unsubscribe();\n        this.extraGuis[existingIndex] = guiInstance;\n      } else {\n        this.extraGuis.push(guiInstance);\n      }\n\n      this._initializeVueComponents();\n      \n      if (guiInstance.autoDisplay) {\n        this.display(guiId, gui.data);\n      } else {\n        this._notifyVueGui(guiId, guiInstance.display(), guiInstance.data());\n      }\n      return;\n    }\n\n    this.removeVueGui(guiId);\n    this.gui()[guiId] = guiInstance;\n    this._initializeVueComponents();\n\n    // Auto display if enabled and it's a CanvasEngine component\n    if (guiInstance.autoDisplay && typeof gui.component === 'function') {\n      this.display(guiId, gui.data);\n    }\n  }\n\n  registerOptimisticReducer(guiId: string, reducer: OptimisticReducer) {\n    const existing = this.optimisticReducers.get(guiId) || [];\n    this.optimisticReducers.set(guiId, existing.concat(reducer));\n  }\n\n  /**\n   * Get all attached GUI components (attachToSprite: true)\n   * \n   * Returns all GUI instances that are configured to be attached to sprites.\n   * These GUIs should be rendered in character.ce instead of canvas.ce.\n   * \n   * @returns Array of GUI instances with attachToSprite: true\n   * \n   * @example\n   * ```ts\n   * const attachedGuis = gui.getAttachedGuis();\n   * // Use in character.ce to render tooltips\n   * ```\n   */\n  getAttachedGuis(): GuiInstance[] {\n    return Object.values(this.gui()).filter(gui => gui.attachToSprite === true);\n  }\n\n  getVueGuis(): GuiInstance[] {\n    return [...this.extraGuis];\n  }\n\n  getAttachedVueGuis(): GuiInstance[] {\n    return this.extraGuis.filter(gui => gui.attachToSprite === true);\n  }\n\n  /**\n   * Check if a player should display attached GUIs\n   * \n   * @param playerId - The player ID to check\n   * @returns true if attached GUIs should be displayed for this player\n   */\n  shouldDisplayAttachedGui(playerId: string): boolean {\n    return this.attachedGuiDisplayState()[playerId] === true;\n  }\n\n  get(id: string): GuiInstance | undefined {\n    // Check CanvasEngine GUIs first\n    const canvasGui = this.gui()[id];\n    if (canvasGui) {\n      return canvasGui;\n    }\n    \n    // Check Vue GUIs in extraGuis\n    return this.extraGuis.find(gui => gui.name === id);\n  }\n\n  exists(id: string): boolean {\n    return !!this.get(id);\n  }\n\n  getAll(): Record<string, GuiInstance> {\n    const allGuis = { ...this.gui() };\n    \n    // Add extraGuis to the result\n    this.extraGuis.forEach(gui => {\n      allGuis[gui.name] = gui;\n    });\n    \n    return allGuis;\n  }\n\n  /**\n   * Display a GUI component\n   * \n   * Displays the GUI immediately if no dependencies are configured,\n   * or waits for all dependencies to be resolved if dependencies are present.\n   * Automatically manages subscriptions to prevent memory leaks.\n   * Works with both CanvasEngine components and Vue components.\n   * \n   * @param id - The GUI component ID\n   * @param data - Data to pass to the component\n   * @param dependencies - Optional runtime dependencies (overrides config dependencies)\n   * \n   * @example\n   * ```ts\n   * // Display immediately\n   * gui.display('inventory', { items: [] });\n   * \n   * // Display with runtime dependencies\n   * gui.display('shop', { shopId: 1 }, [playerSignal, shopSignal]);\n   * ```\n   */\n  display(id: string, data = {}, dependencies: Signal[] = [], openId?: string) {\n    if (!this.exists(id)) {\n      throw throwError(id);\n    }\n\n    const guiInstance = this.get(id)!;\n    const isVueComponent = this.extraGuis.some(gui => gui.name === id);\n\n    if (guiInstance.subscription) {\n      guiInstance.subscription.unsubscribe();\n      guiInstance.subscription = undefined;\n    }\n\n    const show = () => {\n      guiInstance.openId = openId;\n      guiInstance.data.set(data);\n      guiInstance.display.set(true);\n      if (isVueComponent) {\n        this._notifyVueGui(id, true, data);\n      }\n    };\n\n    const deps = dependencies.length > 0\n      ? dependencies\n      : (guiInstance.dependencies ?? []);\n\n    if (deps.length > 0) {\n      const values = deps.map(dependency => dependency());\n      const subscription = new Subscription();\n      const showIfReady = () => {\n        if (values.every(value => value !== undefined)) {\n          show();\n        }\n      };\n\n      deps.forEach((dependency, index) => {\n        subscription.add(dependency.observable.subscribe((value) => {\n          values[index] = value;\n          showIfReady();\n        }));\n      });\n\n      guiInstance.subscription = subscription;\n      showIfReady();\n      return;\n    }\n\n    show();\n  }\n\n  isDisplaying(id: string): boolean {\n    const guiInstance = this.get(id);\n    if (!guiInstance) return false;\n    return guiInstance.display();\n  }\n\n  /**\n   * Handle Vue component display logic\n   * \n   * @param id - GUI component ID\n   * @param data - Component data\n   * @param dependencies - Runtime dependencies\n   * @param guiInstance - GUI instance\n   */\n  private _handleVueComponentDisplay(id: string, data: any, dependencies: Signal[], guiInstance: GuiInstance, openId?: string) {\n    // Unsubscribe from previous subscription if exists\n    if (guiInstance.subscription) {\n      guiInstance.subscription.unsubscribe();\n      guiInstance.subscription = undefined;\n    }\n\n    // Use runtime dependencies or config dependencies\n    const deps = dependencies.length > 0 \n      ? dependencies \n      : (guiInstance.dependencies ?? []);\n\n    if (deps.length > 0) {\n      const values = deps.map(dependency => dependency());\n      const subscription = new Subscription();\n      const showIfReady = () => {\n        if (values.every(value => value !== undefined)) {\n          guiInstance.openId = openId;\n          guiInstance.data.set(data);\n          guiInstance.display.set(true);\n          this._notifyVueGui(id, true, data);\n        }\n      };\n\n      deps.forEach((dependency, index) => {\n        subscription.add(dependency.observable.subscribe((value) => {\n          values[index] = value;\n          showIfReady();\n        }));\n      });\n\n      guiInstance.subscription = subscription;\n      showIfReady();\n      return;\n    }\n\n    // No dependencies, display immediately\n    guiInstance.openId = openId;\n    guiInstance.data.set(data);\n    guiInstance.display.set(true);\n    this._notifyVueGui(id, true, data);\n  }\n\n  /**\n   * Hide a GUI component\n   * \n   * Hides the GUI and cleans up any active subscriptions.\n   * Works with both CanvasEngine components and Vue components.\n   * \n   * @param id - The GUI component ID\n   * \n   * @example\n   * ```ts\n   * gui.hide('inventory');\n   * ```\n   */\n  hide(id: string) {\n    if (!this.exists(id)) {\n      throw throwError(id);\n    }\n\n    const guiInstance = this.get(id)!;\n    \n    // Unsubscribe if there's an active subscription\n    if (guiInstance.subscription) {\n      guiInstance.subscription.unsubscribe();\n      guiInstance.subscription = undefined;\n    }\n\n    guiInstance.display.set(false)\n    guiInstance.openId = undefined;\n    \n    // Check if it's a Vue component and notify VueGui\n    const isVueComponent = this.extraGuis.some(gui => gui.name === id);\n    if (isVueComponent) {\n      this._notifyVueGui(id, false);\n    }\n  }\n\n  private isVueComponent(id: string) {\n    return this.extraGuis.some(gui => gui.name === id);\n  }\n\n  private isVueComponentInstance(gui: GuiInstance) {\n    return typeof gui.component !== \"function\";\n  }\n\n  private removeCanvasGui(guiId: string) {\n    const current = this.gui();\n    if (!(guiId in current)) return;\n    const next = { ...current };\n    delete next[guiId];\n    this.gui.set(next);\n  }\n\n  private removeVueGui(guiId: string) {\n    const removed = this.extraGuis.filter(existing => existing.name === guiId);\n    removed.forEach(gui => gui.subscription?.unsubscribe());\n    if (removed.length > 0) {\n      this.extraGuis = this.extraGuis.filter(existing => existing.name !== guiId);\n    }\n  }\n\n  private resolveComponent(gui: GuiOptions | any) {\n    return gui?.component ?? gui;\n  }\n\n  private resolveGuiId(gui: GuiOptions | any, component: any) {\n    return gui?.name || gui?.id || component?.name || component?.__name;\n  }\n\n  private resolveAttachToSprite(gui: GuiOptions | any, component: any) {\n    return !!(gui?.attachToSprite || gui?.rpgAttachToSprite || component?.attachToSprite || component?.rpgAttachToSprite);\n  }\n\n  private toGuiState(gui: GuiInstance, display = gui.display(), data = gui.data()): GuiState {\n    return {\n      name: gui.name,\n      component: gui.component,\n      display,\n      data,\n      openId: gui.openId,\n      attachToSprite: gui.attachToSprite || false,\n    };\n  }\n\n  private clearPendingActions(guiId: string) {\n    this.pendingActions.delete(guiId);\n  }\n\n  private applyReducers(guiId: string, data: any, actions: GuiAction[]) {\n    const reducers = this.optimisticReducers.get(guiId);\n    if (!reducers || reducers.length === 0) return data;\n    let next = data;\n    for (const action of actions) {\n      for (const reducer of reducers) {\n        const updated = reducer(next, action);\n        if (updated !== undefined && updated !== null && updated !== next) {\n          next = updated;\n        }\n      }\n    }\n    return next;\n  }\n\n  private applyOptimisticAction(action: GuiAction) {\n    const guiInstance = this.get(action.guiId);\n    if (!guiInstance) return;\n    const reducers = this.optimisticReducers.get(action.guiId);\n    if (!reducers || reducers.length === 0) return;\n    const currentData = guiInstance.data();\n    const nextData = this.applyReducers(action.guiId, currentData, [action]);\n    if (nextData === currentData) return;\n    guiInstance.data.set(nextData);\n    const pending = this.pendingActions.get(action.guiId) || [];\n    pending.push(action);\n    this.pendingActions.set(action.guiId, pending);\n    if (this.isVueComponent(action.guiId)) {\n      this._notifyVueGui(action.guiId, guiInstance.display(), nextData);\n    }\n  }\n\n  private applyServerUpdate(guiId: string, data: any, clientActionId?: string) {\n    const guiInstance = this.get(guiId);\n    if (!guiInstance) return;\n    let pending = this.pendingActions.get(guiId) || [];\n    if (clientActionId) {\n      pending = pending.filter(action => action.clientActionId !== clientActionId);\n    } else {\n      pending = [];\n    }\n    let nextData = data;\n    if (pending.length) {\n      nextData = this.applyReducers(guiId, nextData, pending);\n    }\n    guiInstance.data.set(nextData);\n    this.pendingActions.set(guiId, pending);\n    if (this.isVueComponent(guiId)) {\n      this._notifyVueGui(guiId, guiInstance.display(), nextData);\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/RpgClient.d.ts

@@ -230,7 +230,8 @@ export interface RpgSceneHooks<Scene> {
     */
     onRemoveSprite?: (scene: Scene, sprite: RpgComponent) => any;
     /**
-    * Before the scene is loaded
+    * Before the scene is loaded. Async hooks are awaited while the previous
+    * scene is still mounted, allowing transition UI to cover it before teardown.
     *
     * @prop { (scene: RpgScene) => any } [onBeforeLoading]
     * @memberof RpgSceneHooks

package/dist/RpgClientEngine.d.ts

@@ -43,7 +43,40 @@ export declare class RpgClientEngine<T = any> {
     componentAnimations: any[];
     clientVisuals: ClientVisualRegistry;
     projectiles: ProjectileManager;
+    /**
+     * Read the latest pointer position tracked by the client canvas. World
+     * coordinates are suitable for action payloads and map interactions.
+     *
+     * @title pointer
+     * @prop pointer: ClientPointerContext
+     * @memberof RpgClientEngine
+     * @example
+     * ```ts
+     * const target = engine.pointer.world()
+     * if (target) engine.processAction('projectile:shoot', { target })
+     * ```
+     */
     pointer: ClientPointerContext;
+    /**
+     * Register client-only pointer behaviors for map sprites. Interactions remain
+     * local unless a behavior explicitly sends an action to the server.
+     *
+     * See the [client interactions guide](../../guide/interactions.md) for hover,
+     * selection, hit testing, drag-and-drop, overlays, and network rules.
+     *
+     * @title interactions
+     * @prop interactions: RpgClientInteractions
+     * @memberof RpgClientEngine
+     * @example
+     * ```ts
+     * engine.interactions.use('Guard', {
+     *   cursor: 'pointer',
+     *   click(ctx) {
+     *     ctx.action('guard:talk', { eventId: ctx.target.id })
+     *   }
+     * })
+     * ```
+     */
     interactions: RpgClientInteractions;
     private spritesheetResolver?;
     private soundResolver?;
@@ -86,6 +119,8 @@ export declare class RpgClientEngine<T = any> {
     private pingInterval;
     private readonly PING_INTERVAL_MS;
     private lastInputTime;
+    private latestDirectionalInput?;
+    private pendingMapTransferInput?;
     private readonly MOVE_PATH_RESEND_INTERVAL_MS;
     private readonly MAX_MOVE_TRAJECTORY_POINTS;
     private lastMovePathSentAt;
@@ -98,6 +133,7 @@ export declare class RpgClientEngine<T = any> {
     private sceneResetQueued;
     private mapTransitionInProgress;
     private currentMapRoomId?;
+    private activeMapStreamController?;
     private socketListenersInitialized;
     private clientReadyForMapChanges;
     private pendingMapChanges;
@@ -170,6 +206,7 @@ export declare class RpgClientEngine<T = any> {
     private normalizeAckWithSyncState;
     private initListeners;
     private beginMapTransfer;
+    private resetSceneForMapTransfer;
     private clearComponentAnimations;
     private shouldProcessProjectilePacket;
     private callConnectError;
@@ -223,6 +260,7 @@ export declare class RpgClientEngine<T = any> {
      */
     private sendPing;
     private loadScene;
+    private resumeMapTransferMovement;
     addSpriteSheet<T = any>(spritesheetClass: any, id?: string): any;
     /**
      * Set a resolver function for spritesheets
@@ -676,7 +714,44 @@ export declare class RpgClientEngine<T = any> {
     processInput({ input }: {
         input: RpgMovementInput;
     }): Promise<void>;
+    /**
+     * Start a predicted dash for the current player and send it through the
+     * authoritative movement channel.
+     *
+     * @title processDash
+     * @method processDash(input?: Partial<RpgDashInput>): Promise<void>
+     * @param input - Optional direction, speed, duration, and cooldown overrides.
+     * @returns A promise resolved after the dash input has been processed locally.
+     * @memberof RpgClientEngine
+     * @example
+     * ```ts
+     * await engine.processDash({
+     *   direction: { x: 1, y: 0 },
+     *   additionalSpeed: 10,
+     *   duration: 220,
+     *   cooldown: 600,
+     * })
+     * ```
+     */
     processDash(input?: Partial<RpgDashInput>): Promise<void>;
+    /**
+     * Send an action intent to the authoritative server. Client-provided data
+     * must be validated by the receiving player input handler or action.
+     *
+     * @title processAction
+     * @method processAction(action: RpgActionName | RpgActionInput, data?: any): void
+     * @param action - Action name/control value, or a normalized action object.
+     * @param data - Optional serializable context sent with an action name.
+     * @returns Nothing.
+     * @memberof RpgClientEngine
+     * @example
+     * ```ts
+     * engine.processAction('projectile:shoot', {
+     *   target: engine.pointer.world(),
+     *   source: 'map-click',
+     * })
+     * ```
+     */
     processAction(action: RpgActionName, data?: any): void;
     processAction(action: RpgActionInput): void;
     get PIXI(): typeof PIXI;
@@ -742,6 +817,7 @@ export declare class RpgClientEngine<T = any> {
      * ```
      */
     clearClientPredictionStates(): void;
+    private clearMapTransferPredictionStates;
     /**
      * Stop local movement immediately and discard pending predicted movement.
      *