From 3274d30665ab9d595c4cd0cb8748293fe80dcccd Mon Sep 17 00:00:00 2001
From: Albrecht Degering <albrecht@degering.name>
Date: Tue, 8 Sep 2026 02:06:10 +0200
Subject: [PATCH] fix(packaging): expose immutable WebUI Git package for
 v0.1.23

---
 README.md                                | 18 +++++++++++++
 package.json                             | 33 ++++++++++++++++++++++++
 pyproject.toml                           |  2 +-
 src/govoplan_postbox/__init__.py         |  2 +-
 src/govoplan_postbox/backend/manifest.py |  2 +-
 webui/package.json                       |  2 +-
 6 files changed, 55 insertions(+), 4 deletions(-)
 create mode 100644 package.json

diff --git a/README.md b/README.md
index 4ed93a1..52743a5 100644
--- a/README.md
+++ b/README.md
@@ -158,3 +158,21 @@ Run focused checks with:
 /mnt/DATA/git/govoplan/.venv/bin/python -m unittest discover -s tests
 cd webui && npm run test:ui-structure
 ```
+
+## Git-source WebUI package
+
+The repository root exposes `@govoplan/postbox-webui` for Git-tagged release
+dependencies. It mirrors the owning `webui/package.json` version, public
+TypeScript/CSS exports and peer requirements, with entry paths under
+`webui/src`. Consumers provide the shared Core/React peers; the facade runs no
+development or install scripts. The source archive contains `webui/src`, this
+README and any repository license file. Run module development checks from `webui/`; Python
+installation remains governed by `pyproject.toml`.
+
+Das Repository stellt `@govoplan/postbox-webui` am Wurzelpfad für versionierte
+Git-Abhängigkeiten bereit. Version, öffentliche TypeScript-/CSS-Exporte und
+Peer-Anforderungen entsprechen `webui/package.json`; die Einstiegspfade liegen
+unter `webui/src`. Gemeinsame Core-/React-Peers stellt die einbindende Anwendung
+bereit. Die Fassade führt keine Entwicklungs- oder Installationsskripte aus.
+Entwicklungsprüfungen bleiben in `webui/`, die Python-Installation weiterhin in
+`pyproject.toml` definiert.
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..6b584ce
--- /dev/null
+++ b/package.json
@@ -0,0 +1,33 @@
+{
+  "name": "@govoplan/postbox-webui",
+  "version": "0.1.23",
+  "private": true,
+  "type": "module",
+  "main": "webui/src/index.ts",
+  "module": "webui/src/index.ts",
+  "types": "webui/src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./webui/src/index.ts",
+      "import": "./webui/src/index.ts"
+    },
+    "./styles/postbox.css": "./webui/src/styles/postbox.css"
+  },
+  "peerDependencies": {
+    "@govoplan/core-webui": "^0.1.18",
+    "lucide-react": "^1.23.0",
+    "react": ">=19.2.7 <20",
+    "react-dom": ">=19.2.7 <20",
+    "react-router": ">=8.3.0 <9"
+  },
+  "peerDependenciesMeta": {
+    "@govoplan/core-webui": {
+      "optional": true
+    }
+  },
+  "files": [
+    "webui/src",
+    "README.md",
+    "LICENSE"
+  ]
+}
diff --git a/pyproject.toml b/pyproject.toml
index cd08dd2..3ca794a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "govoplan-postbox"
-version = "0.1.22"
+version = "0.1.23"
 description = "Function-bound institutional postboxes for GovOPlaN."
 readme = "README.md"
 requires-python = ">=3.12"
diff --git a/src/govoplan_postbox/__init__.py b/src/govoplan_postbox/__init__.py
index 17d3fe2..92d70b5 100644
--- a/src/govoplan_postbox/__init__.py
+++ b/src/govoplan_postbox/__init__.py
@@ -1,3 +1,3 @@
 """GovOPlaN Postbox module."""
 
-__version__ = "0.1.22"
+__version__ = "0.1.23"
diff --git a/src/govoplan_postbox/backend/manifest.py b/src/govoplan_postbox/backend/manifest.py
index 45f4599..3260e8c 100644
--- a/src/govoplan_postbox/backend/manifest.py
+++ b/src/govoplan_postbox/backend/manifest.py
@@ -77,7 +77,7 @@ from govoplan_postbox.backend.permissions import (
 
 MODULE_ID = "postbox"
 MODULE_NAME = "Postbox"
-MODULE_VERSION = "0.1.22"
+MODULE_VERSION = "0.1.23"
 
 
 def _permission(scope: str, label: str, description: str) -> PermissionDefinition:
diff --git a/webui/package.json b/webui/package.json
index 0eae1fd..566fabb 100644
--- a/webui/package.json
+++ b/webui/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@govoplan/postbox-webui",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "private": true,
   "type": "module",
   "main": "src/index.ts",