@theia/core 1.77.0 → 1.78.0-next.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (180) hide show
  1. package/lib/browser/catalog.json +208 -32
  2. package/lib/browser/encoding-registry.js +1 -1
  3. package/lib/browser/encoding-registry.js.map +1 -1
  4. package/lib/browser/encoding-registry.spec.d.ts +2 -0
  5. package/lib/browser/encoding-registry.spec.d.ts.map +1 -0
  6. package/lib/browser/encoding-registry.spec.js +43 -0
  7. package/lib/browser/encoding-registry.spec.js.map +1 -0
  8. package/lib/browser/messaging/service-connection-provider.d.ts.map +1 -1
  9. package/lib/browser/messaging/service-connection-provider.js +9 -1
  10. package/lib/browser/messaging/service-connection-provider.js.map +1 -1
  11. package/lib/browser/messaging/service-connection-provider.spec.d.ts +2 -0
  12. package/lib/browser/messaging/service-connection-provider.spec.d.ts.map +1 -0
  13. package/lib/browser/messaging/service-connection-provider.spec.js +76 -0
  14. package/lib/browser/messaging/service-connection-provider.spec.js.map +1 -0
  15. package/lib/browser/shell/tab-bars.d.ts +7 -0
  16. package/lib/browser/shell/tab-bars.d.ts.map +1 -1
  17. package/lib/browser/shell/tab-bars.js +25 -11
  18. package/lib/browser/shell/tab-bars.js.map +1 -1
  19. package/lib/browser/shell/tab-bars.spec.js +20 -0
  20. package/lib/browser/shell/tab-bars.spec.js.map +1 -1
  21. package/lib/common/core-preferences.d.ts +1 -0
  22. package/lib/common/core-preferences.d.ts.map +1 -1
  23. package/lib/common/core-preferences.js +11 -1
  24. package/lib/common/core-preferences.js.map +1 -1
  25. package/lib/common/messaging/handler.d.ts +11 -0
  26. package/lib/common/messaging/handler.d.ts.map +1 -1
  27. package/lib/common/messaging/proxy-factory.d.ts +8 -1
  28. package/lib/common/messaging/proxy-factory.d.ts.map +1 -1
  29. package/lib/common/messaging/proxy-factory.js +4 -2
  30. package/lib/common/messaging/proxy-factory.js.map +1 -1
  31. package/lib/common/messaging/proxy-factory.spec.js +16 -1
  32. package/lib/common/messaging/proxy-factory.spec.js.map +1 -1
  33. package/lib/common/shell-environment.d.ts +61 -0
  34. package/lib/common/shell-environment.d.ts.map +1 -0
  35. package/lib/common/shell-environment.js +29 -0
  36. package/lib/common/shell-environment.js.map +1 -0
  37. package/lib/electron-browser/shell-environment/electron-shell-environment-contribution.d.ts +20 -0
  38. package/lib/electron-browser/shell-environment/electron-shell-environment-contribution.d.ts.map +1 -0
  39. package/lib/electron-browser/shell-environment/electron-shell-environment-contribution.js +72 -0
  40. package/lib/electron-browser/shell-environment/electron-shell-environment-contribution.js.map +1 -0
  41. package/lib/electron-browser/shell-environment/electron-shell-environment-contribution.spec.d.ts +2 -0
  42. package/lib/electron-browser/shell-environment/electron-shell-environment-contribution.spec.d.ts.map +1 -0
  43. package/lib/electron-browser/shell-environment/electron-shell-environment-contribution.spec.js +86 -0
  44. package/lib/electron-browser/shell-environment/electron-shell-environment-contribution.spec.js.map +1 -0
  45. package/lib/electron-browser/shell-environment/electron-shell-environment-module.d.ts +4 -0
  46. package/lib/electron-browser/shell-environment/electron-shell-environment-module.d.ts.map +1 -0
  47. package/lib/electron-browser/shell-environment/electron-shell-environment-module.js +26 -0
  48. package/lib/electron-browser/shell-environment/electron-shell-environment-module.js.map +1 -0
  49. package/lib/electron-main/electron-main-application.d.ts.map +1 -1
  50. package/lib/electron-main/electron-main-application.js +12 -4
  51. package/lib/electron-main/electron-main-application.js.map +1 -1
  52. package/lib/electron-node/keyboard/electron-backend-keyboard-module.d.ts.map +1 -1
  53. package/lib/electron-node/keyboard/electron-backend-keyboard-module.js +1 -1
  54. package/lib/electron-node/keyboard/electron-backend-keyboard-module.js.map +1 -1
  55. package/lib/electron-node/request/electron-backend-request-service.d.ts +4 -1
  56. package/lib/electron-node/request/electron-backend-request-service.d.ts.map +1 -1
  57. package/lib/electron-node/request/electron-backend-request-service.js +56 -13
  58. package/lib/electron-node/request/electron-backend-request-service.js.map +1 -1
  59. package/lib/node/backend-application-module.d.ts.map +1 -1
  60. package/lib/node/backend-application-module.js +13 -5
  61. package/lib/node/backend-application-module.js.map +1 -1
  62. package/lib/node/env-variables/env-variables-server.d.ts +13 -3
  63. package/lib/node/env-variables/env-variables-server.d.ts.map +1 -1
  64. package/lib/node/env-variables/env-variables-server.js +21 -14
  65. package/lib/node/env-variables/env-variables-server.js.map +1 -1
  66. package/lib/node/env-variables/env-variables-server.spec.d.ts +2 -0
  67. package/lib/node/env-variables/env-variables-server.spec.d.ts.map +1 -0
  68. package/lib/node/env-variables/env-variables-server.spec.js +83 -0
  69. package/lib/node/env-variables/env-variables-server.spec.js.map +1 -0
  70. package/lib/node/i18n/i18n-backend-module.js +2 -2
  71. package/lib/node/i18n/i18n-backend-module.js.map +1 -1
  72. package/lib/node/index.d.ts +1 -0
  73. package/lib/node/index.d.ts.map +1 -1
  74. package/lib/node/index.js +1 -0
  75. package/lib/node/index.js.map +1 -1
  76. package/lib/node/logger-backend-module.js +1 -1
  77. package/lib/node/logger-backend-module.js.map +1 -1
  78. package/lib/node/messaging/connection-container-module.d.ts +11 -2
  79. package/lib/node/messaging/connection-container-module.d.ts.map +1 -1
  80. package/lib/node/messaging/connection-container-module.js +13 -2
  81. package/lib/node/messaging/connection-container-module.js.map +1 -1
  82. package/lib/node/messaging/connection-container-module.spec.d.ts +2 -0
  83. package/lib/node/messaging/connection-container-module.spec.d.ts.map +1 -0
  84. package/lib/node/messaging/connection-container-module.spec.js +37 -0
  85. package/lib/node/messaging/connection-container-module.spec.js.map +1 -0
  86. package/lib/node/messaging/default-messaging-service.d.ts +33 -4
  87. package/lib/node/messaging/default-messaging-service.d.ts.map +1 -1
  88. package/lib/node/messaging/default-messaging-service.js +52 -10
  89. package/lib/node/messaging/default-messaging-service.js.map +1 -1
  90. package/lib/node/messaging/gated-channel-multiplexer.d.ts +20 -0
  91. package/lib/node/messaging/gated-channel-multiplexer.d.ts.map +1 -0
  92. package/lib/node/messaging/gated-channel-multiplexer.js +50 -0
  93. package/lib/node/messaging/gated-channel-multiplexer.js.map +1 -0
  94. package/lib/node/messaging/gated-channel-multiplexer.spec.d.ts +2 -0
  95. package/lib/node/messaging/gated-channel-multiplexer.spec.d.ts.map +1 -0
  96. package/lib/node/messaging/gated-channel-multiplexer.spec.js +74 -0
  97. package/lib/node/messaging/gated-channel-multiplexer.spec.js.map +1 -0
  98. package/lib/node/messaging/index.d.ts +1 -0
  99. package/lib/node/messaging/index.d.ts.map +1 -1
  100. package/lib/node/messaging/index.js +1 -0
  101. package/lib/node/messaging/index.js.map +1 -1
  102. package/lib/node/messaging/messaging-backend-module.js +1 -1
  103. package/lib/node/messaging/messaging-backend-module.js.map +1 -1
  104. package/lib/node/messaging/messaging-service.d.ts +5 -1
  105. package/lib/node/messaging/messaging-service.d.ts.map +1 -1
  106. package/lib/node/messaging/messaging-service.js.map +1 -1
  107. package/lib/node/messaging/test/default-messaging-service.spec.js +82 -2
  108. package/lib/node/messaging/test/default-messaging-service.spec.js.map +1 -1
  109. package/lib/node/messaging/websocket-frontend-connection-service.d.ts +1 -0
  110. package/lib/node/messaging/websocket-frontend-connection-service.d.ts.map +1 -1
  111. package/lib/node/messaging/websocket-frontend-connection-service.js +8 -0
  112. package/lib/node/messaging/websocket-frontend-connection-service.js.map +1 -1
  113. package/lib/node/messaging/websocket-frontend-connection-service.spec.d.ts +2 -0
  114. package/lib/node/messaging/websocket-frontend-connection-service.spec.d.ts.map +1 -0
  115. package/lib/node/messaging/websocket-frontend-connection-service.spec.js +141 -0
  116. package/lib/node/messaging/websocket-frontend-connection-service.spec.js.map +1 -0
  117. package/lib/node/performance/measurement-backend-bindings.js +1 -1
  118. package/lib/node/performance/measurement-backend-bindings.js.map +1 -1
  119. package/lib/node/process-utils.d.ts +125 -2
  120. package/lib/node/process-utils.d.ts.map +1 -1
  121. package/lib/node/process-utils.js +297 -25
  122. package/lib/node/process-utils.js.map +1 -1
  123. package/lib/node/process-utils.slow-spec.js +78 -3
  124. package/lib/node/process-utils.slow-spec.js.map +1 -1
  125. package/lib/node/process-utils.spec.js +237 -2
  126. package/lib/node/process-utils.spec.js.map +1 -1
  127. package/lib/node/shell-environment.d.ts +107 -0
  128. package/lib/node/shell-environment.d.ts.map +1 -0
  129. package/lib/node/shell-environment.js +396 -0
  130. package/lib/node/shell-environment.js.map +1 -0
  131. package/lib/node/shell-environment.spec.d.ts +2 -0
  132. package/lib/node/shell-environment.spec.d.ts.map +1 -0
  133. package/lib/node/shell-environment.spec.js +348 -0
  134. package/lib/node/shell-environment.spec.js.map +1 -0
  135. package/lib/node/test/exiting-backend.d.ts +5 -0
  136. package/lib/node/test/exiting-backend.d.ts.map +1 -1
  137. package/lib/node/test/exiting-backend.js +16 -3
  138. package/lib/node/test/exiting-backend.js.map +1 -1
  139. package/package.json +7 -4
  140. package/src/browser/encoding-registry.spec.ts +48 -0
  141. package/src/browser/encoding-registry.ts +1 -1
  142. package/src/browser/messaging/service-connection-provider.spec.ts +88 -0
  143. package/src/browser/messaging/service-connection-provider.ts +9 -2
  144. package/src/browser/shell/tab-bars.spec.ts +22 -0
  145. package/src/browser/shell/tab-bars.ts +25 -12
  146. package/src/common/core-preferences.ts +12 -1
  147. package/src/common/messaging/handler.ts +11 -0
  148. package/src/common/messaging/proxy-factory.spec.ts +17 -1
  149. package/src/common/messaging/proxy-factory.ts +16 -2
  150. package/src/common/shell-environment.ts +81 -0
  151. package/src/electron-browser/shell-environment/electron-shell-environment-contribution.spec.ts +95 -0
  152. package/src/electron-browser/shell-environment/electron-shell-environment-contribution.ts +72 -0
  153. package/src/electron-browser/shell-environment/electron-shell-environment-module.ts +29 -0
  154. package/src/electron-main/electron-main-application.ts +15 -4
  155. package/src/electron-node/keyboard/electron-backend-keyboard-module.ts +2 -1
  156. package/src/electron-node/request/electron-backend-request-service.ts +59 -11
  157. package/src/node/backend-application-module.ts +19 -5
  158. package/src/node/env-variables/env-variables-server.spec.ts +93 -0
  159. package/src/node/env-variables/env-variables-server.ts +22 -14
  160. package/src/node/i18n/i18n-backend-module.ts +2 -2
  161. package/src/node/index.ts +1 -0
  162. package/src/node/logger-backend-module.ts +1 -1
  163. package/src/node/messaging/connection-container-module.spec.ts +39 -0
  164. package/src/node/messaging/connection-container-module.ts +16 -4
  165. package/src/node/messaging/default-messaging-service.ts +64 -10
  166. package/src/node/messaging/gated-channel-multiplexer.spec.ts +80 -0
  167. package/src/node/messaging/gated-channel-multiplexer.ts +52 -0
  168. package/src/node/messaging/index.ts +1 -0
  169. package/src/node/messaging/messaging-backend-module.ts +1 -1
  170. package/src/node/messaging/messaging-service.ts +5 -1
  171. package/src/node/messaging/test/default-messaging-service.spec.ts +89 -2
  172. package/src/node/messaging/websocket-frontend-connection-service.spec.ts +158 -0
  173. package/src/node/messaging/websocket-frontend-connection-service.ts +9 -0
  174. package/src/node/performance/measurement-backend-bindings.ts +1 -1
  175. package/src/node/process-utils.slow-spec.ts +90 -3
  176. package/src/node/process-utils.spec.ts +268 -3
  177. package/src/node/process-utils.ts +342 -24
  178. package/src/node/shell-environment.spec.ts +388 -0
  179. package/src/node/shell-environment.ts +406 -0
  180. package/src/node/test/exiting-backend.ts +17 -3
