@flare-engine/scene 0.4.8 → 0.4.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @flare-engine/scene
2
2
 
3
- Scene lifecycle + transitions — `SceneManager` with `register` / `go(name, data?)` / `push` / `pop`, `Scene` interface (`onPreload` / `onInit` / `onEnter` / `onUpdate` / `onDraw` / `onExit` / `onDestroy`), and three transition factories (`noneTransition`, `fadeTransition`, `slideTransition`).
3
+ Scene lifecycle + transitions — `SceneManager` with `register` / `go(name, data?)` / `push(name, data?, { overlay? })` / `pop` (an overlay keeps the scene below live, drawn beneath it), `Scene` interface (`onPreload` / `onInit` / `onEnter` / `onUpdate` / `onDraw` / `onExit` / `onDestroy`), and three transition factories (`noneTransition`, `fadeTransition`, `slideTransition`).
4
4
 
5
5
  ## Install
6
6
 
package/dist/index.d.mts CHANGED
@@ -24,7 +24,11 @@ interface Scene {
24
24
  onDraw?(): void;
25
25
  /** Called when the scene is deactivated (pushed or replaced). */
26
26
  onExit?(): void;
27
- /** Called when the scene is permanently removed. Cleanup resources. */
27
+ /**
28
+ * Called when the scene is permanently removed. Cleanup resources. Can also follow `onPreload`
29
+ * with no `onInit` in between — a target superseded by another `go()` during a fade-out, or
30
+ * still pending at `destroy()` — possibly while the `onPreload` promise is still unresolved.
31
+ */
28
32
  onDestroy?(): void;
29
33
  }
30
34
  /**
@@ -68,20 +72,34 @@ export declare function fadeTransition(duration?: number, easing?: EasingFn): Tr
68
72
  * Default direction is 'left' (outgoing scene slides off to the left, incoming enters from the right).
69
73
  */
70
74
  export declare function slideTransition(duration?: number, direction?: SlideDirection, easing?: EasingFn): Transition;
75
+ interface ScenePushOptions {
76
+ /** Keep the scene below live: it is updated and drawn first, gets no `onExit` on push and no `onEnter` on the matching `pop()`. */
77
+ overlay?: boolean;
78
+ }
79
+ interface ScenePopOptions {
80
+ /** Keep the popped scene initialized: it gets `onExit` only, and the next `push` of its name goes straight to `onEnter`. */
81
+ keep?: boolean;
82
+ /** Forwarded to the revealed scene's `onEnter` (dropped when the popped scene was an overlay). */
83
+ data?: unknown;
84
+ }
71
85
  /**
72
86
  * SceneManager — manages scene registration, navigation, and a scene stack.
73
87
  *
74
88
  * - `register(name, factory)` — register a scene factory
75
89
  * - `go(name, data?)` — switch to a scene (clears the stack)
76
- * - `push(name, data?)` — push a scene onto the stack (pauses current)
77
- * - `pop()` — pop the top scene and resume the one below
78
- * - `update(dt)` — update the active scene and any active transition
90
+ * - `push(name, data?, options?)` — push a scene onto the stack (pauses current unless `options.overlay`)
91
+ * - `pop(options?)` — pop the top scene and resume the one below (destroys it unless `options.keep`)
92
+ * - `update(dt)` — update the live scenes (bottom-up) and any active transition
79
93
  */
