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

package/lib/browser/diagram-widget.js

@@ -0,0 +1,172 @@
+"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.HydraniumGlspDiagramWidget = exports.DIAGRAM_LOADING_FAILED_CLASS = exports.DIAGRAM_LOADING_CLASS = void 0;
+const client_1 = require("@eclipse-glsp/client");
+const theia_integration_1 = require("@eclipse-glsp/theia-integration");
+const inversify_1 = require("@theia/core/shared/inversify");
+const diagram_loader_1 = require("./diagram-loader");
+// Shipped by this package rather than left to adopters: an overlay whose
+// stylesheet was forgotten is an unstyled div in normal flow, which is a silent
+// failure. Adopters override individual rules from their own stylesheet.
+require("../../style/diagram-loading.css");
+/** Class on the overlay root. Adopters style / override via this contract. */
+exports.DIAGRAM_LOADING_CLASS = 'hydranium-diagram-loading';
+/** Added to the overlay root when it switches from pending to reporting a
+ *  failure, so the spinner can be hidden and the text restyled from CSS alone. */
+exports.DIAGRAM_LOADING_FAILED_CLASS = `${exports.DIAGRAM_LOADING_CLASS}-failed`;
+/**
+ * `GLSPDiagramWidget` that covers the canvas with a spinner until the diagram
+ * load reaches a terminal state.
+ *
+ * **Why.** GLSP renders nothing until the first model arrives, so opening a
+ * diagram shows a blank tab for the whole round trip — long enough on a large
+ * model to read as a broken editor rather than a slow one.
+ *
+ * **How the pending state is sourced.** From {@link HydraniumDiagramLoader}, not
+ * from `actionDispatcher.onceModelInitialized()`. The loader settles on failure
+ * as well as on success, and it does so even when its own error-reporting
+ * dispatch throws; `onceModelInitialized()` simply never settles on a failed
+ * load. That distinction is not academic here: this overlay is opaque and covers
+ * the widget node, while GLSP's `StatusOverlay` — where the loader reports the
+ * failure — mounts *inside* the diagram's base div. Keyed on model
+ * initialization, a failed load would leave a spinner turning on top of the
+ * error message explaining it. Keyed on the loader, exactly one component decides
+ * whether the canvas is pending and the two mechanisms compose instead of
+ * competing.
+ *
+ * **The one case where this overlay reports the failure itself.** When
+ * `DiagramLoadFailure.surfaced` is `false` the loader could not dispatch its
+ * `StatusAction` — the action dispatcher was what failed — so the status overlay
+ * shows nothing. Uncovering the canvas would then leave a blank diagram whose only
+ * explanation is a line in the Output channel. In that case, and only that case,
+ * the overlay stays up and swaps the spinner for the error text.
+ *
+ * Bound unconditionally by `AbstractHydraniumGlspTheiaFrontendModule`. To opt out,
+ * override {@link showLoadingOverlay} to a no-op; to change what is rendered,
+ * override {@link createLoadingOverlay} or {@link loadingLabel}.
+ */
+let HydraniumGlspDiagramWidget = class HydraniumGlspDiagramWidget extends theia_integration_1.GLSPDiagramWidget {
+    loadingOverlay;
+    onAfterAttach(msg) {
+        // Before `super`, which is what starts the load on first attach — so the
+        // overlay is already up when the round trip begins.
+        this.showLoadingOverlay();
+        super.onAfterAttach(msg);
+    }
+    dispose() {
+        this.hideLoadingOverlay();
+        super.dispose();
+    }
+    /**
+     * Cover the canvas until the load settles.
+     *
+     * Nothing is created unless there is a signal to take it down again: no
+     * overlay without a framework loader, and none when the load has already
+     * settled — re-attaching a loaded diagram (a tab switch) skips it entirely
+     * rather than creating and immediately removing one, so there is no flash.
+     */
+    showLoadingOverlay() {
+        if (this.loadingOverlay) {
+            return;
+        }
+        const loader = this.hydraniumDiagramLoader;
+        if (!loader || loader.loadOutcome !== undefined) {
+            return;
+        }
+        this.loadingOverlay = this.createLoadingOverlay();
+        this.node.appendChild(this.loadingOverlay);
+        // Both arms: `onceLoadSettled` never rejects, but a widget must not be able
+        // to strand an overlay if that ever changes — a rejection is treated as an
+        // outcome it cannot report, which is the safe reading.
+        loader.onceLoadSettled().then(outcome => this.onLoadSettled(outcome), () => this.hideLoadingOverlay());
+    }
+    /**
+     * Take the overlay down, or keep it as the failure's only reporter.
+     *
+     * The overlay is retained ONLY for a failure the loader could not surface;
+     * anything else uncovers the canvas, so a load that failed *and was reported*
+     * reveals GLSP's status overlay rather than double-reporting on top of it.
+     */
+    onLoadSettled(outcome) {
+        if (outcome.status === 'failed' && !outcome.surfaced) {
+            this.showLoadFailure(outcome.error);
+            return;
+        }
+        this.hideLoadingOverlay();
+    }
+    /**
+     * Repurpose the pending overlay in place as a failure report: same node, so
+     * there is no removal-then-insertion flicker, plus a marker class so the
+     * spinner can be hidden from CSS.
+     *
+     * The wording is {@link HydraniumDiagramLoader.loadFailureLabel}'s, so an
+     * adopter rewording a load failure reaches every surface that reports it.
+     * Without the framework loader there is no failure to render, so its absence
+     * is a no-op rather than a fallback wording.
+     */
+    showLoadFailure(error) {
+        const overlay = this.loadingOverlay;
+        const loader = this.hydraniumDiagramLoader;
+        if (!overlay || !loader) {
+            return;
+        }
+        overlay.classList.add(exports.DIAGRAM_LOADING_FAILED_CLASS);
+        const label = overlay.querySelector(`.${exports.DIAGRAM_LOADING_CLASS}-label`);
+        if (label) {
+            label.textContent = loader.loadFailureLabel(error);
+        }
+    }
+    hideLoadingOverlay() {
+        this.loadingOverlay?.remove();
+        this.loadingOverlay = undefined;
+    }
+    /** Build the overlay DOM. Override to change the wording or add content; the
+     *  root must carry {@link DIAGRAM_LOADING_CLASS} for the shipped styling, and
+     *  the label element its `-label` class so {@link showLoadFailure} finds it. */
+    createLoadingOverlay() {
+        const overlay = document.createElement('div');
+        overlay.className = exports.DIAGRAM_LOADING_CLASS;
+        const spinner = document.createElement('div');
+        spinner.className = `${exports.DIAGRAM_LOADING_CLASS}-spinner`;
+        const label = document.createElement('div');
+        label.className = `${exports.DIAGRAM_LOADING_CLASS}-label`;
+        label.textContent = this.loadingLabel;
+        overlay.appendChild(spinner);
+        overlay.appendChild(label);
+        return overlay;
+    }
+    /** Text shown under the spinner. Override for a domain-specific wording; the
+     *  failure text that replaces it is {@link showLoadFailure}'s. */
+    get loadingLabel() {
+        return 'Loading diagram...';
+    }
+    /**
+     * The framework loader for this diagram, or `undefined` when the container
+     * binds a plain `DiagramLoader`. Absence degrades to "no overlay" rather than
+     * an error: a head that opted out of the framework loader has no settle signal
+     * to key on, and an overlay that never comes down is worse than none.
+     */
+    get hydraniumDiagramLoader() {
+        const loader = this.diContainer.get(client_1.DiagramLoader);
+        return loader instanceof diagram_loader_1.HydraniumDiagramLoader ? loader : undefined;
+    }
+};
+exports.HydraniumGlspDiagramWidget = HydraniumGlspDiagramWidget;
+exports.HydraniumGlspDiagramWidget = HydraniumGlspDiagramWidget = __decorate([
+    (0, inversify_1.injectable)()
+], HydraniumGlspDiagramWidget);
+//# sourceMappingURL=diagram-widget.js.map

