@hydranium/protocol 1.0.0-next.23 → 1.0.0-next.230

package/lib/client/data-connection.js

@@ -0,0 +1,404 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataConnectionWithEvents = exports.DataConnection = exports.DATA_CONNECTION_SESSION_RESTORE_FAILED = exports.DATA_CONNECTION_WATCH_RESTORE_FAILED = void 0;
+const vscode_jsonrpc_1 = require("vscode-jsonrpc");
+const client_ids_1 = require("../client-ids");
+const data_1 = require("../data");
+const errors_1 = require("../errors");
+const primitives_1 = require("../messages/primitives");
+const noop_logger_1 = require("../noop-logger");
+const random_uuid_1 = require("../random-uuid");
+const data_events_1 = require("./data-events");
+const data_session_1 = require("./data-session");
+const rpc_connection_1 = require("./rpc-connection");
+/**
+ * A watch {@link DataConnection.watchDocument} keeps could not be sent again to
+ * a connection that became ready after a drop; the next one sends it again.
+ */
+exports.DATA_CONNECTION_WATCH_RESTORE_FAILED = (0, primitives_1.defineMessage)('hydranium/protocol/data-connection-watch-restore-failed', 'Could not watch {uri} again after reconnecting to the data server: {detail}');
+/**
+ * A session's restore threw when its connection came back; the connection
+ * went on restoring the others.
+ */
+exports.DATA_CONNECTION_SESSION_RESTORE_FAILED = (0, primitives_1.defineMessage)('hydranium/protocol/data-connection-session-restore-failed', 'Could not restore a session after reconnecting to the data server: {detail}');
+/**
+ * A {@link RpcConnection} to the data head, carrying as many participants as
+ * the host has interested parties.
+ *
+ * Document operations live on the participants rather than here: they carry a
+ * `clientId`, which identifies a participant rather than a wire, and the server
+ * keys its opens and watches per `(uri, clientId)`. Two parties sharing one
+ * identity cannot tell each other's writes from their own echoes.
+ * {@link DataConnection.watchDocument} is the exception: it acts as no
+ * participant, under an id no session holds, and opens or writes nothing.
+ *
+ * Generic over the transfer root so this file names no grammar. An adopter
+ * binds the concrete root (or the union of them, for a multi-grammar head) at
+ * its own edge.
+ */
+class DataConnection extends rpc_connection_1.RpcConnection {
+    sessions = new Set();
+    sessionFactory;
+    createSessionEmitter = new vscode_jsonrpc_1.Emitter();
+    /**
+     * Fires with each session {@link createSession} starts, before it returns,
+     * so a listener sees every session a caller can. A session started before
+     * the listener subscribed is in {@link liveSessions}.
+     */
+    onDidCreateSession = this.createSessionEmitter.event;
+    /**
+     * Per URI, the `dirty` the client was last told, whether a session of this
+     * connection has it open or a watch follows it. A session's open or close
+     * of the URI forgets it; disposing a watch does not, since a watch knows
+     * only the caller's spelling of the URI, not the server's key. A
+     * session's restore and a watch sent again after a reconnect tell the
+     * client their answer where it differs, a forgotten URI included; see
+     * {@link restoreDirty}.
+     */
+    dirtyStates = new Map();
+    /** Backs each session's {@link DataSessionHost.onDidChangeDirty}. */
+    dirtyChangedEmitter = new vscode_jsonrpc_1.Emitter();
+    /** Backs each session's {@link DataSessionHost.onDidUpdateDocument}. */
+    documentUpdatedEmitter = new vscode_jsonrpc_1.Emitter();
+    /**
+     * Per id {@link watchDocument} watches under, the URI it watches, which
+     * {@link generationReady} sends again to every later generation until the
+     * watch's handle is disposed.
+     */
+    watches = new Map();
+    /** The port's logger, or one that logs nothing. */
+    logger;
+    /** Backs {@link onDidReconnect}. */
+    reconnectEmitter = new vscode_jsonrpc_1.Emitter();
+    /**
+     * Fires on every reconnect: once a connection becomes ready after an
+     * earlier one was, and its watches have been sent. The server sends no
+     * event for a change made while the connection was down, so a watcher reads
+     * its document again on this; a read it sends now reaches the server after
+     * its watch.
+     */
+    onDidReconnect = this.reconnectEmitter.event;
+    /** Whether a generation was ready before, which makes the next one a reconnect. */
+    readyBefore = false;
+    constructor(port, client, ...rest) {
+        const [options = {}] = rest;
+        super(port, client, {
+            methodNamespace: options.methodNamespace ?? data_1.DATA_SERVER_WIRE_PREFIX,
+            // The default is reachable only where `TClient` satisfies
+            // `DataClientProtocol`, which the constructor's conditional enforces;
+            // the compiler cannot carry that through to the generic parameter.
+            clientMethods: options.clientMethods ?? data_1.DATA_CLIENT_PROTOCOL_METHODS,
+            lifecycle: options
+        });
+        this.sessionFactory =
+            options.sessionFactory ?? ((clientId, host, label) => new data_session_1.DataSession(clientId, host, label));
+        this.logger = (port.logger ?? new noop_logger_1.NoopLogger()).for('DataConnection');
+    }
+    /**
+     * The sessions of this connection that have not ended, in the order they
+     * started. A session is listed until its `onDidDispose` fires, or until
+     * {@link dispose} clears the list.
+     */
+    get liveSessions() {
+        return [...this.sessions];
+    }
+    /**
+     * Start a participant on this connection, registered with the server under a
+     * fresh id, `label` plus `#` plus a random UUID, or under `clientId` when
+     * given. Pass a `label` naming the participant; without one it is
+     * `session`. Synchronous: the registration is sent at once, and the
+     * session's calls wait for it. The server refuses an id live anywhere in
+     * its process, and every call of that session then rejects with an error
+     * `isDuplicateClientIdError` recognises; an id the server reserves beyond
+     * {@link FRAMEWORK_CLIENT_IDS}, such as the integrity author, with one
+     * `isReservedClientIdError` recognises. Only the code crosses the wire, so
+     * test with those guards rather than `instanceof`.
+     *
+     * Throws a {@link ReservedClientIdError} for an id in
+     * {@link FRAMEWORK_CLIENT_IDS} — those are authors the SERVER emits rather
+     * than participants, so a session holding one would read the framework's
+     * own broadcasts as its own echoes and drop them — and a
+     * {@link DuplicateClientIdError} for an id a live session on this
+     * connection already holds.
+     */
+    createSession(label = 'session', clientId) {
+        this.assertLive();
+        const id = clientId ?? `${label}#${(0, random_uuid_1.randomUuid)()}`;
+        if (client_ids_1.FRAMEWORK_CLIENT_IDS.includes(id)) {
+            throw new errors_1.ReservedClientIdError(id);
+        }
+        if ([...this.sessions].some(session => session.clientId === id)) {
+            throw new errors_1.DuplicateClientIdError(id);
+        }
+        const session = this.sessionFactory(id, {
+            connected: () => this.connected(),
+            reportError: (error, reported) => this.reportError(error, reported),
+            restoreDirty: event => this.restoreDirty(event),
+            forgetDirty: uri => this.dirtyStates.delete(uri),
+            onDidChangeDirty: this.dirtyChangedEmitter.event,
+            onDidUpdateDocument: this.documentUpdatedEmitter.event
+        }, label);
+        this.sessions.add(session);
+        // Subscribed before the session is handed out, so the id is free again
+        // on this connection by the time any caller's listener runs.
+        session.onDidDispose(() => this.sessions.delete(session));
+        // A failure reaches the session's own calls, which wait for the same
+        // registration; caught here only so it is not also reported unhandled.
+        session.connected().catch(() => undefined);
+        this.createSessionEmitter.fire(session);
+        return session;
+    }
+    /**
+     * Follow `uri` without opening it: its update events reach this
+     * connection's client once this resolves. An open would hold the document
+     * for as long as the caller follows it. The watch runs under an id of its
+     * own, `label` plus `#` plus a random UUID, and needs no session: a session
+     * closing the document would also end its own watch of it. Every later
+     * connection that becomes ready gets the watch again. Disposing the handle
+     * unwatches.
+     */
+    async watchDocument(uri, label = 'watch') {
+        const clientId = `${label}#${(0, random_uuid_1.randomUuid)()}`;
+        const server = await this.connected();
+        // Kept only from here: kept during the wait, a generation that became
+        // ready meanwhile would send the watch a second time.
+        this.watches.set(clientId, uri);
+        try {
+            await server.watchModelDocument({ uri, clientId });
+        }
+        catch (error) {
+            this.watches.delete(clientId);
+            throw error;
+        }
+        this.logger.debug(`Watch ${uri} as ${clientId}`);
+        return vscode_jsonrpc_1.Disposable.create(() => {
+            if (!this.watches.delete(clientId)) {
+                return;
+            }
+            // Without a generation the server dropped the watch with its
+            // connection, and one that drops before it is ready drops it too: the
+            // unwatch follows no drop to a connection opened only for it.
+            const generation = this.generation;
+            if (generation) {
+                (generation.ready ??= this.awaitReady(generation)).then(() => {
+                    if (this.generation === generation) {
+                        this.logger.debug(`Unwatch ${uri} as ${clientId}`);
+                        generation.server.unwatchModelDocument({ uri, clientId }).catch(() => undefined);
+                    }
+                }, () => undefined);
+            }
+        });
+    }
+    /**
+     * The client, with its `onDocumentDirtyChanged` passing through
+     * {@link deliverDirty} first, so {@link dirtyStates} holds what the server
+     * told it, and every session hears it through {@link dirtyChangedEmitter};
+     * and with its `onDocumentUpdated` heard by every session through
+     * {@link documentUpdatedEmitter} first. Every other bound method forwards
+     * to the client unchanged, and one the client lacks stays absent, so the
+     * binding still refuses it.
+     */
+    localTarget() {
+        const client = this.client;
+        const hearsDirty = typeof client.onDocumentDirtyChanged === 'function';
+        const hearsUpdates = typeof client.onDocumentUpdated === 'function';
+        if (!hearsDirty && !hearsUpdates) {
+            return this.client;
+        }
+        const target = {};
+        for (const name of this.clientMethods) {
+            const method = client[name];
+            if (typeof method === 'function') {
+                target[name] = (params) => method.call(client, params);
+            }
+        }
+        if (hearsDirty) {
+            target.onDocumentDirtyChanged = (event) => {
+                this.dirtyChangedEmitter.fire(event);
+                this.deliverDirty(event);
+            };
+        }
+        if (hearsUpdates) {
+            const forward = target.onDocumentUpdated;
+            target.onDocumentUpdated = (event) => {
+                this.documentUpdatedEmitter.fire(event);
+                forward(event);
+            };
+        }
+        return target;
+    }
+    /**
+     * Hand a dirty state a restore read to the client, unless it is what
+     * {@link dirtyStates} says the client was last told; a URI it holds
+     * nothing for counts as different.
+     */
+    restoreDirty(event) {
+        if (this.dirtyStates.get(event.uri) !== (event.text?.dirty ?? false)) {
+            this.deliverDirty(event);
+        }
+    }
+    /** Record `event` in {@link dirtyStates} and hand it to the client. */
+    deliverDirty(event) {
+        this.dirtyStates.set(event.uri, event.text?.dirty ?? false);
+        const client = this.client;
+        client.onDocumentDirtyChanged?.(event);
+    }
+    /**
+     * After the transport dropped, reconnect on the next macrotask for the
+     * sessions with documents open, so they re-watch and follow their documents
+     * again without waiting for a call of their own, and connect for what
+     * {@link watchDocument} watches, which {@link generationReady} places
+     * again; a session with nothing open restores on its next call. Nothing is
+     * scheduled once this connection is disposed, which drops its generation
+     * too.
+     */
+    dropGeneration() {
+        const dropped = this.generation !== undefined;
+        super.dropGeneration();
+        if (dropped && !this.disposed) {
+            setTimeout(() => {
+                if (!this.disposed) {
+                    this.reconnectSessions();
+                    if (this.watches.size > 0) {
+                        // One generation, not `connected`, which follows a drop to
+                        // the next: that drop's own timer asks again whether
+                        // anything is still kept. A failure is reported by the gate.
+                        const generation = this.currentGeneration();
+                        (generation.ready ??= this.awaitReady(generation)).catch(() => undefined);
+                    }
+                }
+            }, 0);
+        }
+    }
+    /**
+     * Call `reconnect()` on every session, reporting a throw instead of letting
+     * one session's restore stop the others and the watches after them, and,
+     * inside the readiness gate, fail the whole generation.
+     */
+    reconnectSessions() {
+        for (const session of this.sessions) {
+            try {
+                session.reconnect();
+            }
+            catch (error) {
+                // Reported, so it reaches the user on a port without a logger;
+                // logged too, since only the log names the session.
+                this.reportError(error, (0, primitives_1.resolve)(exports.DATA_CONNECTION_SESSION_RESTORE_FAILED, { detail: (0, primitives_1.describeError)(error) }));
+                this.logger.error(`Could not restore session ${session.clientId}: ${(0, primitives_1.describeError)(error)}`);
+            }
+        }
+    }
+    /**
+     * Restore what the server lost with an earlier generation, whichever
+     * request brought this one up: the documents of sessions that have some
+     * open, and every watch {@link watchDocument} keeps.
+     */
+    generationReady(generation) {
+        super.generationReady(generation);
+        this.reconnectSessions();
+        this.watches.forEach((uri, clientId) => this.watchAgain(generation, clientId, uri));
+        if (this.readyBefore) {
+            this.reconnectEmitter.fire(undefined);
+        }
+        this.readyBefore = true;
+    }
+    /**
+     * Send the watch of `uri` under `clientId` to `generation`, which has just
+     * passed its readiness gate. Sent at once rather than after a wait, so no
+     * drop can come between choosing the generation and sending. A failure is
+     * reported, since no caller waits on it, only while the watch is kept and
+     * `generation` is still current: otherwise the next generation sends it
+     * again.
+     *
+     * Once the watch is in place, the document's dirty state is read and goes
+     * through {@link restoreDirty}, as a session's restore does: a flip while
+     * the connection was down reached no one.
+     */
+    watchAgain(generation, clientId, uri) {
+        generation.server.watchModelDocument({ uri, clientId }).then(() => {
+            if (!this.watches.has(clientId)) {
+                return;
+            }
+            this.logger.debug(`Watch ${uri} again as ${clientId}`);
+            generation.server.getModelDocument({ uri }).then(current => {
+                if (current.text && this.watches.has(clientId)) {
+                    try {
+                        this.restoreDirty({ uri: current.uri, text: current.text });
+                    }
+                    catch {
+                        // The client's listener failed, not the watch, which stays kept.
+                    }
+                }
+            }, () => undefined);
+        }, (error) => {
+            if (!this.watches.has(clientId)) {
+                return;
+            }
+            if (this.generation !== generation) {
+                this.logger.debug(`Watch of ${uri} as ${clientId} cut short by a lost connection; the next one sends it again`);
+                return;
+            }
+            this.reportError(error, (0, primitives_1.resolve)(exports.DATA_CONNECTION_WATCH_RESTORE_FAILED, { uri, detail: (0, primitives_1.describeError)(error) }));
+        });
+    }
+    /**
+     * Sessions are detached rather than disposed: the server ends every session
+     * on a connection it sees close, so ending each one first sends requests
+     * over a connection this call is about to dispose.
+     */
+    dispose() {
+        for (const session of [...this.sessions]) {
+            session.detach();
+        }
+        // For a factory's session whose `detach` does not fire.
+        this.sessions.clear();
+        this.watches.clear();
+        this.createSessionEmitter.dispose();
+        this.reconnectEmitter.dispose();
+        this.dirtyChangedEmitter.dispose();
+        this.documentUpdatedEmitter.dispose();
+        super.dispose();
+    }
+}
+exports.DataConnection = DataConnection;
+/**
+ * A {@link DataConnection} that brings its own {@link DataEvents}, so a host
+ * with several interested parties does not have to supply one.
+ *
+ * **The client slot holds exactly one object, and that is why this exists.**
+ * `createRpcProxy` binds a single `localTarget`, and underneath a method name
+ * maps to one handler — a second registration replaces the first silently. So a
+ * properties panel and a tree cannot both be the client; one fan-out sits in the
+ * slot and both subscribe to it.
+ *
+ * Use {@link DataConnection} directly instead when the client is yours: an
+ * adopter service that implements the protocol plus its own methods, a single
+ * consumer that IS the client, or a request/response-only client that binds
+ * nothing.
+ */
+class DataConnectionWithEvents extends DataConnection {
+    /** Server pushes, fanned out to as many local listeners as the host has. */
+    events;
+    constructor(port, options) {
+        // Built as a local because `this` is unavailable before `super`, then
+        // read back onto the field.
+        const events = new data_events_1.DataEvents();
+        super(port, events, options);
+        this.events = events;
+    }
+    /** Disposes the fan-out it created, which no caller else holds. */
+    dispose() {
+        super.dispose();
+        this.events.dispose();
+    }
+}
+exports.DataConnectionWithEvents = DataConnectionWithEvents;
+//# sourceMappingURL=data-connection.js.map

