@hydranium/client-theia 1.0.0-next.13 → 1.0.0-next.135

package/lib/browser/editor-disk-sync.js

@@ -0,0 +1,232 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EditorDiskSync = void 0;
+exports.isResyncableEditorDocument = isResyncableEditorDocument;
+const protocol_1 = require("@hydranium/protocol");
+const logger_1 = require("@theia/core/lib/common/logger");
+const uri_1 = __importDefault(require("@theia/core/lib/common/uri"));
+const inversify_1 = require("@theia/core/shared/inversify");
+const editor_manager_1 = require("@theia/editor/lib/browser/editor-manager");
+const file_service_1 = require("@theia/filesystem/lib/browser/file-service");
+const clock_1 = require("../common/clock");
+/** Whether `document` carries the members of {@link ResyncableEditorDocument}. */
+function isResyncableEditorDocument(document) {
+    return ('uri' in document &&
+        typeof document.uri === 'string' &&
+        'dirty' in document &&
+        'getText' in document &&
+        typeof document.getText === 'function' &&
+        'revert' in document &&
+        typeof document.revert === 'function' &&
+        'contentChanges' in document &&
+        Array.isArray(document.contentChanges) &&
+        'resourceVersion' in document &&
+        'run' in document &&
+        typeof document.run === 'function' &&
+        'onModelWillSaveModel' in document &&
+        typeof document.onModelWillSaveModel === 'function');
+}
+/**
+ * Keeps a dirty editor's save from applying edits its file already holds, as
+ * the file does once the server saves a document the editor shows unsaved.
+ *
+ * Theia keeps such an editor dirty, and its next save corrupts the file: the
+ * save applies the editor's pending edits to the file rather than writing the
+ * whole text, and the file already holds them, so each is applied twice.
+ * Theia's check that the file has not changed since the editor read it passes
+ * whenever the new file has the old one's size, so no conflict is reported. A
+ * revert alone keeps the pending edits.
+ *
+ * Before each save of the editor it reads the file. When the file holds the
+ * text the buffer held as the save began, it drops the edits pending then and
+ * has the save expect the file's version, so the save writes only the edits
+ * made after that point, a save participant's included, onto the file as it
+ * is. The save is not cancelled: it completes and is reported as saved. Save
+ * All relies on this check, since it saves a diagram and then an editor on the
+ * same file at once, before the file watcher has reported the diagram's write.
+ * The buffer is taken when the save calls its will-save listeners. Theia runs
+ * its save participants one after another, each behind an await, and its
+ * first one awaits before it edits, so none has changed the buffer by then. A
+ * participant ordered ahead of it that edits before its first await makes the
+ * file and the taken text differ, and the save applies every edit again.
+ *
+ * On each change the file watcher reports, it marks the editor clean when the
+ * file holds exactly its buffer. The file is compared with the buffer after
+ * it has been read, and the editor is marked in the same step, so a keystroke
+ * made while the file was read leaves the editor dirty. This sync waits behind
+ * a save in flight: that save drops the edits it sent from the pending ones
+ * when it finishes, and a sync before then would have it drop the edits typed
+ * meanwhile.
+ *
+ * An editor whose file holds neither text is left to Theia's own save,
+ * same-size gap included, and so is one whose file cannot be read within
+ * {@link readTimeoutMs}, or whose check throws.
+ *
+ * The adopter binds it as a `FrontendApplicationContribution`.
+ */
+let EditorDiskSync = class EditorDiskSync {
+    fileService;
+    editorManager;
+    logger;
+    /** Times {@link readTimeoutMs}: the container's {@link Clock}, or a `SystemClock`. */
+    clock = new protocol_1.SystemClock();
+    /** Whether an editor's document has failed {@link isResyncableEditorDocument}; warned of once. */
+    warnedUnsyncable = false;
+    /**
+     * How long a check waits for the file. The editor's save, and every later
+     * save and sync of that editor, waits for the check.
+     */
+    readTimeoutMs = 1_000;
+    onStart() {
+        this.fileService.onDidFilesChange(event => {
+            for (const change of event.changes) {
+                this.checkFile(change.resource);
+            }
+        });
+        this.editorManager.onCreated(widget => this.guardSaves(widget));
+        for (const widget of this.editorManager.all) {
+            this.guardSaves(widget);
+        }
+    }
+    /** Check `widget`'s document before each of its saves, for as long as the widget lives. */
+    guardSaves(widget) {
+        const document = this.resyncable(widget.editor.document);
+        if (document) {
+            const registration = document.onModelWillSaveModel(() => this.isolate(() => this.dropChangesOnDisk(document)));
+            widget.onDidDispose(() => registration.dispose());
+        }
+    }
+    /** Check each dirty document an editor shows on `uri`, behind that document's save in flight. */
+    checkFile(uri) {
+        for (const document of this.dirtyDocuments(uri)) {
+            void document.run(() => this.isolate(() => this.syncIfOnDisk(document)));
+        }
+    }
+    /** Read the file of `document` if it is dirty, and sync it if the file holds its buffer. */
+    async syncIfOnDisk(document) {
+        if (!document.dirty) {
+            return;
+        }
+        const content = await this.readFile(document);
+        if (content && document.getText() === content.value) {
+            this.syncFromDisk(document, { etag: content.etag, mtime: content.mtime, encoding: content.encoding });
+        }
+    }
+    /**
+     * Before a save of `document`, drop the edits pending now if its file holds
+     * the buffer as it is now, and take the file's version. The buffer and the
+     * count are taken before the first await, while the save is still calling
+     * its will-save listeners; an edit made after that stays pending, and the
+     * save writes it onto the file.
+     */
+    async dropChangesOnDisk(document) {
+        if (!document.dirty) {
+            return;
+        }
+        const text = document.getText();
+        const pending = document.contentChanges.length;
+        const content = await this.readFile(document);
+        if (content?.value === text) {
+            document.contentChanges.splice(0, pending);
+            document.resourceVersion = { etag: content.etag, mtime: content.mtime, encoding: content.encoding };
+        }
+    }
+    /**
+     * The file of `document`, or `undefined` when it is gone, cannot be read, or
+     * is not read within {@link readTimeoutMs}.
+     */
+    async readFile(document) {
+        const read = this.fileService.read(new uri_1.default(document.uri)).catch(() => undefined);
+        const content = await this.clock.raceTimer(read, this.readTimeoutMs);
+        return content === protocol_1.TIMED_OUT ? undefined : content;
+    }
+    /**
+     * Run `check`, and log its failure rather than pass it on. A will-save
+     * listener that rejects makes Theia drop the save without writing, and a
+     * sync that rejects goes unhandled.
+     */
+    async isolate(check) {
+        try {
+            await check();
+        }
+        catch (err) {
+            void this.logger.error('EditorDiskSync: checking an editor against its file failed; the editor is left as it is.', err);
+        }
+    }
+    /** The dirty documents open in an editor on `uri`, each once however many editors show it. */
+    dirtyDocuments(uri) {
+        const target = uri.toString();
+        const documents = new Set();
+        for (const widget of this.editorManager.all) {
+            const document = this.resyncable(widget.editor.document);
+            if (document && document.uri === target && document.dirty) {
+                documents.add(document);
+            }
+        }
+        return [...documents];
+    }
+    /** `document` if it carries the members the sync resets; otherwise `undefined`, warned of once. */
+    resyncable(document) {
+        if (isResyncableEditorDocument(document)) {
+            return document;
+        }
+        if (!this.warnedUnsyncable) {
+            this.warnedUnsyncable = true;
+            void this.logger.warn('EditorDiskSync: an editor document lacks the Monaco model members the sync resets, so such editors are not synced with their files.');
+        }
+        return undefined;
+    }
+    /**
+     * Take `version` as the file `document` was last saved to, with nothing
+     * pending, and mark it clean. Synchronous throughout: a soft revert only
+     * marks the document clean, and reads nothing. The revert also cancels a
+     * save queued behind the sync, which would have written the same text.
+     */
+    syncFromDisk(document, version) {
+        document.contentChanges.splice(0, document.contentChanges.length);
+        document.resourceVersion = version;
+        void document.revert({ soft: true });
+    }
+};
+exports.EditorDiskSync = EditorDiskSync;
+__decorate([
+    (0, inversify_1.inject)(file_service_1.FileService),
+    __metadata("design:type", file_service_1.FileService)
+], EditorDiskSync.prototype, "fileService", void 0);
+__decorate([
+    (0, inversify_1.inject)(editor_manager_1.EditorManager),
+    __metadata("design:type", editor_manager_1.EditorManager)
+], EditorDiskSync.prototype, "editorManager", void 0);
+__decorate([
+    (0, inversify_1.inject)(logger_1.ILogger),
+    __metadata("design:type", Object)
+], EditorDiskSync.prototype, "logger", void 0);
+__decorate([
+    (0, inversify_1.inject)(clock_1.Clock),
+    (0, inversify_1.optional)(),
+    __metadata("design:type", Object)
+], EditorDiskSync.prototype, "clock", void 0);
+exports.EditorDiskSync = EditorDiskSync = __decorate([
+    (0, inversify_1.injectable)()
+], EditorDiskSync);
+//# sourceMappingURL=editor-disk-sync.js.map

