@singapore-editor/lsp-plugin 0.1.1

package/README.md

@@ -0,0 +1,103 @@
+# @singapore-editor/lsp-plugin
+
+Editor integration layer for LSP-backed Singapore language features.
+
+This package adapts `@singapore-editor/lsp` transports to `@singapore-editor/core` plugins for diagnostics,
+completion, hover, definition navigation, references, and document synchronization.
+
+## Install
+
+```sh
+npm install @singapore-editor/core @singapore-editor/lsp @singapore-editor/lsp-plugin
+```
+
+## Usage
+
+```ts
+import {
+  createLanguageServerAdapterPlugin,
+  createWebSocketLspTransportFactory,
+} from '@singapore-editor/lsp-plugin'
+
+const plugin = createLanguageServerAdapterPlugin({
+  name: 'typescript-lsp',
+  createTransport: createWebSocketLspTransportFactory('ws://localhost:3000/lsp'),
+  documentSync: {
+    shouldSyncLanguageId: (languageId) => languageId === 'typescript',
+  },
+})
+```
+
+## Exports
+
+- `createLanguageServerAdapterPlugin` creates the full editor integration.
+- `createLanguageServerPlugin` exposes a lower-level plugin factory.
+- `createWebSocketLspTransportFactory` and `createWorkerLspTransportFactory` create transport
+  factories.
+- Diagnostic, path, markdown tooltip, completion, and document-sync helpers are available through
+  subpath exports.
+
+## Keys
+
+The completion list and the signature hint are driven by editor commands, not by listening to
+keys: `editor.action.triggerSuggest` (Ctrl+Space), `selectNextSuggestion`, `selectPrevSuggestion`,
+`selectNextPageSuggestion`, `selectPrevPageSuggestion`, `acceptSelectedSuggestion`,
+`hideSuggestWidget`, `closeParameterHints`, `showNextParameterHint` and `showPrevParameterHint`.
+The core's `suggest` keymap pack binds them under the context keys this plugin registers
+(`suggestWidgetVisible`, `parameterHintsVisible`, `parameterHintsMultipleSignatures`). A host that
+turns the editor's keymap off, or drops that pack, binds these commands itself or the list cannot
+be driven from the keyboard. They are part of `commands`, so `commands: []` registers none of them.
+
+## Document lifetime
+
+The connection-only API owns its document session automatically. Dispose the editor to close it:
+
+```ts
+const plugin = createLanguageServerPlugin({
+  webSocketRoute: 'ws://localhost:3001/lsp',
+})
+```
+
+For tabs or split editors, create a session beside the text buffer and pass it to each view:
+
+```ts
+import {
+  createLanguageServerDocument,
+  createLanguageServerPlugin,
+} from '@singapore-editor/lsp-plugin'
+
+const document = createLanguageServerDocument({
+  buffer,
+  uri: 'file:///project/main.ts',
+  languageId: 'typescript',
+  lanes: [
+    {
+      id: 'typescript',
+      features: { diagnostics: 0, completion: 0, hover: 0, navigation: 0 },
+      webSocketRoute: 'ws://localhost:3001/lsp',
+    },
+  ],
+})
+
+const plugin = createLanguageServerPlugin({ document })
+```
+
+The session synchronizes buffer changes and receives diagnostics even with no mounted view.
+Each view renders the current diagnostics on attachment. Disposing a view unsubscribes it;
+it does not close the document. The host calls `document.dispose()` when the document closes.
+Multiple views share the session, with independent completion, hover, and selection UI.
+
+Use `documentId` when the editor uses an opaque identity different from the URI. Connection
+options and an explicit `document` are mutually exclusive plugin inputs. Both forms use the
+same synchronization and diagnostic implementation.
+
+For shared sessions, pass `onApplyWorkspaceEdit` to `createLanguageServerDocument`.
+The document uses it both to advertise workspace-edit support during initialization and to
+apply edits requested by its views. It cannot be supplied on a plugin borrowing that document.
+The connection-only plugin still accepts `onApplyWorkspaceEdit` directly.
+
+### Diagnostic hover actions
+
+`getDiagnosticActions({ documentUri, textVersion, diagnostic })` supplies actions beside each diagnostic note. It is supported by the server, server-set and adapter plugins, including `createTypeScriptLspPlugin`. Return an empty array when no action applies. Each action has a `label` and `run(): void | Promise<void>`.
+
+The tooltip prevents repeated invocation while an action is pending, preserves keyboard focus, and shows a rejected action's message beside its button. Progressive hover replies retain pending actions and their errors. An action refuses to run after its document, text version or diagnostic changes; the user can reopen the hover for a fresh action. The host owns application behavior and async operation state.

package/dist/bufferSync.d.ts

@@ -0,0 +1,12 @@
+import type { EditorTextBuffer } from '@singapore-editor/core/document';
+import type { EditorDisposable } from '@singapore-editor/core/extensions';
+import type { LanguageServerConnectionContext } from './connectionContext';
+import type { LanguageServerDocumentSyncController } from './documentSyncController';
+/** Gives a connection the same live buffer and edit provenance as a mounted editor. */
+export declare function synchronizeLanguageServerBuffer(context: LanguageServerConnectionContext, options: {
+    readonly buffer: EditorTextBuffer;
+    readonly uri: string;
+    readonly languageId: string;
+    readonly controller?: LanguageServerDocumentSyncController;
+}): EditorDisposable;
+//# sourceMappingURL=bufferSync.d.ts.map

package/dist/bufferSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bufferSync.d.ts","sourceRoot":"","sources":["../src/bufferSync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,0BAA0B,CAAA;AAKpF,uFAAuF;AACvF,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,+BAA+B,EACxC,OAAO,EAAE;IACP,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,oCAAoC,CAAA;CAC3D,GACA,gBAAgB,CA0BlB"}

package/dist/bufferSync.js

