@nocturnium/svelte-ide 1.0.1 → 1.0.3

package/dist/crdt/awareness.d.ts

@@ -28,10 +28,16 @@ export interface AwarenessProtocol {
     onUsersChange(callback: (users: AwarenessUser[]) => void): () => void;
     destroy(): void;
 }
+export interface CreateAwarenessProtocolOptions {
+    destroyAwareness?: boolean;
+}
 /**
- * Create an awareness protocol instance
+ * Create an awareness protocol instance.
+ *
+ * Pass a provider-owned Awareness instance to broadcast presence through that
+ * provider. Passing a Y.Doc creates a standalone Awareness instance.
  */
-export declare function createAwarenessProtocol(doc: YDoc): AwarenessProtocol;
+export declare function createAwarenessProtocol(source: YDoc | Awareness, options?: CreateAwarenessProtocolOptions): AwarenessProtocol;
 /**
  * Generate a random color for a user
  */

package/dist/crdt/awareness.js

@@ -3,10 +3,15 @@
  */
 import { Awareness } from 'y-protocols/awareness';
 /**
- * Create an awareness protocol instance
+ * Create an awareness protocol instance.
+ *
+ * Pass a provider-owned Awareness instance to broadcast presence through that
+ * provider. Passing a Y.Doc creates a standalone Awareness instance.
  */
