map/README.md

# Prefecture Map Generator

Browser-based procedural prefecture map generator.

## Project layout

- `src/` - application modules and web workers
- `styles/` - application styles
- `tests/` - browser and Node.js regression tests
- `scripts/` - local development server helpers
- `index.html` - application entry point


## Run locally

Windows:

```bat
scripts\start_server.bat 8000
```

macOS / Linux:

```sh
./scripts/start_server.sh 8000
```

Open `http://127.0.0.1:8000/`.

## Tests

The default manifest runs the fast, canonical Node.js gates:

```sh
node tests/test-all.mjs
```

The release manifest includes the default gates plus the longer production,
quality, cancellation, and mirror-synchronization checks:

```sh
TEST_GROUP=release node tests/test-all.mjs
```

The browser manifest launches the application-level Chromium regression test:

```sh
TEST_GROUP=browser node tests/test-all.mjs
```

On PowerShell, set a group with `$env:TEST_GROUP = "release"` (or
`"browser"`) before running the same command. To run specific registered
suites, provide a comma-separated `TEST_SUITES` value. Unknown suite and group
names fail immediately rather than succeeding without assertions.