@bendyline/docblocks 2.0.0 → 2.1.0

package/dist/{chunk-GCPBEMMH.js → chunk-VTCSF7VS.js}

@@ -1,10 +1,16 @@
 import {
   ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
   maybeGetDocBlocksHost
-} from "./chunk-RVQHY3XU.js";
+} from "./chunk-BNKV7MTO.js";
 import {
+  isRecord
+} from "./chunk-U722UUFN.js";
+import {
+  compareSnapshotsByPath,
+  compareText,
+  copyBytes,
   parseFileSystemVersion
-} from "./chunk-AYZ4HN5M.js";
+} from "./chunk-P4WATND4.js";
 import {
   FsError,
   WORKSPACE_ROOT,
@@ -14,7 +20,7 @@ import {
   parseWorkspacePath,
   workspacePathBasename,
   workspacePathDirname
-} from "./chunk-SI2LU2RP.js";
+} from "./chunk-JS6XFWQK.js";
 
 // src/filesystem/electron-provider-v2.ts
 var fallbackInstanceSequence = 0;
@@ -327,7 +333,7 @@ function normalizeDirectoryListing(value, parent) {
     if (seen.has(entry.path)) throw new TypeError("Filesystem listing contained a duplicate path.");
     seen.add(entry.path);
   }
-  const ordered = [...entries].sort(compareDirectoryEntries);
+  const ordered = [...entries].sort(compareSnapshotsByPath);
   if (ordered.some((entry, index) => entry.path !== entries[index]?.path)) {
     throw new TypeError("Filesystem listing was not in canonical deterministic order.");
   }
@@ -439,13 +445,6 @@ function assertCapabilities(value, operation) {
     }
   }
 }
-function compareDirectoryEntries(left, right) {
-  if (left.kind !== right.kind) return left.kind === "directory" ? -1 : 1;
-  return compareText(left.path, right.path);
-}
-function compareText(left, right) {
-  return left < right ? -1 : left > right ? 1 : 0;
-}
 function isWatchOrigin(value) {
   return value === "local" || value === "external" || value === "unknown";
 }
@@ -458,9 +457,6 @@ function isNonNegativeSafeInteger(value) {
 function isPositiveSafeInteger(value) {
   return isNonNegativeSafeInteger(value) && value > 0;
 }
-function isRecord(value) {
-  return typeof value === "object" && value !== null;
-}
 function invalidTransport(operation, message) {
   return new FsError("io", message, { operation, retryable: false });
 }
@@ -477,12 +473,6 @@ function withOperation(error, operation) {
     retryable: error.retryable
   });
 }
