brick-engine-js 1.0.21 → 1.0.23

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

@@ -443,35 +443,38 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <div id="toc" class="toc2">
 <div id="toctitle">Table of Contents</div>
 <ul class="sectlevel1">
-<li><a href="#properties">1. Properties</a></li>
-<li><a href="#api-reference">2. API Reference</a>
+<li><a href="#architectural-purpose">1. Architectural Purpose</a></li>
+<li><a href="#properties">2. Properties</a></li>
+<li><a href="#api-reference">3. API Reference</a>
 <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="#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>
+<li><a href="#addserializableserializable-serializable-void">3.1. <code>addSerializable(serializable: Serializable): void</code></a></li>
+<li><a href="#updatedeltatime-number-void">3.2. <code>update(deltaTime: number): void</code></a></li>
+<li><a href="#updatedeltatime-number-void-2">3.3. <code>update(deltaTime: number): void</code></a></li>
+<li><a href="#render-void">3.4. <code>render(): void</code></a></li>
+<li><a href="#setupgame-void">3.5. <code>setupGame(): void</code></a></li>
+<li><a href="#drawtitlescreen-void">3.6. <code>drawTitleScreen(): void</code></a></li>
+<li><a href="#drawgameoverscreen-void">3.7. <code>drawGameOverScreen(): void</code></a></li>
+<li><a href="#reset-void">3.8. <code>reset(): void</code></a></li>
+<li><a href="#destroy-void">3.9. <code>destroy(): void</code></a></li>
 </ul>
 </li>
-<li><a href="#session-management">3. Session Management</a></li>
-<li><a href="#automatic-state-restoration-reset">4. Automatic State Restoration (Reset)</a></li>
-<li><a href="#automated-system-controls">5. Automated System Controls</a></li>
+<li><a href="#session-management">4. Session Management</a></li>
+<li><a href="#automatic-state-restoration-reset">5. Automatic State Restoration (Reset)</a></li>
+<li><a href="#automated-system-controls">6. Automated System Controls</a></li>
 </ul>
 </div>
 </div>
 <div id="content">
-<div id="preamble">
+<div class="sect1">
+<h2 id="architectural-purpose"><a class="link" href="#architectural-purpose">1. Architectural Purpose</a></h2>
 <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, and integration with P5.js. All games must extend this class.</p>
+<p>The <code>Game</code> class establishes the central integration boundary encapsulating physical logic away from native visual outputs. Acting as the core orchestrator, it explicitly synchronizes frame drawing metrics while processing isolated mathematical model iterations. This architecture guarantees the internal data state remains cleanly decoupled and uncorrupted regardless of overlapping browser interfaces or runtime execution layers.</p>
 </div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="properties"><a class="link" href="#properties">1. Properties</a></h2>
+<h2 id="properties"><a class="link" href="#properties">2. Properties</a></h2>
 <div class="sectionbody">
 <table class="tableblock frame-all grid-all stretch">
 <colgroup>
@@ -500,11 +503,11 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="api-reference"><a class="link" href="#api-reference">2. API Reference</a></h2>
+<h2 id="api-reference"><a class="link" href="#api-reference">3. API Reference</a></h2>
 <div class="sectionbody">
 <hr>
 <div class="sect2">
-<h3 id="addserializableserializable-serializable-void"><a class="link" href="#addserializableserializable-serializable-void">2.1. <code>addSerializable(serializable: Serializable): void</code></a></h3>
+<h3 id="addserializableserializable-serializable-void"><a class="link" href="#addserializableserializable-serializable-void">3.1. <code>addSerializable(serializable: Serializable): void</code></a></h3>
 <div class="paragraph">
 <p>Registers a custom object or module for session persistence.</p>
 </div>
@@ -539,7 +542,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="updatedeltatime-number-void"><a class="link" href="#updatedeltatime-number-void">2.2. <code>update(deltaTime: number): void</code></a></h3>
+<h3 id="updatedeltatime-number-void"><a class="link" href="#updatedeltatime-number-void">3.2. <code>update(deltaTime: number): void</code></a></h3>
 <div class="paragraph">
 <p>Abstract method for processing game logic.</p>
 </div>
