porta 1.0.0__tar.gz

porta-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,41 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  check:
+    name: ${{ matrix.name }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - { name: test, cmd: "pytest" }
+          - { name: lint, cmd: "ruff check ." }
+          - { name: format, cmd: "ruff format --check ." }
+          - { name: types, cmd: "mypy" }
+          - { name: docs, cmd: "python src/build_figures.py && git diff --exit-code" }
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          python-version: "3.14"
+          enable-cache: true
+      - run: uv run --extra dev ${{ matrix.cmd }}
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          python-version: "3.14"
+          enable-cache: true
+      - run: uv build

porta-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,25 @@
+name: publish
+
+# Publish to PyPI via Trusted Publishing (OIDC) — no stored token.
+# Fires when a GitHub release is published; can also be run by hand
+# (Actions -> publish -> Run workflow) to publish an already-made release.
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # required for Trusted Publishing
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - run: uv run --extra dev pytest
+      - run: uv build
+      - run: uv publish

porta-1.0.0/.gitignore

@@ -0,0 +1,27 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.eggs/
+
+# Virtual envs / tooling
+.venv/
+.uv/
+uv.lock
+
+# Test / coverage
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Editors / OS
+.DS_Store
+.idea/
+.vscode/
+
+# Rendered output (examples may emit these locally)
+*.svg
+!docs/**/*.svg
+!tests/fixtures/**/*.svg

porta-1.0.0/CLAUDE.md

@@ -0,0 +1,53 @@
+# porta
+
+A standalone Python package: a relational DSL for authoring D&D floor plans and
+rendering them to SVG. CLI-driven, zero runtime dependencies.
+
+The user-facing reference is [`docs/room.md`](docs/room.md) (rooms, placement,
+auto-dimensions, validation) and [`docs/door.md`](docs/door.md) (doors); for
+exact behaviour the code is the source of truth. The body below is just working
+conventions.
+
+## Orientation
+
+- **What it does** — parse a `.porta` spec (rooms + relational placement) →
+  resolve geometry by DAG propagation → render SVG.
+- **Package layout** — `src/porta/`: `cli.py` (argparse entry), `parser.py`
+  (`.porta` → model), `model.py` (dataclasses), `layout.py` (relations →
+  coordinates, validation), `render.py` (model → SVG/ASCII), `errors.py` (the
+  `PortaError` hierarchy, each carrying a source line). Tests in `tests/`.
+  `src/build_figures.py` regenerates the doc figures (a dev tool, not shipped).
+- **Consumer** — the `isles` D&D vault (sibling repo) installs porta via
+  `uv add --editable ../porta`. The `.porta` sources and rendered SVGs live in
+  *that* repo, not here. porta knows nothing about isles.
+
+## Workflow
+
+- Run with **`uv`**: `uv run porta draw <in>.porta -o <out>.svg`.
+- Gates (all run in CI on push/PR; run them locally before pushing):
+  `uv run --extra dev pytest` · `ruff check .` · `ruff format --check .` ·
+  `mypy` · and a `docs` job that rebuilds the figures and fails on any drift.
+- Doc figures (`docs/img/`) are generated from fenced ` ```porta ` examples
+  (those with a path on the fence) in `README.md` and `docs/*.md` by
+  `src/build_figures.py` — don't hand-edit them, and keep the examples valid
+  (every one is solved on each build).
+- Use **`python`**, never `python3`.
+- Use **relative paths** in shell/git commands.
+- When handing the user a path to open, avoid spaces in it.
+
+## Conventions
+
+- Modern type hints (`list[str]`, `X | None`); dataclasses for the model.
+- Google-style docstrings on public functions.
+- Keep the runtime dependency-free: SVG via stdlib string/XML templating.
+- Small, pure, testable functions — especially in `layout.py`, where geometry
+  resolution and overlap detection should be unit-tested on tiny inputs.
+- Tests: prefer `pytest.mark.parametrize` for families of similar cases (valid
+  vs. invalid inputs, error conditions, geometry fixtures) over copy-pasted
+  near-identical test functions. Once a test is parametrized, adding a case is
+  one line — so be liberal and keep coverage comprehensive (give each case a
+  readable `id`). Reserve standalone test functions for genuinely distinct
+  assertions.
+- Tests mirror the source: one `tests/test_<module>.py` per `src/porta/<module>.py`
+  (e.g. `test_layout.py` covers all of `layout.py`). Error types in `errors.py`
+  are tested where they're raised, not in a separate file.

porta-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 William J. Bradshaw
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

porta-1.0.0/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: porta
+Version: 1.0.0
+Summary: A relational DSL for authoring and rendering SVG floorplans.
+Project-URL: Homepage, https://github.com/willbradshaw/porta
+Project-URL: Repository, https://github.com/willbradshaw/porta
+Project-URL: Issues, https://github.com/willbradshaw/porta/issues
+Author: Will Bradshaw
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cartography,dnd,dsl,floorplan,svg,ttrpg
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Games/Entertainment :: Role-Playing
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Typing :: Typed
+Requires-Python: >=3.14
+Provides-Extra: dev
+Requires-Dist: mypy>=1.11; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# `porta`
+
+`porta` is two things:
+
+1. A **DSL** for concisely defining a relational floorplan; and
+2. A **software package** for deterministically converting a floorplan into
+   a clean SVG map.
+
+```porta docs/img/readme.svg
+room hall    "Great Hall" 40x20 root
+room parlour "Parlour"    20x20 left-of hall
+room kitchen "Kitchen"    20x20 right-of hall
+room study   "Study"      ?x20  down-of parlour
+```
+
+<img alt="Four rooms rendered to an SVG floor plan" src="docs/img/readme.svg" width="60%">
+
+## The `porta` DSL
+
+`porta` floorplans are defined in `.porta` files adhering to a strict specification.
+Each room is defined in a single line relative to one or more anchor rooms,
+forming a dependency graph all the way back to the initial root room. This model
+creates a 1-to-1 correspondence between the floorplan and the final SVG map it
+produces, allowing `porta` to rapidly and deterministically generate one from
+the other.
+
+Files are read line by line: a `#` starts a comment that runs to the end of the
+line (a `#` inside a quoted name is literal), and blank lines are ignored.
+
+For more on the `porta` DSL specification, see the following documentation:
+
+- [**Rooms**](docs/room.md) — the `room` statement, room positioning,
+  auto-dimensions (`?`), and the layout resolution procedure.
+- [**Doors**](docs/door.md) — default doors & how to modify them, and
+  the `door` statement for explicitly adding non-default doors.
+
+## The `porta` tool
+
+Once a valid floorplan has been written, `porta draw` converts it into an
+SVG map in a two-step process. First, the dependency graph is traversed
+and the relations in the floorplan are converted into a coordinate system.
+Second, that coordinate system is used to deterministically generate an
+SVG file.
+
+```sh
+porta draw plan.porta -o plan.svg
+```
+
+The solved coordinate system can also be viewed and debugged directly
+as an ASCII grid:
+
+```sh
+porta draw plan.porta --debug-ascii
+```
+
+A plan that can't be solved (due to overlaps, missing anchors, gaps
+between a room and its anchor, etc) will fail and raise an error.
+
+## Installation
+
+`porta` is published on PyPI and can be installed with `pip`:
+
+```sh
+pip install porta
+```
+
+Alternatively, install it from a checkout of this repo. Add the `[dev]` extra
+to pull in the test and lint tools as well:
+
+```sh
+pip install -e .          # editable install
+pip install -e ".[dev]"   # ... plus pytest, ruff, and mypy
+```
+
+## Why `porta`?
+
+`porta` is built to be:
+
+- **Text-based** — a plan is plain text: editable in any editor, diffable, and
+  version-controlled alongside your campaign notes. No WYSIWYG, no binary files.
+- **Concise** — a terse syntax with strong defaults; a whole plan is a handful
+  of short lines.
+- **Deterministic** — no procedural generation and no randomness; the same plan
+  always renders the same map.
+- **Relational** — rooms are placed against other rooms, never drawn by hand or
+  given raw coordinates.
+- **Spatial** — the output is a flush, to-scale floor plan in tabletop
+  conventions, not a flowchart or connectivity graph.
+- **Fast** — placement is a single pass over a dependency graph, with no
+  constraint solver to run.
+- **AI-friendly** — terse, text-only, and predictable, so a language model can
+  read and write plans reliably (this one falls out of the rest).
+
+No existing tool hits all of these:
+
+- **Procedural and AI generators** (Watabou, Inkarnate) aren't deterministic or
+  controllable — they invent a layout instead of rendering yours.
+- **GUI map editors** (Dungeondraft, Dungeon Scrawl) aren't text: mouse-driven,
+  binary, and kept apart from your notes.
+- **Diagram tools** (Mermaid, Graphviz, D2) give connectivity, not a spatial,
+  to-scale map.
+- **Hand-written SVG** is text, but neither concise nor relational — verbose and
+  easy to get wrong.
+

porta-1.0.0/README.md

@@ -0,0 +1,104 @@
+# `porta`
+
+`porta` is two things:
+
+1. A **DSL** for concisely defining a relational floorplan; and
+2. A **software package** for deterministically converting a floorplan into
+   a clean SVG map.
+
+```porta docs/img/readme.svg
+room hall    "Great Hall" 40x20 root
+room parlour "Parlour"    20x20 left-of hall
+room kitchen "Kitchen"    20x20 right-of hall
+room study   "Study"      ?x20  down-of parlour
+```
+
+<img alt="Four rooms rendered to an SVG floor plan" src="docs/img/readme.svg" width="60%">
+
+## The `porta` DSL
+
+`porta` floorplans are defined in `.porta` files adhering to a strict specification.
+Each room is defined in a single line relative to one or more anchor rooms,
+forming a dependency graph all the way back to the initial root room. This model
+creates a 1-to-1 correspondence between the floorplan and the final SVG map it
+produces, allowing `porta` to rapidly and deterministically generate one from
+the other.
+
+Files are read line by line: a `#` starts a comment that runs to the end of the
+line (a `#` inside a quoted name is literal), and blank lines are ignored.
+
+For more on the `porta` DSL specification, see the following documentation:
+
+- [**Rooms**](docs/room.md) — the `room` statement, room positioning,
+  auto-dimensions (`?`), and the layout resolution procedure.
+- [**Doors**](docs/door.md) — default doors & how to modify them, and
+  the `door` statement for explicitly adding non-default doors.
+
+## The `porta` tool
+
+Once a valid floorplan has been written, `porta draw` converts it into an
+SVG map in a two-step process. First, the dependency graph is traversed
+and the relations in the floorplan are converted into a coordinate system.
+Second, that coordinate system is used to deterministically generate an
+SVG file.
+
+```sh
+porta draw plan.porta -o plan.svg
+```
+
+The solved coordinate system can also be viewed and debugged directly
+as an ASCII grid:
+
+```sh
+porta draw plan.porta --debug-ascii
+```
+
+A plan that can't be solved (due to overlaps, missing anchors, gaps
+between a room and its anchor, etc) will fail and raise an error.
+
+## Installation
+
+`porta` is published on PyPI and can be installed with `pip`:
+
+```sh
+pip install porta
+```
+
+Alternatively, install it from a checkout of this repo. Add the `[dev]` extra
+to pull in the test and lint tools as well:
+
+```sh
+pip install -e .          # editable install
+pip install -e ".[dev]"   # ... plus pytest, ruff, and mypy
+```
+
+## Why `porta`?
+
+`porta` is built to be:
+
+- **Text-based** — a plan is plain text: editable in any editor, diffable, and
+  version-controlled alongside your campaign notes. No WYSIWYG, no binary files.
+- **Concise** — a terse syntax with strong defaults; a whole plan is a handful
+  of short lines.
+- **Deterministic** — no procedural generation and no randomness; the same plan
+  always renders the same map.
+- **Relational** — rooms are placed against other rooms, never drawn by hand or
+  given raw coordinates.
+- **Spatial** — the output is a flush, to-scale floor plan in tabletop
+  conventions, not a flowchart or connectivity graph.
+- **Fast** — placement is a single pass over a dependency graph, with no
+  constraint solver to run.
+- **AI-friendly** — terse, text-only, and predictable, so a language model can
+  read and write plans reliably (this one falls out of the rest).
+
+No existing tool hits all of these:
+
+- **Procedural and AI generators** (Watabou, Inkarnate) aren't deterministic or
+  controllable — they invent a layout instead of rendering yours.
+- **GUI map editors** (Dungeondraft, Dungeon Scrawl) aren't text: mouse-driven,
+  binary, and kept apart from your notes.
+- **Diagram tools** (Mermaid, Graphviz, D2) give connectivity, not a spatial,
+  to-scale map.
+- **Hand-written SVG** is text, but neither concise nor relational — verbose and
+  easy to get wrong.
+

porta-1.0.0/docs/door.md

@@ -0,0 +1,126 @@
+# Doors
+
+By default, `porta` draws a **door** on every wall between a declared
+[room](room.md) and its anchor. Explicit [door declarations](#door-declarations)
+and [statements](#the-door-statement) are needed only to change a door from
+its default settings (remove it, resize it, move it) or to add an additional door
+in a non-default location.
+
+> [!NOTE]
+> Doors are drawn as thick black marks straddling the walls between
+> the rooms they connect. They only appear in rendered SVG; the
+> ASCII debug view (`porta draw <plan>.porta --debug-ascii`) 
+> shows the room layout without them.
+
+## Default doors
+
+Every [relation](room.md#relations) connecting two rooms is given a
+door by default. These default doors are 5 feet wide and positioned
+as close to the centre of the wall as possible. If they cannot be placed
+fully centrally due to the 5-foot wall grid, they are positioned
+immediately above (for vertical walls) or to the left of the center
+(for horizontal walls).
+
+```porta img/door-overview.svg
+room hall    "Hall"    20x20 root
+room kitchen "Kitchen" 20x20 right-of hall
+room study   "Study"   20x20 down-of hall
+```
+
+<img alt="Three rooms with a default door on each shared wall" src="img/door-overview.svg" width="70%">
+
+## Door declarations
+
+The door drawn by a [relation](room.md#relations) can be modified by
+a **door declaration** added to the end of that relation. There are two
+types of door declaration:
+
+- A `no-door` declaration suppresses the default door on that relation.
+- A `door*` declaration changes the **width** and/or **offset** of the
+  door: `door=W` sets the door width to `W` feet, `door@O` sets the
+  start of the door to `O` feet from the start of the wall, and
+  `door=W@O` sets both.
+
+```porta img/door-declarations.svg
+room r "Root" 20x20 root
+room a "Room A" 20x20 right-of r no-door
+room b "Room B" 20x20 down-of r door=10
+room c "Room C" 20x20 right-of b door@15
+```
+
+<img alt="Four rooms with various modifications to their doors" src="img/door-declarations.svg" width="70%">
+
+## The `door` statement
+
+Some doors aren't tied to a positioning relation. A standalone **`door`
+statement**, on its own line, adds one.
+
+### Between two rooms: `door <a> <b>`
+
+Two rooms can share a wall without either being the other's anchor. A
+`door` statement connects them, following the same width and offset
+syntax as [door declarations](#door-declarations):
+
+```porta img/door-standalone.svg
+room hall "Hall" 40x20 root
+room east "East" 20x20 down-of hall
+room west "West" 20x20 down-of hall shift=20
+door=10@0 east west
+```
+
+<img alt="Two rooms below a hall, joined by a standalone door" src="img/door-standalone.svg" width="70%">
+
+`door` statements can also be used to add additional doors to walls that
+already have them, as long as the doors do not overlap:
+
+```porta img/door-multi.svg
+room r "Root" 20x20 root
+room a "Room A" 20x20 right-of r door@5
+door@15 r a
+```
+
+<img alt="A pair of rooms linked by two doors" src="img/door-multi.svg" width="70%">
+
+### To the outside: `door <room> outside <side>`
+
+An **external** door opens a room onto the outside, on a named side — `up`,
+`down`, `left`, or `right`:
+
+```porta img/door-outside.svg
+room a "Room A" 20x20 root
+room b "Room B" 20x20 right-of a
+door a outside left
+door b outside down
+```
+
+<img alt="Two rooms with external doors on their outer walls" src="img/door-outside.svg" width="70%">
+
+## Invalid doors
+
+`porta` rejects a door it can't place:
+
+- An explicit `door` on a relation whose rooms share no wall (they meet only at
+  a corner).
+- A door wider than its wall, or pushed past the wall's end by its offset.
+- Two doors that overlap on the same wall.
+- An external door on a side that isn't exterior — a room sits flush there.
+
+## Putting it together
+
+```porta img/door-capstone.svg
+room hall     "Hall"          20x40 root
+room drawing  "Drawing Room"  30x40 left-of hall door=20
+room dining   "Dining Room"   30x20 right-of hall door@10
+room kitchen  "Kitchen"       30x20 right-of hall align=end
+room pantry   "Pantry"        10x?  right-of dining right-of kitchen
+room porch    "Porch"         20x10 down-of hall
+room cloak    "Cloakroom"     10x10 down-of drawing left-of porch
+room scullery "Scullery"      15x10 down-of kitchen align=end shift=-5
+room passage  "Passage"       ?x10  right-of porch left-of scullery
+door=10@5 dining kitchen
+door porch outside down
+door dining outside up
+door drawing outside left
+```
+
+<img alt="The manor ground floor with its doors controlled" src="img/door-capstone.svg" width="70%">

porta-1.0.0/docs/img/adjacency.svg

@@ -0,0 +1,43 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1100" height="1268" viewBox="-50 -25 110 126.8">
+  <rect x="-50" y="-25" width="110" height="126.8" fill="#e0e0e0" />
+  <g stroke="#bbb" stroke-width="0.15">
+    <line x1="-15" y1="-15" x2="-15" y2="25" />
+    <line x1="-10" y1="-15" x2="-10" y2="25" />
+    <line x1="-5" y1="-15" x2="-5" y2="25" />
+    <line x1="0" y1="-15" x2="0" y2="25" />
+    <line x1="5" y1="-15" x2="5" y2="25" />
+    <line x1="10" y1="-15" x2="10" y2="25" />
+    <line x1="15" y1="-15" x2="15" y2="25" />
+    <line x1="20" y1="-15" x2="20" y2="25" />
+    <line x1="25" y1="-15" x2="25" y2="25" />
+    <line x1="-15" y1="-15" x2="25" y2="-15" />
+    <line x1="-15" y1="-10" x2="25" y2="-10" />
+    <line x1="-15" y1="-5" x2="25" y2="-5" />
+    <line x1="-15" y1="0" x2="25" y2="0" />
+    <line x1="-15" y1="5" x2="25" y2="5" />
+    <line x1="-15" y1="10" x2="25" y2="10" />
+    <line x1="-15" y1="15" x2="25" y2="15" />
+    <line x1="-15" y1="20" x2="25" y2="20" />
+    <line x1="-15" y1="25" x2="25" y2="25" />
+  </g>
+  <rect data-room="a" x="-15" y="0" width="15" height="10" fill="none" stroke="black" stroke-width="0.5" />
+  <text data-room="a" x="-7.5" y="5" text-anchor="middle" dominant-baseline="central" font-size="6">A</text>
+  <rect data-room="b" x="10" y="0" width="15" height="10" fill="none" stroke="black" stroke-width="0.5" />
+  <text data-room="b" x="17.5" y="5" text-anchor="middle" dominant-baseline="central" font-size="6">B</text>
+  <rect data-room="c" x="0" y="-15" width="10" height="15" fill="none" stroke="black" stroke-width="0.5" />
+  <text data-room="c" x="5" y="-7.5" text-anchor="middle" dominant-baseline="central" font-size="6">C</text>
+  <rect data-room="d" x="0" y="10" width="10" height="15" fill="none" stroke="black" stroke-width="0.5" />
+  <text data-room="d" x="5" y="17.5" text-anchor="middle" dominant-baseline="central" font-size="6">D</text>
+  <rect data-room="r" x="0" y="0" width="10" height="10" fill="none" stroke="black" stroke-width="0.5" />
+  <text data-room="r" x="5" y="5" text-anchor="middle" dominant-baseline="central" font-size="6">R</text>
+  <line class="door" x1="0" y1="0" x2="0" y2="5" stroke="black" stroke-width="1.5" />
+  <line class="door" x1="0" y1="0" x2="5" y2="0" stroke="black" stroke-width="1.5" />
+  <line class="door" x1="0" y1="10" x2="5" y2="10" stroke="black" stroke-width="1.5" />
+  <line class="door" x1="10" y1="0" x2="10" y2="5" stroke="black" stroke-width="1.5" />
+  <text class="scale" x="-40" y="44.2" font-size="6">1 square = 5 ft</text>
+  <text class="key" x="-40" y="53.8" font-size="6">A  Left room  (15x10 ft)</text>
+  <text class="key" x="-40" y="63.4" font-size="6">B  Right room  (15x10 ft)</text>
+  <text class="key" x="-40" y="73" font-size="6">C  Up room  (10x15 ft)</text>
+  <text class="key" x="-40" y="82.6" font-size="6">D  Down room  (10x15 ft)</text>
+  <text class="key" x="-40" y="92.2" font-size="6">R  Root room  (10x10 ft)</text>
+</svg>

porta-1.0.0/docs/img/align_default.svg

@@ -0,0 +1,31 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1100" height="876" viewBox="-45 -10 110 87.6">
+  <rect x="-45" y="-10" width="110" height="87.6" fill="#e0e0e0" />
+  <g stroke="#bbb" stroke-width="0.15">
+    <line x1="-10" y1="0" x2="-10" y2="20" />
+    <line x1="-5" y1="0" x2="-5" y2="20" />
+    <line x1="0" y1="0" x2="0" y2="20" />
+    <line x1="5" y1="0" x2="5" y2="20" />
+    <line x1="10" y1="0" x2="10" y2="20" />
+    <line x1="15" y1="0" x2="15" y2="20" />
+    <line x1="20" y1="0" x2="20" y2="20" />
+    <line x1="25" y1="0" x2="25" y2="20" />
+    <line x1="30" y1="0" x2="30" y2="20" />
+    <line x1="-10" y1="0" x2="30" y2="0" />
+    <line x1="-10" y1="5" x2="30" y2="5" />
+    <line x1="-10" y1="10" x2="30" y2="10" />
+    <line x1="-10" y1="15" x2="30" y2="15" />
+    <line x1="-10" y1="20" x2="30" y2="20" />
+  </g>
+  <rect data-room="a" x="-10" y="0" width="10" height="10" fill="none" stroke="black" stroke-width="0.5" />
+  <text data-room="a" x="-5" y="5" text-anchor="middle" dominant-baseline="central" font-size="6">A</text>
+  <rect data-room="b" x="20" y="0" width="10" height="10" fill="none" stroke="black" stroke-width="0.5" />
+  <text data-room="b" x="25" y="5" text-anchor="middle" dominant-baseline="central" font-size="6">B</text>
+  <rect data-room="r" x="0" y="0" width="20" height="20" fill="none" stroke="black" stroke-width="0.5" />
+  <text data-room="r" x="10" y="10" text-anchor="middle" dominant-baseline="central" font-size="12">R</text>
+  <line class="door" x1="0" y1="0" x2="0" y2="5" stroke="black" stroke-width="1.5" />
+  <line class="door" x1="20" y1="0" x2="20" y2="5" stroke="black" stroke-width="1.5" />
+  <text class="scale" x="-35" y="39.2" font-size="6">1 square = 5 ft</text>
+  <text class="key" x="-35" y="48.8" font-size="6">A  Left room  (10x10 ft)</text>
+  <text class="key" x="-35" y="58.4" font-size="6">B  Right room  (10x10 ft)</text>
+  <text class="key" x="-35" y="68" font-size="6">R  Root room  (20x20 ft)</text>
+</svg>

porta-1.0.0/docs/img/align_end.svg

@@ -0,0 +1,31 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1100" height="876" viewBox="-45 -10 110 87.6">
+  <rect x="-45" y="-10" width="110" height="87.6" fill="#e0e0e0" />
+  <g stroke="#bbb" stroke-width="0.15">
+    <line x1="-10" y1="0" x2="-10" y2="20" />
+    <line x1="-5" y1="0" x2="-5" y2="20" />
+    <line x1="0" y1="0" x2="0" y2="20" />
+    <line x1="5" y1="0" x2="5" y2="20" />
+    <line x1="10" y1="0" x2="10" y2="20" />
+    <line x1="15" y1="0" x2="15" y2="20" />
+    <line x1="20" y1="0" x2="20" y2="20" />
+    <line x1="25" y1="0" x2="25" y2="20" />
+    <line x1="30" y1="0" x2="30" y2="20" />
+    <line x1="-10" y1="0" x2="30" y2="0" />
+    <line x1="-10" y1="5" x2="30" y2="5" />
+    <line x1="-10" y1="10" x2="30" y2="10" />
+    <line x1="-10" y1="15" x2="30" y2="15" />
+    <line x1="-10" y1="20" x2="30" y2="20" />
+  </g>
+  <rect data-room="a" x="-10" y="10" width="10" height="10" fill="none" stroke="black" stroke-width="0.5" />
+  <text data-room="a" x="-5" y="15" text-anchor="middle" dominant-baseline="central" font-size="6">A</text>
+  <rect data-room="b" x="20" y="10" width="10" height="10" fill="none" stroke="black" stroke-width="0.5" />
+  <text data-room="b" x="25" y="15" text-anchor="middle" dominant-baseline="central" font-size="6">B</text>
+  <rect data-room="r" x="0" y="0" width="20" height="20" fill="none" stroke="black" stroke-width="0.5" />
+  <text data-room="r" x="10" y="10" text-anchor="middle" dominant-baseline="central" font-size="12">R</text>
+  <line class="door" x1="0" y1="10" x2="0" y2="15" stroke="black" stroke-width="1.5" />
+  <line class="door" x1="20" y1="10" x2="20" y2="15" stroke="black" stroke-width="1.5" />
+  <text class="scale" x="-35" y="39.2" font-size="6">1 square = 5 ft</text>
+  <text class="key" x="-35" y="48.8" font-size="6">A  Left room  (10x10 ft)</text>
+  <text class="key" x="-35" y="58.4" font-size="6">B  Right room  (10x10 ft)</text>
+  <text class="key" x="-35" y="68" font-size="6">R  Root room  (20x20 ft)</text>
+</svg>