brick-engine-js 1.0.22 → 1.0.23

package/dist/docs/reference/enums/Color.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="#values">1. 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="#values">2. 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>Defines the available visual theme colors for grid cells and text.</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="values"><a class="link" href="#values">1. Values</a></h2>
+<h2 id="values"><a class="link" href="#values">2. Values</a></h2>
 <div class="sectionbody">
 <table class="tableblock frame-all grid-all stretch">
 <colgroup>
@@ -505,12 +507,16 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>INACTIVE</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">Faded color for background/ghost elements.</p></td>
 </tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SHADOW</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Intermediate color between default and inactive for dynamic shadows.</p></td>
+</tr>
 </tbody>
 </table>
 </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>Colors are used throughout the engine to theme the <code><a href="../modules/GameGrid.html">GameGrid</a></code> and the <code>HUD</code>. Use these constants when calling methods like <code>grid.setCellColor(coord, Color.RED)</code>.</p>

package/dist/docs/reference/enums/ControlEventType.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="#values">1. 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="#values">2. 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>Enumerates the different ways an input can be triggered.</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="values"><a class="link" href="#values">1. Values</a></h2>
+<h2 id="values"><a class="link" href="#values">2. 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>Crucial for distinguishing between actions like "Rotate Once" (<code><a href="../enums/ControlEventType.html">PRESSED</a></code>) and "Move Continuously" (<code><a href="../enums/ControlEventType.html">HELD</a></code>). Used in subscription filters: <code><a href="../modules/GameControl.html">modules.control</a>.subscribe(key, ControlEventType.HELD, callback)</code>.</p>

package/dist/docs/reference/enums/ControlKey.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="#values">1. 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="#values">2. 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>Abstraction layer mapping hardware inputs to logical engine actions.</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="values"><a class="link" href="#values">1. Values</a></h2>
+<h2 id="values"><a class="link" href="#values">2. Values</a></h2>
 <div class="sectionbody">
 <table class="tableblock frame-all grid-all stretch">
 <colgroup>
@@ -506,7 +508,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><code>ControlKey</code> is used when subscribing to input events via <code><a href="../modules/GameControl.html">GameControl</a>.subscribe()</code> and when checking the <code>key</code> property of a <code><a href="../types/GameEvent.html">GameEvent</a></code>.</p>

package/dist/docs/reference/enums/EventSuffix.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="#values">1. 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="#values">2. 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>The <code>EventSuffix</code> enum defines the available suffixes used to scope events within the engine&#8217;s contextual notification 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="values"><a class="link" href="#values">1. Values</a></h2>
+<h2 id="values"><a class="link" href="#values">2. Values</a></h2>
 <div class="sectionbody">
 <table class="tableblock frame-all grid-all stretch">
 <colgroup>
@@ -490,7 +492,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>These suffixes are used by the <code><a href="../modules/EventEmitter.html">EventEmitter</a></code> to construct specialized event names (e.g., <code>UP:pressed:playing</code>) and by modules like <code><a href="../modules/GameControl.html">GameControl</a></code> and <code><a href="../modules/GameState.html">GameState</a></code> for state-scoped subscriptions.</p>

package/dist/docs/reference/enums/FontAlignment.html

@@ -443,14 +443,16 @@ 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="#fontalign">1. <code>FontAlign</code></a></li>
-<li><a href="#fontverticalalign">2. <code>FontVerticalAlign</code></a></li>
-<li><a href="#general-usage">3. General Usage</a></li>
+<li><a href="#architectural-purpose">1. Architectural Purpose</a></li>
+<li><a href="#fontalign">2. <code>FontAlign</code></a></li>
+<li><a href="#fontverticalalign">3. <code>FontVerticalAlign</code></a></li>
+<li><a href="#general-usage">4. 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>Enums defining the text anchor points on the canvas.</p>
@@ -458,7 +460,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="fontalign"><a class="link" href="#fontalign">1. <code>FontAlign</code></a></h2>
+<h2 id="fontalign"><a class="link" href="#fontalign">2. <code>FontAlign</code></a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>Horizontal alignment of the text block.</p>
@@ -490,7 +492,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="fontverticalalign"><a class="link" href="#fontverticalalign">2. <code>FontVerticalAlign</code></a></h2>
+<h2 id="fontverticalalign"><a class="link" href="#fontverticalalign">3. <code>FontVerticalAlign</code></a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>Vertical alignment of the text block.</p>
@@ -522,7 +524,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">3. General Usage</a></h2>
+<h2 id="general-usage"><a class="link" href="#general-usage">4. General Usage</a></h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>Used when calling <code><a href="../modules/GameText.html">GameText</a>.setTextAlign()</code>.</p>

