unifi-network-maps 1.4.1__tar.gz → 1.4.3__tar.gz

{unifi_network_maps-1.4.1 → unifi_network_maps-1.4.3}/CHANGELOG.md

@@ -2,7 +2,30 @@
 
 All notable changes to this project will be documented in this file.
 
-## v1.4.0
+## v1.4.3 - (unreleased)
+- planned: POC for HA integration
+
+## v1.4.2 - 2026-01-10
+- Added static code analysis and stricter type-checking
+- Added contract tests for UniFi API wrapper with fixture-based validation.
+- Added optional live UniFi contract tests (gated by `UNIFI_CONTRACT_LIVE=1`).
+- Split CI into dedicated jobs and added a contract-test job.
+- Added Behave-based BDD tests covering CLI outputs, mkdocs assets, and error handling.
+- Added mkdocs timestamp (timezone configurable via `--mkdocs-timestamp-zone`).
+- Added optional dual Mermaid blocks for MkDocs Material theme switching (`--mkdocs-dual-theme`).
+- Switched UniFi API cache payloads to JSON for safer local storage.
+- Skips cache usage when the cache directory is group/world-writable.
+- Added `--no-cache` to bypass UniFi API cache reads/writes.
+- Added file locking around cache read/write operations to avoid concurrent corruption.
+- Hardened Mermaid label escaping for newlines and backslashes.
+- Fixed device cache serialization to preserve LLDP data when caching.
+- Added optional UniFi API request timeouts via `UNIFI_REQUEST_TIMEOUT_SECONDS`.
+- Made `--output` writes atomic to avoid partial files on interruption.
+
+## v1.4.1 - 2026-01-06
+- pip install was broken, fixed.
+
+## v1.4.0 - 2026-01-06
 - Added MkDocs output, which includes gateway/switch details and per-port tables.
 - Port tables show speed, PoE status, power, and wired clients per port.
 - Added compact legend with sidebar injection (`--mkdocs-sidebar-legend`).
@@ -15,14 +38,14 @@ All notable changes to this project will be documented in this file.
 - Added Faker-powered `--generate-mock` for deterministic mock fixtures (dev-only).
 - Added mock fixtures + SVG/Mermaid examples, with mock smoketest/CI steps.
 
-## v1.3.1
+## v1.3.1 - 2026-01-04
 - Added `lldp-md` output with per-device details tables and optional client sections.
 - Added `--client-scope wired|wireless|all` and dashed wireless client links in Mermaid/SVG.
 - Expanded smoketest outputs for wireless/all client scopes and LLDP markdown.
 - Fixed SVG icon loading paths after package reorg.
 - Tuned isometric port label placement on front tiles.
 
-## v1.3.0
+## v1.3.0 - 2026-01-04
 - Reorganized package into submodules (`adapters/`, `model/`, `render/`, `io/`, `cli/`).
 - YAML-based theming with default + dark themes and `--theme-file`.
 - CLI help now grouped by category; CLI logic split into focused helpers.
@@ -31,13 +54,13 @@ All notable changes to this project will be documented in this file.
 - Added PoE/edge/device count logging and improved label ordering helpers.
 - Coverage excludes asset packages; docs updated (options/groups + AI disclosure).
 
-## v1.2.4
+## v1.2.4 - 2026-01-03
 - Added typed `UplinkInfo`/`PortInfo` and uplink fallback for LLDP gaps.
 - Deterministic edge ordering for repeatable output.
 - CI publish workflow (trusted publishing) and release docs.
 - Project metadata and packaging updated for OSS readiness.
 
-## v1.1.0
+## v1.1.0 - 2026-01-03
 - Added isometric SVG output with grid-aligned links and isometric icon set.
 - Improved port label placement and client labeling in SVG outputs.
 - Added smoketest target with multiple outputs (ports/clients/legend).
@@ -45,14 +68,14 @@ All notable changes to this project will be documented in this file.
 - Fixed Mermaid legend/grouped output parsing errors.
 - Refined visuals: link gradients, tile gradients, icon placement tweaks.
 
-## v1.0.0
+## v1.0.0 - 2025-12-30
 - Mermaid legend can render as a separate graph.
 - Straight Mermaid links with node type coloring.
 - Added wired client leaf nodes and uplink port labels.
 - Expanded PoE detection tests and LLDP helpers.
 - CLI loads `.env` automatically.
 
