@hydranium/glsp-client 1.0.0-next → 1.0.0-next.299

package/README.md

@@ -18,6 +18,9 @@ VS Code webview, or a plain browser page. It builds on `@eclipse-glsp/client`.
   rather than dropped.
 - An edge whose labels keep finite bounds without bendpoints, so fit to
   screen frames the diagram instead of blanking it.
+- A plain click on an unselected element that replaces a selection still
+  pending, so two quick clicks on different elements leave only the second
+  selected.
 - One binder that mounts all of it in a diagram container.
 
 ## Install

package/lib/glsp-client-module.d.ts

@@ -19,7 +19,8 @@ export interface GlspClientModuleOptions {
  * Binds the framework's client classes into a GLSP diagram container, whatever
  * hosts it: the instrumented action dispatcher, the failure-reporting diagram
  * loader, the route-repairing hidden-bounds updater, the status overlay that
- * stays on the page, and a sprotty logger that reports through the host's.
+ * stays on the page, the select listener whose plain click replaces a pending
+ * selection, and a sprotty logger that reports through the host's.
  *
  * Call it from the module a host adds AFTER GLSP's defaults, since every class
  * here replaces a token those defaults bind; `rebind` on an unbound token

package/lib/glsp-client-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glsp-client-module.d.ts","sourceRoot":"","sources":["../src/glsp-client-module.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,KAAK,cAAc,EAMrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA4C,KAAK,MAAM,EAAe,MAAM,qBAAqB,CAAC;AAQzG,kDAAkD;AAClD,MAAM,WAAW,uBAAuB;IACrC;;mDAE+C;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,GAAE,uBAA4B,GAAG,IAAI,CAwB3G"}
+{"version":3,"file":"glsp-client-module.d.ts","sourceRoot":"","sources":["../src/glsp-client-module.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,KAAK,cAAc,EAOrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA4C,KAAK,MAAM,EAAe,MAAM,qBAAqB,CAAC;AASzG,kDAAkD;AAClD,MAAM,WAAW,uBAAuB;IACrC;;mDAE+C;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,GAAE,uBAA4B,GAAG,IAAI,CAyB3G"}

package/lib/glsp-client-module.js

@@ -14,6 +14,7 @@ const protocol_1 = require("@hydranium/protocol");
 const action_dispatcher_1 = require("./action-dispatcher");
 const diagram_loader_1 = require("./diagram-loader");
 const hidden_bounds_updater_1 = require("./hidden-bounds-updater");
+const select_mouse_listener_1 = require("./select-mouse-listener");
 const sprotty_logger_adapter_1 = require("./sprotty-logger-adapter");
 const status_overlay_1 = require("./status-overlay");
 const types_1 = require("./types");
@@ -21,7 +22,8 @@ const types_1 = require("./types");
  * Binds the framework's client classes into a GLSP diagram container, whatever
  * hosts it: the instrumented action dispatcher, the failure-reporting diagram
  * loader, the route-repairing hidden-bounds updater, the status overlay that
- * stays on the page, and a sprotty logger that reports through the host's.
+ * stays on the page, the select listener whose plain click replaces a pending
+ * selection, and a sprotty logger that reports through the host's.
  *
  * Call it from the module a host adds AFTER GLSP's defaults, since every class
  * here replaces a token those defaults bind; `rebind` on an unbound token
@@ -58,6 +60,7 @@ function createGlspClientModule(context, options = {}) {
     rebind(client_1.DiagramLoader).to(diagram_loader_1.HydraniumDiagramLoader).inSingletonScope();
     rebind(client_1.GLSPHiddenBoundsUpdater).to(hidden_bounds_updater_1.HydraniumHiddenBoundsUpdater).inSingletonScope();
     rebind(client_1.StatusOverlay).to(status_overlay_1.HydraniumStatusOverlay).inSingletonScope();
+    rebind(client_1.RankedSelectMouseListener).to(select_mouse_listener_1.HydraniumSelectMouseListener).inSingletonScope();
     rebind(client_1.TYPES.ILogger).to(sprotty_logger_adapter_1.SprottyLoggerAdapter).inSingletonScope();
 }
 //# sourceMappingURL=glsp-client-module.js.map

package/lib/glsp-client-module.js.map

@@ -1 +1 @@
-{"version":3,"file":"glsp-client-module.js","sourceRoot":"","sources":["../src/glsp-client-module.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;AAElF,iDAO8B;AAC9B,kDAAyG;AACzG,2DAAoE;AACpE,qDAA0D;AAC1D,mEAAuE;AACvE,qEAAgE;AAChE,qDAA0D;AAC1D,mCAA+C;AAU/C;;;;;;;;;;;;;;;;GAgBG;AACH,gCAAuC,OAAuB,EAAE,OAAO,GAA4B,EAAE;IAClG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC1C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAClB,CAAC,OAAO,CAAC,4BAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,4BAAoB,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvH,CAAC;SAAM,IAAI,CAAC,OAAO,CAAC,4BAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,4BAAoB,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,IAAI,wBAAa,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,4BAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,4BAAoB,CAAC,MAAM,CAAC;aAC7B,cAAc,CAAC,GAAG,CAAC,EAAE;YACnB,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAS,4BAAoB,CAAC,MAAM,CAAC,CAAC;YACtE,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,4BAAoB,CAAC,KAAK,CAAC;gBAC5D,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAQ,4BAAoB,CAAC,KAAK,CAAC;gBACtD,CAAC,CAAC,IAAI,sBAAW,EAAE,CAAC;YACvB,OAAO,IAAI,wBAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC,CAAC;aACD,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,CAAC,iDAA6B,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IAChE,MAAM,CAAC,6BAAoB,CAAC,CAAC,SAAS,CAAC,iDAA6B,CAAC,CAAC;IACtE,MAAM,CAAC,sBAAa,CAAC,CAAC,EAAE,CAAC,uCAAsB,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACpE,MAAM,CAAC,gCAAuB,CAAC,CAAC,EAAE,CAAC,oDAA4B,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACpF,MAAM,CAAC,sBAAa,CAAC,CAAC,EAAE,CAAC,uCAAsB,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACpE,MAAM,CAAC,cAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,6CAAoB,CAAC,CAAC,gBAAgB,EAAE,CAAC;AACrE,CAAC"}
+{"version":3,"file":"glsp-client-module.js","sourceRoot":"","sources":["../src/glsp-client-module.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;AAElF,iDAQ8B;AAC9B,kDAAyG;AACzG,2DAAoE;AACpE,qDAA0D;AAC1D,mEAAuE;AACvE,mEAAuE;AACvE,qEAAgE;AAChE,qDAA0D;AAC1D,mCAA+C;AAU/C;;;;;;;;;;;;;;;;;GAiBG;AACH,gCAAuC,OAAuB,EAAE,OAAO,GAA4B,EAAE;IAClG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC1C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAClB,CAAC,OAAO,CAAC,4BAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,4BAAoB,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvH,CAAC;SAAM,IAAI,CAAC,OAAO,CAAC,4BAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,4BAAoB,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,IAAI,wBAAa,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,4BAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,4BAAoB,CAAC,MAAM,CAAC;aAC7B,cAAc,CAAC,GAAG,CAAC,EAAE;YACnB,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAS,4BAAoB,CAAC,MAAM,CAAC,CAAC;YACtE,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,4BAAoB,CAAC,KAAK,CAAC;gBAC5D,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAQ,4BAAoB,CAAC,KAAK,CAAC;gBACtD,CAAC,CAAC,IAAI,sBAAW,EAAE,CAAC;YACvB,OAAO,IAAI,wBAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC,CAAC;aACD,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,CAAC,iDAA6B,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IAChE,MAAM,CAAC,6BAAoB,CAAC,CAAC,SAAS,CAAC,iDAA6B,CAAC,CAAC;IACtE,MAAM,CAAC,sBAAa,CAAC,CAAC,EAAE,CAAC,uCAAsB,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACpE,MAAM,CAAC,gCAAuB,CAAC,CAAC,EAAE,CAAC,oDAA4B,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACpF,MAAM,CAAC,sBAAa,CAAC,CAAC,EAAE,CAAC,uCAAsB,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACpE,MAAM,CAAC,kCAAyB,CAAC,CAAC,EAAE,CAAC,oDAA4B,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACtF,MAAM,CAAC,cAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,6CAAoB,CAAC,CAAC,gBAAgB,EAAE,CAAC;AACrE,CAAC"}

package/lib/index.d.ts

@@ -13,6 +13,7 @@ export * from './edge';
 export * from './glsp-client';
 export * from './glsp-client-module';
 export * from './hidden-bounds-updater';
+export * from './select-mouse-listener';
 export * from './sprotty-logger-adapter';
 export * from './status-overlay';
 export * from './types';

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAOlF,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAOlF,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC"}

package/lib/index.js

@@ -34,6 +34,7 @@ __exportStar(require("./edge"), exports);
 __exportStar(require("./glsp-client"), exports);
 __exportStar(require("./glsp-client-module"), exports);
 __exportStar(require("./hidden-bounds-updater"), exports);
+__exportStar(require("./select-mouse-listener"), exports);
 __exportStar(require("./sprotty-logger-adapter"), exports);
 __exportStar(require("./status-overlay"), exports);
 __exportStar(require("./types"), exports);

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,4EAA4E;AAC5E,SAAS;AACT,sDAAoC;AACpC,wDAAsC;AACtC,mDAAiC;AACjC,yCAAuB;AACvB,gDAA8B;AAC9B,uDAAqC;AACrC,0DAAwC;AACxC,2DAAyC;AACzC,mDAAiC;AACjC,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,4EAA4E;AAC5E,SAAS;AACT,sDAAoC;AACpC,wDAAsC;AACtC,mDAAiC;AACjC,yCAAuB;AACvB,gDAA8B;AAC9B,uDAAqC;AACrC,0DAAwC;AACxC,0DAAwC;AACxC,2DAAyC;AACzC,mDAAiC;AACjC,0CAAwB"}

package/lib/select-mouse-listener.d.ts

@@ -0,0 +1,30 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import { type Action, type GModelElement, RankedSelectMouseListener, type SelectableElement } from '@eclipse-glsp/client';
+/**
+ * GLSP's select mouse listener, with a plain click on an unselected element
+ * replacing whatever is selected when its action executes.
+ *
+ * The listener names the elements a click deselects from each element's
+ * `selected` flag, which the feedback the previous click's command queues
+ * writes only when that feedback runs; a click landing before then names
+ * nothing, and both elements end up selected. A plain click sends
+ * `deselectAll` instead, which `SelectCommand` resolves against the selection
+ * service as it executes. Reading the service from the listener would still
+ * race the previous click's command, since dispatch is asynchronous.
+ * Ctrl/Cmd-click keeps GLSP's add to the selection; a routing handle keeps
+ * GLSP's path, since `deselectAll` cannot spare the handle's own edge.
+ *
+ * Bound by `createGlspClientModule` via `rebind(RankedSelectMouseListener)`.
+ */
+export declare class HydraniumSelectMouseListener extends RankedSelectMouseListener {
+    protected handleSelectTarget(selectableTarget: SelectableElement, deselectedElements: GModelElement[], event: MouseEvent): (Action | Promise<Action>)[];
+    protected handleDeselectAll(): (Action | Promise<Action>)[];
+}
+//# sourceMappingURL=select-mouse-listener.d.ts.map

package/lib/select-mouse-listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-mouse-listener.d.ts","sourceRoot":"","sources":["../src/select-mouse-listener.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,KAAK,MAAM,EAEX,KAAK,aAAa,EAGlB,yBAAyB,EAEzB,KAAK,iBAAiB,EACxB,MAAM,sBAAsB,CAAC;AAG9B;;;;;;;;;;;;;;;GAeG;AACH,qBACa,4BAA6B,SAAQ,yBAAyB;IACxE,UAAmB,kBAAkB,CAClC,gBAAgB,EAAE,iBAAiB,EACnC,kBAAkB,EAAE,aAAa,EAAE,EACnC,KAAK,EAAE,UAAU,GACjB,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAK9B;IAED,UAAmB,iBAAiB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAEnE;CACH"}

package/lib/select-mouse-listener.js

@@ -0,0 +1,51 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HydraniumSelectMouseListener = void 0;
+const client_1 = require("@eclipse-glsp/client");
+const inversify_1 = require("inversify");
+/**
+ * GLSP's select mouse listener, with a plain click on an unselected element
+ * replacing whatever is selected when its action executes.
+ *
+ * The listener names the elements a click deselects from each element's
+ * `selected` flag, which the feedback the previous click's command queues
+ * writes only when that feedback runs; a click landing before then names
+ * nothing, and both elements end up selected. A plain click sends
+ * `deselectAll` instead, which `SelectCommand` resolves against the selection
+ * service as it executes. Reading the service from the listener would still
+ * race the previous click's command, since dispatch is asynchronous.
+ * Ctrl/Cmd-click keeps GLSP's add to the selection; a routing handle keeps
+ * GLSP's path, since `deselectAll` cannot spare the handle's own edge.
+ *
+ * Bound by `createGlspClientModule` via `rebind(RankedSelectMouseListener)`.
+ */
+let HydraniumSelectMouseListener = class HydraniumSelectMouseListener extends client_1.RankedSelectMouseListener {
+    handleSelectTarget(selectableTarget, deselectedElements, event) {
+        if ((0, client_1.isCtrlOrCmd)(event) || selectableTarget instanceof client_1.GRoutingHandle) {
+            return super.handleSelectTarget(selectableTarget, deselectedElements, event);
+        }
+        return [client_1.SelectAction.setSelection([selectableTarget.id]), client_1.BringToFrontAction.create([selectableTarget.id])];
+    }
+    handleDeselectAll() {
+        return [client_1.SelectAction.setSelection([])];
+    }
+};
+exports.HydraniumSelectMouseListener = HydraniumSelectMouseListener;
+exports.HydraniumSelectMouseListener = HydraniumSelectMouseListener = __decorate([
+    (0, inversify_1.injectable)()
+], HydraniumSelectMouseListener);
+//# sourceMappingURL=select-mouse-listener.js.map

package/lib/select-mouse-listener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-mouse-listener.js","sourceRoot":"","sources":["../src/select-mouse-listener.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;AAElF,iDAS8B;AAC9B,yCAAuC;AAEvC;;;;;;;;;;;;;;;GAeG;AAEI,IAAM,4BAA4B,GAAlC,MAAM,4BAA6B,SAAQ,kCAAyB;IACrD,kBAAkB,CAClC,gBAAmC,EACnC,kBAAmC,EACnC,KAAiB;QAEjB,IAAI,IAAA,oBAAW,EAAC,KAAK,CAAC,IAAI,gBAAgB,YAAY,uBAAc,EAAE,CAAC;YACpE,OAAO,KAAK,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,KAAK,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,CAAC,qBAAY,CAAC,YAAY,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,EAAE,2BAAkB,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/G,CAAC;IAEkB,iBAAiB;QACjC,OAAO,CAAC,qBAAY,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;CACH,CAAA;;uCAfY,4BAA4B;IADxC,IAAA,sBAAU,GAAE;GACA,4BAA4B,CAexC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hydranium/glsp-client",
-  "version": "1.0.0-next",
+  "version": "1.0.0-next.299",
   "description": "Host-neutral client classes for GLSP heads built on @hydranium/glsp-server, the binder that mounts them in a Theia frontend, a VS Code webview or a plain browser page, and the edge whose labels keep finite bounds without bendpoints.",
   "keywords": [
     "diagram",
@@ -59,7 +59,7 @@
   },
   "devDependencies": {
     "@eclipse-glsp/client": "2.7.0",
-    "@hydranium/protocol": "1.0.0-next",
+    "@hydranium/protocol": "1.0.0-next.299",
     "@types/node": "^22.0.0",
     "inversify": "6.2.2",
     "reflect-metadata": "0.2.2",
@@ -69,7 +69,7 @@
   },
   "peerDependencies": {
     "@eclipse-glsp/client": "^2.6.0",
-    "@hydranium/protocol": "^1.0.0-next",
+    "@hydranium/protocol": "1.0.0-next.299",
     "inversify": "^6.0.0",
     "snabbdom": "^3.5.1"
   },

package/src/glsp-client-module.ts

@@ -12,6 +12,7 @@ import {
    DiagramLoader,
    GLSPActionDispatcher,
    GLSPHiddenBoundsUpdater,
+   RankedSelectMouseListener,
    StatusOverlay,
    TYPES
 } from '@eclipse-glsp/client';
@@ -19,6 +20,7 @@ import { type Clock, ConsoleLogger, DefaultTracer, type Logger, SystemClock } fr
 import { HydraniumGlspActionDispatcher } from './action-dispatcher';
 import { HydraniumDiagramLoader } from './diagram-loader';
 import { HydraniumHiddenBoundsUpdater } from './hidden-bounds-updater';
+import { HydraniumSelectMouseListener } from './select-mouse-listener';
 import { SprottyLoggerAdapter } from './sprotty-logger-adapter';
 import { HydraniumStatusOverlay } from './status-overlay';
 import { HydraniumClientTypes } from './types';
@@ -35,7 +37,8 @@ export interface GlspClientModuleOptions {
  * Binds the framework's client classes into a GLSP diagram container, whatever
  * hosts it: the instrumented action dispatcher, the failure-reporting diagram
  * loader, the route-repairing hidden-bounds updater, the status overlay that
- * stays on the page, and a sprotty logger that reports through the host's.
+ * stays on the page, the select listener whose plain click replaces a pending
+ * selection, and a sprotty logger that reports through the host's.
  *
  * Call it from the module a host adds AFTER GLSP's defaults, since every class
  * here replaces a token those defaults bind; `rebind` on an unbound token
@@ -71,5 +74,6 @@ export function createGlspClientModule(context: BindingContext, options: GlspCli
    rebind(DiagramLoader).to(HydraniumDiagramLoader).inSingletonScope();
    rebind(GLSPHiddenBoundsUpdater).to(HydraniumHiddenBoundsUpdater).inSingletonScope();
    rebind(StatusOverlay).to(HydraniumStatusOverlay).inSingletonScope();
+   rebind(RankedSelectMouseListener).to(HydraniumSelectMouseListener).inSingletonScope();
    rebind(TYPES.ILogger).to(SprottyLoggerAdapter).inSingletonScope();
 }

package/src/index.ts

@@ -19,6 +19,7 @@ export * from './edge';
 export * from './glsp-client';
 export * from './glsp-client-module';
 export * from './hidden-bounds-updater';
+export * from './select-mouse-listener';
 export * from './sprotty-logger-adapter';
 export * from './status-overlay';
 export * from './types';

package/src/select-mouse-listener.ts

@@ -0,0 +1,54 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+
+import {
+   type Action,
+   BringToFrontAction,
+   type GModelElement,
+   GRoutingHandle,
+   isCtrlOrCmd,
+   RankedSelectMouseListener,
+   SelectAction,
+   type SelectableElement
+} from '@eclipse-glsp/client';
+import { injectable } from 'inversify';
+
+/**
+ * GLSP's select mouse listener, with a plain click on an unselected element
+ * replacing whatever is selected when its action executes.
+ *
+ * The listener names the elements a click deselects from each element's
+ * `selected` flag, which the feedback the previous click's command queues
+ * writes only when that feedback runs; a click landing before then names
+ * nothing, and both elements end up selected. A plain click sends
+ * `deselectAll` instead, which `SelectCommand` resolves against the selection
+ * service as it executes. Reading the service from the listener would still
+ * race the previous click's command, since dispatch is asynchronous.
+ * Ctrl/Cmd-click keeps GLSP's add to the selection; a routing handle keeps
+ * GLSP's path, since `deselectAll` cannot spare the handle's own edge.
+ *
+ * Bound by `createGlspClientModule` via `rebind(RankedSelectMouseListener)`.
+ */
+@injectable()
+export class HydraniumSelectMouseListener extends RankedSelectMouseListener {
+   protected override handleSelectTarget(
+      selectableTarget: SelectableElement,
+      deselectedElements: GModelElement[],
+      event: MouseEvent
+   ): (Action | Promise<Action>)[] {
+      if (isCtrlOrCmd(event) || selectableTarget instanceof GRoutingHandle) {
+         return super.handleSelectTarget(selectableTarget, deselectedElements, event);
+      }
+      return [SelectAction.setSelection([selectableTarget.id]), BringToFrontAction.create([selectableTarget.id])];
+   }
+
+   protected override handleDeselectAll(): (Action | Promise<Action>)[] {
+      return [SelectAction.setSelection([])];
+   }
+}