@owlmeans/web-panel 0.1.18-rc.56 → 0.1.18-rc.58

package/README.md

@@ -11,7 +11,7 @@ but never started.
 ## Installation
 
 ```sh
-bun add @owlmeans/web-panel@^0.1.18-rc.55
+bun add @owlmeans/web-panel@^0.1.18-rc.58
 ```
 
 Peer requirements (the consuming app provides these): `react`, `react-dom`,
@@ -86,7 +86,7 @@ import { commonConfig, MY_APP_WEB } from 'my-app-common'
 import type { Config } from './types.js'
 
 const cfg: Config = config(MY_APP_WEB, commonConfig as Config)
-// Block the screen with a "reload the page" prompt once every socket has given up reconnecting.
+// Block the screen with a "try again / reload the page" prompt once a socket has given up reconnecting.
 cfg.socket = { ...cfg.socket, reloadDialog: true }
 
 export default cfg
@@ -496,7 +496,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.33
+npx @owlmeans/agent-skills@^0.1.18-rc.35
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/web-panel",
-  "version": "0.1.18-rc.56",
-  "generatedAt": "2026-09-22T18:27:08.247Z",
+  "version": "0.1.18-rc.58",
+  "generatedAt": "2026-09-22T21:57:18.836Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/web-panel/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/web-panel
 
 **Layer:** Web (React)
-**Install:** `"@owlmeans/web-panel": "^0.1.18-rc.56"` in `dependencies`
+**Install:** `"@owlmeans/web-panel": "^0.1.18-rc.58"` in `dependencies`
 
 ## Key Exports
 
@@ -19,7 +19,7 @@ user-invocable: false
 | `TopNav` / `SideNav` / `MobileNav` / `Footer` | The shell's pieces, mountable on their own |
 | `Toaster` | The application's toast surface — mounted once, in the layout |
 | `ThemeToggle` / `useColorScheme` | The light/dark switcher (`ThemeToggleProps`, `ThemeToggleLabels`) and the hook behind it (`ColorSchemeModel`) — see *Light and dark* below |
-| `SocketReloadDialog` | The global "reload the page" prompt (opt in via `cfg.socket.reloadDialog`) `PanelApp` mounts automatically — see below. The hook it reads, `useSocketStatus`, is imported from `@owlmeans/client-socket`, not from this package |
+| `SocketReloadDialog` | The global "connection lost — try again / reload" prompt (opt in via `cfg.socket.reloadDialog`) `PanelApp` mounts automatically — see below. The hooks it reads, `useSocketStatus` and `useSocketRetry`, are imported from `@owlmeans/client-socket`, not from this package |
 | `Link` | An `<a>` addressing an entrypoint alias (or a literal `src`), with the label taken from i18n |
 | `LoginScreen` / `LocalizedLoginScreen` / `appendLoginScreen` | The identity-provider choice screen — see `login-methods`. `LoginScreen` is pure w.r.t. `locale` too, exactly like `translate`: it is a prop, defaulting to nothing, never an implicit `useLanguage()` read, because a component that reaches for i18n context directly crashes an app mounted without one. `LocalizedLoginScreen` supplies `useLanguage()`'s value when the caller does not pass its own |
 | `render(context, opts?)` | Mounts the tree inside `PanelApp`, with the browser language detector installed on the i18n instance. `opts` is `RenderOptions` plus `rootClassName` |
