@hydranium/glsp-client-vscode 0.0.0-stage → 1.0.0-next

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,133 @@
-# Temporary Holding Version
+# `@hydranium/glsp-client-vscode`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The GLSP head's client side in a VS Code extension built on
+[Hydranium](https://github.com/eclipse-emfcloud/hydranium). Install it when
+your extension opens a diagram in a custom editor: it connects GLSP's VS Code
+integration to the head's socket and hosts the diagram in a webview with the
+framework's client classes.
+
+## What it gives you
+
+- GLSP's VS Code server over the head's socket, with the port looked up when
+  the server starts rather than during activation.
+- A custom editor whose webview document carries a Content-Security-Policy
+  that grants sprotty what it needs and no `eval`, and the element the diagram
+  mounts into.
+- A webview starter that adds `@hydranium/glsp-client`'s classes to the
+  diagram container, after GLSP's VS Code modules and before your diagram's.
+
+## Install
+
+```bash
+npm install @hydranium/glsp-client-vscode
+```
+
+| Peer                                       | Range         |
+| ------------------------------------------ | ------------- |
+| `@eclipse-glsp/client`                     | `^2.6.0`      |
+| `@eclipse-glsp/vscode-integration`         | `^2.6.0`      |
+| `@eclipse-glsp/vscode-integration-webview` | `^2.6.0`      |
+| `@hydranium/glsp-client`                   | `^1.0.0-next` |
+| `@hydranium/protocol`                      | `^1.0.0-next` |
+| `inversify`                                | `^6.0.0`      |
+| `vscode-jsonrpc`                           | `^9.0.0`      |
+
+## Wiring
+
+In the extension host, give GLSP's connector the server, start it without
+awaiting it, report a failure off `onReady`, and register your editor, a
+subclass naming the diagram type, the webview bundle and a title. `findPort`
+is your lookup of the head's port, such as `findPort` from
+`@hydranium/client-vscode/node` on your language client:
+
+<!-- snippet-preamble
+declare function findGlspPort(): Promise<number>;
+-->
+
+```ts
+import { GlspVscodeConnector } from '@eclipse-glsp/vscode-integration';
+import { HydraniumGlspEditorProvider, HydraniumGlspVscodeServer } from '@hydranium/glsp-client-vscode/node';
+import { ConsoleLogger } from '@hydranium/protocol';
+import { window, type ExtensionContext } from 'vscode';
+
+class MyDiagramEditorProvider extends HydraniumGlspEditorProvider {
+   override diagramType = 'my-diagram';
+   protected override readonly scriptPath = 'out/webview/diagram.js';
+   protected override readonly stylePath = 'out/webview/diagram.css';
+   protected override readonly title = 'My Diagram';
+}
+
+export function activate(context: ExtensionContext): void {
+   const server = new HydraniumGlspVscodeServer({
+      clientId: 'my-language-glsp',
+      clientName: 'My Language',
+      findPort: findGlspPort,
+      logger: new ConsoleLogger()
+   });
+   const connector = new GlspVscodeConnector({ server });
+   context.subscriptions.push(server, connector);
+   void server.start();
+   server.onReady.catch((error: unknown) => window.showErrorMessage(`Diagram unavailable: ${String(error)}`));
+   context.subscriptions.push(
+      window.registerCustomEditorProvider('myLanguage.diagram', new MyDiagramEditorProvider(connector, context.extensionUri), {
+         webviewOptions: { retainContextWhenHidden: true }
+      })
+   );
+}
+```
+
+The webview may load from the script's directory and the stylesheet's. The
+diagram mounts into an element of class `DIAGRAM_CONTAINER_CLASS`, from the
+package root, which your webview stylesheet sizes. In the webview bundle,
+start the diagram with a `HydraniumGlspStarter` whose container appends your
+diagram's own container module last:
+
+<!-- snippet-preamble
+import type { ContainerModule } from 'inversify';
+declare const myDiagramModule: ContainerModule;
+-->
+
+```ts
+import { initializeDiagramContainer, type ContainerConfiguration } from '@eclipse-glsp/client';
+import { HydraniumGlspStarter } from '@hydranium/glsp-client-vscode/browser';
+import { Container } from 'inversify';
+
+class MyDiagramStarter extends HydraniumGlspStarter {
+   createContainer(...containerConfiguration: ContainerConfiguration): Container {
+      // `myDiagramModule` is yours: the model and view registrations of your diagram.
+      return initializeDiagramContainer(new Container(), ...containerConfiguration, myDiagramModule);
+   }
+}
+new MyDiagramStarter();
+```
+
+The extension host's tier never reaches `@eclipse-glsp/client`, whose
+stylesheets Node cannot load. Keep your own extension host code off your
+diagram module for the same reason.
+
+For the whole setup, see *Host in VS Code* in
+[Adopting Hydranium](https://github.com/eclipse-emfcloud/hydranium/blob/main/docs/ADOPTING.md).
+
+## Entry points
+
+| Subpath     | Use it for                                      | Runs in                    |
+| ----------- | ----------------------------------------------- | -------------------------- |
+| `.`         | The class name both tiers share                 | anywhere                   |
+| `./node`    | The GLSP server and the diagram's custom editor | the VS Code extension host |
+| `./browser` | The diagram webview's starter                   | a webview                  |
+
+The subpaths need a TypeScript `moduleResolution` that reads `exports`
+(`NodeNext` or `Bundler`); see *Requirements* in
+[Adopting Hydranium](https://github.com/eclipse-emfcloud/hydranium/blob/main/docs/ADOPTING.md).
+
+## Status
+
+Alpha: every release is a prerelease that may break the API, so pin an exact
+version. Guides and known limitations:
+[Adopting Hydranium](https://github.com/eclipse-emfcloud/hydranium/blob/main/docs/ADOPTING.md).
+
+## License
+
+`MIT` — see this package's [`LICENSE`](./LICENSE), and the repository
+[`NOTICE.md`](https://github.com/eclipse-emfcloud/hydranium/blob/main/NOTICE.md)
+for third-party notices.

package/lib/browser/glsp-starter.d.ts

@@ -0,0 +1,27 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 { ContainerConfiguration } from '@eclipse-glsp/client';
+import { GLSPStarter } from '@eclipse-glsp/vscode-integration-webview';
+import { type GlspClientModuleOptions } from '@hydranium/glsp-client';
+/**
+ * The diagram webview's starter: GLSP's handshake with the extension host,
+ * with the framework's client module among the modules the container is built
+ * from.
+ *
+ * The module follows the host's own, since it replaces tokens they bind, and
+ * comes before whatever `createContainer` appends: GLSP's model and view
+ * registries give an element type to the module that registers it last, so a
+ * subclass appends its diagram definition last.
+ */
+export declare abstract class HydraniumGlspStarter extends GLSPStarter {
+    protected getContainerConfiguration(): ContainerConfiguration;
+    /** Options for the framework's client module. Without a logger it logs to the webview's console, the only sink a webview has. */
+    protected glspClientModuleOptions(): GlspClientModuleOptions;
+}
+//# sourceMappingURL=glsp-starter.d.ts.map

package/lib/browser/glsp-starter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-starter.d.ts","sourceRoot":"","sources":["../../src/browser/glsp-starter.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACvE,OAAO,EAA0B,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAG9F;;;;;;;;;GASG;AACH,8BAAsB,oBAAqB,SAAQ,WAAW;IAC3D,UAAmB,yBAAyB,IAAI,sBAAsB,CAOrE;IAED,iIAAiI;IACjI,SAAS,CAAC,uBAAuB,IAAI,uBAAuB,CAE3D;CACH"}

package/lib/browser/glsp-starter.js

@@ -0,0 +1,38 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 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.HydraniumGlspStarter = void 0;
+const vscode_integration_webview_1 = require("@eclipse-glsp/vscode-integration-webview");
+const glsp_client_1 = require("@hydranium/glsp-client");
+const inversify_1 = require("inversify");
+/**
+ * The diagram webview's starter: GLSP's handshake with the extension host,
+ * with the framework's client module among the modules the container is built
+ * from.
+ *
+ * The module follows the host's own, since it replaces tokens they bind, and
+ * comes before whatever `createContainer` appends: GLSP's model and view
+ * registries give an element type to the module that registers it last, so a
+ * subclass appends its diagram definition last.
+ */
+class HydraniumGlspStarter extends vscode_integration_webview_1.GLSPStarter {
+    getContainerConfiguration() {
+        return [
+            ...super.getContainerConfiguration(),
+            new inversify_1.ContainerModule((bind, unbind, isBound, rebind) => (0, glsp_client_1.createGlspClientModule)({ bind, unbind, isBound, rebind }, this.glspClientModuleOptions()))
+        ];
+    }
+    /** Options for the framework's client module. Without a logger it logs to the webview's console, the only sink a webview has. */
+    glspClientModuleOptions() {
+        return {};
+    }
+}
+exports.HydraniumGlspStarter = HydraniumGlspStarter;
+//# sourceMappingURL=glsp-starter.js.map

package/lib/browser/glsp-starter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-starter.js","sourceRoot":"","sources":["../../src/browser/glsp-starter.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;AAGlF,yFAAuE;AACvE,wDAA8F;AAC9F,yCAA4C;AAE5C;;;;;;;;;GASG;AACH,0BAA2C,SAAQ,wCAAW;IACxC,yBAAyB;QACzC,OAAO;YACJ,GAAG,KAAK,CAAC,yBAAyB,EAAE;YACpC,IAAI,2BAAe,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CACnD,IAAA,oCAAsB,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,uBAAuB,EAAE,CAAC,CAC3F;SACH,CAAC;IACL,CAAC;IAED,iIAAiI;IACvH,uBAAuB;QAC9B,OAAO,EAAE,CAAC;IACb,CAAC;CACH"}

package/lib/browser/index.d.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 './glsp-starter';
+//# 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;AAElF,cAAc,gBAAgB,CAAC"}

package/lib/browser/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 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 });
+__exportStar(require("./glsp-starter"), 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,iDAA+B"}

package/lib/diagram-container.d.ts

@@ -0,0 +1,15 @@
+/********************************************************************************
+ * Copyright (c) 2026 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
+ ********************************************************************************/
+/**
+ * The class on the element the diagram mounts into. The extension host writes
+ * it into the webview document and the webview's stylesheet sizes it, so it
+ * lives on the neutral root both tiers reach.
+ */
+export declare const DIAGRAM_CONTAINER_CLASS = "hydranium-diagram-container";
+//# sourceMappingURL=diagram-container.d.ts.map

package/lib/diagram-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-container.d.ts","sourceRoot":"","sources":["../src/diagram-container.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,gCAAgC,CAAC"}

package/lib/diagram-container.js

@@ -0,0 +1,18 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 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.DIAGRAM_CONTAINER_CLASS = void 0;
+/**
+ * The class on the element the diagram mounts into. The extension host writes
+ * it into the webview document and the webview's stylesheet sizes it, so it
+ * lives on the neutral root both tiers reach.
+ */
+exports.DIAGRAM_CONTAINER_CLASS = 'hydranium-diagram-container';
+//# sourceMappingURL=diagram-container.js.map

package/lib/diagram-container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-container.js","sourceRoot":"","sources":["../src/diagram-container.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;AAElF;;;;GAIG;AACU,QAAA,uBAAuB,GAAG,6BAA6B,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 './diagram-container';
+//# 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;AAKlF,cAAc,qBAAqB,CAAC"}

package/lib/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 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 });
+// Neutral: what both tiers name. `./node` is the extension host's, and never
+// reaches `@eclipse-glsp/client`, whose stylesheets Node cannot load;
+// `./browser` is the webview's.
+__exportStar(require("./diagram-container"), 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,6EAA6E;AAC7E,sEAAsE;AACtE,gCAAgC;AAChC,sDAAoC"}

package/lib/node/glsp-editor-provider.d.ts

@@ -0,0 +1,57 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 { GlspEditorProvider, type GlspVscodeConnector } from '@eclipse-glsp/vscode-integration';
+import * as vscode from 'vscode';
+/**
+ * A custom editor whose webview hosts a GLSP diagram: the webview document,
+ * its Content-Security-Policy and the element the diagram mounts into.
+ *
+ * `GlspEditorProvider` already mints the per-view `clientId`, registers the
+ * client on the connector and routes save, revert and dirty state; a subclass
+ * names the diagram type, the bundle and the title.
+ *
+ * The connector's messenger reaches each webview's endpoint through the base
+ * class. `GlspVscodeConnector` constructs it with `ignoreHiddenViews: false`;
+ * a messenger handed to the connector must repeat that, or a hidden diagram tab
+ * misses every message sent to it.
+ */
+export declare abstract class HydraniumGlspEditorProvider extends GlspEditorProvider {
+    protected readonly extensionUri: vscode.Uri;
+    /** The webview's script bundle, relative to the extension root. */
+    protected abstract readonly scriptPath: string;
+    /** The webview's stylesheet, relative to the extension root, if the bundler emits one. */
+    protected readonly stylePath?: string;
+    /** The webview document's title. */
+    protected abstract readonly title: string;
+    constructor(connector: GlspVscodeConnector, extensionUri: vscode.Uri);
+    /**
+     * Populate the webview for one diagram view.
+     *
+     * `clientId` is the connector's: the diagram widget mounts into
+     * `#<clientId>_container`, so a document naming another id loads and renders
+     * nothing.
+     */
+    setUpWebview(_document: vscode.CustomDocument, webviewPanel: vscode.WebviewPanel, _token: vscode.CancellationToken, clientId: string): void;
+    /**
+     * Where the webview may load from: the script's directory and the
+     * stylesheet's. VS Code blocks anything outside them without an error, so a
+     * stylesheet elsewhere would leave the diagram unstyled.
+     */
+    protected localResourceRoots(): vscode.Uri[];
+    /**
+     * The webview document.
+     *
+     * The CSP relaxations are sprotty's: `style-src 'unsafe-inline'` because it
+     * writes inline `style` attributes on the SVG, without which every element is
+     * laid out at the origin, and `font-src data:` for the codicon font a bundler
+     * inlines. `'unsafe-eval'` is not granted; nothing in a GLSP bundle needs it.
+     */
+    protected render(webview: vscode.Webview, clientId: string): string;
+}
+//# sourceMappingURL=glsp-editor-provider.d.ts.map

package/lib/node/glsp-editor-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-editor-provider.d.ts","sourceRoot":"","sources":["../../src/node/glsp-editor-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEhG,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAGjC;;;;;;;;;;;;GAYG;AACH,8BAAsB,2BAA4B,SAAQ,kBAAkB;IAUtE,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG;IAT9C,mEAAmE;IACnE,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC/C,0FAA0F;IAC1F,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IACtC,oCAAoC;IACpC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAE1C,YACG,SAAS,EAAE,mBAAmB,EACX,YAAY,EAAE,MAAM,CAAC,GAAG,EAG7C;IAED;;;;;;OAMG;IACH,YAAY,CACT,SAAS,EAAE,MAAM,CAAC,cAAc,EAChC,YAAY,EAAE,MAAM,CAAC,YAAY,EACjC,MAAM,EAAE,MAAM,CAAC,iBAAiB,EAChC,QAAQ,EAAE,MAAM,GAChB,IAAI,CAIN;IAED;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,IAAI,MAAM,CAAC,GAAG,EAAE,CAS3C;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoBlE;CACH"}

package/lib/node/glsp-editor-provider.js

@@ -0,0 +1,131 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HydraniumGlspEditorProvider = void 0;
+const vscode_integration_1 = require("@eclipse-glsp/vscode-integration");
+const node_crypto_1 = require("node:crypto");
+const vscode = __importStar(require("vscode"));
+const diagram_container_1 = require("../diagram-container");
+/**
+ * A custom editor whose webview hosts a GLSP diagram: the webview document,
+ * its Content-Security-Policy and the element the diagram mounts into.
+ *
+ * `GlspEditorProvider` already mints the per-view `clientId`, registers the
+ * client on the connector and routes save, revert and dirty state; a subclass
+ * names the diagram type, the bundle and the title.
+ *
+ * The connector's messenger reaches each webview's endpoint through the base
+ * class. `GlspVscodeConnector` constructs it with `ignoreHiddenViews: false`;
+ * a messenger handed to the connector must repeat that, or a hidden diagram tab
+ * misses every message sent to it.
+ */
+class HydraniumGlspEditorProvider extends vscode_integration_1.GlspEditorProvider {
+    extensionUri;
+    /** The webview's stylesheet, relative to the extension root, if the bundler emits one. */
+    stylePath;
+    constructor(connector, extensionUri) {
+        super(connector);
+        this.extensionUri = extensionUri;
+    }
+    /**
+     * Populate the webview for one diagram view.
+     *
+     * `clientId` is the connector's: the diagram widget mounts into
+     * `#<clientId>_container`, so a document naming another id loads and renders
+     * nothing.
+     */
+    setUpWebview(_document, webviewPanel, _token, clientId) {
+        const webview = webviewPanel.webview;
+        webview.options = { enableScripts: true, localResourceRoots: this.localResourceRoots() };
+        webview.html = this.render(webview, clientId);
+    }
+    /**
+     * Where the webview may load from: the script's directory and the
+     * stylesheet's. VS Code blocks anything outside them without an error, so a
+     * stylesheet elsewhere would leave the diagram unstyled.
+     */
+    localResourceRoots() {
+        const roots = [vscode.Uri.joinPath(this.extensionUri, this.scriptPath, '..')];
+        if (this.stylePath) {
+            const styleRoot = vscode.Uri.joinPath(this.extensionUri, this.stylePath, '..');
+            if (styleRoot.path !== roots[0].path) {
+                roots.push(styleRoot);
+            }
+        }
+        return roots;
+    }
+    /**
+     * The webview document.
+     *
+     * The CSP relaxations are sprotty's: `style-src 'unsafe-inline'` because it
+     * writes inline `style` attributes on the SVG, without which every element is
+     * laid out at the origin, and `font-src data:` for the codicon font a bundler
+     * inlines. `'unsafe-eval'` is not granted; nothing in a GLSP bundle needs it.
+     */
+    render(webview, clientId) {
+        const script = webview.asWebviewUri(vscode.Uri.joinPath(this.extensionUri, this.scriptPath));
+        const style = this.stylePath ? webview.asWebviewUri(vscode.Uri.joinPath(this.extensionUri, this.stylePath)) : undefined;
+        const nonce = (0, node_crypto_1.randomBytes)(16).toString('base64');
+        return `<!DOCTYPE html>
+<html lang="en">
+   <head>
+      <meta charset="UTF-8" />
+      <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+      <meta
+         http-equiv="Content-Security-Policy"
+         content="default-src 'none'; style-src ${webview.cspSource} 'unsafe-inline'; font-src ${webview.cspSource} data:; img-src ${webview.cspSource} data:; script-src 'nonce-${nonce}';"
+      />
+      <title>${escapeHtml(this.title)}</title>${style ? `\n      <link rel="stylesheet" href="${style}" />` : ''}
+   </head>
+   <body>
+      <div id="${clientId}_container" class="${diagram_container_1.DIAGRAM_CONTAINER_CLASS}"></div>
+      <script nonce="${nonce}" src="${script}"></script>
+   </body>
+</html>`;
+    }
+}
+exports.HydraniumGlspEditorProvider = HydraniumGlspEditorProvider;
+function escapeHtml(text) {
+    return text.replace(/[&<>"']/g, character => `&#${character.charCodeAt(0)};`);
+}
+//# sourceMappingURL=glsp-editor-provider.js.map

package/lib/node/glsp-editor-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-editor-provider.js","sourceRoot":"","sources":["../../src/node/glsp-editor-provider.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAElF,yEAAgG;AAChG,6CAA0C;AAC1C,MAAY,MAAM,mCAAe;AACjC,4DAA+D;AAE/D;;;;;;;;;;;;GAYG;AACH,iCAAkD,SAAQ,uCAAkB;IAUnD,YAAY;IAPlC,0FAA0F;IACvE,SAAS,CAAU;IAItC,YACG,SAA8B,EACX,YAAwB;QAE3C,KAAK,CAAC,SAAS,CAAC,CAAC;4BAFE,YAAY;IAGlC,CAAC;IAED;;;;;;OAMG;IACH,YAAY,CACT,SAAgC,EAChC,YAAiC,EACjC,MAAgC,EAChC,QAAgB;QAEhB,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC;QACrC,OAAO,CAAC,OAAO,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;QACzF,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACO,kBAAkB;QACzB,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;QAC9E,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAClB,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC/E,IAAI,SAAS,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IAChB,CAAC;IAED;;;;;;;OAOG;IACO,MAAM,CAAC,OAAuB,EAAE,QAAgB;QACvD,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7F,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxH,MAAM,KAAK,GAAG,IAAA,yBAAW,EAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACjD,OAAO;;;;;;;kDAOqC,OAAO,CAAC,SAAS,8BAA8B,OAAO,CAAC,SAAS,mBAAmB,OAAO,CAAC,SAAS,6BAA6B,KAAK;;eAEzK,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,wCAAwC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE;;;iBAG/F,QAAQ,sBAAsB,2CAAuB;uBAC/C,KAAK,UAAU,MAAM;;QAEpC,CAAC;IACN,CAAC;CACH;;AAED,SAAS,UAAU,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACjF,CAAC"}

package/lib/node/glsp-vscode-server.d.ts

@@ -0,0 +1,46 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 { SocketGlspVscodeServer } from '@eclipse-glsp/vscode-integration';
+import { type Logger } from '@hydranium/protocol';
+/** What {@link HydraniumGlspVscodeServer} needs beyond the GLSP client identity. */
+export interface HydraniumGlspVscodeServerOptions {
+    readonly clientId: string;
+    readonly clientName: string;
+    /**
+     * Resolve the GLSP head's listening port, typically `findPort` from
+     * `@hydranium/client-vscode/node`. Called when the connection is opened, so
+     * the poll runs at `start()` rather than during activation.
+     */
+    readonly findPort: () => Promise<number>;
+    /** Where the connection to the head logs its protocol faults. */
+    readonly logger: Logger;
+}
+/**
+ * The GLSP head reached over its ephemeral socket, with the port discovered
+ * rather than configured.
+ *
+ * `SocketGlspVscodeServer` takes a fixed `connectionOptions` at construction,
+ * but the head's port is assigned when it binds and published as an LSP
+ * request. Awaiting it in `activate` would block activation behind a poll that
+ * can take seconds, even for a user who never opens a diagram, so the lookup
+ * moves to `createConnection`, which the base class calls from `start()`.
+ * The `connectionOptions` handed to `super` is never read, and is an unusable
+ * port so that a refactor reintroducing the base implementation fails loudly
+ * instead of dialling something.
+ *
+ * Report a failure off `onReady`, not off `start()`: `start()` routes its own
+ * error into the readiness promise and resolves anyway.
+ */
+export declare class HydraniumGlspVscodeServer extends SocketGlspVscodeServer {
+    protected readonly findPort: () => Promise<number>;
+    protected readonly logger: Logger;
+    constructor(options: HydraniumGlspVscodeServerOptions);
+    protected createConnection(): ReturnType<SocketGlspVscodeServer['createConnection']>;
+}
+//# sourceMappingURL=glsp-vscode-server.d.ts.map

package/lib/node/glsp-vscode-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-vscode-server.d.ts","sourceRoot":"","sources":["../../src/node/glsp-vscode-server.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAIpE,oFAAoF;AACpF,MAAM,WAAW,gCAAgC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,yBAA0B,SAAQ,sBAAsB;IAClE,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAElC,YAAY,OAAO,EAAE,gCAAgC,EAQpD;IAED,UAAyB,gBAAgB,IAAI,UAAU,CAAC,sBAAsB,CAAC,kBAAkB,CAAC,CAAC,CAalG;CACH"}

package/lib/node/glsp-vscode-server.js

@@ -0,0 +1,93 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HydraniumGlspVscodeServer = void 0;
+const vscode_integration_1 = require("@eclipse-glsp/vscode-integration");
+const protocol_1 = require("@hydranium/protocol");
+const net = __importStar(require("node:net"));
+const node_1 = require("vscode-jsonrpc/node");
+/**
+ * The GLSP head reached over its ephemeral socket, with the port discovered
+ * rather than configured.
+ *
+ * `SocketGlspVscodeServer` takes a fixed `connectionOptions` at construction,
+ * but the head's port is assigned when it binds and published as an LSP
+ * request. Awaiting it in `activate` would block activation behind a poll that
+ * can take seconds, even for a user who never opens a diagram, so the lookup
+ * moves to `createConnection`, which the base class calls from `start()`.
+ * The `connectionOptions` handed to `super` is never read, and is an unusable
+ * port so that a refactor reintroducing the base implementation fails loudly
+ * instead of dialling something.
+ *
+ * Report a failure off `onReady`, not off `start()`: `start()` routes its own
+ * error into the readiness promise and resolves anyway.
+ */
+class HydraniumGlspVscodeServer extends vscode_integration_1.SocketGlspVscodeServer {
+    findPort;
+    logger;
+    constructor(options) {
+        super({
+            clientId: options.clientId,
+            clientName: options.clientName,
+            connectionOptions: { port: 0 }
+        });
+        this.findPort = options.findPort;
+        this.logger = options.logger;
+    }
+    async createConnection() {
+        const port = await this.findPort();
+        // `127.0.0.1`, not `localhost`, and it has to match the head: `startGlspServer`
+        // binds `127.0.0.1` by default, so on a dual-stack machine where `localhost`
+        // resolves to `::1` first the dial fails as ECONNREFUSED with nothing in the
+        // message naming the address family as the cause.
+        // Built here rather than by the base's `createSocketConnection`, which
+        // passes no logger. GLSP's client sends typed messages built by
+        // `@eclipse-glsp/protocol`'s copy of `vscode-jsonrpc`, so they go by name.
+        const socket = new net.Socket();
+        const connection = (0, node_1.createMessageConnection)(new node_1.SocketMessageReader(socket), new node_1.SocketMessageWriter(socket), this.logger);
+        socket.connect({ port, host: '127.0.0.1' });
+        return (0, protocol_1.sendByMethodName)(connection);
+    }
+}
+exports.HydraniumGlspVscodeServer = HydraniumGlspVscodeServer;
+//# sourceMappingURL=glsp-vscode-server.js.map

package/lib/node/glsp-vscode-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-vscode-server.js","sourceRoot":"","sources":["../../src/node/glsp-vscode-server.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAElF,yEAA0E;AAC1E,kDAAoE;AACpE,MAAY,GAAG,qCAAiB;AAChC,8CAAwG;AAgBxG;;;;;;;;;;;;;;;GAeG;AACH,+BAAuC,SAAQ,2CAAsB;IAC/C,QAAQ,CAAwB;IAChC,MAAM,CAAS;IAElC,YAAY,OAAyC;QAClD,KAAK,CAAC;YACH,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,iBAAiB,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;SAChC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAChC,CAAC;IAEkB,KAAK,CAAC,gBAAgB;QACtC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnC,gFAAgF;QAChF,6EAA6E;QAC7E,6EAA6E;QAC7E,kDAAkD;QAClD,uEAAuE;QACvE,gEAAgE;QAChE,2EAA2E;QAC3E,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,UAAU,GAAG,IAAA,8BAAuB,EAAC,IAAI,0BAAmB,CAAC,MAAM,CAAC,EAAE,IAAI,0BAAmB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1H,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QAC5C,OAAO,IAAA,2BAAgB,EAAC,UAAU,CAAC,CAAC;IACvC,CAAC;CACH"}

package/lib/node/index.d.ts

@@ -0,0 +1,11 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 './glsp-editor-provider';
+export * from './glsp-vscode-server';
+//# 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;AAElF,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}

package/lib/node/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 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 });
+__exportStar(require("./glsp-editor-provider"), exports);
+__exportStar(require("./glsp-vscode-server"), 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,yDAAuC;AACvC,uDAAqC"}

package/package.json

@@ -1,6 +1,91 @@
 {
   "name": "@hydranium/glsp-client-vscode",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0-next",
+  "description": "VS Code client primitives for GLSP heads built on @hydranium/glsp-server: the extension host's GLSP server over a discovered socket port and a custom editor whose webview hosts the diagram, and a webview starter that binds @hydranium/glsp-client's host-neutral classes; companion of @hydranium/glsp-server.",
+  "keywords": [
+    "diagram",
+    "glsp",
+    "hydranium",
+    "langium",
+    "language-server",
+    "lsp",
+    "vscode",
+    "vscode-extension",
+    "webview"
+  ],
+  "homepage": "https://github.com/eclipse-emfcloud/hydranium/tree/main/packages/glsp-client-vscode",
+  "bugs": {
+    "url": "https://github.com/eclipse-emfcloud/hydranium/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Hydranium Team"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eclipse-emfcloud/hydranium.git",
+    "directory": "packages/glsp-client-vscode"
+  },
+  "files": [
+    "lib",
+    "src",
+    "!lib/**/*.tsbuildinfo"
+  ],
+  "sideEffects": false,
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./browser": {
+      "types": "./lib/browser/index.d.ts",
+      "default": "./lib/browser/index.js"
+    },
+    "./node": {
+      "types": "./lib/node/index.d.ts",
+      "default": "./lib/node/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rimraf lib tsconfig.tsbuildinfo",
+    "lint": "oxlint --format stylish --config ../../oxlint.config.cjs src test --max-warnings 0",
+    "prepack": "node -e \"const m=require('./package.json'),fs=require('node:fs');const missing=[m.main,...Object.values(m.bin||{})].filter(entry=>entry&&!fs.existsSync(entry));if(missing.length){console.error('prepack '+m.name+': not built ('+missing.join(', ')+' missing). Run the build before packing: a files entry that matches nothing is skipped silently, so the tarball would ship src only.');process.exit(1);}\"",
+    "test": "npm run typecheck:test && vitest run",
+    "typecheck:test": "tsc --noEmit -p tsconfig.test.json",
+    "watch": "tsc -b -w --preserveWatchOutput"
+  },
+  "devDependencies": {
+    "@eclipse-glsp/client": "2.7.0",
+    "@eclipse-glsp/vscode-integration": "2.7.0",
+    "@eclipse-glsp/vscode-integration-webview": "2.7.0",
+    "@hydranium/glsp-client": "1.0.0-next",
+    "@hydranium/protocol": "1.0.0-next",
+    "@types/node": "^22.0.0",
+    "@types/vscode": "^1.101.0",
+    "inversify": "6.2.2",
+    "rimraf": "^5.0.0",
+    "typescript": "^7.0.2",
+    "vscode-jsonrpc": "9.0.0"
+  },
+  "peerDependencies": {
+    "@eclipse-glsp/client": "^2.6.0",
+    "@eclipse-glsp/vscode-integration": "^2.6.0",
+    "@eclipse-glsp/vscode-integration-webview": "^2.6.0",
+    "@hydranium/glsp-client": "^1.0.0-next",
+    "@hydranium/protocol": "^1.0.0-next",
+    "inversify": "^6.0.0",
+    "vscode-jsonrpc": "^9.0.0"
+  },
+  "engines": {
+    "node": ">=22.13",
+    "vscode": "^1.101.0"
+  },
+  "//peerDependencies": "`vscode-jsonrpc` takes a caret, so the framework shares the transport the LSP connection resolves, which an `init` scaffold pins: each `vscode-languageserver-protocol` release pins its transport exactly, so an exact peer would name a copy a fresh install rarely holds. The caret excludes 8.x, so a tree whose top holds GLSP's copy fails the peer with a named ERESOLVE warning, an error under `--strict-peer-deps`, rather than resolving silently. No peer reaches a NESTED copy, such as GLSP's or one the LSP packages nest. The wire compares message types and `ResponseError`s by copy identity, so the framework sends typed messages by method name and recognises errors with `isResponseError` rather than `instanceof`.",
+  "//prepack": "The publish guard, a `prepack` rather than a `prepare`: `prepack` runs only when a tarball is made (`npm pack`, `npm publish`) and never on install, so it cannot break the install it has no business touching. What it defends against: `files` lists `lib`, `lib` is gitignored, and a `files` entry matching nothing is skipped SILENTLY — so `npm publish` from an unbuilt tree emits a tarball of `src` and nothing else, with no error."
+}

package/src/browser/glsp-starter.ts

@@ -0,0 +1,39 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 { ContainerConfiguration } from '@eclipse-glsp/client';
+import { GLSPStarter } from '@eclipse-glsp/vscode-integration-webview';
+import { createGlspClientModule, type GlspClientModuleOptions } from '@hydranium/glsp-client';
+import { ContainerModule } from 'inversify';
+
+/**
+ * The diagram webview's starter: GLSP's handshake with the extension host,
+ * with the framework's client module among the modules the container is built
+ * from.
+ *
+ * The module follows the host's own, since it replaces tokens they bind, and
+ * comes before whatever `createContainer` appends: GLSP's model and view
+ * registries give an element type to the module that registers it last, so a
+ * subclass appends its diagram definition last.
+ */
+export abstract class HydraniumGlspStarter extends GLSPStarter {
+   protected override getContainerConfiguration(): ContainerConfiguration {
+      return [
+         ...super.getContainerConfiguration(),
+         new ContainerModule((bind, unbind, isBound, rebind) =>
+            createGlspClientModule({ bind, unbind, isBound, rebind }, this.glspClientModuleOptions())
+         )
+      ];
+   }
+
+   /** Options for the framework's client module. Without a logger it logs to the webview's console, the only sink a webview has. */
+   protected glspClientModuleOptions(): GlspClientModuleOptions {
+      return {};
+   }
+}

package/src/browser/index.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 './glsp-starter';

package/src/diagram-container.ts

@@ -0,0 +1,15 @@
+/********************************************************************************
+ * Copyright (c) 2026 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
+ ********************************************************************************/
+
+/**
+ * The class on the element the diagram mounts into. The extension host writes
+ * it into the webview document and the webview's stylesheet sizes it, so it
+ * lives on the neutral root both tiers reach.
+ */
+export const DIAGRAM_CONTAINER_CLASS = 'hydranium-diagram-container';

package/src/index.ts

@@ -0,0 +1,13 @@
+/********************************************************************************
+ * Copyright (c) 2026 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
+ ********************************************************************************/
+
+// Neutral: what both tiers name. `./node` is the extension host's, and never
+// reaches `@eclipse-glsp/client`, whose stylesheets Node cannot load;
+// `./browser` is the webview's.
+export * from './diagram-container';

package/src/node/glsp-editor-provider.ts

@@ -0,0 +1,110 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 { GlspEditorProvider, type GlspVscodeConnector } from '@eclipse-glsp/vscode-integration';
+import { randomBytes } from 'node:crypto';
+import * as vscode from 'vscode';
+import { DIAGRAM_CONTAINER_CLASS } from '../diagram-container';
+
+/**
+ * A custom editor whose webview hosts a GLSP diagram: the webview document,
+ * its Content-Security-Policy and the element the diagram mounts into.
+ *
+ * `GlspEditorProvider` already mints the per-view `clientId`, registers the
+ * client on the connector and routes save, revert and dirty state; a subclass
+ * names the diagram type, the bundle and the title.
+ *
+ * The connector's messenger reaches each webview's endpoint through the base
+ * class. `GlspVscodeConnector` constructs it with `ignoreHiddenViews: false`;
+ * a messenger handed to the connector must repeat that, or a hidden diagram tab
+ * misses every message sent to it.
+ */
+export abstract class HydraniumGlspEditorProvider extends GlspEditorProvider {
+   /** The webview's script bundle, relative to the extension root. */
+   protected abstract readonly scriptPath: string;
+   /** The webview's stylesheet, relative to the extension root, if the bundler emits one. */
+   protected readonly stylePath?: string;
+   /** The webview document's title. */
+   protected abstract readonly title: string;
+
+   constructor(
+      connector: GlspVscodeConnector,
+      protected readonly extensionUri: vscode.Uri
+   ) {
+      super(connector);
+   }
+
+   /**
+    * Populate the webview for one diagram view.
+    *
+    * `clientId` is the connector's: the diagram widget mounts into
+    * `#<clientId>_container`, so a document naming another id loads and renders
+    * nothing.
+    */
+   setUpWebview(
+      _document: vscode.CustomDocument,
+      webviewPanel: vscode.WebviewPanel,
+      _token: vscode.CancellationToken,
+      clientId: string
+   ): void {
+      const webview = webviewPanel.webview;
+      webview.options = { enableScripts: true, localResourceRoots: this.localResourceRoots() };
+      webview.html = this.render(webview, clientId);
+   }
+
+   /**
+    * Where the webview may load from: the script's directory and the
+    * stylesheet's. VS Code blocks anything outside them without an error, so a
+    * stylesheet elsewhere would leave the diagram unstyled.
+    */
+   protected localResourceRoots(): vscode.Uri[] {
+      const roots = [vscode.Uri.joinPath(this.extensionUri, this.scriptPath, '..')];
+      if (this.stylePath) {
+         const styleRoot = vscode.Uri.joinPath(this.extensionUri, this.stylePath, '..');
+         if (styleRoot.path !== roots[0].path) {
+            roots.push(styleRoot);
+         }
+      }
+      return roots;
+   }
+
+   /**
+    * The webview document.
+    *
+    * The CSP relaxations are sprotty's: `style-src 'unsafe-inline'` because it
+    * writes inline `style` attributes on the SVG, without which every element is
+    * laid out at the origin, and `font-src data:` for the codicon font a bundler
+    * inlines. `'unsafe-eval'` is not granted; nothing in a GLSP bundle needs it.
+    */
+   protected render(webview: vscode.Webview, clientId: string): string {
+      const script = webview.asWebviewUri(vscode.Uri.joinPath(this.extensionUri, this.scriptPath));
+      const style = this.stylePath ? webview.asWebviewUri(vscode.Uri.joinPath(this.extensionUri, this.stylePath)) : undefined;
+      const nonce = randomBytes(16).toString('base64');
+      return `<!DOCTYPE html>
+<html lang="en">
+   <head>
+      <meta charset="UTF-8" />
+      <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+      <meta
+         http-equiv="Content-Security-Policy"
+         content="default-src 'none'; style-src ${webview.cspSource} 'unsafe-inline'; font-src ${webview.cspSource} data:; img-src ${webview.cspSource} data:; script-src 'nonce-${nonce}';"
+      />
+      <title>${escapeHtml(this.title)}</title>${style ? `\n      <link rel="stylesheet" href="${style}" />` : ''}
+   </head>
+   <body>
+      <div id="${clientId}_container" class="${DIAGRAM_CONTAINER_CLASS}"></div>
+      <script nonce="${nonce}" src="${script}"></script>
+   </body>
+</html>`;
+   }
+}
+
+function escapeHtml(text: string): string {
+   return text.replace(/[&<>"']/g, character => `&#${character.charCodeAt(0)};`);
+}

package/src/node/glsp-vscode-server.ts

@@ -0,0 +1,73 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 { SocketGlspVscodeServer } from '@eclipse-glsp/vscode-integration';
+import { sendByMethodName, type Logger } from '@hydranium/protocol';
+import * as net from 'node:net';
+import { createMessageConnection, SocketMessageReader, SocketMessageWriter } from 'vscode-jsonrpc/node';
+
+/** What {@link HydraniumGlspVscodeServer} needs beyond the GLSP client identity. */
+export interface HydraniumGlspVscodeServerOptions {
+   readonly clientId: string;
+   readonly clientName: string;
+   /**
+    * Resolve the GLSP head's listening port, typically `findPort` from
+    * `@hydranium/client-vscode/node`. Called when the connection is opened, so
+    * the poll runs at `start()` rather than during activation.
+    */
+   readonly findPort: () => Promise<number>;
+   /** Where the connection to the head logs its protocol faults. */
+   readonly logger: Logger;
+}
+
+/**
+ * The GLSP head reached over its ephemeral socket, with the port discovered
+ * rather than configured.
+ *
+ * `SocketGlspVscodeServer` takes a fixed `connectionOptions` at construction,
+ * but the head's port is assigned when it binds and published as an LSP
+ * request. Awaiting it in `activate` would block activation behind a poll that
+ * can take seconds, even for a user who never opens a diagram, so the lookup
+ * moves to `createConnection`, which the base class calls from `start()`.
+ * The `connectionOptions` handed to `super` is never read, and is an unusable
+ * port so that a refactor reintroducing the base implementation fails loudly
+ * instead of dialling something.
+ *
+ * Report a failure off `onReady`, not off `start()`: `start()` routes its own
+ * error into the readiness promise and resolves anyway.
+ */
+export class HydraniumGlspVscodeServer extends SocketGlspVscodeServer {
+   protected readonly findPort: () => Promise<number>;
+   protected readonly logger: Logger;
+
+   constructor(options: HydraniumGlspVscodeServerOptions) {
+      super({
+         clientId: options.clientId,
+         clientName: options.clientName,
+         connectionOptions: { port: 0 }
+      });
+      this.findPort = options.findPort;
+      this.logger = options.logger;
+   }
+
+   protected override async createConnection(): ReturnType<SocketGlspVscodeServer['createConnection']> {
+      const port = await this.findPort();
+      // `127.0.0.1`, not `localhost`, and it has to match the head: `startGlspServer`
+      // binds `127.0.0.1` by default, so on a dual-stack machine where `localhost`
+      // resolves to `::1` first the dial fails as ECONNREFUSED with nothing in the
+      // message naming the address family as the cause.
+      // Built here rather than by the base's `createSocketConnection`, which
+      // passes no logger. GLSP's client sends typed messages built by
+      // `@eclipse-glsp/protocol`'s copy of `vscode-jsonrpc`, so they go by name.
+      const socket = new net.Socket();
+      const connection = createMessageConnection(new SocketMessageReader(socket), new SocketMessageWriter(socket), this.logger);
+      socket.connect({ port, host: '127.0.0.1' });
+      return sendByMethodName(connection);
+   }
+}

package/src/node/index.ts

@@ -0,0 +1,11 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 './glsp-editor-provider';
+export * from './glsp-vscode-server';