@hydranium/glsp-server 1.0.0-next.10

package/lib/command/hydranium-glsp-recording-command.js

@@ -0,0 +1,159 @@
+/********************************************************************************
+ * Copyright (c) 2023-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 { JsonRecordingCommand } from '@eclipse-glsp/server';
+/**
+ * GLSP {@link JsonRecordingCommand} base shared by all hydranium adopters.
+ * Adds two things on top of GLSP's class:
+ *
+ *  1. A **time-labelled execute wrapper** so log lines record how long a
+ *     user-facing operation takes end-to-end — including the `postChange`
+ *     source-model update that re-parses the document. Otherwise the diff +
+ *     patch + persist work happens silently and is hard to attribute when
+ *     something is slow.
+ *  2. A typed `state` field that exposes `updateSourceModel` for the
+ *     `postChange` bridge AND the framework `logger` for time-labelled
+ *     logging. GLSP's base class only types `modelState: JsonModelState`,
+ *     which lacks the framework's logger surface.
+ *
+ * **Optional undo/redo bridge hooks.** An adopter command can supply
+ * `undoAction` / `redoAction` callbacks invoked alongside the patch apply, to
+ * re-emit a side-effect the patch itself does not carry. Provided as optional
+ * constructor args so adopters get that composition surface without
+ * subclassing. Operation handlers that don't need bridge callbacks omit them.
+ *
+ * **postChange semantics.** GLSP's `JsonRecordingCommand.postChange` calls
+ * `modelState.updateSourceModel(newModel)` with the model only. The
+ * framework lift overrides `postChange` so it also threads the based-on
+ * version captured at command start — letting the downstream
+ * `ModelService.update` opt into the `ConflictError` gate. Undo / redo
+ * postChange calls run with version `undefined` (no gating): the user
+ * authored against the recorded patch, not against a specific server
+ * version, so re-applying it should succeed regardless of intervening
+ * edits. The recorded patch itself encodes the semantic intent.
+ */
+export class HydraniumGlspRecordingCommand extends JsonRecordingCommand {
+    label;
+    undoAction;
+    redoAction;
+    /**
+     * Based-on version captured at {@link execute} start; threaded into
+     * {@link postChange} so {@link AbstractHydraniumGlspState.updateSourceModel}
+     * sees the version the user authored against. Cleared after `execute`
+     * returns so undo / redo paths fall through to `updateSourceModel`
+     * without a version (no gating).
+     */
+    activeVersion;
+    /**
+     * Source-model snapshots captured at {@link execute} — the state the
+     * command left ({@link afterSnapshot}) and the state it started from
+     * ({@link beforeSnapshot}). {@link undo} / {@link redo} reconcile the
+     * recorded transition against the *current* source model via the state's
+     * {@link AbstractHydraniumGlspState.conflictResolver}, so under the default
+     * reconciling policy a concurrent edit to another field survives and a
+     * same-field collision is dropped rather than clobbered.
+     */
+    beforeSnapshot;
+    afterSnapshot;
+    constructor(modelState, 
+    /** Human-readable label for the operation; appears in the timing-pair log line. */
+    label, doExecute, 
+    /** Optional bridge invoked alongside undo patch application; for adopters
+     *  that need to re-emit a side-effect the patch does not carry. */
+    undoAction, 
+    /** Optional bridge invoked alongside redo patch application. */
+    redoAction) {
+        super(modelState, doExecute);
+        this.label = label;
+        this.undoAction = undoAction;
+        this.redoAction = redoAction;
+    }
+    /**
+     * Time-label the full execute path: pre-state snapshot + `doExecute` +
+     * post-state snapshot + patch-derive + `postChange` (which writes back
+     * via {@link AbstractHydraniumGlspState.updateSourceModel}). The label combines
+     * the operation name with the source-uri-stamped logger.
+     *
+     * Captures {@link AbstractHydraniumGlspState.version} at start so {@link postChange}
+     * can thread the based-on version into `updateSourceModel`. The capture
+     * is `try`/`finally`-scoped so undo / redo paths invoked later do not
+     * see a stale captured version.
+     */
+    async execute() {
+        const logger = this.modelState.logger.for('HydraniumGlspRecordingCommand');
+        this.activeVersion = this.modelState.version;
+        logger.debug(`Executing '${this.label}' (based-on doc.version=v${this.activeVersion})`);
+        this.beforeSnapshot = this.deepClone(await this.getJsonObject());
+        try {
+            await this.modelState.tracer.for('HydraniumGlspRecordingCommand').time(`Execute command '${this.label}'`, () => super.execute());
+        }
+        finally {
+            this.activeVersion = undefined;
+        }
+        this.afterSnapshot = this.deepClone(await this.getJsonObject());
+    }
+    /**
+     * Override of GLSP's {@link JsonRecordingCommand.postChange} so the
+     * call to {@link AbstractHydraniumGlspState.updateSourceModel} threads the
+     * captured based-on version alongside the new model.
+     *
+     * During {@link execute} the version is the snapshot captured at
+     * command start; during {@link undo} / {@link redo} it is `undefined`
+     * — replaying a recorded patch does not author against a specific
+     * server version, so no gate applies.
+     */
+    postChange(newModel) {
+        return this.modelState.updateSourceModel(newModel, this.activeVersion);
+    }
+    /**
+     * Reconcile the recorded `after → before` transition against the
+     * *current* source model via the state's
+     * {@link AbstractHydraniumGlspState.conflictResolver}, invoke the optional adopter
+     * `undoAction`, and persist via `postChange`. Under the default reconciling
+     * policy the revert is replayed guarded by `test` ops, so a concurrent edit
+     * to another field is preserved (merged) and a same-field collision is
+     * dropped rather than clobbered; a force policy clobbers (last-writer-wins).
+     * On anything but a clean merge the undo is a logged no-op — the side-effect
+     * bridge and `postChange` only run on a merged result, preserving a
+     * "bridge before commit" order.
+     */
+    async undo() {
+        if (!this.undoPatch || this.beforeSnapshot === undefined || this.afterSnapshot === undefined) {
+            return;
+        }
+        const logger = this.modelState.logger.for('HydraniumGlspRecordingCommand');
+        logger.debug(`Undoing '${this.label}' at doc.version=v${this.modelState.version}`);
+        const outcome = await this.modelState.conflictResolver.resolve(this.afterSnapshot, this.beforeSnapshot, async () => this.getJsonObject());
+        if (outcome.status !== 'merged') {
+            logger.warn(`Undo '${this.label}' skipped (${outcome.status}); a foreign edit changed a shared field since the command ran`);
+            return;
+        }
+        await this.undoAction?.();
+        await this.postChange?.(outcome.merged);
+    }
+    /**
+     * Reconcile the recorded `before → after` transition against the current
+     * source model, invoke the optional adopter `redoAction`, and persist via
+     * `postChange`. Same guarded merge / drop semantics as {@link undo}.
+     */
+    async redo() {
+        if (!this.redoPatch || this.beforeSnapshot === undefined || this.afterSnapshot === undefined) {
+            return;
+        }
+        const logger = this.modelState.logger.for('HydraniumGlspRecordingCommand');
+        logger.debug(`Redoing '${this.label}' at doc.version=v${this.modelState.version}`);
+        const outcome = await this.modelState.conflictResolver.resolve(this.beforeSnapshot, this.afterSnapshot, async () => this.getJsonObject());
+        if (outcome.status !== 'merged') {
+            logger.warn(`Redo '${this.label}' skipped (${outcome.status}); a foreign edit changed a shared field since the undo`);
+            return;
+        }
+        await this.redoAction?.();
+        await this.postChange?.(outcome.merged);
+    }
+}
+//# sourceMappingURL=hydranium-glsp-recording-command.js.map

