@theia/plugin-utils 1.75.0-next.28

package/lib/common/plugin-model.spec.js

@@ -0,0 +1,204 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 Maksim Kachurin 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 fs = require("fs");
+const os = require("os");
+const path = require("path");
+const constants_1 = require("./constants");
+const plugin_model_1 = require("./plugin-model");
+const plugin_model_2 = require("../node/plugin-model");
+const test_helpers_1 = require("./test-helpers");
+describe('plugin-model', () => {
+    describe('getPluginId', () => {
+        it('sanitizes publisher and name', () => {
+            (0, chai_1.expect)((0, plugin_model_1.getPluginId)({ publisher: 'dbaeumer', name: 'vscode-eslint' })).to.equal('dbaeumer_vscode_eslint');
+        });
+        it('uses unpublished publisher when publisher is missing', () => {
+            (0, chai_1.expect)((0, plugin_model_1.getPluginId)({ name: 'my-ext' })).to.equal((0, plugin_model_1.getPluginId)({ publisher: constants_1.UNPUBLISHED, name: 'my-ext' }));
+        });
+    });
+    describe('toPluginUrl', () => {
+        it('encodes each path segment and keeps separators for static hosting', () => {
+            const url = (0, plugin_model_1.toPluginUrl)({ publisher: 'vscode', name: 'theme-monokai' }, './themes/monokai-color-theme.json');
+            (0, chai_1.expect)(url).to.equal('hostedPlugin/vscode_theme_monokai/themes/monokai-color-theme.json');
+        });
+        it('encodes special characters inside a segment', () => {
+            (0, chai_1.expect)((0, plugin_model_1.toPluginUrl)({ publisher: 'acme', name: 'ext' }, 'media/my icon.png'))
+                .to.equal('hostedPlugin/acme_ext/media/my%20icon.png');
+            (0, chai_1.expect)((0, plugin_model_1.toPluginUrl)({ publisher: 'acme', name: 'ext' }, '$(folder)'))
+                .to.equal('hostedPlugin/acme_ext/%24(folder)');
+        });
+        it('resolves .. within the plugin root and ignores leading ..', () => {
+            (0, chai_1.expect)((0, plugin_model_1.toPluginUrl)({ publisher: 'acme', name: 'ext' }, 'themes/../icons/a.png'))
+                .to.equal('hostedPlugin/acme_ext/icons/a.png');
+            (0, chai_1.expect)((0, plugin_model_1.toPluginUrl)({ publisher: 'acme', name: 'ext' }, '../secret.json'))
+                .to.equal('hostedPlugin/acme_ext/secret.json');
+        });
+    });
+    describe('pickEngineType', () => {
+        it('prefers theiaPlugin over vscode when both are declared', () => {
+            (0, chai_1.expect)((0, plugin_model_1.pickEngineType)((0, test_helpers_1.manifest)({
+                name: 'both-engines',
+                engines: { vscode: '^1.0.0', theiaPlugin: '*' }
+            }))).to.equal('theiaPlugin');
+        });
+        it('returns vscode when only vscode engine is declared', () => {
+            (0, chai_1.expect)((0, plugin_model_1.pickEngineType)((0, test_helpers_1.manifest)({
+                name: 'vscode-only',
+                engines: { vscode: '^1.0.0' }
+            }))).to.equal('vscode');
+        });
+        it('throws when no supported engine is declared', () => {
+            (0, chai_1.expect)(() => (0, plugin_model_1.pickEngineType)((0, test_helpers_1.manifest)({ name: 'no-engine' }))).to.throw(/No vscode or theiaPlugin engine/);
+        });
+    });
+    describe('applyTrustExtraction', () => {
+        it('copies untrusted workspace support when declared', () => {
+            const result = {};
+            (0, plugin_model_1.applyTrustExtraction)((0, test_helpers_1.manifest)({
+                name: 'trusted',
+                capabilities: { untrustedWorkspaces: { supported: 'limited' } }
+            }), result);
+            (0, chai_1.expect)(result.untrustedWorkspacesSupport).to.equal('limited');
+        });
+        it('leaves result unchanged when capabilities are absent', () => {
+            const result = {};
+            (0, plugin_model_1.applyTrustExtraction)((0, test_helpers_1.manifest)({ name: 'plain' }), result);
+            (0, chai_1.expect)(result.untrustedWorkspacesSupport).to.equal(undefined);
+        });
+    });
+    describe('getPluginRootFileUrl', () => {
+        let tmpDir;
+        before(() => {
+            tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'plugin-utils-root-'));
+            fs.writeFileSync(path.join(tmpDir, 'README.md'), '# Readme');
+        });
+        after(() => {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        });
+        it('finds readme files case-insensitively', () => {
+            const url = (0, plugin_model_2.getPluginRootFileUrl)((0, test_helpers_1.manifest)({ name: 'docs', packagePath: tmpDir }), ['readme.md']);
+            (0, chai_1.expect)(url).to.equal('hostedPlugin/acme_docs/README.md');
+        });
+        it('returns undefined when directory is missing', () => {
+            (0, chai_1.expect)((0, plugin_model_2.getPluginRootFileUrl)((0, test_helpers_1.manifest)({ name: 'missing', packagePath: '/no/such/path' }), ['readme.md'])).to.equal(undefined);
+        });
+    });
+    describe('buildEntryPointForTheia', () => {
+        it('maps theiaPlugin entry points and headless script', () => {
+            const entryPoint = (0, plugin_model_1.buildEntryPointForTheia)((0, test_helpers_1.manifest)({
+                name: 'theia-ext',
+                theiaPlugin: {
+                    frontend: './lib/browser/main.js',
+                    backend: './lib/node/main.js',
+                    headless: './lib/headless.js'
+                }
+            }));
+            (0, chai_1.expect)(entryPoint).to.deep.equal({
+                frontend: './lib/browser/main.js',
+                backend: './lib/node/main.js',
+                headless: './lib/headless.js'
+            });
+        });
+    });
+    describe('buildEntryPointForVsCode', () => {
+        it('prefers browser entry for ui-only extensions in web mode', () => {
+            const entryPoint = (0, plugin_model_1.buildEntryPointForVsCode)((0, test_helpers_1.manifest)({
+                name: 'ui-extension',
+                browser: './dist/browser/extension.js',
+                main: './dist/node/extension.js',
+                extensionKind: ['ui']
+            }), { uiKind: 'web' });
+            (0, chai_1.expect)(entryPoint.frontend).to.equal('./dist/browser/extension.js');
+            (0, chai_1.expect)(entryPoint.backend).to.equal(undefined);
+        });
+        it('uses main as backend when browser is absent', () => {
+            const entryPoint = (0, plugin_model_1.buildEntryPointForVsCode)((0, test_helpers_1.manifest)({
+                name: 'workspace-extension',
+                main: './dist/node/extension.js'
+            }), { uiKind: 'web' });
+            (0, chai_1.expect)(entryPoint.backend).to.equal('./dist/node/extension.js');
+            (0, chai_1.expect)(entryPoint.frontend).to.equal(undefined);
+        });
+        it('prefers backend when both main and browser exist without ui-only web hint', () => {
+            const entryPoint = (0, plugin_model_1.buildEntryPointForVsCode)((0, test_helpers_1.manifest)({
+                name: 'hybrid',
+                browser: './dist/browser/extension.js',
+                main: './dist/node/extension.js',
+                extensionKind: ['workspace', 'ui']
+            }), { uiKind: 'web' });
+            (0, chai_1.expect)(entryPoint.backend).to.equal('./dist/node/extension.js');
+            (0, chai_1.expect)(entryPoint.frontend).to.equal(undefined);
+        });
+        it('forwards headless script from theiaPlugin section', () => {
+            const entryPoint = (0, plugin_model_1.buildEntryPointForVsCode)((0, test_helpers_1.manifest)({
+                name: 'headless',
+                main: './main.js',
+                theiaPlugin: { headless: './headless.js' }
+            }));
+            (0, chai_1.expect)(entryPoint.headless).to.equal('./headless.js');
+        });
+    });
+    describe('buildModel', () => {
+        it('builds theia plugin model with defaults', () => {
+            const model = (0, plugin_model_1.buildModelForTheia)((0, test_helpers_1.manifest)({
+                name: 'Sample',
+                publisher: 'Acme',
+                packageUri: 'hostedPlugin/acme_Sample/'
+            }));
+            (0, chai_1.expect)(model.id).to.equal('acme.sample');
+            (0, chai_1.expect)(model.engine).to.deep.equal({ type: 'theiaPlugin', version: '*' });
+            (0, chai_1.expect)(model.displayName).to.equal('Test Extension');
+            (0, chai_1.expect)(model.packageUri).to.equal('hostedPlugin/acme_Sample/');
+        });
+        it('builds vscode model with icon url and web entry point', () => {
+            const model = (0, plugin_model_1.buildModelForVsCode)((0, test_helpers_1.manifest)({
+                name: 'icon-ext',
+                icon: './media/icon.png',
+                browser: './browser.js',
+                extensionKind: ['ui'],
+                engines: { vscode: '^1.90.0' }
+            }), { uiKind: 'web' });
+            (0, chai_1.expect)(model.engine).to.deep.equal({ type: 'vscode', version: '^1.90.0' });
+            (0, chai_1.expect)(model.iconUrl).to.equal('hostedPlugin/acme_icon_ext/media/icon.png');
+            (0, chai_1.expect)(model.entryPoint.frontend).to.equal('./browser.js');
+        });
+        it('uses UNPUBLISHED publisher and displayName fallback', () => {
+            const model = (0, plugin_model_1.buildModel)((0, test_helpers_1.manifest)({ name: 'anon', publisher: undefined, displayName: undefined }), 'vscode');
+            (0, chai_1.expect)(model.publisher).to.equal(constants_1.UNPUBLISHED);
+            (0, chai_1.expect)(model.displayName).to.equal('anon');
+        });
+    });
+    describe('buildLifecycle', () => {
+        it('uses theia start/stop for theiaPlugin engine', () => {
+            const lifecycle = (0, plugin_model_1.buildLifecycle)((0, test_helpers_1.manifest)({ name: 'theia', publisher: 'acme' }), 'theiaPlugin');
+            (0, chai_1.expect)(lifecycle.startMethod).to.equal(constants_1.THEIA_PLUGIN_START_METHOD);
+            (0, chai_1.expect)(lifecycle.stopMethod).to.equal(constants_1.THEIA_PLUGIN_STOP_METHOD);
+            (0, chai_1.expect)(lifecycle.frontendModuleName).to.equal('acme_theia');
+            (0, chai_1.expect)(lifecycle.frontendInitPath).to.equal(undefined);
+        });
+        it('uses vscode activate/deactivate lifecycle', () => {
+            const lifecycle = (0, plugin_model_1.buildLifecycle)((0, test_helpers_1.manifest)({ name: 'sample', publisher: 'acme' }), 'vscode');
+            (0, chai_1.expect)(lifecycle.startMethod).to.equal(constants_1.VSCODE_EXTENSION_ACTIVATE);
+            (0, chai_1.expect)(lifecycle.stopMethod).to.equal(constants_1.VSCODE_EXTENSION_DEACTIVATE);
+            (0, chai_1.expect)(lifecycle.frontendInitPath).to.equal(constants_1.VSCODE_FRONTEND_INIT);
+            (0, chai_1.expect)(lifecycle.frontendModuleName).to.equal('acme_sample');
+        });
+    });
+});
+//# sourceMappingURL=plugin-model.spec.js.map

