@theia/application-package 1.34.3 → 1.34.4

package/src/application-props.ts

@@ -1,237 +1,237 @@
-// *****************************************************************************
-// Copyright (C) 2018 TypeFox 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 WITH Classpath-exception-2.0
-// *****************************************************************************
-
-import type { BrowserWindowConstructorOptions } from 'electron';
-export import deepmerge = require('deepmerge');
-
-export type RequiredRecursive<T> = {
-    [K in keyof T]-?: T[K] extends object ? RequiredRecursive<T[K]> : T[K]
-};
-
-/**
- * Base configuration for the Theia application.
- */
-export interface ApplicationConfig {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    readonly [key: string]: any;
-}
-
-export type ElectronFrontendApplicationConfig = RequiredRecursive<ElectronFrontendApplicationConfig.Partial>;
-export namespace ElectronFrontendApplicationConfig {
-    export const DEFAULT: ElectronFrontendApplicationConfig = {
-        windowOptions: {}
-    };
-    export interface Partial {
-
-        /**
-         * Override or add properties to the electron `windowOptions`.
-         *
-         * Defaults to `{}`.
-         */
-        readonly windowOptions?: BrowserWindowConstructorOptions;
-    }
-}
-
-export type DefaultTheme = string | Readonly<{ light: string, dark: string }>;
-export namespace DefaultTheme {
-    export function defaultForOSTheme(theme: DefaultTheme): string {
-        if (typeof theme === 'string') {
-            return theme;
-        }
-        if (
-            typeof window !== 'undefined' &&
-            window.matchMedia &&
-            window.matchMedia('(prefers-color-scheme: dark)').matches
-        ) {
-            return theme.dark;
-        }
-        return theme.light;
-    }
-}
-
-/**
- * Application configuration for the frontend. The following properties will be injected into the `index.html`.
- */
-export type FrontendApplicationConfig = RequiredRecursive<FrontendApplicationConfig.Partial>;
-export namespace FrontendApplicationConfig {
-    export const DEFAULT: FrontendApplicationConfig = {
-        applicationName: 'Eclipse Theia',
-        defaultTheme: { light: 'light', dark: 'dark' },
-        defaultIconTheme: 'none',
-        electron: ElectronFrontendApplicationConfig.DEFAULT,
-        defaultLocale: '',
-        validatePreferencesSchema: true
-    };
-    export interface Partial extends ApplicationConfig {
-
-        /**
-         * The default theme for the application.
-         *
-         * Defaults to `dark` if the OS's theme is dark. Otherwise `light`.
-         */
-        readonly defaultTheme?: DefaultTheme;
-
-        /**
-         * The default icon theme for the application.
-         *
-         * Defaults to `none`.
-         */
-        readonly defaultIconTheme?: string;
-
-        /**
-         * The name of the application.
-         *
-         * Defaults to `Eclipse Theia`.
-         */
-        readonly applicationName?: string;
-
-        /**
-         * Electron specific configuration.
-         *
-         * Defaults to `ElectronFrontendApplicationConfig.DEFAULT`.
-         */
-        readonly electron?: ElectronFrontendApplicationConfig.Partial;
-
-        /**
-         * The default locale for the application.
-         *
-         * Defaults to "".
-         */
-        readonly defaultLocale?: string;
-
-        /**
-         * When `true`, the application will validate the JSON schema of the preferences on start
-         * and log warnings to the console if the schema is not valid.
-         *
-         * Defaults to `true`.
-         */
-        readonly validatePreferencesSchema?: boolean;
-    }
-}
-
-/**
- * Application configuration for the backend.
- */
-export type BackendApplicationConfig = RequiredRecursive<BackendApplicationConfig.Partial>;
-export namespace BackendApplicationConfig {
-    export const DEFAULT: BackendApplicationConfig = {
-        singleInstance: false,
-    };
-    export interface Partial extends ApplicationConfig {
-
-        /**
-         * If true and in Electron mode, only one instance of the application is allowed to run at a time.
-         *
-         * Defaults to `false`.
-         */
-        readonly singleInstance?: boolean;
-    }
-}
-
-/**
- * Configuration for the generator.
- */
-export type GeneratorConfig = RequiredRecursive<GeneratorConfig.Partial>;
-export namespace GeneratorConfig {
-    export const DEFAULT: GeneratorConfig = {
-        preloadTemplate: ''
-    };
-    export interface Partial {
-
-        /**
-         * Template to use for extra preload content markup (file path or HTML).
-         *
-         * Defaults to `''`.
-         */
-        readonly preloadTemplate?: string;
-    }
-}
-
-export interface NpmRegistryProps {
-
-    /**
-     * Defaults to `false`.
-     */
-    readonly next: boolean;
-
-    /**
-     * Defaults to `https://registry.npmjs.org/`.
-     */
-    readonly registry: string;
-
-}
-export namespace NpmRegistryProps {
-    export const DEFAULT: NpmRegistryProps = {
-        next: false,
-        registry: 'https://registry.npmjs.org/'
-    };
-}
-
-/**
- * Representation of all backend and frontend related Theia extension and application properties.
- */
-export interface ApplicationProps extends NpmRegistryProps {
-
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    readonly [key: string]: any;
-
-    /**
-     * Whether the extension targets the browser or electron. Defaults to `browser`.
-     */
-    readonly target: ApplicationProps.Target;
-
-    /**
-     * Frontend related properties.
-     */
-    readonly frontend: {
-        readonly config: FrontendApplicationConfig
-    };
-
-    /**
-     * Backend specific properties.
-     */
-    readonly backend: {
-        readonly config: BackendApplicationConfig
-    };
-
-    /**
-     * Generator specific properties.
-     */
-    readonly generator: {
-        readonly config: GeneratorConfig
-    };
-}
-export namespace ApplicationProps {
-    export type Target = keyof typeof ApplicationTarget;
-    export enum ApplicationTarget {
-        browser = 'browser',
-        electron = 'electron'
-    };
-    export const DEFAULT: ApplicationProps = {
-        ...NpmRegistryProps.DEFAULT,
-        target: 'browser',
-        backend: {
-            config: BackendApplicationConfig.DEFAULT
-        },
-        frontend: {
-            config: FrontendApplicationConfig.DEFAULT
-        },
-        generator: {
-            config: GeneratorConfig.DEFAULT
-        }
-    };
-
-}
+// *****************************************************************************
+// Copyright (C) 2018 TypeFox 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 WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import type { BrowserWindowConstructorOptions } from 'electron';
+export import deepmerge = require('deepmerge');
+
+export type RequiredRecursive<T> = {
+    [K in keyof T]-?: T[K] extends object ? RequiredRecursive<T[K]> : T[K]
+};
+
+/**
+ * Base configuration for the Theia application.
+ */
+export interface ApplicationConfig {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    readonly [key: string]: any;
+}
+
+export type ElectronFrontendApplicationConfig = RequiredRecursive<ElectronFrontendApplicationConfig.Partial>;
+export namespace ElectronFrontendApplicationConfig {
+    export const DEFAULT: ElectronFrontendApplicationConfig = {
+        windowOptions: {}
+    };
+    export interface Partial {
+
+        /**
+         * Override or add properties to the electron `windowOptions`.
+         *
+         * Defaults to `{}`.
+         */
+        readonly windowOptions?: BrowserWindowConstructorOptions;
+    }
+}
+
+export type DefaultTheme = string | Readonly<{ light: string, dark: string }>;
+export namespace DefaultTheme {
+    export function defaultForOSTheme(theme: DefaultTheme): string {
+        if (typeof theme === 'string') {
+            return theme;
+        }
+        if (
+            typeof window !== 'undefined' &&
+            window.matchMedia &&
+            window.matchMedia('(prefers-color-scheme: dark)').matches
+        ) {
+            return theme.dark;
+        }
+        return theme.light;
+    }
+}
+
+/**
+ * Application configuration for the frontend. The following properties will be injected into the `index.html`.
+ */
+export type FrontendApplicationConfig = RequiredRecursive<FrontendApplicationConfig.Partial>;
+export namespace FrontendApplicationConfig {
+    export const DEFAULT: FrontendApplicationConfig = {
+        applicationName: 'Eclipse Theia',
+        defaultTheme: { light: 'light', dark: 'dark' },
+        defaultIconTheme: 'none',
+        electron: ElectronFrontendApplicationConfig.DEFAULT,
+        defaultLocale: '',
+        validatePreferencesSchema: true
+    };
+    export interface Partial extends ApplicationConfig {
+
+        /**
+         * The default theme for the application.
+         *
+         * Defaults to `dark` if the OS's theme is dark. Otherwise `light`.
+         */
+        readonly defaultTheme?: DefaultTheme;
+
+        /**
+         * The default icon theme for the application.
+         *
+         * Defaults to `none`.
+         */
+        readonly defaultIconTheme?: string;
+
+        /**
+         * The name of the application.
+         *
+         * Defaults to `Eclipse Theia`.
+         */
+        readonly applicationName?: string;
+
+        /**
+         * Electron specific configuration.
+         *
+         * Defaults to `ElectronFrontendApplicationConfig.DEFAULT`.
+         */
+        readonly electron?: ElectronFrontendApplicationConfig.Partial;
+
+        /**
+         * The default locale for the application.
+         *
+         * Defaults to "".
+         */
+        readonly defaultLocale?: string;
+
+        /**
+         * When `true`, the application will validate the JSON schema of the preferences on start
+         * and log warnings to the console if the schema is not valid.
+         *
+         * Defaults to `true`.
+         */
+        readonly validatePreferencesSchema?: boolean;
+    }
+}
+
+/**
+ * Application configuration for the backend.
+ */
+export type BackendApplicationConfig = RequiredRecursive<BackendApplicationConfig.Partial>;
+export namespace BackendApplicationConfig {
+    export const DEFAULT: BackendApplicationConfig = {
+        singleInstance: false,
+    };
+    export interface Partial extends ApplicationConfig {
+
+        /**
+         * If true and in Electron mode, only one instance of the application is allowed to run at a time.
+         *
+         * Defaults to `false`.
+         */
+        readonly singleInstance?: boolean;
+    }
+}
+
+/**
+ * Configuration for the generator.
+ */
+export type GeneratorConfig = RequiredRecursive<GeneratorConfig.Partial>;
+export namespace GeneratorConfig {
+    export const DEFAULT: GeneratorConfig = {
+        preloadTemplate: ''
+    };
+    export interface Partial {
+
+        /**
+         * Template to use for extra preload content markup (file path or HTML).
+         *
+         * Defaults to `''`.
+         */
+        readonly preloadTemplate?: string;
+    }
+}
+
+export interface NpmRegistryProps {
+
+    /**
+     * Defaults to `false`.
+     */
+    readonly next: boolean;
+
+    /**
+     * Defaults to `https://registry.npmjs.org/`.
+     */
+    readonly registry: string;
+
+}
+export namespace NpmRegistryProps {
+    export const DEFAULT: NpmRegistryProps = {
+        next: false,
+        registry: 'https://registry.npmjs.org/'
+    };
+}
+
+/**
+ * Representation of all backend and frontend related Theia extension and application properties.
+ */
+export interface ApplicationProps extends NpmRegistryProps {
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    readonly [key: string]: any;
+
+    /**
+     * Whether the extension targets the browser or electron. Defaults to `browser`.
+     */
+    readonly target: ApplicationProps.Target;
+
+    /**
+     * Frontend related properties.
+     */
+    readonly frontend: {
+        readonly config: FrontendApplicationConfig
+    };
+
+    /**
+     * Backend specific properties.
+     */
+    readonly backend: {
+        readonly config: BackendApplicationConfig
+    };
+
+    /**
+     * Generator specific properties.
+     */
+    readonly generator: {
+        readonly config: GeneratorConfig
+    };
+}
+export namespace ApplicationProps {
+    export type Target = keyof typeof ApplicationTarget;
+    export enum ApplicationTarget {
+        browser = 'browser',
+        electron = 'electron'
+    };
+    export const DEFAULT: ApplicationProps = {
+        ...NpmRegistryProps.DEFAULT,
+        target: 'browser',
+        backend: {
+            config: BackendApplicationConfig.DEFAULT
+        },
+        frontend: {
+            config: FrontendApplicationConfig.DEFAULT
+        },
+        generator: {
+            config: GeneratorConfig.DEFAULT
+        }
+    };
+
+}

