@hydranium/glsp-client-theia 1.0.0-next.10

package/lib/browser/hydranium-glsp-diagram-configuration.js

@@ -0,0 +1,72 @@
+"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.AbstractHydraniumGlspDiagramConfiguration = void 0;
+const theia_integration_1 = require("@eclipse-glsp/theia-integration");
+const inversify_1 = require("@theia/core/shared/inversify");
+const diagram_only_marker_manager_js_1 = require("./diagram-only-marker-manager.js");
+/**
+ * `GLSPDiagramConfiguration` base for hydranium adopters. By default GLSP
+ * validation markers propagate into Theia's Problems view (the stock
+ * `@eclipse-glsp/theia-integration` behaviour); a head that already publishes
+ * the same diagnostics over LSP suppresses that propagation by setting
+ * {@link propagateMarkersToProblemsView} to `false`.
+ *
+ * **When to suppress.** A head with a co-resident LSP that publishes its
+ * diagnostics over standard LSP `publishDiagnostics` would otherwise list each
+ * error twice: GLSP's `TheiaMarkerManager` pushes the *same* errors again under
+ * a different marker owner, and Theia shows the union across owners. The GLSP
+ * path is also open-diagram-scoped (markers clear when the diagram closes), so
+ * for such a head it cannot reproduce the LSP head's persistent, cross-file
+ * Problems entries — it is only ever a flickering duplicate. A graphical-only
+ * head (no LSP diagnostics, or markers the LSP never produces) keeps the
+ * default so its markers reach the Problems view. The on-diagram decoration is
+ * a separate client feedback path (`ApplyMarkersCommand`), unaffected either
+ * way.
+ *
+ * **How.** {@link initializeContainer} hands {@link connectTheiaMarkerManager}
+ * the Theia marker-manager factory by default; when suppression is enabled it
+ * hands a no-op {@link ExternalMarkerManager} factory instead, so the
+ * per-diagram container binds a manager that renders-but-does-not-forward and
+ * the real `TheiaMarkerManager` (with its `@postConstruct`
+ * `ProblemManager`/shell subscriptions) is never constructed.
+ *
+ * NB: this overrides `GLSPDiagramConfiguration.initializeContainer` rather than
+ * calling `super`. It mirrors the base body (context-menu + marker-manager
+ * wiring); revisit if a future `@eclipse-glsp/theia-integration` adds further
+ * setup there.
+ */
+let AbstractHydraniumGlspDiagramConfiguration = class AbstractHydraniumGlspDiagramConfiguration extends theia_integration_1.GLSPDiagramConfiguration {
+    /**
+     * Whether GLSP markers propagate into Theia's Problems view. `true` (the
+     * framework default) keeps the stock Theia propagation; set `false` for a
+     * head with a co-resident LSP that already publishes the same diagnostics,
+     * to render markers on the diagram only and avoid double-listing.
+     */
+    propagateMarkersToProblemsView = true;
+    initializeContainer(container) {
+        (0, theia_integration_1.connectTheiaContextMenuService)(container, this.contextMenuServiceFactory);
+        const markerManagerFactory = this.propagateMarkersToProblemsView
+            ? this.theiaMarkerManager
+            : () => new diagram_only_marker_manager_js_1.NoOpExternalMarkerManager();
+        (0, theia_integration_1.connectTheiaMarkerManager)(container, markerManagerFactory, this.diagramType);
+    }
+};
+exports.AbstractHydraniumGlspDiagramConfiguration = AbstractHydraniumGlspDiagramConfiguration;
+exports.AbstractHydraniumGlspDiagramConfiguration = AbstractHydraniumGlspDiagramConfiguration = __decorate([
+    (0, inversify_1.injectable)()
+], AbstractHydraniumGlspDiagramConfiguration);
+//# sourceMappingURL=hydranium-glsp-diagram-configuration.js.map

