arek
7874a5f7c6
Add configurable key bindings (TOML), modifier-aware dispatch, mouse-driven pattern placement with preview and rotation, cell grid storage/rendering, and fractional/integer HiDPI scaling. Archive the input-and-placement change and sync its specs to main specs. Tests: Hashtable, Config, Grid, Pattern (4/4 pass).
62 lines
2.2 KiB
Markdown
62 lines
2.2 KiB
Markdown
# cell-grid Specification
|
|
|
|
## Purpose
|
|
Stores and renders the Game of Life cell grid with a fixed cell size and wall boundaries, independent of future simulation rules.
|
|
|
|
## Requirements
|
|
|
|
### Requirement: Grid stores alive and dead cells
|
|
The system SHALL maintain a grid of cells, each either alive or dead, addressable by column and row.
|
|
|
|
#### Scenario: Cell access
|
|
- **WHEN** a cell is set to alive
|
|
- **THEN** reading that cell returns alive
|
|
- **AND** cells never set remain dead
|
|
|
|
### Requirement: Boundary cells are treated as dead
|
|
The system SHALL treat any cell outside the grid bounds as dead and shall not store state outside the grid.
|
|
|
|
#### Scenario: Out of bounds read
|
|
- **WHEN** a cell position outside the grid is queried
|
|
- **THEN** the result is dead
|
|
|
|
### Requirement: Grid resizes while preserving overlapping cells
|
|
The system SHALL preserve cells that remain within bounds when the grid dimensions change, clearing only cells that fall outside the new bounds.
|
|
|
|
#### Scenario: Enlarge grid
|
|
- **WHEN** the grid grows in either dimension
|
|
- **THEN** previously alive cells within the old bounds remain alive
|
|
|
|
#### Scenario: Shrink grid
|
|
- **WHEN** the grid shrinks in either dimension
|
|
- **THEN** cells outside the new bounds are discarded
|
|
- **AND** remaining cells keep their state
|
|
|
|
### Requirement: Cell size is fixed in logical pixels
|
|
The system SHALL use a cell size of 8 logical pixels, so grid dimensions derive from the logical surface size.
|
|
|
|
#### Scenario: Dimension calculation
|
|
- **WHEN** the logical surface is 400 pixels wide
|
|
- **THEN** the grid has 50 columns
|
|
|
|
### Requirement: Alive cells are rendered
|
|
The system SHALL render alive cells distinctly from dead cells.
|
|
|
|
#### Scenario: Render alive cell
|
|
- **WHEN** a cell is alive
|
|
- **THEN** it is drawn with the alive cell color
|
|
|
|
### Requirement: Grid can be cleared
|
|
The system SHALL set all cells to dead when the clear action is triggered.
|
|
|
|
#### Scenario: Clear grid
|
|
- **WHEN** the user triggers the clear action
|
|
- **THEN** all cells become dead
|
|
|
|
### Requirement: Grid lines can be toggled
|
|
The system SHALL show or hide grid lines when the toggle_grid action is triggered.
|
|
|
|
#### Scenario: Toggle lines
|
|
- **WHEN** the user triggers the toggle_grid action
|
|
- **THEN** grid line visibility flips
|