@theia/preferences 1.76.0-next.7 → 1.76.0

package/lib/browser/preference-frontend-contribution.d.ts

@@ -1,4 +1,5 @@
 import { FrontendApplicationContribution } from '@theia/core/lib/browser';
+import { WindowLaunchArgs } from '@theia/core/lib/browser/window/window-launch-args';
 import { CliPreferences } from '../common/cli-preferences';
 import { PreferenceService, PreferenceScope } from '@theia/core/lib/common/preferences';
 import { ILogger } from '@theia/core';
@@ -6,8 +7,25 @@ export declare class PreferenceFrontendContribution implements FrontendApplicati
     protected readonly CliPreferences: CliPreferences;
     protected readonly preferenceService: PreferenceService;
     protected readonly logger: ILogger;
+    protected readonly launchArgs: WindowLaunchArgs;
     onStart(): void;
     protected applyCliPreferences(): Promise<void>;
+    /**
+     * Resolves the CLI-provided preferences to apply to this window.
+     *
+     * The shared backend reflects the original cold-start launch (it cannot distinguish between
+     * windows), so it supplies the process-wide CLI preferences. A forwarded (second-instance)
+     * window additionally carries its own options, provided by the trusted main process, and layers
+     * them on top, overriding by key. Merging (rather than replacing) means a plain
+     * second-instance window keeps the process-wide values instead of dropping them, while an attach
+     * window still gets its own overrides.
+     */
+    protected resolveCliPreferences(): Promise<{
+        session: [string, unknown][];
+        persistent: [string, unknown][];
+    }>;
+    /** Overlays `overrides` onto `base`, later entries winning per key while preserving order (base first). */
+    protected mergeEntries(base: ReadonlyArray<[string, unknown]>, overrides: ReadonlyArray<[string, unknown]>): [string, unknown][];
     /**
      * Applies a batch of CLI-provided preferences sequentially. A rejection from an
      * individual write (bad key, invalid scope, etc.) is logged and does not abort the

package/lib/browser/preference-frontend-contribution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preference-frontend-contribution.d.ts","sourceRoot":"","sources":["../../src/browser/preference-frontend-contribution.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,qBACa,8BAA+B,YAAW,+BAA+B;IAElF,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAGlD,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAGxD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnC,OAAO,IAAI,IAAI;cAIC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCpD;;;;OAIG;cACa,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAS7G"}
+{"version":3,"file":"preference-frontend-contribution.d.ts","sourceRoot":"","sources":["../../src/browser/preference-frontend-contribution.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAE1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AACrF,OAAO,EAAE,cAAc,EAAsB,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,qBACa,8BAA+B,YAAW,+BAA+B;IAElF,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAGlD,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAGxD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAGnC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IAEhD,OAAO,IAAI,IAAI;cAIC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBpD;;;;;;;;;OASG;cACa,qBAAqB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAAC,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,CAAC;IAwBnH,2GAA2G;IAC3G,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IAQhI;;;;OAIG;cACa,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAS7G"}

package/lib/browser/preference-frontend-contribution.js

@@ -18,6 +18,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PreferenceFrontendContribution = void 0;
 const tslib_1 = require("tslib");
 const inversify_1 = require("@theia/core/shared/inversify");
+const launch_arguments_1 = require("@theia/core/lib/common/launch-arguments");
+const window_launch_args_1 = require("@theia/core/lib/browser/window/window-launch-args");
 const cli_preferences_1 = require("../common/cli-preferences");
 const preferences_1 = require("@theia/core/lib/common/preferences");
 const core_1 = require("@theia/core");
@@ -26,18 +28,7 @@ let PreferenceFrontendContribution = class PreferenceFrontendContribution {
         this.applyCliPreferences();
     }
     async applyCliPreferences() {
-        // Fetch both buckets in parallel; both are RPC hops to the same backend and
-        // can overlap with the preference service initialising its providers.
-        const [session, persistent] = await Promise.all([
-            this.CliPreferences.getSessionPreferences().catch(e => {
-                this.logger.warn('Failed to fetch --session-preference values:', e);
-                return [];
-            }),
-            this.CliPreferences.getPreferences().catch(e => {
-                this.logger.warn('Failed to fetch --set-preference values:', e);
-                return [];
-            })
-        ]);
+        const { session, persistent } = await this.resolveCliPreferences();
         // `preferenceService.set()` needs the target provider registered in the providers
         // map, which only happens once `initializeProviders()` has walked every scope and
         // resolved `ready`. Writing before that returns `undefined` from `getProvider()`
@@ -55,6 +46,47 @@ let PreferenceFrontendContribution = class PreferenceFrontendContribution {
         }
         await this.applyAll(persistent, preferences_1.PreferenceScope.User);
     }
+    /**
+     * Resolves the CLI-provided preferences to apply to this window.
+     *
+     * The shared backend reflects the original cold-start launch (it cannot distinguish between
+     * windows), so it supplies the process-wide CLI preferences. A forwarded (second-instance)
+     * window additionally carries its own options, provided by the trusted main process, and layers
+     * them on top, overriding by key. Merging (rather than replacing) means a plain
+     * second-instance window keeps the process-wide values instead of dropping them, while an attach
+     * window still gets its own overrides.
+     */
+    async resolveCliPreferences() {
+        // Fetch both buckets in parallel; both are RPC hops to the same backend and
+        // can overlap with the preference service initialising its providers.
+        const [session, persistent] = await Promise.all([
+            this.CliPreferences.getSessionPreferences().catch(e => {
+                this.logger.warn('Failed to fetch --session-preference values:', e);
+                return [];
+            }),
+            this.CliPreferences.getPreferences().catch(e => {
+                this.logger.warn('Failed to fetch --set-preference values:', e);
+                return [];
+            })
+        ]);
+        const forwarded = this.launchArgs.getLaunchArgs();
+        if (forwarded === undefined) {
+            return { session, persistent };
+        }
+        const warn = (message) => this.logger.warn(message);
+        return {
+            session: this.mergeEntries(session, cli_preferences_1.CliPreferenceEntry.parseAll(launch_arguments_1.LaunchArguments.values(forwarded, 'session-preference'), warn)),
+            persistent: this.mergeEntries(persistent, cli_preferences_1.CliPreferenceEntry.parseAll(launch_arguments_1.LaunchArguments.values(forwarded, 'set-preference'), warn))
+        };
+    }
+    /** Overlays `overrides` onto `base`, later entries winning per key while preserving order (base first). */
+    mergeEntries(base, overrides) {
+        const merged = new Map();
+        for (const [key, value] of [...base, ...overrides]) {
+            merged.set(key, value);
+        }
+        return [...merged];
+    }
     /**
      * Applies a batch of CLI-provided preferences sequentially. A rejection from an
      * individual write (bad key, invalid scope, etc.) is logged and does not abort the
@@ -85,6 +117,10 @@ tslib_1.__decorate([
     (0, inversify_1.named)('preferences:PreferenceFrontendContribution'),
     tslib_1.__metadata("design:type", Object)
 ], PreferenceFrontendContribution.prototype, "logger", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(window_launch_args_1.WindowLaunchArgs),
+    tslib_1.__metadata("design:type", Object)
+], PreferenceFrontendContribution.prototype, "launchArgs", void 0);
 exports.PreferenceFrontendContribution = PreferenceFrontendContribution = tslib_1.__decorate([
     (0, inversify_1.injectable)()
 ], PreferenceFrontendContribution);

package/lib/browser/preference-frontend-contribution.js.map

@@ -1 +1 @@
-{"version":3,"file":"preference-frontend-contribution.js","sourceRoot":"","sources":["../../src/browser/preference-frontend-contribution.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;AAEhF,4DAAyE;AAEzE,+DAA2D;AAC3D,oEAAwF;AACxF,sCAAsC;AAG/B,IAAM,8BAA8B,GAApC,MAAM,8BAA8B;IAUvC,OAAO;QACH,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC/B,CAAC;IAES,KAAK,CAAC,mBAAmB;QAC/B,4EAA4E;QAC5E,sEAAsE;QACtE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC5C,IAAI,CAAC,cAAc,CAAC,qBAAqB,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;gBAClD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8CAA8C,EAAE,CAAC,CAAC,CAAC;gBACpE,OAAO,EAAyB,CAAC;YACrC,CAAC,CAAC;YACF,IAAI,CAAC,cAAc,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;gBAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;gBAChE,OAAO,EAAyB,CAAC;YACrC,CAAC,CAAC;SACL,CAAC,CAAC;QAEH,kFAAkF;QAClF,kFAAkF;QAClF,iFAAiF;QACjF,yDAAyD;QACzD,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC;QAEnC,iFAAiF;QACjF,gFAAgF;QAChF,kFAAkF;QAClF,qEAAqE;QACrE,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,6BAAe,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,yEAAyE;YACzE,wFAAwF;YACxF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,MAAM,iCAAiC,EACvE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,6BAAe,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,QAAQ,CAAC,OAAyC,EAAE,KAAsB;QACtF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;YACjC,IAAI,CAAC;gBACD,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACxD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mCAAmC,GAAG,QAAQ,6BAAe,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YACvG,CAAC;QACL,CAAC;IACL,CAAC;CACJ,CAAA;AA/DY,wEAA8B;AAEpB;IADlB,IAAA,kBAAM,EAAC,gCAAc,CAAC;;sEAC2B;AAG/B;IADlB,IAAA,kBAAM,EAAC,+BAAiB,CAAC;;yEAC8B;AAGrC;IADlB,IAAA,kBAAM,EAAC,cAAO,CAAC;IAAE,IAAA,iBAAK,EAAC,4CAA4C,CAAC;;8DAClC;yCAR1B,8BAA8B;IAD1C,IAAA,sBAAU,GAAE;GACA,8BAA8B,CA+D1C"}
+{"version":3,"file":"preference-frontend-contribution.js","sourceRoot":"","sources":["../../src/browser/preference-frontend-contribution.ts"],"names":[],"mappings":"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"}

package/lib/browser/preference-frontend-contribution.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=preference-frontend-contribution.spec.d.ts.map

package/lib/browser/preference-frontend-contribution.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preference-frontend-contribution.spec.d.ts","sourceRoot":"","sources":["../../src/browser/preference-frontend-contribution.spec.ts"],"names":[],"mappings":""}

package/lib/browser/preference-frontend-contribution.spec.js

@@ -0,0 +1,76 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const launchArgs = (values) => ({ values, negated: [] });
+const preference_frontend_contribution_1 = require("./preference-frontend-contribution");
+class TestPreferenceFrontendContribution extends preference_frontend_contribution_1.PreferenceFrontendContribution {
+    constructor() {
+        super(...arguments);
+        this.sessionBackendCalls = 0;
+        this.persistentBackendCalls = 0;
+    }
+    resolve() {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.launchArgs = { getLaunchArgs: () => this.forwardedArgs };
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.CliPreferences = {
+            getSessionPreferences: async () => {
+                this.sessionBackendCalls++;
+                return [['backend.session', 1]];
+            },
+            getPreferences: async () => {
+                this.persistentBackendCalls++;
+                return [['backend.persistent', 2]];
+            }
+        };
+        return this.resolveCliPreferences();
+    }
+}
+describe('PreferenceFrontendContribution#resolveCliPreferences', () => {
+    let contribution;
+    beforeEach(() => {
+        contribution = new TestPreferenceFrontendContribution();
+    });
+    it('reads preferences from the backend on a cold-start window (no forwarded options)', async () => {
+        contribution.forwardedArgs = undefined;
+        const result = await contribution.resolve();
+        (0, chai_1.expect)(result.session).to.deep.equal([['backend.session', 1]]);
+        (0, chai_1.expect)(result.persistent).to.deep.equal([['backend.persistent', 2]]);
+        (0, chai_1.expect)(contribution.sessionBackendCalls).to.equal(1);
+    });
+    it('layers --session-preference from the forwarded options on top of the backend values', async () => {
+        contribution.forwardedArgs = launchArgs({ 'session-preference': ['editor.fontSize=20'], 'attach-container': ['B'] });
+        const result = await contribution.resolve();
+        // Process-wide backend values are kept (base) and the forwarded value is added on top.
+        (0, chai_1.expect)(result.session).to.deep.equal([['backend.session', 1], ['editor.fontSize', 20]]);
+        (0, chai_1.expect)(result.persistent).to.deep.equal([['backend.persistent', 2]]);
+        (0, chai_1.expect)(contribution.sessionBackendCalls).to.equal(1);
+    });
+    it('layers --set-preference from the forwarded options on top of the backend values', async () => {
+        contribution.forwardedArgs = launchArgs({ 'set-preference': ['editor.tabSize=2'] });
+        const result = await contribution.resolve();
+        (0, chai_1.expect)(result.persistent).to.deep.equal([['backend.persistent', 2], ['editor.tabSize', 2]]);
+        (0, chai_1.expect)(result.session).to.deep.equal([['backend.session', 1]]);
+    });
+    it('lets a forwarded value override a same-key backend value', async () => {
+        contribution.forwardedArgs = launchArgs({ 'session-preference': ['backend.session=99'] });
+        const result = await contribution.resolve();
+        (0, chai_1.expect)(result.session).to.deep.equal([['backend.session', 99]]);
+    });
+});
+//# sourceMappingURL=preference-frontend-contribution.spec.js.map

package/lib/browser/preference-frontend-contribution.spec.js.map

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

package/lib/browser/preference-frontend-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preference-frontend-module.d.ts","sourceRoot":"","sources":["../../src/browser/preference-frontend-module.ts"],"names":[],"mappings":"AAgBA,OAAO,mCAAmC,CAAC;AAC3C,OAAO,mCAAmC,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAwB3E,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,IAAI,CAmCtF;;AAED,wBAEG"}
+{"version":3,"file":"preference-frontend-module.d.ts","sourceRoot":"","sources":["../../src/browser/preference-frontend-module.ts"],"names":[],"mappings":"AAgBA,OAAO,mCAAmC,CAAC;AAC3C,OAAO,mCAAmC,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AA0B3E,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,IAAI,CAqCtF;;AAED,wBAEG"}

package/lib/browser/preference-frontend-module.js

@@ -34,6 +34,8 @@ const preference_open_handler_1 = require("./preference-open-handler");
 const cli_preferences_1 = require("../common/cli-preferences");
 const service_connection_provider_1 = require("@theia/core/lib/browser/messaging/service-connection-provider");
 const preference_frontend_contribution_1 = require("./preference-frontend-contribution");
+const remote_cli_args_contribution_1 = require("@theia/core/lib/common/remote-cli-args-contribution");
+const session_preference_remote_cli_contribution_1 = require("./session-preference-remote-cli-contribution");
 const session_preference_status_bar_contribution_1 = require("./session-preference-status-bar-contribution");
 const preference_layout_1 = require("./util/preference-layout");
 const preference_widget_1 = require("./views/preference-widget");
@@ -59,6 +61,8 @@ function bindPreferences(bind, unbind) {
     bind(cli_preferences_1.CliPreferences).toDynamicValue(ctx => service_connection_provider_1.ServiceConnectionProvider.createProxy(ctx.container, cli_preferences_1.CliPreferencesPath)).inSingletonScope();
     bind(preference_frontend_contribution_1.PreferenceFrontendContribution).toSelf().inSingletonScope();
     bind(browser_1.FrontendApplicationContribution).toService(preference_frontend_contribution_1.PreferenceFrontendContribution);
+    bind(session_preference_remote_cli_contribution_1.SessionPreferenceRemoteCliContribution).toSelf().inSingletonScope();
+    bind(remote_cli_args_contribution_1.RemoteCliArgsContribution).toService(session_preference_remote_cli_contribution_1.SessionPreferenceRemoteCliContribution);
     bind(session_preference_status_bar_contribution_1.SessionPreferenceStatusBarContribution).toSelf().inSingletonScope();
     bind(browser_1.FrontendApplicationContribution).toService(session_preference_status_bar_contribution_1.SessionPreferenceStatusBarContribution);
     bind(browser_1.WidgetStatusBarContribution).toConstantValue((0, browser_1.noopWidgetStatusBarContribution)(preference_widget_1.PreferencesWidget));

package/lib/browser/preference-frontend-module.js.map

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

package/lib/browser/session-preference-remote-cli-contribution.d.ts

@@ -0,0 +1,17 @@
+import { RemoteCliArgsContribution } from '@theia/core/lib/common/remote-cli-args-contribution';
+import { WindowLaunchArgs } from '@theia/core/lib/browser/window/window-launch-args';
+/**
+ * Re-applies `--session-preference` values on a remote backend that is started for a *forwarded*
+ * (second-instance) window.
+ *
+ * The shared local backend only knows the preferences of the original cold-start launch, so its
+ * `RemoteCliContribution#enhanceArgs` cannot supply the right values for a window opened by a
+ * later launch. This frontend contribution reads the session preferences forwarded to the current
+ * window (provided by the trusted main process) and formats them as CLI arguments for the remote
+ * backend.
+ */
+export declare class SessionPreferenceRemoteCliContribution implements RemoteCliArgsContribution {
+    protected readonly launchArgs: WindowLaunchArgs;
+    getRemoteCliArgs(): Promise<string[]>;
+}
+//# sourceMappingURL=session-preference-remote-cli-contribution.d.ts.map