package/lib/browser/hydranium-glsp-diagram-configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydranium-glsp-diagram-configuration.js","sourceRoot":"","sources":["../../src/browser/hydranium-glsp-diagram-configuration.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;AAGlF,uEAAsI;AACtI,4DAA0E;AAC1E,qFAA6E;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEI,IAAe,yCAAyC,GAAxD,MAAe,yCAA0C,SAAQ,4CAAwB;IAC7F;;;;;OAKG;IACO,8BAA8B,GAAG,IAAI,CAAC;IAE7B,mBAAmB,CAAC,SAAoB;QACxD,IAAA,kDAA8B,EAAC,SAAS,EAAE,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAC1E,MAAM,oBAAoB,GAAG,IAAI,CAAC,8BAA8B;YAC7D,CAAC,CAAC,IAAI,CAAC,kBAAkB;YACzB,CAAC,CAAC,GAA0B,EAAE,CAAC,IAAI,0DAAyB,EAAE,CAAC;QAClE,IAAA,6CAAyB,EAAC,SAAS,EAAE,oBAAoB,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAChF,CAAC;CACH,CAAA;AAhBqB,8FAAyC;oDAAzC,yCAAyC;IAD9D,IAAA,sBAAU,GAAE;GACS,yCAAyC,CAgB9D"}

package/lib/browser/index.d.ts

@@ -0,0 +1,20 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export * from './action-dispatcher';
+export * from './client-contribution';
+export * from './diagram-loader';
+export * from './diagram-only-marker-manager';
+export * from './diagram-widget';
+export * from './glsp-client-theia-module';
+export * from './glsp-diagram-manager';
+export * from './glsp-message-service';
+export * from './glsp-theia-frontend-module';
+export * from './hidden-bounds-updater';
+export * from './hydranium-glsp-diagram-configuration';
+//# sourceMappingURL=index.d.ts.map

package/lib/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wCAAwC,CAAC"}

package/lib/browser/index.js

@@ -0,0 +1,38 @@
+"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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Browser-side framework primitives for GLSP-on-Theia adopters.
+// The cross-head Output-channel logger lives in `@hydranium/client-theia/browser`.
+__exportStar(require("./action-dispatcher"), exports);
+__exportStar(require("./client-contribution"), exports);
+__exportStar(require("./diagram-loader"), exports);
+__exportStar(require("./diagram-only-marker-manager"), exports);
+__exportStar(require("./diagram-widget"), exports);
+__exportStar(require("./glsp-client-theia-module"), exports);
+__exportStar(require("./glsp-diagram-manager"), exports);
+__exportStar(require("./glsp-message-service"), exports);
+__exportStar(require("./glsp-theia-frontend-module"), exports);
+__exportStar(require("./hidden-bounds-updater"), exports);
+__exportStar(require("./hydranium-glsp-diagram-configuration"), exports);
+//# sourceMappingURL=index.js.map

package/lib/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,gEAAgE;AAChE,mFAAmF;AACnF,sDAAoC;AACpC,wDAAsC;AACtC,mDAAiC;AACjC,gEAA8C;AAC9C,mDAAiC;AACjC,6DAA2C;AAC3C,yDAAuC;AACvC,yDAAuC;AACvC,+DAA6C;AAC7C,0DAAwC;AACxC,yEAAuD"}

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export * from './browser/index';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAelF,cAAc,iBAAiB,CAAC"}

package/lib/index.js