package/lib/command/hydranium-glsp-recording-command.js.map

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

package/lib/command/index.d.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export * from './hydranium-glsp-recording-command.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/command/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/command/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,uCAAuC,CAAC"}

package/lib/command/index.js

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export * from './hydranium-glsp-recording-command.js';
+//# sourceMappingURL=index.js.map

package/lib/command/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/command/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,uCAAuC,CAAC"}

package/lib/computed-bounds/hydranium-glsp-computed-bounds-action-handler.d.ts

@@ -0,0 +1,61 @@
+/********************************************************************************
+ * 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 ComputedBoundsAction, ComputedBoundsActionHandler, type GModelRoot, type MaybePromise } from '@eclipse-glsp/server';
+import { type AstNode } from '@hydranium/langium';
+import { type AbstractHydraniumGlspState } from '../state/abstract-hydranium-glsp-state.js';
+import { type HydraniumGlspSubmissionHandler } from '../submission/hydranium-glsp-submission-handler.js';
+/**
+ * GLSP {@link ComputedBoundsActionHandler} base shared by all hydranium
+ * adopters. Adds handshake-aware revision-mismatch logging on top of the
+ * upstream handler.
+ *
+ * **Why the lift.** GLSP's base silently returns `[]` on a revision
+ * mismatch — benign for stale post-drag bounds (the user moved an element,
+ * the server-side GModel got re-rendered before the client's pre-move
+ * `computedBounds` arrived; dropping the stale frame is correct). But
+ * catastrophic during the initial `requestModel → setModel` handshake: if the
+ * very first `computedBounds` arrives with a revision the server has already
+ * bumped, the subsequent `SetModelAction` response never fires and the diagram
+ * stays stuck at "model loading…". Adopters need this initial-handshake case
+ * surfaced as a warning so the failure mode is visible in logs.
+ *
+ * **Handshake detection** uses
+ * {@link HydraniumGlspSubmissionHandler.hasPendingInitialRequest} — true
+ * while a `RequestModelAction` has been accepted but the corresponding
+ * `SetModelAction` has not yet been dispatched. Adopters that override
+ * `submitModel` flow must preserve the `hasPendingInitialRequest` semantics
+ * for this logging to remain accurate.
+ *
+ * **Customisation.** The class is shipped non-abstract because the default
+ * body fits common adopters, which bind it directly. Adopters with
+ * bounds-specific cleanup subclass and override `applyBounds`.
+ */
+export declare class HydraniumGlspComputedBoundsActionHandler extends ComputedBoundsActionHandler {
+    protected readonly modelState: AbstractHydraniumGlspState<AstNode, unknown>;
+    protected readonly submissionHandler: HydraniumGlspSubmissionHandler<AstNode, unknown>;
+    execute(action: ComputedBoundsAction): MaybePromise<Action[]>;
+    /**
+     * Defensively filter routes that lack the source+target endpoints upstream
+     * `applyRoute` requires (`newRoutingPoints.length >= 2`). Without this,
+     * the upstream handler throws `GLSPServerError: Invalid Route!` and the
+     * entire `computedBounds` action is rejected — the diagram never settles.
+     *
+     * The race that produces these routes is benign and common on the
+     * initial layout pass: the GModel factory emits an edge with no explicit
+     * `routingPoints`, the client schedules the edge for routing but submits
+     * `computedBounds` before the routing pass finishes, so the route shows
+     * up with 0 or 1 point. Subsequent `computedBounds` actions carry the
+     * fully-routed edges; dropping the incomplete ones here is lossless.
+     *
+     * Adopters with bounds-specific cleanup — clearing ALL routes so the client
+     * re-routes on the next layout, say — override and replace this filter.
+     */
+    protected applyBounds(root: GModelRoot, action: ComputedBoundsAction): void;
+}
+//# sourceMappingURL=hydranium-glsp-computed-bounds-action-handler.d.ts.map