package/lib/browser/session-preference-remote-cli-contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-preference-remote-cli-contribution.d.ts","sourceRoot":"","sources":["../../src/browser/session-preference-remote-cli-contribution.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qDAAqD,CAAC;AAEhG,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAGrF;;;;;;;;;GASG;AACH,qBACa,sCAAuC,YAAW,yBAAyB;IAGpF,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IAE1C,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAU9C"}

package/lib/browser/session-preference-remote-cli-contribution.js

@@ -0,0 +1,54 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionPreferenceRemoteCliContribution = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("@theia/core/shared/inversify");
+const launch_arguments_1 = require("@theia/core/lib/common/launch-arguments");
+const window_launch_args_1 = require("@theia/core/lib/browser/window/window-launch-args");
+const cli_preferences_1 = require("../common/cli-preferences");
+/**
+ * Re-applies `--session-preference` values on a remote backend that is started for a *forwarded*
+ * (second-instance) window.
+ *
+ * The shared local backend only knows the preferences of the original cold-start launch, so its
+ * `RemoteCliContribution#enhanceArgs` cannot supply the right values for a window opened by a
+ * later launch. This frontend contribution reads the session preferences forwarded to the current
+ * window (provided by the trusted main process) and formats them as CLI arguments for the remote
+ * backend.
+ */
+let SessionPreferenceRemoteCliContribution = class SessionPreferenceRemoteCliContribution {
+    async getRemoteCliArgs() {
+        const forwarded = this.launchArgs.getLaunchArgs();
+        if (forwarded === undefined) {
+            // Cold-start window: the shared backend already forwards its session preferences.
+            return [];
+        }
+        return cli_preferences_1.CliPreferenceEntry
+            .parseAll(launch_arguments_1.LaunchArguments.values(forwarded, 'session-preference'))
+            .map(entry => cli_preferences_1.CliPreferenceEntry.toArg('session-preference', entry));
+    }
+};
+exports.SessionPreferenceRemoteCliContribution = SessionPreferenceRemoteCliContribution;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(window_launch_args_1.WindowLaunchArgs),
+    tslib_1.__metadata("design:type", Object)
+], SessionPreferenceRemoteCliContribution.prototype, "launchArgs", void 0);
+exports.SessionPreferenceRemoteCliContribution = SessionPreferenceRemoteCliContribution = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], SessionPreferenceRemoteCliContribution);
+//# sourceMappingURL=session-preference-remote-cli-contribution.js.map

