@eclipse-glsp/server 1.1.0-RC05

package/lib/common/utils/registry.js

@@ -0,0 +1,160 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiRegistry = exports.Registry = void 0;
+/********************************************************************************
+ * Copyright (c) 2022-2023 STMicroelectronics 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 array_util_1 = require("@eclipse-glsp/protocol/lib/utils/array-util");
+const inversify_1 = require("inversify");
+/**
+ * A registry manages a set of key-value pairs and provides query functionality. In GLSP this is typically used to
+ * provide a convenience API for working with multi-injected instances e.g. action handlers or
+ * operation handlers.
+ *
+ * @typeParam K Key type
+ * @param V Value type
+ */
+let Registry = class Registry {
+    constructor() {
+        this.elements = new Map();
+    }
+    /**
+     * Registers a new key-value pair.
+     *
+     * @param key     The key object.
+     * @param element The value object.
+     * @returns `true` if the pair was registered successfully, `false` if another pair with the same key is already
+     *         registered.
+     */
+    register(key, instance) {
+        if (!this.hasKey(key)) {
+            this.elements.set(key, instance);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Removes the value with the given key from the registry.
+     *
+     * @param key The key of the value which should be removed.
+     * @returns `true` if the value was removed successfully, `false` if no value was registered for the given key.
+     */
+    deregister(key) {
+        return this.elements.delete(key);
+    }
+    /**
+     * Queries the registry to check whether a value for the given key is registered.
+     *
+     * @param key The key which should be checked.
+     * @returns `true` if a key-value pair is registered for the given key, `false` otherwise.
+     */
+    hasKey(key) {
+        return this.elements.has(key);
+    }
+    /**
+     * Retrieve the value for the given key.
+     *
+     * @param key The key whose value should be retrieved.
+     * @returns The registered value or `undefined`. Is `undefined` if no value was registered for the given key.
+     */
+    get(key) {
+        return this.elements.get(key);
+    }
+    /**
+     * Retrieve all registered values from the registry.
+     *
+     * @returns An array of all registered keys.
+     */
+    getAll() {
+        return [...new Set(this.elements.values())];
+    }
+    /**
+     * Retrieve all registered keys from the registry.
+     *
+     * @returns An array of all registered keys.
+     */
+    keys() {
+        return [...new Set(this.elements.keys())];
+    }
+};
+Registry = __decorate([
+    (0, inversify_1.injectable)()
+], Registry);
+exports.Registry = Registry;
+/**
+ * A multi registry is used to manage a set of key-value pairs. The main difference to {@link Registry} is that
+ * a multi registry doesn't enforce a 1-1 relation between key and value(s).
+ * One key can be associated with multiple values.
+ *
+ *
+ * @typeParam K  Type of the key
+ * @param V Type of the values
+ */
+let MultiRegistry = class MultiRegistry {
+    constructor() {
+        this.elements = new Map();
+    }
+    register(key, instance) {
+        const instances = this.elements.get(key);
+        if (instances) {
+            instances.push(instance);
+        }
+        else {
+            this.elements.set(key, [instance]);
+        }
+    }
+    deregister(key, element) {
+        const instances = this.elements.get(key);
+        if (instances) {
+            (0, array_util_1.remove)(instances, element);
+            return true;
+        }
+        return false;
+    }
+    deregisterAll(key) {
+        return this.elements.delete(key);
+    }
+    get(key) {
+        const existingInstances = this.elements.get(key);
+        if (existingInstances) {
+            return [...new Set(existingInstances)];
+        }
+        else {
+            return [];
+        }
+    }
+    hasKey(key) {
+        return this.elements.has(key);
+    }
+    getAll() {
+        const values = [];
+        Array.from(this.elements.values()).forEach(instances => values.push(...instances));
+        return [...new Set(values)];
+    }
+    keys() {
+        return [...new Set(this.elements.keys())];
+    }
+};
+MultiRegistry = __decorate([
+    (0, inversify_1.injectable)()
+], MultiRegistry);
+exports.MultiRegistry = MultiRegistry;
+//# sourceMappingURL=registry.js.map

package/lib/common/utils/registry.js.map

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

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

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

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

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

package/lib/common/utils/registry.spec.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/********************************************************************************
+ * Copyright (c) 2022-2023 STMicroelectronics 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 registry_1 = require("./registry");
+const chai_1 = require("chai");
+describe('Test Registry', () => {
+    let registry;
+    beforeEach(() => {
+        registry = new registry_1.Registry();
+    });
+    it('register - with new key-value pair', () => {
+        const key = 'key';
+        const value = 'value';
+        (0, chai_1.expect)(registry.register(key, value)).true;
+        (0, chai_1.expect)(registry.get(key), value);
+    });
+    it('register -  with key-value pair with a already registered key', () => {
+        // Setup
+        const key = 'key';
+        const value = 'value';
+        (0, chai_1.expect)(registry.register(key, value)).true;
+        // Test execution
+        (0, chai_1.expect)(registry.register(key, 'newValue')).false;
+        (0, chai_1.expect)(registry.get(key), value);
+    });
+    it('deregister - with registered key', () => {
+        // Setup
+        const key = 'key';
+        const value = 'value';
+        (0, chai_1.expect)(registry.register(key, value)).true;
+        // Test execution
+        (0, chai_1.expect)(registry.deregister(key)).true;
+        (0, chai_1.expect)(registry.get(key), undefined);
+    });
+    it('deregister - with unregistered key', () => {
+        (0, chai_1.expect)(registry.deregister('unregisteredKey')).false;
+    });
+    it('haskey - with registered key', () => {
+        // Setup
+        const key = 'key';
+        const value = 'value';
+        (0, chai_1.expect)(registry.register(key, value)).true;
+        // Test execution
+        (0, chai_1.expect)(registry.hasKey(key)).true;
+    });
+    it('haskey - with unregistered key', () => {
+        (0, chai_1.expect)(registry.deregister('unregisteredKey')).false;
+    });
+    it('get - with registered key', () => {
+        // Setup
+        const key = 'key';
+        const value = 'value';
+        (0, chai_1.expect)(registry.register(key, value)).true;
+        // Test execution
+        (0, chai_1.expect)(registry.get(key), value);
+    });
+    it('get - with unregistered key', () => {
+        (0, chai_1.expect)(registry.get('unregisteredKey'), undefined);
+    });
+    it('getAll - should return three values', () => {
+        // Setup
+        const e1 = { key: 'key1', value: 'value1' };
+        const e2 = { key: 'key2', value: 'value2' };
+        const e3 = { key: 'key3', value: 'value3' };
+        registry.register(e1.key, e1.value);
+        registry.register(e2.key, e2.value);
+        registry.register(e3.key, e3.value);
+        // Test execution
+        const result = registry.getAll();
+        (0, chai_1.expect)(result).to.have.length(3);
+        (0, chai_1.expect)(result.includes(e1.value)).true;
+        (0, chai_1.expect)(result.includes(e2.value)).true;
+        (0, chai_1.expect)(result.includes(e3.value)).true;
+    });
+    it('keys - should return three keys', () => {
+        // Setup
+        const e1 = { key: 'key1', value: 'value1' };
+        const e2 = { key: 'key2', value: 'value2' };
+        const e3 = { key: 'key3', value: 'value3' };
+        registry.register(e1.key, e1.value);
+        registry.register(e2.key, e2.value);
+        registry.register(e3.key, e3.value);
+        // Test execution
+        const result = registry.keys();
+        (0, chai_1.expect)(result).to.have.length(3);
+        (0, chai_1.expect)(result.includes(e1.key)).true;
+        (0, chai_1.expect)(result.includes(e2.key)).true;
+        (0, chai_1.expect)(result.includes(e3.key)).true;
+    });
+});
+describe('Test MapMultiRegistry', () => {
+    let multiRegistry;
+    beforeEach(() => {
+        multiRegistry = new registry_1.MultiRegistry();
+    });
+    it('register - with new key-value pair', () => {
+        // Setup
+        const e1 = { key: 'key', value: 'value' };
+        const e2 = { key: e1.key, value: 'value2' };
+        multiRegistry.register(e1.key, e1.value);
+        multiRegistry.register(e2.key, e2.value);
+        const resultValue = multiRegistry.get(e1.key);
+        (0, chai_1.expect)(resultValue).to.not.be.undefined;
+        (0, chai_1.expect)(resultValue.length).to.be.equal(2);
+        (0, chai_1.expect)(resultValue.includes(e1.value)).true;
+        (0, chai_1.expect)(resultValue.includes(e2.value)).true;
+    });
+    it('deregister - with registered key', () => {
+        // Setup
+        const key = 'key';
+        const existingValue = ['value', 'value2'];
+        multiRegistry.register(key, existingValue[0]);
+        multiRegistry.register(key, existingValue[1]);
+        // Test execution
+        (0, chai_1.expect)(multiRegistry.deregister(key, existingValue[1])).true;
+        const result = multiRegistry.get(key);
+        (0, chai_1.expect)(result.length).to.be.equal(1);
+        (0, chai_1.expect)(result[0], existingValue[0]);
+    });
+    it('deregister - with unregistered key', () => {
+        (0, chai_1.expect)(multiRegistry.deregister('unregisteredKey', 'someValue')).false;
+    });
+    it('deregisterAll - with registered key', () => {
+        // Setup
+        const key = 'key';
+        const existingValue = ['value', 'value2'];
+        multiRegistry.register(key, existingValue[0]);
+        multiRegistry.register(key, existingValue[1]);
+        (0, chai_1.expect)(multiRegistry.deregisterAll(key)).true;
+        (0, chai_1.expect)(multiRegistry.get(key)).to.have.length(0);
+    });
+    it('deregisterAll - with unregistered key', () => {
+        (0, chai_1.expect)(multiRegistry.deregisterAll('unregisteredKey')).false;
+    });
+    it('haskey - with registered key', () => {
+        // Setup
+        const key = 'key';
+        const existingValue = 'value';
+        multiRegistry.register(key, existingValue);
+        // Test execution
+        (0, chai_1.expect)(multiRegistry.hasKey(key)).true;
+    });
+    it('haskey - with unregistered key', () => {
+        (0, chai_1.expect)(multiRegistry.hasKey('unregisteredKey')).false;
+    });
+    it('get - with registered key', () => {
+        // Setup
+        const key = 'key';
+        const existingValue = 'value';
+        multiRegistry.register(key, existingValue);
+        // Test execution
+        (0, chai_1.expect)(multiRegistry.get(key).length).to.be.equal(1);
+        (0, chai_1.expect)(multiRegistry.get(key).includes(existingValue)).true;
+    });
+    it('get - with unregistered key', () => {
+        (0, chai_1.expect)(multiRegistry.get('unregisteredKey')).to.have.length(0);
+    });
+    it('getAll', () => {
+        // Setup
+        const e1 = { key: 'key1', value: ['value1', 'value2'] };
+        const e2 = { key: 'key2', value: ['value3'] };
+        multiRegistry.register(e1.key, e1.value[0]);
+        multiRegistry.register(e1.key, e1.value[1]);
+        multiRegistry.register(e2.key, e2.value[0]);
+        // Test execution
+        const result = multiRegistry.getAll();
+        (0, chai_1.expect)(result).to.have.length(3);
+        (0, chai_1.expect)(e1.value.every(v => result.includes(v))).true;
+        (0, chai_1.expect)(e2.value.every(v => result.includes(v))).true;
+    });
+    it('keys', () => {
+        // Setup
+        const e1 = { key: 'key1', value: ['value1', 'value2'] };
+        const e2 = { key: 'key2', value: ['value3'] };
+        multiRegistry.register(e1.key, e1.value[0]);
+        multiRegistry.register(e1.key, e1.value[1]);
+        multiRegistry.register(e2.key, e2.value[0]);
+        // Test execution
+        const result = multiRegistry.keys();
+        (0, chai_1.expect)(result.length).to.be.equal(2);
+        (0, chai_1.expect)(result.includes(e1.key)).true;
+        (0, chai_1.expect)(result.includes(e2.key)).true;
+    });
+});
+//# sourceMappingURL=registry.spec.js.map

package/lib/common/utils/registry.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.spec.js","sourceRoot":"","sources":["../../../src/common/utils/registry.spec.ts"],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;;kFAckF;AAClF,yCAAqD;AACrD,+BAA8B;AAE9B,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC3B,IAAI,QAAkC,CAAC;IAEvC,UAAU,CAAC,GAAG,EAAE;QACZ,QAAQ,GAAG,IAAI,mBAAQ,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,MAAM,GAAG,GAAG,KAAK,CAAC;QAClB,MAAM,KAAK,GAAG,OAAO,CAAC;QACtB,IAAA,aAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3C,IAAA,aAAM,EAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACrE,QAAQ;QACR,MAAM,GAAG,GAAG,KAAK,CAAC;QAClB,MAAM,KAAK,GAAG,OAAO,CAAC;QACtB,IAAA,aAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3C,iBAAiB;QACjB,IAAA,aAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;QACjD,IAAA,aAAM,EAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QACxC,QAAQ;QACR,MAAM,GAAG,GAAG,KAAK,CAAC;QAClB,MAAM,KAAK,GAAG,OAAO,CAAC;QACtB,IAAA,aAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3C,iBAAiB;QACjB,IAAA,aAAM,EAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QACtC,IAAA,aAAM,EAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,IAAA,aAAM,EAAC,QAAQ,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACpC,QAAQ;QACR,MAAM,GAAG,GAAG,KAAK,CAAC;QAClB,MAAM,KAAK,GAAG,OAAO,CAAC;QACtB,IAAA,aAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3C,iBAAiB;QACjB,IAAA,aAAM,EAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACtC,IAAA,aAAM,EAAC,QAAQ,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,QAAQ;QACR,MAAM,GAAG,GAAG,KAAK,CAAC;QAClB,MAAM,KAAK,GAAG,OAAO,CAAC;QACtB,IAAA,aAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3C,iBAAiB;QACjB,IAAA,aAAM,EAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACnC,IAAA,aAAM,EAAC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC3C,QAAQ;QACR,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QACpC,iBAAiB;QACjB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;QACjC,IAAA,aAAM,EAAC,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACjC,IAAA,aAAM,EAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACvC,IAAA,aAAM,EAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACvC,IAAA,aAAM,EAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACvC,QAAQ;QACR,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QACpC,iBAAiB;QACjB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAA,aAAM,EAAC,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACjC,IAAA,aAAM,EAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QACrC,IAAA,aAAM,EAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QACrC,IAAA,aAAM,EAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACnC,IAAI,aAA4C,CAAC;IAEjD,UAAU,CAAC,GAAG,EAAE;QACZ,aAAa,GAAG,IAAI,wBAAa,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,QAAQ;QACR,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC1C,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAE5C,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QACzC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QAEzC,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAA,aAAM,EAAC,WAAW,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC;QACxC,IAAA,aAAM,EAAC,WAAY,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAA,aAAM,EAAC,WAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7C,IAAA,aAAM,EAAC,WAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QACxC,QAAQ;QACR,MAAM,GAAG,GAAG,KAAK,CAAC;QAClB,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC1C,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,iBAAiB;QACjB,IAAA,aAAM,EAAC,aAAa,CAAC,UAAU,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,IAAA,aAAM,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrC,IAAA,aAAM,EAAC,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,IAAA,aAAM,EAAC,aAAa,CAAC,UAAU,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC3C,QAAQ;QACR,MAAM,GAAG,GAAG,KAAK,CAAC;QAClB,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC1C,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAA,aAAM,EAAC,aAAa,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9C,IAAA,aAAM,EAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC7C,IAAA,aAAM,EAAC,aAAa,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACpC,QAAQ;QACR,MAAM,GAAG,GAAG,KAAK,CAAC;QAClB,MAAM,aAAa,GAAG,OAAO,CAAC;QAC9B,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAC3C,iBAAiB;QACjB,IAAA,aAAM,EAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACtC,IAAA,aAAM,EAAC,aAAa,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,QAAQ;QACR,MAAM,GAAG,GAAG,KAAK,CAAC;QAClB,MAAM,aAAa,GAAG,OAAO,CAAC;QAC9B,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAC3C,iBAAiB;QACjB,IAAA,aAAM,EAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrD,IAAA,aAAM,EAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACnC,IAAA,aAAM,EAAC,aAAa,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACd,QAAQ;QACR,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;QACxD,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,iBAAiB;QACjB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC;QACtC,IAAA,aAAM,EAAC,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACjC,IAAA,aAAM,EAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrD,IAAA,aAAM,EAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACZ,QAAQ;QACR,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;QACxD,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,iBAAiB;QACjB,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;QACpC,IAAA,aAAM,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrC,IAAA,aAAM,EAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QACrC,IAAA,aAAM,EAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/lib/node/abstract-json-model-storage.d.ts

@@ -0,0 +1,45 @@
+/********************************************************************************
+ * Copyright (c) 2022-2023 EclipseSource 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 { MaybePromise, RequestModelAction, SaveModelAction, TypeGuard } from '@eclipse-glsp/protocol';
+import { ModelState } from '../common/features/model/model-state';
+import { SourceModelStorage } from '../common/features/model/source-model-storage';
+/**
+ * An abstract implementation of {@link SourceModelStorage} that provides utility methods for loading and saving JSON source models
+ * from/into a file.
+ */
+export declare abstract class AbstractJsonModelStorage implements SourceModelStorage {
+    protected modelState: ModelState;
+    abstract loadSourceModel(action: RequestModelAction): MaybePromise<void>;
+    abstract saveSourceModel(action: SaveModelAction): MaybePromise<void>;
+    protected getSourceUri(action: RequestModelAction): string;
+    protected loadFromFile(sourceUri: string): unknown;
+    protected loadFromFile<T>(sourceUri: string, guard: TypeGuard<T>): T;
+    /**
+     * Can be overwritten to customize the behavior if the given file path points to an empty file.
+     * The default implementation returns undefined, concrete subclasses can customize this behavior and
+     * return new source model object instead.
+     * @param path The path of the empty file.
+     * @returns The new model or `undefined`
+     */
+    protected createModelForEmptyFile(path: string): unknown | undefined;
+    protected readFile(path: string): unknown | undefined;
+    protected toJson(fileContent: string): unknown;
+    protected toPath(sourceUri: string): string;
+    protected getFileUri(action: SaveModelAction): string;
+    protected writeFile(fileUri: string, model: unknown): void;
+    protected toString(model: unknown): string;
+}
+//# sourceMappingURL=abstract-json-model-storage.d.ts.map

package/lib/node/abstract-json-model-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-json-model-storage.d.ts","sourceRoot":"","sources":["../../src/node/abstract-json-model-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAClF,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAItG,OAAO,EAAE,UAAU,EAAkB,MAAM,sCAAsC,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AAGnF;;;GAGG;AACH,8BACsB,wBAAyB,YAAW,kBAAkB;IAExE,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC;IAEjC,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAAC,IAAI,CAAC;IAExE,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CAAC,IAAI,CAAC;IAErE,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM;IAQ1D,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAClD,SAAS,CAAC,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;IAoBpE;;;;;;OAMG;IACH,SAAS,CAAC,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIpE,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAYrD,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAI9C,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI3C,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM;IAQrD,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAM1D,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;CAG7C"}

package/lib/node/abstract-json-model-storage.js

@@ -0,0 +1,103 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractJsonModelStorage = void 0;
+const fs = require("fs-extra");
+const inversify_1 = require("inversify");
+const url_1 = require("url");
+const model_state_1 = require("../common/features/model/model-state");
+const glsp_server_error_1 = require("../common/utils/glsp-server-error");
+/**
+ * An abstract implementation of {@link SourceModelStorage} that provides utility methods for loading and saving JSON source models
+ * from/into a file.
+ */
+let AbstractJsonModelStorage = class AbstractJsonModelStorage {
+    getSourceUri(action) {
+        var _a;
+        const sourceUri = (_a = action.options) === null || _a === void 0 ? void 0 : _a[model_state_1.SOURCE_URI_ARG];
+        if (typeof sourceUri !== 'string') {
+            throw new glsp_server_error_1.GLSPServerError(`Invalid RequestModelAction! Missing argument with key '${model_state_1.SOURCE_URI_ARG}'`);
+        }
+        return sourceUri;
+    }
+    loadFromFile(sourceUri, guard) {
+        try {
+            const path = this.toPath(sourceUri);
+            let fileContent = this.readFile(path);
+            if (!fileContent) {
+                fileContent = this.createModelForEmptyFile(path);
+                if (!fileContent) {
+                    throw new glsp_server_error_1.GLSPServerError(`Could not load the source model. The file '${path}' is empty!.`);
+                }
+            }
+            if (guard && !guard(fileContent)) {
+                throw new Error('The loaded root object is not of the expected type!');
+            }
+            return fileContent;
+        }
+        catch (error) {
+            throw new glsp_server_error_1.GLSPServerError(`Could not load model from file: ${sourceUri}`, error);
+        }
+    }
+    /**
+     * Can be overwritten to customize the behavior if the given file path points to an empty file.
+     * The default implementation returns undefined, concrete subclasses can customize this behavior and
+     * return new source model object instead.
+     * @param path The path of the empty file.
+     * @returns The new model or `undefined`
+     */
+    createModelForEmptyFile(path) {
+        return undefined;
+    }
+    readFile(path) {
+        try {
+            const data = fs.readFileSync(path, { encoding: 'utf8' });
+            if (!data || data.length === 0) {
+                return undefined;
+            }
+            return this.toJson(data);
+        }
+        catch (error) {
+            throw new glsp_server_error_1.GLSPServerError(`Could not read & parse file contents of '${path}' as json`, error);
+        }
+    }
+    toJson(fileContent) {
+        return JSON.parse(fileContent);
+    }
+    toPath(sourceUri) {
+        return sourceUri.startsWith('file://') ? (0, url_1.fileURLToPath)(sourceUri) : sourceUri;
+    }
+    getFileUri(action) {
+        var _a;
+        const uri = (_a = action.fileUri) !== null && _a !== void 0 ? _a : this.modelState.get(model_state_1.SOURCE_URI_ARG);
+        if (!uri) {
+            throw new glsp_server_error_1.GLSPServerError('Could not derive fileUri for saving the current source model');
+        }
+        return uri;
+    }
+    writeFile(fileUri, model) {
+        const path = this.toPath(fileUri);
+        const content = this.toString(model);
+        fs.writeFileSync(path, content);
+    }
+    toString(model) {
+        return JSON.stringify(model, undefined, 2);
+    }
+};
+__decorate([
+    (0, inversify_1.inject)(model_state_1.ModelState),
+    __metadata("design:type", Object)
+], AbstractJsonModelStorage.prototype, "modelState", void 0);
+AbstractJsonModelStorage = __decorate([
+    (0, inversify_1.injectable)()
+], AbstractJsonModelStorage);
+exports.AbstractJsonModelStorage = AbstractJsonModelStorage;
+//# sourceMappingURL=abstract-json-model-storage.js.map

package/lib/node/abstract-json-model-storage.js.map

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

package/lib/node/di/app-module.d.ts

@@ -0,0 +1,36 @@
+/********************************************************************************
+ * Copyright (c) 2022-2023 STMicroelectronics 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 { ContainerModule } from 'inversify';
+import * as winston from 'winston';
+import { ModuleContext } from '../../common/index';
+import { LaunchOptions } from '../launch/cli-parser';
+export declare function createAppModule(options: LaunchOptions): ContainerModule;
+/**
+ * Creates the global {@link winston.Logger} instance is used internally by all instances of {@link WinstonLogger}. Can be configured with
+ * the given {@link LaunchOptions}.
+ * @param options The {@link LaunchOptions}
+ * @returns the configured winston instance.
+ */
+export declare function createWinstonInstance<T extends LaunchOptions>(options: T): winston.Logger;
+/**
+ * Configures the binding for {@link WinstonLogger} in the given {@link ModuleContext} with the given {@link LaunchOptions}.
+ * @param context The module context.
+ * @param options The launch options.
+ * @param rebind Flag to determine wether an existing {@link Logger} binding in the context should be rebound. Default is `true`.
+ * @param baseLoggerCreator The underling global {@link winston.Logger} instance.
+ */
+export declare function configureWinstonLogger<T extends LaunchOptions>(context: ModuleContext, options: T, rebind?: boolean, baseLoggerCreator?: (launchOptions: T) => winston.Logger): void;
+//# sourceMappingURL=app-module.d.ts.map

package/lib/node/di/app-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-module.d.ts","sourceRoot":"","sources":["../../../src/node/di/app-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;kFAckF;AAClF,OAAO,EAAE,eAAe,EAAc,MAAM,WAAW,CAAC;AACxD,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAuD,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,CAMvE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,aAAa,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAyBzF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,aAAa,EAC1D,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,CAAC,EACV,MAAM,UAAO,EACb,iBAAiB,GAAE,CAAC,aAAa,EAAE,CAAC,KAAK,OAAO,CAAC,MAA8B,GAChF,IAAI,CAiBN"}