@hydranium/core 1.0.0-next.37 → 1.0.0-next.370

package/lib/documents/ast-document-manager.js

@@ -6,42 +6,22 @@
  *
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
-import { DocumentState, UriUtils } from '@hydranium/langium';
+import { asModelVersion, UNRECORDED_VERSION, describeErrorWithStack } from '@hydranium/protocol';
+import { DocumentState, URI, UriUtils } from '@hydranium/langium';
+import { ReentrantWriteLockError, isInsideWriteLock } from '../langium/workspace/write-lock-scope.js';
 import { Disposable } from 'vscode-languageserver';
 import { TextDocumentIdentifier } from 'vscode-languageserver-protocol';
-import { URI } from '@hydranium/langium';
-import { labelPhaseListener } from '../langium/document-builder/index.js';
 import { UNKNOWN_CLIENT_ID } from './client-ids.js';
 export var AstDocument;
 (function (AstDocument) {
     /**
-     * Construct an {@link AstDocument} envelope. `diagnostics` defaults
-     * to `[]` so test fixtures and the in-process pre-validated paths
-     * don't need to repeat the empty array at every call site. Mirrors
-     * `TransferDocument.create` on the wire side.
+     * Construct an {@link AstDocument} envelope, its version marked as coming
+     * from a read. `diagnostics` absent means not validated.
      */
-    function create(uri, version, root, diagnostics = []) {
-        return { uri, version, root, diagnostics };
+    function create(uri, version, root, diagnostics) {
+        return { uri, version: asModelVersion(version), root, ...(diagnostics === undefined ? {} : { diagnostics }) };
     }
     AstDocument.create = create;
-    /**
-     * Project a {@link LangiumDocument} into its {@link AstDocument}
-     * envelope — the single place that reads `root` / `diagnostics` /
-     * `version` / `uri` off a built document. Both the event path
-     * ({@link AstDocumentManager.onUpdate} / `onSave`) and the read path
-     * (`ModelService`'s snapshot accessors) go through here so the
-     * field mapping lives once.
-     *
-     * The emitted `uri` is always the document's own `textDocument.uri` — the
-     * canonical document-identity form (see {@link DocumentUriPolicy}). Events
-     * carry that identity, not the subscriber's (possibly non-canonical) URI:
-     * a subscriber already knows the URI it subscribed with, so the useful
-     * thing to surface is the canonical one every other layer keys by.
-     */
-    function from(document) {
-        return create(document.textDocument.uri, document.textDocument.version, document.parseResult.value, (document.diagnostics ?? []));
-    }
-    AstDocument.from = from;
 })(AstDocument || (AstDocument = {}));
 /**
  * Higher-level facade over {@link HydraniumTextDocuments} that speaks the
@@ -51,8 +31,9 @@ export var AstDocument;
  *
  * Generic over `<TAst extends AstNode, TDiagnostic>` so each consumer
  * projects its own AST root type and diagnostic shape into the emitted
- * `AstDocument` envelopes. `TDiagnostic` defaults to `unknown`; consumers
- * that care about the diagnostic shape name a concrete one.
+ * `AstDocument` envelopes. `TDiagnostic` defaults to `AstDiagnostic`; a
+ * narrower one is asserted unchecked, as
+ * {@link AstDocumentManager.toAstDocument} says.
  *
  * **URI contract.** Every URI-accepting method takes a URI in *any* spelling
  * (canonical, symlinked, `..`/case-divergent) and canonicalizes internally
@@ -65,7 +46,47 @@ export var AstDocument;
  */
 export class DefaultAstDocumentManager {
     services;
+    /** The last `DocumentBuilder.update`'s URIs; the reason for a document the store does not track. */
     lastUpdate;
+    /**
+     * Canonical URIs a client has opened since the file was last deleted,
+     * whose versions the store keeps. One no client has opened keeps Langium's
+     * version `0` through every change of its content, so its version says
+     * nothing. Kept past the last close, since the store continues the version
+     * sequence on the next open; a delivery can land after that close.
+     */
+    trackedUris = new Set();
+    /**
+     * Per tracked URI, the version whose `Validated` listeners last all ran,
+     * which is the version an update event was delivered for. Dropped on
+     * deletion, so a file created again with the same text is changed again.
+     */
+    deliveredVersions = new Map();
+    /**
+     * Whose writes the build under way carries, set when it starts: the author
+     * of every open document's undelivered version, and the unknown-client id
+     * for a change no write explains, such as a deletion no session's delete
+     * made, a document no client has open, or a write that changed nothing.
+     * An undelivered version is one whose build has not validated it yet, so a
+     * write whose build was cancelled stays a cause of the build that takes
+     * over.
+     *
+     * Errs toward more than one cause, and so toward the unknown client, which
+     * a reader treats as foreign: an answer it repeats, never one it misses.
+     * A change no write explains counts for its own build only, so a build
+     * that takes over from a cancelled one loses it. One field for every build:
+     * a build started outside the workspace lock, such as a re-queue of an
+     * orphaned document, reads the causes of whichever build started last.
+     * An open document no build delivers, one a `shouldValidate` override
+     * skips, stays undelivered after its first write, so it is a cause of every
+     * build from then on while open.
+     */
+    buildCauses = new Set();
+    /** Per canonical URI, the client whose {@link delete} of it is under way. */
+    deletions = new Map();
+    /** Per canonical URI, the newest save queued for it, which {@link coalesceSaves} lets older queued saves defer to. */
+    newestSaves = new Map();
+    coalesceSaves;
     textDocuments;
     fileSystemProvider;
     langiumDocs;
@@ -80,27 +101,42 @@ export class DefaultAstDocumentManager {
         this.documentBuilder = services.workspace.DocumentBuilder;
         this.uriPolicy = services.workspace.DocumentUriPolicy;
         this.tracer = services.Tracer.for(options.logName ?? 'AstDocumentManager').trace('instantiated');
-        this.textDocuments.onDidOpen(event => this.open({ clientId: event.clientId, uri: event.document.uri, languageId: event.document.languageId }));
+        this.coalesceSaves = options.coalesceSaves ?? false;
+        this.textDocuments.onDidOpen(event => {
+            this.trackedUris.add(this.uriPolicy.canonicalUri(event.document.uri));
+            return 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 };
-        });
-        // Content transitions for CLOSED documents bypass the text store: the
-        // last-close revert and watched-file changes rebuild from disk into a
-        // factory-fresh text document carrying the factory's own version. At the
-        // Parsed transition (the earliest phase with text, and one only re-read
-        // documents pass through — cascade relinks re-enter later), reconcile the
-        // store's persisted version sequence with the rebuilt content and
-        // re-stamp the document so every downstream envelope (revert broadcast,
-        // snapshot reads) carries the continued sequence. An empty-changes
-        // update only re-stamps the version. Previously-untracked URIs exit on a
-        // map lookup, so workspace-wide builds don't hash untouched documents.
-        this.documentBuilder.onDocumentPhase(DocumentState.Parsed, labelPhaseListener(document => {
-            const sequenceVersion = this.textDocuments.reconcileExternalContent(document.textDocument.uri, document.textDocument.getText());
-            if (sequenceVersion !== undefined && document.textDocument.version !== sequenceVersion) {
-                this.textDocuments.update(document.textDocument, [], sequenceVersion);
+            this.buildCauses.clear();
+            for (const textDocument of this.textDocuments.all()) {
+                if (!this.isDelivered(textDocument.uri, textDocument.version)) {
+                    this.buildCauses.add(this.textDocuments.getAuthor(textDocument.uri, textDocument.version) ?? UNKNOWN_CLIENT_ID);
+                }
+            }
+            const unexplained = changed.some(uri => {
+                const textDocument = this.textDocuments.get(uri.toString());
+                return textDocument === undefined || this.isDelivered(textDocument.uri, textDocument.version);
+            });
+            if (unexplained) {
+                this.buildCauses.add(UNKNOWN_CLIENT_ID);
+            }
+            deleted.forEach(uri => this.buildCauses.add(this.attributeDeletion(uri.toString())));
+            // 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) {
+                const key = this.uriPolicy.canonicalUri(uri.toString());
+                this.trackedUris.delete(key);
+                this.deliveredVersions.delete(key);
+                this.textDocuments.notifyDocumentDeleted(uri.toString());
             }
-        }, 'AstDocumentManager.reconcileExternalContent'));
+        });
+        // Once every listener ran, not in a listener of its own: listeners after
+        // it could still be skipped by a cancel, and the next build would then
+        // report as rebuilt a version they never delivered.
+        this.documentBuilder.onDocumentPhaseDelivered(DocumentState.Validated, (document, version) => this.markDelivered(document, version));
     }
     /**
      * Resolve a `languageId` for a URI by delegating to the
@@ -130,82 +166,93 @@ export class DefaultAstDocumentManager {
         return languages.length === 1 ? languages[0].LanguageMetaData.languageId : 'plaintext';
     }
     /**
-     * Subscribe to the save event of the document at `uri`. The callback fires only when the
-     * URI of the saved document matches `uri` (compared by canonical form).
+     * The client that authored `document`'s current version, or `undefined` when
+     * no client wrote it: a document no client has open. A rebuild that keeps
+     * the version keeps its author, so this does not say who caused a build;
+     * {@link attributeUpdate} does.
+     * Honest about absence so a routing consumer tests `undefined` directly
+     * rather than against a sentinel; the presentation default
+     * ({@link UNKNOWN_CLIENT_ID}) is applied where an event needs a value.
      */
