@singapore-editor/lsp-plugin 0.1.1

package/dist/signatureHelpController.js

@@ -0,0 +1,160 @@
+import { formatSignatureHelp, nextSignatureIndex, signatureHelpTriggerFromTypedText } from "./signatureHelp.js";
+import { offsetToLspPositionInSnapshot } from "@singapore-editor/lsp";
+import { anchoredSurfaceFollowsUpdate } from "@singapore-editor/plugin-ui/anchored-surface";
+import { createTooltipController } from "@singapore-editor/plugin-ui/tooltip";
+//#region src/signatureHelpController.ts
+/**
+* Shows the signature of the call the caret is inside, requested when an argument list opens or the
+* caret moves to the next argument.
+*
+* Reuses the hover tooltip rather than introducing a second floating surface, so signature text
+* inherits the same theming, markdown rendering, and placement behaviour.
+*/
+var SignatureHelpController = class {
+	options;
+	context;
+	tooltip;
+	abort = null;
+	requestId = 0;
+	currentTheme = null;
+	lastHelp = null;
+	display = null;
+	disposed = false;
+	keymapKeys;
+	constructor(options) {
+		this.options = options;
+		this.context = options.context;
+		this.tooltip = createTooltipController({
+			classNamespace: options.tooltipClassNamespace ?? "lsp-plugin",
+			document: this.context.container.ownerDocument,
+			reentryElement: this.context.scrollElement,
+			themeSource: this.context.scrollElement
+		});
+		this.keymapKeys = [this.context.registerKeymapContextKey("parameterHintsVisible", () => this.display !== null), this.context.registerKeymapContextKey("parameterHintsMultipleSignatures", () => (this.display?.signatureCount ?? 0) > 1)];
+	}
+	update(snapshot, kind) {
+		this.currentTheme = snapshot.theme ?? null;
+		if (kind === "document" || kind === "clear") {
+			this.hide();
+			return;
+		}
+		if (anchoredSurfaceFollowsUpdate(kind)) this.reanchor();
+	}
+	/** The keystroke, not the edit it caused; see signatureHelpTriggerFromTypedText. */
+	handleTypedText(text) {
+		const trigger = signatureHelpTriggerFromTypedText(text);
+		if (!trigger) return;
+		if (trigger.kind === "close") {
+			this.hide();
+			return;
+		}
+		this.request(trigger.triggerCharacter);
+	}
+	hide() {
+		this.abort?.abort();
+		this.abort = null;
+		this.lastHelp = null;
+		this.display = null;
+		this.tooltip.hide();
+	}
+	containsTarget(target) {
+		return this.tooltip.containsTarget(target);
+	}
+	dispose() {
+		if (this.disposed) return;
+		this.disposed = true;
+		for (const key of this.keymapKeys) key.dispose();
+		this.hide();
+		this.tooltip.dispose();
+	}
+	/** The keymap's commands; false when there is nothing on screen for them to act on. */
+	runKeyCommand(command) {
+		const display = this.display;
+		if (!display) return false;
+		if (command === "close") {
+			this.hide();
+			return true;
+		}
+		if (display.signatureCount < 2) return false;
+		const delta = command === "next" ? 1 : -1;
+		this.showSignature(nextSignatureIndex(display.activeSignature, display.signatureCount, delta));
+		return true;
+	}
+	async request(triggerCharacter) {
+		const active = this.options.getActiveDocument();
+		const selection = this.context.getSnapshot().selections[0];
+		if (!active || !selection) {
+			this.hide();
+			return;
+		}
+		if (!this.options.router.hasReady("signatureHelp", "textDocument/signatureHelp")) return;
+		this.abort?.abort();
+		const abort = new AbortController();
+		const requestId = this.requestId + 1;
+		this.requestId = requestId;
+		this.abort = abort;
+		try {
+			const help = await this.options.router.request("textDocument/signatureHelp", {
+				context: {
+					isRetrigger: false,
+					triggerCharacter,
+					triggerKind: 2
+				},
+				position: offsetToLspPositionInSnapshot(active, selection.headOffset),
+				textDocument: { uri: active.uri }
+			}, { signal: abort.signal });
+			this.options.onRequestSuccess?.();
+			if (requestId !== this.requestId) return;
+			if (this.disposed) return;
+			if (active !== this.options.getActiveDocument()) return;
+			this.lastHelp = help ?? null;
+			this.showSignature(help?.activeSignature ?? 0);
+		} catch (error) {
+			this.options.onRequestError(error);
+		}
+	}
+	showSignature(signatureIndex) {
+		const display = formatSignatureHelp(this.lastHelp, signatureIndex);
+		this.display = display;
+		if (!display) {
+			this.tooltip.hide();
+			return;
+		}
+		const anchor = this.caretAnchor();
+		if (!anchor) {
+			this.tooltip.hide();
+			return;
+		}
+		this.tooltip.show({
+			anchor,
+			hoverText: display.markdown,
+			preferredPlacement: "top",
+			theme: this.currentTheme
+		});
+	}
+	/**
+	* Follows the caret when the view moves under the signature.
+	*
+	* The call being typed is where the signature belongs, and a caret that has scrolled out of the
+	* rendered rows has no rect to belong to any more — leaving the widget parked over unrelated code
+	* is worse than losing it, and the next keystroke in the argument list asks for it again.
+	*/
+	reanchor() {
+		if (!this.display) return;
+		const anchor = this.caretAnchor();
+		if (!anchor) {
+			this.hide();
+			return;
+		}
+		this.tooltip.reanchor(anchor);
+	}
+	caretAnchor() {
+		const selection = this.context.getSnapshot().selections[0];
+		if (!selection) return null;
+		return this.context.getRangeClientRect(selection.headOffset, selection.headOffset);
+	}
+};
+//#endregion
+export { SignatureHelpController };
+
+//# sourceMappingURL=signatureHelpController.js.map

