@number10/jsx-phaser 5.0.0

package/dist/render-context.cjs

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxCore = require("@number10/jsx-core");
+const phaserGuards = require("./utils/phaser-guards.cjs");
+class RenderContext {
+  // @migration(audit:surface-access) Phase 7 — textureScene still needed for SVG/texture loading
+  constructor(scene) {
+    this.scene = scene;
+    this.textureScene = scene;
+  }
+  scene;
+  // Hook context stack (replaces global CURRENT)
+  currentCtx = null;
+  // Texture management per mount
+  textureScene = null;
+  textures = /* @__PURE__ */ new Map();
+  // Track if context is shutting down
+  isShuttingDown = false;
+  /**
+   * Check if context is shutting down
+   */
+  isShutdown() {
+    return this.isShuttingDown;
+  }
+  /**
+   * Mark context as shutting down
+   */
+  shutdown() {
+    this.isShuttingDown = true;
+  }
+  /**
+   * Get current hook context
+   */
+  getCurrent() {
+    return this.currentCtx;
+  }
+  /**
+   * Set current hook context
+   */
+  setCurrent(ctx) {
+    this.currentCtx = ctx;
+  }
+  /**
+   * Get texture scene.
+   * @migration(audit:surface-access) Phase 7 — Capability "textures", renderer-native for now
+   */
+  getTextureScene() {
+    return this.textureScene;
+  }
+  /**
+   * Get textures map
+   */
+  getTextures() {
+    return this.textures;
+  }
+  /**
+   * Defer a layout callback to next frame.
+   * Delegates to Core's DeferredLayoutQueue with a shutdown guard.
+   */
+  deferLayout(callback) {
+    if (this.isShuttingDown) return;
+    jsxCore.DeferredLayoutQueue.defer(callback);
+  }
+}
+const contextStore = /* @__PURE__ */ new WeakMap();
+const shutdownScenes = /* @__PURE__ */ new WeakSet();
+function getRenderContext(parentOrScene) {
+  const scene = phaserGuards.isPhaserScene(parentOrScene) ? parentOrScene : parentOrScene.scene;
+  if (!scene || !scene.sys || !scene.sys.settings.active) {
+    throw new Error("getRenderContext: Invalid scene or inactive scene");
+  }
+  const containerKey = phaserGuards.isPhaserContainer(parentOrScene) ? `__rc_${parentOrScene.id ?? "container"}__` : "__rc_scene__";
+  let sceneContexts = contextStore.get(scene);
+  if (!sceneContexts) {
+    sceneContexts = /* @__PURE__ */ new Map();
+    contextStore.set(scene, sceneContexts);
+  }
+  let context = sceneContexts.get(containerKey);
+  if (!context) {
+    context = new RenderContext(scene);
+    sceneContexts.set(containerKey, context);
+    if (!shutdownScenes.has(scene)) {
+      shutdownScenes.add(scene);
+      scene.events.once("shutdown", () => {
+        const contexts = contextStore.get(scene);
+        if (contexts) {
+          for (const [, ctx] of contexts) {
+            ctx.shutdown();
+          }
+          contextStore.delete(scene);
+        }
+      });
+    }
+  }
+  return context;
+}
+function getContextFromParent(parent) {
+  if (!parent) {
+    throw new Error("getContextFromParent: Parent is null or undefined");
+  }
+  return getRenderContext(parent);
+}
+exports.RenderContext = RenderContext;
+exports.getContextFromParent = getContextFromParent;
+exports.getRenderContext = getRenderContext;
+//# sourceMappingURL=render-context.cjs.map