-    onSave(uri, listener) {
-        const target = this.uriPolicy.canonicalUri(uri);
-        return this.textDocuments.onDidSave(async (event) => {
-            if (this.uriPolicy.canonicalUri(event.document.uri) !== target) {
-                return undefined;
-            }
-            // Look the document up by its canonical URI: the adopter's
-            // `LangiumDocuments` keys by the canonical form, while the saved
-            // event carries the (possibly symlinked) client-facing URI.
-            const documentURI = UriUtils.toUri(target);
-            if (documentURI !== undefined && this.langiumDocs.hasDocument(documentURI)) {
-                const document = await this.langiumDocs.getOrCreateDocument(documentURI);
-                return listener({
-                    document: this.toAstDocument(document),
-                    sourceClientId: event.clientId
-                });
-            }
-            return undefined;
-        });
-    }
-    /** Fires when `clientId` detaches from the document at `uri` (matched by canonical form). */
-    onClientClosed(uri, clientId, listener) {
-        const target = this.uriPolicy.canonicalUri(uri);
-        return this.textDocuments.onDidClose(event => {
-            if (event.clientId === clientId && this.uriPolicy.canonicalUri(event.document.uri) === target) {
-                listener();
-            }
-        });
+    getAuthor(document) {
+        return this.textDocuments.getAuthor(document.textDocument.uri, document.textDocument.version);
     }
-    /** Fires when the document at `uri` reaches `Validated` after each rebuild. */
-    onUpdate(uri, listener) {
-        const target = this.uriPolicy.canonicalUri(uri);
-        const emitUpdate = (document) => {
-            if (this.uriPolicy.canonicalUri(document.uri) !== target) {
-                return;
-            }
+    /**
+     * `'changed'` for the first delivery of the document's version, crediting
+     * its author; `'rebuilt'` for a later one, crediting nobody, since it echoes
+     * no write, and naming the build's single cause if it has one. A version an
+     * open made from the text a build already parsed counts as delivered, as it
+     * echoes no write either.
+     *
+     * A document the rule does not apply to (see {@link isTracked}) falls back
+     * to the last update: it is `'changed'` when its URI was passed to
+     * `DocumentBuilder.update`. An open document that a validating build skips,
+     * through a `shouldValidate` override, is never delivered after its first
+     * write, so each of its events from then on is its author's change.
+     */
+    attributeUpdate(document) {
+        const key = this.uriPolicy.canonicalUri(document.uri.toString());
+        const changed = this.isTracked(key)
+            ? this.deliveredVersions.get(key) !== document.textDocument.version
+            : this.lastUpdate?.changed.some(uri => UriUtils.equals(uri, document.uri)) === true;
+        if (changed) {
             // Presentation boundary: the event field is a concrete `string`, so an
-            // unauthored (framework-rebuilt) document surfaces the readable default
-            // rather than `undefined` to subscribers and logs.
-            const sourceClientId = this.getAuthor(document) ?? UNKNOWN_CLIENT_ID;
-            const event = {
-                document: this.toAstDocument(document),
-                sourceClientId,
-                reason: this.lastUpdate?.changed.find(changed => UriUtils.equals(changed, document.uri))
-                    ? 'changed'
-                    : this.lastUpdate?.deleted.find(deleted => UriUtils.equals(deleted, document.uri))
-                        ? 'deleted'
-                        : 'rebuilt'
-            };
-            this.tracer.with(uri).trace(`emitUpdate start: source=${sourceClientId}, reason=${event.reason}`);
-            listener(event);
-            this.tracer.with(uri).trace('emitUpdate listener returned');
-        };
-        return this.documentBuilder.onDocumentPhase(DocumentState.Validated, labelPhaseListener(emitUpdate, 'AstDocumentManager.onUpdate'));
+            // unauthored document surfaces the readable default rather than
+            // `undefined` to subscribers and logs.
+            const author = this.getAuthor(document) ?? UNKNOWN_CLIENT_ID;
+            return { reason: 'changed', sourceClientId: author, causedBy: author };
+        }
+        const [cause] = this.buildCauses;
+        return { reason: 'rebuilt', sourceClientId: UNKNOWN_CLIENT_ID, causedBy: this.buildCauses.size === 1 ? cause : UNKNOWN_CLIENT_ID };
     }
     /**
-     * The client that authored `document`'s current version, or `undefined` when
-     * no client wrote it — a framework-internal rebuild (workspace startup, a
-     * cascade relink, a `didClose`-reload) or a genuine author gap. Honest about
-     * absence so routing consumers (`ModelService.isNonLanguageClientEdit`)
-     * test `undefined` directly rather than against a sentinel; the presentation
-     * default ({@link UNKNOWN_CLIENT_ID}) is applied at the boundary that needs a
-     * concrete value (the `onUpdate` event's `sourceClientId`, the data-server's
-     * `resolveSourceClientId`).
+     * Whether the version rule applies to `uri`: the store keeps its version,
+     * and rebuilds validate. With `updateBuildOptions.validation` off no version
+     * is ever delivered, and the rule would report every event of an open
+     * document as its author's change.
      */
-    getAuthor(document) {
-        return this.textDocuments.getAuthor(document.textDocument.uri, document.textDocument.version);
+    isTracked(uri) {
+        return this.keepsVersion(uri) && Boolean(this.documentBuilder.updateBuildOptions.validation);
+    }
+    /**
+     * Whether the store keeps `uri`'s version: a client opened it since its
+     * file was last deleted, or has it open still, as an editor keeps a
+     * deleted file's buffer.
+     */
+    keepsVersion(uri) {
+        return this.trackedUris.has(uri) || this.textDocuments.isOpen(uri);
+    }
+    /**
+     * Record that `version` of `document` was delivered, when the store tracks
+     * it. The version the listeners saw, not the document's current one: a
+     * write during them has moved that on, and marking it would report the
+     * write's own build as rebuilt.
+     */
+    markDelivered(document, version) {
+        const key = this.uriPolicy.canonicalUri(document.uri.toString());
+        if (this.keepsVersion(key)) {
+            this.deliveredVersions.set(key, version);
+        }
+    }
+    /**
+     * Whether the store holds for `uri` the text a build parsed into `built`,
+     * compared as the store compares a first open's text. A placeholder was
+     * parsed from nothing.
+     */
+    holdsParsedText(uri, built) {
+        const ledger = this.services.workspace.ModelLedger;
+        const root = built.parseResult.value;
+        return (!ledger.isPlaceholder(root) && (ledger.textOf(root) ?? built.textDocument.getText()) === this.textDocuments.get(uri)?.getText());
+    }
+    /** Whether `version` of `uri` was delivered. */
+    isDelivered(uri, version) {
+        return this.deliveredVersions.get(this.uriPolicy.canonicalUri(uri)) === version;
     }
     async open(args) {
         // `open()` is the RPC-level "ensure this document is loaded" call. It is issued
-        // by a view attaching, but also internally by `update()` / `save()` and by every
-        // additional client attaching to the same URI, including the several sub-editors
-        // a composite view opens. When the document is already loaded there is nothing to
+        // by a session opening the document, including by every additional client
+        // attaching to the same URI and the several sub-editors a composite view
+        // opens. When the document is already loaded there is nothing to
         // do here but hand back the close-disposable — callers that want the current
         // state read it from this method's surrounding RPC response, not from a re-build.
         //
@@ -218,10 +265,40 @@ export class DefaultAstDocumentManager {
         // transiently breaks cross-document linking mid-rebuild (a dependent briefly
         // seeing an `extends`/`type` reference unresolved). And because the constructor
         // wires `onDidOpen -> this.open`, it would fire a second, identical rebuild on
-        // every first open. So an already-open `open()` is a no-op.
+        // every first open.
+        //
+        // So an already-open `open()` records the attaching client's open and nothing
+        // else. The open is per `(uri, clientId)` and the store releases the document
+        // only once none is left, so skipping it lets the first client's close tear down a document
+        // another client is still reading. A document waiting out the release grace
+        // is still loaded: a client lost from it within its own grace attaches and
+        // keeps its text, and for any other client the attach releases it, so the
+        // open reads the file.
+        if (this.isOpen(args.uri)) {
+            this.textDocuments.attachClient(args.uri, args.clientId);
+        }
         if (!this.isOpen(args.uri)) {
             const textDocument = await this.createDocumentFromTextOrFileSystem(args.uri, args.languageId, args.version, args.text);
+            const creates = !this.isOpen(args.uri);
             this.textDocuments.notifyDidOpenTextDocument({ textDocument }, args.clientId);
+            if (creates && args.text !== undefined) {
+                // Text the caller supplies was not read from the file, so no file
+                // is assumed: the document is dirty until its first save, whatever
+                // the file holds.
+                this.textDocuments.markCreated(args.uri);
+            }
+            const built = this.getDocument(args.uri);
+            if (creates && built) {
+                if (args.text === undefined && this.holdsParsedText(args.uri, built)) {
+                    // The open writes nothing, so its first delivery would
+                    // otherwise credit the opener, whose client then drops a
+                    // dependency's relink as its own echo.
+                    this.markDelivered(built, this.textDocuments.version(args.uri));
+                }
+                // Without an LSP head nothing else builds the opened text. Nothing
+                // waits on the build either, so its failure ends here.
+                this.services.workspace.VersionSyncService.syncTo(built.uri, this.textDocuments.version(args.uri))?.catch((error) => this.tracer.with(args.uri).error(`The build of the opened text failed. ${describeErrorWithStack(error)}`));
+            }
         }
         return Disposable.create(() => this.close(args));
     }
@@ -253,26 +330,119 @@ 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 file's task
+     * 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
+     * a persist behaves the same, while an mtime is not moved for byte-identical
+     * content that a downstream mtime-keyed build would then read as new work.
+     *
      * Throws if no document is open for `uri`.
      */
     async save(uri, clientId) {
-        const document = this.textDocuments.get(uri);
+        // Canonical throughout: the write and the read that gates it must address
+        // the same file the store was keyed by, or a divergent spelling compares
+        // one file and writes another.
+        const canonical = this.uriPolicy.canonicalUri(uri);
+        const document = this.textDocuments.get(canonical);
         if (!document) {
             throw new Error(`Document ${uri} hasn't been opened for saving yet`);
         }
         const text = document.getText();
-        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(uri), text), 'debug');
+        const version = document.version;
+        let supersededBy;
+        const saved = this.services.workspace.FileSystemTaskQueue.enqueue(canonical, async () => {
+            const newest = this.newestSaves.get(canonical);
+            if (this.coalesceSaves && newest !== saved) {
+                supersededBy = newest;
+                return;
+            }
+            await this.writeSave(canonical, text, clientId);
+        })
+            .then(() => supersededBy ?? version)
+            .finally(() => {
+            if (this.newestSaves.get(canonical) === saved) {
+                this.newestSaves.delete(canonical);
+            }
+        });
+        this.newestSaves.set(canonical, saved);
+        return saved;
+    }
+    async delete(uri, clientId) {
+        const canonical = this.uriPolicy.canonicalUri(uri);
+        const target = UriUtils.toUri(canonical);
+        // The builds below wait for a holder of the write lock, which would be
+        // waiting for this delete.
+        if (isInsideWriteLock()) {
+            throw new ReentrantWriteLockError(canonical);
+        }
+        // The mark holds one client: a second delete would share it, and the
+        // first to settle would clear it under the other.
+        if (this.deletions.has(canonical)) {
+            throw new Error(`Cannot delete ${uri}: a delete of it is under way`);
+        }
+        this.deletions.set(canonical, clientId);
+        try {
+            // A document no build has reached yet is not registered, and the
+            // deletion build would remove nothing and leave every open of it.
+            if (!this.langiumDocs.getDocument(target)) {
+                await this.documentBuilder.scheduleUpdate([target], []);
+            }
+            await this.services.workspace.FileSystemTaskQueue.enqueue(canonical, () => this.fileSystemProvider.deleteFile(target));
+            // Langium removes the document before the build's first await, so a
+            // failure is the dependents' build, and reaches no one else.
+            await this.documentBuilder
+                .scheduleUpdate([], [target])
+                .catch((error) => this.tracer.with(canonical).error(`The build after a deletion failed. ${describeErrorWithStack(error)}`));
+            // A change requested before that build started merges over the
+            // deletion, and the document lives on; the deleting client takes it as
+            // gone, so its open ends here.
+            if (this.textDocuments.isOpenInClient(canonical, clientId)) {
+                await this.close({ uri: canonical, clientId });
+            }
+        }
+        finally {
+            this.deletions.delete(canonical);
+        }
+    }
+    isDeleting(uri) {
+        return this.deletions.has(this.uriPolicy.canonicalUri(uri));
+    }
+    attributeDeletion(uri) {
+        return this.deletions.get(this.uriPolicy.canonicalUri(uri)) ?? UNKNOWN_CLIENT_ID;
+    }
+    /** Write `text` to `uri` unless the file already holds it, then announce the save. Runs inside the file's task queue. */
+    async writeSave(uri, text, clientId) {
+        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(uri), text), 'debug');
+        }
         this.textDocuments.notifyDidSaveTextDocument({ textDocument: TextDocumentIdentifier.create(uri), text }, clientId);
     }
