@bendyline/docblocks 2.2.1 → 2.3.0

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/{chunk-DBJW7BZI.js → chunk-EG3WGSZH.js}

@@ -11,7 +11,6 @@ var DOCBLOCKS_MCP_TOOL_NAMES = [
   "create_document_bundle",
   "save_artifact",
   "inspect_document",
-  "validate_document",
   "preview_document",
   "compare_documents",
   "get_authoring_context",
@@ -307,35 +306,6 @@ function parseInspectionResult(value) {
     diagnostics
   };
 }
-function parseValidationResult(value) {
-  if (!isRecord(value) || !hasExactKeys(value, [
-    "version",
-    "kind",
-    "sourceFormat",
-    "targetFormat",
-    "valid",
-    "summary",
-    "diagnostics"
-  ]) || value.version !== DOCBLOCKS_MCP_WIRE_VERSION || value.kind !== "validation" || !isFormat(value.sourceFormat) || !(value.targetFormat === null || isFormat(value.targetFormat)) || typeof value.valid !== "boolean") {
-    return null;
-  }
-  const summary = parseValidationSummary(value.summary);
-  const diagnostics = parseArray(value.diagnostics, parseMcpDiagnostic);
-  if (summary === null || diagnostics === null) return null;
-  const actualSummary = summarizeDiagnostics(diagnostics);
-  if (summary.errorCount !== actualSummary.errorCount || summary.warningCount !== actualSummary.warningCount || summary.infoCount !== actualSummary.infoCount || value.valid !== (summary.errorCount === 0)) {
-    return null;
-  }
-  return {
-    version: DOCBLOCKS_MCP_WIRE_VERSION,
-    kind: "validation",
-    sourceFormat: value.sourceFormat,
-    targetFormat: value.targetFormat,
-    valid: value.valid,
-    summary,
-    diagnostics
-  };
-}
 function parsePreviewResult(value) {
   if (!isRecord(value) || !hasExactKeys(value, [
     "version",
@@ -595,16 +565,6 @@ function parseThemeSummary(value) {
   if (layouts === null || new Set(layouts).size !== layouts.length) return null;
   return { id: value.id, name: value.name, source: value.source, layouts };
 }
-function parseValidationSummary(value) {
-  if (!isRecord(value) || !hasExactKeys(value, ["errorCount", "warningCount", "infoCount"]) || !isNonNegativeInteger(value.errorCount) || !isNonNegativeInteger(value.warningCount) || !isNonNegativeInteger(value.infoCount)) {
-    return null;
-  }
-  return {
-    errorCount: value.errorCount,
-    warningCount: value.warningCount,
-    infoCount: value.infoCount
-  };
-}
 function parsePreviewItem(value) {
   if (!isRecord(value) || !hasExactKeys(value, ["kind", "index", "label", "artifact", "width", "height"]) || !isPreviewItemKind(value.kind) || !isNonNegativeInteger(value.index) || !isNullableBoundedString(value.label, MCP_WIRE_LIMITS.labelCharacters) || !isBoundedInteger(value.width, 1, MCP_WIRE_LIMITS.imageDimension) || !isBoundedInteger(value.height, 1, MCP_WIRE_LIMITS.imageDimension)) {
     return null;
@@ -642,17 +602,6 @@ function parseComparisonMetric(value) {
     similarity: value.similarity
   };
 }
-function summarizeDiagnostics(diagnostics) {
-  let errorCount = 0;
-  let warningCount = 0;
-  let infoCount = 0;
-  for (const diagnostic of diagnostics) {
-    if (diagnostic.severity === "error") errorCount += diagnostic.count;
-    else if (diagnostic.severity === "warning") warningCount += diagnostic.count;
-    else infoCount += diagnostic.count;
-  }
-  return { errorCount, warningCount, infoCount };
-}
 function parseArray(value, parser, maximumEntries = MCP_WIRE_LIMITS.arrayEntries) {
   if (!Array.isArray(value) || value.length > maximumEntries) return null;
   const parsed = [];
@@ -729,7 +678,7 @@ function isDiagnosticSeverity(value) {
   return value === "info" || value === "warning" || value === "error";
 }
 function isDiagnosticStage(value) {
-  return value === "resolve" || value === "import" || value === "parse" || value === "inspect" || value === "validate" || value === "transform" || value === "convert" || value === "render" || value === "export" || value === "materialize" || value === "compare";
+  return value === "resolve" || value === "import" || value === "parse" || value === "inspect" || value === "transform" || value === "convert" || value === "render" || value === "export" || value === "materialize" || value === "compare";
 }
 function isConversionFidelity(value) {
   return value === "semantic" || value === "editable-native" || value === "rendered-fidelity" || value === "hybrid";
@@ -804,7 +753,6 @@ export {
   parseMcpErrorResult,
   parseConversionResult,
   parseInspectionResult,
-  parseValidationResult,
   parsePreviewResult,
   parseComparisonResult,
   parseMaterializationOptions

package/dist/{chunk-45T5AFCN.js → chunk-MO2VYEZQ.js}

@@ -834,7 +834,7 @@ var FileSystemContentContainer = class {
           const childPath = parseWorkspacePath(child.path);
           const prefixPath = parseWorkspacePath(this.prefix);
           if (!workspacePathContains(prefixPath, childPath)) continue;
-          const rel = childPath === prefixPath ? "" : childPath.slice(prefixPath.length + 1);
+          const rel = prefixPath ? childPath === prefixPath ? "" : childPath.slice(prefixPath.length + 1) : childPath;
           if (prefix && !rel.startsWith(prefix)) continue;
           const size = child.size ?? (await this.provider.stat(child.path))?.size ?? 0;
           entries.push({

package/dist/document/index.d.ts

@@ -1,4 +1,4 @@
-import { q as FileSystemProvider } from '../types-BEg5SQ1_.js';
+import { q as FileSystemProvider } from '../types-Bb3yccTH.js';
 import '../workspace-path-CWVrcuPL.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-BEg5SQ1_.js';
+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-Cv4uiosG.js';
+import '../types-CREx02sE.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

@@ -1,5 +1,5 @@
-import { P as FsOperation, s as FileSystemProviderV2, r as FileSystemProviderCapabilities, q as FileSystemProvider, c as FileSystemAtomicity, d as FileSystemCaseSensitivity, z as FileSystemSymlinkPolicy, i as FileSystemDurability, 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, G as FileSystemWatchListener, H as FileSystemWatchOptions, I as FileSystemWatchSubscription } from '../types-BEg5SQ1_.js';
-export { F as FileCommitResult, a as FileEntry, b as FileMeta, e as FileSystemConditionalWriteStrength, f as FileSystemCreateDirectoryMode, j as FileSystemEntry, l as FileSystemEntryWatchEvent, p as FileSystemOverflowWatchEvent, t as FileSystemProviderWithV2, x as FileSystemSnapshotEntry, y as FileSystemSnapshotFile, A as FileSystemVersion, B as FileSystemWatchErrorListener, C as FileSystemWatchEvent, D as FileSystemWatchEventOrigin, E as FileSystemWatchEventType, J as FileSystemWriteMode, L as FolderEntry, M as FsError, N as FsErrorCode, O as FsErrorContext, S as SerializedFsError, Q as deserializeFsError, R as fsErrorFromUnknown, T as getFileSystemProviderV2, U as hasFileSystemProviderV2, V as isQuotaExceededError, W as isSerializedFsError, X as mapDomExceptionToFsErrorCode, Y as mapNodeErrorCodeToFsErrorCode, Z as parseFileSystemVersion, _ as serializeFsError, $ as tryParseFileSystemVersion } from '../types-BEg5SQ1_.js';
+import { P as FsOperation, s as FileSystemProviderV2, r as FileSystemProviderCapabilities, q as FileSystemProvider, c as FileSystemAtomicity, d as FileSystemCaseSensitivity, z as FileSystemSymlinkPolicy, i as FileSystemDurability, 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, G as FileSystemWatchListener, H as FileSystemWatchOptions, I as FileSystemWatchSubscription } from '../types-Bb3yccTH.js';
+export { F as FileCommitResult, a as FileEntry, b as FileMeta, e as FileSystemConditionalWriteStrength, f as FileSystemCreateDirectoryMode, j as FileSystemEntry, l as FileSystemEntryWatchEvent, p as FileSystemOverflowWatchEvent, t as FileSystemProviderWithV2, x as FileSystemSnapshotEntry, y as FileSystemSnapshotFile, A as FileSystemVersion, B as FileSystemWatchErrorListener, C as FileSystemWatchEvent, D as FileSystemWatchEventOrigin, E as FileSystemWatchEventType, J as FileSystemWriteMode, L as FolderEntry, M as FsError, N as FsErrorCode, O as FsErrorContext, S as SerializedFsError, Q as deserializeFsError, R as fsErrorFromUnknown, T as getFileSystemProviderV2, U as hasFileSystemProviderV2, V as isQuotaExceededError, W as isSerializedFsError, X as mapDomExceptionToFsErrorCode, Y as mapNodeErrorCodeToFsErrorCode, Z as parseFileSystemVersion, _ as serializeFsError, $ as tryParseFileSystemVersion } from '../types-Bb3yccTH.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 export { W as WORKSPACE_ROOT, p as parseWorkspacePath, t as tryParseWorkspacePath, w as workspacePathBasename, b as workspacePathContains, c as workspacePathDirname, d as workspacePathJoin, e as workspacePathToLegacy } from '../workspace-path-CWVrcuPL.js';
 import { MemoryFileSystemSnapshot, MemoryFileSystemProvider } from './memory.js';
@@ -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-CREx02sE.js';
 
 interface DecodeUtf8TextOptions {
     /** User-facing description of the payload being decoded. */

package/dist/filesystem/index.js

@@ -6,7 +6,7 @@ import {
   documentCompanionPath,
   moveFileSystemEntry,
   replaceMemoryWorkspaceFromDbk
-} from "../chunk-45T5AFCN.js";
+} from "../chunk-MO2VYEZQ.js";
 import {
   IndexedDBContentContainer,
   IndexedDBFileSystemProvider,
@@ -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/filesystem/indexeddb.d.ts

@@ -1,4 +1,4 @@
-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, G as FileSystemWatchListener, H as FileSystemWatchOptions, I as FileSystemWatchSubscription, b as FileMeta, q as FileSystemProvider, F as FileCommitResult, j as FileSystemEntry } from '../types-BEg5SQ1_.js';
+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, G as FileSystemWatchListener, H as FileSystemWatchOptions, I as FileSystemWatchSubscription, b as FileMeta, q as FileSystemProvider, F as FileCommitResult, j as FileSystemEntry } from '../types-Bb3yccTH.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 import { ContentContainer, ContentEntry } from '@bendyline/squisq/storage';
 

package/dist/filesystem/memory.d.ts

@@ -1,4 +1,4 @@
-import { s as FileSystemProviderV2, r as FileSystemProviderCapabilities, K as FileSystemWriteOptions, n as FileSystemFileSnapshot, F as FileCommitResult, k as FileSystemEntrySnapshot, m as FileSystemFileRead, g as FileSystemCreateDirectoryOptions, h as FileSystemDirectorySnapshot, u as FileSystemRemoveOptions, v as FileSystemRemoveResult, o as FileSystemMoveOptions, w as FileSystemSnapshot, G as FileSystemWatchListener, H as FileSystemWatchOptions, I as FileSystemWatchSubscription, q as FileSystemProvider, j as FileSystemEntry, b as FileMeta } from '../types-BEg5SQ1_.js';
+import { s as FileSystemProviderV2, r as FileSystemProviderCapabilities, K as FileSystemWriteOptions, n as FileSystemFileSnapshot, F as FileCommitResult, k as FileSystemEntrySnapshot, m as FileSystemFileRead, g as FileSystemCreateDirectoryOptions, h as FileSystemDirectorySnapshot, u as FileSystemRemoveOptions, v as FileSystemRemoveResult, o as FileSystemMoveOptions, w as FileSystemSnapshot, G as FileSystemWatchListener, H as FileSystemWatchOptions, I as FileSystemWatchSubscription, q as FileSystemProvider, j as FileSystemEntry, b as FileMeta } from '../types-Bb3yccTH.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 
 type MemoryFilePayloadKind = 'text' | 'binary';

package/dist/filesystem/native.d.ts

@@ -1,4 +1,4 @@
-import { M as FsError, 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, G as FileSystemWatchListener, H as FileSystemWatchOptions, I as FileSystemWatchSubscription, q as FileSystemProvider, F as FileCommitResult, j as FileSystemEntry, b as FileMeta } from '../types-BEg5SQ1_.js';
+import { M as FsError, 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, G as FileSystemWatchListener, 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';
 
 type NativeFileSystemMovePathState = 'present' | 'missing' | 'unknown';

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 '../types-BEg5SQ1_.js';
+import { P as OpenRequest, L as HostPinnedDocument, D as DocBlocksHostAPI } from '../types-CREx02sE.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-CREx02sE.js';
+import '../types-Bb3yccTH.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

@@ -1,4 +1,4 @@
-export { F as FileCommitResult, a as FileEntry, b as FileMeta, c as FileSystemAtomicity, d as FileSystemCaseSensitivity, e as FileSystemConditionalWriteStrength, f as FileSystemCreateDirectoryMode, g as FileSystemCreateDirectoryOptions, h as FileSystemDirectorySnapshot, i as FileSystemDurability, j as FileSystemEntry, k as FileSystemEntrySnapshot, l as FileSystemEntryWatchEvent, m as FileSystemFileRead, n as FileSystemFileSnapshot, o as FileSystemMoveOptions, p as FileSystemOverflowWatchEvent, q as FileSystemProvider, r as FileSystemProviderCapabilities, s as FileSystemProviderV2, t as FileSystemProviderWithV2, u as FileSystemRemoveOptions, v as FileSystemRemoveResult, w as FileSystemSnapshot, x as FileSystemSnapshotEntry, y as FileSystemSnapshotFile, z as FileSystemSymlinkPolicy, A as FileSystemVersion, B as FileSystemWatchErrorListener, C as FileSystemWatchEvent, D as FileSystemWatchEventOrigin, E as FileSystemWatchEventType, G as FileSystemWatchListener, H as FileSystemWatchOptions, I as FileSystemWatchSubscription, J as FileSystemWriteMode, K as FileSystemWriteOptions, L as FolderEntry, M as FsError, N as FsErrorCode, O as FsErrorContext, P as FsOperation, S as SerializedFsError, Q as deserializeFsError, R as fsErrorFromUnknown, T as getFileSystemProviderV2, U as hasFileSystemProviderV2, V as isQuotaExceededError, W as isSerializedFsError, X as mapDomExceptionToFsErrorCode, Y as mapNodeErrorCodeToFsErrorCode, Z as parseFileSystemVersion, _ as serializeFsError, $ as tryParseFileSystemVersion } from './types-BEg5SQ1_.js';
+export { F as FileCommitResult, a as FileEntry, b as FileMeta, c as FileSystemAtomicity, d as FileSystemCaseSensitivity, e as FileSystemConditionalWriteStrength, f as FileSystemCreateDirectoryMode, g as FileSystemCreateDirectoryOptions, h as FileSystemDirectorySnapshot, i as FileSystemDurability, j as FileSystemEntry, k as FileSystemEntrySnapshot, l as FileSystemEntryWatchEvent, m as FileSystemFileRead, n as FileSystemFileSnapshot, o as FileSystemMoveOptions, p as FileSystemOverflowWatchEvent, q as FileSystemProvider, r as FileSystemProviderCapabilities, s as FileSystemProviderV2, t as FileSystemProviderWithV2, u as FileSystemRemoveOptions, v as FileSystemRemoveResult, w as FileSystemSnapshot, x as FileSystemSnapshotEntry, y as FileSystemSnapshotFile, z as FileSystemSymlinkPolicy, A as FileSystemVersion, B as FileSystemWatchErrorListener, C as FileSystemWatchEvent, D as FileSystemWatchEventOrigin, E as FileSystemWatchEventType, G as FileSystemWatchListener, H as FileSystemWatchOptions, I as FileSystemWatchSubscription, J as FileSystemWriteMode, K as FileSystemWriteOptions, L as FolderEntry, M as FsError, N as FsErrorCode, O as FsErrorContext, P as FsOperation, S as SerializedFsError, Q as deserializeFsError, R as fsErrorFromUnknown, T as getFileSystemProviderV2, U as hasFileSystemProviderV2, V as isQuotaExceededError, W as isSerializedFsError, X as mapDomExceptionToFsErrorCode, Y as mapNodeErrorCodeToFsErrorCode, Z as parseFileSystemVersion, _ as serializeFsError, $ as tryParseFileSystemVersion } from './types-Bb3yccTH.js';
 export { W as WORKSPACE_ROOT, a as WorkspacePath, p as parseWorkspacePath, t as tryParseWorkspacePath, w as workspacePathBasename, b as workspacePathContains, c as workspacePathDirname, d as workspacePathJoin, e as workspacePathToLegacy } from './workspace-path-CWVrcuPL.js';
 export { DbkWorkspaceAssetLayout, DbkWorkspaceSnapshot, DbkWorkspaceSnapshotOptions, DecodeUtf8TextOptions, FileSystemContentContainer, FileSystemEntryMoveState, FileSystemMoveLocation, FileSystemMoveRecoveryError, FileSystemPartialMoveError, FileSystemPartialMoveState, FileSystemPathPresence, LegacyFilePayloadModel, LegacyFileSystemProviderV2Adapter, LegacyFileSystemProviderV2AdapterOptions, createDbkWorkspaceSnapshot, createFileMediaProvider, decodeUtf8Text, describeEntryMove, describePartialMove, documentCompanionPath, isFileSystemMoveRecoveryError, isFileSystemMoveStateError, isFileSystemPartialMoveError, moveFileSystemEntry, replaceMemoryWorkspaceFromDbk } from './filesystem/index.js';
 export { MemoryFilePayloadKind, MemoryFileSystemProvider, MemoryFileSystemProviderV2, MemoryFileSystemSnapshot, MemoryFileSystemSnapshotFile, MemoryFileSystemV2CompatibilityFile, MemoryFileSystemV2Replacement, MemoryFileSystemV2ReplacementFile, MemoryFileSystemV2State, MemoryFileSystemV2StateFile } from './filesystem/memory.js';
@@ -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-CREx02sE.js';
 import '@bendyline/squisq/storage';
 import '@bendyline/squisq/schemas';

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   documentCompanionPath,
   moveFileSystemEntry,
   replaceMemoryWorkspaceFromDbk
-} from "./chunk-45T5AFCN.js";
+} from "./chunk-MO2VYEZQ.js";
 import {
   IndexedDBContentContainer,
   IndexedDBFileSystemProvider,
@@ -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/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, V as ValidationResult } from '../types-DkvEkg0I.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, W as InspectPptxLayoutsResult, X as LinkSummary, Y as ListFormatsResult, Z as ListRootsResult, _ as ListTemplatesResult, $ as ListThemesResult, a0 as ListTransformStylesResult, a1 as MarkdownDocumentSource, a2 as McpErrorDetail, a3 as McpSuccessResult, a4 as OutlineEntry, a5 as PptxLayoutSummary, a6 as PptxSlideSize, a7 as PreviewItem, a8 as PreviewItemKind, a9 as RecommendTemplatesResult, aa as RootGrantSummary, ab as SaveArtifactResult, ac as SavedArtifactDestination, ad as SourceRange, ae as TableSummary, af as TemplateAuthoringRole, ag as TemplateBodyPolicy, ah as TemplateContentProfile, ai as TemplateInputSummary, aj as TemplateRecommendation, ak as TemplateSummary, al as ThemeCatalogEntry, am as ThemeDescription, an as ThemeDescriptionColors, ao as ThemeSummary, ap as TransformStyleSummary, aq as ValidationSummary } from '../types-DkvEkg0I.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-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 '../workspace-path-CWVrcuPL.js';
 
 /** Quantitative limits for untrusted MCP payloads. */
@@ -25,9 +25,8 @@ declare function parseMcpDiagnostic(value: unknown): McpDiagnostic | null;
 declare function parseMcpErrorResult(value: unknown): McpErrorResult | null;
 declare function parseConversionResult(value: unknown): ConversionResult | null;
 declare function parseInspectionResult(value: unknown): InspectionResult | null;
-declare function parseValidationResult(value: unknown): ValidationResult | null;
 declare function parsePreviewResult(value: unknown): PreviewResult | null;
 declare function parseComparisonResult(value: unknown): ComparisonResult | null;
 declare function parseMaterializationOptions(value: unknown): MaterializationOptions | null;
 
-export { ArtifactRef, ComparisonResult, ConversionResult, DocumentSource, InspectionResult, MCP_WIRE_LIMITS, MaterializationOptions, McpDiagnostic, McpErrorResult, PreviewResult, ValidationResult, parseArtifactRef, parseComparisonResult, parseConversionResult, parseDocumentSource, parseInspectionResult, parseMaterializationOptions, parseMcpDiagnostic, parseMcpErrorResult, parsePreviewResult, parseValidationResult };
+export { ArtifactRef, ComparisonResult, ConversionResult, DocumentSource, InspectionResult, MCP_WIRE_LIMITS, MaterializationOptions, McpDiagnostic, McpErrorResult, PreviewResult, parseArtifactRef, parseComparisonResult, parseConversionResult, parseDocumentSource, parseInspectionResult, parseMaterializationOptions, parseMcpDiagnostic, parseMcpErrorResult, parsePreviewResult };

package/dist/mcp/index.js

@@ -10,9 +10,8 @@ import {
   parseMaterializationOptions,
   parseMcpDiagnostic,
   parseMcpErrorResult,
-  parsePreviewResult,
-  parseValidationResult
-} from "../chunk-DBJW7BZI.js";
+  parsePreviewResult
+} from "../chunk-EG3WGSZH.js";
 import "../chunk-AYWKIZLD.js";
 export {
   DOCBLOCKS_MCP_TOOL_NAMES,
@@ -26,6 +25,5 @@ export {
   parseMaterializationOptions,
   parseMcpDiagnostic,
   parseMcpErrorResult,
-  parsePreviewResult,
-  parseValidationResult
+  parsePreviewResult
 };