@hydranium/glsp-server 1.0.0-next.31 → 1.0.0-next.315

package/lib/launcher/abstract-hydranium-glsp-diagram-module.d.ts

@@ -6,70 +6,46 @@
  *
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
-import { DiagramModule } from '@eclipse-glsp/server';
+import { type ActionDispatcher, type ActionHandlerConstructor, type BindingTarget, type ClientSessionInitializer, type CommandStack, DiagramModule, type InstanceMultiBinding, type MultiBinding } from '@eclipse-glsp/server';
 import { type interfaces } from 'inversify';
-import type { LanguageMetaData } from '@hydranium/langium';
+import { DiagramStatusReporter } from '../status/diagram-status-reporter.js';
 /**
- * Bind {@link HydraniumTypes}.DiagramLanguage on a GLSP **session** container
- * to the services of `metadata`'s grammar.
- *
- * Exported separately from {@link AbstractHydraniumGlspDiagramModule} for adopters
- * whose diagram module already extends an intermediate base of their own and
- * cannot take the framework base class; call it from `configure` after
- * `super.configure(...)`. The base class is the preferred entry point because
- * it makes the declaration non-optional.
- *
- * **Why the session tier.** GLSP builds its app container once per process,
- * before any document exists, so a per-language service bound there can only
- * ever be one grammar's. The session container is created per open diagram
- * with its `diagramType` known, and a diagram type has exactly one grammar —
- * so the language is a static fact about the module, resolvable with no URI
- * and no ordering hazard. That last part is load-bearing: GLSP's
- * `OperationHandlerRegistryInitializer` constructs every operation handler at
- * `InitializeClientSession`, i.e. BEFORE `RequestModelAction` supplies the
- * source URI, so anything derived from `ModelState.sourceUri` at injection
- * time would throw on every diagram open.
- *
- * **The whole language, not pre-resolved providers.** There is deliberately no
- * token for an individual per-language provider; see {@link HydraniumTypes} for
- * why. Callers reach `modelState.diagramLanguage` or
- * `modelState.languageServicesFor(node)` instead, which name the choice.
- *
- * Resolution is `toDynamicValue` + `inSingletonScope` — deferred so the parent
- * container's `SharedCoreServices` is available, then resolved once per
- * session rather than per injection.
- */
-export declare function bindDiagramLanguage(bind: interfaces.Bind, metadata: LanguageMetaData): void;
-/**
- * GLSP {@link DiagramModule} base that declares which grammar its diagram type
- * edits, and binds that language's per-language services on the session
- * container.
- *
- * Subclass instead of `DiagramModule` and implement {@link declareLanguage}
- * alongside `diagramType`; the two are the same kind of fact about a diagram
- * type, and pairing them is what lets one GLSP head serve N grammars.
- *
- * Adopter GLSP components then read the language they mean:
- * `modelState.diagramLanguage.references.CandidateProvider` for a reference
- * written on the canvas, `modelState.languageServicesFor(node).references.X`
- * for anything reached through a reference. No per-language service is bound
- * to a token of its own — see {@link bindDiagramLanguage} for why.
+ * GLSP {@link DiagramModule} base that wires the framework's diagram status,
+ * dispatch timing, command stack, save, and transactional operation, undo and
+ * redo handlers.
+ *
+ * A diagram module declares no grammar: a session's language is the one its
+ * loaded document routes to, so one diagram type can serve several grammars.
+ * Adopter GLSP components read `modelState.diagramLanguage` for a reference
+ * written on the canvas and `modelState.languageServicesFor(node)` for
+ * anything reached through a reference; see `HydraniumTypes` for why no
+ * per-language service has a token of its own.
+ *
+ * An adopter whose diagram module already extends a base of its own repeats
+ * what this class's overrides do. Without the status bindings among them,
+ * nothing tells the client why its diagram is read-only; without the operation
+ * and undo handlers, operation handlers edit the built root every reader
+ * shares.
  */
 export declare abstract class AbstractHydraniumGlspDiagramModule extends DiagramModule {
+    protected configure(bind: interfaces.Bind, unbind: interfaces.Unbind, isBound: interfaces.IsBound, rebind: interfaces.Rebind): void;
+    /** The {@link DiagramStatusReporter} of the session; {@link DefaultDiagramStatusReporter} by default. */
+    protected bindDiagramStatusReporter(): BindingTarget<DiagramStatusReporter>;
+    /** Starts the {@link DiagramStatusReporter} with the session, since nothing else injects it. */
+    configureClientSessionInitializers(binding: MultiBinding<ClientSessionInitializer>): void;
+    /** {@link HydraniumGlspServerActionDispatcher}, so every dispatch is timed once logging is at debug. */
+    protected bindActionDispatcher(): BindingTarget<ActionDispatcher>;
+    /** {@link HydraniumGlspCommandStack}, so the diagram is dirty exactly while a document it has open is. */
+    protected bindCommandStack(): BindingTarget<CommandStack>;
     /**
-     * The `LanguageMetaData` of the grammar this diagram type edits — pass the
-     * generated `<Grammar>LanguageMetaData` constant directly.
-     *
-     * Abstract rather than optional so a new diagram module cannot silently
-     * omit it: a missing declaration is a compile error here, where the fix is
-     * obvious, instead of an unbound-token failure at the first diagram open.
-     *
-     * NOT named `bindLanguage`: every `bindX()` on GLSP's `DiagramModule`
-     * returns a `BindingTarget<T>` that GLSP's own `configure` consumes, and a
-     * method in that family returning a `LanguageMetaData` invites
-     * `{ service: … }`. This one states a fact; the framework does the binding.
+     * Adds {@link HydraniumGlspRequestSaveModelActionHandler}, the save the
+     * Theia client sends, beside GLSP's own save handler; replaces the GLSP
+     * handlers that write the client's status or edit mode with ones that set a
+     * diagram status instead; and runs operations, undo and redo through
+     * {@link HydraniumGlspOperationActionHandler} and
+     * {@link HydraniumGlspUndoRedoActionHandler}, without which handlers edit
+     * the built root every reader shares.
      */
-    protected abstract declareLanguage(): LanguageMetaData;
-    protected configure(bind: interfaces.Bind, unbind: interfaces.Unbind, isBound: interfaces.IsBound, rebind: interfaces.Rebind): void;
+    protected configureActionHandlers(binding: InstanceMultiBinding<ActionHandlerConstructor>): void;
 }
 //# sourceMappingURL=abstract-hydranium-glsp-diagram-module.d.ts.map

