brick-engine-js 1.0.22 → 1.0.23

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

@@ -443,22 +443,24 @@ 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="#inheritance">1. Inheritance</a></li>
-<li><a href="#usage">2. Usage</a></li>
-<li><a href="#implementation-specifics">3. Implementation Specifics</a></li>
+<li><a href="#architectural-purpose">1. Architectural Purpose</a></li>
+<li><a href="#inheritance">2. Inheritance</a></li>
+<li><a href="#usage">3. Usage</a></li>
+<li><a href="#implementation-specifics">4. Implementation Specifics</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>GameHudGrid</code> is a specialized implementation of the <code>GameGrid</code> class. It is hard-coded to a <strong>4x4</strong> dimension and is intended for use in the HUD area to display meta-information, such as "Next Piece" in a Tetris-style game.</p>
+<p>The <code>GameHudGrid</code> acts as a specialized engine implementation isolating the visual preview logic for upcoming pieces. By statically overriding the fluid dimensions of a standard <code>GameGrid</code> down to a strict 4x4 coordinate plane, it transparently provides rendering modules exactly the same API for iterating over cells, but guarantees the data remains segregated from the primary physics loop resolving active lines.</p>
 </div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="inheritance"><a class="link" href="#inheritance">1. Inheritance</a></h2>
+<h2 id="inheritance"><a class="link" href="#inheritance">2. Inheritance</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p><code>GameHudGrid</code> extends <a href="GameGrid.html">GameGrid</a>. It inherits all methods for filling areas, stamping pieces, and checking occupancy.</p>
@@ -466,7 +468,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="usage"><a class="link" href="#usage">2. Usage</a></h2>
+<h2 id="usage"><a class="link" href="#usage">3. Usage</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>Accessible via <code>modules.hudGrid</code>.</p>
@@ -485,7 +487,7 @@ hudGrid.stampPiece(nextPieceCoords, 1, Color.BLUE);</code></pre>
 </div>
 </div>
 <div class="sect1">
-<h2 id="implementation-specifics"><a class="link" href="#implementation-specifics">3. Implementation Specifics</a></h2>
+<h2 id="implementation-specifics"><a class="link" href="#implementation-specifics">4. Implementation Specifics</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>The <code>GameHudGrid</code> overrides the dimensions provided in the global configuration, strictly enforcing a 4x4 matrix. This ensures consistency for HUD-specific rendering logic.</p>

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

@@ -443,30 +443,32 @@ 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="#api-reference">1. API Reference</a>
+<li><a href="#architectural-purpose">1. Architectural Purpose</a></li>
+<li><a href="#api-reference">2. API Reference</a>
 <ul class="sectlevel2">
-<li><a href="#renderermetrics-renderermetrics">1.1. <code>rendererMetrics: RendererMetrics</code></a></li>
-<li><a href="#addrendererrenderer-renderer-void">1.2. <code>addRenderer(renderer: Renderer): void</code></a></li>
-<li><a href="#rendergrid-cell-modules-gamemodules-void">1.3. <code>render(grid: Cell[][], modules: GameModules): void</code></a></li>
-<li><a href="#getdebugdata-recordstring-string-number-boolean">1.4. <code>getDebugData(): Record&lt;string, string | number | boolean&gt;</code></a></li>
+<li><a href="#renderermetrics-renderermetrics">2.1. <code>rendererMetrics: RendererMetrics</code></a></li>
+<li><a href="#addrendererrenderer-renderer-void">2.2. <code>addRenderer(renderer: Renderer): void</code></a></li>
+<li><a href="#rendergrid-cell-modules-gamemodules-void">2.3. <code>render(grid: Cell[][], modules: GameModules): void</code></a></li>
+<li><a href="#getdebugdata-recordstring-string-number-boolean">2.4. <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>GameRenderer</code> module is the visual engine of the application. It orchestrates multiple specialized renderers to draw the game grid, background, borders, and HUD elements on the HTML5 canvas.</p>
+<p>The <code>GameRenderer</code> module acts as the visual context manager, orchestrating composite drawing pipelines. It bridges the rigid logical <code><a href="../interfaces/modules/Grid.html">Grid</a></code> limits to the fluid, responsive Canvas dimensions. By computing and freezing pixel scaling math precisely once via a <code><a href="../types/RendererMetrics.html">RendererMetrics</a></code> payload during initialization, it guarantees that all nested rendering loops run without any expensive trigonometric boundaries-checking per frame.</p>
 </div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="api-reference"><a class="link" href="#api-reference">1. API Reference</a></h2>
