@praxisui/dialog 9.0.4-rc.36 → 9.0.4-rc.37

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-08T10:35:56.871Z",
+  "generatedAt": "2026-08-09T11:18:35.694Z",
   "packageName": "@praxisui/dialog",
-  "packageVersion": "9.0.4-rc.36",
+  "packageVersion": "9.0.4-rc.37",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,

package/fesm2022/praxisui-dialog.mjs

@@ -1270,6 +1270,68 @@ function resolveParentSurfaceRuntime(context) {
         ? runtime
         : null;
 }
+/**
+ * The action origin is runtime-only: persisted surface payloads remain JSON
+ * safe, while the visual host can return keyboard focus to the invoking
+ * control after the surface terminates.
+ */
+function resolveRuntimeFocusOrigin(context) {
+    const candidate = context?.runtime
+        ?.focusOrigin;
+    return candidate
+        && typeof candidate.focus === 'function'
+        && (candidate.isConnected || !!candidate.getAttribute('data-praxis-focus-key'))
+        ? candidate
+        : null;
+}
+function resolveReplacementFocusOrigin(focusOrigin) {
+    if (focusOrigin.isConnected) {
+        return focusOrigin;
+    }
+    const key = focusOrigin.getAttribute('data-praxis-focus-key');
+    if (!key || typeof document === 'undefined') {
+        return null;
+    }
+    return Array.from(document.querySelectorAll('[data-praxis-focus-key]'))
+        .find((candidate) => candidate.getAttribute('data-praxis-focus-key') === key)
+        ?? null;
+}
+function restoreRuntimeFocusOnClose(closed$, focusOrigin) {
+    if (!focusOrigin || typeof closed$?.subscribe !== 'function')
+        return;
+    closed$.subscribe(() => {
+        const restore = (remainingAttempts) => {
+            const target = resolveReplacementFocusOrigin(focusOrigin);
+            const activeElement = typeof document !== 'undefined' ? document.activeElement : null;
+            const focusWasLostToDocument = activeElement === document.body
+                || activeElement === document.documentElement;
+            const targetAlreadyFocused = activeElement === target;
+            if (target && (focusWasLostToDocument || targetAlreadyFocused)) {
+                try {
+                    target.focus({ preventScroll: true });
+                }
+                catch {
+                    try {
+                        target.focus();
+                    }
+                    catch { }
+                }
+            }
+            if (remainingAttempts > 0
+                && typeof setTimeout !== 'undefined'
+                // A late overlay teardown can return focus to document.body after the
+                // first restore. Keep checking only while focus remains unowned (or
+                // on the restored target); never steal a user-initiated new focus.
+                && (focusWasLostToDocument || targetAlreadyFocused)) {
+                setTimeout(() => restore(remainingAttempts - 1), 50);
+            }
+        };
+        // The host can recreate a responsive control only after its close and
+        // change-detection queue settles. Three seconds is the bounded recovery
+        // window; the loop stops immediately if the user focuses elsewhere.
+        queueMicrotask(() => restore(60));
+    });
+}
 function providePraxisSurfaceGlobalActions() {
     return {
         provide: GLOBAL_SURFACE_SERVICE,
@@ -1283,6 +1345,7 @@ function providePraxisSurfaceGlobalActions() {
             return {
                 open: async (payload, context) => {
                     const materializedPayload = await materializer.materialize(payload, context);
+                    const focusOrigin = resolveRuntimeFocusOrigin(context);
                     if (materializedPayload.presentation === 'drawer') {
                         if (!surfaceDrawer) {
                             throw new Error('Drawer surface service not available');
@@ -1292,6 +1355,7 @@ function providePraxisSurfaceGlobalActions() {
                             title: materializedPayload.title || materializedPayload.widget.id,
                             titleIcon: materializedPayload.icon,
                             subtitle: materializedPayload.subtitle,
+                            ...(focusOrigin ? { returnFocusTo: focusOrigin } : {}),
                             content: {
                                 component: PraxisSurfaceHostComponent,
                                 inputs: buildHostInputs(materializedPayload, context, {
@@ -1334,9 +1398,11 @@ function providePraxisSurfaceGlobalActions() {
                             minHeight: materializedPayload.size?.minHeight,
                             maxHeight: materializedPayload.size?.maxHeight,
                         });
+                        restoreRuntimeFocusOnClose(ref.closed$, focusOrigin);
                         return ref;
                     }
                     const ref = dialog.open(PraxisSurfaceHostComponent, buildDialogConfig(materializedPayload));
+                    restoreRuntimeFocusOnClose(ref.afterClosed(), focusOrigin);
                     const resultSubject = new Subject();
                     let terminalOutcomeEmitted = false;
                     const complete = (outcome) => {

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@praxisui/dialog",
-  "version": "9.0.4-rc.36",
+  "version": "9.0.4-rc.37",
   "description": "Dialog helpers and components for Praxis UI with Angular Material integration.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
-    "@praxisui/core": "^9.0.4-rc.36",
+    "@praxisui/core": "^9.0.4-rc.37",
     "@angular/material": "^21.0.0",
     "@angular/platform-browser": "^21.0.0",
     "rxjs": "~7.8.0"