package/lib/browser/diagram-widget.js.map

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

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

@@ -0,0 +1,40 @@
+/********************************************************************************
+ * 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 ChannelLoggerOptions } from '@hydranium/client-theia/lib/browser';
+import { type BindingContext } from '@eclipse-glsp/client';
+/** Options for `createGlspClientTheiaModule`. The adopter supplies the channel
+ *  logger configuration ({@link ChannelLoggerOptions} — a `channelName`, and
+ *  optionally a `component` label); the framework owns the dispatcher type and
+ *  the `ChannelLogger` binding. The log threshold is not configured here — it
+ *  is process-global, driven by `bindLogLevelPreference` or by
+ *  `AbstractHydraniumGlspTheiaFrontendModule.logLevelPreference`. */
+export interface GlspClientTheiaModuleOptions {
+    readonly channelLogger: ChannelLoggerOptions;
+}
+/**
+ * Composes the standard framework client bindings: the cross-head Output-channel
+ * logger, the instrumented action dispatcher, the failure-reporting diagram
+ * loader, the instrumented hidden-bounds updater, and the message service that
+ * drops the duplicate model-loading notification.
+ *
+ * Takes the whole {@link BindingContext} rather than `(bind, rebind)`: the
+ * message-service rebind has to know whether GLSP's `theiaNotificationModule`
+ * already bound its token, and a container-module body has the full context to
+ * hand anyway.
+ *
+ * Every binding is unconditional, with no per-feature flags. Each replaces a
+ * GLSP default with a strict superset of its behaviour, so a head that wants
+ * the original rebinds that one token back — the same one-line move this
+ * function makes.
+ *
+ * Adopter composition roots call this first; adopter-specific bindings
+ * (diagram-module rebinds, custom tools, etc.) layer on top.
+ */
+export declare function createGlspClientTheiaModule(context: BindingContext, options: GlspClientTheiaModuleOptions): void;
+//# sourceMappingURL=glsp-client-theia-module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-client-theia-module.d.ts","sourceRoot":"","sources":["../../src/browser/glsp-client-theia-module.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAqB,KAAK,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AACnG,OAAO,EAAE,KAAK,cAAc,EAAgE,MAAM,sBAAsB,CAAC;AAMzH;;;;;qEAKqE;AACrE,MAAM,WAAW,4BAA4B;IAC1C,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,4BAA4B,GAAG,IAAI,CAQhH"}