@@ -0,0 +1,39 @@
+"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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Root barrel re-exports the browser-side surface, mirroring the root entry of
+// the package this one integrates: `@eclipse-glsp/theia-integration`'s own
+// `main` is its browser tier, so an adopter importing the bare specifier
+// expects the same surface here.
+//
+// That makes this root BROWSER-BOUND, not neutral, and not merely
+// DOM-avoiding: the re-exported tier value-imports `@theia/workspace`'s and
+// `@theia/output`'s browser modules, which touch `document` at module load, and
+// its dependency graph imports stylesheets, so loading it needs a bundler with a
+// CSS loader. It is a frontend entry and nothing else. Node-side primitives
+// (connection-handler wiring) stay behind
+// `@hydranium/glsp-client-theia/node` so the `@theia/core/lib/node/...`
+// imports don't leak into a browser bundle.
+__exportStar(require("./browser/index"), exports);
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,+EAA+E;AAC/E,2EAA2E;AAC3E,yEAAyE;AACzE,iCAAiC;AACjC,EAAE;AACF,kEAAkE;AAClE,4EAA4E;AAC5E,gFAAgF;AAChF,iFAAiF;AACjF,4EAA4E;AAC5E,0CAA0C;AAC1C,wEAAwE;AACxE,4CAA4C;AAC5C,kDAAgC"}

package/lib/node/connection-container-module.d.ts

@@ -0,0 +1,22 @@
+/********************************************************************************
+ * 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 { ConnectionHandler } from '@theia/core';
+import { ContainerModule, type interfaces } from '@theia/core/shared/inversify';
+/**
+ * Creates the frontend-scoped Theia backend module that registers a GLSP
+ * `ConnectionHandler` per browser-frontend connection. Returns a ready-to-
+ * export `ContainerModule` so adopters can `export default createGlspConnectionContainerModule(MyHandler)`
+ * from their backend-module entry point.
+ *
+ * The wrapping `ContainerModule + ConnectionContainerModule.create` pattern
+ * mirrors the boilerplate every Theia GLSP adopter writes by hand; lifted so
+ * adopters declare only the handler class.
+ */
+export declare function createGlspConnectionContainerModule(handlerClass: interfaces.Newable<ConnectionHandler>): ContainerModule;
+//# sourceMappingURL=connection-container-module.d.ts.map

package/lib/node/connection-container-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-container-module.d.ts","sourceRoot":"","sources":["../../src/node/connection-container-module.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAEhF;;;;;;;;;GASG;AACH,wBAAgB,mCAAmC,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,iBAAiB,CAAC,GAAG,eAAe,CAUxH"}

package/lib/node/connection-container-module.js

@@ -0,0 +1,36 @@
+"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
+ ********************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGlspConnectionContainerModule = createGlspConnectionContainerModule;
+const core_1 = require("@theia/core");
+const connection_container_module_1 = require("@theia/core/lib/node/messaging/connection-container-module");
+const inversify_1 = require("@theia/core/shared/inversify");
+/**
+ * Creates the frontend-scoped Theia backend module that registers a GLSP
+ * `ConnectionHandler` per browser-frontend connection. Returns a ready-to-
+ * export `ContainerModule` so adopters can `export default createGlspConnectionContainerModule(MyHandler)`
+ * from their backend-module entry point.
+ *
+ * The wrapping `ContainerModule + ConnectionContainerModule.create` pattern
+ * mirrors the boilerplate every Theia GLSP adopter writes by hand; lifted so
+ * adopters declare only the handler class.
+ */
+function createGlspConnectionContainerModule(handlerClass) {
+    const frontendScopedConnectionModule = connection_container_module_1.ConnectionContainerModule.create(({ bind }) => {
+        bind(handlerClass).toSelf().inSingletonScope();
+        bind(core_1.ConnectionHandler)
+            .toDynamicValue(context => context.container.get(handlerClass))
+            .inSingletonScope();
+    });
+    return new inversify_1.ContainerModule(bind => {
+        bind(connection_container_module_1.ConnectionContainerModule).toConstantValue(frontendScopedConnectionModule);
+    });
+}
+//# sourceMappingURL=connection-container-module.js.map

