brick-engine-js 1.0.21 → 1.0.23

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

@@ -12,6 +12,7 @@ export interface Renderer extends RendererInitializable {
      *
      * @param {Cell[][]} grid - The current state of the game grid.
      * @param {GameModules} modules - Access to other engine modules for context (e.g., Score, State).
+     * @returns {void} Returns nothing.
      */
     render(grid: Cell[][], modules: GameModules): void;
 }
@@ -23,6 +24,7 @@ export interface RendererComposite {
      * Registers a new renderer layer to the composite system.
      *
      * @param {Renderer} renderer - The renderer instance to add.
+     * @returns {void} Returns nothing.
      */
     addRenderer(renderer: Renderer): void;
     /**
@@ -30,6 +32,7 @@ export interface RendererComposite {
      *
      * @param {Cell[][]} grid - The current state of the game grid.
      * @param {GameModules} modules - Access to other engine modules.
+     * @returns {void} Returns nothing.
      */
     render(grid: Cell[][], modules: GameModules): void;
     /**
@@ -46,20 +49,26 @@ export interface Text extends Initializable {
      * Sets the display metrics used for coordinate calculations.
      *
      * @param {RendererMetrics} rendererMetrics - The calculated layout metrics.
+     * @returns {void} Returns nothing.
      */
     setRendererMetrics(rendererMetrics: RendererMetrics): void;
     /**
      * Sets the text color to the "active" theme color.
+     *
+     * @returns {void} Returns nothing.
      */
     setActiveText(): void;
     /**
      * Sets the text color to the "inactive" theme color.
+     *
+     * @returns {void} Returns nothing.
      */
     setInactiveText(): void;
     /**
      * Sets the current font size.
      *
      * @param {FontSize} fontSize - The desired size enum value.
+     * @returns {void} Returns nothing.
      */
     setTextSize(fontSize: FontSize): void;
     /**
@@ -67,6 +76,7 @@ export interface Text extends Initializable {
      *
      * @param {FontAlign} fontAlign - The horizontal alignment.
      * @param {FontVerticalAlign} fontVerticalAlign - The vertical alignment.
+     * @returns {void} Returns nothing.
      */
     setTextAlign(fontAlign: FontAlign, fontVerticalAlign: FontVerticalAlign): void;
     /**
@@ -74,6 +84,7 @@ export interface Text extends Initializable {
      *
      * @param {string} text - The string content to display.
      * @param {Coordinate} coordinate - The normalized position (0.0 to 1.0) within the HUD.
+     * @returns {void} Returns nothing.
      */
     textOnHud(text: string, coordinate: Coordinate): void;
     /**
@@ -81,6 +92,7 @@ export interface Text extends Initializable {
      *
      * @param {string} text - The string content to display.
      * @param {Coordinate} coordinate - The normalized position (0.0 to 1.0) within the Display.
+     * @returns {void} Returns nothing.
      */
     textOnDisplay(text: string, coordinate: Coordinate): void;
 }
