@chili-publish/studio-sdk 1.42.0 → 1.44.0

package/lib/src/controllers/UndoManagerController.cjs.js

@@ -0,0 +1,134 @@
+"use strict";
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var _editorAPI, _advanced, _sdk, _editorAPI2;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const EditorResponseData = require("../utils/EditorResponseData.cjs.js");
+class UndoManagerController {
+  /**
+   * @ignore
+   */
+  constructor(children, sdk) {
+    /**
+     * @ignore
+     */
+    __privateAdd(this, _editorAPI);
+    __privateAdd(this, _advanced);
+    __privateAdd(this, _sdk);
+    this.undo = async () => {
+      const res = await __privateGet(this, _editorAPI);
+      return res.undo().then((result) => EditorResponseData.getEditorResponseData(result));
+    };
+    this.redo = async () => {
+      const res = await __privateGet(this, _editorAPI);
+      return res.redo().then((result) => EditorResponseData.getEditorResponseData(result));
+    };
+    this.addCustomData = async (key, value) => {
+      const res = await __privateGet(this, _editorAPI);
+      return res.setCustomUndoData(key, value, false).then((result) => EditorResponseData.getEditorResponseData(result));
+    };
+    this.record = async (operationName, undoOperationCallback) => {
+      try {
+        await __privateGet(this, _advanced).beginIfNoneActive(operationName);
+        await undoOperationCallback(__privateGet(this, _sdk));
+        await __privateGet(this, _advanced).end();
+      } catch (error) {
+        await __privateGet(this, _advanced).abort();
+        throw error;
+      }
+    };
+    this.pause = async () => {
+      const res = await __privateGet(this, _editorAPI);
+      return res.pause().then((result) => EditorResponseData.getEditorResponseData(result));
+    };
+    this.resume = async () => {
+      const res = await __privateGet(this, _editorAPI);
+      return res.resume().then((result) => EditorResponseData.getEditorResponseData(result));
+    };
+    this.clear = async () => {
+      const res = await __privateGet(this, _editorAPI);
+      return res.clear().then((result) => EditorResponseData.getEditorResponseData(result));
+    };
+    this.advanced = {
+      /**
+       * This will start a new undo operation.
+       * This will throw an exception when there is already an undo operation recording.
+       * @experimental This method is experimental and may change in future versions.
+       * @returns
+       */
+      begin: async (operationName) => {
+        return __privateGet(this, _advanced).begin(operationName);
+      },
+      /**
+       * This will start a new undo operation if there is no other undo operation recording.
+       * This does not throw.
+       * @experimental This method is experimental and may change in future versions.
+       * @returns
+       */
+      beginIfNoneActive: async (operationName) => {
+        return __privateGet(this, _advanced).beginIfNoneActive(operationName);
+      },
+      /**
+       * Ends the currently active recording operation.
+       * If there is no recording operation currently running this will throw an exception.
+       * @experimental This method is experimental and may change in future versions.
+       * @returns
+       */
+      end: async () => {
+        return __privateGet(this, _advanced).end();
+      },
+      /**
+       * Aborts the currently active recording operation.
+       * If there is no recording operation currently running this will throw an exception.
+       * @experimental This method is experimental and may change in future versions.
+       * @returns
+       */
+      abort: async () => {
+        return __privateGet(this, _advanced).abort();
+      }
+    };
+    __privateSet(this, _editorAPI, children);
+    __privateSet(this, _sdk, sdk);
+    __privateSet(this, _advanced, new AdvancedUndoManagerController(children));
+  }
+}
+_editorAPI = new WeakMap();
+_advanced = new WeakMap();
+_sdk = new WeakMap();
+class AdvancedUndoManagerController {
+  /**
+   * @ignore
+   */
+  constructor(children) {
+    /**
+     * @ignore
+     */
+    __privateAdd(this, _editorAPI2);
+    this.begin = async (operationName) => {
+      const res = await __privateGet(this, _editorAPI2);
+      return res.begin(operationName).then((result) => EditorResponseData.getEditorResponseData(result));
+    };
+    this.beginIfNoneActive = async (operationName) => {
+      const res = await __privateGet(this, _editorAPI2);
+      return res.beginIfNoneActive(operationName).then((result) => EditorResponseData.getEditorResponseData(result));
+    };
+    this.end = async () => {
+      const res = await __privateGet(this, _editorAPI2);
+      return res.end().then((result) => EditorResponseData.getEditorResponseData(result));
+    };
+    this.abort = async () => {
+      const res = await __privateGet(this, _editorAPI2);
+      return res.abort().then((result) => EditorResponseData.getEditorResponseData(result));
+    };
+    __privateSet(this, _editorAPI2, children);
+  }
+}
+_editorAPI2 = new WeakMap();
+exports.AdvancedUndoManagerController = AdvancedUndoManagerController;
+exports.UndoManagerController = UndoManagerController;
+//# sourceMappingURL=UndoManagerController.cjs.js.map

