@dxos/plugin-simple-layout 0.0.0 → 0.8.4-main.69d29f4

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@dxos/plugin-simple-layout",
-  "version": "0.0.0",
+  "version": "0.8.4-main.69d29f4",
   "description": "Simple layout plugin for minimal UI contexts like popover windows.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dxos/dxos"
+  },
   "license": "MIT",
   "author": "DXOS.org",
   "sideEffects": true,
@@ -22,20 +26,20 @@
     "src"
   ],
   "dependencies": {
-    "@preact-signals/safe-react": "^0.9.0",
+    "@effect-atom/atom": "^0.4.13",
+    "@effect-atom/atom-react": "^0.4.6",
     "@radix-ui/react-context": "1.1.1",
-    "@dxos/app-framework": "0.8.3",
-    "@dxos/log": "0.8.3",
-    "@dxos/react-ui-menu": "0.8.3",
-    "@dxos/live-object": "0.8.3",
-    "@dxos/plugin-graph": "0.8.3",
-    "@dxos/operation": "0.0.0",
-    "@dxos/react-ui-searchlist": "0.8.3",
-    "@dxos/schema": "0.8.3",
-    "@dxos/react-ui-attention": "0.8.3",
-    "@dxos/react-ui-stack": "0.8.3",
-    "@dxos/util": "0.8.3",
-    "@dxos/react-ui-mosaic": "0.8.3"
+    "@dxos/log": "0.8.4-main.69d29f4",
+    "@dxos/app-framework": "0.8.4-main.69d29f4",
+    "@dxos/operation": "0.8.4-main.69d29f4",
+    "@dxos/plugin-graph": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-menu": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-mosaic": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-attention": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-searchlist": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-stack": "0.8.4-main.69d29f4",
+    "@dxos/schema": "0.8.4-main.69d29f4",
+    "@dxos/util": "0.8.4-main.69d29f4"
   },
   "devDependencies": {
     "@types/react": "~19.2.7",
@@ -44,21 +48,22 @@
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
     "vite": "7.1.9",
-    "@dxos/echo-signals": "0.8.3",
-    "@dxos/plugin-search": "0.8.3",
-    "@dxos/plugin-client": "0.8.3",
-    "@dxos/plugin-space": "0.8.3",
-    "@dxos/plugin-testing": "0.0.0",
-    "@dxos/ui-theme": "0.0.0",
-    "@dxos/react-ui": "0.8.3",
-    "@dxos/storybook-utils": "0.8.3"
+    "@dxos/plugin-client": "0.8.4-main.69d29f4",
+    "@dxos/plugin-preview": "0.8.4-main.69d29f4",
+    "@dxos/plugin-search": "0.8.4-main.69d29f4",
+    "@dxos/plugin-space": "0.8.4-main.69d29f4",
+    "@dxos/react-ui": "0.8.4-main.69d29f4",
+    "@dxos/plugin-testing": "0.8.4-main.69d29f4",
+    "@dxos/schema": "0.8.4-main.69d29f4",
+    "@dxos/storybook-utils": "0.8.4-main.69d29f4",
+    "@dxos/ui-theme": "0.8.4-main.69d29f4"
   },
   "peerDependencies": {
     "effect": "3.19.11",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "@dxos/react-ui": "0.8.3",
-    "@dxos/ui-theme": "0.0.0"
+    "@dxos/react-ui": "0.8.4-main.69d29f4",
+    "@dxos/ui-theme": "0.8.4-main.69d29f4"
   },
   "publishConfig": {
     "access": "public"

package/src/SimpleLayoutPlugin.ts

@@ -2,11 +2,12 @@
 // Copyright 2025 DXOS.org
 //
 
-import { Capability, Common, Plugin } from '@dxos/app-framework';
+import { ActivationEvent, Capability, Common, Plugin } from '@dxos/app-framework';
 
-import { OperationResolver, ReactRoot, type SimpleLayoutStateOptions, State } from './capabilities';
+import { OperationResolver, ReactRoot, ReactSurface, SpotlightDismiss, State, UrlHandler } from './capabilities';
 import { meta } from './meta';
 import { translations } from './translations';
+import { SimpleLayoutEvents } from './types';
 
 export type SimpleLayoutPluginOptions = {
   /** Whether running in popover window context (hides mobile-specific UI). */
@@ -17,14 +18,29 @@ export const SimpleLayoutPlugin = Plugin.define<SimpleLayoutPluginOptions>(meta)
   Plugin.addModule(({ isPopover = false }) => ({
     id: Capability.getModuleTag(State),
     activatesOn: Common.ActivationEvent.Startup,
-    activatesAfter: [Common.ActivationEvent.LayoutReady],
-    activate: () => State({ initialState: { isPopover } } satisfies SimpleLayoutStateOptions),
+    activatesAfter: [SimpleLayoutEvents.StateReady, Common.ActivationEvent.LayoutReady],
+    activate: () => State({ initialState: { isPopover } }),
+  })),
+  Plugin.addModule(({ isPopover = false }) => ({
+    id: Capability.getModuleTag(SpotlightDismiss),
+    activatesOn: Common.ActivationEvent.Startup,
+    activate: () => SpotlightDismiss({ isPopover }),
   })),
   Plugin.addModule({
     id: Capability.getModuleTag(ReactRoot),
     activatesOn: Common.ActivationEvent.Startup,
     activate: ReactRoot,
   }),
+  Plugin.addModule({
+    id: Capability.getModuleTag(ReactSurface),
+    activatesOn: Common.ActivationEvent.Startup,
+    activate: ReactSurface,
+  }),
+  Plugin.addModule({
+    id: Capability.getModuleTag(UrlHandler),
+    activatesOn: ActivationEvent.allOf(Common.ActivationEvent.OperationInvokerReady, SimpleLayoutEvents.StateReady),
+    activate: UrlHandler,
+  }),
   Common.Plugin.addOperationResolverModule({ activate: OperationResolver }),
   Common.Plugin.addTranslationsModule({ translations }),
   Plugin.make,

package/src/capabilities/index.ts

@@ -4,4 +4,7 @@
 
 export * from './operation-resolver';
 export * from './react-root';
+export * from './react-surface';
+export * from './spotlight-dismiss';
 export * from './state';
+export * from './url-handler';

package/src/capabilities/operation-resolver/operation-resolver.ts

@@ -7,10 +7,21 @@ import * as Effect from 'effect/Effect';
 import { Capability, Common } from '@dxos/app-framework';
 import { Operation, OperationResolver } from '@dxos/operation';
 
-import { SimpleLayoutState } from '../../types';
+import { type SimpleLayoutState, SimpleLayoutState as SimpleLayoutStateCapability } from '../../types';
+
+/** Maximum number of items to keep in navigation history. */
+const MAX_HISTORY_LENGTH = 50;
 
 export default Capability.makeModule(
   Effect.fnUntraced(function* () {
+    const registry = yield* Capability.get(Common.Capability.AtomRegistry);
+    const stateAtom = yield* Capability.get(SimpleLayoutStateCapability);
+
+    const getState = () => registry.get(stateAtom);
+    const updateState = (fn: (current: SimpleLayoutState) => SimpleLayoutState) => {
+      registry.set(stateAtom, fn(getState()));
+    };
+
     return Capability.contributes(Common.Capability.OperationResolver, [
       //
       // UpdateSidebar - No-op for simple layout.
@@ -34,13 +45,15 @@ export default Capability.makeModule(
       OperationResolver.make({
         operation: Common.LayoutOperation.UpdateDialog,
         handler: Effect.fnUntraced(function* (input) {
-          const layout = yield* Capability.get(SimpleLayoutState);
-          layout.dialogOpen = input.state ?? Boolean(input.subject);
-          layout.dialogType = input.type ?? 'default';
-          layout.dialogBlockAlign = input.blockAlign ?? 'center';
-          layout.dialogOverlayClasses = input.overlayClasses;
-          layout.dialogOverlayStyle = input.overlayStyle;
-          layout.dialogContent = input.subject ? { component: input.subject, props: input.props } : null;
+          updateState((state) => ({
+            ...state,
+            dialogOpen: input.state ?? Boolean(input.subject),
+            dialogType: input.type ?? 'default',
+            dialogBlockAlign: input.blockAlign ?? 'center',
+            dialogOverlayClasses: input.overlayClasses,
+            dialogOverlayStyle: input.overlayStyle,
+            dialogContent: input.subject ? { component: input.subject, props: input.props } : undefined,
+          }));
         }),
       }),
 
@@ -50,21 +63,22 @@ export default Capability.makeModule(
       OperationResolver.make({
         operation: Common.LayoutOperation.UpdatePopover,
         handler: Effect.fnUntraced(function* (input) {
-          const layout = yield* Capability.get(SimpleLayoutState);
-          layout.popoverOpen = input.state ?? Boolean(input.subject);
-          layout.popoverContent =
-            typeof input.subject === 'string'
-              ? { component: input.subject, props: input.props }
-              : input.subject
-                ? { subject: input.subject }
-                : undefined;
-          layout.popoverSide = input.side;
-          layout.popoverVariant = input.variant;
-          if (input.variant === 'virtual') {
-            layout.popoverAnchor = input.anchor;
-          } else {
-            layout.popoverAnchorId = input.anchorId;
-          }
+          updateState((state) => ({
+            ...state,
+            popoverOpen: input.state ?? Boolean(input.subject),
+            popoverKind: input.kind ?? 'base',
+            popoverTitle: input.kind === 'card' ? input.title : undefined,
+            popoverContent:
+              typeof input.subject === 'string'
+                ? { component: input.subject, props: input.props }
+                : input.subject
+                  ? { subject: input.subject }
+                  : undefined,
+            popoverSide: input.side,
+            popoverVariant: input.variant,
+            popoverAnchor: input.variant === 'virtual' ? input.anchor : state.popoverAnchor,
+            popoverAnchorId: input.variant !== 'virtual' ? input.anchorId : state.popoverAnchorId,
+          }));
         }),
       }),
 
@@ -74,14 +88,16 @@ export default Capability.makeModule(
       OperationResolver.make({
         operation: Common.LayoutOperation.SwitchWorkspace,
         handler: Effect.fnUntraced(function* (input) {
-          const layout = yield* Capability.get(SimpleLayoutState);
-          // TODO(wittjosiah): This is a hack to prevent the previous deck from being set for pinned items.
-          //  Ideally this should be worked into the data model in a generic way.
-          if (!layout.workspace.startsWith('!')) {
-            layout.previousWorkspace = layout.workspace;
-          }
-          layout.workspace = input.subject;
-          layout.active = undefined;
+          updateState((state) => ({
+            ...state,
+            // TODO(wittjosiah): This is a hack to prevent the previous deck from being set for pinned items.
+            //  Ideally this should be worked into the data model in a generic way.
+            previousWorkspace: !state.workspace.startsWith('!') ? state.workspace : state.previousWorkspace,
+            workspace: input.subject,
+            active: undefined,
+            // Clear history when switching workspaces.
+            history: [],
+          }));
         }),
       }),
 
@@ -91,9 +107,9 @@ export default Capability.makeModule(
       OperationResolver.make({
         operation: Common.LayoutOperation.RevertWorkspace,
         handler: Effect.fnUntraced(function* () {
-          const layout = yield* Capability.get(SimpleLayoutState);
+          const state = getState();
           yield* Operation.invoke(Common.LayoutOperation.SwitchWorkspace, {
-            subject: layout.previousWorkspace,
+            subject: state.previousWorkspace,
           });
         }),
       }),
@@ -104,8 +120,18 @@ export default Capability.makeModule(
       OperationResolver.make({
         operation: Common.LayoutOperation.Open,
         handler: Effect.fnUntraced(function* (input) {
-          const layout = yield* Capability.get(SimpleLayoutState);
-          layout.active = input.subject[0];
+          updateState((state) => {
+            // Push current active to history if it exists.
+            const newHistory = state.active ? [...state.history, state.active] : state.history;
+            // Limit history length to prevent memory issues.
+            const trimmedHistory =
+              newHistory.length > MAX_HISTORY_LENGTH ? newHistory.slice(-MAX_HISTORY_LENGTH) : newHistory;
+            return {
+              ...state,
+              active: input.subject[0],
+              history: trimmedHistory,
+            };
+          });
         }),
       }),
 
@@ -115,8 +141,23 @@ export default Capability.makeModule(
       OperationResolver.make({
         operation: Common.LayoutOperation.Close,
         handler: Effect.fnUntraced(function* () {
-          const layout = yield* Capability.get(SimpleLayoutState);
-          layout.active = undefined;
+          updateState((state) => {
+            // Pop from history if available.
+            if (state.history.length > 0) {
+              const newHistory = [...state.history];
+              const previousActive = newHistory.pop();
+              return {
+                ...state,
+                active: previousActive,
+                history: newHistory,
+              };
+            }
+            // No history, just clear active.
+            return {
+              ...state,
+              active: undefined,
+            };
+          });
         }),
       }),
 
@@ -126,8 +167,10 @@ export default Capability.makeModule(
       OperationResolver.make({
         operation: Common.LayoutOperation.Set,
         handler: Effect.fnUntraced(function* (input) {
-          const layout = yield* Capability.get(SimpleLayoutState);
-          layout.active = input.subject[0];
+          updateState((state) => ({
+            ...state,
+            active: input.subject[0],
+          }));
         }),
       }),
     ]);

package/src/capabilities/react-surface/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));

package/src/capabilities/react-surface/react-surface.tsx

@@ -0,0 +1,40 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import React from 'react';
+
+import { Capability, Common } from '@dxos/app-framework';
+import { Node } from '@dxos/plugin-graph';
+
+import { Home, Workspace } from '../../components';
+import { meta } from '../../meta';
+
+type SurfaceData = {
+  attendableId: string;
+  properties: Record<string, any>;
+};
+
+const ALLOWED_DISPOSITIONS = ['workspace', 'user-account', 'pin-end'];
+
+export default Capability.makeModule(() =>
+  Effect.succeed(
+    Capability.contributes(Common.Capability.ReactSurface, [
+      Common.createSurface({
+        id: `${meta.id}/home`,
+        role: 'article',
+        filter: (data): data is SurfaceData => data.attendableId === Node.RootId,
+        component: () => <Home />,
+      }),
+      Common.createSurface({
+        id: `${meta.id}/workspace-article`,
+        role: 'article',
+        position: 'fallback',
+        filter: (data): data is SurfaceData =>
+          ALLOWED_DISPOSITIONS.includes((data.properties as Record<string, any>)?.disposition),
+        component: ({ data }) => <Workspace id={data.attendableId} />,
+      }),
+    ]),
+  ),
+);

package/src/capabilities/spotlight-dismiss/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const SpotlightDismiss = Capability.lazy('SpotlightDismiss', () => import('./spotlight-dismiss'));

package/src/{hooks/useSpotlightDismiss.ts → capabilities/spotlight-dismiss/spotlight-dismiss.ts}

@@ -5,14 +5,14 @@
 // Based on the frontend-driven dismiss pattern from:
 // https://github.com/Jedliu/tauri-template-demo
 
-import { useEffect } from 'react';
+import * as Effect from 'effect/Effect';
 
+import { Capability, Common } from '@dxos/app-framework';
 import { log } from '@dxos/log';
 import { isTauri } from '@dxos/util';
 
 /**
  * Get the Tauri window API from the global object.
- * Returns undefined if not running in Tauri.
  */
 const getTauriWindow = (): any => {
   const tauri = (globalThis as any).__TAURI__;
@@ -21,60 +21,46 @@ const getTauriWindow = (): any => {
 
 /**
  * Get the Tauri core API (invoke) from the global object.
- * Returns undefined if not running in Tauri.
  */
 const getTauriCore = (): any => {
   const tauri = (globalThis as any).__TAURI__;
   return tauri?.core;
 };
 
+export type SpotlightDismissOptions = {
+  /** Whether running in popover window context. */
+  isPopover?: boolean;
+};
+
 /**
- * Hook to set up spotlight panel dismiss behavior.
+ * Capability that sets up spotlight panel dismiss behavior.
  * When running in Tauri popover mode, listens for focus loss and Escape key
- * to dismiss the spotlight panel.
+ * to dismiss the spotlight panel. Runs at startup before React renders.
  */
-export const useSpotlightDismiss = (isPopover: boolean | undefined) => {
-  // Handle blur (click outside) to dismiss spotlight.
-  useEffect(() => {
+export default Capability.makeModule(({ isPopover = false }: SpotlightDismissOptions = {}) =>
+  Effect.promise(async () => {
     if (!isPopover || !isTauri()) {
-      return;
+      return [];
     }
 
-    let cleanup: (() => void) | undefined;
-
-    const setup = async () => {
-      try {
-        const tauriWindow = getTauriWindow();
-        const tauriCore = getTauriCore();
-        if (!tauriWindow || !tauriCore) {
-          return;
-        }
-
+    // Set up focus listener.
+    let focusCleanup: (() => void) | undefined;
+    try {
+      const tauriWindow = getTauriWindow();
+      const tauriCore = getTauriCore();
+      if (tauriWindow && tauriCore) {
         const win = tauriWindow.getCurrentWindow();
-        const unlisten = await win.onFocusChanged(async ({ payload }: { payload: boolean }) => {
+        focusCleanup = await win.onFocusChanged(async ({ payload }: { payload: boolean }) => {
           if (!payload) {
             await tauriCore.invoke('hide_spotlight');
           }
         });
-        cleanup = unlisten;
-      } catch (err) {
-        log.catch(err);
       }
-    };
-
-    void setup();
-
-    return () => {
-      cleanup?.();
-    };
-  }, [isPopover]);
-
-  // Handle Escape key to dismiss spotlight.
-  useEffect(() => {
-    if (!isPopover || !isTauri()) {
-      return;
+    } catch (err) {
+      log.catch(err);
     }
 
+    // Set up Escape key listener.
     const handleKeyDown = async (event: KeyboardEvent) => {
       if (event.key === 'Escape') {
         event.preventDefault();
@@ -88,8 +74,13 @@ export const useSpotlightDismiss = (isPopover: boolean | undefined) => {
         }
       }
     };
-
     window.addEventListener('keydown', handleKeyDown);
-    return () => window.removeEventListener('keydown', handleKeyDown);
-  }, [isPopover]);
-};
+
+    return Capability.contributes(Common.Capability.Null, null, () =>
+      Effect.sync(() => {
+        focusCleanup?.();
+        window.removeEventListener('keydown', handleKeyDown);
+      }),
+    );
+  }),
+);

package/src/capabilities/state/state.tsx

@@ -2,18 +2,20 @@
 // Copyright 2025 DXOS.org
 //
 
+import { Atom } from '@effect-atom/atom-react';
 import * as Effect from 'effect/Effect';
 
 import { Capability, Common } from '@dxos/app-framework';
-import { live } from '@dxos/live-object';
+import { Node } from '@dxos/plugin-graph';
 
 import { type SimpleLayoutState } from '../../types';
 import { SimpleLayoutState as SimpleLayoutStateCapability } from '../../types';
 
 const defaultState: SimpleLayoutState = {
   dialogOpen: false,
-  workspace: 'default',
-  previousWorkspace: 'default',
+  workspace: Node.RootId,
+  previousWorkspace: Node.RootId,
+  history: [],
   isPopover: false,
 };
 
@@ -23,38 +25,25 @@ export type SimpleLayoutStateOptions = {
 
 export default Capability.makeModule(({ initialState }: SimpleLayoutStateOptions = {}) =>
   Effect.sync(() => {
-    const state = live<SimpleLayoutState>({ ...defaultState, ...initialState });
-
-    const layout = live<Common.Capability.Layout>({
-      get mode() {
-        return 'simple';
-      },
-      get dialogOpen() {
-        return state.dialogOpen;
-      },
-      get sidebarOpen() {
-        return false;
-      },
-      get complementarySidebarOpen() {
-        return false;
-      },
-      get workspace() {
-        return state.workspace;
-      },
-      get active() {
-        return state.active ? [state.active] : [];
-      },
-      get inactive() {
-        return [];
-      },
-      get scrollIntoView() {
-        return undefined;
-      },
+    const stateAtom = Atom.make<SimpleLayoutState>({ ...defaultState, ...initialState });
+
+    const layoutAtom = Atom.make((get): Common.Capability.Layout => {
+      const state = get(stateAtom);
+      return {
+        mode: 'simple',
+        dialogOpen: state.dialogOpen,
+        sidebarOpen: false,
+        complementarySidebarOpen: false,
+        workspace: state.workspace,
+        active: state.active ? [state.active] : [],
+        inactive: [],
+        scrollIntoView: undefined,
+      };
     });
 
     return [
-      Capability.contributes(SimpleLayoutStateCapability, state),
-      Capability.contributes(Common.Capability.Layout, layout),
+      Capability.contributes(SimpleLayoutStateCapability, stateAtom),
+      Capability.contributes(Common.Capability.Layout, layoutAtom),
     ];
   }),
 );

package/src/capabilities/url-handler/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const UrlHandler = Capability.lazy('UrlHandler', () => import('./url-handler'));

package/src/capabilities/url-handler/url-handler.ts

@@ -0,0 +1,80 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability, Common } from '@dxos/app-framework';
+import { Node } from '@dxos/plugin-graph';
+
+import { type SimpleLayoutState, SimpleLayoutState as SimpleLayoutStateCapability } from '../../types';
+
+/**
+ * URL handler for simple layout that syncs browser URL with layout state.
+ * URL format: /{workspace} or /{workspace}/{active}
+ * Root is represented as / or /root.
+ */
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const { invokeSync } = yield* Capability.get(Common.Capability.OperationInvoker);
+
+    /**
+     * Handle navigation events (initial load and popstate).
+     * Parses URL and updates state accordingly.
+     */
+    const handleNavigation = () => {
+      const pathname = window.location.pathname;
+
+      // Parse URL segments: /{workspace}/{active}
+      const [_, nextWorkspace, nextActive] = pathname.split('/');
+
+      // Determine target workspace (empty or 'root' means Node.RootId).
+      const targetWorkspace = !nextWorkspace || nextWorkspace === 'root' ? Node.RootId : nextWorkspace;
+
+      // Navigate via operations (they will update state accordingly).
+      invokeSync(Common.LayoutOperation.SwitchWorkspace, { subject: targetWorkspace });
+      if (nextActive) {
+        invokeSync(Common.LayoutOperation.Open, { subject: [nextActive] });
+      }
+    };
+
+    // Handle initial URL and listen for browser navigation.
+    yield* Effect.sync(() => handleNavigation());
+    window.addEventListener('popstate', handleNavigation);
+
+    // Subscribe to state changes to update the URL.
+    let lastWorkspace: string | undefined;
+    let lastActive: string | undefined;
+    const unsubscribe = yield* Common.Capability.subscribeAtom(
+      SimpleLayoutStateCapability,
+      (state: SimpleLayoutState) => {
+        const { workspace, active } = state;
+
+        // Only update URL if relevant state changed.
+        if (workspace !== lastWorkspace || active !== lastActive) {
+          lastWorkspace = workspace;
+          lastActive = active;
+
+          // Build path: root is represented as /, other workspaces as /{workspace}.
+          let path: string;
+          if (workspace === Node.RootId) {
+            path = active ? `/${Node.RootId}/${active}` : '/';
+          } else {
+            path = active ? `/${workspace}/${active}` : `/${workspace}`;
+          }
+
+          if (window.location.pathname !== path) {
+            history.pushState(null, '', `${path}${window.location.search}`);
+          }
+        }
+      },
+    );
+
+    return Capability.contributes(Common.Capability.Null, null, () =>
+      Effect.sync(() => {
+        window.removeEventListener('popstate', handleNavigation);
+        unsubscribe();
+      }),
+    );
+  }),
+);