brick-engine-js 1.0.16 → 1.0.17

package/README.adoc

@@ -56,7 +56,7 @@ The engine is organized into the following core modules:
 | Module | Description
 
 | xref:docs/reference/modules/Game.adoc[Game (Core)]
-| The central orchestrator. It manages the main loop (ticks and frames), and coordinates dynamic game loading and transitions via an instance-based switch handler.
+| The central orchestrator. It manages the main loop (ticks and frames) and maintains the lifecycle of all engine modules.
 
 | xref:docs/reference/modules/GameGrid.adoc[GameGrid]
 | Manages the 2D grid data structure. Handles cell values, colors, row/column operations, and collision detection. Includes `GameHudGrid` for custom HUD content.

package/dist/docs/getting-started.html

@@ -634,7 +634,7 @@ export default class MyGame extends Game {
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2026-02-23 16:20:59 -0300
+Last updated 2026-02-24 23:24:58 -0300
 </div>
 </div>
 <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.18.3/highlight.min.js"></script>

package/dist/docs/index.html

@@ -539,7 +539,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <tbody>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="reference/modules/Game.html">Game (Core)</a></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The central orchestrator. It manages the main loop (ticks and frames), and coordinates dynamic game loading and transitions via an instance-based switch handler.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The central orchestrator. It manages the main loop (ticks and frames) and maintains the lifecycle of all engine modules.</p></td>
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="reference/modules/GameGrid.html">GameGrid</a></p></td>

package/dist/docs/publishing.html

@@ -559,7 +559,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2026-02-23 16:10:29 -0300
+Last updated 2026-02-24 23:18:56 -0300
 </div>
 </div>
 <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.18.3/highlight.min.js"></script>

package/dist/docs/reference/interfaces/modules/Score.html

@@ -451,7 +451,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <li><a href="#getformattedscoredigits-number-string">2.3. <code>getFormattedScore(digits?: number): string</code></a></li>
 <li><a href="#increaselevelamount-number-void">2.4. <code>increaseLevel(amount: number): void</code></a></li>
 <li><a href="#resetlevel-void">2.5. <code>resetLevel(): void</code></a></li>
-<li><a href="#setstatestate-state-void">2.6. <code>setState(state: State): void</code></a></li>
+<li><a href="#setupgamehighscoreid-string-void">2.6. <code>setupGameHighScore(id: string): void</code></a></li>
 </ul>
 </li>
 <li><a href="#general-usage">3. General Usage</a></li>
@@ -616,9 +616,9 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="setstatestate-state-void"><a class="link" href="#setstatestate-state-void">2.6. <code>setState(state: <a href="State.html">State</a>): void</code></a></h3>
+<h3 id="setupgamehighscoreid-string-void"><a class="link" href="#setupgamehighscoreid-string-void">2.6. <code>setupGameHighScore(id: string): void</code></a></h3>
 <div class="paragraph">
-<p>Internal setup method to link the score module with high-score persistence logic.</p>
+<p>Initializes the high score for a specific game, loading it from namespaced storage.</p>
 </div>
 <div class="paragraph">
 <p><strong>Parameters</strong></p>
@@ -636,9 +636,9 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <td class="tableblock halign-left valign-top"><p class="tableblock">Description</p></td>
 </tr>
 <tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>state</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="State.html">State</a></code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The global state manager.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>id</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>string</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The unique identifier of the game (e.g., from <code><a href="../modules/Game.html">Game.gameId</a></code>).</p></td>
 </tr>
 </tbody>
 </table>

package/dist/docs/reference/interfaces/modules/Session.html

@@ -449,6 +449,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <li><a href="#_savesession_void">2.2. <code>saveSession(): void</code></a></li>
 <li><a href="#_clearsession_void">2.3. <code>clearSession(): void</code></a></li>
 <li><a href="#_setshowmodalfunctionshowmodal_onconfirm_void_oncancel_void_void_void">2.4. <code>setShowModalFunction(showModal: (onConfirm: () &#8658; void, onCancel: () &#8658; void) &#8658; void): void</code></a></li>
+<li><a href="#_setsessionenabledenabled_boolean_void">2.5. <code>setSessionEnabled(enabled: boolean): void</code></a></li>
 </ul>
 </li>
 <li><a href="#_general_usage">3. General Usage</a></li>
@@ -564,6 +565,35 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </tr>
 </tbody>
 </table>
+<hr>
+</div>
+<div class="sect2">
+<h3 id="_setsessionenabledenabled_boolean_void"><a class="link" href="#_setsessionenabledenabled_boolean_void">2.5. <code>setSessionEnabled(enabled: boolean): void</code></a></h3>
+<div class="paragraph">
+<p>Enables or disables the session recovery mechanism for the current game instance.</p>
+</div>
+<div class="paragraph">
+<p><strong>Parameters</strong></p>
+</div>
+<table class="tableblock frame-all grid-all stretch">
+<colgroup>
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 60%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Name</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Type</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Description</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>enabled</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>boolean</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Whether the session recovery should be enabled.</p></td>
+</tr>
+</tbody>
+</table>
 </div>
 </div>
 </div>
@@ -578,7 +608,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2026-02-23 16:03:34 -0300
+Last updated 2026-02-24 23:17:40 -0300
 </div>
 </div>
 </body>

package/dist/docs/reference/modules/Game.html

@@ -448,15 +448,12 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <ul class="sectlevel2">
 <li><a href="#addserializableserializable-serializable-void">2.1. <code>addSerializable(serializable: Serializable): void</code></a></li>
 <li><a href="#updatedeltatime-number-void">2.2. <code>update(deltaTime: number): void</code></a></li>
-<li><a href="#setswitchhandlerhandler-newgame-game-void-void">2.3. <code>setSwitchHandler(handler: (newGame: Game) &#8658; void): void</code></a></li>
-<li><a href="#propagateswitchhandlergame-game-void">2.4. <code>propagateSwitchHandler(game: Game): void</code></a></li>
-<li><a href="#updatedeltatime-number-void-2">2.5. <code>update(deltaTime: number): void</code></a></li>
-<li><a href="#render-void">2.6. <code>render(): void</code></a></li>
-<li><a href="#setupgame-void">2.7. <code>setupGame(): void</code></a></li>
-<li><a href="#drawtitlescreen-void">2.8. <code>drawTitleScreen(): void</code></a></li>
-<li><a href="#drawgameoverscreen-void">2.9. <code>drawGameOverScreen(): void</code></a></li>
-<li><a href="#switchgamenewgame-game-void">2.10. <code>switchGame(newGame: Game): void</code></a></li>
-<li><a href="#destroy-void">2.11. <code>destroy(): void</code></a></li>
+<li><a href="#updatedeltatime-number-void-2">2.3. <code>update(deltaTime: number): void</code></a></li>
+<li><a href="#render-void">2.4. <code>render(): void</code></a></li>
+<li><a href="#setupgame-void">2.5. <code>setupGame(): void</code></a></li>
+<li><a href="#drawtitlescreen-void">2.6. <code>drawTitleScreen(): void</code></a></li>
+<li><a href="#drawgameoverscreen-void">2.7. <code>drawGameOverScreen(): void</code></a></li>
+<li><a href="#destroy-void">2.8. <code>destroy(): void</code></a></li>
 </ul>
 </li>
 <li><a href="#session-management">3. Session Management</a></li>
@@ -469,7 +466,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <div id="preamble">
 <div class="sectionbody">
 <div class="paragraph">
-<p>The <code>Game</code> class is the heart of your application. It manages the game loop (ticks and frames), initialization of core modules, session restoration, and integration with P5.js. All games must extend this class.</p>
+<p>The <code>Game</code> class is the heart of your application. It manages the game loop (ticks and frames), initialization of core modules, and integration with P5.js. All games must extend this class.</p>
 </div>
 </div>
 </div>
@@ -571,72 +568,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="setswitchhandlerhandler-newgame-game-void-void"><a class="link" href="#setswitchhandlerhandler-newgame-game-void-void">2.3. <code>setSwitchHandler(handler: (newGame: Game) &#8658; void): void</code></a></h3>
-<div class="paragraph">
-<p>Registers the callback to be used when a game requests to switch to another game.</p>
-</div>
-<div class="paragraph">
-<p><strong>Parameters</strong></p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 20%;">
-<col style="width: 20%;">
-<col style="width: 60%;">
-</colgroup>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>handler</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Function</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The callback function receiving the target <code><a href="../modules/Game.html">Game</a></code> instance.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p><strong>Behavior</strong></p>
-</div>
-<div class="paragraph">
-<p>This method is used by the engine orchestrator (typically in <code>main.ts</code>) to define how game switches should be handled (e.g., re-binding controls, resetting the debugger). It allows the <code>Game</code> class to remain decoupled from the specific implementation of the menu or other games.</p>
-</div>
-<hr>
-</div>
-<div class="sect2">
-<h3 id="propagateswitchhandlergame-game-void"><a class="link" href="#propagateswitchhandlergame-game-void">2.4. <code>propagateSwitchHandler(game: Game): void</code></a></h3>
-<div class="paragraph">
-<p>Copies the active switch handler from one game instance to another.</p>
-</div>
-<div class="paragraph">
-<p><strong>Parameters</strong></p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 20%;">
-<col style="width: 20%;">
-<col style="width: 60%;">
-</colgroup>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Type</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Description</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>game</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="../modules/Game.html">Game</a></code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The source game instance providing the handler.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p><strong>Behavior</strong></p>
-</div>
-<div class="paragraph">
-<p>Ensures continuity of the orchestration logic during a switch. When a new game is instantiated and about to become active, this method is called to pass the <code>_switchHandler</code> from the current <code>activeGame</code> to the new one.</p>
-</div>
-<hr>
-</div>
-<div class="sect2">
-<h3 id="updatedeltatime-number-void-2"><a class="link" href="#updatedeltatime-number-void-2">2.5. <code>update(deltaTime: number): void</code></a></h3>
+<h3 id="updatedeltatime-number-void-2"><a class="link" href="#updatedeltatime-number-void-2">2.3. <code>update(deltaTime: number): void</code></a></h3>
 <div class="paragraph">
 <p>Abstract method for processing game logic.</p>
 </div>
@@ -682,7 +614,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="render-void"><a class="link" href="#render-void">2.6. <code>render(): void</code></a></h3>
+<h3 id="render-void"><a class="link" href="#render-void">2.4. <code>render(): void</code></a></h3>
 <div class="paragraph">
 <p>Abstract method for processing visual frames.</p>
 </div>
@@ -705,7 +637,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="setupgame-void"><a class="link" href="#setupgame-void">2.7. <code>setupGame(): void</code></a></h3>
+<h3 id="setupgame-void"><a class="link" href="#setupgame-void">2.5. <code>setupGame(): void</code></a></h3>
 <div class="paragraph">
 <p>Abstract method for setting up the specific game instance.</p>
 </div>
@@ -728,7 +660,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="drawtitlescreen-void"><a class="link" href="#drawtitlescreen-void">2.8. <code>drawTitleScreen(): void</code></a></h3>
+<h3 id="drawtitlescreen-void"><a class="link" href="#drawtitlescreen-void">2.6. <code>drawTitleScreen(): void</code></a></h3>
 <div class="paragraph">
 <p>Abstract method for rendering the game&#8217;s welcome screen.</p>
 </div>
@@ -741,7 +673,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="drawgameoverscreen-void"><a class="link" href="#drawgameoverscreen-void">2.9. <code>drawGameOverScreen(): void</code></a></h3>
+<h3 id="drawgameoverscreen-void"><a class="link" href="#drawgameoverscreen-void">2.7. <code>drawGameOverScreen(): void</code></a></h3>
 <div class="paragraph">
 <p>Abstract method for rendering the screen after a game ends.</p>
 </div>
@@ -752,60 +684,10 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <p>Called when the game state is <code>gameOver</code>. Executed as the primary rendering logic during Game Over, replacing the standard <code>render()</code> call to allow for clean menus or high-score displays.</p>
 </div>
 <hr>
-</div>
-<div class="sect2">
-<h3 id="switchgamenewgame-game-void"><a class="link" href="#switchgamenewgame-game-void">2.10. <code>switchGame(newGame: Game): void</code></a></h3>
-<div class="paragraph">
-<p>Switches execution to a new game instance.</p>
-</div>
-<div class="paragraph">
-<p><strong>Parameters</strong></p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 20%;">
-<col style="width: 20%;">
-<col style="width: 60%;">
-</colgroup>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Name</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Type</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Description</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>newGame</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Game</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The instance of the new game class to load.</p></td>
-</tr>
-</tbody>
-</table>
-<div class="paragraph">
-<p><strong>Behavior</strong></p>
-</div>
-<div class="paragraph">
-<p>Destroys the current game instance (cleaning up listeners and stopping sound) and passes the new instance to the registered <code>_switchHandler</code>. This is the core mechanism for moving between different games or menus.</p>
-</div>
-<div class="quoteblock">
-<blockquote>
-<div class="paragraph">
-<p>[!NOTE]
-The switch handler must be set or propagated before calling this method, otherwise an error will be logged.</p>
-</div>
-</blockquote>
-</div>
-<div class="paragraph">
-<p><strong>Example</strong></p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-typescript hljs" data-lang="typescript">this.switchGame(new MyOtherGame(this.p, this.view));</code></pre>
-</div>
-</div>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="destroy-void"><a class="link" href="#destroy-void">2.11. <code>destroy(): void</code></a></h3>
+<h3 id="destroy-void"><a class="link" href="#destroy-void">2.8. <code>destroy(): void</code></a></h3>
 <div class="paragraph">
 <p>Cleans up the game instance.</p>
 </div>
@@ -887,7 +769,7 @@ The switch handler must be set or propagated before calling this method, otherwi
 </div>
 </li>
 <li>
-<p><strong>EXIT</strong>: Clears the active session and performs a hard stop of the draw loop. In server mode, the orchestrator typically uses the switch handler to return to the <code>GameMenu</code>.</p>
+<p><strong>EXIT</strong>: Clears the active session and performs a hard stop of the draw loop. The specific behavior after stopping depends on the external orchestrator (e.g., returning to a menu).</p>
 </li>
 </ul>
 </div>

package/dist/docs/reference/modules/GameScore.html

@@ -453,10 +453,11 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <li><a href="#resetscore-void">1.6. <code>resetScore(): void</code></a></li>
 <li><a href="#increaselevelamount-number-void">1.7. <code>increaseLevel(amount: number): void</code></a></li>
 <li><a href="#resetlevel-void">1.8. <code>resetLevel(): void</code></a></li>
-<li><a href="#getformattedscoredigits-number-string">1.9. <code>getFormattedScore(digits: number): string</code></a></li>
-<li><a href="#serialize-string">1.10. <code>serialize(): string</code></a></li>
-<li><a href="#deserializedata-string-void">1.11. <code>deserialize(data: string): void</code></a></li>
-<li><a href="#getdebugdata-recordstring-string-number-boolean">1.12. <code>getDebugData(): Record&lt;string, string | number | boolean&gt;</code></a></li>
+<li><a href="#setupgamehighscoreid-string-void">1.9. <code>setupGameHighScore(id: string): void</code></a></li>
+<li><a href="#getformattedscoredigits-number-string">1.10. <code>getFormattedScore(digits: number): string</code></a></li>
+<li><a href="#serialize-string">1.11. <code>serialize(): string</code></a></li>
+<li><a href="#deserializedata-string-void">1.12. <code>deserialize(data: string): void</code></a></li>
+<li><a href="#getdebugdata-recordstring-string-number-boolean">1.13. <code>getDebugData(): Record&lt;string, string | number | boolean&gt;</code></a></li>
 </ul>
 </li>
 </ul>
@@ -503,7 +504,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <p><strong>Behavior</strong></p>
 </div>
 <div class="paragraph">
-<p>When set, it automatically persists the value directly to <code>LocalStorage</code> under the <code>highScore</code> key. It does not use <code>GameState</code> for this persistence.</p>
+<p>When set, it automatically persists the value directly to <code>LocalStorage</code> under the namespaced key <code>${gameId}::highScore</code>. This ensures that different games do not overwrite each other&#8217;s records.</p>
 </div>
 <hr>
 </div>
@@ -581,12 +582,41 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <div class="sect2">
 <h3 id="resetlevel-void"><a class="link" href="#resetlevel-void">1.8. <code>resetLevel(): void</code></a></h3>
 <div class="paragraph">
-<p>Resets the level counter to 1.</p>
+<p>Resets the level counter to 1.
+'''</p>
 </div>
+</div>
+<div class="sect2">
+<h3 id="setupgamehighscoreid-string-void"><a class="link" href="#setupgamehighscoreid-string-void">1.9. <code>setupGameHighScore(id: string): void</code></a></h3>
+<div class="paragraph">
+<p>Initializes the module with the specific game ID and loads the corresponding high score.</p>
+</div>
+<div class="paragraph">
+<p><strong>Parameters</strong></p>
+</div>
+<table class="tableblock frame-all grid-all stretch">
+<colgroup>
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 60%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Name</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Type</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Description</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>id</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>string</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The unique game identifier used as a prefix for LocalStorage.</p></td>
+</tr>
+</tbody>
+</table>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="getformattedscoredigits-number-string"><a class="link" href="#getformattedscoredigits-number-string">1.9. <code>getFormattedScore(digits: number): string</code></a></h3>
+<h3 id="getformattedscoredigits-number-string"><a class="link" href="#getformattedscoredigits-number-string">1.10. <code>getFormattedScore(digits: number): string</code></a></h3>
 <div class="paragraph">
 <p>Returns the score as a padded string suitable for HUD display.</p>
 </div>
@@ -621,7 +651,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="serialize-string"><a class="link" href="#serialize-string">1.10. <code>serialize(): string</code></a></h3>
+<h3 id="serialize-string"><a class="link" href="#serialize-string">1.11. <code>serialize(): string</code></a></h3>
 <div class="paragraph">
 <p><strong>Behavior</strong></p>
 </div>
@@ -631,7 +661,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="deserializedata-string-void"><a class="link" href="#deserializedata-string-void">1.11. <code>deserialize(data: string): void</code></a></h3>
+<h3 id="deserializedata-string-void"><a class="link" href="#deserializedata-string-void">1.12. <code>deserialize(data: string): void</code></a></h3>
 <div class="paragraph">
 <p><strong>Behavior</strong></p>
 </div>
@@ -641,7 +671,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="getdebugdata-recordstring-string-number-boolean"><a class="link" href="#getdebugdata-recordstring-string-number-boolean">1.12. <code>getDebugData(): Record&lt;string, string | number | boolean&gt;</code></a></h3>
+<h3 id="getdebugdata-recordstring-string-number-boolean"><a class="link" href="#getdebugdata-recordstring-string-number-boolean">1.13. <code>getDebugData(): Record&lt;string, string | number | boolean&gt;</code></a></h3>
 <div class="paragraph">
 <p>Returns metadata for the real-time debugger.</p>
 </div>

package/dist/docs/reference/modules/GameSession.html

@@ -445,8 +445,9 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <li><a href="#_session_management">1. Session Management</a>
 <ul class="sectlevel2">
 <li><a href="#_savesession_void">1.1. <code>saveSession(): void</code></a></li>
-<li><a href="#_clearsession_void">1.2. <code>clearSession(): void</code></a></li>
-<li><a href="#_syncstatestate_state_void">1.3. <code>syncState(state: State): void</code></a></li>
+<li><a href="#_setsessionenabledenabled_boolean_void">1.2. <code>setSessionEnabled(enabled: boolean): void</code></a></li>
+<li><a href="#_clearsession_void">1.3. <code>clearSession(): void</code></a></li>
+<li><a href="#_syncstatestate_state_void">1.4. <code>syncState(state: State): void</code></a></li>
 </ul>
 </li>
 <li><a href="#_internals">2. Internals</a></li>
@@ -467,17 +468,46 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <div class="sect2">
 <h3 id="_savesession_void"><a class="link" href="#_savesession_void">1.1. <code>saveSession(): void</code></a></h3>
 <div class="paragraph">
-<p>Creates or updates the session. Early returns if the <code>GameID</code> belongs to the main menu (<code>game-menu</code>) or if the <code>SessionModal</code> (if existing) has not been confirmed/rejected yet.</p>
+<p>Creates or updates the session. Early returns if the session is disabled (via <code>setSessionEnabled</code>) or if the <code>SessionModal</code> (if existing) has not been confirmed/rejected yet.</p>
 </div>
+<hr>
 </div>
 <div class="sect2">
-<h3 id="_clearsession_void"><a class="link" href="#_clearsession_void">1.2. <code>clearSession(): void</code></a></h3>
+<h3 id="_setsessionenabledenabled_boolean_void"><a class="link" href="#_setsessionenabledenabled_boolean_void">1.2. <code>setSessionEnabled(enabled: boolean): void</code></a></h3>
+<div class="paragraph">
+<p>Enables or disables the session recovery mechanism. When disabled, the engine will neither show the session recovery modal nor save the session.</p>
+</div>
+<div class="paragraph">
+<p><strong>Parameters</strong></p>
+</div>
+<table class="tableblock frame-all grid-all stretch">
+<colgroup>
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 60%;">
+</colgroup>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Name</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Type</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Description</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>enabled</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>boolean</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Whether the session should be enabled.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect2">
+<h3 id="_clearsession_void"><a class="link" href="#_clearsession_void">1.3. <code>clearSession(): void</code></a></h3>
 <div class="paragraph">
 <p>Removes the saved instances from <code>localStorage</code>.</p>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_syncstatestate_state_void"><a class="link" href="#_syncstatestate_state_void">1.3. <code>syncState(state: State): void</code></a></h3>
+<h3 id="_syncstatestate_state_void"><a class="link" href="#_syncstatestate_state_void">1.4. <code>syncState(state: State): void</code></a></h3>
 <div class="paragraph">
 <p>Subscribes to <code><a href="GameState.html">GameState</a></code> interactions.</p>
 </div>
@@ -508,7 +538,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 <div class="paragraph">
 <p>Reacts to:
-- <code>PLAYING</code>: If a session for the current <code>gameId</code> exists, is NOT the game menu, and the modal hasn&#8217;t been closed, it invokes the modal via <code>_showSessionModal</code>. If accepted, calls deserialize on all registered targets. If canceled or if no previous session exists, proceeds normally. The modal state is tracked to prevent re-triggering during the same power cycle.
+- <code>PLAYING</code>: If a session for the current <code>gameId</code> exists, session is enabled, and the modal hasn&#8217;t been closed, it invokes the modal via <code>_showSessionModal</code>. If accepted, calls deserialize on all registered targets. If canceled or if no previous session exists, proceeds normally. The modal state is tracked to prevent re-triggering during the same power cycle.
 - <code>ON</code> (when false): Resets the modal state tracking closure, allowing the session modal to appear again after the device is powered back on.
 - <code>GAME_OVER</code>: Clears active session entirely.</p>
 </div>
@@ -526,7 +556,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2026-02-22 22:09:51 -0300
+Last updated 2026-02-24 23:17:20 -0300
 </div>
 </div>
 </body>