brick-engine-js 1.0.1 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (225) hide show
  1. package/dist/docs/GAME_DEVELOPER_GUIDE.html +1 -1
  2. package/dist/docs/brick-engine-guide.html +1 -1
  3. package/dist/docs/getting-started.html +1 -1
  4. package/dist/docs/jsdoc_standard.html +1 -1
  5. package/dist/docs/publishing.html +1 -1
  6. package/dist/docs/reference/interfaces/modules/Session.html +1 -1
  7. package/dist/docs/reference/modules/GameMenu.html +1 -1
  8. package/dist/docs/reference/modules/GameSession.html +1 -1
  9. package/dist/docs/reference/modules/InitialStateSnapshot.html +1 -1
  10. package/dist/docs/reference/modules/SessionModal.html +1 -1
  11. package/dist/docs/testing_best_practices.html +1 -1
  12. package/package.json +7 -1
  13. package/.env.local.example +0 -2
  14. package/.github/workflows/publish.yml +0 -73
  15. package/.prettierignore +0 -2
  16. package/.prettierrc.json +0 -8
  17. package/eslint.config.mjs +0 -29
  18. package/public/CNAME +0 -1
  19. package/public/docs/GAME_DEVELOPER_GUIDE.html +0 -727
  20. package/public/docs/brick-engine-guide.html +0 -610
  21. package/public/docs/diagrams/lifecycle.mmd +0 -19
  22. package/public/docs/documentation_style_guide.html +0 -994
  23. package/public/docs/getting-started.html +0 -648
  24. package/public/docs/images/lifecycle.svg +0 -1
  25. package/public/docs/index.html +0 -593
  26. package/public/docs/jsdoc_standard.html +0 -656
  27. package/public/docs/publishing.html +0 -573
  28. package/public/docs/reference/enums/Color.html +0 -533
  29. package/public/docs/reference/enums/ControlEventType.html +0 -505
  30. package/public/docs/reference/enums/ControlKey.html +0 -529
  31. package/public/docs/reference/enums/FontAlignment.html +0 -545
  32. package/public/docs/reference/enums/FontSize.html +0 -517
  33. package/public/docs/reference/enums/Sound.html +0 -558
  34. package/public/docs/reference/enums/StateProperty.html +0 -525
  35. package/public/docs/reference/helpers/CellHelper.html +0 -520
  36. package/public/docs/reference/helpers/ControlInputHandlerHelper.html +0 -569
  37. package/public/docs/reference/helpers/CoordinateHelper.html +0 -703
  38. package/public/docs/reference/helpers/RelativeValuesHelper.html +0 -560
  39. package/public/docs/reference/interfaces/Debuggable.html +0 -501
  40. package/public/docs/reference/interfaces/GameModules.html +0 -544
  41. package/public/docs/reference/interfaces/Initializable.html +0 -495
  42. package/public/docs/reference/interfaces/RendererInitializable.html +0 -517
  43. package/public/docs/reference/interfaces/StateSyncable.html +0 -542
  44. package/public/docs/reference/interfaces/modules/Control.html +0 -648
  45. package/public/docs/reference/interfaces/modules/Grid.html +0 -1256
  46. package/public/docs/reference/interfaces/modules/Renderer.html +0 -522
  47. package/public/docs/reference/interfaces/modules/RendererComposite.html +0 -577
  48. package/public/docs/reference/interfaces/modules/Score.html +0 -669
  49. package/public/docs/reference/interfaces/modules/Session.html +0 -585
  50. package/public/docs/reference/interfaces/modules/State.html +0 -897
  51. package/public/docs/reference/interfaces/modules/Text.html +0 -668
  52. package/public/docs/reference/interfaces/modules/Time.html +0 -684
  53. package/public/docs/reference/modules/Debugger.html +0 -579
  54. package/public/docs/reference/modules/DisplayRenderer.html +0 -557
  55. package/public/docs/reference/modules/Game.html +0 -909
  56. package/public/docs/reference/modules/GameControl.html +0 -716
  57. package/public/docs/reference/modules/GameGrid.html +0 -1910
  58. package/public/docs/reference/modules/GameHudGrid.html +0 -508
  59. package/public/docs/reference/modules/GameMenu.html +0 -538
  60. package/public/docs/reference/modules/GameRenderer.html +0 -589
  61. package/public/docs/reference/modules/GameScore.html +0 -664
  62. package/public/docs/reference/modules/GameSession.html +0 -533
  63. package/public/docs/reference/modules/GameSound.html +0 -636
  64. package/public/docs/reference/modules/GameState.html +0 -922
  65. package/public/docs/reference/modules/GameText.html +0 -701
  66. package/public/docs/reference/modules/GameTime.html +0 -696
  67. package/public/docs/reference/modules/HudRenderer.html +0 -568
  68. package/public/docs/reference/modules/InitialStateSnapshot.html +0 -557
  69. package/public/docs/reference/modules/SessionModal.html +0 -520
  70. package/public/docs/reference/types/Axis.html +0 -505
  71. package/public/docs/reference/types/Cell.html +0 -514
  72. package/public/docs/reference/types/ControlCallback.html +0 -488
  73. package/public/docs/reference/types/Coordinate.html +0 -510
  74. package/public/docs/reference/types/GameEntry.html +0 -514
  75. package/public/docs/reference/types/GameEvent.html +0 -514
  76. package/public/docs/reference/types/Piece.html +0 -506
  77. package/public/docs/reference/types/RendererMetrics.html +0 -514
  78. package/public/docs/reference/types/Vector.html +0 -509
  79. package/public/docs/testing_best_practices.html +0 -770
  80. package/public/favicon.ico +0 -0
  81. package/public/fonts/digital-7.monoitalic.ttf +0 -0
  82. package/public/images/cell.svg +0 -32
  83. package/public/images/close.png +0 -0
  84. package/public/images/games.png +0 -0
  85. package/public/images/github.png +0 -0
  86. package/public/images/letter-a.png +0 -0
  87. package/public/images/letter-d.png +0 -0
  88. package/public/images/letter-j.png +0 -0
  89. package/public/images/letter-s.png +0 -0
  90. package/public/images/letter-w.png +0 -0
  91. package/public/images/meta-image.png +0 -0
  92. package/public/images/number-1.png +0 -0
  93. package/public/images/number-2.png +0 -0
  94. package/public/images/number-3.png +0 -0
  95. package/public/images/number-4.png +0 -0
  96. package/public/images/number-5.png +0 -0
  97. package/public/images/number-6.png +0 -0
  98. package/public/images/splash.gif +0 -0
  99. package/public/index.html +0 -15
  100. package/public/sounds/sound_00.wav +0 -0
  101. package/public/sounds/sound_01.wav +0 -0
  102. package/public/sounds/sound_02.wav +0 -0
  103. package/public/sounds/sound_03.wav +0 -0
  104. package/public/sounds/sound_04.wav +0 -0
  105. package/public/sounds/sound_05.wav +0 -0
  106. package/public/sounds/sound_06.wav +0 -0
  107. package/public/sounds/sound_07.wav +0 -0
  108. package/public/sounds/sound_08.wav +0 -0
  109. package/public/sounds/sound_09.wav +0 -0
  110. package/public/sounds/sound_10.wav +0 -0
  111. package/public/sounds/sound_11.wav +0 -0
  112. package/public/sounds/sound_12.wav +0 -0
  113. package/public/sounds/sound_13.wav +0 -0
  114. package/public/sounds/sound_14.wav +0 -0
  115. package/public/sounds/sound_15.wav +0 -0
  116. package/public/style/body.css +0 -86
  117. package/public/style/buttons.css +0 -233
  118. package/public/style/debugger.css +0 -117
  119. package/public/style/sessionModal.css +0 -155
  120. package/public/style/sourceCodeAndCommands.css +0 -74
  121. package/public/style/splash.css +0 -13
  122. package/public/style/theme.css +0 -137
  123. package/scripts/generate-diagrams.sh +0 -20
  124. package/scripts/generate-docs.js +0 -111
  125. package/src/client-game.d.ts +0 -1
  126. package/src/config/configs.test.ts +0 -20
  127. package/src/config/configs.ts +0 -197
  128. package/src/config/env.test.ts +0 -59
  129. package/src/config/env.ts +0 -7
  130. package/src/config/styles.ts +0 -5
  131. package/src/core/Game.test.ts +0 -167
  132. package/src/core/Game.ts +0 -307
  133. package/src/core/InitialStateSnapshot.test.ts +0 -51
  134. package/src/core/InitialStateSnapshot.ts +0 -46
  135. package/src/core/helpers/CellHelper.test.ts +0 -33
  136. package/src/core/helpers/CellHelper.ts +0 -21
  137. package/src/core/helpers/ControlInputHandlerHelper.test.ts +0 -116
  138. package/src/core/helpers/ControlInputHandlerHelper.ts +0 -68
  139. package/src/core/helpers/CoordinateHelper.test.ts +0 -113
  140. package/src/core/helpers/CoordinateHelper.ts +0 -82
  141. package/src/core/helpers/InterfaceIdentifierHelper.test.ts +0 -122
  142. package/src/core/helpers/InterfaceIdentifierHelper.ts +0 -43
  143. package/src/core/helpers/RelativeValuesHelper.test.ts +0 -47
  144. package/src/core/helpers/RelativeValuesHelper.ts +0 -29
  145. package/src/core/module/control/GameControl.test.ts +0 -82
  146. package/src/core/module/control/GameControl.ts +0 -142
  147. package/src/core/module/control/GameControlKeyBinding.test.ts +0 -59
  148. package/src/core/module/control/GameControlKeyBinding.ts +0 -92
  149. package/src/core/module/grid/GameGrid.test.ts +0 -83
  150. package/src/core/module/grid/GameGrid.ts +0 -610
  151. package/src/core/module/grid/GameHudGrid.test.ts +0 -22
  152. package/src/core/module/grid/GameHudGrid.ts +0 -40
  153. package/src/core/module/grid/engines/GridAnalysisEngine.test.ts +0 -157
  154. package/src/core/module/grid/engines/GridAnalysisEngine.ts +0 -124
  155. package/src/core/module/grid/engines/GridLineEngine.test.ts +0 -132
  156. package/src/core/module/grid/engines/GridLineEngine.ts +0 -165
  157. package/src/core/module/grid/engines/GridMovementEngine.test.ts +0 -125
  158. package/src/core/module/grid/engines/GridMovementEngine.ts +0 -113
  159. package/src/core/module/grid/engines/GridRegionEngine.test.ts +0 -136
  160. package/src/core/module/grid/engines/GridRegionEngine.ts +0 -52
  161. package/src/core/module/grid/engines/GridTransformEngine.test.ts +0 -98
  162. package/src/core/module/grid/engines/GridTransformEngine.ts +0 -70
  163. package/src/core/module/renderer/DisplayRenderer.test.ts +0 -86
  164. package/src/core/module/renderer/DisplayRenderer.ts +0 -152
  165. package/src/core/module/renderer/GameRenderer.test.ts +0 -103
  166. package/src/core/module/renderer/GameRenderer.ts +0 -144
  167. package/src/core/module/renderer/HudRenderer.test.ts +0 -108
  168. package/src/core/module/renderer/HudRenderer.ts +0 -203
  169. package/src/core/module/score/GameScore.test.ts +0 -71
  170. package/src/core/module/score/GameScore.ts +0 -188
  171. package/src/core/module/session/GameSession.test.ts +0 -176
  172. package/src/core/module/session/GameSession.ts +0 -103
  173. package/src/core/module/sound/GameSound.test.ts +0 -117
  174. package/src/core/module/sound/GameSound.ts +0 -229
  175. package/src/core/module/state/GameState.test.ts +0 -101
  176. package/src/core/module/state/GameState.ts +0 -339
  177. package/src/core/module/text/GameText.test.ts +0 -87
  178. package/src/core/module/text/GameText.ts +0 -150
  179. package/src/core/module/time/GameTime.test.ts +0 -86
  180. package/src/core/module/time/GameTime.ts +0 -144
  181. package/src/core/types/Interfaces.ts +0 -59
  182. package/src/core/types/Types.ts +0 -124
  183. package/src/core/types/enums.ts +0 -113
  184. package/src/core/types/modules.ts +0 -841
  185. package/src/index.test.ts +0 -15
  186. package/src/index.ts +0 -9
  187. package/src/main.test.ts +0 -137
  188. package/src/main.ts +0 -77
  189. package/src/menu/GameMenu.test.ts +0 -157
  190. package/src/menu/GameMenu.ts +0 -124
  191. package/src/menu/GameMenuSingleton.test.ts +0 -26
  192. package/src/menu/GameMenuSingleton.ts +0 -13
  193. package/src/menu/GameRepository.test.ts +0 -46
  194. package/src/menu/GameRepository.ts +0 -47
  195. package/src/menu/manager/GameManager.test.ts +0 -68
  196. package/src/menu/manager/GameManager.ts +0 -50
  197. package/src/types/global.d.ts +0 -8
  198. package/src/types/interfaces.ts +0 -5
  199. package/src/view/Debugger.test.ts +0 -152
  200. package/src/view/Debugger.ts +0 -124
  201. package/src/view/GameView.test.ts +0 -95
  202. package/src/view/GameView.ts +0 -244
  203. package/src/view/SessionModal.test.ts +0 -141
  204. package/src/view/SessionModal.ts +0 -73
  205. package/src/view/components/layout/ButtonLayout.test.ts +0 -28
  206. package/src/view/components/layout/ButtonLayout.ts +0 -63
  207. package/src/view/components/layout/ContainerLayout.test.ts +0 -48
  208. package/src/view/components/layout/ContainerLayout.ts +0 -50
  209. package/src/view/components/layout/FrameLayout.test.ts +0 -24
  210. package/src/view/components/layout/FrameLayout.ts +0 -25
  211. package/src/view/components/ui/BigButton.test.ts +0 -28
  212. package/src/view/components/ui/BigButton.ts +0 -31
  213. package/src/view/components/ui/Button.test.ts +0 -30
  214. package/src/view/components/ui/Button.ts +0 -30
  215. package/src/view/components/ui/Canvas.test.ts +0 -32
  216. package/src/view/components/ui/Canvas.ts +0 -34
  217. package/src/view/components/ui/SmallButton.test.ts +0 -48
  218. package/src/view/components/ui/SmallButton.ts +0 -32
  219. package/src/view/theme/applyColors.test.ts +0 -47
  220. package/src/view/theme/applyColors.ts +0 -38
  221. package/src/view/theme/dimensions.test.ts +0 -34
  222. package/src/view/theme/dimensions.ts +0 -53
  223. package/tsconfig.json +0 -16
  224. package/vitest.config.ts +0 -14
  225. package/webpack.config.js +0 -133