package/lib/launcher/abstract-hydranium-glsp-diagram-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abstract-hydranium-glsp-diagram-module.d.ts","sourceRoot":"","sources":["../../src/launcher/abstract-hydranium-glsp-diagram-module.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAI3F;AA0BD;;;;;;;;;;;;;;GAcG;AACH,8BACsB,kCAAmC,SAAQ,aAAa;IAC3E;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,IAAI,gBAAgB;cAEnC,SAAS,CACzB,IAAI,EAAE,UAAU,CAAC,IAAI,EACrB,MAAM,EAAE,UAAU,CAAC,MAAM,EACzB,OAAO,EAAE,UAAU,CAAC,OAAO,EAC3B,MAAM,EAAE,UAAU,CAAC,MAAM,GACzB,IAAI;CAIT"}
+{"version":3,"file":"abstract-hydranium-glsp-diagram-module.d.ts","sourceRoot":"","sources":["../../src/launcher/abstract-hydranium-glsp-diagram-module.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAE7B,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EACjB,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAKnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAMxD,OAAO,EAAgC,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAI3G;;;;;;;;;;;;;;;;;GAiBG;AACH,8BACsB,kCAAmC,SAAQ,aAAa;IAC3E,UAAmB,SAAS,CACzB,IAAI,EAAE,UAAU,CAAC,IAAI,EACrB,MAAM,EAAE,UAAU,CAAC,MAAM,EACzB,OAAO,EAAE,UAAU,CAAC,OAAO,EAC3B,MAAM,EAAE,UAAU,CAAC,MAAM,GACzB,IAAI,CAKN;IAED,yGAAyG;IACzG,SAAS,CAAC,yBAAyB,IAAI,aAAa,CAAC,qBAAqB,CAAC,CAE1E;IAED,gGAAgG;IACvF,kCAAkC,CAAC,OAAO,EAAE,YAAY,CAAC,wBAAwB,CAAC,GAAG,IAAI,CAGjG;IAED,wGAAwG;IACxG,UAAmB,oBAAoB,IAAI,aAAa,CAAC,gBAAgB,CAAC,CAEzE;IAED,0GAA0G;IAC1G,UAAmB,gBAAgB,IAAI,aAAa,CAAC,YAAY,CAAC,CAEjE;IAED;;;;;;;;OAQG;IACH,UAAmB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,CAAC,wBAAwB,CAAC,GAAG,IAAI,CAOxG;CACH"}

package/lib/launcher/abstract-hydranium-glsp-diagram-module.js

@@ -12,85 +12,74 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     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 { DiagramModule } from '@eclipse-glsp/server';
+import { applyBindingTarget, DiagramModule, OperationActionHandler, RequestModelActionHandler, SetEditModeActionHandler, UndoRedoActionHandler } from '@eclipse-glsp/server';
 import { injectable } from 'inversify';
-import { typedMetadata } from '@hydranium/core';
-import { HydraniumTypes } from '../state/hydranium-shared-core-services.js';
+import { HydraniumGlspServerActionDispatcher } from '../dispatcher/server-action-dispatcher.js';
+import { HydraniumGlspRequestSaveModelActionHandler } from '../storage/hydranium-glsp-request-save-model-action-handler.js';
+import { HydraniumGlspCommandStack } from '../command/hydranium-glsp-command-stack.js';
+import { HydraniumGlspOperationActionHandler } from '../command/hydranium-glsp-operation-action-handler.js';
+import { HydraniumGlspUndoRedoActionHandler } from '../command/hydranium-glsp-undo-redo-action-handler.js';
+import { DefaultDiagramStatusReporter, DiagramStatusReporter } from '../status/diagram-status-reporter.js';
+import { HydraniumGlspRequestModelActionHandler } from '../status/hydranium-glsp-request-model-action-handler.js';
+import { HydraniumGlspSetEditModeActionHandler } from '../status/hydranium-glsp-set-edit-mode-action-handler.js';
 /**
- * Bind {@link HydraniumTypes}.DiagramLanguage on a GLSP **session** container
- * to the services of `metadata`'s grammar.
+ * GLSP {@link DiagramModule} base that wires the framework's diagram status,
+ * dispatch timing, command stack, save, and transactional operation, undo and
+ * redo handlers.
  *
- * Exported separately from {@link AbstractHydraniumGlspDiagramModule} for adopters
- * whose diagram module already extends an intermediate base of their own and
- * cannot take the framework base class; call it from `configure` after
- * `super.configure(...)`. The base class is the preferred entry point because
- * it makes the declaration non-optional.
+ * A diagram module declares no grammar: a session's language is the one its
+ * loaded document routes to, so one diagram type can serve several grammars.
+ * Adopter GLSP components read `modelState.diagramLanguage` for a reference
+ * written on the canvas and `modelState.languageServicesFor(node)` for
+ * anything reached through a reference; see `HydraniumTypes` for why no
+ * per-language service has a token of its own.
  *
- * **Why the session tier.** GLSP builds its app container once per process,
- * before any document exists, so a per-language service bound there can only
- * ever be one grammar's. The session container is created per open diagram
- * with its `diagramType` known, and a diagram type has exactly one grammar —
- * so the language is a static fact about the module, resolvable with no URI
- * and no ordering hazard. That last part is load-bearing: GLSP's
- * `OperationHandlerRegistryInitializer` constructs every operation handler at
- * `InitializeClientSession`, i.e. BEFORE `RequestModelAction` supplies the
- * source URI, so anything derived from `ModelState.sourceUri` at injection
- * time would throw on every diagram open.
- *
- * **The whole language, not pre-resolved providers.** There is deliberately no
- * token for an individual per-language provider; see {@link HydraniumTypes} for
- * why. Callers reach `modelState.diagramLanguage` or
- * `modelState.languageServicesFor(node)` instead, which name the choice.
- *
- * Resolution is `toDynamicValue` + `inSingletonScope` — deferred so the parent
- * container's `SharedCoreServices` is available, then resolved once per
- * session rather than per injection.
- */
-export function bindDiagramLanguage(bind, metadata) {
-    bind(HydraniumTypes.DiagramLanguage)
-        .toDynamicValue(context => resolveDiagramLanguage(context.container, metadata))
-        .inSingletonScope();
-}
-/**
- * The registered services for `metadata`'s language, or a throw naming both
- * the declared id and the registered ones.
- *
- * Failing loudly is the point: the declared language is the one fact this
- * module states that the grammar does not, so it can drift. An unregistered id
- * means the adopter declared a language they never registered — a wiring
- * mistake whose silent form (falling back to some other grammar's providers)
- * would surface much later as references that resolve against the wrong scope.
- */
-function resolveDiagramLanguage(container, metadata) {
-    const registry = container.get(HydraniumTypes.SharedCoreServices).ServiceRegistry;
-    const language = registry.getServices(typedMetadata(metadata));
-    if (!language) {
-        const registered = registry.all.map(candidate => candidate.LanguageMetaData.languageId);
-        throw new Error(`Diagram module declares language '${metadata.languageId}', which is not registered on the ServiceRegistry. ` +
-            `Registered languages: ${registered.length > 0 ? registered.join(', ') : '(none)'}. ` +
-            'Declare the languageId of a grammar passed to bootstrapLangiumLanguages.');
-    }
-    return language;
-}
-/**
- * GLSP {@link DiagramModule} base that declares which grammar its diagram type
- * edits, and binds that language's per-language services on the session
- * container.
- *
- * Subclass instead of `DiagramModule` and implement {@link declareLanguage}
- * alongside `diagramType`; the two are the same kind of fact about a diagram
- * type, and pairing them is what lets one GLSP head serve N grammars.
- *
- * Adopter GLSP components then read the language they mean:
- * `modelState.diagramLanguage.references.CandidateProvider` for a reference
- * written on the canvas, `modelState.languageServicesFor(node).references.X`
- * for anything reached through a reference. No per-language service is bound
- * to a token of its own — see {@link bindDiagramLanguage} for why.
+ * An adopter whose diagram module already extends a base of its own repeats
+ * what this class's overrides do. Without the status bindings among them,
+ * nothing tells the client why its diagram is read-only; without the operation
+ * and undo handlers, operation handlers edit the built root every reader
+ * shares.
  */
 let AbstractHydraniumGlspDiagramModule = class AbstractHydraniumGlspDiagramModule extends DiagramModule {
     configure(bind, unbind, isBound, rebind) {
+        // Bound first: `super.configure` applies the session initializers, and the
+        // reporter's initializer entry refers to this binding.
+        applyBindingTarget({ bind, isBound }, DiagramStatusReporter, this.bindDiagramStatusReporter()).inSingletonScope();
         super.configure(bind, unbind, isBound, rebind);
-        bindDiagramLanguage(bind, this.declareLanguage());
+    }
+    /** The {@link DiagramStatusReporter} of the session; {@link DefaultDiagramStatusReporter} by default. */
+    bindDiagramStatusReporter() {
+        return DefaultDiagramStatusReporter;
+    }
+    /** Starts the {@link DiagramStatusReporter} with the session, since nothing else injects it. */
+    configureClientSessionInitializers(binding) {
+        super.configureClientSessionInitializers(binding);
+        binding.add({ service: DiagramStatusReporter });
+    }
+    /** {@link HydraniumGlspServerActionDispatcher}, so every dispatch is timed once logging is at debug. */
+    bindActionDispatcher() {
+        return HydraniumGlspServerActionDispatcher;
+    }
+    /** {@link HydraniumGlspCommandStack}, so the diagram is dirty exactly while a document it has open is. */
+    bindCommandStack() {
+        return HydraniumGlspCommandStack;
+    }
+    /**
+     * Adds {@link HydraniumGlspRequestSaveModelActionHandler}, the save the
+     * Theia client sends, beside GLSP's own save handler; replaces the GLSP
+     * handlers that write the client's status or edit mode with ones that set a
+     * diagram status instead; and runs operations, undo and redo through
+     * {@link HydraniumGlspOperationActionHandler} and
+     * {@link HydraniumGlspUndoRedoActionHandler}, without which handlers edit
+     * the built root every reader shares.
+     */
+    configureActionHandlers(binding) {
+        super.configureActionHandlers(binding);
+        binding.add(HydraniumGlspRequestSaveModelActionHandler);
+        binding.rebind(RequestModelActionHandler, HydraniumGlspRequestModelActionHandler);
+        binding.rebind(SetEditModeActionHandler, HydraniumGlspSetEditModeActionHandler);
+        binding.rebind(OperationActionHandler, HydraniumGlspOperationActionHandler);
+        binding.rebind(UndoRedoActionHandler, HydraniumGlspUndoRedoActionHandler);
     }
 };
 AbstractHydraniumGlspDiagramModule = __decorate([

package/lib/launcher/abstract-hydranium-glsp-diagram-module.js.map

@@ -1 +1 @@
-{"version":3,"file":"abstract-hydranium-glsp-diagram-module.js","sourceRoot":"","sources":["../../src/launcher/abstract-hydranium-glsp-diagram-module.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;;;;;;;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAmB,MAAM,WAAW,CAAC;AAExD,OAAO,EAA0D,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACxG,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAqB,EAAE,QAA0B;IAClF,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC;SAChC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;SAC9E,gBAAgB,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,sBAAsB,CAAC,SAA+B,EAAE,QAA0B;IACxF,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAuB,cAAc,CAAC,kBAAkB,CAAC,CAAC,eAAe,CAAC;IACxG,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,aAAa,CAAyB,QAAQ,CAAC,CAAC,CAAC;IACvF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACxF,MAAM,IAAI,KAAK,CACZ,qCAAqC,QAAQ,CAAC,UAAU,qDAAqD;YAC1G,yBAAyB,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI;YACrF,0EAA0E,CAC/E,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AAEI,IAAe,kCAAkC,GAAjD,MAAe,kCAAmC,SAAQ,aAAa;IAgBxD,SAAS,CACzB,IAAqB,EACrB,MAAyB,EACzB,OAA2B,EAC3B,MAAyB;QAEzB,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/C,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;IACrD,CAAC;CACH,CAAA;AAzBqB,kCAAkC;IADvD,UAAU,EAAE;GACS,kCAAkC,CAyBvD"}
+{"version":3,"file":"abstract-hydranium-glsp-diagram-module.js","sourceRoot":"","sources":["../../src/launcher/abstract-hydranium-glsp-diagram-module.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;;;;;;;AAElF,OAAO,EAGJ,kBAAkB,EAIlB,aAAa,EAGb,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,EACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAmB,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,mCAAmC,EAAE,MAAM,2CAA2C,CAAC;AAChG,OAAO,EAAE,0CAA0C,EAAE,MAAM,gEAAgE,CAAC;AAC5H,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AACvF,OAAO,EAAE,mCAAmC,EAAE,MAAM,uDAAuD,CAAC;AAC5G,OAAO,EAAE,kCAAkC,EAAE,MAAM,uDAAuD,CAAC;AAC3G,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC3G,OAAO,EAAE,sCAAsC,EAAE,MAAM,0DAA0D,CAAC;AAClH,OAAO,EAAE,qCAAqC,EAAE,MAAM,0DAA0D,CAAC;AAEjH;;;;;;;;;;;;;;;;;GAiBG;AAEI,IAAe,kCAAkC,GAAjD,MAAe,kCAAmC,SAAQ,aAAa;IACxD,SAAS,CACzB,IAAqB,EACrB,MAAyB,EACzB,OAA2B,EAC3B,MAAyB;QAEzB,2EAA2E;QAC3E,uDAAuD;QACvD,kBAAkB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,qBAAqB,EAAE,IAAI,CAAC,yBAAyB,EAAE,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAClH,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,yGAAyG;IAC/F,yBAAyB;QAChC,OAAO,4BAA4B,CAAC;IACvC,CAAC;IAED,gGAAgG;IACvF,kCAAkC,CAAC,OAA+C;QACxF,KAAK,CAAC,kCAAkC,CAAC,OAAO,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,wGAAwG;IACrF,oBAAoB;QACpC,OAAO,mCAAmC,CAAC;IAC9C,CAAC;IAED,0GAA0G;IACvF,gBAAgB;QAChC,OAAO,yBAAyB,CAAC;IACpC,CAAC;IAED;;;;;;;;OAQG;IACgB,uBAAuB,CAAC,OAAuD;QAC/F,KAAK,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACxD,OAAO,CAAC,MAAM,CAAC,yBAAyB,EAAE,sCAAsC,CAAC,CAAC;QAClF,OAAO,CAAC,MAAM,CAAC,wBAAwB,EAAE,qCAAqC,CAAC,CAAC;QAChF,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,mCAAmC,CAAC,CAAC;QAC5E,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,kCAAkC,CAAC,CAAC;IAC7E,CAAC;CACH,CAAA;AAnDqB,kCAAkC;IADvD,UAAU,EAAE;GACS,kCAAkC,CAmDvD"}

package/lib/launcher/drop-notifications-to-gone-client.d.ts

@@ -0,0 +1,23 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 { Logger as GlspLogger } from '@eclipse-glsp/server';
+/**
+ * `connection` with a notification to a client that has gone dropped, logged
+ * at debug, rather than left to throw or reject. GLSP sends every action as a
+ * notification and drops the promise, so a client that disconnects mid-write
+ * (an `EPIPE`) or a send after GLSP disposed the connection is otherwise an
+ * unhandled rejection on every ordinary close. Any other failure still throws
+ * or rejects: {@link isClientGoneError} tells the two apart, as on the
+ * LSP head. A launcher that overrides `createConnection` applies it, as the
+ * framework's own do.
+ */
+export declare function dropNotificationsToGoneClient<T extends {
+    sendNotification(method: string, ...params: unknown[]): Promise<void>;
+}>(connection: T, logger: GlspLogger): T;
+//# sourceMappingURL=drop-notifications-to-gone-client.d.ts.map

package/lib/launcher/drop-notifications-to-gone-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-notifications-to-gone-client.d.ts","sourceRoot":"","sources":["../../src/launcher/drop-notifications-to-gone-client.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGjE;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,SAAS;IAAE,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,EAC9H,UAAU,EAAE,CAAC,EACb,MAAM,EAAE,UAAU,GAClB,CAAC,CAqBH"}

package/lib/launcher/drop-notifications-to-gone-client.js

@@ -0,0 +1,43 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 { isClientGoneError } from '@hydranium/core';
+/**
+ * `connection` with a notification to a client that has gone dropped, logged
+ * at debug, rather than left to throw or reject. GLSP sends every action as a
+ * notification and drops the promise, so a client that disconnects mid-write
+ * (an `EPIPE`) or a send after GLSP disposed the connection is otherwise an
+ * unhandled rejection on every ordinary close. Any other failure still throws
+ * or rejects: {@link isClientGoneError} tells the two apart, as on the
+ * LSP head. A launcher that overrides `createConnection` applies it, as the
+ * framework's own do.
+ */
+export function dropNotificationsToGoneClient(connection, logger) {
+    const dropIfGone = (error) => {
+        if (!isClientGoneError(error)) {
+            throw error;
+        }
+        logger.debug(`Dropped a notification to a client that has gone: ${String(error)}`);
+    };
+    const sendNotification = (method, ...params) => {
+        try {
+            return connection.sendNotification(method, ...params).catch(dropIfGone);
+        }
+        catch (error) {
+            // A disposed connection throws rather than rejecting.
+            dropIfGone(error);
+            return Promise.resolve();
+        }
+    };
+    return new Proxy(connection, {
+        get(target, property, receiver) {
+            return property === 'sendNotification' ? sendNotification : Reflect.get(target, property, receiver);
+        }
+    });
+}
+//# sourceMappingURL=drop-notifications-to-gone-client.js.map

package/lib/launcher/drop-notifications-to-gone-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-notifications-to-gone-client.js","sourceRoot":"","sources":["../../src/launcher/drop-notifications-to-gone-client.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAC1C,UAAa,EACb,MAAkB;IAElB,MAAM,UAAU,GAAG,CAAC,KAAc,EAAQ,EAAE;QACzC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,KAAK,CAAC;QACf,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,qDAAqD,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC,CAAC;IACF,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAE,GAAG,MAAiB,EAAiB,EAAE;QAC9E,IAAI,CAAC;YACF,OAAO,UAAU,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACvB,sDAAsD;YACtD,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC5B,CAAC;IACJ,CAAC,CAAC;IACF,OAAO,IAAI,KAAK,CAAC,UAAU,EAAE;QAC1B,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ;YAC3B,OAAO,QAAQ,KAAK,kBAAkB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACvG,CAAC;KACH,CAAC,CAAC;AACN,CAAC"}

package/lib/launcher/glsp-app-module.d.ts

@@ -6,8 +6,7 @@
  *
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
-import { GLSPModule } from '@eclipse-glsp/server';
-import type { BindingContext } from '@eclipse-glsp/protocol/lib/di/inversify-util.js';
+import { type BindingContext, GLSPModule } from '@eclipse-glsp/server';
 import type { ServerSharedServices } from '@hydranium/core';
 import { type ConflictResolver } from '@hydranium/protocol';
 import { type interfaces } from 'inversify';

package/lib/launcher/glsp-app-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glsp-app-module.d.ts","sourceRoot":"","sources":["../../src/launcher/glsp-app-module.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,KAAK,gBAAgB,EAA+B,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAGxD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,6BAA6B,CAAC,OAAO,SAAS,oBAAoB,GAAG,oBAAoB;IACvG;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB;;;;;;;;OAQG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBACa,sBAAsB,CAAC,OAAO,SAAS,oBAAoB,GAAG,oBAAoB,CAAE,SAAQ,UAAU;IACpG,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,6BAA6B,CAAC,OAAO,CAAC;gBAA/C,OAAO,EAAE,6BAA6B,CAAC,OAAO,CAAC;cAI3D,SAAS,CACzB,IAAI,EAAE,UAAU,CAAC,IAAI,EACrB,MAAM,EAAE,UAAU,CAAC,MAAM,EACzB,OAAO,EAAE,UAAU,CAAC,OAAO,EAC3B,MAAM,EAAE,UAAU,CAAC,MAAM,GACzB,IAAI;IAMP;;;;OAIG;IACH,SAAS,CAAC,2BAA2B,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;CAGvE"}
+{"version":3,"file":"glsp-app-module.d.ts","sourceRoot":"","sources":["../../src/launcher/glsp-app-module.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,KAAK,gBAAgB,EAA+B,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAGxD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,6BAA6B,CAAC,OAAO,SAAS,oBAAoB,GAAG,oBAAoB;IACvG;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB;;;;;;;;OAQG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBACa,sBAAsB,CAAC,OAAO,SAAS,oBAAoB,GAAG,oBAAoB,CAAE,SAAQ,UAAU;IACpG,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,6BAA6B,CAAC,OAAO,CAAC;IAA9E,YAA+B,OAAO,EAAE,6BAA6B,CAAC,OAAO,CAAC,EAE7E;IAED,UAAmB,SAAS,CACzB,IAAI,EAAE,UAAU,CAAC,IAAI,EACrB,MAAM,EAAE,UAAU,CAAC,MAAM,EACzB,OAAO,EAAE,UAAU,CAAC,OAAO,EAC3B,MAAM,EAAE,UAAU,CAAC,MAAM,GACzB,IAAI,CAIN;IAED;;;;OAIG;IACH,SAAS,CAAC,2BAA2B,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAEpE;CACH"}

package/lib/launcher/glsp-app-module.js.map

@@ -1 +1 @@
-{"version":3,"file":"glsp-app-module.js","sourceRoot":"","sources":["../../src/launcher/glsp-app-module.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;;;;;;;;;;AAElF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,OAAO,EAAyB,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,UAAU,EAAmB,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AA0C5E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAoF,SAAQ,UAAU;IACjF;IAA/B,YAA+B,OAA+C;QAC3E,KAAK,EAAE,CAAC;QADoB,YAAO,GAAP,OAAO,CAAwC;IAE9E,CAAC;IAEkB,SAAS,CACzB,IAAqB,EACrB,MAAyB,EACzB,OAA2B,EAC3B,MAAyB;QAEzB,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7E,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,IAAI,2BAA2B,EAAE,CAAC,CAAC;QAC1H,IAAI,CAAC,2BAA2B,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;OAIG;IACO,2BAA2B,CAAC,QAAwB;QAC3D,mBAAmB;IACtB,CAAC;CACH,CAAA;AAxBY,sBAAsB;IADlC,UAAU,EAAE;;GACA,sBAAsB,CAwBlC"}
+{"version":3,"file":"glsp-app-module.js","sourceRoot":"","sources":["../../src/launcher/glsp-app-module.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;;;;;;;;;;AAElF,OAAO,EAAuB,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvE,OAAO,EAAyB,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,UAAU,EAAmB,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AA0C5E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAoF,SAAQ,UAAU;IACjF,OAAO;IAAtC,YAA+B,OAA+C;QAC3E,KAAK,EAAE,CAAC;uBADoB,OAAO;IAEtC,CAAC;IAEkB,SAAS,CACzB,IAAqB,EACrB,MAAyB,EACzB,OAA2B,EAC3B,MAAyB;QAEzB,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7E,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,IAAI,2BAA2B,EAAE,CAAC,CAAC;QAC1H,IAAI,CAAC,2BAA2B,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;OAIG;IACO,2BAA2B,CAAC,QAAwB;QAC3D,mBAAmB;IACtB,CAAC;CACH,CAAA;AAxBY,sBAAsB;IADlC,UAAU,EAAE;;GACA,sBAAsB,CAwBlC"}

package/lib/launcher/glsp-connection-logger.d.ts

@@ -0,0 +1,19 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 { Logger as GlspLogger } from '@eclipse-glsp/server';
+import type { Logger as ConnectionLogger } from 'vscode-jsonrpc';
+/**
+ * A GLSP logger in the shape a `vscode-jsonrpc` connection logs to. A launcher
+ * that overrides `createConnection` passes it over its injected `logger`, or
+ * the connection logs to `console` or nowhere instead of the adopter's logger.
+ * GLSP's logger has no `log`; the connection's `log` lines go to `info`, the
+ * threshold the framework's own `Logger.log` emits at.
+ */
+export declare function createGlspConnectionLogger(logger: GlspLogger): ConnectionLogger;
+//# sourceMappingURL=glsp-connection-logger.d.ts.map

package/lib/launcher/glsp-connection-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-connection-logger.d.ts","sourceRoot":"","sources":["../../src/launcher/glsp-connection-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEjE;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,CAO/E"}

package/lib/launcher/glsp-connection-logger.js

@@ -0,0 +1,24 @@
+/********************************************************************************
+ * Copyright (c) 2026 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
+ ********************************************************************************/
+/**
+ * A GLSP logger in the shape a `vscode-jsonrpc` connection logs to. A launcher
+ * that overrides `createConnection` passes it over its injected `logger`, or
+ * the connection logs to `console` or nowhere instead of the adopter's logger.
+ * GLSP's logger has no `log`; the connection's `log` lines go to `info`, the
+ * threshold the framework's own `Logger.log` emits at.
+ */
+export function createGlspConnectionLogger(logger) {
+    return {
+        error: message => logger.error(message),
+        warn: message => logger.warn(message),
+        info: message => logger.info(message),
+        log: message => logger.info(message)
+    };
+}
+//# sourceMappingURL=glsp-connection-logger.js.map

package/lib/launcher/glsp-connection-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glsp-connection-logger.js","sourceRoot":"","sources":["../../src/launcher/glsp-connection-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAKlF;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAkB;IAC1D,OAAO;QACJ,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QACvC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QACrC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QACrC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;KACtC,CAAC;AACL,CAAC"}

package/lib/launcher/glsp-server-overrides.d.ts

@@ -14,15 +14,17 @@ import { ContainerModule } from 'inversify';
  *
  * **The tier matters, and the app container cannot stand in for it.** GLSP's
  * launcher creates the server container as a child and loads the adopter's
- * `ServerModule` into it, so a `GLSPServer` binding made further up is shadowed
- * rather than consulted, and inversify refuses to rebind a parent's binding
- * from a child at all. The framework's app-tier overrides therefore cannot
- * reach this symbol.
+ * `ServerModule` into it. The framework's server is a singleton of that
+ * container; bound in the app container, every connected application would
+ * share one server.
  *
- * **Load this AFTER the adopter's `ServerModule`, never beside it.** Both bind
- * `GLSPServer`, so a plain second binding resolves to an ambiguous-match error
- * rather than to either one; `rebind` needs the first binding to already be
- * present.
+ * **An adopter's server is kept when it extends {@link HydraniumGlspServer}.**
+ * Any other `GLSPServer` the adopter's `ServerModule` binds, upstream's default
+ * included, is replaced when the container first creates it, so a server that
+ * extends upstream's directly is discarded, with a warning naming its class.
+ * The replacement happens on activation because `rebind` would replace an
+ * adopter's subclass as well; the discarded server is constructed once and
+ * never used.
  *
  * Keeping this out of the adopter's hands is the point: an adopter passes their
  * own `ServerModule` in, so anything they must add themselves is a fix the

package/lib/launcher/glsp-server-overrides.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glsp-server-overrides.d.ts","sourceRoot":"","sources":["../../src/launcher/glsp-server-overrides.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,yBAAyB,IAAI,eAAe,CAI3D"}
+{"version":3,"file":"glsp-server-overrides.d.ts","sourceRoot":"","sources":["../../src/launcher/glsp-server-overrides.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,yBAAyB,IAAI,eAAe,CAkB3D"}

package/lib/launcher/glsp-server-overrides.js

@@ -6,7 +6,7 @@
  *
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
-import { GLSPServer } from '@eclipse-glsp/server';
+import { DefaultGLSPServer, GLSPServer, LoggerFactory } from '@eclipse-glsp/server';
 import { ContainerModule } from 'inversify';
 import { HydraniumGlspServer } from './hydranium-glsp-server.js';
 /**
@@ -16,15 +16,17 @@ import { HydraniumGlspServer } from './hydranium-glsp-server.js';
  *
  * **The tier matters, and the app container cannot stand in for it.** GLSP's
  * launcher creates the server container as a child and loads the adopter's
- * `ServerModule` into it, so a `GLSPServer` binding made further up is shadowed
- * rather than consulted, and inversify refuses to rebind a parent's binding
- * from a child at all. The framework's app-tier overrides therefore cannot
- * reach this symbol.
+ * `ServerModule` into it. The framework's server is a singleton of that
+ * container; bound in the app container, every connected application would
+ * share one server.
  *
- * **Load this AFTER the adopter's `ServerModule`, never beside it.** Both bind
- * `GLSPServer`, so a plain second binding resolves to an ambiguous-match error
- * rather than to either one; `rebind` needs the first binding to already be
- * present.
+ * **An adopter's server is kept when it extends {@link HydraniumGlspServer}.**
+ * Any other `GLSPServer` the adopter's `ServerModule` binds, upstream's default
+ * included, is replaced when the container first creates it, so a server that
+ * extends upstream's directly is discarded, with a warning naming its class.
+ * The replacement happens on activation because `rebind` would replace an
+ * adopter's subclass as well; the discarded server is constructed once and
+ * never used.
  *
  * Keeping this out of the adopter's hands is the point: an adopter passes their
  * own `ServerModule` in, so anything they must add themselves is a fix the
@@ -38,8 +40,20 @@ import { HydraniumGlspServer } from './hydranium-glsp-server.js';
  * a further adopter subclass moves it again.
  */
 export function createGlspServerOverrides() {
-    return new ContainerModule((_bind, _unbind, _isBound, rebind) => {
-        rebind(GLSPServer).to(HydraniumGlspServer).inSingletonScope();
+    return new ContainerModule((bind, _unbind, _isBound, _rebind, _unbindAsync, onActivation) => {
+        bind(HydraniumGlspServer).toSelf().inSingletonScope();
+        onActivation(GLSPServer, (context, server) => {
+            if (server instanceof HydraniumGlspServer) {
+                return server;
+            }
+            if (server.constructor !== DefaultGLSPServer) {
+                context.container
+                    .get(LoggerFactory)('HydraniumGlspServer')
+                    .warn(`Replacing the bound GLSP server ${server.constructor.name} with HydraniumGlspServer; ` +
+                    'extend HydraniumGlspServer to keep its behaviour.');
+            }
+            return context.container.get(HydraniumGlspServer);
+        });
     });
 }
 //# sourceMappingURL=glsp-server-overrides.js.map

package/lib/launcher/glsp-server-overrides.js.map

@@ -1 +1 @@
-{"version":3,"file":"glsp-server-overrides.js","sourceRoot":"","sources":["../../src/launcher/glsp-server-overrides.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,yBAAyB;IACtC,OAAO,IAAI,eAAe,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QAC7D,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"glsp-server-overrides.js","sourceRoot":"","sources":["../../src/launcher/glsp-server-overrides.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,yBAAyB;IACtC,OAAO,IAAI,eAAe,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE;QACzF,IAAI,CAAC,mBAAmB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACtD,YAAY,CAAa,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtD,IAAI,MAAM,YAAY,mBAAmB,EAAE,CAAC;gBACzC,OAAO,MAAM,CAAC;YACjB,CAAC;YACD,IAAI,MAAM,CAAC,WAAW,KAAK,iBAAiB,EAAE,CAAC;gBAC5C,OAAO,CAAC,SAAS;qBACb,GAAG,CAAgB,aAAa,CAAC,CAAC,qBAAqB,CAAC;qBACxD,IAAI,CACF,mCAAmC,MAAM,CAAC,WAAW,CAAC,IAAI,6BAA6B;oBACpF,mDAAmD,CACxD,CAAC;YACR,CAAC;YACD,OAAO,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;AACN,CAAC"}