package/lib/client/data-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-connection.js","sourceRoot":"","sources":["../../src/client/data-connection.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;AAElF,mDAAiE;AACjE,8CAAqD;AACrD,kCASiB;AACjB,sCAA0E;AAE1E,uDAA+E;AAC/E,gDAA4C;AAC5C,gDAA4C;AAE5C,+CAA2C;AAE3C,iDAAsE;AACtE,qDAA4G;AAE5G;;;GAGG;AACU,QAAA,oCAAoC,GAAG,IAAA,0BAAa,EAC9D,yDAAyD,EACzD,6EAA6E,CAC/E,CAAC;AAEF;;;GAGG;AACU,QAAA,sCAAsC,GAAG,IAAA,0BAAa,EAChE,2DAA2D,EAC3D,6EAA6E,CAC/E,CAAC;AAkDF;;;;;;;;;;;;;;GAcG;AACH,oBAIE,SAAQ,8BAA+B;IACnB,QAAQ,GAAG,IAAI,GAAG,EAAmC,CAAC;IACtD,cAAc,CAAyC;IACvD,oBAAoB,GAAG,IAAI,wBAAO,EAAmC,CAAC;IACzF;;;;OAIG;IACM,kBAAkB,GAA2C,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC;IACtG;;;;;;;;OAQG;IACgB,WAAW,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC5D,qEAAqE;IAClD,mBAAmB,GAAG,IAAI,wBAAO,EAAqC,CAAC;IAC1F,wEAAwE;IACrD,sBAAsB,GAAG,IAAI,wBAAO,EAAkE,CAAC;IAC1H;;;;OAIG;IACgB,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvD,mDAAmD;IAChC,MAAM,CAAS;IAClC,oCAAoC;IACjB,gBAAgB,GAAG,IAAI,wBAAO,EAAQ,CAAC;IAC1D;;;;;;OAMG;IACM,cAAc,GAAgB,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;IACnE,mFAAmF;IACzE,WAAW,GAAG,KAAK,CAAC;IAE9B,YAAY,IAAc,EAAE,MAAe,EAAE,GAAG,IAAqD;QAClG,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,IAEtB,CAAC;QACF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE;YACjB,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,8BAAuB;YACnE,0DAA0D;YAC1D,sEAAsE;YACtE,mEAAmE;YACnE,aAAa,EAAE,OAAO,CAAC,aAAa,IAAK,mCAA+E;YACxH,SAAS,EAAE,OAAO;SACpB,CAAC,CAAC;QACH,IAAI,CAAC,cAAc;YAChB,OAAO,CAAC,cAAc,IAAI,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,0BAAW,CAAqB,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACrH,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,wBAAU,EAAE,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACzE,CAAC;IAED;;;;OAIG;IACH,IAAI,YAAY;QACb,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,KAAK,GAAG,SAAS,EAAE,QAAiB;QAC/C,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,EAAE,GAAG,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAA,wBAAU,GAAE,EAAE,CAAC;QAClD,IAAI,iCAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,8BAAqB,CAAC,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,EAAE,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,+BAAsB,CAAC,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAChC,EAAE,EACF;YACG,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE;YACjC,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC;YACnE,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YAC/C,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC;YAChD,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,CAAC,KAAK;YAChD,mBAAmB,EAAE,IAAI,CAAC,sBAAsB,CAAC,KAAK;SACxD,EACD,KAAK,CACP,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3B,uEAAuE;QACvE,6DAA6D;QAC7D,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1D,qEAAqE;QACrE,uEAAuE;QACvE,OAAO,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC;IAClB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,aAAa,CAAC,GAAW,EAAE,KAAK,GAAG,OAAO;QAC7C,MAAM,QAAQ,GAAG,GAAG,KAAK,IAAI,IAAA,wBAAU,GAAE,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,sEAAsE;QACtE,sDAAsD;QACtD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC;YACF,MAAM,MAAM,CAAC,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9B,MAAM,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,OAAO,QAAQ,EAAE,CAAC,CAAC;QACjD,OAAO,2BAAU,CAAC,MAAM,CAAC,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClC,OAAO;YACV,CAAC;YACD,6DAA6D;YAC7D,sEAAsE;YACtE,8DAA8D;YAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;YACnC,IAAI,UAAU,EAAE,CAAC;gBACd,CAAC,UAAU,CAAC,KAAK,KAAK,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CACpD,GAAG,EAAE;oBACF,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;wBAClC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,OAAO,QAAQ,EAAE,CAAC,CAAC;wBACnD,UAAU,CAAC,MAAM,CAAC,oBAAoB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;oBACpF,CAAC;gBACJ,CAAC,EACD,GAAG,EAAE,CAAC,SAAS,CACjB,CAAC;YACL,CAAC;QACJ,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;;;;;;OAQG;IACgB,WAAW;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAA4C,CAAC;QACjE,MAAM,UAAU,GAAG,OAAO,MAAM,CAAC,sBAAsB,KAAK,UAAU,CAAC;QACvE,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC,iBAAiB,KAAK,UAAU,CAAC;QACpE,IAAI,CAAC,UAAU,IAAI,CAAC,YAAY,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,MAAM,CAAC;QACtB,CAAC;QACD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACrC,MAAM,MAAM,GAAY,MAAM,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;gBAChC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAe,EAAW,EAAE,CAAE,MAAuC,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC9G,CAAC;QACJ,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACd,MAAM,CAAC,sBAAsB,GAAG,CAAC,KAAwC,EAAQ,EAAE;gBAChF,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACrC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC,CAAC;QACL,CAAC;QACD,IAAI,YAAY,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,MAAM,CAAC,iBAAoG,CAAC;YAC5H,MAAM,CAAC,iBAAiB,GAAG,CAAC,KAAqE,EAAQ,EAAE;gBACxG,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACxC,OAAO,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAA4B,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACO,YAAY,CAAC,KAAwC;QAC5D,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,EAAE,CAAC;YACpE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACJ,CAAC;IAED,uEAAuE;IAC7D,YAAY,CAAC,KAAwC;QAC5D,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,MAA2F,CAAC;QAChH,MAAM,CAAC,sBAAsB,EAAE,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;OAQG;IACgB,cAAc;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC;QAC9C,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7B,UAAU,CAAC,GAAG,EAAE;gBACb,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAClB,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBACzB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;wBACzB,2DAA2D;wBAC3D,qDAAqD;wBACrD,6DAA6D;wBAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;wBAC5C,CAAC,UAAU,CAAC,KAAK,KAAK,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;oBAC7E,CAAC;gBACJ,CAAC;YACJ,CAAC,EAAE,CAAC,CAAC,CAAC;QACT,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACO,iBAAiB;QACxB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,IAAI,CAAC;gBACF,OAAO,CAAC,SAAS,EAAE,CAAC;YACvB,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACvB,+DAA+D;gBAC/D,oDAAoD;gBACpD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAA,oBAAO,EAAC,QAAA,sCAAsC,EAAE,EAAE,MAAM,EAAE,IAAA,0BAAa,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC3G,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,OAAO,CAAC,QAAQ,KAAK,IAAA,0BAAa,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC/F,CAAC;QACJ,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACgB,eAAe,CAAC,UAA4C;QAC5E,KAAK,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAClC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;QACpF,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED;;;;;;;;;;;OAWG;IACO,UAAU,CAAC,UAA4C,EAAE,QAAgB,EAAE,GAAW;QAC7F,UAAU,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,CACzD,GAAG,EAAE;YACF,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,OAAO;YACV,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,aAAa,QAAQ,EAAE,CAAC,CAAC;YACvD,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAC7C,OAAO,CAAC,EAAE;gBACP,IAAI,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC9C,IAAI,CAAC;wBACF,IAAI,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC/D,CAAC;oBAAC,MAAM,CAAC;wBACN,iEAAiE;oBACpE,CAAC;gBACJ,CAAC;YACJ,CAAC,EACD,GAAG,EAAE,CAAC,SAAS,CACjB,CAAC;QACL,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YAChB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,OAAO;YACV,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBAClC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,OAAO,QAAQ,8DAA8D,CAAC,CAAC;gBAChH,OAAO;YACV,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAA,oBAAO,EAAC,QAAA,oCAAoC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,IAAA,0BAAa,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACjH,CAAC,CACH,CAAC;IACL,CAAC;IAED;;;;OAIG;IACM,OAAO;QACb,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,CAAC;QACD,wDAAwD;QACxD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAChC,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,CAAC;QACtC,KAAK,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC;CACH;;AAED;;;;;;;;;;;;;;GAcG;AACH,8BAGE,SAAQ,cAAoG;IAC3G,4EAA4E;IACnE,MAAM,CAAmE;IAElF,YAAY,IAAc,EAAE,OAAmD;QAC5E,sEAAsE;QACtE,4BAA4B;QAC5B,MAAM,MAAM,GAAG,IAAI,wBAAU,EAAwD,CAAC;QACtF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,mEAAmE;IAC1D,OAAO;QACb,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;CACH"}

