@dxos/plugin-simple-layout 0.8.4-main.7996785055 → 0.8.4-main.8baae0fced

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-simple-layout",
-  "version": "0.8.4-main.7996785055",
+  "version": "0.8.4-main.8baae0fced",
   "description": "Simple layout plugin for minimal UI contexts like popover windows.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -8,16 +8,67 @@
     "type": "git",
     "url": "https://github.com/dxos/dxos"
   },
-  "license": "MIT",
+  "license": "FSL-1.1-Apache-2.0",
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
+  "imports": {
+    "#capabilities": {
+      "source": "./src/capabilities/index.ts",
+      "types": "./dist/types/src/capabilities/index.d.ts",
+      "default": "./dist/lib/neutral/capabilities/index.mjs"
+    },
+    "#components": {
+      "source": "./src/components/index.ts",
+      "types": "./dist/types/src/components/index.d.ts",
+      "default": "./dist/lib/neutral/components/index.mjs"
+    },
+    "#hooks": {
+      "source": "./src/hooks/index.ts",
+      "types": "./dist/types/src/hooks/index.d.ts",
+      "default": "./dist/lib/neutral/hooks/index.mjs"
+    },
+    "#meta": {
+      "source": "./src/meta.ts",
+      "types": "./dist/types/src/meta.d.ts",
+      "default": "./dist/lib/neutral/meta.mjs"
+    },
+    "#operations": {
+      "source": "./src/operations/index.ts",
+      "types": "./dist/types/src/operations/index.d.ts",
+      "default": "./dist/lib/neutral/operations/index.mjs"
+    },
+    "#plugin": {
+      "source": "./src/SimpleLayoutPlugin.ts",
+      "types": "./dist/types/src/SimpleLayoutPlugin.d.ts",
+      "default": "./dist/lib/neutral/SimpleLayoutPlugin.mjs"
+    },
+    "#translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/neutral/translations.mjs"
+    },
+    "#types": {
+      "source": "./src/types/index.ts",
+      "types": "./dist/types/src/types/index.d.ts",
+      "default": "./dist/lib/neutral/types/index.mjs"
+    }
+  },
   "exports": {
     ".": {
       "source": "./src/index.ts",
-      "browser": "./dist/lib/browser/index.mjs",
-      "node": "./dist/lib/node-esm/index.mjs",
-      "types": "./dist/types/src/index.d.ts"
+      "types": "./dist/types/src/index.d.ts",
+      "default": "./dist/lib/neutral/index.mjs"
+    },
+    "./plugin": {
+      "source": "./src/plugin.ts",
+      "types": "./dist/types/src/plugin.d.ts",
+      "default": "./dist/lib/neutral/plugin.mjs"
+    },
+    "./translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/neutral/translations.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -29,22 +80,26 @@
     "@effect-atom/atom": "^0.5.1",
     "@effect-atom/atom-react": "^0.5.0",
     "@radix-ui/react-context": "1.1.1",
-    "@tauri-apps/plugin-deep-link": "^2.2.0",
+    "@tauri-apps/plugin-deep-link": "^2.4.9",
     "@tauri-apps/plugin-haptics": "^2.3.2",
-    "@dxos/app-framework": "0.8.4-main.7996785055",
-    "@dxos/echo": "0.8.4-main.7996785055",
-    "@dxos/async": "0.8.4-main.7996785055",
-    "@dxos/log": "0.8.4-main.7996785055",
-    "@dxos/plugin-graph": "0.8.4-main.7996785055",
-    "@dxos/react-ui-menu": "0.8.4-main.7996785055",
-    "@dxos/react-ui-mosaic": "0.8.4-main.7996785055",
-    "@dxos/react-ui-search": "0.8.4-main.7996785055",
-    "@dxos/react-ui-stack": "0.8.4-main.7996785055",
-    "@dxos/react-ui-attention": "0.8.4-main.7996785055",
-    "@dxos/schema": "0.8.4-main.7996785055",
-    "@dxos/util": "0.8.4-main.7996785055",
-    "@dxos/operation": "0.8.4-main.7996785055",
-    "@dxos/app-toolkit": "0.8.4-main.7996785055"
+    "@dxos/async": "0.8.4-main.8baae0fced",
+    "@dxos/app-framework": "0.8.4-main.8baae0fced",
+    "@dxos/app-toolkit": "0.8.4-main.8baae0fced",
+    "@dxos/context": "0.8.4-main.8baae0fced",
+    "@dxos/compute": "0.8.4-main.8baae0fced",
+    "@dxos/effect": "0.8.4-main.8baae0fced",
+    "@dxos/echo": "0.8.4-main.8baae0fced",
+    "@dxos/plugin-client": "0.8.4-main.8baae0fced",
+    "@dxos/log": "0.8.4-main.8baae0fced",
+    "@dxos/plugin-graph": "0.8.4-main.8baae0fced",
+    "@dxos/react-ui-attention": "0.8.4-main.8baae0fced",
+    "@dxos/react-ui-list": "0.8.4-main.8baae0fced",
+    "@dxos/react-ui-menu": "0.8.4-main.8baae0fced",
+    "@dxos/react-ui-search": "0.8.4-main.8baae0fced",
+    "@dxos/react-ui-mosaic": "0.8.4-main.8baae0fced",
+    "@dxos/react-ui-stack": "0.8.4-main.8baae0fced",
+    "@dxos/util": "0.8.4-main.8baae0fced",
+    "@dxos/schema": "0.8.4-main.8baae0fced"
   },
   "devDependencies": {
     "@types/react": "~19.2.7",
@@ -52,24 +107,23 @@
     "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "vite": "^7.1.11",
-    "@dxos/app-graph": "0.8.4-main.7996785055",
-    "@dxos/plugin-client": "0.8.4-main.7996785055",
-    "@dxos/plugin-preview": "0.8.4-main.7996785055",
-    "@dxos/plugin-search": "0.8.4-main.7996785055",
-    "@dxos/plugin-space": "0.8.4-main.7996785055",
-    "@dxos/plugin-testing": "0.8.4-main.7996785055",
-    "@dxos/schema": "0.8.4-main.7996785055",
-    "@dxos/ui-theme": "0.8.4-main.7996785055",
-    "@dxos/storybook-utils": "0.8.4-main.7996785055",
-    "@dxos/react-ui": "0.8.4-main.7996785055"
+    "vite": "^8.0.13",
+    "@dxos/app-graph": "0.8.4-main.8baae0fced",
+    "@dxos/plugin-preview": "0.8.4-main.8baae0fced",
+    "@dxos/plugin-search": "0.8.4-main.8baae0fced",
+    "@dxos/plugin-space": "0.8.4-main.8baae0fced",
+    "@dxos/plugin-testing": "0.8.4-main.8baae0fced",
+    "@dxos/schema": "0.8.4-main.8baae0fced",
+    "@dxos/react-ui": "0.8.4-main.8baae0fced",
+    "@dxos/ui-theme": "0.8.4-main.8baae0fced",
+    "@dxos/storybook-utils": "0.8.4-main.8baae0fced"
   },
   "peerDependencies": {
     "effect": "3.20.0",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "@dxos/react-ui": "0.8.4-main.7996785055",
-    "@dxos/ui-theme": "0.8.4-main.7996785055"
+    "@dxos/ui-theme": "0.8.4-main.8baae0fced",
+    "@dxos/react-ui": "0.8.4-main.8baae0fced"
   },
   "publishConfig": {
     "access": "public"

package/src/SimpleLayoutPlugin.ts

@@ -5,10 +5,18 @@
 import { ActivationEvent, ActivationEvents, Capability, Plugin } from '@dxos/app-framework';
 import { AppActivationEvents, AppPlugin } from '@dxos/app-toolkit';
 
-import { OperationHandler, ReactRoot, ReactSurface, SpotlightDismiss, State, UrlHandler } from './capabilities';
-import { meta } from './meta';
-import { translations } from './translations';
-import { SimpleLayoutEvents } from './types';
+import {
+  AppGraphBuilder,
+  OperationHandler,
+  ReactRoot,
+  ReactSurface,
+  SpotlightDismiss,
+  State,
+  UrlHandler,
+} from '#capabilities';
+import { meta } from '#meta';
+import { translations } from '#translations';
+import { SimpleLayoutEvents } from '#types';
 
 export type SimpleLayoutPluginOptions = {
   /** Determines if running in popover window context (hides mobile-specific UI). */
@@ -16,12 +24,13 @@ export type SimpleLayoutPluginOptions = {
 };
 
 export const SimpleLayoutPlugin = Plugin.define<SimpleLayoutPluginOptions>(meta).pipe(
+  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),
   AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),
   AppPlugin.addTranslationsModule({ translations }),
   Plugin.addModule(({ isPopover = false }) => ({
     id: Capability.getModuleTag(State),
     activatesOn: ActivationEvents.Startup,
-    activatesAfter: [SimpleLayoutEvents.StateReady, AppActivationEvents.LayoutReady],
+    firesAfterActivation: [SimpleLayoutEvents.StateReady, AppActivationEvents.LayoutReady],
     activate: () => State({ initialState: { isPopover } }),
   })),
   Plugin.addModule(({ isPopover = false }) => ({
@@ -41,8 +50,10 @@ export const SimpleLayoutPlugin = Plugin.define<SimpleLayoutPluginOptions>(meta)
   }),
   Plugin.addModule({
     id: Capability.getModuleTag(UrlHandler),
-    activatesOn: ActivationEvent.allOf(ActivationEvents.OperationInvokerReady, SimpleLayoutEvents.StateReady),
+    activatesOn: ActivationEvent.allOf(ActivationEvents.ProcessManagerReady, SimpleLayoutEvents.StateReady),
     activate: UrlHandler,
   }),
   Plugin.make,
 );
+
+export default SimpleLayoutPlugin;

package/src/capabilities/app-graph-builder.ts

@@ -0,0 +1,21 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { AppCapabilities, AppNode } from '@dxos/app-toolkit';
+import { GraphBuilder, NodeMatcher } from '@dxos/plugin-graph';
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const extensions = yield* GraphBuilder.createExtension({
+      id: 'org.dxos.plugin.simpleLayout.not-found',
+      match: NodeMatcher.whenRoot,
+      connector: () => Effect.succeed([AppNode.makeNotFound()]),
+    });
+
+    return Capability.contributes(AppCapabilities.AppGraphBuilder, extensions);
+  }),
+);

