@bendyline/docblocks 2.7.2 → 2.7.4

package/dist/reconcile-electron-Bz-iAY_B.d.ts

@@ -0,0 +1,142 @@
+import { d as FileSystemProvider } from './types-DLteNrK0.js';
+import { Z as ElectronWorkspaceInfo, aj as HostEnvironment } from './capabilities-BJEkIsO1.js';
+
+/**
+ * Origin of a transient workspace — records where its contents came from and
+ * how to save them back. Set only on `type: 'transient'` workspaces.
+ * - 'loose-file' — a single markdown file opened from the OS (Electron);
+ *   edits write back through an owner-scoped `resourceId` grant.
+ * - 'dbk' — a `.dbk`/zip bundle unpacked into memory (Electron); edits are
+ *   re-zipped and written back through an owner-scoped resource grant.
+ * - 'web-file' — a single markdown file launched into the installed web app
+ *   (File Handling API); edits write back through `handle`.
+ * - 'web-dbk' — a `.dbk`/zip bundle launched into the installed web app;
+ *   edits are re-zipped and written back through `handle`.
+ *
+ * The web variants hold a live `FileSystemFileHandle`. That is safe because
+ * transient descriptors are never persisted — they live only in the
+ * in-memory registry (see workspace-manager) for the current page session.
+ */
+type TransientOrigin = {
+    kind: 'loose-file';
+    resourceId: string;
+} | {
+    kind: 'dbk';
+    resourceId: string;
+    /** SHA-256 of the last bundle version acknowledged by the host. */
+    version: string | null;
+} | {
+    kind: 'web-file';
+    handle: FileSystemFileHandle;
+    name: string;
+} | {
+    kind: 'web-dbk';
+    handle: FileSystemFileHandle;
+    name: string;
+    /** SHA-256 of the last bundle version observed on disk. */
+    version: string | null;
+};
+/**
+ * Workspace — a named binding to a FileSystemProvider, representing
+ * the user's current working context (a folder of markdown files).
+ */
+interface WorkspaceDescriptor {
+    /** Unique stable identifier (persisted in IndexedDB). */
+    id: string;
+    /** User-visible label. */
+    name: string;
+    /**
+     * Provider kind:
+     * - 'indexeddb' — browser-local storage (web only)
+     * - 'native' — File System Access API (web Chrome/Edge only)
+     * - 'host-native' — Electron main-process native filesystem
+     * - 'transient' — session-only, in-memory (a loose file/`.dbk` opened from
+     *   the OS, or a document copied from a shared URL). Never persisted; its
+     *   provider lives in an in-memory registry (see workspace-manager). An
+     *   `origin` is present only when changes can be saved back externally.
+     */
+    type: 'indexeddb' | 'native' | 'host-native' | 'transient';
+    /** ISO timestamp of last access. */
+    lastOpened: string;
+    /** Absolute filesystem path for 'host-native' workspaces. */
+    rootPath?: string;
+    /** For 'transient' workspaces: where the contents came from / save back to. */
+    origin?: TransientOrigin;
+    /**
+     * Per-workspace override for the global versioning preference. When
+     * `'inherit'` (or absent), the global preference applies. `'on'` /
+     * `'off'` force the corresponding behavior regardless of the global
+     * setting. See `resolveVersioningEnabled` in the preferences module.
+     */
+    versioningOverride?: 'inherit' | 'on' | 'off';
+}
+
+/** Parse the complete persisted workspace list before it reaches startup code. */
+declare function parsePersistedWorkspaceList(value: unknown): WorkspaceDescriptor[];
+
+/**
+ * WorkspaceManager — manages the list of known workspaces in IndexedDB
+ * and provides helpers for creating / switching / removing them.
+ *
+ * The actual FileSystemProvider instances are created by the caller
+ * (since native providers need a DirectoryHandle from user interaction).
+ */
+
+/** Id of the browser-local workspace `ensureDefaultWorkspace` creates. */
+declare const DEFAULT_WORKSPACE_ID = "default";
+/** Register a transient workspace and its (already-built) provider. */
+declare function registerTransientWorkspace(descriptor: WorkspaceDescriptor, provider: FileSystemProvider): void;
+/** Look up a transient workspace (descriptor + provider) by id, if any. */
+declare function getTransientWorkspace(id: string): {
+    descriptor: WorkspaceDescriptor;
+    provider: FileSystemProvider;
+} | null;
+/** Forget a transient workspace (e.g. when it is closed). */
+declare function unregisterTransientWorkspace(id: string): Promise<void>;
+/**
+ * Get all known workspace descriptors — persisted plus any session-only
+ * transient ones (so they show in the picker and resolve for the session).
+ */
+declare function listWorkspaces(): Promise<WorkspaceDescriptor[]>;
+/**
+ * Get a specific workspace descriptor by id (transient or persisted).
+ */
+declare function getWorkspace(id: string): Promise<WorkspaceDescriptor | null>;
+/**
+ * Add or update a workspace descriptor. If a workspace with the same id
+ * already exists, it is replaced. Transient workspaces are never persisted.
+ */
+declare function saveWorkspace(workspace: WorkspaceDescriptor): Promise<void>;
+/**
+ * Remove a workspace descriptor by id (transient or persisted).
+ */
+declare function removeWorkspace(id: string): Promise<void>;
+/**
+ * Touch the lastOpened timestamp on a workspace. For transient workspaces this
+ * updates the in-memory descriptor only (nothing is persisted).
+ */
+declare function touchWorkspace(id: string): Promise<void>;
+/**
+ * Ensure a default IndexedDB workspace exists. Called on app startup.
+ * Returns the descriptor.
+ */
+declare function ensureDefaultWorkspace(): Promise<WorkspaceDescriptor>;
+
+interface ElectronWorkspaceReconciliation {
+    /** Obsolete renderer descriptors to remove before attempting restoration. */
+    readonly removeIds: readonly string[];
+    /** Canonical main-authorized descriptors to insert or replace. */
+    readonly upsert: readonly WorkspaceDescriptor[];
+    /** Safe navigation migration for a local descriptor matched by root. */
+    readonly idRemap: Readonly<Record<string, string>>;
+}
+/**
+ * Reconcile renderer IndexedDB metadata with the main process authority list.
+ * `hostWorkspaces` is authoritative: local Electron descriptors absent from
+ * it cannot be opened safely and are removed. Root-path matching carries user
+ * metadata across an id migration without treating that display path as
+ * authority.
+ */
+declare function reconcileElectronWorkspaceDescriptors(local: readonly WorkspaceDescriptor[], hostWorkspaces: readonly ElectronWorkspaceInfo[], platform: HostEnvironment['platform'], now: string): ElectronWorkspaceReconciliation;
+
+export { DEFAULT_WORKSPACE_ID as D, type ElectronWorkspaceReconciliation as E, type TransientOrigin as T, type WorkspaceDescriptor as W, getWorkspace as a, registerTransientWorkspace as b, removeWorkspace as c, ensureDefaultWorkspace as e, getTransientWorkspace as g, listWorkspaces as l, parsePersistedWorkspaceList as p, reconcileElectronWorkspaceDescriptors as r, saveWorkspace as s, touchWorkspace as t, unregisterTransientWorkspace as u };