package/lib/computed-bounds/hydranium-glsp-computed-bounds-action-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydranium-glsp-computed-bounds-action-handler.d.ts","sourceRoot":"","sources":["../../src/computed-bounds/hydranium-glsp-computed-bounds-action-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,KAAK,MAAM,EACX,KAAK,oBAAoB,EACzB,2BAA2B,EAC3B,KAAK,UAAU,EACf,KAAK,YAAY,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,KAAK,8BAA8B,EAAE,MAAM,oDAAoD,CAAC;AAEzG;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBACa,wCAAyC,SAAQ,2BAA2B;IACtF,mBAA2B,UAAU,EAAE,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpF,mBAA2B,iBAAiB,EAAE,8BAA8B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAEtF,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;IAqBtE;;;;;;;;;;;;;;;OAeG;cACgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI;CAatF"}

package/lib/computed-bounds/hydranium-glsp-computed-bounds-action-handler.js

@@ -0,0 +1,93 @@
+/********************************************************************************
+ * 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;
+};
+import { ComputedBoundsActionHandler } from '@eclipse-glsp/server';
+import { injectable } from 'inversify';
+/**
+ * GLSP {@link ComputedBoundsActionHandler} base shared by all hydranium
+ * adopters. Adds handshake-aware revision-mismatch logging on top of the
+ * upstream handler.
+ *
+ * **Why the lift.** GLSP's base silently returns `[]` on a revision
+ * mismatch — benign for stale post-drag bounds (the user moved an element,
+ * the server-side GModel got re-rendered before the client's pre-move
+ * `computedBounds` arrived; dropping the stale frame is correct). But
+ * catastrophic during the initial `requestModel → setModel` handshake: if the
+ * very first `computedBounds` arrives with a revision the server has already
+ * bumped, the subsequent `SetModelAction` response never fires and the diagram
+ * stays stuck at "model loading…". Adopters need this initial-handshake case
+ * surfaced as a warning so the failure mode is visible in logs.
+ *
+ * **Handshake detection** uses
+ * {@link HydraniumGlspSubmissionHandler.hasPendingInitialRequest} — true
+ * while a `RequestModelAction` has been accepted but the corresponding
+ * `SetModelAction` has not yet been dispatched. Adopters that override
+ * `submitModel` flow must preserve the `hasPendingInitialRequest` semantics
+ * for this logging to remain accurate.
+ *
+ * **Customisation.** The class is shipped non-abstract because the default
+ * body fits common adopters, which bind it directly. Adopters with
+ * bounds-specific cleanup subclass and override `applyBounds`.
+ */
+let HydraniumGlspComputedBoundsActionHandler = class HydraniumGlspComputedBoundsActionHandler extends ComputedBoundsActionHandler {
+    execute(action) {
+        this.modelState.logger.debug(`ComputedBoundsActionHandler.execute entered: action.revision=${action.revision}`);
+        const model = this.modelState.root;
+        if (action.revision !== model.revision) {
+            if (this.submissionHandler.hasPendingInitialRequest()) {
+                this.modelState.logger.warn(`ComputedBounds rejected (initial handshake): action.revision=${action.revision} model.revision=${model.revision} — ` +
+                    'initial SetModelAction will not fire (empty diagram)');
+            }
+            else {
+                this.modelState.logger.debug(`ComputedBounds dropped (stale): action.revision=${action.revision} model.revision=${model.revision} — ` +
+                    'bounds belong to a superseded GModel; safe to ignore');
+            }
+            return [];
+        }
+        this.modelState.logger.trace(`ComputedBounds accepted: revision=${action.revision}, bounds=${action.bounds?.length ?? 0}`);
+        return super.execute(action);
+    }
+    /**
+     * Defensively filter routes that lack the source+target endpoints upstream
+     * `applyRoute` requires (`newRoutingPoints.length >= 2`). Without this,
+     * the upstream handler throws `GLSPServerError: Invalid Route!` and the
+     * entire `computedBounds` action is rejected — the diagram never settles.
+     *
+     * The race that produces these routes is benign and common on the
+     * initial layout pass: the GModel factory emits an edge with no explicit
+     * `routingPoints`, the client schedules the edge for routing but submits
+     * `computedBounds` before the routing pass finishes, so the route shows
+     * up with 0 or 1 point. Subsequent `computedBounds` actions carry the
+     * fully-routed edges; dropping the incomplete ones here is lossless.
+     *
+     * Adopters with bounds-specific cleanup — clearing ALL routes so the client
+     * re-routes on the next layout, say — override and replace this filter.
+     */
+    applyBounds(root, action) {
+        if (action.routes && action.routes.length > 0) {
+            const original = action.routes.length;
+            action.routes = action.routes.filter(route => (route.newRoutingPoints?.length ?? 0) >= 2);
+            const dropped = original - action.routes.length;
+            if (dropped > 0) {
+                this.modelState.logger.debug(`ComputedBounds dropped ${dropped}/${original} route(s) with <2 routing points — client hasn't finished routing yet`);
+            }
+        }
+        super.applyBounds(root, action);
+    }
+};
+HydraniumGlspComputedBoundsActionHandler = __decorate([
+    injectable()
+], HydraniumGlspComputedBoundsActionHandler);
+export { HydraniumGlspComputedBoundsActionHandler };
+//# sourceMappingURL=hydranium-glsp-computed-bounds-action-handler.js.map