+<h2 id="api-reference"><a class="link" href="#api-reference">2. API Reference</a></h2>
 <div class="sectionbody">
 <div class="sect2">
-<h3 id="renderermetrics-renderermetrics"><a class="link" href="#renderermetrics-renderermetrics">1.1. <code>rendererMetrics: RendererMetrics</code></a></h3>
+<h3 id="renderermetrics-renderermetrics"><a class="link" href="#renderermetrics-renderermetrics">2.1. <code>rendererMetrics: RendererMetrics</code></a></h3>
 <div class="paragraph">
 <p>Read-only property containing the calculated dimensions and origins for all UI components.</p>
 </div>
@@ -485,7 +487,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="addrendererrenderer-renderer-void"><a class="link" href="#addrendererrenderer-renderer-void">1.2. <code>addRenderer(renderer: Renderer): void</code></a></h3>
+<h3 id="addrendererrenderer-renderer-void"><a class="link" href="#addrendererrenderer-renderer-void">2.2. <code>addRenderer(renderer: Renderer): void</code></a></h3>
 <div class="paragraph">
 <p>Registers a new rendering layer.</p>
 </div>
@@ -520,7 +522,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="rendergrid-cell-modules-gamemodules-void"><a class="link" href="#rendergrid-cell-modules-gamemodules-void">1.3. <code>render(grid: Cell[][], modules: GameModules): void</code></a></h3>
+<h3 id="rendergrid-cell-modules-gamemodules-void"><a class="link" href="#rendergrid-cell-modules-gamemodules-void">2.3. <code>render(grid: Cell[][], modules: GameModules): void</code></a></h3>
 <div class="paragraph">
 <p>The main drawing execution call.</p>
 </div>
@@ -560,7 +562,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.4. <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">2.4. <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/GameScore.html

@@ -443,60 +443,62 @@ 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="#api-reference">1. API Reference</a>
+<li><a href="#architectural-purpose">1. Architectural Purpose</a></li>
+<li><a href="#api-reference">2. API Reference</a>
 <ul class="sectlevel2">
-<li><a href="#score-number">1.1. <code>score: number</code></a></li>
-<li><a href="#level-number">1.2. <code>level: number</code></a></li>
-<li><a href="#multiplier-number">1.3. <code>multiplier: number</code></a></li>
-<li><a href="#highscore-number">1.4. <code>highScore: number</code></a></li>
-<li><a href="#increasescoreamount-number-void">1.5. <code>increaseScore(amount: number): void</code></a></li>
-<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="#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>
+<li><a href="#score-number">2.1. <code>score: number</code></a></li>
+<li><a href="#level-number">2.2. <code>level: number</code></a></li>
+<li><a href="#multiplier-number">2.3. <code>multiplier: number</code></a></li>
+<li><a href="#highscore-number">2.4. <code>highScore: number</code></a></li>
+<li><a href="#increasescoreamount-number-void">2.5. <code>increaseScore(amount: number): void</code></a></li>
+<li><a href="#resetscore-void">2.6. <code>resetScore(): void</code></a></li>
+<li><a href="#increaselevelamount-number-void">2.7. <code>increaseLevel(amount: number): void</code></a></li>
+<li><a href="#resetlevel-void">2.8. <code>resetLevel(): void</code></a></li>
+<li><a href="#setupgamehighscoreid-string-void">2.9. <code>setupGameHighScore(id: string): void</code></a></li>
+<li><a href="#getformattedscoredigits-number-string">2.10. <code>getFormattedScore(digits: number): string</code></a></li>
+<li><a href="#serialize-string">2.11. <code>serialize(): string</code></a></li>
+<li><a href="#deserializedata-string-void">2.12. <code>deserialize(data: string): void</code></a></li>
+<li><a href="#getdebugdata-recordstring-string-number-boolean">2.13. <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>GameScore</code> module tracks player performance during a session. It manages the current score, game levels, multipliers, and acts as the authority for the game&#8217;s <code>highScore</code>, persisting it directly to <code>LocalStorage</code>. It also fully supports Session serialization out of the box.</p>
+<p>The <code>GameScore</code> module acts as the strict authority dedicated to tracking real-time player performance metrics, levels, and point multipliers. It prevents transient session logic from interacting with persistent storage, explicitly taking over saving the global <code>highScore</code> into an isolated <code>LocalStorage</code> namespace directly, ensuring different game engines do not overwrite each other&#8217;s records.</p>
 </div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="api-reference"><a class="link" href="#api-reference">1. API Reference</a></h2>