-function copyBytes(data) {
-  const source = ArrayBuffer.isView(data) ? new Uint8Array(data.buffer, data.byteOffset, data.byteLength) : new Uint8Array(data);
-  const copy = new Uint8Array(source.byteLength);
-  copy.set(source);
-  return copy.buffer;
-}
 function copyWireBuffer(data) {
   if (Object.prototype.toString.call(data) !== "[object ArrayBuffer]") {
     throw new TypeError("Expected an ArrayBuffer from the filesystem transport.");
@@ -560,4 +550,4 @@ export {
   ElectronFileSystemProviderV2,
   ElectronFileSystemProvider
 };
-//# sourceMappingURL=chunk-GCPBEMMH.js.map
+//# sourceMappingURL=chunk-VTCSF7VS.js.map

package/dist/chunk-VTCSF7VS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/filesystem/electron-provider-v2.ts","../src/filesystem/electron-provider.ts"],"sourcesContent":["import {\n  ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,\n  maybeGetDocBlocksHost,\n  type DocBlocksHostFsV2API,\n  type HostFileSystemV2Result,\n  type HostFileSystemV2WatchMessage,\n} from '../host/index.js';\nimport {\n  FsError,\n  deserializeFsError,\n  fsErrorFromUnknown,\n  isSerializedFsError,\n  type FsOperation,\n} from './fs-error.js';\nimport {\n  WORKSPACE_ROOT,\n  parseWorkspacePath,\n  workspacePathBasename,\n  workspacePathDirname,\n  type WorkspacePath,\n} from './workspace-path.js';\nimport { copyBytes } from './internal/bytes.js';\nimport { compareSnapshotsByPath, compareText } from './internal/entry-order.js';\nimport { isRecord } from './internal/records.js';\nimport {\n  parseFileSystemVersion,\n  type FileSystemCreateDirectoryOptions,\n  type FileSystemDirectorySnapshot,\n  type FileSystemEntrySnapshot,\n  type FileSystemFileRead,\n  type FileSystemFileSnapshot,\n  type FileSystemMoveOptions,\n  type FileSystemProviderCapabilities,\n  type FileSystemProviderV2,\n  type FileSystemRemoveOptions,\n  type FileSystemRemoveResult,\n  type FileSystemSnapshot,\n  type FileSystemSnapshotEntry,\n  type FileSystemWatchEvent,\n  type FileSystemWatchOptions,\n  type FileSystemWatchSubscription,\n  type FileSystemWriteOptions,\n} from './v2.js';\n\ninterface ClientWatcher {\n  readonly listener: (event: FileSystemWatchEvent) => void;\n  readonly onError: FileSystemWatchOptions['onError'];\n}\n\nlet fallbackInstanceSequence = 0;\n\nfunction getHostFsV2(operation: FsOperation): DocBlocksHostFsV2API {\n  const host = maybeGetDocBlocksHost();\n  if (!host?.fsV2) {\n    throw new FsError('not-supported', 'Electron filesystem v2 host is unavailable.', {\n      operation,\n    });\n  }\n  return host.fsV2;\n}\n\n/** Pure renderer-side client for the typed Electron filesystem v2 transport. */\nexport class ElectronFileSystemProviderV2 implements FileSystemProviderV2 {\n  public readonly id: string;\n  public readonly label: string;\n  public readonly capabilities = ELECTRON_FILE_SYSTEM_V2_CAPABILITIES;\n\n  private readonly rootPath: string;\n  private readonly instanceId = createInstanceId();\n  private readonly watchers = new Map<string, ClientWatcher>();\n  private readonly subscriptions = new Set<FileSystemWatchSubscription>();\n  private readonly inFlight = new Set<Promise<unknown>>();\n  private openPromise: Promise<void> | null = null;\n  private removeWatchBridge: (() => void) | null = null;\n  private disposePromise: Promise<void> | null = null;\n  private hostOpened = false;\n  private disposed = false;\n\n  public constructor(id: string, label: string, rootPath: string) {\n    this.id = id;\n    this.label = label;\n    this.rootPath = rootPath;\n  }\n\n  public getRootPath(): string {\n    return this.rootPath;\n  }\n\n  public async stat(path: WorkspacePath): Promise<FileSystemEntrySnapshot | null> {\n    const canonical = parseWorkspacePath(String(path));\n    return this.request(\n      'stat',\n      () => getHostFsV2('stat').stat(this.instanceId, canonical),\n      (value) => (value ? normalizeEntry(value) : null),\n    );\n  }\n\n  public async readFile(path: WorkspacePath): Promise<FileSystemFileRead | null> {\n    const canonical = parseWorkspacePath(String(path));\n    return this.request(\n      'read',\n      () => getHostFsV2('read').readFile(this.instanceId, canonical),\n      (value) => {\n        if (!value) return null;\n        const entry = normalizeFile(value.entry);\n        const data = copyWireBuffer(value.data);\n        if (data.byteLength !== entry.size) {\n          throw new TypeError('Filesystem transport returned file bytes with the wrong size.');\n        }\n        return Object.freeze({ entry, data });\n      },\n    );\n  }\n\n  public async readDirectory(path: WorkspacePath): Promise<readonly FileSystemEntrySnapshot[]> {\n    const canonical = parseWorkspacePath(String(path));\n    return this.request(\n      'list',\n      () => getHostFsV2('list').readDirectory(this.instanceId, canonical),\n      (value) => normalizeDirectoryListing(value, canonical),\n    );\n  }\n\n  public async writeFile(\n    path: WorkspacePath,\n    data: ArrayBuffer | Uint8Array,\n    options?: FileSystemWriteOptions,\n  ): Promise<FileSystemFileSnapshot> {\n    const canonical = parseWorkspacePath(String(path));\n    const owned = copyBytes(data);\n    return this.request(\n      'write',\n      () => getHostFsV2('write').writeFile(this.instanceId, canonical, owned, options),\n      normalizeFile,\n    );\n  }\n\n  public async createDirectory(\n    path: WorkspacePath,\n    options?: FileSystemCreateDirectoryOptions,\n  ): Promise<FileSystemDirectorySnapshot> {\n    const canonical = parseWorkspacePath(String(path));\n    return this.request(\n      'create-directory',\n      () => getHostFsV2('create-directory').createDirectory(this.instanceId, canonical, options),\n      normalizeDirectory,\n    );\n  }\n\n  public async remove(\n    path: WorkspacePath,\n    options?: FileSystemRemoveOptions,\n  ): Promise<FileSystemRemoveResult> {\n    const canonical = parseWorkspacePath(String(path));\n    return this.request(\n      'remove',\n      () => getHostFsV2('remove').remove(this.instanceId, canonical, options),\n      normalizeRemoveResult,\n    );\n  }\n\n  public async move(\n    oldPath: WorkspacePath,\n    newPath: WorkspacePath,\n    options?: FileSystemMoveOptions,\n  ): Promise<FileSystemEntrySnapshot> {\n    const source = parseWorkspacePath(String(oldPath));\n    const destination = parseWorkspacePath(String(newPath));\n    return this.request(\n      'move',\n      () => getHostFsV2('move').move(this.instanceId, source, destination, options),\n      normalizeEntry,\n    );\n  }\n\n  public async snapshot(): Promise<FileSystemSnapshot> {\n    return this.request(\n      'snapshot',\n      () => getHostFsV2('snapshot').snapshot(this.instanceId),\n      normalizeSnapshot,\n    );\n  }\n\n  public watch(\n    listener: (event: FileSystemWatchEvent) => void,\n    options: FileSystemWatchOptions = {},\n  ): FileSystemWatchSubscription {\n    this.assertOpen('watch');\n    this.ensureWatchBridge();\n    const subscriptionId = createInstanceId();\n    const watcher: ClientWatcher = { listener, onError: options.onError };\n    this.watchers.set(subscriptionId, watcher);\n    let closed = false;\n    let subscribed = false;\n    let closePromise: Promise<void> | null = null;\n    const ready = this.ensureOpen('watch')\n      .then(async () => {\n        if (closed) return;\n        unwrap(await getHostFsV2('watch').watchSubscribe(this.instanceId, subscriptionId), 'watch');\n        subscribed = true;\n      })\n      .catch((error: unknown) => {\n        closed = true;\n        this.watchers.delete(subscriptionId);\n        const typed = error instanceof FsError ? error : new FsError('io', String(error));\n        try {\n          watcher.onError?.(typed);\n        } catch {\n          // Isolate observers.\n        }\n        throw typed;\n      });\n\n    const subscription: FileSystemWatchSubscription = {\n      get closed() {\n        return closed;\n      },\n      ready,\n      dispose: () => {\n        if (closePromise) return closePromise;\n        closed = true;\n        this.watchers.delete(subscriptionId);\n        this.subscriptions.delete(subscription);\n        closePromise = (async () => {\n          await ready.catch(() => undefined);\n          if (subscribed) {\n            unwrap(\n              await getHostFsV2('watch').watchUnsubscribe(this.instanceId, subscriptionId),\n              'watch',\n            );\n          }\n        })();\n        return closePromise;\n      },\n    };\n    this.subscriptions.add(subscription);\n    return subscription;\n  }\n\n  public dispose(): Promise<void> {\n    if (this.disposePromise) return this.disposePromise;\n    this.disposed = true;\n    this.disposePromise = (async () => {\n      await Promise.allSettled([...this.inFlight]);\n      await Promise.all([...this.subscriptions].map((subscription) => subscription.dispose()));\n      try {\n        if (this.openPromise) {\n          try {\n            await this.openPromise;\n          } catch {\n            // A failed request normally creates no host record. `hostOpened`\n            // separately tracks a successful open whose response validation\n            // failed after the main-side record had already been published.\n          }\n        }\n        if (this.hostOpened) {\n          try {\n            unwrap(await getHostFsV2('dispose').dispose(this.instanceId), 'dispose');\n          } catch (error: unknown) {\n            if (!(error instanceof FsError && error.code === 'closed')) throw error;\n          } finally {\n            this.hostOpened = false;\n          }\n        }\n      } finally {\n        this.removeWatchBridge?.();\n        this.removeWatchBridge = null;\n      }\n    })();\n    return this.disposePromise;\n  }\n\n  private request<T, U>(\n    operation: FsOperation,\n    send: () => Promise<HostFileSystemV2Result<T>>,\n    normalize: (value: T) => U,\n  ): Promise<U> {\n    this.assertOpen(operation);\n    const promise = this.ensureOpen(operation).then(async () => {\n      try {\n        return normalize(unwrap(await send(), operation));\n      } catch (error: unknown) {\n        throw transportErrorFromUnknown(error, operation);\n      }\n    });\n    this.inFlight.add(promise);\n    void promise.then(\n      () => this.inFlight.delete(promise),\n      () => this.inFlight.delete(promise),\n    );\n    return promise;\n  }\n\n  private ensureOpen(operation: FsOperation): Promise<void> {\n    this.assertOpen(operation);\n    if (!this.openPromise) {\n      const attempt = getHostFsV2(operation)\n        .open({\n          instanceId: this.instanceId,\n          providerId: this.id,\n          label: this.label,\n        })\n        .then((result) => {\n          if (isRecord(result) && result.ok === true) this.hostOpened = true;\n          const capabilities = unwrap(result, operation);\n          assertCapabilities(capabilities, operation);\n        })\n        .catch((error: unknown) => {\n          const typed = withOperation(fsErrorFromUnknown(error, { operation }), operation);\n          if (typed.retryable && this.openPromise === attempt) this.openPromise = null;\n          throw typed;\n        });\n      this.openPromise = attempt;\n    }\n    return this.openPromise;\n  }\n\n  private ensureWatchBridge(): void {\n    if (this.removeWatchBridge) return;\n    this.removeWatchBridge = getHostFsV2('watch').onWatchMessage((message) =>\n      this.handleWatchMessage(message),\n    );\n  }\n\n  private handleWatchMessage(message: HostFileSystemV2WatchMessage): void {\n    if (message.instanceId !== this.instanceId) return;\n    const watcher = this.watchers.get(message.subscriptionId);\n    if (!watcher) return;\n    if (message.kind === 'error') {\n      const typed = isSerializedFsError(message.error)\n        ? deserializeFsError(message.error)\n        : invalidTransport('watch', 'Filesystem transport returned an invalid watch error.');\n      try {\n        watcher.onError?.(typed);\n      } catch {\n        // Isolate observers.\n      }\n      return;\n    }\n\n    let event: FileSystemWatchEvent;\n    try {\n      event = normalizeWatchEvent(message.event);\n    } catch (error: unknown) {\n      try {\n        watcher.onError?.(transportErrorFromUnknown(error, 'watch'));\n      } catch {\n        // Isolate observers.\n      }\n      return;\n    }\n    try {\n      watcher.listener(event);\n    } catch {\n      // Watch callbacks are observational.\n    }\n  }\n\n  private assertOpen(operation: FsOperation): void {\n    if (!this.disposed) return;\n    throw new FsError('disposed', 'Filesystem provider is disposed.', { operation });\n  }\n}\n\nfunction unwrap<T>(result: HostFileSystemV2Result<T>, operation: FsOperation): T {\n  if (!isRecord(result) || typeof result.ok !== 'boolean') {\n    throw invalidTransport(operation, 'Filesystem transport returned an invalid result envelope.');\n  }\n  if (result.ok) {\n    if (!('value' in result)) {\n      throw invalidTransport(operation, 'Filesystem transport omitted a result value.');\n    }\n    return result.value;\n  }\n  if (!isSerializedFsError(result.error)) {\n    throw invalidTransport(operation, 'Filesystem transport returned an invalid error envelope.');\n  }\n  throw deserializeFsError(result.error);\n}\n\nfunction normalizeEntry(entry: FileSystemEntrySnapshot): FileSystemEntrySnapshot {\n  if (!isRecord(entry)) throw new TypeError('Expected a filesystem entry object.');\n  if (typeof entry.path !== 'string')\n    throw new TypeError('Filesystem entry path must be a string.');\n  if (typeof entry.name !== 'string')\n    throw new TypeError('Filesystem entry name must be a string.');\n  if (typeof entry.lastModified !== 'string') {\n    throw new TypeError('Filesystem entry timestamp must be a string.');\n  }\n  const path = parseWorkspacePath(entry.path);\n  if (entry.name !== workspacePathBasename(path)) {\n    throw new TypeError('Filesystem entry name does not match its canonical path.');\n  }\n  const common = {\n    path,\n    name: entry.name,\n    version: parseFileSystemVersion(entry.version),\n    lastModified: new Date(entry.lastModified).toISOString(),\n  };\n  if (entry.kind === 'file') {\n    if (!isNonNegativeSafeInteger(entry.size)) {\n      throw new TypeError('Filesystem file size must be a non-negative safe integer.');\n    }\n    return Object.freeze({ ...common, kind: 'file', size: entry.size });\n  }\n  if (entry.kind === 'directory') {\n    if (entry.size !== null) throw new TypeError('Filesystem directory size must be null.');\n    return Object.freeze({ ...common, kind: 'directory', size: null });\n  }\n  throw new TypeError('Unknown filesystem entry kind.');\n}\n\nfunction normalizeDirectoryListing(\n  value: readonly FileSystemEntrySnapshot[],\n  parent: WorkspacePath,\n): readonly FileSystemEntrySnapshot[] {\n  if (!Array.isArray(value)) throw new TypeError('Expected a filesystem directory listing.');\n  const entries = value.map(normalizeEntry);\n  const seen = new Set<WorkspacePath>();\n  for (const entry of entries) {\n    if (entry.path === WORKSPACE_ROOT || workspacePathDirname(entry.path) !== parent) {\n      throw new TypeError('Filesystem listing contained a non-child entry.');\n    }\n    if (seen.has(entry.path)) throw new TypeError('Filesystem listing contained a duplicate path.');\n    seen.add(entry.path);\n  }\n  const ordered = [...entries].sort(compareSnapshotsByPath);\n  if (ordered.some((entry, index) => entry.path !== entries[index]?.path)) {\n    throw new TypeError('Filesystem listing was not in canonical deterministic order.');\n  }\n  return Object.freeze(entries);\n}\n\nfunction normalizeFile(entry: FileSystemFileSnapshot): FileSystemFileSnapshot {\n  const normalized = normalizeEntry(entry);\n  if (normalized.kind !== 'file') throw new TypeError('Expected a file snapshot.');\n  return normalized;\n}\n\nfunction normalizeDirectory(entry: FileSystemDirectorySnapshot): FileSystemDirectorySnapshot {\n  const normalized = normalizeEntry(entry);\n  if (normalized.kind !== 'directory') throw new TypeError('Expected a directory snapshot.');\n  return normalized;\n}\n\nfunction normalizeSnapshot(snapshot: FileSystemSnapshot): FileSystemSnapshot {\n  if (!isRecord(snapshot) || !Array.isArray(snapshot.entries)) {\n    throw new TypeError('Expected a filesystem snapshot object.');\n  }\n  const version = parseFileSystemVersion(snapshot.version);\n  const entries: FileSystemSnapshotEntry[] = snapshot.entries.map((entry) => {\n    if (entry.kind === 'file') {\n      const file = normalizeFile(entry);\n      const data = copyWireBuffer(entry.data);\n      if (data.byteLength !== file.size) {\n        throw new TypeError('Filesystem snapshot file bytes have the wrong size.');\n      }\n      return Object.freeze({ ...file, data });\n    }\n    if (entry.kind === 'directory') return normalizeDirectory(entry);\n    throw new TypeError('Unknown filesystem snapshot entry kind.');\n  });\n  const roots = entries.filter((entry) => entry.path === WORKSPACE_ROOT);\n  if (roots.length !== 1 || roots[0]?.kind !== 'directory' || roots[0].version !== version) {\n    throw new TypeError('Filesystem snapshot must contain one matching root directory.');\n  }\n  const seen = new Set<WorkspacePath>();\n  for (const entry of entries) {\n    if (seen.has(entry.path))\n      throw new TypeError('Filesystem snapshot contained a duplicate path.');\n    seen.add(entry.path);\n  }\n  const ordered = [...entries].sort((left, right) => compareText(left.path, right.path));\n  if (ordered.some((entry, index) => entry.path !== entries[index]?.path)) {\n    throw new TypeError('Filesystem snapshot was not in canonical deterministic order.');\n  }\n  return Object.freeze({\n    version,\n    entries: Object.freeze(entries),\n  });\n}\n\nfunction normalizeWatchEvent(event: FileSystemWatchEvent): FileSystemWatchEvent {\n  if (!isRecord(event)) throw new TypeError('Expected a filesystem watch event object.');\n  if (!isPositiveSafeInteger(event.sequence)) {\n    throw new TypeError('Filesystem watch sequence must be a positive safe integer.');\n  }\n  if (!isWatchOrigin(event.origin)) throw new TypeError('Unknown filesystem watch origin.');\n  if (typeof event.path !== 'string') throw new TypeError('Watch event path must be a string.');\n  const path = parseWorkspacePath(event.path);\n  if (event.type === 'overflow') {\n    if (\n      event.kind !== null ||\n      event.destinationPath !== null ||\n      event.version !== null ||\n      event.previousVersion !== null\n    ) {\n      throw new TypeError('Filesystem overflow event has entry-specific fields.');\n    }\n    return Object.freeze({\n      sequence: event.sequence,\n      origin: event.origin,\n      type: 'overflow',\n      kind: null,\n      path,\n      destinationPath: null,\n      version: null,\n      previousVersion: null,\n    });\n  }\n  if (!isEntryWatchType(event.type)) throw new TypeError('Unknown filesystem watch event type.');\n  if (event.kind !== 'file' && event.kind !== 'directory') {\n    throw new TypeError('Unknown filesystem watch entry kind.');\n  }\n  const destinationPath =\n    event.destinationPath === null\n      ? null\n      : typeof event.destinationPath === 'string'\n        ? parseWorkspacePath(event.destinationPath)\n        : (() => {\n            throw new TypeError('Watch destination path must be a string or null.');\n          })();\n  if ((event.type === 'moved') !== (destinationPath !== null)) {\n    throw new TypeError('Only moved watch events may have a destination path.');\n  }\n  return Object.freeze({\n    sequence: event.sequence,\n    origin: event.origin,\n    type: event.type,\n    kind: event.kind,\n    path,\n    destinationPath,\n    version: event.version === null ? null : parseFileSystemVersion(event.version),\n    previousVersion:\n      event.previousVersion === null ? null : parseFileSystemVersion(event.previousVersion),\n  });\n}\n\nfunction normalizeRemoveResult(value: FileSystemRemoveResult): FileSystemRemoveResult {\n  if (!isRecord(value) || typeof value.removed !== 'boolean') {\n    throw new TypeError('Filesystem transport returned an invalid remove result.');\n  }\n  return Object.freeze({ removed: value.removed, version: parseFileSystemVersion(value.version) });\n}\n\nfunction assertCapabilities(value: FileSystemProviderCapabilities, operation: FsOperation): void {\n  if (!isRecord(value)) {\n    throw invalidTransport(operation, 'Filesystem host returned invalid capabilities.');\n  }\n  for (const key of Object.keys(ELECTRON_FILE_SYSTEM_V2_CAPABILITIES) as Array<\n    keyof FileSystemProviderCapabilities\n  >) {\n    if (value[key] !== ELECTRON_FILE_SYSTEM_V2_CAPABILITIES[key]) {\n      throw invalidTransport(operation, `Filesystem host capability mismatch: ${key}.`);\n    }\n  }\n}\n\nfunction isWatchOrigin(value: unknown): value is FileSystemWatchEvent['origin'] {\n  return value === 'local' || value === 'external' || value === 'unknown';\n}\n\nfunction isEntryWatchType(\n  value: unknown,\n): value is Exclude<FileSystemWatchEvent['type'], 'overflow'> {\n  return value === 'created' || value === 'modified' || value === 'removed' || value === 'moved';\n}\n\nfunction isNonNegativeSafeInteger(value: unknown): value is number {\n  return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;\n}\n\nfunction isPositiveSafeInteger(value: unknown): value is number {\n  return isNonNegativeSafeInteger(value) && value > 0;\n}\n\nfunction invalidTransport(operation: FsOperation, message: string): FsError {\n  return new FsError('io', message, { operation, retryable: false });\n}\n\nfunction transportErrorFromUnknown(error: unknown, operation: FsOperation): FsError {\n  if (error instanceof TypeError) return invalidTransport(operation, error.message);\n  return withOperation(fsErrorFromUnknown(error, { operation }), operation);\n}\n\nfunction withOperation(error: FsError, operation: FsOperation): FsError {\n  if (error.operation === operation) return error;\n  return new FsError(error.code, error.message, {\n    operation,\n    path: error.path ?? undefined,\n    destinationPath: error.destinationPath ?? undefined,\n    retryable: error.retryable,\n  });\n}\n\nfunction copyWireBuffer(data: ArrayBuffer): ArrayBuffer {\n  if (Object.prototype.toString.call(data) !== '[object ArrayBuffer]') {\n    throw new TypeError('Expected an ArrayBuffer from the filesystem transport.');\n  }\n  return data.slice(0);\n}\n\nfunction createInstanceId(): string {\n  const randomUUID = globalThis.crypto?.randomUUID;\n  if (typeof randomUUID === 'function') return randomUUID.call(globalThis.crypto);\n  fallbackInstanceSequence += 1;\n  return `electron-fs-v2-${Date.now()}-${fallbackInstanceSequence}`;\n}\n","/**\n * ElectronFileSystemProvider — implements FileSystemProvider by delegating\n * to the Electron desktop host's fs IPC bridge. Every operation is scoped\n * to an opaque workspace id that the main process resolves against its\n * registered workspace authority.\n *\n * This file has no Electron dependency — it is a pure IPC client that\n * relies on the `docBlocksHost` global installed by the preload script.\n */\n\nimport type { FileCommitResult, FileSystemProvider, FileSystemEntry, FileMeta } from './types.js';\nimport { maybeGetDocBlocksHost } from '../host/index.js';\nimport type { DocBlocksHostFsAPI } from '../host/types.js';\nimport { ElectronFileSystemProviderV2 } from './electron-provider-v2.js';\n\nexport { isElectronHost } from '../host/index.js';\n\nfunction getHostFs(): DocBlocksHostFsAPI {\n  const host = maybeGetDocBlocksHost();\n  if (!host) {\n    throw new Error(\n      'ElectronFileSystemProvider: docBlocksHost is not available — not running under Electron?',\n    );\n  }\n  return host.fs;\n}\n\nexport class ElectronFileSystemProvider implements FileSystemProvider {\n  readonly id: string;\n  readonly label: string;\n  readonly v2: ElectronFileSystemProviderV2;\n\n  private readonly rootPath: string;\n\n  constructor(id: string, label: string, rootPath: string) {\n    this.id = id;\n    this.label = label;\n    this.rootPath = rootPath;\n    this.v2 = new ElectronFileSystemProviderV2(id, label, rootPath);\n  }\n\n  /** Absolute path this provider is rooted at. */\n  getRootPath(): string {\n    return this.rootPath;\n  }\n\n  readFile(path: string): Promise<string | null> {\n    return getHostFs().readFile(this.id, path);\n  }\n\n  writeFile(path: string, content: string): Promise<void> {\n    return getHostFs().writeFile(this.id, path, content);\n  }\n\n  commitFile(\n    path: string,\n    content: string,\n    expectedContent: string | null,\n  ): Promise<FileCommitResult> {\n    return getHostFs().commitFile(this.id, path, content, expectedContent);\n  }\n\n  delete(path: string): Promise<void> {\n    return getHostFs().delete(this.id, path);\n  }\n\n  rename(oldPath: string, newPath: string): Promise<void> {\n    return getHostFs().rename(this.id, oldPath, newPath);\n  }\n\n  readDirectory(path: string): Promise<FileSystemEntry[]> {\n    return getHostFs().readDirectory(this.id, path);\n  }\n\n  exists(path: string): Promise<boolean> {\n    return getHostFs().exists(this.id, path);\n  }\n\n  createDirectory(path: string): Promise<void> {\n    return getHostFs().createDirectory(this.id, path);\n  }\n\n  stat(path: string): Promise<FileMeta | null> {\n    return getHostFs().stat(this.id, path);\n  }\n\n  readBinary(path: string): Promise<ArrayBuffer | null> {\n    return getHostFs().readBinary(this.id, path);\n  }\n\n  writeBinary(path: string, data: ArrayBuffer | Uint8Array): Promise<void> {\n    return getHostFs().writeBinary(this.id, path, data);\n  }\n\n  /** Subscribe to external change notifications under this root. */\n  watch(onChange: (changedPath: string) => void): () => void {\n    return getHostFs().watch(this.id, onChange);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-2D7Y4IR3.js → chunk-WJKYY5QR.js}

@@ -2,8 +2,18 @@ import {
   withFileCommitLock
 } from "./chunk-AEHCVWU5.js";
 import {
+  parentChain
+} from "./chunk-GM5YXU4L.js";
+import {
+  bytesEqual,
+  compareSnapshotsByName,
+  compareText,
+  copyBytes,
   parseFileSystemVersion
-} from "./chunk-AYZ4HN5M.js";
+} from "./chunk-P4WATND4.js";
+import {
+  decodeUtf8Text
+} from "./chunk-FA7UNOXK.js";
 import {
   FsError,
   WORKSPACE_ROOT,
@@ -13,7 +23,7 @@ import {
   workspacePathContains,
   workspacePathDirname,
   workspacePathJoin
-} from "./chunk-SI2LU2RP.js";
+} from "./chunk-JS6XFWQK.js";
 
 // src/filesystem/native-provider-v2.ts
 var NativeFileSystemMoveRecoveryError = class extends FsError {
@@ -102,7 +112,7 @@ var NativeFileSystemProviderV2 = class {
           withoutData((await this.scanMetadataHandle(childPath, childHandle, "list")).root)
         );
       }
-      children.sort(compareSnapshots);
+      children.sort(compareSnapshotsByName);
       return Object.freeze(children);
     });
   }
@@ -141,7 +151,7 @@ var NativeFileSystemProviderV2 = class {
         await this.writeBytes(canonical, ownedData);
         writeCompleted = true;
         const written = await this.requireSnapshot(canonical, "write");
-        if (written.root.kind !== "file" || !equalBytes(written.root.data, ownedData)) {
+        if (written.root.kind !== "file" || !bytesEqual(written.root.data, ownedData)) {
           throw this.error(
             "conflict",
             "write",
@@ -282,7 +292,7 @@ var NativeFileSystemProviderV2 = class {
       }
       const createdParents = await this.createDirectories(missingParents);
       let destinationVersion = null;
-      let sourceDeleted = false;
+      let sourceDeleteAttempted = false;
       try {
         await this.writeTree(source, sourcePath, destinationPath);
         const copied = await this.requireSnapshot(destinationPath, "move");
@@ -302,8 +312,15 @@ var NativeFileSystemProviderV2 = class {
             destinationPath
           });
         }
+        if (!await this.matchesCapturedSource(sourcePath, source)) {
+          throw new FsError("conflict", "Source changed while the move was copied.", {
+            operation: "move",
+            path: sourcePath,
+            destinationPath
+          });
+        }
+        sourceDeleteAttempted = true;
         await this.removeEntry(sourcePath, source.root.kind === "directory");
-        sourceDeleted = true;
         const [sourceAfter, destinationAfter] = await Promise.all([
           this.tryScanMetadata(sourcePath, "move"),
           this.tryScanMetadata(destinationPath, "move")
@@ -323,7 +340,7 @@ var NativeFileSystemProviderV2 = class {
           source,
           createdParents,
           destinationVersion,
-          sourceDeleted,
+          sourceDeleteAttempted,
           error
         );
       }
@@ -513,7 +530,7 @@ var NativeFileSystemProviderV2 = class {
         await this.scanHandle(workspacePathJoin(path, name), childHandle, operation, scanFile)
       );
     }
-    const childRoots = children.map((child) => child.root).sort(compareSnapshots);
+    const childRoots = children.map((child) => child.root).sort(compareSnapshotsByName);
     const version = await metadataVersion(
       "directory",
       new TextEncoder().encode(
@@ -574,6 +591,25 @@ var NativeFileSystemProviderV2 = class {
       kind: "file",
       path,
       name: workspacePathBasename(path),
+      // Derived from size + mtime, never from content. This keeps stat/list
+      // proportional to entry count instead of bytes (see scanMetadataHandle),
+      // which is what makes large workspaces listable in a browser tab at all.
+      //
+      // The cost is a real blind spot: an external same-size rewrite inside one
+      // mtime tick is invisible here. FAT/exFAT stamp mtime at 2-second
+      // granularity, and network shares can be coarser, so this is reachable on
+      // removable and mounted volumes rather than merely theoretical. Two
+      // consequences follow, and neither is hypothetical:
+      //   - a conditional write guarded on expectedVersion accepts, silently
+      //     overwriting the external edit;
+      //   - move() re-checks this version to prove the source is unchanged
+      //     before deleting it, so it can delete a source whose bytes it never
+      //     copied, losing the edit outright.
+      // `conditionalWrite: 'process'` declares the first (expectedVersion binds
+      // only against writers in this process). The second is a provider-internal
+      // check that the token cannot actually support; closing it means
+      // byte-comparing the captured source before the delete, not hashing
+      // content here, which would undo the scan-by-metadata property above.
       size: file.size,
       version: await metadataVersion(
         "file",
@@ -663,28 +699,44 @@ var NativeFileSystemProviderV2 = class {
       if (entry.kind === "file") await this.writeBytes(path, entry.data);
     }
   }
-  async rollbackMoveAndThrow(sourcePath, destinationPath, source, createdParents, destinationVersion, sourceDeleted, primary) {
+  async rollbackMoveAndThrow(sourcePath, destinationPath, source, createdParents, destinationVersion, sourceDeleteAttempted, primary) {
     const primaryError = this.translateError(primary, "move", sourcePath, destinationPath);
     const recoveryErrors = [];
-    const sourceCurrent = await this.probeScan(sourcePath);
-    if (sourceCurrent === null && sourceDeleted) {
-      try {
-        await this.writeTree(source, sourcePath, sourcePath);
-        const restored = await this.probeSnapshot(sourcePath);
-        if (!restored || !equalTreeContents(source, sourcePath, restored, sourcePath)) {
-          throw new FsError("conflict", "Restored source does not match its captured state.", {
-            operation: "move",
-            path: sourcePath,
-            destinationPath
-          });
+    let sourceWhole = true;
+    if (sourceDeleteAttempted) {
+      sourceWhole = await this.matchesCapturedSource(sourcePath, source);
+      if (!sourceWhole) {
+        try {
+          await this.writeTree(source, sourcePath, sourcePath);
+          const restored = await this.probeSnapshot(sourcePath);
+          if (!restored || !equalTreeContents(source, sourcePath, restored, sourcePath)) {
+            throw new FsError("conflict", "Restored source does not match its captured state.", {
+              operation: "move",
+              path: sourcePath,
+              destinationPath
+            });
+          }
+          sourceWhole = true;
+        } catch (error) {
+          recoveryErrors.push(this.translateError(error, "move", sourcePath, destinationPath));
         }
-      } catch (error) {
-        recoveryErrors.push(this.translateError(error, "move", sourcePath, destinationPath));
       }
     }
     const destinationCurrent = await this.probeScan(destinationPath);
     if (destinationCurrent) {
-      if (destinationVersion && destinationCurrent.root.version !== destinationVersion) {
+      if (!sourceWhole) {
+        recoveryErrors.push(
+          new FsError(
+            "conflict",
+            "Source is incomplete; rollback kept the copy at the destination.",
+            {
+              operation: "move",
+              path: sourcePath,
+              destinationPath
+            }
+          )
+        );
+      } else if (destinationVersion && destinationCurrent.root.version !== destinationVersion) {
         recoveryErrors.push(
           new FsError("conflict", "Destination changed; rollback will not delete it.", {
             operation: "move",
@@ -716,6 +768,18 @@ var NativeFileSystemProviderV2 = class {
       state
     );
   }
+  /**
+   * Whether the source still holds exactly the bytes the move captured.
+   *
+   * A probe that fails answers "no": rollback must never treat an unverifiable
+   * source as whole, because that is precisely what licenses deleting the copy
+   * at the destination.
+   */
+  async matchesCapturedSource(sourcePath, source) {
+    const current = await this.probeSnapshot(sourcePath);
+    if (!current) return false;
+    return equalTreeContents(source, sourcePath, current, sourcePath);
+  }
   async probeScan(path) {
     try {
       return await this.tryScanMetadata(path, "move");
@@ -784,15 +848,6 @@ async function metadataVersion(kind, metadata, operation, path) {
   const hex = [...new Uint8Array(digest)].map((value) => value.toString(16).padStart(2, "0")).join("");
   return parseFileSystemVersion(`sha256:${hex}`);
 }
-function parentChain(path) {
-  const parents = [];
-  let current = workspacePathDirname(path);
-  while (current) {
-    parents.unshift(current);
-    current = workspacePathDirname(current);
-  }
-  return parents;
-}
 function pathDepth(path) {
   return path ? path.split("/").length : 0;
 }
@@ -805,17 +860,6 @@ function isMissingOrKindError(error) {
   const name = errorName(error);
   return name === "NotFoundError" || name === "TypeMismatchError";
 }
-function copyBytes(data) {
-  const source = ArrayBuffer.isView(data) ? new Uint8Array(data.buffer, data.byteOffset, data.byteLength) : new Uint8Array(data);
-  const copy = new Uint8Array(source.byteLength);
-  copy.set(source);
-  return copy.buffer;
-}
-function equalBytes(left, right) {
-  const leftBytes = new Uint8Array(left);
-  const rightBytes = new Uint8Array(right);
-  return leftBytes.byteLength === rightBytes.byteLength && leftBytes.every((value, index) => value === rightBytes[index]);
-}
 function equalTreeContents(left, leftRoot, right, rightRoot) {
   if (left.entries.length !== right.entries.length) return false;
   const rightByRelativePath = /* @__PURE__ */ new Map();
@@ -830,7 +874,7 @@ function equalTreeContents(left, leftRoot, right, rightRoot) {
     const counterpart = rightByRelativePath.get(relativePath);
     if (!counterpart || counterpart.kind !== entry.kind) return false;
     if (entry.kind === "file") {
-      if (counterpart.kind !== "file" || !equalBytes(entry.data, counterpart.data)) return false;
+      if (counterpart.kind !== "file" || !bytesEqual(entry.data, counterpart.data)) return false;
     }
   }
   return true;
@@ -871,13 +915,6 @@ function newestLastModified(children) {
   }
   return newest ? new Date(newest).toISOString() : EPOCH;
 }
-function compareSnapshots(left, right) {
-  if (left.kind !== right.kind) return left.kind === "directory" ? -1 : 1;
-  return compareText(left.name, right.name);
-}
-function compareText(left, right) {
-  return left < right ? -1 : left > right ? 1 : 0;
-}
 
 // src/filesystem/native-provider.ts
 function isNativeFileSystemSupported() {
@@ -950,6 +987,21 @@ function isMissingEntryError(error) {
   const name = errorName2(error);
   return name === "NotFoundError" || name === "TypeMismatchError";
 }
+function isKindMismatchError(error) {
+  return errorName2(error) === "TypeMismatchError";
+}
+function rootIsNotAMutationTarget(operation, path) {
+  return new FsError("invalid-path", "The workspace root is not a file entry.", {
+    operation,
+    path
+  });
+}
+function notAFile(operation, path) {
+  return new FsError("type-mismatch", "Expected a file but found a directory.", {
+    operation,
+    path
+  });
+}
 function isPermissionError(error) {
   const name = errorName2(error);
   return name === "NotAllowedError" || name === "SecurityError";
@@ -1036,22 +1088,16 @@ var NativeFileSystemProvider = class {
   }
   async readFile(path) {
     const p = normalisePath(path);
-    const dir = await resolveDir(this.root, parentDir(p));
-    if (!dir) return null;
-    try {
-      const fileHandle = await dir.getFileHandle(baseName(p));
-      const file = await fileHandle.getFile();
-      return file.text();
-    } catch (error) {
-      if (isMissingEntryError(error)) return null;
-      throw error;
-    }
+    const data = await this.readBinary(p);
+    if (data === null) return null;
+    return decodeUtf8Text(data, { label: "The file", operation: "read", path: p });
   }
   async writeFile(path, content) {
     return this.withMutationLock(() => this.writeFileUnlocked(path, content));
   }
   async writeFileUnlocked(path, content) {
     const p = normalisePath(path);
+    if (!p) throw rootIsNotAMutationTarget("write", path);
     const dir = await resolveDirCreate(this.root, parentDir(p));
     const fileHandle = await dir.getFileHandle(baseName(p), { create: true });
     const writable = await fileHandle.createWritable();
@@ -1079,7 +1125,7 @@ var NativeFileSystemProvider = class {
   }
   async deleteUnlocked(path) {
     const p = normalisePath(path);
-    if (!p) throw new Error("Cannot delete the filesystem root");
+    if (!p) throw rootIsNotAMutationTarget("remove", path);
     const parent = parentDir(p);
     const name = baseName(p);
     const dir = await resolveDir(this.root, parent);
@@ -1098,9 +1144,7 @@ var NativeFileSystemProvider = class {
     const op = normalisePath(oldPath);
     const np = normalisePath(newPath);
     if (op === np) return;
-    if (!op || !np) {
-      throw new Error("Cannot rename the filesystem root");
-    }
+    if (!op || !np) throw rootIsNotAMutationTarget("move", !op ? oldPath : newPath);
     if (np.startsWith(op + "/")) {
       throw new Error("Cannot move a directory into itself");
     }
@@ -1154,6 +1198,14 @@ var NativeFileSystemProvider = class {
     try {
       await this.deleteUnlocked(op);
     } catch (error) {
+      try {
+        await this.copyDirectory(np, op);
+      } catch (restoreError) {
+        throw new NativeMoveRecoveryError(
+          `Move partially deleted the source and it could not be restored; the copy at ${newPath} was kept: ${oldPath} -> ${newPath}`,
+          [error, restoreError]
+        );
+      }
       try {
         await this.deleteUnlocked(np);
       } catch (rollbackError) {
@@ -1186,6 +1238,7 @@ var NativeFileSystemProvider = class {
   }
   async exists(path) {
     const p = normalisePath(path);
+    if (!p) return true;
     const parent = parentDir(p);
     const name = baseName(p);
     const dir = await resolveDir(this.root, parent);
@@ -1212,6 +1265,7 @@ var NativeFileSystemProvider = class {
   }
   async stat(path) {
     const p = normalisePath(path);
+    if (!p) return null;
     const dir = await resolveDir(this.root, parentDir(p));
     if (!dir) return null;
     try {
@@ -1230,6 +1284,7 @@ var NativeFileSystemProvider = class {
   }
   async readBinary(path) {
     const p = normalisePath(path);
+    if (!p) throw notAFile("read", p);
     const dir = await resolveDir(this.root, parentDir(p));
     if (!dir) return null;
     try {
@@ -1237,6 +1292,7 @@ var NativeFileSystemProvider = class {
       const file = await fileHandle.getFile();
       return file.arrayBuffer();
     } catch (error) {
+      if (isKindMismatchError(error)) throw notAFile("read", p);
       if (isMissingEntryError(error)) return null;
       throw error;
     }
@@ -1246,6 +1302,7 @@ var NativeFileSystemProvider = class {
   }
   async writeBinaryUnlocked(path, data) {
     const p = normalisePath(path);
+    if (!p) throw rootIsNotAMutationTarget("write", path);
     const dir = await resolveDirCreate(this.root, parentDir(p));
     const fileHandle = await dir.getFileHandle(baseName(p), { create: true });
     const writable = await fileHandle.createWritable();
@@ -1290,4 +1347,4 @@ export {
   openNativeFolder,
   restoreNativeFolder
 };
-//# sourceMappingURL=chunk-2D7Y4IR3.js.map
+//# sourceMappingURL=chunk-WJKYY5QR.js.map