-export function createAwarenessProtocol(doc) {
-    const awareness = new Awareness(doc);
+export function createAwarenessProtocol(source, options = {}) {
+    const ownsAwareness = source instanceof Awareness;
+    const awareness = ownsAwareness ? source : new Awareness(source);
+    const shouldDestroyAwareness = options.destroyAwareness ?? !ownsAwareness;
     const userChangeCallbacks = new Set();
     // Track awareness changes
     awareness.on('change', () => {
@@ -75,7 +80,9 @@ export function createAwarenessProtocol(doc) {
             return () => userChangeCallbacks.delete(callback);
         },
         destroy() {
-            awareness.destroy();
+            if (shouldDestroyAwareness) {
+                awareness.destroy();
+            }
             userChangeCallbacks.clear();
         }
     };

package/dist/crdt/document.d.ts

@@ -4,6 +4,11 @@
  */
 import * as Y from 'yjs';
 import type { DocumentOptions } from './types';
+export interface CollaborativeUndoManagerOptions {
+    captureTimeout?: number;
+    trackedOrigins?: Set<unknown>;
+    deleteFilter?: (item: Y.Item) => boolean;
+}
 export declare class CollaborativeDocument {
     readonly doc: Y.Doc;
     readonly id: string;
@@ -49,7 +54,11 @@ export declare class CollaborativeDocument {
     /**
      * Setup undo manager
      */
-    private setupUndoManager;
+    getUndoManager(options?: CollaborativeUndoManagerOptions): Y.UndoManager;
+    /**
+     * Check whether this document currently owns an undo manager.
+     */
+    hasUndoManager(): boolean;
     /**
      * Track additional origins for undo
      */

package/dist/crdt/document.js

@@ -18,7 +18,7 @@ export class CollaborativeDocument {
         }
         // Setup undo manager if enabled
         if (options.enableUndo !== false) {
-            this.setupUndoManager(options.undoCaptureTimeout);
+            this.getUndoManager({ captureTimeout: options.undoCaptureTimeout });
         }
     }
     /**
@@ -97,20 +97,28 @@ export class CollaborativeDocument {
     /**
      * Setup undo manager
      */
-    setupUndoManager(captureTimeout = 500) {
-        const trackedOrigins = new Set([null, 'local']);
+    getUndoManager(options = {}) {
+        if (this.undoManager)
+            return this.undoManager;
+        const { captureTimeout = 500, trackedOrigins = new Set([null, 'local']), deleteFilter } = options;
         this.undoManager = new Y.UndoManager(this.getText(), {
             trackedOrigins,
-            captureTimeout
+            captureTimeout,
+            deleteFilter
         });
+        return this.undoManager;
+    }
+    /**
+     * Check whether this document currently owns an undo manager.
+     */
+    hasUndoManager() {
+        return this.undoManager !== null;
     }
     /**
      * Track additional origins for undo
      */
     trackOrigin(origin) {
-        if (this.undoManager) {
-            this.undoManager.trackedOrigins.add(origin);
-        }
+        this.getUndoManager().trackedOrigins.add(origin);
     }
     /**
      * Undo last change

package/dist/crdt/index.d.ts

@@ -4,6 +4,12 @@
  */
 export { CollaborativeDocument } from './document';
 export { CollaborativeProvider } from './provider';
-export { createAwarenessProtocol } from './awareness';
-export { createUndoManager } from './undo';
+export { createProvider } from './provider';
+export { createAwarenessProtocol, generateUserColor, getInitials } from './awareness';
+export { createUndoManager, createUserUndoManager } from './undo';
+export { default as CollaborativeEditor } from '../components/editor/CollaborativeEditor.svelte';
+export { CRDTBinding, createCRDTBinding, createRelativePosition, resolveRelativePosition } from '../components/editor/core/crdt-binding';
 export type * from './types';
+export type { AwarenessProtocol, AwarenessUser, CreateAwarenessProtocolOptions } from './awareness';
+export type { UndoManagerInstance, UndoManagerOptions, UndoManagerState } from './undo';
+export type { CRDTBindingConfig, CRDTPosition, RelativePosition } from '../components/editor/core/crdt-binding';

package/dist/crdt/index.js

@@ -4,5 +4,8 @@
  */
 export { CollaborativeDocument } from './document';
 export { CollaborativeProvider } from './provider';
-export { createAwarenessProtocol } from './awareness';
-export { createUndoManager } from './undo';
+export { createProvider } from './provider';
+export { createAwarenessProtocol, generateUserColor, getInitials } from './awareness';
+export { createUndoManager, createUserUndoManager } from './undo';
+export { default as CollaborativeEditor } from '../components/editor/CollaborativeEditor.svelte';
+export { CRDTBinding, createCRDTBinding, createRelativePosition, resolveRelativePosition } from '../components/editor/core/crdt-binding';

package/dist/crdt/undo.d.ts

@@ -1,13 +1,8 @@
 /**
  * Undo manager for CRDT documents
  */
-import * as Y from 'yjs';
-import type { CollaborativeDocument } from './document';
-export interface UndoManagerOptions {
-    captureTimeout?: number;
-    trackedOrigins?: Set<unknown>;
-    deleteFilter?: (item: Y.Item) => boolean;
-}
+import type { CollaborativeDocument, CollaborativeUndoManagerOptions } from './document';
+export type UndoManagerOptions = CollaborativeUndoManagerOptions;
 export interface UndoManagerState {
     canUndo: boolean;
     canRedo: boolean;

package/dist/crdt/undo.js

@@ -1,18 +1,11 @@
 /**
  * Undo manager for CRDT documents
  */
-import * as Y from 'yjs';
 /**
  * Create an undo manager for a collaborative document
  */
 export function createUndoManager(document, options = {}) {
-    const { captureTimeout = 500, trackedOrigins = new Set([null, 'local']), deleteFilter } = options;
-    const text = document.getText();
-    const manager = new Y.UndoManager(text, {
-        captureTimeout,
-        trackedOrigins,
-        deleteFilter
-    });
+    const manager = document.getUndoManager(options);
     const stateCallbacks = new Set();
     function getState() {
         return {

package/dist/index.d.ts

@@ -8,7 +8,7 @@
  * - All UI components built from scratch (no UI libraries)
  * - Native Svelte 5 runes for state management
  * - Custom code editor (no CodeMirror dependency)
- * - Yjs for CRDT collaboration (optional, tree-shakeable)
+ * - Yjs for CRDT collaboration (optional via the ./crdt entry)
  *
  * ============================================================================
  * PUBLIC API SURFACE — what belongs in this root barrel
@@ -111,11 +111,6 @@ export { default as Editor } from './components/editor/Editor.svelte';
  * @public - Stable API
  */
 export { default as CustomEditor } from './components/editor/CustomEditor.svelte';
-/**
- * Collaborative editor with CRDT support
- * @experimental - requires the optional yjs peers; API may change in future versions
- */
-export { default as CollaborativeEditor } from './components/editor/CollaborativeEditor.svelte';
 /**
  * Editor tab bar component
  * @public - Stable API
@@ -142,14 +137,17 @@ export { default as FileExplorer, type FileChangeStatus, type GitFileStatus } fr
  *
  * Functions and types marked below:
  *   createEditorState, createNavigation, createKeyboardHandler,
- *   createDefaultKeybindings, createCRDTBinding,
+ *   createDefaultKeybindings,
  *   EditorState, Position, Selection, Line, ChangeEvent,
- *   Navigation, KeyboardHandler, Keybinding, CRDTBinding,
+ *   Navigation, KeyboardHandler, Keybinding,
  *   Cursor, CursorManager, CursorManagerConfig
  *
  * @public - Stable API
  */
-export { createEditorState, createNavigation, createKeyboardHandler, createDefaultKeybindings, createCRDTBinding, type EditorState, type Position, type Selection, type Line, type ChangeEvent, type Navigation, type KeyboardHandler, type Keybinding, type CRDTBinding, type Cursor, type CursorManager, type CursorManagerConfig } from './components/editor/core';
+export { createEditorState, type EditorState, type Position, type Selection, type Line, type ChangeEvent } from './components/editor/core/state';
+export { createNavigation, type Navigation } from './components/editor/core/navigation';
+export { createKeyboardHandler, createDefaultKeybindings, type KeyboardHandler, type Keybinding } from './components/editor/core/keybindings';
+export { type Cursor, type CursorManager, type CursorManagerConfig } from './components/editor/core/multi-cursor';
 /**
  * Editor theme utilities and types
  * @public - Stable API

package/dist/index.js

@@ -8,7 +8,7 @@
  * - All UI components built from scratch (no UI libraries)
  * - Native Svelte 5 runes for state management
  * - Custom code editor (no CodeMirror dependency)
- * - Yjs for CRDT collaboration (optional, tree-shakeable)
+ * - Yjs for CRDT collaboration (optional via the ./crdt entry)
  *
  * ============================================================================
  * PUBLIC API SURFACE — what belongs in this root barrel
@@ -117,11 +117,6 @@ export { default as Editor } from './components/editor/Editor.svelte';
  * @public - Stable API
  */
 export { default as CustomEditor } from './components/editor/CustomEditor.svelte';
-/**
- * Collaborative editor with CRDT support
- * @experimental - requires the optional yjs peers; API may change in future versions
- */
-export { default as CollaborativeEditor } from './components/editor/CollaborativeEditor.svelte';
 /**
  * Editor tab bar component
  * @public - Stable API
@@ -148,14 +143,17 @@ export { default as FileExplorer } from './components/editor/FileExplorer.svelte
  *
  * Functions and types marked below:
  *   createEditorState, createNavigation, createKeyboardHandler,
- *   createDefaultKeybindings, createCRDTBinding,
+ *   createDefaultKeybindings,
  *   EditorState, Position, Selection, Line, ChangeEvent,
- *   Navigation, KeyboardHandler, Keybinding, CRDTBinding,
+ *   Navigation, KeyboardHandler, Keybinding,
  *   Cursor, CursorManager, CursorManagerConfig
  *
  * @public - Stable API
  */
-export { createEditorState, createNavigation, createKeyboardHandler, createDefaultKeybindings, createCRDTBinding } from './components/editor/core';
+export { createEditorState } from './components/editor/core/state';
+export { createNavigation } from './components/editor/core/navigation';
+export { createKeyboardHandler, createDefaultKeybindings } from './components/editor/core/keybindings';
+export {} from './components/editor/core/multi-cursor';
 /**
  * Editor theme utilities and types
  * @public - Stable API

package/dist/services/error-handling.d.ts

@@ -3,17 +3,8 @@
  *
  * Provides structured error types, recovery strategies, and user-friendly error messages.
  */
-export type VFSErrorCode = 'NETWORK_ERROR' | 'CONNECTION_LOST' | 'TIMEOUT' | 'FILE_LOCKED' | 'LOCK_EXPIRED' | 'LOCK_CONFLICT' | 'VERSION_CONFLICT' | 'FILE_NOT_FOUND' | 'PERMISSION_DENIED' | 'WORKSPACE_NOT_FOUND' | 'INVALID_OPERATION' | 'SERVER_ERROR' | 'RATE_LIMITED' | 'UNKNOWN';
-export interface VFSError extends Error {
-    code: VFSErrorCode;
-    statusCode?: number;
-    path?: string;
-    workspaceId?: string;
-    retryable: boolean;
-    userMessage: string;
-    technicalDetails?: string;
-    recoveryOptions: RecoveryOption[];
-}
+import { VFSError, type VFSErrorCode } from '../types/vfs';
+export { VFSError, type VFSErrorCode };
 export interface RecoveryOption {
     id: string;
     label: string;

package/dist/services/error-handling.js

@@ -3,6 +3,11 @@
  *
  * Provides structured error types, recovery strategies, and user-friendly error messages.
  */
+import { VFSError } from '../types/vfs';
+// ============================================================================
+// Error Types
+// ============================================================================
+export { VFSError };
 // ============================================================================
 // Error Factory
 // ============================================================================
@@ -10,9 +15,7 @@
  * Create a structured VFS error
  */
 export function createVFSError(code, message, options = {}) {
-    const error = new Error(message);
-    error.name = 'VFSError';
-    error.code = code;
+    const error = new VFSError(message, code, options.cause);
     error.statusCode = options.statusCode;
     error.path = options.path;
     error.workspaceId = options.workspaceId;
@@ -29,6 +32,14 @@ export function createVFSError(code, message, options = {}) {
 export function parseError(error, context) {
     // Already a VFSError
     if (isVFSError(error)) {
+        error.path ??= context?.path;
+        error.workspaceId ??= context?.workspaceId;
+        error.retryable = isRetryableError(error.code);
+        error.userMessage = getUserMessage(error.code, error.path);
+        error.technicalDetails ??= error.message;
+        if (error.recoveryOptions.length === 0) {
+            error.recoveryOptions = getRecoveryOptions(error.code);
+        }
         return error;
     }
     // Network/fetch errors
@@ -97,7 +108,7 @@ function parseStatusCode(status, message, context) {
  * Check if error is a VFSError
  */
 export function isVFSError(error) {
-    return error instanceof Error && 'code' in error && 'retryable' in error;
+    return error instanceof VFSError;
 }
 /**
  * Check if error code is retryable

package/dist/services/lsp-client.d.ts

@@ -13,6 +13,7 @@ export declare class LSPClient {
     private _capabilities;
     private reconnectAttempts;
     private reconnectTimeout;
+    private intentionalDisconnect;
     private openDocuments;
     private diagnosticsCache;
     private eventHandlers;
@@ -28,6 +29,8 @@ export declare class LSPClient {
     private emitEvent;
     private setState;
     connect(): Promise<void>;
+    private cleanupSocket;
+    private getReconnectDelay;
     private handleDisconnect;
     disconnect(): Promise<void>;
     private initialize;

package/dist/services/lsp-client.js

@@ -109,6 +109,7 @@ export class LSPClient {
     _capabilities = null;
     reconnectAttempts = 0;
     reconnectTimeout = null;
+    intentionalDisconnect = false;
     // Document tracking
     openDocuments = new Map();
     diagnosticsCache = new Map();
@@ -177,11 +178,24 @@ export class LSPClient {
         if (this._state !== 'disconnected' && this._state !== 'error') {
             return;
         }
+        this.intentionalDisconnect = false;
+        if (this.reconnectTimeout) {
+            clearTimeout(this.reconnectTimeout);
+            this.reconnectTimeout = null;
+        }
+        this.cleanupSocket();
         this.setState('connecting');
         return new Promise((resolve, reject) => {
             try {
-                this.ws = new WebSocket(this.config.serverUrl);
-                this.ws.onopen = async () => {
+                const socket = new WebSocket(this.config.serverUrl);
+                this.ws = socket;
+                socket.onopen = async () => {
+                    if (socket !== this.ws)
+                        return;
+                    if (this.reconnectTimeout) {
+                        clearTimeout(this.reconnectTimeout);
+                        this.reconnectTimeout = null;
+                    }
                     this.reconnectAttempts = 0;
                     this.setState('connected');
                     try {
@@ -192,17 +206,21 @@ export class LSPClient {
                         reject(err);
                     }
                 };
-                this.ws.onclose = () => {
-                    this.handleDisconnect();
+                socket.onclose = () => {
+                    this.handleDisconnect(socket);
                 };
-                this.ws.onerror = (_event) => {
+                socket.onerror = (_event) => {
+                    if (socket !== this.ws)
+                        return;
                     const error = new Error('WebSocket error');
                     this.emitEvent('onError', error);
                     if (this._state === 'connecting') {
                         reject(error);
                     }
                 };
-                this.ws.onmessage = (event) => {
+                socket.onmessage = (event) => {
+                    if (socket !== this.ws)
+                        return;
                     this.handleMessage(event.data);
                 };
             }
@@ -212,7 +230,29 @@ export class LSPClient {
             }
         });
     }
-    handleDisconnect() {
+    cleanupSocket(socket = this.ws) {
+        if (!socket)
+            return;
+        socket.onopen = null;
+        socket.onclose = null;
+        socket.onerror = null;
+        socket.onmessage = null;
+        if (socket.readyState !== WebSocket.CLOSING) {
+            socket.close();
+        }
+        if (socket === this.ws) {
+            this.ws = null;
+        }
+    }
+    getReconnectDelay(attempt) {
+        const baseDelay = this.config.reconnectDelay ?? 1000;
+        const exponentialDelay = baseDelay * 2 ** (attempt - 1);
+        const jitter = 0.75 + Math.random() * 0.5;
+        return Math.round(exponentialDelay * jitter);
+    }
+    handleDisconnect(socket = this.ws) {
+        const wasIntentional = this.intentionalDisconnect;
+        this.cleanupSocket(socket);
         this.setState('disconnected');
         // Cancel pending requests
         for (const [_id, pending] of this.pendingRequests) {
@@ -220,11 +260,15 @@ export class LSPClient {
             pending.reject(new Error('Connection closed'));
         }
         this.pendingRequests.clear();
+        if (wasIntentional) {
+            this.intentionalDisconnect = false;
+            return;
+        }
         // Auto-reconnect
         if (this.config.autoReconnect &&
             this.reconnectAttempts < (this.config.maxReconnectAttempts ?? 5)) {
             this.reconnectAttempts++;
-            const delay = (this.config.reconnectDelay ?? 1000) * this.reconnectAttempts;
+            const delay = this.getReconnectDelay(this.reconnectAttempts);
             if (this.config.debug) {
                 console.log(`[LSP] Reconnecting in ${delay}ms (attempt ${this.reconnectAttempts})`);
             }
@@ -236,6 +280,7 @@ export class LSPClient {
         }
     }
     async disconnect() {
+        this.intentionalDisconnect = true;
         if (this.reconnectTimeout) {
             clearTimeout(this.reconnectTimeout);
             this.reconnectTimeout = null;
@@ -251,10 +296,10 @@ export class LSPClient {
                     // Ignore errors during shutdown
                 }
             }
-            this.ws.close();
-            this.ws = null;
+            this.cleanupSocket();
         }
         this.setState('disconnected');
+        this.intentionalDisconnect = false;
     }
     // ============================================================================
     // Initialize

package/dist/services/optimistic.d.ts

@@ -6,6 +6,7 @@
  */
 export interface OptimisticOperation<T> {
     id: string;
+    scopeKey?: string;
     type: string;
     payload: T;
     timestamp: number;
@@ -53,6 +54,7 @@ type CommitFn<T> = () => Promise<T>;
  * ```
  */
 export declare function optimisticUpdate<T, R>(options: {
+    scopeKey?: string;
     type: string;
     payload: T;
     apply: () => void;
@@ -84,6 +86,7 @@ export declare function createOptimisticState<T>(initialValue: T): {
  * Batch multiple optimistic operations
  */
 export declare function batchOptimisticUpdates(operations: Array<{
+    scopeKey?: string;
     type: string;
     payload: unknown;
     apply: () => void;
@@ -95,9 +98,9 @@ export declare function batchOptimisticUpdates(operations: Array<{
     failedCount: number;
 }>;
 /**
- * Get all pending operations
+ * Get pending operations, optionally limited to one document/workspace scope.
  */
-export declare function getPendingOperations(): OptimisticOperation<unknown>[];
+export declare function getPendingOperations(scopeKey?: string): OptimisticOperation<unknown>[];
 /**
  * Get operation by ID
  */
@@ -105,11 +108,11 @@ export declare function getOperation(id: string): OptimisticOperation<unknown> |
 /**
  * Cancel a pending operation
  */
-export declare function cancelOperation(id: string): Promise<boolean>;
+export declare function cancelOperation(id: string, scopeKey?: string): Promise<boolean>;
 /**
- * Cancel all pending operations
+ * Cancel pending operations, optionally limited to one document/workspace scope.
  */
-export declare function cancelAllOperations(): Promise<void>;
+export declare function cancelAllOperations(scopeKey?: string): Promise<void>;
 export interface ConflictInfo {
     type: 'version' | 'lock' | 'concurrent';
     localVersion?: number;

package/dist/services/optimistic.js

@@ -4,6 +4,7 @@
  * Provides utilities for optimistic UI updates with automatic rollback on failure.
  * Implements a queue-based system for managing pending operations.
  */
+const DEFAULT_SCOPE_KEY = '__global__';
 // ============================================================================
 // Operation Queue
 // ============================================================================
@@ -38,8 +39,10 @@ const rollbackFunctions = new Map();
 export async function optimisticUpdate(options) {
     const { type, payload, apply, rollback, commit, config = {} } = options;
     const { maxRetries = 3, retryDelay = 1000, onCommit, onRollback, onRetry } = config;
+    const scopeKey = options.scopeKey ?? getScopeKeyFromPayload(payload);
     const operation = {
         id: crypto.randomUUID(),
+        scopeKey,
         type,
         payload,
         timestamp: Date.now(),
@@ -85,7 +88,7 @@ export async function optimisticUpdate(options) {
             operation.retryCount++;
             if (operation.retryCount <= maxRetries) {
                 onRetry?.(operation, operation.retryCount);
-                await delay(retryDelay * operation.retryCount); // Exponential backoff
+                await delay(getRetryDelay(retryDelay, operation.retryCount));
             }
         }
     }
@@ -227,10 +230,10 @@ export async function batchOptimisticUpdates(operations, config) {
 // Queue Management
 // ============================================================================
 /**
- * Get all pending operations
+ * Get pending operations, optionally limited to one document/workspace scope.
  */
-export function getPendingOperations() {
-    return Array.from(operationQueue.values()).filter((op) => op.status === 'pending');
+export function getPendingOperations(scopeKey) {
+    return Array.from(operationQueue.values()).filter((op) => op.status === 'pending' && (!scopeKey || op.scopeKey === scopeKey));
 }
 /**
  * Get operation by ID
@@ -241,9 +244,11 @@ export function getOperation(id) {
 /**
  * Cancel a pending operation
  */
-export async function cancelOperation(id) {
+export async function cancelOperation(id, scopeKey) {
     const operation = operationQueue.get(id);
-    if (!operation || operation.status !== 'pending') {
+    if (!operation ||
+        operation.status !== 'pending' ||
+        (scopeKey && operation.scopeKey !== scopeKey)) {
         return false;
     }
     const rollback = rollbackFunctions.get(id);
@@ -262,12 +267,12 @@ export async function cancelOperation(id) {
     return true;
 }
 /**
- * Cancel all pending operations
+ * Cancel pending operations, optionally limited to one document/workspace scope.
  */
-export async function cancelAllOperations() {
-    const pending = getPendingOperations();
+export async function cancelAllOperations(scopeKey) {
+    const pending = getPendingOperations(scopeKey);
     for (const op of pending) {
-        await cancelOperation(op.id);
+        await cancelOperation(op.id, scopeKey);
     }
 }
 /**
@@ -319,6 +324,27 @@ export function parseConflictDetails(error) {
 function delay(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function getScopeKeyFromPayload(payload) {
+    if (payload && typeof payload === 'object') {
+        const candidate = payload;
+        if (typeof candidate.scopeKey === 'string')
+            return candidate.scopeKey;
+        if (typeof candidate.workspaceId === 'string' && typeof candidate.path === 'string') {
+            return `${candidate.workspaceId}:${candidate.path}`;
+        }
+        if (typeof candidate.workspace === 'string' && typeof candidate.path === 'string') {
+            return `${candidate.workspace}:${candidate.path}`;
+        }
+        if (typeof candidate.path === 'string')
+            return candidate.path;
+    }
+    return DEFAULT_SCOPE_KEY;
+}
+function getRetryDelay(baseDelay, attempt) {
+    const exponentialDelay = baseDelay * 2 ** (attempt - 1);
+    const jitter = 0.75 + Math.random() * 0.5;
+    return Math.round(exponentialDelay * jitter);
+}
 /**
  * Create a debounced optimistic updater
  */

package/dist/services/vfs-client.js

@@ -55,7 +55,7 @@ async function request(path, options = {}) {
         if (err instanceof VFSError)
             throw err;
         if (err instanceof Error && err.name === 'AbortError') {
-            throw new VFSError('Request timeout', 'NETWORK_ERROR');
+            throw new VFSError('Request timeout', 'TIMEOUT');
         }
         throw new VFSError(err instanceof Error ? err.message : 'Unknown error', 'NETWORK_ERROR', err);
     }
@@ -65,14 +65,22 @@ async function request(path, options = {}) {
 }
 function mapStatusToErrorCode(status) {
     switch (status) {
-        case 404:
-            return 'FILE_NOT_FOUND';
+        case 401:
         case 403:
             return 'PERMISSION_DENIED';
+        case 404:
+            return 'FILE_NOT_FOUND';
         case 409:
             return 'VERSION_CONFLICT';
         case 423:
             return 'FILE_LOCKED';
+        case 429:
+            return 'RATE_LIMITED';
+        case 500:
+        case 502:
+        case 503:
+        case 504:
+            return 'SERVER_ERROR';
         default:
             return 'NETWORK_ERROR';
     }