From 48205e6e461f5f93d88380df8e23db54fdb719f7 Mon Sep 17 00:00:00 2001
From: Albrecht Degering <albrecht@degering.name>
Date: Mon, 24 Aug 2026 11:36:41 +0200
Subject: [PATCH] fix(webui): bind reusable mail credentials to help

---
 package-lock.json                                 |  4 ++--
 package.json                                      |  2 +-
 pyproject.toml                                    |  2 +-
 src/govoplan_mail/backend/manifest.py             |  2 +-
 webui/package-lock.json                           |  4 ++--
 webui/package.json                                |  2 +-
 webui/src/features/mail/MailProfileManagement.tsx | 12 ++++++++----
 7 files changed, 16 insertions(+), 12 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index c82b651..36ea56d 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "@govoplan/mail-webui",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@govoplan/mail-webui",
-      "version": "0.1.23",
+      "version": "0.1.24",
       "peerDependencies": {
         "@govoplan/core-webui": "^0.1.18",
         "lucide-react": "^1.23.0",
diff --git a/package.json b/package.json
index 478f7f7..b7aa1ba 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@govoplan/mail-webui",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "private": true,
   "type": "module",
   "main": "webui/src/index.ts",
diff --git a/pyproject.toml b/pyproject.toml
index ad89ea3..f16a054 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "govoplan-mail"
-version = "0.1.23"
+version = "0.1.24"
 description = "GovOPlaN mail module with backend and WebUI integration."
 readme = "README.md"
 requires-python = ">=3.12"
diff --git a/src/govoplan_mail/backend/manifest.py b/src/govoplan_mail/backend/manifest.py
index 225adb6..cd2e7fd 100644
--- a/src/govoplan_mail/backend/manifest.py
+++ b/src/govoplan_mail/backend/manifest.py
@@ -445,7 +445,7 @@ POP3_PROVIDER = ExternalProviderDeclaration(
 manifest = ModuleManifest(
     id="mail",
     name="Mail",
-    version="0.1.23",
+    version="0.1.24",
     required_capabilities=(CAPABILITY_AUTH_PRINCIPAL_RESOLVER, CAPABILITY_AUTH_PERMISSION_EVALUATOR),
     optional_dependencies=("campaigns", "addresses", "calendar", "postbox", "search"),
     provides_interfaces=(
diff --git a/webui/package-lock.json b/webui/package-lock.json
index c97c9e1..5e244a0 100644
--- a/webui/package-lock.json
+++ b/webui/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "@govoplan/mail-webui",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@govoplan/mail-webui",
-      "version": "0.1.23",
+      "version": "0.1.24",
       "devDependencies": {
         "typescript": "^5.7.2"
       },
diff --git a/webui/package.json b/webui/package.json
index 0b67f8a..40d4f37 100644
--- a/webui/package.json
+++ b/webui/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@govoplan/mail-webui",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "private": true,
   "type": "module",
   "main": "src/index.ts",
diff --git a/webui/src/features/mail/MailProfileManagement.tsx b/webui/src/features/mail/MailProfileManagement.tsx
index 667c684..15e7c26 100644
--- a/webui/src/features/mail/MailProfileManagement.tsx
+++ b/webui/src/features/mail/MailProfileManagement.tsx
@@ -1495,7 +1495,7 @@ function ProfileForm({
       {editTarget.kind === "credentials" &&
       <FormGrid columns={2} gap="small" collapseAt="workspace" className="">
         {creatingCredential &&
-        <FormField label="Reusable credential" documentation={MAIL_PROFILE_WORKFLOW_DOCUMENTATION}>
+        <FormField label="Reusable credential" documentation={MAIL_PROFILE_WORKFLOW_DOCUMENTATION} helpContextId="mail.profiles" helpModuleId="mail">
           <select value={reuseCredentialId} disabled={credentialDisabled} onChange={(event) => setReuseCredentialId(event.target.value)}>
             <option value="">Create a new credential</option>
             {availableCredentials.map((credential) =>
@@ -1509,13 +1509,13 @@ function ProfileForm({
         {creatingCredential && <div />}
         {!reuseCredentialId &&
         <>
-          <FormField label="Credential name" documentation={MAIL_PROFILE_DOCUMENTATION}>
+          <FormField label="Credential name" documentation={MAIL_PROFILE_DOCUMENTATION} helpContextId="mail.profiles" helpModuleId="mail">
             <input value={draft.credentialName} disabled={credentialDisabled} onChange={(event) => setDraft({ ...draft, credentialName: event.target.value })} />
           </FormField>
           <FormField label="Description">
             <input value={draft.credentialDescription} disabled={credentialDisabled} onChange={(event) => setDraft({ ...draft, credentialDescription: event.target.value })} />
           </FormField>
-          <FormField label="Available to modules" help="Choose installed modules. Keep Mail selected to use this credential here.">
+          <FormField label="Available to modules" help="Choose installed modules. Keep Mail selected to use this credential here." helpContextId="mail.profiles" helpModuleId="mail">
             <ReferenceMultiSelect
               values={commaValues(draft.credentialAllowedModules)}
               onChange={(values) => setDraft({ ...draft, credentialAllowedModules: values.join(", ") })}
@@ -1527,7 +1527,9 @@ function ProfileForm({
           </FormField>
           <FormField
             label="Limited to servers"
-            help="Choose an announced server or enter a module-qualified reference. Leave blank for every permitted server.">
+            help="Choose an announced server or enter a module-qualified reference. Leave blank for every permitted server."
+            helpContextId="mail.profiles"
+            helpModuleId="mail">
             <ReferenceMultiSelect
               values={commaValues(draft.credentialAllowedServerRefs)}
               onChange={(values) => setDraft({ ...draft, credentialAllowedServerRefs: values.join(", ") })}
@@ -1540,6 +1542,8 @@ function ProfileForm({
           </FormField>
           <ToggleSwitch
             checked={draft.credentialIsDefault}
+            helpContextId="mail.profiles"
+            helpModuleId="mail"
             disabled={credentialDisabled}
             onChange={(checked) => setDraft({ ...draft, credentialIsDefault: checked })}
             label={`Default credential for this ${editTarget.protocol.toUpperCase()} server`} />