package/dist/{types-BvDnr3YU.d.ts → types-DLteNrK0.d.ts}

@@ -1,4 +1,4 @@
-import { n as FileSystemProviderV2 } from './v2-BVnZZyd4.js';
+import { g as FileSystemEntryReadIssue, o as FileSystemProviderV2 } from './v2-DwxWjFC0.js';
 
 /**
  * FileSystemProvider — abstract interface for a virtual filesystem.
@@ -14,6 +14,8 @@ interface FileEntry {
     path: string;
     /** ISO-8601 timestamp when the provider can supply file metadata while listing. */
     lastModified?: string;
+    /** Set when the provider listed the file but could not read it at the time. */
+    readIssue?: FileSystemEntryReadIssue;
 }
 interface FolderEntry {
     kind: 'directory';

package/dist/{v2-BVnZZyd4.d.ts → v2-DwxWjFC0.d.ts}

@@ -92,9 +92,20 @@ interface FileSystemEntrySnapshotBase {
     /** ISO-8601 timestamp supplied by the backend; versions remain authoritative. */
     readonly lastModified: string;
 }
+/** Why a listed file's bytes could not be read when it was observed. */
+interface FileSystemEntryReadIssue {
+    readonly code: FsErrorCode;
+    readonly message: string;
+}
 interface FileSystemFileSnapshot extends FileSystemEntrySnapshotBase {
     readonly kind: 'file';
     readonly size: number;
+    /**
+     * Present when a listing or watch observation could not read the file (a
+     * sync client holding it, an ACL). The entry stays listed, but its version
+     * then reflects metadata only; callers needing content must read the file.
+     */
+    readonly readIssue?: FileSystemEntryReadIssue;
 }
 interface FileSystemDirectorySnapshot extends FileSystemEntrySnapshotBase {
     readonly kind: 'directory';
@@ -215,4 +226,4 @@ interface FileSystemProviderV2 {
     dispose(): Promise<void>;
 }
 
-export { type FileSystemWatchOptions as A, type FileSystemWatchSubscription as B, type FileSystemWriteMode as C, type FileSystemWriteOptions as D, FsError as E, type FileSystemAtomicity as F, type FsErrorCode as G, type FsErrorContext as H, type FsOperation as I, deserializeFsError as J, fsErrorFromUnknown as K, isQuotaExceededError as L, isSerializedFsError as M, mapDomExceptionToFsErrorCode as N, mapNodeErrorCodeToFsErrorCode as O, parseFileSystemVersion as P, serializeFsError as Q, tryParseFileSystemVersion as R, type SerializedFsError as S, type FileSystemCaseSensitivity as a, type FileSystemConditionalWriteStrength as b, type FileSystemCreateDirectoryMode as c, type FileSystemCreateDirectoryOptions as d, type FileSystemDirectorySnapshot as e, type FileSystemDurability as f, type FileSystemEntrySnapshot as g, type FileSystemEntryWatchEvent as h, type FileSystemFileRead as i, type FileSystemFileSnapshot as j, type FileSystemMoveOptions as k, type FileSystemOverflowWatchEvent as l, type FileSystemProviderCapabilities as m, type FileSystemProviderV2 as n, type FileSystemRemoveOptions as o, type FileSystemRemoveResult as p, type FileSystemSnapshot as q, type FileSystemSnapshotEntry as r, type FileSystemSnapshotFile as s, type FileSystemSymlinkPolicy as t, type FileSystemVersion as u, type FileSystemWatchErrorListener as v, type FileSystemWatchEvent as w, type FileSystemWatchEventOrigin as x, type FileSystemWatchEventType as y, type FileSystemWatchListener as z };
+export { type FileSystemWatchListener as A, type FileSystemWatchOptions as B, type FileSystemWatchSubscription as C, type FileSystemWriteMode as D, type FileSystemWriteOptions as E, type FileSystemAtomicity as F, FsError as G, type FsErrorCode as H, type FsErrorContext as I, type FsOperation as J, deserializeFsError as K, fsErrorFromUnknown as L, isQuotaExceededError as M, isSerializedFsError as N, mapDomExceptionToFsErrorCode as O, mapNodeErrorCodeToFsErrorCode as P, parseFileSystemVersion as Q, serializeFsError as R, type SerializedFsError as S, tryParseFileSystemVersion as T, type FileSystemCaseSensitivity as a, type FileSystemConditionalWriteStrength as b, type FileSystemCreateDirectoryMode as c, type FileSystemCreateDirectoryOptions as d, type FileSystemDirectorySnapshot as e, type FileSystemDurability as f, type FileSystemEntryReadIssue as g, type FileSystemEntrySnapshot as h, type FileSystemEntryWatchEvent as i, type FileSystemFileRead as j, type FileSystemFileSnapshot as k, type FileSystemMoveOptions as l, type FileSystemOverflowWatchEvent as m, type FileSystemProviderCapabilities as n, type FileSystemProviderV2 as o, type FileSystemRemoveOptions as p, type FileSystemRemoveResult as q, type FileSystemSnapshot as r, type FileSystemSnapshotEntry as s, type FileSystemSnapshotFile as t, type FileSystemSymlinkPolicy as u, type FileSystemVersion as v, type FileSystemWatchErrorListener as w, type FileSystemWatchEvent as x, type FileSystemWatchEventOrigin as y, type FileSystemWatchEventType as z };

package/dist/vscode/index.d.ts

@@ -5,6 +5,11 @@ import '../workspace-path-CWVrcuPL.js';
  * Typed message protocol between the extension host and webview.
  */
 
+interface WikiSuggestionMessage {
+    target: string;
+    label: string;
+    kind: 'article' | 'folder';
+}
 /**
  * Bounds for host-persisted proofing state.
  *
@@ -49,7 +54,7 @@ declare const DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MAX = 2.4;
  * registry, and the VS Code `package.json` enum in sync. `'theme'` is the
  * default and means "inherit from the active theme override".
  */
-declare const DOCBLOCKS_WRITE_CANVAS_FONT_SCHEMES: readonly ["theme", "serif-sans", "sans-sans", "serif-serif", "pt-serif", "hanken", "playfair-pt-serif", "hanken-lora", "dm-serif-dm-sans", "inter"];
+declare const DOCBLOCKS_WRITE_CANVAS_FONT_SCHEMES: readonly ["theme", "serif-sans", "sans-sans", "serif-serif", "pt-serif", "hanken", "playfair-pt-serif", "hanken-lora", "dm-serif-dm-sans", "inter", "inconsolata"];
 type DocBlocksWriteCanvasFontScheme = (typeof DOCBLOCKS_WRITE_CANVAS_FONT_SCHEMES)[number];
 interface VscodeWriteCanvasSettings {
     textSize: number;
@@ -198,6 +203,18 @@ type ExtensionToWebviewMessage = {
     type: 'workspaceFileRead';
     requestId: number;
     dataBase64: string | null;
+} | {
+    type: 'wikiLinkResult';
+    requestId: number;
+    exists: boolean;
+} | {
+    type: 'wikiSuggestions';
+    requestId: number;
+    items: WikiSuggestionMessage[];
+} | {
+    type: 'wikiLinkError';
+    requestId: number;
+    message: string;
 } | {
     type: 'workspaceFileError';
     requestId: number;
@@ -233,6 +250,15 @@ type WebviewToExtensionMessage = {
 } | {
     type: 'openLink';
     href: string;
+} | {
+    type: 'wikiSuggestRequest';
+    requestId: number;
+    query: string;
+} | {
+    type: 'wikiLinkRequest';
+    requestId: number;
+    target: string;
+    action: 'exists' | 'open' | 'create';
 } | {
     type: 'copyCode';
     requestId: number;
@@ -354,4 +380,4 @@ declare function isSafeMimeType(value: unknown): value is string;
  */
 declare function hasSubstantiveTextChange(baseline: string, candidate: string): boolean;
 
-export { DEFAULT_VSCODE_PROOFING_SETTINGS, DEFAULT_VSCODE_WRITE_CANVAS_SETTINGS, DOCBLOCKS_ACCENT_COLORS, DOCBLOCKS_WRITE_CANVAS_FONT_SCHEMES, DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MAX, DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MIN, DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MAX, DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MIN, type DocBlocksAccentColor, type DocBlocksWriteCanvasFontScheme, type DocumentConflictChoice, type DocumentConflictDetailsMessage, type DocumentSessionMessageStatus, type ExportTargetGrantMessage, type ExtensionToWebviewMessage, type MediaEntryMessage, PROOF_STATE_LIMITS, VSCODE_CATALOG_STATES, VSCODE_WORKSPACE_SETTINGS_STATUSES, type VscodeCatalogState, type VscodeEditorSettings, type VscodeProofingSettings, type VscodeWorkspaceSettingsState, type VscodeWorkspaceSettingsStatus, type VscodeWriteCanvasSettings, type WebviewToExtensionMessage, hasSubstantiveTextChange, isDocBlocksAccentColor, isDocBlocksWriteCanvasFontScheme, isDocBlocksWriteCanvasLineSpacing, isDocBlocksWriteCanvasTextSize, isSafeExportFilename, isSafeMimeType, normalizeDocBlocksAccentColor, parseExtensionToWebviewMessage, parseVscodeWorkspaceSettingsState, parseWebviewToExtensionMessage };
+export { DEFAULT_VSCODE_PROOFING_SETTINGS, DEFAULT_VSCODE_WRITE_CANVAS_SETTINGS, DOCBLOCKS_ACCENT_COLORS, DOCBLOCKS_WRITE_CANVAS_FONT_SCHEMES, DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MAX, DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MIN, DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MAX, DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MIN, type DocBlocksAccentColor, type DocBlocksWriteCanvasFontScheme, type DocumentConflictChoice, type DocumentConflictDetailsMessage, type DocumentSessionMessageStatus, type ExportTargetGrantMessage, type ExtensionToWebviewMessage, type MediaEntryMessage, PROOF_STATE_LIMITS, VSCODE_CATALOG_STATES, VSCODE_WORKSPACE_SETTINGS_STATUSES, type VscodeCatalogState, type VscodeEditorSettings, type VscodeProofingSettings, type VscodeWorkspaceSettingsState, type VscodeWorkspaceSettingsStatus, type VscodeWriteCanvasSettings, type WebviewToExtensionMessage, type WikiSuggestionMessage, hasSubstantiveTextChange, isDocBlocksAccentColor, isDocBlocksWriteCanvasFontScheme, isDocBlocksWriteCanvasLineSpacing, isDocBlocksWriteCanvasTextSize, isSafeExportFilename, isSafeMimeType, normalizeDocBlocksAccentColor, parseExtensionToWebviewMessage, parseVscodeWorkspaceSettingsState, parseWebviewToExtensionMessage };

package/dist/vscode/index.js

@@ -1,15 +1,18 @@
 import {
   parseWorkspaceSettings,
   parseWorkspaceSettingsPatch
-} from "../chunk-UK7R3RC7.js";
+} from "../chunk-BC42VRYW.js";
 import {
   HOST_WIRE_LIMITS,
   isBoundedString
 } from "../chunk-46AGYHDY.js";
-import "../chunk-AYWKIZLD.js";
+import "../chunk-UTH3HYCZ.js";
 
 // src/vscode/messages.ts
 var MAX_REQUEST_ID = 2147483647;
+function isWikiSuggestion(value) {
+  return isRecord(value) && hasOnlyKeys(value, ["target", "label", "kind"]) && hasBoundedString(value, "target", 2048, 1) && hasBoundedString(value, "label", 2048, 1) && (value.kind === "article" || value.kind === "folder");
+}
 var PROOF_STATE_LIMITS = Object.freeze({
   dictionaryWords: 5e3,
   wordCharacters: 128,
@@ -38,7 +41,8 @@ var DOCBLOCKS_WRITE_CANVAS_FONT_SCHEMES = [
   "playfair-pt-serif",
   "hanken-lora",
   "dm-serif-dm-sans",
-  "inter"
+  "inter",
+  "inconsolata"
 ];
 var DEFAULT_VSCODE_WRITE_CANVAS_SETTINGS = {
   textSize: 16,
@@ -80,6 +84,15 @@ function parseWebviewToExtensionMessage(value) {
     }
     case "openLink":
       return hasOnlyKeys(value, ["type", "href"]) && hasBoundedString(value, "href", HOST_WIRE_LIMITS.urlCharacters, 1) ? { type: "openLink", href: value.href } : null;
+    case "wikiSuggestRequest":
+      return hasOnlyKeys(value, ["type", "requestId", "query"]) && hasRequestId(value) && hasBoundedString(value, "query", 2048, 0) ? { type: "wikiSuggestRequest", requestId: value.requestId, query: value.query } : null;
+    case "wikiLinkRequest":
+      return hasOnlyKeys(value, ["type", "requestId", "target", "action"]) && hasRequestId(value) && hasBoundedString(value, "target", 2048, 1) && (value.action === "exists" || value.action === "open" || value.action === "create") ? {
+        type: "wikiLinkRequest",
+        requestId: value.requestId,
+        target: value.target,
+        action: value.action
+      } : null;
     case "copyCode":
       return hasOnlyKeys(value, ["type", "requestId", "code"]) && hasRequestId(value) && hasBoundedString(value, "code", HOST_WIRE_LIMITS.documentCharacters) ? { type: "copyCode", requestId: value.requestId, code: value.code } : null;
     case "edit":
@@ -299,6 +312,7 @@ function parseExtensionToWebviewMessage(value) {
     case "exportError":
     case "proofStateError":
     case "workspaceFileError":
+    case "wikiLinkError":
       return hasOnlyKeys(value, ["type", "requestId", "message"]) && hasRequestId(value) && hasBoundedString(value, "message", HOST_WIRE_LIMITS.messageCharacters, 1) ? { type: value.type, requestId: value.requestId, message: value.message } : null;
     case "exportSaved":
     case "exportTargetResolved":
@@ -309,6 +323,10 @@ function parseExtensionToWebviewMessage(value) {
       const target = parseExportTargetGrant(value.target);
       return target !== void 0 ? { type: value.type, requestId: value.requestId, target } : null;
     }
+    case "wikiSuggestions":
+      return hasOnlyKeys(value, ["type", "requestId", "items"]) && hasRequestId(value) && Array.isArray(value.items) && value.items.length <= 20 && value.items.every(isWikiSuggestion) ? { type: "wikiSuggestions", requestId: value.requestId, items: value.items } : null;
+    case "wikiLinkResult":
+      return hasOnlyKeys(value, ["type", "requestId", "exists"]) && hasRequestId(value) && typeof value.exists === "boolean" ? { type: "wikiLinkResult", requestId: value.requestId, exists: value.exists } : null;
     case "workspaceFileRead":
       return hasOnlyKeys(value, ["type", "requestId", "dataBase64"]) && hasRequestId(value) && hasNullableBoundedString(value, "dataBase64", HOST_WIRE_LIMITS.base64Characters) ? { type: "workspaceFileRead", requestId: value.requestId, dataBase64: value.dataBase64 } : null;
     case "workspaceSettings": {

package/dist/workspace/index.d.ts

@@ -1,145 +1,45 @@
-import { d as FileSystemProvider } from '../types-BvDnr3YU.js';
-import { Z as ElectronWorkspaceInfo, aj as HostEnvironment } from '../capabilities-BvUC17t9.js';
-import '../v2-BVnZZyd4.js';
-import '../workspace-path-CWVrcuPL.js';
-import '../filesystem-v2-C8AdSXUN.js';
+export { D as DEFAULT_WORKSPACE_ID, E as ElectronWorkspaceReconciliation, T as TransientOrigin, W as WorkspaceDescriptor, e as ensureDefaultWorkspace, g as getTransientWorkspace, a as getWorkspace, l as listWorkspaces, p as parsePersistedWorkspaceList, r as reconcileElectronWorkspaceDescriptors, b as registerTransientWorkspace, c as removeWorkspace, s as saveWorkspace, t as touchWorkspace, u as unregisterTransientWorkspace } from '../reconcile-electron-Bz-iAY_B.js';
+import { ContentContainer } from '@bendyline/squisq/storage';
+import { o as FileSystemProviderV2 } from '../v2-DwxWjFC0.js';
+import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
+import '../types-DLteNrK0.js';
+import '../capabilities-BJEkIsO1.js';
+import '../filesystem-v2-CXdAPR27.js';
 
-/**
- * Origin of a transient workspace — records where its contents came from and
- * how to save them back. Set only on `type: 'transient'` workspaces.
- * - 'loose-file' — a single markdown file opened from the OS (Electron);
- *   edits write back through an owner-scoped `resourceId` grant.
- * - 'dbk' — a `.dbk`/zip bundle unpacked into memory (Electron); edits are
- *   re-zipped and written back through an owner-scoped resource grant.
- * - 'web-file' — a single markdown file launched into the installed web app
- *   (File Handling API); edits write back through `handle`.
- * - 'web-dbk' — a `.dbk`/zip bundle launched into the installed web app;
- *   edits are re-zipped and written back through `handle`.
- *
- * The web variants hold a live `FileSystemFileHandle`. That is safe because
- * transient descriptors are never persisted — they live only in the
- * in-memory registry (see workspace-manager) for the current page session.
- */
-type TransientOrigin = {
-    kind: 'loose-file';
-    resourceId: string;
-} | {
-    kind: 'dbk';
-    resourceId: string;
-    /** SHA-256 of the last bundle version acknowledged by the host. */
-    version: string | null;
-} | {
-    kind: 'web-file';
-    handle: FileSystemFileHandle;
-    name: string;
-} | {
-    kind: 'web-dbk';
-    handle: FileSystemFileHandle;
-    name: string;
-    /** SHA-256 of the last bundle version observed on disk. */
-    version: string | null;
-};
-/**
- * Workspace — a named binding to a FileSystemProvider, representing
- * the user's current working context (a folder of markdown files).
- */
-interface WorkspaceDescriptor {
-    /** Unique stable identifier (persisted in IndexedDB). */
-    id: string;
-    /** User-visible label. */
-    name: string;
-    /**
-     * Provider kind:
-     * - 'indexeddb' — browser-local storage (web only)
-     * - 'native' — File System Access API (web Chrome/Edge only)
-     * - 'host-native' — Electron main-process native filesystem
-     * - 'transient' — session-only, in-memory (a loose file/`.dbk` opened from
-     *   the OS, or a document copied from a shared URL). Never persisted; its
-     *   provider lives in an in-memory registry (see workspace-manager). An
-     *   `origin` is present only when changes can be saved back externally.
-     */
-    type: 'indexeddb' | 'native' | 'host-native' | 'transient';
-    /** ISO timestamp of last access. */
-    lastOpened: string;
-    /** Absolute filesystem path for 'host-native' workspaces. */
-    rootPath?: string;
-    /** For 'transient' workspaces: where the contents came from / save back to. */
-    origin?: TransientOrigin;
-    /**
-     * Per-workspace override for the global versioning preference. When
-     * `'inherit'` (or absent), the global preference applies. `'on'` /
-     * `'off'` force the corresponding behavior regardless of the global
-     * setting. See `resolveVersioningEnabled` in the preferences module.
-     */
-    versioningOverride?: 'inherit' | 'on' | 'off';
+declare const WORKSPACE_BACKUP_MANIFEST = "docblocks-backup.json";
+declare const WORKSPACE_BACKUP_LIMITS: Readonly<{
+    maxEntries: 10000;
+    maxUncompressedBytes: number;
+    maxEntryUncompressedBytes: number;
+    maxCompressionRatio: 1000;
+}>;
+interface BackupWorkspace {
+    readonly name: string;
+    readonly prefix: string;
+    readonly directories: readonly WorkspacePath[];
 }
-
-/** Parse the complete persisted workspace list before it reaches startup code. */
-declare function parsePersistedWorkspaceList(value: unknown): WorkspaceDescriptor[];
-
-/**
- * WorkspaceManager — manages the list of known workspaces in IndexedDB
- * and provides helpers for creating / switching / removing them.
- *
- * The actual FileSystemProvider instances are created by the caller
- * (since native providers need a DirectoryHandle from user interaction).
- */
-
-/** Id of the browser-local workspace `ensureDefaultWorkspace` creates. */
-declare const DEFAULT_WORKSPACE_ID = "default";
-/** Register a transient workspace and its (already-built) provider. */
-declare function registerTransientWorkspace(descriptor: WorkspaceDescriptor, provider: FileSystemProvider): void;
-/** Look up a transient workspace (descriptor + provider) by id, if any. */
-declare function getTransientWorkspace(id: string): {
-    descriptor: WorkspaceDescriptor;
-    provider: FileSystemProvider;
-} | null;
-/** Forget a transient workspace (e.g. when it is closed). */
-declare function unregisterTransientWorkspace(id: string): Promise<void>;
-/**
- * Get all known workspace descriptors — persisted plus any session-only
- * transient ones (so they show in the picker and resolve for the session).
- */
-declare function listWorkspaces(): Promise<WorkspaceDescriptor[]>;
-/**
- * Get a specific workspace descriptor by id (transient or persisted).
- */
-declare function getWorkspace(id: string): Promise<WorkspaceDescriptor | null>;
-/**
- * Add or update a workspace descriptor. If a workspace with the same id
- * already exists, it is replaced. Transient workspaces are never persisted.
- */
-declare function saveWorkspace(workspace: WorkspaceDescriptor): Promise<void>;
-/**
- * Remove a workspace descriptor by id (transient or persisted).
- */
-declare function removeWorkspace(id: string): Promise<void>;
-/**
- * Touch the lastOpened timestamp on a workspace. For transient workspaces this
- * updates the in-memory descriptor only (nothing is persisted).
- */
-declare function touchWorkspace(id: string): Promise<void>;
-/**
- * Ensure a default IndexedDB workspace exists. Called on app startup.
- * Returns the descriptor.
- */
-declare function ensureDefaultWorkspace(): Promise<WorkspaceDescriptor>;
-
-interface ElectronWorkspaceReconciliation {
-    /** Obsolete renderer descriptors to remove before attempting restoration. */
-    readonly removeIds: readonly string[];
-    /** Canonical main-authorized descriptors to insert or replace. */
-    readonly upsert: readonly WorkspaceDescriptor[];
-    /** Safe navigation migration for a local descriptor matched by root. */
-    readonly idRemap: Readonly<Record<string, string>>;
+interface WorkspaceBackupManifest {
+    readonly format: 'docblocks-workspace-backup';
+    readonly version: 1;
+    readonly workspaces: readonly BackupWorkspace[];
 }
-/**
- * Reconcile renderer IndexedDB metadata with the main process authority list.
- * `hostWorkspaces` is authoritative: local Electron descriptors absent from
- * it cannot be opened safely and are removed. Root-path matching carries user
- * metadata across an id migration without treating that display path as
- * authority.
- */
-declare function reconcileElectronWorkspaceDescriptors(local: readonly WorkspaceDescriptor[], hostWorkspaces: readonly ElectronWorkspaceInfo[], platform: HostEnvironment['platform'], now: string): ElectronWorkspaceReconciliation;
+interface RestorableWorkspace {
+    readonly name: string;
+    readonly directories: readonly WorkspacePath[];
+    readonly files: readonly {
+        path: WorkspacePath;
+        data: ArrayBuffer;
+    }[];
+}
+declare function parseWorkspaceBackupManifest(value: unknown): WorkspaceBackupManifest;
+/** Capture bytes and empty directories without modifying the source workspace. */
+declare function appendWorkspaceBackup(container: ContentContainer, provider: FileSystemProviderV2, previous: readonly BackupWorkspace[]): Promise<BackupWorkspace[]>;
+declare function finishWorkspaceBackup(container: ContentContainer, workspaces: readonly BackupWorkspace[]): Promise<void>;
+/** Validate the complete archive before creating any destination workspace.
+ * Legacy plain ZIP backups restore as one workspace, retaining their full tree.
+ */
+declare function readWorkspaceBackup(container: ContentContainer, legacyName: string): Promise<RestorableWorkspace[]>;
+/** Only an empty, newly allocated destination may receive a restored tree. */
+declare function restoreWorkspaceBackup(workspace: RestorableWorkspace, provider: FileSystemProviderV2): Promise<void>;
 
-export { DEFAULT_WORKSPACE_ID, type ElectronWorkspaceReconciliation, type TransientOrigin, type WorkspaceDescriptor, ensureDefaultWorkspace, getTransientWorkspace, getWorkspace, listWorkspaces, parsePersistedWorkspaceList, reconcileElectronWorkspaceDescriptors, registerTransientWorkspace, removeWorkspace, saveWorkspace, touchWorkspace, unregisterTransientWorkspace };
+export { type BackupWorkspace, type RestorableWorkspace, WORKSPACE_BACKUP_LIMITS, WORKSPACE_BACKUP_MANIFEST, type WorkspaceBackupManifest, appendWorkspaceBackup, finishWorkspaceBackup, parseWorkspaceBackupManifest, readWorkspaceBackup, restoreWorkspaceBackup };

package/dist/workspace/index.js

@@ -1,29 +1,44 @@
 import {
   DEFAULT_WORKSPACE_ID,
+  WORKSPACE_BACKUP_LIMITS,
+  WORKSPACE_BACKUP_MANIFEST,
+  appendWorkspaceBackup,
   ensureDefaultWorkspace,
+  finishWorkspaceBackup,
   getTransientWorkspace,
   getWorkspace,
   listWorkspaces,
   parsePersistedWorkspaceList,
+  parseWorkspaceBackupManifest,
+  readWorkspaceBackup,
   reconcileElectronWorkspaceDescriptors,
   registerTransientWorkspace,
   removeWorkspace,
+  restoreWorkspaceBackup,
   saveWorkspace,
   touchWorkspace,
   unregisterTransientWorkspace
-} from "../chunk-QS5WTLUZ.js";
+} from "../chunk-XI2LYBRR.js";
 import "../chunk-DAPFSEKY.js";
 import "../chunk-XAMILHQP.js";
+import "../chunk-UTH3HYCZ.js";
 export {
   DEFAULT_WORKSPACE_ID,
+  WORKSPACE_BACKUP_LIMITS,
+  WORKSPACE_BACKUP_MANIFEST,
+  appendWorkspaceBackup,
   ensureDefaultWorkspace,
+  finishWorkspaceBackup,
   getTransientWorkspace,
   getWorkspace,
   listWorkspaces,
   parsePersistedWorkspaceList,
+  parseWorkspaceBackupManifest,
+  readWorkspaceBackup,
   reconcileElectronWorkspaceDescriptors,
   registerTransientWorkspace,
   removeWorkspace,
+  restoreWorkspaceBackup,
   saveWorkspace,
   touchWorkspace,
   unregisterTransientWorkspace

package/dist/workspace-index/index.d.ts

@@ -1,4 +1,4 @@
-import { n as FileSystemProviderV2, m as FileSystemProviderCapabilities } from '../v2-BVnZZyd4.js';
+import { o as FileSystemProviderV2, n as FileSystemProviderCapabilities } from '../v2-DwxWjFC0.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 import { d as CatalogDocumentFormat, f as CatalogOutlineEntry } from '../catalog-BQK05tne.js';
 import '@bendyline/squisq/markdown';
@@ -151,6 +151,8 @@ interface WorkspaceIndex {
     start(): void;
     /** Every discoverable file, sorted by path; the same array within a generation. */
     getFiles(): readonly WorkspaceIndexFile[];
+    /** Discoverable folders, including empty folders; sorted within a generation. */
+    getDirectories(): readonly WorkspacePath[];
     /** Every document (Markdown and outside-in), sorted by path. */
     getDocuments(): readonly IndexedDocument[];
     getDocument(path: string): IndexedDocument | null;

package/dist/workspace-index/index.js

@@ -11,14 +11,14 @@ import {
 } from "../chunk-YHSFRPBS.js";
 import {
   decodeUtf8Text
-} from "../chunk-M5ZNQGR5.js";
+} from "../chunk-IYKGM3PV.js";
 import {
   FsError,
   WORKSPACE_ROOT,
   parseWorkspacePath,
   tryParseWorkspacePath,
   workspacePathContains
-} from "../chunk-AYWKIZLD.js";
+} from "../chunk-UTH3HYCZ.js";
 
 // src/workspace-index/search-text.ts
 var LineBuilder = class {
@@ -533,6 +533,7 @@ var WorkspaceIndexImpl = class {
     this.generation = 0;
     this.lastPublish = 0;
     this.filesCache = null;
+    this.directoriesCache = null;
     this.documentsCache = null;
     this.statusCache = null;
     this.workspaceId = options.workspaceId;
@@ -592,6 +593,20 @@ var WorkspaceIndexImpl = class {
     }
     return this.documentsCache;
   }
+  getDirectories() {
+    if (!this.directoriesCache) {
+      const directories = new Set(this.tree.directories);
+      for (const path of [...this.tree.directories, ...this.tree.files.keys()]) {
+        let slash = path.lastIndexOf("/");
+        while (slash >= 0) {
+          directories.add(parseWorkspacePath(path.slice(0, slash)));
+          slash = path.lastIndexOf("/", slash - 1);
+        }
+      }
+      this.directoriesCache = Object.freeze([...directories].sort(compareCodeUnits2));
+    }
+    return this.directoriesCache;
+  }
   getDocument(path) {
     const canonical = tryParseWorkspacePath(path);
     const state = canonical === null ? void 0 : this.tree.documents.get(canonical);
@@ -1167,6 +1182,7 @@ var WorkspaceIndexImpl = class {
     this.generation += 1;
     this.lastPublish = this.now();
     this.filesCache = null;
+    this.directoriesCache = null;
     this.documentsCache = null;
     this.statusCache = null;
     for (const listener of [...this.listeners]) {

package/dist/workspace-settings/index.d.ts

@@ -3,7 +3,7 @@ export { b as CATALOG_JSON_CONTENT_MODES, c as CATALOG_SORT_ORDERS, d as Catalog
 import { C as CatalogEntry, W as WorkspaceCatalog } from '../catalog-BQK05tne.js';
 export { a as CATALOG_FORMAT_VERSION, b as CATALOG_GENERATOR, c as CATALOG_LIMITS, d as CatalogDocumentFormat, e as CatalogEntryHints, f as CatalogOutlineEntry, g as CatalogSource, O as OUTSIDE_IN_FORMAT_IDS, h as OutsideInFormatId, i as OutsideInLayout, j as buildCatalogMarkdownDocument, k as catalogEntryForUnreadable, l as catalogEntryFromDocument, m as catalogEntryFromMarkdown, n as chooseOutsideInMarkdownPath, o as createWorkspaceCatalog, p as isGeneratedCatalogHtml, q as isGeneratedCatalogJson, r as readCatalogHtmlDigest, s as relativeCatalogLink, t as relocateOutsideInLayout, u as resolveOutsideInLayout, v as serializeCatalogJson, w as sortCatalogEntries, x as stampCatalogHtml } from '../catalog-BQK05tne.js';
 import { MarkdownDocument } from '@bendyline/squisq/markdown';
-import { u as FileSystemVersion, n as FileSystemProviderV2 } from '../v2-BVnZZyd4.js';
+import { v as FileSystemVersion, o as FileSystemProviderV2 } from '../v2-DwxWjFC0.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 
 /**