@@ -96,17 +108,28 @@ export interface Grid extends Initializable {
      */
     getGrid(): Cell[][];
     /** The number of columns in the grid. */
-    width: number;
+    readonly width: number;
     /** The number of rows in the grid. */
-    height: number;
+    readonly height: number;
+    /** The index of the top-most row (always 0). */
+    readonly topRow: number;
+    /** The index of the bottom-most row. */
+    readonly bottomRow: number;
+    /** The index of the left-most column (always 0). */
+    readonly leftColumn: number;
+    /** The index of the right-most column. */
+    readonly rightColumn: number;
     /**
      * Resets the entire grid to its empty state.
+     *
+     * @returns {void} Returns nothing.
      */
     resetGrid(): void;
     /**
      * Iterates over every cell in the grid.
      *
      * @param {function(Cell): void} callback - The function to execute for each cell.
+     * @returns {void} Returns nothing.
      */
     forEach(callback: (cell: Cell) => void): void;
     /**
@@ -128,6 +151,7 @@ export interface Grid extends Initializable {
      *
      * @param {Coordinate} coordinate - The target location.
      * @param {number} value - The new value (0 for empty).
+     * @returns {void} Returns nothing.
      */
     setCellValue(coordinate: Coordinate, value: number): void;
     /**
@@ -135,22 +159,23 @@ export interface Grid extends Initializable {
      *
      * @param {Coordinate} coordinate - The target location.
      * @param {Color} color - The new color.
+     * @returns {void} Returns nothing.
      */
     setCellColor(coordinate: Coordinate, color: Color): void;
     /**
      * Checks if a cell is occupied (value > 0).
      *
-     * @param {Coordinate} coordinate - The location to check.
+     * @param {Cell} cell - The cell to check.
      * @returns {boolean} `true` if active.
      */
-    isCellActive(coordinate: Coordinate): boolean;
+    isCellActive(cell: Cell): boolean;
     /**
      * Checks if a cell is empty (value == 0).
      *
-     * @param {Coordinate} coordinate - The location to check.
+     * @param {Cell} cell - The cell to check.
      * @returns {boolean} `true` if inactive.
      */
-    isCellInactive(coordinate: Coordinate): boolean;
+    isCellInactive(cell: Cell): boolean;
     /**
      * Checks if a specific row is completely full.
      *
@@ -169,18 +194,21 @@ export interface Grid extends Initializable {
      * Clears all cells in a specific row.
      *
      * @param {number} y - The row index.
+     * @returns {void} Returns nothing.
      */
     clearRow(y: number): void;
     /**
      * Shifts all rows above the specified index down by one.
      *
      * @param {number} fromY - The row index to start from.
+     * @returns {void} Returns nothing.
      */
     shiftRowsDown(fromY: number): void;
     /**
      * Shifts all rows below the specified index up by one.
      *
      * @param {number} fromY - The row index to start from.
+     * @returns {void} Returns nothing.
      */
     shiftRowsUp(fromY: number): void;
     /**
@@ -207,18 +235,21 @@ export interface Grid extends Initializable {
      * Clears all cells in a specific column.
      *
      * @param {number} x - The column index.
+     * @returns {void} Returns nothing.
      */
     clearColumn(x: number): void;
     /**
      * Shifts all columns to the right of the specified index.
      *
      * @param {number} fromX - The column index to start from.
+     * @returns {void} Returns nothing.
      */
     shiftColumnsRight(fromX: number): void;
     /**
      * Shifts all columns to the left of the specified index.
      *
      * @param {number} fromX - The column index to start from.
+     * @returns {void} Returns nothing.
      */
     shiftColumnsLeft(fromX: number): void;
     /**
@@ -241,101 +272,104 @@ export interface Grid extends Initializable {
      * @param {Coordinate} end - Bottom-right coordinate.
      * @param {number} value - The value to fill.
      * @param {Color} color - The color to fill.
+     * @returns {void} Returns nothing.
      */
     fillArea(start: Coordinate, end: Coordinate, value: number, color: Color): void;
     /**
      * Updates multiple coordinates simultaneously with their specific values and colors.
      *
-     * @param {Piece} piece - The collection of cells to stamp.
+     * @param {Piece | Cell[]} cells - The collection of cells to stamp.
+     * @returns {void} Returns nothing.
      */
-    stampPiece(piece: Piece): void;
+    stampPiece(cells: Piece | Cell[]): void;
     /**
      * Updates a single coordinate with a specific value and color from a Cell.
      *
      * @param {Cell} cell - The cell containing coordinate, value and color.
+     * @returns {void} Returns nothing.
      */
     stampCell(cell: Cell): void;
     /**
      * Attempts to move a piece in a given direction.
      *
-     * @param {Piece} piece - The current piece coordinates.
+     * @param {Piece | Cell[]} cells - The current piece coordinates.
      * @param {Vector} direction - The movement vector.
-     * @returns {Piece | null} The new piece or null if blocked.
+     * @returns {Piece} The new piece.
      */
-    movePiece(piece: Piece, direction: Vector): Piece | null;
+    movePiece(cells: Piece | Cell[], direction: Vector): Piece;
     /**
      * Attempts to move a piece one unit to the left.
      *
-     * @param {Piece} piece - The current piece coordinates.
-     * @returns {Piece | null} The new piece or null if blocked.
+     * @param {Piece | Cell[]} cells - The current piece coordinates.
+     * @returns {Piece} The new piece.
      */
-    movePieceLeft(piece: Piece): Piece | null;
+    movePieceLeft(cells: Piece | Cell[]): Piece;
     /**
      * Attempts to move a piece one unit to the right.
      *
-     * @param {Piece} piece - The current piece coordinates.
-     * @returns {Piece | null} The new piece or null if blocked.
+     * @param {Piece | Cell[]} cells - The current piece coordinates.
+     * @returns {Piece} The new piece.
      */
-    movePieceRight(piece: Piece): Piece | null;
+    movePieceRight(cells: Piece | Cell[]): Piece;
     /**
      * Attempts to move a piece one unit up.
      *
-     * @param {Piece} piece - The current piece coordinates.
-     * @returns {Piece | null} The new piece or null if blocked.
+     * @param {Piece | Cell[]} cells - The current piece coordinates.
+     * @returns {Piece} The new piece.
      */
-    movePieceUp(piece: Piece): Piece | null;
+    movePieceUp(cells: Piece | Cell[]): Piece;
     /**
      * Attempts to move a piece one unit down.
      *
-     * @param {Piece} piece - The current piece coordinates.
-     * @returns {Piece | null} The new piece or null if blocked.
+     * @param {Piece | Cell[]} cells - The current piece coordinates.
+     * @returns {Piece} The new piece.
      */
-    movePieceDown(piece: Piece): Piece | null;
+    movePieceDown(cells: Piece | Cell[]): Piece;
     /**
      * Attempts to move a single coordinate in a given direction.
      *
      * @param {Cell} cell - The current cell.
      * @param {Vector} direction - The movement vector.
-     * @returns {Cell | null} The new cell or null if blocked.
+     * @returns {Cell} The new cell.
      */
-    moveCell(cell: Cell, direction: Vector): Cell | null;
+    moveCell(cell: Cell, direction: Vector): Cell;
     /**
      * Attempts to move a single coordinate one unit to the left.
      *
      * @param {Cell} cell - The current cell.
-     * @returns {Cell | null} The new cell or null if blocked.
+     * @returns {Cell} The new cell.
      */
-    moveCellLeft(cell: Cell): Cell | null;
+    moveCellLeft(cell: Cell): Cell;
     /**
      * Attempts to move a single coordinate one unit to the right.
      *
      * @param {Cell} cell - The current cell.
-     * @returns {Cell | null} The new cell or null if blocked.
+     * @returns {Cell} The new cell.
      */
-    moveCellRight(cell: Cell): Cell | null;
+    moveCellRight(cell: Cell): Cell;
     /**
      * Attempts to move a single coordinate one unit up.
      *
      * @param {Cell} cell - The current cell.
-     * @returns {Cell | null} The new cell or null if blocked.
+     * @returns {Cell} The new cell.
      */
-    moveCellUp(cell: Cell): Cell | null;
+    moveCellUp(cell: Cell): Cell;
     /**
      * Attempts to move a single coordinate one unit down.
      *
      * @param {Cell} cell - The current cell.
-     * @returns {Cell | null} The new cell or null if blocked.
+     * @returns {Cell} The new cell.
      */
-    moveCellDown(cell: Cell): Cell | null;
+    moveCellDown(cell: Cell): Cell;
     /**
      * Attempts to rotate a piece 90 degrees around a specific origin.
      *
      * @param {Piece} piece - The current piece.
      * @param {Coordinate} origin - The center of rotation.
      * @param {boolean} [clockwise=true] - Direction of rotation.
-     * @returns {Piece | null} The new piece or null if blocked.
+     * @returns {Piece} The new piece.
      */
-    rotatePiece(piece: Piece, origin: Coordinate, clockwise?: boolean): Piece | null;
+    rotatePiece(piece: Piece, origin: Coordinate, clockwise?: boolean): Piece;
     /**
      * Identifies all rows that are completely filled with active cells.
      *
@@ -404,6 +438,7 @@ export interface Grid extends Initializable {
      *
      * @param {Coordinate} a - First coordinate.
      * @param {Coordinate} b - Second coordinate.
+     * @returns {void} Returns nothing.
      */
     swapCells(a: Coordinate, b: Coordinate): void;
 }