package/lib/client/data-events.d.ts

@@ -7,7 +7,7 @@
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
 import { Emitter, type Event } from 'vscode-jsonrpc';
-import type { DataClientProtocol, ProjectsChangedEvent, TransferDocumentSavedEvent, TransferDocumentUpdatedEvent } from '../data';
+import type { DataClientProtocol, ProjectsChangedEvent, TransferDocumentDeletedEvent, TransferDocumentDirtyChangedEvent, TransferDocumentSavedEvent, TransferDocumentsBuiltEvent, TransferDocumentUpdatedEvent } from '../data';
 import type { Project } from '../project';
 import type { TransferDiagnostic } from '../transfer-diagnostic';
 import type { TransferElement } from '../transfer-element';
@@ -34,15 +34,27 @@ import type { TransferElement } from '../transfer-element';
 export declare class DataEvents<TTransfer extends TransferElement, TDiagnostic extends TransferDiagnostic = TransferDiagnostic, TProject extends Project = Project> implements DataClientProtocol<TTransfer, TDiagnostic, TProject> {
     protected readonly documentUpdatedEmitter: Emitter<TransferDocumentUpdatedEvent<TTransfer, TDiagnostic>>;
     protected readonly documentSavedEmitter: Emitter<TransferDocumentSavedEvent<TTransfer, TDiagnostic>>;
+    protected readonly documentDirtyChangedEmitter: Emitter<TransferDocumentDirtyChangedEvent>;
+    protected readonly documentDeletedEmitter: Emitter<TransferDocumentDeletedEvent>;
+    protected readonly documentsBuiltEmitter: Emitter<TransferDocumentsBuiltEvent>;
     protected readonly projectsChangedEmitter: Emitter<ProjectsChangedEvent<TProject>>;
     /** A build-phase event for a watched document. Carries the originating `sourceClientId`. */
     readonly onDidUpdateDocument: Event<TransferDocumentUpdatedEvent<TTransfer, TDiagnostic>>;
     /** A watched document was persisted to disk. */
     readonly onDidSaveDocument: Event<TransferDocumentSavedEvent<TTransfer, TDiagnostic>>;
+    /** A watched document's text started or stopped differing from its file. */
+    readonly onDidChangeDocumentDirty: Event<TransferDocumentDirtyChangedEvent>;
+    /** A document's backing file was removed, watched or not. Any watch survives. */
+    readonly onDidDeleteDocument: Event<TransferDocumentDeletedEvent>;
+    /** Documents built that nobody watches — re-read anything derived from them. */
+    readonly onDidBuildDocuments: Event<TransferDocumentsBuiltEvent>;
     /** The project set changed. */
     readonly onDidChangeProjects: Event<ProjectsChangedEvent<TProject>>;
     onDocumentUpdated(event: TransferDocumentUpdatedEvent<TTransfer, TDiagnostic>): void;
     onDocumentSaved(event: TransferDocumentSavedEvent<TTransfer, TDiagnostic>): void;
+    onDocumentDirtyChanged(event: TransferDocumentDirtyChangedEvent): void;
+    onDocumentDeleted(event: TransferDocumentDeletedEvent): void;
+    onDocumentsBuilt(event: TransferDocumentsBuiltEvent): void;
     onProjectsChanged(event: ProjectsChangedEvent<TProject>): void;
     dispose(): void;
 }