@@ -0,0 +1,35 @@
+import { bufferDocumentSnapshot } from "./documentSnapshot.js";
+import { DocumentSync } from "./documentSync.js";
+import { logicalRevisionScopeFor } from "./lane.js";
+//#region src/bufferSync.ts
+/** Gives a connection the same live buffer and edit provenance as a mounted editor. */
+function synchronizeLanguageServerBuffer(context, options) {
+	const getSnapshot = () => bufferDocumentSnapshot({
+		...options,
+		uri: sync.activeDocument?.uri ?? options.uri
+	});
+	const sync = new DocumentSync(context.workspace, {
+		clear() {},
+		render() {},
+		publishSummary() {}
+	}, {
+		logicalRevisionScope: logicalRevisionScopeFor(context.workspace),
+		onDocumentClosed() {}
+	});
+	const registration = options.controller?.register({
+		workspace: context.workspace,
+		sync,
+		getSnapshot
+	});
+	sync.sync(getSnapshot(), null);
+	const unsubscribe = options.buffer.subscribe(({ change }) => sync.sync(getSnapshot(), change));
+	return { dispose() {
+		unsubscribe();
+		registration?.dispose();
+		sync.close();
+	} };
+}
+//#endregion
+export { synchronizeLanguageServerBuffer };
+
+//# sourceMappingURL=bufferSync.js.map

package/dist/bufferSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bufferSync.js","names":[],"sources":["../src/bufferSync.ts"],"sourcesContent":["import type { EditorTextBuffer } from '@singapore-editor/core/document'\nimport type { EditorDisposable } from '@singapore-editor/core/extensions'\nimport type { LanguageServerConnectionContext } from './connectionContext'\nimport type { LanguageServerDocumentSyncController } from './documentSyncController'\nimport { bufferDocumentSnapshot } from './documentSnapshot'\nimport { DocumentSync } from './documentSync'\nimport { logicalRevisionScopeFor } from './lane'\n\n/** Gives a connection the same live buffer and edit provenance as a mounted editor. */\nexport function synchronizeLanguageServerBuffer(\n  context: LanguageServerConnectionContext,\n  options: {\n    readonly buffer: EditorTextBuffer\n    readonly uri: string\n    readonly languageId: string\n    readonly controller?: LanguageServerDocumentSyncController\n  },\n): EditorDisposable {\n  const getSnapshot = () =>\n    bufferDocumentSnapshot({ ...options, uri: sync.activeDocument?.uri ?? options.uri })\n  const sync = new DocumentSync(\n    context.workspace,\n    {\n      clear() {},\n      render() {},\n      publishSummary() {},\n    },\n    { logicalRevisionScope: logicalRevisionScopeFor(context.workspace), onDocumentClosed() {} },\n  )\n  const registration = options.controller?.register({\n    workspace: context.workspace,\n    sync,\n    getSnapshot,\n  })\n  sync.sync(getSnapshot(), null)\n  const unsubscribe = options.buffer.subscribe(({ change }) => sync.sync(getSnapshot(), change))\n  return {\n    dispose() {\n      unsubscribe()\n      registration?.dispose()\n      sync.close()\n    },\n  }\n}\n"],"mappings":";;;;;AASA,SAAgB,gCACd,SACA,SAMkB;CAClB,MAAM,oBACJ,uBAAuB;EAAE,GAAG;EAAS,KAAK,KAAK,gBAAgB,OAAO,QAAQ;CAAI,CAAC;CACrF,MAAM,OAAO,IAAI,aACf,QAAQ,WACR;EACE,QAAQ,CAAC;EACT,SAAS,CAAC;EACV,iBAAiB,CAAC;CACpB,GACA;EAAE,sBAAsB,wBAAwB,QAAQ,SAAS;EAAG,mBAAmB,CAAC;CAAE,CAC5F;CACA,MAAM,eAAe,QAAQ,YAAY,SAAS;EAChD,WAAW,QAAQ;EACnB;EACA;CACF,CAAC;CACD,KAAK,KAAK,YAAY,GAAG,IAAI;CAC7B,MAAM,cAAc,QAAQ,OAAO,WAAW,EAAE,aAAa,KAAK,KAAK,YAAY,GAAG,MAAM,CAAC;CAC7F,OAAO,EACL,UAAU;EACR,YAAY;EACZ,cAAc,QAAQ;EACtB,KAAK,MAAM;CACb,EACF;AACF"}

package/dist/codeActions.d.ts

