brick-engine-js 1.0.21 → 1.0.23

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

@@ -443,35 +443,41 @@ 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="#tickinterval-number">1.1. <code>tickInterval: number</code></a></li>
-<li><a href="#shouldtick-boolean">1.2. <code>shouldTick(): boolean</code></a></li>
-<li><a href="#updatedeltatime-number-void">1.3. <code>update(deltaTime: number): void</code></a></li>
-<li><a href="#reset-void">1.4. <code>reset(): void</code></a></li>
-<li><a href="#incrementtickintervalamount-number-void">1.5. <code>incrementTickInterval(amount: number): void</code></a></li>
-<li><a href="#decrementtickintervalamount-number-void">1.6. <code>decrementTickInterval(amount: number): void</code></a></li>
-<li><a href="#settickintervalinterval-number-void">1.7. <code>setTickInterval(interval: number): void</code></a></li>
-<li><a href="#setmintickintervalinterval-number-void">1.8. <code>setMinTickInterval(interval: number): void</code></a></li>
-<li><a href="#getdebugdata-recordstring-string-number-boolean">1.9. <code>getDebugData(): Record&lt;string, string | number | boolean&gt;</code></a></li>
+<li><a href="#tickinterval-number">2.1. <code>tickInterval: number</code></a></li>
+<li><a href="#totalticks-number">2.2. <code>totalTicks: number</code></a></li>
+<li><a href="#elapsedtime-number">2.3. <code>elapsedTime: number</code></a></li>
+<li><a href="#shouldtick-boolean">2.4. <code>shouldTick(): boolean</code></a></li>
+<li><a href="#updatedeltatime-number-void">2.5. <code>update(deltaTime: number): void</code></a></li>
+<li><a href="#reset-void">2.6. <code>reset(): void</code></a></li>
+<li><a href="#istickeveryinterval-number-boolean">2.7. <code>isTickEvery(interval: number): boolean</code></a></li>
+<li><a href="#incrementtickintervalamount-number-void">2.8. <code>incrementTickInterval(amount: number): void</code></a></li>
+<li><a href="#decrementtickintervalamount-number-void">2.9. <code>decrementTickInterval(amount: number): void</code></a></li>
+<li><a href="#settickintervalinterval-number-void">2.10. <code>setTickInterval(interval: number): void</code></a></li>
+<li><a href="#setmintickintervalinterval-number-void">2.11. <code>setMinTickInterval(interval: number): void</code></a></li>
+<li><a href="#getdebugdata-recordstring-string-number-boolean">2.12. <code>getDebugData(): Record&lt;string, string | number | boolean&gt;</code></a></li>
+<li><a href="#captureinitialstate-void">2.13. <code>captureInitialState(): void</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>GameTime</code> module manages the engine&#8217;s logical clock. It decouples game logic "ticks" from the visual frame rate, ensuring consistent gameplay speed regardless of the device&#8217;s performance.</p>
+<p>The <code>GameTime</code> module manages the engine&#8217;s logical clock independent of the visual context. By decoupling the deterministic game logic "ticks" from the unpredictable visual frame rate of the browser, it ensures consistent gameplay speed and difficulty-progression physics regardless of the device&#8217;s hardware performance capabilities.</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="tickinterval-number"><a class="link" href="#tickinterval-number">1.1. <code>tickInterval: number</code></a></h3>
+<h3 id="tickinterval-number"><a class="link" href="#tickinterval-number">2.1. <code>tickInterval: number</code></a></h3>
 <div class="paragraph">
 <p>Getter/Setter for the game logic speed in milliseconds.</p>
 </div>
@@ -490,7 +496,21 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="shouldtick-boolean"><a class="link" href="#shouldtick-boolean">1.2. <code>shouldTick(): boolean</code></a></h3>
+<h3 id="totalticks-number"><a class="link" href="#totalticks-number">2.2. <code>totalTicks: number</code></a></h3>
+<div class="paragraph">
+<p>Read-only property returning the total number of logic ticks that have occurred since the game started.</p>
+</div>
+<hr>
+</div>
+<div class="sect2">
+<h3 id="elapsedtime-number"><a class="link" href="#elapsedtime-number">2.3. <code>elapsedTime: number</code></a></h3>
+<div class="paragraph">
+<p>Read-only property returning the total time in milliseconds elapsed since the game started.</p>
+</div>
+<hr>
+</div>
+<div class="sect2">
+<h3 id="shouldtick-boolean"><a class="link" href="#shouldtick-boolean">2.4. <code>shouldTick(): boolean</code></a></h3>
 <div class="paragraph">
 <p>Determines if a logic update should be executed.</p>
 </div>