package/dist/docs/reference/enums/FontSize.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="#values">1. 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="#values">2. 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>Predefined logic scales for the retro pixelated typography.</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="values"><a class="link" href="#values">1. Values</a></h2>
+<h2 id="values"><a class="link" href="#values">2. Values</a></h2>
 <div class="sectionbody">
 <table class="tableblock frame-all grid-all stretch">
 <colgroup>
@@ -494,7 +496,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>Set the active font size via <code><a href="../modules/GameText.html">GameText</a>.setTextSize(FontSize.LARGE)</code>. The engine automatically handles the scaling based on the display resolution.</p>

package/dist/docs/reference/enums/Sound.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="#values">1. 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="#values">2. 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>Maps sound identifiers to their relative asset paths.</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="values"><a class="link" href="#values">1. Values</a></h2>
+<h2 id="values"><a class="link" href="#values">2. Values</a></h2>
 <div class="sectionbody">
 <table class="tableblock frame-all grid-all stretch">
 <colgroup>
@@ -534,7 +536,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>Use these constants to trigger audio effects via the <code><a href="../modules/GameSound.html">GameSound</a></code> module.

package/dist/docs/reference/enums/StateProperty.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="#values">1. 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="#values">2. 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>Enumerates all observable and persistent properties of the game 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="values"><a class="link" href="#values">1. Values</a></h2>
+<h2 id="values"><a class="link" href="#values">2. Values</a></h2>
 <div class="sectionbody">
 <table class="tableblock frame-all grid-all stretch">
 <colgroup>
@@ -502,7 +504,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>Used identifying which property changed in the <code><a href="../modules/GameState.html">GameState</a>.subscribe()</code> callback.</p>

package/dist/docs/reference/helpers/CellHelper.html

@@ -7,6 +7,7 @@
 <meta name="generator" content="Asciidoctor 2.0.20">
 <meta name="description" content="Static factory methods for creating and initializing Cell objects consistently.">
 <meta name="keywords" content="cell, factory, grid, helper">
+<meta name="author" content="== Architectural Purpose">
 <title>CellHelper Reference</title>
 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700">
 <style>
@@ -440,6 +441,9 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <body class="article toc2 toc-left">
 <div id="header">
 <h1>CellHelper Reference</h1>
+<div class="details">
+<span id="author" class="author">== Architectural Purpose</span><br>
+</div>
 <div id="toc" class="toc2">
 <div id="toctitle">Table of Contents</div>
 <ul class="sectlevel1">
@@ -455,7 +459,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <div id="preamble">
 <div class="sectionbody">
 <div class="paragraph">
-<p>The <code>CellHelper</code> provides static factory methods for creating and initializing <code>Cell</code> objects consistently.</p>
+<p>The <code>CellHelper</code> provides a reliable and centralized mechanism to instantiate default grid cells. It ensures that every cell generated across the engine instances starts with identical baseline properties, preventing inconsistent matrix states from forming in abstract spaces.</p>
 </div>
 </div>
 </div>
@@ -485,7 +489,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>coordinate</code></p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../types/Coordinate.html">Coordinate</a></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The <code>{x, y}</code> position to assign to the new cell.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The initialized precise <code>{x, y}</code> logical grid position to assign to the new cell instance.</p></td>
 </tr>
 </tbody>
 </table>

package/dist/docs/reference/helpers/ControlInputHandlerHelper.html

@@ -7,6 +7,7 @@
 <meta name="generator" content="Asciidoctor 2.0.20">
 <meta name="description" content="Utilities for normalizing raw hardware keyboard events into abstract ControlKey actions.">
 <meta name="keywords" content="input, handler, keyboard, normalization, helper">