-## v0.2.0
+## v0.2.0 - 2026-01-02 - Initial public release
 - Added versioning workflow and bump tooling.
 - Introduced SVG renderer and tree layout fixes.
 - Increased test coverage and added coverage tooling.

unifi_network_maps-1.4.3/CONTRIBUTING.md

@@ -0,0 +1,89 @@
+# Contributing
+
+Thanks for considering a contribution!
+
+## Development setup
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements-build.txt
+pip install -r requirements-dev.txt -c constraints.txt
+pre-commit install
+```
+
+Editable install:
+
+```bash
+pip install -e .
+```
+
+Local install check (non-editable):
+
+```bash
+pip install .
+```
+
+## Running checks
+
+```bash
+ruff check .
+pyright
+pytest
+behave
+```
+
+Or run everything with:
+
+```bash
+make ci
+```
+
+Notes:
+- Contract tests use fixtures in `tests/test_contract_unifi.py` and run in CI.
+- Live contract tests require `UNIFI_CONTRACT_LIVE=1` plus UniFi env vars.
+- BDD tests live in `features/` and run via `behave` (included in `make ci`).
+
+## Release
+
+Build and upload to PyPI:
+
+```bash
+python -m pip install build twine
+python -m build
+twine upload dist/*
+```
+
+Tagging is recommended before release:
+
+```bash
+git tag -a vX.Y.Z -m "vX.Y.Z"
+git push origin vX.Y.Z
+```
+
+See `LICENSES.md` for third-party license info.
+
+## Guidelines
+
+- Keep changes focused and small.
+- Add or update tests where behavior changes.
+- Run `make ci` before opening a PR.
+
+## Is there value in this project?
+
+  What exists today:
+
+  - UniFi UI topology view: great live map, but not exportable, not automatable, and not Mermaid/SVG.
+  - Mermaid/Graphviz tools: diagramming, but no UniFi data ingestion or LLDP/topology logic.
+  - UniFi API wrappers: data access only, no rendering/export pipelines.
+  - NetBox/Grafana/HA cards: broader infra tooling, but not focused on UniFi LLDP + publishable diagrams.
+
+  What’s distinctive here:
+
+  - Automated UniFi → Mermaid/SVG (incl. isometric) output, with ports/PoE/clients.
+  - Deterministic CLI + cache + mock generator for CI and docs.
+  - MkDocs/Markdown output plus planned HA‑friendly artifacts.
+  - A clean render pipeline that can power multiple export targets.
+
+  So we’re not duplicating a packaged workflow; we’re combining data + topology modeling + diagram output + documentation/export in a way I haven’t seen in one place.
+  

{unifi_network_maps-1.4.1 → unifi_network_maps-1.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unifi-network-maps
-Version: 1.4.1
+Version: 1.4.3
 Summary: Dynamic UniFi -> network maps in mermaid or svg
 Author: Merlijn
 License-Expression: MIT
@@ -25,31 +25,38 @@ Requires-Dist: python-dotenv==1.2.1
 Requires-Dist: PyYAML==6.0.3
 Provides-Extra: dev
 Requires-Dist: Faker==40.1.0; extra == "dev"
+Requires-Dist: behave==1.3.3; extra == "dev"
 Requires-Dist: pre-commit==4.5.1; extra == "dev"
 Requires-Dist: pytest==9.0.2; extra == "dev"
 Requires-Dist: pytest-cov==7.0.0; extra == "dev"
-Requires-Dist: ruff==0.14.10; extra == "dev"
+Requires-Dist: pyright==1.1.408; extra == "dev"
+Requires-Dist: ruff==0.14.11; extra == "dev"
 Dynamic: license-file
 
 # unifi-network-maps
 
-Dynamic UniFi -> Mermaid network maps generated from LLDP topology.
+[![CI](https://github.com/merlijntishauser/unifi-network-maps/actions/workflows/ci.yml/badge.svg)](https://github.com/merlijntishauser/unifi-network-maps/actions/workflows/ci.yml)
+[![CodeQL](https://github.com/merlijntishauser/unifi-network-maps/actions/workflows/codeql.yml/badge.svg)](https://github.com/merlijntishauser/unifi-network-maps/actions/workflows/codeql.yml)
+[![Publish](https://github.com/merlijntishauser/unifi-network-maps/actions/workflows/publish.yml/badge.svg)](https://github.com/merlijntishauser/unifi-network-maps/actions/workflows/publish.yml)
+[![PyPI](https://img.shields.io/pypi/v/unifi-network-maps.svg)](https://pypi.org/project/unifi-network-maps/)
 
-## Setup
+Dynamic UniFi network maps generated from LLDP topology. Output can be a range of options including Markdown,
+Mermaid, SVG (including an Isometric view), and MkDocs.
 
-- Python >= 3.13
-- Virtualenv required
+## Installation
+
+PyPI:
 
 ```bash
-python -m venv .venv
-source .venv/bin/activate
-pip install -r requirements-build.txt
-pip install -e . -c constraints.txt
+pip install unifi-network-maps
 ```
 
-Local install (non-editable):
+From source:
 
 ```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements-build.txt
 pip install .
 ```
 
@@ -63,6 +70,7 @@ export UNIFI_SITE=default
 export UNIFI_USER=local_admin
 export UNIFI_PASS=********
 export UNIFI_VERIFY_SSL=false
+export UNIFI_REQUEST_TIMEOUT_SECONDS=10
 ```
 
 Use a custom env file:
@@ -71,7 +79,7 @@ Use a custom env file:
 unifi-network-maps --env-file ./site.env --stdout
 ```
 
-## Usage
+## Quickstart
 
 Basic map (tree layout by LLDP hops):
 
@@ -85,6 +93,8 @@ Write Markdown for notes tools:
 unifi-network-maps --markdown --output ./network.md
 ```
 
+## Usage
+
 Show ports + clients:
 
 ```bash
@@ -101,23 +111,29 @@ Isometric SVG output:
 
 ```bash
 unifi-network-maps --format svg-iso --output ./network.svg
+```
 
-# Single-page MkDocs output (ports included, no clients)
-unifi-network-maps --format mkdocs --output ./docs/unifi-network.md
+MkDocs output (ports included, no clients):
 
-# MkDocs output (map + legend + gateway/switch port tables)
+```bash
 unifi-network-maps --format mkdocs --output ./docs/unifi-network.md
+```
 
-# Include wired clients in the port tables
+MkDocs output with clients:
+
+```bash
 unifi-network-maps --format mkdocs --include-clients --output ./docs/unifi-network.md
 ```
 
-SVG size overrides:
+MkDocs output with dual Mermaid blocks for Material theme switching:
 
 ```bash
-unifi-network-maps --format svg --svg-width 1400 --svg-height 900 --output ./network.svg
+unifi-network-maps --format mkdocs --mkdocs-dual-theme --output ./docs/unifi-network.md
+```
 
-# LLDP tables for troubleshooting
+LLDP tables for troubleshooting:
+
+```bash
 unifi-network-maps --format lldp-md --output ./lldp.md
 ```
 
@@ -142,9 +158,7 @@ unifi-network-maps --generate-mock examples/mock_data.json --mock-seed 1337
 Generate the isometric SVG:
 
 ```bash
-unifi-network-maps --mock-data examples/mock_data.json \
-  --include-ports --include-clients --format svg-iso \
-  --output examples/output/network_ports_clients_iso.svg
+unifi-network-maps --mock-data examples/mock_data.json   --include-ports --include-clients --format svg-iso   --output examples/output/network_ports_clients_iso.svg
 ```
 
 ![Isometric network example](examples/output/network_ports_clients_iso.svg)
@@ -170,50 +184,14 @@ graph TB
   linkStyle 1 stroke:#1e88e5,stroke-width:2px,arrowhead:none;
 ```
 
-## Local install check
-
-```bash
-pip install .
-```
-
-## Dev
-
-```bash
-pip install -r requirements-dev.txt -c constraints.txt
-```
-
-## Release
-
-Build and upload to PyPI:
-
-```bash
-python -m pip install build twine
-python -m build
-twine upload dist/*
-```
-
-Tagging is recommended before release:
-
-```bash
-git tag -a vX.Y.Z -m "vX.Y.Z"
-git push origin vX.Y.Z
-```
-
-See `LICENSES.md` for third-party license info.
-
-## Installation
-
-PyPI: https://pypi.org/project/unifi-network-maps/
+## MkDocs Material example
 
-```bash
-pip install unifi-network-maps
-```
+See `examples/mkdocs/` for a ready-to-use setup that renders Mermaid diagrams
+with Material for MkDocs, including a sample `unifi-network` page and legend.
 
-Then run:
+The built-in themes live at `src/unifi_network_maps/assets/themes/default.yaml` and
+`src/unifi_network_maps/assets/themes/dark.yaml`.
 
-```bash
-unifi-network-maps --help
-```
 
 ## Options
 
@@ -223,6 +201,7 @@ Source:
 - `--site`: override `UNIFI_SITE`.
 - `--env-file`: load environment variables from a specific `.env` file.
 - `--mock-data`: use mock data JSON instead of the UniFi API.
+
 Mock:
 - `--generate-mock`: write mock data JSON and exit.
 - `--mock-seed`: seed for deterministic mock generation.
@@ -236,6 +215,7 @@ Functional:
 - `--include-clients`: add active wired clients as leaf nodes.
 - `--client-scope wired|wireless|all`: which client types to include (default wired).
 - `--only-unifi`: only include neighbors that are UniFi devices.
+- `--no-cache`: disable UniFi API cache reads and writes.
 
 Mermaid:
 - `--direction LR|TB`: diagram direction for Mermaid (default TB).
@@ -253,25 +233,13 @@ Output:
 - `--stdout`: write output to stdout.
 - `--markdown`: wrap Mermaid output in a code fence.
 - `--mkdocs-sidebar-legend`: write assets to place the compact legend in the MkDocs right sidebar.
+- `--mkdocs-dual-theme`: render light/dark Mermaid blocks for Material theme switching.
+- `--mkdocs-timestamp-zone`: timezone for mkdocs timestamp (`Europe/Amsterdam` default; use `off` to disable).
 
 Debug:
 - `--debug-dump`: dump gateway + sample devices to stderr for debugging.
 - `--debug-sample N`: number of non-gateway devices in debug dump (default 2).
 
-## Notes
-
-- Default output is top-to-bottom (TB) and rendered as a hop-based tree from the gateway(s).
-- Nodes are color-coded by type (gateway/switch/AP/client) with a sensible default palette.
-- PoE links are highlighted in blue and annotated with a power icon when detected from `port_table`.
-- Wireless client links render as dashed lines to indicate the last-known upstream.
-- SVG output uses vendored device glyphs from `src/unifi_network_maps/assets/icons`.
-- Isometric SVG output uses MIT-licensed icons from `markmanx/isopacks`.
-- SVG port labels render inside child nodes for readability.
-
-## AI Disclosure
-
-This project used OpenAI Codex as a coding assistant for portions of the implementation and documentation.
-
 ## Theme file
 
 Example theme YAML (override only the values you want):
@@ -297,10 +265,17 @@ svg:
       to: "#b6dcff"
 ```
 
-## MkDocs Material example
+## Notes
 
-See `examples/mkdocs/` for a ready-to-use setup that renders Mermaid diagrams
-with Material for MkDocs, including a sample `unifi-network` page and legend.
+- Default output is top-to-bottom (TB) and rendered as a hop-based tree from the gateway(s).
+- Nodes are color-coded by type (gateway/switch/AP/client) with a sensible default palette.
+- PoE links are highlighted in blue and annotated with a power icon when detected from `port_table`.
+- Wireless client links render as dashed lines to indicate the last-known upstream.
+- SVG output uses vendored device glyphs from `src/unifi_network_maps/assets/icons`.
+- Isometric SVG output uses MIT-licensed icons from `markmanx/isopacks`.
+- SVG port labels render inside child nodes for readability.
 
-The built-in themes live at `src/unifi_network_maps/assets/themes/default.yaml` and
-`src/unifi_network_maps/assets/themes/dark.yaml`.
+
+## AI Disclosure
+
+This project used OpenAI Codex as a coding assistant for portions of the implementation and documentation.

{unifi_network_maps-1.4.1 → unifi_network_maps-1.4.3}/README.md

@@ -1,22 +1,27 @@
 # unifi-network-maps
 
-Dynamic UniFi -> Mermaid network maps generated from LLDP topology.
+[![CI](https://github.com/merlijntishauser/unifi-network-maps/actions/workflows/ci.yml/badge.svg)](https://github.com/merlijntishauser/unifi-network-maps/actions/workflows/ci.yml)
+[![CodeQL](https://github.com/merlijntishauser/unifi-network-maps/actions/workflows/codeql.yml/badge.svg)](https://github.com/merlijntishauser/unifi-network-maps/actions/workflows/codeql.yml)
+[![Publish](https://github.com/merlijntishauser/unifi-network-maps/actions/workflows/publish.yml/badge.svg)](https://github.com/merlijntishauser/unifi-network-maps/actions/workflows/publish.yml)
+[![PyPI](https://img.shields.io/pypi/v/unifi-network-maps.svg)](https://pypi.org/project/unifi-network-maps/)
 
-## Setup
+Dynamic UniFi network maps generated from LLDP topology. Output can be a range of options including Markdown,
+Mermaid, SVG (including an Isometric view), and MkDocs.
 
-- Python >= 3.13
-- Virtualenv required
+## Installation
+
+PyPI:
 
 ```bash
-python -m venv .venv
-source .venv/bin/activate
-pip install -r requirements-build.txt
-pip install -e . -c constraints.txt
+pip install unifi-network-maps
 ```
 
-Local install (non-editable):
+From source:
 
 ```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements-build.txt
 pip install .
 ```
 
@@ -30,6 +35,7 @@ export UNIFI_SITE=default
 export UNIFI_USER=local_admin
 export UNIFI_PASS=********
 export UNIFI_VERIFY_SSL=false
+export UNIFI_REQUEST_TIMEOUT_SECONDS=10
 ```
 
 Use a custom env file:
@@ -38,7 +44,7 @@ Use a custom env file:
 unifi-network-maps --env-file ./site.env --stdout
 ```
 
-## Usage
+## Quickstart
 
 Basic map (tree layout by LLDP hops):
 
@@ -52,6 +58,8 @@ Write Markdown for notes tools:
 unifi-network-maps --markdown --output ./network.md
 ```
 
+## Usage
+
 Show ports + clients:
 
 ```bash
@@ -68,23 +76,29 @@ Isometric SVG output:
 
 ```bash
 unifi-network-maps --format svg-iso --output ./network.svg
+```
 
-# Single-page MkDocs output (ports included, no clients)
-unifi-network-maps --format mkdocs --output ./docs/unifi-network.md
+MkDocs output (ports included, no clients):
 
-# MkDocs output (map + legend + gateway/switch port tables)
+```bash
 unifi-network-maps --format mkdocs --output ./docs/unifi-network.md
+```
 
-# Include wired clients in the port tables
+MkDocs output with clients:
+
+```bash
 unifi-network-maps --format mkdocs --include-clients --output ./docs/unifi-network.md
 ```
 
-SVG size overrides:
+MkDocs output with dual Mermaid blocks for Material theme switching:
 
 ```bash
-unifi-network-maps --format svg --svg-width 1400 --svg-height 900 --output ./network.svg
+unifi-network-maps --format mkdocs --mkdocs-dual-theme --output ./docs/unifi-network.md
+```
 
-# LLDP tables for troubleshooting
+LLDP tables for troubleshooting:
+
+```bash
 unifi-network-maps --format lldp-md --output ./lldp.md
 ```
 
@@ -109,9 +123,7 @@ unifi-network-maps --generate-mock examples/mock_data.json --mock-seed 1337
 Generate the isometric SVG:
 
 ```bash
-unifi-network-maps --mock-data examples/mock_data.json \
-  --include-ports --include-clients --format svg-iso \
-  --output examples/output/network_ports_clients_iso.svg
+unifi-network-maps --mock-data examples/mock_data.json   --include-ports --include-clients --format svg-iso   --output examples/output/network_ports_clients_iso.svg
 ```
 
 ![Isometric network example](examples/output/network_ports_clients_iso.svg)
@@ -137,50 +149,14 @@ graph TB
   linkStyle 1 stroke:#1e88e5,stroke-width:2px,arrowhead:none;
 ```
 
-## Local install check
-
-```bash
-pip install .
-```
-
-## Dev
-
-```bash
-pip install -r requirements-dev.txt -c constraints.txt
-```
-
-## Release
-
-Build and upload to PyPI:
-
-```bash
-python -m pip install build twine
-python -m build
-twine upload dist/*
-```
-
-Tagging is recommended before release:
-
-```bash
-git tag -a vX.Y.Z -m "vX.Y.Z"
-git push origin vX.Y.Z
-```
-
-See `LICENSES.md` for third-party license info.
-
-## Installation
-
-PyPI: https://pypi.org/project/unifi-network-maps/
+## MkDocs Material example
 
-```bash
-pip install unifi-network-maps
-```
+See `examples/mkdocs/` for a ready-to-use setup that renders Mermaid diagrams
+with Material for MkDocs, including a sample `unifi-network` page and legend.
 
-Then run:
+The built-in themes live at `src/unifi_network_maps/assets/themes/default.yaml` and
+`src/unifi_network_maps/assets/themes/dark.yaml`.
 
-```bash
-unifi-network-maps --help
-```
 
 ## Options
 
@@ -190,6 +166,7 @@ Source:
 - `--site`: override `UNIFI_SITE`.
 - `--env-file`: load environment variables from a specific `.env` file.
 - `--mock-data`: use mock data JSON instead of the UniFi API.
+
 Mock:
 - `--generate-mock`: write mock data JSON and exit.
 - `--mock-seed`: seed for deterministic mock generation.
@@ -203,6 +180,7 @@ Functional:
 - `--include-clients`: add active wired clients as leaf nodes.
 - `--client-scope wired|wireless|all`: which client types to include (default wired).
 - `--only-unifi`: only include neighbors that are UniFi devices.
+- `--no-cache`: disable UniFi API cache reads and writes.
 
 Mermaid:
 - `--direction LR|TB`: diagram direction for Mermaid (default TB).
@@ -220,25 +198,13 @@ Output:
 - `--stdout`: write output to stdout.
 - `--markdown`: wrap Mermaid output in a code fence.
 - `--mkdocs-sidebar-legend`: write assets to place the compact legend in the MkDocs right sidebar.
+- `--mkdocs-dual-theme`: render light/dark Mermaid blocks for Material theme switching.
+- `--mkdocs-timestamp-zone`: timezone for mkdocs timestamp (`Europe/Amsterdam` default; use `off` to disable).
 
 Debug:
 - `--debug-dump`: dump gateway + sample devices to stderr for debugging.
 - `--debug-sample N`: number of non-gateway devices in debug dump (default 2).
 
-## Notes
-
-- Default output is top-to-bottom (TB) and rendered as a hop-based tree from the gateway(s).
-- Nodes are color-coded by type (gateway/switch/AP/client) with a sensible default palette.
-- PoE links are highlighted in blue and annotated with a power icon when detected from `port_table`.
-- Wireless client links render as dashed lines to indicate the last-known upstream.
-- SVG output uses vendored device glyphs from `src/unifi_network_maps/assets/icons`.
-- Isometric SVG output uses MIT-licensed icons from `markmanx/isopacks`.
-- SVG port labels render inside child nodes for readability.
-
-## AI Disclosure
-
-This project used OpenAI Codex as a coding assistant for portions of the implementation and documentation.
-
 ## Theme file
 
 Example theme YAML (override only the values you want):
@@ -264,10 +230,17 @@ svg:
       to: "#b6dcff"
 ```
 
-## MkDocs Material example
+## Notes
 
-See `examples/mkdocs/` for a ready-to-use setup that renders Mermaid diagrams
-with Material for MkDocs, including a sample `unifi-network` page and legend.
+- Default output is top-to-bottom (TB) and rendered as a hop-based tree from the gateway(s).
+- Nodes are color-coded by type (gateway/switch/AP/client) with a sensible default palette.
+- PoE links are highlighted in blue and annotated with a power icon when detected from `port_table`.
+- Wireless client links render as dashed lines to indicate the last-known upstream.
+- SVG output uses vendored device glyphs from `src/unifi_network_maps/assets/icons`.
+- Isometric SVG output uses MIT-licensed icons from `markmanx/isopacks`.
+- SVG port labels render inside child nodes for readability.
 
-The built-in themes live at `src/unifi_network_maps/assets/themes/default.yaml` and
-`src/unifi_network_maps/assets/themes/dark.yaml`.
+
+## AI Disclosure
+
+This project used OpenAI Codex as a coding assistant for portions of the implementation and documentation.