@hydranium/glsp-client 0.0.0-stage → 1.0.0-next.298

package/lib/sprotty-logger-adapter.js

@@ -0,0 +1,130 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SprottyLoggerAdapter = void 0;
+const client_1 = require("@eclipse-glsp/client");
+const protocol_1 = require("@hydranium/protocol");
+const inversify_1 = require("inversify");
+const types_1 = require("./types");
+/** GLSP's wording for a request it resolved silently after its timeout. If
+ *  upstream rewords it, the notice degrades to `debug` with the rest of `info`. */
+const REQUEST_TIMED_OUT = /\btime out after \d+ms\b/;
+/**
+ * sprotty's `ILogger` over the host's {@link Logger}, so sprotty's own lines
+ * reach the same sink as the framework's: a view-registration failure lands in
+ * the Theia Output channel beside the action traffic, or on a page's console.
+ * sprotty binds a `NullLogger` by default, which drops those failures.
+ *
+ * sprotty's `error` and `warn` keep their levels and their parameters, where
+ * the parameter is the useful part, such as the element type that has no view.
+ *
+ * Its `info` is diagnosis, chatty on every hover's feedback, so it goes to
+ * `debug`; the one anomaly reported there, a request GLSP resolved silently
+ * after its timeout, goes to `warn`, where a default threshold shows it.
+ *
+ * Its `log` fires per action, per command and per render with the whole action
+ * or model as a parameter, so it goes to `trace`, where the framework
+ * dispatcher logs that traffic. **At `info` and `log` a parameter is reduced to
+ * its name**, an action's `kind` or an object's class, never forwarded whole:
+ * the Theia channel logger stringifies every parameter as JSON, so forwarding
+ * them would write the model into the Output channel on every action.
+ *
+ * Each line goes through a logger nested under the host's for the calling
+ * class, cached per class, so the origin is a tag the host renders inside its
+ * own, `[GLSP client :: Viewer]`, not a prefix inside the message. Where
+ * sprotty passes a sentence instead of the caller, as its layout registries
+ * do, the sentence prefixes the message. The adapter's own `logLevel` is
+ * sprotty's most verbose, so only the framework threshold filters; `info` and
+ * `log` check it first, since they run on every action and render and would
+ * otherwise format a line the threshold drops.
+ *
+ * Bound by `createGlspClientModule` via `rebind(TYPES.ILogger)`.
+ */
+let SprottyLoggerAdapter = class SprottyLoggerAdapter {
+    logger;
+    logLevel = client_1.LogLevel.log;
+    /** Loggers derived per calling class; sprotty logs from a few dozen classes. */
+    loggers = new Map();
+    error(thisArg, message, ...params) {
+        this.loggerFor(thisArg).error(this.formatMessage(thisArg, message), ...params);
+    }
+    warn(thisArg, message, ...params) {
+        this.loggerFor(thisArg).warn(this.formatMessage(thisArg, message), ...params);
+    }
+    info(thisArg, message, ...params) {
+        if (REQUEST_TIMED_OUT.test(message)) {
+            this.loggerFor(thisArg).warn(this.formatMessage(thisArg, message, params));
+        }
+        else if (protocol_1.Logger.isLevelEnabled('debug')) {
+            this.loggerFor(thisArg).debug(this.formatMessage(thisArg, message, params));
+        }
+    }
+    log(thisArg, message, ...params) {
+        if (protocol_1.Logger.isLevelEnabled('trace')) {
+            this.loggerFor(thisArg).trace(this.formatMessage(thisArg, message, params));
+        }
+    }
+    /** The host's logger with the calling class nested under its tag, or the
+     *  host's own when the caller is not an object. */
+    loggerFor(thisArg) {
+        const caller = typeof thisArg === 'object' && thisArg !== null ? this.nameOf(thisArg) : undefined;
+        if (caller === undefined) {
+            return this.logger;
+        }
+        let derived = this.loggers.get(caller);
+        if (derived === undefined) {
+            derived = this.logger.sub(caller);
+            this.loggers.set(caller, derived);
+        }
+        return derived;
+    }
+    /** The message, behind the sentence sprotty sometimes passes as the caller,
+     *  followed by the parameters' names. */
+    formatMessage(thisArg, message, params = []) {
+        const text = typeof thisArg === 'string' ? `${thisArg}${message}` : message;
+        return [text, ...params.map(param => this.nameOf(param)).filter(name => name !== undefined)].join(' ');
+    }
+    /** An action's `kind`, also inside the message GLSP sends an action in, a
+     *  string as it is, any other object's class, else nothing. */
+    nameOf(value) {
+        if (typeof value === 'string') {
+            return value;
+        }
+        if (typeof value !== 'object' || value === null) {
+            return undefined;
+        }
+        const { kind, action } = value;
+        if (typeof kind === 'string') {
+            return kind;
+        }
+        if (typeof action?.kind === 'string') {
+            return action.kind;
+        }
+        return value.constructor?.name;
+    }
+};
+exports.SprottyLoggerAdapter = SprottyLoggerAdapter;
+__decorate([
+    (0, inversify_1.inject)(types_1.HydraniumClientTypes.Logger),
+    __metadata("design:type", Object)
+], SprottyLoggerAdapter.prototype, "logger", void 0);
+exports.SprottyLoggerAdapter = SprottyLoggerAdapter = __decorate([
+    (0, inversify_1.injectable)()
+], SprottyLoggerAdapter);
+//# sourceMappingURL=sprotty-logger-adapter.js.map