@@ -498,20 +518,20 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <p><strong>Returns</strong></p>
 </div>
 <div class="paragraph">
-<p><code>boolean</code> - <code>true</code> if the internal accumulator has exceeded the <code>tickInterval</code>.</p>
+<p><code>boolean</code> - <code>true</code> if the internal ticker buffer (accumulator) has exceeded the <code>tickInterval</code>.</p>
 </div>
 <div class="paragraph">
 <p><strong>Behavior</strong></p>
 </div>
 <div class="paragraph">
-<p>Called by the main loop. If it returns true, it automatically subtracts the <code>tickInterval</code> from the accumulator to maintain a stable clock.</p>
+<p>Called by the main loop. If it returns true, it automatically subtracts the <code>tickInterval</code> from the <code>tickAccumulator</code> to maintain a stable clock.</p>
 </div>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="updatedeltatime-number-void"><a class="link" href="#updatedeltatime-number-void">1.3. <code>update(deltaTime: number): void</code></a></h3>
+<h3 id="updatedeltatime-number-void"><a class="link" href="#updatedeltatime-number-void">2.5. <code>update(deltaTime: number): void</code></a></h3>
 <div class="paragraph">
-<p>Advances the internal time accumulator.</p>
+<p>Advances the internal time buffer (tick accumulator).</p>
 </div>
 <div class="paragraph">
 <p><strong>Parameters</strong></p>
@@ -531,16 +551,16 @@ 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>deltaTime</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">Time elapsed since the last render frame (in milliseconds).</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Time physically elapsed since the last rendering frame (in milliseconds).</p></td>
 </tr>
 </tbody>
 </table>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="reset-void"><a class="link" href="#reset-void">1.4. <code>reset(): void</code></a></h3>
+<h3 id="reset-void"><a class="link" href="#reset-void">2.6. <code>reset(): void</code></a></h3>
 <div class="paragraph">
-<p>Clears the time accumulator.</p>
+<p>Clears the tick accumulator.</p>
 </div>
 <div class="paragraph">
 <p><strong>Behavior</strong></p>
@@ -551,7 +571,42 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="incrementtickintervalamount-number-void"><a class="link" href="#incrementtickintervalamount-number-void">1.5. <code>incrementTickInterval(amount: number): void</code></a></h3>
+<h3 id="istickeveryinterval-number-boolean"><a class="link" href="#istickeveryinterval-number-boolean">2.7. <code>isTickEvery(interval: number): boolean</code></a></h3>
+<div class="paragraph">
+<p>Returns <code>true</code> if the <code>totalTicks</code> is a multiple of the specified <code>interval</code>. Useful for scheduling recurring game events (e.g., spawning an item every 20 ticks).</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>interval</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">The tick frequency interval constraint to check against.</p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p><strong>Returns</strong></p>
+</div>
+<div class="paragraph">
+<p><code>boolean</code> - <code>true</code> if the current tick is a multiple of the interval (and greater than 0).</p>
+</div>
+<hr>
+</div>
+<div class="sect2">
+<h3 id="incrementtickintervalamount-number-void"><a class="link" href="#incrementtickintervalamount-number-void">2.8. <code>incrementTickInterval(amount: number): void</code></a></h3>
 <div class="paragraph">
 <p>Slows down the game by increasing the time between ticks.</p>
 </div>
@@ -580,7 +635,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="decrementtickintervalamount-number-void"><a class="link" href="#decrementtickintervalamount-number-void">1.6. <code>decrementTickInterval(amount: number): void</code></a></h3>
+<h3 id="decrementtickintervalamount-number-void"><a class="link" href="#decrementtickintervalamount-number-void">2.9. <code>decrementTickInterval(amount: number): void</code></a></h3>
 <div class="paragraph">
 <p>Speeds up the game by decreasing the time between ticks.</p>
 </div>
