@bendyline/docblocks 2.2.0 → 2.2.2

package/dist/{chunk-M2PUNKHS.js → chunk-2WDJ27EH.js}

@@ -1,4 +1,5 @@
 // src/host/wire-policy.ts
+var MAX_HOST_PINNED_DOCUMENTS = 50;
 var HOST_WIRE_LIMITS = Object.freeze({
   identifierCharacters: 256,
   labelCharacters: 1024,
@@ -37,6 +38,29 @@ function parseOpenRequest(value) {
   }
   return null;
 }
+function parsePinnedMenuDocuments(value) {
+  if (!Array.isArray(value)) return [];
+  const documents = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const entry of value) {
+    if (documents.length >= MAX_HOST_PINNED_DOCUMENTS) break;
+    if (typeof entry !== "object" || entry === null || Array.isArray(entry)) continue;
+    const record = entry;
+    if (!hasExactKeys(record, ["workspaceId", "workspaceName", "path"])) continue;
+    if (!isBoundedString(record.workspaceId, HOST_WIRE_LIMITS.identifierCharacters, 1)) continue;
+    if (!isBoundedString(record.workspaceName, HOST_WIRE_LIMITS.labelCharacters, 1)) continue;
+    if (!isBoundedString(record.path, HOST_WIRE_LIMITS.pathCharacters, 1)) continue;
+    const key = `${record.workspaceId}\0${record.path}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    documents.push({
+      workspaceId: record.workspaceId,
+      workspaceName: record.workspaceName,
+      path: record.path
+    });
+  }
+  return documents;
+}
 function parseExternalHttpUrl(value) {
   if (!isBoundedString(value, HOST_WIRE_LIMITS.urlCharacters, 1)) return null;
   try {
@@ -65,10 +89,12 @@ function isTrustedRendererUrl(value, developmentOrigin) {
 }
 
 export {
+  MAX_HOST_PINNED_DOCUMENTS,
   HOST_WIRE_LIMITS,
   isBoundedString,
   isBoundedBytePayload,
   parseOpenRequest,
+  parsePinnedMenuDocuments,
   parseExternalHttpUrl,
   isTrustedRendererUrl
 };

package/dist/filesystem/electron.d.ts

@@ -1,7 +1,7 @@
 import { s as FileSystemProviderV2, r as FileSystemProviderCapabilities, k as FileSystemEntrySnapshot, m as FileSystemFileRead, K as FileSystemWriteOptions, n as FileSystemFileSnapshot, g as FileSystemCreateDirectoryOptions, h as FileSystemDirectorySnapshot, u as FileSystemRemoveOptions, v as FileSystemRemoveResult, o as FileSystemMoveOptions, w as FileSystemSnapshot, C as FileSystemWatchEvent, H as FileSystemWatchOptions, I as FileSystemWatchSubscription, q as FileSystemProvider, F as FileCommitResult, j as FileSystemEntry, b as FileMeta } from '../types-BEg5SQ1_.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 export { isElectronHost } from '../host/index.js';
-import '../types-Cv4uiosG.js';
+import '../types-CHhtLOXM.js';
 
 /** Pure renderer-side client for the typed Electron filesystem v2 transport. */
 declare class ElectronFileSystemProviderV2 implements FileSystemProviderV2 {

package/dist/filesystem/electron.js

@@ -5,7 +5,7 @@ import {
 import {
   isElectronHost
 } from "../chunk-6XHOOBYF.js";
-import "../chunk-M2PUNKHS.js";
+import "../chunk-2WDJ27EH.js";
 import "../chunk-73OOROXH.js";
 import "../chunk-M62ZGJ5I.js";
 import "../chunk-AYWKIZLD.js";

package/dist/filesystem/index.d.ts

@@ -10,7 +10,7 @@ import { MediaProvider } from '@bendyline/squisq/schemas';
 export { NativeFileSystemMovePathState, NativeFileSystemMoveRecoveryError, NativeFileSystemMoveRecoveryState, NativeFileSystemProvider, NativeFileSystemProviderV2, isNativeFileSystemSupported, loadDirectoryHandle, openNativeFolder, removeDirectoryHandle, restoreNativeFolder, storeDirectoryHandle } from './native.js';
 export { ElectronFileSystemProvider, ElectronFileSystemProviderV2 } from './electron.js';
 export { isElectronHost } from '../host/index.js';
-import '../types-Cv4uiosG.js';
+import '../types-CHhtLOXM.js';
 
 interface DecodeUtf8TextOptions {
     /** User-facing description of the payload being decoded. */

package/dist/filesystem/index.js

@@ -36,7 +36,7 @@ import {
 import {
   isElectronHost
 } from "../chunk-6XHOOBYF.js";
-import "../chunk-M2PUNKHS.js";
+import "../chunk-2WDJ27EH.js";
 import "../chunk-73OOROXH.js";
 import {
   parseFileSystemVersion,

package/dist/host/index.d.ts

@@ -1,8 +1,10 @@
-import { O as OpenRequest, D as DocBlocksHostAPI } from '../types-Cv4uiosG.js';
-export { a as DocBlocksHostExportAPI, b as DocBlocksHostExternalAPI, c as DocBlocksHostFfmpegAPI, d as DocBlocksHostFsAPI, e as DocBlocksHostFsV2API, f as DocBlocksHostGitAPI, g as DocBlocksHostLifecycleAPI, h as DocBlocksHostShellAPI, i as DocBlocksHostUpdaterAPI, j as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, k as ElectronWorkspaceInfo, l as ExternalBinaryCommitResult, G as GitBranchInfo, m as GitCapabilities, n as GitCloneHandle, o as GitCloneProgress, p as GitError, q as GitErrorCode, r as GitFileAtRevision, s as GitFileChange, t as GitFileStatusCode, u as GitLogEntry, v as GitLogOptions, w as GitRemoteInfo, x as GitRepoDetection, y as GitResult, z as GitRevision, A as GitStatus, H as HostCloseReason, B as HostEnvironment, C as HostExportTargetGrant, F as HostFileSystemV2OpenRequest, I as HostFileSystemV2Result, J as HostFileSystemV2WatchMessage, K as HostPrepareCloseRequest, L as HostPrepareCloseResult, M as MenuCommand, U as UpdateCheckResult, N as UpdateInstallResult, P as UpdaterStatus } from '../types-Cv4uiosG.js';
+import { P as OpenRequest, L as HostPinnedDocument, D as DocBlocksHostAPI } from '../types-CHhtLOXM.js';
+export { a as DocBlocksHostExportAPI, b as DocBlocksHostExternalAPI, c as DocBlocksHostFfmpegAPI, d as DocBlocksHostFsAPI, e as DocBlocksHostFsV2API, f as DocBlocksHostGitAPI, g as DocBlocksHostLifecycleAPI, h as DocBlocksHostMenuAPI, i as DocBlocksHostShellAPI, j as DocBlocksHostUpdaterAPI, k as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, l as ElectronWorkspaceInfo, m as ExternalBinaryCommitResult, G as GitBranchInfo, n as GitCapabilities, o as GitCloneHandle, p as GitCloneProgress, q as GitError, r as GitErrorCode, s as GitFileAtRevision, t as GitFileChange, u as GitFileStatusCode, v as GitLogEntry, w as GitLogOptions, x as GitRemoteInfo, y as GitRepoDetection, z as GitResult, A as GitRevision, B as GitStatus, H as HostCloseReason, C as HostEnvironment, F as HostExportTargetGrant, I as HostFileSystemV2OpenRequest, J as HostFileSystemV2Result, K as HostFileSystemV2WatchMessage, M as HostPrepareCloseRequest, N as HostPrepareCloseResult, O as MenuCommand, U as UpdateCheckResult, Q as UpdateInstallResult, R as UpdaterStatus } from '../types-CHhtLOXM.js';
 import '../types-BEg5SQ1_.js';
 import '../workspace-path-CWVrcuPL.js';
 
+/** Upper bound on shortcuts mirrored into the native menu, to keep it usable. */
+declare const MAX_HOST_PINNED_DOCUMENTS = 50;
 /** Quantitative limits shared by privileged host boundaries. */
 declare const HOST_WIRE_LIMITS: Readonly<{
     identifierCharacters: 256;
@@ -19,6 +21,12 @@ declare function isBoundedString(value: unknown, maximumCharacters: number, mini
 declare function isBoundedBytePayload(value: unknown, maximumBytes?: number): value is ArrayBuffer | Uint8Array;
 /** Parse one exact, bounded main-to-renderer open request. */
 declare function parseOpenRequest(value: unknown): OpenRequest | null;
+/**
+ * Validate a renderer-published pinned-document list before the main process
+ * builds native menu items from it. Renderer input is untrusted: drop any
+ * malformed, oversized, or duplicate entries and cap the total.
+ */
+declare function parsePinnedMenuDocuments(value: unknown): HostPinnedDocument[];
 /** Return one canonical HTTP(S) URL, or null when external navigation is unsafe. */
 declare function parseExternalHttpUrl(value: unknown): string | null;
 /** True only for the packaged renderer origin or the exact configured dev origin. */
@@ -37,4 +45,4 @@ declare function getDocBlocksHost(): DocBlocksHostAPI;
 /** Return the host API, or null if not running under Electron. */
 declare function maybeGetDocBlocksHost(): DocBlocksHostAPI | null;
 
-export { DocBlocksHostAPI, HOST_WIRE_LIMITS, OpenRequest, getDocBlocksHost, isBoundedBytePayload, isBoundedString, isElectronHost, isTrustedRendererUrl, maybeGetDocBlocksHost, parseExternalHttpUrl, parseOpenRequest };
+export { DocBlocksHostAPI, HOST_WIRE_LIMITS, HostPinnedDocument, MAX_HOST_PINNED_DOCUMENTS, OpenRequest, getDocBlocksHost, isBoundedBytePayload, isBoundedString, isElectronHost, isTrustedRendererUrl, maybeGetDocBlocksHost, parseExternalHttpUrl, parseOpenRequest, parsePinnedMenuDocuments };

package/dist/host/index.js

@@ -6,15 +6,18 @@ import {
 } from "../chunk-6XHOOBYF.js";
 import {
   HOST_WIRE_LIMITS,
+  MAX_HOST_PINNED_DOCUMENTS,
   isBoundedBytePayload,
   isBoundedString,
   isTrustedRendererUrl,
   parseExternalHttpUrl,
-  parseOpenRequest
-} from "../chunk-M2PUNKHS.js";
+  parseOpenRequest,
+  parsePinnedMenuDocuments
+} from "../chunk-2WDJ27EH.js";
 export {
   ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
   HOST_WIRE_LIMITS,
+  MAX_HOST_PINNED_DOCUMENTS,
   getDocBlocksHost,
   isBoundedBytePayload,
   isBoundedString,
@@ -22,5 +25,6 @@ export {
   isTrustedRendererUrl,
   maybeGetDocBlocksHost,
   parseExternalHttpUrl,
-  parseOpenRequest
+  parseOpenRequest,
+  parsePinnedMenuDocuments
 };

package/dist/index.d.ts

@@ -7,8 +7,8 @@ export { NativeFileSystemMovePathState, NativeFileSystemMoveRecoveryError, Nativ
 export { ElectronFileSystemProvider, ElectronFileSystemProviderV2 } from './filesystem/electron.js';
 export { DOCUMENT_RECOVERY_JOURNAL_SCHEMA_VERSION, DOCUMENT_RECOVERY_JOURNAL_STORAGE_KEY, DocumentCommitConflictError, DocumentCommitRequest, DocumentCommitResult, DocumentCommitTarget, DocumentConflictStrategy, DocumentExternalChangeResult, DocumentExternalSnapshot, DocumentExternalVersion, DocumentRecoveryAcknowledgement, DocumentRecoveryJournal, DocumentRecoveryJournalOptions, DocumentRecoveryRecord, DocumentRecoveryStorage, DocumentRecoveryWrite, DocumentRecoveryWriteFailure, DocumentRecoveryWriteResult, DocumentSaveReason, DocumentSession, DocumentSessionConflict, DocumentSessionConflictError, DocumentSessionEditScope, DocumentSessionLifecycle, DocumentSessionOptions, DocumentSessionSnapshot, DocumentSessionStatus, DocumentSessionTransition, FileSystemDocumentTargetOptions, createFileSystemDocumentTarget, getDefaultDocumentRecoveryStorage } from './document/index.js';
 export { ElectronWorkspaceReconciliation, TransientOrigin, WorkspaceDescriptor, ensureDefaultWorkspace, getTransientWorkspace, getWorkspace, listWorkspaces, parsePersistedWorkspaceList, reconcileElectronWorkspaceDescriptors, registerTransientWorkspace, removeWorkspace, saveWorkspace, touchWorkspace, unregisterTransientWorkspace } from './workspace/index.js';
-export { HOST_WIRE_LIMITS, getDocBlocksHost, isBoundedBytePayload, isBoundedString, isElectronHost, isTrustedRendererUrl, maybeGetDocBlocksHost, parseExternalHttpUrl, parseOpenRequest } from './host/index.js';
+export { HOST_WIRE_LIMITS, MAX_HOST_PINNED_DOCUMENTS, getDocBlocksHost, isBoundedBytePayload, isBoundedString, isElectronHost, isTrustedRendererUrl, maybeGetDocBlocksHost, parseExternalHttpUrl, parseOpenRequest, parsePinnedMenuDocuments } from './host/index.js';
 export { SHARED_DOCUMENT_LIMITS, SharedDocumentHashParseResult, SharedDocumentMode, SharedDocumentPayload, createSharedDocumentHash, createSharedDocumentUrl, parseSharedDocumentHash } from './share/index.js';
-export { D as DocBlocksHostAPI, a as DocBlocksHostExportAPI, b as DocBlocksHostExternalAPI, c as DocBlocksHostFfmpegAPI, d as DocBlocksHostFsAPI, e as DocBlocksHostFsV2API, f as DocBlocksHostGitAPI, g as DocBlocksHostLifecycleAPI, h as DocBlocksHostShellAPI, i as DocBlocksHostUpdaterAPI, j as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, k as ElectronWorkspaceInfo, l as ExternalBinaryCommitResult, G as GitBranchInfo, m as GitCapabilities, n as GitCloneHandle, o as GitCloneProgress, p as GitError, q as GitErrorCode, r as GitFileAtRevision, s as GitFileChange, t as GitFileStatusCode, u as GitLogEntry, v as GitLogOptions, w as GitRemoteInfo, x as GitRepoDetection, y as GitResult, z as GitRevision, A as GitStatus, H as HostCloseReason, B as HostEnvironment, C as HostExportTargetGrant, F as HostFileSystemV2OpenRequest, I as HostFileSystemV2Result, J as HostFileSystemV2WatchMessage, K as HostPrepareCloseRequest, L as HostPrepareCloseResult, M as MenuCommand, O as OpenRequest, U as UpdateCheckResult, N as UpdateInstallResult, P as UpdaterStatus } from './types-Cv4uiosG.js';
+export { D as DocBlocksHostAPI, a as DocBlocksHostExportAPI, b as DocBlocksHostExternalAPI, c as DocBlocksHostFfmpegAPI, d as DocBlocksHostFsAPI, e as DocBlocksHostFsV2API, f as DocBlocksHostGitAPI, g as DocBlocksHostLifecycleAPI, h as DocBlocksHostMenuAPI, i as DocBlocksHostShellAPI, j as DocBlocksHostUpdaterAPI, k as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, l as ElectronWorkspaceInfo, m as ExternalBinaryCommitResult, G as GitBranchInfo, n as GitCapabilities, o as GitCloneHandle, p as GitCloneProgress, q as GitError, r as GitErrorCode, s as GitFileAtRevision, t as GitFileChange, u as GitFileStatusCode, v as GitLogEntry, w as GitLogOptions, x as GitRemoteInfo, y as GitRepoDetection, z as GitResult, A as GitRevision, B as GitStatus, H as HostCloseReason, C as HostEnvironment, F as HostExportTargetGrant, I as HostFileSystemV2OpenRequest, J as HostFileSystemV2Result, K as HostFileSystemV2WatchMessage, L as HostPinnedDocument, M as HostPrepareCloseRequest, N as HostPrepareCloseResult, O as MenuCommand, P as OpenRequest, U as UpdateCheckResult, Q as UpdateInstallResult, R as UpdaterStatus } from './types-CHhtLOXM.js';
 import '@bendyline/squisq/storage';
 import '@bendyline/squisq/schemas';

package/dist/index.js

@@ -47,12 +47,14 @@ import {
 } from "./chunk-6XHOOBYF.js";
 import {
   HOST_WIRE_LIMITS,
+  MAX_HOST_PINNED_DOCUMENTS,
   isBoundedBytePayload,
   isBoundedString,
   isTrustedRendererUrl,
   parseExternalHttpUrl,
-  parseOpenRequest
-} from "./chunk-M2PUNKHS.js";
+  parseOpenRequest,
+  parsePinnedMenuDocuments
+} from "./chunk-2WDJ27EH.js";
 import "./chunk-73OOROXH.js";
 import {
   parseFileSystemVersion,
@@ -135,6 +137,7 @@ export {
   IndexedDBFileSystemProvider,
   IndexedDBFileSystemProviderV2,
   LegacyFileSystemProviderV2Adapter,
+  MAX_HOST_PINNED_DOCUMENTS,
   MemoryFileSystemProvider,
   MemoryFileSystemProviderV2,
   NativeFileSystemMoveRecoveryError,
@@ -181,6 +184,7 @@ export {
   parseFileSystemVersion,
   parseOpenRequest,
   parsePersistedWorkspaceList,
+  parsePinnedMenuDocuments,
   parseSharedDocumentHash,
   parseWorkspacePath,
   reconcileElectronWorkspaceDescriptors,

package/dist/{types-Cv4uiosG.d.ts → types-CHhtLOXM.d.ts}

@@ -382,6 +382,31 @@ type UpdaterStatus = {
 };
 /** Menu-command events pushed from the main process to the renderer. */
 type MenuCommand = 'file:new' | 'file:openFolder' | 'file:revealWorkspace' | 'file:settings' | 'git:commit' | 'git:push' | 'git:pull' | 'git:fetch' | 'git:newBranch' | 'git:switchBranch' | 'git:history' | 'git:clone' | 'git:openOnRemote' | 'git:createPullRequest' | 'help:about' | 'help:checkForUpdates' | 'help:viewOnGitHub';
+/**
+ * One pinned document mirrored from the renderer into native menu surfaces.
+ *
+ * The renderer owns the authoritative pinned list (localStorage). The main
+ * process only caches the latest snapshot so the tray / menu bar can offer a
+ * one-click shortcut per document; it never persists or mutates it.
+ */
+interface HostPinnedDocument {
+    readonly workspaceId: string;
+    readonly workspaceName: string;
+    /** Canonical, root-relative workspace path. */
+    readonly path: string;
+}
+/**
+ * Renderer-to-main channel that keeps native menu surfaces in sync with
+ * renderer-owned state.
+ */
+interface DocBlocksHostMenuAPI {
+    /**
+     * Publish the current pinned-document list so the desktop tray can offer a
+     * shortcut per document that activates it in the main window. Replaces any
+     * previously published list; send an empty array to clear the shortcuts.
+     */
+    setPinnedDocuments(documents: readonly HostPinnedDocument[]): void;
+}
 /**
  * OS open-file / deep-link event resolved by the host.
  * - 'workspace-file': a file inside an already-registered workspace.
@@ -486,6 +511,7 @@ interface DocBlocksHostAPI {
     git: DocBlocksHostGitAPI;
     updater: DocBlocksHostUpdaterAPI;
     lifecycle: DocBlocksHostLifecycleAPI;
+    menu: DocBlocksHostMenuAPI;
     /**
      * Subscribe to menu commands dispatched by the native menu.
      * Returns an unsubscribe function.
@@ -498,4 +524,4 @@ interface DocBlocksHostAPI {
     onOpenRequest(listener: (request: OpenRequest) => void): () => void;
 }
 
-export { type GitStatus as A, type HostEnvironment as B, type HostExportTargetGrant as C, type DocBlocksHostAPI as D, ELECTRON_FILE_SYSTEM_V2_CAPABILITIES as E, type HostFileSystemV2OpenRequest as F, type GitBranchInfo as G, type HostCloseReason as H, type HostFileSystemV2Result as I, type HostFileSystemV2WatchMessage as J, type HostPrepareCloseRequest as K, type HostPrepareCloseResult as L, type MenuCommand as M, type UpdateInstallResult as N, type OpenRequest as O, type UpdaterStatus as P, type UpdateCheckResult as U, type DocBlocksHostExportAPI as a, type DocBlocksHostExternalAPI as b, type DocBlocksHostFfmpegAPI as c, type DocBlocksHostFsAPI as d, type DocBlocksHostFsV2API as e, type DocBlocksHostGitAPI as f, type DocBlocksHostLifecycleAPI as g, type DocBlocksHostShellAPI as h, type DocBlocksHostUpdaterAPI as i, type DocBlocksHostWorkspacesAPI as j, type ElectronWorkspaceInfo as k, type ExternalBinaryCommitResult as l, type GitCapabilities as m, type GitCloneHandle as n, type GitCloneProgress as o, type GitError as p, type GitErrorCode as q, type GitFileAtRevision as r, type GitFileChange as s, type GitFileStatusCode as t, type GitLogEntry as u, type GitLogOptions as v, type GitRemoteInfo as w, type GitRepoDetection as x, type GitResult as y, type GitRevision as z };
+export { type GitRevision as A, type GitStatus as B, type HostEnvironment as C, type DocBlocksHostAPI as D, ELECTRON_FILE_SYSTEM_V2_CAPABILITIES as E, type HostExportTargetGrant as F, type GitBranchInfo as G, type HostCloseReason as H, type HostFileSystemV2OpenRequest as I, type HostFileSystemV2Result as J, type HostFileSystemV2WatchMessage as K, type HostPinnedDocument as L, type HostPrepareCloseRequest as M, type HostPrepareCloseResult as N, type MenuCommand as O, type OpenRequest as P, type UpdateInstallResult as Q, type UpdaterStatus as R, type UpdateCheckResult as U, type DocBlocksHostExportAPI as a, type DocBlocksHostExternalAPI as b, type DocBlocksHostFfmpegAPI as c, type DocBlocksHostFsAPI as d, type DocBlocksHostFsV2API as e, type DocBlocksHostGitAPI as f, type DocBlocksHostLifecycleAPI as g, type DocBlocksHostMenuAPI as h, type DocBlocksHostShellAPI as i, type DocBlocksHostUpdaterAPI as j, type DocBlocksHostWorkspacesAPI as k, type ElectronWorkspaceInfo as l, type ExternalBinaryCommitResult as m, type GitCapabilities as n, type GitCloneHandle as o, type GitCloneProgress as p, type GitError as q, type GitErrorCode as r, type GitFileAtRevision as s, type GitFileChange as t, type GitFileStatusCode as u, type GitLogEntry as v, type GitLogOptions as w, type GitRemoteInfo as x, type GitRepoDetection as y, type GitResult as z };

package/dist/vscode/index.d.ts

@@ -22,11 +22,22 @@ declare const DOCBLOCKS_ACCENT_COLORS: readonly ["brown", "green", "blue", "purp
 type DocBlocksAccentColor = (typeof DOCBLOCKS_ACCENT_COLORS)[number];
 declare const DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MIN = 12;
 declare const DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MAX = 32;
-declare const DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MIN = 1.2;
+declare const DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MIN = 1;
 declare const DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MAX = 2.4;
+/**
+ * Stable ids for the Write-canvas font schemes. This is the wire/persisted
+ * contract for the font choice; the human labels and the resolved CSS
+ * font-family strings live with the UI in `@bendyline/docblocks-react`
+ * (`WRITE_CANVAS_FONT_SCHEMES`). A guard test keeps this list, the react
+ * 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"];
+type DocBlocksWriteCanvasFontScheme = (typeof DOCBLOCKS_WRITE_CANVAS_FONT_SCHEMES)[number];
 interface VscodeWriteCanvasSettings {
     textSize: number;
     lineSpacing: number;
+    fontScheme: DocBlocksWriteCanvasFontScheme;
 }
 declare const DEFAULT_VSCODE_WRITE_CANVAS_SETTINGS: Readonly<VscodeWriteCanvasSettings>;
 interface VscodeEditorSettings {
@@ -219,7 +230,18 @@ declare function parseExtensionToWebviewMessage(value: unknown): ExtensionToWebv
 declare function isDocBlocksAccentColor(value: unknown): value is DocBlocksAccentColor;
 declare function isDocBlocksWriteCanvasTextSize(value: unknown): value is number;
 declare function isDocBlocksWriteCanvasLineSpacing(value: unknown): value is number;
+declare function isDocBlocksWriteCanvasFontScheme(value: unknown): value is DocBlocksWriteCanvasFontScheme;
 declare function isSafeExportFilename(value: unknown): value is string;
 declare function isSafeMimeType(value: unknown): value is string;
 
-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, type DocBlocksAccentColor, type DocumentConflictChoice, type DocumentConflictDetailsMessage, type DocumentSessionMessageStatus, type ExportTargetGrantMessage, type ExtensionToWebviewMessage, type MediaEntryMessage, type VscodeEditorSettings, type VscodeWriteCanvasSettings, type WebviewToExtensionMessage, isDocBlocksAccentColor, isDocBlocksWriteCanvasLineSpacing, isDocBlocksWriteCanvasTextSize, isSafeExportFilename, isSafeMimeType, parseExtensionToWebviewMessage, parseWebviewToExtensionMessage };
+/**
+ * Return whether two document snapshots differ by more than whitespace.
+ *
+ * VS Code's DocBlocks webview is allowed to hydrate and navigate without
+ * authoring a file edit. Before the user's first substantive edit, hosts use
+ * this comparison to discard serializer churn that only changes line breaks,
+ * indentation, or other whitespace.
+ */
+declare function hasSubstantiveTextChange(baseline: string, candidate: string): boolean;
+
+export { 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, type VscodeEditorSettings, type VscodeWriteCanvasSettings, type WebviewToExtensionMessage, hasSubstantiveTextChange, isDocBlocksAccentColor, isDocBlocksWriteCanvasFontScheme, isDocBlocksWriteCanvasLineSpacing, isDocBlocksWriteCanvasTextSize, isSafeExportFilename, isSafeMimeType, parseExtensionToWebviewMessage, parseWebviewToExtensionMessage };

package/dist/vscode/index.js

@@ -1,7 +1,7 @@
 import {
   HOST_WIRE_LIMITS,
   isBoundedString
-} from "../chunk-M2PUNKHS.js";
+} from "../chunk-2WDJ27EH.js";
 
 // src/vscode/messages.ts
 var MAX_REQUEST_ID = 2147483647;
@@ -16,11 +16,24 @@ var DOCBLOCKS_ACCENT_COLORS = [
 ];
 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_MIN = 1;
 var DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MAX = 2.4;
+var DOCBLOCKS_WRITE_CANVAS_FONT_SCHEMES = [
+  "theme",
+  "serif-sans",
+  "sans-sans",
+  "serif-serif",
+  "pt-serif",
+  "hanken",
+  "playfair-pt-serif",
+  "hanken-lora",
+  "dm-serif-dm-sans",
+  "inter"
+];
 var DEFAULT_VSCODE_WRITE_CANVAS_SETTINGS = {
   textSize: 16,
-  lineSpacing: 1.7
+  lineSpacing: 1.7,
+  fontScheme: "theme"
 };
 function parseWebviewToExtensionMessage(value) {
   if (!isRecord(value) || typeof value.type !== "string") return null;
@@ -295,8 +308,11 @@ function isDocBlocksWriteCanvasLineSpacing(value) {
     DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MAX
   );
 }
+function isDocBlocksWriteCanvasFontScheme(value) {
+  return DOCBLOCKS_WRITE_CANVAS_FONT_SCHEMES.some((scheme) => scheme === value);
+}
 function parseVscodeWriteCanvasSettings(value) {
-  return isRecord(value) && hasOnlyKeys(value, ["textSize", "lineSpacing"]) && isDocBlocksWriteCanvasTextSize(value.textSize) && isDocBlocksWriteCanvasLineSpacing(value.lineSpacing) ? { textSize: value.textSize, lineSpacing: value.lineSpacing } : null;
+  return isRecord(value) && hasOnlyKeys(value, ["textSize", "lineSpacing", "fontScheme"]) && isDocBlocksWriteCanvasTextSize(value.textSize) && isDocBlocksWriteCanvasLineSpacing(value.lineSpacing) && isDocBlocksWriteCanvasFontScheme(value.fontScheme) ? { textSize: value.textSize, lineSpacing: value.lineSpacing, fontScheme: value.fontScheme } : null;
 }
 function numberInRange(value, min, max) {
   return typeof value === "number" && Number.isFinite(value) && value >= min && value <= max;
@@ -372,14 +388,39 @@ function isSafeMimeType(value) {
     value
   );
 }
+
+// src/vscode/text-change.ts
+function hasSubstantiveTextChange(baseline, candidate) {
+  let baselineIndex = 0;
+  let candidateIndex = 0;
+  while (true) {
+    baselineIndex = skipWhitespace(baseline, baselineIndex);
+    candidateIndex = skipWhitespace(candidate, candidateIndex);
+    const baselineEnded = baselineIndex === baseline.length;
+    const candidateEnded = candidateIndex === candidate.length;
+    if (baselineEnded || candidateEnded) return baselineEnded !== candidateEnded;
+    if (baseline[baselineIndex] !== candidate[candidateIndex]) return true;
+    baselineIndex += 1;
+    candidateIndex += 1;
+  }
+}
+var WHITESPACE_CHARACTER = /\s/u;
+function skipWhitespace(value, start) {
+  let index = start;
+  while (index < value.length && WHITESPACE_CHARACTER.test(value[index])) index += 1;
+  return index;
+}
 export {
   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,
+  hasSubstantiveTextChange,
   isDocBlocksAccentColor,
+  isDocBlocksWriteCanvasFontScheme,
   isDocBlocksWriteCanvasLineSpacing,
   isDocBlocksWriteCanvasTextSize,
   isSafeExportFilename,

package/dist/workspace/index.d.ts

@@ -1,5 +1,5 @@
 import { q as FileSystemProvider } from '../types-BEg5SQ1_.js';
-import { k as ElectronWorkspaceInfo, B as HostEnvironment } from '../types-Cv4uiosG.js';
+import { l as ElectronWorkspaceInfo, C as HostEnvironment } from '../types-CHhtLOXM.js';
 import '../workspace-path-CWVrcuPL.js';
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/docblocks",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "description": "Core data structures and filesystem abstractions for DocBlocks",
   "license": "MIT",
   "author": "Bendyline",
@@ -23,9 +23,13 @@
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "sideEffects": false,
+  "//sideEffects": "tsup's split multi-entry build emits bare imports for shared chunks. Mark only those generated chunks as side-effectful so consumer bundlers retain them without treating the public entries as side-effectful.",
+  "sideEffects": [
+    "./dist/chunk-*.js"
+  ],
   "files": [
-    "dist"
+    "dist",
+    "THIRD_PARTY_NOTICES.txt"
   ],
   "exports": {
     ".": {
@@ -99,7 +103,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@bendyline/squisq": "2.3.2",
+    "@bendyline/squisq": "2.4.1",
     "zod": "3.25.76"
   }
 }