package/lib/common/plugin-model.spec.js.map

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

package/lib/common/protocol-shims.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Structural subset of `@theia/core` / `@theia/task` types used by normalize-contributions.
+ * Keep in sync with:
+ * `packages/core/src/common/json-schema.ts`,
+ * `packages/core/src/common/preferences/preference-schema.ts`,
+ * `packages/core/src/common/color.ts`,
+ * `packages/task/src/common/task-protocol.ts`.
+ */
+export type JSONPrimitive = boolean | number | string | null;
+export type JSONValue = JSONPrimitive | JSONObject | JSONValue[];
+export interface JSONObject {
+    [key: string]: JSONValue;
+}
+export type JsonType = 'string' | 'array' | 'number' | 'integer' | 'object' | 'boolean' | 'null';
+export interface IJSONSchema {
+    id?: string;
+    $id?: string;
+    $schema?: string;
+    type?: JsonType | JsonType[];
+    owner?: string;
+    group?: string;
+    title?: string;
+    default?: JSONValue;
+    definitions?: IJSONSchemaMap;
+    description?: string;
+    properties?: IJSONSchemaMap;
+    patternProperties?: IJSONSchemaMap;
+    additionalProperties?: boolean | IJSONSchema;
+    minProperties?: number;
+    maxProperties?: number;
+    dependencies?: IJSONSchemaMap | {
+        [prop: string]: string[];
+    };
+    items?: IJSONSchema | IJSONSchema[];
+    prefixItems?: IJSONSchema[];
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+    additionalItems?: boolean | IJSONSchema;
+    pattern?: string;
+    minLength?: number;
+    maxLength?: number;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: boolean | number;
+    exclusiveMaximum?: boolean | number;
+    multipleOf?: number;
+    required?: string[];
+    $ref?: string;
+    anyOf?: IJSONSchema[];
+    allOf?: IJSONSchema[];
+    oneOf?: IJSONSchema[];
+    not?: IJSONSchema;
+    enum?: JSONValue[];
+    format?: string;
+    const?: JSONValue;
+    contains?: IJSONSchema;
+    propertyNames?: IJSONSchema;
+    $comment?: string;
+    if?: IJSONSchema;
+    then?: IJSONSchema;
+    else?: IJSONSchema;
+    defaultSnippets?: IJSONSchemaSnippet[];
+    errorMessage?: string;
+    patternErrorMessage?: string;
+    deprecationMessage?: string;
+    markdownDeprecationMessage?: string;
+    enumItemLabels?: string[];
+    enumDescriptions?: string[];
+    markdownEnumDescriptions?: string[];
+    markdownDescription?: string;
+    doNotSuggest?: boolean;
+    allowComments?: boolean;
+    allowTrailingCommas?: boolean;
+}
+export interface IJSONSchemaMap {
+    [name: string]: IJSONSchema;
+}
+export interface IJSONSchemaSnippet {
+    label?: string;
+    description?: string;
+    body?: JSONValue;
+    bodyText?: string;
+}
+/** Keep numeric values aligned with `PreferenceScope` in `@theia/core`. */
+export declare enum PreferenceScope {
+    Default = 0,
+    User = 1,
+    Workspace = 2,
+    Folder = 3
+}
+export interface PreferenceDataProperty extends IJSONSchema {
+    overridable?: boolean;
+    included?: boolean;
+    hidden?: boolean;
+    scope?: PreferenceScope;
+    typeDetails?: unknown;
+    tags?: string[];
+}
+export interface PreferenceSchema {
+    scope?: PreferenceScope;
+    title?: string;
+    defaultOverridable?: boolean;
+    properties: {
+        [name: string]: PreferenceDataProperty;
+    };
+}
+export interface ColorDefinition {
+    id: string;
+    defaults?: {
+        light: string;
+        dark: string;
+        hc: string;
+    };
+    description: string;
+}
+export interface TaskDefinition {
+    taskType: string;
+    source: string;
+    properties: {
+        required?: string[];
+        all: string[];
+        schema: IJSONSchema;
+    };
+}
+/** Same segment as `CSSIcon.iconNameSegment` in `@theia/core`. */
+export declare const ICON_NAME_SEGMENT = "[A-Za-z0-9]+";
+//# sourceMappingURL=protocol-shims.d.ts.map