package/lib/browser/session-preference-remote-cli-contribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-preference-remote-cli-contribution.js","sourceRoot":"","sources":["../../src/browser/session-preference-remote-cli-contribution.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oDAAoD;AACpD,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;AAEhF,4DAAkE;AAElE,8EAA0E;AAC1E,0FAAqF;AACrF,+DAA+D;AAE/D;;;;;;;;;GASG;AAEI,IAAM,sCAAsC,GAA5C,MAAM,sCAAsC;IAK/C,KAAK,CAAC,gBAAgB;QAClB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;QAClD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC1B,kFAAkF;YAClF,OAAO,EAAE,CAAC;QACd,CAAC;QACD,OAAO,oCAAkB;aACpB,QAAQ,CAAC,kCAAe,CAAC,MAAM,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;aACjE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,oCAAkB,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7E,CAAC;CACJ,CAAA;AAfY,wFAAsC;AAG5B;IADlB,IAAA,kBAAM,EAAC,qCAAgB,CAAC;;0EACuB;iDAHvC,sCAAsC;IADlD,IAAA,sBAAU,GAAE;GACA,sCAAsC,CAelD"}

package/lib/browser/session-preference-remote-cli-contribution.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-preference-remote-cli-contribution.spec.d.ts.map

package/lib/browser/session-preference-remote-cli-contribution.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-preference-remote-cli-contribution.spec.d.ts","sourceRoot":"","sources":["../../src/browser/session-preference-remote-cli-contribution.spec.ts"],"names":[],"mappings":""}