package/lib/computed-bounds/hydranium-glsp-computed-bounds-action-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydranium-glsp-computed-bounds-action-handler.js","sourceRoot":"","sources":["../../src/computed-bounds/hydranium-glsp-computed-bounds-action-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;;;;;;;AAElF,OAAO,EAGJ,2BAA2B,EAG7B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAIvC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEI,IAAM,wCAAwC,GAA9C,MAAM,wCAAyC,SAAQ,2BAA2B;IAI7E,OAAO,CAAC,MAA4B;QAC1C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,gEAAgE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChH,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QACnC,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,EAAE,CAAC;gBACrD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CACxB,gEAAgE,MAAM,CAAC,QAAQ,mBAAmB,KAAK,CAAC,QAAQ,KAAK;oBAClH,sDAAsD,CAC3D,CAAC;YACL,CAAC;iBAAM,CAAC;gBACL,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CACzB,mDAAmD,MAAM,CAAC,QAAQ,mBAAmB,KAAK,CAAC,QAAQ,KAAK;oBACrG,sDAAsD,CAC3D,CAAC;YACL,CAAC;YACD,OAAO,EAAE,CAAC;QACb,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,MAAM,CAAC,QAAQ,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3H,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACgB,WAAW,CAAC,IAAgB,EAAE,MAA4B;QAC1E,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YACtC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1F,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YAChD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBACf,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CACzB,0BAA0B,OAAO,IAAI,QAAQ,uEAAuE,CACtH,CAAC;YACL,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;CACH,CAAA;AAtDY,wCAAwC;IADpD,UAAU,EAAE;GACA,wCAAwC,CAsDpD"}

