feat(core): support for python 3.14.x (#321)

* feat(core): support for python 3.14.x
* feat(cli): print python version in epilog
* refactor(platform): adapt to PEP 649 given we shadow list ...
* perf(gui,utils,wsi): lazy load nicegui
* docs: introduce mermaid support
* docs: update

Author: helmut-hoffer-von-ankershoffen

.github/CLAUDE.md

@@ -70,7 +70,7 @@ The Aignostics Python SDK uses a **sophisticated multi-stage CI/CD pipeline** bu
 
 | Workflow | Triggers | Purpose | Calls |
 |----------|----------|---------|-------|
-| **ci-cd.yml** | push(main), PR, release, tag | Main CI/CD pipeline | _lint, _audit, _test, _codeql, _ketryx, _package-publish, _docker-publish |
+| **ci-cd.yml** | push(main), PR, release, tag | Main CI/CD pipeline | _lint,_audit, _test,_codeql, _ketryx,_package-publish, _docker-publish |
 | **build-native-only.yml** | push, PR, release (if msg contains `build:native:only`) | Native executable builds | _build-native-only |
 | **claude-code-interactive.yml** | workflow_dispatch (manual) | Manual Claude sessions | _claude-code (interactive) |
 | **claude-code-automation-pr-review.yml** | PR opened/sync (excludes bots) | Automated PR reviews | _claude-code (automation) |
@@ -334,30 +334,32 @@ uv run pytest -m "(scheduled or scheduled_only)" -v
 1. Unit Tests (3 min)
    ├─ Python 3.11 ─┐
    ├─ Python 3.12 ─┼─ Parallel execution
-   └─ Python 3.13 ─┘
+   ├─ Python 3.13 ─┤
+   └─ Python 3.14 ─┘
 
 2. Integration Tests (5 min)
    ├─ Python 3.11 ─┐
    ├─ Python 3.12 ─┼─ Parallel execution
-   └─ Python 3.13 ─┘
+   ├─ Python 3.13 ─┤
+   └─ Python 3.14 ─┘
 
 3. E2E Regular (7 min)
    ├─ Python 3.11 ─┐
    ├─ Python 3.12 ─┼─ Parallel execution
-   └─ Python 3.13 ─┘
+   ├─ Python 3.13 ─┤
+   └─ Python 3.14 ─┘
 
 4. Long Running (if not skipped)
-   └─ Python 3.13 only (single version)
+   └─ Python 3.14 only (single version)
 
 5. Very Long Running (if explicitly enabled)
-   └─ Python 3.13 only (single version)
+   └─ Python 3.14 only (single version)
 ```
 
 **Matrix Testing**:
 
-* Unit, Integration, E2E run on **all 3 Python versions** (3.11, 3.12, 3.13)
-* Long running and very long running run on **Python 3.13 only** to save CI time
-* Windows ARM excludes Python 3.12.12 due to instability
+* Unit, Integration, E2E run on **all four Python versions** (3.11, 3.12, 3.13, 3.14)
+* Long running and very long running run on **Python 3.14 only** to save CI time
 
 ### Skip Markers System
 
@@ -1006,14 +1008,18 @@ make dist_native
 
 1. Ensure `main` branch is clean and all tests pass
 2. Run version bump:
+
    ```bash
    make bump patch  # or minor, major
    ```
+
 3. This creates a commit and git tag
 4. Push with tags:
+
    ```bash
    git push --follow-tags
    ```
+
 5. CI detects tag and triggers:
    * Full CI pipeline (lint, audit, test, CodeQL)
    * Package build and publish to PyPI

.github/copilot-instructions.md

@@ -77,7 +77,7 @@ CLI and GUI layers depend on Service layer, never on each other.
 make install          # Install dev deps + pre-commit hooks
 make all             # Full CI pipeline (lint, test, docs, audit)
 make test            # Run tests with coverage (85% minimum)
-make test 3.12       # Run on specific Python version
+make test 3.14       # Run on specific Python version
 make lint            # Ruff formatting + MyPy type checking
 ```
 

.python-version

@@ -1 +1 @@
-3.13.10
+3.14.1

.readthedocs.yml

@@ -34,3 +34,5 @@ build:
       - uv venv $READTHEDOCS_VIRTUALENV_PATH
       - . ${READTHEDOCS_VIRTUALENV_PATH}/bin/activate
       - UV_PROJECT_ENVIRONMENT=$READTHEDOCS_VIRTUALENV_PATH uv sync --frozen --all-extras
+    post_install:
+      - npm install -g --ignore-scripts @mermaid-js/mermaid-cli