@hydranium/glsp-client-theia 1.0.0-next.28 → 1.0.0-next.281

package/lib/browser/client-contribution.js

@@ -20,89 +20,269 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HydraniumGlspClientContribution = void 0;
+exports.HydraniumGlspClientContribution = exports.DEFAULT_GLSP_CLIENT_STARTUP_TIMEOUT_MS = void 0;
+const client_1 = require("@eclipse-glsp/client");
 const theia_integration_1 = require("@eclipse-glsp/theia-integration");
+const common_1 = require("@eclipse-glsp/theia-integration/lib/common");
+const browser_1 = require("@hydranium/client-theia/browser");
+const common_2 = require("@hydranium/client-theia/common");
+const protocol_1 = require("@hydranium/protocol");
+const core_1 = require("@theia/core");
 const promise_util_1 = require("@theia/core/lib/common/promise-util");
 const inversify_1 = require("@theia/core/shared/inversify");
-const output_channel_1 = require("@theia/output/lib/browser/output-channel");
-const browser_1 = require("@theia/workspace/lib/browser");
+const browser_2 = require("@theia/workspace/lib/browser");
+// GLSP's channel connection uses the top-level `vscode-jsonrpc`'s root entry, which
+// installs no runtime layer; without the browser entry, no message is received.
+require("vscode-jsonrpc/browser");
+const glsp_client_1 = require("./glsp-client");
+exports.DEFAULT_GLSP_CLIENT_STARTUP_TIMEOUT_MS = 30_000;
 /**
  * Theia GLSP client contribution for adopters whose GLSP server runs in a
  * sideloaded VS Code extension process (or any other deferred-start setup).
- * The behaviours adopters reliably need are lifted:
  *
- *   1. `waitForBackendConnected`: tail the OutputChannel for a server-printed
- *      ready marker. While a socket connection might open earlier, the GLSP
- *      server typically does internal initialisation before it can accept
- *      client connections — we wait for it to say so.
- *   2. `start`: defer until a workspace is opened. If Theia starts without a
- *      workspace, this prevents the frontend-backend connection (and its
- *      "connecting" progress spinner) from firing prematurely.
+ * The client starts once a workspace is open and sends its first request at
+ * once; the backend handler holds it until its socket to the server is up. A
+ * start that fails, and a connection lost after one succeeded, start a fresh
+ * client after a backoff, for as long as the contribution lives. Each start is
+ * reported through the {@link ConnectionReporter}, and announced through
+ * {@link onDidStartClient} and {@link onDidLoseClient}.
  *
  * A `GLSPClient` override filtering inbound messages by clientId is
  * deliberately NOT provided: upstream's `BaseJsonrpcGLSPClient.onActionMessage`
- * already filters by clientId, so the `TheiaJsonrpcGLSPClient` returned by
- * `BaseGLSPClientContribution.createGLSPClient` is correct as-is.
+ * already filters by clientId.
  */
 let HydraniumGlspClientContribution = class HydraniumGlspClientContribution extends theia_integration_1.BaseGLSPClientContribution {
-    outputChannelManager;
     workspaceService;
+    connectionReporter;
+    logger;
+    /** Times the restart escalation reset: the container's {@link Clock}, or a `SystemClock`. */
+    clock = new protocol_1.SystemClock();
     id;
-    channelName;
-    readyMarker;
+    /** Delay before the restart following each consecutive failed start or lost
+     *  client; the last repeats. */
+    restartDelaysMs = [1_000, 2_000, 4_000, 8_000];
+    /** How long a client must stay up before the restart delays start over, so
+     *  a server that fails right after starting is not restarted at once. */
+    restartEscalationResetMs = 30_000;
+    consecutiveFailures = 0;
+    restartTimer;
+    /** Running since the current client started; cleared once a restart has taken it into account. */
+    sinceStart;
+    /** Clients started so far, which numbers them in the log: they share {@link id}. */
+    startedClients = 0;
+    /** The attempt waiting for a channel, if any. */
+    channelRequest;
+    disposed = false;
+    clientStartedEmitter = new core_1.Emitter();
+    clientLostEmitter = new core_1.Emitter();
+    /** Fires with each client once it has started and its server has answered. */
+    onDidStartClient = this.clientStartedEmitter.event;
+    /** Fires when the started client stops; {@link glspClient} already waits
+     *  for its replacement then. */
+    onDidLoseClient = this.clientLostEmitter.event;
     constructor(options) {
         super();
         this.id = options.languageContributionId;
-        this.channelName = options.channelName;
-        this.readyMarker = options.readyMarker;
-    }
-    /** Wait for the server to print its ready marker into the OutputChannel.
-     *  Resolves immediately if the marker is already present (server started
-     *  before the client contribution mounted). */
-    async waitForBackendConnected() {
-        const channel = this.outputChannelManager.getChannel(this.channelName);
-        const channelText = channel.resource?.textModel?.getValue() ?? '';
-        if (channelText.includes(this.readyMarker)) {
+        this.glspClientStartupTimeout = options.startupTimeoutMs ?? exports.DEFAULT_GLSP_CLIENT_STARTUP_TIMEOUT_MS;
+    }
+    /** The client every diagram load awaits; after a failed start, a fresh one. */
+    get glspClient() {
+        return this.glspClientDeferred.state === 'rejected' ? this.restart() : this.glspClientDeferred.promise;
+    }
+    /** Start a fresh client over a fresh channel at once, if the last start failed. */
+    restart() {
+        if (!this.disposed && this.glspClientDeferred.state === 'rejected') {
+            this.replaceClient();
+            void this.activateClient();
+        }
+        return this.glspClientDeferred.promise;
+    }
+    /** Point {@link glspClient} at a fresh client still to start, and tear down
+     *  the old one's channel. */
+    replaceClient() {
+        clearTimeout(this.restartTimer);
+        // Replaced before the old channel goes, so the old client stopping is
+        // not taken for a loss of the new one.
+        this.glspClientDeferred = new promise_util_1.Deferred();
+        this.toDispose.dispose();
+        // Upstream refuses to open a channel while the collection is disposed.
+        this.toDispose.push(core_1.Disposable.NULL);
+    }
+    /** Settles the promise current when it began, so a start a restart overtook
+     *  cannot settle its successor. */
+    async activateClient() {
+        const pending = this.glspClientDeferred;
+        await this.workspaceOpened();
+        if (this.disposed) {
             return;
         }
-        const deferred = new promise_util_1.Deferred();
-        const channelListener = channel.onContentChange(() => {
-            const text = channel.resource?.textModel?.getValue() ?? '';
-            if (text.includes(this.readyMarker)) {
-                channelListener.dispose();
-                deferred.resolve();
+        const attempt = this.connectionReporter.connecting(this.connectionTarget);
+        const timeout = this.glspClientStartupTimeout > 0
+            ? setTimeout(() => pending.reject(new Error(this.startupTimeoutMessage())), this.glspClientStartupTimeout)
+            : undefined;
+        pending.promise.then(client => {
+            clearTimeout(timeout);
+            attempt.connected();
+            this.sinceStart = this.clock.stopwatch();
+            this.logger.info(`[${this.id}] Diagram client ${++this.startedClients} started.`);
+            this.clientStartedEmitter.fire(client);
+            this.restartOnLoss(client);
+        }, (error) => {
+            clearTimeout(timeout);
+            if (this.disposed) {
+                attempt.cancelled();
+                return;
+            }
+            attempt.failed((0, protocol_1.describeError)(error), () => void this.restart());
+            this.scheduleRestart(() => {
+                if (this.glspClientDeferred === pending) {
+                    void this.restart();
+                }
+            });
+        });
+        try {
+            const connection = await this.createConnection();
+            // Ahead of the client's own listener, whose teardown rejects with a
+            // transport message instead.
+            connection.onClose(() => pending.reject(new Error(this.unreachableMessage())));
+            // Upstream builds the connection from the `vscode-jsonrpc` hoisted
+            // beside it and the client's typed messages from its protocol's copy;
+            // a type sent over another copy's connection throws.
+            const client = await this.createGLSPClient((0, protocol_1.sendByMethodName)(connection));
+            connection.onDispose(() => client.stop());
+            await this.start(client);
+            pending.resolve(client);
+        }
+        catch (error) {
+            pending.reject(error);
+        }
+    }
+    /** Run `restart` after the delay for the failures so far, and return that delay. */
+    scheduleRestart(restart) {
+        if (this.sinceStart !== undefined && this.sinceStart.elapsedMs >= this.restartEscalationResetMs) {
+            this.consecutiveFailures = 0;
+        }
+        this.sinceStart = undefined;
+        const delay = this.restartDelaysMs[Math.min(this.consecutiveFailures, this.restartDelaysMs.length - 1)];
+        this.consecutiveFailures++;
+        clearTimeout(this.restartTimer);
+        this.restartTimer = setTimeout(restart, delay);
+        return delay;
+    }
+    /** Once `client` stops, replace it and start its replacement after the
+     *  restart delay, unless a dispose stopped it. */
+    restartOnLoss(client) {
+        const listener = client.onCurrentStateChanged(state => {
+            if (state !== client_1.ClientState.ServerError && state !== client_1.ClientState.Stopped) {
+                return;
+            }
+            listener.dispose();
+            if (!this.disposed) {
+                this.replaceClient();
+                this.clientLostEmitter.fire();
+                const delay = this.scheduleRestart(() => void this.activateClient());
+                // Upstream's client has just logged that it will not be restarted, which holds for it alone.
+                this.logger.info(`[${this.id}] Diagram client ${this.startedClients} lost; starting a fresh one in ${delay} ms.`);
             }
         });
-        return deferred.promise;
     }
+    /** Start the client and initialize its server, rejecting on failure; the
+     *  caller settles {@link glspClient}. */
     async start(glspClient) {
-        // Defer starting the GLSP client until a workspace is opened. If Theia
-        // starts without a workspace, this prevents creating the frontend-
-        // backend connection (and showing the "connecting" progress) prematurely.
+        await glspClient.start();
+        await this.initialize(glspClient);
+    }
+    /** Without upstream's own error notification, which would duplicate the reporter's. */
+    async initialize(glspClient) {
+        return glspClient.initializeServer(await this.createInitializeParameters());
+    }
+    /** Upstream's base client, without the notifications of its Theia subclass,
+     *  which would duplicate the reporter's. */
+    async createGLSPClient(connectionProvider) {
+        return new glsp_client_1.HydraniumGlspClient({ id: this.id, connectionProvider });
+    }
+    /**
+     * Whichever channel arrives goes to the attempt waiting now, and one that
+     * arrives with none waiting is closed. Theia holds each open until its
+     * websocket is back, and after an outage every held open past the first
+     * throws "already open" without reaching its handler, so the first to arrive
+     * has to serve the latest attempt. Without Theia's replay, which would be a
+     * second opener of the same path.
+     */
+    async createChannelConnection() {
+        this.channelRequest?.reject(new Error('A newer start took over the channel request.'));
+        const request = new promise_util_1.Deferred();
+        this.channelRequest = request;
+        this.connectionProvider.listen(common_1.GLSPContribution.getPath(this), (_path, channel) => {
+            const waiting = this.channelRequest;
+            this.channelRequest = undefined;
+            if (waiting && !this.disposed) {
+                waiting.resolve(channel);
+            }
+            else {
+                channel.close();
+            }
+        }, false);
+        const channel = await request.promise;
+        const connection = (0, common_1.createChannelConnection)(channel, this.logger);
+        this.toDispose.push(core_1.Disposable.create(() => this.disposeChannel(connection, channel)));
+        return connection;
+    }
+    /** Also closes the channel: upstream leaves a Theia channel open, and the
+     *  next one on the same path then cannot open. */
+    async disposeChannel(connection, channel) {
+        await super.disposeChannel(connection, channel);
+        channel.close();
+    }
+    /** Also fails a start in flight, so nothing reports it after this. */
+    dispose() {
+        this.disposed = true;
+        clearTimeout(this.restartTimer);
+        this.glspClientDeferred.promise.catch(() => undefined);
+        this.glspClientDeferred.reject(new Error('The diagram client was disposed.'));
+        this.clientStartedEmitter.dispose();
+        this.clientLostEmitter.dispose();
+        super.dispose();
+    }
+    async workspaceOpened() {
         const roots = this.workspaceService.tryGetRoots();
-        if (!roots || roots.length === 0) {
-            await new Promise(resolve => {
-                const disposable = this.workspaceService.onWorkspaceChanged(changedRoots => {
-                    if (changedRoots && changedRoots.length > 0) {
-                        disposable.dispose();
-                        resolve();
-                    }
-                });
-            });
+        if (roots.length === 0) {
+            await core_1.Event.toPromise(core_1.Event.filter(this.workspaceService.onWorkspaceChanged, changedRoots => changedRoots.length > 0));
         }
-        await this.waitForBackendConnected();
-        return super.start(glspClient);
+    }
+    get connectionTarget() {
+        return (this.cachedConnectionTarget ??= {
+            connectingMessage: core_1.nls.localize('hydranium/glsp-client-theia/diagram-server-connecting', 'Connecting to the diagram server…'),
+            connectedMessage: core_1.nls.localize('hydranium/glsp-client-theia/diagram-server-connected', 'Connected to the diagram server.')
+        });
+    }
+    /** One object per contribution: the reporter keys what it has shown on it. */
+    cachedConnectionTarget;
+    unreachableMessage() {
+        return core_1.nls.localize('hydranium/glsp-client-theia/diagram-server-unreachable', 'Could not connect to the diagram server.');
+    }
+    startupTimeoutMessage() {
+        return core_1.nls.localize('hydranium/glsp-client-theia/diagram-server-timeout', 'The diagram server did not answer within {0} seconds.', String(Math.round(this.glspClientStartupTimeout / 1000)));
     }
 };
 exports.HydraniumGlspClientContribution = HydraniumGlspClientContribution;
 __decorate([
-    (0, inversify_1.inject)(output_channel_1.OutputChannelManager),
-    __metadata("design:type", output_channel_1.OutputChannelManager)
-], HydraniumGlspClientContribution.prototype, "outputChannelManager", void 0);
-__decorate([
-    (0, inversify_1.inject)(browser_1.WorkspaceService),
-    __metadata("design:type", browser_1.WorkspaceService)
+    (0, inversify_1.inject)(browser_2.WorkspaceService),
+    __metadata("design:type", browser_2.WorkspaceService)
 ], HydraniumGlspClientContribution.prototype, "workspaceService", void 0);
+__decorate([
+    (0, inversify_1.inject)(browser_1.ConnectionReporter),
+    __metadata("design:type", Object)
+], HydraniumGlspClientContribution.prototype, "connectionReporter", void 0);
+__decorate([
+    (0, inversify_1.inject)(browser_1.ChannelLogger),
+    __metadata("design:type", browser_1.ChannelLogger)
+], HydraniumGlspClientContribution.prototype, "logger", void 0);
+__decorate([
+    (0, inversify_1.inject)(common_2.Clock),
+    (0, inversify_1.optional)(),
+    __metadata("design:type", Object)
+], HydraniumGlspClientContribution.prototype, "clock", void 0);
 exports.HydraniumGlspClientContribution = HydraniumGlspClientContribution = __decorate([
     (0, inversify_1.injectable)(),
     __param(0, (0, inversify_1.unmanaged)()),

package/lib/browser/client-contribution.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-contribution.js","sourceRoot":"","sources":["../../src/browser/client-contribution.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;AAGlF,uEAA6E;AAC7E,sEAA+D;AAC/D,4DAA6E;AAC7E,6EAAgF;AAChF,0DAAgE;AAYhE;;;;;;;;;;;;;;;;;GAiBG;AAEI,IAAM,+BAA+B,GAArC,MAAM,+BAAgC,SAAQ,8CAA0B;IACpC,oBAAoB,CAAwB;IACvC,gBAAgB,CAAoB;IAExE,EAAE,CAAS;IACD,WAAW,CAAS;IACpB,WAAW,CAAS;IAEvC,YAAyB,OAAkC;QACxD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC;QACzC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAC1C,CAAC;IAED;;mDAE+C;IACrC,KAAK,CAAC,uBAAuB;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvE,MAAM,WAAW,GACb,OAA4E,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACvH,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1C,OAAO;QACV,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,uBAAQ,EAAQ,CAAC;QACtC,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,EAAE;YAClD,MAAM,IAAI,GAAI,OAA4E,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACjI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBACnC,eAAe,CAAC,OAAO,EAAE,CAAC;gBAC1B,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC3B,CAAC;IAEkB,KAAK,CAAC,KAAK,CAAC,UAAsB;QAClD,uEAAuE;QACvE,mEAAmE;QACnE,0EAA0E;QAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC;QAClD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;gBAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,YAAY,CAAC,EAAE;oBACxE,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC3C,UAAU,CAAC,OAAO,EAAE,CAAC;wBACrB,OAAO,EAAE,CAAC;oBACb,CAAC;gBACJ,CAAC,CAAC,CAAC;YACN,CAAC,CAAC,CAAC;QACN,CAAC;QACD,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;CACH,CAAA;AAtDY,0EAA+B;AACD;IAAvC,IAAA,kBAAM,EAAC,qCAAoB,CAAC;8BAAkC,qCAAoB;6EAAC;AACvC;IAA5C,IAAA,kBAAM,EAAC,0BAAgB,CAAC;8BAAuC,0BAAgB;yEAAC;0CAFvE,+BAA+B;IAD3C,IAAA,sBAAU,GAAE;IASG,WAAA,IAAA,qBAAS,GAAE,CAAA;;GARd,+BAA+B,CAsD3C"}
+{"version":3,"file":"client-contribution.js","sourceRoot":"","sources":["../../src/browser/client-contribution.ts"],"names":[],"mappings":"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"}

package/lib/browser/diagram-loader.d.ts

@@ -7,7 +7,7 @@
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
 import { DiagramLoader, type DiagramLoadingOptions } from '@eclipse-glsp/client';
-import { ChannelLogger } from '@hydranium/client-theia/lib/browser';
+import { ChannelLogger } from '@hydranium/client-theia/browser';
 import { Deferred } from '@hydranium/protocol';
 /**
  * How a diagram load ended. A discriminated union rather than a boolean or a
@@ -26,8 +26,7 @@ export interface DiagramLoadFailure {
     readonly error: unknown;
     /**
      * Whether the `severity: 'ERROR'` {@link StatusAction} reached the action
-     * dispatcher — i.e. whether GLSP's `StatusOverlay` is now displaying this
-     * failure.
+     * dispatcher. It says nothing about whether a status overlay shows it.
      *
      * `false` means the report itself failed, which happens when the action
      * dispatcher is the thing that could not initialize. A consumer that covers
@@ -110,10 +109,20 @@ export declare class HydraniumDiagramLoader extends DiagramLoader {
     protected reportLoadFailure(err: unknown): Promise<boolean>;
     /**
      * The sentence a failed load is reported with, on every surface that reports
-     * it, and the only seam an adopter rewords or localizes it at. Public
-     * because the canvas overlay is one of those surfaces and lives in another
-     * class: it renders this failure exactly when the `StatusAction` did not
-     * land, so a second copy of the sentence there could only ever drift unseen.
+     * it. Public because the canvas overlay is one of those surfaces and lives in
+     * another class, where a second copy of the sentence would drift.
+     *
+     * **The seam and the catalogue key answer different questions, so it carries
+     * both.** Overriding this method changes the WORDING for every user of one
+     * adopter's product; the key is what gives a reader the sentence in their own
+     * language, and no override can supply that without an adopter writing a
+     * subclass per locale — which is the thing a catalogue exists to avoid. Two
+     * of the three surfaces this reaches are user-visible, so the audience
+     * triage answers it: a host-bound string a user sees takes an inline key.
+     *
+     * The Output-channel line is therefore localized too, which is deliberate
+     * rather than overlooked — the alternative is a second English copy of one
+     * sentence, and the reason for a single source here has not changed.
      */
     loadFailureLabel(err: unknown): string;
     /** Render a thrown value as a message. Shared so the channel line, the status

package/lib/browser/diagram-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagram-loader.d.ts","sourceRoot":"","sources":["../../src/browser/diagram-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,aAAa,EAAE,KAAK,qBAAqB,EAAgB,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/C;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IAChC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IAChC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBACa,sBAAuB,SAAQ,aAAa;IAC/B,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAG,aAAa,CAAC;IAElE,SAAS,CAAC,QAAQ,CAAC,OAAO,+BAAsC;IAChE,SAAS,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAEvC;;;+DAG2D;IAC3D,IAAI,WAAW,IAAI,kBAAkB,GAAG,SAAS,CAEhD;IAED;uEACmE;IACnE,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAI/B,IAAI,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAcnE;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAQnD;;;;;;;;;;;OAWG;cACa,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAYjE;;;;;;OAMG;IACH,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAItC;qFACiF;IACjF,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;CAG7C"}
+{"version":3,"file":"diagram-loader.d.ts","sourceRoot":"","sources":["../../src/browser/diagram-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,aAAa,EAAE,KAAK,qBAAqB,EAAgB,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAiB,MAAM,qBAAqB,CAAC;AAI9D;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IAChC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IAChC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBACa,sBAAuB,SAAQ,aAAa;IAC/B,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAG,aAAa,CAAC;IAElE,SAAS,CAAC,QAAQ,CAAC,OAAO,+BAAsC;IAChE,SAAS,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAEvC;;;+DAG2D;IAC3D,IAAI,WAAW,IAAI,kBAAkB,GAAG,SAAS,CAEhD;IAED;uEACmE;IACnE,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAE7C;IAEc,IAAI,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CASlE;IAED;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAMlD;IAED;;;;;;;;;;;OAWG;IACH,UAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAUhE;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAErC;IAED;qFACiF;IACjF,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAE1C;CACH"}

package/lib/browser/diagram-loader.js

@@ -19,8 +19,9 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HydraniumDiagramLoader = void 0;
 const client_1 = require("@eclipse-glsp/client");
-const browser_1 = require("@hydranium/client-theia/lib/browser");
+const browser_1 = require("@hydranium/client-theia/browser");
 const protocol_1 = require("@hydranium/protocol");
+const core_1 = require("@theia/core");
 const inversify_1 = require("@theia/core/shared/inversify");
 /**
  * Diagram loader that never lets a load failure vanish.
@@ -75,10 +76,7 @@ let HydraniumDiagramLoader = class HydraniumDiagramLoader extends client_1.Diagr
             this.settle({ status: 'loaded' });
         }
         catch (err) {
-            // Report first, settle second, and carry whether the report landed: a
-            // consumer that uncovers the canvas on settle then finds the error
-            // already on the status overlay — or learns that it has to render the
-            // failure itself because nothing else can.
+            // Report first, settle second, and carry whether the report landed.
             const surfaced = await this.reportLoadFailure(err);
             this.settle({ status: 'failed', error: err, surfaced });
         }
@@ -128,18 +126,28 @@ let HydraniumDiagramLoader = class HydraniumDiagramLoader extends client_1.Diagr
     }
     /**
      * The sentence a failed load is reported with, on every surface that reports
-     * it, and the only seam an adopter rewords or localizes it at. Public
-     * because the canvas overlay is one of those surfaces and lives in another
-     * class: it renders this failure exactly when the `StatusAction` did not
-     * land, so a second copy of the sentence there could only ever drift unseen.
+     * it. Public because the canvas overlay is one of those surfaces and lives in
+     * another class, where a second copy of the sentence would drift.
+     *
+     * **The seam and the catalogue key answer different questions, so it carries
+     * both.** Overriding this method changes the WORDING for every user of one
+     * adopter's product; the key is what gives a reader the sentence in their own
+     * language, and no override can supply that without an adopter writing a
+     * subclass per locale — which is the thing a catalogue exists to avoid. Two
+     * of the three surfaces this reaches are user-visible, so the audience
+     * triage answers it: a host-bound string a user sees takes an inline key.
+     *
+     * The Output-channel line is therefore localized too, which is deliberate
+     * rather than overlooked — the alternative is a second English copy of one
+     * sentence, and the reason for a single source here has not changed.
      */
     loadFailureLabel(err) {
-        return `Diagram failed to load: ${this.formatError(err)}`;
+        return core_1.nls.localize('hydranium/glsp-client-theia/diagram-load-failed', 'Diagram failed to load: {0}', this.formatError(err));
     }
     /** Render a thrown value as a message. Shared so the channel line, the status
      *  overlay and any consumer rendering {@link DiagramLoadFailure.error} agree. */
     formatError(err) {
-        return err instanceof Error ? err.message : String(err);
+        return (0, protocol_1.describeError)(err);
     }
 };
 exports.HydraniumDiagramLoader = HydraniumDiagramLoader;

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

@@ -1 +1 @@
-{"version":3,"file":"diagram-loader.js","sourceRoot":"","sources":["../../src/browser/diagram-loader.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;AAElF,iDAA+F;AAC/F,iEAAoE;AACpE,kDAA+C;AAC/C,4DAAkE;AAkClE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAuB,SAAQ,sBAAa;IACZ,OAAO,CAAiB;IAE/C,OAAO,GAAG,IAAI,mBAAQ,EAAsB,CAAC;IACtD,OAAO,CAAsB;IAEvC;;;+DAG2D;IAC3D,IAAI,WAAW;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC;IACvB,CAAC;IAED;uEACmE;IACnE,eAAe;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;IAC/B,CAAC;IAEQ,KAAK,CAAC,IAAI,CAAC,OAA+B;QAChD,IAAI,CAAC;YACF,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACZ,sEAAsE;YACtE,mEAAmE;YACnE,sEAAsE;YACtE,2CAA2C;YAC3C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3D,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACO,MAAM,CAAC,OAA2B;QACzC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO;QACV,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;OAWG;IACO,KAAK,CAAC,iBAAiB,CAAC,GAAY;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC;YACF,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,qBAAY,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;YACxF,OAAO,IAAI,CAAC;QACf,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,kEAAkE,EAAE,SAAS,CAAC,CAAC;YAClG,OAAO,KAAK,CAAC;QAChB,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,gBAAgB,CAAC,GAAY;QAC1B,OAAO,2BAA2B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7D,CAAC;IAED;qFACiF;IACvE,WAAW,CAAC,GAAY;QAC/B,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;CACH,CAAA;AA9FY,wDAAsB;AACU;IAAzC,IAAA,kBAAM,EAAC,uBAAa,CAAC;8BAA8B,uBAAa;uDAAC;iCADxD,sBAAsB;IADlC,IAAA,sBAAU,GAAE;GACA,sBAAsB,CA8FlC"}
+{"version":3,"file":"diagram-loader.js","sourceRoot":"","sources":["../../src/browser/diagram-loader.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;AAElF,iDAA+F;AAC/F,6DAAgE;AAChE,kDAA8D;AAC9D,sCAAkC;AAClC,4DAAkE;AAiClE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAuB,SAAQ,sBAAa;IACZ,OAAO,CAAiB;IAE/C,OAAO,GAAG,IAAI,mBAAQ,EAAsB,CAAC;IACtD,OAAO,CAAsB;IAEvC;;;+DAG2D;IAC3D,IAAI,WAAW;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC;IACvB,CAAC;IAED;uEACmE;IACnE,eAAe;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;IAC/B,CAAC;IAEQ,KAAK,CAAC,IAAI,CAAC,OAA+B;QAChD,IAAI,CAAC;YACF,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACZ,oEAAoE;YACpE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3D,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACO,MAAM,CAAC,OAA2B;QACzC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO;QACV,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;OAWG;IACO,KAAK,CAAC,iBAAiB,CAAC,GAAY;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC;YACF,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,qBAAY,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;YACxF,OAAO,IAAI,CAAC;QACf,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,kEAAkE,EAAE,SAAS,CAAC,CAAC;YAClG,OAAO,KAAK,CAAC;QAChB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,gBAAgB,CAAC,GAAY;QAC1B,OAAO,UAAG,CAAC,QAAQ,CAAC,iDAAiD,EAAE,6BAA6B,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAChI,CAAC;IAED;qFACiF;IACvE,WAAW,CAAC,GAAY;QAC/B,OAAO,IAAA,wBAAa,EAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;CACH,CAAA;;AApG4C;IAAzC,IAAA,kBAAM,EAAC,uBAAa,CAAC;8BAA8B,uBAAa;uDAAC;iCADxD,sBAAsB;IADlC,IAAA,sBAAU,GAAE;GACA,sBAAsB,CAqGlC"}

package/lib/browser/diagram-only-marker-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagram-only-marker-manager.d.ts","sourceRoot":"","sources":["../../src/browser/diagram-only-marker-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,qBAAqB,EAAE,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAG1E;;;;;;;;;;;;;;GAcG;AACH,qBACa,yBAA0B,SAAQ,qBAAqB;IACjE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;CAG7E"}
+{"version":3,"file":"diagram-only-marker-manager.d.ts","sourceRoot":"","sources":["../../src/browser/diagram-only-marker-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,qBAAqB,EAAE,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAG1E;;;;;;;;;;;;;;GAcG;AACH,qBACa,yBAA0B,SAAQ,qBAAqB;IACjE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAE1E;CACH"}

package/lib/browser/diagram-only-marker-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagram-only-marker-manager.js","sourceRoot":"","sources":["../../src/browser/diagram-only-marker-manager.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;AAElF,iDAA0E;AAC1E,4DAA0D;AAE1D;;;;;;;;;;;;;;GAcG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,8BAAqB;IACjE,UAAU,CAAC,QAAkB,EAAE,OAAgB,EAAE,UAAmB;QACjE,6DAA6D;IAChE,CAAC;CACH,CAAA;AAJY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,sBAAU,GAAE;GACA,yBAAyB,CAIrC"}
+{"version":3,"file":"diagram-only-marker-manager.js","sourceRoot":"","sources":["../../src/browser/diagram-only-marker-manager.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;AAElF,iDAA0E;AAC1E,4DAA0D;AAE1D;;;;;;;;;;;;;;GAcG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,8BAAqB;IACjE,UAAU,CAAC,QAAkB,EAAE,OAAgB,EAAE,UAAmB;QACjE,6DAA6D;IAChE,CAAC;CACH,CAAA;;oCAJY,yBAAyB;IADrC,IAAA,sBAAU,GAAE;GACA,yBAAyB,CAIrC"}

package/lib/browser/diagram-widget.d.ts

@@ -6,9 +6,13 @@
  *
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
-import { GLSPDiagramWidget } from '@eclipse-glsp/theia-integration';
+import { type Args } from '@eclipse-glsp/client';
+import { GLSPDiagramWidget, type GLSPDiagramWidgetOptions } from '@eclipse-glsp/theia-integration';
 import { type Message } from '@theia/core/lib/browser';
+import { Emitter, type Event } from '@theia/core';
+import { type Container } from '@theia/core/shared/inversify';
 import { type DiagramLoadOutcome, HydraniumDiagramLoader } from './diagram-loader';
+import { WindowSessionService } from './window-session';
 import '../../style/diagram-loading.css';
 /** Class on the overlay root. Adopters style / override via this contract. */
 export declare const DIAGRAM_LOADING_CLASS = "hydranium-diagram-loading";
@@ -24,32 +28,48 @@ export declare const DIAGRAM_LOADING_FAILED_CLASS = "hydranium-diagram-loading-f
  * 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.
+ * from `actionDispatcher.onceModelInitialized()`: the loader settles on failure
+ * as well as on success, even when its own error report throws, while
+ * `onceModelInitialized()` never settles on a failed load and would leave the
+ * spinner turning for good.
  *
- * **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.
+ * A failed load keeps the overlay up with the error and a Retry, which asks for
+ * a fresh widget through {@link onDidRequestReopen}.
  *
  * 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}.
+ *
+ * Its saveable is a {@link HydraniumGlspSaveable}, which keeps a pending save
+ * dirty, so Theia's exit check still counts it; see {@link createSaveable}.
  */
 export declare class HydraniumGlspDiagramWidget extends GLSPDiagramWidget {
+    protected readonly windowSessions: WindowSessionService;
     protected loadingOverlay?: HTMLElement;
+    protected readonly reopenRequestEmitter: Emitter<void>;
+    /** Fires when this diagram asks to be replaced by a fresh widget, as its
+     *  Retry does; `AbstractHydraniumGlspDiagramManager` reopens it. A load is
+     *  not repeated in place, since GLSP's model source registers its handlers
+     *  once per load. */
+    readonly onDidRequestReopen: Event<void>;
+    /**
+     * Replaces the saveable GLSP's `configure` builds inline, with no factory
+     * seam. The widget factory calls `configure` before the widget reaches the
+     * shell, so Theia only ever tracks this one.
+     */
+    configure(options: GLSPDiagramWidgetOptions, diContainer: Container): void;
+    /** The widget's saveable. Override to change how saves and dirty state behave. */
+    protected createSaveable(): GLSPDiagramWidget['saveable'];
+    /** Adds the window's resume token, so a reload or reconnect takes this diagram's session over. */
+    protected getRequestModelOptions(): Args;
     protected onAfterAttach(msg: Message): void;
     dispose(): void;
+    /**
+     * GLSP's restore with `animate: false`; compare the two on a GLSP upgrade.
+     * An animated restore holds back every later command, so a Delete right
+     * after a select-all typed as the diagram opens finds nothing selected.
+     */
+    protected setViewportData(viewportData: Parameters<GLSPDiagramWidget['setViewportData']>[0]): Promise<void>;
     /**
      * Cover the canvas until the load settles.
      *
@@ -59,13 +79,7 @@ export declare class HydraniumGlspDiagramWidget extends GLSPDiagramWidget {
      * rather than creating and immediately removing one, so there is no flash.
      */
     protected showLoadingOverlay(): void;
-    /**
-     * 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.
-     */
+    /** Take the overlay down, or keep it as the failure's report. */
     protected onLoadSettled(outcome: DiagramLoadOutcome): void;
     /**
      * Repurpose the pending overlay in place as a failure report: same node, so
@@ -78,6 +92,10 @@ export declare class HydraniumGlspDiagramWidget extends GLSPDiagramWidget {
      * is a no-op rather than a fallback wording.
      */
     protected showLoadFailure(error: unknown): void;
+    /** Ask for a fresh widget, after a failed load. */
+    protected retryLoad(): void;
+    /** Build the failure overlay's Retry button, which calls {@link retryLoad}. */
+    protected createRetryButton(): HTMLElement;
     protected hideLoadingOverlay(): void;
     /** 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

package/lib/browser/diagram-widget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagram-widget.d.ts","sourceRoot":"","sources":["../../src/browser/diagram-widget.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGpE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,KAAK,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAInF,OAAO,iCAAiC,CAAC;AAEzC,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,8BAA8B,CAAC;AAEjE;kFACkF;AAClF,eAAO,MAAM,4BAA4B,qCAAoC,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBACa,0BAA2B,SAAQ,iBAAiB;IAC9D,SAAS,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC;cAEpB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAO3C,OAAO,IAAI,IAAI;IAKxB;;;;;;;OAOG;IACH,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAmBpC;;;;;;OAMG;IACH,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAQ1D;;;;;;;;;OASG;IACH,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAa/C,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAKpC;;oFAEgF;IAChF,SAAS,CAAC,oBAAoB,IAAI,WAAW;IAa7C;sEACkE;IAClE,SAAS,KAAK,YAAY,IAAI,MAAM,CAEnC;IAED;;;;;OAKG;IACH,SAAS,KAAK,sBAAsB,IAAI,sBAAsB,GAAG,SAAS,CAGzE;CACH"}
+{"version":3,"file":"diagram-widget.d.ts","sourceRoot":"","sources":["../../src/browser/diagram-widget.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,IAAI,EAAgF,MAAM,sBAAsB,CAAC;AAE/H,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAGnG,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,KAAK,KAAK,EAAO,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,KAAK,SAAS,EAAsB,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,KAAK,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAEnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAIxD,OAAO,iCAAiC,CAAC;AAEzC,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,8BAA8B,CAAC;AAEjE;kFACkF;AAClF,eAAO,MAAM,4BAA4B,qCAAoC,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBACa,0BAA2B,SAAQ,iBAAiB;IAChC,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAG,oBAAoB,CAAC;IACvF,SAAS,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC;IACvC,SAAS,CAAC,QAAQ,CAAC,oBAAoB,gBAAuB;IAE9D;;;yBAGqB;IACrB,QAAQ,CAAC,kBAAkB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAmC;IAE3E;;;;OAIG;IACM,SAAS,CAAC,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,SAAS,GAAG,IAAI,CAMlF;IAED,kFAAkF;IAClF,SAAS,CAAC,cAAc,IAAI,iBAAiB,CAAC,UAAU,CAAC,CAExD;IAED,kGAAkG;IAClG,UAAmB,sBAAsB,IAAI,IAAI,CAEhD;IAED,UAAmB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAKnD;IAEQ,OAAO,IAAI,IAAI,CAGvB;IAED;;;;OAIG;IACH,UAAyB,eAAe,CAAC,YAAY,EAAE,UAAU,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzH;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,kBAAkB,IAAI,IAAI,CAiBnC;IAED,iEAAiE;IACjE,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAMzD;IAED;;;;;;;;;OASG;IACH,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAY9C;IAED,mDAAmD;IACnD,SAAS,CAAC,SAAS,IAAI,IAAI,CAI1B;IAED,+EAA+E;IAC/E,SAAS,CAAC,iBAAiB,IAAI,WAAW,CAMzC;IAED,SAAS,CAAC,kBAAkB,IAAI,IAAI,CAGnC;IAED;;oFAEgF;IAChF,SAAS,CAAC,oBAAoB,IAAI,WAAW,CAW5C;IAED;sEACkE;IAClE,SAAS,KAAK,YAAY,IAAI,MAAM,CAEnC;IAED;;;;;OAKG;IACH,SAAS,KAAK,sBAAsB,IAAI,sBAAsB,GAAG,SAAS,CAGzE;CACH"}