package/lib/computed-bounds/index.d.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export * from './hydranium-glsp-computed-bounds-action-handler.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/computed-bounds/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/computed-bounds/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,oDAAoD,CAAC"}

package/lib/computed-bounds/index.js

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export * from './hydranium-glsp-computed-bounds-action-handler.js';
+//# sourceMappingURL=index.js.map

package/lib/computed-bounds/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/computed-bounds/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,oDAAoD,CAAC"}

package/lib/dispatcher/index.d.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export * from './server-action-dispatcher.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/dispatcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dispatcher/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,+BAA+B,CAAC"}

package/lib/dispatcher/index.js

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export * from './server-action-dispatcher.js';
+//# sourceMappingURL=index.js.map

package/lib/dispatcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dispatcher/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,+BAA+B,CAAC"}

package/lib/dispatcher/server-action-dispatcher.d.ts

@@ -0,0 +1,52 @@
+/********************************************************************************
+ * Copyright (c) 2023-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, DefaultActionDispatcher } from '@eclipse-glsp/server';
+import { type Tracer } from '@hydranium/protocol';
+import { type GlspClientLogger } from '../logging/glsp-client-logger.js';
+/**
+ * Server-side action dispatcher with built-in traffic observability:
+ * every {@link DefaultActionDispatcher.dispatch} call is wrapped in a
+ * {@link Tracer.time} pair that records the dispatch direction
+ * (`→ client` vs `→ server`) and timing.
+ *
+ * **Why this lives in the framework (vs left as an adopter override).**
+ * Debugging GLSP state, storage, and submission flows depends heavily on
+ * seeing each action with timing and direction — especially when bringing
+ * up a new adopter against an empty/partial diagram before its submission
+ * flow is complete. Providing this dispatcher in the framework gives every
+ * adopter the same observability primitive from the very first GLSP-head
+ * launch.
+ *
+ * **Extension points.**
+ * - {@link loggedKinds} — if set, filter the log lines (the dispatch
+ *   still happens; only the bracketed timing line is suppressed). Default
+ *   `undefined` means **every** action's dispatch is timed and logged.
+ * - {@link summarize} — return a non-empty string to append `[summary]`
+ *   to the log line; default returns `''` (no extra bracket).
+ *
+ * Adopters bind it in a per-diagram module, as the `ActionDispatcher` service.
+ */
+export declare class HydraniumGlspServerActionDispatcher extends DefaultActionDispatcher {
+    /** Narrowed from `Logger`; DI binds {@link GlspClientLogger}. */
+    protected readonly logger: GlspClientLogger;
+    /** Caller-tagged tracer (auto-componented with this class name, like the logger). */
+    protected readonly tracer: Tracer;
+    /**
+     * If set, the timing log line is emitted only when `action.kind` is in
+     * this set. Subclasses override via field reassignment.
+     */
+    protected readonly loggedKinds: ReadonlySet<string> | undefined;
+    /**
+     * Override to enrich the log line with payload-specific detail. Return an
+     * empty string to suppress the bracket. Default returns `''`.
+     */
+    protected summarize(_action: Action): string;
+    dispatch(action: Action): Promise<void>;
+}
+//# sourceMappingURL=server-action-dispatcher.d.ts.map