@@ -458,6 +493,7 @@ export interface State extends Initializable {
      * Sets the color rendering preference.
      *
      * @param {boolean} value - The new state.
+     * @returns {void} Returns nothing.
      */
     setColorEnabled(value: boolean): void;
     /**
@@ -470,6 +506,7 @@ export interface State extends Initializable {
      * Sets the master mute state.
      *
      * @param {boolean} value - The new mute state.
+     * @returns {void} Returns nothing.
      */
     setMuted(value: boolean): void;
     /**
@@ -477,6 +514,7 @@ export interface State extends Initializable {
      *
      * @param {StateProperty} property - The state property to monitor.
      * @param {function(boolean | number): void} callback - The function to execute when the property changes.
+     * @returns {void} Returns nothing.
      */
     subscribe(property: StateProperty, callback: (value: boolean | number) => void): void;
     /**
@@ -484,62 +522,118 @@ export interface State extends Initializable {
      *
      * @param {StateProperty} property - The state property being monitored.
      * @param {function(boolean | number): void} callback - The callback reference to remove.
+     * @returns {void} Returns nothing.
      */
     unsubscribe(property: StateProperty, callback: (value: boolean | number) => void): void;
     /**
      * Registers a callback for a specific state change ONLY during the title screen.
+     * @param {StateProperty} property - The state property to monitor.
+     * @param {function(boolean | number): void} callback - The function to execute when the property changes.
+     * @returns {void} Returns nothing.
      */
     subscribeForTitleScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
     /**
      * Removes an existing title screen subscription.
+     * @param {StateProperty} property - The state property to monitor.
+     * @param {function(boolean | number): void} callback - The function to execute when the property changes.
+     * @returns {void} Returns nothing.
      */
     unsubscribeForTitleScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
     /**
      * Registers a callback for a specific state change ONLY during the game over screen.
+     * @param {StateProperty} property - The state property to monitor.
+     * @param {function(boolean | number): void} callback - The function to execute when the property changes.
+     * @returns {void} Returns nothing.
      */
     subscribeForGameOverScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
     /**
      * Removes an existing game over screen subscription.
+     * @param {StateProperty} property - The state property to monitor.
+     * @param {function(boolean | number): void} callback - The function to execute when the property changes.
+     * @returns {void} Returns nothing.
      */
     unsubscribeForGameOverScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
     /**
      * Registers a callback for a specific state change ONLY during active gameplay.
+     * @param {StateProperty} property - The state property to monitor.
+     * @param {function(boolean | number): void} callback - The function to execute when the property changes.
+     * @returns {void} Returns nothing.
      */
     subscribeForPlayingScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
     /**
      * Removes an existing playing screen subscription.
+     * @param {StateProperty} property - The state property to monitor.
+     * @param {function(boolean | number): void} callback - The function to execute when the property changes.
+     * @returns {void} Returns nothing.
      */
     unsubscribeForPlayingScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
     /**
      * Registers a callback for a specific state change ONLY during the paused screen.
+     * @param {StateProperty} property - The state property to monitor.
+     * @param {function(boolean | number): void} callback - The function to execute when the property changes.
+     * @returns {void} Returns nothing.
      */
     subscribeForPausedScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
     /**
      * Removes an existing paused screen subscription.
+     * @param {StateProperty} property - The state property to monitor.
+     * @param {function(boolean | number): void} callback - The function to execute when the property changes.
+     * @returns {void} Returns nothing.
      */
     unsubscribeForPausedScreen(property: StateProperty, callback: (value: boolean | number) => void): void;
-    /** Turn the game system on. */
+    /**
+     * Turn the game system on.
+     * @returns {void} Returns nothing.
+     */
     turnOn(): void;
-    /** Turn the game system off. */
+    /**
+     * Turn the game system off.
+     * @returns {void} Returns nothing.
+     */
     turnOff(): void;
-    /** Initiate a new game (transition from Title Screen to Gameplay). */
+    /**
+     * Initiate a new game (transition from Title Screen to Gameplay).
+     * @returns {void} Returns nothing.
+     */
     startGame(): void;
-    /** Exit the current game session (transition to Title Screen). */
+    /**
+     * Exit the current game session (transition to Title Screen).
+     * @returns {void} Returns nothing.
+     */
     exitGame(): void;
-    /** Pause the current game logic. */
+    /**
+     * Pause the current game logic.
+     * @returns {void} Returns nothing.
+     */
     pause(): void;
-    /** Resume the game logic from a paused state. */
+    /**
+     * Resume the game logic from a paused state.
+     * @returns {void} Returns nothing.
+     */
     resume(): void;
-    /** Trigger a game over state. */
+    /**
+     * Trigger a game over state.
+     * @returns {void} Returns nothing.
+     */
     triggerGameOver(): void;
-    /** Reset the game state flags for a new round (post-Game Over). */
+    /**
+     * Reset the game state flags for a new round (post-Game Over).
+     * @returns {void} Returns nothing.
+     */
     resetGame(): void;
-    /** Toggles the {@link StateProperty.COLOR_ENABLED} state. */
+    /**
+     * Toggles the {@link StateProperty.COLOR_ENABLED} state.
+     * @returns {void} Returns nothing.
+     */
     toggleColorEnabled(): void;
-    /** Toggles the {@link StateProperty.MUTED} state. */
+    /**
+     * Toggles the {@link StateProperty.MUTED} state.
+     * @returns {void} Returns nothing.
+     */
     toggleMuted(): void;
     /**
      * Resets the game over state and starts the game again.
+     * @returns {void} Returns nothing.
      */
     resetGameOver(): void;
 }