package/lib/browser/glsp-client-theia-module.js

@@ -0,0 +1,46 @@
+"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.createGlspClientTheiaModule = createGlspClientTheiaModule;
+const browser_1 = require("@hydranium/client-theia/lib/browser");
+const client_1 = require("@eclipse-glsp/client");
+const action_dispatcher_1 = require("./action-dispatcher");
+const diagram_loader_1 = require("./diagram-loader");
+const glsp_message_service_1 = require("./glsp-message-service");
+const hidden_bounds_updater_1 = require("./hidden-bounds-updater");
+/**
+ * Composes the standard framework client bindings: the cross-head Output-channel
+ * logger, the instrumented action dispatcher, the failure-reporting diagram
+ * loader, the instrumented hidden-bounds updater, and the message service that
+ * drops the duplicate model-loading notification.
+ *
+ * Takes the whole {@link BindingContext} rather than `(bind, rebind)`: the
+ * message-service rebind has to know whether GLSP's `theiaNotificationModule`
+ * already bound its token, and a container-module body has the full context to
+ * hand anyway.
+ *
+ * Every binding is unconditional, with no per-feature flags. Each replaces a
+ * GLSP default with a strict superset of its behaviour, so a head that wants
+ * the original rebinds that one token back — the same one-line move this
+ * function makes.
+ *
+ * Adopter composition roots call this first; adopter-specific bindings
+ * (diagram-module rebinds, custom tools, etc.) layer on top.
+ */
+function createGlspClientTheiaModule(context, options) {
+    const { bind, isBound, rebind } = context;
+    (0, browser_1.bindChannelLogger)(bind, options.channelLogger);
+    bind(action_dispatcher_1.HydraniumGlspActionDispatcher).toSelf().inSingletonScope();
+    rebind(client_1.GLSPActionDispatcher).toService(action_dispatcher_1.HydraniumGlspActionDispatcher);
+    rebind(client_1.DiagramLoader).to(diagram_loader_1.HydraniumDiagramLoader).inSingletonScope();
+    rebind(client_1.GLSPHiddenBoundsUpdater).to(hidden_bounds_updater_1.HydraniumHiddenBoundsUpdater).inSingletonScope();
+    (0, glsp_message_service_1.bindHydraniumGlspMessageService)(bind, isBound, rebind);
+}
+//# sourceMappingURL=glsp-client-theia-module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-client-theia-module.js","sourceRoot":"","sources":["../../src/browser/glsp-client-theia-module.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;AAsClF,kEAQC;AA5CD,iEAAmG;AACnG,iDAAyH;AACzH,2DAAoE;AACpE,qDAA0D;AAC1D,iEAAyE;AACzE,mEAAuE;AAYvE;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,2BAA2B,CAAC,OAAuB,EAAE,OAAqC;IACvG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC1C,IAAA,2BAAiB,EAAC,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/C,IAAI,CAAC,iDAA6B,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IAChE,MAAM,CAAC,6BAAoB,CAAC,CAAC,SAAS,CAAC,iDAA6B,CAAC,CAAC;IACtE,MAAM,CAAC,sBAAa,CAAC,CAAC,EAAE,CAAC,uCAAsB,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACpE,MAAM,CAAC,gCAAuB,CAAC,CAAC,EAAE,CAAC,oDAA4B,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACpF,IAAA,sDAA+B,EAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC"}