package/lib/sprotty-logger-adapter.js.map

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

package/lib/status-overlay.d.ts

@@ -0,0 +1,23 @@
+/********************************************************************************
+ * 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 StatusAction, StatusOverlay } from '@eclipse-glsp/client';
+/**
+ * GLSP's status overlay, kept on the page.
+ *
+ * It inserts its element into the diagram's base div when the diagram starts,
+ * and sprotty's first render then replaces that div with its own, so the element
+ * is left detached and no status it shows is ever seen. This puts the element
+ * back into the current base div before it shows anything.
+ */
+export declare class HydraniumStatusOverlay extends StatusOverlay {
+    handle(action: StatusAction): void;
+    show(...args: Parameters<StatusOverlay['show']>): void;
+    protected reattach(): void;
+}
+//# sourceMappingURL=status-overlay.d.ts.map

package/lib/status-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-overlay.d.ts","sourceRoot":"","sources":["../src/status-overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGxE;;;;;;;GAOG;AACH,qBACa,sBAAuB,SAAQ,aAAa;IAC7C,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAG1C;IAEQ,IAAI,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAG9D;IAED,SAAS,CAAC,QAAQ,IAAI,IAAI,CASzB;CACH"}

package/lib/status-overlay.js

@@ -0,0 +1,52 @@
+"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.HydraniumStatusOverlay = void 0;
+const client_1 = require("@eclipse-glsp/client");
+const inversify_1 = require("inversify");
+/**
+ * GLSP's status overlay, kept on the page.
+ *
+ * It inserts its element into the diagram's base div when the diagram starts,
+ * and sprotty's first render then replaces that div with its own, so the element
+ * is left detached and no status it shows is ever seen. This puts the element
+ * back into the current base div before it shows anything.
+ */
+let HydraniumStatusOverlay = class HydraniumStatusOverlay extends client_1.StatusOverlay {
+    handle(action) {
+        this.reattach();
+        super.handle(action);
+    }
+    show(...args) {
+        super.show(...args);
+        this.reattach();
+    }
+    reattach() {
+        const container = this.containerElement;
+        if (!container || container.isConnected) {
+            return;
+        }
+        const parent = this.getParentContainer();
+        if (parent) {
+            this.insertContainerIntoParent(container, parent);
+        }
+    }
+};
+exports.HydraniumStatusOverlay = HydraniumStatusOverlay;
+exports.HydraniumStatusOverlay = HydraniumStatusOverlay = __decorate([
+    (0, inversify_1.injectable)()
+], HydraniumStatusOverlay);
+//# sourceMappingURL=status-overlay.js.map

package/lib/status-overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-overlay.js","sourceRoot":"","sources":["../src/status-overlay.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;AAElF,iDAAwE;AACxE,yCAAuC;AAEvC;;;;;;;GAOG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAuB,SAAQ,sBAAa;IAC7C,MAAM,CAAC,MAAoB;QACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAEQ,IAAI,CAAC,GAAG,IAAuC;QACrD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC,QAAQ,EAAE,CAAC;IACnB,CAAC;IAES,QAAQ;QACf,MAAM,SAAS,GAAG,IAAI,CAAC,gBAA2C,CAAC;QACnE,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;YACvC,OAAO;QACV,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACzC,IAAI,MAAM,EAAE,CAAC;YACV,IAAI,CAAC,yBAAyB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC;IACJ,CAAC;CACH,CAAA;;iCArBY,sBAAsB;IADlC,IAAA,sBAAU,GAAE;GACA,sBAAsB,CAqBlC"}

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;;;AAqDlF,+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,0BAAiC,OAAO,GAAwB,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;AAKlF,cAAc,iBAAiB,CAAC"}

package/lib/testing/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 });
+// Subpath barrel for `@hydranium/glsp-client/testing` — the Inversify binding
+// recorder for testing a module factory without a container.
+__exportStar(require("./bind-recorder"), exports);
+//# sourceMappingURL=index.js.map

package/lib/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,8EAA8E;AAC9E,6DAA6D;AAE7D,kDAAgC"}

package/lib/types.d.ts