package/lib/node/connection-container-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-container-module.js","sourceRoot":"","sources":["../../src/node/connection-container-module.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;AAgBlF,kFAUC;AAxBD,sCAAgD;AAChD,4GAAuG;AACvG,4DAAgF;AAEhF;;;;;;;;;GASG;AACH,SAAgB,mCAAmC,CAAC,YAAmD;IACpG,MAAM,8BAA8B,GAAG,uDAAyB,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;QAClF,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;QAC/C,IAAI,CAAC,wBAAiB,CAAC;aACnB,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;aAC9D,gBAAgB,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,2BAAe,CAAC,IAAI,CAAC,EAAE;QAC/B,IAAI,CAAC,uDAAyB,CAAC,CAAC,eAAe,CAAC,8BAA8B,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/lib/node/glsp-server-connection-handler.d.ts

@@ -0,0 +1,49 @@
+/********************************************************************************
+ * 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 { AbstractSocketForwardingConnectionHandler } from '@hydranium/client-theia/lib/node';
+import { type Channel, type Disposable } from '@theia/core';
+import type * as net from 'net';
+/** Options for `GlspServerConnectionHandler`. The language contribution
+ *  id determines the per-language servicePath that Theia routes browser-frontend
+ *  connections to; the port command is the Theia/VS Code command id whose return
+ *  value is the GLSP server's listening port. */
+export interface GlspServerConnectionHandlerOptions {
+    readonly languageContributionId: string;
+    readonly portCommand: string;
+    readonly findPortTimeout?: number;
+    readonly findPortAttempts?: number;
+    readonly connectTimeoutMs?: number;
+    /**
+     * Optional diagnostic hook called immediately after the outbound
+     * `net.Socket` to the GLSP server is created, BEFORE `socket.connect()`
+     * is invoked. Adopters use this to attach `'data'` / `'close'` listeners
+     * for byte-level observability when debugging wire-level handshake
+     * issues; attaching listeners before `connect()` is what guarantees the
+     * very first bytes are observed.
+     */
+    readonly onSocketCreated?: (socket: net.Socket) => void;
+}
+/**
+ * Bridges a Theia browser-frontend channel to a GLSP server's TCP socket.
+ *
+ * The port-discovery + buffer-and-replay race fix + connect orchestration live
+ * on the cross-head {@link AbstractSocketForwardingConnectionHandler} base; this
+ * subclass supplies only the GLSP specifics — the per-language servicePath
+ * (`GLSPContribution.servicePath + '/' + languageContributionId`), the port
+ * command, the log labels — and plugs in `@eclipse-glsp/theia-integration`'s
+ * `SocketConnectionForwarder` as the byte relay. Adopters with different
+ * language ids or command names subclass with a one-line `super({...})` call.
+ * Sibling of `@hydranium/data-client-theia`'s `DataServerConnectionHandler`,
+ * which subclasses the same base with its own GLSP-free forwarder.
+ */
+export declare class GlspServerConnectionHandler extends AbstractSocketForwardingConnectionHandler {
+    constructor(options: GlspServerConnectionHandlerOptions);
+    protected forwardToSocketConnection(clientChannel: Channel, socket: net.Socket): Disposable;
+}
+//# sourceMappingURL=glsp-server-connection-handler.d.ts.map

package/lib/node/glsp-server-connection-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-server-connection-handler.d.ts","sourceRoot":"","sources":["../../src/node/glsp-server-connection-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF,OAAO,EAAE,yCAAyC,EAAE,MAAM,kCAAkC,CAAC;AAC7F,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,KAAK,GAAG,MAAM,KAAK,CAAC;AAEhC;;;iDAGiD;AACjD,MAAM,WAAW,kCAAkC;IAChD,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC;CAC1D;AAED;;;;;;;;;;;;GAYG;AACH,qBACa,2BAA4B,SAAQ,yCAAyC;gBAC9D,OAAO,EAAE,kCAAkC;IAapE,SAAS,CAAC,yBAAyB,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,UAAU;CAG7F"}

package/lib/node/glsp-server-connection-handler.js