+    /**
+     * Whether the file at `uri` already holds `text`.
+     *
+     * Compared by CONTENT rather than against a remembered version, so a write
+     * from outside this server is still corrected: a version this manager already
+     * saved says nothing about what is on disk now. `false` when the file cannot
+     * be read at all, which is the answer that writes — a document whose file does
+     * not exist yet is exactly the one a first save has to create.
+     */
+    async matchesDisk(uri, text) {
+        return this.fileSystemProvider
+            .readFile(UriUtils.toUri(uri))
+            .then(onDisk => onDisk === text)
+            .catch(() => false);
+    }
     isOpen(uri) {
         return !!this.textDocuments.get(uri);
     }
-    isTriggeringEdit(uri) {
-        const canonical = this.uriPolicy.canonicalUri(uri);
-        return this.lastUpdate?.changed.some(changed => this.uriPolicy.canonicalUri(changed) === canonical) ?? false;
-    }
     /**
      * The `LangiumDocument` for an externally-supplied URI, looked up by its
      * canonical identity. Folds the `getDocument(toUri(canonicalUri(uri)))` idiom
@@ -284,15 +454,29 @@ export class DefaultAstDocumentManager {
         return this.langiumDocs.getDocument(UriUtils.toUri(this.uriPolicy.canonicalUri(uri)));
     }
     async createDocumentFromTextOrFileSystem(uri, languageId = this.resolveLanguageId(uri), version = 0, text) {
-        return { uri, languageId, version, text: text ?? (await this.fileSystemProvider.readFile(UriUtils.toUri(uri))) };
+        // Read in the file's task 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.services.workspace.FileSystemTaskQueue.enqueue(uri, () => this.fileSystemProvider.readFile(UriUtils.toUri(uri))))
+        };
     }
     /**
-     * Hook for subclasses that want to re-shape the emitted document (e.g. inject
-     * a custom-typed `diagnostics` field). The default delegates to
-     * {@link AstDocument.from}, the shared LangiumDocument→envelope projection.
+     * Events and the model service's snapshot reads both come through here, so
+     * an override that re-shapes the document re-shapes both.
      */
     toAstDocument(document) {
-        return AstDocument.from(document);
+        const uri = document.textDocument.uri;
+        const root = document.parseResult.value;
+        const ledger = this.services.workspace.ModelLedger;
+        const version = ledger.versionOf(root);
+        if (version === UNRECORDED_VERSION && !ledger.isPlaceholder(root)) {
+            this.tracer.with(uri).warn('No model version recorded for the root: it was built outside the document factory');
+        }
+        return AstDocument.create(uri, version, root, document.diagnostics);
     }
 }
 //# sourceMappingURL=ast-document-manager.js.map