+<h2 id="api-reference"><a class="link" href="#api-reference">2. API Reference</a></h2>
 <div class="sectionbody">
 <div class="sect2">
-<h3 id="score-number"><a class="link" href="#score-number">1.1. <code>score: number</code></a></h3>
+<h3 id="score-number"><a class="link" href="#score-number">2.1. <code>score: number</code></a></h3>
 <div class="paragraph">
 <p>Read-only property returning the current session&#8217;s points.</p>
 </div>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="level-number"><a class="link" href="#level-number">1.2. <code>level: number</code></a></h3>
+<h3 id="level-number"><a class="link" href="#level-number">2.2. <code>level: number</code></a></h3>
 <div class="paragraph">
 <p>Read-only property returning the current difficulty level.</p>
 </div>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="multiplier-number"><a class="link" href="#multiplier-number">1.3. <code>multiplier: number</code></a></h3>
+<h3 id="multiplier-number"><a class="link" href="#multiplier-number">2.3. <code>multiplier: number</code></a></h3>
 <div class="paragraph">
 <p>Read and Write property for the current points multiplier.</p>
 </div>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="highscore-number"><a class="link" href="#highscore-number">1.4. <code>highScore: number</code></a></h3>
+<h3 id="highscore-number"><a class="link" href="#highscore-number">2.4. <code>highScore: number</code></a></h3>
 <div class="paragraph">
 <p>Read and Write property for the highest overall score achieved.</p>
 </div>
@@ -509,7 +511,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="increasescoreamount-number-void"><a class="link" href="#increasescoreamount-number-void">1.5. <code>increaseScore(amount: number): void</code></a></h3>
+<h3 id="increasescoreamount-number-void"><a class="link" href="#increasescoreamount-number-void">2.5. <code>increaseScore(amount: number): void</code></a></h3>
 <div class="paragraph">
 <p>Adds points to the current session.</p>
 </div>
@@ -531,7 +533,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>amount</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>number</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Base points to add.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Base raw integer points to add before multiplier application.</p></td>
 </tr>
 </tbody>
 </table>
@@ -544,14 +546,14 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="resetscore-void"><a class="link" href="#resetscore-void">1.6. <code>resetScore(): void</code></a></h3>
+<h3 id="resetscore-void"><a class="link" href="#resetscore-void">2.6. <code>resetScore(): void</code></a></h3>
 <div class="paragraph">
 <p>Resets the session score to zero.</p>
 </div>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="increaselevelamount-number-void"><a class="link" href="#increaselevelamount-number-void">1.7. <code>increaseLevel(amount: number): void</code></a></h3>
+<h3 id="increaselevelamount-number-void"><a class="link" href="#increaselevelamount-number-void">2.7. <code>increaseLevel(amount: number): void</code></a></h3>
 <div class="paragraph">
 <p>Increases the game difficulty level.</p>
 </div>
@@ -573,21 +575,21 @@ 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>amount</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>number</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number of levels to add.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Positive integer count of step levels to advance globally.</p></td>
 </tr>
 </tbody>
 </table>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="resetlevel-void"><a class="link" href="#resetlevel-void">1.8. <code>resetLevel(): void</code></a></h3>