package/lib/src/controllers/UndoManagerController.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UndoManagerController.cjs.js","sources":["../../../src/controllers/UndoManagerController.ts"],"sourcesContent":["import SDK from '..';\nimport { EditorAPI } from '../types/CommonTypes';\nimport { getEditorResponseData } from '../utils/EditorResponseData';\n\n/**\n * The UndoManagerController is responsible for all communication regarding the Undo-Manager.\n * Methods inside this controller can be called by `window.SDK.undoManager.{method-name}`\n */\nexport class UndoManagerController {\n    /**\n     * @ignore\n     */\n    #editorAPI: EditorAPI;\n    #advanced: AdvancedUndoManagerController;\n    #sdk: SDK;\n\n    /**\n     * @ignore\n     */\n    constructor(children: EditorAPI, sdk: SDK) {\n        this.#editorAPI = children;\n        this.#sdk = sdk;\n        this.#advanced = new AdvancedUndoManagerController(children);\n    }\n\n    /**\n     * This method undoes the last operation\n     * @returns\n     */\n    undo = async () => {\n        const res = await this.#editorAPI;\n        return res.undo().then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * This method redoes the last operation\n     * @returns\n     */\n    redo = async () => {\n        const res = await this.#editorAPI;\n        return res.redo().then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * This method adds custom data that will be saved and restored when undoing and redoing.\n     * Duplicate values are overwritten. The data is exposed via the onCustomUndoDataChanged event.\n     *\n     * @param key The key of the custom data\n     * @param value The value of the custom data\n     * @returns\n     */\n    addCustomData = async (key: string, value: string) => {\n        const res = await this.#editorAPI;\n        return res.setCustomUndoData(key, value, false).then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * Record any operations in the current scope. This will automatically begin\n     * the undo operation. Once you leave the record scope, it will end the undo operation.\n     * Even if you throw an exception inside the record scope it will still end it properly.\n     * @returns\n     */\n    record = async (operationName: string, undoOperationCallback: (sdk: SDK) => Promise<void>) => {\n        try {\n            await this.#advanced.beginIfNoneActive(operationName);\n\n            await undoOperationCallback(this.#sdk);\n\n            await this.#advanced.end();\n        } catch (error) {\n            await this.#advanced.abort();\n            throw error;\n        }\n    };\n\n    /**\n     * This method pauses the undo manager\n     * @returns\n     */\n    pause = async () => {\n        const res = await this.#editorAPI;\n        return res.pause().then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * This method resumes the undo manager\n     * @returns\n     */\n    resume = async () => {\n        const res = await this.#editorAPI;\n        return res.resume().then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * This method clears the undo stack\n     * @returns\n     */\n    clear = async () => {\n        const res = await this.#editorAPI;\n        return res.clear().then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * Advanced undo manager functionality for manually controlling undo operations.\n     * This will start a new undo operation.\n     * This will throw an exception when there is already an undo operation recording.\n     * @experimental This method is experimental and may change in future versions.\n     * @returns\n     */\n    advanced = {\n        /**\n         * This will start a new undo operation.\n         * This will throw an exception when there is already an undo operation recording.\n         * @experimental This method is experimental and may change in future versions.\n         * @returns\n         */\n        begin: async (operationName: string) => {\n            return this.#advanced.begin(operationName);\n        },\n\n        /**\n         * This will start a new undo operation if there is no other undo operation recording.\n         * This does not throw.\n         * @experimental This method is experimental and may change in future versions.\n         * @returns\n         */\n        beginIfNoneActive: async (operationName: string) => {\n            return this.#advanced.beginIfNoneActive(operationName);\n        },\n\n        /**\n         * Ends the currently active recording operation.\n         * If there is no recording operation currently running this will throw an exception.\n         * @experimental This method is experimental and may change in future versions.\n         * @returns\n         */\n        end: async () => {\n            return this.#advanced.end();\n        },\n\n        /**\n         * Aborts the currently active recording operation.\n         * If there is no recording operation currently running this will throw an exception.\n         * @experimental This method is experimental and may change in future versions.\n         * @returns\n         */\n        abort: async () => {\n            return this.#advanced.abort();\n        },\n    };\n}\n\nexport class AdvancedUndoManagerController {\n    /**\n     * @ignore\n     */\n    #editorAPI: EditorAPI;\n\n    /**\n     * @ignore\n     */\n    constructor(children: EditorAPI) {\n        this.#editorAPI = children;\n    }\n\n    /**\n     * This will start a new undo operation.\n     * This will throw an exception when there is already an undo operation recording.\n     * @returns\n     */\n    begin = async (operationName: string) => {\n        const res = await this.#editorAPI;\n        return res.begin(operationName).then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * This will start a new undo operation if there is no other undo operation recording.\n     * This does not throw.\n     * @returns\n     */\n    beginIfNoneActive = async (operationName: string) => {\n        const res = await this.#editorAPI;\n        return res.beginIfNoneActive(operationName).then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * Ends the currently active recording operation.\n     * If there is no recording operation currently running this will throw an exception.\n     * @returns\n     */\n    end = async () => {\n        const res = await this.#editorAPI;\n        return res.end().then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * Aborts the currently active recording operation.\n     * If there is no recording operation currently running this will throw an exception.\n     * @returns\n     */\n    abort = async () => {\n        const res = await this.#editorAPI;\n        return res.abort().then((result) => getEditorResponseData<null>(result));\n    };\n}\n"],"names":["getEditorResponseData","_editorAPI"],"mappings":"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"}

package/lib/src/controllers/UndoManagerController.es.js

@@ -0,0 +1,134 @@
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var _editorAPI, _advanced, _sdk, _editorAPI2;
+import { getEditorResponseData } from "../utils/EditorResponseData.es.js";
+class UndoManagerController {
+  /**
+   * @ignore
+   */
+  constructor(children, sdk) {
+    /**
+     * @ignore
+     */
+    __privateAdd(this, _editorAPI);
+    __privateAdd(this, _advanced);
+    __privateAdd(this, _sdk);
+    this.undo = async () => {
+      const res = await __privateGet(this, _editorAPI);
+      return res.undo().then((result) => getEditorResponseData(result));
+    };
+    this.redo = async () => {
+      const res = await __privateGet(this, _editorAPI);
+      return res.redo().then((result) => getEditorResponseData(result));
+    };
+    this.addCustomData = async (key, value) => {
+      const res = await __privateGet(this, _editorAPI);
+      return res.setCustomUndoData(key, value, false).then((result) => getEditorResponseData(result));
+    };
+    this.record = async (operationName, undoOperationCallback) => {
+      try {
+        await __privateGet(this, _advanced).beginIfNoneActive(operationName);
+        await undoOperationCallback(__privateGet(this, _sdk));
+        await __privateGet(this, _advanced).end();
+      } catch (error) {
+        await __privateGet(this, _advanced).abort();
+        throw error;
+      }
+    };
+    this.pause = async () => {
+      const res = await __privateGet(this, _editorAPI);
+      return res.pause().then((result) => getEditorResponseData(result));
+    };
+    this.resume = async () => {
+      const res = await __privateGet(this, _editorAPI);
+      return res.resume().then((result) => getEditorResponseData(result));
+    };
+    this.clear = async () => {
+      const res = await __privateGet(this, _editorAPI);
+      return res.clear().then((result) => getEditorResponseData(result));
+    };
+    this.advanced = {
+      /**
+       * This will start a new undo operation.
+       * This will throw an exception when there is already an undo operation recording.
+       * @experimental This method is experimental and may change in future versions.
+       * @returns
+       */
+      begin: async (operationName) => {
+        return __privateGet(this, _advanced).begin(operationName);
+      },
+      /**
+       * This will start a new undo operation if there is no other undo operation recording.
+       * This does not throw.
+       * @experimental This method is experimental and may change in future versions.
+       * @returns
+       */
+      beginIfNoneActive: async (operationName) => {
+        return __privateGet(this, _advanced).beginIfNoneActive(operationName);
+      },
+      /**
+       * Ends the currently active recording operation.
+       * If there is no recording operation currently running this will throw an exception.
+       * @experimental This method is experimental and may change in future versions.
+       * @returns
+       */
+      end: async () => {
+        return __privateGet(this, _advanced).end();
+      },
+      /**
+       * Aborts the currently active recording operation.
+       * If there is no recording operation currently running this will throw an exception.
+       * @experimental This method is experimental and may change in future versions.
+       * @returns
+       */
+      abort: async () => {
+        return __privateGet(this, _advanced).abort();
+      }
+    };
+    __privateSet(this, _editorAPI, children);
+    __privateSet(this, _sdk, sdk);
+    __privateSet(this, _advanced, new AdvancedUndoManagerController(children));
+  }
+}
+_editorAPI = new WeakMap();
+_advanced = new WeakMap();
+_sdk = new WeakMap();
+class AdvancedUndoManagerController {
+  /**
+   * @ignore
+   */
+  constructor(children) {
+    /**
+     * @ignore
+     */
+    __privateAdd(this, _editorAPI2);
+    this.begin = async (operationName) => {
+      const res = await __privateGet(this, _editorAPI2);
+      return res.begin(operationName).then((result) => getEditorResponseData(result));
+    };
+    this.beginIfNoneActive = async (operationName) => {
+      const res = await __privateGet(this, _editorAPI2);
+      return res.beginIfNoneActive(operationName).then((result) => getEditorResponseData(result));
+    };
+    this.end = async () => {
+      const res = await __privateGet(this, _editorAPI2);
+      return res.end().then((result) => getEditorResponseData(result));
+    };
+    this.abort = async () => {
+      const res = await __privateGet(this, _editorAPI2);
+      return res.abort().then((result) => getEditorResponseData(result));
+    };
+    __privateSet(this, _editorAPI2, children);
+  }
+}
+_editorAPI2 = new WeakMap();
+export {
+  AdvancedUndoManagerController,
+  UndoManagerController
+};
+//# sourceMappingURL=UndoManagerController.es.js.map

package/lib/src/controllers/UndoManagerController.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UndoManagerController.es.js","sources":["../../../src/controllers/UndoManagerController.ts"],"sourcesContent":["import SDK from '..';\nimport { EditorAPI } from '../types/CommonTypes';\nimport { getEditorResponseData } from '../utils/EditorResponseData';\n\n/**\n * The UndoManagerController is responsible for all communication regarding the Undo-Manager.\n * Methods inside this controller can be called by `window.SDK.undoManager.{method-name}`\n */\nexport class UndoManagerController {\n    /**\n     * @ignore\n     */\n    #editorAPI: EditorAPI;\n    #advanced: AdvancedUndoManagerController;\n    #sdk: SDK;\n\n    /**\n     * @ignore\n     */\n    constructor(children: EditorAPI, sdk: SDK) {\n        this.#editorAPI = children;\n        this.#sdk = sdk;\n        this.#advanced = new AdvancedUndoManagerController(children);\n    }\n\n    /**\n     * This method undoes the last operation\n     * @returns\n     */\n    undo = async () => {\n        const res = await this.#editorAPI;\n        return res.undo().then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * This method redoes the last operation\n     * @returns\n     */\n    redo = async () => {\n        const res = await this.#editorAPI;\n        return res.redo().then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * This method adds custom data that will be saved and restored when undoing and redoing.\n     * Duplicate values are overwritten. The data is exposed via the onCustomUndoDataChanged event.\n     *\n     * @param key The key of the custom data\n     * @param value The value of the custom data\n     * @returns\n     */\n    addCustomData = async (key: string, value: string) => {\n        const res = await this.#editorAPI;\n        return res.setCustomUndoData(key, value, false).then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * Record any operations in the current scope. This will automatically begin\n     * the undo operation. Once you leave the record scope, it will end the undo operation.\n     * Even if you throw an exception inside the record scope it will still end it properly.\n     * @returns\n     */\n    record = async (operationName: string, undoOperationCallback: (sdk: SDK) => Promise<void>) => {\n        try {\n            await this.#advanced.beginIfNoneActive(operationName);\n\n            await undoOperationCallback(this.#sdk);\n\n            await this.#advanced.end();\n        } catch (error) {\n            await this.#advanced.abort();\n            throw error;\n        }\n    };\n\n    /**\n     * This method pauses the undo manager\n     * @returns\n     */\n    pause = async () => {\n        const res = await this.#editorAPI;\n        return res.pause().then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * This method resumes the undo manager\n     * @returns\n     */\n    resume = async () => {\n        const res = await this.#editorAPI;\n        return res.resume().then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * This method clears the undo stack\n     * @returns\n     */\n    clear = async () => {\n        const res = await this.#editorAPI;\n        return res.clear().then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * Advanced undo manager functionality for manually controlling undo operations.\n     * This will start a new undo operation.\n     * This will throw an exception when there is already an undo operation recording.\n     * @experimental This method is experimental and may change in future versions.\n     * @returns\n     */\n    advanced = {\n        /**\n         * This will start a new undo operation.\n         * This will throw an exception when there is already an undo operation recording.\n         * @experimental This method is experimental and may change in future versions.\n         * @returns\n         */\n        begin: async (operationName: string) => {\n            return this.#advanced.begin(operationName);\n        },\n\n        /**\n         * This will start a new undo operation if there is no other undo operation recording.\n         * This does not throw.\n         * @experimental This method is experimental and may change in future versions.\n         * @returns\n         */\n        beginIfNoneActive: async (operationName: string) => {\n            return this.#advanced.beginIfNoneActive(operationName);\n        },\n\n        /**\n         * Ends the currently active recording operation.\n         * If there is no recording operation currently running this will throw an exception.\n         * @experimental This method is experimental and may change in future versions.\n         * @returns\n         */\n        end: async () => {\n            return this.#advanced.end();\n        },\n\n        /**\n         * Aborts the currently active recording operation.\n         * If there is no recording operation currently running this will throw an exception.\n         * @experimental This method is experimental and may change in future versions.\n         * @returns\n         */\n        abort: async () => {\n            return this.#advanced.abort();\n        },\n    };\n}\n\nexport class AdvancedUndoManagerController {\n    /**\n     * @ignore\n     */\n    #editorAPI: EditorAPI;\n\n    /**\n     * @ignore\n     */\n    constructor(children: EditorAPI) {\n        this.#editorAPI = children;\n    }\n\n    /**\n     * This will start a new undo operation.\n     * This will throw an exception when there is already an undo operation recording.\n     * @returns\n     */\n    begin = async (operationName: string) => {\n        const res = await this.#editorAPI;\n        return res.begin(operationName).then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * This will start a new undo operation if there is no other undo operation recording.\n     * This does not throw.\n     * @returns\n     */\n    beginIfNoneActive = async (operationName: string) => {\n        const res = await this.#editorAPI;\n        return res.beginIfNoneActive(operationName).then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * Ends the currently active recording operation.\n     * If there is no recording operation currently running this will throw an exception.\n     * @returns\n     */\n    end = async () => {\n        const res = await this.#editorAPI;\n        return res.end().then((result) => getEditorResponseData<null>(result));\n    };\n\n    /**\n     * Aborts the currently active recording operation.\n     * If there is no recording operation currently running this will throw an exception.\n     * @returns\n     */\n    abort = async () => {\n        const res = await this.#editorAPI;\n        return res.abort().then((result) => getEditorResponseData<null>(result));\n    };\n}\n"],"names":["_editorAPI"],"mappings":"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"}

package/lib/src/controllers/UtilsController.cjs.js

@@ -0,0 +1,97 @@
+"use strict";
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var _editorAPI, _localConfig;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const CommonTypes = require("../types/CommonTypes.cjs.js");
+const ConfigurationTypes = require("../types/ConfigurationTypes.cjs.js");
+const ConnectorTypes = require("../types/ConnectorTypes.cjs.js");
+const EditorResponseData = require("../utils/EditorResponseData.cjs.js");
+const Enums = require("../utils/Enums.cjs.js");
+const MathUtils = require("../utils/MathUtils.cjs.js");
+class UtilsController {
+  /**
+   * @ignore
+   */
+  constructor(editorAPI, localConfig) {
+    /**
+     * @ignore
+     */
+    __privateAdd(this, _editorAPI);
+    __privateAdd(this, _localConfig);
+    this.round = (val, precision) => EditorResponseData.getEditorResponseData({
+      data: String(MathUtils.round(val, precision)),
+      success: true,
+      status: 200,
+      parsedData: null
+    });
+    this.createEnvironmentBaseURL = (parameters) => {
+      const { type = Enums.EnvironmentType.SANDBOX, environment = "ft-nostress", version = "1" } = parameters;
+      const host = type == Enums.EnvironmentType.SANDBOX ? "chili-publish-sandbox" : "chili-publish";
+      return `https://${environment}.${host}.online/grafx/api/v${version}/environment/${environment}`;
+    };
+    this.stageFiles = async (files, remoteConnectorId, validationConfiguration) => {
+      const envApiUrl = __privateGet(this, _localConfig).get(ConfigurationTypes.WellKnownConfigurationKeys.GraFxStudioEnvironmentApiUrl);
+      if (!envApiUrl) {
+        throw new Error("GraFx Studio Environment API URL is not set");
+      }
+      const stageUrl = `${envApiUrl}connectors/${remoteConnectorId}/stage`;
+      const accessToken = __privateGet(this, _localConfig).get(ConfigurationTypes.WellKnownConfigurationKeys.GraFxStudioAuthToken);
+      if (!accessToken) {
+        throw new Error("GraFx Studio Auth Token is not set");
+      }
+      const formData = new FormData();
+      files.forEach((file, idx) => {
+        const filename = file instanceof File ? file.name : `blob-${idx}`;
+        formData.append("files", file, filename);
+      });
+      if (validationConfiguration) {
+        formData.append(
+          "validationJson",
+          JSON.stringify({
+            allowedMimeTypes: validationConfiguration.mimeTypes,
+            minDimensions: {
+              width: validationConfiguration.minWidthPixels,
+              height: validationConfiguration.minHeightPixels
+            }
+          })
+        );
+      }
+      const response = await fetch(stageUrl, {
+        method: "POST",
+        body: formData,
+        headers: {
+          Authorization: `Bearer ${accessToken}`
+        }
+      });
+      if (response.status === 422) {
+        const data2 = await response.json();
+        throw new ConnectorTypes.UploadAssetValidationError(data2.message, ConnectorTypes.UploadAssetValidationErrorType.minDimension);
+      }
+      if (response.status === 401) {
+        const data2 = await response.json();
+        throw new CommonTypes.SDKUnauthorizedError(data2.message);
+      }
+      if (!response.ok) {
+        throw new Error("Failed to stage files");
+      }
+      const data = await response.json();
+      return data;
+    };
+    this.unitEvaluate = async (unitExpression, conversionUnit) => {
+      const res = await __privateGet(this, _editorAPI);
+      return res.unitEvaluate(unitExpression, conversionUnit).then((result) => EditorResponseData.getEditorResponseData(result));
+    };
+    __privateSet(this, _editorAPI, editorAPI);
+    __privateSet(this, _localConfig, localConfig);
+  }
+}
+_editorAPI = new WeakMap();
+_localConfig = new WeakMap();
+exports.UtilsController = UtilsController;
+//# sourceMappingURL=UtilsController.cjs.js.map

package/lib/src/controllers/UtilsController.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UtilsController.cjs.js","sources":["../../../src/controllers/UtilsController.ts"],"sourcesContent":["import { SDKUnauthorizedError, type EditorAPI, type Id } from '../types/CommonTypes';\nimport { WellKnownConfigurationKeys } from '../types/ConfigurationTypes';\nimport {\n    FilePointer,\n    UploadAssetValidationError,\n    UploadAssetValidationErrorType,\n    UploadValidationConfiguration,\n} from '../types/ConnectorTypes';\nimport { getEditorResponseData } from '../utils/EditorResponseData';\nimport { EnvironmentType } from '../utils/Enums';\nimport { round } from '../utils/MathUtils';\nimport { MeasurementUnit } from '../types/LayoutTypes';\n\n/**\n * The UtilsController exposes a set of useful utilities that can be used to make some repeated tasks a bit easier\n * Methods inside this controller can be called by `window.SDK.utils.{method-name}`\n */\nexport class UtilsController {\n    /**\n     * @ignore\n     */\n    #editorAPI: EditorAPI;\n    #localConfig: Map<string, string>;\n\n    /**\n     * @ignore\n     */\n    constructor(editorAPI: EditorAPI, localConfig: Map<string, string>) {\n        this.#editorAPI = editorAPI;\n        this.#localConfig = localConfig;\n    }\n\n    /**\n     * This method can round a value to a certain precision, default is 2\n     * @param val the value that needs to be rounded\n     * @param precision the precision of the rounding operation\n     * @returns the rounded value as a number\n     */\n    round = (val: number, precision?: number) =>\n        getEditorResponseData<number>({\n            data: String(round(val, precision)),\n            success: true,\n            status: 200,\n            parsedData: null,\n        });\n\n    createEnvironmentBaseURL = (parameters: { type?: EnvironmentType; environment?: string; version?: string }) => {\n        const { type = EnvironmentType.SANDBOX, environment = 'ft-nostress', version = '1' } = parameters;\n        const host = type == EnvironmentType.SANDBOX ? 'chili-publish-sandbox' : 'chili-publish';\n        return `https://${environment}.${host}.online/grafx/api/v${version}/environment/${environment}`;\n    };\n\n    /**\n     * This method can help you stage a file to the CHILI GraFx Environment API for upload.\n     * @param files The Files or Blobs to stage.\n     * @param remoteConnectorId The connector ID from Environment API to stage the files for.\n     * @param validationConfiguration The validation configuration to use for the files.\n     * @returns Promise<FilePointer[]> referencing the staged data.\n     */\n    stageFiles = async (\n        files: File[] | Blob[],\n        remoteConnectorId: Id,\n        validationConfiguration?: UploadValidationConfiguration,\n    ): Promise<FilePointer[]> => {\n        const envApiUrl = this.#localConfig.get(WellKnownConfigurationKeys.GraFxStudioEnvironmentApiUrl);\n        if (!envApiUrl) {\n            throw new Error('GraFx Studio Environment API URL is not set');\n        }\n\n        const stageUrl = `${envApiUrl}connectors/${remoteConnectorId}/stage`;\n\n        const accessToken = this.#localConfig.get(WellKnownConfigurationKeys.GraFxStudioAuthToken);\n        if (!accessToken) {\n            throw new Error('GraFx Studio Auth Token is not set');\n        }\n\n        const formData = new FormData();\n\n        // Add each file/blob to form data\n        files.forEach((file, idx) => {\n            const filename = file instanceof File ? file.name : `blob-${idx}`;\n            formData.append('files', file, filename);\n        });\n\n        if (validationConfiguration) {\n            formData.append(\n                'validationJson',\n                JSON.stringify({\n                    allowedMimeTypes: validationConfiguration.mimeTypes,\n                    minDimensions: {\n                        width: validationConfiguration.minWidthPixels,\n                        height: validationConfiguration.minHeightPixels,\n                    },\n                }),\n            );\n        }\n\n        const response = await fetch(stageUrl, {\n            method: 'POST',\n            body: formData,\n            headers: {\n                Authorization: `Bearer ${accessToken}`,\n            },\n        });\n\n        if (response.status === 422) {\n            const data = await response.json();\n            throw new UploadAssetValidationError(data.message, UploadAssetValidationErrorType.minDimension);\n        }\n\n        if (response.status === 401) {\n            const data = await response.json();\n            throw new SDKUnauthorizedError(data.message);\n        }\n\n        if (!response.ok) {\n            throw new Error('Failed to stage files');\n        }\n\n        const data = await response.json();\n        return data as FilePointer[];\n    };\n\n    /**\n     * Evaluates a unit expression and returns its value as a number in the\n     * specified conversionUnit, or in the current layout measurement unit if\n     * conversionUnit is not provided.\n     *\n     * Returns null if unitExpression is null, empty, or cannot be evaluated.\n     *\n     * Example:\n     * ```\n     * const value = await SDK.utils.unitEvaluate('10cm', MeasurementUnit.px);\n     * // value is the numeric value in px\n     * ```\n     *\n     * @param unitExpression The unit expression to evaluate (e.g., \"10px\", \"5mm + 2cm\", null)\n     * @param conversionUnit Optional target unit for conversion. If not provided, uses the current layout measurement unit.\n     * @returns The evaluated result as a number, or null if the expression cannot be evaluated\n     */\n    unitEvaluate = async (unitExpression: string | null, conversionUnit?: MeasurementUnit) => {\n        const res = await this.#editorAPI;\n        return res\n            .unitEvaluate(unitExpression, conversionUnit)\n            .then((result) => getEditorResponseData<number | null>(result));\n    };\n}\n"],"names":["getEditorResponseData","round","EnvironmentType","WellKnownConfigurationKeys","data","UploadAssetValidationError","UploadAssetValidationErrorType","SDKUnauthorizedError"],"mappings":";;;;;;;;;;;;;;;;AAiBO,MAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA,EAUzB,YAAY,WAAsB,aAAkC;AANpE;AAAA;AAAA;AAAA;AACA;AAgBA,SAAA,QAAQ,CAAC,KAAa,cAClBA,mBAAAA,sBAA8B;AAAA,MAC1B,MAAM,OAAOC,UAAAA,MAAM,KAAK,SAAS,CAAC;AAAA,MAClC,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,YAAY;AAAA,IAAA,CACf;AAEL,SAAA,2BAA2B,CAAC,eAAmF;AAC3G,YAAM,EAAE,OAAOC,MAAAA,gBAAgB,SAAS,cAAc,eAAe,UAAU,QAAQ;AACvF,YAAM,OAAO,QAAQA,MAAAA,gBAAgB,UAAU,0BAA0B;AACzE,aAAO,WAAW,WAAW,IAAI,IAAI,sBAAsB,OAAO,gBAAgB,WAAW;AAAA,IACjG;AASA,SAAA,aAAa,OACT,OACA,mBACA,4BACyB;AACzB,YAAM,YAAY,mBAAK,cAAa,IAAIC,mBAAAA,2BAA2B,4BAA4B;AAC/F,UAAI,CAAC,WAAW;AACZ,cAAM,IAAI,MAAM,6CAA6C;AAAA,MACjE;AAEA,YAAM,WAAW,GAAG,SAAS,cAAc,iBAAiB;AAE5D,YAAM,cAAc,mBAAK,cAAa,IAAIA,mBAAAA,2BAA2B,oBAAoB;AACzF,UAAI,CAAC,aAAa;AACd,cAAM,IAAI,MAAM,oCAAoC;AAAA,MACxD;AAEA,YAAM,WAAW,IAAI,SAAA;AAGrB,YAAM,QAAQ,CAAC,MAAM,QAAQ;AACzB,cAAM,WAAW,gBAAgB,OAAO,KAAK,OAAO,QAAQ,GAAG;AAC/D,iBAAS,OAAO,SAAS,MAAM,QAAQ;AAAA,MAC3C,CAAC;AAED,UAAI,yBAAyB;AACzB,iBAAS;AAAA,UACL;AAAA,UACA,KAAK,UAAU;AAAA,YACX,kBAAkB,wBAAwB;AAAA,YAC1C,eAAe;AAAA,cACX,OAAO,wBAAwB;AAAA,cAC/B,QAAQ,wBAAwB;AAAA,YAAA;AAAA,UACpC,CACH;AAAA,QAAA;AAAA,MAET;AAEA,YAAM,WAAW,MAAM,MAAM,UAAU;AAAA,QACnC,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,SAAS;AAAA,UACL,eAAe,UAAU,WAAW;AAAA,QAAA;AAAA,MACxC,CACH;AAED,UAAI,SAAS,WAAW,KAAK;AACzB,cAAMC,QAAO,MAAM,SAAS,KAAA;AAC5B,cAAM,IAAIC,eAAAA,2BAA2BD,MAAK,SAASE,eAAAA,+BAA+B,YAAY;AAAA,MAClG;AAEA,UAAI,SAAS,WAAW,KAAK;AACzB,cAAMF,QAAO,MAAM,SAAS,KAAA;AAC5B,cAAM,IAAIG,YAAAA,qBAAqBH,MAAK,OAAO;AAAA,MAC/C;AAEA,UAAI,CAAC,SAAS,IAAI;AACd,cAAM,IAAI,MAAM,uBAAuB;AAAA,MAC3C;AAEA,YAAM,OAAO,MAAM,SAAS,KAAA;AAC5B,aAAO;AAAA,IACX;AAmBA,SAAA,eAAe,OAAO,gBAA+B,mBAAqC;AACtF,YAAM,MAAM,MAAM,mBAAK;AACvB,aAAO,IACF,aAAa,gBAAgB,cAAc,EAC3C,KAAK,CAAC,WAAWJ,yCAAqC,MAAM,CAAC;AAAA,IACtE;AArHI,uBAAK,YAAa;AAClB,uBAAK,cAAe;AAAA,EACxB;AAoHJ;AA7HI;AACA;;"}

package/lib/src/controllers/UtilsController.es.js

@@ -0,0 +1,97 @@
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var _editorAPI, _localConfig;
+import { SDKUnauthorizedError } from "../types/CommonTypes.es.js";
+import { WellKnownConfigurationKeys } from "../types/ConfigurationTypes.es.js";
+import { UploadAssetValidationError, UploadAssetValidationErrorType } from "../types/ConnectorTypes.es.js";
+import { getEditorResponseData } from "../utils/EditorResponseData.es.js";
+import { EnvironmentType } from "../utils/Enums.es.js";
+import { round } from "../utils/MathUtils.es.js";
+class UtilsController {
+  /**
+   * @ignore
+   */
+  constructor(editorAPI, localConfig) {
+    /**
+     * @ignore
+     */
+    __privateAdd(this, _editorAPI);
+    __privateAdd(this, _localConfig);
+    this.round = (val, precision) => getEditorResponseData({
+      data: String(round(val, precision)),
+      success: true,
+      status: 200,
+      parsedData: null
+    });
+    this.createEnvironmentBaseURL = (parameters) => {
+      const { type = EnvironmentType.SANDBOX, environment = "ft-nostress", version = "1" } = parameters;
+      const host = type == EnvironmentType.SANDBOX ? "chili-publish-sandbox" : "chili-publish";
+      return `https://${environment}.${host}.online/grafx/api/v${version}/environment/${environment}`;
+    };
+    this.stageFiles = async (files, remoteConnectorId, validationConfiguration) => {
+      const envApiUrl = __privateGet(this, _localConfig).get(WellKnownConfigurationKeys.GraFxStudioEnvironmentApiUrl);
+      if (!envApiUrl) {
+        throw new Error("GraFx Studio Environment API URL is not set");
+      }
+      const stageUrl = `${envApiUrl}connectors/${remoteConnectorId}/stage`;
+      const accessToken = __privateGet(this, _localConfig).get(WellKnownConfigurationKeys.GraFxStudioAuthToken);
+      if (!accessToken) {
+        throw new Error("GraFx Studio Auth Token is not set");
+      }
+      const formData = new FormData();
+      files.forEach((file, idx) => {
+        const filename = file instanceof File ? file.name : `blob-${idx}`;
+        formData.append("files", file, filename);
+      });
+      if (validationConfiguration) {
+        formData.append(
+          "validationJson",
+          JSON.stringify({
+            allowedMimeTypes: validationConfiguration.mimeTypes,
+            minDimensions: {
+              width: validationConfiguration.minWidthPixels,
+              height: validationConfiguration.minHeightPixels
+            }
+          })
+        );
+      }
+      const response = await fetch(stageUrl, {
+        method: "POST",
+        body: formData,
+        headers: {
+          Authorization: `Bearer ${accessToken}`
+        }
+      });
+      if (response.status === 422) {
+        const data2 = await response.json();
+        throw new UploadAssetValidationError(data2.message, UploadAssetValidationErrorType.minDimension);
+      }
+      if (response.status === 401) {
+        const data2 = await response.json();
+        throw new SDKUnauthorizedError(data2.message);
+      }
+      if (!response.ok) {
+        throw new Error("Failed to stage files");
+      }
+      const data = await response.json();
+      return data;
+    };
+    this.unitEvaluate = async (unitExpression, conversionUnit) => {
+      const res = await __privateGet(this, _editorAPI);
+      return res.unitEvaluate(unitExpression, conversionUnit).then((result) => getEditorResponseData(result));
+    };
+    __privateSet(this, _editorAPI, editorAPI);
+    __privateSet(this, _localConfig, localConfig);
+  }
+}
+_editorAPI = new WeakMap();
+_localConfig = new WeakMap();
+export {
+  UtilsController
+};
+//# sourceMappingURL=UtilsController.es.js.map

package/lib/src/controllers/UtilsController.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UtilsController.es.js","sources":["../../../src/controllers/UtilsController.ts"],"sourcesContent":["import { SDKUnauthorizedError, type EditorAPI, type Id } from '../types/CommonTypes';\nimport { WellKnownConfigurationKeys } from '../types/ConfigurationTypes';\nimport {\n    FilePointer,\n    UploadAssetValidationError,\n    UploadAssetValidationErrorType,\n    UploadValidationConfiguration,\n} from '../types/ConnectorTypes';\nimport { getEditorResponseData } from '../utils/EditorResponseData';\nimport { EnvironmentType } from '../utils/Enums';\nimport { round } from '../utils/MathUtils';\nimport { MeasurementUnit } from '../types/LayoutTypes';\n\n/**\n * The UtilsController exposes a set of useful utilities that can be used to make some repeated tasks a bit easier\n * Methods inside this controller can be called by `window.SDK.utils.{method-name}`\n */\nexport class UtilsController {\n    /**\n     * @ignore\n     */\n    #editorAPI: EditorAPI;\n    #localConfig: Map<string, string>;\n\n    /**\n     * @ignore\n     */\n    constructor(editorAPI: EditorAPI, localConfig: Map<string, string>) {\n        this.#editorAPI = editorAPI;\n        this.#localConfig = localConfig;\n    }\n\n    /**\n     * This method can round a value to a certain precision, default is 2\n     * @param val the value that needs to be rounded\n     * @param precision the precision of the rounding operation\n     * @returns the rounded value as a number\n     */\n    round = (val: number, precision?: number) =>\n        getEditorResponseData<number>({\n            data: String(round(val, precision)),\n            success: true,\n            status: 200,\n            parsedData: null,\n        });\n\n    createEnvironmentBaseURL = (parameters: { type?: EnvironmentType; environment?: string; version?: string }) => {\n        const { type = EnvironmentType.SANDBOX, environment = 'ft-nostress', version = '1' } = parameters;\n        const host = type == EnvironmentType.SANDBOX ? 'chili-publish-sandbox' : 'chili-publish';\n        return `https://${environment}.${host}.online/grafx/api/v${version}/environment/${environment}`;\n    };\n\n    /**\n     * This method can help you stage a file to the CHILI GraFx Environment API for upload.\n     * @param files The Files or Blobs to stage.\n     * @param remoteConnectorId The connector ID from Environment API to stage the files for.\n     * @param validationConfiguration The validation configuration to use for the files.\n     * @returns Promise<FilePointer[]> referencing the staged data.\n     */\n    stageFiles = async (\n        files: File[] | Blob[],\n        remoteConnectorId: Id,\n        validationConfiguration?: UploadValidationConfiguration,\n    ): Promise<FilePointer[]> => {\n        const envApiUrl = this.#localConfig.get(WellKnownConfigurationKeys.GraFxStudioEnvironmentApiUrl);\n        if (!envApiUrl) {\n            throw new Error('GraFx Studio Environment API URL is not set');\n        }\n\n        const stageUrl = `${envApiUrl}connectors/${remoteConnectorId}/stage`;\n\n        const accessToken = this.#localConfig.get(WellKnownConfigurationKeys.GraFxStudioAuthToken);\n        if (!accessToken) {\n            throw new Error('GraFx Studio Auth Token is not set');\n        }\n\n        const formData = new FormData();\n\n        // Add each file/blob to form data\n        files.forEach((file, idx) => {\n            const filename = file instanceof File ? file.name : `blob-${idx}`;\n            formData.append('files', file, filename);\n        });\n\n        if (validationConfiguration) {\n            formData.append(\n                'validationJson',\n                JSON.stringify({\n                    allowedMimeTypes: validationConfiguration.mimeTypes,\n                    minDimensions: {\n                        width: validationConfiguration.minWidthPixels,\n                        height: validationConfiguration.minHeightPixels,\n                    },\n                }),\n            );\n        }\n\n        const response = await fetch(stageUrl, {\n            method: 'POST',\n            body: formData,\n            headers: {\n                Authorization: `Bearer ${accessToken}`,\n            },\n        });\n\n        if (response.status === 422) {\n            const data = await response.json();\n            throw new UploadAssetValidationError(data.message, UploadAssetValidationErrorType.minDimension);\n        }\n\n        if (response.status === 401) {\n            const data = await response.json();\n            throw new SDKUnauthorizedError(data.message);\n        }\n\n        if (!response.ok) {\n            throw new Error('Failed to stage files');\n        }\n\n        const data = await response.json();\n        return data as FilePointer[];\n    };\n\n    /**\n     * Evaluates a unit expression and returns its value as a number in the\n     * specified conversionUnit, or in the current layout measurement unit if\n     * conversionUnit is not provided.\n     *\n     * Returns null if unitExpression is null, empty, or cannot be evaluated.\n     *\n     * Example:\n     * ```\n     * const value = await SDK.utils.unitEvaluate('10cm', MeasurementUnit.px);\n     * // value is the numeric value in px\n     * ```\n     *\n     * @param unitExpression The unit expression to evaluate (e.g., \"10px\", \"5mm + 2cm\", null)\n     * @param conversionUnit Optional target unit for conversion. If not provided, uses the current layout measurement unit.\n     * @returns The evaluated result as a number, or null if the expression cannot be evaluated\n     */\n    unitEvaluate = async (unitExpression: string | null, conversionUnit?: MeasurementUnit) => {\n        const res = await this.#editorAPI;\n        return res\n            .unitEvaluate(unitExpression, conversionUnit)\n            .then((result) => getEditorResponseData<number | null>(result));\n    };\n}\n"],"names":["data"],"mappings":";;;;;;;;;;;;;;AAiBO,MAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA,EAUzB,YAAY,WAAsB,aAAkC;AANpE;AAAA;AAAA;AAAA;AACA;AAgBA,SAAA,QAAQ,CAAC,KAAa,cAClB,sBAA8B;AAAA,MAC1B,MAAM,OAAO,MAAM,KAAK,SAAS,CAAC;AAAA,MAClC,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,YAAY;AAAA,IAAA,CACf;AAEL,SAAA,2BAA2B,CAAC,eAAmF;AAC3G,YAAM,EAAE,OAAO,gBAAgB,SAAS,cAAc,eAAe,UAAU,QAAQ;AACvF,YAAM,OAAO,QAAQ,gBAAgB,UAAU,0BAA0B;AACzE,aAAO,WAAW,WAAW,IAAI,IAAI,sBAAsB,OAAO,gBAAgB,WAAW;AAAA,IACjG;AASA,SAAA,aAAa,OACT,OACA,mBACA,4BACyB;AACzB,YAAM,YAAY,mBAAK,cAAa,IAAI,2BAA2B,4BAA4B;AAC/F,UAAI,CAAC,WAAW;AACZ,cAAM,IAAI,MAAM,6CAA6C;AAAA,MACjE;AAEA,YAAM,WAAW,GAAG,SAAS,cAAc,iBAAiB;AAE5D,YAAM,cAAc,mBAAK,cAAa,IAAI,2BAA2B,oBAAoB;AACzF,UAAI,CAAC,aAAa;AACd,cAAM,IAAI,MAAM,oCAAoC;AAAA,MACxD;AAEA,YAAM,WAAW,IAAI,SAAA;AAGrB,YAAM,QAAQ,CAAC,MAAM,QAAQ;AACzB,cAAM,WAAW,gBAAgB,OAAO,KAAK,OAAO,QAAQ,GAAG;AAC/D,iBAAS,OAAO,SAAS,MAAM,QAAQ;AAAA,MAC3C,CAAC;AAED,UAAI,yBAAyB;AACzB,iBAAS;AAAA,UACL;AAAA,UACA,KAAK,UAAU;AAAA,YACX,kBAAkB,wBAAwB;AAAA,YAC1C,eAAe;AAAA,cACX,OAAO,wBAAwB;AAAA,cAC/B,QAAQ,wBAAwB;AAAA,YAAA;AAAA,UACpC,CACH;AAAA,QAAA;AAAA,MAET;AAEA,YAAM,WAAW,MAAM,MAAM,UAAU;AAAA,QACnC,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,SAAS;AAAA,UACL,eAAe,UAAU,WAAW;AAAA,QAAA;AAAA,MACxC,CACH;AAED,UAAI,SAAS,WAAW,KAAK;AACzB,cAAMA,QAAO,MAAM,SAAS,KAAA;AAC5B,cAAM,IAAI,2BAA2BA,MAAK,SAAS,+BAA+B,YAAY;AAAA,MAClG;AAEA,UAAI,SAAS,WAAW,KAAK;AACzB,cAAMA,QAAO,MAAM,SAAS,KAAA;AAC5B,cAAM,IAAI,qBAAqBA,MAAK,OAAO;AAAA,MAC/C;AAEA,UAAI,CAAC,SAAS,IAAI;AACd,cAAM,IAAI,MAAM,uBAAuB;AAAA,MAC3C;AAEA,YAAM,OAAO,MAAM,SAAS,KAAA;AAC5B,aAAO;AAAA,IACX;AAmBA,SAAA,eAAe,OAAO,gBAA+B,mBAAqC;AACtF,YAAM,MAAM,MAAM,mBAAK;AACvB,aAAO,IACF,aAAa,gBAAgB,cAAc,EAC3C,KAAK,CAAC,WAAW,sBAAqC,MAAM,CAAC;AAAA,IACtE;AArHI,uBAAK,YAAa;AAClB,uBAAK,cAAe;AAAA,EACxB;AAoHJ;AA7HI;AACA;"}