@@ -0,0 +1,348 @@
1
+ // *****************************************************************************
2
+ // Copyright (C) 2026 STMicroelectronics and others.
3
+ //
4
+ // This program and the accompanying materials are made available under the
5
+ // terms of the Eclipse Public License v. 2.0 which is available at
6
+ // http://www.eclipse.org/legal/epl-2.0.
7
+ //
8
+ // This Source Code may also be made available under the following Secondary
9
+ // Licenses when the conditions for such availability set forth in the Eclipse
10
+ // Public License v. 2.0 are satisfied: GNU General Public License, version 2
11
+ // with the GNU Classpath Exception which is available at
12
+ // https://www.gnu.org/software/classpath/license.html.
13
+ //
14
+ // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
15
+ // *****************************************************************************
16
+ import { expect } from 'chai';
17
+ import { Container } from 'inversify';
18
+ import { ILogger } from '../common/logger.js';
19
+ import { Stopwatch } from '../common/performance/index.js';
20
+ import { ShellEnvironmentResolutionTimeout } from '../common/shell-environment.js';
21
+ import { MockLogger } from '../common/test/mock-logger.js';
22
+ import { NodeStopwatch } from './performance/node-stopwatch.js';
23
+ import { SettingService } from './setting-service.js';
24
+ import { ShellEnvironmentServerImpl } from './shell-environment.js';
25
+ /** A setting service that keeps its values in memory and counts the writes. */
26
+ class TestSettingService {
27
+ constructor() {
28
+ this.values = new Map();
29
+ this.writes = 0;
30
+ }
31
+ async get(key) {
32
+ return this.values.get(key);
33
+ }
34
+ async set(key, value) {
35
+ this.writes++;
36
+ this.values.set(key, value);
37
+ }
38
+ }
39
+ /**
40
+ * The service with the login shell replaced by Node running a script, so that the tests run without a shell,
41
+ * and with the resolution enabled, which it is not where the tests run.
42
+ */
43
+ class TestShellEnvironment extends ShellEnvironmentServerImpl {
44
+ constructor() {
45
+ super(...arguments);
46
+ /** The script to run in place of the login shell's command. Its first argument is the marker. */
47
+ this.script = '';
48
+ /** How often the login shell was killed. */
49
+ this.kills = 0;
50
+ }
51
+ getSkipReason() {
52
+ return undefined;
53
+ }
54
+ getLoginShell() {
55
+ return process.execPath;
56
+ }
57
+ getShellArguments(shell, mark) {
58
+ return ['-e', this.script, mark];
59
+ }
60
+ getResolutionTimeout() {
61
+ return super.getResolutionTimeout();
62
+ }
63
+ apply(env) {
64
+ this.applied = env;
65
+ super.apply(env);
66
+ }
67
+ kill(child) {
68
+ this.kills++;
69
+ super.kill(child);
70
+ }
71
+ /** Settles once the login shell is running. */
72
+ async whenShellStarted() {
73
+ while (!this.shell) {
74
+ await new Promise(resolve => setTimeout(resolve, 10));
75
+ }
76
+ }
77
+ }
78
+ /** The service with the shell arguments exposed. */
79
+ class ExposedShellEnvironment extends ShellEnvironmentServerImpl {
80
+ getShellArguments(shell, mark, executable) {
81
+ return super.getShellArguments(shell, mark, executable);
82
+ }
83
+ }
84
+ describe('ShellEnvironmentServerImpl', () => {
85
+ const prefix = 'THEIA_SHELL_ENVIRONMENT_SPEC_';
86
+ const restored = ['PATH', 'ELECTRON_RUN_AS_NODE', 'THEIA_RESOLVING_ENVIRONMENT', 'DISABLE_AUTO_UPDATE', 'XDG_RUNTIME_DIR', 'DEBUG'];
87
+ let original;
88
+ /** The script writes the given JSON source between the markers, with what dotfiles might print around it. */
89
+ const printing = (json) => `process.stdout.write('Welcome!\\n' + process.argv[1] + JSON.stringify(${json}) + process.argv[1] + '\\nbye\\n')`;
90
+ /** The script starts a detached program that inherits the stdout of the "shell" and keeps it open for four seconds. */
91
+ const backgroundJob = "require('child_process').spawn(process.execPath, ['-e', 'setTimeout(() => { }, 4000)'], "
92
+ + "{ detached: true, stdio: ['ignore', 'inherit', 'ignore'] }).unref();";
93
+ const setup = (script, timeout) => {
94
+ const container = new Container({ defaultScope: 'Singleton' });
95
+ container.bind(ILogger).to(MockLogger);
96
+ container.bind(Stopwatch).to(NodeStopwatch);
97
+ container.bind(TestSettingService).toSelf();
98
+ container.bind(SettingService).toService(TestSettingService);
99
+ container.bind(TestShellEnvironment).toSelf();
100
+ container.bind(ShellEnvironmentServerImpl).toSelf();
101
+ const settings = container.get(TestSettingService);
102
+ if (timeout !== undefined) {
103
+ settings.values.set(ShellEnvironmentResolutionTimeout.PREFERENCE, timeout);
104
+ }
105
+ const environment = container.get(TestShellEnvironment);
106
+ environment.script = script;
107
+ return { environment, settings };
108
+ };
109
+ beforeEach(() => {
110
+ original = new Map(restored.map(key => [key, process.env[key]]));
111
+ });
112
+ afterEach(() => {
113
+ for (const key of Object.keys(process.env)) {
114
+ if (key.startsWith(prefix)) {
115
+ delete process.env[key];
116
+ }
117
+ }
118
+ for (const [key, value] of original) {
119
+ if (value === undefined) {
120
+ delete process.env[key];
121
+ }
122
+ else {
123
+ process.env[key] = value;
124
+ }
125
+ }
126
+ });
127
+ it('applies the PATH that the login shell prints, ignoring what its configuration prints around it', async () => {
128
+ const { environment } = setup(printing("{ PATH: '/login/bin:/usr/bin' }"));
129
+ expect(await environment.whenResolved()).to.deep.equal({ status: 'applied' });
130
+ expect(process.env.PATH).to.equal('/login/bin:/usr/bin');
131
+ });
132
+ it('runs the login shell with a variable that tells the shell configuration that the environment is being resolved', async () => {
133
+ const { environment } = setup(printing("{ PATH: '/resolving/' + process.env.THEIA_RESOLVING_ENVIRONMENT }"));
134
+ expect(await environment.whenResolved()).to.deep.equal({ status: 'applied' });
135
+ expect(process.env.PATH).to.equal('/resolving/1');
136
+ });
137
+ it('applies no variable of the login shell but PATH', async () => {
138
+ const { environment } = setup(printing(`{
139
+ PATH: '/login/bin', ${prefix}VARIABLE: 'from the shell',
140
+ ELECTRON_RUN_AS_NODE: process.env.ELECTRON_RUN_AS_NODE, THEIA_RESOLVING_ENVIRONMENT: '1',
141
+ DISABLE_AUTO_UPDATE: 'true', XDG_RUNTIME_DIR: '/run/user/login', DEBUG: '*'
142
+ }`));
143
+ expect(await environment.whenResolved()).to.deep.equal({ status: 'applied' });
144
+ expect(process.env.PATH).to.equal('/login/bin');
145
+ expect(process.env[`${prefix}VARIABLE`]).to.be.undefined;
146
+ for (const key of restored.filter(variable => variable !== 'PATH')) {
147
+ expect(process.env[key], key).to.equal(original.get(key));
148
+ }
149
+ });
150
+ it('hands over the environment of the login shell without the variables that were set for the resolution', async () => {
151
+ process.env.DISABLE_AUTO_UPDATE = 'backend';
152
+ const { environment } = setup(printing(`{ ...process.env, PATH: '/login/bin', ${prefix}VARIABLE: 'from the shell' }`));
153
+ expect(await environment.whenResolved()).to.deep.equal({ status: 'applied' });
154
+ expect(environment.applied).to.include({ PATH: '/login/bin', [`${prefix}VARIABLE`]: 'from the shell' });
155
+ for (const key of ['ELECTRON_RUN_AS_NODE', 'ELECTRON_NO_ATTACH_CONSOLE', 'THEIA_RESOLVING_ENVIRONMENT',
156
+ 'DISABLE_AUTO_UPDATE', 'ZSH_TMUX_AUTOSTART', 'ZSH_TMUX_AUTOSTARTED']) {
157
+ expect(environment.applied[key], key).to.equal(process.env[key]);
158
+ }
159
+ });
160
+ it('reports a login shell environment that defines no PATH', async () => {
161
+ const { environment } = setup(printing(`{ ${prefix}VARIABLE: 'from the shell' }`));
162
+ const resolution = await environment.whenResolved();
163
+ expect(resolution.status).to.equal('failed');
164
+ expect(resolution.reason).to.contain('does not define PATH');
165
+ expect(process.env.PATH).to.equal(original.get('PATH'));
166
+ });
167
+ it('gives up on a login shell that does not answer within the timeout', async function () {
168
+ this.timeout(10_000);
169
+ const { environment } = setup('setInterval(() => { }, 1000)', '1');
170
+ const start = Date.now();
171
+ expect(await environment.whenResolved()).to.deep.equal({ status: 'timeout' });
172
+ const elapsed = Date.now() - start;
173
+ expect(elapsed).to.be.at.least(900).and.at.most(5000);
174
+ });
175
+ it('gives up at the timeout even if a program started by the shell configuration keeps the output open', async function () {
176
+ this.timeout(10_000);
177
+ // the detached program escapes the killing of the shell's process group and keeps the pipe open
178
+ const { environment } = setup(backgroundJob + 'setInterval(() => { }, 1000)', '1');
179
+ const start = Date.now();
180
+ expect(await environment.whenResolved()).to.deep.equal({ status: 'timeout' });
181
+ expect(Date.now() - start).to.be.at.most(2500);
182
+ });
183
+ it('applies the environment once the login shell has exited, even if a program that it started keeps the output open', async function () {
184
+ this.timeout(10_000);
185
+ const { environment } = setup(backgroundJob + printing("{ PATH: '/background/job' }"), '3');
186
+ const start = Date.now();
187
+ expect(await environment.whenResolved()).to.deep.equal({ status: 'applied' });
188
+ expect(Date.now() - start).to.be.at.most(2000);
189
+ expect(process.env.PATH).to.equal('/background/job');
190
+ });
191
+ it('reports a login shell that exits without printing its environment while a program that it started keeps the output open', async function () {
192
+ this.timeout(10_000);
193
+ const { environment } = setup(backgroundJob, '1');
194
+ const resolution = await environment.whenResolved();
195
+ expect(resolution.status).to.equal('failed');
196
+ expect(resolution.reason).to.contain('did not print its environment');
197
+ });
198
+ it('applies the environment that the login shell printed, even if it does not exit within the timeout', async function () {
199
+ this.timeout(10_000);
200
+ const { environment } = setup(printing("{ PATH: '/hanging/shell' }") + '; setInterval(() => { }, 1000)', '1');
201
+ expect(await environment.whenResolved()).to.deep.equal({ status: 'applied' });
202
+ expect(process.env.PATH).to.equal('/hanging/shell');
203
+ });
204
+ it('kills a login shell that is still running when the backend stops', async function () {
205
+ this.timeout(10_000);
206
+ const { environment } = setup('setInterval(() => { }, 1000)', '8');
207
+ const start = Date.now();
208
+ const resolved = environment.whenResolved();
209
+ await environment.whenShellStarted();
210
+ environment.onStop();
211
+ const resolution = await resolved;
212
+ expect(resolution.status).to.equal('failed');
213
+ // SIGKILL for its process group, or SIGTERM on Windows, where there is none and any signal ends the process
214
+ expect(resolution.reason).to.contain('exited with signal');
215
+ expect(Date.now() - start).to.be.at.most(5000);
216
+ });
217
+ it('kills nothing when the backend stops after the login shell has exited', async function () {
218
+ this.timeout(10_000);
219
+ // the program that the shell configuration started is still running
220
+ const { environment } = setup(backgroundJob + printing("{ PATH: '/exited' }"), '3');
221
+ expect(await environment.whenResolved()).to.deep.equal({ status: 'applied' });
222
+ environment.onStop();
223
+ expect(environment.kills).to.equal(0);
224
+ });
225
+ it('settles with the default timeout when the stored timeout cannot be read', async () => {
226
+ const { environment, settings } = setup(printing("{ PATH: '/default/timeout' }"));
227
+ settings.get = async () => { throw new Error('The settings cannot be read'); };
228
+ expect(await environment.whenResolved()).to.deep.equal({ status: 'applied' });
229
+ expect(process.env.PATH).to.equal('/default/timeout');
230
+ });
231
+ it('reports a login shell that fails', async () => {
232
+ const { environment } = setup('process.exit(3)');
233
+ const resolution = await environment.whenResolved();
234
+ expect(resolution.status).to.equal('failed');
235
+ expect(resolution.reason).to.contain('code 3');
236
+ });
237
+ it('reports a login shell that does not print its environment', async () => {
238
+ const { environment } = setup("process.stdout.write('nothing to see')");
239
+ const resolution = await environment.whenResolved();
240
+ expect(resolution.status).to.equal('failed');
241
+ expect(resolution.reason).to.contain('did not print its environment');
242
+ });
243
+ it('reports an environment that cannot be parsed', async () => {
244
+ const { environment } = setup("process.stdout.write(process.argv[1] + '{' + process.argv[1])");
245
+ const resolution = await environment.whenResolved();
246
+ expect(resolution.status).to.equal('failed');
247
+ expect(resolution.reason).to.contain('could not be parsed');
248
+ });
249
+ it('resolves once and shares the outcome', async () => {
250
+ const { environment } = setup(printing("{ PATH: '/once' }"));
251
+ environment.initialize();
252
+ const first = environment.whenResolved();
253
+ expect(environment.whenResolved()).to.equal(first);
254
+ expect(await first).to.deep.equal({ status: 'applied' });
255
+ process.env.PATH = '/changed';
256
+ expect(await environment.whenResolved()).to.deep.equal({ status: 'applied' });
257
+ expect(process.env.PATH).to.equal('/changed');
258
+ });
259
+ it('skips the resolution where it does not apply', async () => {
260
+ const { environment } = setup('');
261
+ const container = new Container();
262
+ container.bind(ILogger).to(MockLogger);
263
+ container.bind(Stopwatch).to(NodeStopwatch);
264
+ container.bind(SettingService).toConstantValue(new TestSettingService());
265
+ container.bind(ShellEnvironmentServerImpl).toSelf();
266
+ const unmodified = container.get(ShellEnvironmentServerImpl);
267
+ const resolution = await unmodified.whenResolved();
268
+ expect(resolution.status).to.equal('skipped');
269
+ expect(resolution.reason).to.match(process.platform === 'win32' ? /Windows/ : /Electron/);
270
+ expect(await environment.getResolutionTimeout()).to.equal(ShellEnvironmentResolutionTimeout.DEFAULT);
271
+ });
272
+ it('skips the resolution in a backend that the login shell being resolved has started', async function () {
273
+ if (process.platform === 'win32') {
274
+ this.skip();
275
+ }
276
+ const versions = process.versions;
277
+ const electron = versions.electron;
278
+ versions.electron = electron ?? '0.0.0-test';
279
+ process.env.THEIA_RESOLVING_ENVIRONMENT = '1';
280
+ try {
281
+ const container = new Container();
282
+ container.bind(ILogger).to(MockLogger);
283
+ container.bind(Stopwatch).to(NodeStopwatch);
284
+ container.bind(SettingService).toConstantValue(new TestSettingService());
285
+ container.bind(ShellEnvironmentServerImpl).toSelf();
286
+ const resolution = await container.get(ShellEnvironmentServerImpl).whenResolved();
287
+ expect(resolution.status).to.equal('skipped');
288
+ expect(resolution.reason).to.contain('login shell');
289
+ }
290
+ finally {
291
+ if (electron === undefined) {
292
+ delete versions.electron;
293
+ }
294
+ else {
295
+ versions.electron = electron;
296
+ }
297
+ }
298
+ });
299
+ it('uses the stored resolution timeout within its bounds', async () => {
300
+ const timeout = (stored) => setup('', stored).environment.getResolutionTimeout();
301
+ expect(await timeout()).to.equal(10);
302
+ expect(await timeout('')).to.equal(10);
303
+ expect(await timeout('soon')).to.equal(10);
304
+ expect(await timeout('30')).to.equal(30);
305
+ expect(await timeout('0')).to.equal(1);
306
+ expect(await timeout('300')).to.equal(120);
307
+ });
308
+ it('stores the resolution timeout for the next start when it changes', async () => {
309
+ const { environment, settings } = setup('');
310
+ await environment.setResolutionTimeout(30);
311
+ expect(settings.values.get(ShellEnvironmentResolutionTimeout.PREFERENCE)).to.equal('30');
312
+ await environment.setResolutionTimeout(30);
313
+ expect(settings.writes).to.equal(1);
314
+ await environment.setResolutionTimeout(undefined);
315
+ expect(settings.values.get(ShellEnvironmentResolutionTimeout.PREFERENCE)).to.equal('');
316
+ await environment.setResolutionTimeout(undefined);
317
+ expect(settings.writes).to.equal(2);
318
+ });
319
+ it('runs the login shell interactively and as a login shell, printing the environment with this executable', () => {
320
+ const environment = new ExposedShellEnvironment();
321
+ const mark = 'abc123';
322
+ const posix = environment.getShellArguments('/bin/zsh', mark);
323
+ expect(posix.slice(0, 3)).to.deep.equal(['-i', '-l', '-c']);
324
+ expect(posix[3]).to.contain(process.execPath).and.to.contain(`"${mark}" + JSON.stringify(process.env) + "${mark}"`);
325
+ expect(environment.getShellArguments('/bin/tcsh', mark).slice(0, 1)).to.deep.equal(['-ic']);
326
+ for (const pwsh of ['/usr/local/bin/pwsh', '/usr/local/bin/pwsh-preview', '/usr/bin/powershell']) {
327
+ const powershell = environment.getShellArguments(pwsh, mark);
328
+ expect(powershell.slice(0, 2), pwsh).to.deep.equal(['-Login', '-Command']);
329
+ expect(powershell[2], pwsh).to.contain(process.execPath).and.to.contain(`''${mark}''`);
330
+ }
331
+ const nu = environment.getShellArguments('/opt/homebrew/bin/nu', mark);
332
+ expect(nu.slice(0, 3)).to.deep.equal(['-i', '-l', '-c']);
333
+ expect(nu[3]).to.contain(`^'${process.execPath}' -p`).and.to.contain(`"${mark}" + JSON.stringify(process.env) + "${mark}"`);
334
+ const xonsh = environment.getShellArguments('/usr/bin/xonsh', mark);
335
+ expect(xonsh).to.deep.equal(['-i', '-l', '-c', `import os, json; print("${mark}", json.dumps(dict(os.environ)), "${mark}")`]);
336
+ });
337
+ it('quotes the executable for the shell even if its path contains a single quote', () => {
338
+ const environment = new ExposedShellEnvironment();
339
+ const executable = "/Applications/Theia's IDE.app/Contents/MacOS/Theia";
340
+ const quoted = "'/Applications/Theia'\\''s IDE.app/Contents/MacOS/Theia' -p";
341
+ expect(environment.getShellArguments('/bin/zsh', 'abc123', executable)[3]).to.contain(quoted);
342
+ expect(environment.getShellArguments('/bin/tcsh', 'abc123', executable)[1]).to.contain(quoted);
343
+ expect(environment.getShellArguments('/usr/local/bin/pwsh', 'abc123', executable)[2]).to.contain("& '/Applications/Theia''s IDE.app/Contents/MacOS/Theia' -p");
344
+ expect(environment.getShellArguments('/usr/local/bin/nu', 'abc123', executable)[3]).to.contain('^"/Applications/Theia\'s IDE.app/Contents/MacOS/Theia" -p');
345
+ expect(environment.getShellArguments('/usr/local/bin/nu', 'abc123', '/opt/Theia\'s "IDE"\\theia')[3]).to.contain('^"/opt/Theia\'s \\"IDE\\"\\\\theia" -p');
346
+ });
347
+ });
348
+ //# sourceMappingURL=shell-environment.spec.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shell-environment.spec.js","sourceRoot":"","sources":["../../src/node/shell-environment.spec.ts"],"names":[],"mappings":"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"}
@@ -4,6 +4,7 @@
4
4
  * The `exit` handler of the `BackendApplication` then terminates the process tree.