@@ -0,0 +1,64 @@
+"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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GlspServerConnectionHandler = void 0;
+const common_1 = require("@eclipse-glsp/theia-integration/lib/common");
+const node_1 = require("@eclipse-glsp/theia-integration/lib/node");
+const node_2 = require("@hydranium/client-theia/lib/node");
+const inversify_1 = require("@theia/core/shared/inversify");
+/**
+ * Bridges a Theia browser-frontend channel to a GLSP server's TCP socket.
+ *
+ * The port-discovery + buffer-and-replay race fix + connect orchestration live
+ * on the cross-head {@link AbstractSocketForwardingConnectionHandler} base; this
+ * subclass supplies only the GLSP specifics — the per-language servicePath
+ * (`GLSPContribution.servicePath + '/' + languageContributionId`), the port
+ * command, the log labels — and plugs in `@eclipse-glsp/theia-integration`'s
+ * `SocketConnectionForwarder` as the byte relay. Adopters with different
+ * language ids or command names subclass with a one-line `super({...})` call.
+ * Sibling of `@hydranium/data-client-theia`'s `DataServerConnectionHandler`,
+ * which subclasses the same base with its own GLSP-free forwarder.
+ */
+let GlspServerConnectionHandler = class GlspServerConnectionHandler extends node_2.AbstractSocketForwardingConnectionHandler {
+    constructor(options) {
+        super({
+            path: common_1.GLSPContribution.servicePath + '/' + options.languageContributionId,
+            portCommand: options.portCommand,
+            logComponent: 'GLSP',
+            serverName: 'Graphical Server',
+            findPortTimeout: options.findPortTimeout,
+            findPortAttempts: options.findPortAttempts,
+            connectTimeoutMs: options.connectTimeoutMs,
+            onSocketCreated: options.onSocketCreated
+        });
+    }
+    forwardToSocketConnection(clientChannel, socket) {
+        return new node_1.SocketConnectionForwarder(clientChannel, socket);
+    }
+};
+exports.GlspServerConnectionHandler = GlspServerConnectionHandler;
+exports.GlspServerConnectionHandler = GlspServerConnectionHandler = __decorate([
+    (0, inversify_1.injectable)(),
+    __param(0, (0, inversify_1.unmanaged)()),
+    __metadata("design:paramtypes", [Object])
+], GlspServerConnectionHandler);
+//# sourceMappingURL=glsp-server-connection-handler.js.map

package/lib/node/glsp-server-connection-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-server-connection-handler.js","sourceRoot":"","sources":["../../src/node/glsp-server-connection-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;AAElF,uEAA8E;AAC9E,mEAAqF;AACrF,2DAA6F;AAE7F,4DAAqE;AAwBrE;;;;;;;;;;;;GAYG;AAEI,IAAM,2BAA2B,GAAjC,MAAM,2BAA4B,SAAQ,gDAAyC;IACvF,YAAyB,OAA2C;QACjE,KAAK,CAAC;YACH,IAAI,EAAE,yBAAgB,CAAC,WAAW,GAAG,GAAG,GAAG,OAAO,CAAC,sBAAsB;YACzE,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,YAAY,EAAE,MAAM;YACpB,UAAU,EAAE,kBAAkB;YAC9B,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,eAAe,EAAE,OAAO,CAAC,eAAe;SAC1C,CAAC,CAAC;IACN,CAAC;IAES,yBAAyB,CAAC,aAAsB,EAAE,MAAkB;QAC3E,OAAO,IAAI,gCAAyB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC;CACH,CAAA;AAjBY,kEAA2B;sCAA3B,2BAA2B;IADvC,IAAA,sBAAU,GAAE;IAEG,WAAA,IAAA,qBAAS,GAAE,CAAA;;GADd,2BAA2B,CAiBvC"}

package/lib/node/index.d.ts

@@ -0,0 +1,11 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export * from './connection-container-module';
+export * from './glsp-server-connection-handler';
+//# sourceMappingURL=index.d.ts.map

package/lib/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC"}

package/lib/node/index.js

@@ -0,0 +1,28 @@
+"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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Node-side framework primitives for GLSP-on-Theia adopters.
+__exportStar(require("./connection-container-module"), exports);
+__exportStar(require("./glsp-server-connection-handler"), exports);
+//# sourceMappingURL=index.js.map