package/lib/browser/editor-disk-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-disk-sync.js","sourceRoot":"","sources":["../../src/browser/editor-disk-sync.ts"],"names":[],"mappings":"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"}

package/lib/browser/hydranium-file-service.d.ts

@@ -0,0 +1,44 @@
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import type URI from '@theia/core/lib/common/uri';
+import { FileService, type UpdateTextFileOptions } from '@theia/filesystem/lib/browser/file-service';
+/**
+ * Theia's `FileService`, refusing an incremental save once the file has
+ * changed since the editor read it.
+ *
+ * Theia's own check, which `write` and `update` share, passes a file whose
+ * mtime moved on when its size still matches the etag the editor read. That
+ * is safe for `write`, which replaces the file with the whole text, but
+ * `update` applies the editor's pending edits to the file as it is, so after a
+ * same-size change, the server saving those very edits included, it applies
+ * them a second time. Here `update` hands that check the etag with a `!`
+ * appended, which no file's etag can match: Theia writes an etag as the mtime
+ * in base 29 followed by the size in base 31, digits and lower-case letters
+ * only. An advanced mtime is then enough for Theia to refuse with its
+ * `FILE_MODIFIED_SINCE`. The editor's save then falls back to `write` with the
+ * whole text, which Theia checks as before: it writes when the size is
+ * unchanged, and asks the user otherwise. A same-size change by another
+ * process is therefore overwritten by that write rather than merged with the
+ * editor's edits. `write` is left as it is.
+ *
+ * It is the safety net behind `EditorDiskSync`, which acts only when the
+ * file holds the editor's buffer: a file holding some of the edits, as when a
+ * save participant ordered ahead of Theia's first one edits before its first
+ * await, is left to this check.
+ *
+ * A write within the file system's mtime resolution of the read goes unseen,
+ * as it does for Theia's own check. A file whose mtime moves while its text
+ * stays the same costs a whole-text write rather than the edits.
+ *
+ * The adopter binds it with `rebind(FileService).to(HydraniumFileService).inSingletonScope()`.
+ */
+export declare class HydraniumFileService extends FileService {
+    update(resource: URI, changes: Parameters<FileService['update']>[1], options: UpdateTextFileOptions): ReturnType<FileService['update']>;
+}
+//# sourceMappingURL=hydranium-file-service.d.ts.map