@@ -568,7 +571,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="updatedeltatime-number-void-2"><a class="link" href="#updatedeltatime-number-void-2">2.3. <code>update(deltaTime: number): void</code></a></h3>
+<h3 id="updatedeltatime-number-void-2"><a class="link" href="#updatedeltatime-number-void-2">3.3. <code>update(deltaTime: number): void</code></a></h3>
 <div class="paragraph">
 <p>Abstract method for processing game logic.</p>
 </div>
@@ -614,7 +617,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.4. <code>render(): void</code></a></h3>
+<h3 id="render-void"><a class="link" href="#render-void">3.4. <code>render(): void</code></a></h3>
 <div class="paragraph">
 <p>Abstract method for processing visual frames.</p>
 </div>
@@ -637,7 +640,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.5. <code>setupGame(): void</code></a></h3>
+<h3 id="setupgame-void"><a class="link" href="#setupgame-void">3.5. <code>setupGame(): void</code></a></h3>
 <div class="paragraph">
 <p>Abstract method for setting up the specific game instance.</p>
 </div>
@@ -660,7 +663,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.6. <code>drawTitleScreen(): void</code></a></h3>
+<h3 id="drawtitlescreen-void"><a class="link" href="#drawtitlescreen-void">3.6. <code>drawTitleScreen(): void</code></a></h3>
 <div class="paragraph">
 <p>Abstract method for rendering the game&#8217;s welcome screen.</p>
 </div>
@@ -673,7 +676,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.7. <code>drawGameOverScreen(): void</code></a></h3>
+<h3 id="drawgameoverscreen-void"><a class="link" href="#drawgameoverscreen-void">3.7. <code>drawGameOverScreen(): void</code></a></h3>
 <div class="paragraph">
 <p>Abstract method for rendering the screen after a game ends.</p>
 </div>
@@ -684,10 +687,29 @@ 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>
-<hr>
 </div>
 <div class="sect2">
-<h3 id="destroy-void"><a class="link" href="#destroy-void">2.8. <code>destroy(): void</code></a></h3>
+<h3 id="reset-void"><a class="link" href="#reset-void">3.8. <code>reset(): void</code></a></h3>
+<div class="paragraph">
+<p>Resets the game to its initial state.</p>
+</div>
+<div class="paragraph">
+<p><strong>Behavior</strong></p>
+</div>
+<div class="paragraph">
+<p>This method performs a comprehensive reset of the game, including:
+- Clearing the <code><a href="../interfaces/modules/Grid.html">Grid</a></code>.
+- Resetting the <code><a href="../interfaces/modules/Score.html">Score</a></code> and level.
+- Resetting the <code><a href="../interfaces/modules/Time.html">Time</a></code> accumulators.
+- Clearing the active <code><a href="../interfaces/modules/Session.html">Session</a></code>.
+- Restoring all custom game properties to their post-setup values via the <code><a href="InitialStateSnapshot.html">InitialStateSnapshot</a></code>.</p>
+</div>
+<div class="paragraph">
+<p>This method is called by the <code><a href="GameEventRegistry.html">GameEventRegistry</a></code> during power cycles and manual restarts.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="destroy-void"><a class="link" href="#destroy-void">3.9. <code>destroy(): void</code></a></h3>
 <div class="paragraph">
 <p>Cleans up the game instance.</p>
 </div>
@@ -701,7 +723,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="session-management"><a class="link" href="#session-management">3. Session Management</a></h2>
+<h2 id="session-management"><a class="link" href="#session-management">4. Session Management</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>The <code>Game</code> base class automatically orchestrates gameplay sessions by subscribing to system-level <code><a href="GameState.html">GameState</a></code> events:</p>
@@ -709,7 +731,10 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <div class="ulist">
 <ul>
 <li>