package/lib/dispatcher/server-action-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-action-dispatcher.d.ts","sourceRoot":"","sources":["../../src/dispatcher/server-action-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,MAAM,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE5E,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,mCAAoC,SAAQ,uBAAuB;IAC7E,iEAAiE;IACjE,mBAA2B,MAAM,EAAE,gBAAgB,CAAC;IAEpD,qFAAqF;IACtD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAG,MAAM,CAAC;IAElE;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAa;IAE5E;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAInC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWlD"}

package/lib/dispatcher/server-action-dispatcher.js

@@ -0,0 +1,79 @@
+/********************************************************************************
+ * Copyright (c) 2023-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);
+};
+import { DefaultActionDispatcher } from '@eclipse-glsp/server';
+import { inject, injectable } from 'inversify';
+import { HydraniumTypes } from '../state/hydranium-shared-core-services.js';
+/**
+ * Server-side action dispatcher with built-in traffic observability:
+ * every {@link DefaultActionDispatcher.dispatch} call is wrapped in a
+ * {@link Tracer.time} pair that records the dispatch direction
+ * (`→ client` vs `→ server`) and timing.
+ *
+ * **Why this lives in the framework (vs left as an adopter override).**
+ * Debugging GLSP state, storage, and submission flows depends heavily on
+ * seeing each action with timing and direction — especially when bringing
+ * up a new adopter against an empty/partial diagram before its submission
+ * flow is complete. Providing this dispatcher in the framework gives every
+ * adopter the same observability primitive from the very first GLSP-head
+ * launch.
+ *
+ * **Extension points.**
+ * - {@link loggedKinds} — if set, filter the log lines (the dispatch
+ *   still happens; only the bracketed timing line is suppressed). Default
+ *   `undefined` means **every** action's dispatch is timed and logged.
+ * - {@link summarize} — return a non-empty string to append `[summary]`
+ *   to the log line; default returns `''` (no extra bracket).
+ *
+ * Adopters bind it in a per-diagram module, as the `ActionDispatcher` service.
+ */
+let HydraniumGlspServerActionDispatcher = class HydraniumGlspServerActionDispatcher extends DefaultActionDispatcher {
+    /** Caller-tagged tracer (auto-componented with this class name, like the logger). */
+    tracer;
+    /**
+     * If set, the timing log line is emitted only when `action.kind` is in
+     * this set. Subclasses override via field reassignment.
+     */
+    loggedKinds = undefined;
+    /**
+     * Override to enrich the log line with payload-specific detail. Return an
+     * empty string to suppress the bracket. Default returns `''`.
+     */
+    summarize(_action) {
+        return '';
+    }
+    dispatch(action) {
+        if (this.loggedKinds && !this.loggedKinds.has(action.kind)) {
+            return super.dispatch(action);
+        }
+        const direction = this.clientActionForwarder.shouldForwardToClient(action) ? '→ client' : '→ server';
+        const summary = this.summarize(action);
+        const label = summary
+            ? `Dispatch action '${action.kind}' ${direction} [${summary}]`
+            : `Dispatch action '${action.kind}' ${direction}`;
+        return this.tracer.time(label, () => super.dispatch(action));
+    }
+};
+__decorate([
+    inject(HydraniumTypes.Tracer),
+    __metadata("design:type", Object)
+], HydraniumGlspServerActionDispatcher.prototype, "tracer", void 0);
+HydraniumGlspServerActionDispatcher = __decorate([
+    injectable()
+], HydraniumGlspServerActionDispatcher);
+export { HydraniumGlspServerActionDispatcher };
+//# sourceMappingURL=server-action-dispatcher.js.map