+<h3 id="resetlevel-void"><a class="link" href="#resetlevel-void">2.8. <code>resetLevel(): void</code></a></h3>
 <div class="paragraph">
 <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>
+<h3 id="setupgamehighscoreid-string-void"><a class="link" href="#setupgamehighscoreid-string-void">2.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>
@@ -609,14 +611,14 @@ 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>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>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The unique game UUID identifier used as a persistent prefix for namespace isolation.</p></td>
 </tr>
 </tbody>
 </table>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="getformattedscoredigits-number-string"><a class="link" href="#getformattedscoredigits-number-string">1.10. <code>getFormattedScore(digits: number): string</code></a></h3>
+<h3 id="getformattedscoredigits-number-string"><a class="link" href="#getformattedscoredigits-number-string">2.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>
@@ -638,7 +640,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>digits</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>number</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Total length of the string (e.g., 6 for "000150").</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Total character length to dictate string sequence width (e.g., 6 outputs "000150").</p></td>
 </tr>
 </tbody>
 </table>
@@ -651,7 +653,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.11. <code>serialize(): string</code></a></h3>
+<h3 id="serialize-string"><a class="link" href="#serialize-string">2.11. <code>serialize(): string</code></a></h3>
 <div class="paragraph">
 <p><strong>Behavior</strong></p>
 </div>
@@ -661,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="deserializedata-string-void"><a class="link" href="#deserializedata-string-void">1.12. <code>deserialize(data: string): void</code></a></h3>
+<h3 id="deserializedata-string-void"><a class="link" href="#deserializedata-string-void">2.12. <code>deserialize(data: string): void</code></a></h3>
 <div class="paragraph">
 <p><strong>Behavior</strong></p>
 </div>
@@ -671,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="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>
+<h3 id="getdebugdata-recordstring-string-number-boolean"><a class="link" href="#getdebugdata-recordstring-string-number-boolean">2.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

@@ -442,38 +442,56 @@ 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="#_session_management">1. Session Management</a>
+<li><a href="#_architectural_purpose">1. Architectural Purpose</a></li>
+<li><a href="#_session_management">2. Session Management</a>
 <ul class="sectlevel2">