-<p><strong>Restoring Sessions</strong>: When the state changes to <code>PLAYING</code>, the <code>Game</code> checks if there are any active sessions stored for its registered <code>Serializable</code> instances. If an active session is detected, it triggers a UI modal asking the user if they wish to resume their previous session.</p>
+<p><strong>Restoring Sessions</strong>: When the state changes to <code>PLAYING</code>, the <code>Game</code> checks if there are any active sessions stored. If detected, it triggers a UI modal.</p>
+</li>
+<li>
+<p><strong>Loop Blocking</strong>: While the session restoration modal is open (<code>session.isModalOpen()</code>), the engine <strong>completely skips</strong> the <code>draw()</code> loop content (both logic and rendering) to prevent any background interaction while the user is choosing whether to resume. See <code><a href="../interfaces/modules/Session.html">Session</a></code> for more details.</p>
 </li>
 <li>
 <p><strong>Clearing Sessions</strong>: The active session is automatically wiped when the state changes to <code>GAME_OVER</code>, ensuring that players do not resume a lost game.</p>
@@ -719,7 +744,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="automatic-state-restoration-reset"><a class="link" href="#automatic-state-restoration-reset">4. Automatic State Restoration (Reset)</a></h2>
+<h2 id="automatic-state-restoration-reset"><a class="link" href="#automatic-state-restoration-reset">5. Automatic State Restoration (Reset)</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>To provide a seamless developer experience, the <code>Game</code> class implements an internal mechanism to transparently cache and restore custom client properties.</p>
@@ -733,7 +758,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="automated-system-controls"><a class="link" href="#automated-system-controls">5. Automated System Controls</a></h2>
+<h2 id="automated-system-controls"><a class="link" href="#automated-system-controls">6. Automated System Controls</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>The <code>Game</code> base class automatically registers listeners for system-level buttons:</p>

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

@@ -443,38 +443,40 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <div id="toc" class="toc2">
 <div id="toctitle">Table of Contents</div>
 <ul class="sectlevel1">
-<li><a href="#supported-keys-controlkey">1. Supported Keys (<code>ControlKey</code>)</a></li>
-<li><a href="#api-reference">2. API Reference</a>
+<li><a href="#architectural-purpose">1. Architectural Purpose</a></li>
+<li><a href="#supported-keys-controlkey">2. Supported Keys (<code>ControlKey</code>)</a></li>
+<li><a href="#api-reference">3. API Reference</a>
 <ul class="sectlevel2">