package/lib/common/protocol-shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-shims.d.ts","sourceRoot":"","sources":["../../src/common/protocol-shims.ts"],"names":[],"mappings":"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"}

package/lib/common/protocol-shims.js

@@ -0,0 +1,29 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 Maksim Kachurin 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.ICON_NAME_SEGMENT = exports.PreferenceScope = void 0;
+/** Keep numeric values aligned with `PreferenceScope` in `@theia/core`. */
+var PreferenceScope;
+(function (PreferenceScope) {
+    PreferenceScope[PreferenceScope["Default"] = 0] = "Default";
+    PreferenceScope[PreferenceScope["User"] = 1] = "User";
+    PreferenceScope[PreferenceScope["Workspace"] = 2] = "Workspace";
+    PreferenceScope[PreferenceScope["Folder"] = 3] = "Folder";
+})(PreferenceScope || (exports.PreferenceScope = PreferenceScope = {}));
+/** Same segment as `CSSIcon.iconNameSegment` in `@theia/core`. */
+exports.ICON_NAME_SEGMENT = '[A-Za-z0-9]+';
+//# sourceMappingURL=protocol-shims.js.map

package/lib/common/protocol-shims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-shims.js","sourceRoot":"","sources":["../../src/common/protocol-shims.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,iDAAiD;AACjD,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;;;AA4FhF,2EAA2E;AAC3E,IAAY,eAKX;AALD,WAAY,eAAe;IACvB,2DAAW,CAAA;IACX,qDAAQ,CAAA;IACR,+DAAa,CAAA;IACb,yDAAU,CAAA;AACd,CAAC,EALW,eAAe,+BAAf,eAAe,QAK1B;AAkCD,kEAAkE;AACrD,QAAA,iBAAiB,GAAG,cAAc,CAAC"}