package/lib/browser/glsp-diagram-manager.d.ts

@@ -0,0 +1,46 @@
+/********************************************************************************
+ * 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 { GLSPDiagramManager } from '@eclipse-glsp/theia-integration';
+import { type GLSPDiagramLanguage } from '@eclipse-glsp/theia-integration/lib/common';
+/**
+ * `GLSPDiagramManager` subclass that derives the language-correlated getters
+ * (`fileExtensions`, `diagramType`, `contributionId`, `iconClass`) from a
+ * {@link GLSPDiagramLanguage} descriptor and the human-readable `label` from a
+ * separate adopter field — so adopters override two abstract members per
+ * manager rather than a getter apiece.
+ *
+ * Adopters subclass and provide:
+ *  - {@link diagramLanguage} — wire-format identifiers + file routing
+ *  - {@link managerLabel} — human-readable label shown in the open-with menu
+ *
+ * Optional override:
+ *  - {@link customIconClass} — overrides the language's `iconClass`
+ *  - `get id()` — manager id; defaults to nothing because manager id is
+ *    typically `static readonly ID = '…'` referenced by external callers
+ *    (Theia `WidgetManager` lookups). Adopter subclasses set `static ID`
+ *    and override `get id()` to return it.
+ *
+ * Abstract base class with hook fields, adopter subclasses with concrete
+ * values, following the GLSP module convention. The container always
+ * constructs the adopter subclass, never the abstract base directly.
+ */
+export declare abstract class AbstractHydraniumGlspDiagramManager extends GLSPDiagramManager {
+    /** Wire-format identifiers + file routing for this manager's diagram type. */
+    protected abstract readonly diagramLanguage: GLSPDiagramLanguage;
+    /** Human-readable label shown in the open-with menu and editor tabs. */
+    protected abstract readonly managerLabel: string;
+    /** Optional icon-class override; takes precedence over the language's `iconClass`. */
+    protected readonly customIconClass?: string;
+    get fileExtensions(): string[];
+    get diagramType(): string;
+    get contributionId(): string;
+    get iconClass(): string;
+    get label(): string;
+}
+//# sourceMappingURL=glsp-diagram-manager.d.ts.map

package/lib/browser/glsp-diagram-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-diagram-manager.d.ts","sourceRoot":"","sources":["../../src/browser/glsp-diagram-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAGtF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,8BACsB,mCAAoC,SAAQ,kBAAkB;IACjF,8EAA8E;IAC9E,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC;IAEjE,wEAAwE;IACxE,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAEjD,sFAAsF;IACtF,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAE5C,IAAa,cAAc,IAAI,MAAM,EAAE,CAEtC;IAED,IAAa,WAAW,IAAI,MAAM,CAEjC;IAED,IAAa,cAAc,IAAI,MAAM,CAEpC;IAED,IAAa,SAAS,IAAI,MAAM,CAE/B;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;CACH"}

package/lib/browser/glsp-diagram-manager.js