package/lib/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,6DAA6D;AAC7D,gEAA8C;AAC9C,mEAAiD"}

package/lib/testing/bind-recorder.d.ts

@@ -0,0 +1,67 @@
+/********************************************************************************
+ * 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 { interfaces } from 'inversify';
+/**
+ * One captured `bind(...)` or `rebind(...)` call on a {@link BindRecorder}.
+ *
+ * `chain` holds the follow-up methods in invocation order, one string per call,
+ * rendered as `name(arg, …)`. Arguments are stringified inline so assertions
+ * can compare structure without re-resolving service identifiers.
+ */
+export interface BindRecorderEntry {
+    readonly kind: 'bind' | 'rebind';
+    readonly token: unknown;
+    readonly chain: string[];
+}
+/**
+ * A spy set of Inversify binding hooks that records every call and its chain.
+ * Hand them to a module-factory under test — they satisfy Inversify's
+ * `interfaces.Bind` / `interfaces.Rebind` / `interfaces.Unbind` /
+ * `interfaces.IsBound` shapes at the call site but never resolve real services.
+ *
+ * Together they match GLSP's `BindingContext`, so a factory taking the whole
+ * context is called as `factory(recorder, options)` — the recorder *is*
+ * structurally a context.
+ *
+ * Use {@link captured} to assert which tokens were touched and with what
+ * fluent chain. {@link find} is a small ergonomic helper for the common
+ * lookup pattern.
+ */
+export interface BindRecorder {
+    readonly bind: interfaces.Bind;
+    readonly rebind: interfaces.Rebind;
+    readonly unbind: interfaces.Unbind;
+    readonly isBound: interfaces.IsBound;
+    readonly captured: readonly BindRecorderEntry[];
+    /** Convenience lookup — returns the first entry matching both `kind` and `token`, or `undefined`. */
+    find(kind: 'bind' | 'rebind', token: unknown): BindRecorderEntry | undefined;
+}
+/** Options for {@link makeBindRecorder}. */
+export interface BindRecorderOptions {
+    /**
+     * What `isBound` answers. Defaults to `true` for every token, matching
+     * production: a head registers its own module *after* the GLSP default
+     * modules, so the tokens a framework module rebinds are already bound. Pass a
+     * list to model a container where only those tokens are bound — e.g. to
+     * exercise a factory's bind-instead-of-rebind fallback.
+     */
+    readonly boundTokens?: readonly unknown[];
+}
+/**
+ * Build a {@link BindRecorder} for testing Inversify module factories without a
+ * real container: hand it to the factory, then assert over {@link BindRecorder.find}.
+ *
+ * The `bind` / `rebind` functions return a chained proxy that ignores its
+ * arguments structurally but records every method invocation as a string.
+ * Stringification: functions → `<className>`, symbols → `Symbol(desc).toString()`,
+ * everything else → `String(value)`. This is enough to assert which tokens are
+ * involved without dragging real service resolution into the test.
+ */
+export declare function makeBindRecorder(options?: BindRecorderOptions): BindRecorder;
+//# sourceMappingURL=bind-recorder.d.ts.map

package/lib/testing/bind-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind-recorder.d.ts","sourceRoot":"","sources":["../../src/testing/bind-recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,qGAAqG;IACrG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAAC;CAC/E;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC5C;AAuBD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAkChF"}

package/lib/testing/bind-recorder.js