package/lib/browser/session-preference-remote-cli-contribution.spec.js

@@ -0,0 +1,50 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const launchArgs = (values) => ({ values, negated: [] });
+const cli_preferences_1 = require("../common/cli-preferences");
+const session_preference_remote_cli_contribution_1 = require("./session-preference-remote-cli-contribution");
+class TestContribution extends session_preference_remote_cli_contribution_1.SessionPreferenceRemoteCliContribution {
+    set forwardedArgs(args) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.launchArgs = { getLaunchArgs: () => args };
+    }
+}
+describe('SessionPreferenceRemoteCliContribution#getRemoteCliArgs', () => {
+    let contribution;
+    beforeEach(() => {
+        contribution = new TestContribution();
+    });
+    it('returns no args for a cold-start window (no forwarded options)', async () => {
+        contribution.forwardedArgs = undefined;
+        (0, chai_1.expect)(await contribution.getRemoteCliArgs()).to.deep.equal([]);
+    });
+    it('returns no args for a forwarded window without --session-preference', async () => {
+        contribution.forwardedArgs = launchArgs({ 'attach-container': ['B'] });
+        (0, chai_1.expect)(await contribution.getRemoteCliArgs()).to.deep.equal([]);
+    });
+    it('formats forwarded --session-preference values for the remote backend', async () => {
+        contribution.forwardedArgs = launchArgs({ 'attach-container': ['B'], 'session-preference': ['editor.fontSize=20'] });
+        const args = await contribution.getRemoteCliArgs();
+        (0, chai_1.expect)(args).to.have.lengthOf(1);
+        // The produced arg must parse back to the original entry on the remote.
+        const value = args[0].substring('--session-preference='.length);
+        (0, chai_1.expect)(cli_preferences_1.CliPreferenceEntry.parse(value)).to.deep.equal(['editor.fontSize', 20]);
+    });
+});
+//# sourceMappingURL=session-preference-remote-cli-contribution.spec.js.map

