@bendyline/docblocks 2.7.3 → 2.7.5

package/THIRD_PARTY_NOTICES.txt

@@ -6,7 +6,7 @@ Run `npm run generate:notices` from the repository root.
 Resolved runtime and optional dependency closure declared by packages/core/package.json.
 
 Inventory source: package-lock.json.
-Components: 112.
+Components: 113.
 
 This notice is included in the published npm tarball. Transitive packages installed by npm also retain their package-local license files.
 
@@ -14,7 +14,8 @@ This notice is included in the published npm tarball. Transitive packages instal
 
 | Package | Version | License | Source |
 | --- | --- | --- | --- |
-| @bendyline/squisq | 2.12.3 | MIT | https://github.com/bendyline/squisq |
+| @bendyline/squisq | 2.13.0 | MIT | https://github.com/bendyline/squisq |
+| @bendyline/squisq-graph | 2.13.0 | 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,8 +133,8 @@ 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.12.3
-Source files: node_modules/@bendyline/squisq/LICENSE
+Components: @bendyline/squisq-graph@2.13.0, @bendyline/squisq@2.13.0
+Source files: node_modules/@bendyline/squisq-graph/LICENSE, node_modules/@bendyline/squisq/LICENSE
 ==============================================================================
 MIT License
 
@@ -158,7 +159,37 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 ==============================================================================
-Components: @bendyline/squisq@2.12.3
+Components: @bendyline/squisq-graph@2.13.0
+Source files: node_modules/@bendyline/squisq-graph/NOTICE.md
+==============================================================================
+# Third-Party Notices for @bendyline/squisq-graph
+
+This notice applies to the `@bendyline/squisq-graph` npm package.
+Squisq-authored code is licensed under the MIT license in `LICENSE`.
+Third-party components remain under their respective license terms.
+
+## Runtime dependencies
+
+| Package | Version | License | Repository |
+| ------- | ------- | ------- | ---------- |
+
+This package has no third-party runtime dependencies. The layout engine and its
+worker entry are Squisq-authored (MIT).
+
+==============================================================================
+Components: @bendyline/squisq-graph@2.13.0
+Source files: node_modules/@bendyline/squisq-graph/THIRD_PARTY_LICENSES.txt
+==============================================================================
+THIRD-PARTY LICENSES FOR @bendyline/squisq-graph
+
+Generated from the actual esbuild input graph. Package-local license, copying,
+and notice files are reproduced verbatim. When an npm tarball omits its
+repository license, the pinned upstream copy is vendored and identified below.
+
+COMPONENTS
+
+==============================================================================
+Components: @bendyline/squisq@2.13.0
 Source files: node_modules/@bendyline/squisq/NOTICE.md
 ==============================================================================
 # Third-Party Notices for @bendyline/squisq
@@ -189,7 +220,7 @@ third-party license texts for bundled code and data are shipped in
 THIRD_PARTY_LICENSES.txt.
 
 ==============================================================================
-Components: @bendyline/squisq@2.12.3
+Components: @bendyline/squisq@2.13.0
 Source files: node_modules/@bendyline/squisq/THIRD_PARTY_LICENSES.txt
 ==============================================================================
 THIRD-PARTY LICENSES FOR @bendyline/squisq

package/dist/{capabilities-r03EXSAi.d.ts → capabilities-DHwh4P4D.d.ts}