package/lib/documents/ast-document-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"ast-document-manager.js","sourceRoot":"","sources":["../../src/documents/ast-document-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ast-document-manager.js","sourceRoot":"","sources":["../../src/documents/ast-document-manager.ts"],"names":[],"mappings":"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"}

package/lib/documents/client-ids.d.ts

@@ -7,24 +7,10 @@
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
 /**
- * Well-known client-kind identifiers used across the multi-client framework.
- *
- * The framework tracks each document as belonging to one or more "clients"
- * — typically an LSP-text-client (Monaco, VS Code, etc.), a GLSP diagram
- * client, and/or a structured-form client. Each kind carries a stable id so
- * the server can route outbound corrections, edits, and notifications to the
- * right transport.
- */
-/** Identifier for an LSP-text client (Monaco, VS Code, …). */
-export declare const LANGUAGE_CLIENT_ID = "language-client";
-/** Fallback identifier when a document's author is unknown (e.g. cold workspace-init load). */
-export declare const UNKNOWN_CLIENT_ID = "unknown";
-/**
- * Synthetic author id on the `onDocumentUpdated` broadcast a data-server
- * emits after the LAST client closed a document and the framework rebuilt it
- * from its disk content (discarding unsaved in-session edits). Not a real
- * client: it lets consumers distinguish the revert broadcast from
- * client-authored updates.
+ * Re-export, because these are WIRE values and the side that has to recognise
+ * them is the client. They are defined in `@hydranium/protocol` so a frontend
+ * can name them without depending on the server tier; this path stays so
+ * server-side code keeps importing them from where it already does.
  */
-export declare const REVERT_ON_CLOSE_CLIENT_ID = "revert-on-close";
+export { FRAMEWORK_CLIENT_IDS, LANGUAGE_CLIENT_ID, DOCUMENT_RELEASE_CLIENT_ID, UNKNOWN_CLIENT_ID } from '@hydranium/protocol';
 //# sourceMappingURL=client-ids.d.ts.map

package/lib/documents/client-ids.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-ids.d.ts","sourceRoot":"","sources":["../../src/documents/client-ids.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;GAQG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AAEpD,+FAA+F;AAC/F,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,oBAAoB,CAAC"}
+{"version":3,"file":"client-ids.d.ts","sourceRoot":"","sources":["../../src/documents/client-ids.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;GAKG;AACH,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}