@@ -0,0 +1,66 @@
+"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.AbstractHydraniumGlspDiagramManager = void 0;
+const client_1 = require("@eclipse-glsp/client");
+const theia_integration_1 = require("@eclipse-glsp/theia-integration");
+const inversify_1 = require("@theia/core/shared/inversify");
+/**
+ * `GLSPDiagramManager` subclass that derives the language-correlated getters
+ * (`fileExtensions`, `diagramType`, `contributionId`, `iconClass`) from a
+ * {@link GLSPDiagramLanguage} descriptor and the human-readable `label` from a
+ * separate adopter field — so adopters override two abstract members per
+ * manager rather than a getter apiece.
+ *
+ * Adopters subclass and provide:
+ *  - {@link diagramLanguage} — wire-format identifiers + file routing
+ *  - {@link managerLabel} — human-readable label shown in the open-with menu
+ *
+ * Optional override:
+ *  - {@link customIconClass} — overrides the language's `iconClass`
+ *  - `get id()` — manager id; defaults to nothing because manager id is
+ *    typically `static readonly ID = '…'` referenced by external callers
+ *    (Theia `WidgetManager` lookups). Adopter subclasses set `static ID`
+ *    and override `get id()` to return it.
+ *
+ * Abstract base class with hook fields, adopter subclasses with concrete
+ * values, following the GLSP module convention. The container always
+ * constructs the adopter subclass, never the abstract base directly.
+ */
+let AbstractHydraniumGlspDiagramManager = class AbstractHydraniumGlspDiagramManager extends theia_integration_1.GLSPDiagramManager {
+    /** Optional icon-class override; takes precedence over the language's `iconClass`. */
+    customIconClass;
+    get fileExtensions() {
+        return [...this.diagramLanguage.fileExtensions];
+    }
+    get diagramType() {
+        return this.diagramLanguage.diagramType;
+    }
+    get contributionId() {
+        return this.diagramLanguage.contributionId;
+    }
+    get iconClass() {
+        return this.customIconClass ?? this.diagramLanguage.iconClass ?? (0, client_1.codiconCSSString)('type-hierarchy-sub');
+    }
+    get label() {
+        return this.managerLabel;
+    }
+};
+exports.AbstractHydraniumGlspDiagramManager = AbstractHydraniumGlspDiagramManager;
+exports.AbstractHydraniumGlspDiagramManager = AbstractHydraniumGlspDiagramManager = __decorate([
+    (0, inversify_1.injectable)()
+], AbstractHydraniumGlspDiagramManager);
+//# sourceMappingURL=glsp-diagram-manager.js.map

package/lib/browser/glsp-diagram-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-diagram-manager.js","sourceRoot":"","sources":["../../src/browser/glsp-diagram-manager.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;AAElF,iDAAwD;AACxD,uEAAqE;AAErE,4DAA0D;AAE1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEI,IAAe,mCAAmC,GAAlD,MAAe,mCAAoC,SAAQ,sCAAkB;IAOjF,sFAAsF;IACnE,eAAe,CAAU;IAE5C,IAAa,cAAc;QACxB,OAAO,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;IACnD,CAAC;IAED,IAAa,WAAW;QACrB,OAAO,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC;IAC3C,CAAC;IAED,IAAa,cAAc;QACxB,OAAO,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC;IAC9C,CAAC;IAED,IAAa,SAAS;QACnB,OAAO,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,eAAe,CAAC,SAAS,IAAI,IAAA,yBAAgB,EAAC,oBAAoB,CAAC,CAAC;IAC3G,CAAC;IAED,IAAI,KAAK;QACN,OAAO,IAAI,CAAC,YAAY,CAAC;IAC5B,CAAC;CACH,CAAA;AA7BqB,kFAAmC;8CAAnC,mCAAmC;IADxD,IAAA,sBAAU,GAAE;GACS,mCAAmC,CA6BxD"}

package/lib/browser/glsp-message-service.d.ts