package/dist/render-context.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-context.cjs","sources":["../src/render-context.ts"],"sourcesContent":["/**\n * Render context - isolates global state per mount point.\n * Storage uses a module-level Map instead of Phaser's scene.data.\n * Deferred layout and layout batching delegate to Core's static queues.\n *\n * @migration(audit:surface-access) Phase 7 — scene.data → Map ✅, deferLayout → DeferredLayoutQueue ✅\n */\nimport { DeferredLayoutQueue } from '@number10/jsx-core'\nimport type * as Phaser from 'phaser'\nimport type { Ctx } from './hooks'\nimport { isPhaserContainer, isPhaserScene } from './utils/phaser-guards'\n\n/**\n * Render context - encapsulates all previously global state.\n * Each mount point gets its own isolated context.\n *\n * Layout batching is handled by Core's LayoutBatchQueue (static, global).\n * Deferred layout callbacks are handled by Core's DeferredLayoutQueue.\n * RenderContext only adds a shutdown guard on top.\n */\nexport class RenderContext {\n  // Hook context stack (replaces global CURRENT)\n  private currentCtx: Ctx | null = null\n\n  // Texture management per mount\n  private textureScene: Phaser.Scene | null = null\n  private textures = new Map<\n    string,\n    { refCount: number; promise: Promise<void> | null; loaded: boolean }\n  >()\n\n  // Track if context is shutting down\n  private isShuttingDown = false\n\n  // @migration(audit:surface-access) Phase 7 — textureScene still needed for SVG/texture loading\n  constructor(public scene: Phaser.Scene) {\n    this.textureScene = scene\n  }\n\n  /**\n   * Check if context is shutting down\n   */\n  isShutdown(): boolean {\n    return this.isShuttingDown\n  }\n\n  /**\n   * Mark context as shutting down\n   */\n  shutdown(): void {\n    this.isShuttingDown = true\n  }\n\n  /**\n   * Get current hook context\n   */\n  getCurrent(): Ctx | null {\n    return this.currentCtx\n  }\n\n  /**\n   * Set current hook context\n   */\n  setCurrent(ctx: Ctx | null): void {\n    this.currentCtx = ctx\n  }\n\n  /**\n   * Get texture scene.\n   * @migration(audit:surface-access) Phase 7 — Capability \"textures\", renderer-native for now\n   */\n  getTextureScene(): Phaser.Scene | null {\n    return this.textureScene\n  }\n\n  /**\n   * Get textures map\n   */\n  getTextures(): Map<string, { refCount: number; promise: Promise<void> | null; loaded: boolean }> {\n    return this.textures\n  }\n\n  /**\n   * Defer a layout callback to next frame.\n   * Delegates to Core's DeferredLayoutQueue with a shutdown guard.\n   */\n  deferLayout(callback: () => void): void {\n    if (this.isShuttingDown) return\n    DeferredLayoutQueue.defer(callback)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Internal context storage (replaces scene.data)\n// ---------------------------------------------------------------------------\n\n/**\n * Per-scene context store — isolates RenderContexts between different Phaser.Game instances.\n *\n * Key structure: WeakMap<Scene, Map<containerKey, RenderContext>>\n * This prevents container ID collisions across different Game instances because\n * each Game creates its own Scene objects, and WeakMap keys are based on object\n * identity (not string keys that can collide).\n */\nconst contextStore = new WeakMap<Phaser.Scene, Map<string, RenderContext>>()\n\n/** Track which scenes have shutdown listeners registered */\nconst shutdownScenes = new WeakSet<Phaser.Scene>()\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Get or create RenderContext for a scene or container.\n * Uses an internal Map for storage instead of scene.data.\n * @param parentOrScene - Scene or Container to get context for\n * @returns RenderContext instance\n */\nexport function getRenderContext(\n  parentOrScene: Phaser.Scene | Phaser.GameObjects.Container\n): RenderContext {\n  const scene = isPhaserScene(parentOrScene) ? parentOrScene : parentOrScene.scene\n\n  if (!scene || !scene.sys || !scene.sys.settings.active) {\n    throw new Error('getRenderContext: Invalid scene or inactive scene')\n  }\n\n  // Build unique key: scene identity + container identity for multi-mount isolation\n  const containerKey = isPhaserContainer(parentOrScene)\n    ? `__rc_${(parentOrScene as unknown as { id?: number }).id ?? 'container'}__`\n    : '__rc_scene__'\n\n  // Get or create the per-scene context map (WeakMap ensures isolation across Game instances)\n  let sceneContexts = contextStore.get(scene)\n  if (!sceneContexts) {\n    sceneContexts = new Map()\n    contextStore.set(scene, sceneContexts)\n  }\n\n  let context = sceneContexts.get(containerKey)\n\n  if (!context) {\n    context = new RenderContext(scene)\n    sceneContexts.set(containerKey, context)\n\n    // Register shutdown cleanup once per scene\n    if (!shutdownScenes.has(scene)) {\n      shutdownScenes.add(scene)\n      scene.events.once('shutdown', () => {\n        // Clean up all contexts associated with this scene\n        const contexts = contextStore.get(scene)\n        if (contexts) {\n          for (const [, ctx] of contexts) {\n            ctx.shutdown()\n          }\n          contextStore.delete(scene)\n        }\n      })\n    }\n  }\n\n  return context\n}\n\n/**\n * Get RenderContext from a parent (used internally by hooks)\n * @param parent - Parent scene or container\n * @returns RenderContext instance\n */\nexport function getContextFromParent(\n  parent: Phaser.Scene | Phaser.GameObjects.Container\n): RenderContext {\n  if (!parent) {\n    throw new Error('getContextFromParent: Parent is null or undefined')\n  }\n  return getRenderContext(parent)\n}\n"],"names":["DeferredLayoutQueue","isPhaserScene","isPhaserContainer"],"mappings":";;;;AAoBO,MAAM,cAAc;AAAA;AAAA,EAezB,YAAmB,OAAqB;AAArB,SAAA,QAAA;AACjB,SAAK,eAAe;AAAA,EACtB;AAAA,EAFmB;AAAA;AAAA,EAbX,aAAyB;AAAA;AAAA,EAGzB,eAAoC;AAAA,EACpC,+BAAe,IAAA;AAAA;AAAA,EAMf,iBAAiB;AAAA;AAAA;AAAA;AAAA,EAUzB,aAAsB;AACpB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,WAAiB;AACf,SAAK,iBAAiB;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA,EAKA,aAAyB;AACvB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,KAAuB;AAChC,SAAK,aAAa;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,kBAAuC;AACrC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,cAAiG;AAC/F,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,YAAY,UAA4B;AACtC,QAAI,KAAK,eAAgB;AACzBA,YAAAA,oBAAoB,MAAM,QAAQ;AAAA,EACpC;AACF;AAcA,MAAM,mCAAmB,QAAA;AAGzB,MAAM,qCAAqB,QAAA;AAYpB,SAAS,iBACd,eACe;AACf,QAAM,QAAQC,aAAAA,cAAc,aAAa,IAAI,gBAAgB,cAAc;AAE3E,MAAI,CAAC,SAAS,CAAC,MAAM,OAAO,CAAC,MAAM,IAAI,SAAS,QAAQ;AACtD,UAAM,IAAI,MAAM,mDAAmD;AAAA,EACrE;AAGA,QAAM,eAAeC,aAAAA,kBAAkB,aAAa,IAChD,QAAS,cAA6C,MAAM,WAAW,OACvE;AAGJ,MAAI,gBAAgB,aAAa,IAAI,KAAK;AAC1C,MAAI,CAAC,eAAe;AAClB,wCAAoB,IAAA;AACpB,iBAAa,IAAI,OAAO,aAAa;AAAA,EACvC;AAEA,MAAI,UAAU,cAAc,IAAI,YAAY;AAE5C,MAAI,CAAC,SAAS;AACZ,cAAU,IAAI,cAAc,KAAK;AACjC,kBAAc,IAAI,cAAc,OAAO;AAGvC,QAAI,CAAC,eAAe,IAAI,KAAK,GAAG;AAC9B,qBAAe,IAAI,KAAK;AACxB,YAAM,OAAO,KAAK,YAAY,MAAM;AAElC,cAAM,WAAW,aAAa,IAAI,KAAK;AACvC,YAAI,UAAU;AACZ,qBAAW,CAAA,EAAG,GAAG,KAAK,UAAU;AAC9B,gBAAI,SAAA;AAAA,UACN;AACA,uBAAa,OAAO,KAAK;AAAA,QAC3B;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;AAOO,SAAS,qBACd,QACe;AACf,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,mDAAmD;AAAA,EACrE;AACA,SAAO,iBAAiB,MAAM;AAChC;;;;"}

package/dist/render-context.d.ts

@@ -0,0 +1,66 @@
+import { Ctx } from './hooks';
+import type * as Phaser from 'phaser';
+/**
+ * Render context - encapsulates all previously global state.
+ * Each mount point gets its own isolated context.
+ *
+ * Layout batching is handled by Core's LayoutBatchQueue (static, global).
+ * Deferred layout callbacks are handled by Core's DeferredLayoutQueue.
+ * RenderContext only adds a shutdown guard on top.
+ */
+export declare class RenderContext {
+    scene: Phaser.Scene;
+    private currentCtx;
+    private textureScene;
+    private textures;
+    private isShuttingDown;
+    constructor(scene: Phaser.Scene);
+    /**
+     * Check if context is shutting down
+     */
+    isShutdown(): boolean;
+    /**
+     * Mark context as shutting down
+     */
+    shutdown(): void;
+    /**
+     * Get current hook context
+     */
+    getCurrent(): Ctx | null;
+    /**
+     * Set current hook context
+     */
+    setCurrent(ctx: Ctx | null): void;
+    /**
+     * Get texture scene.
+     * @migration(audit:surface-access) Phase 7 — Capability "textures", renderer-native for now
+     */
+    getTextureScene(): Phaser.Scene | null;
+    /**
+     * Get textures map
+     */
+    getTextures(): Map<string, {
+        refCount: number;
+        promise: Promise<void> | null;
+        loaded: boolean;
+    }>;
+    /**
+     * Defer a layout callback to next frame.
+     * Delegates to Core's DeferredLayoutQueue with a shutdown guard.
+     */
+    deferLayout(callback: () => void): void;
+}
+/**
+ * Get or create RenderContext for a scene or container.
+ * Uses an internal Map for storage instead of scene.data.
+ * @param parentOrScene - Scene or Container to get context for
+ * @returns RenderContext instance
+ */
+export declare function getRenderContext(parentOrScene: Phaser.Scene | Phaser.GameObjects.Container): RenderContext;
+/**
+ * Get RenderContext from a parent (used internally by hooks)
+ * @param parent - Parent scene or container
+ * @returns RenderContext instance
+ */
+export declare function getContextFromParent(parent: Phaser.Scene | Phaser.GameObjects.Container): RenderContext;
+//# sourceMappingURL=render-context.d.ts.map

package/dist/render-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-context.d.ts","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,KAAK,MAAM,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAGlC;;;;;;;GAOG;AACH,qBAAa,aAAa;IAeL,KAAK,EAAE,MAAM,CAAC,KAAK;IAbtC,OAAO,CAAC,UAAU,CAAmB;IAGrC,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAGb;IAGH,OAAO,CAAC,cAAc,CAAQ;gBAGX,KAAK,EAAE,MAAM,CAAC,KAAK;IAItC;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,UAAU,IAAI,GAAG,GAAG,IAAI;IAIxB;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;IAIjC;;;OAGG;IACH,eAAe,IAAI,MAAM,CAAC,KAAK,GAAG,IAAI;IAItC;;OAEG;IACH,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAIhG;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;CAIxC;AAuBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,SAAS,GACzD,aAAa,CA0Cf;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,SAAS,GAClD,aAAa,CAKf"}

package/dist/render-context.js

@@ -0,0 +1,106 @@
+import { DeferredLayoutQueue } from "@number10/jsx-core";
+import { isPhaserScene, isPhaserContainer } from "./utils/phaser-guards.js";
+class RenderContext {
+  // @migration(audit:surface-access) Phase 7 — textureScene still needed for SVG/texture loading
+  constructor(scene) {
+    this.scene = scene;
+    this.textureScene = scene;
+  }
+  scene;
+  // Hook context stack (replaces global CURRENT)
+  currentCtx = null;
+  // Texture management per mount
+  textureScene = null;
+  textures = /* @__PURE__ */ new Map();
+  // Track if context is shutting down
+  isShuttingDown = false;
+  /**
+   * Check if context is shutting down
+   */
+  isShutdown() {
+    return this.isShuttingDown;
+  }
+  /**
+   * Mark context as shutting down
+   */
+  shutdown() {
+    this.isShuttingDown = true;
+  }
+  /**
+   * Get current hook context
+   */
+  getCurrent() {
+    return this.currentCtx;
+  }
+  /**
+   * Set current hook context
+   */
+  setCurrent(ctx) {
+    this.currentCtx = ctx;
+  }
+  /**
+   * Get texture scene.
+   * @migration(audit:surface-access) Phase 7 — Capability "textures", renderer-native for now
+   */
+  getTextureScene() {
+    return this.textureScene;
+  }
+  /**
+   * Get textures map
+   */
+  getTextures() {
+    return this.textures;
+  }
+  /**
+   * Defer a layout callback to next frame.
+   * Delegates to Core's DeferredLayoutQueue with a shutdown guard.
+   */
+  deferLayout(callback) {
+    if (this.isShuttingDown) return;
+    DeferredLayoutQueue.defer(callback);
+  }
+}
+const contextStore = /* @__PURE__ */ new WeakMap();
+const shutdownScenes = /* @__PURE__ */ new WeakSet();
+function getRenderContext(parentOrScene) {
+  const scene = isPhaserScene(parentOrScene) ? parentOrScene : parentOrScene.scene;
+  if (!scene || !scene.sys || !scene.sys.settings.active) {
+    throw new Error("getRenderContext: Invalid scene or inactive scene");
+  }
+  const containerKey = isPhaserContainer(parentOrScene) ? `__rc_${parentOrScene.id ?? "container"}__` : "__rc_scene__";
+  let sceneContexts = contextStore.get(scene);
+  if (!sceneContexts) {
+    sceneContexts = /* @__PURE__ */ new Map();
+    contextStore.set(scene, sceneContexts);
+  }
+  let context = sceneContexts.get(containerKey);
+  if (!context) {
+    context = new RenderContext(scene);
+    sceneContexts.set(containerKey, context);
+    if (!shutdownScenes.has(scene)) {
+      shutdownScenes.add(scene);
+      scene.events.once("shutdown", () => {
+        const contexts = contextStore.get(scene);
+        if (contexts) {
+          for (const [, ctx] of contexts) {
+            ctx.shutdown();
+          }
+          contextStore.delete(scene);
+        }
+      });
+    }
+  }
+  return context;
+}
+function getContextFromParent(parent) {
+  if (!parent) {
+    throw new Error("getContextFromParent: Parent is null or undefined");
+  }
+  return getRenderContext(parent);
+}
+export {
+  RenderContext,
+  getContextFromParent,
+  getRenderContext
+};
+//# sourceMappingURL=render-context.js.map

package/dist/render-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-context.js","sources":["../src/render-context.ts"],"sourcesContent":["/**\n * Render context - isolates global state per mount point.\n * Storage uses a module-level Map instead of Phaser's scene.data.\n * Deferred layout and layout batching delegate to Core's static queues.\n *\n * @migration(audit:surface-access) Phase 7 — scene.data → Map ✅, deferLayout → DeferredLayoutQueue ✅\n */\nimport { DeferredLayoutQueue } from '@number10/jsx-core'\nimport type * as Phaser from 'phaser'\nimport type { Ctx } from './hooks'\nimport { isPhaserContainer, isPhaserScene } from './utils/phaser-guards'\n\n/**\n * Render context - encapsulates all previously global state.\n * Each mount point gets its own isolated context.\n *\n * Layout batching is handled by Core's LayoutBatchQueue (static, global).\n * Deferred layout callbacks are handled by Core's DeferredLayoutQueue.\n * RenderContext only adds a shutdown guard on top.\n */\nexport class RenderContext {\n  // Hook context stack (replaces global CURRENT)\n  private currentCtx: Ctx | null = null\n\n  // Texture management per mount\n  private textureScene: Phaser.Scene | null = null\n  private textures = new Map<\n    string,\n    { refCount: number; promise: Promise<void> | null; loaded: boolean }\n  >()\n\n  // Track if context is shutting down\n  private isShuttingDown = false\n\n  // @migration(audit:surface-access) Phase 7 — textureScene still needed for SVG/texture loading\n  constructor(public scene: Phaser.Scene) {\n    this.textureScene = scene\n  }\n\n  /**\n   * Check if context is shutting down\n   */\n  isShutdown(): boolean {\n    return this.isShuttingDown\n  }\n\n  /**\n   * Mark context as shutting down\n   */\n  shutdown(): void {\n    this.isShuttingDown = true\n  }\n\n  /**\n   * Get current hook context\n   */\n  getCurrent(): Ctx | null {\n    return this.currentCtx\n  }\n\n  /**\n   * Set current hook context\n   */\n  setCurrent(ctx: Ctx | null): void {\n    this.currentCtx = ctx\n  }\n\n  /**\n   * Get texture scene.\n   * @migration(audit:surface-access) Phase 7 — Capability \"textures\", renderer-native for now\n   */\n  getTextureScene(): Phaser.Scene | null {\n    return this.textureScene\n  }\n\n  /**\n   * Get textures map\n   */\n  getTextures(): Map<string, { refCount: number; promise: Promise<void> | null; loaded: boolean }> {\n    return this.textures\n  }\n\n  /**\n   * Defer a layout callback to next frame.\n   * Delegates to Core's DeferredLayoutQueue with a shutdown guard.\n   */\n  deferLayout(callback: () => void): void {\n    if (this.isShuttingDown) return\n    DeferredLayoutQueue.defer(callback)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Internal context storage (replaces scene.data)\n// ---------------------------------------------------------------------------\n\n/**\n * Per-scene context store — isolates RenderContexts between different Phaser.Game instances.\n *\n * Key structure: WeakMap<Scene, Map<containerKey, RenderContext>>\n * This prevents container ID collisions across different Game instances because\n * each Game creates its own Scene objects, and WeakMap keys are based on object\n * identity (not string keys that can collide).\n */\nconst contextStore = new WeakMap<Phaser.Scene, Map<string, RenderContext>>()\n\n/** Track which scenes have shutdown listeners registered */\nconst shutdownScenes = new WeakSet<Phaser.Scene>()\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Get or create RenderContext for a scene or container.\n * Uses an internal Map for storage instead of scene.data.\n * @param parentOrScene - Scene or Container to get context for\n * @returns RenderContext instance\n */\nexport function getRenderContext(\n  parentOrScene: Phaser.Scene | Phaser.GameObjects.Container\n): RenderContext {\n  const scene = isPhaserScene(parentOrScene) ? parentOrScene : parentOrScene.scene\n\n  if (!scene || !scene.sys || !scene.sys.settings.active) {\n    throw new Error('getRenderContext: Invalid scene or inactive scene')\n  }\n\n  // Build unique key: scene identity + container identity for multi-mount isolation\n  const containerKey = isPhaserContainer(parentOrScene)\n    ? `__rc_${(parentOrScene as unknown as { id?: number }).id ?? 'container'}__`\n    : '__rc_scene__'\n\n  // Get or create the per-scene context map (WeakMap ensures isolation across Game instances)\n  let sceneContexts = contextStore.get(scene)\n  if (!sceneContexts) {\n    sceneContexts = new Map()\n    contextStore.set(scene, sceneContexts)\n  }\n\n  let context = sceneContexts.get(containerKey)\n\n  if (!context) {\n    context = new RenderContext(scene)\n    sceneContexts.set(containerKey, context)\n\n    // Register shutdown cleanup once per scene\n    if (!shutdownScenes.has(scene)) {\n      shutdownScenes.add(scene)\n      scene.events.once('shutdown', () => {\n        // Clean up all contexts associated with this scene\n        const contexts = contextStore.get(scene)\n        if (contexts) {\n          for (const [, ctx] of contexts) {\n            ctx.shutdown()\n          }\n          contextStore.delete(scene)\n        }\n      })\n    }\n  }\n\n  return context\n}\n\n/**\n * Get RenderContext from a parent (used internally by hooks)\n * @param parent - Parent scene or container\n * @returns RenderContext instance\n */\nexport function getContextFromParent(\n  parent: Phaser.Scene | Phaser.GameObjects.Container\n): RenderContext {\n  if (!parent) {\n    throw new Error('getContextFromParent: Parent is null or undefined')\n  }\n  return getRenderContext(parent)\n}\n"],"names":[],"mappings":";;AAoBO,MAAM,cAAc;AAAA;AAAA,EAezB,YAAmB,OAAqB;AAArB,SAAA,QAAA;AACjB,SAAK,eAAe;AAAA,EACtB;AAAA,EAFmB;AAAA;AAAA,EAbX,aAAyB;AAAA;AAAA,EAGzB,eAAoC;AAAA,EACpC,+BAAe,IAAA;AAAA;AAAA,EAMf,iBAAiB;AAAA;AAAA;AAAA;AAAA,EAUzB,aAAsB;AACpB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,WAAiB;AACf,SAAK,iBAAiB;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA,EAKA,aAAyB;AACvB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,KAAuB;AAChC,SAAK,aAAa;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,kBAAuC;AACrC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,cAAiG;AAC/F,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,YAAY,UAA4B;AACtC,QAAI,KAAK,eAAgB;AACzB,wBAAoB,MAAM,QAAQ;AAAA,EACpC;AACF;AAcA,MAAM,mCAAmB,QAAA;AAGzB,MAAM,qCAAqB,QAAA;AAYpB,SAAS,iBACd,eACe;AACf,QAAM,QAAQ,cAAc,aAAa,IAAI,gBAAgB,cAAc;AAE3E,MAAI,CAAC,SAAS,CAAC,MAAM,OAAO,CAAC,MAAM,IAAI,SAAS,QAAQ;AACtD,UAAM,IAAI,MAAM,mDAAmD;AAAA,EACrE;AAGA,QAAM,eAAe,kBAAkB,aAAa,IAChD,QAAS,cAA6C,MAAM,WAAW,OACvE;AAGJ,MAAI,gBAAgB,aAAa,IAAI,KAAK;AAC1C,MAAI,CAAC,eAAe;AAClB,wCAAoB,IAAA;AACpB,iBAAa,IAAI,OAAO,aAAa;AAAA,EACvC;AAEA,MAAI,UAAU,cAAc,IAAI,YAAY;AAE5C,MAAI,CAAC,SAAS;AACZ,cAAU,IAAI,cAAc,KAAK;AACjC,kBAAc,IAAI,cAAc,OAAO;AAGvC,QAAI,CAAC,eAAe,IAAI,KAAK,GAAG;AAC9B,qBAAe,IAAI,KAAK;AACxB,YAAM,OAAO,KAAK,YAAY,MAAM;AAElC,cAAM,WAAW,aAAa,IAAI,KAAK;AACvC,YAAI,UAAU;AACZ,qBAAW,CAAA,EAAG,GAAG,KAAK,UAAU;AAC9B,gBAAI,SAAA;AAAA,UACN;AACA,uBAAa,OAAO,KAAK;AAAA,QAC3B;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;AAOO,SAAS,qBACd,QACe;AACf,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,mDAAmD;AAAA,EACrE;AACA,SAAO,iBAAiB,MAAM;AAChC;"}

package/dist/scene-backgrounds.cjs

@@ -0,0 +1,285 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const Phaser = require("phaser");
+function _interopNamespaceDefault(e) {
+  const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
+  if (e) {
+    for (const k in e) {
+      if (k !== "default") {
+        const d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: () => e[k]
+        });
+      }
+    }
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+const Phaser__namespace = /* @__PURE__ */ _interopNamespaceDefault(Phaser);
+const DEFAULT_LOGO_KEY = "phaser-jsx-logo";
+const DEFAULT_BACKGROUND = {
+  type: "grid",
+  animation: "lemniscate",
+  opacity: 0.15,
+  color: 4890367
+};
+let sceneBackgroundTextureId = 0;
+function colorToCss(color) {
+  return `#${color.toString(16).padStart(6, "0")}`;
+}
+function createCanvasTexture(scene, width, height, draw) {
+  const textureKey = `__phaserjsx_scene_bg_${sceneBackgroundTextureId++}`;
+  const textureWidth = Math.max(1, Math.ceil(width));
+  const textureHeight = Math.max(1, Math.ceil(height));
+  const texture = scene.textures.createCanvas(textureKey, textureWidth, textureHeight);
+  if (!texture) {
+    throw new Error("Unable to create scene background texture");
+  }
+  const canvas = texture.getSourceImage();
+  const ctx = canvas.getContext("2d");
+  if (!ctx) {
+    throw new Error("Unable to create scene background canvas texture");
+  }
+  ctx.clearRect(0, 0, textureWidth, textureHeight);
+  draw(ctx, textureWidth, textureHeight);
+  texture.refresh();
+  return textureKey;
+}
+function removeTexture(scene, textureKey) {
+  if (textureKey && scene.textures.exists(textureKey)) {
+    scene.textures.remove(textureKey);
+  }
+}
+function addSceneBackground(scene, config = DEFAULT_BACKGROUND) {
+  const bgConfig = config ?? DEFAULT_BACKGROUND;
+  if (bgConfig.type === "none") return null;
+  let background;
+  let backgroundTween;
+  const particleTweens = [];
+  const textureKeys = /* @__PURE__ */ new Set();
+  let resizeFn;
+  let destroyed = false;
+  const createGridBackground = () => {
+    const gridSize = 40;
+    const color = bgConfig.color ?? 4890367;
+    const opacity = bgConfig.opacity ?? 0.15;
+    const textureKey = createCanvasTexture(scene, gridSize, gridSize, (ctx, width, height) => {
+      ctx.globalAlpha = opacity;
+      ctx.strokeStyle = colorToCss(color);
+      ctx.lineWidth = 1;
+      ctx.beginPath();
+      ctx.moveTo(0.5, 0);
+      ctx.lineTo(0.5, height);
+      ctx.moveTo(0, 0.5);
+      ctx.lineTo(width, 0.5);
+      ctx.stroke();
+    });
+    textureKeys.add(textureKey);
+    const tile = scene.add.tileSprite(0, 0, scene.scale.width, scene.scale.height, textureKey);
+    tile.setOrigin(0, 0);
+    const moveGrid = (offsetX, offsetY) => {
+      tile.tilePositionX = -offsetX;
+      tile.tilePositionY = -offsetY;
+    };
+    tile.__redrawFn = moveGrid;
+    background = tile;
+    resizeFn = (width, height) => {
+      tile.setSize(width, height);
+    };
+  };
+  const createLogoBackground = () => {
+    const container = scene.add.container(scene.scale.width / 2, scene.scale.height / 2);
+    const opacity = bgConfig.opacity ?? 0.1;
+    const logoKey = bgConfig.logoKey ?? DEFAULT_LOGO_KEY;
+    const logo = scene.add.image(0, 0, logoKey);
+    logo.setAlpha(opacity);
+    logo.setScale(0.5);
+    container.add(logo);
+    background = container;
+    resizeFn = (width, height) => {
+      container.setPosition(width / 2, height / 2);
+    };
+  };
+  const createGradientBackground = () => {
+    const color1 = bgConfig.color ?? 4890367;
+    const color2 = bgConfig.colorSecondary ?? 7031551;
+    const opacity = bgConfig.opacity ?? 0.2;
+    const createGradientTexture = (width, height) => createCanvasTexture(scene, width, height, (ctx, textureWidth, textureHeight) => {
+      const gradient = ctx.createLinearGradient(0, 0, 0, textureHeight);
+      gradient.addColorStop(0, colorToCss(color1));
+      gradient.addColorStop(1, colorToCss(color2));
+      ctx.globalAlpha = opacity;
+      ctx.fillStyle = gradient;
+      ctx.fillRect(0, 0, textureWidth, textureHeight);
+    });
+    let textureKey = createGradientTexture(scene.scale.width, scene.scale.height);
+    textureKeys.add(textureKey);
+    const image = scene.add.image(0, 0, textureKey);
+    image.setOrigin(0, 0);
+    resizeFn = (width, height) => {
+      const previousTextureKey = textureKey;
+      textureKey = createGradientTexture(width, height);
+      textureKeys.add(textureKey);
+      image.setTexture(textureKey);
+      image.setDisplaySize(width, height);
+      textureKeys.delete(previousTextureKey);
+      removeTexture(scene, previousTextureKey);
+    };
+    background = image;
+  };
+  const createParticlesBackground = () => {
+    const container = scene.add.container(0, 0);
+    const particleCount = 20;
+    const color = bgConfig.color ?? 4890367;
+    const opacity = bgConfig.opacity ?? 0.1;
+    const particles = [];
+    for (let i = 0; i < particleCount; i += 1) {
+      const size = Phaser__namespace.Math.Between(2, 6);
+      const x = Phaser__namespace.Math.Between(0, scene.scale.width);
+      const y = Phaser__namespace.Math.Between(0, scene.scale.height);
+      const particle = scene.add.circle(x, y, size, color, opacity);
+      container.add(particle);
+      particles.push(particle);
+      particleTweens.push(
+        scene.tweens.add({
+          targets: particle,
+          y: particle.y + Phaser__namespace.Math.Between(-50, 50),
+          x: particle.x + Phaser__namespace.Math.Between(-50, 50),
+          alpha: opacity * 1.5,
+          duration: Phaser__namespace.Math.Between(2e3, 4e3),
+          yoyo: true,
+          repeat: -1,
+          ease: "Sine.easeInOut"
+        })
+      );
+    }
+    background = container;
+    resizeFn = (width, height) => {
+      for (const particle of particles) {
+        particle.setPosition(Phaser__namespace.Math.Between(0, width), Phaser__namespace.Math.Between(0, height));
+      }
+    };
+  };
+  switch (bgConfig.type) {
+    case "grid":
+      createGridBackground();
+      break;
+    case "logo":
+      createLogoBackground();
+      break;
+    case "gradient":
+      createGradientBackground();
+      break;
+    case "particles":
+      createParticlesBackground();
+      break;
+  }
+  if (!background) return null;
+  if (bgConfig.animation && bgConfig.animation !== "static") {
+    backgroundTween = applyAnimation(scene, background, bgConfig.animation);
+  }
+  const onResize = () => {
+    if (resizeFn) resizeFn(scene.scale.width, scene.scale.height);
+  };
+  const cleanup = () => {
+    if (destroyed) return;
+    destroyed = true;
+    backgroundTween?.stop();
+    for (const tween of particleTweens) {
+      tween.stop();
+    }
+    background?.destroy();
+    background = void 0;
+    for (const textureKey of textureKeys) {
+      removeTexture(scene, textureKey);
+    }
+    textureKeys.clear();
+    scene.scale.off(Phaser__namespace.Scale.Events.RESIZE, onResize);
+    scene.events.off(Phaser__namespace.Scenes.Events.SHUTDOWN, cleanup);
+    scene.events.off(Phaser__namespace.Scenes.Events.DESTROY, cleanup);
+  };
+  scene.scale.on(Phaser__namespace.Scale.Events.RESIZE, onResize);
+  scene.events.once(Phaser__namespace.Scenes.Events.SHUTDOWN, cleanup);
+  scene.events.once(Phaser__namespace.Scenes.Events.DESTROY, cleanup);
+  return {
+    background,
+    destroy: cleanup,
+    resize: (width, height) => {
+      if (resizeFn) resizeFn(width, height);
+    }
+  };
+}
+function applyAnimation(scene, target, animation) {
+  const redrawFn = target.__redrawFn;
+  switch (animation) {
+    case "lemniscate":
+      return redrawFn ? animateLemniscate(scene, redrawFn) : animatePulse(scene, target);
+    case "wave":
+      return redrawFn ? animateWave(scene, redrawFn) : animatePulse(scene, target);
+    case "pulse":
+      return animatePulse(scene, target);
+    case "rotate":
+      return animateRotate(scene, target);
+    case "static":
+    default:
+      return void 0;
+  }
+}
+function animateLemniscate(scene, drawFn) {
+  const amplitude = 30;
+  const duration = 8e3;
+  return scene.tweens.addCounter({
+    from: 0,
+    to: Math.PI * 2,
+    duration,
+    repeat: -1,
+    onUpdate: (tween) => {
+      const t = tween.getValue();
+      if (t !== null) {
+        const offsetX = amplitude * Math.cos(t);
+        const offsetY = amplitude * Math.sin(2 * t) / 2;
+        drawFn(offsetX, offsetY);
+      }
+    }
+  });
+}
+function animateWave(scene, drawFn) {
+  return scene.tweens.addCounter({
+    from: 0,
+    to: 40,
+    duration: 3e3,
+    yoyo: true,
+    repeat: -1,
+    onUpdate: (tween) => {
+      const offset = tween.getValue();
+      if (offset !== null) {
+        drawFn(offset, 0);
+      }
+    }
+  });
+}
+function animatePulse(scene, target) {
+  return scene.tweens.add({
+    targets: target,
+    scaleX: 1.1,
+    scaleY: 1.1,
+    duration: 2e3,
+    yoyo: true,
+    repeat: -1,
+    ease: "Sine.easeInOut"
+  });
+}
+function animateRotate(scene, target) {
+  return scene.tweens.add({
+    targets: target,
+    angle: 360,
+    duration: 2e4,
+    repeat: -1,
+    ease: "Linear"
+  });
+}
+exports.DEFAULT_BACKGROUND = DEFAULT_BACKGROUND;
+exports.addSceneBackground = addSceneBackground;
+//# sourceMappingURL=scene-backgrounds.cjs.map

package/dist/scene-backgrounds.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-backgrounds.cjs","sources":["../src/scene-backgrounds.ts"],"sourcesContent":["import * as Phaser from 'phaser'\n\n/**\n * Built-in decorative background variants that can be attached to a Phaser scene.\n */\nexport type SceneBackgroundType = 'grid' | 'logo' | 'gradient' | 'particles' | 'none'\n\n/**\n * Optional animation applied to a scene background after it is created.\n */\nexport type BackgroundAnimation = 'lemniscate' | 'wave' | 'pulse' | 'rotate' | 'static'\n\n/**\n * Configuration for {@link addSceneBackground}.\n */\nexport interface BackgroundConfig {\n  /** Background variant to create. Use `'none'` to disable background creation. */\n  type: SceneBackgroundType\n\n  /** Animation preset applied to the created background. Defaults depend on caller config. */\n  animation?: BackgroundAnimation\n\n  /** Background opacity, usually between `0` and `1`. */\n  opacity?: number\n\n  /** Primary color as a Phaser numeric color, for example `0x4a9eff`. */\n  color?: number\n\n  /** Secondary color used by gradient backgrounds. */\n  colorSecondary?: number\n\n  /** Texture key used by the logo background. Defaults to the built-in logo key. */\n  logoKey?: string\n}\n\n/**\n * Handle returned by {@link addSceneBackground}.\n */\nexport interface SceneBackgroundHandle {\n  /** Root game object created for the background. */\n  background: BackgroundTarget\n\n  /** Stops animations, destroys game objects, removes generated textures, and detaches listeners. */\n  destroy: () => void\n\n  /** Manually resize the background to match an external viewport size. */\n  resize: (width: number, height: number) => void\n}\n\nconst DEFAULT_LOGO_KEY = 'phaser-jsx-logo'\n\n/**\n * Default scene background used when no explicit config is provided.\n */\nexport const DEFAULT_BACKGROUND: BackgroundConfig = {\n  type: 'grid',\n  animation: 'lemniscate',\n  opacity: 0.15,\n  color: 0x4a9eff,\n}\n\ntype BackgroundTarget =\n  | Phaser.GameObjects.Container\n  | Phaser.GameObjects.Image\n  | Phaser.GameObjects.TileSprite\ntype RedrawableTarget = BackgroundTarget & { __redrawFn?: (x: number, y: number) => void }\n\nlet sceneBackgroundTextureId = 0\n\nfunction colorToCss(color: number): string {\n  return `#${color.toString(16).padStart(6, '0')}`\n}\n\nfunction createCanvasTexture(\n  scene: Phaser.Scene,\n  width: number,\n  height: number,\n  draw: (ctx: CanvasRenderingContext2D, width: number, height: number) => void\n): string {\n  const textureKey = `__phaserjsx_scene_bg_${sceneBackgroundTextureId++}`\n  const textureWidth = Math.max(1, Math.ceil(width))\n  const textureHeight = Math.max(1, Math.ceil(height))\n  const texture = scene.textures.createCanvas(textureKey, textureWidth, textureHeight)\n\n  if (!texture) {\n    throw new Error('Unable to create scene background texture')\n  }\n\n  const canvas = texture.getSourceImage() as HTMLCanvasElement\n  const ctx = canvas.getContext('2d')\n\n  if (!ctx) {\n    throw new Error('Unable to create scene background canvas texture')\n  }\n\n  ctx.clearRect(0, 0, textureWidth, textureHeight)\n  draw(ctx, textureWidth, textureHeight)\n  texture.refresh()\n\n  return textureKey\n}\n\nfunction removeTexture(scene: Phaser.Scene, textureKey: string | undefined): void {\n  if (textureKey && scene.textures.exists(textureKey)) {\n    scene.textures.remove(textureKey)\n  }\n}\n\n/**\n * Adds a decorative background object to a Phaser scene.\n *\n * The helper owns all game objects, tweens, resize listeners, and generated textures it creates.\n * It automatically cleans up on scene shutdown or destroy. Call `handle.destroy()` when removing\n * the background earlier.\n *\n * @param scene - Phaser scene that receives the background.\n * @param config - Background type, colors, opacity, animation, and optional logo texture key.\n * @returns A handle for manual resize and cleanup, or `null` when `config.type` is `'none'`.\n *\n * @example\n * ```ts\n * const handle = addSceneBackground(scene, {\n *   type: 'grid',\n *   animation: 'wave',\n *   color: 0x4a9eff,\n *   opacity: 0.12,\n * })\n *\n * // Later, if the background should be removed before scene shutdown:\n * handle?.destroy()\n * ```\n */\nexport function addSceneBackground(\n  scene: Phaser.Scene,\n  config: BackgroundConfig = DEFAULT_BACKGROUND\n): SceneBackgroundHandle | null {\n  const bgConfig = config ?? DEFAULT_BACKGROUND\n  if (bgConfig.type === 'none') return null\n\n  let background: BackgroundTarget | undefined\n  let backgroundTween: Phaser.Tweens.Tween | undefined\n  const particleTweens: Phaser.Tweens.Tween[] = []\n  const textureKeys = new Set<string>()\n  let resizeFn: ((width: number, height: number) => void) | undefined\n  let destroyed = false\n\n  const createGridBackground = () => {\n    const gridSize = 40\n    const color = bgConfig.color ?? 0x4a9eff\n    const opacity = bgConfig.opacity ?? 0.15\n    const textureKey = createCanvasTexture(scene, gridSize, gridSize, (ctx, width, height) => {\n      ctx.globalAlpha = opacity\n      ctx.strokeStyle = colorToCss(color)\n      ctx.lineWidth = 1\n      ctx.beginPath()\n      ctx.moveTo(0.5, 0)\n      ctx.lineTo(0.5, height)\n      ctx.moveTo(0, 0.5)\n      ctx.lineTo(width, 0.5)\n      ctx.stroke()\n    })\n    textureKeys.add(textureKey)\n\n    const tile = scene.add.tileSprite(0, 0, scene.scale.width, scene.scale.height, textureKey)\n    tile.setOrigin(0, 0)\n\n    const moveGrid = (offsetX: number, offsetY: number) => {\n      tile.tilePositionX = -offsetX\n      tile.tilePositionY = -offsetY\n    }\n\n    ;(tile as RedrawableTarget).__redrawFn = moveGrid\n    background = tile\n    resizeFn = (width, height) => {\n      tile.setSize(width, height)\n    }\n  }\n\n  const createLogoBackground = () => {\n    const container = scene.add.container(scene.scale.width / 2, scene.scale.height / 2)\n    const opacity = bgConfig.opacity ?? 0.1\n    const logoKey = bgConfig.logoKey ?? DEFAULT_LOGO_KEY\n\n    const logo = scene.add.image(0, 0, logoKey)\n    logo.setAlpha(opacity)\n    logo.setScale(0.5)\n\n    container.add(logo)\n    background = container\n    resizeFn = (width, height) => {\n      container.setPosition(width / 2, height / 2)\n    }\n  }\n\n  const createGradientBackground = () => {\n    const color1 = bgConfig.color ?? 0x4a9eff\n    const color2 = bgConfig.colorSecondary ?? 0x6b4aff\n    const opacity = bgConfig.opacity ?? 0.2\n\n    const createGradientTexture = (width: number, height: number) =>\n      createCanvasTexture(scene, width, height, (ctx, textureWidth, textureHeight) => {\n        const gradient = ctx.createLinearGradient(0, 0, 0, textureHeight)\n        gradient.addColorStop(0, colorToCss(color1))\n        gradient.addColorStop(1, colorToCss(color2))\n\n        ctx.globalAlpha = opacity\n        ctx.fillStyle = gradient\n        ctx.fillRect(0, 0, textureWidth, textureHeight)\n      })\n\n    let textureKey = createGradientTexture(scene.scale.width, scene.scale.height)\n    textureKeys.add(textureKey)\n\n    const image = scene.add.image(0, 0, textureKey)\n    image.setOrigin(0, 0)\n\n    resizeFn = (width, height) => {\n      const previousTextureKey = textureKey\n      textureKey = createGradientTexture(width, height)\n      textureKeys.add(textureKey)\n      image.setTexture(textureKey)\n      image.setDisplaySize(width, height)\n      textureKeys.delete(previousTextureKey)\n      removeTexture(scene, previousTextureKey)\n    }\n\n    background = image\n  }\n\n  const createParticlesBackground = () => {\n    const container = scene.add.container(0, 0)\n    const particleCount = 20\n    const color = bgConfig.color ?? 0x4a9eff\n    const opacity = bgConfig.opacity ?? 0.1\n    const particles: Phaser.GameObjects.Arc[] = []\n\n    for (let i = 0; i < particleCount; i += 1) {\n      const size = Phaser.Math.Between(2, 6)\n      const x = Phaser.Math.Between(0, scene.scale.width)\n      const y = Phaser.Math.Between(0, scene.scale.height)\n\n      const particle = scene.add.circle(x, y, size, color, opacity)\n      container.add(particle)\n      particles.push(particle)\n\n      particleTweens.push(\n        scene.tweens.add({\n          targets: particle,\n          y: particle.y + Phaser.Math.Between(-50, 50),\n          x: particle.x + Phaser.Math.Between(-50, 50),\n          alpha: opacity * 1.5,\n          duration: Phaser.Math.Between(2000, 4000),\n          yoyo: true,\n          repeat: -1,\n          ease: 'Sine.easeInOut',\n        })\n      )\n    }\n\n    background = container\n    resizeFn = (width, height) => {\n      for (const particle of particles) {\n        particle.setPosition(Phaser.Math.Between(0, width), Phaser.Math.Between(0, height))\n      }\n    }\n  }\n\n  switch (bgConfig.type) {\n    case 'grid':\n      createGridBackground()\n      break\n    case 'logo':\n      createLogoBackground()\n      break\n    case 'gradient':\n      createGradientBackground()\n      break\n    case 'particles':\n      createParticlesBackground()\n      break\n  }\n\n  if (!background) return null\n\n  if (bgConfig.animation && bgConfig.animation !== 'static') {\n    backgroundTween = applyAnimation(scene, background, bgConfig.animation)\n  }\n\n  const onResize = () => {\n    if (resizeFn) resizeFn(scene.scale.width, scene.scale.height)\n  }\n\n  const cleanup = () => {\n    if (destroyed) return\n    destroyed = true\n\n    backgroundTween?.stop()\n    for (const tween of particleTweens) {\n      tween.stop()\n    }\n\n    background?.destroy()\n    background = undefined\n    for (const textureKey of textureKeys) {\n      removeTexture(scene, textureKey)\n    }\n    textureKeys.clear()\n\n    scene.scale.off(Phaser.Scale.Events.RESIZE, onResize)\n    scene.events.off(Phaser.Scenes.Events.SHUTDOWN, cleanup)\n    scene.events.off(Phaser.Scenes.Events.DESTROY, cleanup)\n  }\n\n  scene.scale.on(Phaser.Scale.Events.RESIZE, onResize)\n  scene.events.once(Phaser.Scenes.Events.SHUTDOWN, cleanup)\n  scene.events.once(Phaser.Scenes.Events.DESTROY, cleanup)\n\n  return {\n    background,\n    destroy: cleanup,\n    resize: (width, height) => {\n      if (resizeFn) resizeFn(width, height)\n    },\n  }\n}\n\nfunction applyAnimation(\n  scene: Phaser.Scene,\n  target: BackgroundTarget,\n  animation: BackgroundAnimation\n): Phaser.Tweens.Tween | undefined {\n  const redrawFn = (target as RedrawableTarget).__redrawFn\n\n  switch (animation) {\n    case 'lemniscate':\n      return redrawFn ? animateLemniscate(scene, redrawFn) : animatePulse(scene, target)\n    case 'wave':\n      return redrawFn ? animateWave(scene, redrawFn) : animatePulse(scene, target)\n    case 'pulse':\n      return animatePulse(scene, target)\n    case 'rotate':\n      return animateRotate(scene, target)\n    case 'static':\n    default:\n      return undefined\n  }\n}\n\nfunction animateLemniscate(\n  scene: Phaser.Scene,\n  drawFn: (x: number, y: number) => void\n): Phaser.Tweens.Tween {\n  const amplitude = 30\n  const duration = 8000\n\n  return scene.tweens.addCounter({\n    from: 0,\n    to: Math.PI * 2,\n    duration,\n    repeat: -1,\n    onUpdate: (tween) => {\n      const t = tween.getValue()\n      if (t !== null) {\n        const offsetX = amplitude * Math.cos(t)\n        const offsetY = (amplitude * Math.sin(2 * t)) / 2\n        drawFn(offsetX, offsetY)\n      }\n    },\n  })\n}\n\nfunction animateWave(\n  scene: Phaser.Scene,\n  drawFn: (x: number, y: number) => void\n): Phaser.Tweens.Tween {\n  return scene.tweens.addCounter({\n    from: 0,\n    to: 40,\n    duration: 3000,\n    yoyo: true,\n    repeat: -1,\n    onUpdate: (tween) => {\n      const offset = tween.getValue()\n      if (offset !== null) {\n        drawFn(offset, 0)\n      }\n    },\n  })\n}\n\nfunction animatePulse(scene: Phaser.Scene, target: BackgroundTarget): Phaser.Tweens.Tween {\n  return scene.tweens.add({\n    targets: target,\n    scaleX: 1.1,\n    scaleY: 1.1,\n    duration: 2000,\n    yoyo: true,\n    repeat: -1,\n    ease: 'Sine.easeInOut',\n  })\n}\n\nfunction animateRotate(scene: Phaser.Scene, target: BackgroundTarget): Phaser.Tweens.Tween {\n  return scene.tweens.add({\n    targets: target,\n    angle: 360,\n    duration: 20000,\n    repeat: -1,\n    ease: 'Linear',\n  })\n}\n"],"names":["Phaser"],"mappings":"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"}