@@ -609,7 +664,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="settickintervalinterval-number-void"><a class="link" href="#settickintervalinterval-number-void">1.7. <code>setTickInterval(interval: number): void</code></a></h3>
+<h3 id="settickintervalinterval-number-void"><a class="link" href="#settickintervalinterval-number-void">2.10. <code>setTickInterval(interval: number): void</code></a></h3>
 <div class="paragraph">
 <p>Sets the tick interval exactly to the specified value.</p>
 </div>
@@ -631,14 +686,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>interval</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">The new interval between logic updates (in milliseconds).</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The precise new integer interval interval between logic updates (in milliseconds).</p></td>
 </tr>
 </tbody>
 </table>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="setmintickintervalinterval-number-void"><a class="link" href="#setmintickintervalinterval-number-void">1.8. <code>setMinTickInterval(interval: number): void</code></a></h3>
+<h3 id="setmintickintervalinterval-number-void"><a class="link" href="#setmintickintervalinterval-number-void">2.11. <code>setMinTickInterval(interval: number): void</code></a></h3>
 <div class="paragraph">
 <p>Sets the minimum limit for the tick interval, preventing the game from speeding up beyond this point.</p>
 </div>
@@ -660,14 +715,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>interval</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">The minimum interval allowed (in milliseconds).</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The strict minimum boundary interval allowed (in milliseconds).</p></td>
 </tr>
 </tbody>
 </table>
 <hr>
 </div>
 <div class="sect2">
-<h3 id="getdebugdata-recordstring-string-number-boolean"><a class="link" href="#getdebugdata-recordstring-string-number-boolean">1.9. <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.12. <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>
@@ -675,7 +730,20 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <p><strong>Returns</strong></p>
 </div>
 <div class="paragraph">
-<p><code>Record&lt;string, string | number | boolean&gt;</code> - Object containing <code>fps</code> (Frames Per Second) and <code>tps</code> (Ticks Per Second).</p>
+<p><code>Record&lt;string, string | number | boolean&gt;</code> - Object containing <code>fps</code> (Frames Per Second), <code>tps</code> (Ticks Per Second), <code>tick_interval</code>, and <code>tick_accumulator</code>.</p>
+</div>
+<hr>
+</div>
+<div class="sect2">
+<h3 id="captureinitialstate-void"><a class="link" href="#captureinitialstate-void">2.13. <code>captureInitialState(): void</code></a></h3>
+<div class="paragraph">
+<p>Captures the current <code>tickInterval</code> as the starting speed for the game session.</p>
+</div>
+<div class="paragraph">
+<p><strong>Behavior</strong></p>
+</div>
+<div class="paragraph">
+<p>This method is called by the <code>Game</code> engine after the game-specific <code>setupGame()</code> has executed. It ensures that when <code>reset()</code> is called, the game returns to its intended initial speed rather than the engine&#8217;s global default.</p>
 </div>
 </div>
 </div>

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

@@ -443,28 +443,30 @@ 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="#setuprenderermetrics-renderermetrics-void">1.1. <code>setup(rendererMetrics: RendererMetrics): void</code></a></li>
-<li><a href="#rendergrid-cell-modules-gamemodules-void">1.2. <code>render(grid: Cell[][], modules: GameModules): void</code></a></li>
+<li><a href="#setuprenderermetrics-renderermetrics-void">2.1. <code>setup(rendererMetrics: RendererMetrics): void</code></a></li>
+<li><a href="#rendergrid-cell-modules-gamemodules-void">2.2. <code>render(grid: Cell[][], modules: GameModules): void</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>HudRenderer</code> manages the visualization of the Head-Up Display, including scores, levels, system status, and the specialized HUD grid. It implements the standard <code><a href="../interfaces/modules/Renderer.html">Renderer</a></code> interface and is managed by the <code><a href="GameRenderer.html">GameRenderer</a></code>.</p>
+<p>The <code>HudRenderer</code> manages the strict visualization sequence outlining string payloads and UI components, including scores, levels, system status, and the specialized piece view. It deliberately abstracts these data polling operations away from the physics grid logic so that game execution speeds aren&#8217;t restricted by formatting strings or parsing metadata visual offsets.</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="setuprenderermetrics-renderermetrics-void"><a class="link" href="#setuprenderermetrics-renderermetrics-void">1.1. <code>setup(rendererMetrics: RendererMetrics): void</code></a></h3>
+<h3 id="setuprenderermetrics-renderermetrics-void"><a class="link" href="#setuprenderermetrics-renderermetrics-void">2.1. <code>setup(rendererMetrics: RendererMetrics): void</code></a></h3>
 <div class="paragraph">
 <p>Pre-calculates static HUD geometry.</p>
 </div>