package/lib/common/test-helpers.d.ts

@@ -0,0 +1,5 @@
+import type { NormalizeContributionsContext } from './contribution-types';
+import type { PluginManifest } from './manifest-types';
+export declare function manifest(partial: Partial<PluginManifest> & Pick<PluginManifest, 'name'>): PluginManifest;
+export declare function createNormalizeCtx(pluginOverrides?: Partial<PluginManifest>, ctxOverrides?: Partial<NormalizeContributionsContext>): NormalizeContributionsContext;
+//# sourceMappingURL=test-helpers.d.ts.map

package/lib/common/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../src/common/test-helpers.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,cAAc,CAQxG;AAED,wBAAgB,kBAAkB,CAC9B,eAAe,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,EACzC,YAAY,CAAC,EAAE,OAAO,CAAC,6BAA6B,CAAC,GACtD,6BAA6B,CAU/B"}

package/lib/common/test-helpers.js

@@ -0,0 +1,41 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 Maksim Kachurin 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.manifest = manifest;
+exports.createNormalizeCtx = createNormalizeCtx;
+const plugin_model_1 = require("./plugin-model");
+function manifest(partial) {
+    return {
+        version: '1.0.0',
+        publisher: 'acme',
+        packagePath: '/tmp/plugin',
+        displayName: 'Test Extension',
+        ...partial
+    };
+}
+function createNormalizeCtx(pluginOverrides, ctxOverrides) {
+    const plugin = manifest({ name: 'test-ext', ...pluginOverrides });
+    return {
+        plugin,
+        resolveUrl: relativePath => (0, plugin_model_1.toPluginUrl)(plugin, relativePath),
+        resolveUri: (pck, relativePath) => (0, plugin_model_1.toPluginUrl)(pck, relativePath),
+        onError: () => undefined,
+        onWarn: () => undefined,
+        ...ctxOverrides
+    };
+}
+//# sourceMappingURL=test-helpers.js.map