package/lib/browser/hydranium-file-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydranium-file-service.d.ts","sourceRoot":"","sources":["../../src/browser/hydranium-file-service.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,GAAG,MAAM,4BAA4B,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,KAAK,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAGrG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBACa,oBAAqB,SAAQ,WAAW;IACzC,MAAM,CACZ,QAAQ,EAAE,GAAG,EACb,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAC7C,OAAO,EAAE,qBAAqB,GAC9B,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;CAKtC"}

package/lib/browser/hydranium-file-service.js

@@ -0,0 +1,61 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HydraniumFileService = void 0;
+const inversify_1 = require("@theia/core/shared/inversify");
+const file_service_1 = require("@theia/filesystem/lib/browser/file-service");
+const files_1 = require("@theia/filesystem/lib/common/files");
+/**
+ * Theia's `FileService`, refusing an incremental save once the file has
+ * changed since the editor read it.
+ *
+ * Theia's own check, which `write` and `update` share, passes a file whose
+ * mtime moved on when its size still matches the etag the editor read. That
+ * is safe for `write`, which replaces the file with the whole text, but
+ * `update` applies the editor's pending edits to the file as it is, so after a
+ * same-size change, the server saving those very edits included, it applies
+ * them a second time. Here `update` hands that check the etag with a `!`
+ * appended, which no file's etag can match: Theia writes an etag as the mtime
+ * in base 29 followed by the size in base 31, digits and lower-case letters
+ * only. An advanced mtime is then enough for Theia to refuse with its
+ * `FILE_MODIFIED_SINCE`. The editor's save then falls back to `write` with the
+ * whole text, which Theia checks as before: it writes when the size is
+ * unchanged, and asks the user otherwise. A same-size change by another
+ * process is therefore overwritten by that write rather than merged with the
+ * editor's edits. `write` is left as it is.
+ *
+ * It is the safety net behind `EditorDiskSync`, which acts only when the
+ * file holds the editor's buffer: a file holding some of the edits, as when a
+ * save participant ordered ahead of Theia's first one edits before its first
+ * await, is left to this check.
+ *
+ * A write within the file system's mtime resolution of the read goes unseen,
+ * as it does for Theia's own check. A file whose mtime moves while its text
+ * stays the same costs a whole-text write rather than the edits.
+ *
+ * The adopter binds it with `rebind(FileService).to(HydraniumFileService).inSingletonScope()`.
+ */
+let HydraniumFileService = class HydraniumFileService extends file_service_1.FileService {
+    update(resource, changes, options) {
+        const strict = typeof options.etag === 'string' && options.etag !== files_1.ETAG_DISABLED ? { ...options, etag: `${options.etag}!` } : options;
+        return super.update(resource, changes, strict);
+    }
+};
+exports.HydraniumFileService = HydraniumFileService;
+exports.HydraniumFileService = HydraniumFileService = __decorate([
+    (0, inversify_1.injectable)()
+], HydraniumFileService);
+//# sourceMappingURL=hydranium-file-service.js.map