package/lib/client/data-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-events.d.ts","sourceRoot":"","sources":["../../src/client/data-events.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAClI,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,UAAU,CACpB,SAAS,SAAS,eAAe,EACjC,WAAW,SAAS,kBAAkB,GAAG,kBAAkB,EAC3D,QAAQ,SAAS,OAAO,GAAG,OAAO,CACnC,YAAW,kBAAkB,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC;IAC9D,SAAS,CAAC,QAAQ,CAAC,sBAAsB,gEAAuE;IAChH,SAAS,CAAC,QAAQ,CAAC,oBAAoB,8DAAqE;IAC5G,SAAS,CAAC,QAAQ,CAAC,sBAAsB,0CAAiD;IAE1F,4FAA4F;IAC5F,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,4BAA4B,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAqC;IAC9H,gDAAgD;IAChD,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAC,0BAA0B,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAmC;IACxH,+BAA+B;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAqC;IAIxG,iBAAiB,CAAC,KAAK,EAAE,4BAA4B,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG,IAAI;IAIpF,eAAe,CAAC,KAAK,EAAE,0BAA0B,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG,IAAI;IAIhF,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAAG,IAAI;IAI9D,OAAO,IAAI,IAAI;CAKjB"}
+{"version":3,"file":"data-events.d.ts","sourceRoot":"","sources":["../../src/client/data-events.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EACT,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,iCAAiC,EACjC,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC9B,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,UAAU,CACpB,SAAS,SAAS,eAAe,EACjC,WAAW,SAAS,kBAAkB,GAAG,kBAAkB,EAC3D,QAAQ,SAAS,OAAO,GAAG,OAAO,CACnC,YAAW,kBAAkB,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC;IAC9D,SAAS,CAAC,QAAQ,CAAC,sBAAsB,gEAAuE;IAChH,SAAS,CAAC,QAAQ,CAAC,oBAAoB,8DAAqE;IAC5G,SAAS,CAAC,QAAQ,CAAC,2BAA2B,6CAAoD;IAClG,SAAS,CAAC,QAAQ,CAAC,sBAAsB,wCAA+C;IACxF,SAAS,CAAC,QAAQ,CAAC,qBAAqB,uCAA8C;IACtF,SAAS,CAAC,QAAQ,CAAC,sBAAsB,0CAAiD;IAE1F,4FAA4F;IAC5F,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,4BAA4B,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAqC;IAC9H,gDAAgD;IAChD,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAC,0BAA0B,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAmC;IACxH,4EAA4E;IAC5E,QAAQ,CAAC,wBAAwB,EAAE,KAAK,CAAC,iCAAiC,CAAC,CAA0C;IACrH,iFAAiF;IACjF,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,4BAA4B,CAAC,CAAqC;IACtG,gFAAgF;IAChF,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,2BAA2B,CAAC,CAAoC;IACpG,+BAA+B;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAqC;IAIxG,iBAAiB,CAAC,KAAK,EAAE,4BAA4B,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG,IAAI,CAEnF;IAED,eAAe,CAAC,KAAK,EAAE,0BAA0B,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG,IAAI,CAE/E;IAED,sBAAsB,CAAC,KAAK,EAAE,iCAAiC,GAAG,IAAI,CAErE;IAED,iBAAiB,CAAC,KAAK,EAAE,4BAA4B,GAAG,IAAI,CAE3D;IAED,gBAAgB,CAAC,KAAK,EAAE,2BAA2B,GAAG,IAAI,CAEzD;IAED,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAE7D;IAED,OAAO,IAAI,IAAI,CAOd;CACH"}

package/lib/client/data-events.js

@@ -33,11 +33,20 @@ const vscode_jsonrpc_1 = require("vscode-jsonrpc");
 class DataEvents {
     documentUpdatedEmitter = new vscode_jsonrpc_1.Emitter();
     documentSavedEmitter = new vscode_jsonrpc_1.Emitter();
+    documentDirtyChangedEmitter = new vscode_jsonrpc_1.Emitter();
+    documentDeletedEmitter = new vscode_jsonrpc_1.Emitter();
+    documentsBuiltEmitter = new vscode_jsonrpc_1.Emitter();
     projectsChangedEmitter = new vscode_jsonrpc_1.Emitter();
     /** A build-phase event for a watched document. Carries the originating `sourceClientId`. */
     onDidUpdateDocument = this.documentUpdatedEmitter.event;
     /** A watched document was persisted to disk. */
     onDidSaveDocument = this.documentSavedEmitter.event;
+    /** A watched document's text started or stopped differing from its file. */
+    onDidChangeDocumentDirty = this.documentDirtyChangedEmitter.event;
+    /** A document's backing file was removed, watched or not. Any watch survives. */
+    onDidDeleteDocument = this.documentDeletedEmitter.event;
+    /** Documents built that nobody watches — re-read anything derived from them. */
+    onDidBuildDocuments = this.documentsBuiltEmitter.event;
     /** The project set changed. */
     onDidChangeProjects = this.projectsChangedEmitter.event;
     // --- DataClientProtocol (wire names) ---
@@ -47,12 +56,24 @@ class DataEvents {
     onDocumentSaved(event) {
         this.documentSavedEmitter.fire(event);
     }
+    onDocumentDirtyChanged(event) {
+        this.documentDirtyChangedEmitter.fire(event);
+    }
+    onDocumentDeleted(event) {
+        this.documentDeletedEmitter.fire(event);
+    }
+    onDocumentsBuilt(event) {
+        this.documentsBuiltEmitter.fire(event);
+    }
     onProjectsChanged(event) {
         this.projectsChangedEmitter.fire(event);
     }
     dispose() {
         this.documentUpdatedEmitter.dispose();
         this.documentSavedEmitter.dispose();
+        this.documentDirtyChangedEmitter.dispose();
+        this.documentDeletedEmitter.dispose();
+        this.documentsBuiltEmitter.dispose();
         this.projectsChangedEmitter.dispose();
     }
 }

package/lib/client/data-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-events.js","sourceRoot":"","sources":["../../src/client/data-events.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;AAElF,mDAAqD;AAMrD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,UAAU;IAKD,sBAAsB,GAAG,IAAI,wBAAO,EAAwD,CAAC;IAC7F,oBAAoB,GAAG,IAAI,wBAAO,EAAsD,CAAC;IACzF,sBAAsB,GAAG,IAAI,wBAAO,EAAkC,CAAC;IAE1F,4FAA4F;IACnF,mBAAmB,GAAgE,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC;IAC9H,gDAAgD;IACvC,iBAAiB,GAA8D,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC;IACxH,+BAA+B;IACtB,mBAAmB,GAA0C,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC;IAExG,0CAA0C;IAE1C,iBAAiB,CAAC,KAA2D;QAC1E,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,eAAe,CAAC,KAAyD;QACtE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,iBAAiB,CAAC,KAAqC;QACpD,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO;QACJ,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,CAAC;QACtC,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,CAAC;IACzC,CAAC;CACH;AAnCD,gCAmCC"}
+{"version":3,"file":"data-events.js","sourceRoot":"","sources":["../../src/client/data-events.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;AAElF,mDAAqD;AAcrD;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAKsB,sBAAsB,GAAG,IAAI,wBAAO,EAAwD,CAAC;IAC7F,oBAAoB,GAAG,IAAI,wBAAO,EAAsD,CAAC;IACzF,2BAA2B,GAAG,IAAI,wBAAO,EAAqC,CAAC;IAC/E,sBAAsB,GAAG,IAAI,wBAAO,EAAgC,CAAC;IACrE,qBAAqB,GAAG,IAAI,wBAAO,EAA+B,CAAC;IACnE,sBAAsB,GAAG,IAAI,wBAAO,EAAkC,CAAC;IAE1F,4FAA4F;IACnF,mBAAmB,GAAgE,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC;IAC9H,gDAAgD;IACvC,iBAAiB,GAA8D,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC;IACxH,4EAA4E;IACnE,wBAAwB,GAA6C,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC;IACrH,iFAAiF;IACxE,mBAAmB,GAAwC,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC;IACtG,gFAAgF;IACvE,mBAAmB,GAAuC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC;IACpG,+BAA+B;IACtB,mBAAmB,GAA0C,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC;IAExG,0CAA0C;IAE1C,iBAAiB,CAAC,KAA2D;QAC1E,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,eAAe,CAAC,KAAyD;QACtE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,sBAAsB,CAAC,KAAwC;QAC5D,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,iBAAiB,CAAC,KAAmC;QAClD,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,gBAAgB,CAAC,KAAkC;QAChD,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,iBAAiB,CAAC,KAAqC;QACpD,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO;QACJ,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,CAAC;QACtC,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,CAAC,2BAA2B,CAAC,OAAO,EAAE,CAAC;QAC3C,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,CAAC;QACtC,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,CAAC;IACzC,CAAC;CACH"}

package/lib/client/data-port.d.ts

@@ -7,14 +7,20 @@
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
 import type { Event, MessageConnection } from 'vscode-jsonrpc';
+import type { Logger } from '../logger';
+import type { ResolvedMessage } from '../messages/primitives';
+import type { RpcConnectionLifecycle } from './rpc-connection';
 /**
  * The one thing a host has to supply for the data head: a live JSON-RPC
- * connection to the data server, plus the identity and failure sink that go
- * with it.
+ * connection to the data server, plus the failure sink that goes with it.
  *
- * "Port" in the hexagonal sense — the host implements it, `DataSession`
+ * "Port" in the hexagonal sense — the host implements it, `DataConnection`
  * consumes it, and nothing on either side of the boundary imports the other.
  *
+ * Carries no identity. A `clientId` names a participant, and one transport
+ * serves as many as the host has; binding an identity here is what makes two
+ * of them share one, so it lives on `DataSession` instead.
+ *
  * **This deliberately does NOT wrap the protocol methods.** `createRpcProxy`
  * already takes a promise of a connection and produces the whole typed
  * `DataServerProtocol` surface, so wrapping it would re-derive the framework's
@@ -22,7 +28,7 @@ import type { Event, MessageConnection } from 'vscode-jsonrpc';
  * method allowlists, which cannot drift. Everything a form or a tree actually
  * does — the wire contract, the open/watch/update/close sequence, `baseVersion`
  * conflict handling, echo filtering by `sourceClientId` — is host-invariant and
- * lives above this interface. What varies between hosts is exactly the four
+ * lives above this interface. What varies between hosts is exactly the
  * members below.
  *
  * **Why the transport hop and not merely the protocol.** In a Theia frontend
@@ -43,21 +49,6 @@ import type { Event, MessageConnection } from 'vscode-jsonrpc';
  *   calls on the promise but never calls `listen` itself.
  */
 export interface DataPort {
-    /**
-     * Stable identity of this client on the data server, passed as `clientId`
-     * on every document request.
-     *
-     * It has to be stable for the session because it is the echo key: an
-     * inbound `onDocumentUpdated` carries the originating mutation's
-     * `clientId` as `sourceClientId`, and a client that cannot recognise its
-     * own echo treats its own write as a concurrent third-party one. It also
-     * has to be distinct per client, since it keys the server's per-
-     * `(uri, clientId)` watch bucket.
-     *
-     * Avoid the three values the framework itself uses as sentinels —
-     * `'language-client'`, `'unknown'` and `'revert-on-close'`.
-     */
-    readonly clientId: string;
     /**
      * Open the transport and hand back a listening `MessageConnection`.
      *
@@ -73,10 +64,18 @@ export interface DataPort {
      *
      * It exists because the alternative is worse in both directions: this tier
      * cannot import a host's UI, and swallowing the error makes a dead
-     * connection look like an empty model. `context` names what was being
-     * attempted, not where in the code it happened.
+     * connection look like an empty model.
+     *
+     * `reported` is a complete sentence plus the identity needed to render it in
+     * another language. It carries a value rather than using a protocol field
+     * because this tier does not know whether a process hop intervenes — in a
+     * webview host the render happens across one — and a `ResolvedMessage` is
+     * structured-clone safe either way. Render it with `renderFrameworkMessage`;
+     * passing no translation map yields the English.
      */
-    reportError(error: unknown, context: string): void;
+    reportError(error: unknown, reported: ResolvedMessage): void;
+    /** Where a connection over this port logs what it does on its own. Without one it logs nothing. */
+    readonly logger?: Logger;
     /**
      * Fires when the host tears the transport down and the current connection
      * is no longer usable — a language-server restart being the case that
@@ -91,5 +90,11 @@ export interface DataPort {
      * `Disposable` on the *wire* would not be.
      */
     readonly onDispose: Event<void>;
+    /**
+     * Called for each connection generation, beside the lifecycle the
+     * connection's options pass, so a host reporting its connections itself
+     * does so without every connection built over it passing this on.
+     */
+    readonly connectionLifecycle?: RpcConnectionLifecycle;
 }
 //# sourceMappingURL=data-port.d.ts.map

package/lib/client/data-port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-port.d.ts","sourceRoot":"","sources":["../../src/client/data-port.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,WAAW,QAAQ;IACtB;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;;;;OAOG;IACH,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEtC;;;;;;;;OAQG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnD;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;CAClC"}
+{"version":3,"file":"data-port.d.ts","sourceRoot":"","sources":["../../src/client/data-port.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,WAAW,QAAQ;IACtB;;;;;;;OAOG;IACH,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEtC;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IAE7D,mGAAmG;IACnG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,sBAAsB,CAAC;CACxD"}