@bendyline/docblocks 2.4.0 → 2.6.0

package/THIRD_PARTY_NOTICES.txt

@@ -14,7 +14,7 @@ This notice is included in the published npm tarball. Transitive packages instal
 
 | Package | Version | License | Source |
 | --- | --- | --- | --- |
-| @bendyline/squisq | 2.8.0 | MIT | https://github.com/bendyline/squisq |
+| @bendyline/squisq | 2.11.1 | MIT | https://github.com/bendyline/squisq |
 | @types/debug | 4.1.12 | MIT | https://github.com/DefinitelyTyped/DefinitelyTyped |
 | @types/hast | 3.0.4 | MIT | https://github.com/DefinitelyTyped/DefinitelyTyped |
 | @types/katex | 0.16.8 | MIT | https://github.com/DefinitelyTyped/DefinitelyTyped |
@@ -132,7 +132,7 @@ This notice is included in the published npm tarball. Transitive packages instal
 Package-local license, copying, and notice files are reproduced below. Where a published package omits its repository license, the reviewed aggregate or README identified in `Source files` supplies the retained material.
 
 ==============================================================================
-Components: @bendyline/squisq@2.8.0
+Components: @bendyline/squisq@2.11.1
 Source files: node_modules/@bendyline/squisq/LICENSE
 ==============================================================================
 MIT License
@@ -158,7 +158,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 ==============================================================================
-Components: @bendyline/squisq@2.8.0
+Components: @bendyline/squisq@2.11.1
 Source files: node_modules/@bendyline/squisq/NOTICE.md
 ==============================================================================
 # Third-Party Notices for @bendyline/squisq
@@ -189,7 +189,7 @@ third-party license texts for bundled code and data are shipped in
 THIRD_PARTY_LICENSES.txt.
 
 ==============================================================================
-Components: @bendyline/squisq@2.8.0
+Components: @bendyline/squisq@2.11.1
 Source files: node_modules/@bendyline/squisq/THIRD_PARTY_LICENSES.txt
 ==============================================================================
 THIRD-PARTY LICENSES FOR @bendyline/squisq

package/dist/{chunk-LMMOFRGQ.js → chunk-FBCGLK6N.js}