@@ -0,0 +1,59 @@
+/********************************************************************************
+ * 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 EndProgressAction, type StartProgressAction, type UpdateProgressAction } from '@eclipse-glsp/client';
+import { TheiaGLSPMessageService } from '@eclipse-glsp/theia-integration';
+import { type interfaces } from '@theia/core/shared/inversify';
+/**
+ * Title of the model-loading progress report. Emitted by
+ * `@eclipse-glsp/server`'s `RequestModelActionHandler`, so it is a GLSP-protocol
+ * constant every server shares, not an adopter string — which is what makes
+ * matching on it a framework-level concern.
+ *
+ * Matched by title because `StartProgressAction` carries no kind or category to
+ * key on; the `progressId` is generated per report, so it can only be correlated
+ * after the fact (see {@link HydraniumGlspMessageService.suppressedProgressIds}).
+ *
+ * Matching an English literal fails silently — no error, no log line, just the
+ * duplicate progress popup back — so this needs keeping in step with
+ * `RequestModelActionHandler` on every GLSP bump.
+ */
+export declare const MODEL_LOADING_PROGRESS_TITLE = "Model loading in progress";
+/**
+ * Drops the Theia progress notification for diagram model loading, and only that
+ * one.
+ *
+ * `HydraniumGlspDiagramWidget`'s loading overlay already reports model loading,
+ * on the canvas the user is looking at; the notification says the same thing in a
+ * corner popup. Every other progress report is forwarded untouched, so a
+ * long-running server operation still surfaces normally.
+ *
+ * Bound unconditionally by `createGlspClientTheiaModule`, because the overlay it
+ * defers to is likewise unconditional. A head that no-ops the overlay and wants
+ * the notification back rebinds `TheiaGLSPMessageService` to GLSP's own.
+ */
+export declare class HydraniumGlspMessageService extends TheiaGLSPMessageService {
+    /** Ids of reports that were swallowed, so their updates and completion are
+     *  dropped as well — otherwise Theia sees an update for a progress it never
+     *  started. */
+    protected suppressedProgressIds: Set<string>;
+    protected startProgress(action: StartProgressAction): void;
+    protected updateProgress(action: UpdateProgressAction): void;
+    protected endProgress(action: EndProgressAction): void;
+}
+/**
+ * Replace the message service bound by GLSP's `theiaNotificationModule`.
+ *
+ * Called by `createGlspClientTheiaModule`, whose module the adopter registers
+ * after the Theia default modules — so the token is normally already bound and
+ * this rebinds. The `isBound` branch keeps it correct regardless of module order
+ * and if GLSP's default composition changes: it degrades to "we bind it
+ * ourselves" instead of an inversify error at diagram-open time.
+ */
+export declare function bindHydraniumGlspMessageService(bind: interfaces.Bind, isBound: interfaces.IsBound, rebind: interfaces.Rebind): void;
+//# sourceMappingURL=glsp-message-service.d.ts.map

package/lib/browser/glsp-message-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-message-service.d.ts","sourceRoot":"","sources":["../../src/browser/glsp-message-service.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACnH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,KAAK,UAAU,EAAc,MAAM,8BAA8B,CAAC;AAE3E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,4BAA4B,8BAA8B,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,qBACa,2BAA4B,SAAQ,uBAAuB;IACrE;;mBAEe;IACf,SAAS,CAAC,qBAAqB,cAAqB;cAEjC,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;cAQhD,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;cAOlD,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;CAQjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,IAAI,CAMnI"}

package/lib/browser/glsp-message-service.js