5
5
  * Set {@link EXITING_BACKEND_NO_POWERSHELL} to make the listing of the children of the process fail.
6
6
  * Set {@link EXITING_BACKEND_GRACEFUL} to shut down as on `SIGTERM` instead, which exits with code 1.
7
+ * Set {@link EXITING_BACKEND_CHILD_IGNORES_SIGTERM} to make the child ignore `SIGTERM`.
7
8
  */
8
9
  import 'reflect-metadata';
9
10
  export declare const EXITING_BACKEND_EXIT_CODE = 3;
@@ -15,4 +16,8 @@ export declare const EXITING_BACKEND_NO_POWERSHELL = "THEIA_TEST_EXITING_BACKEND
15
16
  * Environment variable that makes the script shut down gracefully, as on `SIGTERM`, rather than exit abruptly.
16
17
  */
17
18
  export declare const EXITING_BACKEND_GRACEFUL = "THEIA_TEST_EXITING_BACKEND_GRACEFUL";
19
+ /**
20
+ * Environment variable that makes the child of the script ignore `SIGTERM`.
21
+ */
22
+ export declare const EXITING_BACKEND_CHILD_IGNORES_SIGTERM = "THEIA_TEST_EXITING_BACKEND_CHILD_IGNORES_SIGTERM";
18
23
  //# sourceMappingURL=exiting-backend.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"exiting-backend.d.ts","sourceRoot":"","sources":["../../../src/node/test/exiting-backend.ts"],"names":[],"mappings":"AAgBA;;;;;;GAMG;AAEH,OAAO,kBAAkB,CAAC;AAY1B,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,6BAA6B,6CAA6C,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,wBAAwB,wCAAwC,CAAC"}