package/src/environment.ts

@@ -1,76 +1,76 @@
-// *****************************************************************************
-// Copyright (C) 2018 TypeFox 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 WITH Classpath-exception-2.0
-// *****************************************************************************
-
-const isElectron: () => boolean = require('is-electron');
-
-/**
- * The electron specific environment.
- */
-class ElectronEnv {
-
-    /**
-     * Environment variable that can be accessed on the `process` to check if running in electron or not.
-     */
-    readonly THEIA_ELECTRON_VERSION = 'THEIA_ELECTRON_VERSION';
-
-    /**
-     * `true` if running in electron. Otherwise, `false`.
-     *
-     * Can be called from both the `main` and the render process. Also works for forked cluster workers.
-     */
-    is(): boolean {
-        return isElectron();
-    }
-
-    /**
-     * `true` if running in Electron in development mode. Otherwise, `false`.
-     *
-     * Cannot be used from the browser. From the browser, it is always `false`.
-     */
-    isDevMode(): boolean {
-        return this.is()
-            && typeof process !== 'undefined'
-            // `defaultApp` does not exist on the Node.js API, but on electron (`electron.d.ts`).
-            && ((process as any).defaultApp || /node_modules[/\\]electron[/\\]/.test(process.execPath)); // eslint-disable-line @typescript-eslint/no-explicit-any
-    }
-
-    /**
-     * Creates and return with a new environment object which always contains the `ELECTRON_RUN_AS_NODE: 1` property pair.
-     * This should be used to `spawn` and `fork` a new Node.js process from the Node.js shipped with Electron. Otherwise, a new Electron
-     * process will be spawned which [has side-effects](https://github.com/eclipse-theia/theia/issues/5385).
-     *
-     * If called from the backend and the `env` argument is not defined, it falls back to `process.env` such as Node.js behaves
-     * with the [`SpawnOptions`](https://nodejs.org/api/child_process.html#child_process_child_process_spawn_command_args_options).
-     * If `env` is defined, it will be shallow-copied.
-     *
-     * Calling this function from the frontend does not make any sense, hence throw an error.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    runAsNodeEnv(env?: any): any & { ELECTRON_RUN_AS_NODE: 1 } {
-        if (typeof process === 'undefined') {
-            throw new Error("'process' cannot be undefined.");
-        }
-        return {
-            ...(env === undefined ? process.env : env),
-            ELECTRON_RUN_AS_NODE: 1
-        };
-    }
-
-}
-
-const electron = new ElectronEnv();
-const environment: Readonly<{ electron: ElectronEnv }> = { electron };
-export { environment };
+// *****************************************************************************
+// Copyright (C) 2018 TypeFox 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 WITH Classpath-exception-2.0
+// *****************************************************************************
+
+const isElectron: () => boolean = require('is-electron');
+
+/**
+ * The electron specific environment.
+ */
+class ElectronEnv {
+
+    /**
+     * Environment variable that can be accessed on the `process` to check if running in electron or not.
+     */
+    readonly THEIA_ELECTRON_VERSION = 'THEIA_ELECTRON_VERSION';
+
+    /**
+     * `true` if running in electron. Otherwise, `false`.
+     *
+     * Can be called from both the `main` and the render process. Also works for forked cluster workers.
+     */
+    is(): boolean {
+        return isElectron();
+    }
+
+    /**
+     * `true` if running in Electron in development mode. Otherwise, `false`.
+     *
+     * Cannot be used from the browser. From the browser, it is always `false`.
+     */
+    isDevMode(): boolean {
+        return this.is()
+            && typeof process !== 'undefined'
+            // `defaultApp` does not exist on the Node.js API, but on electron (`electron.d.ts`).
+            && ((process as any).defaultApp || /node_modules[/\\]electron[/\\]/.test(process.execPath)); // eslint-disable-line @typescript-eslint/no-explicit-any
+    }
+
+    /**
+     * Creates and return with a new environment object which always contains the `ELECTRON_RUN_AS_NODE: 1` property pair.
+     * This should be used to `spawn` and `fork` a new Node.js process from the Node.js shipped with Electron. Otherwise, a new Electron
+     * process will be spawned which [has side-effects](https://github.com/eclipse-theia/theia/issues/5385).
+     *
+     * If called from the backend and the `env` argument is not defined, it falls back to `process.env` such as Node.js behaves
+     * with the [`SpawnOptions`](https://nodejs.org/api/child_process.html#child_process_child_process_spawn_command_args_options).
+     * If `env` is defined, it will be shallow-copied.
+     *
+     * Calling this function from the frontend does not make any sense, hence throw an error.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    runAsNodeEnv(env?: any): any & { ELECTRON_RUN_AS_NODE: 1 } {
+        if (typeof process === 'undefined') {
+            throw new Error("'process' cannot be undefined.");
+        }
+        return {
+            ...(env === undefined ? process.env : env),
+            ELECTRON_RUN_AS_NODE: 1
+        };
+    }
+
+}
+
+const electron = new ElectronEnv();
+const environment: Readonly<{ electron: ElectronEnv }> = { electron };
+export { environment };