@lspeasy/core 2.1.1 → 2.1.3

package/dist/utils/disposable.js

@@ -3,13 +3,45 @@
  * Pattern: MCP SDK's disposable pattern
  */
 /**
- * Store for managing multiple disposables
+ * Collects multiple `Disposable` instances and releases them together.
+ *
+ * @remarks
+ * Ideal for managing handler registrations on a server that should all be
+ * torn down when a document is closed or a feature is disabled.
+ * Once `dispose()` is called on the store, any further `add()` calls
+ * immediately dispose the item rather than storing it.
+ *
+ * @useWhen
+ * You register multiple handlers (hover, completion, definition) that share
+ * the same lifetime — collect them all into one store and dispose the store
+ * on shutdown or feature toggle.
+ *
+ * @example
+ * ```ts
+ * import { DisposableStore } from '@lspeasy/core';
+ * import { LSPServer } from '@lspeasy/server';
+ *
+ * const server = new LSPServer();
+ * const disposables = new DisposableStore();
+ *
+ * disposables.add(server.onRequest('textDocument/hover', handleHover));
+ * disposables.add(server.onRequest('textDocument/completion', handleCompletion));
+ *
+ * // Later — unregister all handlers at once
+ * disposables.dispose();
+ * ```
+ *
+ * @category Lifecycle
  */
 export class DisposableStore {
     disposables = [];
     disposed = false;
     /**
-     * Add a disposable to the store
+     * Add a disposable to the store.
+     *
+     * @param disposable - The resource to track. If the store is already disposed,
+     *   `disposable.dispose()` is called immediately.
+     * @returns The same `disposable` passed in, for fluent chaining.
      */
     add(disposable) {
         if (this.disposed) {

package/dist/utils/disposable.js.map

@@ -1 +1 @@
-{"version":3,"file":"disposable.js","sourceRoot":"","sources":["../../src/utils/disposable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;GAEG;AACH,MAAM,OAAO,eAAe;IAClB,WAAW,GAAiB,EAAE,CAAC;IAC/B,QAAQ,GAAG,KAAK,CAAC;IAEzB;;OAEG;IACH,GAAG,CAAuB,UAAa,EAAK;QAC1C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,UAAU,CAAC;IAAA,CACnB;IAED;;OAEG;IACH,OAAO,GAAS;QACd,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,2BAA2B;QAC3B,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAG,CAAC;YAC3C,IAAI,CAAC;gBACH,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IAAA,CACF;IAED;;OAEG;IACH,UAAU,GAAY;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC;IAAA,CACtB;IAED;;OAEG;IACH,KAAK,GAAS;QACZ,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IAAA,CACvB;CACF"}
+{"version":3,"file":"disposable.js","sourceRoot":"","sources":["../../src/utils/disposable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,OAAO,eAAe;IAClB,WAAW,GAAiB,EAAE,CAAC;IAC/B,QAAQ,GAAG,KAAK,CAAC;IAEzB;;;;;;OAMG;IACH,GAAG,CAAuB,UAAa;QACrC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,2BAA2B;QAC3B,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAG,CAAC;YAC3C,IAAI,CAAC;gBACH,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/utils/document.d.ts

@@ -1,23 +1,66 @@
 import type { DidChangeTextDocumentParams, Range } from 'vscode-languageserver-protocol';
 /**
- * Tracks per-document versions for change notifications.
+ * Tracks monotonically increasing version numbers for open text documents.
+ *
+ * @remarks
+ * The LSP spec requires `DidChangeTextDocumentParams.textDocument.version` to
+ * increment with every change notification. Use `DocumentVersionTracker` to
+ * manage version numbers centrally rather than maintaining ad-hoc counters in
+ * each document model.
+ *
+ * @useWhen
+ * You are building an LSP client that sends `textDocument/didChange`
+ * notifications and need to track per-document version counters.
+ *
+ * @never
+ * NEVER send a `textDocument/didChange` with the same version number as a
+ * previous change for the same document. The server may reject the change as
+ * a no-op or apply it out of order, causing text state desync.
+ *
+ * @example
+ * ```ts
+ * import { DocumentVersionTracker, createIncrementalDidChangeParams } from '@lspeasy/core';
+ *
+ * const tracker = new DocumentVersionTracker();
+ * tracker.open('file:///src/main.ts');
+ *
+ * const params = createIncrementalDidChangeParams(
+ *   'file:///src/main.ts',
+ *   [{ range: { start: { line: 0, character: 0 }, end: { line: 0, character: 5 } }, text: 'hello' }],
+ *   { tracker }
+ * );
+ * await client.sendNotification('textDocument/didChange', params);
+ * ```
+ *
+ * @category Document
  */
 export declare class DocumentVersionTracker {
     private readonly versions;
     /**
      * Starts tracking a document URI with an optional initial version.
+     *
+     * @param uri - The document URI to start tracking.
+     * @param initialVersion - Starting version number (defaults to `0`).
      */
     open(uri: string, initialVersion?: number): void;
     /**
      * Increments and returns the next document version.
+     *
+     * @param uri - The document URI to increment.
+     * @returns The incremented version number.
      */
     nextVersion(uri: string): number;
     /**
      * Returns the current tracked version, if any.
+     *
+     * @param uri - The document URI to query.
+     * @returns The current version number, or `undefined` if the document is not tracked.
      */
     currentVersion(uri: string): number | undefined;
     /**
      * Stops tracking a document URI.
+     *
+     * @param uri - The document URI to stop tracking.
      */
     close(uri: string): void;
 }
@@ -25,23 +68,55 @@ export declare class DocumentVersionTracker {
  * Source of version information for helper constructors.
  */
 export interface VersionSource {
+    /** Explicit version number to use; takes precedence over `tracker`. */
     version?: number;
+    /** A `DocumentVersionTracker` instance to auto-increment the version. */
     tracker?: DocumentVersionTracker;
 }
 /**
  * Represents a single incremental text document change.
  */
 export interface IncrementalChange {
+    /** The range in the document that was replaced. */
     range: Range;
+    /** The new text that replaced the range. */
     text: string;
+    /** Optional deprecated length of the replaced range, used by some servers for backwards compat. */
     rangeLength?: number;
 }
 /**
- * Creates incremental didChange params from one or more range edits.
+ * Builds `DidChangeTextDocumentParams` for an incremental (range-based)
+ * document change notification.
+ *
+ * @remarks
+ * Use when the client tracks individual edits (e.g. single-character
+ * insertions, deletions) rather than sending the full document text on each
+ * change. Requires the server to have `textDocumentSync.change = Incremental`.
+ *
+ * @param uri - The document URI.
+ * @param changes - One or more range-based text changes.
+ * @param source - Either an explicit `version` number or a `tracker` instance.
+ * @returns A `DidChangeTextDocumentParams` ready to send.
+ * @throws If neither `version` nor `tracker` is provided.
+ *
+ * @category Document
  */
 export declare function createIncrementalDidChangeParams(uri: string, changes: IncrementalChange[], source: VersionSource): DidChangeTextDocumentParams;
 /**
- * Creates full-document didChange params for full text replacement.
+ * Builds `DidChangeTextDocumentParams` for a full-document text replacement.
+ *
+ * @remarks
+ * Use when the server only supports full-text synchronisation
+ * (`textDocumentSync.change = Full`) or when tracking individual edits is
+ * impractical (e.g. clipboard paste of a large file).
+ *
+ * @param uri - The document URI.
+ * @param text - The complete new document text.
+ * @param source - Either an explicit `version` number or a `tracker` instance.
+ * @returns A `DidChangeTextDocumentParams` ready to send.
+ * @throws If neither `version` nor `tracker` is provided.
+ *
+ * @category Document
  */
 export declare function createFullDidChangeParams(uri: string, text: string, source: VersionSource): DidChangeTextDocumentParams;
 //# sourceMappingURL=document.d.ts.map

package/dist/utils/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/utils/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,KAAK,EAGN,MAAM,gCAAgC,CAAC;AAExC;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IAEtD;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,GAAE,MAAU,GAAG,IAAI,CAElD;IAED;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/B;IAED;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE9C;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEvB;CACF;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAqBD;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,iBAAiB,EAAE,EAC5B,MAAM,EAAE,aAAa,GACpB,2BAA2B,CAY7B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,GACpB,2BAA2B,CAQ7B"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/utils/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,KAAK,EAGN,MAAM,gCAAgC,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IAEtD;;;;;OAKG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,GAAE,MAAU,GAAG,IAAI,CAElD;IAED;;;;;OAKG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/B;IAED;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE9C;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEvB;CACF;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,KAAK,EAAE,KAAK,CAAC;IACb,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAqBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,iBAAiB,EAAE,EAC5B,MAAM,EAAE,aAAa,GACpB,2BAA2B,CAY7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,GACpB,2BAA2B,CAQ7B"}

package/dist/utils/document.js

@@ -1,16 +1,54 @@
 /**
- * Tracks per-document versions for change notifications.
+ * Tracks monotonically increasing version numbers for open text documents.
+ *
+ * @remarks
+ * The LSP spec requires `DidChangeTextDocumentParams.textDocument.version` to
+ * increment with every change notification. Use `DocumentVersionTracker` to
+ * manage version numbers centrally rather than maintaining ad-hoc counters in
+ * each document model.
+ *
+ * @useWhen
+ * You are building an LSP client that sends `textDocument/didChange`
+ * notifications and need to track per-document version counters.
+ *
+ * @never
+ * NEVER send a `textDocument/didChange` with the same version number as a
+ * previous change for the same document. The server may reject the change as
+ * a no-op or apply it out of order, causing text state desync.
+ *
+ * @example
+ * ```ts
+ * import { DocumentVersionTracker, createIncrementalDidChangeParams } from '@lspeasy/core';
+ *
+ * const tracker = new DocumentVersionTracker();
+ * tracker.open('file:///src/main.ts');
+ *
+ * const params = createIncrementalDidChangeParams(
+ *   'file:///src/main.ts',
+ *   [{ range: { start: { line: 0, character: 0 }, end: { line: 0, character: 5 } }, text: 'hello' }],
+ *   { tracker }
+ * );
+ * await client.sendNotification('textDocument/didChange', params);
+ * ```
+ *
+ * @category Document
  */
 export class DocumentVersionTracker {
     versions = new Map();
     /**
      * Starts tracking a document URI with an optional initial version.
+     *
+     * @param uri - The document URI to start tracking.
+     * @param initialVersion - Starting version number (defaults to `0`).
      */
     open(uri, initialVersion = 0) {
         this.versions.set(uri, initialVersion);
     }
     /**
      * Increments and returns the next document version.
+     *
+     * @param uri - The document URI to increment.
+     * @returns The incremented version number.
      */
     nextVersion(uri) {
         const current = this.versions.get(uri) ?? 0;
@@ -20,12 +58,17 @@ export class DocumentVersionTracker {
     }
     /**
      * Returns the current tracked version, if any.
+     *
+     * @param uri - The document URI to query.
+     * @returns The current version number, or `undefined` if the document is not tracked.
      */
     currentVersion(uri) {
         return this.versions.get(uri);
     }
     /**
      * Stops tracking a document URI.
+     *
+     * @param uri - The document URI to stop tracking.
      */
     close(uri) {
         this.versions.delete(uri);
@@ -47,7 +90,21 @@ function createIdentifier(uri, version) {
     };
 }
 /**
- * Creates incremental didChange params from one or more range edits.
+ * Builds `DidChangeTextDocumentParams` for an incremental (range-based)
+ * document change notification.
+ *
+ * @remarks
+ * Use when the client tracks individual edits (e.g. single-character
+ * insertions, deletions) rather than sending the full document text on each
+ * change. Requires the server to have `textDocumentSync.change = Incremental`.
+ *
+ * @param uri - The document URI.
+ * @param changes - One or more range-based text changes.
+ * @param source - Either an explicit `version` number or a `tracker` instance.
+ * @returns A `DidChangeTextDocumentParams` ready to send.
+ * @throws If neither `version` nor `tracker` is provided.
+ *
+ * @category Document
  */
 export function createIncrementalDidChangeParams(uri, changes, source) {
     const version = resolveVersion(uri, source);
@@ -62,7 +119,20 @@ export function createIncrementalDidChangeParams(uri, changes, source) {
     };
 }
 /**
- * Creates full-document didChange params for full text replacement.
+ * Builds `DidChangeTextDocumentParams` for a full-document text replacement.
+ *
+ * @remarks
+ * Use when the server only supports full-text synchronisation
+ * (`textDocumentSync.change = Full`) or when tracking individual edits is
+ * impractical (e.g. clipboard paste of a large file).
+ *
+ * @param uri - The document URI.
+ * @param text - The complete new document text.
+ * @param source - Either an explicit `version` number or a `tracker` instance.
+ * @returns A `DidChangeTextDocumentParams` ready to send.
+ * @throws If neither `version` nor `tracker` is provided.
+ *
+ * @category Document
  */
 export function createFullDidChangeParams(uri, text, source) {
     const version = resolveVersion(uri, source);

package/dist/utils/document.js.map

@@ -1 +1 @@
-{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/utils/document.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,OAAO,sBAAsB;IAChB,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEtD;;OAEG;IACH,IAAI,CAAC,GAAW,EAAE,cAAc,GAAW,CAAC,EAAQ;QAClD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAAA,CACxC;IAED;;OAEG;IACH,WAAW,CAAC,GAAW,EAAU;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IAAA,CACb;IAED;;OAEG;IACH,cAAc,CAAC,GAAW,EAAsB;QAC9C,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAAA,CAC/B;IAED;;OAEG;IACH,KAAK,CAAC,GAAW,EAAQ;QACvB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAAA,CAC3B;CACF;AAmBD,SAAS,cAAc,CAAC,GAAW,EAAE,MAAqB,EAAU;IAClE,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;AAAA,CAC5F;AAED,SAAS,gBAAgB,CAAC,GAAW,EAAE,OAAe,EAAmC;IACvF,OAAO;QACL,GAAG;QACH,OAAO;KACR,CAAC;AAAA,CACH;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAC9C,GAAW,EACX,OAA4B,EAC5B,MAAqB,EACQ;IAC7B,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAqC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChF,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,YAAY,EAAE,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC;QAC5C,cAAc;KACf,CAAC;AAAA,CACH;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAW,EACX,IAAY,EACZ,MAAqB,EACQ;IAC7B,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAqC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpE,OAAO;QACL,YAAY,EAAE,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC;QAC5C,cAAc;KACf,CAAC;AAAA,CACH"}
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/utils/document.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,OAAO,sBAAsB;IAChB,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEtD;;;;;OAKG;IACH,IAAI,CAAC,GAAW,EAAE,cAAc,GAAW,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,GAAW;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,GAAW;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAW;QACf,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF;AAwBD,SAAS,cAAc,CAAC,GAAW,EAAE,MAAqB;IACxD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;AAC7F,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW,EAAE,OAAe;IACpD,OAAO;QACL,GAAG;QACH,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gCAAgC,CAC9C,GAAW,EACX,OAA4B,EAC5B,MAAqB;IAErB,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAqC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChF,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,YAAY,EAAE,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC;QAC5C,cAAc;KACf,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAW,EACX,IAAY,EACZ,MAAqB;IAErB,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAqC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpE,OAAO;QACL,YAAY,EAAE,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC;QAC5C,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/utils/errors.d.ts

@@ -2,7 +2,18 @@
  * LSP and JSON-RPC error codes
  */
 /**
- * JSON-RPC 2.0 error codes
+ * Numeric error codes defined by JSON-RPC 2.0 and the LSP specification.
+ *
+ * @remarks
+ * Use these constants when throwing `ResponseError` from request handlers
+ * so clients can programmatically distinguish error types.
+ *
+ * Ranges:
+ * - `-32700` to `-32600`: JSON-RPC 2.0 standard errors
+ * - `-32899` to `-32800`: LSP-reserved range
+ * - `-32099` to `-32000`: Application-defined errors
+ *
+ * @category Errors
  */
 export declare const JSONRPCErrorCode: {
     readonly ParseError: -32700;
@@ -23,14 +34,54 @@ export declare const JSONRPCErrorCode: {
  */
 export declare const ErrorMessage: Record<number, string>;
 /**
- * LSP Response Error
+ * An `Error` subclass that maps to a JSON-RPC 2.0 error response.
+ *
+ * @remarks
+ * Throw a `ResponseError` from any request handler to send a structured error
+ * response to the client. The framework catches it and converts it to the wire
+ * format automatically.
+ *
+ * Use the static factory methods (`ResponseError.invalidParams()`, etc.) for
+ * the standard JSON-RPC / LSP error codes rather than constructing raw codes.
+ *
+ * @useWhen
+ * A request handler needs to reject with a machine-readable error code that
+ * the client can act on (e.g. respond with `MethodNotFound` when a capability
+ * was not declared, or `InvalidParams` when schema validation fails).
+ *
+ * @avoidWhen
+ * You want to log a server-side error without sending an error to the client —
+ * throw a plain `Error` and handle it via `server.onError()` instead.
+ *
+ * @never
+ * NEVER throw `ResponseError` with a code outside the defined ranges without
+ * documenting it. Undocumented codes are opaque to clients and tools.
+ *
+ * @example
+ * ```ts
+ * import { ResponseError, JSONRPCErrorCode } from '@lspeasy/core';
+ * import { LSPServer } from '@lspeasy/server';
+ *
+ * const server = new LSPServer();
+ * server.onRequest('textDocument/hover', async (params) => {
+ *   const doc = getDocument(params.textDocument.uri);
+ *   if (!doc) {
+ *     throw ResponseError.invalidParams(`Unknown document: ${params.textDocument.uri}`);
+ *   }
+ *   return computeHover(doc, params.position);
+ * });
+ * ```
+ *
+ * @category Errors
  */
 export declare class ResponseError extends Error {
     readonly code: number;
     readonly data?: unknown;
     constructor(code: number, message: string, data?: unknown);
     /**
-     * Convert to JSON-RPC error object
+     * Serializes to the JSON-RPC wire format (`{ code, message, data? }`).
+     *
+     * @returns A plain object suitable for embedding in an `ErrorResponseMessage`.
      */
     toJSON(): {
         code: number;
@@ -38,31 +89,57 @@ export declare class ResponseError extends Error {
         data: unknown;
     };
     /**
-     * Create a parse error
+     * Create a parse error.
+     *
+     * @param message - Optional override for the default error message.
+     * @param data - Optional machine-readable error details.
+     * @returns A `ResponseError` with code {@link JSONRPCErrorCode.ParseError}.
      */
     static parseError(message?: string, data?: unknown): ResponseError;
     /**
-     * Create an invalid request error
+     * Create an invalid request error.
+     *
+     * @param message - Optional override for the default error message.
+     * @param data - Optional machine-readable error details.
+     * @returns A `ResponseError` with code {@link JSONRPCErrorCode.InvalidRequest}.
      */
     static invalidRequest(message?: string, data?: unknown): ResponseError;
     /**
-     * Create a method not found error
+     * Create a method not found error.
+     *
+     * @param method - The method name that was not found.
+     * @param data - Optional machine-readable error details.
+     * @returns A `ResponseError` with code {@link JSONRPCErrorCode.MethodNotFound}.
      */
     static methodNotFound(method: string, data?: unknown): ResponseError;
     /**
-     * Create an invalid params error
+     * Create an invalid params error.
+     *
+     * @param message - Optional override for the default error message.
+     * @param data - Optional machine-readable error details.
+     * @returns A `ResponseError` with code {@link JSONRPCErrorCode.InvalidParams}.
      */
     static invalidParams(message?: string, data?: unknown): ResponseError;
     /**
-     * Create an internal error
+     * Create an internal error.
+     *
+     * @param message - Optional override for the default error message.
+     * @param data - Optional machine-readable error details.
+     * @returns A `ResponseError` with code {@link JSONRPCErrorCode.InternalError}.
      */
     static internalError(message?: string, data?: unknown): ResponseError;
     /**
-     * Create a server not initialized error
+     * Create a server not initialized error.
+     *
+     * @param data - Optional machine-readable error details.
+     * @returns A `ResponseError` with code {@link JSONRPCErrorCode.ServerNotInitialized}.
      */
     static serverNotInitialized(data?: unknown): ResponseError;
     /**
-     * Create a request cancelled error
+     * Create a request cancelled error.
+     *
+     * @param data - Optional machine-readable error details.
+     * @returns A `ResponseError` with code {@link JSONRPCErrorCode.RequestCancelled}.
      */
     static requestCancelled(data?: unknown): ResponseError;
 }

package/dist/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAkBnB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAW/C,CAAC;AAEF;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAEpB,IAAI,EAAE,MAAM;aAEZ,IAAI,CAAC;IAHvB,YACkB,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,SAAS,EAI/B;IAED;;OAEG;IACH,MAAM;;;;MAML;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAMjE;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAMrE;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAEnE;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAMpE;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAMpE;IAED;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAMzD;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAMrD;CACF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB;aAE3B,UAAU,EAAE,CAAC,KAAK;aAClB,cAAc,EAAE,CAAC,KAAK;aACtB,cAAc,EAAE,CAAC,KAAK;aACtB,aAAa,EAAE,CAAC,KAAK;aACrB,aAAa,EAAE,CAAC,KAAK;aAGrB,oBAAoB,EAAE,CAAC,KAAK;aAC5B,gBAAgB,EAAE,CAAC,KAAK;aAGxB,gBAAgB,EAAE,CAAC,KAAK;aACxB,cAAc,EAAE,CAAC,KAAK;aACtB,gBAAgB,EAAE,CAAC,KAAK;aACxB,eAAe,EAAE,CAAC,KAAK;aACvB,eAAe,EAAE,CAAC,KAAK;CACf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAW/C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAEpB,IAAI,EAAE,MAAM;aAEZ,IAAI,CAAC,EAAE,OAAO;IAHhC,YACkB,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,OAAO,EAI/B;IAED;;;;OAIG;IACH,MAAM;QAEF,IAAI;QACJ,OAAO;QACP,IAAI;MAEP;IAED;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAMjE;IAED;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAMrE;IAED;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAEnE;IAED;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAMpE;IAED;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAMpE;IAED;;;;;OAKG;IACH,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAMzD;IAED;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAMrD;CACF"}

package/dist/utils/errors.js

@@ -2,7 +2,18 @@
  * LSP and JSON-RPC error codes
  */
 /**
- * JSON-RPC 2.0 error codes
+ * Numeric error codes defined by JSON-RPC 2.0 and the LSP specification.
+ *
+ * @remarks
+ * Use these constants when throwing `ResponseError` from request handlers
+ * so clients can programmatically distinguish error types.
+ *
+ * Ranges:
+ * - `-32700` to `-32600`: JSON-RPC 2.0 standard errors
+ * - `-32899` to `-32800`: LSP-reserved range
+ * - `-32099` to `-32000`: Application-defined errors
+ *
+ * @category Errors
  */
 export const JSONRPCErrorCode = {
     // Standard JSON-RPC 2.0 errors
@@ -37,7 +48,45 @@ export const ErrorMessage = {
     [JSONRPCErrorCode.ServerCancelled]: 'Server cancelled'
 };
 /**
- * LSP Response Error
+ * An `Error` subclass that maps to a JSON-RPC 2.0 error response.
+ *
+ * @remarks
+ * Throw a `ResponseError` from any request handler to send a structured error
+ * response to the client. The framework catches it and converts it to the wire
+ * format automatically.
+ *
+ * Use the static factory methods (`ResponseError.invalidParams()`, etc.) for
+ * the standard JSON-RPC / LSP error codes rather than constructing raw codes.
+ *
+ * @useWhen
+ * A request handler needs to reject with a machine-readable error code that
+ * the client can act on (e.g. respond with `MethodNotFound` when a capability
+ * was not declared, or `InvalidParams` when schema validation fails).
+ *
+ * @avoidWhen
+ * You want to log a server-side error without sending an error to the client —
+ * throw a plain `Error` and handle it via `server.onError()` instead.
+ *
+ * @never
+ * NEVER throw `ResponseError` with a code outside the defined ranges without
+ * documenting it. Undocumented codes are opaque to clients and tools.
+ *
+ * @example
+ * ```ts
+ * import { ResponseError, JSONRPCErrorCode } from '@lspeasy/core';
+ * import { LSPServer } from '@lspeasy/server';
+ *
+ * const server = new LSPServer();
+ * server.onRequest('textDocument/hover', async (params) => {
+ *   const doc = getDocument(params.textDocument.uri);
+ *   if (!doc) {
+ *     throw ResponseError.invalidParams(`Unknown document: ${params.textDocument.uri}`);
+ *   }
+ *   return computeHover(doc, params.position);
+ * });
+ * ```
+ *
+ * @category Errors
  */
 export class ResponseError extends Error {
     code;
@@ -49,7 +98,9 @@ export class ResponseError extends Error {
         this.name = 'ResponseError';
     }
     /**
-     * Convert to JSON-RPC error object
+     * Serializes to the JSON-RPC wire format (`{ code, message, data? }`).
+     *
+     * @returns A plain object suitable for embedding in an `ErrorResponseMessage`.
      */
     toJSON() {
         return {
@@ -59,43 +110,69 @@ export class ResponseError extends Error {
         };
     }
     /**
-     * Create a parse error
+     * Create a parse error.
+     *
+     * @param message - Optional override for the default error message.
+     * @param data - Optional machine-readable error details.
+     * @returns A `ResponseError` with code {@link JSONRPCErrorCode.ParseError}.
      */
     static parseError(message, data) {
         return new ResponseError(JSONRPCErrorCode.ParseError, message ?? ErrorMessage[JSONRPCErrorCode.ParseError] ?? 'Parse error', data);
     }
     /**
-     * Create an invalid request error
+     * Create an invalid request error.
+     *
+     * @param message - Optional override for the default error message.
+     * @param data - Optional machine-readable error details.
+     * @returns A `ResponseError` with code {@link JSONRPCErrorCode.InvalidRequest}.
      */
     static invalidRequest(message, data) {
         return new ResponseError(JSONRPCErrorCode.InvalidRequest, message ?? ErrorMessage[JSONRPCErrorCode.InvalidRequest] ?? 'Invalid request', data);
     }
     /**
-     * Create a method not found error
+     * Create a method not found error.
+     *
+     * @param method - The method name that was not found.
+     * @param data - Optional machine-readable error details.
+     * @returns A `ResponseError` with code {@link JSONRPCErrorCode.MethodNotFound}.
      */
     static methodNotFound(method, data) {
         return new ResponseError(JSONRPCErrorCode.MethodNotFound, `Method not found: ${method}`, data);
     }
     /**
-     * Create an invalid params error
+     * Create an invalid params error.
+     *
+     * @param message - Optional override for the default error message.
+     * @param data - Optional machine-readable error details.
+     * @returns A `ResponseError` with code {@link JSONRPCErrorCode.InvalidParams}.
      */
     static invalidParams(message, data) {
         return new ResponseError(JSONRPCErrorCode.InvalidParams, message ?? ErrorMessage[JSONRPCErrorCode.InvalidParams] ?? 'Invalid params', data);
     }
     /**
-     * Create an internal error
+     * Create an internal error.
+     *
+     * @param message - Optional override for the default error message.
+     * @param data - Optional machine-readable error details.
+     * @returns A `ResponseError` with code {@link JSONRPCErrorCode.InternalError}.
      */
     static internalError(message, data) {
         return new ResponseError(JSONRPCErrorCode.InternalError, message ?? ErrorMessage[JSONRPCErrorCode.InternalError] ?? 'Internal error', data);
     }
     /**
-     * Create a server not initialized error
+     * Create a server not initialized error.
+     *
+     * @param data - Optional machine-readable error details.
+     * @returns A `ResponseError` with code {@link JSONRPCErrorCode.ServerNotInitialized}.
      */
     static serverNotInitialized(data) {
         return new ResponseError(JSONRPCErrorCode.ServerNotInitialized, ErrorMessage[JSONRPCErrorCode.ServerNotInitialized] ?? 'Server not initialized', data);
     }
     /**
-     * Create a request cancelled error
+     * Create a request cancelled error.
+     *
+     * @param data - Optional machine-readable error details.
+     * @returns A `ResponseError` with code {@link JSONRPCErrorCode.RequestCancelled}.
      */
     static requestCancelled(data) {
         return new ResponseError(JSONRPCErrorCode.RequestCancelled, ErrorMessage[JSONRPCErrorCode.RequestCancelled] ?? 'Request cancelled', data);

package/dist/utils/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"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"}

package/dist/utils/handler-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"handler-registry.js","sourceRoot":"","sources":["../../src/utils/handler-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH;;GAEG;AACH,MAAM,OAAO,eAAe;IAClB,QAAQ,GAAG,IAAI,GAAG,EAA+C,CAAC;IAClE,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEpD;;OAEG;IACH,QAAQ,CAAC,MAAc,EAAE,OAA4C,EAAc;QACjF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAEzB,OAAO;YACL,OAAO,EAAE,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAAA,CACzB;SACF,CAAC;IAAA,CACH;IAED;;OAEG;IACH,UAAU,CAAC,MAAc,EAAQ;QAC/B,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;IAAA,CACF;IAED;;OAEG;IACH,GAAG,CAAC,MAAc,EAAmD;QACnE,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAAA,CAClC;IAED;;OAEG;IACH,KAAK,GAAS;QACZ,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAAA,CACzB;IAEO,WAAW,CAAC,MAAc,EAAQ;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAAA,CACrB;IAEO,cAAc,CAAC,MAAc,EAAQ;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvB,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;IAAA,CACF;IAEO,SAAS,CAAC,MAAc,EAAU;QACxC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAAA,CACvD;CACF"}
+{"version":3,"file":"handler-registry.js","sourceRoot":"","sources":["../../src/utils/handler-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH;;GAEG;AACH,MAAM,OAAO,eAAe;IAClB,QAAQ,GAAG,IAAI,GAAG,EAA+C,CAAC;IAClE,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEpD;;OAEG;IACH,QAAQ,CAAC,MAAc,EAAE,OAA4C;QACnE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAEzB,OAAO;YACL,OAAO,EAAE,GAAG,EAAE;gBACZ,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,MAAc;QACvB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAEO,WAAW,CAAC,MAAc;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAEO,cAAc,CAAC,MAAc;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvB,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,MAAc;QAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;CACF"}