@hydranium/glsp-client-theia 1.0.0-next.32 → 1.0.0-next.321

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

@@ -1,123 +0,0 @@
-/********************************************************************************
- * 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 { DiagramLoader, type DiagramLoadingOptions } from '@eclipse-glsp/client';
-import { ChannelLogger } from '@hydranium/client-theia/lib/browser';
-import { Deferred } from '@hydranium/protocol';
-/**
- * How a diagram load ended. A discriminated union rather than a boolean or a
- * string: a consumer showing a pending indicator has to distinguish "not settled
- * yet" (`undefined`) from either terminal state, and the failed arm has to carry
- * enough for that consumer to decide whether *it* is now the only thing that can
- * report the failure — see {@link DiagramLoadFailure.surfaced}.
- */
-export type DiagramLoadOutcome = DiagramLoadSuccess | DiagramLoadFailure;
-export interface DiagramLoadSuccess {
-    readonly status: 'loaded';
-}
-export interface DiagramLoadFailure {
-    readonly status: 'failed';
-    /** The thrown value, verbatim. `unknown` because a rejection can be anything. */
-    readonly error: unknown;
-    /**
-     * Whether the `severity: 'ERROR'` {@link StatusAction} reached the action
-     * dispatcher — i.e. whether GLSP's `StatusOverlay` is now displaying this
-     * failure.
-     *
-     * `false` means the report itself failed, which happens when the action
-     * dispatcher is the thing that could not initialize. A consumer that covers
-     * the canvas must then render the failure itself: it is the only surface
-     * left, and removing its overlay would leave a blank diagram whose only
-     * explanation is a line in the Output channel — the exact failure mode this
-     * loader exists to prevent.
-     */
-    readonly surfaced: boolean;
-}
-/**
- * Diagram loader that never lets a load failure vanish.
- *
- * `DiagramLoader.load()` orchestrates the full diagram-init path — action
- * dispatcher init, GLSP-client connect + server `initialize`, the first
- * `RequestModelAction`, and the model-initialization constraint. Of these only
- * the `IDiagramStartup` hooks are wrapped by the base loader (it logs them to
- * `console.error`); the dispatcher-init / connection / request-model steps are
- * not. The widget that drives loading
- * (`@eclipse-glsp/theia-integration`'s `GLSPDiagramWidget.onAfterAttach`)
- * calls `load()` *without awaiting or catching it*, so any rejection becomes an
- * uncaught promise rejection visible only in the browser devtools console —
- * nothing reaches the e2e output, the server log, or a Theia log sink, and the
- * diagram just stays blank.
- *
- * This subclass closes that gap: it catches every load failure, routes it to
- * the framework Output channel (the same {@link ChannelLogger} sink the server
- * log and action traffic share, so it is discoverable where a developer already
- * looks), and surfaces a persistent error to the user via a `severity: 'ERROR'`
- * {@link StatusAction} on the diagram's status overlay. It deliberately does
- * **not** rethrow — the caller drops the promise, so rethrowing would only
- * reproduce the uncaught rejection this exists to prevent.
- *
- * It also publishes the load's terminal state ({@link loadOutcome} /
- * {@link onceLoadSettled}) so a pending indicator has one authority to key on.
- * `HydraniumGlspDiagramWidget` uses it to cover the canvas while loading; see
- * {@link settle} for why the signal cannot be derived from the error
- * `StatusAction` instead.
- *
- * Bound by `createGlspClientTheiaModule` via `rebind(DiagramLoader)`.
- */
-export declare class HydraniumDiagramLoader extends DiagramLoader {
-    protected readonly channel: ChannelLogger;
-    protected readonly settled: Deferred<DiagramLoadOutcome>;
-    protected outcome?: DiagramLoadOutcome;
-    /** Terminal state of the load, or `undefined` while it is still in flight.
-     *  The synchronous companion of {@link onceLoadSettled}, for a consumer that
-     *  must decide something in the same tick (e.g. whether to show an indicator
-     *  at all when re-attaching an already-loaded diagram). */
-    get loadOutcome(): DiagramLoadOutcome | undefined;
-    /** Resolves once the load reaches a terminal state — on success **and** on
-     *  failure, so a caller awaiting it cannot hang. Never rejects. */
-    onceLoadSettled(): Promise<DiagramLoadOutcome>;
-    load(options?: DiagramLoadingOptions): Promise<void>;
-    /**
-     * Record the terminal state and release {@link onceLoadSettled}. Idempotent —
-     * the first outcome wins, so a reload cannot flip a settled indicator.
-     *
-     * This runs unconditionally after {@link reportLoadFailure}, *including* when
-     * the status dispatch inside it threw. That is the load-bearing property: when
-     * the action dispatcher is itself the thing that failed to initialize — the
-     * exact failure this class exists for — no `StatusAction` ever lands, so a
-     * consumer observing actions would wait forever. Settling here means a pending
-     * indicator always comes down, and `surfaced: false` tells that consumer it is
-     * now the only thing that can report the failure.
-     */
-    protected settle(outcome: DiagramLoadOutcome): void;
-    /**
-     * Route a diagram-load failure to the Output channel and the status overlay.
-     * The status dispatch is itself guarded: when the action dispatcher is the
-     * thing that failed to initialize, dispatching may throw too, and a failure
-     * to *report* the failure must not re-escape as an uncaught rejection.
-     *
-     * @returns whether the `StatusAction` reached the dispatcher — i.e. whether the
-     * user can see this failure on the diagram. The channel line always happens, so
-     * the return value is specifically about the *user-visible* report; a `false`
-     * makes {@link DiagramLoadFailure.surfaced} false and hands the job to whoever
-     * is covering the canvas.
-     */
-    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.
-     */
-    loadFailureLabel(err: unknown): string;
-    /** Render a thrown value as a message. Shared so the channel line, the status
-     *  overlay and any consumer rendering {@link DiagramLoadFailure.error} agree. */
-    protected formatError(err: unknown): string;
-}
-//# sourceMappingURL=diagram-loader.d.ts.map

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

