@lapis-notes/workspace 0.2.1 → 0.3.1

package/CHANGELOG.md

@@ -1,36 +1,147 @@
 # @lapis-notes/workspace
 
+## 0.3.1
+
+### Patch Changes
+
+- [#44](https://github.com/lapismd/lapis-notes/pull/44)
+  [`f2373ba`](https://github.com/lapismd/lapis-notes/commit/f2373baf79db19267f3422895ce321ef1fa3c78d)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Point package
+  documentation to the canonical specification and remove stale package-local
+  and pre-consolidation specification links.
+
+- [#47](https://github.com/lapismd/lapis-notes/pull/47)
+  [`6f315ba`](https://github.com/lapismd/lapis-notes/commit/6f315baef2bd2f0bb4942927d4e19b9e0eb2a15d)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Restore explicit
+  disk-version acceptance in the shared retained conflict review, including
+  preserving deletion through the captured guarded writer decision.
+- Updated dependencies
+  [[`f2373ba`](https://github.com/lapismd/lapis-notes/commit/f2373baf79db19267f3422895ce321ef1fa3c78d)]:
+  - @lapis-notes/api@0.2.1
+  - @lapis-notes/ui@0.1.5
+
+## 0.3.0
+
+### Minor Changes
+
+- [`535a6cc`](https://github.com/lapismd/lapis-notes/commit/535a6cc7b39f397cf8761a06db7b831386121928)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Share the existing
+  desktop vault chooser and branded startup presentation across native hosts,
+  with injected profile storage and native actions.
+
+- [`fc3ecdf`](https://github.com/lapismd/lapis-notes/commit/fc3ecdf374005e3c2e960af7d84709b92803537a)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Share the retained
+  text-conflict presentation through the App-owned `bindFileConflictReviews`
+  binding: one reference-counted lease for WorkspaceShell mounts and early host
+  surfaces captured writer conflicts as Problems diagnostics and a three-way
+  MergeEditor review leaf whose saves and refreshes run through the writer-owned
+  captured actions (LN-WS-102–104).
+
+### Patch Changes
+
+- [`4cdbb7b`](https://github.com/lapismd/lapis-notes/commit/4cdbb7b09f2875d413bf0e3fa054ed16345866a8)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Expose the existing
+  desktop Safe Mode recovery presentation through shared, host-controlled
+  callbacks for Tauri.
+
+- [`d8946b9`](https://github.com/lapismd/lapis-notes/commit/d8946b941569484b813eb0c1e8b1c5729fffc1a7)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Add owned
+  diagnostic-resource navigation and themed recovery-banner actions. Accept
+  Design Core 0.5.1 alongside the existing 0.4 range.
+
+- Require released Design Core 0.6 for the close-guard, plugin-flush and
+  centered panel contracts used by current source. Retain portable registry
+  dependency ranges for the shared application runtime.
+- Updated dependencies
+  [[`bdd4923`](https://github.com/lapismd/lapis-notes/commit/bdd492357135de2cc0175fa42413709b2a38cd63),
+  [`86e85f6`](https://github.com/lapismd/lapis-notes/commit/86e85f6e814430c1755147c913eb91090a439bf4),
+  [`631aeec`](https://github.com/lapismd/lapis-notes/commit/631aeec539e2fb061dc80c5c3a30a248ee15c529),
+  [`fdee7e4`](https://github.com/lapismd/lapis-notes/commit/fdee7e4defde17a1009e16138d78c93c3ead8e2f),
+  [`a91d5e2`](https://github.com/lapismd/lapis-notes/commit/a91d5e2eb5ec037029f6a7a2df316a9bd9440af7),
+  [`fbba8d4`](https://github.com/lapismd/lapis-notes/commit/fbba8d48498c34939fec475e6bed67a682045820),
+  [`d8946b9`](https://github.com/lapismd/lapis-notes/commit/d8946b941569484b813eb0c1e8b1c5729fffc1a7),
+  [`ebf033a`](https://github.com/lapismd/lapis-notes/commit/ebf033af0fc0752be5ce5ffa7d55784163d291b4),
+  [`023259d`](https://github.com/lapismd/lapis-notes/commit/023259d96d4ff0414fec6427924ed917f89405a3),
+  [`63a5e7f`](https://github.com/lapismd/lapis-notes/commit/63a5e7fe40eea45762b5842b588c742076c7dd1d),
+  [`2bffe48`](https://github.com/lapismd/lapis-notes/commit/2bffe484b38761af197afe7ab9b0d7b3affb50d7),
+  [`86f6316`](https://github.com/lapismd/lapis-notes/commit/86f63166c3d5be648c595ef4e230ea6c4081bc48),
+  [`edf1d76`](https://github.com/lapismd/lapis-notes/commit/edf1d76f4f3aa0442c1d9153d812f29b7d14e5c2),
+  [`b3be91d`](https://github.com/lapismd/lapis-notes/commit/b3be91daecbd43187bacf8cfdc39f8311d700720),
+  [`5ef0a63`](https://github.com/lapismd/lapis-notes/commit/5ef0a6331c1b846b70357f990d919977a561112c),
+  [`bac3e5e`](https://github.com/lapismd/lapis-notes/commit/bac3e5eda6f467dbc86ec88c9f27a275f2b27953),
+  [`978b987`](https://github.com/lapismd/lapis-notes/commit/978b987ba4c95408a63e49fad11bc44bab020758),
+  [`ad4490c`](https://github.com/lapismd/lapis-notes/commit/ad4490ca1cd808002765582a17a5c81fa5335e0d),
+  [`74f544e`](https://github.com/lapismd/lapis-notes/commit/74f544e2aa8a967524c0c218f3db7e1a495a1a17),
+  [`55be8dc`](https://github.com/lapismd/lapis-notes/commit/55be8dce6f7b19b0e8036be86a3cf5305db25317),
+  [`501c50e`](https://github.com/lapismd/lapis-notes/commit/501c50e049264560e13e29c75a74c089922c7297),
+  [`98b333f`](https://github.com/lapismd/lapis-notes/commit/98b333f73ff5ba8d5f28c52e4e3a2ceaa5ade0fb),
+  [`535a6cc`](https://github.com/lapismd/lapis-notes/commit/535a6cc7b39f397cf8761a06db7b831386121928),
+  [`8a27bc3`](https://github.com/lapismd/lapis-notes/commit/8a27bc36a7a7fa81594e517908a6f5ed8ca77313),
+  [`109e208`](https://github.com/lapismd/lapis-notes/commit/109e208a63253dcc1a7abad3fd5a9b13c39d3def),
+  [`1e64589`](https://github.com/lapismd/lapis-notes/commit/1e6458922b486c07f36a5bc7d85d020b5805cd49),
+  [`f828eae`](https://github.com/lapismd/lapis-notes/commit/f828eaeba8411aa342d7ab4954393e84612af2f3)]:
+  - @lapis-notes/api@0.2.0
+  - @lapis-notes/ui@0.1.4
+
+## 0.2.2
+
+### Patch Changes
+
+- [#36](https://github.com/lapismd/lapis-notes/pull/36)
+  [`17060a1`](https://github.com/lapismd/lapis-notes/commit/17060a1df152c9fc2302c93767cd7172868ff030)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Consume published Design
+  Core 0.5.0 with prepared browser CSS and bundled font assets through normal
+  npm ranges.
+- Updated dependencies
+  [[`17060a1`](https://github.com/lapismd/lapis-notes/commit/17060a1df152c9fc2302c93767cd7172868ff030)]:
+  - @lapis-notes/api@0.1.5
+
 ## 0.2.1
 
 ### Patch Changes
 
-- [#15](https://github.com/lapismd/lapis-notes/pull/15) [`57996c6`](https://github.com/lapismd/lapis-notes/commit/57996c6d26c1e7ed723df1291b415ee94d3a58e5) Thanks [@stevejuma](https://github.com/stevejuma)! - Retain selected plugin releases in navigation and persisted Plugins views so
-  application links can open a specific version. Fail closed for unavailable
-  versions and keep historical installation bound to the selected release.
+- [#15](https://github.com/lapismd/lapis-notes/pull/15)
+  [`57996c6`](https://github.com/lapismd/lapis-notes/commit/57996c6d26c1e7ed723df1291b415ee94d3a58e5)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Retain selected plugin
+  releases in navigation and persisted Plugins views so application links can
+  open a specific version. Fail closed for unavailable versions and keep
+  historical installation bound to the selected release.
 
 ## 0.2.0
 
 ### Minor Changes
 
-- [#4](https://github.com/lapismd/lapis-notes/pull/4) [`08a9e4b`](https://github.com/lapismd/lapis-notes/commit/08a9e4bc671c87484e1fbb7c3271b2aad3f176e5) Thanks [@stevejuma](https://github.com/stevejuma)! - Add the Plugins workspace browser with a category homepage, update listings,
-  responsive filters, and verified install/update actions shared with Settings.
-  Settings Browse and Updates now open shared plugin details directly. Details
-  include a Back action, fixed navigation, themed media, image loading and failure
-  states, release notes, download counts, and linked authors.
+- [#4](https://github.com/lapismd/lapis-notes/pull/4)
+  [`08a9e4b`](https://github.com/lapismd/lapis-notes/commit/08a9e4bc671c87484e1fbb7c3271b2aad3f176e5)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Add the Plugins workspace
+  browser with a category homepage, update listings, responsive filters, and
+  verified install/update actions shared with Settings. Settings Browse and
+  Updates now open shared plugin details directly. Details include a Back
+  action, fixed navigation, themed media, image loading and failure states,
+  release notes, download counts, and linked authors.
 
 ### Patch Changes
 
-- [#4](https://github.com/lapismd/lapis-notes/pull/4) [`c1ad3c4`](https://github.com/lapismd/lapis-notes/commit/c1ad3c4acee2eac1ae87c22f66e946d2e0db3bf2) Thanks [@stevejuma](https://github.com/stevejuma)! - Require published Design Core 0.3.2 for native window-controls spacing, bold settings headings, selected-tab indicators and mobile shell teardown. Consume the npm release through portable semver ranges and lockfile integrity.
+- [#4](https://github.com/lapismd/lapis-notes/pull/4)
+  [`c1ad3c4`](https://github.com/lapismd/lapis-notes/commit/c1ad3c4acee2eac1ae87c22f66e946d2e0db3bf2)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Require published Design
+  Core 0.3.2 for native window-controls spacing, bold settings headings,
+  selected-tab indicators and mobile shell teardown. Consume the npm release
+  through portable semver ranges and lockfile integrity.
 
-- Updated dependencies [[`39f886d`](https://github.com/lapismd/lapis-notes/commit/39f886d017a28d916b3f6cac7d08b7723a04f45b), [`c1ad3c4`](https://github.com/lapismd/lapis-notes/commit/c1ad3c4acee2eac1ae87c22f66e946d2e0db3bf2), [`1e949fc`](https://github.com/lapismd/lapis-notes/commit/1e949fc9d51b795a50760e1146a9599602746c6b)]:
+- Updated dependencies
+  [[`39f886d`](https://github.com/lapismd/lapis-notes/commit/39f886d017a28d916b3f6cac7d08b7723a04f45b),
+  [`c1ad3c4`](https://github.com/lapismd/lapis-notes/commit/c1ad3c4acee2eac1ae87c22f66e946d2e0db3bf2),
+  [`1e949fc`](https://github.com/lapismd/lapis-notes/commit/1e949fc9d51b795a50760e1146a9599602746c6b)]:
   - @lapis-notes/api@0.1.2
 
 ## 0.1.1
 
 ### Patch Changes
 
-- Support verified static V2 catalogs alongside Nostr sources, retain installation
-  source provenance, and render themed registry images and structured release notes.
+- Support verified static V2 catalogs alongside Nostr sources, retain
+  installation source provenance, and render themed registry images and
+  structured release notes.
 - Updated dependencies []:
   - @lapis-notes/api@0.1.1
 

package/README.md

@@ -11,6 +11,10 @@ backend setup.
 
 - `WorkspaceShell`, the Svelte component used by hosts and demos.
 - `WorkspaceShellProps`, the public prop contract for typed Svelte consumers.
+- `DesktopVaultLauncher` and `DesktopVaultLauncherHost`, the existing Deno
+  vault chooser with injected profile storage, appearance and native actions.
+- `DesktopWorkspaceStartup`, the shared Lapis-branded Design Core startup
+  presentation. Both native hosts pass actual phase progress and recovery actions.
 
 ## Usage
 
@@ -32,5 +36,5 @@ pnpm --filter @lapis-notes/workspace test
 
 ## References
 
-- [Package spec](spec.md)
-- [Canonical spec](../../spec/src/20-packages/workspace/index.md)
+- [Workspace contract](../../spec/src/workspace-shell.md)
+- [Canonical spec](../../spec/src/workspace-shell.md)

package/dist/WorkspaceShell.svelte

@@ -1,10 +1,15 @@
 <script lang="ts" module>
   import type { App } from "@lapis-notes/api";
   import type { WorkspaceNavigation } from "@lapismd/design-core/workspace/app-shell";
-  import type { WorkspaceRequestedDisplayMode } from "@lapismd/design-core/workspace/core";
+  import type {
+    WorkspaceRequestedDisplayMode,
+    WorkspacePopoutHost,
+  } from "@lapismd/design-core/workspace/core";
 
   export interface WorkspaceShellProps {
     app: App;
+    /** Optional host-owned popup creation policy. null disables detached windows. */
+    popoutHost?: WorkspacePopoutHost | null;
     displayMode?: WorkspaceRequestedDisplayMode;
     workspaceLabel?: string;
     workspaceNavigation?: WorkspaceNavigation;
@@ -14,14 +19,19 @@
 
 <script lang="ts">
   import { onMount, untrack } from "svelte";
-  import { provideApplicationState } from "@lapis-notes/api";
+  import {
+    bindNativeEditingProblems,
+    provideApplicationState,
+  } from "@lapis-notes/api";
   import { getWorkspaceHostBinding } from "@lapis-notes/api/workspace-host";
   import { AppShell } from "@lapismd/design-core/workspace/app-shell";
+  import { bindFileConflictReviews } from "./file-conflicts/register-conflict-reviews";
   import "./workspace-shell.css";
 
   let {
     app,
     displayMode,
+    popoutHost,
     workspaceLabel = "Lapis Notes",
     workspaceNavigation,
     class: className = "",
@@ -39,6 +49,12 @@
     // AppShell.Root does not own startup. By the time this shell is mounted,
     // the consumer has loaded the vault and restored the Lapis workspace.
     void controller.start();
+    const stopNative = bindNativeEditingProblems(app);
+    const stopConflicts = bindFileConflictReviews(app);
+    return () => {
+      stopConflicts();
+      stopNative();
+    };
   });
 </script>
 
@@ -49,6 +65,7 @@
 >
   <AppShell.Root
     {controller}
+    {popoutHost}
     autoStart={false}
     {activateNewTabs}
     disposeOnDestroy={false}

package/dist/WorkspaceShell.svelte.d.ts

@@ -1,8 +1,10 @@
 import type { App } from "@lapis-notes/api";
 import type { WorkspaceNavigation } from "@lapismd/design-core/workspace/app-shell";
-import type { WorkspaceRequestedDisplayMode } from "@lapismd/design-core/workspace/core";
+import type { WorkspaceRequestedDisplayMode, WorkspacePopoutHost } from "@lapismd/design-core/workspace/core";
 export interface WorkspaceShellProps {
     app: App;
+    /** Optional host-owned popup creation policy. null disables detached windows. */
+    popoutHost?: WorkspacePopoutHost | null;
     displayMode?: WorkspaceRequestedDisplayMode;
     workspaceLabel?: string;
     workspaceNavigation?: WorkspaceNavigation;

package/dist/desktop/DesktopRecoveryBanner.css

@@ -0,0 +1,46 @@
+.desktop-recovery-banner {
+  position: absolute;
+  z-index: 80;
+  inset-block-end: 0.75rem;
+  inset-inline-start: 50%;
+  display: flex;
+  width: min(56rem, calc(100% - 2rem));
+  box-sizing: border-box;
+  align-items: center;
+  gap: 1rem;
+  padding: 0.75rem 1rem;
+  border: 1px solid var(--ui-workspace-border);
+  border-radius: var(--ui-radius, 0.625rem);
+  color: var(--ui-workspace-foreground);
+  background: var(--ui-workspace-background, var(--background));
+  box-shadow: var(--ui-workspace-shadow-lg, 0 12px 30px rgb(0 0 0 / 16%));
+  translate: -50% 0;
+}
+.desktop-recovery-banner__message {
+  display: flex;
+  min-width: 0;
+  flex: 1;
+  flex-direction: column;
+  gap: 0.125rem;
+  font-size: 0.75rem;
+  color: var(--ui-workspace-muted-foreground);
+}
+.desktop-recovery-banner__message strong {
+  font-size: 0.875rem;
+  color: var(--ui-workspace-foreground);
+}
+.desktop-recovery-banner__actions {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: flex-end;
+  gap: 0.5rem;
+}
+@media (width < 48rem) {
+  .desktop-recovery-banner {
+    align-items: stretch;
+    flex-direction: column;
+  }
+  .desktop-recovery-banner__actions {
+    justify-content: flex-start;
+  }
+}

package/dist/desktop/DesktopRecoveryBanner.svelte

@@ -0,0 +1,70 @@
+<script lang="ts">
+  import DatabaseIcon from "@lucide/svelte/icons/database";
+  import SearchIcon from "@lucide/svelte/icons/search";
+  import RotateCcwIcon from "@lucide/svelte/icons/rotate-ccw";
+  import * as Button from "@lapismd/design-core/shadcn/button";
+  import "./DesktopRecoveryBanner.css";
+
+  let {
+    reasons = [],
+    lastFailure = "",
+    message = "",
+    metadataBusy = false,
+    searchBusy = false,
+    disabled = false,
+    onRebuildMetadata,
+    onRebuildSearch,
+    onRestart,
+  }: {
+    reasons?: readonly string[];
+    lastFailure?: string;
+    message?: string;
+    metadataBusy?: boolean;
+    searchBusy?: boolean;
+    disabled?: boolean;
+    onRebuildMetadata(): Promise<void>;
+    onRebuildSearch(): Promise<void>;
+    onRestart(): Promise<void>;
+  } = $props();
+</script>
+
+<div
+  class="desktop-recovery-banner"
+  role="status"
+  aria-label="Safe Mode"
+  data-ui-component="desktop-recovery-banner"
+  data-ui-part="root"
+  data-desktop-drag-region="false"
+>
+  <div class="desktop-recovery-banner__message">
+    <strong>Safe Mode is active</strong>
+    <span
+      >{reasons.length
+        ? reasons.join(". ")
+        : "Startup recovery restrictions are active for this session."}</span
+    >
+    {#if lastFailure}<span>Last failure: {lastFailure}</span>{/if}
+    {#if message}<span>{message}</span>{/if}
+  </div>
+  <div class="desktop-recovery-banner__actions">
+    <Button.Root
+      variant="outline"
+      disabled={disabled || metadataBusy}
+      onclick={onRebuildMetadata}
+    >
+      <DatabaseIcon aria-hidden="true" />
+      {metadataBusy ? "Rebuilding metadata…" : "Rebuild metadata"}
+    </Button.Root>
+    <Button.Root
+      variant="outline"
+      disabled={disabled || searchBusy}
+      onclick={onRebuildSearch}
+    >
+      <SearchIcon aria-hidden="true" />
+      {searchBusy ? "Rebuilding Search…" : "Rebuild Search"}
+    </Button.Root>
+    <Button.Root {disabled} onclick={onRestart}>
+      <RotateCcwIcon aria-hidden="true" />Restart normally
+    </Button.Root>
+  </div>
+</div>

package/dist/desktop/DesktopRecoveryBanner.svelte.d.ts

@@ -0,0 +1,15 @@
+import "./DesktopRecoveryBanner.css";
+type $$ComponentProps = {
+    reasons?: readonly string[];
+    lastFailure?: string;
+    message?: string;
+    metadataBusy?: boolean;
+    searchBusy?: boolean;
+    disabled?: boolean;
+    onRebuildMetadata(): Promise<void>;
+    onRebuildSearch(): Promise<void>;
+    onRestart(): Promise<void>;
+};
+declare const DesktopRecoveryBanner: import("svelte").Component<$$ComponentProps, {}, "">;
+type DesktopRecoveryBanner = ReturnType<typeof DesktopRecoveryBanner>;
+export default DesktopRecoveryBanner;

package/dist/desktop/DesktopVaultLauncher.svelte

@@ -0,0 +1,278 @@
+<script lang="ts">
+  import Archive from "@lucide/svelte/icons/archive";
+  import Copy from "@lucide/svelte/icons/copy";
+  import Ellipsis from "@lucide/svelte/icons/ellipsis";
+  import FolderInput from "@lucide/svelte/icons/folder-input";
+  import FolderOpen from "@lucide/svelte/icons/folder-open";
+  import FolderPlus from "@lucide/svelte/icons/folder-plus";
+  import PenLine from "@lucide/svelte/icons/pen-line";
+  import Settings from "@lucide/svelte/icons/settings";
+  import X from "@lucide/svelte/icons/x";
+  import type { VaultProfile } from "@lapis-notes/api";
+  import * as Button from "@lapismd/design-core/shadcn/button";
+  import * as Card from "@lapismd/design-core/shadcn/card";
+  import * as DropdownMenu from "@lapismd/design-core/shadcn/dropdown-menu";
+  import { onMount, untrack } from "svelte";
+  import { DesktopVaultLauncherState } from "./desktop-vault-launcher.svelte";
+  import {
+    getVaultProfileLocation,
+    getVaultProfileRootPath,
+    type LauncherStatus,
+    type DesktopVaultLauncherHost,
+  } from "./desktop-vault-launcher";
+  import DesktopVaultLauncherDialogs from "./DesktopVaultLauncherDialogs.svelte";
+  import lapisLogo from "./lapis-logo.svg";
+  import "./desktop-vault-launcher.css";
+  import "./desktop-vault-launcher-controls.css";
+  let {
+    status,
+    errorMessage = "",
+    canReturn = false,
+    host,
+    onCreate,
+    onOpen,
+    onOpenRecent,
+    onClose,
+  }: {
+    status: LauncherStatus;
+    errorMessage?: string;
+    canReturn?: boolean;
+    host: DesktopVaultLauncherHost;
+    onCreate(): Promise<void>;
+    onOpen(): Promise<void>;
+    onOpenRecent(profile: VaultProfile): Promise<void>;
+    onClose?(): void;
+  } = $props();
+  const model = new DesktopVaultLauncherState(untrack(() => host));
+  const busy = $derived(status === "loading" || status === "opening");
+  const visibleError = $derived(errorMessage || model.actionError);
+  const actionClass = "desktop-launcher__action";
+  const outlineActionClass = `${actionClass} desktop-launcher__outline`;
+  onMount(() => {
+    void model.refresh();
+  });
+</script>
+
+<section
+  class="desktop-launcher"
+  data-ui-component="desktop-vault-launcher"
+  data-desktop-vault-launcher
+  data-desktop-drag-region
+  aria-label="Vaults"
+  aria-busy={busy}
+>
+  <div
+    class="desktop-launcher__content"
+    data-desktop-vault-launcher-content
+    data-desktop-drag-region="false"
+  >
+    <div class="desktop-launcher__header">
+      <div class="desktop-launcher__brand">
+        <img src={lapisLogo} alt="" class="desktop-launcher__logo" />
+        <div class="desktop-launcher__copy">
+          <div class="desktop-launcher__eyebrow">Lapis Notes</div>
+          <h1 class="desktop-launcher__heading">
+            {model.recentVaults.length === 0
+              ? "Create a vault"
+              : "Open a vault"}
+          </h1>
+          <p class="desktop-launcher__description">
+            {#if model.recentVaults.length === 0}
+              Start a new vault on this Mac, or open an existing folder if you
+              already have one.
+            {:else}
+              Jump back into a recent vault or create a new one on this Mac.
+            {/if}
+          </p>
+        </div>
+      </div>
+      <div class="desktop-launcher__header-actions">
+        <Button.Root
+          variant="link"
+          size="sm"
+          class="desktop-launcher__settings-trigger"
+          onclick={() => (model.settingsOpen = true)}
+        >
+          <Settings class="desktop-launcher__icon" />
+          Settings
+        </Button.Root>
+        {#if canReturn}
+          <Button.Root
+            type="button"
+            variant="secondary"
+            size="icon-lg"
+            class="desktop-launcher__close"
+            aria-label="Return to previous vault"
+            onclick={() => onClose?.()}
+          >
+            <X class="desktop-launcher__large-icon" />
+          </Button.Root>
+        {/if}
+      </div>
+    </div>
+
+    {#if visibleError}
+      <div class="desktop-launcher__error" role="alert">
+        {visibleError}
+      </div>
+    {:else if model.actionMessage}
+      <div class="desktop-launcher__message" role="status">
+        {model.actionMessage}
+      </div>
+    {/if}
+
+    <div class="desktop-launcher__columns">
+      <Card.Root class="desktop-launcher__actions desktop-launcher__card">
+        <Card.Header class="desktop-launcher__card-header">
+          <Card.Title class="desktop-launcher__card-title">
+            {model.recentVaults.length === 0
+              ? "New Desktop Vault"
+              : "Desktop Vaults"}
+          </Card.Title>
+          <Card.Description>
+            {model.recentVaults.length === 0
+              ? "Create a new vault directory first, or open an existing folder."
+              : "Choose an existing folder or create a new vault directory."}
+          </Card.Description>
+        </Card.Header>
+        <Card.Content class="desktop-launcher__action-list">
+          <Button.Root
+            variant={model.recentVaults.length === 0 ? "default" : "outline"}
+            class={model.recentVaults.length === 0
+              ? actionClass
+              : outlineActionClass}
+            disabled={busy}
+            onclick={() => void model.invoke(onCreate)}
+          >
+            <FolderPlus class="desktop-launcher__large-icon" />
+            <span class="desktop-launcher__action-copy">
+              <span class="desktop-launcher__label">Create New Vault</span>
+              <span class="desktop-launcher__hint">
+                Pick a new folder location and open it immediately.
+              </span>
+            </span>
+          </Button.Root>
+          <Button.Root
+            variant={model.recentVaults.length === 0 ? "outline" : "default"}
+            class={model.recentVaults.length === 0
+              ? outlineActionClass
+              : actionClass}
+            disabled={busy}
+            onclick={() => void model.invoke(onOpen)}
+          >
+            <FolderOpen class="desktop-launcher__large-icon" />
+            <span class="desktop-launcher__action-copy">
+              <span class="desktop-launcher__label">Open Vault</span>
+              <span class="desktop-launcher__hint">
+                Choose a folder you have already been using as a vault.
+              </span>
+            </span>
+          </Button.Root>
+        </Card.Content>
+      </Card.Root>
+
+      <Card.Root class="desktop-launcher__recents desktop-launcher__card">
+        <Card.Header class="desktop-launcher__card-header">
+          <div class="desktop-launcher__recents-header">
+            <div>
+              <Card.Title class="desktop-launcher__card-title"
+                >Recent Projects</Card.Title
+              >
+              <Card.Description
+                >Recently opened vaults stored on this device.</Card.Description
+              >
+            </div>
+            {#if model.recentVaults.length > 0}
+              <Button.Root
+                variant="link"
+                size="sm"
+                class="desktop-launcher__link"
+                onclick={() => (model.recentVaultDialogOpen = true)}
+              >
+                View all
+              </Button.Root>
+            {/if}
+          </div>
+        </Card.Header>
+        <Card.Content class="desktop-launcher__recent-list">
+          {#if model.inlineRecentVaults.length > 0}
+            {#each model.inlineRecentVaults as profile (profile.id)}
+              <div class="desktop-launcher__recent">
+                <button
+                  class="desktop-launcher__recent-open"
+                  data-ui-part="recent-open"
+                  type="button"
+                  disabled={busy || model.activeActionId === profile.id}
+                  onclick={() => void model.invoke(() => onOpenRecent(profile))}
+                >
+                  <FolderOpen class="desktop-launcher__recent-icon" />
+                  <span class="desktop-launcher__recent-copy">
+                    <span class="desktop-launcher__recent-name"
+                      >{profile.name}</span
+                    >
+                    <span class="desktop-launcher__location"
+                      >{getVaultProfileLocation(profile)}</span
+                    >
+                  </span>
+                </button>
+                {#if host.copyId || host.rename || host.move || host.reveal || host.remove}
+                  <DropdownMenu.Root>
+                    <DropdownMenu.Trigger
+                      class="desktop-launcher__recent-menu"
+                      aria-label={`Open actions for ${profile.name}`}
+                      title={`Open actions for ${profile.name}`}
+                      disabled={busy || model.activeActionId === profile.id}
+                    >
+                      <Ellipsis class="desktop-launcher__icon" />
+                    </DropdownMenu.Trigger>
+                    <DropdownMenu.Content align="end" side="bottom">
+                      {#if host.copyId}<DropdownMenu.Item
+                          onclick={() => void model.copyVaultId(profile)}
+                        >
+                          <Copy class="desktop-launcher__icon" />
+                          Copy vault ID
+                        </DropdownMenu.Item>{/if}
+                      {#if host.rename}<DropdownMenu.Item
+                          onclick={() => model.openRenameDialog(profile)}
+                        >
+                          <PenLine class="desktop-launcher__icon" />
+                          Rename vault...
+                        </DropdownMenu.Item>{/if}
+                      {#if host.move}<DropdownMenu.Item
+                          disabled={!getVaultProfileRootPath(profile)}
+                          onclick={() => void model.moveRecentVault(profile)}
+                        >
+                          <FolderInput class="desktop-launcher__icon" />
+                          Move vault...
+                        </DropdownMenu.Item>{/if}
+                      {#if host.reveal}<DropdownMenu.Item
+                          disabled={!getVaultProfileRootPath(profile)}
+                          onclick={() => void model.revealRecentVault(profile)}
+                        >
+                          <FolderOpen class="desktop-launcher__icon" />
+                          {host.revealLabel ?? "Reveal vault in file manager"}
+                        </DropdownMenu.Item>{/if}
+                      {#if host.remove}<DropdownMenu.Separator />{/if}
+                      {#if host.remove}<DropdownMenu.Item
+                          onclick={() => void model.removeRecentVault(profile)}
+                        >
+                          <Archive class="desktop-launcher__icon" />
+                          Remove from list
+                        </DropdownMenu.Item>{/if}
+                    </DropdownMenu.Content>
+                  </DropdownMenu.Root>
+                {/if}
+              </div>
+            {/each}
+          {:else}
+            <div class="desktop-launcher__empty">
+              Your recent vaults will appear here after you create or open one.
+            </div>
+          {/if}
+        </Card.Content>
+      </Card.Root>
+    </div>
+  </div>
+</section>
+
+<DesktopVaultLauncherDialogs {model} {onOpenRecent} />