@@ -499,7 +501,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.2. <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.2. <code>render(grid: Cell[][], modules: GameModules): void</code></a></h3>
 <div class="paragraph">
 <p>Main HUD drawing orchestration.</p>
 </div>

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

@@ -441,29 +441,31 @@ 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="#methods">1. Methods</a>
+<li><a href="#architectural-purpose">1. Architectural Purpose</a></li>
+<li><a href="#methods">2. Methods</a>
 <ul class="sectlevel2">
-<li><a href="#capturebaseproperties">1.1. <code>captureBaseProperties</code></a></li>
-<li><a href="#captureinitialstate">1.2. <code>captureInitialState</code></a></li>
-<li><a href="#restoreinitialstate">1.3. <code>restoreInitialState</code></a></li>
+<li><a href="#capturebaseproperties">2.1. <code>captureBaseProperties</code></a></li>
+<li><a href="#captureinitialstate">2.2. <code>captureInitialState</code></a></li>
+<li><a href="#restoreinitialstate">2.3. <code>restoreInitialState</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>InitialStateSnapshot</code> class manages the transparent caching of a game&#8217;s state. It is an internal orchestrator utilized by the <code>Game</code> base class to capture the properties added by the developer during <code>setupGame()</code> and allows restoring them when the game is reset.</p>
+<p>The <code>InitialStateSnapshot</code> acts as an agnostic structural utility handling transparent auto-save boundaries. Rather than forcing developers to write boilerplate serialization functions for their native sub-classes, the Engine relies on this module to dynamically iterate, deeply clone, and selectively safely cache customized attributes into local memory buffers to restore configurations effortlessly upon reset triggers.</p>
 </div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="methods"><a class="link" href="#methods">1. Methods</a></h2>
+<h2 id="methods"><a class="link" href="#methods">2. Methods</a></h2>
 <div class="sectionbody">
 <div class="sect2">
-<h3 id="capturebaseproperties"><a class="link" href="#capturebaseproperties">1.1. <code>captureBaseProperties</code></a></h3>
+<h3 id="capturebaseproperties"><a class="link" href="#capturebaseproperties">2.1. <code>captureBaseProperties</code></a></h3>
 <div class="paragraph">
 <p>Captures the base properties of the instance before any custom client properties are added. In the engine&#8217;s architecture, this should be called at the very end of the base <code>Game</code> constructor, establishing the baseline for what should be ignored during the snapshot phase automatically.</p>
 </div>
@@ -491,7 +493,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="captureinitialstate"><a class="link" href="#captureinitialstate">1.2. <code>captureInitialState</code></a></h3>
+<h3 id="captureinitialstate"><a class="link" href="#captureinitialstate">2.2. <code>captureInitialState</code></a></h3>
 <div class="paragraph">
 <p>Stores the initial state of custom client properties. It selectively clones properties that were not present in the base properties and are not functions. The deep cloning strategy involves:
 1. Checking if the object has a custom <code>clone()</code> method.
@@ -522,7 +524,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <hr>
 </div>
 <div class="sect2">
-<h3 id="restoreinitialstate"><a class="link" href="#restoreinitialstate">1.3. <code>restoreInitialState</code></a></h3>
+<h3 id="restoreinitialstate"><a class="link" href="#restoreinitialstate">2.3. <code>restoreInitialState</code></a></h3>
 <div class="paragraph">
 <p>Restores the captured custom properties back to the instance, effectively resetting the client&#8217;s state.</p>
 </div>
@@ -553,7 +555,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-25 03:59:03 -0300
+Last updated 2026-02-27 22:00:35 -0300
 </div>
 </div>
 </body>

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

@@ -442,35 +442,37 @@ 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="#_lifecycle">1. Lifecycle</a>
+<li><a href="#_architectural_purpose">1. Architectural Purpose</a></li>
+<li><a href="#_lifecycle">2. Lifecycle</a>
 <ul class="sectlevel2">