@@ -0,0 +1,83 @@
+import type { EditorViewContributionContext, EditorViewContributionUpdateKind } from '@singapore-editor/core/extensions';
+import { type LspTextDocumentSnapshot } from '@singapore-editor/lsp';
+import type * as lsp from 'vscode-languageserver-protocol';
+import type { OffsetRange } from '@singapore-editor/plugin-ui/offset-range';
+import type { ActiveDocument } from './pluginTypes';
+import { type LanguageServerCodeActionRouter } from './serverSet';
+export type CodeActionResponse = readonly (lsp.Command | lsp.CodeAction)[] | null;
+/**
+ * The one action `editor.action.autoFix` applies, or null when the answer holds none.
+ *
+ * Nothing else in the answer is kept. There is no menu to put a second candidate in, and a ranked
+ * list no surface can draw would be a promise the editor does not keep.
+ *
+ * `isPreferred` is the server naming the action it would pick itself, and the first such is taken
+ * rather than re-ordered: the order the answer arrived in is the only other ranking it gave us.
+ * `resolvable` says whether the server fills an action's edit in on request — without that, one
+ * that arrived carrying only a command is a fix this client has no way to carry out, and taking it
+ * would swallow the chord to do nothing.
+ */
+export declare function preferredQuickFix(response: CodeActionResponse, resolvable: boolean): lsp.CodeAction | null;
+/**
+ * The range an automatic request asks about, or null when there is nothing at the caret to ask
+ * about.
+ *
+ * A caret sitting between two blanks is inside indentation or trailing space, where no server has an
+ * action to offer; asking anyway would spend a request per settled keystroke while a line is being
+ * indented. A drawn selection always asks, because the user pointed at something.
+ */
+export declare function codeActionAutoTriggerRange(document: LspTextDocumentSnapshot, start: number, end: number): OffsetRange | null;
+export type CodeActionControllerOptions = {
+    readonly router: LanguageServerCodeActionRouter;
+    readonly context: EditorViewContributionContext;
+    readonly getActiveDocument: () => ActiveDocument | null;
+    readonly getDiagnostics: () => readonly lsp.Diagnostic[];
+    readonly onRequestError: (error: unknown) => void;
+};
+/**
+ * Keeps the fix available at the caret, and applies it on request.
+ *
+ * It is refreshed by a debounced oracle rather than fetched when the fix is asked for, because the
+ * two events that change the answer — the caret moving and the server republishing diagnostics —
+ * are exactly the two the user is waiting on: by the time a squiggle is visible under the caret, its
+ * fix is already in hand. Anything that could invalidate it drops it first, so a stale answer is
+ * never applied to text it was not computed against.
+ */
+export declare class CodeActionController {
+    private readonly options;
+    private fix;
+    private seenDiagnostics;
+    private timer;
+    private abort;
+    private applicationAbort;
+    private requestId;
+    private disposed;
+    constructor(options: CodeActionControllerOptions);
+    update(kind: EditorViewContributionUpdateKind): void;
+    /**
+     * Reruns the oracle when the server republished the active document's diagnostics.
+     *
+     * Publishes the document sync refused — another file, or a version the buffer has moved past — leave
+     * the list identical, and re-asking on those would answer for a document nobody is looking at.
+     */
+    diagnosticsChanged(): void;
+    /**
+     * Applies the preferred quick fix at the caret.
+     *
+     * Reports handled as soon as the edit is on its way: an action the server has not filled in yet
+     * needs a round trip, and returning false would let the keystroke fall through to another binding
+     * after the fix was already committed to.
+     */
+    applyAutoFix(): boolean;
+    dispose(): void;
+    private schedule;
+    private clear;
+    private request;
+    private runAction;
+    private resolvesActions;
+    private dispatchAction;
+    private isCurrentApplication;
+    private reportUnsupportedCommand;
+    private reportHostFailure;
+}
+//# sourceMappingURL=codeActions.d.ts.map

package/dist/codeActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeActions.d.ts","sourceRoot":"","sources":["../src/codeActions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,gCAAgC,EACjC,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,KAAK,GAAG,MAAM,gCAAgC,CAAA;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAA;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,aAAa,CAAA;AAgBpB,MAAM,MAAM,kBAAkB,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,EAAE,GAAG,IAAI,CAAA;AAEjF;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,kBAAkB,EAC5B,UAAU,EAAE,OAAO,GAClB,GAAG,CAAC,UAAU,GAAG,IAAI,CAevB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,uBAAuB,EACjC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,WAAW,GAAG,IAAI,CAYpB;AAED,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,MAAM,EAAE,8BAA8B,CAAA;IAC/C,QAAQ,CAAC,OAAO,EAAE,6BAA6B,CAAA;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,cAAc,GAAG,IAAI,CAAA;IACvD,QAAQ,CAAC,cAAc,EAAE,MAAM,SAAS,GAAG,CAAC,UAAU,EAAE,CAAA;IACxD,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAClD,CAAA;AAED;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;IASZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR3C,OAAO,CAAC,GAAG,CAA8B;IACzC,OAAO,CAAC,eAAe,CAAyC;IAChE,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,QAAQ,CAAQ;gBAEY,OAAO,EAAE,2BAA2B;IAEjE,MAAM,CAAC,IAAI,EAAE,gCAAgC,GAAG,IAAI;IAU3D;;;;;OAKG;IACI,kBAAkB,IAAI,IAAI;IAQjC;;;;;;OAMG;IACI,YAAY,IAAI,OAAO;IAmBvB,OAAO,IAAI,IAAI;IAOtB,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,KAAK;YAWC,OAAO;YA8CP,SAAS;IA8BvB,OAAO,CAAC,eAAe;YAIT,cAAc;IA0C5B,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,wBAAwB;IAMhC,OAAO,CAAC,iBAAiB;CAI1B"}

package/dist/codeActions.js