@@ -553,6 +647,7 @@ export interface Control extends Initializable {
      *
      * @param {ControlKey} key - The key identity.
      * @param {ControlEventType} type - The type of event (press/hold).
+     * @returns {void} Returns nothing.
      */
     notify(key: ControlKey, type: ControlEventType): void;
     /**
@@ -561,6 +656,7 @@ export interface Control extends Initializable {
      * @param {ControlKey} key - The key to listen for.
      * @param {ControlEventType} type - The event trigger type.
      * @param {ControlCallback} callback - The function to execute.
+     * @returns {void} Returns nothing.
      */
     subscribe(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
     /**
@@ -569,52 +665,90 @@ export interface Control extends Initializable {
      * @param {ControlKey} key - The key to stop listening for.
      * @param {ControlEventType} type - The event trigger type.
      * @param {ControlCallback} callback - The function reference to remove.
+     * @returns {void} Returns nothing.
      */
     unsubscribe(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
     /**
      * Registers a callback for a specific control event ONLY during the title screen.
+     * @param {ControlKey} key - The key to listen for.
+     * @param {ControlEventType} type - The event trigger type.
+     * @param {ControlCallback} callback - The function reference to remove.
+     * @returns {void} Returns nothing.
      */
     subscribeForTitleScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
     /**
      * Removes an existing title screen subscription.
+     * @param {ControlKey} key - The key to stop listening for.
+     * @param {ControlEventType} type - The event trigger type.
+     * @param {ControlCallback} callback - The function reference to remove.
+     * @returns {void} Returns nothing.
      */
     unsubscribeForTitleScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
     /**
      * Registers a callback for a specific control event ONLY during the game over screen.
+     * @param {ControlKey} key - The key to listen for.
+     * @param {ControlEventType} type - The event trigger type.
+     * @param {ControlCallback} callback - The function to execute.
+     * @returns {void} Returns nothing.
      */
     subscribeForGameOverScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
     /**
      * Removes an existing game over screen subscription.
+     * @param {ControlKey} key - The key to stop listening for.
+     * @param {ControlEventType} type - The event trigger type.
+     * @param {ControlCallback} callback - The function reference to remove.
+     * @returns {void} Returns nothing.
      */
     unsubscribeForGameOverScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
     /**
      * Registers a callback for a specific control event ONLY during active gameplay.
+     * @param {ControlKey} key - The key to listen for.
+     * @param {ControlEventType} type - The event trigger type.
+     * @param {ControlCallback} callback - The function to execute.
+     * @returns {void} Returns nothing.
      */
     subscribeForPlayingScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
     /**
      * Removes an existing playing screen subscription.
+     * @param {ControlKey} key - The key to stop listening for.
+     * @param {ControlEventType} type - The event trigger type.
+     * @param {ControlCallback} callback - The function reference to remove.
+     * @returns {void} Returns nothing.
      */
     unsubscribeForPlayingScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
     /**
      * Registers a callback for a specific control event ONLY during the paused screen.
+     * @param {ControlKey} key - The key to listen for.
+     * @param {ControlEventType} type - The event trigger type.
+     * @param {ControlCallback} callback - The function to execute.
+     * @returns {void} Returns nothing.
      */
     subscribeForPausedScreen(key: ControlKey, type: ControlEventType, callback: ControlCallback): void;
     /**
      * Removes an existing paused screen subscription.
+     * @param {ControlKey} key - The key to stop listening for.
+     * @param {ControlEventType} type - The event trigger type.
+     * @param {ControlCallback} callback - The function reference to remove.
+     * @returns {void} Returns nothing.
      */
     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.
+     * @returns {void} Returns nothing.
      */
     setModules(modules: GameModules): void;
     /**
      * Detaches all hardware/DOM event listeners.
+     *
+     * @returns {void} Returns nothing.
      */
     unbindControls(): void;
     /**
      * Attaches all hardware/DOM event listeners.
+     *
+     * @returns {void} Returns nothing.
      */
     bindControls(): void;
 }
@@ -625,10 +759,22 @@ export interface Control extends Initializable {
 export interface Time extends Initializable {
     /** The interval between logic ticks in milliseconds. */
     tickInterval: number;
+    /** The total number of ticks since the game started. */
+    readonly totalTicks: number;
+    /** Total elapsed time in milliseconds since the game started. */
+    readonly elapsedTime: number;
+    /**
+     * Checks if enough time has passed for a game tick based on a specific interval.
+     *
+     * @param {number} interval - The tick interval to check.
+     * @returns {boolean} `true` if the current tick is a multiple of the interval.
+     */
+    isTickEvery(interval: number): boolean;
     /**
      * Accumulates passed time and calculates FPS/TPS.
      *
      * @param {number} deltaTime - Time elapsed since last frame in milliseconds.
+     * @returns {void} Returns nothing.
      */
     update(deltaTime: number): void;
     /**
@@ -639,35 +785,43 @@ export interface Time extends Initializable {
     shouldTick(): boolean;
     /**
      * Resets internal time accumulators and counters.
+     *
+     * @returns {void} Returns nothing.
      */
     reset(): void;
     /**
      * Increases the tick interval (slowing down the game logic).
      *
      * @param {number} amount - Milliseconds to add.
+     * @returns {void} Returns nothing.
      */
     incrementTickInterval(amount: number): void;
     /**
      * Decreases the tick interval (speeding up the game logic).
      *
      * @param {number} amount - Milliseconds to subtract.
+     * @returns {void} Returns nothing.
      */
     decrementTickInterval(amount: number): void;
     /**
      * Sets the tick interval.
      *
      * @param {number} interval - The new tick interval in milliseconds.
+     * @returns {void} Returns nothing.
      */
     setTickInterval(interval: number): void;
     /**
      * Sets the minimum tick interval.
      *
      * @param {number} interval - The new minimum tick interval in milliseconds.
+     * @returns {void} Returns nothing.
      */
     setMinTickInterval(interval: number): void;
     /**
      * Captures the current tick interval as the initial state.
      * Use this after games have set their starting speed.
+     *
+     * @returns {void} Returns nothing.
      */
     captureInitialState(): void;
 }
@@ -697,6 +851,7 @@ export interface SoundModule extends Initializable {
     stopAll(): Promise<void>;
     /**
      * Toggles the master mute setting.
+     * @returns {void} Returns nothing.
      */
     toggleMute(): void;
     /** Current master mute state. */
@@ -712,10 +867,12 @@ export interface TimePerformanceMonitor {
      * Updates performance calculations.
      *
      * @param {number} deltaTime - Time elapsed since last frame.
+     * @returns {void} Returns nothing.
      */
     update(deltaTime: number): void;
     /**
      * Records a logic tick occurrence for TPS calculation.
+     * @returns {void} Returns nothing.
      */
     logTick(): void;
     /**
@@ -723,6 +880,7 @@ export interface TimePerformanceMonitor {
      *
      * @param {p5} p - The P5 instance to draw on.
      * @param {number} tickInterval - The expected tick interval.
+     * @returns {void} Returns nothing.
      */
     render(p: p5, tickInterval: number): void;
 }
@@ -738,10 +896,12 @@ export interface Score {
      * Adds points to the score, applying the current multiplier.
      *
      * @param {number} amount - Base points to add.
+     * @returns {void} Returns nothing.
      */
     increaseScore(amount: number): void;
     /**
      * Resets the score to zero.
+     * @returns {void} Returns nothing.
      */
     resetScore(): void;
     /**
@@ -761,16 +921,19 @@ export interface Score {
      * Increases the difficulty level.
      *
      * @param {number} amount - Levels to advance.
+     * @returns {void} Returns nothing.
      */
     increaseLevel(amount: number): void;
     /**
      * Resets the level to the starting value (1).
+     * @returns {void} Returns nothing.
      */
     resetLevel(): void;
     /**
      * Sets up the game high score.
      *
      * @param {string} id - The game ID.
+     * @returns {void} Returns nothing.
      */
     setupGameHighScore(id: string): void;
 }
@@ -780,19 +943,23 @@ export interface Session extends StateSyncable, Debuggable {
      * Registers a serializable object to be saved in the session.
      *
      * @param {Serializable} serializable - The object to register.
+     * @returns {void} Returns nothing.
      */
     register(serializable: Serializable): void;
     /**
      * Creates or updates the current session.
+     * @returns {void} Returns nothing.
      */
     saveSession(): void;
     /**
      * Clears the current session.
+     * @returns {void} Returns nothing.
      */
     clearSession(): void;
     /**
      * Sets whether the session is enabled.
      * @param {boolean} enabled - Whether the session should be enabled.
+     * @returns {void} Returns nothing.
      */
     setSessionEnabled(enabled: boolean): void;
     /**
@@ -805,11 +972,13 @@ export interface Session extends StateSyncable, Debuggable {
     /**
      * Sets the function to be called when the session modal should be shown.
      * @param {function} showModal - The function to be called.
+     * @returns {void} Returns nothing.
      */
     setShowModalFunction(showModal: (onConfirm: () => void, onCancel: () => void) => void): void;
     /**
      * Sets the function to be called when the session is canceled/cleared to reset the game.
      * @param {function} resetFn - The function to be called.
+     * @returns {void} Returns nothing.
      */
     setResetFunction(resetFn: () => void): void;
 }