package/lib/common/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../src/common/test-helpers.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,iDAAiD;AACjD,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;;AAMhF,4BAQC;AAED,gDAaC;AAzBD,iDAA6C;AAE7C,SAAgB,QAAQ,CAAC,OAA+D;IACpF,OAAO;QACH,OAAO,EAAE,OAAO;QAChB,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE,aAAa;QAC1B,WAAW,EAAE,gBAAgB;QAC7B,GAAG,OAAO;KACb,CAAC;AACN,CAAC;AAED,SAAgB,kBAAkB,CAC9B,eAAyC,EACzC,YAAqD;IAErD,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,eAAe,EAAE,CAAC,CAAC;IAClE,OAAO;QACH,MAAM;QACN,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC,IAAA,0BAAW,EAAC,MAAM,EAAE,YAAY,CAAC;QAC7D,UAAU,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,CAAC,IAAA,0BAAW,EAAC,GAAG,EAAE,YAAY,CAAC;QACjE,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;QACxB,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS;QACvB,GAAG,YAAY;KAClB,CAAC;AACN,CAAC"}

package/lib/common/utils.d.ts

@@ -0,0 +1,20 @@
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+export declare function isStringArray(value: unknown): value is string[];
+export declare function flatten<T>(arrays: readonly (readonly T[])[]): T[];
+export declare function isColorDefaults(value: unknown): value is {
+    light: string;
+    dark: string;
+    highContrast: string;
+};
+interface Errno {
+    readonly code: string;
+    readonly errno: number;
+}
+declare const ENOENT: "ENOENT";
+type ErrnoException = Error & Errno;
+export declare function isENOENT(arg: unknown): arg is ErrnoException & Readonly<{
+    code: typeof ENOENT;
+}>;
+export declare function deepClone<T>(obj: T): T;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/lib/common/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/common/utils.ts"],"names":[],"mappings":"AAgBA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,CAE/D;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAMjE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAK9G;AAED,UAAU,KAAK;IACX,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAED,QAAA,MAAM,MAAM,EAAG,QAAiB,CAAC;AAEjC,KAAK,cAAc,GAAG,KAAK,GAAG,KAAK,CAAC;AASpC,wBAAgB,QAAQ,CACpB,GAAG,EAAE,OAAO,GACb,GAAG,IAAI,cAAc,GAAG,QAAQ,CAAC;IAAE,IAAI,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC,CAE3D;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAkBtC"}

