@hydranium/core 1.0.0-next.115 → 1.0.0-next.117

package/lib/testing/stub-hydranium-text-documents.js

@@ -8,6 +8,7 @@
  ********************************************************************************/
 import { Disposable } from 'vscode-languageserver';
 import { LANGUAGE_CLIENT_ID } from '../documents/client-ids.js';
+import { ClientSessionRegistry } from '../documents/client-session-registry.js';
 /** Build a {@link StubHydraniumTextDocuments}. */
 export function makeStubHydraniumTextDocuments() {
     const docs = new Map();
@@ -19,7 +20,12 @@ export function makeStubHydraniumTextDocuments() {
     let applyEditHandler = () => ({ applied: true });
     const saveListeners = [];
     const closeListeners = [];
-    return {
+    // The real registry, so the session table, the opens, the closing state and
+    // the open options behave as the store's do. The stub's plain-string keys
+    // stand in for canonical URIs (one stub-boundary cast, like `fireClose`).
+    const sessions = new ClientSessionRegistry();
+    const key = (uri) => uri;
+    const stub = {
         get changes() {
             return changes;
         },
@@ -100,21 +106,38 @@ export function makeStubHydraniumTextDocuments() {
         isOpenInAnyClient(uri) {
             return docs.has(uri) || languageClientOpen.has(uri);
         },
-        openDocuments() {
-            // Merge the two seeding channels: `seedOpen` records the holding client
-            // on the doc entry, `seedOpenInLanguageClient` marks the LSP client.
-            const clientsByUri = new Map();
-            for (const [uri, entry] of docs) {
-                clientsByUri.set(uri, new Set([entry.clientId]));
+        isOpenInClient(uri, clientId) {
+            return sessions.isOpenIn(key(uri), clientId);
+        },
+        registerSession(clientId) {
+            sessions.register(clientId);
+        },
+        closeSession(clientId) {
+            if (!sessions.isRegistered(clientId)) {
+                return;
+            }
+            try {
+                for (const uri of sessions.beginClose(clientId)) {
+                    stub.fireClose(uri, clientId);
+                }
             }
-            for (const uri of languageClientOpen) {
-                const clients = clientsByUri.get(uri) ?? new Set();
-                clients.add(LANGUAGE_CLIENT_ID);
-                clientsByUri.set(uri, clients);
+            finally {
+                sessions.unregister(clientId);
             }
-            // The real store keys by canonical identity; the stub's plain-string
-            // keys stand in for it (single stub-boundary cast, like `fireClose`).
-            return [...clientsByUri].map(([uri, clients]) => ({ uri: uri, clients: [...clients] }));
+        },
+        get onDidCloseSession() {
+            return sessions.onDidCloseSession;
+        },
+        openOptions(uri, clientId) {
+            return sessions.openOptions(key(uri), clientId);
+        },
+        setOpenOptions(uri, clientId, options) {
+            sessions.setOpenOptions(key(uri), clientId, options);
+        },
+        openDocuments() {
+            // From the registry that also answers `isOpenInClient`, which both
+            // seeding channels feed, so the two never disagree about an open.
+            return sessions.openDocuments();
         },
         setApplyEditHandler(handler) {
             applyEditHandler = handler;
@@ -127,9 +150,11 @@ export function makeStubHydraniumTextDocuments() {
             staged.push({ uri, text });
         },
         seedOpen(uri, text, clientId) {
+            sessions.addOpen(key(uri), clientId);
             docs.set(uri, { uri, version: 1, text, clientId });
         },
         seedOpenInLanguageClient(uri) {
+            sessions.addOpen(key(uri), LANGUAGE_CLIENT_ID);
             languageClientOpen.add(uri);
         },
         fireClose(uri, clientId) {
@@ -140,6 +165,7 @@ export function makeStubHydraniumTextDocuments() {
             if (holder && holder.clientId === clientId) {
                 docs.delete(uri);
             }
+            sessions.removeOpen(key(uri), clientId);
             if (clientId === LANGUAGE_CLIENT_ID) {
                 languageClientOpen.delete(uri);
             }
@@ -158,7 +184,12 @@ export function makeStubHydraniumTextDocuments() {
             saveListeners.length = 0;
             closeListeners.length = 0;
             applyEditHandler = () => ({ applied: true });
+            // Cleared in place rather than replaced: a model service built on the
+            // stub subscribed to `onDidCloseSession` once, and a new registry would
+            // leave that subscription on one nothing fires.
+            sessions.clear();
         }
     };
+    return stub;
 }
 //# sourceMappingURL=stub-hydranium-text-documents.js.map

package/lib/testing/stub-hydranium-text-documents.js.map

@@ -1 +1 @@
-{"version":3,"file":"stub-hydranium-text-documents.js","sourceRoot":"","sources":["../../src/testing/stub-hydranium-text-documents.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stub-hydranium-text-documents.js","sourceRoot":"","sources":["../../src/testing/stub-hydranium-text-documents.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAqHhF,kDAAkD;AAClD,MAAM,UAAU,8BAA8B;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAiC,CAAC;IACtD,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAwC,EAAE,CAAC;IACtD,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC7C,MAAM,YAAY,GAAoD,EAAE,CAAC;IACzE,MAAM,MAAM,GAAoC,EAAE,CAAC;IACnD,IAAI,gBAAgB,GAAwE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACtH,MAAM,aAAa,GAA4E,EAAE,CAAC;IAClG,MAAM,cAAc,GAAwE,EAAE,CAAC;IAC/F,4EAA4E;IAC5E,0EAA0E;IAC1E,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAC7C,MAAM,GAAG,GAAG,CAAC,GAAW,EAAgB,EAAE,CAAC,GAAmB,CAAC;IAE/D,MAAM,IAAI,GAA+B;QACtC,IAAI,OAAO;YACR,OAAO,OAAO,CAAC;QAClB,CAAC;QACD,IAAI,KAAK;YACN,OAAO,KAAK,CAAC;QAChB,CAAC;QACD,IAAI,YAAY;YACb,OAAO,YAAY,CAAC;QACvB,CAAC;QACD,IAAI,MAAM;YACP,OAAO,MAAM,CAAC;QACjB,CAAC;QACD,GAAG,CAAC,GAAG;YACJ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC1B,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9E,CAAC;QACD,OAAO,CAAC,GAAG;YACR,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,2BAA2B,CAAC,KAAK,EAAE,QAAQ,GAAG,kBAAkB;YAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YAClD,MAAM,IAAI,GAA0B;gBACjC,GAAG,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG;gBAC3B,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,OAAO;gBACnC,IAAI,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE;gBACzC,QAAQ;aACV,CAAC;YACF,IAAI,QAAQ,IAAI,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBAChD,OAAO;YACV,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QACD,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ;YACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,YAAY,GAAG,kCAAkC,CAAC,CAAC;YACtE,CAAC;YACD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC;YACvC,oEAAoE;YACpE,qEAAqE;YACrE,gEAAgE;YAChE,MAAM,IAAI,GAA0B,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YAChH,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC,OAAO,CAAC;QACvB,CAAC;QACD,yBAAyB,CAAC,KAAK,EAAE,QAAQ;YACtC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtD,KAAK,MAAM,QAAQ,IAAI,aAAa,CAAC,KAAK,EAAE,EAAE,CAAC;gBAC5C,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YACrE,CAAC;QACJ,CAAC;QACD,SAAS,CAAC,QAAQ;YACf,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7B,OAAO,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE;gBAC3B,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAC5C,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;oBACZ,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAChC,CAAC;YACJ,CAAC,CAAC,CAAC;QACN,CAAC;QACD,UAAU,CAAC,QAAQ;YAChB,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9B,OAAO,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE;gBAC3B,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAC7C,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;oBACZ,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBACjC,CAAC;YACJ,CAAC,CAAC,CAAC;QACN,CAAC;QACD,SAAS,CAAC,GAAG;YACV,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC;QAClC,CAAC;QACD,sBAAsB,CAAC,GAAG;YACvB,OAAO,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QACD,iBAAiB,CAAC,GAAG;YAClB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;QACD,cAAc,CAAC,GAAG,EAAE,QAAQ;YACzB,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;QACD,eAAe,CAAC,QAAQ;YACrB,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;QACD,YAAY,CAAC,QAAQ;YAClB,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpC,OAAO;YACV,CAAC;YACD,IAAI,CAAC;gBACF,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC/C,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;gBACjC,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACR,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACjC,CAAC;QACJ,CAAC;QACD,IAAI,iBAAiB;YAClB,OAAO,QAAQ,CAAC,iBAAiB,CAAC;QACrC,CAAC;QACD,WAAW,CAAC,GAAG,EAAE,QAAQ;YACtB,OAAO,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;QACnD,CAAC;QACD,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO;YAClC,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;QACD,aAAa;YACV,mEAAmE;YACnE,kEAAkE;YAClE,OAAO,QAAQ,CAAC,aAAa,EAAE,CAAC;QACnC,CAAC;QACD,mBAAmB,CAAC,OAAO;YACxB,gBAAgB,GAAG,OAAO,CAAC;QAC9B,CAAC;QACD,KAAK,CAAC,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO;YAClD,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACjE,OAAO,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;QACD,mBAAmB,CAAC,GAAG,EAAE,IAAI;YAC1B,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9B,CAAC;QACD,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ;YACzB,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;YACrC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,wBAAwB,CAAC,GAAG;YACzB,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,kBAAkB,CAAC,CAAC;YAC/C,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC;QACD,SAAS,CAAC,GAAG,EAAE,QAAQ;YACpB,qEAAqE;YACrE,kEAAkE;YAClE,kEAAkE;YAClE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC1C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;YACD,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;YACxC,IAAI,QAAQ,KAAK,kBAAkB,EAAE,CAAC;gBACnC,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClC,CAAC;YACD,MAAM,KAAK,GAAG,EAAE,QAAQ,EAAE,EAAE,GAAG,EAA6B,EAAE,QAAQ,EAAiD,CAAC;YACxH,KAAK,MAAM,QAAQ,IAAI,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC;gBAC7C,QAAQ,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;QACJ,CAAC;QACD,KAAK;YACF,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACnB,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YACjB,kBAAkB,CAAC,KAAK,EAAE,CAAC;YAC3B,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;YACxB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YAClB,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;YACzB,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;YAC1B,gBAAgB,GAAG,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,sEAAsE;YACtE,wEAAwE;YACxE,gDAAgD;YAChD,QAAQ,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;KACH,CAAC;IACF,OAAO,IAAI,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hydranium/core",
-  "version": "1.0.0-next.115",
+  "version": "1.0.0-next.117",
   "description": "Foundational runtime of the hydranium framework: AST coordination layer (services, integrity, AST extension, serialization, multi-client documents) plus the LSP textual head at the /lsp subpath. Consumed by protocol-head packages (@hydranium/data-server, @hydranium/glsp-server).",
   "keywords": [
     "hydranium",
@@ -104,8 +104,8 @@
     "diff": "^5.2.0"
   },
   "devDependencies": {
-    "@hydranium/langium": "1.0.0-next.115",
-    "@hydranium/protocol": "1.0.0-next.115",
+    "@hydranium/langium": "1.0.0-next.117",
+    "@hydranium/protocol": "1.0.0-next.117",
     "@playwright/test": "^1.40.0",
     "@types/diff": "^5.2.0",
     "rimraf": "^5.0.0",
@@ -117,8 +117,8 @@
     "vscode-languageserver-types": "^3.17.5"
   },
   "peerDependencies": {
-    "@hydranium/langium": "1.0.0-next.115",
-    "@hydranium/protocol": "1.0.0-next.115",
+    "@hydranium/langium": "1.0.0-next.117",
+    "@hydranium/protocol": "1.0.0-next.117",
     "@playwright/test": "^1.40.0",
     "vscode-jsonrpc": "9.0.1",
     "vscode-languageserver": "~10.0.1",

package/src/documents/ast-document-manager.ts

@@ -8,6 +8,7 @@
  ********************************************************************************/
 
 import {
+   type CanonicalUri,
    type CloseModelArgs,
    type Tracer,
    type TransferSavedEvent,
@@ -178,7 +179,18 @@ export type AstDocumentSavedEvent<TAst extends AstNode, TDiagnostic extends AstD
 >;
 
 /** Construction options for {@link AstDocumentManager}. */
-export type AstDocumentManagerOptions = LogNameOptions;
+export interface AstDocumentManagerOptions extends LogNameOptions {
+   /**
+    * Skip a queued save of a URI when a newer save of it is queued behind. The
+    * newer save took its text later, so disk ends the same with fewer writes.
+    * A skipped save announces nothing and takes the newer save's outcome: it
+    * resolves when that one lands and rejects with its error when it fails,
+    * since disk then holds neither text. Defaults to `false`: every save
+    * writes. The framework binds the manager without options, so turning this
+    * on means rebinding `AstDocumentManager` with them.
+    */
+   readonly coalesceSaves?: boolean;
+}
 
 /**
  * The document slot the model server and the integrity service talk to:
@@ -201,8 +213,29 @@ export interface AstDocumentManager<TAst extends AstNode, TDiagnostic extends As
 
    /** Apply `text` as `clientId`'s edit. Resolves to the resulting text-document version. */
    update(uri: string, text: string, clientId: string): Promise<number>;
+   /**
+    * Write the document's current text to disk through the URI's disk queue.
+    * The text is taken when this is called, so saves of one URI land in the
+    * order they were called.
+    */
    save(uri: string, clientId: string): Promise<void>;
 
+   /**
+    * Run `task` once every disk task already queued for `uri` has settled, and
+    * before any queued after it. Every server-side disk access of a file that
+    * must not interleave with its saves goes through here: two writes of one
+    * file that bypass it can land in either order, and the older text then
+    * stays on disk. Tasks of different URIs run in parallel. A task that has
+    * nothing to do still resolves once the tasks before it have settled.
+    *
+    * A task must not await a build, nor a save, another disk task or an open
+    * of a document no client has open, all of the same URI: a build's
+    * integrity repair queues its own write here and the build waits for it,
+    * and such an open reads the file here, so a task waiting on either queued
+    * behind it never resolves, which wedges the URI's queue for good.
+    */
+   queueDiskTask<T>(uri: string, task: () => Promise<T>): Promise<T>;
+
    onUpdate(uri: string, listener: (event: AstDocumentUpdatedEvent<TAst, TDiagnostic>) => void): Disposable;
    onSave(uri: string, listener: (event: AstDocumentSavedEvent<TAst, TDiagnostic>) => void | Promise<void>): Disposable;
    onClientClosed(uri: string, clientId: string, listener: () => void): Disposable;
@@ -251,6 +284,17 @@ export class DefaultAstDocumentManager<
 > implements AstDocumentManager<TAst, TDiagnostic> {
    protected lastUpdate?: UpdateInfo;
 
+   /**
+    * Per canonical URI, the settling of the last disk task queued for it; the
+    * next task chains behind it. An entry leaves once its URI's queue is idle.
+    * Kept outside the workspace lock, whose `write` cancels the write before
+    * it: a save cancelled that way reports success for text it never wrote.
+    */
+   protected readonly diskQueues = new Map<CanonicalUri, Promise<void>>();
+   /** Per canonical URI, the newest save queued for it, which {@link coalesceSaves} lets older queued saves defer to. */
+   protected readonly newestSaves = new Map<CanonicalUri, Promise<void>>();
+   protected readonly coalesceSaves: boolean;
+
    protected readonly textDocuments: HydraniumTextDocuments<TextDocument>;
    protected readonly fileSystemProvider: WritableFileSystemProvider;
    protected readonly langiumDocs: LangiumDocuments;
@@ -268,12 +312,19 @@ export class DefaultAstDocumentManager<
       this.documentBuilder = services.workspace.DocumentBuilder;
       this.uriPolicy = services.workspace.DocumentUriPolicy;
       this.tracer = services.Tracer.for(options.logName ?? 'AstDocumentManager').trace('instantiated');
+      this.coalesceSaves = options.coalesceSaves ?? false;
       this.textDocuments.onDidOpen(event =>
          this.open({ clientId: event.clientId, uri: event.document.uri, languageId: event.document.languageId })
       );
       this.textDocuments.onDidClose(event => this.close({ clientId: event.clientId, uri: event.document.uri }));
       this.documentBuilder.onUpdate((changed, deleted) => {
          this.lastUpdate = { changed, deleted };
+         // The only place a deletion is observable: `DocumentBuilder.update`
+         // removes a deleted document before it builds anything, so no phase
+         // listener ever sees it.
+         for (const uri of deleted) {
+            this.textDocuments.notifyDocumentDeleted(uri.toString());
+         }
       });
       // Content transitions for CLOSED documents bypass the text store: the
       // last-close revert and watched-file changes rebuild from disk into a
@@ -463,6 +514,12 @@ export class DefaultAstDocumentManager<
     * callers don't need to pass it — the manager owns content and version
     * sequencing.
     *
+    * The text is taken synchronously, before the save waits in the URI's disk
+    * queue; the compare and the write run in the queue. Taken later, a save
+    * that waits behind another writes whatever the store holds when its turn
+    * comes, edits made after the call included, and announces that text under
+    * its own client id.
+    *
     * **The write is skipped when the file already holds that text; the
     * notification is not.** A save announces that the content is on disk, which
     * is true either way — so a subscriber clearing a dirty marker or reacting to
@@ -481,15 +538,52 @@ export class DefaultAstDocumentManager<
          throw new Error(`Document ${uri} hasn't been opened for saving yet`);
       }
       const text = document.getText();
-      if (!(await this.matchesDisk(canonical, text))) {
-         await this.tracer.with(canonical).time(
+      let supersededBy: Promise<void> | undefined;
+      const saved: Promise<void> = this.queueDiskTask(canonical, async () => {
+         const newest = this.newestSaves.get(canonical);
+         if (this.coalesceSaves && newest !== saved) {
+            supersededBy = newest;
+            return;
+         }
+         await this.writeSave(canonical, text, clientId);
+      })
+         .then(() => supersededBy)
+         .finally(() => {
+            if (this.newestSaves.get(canonical) === saved) {
+               this.newestSaves.delete(canonical);
+            }
+         });
+      this.newestSaves.set(canonical, saved);
+      return saved;
+   }
+
+   /** Write `text` to `uri` unless the file already holds it, then announce the save. Runs inside the URI's disk queue. */
+   protected async writeSave(uri: CanonicalUri, text: string, clientId: string): Promise<void> {
+      if (!(await this.matchesDisk(uri, text))) {
+         await this.tracer.with(uri).time(
             `Write file (${text.length} bytes, from ${clientId})`,
             // Async write so a slow disk does not block the event loop for the duration of the fs call.
-            () => this.fileSystemProvider.writeFile(UriUtils.toUri(canonical), text),
+            () => this.fileSystemProvider.writeFile(UriUtils.toUri(uri), text),
             'debug'
          );
       }
-      this.textDocuments.notifyDidSaveTextDocument({ textDocument: TextDocumentIdentifier.create(canonical), text }, clientId);
+      this.textDocuments.notifyDidSaveTextDocument({ textDocument: TextDocumentIdentifier.create(uri), text }, clientId);
+   }
+
+   queueDiskTask<T>(uri: string, task: () => Promise<T>): Promise<T> {
+      const key = this.uriPolicy.canonicalUri(uri);
+      const result = (this.diskQueues.get(key) ?? Promise.resolve()).then(task);
+      const settled = result.then(
+         () => undefined,
+         () => undefined
+      );
+      this.diskQueues.set(key, settled);
+      void settled.then(() => {
+         if (this.diskQueues.get(key) === settled) {
+            this.diskQueues.delete(key);
+         }
+      });
+      return result;
    }
 
    /**
@@ -534,7 +628,14 @@ export class DefaultAstDocumentManager<
       version = 0,
       text?: string
    ): Promise<TextDocumentItem> {
-      return { uri, languageId, version, text: text ?? (await this.fileSystemProvider.readFile(UriUtils.toUri(uri))) };
+      // Read in the disk queue: a read beside a queued save of the file returns
+      // the text from before it, and the document then opens on that.
+      return {
+         uri,
+         languageId,
+         version,
+         text: text ?? (await this.queueDiskTask(uri, () => this.fileSystemProvider.readFile(UriUtils.toUri(uri))))
+      };
    }
 
    /**

package/src/documents/client-session-errors.ts

@@ -0,0 +1,54 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+
+/**
+ * Thrown by every call on a client session after it ended, and by an open that
+ * was still in flight when its session ended.
+ *
+ * The message names the client id, so it is addressed to whoever composes the
+ * system rather than to an end user.
+ */
+export class SessionClosedError extends Error {
+   constructor(readonly clientId: string) {
+      super(`Client session ${clientId} is closed`);
+      this.name = 'SessionClosedError';
+   }
+}
+
+/**
+ * Thrown when a client session writes a document it does not have open.
+ *
+ * A session writes only what it has open, so this is the answer both to a write
+ * that never opened and to one whose open was closed underneath it — by the
+ * session itself, or by the document being deleted.
+ */
+export class DocumentNotOpenError extends Error {
+   constructor(
+      readonly uri: string,
+      readonly clientId: string
+   ) {
+      super(`Document ${uri} is not open in client session ${clientId}`);
+      this.name = 'DocumentNotOpenError';
+   }
+}
+
+/**
+ * Thrown when a client session is started under an id that is already live in
+ * the process, or that the framework reserves for itself.
+ *
+ * Ids are unique process-wide because the id is also the author label on every
+ * version and the key a client recognises its own echoes by; two participants
+ * sharing one would each take the other's writes for their own.
+ */
+export class DuplicateClientIdError extends Error {
+   constructor(readonly clientId: string) {
+      super(`Client id ${clientId} is already in use`);
+      this.name = 'DuplicateClientIdError';
+   }
+}

package/src/documents/client-session-registry.ts

@@ -0,0 +1,211 @@
+/********************************************************************************
+ * 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 CanonicalUri, FRAMEWORK_CLIENT_IDS } from '@hydranium/protocol';
+import { Emitter, type Event } from 'vscode-languageserver';
+import { INTEGRITY_CLIENT_ID } from '../langium/integrity/integrity-rule.js';
+import { DuplicateClientIdError, SessionClosedError } from './client-session-errors.js';
+
+/**
+ * What a client session states about one of its opens, kept per
+ * `(session, uri)` for as long as that open lasts.
+ *
+ * Any object type: an adopter declares the fields its own open path reads and
+ * passes that type as a session's `TOpenOptions`. Stored per open rather than
+ * per document, so two sessions opening one document with different options
+ * each keep their own.
+ */
+export type OpenOptions = object;
+
+/**
+ * `'closing'` covers the span in which a session's opens are being closed. The
+ * id is still taken then, and the session can open nothing more, so an open
+ * issued from a close listener cannot outlive the session that made it.
+ */
+export type ClientSessionState = 'live' | 'closing';
+
+/** Delivered by {@link ClientSessionRegistry.onDidCloseSession}. */
+export interface ClientSessionClosedEvent {
+   readonly clientId: string;
+}
+
+/**
+ * The ids no client session may be started under: the wire's well-known ids and
+ * the integrity author. Each names a framework participant rather than a
+ * client, and a session holding one would have its writes read as that
+ * participant's.
+ */
+export const RESERVED_CLIENT_IDS: readonly string[] = [...FRAMEWORK_CLIENT_IDS, INTEGRITY_CLIENT_ID];
+
+/**
+ * Which client has which document open, and which client ids are registered
+ * sessions — the open facts every head shares, composed by
+ * `HydraniumTextDocuments`.
+ *
+ * Opens are recorded for every client id, registered or not. An id that was
+ * never registered is a client that predates sessions and writes through the
+ * flat `clientId` calls; its opens are tracked exactly as a session's are, and
+ * only the session table ignores it. Requiring registration before an open
+ * would refuse every such client.
+ *
+ * One open per `(client, uri)`, with no reference count: a repeat open changes
+ * nothing, and one close ends it.
+ *
+ * Pure bookkeeping. Closing a document is the store's job, because a close has
+ * to reach the text store and its listeners; the store asks this class what to
+ * close and records each close here.
+ */
+export class ClientSessionRegistry {
+   protected readonly sessions = new Map<string, ClientSessionState>();
+   protected readonly clientsByUri = new Map<CanonicalUri, Set<string>>();
+   /** Each client's opens, with the options it opened them with. */
+   protected readonly opensByClient = new Map<string, Map<CanonicalUri, OpenOptions | undefined>>();
+   protected readonly reservedIds: ReadonlySet<string> = new Set(RESERVED_CLIENT_IDS);
+   protected readonly sessionClosedEmitter = new Emitter<ClientSessionClosedEvent>();
+
+   /** Fires once a session has been removed from the table, after all its opens closed. */
+   get onDidCloseSession(): Event<ClientSessionClosedEvent> {
+      return this.sessionClosedEmitter.event;
+   }
+
+   /**
+    * Enter `clientId` in the session table.
+    *
+    * Throws {@link DuplicateClientIdError} when the id is live anywhere in the
+    * process: reserved, registered (including by a session that is still
+    * closing), or holding opens as a client that is not a session. The last
+    * matters because the id is the author label and the echo key, and a
+    * session sharing one with another client would take that client's writes
+    * for its own.
+    */
+   register(clientId: string): void {
+      if (this.reservedIds.has(clientId) || this.sessions.has(clientId) || this.opensByClient.has(clientId)) {
+         throw new DuplicateClientIdError(clientId);
+      }
+      this.sessions.set(clientId, 'live');
+   }
+
+   /** Whether `clientId` is in the session table, live or closing. */
+   isRegistered(clientId: string): boolean {
+      return this.sessions.has(clientId);
+   }
+
+   /**
+    * Mark `clientId` as closing and return every URI it has open, as a copy the
+    * caller can close while this registry changes underneath it.
+    */
+   beginClose(clientId: string): CanonicalUri[] {
+      if (this.sessions.has(clientId)) {
+         this.sessions.set(clientId, 'closing');
+      }
+      return this.opensOf(clientId);
+   }
+
+   /** Remove `clientId` from the session table and announce it. A no-op for an id that is not registered. */
+   unregister(clientId: string): void {
+      if (!this.sessions.delete(clientId)) {
+         return;
+      }
+      this.sessionClosedEmitter.fire(Object.freeze({ clientId }));
+   }
+
+   /**
+    * Record that `clientId` opened `uri`, with no options. Returns `false` when
+    * it already had it open, in which case nothing changes.
+    *
+    * Throws {@link SessionClosedError} for a session that is closing.
+    */
+   addOpen(uri: CanonicalUri, clientId: string): boolean {
+      if (this.sessions.get(clientId) === 'closing') {
+         throw new SessionClosedError(clientId);
+      }
+      let opens = this.opensByClient.get(clientId);
+      if (opens?.has(uri)) {
+         return false;
+      }
+      if (!opens) {
+         opens = new Map();
+         this.opensByClient.set(clientId, opens);
+      }
+      opens.set(uri, undefined);
+      let clients = this.clientsByUri.get(uri);
+      if (!clients) {
+         clients = new Set();
+         this.clientsByUri.set(uri, clients);
+      }
+      clients.add(clientId);
+      return true;
+   }
+
+   /** Record that `clientId` closed `uri`. Returns `false` when it did not have it open. */
+   removeOpen(uri: CanonicalUri, clientId: string): boolean {
+      const opens = this.opensByClient.get(clientId);
+      if (!opens?.delete(uri)) {
+         return false;
+      }
+      if (opens.size === 0) {
+         this.opensByClient.delete(clientId);
+      }
+      const clients = this.clientsByUri.get(uri);
+      clients?.delete(clientId);
+      if (!clients?.size) {
+         this.clientsByUri.delete(uri);
+      }
+      return true;
+   }
+
+   /** Whether `clientId` has `uri` open. */
+   isOpenIn(uri: CanonicalUri, clientId: string): boolean {
+      return !!this.clientsByUri.get(uri)?.has(clientId);
+   }
+
+   /** Whether any client has `uri` open. */
+   isOpen(uri: CanonicalUri): boolean {
+      return this.clientsByUri.has(uri);
+   }
+
+   /** The clients that have `uri` open, in the order they opened it. */
+   clientsOf(uri: CanonicalUri): string[] {
+      return [...(this.clientsByUri.get(uri) ?? [])];
+   }
+
+   /** The URIs `clientId` has open, in the order it opened them. */
+   opensOf(clientId: string): CanonicalUri[] {
+      return [...(this.opensByClient.get(clientId)?.keys() ?? [])];
+   }
+
+   /** Every document open in at least one client, with the clients that have it open. */
+   openDocuments(): Array<{ readonly uri: CanonicalUri; readonly clients: string[] }> {
+      return [...this.clientsByUri].map(([uri, clients]) => ({ uri, clients: [...clients] }));
+   }
+
+   /** The options `clientId` opened `uri` with, or `undefined` when it gave none or does not have it open. */
+   openOptions(uri: CanonicalUri, clientId: string): OpenOptions | undefined {
+      return this.opensByClient.get(clientId)?.get(uri);
+   }
+
+   /** Replace the options of an existing open. Does nothing when `clientId` does not have `uri` open. */
+   setOpenOptions(uri: CanonicalUri, clientId: string, options: OpenOptions | undefined): void {
+      const opens = this.opensByClient.get(clientId);
+      if (opens?.has(uri)) {
+         opens.set(uri, options);
+      }
+   }
+
+   /**
+    * Forget every session and open without announcing anything. Subscriptions
+    * stay, so a listener registered before the clear hears the sessions that
+    * end after it.
+    */
+   clear(): void {
+      this.sessions.clear();
+      this.clientsByUri.clear();
+      this.opensByClient.clear();
+   }
+}