package/dist/signatureHelpController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signatureHelpController.js","names":[],"sources":["../src/signatureHelpController.ts"],"sourcesContent":["import type * as lsp from 'vscode-languageserver-protocol'\n\nimport type {\n  EditorDisposable,\n  EditorTheme,\n  EditorViewContributionContext,\n  EditorViewContributionUpdateKind,\n  EditorViewSnapshot,\n} from '@singapore-editor/core'\nimport { offsetToLspPositionInSnapshot } from '@singapore-editor/lsp'\n\nimport type { ActiveDocument } from './pluginTypes'\nimport type { SignatureHelpKeyCommand } from './keyCommands'\nimport type { LanguageServerFeatureRouter } from './serverSet'\nimport {\n  formatSignatureHelp,\n  nextSignatureIndex,\n  signatureHelpTriggerFromTypedText,\n  type SignatureHelpDisplay,\n} from './signatureHelp'\nimport { anchoredSurfaceFollowsUpdate } from '@singapore-editor/plugin-ui/anchored-surface'\nimport {\n  type TooltipController,\n  createTooltipController,\n} from '@singapore-editor/plugin-ui/tooltip'\n\nexport type SignatureHelpControllerOptions = {\n  readonly context: EditorViewContributionContext\n  readonly router: LanguageServerFeatureRouter\n  readonly getActiveDocument: () => ActiveDocument | null\n  readonly tooltipClassNamespace?: string\n  readonly onRequestSuccess?: () => void\n  readonly onRequestError: (error: unknown) => void\n}\n\n/**\n * Shows the signature of the call the caret is inside, requested when an argument list opens or the\n * caret moves to the next argument.\n *\n * Reuses the hover tooltip rather than introducing a second floating surface, so signature text\n * inherits the same theming, markdown rendering, and placement behaviour.\n */\nexport class SignatureHelpController {\n  private readonly context: EditorViewContributionContext\n  private readonly tooltip: TooltipController\n  private abort: AbortController | null = null\n  private requestId = 0\n  private currentTheme: EditorTheme | null = null\n  private lastHelp: lsp.SignatureHelp | null = null\n  private display: SignatureHelpDisplay | null = null\n  private disposed = false\n  private readonly keymapKeys: readonly EditorDisposable[]\n\n  public constructor(private readonly options: SignatureHelpControllerOptions) {\n    this.context = options.context\n    this.tooltip = createTooltipController({\n      classNamespace: options.tooltipClassNamespace ?? 'lsp-plugin',\n      document: this.context.container.ownerDocument,\n      reentryElement: this.context.scrollElement,\n      themeSource: this.context.scrollElement,\n    })\n    this.keymapKeys = [\n      this.context.registerKeymapContextKey('parameterHintsVisible', () => this.display !== null),\n      this.context.registerKeymapContextKey(\n        'parameterHintsMultipleSignatures',\n        () => (this.display?.signatureCount ?? 0) > 1,\n      ),\n    ]\n  }\n\n  public update(snapshot: EditorViewSnapshot, kind: EditorViewContributionUpdateKind): void {\n    this.currentTheme = snapshot.theme ?? null\n    if (kind === 'document' || kind === 'clear') {\n      this.hide()\n      return\n    }\n    if (anchoredSurfaceFollowsUpdate(kind)) this.reanchor()\n  }\n\n  /** The keystroke, not the edit it caused; see signatureHelpTriggerFromTypedText. */\n  public handleTypedText(text: string): void {\n    const trigger = signatureHelpTriggerFromTypedText(text)\n    if (!trigger) return\n    if (trigger.kind === 'close') {\n      this.hide()\n      return\n    }\n\n    void this.request(trigger.triggerCharacter)\n  }\n\n  public hide(): void {\n    this.abort?.abort()\n    this.abort = null\n    this.lastHelp = null\n    this.display = null\n    this.tooltip.hide()\n  }\n\n  public containsTarget(target: EventTarget | null): boolean {\n    return this.tooltip.containsTarget(target)\n  }\n\n  public dispose(): void {\n    if (this.disposed) return\n\n    this.disposed = true\n    for (const key of this.keymapKeys) key.dispose()\n    this.hide()\n    this.tooltip.dispose()\n  }\n\n  /** The keymap's commands; false when there is nothing on screen for them to act on. */\n  public runKeyCommand(command: SignatureHelpKeyCommand): boolean {\n    const display = this.display\n    if (!display) return false\n    if (command === 'close') {\n      this.hide()\n      return true\n    }\n    if (display.signatureCount < 2) return false\n\n    const delta = command === 'next' ? 1 : -1\n    this.showSignature(nextSignatureIndex(display.activeSignature, display.signatureCount, delta))\n    return true\n  }\n\n  private async request(triggerCharacter: '(' | ','): Promise<void> {\n    const active = this.options.getActiveDocument()\n    const selection = this.context.getSnapshot().selections[0]\n    if (!active || !selection) {\n      this.hide()\n      return\n    }\n    if (!this.options.router.hasReady('signatureHelp', 'textDocument/signatureHelp')) return\n\n    this.abort?.abort()\n    const abort = new AbortController()\n    const requestId = this.requestId + 1\n    this.requestId = requestId\n    this.abort = abort\n\n    try {\n      const help = await this.options.router.request<lsp.SignatureHelp | null>(\n        'textDocument/signatureHelp',\n        {\n          context: { isRetrigger: false, triggerCharacter, triggerKind: 2 },\n          position: offsetToLspPositionInSnapshot(active, selection.headOffset),\n          textDocument: { uri: active.uri },\n        },\n        { signal: abort.signal },\n      )\n      this.options.onRequestSuccess?.()\n      // A newer request, a document swap, or a teardown between send and receive all mean this\n      // answer describes a call the caret is no longer in.\n      if (requestId !== this.requestId) return\n      if (this.disposed) return\n      if (active !== this.options.getActiveDocument()) return\n\n      this.lastHelp = help ?? null\n      this.showSignature(help?.activeSignature ?? 0)\n    } catch (error) {\n      this.options.onRequestError(error)\n    }\n  }\n\n  private showSignature(signatureIndex: number): void {\n    const display = formatSignatureHelp(this.lastHelp, signatureIndex)\n    this.display = display\n    if (!display) {\n      this.tooltip.hide()\n      return\n    }\n\n    const anchor = this.caretAnchor()\n    if (!anchor) {\n      this.tooltip.hide()\n      return\n    }\n\n    this.tooltip.show({\n      anchor,\n      hoverText: display.markdown,\n      // Above the caret: the argument being typed sits below it, and covering that is the one\n      // thing the widget must not do.\n      preferredPlacement: 'top',\n      theme: this.currentTheme,\n    })\n  }\n\n  /**\n   * Follows the caret when the view moves under the signature.\n   *\n   * The call being typed is where the signature belongs, and a caret that has scrolled out of the\n   * rendered rows has no rect to belong to any more — leaving the widget parked over unrelated code\n   * is worse than losing it, and the next keystroke in the argument list asks for it again.\n   */\n  private reanchor(): void {\n    if (!this.display) return\n\n    const anchor = this.caretAnchor()\n    if (!anchor) {\n      this.hide()\n      return\n    }\n\n    this.tooltip.reanchor(anchor)\n  }\n\n  private caretAnchor(): DOMRect | null {\n    const selection = this.context.getSnapshot().selections[0]\n    if (!selection) return null\n\n    return this.context.getRangeClientRect(selection.headOffset, selection.headOffset)\n  }\n}\n"],"mappings":"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"}

package/dist/sourceText.d.ts

@@ -0,0 +1,22 @@
+import type { TextReadSnapshot } from '@singapore-editor/core/document';
+import type { LspTextDocumentSnapshot } from '@singapore-editor/lsp';
+import type { OffsetRange } from '@singapore-editor/plugin-ui/offset-range';
+type RowBounds = {
+    readonly start: number;
+    /** The row's break, or the document end for the last row. */
+    readonly end: number;
+    /** The next row's start, or the document end: the row with its break. */
+    readonly next: number;
+};
+export declare function rowBounds(document: LspTextDocumentSnapshot, offset: number): RowBounds;
+/** One code unit, or '' outside the document. */
+export declare function characterAt(document: LspTextDocumentSnapshot, offset: number): string;
+/**
+ * Runs a line-local finder over a window of the row around `offset`, break included, widening it
+ * while the answer reaches a clipped edge. Finding a word never copies a long row whole.
+ */
+export declare function rangeAroundOffset<Found extends OffsetRange | null>(document: LspTextDocumentSnapshot, offset: number, find: (text: string, offset: number) => Found): Found;
+/** Line queries over an LSP document, for a core helper that takes a read source. */
+export declare function textReadSnapshotOf(document: LspTextDocumentSnapshot): TextReadSnapshot;
+export {};
+//# sourceMappingURL=sourceText.d.ts.map

package/dist/sourceText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceText.d.ts","sourceRoot":"","sources":["../src/sourceText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAA;AAI3E,KAAK,SAAS,GAAG;IACf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAOtF;AAED,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGrF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,SAAS,WAAW,GAAG,IAAI,EAChE,QAAQ,EAAE,uBAAuB,EACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,KAAK,GAC5C,KAAK,CAUP;AAaD,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,gBAAgB,CAkBtF"}

package/dist/sourceText.js

@@ -0,0 +1,70 @@
+//#region src/sourceText.ts
+var INITIAL_RADIUS = 256;
+function rowBounds(document, offset) {
+	const length = document.textSnapshot.length;
+	const row = document.lineStarts.indexForOffset(Math.max(0, Math.min(offset, length)));
+	const start = document.lineStarts.at(row) ?? 0;
+	const nextStart = document.lineStarts.at(row + 1);
+	if (nextStart === void 0) return {
+		start,
+		end: length,
+		next: length
+	};
+	return {
+		start,
+		end: Math.max(start, nextStart - 1),
+		next: nextStart
+	};
+}
+/** One code unit, or '' outside the document. */
+function characterAt(document, offset) {
+	if (offset < 0 || offset >= document.textSnapshot.length) return "";
+	return document.textSnapshot.readRange(offset, offset + 1);
+}
+/**
+* Runs a line-local finder over a window of the row around `offset`, break included, widening it
+* while the answer reaches a clipped edge. Finding a word never copies a long row whole.
+*/
+function rangeAroundOffset(document, offset, find) {
+	const row = rowBounds(document, offset);
+	for (let radius = INITIAL_RADIUS;; radius *= 2) {
+		const from = Math.max(row.start, offset - radius);
+		const to = Math.min(row.next, offset + radius);
+		const found = find(document.textSnapshot.readRange(from, to), offset - from);
+		const range = found ? {
+			start: from + found.start,
+			end: from + found.end
+		} : found;
+		if (!reachesClippedEdge(range, from, to, row)) return range;
+	}
+}
+function reachesClippedEdge(range, from, to, row) {
+	if (!range) return false;
+	if (range.start <= from && from > row.start) return true;
+	return range.end >= to && to < row.next;
+}
+/** Line queries over an LSP document, for a core helper that takes a read source. */
+function textReadSnapshotOf(document) {
+	const { lineStarts, textSnapshot } = document;
+	const lineStart = (lineIndex) => lineStarts.at(Math.max(0, lineIndex)) ?? textSnapshot.length;
+	return {
+		length: textSnapshot.length,
+		lineCount: Math.max(1, lineStarts.length),
+		lineStart,
+		lineRange: (lineIndex) => {
+			const row = Math.max(0, lineIndex);
+			const next = lineStarts.at(row + 1);
+			return {
+				start: lineStart(row),
+				end: next === void 0 ? textSnapshot.length : next - 1
+			};
+		},
+		lineAt: (offset) => lineStarts.indexForOffset(Math.max(0, Math.min(offset, textSnapshot.length))),
+		readRange: (start, end) => textSnapshot.readRange(start, end),
+		forEachTextChunk: (visit) => textSnapshot.forEachTextChunk(visit)
+	};
+}
+//#endregion
+export { characterAt, rangeAroundOffset, rowBounds, textReadSnapshotOf };
+
+//# sourceMappingURL=sourceText.js.map

package/dist/sourceText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceText.js","names":[],"sources":["../src/sourceText.ts"],"sourcesContent":["import type { TextReadSnapshot } from '@singapore-editor/core/document'\nimport type { LspTextDocumentSnapshot } from '@singapore-editor/lsp'\nimport type { OffsetRange } from '@singapore-editor/plugin-ui/offset-range'\n\nconst INITIAL_RADIUS = 256\n\ntype RowBounds = {\n  readonly start: number\n  /** The row's break, or the document end for the last row. */\n  readonly end: number\n  /** The next row's start, or the document end: the row with its break. */\n  readonly next: number\n}\n\nexport function rowBounds(document: LspTextDocumentSnapshot, offset: number): RowBounds {\n  const length = document.textSnapshot.length\n  const row = document.lineStarts.indexForOffset(Math.max(0, Math.min(offset, length)))\n  const start = document.lineStarts.at(row) ?? 0\n  const nextStart = document.lineStarts.at(row + 1)\n  if (nextStart === undefined) return { start, end: length, next: length }\n  return { start, end: Math.max(start, nextStart - 1), next: nextStart }\n}\n\n/** One code unit, or '' outside the document. */\nexport function characterAt(document: LspTextDocumentSnapshot, offset: number): string {\n  if (offset < 0 || offset >= document.textSnapshot.length) return ''\n  return document.textSnapshot.readRange(offset, offset + 1)\n}\n\n/**\n * Runs a line-local finder over a window of the row around `offset`, break included, widening it\n * while the answer reaches a clipped edge. Finding a word never copies a long row whole.\n */\nexport function rangeAroundOffset<Found extends OffsetRange | null>(\n  document: LspTextDocumentSnapshot,\n  offset: number,\n  find: (text: string, offset: number) => Found,\n): Found {\n  const row = rowBounds(document, offset)\n  for (let radius = INITIAL_RADIUS; ; radius *= 2) {\n    const from = Math.max(row.start, offset - radius)\n    const to = Math.min(row.next, offset + radius)\n    const found = find(document.textSnapshot.readRange(from, to), offset - from)\n    // Shifting keeps the finder's own null-or-range shape, so a finder that always answers stays so.\n    const range = (found ? { start: from + found.start, end: from + found.end } : found) as Found\n    if (!reachesClippedEdge(range, from, to, row)) return range\n  }\n}\n\nfunction reachesClippedEdge(\n  range: OffsetRange | null,\n  from: number,\n  to: number,\n  row: RowBounds,\n): boolean {\n  if (!range) return false\n  if (range.start <= from && from > row.start) return true\n  return range.end >= to && to < row.next\n}\n\n/** Line queries over an LSP document, for a core helper that takes a read source. */\nexport function textReadSnapshotOf(document: LspTextDocumentSnapshot): TextReadSnapshot {\n  const { lineStarts, textSnapshot } = document\n  const lineStart = (lineIndex: number): number =>\n    lineStarts.at(Math.max(0, lineIndex)) ?? textSnapshot.length\n  return {\n    length: textSnapshot.length,\n    lineCount: Math.max(1, lineStarts.length),\n    lineStart,\n    lineRange: (lineIndex) => {\n      const row = Math.max(0, lineIndex)\n      const next = lineStarts.at(row + 1)\n      return { start: lineStart(row), end: next === undefined ? textSnapshot.length : next - 1 }\n    },\n    lineAt: (offset) =>\n      lineStarts.indexForOffset(Math.max(0, Math.min(offset, textSnapshot.length))),\n    readRange: (start, end) => textSnapshot.readRange(start, end),\n    forEachTextChunk: (visit) => textSnapshot.forEachTextChunk(visit),\n  }\n}\n"],"mappings":";AAIA,IAAM,iBAAiB;AAUvB,SAAgB,UAAU,UAAmC,QAA2B;CACtF,MAAM,SAAS,SAAS,aAAa;CACrC,MAAM,MAAM,SAAS,WAAW,eAAe,KAAK,IAAI,GAAG,KAAK,IAAI,QAAQ,MAAM,CAAC,CAAC;CACpF,MAAM,QAAQ,SAAS,WAAW,GAAG,GAAG,KAAK;CAC7C,MAAM,YAAY,SAAS,WAAW,GAAG,MAAM,CAAC;CAChD,IAAI,cAAc,KAAA,GAAW,OAAO;EAAE;EAAO,KAAK;EAAQ,MAAM;CAAO;CACvE,OAAO;EAAE;EAAO,KAAK,KAAK,IAAI,OAAO,YAAY,CAAC;EAAG,MAAM;CAAU;AACvE;;AAGA,SAAgB,YAAY,UAAmC,QAAwB;CACrF,IAAI,SAAS,KAAK,UAAU,SAAS,aAAa,QAAQ,OAAO;CACjE,OAAO,SAAS,aAAa,UAAU,QAAQ,SAAS,CAAC;AAC3D;;;;;AAMA,SAAgB,kBACd,UACA,QACA,MACO;CACP,MAAM,MAAM,UAAU,UAAU,MAAM;CACtC,KAAK,IAAI,SAAS,iBAAkB,UAAU,GAAG;EAC/C,MAAM,OAAO,KAAK,IAAI,IAAI,OAAO,SAAS,MAAM;EAChD,MAAM,KAAK,KAAK,IAAI,IAAI,MAAM,SAAS,MAAM;EAC7C,MAAM,QAAQ,KAAK,SAAS,aAAa,UAAU,MAAM,EAAE,GAAG,SAAS,IAAI;EAE3E,MAAM,QAAS,QAAQ;GAAE,OAAO,OAAO,MAAM;GAAO,KAAK,OAAO,MAAM;EAAI,IAAI;EAC9E,IAAI,CAAC,mBAAmB,OAAO,MAAM,IAAI,GAAG,GAAG,OAAO;CACxD;AACF;AAEA,SAAS,mBACP,OACA,MACA,IACA,KACS;CACT,IAAI,CAAC,OAAO,OAAO;CACnB,IAAI,MAAM,SAAS,QAAQ,OAAO,IAAI,OAAO,OAAO;CACpD,OAAO,MAAM,OAAO,MAAM,KAAK,IAAI;AACrC;;AAGA,SAAgB,mBAAmB,UAAqD;CACtF,MAAM,EAAE,YAAY,iBAAiB;CACrC,MAAM,aAAa,cACjB,WAAW,GAAG,KAAK,IAAI,GAAG,SAAS,CAAC,KAAK,aAAa;CACxD,OAAO;EACL,QAAQ,aAAa;EACrB,WAAW,KAAK,IAAI,GAAG,WAAW,MAAM;EACxC;EACA,YAAY,cAAc;GACxB,MAAM,MAAM,KAAK,IAAI,GAAG,SAAS;GACjC,MAAM,OAAO,WAAW,GAAG,MAAM,CAAC;GAClC,OAAO;IAAE,OAAO,UAAU,GAAG;IAAG,KAAK,SAAS,KAAA,IAAY,aAAa,SAAS,OAAO;GAAE;EAC3F;EACA,SAAS,WACP,WAAW,eAAe,KAAK,IAAI,GAAG,KAAK,IAAI,QAAQ,aAAa,MAAM,CAAC,CAAC;EAC9E,YAAY,OAAO,QAAQ,aAAa,UAAU,OAAO,GAAG;EAC5D,mBAAmB,UAAU,aAAa,iBAAiB,KAAK;CAClE;AACF"}

package/dist/types.d.ts

@@ -0,0 +1,238 @@
+import type { TooltipAction } from '@singapore-editor/plugin-ui/tooltip';
+import type { LanguageServerDocument } from './document';
+import type { DocumentLogicalRevisionScope } from '@singapore-editor/core/document';
+import type { EditorDisposable, EditorPlugin, EditorTextAnchor, EditorViewSnapshot } from '@singapore-editor/core/extensions';
+import type { LspClient, LspNotificationHandler, LspServerRequestHandler, LspWebSocketTransportOptions } from '@singapore-editor/lsp';
+import type * as lsp from 'vscode-languageserver-protocol';
+import type { LanguageServerConnectionContext } from './connectionContext';
+import type { LanguageServerDocumentSyncController } from './documentSyncController';
+import type { LspConnectionProvider, LspReconnectOptions } from './lspConnection';
+import type { ParsedWorkspaceEdit } from './workspaceEdit';
+import type { WorkspaceTextDocumentProvenance } from './workspaceTextEdits';
+export type { LanguageServerConnectionContext } from './connectionContext';
+import type { LanguageServerSemanticTokensFactory, LanguageServerSemanticTokensOptions } from './semanticTokens';
+export type LanguageServerStatus = 'idle' | 'loading' | 'ready' | 'error';
+export declare const LANGUAGE_SERVER_FEATURE_IDS: readonly ["completion", "hover", "navigation", "signatureHelp", "diagnostics", "codeActions", "formatting", "rename", "documentHighlights", "semanticTokens"];
+export type LanguageServerFeatureId = (typeof LANGUAGE_SERVER_FEATURE_IDS)[number];
+export type LanguageServerFeatureRanks = Partial<Readonly<Record<LanguageServerFeatureId, number>>>;
+export type LanguageServerReadyNotification = {
+    readonly method: string;
+    readonly params: unknown;
+};
+export type LanguageServerDiagnosticCounts = {
+    readonly error: number;
+    readonly warning: number;
+    readonly information: number;
+    readonly hint: number;
+    readonly total: number;
+};
+/**
+ * How far a summary's diagnostics can be trusted, so an empty list is never mistaken for a clean
+ * file. `awaiting`: a first result is being asked for. `refreshing`: a result is shown and a newer
+ * one is being asked for. `current`: nothing is pending. `silent`: the server has said nothing and
+ * nothing is pending — a push-only server may never publish, so this never waits. `unavailable`:
+ * the connection is gone and what was shown was cleared.
+ */
+export type LanguageServerDiagnosticsFreshness = 'awaiting' | 'refreshing' | 'current' | 'silent' | 'unavailable';
+export type LanguageServerDiagnosticSummary = {
+    readonly uri: lsp.DocumentUri | null;
+    readonly version: number | null;
+    readonly diagnostics: readonly lsp.Diagnostic[];
+    readonly counts: LanguageServerDiagnosticCounts;
+    readonly freshness: LanguageServerDiagnosticsFreshness;
+};
+export type LanguageServerDiagnosticMarkerEvent = {
+    readonly direction: 'next' | 'previous';
+    readonly diagnostic: lsp.Diagnostic;
+    readonly documentUri: lsp.DocumentUri;
+    readonly textVersion: number;
+    readonly anchor: EditorTextAnchor;
+};
+export type LanguageServerDiagnosticMarkerClaim = {
+    readonly kind: 'claimed';
+    dispose(): void;
+} | {
+    readonly kind: 'ignored';
+};
+export type LanguageServerDefinitionTarget = {
+    readonly uri: lsp.DocumentUri;
+    readonly path: string;
+    readonly range: lsp.Range;
+};
+export type LanguageServerNavigationKind = 'definition' | 'references' | 'implementation' | 'typeDefinition';
+export type LanguageServerNavigationOpenMode = 'default' | 'peek' | 'aside';
+export type LanguageServerNavigationOptions = {
+    readonly kind: LanguageServerNavigationKind;
+    readonly openMode: LanguageServerNavigationOpenMode;
+};
+export type LanguageServerReferencesResult = {
+    readonly uri: lsp.DocumentUri;
+    readonly targets: readonly LanguageServerDefinitionTarget[];
+};
+export type LanguageServerDocumentSnapshot = Pick<EditorViewSnapshot, 'documentId' | 'languageId' | 'textSnapshot' | 'textVersion' | 'documentSyncPoint' | 'changesSinceDocumentSyncPoint' | 'lineStarts' | 'lineStartsView'>;
+export type LanguageServerDocumentSyncOptions = {
+    /** Projects a live path transition before deferred view publication catches up. */
+    readonly controller?: LanguageServerDocumentSyncController;
+    /** Resolves opaque editor identities to protocol URIs. Returning null disables synchronization. */
+    uriForDocument?(snapshot: LanguageServerDocumentSnapshot): lsp.DocumentUri | null;
+    /**
+     * The language id sent to the server when the editor and protocol use different names.
+     * Returning undefined keeps the editor's id.
+     */
+    languageIdForDocument?(languageId: string, uri: lsp.DocumentUri): string | undefined;
+    shouldSyncLanguageId?(languageId: string, snapshot: LanguageServerDocumentSnapshot): boolean;
+    shouldSyncUri?(uri: lsp.DocumentUri, snapshot: LanguageServerDocumentSnapshot): boolean;
+};
+export type { WorkspaceTextDocumentProvenance } from './workspaceTextEdits';
+export type WorkspaceEditOriginGuard = {
+    readonly documents: readonly WorkspaceTextDocumentProvenance[];
+    isCurrent(uri: string): boolean;
+};
+export type ApplyWorkspaceEditRequest = {
+    readonly guard: WorkspaceEditOriginGuard;
+    readonly label: string;
+    readonly logicalRevisionScope: DocumentLogicalRevisionScope;
+    readonly originUri: string;
+    readonly originVersion: number;
+    readonly plan: ParsedWorkspaceEdit;
+    readonly serverId: string;
+    readonly signal: AbortSignal;
+    readonly source: 'code-action' | 'rename';
+};
+export type ApplyWorkspaceEditResult = {
+    readonly status: 'applied';
+} | {
+    readonly status: 'cancelled';
+} | {
+    readonly code: string;
+    readonly message: string;
+    readonly status: 'failed';
+} | {
+    readonly code: string;
+    readonly message: string;
+    readonly status: 'rolled-back';
+} | {
+    readonly affectedPaths: readonly string[];
+    readonly code: string;
+    readonly message: string;
+    readonly status: 'recovery-required';
+};
+export type OnApplyWorkspaceEdit = (request: ApplyWorkspaceEditRequest) => Promise<ApplyWorkspaceEditResult>;
+export type LanguageServerLaneHostOptions = {
+    readonly onApplyWorkspaceEdit?: OnApplyWorkspaceEdit;
+};
+export type LanguageServerRenamePrompt = {
+    readonly anchor: DOMRect;
+    readonly currentName: string;
+    readonly signal: AbortSignal;
+};
+export type LanguageServerDiagnosticActionContext = {
+    readonly documentUri: lsp.DocumentUri;
+    readonly textVersion: number;
+    readonly diagnostic: lsp.Diagnostic;
+};
+export type LanguageServerDiagnosticActions = (context: LanguageServerDiagnosticActionContext) => readonly TooltipAction[];
+export type LanguageServerPluginOptions = LanguageServerLaneHostOptions & {
+    readonly rootUri?: lsp.DocumentUri | null;
+    readonly initializationOptions?: unknown;
+    readonly timeoutMs?: number;
+    /**
+     * Merged over `defaultClientCapabilities()`, so a host declares only what it adds. Build a
+     * semantic-tokens block with `semanticTokensClientCapability()` from `@singapore-editor/lsp` rather than
+     * by hand: it refuses the flags this editor cannot honour, each of which a real server acts on.
+     */
+    readonly capabilities?: lsp.ClientCapabilities;
+    /** At least one real server branches on this. The value is the host's to pick. */
+    readonly clientInfo?: lsp.InitializeParams['clientInfo'];
+    /**
+     * Merged around the plugin's own handlers. An entry for `textDocument/publishDiagnostics` runs
+     * after the plugin's and cannot displace it, because the diagnostics feature hangs off it.
+     */
+    readonly notificationHandlers?: Readonly<Record<string, LspNotificationHandler<LspClient>>>;
+    /**
+     * Answers requests the server sends the client, such as a server asking the host for files.
+     * A method the plugin answers itself (`workspace/diagnostic/refresh`) stays the plugin's.
+     */
+    readonly serverRequestHandlers?: Readonly<Record<string, LspServerRequestHandler<LspClient>>>;
+    /** Which documents reach the server, and under what language id. */
+    readonly documentSync?: LanguageServerDocumentSyncOptions;
+    readonly webSocketRoute: string | URL;
+    readonly webSocketTransportOptions?: LspWebSocketTransportOptions;
+    /**
+     * Borrows the connection rather than owning one per view, so a file switch that rebuilds the view
+     * does not also rebuild the websocket and re-run `initialize`. The route and options above still
+     * describe the connection — the provider is handed them and builds from them the first time it
+     * sees a key. See `LspConnectionProvider`.
+     */
+    readonly connectionProvider?: LspConnectionProvider;
+    /**
+     * Turns on the semantic token layer, and is how the host gets hold of one: a layer needs a
+     * viewport, a snapshot and a lifecycle, so the contribution creates it and hands it over through
+     * `onLayer`. Supplying nothing creates no layer and fires no demand signal.
+     */
+    readonly semanticTokens?: LanguageServerSemanticTokensOptions;
+    /**
+     * Hands the host the connection the moment it exists, which is the only way to reach the
+     * `LspClient` — and therefore the only way to issue a request, override the timeout for one, or
+     * cancel one. Returning a disposable ties the host's own controller to the connection's life.
+     */
+    onConnectionCreated?(context: LanguageServerConnectionContext): EditorDisposable | void;
+    /** The same context again, once `initialize` has come back and server capabilities are known. */
+    onConnected?(context: LanguageServerConnectionContext): void;
+    readonly onStatusChange?: (status: LanguageServerStatus) => void;
+    readonly onDiagnostics?: (summary: LanguageServerDiagnosticSummary) => void;
+    readonly getDiagnosticActions?: LanguageServerDiagnosticActions;
+    readonly onDidNavigateDiagnostic?: (event: LanguageServerDiagnosticMarkerEvent) => LanguageServerDiagnosticMarkerClaim;
+    readonly onInteractiveReady?: () => void;
+    readonly onRequestError?: (serverId: string, method: string, error: unknown) => void;
+    /** Reports the selected destination when Ctrl/Cmd-hover renders a jumpable link. */
+    readonly onDefinitionLinkHover?: (target: LanguageServerDefinitionTarget) => void;
+    readonly onOpenDefinition?: (target: LanguageServerDefinitionTarget, options?: LanguageServerNavigationOptions) => void | boolean;
+    readonly onOpenReferences?: (result: LanguageServerReferencesResult) => void | boolean;
+    readonly onError?: (error: unknown) => void;
+};
+export type LanguageServerLaneOptions = LanguageServerLaneHostOptions & {
+    readonly id: string;
+    readonly features: LanguageServerFeatureRanks;
+    readonly rootUri?: lsp.DocumentUri | null;
+    readonly initializationOptions?: unknown;
+    readonly timeoutMs?: number;
+    readonly capabilities?: lsp.ClientCapabilities;
+    readonly clientInfo?: lsp.InitializeParams['clientInfo'];
+    readonly notificationHandlers?: Readonly<Record<string, LspNotificationHandler<LspClient>>>;
+    readonly serverRequestHandlers?: Readonly<Record<string, LspServerRequestHandler<LspClient>>>;
+    readonly webSocketRoute: string | URL;
+    readonly webSocketTransportOptions?: LspWebSocketTransportOptions;
+    readonly connectionProvider?: LspConnectionProvider;
+    /** Reconnects after the server goes away on its own; off unless given. */
+    readonly reconnect?: LspReconnectOptions;
+    readonly readyNotifications?: readonly LanguageServerReadyNotification[];
+    onConnectionCreated?(context: LanguageServerConnectionContext): EditorDisposable | void;
+    onConnected?(context: LanguageServerConnectionContext): void;
+    readonly onStatusChange?: (status: LanguageServerStatus) => void;
+    readonly onDiagnostics?: (summary: LanguageServerDiagnosticSummary) => void;
+    readonly onInteractiveReady?: () => void;
+    readonly onRequestError?: (method: string, error: unknown) => void;
+    readonly onError?: (error: unknown) => void;
+};
+export type LanguageServerSetPluginOptions = Pick<LanguageServerPluginOptions, 'onDiagnostics' | 'onDidNavigateDiagnostic' | 'getDiagnosticActions' | 'onInteractiveReady' | 'onRequestError' | 'onDefinitionLinkHover' | 'onOpenDefinition' | 'onOpenReferences' | 'onError'> & {
+    readonly semanticTokens?: LanguageServerSemanticTokensFactory;
+} & ({
+    readonly lanes: readonly LanguageServerLaneOptions[];
+    readonly document?: never;
+    readonly documentSync?: LanguageServerDocumentSyncOptions;
+    readonly onApplyWorkspaceEdit?: OnApplyWorkspaceEdit;
+} | {
+    readonly document: LanguageServerDocument;
+    readonly lanes?: never;
+    readonly documentSync?: never;
+    readonly onApplyWorkspaceEdit?: never;
+});
+export type LanguageServerDocumentPluginOptions = Omit<Extract<LanguageServerSetPluginOptions, {
+    readonly document: LanguageServerDocument;
+}>, 'lanes' | 'document'> & {
+    readonly document: LanguageServerDocument;
+    readonly webSocketRoute?: never;
+};
+export type LanguageServerPlugin = EditorPlugin;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,17 @@
+//#region src/types.ts
+var LANGUAGE_SERVER_FEATURE_IDS = [
+	"completion",
+	"hover",
+	"navigation",
+	"signatureHelp",
+	"diagnostics",
+	"codeActions",
+	"formatting",
+	"rename",
+	"documentHighlights",
+	"semanticTokens"
+];
+//#endregion
+export { LANGUAGE_SERVER_FEATURE_IDS };
+
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type { TooltipAction } from '@singapore-editor/plugin-ui/tooltip'\nimport type { LanguageServerDocument } from './document'\nimport type { DocumentLogicalRevisionScope } from '@singapore-editor/core/document'\nimport type {\n  EditorDisposable,\n  EditorPlugin,\n  EditorTextAnchor,\n  EditorViewSnapshot,\n} from '@singapore-editor/core/extensions'\nimport type {\n  LspClient,\n  LspNotificationHandler,\n  LspServerRequestHandler,\n  LspWebSocketTransportOptions,\n} from '@singapore-editor/lsp'\nimport type * as lsp from 'vscode-languageserver-protocol'\n\nimport type { LanguageServerConnectionContext } from './connectionContext'\nimport type { LanguageServerDocumentSyncController } from './documentSyncController'\nimport type { LspConnectionProvider, LspReconnectOptions } from './lspConnection'\nimport type { ParsedWorkspaceEdit } from './workspaceEdit'\nimport type { WorkspaceTextDocumentProvenance } from './workspaceTextEdits'\nexport type { LanguageServerConnectionContext } from './connectionContext'\nimport type {\n  LanguageServerSemanticTokensFactory,\n  LanguageServerSemanticTokensOptions,\n} from './semanticTokens'\n\nexport type LanguageServerStatus = 'idle' | 'loading' | 'ready' | 'error'\n\nexport const LANGUAGE_SERVER_FEATURE_IDS = [\n  'completion',\n  'hover',\n  'navigation',\n  'signatureHelp',\n  'diagnostics',\n  'codeActions',\n  'formatting',\n  'rename',\n  'documentHighlights',\n  'semanticTokens',\n] as const\n\nexport type LanguageServerFeatureId = (typeof LANGUAGE_SERVER_FEATURE_IDS)[number]\n\nexport type LanguageServerFeatureRanks = Partial<Readonly<Record<LanguageServerFeatureId, number>>>\n\nexport type LanguageServerReadyNotification = {\n  readonly method: string\n  readonly params: unknown\n}\n\nexport type LanguageServerDiagnosticCounts = {\n  readonly error: number\n  readonly warning: number\n  readonly information: number\n  readonly hint: number\n  readonly total: number\n}\n\n/**\n * How far a summary's diagnostics can be trusted, so an empty list is never mistaken for a clean\n * file. `awaiting`: a first result is being asked for. `refreshing`: a result is shown and a newer\n * one is being asked for. `current`: nothing is pending. `silent`: the server has said nothing and\n * nothing is pending — a push-only server may never publish, so this never waits. `unavailable`:\n * the connection is gone and what was shown was cleared.\n */\nexport type LanguageServerDiagnosticsFreshness =\n  | 'awaiting'\n  | 'refreshing'\n  | 'current'\n  | 'silent'\n  | 'unavailable'\n\nexport type LanguageServerDiagnosticSummary = {\n  readonly uri: lsp.DocumentUri | null\n  readonly version: number | null\n  readonly diagnostics: readonly lsp.Diagnostic[]\n  readonly counts: LanguageServerDiagnosticCounts\n  readonly freshness: LanguageServerDiagnosticsFreshness\n}\n\nexport type LanguageServerDiagnosticMarkerEvent = {\n  readonly direction: 'next' | 'previous'\n  readonly diagnostic: lsp.Diagnostic\n  readonly documentUri: lsp.DocumentUri\n  readonly textVersion: number\n  readonly anchor: EditorTextAnchor\n}\n\nexport type LanguageServerDiagnosticMarkerClaim =\n  | { readonly kind: 'claimed'; dispose(): void }\n  | { readonly kind: 'ignored' }\n\nexport type LanguageServerDefinitionTarget = {\n  readonly uri: lsp.DocumentUri\n  readonly path: string\n  readonly range: lsp.Range\n}\n\nexport type LanguageServerNavigationKind =\n  | 'definition'\n  | 'references'\n  | 'implementation'\n  | 'typeDefinition'\n\nexport type LanguageServerNavigationOpenMode = 'default' | 'peek' | 'aside'\n\nexport type LanguageServerNavigationOptions = {\n  readonly kind: LanguageServerNavigationKind\n  readonly openMode: LanguageServerNavigationOpenMode\n}\n\nexport type LanguageServerReferencesResult = {\n  readonly uri: lsp.DocumentUri\n  readonly targets: readonly LanguageServerDefinitionTarget[]\n}\n\nexport type LanguageServerDocumentSnapshot = Pick<\n  EditorViewSnapshot,\n  | 'documentId'\n  | 'languageId'\n  | 'textSnapshot'\n  | 'textVersion'\n  | 'documentSyncPoint'\n  | 'changesSinceDocumentSyncPoint'\n  | 'lineStarts'\n  | 'lineStartsView'\n>\n\nexport type LanguageServerDocumentSyncOptions = {\n  /** Projects a live path transition before deferred view publication catches up. */\n  readonly controller?: LanguageServerDocumentSyncController\n  /** Resolves opaque editor identities to protocol URIs. Returning null disables synchronization. */\n  uriForDocument?(snapshot: LanguageServerDocumentSnapshot): lsp.DocumentUri | null\n  /**\n   * The language id sent to the server when the editor and protocol use different names.\n   * Returning undefined keeps the editor's id.\n   */\n  languageIdForDocument?(languageId: string, uri: lsp.DocumentUri): string | undefined\n  shouldSyncLanguageId?(languageId: string, snapshot: LanguageServerDocumentSnapshot): boolean\n  shouldSyncUri?(uri: lsp.DocumentUri, snapshot: LanguageServerDocumentSnapshot): boolean\n}\n\nexport type { WorkspaceTextDocumentProvenance } from './workspaceTextEdits'\n\nexport type WorkspaceEditOriginGuard = {\n  readonly documents: readonly WorkspaceTextDocumentProvenance[]\n  isCurrent(uri: string): boolean\n}\n\nexport type ApplyWorkspaceEditRequest = {\n  readonly guard: WorkspaceEditOriginGuard\n  readonly label: string\n  readonly logicalRevisionScope: DocumentLogicalRevisionScope\n  readonly originUri: string\n  readonly originVersion: number\n  readonly plan: ParsedWorkspaceEdit\n  readonly serverId: string\n  readonly signal: AbortSignal\n  readonly source: 'code-action' | 'rename'\n}\n\nexport type ApplyWorkspaceEditResult =\n  | { readonly status: 'applied' }\n  | { readonly status: 'cancelled' }\n  | { readonly code: string; readonly message: string; readonly status: 'failed' }\n  | { readonly code: string; readonly message: string; readonly status: 'rolled-back' }\n  | {\n      readonly affectedPaths: readonly string[]\n      readonly code: string\n      readonly message: string\n      readonly status: 'recovery-required'\n    }\n\nexport type OnApplyWorkspaceEdit = (\n  request: ApplyWorkspaceEditRequest,\n) => Promise<ApplyWorkspaceEditResult>\n\nexport type LanguageServerLaneHostOptions = {\n  readonly onApplyWorkspaceEdit?: OnApplyWorkspaceEdit\n}\n\nexport type LanguageServerRenamePrompt = {\n  readonly anchor: DOMRect\n  readonly currentName: string\n  readonly signal: AbortSignal\n}\n\nexport type LanguageServerDiagnosticActionContext = {\n  readonly documentUri: lsp.DocumentUri\n  readonly textVersion: number\n  readonly diagnostic: lsp.Diagnostic\n}\n\nexport type LanguageServerDiagnosticActions = (\n  context: LanguageServerDiagnosticActionContext,\n) => readonly TooltipAction[]\n\nexport type LanguageServerPluginOptions = LanguageServerLaneHostOptions & {\n  readonly rootUri?: lsp.DocumentUri | null\n  readonly initializationOptions?: unknown\n  readonly timeoutMs?: number\n  /**\n   * Merged over `defaultClientCapabilities()`, so a host declares only what it adds. Build a\n   * semantic-tokens block with `semanticTokensClientCapability()` from `@singapore-editor/lsp` rather than\n   * by hand: it refuses the flags this editor cannot honour, each of which a real server acts on.\n   */\n  readonly capabilities?: lsp.ClientCapabilities\n  /** At least one real server branches on this. The value is the host's to pick. */\n  readonly clientInfo?: lsp.InitializeParams['clientInfo']\n  /**\n   * Merged around the plugin's own handlers. An entry for `textDocument/publishDiagnostics` runs\n   * after the plugin's and cannot displace it, because the diagnostics feature hangs off it.\n   */\n  readonly notificationHandlers?: Readonly<Record<string, LspNotificationHandler<LspClient>>>\n  /**\n   * Answers requests the server sends the client, such as a server asking the host for files.\n   * A method the plugin answers itself (`workspace/diagnostic/refresh`) stays the plugin's.\n   */\n  readonly serverRequestHandlers?: Readonly<Record<string, LspServerRequestHandler<LspClient>>>\n  /** Which documents reach the server, and under what language id. */\n  readonly documentSync?: LanguageServerDocumentSyncOptions\n  readonly webSocketRoute: string | URL\n  readonly webSocketTransportOptions?: LspWebSocketTransportOptions\n  /**\n   * Borrows the connection rather than owning one per view, so a file switch that rebuilds the view\n   * does not also rebuild the websocket and re-run `initialize`. The route and options above still\n   * describe the connection — the provider is handed them and builds from them the first time it\n   * sees a key. See `LspConnectionProvider`.\n   */\n  readonly connectionProvider?: LspConnectionProvider\n  /**\n   * Turns on the semantic token layer, and is how the host gets hold of one: a layer needs a\n   * viewport, a snapshot and a lifecycle, so the contribution creates it and hands it over through\n   * `onLayer`. Supplying nothing creates no layer and fires no demand signal.\n   */\n  readonly semanticTokens?: LanguageServerSemanticTokensOptions\n  /**\n   * Hands the host the connection the moment it exists, which is the only way to reach the\n   * `LspClient` — and therefore the only way to issue a request, override the timeout for one, or\n   * cancel one. Returning a disposable ties the host's own controller to the connection's life.\n   */\n  onConnectionCreated?(context: LanguageServerConnectionContext): EditorDisposable | void\n  /** The same context again, once `initialize` has come back and server capabilities are known. */\n  onConnected?(context: LanguageServerConnectionContext): void\n  readonly onStatusChange?: (status: LanguageServerStatus) => void\n  readonly onDiagnostics?: (summary: LanguageServerDiagnosticSummary) => void\n  readonly getDiagnosticActions?: LanguageServerDiagnosticActions\n  readonly onDidNavigateDiagnostic?: (\n    event: LanguageServerDiagnosticMarkerEvent,\n  ) => LanguageServerDiagnosticMarkerClaim\n  readonly onInteractiveReady?: () => void\n  readonly onRequestError?: (serverId: string, method: string, error: unknown) => void\n  /** Reports the selected destination when Ctrl/Cmd-hover renders a jumpable link. */\n  readonly onDefinitionLinkHover?: (target: LanguageServerDefinitionTarget) => void\n  readonly onOpenDefinition?: (\n    target: LanguageServerDefinitionTarget,\n    options?: LanguageServerNavigationOptions,\n  ) => void | boolean\n  readonly onOpenReferences?: (result: LanguageServerReferencesResult) => void | boolean\n  readonly onError?: (error: unknown) => void\n}\n\nexport type LanguageServerLaneOptions = LanguageServerLaneHostOptions & {\n  readonly id: string\n  readonly features: LanguageServerFeatureRanks\n  readonly rootUri?: lsp.DocumentUri | null\n  readonly initializationOptions?: unknown\n  readonly timeoutMs?: number\n  readonly capabilities?: lsp.ClientCapabilities\n  readonly clientInfo?: lsp.InitializeParams['clientInfo']\n  readonly notificationHandlers?: Readonly<Record<string, LspNotificationHandler<LspClient>>>\n  readonly serverRequestHandlers?: Readonly<Record<string, LspServerRequestHandler<LspClient>>>\n  readonly webSocketRoute: string | URL\n  readonly webSocketTransportOptions?: LspWebSocketTransportOptions\n  readonly connectionProvider?: LspConnectionProvider\n  /** Reconnects after the server goes away on its own; off unless given. */\n  readonly reconnect?: LspReconnectOptions\n  readonly readyNotifications?: readonly LanguageServerReadyNotification[]\n  onConnectionCreated?(context: LanguageServerConnectionContext): EditorDisposable | void\n  onConnected?(context: LanguageServerConnectionContext): void\n  readonly onStatusChange?: (status: LanguageServerStatus) => void\n  readonly onDiagnostics?: (summary: LanguageServerDiagnosticSummary) => void\n  readonly onInteractiveReady?: () => void\n  readonly onRequestError?: (method: string, error: unknown) => void\n  readonly onError?: (error: unknown) => void\n}\n\nexport type LanguageServerSetPluginOptions = Pick<\n  LanguageServerPluginOptions,\n  | 'onDiagnostics'\n  | 'onDidNavigateDiagnostic'\n  | 'getDiagnosticActions'\n  | 'onInteractiveReady'\n  | 'onRequestError'\n  | 'onDefinitionLinkHover'\n  | 'onOpenDefinition'\n  | 'onOpenReferences'\n  | 'onError'\n> & {\n  readonly semanticTokens?: LanguageServerSemanticTokensFactory\n} & (\n    | {\n        readonly lanes: readonly LanguageServerLaneOptions[]\n        readonly document?: never\n        readonly documentSync?: LanguageServerDocumentSyncOptions\n        readonly onApplyWorkspaceEdit?: OnApplyWorkspaceEdit\n      }\n    | {\n        readonly document: LanguageServerDocument\n        readonly lanes?: never\n        readonly documentSync?: never\n        readonly onApplyWorkspaceEdit?: never\n      }\n  )\n\nexport type LanguageServerDocumentPluginOptions = Omit<\n  Extract<LanguageServerSetPluginOptions, { readonly document: LanguageServerDocument }>,\n  'lanes' | 'document'\n> & {\n  readonly document: LanguageServerDocument\n  readonly webSocketRoute?: never\n}\n\nexport type LanguageServerPlugin = EditorPlugin\n"],"mappings":";AA8BA,IAAa,8BAA8B;CACzC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}

package/dist/viewDocumentSnapshot.d.ts

@@ -0,0 +1,5 @@
+import type { LanguageServerDocumentSnapshot } from './types';
+import type { LspTextDocumentSnapshot } from '@singapore-editor/lsp';
+/** The view's text and line-start index as an LSP document snapshot, so nothing rescans the text. */
+export declare function viewDocumentSnapshot(snapshot: LanguageServerDocumentSnapshot): LspTextDocumentSnapshot;
+//# sourceMappingURL=viewDocumentSnapshot.d.ts.map

package/dist/viewDocumentSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewDocumentSnapshot.d.ts","sourceRoot":"","sources":["../src/viewDocumentSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,SAAS,CAAA;AAC7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAEpE,qGAAqG;AACrG,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,8BAA8B,GACvC,uBAAuB,CAKzB"}

package/dist/viewDocumentSnapshot.js

@@ -0,0 +1,12 @@
+//#region src/viewDocumentSnapshot.ts
+/** The view's text and line-start index as an LSP document snapshot, so nothing rescans the text. */
+function viewDocumentSnapshot(snapshot) {
+	return {
+		textSnapshot: snapshot.textSnapshot,
+		lineStarts: snapshot.lineStartsView
+	};
+}
+//#endregion
+export { viewDocumentSnapshot };
+
+//# sourceMappingURL=viewDocumentSnapshot.js.map

package/dist/viewDocumentSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewDocumentSnapshot.js","names":[],"sources":["../src/viewDocumentSnapshot.ts"],"sourcesContent":["import type { LanguageServerDocumentSnapshot } from './types'\nimport type { LspTextDocumentSnapshot } from '@singapore-editor/lsp'\n\n/** The view's text and line-start index as an LSP document snapshot, so nothing rescans the text. */\nexport function viewDocumentSnapshot(\n  snapshot: LanguageServerDocumentSnapshot,\n): LspTextDocumentSnapshot {\n  return {\n    textSnapshot: snapshot.textSnapshot,\n    lineStarts: snapshot.lineStartsView,\n  }\n}\n"],"mappings":";;AAIA,SAAgB,qBACd,UACyB;CACzB,OAAO;EACL,cAAc,SAAS;EACvB,YAAY,SAAS;CACvB;AACF"}

package/dist/websocket.d.ts

@@ -0,0 +1,6 @@
+export { createLanguageServerDocument, LanguageServerDocument, type LanguageServerDocumentOptions, } from './document';
+export type { LanguageServerDocumentPluginOptions, LanguageServerDocumentSnapshot } from './types';
+export { createLanguageServerPlugin, createLanguageServerSetPlugin, type LanguageServerResolvedOptions, } from './plugin';
+export { acquireLanguageServerLane, type AcquiredLanguageServerLane } from './lane';
+export type { LanguageServerDefinitionTarget, LanguageServerDiagnosticSummary, LanguageServerDiagnosticsFreshness, LanguageServerPlugin, LanguageServerLaneOptions, LanguageServerPluginOptions, LanguageServerSetPluginOptions, LanguageServerStatus, } from './types';
+//# sourceMappingURL=websocket.d.ts.map

package/dist/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,KAAK,6BAA6B,GACnC,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,mCAAmC,EAAE,8BAA8B,EAAE,MAAM,SAAS,CAAA;AAClG,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,KAAK,6BAA6B,GACnC,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,yBAAyB,EAAE,KAAK,0BAA0B,EAAE,MAAM,QAAQ,CAAA;AACnF,YAAY,EACV,8BAA8B,EAC9B,+BAA+B,EAC/B,kCAAkC,EAClC,oBAAoB,EACpB,yBAAyB,EACzB,2BAA2B,EAC3B,8BAA8B,EAC9B,oBAAoB,GACrB,MAAM,SAAS,CAAA"}