@@ -0,0 +1,97 @@
+"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.HydraniumGlspMessageService = exports.MODEL_LOADING_PROGRESS_TITLE = void 0;
+exports.bindHydraniumGlspMessageService = bindHydraniumGlspMessageService;
+const theia_integration_1 = require("@eclipse-glsp/theia-integration");
+const inversify_1 = require("@theia/core/shared/inversify");
+/**
+ * Title of the model-loading progress report. Emitted by
+ * `@eclipse-glsp/server`'s `RequestModelActionHandler`, so it is a GLSP-protocol
+ * constant every server shares, not an adopter string — which is what makes
+ * matching on it a framework-level concern.
+ *
+ * Matched by title because `StartProgressAction` carries no kind or category to
+ * key on; the `progressId` is generated per report, so it can only be correlated
+ * after the fact (see {@link HydraniumGlspMessageService.suppressedProgressIds}).
+ *
+ * Matching an English literal fails silently — no error, no log line, just the
+ * duplicate progress popup back — so this needs keeping in step with
+ * `RequestModelActionHandler` on every GLSP bump.
+ */
+exports.MODEL_LOADING_PROGRESS_TITLE = 'Model loading in progress';
+/**
+ * Drops the Theia progress notification for diagram model loading, and only that
+ * one.
+ *
+ * `HydraniumGlspDiagramWidget`'s loading overlay already reports model loading,
+ * on the canvas the user is looking at; the notification says the same thing in a
+ * corner popup. Every other progress report is forwarded untouched, so a
+ * long-running server operation still surfaces normally.
+ *
+ * Bound unconditionally by `createGlspClientTheiaModule`, because the overlay it
+ * defers to is likewise unconditional. A head that no-ops the overlay and wants
+ * the notification back rebinds `TheiaGLSPMessageService` to GLSP's own.
+ */
+let HydraniumGlspMessageService = class HydraniumGlspMessageService extends theia_integration_1.TheiaGLSPMessageService {
+    /** Ids of reports that were swallowed, so their updates and completion are
+     *  dropped as well — otherwise Theia sees an update for a progress it never
+     *  started. */
+    suppressedProgressIds = new Set();
+    startProgress(action) {
+        if (action.title === exports.MODEL_LOADING_PROGRESS_TITLE) {
+            this.suppressedProgressIds.add(action.progressId);
+            return;
+        }
+        super.startProgress(action);
+    }
+    updateProgress(action) {
+        if (this.suppressedProgressIds.has(action.progressId)) {
+            return;
+        }
+        super.updateProgress(action);
+    }
+    endProgress(action) {
+        // `delete` reports whether the id was suppressed and cleans the entry up in
+        // one step, so the set cannot grow across reloads.
+        if (this.suppressedProgressIds.delete(action.progressId)) {
+            return;
+        }
+        super.endProgress(action);
+    }
+};
+exports.HydraniumGlspMessageService = HydraniumGlspMessageService;
+exports.HydraniumGlspMessageService = HydraniumGlspMessageService = __decorate([
+    (0, inversify_1.injectable)()
+], HydraniumGlspMessageService);
+/**
+ * Replace the message service bound by GLSP's `theiaNotificationModule`.
+ *
+ * Called by `createGlspClientTheiaModule`, whose module the adopter registers
+ * after the Theia default modules — so the token is normally already bound and
+ * this rebinds. The `isBound` branch keeps it correct regardless of module order
+ * and if GLSP's default composition changes: it degrades to "we bind it
+ * ourselves" instead of an inversify error at diagram-open time.
+ */
+function bindHydraniumGlspMessageService(bind, isBound, rebind) {
+    if (isBound(theia_integration_1.TheiaGLSPMessageService)) {
+        rebind(theia_integration_1.TheiaGLSPMessageService).to(HydraniumGlspMessageService).inSingletonScope();
+    }
+    else {
+        bind(theia_integration_1.TheiaGLSPMessageService).to(HydraniumGlspMessageService).inSingletonScope();
+    }
+}
+//# sourceMappingURL=glsp-message-service.js.map

package/lib/browser/glsp-message-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-message-service.js","sourceRoot":"","sources":["../../src/browser/glsp-message-service.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;AA4ElF,0EAMC;AA/ED,uEAA0E;AAC1E,4DAA2E;AAE3E;;;;;;;;;;;;;GAaG;AACU,QAAA,4BAA4B,GAAG,2BAA2B,CAAC;AAExE;;;;;;;;;;;;GAYG;AAEI,IAAM,2BAA2B,GAAjC,MAAM,2BAA4B,SAAQ,2CAAuB;IACrE;;mBAEe;IACL,qBAAqB,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,aAAa,CAAC,MAA2B;QACzD,IAAI,MAAM,CAAC,KAAK,KAAK,oCAA4B,EAAE,CAAC;YACjD,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAClD,OAAO;QACV,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAEkB,cAAc,CAAC,MAA4B;QAC3D,IAAI,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YACrD,OAAO;QACV,CAAC;QACD,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAEkB,WAAW,CAAC,MAAyB;QACrD,4EAA4E;QAC5E,mDAAmD;QACnD,IAAI,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YACxD,OAAO;QACV,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;CACH,CAAA;AA7BY,kEAA2B;sCAA3B,2BAA2B;IADvC,IAAA,sBAAU,GAAE;GACA,2BAA2B,CA6BvC;AAED;;;;;;;;GAQG;AACH,SAAgB,+BAA+B,CAAC,IAAqB,EAAE,OAA2B,EAAE,MAAyB;IAC1H,IAAI,OAAO,CAAC,2CAAuB,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,2CAAuB,CAAC,CAAC,EAAE,CAAC,2BAA2B,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACtF,CAAC;SAAM,CAAC;QACL,IAAI,CAAC,2CAAuB,CAAC,CAAC,EAAE,CAAC,2BAA2B,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACpF,CAAC;AACJ,CAAC"}