+<meta name="author" content="== Architectural Purpose">
 <title>ControlInputHandlerHelper Reference</title>
 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700">
 <style>
@@ -440,6 +441,9 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <body class="article toc2 toc-left">
 <div id="header">
 <h1>ControlInputHandlerHelper Reference</h1>
+<div class="details">
+<span id="author" class="author">== Architectural Purpose</span><br>
+</div>
 <div id="toc" class="toc2">
 <div id="toctitle">Table of Contents</div>
 <ul class="sectlevel1">
@@ -457,7 +461,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <div id="preamble">
 <div class="sectionbody">
 <div class="paragraph">
-<p>The <code>ControlInputHandlerHelper</code> manages the complexity of input timing, such as identifying the difference between a quick "press" and a sustained "hold".</p>
+<p>The <code>ControlInputHandlerHelper</code> manages the complexity of input timing, normalizing raw hardware keyboard events or UI button clicks into abstract <code><a href="../enums/ControlKey.html">ControlKey</a></code> actions. It handles the nuance between a quick "press" and a sustained "hold", offloading timer logic from the core <code><a href="../modules/GameControl.html">GameControl</a></code> module.</p>
 </div>
 </div>
 </div>
@@ -494,8 +498,8 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </tr>
 <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"><a href="../enums/ControlKey.html">ControlKey</a></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The virtual key being interacted with.</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 abstract configured identity of the control key being interacted with.</p></td>
 </tr>
 </tbody>
 </table>
@@ -539,8 +543,8 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </tr>
 <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"><a href="../enums/ControlKey.html">ControlKey</a></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The key that was released.</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 exact registered identity of the control key that was released.</p></td>
 </tr>
 </tbody>
 </table>

package/dist/docs/reference/helpers/CoordinateHelper.html

@@ -7,6 +7,7 @@
 <meta name="generator" content="Asciidoctor 2.0.20">
 <meta name="description" content="Specialized math utilities for converting between Grid, Display, and Pixel coordinate systems.">
 <meta name="keywords" content="coordinates, math, grid, display, conversion, helper">
+<meta name="author" content="== Architectural Purpose">
 <title>CoordinateHelper Reference</title>
 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700">
 <style>
@@ -440,6 +441,9 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <body class="article toc2 toc-left">
 <div id="header">
 <h1>CoordinateHelper Reference</h1>
+<div class="details">
+<span id="author" class="author">== Architectural Purpose</span><br>
+</div>
 <div id="toc" class="toc2">
 <div id="toctitle">Table of Contents</div>
 <ul class="sectlevel1">
@@ -459,7 +463,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <div id="preamble">
 <div class="sectionbody">
 <div class="paragraph">
-<p>The <code>CoordinateHelper</code> is a static utility class that handles translations between different coordinate systems: the logical <a href="../modules/GameGrid.html">Game Grid</a>, the normalized Display area, and absolute pixel positions.</p>
+<p>The <code>CoordinateHelper</code> acts as the engine&#8217;s translation layer between the different abstract mathematical models (e.g., the logical <code><a href="../modules/GameGrid.html">Game Grid</a></code> or scaling normalized values from 0.0 to 1.0) and the absolute physical layout on screen. It ensures consistency in calculating element sizes dynamically so interfaces remain strictly responsive to the runtime canvas resolution.</p>
 </div>
 </div>
 </div>
@@ -497,7 +501,7 @@ 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><a href="../types/Coordinate.html">Coordinate</a></code> - The normalized <code>{x, y}</code> point.</p>
+<p><code><a href="../types/Coordinate.html">Coordinate</a></code> - The new coordinate structure scaled proportionately to the physical base canvas width/height.</p>
 </div>
 <hr>
 </div>
@@ -524,12 +528,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>x</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">Normalized horizontal position (0.0 to 1.0).</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The relative or normalized input X horizontal position (0.0 to 1.0).</p></td>
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>displayWidth</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 total width of the display area.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The dynamically calculated width of the central display area.</p></td>
 </tr>
 </tbody>
 </table>