@@ -341,12 +341,22 @@ on every navigation. Neither does anything unless an app opts in:
 cfg.socket = { reloadDialog: true }
 ```
 
-Once every `ws()`/`useWs()` connection in the app has exhausted its own retry budget
+Once any `ws()`/`useWs()` connection in the app has exhausted its own retry budget
 (`useSocketStatus() === 'lost'`), a global, blocking `AlertDialog` covers the screen — no Escape,
-no outside click, one action ("Reload page") that calls `window.location.reload()`. There is
-nothing else the budget-exhausted state can resolve into: the aggregate is not released on that
-path (see the `client-socket` skill), so the only way out is the reload. Strings are lib-tier
-(`useI18nLib('socket', 'reload')`), 7 languages, under `src/components/socket/i18n/`.
+no outside click, two actions:
+
+- **"Try again"** (`data-socket-retry-action`) — `useSocketRetry().retry()` revives every lost
+  connection (see the `client-socket` skill). The dialog stays up with the button disabled and
+  reading "Reconnecting…" while they retry, closes once the aggregate is `'online'`, and offers
+  both buttons again if it falls back to `'lost'`.
+- **"Reload page"** (`data-socket-reload-action`) — `window.location.reload()`, the fallback that
+  always works.
+
+The status service also retries by itself when the tab becomes visible, the window gains focus or
+the browser comes back online, so a socket that died in a background tab is usually back before
+anyone presses anything — an open dialog shows "Reconnecting…" through that too. Strings are
+lib-tier (`useI18nLib('socket', 'reload')`: `title`, `description`, `action`, `retry`,
+`retrying`), 8 languages, under `src/components/socket/i18n/`.
 
 Leave `cfg.socket.reloadDialog` unset (or `false`) for an app that would rather show its own
 inline "reconnecting…" state — `useSocketStatus()` from `@owlmeans/client-socket` serves that,
@@ -536,7 +546,7 @@ in a linked workspace, so it is the reliable scan target in both modes.
 ## Depends On
 
 - `@owlmeans/web-client`, `@owlmeans/client-panel`, `@owlmeans/client-i18n`, `@owlmeans/web-router`
-- `@owlmeans/client-socket` — `appendSocketStatus`, `useSocketStatus`, behind `SocketReloadDialog`
+- `@owlmeans/client-socket` — `appendSocketStatus`, `useSocketStatus`, `useSocketRetry`, behind `SocketReloadDialog`
 - Peers (app-provided): `react`, `react-dom`, `react-hook-form`, `tailwindcss`, `tailwind-merge`,
   `clsx`, `class-variance-authority`, `lucide-react`, `ajv`, and the `@radix-ui/react-*` primitives
   (`alert-dialog`, `dialog`, `label`, `navigation-menu`, `progress`, `separator`, `slot`). No MUI,

package/build/components/socket/i18n/be.json

@@ -1,7 +1,9 @@
 {
     "reload": {
         "title": "Злучэнне страчана",
-        "description": "Не ўдалося аднавіць злучэнне пасля некалькіх спробаў. Перазагрузіце старонку, каб працягнуць.",
-        "action": "Перазагрузіць старонку"
+        "description": "Не ўдалося аднавіць злучэнне пасля некалькіх спробаў. Паспрабуйце яшчэ раз або перазагрузіце старонку, каб працягнуць.",
+        "action": "Перазагрузіць старонку",
+        "retry": "Паспрабаваць яшчэ раз",
+        "retrying": "Паўторнае падключэнне…"
     }
 }

package/build/components/socket/i18n/de.json

@@ -1,7 +1,9 @@
 {
     "reload": {
         "title": "Verbindung verloren",
-        "description": "Die Verbindung konnte nach mehreren Versuchen nicht wiederhergestellt werden. Lade die Seite neu, um fortzufahren.",
-        "action": "Seite neu laden"
+        "description": "Die Verbindung konnte nach mehreren Versuchen nicht wiederhergestellt werden. Versuche es erneut oder lade die Seite neu, um fortzufahren.",
+        "action": "Seite neu laden",
+        "retry": "Erneut versuchen",
+        "retrying": "Verbindung wird wiederhergestellt…"
     }
 }

package/build/components/socket/i18n/en.json

@@ -1,7 +1,9 @@
 {
     "reload": {
         "title": "Connection lost",
-        "description": "We couldn't restore the connection after several attempts. Reload the page to continue.",
-        "action": "Reload page"
+        "description": "We couldn't restore the connection after several attempts. Try again, or reload the page to continue.",
+        "action": "Reload page",
+        "retry": "Try again",
+        "retrying": "Reconnecting…"
     }
 }

package/build/components/socket/i18n/es.json

@@ -1,7 +1,9 @@
 {
     "reload": {
         "title": "Conexión perdida",
-        "description": "No se pudo restablecer la conexión tras varios intentos. Recarga la página para continuar.",
-        "action": "Recargar página"
+        "description": "No se pudo restablecer la conexión tras varios intentos. Vuelve a intentarlo o recarga la página para continuar.",
+        "action": "Recargar página",
+        "retry": "Reintentar",
+        "retrying": "Reconectando…"
     }
 }

package/build/components/socket/i18n/fr.json

@@ -1,7 +1,9 @@
 {
     "reload": {
         "title": "Connexion perdue",
-        "description": "Nous n’avons pas pu rétablir la connexion après plusieurs tentatives. Actualisez la page pour continuer.",
-        "action": "Actualiser la page"
+        "description": "Nous n’avons pas pu rétablir la connexion après plusieurs tentatives. Réessayez ou actualisez la page pour continuer.",
+        "action": "Actualiser la page",
+        "retry": "Réessayer",
+        "retrying": "Reconnexion…"
     }
 }

package/build/components/socket/i18n/pl.json

@@ -1,7 +1,9 @@
 {
     "reload": {
         "title": "Utracono połączenie",
-        "description": "Nie udało się przywrócić połączenia mimo kilku prób. Odśwież stronę, aby kontynuować.",
-        "action": "Odśwież stronę"
+        "description": "Nie udało się przywrócić połączenia mimo kilku prób. Spróbuj ponownie lub odśwież stronę, aby kontynuować.",
+        "action": "Odśwież stronę",
+        "retry": "Spróbuj ponownie",
+        "retrying": "Ponowne łączenie…"
     }
 }

package/build/components/socket/i18n/ru.json

@@ -1,7 +1,9 @@
 {
     "reload": {
         "title": "Соединение потеряно",
-        "description": "Не удалось восстановить соединение после нескольких попыток. Перезагрузите страницу, чтобы продолжить.",
-        "action": "Перезагрузить страницу"
+        "description": "Не удалось восстановить соединение после нескольких попыток. Попробуйте снова или перезагрузите страницу, чтобы продолжить.",
+        "action": "Перезагрузить страницу",
+        "retry": "Попробовать снова",
+        "retrying": "Переподключение…"
     }
 }

package/build/components/socket/i18n/uk.json

@@ -1,7 +1,9 @@
 {
     "reload": {
         "title": "З'єднання втрачено",
-        "description": "Не вдалося відновити з'єднання після кількох спроб. Перезавантажте сторінку, щоб продовжити.",
-        "action": "Перезавантажити сторінку"
+        "description": "Не вдалося відновити з'єднання після кількох спроб. Спробуйте ще раз або перезавантажте сторінку, щоб продовжити.",
+        "action": "Перезавантажити сторінку",
+        "retry": "Спробувати ще раз",
+        "retrying": "Перепідключення…"
     }
 }

package/build/components/socket/reload-dialog.d.ts

@@ -1,13 +1,17 @@
 import type { FC } from 'react';
 /**
- * A global, blocking "reload the page" prompt — opt in per app with `cfg.socket.reloadDialog`.
+ * A global, blocking "connection lost" prompt — opt in per app with `cfg.socket.reloadDialog`.
  *
  * Mount it once, above the router (`PanelApp` does), exactly like `PanelCookieConsent`: a dialog
  * mounted inside a route is torn down on every navigation, and this one is meant to survive them
  * all. It opens the moment `useSocketStatus()` reports `'lost'` — every `ws()`/`useWs()`
- * connection in the app has exhausted its own retry budget (10 minutes by default) — and it never
- * closes on its own: there is nothing left retrying that a countdown or a poll could wait out, so
- * the only exit this dialog offers is the one that actually fixes it.
+ * connection in the app has exhausted its own retry budget (10 minutes by default).
+ *
+ * Two exits: "Try again" revives every lost connection (`useSocketRetry()`), and the dialog stays
+ * up showing progress until they are back online — or offers both buttons again if they are lost
+ * again. "Reload page" is the fallback that always works. The status service also retries by
+ * itself when the tab or window becomes active, so a socket that died in a background tab is
+ * usually back before anyone has to press anything.
  *
  * Non-dismissible on two levels: Radix's `AlertDialogContent` (unlike its plain `Dialog` sibling)
  * never treats an outside click as a request to close, so there is no `onPointerDownOutside` to

package/build/components/socket/reload-dialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reload-dialog.d.ts","sourceRoot":"","sources":["../../../src/components/socket/reload-dialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAA;AAQ/B;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB,EAAE,EAqBhC,CAAA"}
+{"version":3,"file":"reload-dialog.d.ts","sourceRoot":"","sources":["../../../src/components/socket/reload-dialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAA;AAS/B;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,kBAAkB,EAAE,EAgChC,CAAA"}

package/build/components/socket/reload-dialog.js

@@ -1,16 +1,21 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useSocketStatus } from '@owlmeans/client-socket';
+import { useSocketRetry, useSocketStatus } from '@owlmeans/client-socket';
 import { useI18nLib } from '@owlmeans/client-i18n';
 import { AlertDialog, AlertDialogAction, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle } from '../../@/components/ui/alert-dialog.js';
+import { Button } from '../../@/components/ui/button.js';
 /**
- * A global, blocking "reload the page" prompt — opt in per app with `cfg.socket.reloadDialog`.
+ * A global, blocking "connection lost" prompt — opt in per app with `cfg.socket.reloadDialog`.
  *
  * Mount it once, above the router (`PanelApp` does), exactly like `PanelCookieConsent`: a dialog
  * mounted inside a route is torn down on every navigation, and this one is meant to survive them
  * all. It opens the moment `useSocketStatus()` reports `'lost'` — every `ws()`/`useWs()`
- * connection in the app has exhausted its own retry budget (10 minutes by default) — and it never
- * closes on its own: there is nothing left retrying that a countdown or a poll could wait out, so
- * the only exit this dialog offers is the one that actually fixes it.
+ * connection in the app has exhausted its own retry budget (10 minutes by default).
+ *
+ * Two exits: "Try again" revives every lost connection (`useSocketRetry()`), and the dialog stays
+ * up showing progress until they are back online — or offers both buttons again if they are lost
+ * again. "Reload page" is the fallback that always works. The status service also retries by
+ * itself when the tab or window becomes active, so a socket that died in a background tab is
+ * usually back before anyone has to press anything.
  *
  * Non-dismissible on two levels: Radix's `AlertDialogContent` (unlike its plain `Dialog` sibling)
  * never treats an outside click as a request to close, so there is no `onPointerDownOutside` to
@@ -19,8 +24,11 @@ import { AlertDialog, AlertDialogAction, AlertDialogContent, AlertDialogDescript
  */
 export const SocketReloadDialog = () => {
     const status = useSocketStatus();
+    const { retry, retrying } = useSocketRetry();
     const t = useI18nLib('socket', 'reload');
-    const open = status === 'lost';
-    return _jsx(AlertDialog, { open: open, children: _jsxs(AlertDialogContent, { "data-socket-reload-dialog": true, onEscapeKeyDown: event => event.preventDefault(), children: [_jsxs(AlertDialogHeader, { children: [_jsx(AlertDialogTitle, { children: t('title') }), _jsx(AlertDialogDescription, { children: t('description') })] }), _jsx(AlertDialogFooter, { children: _jsx(AlertDialogAction, { "data-socket-reload-action": true, onClick: () => window.location.reload(), children: t('action') }) })] }) });
+    const open = status === 'lost' || (retrying && status === 'reconnecting');
+    // Closing still animates the content out — keep the retry in its busy state until it is gone.
+    const busy = retrying || !open;
+    return _jsx(AlertDialog, { open: open, children: _jsxs(AlertDialogContent, { "data-socket-reload-dialog": true, onEscapeKeyDown: event => event.preventDefault(), children: [_jsxs(AlertDialogHeader, { children: [_jsx(AlertDialogTitle, { children: t('title') }), _jsx(AlertDialogDescription, { children: t('description') })] }), _jsxs(AlertDialogFooter, { children: [_jsx(Button, { variant: "outline", "data-socket-reload-action": true, onClick: () => window.location.reload(), children: t('action') }), _jsx(AlertDialogAction, { "data-socket-retry-action": true, disabled: busy, "aria-busy": busy, onClick: retry, children: busy ? t('retrying') : t('retry') })] })] }) });
 };
 //# sourceMappingURL=reload-dialog.js.map

package/build/components/socket/reload-dialog.js.map

@@ -1 +1 @@
-{"version":3,"file":"reload-dialog.js","sourceRoot":"","sources":["../../../src/components/socket/reload-dialog.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EACL,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,sBAAsB,EAC1E,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EACvD,MAAM,uCAAuC,CAAA;AAE9C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAO,GAAG,EAAE;IACzC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;IAChC,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACxC,MAAM,IAAI,GAAG,MAAM,KAAK,MAAM,CAAA;IAE9B,OAAO,KAAC,WAAW,IAAC,IAAI,EAAE,IAAI,YAC5B,MAAC,kBAAkB,uCAEjB,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,aAEhD,MAAC,iBAAiB,eAChB,KAAC,gBAAgB,cAAE,CAAC,CAAC,OAAO,CAAC,GAAoB,EACjD,KAAC,sBAAsB,cAAE,CAAC,CAAC,aAAa,CAAC,GAA0B,IACjD,EACpB,KAAC,iBAAiB,cAChB,KAAC,iBAAiB,uCAA2B,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,YACjF,CAAC,CAAC,QAAQ,CAAC,GACM,GACF,IACD,GACT,CAAA;AAChB,CAAC,CAAA"}
+{"version":3,"file":"reload-dialog.js","sourceRoot":"","sources":["../../../src/components/socket/reload-dialog.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EACL,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,sBAAsB,EAC1E,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EACvD,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAA;AAExD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAO,GAAG,EAAE;IACzC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;IAChC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE,CAAA;IAC5C,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACxC,MAAM,IAAI,GAAG,MAAM,KAAK,MAAM,IAAI,CAAC,QAAQ,IAAI,MAAM,KAAK,cAAc,CAAC,CAAA;IACzE,8FAA8F;IAC9F,MAAM,IAAI,GAAG,QAAQ,IAAI,CAAC,IAAI,CAAA;IAE9B,OAAO,KAAC,WAAW,IAAC,IAAI,EAAE,IAAI,YAC5B,MAAC,kBAAkB,uCAEjB,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,aAEhD,MAAC,iBAAiB,eAChB,KAAC,gBAAgB,cAAE,CAAC,CAAC,OAAO,CAAC,GAAoB,EACjD,KAAC,sBAAsB,cAAE,CAAC,CAAC,aAAa,CAAC,GAA0B,IACjD,EACpB,MAAC,iBAAiB,eAChB,KAAC,MAAM,IAAC,OAAO,EAAC,SAAS,qCAA2B,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,YACxF,CAAC,CAAC,QAAQ,CAAC,GACL,EACT,KAAC,iBAAiB,sCAEhB,QAAQ,EAAE,IAAI,eACH,IAAI,EACf,OAAO,EAAE,KAAK,YAEb,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAChB,IACF,IACD,GACT,CAAA;AAChB,CAAC,CAAA"}

package/build/types.d.ts

@@ -5,7 +5,7 @@ import type { SocketClientSettings, SocketStatusServiceAppend } from '@owlmeans/
 export interface AppConfig extends Config, WithFlowConfig {
     socket?: SocketClientSettings & {
         /**
-         * Show `SocketReloadDialog` — a global, blocking "reload the page" prompt — once every
+         * Show `SocketReloadDialog` — a global, blocking "try again / reload the page" prompt — once every
          * socket in the app has given up reconnecting (`useSocketStatus() === 'lost'`). Off by
          * default: an app opts in once it has decided that outcome deserves a full-page prompt
          * rather than the caller's own fallback UI.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/web-panel",
-  "version": "0.1.18-rc.56",
+  "version": "0.1.18-rc.58",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -51,33 +51,33 @@
   },
   "dependencies": {
     "@hookform/resolvers": "^5.2.2",
-    "@owlmeans/api-config-client": "^0.1.18-rc.31",
-    "@owlmeans/auth": "^0.1.18-rc.31",
-    "@owlmeans/auth-common": "^0.1.18-rc.33",
-    "@owlmeans/basic-envelope": "^0.1.18-rc.32",
-    "@owlmeans/client": "^0.1.18-rc.36",
-    "@owlmeans/client-auth": "^0.1.18-rc.43",
-    "@owlmeans/client-config": "^0.1.18-rc.33",
-    "@owlmeans/client-context": "^0.1.18-rc.34",
-    "@owlmeans/client-entrypoint": "^0.1.18-rc.33",
-    "@owlmeans/client-flow": "^0.1.18-rc.39",
-    "@owlmeans/client-i18n": "^0.1.18-rc.35",
-    "@owlmeans/client-panel": "^0.1.18-rc.43",
-    "@owlmeans/client-route": "^0.1.18-rc.34",
-    "@owlmeans/client-socket": "^0.1.18-rc.34",
-    "@owlmeans/config": "^0.1.18-rc.33",
-    "@owlmeans/context": "^0.1.18-rc.29",
-    "@owlmeans/entrypoint": "^0.1.18-rc.32",
-    "@owlmeans/error": "^0.1.18-rc.31",
-    "@owlmeans/flow": "^0.1.18-rc.34",
-    "@owlmeans/i18n": "^0.1.18-rc.32",
-    "@owlmeans/route": "^0.1.18-rc.30",
-    "@owlmeans/state": "^0.1.18-rc.30",
-    "@owlmeans/web-client": "^0.1.18-rc.46",
-    "@owlmeans/web-consent": "^0.1.18-rc.27",
-    "@owlmeans/web-db": "^0.1.18-rc.34",
-    "@owlmeans/web-flow": "^0.1.18-rc.38",
-    "@owlmeans/web-router": "^0.1.18-rc.34",
+    "@owlmeans/api-config-client": "^0.1.18-rc.33",
+    "@owlmeans/auth": "^0.1.18-rc.33",
+    "@owlmeans/auth-common": "^0.1.18-rc.35",
+    "@owlmeans/basic-envelope": "^0.1.18-rc.34",
+    "@owlmeans/client": "^0.1.18-rc.38",
+    "@owlmeans/client-auth": "^0.1.18-rc.45",
+    "@owlmeans/client-config": "^0.1.18-rc.35",
+    "@owlmeans/client-context": "^0.1.18-rc.36",
+    "@owlmeans/client-entrypoint": "^0.1.18-rc.35",
+    "@owlmeans/client-flow": "^0.1.18-rc.41",
+    "@owlmeans/client-i18n": "^0.1.18-rc.37",
+    "@owlmeans/client-panel": "^0.1.18-rc.45",
+    "@owlmeans/client-route": "^0.1.18-rc.36",
+    "@owlmeans/client-socket": "^0.1.18-rc.36",
+    "@owlmeans/config": "^0.1.18-rc.35",
+    "@owlmeans/context": "^0.1.18-rc.31",
+    "@owlmeans/entrypoint": "^0.1.18-rc.34",
+    "@owlmeans/error": "^0.1.18-rc.33",
+    "@owlmeans/flow": "^0.1.18-rc.36",
+    "@owlmeans/i18n": "^0.1.18-rc.34",
+    "@owlmeans/route": "^0.1.18-rc.32",
+    "@owlmeans/state": "^0.1.18-rc.32",
+    "@owlmeans/web-client": "^0.1.18-rc.48",
+    "@owlmeans/web-consent": "^0.1.18-rc.29",
+    "@owlmeans/web-db": "^0.1.18-rc.36",
+    "@owlmeans/web-flow": "^0.1.18-rc.40",
+    "@owlmeans/web-router": "^0.1.18-rc.36",
     "i18next-browser-languagedetector": "^8.0.0",
     "qrcode.react": "^4.2.0",
     "react-google-recaptcha": "^3.1.0",
@@ -103,7 +103,7 @@
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@owlmeans/test-ui": "^0.1.18-rc.34",
+    "@owlmeans/test-ui": "^0.1.18-rc.36",
     "@radix-ui/react-alert-dialog": "^1.1.15",
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-label": "^2.1.0",

package/src/components/socket/i18n/be.json

@@ -1,7 +1,9 @@
 {
   "reload": {
     "title": "Злучэнне страчана",
-    "description": "Не ўдалося аднавіць злучэнне пасля некалькіх спробаў. Перазагрузіце старонку, каб працягнуць.",
-    "action": "Перазагрузіць старонку"
+    "description": "Не ўдалося аднавіць злучэнне пасля некалькіх спробаў. Паспрабуйце яшчэ раз або перазагрузіце старонку, каб працягнуць.",
+    "action": "Перазагрузіць старонку",
+    "retry": "Паспрабаваць яшчэ раз",
+    "retrying": "Паўторнае падключэнне…"
   }
 }

package/src/components/socket/i18n/de.json

@@ -1,7 +1,9 @@
 {
   "reload": {
     "title": "Verbindung verloren",
-    "description": "Die Verbindung konnte nach mehreren Versuchen nicht wiederhergestellt werden. Lade die Seite neu, um fortzufahren.",
-    "action": "Seite neu laden"
+    "description": "Die Verbindung konnte nach mehreren Versuchen nicht wiederhergestellt werden. Versuche es erneut oder lade die Seite neu, um fortzufahren.",
+    "action": "Seite neu laden",
+    "retry": "Erneut versuchen",
+    "retrying": "Verbindung wird wiederhergestellt…"
   }
 }

package/src/components/socket/i18n/en.json

@@ -1,7 +1,9 @@
 {
   "reload": {
     "title": "Connection lost",
-    "description": "We couldn't restore the connection after several attempts. Reload the page to continue.",
-    "action": "Reload page"
+    "description": "We couldn't restore the connection after several attempts. Try again, or reload the page to continue.",
+    "action": "Reload page",
+    "retry": "Try again",
+    "retrying": "Reconnecting…"
   }
 }

package/src/components/socket/i18n/es.json

@@ -1,7 +1,9 @@
 {
   "reload": {
     "title": "Conexión perdida",
-    "description": "No se pudo restablecer la conexión tras varios intentos. Recarga la página para continuar.",
-    "action": "Recargar página"
+    "description": "No se pudo restablecer la conexión tras varios intentos. Vuelve a intentarlo o recarga la página para continuar.",
+    "action": "Recargar página",
+    "retry": "Reintentar",
+    "retrying": "Reconectando…"
   }
 }

package/src/components/socket/i18n/fr.json

@@ -1,7 +1,9 @@
 {
   "reload": {
     "title": "Connexion perdue",
-    "description": "Nous n’avons pas pu rétablir la connexion après plusieurs tentatives. Actualisez la page pour continuer.",
-    "action": "Actualiser la page"
+    "description": "Nous n’avons pas pu rétablir la connexion après plusieurs tentatives. Réessayez ou actualisez la page pour continuer.",
+    "action": "Actualiser la page",
+    "retry": "Réessayer",
+    "retrying": "Reconnexion…"
   }
 }

package/src/components/socket/i18n/pl.json

@@ -1,7 +1,9 @@
 {
   "reload": {
     "title": "Utracono połączenie",
-    "description": "Nie udało się przywrócić połączenia mimo kilku prób. Odśwież stronę, aby kontynuować.",
-    "action": "Odśwież stronę"
+    "description": "Nie udało się przywrócić połączenia mimo kilku prób. Spróbuj ponownie lub odśwież stronę, aby kontynuować.",
+    "action": "Odśwież stronę",
+    "retry": "Spróbuj ponownie",
+    "retrying": "Ponowne łączenie…"
   }
 }

package/src/components/socket/i18n/ru.json

@@ -1,7 +1,9 @@
 {
   "reload": {
     "title": "Соединение потеряно",
-    "description": "Не удалось восстановить соединение после нескольких попыток. Перезагрузите страницу, чтобы продолжить.",
-    "action": "Перезагрузить страницу"
+    "description": "Не удалось восстановить соединение после нескольких попыток. Попробуйте снова или перезагрузите страницу, чтобы продолжить.",
+    "action": "Перезагрузить страницу",
+    "retry": "Попробовать снова",
+    "retrying": "Переподключение…"
   }
 }

package/src/components/socket/i18n/uk.json

@@ -1,7 +1,9 @@
 {
   "reload": {
     "title": "З'єднання втрачено",
-    "description": "Не вдалося відновити з'єднання після кількох спроб. Перезавантажте сторінку, щоб продовжити.",
-    "action": "Перезавантажити сторінку"
+    "description": "Не вдалося відновити з'єднання після кількох спроб. Спробуйте ще раз або перезавантажте сторінку, щоб продовжити.",
+    "action": "Перезавантажити сторінку",
+    "retry": "Спробувати ще раз",
+    "retrying": "Перепідключення…"
   }
 }

package/src/components/socket/reload-dialog.tsx

@@ -1,20 +1,25 @@
 import type { FC } from 'react'
-import { useSocketStatus } from '@owlmeans/client-socket'
+import { useSocketRetry, useSocketStatus } from '@owlmeans/client-socket'
 import { useI18nLib } from '@owlmeans/client-i18n'
 import {
   AlertDialog, AlertDialogAction, AlertDialogContent, AlertDialogDescription,
   AlertDialogFooter, AlertDialogHeader, AlertDialogTitle
 } from '../../@/components/ui/alert-dialog.js'
+import { Button } from '../../@/components/ui/button.js'
 
 /**
- * A global, blocking "reload the page" prompt — opt in per app with `cfg.socket.reloadDialog`.
+ * A global, blocking "connection lost" prompt — opt in per app with `cfg.socket.reloadDialog`.
  *
  * Mount it once, above the router (`PanelApp` does), exactly like `PanelCookieConsent`: a dialog
  * mounted inside a route is torn down on every navigation, and this one is meant to survive them
  * all. It opens the moment `useSocketStatus()` reports `'lost'` — every `ws()`/`useWs()`
- * connection in the app has exhausted its own retry budget (10 minutes by default) — and it never
- * closes on its own: there is nothing left retrying that a countdown or a poll could wait out, so
- * the only exit this dialog offers is the one that actually fixes it.
+ * connection in the app has exhausted its own retry budget (10 minutes by default).
+ *
+ * Two exits: "Try again" revives every lost connection (`useSocketRetry()`), and the dialog stays
+ * up showing progress until they are back online — or offers both buttons again if they are lost
+ * again. "Reload page" is the fallback that always works. The status service also retries by
+ * itself when the tab or window becomes active, so a socket that died in a background tab is
+ * usually back before anyone has to press anything.
  *
  * Non-dismissible on two levels: Radix's `AlertDialogContent` (unlike its plain `Dialog` sibling)
  * never treats an outside click as a request to close, so there is no `onPointerDownOutside` to
@@ -23,8 +28,11 @@ import {
  */
 export const SocketReloadDialog: FC = () => {
   const status = useSocketStatus()
+  const { retry, retrying } = useSocketRetry()
   const t = useI18nLib('socket', 'reload')
-  const open = status === 'lost'
+  const open = status === 'lost' || (retrying && status === 'reconnecting')
+  // Closing still animates the content out — keep the retry in its busy state until it is gone.
+  const busy = retrying || !open
 
   return <AlertDialog open={open}>
     <AlertDialogContent
@@ -36,8 +44,16 @@ export const SocketReloadDialog: FC = () => {
         <AlertDialogDescription>{t('description')}</AlertDialogDescription>
       </AlertDialogHeader>
       <AlertDialogFooter>
-        <AlertDialogAction data-socket-reload-action onClick={() => window.location.reload()}>
+        <Button variant="outline" data-socket-reload-action onClick={() => window.location.reload()}>
           {t('action')}
+        </Button>
+        <AlertDialogAction
+          data-socket-retry-action
+          disabled={busy}
+          aria-busy={busy}
+          onClick={retry}
+        >
+          {busy ? t('retrying') : t('retry')}
         </AlertDialogAction>
       </AlertDialogFooter>
     </AlertDialogContent>

package/src/types.ts

@@ -7,7 +7,7 @@ import type { SocketClientSettings, SocketStatusServiceAppend } from '@owlmeans/
 export interface AppConfig extends Config, WithFlowConfig {
   socket?: SocketClientSettings & {
     /**
-     * Show `SocketReloadDialog` — a global, blocking "reload the page" prompt — once every
+     * Show `SocketReloadDialog` — a global, blocking "try again / reload the page" prompt — once every
      * socket in the app has given up reconnecting (`useSocketStatus() === 'lost'`). Off by
      * default: an app opts in once it has decided that outcome deserves a full-page prompt
      * rather than the caller's own fallback UI.

package/tests/harness/mount.tsx

@@ -1,6 +1,7 @@
 import '../../src/@/globals.css'
 
 import type { FC, PropsWithChildren } from 'react'
+import { useState } from 'react'
 import { createRoot } from 'react-dom/client'
 import { config } from '@owlmeans/client-context'
 import { AppType, service } from '@owlmeans/config'
@@ -184,12 +185,23 @@ const ReportsGroup: FC<PropsWithChildren> = ({ children }) => <div id="reports-g
  */
 const SocketStatusScreen: FC = () => {
   const context = useContext()
+  // A revive the way a real carrier's goes: the connection is retrying again the moment it is
+  // asked to. How that retry ends is up to the test — `#report-online` or `#report-lost`.
+  const [revived, setRevived] = useState(0)
+  const reportLost = () => context.socketStatus().report(HARNESS_SOCKET_ID, 'lost', () => {
+    setRevived(n => n + 1)
+    context.socketStatus().report(HARNESS_SOCKET_ID, 'reconnecting')
+  })
 
   return <div id="socket-status">
     socket-status-screen
