@bendyline/docblocks 2.0.0 → 2.1.1

package/dist/vscode/index.js

@@ -1,3 +1,389 @@
-/** Runtime-validated VS Code host/webview wire protocol. */
-export * from './messages.js';
-//# sourceMappingURL=index.js.map
+import {
+  HOST_WIRE_LIMITS,
+  isBoundedString
+} from "../chunk-M2PUNKHS.js";
+
+// src/vscode/messages.ts
+var MAX_REQUEST_ID = 2147483647;
+var DOCBLOCKS_ACCENT_COLORS = [
+  "brown",
+  "green",
+  "blue",
+  "purple",
+  "maroon",
+  "orange",
+  "gray"
+];
+var DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MIN = 12;
+var DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MAX = 32;
+var DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MIN = 1.2;
+var DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MAX = 2.4;
+var DEFAULT_VSCODE_WRITE_CANVAS_SETTINGS = {
+  textSize: 16,
+  lineSpacing: 1.7
+};
+function parseWebviewToExtensionMessage(value) {
+  if (!isRecord(value) || typeof value.type !== "string") return null;
+  switch (value.type) {
+    case "ready":
+      return hasOnlyKeys(value, ["type"]) ? { type: "ready" } : null;
+    case "setAutoSave":
+      return hasOnlyKeys(value, ["type", "enabled"]) && typeof value.enabled === "boolean" ? { type: "setAutoSave", enabled: value.enabled } : null;
+    case "setAccentColor":
+      return hasOnlyKeys(value, ["type", "accentColor"]) && isDocBlocksAccentColor(value.accentColor) ? { type: "setAccentColor", accentColor: value.accentColor } : null;
+    case "setWriteCanvasSettings": {
+      if (!hasOnlyKeys(value, ["type", "settings"])) return null;
+      const settings = parseVscodeWriteCanvasSettings(value.settings);
+      return settings ? { type: "setWriteCanvasSettings", settings } : null;
+    }
+    case "openLink":
+      return hasOnlyKeys(value, ["type", "href"]) && hasBoundedString(value, "href", HOST_WIRE_LIMITS.urlCharacters, 1) ? { type: "openLink", href: value.href } : null;
+    case "edit":
+      return hasOnlyKeys(value, [
+        "type",
+        "content",
+        "sessionId",
+        "clientRevision",
+        "baseDocumentVersion"
+      ]) && hasBoundedString(value, "content", HOST_WIRE_LIMITS.documentCharacters) && isSessionEnvelope(value) ? {
+        type: "edit",
+        content: value.content,
+        sessionId: value.sessionId,
+        clientRevision: value.clientRevision,
+        baseDocumentVersion: value.baseDocumentVersion
+      } : null;
+    case "save":
+      return hasOnlyKeys(value, [
+        "type",
+        "sessionId",
+        "requestId",
+        "clientRevision",
+        "baseDocumentVersion"
+      ]) && isSessionEnvelope(value) && hasRequestId(value) ? {
+        type: "save",
+        sessionId: value.sessionId,
+        requestId: value.requestId,
+        clientRevision: value.clientRevision,
+        baseDocumentVersion: value.baseDocumentVersion
+      } : null;
+    case "resolveConflict":
+      return hasOnlyKeys(value, ["type", "sessionId", "choice"]) && hasBoundedString(value, "sessionId", HOST_WIRE_LIMITS.identifierCharacters, 1) && (value.choice === "use-local" || value.choice === "use-external") ? { type: "resolveConflict", sessionId: value.sessionId, choice: value.choice } : null;
+    case "resolveMedia":
+      return hasOnlyKeys(value, ["type", "requestId", "ref"]) && hasRequestId(value) && hasBoundedString(value, "ref", HOST_WIRE_LIMITS.pathCharacters, 1) ? { type: "resolveMedia", requestId: value.requestId, ref: value.ref } : null;
+    case "listMedia":
+      return hasOnlyKeys(value, ["type", "requestId"]) && hasRequestId(value) ? { type: "listMedia", requestId: value.requestId } : null;
+    case "addMedia":
+      return hasOnlyKeys(value, ["type", "requestId", "name", "dataBase64", "mimeType"]) && hasRequestId(value) && hasBoundedString(value, "name", HOST_WIRE_LIMITS.pathCharacters, 1) && hasBoundedString(value, "dataBase64", HOST_WIRE_LIMITS.base64Characters) && hasMimeType(value, "mimeType") ? {
+        type: "addMedia",
+        requestId: value.requestId,
+        name: value.name,
+        dataBase64: value.dataBase64,
+        mimeType: value.mimeType
+      } : null;
+    case "removeMedia":
+      return hasOnlyKeys(value, ["type", "requestId", "ref"]) && hasRequestId(value) && hasBoundedString(value, "ref", HOST_WIRE_LIMITS.pathCharacters, 1) ? { type: "removeMedia", requestId: value.requestId, ref: value.ref } : null;
+    case "saveExport":
+      return hasOnlyKeys(value, [
+        "type",
+        "requestId",
+        "filename",
+        "dataBase64",
+        "mimeType",
+        "grantId",
+        "targetFilename"
+      ]) && hasRequestId(value) && hasSafeFilename(value, "filename") && hasBoundedString(value, "dataBase64", HOST_WIRE_LIMITS.base64Characters) && hasMimeType(value, "mimeType") && hasNullableBoundedString(value, "grantId", HOST_WIRE_LIMITS.identifierCharacters, 1) && hasNullableSafeFilename(value, "targetFilename") ? {
+        type: "saveExport",
+        requestId: value.requestId,
+        filename: value.filename,
+        dataBase64: value.dataBase64,
+        mimeType: value.mimeType,
+        grantId: value.grantId,
+        targetFilename: value.targetFilename
+      } : null;
+    case "resolveExportTarget":
+      return hasOnlyKeys(value, ["type", "requestId", "filename"]) && hasRequestId(value) && hasSafeFilename(value, "filename") ? { type: "resolveExportTarget", requestId: value.requestId, filename: value.filename } : null;
+    case "pickExportTarget":
+      return hasOnlyKeys(value, ["type", "requestId", "filename", "currentGrantId"]) && hasRequestId(value) && hasSafeFilename(value, "filename") && hasNullableBoundedString(value, "currentGrantId", HOST_WIRE_LIMITS.identifierCharacters, 1) ? {
+        type: "pickExportTarget",
+        requestId: value.requestId,
+        filename: value.filename,
+        currentGrantId: value.currentGrantId
+      } : null;
+    case "readWorkspaceFile":
+      return hasOnlyKeys(value, ["type", "requestId", "path"]) && hasRequestId(value) && hasBoundedString(value, "path", HOST_WIRE_LIMITS.pathCharacters, 1) ? { type: "readWorkspaceFile", requestId: value.requestId, path: value.path } : null;
+    default:
+      return null;
+  }
+}
+function parseExtensionToWebviewMessage(value) {
+  if (!isRecord(value) || typeof value.type !== "string") return null;
+  switch (value.type) {
+    case "setContent":
+      return hasOnlyKeys(value, [
+        "type",
+        "content",
+        "documentVersion",
+        "fileName",
+        "sessionId",
+        "sessionRevision",
+        "acknowledgedClientRevision"
+      ]) && hasBoundedString(value, "content", HOST_WIRE_LIMITS.documentCharacters) && hasNonNegativeInteger(value, "documentVersion") && hasBoundedString(value, "fileName", HOST_WIRE_LIMITS.pathCharacters, 1) && hasBoundedString(value, "sessionId", HOST_WIRE_LIMITS.identifierCharacters, 1) && hasNonNegativeInteger(value, "sessionRevision") && hasNonNegativeInteger(value, "acknowledgedClientRevision") ? {
+        type: "setContent",
+        content: value.content,
+        documentVersion: value.documentVersion,
+        fileName: value.fileName,
+        sessionId: value.sessionId,
+        sessionRevision: value.sessionRevision,
+        acknowledgedClientRevision: value.acknowledgedClientRevision
+      } : null;
+    case "editAcknowledged":
+      return hasOnlyKeys(value, [
+        "type",
+        "sessionId",
+        "clientRevision",
+        "sessionRevision",
+        "accepted",
+        "message"
+      ]) && hasBoundedString(value, "sessionId", HOST_WIRE_LIMITS.identifierCharacters, 1) && hasNonNegativeInteger(value, "clientRevision") && hasNonNegativeInteger(value, "sessionRevision") && typeof value.accepted === "boolean" && hasNullableBoundedString(value, "message", HOST_WIRE_LIMITS.messageCharacters) ? {
+        type: "editAcknowledged",
+        sessionId: value.sessionId,
+        clientRevision: value.clientRevision,
+        sessionRevision: value.sessionRevision,
+        accepted: value.accepted,
+        message: value.message
+      } : null;
+    case "sessionState": {
+      if (!hasOnlyKeys(value, [
+        "type",
+        "sessionId",
+        "status",
+        "revision",
+        "persistedRevision",
+        "acknowledgedClientRevision",
+        "documentVersion",
+        "error",
+        "conflict"
+      ]) || !hasBoundedString(value, "sessionId", HOST_WIRE_LIMITS.identifierCharacters, 1) || !isDocumentSessionMessageStatus(value.status) || !hasNonNegativeInteger(value, "revision") || !hasNonNegativeInteger(value, "persistedRevision") || value.persistedRevision > value.revision || !hasNonNegativeInteger(value, "acknowledgedClientRevision") || !hasNonNegativeInteger(value, "documentVersion") || !hasNullableBoundedString(value, "error", HOST_WIRE_LIMITS.messageCharacters)) {
+        return null;
+      }
+      const conflict = parseDocumentConflictDetails(value.conflict);
+      if (conflict === void 0 || value.status === "conflict" && conflict === null || value.status !== "conflict" && conflict !== null) {
+        return null;
+      }
+      return {
+        type: "sessionState",
+        sessionId: value.sessionId,
+        status: value.status,
+        revision: value.revision,
+        persistedRevision: value.persistedRevision,
+        acknowledgedClientRevision: value.acknowledgedClientRevision,
+        documentVersion: value.documentVersion,
+        error: value.error,
+        conflict
+      };
+    }
+    case "saveResult":
+      return hasOnlyKeys(value, [
+        "type",
+        "sessionId",
+        "requestId",
+        "ok",
+        "revision",
+        "persistedRevision",
+        "documentVersion",
+        "message"
+      ]) && hasBoundedString(value, "sessionId", HOST_WIRE_LIMITS.identifierCharacters, 1) && hasRequestId(value) && typeof value.ok === "boolean" && hasNonNegativeInteger(value, "revision") && hasNonNegativeInteger(value, "persistedRevision") && value.persistedRevision <= value.revision && hasNonNegativeInteger(value, "documentVersion") && hasNullableBoundedString(value, "message", HOST_WIRE_LIMITS.messageCharacters) ? {
+        type: "saveResult",
+        sessionId: value.sessionId,
+        requestId: value.requestId,
+        ok: value.ok,
+        revision: value.revision,
+        persistedRevision: value.persistedRevision,
+        documentVersion: value.documentVersion,
+        message: value.message
+      } : null;
+    case "themeChange":
+      return hasOnlyKeys(value, ["type", "theme"]) && (value.theme === "light" || value.theme === "dark") ? { type: "themeChange", theme: value.theme } : null;
+    case "editorSettings": {
+      if (!hasOnlyKeys(value, ["type", "settings"])) return null;
+      const settings = parseVscodeEditorSettings(value.settings);
+      return settings ? { type: "editorSettings", settings } : null;
+    }
+    case "mediaResolved":
+      return hasOnlyKeys(value, ["type", "requestId", "url"]) && hasRequestId(value) && isBoundedMediaDataUrl(value.url) ? { type: "mediaResolved", requestId: value.requestId, url: value.url } : null;
+    case "mediaListed": {
+      if (!hasOnlyKeys(value, ["type", "requestId", "entries"]) || !hasRequestId(value)) {
+        return null;
+      }
+      const entries = parseMediaEntries(value.entries);
+      return entries ? { type: "mediaListed", requestId: value.requestId, entries } : null;
+    }
+    case "mediaAdded":
+      return hasOnlyKeys(value, ["type", "requestId", "path"]) && hasRequestId(value) && hasBoundedString(value, "path", HOST_WIRE_LIMITS.pathCharacters, 1) ? { type: "mediaAdded", requestId: value.requestId, path: value.path } : null;
+    case "mediaRemoved":
+      return hasOnlyKeys(value, ["type", "requestId"]) && hasRequestId(value) ? { type: "mediaRemoved", requestId: value.requestId } : null;
+    case "mediaError":
+    case "exportError":
+    case "workspaceFileError":
+      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":
+    case "exportTargetPicked": {
+      if (!hasOnlyKeys(value, ["type", "requestId", "target"]) || !hasRequestId(value)) {
+        return null;
+      }
+      const target = parseExportTargetGrant(value.target);
+      return target !== void 0 ? { type: value.type, requestId: value.requestId, target } : 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;
+    default:
+      return null;
+  }
+}
+function parseExportTargetGrant(value) {
+  if (value === null) return null;
+  if (!isRecord(value) || !hasOnlyKeys(value, ["grantId", "displayLabel"]) || !hasBoundedString(value, "grantId", HOST_WIRE_LIMITS.identifierCharacters, 1) || !hasBoundedString(value, "displayLabel", HOST_WIRE_LIMITS.pathCharacters, 1)) {
+    return void 0;
+  }
+  return { grantId: value.grantId, displayLabel: value.displayLabel };
+}
+function parseDocumentConflictDetails(value) {
+  if (value === null) return null;
+  if (!isRecord(value) || !hasOnlyKeys(value, [
+    "localBaseDocumentVersion",
+    "externalDocumentVersion",
+    "localBytes",
+    "externalBytes",
+    "localEditedAt",
+    "externalObservedAt",
+    "externalIsDirty"
+  ]) || !hasNonNegativeInteger(value, "localBaseDocumentVersion") || !hasNonNegativeInteger(value, "externalDocumentVersion") || !hasNonNegativeInteger(value, "localBytes") || !isNullableNonNegativeInteger(value.externalBytes) || !isNullableNonNegativeInteger(value.localEditedAt) || !isNullableNonNegativeInteger(value.externalObservedAt) || value.externalIsDirty !== null && typeof value.externalIsDirty !== "boolean") {
+    return void 0;
+  }
+  return {
+    localBaseDocumentVersion: value.localBaseDocumentVersion,
+    externalDocumentVersion: value.externalDocumentVersion,
+    localBytes: value.localBytes,
+    externalBytes: value.externalBytes,
+    localEditedAt: value.localEditedAt,
+    externalObservedAt: value.externalObservedAt,
+    externalIsDirty: value.externalIsDirty
+  };
+}
+function parseVscodeEditorSettings(value) {
+  if (!isRecord(value) || !hasOnlyKeys(value, ["autoSave", "accentColor", "writeCanvasSettings"]) || typeof value.autoSave !== "boolean" || !isDocBlocksAccentColor(value.accentColor)) {
+    return null;
+  }
+  const writeCanvasSettings = parseVscodeWriteCanvasSettings(value.writeCanvasSettings);
+  return writeCanvasSettings ? { autoSave: value.autoSave, accentColor: value.accentColor, writeCanvasSettings } : null;
+}
+function isDocBlocksAccentColor(value) {
+  return DOCBLOCKS_ACCENT_COLORS.some((color) => color === value);
+}
+function isDocBlocksWriteCanvasTextSize(value) {
+  return numberInRange(
+    value,
+    DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MIN,
+    DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MAX
+  );
+}
+function isDocBlocksWriteCanvasLineSpacing(value) {
+  return numberInRange(
+    value,
+    DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MIN,
+    DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MAX
+  );
+}
+function parseVscodeWriteCanvasSettings(value) {
+  return isRecord(value) && hasOnlyKeys(value, ["textSize", "lineSpacing"]) && isDocBlocksWriteCanvasTextSize(value.textSize) && isDocBlocksWriteCanvasLineSpacing(value.lineSpacing) ? { textSize: value.textSize, lineSpacing: value.lineSpacing } : null;
+}
+function numberInRange(value, min, max) {
+  return typeof value === "number" && Number.isFinite(value) && value >= min && value <= max;
+}
+function parseMediaEntries(value) {
+  if (!Array.isArray(value) || value.length > HOST_WIRE_LIMITS.arrayEntries) return null;
+  const entries = [];
+  for (const entry of value) {
+    if (!isRecord(entry) || !hasOnlyKeys(entry, ["name", "mimeType", "size"]) || !hasBoundedString(entry, "name", HOST_WIRE_LIMITS.pathCharacters, 1) || !hasMimeType(entry, "mimeType") || !hasNonNegativeInteger(entry, "size") || entry.size > HOST_WIRE_LIMITS.binaryBytes) {
+      return null;
+    }
+    entries.push({ name: entry.name, mimeType: entry.mimeType, size: entry.size });
+  }
+  return entries;
+}
+function isBoundedMediaDataUrl(value) {
+  if (!isBoundedString(value, HOST_WIRE_LIMITS.base64Characters + 512, 1)) return false;
+  if (!value.startsWith("data:")) return false;
+  const separator = value.indexOf(";base64,");
+  return separator > 5 && separator <= HOST_WIRE_LIMITS.identifierCharacters;
+}
+function isDocumentSessionMessageStatus(value) {
+  return value === "idle" || value === "saved" || value === "dirty" || value === "saving" || value === "error" || value === "conflict" || value === "closed";
+}
+function isSessionEnvelope(value) {
+  return hasBoundedString(value, "sessionId", HOST_WIRE_LIMITS.identifierCharacters, 1) && hasNonNegativeInteger(value, "clientRevision") && hasNonNegativeInteger(value, "baseDocumentVersion");
+}
+function hasRequestId(value) {
+  return hasNonNegativeInteger(value, "requestId") && value.requestId <= MAX_REQUEST_ID;
+}
+function hasBoundedString(value, key, maximumCharacters, minimumCharacters = 0) {
+  return isBoundedString(value[key], maximumCharacters, minimumCharacters);
+}
+function hasNullableBoundedString(value, key, maximumCharacters, minimumCharacters = 0) {
+  return value[key] === null || isBoundedString(value[key], maximumCharacters, minimumCharacters);
+}
+function hasNonNegativeInteger(value, key) {
+  const entry = value[key];
+  return typeof entry === "number" && Number.isSafeInteger(entry) && entry >= 0;
+}
+function isNullableNonNegativeInteger(value) {
+  return value === null || typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasOnlyKeys(value, keys) {
+  const expected = new Set(keys);
+  const actual = Object.keys(value);
+  return actual.length === expected.size && actual.every((key) => expected.has(key));
+}
+function hasSafeFilename(value, key) {
+  return isSafeExportFilename(value[key]);
+}
+function hasNullableSafeFilename(value, key) {
+  return value[key] === null || isSafeExportFilename(value[key]);
+}
+function isSafeExportFilename(value) {
+  return isBoundedString(value, 255, 1) && value.trim() === value && !/[\\/:*?"<>|]/.test(value) && !hasControlCharacter(value) && value !== "." && value !== ".." && !value.endsWith(".") && !value.endsWith(" ");
+}
+function hasControlCharacter(value) {
+  for (let index = 0; index < value.length; index += 1) {
+    const code = value.charCodeAt(index);
+    if (code <= 31 || code === 127) return true;
+  }
+  return false;
+}
+function hasMimeType(value, key) {
+  return isSafeMimeType(value[key]);
+}
+function isSafeMimeType(value) {
+  return isBoundedString(value, HOST_WIRE_LIMITS.identifierCharacters, 1) && /^[A-Za-z0-9!#$&^_.+-]+\/[A-Za-z0-9!#$&^_.+-]+(?:\s*;\s*[A-Za-z0-9!#$&^_.+-]+=[^;\r\n]+)*$/.test(
+    value
+  );
+}
+export {
+  DEFAULT_VSCODE_WRITE_CANVAS_SETTINGS,
+  DOCBLOCKS_ACCENT_COLORS,
+  DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MAX,
+  DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MIN,
+  DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MAX,
+  DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MIN,
+  isDocBlocksAccentColor,
+  isDocBlocksWriteCanvasLineSpacing,
+  isDocBlocksWriteCanvasTextSize,
+  isSafeExportFilename,
+  isSafeMimeType,
+  parseExtensionToWebviewMessage,
+  parseWebviewToExtensionMessage
+};

package/dist/workspace/index.d.ts

@@ -1,4 +1,141 @@
-export type { WorkspaceDescriptor, TransientOrigin } from './types.js';
-export { listWorkspaces, getWorkspace, saveWorkspace, removeWorkspace, touchWorkspace, ensureDefaultWorkspace, registerTransientWorkspace, getTransientWorkspace, unregisterTransientWorkspace, } from './workspace-manager.js';
-export { reconcileElectronWorkspaceDescriptors, type ElectronWorkspaceReconciliation, } from './reconcile-electron.js';
-//# sourceMappingURL=index.d.ts.map
+import { q as FileSystemProvider } from '../types-BEg5SQ1_.js';
+import { k as ElectronWorkspaceInfo, B as HostEnvironment } from '../types-CueK0tvU.js';
+import '../workspace-path-CWVrcuPL.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)
+     * - 'electron-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' | 'electron-native' | 'transient';
+    /** ISO timestamp of last access. */
+    lastOpened: string;
+    /** Absolute filesystem path for 'electron-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).
+ */
+
+/** 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 { type ElectronWorkspaceReconciliation, type TransientOrigin, type WorkspaceDescriptor, ensureDefaultWorkspace, getTransientWorkspace, getWorkspace, listWorkspaces, parsePersistedWorkspaceList, reconcileElectronWorkspaceDescriptors, registerTransientWorkspace, removeWorkspace, saveWorkspace, touchWorkspace, unregisterTransientWorkspace };

package/dist/workspace/index.js

@@ -1,3 +1,28 @@
-export { listWorkspaces, getWorkspace, saveWorkspace, removeWorkspace, touchWorkspace, ensureDefaultWorkspace, registerTransientWorkspace, getTransientWorkspace, unregisterTransientWorkspace, } from './workspace-manager.js';
-export { reconcileElectronWorkspaceDescriptors, } from './reconcile-electron.js';
-//# sourceMappingURL=index.js.map
+import {
+  ensureDefaultWorkspace,
+  getTransientWorkspace,
+  getWorkspace,
+  listWorkspaces,
+  parsePersistedWorkspaceList,
+  reconcileElectronWorkspaceDescriptors,
+  registerTransientWorkspace,
+  removeWorkspace,
+  saveWorkspace,
+  touchWorkspace,
+  unregisterTransientWorkspace
+} from "../chunk-SJBB5OD7.js";
+import "../chunk-OQCPBOQA.js";
+import "../chunk-XAMILHQP.js";
+export {
+  ensureDefaultWorkspace,
+  getTransientWorkspace,
+  getWorkspace,
+  listWorkspaces,
+  parsePersistedWorkspaceList,
+  reconcileElectronWorkspaceDescriptors,
+  registerTransientWorkspace,
+  removeWorkspace,
+  saveWorkspace,
+  touchWorkspace,
+  unregisterTransientWorkspace
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/docblocks",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "Core data structures and filesystem abstractions for DocBlocks",
   "license": "MIT",
   "author": "Bendyline",
@@ -9,7 +9,7 @@
     "url": "https://github.com/bendyline/docblocks.git",
     "directory": "packages/core"
   },
-  "homepage": "https://github.com/bendyline/docblocks",
+  "homepage": "https://docblocks.com/",
   "keywords": [
     "docblocks",
     "markdown",
@@ -23,9 +23,9 @@
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "sideEffects": false,
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "exports": {
     ".": {
@@ -73,6 +73,11 @@
       "import": "./dist/host/index.js",
       "default": "./dist/host/index.js"
     },
+    "./share": {
+      "types": "./dist/share/index.d.ts",
+      "import": "./dist/share/index.js",
+      "default": "./dist/share/index.js"
+    },
     "./vscode": {
       "types": "./dist/vscode/index.d.ts",
       "import": "./dist/vscode/index.js",
@@ -94,7 +99,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@bendyline/squisq": "2.0.1",
+    "@bendyline/squisq": "2.3.1",
     "zod": "3.25.76"
   }
 }