package/src/capabilities/index.ts

@@ -2,9 +2,16 @@
 // Copyright 2025 DXOS.org
 //
 
-export * from './operation-handler';
-export * from './react-root';
-export * from './react-surface';
-export * from './spotlight-dismiss';
-export * from './state';
-export * from './url-handler';
+import { Capability } from '@dxos/app-framework';
+import { OperationHandlerSet } from '@dxos/compute';
+
+export const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));
+export const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(
+  'OperationHandler',
+  () => import('./operation-handler'),
+);
+export const ReactRoot = Capability.lazy('ReactRoot', () => import('./react-root'));
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));
+export const SpotlightDismiss = Capability.lazy('SpotlightDismiss', () => import('./spotlight-dismiss'));
+export const State = Capability.lazy('State', () => import('./state'));
+export const UrlHandler = Capability.lazy('UrlHandler', () => import('./url-handler'));

package/src/capabilities/{operation-handler/operation-handler.ts → operation-handler.ts}

@@ -3,9 +3,9 @@
 import * as Effect from 'effect/Effect';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
-import type { OperationHandlerSet } from '@dxos/operation';
+import type { OperationHandlerSet } from '@dxos/compute';
 
-import { SimpleLayoutOperationHandlerSet } from '../../operations';
+import { SimpleLayoutOperationHandlerSet } from '#operations';
 
 export default Capability.makeModule<OperationHandlerSet.OperationHandlerSet>(
   Effect.fnUntraced(function* () {

package/src/capabilities/{react-root/react-root.tsx → react-root.tsx}

@@ -7,8 +7,8 @@ import React from 'react';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
 
-import { SimpleLayout } from '../../components';
-import { meta } from '../../meta';
+import { SimpleLayout } from '#components';
+import { meta } from '#meta';
 
 export default Capability.makeModule(() =>
   Effect.succeed(

package/src/capabilities/{react-surface/react-surface.tsx → react-surface.tsx}

@@ -7,31 +7,38 @@ import React from 'react';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
 import { Surface } from '@dxos/app-framework/ui';
+import { NOT_FOUND_PATH } from '@dxos/app-toolkit';
+import { NotFoundArticle } from '@dxos/app-toolkit/ui';
 import { Node } from '@dxos/plugin-graph';
 
-import { Home, NavBranch } from '../../components';
-import { meta } from '../../meta';
+import { Home, NavBranch } from '#components';
 
 type SurfaceData = {
   attendableId: string;
   properties: Record<string, any>;
 };
 
-const ALLOWED_DISPOSITIONS = ['workspace', 'user-account', 'pin-end', 'alternate-tree'];
+const ALLOWED_DISPOSITIONS = ['workspace', 'user-account', 'pin-end'];
 
 export default Capability.makeModule(() =>
   Effect.succeed(
     Capability.contributes(Capabilities.ReactSurface, [
       Surface.create({
-        id: `${meta.id}.home`,
+        id: 'home',
         role: 'article',
         filter: (data): data is SurfaceData => data.attendableId === Node.RootId,
         component: () => <Home />,
       }),
       Surface.create({
-        id: `${meta.id}.nav-branch`,
+        id: 'not-found',
         role: 'article',
-        position: 'fallback',
+        filter: (data): data is SurfaceData => data.attendableId === NOT_FOUND_PATH,
+        component: () => <NotFoundArticle />,
+      }),
+      Surface.create({
+        id: 'nav-branch',
+        role: 'article',
+        position: 'last',
         filter: (data): data is SurfaceData => {
           const props = data.properties as Record<string, any>;
           return ALLOWED_DISPOSITIONS.includes(props?.disposition) || props?.role === 'branch';

package/src/capabilities/{state/state.tsx → state.tsx}

@@ -9,10 +9,9 @@ import { Capability } from '@dxos/app-framework';
 import { AppCapabilities } from '@dxos/app-toolkit';
 import { Node } from '@dxos/plugin-graph';
 
-import { type SimpleLayoutState } from '../../types';
-import { SimpleLayoutState as SimpleLayoutStateCapability } from '../../types';
+import { SimpleLayoutCapabilities } from '#types';
 
-const defaultState: SimpleLayoutState = {
+const defaultState: SimpleLayoutCapabilities.SimpleLayoutState = {
   dialogOpen: false,
   workspace: Node.RootId,
   previousWorkspace: Node.RootId,
@@ -23,12 +22,12 @@ const defaultState: SimpleLayoutState = {
 };
 
 export type SimpleLayoutStateOptions = {
-  initialState?: Partial<SimpleLayoutState>;
+  initialState?: Partial<SimpleLayoutCapabilities.SimpleLayoutState>;
 };
 
 export default Capability.makeModule(({ initialState }: SimpleLayoutStateOptions = {}) =>
   Effect.sync(() => {
-    const stateAtom = Atom.make<SimpleLayoutState>({ ...defaultState, ...initialState });
+    const stateAtom = Atom.make<SimpleLayoutCapabilities.SimpleLayoutState>({ ...defaultState, ...initialState });
 
     const layoutAtom = Atom.make((get): AppCapabilities.Layout => {
       const state = get(stateAtom);
@@ -45,7 +44,7 @@ export default Capability.makeModule(({ initialState }: SimpleLayoutStateOptions
     });
 
     return [
-      Capability.contributes(SimpleLayoutStateCapability, stateAtom),
+      Capability.contributes(SimpleLayoutCapabilities.State, stateAtom),
       Capability.contributes(AppCapabilities.Layout, layoutAtom),
     ];
   }),

package/src/capabilities/url-handler.ts

@@ -0,0 +1,164 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { AppCapabilities, LayoutOperation, fromUrlPath, getWorkspaceFromPath, toUrlPath } from '@dxos/app-toolkit';
+import { runAndForwardErrors } from '@dxos/effect';
+import { log } from '@dxos/log';
+import { isTauri } from '@dxos/util';
+
+import { SimpleLayoutCapabilities } from '#types';
+
+/**
+ * URL handler for simple layout that syncs browser URL with layout state.
+ * URL paths map directly to qualified graph IDs with the leading `root` segment stripped.
+ * Root is represented as `/`.
+ *
+ * On Tauri, also listens for deep links via the deep-link plugin.
+ */
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const { invokePromise } = yield* Capability.get(Capabilities.OperationInvoker);
+    const capabilities = yield* Capability.Service;
+
+    /** Dispatch all NavigationHandler contributions with a given URL. */
+    const dispatchNavigationHandlers = (url: URL) =>
+      Effect.gen(function* () {
+        const handlers = yield* Capability.getAll(AppCapabilities.NavigationHandler);
+        yield* Effect.all(
+          handlers.map((handler) => handler(url)),
+          { concurrency: 'unbounded' },
+        );
+      }).pipe(Effect.provideService(Capability.Service, capabilities), runAndForwardErrors);
+
+    /**
+     * Handle navigation from a URL.
+     * Dispatches to NavigationHandler contributions, then handles pathname routing.
+     */
+    const handlePathNavigation = (url?: URL) => {
+      const resolvedUrl = url ?? new URL(window.location.href);
+      void dispatchNavigationHandlers(resolvedUrl);
+
+      let pathname = resolvedUrl.pathname;
+      if (isFilePath(pathname)) {
+        log.info('[UrlHandler] Skipping file path (not a graph node)', { pathname });
+        pathname = '/';
+      }
+
+      const qualifiedId = fromUrlPath(pathname);
+      const workspace = getWorkspaceFromPath(qualifiedId);
+
+      void invokePromise(LayoutOperation.SwitchWorkspace, { subject: workspace });
+
+      const activeId = qualifiedId !== workspace ? qualifiedId : undefined;
+      if (activeId) {
+        void invokePromise(LayoutOperation.Open, { subject: [activeId] });
+      }
+    };
+
+    const onPopState = () => {
+      handlePathNavigation();
+    };
+
+    // Initial navigation.
+    yield* Effect.sync(() => handlePathNavigation());
+    window.addEventListener('popstate', onPopState);
+
+    // Tauri deep link support.
+    let unlistenDeepLink: (() => void) | undefined;
+    if (isTauri()) {
+      yield* Effect.tryPromise({
+        try: async () => {
+          const { getCurrent, onOpenUrl } = await import('@tauri-apps/plugin-deep-link');
+
+          const launchUrls = await getCurrent();
+          if (launchUrls && launchUrls.length > 0) {
+            log.info('[UrlHandler] App launched with deep links', { urls: launchUrls });
+            for (const urlString of launchUrls) {
+              handleDeepLink(urlString, handlePathNavigation);
+            }
+          }
+
+          unlistenDeepLink = await onOpenUrl((urls) => {
+            log.info('[UrlHandler] Deep links received', { urls });
+            for (const urlString of urls) {
+              handleDeepLink(urlString, handlePathNavigation);
+            }
+          });
+        },
+        catch: (error) => {
+          log.warn('[UrlHandler] Failed to initialize deep link listener', { error });
+          return error;
+        },
+      }).pipe(Effect.catchAll(() => Effect.void));
+    }
+
+    // Sync URL with layout state changes.
+    let lastWorkspace: string | undefined;
+    let lastActive: string | undefined;
+    const unsubscribe = yield* Capabilities.subscribeAtom(
+      SimpleLayoutCapabilities.State,
+      (state: SimpleLayoutCapabilities.SimpleLayoutState) => {
+        const { workspace, active } = state;
+
+        if (workspace !== lastWorkspace || active !== lastActive) {
+          lastWorkspace = workspace;
+          lastActive = active;
+
+          const path = active ? toUrlPath(active) : toUrlPath(workspace);
+          if (window.location.pathname !== path) {
+            history.pushState(null, '', `${path}${window.location.search}`);
+          }
+        }
+      },
+    );
+
+    return Capability.contributes(Capabilities.Null, null, () =>
+      Effect.sync(() => {
+        window.removeEventListener('popstate', onPopState);
+        unsubscribe();
+        unlistenDeepLink?.();
+      }),
+    );
+  }),
+);
+
+/** Check if a path is a redirect path handled elsewhere (e.g., OAuth). */
+const isRedirectPath = (pathname: string): boolean => pathname.startsWith('/redirect/');
+
+/** Paths with file extensions are not graph node paths. */
+const isFilePath = (pathname: string): boolean => /\.[a-z]+$/i.test(pathname);
+
+/** Handle a deep link URL string. Merges query params into window.location and navigates. */
+const handleDeepLink = (urlString: string, navigate: (url?: URL) => void): void => {
+  log.info('[UrlHandler] Deep link received', { url: urlString });
+  try {
+    const deepLinkUrl = new URL(urlString);
+
+    // For custom schemes (e.g., composer://a/b/c), new URL() treats the first segment as the
+    // hostname. Reconstruct the full path from hostname + pathname.
+    const fullPath =
+      deepLinkUrl.protocol !== 'https:' && deepLinkUrl.protocol !== 'http:' && deepLinkUrl.hostname
+        ? '/' + deepLinkUrl.hostname + deepLinkUrl.pathname
+        : deepLinkUrl.pathname;
+
+    if (isRedirectPath(fullPath)) {
+      return;
+    }
+
+    // Merge deep link query params into the current window URL so handlers can read them.
+    const current = new URL(window.location.href);
+    if (deepLinkUrl.search) {
+      deepLinkUrl.searchParams.forEach((value, key) => current.searchParams.set(key, value));
+    }
+    current.pathname = fullPath;
+    history.replaceState(null, '', current.pathname + current.search);
+
+    navigate(current);
+  } catch (error) {
+    log.warn('[UrlHandler] Failed to parse deep link URL', { urlString, error });
+  }
+};

package/src/components/ContentError.stories.tsx

@@ -7,7 +7,7 @@ import { type Meta, type StoryObj } from '@storybook/react-vite';
 import { ErrorFallback } from '@dxos/react-ui';
 import { withTheme } from '@dxos/react-ui/testing';
 
-import { translations } from '../translations';
+import { translations } from '#translations';
 
 const meta = {
   title: 'plugins/plugin-simple-layout/components/ErrorFallback',

package/src/components/Dialog/Dialog.tsx

@@ -5,10 +5,11 @@
 import React from 'react';
 
 import { Surface } from '@dxos/app-framework/ui';
+import { AppSurface } from '@dxos/app-toolkit/ui';
 import { AlertDialog, Dialog as NaturalDialog } from '@dxos/react-ui';
 import { ErrorFallback } from '@dxos/react-ui';
 
-import { useSimpleLayoutState } from '../../hooks';
+import { useSimpleLayoutState } from '#hooks';
 
 export const Dialog = () => {
   const { state, updateState } = useSimpleLayoutState();
@@ -23,14 +24,24 @@ export const Dialog = () => {
       onOpenChange={(nextOpen) => updateState((state) => ({ ...state, dialogOpen: nextOpen }))}
     >
       {state.dialogBlockAlign === 'end' ? (
-        <Surface.Surface role='dialog' data={state.dialogContent} limit={1} fallback={ErrorFallback} />
+        <Surface.Surface
+          type={AppSurface.Dialog}
+          data={state.dialogContent ?? undefined}
+          limit={1}
+          fallback={ErrorFallback}
+        />
       ) : (
         <DialogOverlay
           blockAlign={state.dialogBlockAlign}
           classNames={state.dialogOverlayClasses}
           style={state.dialogOverlayStyle}
         >
-          <Surface.Surface role='dialog' data={state.dialogContent} limit={1} fallback={ErrorFallback} />
+          <Surface.Surface
+            type={AppSurface.Dialog}
+            data={state.dialogContent ?? undefined}
+            limit={1}
+            fallback={ErrorFallback}
+          />
         </DialogOverlay>
       )}
     </DialogRoot>

package/src/components/Home/Home.tsx

@@ -15,7 +15,8 @@ import { SearchPanel, useSearchListItem, useSearchListResults } from '@dxos/reac
 import { mx } from '@dxos/ui-theme';
 import { byPosition, getHostPlatform, isTauri } from '@dxos/util';
 
-import { meta } from '../../meta';
+import { meta } from '#meta';
+
 import { useExpandPath } from '../hooks';
 
 export type HomeProps = {};
@@ -99,7 +100,7 @@ const WorkspaceTile: MosaicStackTileComponent<Node.Node> = (props) => {
       fullWidth
       tabIndex={-1} // TODO(burdon): Use Mosaic.Focus.
       data-selected={isSelected}
-      classNames={mx('dx-focus-ring', isSelected && 'bg-hover-overlay')}
+      classNames={mx('dx-focus-ring', isSelected && 'bg-selected-surface')}
       onClick={handleSelect}
       ref={cardRef}
     >

package/src/components/Loading/Loading.tsx

@@ -6,5 +6,5 @@ import React from 'react';
 
 // TODO(burdon): Show skeleton: https://github.com/dxos/dxos/issues/8259
 export const Loading = () => {
-  return <div role='none' className='grid place-items-center dx-attention-surface' />;
+  return <div className='grid place-items-center dx-attention-surface' />;
 };