-<li><a href="#subscribekey-controlkey-type-controleventtype-callback-controlcallback-void">2.1. <code>subscribe(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
-<li><a href="#unsubscribekey-controlkey-type-controleventtype-callback-controlcallback-void">2.2. <code>unsubscribe(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
-<li><a href="#subscribefortitlescreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.3. <code>subscribeForTitleScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
-<li><a href="#unsubscribefortitlescreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.4. <code>unsubscribeForTitleScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
-<li><a href="#subscribeforgameoverscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.5. <code>subscribeForGameOverScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
-<li><a href="#unsubscribeforgameoverscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.6. <code>unsubscribeForGameOverScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
-<li><a href="#subscribeforplayingscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.7. <code>subscribeForPlayingScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
-<li><a href="#unsubscribeforplayingscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.8. <code>unsubscribeForPlayingScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
-<li><a href="#subscribeforpausedscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.9. <code>subscribeForPausedScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
-<li><a href="#unsubscribeforpausedscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.10. <code>unsubscribeForPausedScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
-<li><a href="#bindcontrols-void">2.11. <code>bindControls(): void</code></a></li>
-<li><a href="#unbindcontrols-void">2.12. <code>unbindControls(): void</code></a></li>
-<li><a href="#notifykey-controlkey-type-controleventtype-void">2.13. <code>notify(key: ControlKey, type: ControlEventType): void</code></a></li>
-<li><a href="#getdebugdata-recordstring-string-number-boolean">2.14. <code>getDebugData(): Record&lt;string, string | number | boolean&gt;</code></a></li>
+<li><a href="#subscribekey-controlkey-type-controleventtype-callback-controlcallback-void">3.1. <code>subscribe(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
+<li><a href="#unsubscribekey-controlkey-type-controleventtype-callback-controlcallback-void">3.2. <code>unsubscribe(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
+<li><a href="#subscribefortitlescreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.3. <code>subscribeForTitleScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
+<li><a href="#unsubscribefortitlescreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.4. <code>unsubscribeForTitleScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
+<li><a href="#subscribeforgameoverscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.5. <code>subscribeForGameOverScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
+<li><a href="#unsubscribeforgameoverscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.6. <code>unsubscribeForGameOverScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
+<li><a href="#subscribeforplayingscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.7. <code>subscribeForPlayingScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
+<li><a href="#unsubscribeforplayingscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.8. <code>unsubscribeForPlayingScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
+<li><a href="#subscribeforpausedscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.9. <code>subscribeForPausedScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
+<li><a href="#unsubscribeforpausedscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.10. <code>unsubscribeForPausedScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></li>
+<li><a href="#bindcontrols-void">3.11. <code>bindControls(): void</code></a></li>
+<li><a href="#unbindcontrols-void">3.12. <code>unbindControls(): void</code></a></li>
+<li><a href="#notifykey-controlkey-type-controleventtype-void">3.13. <code>notify(key: ControlKey, type: ControlEventType): void</code></a></li>
+<li><a href="#getdebugdata-recordstring-string-number-boolean">3.14. <code>getDebugData(): Record&lt;string, string | number | boolean&gt;</code></a></li>
 </ul>
 </li>
 </ul>
 </div>
 </div>
 <div id="content">
-<div id="preamble">
+<div class="sect1">
+<h2 id="architectural-purpose"><a class="link" href="#architectural-purpose">1. Architectural Purpose</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p>The <code>GameControl</code> module handles user input from physical keyboards and virtual buttons. It provides an event-based system for reacting to player actions.</p>
+<p>The <code>GameControl</code> module functions as the central event bus translating physical browser and hardware DOM inputs into abstract game behaviors. It encapsulates raw environment listeners so distinct module parts can effortlessly subscribe to simplified <code><a href="../enums/ControlKey.html">ControlKey</a></code> hooks. Vitally, it centrally gates input propagation depending intelligently on the global engine <code><a href="GameState.html">GameState</a></code> (e.g. blocking game keys while in modals).</p>
 </div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="supported-keys-controlkey"><a class="link" href="#supported-keys-controlkey">1. Supported Keys (<code>ControlKey</code>)</a></h2>
+<h2 id="supported-keys-controlkey"><a class="link" href="#supported-keys-controlkey">2. Supported Keys (<code>ControlKey</code>)</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>The engine maps physical keys to virtual engine keys:</p>
@@ -511,10 +513,10 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="api-reference"><a class="link" href="#api-reference">2. API Reference</a></h2>
+<h2 id="api-reference"><a class="link" href="#api-reference">3. API Reference</a></h2>
 <div class="sectionbody">
 <div class="sect2">
-<h3 id="subscribekey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#subscribekey-controlkey-type-controleventtype-callback-controlcallback-void">2.1. <code>subscribe(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
+<h3 id="subscribekey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#subscribekey-controlkey-type-controleventtype-callback-controlcallback-void">3.1. <code>subscribe(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
 <div class="paragraph">
 <p>Registers a callback for a specific input event.</p>
 </div>
@@ -536,17 +538,17 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>key</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="../enums/ControlKey.html">ControlKey</a></code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The virtual key to monitor (e.g., <code>ControlKey.ACTION</code>).</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The explicit abstract virtual key string mapping to monitor cleanly (e.g., <code>ControlKey.ACTION</code>).</p></td>
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>type</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="../enums/ControlEventType.html">ControlEventType</a></code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The type of trigger (<code>PRESSED</code> or <code>HELD</code>).</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The lifecycle trigger distinction (<code>PRESSED</code> or <code>HELD</code>).</p></td>
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>callback</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="../types/ControlCallback.html">ControlCallback</a></code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The function to execute when the event occurs.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The injected execution sequence called securely when the payload completes.</p></td>
 </tr>
 </tbody>
 </table>
@@ -569,7 +571,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="unsubscribekey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#unsubscribekey-controlkey-type-controleventtype-callback-controlcallback-void">2.2. <code>unsubscribe(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
+<h3 id="unsubscribekey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#unsubscribekey-controlkey-type-controleventtype-callback-controlcallback-void">3.2. <code>unsubscribe(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
 <div class="paragraph">
 <p>Removes an existing subscription.</p>
 </div>
@@ -591,17 +593,17 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>key</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="../enums/ControlKey.html">ControlKey</a></code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The virtual key.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The registered virtual key name.</p></td>
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>type</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="../enums/ControlEventType.html">ControlEventType</a></code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The trigger type.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The exact behavior trigger.</p></td>
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>callback</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="../types/ControlCallback.html">ControlCallback</a></code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The reference to the function to remove.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The exact memory reference mapping previously used to construct the subscription block.</p></td>
 </tr>
 </tbody>
 </table>
@@ -614,7 +616,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="subscribefortitlescreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#subscribefortitlescreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.3. <code>subscribeForTitleScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
+<h3 id="subscribefortitlescreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#subscribefortitlescreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.3. <code>subscribeForTitleScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
 <div class="paragraph">
 <p>Registers a callback for a specific input event ONLY when the game is on the Title Screen.</p>
 </div>
@@ -653,14 +655,14 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="unsubscribefortitlescreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#unsubscribefortitlescreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.4. <code>unsubscribeForTitleScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
+<h3 id="unsubscribefortitlescreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#unsubscribefortitlescreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.4. <code>unsubscribeForTitleScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
 <div class="paragraph">
 <p>Removes an existing Title Screen subscription.</p>
 </div>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="subscribeforgameoverscreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#subscribeforgameoverscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.5. <code>subscribeForGameOverScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
+<h3 id="subscribeforgameoverscreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#subscribeforgameoverscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.5. <code>subscribeForGameOverScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
 <div class="paragraph">
 <p>Registers a callback for a specific input event ONLY when the game is on the Game Over Screen.</p>
 </div>
@@ -699,28 +701,28 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="unsubscribeforgameoverscreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#unsubscribeforgameoverscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.6. <code>unsubscribeForGameOverScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
+<h3 id="unsubscribeforgameoverscreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#unsubscribeforgameoverscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.6. <code>unsubscribeForGameOverScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
 <div class="paragraph">
 <p>Removes an existing Game Over Screen subscription.</p>
 </div>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="subscribeforplayingscreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#subscribeforplayingscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.7. <code>subscribeForPlayingScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
+<h3 id="subscribeforplayingscreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#subscribeforplayingscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.7. <code>subscribeForPlayingScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
 <div class="paragraph">
 <p>Registers a callback for a specific input event ONLY during active gameplay. This is functionally equivalent to <code>subscribe</code> for control keys, but provides explicit intent.</p>
 </div>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="unsubscribeforplayingscreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#unsubscribeforplayingscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.8. <code>unsubscribeForPlayingScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
+<h3 id="unsubscribeforplayingscreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#unsubscribeforplayingscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.8. <code>unsubscribeForPlayingScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
 <div class="paragraph">
 <p>Removes an existing Playing Screen subscription.</p>
 </div>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="subscribeforpausedscreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#subscribeforpausedscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.9. <code>subscribeForPausedScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
+<h3 id="subscribeforpausedscreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#subscribeforpausedscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.9. <code>subscribeForPausedScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
 <div class="paragraph">
 <p>Registers a callback for a specific input event ONLY when the game is in a Paused state.</p>
 </div>
@@ -759,14 +761,14 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="unsubscribeforpausedscreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#unsubscribeforpausedscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">2.10. <code>unsubscribeForPausedScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
+<h3 id="unsubscribeforpausedscreenkey-controlkey-type-controleventtype-callback-controlcallback-void"><a class="link" href="#unsubscribeforpausedscreenkey-controlkey-type-controleventtype-callback-controlcallback-void">3.10. <code>unsubscribeForPausedScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void</code></a></h3>
 <div class="paragraph">
 <p>Removes an existing Paused Screen subscription.</p>
 </div>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="bindcontrols-void"><a class="link" href="#bindcontrols-void">2.11. <code>bindControls(): void</code></a></h3>
+<h3 id="bindcontrols-void"><a class="link" href="#bindcontrols-void">3.11. <code>bindControls(): void</code></a></h3>
 <div class="paragraph">
 <p>Attaches low-level event listeners to the environment.</p>
 </div>
@@ -779,7 +781,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="unbindcontrols-void"><a class="link" href="#unbindcontrols-void">2.12. <code>unbindControls(): void</code></a></h3>
+<h3 id="unbindcontrols-void"><a class="link" href="#unbindcontrols-void">3.12. <code>unbindControls(): void</code></a></h3>
 <div class="paragraph">
 <p>Detaches all input listeners and clears subscriptions.</p>
 </div>
@@ -792,7 +794,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="notifykey-controlkey-type-controleventtype-void"><a class="link" href="#notifykey-controlkey-type-controleventtype-void">2.13. <code>notify(key: ControlKey, type: ControlEventType): void</code></a></h3>
+<h3 id="notifykey-controlkey-type-controleventtype-void"><a class="link" href="#notifykey-controlkey-type-controleventtype-void">3.13. <code>notify(key: ControlKey, type: ControlEventType): void</code></a></h3>
 <div class="paragraph">
 <p>Manually triggers an input event.</p>
 </div>
@@ -814,12 +816,12 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>key</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="../enums/ControlKey.html">ControlKey</a></code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The key to notify.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The exact abstracted key intent generating the signal.</p></td>
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>type</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="../enums/ControlEventType.html">ControlEventType</a></code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The trigger type to simulate.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The physical user behavior type causing the event (e.g., <code>PRESSED</code>).</p></td>
 </tr>
 </tbody>
 </table>
@@ -827,11 +829,14 @@ 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>Executes all callbacks associated with the given key and event type, subject to the following state-based rules:</p>
+<p>Executes all callbacks associated with the given key and event type, subject to the following logic:</p>
 </div>
 <div class="ulist">
 <ul>
 <li>
+<p><strong>Session Modal / Unresolved (<code>isModalOpen() || !isSessionResolved()</code>)</strong>: All inputs are BLOCKED to prevent interactions while the user is making a session restoration choice via the <code><a href="../interfaces/modules/Session.html">Session</a></code> module.</p>
+</li>
+<li>
 <p><strong>System Off (<code>isOff()</code>)</strong>: Only the <code><a href="../enums/ControlKey.html">POWER</a></code> key is processed. All other keys are ignored.</p>
 </li>
 <li>
@@ -843,12 +848,12 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </ul>
 </div>
 <div class="paragraph">
-<p><strong>Throws an error</strong> if the game modules have not been initialized. It is primarily used internally by the input handler but can be used for automated testing or input simulation.</p>
+<p><strong>Throws an error</strong> if the game modules have not been initialized.</p>
 </div>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="getdebugdata-recordstring-string-number-boolean"><a class="link" href="#getdebugdata-recordstring-string-number-boolean">2.14. <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">3.14. <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/GameEventRegistry.html

@@ -443,27 +443,28 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <div id="toc" class="toc2">
 <div id="toctitle">Table of Contents</div>
 <ul class="sectlevel1">
-<li><a href="#core-responsibilities">1. Core Responsibilities</a></li>
-<li><a href="#api-reference">2. API Reference</a>
+<li><a href="#architectural-purpose">1. Architectural Purpose</a></li>
+<li><a href="#core-responsibilities">2. Core Responsibilities</a></li>
+<li><a href="#api-reference">3. API Reference</a>
 <ul class="sectlevel2">
-<li><a href="#setupcontroleventsmodules-gamemodules-onreset-void-void">2.1. <code>setupControlEvents(modules: GameModules, onReset: () &#8658; void): void</code></a></li>
-<li><a href="#setupstateeventsmodules-gamemodules-void">2.2. <code>setupStateEvents(modules: GameModules): void</code></a></li>
+<li><a href="#setupcontroleventsmodules-gamemodules-onreset-void-void">3.1. <code>setupControlEvents(modules: GameModules, onReset: () &#8658; void): void</code></a></li>
+<li><a href="#setupstateeventsmodules-gamemodules-void">3.2. <code>setupStateEvents(modules: GameModules): void</code></a></li>
 </ul>
 </li>
-<li><a href="#internal-reset-logic">3. Internal Reset Logic</a></li>
 </ul>
 </div>
 </div>
 <div id="content">
-<div id="preamble">
+<div class="sect1">
+<h2 id="architectural-purpose"><a class="link" href="#architectural-purpose">1. Architectural Purpose</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p>The <code>GameEventRegistry</code> is a static helper class that centralizes the logic for system-level event subscriptions. It ensures a consistent behavior for power management, game resets, and state transitions across the engine.</p>
+<p>The <code>GameEventRegistry</code> is a static helper class that centralizes the logic for system-level event subscriptions. By moving these registrations out of the core Game class, it maintains a clean startup sequence and ensures that all modules remain decoupled while still reacting systematically to global lifecycle changes like turning on/off or Game Over.</p>
 </div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="core-responsibilities"><a class="link" href="#core-responsibilities">1. Core Responsibilities</a></h2>
+<h2 id="core-responsibilities"><a class="link" href="#core-responsibilities">2. Core Responsibilities</a></h2>
 <div class="sectionbody">
 <div class="olist arabic">
 <ol class="arabic">
@@ -485,12 +486,12 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="api-reference"><a class="link" href="#api-reference">2. API Reference</a></h2>
+<h2 id="api-reference"><a class="link" href="#api-reference">3. API Reference</a></h2>
 <div class="sectionbody">
 <div class="sect2">
-<h3 id="setupcontroleventsmodules-gamemodules-onreset-void-void"><a class="link" href="#setupcontroleventsmodules-gamemodules-onreset-void-void">2.1. <code>setupControlEvents(modules: GameModules, onReset: () &#8658; void): void</code></a></h3>
+<h3 id="setupcontroleventsmodules-gamemodules-onreset-void-void"><a class="link" href="#setupcontroleventsmodules-gamemodules-onreset-void-void">3.1. <code>setupControlEvents(modules: GameModules, onReset: () &#8658; void): void</code></a></h3>
 <div class="paragraph">
-<p>Sets up all system-level control event subscriptions.</p>
+<p>Sets up all system-level control event subscriptions. Injects handlers for core game hardware button mappings like power cycling, resetting the active game, unpausing, or modifying hardware toggles like sound and color.</p>
 </div>
 <div class="paragraph">
 <p><strong>Parameters</strong></p>
@@ -510,12 +511,12 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>modules</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="../types/GameModules.html">GameModules</a></code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The collection of engine modules.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The collection of initialized game modules to bind.</p></td>
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>onReset</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">Callback to restore the initial state of the game instance.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Callback to be executed immediately to restore the initial properties of the game instance during soft resets.</p></td>
 </tr>
 </tbody>
 </table>
@@ -533,9 +534,9 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="setupstateeventsmodules-gamemodules-void"><a class="link" href="#setupstateeventsmodules-gamemodules-void">2.2. <code>setupStateEvents(modules: GameModules): void</code></a></h3>
+<h3 id="setupstateeventsmodules-gamemodules-void"><a class="link" href="#setupstateeventsmodules-gamemodules-void">3.2. <code>setupStateEvents(modules: GameModules): void</code></a></h3>
 <div class="paragraph">
-<p>Sets up all system-level state property subscriptions.</p>
+<p>Sets up all system-level state property subscriptions. Binds lifecycle behaviors to state property changes, such as clearing current session data upon encountering Game Over, or fully purging rendering/grid variables when the system is virtually powered down.</p>
 </div>
 <div class="paragraph">
 <p><strong>Parameters</strong></p>
@@ -555,7 +556,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>modules</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="../types/GameModules.html">GameModules</a></code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The collection of engine modules.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The structured collection of engine modules.</p></td>
 </tr>
 </tbody>
 </table>
@@ -571,24 +572,6 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 </div>
-<div class="sect1">
-<h2 id="internal-reset-logic"><a class="link" href="#internal-reset-logic">3. Internal Reset Logic</a></h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The registry uses private methods to ensure data consistency during resets:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong><code>resetModules</code></strong>: Resets <code>Grid</code>, <code>Score</code>, <code>Level</code>, and <code>Time</code> to their defaults.</p>
-</li>
-<li>
-<p><strong><code>fullReset</code></strong>: Combines <code>resetModules</code> with <code>Session</code> clearing and execution of the <code>onReset</code> callback.</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
 </div>
 <div id="footer">
 <div id="footer-text">