@@ -0,0 +1,72 @@
+"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
+ ********************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeBindRecorder = makeBindRecorder;
+/** Methods on Inversify's binding builder that the recorder traps verbatim. */
+const RECORDED_CHAIN_METHODS = [
+    'toSelf',
+    'to',
+    'toService',
+    'toConstantValue',
+    'toDynamicValue',
+    'toFactory',
+    'toFunction',
+    'toAutoFactory',
+    'toProvider',
+    'inSingletonScope',
+    'inTransientScope',
+    'inRequestScope',
+    'whenTargetNamed',
+    'whenTargetTagged',
+    'whenInjectedInto',
+    'onActivation',
+    'onDeactivation'
+];
+/**
+ * Build a {@link BindRecorder} for testing Inversify module factories without a
+ * real container: hand it to the factory, then assert over {@link BindRecorder.find}.
+ *
+ * The `bind` / `rebind` functions return a chained proxy that ignores its
+ * arguments structurally but records every method invocation as a string.
+ * Stringification: functions → `<className>`, symbols → `Symbol(desc).toString()`,
+ * everything else → `String(value)`. This is enough to assert which tokens are
+ * involved without dragging real service resolution into the test.
+ */
+function makeBindRecorder(options = {}) {
+    const captured = [];
+    const stringifyArg = (value) => {
+        if (typeof value === 'function') {
+            return `<${value.name || 'fn'}>`;
+        }
+        if (typeof value === 'symbol') {
+            return value.toString();
+        }
+        return String(value);
+    };
+    const beginEntry = (kind, token) => {
+        const entry = { kind, token, chain: [] };
+        captured.push(entry);
+        const proxy = {};
+        for (const method of RECORDED_CHAIN_METHODS) {
+            proxy[method] = (...args) => {
+                entry.chain.push(`${method}(${args.map(stringifyArg).join(', ')})`);
+                return proxy;
+            };
+        }
+        return proxy;
+    };
+    const bind = ((token) => beginEntry('bind', token));
+    const rebind = ((token) => beginEntry('rebind', token));
+    const unbind = (() => undefined);
+    const isBound = ((token) => options.boundTokens?.includes(token) ?? true);
+    const find = (kind, token) => captured.find(entry => entry.kind === kind && entry.token === token);
+    return { bind, rebind, unbind, isBound, captured, find };
+}
+//# sourceMappingURL=bind-recorder.js.map

package/lib/testing/bind-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind-recorder.js","sourceRoot":"","sources":["../../src/testing/bind-recorder.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;AAoFlF,4CAkCC;AAjED,+EAA+E;AAC/E,MAAM,sBAAsB,GAAG;IAC5B,QAAQ;IACR,IAAI;IACJ,WAAW;IACX,iBAAiB;IACjB,gBAAgB;IAChB,WAAW;IACX,YAAY;IACZ,eAAe;IACf,YAAY;IACZ,kBAAkB;IAClB,kBAAkB;IAClB,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,kBAAkB;IAClB,cAAc;IACd,gBAAgB;CACT,CAAC;AAEX;;;;;;;;;GASG;AACH,SAAgB,gBAAgB,CAAC,UAA+B,EAAE;IAC/D,MAAM,QAAQ,GAAwB,EAAE,CAAC;IAEzC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAU,EAAE;QAC7C,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAC/B,OAAO,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,GAAG,CAAC;QACpC,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,IAAuB,EAAE,KAAc,EAAW,EAAE;QACrE,MAAM,KAAK,GAAsB,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAC5D,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,MAAM,KAAK,GAAoD,EAAE,CAAC;QAClE,KAAK,MAAM,MAAM,IAAI,sBAAsB,EAAE,CAAC;YAC3C,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAe,EAAW,EAAE;gBAC7C,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpE,OAAO,KAAK,CAAC;YAChB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAoB,CAAC;IAChF,MAAM,MAAM,GAAG,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAsB,CAAC;IACtF,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,CAAiC,CAAC;IACjE,MAAM,OAAO,GAAG,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAuB,CAAC;IACzG,MAAM,IAAI,GAAG,CAAC,IAAuB,EAAE,KAAc,EAAiC,EAAE,CACrF,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAExE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5D,CAAC"}

package/lib/testing/index.d.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export * from './bind-recorder';
+//# sourceMappingURL=index.d.ts.map

package/lib/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAOlF,cAAc,iBAAiB,CAAC"}