package/lib/browser/session-preference-remote-cli-contribution.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-preference-remote-cli-contribution.spec.js","sourceRoot":"","sources":["../../src/browser/session-preference-remote-cli-contribution.spec.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oDAAoD;AACpD,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;AAEhF,+BAA8B;AAG9B,MAAM,UAAU,GAAG,CAAC,MAAgC,EAAmB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;AACpG,+DAA+D;AAC/D,6GAAsG;AAEtG,MAAM,gBAAiB,SAAQ,mFAAsC;IACjE,IAAI,aAAa,CAAC,IAAiC;QAC/C,8DAA8D;QAC7D,IAAY,CAAC,UAAU,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IAC7D,CAAC;CACJ;AAED,QAAQ,CAAC,yDAAyD,EAAE,GAAG,EAAE;IAErE,IAAI,YAA8B,CAAC;IAEnC,UAAU,CAAC,GAAG,EAAE;QACZ,YAAY,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC5E,YAAY,CAAC,aAAa,GAAG,SAAS,CAAC;QACvC,IAAA,aAAM,EAAC,MAAM,YAAY,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACjF,YAAY,CAAC,aAAa,GAAG,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvE,IAAA,aAAM,EAAC,MAAM,YAAY,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QAClF,YAAY,CAAC,aAAa,GAAG,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC,GAAG,CAAC,EAAE,oBAAoB,EAAE,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAErH,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,gBAAgB,EAAE,CAAC;QAEnD,IAAA,aAAM,EAAC,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACjC,wEAAwE;QACxE,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAChE,IAAA,aAAM,EAAC,oCAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/lib/common/cli-preferences.d.ts