1
+ {"version":3,"file":"exiting-backend.d.ts","sourceRoot":"","sources":["../../../src/node/test/exiting-backend.ts"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AAEH,OAAO,kBAAkB,CAAC;AAY1B,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,6BAA6B,6CAA6C,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,wBAAwB,wCAAwC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,qCAAqC,qDAAqD,CAAC"}
@@ -19,6 +19,7 @@
19
19
  * The `exit` handler of the `BackendApplication` then terminates the process tree.
20
20
  * Set {@link EXITING_BACKEND_NO_POWERSHELL} to make the listing of the children of the process fail.
21
21
  * Set {@link EXITING_BACKEND_GRACEFUL} to shut down as on `SIGTERM` instead, which exits with code 1.
22
+ * Set {@link EXITING_BACKEND_CHILD_IGNORES_SIGTERM} to make the child ignore `SIGTERM`.
22
23
  */
23
24
  import 'reflect-metadata';
24
25
  import * as cp from 'child_process';
@@ -38,6 +39,10 @@ export const EXITING_BACKEND_NO_POWERSHELL = 'THEIA_TEST_EXITING_BACKEND_NO_POWE
38
39
  * Environment variable that makes the script shut down gracefully, as on `SIGTERM`, rather than exit abruptly.
39
40
  */
40
41
  export const EXITING_BACKEND_GRACEFUL = 'THEIA_TEST_EXITING_BACKEND_GRACEFUL';
42
+ /**
43
+ * Environment variable that makes the child of the script ignore `SIGTERM`.
44
+ */
45
+ export const EXITING_BACKEND_CHILD_IGNORES_SIGTERM = 'THEIA_TEST_EXITING_BACKEND_CHILD_IGNORES_SIGTERM';
41
46
  class NoPowerShellProcessUtils extends ProcessUtils {
42
47
  winGetPowerShellPath() {
43
48
  return 'C:\\does-not-exist\\powershell.exe';
@@ -55,8 +60,7 @@ if (process.argv[1] && path.resolve(process.argv[1]) === import.meta.filename) {
55
60
  bindContributionProvider(container, BackendApplicationContribution);
56
61
  container.bind(BackendApplication).toSelf().inSingletonScope();
57
62
  container.get(BackendApplication);
58
- const child = cp.spawn(process.execPath, ['-e', 'setInterval(() => {}, 1000)'], { stdio: 'ignore' });
59
- child.on('spawn', () => process.stdout.write(`${child.pid}\n`, () => {
63
+ const exit = () => {
60
64
  if (process.env[EXITING_BACKEND_GRACEFUL]) {
61
65
  // Signals cannot be sent to a process on Windows, so invoke the handler of the `BackendApplication` directly.
62
66
  process.emit('SIGTERM', 'SIGTERM');
@@ -64,6 +68,15 @@ if (process.argv[1] && path.resolve(process.argv[1]) === import.meta.filename) {
64
68
  else {
65
69
  process.exit(EXITING_BACKEND_EXIT_CODE);
66
70
  }
67
- }));
71
+ };
72
+ if (process.env[EXITING_BACKEND_CHILD_IGNORES_SIGTERM]) {
73
+ // The child reports when it ignores `SIGTERM`.
74
+ const child = cp.spawn(process.execPath, ['-e', 'process.on("SIGTERM", () => {}); console.log(); setInterval(() => {}, 1000)'], { stdio: ['ignore', 'pipe', 'ignore'] });
75
+ child.stdout.once('data', () => process.stdout.write(`${child.pid}\n`, exit));
76
+ }
77
+ else {
78
+ const child = cp.spawn(process.execPath, ['-e', 'setInterval(() => {}, 1000)'], { stdio: 'ignore' });
79
+ child.on('spawn', () => process.stdout.write(`${child.pid}\n`, exit));
80
+ }
68
81
  }
69
82
  //# sourceMappingURL=exiting-backend.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"exiting-backend.js","sourceRoot":"","sources":["../../../src/node/test/exiting-backend.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"exiting-backend.js","sourceRoot":"","sources":["../../../src/node/test/exiting-backend.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@theia/core",
3
- "version": "1.77.0",
3
+ "version": "1.78.0-next.19+437666ef7",
4
4
  "description": "Theia is a cloud & desktop IDE framework implemented in TypeScript.",
5
5
  "type": "module",
6
6
  "main": "lib/common/index.js",
@@ -63,8 +63,8 @@
63
63
  "@lumino/virtualdom": "^2.0.5",
64
64
  "@lumino/widgets": "2.7.5",
65
65
  "@parcel/watcher": "^2.6.0",
66
- "@theia/application-package": "1.77.0",
67
- "@theia/request": "1.77.0",
66
+ "@theia/application-package": "1.78.0-next.19+437666ef7",
67
+ "@theia/request": "1.78.0-next.19+437666ef7",
68
68
  "@types/body-parser": "^1.19.6",
69
69
  "@types/express": "^4.17.25",
70
70
  "@types/fs-extra": "^4.0.15",
@@ -221,6 +221,9 @@
221
221
  "frontendElectron": "lib/electron-browser/token/electron-token-frontend-module",
222
222
  "backendElectron": "lib/electron-node/token/electron-token-backend-module"
223
223
  },
224
+ {
225
+ "frontendElectron": "lib/electron-browser/shell-environment/electron-shell-environment-module"
226
+ },
224
227
  {
225
228
  "backend": "lib/node/hosting/backend-hosting-module",
226
229
  "backendElectron": "lib/electron-node/hosting/electron-backend-hosting-module"
@@ -279,5 +282,5 @@
279
282
  "nyc": {
280
283
  "extends": "../../configs/nyc.json"
281
284
  },
282
- "gitHead": "9c6d81590b559ee8a78a7808203674f3127411f1"
285
+ "gitHead": "437666ef7a6573ee8e5f41e3206c8be4d7e83ab4"
283
286
  }
@@ -0,0 +1,48 @@
1
+ // *****************************************************************************
2
+ // Copyright (C) 2026 Raphael Fakhri and others.
3
+ //
4
+ // This program and the accompanying materials are made available under the
5
+ // terms of the Eclipse Public License v. 2.0 which is available at
6
+ // http://www.eclipse.org/legal/epl-2.0.
7
+ //
8
+ // This Source Code may also be made available under the following Secondary
9
+ // Licenses when the conditions for such availability set forth in the Eclipse
10
+ // Public License v. 2.0 are satisfied: GNU General Public License, version 2
11
+ // with the GNU Classpath Exception which is available at
12
+ // https://www.gnu.org/software/classpath/license.html.
13
+ //
14
+ // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
15
+ // *****************************************************************************
16
+
17
+ import { expect } from 'chai';
18
+ import { Container } from 'inversify';
19
+ import { EncodingRegistry } from './encoding-registry.js';
20
+ import { CorePreferences } from '../common/core-preferences.js';
21
+ import { EncodingService } from '../common/encoding-service.js';
22
+ import { UTF8 } from '../common/encodings.js';
23
+ import URI from '../common/uri.js';
24
+
25
+ describe('EncodingRegistry', () => {
26
+
27
+ const configDir = new URI('file:///home/user/.theia');
28
+ let registry: EncodingRegistry;
29
+
30
+ beforeEach(() => {
31
+ const container = new Container();
32
+ container.bind(EncodingService).toSelf().inSingletonScope();
33
+ container.bind(CorePreferences).toConstantValue({ get: () => 'windows1252' } as unknown as CorePreferences);
34
+ container.bind(EncodingRegistry).toSelf().inSingletonScope();
35
+ registry = container.get(EncodingRegistry);
36
+ registry.registerOverride({ encoding: UTF8, parent: configDir });
37
+ });
38
+
39
+ it('should apply a parent override to resources inside the parent', () => {
40
+ expect(registry.getEncodingForResource(configDir.resolve('settings.json'))).to.equal(UTF8);
41
+ expect(registry.getEncodingForResource(configDir.resolve('nested/tasks.json'))).to.equal(UTF8);
42
+ });
43
+
44
+ it('should not apply a parent override to resources outside the parent', () => {
45
+ expect(registry.getEncodingForResource(new URI('file:///home/user/notes.txt'))).to.equal('windows1252');
46
+ expect(registry.getEncodingForResource(new URI('file:///home/user'))).to.equal('windows1252');
47
+ });
48
+ });
@@ -77,7 +77,7 @@ export class EncodingRegistry {
77
77
  protected getEncodingOverride(resource: URI): string | undefined {
78
78
  if (this.encodingOverrides && this.encodingOverrides.length) {
79
79
  for (const override of this.encodingOverrides) {
80
- if (override.parent && resource.isEqualOrParent(override.parent)) {
80
+ if (override.parent && override.parent.isEqualOrParent(resource)) {
81
81
  return override.encoding;
82
82
  }
83
83