@@ -1,5 +1,7 @@
 // src/share/index.ts
 var SHARED_DOCUMENT_LIMITS = Object.freeze({
+  /** Conservative ceiling for a locally rendered, medium-correction QR code. */
+  qrUrlCharacters: 2048,
   /** A conservative interoperability threshold, not a universal browser limit. */
   portableUrlCharacters: 4096,
   /** Hard cap applied before a hash is copied or decoded. */

package/dist/{chunk-6L3JRDE7.js → chunk-KLQKU74Q.js}

@@ -273,6 +273,11 @@ var DocumentSession = class {
       if (this.conflict.localContent === this.content && this.conflict.localRevision === this.revision && this.conflict.externalContent === change.content && this.conflict.externalVersion === externalVersion) {
         return "ignored";
       }
+      const localBranchIsStillClean = this.savingRevision === null && this.lifecycle === "open" && this.persistedRevision === this.revision && this.persistedContent === this.content && this.conflict.localRevision === this.revision && this.conflict.localContent === this.content;
+      if (localBranchIsStillClean && change.content !== null) {
+        this.adoptExternalContent(change.content);
+        return "applied";
+      }
       this.clearAutoSaveTimer();
       this.haltDrain = true;
       this.conflict = {
@@ -292,13 +297,7 @@ var DocumentSession = class {
     }
     const isClean = this.persistedRevision === this.revision && this.savingRevision === null && this.error === null && this.conflict === null;
     if (isClean && change.content !== null) {
-      this.content = change.content;
-      this.revision += 1;
-      this.persistedRevision = this.revision;
-      this.persistedContent = change.content;
-      this.generation += 1;
-      this.discardRecoverySnapshot();
-      this.emit();
+      this.adoptExternalContent(change.content);
       return "applied";
     }
     this.clearAutoSaveTimer();
@@ -315,6 +314,20 @@ var DocumentSession = class {
     this.emit();
     return "conflict";
   }
+  adoptExternalContent(content) {
+    this.clearAutoSaveTimer();
+    this.autoSaveRetryAttempt = 0;
+    this.content = content;
+    this.revision += 1;
+    this.persistedRevision = this.revision;
+    this.persistedContent = content;
+    this.generation += 1;
+    this.haltDrain = false;
+    this.error = null;
+    this.conflict = null;
+    this.discardRecoverySnapshot();
+    this.emit();
+  }
   resolveConflict(strategy) {
     return this.enqueueOperation(async () => {
       if (!this.conflict) return this.snapshot;

package/dist/{chunk-EG3WGSZH.js → chunk-YWYT6K6J.js}

@@ -102,6 +102,19 @@ function parseArtifactRef(value) {
   };
 }
 function parseDocumentSource(value) {
+  if (typeof value === "string") {
+    const text = value.trim();
+    if (text.startsWith("{")) {
+      try {
+        return parseDocumentSource(JSON.parse(text));
+      } catch {
+        return null;
+      }
+    }
+    if (isArtifactUri(text)) return { kind: "artifact", uri: text };
+    const parsedPath = parseNonRootWorkspacePath(text);
+    return parsedPath === null ? null : { kind: "file", rootId: null, path: parsedPath, format: null };
+  }
   if (!isRecord(value) || typeof value.kind !== "string") return null;
   switch (value.kind) {
     case "markdown": {
@@ -116,13 +129,14 @@ function parseDocumentSource(value) {
       return { kind: "markdown", markdown, name };
     }
     case "file": {
-      if (!hasExactKeys(value, ["kind", "rootId", "path"]) && !hasExactKeys(value, ["kind", "rootId", "path", "format"])) {
+      if (!hasExactKeys(value, ["kind", "rootId", "path"]) && !hasExactKeys(value, ["kind", "rootId", "path", "format"]) && !hasExactKeys(value, ["kind", "path"]) && !hasExactKeys(value, ["kind", "path", "format"])) {
         return null;
       }
-      const { rootId, path } = value;
+      const path = value.path;
+      const rootId = Object.prototype.hasOwnProperty.call(value, "rootId") ? value.rootId : null;
       const format = Object.prototype.hasOwnProperty.call(value, "format") ? value.format : null;
       const parsedPath = parseNonRootWorkspacePath(path);
-      if (!isIdentifier(rootId) || parsedPath === null || !(format === null || isFormat(format))) {
+      if (!(rootId === null || isIdentifier(rootId)) || parsedPath === null || !(format === null || isFormat(format))) {
         return null;
       }
       return { kind: "file", rootId, path: parsedPath, format };

package/dist/document/index.d.ts

@@ -310,6 +310,7 @@ declare class DocumentSession {
      * adopt it. Dirty or saving sessions preserve local text and enter conflict.
      */
     observeExternal(change: DocumentExternalSnapshot): DocumentExternalChangeResult;
+    private adoptExternalContent;
     resolveConflict(strategy: DocumentConflictStrategy): Promise<DocumentSessionSnapshot>;
     /**
      * Freeze edits and flush through the latest revision. A successful call

package/dist/document/index.js

@@ -7,7 +7,7 @@ import {
   DocumentSessionConflictError,
   createFileSystemDocumentTarget,
   getDefaultDocumentRecoveryStorage
-} from "../chunk-6L3JRDE7.js";
+} from "../chunk-KLQKU74Q.js";
 import "../chunk-QI6YKTQV.js";
 import "../chunk-M5ZNQGR5.js";
 import "../chunk-AYWKIZLD.js";

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-Bb3yccTH.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 export { isElectronHost } from '../host/index.js';
-import '../types-D2CRLJB6.js';
+import '../types-DBYraXxE.js';
 
 /** Pure renderer-side client for the typed Electron filesystem v2 transport. */
 declare class ElectronFileSystemProviderV2 implements FileSystemProviderV2 {

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-D2CRLJB6.js';
+import '../types-DBYraXxE.js';
 
 interface DecodeUtf8TextOptions {
     /** User-facing description of the payload being decoded. */

package/dist/host/index.d.ts

@@ -1,5 +1,5 @@
-import { Q as OpenRequest, M as HostPinnedDocument, D as DocBlocksHostAPI } from '../types-D2CRLJB6.js';
-export { a as DocBlocksHostClipboardAPI, b as DocBlocksHostExportAPI, c as DocBlocksHostExternalAPI, d as DocBlocksHostFfmpegAPI, e as DocBlocksHostFsAPI, f as DocBlocksHostFsV2API, g as DocBlocksHostGitAPI, h as DocBlocksHostLifecycleAPI, i as DocBlocksHostMenuAPI, j as DocBlocksHostShellAPI, k as DocBlocksHostUpdaterAPI, l as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, m as ElectronWorkspaceInfo, n as ExternalBinaryCommitResult, G as GitBranchInfo, o as GitCapabilities, p as GitCloneHandle, q as GitCloneProgress, r as GitError, s as GitErrorCode, t as GitFileAtRevision, u as GitFileChange, v as GitFileStatusCode, w as GitLogEntry, x as GitLogOptions, y as GitRemoteInfo, z as GitRepoDetection, A as GitResult, B as GitRevision, C as GitStatus, H as HostCloseReason, F as HostEnvironment, I as HostExportTargetGrant, J as HostFileSystemV2OpenRequest, K as HostFileSystemV2Result, L as HostFileSystemV2WatchMessage, N as HostPrepareCloseRequest, O as HostPrepareCloseResult, P as MenuCommand, U as UpdateCheckResult, R as UpdateInstallResult, S as UpdaterStatus } from '../types-D2CRLJB6.js';
+import { Q as OpenRequest, M as HostPinnedDocument, D as DocBlocksHostAPI } from '../types-DBYraXxE.js';
+export { a as DocBlocksHostClipboardAPI, b as DocBlocksHostExportAPI, c as DocBlocksHostExternalAPI, d as DocBlocksHostFfmpegAPI, e as DocBlocksHostFsAPI, f as DocBlocksHostFsV2API, g as DocBlocksHostGitAPI, h as DocBlocksHostLifecycleAPI, i as DocBlocksHostMenuAPI, j as DocBlocksHostShellAPI, k as DocBlocksHostUpdaterAPI, l as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, m as ElectronWorkspaceInfo, n as ExternalBinaryCommitResult, G as GitBranchInfo, o as GitCapabilities, p as GitCloneHandle, q as GitCloneProgress, r as GitError, s as GitErrorCode, t as GitFileAtRevision, u as GitFileChange, v as GitFileStatusCode, w as GitLogEntry, x as GitLogOptions, y as GitRemoteInfo, z as GitRepoDetection, A as GitResult, B as GitRevision, C as GitStatus, H as HostCloseReason, F as HostEnvironment, I as HostExportTargetGrant, J as HostFileSystemV2OpenRequest, K as HostFileSystemV2Result, L as HostFileSystemV2WatchMessage, N as HostPrepareCloseRequest, O as HostPrepareCloseResult, P as MenuCommand, U as UpdateCheckResult, R as UpdateInstallResult, S as UpdaterStatus } from '../types-DBYraXxE.js';
 import '../types-Bb3yccTH.js';
 import '../workspace-path-CWVrcuPL.js';
 

package/dist/index.d.ts

@@ -9,6 +9,6 @@ export { DOCUMENT_RECOVERY_JOURNAL_SCHEMA_VERSION, DOCUMENT_RECOVERY_JOURNAL_STO
 export { ElectronWorkspaceReconciliation, TransientOrigin, WorkspaceDescriptor, ensureDefaultWorkspace, getTransientWorkspace, getWorkspace, listWorkspaces, parsePersistedWorkspaceList, reconcileElectronWorkspaceDescriptors, registerTransientWorkspace, removeWorkspace, saveWorkspace, touchWorkspace, unregisterTransientWorkspace } from './workspace/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 DocBlocksHostClipboardAPI, b as DocBlocksHostExportAPI, c as DocBlocksHostExternalAPI, d as DocBlocksHostFfmpegAPI, e as DocBlocksHostFsAPI, f as DocBlocksHostFsV2API, g as DocBlocksHostGitAPI, h as DocBlocksHostLifecycleAPI, i as DocBlocksHostMenuAPI, j as DocBlocksHostShellAPI, k as DocBlocksHostUpdaterAPI, l as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, m as ElectronWorkspaceInfo, n as ExternalBinaryCommitResult, G as GitBranchInfo, o as GitCapabilities, p as GitCloneHandle, q as GitCloneProgress, r as GitError, s as GitErrorCode, t as GitFileAtRevision, u as GitFileChange, v as GitFileStatusCode, w as GitLogEntry, x as GitLogOptions, y as GitRemoteInfo, z as GitRepoDetection, A as GitResult, B as GitRevision, C as GitStatus, H as HostCloseReason, F as HostEnvironment, I as HostExportTargetGrant, J as HostFileSystemV2OpenRequest, K as HostFileSystemV2Result, L as HostFileSystemV2WatchMessage, M as HostPinnedDocument, N as HostPrepareCloseRequest, O as HostPrepareCloseResult, P as MenuCommand, Q as OpenRequest, U as UpdateCheckResult, R as UpdateInstallResult, S as UpdaterStatus } from './types-D2CRLJB6.js';
+export { D as DocBlocksHostAPI, a as DocBlocksHostClipboardAPI, b as DocBlocksHostExportAPI, c as DocBlocksHostExternalAPI, d as DocBlocksHostFfmpegAPI, e as DocBlocksHostFsAPI, f as DocBlocksHostFsV2API, g as DocBlocksHostGitAPI, h as DocBlocksHostLifecycleAPI, i as DocBlocksHostMenuAPI, j as DocBlocksHostShellAPI, k as DocBlocksHostUpdaterAPI, l as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, m as ElectronWorkspaceInfo, n as ExternalBinaryCommitResult, G as GitBranchInfo, o as GitCapabilities, p as GitCloneHandle, q as GitCloneProgress, r as GitError, s as GitErrorCode, t as GitFileAtRevision, u as GitFileChange, v as GitFileStatusCode, w as GitLogEntry, x as GitLogOptions, y as GitRemoteInfo, z as GitRepoDetection, A as GitResult, B as GitRevision, C as GitStatus, H as HostCloseReason, F as HostEnvironment, I as HostExportTargetGrant, J as HostFileSystemV2OpenRequest, K as HostFileSystemV2Result, L as HostFileSystemV2WatchMessage, M as HostPinnedDocument, N as HostPrepareCloseRequest, O as HostPrepareCloseResult, P as MenuCommand, Q as OpenRequest, U as UpdateCheckResult, R as UpdateInstallResult, S as UpdaterStatus } from './types-DBYraXxE.js';
 import '@bendyline/squisq/storage';
 import '@bendyline/squisq/schemas';

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   createSharedDocumentHash,
   createSharedDocumentUrl,
   parseSharedDocumentHash
-} from "./chunk-LMMOFRGQ.js";
+} from "./chunk-FBCGLK6N.js";
 import {
   FileSystemContentContainer,
   LegacyFileSystemProviderV2Adapter,
@@ -69,7 +69,7 @@ import {
   DocumentSessionConflictError,
   createFileSystemDocumentTarget,
   getDefaultDocumentRecoveryStorage
-} from "./chunk-6L3JRDE7.js";
+} from "./chunk-KLQKU74Q.js";
 import {
   FileSystemMoveRecoveryError,
   FileSystemPartialMoveError,

package/dist/mcp/index.d.ts

@@ -1,5 +1,5 @@
-import { A as ArtifactRef, C as ComparisonResult, a as ConversionResult, D as DocumentSource, I as InspectionResult, M as MaterializationOptions, b as McpDiagnostic, c as McpErrorResult, P as PreviewResult } from '../types-DapJIsC2.js';
-export { d as AppliedOption, e as AppliedOptionValue, f as ApplyInferredThemeResult, g as ArtifactDocumentSource, h as AssetSummary, i as AuthoringContextResult, j as AuthoringGoal, k as AuthoringSyntaxSummary, l as AuthoringTemplateSummary, B as BlockSummary, m as BundleAssetContentSource, n as BundleAssetRef, o as BundleDocumentSource, p as ComparisonCategory, q as ComparisonChange, r as ComparisonMetric, s as ComparisonStatus, t as ConversionFidelity, u as ConvertDocumentResult, v as DOCBLOCKS_MCP_TOOL_NAMES, w as DOCBLOCKS_MCP_WIRE_VERSION, x as DescribeTemplateResult, y as DescribeThemeResult, z as DescribedTemplate, E as DiagnosticLocation, F as DiagnosticSeverity, G as DiagnosticStage, H as DocBlocksMcpToolName, J as DocBlocksMcpWireVersion, K as DocumentItemSummary, L as DocumentMetadataSummary, N as DocumentStatistics, O as EngineVersion, Q as FileDocumentSource, R as FormatCapabilitySummary, S as FormatDirectionCapability, T as InferThemeResult, U as InferredLayoutSummary, V as InspectPptxLayoutsResult, W as LinkSummary, X as ListFormatsResult, Y as ListRootsResult, Z as ListTemplatesResult, _ as ListThemesResult, $ as ListTransformStylesResult, a0 as MarkdownDocumentSource, a1 as McpErrorDetail, a2 as McpSuccessResult, a3 as OutlineEntry, a4 as PptxLayoutSummary, a5 as PptxSlideSize, a6 as PreviewItem, a7 as PreviewItemKind, a8 as RecommendTemplatesResult, a9 as RootGrantSummary, aa as SaveArtifactResult, ab as SavedArtifactDestination, ac as SourceRange, ad as TableSummary, ae as TemplateAuthoringRole, af as TemplateBodyPolicy, ag as TemplateContentProfile, ah as TemplateInputSummary, ai as TemplateRecommendation, aj as TemplateSummary, ak as ThemeCatalogEntry, al as ThemeDescription, am as ThemeDescriptionColors, an as ThemeSummary, ao as TransformStyleSummary } from '../types-DapJIsC2.js';
+import { A as ArtifactRef, C as ComparisonResult, a as ConversionResult, D as DocumentSource, I as InspectionResult, M as MaterializationOptions, b as McpDiagnostic, c as McpErrorResult, P as PreviewResult } from '../types-Oy9U5FST.js';
+export { d as AppliedOption, e as AppliedOptionValue, f as ApplyInferredThemeResult, g as ArtifactDocumentSource, h as AssetSummary, i as AuthoringContextResult, j as AuthoringGoal, k as AuthoringSyntaxSummary, l as AuthoringTemplateSummary, B as BlockSummary, m as BundleAssetContentSource, n as BundleAssetRef, o as BundleDocumentSource, p as ComparisonCategory, q as ComparisonChange, r as ComparisonMetric, s as ComparisonStatus, t as ConversionFidelity, u as ConvertDocumentResult, v as DOCBLOCKS_MCP_TOOL_NAMES, w as DOCBLOCKS_MCP_WIRE_VERSION, x as DescribeTemplateResult, y as DescribeThemeResult, z as DescribedTemplate, E as DiagnosticLocation, F as DiagnosticSeverity, G as DiagnosticStage, H as DocBlocksMcpToolName, J as DocBlocksMcpWireVersion, K as DocumentItemSummary, L as DocumentMetadataSummary, N as DocumentStatistics, O as EngineVersion, Q as FileDocumentSource, R as FormatCapabilitySummary, S as FormatDirectionCapability, T as InferThemeResult, U as InferredLayoutSummary, V as InspectPptxLayoutsResult, W as LinkSummary, X as ListFormatsResult, Y as ListRootsResult, Z as ListTemplatesResult, _ as ListThemesResult, $ as ListTransformStylesResult, a0 as MarkdownDocumentSource, a1 as McpErrorDetail, a2 as McpSuccessResult, a3 as OutlineEntry, a4 as PptxLayoutSummary, a5 as PptxSlideSize, a6 as PreviewItem, a7 as PreviewItemKind, a8 as RecommendTemplatesResult, a9 as RootGrantSummary, aa as SaveArtifactResult, ab as SavedArtifactDestination, ac as SourceRange, ad as TableSummary, ae as TemplateAuthoringRole, af as TemplateBodyPolicy, ag as TemplateContentProfile, ah as TemplateInputSummary, ai as TemplateRecommendation, aj as TemplateSummary, ak as ThemeCatalogEntry, al as ThemeDescription, am as ThemeDescriptionColors, an as ThemeSummary, ao as TransformStyleSummary } from '../types-Oy9U5FST.js';
 import '../workspace-path-CWVrcuPL.js';
 
 /** Quantitative limits for untrusted MCP payloads. */

package/dist/mcp/index.js

@@ -11,7 +11,7 @@ import {
   parseMcpDiagnostic,
   parseMcpErrorResult,
   parsePreviewResult
-} from "../chunk-EG3WGSZH.js";
+} from "../chunk-YWYT6K6J.js";
 import "../chunk-AYWKIZLD.js";
 export {
   DOCBLOCKS_MCP_TOOL_NAMES,

package/dist/mcp/zod.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { z as z$1 } from 'zod/v4';
-import { H as DocBlocksMcpToolName } from '../types-DapJIsC2.js';
+import { H as DocBlocksMcpToolName } from '../types-Oy9U5FST.js';
 import '../workspace-path-CWVrcuPL.js';
 
 /** Canonical Zod projection of the exact MCP wire contract for protocol SDKs. */
@@ -167,7 +167,22 @@ declare const bundleDocumentSourceSchema: z.ZodObject<{
     }[];
     name?: string | null | undefined;
 }>;
-declare const documentSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+/**
+ * Document source, with a flat-string convenience form.
+ *
+ * Small local models emitting tool calls through textual salvage produce
+ * flat KEY→string argument maps, so a structured `source` object arrives
+ * as a plain string — historically an instant .strict() rejection, and
+ * the first structural-args toolset turned that into unbreakable retry
+ * loops for every sub-frontier model (gezel's 2026-08-22 scorecard:
+ * PPTX production 0/33 across 11 local models). Accept the string
+ * spelling at the schema boundary instead: an artifact URI string is an
+ * artifact source, anything else is a root-relative file path. Inline
+ * markdown must still use the structured `{kind:"markdown"}` form — a
+ * bare string is far more often a path, and silently turning a mistyped
+ * path into a one-line document would be worse than rejecting it.
+ */
+declare const documentSourceSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"markdown">;
     markdown: z.ZodString;
     name: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
@@ -181,19 +196,19 @@ declare const documentSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject
     name?: string | null | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"file">;
-    rootId: z.ZodString;
+    rootId: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     path: z.ZodEffects<z.ZodString, string, string>;
     format: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
 }, "strict", z.ZodTypeAny, {
     path: string;
     format: string | null;
     kind: "file";
-    rootId: string;
+    rootId: string | null;
 }, {
     path: string;
     kind: "file";
-    rootId: string;
     format?: string | null | undefined;
+    rootId?: string | null | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"artifact">;
     uri: z.ZodString;
@@ -302,7 +317,38 @@ declare const documentSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject
         license: string | null;
     }[];
     name?: string | null | undefined;
-}>]>;
+}>]>, {
+    name: string | null;
+    markdown: string;
+    kind: "bundle";
+    assets: {
+        path: string;
+        source: {
+            path: string;
+            kind: "file";
+            rootId: string;
+        } | {
+            uri: string;
+            kind: "artifact";
+        };
+        mimeType: string | null;
+        altText: string | null;
+        credit: string | null;
+        license: string | null;
+    }[];
+} | {
+    name: string | null;
+    markdown: string;
+    kind: "markdown";
+} | {
+    path: string;
+    format: string | null;
+    kind: "file";
+    rootId: string | null;
+} | {
+    uri: string;
+    kind: "artifact";
+}, unknown>;
 declare const artifactRefSchema: z.ZodEffects<z.ZodObject<{
     id: z.ZodString;
     uri: z.ZodString;

package/dist/mcp/zod.js

@@ -5,7 +5,7 @@ import {
   parseConversionResult,
   parseInspectionResult,
   parsePreviewResult
-} from "../chunk-EG3WGSZH.js";
+} from "../chunk-YWYT6K6J.js";
 import "../chunk-AYWKIZLD.js";
 
 // src/mcp/zod.ts
@@ -70,7 +70,7 @@ var bundleDocumentSourceSchema = z.object({
   assets: z.array(bundleAssetSchema).max(MCP_WIRE_LIMITS.bundleAssets),
   name: labelSchema.nullable().optional().default(null)
 }).strict();
-var documentSourceSchema = z.discriminatedUnion("kind", [
+var structuredDocumentSourceSchema = z.discriminatedUnion("kind", [
   z.object({
     kind: z.literal("markdown"),
     markdown: z.string().max(MAX_MARKDOWN_CHARACTERS).regex(WIRE_STRING_PATTERN, "NUL and DEL are not permitted on the MCP wire"),
@@ -78,13 +78,31 @@ var documentSourceSchema = z.discriminatedUnion("kind", [
   }).strict(),
   z.object({
     kind: z.literal("file"),
-    rootId: idSchema,
+    // Nullable-with-default: a null rootId means "the server's sole
+    // read-enabled root". Agents on a one-root server (the common MCP
+    // setup) no longer round-trip list_roots before every conversion;
+    // multi-root servers still get an actionable error naming the
+    // candidates. See McpFileAuthority.authorizeRootRead.
+    rootId: idSchema.nullable().optional().default(null),
     path: workspacePathSchema,
     format: formatSchema.nullable().optional().default(null)
   }).strict(),
   z.object({ kind: z.literal("artifact"), uri: artifactUriSchema }).strict(),
   bundleDocumentSourceSchema
 ]);
+var documentSourceSchema = z.preprocess((value) => {
+  if (typeof value !== "string") return value;
+  const text = value.trim();
+  if (text.startsWith("{")) {
+    try {
+      return JSON.parse(text);
+    } catch {
+      return value;
+    }
+  }
+  if (ARTIFACT_URI_PATTERN.test(text)) return { kind: "artifact", uri: text };
+  return { kind: "file", path: text };
+}, structuredDocumentSourceSchema);
 var appliedOptionSchema = z.object({
   name: idSchema,
   value: z.union([boundedString, z.number().finite(), z.boolean(), z.null()])

package/dist/share/index.d.ts

@@ -24,6 +24,8 @@ type SharedDocumentHashParseResult = {
     readonly message: string;
 };
 declare const SHARED_DOCUMENT_LIMITS: Readonly<{
+    /** Conservative ceiling for a locally rendered, medium-correction QR code. */
+    qrUrlCharacters: 2048;
     /** A conservative interoperability threshold, not a universal browser limit. */
     portableUrlCharacters: 4096;
     /** Hard cap applied before a hash is copied or decoded. */

package/dist/share/index.js

@@ -3,7 +3,7 @@ import {
   createSharedDocumentHash,
   createSharedDocumentUrl,
   parseSharedDocumentHash
-} from "../chunk-LMMOFRGQ.js";
+} from "../chunk-FBCGLK6N.js";
 export {
   SHARED_DOCUMENT_LIMITS,
   createSharedDocumentHash,

package/dist/{types-D2CRLJB6.d.ts → types-DBYraXxE.d.ts}

@@ -87,10 +87,16 @@ interface GitRepoDetection {
     isRepo: boolean;
     /** False when the workspace root is a subdirectory of a larger repo. */
     rootIsToplevel?: boolean;
-    /** Main-owned repository authority; absent when expanded access was declined. */
+    /** Main-owned repository authority; absent while expanded access is ungranted. */
     repositoryId?: string;
     /** True when Git metadata or the work tree extends beyond the workspace grant. */
     requiresExpandedGrant?: boolean;
+    /**
+     * Display path of the enclosing repository root. Present only alongside
+     * `requiresExpandedGrant` so the in-app consent surface can name what the
+     * user would be granting access to.
+     */
+    repositoryRoot?: string;
 }
 type GitFileStatusCode = 'added' | 'modified' | 'deleted' | 'renamed' | 'copied' | 'type-changed' | 'untracked' | 'ignored' | 'unmerged';
 interface GitFileChange {
@@ -198,8 +204,22 @@ interface GitCloneHandle {
 }
 interface DocBlocksHostGitAPI {
     capabilities(): Promise<GitCapabilities>;
-    /** Detect a persisted workspace by opaque workspace id and mint repository authority. */
+    /**
+     * Detect a persisted workspace by opaque workspace id and mint repository
+     * authority. Never prompts: a workspace inside a larger repository comes
+     * back with `requiresExpandedGrant` and no `repositoryId` until the user
+     * opts in through `grantExpandedRepo`.
+     */
     detectRepo(workspaceId: string): Promise<GitResult<GitRepoDetection>>;
+    /**
+     * Grant expanded access to the repository enclosing the workspace and mint
+     * repository authority. Must be called from an explicit user gesture. The
+     * choice is remembered for that repository; `always` remembers it for every
+     * repository opened from a subfolder.
+     */
+    grantExpandedRepo(workspaceId: string, opts?: {
+        always?: boolean;
+    }): Promise<GitResult<GitRepoDetection>>;
     init(workspaceId: string): Promise<GitResult<void>>;
     status(repositoryId: string): Promise<GitResult<GitStatus>>;
     stage(repositoryId: string, paths: string[]): Promise<GitResult<void>>;
@@ -306,6 +326,8 @@ interface DocBlocksHostWorkspacesAPI {
 interface DocBlocksHostShellAPI {
     /** Reveal a registered workspace root or one root-relative entry. */
     revealInFolder(workspaceId: string, workspacePath?: string): Promise<void>;
+    /** Open a registered workspace root in Finder or the platform file manager. */
+    openWorkspaceFolder(workspaceId: string): Promise<void>;
     /** Open a URL in the default browser. */
     openExternal(url: string): Promise<void>;
 }
@@ -313,6 +335,8 @@ interface DocBlocksHostShellAPI {
 interface DocBlocksHostClipboardAPI {
     /** Replace the system clipboard's plain-text contents. */
     writeText(text: string): Promise<void>;
+    /** Resolve a registered workspace entry in main and copy its absolute path. */
+    writeWorkspacePath(workspaceId: string, workspacePath: string): Promise<void>;
 }
 /** Exact, main-owned export authority. The display path is never authority. */
 interface HostExportTargetGrant {

package/dist/{types-DapJIsC2.d.ts → types-Oy9U5FST.d.ts}

@@ -55,10 +55,17 @@ interface MarkdownDocumentSource {
     readonly markdown: string;
     readonly name: string | null;
 }
-/** A file selected from a server-configured, authority-scoped root. */
+/**
+ * A file selected from a server-configured, authority-scoped root.
+ *
+ * A null rootId means "the server's sole read-enabled root": callers on
+ * a one-root server may omit it, and the authority resolves or rejects
+ * with the candidate ids. It never grants new authority — resolution
+ * still goes through the same root allow-list.
+ */
 interface FileDocumentSource {
     readonly kind: 'file';
-    readonly rootId: string;
+    readonly rootId: string | null;
     readonly path: WorkspacePath;
     readonly format: string | null;
 }

package/dist/vscode/index.d.ts

@@ -1,6 +1,19 @@
 /**
  * Typed message protocol between the extension host and webview.
  */
+/**
+ * Bounds for host-persisted proofing state.
+ *
+ * Both payloads are written by the webview and stored in extension-host state,
+ * which is memory-resident and serialized on every VS Code shutdown, so neither
+ * may grow without limit. The ignore payload is the engine's opaque export —
+ * a list of context hashes — and grows only with dismissals in one document.
+ */
+declare const PROOF_STATE_LIMITS: Readonly<{
+    dictionaryWords: 5000;
+    wordCharacters: 128;
+    ignoredJsonCharacters: number;
+}>;
 type DocumentSessionMessageStatus = 'idle' | 'saved' | 'dirty' | 'saving' | 'error' | 'conflict' | 'closed';
 type DocumentConflictChoice = 'use-local' | 'use-external';
 /** Host-observed details that help a user distinguish two text branches. */
@@ -40,10 +53,21 @@ interface VscodeWriteCanvasSettings {
     fontScheme: DocBlocksWriteCanvasFontScheme;
 }
 declare const DEFAULT_VSCODE_WRITE_CANVAS_SETTINGS: Readonly<VscodeWriteCanvasSettings>;
+/**
+ * Which inline proofing squiggles the editor draws. Two switches, not
+ * one: harper's grammar rules are English-only, so a writer working in
+ * another language wants spelling alone. Both off means no engine loads.
+ */
+interface VscodeProofingSettings {
+    spelling: boolean;
+    grammar: boolean;
+}
+declare const DEFAULT_VSCODE_PROOFING_SETTINGS: Readonly<VscodeProofingSettings>;
 interface VscodeEditorSettings {
     autoSave: boolean;
     accentColor: DocBlocksAccentColor;
     writeCanvasSettings: VscodeWriteCanvasSettings;
+    proofingSettings: VscodeProofingSettings;
 }
 /**
  * An opaque, one-shot authority to write one host-owned export target.
@@ -144,6 +168,18 @@ type ExtensionToWebviewMessage = {
     type: 'workspaceFileError';
     requestId: number;
     message: string;
+} | {
+    type: 'proofDictionaryLoaded';
+    requestId: number;
+    words: string[];
+} | {
+    type: 'proofIgnoresLoaded';
+    requestId: number;
+    ignoredJson: string | null;
+} | {
+    type: 'proofStateError';
+    requestId: number;
+    message: string;
 };
 /** Messages sent from the webview to the extension host. */
 type WebviewToExtensionMessage = {
@@ -157,6 +193,9 @@ type WebviewToExtensionMessage = {
 } | {
     type: 'setWriteCanvasSettings';
     settings: VscodeWriteCanvasSettings;
+} | {
+    type: 'setProofingSettings';
+    settings: VscodeProofingSettings;
 } | {
     type: 'openLink';
     href: string;
@@ -219,6 +258,18 @@ type WebviewToExtensionMessage = {
     type: 'readWorkspaceFile';
     requestId: number;
     path: string;
+} | {
+    type: 'loadProofDictionary';
+    requestId: number;
+} | {
+    type: 'addProofDictionaryWord';
+    word: string;
+} | {
+    type: 'loadProofIgnores';
+    requestId: number;
+} | {
+    type: 'saveProofIgnores';
+    ignoredJson: string;
 };
 interface MediaEntryMessage {
     name: string;
@@ -255,4 +306,4 @@ declare function isSafeMimeType(value: unknown): value is string;
  */
 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 };
+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, type VscodeEditorSettings, type VscodeProofingSettings, type VscodeWriteCanvasSettings, type WebviewToExtensionMessage, hasSubstantiveTextChange, isDocBlocksAccentColor, isDocBlocksWriteCanvasFontScheme, isDocBlocksWriteCanvasLineSpacing, isDocBlocksWriteCanvasTextSize, isSafeExportFilename, isSafeMimeType, parseExtensionToWebviewMessage, parseWebviewToExtensionMessage };

package/dist/vscode/index.js

@@ -5,6 +5,11 @@ import {
 
 // src/vscode/messages.ts
 var MAX_REQUEST_ID = 2147483647;
+var PROOF_STATE_LIMITS = Object.freeze({
+  dictionaryWords: 5e3,
+  wordCharacters: 128,
+  ignoredJsonCharacters: 64 * 1024
+});
 var DOCBLOCKS_ACCENT_COLORS = [
   "brown",
   "green",
@@ -35,6 +40,10 @@ var DEFAULT_VSCODE_WRITE_CANVAS_SETTINGS = {
   lineSpacing: 1.7,
   fontScheme: "theme"
 };
+var DEFAULT_VSCODE_PROOFING_SETTINGS = {
+  spelling: true,
+  grammar: true
+};
 function parseWebviewToExtensionMessage(value) {
   if (!isRecord(value) || typeof value.type !== "string") return null;
   switch (value.type) {
@@ -49,6 +58,11 @@ function parseWebviewToExtensionMessage(value) {
       const settings = parseVscodeWriteCanvasSettings(value.settings);
       return settings ? { type: "setWriteCanvasSettings", settings } : null;
     }
+    case "setProofingSettings": {
+      if (!hasOnlyKeys(value, ["type", "settings"])) return null;
+      const settings = parseVscodeProofingSettings(value.settings);
+      return settings ? { type: "setProofingSettings", settings } : null;
+    }
     case "openLink":
       return hasOnlyKeys(value, ["type", "href"]) && hasBoundedString(value, "href", HOST_WIRE_LIMITS.urlCharacters, 1) ? { type: "openLink", href: value.href } : null;
     case "copyCode":
@@ -126,6 +140,13 @@ function parseWebviewToExtensionMessage(value) {
       } : 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;
+    case "loadProofDictionary":
+    case "loadProofIgnores":
+      return hasOnlyKeys(value, ["type", "requestId"]) && hasRequestId(value) ? { type: value.type, requestId: value.requestId } : null;
+    case "addProofDictionaryWord":
+      return hasOnlyKeys(value, ["type", "word"]) && hasBoundedString(value, "word", PROOF_STATE_LIMITS.wordCharacters, 1) ? { type: "addProofDictionaryWord", word: value.word } : null;
+    case "saveProofIgnores":
+      return hasOnlyKeys(value, ["type", "ignoredJson"]) && hasBoundedString(value, "ignoredJson", PROOF_STATE_LIMITS.ignoredJsonCharacters) ? { type: "saveProofIgnores", ignoredJson: value.ignoredJson } : null;
     default:
       return null;
   }
@@ -241,8 +262,20 @@ function parseExtensionToWebviewMessage(value) {
       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 "proofDictionaryLoaded": {
+      if (!hasOnlyKeys(value, ["type", "requestId", "words"]) || !hasRequestId(value)) return null;
+      const words = parseProofDictionaryWords(value.words);
+      return words ? { type: "proofDictionaryLoaded", requestId: value.requestId, words } : null;
+    }
+    case "proofIgnoresLoaded":
+      return hasOnlyKeys(value, ["type", "requestId", "ignoredJson"]) && hasRequestId(value) && hasNullableBoundedString(value, "ignoredJson", PROOF_STATE_LIMITS.ignoredJsonCharacters) ? {
+        type: "proofIgnoresLoaded",
+        requestId: value.requestId,
+        ignoredJson: value.ignoredJson
+      } : null;
     case "mediaError":
     case "exportError":
+    case "proofStateError":
     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":
@@ -260,6 +293,15 @@ function parseExtensionToWebviewMessage(value) {
       return null;
   }
 }
+function parseProofDictionaryWords(value) {
+  if (!Array.isArray(value) || value.length > PROOF_STATE_LIMITS.dictionaryWords) return null;
+  const words = [];
+  for (const entry of value) {
+    if (!isBoundedString(entry, PROOF_STATE_LIMITS.wordCharacters, 1)) return null;
+    words.push(entry);
+  }
+  return words;
+}
 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)) {
@@ -291,11 +333,20 @@ function parseDocumentConflictDetails(value) {
   };
 }
 function parseVscodeEditorSettings(value) {
-  if (!isRecord(value) || !hasOnlyKeys(value, ["autoSave", "accentColor", "writeCanvasSettings"]) || typeof value.autoSave !== "boolean" || !isDocBlocksAccentColor(value.accentColor)) {
+  if (!isRecord(value) || !hasOnlyKeys(value, ["autoSave", "accentColor", "writeCanvasSettings", "proofingSettings"]) || typeof value.autoSave !== "boolean" || !isDocBlocksAccentColor(value.accentColor)) {
     return null;
   }
   const writeCanvasSettings = parseVscodeWriteCanvasSettings(value.writeCanvasSettings);
-  return writeCanvasSettings ? { autoSave: value.autoSave, accentColor: value.accentColor, writeCanvasSettings } : null;
+  const proofingSettings = parseVscodeProofingSettings(value.proofingSettings);
+  return writeCanvasSettings && proofingSettings ? {
+    autoSave: value.autoSave,
+    accentColor: value.accentColor,
+    writeCanvasSettings,
+    proofingSettings
+  } : null;
+}
+function parseVscodeProofingSettings(value) {
+  return isRecord(value) && hasOnlyKeys(value, ["spelling", "grammar"]) && typeof value.spelling === "boolean" && typeof value.grammar === "boolean" ? { spelling: value.spelling, grammar: value.grammar } : null;
 }
 function isDocBlocksAccentColor(value) {
   return DOCBLOCKS_ACCENT_COLORS.some((color) => color === value);
@@ -417,6 +468,7 @@ function skipWhitespace(value, start) {
   return index;
 }
 export {
+  DEFAULT_VSCODE_PROOFING_SETTINGS,
   DEFAULT_VSCODE_WRITE_CANVAS_SETTINGS,
   DOCBLOCKS_ACCENT_COLORS,
   DOCBLOCKS_WRITE_CANVAS_FONT_SCHEMES,
@@ -424,6 +476,7 @@ export {
   DOCBLOCKS_WRITE_CANVAS_LINE_SPACING_MIN,
   DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MAX,
   DOCBLOCKS_WRITE_CANVAS_TEXT_SIZE_MIN,
+  PROOF_STATE_LIMITS,
   hasSubstantiveTextChange,
   isDocBlocksAccentColor,
   isDocBlocksWriteCanvasFontScheme,

package/dist/workspace/index.d.ts

@@ -1,5 +1,5 @@
 import { q as FileSystemProvider } from '../types-Bb3yccTH.js';
-import { m as ElectronWorkspaceInfo, F as HostEnvironment } from '../types-D2CRLJB6.js';
+import { m as ElectronWorkspaceInfo, F as HostEnvironment } from '../types-DBYraXxE.js';
 import '../workspace-path-CWVrcuPL.js';
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/docblocks",
-  "version": "2.4.0",
+  "version": "2.6.0",
   "description": "Core data structures and filesystem abstractions for DocBlocks",
   "license": "MIT",
   "author": "Bendyline",
@@ -20,7 +20,7 @@
     "access": "public"
   },
   "engines": {
-    "node": "^22.22.2 || ^24.15.0 || >=26.0.0"
+    "node": "^24.18.0 || >=26.0.0"
   },
   "type": "module",
   "main": "./dist/index.js",
@@ -106,7 +106,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@bendyline/squisq": "2.8.0",
+    "@bendyline/squisq": "2.11.1",
     "zod": "3.25.76"
   }
 }