@@ -564,12 +568,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>y</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">Normalized vertical position (0.0 to 1.0).</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The relative or normalized input Y vertical position (0.0 to 1.0).</p></td>
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>displayHeight</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 total height of the display area.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The dynamically calculated height of the central display area.</p></td>
 </tr>
 </tbody>
 </table>
@@ -604,12 +608,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>x</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">Normalized horizontal position (0.0 to 1.0) relative to the HUD area.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The relative or normalized X position specifically within the bounded HUD compartment.</p></td>
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>displayWidth</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 width of the main display (used to calculate the HUD offset).</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The total real width of the central display (used for zero-point alignment offset calculation).</p></td>
 </tr>
 </tbody>
 </table>
@@ -644,12 +648,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>y</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">Normalized vertical position (0.0 to 1.0) relative to the HUD area.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The relative or normalized Y position specifically within the bounded HUD compartment.</p></td>
 </tr>
 <tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>displayHeight</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 total height of the display area.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The absolute pixel height assigned logically to the central display (used for scaled positioning bounds).</p></td>
 </tr>
 </tbody>
 </table>

package/dist/docs/reference/helpers/RelativeValuesHelper.html

@@ -7,6 +7,7 @@
 <meta name="generator" content="Asciidoctor 2.0.20">
 <meta name="description" content="Generic utilities for calculating relative sizes and positions within containers.">
 <meta name="keywords" content="relative, sizing, positioning, layout, helper">
+<meta name="author" content="== Architectural Purpose">
 <title>RelativeValuesHelper Reference</title>
 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700">
 <style>
@@ -440,6 +441,9 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <body class="article toc2 toc-left">
 <div id="header">
 <h1>RelativeValuesHelper Reference</h1>
+<div class="details">
+<span id="author" class="author">== Architectural Purpose</span><br>
+</div>
 <div id="toc" class="toc2">
 <div id="toctitle">Table of Contents</div>
 <ul class="sectlevel1">
@@ -456,7 +460,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <div id="preamble">
 <div class="sectionbody">
 <div class="paragraph">
-<p>The <code>RelativeValuesHelper</code> provides conversion utilities for scaling absolute sizes to the current canvas dimensions, enabling responsive layouts.</p>
+<p>The <code>RelativeValuesHelper</code> provides isolated mathematical layout functions specifically designed to scale absolute sizes to the base runtime canvas. It guarantees isolated calculations for responsive dimensional generation dynamically without hardcoding absolute <code>p5</code> rendering parameters.</p>
 </div>
 </div>
 </div>
@@ -486,7 +490,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>size</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">A float between 0.0 and 1.0 representing percentage of width.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The desired scale fraction bounded between 0.0 and 1.0 representing percentage of width.</p></td>
 </tr>
 </tbody>
 </table>
@@ -521,7 +525,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>size</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">A float between 0.0 and 1.0 representing percentage of height.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The desired scale fraction bounded between 0.0 and 1.0 representing percentage of height.</p></td>
 </tr>
 </tbody>
 </table>

package/dist/docs/reference/interfaces/Debuggable.html

@@ -443,17 +443,19 @@ 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="#getdebugdata-recordstring-string-number-boolean">1.1. <code>getDebugData(): Record&lt;string, string | number | boolean&gt;</code></a></li>
+<li><a href="#getdebugdata-recordstring-string-number-boolean">2.1. <code>getDebugData(): Record&lt;string, string | number | boolean&gt;</code></a></li>
 </ul>
 </li>
-<li><a href="#general-usage">2. General Usage</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>Contract for modules that provide transparency to the developer.</p>
@@ -461,10 +463,10 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </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="getdebugdata-recordstring-string-number-boolean"><a class="link" href="#getdebugdata-recordstring-string-number-boolean">1.1. <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.1. <code>getDebugData(): Record&lt;string, string | number | boolean&gt;</code></a></h3>
 <div class="paragraph">
 <p>Returns a dictionary of internal metrics for real-time inspection.</p>
 </div>
@@ -478,7 +480,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 implemented, the <a href="../modules/Debugger.html">Debugger</a> module will automatically create a UI section for the component and refresh its data every logic tick.</p>