package/lib/common/utils.js

@@ -0,0 +1,74 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 Maksim Kachurin 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.isObject = isObject;
+exports.isStringArray = isStringArray;
+exports.flatten = flatten;
+exports.isColorDefaults = isColorDefaults;
+exports.isENOENT = isENOENT;
+exports.deepClone = deepClone;
+function isObject(value) {
+    // eslint-disable-next-line no-null/no-null
+    return typeof value === 'object' && value !== null;
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every(item => typeof item === 'string');
+}
+function flatten(arrays) {
+    const result = [];
+    for (const arr of arrays) {
+        result.push(...arr);
+    }
+    return result;
+}
+function isColorDefaults(value) {
+    return isObject(value)
+        && typeof value.light === 'string'
+        && typeof value.dark === 'string'
+        && typeof value.highContrast === 'string';
+}
+const ENOENT = 'ENOENT';
+function isErrnoException(arg) {
+    return arg instanceof Error
+        && isObject(arg)
+        && typeof arg.code === 'string'
+        && typeof arg.errno === 'number';
+}
+function isENOENT(arg) {
+    return isErrnoException(arg) && arg.code === ENOENT;
+}
+function deepClone(obj) {
+    if (!isObject(obj)) {
+        return obj;
+    }
+    if (obj instanceof RegExp) {
+        return obj;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const result = Array.isArray(obj) ? [] : {};
+    Object.keys(obj).forEach((key) => {
+        const prop = obj[key];
+        if (isObject(prop)) {
+            result[key] = deepClone(prop);
+        }
+        else {
+            result[key] = prop;
+        }
+    });
+    return result;
+}
+//# sourceMappingURL=utils.js.map

package/lib/common/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/common/utils.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,iDAAiD;AACjD,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,4BAGC;AAED,sCAEC;AAED,0BAMC;AAED,0CAKC;AAkBD,4BAIC;AAED,8BAkBC;AAhED,SAAgB,QAAQ,CAAC,KAAc;IACnC,2CAA2C;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACvD,CAAC;AAED,SAAgB,aAAa,CAAC,KAAc;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AACjF,CAAC;AAED,SAAgB,OAAO,CAAI,MAAiC;IACxD,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,SAAgB,eAAe,CAAC,KAAc;IAC1C,OAAO,QAAQ,CAAC,KAAK,CAAC;WACf,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;WAC/B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;WAC9B,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC;AAClD,CAAC;AAOD,MAAM,MAAM,GAAG,QAAiB,CAAC;AAIjC,SAAS,gBAAgB,CAAC,GAAY;IAClC,OAAO,GAAG,YAAY,KAAK;WACpB,QAAQ,CAAC,GAAG,CAAC;WACb,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;WAC5B,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC;AACzC,CAAC;AAED,SAAgB,QAAQ,CACpB,GAAY;IAEZ,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AACxD,CAAC;AAED,SAAgB,SAAS,CAAI,GAAM;IAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACjB,OAAO,GAAG,CAAC;IACf,CAAC;IACD,IAAI,GAAG,YAAY,MAAM,EAAE,CAAC;QACxB,OAAO,GAAG,CAAC;IACf,CAAC;IACD,8DAA8D;IAC9D,MAAM,MAAM,GAAQ,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,GAAW,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACvB,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO,MAAW,CAAC;AACvB,CAAC"}

package/lib/common/utils.spec.d.ts

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

package/lib/common/utils.spec.d.ts.map

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

package/lib/common/utils.spec.js

@@ -0,0 +1,77 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 Maksim Kachurin 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 assert_1 = require("assert");
+const fs_1 = require("fs");
+const utils_1 = require("./utils");
+describe('utils', () => {
+    describe('isObject', () => {
+        it('returns true for plain objects', () => {
+            (0, chai_1.expect)((0, utils_1.isObject)({})).to.equal(true);
+            (0, chai_1.expect)((0, utils_1.isObject)({ a: 1 })).to.equal(true);
+        });
+        it('returns false for null and primitives', () => {
+            // eslint-disable-next-line no-null/no-null
+            (0, chai_1.expect)((0, utils_1.isObject)(null)).to.equal(false);
+            (0, chai_1.expect)((0, utils_1.isObject)(undefined)).to.equal(false);
+            (0, chai_1.expect)((0, utils_1.isObject)('x')).to.equal(false);
+        });
+        it('returns true for arrays because they are objects in JavaScript', () => {
+            (0, chai_1.expect)((0, utils_1.isObject)([])).to.equal(true);
+        });
+    });
+    describe('isStringArray', () => {
+        it('returns true only for string arrays', () => {
+            (0, chai_1.expect)((0, utils_1.isStringArray)(['a', 'b'])).to.equal(true);
+            (0, chai_1.expect)((0, utils_1.isStringArray)([])).to.equal(true);
+        });
+        it('returns false for mixed or non-array values', () => {
+            (0, chai_1.expect)((0, utils_1.isStringArray)(['a', 1])).to.equal(false);
+            (0, chai_1.expect)((0, utils_1.isStringArray)('a')).to.equal(false);
+        });
+    });
+    describe('isENOENT', () => {
+        it('detects fs ENOENT errors', async () => {
+            await (0, assert_1.rejects)(fs_1.promises.readFile('definitely-missing-' + Date.now()), reason => (0, utils_1.isENOENT)(reason));
+        });
+        it('returns false for plain errors and null', () => {
+            (0, chai_1.expect)((0, utils_1.isENOENT)(new Error('I am not ENOENT'))).to.equal(false);
+            // eslint-disable-next-line no-null/no-null
+            (0, chai_1.expect)((0, utils_1.isENOENT)(null)).to.equal(false);
+        });
+        it('returns false for other errno codes', async () => {
+            await (0, assert_1.rejects)(fs_1.promises.readdir(__filename), reason => !(0, utils_1.isENOENT)(reason));
+        });
+    });
+    describe('deepClone', () => {
+        it('clones nested objects without sharing references', () => {
+            const source = { nested: { value: 1 }, list: [1, 2] };
+            const clone = (0, utils_1.deepClone)(source);
+            (0, chai_1.expect)(clone).to.deep.equal(source);
+            (0, chai_1.expect)(clone).to.not.equal(source);
+            (0, chai_1.expect)(clone.nested).to.not.equal(source.nested);
+            (0, chai_1.expect)(clone.list).to.not.equal(source.list);
+        });
+        it('returns primitives and regexps unchanged', () => {
+            (0, chai_1.expect)((0, utils_1.deepClone)(42)).to.equal(42);
+            const re = /abc/;
+            (0, chai_1.expect)((0, utils_1.deepClone)(re)).to.equal(re);
+        });
+    });
+});
+//# sourceMappingURL=utils.spec.js.map