80
94
  export declare class SceneManager {
81
95
  private _factories;
82
96
  private _scenes;
83
97
  private _initialized;
84
98
  private _stack;
99
+ /** Parallel to `_stack`: whether the scene at that index was pushed as an overlay. */
100
+ private _overlay;
101
+ /** Scenes popped with `keep: true`: initialized and cached, but off the stack until pushed again. */
102
+ private _kept;
85
103
  private _transition;
86
104
  private _transitionState;
87
105
  private _pendingScene;
@@ -102,16 +120,24 @@ export declare class SceneManager {
102
120
  * Navigate to a scene by name. Clears the entire stack.
103
121
  * Calls onExit on the current scene, onDestroy on all stacked scenes,
104
122
  * then onPreload → onInit → onEnter on the new scene.
123
+ * A `go()` issued while an animated `go()` is still fading out supersedes
124
+ * it: the superseded target gets `onDestroy` (never `onInit` / `onEnter`).
105
125
  */
106
126
  go(name: string, data?: unknown): Promise<void>;
107
127
  /**
108
- * Push a scene onto the stack. The current scene gets onExit.
109
- * The new scene gets onPreload → onInit → onEnter.
128
+ * Push a scene onto the stack. The current scene gets onExit, unless
129
+ * `options.overlay` is true — then it stays live and is updated and drawn
130
+ * before the pushed scene. The new scene gets onPreload → onInit → onEnter.
131
+ */
132
+ push(name: string, data?: unknown, options?: ScenePushOptions): Promise<void>;
133
+ /**
134
+ * Pop the top scene. Calls onExit on it, then onDestroy unless
135
+ * `options.keep` is true — a kept scene stays initialized so the next `push`
136
+ * of its name goes straight to onEnter. The scene below gets
137
+ * onEnter(options.data) unless the popped scene was pushed as an overlay.
110
138
  */
111
- push(name: string, data?: unknown): Promise<void>;
112
- /** Pop the top scene. Calls onExit + onDestroy on it, onEnter on the one below. */
113
- pop(): void;
114
- /** Update the active scene and any active transition. */
139
+ pop(options?: ScenePopOptions): void;
140
+ /** Update the live scenes (bottom-up, overlays last) and any active transition. */
115
141
  update(dt: number): void;
116
142
  /** Destroy all scenes and clear state. */
117
143
  destroy(): void;
@@ -122,9 +148,27 @@ export declare class SceneManager {
122
148
  private _getOrCreate;
123
149
  private _initIfNeeded;
124
150
  private _activateScene;
125
- private _exitAndDestroyCurrent;
151
+ /** Exit and destroy every stacked scene, top first, then empty the stack and destroy the kept scenes. */
152
+ private _teardownStack;
153
+ /**
154
+ * Destroy scenes popped with `keep: true` that were never pushed again. They
155
+ * already got `onExit` on the pop. The cache entry is dropped only when it is
156
+ * still this instance — an animated `go()` to the same name has already
157
+ * replaced it with the pending scene.
158
+ */
159
+ private _destroyKept;
160
+ /**
161
+ * Destroy the target of an animated `go()` that was superseded before its
162
+ * out-phase finished. It got `onPreload` but never `onInit`. Fields are
163
+ * cleared first so a re-entrant call from `onDestroy` cannot destroy twice;
164
+ * an instance someone else still holds (stack, kept set) or has already
165
+ * destroyed (evicted from the cache) is left alone.
166
+ */
167
+ private _discardPending;
126
168
  private _finishOutPhase;
169
+ /** Update then draw each live scene bottom-up: from the lowest scene not under an overlay to the top. */
170
+ private _updateStack;
127
171
  private _updateTransition;
128
172
  }
129
- export type { Scene, SceneFactory, SlideDirection, Transition, TransitionState };
173
+ export type { Scene, SceneFactory, ScenePopOptions, ScenePushOptions, SlideDirection, Transition, TransitionState };
130
174
  //# sourceMappingURL=index.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../src/scene.ts","../src/transition.ts","../src/scene-manager.ts"],"mappings":";;;;;;;UAOiB;;WAEN;;EAGT,OAAO;;EAGP,QAAQ;;EAGR,qBAAqB;;EAGrB;;EAGA,SAAS;;EAGT,UAAU;;EAGV;;EAGA;;EAGA;;;;;;;;;KAUU,gBAAgB,OAAO,OAAO,QAAQ,aAAa;;KCzCnD;;UAGK;;EAEf;;EAEA;;EAEA;;;UAIe;;WAEN;;WAGA;;WAGA,YAAY;;EAGrB,MAAM,sBAAsB;;EAG5B,OAAO,OAAO,iBAAiB,aAAa;;;wBAgC9B,kBAAkB;;wBAgBlB,eAAe,mBAAgB,SAAQ,WAAsB;;;;;wBAmB7D,gBACd,mBACA,YAAW,gBACX,SAAQ,WACP;;;;;;;;;;qBCtFU;UACH;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;;MAGJ,WAAW;;MAKX;;MAKA;;EAKJ,cAAc,YAAY;;EAK1B,SAAS,cAAc,SAAS;;;;;;EAS1B,GAAG,cAAc,iBAAiB;;;;;EA4DlC,KAAK,cAAc,iBAAiB;;EAW1C;;EAaA,OAAO;;EAcP;;MAcI;;MAMA;UAII;UAYM;UAOA;UAgBN;UAWA;UA6BA"}
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../src/scene.ts","../src/transition.ts","../src/scene-manager.ts"],"mappings":";;;;;;;UAOiB;;WAEN;;EAGT,OAAO;;EAGP,QAAQ;;EAGR,qBAAqB;;EAGrB;;EAGA,SAAS;;EAGT,UAAU;;EAGV;;EAGA;;;;;;EAOA;;;;;;;;;KAUU,gBAAgB,OAAO,OAAO,QAAQ,aAAa;;KC7CnD;;UAGK;;EAEf;;EAEA;;EAEA;;;UAIe;;WAEN;;WAGA;;WAGA,YAAY;;EAGrB,MAAM,sBAAsB;;EAG5B,OAAO,OAAO,iBAAiB,aAAa;;;wBAgC9B,kBAAkB;;wBAgBlB,eAAe,mBAAgB,SAAQ,WAAsB;;;;;wBAmB7D,gBACd,mBACA,YAAW,gBACX,SAAQ,WACP;UC/Fc;;EAEf;;UAGe;;EAEf;;EAEA;;;;;;;;;;;qBAYW;UACH;UACA;UACA;UACA;;UAEA;;UAEA;UACA;UACA;UACA;UACA;UACA;UACA;;MAGJ,WAAW;;MAKX;;MAKA;;EAKJ,cAAc,YAAY;;EAK1B,SAAS,cAAc,SAAS;;;;;;;;EAW1B,GAAG,cAAc,iBAAiB;;;;;;EAmElC,KAAK,cAAc,gBAAgB,UAAU,mBAAmB;;;;;;;EAmBtE,IAAI,UAAU;;EAkBd,OAAO;;EAUP;;MASI;;MAMA;UAII;UAYM;UAOA;;UAQN;;;;;;;UAmBA;;;;;;;;UAkBA;UAiBA;;UAwBA;UAYA"}
package/dist/index.d.ts CHANGED
@@ -24,7 +24,11 @@ interface Scene {
24
24
  onDraw?(): void;
25
25
  /** Called when the scene is deactivated (pushed or replaced). */
26
26
  onExit?(): void;
27
- /** Called when the scene is permanently removed. Cleanup resources. */
27
+ /**
28
+ * Called when the scene is permanently removed. Cleanup resources. Can also follow `onPreload`
29
+ * with no `onInit` in between — a target superseded by another `go()` during a fade-out, or
30
+ * still pending at `destroy()` — possibly while the `onPreload` promise is still unresolved.
31
+ */
28
32
  onDestroy?(): void;
29
33
  }
30
34
  /**
@@ -68,20 +72,34 @@ export declare function fadeTransition(duration?: number, easing?: EasingFn): Tr
68
72
  * Default direction is 'left' (outgoing scene slides off to the left, incoming enters from the right).
69
73
  */
70
74
  export declare function slideTransition(duration?: number, direction?: SlideDirection, easing?: EasingFn): Transition;
75
+ interface ScenePushOptions {
76
+ /** Keep the scene below live: it is updated and drawn first, gets no `onExit` on push and no `onEnter` on the matching `pop()`. */
77
+ overlay?: boolean;
78
+ }
79
+ interface ScenePopOptions {
80
+ /** Keep the popped scene initialized: it gets `onExit` only, and the next `push` of its name goes straight to `onEnter`. */
81
+ keep?: boolean;
82
+ /** Forwarded to the revealed scene's `onEnter` (dropped when the popped scene was an overlay). */
83
+ data?: unknown;
84
+ }
71
85
  /**
72
86
  * SceneManager — manages scene registration, navigation, and a scene stack.
73
87
  *
74
88
  * - `register(name, factory)` — register a scene factory
75
89
  * - `go(name, data?)` — switch to a scene (clears the stack)
76
- * - `push(name, data?)` — push a scene onto the stack (pauses current)
77
- * - `pop()` — pop the top scene and resume the one below
78
- * - `update(dt)` — update the active scene and any active transition
90
+ * - `push(name, data?, options?)` — push a scene onto the stack (pauses current unless `options.overlay`)
91
+ * - `pop(options?)` — pop the top scene and resume the one below (destroys it unless `options.keep`)
92
+ * - `update(dt)` — update the live scenes (bottom-up) and any active transition
79
93
  */
80
94
  export declare class SceneManager {
81
95
  private _factories;
82
96
  private _scenes;
83
97
  private _initialized;
84
98
  private _stack;
99
+ /** Parallel to `_stack`: whether the scene at that index was pushed as an overlay. */
100
+ private _overlay;
101
+ /** Scenes popped with `keep: true`: initialized and cached, but off the stack until pushed again. */
102
+ private _kept;
85
103
  private _transition;
86
104
  private _transitionState;
87
105
  private _pendingScene;
@@ -102,16 +120,24 @@ export declare class SceneManager {
102
120
  * Navigate to a scene by name. Clears the entire stack.
103
121
  * Calls onExit on the current scene, onDestroy on all stacked scenes,
104
122
  * then onPreload → onInit → onEnter on the new scene.
123
+ * A `go()` issued while an animated `go()` is still fading out supersedes
124
+ * it: the superseded target gets `onDestroy` (never `onInit` / `onEnter`).
105
125
  */
106
126
  go(name: string, data?: unknown): Promise<void>;
107
127
  /**
108
- * Push a scene onto the stack. The current scene gets onExit.
109
- * The new scene gets onPreload → onInit → onEnter.
128
+ * Push a scene onto the stack. The current scene gets onExit, unless
129
+ * `options.overlay` is true — then it stays live and is updated and drawn
130
+ * before the pushed scene. The new scene gets onPreload → onInit → onEnter.
131
+ */
132
+ push(name: string, data?: unknown, options?: ScenePushOptions): Promise<void>;
133
+ /**
134
+ * Pop the top scene. Calls onExit on it, then onDestroy unless
135
+ * `options.keep` is true — a kept scene stays initialized so the next `push`
136
+ * of its name goes straight to onEnter. The scene below gets
137
+ * onEnter(options.data) unless the popped scene was pushed as an overlay.
110
138
  */
111
- push(name: string, data?: unknown): Promise<void>;
112
- /** Pop the top scene. Calls onExit + onDestroy on it, onEnter on the one below. */
113
- pop(): void;
114
- /** Update the active scene and any active transition. */
139
+ pop(options?: ScenePopOptions): void;
140
+ /** Update the live scenes (bottom-up, overlays last) and any active transition. */
115
141
  update(dt: number): void;
116
142
  /** Destroy all scenes and clear state. */
117
143
  destroy(): void;
@@ -122,9 +148,27 @@ export declare class SceneManager {
122
148
  private _getOrCreate;
123
149
  private _initIfNeeded;
124
150
  private _activateScene;
125
- private _exitAndDestroyCurrent;
151
+ /** Exit and destroy every stacked scene, top first, then empty the stack and destroy the kept scenes. */
152
+ private _teardownStack;
153
+ /**
154
+ * Destroy scenes popped with `keep: true` that were never pushed again. They
155
+ * already got `onExit` on the pop. The cache entry is dropped only when it is
156
+ * still this instance — an animated `go()` to the same name has already
157
+ * replaced it with the pending scene.
158
+ */
159
+ private _destroyKept;
160
+ /**
161
+ * Destroy the target of an animated `go()` that was superseded before its
162
+ * out-phase finished. It got `onPreload` but never `onInit`. Fields are
163
+ * cleared first so a re-entrant call from `onDestroy` cannot destroy twice;
164
+ * an instance someone else still holds (stack, kept set) or has already
165
+ * destroyed (evicted from the cache) is left alone.
166
+ */
167
+ private _discardPending;
126
168
  private _finishOutPhase;
169
+ /** Update then draw each live scene bottom-up: from the lowest scene not under an overlay to the top. */
170
+ private _updateStack;
127
171
  private _updateTransition;
128
172
  }
129
- export type { Scene, SceneFactory, SlideDirection, Transition, TransitionState };
173
+ export type { Scene, SceneFactory, ScenePopOptions, ScenePushOptions, SlideDirection, Transition, TransitionState };
130
174
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","names":[],"sources":["../src/scene.ts","../src/transition.ts","../src/scene-manager.ts"],"mappings":";;;;;;;UAOiB;;WAEN;;EAGT,OAAO;;EAGP,QAAQ;;EAGR,qBAAqB;;EAGrB;;EAGA,SAAS;;EAGT,UAAU;;EAGV;;EAGA;;EAGA;;;;;;;;;KAUU,gBAAgB,OAAO,OAAO,QAAQ,aAAa;;KCzCnD;;UAGK;;EAEf;;EAEA;;EAEA;;;UAIe;;WAEN;;WAGA;;WAGA,YAAY;;EAGrB,MAAM,sBAAsB;;EAG5B,OAAO,OAAO,iBAAiB,aAAa;;;wBAgC9B,kBAAkB;;wBAgBlB,eAAe,mBAAgB,SAAQ,WAAsB;;;;;wBAmB7D,gBACd,mBACA,YAAW,gBACX,SAAQ,WACP;;;;;;;;;;qBCtFU;UACH;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;;MAGJ,WAAW;;MAKX;;MAKA;;EAKJ,cAAc,YAAY;;EAK1B,SAAS,cAAc,SAAS;;;;;;EAS1B,GAAG,cAAc,iBAAiB;;;;;EA4DlC,KAAK,cAAc,iBAAiB;;EAW1C;;EAaA,OAAO;;EAcP;;MAcI;;MAMA;UAII;UAYM;UAOA;UAgBN;UAWA;UA6BA"}
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../src/scene.ts","../src/transition.ts","../src/scene-manager.ts"],"mappings":";;;;;;;UAOiB;;WAEN;;EAGT,OAAO;;EAGP,QAAQ;;EAGR,qBAAqB;;EAGrB;;EAGA,SAAS;;EAGT,UAAU;;EAGV;;EAGA;;;;;;EAOA;;;;;;;;;KAUU,gBAAgB,OAAO,OAAO,QAAQ,aAAa;;KC7CnD;;UAGK;;EAEf;;EAEA;;EAEA;;;UAIe;;WAEN;;WAGA;;WAGA,YAAY;;EAGrB,MAAM,sBAAsB;;EAG5B,OAAO,OAAO,iBAAiB,aAAa;;;wBAgC9B,kBAAkB;;wBAgBlB,eAAe,mBAAgB,SAAQ,WAAsB;;;;;wBAmB7D,gBACd,mBACA,YAAW,gBACX,SAAQ,WACP;UC/Fc;;EAEf;;UAGe;;EAEf;;EAEA;;;;;;;;;;;qBAYW;UACH;UACA;UACA;UACA;;UAEA;;UAEA;UACA;UACA;UACA;UACA;UACA;UACA;;MAGJ,WAAW;;MAKX;;MAKA;;EAKJ,cAAc,YAAY;;EAK1B,SAAS,cAAc,SAAS;;;;;;;;EAW1B,GAAG,cAAc,iBAAiB;;;;;;EAmElC,KAAK,cAAc,gBAAgB,UAAU,mBAAmB;;;;;;;EAmBtE,IAAI,UAAU;;EAkBd,OAAO;;EAUP;;MASI;;MAMA;UAII;UAYM;UAOA;;UAQN;;;;;;;UAmBA;;;;;;;;UAkBA;UAiBA;;UAwBA;UAYA"}
package/dist/index.js CHANGED
@@ -93,15 +93,19 @@ function slideTransition(duration = .3, direction = "left", easing = identity) {
93
93
  *
94
94
  * - `register(name, factory)` — register a scene factory
95
95
  * - `go(name, data?)` — switch to a scene (clears the stack)
96
- * - `push(name, data?)` — push a scene onto the stack (pauses current)
97
- * - `pop()` — pop the top scene and resume the one below
98
- * - `update(dt)` — update the active scene and any active transition
96
+ * - `push(name, data?, options?)` — push a scene onto the stack (pauses current unless `options.overlay`)
97
+ * - `pop(options?)` — pop the top scene and resume the one below (destroys it unless `options.keep`)
98
+ * - `update(dt)` — update the live scenes (bottom-up) and any active transition
99
99
  */
100
100
  var SceneManager = class {
101
101
  _factories = /* @__PURE__ */ new Map();
102
102
  _scenes = /* @__PURE__ */ new Map();
103
103
  _initialized = /* @__PURE__ */ new Set();
104
104
  _stack = [];
105
+ /** Parallel to `_stack`: whether the scene at that index was pushed as an overlay. */
106
+ _overlay = [];
107
+ /** Scenes popped with `keep: true`: initialized and cached, but off the stack until pushed again. */
108
+ _kept = /* @__PURE__ */ new Set();
105
109
  _transition = noneTransition();
106
110
  _transitionState = null;
107
111
  _pendingScene = null;
@@ -132,6 +136,8 @@ var SceneManager = class {
132
136
  * Navigate to a scene by name. Clears the entire stack.
133
137
  * Calls onExit on the current scene, onDestroy on all stacked scenes,
134
138
  * then onPreload → onInit → onEnter on the new scene.
139
+ * A `go()` issued while an animated `go()` is still fading out supersedes
140
+ * it: the superseded target gets `onDestroy` (never `onInit` / `onEnter`).
135
141
  */
136
142
  async go(name, data) {
137
143
  if (!this._factories.has(name)) {
@@ -139,6 +145,7 @@ var SceneManager = class {
139
145
  return;
140
146
  }
141
147
  if (this._transition.duration > 0 && this.current) {
148
+ this._discardPending();
142
149
  this._scenes.delete(name);
143
150
  this._initialized.delete(name);
144
151
  const scene = this._getOrCreate(name);
@@ -161,57 +168,63 @@ var SceneManager = class {
161
168
  });
162
169
  this._transitionState = this._transition.start("out");
163
170
  } else {
164
- this._exitAndDestroyCurrent();
171
+ this._discardPending();
172
+ this._transitionState = null;
173
+ this._teardownStack();
165
174
  const scene = this._getOrCreate(name);
166
175
  await this._activateScene(scene, data);
167
176
  }
168
177
  }
169
178
  /**
170
- * Push a scene onto the stack. The current scene gets onExit.
171
- * The new scene gets onPreload → onInit → onEnter.
179
+ * Push a scene onto the stack. The current scene gets onExit, unless
180
+ * `options.overlay` is true — then it stays live and is updated and drawn
181
+ * before the pushed scene. The new scene gets onPreload → onInit → onEnter.
172
182
  */
173
- async push(name, data) {
183
+ async push(name, data, options) {
174
184
  const scene = this._getOrCreate(name);
175
185
  if (!scene) return;
176
- this.current?.onExit?.();
186
+ const overlay = options?.overlay === true;
187
+ if (!overlay) this.current?.onExit?.();
177
188
  await this._initIfNeeded(scene);
189
+ this._kept.delete(scene);
178
190
  this._stack.push(scene);
191
+ this._overlay.push(overlay);
179
192
  scene.onEnter?.(data);
180
193
  }
181
- /** Pop the top scene. Calls onExit + onDestroy on it, onEnter on the one below. */
182
- pop() {
194
+ /**
195
+ * Pop the top scene. Calls onExit on it, then onDestroy unless
196
+ * `options.keep` is true — a kept scene stays initialized so the next `push`
197
+ * of its name goes straight to onEnter. The scene below gets
198
+ * onEnter(options.data) unless the popped scene was pushed as an overlay.
199
+ */
200
+ pop(options) {
183
201
  if (this._stack.length <= 1) return;
184
202
  const top = this._stack.pop();
203
+ const wasOverlay = this._overlay.pop() === true;
185
204
  top.onExit?.();
186
- top.onDestroy?.();
187
- this._scenes.delete(top.name);
188
- this._initialized.delete(top.name);
189
- this.current?.onEnter?.();
205
+ if (options?.keep === true) this._kept.add(top);
206
+ else {
207
+ top.onDestroy?.();
208
+ this._scenes.delete(top.name);
209
+ this._initialized.delete(top.name);
210
+ }
211
+ if (!wasOverlay) this.current?.onEnter?.(options?.data);
190
212
  }
191
- /** Update the active scene and any active transition. */
213
+ /** Update the live scenes (bottom-up, overlays last) and any active transition. */
192
214
  update(dt) {
193
215
  if (this._transitionState) {
194
216
  this._updateTransition(dt);
195
217
  return;
196
218
  }
197
- const scene = this.current;
198
- if (scene) {
199
- scene.onUpdate?.(dt);
200
- scene.onDraw?.();
201
- }
219
+ this._updateStack(dt);
202
220
  }
203
221
  /** Destroy all scenes and clear state. */
204
222
  destroy() {
205
- for (let i = this._stack.length - 1; i >= 0; i--) {
206
- const scene = this._stack[i];
207
- scene.onExit?.();
208
- scene.onDestroy?.();
209
- }
210
- this._stack.length = 0;
223
+ this._discardPending();
224
+ this._teardownStack();
211
225
  this._scenes.clear();
212
226
  this._initialized.clear();
213
227
  this._transitionState = null;
214
- this._pendingScene = null;
215
228
  }
216
229
  /** Get the transition progress (0–1) for rendering. 0 during 'out', 1 when done. */
217
230
  get transitionProgress() {
@@ -238,19 +251,13 @@ var SceneManager = class {
238
251
  scene.onInit?.();
239
252
  }
240
253
  async _activateScene(scene, data) {
241
- for (let i = this._stack.length - 1; i >= 0; i--) {
242
- const s = this._stack[i];
243
- s.onExit?.();
244
- s.onDestroy?.();
245
- this._scenes.delete(s.name);
246
- this._initialized.delete(s.name);
247
- }
248
- this._stack.length = 0;
249
254
  await this._initIfNeeded(scene);
250
255
  this._stack.push(scene);
256
+ this._overlay.push(false);
251
257
  scene.onEnter?.(data);
252
258
  }
253
- _exitAndDestroyCurrent() {
259
+ /** Exit and destroy every stacked scene, top first, then empty the stack and destroy the kept scenes. */
260
+ _teardownStack() {
254
261
  for (let i = this._stack.length - 1; i >= 0; i--) {
255
262
  const s = this._stack[i];
256
263
  s.onExit?.();
@@ -259,6 +266,41 @@ var SceneManager = class {
259
266
  this._initialized.delete(s.name);
260
267
  }
261
268
  this._stack.length = 0;
269
+ this._overlay.length = 0;
270
+ this._destroyKept();
271
+ }
272
+ /**
273
+ * Destroy scenes popped with `keep: true` that were never pushed again. They
274
+ * already got `onExit` on the pop. The cache entry is dropped only when it is
275
+ * still this instance — an animated `go()` to the same name has already
276
+ * replaced it with the pending scene.
277
+ */
278
+ _destroyKept() {
279
+ for (const s of this._kept) {
280
+ s.onDestroy?.();
281
+ if (this._scenes.get(s.name) === s) {
282
+ this._scenes.delete(s.name);
283
+ this._initialized.delete(s.name);
284
+ }
285
+ }
286
+ this._kept.clear();
287
+ }
288
+ /**
289
+ * Destroy the target of an animated `go()` that was superseded before its
290
+ * out-phase finished. It got `onPreload` but never `onInit`. Fields are
291
+ * cleared first so a re-entrant call from `onDestroy` cannot destroy twice;
292
+ * an instance someone else still holds (stack, kept set) or has already
293
+ * destroyed (evicted from the cache) is left alone.
294
+ */
295
+ _discardPending() {
296
+ const pending = this._pendingScene;
297
+ if (!pending) return;
298
+ this._pendingScene = null;
299
+ this._pendingData = void 0;
300
+ if (this._scenes.get(pending.name) !== pending || this._stack.includes(pending) || this._kept.has(pending)) return;
301
+ pending.onDestroy?.();
302
+ this._scenes.delete(pending.name);
303
+ this._initialized.delete(pending.name);
262
304
  }
263
305
  _finishOutPhase() {
264
306
  if (!this._transitionState?.done || this._transitionState.phase !== "out") return;
@@ -267,37 +309,41 @@ var SceneManager = class {
267
309
  this._pendingScene = null;
268
310
  this._pendingData = void 0;
269
311
  if (pending) {
270
- for (let i = this._stack.length - 1; i >= 0; i--) {
271
- const s = this._stack[i];
272
- s.onExit?.();
273
- s.onDestroy?.();
274
- this._scenes.delete(s.name);
275
- this._initialized.delete(s.name);
276
- }
277
- this._stack.length = 0;
312
+ this._teardownStack();
278
313
  this._scenes.set(pending.name, pending);
279
314
  this._initialized.add(pending.name);
280
315
  pending.onInit?.();
281
316
  this._stack.push(pending);
317
+ this._overlay.push(false);
282
318
  pending.onEnter?.(data);
283
319
  }
284
320
  this._transitionState = this._transition.start("in");
285
321
  }
322
+ /** Update then draw each live scene bottom-up: from the lowest scene not under an overlay to the top. */
323
+ _updateStack(dt) {
324
+ const stack = this._stack;
325
+ let from = stack.length - 1;
326
+ if (from < 0) return;
327
+ while (from > 0 && this._overlay[from]) from--;
328
+ for (let i = from; i < stack.length; i++) {
329
+ const scene = stack[i];
330
+ scene.onUpdate?.(dt);
331
+ scene.onDraw?.();
332
+ }
333
+ }
286
334
  _updateTransition(dt) {
287
335
  if (!this._transitionState) return;
288
336
  this._transition.update(this._transitionState, dt);
289
337
  if (this._transitionState.done) {
290
338
  if (this._transitionState.phase === "out") {
291
339
  if (!this._preloadResolved) {
292
- this.current?.onUpdate?.(dt);
293
- this.current?.onDraw?.();
340
+ this._updateStack(dt);
294
341
  return;
295
342
  }
296
343
  this._finishOutPhase();
297
344
  } else this._transitionState = null;
298
345
  }
299
- this.current?.onUpdate?.(dt);
300
- this.current?.onDraw?.();
346
+ this._updateStack(dt);
301
347
  }
302
348
  };
303
349
  exports.SceneManager = SceneManager;
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":["World","Camera2D"],"sources":["../src/transition.ts","../src/scene-manager.ts"],"sourcesContent":["import type { EasingFn } from '@flare-engine/math';\n\nexport type { EasingFn };\n\n/** Slide direction — where the outgoing scene moves off-screen to. */\nexport type SlideDirection = 'left' | 'right' | 'up' | 'down';\n\n/** Transition state during a scene switch. */\nexport interface TransitionState {\n /** Progress 0 → 1. */\n progress: number;\n /** Whether the transition is complete. */\n done: boolean;\n /** Phase: 'out' = leaving scene fading out, 'in' = entering scene fading in. */\n phase: 'out' | 'in';\n}\n\n/** A transition controls the visual blending between two scenes. */\nexport interface Transition {\n /** Discriminator for consumers that apply a visual effect (alpha, translate, etc.). */\n readonly kind: 'none' | 'fade' | 'slide';\n\n /** Duration in seconds for each phase (out + in). */\n readonly duration: number;\n\n /** For slide transitions, the direction the outgoing scene slides toward. */\n readonly direction?: SlideDirection;\n\n /** Start the transition. */\n start(phase: 'out' | 'in'): TransitionState;\n\n /** Update the transition by dt seconds. Returns the updated state. */\n update(state: TransitionState, dt: number): TransitionState;\n}\n\nconst identity: EasingFn = (t) => t;\n\n/**\n * Returns a stateful advance function that tracks raw (linear) progress in its\n * own closure so the easing function is applied without accumulating drift.\n * Call `reset()` when starting a new transition phase.\n */\nfunction makeAdvancer(duration: number, easing: EasingFn) {\n let raw = 0;\n return {\n reset() {\n raw = 0;\n },\n advance(state: TransitionState, dt: number): TransitionState {\n if (state.done) return state;\n raw += dt / duration;\n if (raw >= 1) {\n raw = 1;\n state.progress = 1;\n state.done = true;\n } else {\n state.progress = easing(raw);\n }\n return state;\n },\n };\n}\n\n/** No transition — instant scene switch. */\nexport function noneTransition(): Transition {\n return {\n kind: 'none',\n duration: 0,\n start(phase) {\n return { progress: 1, done: true, phase };\n },\n update(state) {\n state.progress = 1;\n state.done = true;\n return state;\n },\n };\n}\n\n/** Fade transition — consumer interprets `progress` as alpha. */\nexport function fadeTransition(duration = 0.3, easing: EasingFn = identity): Transition {\n const advancer = makeAdvancer(duration, easing);\n return {\n kind: 'fade',\n duration,\n start(phase) {\n advancer.reset();\n return { progress: 0, done: false, phase };\n },\n update(state, dt) {\n return advancer.advance(state, dt);\n },\n };\n}\n\n/**\n * Slide transition — consumer interprets `progress` as a 0→1 offset along `direction`.\n * Default direction is 'left' (outgoing scene slides off to the left, incoming enters from the right).\n */\nexport function slideTransition(\n duration = 0.3,\n direction: SlideDirection = 'left',\n easing: EasingFn = identity,\n): Transition {\n const advancer = makeAdvancer(duration, easing);\n return {\n kind: 'slide',\n duration,\n direction,\n start(phase) {\n advancer.reset();\n return { progress: 0, done: false, phase };\n },\n update(state, dt) {\n return advancer.advance(state, dt);\n },\n };\n}\n","import { World } from '@flare-engine/ecs';\nimport { Camera2D } from '@flare-engine/render';\nimport type { Scene, SceneFactory } from './scene.js';\nimport type { Transition, TransitionState } from './transition.js';\nimport { noneTransition } from './transition.js';\n\ndeclare const __DEV__: boolean | undefined;\n\n/**\n * SceneManager — manages scene registration, navigation, and a scene stack.\n *\n * - `register(name, factory)` — register a scene factory\n * - `go(name, data?)` — switch to a scene (clears the stack)\n * - `push(name, data?)` — push a scene onto the stack (pauses current)\n * - `pop()` — pop the top scene and resume the one below\n * - `update(dt)` — update the active scene and any active transition\n */\nexport class SceneManager {\n private _factories = new Map<string, SceneFactory>();\n private _scenes = new Map<string, Scene>();\n private _initialized = new Set<string>();\n private _stack: Scene[] = [];\n private _transition: Transition = noneTransition();\n private _transitionState: TransitionState | null = null;\n private _pendingScene: Scene | null = null;\n private _pendingData: unknown = undefined;\n private _preloadResolved = true;\n private _preloadGen = 0;\n\n /** The currently active scene (top of stack). */\n get current(): Scene | undefined {\n return this._stack.length > 0 ? this._stack[this._stack.length - 1] : undefined;\n }\n\n /** Number of scenes on the stack. */\n get stackSize(): number {\n return this._stack.length;\n }\n\n /** Whether a transition is currently in progress. */\n get isTransitioning(): boolean {\n return this._transitionState !== null;\n }\n\n /** Set the default transition for scene switches. */\n setTransition(transition: Transition): void {\n this._transition = transition;\n }\n\n /** Register a scene factory by name. */\n register(name: string, factory: SceneFactory): void {\n this._factories.set(name, factory);\n }\n\n /**\n * Navigate to a scene by name. Clears the entire stack.\n * Calls onExit on the current scene, onDestroy on all stacked scenes,\n * then onPreload → onInit → onEnter on the new scene.\n */\n async go(name: string, data?: unknown): Promise<void> {\n if (!this._factories.has(name)) {\n if (typeof __DEV__ !== 'undefined' && __DEV__) {\n console.warn(\n `[SceneManager] go('${name}'): scene not registered. Registered: ${[...this._factories.keys()].join(', ')}`,\n );\n }\n return;\n }\n\n if (this._transition.duration > 0 && this.current) {\n // Animated transition — evict target from cache first so restart\n // builds a fresh instance with a fresh World/Camera2D.\n this._scenes.delete(name);\n this._initialized.delete(name);\n const scene = this._getOrCreate(name)!;\n this._pendingScene = scene;\n this._pendingData = data;\n\n // Start preload concurrently with the fade-out.\n this._initialized.add(scene.name);\n this._preloadResolved = false;\n const gen = ++this._preloadGen;\n const preload = scene.onPreload?.();\n if (preload == null) {\n this._preloadResolved = true;\n } else {\n void preload.then(\n () => {\n if (gen !== this._preloadGen) return;\n this._preloadResolved = true;\n this._finishOutPhase();\n },\n (err) => {\n if (gen !== this._preloadGen) return;\n this._preloadResolved = true;\n if (typeof __DEV__ !== 'undefined' && __DEV__) {\n console.error(\n `[SceneManager] onPreload('${scene.name}') rejected; entering scene anyway`,\n err,\n );\n }\n this._finishOutPhase();\n },\n );\n }\n\n this._transitionState = this._transition.start('out');\n } else {\n // Instant transition — destroy first so _getOrCreate builds fresh.\n this._exitAndDestroyCurrent();\n const scene = this._getOrCreate(name)!;\n await this._activateScene(scene, data);\n }\n }\n\n /**\n * Push a scene onto the stack. The current scene gets onExit.\n * The new scene gets onPreload → onInit → onEnter.\n */\n async push(name: string, data?: unknown): Promise<void> {\n const scene = this._getOrCreate(name);\n if (!scene) return;\n\n this.current?.onExit?.();\n await this._initIfNeeded(scene);\n this._stack.push(scene);\n scene.onEnter?.(data);\n }\n\n /** Pop the top scene. Calls onExit + onDestroy on it, onEnter on the one below. */\n pop(): void {\n if (this._stack.length <= 1) return;\n\n const top = this._stack.pop()!;\n top.onExit?.();\n top.onDestroy?.();\n this._scenes.delete(top.name);\n this._initialized.delete(top.name);\n\n this.current?.onEnter?.();\n }\n\n /** Update the active scene and any active transition. */\n update(dt: number): void {\n if (this._transitionState) {\n this._updateTransition(dt);\n return;\n }\n\n const scene = this.current;\n if (scene) {\n scene.onUpdate?.(dt);\n scene.onDraw?.();\n }\n }\n\n /** Destroy all scenes and clear state. */\n destroy(): void {\n for (let i = this._stack.length - 1; i >= 0; i--) {\n const scene = this._stack[i]!;\n scene.onExit?.();\n scene.onDestroy?.();\n }\n this._stack.length = 0;\n this._scenes.clear();\n this._initialized.clear();\n this._transitionState = null;\n this._pendingScene = null;\n }\n\n /** Get the transition progress (0–1) for rendering. 0 during 'out', 1 when done. */\n get transitionProgress(): number {\n if (!this._transitionState) return 0;\n return this._transitionState.progress;\n }\n\n /** Get the current transition phase. */\n get transitionPhase(): 'out' | 'in' | null {\n return this._transitionState?.phase ?? null;\n }\n\n private _getOrCreate(name: string): Scene | null {\n let scene = this._scenes.get(name);\n if (scene) return scene;\n\n const factory = this._factories.get(name);\n if (!factory) return null;\n\n scene = factory(new World(), new Camera2D());\n this._scenes.set(name, scene);\n return scene;\n }\n\n private async _initIfNeeded(scene: Scene): Promise<void> {\n if (this._initialized.has(scene.name)) return;\n this._initialized.add(scene.name);\n await scene.onPreload?.();\n scene.onInit?.();\n }\n\n private async _activateScene(scene: Scene, data?: unknown): Promise<void> {\n // Destroy all stacked scenes\n for (let i = this._stack.length - 1; i >= 0; i--) {\n const s = this._stack[i]!;\n s.onExit?.();\n s.onDestroy?.();\n this._scenes.delete(s.name);\n this._initialized.delete(s.name);\n }\n this._stack.length = 0;\n\n await this._initIfNeeded(scene);\n this._stack.push(scene);\n scene.onEnter?.(data);\n }\n\n private _exitAndDestroyCurrent(): void {\n for (let i = this._stack.length - 1; i >= 0; i--) {\n const s = this._stack[i]!;\n s.onExit?.();\n s.onDestroy?.();\n this._scenes.delete(s.name);\n this._initialized.delete(s.name);\n }\n this._stack.length = 0;\n }\n\n private _finishOutPhase(): void {\n if (!this._transitionState?.done || this._transitionState.phase !== 'out') return;\n\n const pending = this._pendingScene;\n const data = this._pendingData;\n this._pendingScene = null;\n this._pendingData = undefined;\n\n if (pending) {\n for (let i = this._stack.length - 1; i >= 0; i--) {\n const s = this._stack[i]!;\n s.onExit?.();\n s.onDestroy?.();\n this._scenes.delete(s.name);\n this._initialized.delete(s.name);\n }\n this._stack.length = 0;\n\n // Preload already ran in go(); call onInit then enter.\n this._scenes.set(pending.name, pending);\n this._initialized.add(pending.name);\n pending.onInit?.();\n this._stack.push(pending);\n pending.onEnter?.(data);\n }\n\n this._transitionState = this._transition.start('in');\n }\n\n private _updateTransition(dt: number): void {\n if (!this._transitionState) return;\n\n this._transition.update(this._transitionState, dt);\n\n if (this._transitionState.done) {\n if (this._transitionState.phase === 'out') {\n // Hold until preload (started concurrently in go()) resolves.\n if (!this._preloadResolved) {\n this.current?.onUpdate?.(dt);\n this.current?.onDraw?.();\n return;\n }\n\n this._finishOutPhase();\n } else {\n // Phase 'in' done — transition complete\n this._transitionState = null;\n }\n }\n\n // Still update the current scene during transition\n this.current?.onUpdate?.(dt);\n this.current?.onDraw?.();\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":["World","Camera2D"],"sources":["../src/transition.ts","../src/scene-manager.ts"],"sourcesContent":["import type { EasingFn } from '@flare-engine/math';\n\nexport type { EasingFn };\n\n/** Slide direction — where the outgoing scene moves off-screen to. */\nexport type SlideDirection = 'left' | 'right' | 'up' | 'down';\n\n/** Transition state during a scene switch. */\nexport interface TransitionState {\n /** Progress 0 → 1. */\n progress: number;\n /** Whether the transition is complete. */\n done: boolean;\n /** Phase: 'out' = leaving scene fading out, 'in' = entering scene fading in. */\n phase: 'out' | 'in';\n}\n\n/** A transition controls the visual blending between two scenes. */\nexport interface Transition {\n /** Discriminator for consumers that apply a visual effect (alpha, translate, etc.). */\n readonly kind: 'none' | 'fade' | 'slide';\n\n /** Duration in seconds for each phase (out + in). */\n readonly duration: number;\n\n /** For slide transitions, the direction the outgoing scene slides toward. */\n readonly direction?: SlideDirection;\n\n /** Start the transition. */\n start(phase: 'out' | 'in'): TransitionState;\n\n /** Update the transition by dt seconds. Returns the updated state. */\n update(state: TransitionState, dt: number): TransitionState;\n}\n\nconst identity: EasingFn = (t) => t;\n\n/**\n * Returns a stateful advance function that tracks raw (linear) progress in its\n * own closure so the easing function is applied without accumulating drift.\n * Call `reset()` when starting a new transition phase.\n */\nfunction makeAdvancer(duration: number, easing: EasingFn) {\n let raw = 0;\n return {\n reset() {\n raw = 0;\n },\n advance(state: TransitionState, dt: number): TransitionState {\n if (state.done) return state;\n raw += dt / duration;\n if (raw >= 1) {\n raw = 1;\n state.progress = 1;\n state.done = true;\n } else {\n state.progress = easing(raw);\n }\n return state;\n },\n };\n}\n\n/** No transition — instant scene switch. */\nexport function noneTransition(): Transition {\n return {\n kind: 'none',\n duration: 0,\n start(phase) {\n return { progress: 1, done: true, phase };\n },\n update(state) {\n state.progress = 1;\n state.done = true;\n return state;\n },\n };\n}\n\n/** Fade transition — consumer interprets `progress` as alpha. */\nexport function fadeTransition(duration = 0.3, easing: EasingFn = identity): Transition {\n const advancer = makeAdvancer(duration, easing);\n return {\n kind: 'fade',\n duration,\n start(phase) {\n advancer.reset();\n return { progress: 0, done: false, phase };\n },\n update(state, dt) {\n return advancer.advance(state, dt);\n },\n };\n}\n\n/**\n * Slide transition — consumer interprets `progress` as a 0→1 offset along `direction`.\n * Default direction is 'left' (outgoing scene slides off to the left, incoming enters from the right).\n */\nexport function slideTransition(\n duration = 0.3,\n direction: SlideDirection = 'left',\n easing: EasingFn = identity,\n): Transition {\n const advancer = makeAdvancer(duration, easing);\n return {\n kind: 'slide',\n duration,\n direction,\n start(phase) {\n advancer.reset();\n return { progress: 0, done: false, phase };\n },\n update(state, dt) {\n return advancer.advance(state, dt);\n },\n };\n}\n","import { World } from '@flare-engine/ecs';\nimport { Camera2D } from '@flare-engine/render';\nimport type { Scene, SceneFactory } from './scene.js';\nimport type { Transition, TransitionState } from './transition.js';\nimport { noneTransition } from './transition.js';\n\ndeclare const __DEV__: boolean | undefined;\n\nexport interface ScenePushOptions {\n /** Keep the scene below live: it is updated and drawn first, gets no `onExit` on push and no `onEnter` on the matching `pop()`. */\n overlay?: boolean;\n}\n\nexport interface ScenePopOptions {\n /** Keep the popped scene initialized: it gets `onExit` only, and the next `push` of its name goes straight to `onEnter`. */\n keep?: boolean;\n /** Forwarded to the revealed scene's `onEnter` (dropped when the popped scene was an overlay). */\n data?: unknown;\n}\n\n/**\n * SceneManager — manages scene registration, navigation, and a scene stack.\n *\n * - `register(name, factory)` — register a scene factory\n * - `go(name, data?)` — switch to a scene (clears the stack)\n * - `push(name, data?, options?)` — push a scene onto the stack (pauses current unless `options.overlay`)\n * - `pop(options?)` — pop the top scene and resume the one below (destroys it unless `options.keep`)\n * - `update(dt)` — update the live scenes (bottom-up) and any active transition\n */\nexport class SceneManager {\n private _factories = new Map<string, SceneFactory>();\n private _scenes = new Map<string, Scene>();\n private _initialized = new Set<string>();\n private _stack: Scene[] = [];\n /** Parallel to `_stack`: whether the scene at that index was pushed as an overlay. */\n private _overlay: boolean[] = [];\n /** Scenes popped with `keep: true`: initialized and cached, but off the stack until pushed again. */\n private _kept = new Set<Scene>();\n private _transition: Transition = noneTransition();\n private _transitionState: TransitionState | null = null;\n private _pendingScene: Scene | null = null;\n private _pendingData: unknown = undefined;\n private _preloadResolved = true;\n private _preloadGen = 0;\n\n /** The currently active scene (top of stack). */\n get current(): Scene | undefined {\n return this._stack.length > 0 ? this._stack[this._stack.length - 1] : undefined;\n }\n\n /** Number of scenes on the stack. */\n get stackSize(): number {\n return this._stack.length;\n }\n\n /** Whether a transition is currently in progress. */\n get isTransitioning(): boolean {\n return this._transitionState !== null;\n }\n\n /** Set the default transition for scene switches. */\n setTransition(transition: Transition): void {\n this._transition = transition;\n }\n\n /** Register a scene factory by name. */\n register(name: string, factory: SceneFactory): void {\n this._factories.set(name, factory);\n }\n\n /**\n * Navigate to a scene by name. Clears the entire stack.\n * Calls onExit on the current scene, onDestroy on all stacked scenes,\n * then onPreload → onInit → onEnter on the new scene.\n * A `go()` issued while an animated `go()` is still fading out supersedes\n * it: the superseded target gets `onDestroy` (never `onInit` / `onEnter`).\n */\n async go(name: string, data?: unknown): Promise<void> {\n if (!this._factories.has(name)) {\n if (typeof __DEV__ !== 'undefined' && __DEV__) {\n console.warn(\n `[SceneManager] go('${name}'): scene not registered. Registered: ${[...this._factories.keys()].join(', ')}`,\n );\n }\n return;\n }\n\n if (this._transition.duration > 0 && this.current) {\n this._discardPending();\n // Animated transition — evict target from cache first so restart\n // builds a fresh instance with a fresh World/Camera2D.\n this._scenes.delete(name);\n this._initialized.delete(name);\n const scene = this._getOrCreate(name)!;\n this._pendingScene = scene;\n this._pendingData = data;\n\n // Start preload concurrently with the fade-out.\n this._initialized.add(scene.name);\n this._preloadResolved = false;\n const gen = ++this._preloadGen;\n const preload = scene.onPreload?.();\n if (preload == null) {\n this._preloadResolved = true;\n } else {\n void preload.then(\n () => {\n if (gen !== this._preloadGen) return;\n this._preloadResolved = true;\n this._finishOutPhase();\n },\n (err) => {\n if (gen !== this._preloadGen) return;\n this._preloadResolved = true;\n if (typeof __DEV__ !== 'undefined' && __DEV__) {\n console.error(\n `[SceneManager] onPreload('${scene.name}') rejected; entering scene anyway`,\n err,\n );\n }\n this._finishOutPhase();\n },\n );\n }\n\n this._transitionState = this._transition.start('out');\n } else {\n // A pending animated go() is superseded; end any transition in progress\n // too, or _finishOutPhase would later replace the instant scene with the\n // stale target. Its late preload handler is harmless once the state is null.\n this._discardPending();\n this._transitionState = null;\n // Instant transition — destroy first so _getOrCreate builds fresh.\n this._teardownStack();\n const scene = this._getOrCreate(name)!;\n await this._activateScene(scene, data);\n }\n }\n\n /**\n * Push a scene onto the stack. The current scene gets onExit, unless\n * `options.overlay` is true — then it stays live and is updated and drawn\n * before the pushed scene. The new scene gets onPreload → onInit → onEnter.\n */\n async push(name: string, data?: unknown, options?: ScenePushOptions): Promise<void> {\n const scene = this._getOrCreate(name);\n if (!scene) return;\n\n const overlay = options?.overlay === true;\n if (!overlay) this.current?.onExit?.();\n await this._initIfNeeded(scene);\n this._kept.delete(scene);\n this._stack.push(scene);\n this._overlay.push(overlay);\n scene.onEnter?.(data);\n }\n\n /**\n * Pop the top scene. Calls onExit on it, then onDestroy unless\n * `options.keep` is true — a kept scene stays initialized so the next `push`\n * of its name goes straight to onEnter. The scene below gets\n * onEnter(options.data) unless the popped scene was pushed as an overlay.\n */\n pop(options?: ScenePopOptions): void {\n if (this._stack.length <= 1) return;\n\n const top = this._stack.pop()!;\n const wasOverlay = this._overlay.pop() === true;\n top.onExit?.();\n if (options?.keep === true) {\n this._kept.add(top);\n } else {\n top.onDestroy?.();\n this._scenes.delete(top.name);\n this._initialized.delete(top.name);\n }\n\n if (!wasOverlay) this.current?.onEnter?.(options?.data);\n }\n\n /** Update the live scenes (bottom-up, overlays last) and any active transition. */\n update(dt: number): void {\n if (this._transitionState) {\n this._updateTransition(dt);\n return;\n }\n\n this._updateStack(dt);\n }\n\n /** Destroy all scenes and clear state. */\n destroy(): void {\n this._discardPending();\n this._teardownStack();\n this._scenes.clear();\n this._initialized.clear();\n this._transitionState = null;\n }\n\n /** Get the transition progress (0–1) for rendering. 0 during 'out', 1 when done. */\n get transitionProgress(): number {\n if (!this._transitionState) return 0;\n return this._transitionState.progress;\n }\n\n /** Get the current transition phase. */\n get transitionPhase(): 'out' | 'in' | null {\n return this._transitionState?.phase ?? null;\n }\n\n private _getOrCreate(name: string): Scene | null {\n let scene = this._scenes.get(name);\n if (scene) return scene;\n\n const factory = this._factories.get(name);\n if (!factory) return null;\n\n scene = factory(new World(), new Camera2D());\n this._scenes.set(name, scene);\n return scene;\n }\n\n private async _initIfNeeded(scene: Scene): Promise<void> {\n if (this._initialized.has(scene.name)) return;\n this._initialized.add(scene.name);\n await scene.onPreload?.();\n scene.onInit?.();\n }\n\n private async _activateScene(scene: Scene, data?: unknown): Promise<void> {\n await this._initIfNeeded(scene);\n this._stack.push(scene);\n this._overlay.push(false);\n scene.onEnter?.(data);\n }\n\n /** Exit and destroy every stacked scene, top first, then empty the stack and destroy the kept scenes. */\n private _teardownStack(): void {\n for (let i = this._stack.length - 1; i >= 0; i--) {\n const s = this._stack[i]!;\n s.onExit?.();\n s.onDestroy?.();\n this._scenes.delete(s.name);\n this._initialized.delete(s.name);\n }\n this._stack.length = 0;\n this._overlay.length = 0;\n this._destroyKept();\n }\n\n /**\n * Destroy scenes popped with `keep: true` that were never pushed again. They\n * already got `onExit` on the pop. The cache entry is dropped only when it is\n * still this instance — an animated `go()` to the same name has already\n * replaced it with the pending scene.\n */\n private _destroyKept(): void {\n for (const s of this._kept) {\n s.onDestroy?.();\n if (this._scenes.get(s.name) === s) {\n this._scenes.delete(s.name);\n this._initialized.delete(s.name);\n }\n }\n this._kept.clear();\n }\n\n /**\n * Destroy the target of an animated `go()` that was superseded before its\n * out-phase finished. It got `onPreload` but never `onInit`. Fields are\n * cleared first so a re-entrant call from `onDestroy` cannot destroy twice;\n * an instance someone else still holds (stack, kept set) or has already\n * destroyed (evicted from the cache) is left alone.\n */\n private _discardPending(): void {\n const pending = this._pendingScene;\n if (!pending) return;\n this._pendingScene = null;\n this._pendingData = undefined;\n if (\n this._scenes.get(pending.name) !== pending ||\n this._stack.includes(pending) ||\n this._kept.has(pending)\n ) {\n return;\n }\n pending.onDestroy?.();\n this._scenes.delete(pending.name);\n this._initialized.delete(pending.name);\n }\n\n private _finishOutPhase(): void {\n if (!this._transitionState?.done || this._transitionState.phase !== 'out') return;\n\n const pending = this._pendingScene;\n const data = this._pendingData;\n this._pendingScene = null;\n this._pendingData = undefined;\n\n if (pending) {\n this._teardownStack();\n\n // Preload already ran in go(); call onInit then enter.\n this._scenes.set(pending.name, pending);\n this._initialized.add(pending.name);\n pending.onInit?.();\n this._stack.push(pending);\n this._overlay.push(false);\n pending.onEnter?.(data);\n }\n\n this._transitionState = this._transition.start('in');\n }\n\n /** Update then draw each live scene bottom-up: from the lowest scene not under an overlay to the top. */\n private _updateStack(dt: number): void {\n const stack = this._stack;\n let from = stack.length - 1;\n if (from < 0) return;\n while (from > 0 && this._overlay[from]) from--;\n for (let i = from; i < stack.length; i++) {\n const scene = stack[i]!;\n scene.onUpdate?.(dt);\n scene.onDraw?.();\n }\n }\n\n private _updateTransition(dt: number): void {\n if (!this._transitionState) return;\n\n this._transition.update(this._transitionState, dt);\n\n if (this._transitionState.done) {\n if (this._transitionState.phase === 'out') {\n // Hold until preload (started concurrently in go()) resolves.\n if (!this._preloadResolved) {\n this._updateStack(dt);\n return;\n }\n\n this._finishOutPhase();\n } else {\n // Phase 'in' done — transition complete\n this._transitionState = null;\n }\n }\n\n // Still update the live scenes during transition\n this._updateStack(dt);\n }\n}\n"],"mappings":"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"}
package/dist/index.mjs CHANGED
@@ -92,15 +92,19 @@ function slideTransition(duration = .3, direction = "left", easing = identity) {
92
92
  *
93
93
  * - `register(name, factory)` — register a scene factory
94
94
  * - `go(name, data?)` — switch to a scene (clears the stack)
95
- * - `push(name, data?)` — push a scene onto the stack (pauses current)
96
- * - `pop()` — pop the top scene and resume the one below
97
- * - `update(dt)` — update the active scene and any active transition
95
+ * - `push(name, data?, options?)` — push a scene onto the stack (pauses current unless `options.overlay`)
96
+ * - `pop(options?)` — pop the top scene and resume the one below (destroys it unless `options.keep`)
97
+ * - `update(dt)` — update the live scenes (bottom-up) and any active transition
98
98
  */
99
99
  var SceneManager = class {
100
100
  _factories = /* @__PURE__ */ new Map();
101
101
  _scenes = /* @__PURE__ */ new Map();
102
102
  _initialized = /* @__PURE__ */ new Set();
103
103
  _stack = [];
104
+ /** Parallel to `_stack`: whether the scene at that index was pushed as an overlay. */
105
+ _overlay = [];
106
+ /** Scenes popped with `keep: true`: initialized and cached, but off the stack until pushed again. */
107
+ _kept = /* @__PURE__ */ new Set();
104
108
  _transition = noneTransition();
105
109
  _transitionState = null;
106
110
  _pendingScene = null;
@@ -131,6 +135,8 @@ var SceneManager = class {
131
135
  * Navigate to a scene by name. Clears the entire stack.
132
136
  * Calls onExit on the current scene, onDestroy on all stacked scenes,
133
137
  * then onPreload → onInit → onEnter on the new scene.
138
+ * A `go()` issued while an animated `go()` is still fading out supersedes
139
+ * it: the superseded target gets `onDestroy` (never `onInit` / `onEnter`).
134
140
  */
135
141
  async go(name, data) {
136
142
  if (!this._factories.has(name)) {
@@ -138,6 +144,7 @@ var SceneManager = class {
138
144
  return;
139
145
  }
140
146
  if (this._transition.duration > 0 && this.current) {
147
+ this._discardPending();
141
148
  this._scenes.delete(name);
142
149
  this._initialized.delete(name);
143
150
  const scene = this._getOrCreate(name);
@@ -160,57 +167,63 @@ var SceneManager = class {
160
167
  });
161
168
  this._transitionState = this._transition.start("out");
162
169
  } else {
163
- this._exitAndDestroyCurrent();
170
+ this._discardPending();
171
+ this._transitionState = null;
172
+ this._teardownStack();
164
173
  const scene = this._getOrCreate(name);
165
174
  await this._activateScene(scene, data);
166
175
  }
167
176
  }
168
177
  /**
169
- * Push a scene onto the stack. The current scene gets onExit.
170
- * The new scene gets onPreload → onInit → onEnter.
178
+ * Push a scene onto the stack. The current scene gets onExit, unless
179
+ * `options.overlay` is true — then it stays live and is updated and drawn
180
+ * before the pushed scene. The new scene gets onPreload → onInit → onEnter.
171
181
  */
172
- async push(name, data) {
182
+ async push(name, data, options) {
173
183
  const scene = this._getOrCreate(name);
174
184
  if (!scene) return;
175
- this.current?.onExit?.();
185
+ const overlay = options?.overlay === true;
186
+ if (!overlay) this.current?.onExit?.();
176
187
  await this._initIfNeeded(scene);
188
+ this._kept.delete(scene);
177
189
  this._stack.push(scene);
190
+ this._overlay.push(overlay);
178
191
  scene.onEnter?.(data);
179
192
  }
180
- /** Pop the top scene. Calls onExit + onDestroy on it, onEnter on the one below. */
181
- pop() {
193
+ /**
194
+ * Pop the top scene. Calls onExit on it, then onDestroy unless
195
+ * `options.keep` is true — a kept scene stays initialized so the next `push`
196
+ * of its name goes straight to onEnter. The scene below gets
197
+ * onEnter(options.data) unless the popped scene was pushed as an overlay.
198
+ */
199
+ pop(options) {
182
200
  if (this._stack.length <= 1) return;
183
201
  const top = this._stack.pop();
202
+ const wasOverlay = this._overlay.pop() === true;
184
203
  top.onExit?.();
185
- top.onDestroy?.();
186
- this._scenes.delete(top.name);
187
- this._initialized.delete(top.name);
188
- this.current?.onEnter?.();
204
+ if (options?.keep === true) this._kept.add(top);
205
+ else {
206
+ top.onDestroy?.();
207
+ this._scenes.delete(top.name);
208
+ this._initialized.delete(top.name);
209
+ }
210
+ if (!wasOverlay) this.current?.onEnter?.(options?.data);
189
211
  }
190
- /** Update the active scene and any active transition. */
212
+ /** Update the live scenes (bottom-up, overlays last) and any active transition. */
191
213
  update(dt) {
192
214
  if (this._transitionState) {
193
215
  this._updateTransition(dt);
194
216
  return;
195
217
  }
196
- const scene = this.current;
197
- if (scene) {
198
- scene.onUpdate?.(dt);
199
- scene.onDraw?.();
200
- }
218
+ this._updateStack(dt);
201
219
  }
202
220
  /** Destroy all scenes and clear state. */
203
221
  destroy() {
204
- for (let i = this._stack.length - 1; i >= 0; i--) {
205
- const scene = this._stack[i];
206
- scene.onExit?.();
207
- scene.onDestroy?.();
208
- }
209
- this._stack.length = 0;
222
+ this._discardPending();
223
+ this._teardownStack();
210
224
  this._scenes.clear();
211
225
  this._initialized.clear();
212
226
  this._transitionState = null;
213
- this._pendingScene = null;
214
227
  }
215
228
  /** Get the transition progress (0–1) for rendering. 0 during 'out', 1 when done. */
216
229
  get transitionProgress() {
@@ -237,19 +250,13 @@ var SceneManager = class {
237
250
  scene.onInit?.();
238
251
  }
239
252
  async _activateScene(scene, data) {
240
- for (let i = this._stack.length - 1; i >= 0; i--) {
241
- const s = this._stack[i];
242
- s.onExit?.();
243
- s.onDestroy?.();
244
- this._scenes.delete(s.name);
245
- this._initialized.delete(s.name);
246
- }
247
- this._stack.length = 0;
248
253
  await this._initIfNeeded(scene);
249
254
  this._stack.push(scene);
255
+ this._overlay.push(false);
250
256
  scene.onEnter?.(data);
251
257
  }
252
- _exitAndDestroyCurrent() {
258
+ /** Exit and destroy every stacked scene, top first, then empty the stack and destroy the kept scenes. */
259
+ _teardownStack() {
253
260
  for (let i = this._stack.length - 1; i >= 0; i--) {
254
261
  const s = this._stack[i];
255
262
  s.onExit?.();
@@ -258,6 +265,41 @@ var SceneManager = class {
258
265
  this._initialized.delete(s.name);
259
266
  }
260
267
  this._stack.length = 0;
268
+ this._overlay.length = 0;
269
+ this._destroyKept();
270
+ }
271
+ /**
272
+ * Destroy scenes popped with `keep: true` that were never pushed again. They
273
+ * already got `onExit` on the pop. The cache entry is dropped only when it is
274
+ * still this instance — an animated `go()` to the same name has already
275
+ * replaced it with the pending scene.
276
+ */
277
+ _destroyKept() {
278
+ for (const s of this._kept) {
279
+ s.onDestroy?.();
280
+ if (this._scenes.get(s.name) === s) {
281
+ this._scenes.delete(s.name);
282
+ this._initialized.delete(s.name);
283
+ }
284
+ }
285
+ this._kept.clear();
286
+ }
287
+ /**
288
+ * Destroy the target of an animated `go()` that was superseded before its
289
+ * out-phase finished. It got `onPreload` but never `onInit`. Fields are
290
+ * cleared first so a re-entrant call from `onDestroy` cannot destroy twice;
291
+ * an instance someone else still holds (stack, kept set) or has already
292
+ * destroyed (evicted from the cache) is left alone.
293
+ */
294
+ _discardPending() {
295
+ const pending = this._pendingScene;
296
+ if (!pending) return;
297
+ this._pendingScene = null;
298
+ this._pendingData = void 0;
299
+ if (this._scenes.get(pending.name) !== pending || this._stack.includes(pending) || this._kept.has(pending)) return;
300
+ pending.onDestroy?.();
301
+ this._scenes.delete(pending.name);
302
+ this._initialized.delete(pending.name);
261
303
  }
262
304
  _finishOutPhase() {
263
305
  if (!this._transitionState?.done || this._transitionState.phase !== "out") return;
@@ -266,37 +308,41 @@ var SceneManager = class {
266
308
  this._pendingScene = null;
267
309
  this._pendingData = void 0;
268
310
  if (pending) {
269
- for (let i = this._stack.length - 1; i >= 0; i--) {
270
- const s = this._stack[i];
271
- s.onExit?.();
272
- s.onDestroy?.();
273
- this._scenes.delete(s.name);
274
- this._initialized.delete(s.name);
275
- }
276
- this._stack.length = 0;
311
+ this._teardownStack();
277
312
  this._scenes.set(pending.name, pending);
278
313
  this._initialized.add(pending.name);
279
314
  pending.onInit?.();
280
315
  this._stack.push(pending);
316
+ this._overlay.push(false);
281
317
  pending.onEnter?.(data);
282
318
  }
283
319
  this._transitionState = this._transition.start("in");
284
320
  }
321
+ /** Update then draw each live scene bottom-up: from the lowest scene not under an overlay to the top. */
322
+ _updateStack(dt) {
323
+ const stack = this._stack;
324
+ let from = stack.length - 1;
325
+ if (from < 0) return;
326
+ while (from > 0 && this._overlay[from]) from--;
327
+ for (let i = from; i < stack.length; i++) {
328
+ const scene = stack[i];
329
+ scene.onUpdate?.(dt);
330
+ scene.onDraw?.();
331
+ }
332
+ }
285
333
  _updateTransition(dt) {
286
334
  if (!this._transitionState) return;
287
335
  this._transition.update(this._transitionState, dt);
288
336
  if (this._transitionState.done) {
289
337
  if (this._transitionState.phase === "out") {
290
338
  if (!this._preloadResolved) {
291
- this.current?.onUpdate?.(dt);
292
- this.current?.onDraw?.();
339
+ this._updateStack(dt);
293
340
  return;
294
341
  }
295
342
  this._finishOutPhase();
296
343
  } else this._transitionState = null;
297
344
  }
298
- this.current?.onUpdate?.(dt);
299
- this.current?.onDraw?.();
345
+ this._updateStack(dt);
300
346
  }
301
347
  };
302
348
  export { SceneManager, fadeTransition, noneTransition, slideTransition };
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":[],"sources":["../src/transition.ts","../src/scene-manager.ts"],"sourcesContent":["import type { EasingFn } from '@flare-engine/math';\n\nexport type { EasingFn };\n\n/** Slide direction — where the outgoing scene moves off-screen to. */\nexport type SlideDirection = 'left' | 'right' | 'up' | 'down';\n\n/** Transition state during a scene switch. */\nexport interface TransitionState {\n /** Progress 0 → 1. */\n progress: number;\n /** Whether the transition is complete. */\n done: boolean;\n /** Phase: 'out' = leaving scene fading out, 'in' = entering scene fading in. */\n phase: 'out' | 'in';\n}\n\n/** A transition controls the visual blending between two scenes. */\nexport interface Transition {\n /** Discriminator for consumers that apply a visual effect (alpha, translate, etc.). */\n readonly kind: 'none' | 'fade' | 'slide';\n\n /** Duration in seconds for each phase (out + in). */\n readonly duration: number;\n\n /** For slide transitions, the direction the outgoing scene slides toward. */\n readonly direction?: SlideDirection;\n\n /** Start the transition. */\n start(phase: 'out' | 'in'): TransitionState;\n\n /** Update the transition by dt seconds. Returns the updated state. */\n update(state: TransitionState, dt: number): TransitionState;\n}\n\nconst identity: EasingFn = (t) => t;\n\n/**\n * Returns a stateful advance function that tracks raw (linear) progress in its\n * own closure so the easing function is applied without accumulating drift.\n * Call `reset()` when starting a new transition phase.\n */\nfunction makeAdvancer(duration: number, easing: EasingFn) {\n let raw = 0;\n return {\n reset() {\n raw = 0;\n },\n advance(state: TransitionState, dt: number): TransitionState {\n if (state.done) return state;\n raw += dt / duration;\n if (raw >= 1) {\n raw = 1;\n state.progress = 1;\n state.done = true;\n } else {\n state.progress = easing(raw);\n }\n return state;\n },\n };\n}\n\n/** No transition — instant scene switch. */\nexport function noneTransition(): Transition {\n return {\n kind: 'none',\n duration: 0,\n start(phase) {\n return { progress: 1, done: true, phase };\n },\n update(state) {\n state.progress = 1;\n state.done = true;\n return state;\n },\n };\n}\n\n/** Fade transition — consumer interprets `progress` as alpha. */\nexport function fadeTransition(duration = 0.3, easing: EasingFn = identity): Transition {\n const advancer = makeAdvancer(duration, easing);\n return {\n kind: 'fade',\n duration,\n start(phase) {\n advancer.reset();\n return { progress: 0, done: false, phase };\n },\n update(state, dt) {\n return advancer.advance(state, dt);\n },\n };\n}\n\n/**\n * Slide transition — consumer interprets `progress` as a 0→1 offset along `direction`.\n * Default direction is 'left' (outgoing scene slides off to the left, incoming enters from the right).\n */\nexport function slideTransition(\n duration = 0.3,\n direction: SlideDirection = 'left',\n easing: EasingFn = identity,\n): Transition {\n const advancer = makeAdvancer(duration, easing);\n return {\n kind: 'slide',\n duration,\n direction,\n start(phase) {\n advancer.reset();\n return { progress: 0, done: false, phase };\n },\n update(state, dt) {\n return advancer.advance(state, dt);\n },\n };\n}\n","import { World } from '@flare-engine/ecs';\nimport { Camera2D } from '@flare-engine/render';\nimport type { Scene, SceneFactory } from './scene.js';\nimport type { Transition, TransitionState } from './transition.js';\nimport { noneTransition } from './transition.js';\n\ndeclare const __DEV__: boolean | undefined;\n\n/**\n * SceneManager — manages scene registration, navigation, and a scene stack.\n *\n * - `register(name, factory)` — register a scene factory\n * - `go(name, data?)` — switch to a scene (clears the stack)\n * - `push(name, data?)` — push a scene onto the stack (pauses current)\n * - `pop()` — pop the top scene and resume the one below\n * - `update(dt)` — update the active scene and any active transition\n */\nexport class SceneManager {\n private _factories = new Map<string, SceneFactory>();\n private _scenes = new Map<string, Scene>();\n private _initialized = new Set<string>();\n private _stack: Scene[] = [];\n private _transition: Transition = noneTransition();\n private _transitionState: TransitionState | null = null;\n private _pendingScene: Scene | null = null;\n private _pendingData: unknown = undefined;\n private _preloadResolved = true;\n private _preloadGen = 0;\n\n /** The currently active scene (top of stack). */\n get current(): Scene | undefined {\n return this._stack.length > 0 ? this._stack[this._stack.length - 1] : undefined;\n }\n\n /** Number of scenes on the stack. */\n get stackSize(): number {\n return this._stack.length;\n }\n\n /** Whether a transition is currently in progress. */\n get isTransitioning(): boolean {\n return this._transitionState !== null;\n }\n\n /** Set the default transition for scene switches. */\n setTransition(transition: Transition): void {\n this._transition = transition;\n }\n\n /** Register a scene factory by name. */\n register(name: string, factory: SceneFactory): void {\n this._factories.set(name, factory);\n }\n\n /**\n * Navigate to a scene by name. Clears the entire stack.\n * Calls onExit on the current scene, onDestroy on all stacked scenes,\n * then onPreload → onInit → onEnter on the new scene.\n */\n async go(name: string, data?: unknown): Promise<void> {\n if (!this._factories.has(name)) {\n if (typeof __DEV__ !== 'undefined' && __DEV__) {\n console.warn(\n `[SceneManager] go('${name}'): scene not registered. Registered: ${[...this._factories.keys()].join(', ')}`,\n );\n }\n return;\n }\n\n if (this._transition.duration > 0 && this.current) {\n // Animated transition — evict target from cache first so restart\n // builds a fresh instance with a fresh World/Camera2D.\n this._scenes.delete(name);\n this._initialized.delete(name);\n const scene = this._getOrCreate(name)!;\n this._pendingScene = scene;\n this._pendingData = data;\n\n // Start preload concurrently with the fade-out.\n this._initialized.add(scene.name);\n this._preloadResolved = false;\n const gen = ++this._preloadGen;\n const preload = scene.onPreload?.();\n if (preload == null) {\n this._preloadResolved = true;\n } else {\n void preload.then(\n () => {\n if (gen !== this._preloadGen) return;\n this._preloadResolved = true;\n this._finishOutPhase();\n },\n (err) => {\n if (gen !== this._preloadGen) return;\n this._preloadResolved = true;\n if (typeof __DEV__ !== 'undefined' && __DEV__) {\n console.error(\n `[SceneManager] onPreload('${scene.name}') rejected; entering scene anyway`,\n err,\n );\n }\n this._finishOutPhase();\n },\n );\n }\n\n this._transitionState = this._transition.start('out');\n } else {\n // Instant transition — destroy first so _getOrCreate builds fresh.\n this._exitAndDestroyCurrent();\n const scene = this._getOrCreate(name)!;\n await this._activateScene(scene, data);\n }\n }\n\n /**\n * Push a scene onto the stack. The current scene gets onExit.\n * The new scene gets onPreload → onInit → onEnter.\n */\n async push(name: string, data?: unknown): Promise<void> {\n const scene = this._getOrCreate(name);\n if (!scene) return;\n\n this.current?.onExit?.();\n await this._initIfNeeded(scene);\n this._stack.push(scene);\n scene.onEnter?.(data);\n }\n\n /** Pop the top scene. Calls onExit + onDestroy on it, onEnter on the one below. */\n pop(): void {\n if (this._stack.length <= 1) return;\n\n const top = this._stack.pop()!;\n top.onExit?.();\n top.onDestroy?.();\n this._scenes.delete(top.name);\n this._initialized.delete(top.name);\n\n this.current?.onEnter?.();\n }\n\n /** Update the active scene and any active transition. */\n update(dt: number): void {\n if (this._transitionState) {\n this._updateTransition(dt);\n return;\n }\n\n const scene = this.current;\n if (scene) {\n scene.onUpdate?.(dt);\n scene.onDraw?.();\n }\n }\n\n /** Destroy all scenes and clear state. */\n destroy(): void {\n for (let i = this._stack.length - 1; i >= 0; i--) {\n const scene = this._stack[i]!;\n scene.onExit?.();\n scene.onDestroy?.();\n }\n this._stack.length = 0;\n this._scenes.clear();\n this._initialized.clear();\n this._transitionState = null;\n this._pendingScene = null;\n }\n\n /** Get the transition progress (0–1) for rendering. 0 during 'out', 1 when done. */\n get transitionProgress(): number {\n if (!this._transitionState) return 0;\n return this._transitionState.progress;\n }\n\n /** Get the current transition phase. */\n get transitionPhase(): 'out' | 'in' | null {\n return this._transitionState?.phase ?? null;\n }\n\n private _getOrCreate(name: string): Scene | null {\n let scene = this._scenes.get(name);\n if (scene) return scene;\n\n const factory = this._factories.get(name);\n if (!factory) return null;\n\n scene = factory(new World(), new Camera2D());\n this._scenes.set(name, scene);\n return scene;\n }\n\n private async _initIfNeeded(scene: Scene): Promise<void> {\n if (this._initialized.has(scene.name)) return;\n this._initialized.add(scene.name);\n await scene.onPreload?.();\n scene.onInit?.();\n }\n\n private async _activateScene(scene: Scene, data?: unknown): Promise<void> {\n // Destroy all stacked scenes\n for (let i = this._stack.length - 1; i >= 0; i--) {\n const s = this._stack[i]!;\n s.onExit?.();\n s.onDestroy?.();\n this._scenes.delete(s.name);\n this._initialized.delete(s.name);\n }\n this._stack.length = 0;\n\n await this._initIfNeeded(scene);\n this._stack.push(scene);\n scene.onEnter?.(data);\n }\n\n private _exitAndDestroyCurrent(): void {\n for (let i = this._stack.length - 1; i >= 0; i--) {\n const s = this._stack[i]!;\n s.onExit?.();\n s.onDestroy?.();\n this._scenes.delete(s.name);\n this._initialized.delete(s.name);\n }\n this._stack.length = 0;\n }\n\n private _finishOutPhase(): void {\n if (!this._transitionState?.done || this._transitionState.phase !== 'out') return;\n\n const pending = this._pendingScene;\n const data = this._pendingData;\n this._pendingScene = null;\n this._pendingData = undefined;\n\n if (pending) {\n for (let i = this._stack.length - 1; i >= 0; i--) {\n const s = this._stack[i]!;\n s.onExit?.();\n s.onDestroy?.();\n this._scenes.delete(s.name);\n this._initialized.delete(s.name);\n }\n this._stack.length = 0;\n\n // Preload already ran in go(); call onInit then enter.\n this._scenes.set(pending.name, pending);\n this._initialized.add(pending.name);\n pending.onInit?.();\n this._stack.push(pending);\n pending.onEnter?.(data);\n }\n\n this._transitionState = this._transition.start('in');\n }\n\n private _updateTransition(dt: number): void {\n if (!this._transitionState) return;\n\n this._transition.update(this._transitionState, dt);\n\n if (this._transitionState.done) {\n if (this._transitionState.phase === 'out') {\n // Hold until preload (started concurrently in go()) resolves.\n if (!this._preloadResolved) {\n this.current?.onUpdate?.(dt);\n this.current?.onDraw?.();\n return;\n }\n\n this._finishOutPhase();\n } else {\n // Phase 'in' done — transition complete\n this._transitionState = null;\n }\n }\n\n // Still update the current scene during transition\n this.current?.onUpdate?.(dt);\n this.current?.onDraw?.();\n }\n}\n"],"mappings":";;;AAmCA,MAAM,YAAsB,MAAM;;;;;;AAOlC,SAAS,aAAa,UAAkB,QAAkB;CACxD,IAAI,MAAM;CACV,OAAO;EACL,QAAQ;GACN,MAAM;EACR;EACA,QAAQ,OAAwB,IAA6B;GAC3D,IAAI,MAAM,MAAM,OAAO;GACvB,OAAO,KAAK;GACZ,IAAI,OAAO,GAAG;IACZ,MAAM;IACN,MAAM,WAAW;IACjB,MAAM,OAAO;GACf,OACE,MAAM,WAAW,OAAO,GAAG;GAE7B,OAAO;EACT;CACF;AACF;;AAGA,SAAgB,iBAA6B;CAC3C,OAAO;EACL,MAAM;EACN,UAAU;EACV,MAAM,OAAO;GACX,OAAO;IAAE,UAAU;IAAG,MAAM;IAAM;GAAM;EAC1C;EACA,OAAO,OAAO;GACZ,MAAM,WAAW;GACjB,MAAM,OAAO;GACb,OAAO;EACT;CACF;AACF;;AAGA,SAAgB,eAAe,WAAW,IAAK,SAAmB,UAAsB;CACtF,MAAM,WAAW,aAAa,UAAU,MAAM;CAC9C,OAAO;EACL,MAAM;EACN;EACA,MAAM,OAAO;GACX,SAAS,MAAM;GACf,OAAO;IAAE,UAAU;IAAG,MAAM;IAAO;GAAM;EAC3C;EACA,OAAO,OAAO,IAAI;GAChB,OAAO,SAAS,QAAQ,OAAO,EAAE;EACnC;CACF;AACF;;;;;AAMA,SAAgB,gBACd,WAAW,IACX,YAA4B,QAC5B,SAAmB,UACP;CACZ,MAAM,WAAW,aAAa,UAAU,MAAM;CAC9C,OAAO;EACL,MAAM;EACN;EACA;EACA,MAAM,OAAO;GACX,SAAS,MAAM;GACf,OAAO;IAAE,UAAU;IAAG,MAAM;IAAO;GAAM;EAC3C;EACA,OAAO,OAAO,IAAI;GAChB,OAAO,SAAS,QAAQ,OAAO,EAAE;EACnC;CACF;AACF;;;;;;;;;;;ACpGA,IAAa,eAAb,MAA0B;CACxB,6BAAqB,IAAI,IAA0B;CACnD,0BAAkB,IAAI,IAAmB;CACzC,+BAAuB,IAAI,IAAY;CACvC,SAA0B,CAAC;CAC3B,cAAkC,eAAe;CACjD,mBAAmD;CACnD,gBAAsC;CACtC,eAAgC,KAAA;CAChC,mBAA2B;CAC3B,cAAsB;;CAGtB,IAAI,UAA6B;EAC/B,OAAO,KAAK,OAAO,SAAS,IAAI,KAAK,OAAO,KAAK,OAAO,SAAS,KAAK,KAAA;CACxE;;CAGA,IAAI,YAAoB;EACtB,OAAO,KAAK,OAAO;CACrB;;CAGA,IAAI,kBAA2B;EAC7B,OAAO,KAAK,qBAAqB;CACnC;;CAGA,cAAc,YAA8B;EAC1C,KAAK,cAAc;CACrB;;CAGA,SAAS,MAAc,SAA6B;EAClD,KAAK,WAAW,IAAI,MAAM,OAAO;CACnC;;;;;;CAOA,MAAM,GAAG,MAAc,MAA+B;EACpD,IAAI,CAAC,KAAK,WAAW,IAAI,IAAI,GAAG;GAC9B,IAAI,OAAO,YAAY,eAAe,SACpC,QAAQ,KACN,sBAAsB,KAAK,wCAAwC,CAAC,GAAG,KAAK,WAAW,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,GAC1G;GAEF;EACF;EAEA,IAAI,KAAK,YAAY,WAAW,KAAK,KAAK,SAAS;GAGjD,KAAK,QAAQ,OAAO,IAAI;GACxB,KAAK,aAAa,OAAO,IAAI;GAC7B,MAAM,QAAQ,KAAK,aAAa,IAAI;GACpC,KAAK,gBAAgB;GACrB,KAAK,eAAe;GAGpB,KAAK,aAAa,IAAI,MAAM,IAAI;GAChC,KAAK,mBAAmB;GACxB,MAAM,MAAM,EAAE,KAAK;GACnB,MAAM,UAAU,MAAM,YAAY;GAClC,IAAI,WAAW,MACb,KAAK,mBAAmB;QAExB,QAAa,WACL;IACJ,IAAI,QAAQ,KAAK,aAAa;IAC9B,KAAK,mBAAmB;IACxB,KAAK,gBAAgB;GACvB,IACC,QAAQ;IACP,IAAI,QAAQ,KAAK,aAAa;IAC9B,KAAK,mBAAmB;IACxB,IAAI,OAAO,YAAY,eAAe,SACpC,QAAQ,MACN,6BAA6B,MAAM,KAAK,qCACxC,GACF;IAEF,KAAK,gBAAgB;GACvB,CACF;GAGF,KAAK,mBAAmB,KAAK,YAAY,MAAM,KAAK;EACtD,OAAO;GAEL,KAAK,uBAAuB;GAC5B,MAAM,QAAQ,KAAK,aAAa,IAAI;GACpC,MAAM,KAAK,eAAe,OAAO,IAAI;EACvC;CACF;;;;;CAMA,MAAM,KAAK,MAAc,MAA+B;EACtD,MAAM,QAAQ,KAAK,aAAa,IAAI;EACpC,IAAI,CAAC,OAAO;EAEZ,KAAK,SAAS,SAAS;EACvB,MAAM,KAAK,cAAc,KAAK;EAC9B,KAAK,OAAO,KAAK,KAAK;EACtB,MAAM,UAAU,IAAI;CACtB;;CAGA,MAAY;EACV,IAAI,KAAK,OAAO,UAAU,GAAG;EAE7B,MAAM,MAAM,KAAK,OAAO,IAAI;EAC5B,IAAI,SAAS;EACb,IAAI,YAAY;EAChB,KAAK,QAAQ,OAAO,IAAI,IAAI;EAC5B,KAAK,aAAa,OAAO,IAAI,IAAI;EAEjC,KAAK,SAAS,UAAU;CAC1B;;CAGA,OAAO,IAAkB;EACvB,IAAI,KAAK,kBAAkB;GACzB,KAAK,kBAAkB,EAAE;GACzB;EACF;EAEA,MAAM,QAAQ,KAAK;EACnB,IAAI,OAAO;GACT,MAAM,WAAW,EAAE;GACnB,MAAM,SAAS;EACjB;CACF;;CAGA,UAAgB;EACd,KAAK,IAAI,IAAI,KAAK,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;GAChD,MAAM,QAAQ,KAAK,OAAO;GAC1B,MAAM,SAAS;GACf,MAAM,YAAY;EACpB;EACA,KAAK,OAAO,SAAS;EACrB,KAAK,QAAQ,MAAM;EACnB,KAAK,aAAa,MAAM;EACxB,KAAK,mBAAmB;EACxB,KAAK,gBAAgB;CACvB;;CAGA,IAAI,qBAA6B;EAC/B,IAAI,CAAC,KAAK,kBAAkB,OAAO;EACnC,OAAO,KAAK,iBAAiB;CAC/B;;CAGA,IAAI,kBAAuC;EACzC,OAAO,KAAK,kBAAkB,SAAS;CACzC;CAEA,aAAqB,MAA4B;EAC/C,IAAI,QAAQ,KAAK,QAAQ,IAAI,IAAI;EACjC,IAAI,OAAO,OAAO;EAElB,MAAM,UAAU,KAAK,WAAW,IAAI,IAAI;EACxC,IAAI,CAAC,SAAS,OAAO;EAErB,QAAQ,QAAQ,IAAI,MAAM,GAAG,IAAI,SAAS,CAAC;EAC3C,KAAK,QAAQ,IAAI,MAAM,KAAK;EAC5B,OAAO;CACT;CAEA,MAAc,cAAc,OAA6B;EACvD,IAAI,KAAK,aAAa,IAAI,MAAM,IAAI,GAAG;EACvC,KAAK,aAAa,IAAI,MAAM,IAAI;EAChC,MAAM,MAAM,YAAY;EACxB,MAAM,SAAS;CACjB;CAEA,MAAc,eAAe,OAAc,MAA+B;EAExE,KAAK,IAAI,IAAI,KAAK,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;GAChD,MAAM,IAAI,KAAK,OAAO;GACtB,EAAE,SAAS;GACX,EAAE,YAAY;GACd,KAAK,QAAQ,OAAO,EAAE,IAAI;GAC1B,KAAK,aAAa,OAAO,EAAE,IAAI;EACjC;EACA,KAAK,OAAO,SAAS;EAErB,MAAM,KAAK,cAAc,KAAK;EAC9B,KAAK,OAAO,KAAK,KAAK;EACtB,MAAM,UAAU,IAAI;CACtB;CAEA,yBAAuC;EACrC,KAAK,IAAI,IAAI,KAAK,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;GAChD,MAAM,IAAI,KAAK,OAAO;GACtB,EAAE,SAAS;GACX,EAAE,YAAY;GACd,KAAK,QAAQ,OAAO,EAAE,IAAI;GAC1B,KAAK,aAAa,OAAO,EAAE,IAAI;EACjC;EACA,KAAK,OAAO,SAAS;CACvB;CAEA,kBAAgC;EAC9B,IAAI,CAAC,KAAK,kBAAkB,QAAQ,KAAK,iBAAiB,UAAU,OAAO;EAE3E,MAAM,UAAU,KAAK;EACrB,MAAM,OAAO,KAAK;EAClB,KAAK,gBAAgB;EACrB,KAAK,eAAe,KAAA;EAEpB,IAAI,SAAS;GACX,KAAK,IAAI,IAAI,KAAK,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;IAChD,MAAM,IAAI,KAAK,OAAO;IACtB,EAAE,SAAS;IACX,EAAE,YAAY;IACd,KAAK,QAAQ,OAAO,EAAE,IAAI;IAC1B,KAAK,aAAa,OAAO,EAAE,IAAI;GACjC;GACA,KAAK,OAAO,SAAS;GAGrB,KAAK,QAAQ,IAAI,QAAQ,MAAM,OAAO;GACtC,KAAK,aAAa,IAAI,QAAQ,IAAI;GAClC,QAAQ,SAAS;GACjB,KAAK,OAAO,KAAK,OAAO;GACxB,QAAQ,UAAU,IAAI;EACxB;EAEA,KAAK,mBAAmB,KAAK,YAAY,MAAM,IAAI;CACrD;CAEA,kBAA0B,IAAkB;EAC1C,IAAI,CAAC,KAAK,kBAAkB;EAE5B,KAAK,YAAY,OAAO,KAAK,kBAAkB,EAAE;EAEjD,IAAI,KAAK,iBAAiB,MAAM;GAC9B,IAAI,KAAK,iBAAiB,UAAU,OAAO;IAEzC,IAAI,CAAC,KAAK,kBAAkB;KAC1B,KAAK,SAAS,WAAW,EAAE;KAC3B,KAAK,SAAS,SAAS;KACvB;IACF;IAEA,KAAK,gBAAgB;GACvB,OAEE,KAAK,mBAAmB;EAE5B;EAGA,KAAK,SAAS,WAAW,EAAE;EAC3B,KAAK,SAAS,SAAS;CACzB;AACF"}
1
+ {"version":3,"file":"index.mjs","names":[],"sources":["../src/transition.ts","../src/scene-manager.ts"],"sourcesContent":["import type { EasingFn } from '@flare-engine/math';\n\nexport type { EasingFn };\n\n/** Slide direction — where the outgoing scene moves off-screen to. */\nexport type SlideDirection = 'left' | 'right' | 'up' | 'down';\n\n/** Transition state during a scene switch. */\nexport interface TransitionState {\n /** Progress 0 → 1. */\n progress: number;\n /** Whether the transition is complete. */\n done: boolean;\n /** Phase: 'out' = leaving scene fading out, 'in' = entering scene fading in. */\n phase: 'out' | 'in';\n}\n\n/** A transition controls the visual blending between two scenes. */\nexport interface Transition {\n /** Discriminator for consumers that apply a visual effect (alpha, translate, etc.). */\n readonly kind: 'none' | 'fade' | 'slide';\n\n /** Duration in seconds for each phase (out + in). */\n readonly duration: number;\n\n /** For slide transitions, the direction the outgoing scene slides toward. */\n readonly direction?: SlideDirection;\n\n /** Start the transition. */\n start(phase: 'out' | 'in'): TransitionState;\n\n /** Update the transition by dt seconds. Returns the updated state. */\n update(state: TransitionState, dt: number): TransitionState;\n}\n\nconst identity: EasingFn = (t) => t;\n\n/**\n * Returns a stateful advance function that tracks raw (linear) progress in its\n * own closure so the easing function is applied without accumulating drift.\n * Call `reset()` when starting a new transition phase.\n */\nfunction makeAdvancer(duration: number, easing: EasingFn) {\n let raw = 0;\n return {\n reset() {\n raw = 0;\n },\n advance(state: TransitionState, dt: number): TransitionState {\n if (state.done) return state;\n raw += dt / duration;\n if (raw >= 1) {\n raw = 1;\n state.progress = 1;\n state.done = true;\n } else {\n state.progress = easing(raw);\n }\n return state;\n },\n };\n}\n\n/** No transition — instant scene switch. */\nexport function noneTransition(): Transition {\n return {\n kind: 'none',\n duration: 0,\n start(phase) {\n return { progress: 1, done: true, phase };\n },\n update(state) {\n state.progress = 1;\n state.done = true;\n return state;\n },\n };\n}\n\n/** Fade transition — consumer interprets `progress` as alpha. */\nexport function fadeTransition(duration = 0.3, easing: EasingFn = identity): Transition {\n const advancer = makeAdvancer(duration, easing);\n return {\n kind: 'fade',\n duration,\n start(phase) {\n advancer.reset();\n return { progress: 0, done: false, phase };\n },\n update(state, dt) {\n return advancer.advance(state, dt);\n },\n };\n}\n\n/**\n * Slide transition — consumer interprets `progress` as a 0→1 offset along `direction`.\n * Default direction is 'left' (outgoing scene slides off to the left, incoming enters from the right).\n */\nexport function slideTransition(\n duration = 0.3,\n direction: SlideDirection = 'left',\n easing: EasingFn = identity,\n): Transition {\n const advancer = makeAdvancer(duration, easing);\n return {\n kind: 'slide',\n duration,\n direction,\n start(phase) {\n advancer.reset();\n return { progress: 0, done: false, phase };\n },\n update(state, dt) {\n return advancer.advance(state, dt);\n },\n };\n}\n","import { World } from '@flare-engine/ecs';\nimport { Camera2D } from '@flare-engine/render';\nimport type { Scene, SceneFactory } from './scene.js';\nimport type { Transition, TransitionState } from './transition.js';\nimport { noneTransition } from './transition.js';\n\ndeclare const __DEV__: boolean | undefined;\n\nexport interface ScenePushOptions {\n /** Keep the scene below live: it is updated and drawn first, gets no `onExit` on push and no `onEnter` on the matching `pop()`. */\n overlay?: boolean;\n}\n\nexport interface ScenePopOptions {\n /** Keep the popped scene initialized: it gets `onExit` only, and the next `push` of its name goes straight to `onEnter`. */\n keep?: boolean;\n /** Forwarded to the revealed scene's `onEnter` (dropped when the popped scene was an overlay). */\n data?: unknown;\n}\n\n/**\n * SceneManager — manages scene registration, navigation, and a scene stack.\n *\n * - `register(name, factory)` — register a scene factory\n * - `go(name, data?)` — switch to a scene (clears the stack)\n * - `push(name, data?, options?)` — push a scene onto the stack (pauses current unless `options.overlay`)\n * - `pop(options?)` — pop the top scene and resume the one below (destroys it unless `options.keep`)\n * - `update(dt)` — update the live scenes (bottom-up) and any active transition\n */\nexport class SceneManager {\n private _factories = new Map<string, SceneFactory>();\n private _scenes = new Map<string, Scene>();\n private _initialized = new Set<string>();\n private _stack: Scene[] = [];\n /** Parallel to `_stack`: whether the scene at that index was pushed as an overlay. */\n private _overlay: boolean[] = [];\n /** Scenes popped with `keep: true`: initialized and cached, but off the stack until pushed again. */\n private _kept = new Set<Scene>();\n private _transition: Transition = noneTransition();\n private _transitionState: TransitionState | null = null;\n private _pendingScene: Scene | null = null;\n private _pendingData: unknown = undefined;\n private _preloadResolved = true;\n private _preloadGen = 0;\n\n /** The currently active scene (top of stack). */\n get current(): Scene | undefined {\n return this._stack.length > 0 ? this._stack[this._stack.length - 1] : undefined;\n }\n\n /** Number of scenes on the stack. */\n get stackSize(): number {\n return this._stack.length;\n }\n\n /** Whether a transition is currently in progress. */\n get isTransitioning(): boolean {\n return this._transitionState !== null;\n }\n\n /** Set the default transition for scene switches. */\n setTransition(transition: Transition): void {\n this._transition = transition;\n }\n\n /** Register a scene factory by name. */\n register(name: string, factory: SceneFactory): void {\n this._factories.set(name, factory);\n }\n\n /**\n * Navigate to a scene by name. Clears the entire stack.\n * Calls onExit on the current scene, onDestroy on all stacked scenes,\n * then onPreload → onInit → onEnter on the new scene.\n * A `go()` issued while an animated `go()` is still fading out supersedes\n * it: the superseded target gets `onDestroy` (never `onInit` / `onEnter`).\n */\n async go(name: string, data?: unknown): Promise<void> {\n if (!this._factories.has(name)) {\n if (typeof __DEV__ !== 'undefined' && __DEV__) {\n console.warn(\n `[SceneManager] go('${name}'): scene not registered. Registered: ${[...this._factories.keys()].join(', ')}`,\n );\n }\n return;\n }\n\n if (this._transition.duration > 0 && this.current) {\n this._discardPending();\n // Animated transition — evict target from cache first so restart\n // builds a fresh instance with a fresh World/Camera2D.\n this._scenes.delete(name);\n this._initialized.delete(name);\n const scene = this._getOrCreate(name)!;\n this._pendingScene = scene;\n this._pendingData = data;\n\n // Start preload concurrently with the fade-out.\n this._initialized.add(scene.name);\n this._preloadResolved = false;\n const gen = ++this._preloadGen;\n const preload = scene.onPreload?.();\n if (preload == null) {\n this._preloadResolved = true;\n } else {\n void preload.then(\n () => {\n if (gen !== this._preloadGen) return;\n this._preloadResolved = true;\n this._finishOutPhase();\n },\n (err) => {\n if (gen !== this._preloadGen) return;\n this._preloadResolved = true;\n if (typeof __DEV__ !== 'undefined' && __DEV__) {\n console.error(\n `[SceneManager] onPreload('${scene.name}') rejected; entering scene anyway`,\n err,\n );\n }\n this._finishOutPhase();\n },\n );\n }\n\n this._transitionState = this._transition.start('out');\n } else {\n // A pending animated go() is superseded; end any transition in progress\n // too, or _finishOutPhase would later replace the instant scene with the\n // stale target. Its late preload handler is harmless once the state is null.\n this._discardPending();\n this._transitionState = null;\n // Instant transition — destroy first so _getOrCreate builds fresh.\n this._teardownStack();\n const scene = this._getOrCreate(name)!;\n await this._activateScene(scene, data);\n }\n }\n\n /**\n * Push a scene onto the stack. The current scene gets onExit, unless\n * `options.overlay` is true — then it stays live and is updated and drawn\n * before the pushed scene. The new scene gets onPreload → onInit → onEnter.\n */\n async push(name: string, data?: unknown, options?: ScenePushOptions): Promise<void> {\n const scene = this._getOrCreate(name);\n if (!scene) return;\n\n const overlay = options?.overlay === true;\n if (!overlay) this.current?.onExit?.();\n await this._initIfNeeded(scene);\n this._kept.delete(scene);\n this._stack.push(scene);\n this._overlay.push(overlay);\n scene.onEnter?.(data);\n }\n\n /**\n * Pop the top scene. Calls onExit on it, then onDestroy unless\n * `options.keep` is true — a kept scene stays initialized so the next `push`\n * of its name goes straight to onEnter. The scene below gets\n * onEnter(options.data) unless the popped scene was pushed as an overlay.\n */\n pop(options?: ScenePopOptions): void {\n if (this._stack.length <= 1) return;\n\n const top = this._stack.pop()!;\n const wasOverlay = this._overlay.pop() === true;\n top.onExit?.();\n if (options?.keep === true) {\n this._kept.add(top);\n } else {\n top.onDestroy?.();\n this._scenes.delete(top.name);\n this._initialized.delete(top.name);\n }\n\n if (!wasOverlay) this.current?.onEnter?.(options?.data);\n }\n\n /** Update the live scenes (bottom-up, overlays last) and any active transition. */\n update(dt: number): void {\n if (this._transitionState) {\n this._updateTransition(dt);\n return;\n }\n\n this._updateStack(dt);\n }\n\n /** Destroy all scenes and clear state. */\n destroy(): void {\n this._discardPending();\n this._teardownStack();\n this._scenes.clear();\n this._initialized.clear();\n this._transitionState = null;\n }\n\n /** Get the transition progress (0–1) for rendering. 0 during 'out', 1 when done. */\n get transitionProgress(): number {\n if (!this._transitionState) return 0;\n return this._transitionState.progress;\n }\n\n /** Get the current transition phase. */\n get transitionPhase(): 'out' | 'in' | null {\n return this._transitionState?.phase ?? null;\n }\n\n private _getOrCreate(name: string): Scene | null {\n let scene = this._scenes.get(name);\n if (scene) return scene;\n\n const factory = this._factories.get(name);\n if (!factory) return null;\n\n scene = factory(new World(), new Camera2D());\n this._scenes.set(name, scene);\n return scene;\n }\n\n private async _initIfNeeded(scene: Scene): Promise<void> {\n if (this._initialized.has(scene.name)) return;\n this._initialized.add(scene.name);\n await scene.onPreload?.();\n scene.onInit?.();\n }\n\n private async _activateScene(scene: Scene, data?: unknown): Promise<void> {\n await this._initIfNeeded(scene);\n this._stack.push(scene);\n this._overlay.push(false);\n scene.onEnter?.(data);\n }\n\n /** Exit and destroy every stacked scene, top first, then empty the stack and destroy the kept scenes. */\n private _teardownStack(): void {\n for (let i = this._stack.length - 1; i >= 0; i--) {\n const s = this._stack[i]!;\n s.onExit?.();\n s.onDestroy?.();\n this._scenes.delete(s.name);\n this._initialized.delete(s.name);\n }\n this._stack.length = 0;\n this._overlay.length = 0;\n this._destroyKept();\n }\n\n /**\n * Destroy scenes popped with `keep: true` that were never pushed again. They\n * already got `onExit` on the pop. The cache entry is dropped only when it is\n * still this instance — an animated `go()` to the same name has already\n * replaced it with the pending scene.\n */\n private _destroyKept(): void {\n for (const s of this._kept) {\n s.onDestroy?.();\n if (this._scenes.get(s.name) === s) {\n this._scenes.delete(s.name);\n this._initialized.delete(s.name);\n }\n }\n this._kept.clear();\n }\n\n /**\n * Destroy the target of an animated `go()` that was superseded before its\n * out-phase finished. It got `onPreload` but never `onInit`. Fields are\n * cleared first so a re-entrant call from `onDestroy` cannot destroy twice;\n * an instance someone else still holds (stack, kept set) or has already\n * destroyed (evicted from the cache) is left alone.\n */\n private _discardPending(): void {\n const pending = this._pendingScene;\n if (!pending) return;\n this._pendingScene = null;\n this._pendingData = undefined;\n if (\n this._scenes.get(pending.name) !== pending ||\n this._stack.includes(pending) ||\n this._kept.has(pending)\n ) {\n return;\n }\n pending.onDestroy?.();\n this._scenes.delete(pending.name);\n this._initialized.delete(pending.name);\n }\n\n private _finishOutPhase(): void {\n if (!this._transitionState?.done || this._transitionState.phase !== 'out') return;\n\n const pending = this._pendingScene;\n const data = this._pendingData;\n this._pendingScene = null;\n this._pendingData = undefined;\n\n if (pending) {\n this._teardownStack();\n\n // Preload already ran in go(); call onInit then enter.\n this._scenes.set(pending.name, pending);\n this._initialized.add(pending.name);\n pending.onInit?.();\n this._stack.push(pending);\n this._overlay.push(false);\n pending.onEnter?.(data);\n }\n\n this._transitionState = this._transition.start('in');\n }\n\n /** Update then draw each live scene bottom-up: from the lowest scene not under an overlay to the top. */\n private _updateStack(dt: number): void {\n const stack = this._stack;\n let from = stack.length - 1;\n if (from < 0) return;\n while (from > 0 && this._overlay[from]) from--;\n for (let i = from; i < stack.length; i++) {\n const scene = stack[i]!;\n scene.onUpdate?.(dt);\n scene.onDraw?.();\n }\n }\n\n private _updateTransition(dt: number): void {\n if (!this._transitionState) return;\n\n this._transition.update(this._transitionState, dt);\n\n if (this._transitionState.done) {\n if (this._transitionState.phase === 'out') {\n // Hold until preload (started concurrently in go()) resolves.\n if (!this._preloadResolved) {\n this._updateStack(dt);\n return;\n }\n\n this._finishOutPhase();\n } else {\n // Phase 'in' done — transition complete\n this._transitionState = null;\n }\n }\n\n // Still update the live scenes during transition\n this._updateStack(dt);\n }\n}\n"],"mappings":";;;AAmCA,MAAM,YAAsB,MAAM;;;;;;AAOlC,SAAS,aAAa,UAAkB,QAAkB;CACxD,IAAI,MAAM;CACV,OAAO;EACL,QAAQ;GACN,MAAM;EACR;EACA,QAAQ,OAAwB,IAA6B;GAC3D,IAAI,MAAM,MAAM,OAAO;GACvB,OAAO,KAAK;GACZ,IAAI,OAAO,GAAG;IACZ,MAAM;IACN,MAAM,WAAW;IACjB,MAAM,OAAO;GACf,OACE,MAAM,WAAW,OAAO,GAAG;GAE7B,OAAO;EACT;CACF;AACF;;AAGA,SAAgB,iBAA6B;CAC3C,OAAO;EACL,MAAM;EACN,UAAU;EACV,MAAM,OAAO;GACX,OAAO;IAAE,UAAU;IAAG,MAAM;IAAM;GAAM;EAC1C;EACA,OAAO,OAAO;GACZ,MAAM,WAAW;GACjB,MAAM,OAAO;GACb,OAAO;EACT;CACF;AACF;;AAGA,SAAgB,eAAe,WAAW,IAAK,SAAmB,UAAsB;CACtF,MAAM,WAAW,aAAa,UAAU,MAAM;CAC9C,OAAO;EACL,MAAM;EACN;EACA,MAAM,OAAO;GACX,SAAS,MAAM;GACf,OAAO;IAAE,UAAU;IAAG,MAAM;IAAO;GAAM;EAC3C;EACA,OAAO,OAAO,IAAI;GAChB,OAAO,SAAS,QAAQ,OAAO,EAAE;EACnC;CACF;AACF;;;;;AAMA,SAAgB,gBACd,WAAW,IACX,YAA4B,QAC5B,SAAmB,UACP;CACZ,MAAM,WAAW,aAAa,UAAU,MAAM;CAC9C,OAAO;EACL,MAAM;EACN;EACA;EACA,MAAM,OAAO;GACX,SAAS,MAAM;GACf,OAAO;IAAE,UAAU;IAAG,MAAM;IAAO;GAAM;EAC3C;EACA,OAAO,OAAO,IAAI;GAChB,OAAO,SAAS,QAAQ,OAAO,EAAE;EACnC;CACF;AACF;;;;;;;;;;;ACxFA,IAAa,eAAb,MAA0B;CACxB,6BAAqB,IAAI,IAA0B;CACnD,0BAAkB,IAAI,IAAmB;CACzC,+BAAuB,IAAI,IAAY;CACvC,SAA0B,CAAC;;CAE3B,WAA8B,CAAC;;CAE/B,wBAAgB,IAAI,IAAW;CAC/B,cAAkC,eAAe;CACjD,mBAAmD;CACnD,gBAAsC;CACtC,eAAgC,KAAA;CAChC,mBAA2B;CAC3B,cAAsB;;CAGtB,IAAI,UAA6B;EAC/B,OAAO,KAAK,OAAO,SAAS,IAAI,KAAK,OAAO,KAAK,OAAO,SAAS,KAAK,KAAA;CACxE;;CAGA,IAAI,YAAoB;EACtB,OAAO,KAAK,OAAO;CACrB;;CAGA,IAAI,kBAA2B;EAC7B,OAAO,KAAK,qBAAqB;CACnC;;CAGA,cAAc,YAA8B;EAC1C,KAAK,cAAc;CACrB;;CAGA,SAAS,MAAc,SAA6B;EAClD,KAAK,WAAW,IAAI,MAAM,OAAO;CACnC;;;;;;;;CASA,MAAM,GAAG,MAAc,MAA+B;EACpD,IAAI,CAAC,KAAK,WAAW,IAAI,IAAI,GAAG;GAC9B,IAAI,OAAO,YAAY,eAAe,SACpC,QAAQ,KACN,sBAAsB,KAAK,wCAAwC,CAAC,GAAG,KAAK,WAAW,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,GAC1G;GAEF;EACF;EAEA,IAAI,KAAK,YAAY,WAAW,KAAK,KAAK,SAAS;GACjD,KAAK,gBAAgB;GAGrB,KAAK,QAAQ,OAAO,IAAI;GACxB,KAAK,aAAa,OAAO,IAAI;GAC7B,MAAM,QAAQ,KAAK,aAAa,IAAI;GACpC,KAAK,gBAAgB;GACrB,KAAK,eAAe;GAGpB,KAAK,aAAa,IAAI,MAAM,IAAI;GAChC,KAAK,mBAAmB;GACxB,MAAM,MAAM,EAAE,KAAK;GACnB,MAAM,UAAU,MAAM,YAAY;GAClC,IAAI,WAAW,MACb,KAAK,mBAAmB;QAExB,QAAa,WACL;IACJ,IAAI,QAAQ,KAAK,aAAa;IAC9B,KAAK,mBAAmB;IACxB,KAAK,gBAAgB;GACvB,IACC,QAAQ;IACP,IAAI,QAAQ,KAAK,aAAa;IAC9B,KAAK,mBAAmB;IACxB,IAAI,OAAO,YAAY,eAAe,SACpC,QAAQ,MACN,6BAA6B,MAAM,KAAK,qCACxC,GACF;IAEF,KAAK,gBAAgB;GACvB,CACF;GAGF,KAAK,mBAAmB,KAAK,YAAY,MAAM,KAAK;EACtD,OAAO;GAIL,KAAK,gBAAgB;GACrB,KAAK,mBAAmB;GAExB,KAAK,eAAe;GACpB,MAAM,QAAQ,KAAK,aAAa,IAAI;GACpC,MAAM,KAAK,eAAe,OAAO,IAAI;EACvC;CACF;;;;;;CAOA,MAAM,KAAK,MAAc,MAAgB,SAA2C;EAClF,MAAM,QAAQ,KAAK,aAAa,IAAI;EACpC,IAAI,CAAC,OAAO;EAEZ,MAAM,UAAU,SAAS,YAAY;EACrC,IAAI,CAAC,SAAS,KAAK,SAAS,SAAS;EACrC,MAAM,KAAK,cAAc,KAAK;EAC9B,KAAK,MAAM,OAAO,KAAK;EACvB,KAAK,OAAO,KAAK,KAAK;EACtB,KAAK,SAAS,KAAK,OAAO;EAC1B,MAAM,UAAU,IAAI;CACtB;;;;;;;CAQA,IAAI,SAAiC;EACnC,IAAI,KAAK,OAAO,UAAU,GAAG;EAE7B,MAAM,MAAM,KAAK,OAAO,IAAI;EAC5B,MAAM,aAAa,KAAK,SAAS,IAAI,MAAM;EAC3C,IAAI,SAAS;EACb,IAAI,SAAS,SAAS,MACpB,KAAK,MAAM,IAAI,GAAG;OACb;GACL,IAAI,YAAY;GAChB,KAAK,QAAQ,OAAO,IAAI,IAAI;GAC5B,KAAK,aAAa,OAAO,IAAI,IAAI;EACnC;EAEA,IAAI,CAAC,YAAY,KAAK,SAAS,UAAU,SAAS,IAAI;CACxD;;CAGA,OAAO,IAAkB;EACvB,IAAI,KAAK,kBAAkB;GACzB,KAAK,kBAAkB,EAAE;GACzB;EACF;EAEA,KAAK,aAAa,EAAE;CACtB;;CAGA,UAAgB;EACd,KAAK,gBAAgB;EACrB,KAAK,eAAe;EACpB,KAAK,QAAQ,MAAM;EACnB,KAAK,aAAa,MAAM;EACxB,KAAK,mBAAmB;CAC1B;;CAGA,IAAI,qBAA6B;EAC/B,IAAI,CAAC,KAAK,kBAAkB,OAAO;EACnC,OAAO,KAAK,iBAAiB;CAC/B;;CAGA,IAAI,kBAAuC;EACzC,OAAO,KAAK,kBAAkB,SAAS;CACzC;CAEA,aAAqB,MAA4B;EAC/C,IAAI,QAAQ,KAAK,QAAQ,IAAI,IAAI;EACjC,IAAI,OAAO,OAAO;EAElB,MAAM,UAAU,KAAK,WAAW,IAAI,IAAI;EACxC,IAAI,CAAC,SAAS,OAAO;EAErB,QAAQ,QAAQ,IAAI,MAAM,GAAG,IAAI,SAAS,CAAC;EAC3C,KAAK,QAAQ,IAAI,MAAM,KAAK;EAC5B,OAAO;CACT;CAEA,MAAc,cAAc,OAA6B;EACvD,IAAI,KAAK,aAAa,IAAI,MAAM,IAAI,GAAG;EACvC,KAAK,aAAa,IAAI,MAAM,IAAI;EAChC,MAAM,MAAM,YAAY;EACxB,MAAM,SAAS;CACjB;CAEA,MAAc,eAAe,OAAc,MAA+B;EACxE,MAAM,KAAK,cAAc,KAAK;EAC9B,KAAK,OAAO,KAAK,KAAK;EACtB,KAAK,SAAS,KAAK,KAAK;EACxB,MAAM,UAAU,IAAI;CACtB;;CAGA,iBAA+B;EAC7B,KAAK,IAAI,IAAI,KAAK,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;GAChD,MAAM,IAAI,KAAK,OAAO;GACtB,EAAE,SAAS;GACX,EAAE,YAAY;GACd,KAAK,QAAQ,OAAO,EAAE,IAAI;GAC1B,KAAK,aAAa,OAAO,EAAE,IAAI;EACjC;EACA,KAAK,OAAO,SAAS;EACrB,KAAK,SAAS,SAAS;EACvB,KAAK,aAAa;CACpB;;;;;;;CAQA,eAA6B;EAC3B,KAAK,MAAM,KAAK,KAAK,OAAO;GAC1B,EAAE,YAAY;GACd,IAAI,KAAK,QAAQ,IAAI,EAAE,IAAI,MAAM,GAAG;IAClC,KAAK,QAAQ,OAAO,EAAE,IAAI;IAC1B,KAAK,aAAa,OAAO,EAAE,IAAI;GACjC;EACF;EACA,KAAK,MAAM,MAAM;CACnB;;;;;;;;CASA,kBAAgC;EAC9B,MAAM,UAAU,KAAK;EACrB,IAAI,CAAC,SAAS;EACd,KAAK,gBAAgB;EACrB,KAAK,eAAe,KAAA;EACpB,IACE,KAAK,QAAQ,IAAI,QAAQ,IAAI,MAAM,WACnC,KAAK,OAAO,SAAS,OAAO,KAC5B,KAAK,MAAM,IAAI,OAAO,GAEtB;EAEF,QAAQ,YAAY;EACpB,KAAK,QAAQ,OAAO,QAAQ,IAAI;EAChC,KAAK,aAAa,OAAO,QAAQ,IAAI;CACvC;CAEA,kBAAgC;EAC9B,IAAI,CAAC,KAAK,kBAAkB,QAAQ,KAAK,iBAAiB,UAAU,OAAO;EAE3E,MAAM,UAAU,KAAK;EACrB,MAAM,OAAO,KAAK;EAClB,KAAK,gBAAgB;EACrB,KAAK,eAAe,KAAA;EAEpB,IAAI,SAAS;GACX,KAAK,eAAe;GAGpB,KAAK,QAAQ,IAAI,QAAQ,MAAM,OAAO;GACtC,KAAK,aAAa,IAAI,QAAQ,IAAI;GAClC,QAAQ,SAAS;GACjB,KAAK,OAAO,KAAK,OAAO;GACxB,KAAK,SAAS,KAAK,KAAK;GACxB,QAAQ,UAAU,IAAI;EACxB;EAEA,KAAK,mBAAmB,KAAK,YAAY,MAAM,IAAI;CACrD;;CAGA,aAAqB,IAAkB;EACrC,MAAM,QAAQ,KAAK;EACnB,IAAI,OAAO,MAAM,SAAS;EAC1B,IAAI,OAAO,GAAG;EACd,OAAO,OAAO,KAAK,KAAK,SAAS,OAAO;EACxC,KAAK,IAAI,IAAI,MAAM,IAAI,MAAM,QAAQ,KAAK;GACxC,MAAM,QAAQ,MAAM;GACpB,MAAM,WAAW,EAAE;GACnB,MAAM,SAAS;EACjB;CACF;CAEA,kBAA0B,IAAkB;EAC1C,IAAI,CAAC,KAAK,kBAAkB;EAE5B,KAAK,YAAY,OAAO,KAAK,kBAAkB,EAAE;EAEjD,IAAI,KAAK,iBAAiB,MAAM;GAC9B,IAAI,KAAK,iBAAiB,UAAU,OAAO;IAEzC,IAAI,CAAC,KAAK,kBAAkB;KAC1B,KAAK,aAAa,EAAE;KACpB;IACF;IAEA,KAAK,gBAAgB;GACvB,OAEE,KAAK,mBAAmB;EAE5B;EAGA,KAAK,aAAa,EAAE;CACtB;AACF"}
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@flare-engine/scene",
3
- "version": "0.4.8",
3
+ "version": "0.4.11",
4
4
  "description": "Scene manager, transitions, lifecycle",
5
- "keywords": ["flare-engine", "scene", "transitions"],
5
+ "keywords": ["flare-engine", "scene", "transitions", "react-native", "typescript"],
6
6
  "license": "Apache-2.0",
7
7
  "author": "Grzegorz Otto",
8
8
  "homepage": "https://github.com/grzott/flare-engine#readme",
@@ -37,9 +37,9 @@
37
37
  "typecheck": "tsc --noEmit"
38
38
  },
39
39
  "dependencies": {
40
- "@flare-engine/ecs": "^0.4.8",
41
- "@flare-engine/math": "^0.4.8",
42
- "@flare-engine/render": "^0.4.8"
40
+ "@flare-engine/ecs": "^0.4.11",
41
+ "@flare-engine/math": "^0.4.11",
42
+ "@flare-engine/render": "^0.4.11"
43
43
  },
44
44
  "engines": {
45
45
  "node": ">=20"