-    <button id="report-lost" onClick={() => context.socketStatus().report(HARNESS_SOCKET_ID, 'lost')}>
+    <span id="revived">{revived}</span>
+    <button id="report-lost" onClick={reportLost}>
       lose connection
     </button>
+    <button id="report-online" onClick={() => context.socketStatus().report(HARNESS_SOCKET_ID, 'online')}>
+      reconnected
+    </button>
     <button id="release-lost" onClick={() => context.socketStatus().release(HARNESS_SOCKET_ID)}>
       restore connection
     </button>

package/tests/socket-dialog.spec.ts

@@ -11,6 +11,19 @@ afterAll(async () => {
 
 const open = async (path: string) => mountComponent({ url: `${HARNESS_URL.replace(/\/$/, '')}${path}` })
 
+type Page = Awaited<ReturnType<typeof open>>['page']
+
+// The modal overlay covers the harness buttons and would take a pointer click itself.
+const clickBehindDialog = async (page: Page, selector: string) =>
+  page.evaluate(sel => document.querySelector<HTMLButtonElement>(sel)?.click(), selector)
+
+const revivedCount = async (page: Page, count: number) =>
+  page.waitForFunction(n => document.querySelector('#revived')?.textContent === String(n), count)
+
+const retryDisabled = async (page: Page, disabled: boolean) => page.waitForFunction(
+  d => document.querySelector<HTMLButtonElement>('[data-socket-retry-action]')?.disabled === d, disabled
+)
+
 describe('@owlmeans/web-panel — the socket reload dialog', () => {
   test('stays unmounted until the connection is reported lost', async () => {
     const { page, close } = await open('/socket')
@@ -38,6 +51,13 @@ describe('@owlmeans/web-panel — the socket reload dialog', () => {
       await page.mouse.click(2, 2)
       expect(await dialog.isVisible()).toBe(true)
 
+      // The secondary button's label must be readable, not the primary's text on an outline fill.
+      const reloadColors = await page.locator('[data-socket-reload-action]').evaluate(el => {
+        const style = getComputedStyle(el)
+        return { color: style.color, background: style.backgroundColor }
+      })
+      expect(reloadColors.color).not.toBe(reloadColors.background)
+
       const [navigated] = await Promise.all([
         page.waitForEvent('load'),
         page.locator('[data-socket-reload-action]').click(),
@@ -53,6 +73,71 @@ describe('@owlmeans/web-panel — the socket reload dialog', () => {
     }
   }, TIMEOUT)
 
+  test('Try again revives the lost connection, shows progress, and closes once it is back', async () => {
+    const { page, close } = await open('/socket')
+    try {
+      await page.waitForSelector('#socket-status')
+      await page.locator('#report-lost').click()
+
+      const dialog = page.locator('[data-socket-reload-dialog]')
+      const retry = page.locator('[data-socket-retry-action]')
+      await dialog.waitFor({ state: 'visible' })
+      expect(await retry.isEnabled()).toBe(true)
+
+      await retry.click()
+      await revivedCount(page, 1)
+      await retryDisabled(page, true)
+      // Still up while the revived connection is retrying — closing now would read as "fixed".
+      expect(await dialog.isVisible()).toBe(true)
+      expect(await retry.getAttribute('aria-busy')).toBe('true')
+
+      await clickBehindDialog(page, '#report-online')
+      await dialog.waitFor({ state: 'detached' })
+    } finally {
+      await close()
+    }
+  }, TIMEOUT)
+
+  test('a retry that fails again offers both buttons again', async () => {
+    const { page, close } = await open('/socket')
+    try {
+      await page.waitForSelector('#socket-status')
+      await page.locator('#report-lost').click()
+      const retry = page.locator('[data-socket-retry-action]')
+      await retry.click()
+      await retryDisabled(page, true)
+
+      await clickBehindDialog(page, '#report-lost')
+      await retryDisabled(page, false)
+      expect(await page.locator('[data-socket-reload-dialog]').isVisible()).toBe(true)
+    } finally {
+      await close()
+    }
+  }, TIMEOUT)
+
+  test('retries on its own when the tab or window becomes active again', async () => {
+    const { page, close } = await open('/socket')
+    try {
+      await page.waitForSelector('#socket-status')
+      await page.locator('#report-lost').click()
+      await page.locator('[data-socket-reload-dialog]').waitFor({ state: 'visible' })
+
+      await page.evaluate(() => document.dispatchEvent(new Event('visibilitychange')))
+      await revivedCount(page, 1)
+
+      // Nothing is lost any more, so a second activation has nothing to revive.
+      await page.evaluate(() => window.dispatchEvent(new Event('focus')))
+      await page.waitForTimeout(100)
+      expect(await page.locator('#revived').textContent()).toBe('1')
+
+      await clickBehindDialog(page, '#report-lost')
+      await page.evaluate(() => window.dispatchEvent(new Event('focus')))
+      await revivedCount(page, 2)
+    } finally {
+      await close()
+    }
+  }, TIMEOUT)
+
   test('never mounts when the app has not opted in via cfg.socket.reloadDialog', async () => {
     const { page, close } = await open('/socket?reloadDialog=0')
     try {