brick-engine-js 1.0.16 → 1.0.18

package/dist/types/core/module/control/GameControl.d.ts

@@ -9,7 +9,7 @@ import { ControlCallback, ControlEventType, GameModules } from '../../types/Type
 export default class GameControl implements Control, Debuggable {
     private _modules;
     private _keyBinding;
-    private _subscribers;
+    private _activeListeners;
     /**
      * Initializes the control system.
      * Sets up key bindings and prepares the input handler.
@@ -29,22 +29,18 @@ export default class GameControl implements Control, Debuggable {
      * @param {GameModules} modules - The collected game modules.
      */
     setModules(modules: GameModules): void;
-    /**
-     * Subscribes a callback to a specific control event.
-     *
-     * @param {ControlKey} key - The key to listen for.
-     * @param {ControlEventType} type - The event type (pressed/held).
-     * @param {ControlCallback} callback - The function to execute.
-     */
     subscribe(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
-    /**
-     * Unsubscribes a callback from a control event.
-     *
-     * @param {ControlKey} key - The key to stop listening for.
-     * @param {ControlEventType} type - The event type.
-     * @param {ControlCallback} callback - The function to remove.
-     */
     unsubscribe(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    subscribeForTitleScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    unsubscribeForTitleScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    subscribeForGameOverScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    unsubscribeForGameOverScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    subscribeForPlayingScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    unsubscribeForPlayingScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    subscribeForPausedScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    unsubscribeForPausedScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    private _subscribe;
+    private _unsubscribe;
     /**
      * Notifies subscribers of a control event.
      *

package/dist/types/core/module/renderer/DisplayRenderer.d.ts

@@ -1,4 +1,3 @@
-import p5 from 'p5';
 import { Cell, GameModules, RendererMetrics } from '../../types/Types';
 import { Renderer, State } from '../../types/modules';
 /**
@@ -6,16 +5,9 @@ import { Renderer, State } from '../../types/modules';
  * Handles cell rendering, background drawing, and optimizes static elements using an off-screen buffer.
  */
 export default class DisplayRenderer implements Renderer {
-    private _p;
     private _rendererMetrics;
     private _cellPreCalculatedGeometry;
     private _staticGraphics;
-    /**
-     * Creates an instance of the DisplayRenderer.
-     *
-     * @param {p5} p - The p5 instance.
-     */
-    constructor(p: p5);
     /**
      * Initializes the renderer with the calculated metrics.
      * Pre-calculates cell geometry for faster rendering.

package/dist/types/core/module/renderer/GameRenderer.d.ts

@@ -1,4 +1,3 @@
-import p5 from 'p5';
 import { Cell, GameModules, RendererMetrics } from '../../types/Types';
 import { Debuggable } from '../../types/Interfaces';
 import { Renderer } from '../../types/modules';
@@ -9,17 +8,10 @@ import { RendererComposite } from '../../types/modules';
  * Handles the calculation of shared rendering metrics (sizes, positions) to ensure consistency.
  */
 export default class GameRenderer implements RendererComposite, Debuggable {
-    private _p;
     private _renderers;
     private _displayRenderer;
     private _hudRenderer;
     private _rendererMetrics;
-    /**
-     * Creates an instance of GameRenderer.
-     *
-     * @param {p5} p - The p5 instance.
-     */
-    constructor(p: p5);
     /**
      * Adds a sub-renderer to the composition.
      *

package/dist/types/core/module/renderer/HudRenderer.d.ts

@@ -1,21 +1,13 @@
 import { Renderer } from '../../types/modules';
 import { Cell, GameModules, RendererMetrics } from '../../types/Types';
-import p5 from 'p5';
 /**
  * Responsible for rendering the Heads-Up Display (HUD).
  * Displays game information like Score, High Score, Level, and the Next Piece Preview.
  */
 export default class HudRenderer implements Renderer {
-    private _p;
     private _gridOrigin;
     private _cellSize;
     private _hudBorderRect;
-    /**
-     * Creates an instance of HudRenderer.
-     *
-     * @param {p5} p - The p5 instance.
-     */
-    constructor(p: p5);
     /**
      * Initializes the HUD with calculated metrics.
      * Sets up the grid origin and border rectangle for the "next piece" preview area.

package/dist/types/core/module/score/GameScore.d.ts

@@ -12,12 +12,14 @@ export default class GameScore implements Score, Debuggable, Serializable {
     private _level;
     private _maxLevel;
     private _highScore;
+    private _gameId;
     serialId: string;
     /**
-     * Initializes the score module.
-     * Currently a no-op but required by interface.
+     * Sets up the game high score.
+     *
+     * @param {string} id - The game ID.
      */
-    setup(): void;
+    setupGameHighScore(id: string): void;
     /**
      * Increases the score by the given amount, applying the current multiplier.
      * Automatically checks for high score updates.

package/dist/types/core/module/session/GameSession.d.ts

@@ -14,7 +14,6 @@ export default class GameSession implements Session {
     setSessionEnabled(enabled: boolean): void;
     private _hasSession;
     private _loadSession;
-    private _destroySession;
     syncState(state: State): void;
     getDebugData(): Record<string, string | number | boolean>;
     private _key;

package/dist/types/core/module/state/GameState.d.ts

@@ -15,8 +15,6 @@ import { StateProperty } from '../../types/Types';
  */
 export default class GameState implements State, Debuggable {
     private _state;
-    /** Map to store property names and their associated subscription callbacks. */
-    private _subscribers;
     /**
      * Initializes the state module.
      * Sets default values for all state properties and loads persisted data.
@@ -35,11 +33,11 @@ export default class GameState implements State, Debuggable {
     private _set;
     /**
      * Notifies all subscribers of a property change.
+     * Dispatches to the base property channel and state-specific context channels.
      *
      * @param {StateProperty} property - The property that changed.
-     * @param {boolean | number} value - The new value of the property.
      */
-    private _notify;
+    notify(property: StateProperty): void;
     /**
      * Checks if the game machine is powered on.
      *
@@ -149,20 +147,18 @@ export default class GameState implements State, Debuggable {
      * Toggles the muted state.
      */
     toggleMuted(): void;
-    /**
-     * Subscribes to changes in specific state properties.
-     *
-     * @param {StateProperty} property - The state property to monitor.
-     * @param {function(boolean | number): void} callback - The function to execute when the property changes.
-     */
     subscribe(property: StateProperty, callback: (value: boolean | number) => void): void;
-    /**
-     * Unsubscribes from changes in specific state properties.
-     *
-     * @param {StateProperty} property - The state property to monitor.
-     * @param {function(boolean | number): void} callback - The function to remove.
-     */
     unsubscribe(property: StateProperty, callback: (value: boolean | number) => void): void;
+    subscribeForTitleScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
+    unsubscribeForTitleScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
+    subscribeForGameOverScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
+    unsubscribeForGameOverScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
+    subscribeForPlayingScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
+    unsubscribeForPlayingScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
+    subscribeForPausedScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
+    unsubscribeForPausedScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
+    private _subscribe;
+    private _unsubscribe;
     /**
      * Retrieves debug information about the game state.
      *

package/dist/types/core/module/text/GameText.d.ts

@@ -1,4 +1,3 @@
-import p5 from 'p5';
 import { FontSize, FontAlign, FontVerticalAlign } from '../../types/enums';
 import { Coordinate, RendererMetrics } from '../../types/Types';
 import { Debuggable } from '../../types/Interfaces';
@@ -16,14 +15,6 @@ export default class GameText implements Text, Debuggable {
     private fontSizes;
     /** Stores the current display metrics for relative positioning. */
     private _rendererMetrics;
-    /** The p5 instance used for rendering. */
-    private _p;
-    /**
-     * Creates an instance of GameText.
-     *
-     * @param {p5} p - The p5 instance.
-     */
-    constructor(p: p5);
     /**
      * Setup the font and pre-calculates relative font sizes.
      *

package/dist/types/core/types/modules.d.ts

@@ -486,6 +486,38 @@ export interface State extends Initializable {
      * @param {function(boolean | number): void} callback - The callback reference to remove.
      */
     unsubscribe(property: StateProperty, callback: (value: boolean | number) => void): void;
+    /**
+     * Registers a callback for a specific state change ONLY during the title screen.
+     */
+    subscribeForTitleScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
+    /**
+     * Removes an existing title screen subscription.
+     */
+    unsubscribeForTitleScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
+    /**
+     * Registers a callback for a specific state change ONLY during the game over screen.
+     */
+    subscribeForGameOverScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
+    /**
+     * Removes an existing game over screen subscription.
+     */
+    unsubscribeForGameOverScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
+    /**
+     * Registers a callback for a specific state change ONLY during active gameplay.
+     */
+    subscribeForPlayingScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
+    /**
+     * Removes an existing playing screen subscription.
+     */
+    unsubscribeForPlayingScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
+    /**
+     * Registers a callback for a specific state change ONLY during the paused screen.
+     */
+    subscribeForPausedScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
+    /**
+     * Removes an existing paused screen subscription.
+     */
+    unsubscribeForPausedScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
     /** Turn the game system on. */
     turnOn(): void;
     /** Turn the game system off. */
@@ -523,12 +555,6 @@ export interface Control extends Initializable {
      * @param {ControlEventType} type - The type of event (press/hold).
      */
     notify(key: ControlKey, type: ControlEventType): void;
-    /**
-     * Injects the module references required for populating the event context.
-     *
-     * @param {GameModules} modules - The collection of system modules.
-     */
-    setModules(modules: GameModules): void;
     /**
      * Registers a callback for a specific control event.
      *
@@ -545,6 +571,44 @@ export interface Control extends Initializable {
      * @param {ControlCallback} callback - The function reference to remove.
      */
     unsubscribe(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    /**
+     * Registers a callback for a specific control event ONLY during the title screen.
+     */
+    subscribeForTitleScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    /**
+     * Removes an existing title screen subscription.
+     */
+    unsubscribeForTitleScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    /**
+     * Registers a callback for a specific control event ONLY during the game over screen.
+     */
+    subscribeForGameOverScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    /**
+     * Removes an existing game over screen subscription.
+     */
+    unsubscribeForGameOverScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    /**
+     * Registers a callback for a specific control event ONLY during active gameplay.
+     */
+    subscribeForPlayingScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    /**
+     * Removes an existing playing screen subscription.
+     */
+    unsubscribeForPlayingScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    /**
+     * Registers a callback for a specific control event ONLY during the paused screen.
+     */
+    subscribeForPausedScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    /**
+     * Removes an existing paused screen subscription.
+     */
+    unsubscribeForPausedScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
+    /**
+     * Injects the module references required for populating the event context.
+     *
+     * @param {GameModules} modules - The collection of system modules.
+     */
+    setModules(modules: GameModules): void;
     /**
      * Detaches all hardware/DOM event listeners.
      */
@@ -660,7 +724,7 @@ export interface TimePerformanceMonitor {
 /**
  * Interface for the score and progression module.
  */
-export interface Score extends Initializable {
+export interface Score {
     /** Current session score points. */
     score: number;
     /** Current high score. */
@@ -698,6 +762,12 @@ export interface Score extends Initializable {
      * Resets the level to the starting value (1).
      */
     resetLevel(): void;
+    /**
+     * Sets up the game high score.
+     *
+     * @param {string} id - The game ID.
+     */
+    setupGameHighScore(id: string): void;
 }
 export interface Session extends StateSyncable, Debuggable {
     gameId: string;

package/dist/types/index.d.ts

@@ -5,5 +5,7 @@ export * from './core/types/modules';
 export * from './core/types/Types';
 export { default as Game } from './core/Game';
 export { default as GameView } from './view/GameView';
+export { default as RendererContext } from './core/context/RendererContext';
+export { default as EventEmitter } from './core/event/EventEmitter';
 export { default as configs } from './config/configs';
 export { bootstrap, setActiveGame } from './bootstrap';

package/dist/types/view/Debugger.d.ts

@@ -1,11 +1,9 @@
-import p5 from 'p5';
 import { Initializable } from '../core/types/Interfaces';
 import { GameModules } from '../core/types/Types';
 export default class NewDebugger implements Initializable {
-    private _p;
     private _gameModules;
     private _moduleElements;
-    constructor(gameModules: GameModules, p: p5);
+    constructor(gameModules: GameModules);
     setup(): void;
     setGameModules(gameModules: GameModules): void;
     update(): void;

package/dist/types/view/GameView.d.ts

@@ -22,7 +22,6 @@ export default class GameView {
     private _leftBtn;
     private _actionBtn;
     private _parent;
-    private _p;
     private _inputHandler;
     private _cachedCanvas;
     private _debugger;
@@ -33,7 +32,7 @@ export default class GameView {
      * @param p - The p5 instance used for rendering and event handling.
      * @param parent - The DOM element where the game view will be attached.
      */
-    constructor(p: p5, parent: HTMLElement);
+    constructor(parent: HTMLElement);
     /**
      * Checks if the game body has been built.
      * @returns True if the game body has been built, false otherwise.

package/dist/types/view/SessionModal.d.ts

@@ -1,11 +1,9 @@
 import { Initializable } from '../core/types/Interfaces';
-import p5 from 'p5';
 export default class SessionModal implements Initializable {
-    private _p;
     private _container;
     private _confirmButton;
     private _cancelButton;
-    constructor(p: p5);
+    constructor();
     setup(): void;
     show(onConfirm: () => void, onCancel: () => void): void;
     private _hide;

package/dist/types/view/components/layout/ButtonLayout.d.ts

@@ -21,5 +21,5 @@ interface ButtonLayoutResponse {
  *  - directionVerticalContainer: For Up/Down buttons.
  *  - directionHorizontalContainer: For Left/Right buttons.
  */
-export default function ButtonLayout(p: p5, container: p5.Element): ButtonLayoutResponse;
+export default function ButtonLayout(container: p5.Element): ButtonLayoutResponse;
 export {};

package/dist/types/view/components/layout/ContainerLayout.d.ts

@@ -19,5 +19,5 @@ interface ContainerResponse {
  * @param {HTMLElement} parent - The DOM element where the container will be appended.
  * @returns {ContainerResponse} Object containing the container element and its calculated width/height.
  */
-export default function ContainerLayout(p: p5, parent: HTMLElement): ContainerResponse;
+export default function ContainerLayout(parent: HTMLElement): ContainerResponse;
 export {};

package/dist/types/view/components/layout/FrameLayout.d.ts

@@ -8,4 +8,4 @@ import p5 from 'p5';
  * @param container - The parent container element.
  * @returns The created frame element.
  */
-export default function FrameLayout(p: p5, container: p5.Element): p5.Element;
+export default function FrameLayout(container: p5.Element): p5.Element;

package/dist/types/view/components/ui/BigButton.d.ts

@@ -10,4 +10,4 @@ import p5 from 'p5';
  * @param label - The text label for the button (currently used for aria-label or internal logic as visual label is commented out).
  * @returns The created button element.
  */
-export default function BigButton(p: p5, container: p5.Element, label: string): p5.Element;
+export default function BigButton(container: p5.Element, label: string): p5.Element;

package/dist/types/view/components/ui/Button.d.ts

@@ -9,4 +9,4 @@ import p5 from 'p5';
  * @param label - The text label for the button.
  * @returns The created button element.
  */
-export default function Button(p: p5, container: p5.Element, label: string): p5.Element;
+export default function Button(container: p5.Element, label: string): p5.Element;

package/dist/types/view/components/ui/Canvas.d.ts

@@ -18,5 +18,5 @@ interface CanvasResponse {
  * @param {number} width - The width of the outer container, used to calculate canvas dimensions with `configs.viewLayout.canvas.widthRatio`.
  * @returns {CanvasResponse} Object containing the canvas element and its calculated dimensions.
  */
-export default function Canvas(p: p5, container: p5.Element, width: number): CanvasResponse;
+export default function Canvas(container: p5.Element, width: number): CanvasResponse;
 export {};

package/dist/types/view/components/ui/SmallButton.d.ts

@@ -10,4 +10,4 @@ import p5 from 'p5';
  * @param {boolean} top - Determines position/styling nuance (e.g. if it belongs to the top row of small buttons).
  * @returns {p5.Element} The created button element.
  */
-export default function SmallButton(p: p5, container: p5.Element, label: string, top: boolean): p5.Element;
+export default function SmallButton(container: p5.Element, label: string, top: boolean): p5.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brick-engine-js",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "A lightweight brick engine built with p5.js and TypeScript",
   "type": "commonjs",
   "main": "dist/brick-engine.js",