-<li><a href="#_savesession_void">1.1. <code>saveSession(): 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>
+<li><a href="#_savesession_void">2.1. <code>saveSession(): void</code></a></li>
+<li><a href="#_issessionresolved_boolean">2.2. <code>isSessionResolved(): boolean</code></a></li>
+<li><a href="#_setresetfunctionresetfn_void_void">2.3. <code>setResetFunction(resetFn: () &#8658; void): void</code></a></li>
+<li><a href="#_setsessionenabledenabled_boolean_void">2.4. <code>setSessionEnabled(enabled: boolean): void</code></a></li>
+<li><a href="#_clearsession_void">2.5. <code>clearSession(): void</code></a></li>
+<li><a href="#_syncstatestate_state_void">2.6. <code>syncState(state: State): void</code></a></li>
 </ul>
 </li>
-<li><a href="#_internals">2. Internals</a></li>
+<li><a href="#_internals">3. Internals</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>GameSession</code> module implements the <code><a href="../interfaces/modules/Session.html">Session</a></code> interface. It acts as the default engine implementation for persistence lifecycle hooks.</p>
+<p>The <code>GameSession</code> module implements the engine&#8217;s core persistence logic orchestrator for transient serialized data. Rather than mixing user preferences (<code>GameState</code>) with dynamic game-over progress (like active piece locations or multipliers), <code>GameSession</code> secures an isolated boundary that hooks directly into the logical <code><a href="GameState.html">GameState</a></code> phase shifts and intelligently pauses flow via modal confirmations before accidental memory leaks or overwrites occur.</p>
 </div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_session_management"><a class="link" href="#_session_management">1. Session Management</a></h2>
+<h2 id="_session_management"><a class="link" href="#_session_management">2. Session Management</a></h2>
 <div class="sectionbody">
 <div class="sect2">
-<h3 id="_savesession_void"><a class="link" href="#_savesession_void">1.1. <code>saveSession(): void</code></a></h3>
+<h3 id="_savesession_void"><a class="link" href="#_savesession_void">2.1. <code>saveSession(): void</code></a></h3>
+<div class="paragraph">
+<p>Persists the current state of all registered <code><a href="../Serializable.html">Serializable</a></code> instances. Early returns if the session is disabled (via <code>setSessionEnabled</code>) or if the session restoration flow is not yet complete (<code>isSessionResolved()</code> is <code>false</code>).</p>
+</div>
+<hr>
+</div>
+<div class="sect2">
+<h3 id="_issessionresolved_boolean"><a class="link" href="#_issessionresolved_boolean">2.2. <code>isSessionResolved(): boolean</code></a></h3>
+<div class="paragraph">
+<p>Implementation of the interface method. Returns whether the session resolution has been finalized.</p>
+</div>
+<hr>
+</div>
+<div class="sect2">
+<h3 id="_setresetfunctionresetfn_void_void"><a class="link" href="#_setresetfunctionresetfn_void_void">2.3. <code>setResetFunction(resetFn: () &#8658; void): void</code></a></h3>
 <div class="paragraph">
-<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>
+<p>Stores the reset callback that will be invoked if the user chooses to cancel restoration.</p>
 </div>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="_setsessionenabledenabled_boolean_void"><a class="link" href="#_setsessionenabledenabled_boolean_void">1.2. <code>setSessionEnabled(enabled: boolean): void</code></a></h3>
+<h3 id="_setsessionenabledenabled_boolean_void"><a class="link" href="#_setsessionenabledenabled_boolean_void">2.4. <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>
@@ -495,19 +513,19 @@ 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>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>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The primitive strict boolean enforcing if a startup evaluates past history (<code>true</code>) or resets blindly (<code>false</code>).</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>
+<h3 id="_clearsession_void"><a class="link" href="#_clearsession_void">2.5. <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.4. <code>syncState(state: State): void</code></a></h3>
+<h3 id="_syncstatestate_state_void"><a class="link" href="#_syncstatestate_state_void">2.6. <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>
@@ -529,7 +547,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>state</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="../interfaces/modules/State.html">State</a></code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The game state orchestrator.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The global singleton source-of-truth object orchestrator explicitly exposing lifecycle events.</p></td>
 </tr>
 </tbody>
 </table>
@@ -538,7 +556,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, 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>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. If canceled, it also invokes the registered <code>resetFn</code> to ensure the game starts with a clean state.
 - <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>
@@ -546,7 +564,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="_internals"><a class="link" href="#_internals">2. Internals</a></h2>
+<h2 id="_internals"><a class="link" href="#_internals">3. Internals</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>The system scopes data internally via the <code>${gameId}::${serialId}</code> key pattern within the <code>localStorage</code>. Under the hood, the engine identifies instances that implements the <code><a href="../interfaces/Serializable.html">Serializable</a></code> capability and registers them here implicitly during the bootstrap.</p>
@@ -556,7 +574,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-24 23:17:20 -0300
+Last updated 2026-02-27 21:47:24 -0300
 </div>
 </div>
 </body>

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

@@ -443,32 +443,34 @@ 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="#api-reference">1. API Reference</a>
+<li><a href="#architectural-purpose">1. Architectural Purpose</a></li>
+<li><a href="#api-reference">2. API Reference</a>
 <ul class="sectlevel2">
-<li><a href="#playsound-sound-promisevoid">1.1. <code>play(sound: Sound): Promise&lt;void&gt;</code></a></li>
-<li><a href="#stopsound-sound-void">1.2. <code>stop(sound: Sound): void</code></a></li>
-<li><a href="#stopall-void">1.3. <code>stopAll(): void</code></a></li>
-<li><a href="#togglemute-void">1.4. <code>toggleMute(): void</code></a></li>
-<li><a href="#syncstatestate-state-void">1.5. <code>syncState(state: State): void</code></a></li>
-<li><a href="#getdebugdata-recordstring-string-number-boolean">1.6. <code>getDebugData(): Record&lt;string, string | number | boolean&gt;</code></a></li>
+<li><a href="#playsound-sound-promisevoid">2.1. <code>play(sound: Sound): Promise&lt;void&gt;</code></a></li>
+<li><a href="#stopsound-sound-void">2.2. <code>stop(sound: Sound): void</code></a></li>
+<li><a href="#stopall-void">2.3. <code>stopAll(): void</code></a></li>
+<li><a href="#togglemute-void">2.4. <code>toggleMute(): void</code></a></li>
+<li><a href="#syncstatestate-state-void">2.5. <code>syncState(state: State): void</code></a></li>
+<li><a href="#getdebugdata-recordstring-string-number-boolean">2.6. <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>GameSound</code> module manages audio playback for the engine using the <strong>Web Audio API</strong>. It provides low-latency sound effects and automatic synchronization with the game&#8217;s mute state.</p>
+<p>The <code>GameSound</code> module manages non-blocking audio playback using the raw <strong>Web Audio API</strong>. It decouples context management and audio file loading processes away from the simple gameplay components. By abstracting buffer decoding and muting operations, it allows modules to securely emit audio triggers without managing active <code>GainNode</code> flows or managing overlaps directly.</p>
 </div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="api-reference"><a class="link" href="#api-reference">1. API Reference</a></h2>
+<h2 id="api-reference"><a class="link" href="#api-reference">2. API Reference</a></h2>
 <div class="sectionbody">
 <div class="sect2">
-<h3 id="playsound-sound-promisevoid"><a class="link" href="#playsound-sound-promisevoid">1.1. <code>play(sound: Sound): Promise&lt;void&gt;</code></a></h3>
+<h3 id="playsound-sound-promisevoid"><a class="link" href="#playsound-sound-promisevoid">2.1. <code>play(sound: Sound): Promise&lt;void&gt;</code></a></h3>
 <div class="paragraph">
 <p>Plays a preloaded sound effect.</p>
 </div>
@@ -490,7 +492,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>sound</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="../enums/Sound.html">Sound</a></code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The enum identifier of the sound to play.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The exact registered enum identifier of the active soundtrack/effect file to trigger.</p></td>
 </tr>
 </tbody>
 </table>
@@ -517,7 +519,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="stopsound-sound-void"><a class="link" href="#stopsound-sound-void">1.2. <code>stop(sound: Sound): void</code></a></h3>
+<h3 id="stopsound-sound-void"><a class="link" href="#stopsound-sound-void">2.2. <code>stop(sound: Sound): void</code></a></h3>
 <div class="paragraph">
 <p>Stops all active instances of a specific sound.</p>
 </div>
@@ -539,7 +541,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>sound</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code><a href="../enums/Sound.html">Sound</a></code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The enum identifier of the sound to stop.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The explicit enum identity of the playing audio buffer layer to abruptly physically halt.</p></td>
 </tr>
 </tbody>
 </table>
@@ -552,14 +554,14 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="stopall-void"><a class="link" href="#stopall-void">1.3. <code>stopAll(): void</code></a></h3>
+<h3 id="stopall-void"><a class="link" href="#stopall-void">2.3. <code>stopAll(): void</code></a></h3>
 <div class="paragraph">
 <p>Stops every sound currently playing in the engine.</p>
 </div>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="togglemute-void"><a class="link" href="#togglemute-void">1.4. <code>toggleMute(): void</code></a></h3>
+<h3 id="togglemute-void"><a class="link" href="#togglemute-void">2.4. <code>toggleMute(): void</code></a></h3>
 <div class="paragraph">
 <p>Toggles the master mute status.</p>
 </div>
@@ -572,7 +574,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="syncstatestate-state-void"><a class="link" href="#syncstatestate-state-void">1.5. <code>syncState(state: State): void</code></a></h3>
+<h3 id="syncstatestate-state-void"><a class="link" href="#syncstatestate-state-void">2.5. <code>syncState(state: State): void</code></a></h3>
 <div class="paragraph">
 <p>Synchronizes audio settings with the global game state.</p>
 </div>
@@ -607,7 +609,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.6. <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">2.6. <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>