@@ -1,157 +0,0 @@
1
- import { describe, it, expect, vi, beforeEach } from 'vitest';
2
- import GridAnalysisEngine from './GridAnalysisEngine';
3
- import { Grid } from '../../../types/modules';
4
- import { Color } from '../../../types/enums';
5
-
6
- describe('GridAnalysisEngine', () => {
7
- let engine: GridAnalysisEngine;
8
- let mockGrid: Grid;
9
-
10
- beforeEach(() => {
11
- // [ARRANGE] Mock Grid facade
12
- mockGrid = {
13
- width: 10,
14
- height: 20,
15
- isValidCoordinate: vi.fn(),
16
- isCellActive: vi.fn(),
17
- getCell: vi.fn(),
18
- stampCell: vi.fn(),
19
- } as unknown as Grid;
20
- engine = new GridAnalysisEngine(mockGrid);
21
- });
22
-
23
- describe('getFullRows', () => {
24
- it('should return indices of rows where all cells are active', () => {
25
- // [ARRANGE] Row 2 is full, others are not
26
- vi.mocked(mockGrid.isCellActive).mockImplementation(({ y }) => y === 2);
27
-
28
- // [ACT]
29
- const result = engine.getFullRows();
30
-
31
- // [ASSERT]
32
- expect(result).toEqual([2]);
33
- });
34
-
35
- it('should return an empty array if no rows are full', () => {
36
- // [ARRANGE]
37
- vi.mocked(mockGrid.isCellActive).mockReturnValue(false);
38
-
39
- // [ACT]
40
- const result = engine.getFullRows();
41
-
42
- // [ASSERT]
43
- expect(result).toEqual([]);
44
- });
45
- });
46
-
47
- describe('getFullColumns', () => {
48
- it('should return indices of columns where all cells are active', () => {
49
- // [ARRANGE] Column 5 is full
50
- vi.mocked(mockGrid.isCellActive).mockImplementation(({ x }) => x === 5);
51
-
52
- // [ACT]
53
- const result = engine.getFullColumns();
54
-
55
- // [ASSERT]
56
- expect(result).toEqual([5]);
57
- });
58
- });
59
-
60
- describe('getNeighbors', () => {
61
- it('should return only orthogonally adjacent cells by default', () => {
62
- // [ARRANGE]
63
- const coord = { x: 5, y: 5 };
64
- vi.mocked(mockGrid.isValidCoordinate).mockReturnValue(true);
65
- vi.mocked(mockGrid.getCell).mockImplementation(c => ({ coordinate: c, value: 1, color: Color.DEFAULT }));
66
-
67
- // [ACT]
68
- const result = engine.getNeighbors(coord);
69
-
70
- // [ASSERT]
71
- expect(result).toHaveLength(4);
72
- expect(result.map(c => c.coordinate)).toContainEqual({ x: 4, y: 5 });
73
- expect(result.map(c => c.coordinate)).toContainEqual({ x: 6, y: 5 });
74
- expect(result.map(c => c.coordinate)).toContainEqual({ x: 5, y: 4 });
75
- expect(result.map(c => c.coordinate)).toContainEqual({ x: 5, y: 6 });
76
- });
77
-
78
- it('should return 8 neighbors if includeDiagonal is true', () => {
79
- // [ARRANGE]
80
- const coord = { x: 5, y: 5 };
81
- vi.mocked(mockGrid.isValidCoordinate).mockReturnValue(true);
82
- vi.mocked(mockGrid.getCell).mockImplementation(c => ({ coordinate: c, value: 1, color: Color.DEFAULT }));
83
-
84
- // [ACT]
85
- const result = engine.getNeighbors(coord, true);
86
-
87
- // [ASSERT]
88
- expect(result).toHaveLength(8);
89
- expect(result.map(c => c.coordinate)).toContainEqual({ x: 4, y: 4 });
90
- });
91
-
92
- it('should skip invalid coordinates (e.g., edges)', () => {
93
- // [ARRANGE] Center at (0,0)
94
- const coord = { x: 0, y: 0 };
95
- vi.mocked(mockGrid.isValidCoordinate).mockImplementation(c => c.x >= 0 && c.y >= 0);
96
- vi.mocked(mockGrid.getCell).mockImplementation(c => ({ coordinate: c, value: 1, color: Color.DEFAULT }));
97
-
98
- // [ACT]
99
- const result = engine.getNeighbors(coord);
100
-
101
- // [ASSERT]
102
- // Only (1,0) and (0,1) are valid
103
- expect(result).toHaveLength(2);
104
- });
105
- });
106
-
107
- describe('findConnectedCells', () => {
108
- it('should return an empty array if starting cell is inactive', () => {
109
- // [ARRANGE]
110
- vi.mocked(mockGrid.isCellActive).mockReturnValue(false);
111
-
112
- // [ACT]
113
- const result = engine.findConnectedCells({ x: 5, y: 5 });
114
-
115
- // [ASSERT]
116
- expect(result).toEqual([]);
117
- });
118
-
119
- it('should find all connected cells with the same value using BFS', () => {
120
- // [ARRANGE] Simple 2x1 block
121
- const start = { x: 5, y: 5 };
122
- const neighbor = { x: 6, y: 5 };
123
-
124
- vi.mocked(mockGrid.isCellActive).mockImplementation(c => (c.x === 5 && c.y === 5) || (c.x === 6 && c.y === 5));
125
- vi.mocked(mockGrid.isValidCoordinate).mockReturnValue(true);
126
- vi.mocked(mockGrid.getCell).mockImplementation(c => ({ coordinate: c, value: 1, color: Color.RED }));
127
-
128
- // [ACT]
129
- const result = engine.findConnectedCells(start);
130
-
131
- // [ASSERT]
132
- expect(result).toHaveLength(2);
133
- expect(result.map(c => c.coordinate)).toContainEqual(start);
134
- expect(result.map(c => c.coordinate)).toContainEqual(neighbor);
135
- });
136
- });
137
-
138
- describe('swapCells', () => {
139
- it('should swap attributes of two cells using stampCell', () => {
140
- // [ARRANGE]
141
- const a = { x: 1, y: 1 };
142
- const b = { x: 2, y: 2 };
143
- const cellA = { coordinate: a, value: 1, color: Color.RED };
144
- const cellB = { coordinate: b, value: 2, color: Color.BLUE };
145
-
146
- vi.mocked(mockGrid.getCell).mockImplementation(c => (c.x === 1 ? cellA : cellB));
147
-
148
- // [ACT]
149
- engine.swapCells(a, b);
150
-
151
- // [ASSERT]
152
- // Stamp cellB at a, and cellA at b
153
- expect(mockGrid.stampCell).toHaveBeenCalledWith({ ...cellB, coordinate: a });
154
- expect(mockGrid.stampCell).toHaveBeenCalledWith({ ...cellA, coordinate: b });
155
- });
156
- });
157
- });
@@ -1,124 +0,0 @@
1
- import { Cell, Coordinate, Piece } from '../../../types/Types';
2
- import { Grid } from '../../../types/modules';
3
-
4
- /**
5
- * Handles analysis and search operations on the grid.
6
- */
7
- export default class GridAnalysisEngine {
8
- constructor(private grid: Grid) {}
9
-
10
- /**
11
- * Identifies all rows that are completely filled with active cells.
12
- */
13
- getFullRows(): number[] {
14
- const fullRows: number[] = [];
15
- for (let y = 0; y < this.grid.height; y++) {
16
- let isFull = true;
17
- for (let x = 0; x < this.grid.width; x++) {
18
- if (!this.grid.isCellActive({ x, y })) {
19
- isFull = false;
20
- break;
21
- }
22
- }
23
- if (isFull) fullRows.push(y);
24
- }
25
- return fullRows;
26
- }
27
-
28
- /**
29
- * Identifies all columns that are completely filled with active cells.
30
- */
31
- getFullColumns(): number[] {
32
- const fullColumns: number[] = [];
33
- for (let x = 0; x < this.grid.width; x++) {
34
- let isFull = true;
35
- for (let y = 0; y < this.grid.height; y++) {
36
- if (!this.grid.isCellActive({ x, y })) {
37
- isFull = false;
38
- break;
39
- }
40
- }
41
- if (isFull) fullColumns.push(x);
42
- }
43
- return fullColumns;
44
- }
45
-
46
- /**
47
- * Returns the active cells adjacent to a specific coordinate.
48
- */
49
- getNeighbors(coord: Coordinate, includeDiagonal: boolean = false): Cell[] {
50
- const neighbors: Cell[] = [];
51
- const offsets = [
52
- { x: -1, y: 0 },
53
- { x: 1, y: 0 },
54
- { x: 0, y: -1 },
55
- { x: 0, y: 1 },
56
- ];
57
-
58
- if (includeDiagonal) {
59
- offsets.push({ x: -1, y: -1 }, { x: 1, y: -1 }, { x: -1, y: 1 }, { x: 1, y: 1 });
60
- }
61
-
62
- offsets.forEach(offset => {
63
- const neighborCoord = { x: coord.x + offset.x, y: coord.y + offset.y };
64
- if (this.grid.isValidCoordinate(neighborCoord)) {
65
- neighbors.push(this.grid.getCell(neighborCoord));
66
- }
67
- });
68
-
69
- return neighbors;
70
- }
71
-
72
- /**
73
- * Finds all connected active cells of the same value starting from a specific coordinate.
74
- */
75
- findConnectedCells(coord: Coordinate): Piece {
76
- if (!this.grid.isCellActive(coord)) return [];
77
-
78
- const startCell = this.grid.getCell(coord);
79
- const targetValue = startCell.value;
80
- const connected: Piece = [];
81
- const visited = new Set<string>();
82
- const queue: Coordinate[] = [coord];
83
-
84
- const getCoordKey = (c: Coordinate) => `${c.x},${c.y}`;
85
- visited.add(getCoordKey(coord));
86
-
87
- while (queue.length > 0) {
88
- const current = queue.shift()!;
89
- const cell = this.grid.getCell(current);
90
-
91
- if (cell.value === targetValue) {
92
- connected.push(cell);
93
-
94
- const neighbors = [
95
- { x: current.x - 1, y: current.y },
96
- { x: current.x + 1, y: current.y },
97
- { x: current.x, y: current.y - 1 },
98
- { x: current.x, y: current.y + 1 },
99
- ];
100
-
101
- neighbors.forEach(n => {
102
- const key = getCoordKey(n);
103
- if (this.grid.isValidCoordinate(n) && !visited.has(key) && this.grid.isCellActive(n)) {
104
- visited.add(key);
105
- queue.push(n);
106
- }
107
- });
108
- }
109
- }
110
-
111
- return connected;
112
- }
113
-
114
- /**
115
- * Swaps the values and colors of two cells.
116
- */
117
- swapCells(a: Coordinate, b: Coordinate): void {
118
- const cellA = { ...this.grid.getCell(a) };
119
- const cellB = { ...this.grid.getCell(b) };
120
-
121
- this.grid.stampCell({ ...cellB, coordinate: a });
122
- this.grid.stampCell({ ...cellA, coordinate: b });
123
- }
124
- }
@@ -1,132 +0,0 @@
1
- import { describe, it, expect, beforeEach } from 'vitest';
2
- import GridLineEngine from './GridLineEngine';
3
- import { Grid } from '../../../types/modules';
4
- import { Color } from '../../../types/enums';
5
- import { Cell } from '../../../types/Types';
6
-
7
- describe('GridLineEngine', () => {
8
- let engine: GridLineEngine;
9
- let mockGrid: Grid;
10
- let gridData: Cell[][];
11
-
12
- const createSmallGrid = (w: number, h: number) => {
13
- const data: Cell[][] = [];
14
- for (let y = 0; y < h; y++) {
15
- data[y] = [];
16
- for (let x = 0; x < w; x++) {
17
- data[y][x] = { coordinate: { x, y }, value: 0, color: Color.DEFAULT };
18
- }
19
- }
20
- return data;
21
- };
22
-
23
- beforeEach(() => {
24
- gridData = createSmallGrid(3, 3);
25
- mockGrid = {
26
- width: 3,
27
- height: 3,
28
- getGrid: () => gridData,
29
- } as unknown as Grid;
30
- engine = new GridLineEngine(mockGrid);
31
- });
32
-
33
- describe('isRowFull', () => {
34
- it('should return true if all cells in a row have value > 0', () => {
35
- // [ARRANGE]
36
- gridData[1].forEach(c => (c.value = 1));
37
-
38
- // [ACT]
39
- const result = engine.isRowFull(1);
40
-
41
- // [ASSERT]
42
- expect(result).toBe(true);
43
- });
44
-
45
- it('should return false if any cell in a row has value 0', () => {
46
- // [ARRANGE]
47
- gridData[1][0].value = 1;
48
- gridData[1][1].value = 0; // one empty
49
-
50
- // [ACT]
51
- const result = engine.isRowFull(1);
52
-
53
- // [ASSERT]
54
- expect(result).toBe(false);
55
- });
56
- });
57
-
58
- describe('clearRow', () => {
59
- it('should reset all cells in a row to value 0', () => {
60
- // [ARRANGE]
61
- gridData[1].forEach(c => (c.value = 5));
62
-
63
- // [ACT]
64
- engine.clearRow(1);
65
-
66
- // [ASSERT]
67
- expect(gridData[1].every(c => c.value === 0)).toBe(true);
68
- });
69
- });
70
-
71
- describe('shiftRowsDown', () => {
72
- it('should copy values from row above and clear top row', () => {
73
- // [ARRANGE]
74
- gridData[0][0].value = 9; // top row
75
- gridData[1][0].value = 0; // target row
76
-
77
- // [ACT]
78
- engine.shiftRowsDown(1);
79
-
80
- // [ASSERT]
81
- expect(gridData[1][0].value).toBe(9);
82
- expect(gridData[0][0].value).toBe(0); // top row cleared
83
- });
84
- });
85
-
86
- describe('clearFullRows', () => {
87
- it('should detect, clear, and shift rows, returning count', () => {
88
- // [ARRANGE]
89
- // Row 2 is full
90
- gridData[2].forEach(c => (c.value = 1));
91
- // Row 1 has a pattern
92
- gridData[1][0].value = 7;
93
-
94
- // [ACT]
95
- const cleared = engine.clearFullRows();
96
-
97
- // [ASSERT]
98
- expect(cleared).toBe(1);
99
- expect(gridData[2][0].value).toBe(7); // row 1 shifted to row 2
100
- expect(gridData[1][0].value).toBe(0); // top row (originally 0 or 1) cleared
101
- });
102
- });
103
-
104
- describe('isColumnFull', () => {
105
- it('should return true if all cells in a column have value > 0', () => {
106
- // [ARRANGE]
107
- gridData[0][0].value = 1;
108
- gridData[1][0].value = 1;
109
- gridData[2][0].value = 1;
110
-
111
- // [ACT]
112
- const result = engine.isColumnFull(0);
113
-
114
- // [ASSERT]
115
- expect(result).toBe(true);
116
- });
117
- });
118
-
119
- describe('shiftColumnsRight', () => {
120
- it('should copy values from left and clear first column', () => {
121
- // [ARRANGE]
122
- gridData[0][0].value = 8;
123
-
124
- // [ACT]
125
- engine.shiftColumnsRight(1);
126
-
127
- // [ASSERT]
128
- expect(gridData[0][1].value).toBe(8);
129
- expect(gridData[0][0].value).toBe(0);
130
- });
131
- });
132
- });
@@ -1,165 +0,0 @@
1
- import { Grid } from '../../../types/modules';
2
- import CellHelper from '../../../helpers/CellHelper';
3
-
4
- /**
5
- * Handles line-based operations (rows and columns) on the grid.
6
- */
7
- export default class GridLineEngine {
8
- constructor(private grid: Grid) {}
9
-
10
- /**
11
- * Checks if every cell in a specific row is active.
12
- */
13
- isRowFull(y: number): boolean {
14
- const gridData = this.grid.getGrid();
15
- if (y < 0 || y >= this.grid.height) return false;
16
- return gridData[y].every(cell => cell.value > 0);
17
- }
18
-
19
- /**
20
- * Checks if every cell in a specific row is inactive.
21
- */
22
- isRowEmpty(y: number): boolean {
23
- const gridData = this.grid.getGrid();
24
- if (y < 0 || y >= this.grid.height) return true;
25
- return gridData[y].every(cell => cell.value === 0);
26
- }
27
-
28
- /**
29
- * Resets all cells in a specific row to their default empty state.
30
- */
31
- clearRow(y: number): void {
32
- const gridData = this.grid.getGrid();
33
- if (y < 0 || y >= this.grid.height) return;
34
- for (let x = 0; x < this.grid.width; x++) {
35
- gridData[y][x] = CellHelper.emptyCell({ x, y });
36
- }
37
- }
38
-
39
- /**
40
- * Shifts all rows above a certain index down by one position.
41
- */
42
- shiftRowsDown(fromY: number): void {
43
- const gridData = this.grid.getGrid();
44
- for (let y = fromY; y > 0; y--) {
45
- for (let x = 0; x < this.grid.width; x++) {
46
- const prevCell = gridData[y - 1][x];
47
- gridData[y][x].value = prevCell.value;
48
- gridData[y][x].color = prevCell.color;
49
- }
50
- }
51
- this.clearRow(0);
52
- }
53
-
54
- /**
55
- * Shifts all rows below a certain index up by one position.
56
- */
57
- shiftRowsUp(fromY: number): void {
58
- const gridData = this.grid.getGrid();
59
- for (let y = fromY; y < this.grid.height - 1; y++) {
60
- for (let x = 0; x < this.grid.width; x++) {
61
- const nextCell = gridData[y + 1][x];
62
- gridData[y][x].value = nextCell.value;
63
- gridData[y][x].color = nextCell.color;
64
- }
65
- }
66
- this.clearRow(this.grid.height - 1);
67
- }
68
-
69
- /**
70
- * Scans for full rows, clears them, and shifts remaining rows down.
71
- */
72
- clearFullRows(): number {
73
- let rowsCleared = 0;
74
- for (let y = this.grid.height - 1; y >= 0; y--) {
75
- if (this.isRowFull(y)) {
76
- this.clearRow(y);
77
- this.shiftRowsDown(y);
78
- rowsCleared++;
79
- y++; // Re-check the same row index after shifting
80
- }
81
- }
82
- return rowsCleared;
83
- }
84
-
85
- /**
86
- * Checks if every cell in a specific column is active.
87
- */
88
- isColumnFull(x: number): boolean {
89
- const gridData = this.grid.getGrid();
90
- if (x < 0 || x >= this.grid.width) return false;
91
- for (let y = 0; y < this.grid.height; y++) {
92
- if (gridData[y][x].value === 0) return false;
93
- }
94
- return true;
95
- }
96
-
97
- /**
98
- * Checks if every cell in a specific column is inactive.
99
- */
100
- isColumnEmpty(x: number): boolean {
101
- const gridData = this.grid.getGrid();
102
- if (x < 0 || x >= this.grid.width) return true;
103
- for (let y = 0; y < this.grid.height; y++) {
104
- if (gridData[y][x].value !== 0) return false;
105
- }
106
- return true;
107
- }
108
-
109
- /**
110
- * Resets all cells in a specific column to their default empty state.
111
- */
112
- clearColumn(x: number): void {
113
- const gridData = this.grid.getGrid();
114
- if (x < 0 || x >= this.grid.width) return;
115
- for (let y = 0; y < this.grid.height; y++) {
116
- gridData[y][x] = CellHelper.emptyCell({ x, y });
117
- }
118
- }
119
-
120
- /**
121
- * Shifts all columns to the left of a certain index one position to the right.
122
- */
123
- shiftColumnsRight(fromX: number): void {
124
- const gridData = this.grid.getGrid();
125
- for (let x = fromX; x > 0; x--) {
126
- for (let y = 0; y < this.grid.height; y++) {
127
- const prevCell = gridData[y][x - 1];
128
- gridData[y][x].value = prevCell.value;
129
- gridData[y][x].color = prevCell.color;
130
- }
131
- }
132
- this.clearColumn(0);
133
- }
134
-
135
- /**
136
- * Shifts all columns to the right of a certain index one position to the left.
137
- */
138
- shiftColumnsLeft(fromX: number): void {
139
- const gridData = this.grid.getGrid();
140
- for (let x = fromX; x < this.grid.width - 1; x++) {
141
- for (let y = 0; y < this.grid.height; y++) {
142
- const nextCell = gridData[y][x + 1];
143
- gridData[y][x].value = nextCell.value;
144
- gridData[y][x].color = nextCell.color;
145
- }
146
- }
147
- this.clearColumn(this.grid.width - 1);
148
- }
149
-
150
- /**
151
- * Scans for full columns, clears them, and shifts remaining columns right.
152
- */
153
- clearFullColumns(): number {
154
- let columnsCleared = 0;
155
- for (let x = this.grid.width - 1; x >= 0; x--) {
156
- if (this.isColumnFull(x)) {
157
- this.clearColumn(x);
158
- this.shiftColumnsRight(x);
159
- columnsCleared++;
160
- x++; // Re-check the same column index after shifting
161
- }
162
- }
163
- return columnsCleared;
164
- }
165
- }
@@ -1,125 +0,0 @@
1
- import { describe, it, expect, vi, beforeEach } from 'vitest';
2
- import GridMovementEngine from './GridMovementEngine';
3
- import { Grid } from '../../../types/modules';
4
- import { Color } from '../../../types/enums';
5
- import { Vector, Coordinate } from '../../../types/Types';
6
-
7
- describe('GridMovementEngine', () => {
8
- let engine: GridMovementEngine;
9
- let mockGrid: Grid;
10
-
11
- beforeEach(() => {
12
- // [ARRANGE] Mock Grid facade
13
- mockGrid = {
14
- isValidCoordinate: vi.fn(),
15
- isCellActive: vi.fn(),
16
- } as unknown as Grid;
17
- engine = new GridMovementEngine(mockGrid);
18
- });
19
-
20
- describe('movePiece', () => {
21
- it('should return a new piece shifted in the specified direction', () => {
22
- // [ARRANGE]
23
- const piece = [{ coordinate: { x: 5, y: 5 }, value: 1, color: Color.RED }];
24
- const direction: Vector = { x: 1, y: 0 };
25
- vi.mocked(mockGrid.isValidCoordinate).mockReturnValue(true);
26
- vi.mocked(mockGrid.isCellActive).mockReturnValue(false);
27
-
28
- // [ACT]
29
- const result = engine.movePiece(piece, direction);
30
-
31
- // [ASSERT]
32
- expect(result).not.toBeNull();
33
- expect(result![0].coordinate).toEqual({ x: 6, y: 5 });
34
- });
35
-
36
- it('should return null if the move is out of bounds', () => {
37
- // [ARRANGE]
38
- const piece = [{ coordinate: { x: 0, y: 0 }, value: 1, color: Color.RED }];
39
- vi.mocked(mockGrid.isValidCoordinate).mockReturnValue(false);
40
-
41
- // [ACT]
42
- const result = engine.movePieceLeft(piece);
43
-
44
- // [ASSERT]
45
- expect(result).toBeNull();
46
- });
47
-
48
- it('should return null if it collides with an active cell that is NOT part of self', () => {
49
- // [ARRANGE]
50
- const piece = [{ coordinate: { x: 5, y: 5 }, value: 1, color: Color.RED }];
51
- vi.mocked(mockGrid.isValidCoordinate).mockReturnValue(true);
52
- vi.mocked(mockGrid.isCellActive).mockReturnValue(true); // Obstacle at (6,5)
53
-
54
- // [ACT]
55
- const result = engine.movePieceRight(piece);
56
-
57
- // [ASSERT]
58
- expect(result).toBeNull();
59
- });
60
-
61
- it('should NOT return null if it collides with its own current position (diagonal or overlapping)', () => {
62
- // [ARRANGE] Piece with 2 cells
63
- const piece = [
64
- { coordinate: { x: 5, y: 5 }, value: 1, color: Color.RED },
65
- { coordinate: { x: 6, y: 5 }, value: 1, color: Color.RED },
66
- ];
67
- vi.mocked(mockGrid.isValidCoordinate).mockReturnValue(true);
68
-
69
- // isCellActive is true for (5,5) and (6,5)
70
- vi.mocked(mockGrid.isCellActive).mockImplementation((c: Coordinate) => c.x === 5 || c.x === 6);
71
-
72
- // [ACT] Move right: (5,5)->(6,5) and (6,5)->(7,5)
73
- // (6,5) is active, but it matches the original piece's second cell
74
- const result = engine.movePieceRight(piece);
75
-
76
- // [ASSERT]
77
- expect(result).not.toBeNull();
78
- expect(result![0].coordinate).toEqual({ x: 6, y: 5 });
79
- expect(result![1].coordinate).toEqual({ x: 7, y: 5 });
80
- });
81
- });
82
-
83
- describe('getDropPath', () => {
84
- it('should return the furthest possible position downwards', () => {
85
- // [ARRANGE]
86
- const piece = [{ coordinate: { x: 5, y: 0 }, value: 1, color: Color.RED }];
87
- vi.mocked(mockGrid.isValidCoordinate).mockImplementation((c: Coordinate) => c.y >= 0 && c.y <= 10);
88
- vi.mocked(mockGrid.isCellActive).mockReturnValue(false);
89
-
90
- // [ACT]
91
- const result = engine.getDropPath(piece);
92
-
93
- // [ASSERT]
94
- expect(result[0].coordinate.y).toBe(10);
95
- });
96
- });
97
-
98
- describe('moveCell', () => {
99
- it('should move a single cell if path is clear', () => {
100
- // [ARRANGE]
101
- const cell = { coordinate: { x: 1, y: 1 }, value: 1, color: Color.RED };
102
- vi.mocked(mockGrid.isValidCoordinate).mockReturnValue(true);
103
- vi.mocked(mockGrid.isCellActive).mockReturnValue(false);
104
-
105
- // [ACT]
106
- const result = engine.moveCellDown(cell);
107
-
108
- // [ASSERT]
109
- expect(result?.coordinate).toEqual({ x: 1, y: 2 });
110
- });
111
-
112
- it('should return null if single cell path is blocked', () => {
113
- // [ARRANGE]
114
- const cell = { coordinate: { x: 1, y: 1 }, value: 1, color: Color.RED };
115
- vi.mocked(mockGrid.isValidCoordinate).mockReturnValue(true);
116
- vi.mocked(mockGrid.isCellActive).mockReturnValue(true);
117
-
118
- // [ACT]
119
- const result = engine.moveCellDown(cell);
120
-
121
- // [ASSERT]
122
- expect(result).toBeNull();
123
- });
124
- });
125
- });