@flare-engine/scene 0.4.12 → 0.4.13

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/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\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 private _warnedPendingGo = false;\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 * Ignored while an animated `go()` is still fading out — that `go()` clears\n * the stack when the fade-out ends; nothing is called and nothing changes.\n */\n async push(name: string, data?: unknown, options?: ScenePushOptions): Promise<void> {\n if (this._refusedByPendingGo()) return;\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 * Ignored while an animated `go()` is still fading out — that `go()` clears\n * the stack when the fade-out ends; nothing is called and nothing changes.\n */\n pop(options?: ScenePopOptions): void {\n if (this._refusedByPendingGo()) return;\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 /** True while an animated `go()` target is pending; warns once per manager in dev. */\n private _refusedByPendingGo(): boolean {\n const pending = this._pendingScene;\n if (!pending) return false;\n if (!this._warnedPendingGo && typeof __DEV__ !== 'undefined' && __DEV__) {\n this._warnedPendingGo = true;\n console.warn(\n `[SceneManager] push()/pop() ignored while go('${pending.name}') is fading out; call them after the fade-out ends`,\n );\n }\n return true;\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;CACtB,mBAA2B;;CAG3B,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;;;;;;;;CASA,MAAM,KAAK,MAAc,MAAgB,SAA2C;EAClF,IAAI,KAAK,oBAAoB,GAAG;EAChC,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;;;;;;;;;CAUA,IAAI,SAAiC;EACnC,IAAI,KAAK,oBAAoB,GAAG;EAChC,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;;CAGA,sBAAuC;EACrC,MAAM,UAAU,KAAK;EACrB,IAAI,CAAC,SAAS,OAAO;EACrB,IAAI,CAAC,KAAK,oBAAoB,OAAO,YAAY,eAAe,SAAS;GACvE,KAAK,mBAAmB;GACxB,QAAQ,KACN,iDAAiD,QAAQ,KAAK,oDAChE;EACF;EACA,OAAO;CACT;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,IAAIA,kBAAAA,MAAM,GAAG,IAAIC,qBAAAA,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"}
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 private _warnedPendingGo = false;\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 * Ignored while an animated `go()` is still fading out — that `go()` clears\n * the stack when the fade-out ends; nothing is called and nothing changes.\n */\n async push(name: string, data?: unknown, options?: ScenePushOptions): Promise<void> {\n if (this._refusedByPendingGo()) return;\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 * Ignored while an animated `go()` is still fading out — that `go()` clears\n * the stack when the fade-out ends; nothing is called and nothing changes.\n */\n pop(options?: ScenePopOptions): void {\n if (this._refusedByPendingGo()) return;\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 /** True while an animated `go()` target is pending; warns once per manager in dev. */\n private _refusedByPendingGo(): boolean {\n const pending = this._pendingScene;\n if (!pending) return false;\n if (!this._warnedPendingGo && typeof __DEV__ !== 'undefined' && __DEV__) {\n this._warnedPendingGo = true;\n console.warn(\n `[SceneManager] push()/pop() ignored while go('${pending.name}') is fading out; call them after the fade-out ends`,\n );\n }\n return true;\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;CAChB,6BAAa,IAAI,IAA0B;CAC3C,0BAAU,IAAI,IAAmB;CACjC,+BAAe,IAAI,IAAY;CAC/B,SAAkB,CAAC;;CAEnB,WAAsB,CAAC;;CAEvB,wBAAQ,IAAI,IAAW;CACvB,cAA0B,eAAe;CACzC,mBAA2C;CAC3C,gBAA8B;CAC9B,eAAwB,KAAA;CACxB,mBAAmB;CACnB,cAAc;CACd,mBAAmB;;CAG3B,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;QAEnB,QAAQ,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;;;;;;;;CASA,MAAM,KAAK,MAAc,MAAgB,SAA2C;EAClF,IAAI,KAAK,oBAAoB,GAAG;EAChC,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;;;;;;;;;CAUA,IAAI,SAAiC;EACnC,IAAI,KAAK,oBAAoB,GAAG;EAChC,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;;CAGQ,sBAA+B;EACrC,MAAM,UAAU,KAAK;EACrB,IAAI,CAAC,SAAS,OAAO;EACrB,IAAI,CAAC,KAAK,oBAAoB,OAAO,YAAY,eAAe,SAAS;GACvE,KAAK,mBAAmB;GACxB,QAAQ,KACN,iDAAiD,QAAQ,KAAK,oDAChE;EACF;EACA,OAAO;CACT;CAEQ,aAAa,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,IAAIA,kBAAAA,MAAM,GAAG,IAAIC,qBAAAA,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;;CAGQ,iBAAuB;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;;;;;;;CAQQ,eAAqB;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;;;;;;;;CASQ,kBAAwB;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;CAEQ,kBAAwB;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;;CAGQ,aAAa,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;CAEQ,kBAAkB,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"}
@@ -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\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 private _warnedPendingGo = false;\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 * Ignored while an animated `go()` is still fading out — that `go()` clears\n * the stack when the fade-out ends; nothing is called and nothing changes.\n */\n async push(name: string, data?: unknown, options?: ScenePushOptions): Promise<void> {\n if (this._refusedByPendingGo()) return;\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 * Ignored while an animated `go()` is still fading out — that `go()` clears\n * the stack when the fade-out ends; nothing is called and nothing changes.\n */\n pop(options?: ScenePopOptions): void {\n if (this._refusedByPendingGo()) return;\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 /** True while an animated `go()` target is pending; warns once per manager in dev. */\n private _refusedByPendingGo(): boolean {\n const pending = this._pendingScene;\n if (!pending) return false;\n if (!this._warnedPendingGo && typeof __DEV__ !== 'undefined' && __DEV__) {\n this._warnedPendingGo = true;\n console.warn(\n `[SceneManager] push()/pop() ignored while go('${pending.name}') is fading out; call them after the fade-out ends`,\n );\n }\n return true;\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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"}
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 private _warnedPendingGo = false;\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 * Ignored while an animated `go()` is still fading out — that `go()` clears\n * the stack when the fade-out ends; nothing is called and nothing changes.\n */\n async push(name: string, data?: unknown, options?: ScenePushOptions): Promise<void> {\n if (this._refusedByPendingGo()) return;\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 * Ignored while an animated `go()` is still fading out — that `go()` clears\n * the stack when the fade-out ends; nothing is called and nothing changes.\n */\n pop(options?: ScenePopOptions): void {\n if (this._refusedByPendingGo()) return;\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 /** True while an animated `go()` target is pending; warns once per manager in dev. */\n private _refusedByPendingGo(): boolean {\n const pending = this._pendingScene;\n if (!pending) return false;\n if (!this._warnedPendingGo && typeof __DEV__ !== 'undefined' && __DEV__) {\n this._warnedPendingGo = true;\n console.warn(\n `[SceneManager] push()/pop() ignored while go('${pending.name}') is fading out; call them after the fade-out ends`,\n );\n }\n return true;\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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@flare-engine/scene",
3
- "version": "0.4.12",
3
+ "version": "0.4.13",
4
4
  "description": "Scene manager, transitions, lifecycle",
5
5
  "keywords": ["flare-engine", "scene", "transitions", "react-native", "typescript"],
6
6
  "license": "Apache-2.0",
@@ -37,9 +37,9 @@
37
37
  "typecheck": "tsc --noEmit"
38
38
  },
39
39
  "dependencies": {
40
- "@flare-engine/ecs": "^0.4.12",
41
- "@flare-engine/math": "^0.4.12",
42
- "@flare-engine/render": "^0.4.12"
40
+ "@flare-engine/ecs": "^0.4.13",
41
+ "@flare-engine/math": "^0.4.13",
42
+ "@flare-engine/render": "^0.4.13"
43
43
  },
44
44
  "engines": {
45
45
  "node": ">=20"