package/lib/browser/hydranium-file-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydranium-file-service.js","sourceRoot":"","sources":["../../src/browser/hydranium-file-service.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;AAGlF,4DAA0D;AAC1D,6EAAqG;AACrG,8DAAmE;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,0BAAW;IACzC,MAAM,CACZ,QAAa,EACb,OAA6C,EAC7C,OAA8B;QAE9B,MAAM,MAAM,GACT,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,qBAAa,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC3H,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;CACH,CAAA;AAVY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,sBAAU,GAAE;GACA,oBAAoB,CAUhC"}

package/lib/browser/index.d.ts

@@ -10,4 +10,8 @@ export * from './channel-logger';
 export * from './log-level-preference';
 export * from './browser-capture';
 export * from './memory-diagnostics-contribution';
+export * from './session-aware-connection-source';
+export * from './connection-diagnostics-contribution';
+export * from './editor-disk-sync';
+export * from './hydranium-file-service';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC"}

package/lib/browser/index.js

@@ -27,4 +27,8 @@ __exportStar(require("./channel-logger"), exports);
 __exportStar(require("./log-level-preference"), exports);
 __exportStar(require("./browser-capture"), exports);
 __exportStar(require("./memory-diagnostics-contribution"), exports);
+__exportStar(require("./session-aware-connection-source"), exports);
+__exportStar(require("./connection-diagnostics-contribution"), exports);
+__exportStar(require("./editor-disk-sync"), exports);
+__exportStar(require("./hydranium-file-service"), exports);
 //# sourceMappingURL=index.js.map