@@ -4,4 +4,32 @@ export interface CliPreferences {
     getPreferences(): Promise<[string, unknown][]>;
     getSessionPreferences(): Promise<[string, unknown][]>;
 }
+export declare namespace CliPreferenceEntry {
+    /**
+     * Sink for warnings about malformed entries. Callers running in an Inversify context should
+     * pass their named `ILogger`, since these helpers live in `common` and cannot inject one
+     * themselves. Defaults to `console.warn`.
+     */
+    type WarningSink = (message: string) => void;
+    /**
+     * Parses a single `KEY=JSONVALUE` preference assignment as accepted by `--set-preference`
+     * and `--session-preference`. The value may be `base64:`-prefixed (used when forwarding
+     * values that must survive shell/URL transport intact). Returns `undefined` (after logging a
+     * warning to {@link warn}) when the entry has no key or the value is not valid JSON.
+     */
+    function parse(entry: string, warn?: WarningSink): [string, unknown] | undefined;
+    /**
+     * Formats a preference entry as a CLI argument of the form
+     * `--<optionName>=<key>=base64:<base64(JSON(value))>`, the inverse of {@link parse}.
+     *
+     * The value is base64-encoded so it survives shell/URL transport intact (e.g. when the
+     * argument is passed to a remote backend over an SSH command line).
+     */
+    function toArg(optionName: string, [key, value]: [string, unknown]): string;
+    /**
+     * Parses a list of `KEY=JSONVALUE` assignments, dropping any invalid entries and reporting
+     * them to {@link warn}.
+     */
+    function parseAll(entries: readonly string[], warn?: WarningSink): [string, unknown][];
+}
 //# sourceMappingURL=cli-preferences.d.ts.map

