Commit 6079f79
authored
spec: add maze-printable specification (#3236)
## New Specification: `maze-printable`
Related to #3232
---
### specification.md
# maze-printable: Printable Maze Puzzle
## Description
A rectangular maze puzzle visualization with clearly marked start and
goal positions. The maze is algorithmically generated to guarantee
exactly one solution path from start to finish. The clean
black-and-white design is optimized for printing, allowing users to
solve the puzzle with a pen or pencil.
## Applications
- Printable activity sheets for children's entertainment and education
- Puzzle books and newspapers requiring programmatically generated mazes
- Educational materials teaching algorithmic thinking and
problem-solving
- Restaurant placemats and waiting room entertainment
## Data
- `width` (int) - Number of cells horizontally (recommended: 15-40)
- `height` (int) - Number of cells vertically (recommended: 15-40)
- `seed` (int, optional) - Random seed for reproducible maze generation
- Size: Grid dimensions determine complexity (larger = harder)
- Example: 25x25 grid with start at top-left, goal at bottom-right
## Notes
- Use maze generation algorithms (DFS, Prim's, Kruskal's) that guarantee
a single solution
- Start position typically marked with "S" or arrow, goal with "G" or
star
- Wall thickness should be consistent and print-friendly (not too thin)
- Include adequate margins for printing
- Black walls on white background for maximum contrast and ink
efficiency
- Passage width should accommodate pen/pencil marking
---
**Next:** Add `approved` label to the issue to merge this PR.
---
:robot: *[spec-create
workflow](https://github.com/MarkusNeusinger/pyplots/actions/runs/20794899276)*
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>1 parent bf5e0cf commit 6079f79
2 files changed
+57
-0
lines changed| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
0 commit comments