package/lib/browser/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,gFAAgF;AAChF,mDAAiC;AACjC,yDAAuC;AACvC,oDAAkC;AAClC,oEAAkD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,gFAAgF;AAChF,mDAAiC;AACjC,yDAAuC;AACvC,oDAAkC;AAClC,oEAAkD;AAClD,oEAAkD;AAClD,wEAAsD;AACtD,qDAAmC;AACnC,2DAAyC"}

package/lib/browser/log-level-preference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-level-preference.d.ts","sourceRoot":"","sources":["../../src/browser/log-level-preference.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,oBAAoB,EAAyB,MAAM,qBAAqB,CAAC;AAIlF,OAAO,EAAE,+BAA+B,EAAE,MAAM,2DAA2D,CAAC;AAC5G,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAC1F,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAEnF,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,eAA+B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBACa,8BAA+B,YAAW,+BAA+B;IACvD,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAG,MAAM,CAAC;IAC5C,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAG,iBAAiB,CAAC;IAC7D,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAG,OAAO,CAAC;IAErD;;gEAE4D;IAC5D,SAAS,CAAC,QAAQ,CAAC,SAAS,uBAA8B;IAC1D;;mBAEe;IACf,SAAS,CAAC,UAAU,UAAS;IAE7B;;;;;;;;;;OAUG;IACH,OAAO,IAAI,IAAI;IAIf;yEACqE;cACrD,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB/C,MAAM,IAAI,IAAI;IAId;;;;;;OAMG;IACH,SAAS,CAAC,UAAU,IAAI,IAAI;CAM9B;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAI1F"}
+{"version":3,"file":"log-level-preference.d.ts","sourceRoot":"","sources":["../../src/browser/log-level-preference.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,oBAAoB,EAAyB,MAAM,qBAAqB,CAAC;AAIlF,OAAO,EAAE,+BAA+B,EAAE,MAAM,2DAA2D,CAAC;AAC5G,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAC1F,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAEnF,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,eAA+B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBACa,8BAA+B,YAAW,+BAA+B;IACvD,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAG,MAAM,CAAC;IAC5C,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAG,iBAAiB,CAAC;IAC7D,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAG,OAAO,CAAC;IAErD;;gEAE4D;IAC5D,SAAS,CAAC,QAAQ,CAAC,SAAS,uBAA8B;IAC1D;;mBAEe;IACf,SAAS,CAAC,UAAU,UAAS;IAE7B;;;;;;;;;;OAUG;IACH,OAAO,IAAI,IAAI;IAIf;yEACqE;cACrD,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB/C,MAAM,IAAI,IAAI;IAId;;;;;;OAMG;IACH,SAAS,CAAC,UAAU,IAAI,IAAI;CAiB9B;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAI1F"}

package/lib/browser/log-level-preference.js

@@ -111,7 +111,18 @@ let LogLevelPreferenceContribution = class LogLevelPreferenceContribution {
     applyLevel() {
         const level = (0, protocol_1.parseLogLevel)(this.preferences.get(this.preferenceName));
         if (level) {
+            const previous = protocol_1.Logger.getLevel();
             protocol_1.Logger.setLevel(level);
+            if (previous !== level) {
+                // Through Theia's `ILogger`, which has a threshold of its own and so
+                // is not silenced by the value just applied — the framework logger
+                // this preference governs would drop the line on a switch to `error`.
+                //
+                // Frontend and server announce separately: this preference reaches
+                // the server only if a client delivers it as configuration, so one
+                // line without the other says it did not.
+                this.logger.info(`Log level ${previous} → ${level} (preference '${this.preferenceName}')`);
+            }
         }
     }
 };

package/lib/browser/log-level-preference.js.map

@@ -1 +1 @@
-{"version":3,"file":"log-level-preference.js","sourceRoot":"","sources":["../../src/browser/log-level-preference.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;AAmHlF,wDAIC;AArHD,kDAAkF;AAClF,gFAAgF;AAChF,gFAAgF;AAChF,6EAA6E;AAC7E,iHAA4G;AAC5G,0DAAwD;AACxD,8FAA0F;AAC1F,4DAAmF;AAEnF,4FAA4F;AAC/E,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;GAoBG;AAEI,IAAM,8BAA8B,GAApC,MAAM,8BAA8B;IACO,cAAc,CAAU;IACzB,WAAW,CAAqB;IAC1C,MAAM,CAAW;IAErD;;gEAE4D;IACzC,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC1D;;mBAEe;IACL,UAAU,GAAG,KAAK,CAAC;IAE7B;;;;;;;;;;OAUG;IACH,OAAO;QACJ,KAAK,IAAI,CAAC,cAAc,EAAE,CAAC;IAC9B,CAAC;IAED;yEACqE;IAC3D,KAAK,CAAC,cAAc;QAC3B,IAAI,CAAC;YACF,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;YAC7B,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACnB,OAAO;YACV,CAAC;YACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,IAAI,CAAC,SAAS,CAAC,IAAI,CAChB,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE;gBAC1C,IAAI,KAAK,CAAC,cAAc,KAAK,IAAI,CAAC,cAAc,EAAE,CAAC;oBAChD,IAAI,CAAC,UAAU,EAAE,CAAC;gBACrB,CAAC;YACJ,CAAC,CAAC,CACJ,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACZ,uEAAuE;YACvE,wEAAwE;YACxE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,IAAI,CAAC,cAAc,GAAG,EAAE,GAAG,CAAC,CAAC;QAC7F,CAAC;IACJ,CAAC;IAED,MAAM;QACH,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;OAMG;IACO,UAAU;QACjB,MAAM,KAAK,GAAG,IAAA,wBAAa,EAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAS,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;QAC/E,IAAI,KAAK,EAAE,CAAC;YACT,iBAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACJ,CAAC;CACH,CAAA;AAtEY,wEAA8B;AACO;IAA9C,IAAA,kBAAM,EAAC,0BAAkB,CAAC;;sEAA4C;AACzB;IAA7C,IAAA,kBAAM,EAAC,sCAAiB,CAAC;;mEAAoD;AAC1C;IAAnC,IAAA,kBAAM,EAAC,gBAAO,CAAC;;8DAAqC;yCAH3C,8BAA8B;IAD1C,IAAA,sBAAU,GAAE;GACA,8BAA8B,CAsE1C;AAED;;;;;;GAMG;AACH,SAAgB,sBAAsB,CAAC,IAAqB,EAAE,cAAsB;IACjF,IAAI,CAAC,0BAAkB,CAAC,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;IACzD,IAAI,CAAC,8BAA8B,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACjE,IAAI,CAAC,mEAA+B,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;AACnF,CAAC"}
+{"version":3,"file":"log-level-preference.js","sourceRoot":"","sources":["../../src/browser/log-level-preference.ts"],"names":[],"mappings":"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"}

package/lib/browser/memory-diagnostics-contribution.d.ts

@@ -43,6 +43,15 @@ export declare const MemoryDiagnosticsService: unique symbol;
  */
 export type HostMemoryDiagnosticsService = HostDiagnosticsProtocol;
 export declare const HostMemoryDiagnosticsService: unique symbol;
+/**
+ * What a `report` call captured, as a code rather than a prose fragment. The
+ * sentences it appears in are authored once per code, because a fragment
+ * substituted into a sentence is itself translatable text and a translator
+ * given the sentence alone cannot inflect around a hole.
+ */
+export type DiagnosticsSubject = 'server-state' | 'pod-memory' | 'latency' | 'backend-state' | 'profile';
+/** Which process a heap snapshot is taken of; a code, for the reason {@link DiagnosticsSubject} is one. */
+export type HeapSnapshotTarget = 'server' | 'backend';
 /**
  * Memory-diagnostics commands, one per layer reachable from the frontend. Full
  * multi-line snapshots are appended to the configured output channel; a one-line
@@ -77,14 +86,28 @@ export declare class MemoryDiagnosticsContribution implements CommandContributio
      */
     protected readonly stopProfilingLabel: string;
     registerCommands(registry: CommandRegistry): void;
-    protected command(id: string, label: string, category: string): Command;
+    /**
+     * Takes an object rather than positional arguments so that `label` — the one
+     * user-facing member — is addressable by name. A lint rule guarding the
+     * localization of labels has only syntax to work with, and a selector for an
+     * argument position would equally catch `id`, which must stay a bare literal.
+     */
+    protected command(spec: {
+        id: string;
+        label: string;
+        category: string;
+    }): Command;
+    /** The record window as whole seconds, for the label and the toast that must agree on it. */
+    protected recordDurationSeconds(): number;
     /** Run a snapshot call, append the full result to the channel, toast the first matching summary line. */
-    protected report(what: string, produce: () => Promise<string>, summaryKeys: string[]): Promise<void>;
-    protected writeSnapshot(target: string, produce: (label: string) => Promise<string>): Promise<void>;
+    protected report(subject: DiagnosticsSubject, produce: () => Promise<string>, summaryKeys: string[]): Promise<void>;
+    protected writeSnapshot(target: HeapSnapshotTarget, produce: (label: string) => Promise<string>): Promise<void>;
     /** Begin an open-ended capture; the toast's stop action ends it and reports. */
     protected startProfiling(): Promise<void>;
     /** End the capture and report it. Shared, so the toast action and the command cannot diverge in behaviour. */
     protected stopProfiling(): Promise<void>;
+    /** One authored sentence for both start paths; identical literals in two places drift apart under translation. */
+    protected startProfilingFailedMessage(detail: string): string;
     /** Capture a fixed-length window: start, wait, stop, and report the result. */
     protected recordProfile(): Promise<void>;
     /** Isolated so tests can drive the record window without a real timer. */
@@ -92,7 +115,20 @@ export declare class MemoryDiagnosticsContribution implements CommandContributio
     protected dumpFrontendState(): Promise<void>;
     protected channel(): OutputChannel;
     /** Pull the first line starting with one of `keys` for a one-line toast; full text is in the channel. */
-    protected summarize(snapshot: string, what: string, keys: string[]): string;
+    protected summarize(snapshot: string, subject: DiagnosticsSubject, keys: string[]): string;
+    /**
+     * The captured-with-detail toast. The detail is a machine-formatted figure,
+     * so it is safe as a substitution parameter; the subject is not, hence one
+     * authored sentence per subject.
+     */
+    protected capturedDetailMessage(subject: DiagnosticsSubject, detail: string): string;
+    /** The captured-without-detail toast; the channel name is adopter branding, not translatable text. */
+    protected capturedChannelMessage(subject: DiagnosticsSubject): string;
+    /** The failed-to-dump toast; the detail is a technical error string, safe as a parameter. */
+    protected dumpFailedMessage(subject: DiagnosticsSubject, detail: string): string;
+    protected writingSnapshotMessage(target: HeapSnapshotTarget): string;
+    protected wroteSnapshotMessage(target: HeapSnapshotTarget, filePath: string): string;
+    protected writeSnapshotFailedMessage(target: HeapSnapshotTarget, detail: string): string;
     protected errorMessage(error: unknown): string;
 }
 /**

package/lib/browser/memory-diagnostics-contribution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-diagnostics-contribution.d.ts","sourceRoot":"","sources":["../../src/browser/memory-diagnostics-contribution.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-diagnostics-contribution.d.ts","sourceRoot":"","sources":["../../src/browser/memory-diagnostics-contribution.ts"],"names":[],"mappings":"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"}