@@ -1 +0,0 @@
-{"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"}

package/lib/browser/diagram-loader.js

@@ -1,153 +0,0 @@
-"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.HydraniumDiagramLoader = void 0;
-const client_1 = require("@eclipse-glsp/client");
-const browser_1 = require("@hydranium/client-theia/lib/browser");
-const protocol_1 = require("@hydranium/protocol");
-const inversify_1 = require("@theia/core/shared/inversify");
-/**
- * Diagram loader that never lets a load failure vanish.
- *
- * `DiagramLoader.load()` orchestrates the full diagram-init path — action
- * dispatcher init, GLSP-client connect + server `initialize`, the first
- * `RequestModelAction`, and the model-initialization constraint. Of these only
- * the `IDiagramStartup` hooks are wrapped by the base loader (it logs them to
- * `console.error`); the dispatcher-init / connection / request-model steps are
- * not. The widget that drives loading
- * (`@eclipse-glsp/theia-integration`'s `GLSPDiagramWidget.onAfterAttach`)
- * calls `load()` *without awaiting or catching it*, so any rejection becomes an
- * uncaught promise rejection visible only in the browser devtools console —
- * nothing reaches the e2e output, the server log, or a Theia log sink, and the
- * diagram just stays blank.
- *
- * This subclass closes that gap: it catches every load failure, routes it to
- * the framework Output channel (the same {@link ChannelLogger} sink the server
- * log and action traffic share, so it is discoverable where a developer already
- * looks), and surfaces a persistent error to the user via a `severity: 'ERROR'`
- * {@link StatusAction} on the diagram's status overlay. It deliberately does
- * **not** rethrow — the caller drops the promise, so rethrowing would only
- * reproduce the uncaught rejection this exists to prevent.
- *
- * It also publishes the load's terminal state ({@link loadOutcome} /
- * {@link onceLoadSettled}) so a pending indicator has one authority to key on.
- * `HydraniumGlspDiagramWidget` uses it to cover the canvas while loading; see
- * {@link settle} for why the signal cannot be derived from the error
- * `StatusAction` instead.
- *
- * Bound by `createGlspClientTheiaModule` via `rebind(DiagramLoader)`.
- */
-let HydraniumDiagramLoader = class HydraniumDiagramLoader extends client_1.DiagramLoader {
-    channel;
-    settled = new protocol_1.Deferred();
-    outcome;
-    /** Terminal state of the load, or `undefined` while it is still in flight.
-     *  The synchronous companion of {@link onceLoadSettled}, for a consumer that
-     *  must decide something in the same tick (e.g. whether to show an indicator
-     *  at all when re-attaching an already-loaded diagram). */
-    get loadOutcome() {
-        return this.outcome;
-    }
-    /** Resolves once the load reaches a terminal state — on success **and** on
-     *  failure, so a caller awaiting it cannot hang. Never rejects. */
-    onceLoadSettled() {
-        return this.settled.promise;
-    }
-    async load(options) {
-        try {
-            await super.load(options);
-            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.
-            const surfaced = await this.reportLoadFailure(err);
-            this.settle({ status: 'failed', error: err, surfaced });
-        }
-    }
-    /**
-     * Record the terminal state and release {@link onceLoadSettled}. Idempotent —
-     * the first outcome wins, so a reload cannot flip a settled indicator.
-     *
-     * This runs unconditionally after {@link reportLoadFailure}, *including* when
-     * the status dispatch inside it threw. That is the load-bearing property: when
-     * the action dispatcher is itself the thing that failed to initialize — the
-     * exact failure this class exists for — no `StatusAction` ever lands, so a
-     * consumer observing actions would wait forever. Settling here means a pending
-     * indicator always comes down, and `surfaced: false` tells that consumer it is
-     * now the only thing that can report the failure.
-     */
-    settle(outcome) {
-        if (this.outcome !== undefined) {
-            return;
-        }
-        this.outcome = outcome;
-        this.settled.resolve(outcome);
-    }
-    /**
-     * Route a diagram-load failure to the Output channel and the status overlay.
-     * The status dispatch is itself guarded: when the action dispatcher is the
-     * thing that failed to initialize, dispatching may throw too, and a failure
-     * to *report* the failure must not re-escape as an uncaught rejection.
-     *
-     * @returns whether the `StatusAction` reached the dispatcher — i.e. whether the
-     * user can see this failure on the diagram. The channel line always happens, so
-     * the return value is specifically about the *user-visible* report; a `false`
-     * makes {@link DiagramLoadFailure.surfaced} false and hands the job to whoever
-     * is covering the canvas.
-     */
-    async reportLoadFailure(err) {
-        const label = this.loadFailureLabel(err);
-        this.channel.error(label, err);
-        try {
-            await this.actionDispatcher.dispatch(client_1.StatusAction.create(label, { severity: 'ERROR' }));
-            return true;
-        }
-        catch (statusErr) {
-            this.channel.error('Failed to surface the diagram-load failure on the status overlay', statusErr);
-            return false;
-        }
-    }
-    /**
-     * 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.
-     */
-    loadFailureLabel(err) {
-        return `Diagram failed to load: ${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);
-    }
-};
-exports.HydraniumDiagramLoader = HydraniumDiagramLoader;
-__decorate([
-    (0, inversify_1.inject)(browser_1.ChannelLogger),
-    __metadata("design:type", browser_1.ChannelLogger)
-], HydraniumDiagramLoader.prototype, "channel", void 0);
-exports.HydraniumDiagramLoader = HydraniumDiagramLoader = __decorate([
-    (0, inversify_1.injectable)()
-], HydraniumDiagramLoader);
-//# sourceMappingURL=diagram-loader.js.map

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

@@ -1 +0,0 @@
-{"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"}

package/lib/browser/hidden-bounds-updater.d.ts

@@ -1,122 +0,0 @@
-/********************************************************************************
- * 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 Action, type ElementAndRoutingPoints, type GModelElement, type GRoutableElement, GLSPHiddenBoundsUpdater, RequestBoundsAction } from '@eclipse-glsp/client';
-import { ChannelLogger } from '@hydranium/client-theia/lib/browser';
-import { type Clock } from '@hydranium/protocol';
-import { type VNode } from 'snabbdom';
-/**
- * Instruments sprotty's hidden-bounds pass and repairs degenerate routes before
- * they go on the wire.
- *
- * **Why the framework owns this.** Every GLSP head runs the hidden-bounds pass on
- * every model update, and it is the one client-side phase that scales with the
- * *rendered element count* rather than the model size — labels, compartments and
- * edge decorations expand a modest node count into orders of magnitude more DOM
- * elements. Without a timing line there is no way to tell a slow measurement pass
- * apart from slow edge routing or a slow server round trip; with one,
- * `bounds-request` either exonerates the client in a sentence or names the
- * dominant cost.
- *
- * Emits exactly one `trace` line per bounds request — `trace` because the
- * frequency matches the per-action traffic `HydraniumGlspActionDispatcher` logs
- * there (a bounds request is driven by those actions), so it belongs with them
- * rather than above them. The line carries:
- *
- *  - `server` / `local` — whether the request came from the server or from a
- *    client-local {@link LocalRequestBoundsAction}
- *  - `scope=<ids>` — the elements a scoped request named; absent when the request
- *    covers the whole diagram
- *  - `measured=N` — DOM elements whose bounds were read. Exceeds the scoped id
- *    count because the base class expands each requested element to its
- *    descendants
- *  - `getBBox=Nms` — {@link getBoundsFromDOM} **only**: the layout pass and the
- *    `ComputedBoundsAction` assembly stay outside it, so the number isolates raw
- *    measurement cost
- *
- * Composed from {@link Clock.measure} rather than `Tracer.time`, matching
- * `HydraniumDocumentBuilder`'s phase instrumentation. `Tracer.time` is for "tell
- * me when this is slow" and is deliberately silent on a fast success, which would
- * drop the element count on every normal pass — and forcing it to emit costs a
- * paired `[#N start]` line per request. This is a per-occurrence record, so it
- * measures and composes its own line.
- *
- * Bound by `createGlspClientTheiaModule` via `rebind(GLSPHiddenBoundsUpdater)`.
- */
-export declare class HydraniumHiddenBoundsUpdater extends GLSPHiddenBoundsUpdater {
-    protected readonly channel: ChannelLogger;
-    /** Not injected: the browser container binds no {@link Clock}, and this only
-     *  measures — no logic is gated on time, so there is nothing to fake in
-     *  production. Overridden in tests for a deterministic elapsed value. */
-    protected readonly clock: Clock;
-    /**
-     * Scope description for the in-flight request, read from the `cause` in
-     * {@link postUpdate} and consumed by {@link getBoundsFromDOM} — which the base
-     * class calls with no arguments, so the cause cannot be threaded through.
-     */
-    protected currentScope?: string;
-    decorate(vnode: VNode, element: GModelElement): VNode;
-    /**
-     * Replace the routing entry the base class just pushed when it carries fewer
-     * than two points, which is not a valid route for any edge.
-     *
-     * `calcElementAndRoute` already guards the case where the registered router
-     * returns *nothing* — it falls back to source + own routing points + target.
-     * The hole is one step further in: `calcRoute` filters duplicate points at
-     * `Number.EPSILON`, so while obstacles still carry sprotty's unmeasured-bounds
-     * sentinel `(100, 100, -1, -1)` the source and target coincide and a valid
-     * two-point route collapses to a single point. That result is defined, so the
-     * upstream truthiness guard never fires and the single point ships.
-     *
-     * The substitute is deliberately upstream's own fallback shape rather than a
-     * new invention, so a repaired route is indistinguishable from a route the
-     * base class would have produced had it noticed. Only already-invalid payloads
-     * are touched, so a head with a working router is unaffected.
-     */
-    protected repairLastRoute(element: GRoutableElement): void;
-    /** A route needs at least a start and an end point to describe an edge. */
-    protected hasValidRoute(route: ElementAndRoutingPoints): boolean;
-    /** Upstream's `calcElementAndRoute` no-router fallback: the element's own
-     *  bendpoints framed by its source and target anchor positions. */
-    protected toSourceTargetRoute(element: GRoutableElement): ElementAndRoutingPoints;
-    protected getBoundsFromDOM(): void;
-    /** Format the per-request line. Override to change the wording. */
-    protected formatBoundsRequest(scope: string, measured: number, elapsedMs: number): string;
-    postUpdate(cause?: Action): void;
-    /**
-     * Scope facts for the log line: where the request came from, and which
-     * elements it asked for.
-     *
-     * Origin is read from {@link ServerAction}, the `__receivedFromServer` marker
-     * `GLSPModelSource` stamps on inbound actions, rather than from
-     * `LocalRequestBoundsAction.is`. The latter would answer the same today, but
-     * only incidentally: its `elementIDs` check is declared optional, so it is
-     * really just "a bounds request that did not come from the server". Keying on
-     * the marker states that directly, and keeps an *unscoped* local request from
-     * being mislabelled `server` if GLSP ever tightens that guard.
-     */
-    protected formatCause(cause: Action): string;
-    /**
-     * Name the elements a scoped request asked for, or `undefined` when it covers
-     * the whole diagram.
-     *
-     * Deliberately the ids and not their count. A scoped request in practice names
-     * a single element, so a count is always `1` and says nothing, while the id
-     * says *which* element was re-measured — and it is the only part of the line
-     * that distinguishes one such request from the next. It also stops the line
-     * reading as a contradiction: `scope=node0, measured=6` is coherent (the base
-     * class expands a requested element to its descendants, so one id measures six
-     * DOM elements), where `scoped=1, measured=6` invites the reader to wonder
-     * which number is wrong.
-     *
-     * A request naming only the root is treated as unscoped: it measures
-     * everything, so the id adds nothing over the absence of a `scope` tag.
-     */
-    protected formatScope(cause: RequestBoundsAction): string | undefined;
-}
-//# sourceMappingURL=hidden-bounds-updater.d.ts.map

package/lib/browser/hidden-bounds-updater.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hidden-bounds-updater.d.ts","sourceRoot":"","sources":["../../src/browser/hidden-bounds-updater.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,KAAK,MAAM,EACX,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,uBAAuB,EAGvB,mBAAmB,EAGrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,KAAK,KAAK,EAAe,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAOtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBACa,4BAA6B,SAAQ,uBAAuB;IAC/C,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAG,aAAa,CAAC;IAElE;;6EAEyE;IACzE,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAqB;IAEpD;;;;OAIG;IACH,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,GAAG,KAAK;IAQ9D;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAQ1D,2EAA2E;IAC3E,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO;IAIhE;uEACmE;IACnE,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,uBAAuB;cAO9D,gBAAgB,IAAI,IAAI;IAa3C,mEAAmE;IACnE,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAIhF,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAazC;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAM5C;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS;CAcvE"}

package/lib/browser/hidden-bounds-updater.js

@@ -1,207 +0,0 @@
-"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.HydraniumHiddenBoundsUpdater = void 0;
-const client_1 = require("@eclipse-glsp/client");
-const browser_1 = require("@hydranium/client-theia/lib/browser");
-const protocol_1 = require("@hydranium/protocol");
-const inversify_1 = require("@theia/core/shared/inversify");
-/** How many scoped element ids the log line names before summarising the rest.
- *  A scoped request names one element in practice; the cap only stops a
- *  pathological caller from writing a thousand ids into the channel. */
-const SCOPE_ID_CAP = 3;
-/**
- * Instruments sprotty's hidden-bounds pass and repairs degenerate routes before
- * they go on the wire.
- *
- * **Why the framework owns this.** Every GLSP head runs the hidden-bounds pass on
- * every model update, and it is the one client-side phase that scales with the
- * *rendered element count* rather than the model size — labels, compartments and
- * edge decorations expand a modest node count into orders of magnitude more DOM
- * elements. Without a timing line there is no way to tell a slow measurement pass
- * apart from slow edge routing or a slow server round trip; with one,
- * `bounds-request` either exonerates the client in a sentence or names the
- * dominant cost.
- *
- * Emits exactly one `trace` line per bounds request — `trace` because the
- * frequency matches the per-action traffic `HydraniumGlspActionDispatcher` logs
- * there (a bounds request is driven by those actions), so it belongs with them
- * rather than above them. The line carries:
- *
- *  - `server` / `local` — whether the request came from the server or from a
- *    client-local {@link LocalRequestBoundsAction}
- *  - `scope=<ids>` — the elements a scoped request named; absent when the request
- *    covers the whole diagram
- *  - `measured=N` — DOM elements whose bounds were read. Exceeds the scoped id
- *    count because the base class expands each requested element to its
- *    descendants
- *  - `getBBox=Nms` — {@link getBoundsFromDOM} **only**: the layout pass and the
- *    `ComputedBoundsAction` assembly stay outside it, so the number isolates raw
- *    measurement cost
- *
- * Composed from {@link Clock.measure} rather than `Tracer.time`, matching
- * `HydraniumDocumentBuilder`'s phase instrumentation. `Tracer.time` is for "tell
- * me when this is slow" and is deliberately silent on a fast success, which would
- * drop the element count on every normal pass — and forcing it to emit costs a
- * paired `[#N start]` line per request. This is a per-occurrence record, so it
- * measures and composes its own line.
- *
- * Bound by `createGlspClientTheiaModule` via `rebind(GLSPHiddenBoundsUpdater)`.
- */
-let HydraniumHiddenBoundsUpdater = class HydraniumHiddenBoundsUpdater extends client_1.GLSPHiddenBoundsUpdater {
-    channel;
-    /** Not injected: the browser container binds no {@link Clock}, and this only
-     *  measures — no logic is gated on time, so there is nothing to fake in
-     *  production. Overridden in tests for a deterministic elapsed value. */
-    clock = new protocol_1.SystemClock();
-    /**
-     * Scope description for the in-flight request, read from the `cause` in
-     * {@link postUpdate} and consumed by {@link getBoundsFromDOM} — which the base
-     * class calls with no arguments, so the cause cannot be threaded through.
-     */
-    currentScope;
-    decorate(vnode, element) {
-        super.decorate(vnode, element);
-        if ((0, client_1.isRoutable)(element)) {
-            this.repairLastRoute(element);
-        }
-        return vnode;
-    }
-    /**
-     * Replace the routing entry the base class just pushed when it carries fewer
-     * than two points, which is not a valid route for any edge.
-     *
-     * `calcElementAndRoute` already guards the case where the registered router
-     * returns *nothing* — it falls back to source + own routing points + target.
-     * The hole is one step further in: `calcRoute` filters duplicate points at
-     * `Number.EPSILON`, so while obstacles still carry sprotty's unmeasured-bounds
-     * sentinel `(100, 100, -1, -1)` the source and target coincide and a valid
-     * two-point route collapses to a single point. That result is defined, so the
-     * upstream truthiness guard never fires and the single point ships.
-     *
-     * The substitute is deliberately upstream's own fallback shape rather than a
-     * new invention, so a repaired route is indistinguishable from a route the
-     * base class would have produced had it noticed. Only already-invalid payloads
-     * are touched, so a head with a working router is unaffected.
-     */
-    repairLastRoute(element) {
-        const addedRoute = this.element2route.pop();
-        if (addedRoute === undefined) {
-            return;
-        }
-        this.element2route.push(this.hasValidRoute(addedRoute) ? addedRoute : this.toSourceTargetRoute(element));
-    }
-    /** A route needs at least a start and an end point to describe an edge. */
-    hasValidRoute(route) {
-        return route.newRoutingPoints !== undefined && route.newRoutingPoints.length >= 2;
-    }
-    /** Upstream's `calcElementAndRoute` no-router fallback: the element's own
-     *  bendpoints framed by its source and target anchor positions. */
-    toSourceTargetRoute(element) {
-        return {
-            elementId: element.id,
-            newRoutingPoints: [element.source?.position ?? client_1.Point.ORIGIN, ...element.routingPoints, element.target?.position ?? client_1.Point.ORIGIN]
-        };
-    }
-    getBoundsFromDOM() {
-        if (this.currentScope === undefined) {
-            // Not inside an instrumented `postUpdate` (a subclass calling directly);
-            // with no cause there is nothing to attribute a measurement to.
-            super.getBoundsFromDOM();
-            return;
-        }
-        // Read before the pass: the base class clears the map on its way out.
-        const measured = this.getElement2BoundsData().size;
-        const { elapsedMs } = this.clock.measure(() => super.getBoundsFromDOM());
-        this.channel.trace(this.formatBoundsRequest(this.currentScope, measured, elapsedMs));
-    }
-    /** Format the per-request line. Override to change the wording. */
-    formatBoundsRequest(scope, measured, elapsedMs) {
-        return `bounds-request[${scope}] measured=${measured} getBBox=${elapsedMs.toFixed(0)}ms`;
-    }
-    postUpdate(cause) {
-        if (cause?.kind !== client_1.RequestBoundsAction.KIND) {
-            super.postUpdate(cause);
-            return;
-        }
-        this.currentScope = this.formatCause(cause);
-        try {
-            super.postUpdate(cause);
-        }
-        finally {
-            this.currentScope = undefined;
-        }
-    }
-    /**
-     * Scope facts for the log line: where the request came from, and which
-     * elements it asked for.
-     *
-     * Origin is read from {@link ServerAction}, the `__receivedFromServer` marker
-     * `GLSPModelSource` stamps on inbound actions, rather than from
-     * `LocalRequestBoundsAction.is`. The latter would answer the same today, but
-     * only incidentally: its `elementIDs` check is declared optional, so it is
-     * really just "a bounds request that did not come from the server". Keying on
-     * the marker states that directly, and keeps an *unscoped* local request from
-     * being mislabelled `server` if GLSP ever tightens that guard.
-     */
-    formatCause(cause) {
-        const origin = client_1.ServerAction.is(cause) ? 'server' : 'local';
-        const scope = this.formatScope(cause);
-        return scope ? `${origin} scope=${scope}` : origin;
-    }
-    /**
-     * Name the elements a scoped request asked for, or `undefined` when it covers
-     * the whole diagram.
-     *
-     * Deliberately the ids and not their count. A scoped request in practice names
-     * a single element, so a count is always `1` and says nothing, while the id
-     * says *which* element was re-measured — and it is the only part of the line
-     * that distinguishes one such request from the next. It also stops the line
-     * reading as a contradiction: `scope=node0, measured=6` is coherent (the base
-     * class expands a requested element to its descendants, so one id measures six
-     * DOM elements), where `scoped=1, measured=6` invites the reader to wonder
-     * which number is wrong.
-     *
-     * A request naming only the root is treated as unscoped: it measures
-     * everything, so the id adds nothing over the absence of a `scope` tag.
-     */
-    formatScope(cause) {
-        const scopedIds = cause.elementIDs;
-        if (!scopedIds || scopedIds.length === 0) {
-            return undefined;
-        }
-        const named = scopedIds.filter(id => id !== cause.newRoot?.id);
-        if (named.length === 0) {
-            return undefined;
-        }
-        if (named.length > SCOPE_ID_CAP) {
-            return `${named.slice(0, SCOPE_ID_CAP).join(',')},+${named.length - SCOPE_ID_CAP} more`;
-        }
-        return named.join(',');
-    }
-};
-exports.HydraniumHiddenBoundsUpdater = HydraniumHiddenBoundsUpdater;
-__decorate([
-    (0, inversify_1.inject)(browser_1.ChannelLogger),
-    __metadata("design:type", browser_1.ChannelLogger)
-], HydraniumHiddenBoundsUpdater.prototype, "channel", void 0);
-exports.HydraniumHiddenBoundsUpdater = HydraniumHiddenBoundsUpdater = __decorate([
-    (0, inversify_1.injectable)()
-], HydraniumHiddenBoundsUpdater);
-//# sourceMappingURL=hidden-bounds-updater.js.map

package/lib/browser/hidden-bounds-updater.js.map

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