@@ -1,5 +1,5 @@
-import { F as FileCommitResult, c as FileSystemEntry, b as FileMeta } from './types-BvDnr3YU.js';
-import { D as DocBlocksHostFsV2API } from './filesystem-v2-C8AdSXUN.js';
+import { F as FileCommitResult, c as FileSystemEntry, b as FileMeta } from './types-DLteNrK0.js';
+import { D as DocBlocksHostFsV2API } from './filesystem-v2-CXdAPR27.js';
 
 /** Provider-neutral catalog management. IDs never authorize filesystem access. */
 interface AiKnowledgeCatalog {
@@ -195,6 +195,18 @@ interface AiChatMessage {
  * and flashcards, made in many small calls with explicit caps) never does.
  */
 type AiChatPurpose = 'write' | 'review' | 'illustrate' | 'study' | 'chat';
+/**
+ * Structured output: the reply should be one JSON value matching `schema`, a
+ * JSON Schema object. Hosts that can enforce it do (llama.cpp with a grammar,
+ * Apple's on-device model with guided generation); others ignore it. Callers
+ * still validate the reply.
+ */
+interface AiResponseFormat {
+    readonly type: 'json_schema';
+    /** A short identifier for the shape, such as `presentation_slide`. */
+    readonly name: string;
+    readonly schema: Readonly<Record<string, unknown>>;
+}
 interface AiChatRequest {
     readonly messages: readonly AiChatMessage[];
     /** Opaque provider model id. Omitted means "the host's current choice". */
@@ -203,6 +215,7 @@ interface AiChatRequest {
     /** Optional caller cap. Writing without one uses the host/model's available capacity. */
     readonly maxTokens?: number;
     readonly purpose: AiChatPurpose;
+    readonly responseFormat?: AiResponseFormat;
 }
 interface AiChatCompletion {
     readonly text: string;
@@ -892,6 +905,8 @@ interface HostExportTargetGrant {
 }
 /** Native export target selection and binary file writing. */
 interface DocBlocksHostExportAPI {
+    /** Open a successfully saved grant in its default app; Markdown opens in DocBlocks. */
+    openSaved?(documentId: string, grantId: string): Promise<void>;
     /** A share-sheet outcome is never a durable export target. Android can only report presentation. */
     share?(filename: string, data: ArrayBuffer | Uint8Array): Promise<'shared' | 'presented' | 'cancelled'>;
     /** Resolve an exact remembered grant or a display-only host suggestion. */
@@ -1001,6 +1016,14 @@ interface DocBlocksHostMenuAPI {
      * previously published list; send an empty array to clear the shortcuts.
      */
     setPinnedDocuments(documents: readonly HostPinnedDocument[]): void;
+    /**
+     * Whether DocBlocks keeps an icon in the macOS menu bar, the Windows
+     * notification area, or the Linux system tray. Off until the user turns it
+     * on. Absent on a host without one.
+     */
+    getTrayEnabled?(): Promise<boolean>;
+    /** Show or remove the tray icon, remembered across launches; resolves with the saved value. */
+    setTrayEnabled?(enabled: boolean): Promise<boolean>;
 }
 /**
  * OS open-file / deep-link event resolved by the host.
@@ -1188,10 +1211,13 @@ interface HostCapabilities {
     readonly exportDestinations: boolean;
     /** Remembered, re-resolvable export targets (`resolveTarget`/`pickTarget`). */
     readonly exportRememberedTargets: boolean;
+    readonly openSavedExports: boolean;
     readonly externalResources: boolean;
     readonly openRequests: boolean;
     readonly menuCommands: boolean;
     readonly pinnedDocumentMirror: boolean;
+    /** An opt-in tray / menu bar icon the user can turn on and off. */
+    readonly trayIcon: boolean;
     readonly guardedClose: boolean;
     readonly git: boolean;
     readonly updater: boolean;
@@ -1250,4 +1276,4 @@ declare function parseHostEnvironment(value: unknown): HostEnvironment | null;
  */
 declare function deriveHostCapabilities(host: unknown): HostCapabilities;
 
-export { type GitBranchInfo as $, type AiChatCompletion as A, type AiReviewMode as B, type AiSearchHit as C, type AiSearchQuery as D, type AiSearchResult as E, type AiSpeechAudio as F, type AiStatus as G, type AiSynthesizeRequest as H, type AiTranscribeRequest as I, type AiTranscript as J, type AiUnavailableReason as K, type DocBlocksHostAPI as L, type DocBlocksHostAiAPI as M, type DocBlocksHostClipboardAPI as N, type DocBlocksHostExportAPI as O, type DocBlocksHostExternalAPI as P, type DocBlocksHostFfmpegAPI as Q, type DocBlocksHostFsAPI as R, type DocBlocksHostGitAPI as S, type DocBlocksHostLifecycleAPI as T, type DocBlocksHostMenuAPI as U, type DocBlocksHostShellAPI as V, type DocBlocksHostSpeechAPI as W, type DocBlocksHostUpdaterAPI as X, type DocBlocksHostWorkspacesAPI as Y, type ElectronWorkspaceInfo as Z, type ExternalBinaryCommitResult as _, type AiChatEvent as a, type GitCapabilities as a0, type GitCloneHandle as a1, type GitCloneProgress as a2, type GitError as a3, type GitErrorCode as a4, type GitFileAtRevision as a5, type GitFileChange as a6, type GitFileStatusCode as a7, type GitLogEntry as a8, type GitLogOptions as a9, type SpeechModelKind as aA, type SpeechPreferences as aB, type SpeechPreferencesPatch as aC, type SpeechProgress as aD, type SpeechReadiness as aE, type SpeechReadinessState as aF, type SpeechResult as aG, type SpeechSegment as aH, type SpeechStatus as aI, type SpeechSynthesisHandle as aJ, type SpeechSynthesisSummary as aK, type SpeechSynthesizeEvent as aL, type SpeechSynthesizeRequest as aM, type SpeechTranscribeRequest as aN, type SpeechTranscript as aO, type SpeechVoiceInfo as aP, type SpeechWordTiming as aQ, type UpdateCheckResult as aR, type UpdateInstallResult as aS, type UpdaterStatus as aT, deriveHostCapabilities as aU, parseAiKnowledgeAction as aV, parseAiKnowledgeState as aW, parseHostEnvironment as aX, type GitRemoteInfo as aa, type GitRepoDetection as ab, type GitResult as ac, type GitRevision as ad, type GitStatus as ae, HOST_PLATFORMS as af, HOST_SURFACE_KINDS as ag, type HostCapabilities as ah, type HostCloseReason as ai, type HostEnvironment as aj, type HostExportTargetGrant as ak, type HostPinnedDocument as al, type HostPlatform as am, type HostPrepareCloseRequest as an, type HostPrepareCloseResult as ao, type HostSurfaceKind as ap, type MenuCommand as aq, NO_HOST_CAPABILITIES as ar, type OpenRequest as as, type SpeechAudioChunk as at, type SpeechCatalog as au, type SpeechError as av, type SpeechErrorCode as aw, type SpeechInstallEvent as ax, type SpeechInstallHandle as ay, type SpeechModelInfo as az, type AiChatHandle as b, type AiChatMessage as c, type AiChatProgress as d, type AiChatPurpose as e, type AiChatRequest as f, type AiConnectionStep as g, type AiEnsureWorkspaceHandle as h, type AiError as i, type AiErrorCode as j, type AiImageRequest as k, type AiImageResult as l, type AiKnowledgeAPI as m, type AiKnowledgeAction as n, type AiKnowledgeCatalog as o, type AiKnowledgeState as p, type AiModelDownloadInfo as q, type AiModelFit as r, type AiModelInfo as s, type AiModelInstallEvent as t, type AiModelInstallHandle as u, type AiPreferences as v, type AiPreferencesPatch as w, type AiProgress as x, type AiProviderInfo as y, type AiResult as z };
+export { type ExternalBinaryCommitResult as $, type AiChatCompletion as A, type AiResult as B, type AiReviewMode as C, type AiSearchHit as D, type AiSearchQuery as E, type AiSearchResult as F, type AiSpeechAudio as G, type AiStatus as H, type AiSynthesizeRequest as I, type AiTranscribeRequest as J, type AiTranscript as K, type AiUnavailableReason as L, type DocBlocksHostAPI as M, type DocBlocksHostAiAPI as N, type DocBlocksHostClipboardAPI as O, type DocBlocksHostExportAPI as P, type DocBlocksHostExternalAPI as Q, type DocBlocksHostFfmpegAPI as R, type DocBlocksHostFsAPI as S, type DocBlocksHostGitAPI as T, type DocBlocksHostLifecycleAPI as U, type DocBlocksHostMenuAPI as V, type DocBlocksHostShellAPI as W, type DocBlocksHostSpeechAPI as X, type DocBlocksHostUpdaterAPI as Y, type DocBlocksHostWorkspacesAPI as Z, type ElectronWorkspaceInfo as _, type AiChatEvent as a, type GitBranchInfo as a0, type GitCapabilities as a1, type GitCloneHandle as a2, type GitCloneProgress as a3, type GitError as a4, type GitErrorCode as a5, type GitFileAtRevision as a6, type GitFileChange as a7, type GitFileStatusCode as a8, type GitLogEntry as a9, type SpeechModelInfo as aA, type SpeechModelKind as aB, type SpeechPreferences as aC, type SpeechPreferencesPatch as aD, type SpeechProgress as aE, type SpeechReadiness as aF, type SpeechReadinessState as aG, type SpeechResult as aH, type SpeechSegment as aI, type SpeechStatus as aJ, type SpeechSynthesisHandle as aK, type SpeechSynthesisSummary as aL, type SpeechSynthesizeEvent as aM, type SpeechSynthesizeRequest as aN, type SpeechTranscribeRequest as aO, type SpeechTranscript as aP, type SpeechVoiceInfo as aQ, type SpeechWordTiming as aR, type UpdateCheckResult as aS, type UpdateInstallResult as aT, type UpdaterStatus as aU, deriveHostCapabilities as aV, parseAiKnowledgeAction as aW, parseAiKnowledgeState as aX, parseHostEnvironment as aY, type GitLogOptions as aa, type GitRemoteInfo as ab, type GitRepoDetection as ac, type GitResult as ad, type GitRevision as ae, type GitStatus as af, HOST_PLATFORMS as ag, HOST_SURFACE_KINDS as ah, type HostCapabilities as ai, type HostCloseReason as aj, type HostEnvironment as ak, type HostExportTargetGrant as al, type HostPinnedDocument as am, type HostPlatform as an, type HostPrepareCloseRequest as ao, type HostPrepareCloseResult as ap, type HostSurfaceKind as aq, type MenuCommand as ar, NO_HOST_CAPABILITIES as as, type OpenRequest as at, type SpeechAudioChunk as au, type SpeechCatalog as av, type SpeechError as aw, type SpeechErrorCode as ax, type SpeechInstallEvent as ay, type SpeechInstallHandle as az, type AiChatHandle as b, type AiChatMessage as c, type AiChatProgress as d, type AiChatPurpose as e, type AiChatRequest as f, type AiConnectionStep as g, type AiEnsureWorkspaceHandle as h, type AiError as i, type AiErrorCode as j, type AiImageRequest as k, type AiImageResult as l, type AiKnowledgeAPI as m, type AiKnowledgeAction as n, type AiKnowledgeCatalog as o, type AiKnowledgeState as p, type AiModelDownloadInfo as q, type AiModelFit as r, type AiModelInfo as s, type AiModelInstallEvent as t, type AiModelInstallHandle as u, type AiPreferences as v, type AiPreferencesPatch as w, type AiProgress as x, type AiProviderInfo as y, type AiResponseFormat as z };

package/dist/{chunk-KQ6756AJ.js → chunk-3GSMJ4MQ.js}

@@ -1,6 +1,6 @@
 import {
   workspacePathDirname
-} from "./chunk-AYWKIZLD.js";
+} from "./chunk-UTH3HYCZ.js";
 
 // src/filesystem/internal/parent-chain.ts
 function parentChain(path) {

package/dist/{chunk-YWYT6K6J.js → chunk-3LXXRIO2.js}

@@ -1,6 +1,6 @@
 import {
   tryParseWorkspacePath
-} from "./chunk-AYWKIZLD.js";
+} from "./chunk-UTH3HYCZ.js";
 
 // src/mcp/types.ts
 var DOCBLOCKS_MCP_WIRE_VERSION = 1;

package/dist/{chunk-ZTSG7AC3.js → chunk-64733GFL.js}

@@ -27,10 +27,12 @@ var NO_CAPABILITIES = Object.freeze({
   clipboard: false,
   exportDestinations: false,
   exportRememberedTargets: false,
+  openSavedExports: false,
   externalResources: false,
   openRequests: false,
   menuCommands: false,
   pinnedDocumentMirror: false,
+  trayIcon: false,
   guardedClose: false,
   git: false,
   updater: false,
@@ -103,10 +105,12 @@ function deriveHostCapabilities(host) {
     clipboard: hasMethod(host.clipboard, "writeText"),
     exportDestinations: hasMethod(exports, "save"),
     exportRememberedTargets: hasMethod(exports, "resolveTarget") && hasMethod(exports, "pickTarget"),
+    openSavedExports: hasMethod(exports, "openSaved"),
     externalResources: hasMethod(host.external, "readText"),
     openRequests: hasMethod(host, "onOpenRequest"),
     menuCommands: hasMethod(host, "onMenuCommand"),
     pinnedDocumentMirror: hasMethod(host.menu, "setPinnedDocuments"),
+    trayIcon: hasMethod(host.menu, "getTrayEnabled") && hasMethod(host.menu, "setTrayEnabled"),
     guardedClose: hasMethod(host.lifecycle, "onPrepareClose"),
     git: hasMethod(host.git, "status"),
     updater: hasMethod(host.updater, "checkForUpdates"),
@@ -141,6 +145,8 @@ var AI_WIRE_LIMITS = Object.freeze({
   completionCharacters: HOST_WIRE_LIMITS.documentCharacters,
   maxTokensCeiling: 32768,
   temperatureCeiling: 2,
+  /** A response schema describes a reply's shape; it is not another prompt. */
+  responseSchemaCharacters: 16 * 1024,
   verificationCodeCharacters: 16,
   progressPhaseCharacters: 64,
   modelEntries: 200,
@@ -363,9 +369,33 @@ function parseAiChatMessage(value) {
   if (!isBoundedString(value.content, AI_WIRE_LIMITS.promptCharacters)) return null;
   return { role: value.role, content: value.content };
 }
+var RESPONSE_FORMAT_NAME = /^[A-Za-z0-9_-]{1,64}$/u;
+function parseAiResponseFormat(value) {
+  if (!isRecord2(value)) return null;
+  if (!hasExactKeys(value, ["type", "name", "schema"])) return null;
+  if (value.type !== "json_schema") return null;
+  if (typeof value.name !== "string" || !RESPONSE_FORMAT_NAME.test(value.name)) return null;
+  if (!isRecord2(value.schema)) return null;
+  let serialized;
+  try {
+    serialized = JSON.stringify(value.schema);
+  } catch {
+    return null;
+  }
+  if (serialized.length > AI_WIRE_LIMITS.responseSchemaCharacters) return null;
+  return {
+    type: "json_schema",
+    name: value.name,
+    schema: JSON.parse(serialized)
+  };
+}
 function parseAiChatRequest(value) {
   if (!isRecord2(value)) return null;
-  if (!hasKeysWithin(value, ["messages", "purpose"], ["model", "temperature", "maxTokens"])) {
+  if (!hasKeysWithin(
+    value,
+    ["messages", "purpose"],
+    ["model", "temperature", "maxTokens", "responseFormat"]
+  )) {
     return null;
   }
   if (typeof value.purpose !== "string" || !CHAT_PURPOSES.has(value.purpose)) return null;
@@ -390,12 +420,15 @@ function parseAiChatRequest(value) {
   if (value.maxTokens !== void 0 && !isNonNegativeInteger(value.maxTokens, AI_WIRE_LIMITS.maxTokensCeiling)) {
     return null;
   }
+  const responseFormat = value.responseFormat === void 0 ? void 0 : parseAiResponseFormat(value.responseFormat);
+  if (responseFormat === null) return null;
   return {
     messages,
     purpose: value.purpose,
     ...value.model === void 0 ? {} : { model: value.model },
     ...value.temperature === void 0 ? {} : { temperature: value.temperature },
-    ...value.maxTokens === void 0 ? {} : { maxTokens: value.maxTokens }
+    ...value.maxTokens === void 0 ? {} : { maxTokens: value.maxTokens },
+    ...responseFormat === void 0 ? {} : { responseFormat }
   };
 }
 function parseAiChatProgress(value) {

package/dist/{chunk-UK7R3RC7.js → chunk-BC42VRYW.js}

@@ -1,6 +1,6 @@
 import {
   parseWorkspacePath
-} from "./chunk-AYWKIZLD.js";
+} from "./chunk-UTH3HYCZ.js";
 
 // src/workspace-settings/settings.ts
 var WORKSPACE_SETTINGS_DIRECTORY = ".docblocks";

package/dist/{chunk-DFMRE22M.js → chunk-EFGQUOTL.js}

@@ -1,7 +1,7 @@
 import {
   FILE_SYSTEM_TRANSFER_LIMITS,
   maybeGetDocBlocksHost
-} from "./chunk-ZTSG7AC3.js";
+} from "./chunk-64733GFL.js";
 import {
   parseFileSystemCapabilities
 } from "./chunk-245W57QP.js";
@@ -26,11 +26,12 @@ import {
   WORKSPACE_ROOT,
   deserializeFsError,
   fsErrorFromUnknown,
+  isFsErrorCode,
   isSerializedFsError,
   parseWorkspacePath,
   workspacePathBasename,
   workspacePathDirname
-} from "./chunk-AYWKIZLD.js";
+} from "./chunk-UTH3HYCZ.js";
 
 // src/filesystem/host-provider-v2.ts
 var fallbackInstanceSequence = 0;
@@ -419,7 +420,13 @@ function normalizeEntry(entry) {
     if (!isNonNegativeSafeInteger(entry.size)) {
       throw new TypeError("Filesystem file size must be a non-negative safe integer.");
     }
-    return Object.freeze({ ...common, kind: "file", size: entry.size });
+    const readIssue = normalizeReadIssue(entry.readIssue);
+    return Object.freeze({
+      ...common,
+      kind: "file",
+      size: entry.size,
+      ...readIssue ? { readIssue } : {}
+    });
   }
   if (entry.kind === "directory") {
     if (entry.size !== null) throw new TypeError("Filesystem directory size must be null.");
@@ -427,6 +434,13 @@ function normalizeEntry(entry) {
   }
   throw new TypeError("Unknown filesystem entry kind.");
 }
+function normalizeReadIssue(value) {
+  if (value === void 0) return void 0;
+  if (!isRecord(value) || !isFsErrorCode(value.code) || !isBoundedString(value.message, HOST_WIRE_LIMITS.messageCharacters, 1)) {
+    throw new TypeError("Filesystem entry read issue is malformed.");
+  }
+  return Object.freeze({ code: value.code, message: value.message });
+}
 function normalizeDirectoryListing(value, parent) {
   if (!Array.isArray(value)) throw new TypeError("Expected a filesystem directory listing.");
   const entries = value.map(normalizeEntry);

package/dist/{chunk-IGB2VSRE.js → chunk-FIEMYP2N.js}

@@ -3,11 +3,11 @@ import {
 } from "./chunk-XAMILHQP.js";
 import {
   decodeUtf8Text
-} from "./chunk-M5ZNQGR5.js";
+} from "./chunk-IYKGM3PV.js";
 import {
   FsError,
   parseWorkspacePath
-} from "./chunk-AYWKIZLD.js";
+} from "./chunk-UTH3HYCZ.js";
 
 // src/filesystem/move-error.ts
 function locationFromPresence(source, destination) {

package/dist/{chunk-M5ZNQGR5.js → chunk-IYKGM3PV.js}

@@ -1,6 +1,6 @@
 import {
   FsError
-} from "./chunk-AYWKIZLD.js";
+} from "./chunk-UTH3HYCZ.js";
 
 // src/filesystem/utf8.ts
 function decodeUtf8Text(data, options = {}) {

package/dist/{chunk-6UPO2GE6.js → chunk-K5HRMSXD.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-DZB666V7.js";
 import {
   parentChain
-} from "./chunk-KQ6756AJ.js";
+} from "./chunk-3GSMJ4MQ.js";
 import {
   bytesEqual,
   compareSnapshotsByName,
@@ -15,7 +15,7 @@ import {
 } from "./chunk-LPIJ6HKL.js";
 import {
   decodeUtf8Text
-} from "./chunk-M5ZNQGR5.js";
+} from "./chunk-IYKGM3PV.js";
 import {
   FsError,
   WORKSPACE_ROOT,
@@ -25,7 +25,7 @@ import {
   workspacePathContains,
   workspacePathDirname,
   workspacePathJoin
-} from "./chunk-AYWKIZLD.js";
+} from "./chunk-UTH3HYCZ.js";
 
 // src/filesystem/native-provider-v2.ts
 var NativeFileSystemMoveRecoveryError = class extends FsError {

package/dist/{chunk-UDEWLHQI.js → chunk-LDAG5NTQ.js}

@@ -1,6 +1,6 @@
 import {
   parentChainWithRoot
-} from "./chunk-KQ6756AJ.js";
+} from "./chunk-3GSMJ4MQ.js";
 import {
   compareSnapshotsByName,
   compareText,
@@ -11,7 +11,7 @@ import {
 } from "./chunk-LPIJ6HKL.js";
 import {
   decodeUtf8Text
-} from "./chunk-M5ZNQGR5.js";
+} from "./chunk-IYKGM3PV.js";
 import {
   FsError,
   WORKSPACE_ROOT,
@@ -19,7 +19,7 @@ import {
   workspacePathBasename,
   workspacePathContains,
   workspacePathDirname
-} from "./chunk-AYWKIZLD.js";
+} from "./chunk-UTH3HYCZ.js";
 
 // src/filesystem/memory-provider-v2.ts
 var MEMORY_CAPABILITIES = Object.freeze({

package/dist/{chunk-7SN7YQL4.js → chunk-LJLQYXVL.js}

@@ -1,6 +1,6 @@
 import {
   guessMimeType
-} from "./chunk-HKOOHM67.js";
+} from "./chunk-Q3OFZWJS.js";
 import {
   bytesEqual,
   compareSnapshotsByName,
@@ -17,7 +17,7 @@ import {
   createFileSystemDocumentTarget,
   describeEntryMove,
   describePartialMove
-} from "./chunk-IGB2VSRE.js";
+} from "./chunk-FIEMYP2N.js";
 import {
   getFileSystemProviderV2
 } from "./chunk-XAMILHQP.js";
@@ -31,7 +31,98 @@ import {
   workspacePathDirname,
   workspacePathJoin,
   workspacePathToLegacy
-} from "./chunk-AYWKIZLD.js";
+} from "./chunk-UTH3HYCZ.js";
+
+// src/filesystem/wiki-links.ts
+var markdownModule = null;
+function loadMarkdown() {
+  markdownModule ?? (markdownModule = import("@bendyline/squisq/markdown"));
+  return markdownModule;
+}
+async function suggestWikiArticles(files, directories, documentPath, query, extension = ".md", explicitExtensions = false) {
+  const { wikiLinkPath } = await loadMarkdown();
+  if (query.length > 2048 || query && !wikiLinkPath(`${query.trimEnd()}x`)) return [];
+  const source = parseWorkspacePath(documentPath);
+  const parent = workspacePathDirname(source);
+  const rootPrefix = parent ? `${parent}/` : "";
+  const slash = query.lastIndexOf("/");
+  const prefix = query.slice(0, slash + 1);
+  const needle = query.slice(slash + 1).toLowerCase();
+  const candidates = [];
+  const relative = (path) => {
+    if (!path.startsWith(rootPrefix)) return null;
+    const target = path.slice(rootPrefix.length);
+    if (!target.startsWith(prefix)) return null;
+    const name = target.slice(prefix.length);
+    return name && !name.includes("/") && name.toLowerCase().includes(needle) ? target : null;
+  };
+  for (const directory of directories) {
+    const target = relative(directory);
+    if (target && target.length < 2048 && wikiLinkPath(target))
+      candidates.push({
+        target: `${target}/`,
+        label: `${target.slice(prefix.length)}/`,
+        kind: "folder"
+      });
+  }
+  const articlePaths = new Set(files.map((file) => file.path));
+  for (const file of files) {
+    if (file.path === source || !/\.(?:md|html?)$/i.test(file.path)) continue;
+    const target = relative(file.path);
+    if (!target || !wikiLinkPath(target)) continue;
+    const stem = file.path.replace(/\.(?:md|html?)$/i, "");
+    const preferred = [`${stem}${extension}`, `${stem}.md`, `${stem}.html`, `${stem}.htm`].find(
+      (path) => articlePaths.has(path)
+    );
+    const insertion = !explicitExtensions && file.path === preferred ? target.replace(/\.(?:md|html?)$/i, "") : target;
+    candidates.push({ target: insertion, label: insertion.slice(prefix.length), kind: "article" });
+  }
+  return candidates.sort(
+    (a, b) => Number(b.kind === "folder") - Number(a.kind === "folder") || Number(b.label.toLowerCase().startsWith(needle)) - Number(a.label.toLowerCase().startsWith(needle)) || a.label.localeCompare(b.label) || a.target.localeCompare(b.target)
+  ).slice(0, 20);
+}
+async function resolveWikiArticlePath(documentPath, target, extension = ".md") {
+  const { wikiLinkPath } = await loadMarkdown();
+  const relative = wikiLinkPath(target, extension);
+  if (!relative) throw new FsError("invalid-path", "Invalid wiki article name.");
+  return workspacePathJoin(workspacePathDirname(parseWorkspacePath(documentPath)), relative);
+}
+async function findWikiArticle(provider, documentPath, target, extension = ".md") {
+  const { wikiLinkPath } = await loadMarkdown();
+  const preferred = await resolveWikiArticlePath(documentPath, target, extension);
+  const candidates = /\.(?:md|html?)$/i.test(target) ? [target] : [.../* @__PURE__ */ new Set([`${target}${extension}`, `${target}.md`, `${target}.html`, `${target}.htm`])];
+  for (const relativePath of candidates) {
+    const path = await resolveWikiArticlePath(documentPath, relativePath, extension);
+    if (await wikiArticleExists(provider, path)) return { path, relativePath, exists: true };
+  }
+  return { path: preferred, relativePath: wikiLinkPath(target, extension), exists: false };
+}
+async function wikiArticleExists(provider, path) {
+  const v2 = getFileSystemProviderV2(provider);
+  if (!v2) return await provider.stat(path) !== null;
+  const entry = await v2.stat(path);
+  if (entry && entry.kind !== "file")
+    throw new FsError("type-mismatch", "The article path is a folder.");
+  return entry !== null;
+}
+async function ensureWikiArticle(provider, path) {
+  if (await wikiArticleExists(provider, path)) return false;
+  const v2 = getFileSystemProviderV2(provider);
+  if (!v2) throw new FsError("not-supported", "This workspace cannot create articles safely.");
+  try {
+    await v2.writeFile(path, new Uint8Array(), {
+      mode: "create",
+      expectedVersion: null,
+      createParents: true
+    });
+    return true;
+  } catch (error) {
+    if (error instanceof FsError && (error.code === "already-exists" || error.code === "conflict")) {
+      if (await wikiArticleExists(provider, path)) return false;
+    }
+    throw error;
+  }
+}
 
 // src/filesystem/legacy-v2-adapter.ts
 var EPOCH = (/* @__PURE__ */ new Date(0)).toISOString();
@@ -1104,6 +1195,11 @@ function createFileMediaProvider(container, markdownBasename) {
 }
 
 export {
+  suggestWikiArticles,
+  resolveWikiArticlePath,
+  findWikiArticle,
+  wikiArticleExists,
+  ensureWikiArticle,
   LegacyFileSystemProviderV2Adapter,
   rewriteCompanionReferences,
   documentCompanionPath,

package/dist/{chunk-4I4AG2BH.js → chunk-P32NVUQL.js}

@@ -1,10 +1,10 @@
 import {
   HostFileSystemProviderV2
-} from "./chunk-DFMRE22M.js";
+} from "./chunk-EFGQUOTL.js";
 import {
   ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
   maybeGetDocBlocksHost
-} from "./chunk-ZTSG7AC3.js";
+} from "./chunk-64733GFL.js";
 
 // src/filesystem/electron-provider-v2.ts
 var ElectronFileSystemProviderV2 = class extends HostFileSystemProviderV2 {

package/dist/{chunk-HKOOHM67.js → chunk-Q3OFZWJS.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-DZB666V7.js";
 import {
   parentChainWithRoot
-} from "./chunk-KQ6756AJ.js";
+} from "./chunk-3GSMJ4MQ.js";
 import {
   isRecord
 } from "./chunk-73OOROXH.js";
@@ -22,7 +22,7 @@ import {
 } from "./chunk-LPIJ6HKL.js";
 import {
   decodeUtf8Text
-} from "./chunk-M5ZNQGR5.js";
+} from "./chunk-IYKGM3PV.js";
 import {
   FsError,
   WORKSPACE_ROOT,
@@ -31,7 +31,7 @@ import {
   workspacePathBasename,
   workspacePathContains,
   workspacePathDirname
-} from "./chunk-AYWKIZLD.js";
+} from "./chunk-UTH3HYCZ.js";
 
 // src/filesystem/indexeddb-provider-v2.ts
 var ENTRY_SCHEMA_VERSION = 1;

package/dist/{chunk-AYWKIZLD.js → chunk-UTH3HYCZ.js}

@@ -17,6 +17,9 @@ var FS_ERROR_CODES = /* @__PURE__ */ new Set([
   "aborted",
   "io"
 ]);
+function isFsErrorCode(value) {
+  return typeof value === "string" && FS_ERROR_CODES.has(value);
+}
 var FS_OPERATIONS = /* @__PURE__ */ new Set([
   "parse-path",
   "read",
@@ -109,7 +112,7 @@ function mapNodeErrorCodeToFsErrorCode(code) {
 function isSerializedFsError(value) {
   if (!value || typeof value !== "object") return false;
   const candidate = value;
-  return candidate.name === "FsError" && typeof candidate.code === "string" && FS_ERROR_CODES.has(candidate.code) && typeof candidate.message === "string" && (candidate.operation === null || typeof candidate.operation === "string" && FS_OPERATIONS.has(candidate.operation)) && (candidate.path === null || typeof candidate.path === "string") && (candidate.destinationPath === null || typeof candidate.destinationPath === "string") && typeof candidate.retryable === "boolean";
+  return candidate.name === "FsError" && isFsErrorCode(candidate.code) && typeof candidate.message === "string" && (candidate.operation === null || typeof candidate.operation === "string" && FS_OPERATIONS.has(candidate.operation)) && (candidate.path === null || typeof candidate.path === "string") && (candidate.destinationPath === null || typeof candidate.destinationPath === "string") && typeof candidate.retryable === "boolean";
 }
 function deserializeFsError(value) {
   return new FsError(value.code, value.message, {
@@ -205,6 +208,7 @@ function invalidPath(path, message) {
 }
 
 export {
+  isFsErrorCode,
   FsError,
   mapDomExceptionToFsErrorCode,
   mapNodeErrorCodeToFsErrorCode,