package/lib/dispatcher/server-action-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-action-dispatcher.js","sourceRoot":"","sources":["../../src/dispatcher/server-action-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;;;;;;;;;;AAElF,OAAO,EAAe,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEI,IAAM,mCAAmC,GAAzC,MAAM,mCAAoC,SAAQ,uBAAuB;IAI7E,qFAAqF;IACnC,MAAM,CAAU;IAElE;;;OAGG;IACgB,WAAW,GAAoC,SAAS,CAAC;IAE5E;;;OAGG;IACO,SAAS,CAAC,OAAe;QAChC,OAAO,EAAE,CAAC;IACb,CAAC;IAEQ,QAAQ,CAAC,MAAc;QAC7B,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1D,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QACrG,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO;YAClB,CAAC,CAAC,oBAAoB,MAAM,CAAC,IAAI,KAAK,SAAS,KAAK,OAAO,GAAG;YAC9D,CAAC,CAAC,oBAAoB,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,CAAC;CACH,CAAA;AA3BoD;IAAjD,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC;;mEAAoC;AALxD,mCAAmC;IAD/C,UAAU,EAAE;GACA,mCAAmC,CAgC/C"}

package/lib/index.d.ts

@@ -0,0 +1,19 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export * from './command/index.js';
+export * from './computed-bounds/index.js';
+export * from './dispatcher/index.js';
+export * from './launcher/index.js';
+export * from './logging/index.js';
+export * from './state/index.js';
+export * from './storage/index.js';
+export * from './submission/index.js';
+export * from './util/index.js';
+export * from './validation/index.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}

package/lib/index.js

@@ -0,0 +1,20 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+// Public API barrel for `@hydranium/glsp-server` — the GLSP protocol head.
+export * from './command/index.js';
+export * from './computed-bounds/index.js';
+export * from './dispatcher/index.js';
+export * from './launcher/index.js';
+export * from './logging/index.js';
+export * from './state/index.js';
+export * from './storage/index.js';
+export * from './submission/index.js';
+export * from './util/index.js';
+export * from './validation/index.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,2EAA2E;AAC3E,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}