@lspeasy/client 3.0.2 → 3.0.3

package/dist/connection/types.d.ts

@@ -1,5 +1,14 @@
 /**
- * Lifecycle state for the client connection.
+ * Lifecycle state of an `LSPClient` connection.
+ *
+ * @remarks
+ * Transitions: `Disconnected` → `Connecting` (on `connect()`) → `Connected`
+ * (after `initialized`) → `Disconnecting` (on `disconnect()`) →
+ * `Disconnected`.
+ *
+ * Listen for state changes via `LSPClient.onConnectionStateChange`.
+ *
+ * @category Client
  */
 export declare enum ConnectionState {
     Connecting = "connecting",
@@ -9,39 +18,72 @@ export declare enum ConnectionState {
 }
 /**
  * Configuration for optional heartbeat monitoring.
+ *
+ * @remarks
+ * When `enabled` is `true`, the client sends a `$/ping` request at each
+ * `interval` milliseconds. If no response arrives within `timeout`
+ * milliseconds, the connection is marked unresponsive.
+ *
+ * @config
+ * @category Client
  */
 export interface HeartbeatConfig {
+    /** Whether heartbeat monitoring is active. */
     enabled?: boolean;
+    /** Interval between pings in milliseconds. */
     interval: number;
+    /** Time to wait for a pong response in milliseconds. */
     timeout: number;
 }
 /**
- * Runtime heartbeat status snapshot.
+ * Snapshot of the current heartbeat monitoring status.
+ *
+ * @category Client
  */
 export interface HeartbeatStatus {
+    /** Whether heartbeat monitoring is active. */
     enabled: boolean;
+    /** Interval between pings in milliseconds. */
     interval: number;
+    /** Timeout in milliseconds before a ping is considered unanswered. */
     timeout: number;
+    /** Timestamp of the last outgoing ping, or `null` if no ping has been sent. */
     lastPing: Date | null;
+    /** Timestamp of the last received pong, or `null` if no pong has been received. */
     lastPong: Date | null;
+    /** Whether the server responded to the most recent ping within the timeout window. */
     isResponsive: boolean;
 }
 /**
- * Aggregated connection health details.
+ * Aggregated connection health snapshot returned by
+ * `LSPClient.getConnectionHealth()`.
+ *
+ * @category Client
  */
 export interface ConnectionHealth {
+    /** Current lifecycle state of the connection. */
     state: ConnectionState;
+    /** Timestamp of the last outgoing message, or `null` if none has been sent. */
     lastMessageSent: Date | null;
+    /** Timestamp of the last incoming message, or `null` if none has been received. */
     lastMessageReceived: Date | null;
+    /** Heartbeat monitoring snapshot, present only when heartbeat is configured. */
     heartbeat?: HeartbeatStatus;
 }
 /**
- * Event payload emitted when connection state changes.
+ * Payload emitted when the connection state changes.
+ * Subscribe via `LSPClient.onConnectionStateChange()`.
+ *
+ * @category Client
  */
 export interface StateChangeEvent {
+    /** The state the connection was in before this transition. */
     previous: ConnectionState;
+    /** The state the connection has transitioned into. */
     current: ConnectionState;
+    /** Wall-clock time at which the state transition occurred. */
     timestamp: Date;
+    /** Optional human-readable description of why the state changed. */
     reason?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/connection/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/connection/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,eAAe;IACzB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,aAAa,kBAAkB;IAC/B,YAAY,iBAAiB;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,eAAe,CAAC;IACvB,eAAe,EAAE,IAAI,GAAG,IAAI,CAAC;IAC7B,mBAAmB,EAAE,IAAI,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/connection/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,oBAAY,eAAe;IACzB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,aAAa,kBAAkB;IAC/B,YAAY,iBAAiB;CAC9B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,mFAAmF;IACnF,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,sFAAsF;IACtF,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,KAAK,EAAE,eAAe,CAAC;IACvB,+EAA+E;IAC/E,eAAe,EAAE,IAAI,GAAG,IAAI,CAAC;IAC7B,mFAAmF;IACnF,mBAAmB,EAAE,IAAI,GAAG,IAAI,CAAC;IACjC,gFAAgF;IAChF,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,QAAQ,EAAE,eAAe,CAAC;IAC1B,sDAAsD;IACtD,OAAO,EAAE,eAAe,CAAC;IACzB,8DAA8D;IAC9D,SAAS,EAAE,IAAI,CAAC;IAChB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/connection/types.js

@@ -1,8 +1,16 @@
-export { ConnectionState };
 /**
- * Lifecycle state for the client connection.
+ * Lifecycle state of an `LSPClient` connection.
+ *
+ * @remarks
+ * Transitions: `Disconnected` → `Connecting` (on `connect()`) → `Connected`
+ * (after `initialized`) → `Disconnecting` (on `disconnect()`) →
+ * `Disconnected`.
+ *
+ * Listen for state changes via `LSPClient.onConnectionStateChange`.
+ *
+ * @category Client
  */
-var ConnectionState;
+export var ConnectionState;
 (function (ConnectionState) {
     ConnectionState["Connecting"] = "connecting";
     ConnectionState["Connected"] = "connected";

package/dist/connection/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/connection/types.ts"],"names":[],"mappings":"SAGY,eAAe;AAH3B;;GAEG;AACH,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,4CAAyB,CAAA;IACzB,0CAAuB,CAAA;IACvB,kDAA+B,CAAA;IAC/B,gDAA6B,CAAA;AAAA,CAC/B,EALY,eAAe,KAAf,eAAe,QAK1B"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/connection/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,4CAAyB,CAAA;IACzB,0CAAuB,CAAA;IACvB,kDAA+B,CAAA;IAC/B,gDAA6B,CAAA;AAC/B,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B"}

package/dist/index.d.ts

@@ -1,5 +1,52 @@
 /**
- * @lspeasy/client - LSP Client for connecting to language servers
+ * LSP client package for connecting to language servers.
+ *
+ * @remarks
+ * Use `@lspeasy/client` when you need to build the **consumer** side of the
+ * Language Server Protocol — an editor extension, a CLI analysis tool, a test
+ * harness, or any process that speaks to a language server process.
+ *
+ * The primary entry point is {@link LSPClient}. Construct it with
+ * {@link ClientOptions}, call `connect(transport)` to complete the LSP
+ * handshake, then use `expect<ServerCaps>()` to get typed access to
+ * capability-aware namespaces (e.g. `client.textDocument.hover(params)`).
+ *
+ * ### Transport Decision Tree
+ *
+ * **Stdio** (`StdioTransport` from `@lspeasy/core/node`)
+ * — Use when: spawning the language server as a child process (the canonical
+ *   editor extension pattern). Zero network overhead; server and client share
+ *   a lifespan. Failure mode: server process dies silently → stdout EOF fires
+ *   `onClose`; pair with `HeartbeatMonitor` on long-lived processes.
+ *
+ * **WebSocket** (`WebSocketTransport` from `@lspeasy/core`)
+ * — Use when: the language server runs remotely (CI, container, cloud dev env)
+ *   or must be browser-accessible. Supports reconnect with exponential back-off.
+ *   Failure mode: network partition → `onError` fires without `onClose`;
+ *   enable `enableReconnect` and subscribe to `ConnectionHealthTracker` events.
+ *
+ * **TCP** (`TcpTransport` from `@lspeasy/core/node`)
+ * — Use when: you need a persistent local socket and control both ends
+ *   (e.g. a test harness or a daemon that outlives the client process).
+ *   Failure mode: port conflict at startup; use `mode: 'client'` only after
+ *   confirming the server is listening, or wrap in a retry loop.
+ *
+ * **DedicatedWorkerTransport** (`DedicatedWorkerTransport` from `@lspeasy/core`)
+ * — Use when: running the language server in a Web Worker for browser isolation.
+ *   Zero latency (shared memory), no WebSocket overhead. Failure mode: worker
+ *   uncaught exception terminates silently; subscribe to `worker.onerror`.
+ *
+ * ### Connection health
+ * Use {@link ConnectionHealthTracker} and {@link HeartbeatMonitor} to detect
+ * silent transport failures. Subscribe to state-change events via
+ * {@link ConnectionState}.
+ *
+ * ### Dynamic registration
+ * The client handles `client/registerCapability` and
+ * `client/unregisterCapability` requests from the server automatically,
+ * updating the typed namespaces at runtime.
+ *
+ * @packageDocumentation
  */
 export { LSPClient } from './client.js';
 export { CapabilityGuard, ClientCapabilityGuard } from './capability-guard.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACnG,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGxE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACnG,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGxE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,5 +1,52 @@
 /**
- * @lspeasy/client - LSP Client for connecting to language servers
+ * LSP client package for connecting to language servers.
+ *
+ * @remarks
+ * Use `@lspeasy/client` when you need to build the **consumer** side of the
+ * Language Server Protocol — an editor extension, a CLI analysis tool, a test
+ * harness, or any process that speaks to a language server process.
+ *
+ * The primary entry point is {@link LSPClient}. Construct it with
+ * {@link ClientOptions}, call `connect(transport)` to complete the LSP
+ * handshake, then use `expect<ServerCaps>()` to get typed access to
+ * capability-aware namespaces (e.g. `client.textDocument.hover(params)`).
+ *
+ * ### Transport Decision Tree
+ *
+ * **Stdio** (`StdioTransport` from `@lspeasy/core/node`)
+ * — Use when: spawning the language server as a child process (the canonical
+ *   editor extension pattern). Zero network overhead; server and client share
+ *   a lifespan. Failure mode: server process dies silently → stdout EOF fires
+ *   `onClose`; pair with `HeartbeatMonitor` on long-lived processes.
+ *
+ * **WebSocket** (`WebSocketTransport` from `@lspeasy/core`)
+ * — Use when: the language server runs remotely (CI, container, cloud dev env)
+ *   or must be browser-accessible. Supports reconnect with exponential back-off.
+ *   Failure mode: network partition → `onError` fires without `onClose`;
+ *   enable `enableReconnect` and subscribe to `ConnectionHealthTracker` events.
+ *
+ * **TCP** (`TcpTransport` from `@lspeasy/core/node`)
+ * — Use when: you need a persistent local socket and control both ends
+ *   (e.g. a test harness or a daemon that outlives the client process).
+ *   Failure mode: port conflict at startup; use `mode: 'client'` only after
+ *   confirming the server is listening, or wrap in a retry loop.
+ *
+ * **DedicatedWorkerTransport** (`DedicatedWorkerTransport` from `@lspeasy/core`)
+ * — Use when: running the language server in a Web Worker for browser isolation.
+ *   Zero latency (shared memory), no WebSocket overhead. Failure mode: worker
+ *   uncaught exception terminates silently; subscribe to `worker.onerror`.
+ *
+ * ### Connection health
+ * Use {@link ConnectionHealthTracker} and {@link HeartbeatMonitor} to detect
+ * silent transport failures. Subscribe to state-change events via
+ * {@link ConnectionState}.
+ *
+ * ### Dynamic registration
+ * The client handles `client/registerCapability` and
+ * `client/unregisterCapability` requests from the server automatically,
+ * updating the typed namespaces at runtime.
+ *
+ * @packageDocumentation
  */
 export { LSPClient } from './client.js';
 export { CapabilityGuard, ClientCapabilityGuard } from './capability-guard.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAS/E,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAOnG,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAS/E,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAOnG,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/notifications/wait.d.ts

@@ -1,12 +1,63 @@
 /**
- * Configuration for waiting on a specific notification.
+ * Options for `NotificationWaiter` and `LSPClient.waitForNotification`.
+ *
+ * @config
+ * @typeParam TParams - The notification params type for the awaited method.
+ * @category Client
  */
 export interface NotificationWaitOptions<TParams> {
+    /**
+     * Maximum time to wait in milliseconds before rejecting with a timeout error.
+     */
     timeout: number;
+    /**
+     * Optional predicate to skip notifications that don't match the expected
+     * content. The waiter continues listening until a matching notification
+     * arrives or the timeout expires.
+     */
     filter?: (params: TParams) => boolean;
 }
 /**
- * Tracks a single wait-for-notification operation and timeout lifecycle.
+ * Tracks a single wait-for-notification operation and its timeout lifecycle.
+ *
+ * @remarks
+ * Created internally by `LSPClient.waitForNotification`. Use
+ * `LSPClient.waitForNotification` rather than instantiating this class
+ * directly.
+ *
+ * @useWhen
+ * You need to await a specific server-to-client notification after triggering
+ * a server-side operation — for example, waiting for
+ * `textDocument/publishDiagnostics` after saving a document.
+ *
+ * @avoidWhen
+ * You need to listen for ongoing notifications (not a one-shot wait) — use
+ * `LSPClient.onNotification` for persistent subscriptions instead.
+ *
+ * @never
+ * NEVER create a `NotificationWaiter` without setting a timeout — an
+ * indefinite wait will leak the waiter permanently if the notification never
+ * arrives (e.g. the server suppresses it for certain file types).
+ *
+ * NEVER use `NotificationWaiter` to wait for notifications that arrive before
+ * the waiter is registered. The waiter only sees notifications emitted after
+ * `start()` is called; earlier notifications are silently missed.
+ *
+ * @example
+ * ```ts
+ * // Wait for diagnostics after saving
+ * const diags = await client.waitForNotification(
+ *   'textDocument/publishDiagnostics',
+ *   {
+ *     timeout: 5000,
+ *     filter: (params) => params.uri === 'file:///src/main.ts',
+ *   }
+ * );
+ * console.log(diags.diagnostics);
+ * ```
+ *
+ * @typeParam TParams - The notification params type.
+ * @category Client
  */
 export declare class NotificationWaiter<TParams> {
     private readonly method;
@@ -22,6 +73,10 @@ export declare class NotificationWaiter<TParams> {
     start(): void;
     /**
      * Returns whether an incoming notification satisfies this waiter.
+     *
+     * @param method - The notification method string of the incoming message.
+     * @param params - The notification params to test against the optional filter predicate.
+     * @returns `true` when the method matches and the filter (if any) passes.
      */
     matches(method: string, params: TParams): boolean;
     /**

package/dist/notifications/wait.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../src/notifications/wait.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,uBAAuB,CAAC,OAAO;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,kBAAkB,CAAC,OAAO;IAMnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAGxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAT5B,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAElD,YACmB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,EAC1D,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,EAClC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EACb,SAAS,EAAE,MAAM,IAAI,EAIvC;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CASZ;IAED;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAUhD;IAED;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAG7B;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAGzB;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAOd;CACF"}
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../src/notifications/wait.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB,CAAC,OAAO;IAC9C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,kBAAkB,CAAC,OAAO;IAMnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAGxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAT5B,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAElD,YACmB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,EAC1D,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,EAClC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EACb,SAAS,EAAE,MAAM,IAAI,EAIvC;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CASZ;IAED;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAUhD;IAED;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAG7B;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAGzB;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAOd;CACF"}

package/dist/notifications/wait.js

@@ -1,5 +1,44 @@
 /**
- * Tracks a single wait-for-notification operation and timeout lifecycle.
+ * Tracks a single wait-for-notification operation and its timeout lifecycle.
+ *
+ * @remarks
+ * Created internally by `LSPClient.waitForNotification`. Use
+ * `LSPClient.waitForNotification` rather than instantiating this class
+ * directly.
+ *
+ * @useWhen
+ * You need to await a specific server-to-client notification after triggering
+ * a server-side operation — for example, waiting for
+ * `textDocument/publishDiagnostics` after saving a document.
+ *
+ * @avoidWhen
+ * You need to listen for ongoing notifications (not a one-shot wait) — use
+ * `LSPClient.onNotification` for persistent subscriptions instead.
+ *
+ * @never
+ * NEVER create a `NotificationWaiter` without setting a timeout — an
+ * indefinite wait will leak the waiter permanently if the notification never
+ * arrives (e.g. the server suppresses it for certain file types).
+ *
+ * NEVER use `NotificationWaiter` to wait for notifications that arrive before
+ * the waiter is registered. The waiter only sees notifications emitted after
+ * `start()` is called; earlier notifications are silently missed.
+ *
+ * @example
+ * ```ts
+ * // Wait for diagnostics after saving
+ * const diags = await client.waitForNotification(
+ *   'textDocument/publishDiagnostics',
+ *   {
+ *     timeout: 5000,
+ *     filter: (params) => params.uri === 'file:///src/main.ts',
+ *   }
+ * );
+ * console.log(diags.diagnostics);
+ * ```
+ *
+ * @typeParam TParams - The notification params type.
+ * @category Client
  */
 export class NotificationWaiter {
     method;
@@ -26,6 +65,10 @@ export class NotificationWaiter {
     }
     /**
      * Returns whether an incoming notification satisfies this waiter.
+     *
+     * @param method - The notification method string of the incoming message.
+     * @param params - The notification params to test against the optional filter predicate.
+     * @returns `true` when the method matches and the filter (if any) passes.
      */
     matches(method, params) {
         if (method !== this.method) {

package/dist/notifications/wait.js.map

@@ -1 +1 @@
-{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../src/notifications/wait.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAMV,MAAM;IACN,OAAO;IAGP,SAAS;IATpB,aAAa,CAA6B;IACjC,SAAS,CAA4B;IACrC,QAAQ,CAAyB;IAElD,YACmB,MAAc,EACd,OAAyC,EAC1D,OAAkC,EAClC,MAA8B,EACb,SAAqB,EACtC;sBALiB,MAAM;uBACN,OAAO;yBAGP,SAAS;QAE1B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC;IAAA,CACxB;IAED;;OAEG;IACH,KAAK,GAAS;QACZ,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;YACpC,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CACX,IAAI,KAAK,CACP,uCAAuC,IAAI,CAAC,MAAM,WAAW,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CACtF,CACF,CAAC;QAAA,CACH,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAAA,CAC1B;IAED;;OAEG;IACH,OAAO,CAAC,MAAc,EAAE,MAAe,EAAW;QAChD,IAAI,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IAAA,CACb;IAED;;OAEG;IACH,OAAO,CAAC,MAAe,EAAQ;QAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAAA,CACxB;IAED;;OAEG;IACH,MAAM,CAAC,KAAY,EAAQ;QACzB,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAAA,CACtB;IAED;;OAEG;IACH,OAAO,GAAS;QACd,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACjC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;QACjC,CAAC;QAED,IAAI,CAAC,SAAS,EAAE,CAAC;IAAA,CAClB;CACF"}
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../src/notifications/wait.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,OAAO,kBAAkB;IAMV,MAAM;IACN,OAAO;IAGP,SAAS;IATpB,aAAa,CAA6B;IACjC,SAAS,CAA4B;IACrC,QAAQ,CAAyB;IAElD,YACmB,MAAc,EACd,OAAyC,EAC1D,OAAkC,EAClC,MAA8B,EACb,SAAqB;sBAJrB,MAAM;uBACN,OAAO;yBAGP,SAAS;QAE1B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;YACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CACX,IAAI,KAAK,CACP,uCAAuC,IAAI,CAAC,MAAM,WAAW,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CACtF,CACF,CAAC;QACJ,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,MAAc,EAAE,MAAe;QACrC,IAAI,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,MAAe;QACrB,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAY;QACjB,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACjC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;QACjC,CAAC;QAED,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;CACF"}

package/dist/progress.js.map

@@ -1 +1 @@
-{"version":3,"file":"progress.js","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoCH;;;GAGG;AACH,MAAM,OAAO,eAAe;IAClB,QAAQ,GAAG,IAAI,GAAG,EAAkC,CAAC;IACrD,cAAc,GAAsB,EAAE,CAAC;IAE/C;;OAEG;IACH,UAAU,CAAC,KAAoB,EAAE,OAAwB,EAAwB;QAC/E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClC,OAAO;YACL,OAAO,EAAE,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAAA,CAC7B;SACF,CAAC;IAAA,CACH;IAED;;OAEG;IACH,aAAa,CAAC,OAAwB,EAAwB;QAC5D,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO;YACL,OAAO,EAAE,GAAG,EAAE,CAAC;gBACb,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACnD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;oBACjB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBACvC,CAAC;YAAA,CACF;SACF,CAAC;IAAA,CACH;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,MAAsB,EAAiB;QAC1D,uCAAuC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAED,2BAA2B;QAC3B,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAAA,CAC9D;CACF"}
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoCH;;;GAGG;AACH,MAAM,OAAO,eAAe;IAClB,QAAQ,GAAG,IAAI,GAAG,EAAkC,CAAC;IACrD,cAAc,GAAsB,EAAE,CAAC;IAE/C;;OAEG;IACH,UAAU,CAAC,KAAoB,EAAE,OAAwB;QACvD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClC,OAAO;YACL,OAAO,EAAE,GAAG,EAAE;gBACZ,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAwB;QACpC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO;YACL,OAAO,EAAE,GAAG,EAAE;gBACZ,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACnD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;oBACjB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBACvC,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,MAAsB;QACzC,uCAAuC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAED,2BAA2B;QAC3B,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/types.d.ts

@@ -10,7 +10,14 @@ import type { HeartbeatConfig } from './connection/types.js';
  */
 export type { Client } from '@lspeasy/core';
 /**
- * LSP Client options
+ * Configuration for an `LSPClient` instance.
+ *
+ * @remarks
+ * Passed to the `LSPClient` constructor. All fields are optional; the client
+ * works with zero configuration.
+ *
+ * @config
+ * @category Client
  */
 export interface ClientOptions<ClientCaps extends Partial<ClientCapabilities> = ClientCapabilities> {
     /**
@@ -61,43 +68,81 @@ export interface ClientOptions<ClientCaps extends Partial<ClientCapabilities> =
     onValidationError?: (error: ZodError, response: ResponseMessage) => void;
 }
 /**
- * Initialize result from server
+ * Initialize result from server.
+ *
+ * @category Client
  */
 export interface InitializeResult {
+    /** Server capabilities advertised in the `initialize` response. */
     capabilities: import('vscode-languageserver-protocol').ServerCapabilities;
+    /** Optional server identification returned by the language server. */
     serverInfo?: {
+        /** Human-readable name of the language server. */
         name: string;
+        /** Optional version string of the language server. */
         version?: string;
     };
 }
 /**
- * Cancellable request result
+ * Return value of `LSPClient.sendCancellableRequest`.
+ *
+ * @remarks
+ * `promise` rejects with a cancellation error when `cancel()` is called.
+ * Always attach a `.catch()` handler to `promise` before calling `cancel()`
+ * to avoid unhandled promise rejections.
+ *
+ * @typeParam T - The expected response result type.
+ * @category Client
  */
 export interface CancellableRequest<T> {
     /**
-     * Promise that resolves with the request result
+     * Promise that resolves with the request result or rejects on cancellation.
      */
     promise: Promise<T>;
     /**
-     * Function to cancel the request
+     * Cancels the in-flight request and sends `$/cancelRequest` to the server.
      */
     cancel: () => void;
 }
 /**
- * Options for sending a request with partial-result streaming.
+ * Options for `LSPClient.sendRequestWithPartialResults`.
+ *
+ * @config
+ * @typeParam TPartial - The partial result element type.
+ * @category Client
  */
 export interface PartialRequestOptions<TPartial> {
+    /**
+     * Custom `partialResultToken` value; auto-generated when omitted.
+     */
     token?: string | number;
+    /**
+     * Called for each `$/progress` notification carrying a partial result.
+     */
     onPartial: (partial: TPartial) => void;
 }
 /**
  * Result returned by partial-result enabled requests.
  */
 export type PartialRequestResult<TPartial, TResult> = PartialRequestOutcome<TPartial, TResult>;
+/**
+ * Namespace for sending notebook-document lifecycle notifications to a server.
+ *
+ * @remarks
+ * Available on `client.notebookDocument` after `connect()`. Mirrors the
+ * standard LSP `notebookDocument/*` notification methods for clients that
+ * declare `notebookDocumentSync` capability.
+ *
+ * @category Client
+ */
 export interface NotebookDocumentNamespace {
+    /** Notify the server that a notebook document was opened. */
     didOpen(params: DidOpenNotebookDocumentParams): Promise<void>;
+    /** Notify the server that a notebook document changed. */
     didChange(params: DidChangeNotebookDocumentParams): Promise<void>;
+    /** Notify the server that a notebook document was saved. */
     didSave(params: DidSaveNotebookDocumentParams): Promise<void>;
+    /** Notify the server that a notebook document was closed. */
     didClose(params: DidCloseNotebookDocumentParams): Promise<void>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAEV,kBAAkB,EAClB,2BAA2B,EAC3B,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC7B,8BAA8B,EAC9B,qBAAqB,EACrB,MAAM,EACN,QAAQ,EACR,UAAU,EACV,gBAAgB,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;GAEG;AACH,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,aAAa,CAC5B,UAAU,SAAS,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB;IAEnE;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,YAAY,CAAC,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,UAAU,GAAG,gBAAgB,CAAC,CAAC;IAElD;;OAEG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B;;OAEG;IACH,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;IAElD;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;CAC1E;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,OAAO,gCAAgC,EAAE,kBAAkB,CAAC;IAC1E,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,QAAQ;IAC7C,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,SAAS,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,QAAQ,EAAE,OAAO,IAAI,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAE/F,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,MAAM,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,SAAS,CAAC,MAAM,EAAE,+BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,OAAO,CAAC,MAAM,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAEV,kBAAkB,EAClB,2BAA2B,EAC3B,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC7B,8BAA8B,EAC9B,qBAAqB,EACrB,MAAM,EACN,QAAQ,EACR,UAAU,EACV,gBAAgB,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;GAEG;AACH,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa,CAC5B,UAAU,SAAS,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB;IAEnE;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,YAAY,CAAC,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,UAAU,GAAG,gBAAgB,CAAC,CAAC;IAElD;;OAEG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B;;OAEG;IACH,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;IAElD;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;CAC1E;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,YAAY,EAAE,OAAO,gCAAgC,EAAE,kBAAkB,CAAC;IAC1E,sEAAsE;IACtE,UAAU,CAAC,EAAE;QACX,kDAAkD;QAClD,IAAI,EAAE,MAAM,CAAC;QACb,sDAAsD;QACtD,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB,CAAC,QAAQ;IAC7C;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;OAEG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,QAAQ,EAAE,OAAO,IAAI,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAE/F;;;;;;;;;GASG;AACH,MAAM,WAAW,yBAAyB;IACxC,6DAA6D;IAC7D,OAAO,CAAC,MAAM,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,0DAA0D;IAC1D,SAAS,CAAC,MAAM,EAAE,+BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,4DAA4D;IAC5D,OAAO,CAAC,MAAM,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE"}

package/dist/validation.d.ts

@@ -39,5 +39,5 @@ export interface ValidationOptions {
 /**
  * Creates a response validator with custom options
  */
-export declare function createValidator(options?: ValidationOptions): <T>(method: "callHierarchy/incomingCalls" | "callHierarchy/outgoingCalls" | "client/registerCapability" | "client/unregisterCapability" | "codeAction/resolve" | "codeLens/resolve" | "completionItem/resolve" | "documentLink/resolve" | "initialize" | "inlayHint/resolve" | "shutdown" | "textDocument/codeAction" | "textDocument/codeLens" | "textDocument/colorPresentation" | "textDocument/completion" | "textDocument/declaration" | "textDocument/definition" | "textDocument/diagnostic" | "textDocument/documentColor" | "textDocument/documentHighlight" | "textDocument/documentLink" | "textDocument/documentSymbol" | "textDocument/foldingRange" | "textDocument/formatting" | "textDocument/hover" | "textDocument/implementation" | "textDocument/inlayHint" | "textDocument/inlineValue" | "textDocument/linkedEditingRange" | "textDocument/moniker" | "textDocument/onTypeFormatting" | "textDocument/prepareCallHierarchy" | "textDocument/prepareRename" | "textDocument/prepareTypeHierarchy" | "textDocument/rangeFormatting" | "textDocument/references" | "textDocument/rename" | "textDocument/selectionRange" | "textDocument/semanticTokens/full" | "textDocument/semanticTokens/full/delta" | "textDocument/semanticTokens/range" | "textDocument/signatureHelp" | "textDocument/typeDefinition" | "textDocument/willSaveWaitUntil" | "typeHierarchy/subtypes" | "typeHierarchy/supertypes" | "window/showDocument" | "window/showMessageRequest" | "window/workDoneProgress/create" | "workspace/applyEdit" | "workspace/codeLens/refresh" | "workspace/configuration" | "workspace/diagnostic" | "workspace/diagnostic/refresh" | "workspace/executeCommand" | "workspace/inlayHint/refresh" | "workspace/inlineValue/refresh" | "workspace/semanticTokens/refresh" | "workspace/symbol" | "workspace/willCreateFiles" | "workspace/willDeleteFiles" | "workspace/willRenameFiles" | "workspace/workspaceFolders" | "workspaceSymbol/resolve", schema: z.ZodType<T, unknown, z.core.$ZodTypeInternals<T, unknown>>, response: unknown) => T;
+export declare function createValidator(options?: ValidationOptions): <T>(method: LSPRequestMethod, schema: z.ZodSchema<T>, response: unknown) => T;
 //# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAE9B,MAAM,EAAE,MAAM;aACd,MAAM,EAAE,CAAC,CAAC,QAAQ;aAClB,QAAQ,EAAE,OAAO;IAHnC,YACkB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,CAAC,QAAQ,EAClB,QAAQ,EAAE,OAAO,EAIlC;CACF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,QAAQ,EAAE,OAAO,GAChB,CAAC,CAQH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAC9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,iBAAsB,IAGpC,CAAC,48DAkB3B"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAE9B,MAAM,EAAE,MAAM;aACd,MAAM,EAAE,CAAC,CAAC,QAAQ;aAClB,QAAQ,EAAE,OAAO;IAHnC,YACkB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,CAAC,QAAQ,EAClB,QAAQ,EAAE,OAAO,EAIlC;CACF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,QAAQ,EAAE,OAAO,GAChB,CAAC,CAQH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAC9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,iBAAsB,IAGpC,CAAC,UAChB,gBAAgB,UAChB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YACZ,OAAO,KAChB,CAAC,CAcL"}

package/dist/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAE9B,MAAM;IACN,MAAM;IACN,QAAQ;IAH1B,YACkB,MAAc,EACd,MAAkB,EAClB,QAAiB,EACjC;QACA,KAAK,CAAC,kCAAkC,MAAM,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;sBAJrD,MAAM;sBACN,MAAM;wBACN,QAAQ;QAGxB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IAAA,CACvC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAwB,EACxB,MAAsB,EACtB,QAAiB,EACd;IACH,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AAAA,CACpB;AAkBD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAO,GAAsB,EAAE,EAAE;IAC/D,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC;IAEtD,OAAO,SAAS,QAAQ,CACtB,MAAwB,EACxB,MAAsB,EACtB,QAAiB,EACd;QACH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,QAAa,CAAC;QACvB,CAAC;QAED,IAAI,CAAC;YACH,OAAO,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,uBAAuB,IAAI,iBAAiB,EAAE,CAAC;gBAClE,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IAAA,CACF,CAAC;AAAA,CACH"}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAE9B,MAAM;IACN,MAAM;IACN,QAAQ;IAH1B,YACkB,MAAc,EACd,MAAkB,EAClB,QAAiB;QAEjC,KAAK,CAAC,kCAAkC,MAAM,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;sBAJrD,MAAM;sBACN,MAAM;wBACN,QAAQ;QAGxB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAwB,EACxB,MAAsB,EACtB,QAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAkBD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAO,GAAsB,EAAE;IAC7D,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC;IAEtD,OAAO,SAAS,QAAQ,CACtB,MAAwB,EACxB,MAAsB,EACtB,QAAiB;QAEjB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,QAAa,CAAC;QACvB,CAAC;QAED,IAAI,CAAC;YACH,OAAO,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,uBAAuB,IAAI,iBAAiB,EAAE,CAAC;gBAClE,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lspeasy/client",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "description": "Connect to LSP servers with typed client API",
   "private": false,
   "keywords": [
@@ -14,7 +14,7 @@
     "url": "https://github.com/pradeepmouli/lspeasy/issues"
   },
   "license": "MIT",
-  "author": "Pradeep Mouli",
+  "author": "Pradeep Mouli <pmouli@mac.com> (https://github.com/pradeepmouli)",
   "repository": {
     "type": "git",
     "url": "https://github.com/pradeepmouli/lspeasy.git",
@@ -37,15 +37,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@lspeasy/core": "2.1.2"
+    "@lspeasy/core": "2.1.3"
   },
   "optionalDependencies": {
-    "zod": "^4.3.6"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "typescript": "^5.9.3",
-    "vscode-languageserver-protocol": "^3.17.5",
-    "zod": "^4.3.6"
+    "typescript": "^6.0.3",
+    "vscode-languageserver-protocol": "^3.17.5"
   },
   "engines": {
     "node": ">=20.0.0"