@@ -0,0 +1,294 @@
+import { characterAt, rowBounds } from "./sourceText.js";
+import { parseWorkspaceEdit } from "./workspaceEdit.js";
+import { currentWorkspaceEditOrigin } from "./workspaceEditProvenance.js";
+import { lspPositionToOffsetInSnapshot, offsetToLspPositionInSnapshot } from "@singapore-editor/lsp";
+//#region src/codeActions.ts
+/**
+* Long enough that a held arrow key or a burst of typing asks once, short enough that the answer is
+* already there when the hand leaves the keyboard and reaches for the fix.
+*/
+var CODE_ACTION_DEBOUNCE_MS = 250;
+var CODE_ACTION_TRIGGER_AUTOMATIC = 2;
+/** Root of the kind subtree the auto fix draws from. */
+var CODE_ACTION_QUICK_FIX_KIND = "quickfix";
+/**
+* The one action `editor.action.autoFix` applies, or null when the answer holds none.
+*
+* Nothing else in the answer is kept. There is no menu to put a second candidate in, and a ranked
+* list no surface can draw would be a promise the editor does not keep.
+*
+* `isPreferred` is the server naming the action it would pick itself, and the first such is taken
+* rather than re-ordered: the order the answer arrived in is the only other ranking it gave us.
+* `resolvable` says whether the server fills an action's edit in on request — without that, one
+* that arrived carrying only a command is a fix this client has no way to carry out, and taking it
+* would swallow the chord to do nothing.
+*/
+function preferredQuickFix(response, resolvable) {
+	if (!response) return null;
+	for (const entry of response) {
+		if (isCommand(entry)) continue;
+		if (entry.isPreferred !== true || entry.disabled) continue;
+		if (!resolvable && !entry.edit) continue;
+		if (!isQuickFixKind(entry.kind)) continue;
+		return entry;
+	}
+	return null;
+}
+/**
+* The range an automatic request asks about, or null when there is nothing at the caret to ask
+* about.
+*
+* A caret sitting between two blanks is inside indentation or trailing space, where no server has an
+* action to offer; asking anyway would spend a request per settled keystroke while a line is being
+* indented. A drawn selection always asks, because the user pointed at something.
+*/
+function codeActionAutoTriggerRange(document, start, end) {
+	if (start !== end) return {
+		start,
+		end
+	};
+	const line = rowBounds(document, start);
+	if (line.end === line.start) return null;
+	if (start === line.start) return isWhitespace(characterAt(document, start)) ? null : {
+		start,
+		end
+	};
+	if (start === line.end) return isWhitespace(characterAt(document, start - 1)) ? null : {
+		start,
+		end
+	};
+	const around = document.textSnapshot.readRange(start - 1, start + 1);
+	return isWhitespace(around[0]) && isWhitespace(around[1]) ? null : {
+		start,
+		end
+	};
+}
+/**
+* Keeps the fix available at the caret, and applies it on request.
+*
+* It is refreshed by a debounced oracle rather than fetched when the fix is asked for, because the
+* two events that change the answer — the caret moving and the server republishing diagnostics —
+* are exactly the two the user is waiting on: by the time a squiggle is visible under the caret, its
+* fix is already in hand. Anything that could invalidate it drops it first, so a stale answer is
+* never applied to text it was not computed against.
+*/
+var CodeActionController = class {
+	options;
+	fix = null;
+	seenDiagnostics = null;
+	timer = null;
+	abort = null;
+	applicationAbort = null;
+	requestId = 0;
+	disposed = false;
+	constructor(options) {
+		this.options = options;
+	}
+	update(kind) {
+		if (kind === "document" || kind === "clear") {
+			this.clear();
+			return;
+		}
+		if (kind !== "selection" && kind !== "content") return;
+		this.schedule();
+	}
+	/**
+	* Reruns the oracle when the server republished the active document's diagnostics.
+	*
+	* Publishes the document sync refused — another file, or a version the buffer has moved past — leave
+	* the list identical, and re-asking on those would answer for a document nobody is looking at.
+	*/
+	diagnosticsChanged() {
+		const diagnostics = this.options.getDiagnostics();
+		if (diagnostics === this.seenDiagnostics) return;
+		this.seenDiagnostics = diagnostics;
+		this.schedule();
+	}
+	/**
+	* Applies the preferred quick fix at the caret.
+	*
+	* Reports handled as soon as the edit is on its way: an action the server has not filled in yet
+	* needs a round trip, and returning false would let the keystroke fall through to another binding
+	* after the fix was already committed to.
+	*/
+	applyAutoFix() {
+		if (this.disposed) return false;
+		const active = this.options.getActiveDocument();
+		if (!active) return false;
+		const fix = this.fix;
+		if (!fix) return false;
+		const provenance = this.options.router.provenanceOf(fix);
+		if (!provenance) return false;
+		this.applicationAbort?.abort();
+		const abort = new AbortController();
+		this.applicationAbort = abort;
+		this.runAction(active, fix, provenance, abort);
+		return true;
+	}
+	dispose() {
+		if (this.disposed) return;
+		this.disposed = true;
+		this.clear();
+	}
+	schedule() {
+		this.clear();
+		/**
+		* @justification Debounces a question to the language server against the caret and the
+		* diagnostics, not against rendering, and `clear()` withdraws it on every further change — so a
+		* fix is never computed against text the reader has already moved past.
+		*/
+		this.timer = setTimeout(() => {
+			this.timer = null;
+			this.request();
+		}, CODE_ACTION_DEBOUNCE_MS);
+	}
+	clear() {
+		if (this.timer) clearTimeout(this.timer);
+		this.timer = null;
+		this.abort?.abort();
+		this.abort = null;
+		this.applicationAbort?.abort();
+		this.applicationAbort = null;
+		this.requestId += 1;
+		this.fix = null;
+	}
+	async request() {
+		const active = this.options.getActiveDocument();
+		if (!active) return;
+		if (!this.options.router.hasReady("codeActions", "textDocument/codeAction")) return;
+		const selection = this.options.context.getSnapshot().selections[0];
+		if (!selection) return;
+		const range = codeActionAutoTriggerRange(active, selection.startOffset, selection.endOffset);
+		if (!range) return;
+		const abort = new AbortController();
+		const requestId = this.requestId + 1;
+		this.requestId = requestId;
+		this.abort = abort;
+		try {
+			const response = await this.options.router.request("textDocument/codeAction", {
+				context: {
+					diagnostics: diagnosticsOverlapping(active, this.options.getDiagnostics(), range),
+					only: [CODE_ACTION_QUICK_FIX_KIND],
+					triggerKind: CODE_ACTION_TRIGGER_AUTOMATIC
+				},
+				range: {
+					end: offsetToLspPositionInSnapshot(active, range.end),
+					start: offsetToLspPositionInSnapshot(active, range.start)
+				},
+				textDocument: { uri: active.uri }
+			}, { signal: abort.signal });
+			if (requestId !== this.requestId) return;
+			if (this.disposed) return;
+			if (active !== this.options.getActiveDocument()) return;
+			this.fix = preferredQuickFix(response, this.resolvesActions());
+		} catch (error) {
+			if (!isAbortError(error)) this.options.onRequestError(error);
+		}
+	}
+	async runAction(active, action, provenance, abort) {
+		try {
+			if (action.command) {
+				this.reportUnsupportedCommand(action);
+				return;
+			}
+			const owned = action.edit ? {
+				action,
+				...provenance
+			} : await this.options.router.resolveOwnedCodeAction(action, { signal: abort.signal });
+			if (!owned) return;
+			if (!this.isCurrentApplication(active, abort)) return;
+			if (owned.action.command) {
+				this.reportUnsupportedCommand(owned.action);
+				return;
+			}
+			await this.dispatchAction(active, owned.action, owned, abort.signal);
+		} catch (error) {
+			if (!isAbortError(error)) this.options.onRequestError(error);
+		} finally {
+			if (this.applicationAbort === abort) this.applicationAbort = null;
+		}
+	}
+	resolvesActions() {
+		return this.options.router.canResolveCodeActions();
+	}
+	async dispatchAction(active, action, provenance, signal) {
+		if (!action.edit) {
+			this.reportUnsupportedCommand(action);
+			return;
+		}
+		const parsed = parseWorkspaceEdit(action.edit);
+		if (!parsed.ok) {
+			this.options.onRequestError(new Error(parsed.error.reason));
+			return;
+		}
+		const origin = currentWorkspaceEditOrigin(provenance.guard, active, parsed.value);
+		if (!origin) return;
+		if (signal.aborted) return;
+		const apply = provenance.lane.onApplyWorkspaceEdit;
+		if (!apply) {
+			this.options.onRequestError(/* @__PURE__ */ new Error(`"${action.title}" cannot be applied without a workspace edit host.`));
+			return;
+		}
+		const result = await apply({
+			guard: provenance.guard,
+			label: action.title,
+			logicalRevisionScope: provenance.lane.connection.logicalRevisionScope,
+			originUri: active.uri,
+			originVersion: origin.version,
+			plan: parsed.value,
+			serverId: provenance.lane.id,
+			signal,
+			source: "code-action"
+		});
+		this.reportHostFailure(result);
+	}
+	isCurrentApplication(active, abort) {
+		if (this.disposed) return false;
+		if (abort.signal.aborted) return false;
+		return active === this.options.getActiveDocument();
+	}
+	reportUnsupportedCommand(action) {
+		this.options.onRequestError(/* @__PURE__ */ new Error(`"${action.title}" includes a server command, which this editor cannot run.`));
+	}
+	reportHostFailure(result) {
+		if (result.status !== "failed") return;
+		this.options.onRequestError(/* @__PURE__ */ new Error(`${result.code}: ${result.message}`));
+	}
+};
+/** A literal's own `command` is an object; only the bare form names its command with a string. */
+function isCommand(entry) {
+	return typeof entry.command === "string";
+}
+/**
+* Whether `kind` is the quick-fix kind or sits beneath it in the dotted hierarchy.
+*
+* Containment, not equality: a server that names its actions precisely answers `quickfix.import`,
+* and comparing the strings whole would reject every one of those. An action that named no kind at
+* all placed itself nowhere, so it is not in this subtree either.
+*/
+function isQuickFixKind(kind) {
+	if (kind === void 0) return false;
+	return kind === CODE_ACTION_QUICK_FIX_KIND || kind.startsWith(`${CODE_ACTION_QUICK_FIX_KIND}.`);
+}
+function diagnosticsOverlapping(document, diagnostics, range) {
+	return diagnostics.filter((diagnostic) => {
+		const start = lspPositionToOffsetInSnapshot(document, diagnostic.range.start);
+		const end = lspPositionToOffsetInSnapshot(document, diagnostic.range.end);
+		return start <= range.end && end >= range.start;
+	});
+}
+function isWhitespace(character) {
+	return character !== void 0 && /\s/.test(character);
+}
+function isAbortError(error) {
+	if (error instanceof DOMException && error.name === "AbortError") return true;
+	if (!isRecord(error)) return false;
+	return error.name === "LspRequestCancelledError";
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
+export { CodeActionController, codeActionAutoTriggerRange, preferredQuickFix };
+
+//# sourceMappingURL=codeActions.js.map

package/dist/codeActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeActions.js","names":[],"sources":["../src/codeActions.ts"],"sourcesContent":["import type {\n  EditorViewContributionContext,\n  EditorViewContributionUpdateKind,\n} from '@singapore-editor/core/extensions'\nimport {\n  lspPositionToOffsetInSnapshot,\n  offsetToLspPositionInSnapshot,\n  type LspTextDocumentSnapshot,\n} from '@singapore-editor/lsp'\nimport type * as lsp from 'vscode-languageserver-protocol'\n\nimport type { OffsetRange } from '@singapore-editor/plugin-ui/offset-range'\nimport type { ActiveDocument } from './pluginTypes'\nimport { characterAt, rowBounds } from './sourceText'\nimport {\n  type LanguageServerCodeActionProvenance,\n  type LanguageServerCodeActionRouter,\n} from './serverSet'\nimport type { ApplyWorkspaceEditResult } from './types'\nimport { parseWorkspaceEdit } from './workspaceEdit'\nimport { currentWorkspaceEditOrigin } from './workspaceEditProvenance'\n\n/**\n * Long enough that a held arrow key or a burst of typing asks once, short enough that the answer is\n * already there when the hand leaves the keyboard and reaches for the fix.\n */\nconst CODE_ACTION_DEBOUNCE_MS = 250\n\nconst CODE_ACTION_TRIGGER_AUTOMATIC = 2\n\n/** Root of the kind subtree the auto fix draws from. */\nconst CODE_ACTION_QUICK_FIX_KIND = 'quickfix'\n\nexport type CodeActionResponse = readonly (lsp.Command | lsp.CodeAction)[] | null\n\n/**\n * The one action `editor.action.autoFix` applies, or null when the answer holds none.\n *\n * Nothing else in the answer is kept. There is no menu to put a second candidate in, and a ranked\n * list no surface can draw would be a promise the editor does not keep.\n *\n * `isPreferred` is the server naming the action it would pick itself, and the first such is taken\n * rather than re-ordered: the order the answer arrived in is the only other ranking it gave us.\n * `resolvable` says whether the server fills an action's edit in on request — without that, one\n * that arrived carrying only a command is a fix this client has no way to carry out, and taking it\n * would swallow the chord to do nothing.\n */\nexport function preferredQuickFix(\n  response: CodeActionResponse,\n  resolvable: boolean,\n): lsp.CodeAction | null {\n  if (!response) return null\n\n  for (const entry of response) {\n    // A server that declines the literal form answers with bare commands, which carry neither a\n    // kind nor a preference and so can never be the action asked for here.\n    if (isCommand(entry)) continue\n    if (entry.isPreferred !== true || entry.disabled) continue\n    if (!resolvable && !entry.edit) continue\n    if (!isQuickFixKind(entry.kind)) continue\n\n    return entry\n  }\n\n  return null\n}\n\n/**\n * The range an automatic request asks about, or null when there is nothing at the caret to ask\n * about.\n *\n * A caret sitting between two blanks is inside indentation or trailing space, where no server has an\n * action to offer; asking anyway would spend a request per settled keystroke while a line is being\n * indented. A drawn selection always asks, because the user pointed at something.\n */\nexport function codeActionAutoTriggerRange(\n  document: LspTextDocumentSnapshot,\n  start: number,\n  end: number,\n): OffsetRange | null {\n  if (start !== end) return { start, end }\n\n  const line = rowBounds(document, start)\n  if (line.end === line.start) return null\n  if (start === line.start)\n    return isWhitespace(characterAt(document, start)) ? null : { start, end }\n  if (start === line.end)\n    return isWhitespace(characterAt(document, start - 1)) ? null : { start, end }\n\n  const around = document.textSnapshot.readRange(start - 1, start + 1)\n  return isWhitespace(around[0]) && isWhitespace(around[1]) ? null : { start, end }\n}\n\nexport type CodeActionControllerOptions = {\n  readonly router: LanguageServerCodeActionRouter\n  readonly context: EditorViewContributionContext\n  readonly getActiveDocument: () => ActiveDocument | null\n  readonly getDiagnostics: () => readonly lsp.Diagnostic[]\n  readonly onRequestError: (error: unknown) => void\n}\n\n/**\n * Keeps the fix available at the caret, and applies it on request.\n *\n * It is refreshed by a debounced oracle rather than fetched when the fix is asked for, because the\n * two events that change the answer — the caret moving and the server republishing diagnostics —\n * are exactly the two the user is waiting on: by the time a squiggle is visible under the caret, its\n * fix is already in hand. Anything that could invalidate it drops it first, so a stale answer is\n * never applied to text it was not computed against.\n */\nexport class CodeActionController {\n  private fix: lsp.CodeAction | null = null\n  private seenDiagnostics: readonly lsp.Diagnostic[] | null = null\n  private timer: ReturnType<typeof setTimeout> | null = null\n  private abort: AbortController | null = null\n  private applicationAbort: AbortController | null = null\n  private requestId = 0\n  private disposed = false\n\n  public constructor(private readonly options: CodeActionControllerOptions) {}\n\n  public update(kind: EditorViewContributionUpdateKind): void {\n    if (kind === 'document' || kind === 'clear') {\n      this.clear()\n      return\n    }\n    if (kind !== 'selection' && kind !== 'content') return\n\n    this.schedule()\n  }\n\n  /**\n   * Reruns the oracle when the server republished the active document's diagnostics.\n   *\n   * Publishes the document sync refused — another file, or a version the buffer has moved past — leave\n   * the list identical, and re-asking on those would answer for a document nobody is looking at.\n   */\n  public diagnosticsChanged(): void {\n    const diagnostics = this.options.getDiagnostics()\n    if (diagnostics === this.seenDiagnostics) return\n\n    this.seenDiagnostics = diagnostics\n    this.schedule()\n  }\n\n  /**\n   * Applies the preferred quick fix at the caret.\n   *\n   * Reports handled as soon as the edit is on its way: an action the server has not filled in yet\n   * needs a round trip, and returning false would let the keystroke fall through to another binding\n   * after the fix was already committed to.\n   */\n  public applyAutoFix(): boolean {\n    if (this.disposed) return false\n\n    const active = this.options.getActiveDocument()\n    if (!active) return false\n\n    const fix = this.fix\n    if (!fix) return false\n\n    const provenance = this.options.router.provenanceOf(fix)\n    if (!provenance) return false\n\n    this.applicationAbort?.abort()\n    const abort = new AbortController()\n    this.applicationAbort = abort\n    void this.runAction(active, fix, provenance, abort)\n    return true\n  }\n\n  public dispose(): void {\n    if (this.disposed) return\n\n    this.disposed = true\n    this.clear()\n  }\n\n  private schedule(): void {\n    this.clear()\n    /**\n     * @justification Debounces a question to the language server against the caret and the\n     * diagnostics, not against rendering, and `clear()` withdraws it on every further change — so a\n     * fix is never computed against text the reader has already moved past.\n     */\n    this.timer = setTimeout(() => {\n      this.timer = null\n      void this.request()\n    }, CODE_ACTION_DEBOUNCE_MS)\n  }\n\n  private clear(): void {\n    if (this.timer) clearTimeout(this.timer)\n    this.timer = null\n    this.abort?.abort()\n    this.abort = null\n    this.applicationAbort?.abort()\n    this.applicationAbort = null\n    this.requestId += 1\n    this.fix = null\n  }\n\n  private async request(): Promise<void> {\n    const active = this.options.getActiveDocument()\n    if (!active) return\n    if (!this.options.router.hasReady('codeActions', 'textDocument/codeAction')) return\n\n    const selection = this.options.context.getSnapshot().selections[0]\n    if (!selection) return\n\n    const range = codeActionAutoTriggerRange(active, selection.startOffset, selection.endOffset)\n    if (!range) return\n\n    const abort = new AbortController()\n    const requestId = this.requestId + 1\n    this.requestId = requestId\n    this.abort = abort\n\n    try {\n      const response = await this.options.router.request<CodeActionResponse>(\n        'textDocument/codeAction',\n        {\n          context: {\n            diagnostics: diagnosticsOverlapping(active, this.options.getDiagnostics(), range),\n            // The auto fix can apply nothing else, so asking for the wider hierarchy would make\n            // every settled keystroke pay for refactors that are thrown away on arrival.\n            only: [CODE_ACTION_QUICK_FIX_KIND],\n            triggerKind: CODE_ACTION_TRIGGER_AUTOMATIC,\n          },\n          range: {\n            end: offsetToLspPositionInSnapshot(active, range.end),\n            start: offsetToLspPositionInSnapshot(active, range.start),\n          },\n          textDocument: { uri: active.uri },\n        },\n        { signal: abort.signal },\n      )\n      if (requestId !== this.requestId) return\n      if (this.disposed) return\n      if (active !== this.options.getActiveDocument()) return\n\n      // Narrowed again on arrival, because `only` is a hint the server is free to ignore.\n      this.fix = preferredQuickFix(response, this.resolvesActions())\n    } catch (error) {\n      if (!isAbortError(error)) this.options.onRequestError(error)\n    }\n  }\n\n  private async runAction(\n    active: ActiveDocument,\n    action: lsp.CodeAction,\n    provenance: LanguageServerCodeActionProvenance,\n    abort: AbortController,\n  ): Promise<void> {\n    try {\n      if (action.command) {\n        this.reportUnsupportedCommand(action)\n        return\n      }\n\n      const owned = action.edit\n        ? { action, ...provenance }\n        : await this.options.router.resolveOwnedCodeAction(action, { signal: abort.signal })\n      if (!owned) return\n      if (!this.isCurrentApplication(active, abort)) return\n      if (owned.action.command) {\n        this.reportUnsupportedCommand(owned.action)\n        return\n      }\n\n      await this.dispatchAction(active, owned.action, owned, abort.signal)\n    } catch (error) {\n      if (!isAbortError(error)) this.options.onRequestError(error)\n    } finally {\n      if (this.applicationAbort === abort) this.applicationAbort = null\n    }\n  }\n\n  private resolvesActions(): boolean {\n    return this.options.router.canResolveCodeActions()\n  }\n\n  private async dispatchAction(\n    active: ActiveDocument,\n    action: lsp.CodeAction,\n    provenance: LanguageServerCodeActionProvenance,\n    signal: AbortSignal,\n  ): Promise<void> {\n    if (!action.edit) {\n      this.reportUnsupportedCommand(action)\n      return\n    }\n\n    const parsed = parseWorkspaceEdit(action.edit)\n    if (!parsed.ok) {\n      this.options.onRequestError(new Error(parsed.error.reason))\n      return\n    }\n    const origin = currentWorkspaceEditOrigin(provenance.guard, active, parsed.value)\n    if (!origin) return\n    if (signal.aborted) return\n\n    const apply = provenance.lane.onApplyWorkspaceEdit\n    if (!apply) {\n      this.options.onRequestError(\n        new Error(`\"${action.title}\" cannot be applied without a workspace edit host.`),\n      )\n      return\n    }\n\n    const result = await apply({\n      guard: provenance.guard,\n      label: action.title,\n      logicalRevisionScope: provenance.lane.connection.logicalRevisionScope,\n      originUri: active.uri,\n      originVersion: origin.version,\n      plan: parsed.value,\n      serverId: provenance.lane.id,\n      signal,\n      source: 'code-action',\n    })\n    this.reportHostFailure(result)\n  }\n\n  private isCurrentApplication(active: ActiveDocument, abort: AbortController): boolean {\n    if (this.disposed) return false\n    if (abort.signal.aborted) return false\n    return active === this.options.getActiveDocument()\n  }\n\n  private reportUnsupportedCommand(action: lsp.CodeAction): void {\n    this.options.onRequestError(\n      new Error(`\"${action.title}\" includes a server command, which this editor cannot run.`),\n    )\n  }\n\n  private reportHostFailure(result: ApplyWorkspaceEditResult): void {\n    if (result.status !== 'failed') return\n    this.options.onRequestError(new Error(`${result.code}: ${result.message}`))\n  }\n}\n\n/** A literal's own `command` is an object; only the bare form names its command with a string. */\nfunction isCommand(entry: lsp.Command | lsp.CodeAction): entry is lsp.Command {\n  return typeof (entry as lsp.Command).command === 'string'\n}\n\n/**\n * Whether `kind` is the quick-fix kind or sits beneath it in the dotted hierarchy.\n *\n * Containment, not equality: a server that names its actions precisely answers `quickfix.import`,\n * and comparing the strings whole would reject every one of those. An action that named no kind at\n * all placed itself nowhere, so it is not in this subtree either.\n */\nfunction isQuickFixKind(kind: string | undefined): boolean {\n  if (kind === undefined) return false\n\n  return kind === CODE_ACTION_QUICK_FIX_KIND || kind.startsWith(`${CODE_ACTION_QUICK_FIX_KIND}.`)\n}\n\nfunction diagnosticsOverlapping(\n  document: LspTextDocumentSnapshot,\n  diagnostics: readonly lsp.Diagnostic[],\n  range: OffsetRange,\n): lsp.Diagnostic[] {\n  return diagnostics.filter((diagnostic) => {\n    const start = lspPositionToOffsetInSnapshot(document, diagnostic.range.start)\n    const end = lspPositionToOffsetInSnapshot(document, diagnostic.range.end)\n    return start <= range.end && end >= range.start\n  })\n}\n\nfunction isWhitespace(character: string | undefined): boolean {\n  return character !== undefined && /\\s/.test(character)\n}\n\nfunction isAbortError(error: unknown): boolean {\n  if (error instanceof DOMException && error.name === 'AbortError') return true\n  if (!isRecord(error)) return false\n  return error.name === 'LspRequestCancelledError'\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n"],"mappings":"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"}

package/dist/colorAlpha.d.ts

@@ -0,0 +1,4 @@
+/** Resolve registered CSS colors against the editor that supplies their theme variables. */
+export declare function readColorAlpha(source: HTMLElement, color: string): number;
+export declare function colorAlpha(color: string): number;
+//# sourceMappingURL=colorAlpha.d.ts.map

package/dist/colorAlpha.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorAlpha.d.ts","sourceRoot":"","sources":["../src/colorAlpha.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAWzE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWhD"}

package/dist/colorAlpha.js

@@ -0,0 +1,28 @@
+//#region src/colorAlpha.ts
+/** Resolve registered CSS colors against the editor that supplies their theme variables. */
+function readColorAlpha(source, color) {
+	const probe = source.ownerDocument.createElement("span");
+	probe.style.cssText = "display:none";
+	probe.style.color = color;
+	source.append(probe);
+	try {
+		return colorAlpha(source.ownerDocument.defaultView?.getComputedStyle(probe).color ?? color);
+	} finally {
+		probe.remove();
+	}
+}
+function colorAlpha(color) {
+	if (color === "transparent") return 0;
+	if (/^#[\da-f]{4}$/i.test(color)) return Number.parseInt(color[4] + color[4], 16) / 255;
+	if (/^#[\da-f]{8}$/i.test(color)) return Number.parseInt(color.slice(7), 16) / 255;
+	let component = null;
+	if (color.includes("/")) component = color.slice(color.lastIndexOf("/") + 1, -1).trim();
+	if (/^rgba?\(/.test(color) && color.split(",").length === 4) component = color.slice(color.lastIndexOf(",") + 1, -1).trim();
+	if (component === null) return 1;
+	const alpha = Number.parseFloat(component) / (component.endsWith("%") ? 100 : 1);
+	return Number.isFinite(alpha) ? Math.max(0, Math.min(1, alpha)) : 1;
+}
+//#endregion
+export { colorAlpha, readColorAlpha };
+
+//# sourceMappingURL=colorAlpha.js.map

package/dist/colorAlpha.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorAlpha.js","names":[],"sources":["../src/colorAlpha.ts"],"sourcesContent":["/** Resolve registered CSS colors against the editor that supplies their theme variables. */\nexport function readColorAlpha(source: HTMLElement, color: string): number {\n  const probe = source.ownerDocument.createElement('span')\n  probe.style.cssText = 'display:none'\n  probe.style.color = color\n  source.append(probe)\n  try {\n    const resolved = source.ownerDocument.defaultView?.getComputedStyle(probe).color ?? color\n    return colorAlpha(resolved)\n  } finally {\n    probe.remove()\n  }\n}\n\nexport function colorAlpha(color: string): number {\n  if (color === 'transparent') return 0\n  if (/^#[\\da-f]{4}$/i.test(color)) return Number.parseInt(color[4]! + color[4]!, 16) / 255\n  if (/^#[\\da-f]{8}$/i.test(color)) return Number.parseInt(color.slice(7), 16) / 255\n  let component: string | null = null\n  if (color.includes('/')) component = color.slice(color.lastIndexOf('/') + 1, -1).trim()\n  if (/^rgba?\\(/.test(color) && color.split(',').length === 4)\n    component = color.slice(color.lastIndexOf(',') + 1, -1).trim()\n  if (component === null) return 1\n  const alpha = Number.parseFloat(component) / (component.endsWith('%') ? 100 : 1)\n  return Number.isFinite(alpha) ? Math.max(0, Math.min(1, alpha)) : 1\n}\n"],"mappings":";;AACA,SAAgB,eAAe,QAAqB,OAAuB;CACzE,MAAM,QAAQ,OAAO,cAAc,cAAc,MAAM;CACvD,MAAM,MAAM,UAAU;CACtB,MAAM,MAAM,QAAQ;CACpB,OAAO,OAAO,KAAK;CACnB,IAAI;EAEF,OAAO,WADU,OAAO,cAAc,aAAa,iBAAiB,KAAK,CAAC,CAAC,SAAS,KAC1D;CAC5B,UAAU;EACR,MAAM,OAAO;CACf;AACF;AAEA,SAAgB,WAAW,OAAuB;CAChD,IAAI,UAAU,eAAe,OAAO;CACpC,IAAI,iBAAiB,KAAK,KAAK,GAAG,OAAO,OAAO,SAAS,MAAM,KAAM,MAAM,IAAK,EAAE,IAAI;CACtF,IAAI,iBAAiB,KAAK,KAAK,GAAG,OAAO,OAAO,SAAS,MAAM,MAAM,CAAC,GAAG,EAAE,IAAI;CAC/E,IAAI,YAA2B;CAC/B,IAAI,MAAM,SAAS,GAAG,GAAG,YAAY,MAAM,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,KAAK;CACtF,IAAI,WAAW,KAAK,KAAK,KAAK,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,GACxD,YAAY,MAAM,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,KAAK;CAC/D,IAAI,cAAc,MAAM,OAAO;CAC/B,MAAM,QAAQ,OAAO,WAAW,SAAS,KAAK,UAAU,SAAS,GAAG,IAAI,MAAM;CAC9E,OAAO,OAAO,SAAS,KAAK,IAAI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,CAAC,IAAI;AACpE"}