@@ -0,0 +1,27 @@
+/********************************************************************************
+ * 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 { Clock, Logger, Tracer } from '@hydranium/protocol';
+import type { interfaces } from 'inversify';
+/**
+ * The DI tokens the framework's client classes inject, typed by the protocol
+ * interfaces so a host binds whatever implementation it has: a Theia frontend
+ * binds its Output-channel logger, a page or webview a console logger. Kept in
+ * a registry so a token's name cannot collide with the type it injects.
+ *
+ * `Logger` and `Tracer` are required, so a host that binds neither fails at
+ * resolution rather than running silent; `createGlspClientModule` binds
+ * defaults for a host that passes none. `Clock` is optional: the classes fall
+ * back to a `SystemClock`.
+ */
+export declare const HydraniumClientTypes: {
+    readonly Logger: interfaces.ServiceIdentifier<Logger>;
+    readonly Tracer: interfaces.ServiceIdentifier<Tracer>;
+    readonly Clock: interfaces.ServiceIdentifier<Clock>;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAQ5C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB;aAC9B,MAAM;aACN,MAAM;aACN,KAAK;CACE,CAAC"}

package/lib/types.js

@@ -0,0 +1,33 @@
+"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.HydraniumClientTypes = void 0;
+/** A fresh `Symbol` cast to inversify's typed identifier, so `bind` and
+ *  `@inject` sites type-check against `T` rather than `any`. */
+function serviceIdentifier(description) {
+    return Symbol(description);
+}
+/**
+ * The DI tokens the framework's client classes inject, typed by the protocol
+ * interfaces so a host binds whatever implementation it has: a Theia frontend
+ * binds its Output-channel logger, a page or webview a console logger. Kept in
+ * a registry so a token's name cannot collide with the type it injects.
+ *
+ * `Logger` and `Tracer` are required, so a host that binds neither fails at
+ * resolution rather than running silent; `createGlspClientModule` binds
+ * defaults for a host that passes none. `Clock` is optional: the classes fall
+ * back to a `SystemClock`.
+ */
+exports.HydraniumClientTypes = {
+    Logger: serviceIdentifier('HydraniumClientLogger'),
+    Tracer: serviceIdentifier('HydraniumClientTracer'),
+    Clock: serviceIdentifier('HydraniumClientClock')
+};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;AAKlF;gEACgE;AAChE,SAAS,iBAAiB,CAAI,WAAmB;IAC9C,OAAO,MAAM,CAAC,WAAW,CAAoC,CAAC;AACjE,CAAC;AAED;;;;;;;;;;GAUG;AACU,QAAA,oBAAoB,GAAG;IACjC,MAAM,EAAE,iBAAiB,CAAS,uBAAuB,CAAC;IAC1D,MAAM,EAAE,iBAAiB,CAAS,uBAAuB,CAAC;IAC1D,KAAK,EAAE,iBAAiB,CAAQ,sBAAsB,CAAC;CAChD,CAAC"}

package/package.json

@@ -1,6 +1,81 @@
 {
   "name": "@hydranium/glsp-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0-next.298",
+  "description": "Host-neutral client classes for GLSP heads built on @hydranium/glsp-server, the binder that mounts them in a Theia frontend, a VS Code webview or a plain browser page, and the edge whose labels keep finite bounds without bendpoints.",
+  "keywords": [
+    "diagram",
+    "glsp",
+    "hydranium",
+    "langium",
+    "language-server",
+    "lsp"
+  ],
+  "homepage": "https://github.com/eclipse-emfcloud/hydranium/tree/main/packages/glsp-client",
+  "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"
+  },
+  "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"
+    },
+    "./messages": {
+      "types": "./lib/messages/index.d.ts",
+      "default": "./lib/messages/index.js"
+    },
+    "./testing": {
+      "types": "./lib/testing/index.d.ts",
+      "default": "./lib/testing/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",
+    "@hydranium/protocol": "1.0.0-next.298",
+    "@types/node": "^22.0.0",
+    "inversify": "6.2.2",
+    "reflect-metadata": "0.2.2",
+    "rimraf": "^5.0.0",
+    "snabbdom": "3.5.1",
+    "typescript": "^7.0.2"
+  },
+  "peerDependencies": {
+    "@eclipse-glsp/client": "^2.6.0",
+    "@hydranium/protocol": "1.0.0-next.298",
+    "inversify": "^6.0.0",
+    "snabbdom": "^3.5.1"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "//peerDependencies": "`inversify` is imported plainly, as `@eclipse-glsp/client` imports it, and peered so the classes here decorate with the same copy the diagram container resolves; `@theia/core/shared/inversify` re-exports that copy, so a Theia frontend satisfies it without a second install. `snabbdom` is a peer for the `VNode` type the hidden-bounds updater reads, the same reason the Theia package peers it.",
+  "//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."
+}