-<li><a href="#_setup_void">1.1. <code>setup(): void</code></a></li>
-<li><a href="#_showonconfirm_void_oncancel_void_void">1.2. <code>show(onConfirm: () &#8658; void, onCancel: () &#8658; void): void</code></a></li>
+<li><a href="#_setup_void">2.1. <code>setup(): void</code></a></li>
+<li><a href="#_showonconfirm_void_oncancel_void_void">2.2. <code>show(onConfirm: () &#8658; void, onCancel: () &#8658; void): void</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>SessionModal</code> interacts directly with the DOM outside of the Canvas domain, creating standard HTML elements (divs and buttons) overlapping the P5.js context to prompt users whether they wish to resume their previous game session.</p>
+<p>The <code>SessionModal</code> generates an explicit blocking UI boundary forcing the User to interpret corrupted or previously interrupted memory states safely. Designed as a standalone Vanilla DOM layer hovering entirely above the game Engine canvas, it acts as a synchronized <code>Promise</code> wall. The background engine pauses initial boot sequences until physical button listeners explicitly return 'Confirm' or 'Cancel', thus preventing corrupt states from overriding standard initialization.</p>
 </div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_lifecycle"><a class="link" href="#_lifecycle">1. Lifecycle</a></h2>
+<h2 id="_lifecycle"><a class="link" href="#_lifecycle">2. Lifecycle</a></h2>
 <div class="sectionbody">
 <div class="sect2">
-<h3 id="_setup_void"><a class="link" href="#_setup_void">1.1. <code>setup(): void</code></a></h3>
+<h3 id="_setup_void"><a class="link" href="#_setup_void">2.1. <code>setup(): void</code></a></h3>
 <div class="paragraph">
 <p>Creates the necessary DOM layer elements. Called typically during engine bootstrap by the <code><a href="../../view/GameView.html">GameView</a></code>.
 Constructs the background container wrapper, title frames, dialogue text, and confirm/cancel action buttons. Sets their initial state utilizing the CSS <code>.hidden</code> class to keep them out of view until queried.</p>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_showonconfirm_void_oncancel_void_void"><a class="link" href="#_showonconfirm_void_oncancel_void_void">1.2. <code>show(onConfirm: () &#8658; void, onCancel: () &#8658; void): void</code></a></h3>
+<h3 id="_showonconfirm_void_oncancel_void_void"><a class="link" href="#_showonconfirm_void_oncancel_void_void">2.2. <code>show(onConfirm: () &#8658; void, onCancel: () &#8658; void): void</code></a></h3>
 <div class="paragraph">
 <p>Reveals the modal.</p>
 </div>
@@ -513,7 +515,7 @@ Constructs the background container wrapper, title frames, dialogue text, and co
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2026-02-22 17:04:18 -0300
+Last updated 2026-02-27 21:56:50 -0300
 </div>
 </div>
 </body>

package/dist/docs/reference/types/Axis.html

@@ -443,13 +443,15 @@ 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="#possible-values">1. Possible Values</a></li>
-<li><a href="#general-usage">2. General Usage</a></li>
+<li><a href="#architectural-purpose">1. Architectural Purpose</a></li>
+<li><a href="#possible-values">2. Possible Values</a></li>
+<li><a href="#general-usage">3. General Usage</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>Represents an axis in a 2D coordinate system.</p>
@@ -457,7 +459,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="possible-values"><a class="link" href="#possible-values">1. Possible Values</a></h2>
+<h2 id="possible-values"><a class="link" href="#possible-values">2. Possible Values</a></h2>
 <div class="sectionbody">
 <table class="tableblock frame-all grid-all stretch">
 <colgroup>
@@ -482,7 +484,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="general-usage"><a class="link" href="#general-usage">2. General Usage</a></h2>
+<h2 id="general-usage"><a class="link" href="#general-usage">3. General Usage</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>The <code>Axis</code> type is primarily used for transformation operations that apply selectively to one dimension, such as mirroring a piece across a specific axis.</p>

package/dist/docs/reference/types/Cell.html

@@ -443,13 +443,15 @@ 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="#attributes">1. Attributes</a></li>
-<li><a href="#general-usage">2. General Usage</a></li>
+<li><a href="#architectural-purpose">1. Architectural Purpose</a></li>
+<li><a href="#attributes">2. Attributes</a></li>
+<li><a href="#general-usage">3. General Usage</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>Represents the state of an individual unit within the 2D game grid.</p>
@@ -457,7 +459,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="attributes"><a class="link" href="#attributes">1. Attributes</a></h2>
+<h2 id="attributes"><a class="link" href="#attributes">2. Attributes</a></h2>
 <div class="sectionbody">
 <table class="tableblock frame-all grid-all stretch">
 <colgroup>
@@ -491,7 +493,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="general-usage"><a class="link" href="#general-usage">2. General Usage</a></h2>
+<h2 id="general-usage"><a class="link" href="#general-usage">3. General Usage</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>Cells are managed by the <code><a href="../modules/GameGrid.html">GameGrid</a></code> module. They are rarely created manually; instead, they are accessed and modified via methods like <code>grid.getCell(coord)</code> and <code>grid.setCellValue(coord, val)</code>.</p>

package/dist/docs/reference/types/ControlCallback.html

@@ -443,13 +443,15 @@ 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="#structure">1. Structure</a></li>
-<li><a href="#general-usage">2. General Usage</a></li>
+<li><a href="#architectural-purpose">1. Architectural Purpose</a></li>
+<li><a href="#structure">2. Structure</a></li>
+<li><a href="#general-usage">3. General Usage</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>Type definition for functions that handle engine input.</p>
@@ -457,7 +459,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="structure"><a class="link" href="#structure">1. Structure</a></h2>
+<h2 id="structure"><a class="link" href="#structure">2. Structure</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p><code>type ControlCallback = (event: <a href="GameEvent.html">GameEvent</a>) &#8658; void;</code></p>
@@ -465,7 +467,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="general-usage"><a class="link" href="#general-usage">2. General Usage</a></h2>
+<h2 id="general-usage"><a class="link" href="#general-usage">3. General Usage</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>This type ensures that functions passed to <code>modules.control.subscribe(key, type, callback)</code> (see <code><a href="../modules/GameControl.html">GameControl</a></code>) correctly accept the <code><a href="GameEvent.html">GameEvent</a></code> context.</p>

package/dist/docs/reference/types/Coordinate.html

@@ -443,13 +443,15 @@ 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="#attributes">1. Attributes</a></li>
-<li><a href="#general-usage">2. General Usage</a></li>
+<li><a href="#architectural-purpose">1. Architectural Purpose</a></li>
+<li><a href="#attributes">2. Attributes</a></li>
+<li><a href="#general-usage">3. General Usage</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>A foundational 2D point interface used for positioning.</p>
@@ -457,7 +459,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="attributes"><a class="link" href="#attributes">1. Attributes</a></h2>
+<h2 id="attributes"><a class="link" href="#attributes">2. Attributes</a></h2>
 <div class="sectionbody">
 <table class="tableblock frame-all grid-all stretch">
 <colgroup>
@@ -486,7 +488,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="general-usage"><a class="link" href="#general-usage">2. General Usage</a></h2>
+<h2 id="general-usage"><a class="link" href="#general-usage">3. General Usage</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>Coordinates describe grid positions (columns/rows) as integers, or normalized screen positions as floats (0.0 to 1.0).

package/dist/docs/reference/types/GameEvent.html

@@ -443,13 +443,15 @@ 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="#attributes">1. Attributes</a></li>
-<li><a href="#general-usage">2. General Usage</a></li>
+<li><a href="#architectural-purpose">1. Architectural Purpose</a></li>
+<li><a href="#attributes">2. Attributes</a></li>
+<li><a href="#general-usage">3. General Usage</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 context object delivered to input subscribers.</p>
@@ -457,7 +459,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="attributes"><a class="link" href="#attributes">1. Attributes</a></h2>
+<h2 id="attributes"><a class="link" href="#attributes">2. Attributes</a></h2>
 <div class="sectionbody">
 <table class="tableblock frame-all grid-all stretch">
 <colgroup>
@@ -491,7 +493,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="general-usage"><a class="link" href="#general-usage">2. General Usage</a></h2>
+<h2 id="general-usage"><a class="link" href="#general-usage">3. General Usage</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>When a control callback is executed, it receives a <code>GameEvent</code>. This allows the game logic to react based on the key type and interact with the <code><a href="../interfaces/modules/Grid.html">Grid</a></code>, <code><a href="../interfaces/modules/State.html">State</a></code>, or <code><a href="../interfaces/modules/Score.html">Score</a></code> modules.</p>