package/lib/common/cli-preferences.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-preferences.d.ts","sourceRoot":"","sources":["../../src/common/cli-preferences.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,cAAc,eAA2B,CAAC;AACvD,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC3B,cAAc,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/C,qBAAqB,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;CACzD"}
+{"version":3,"file":"cli-preferences.d.ts","sourceRoot":"","sources":["../../src/common/cli-preferences.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,cAAc,eAA2B,CAAC;AACvD,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC3B,cAAc,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/C,qBAAqB,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;CACzD;AAED,yBAAiB,kBAAkB,CAAC;IAEhC;;;;OAIG;IACH,KAAY,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAIpD;;;;;OAKG;IACH,SAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,WAAyB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAiBnG;IAED;;;;;;OAMG;IACH,SAAgB,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEjF;IAED;;;OAGG;IACH,SAAgB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,GAAE,WAAyB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CASzG;CAaJ"}

package/lib/common/cli-preferences.js

@@ -15,7 +15,72 @@
 // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
 // *****************************************************************************
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CliPreferencesPath = exports.CliPreferences = void 0;
+exports.CliPreferenceEntry = exports.CliPreferencesPath = exports.CliPreferences = void 0;
 exports.CliPreferences = Symbol('CliPreferences');
 exports.CliPreferencesPath = '/services/cli-preferences';
+var CliPreferenceEntry;
+(function (CliPreferenceEntry) {
+    const defaultWarn = message => console.warn(message);
+    /**
+     * Parses a single `KEY=JSONVALUE` preference assignment as accepted by `--set-preference`
+     * and `--session-preference`. The value may be `base64:`-prefixed (used when forwarding
+     * values that must survive shell/URL transport intact). Returns `undefined` (after logging a
+     * warning to {@link warn}) when the entry has no key or the value is not valid JSON.
+     */
+    function parse(entry, warn = defaultWarn) {
+        const firstEqualIndex = entry.indexOf('=');
+        if (firstEqualIndex <= 0) {
+            warn(`Ignoring preference CLI argument "${entry}": expected KEY=JSONVALUE.`);
+            return undefined;
+        }
+        const rawValue = entry.substring(firstEqualIndex + 1);
+        try {
+            // Decoding happens inside the `try` so that a malformed `base64:` payload is reported
+            // like any other invalid value instead of throwing out of `parse`.
+            const value = rawValue.startsWith('base64:') ? decodeBase64(rawValue.substring('base64:'.length)) : rawValue;
+            return [entry.substring(0, firstEqualIndex), JSON.parse(value)];
+        }
+        catch (e) {
+            const reason = e instanceof Error ? e.message : String(e);
+            warn(`Ignoring preference CLI argument "${entry}": value is not valid JSON (${reason}).`);
+            return undefined;
+        }
+    }
+    CliPreferenceEntry.parse = parse;
+    /**
+     * Formats a preference entry as a CLI argument of the form
+     * `--<optionName>=<key>=base64:<base64(JSON(value))>`, the inverse of {@link parse}.
+     *
+     * The value is base64-encoded so it survives shell/URL transport intact (e.g. when the
+     * argument is passed to a remote backend over an SSH command line).
+     */
+    function toArg(optionName, [key, value]) {
+        return `--${optionName}=${key}=base64:${encodeBase64(JSON.stringify(value))}`;
+    }
+    CliPreferenceEntry.toArg = toArg;
+    /**
+     * Parses a list of `KEY=JSONVALUE` assignments, dropping any invalid entries and reporting
+     * them to {@link warn}.
+     */
+    function parseAll(entries, warn = defaultWarn) {
+        const result = [];
+        for (const entry of entries) {
+            const parsed = parse(entry, warn);
+            if (parsed) {
+                result.push(parsed);
+            }
+        }
+        return result;
+    }
+    CliPreferenceEntry.parseAll = parseAll;
+    // `Buffer` is available on the backend and is polyfilled into the frontend bundle by the
+    // esbuild generator, so a single implementation covers both. It also handles UTF-8 directly,
+    // unlike `atob`/`btoa`, which only deal in binary strings.
+    function decodeBase64(value) {
+        return Buffer.from(value, 'base64').toString('utf-8');
+    }
+    function encodeBase64(value) {
+        return Buffer.from(value, 'utf-8').toString('base64');
+    }
+})(CliPreferenceEntry || (exports.CliPreferenceEntry = CliPreferenceEntry = {}));
 //# sourceMappingURL=cli-preferences.js.map

package/lib/common/cli-preferences.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-preferences.js","sourceRoot":"","sources":["../../src/common/cli-preferences.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAEnE,QAAA,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAC1C,QAAA,kBAAkB,GAAG,2BAA2B,CAAC"}
+{"version":3,"file":"cli-preferences.js","sourceRoot":"","sources":["../../src/common/cli-preferences.ts"],"names":[],"mappings":"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"}

package/lib/common/cli-preferences.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli-preferences.spec.d.ts.map

package/lib/common/cli-preferences.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-preferences.spec.d.ts","sourceRoot":"","sources":["../../src/common/cli-preferences.spec.ts"],"names":[],"mappings":""}

package/lib/common/cli-preferences.spec.js

@@ -0,0 +1,64 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const cli_preferences_1 = require("./cli-preferences");
+describe('CliPreferenceEntry.parse', () => {
+    it('parses a KEY=JSONVALUE assignment', () => {
+        (0, chai_1.expect)(cli_preferences_1.CliPreferenceEntry.parse('editor.fontSize=14')).to.deep.equal(['editor.fontSize', 14]);
+    });
+    it('parses boolean and string JSON values', () => {
+        (0, chai_1.expect)(cli_preferences_1.CliPreferenceEntry.parse('foo.enabled=true')).to.deep.equal(['foo.enabled', true]);
+        (0, chai_1.expect)(cli_preferences_1.CliPreferenceEntry.parse('foo.label="hello"')).to.deep.equal(['foo.label', 'hello']);
+    });
+    it('keeps "=" characters that are part of the value', () => {
+        (0, chai_1.expect)(cli_preferences_1.CliPreferenceEntry.parse('foo.expr="a=b"')).to.deep.equal(['foo.expr', 'a=b']);
+    });
+    it('decodes a base64-encoded value', () => {
+        // base64 of the JSON value `42`
+        (0, chai_1.expect)(cli_preferences_1.CliPreferenceEntry.parse('foo.num=base64:NDI=')).to.deep.equal(['foo.num', 42]);
+    });
+    it('returns undefined when there is no key', () => {
+        (0, chai_1.expect)(cli_preferences_1.CliPreferenceEntry.parse('=1')).to.be.undefined;
+    });
+    it('returns undefined when there is no "="', () => {
+        (0, chai_1.expect)(cli_preferences_1.CliPreferenceEntry.parse('noequals')).to.be.undefined;
+    });
+    it('returns undefined for an invalid JSON value', () => {
+        (0, chai_1.expect)(cli_preferences_1.CliPreferenceEntry.parse('foo.bar=not json')).to.be.undefined;
+    });
+    describe('parseAll', () => {
+        it('parses and filters a list, dropping invalid entries', () => {
+            const result = cli_preferences_1.CliPreferenceEntry.parseAll(['a=1', 'bad', 'b="x"']);
+            (0, chai_1.expect)(result).to.deep.equal([['a', 1], ['b', 'x']]);
+        });
+    });
+    describe('toArg', () => {
+        it('formats an entry as a base64-encoded CLI argument', () => {
+            // base64 of the JSON value `42`
+            (0, chai_1.expect)(cli_preferences_1.CliPreferenceEntry.toArg('session-preference', ['foo.num', 42])).to.equal('--session-preference=foo.num=base64:NDI=');
+        });
+        it('round-trips a value with shell-special characters through toArg + parse', () => {
+            const entry = ['foo.expr', '$HOME && "quoted"'];
+            const arg = cli_preferences_1.CliPreferenceEntry.toArg('session-preference', entry);
+            // The value part of `--session-preference=<value>` must parse back to the original entry.
+            const value = arg.substring('--session-preference='.length);
+            (0, chai_1.expect)(cli_preferences_1.CliPreferenceEntry.parse(value)).to.deep.equal(entry);
+        });
+    });
+});
+//# sourceMappingURL=cli-preferences.spec.js.map