@mlightcad/cad-simple-viewer 1.2.4 → 1.2.5

package/lib/editor/input/ui/AcEdFloatingInput.js

@@ -0,0 +1,239 @@
+import { AcEdFloatingInputBoxes } from './AcEdFloatingInputBoxes';
+/**
+ * A UI component providing a small floating input box used inside CAD editing
+ * workflows. It supports both single-input (distance, angle, etc.) and
+ * double-input (coordinate entry) modes.
+ *
+ * The component is responsible for:
+ *
+ * - Creating, styling, and destroying its HTML structure
+ * - Handling keyboard events (Enter, Escape)
+ * - Managing live validation (via built-in or custom callback)
+ * - Emitting commit/change/cancel events
+ * - Ensuring no memory leaks via `dispose()`
+ *
+ * This abstraction allows higher-level objects such as AcEdInputManager to
+ * remain clean and free from DOM-handling logic.
+ */
+var AcEdFloatingInput = /** @class */ (function () {
+    // ---------------------------------------------------------------------------
+    // CONSTRUCTOR
+    // ---------------------------------------------------------------------------
+    /**
+     * Constructs a new floating input widget with the given options.
+     *
+     * @param options Configuration object controlling behavior, callbacks,
+     *                validation, and display mode.
+     */
+    function AcEdFloatingInput(options) {
+        var _this = this;
+        var _a, _b;
+        /** Whether the widget is currently visible. */
+        this.visible = false;
+        /** Whether this instance has been disposed. */
+        this.disposed = false;
+        this.parent = (_a = options.parent) !== null && _a !== void 0 ? _a : document.body;
+        this.validateFn = options.validate;
+        this.getDynamicValue = options.getDynamicValue;
+        this.drawPreview = options.drawPreview;
+        this.onCommit = options.onCommit;
+        this.onChange = options.onChange;
+        this.onCancel = options.onCancel;
+        // Create DOM
+        this.container = document.createElement('div');
+        this.container.className = 'ml-floating-input';
+        var label = document.createElement('span');
+        label.className = 'ml-floating-input-label';
+        label.textContent = (_b = options.message) !== null && _b !== void 0 ? _b : '';
+        this.container.appendChild(label);
+        this.inputs = new AcEdFloatingInputBoxes({
+            parent: this.container,
+            twoInputs: options.twoInputs,
+            validate: this.validateFn,
+            onCancel: this.onCancel,
+            onCommit: this.onCommit,
+            onChange: this.onChange
+        });
+        // Always add it as children of body element because the browser will ignore it completely if
+        // adding an <input> element as a child of a <canvas> element.
+        document.body.appendChild(this.container);
+        // Bind events
+        this.boundOnMouseEnter = function (e) { return _this.handleMouseEnter(e); };
+        this.boundOnMouseLeave = function () { return _this.handleMouseLeave(); };
+        this.boundOnMouseMove = function (e) { return _this.handleMouseMove(e); };
+        this.boundOnClick = function (e) { return _this.handleClick(e); };
+        // When the mouse enters the parent element, show floating input as AutoCAD
+        this.parent.addEventListener('mouseenter', this.boundOnMouseEnter);
+        // When the mouse leaves the parent element, hide floating input as AutoCAD
+        this.parent.addEventListener('mouseleave', this.boundOnMouseLeave);
+        this.injectCSS();
+    }
+    /**
+     * Injects minimal CSS required for the floating input and preview rectangle.
+     * Useful when you do not have a separate CSS file.
+     */
+    AcEdFloatingInput.prototype.injectCSS = function () {
+        if (AcEdFloatingInput.stylesInjected)
+            return;
+        AcEdFloatingInput.stylesInjected = true;
+        var style = document.createElement('style');
+        style.textContent = "\n      .ml-floating-input {\n        position: absolute;\n        display: flex;\n        align-items: center;\n        padding: 2px 4px;\n        background: #444; /* gray background for container */\n        color: #fff; /* white text for message */\n        border: none;\n        border-radius: 4px;\n        font-size: 12px;\n        pointer-events: none;\n        z-index: 10000;\n      }\n      .ml-floating-input input {\n        font-size: 12px;\n        padding: 2px 4px;\n        margin-left: 6px;\n        height: 22px;\n        width: 90px; /* wider to show coordinates */\n        background: #888; /* gray background for input */\n        border: 1px solid #666; /* subtle border */\n        border-radius: 2px;\n      }\n      .ml-floating-input input.invalid {\n        border-color: red;\n        color: red;\n      }\n      .ml-floating-input-label {\n        white-space: nowrap;\n        color: #fff; /* white label text */\n      }\n    ";
+        document.head.appendChild(style);
+    };
+    Object.defineProperty(AcEdFloatingInput.prototype, "isVisible", {
+        /**
+         * Indicates whether the floating input widget is currently visible.
+         * Can be used by external code to check if the input is shown on the screen.
+         */
+        get: function () {
+            return this.visible;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Shows the floating input box at the specified screen coordinates.
+     * @param pos - The mouse position in browser
+     */
+    AcEdFloatingInput.prototype.showAt = function (pos) {
+        if (this.disposed)
+            return;
+        this.container.style.display = 'flex';
+        this.visible = true;
+        this.inputs.focus();
+        this.setPosition(pos);
+        // Listen to mouse move and click on parent
+        this.parent.addEventListener('mousemove', this.boundOnMouseMove);
+        this.parent.addEventListener('click', this.boundOnClick);
+    };
+    /**
+     * Hides the floating input widget.
+     *
+     * - Removes the widget from view.
+     * - Stops tracking mouse movement on the parent element.
+     *
+     * Safe to call multiple times; if the widget is already hidden, this method
+     * does nothing.
+     */
+    AcEdFloatingInput.prototype.hide = function () {
+        if (!this.visible)
+            return;
+        this.container.style.display = 'none';
+        this.visible = false;
+        this.removeListener();
+    };
+    /**
+     * Disposes the floating input widget permanently.
+     *
+     * - Removes all event listeners (keyboard, input, mouse move).
+     * - Removes the widget's DOM container from the parent.
+     * - Marks the widget as disposed; after this, it cannot be shown again.
+     *
+     * Safe to call multiple times; subsequent calls have no effect.
+     */
+    AcEdFloatingInput.prototype.dispose = function () {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.inputs.dispose();
+        this.removeListener(true);
+        this.container.remove();
+    };
+    /**
+     * Sets position of this floating input
+     * @param pos - The mouse position in browser
+     * @returns The mouse position in the parent element of the floating input.
+     */
+    AcEdFloatingInput.prototype.setPosition = function (pos) {
+        var parentRect = this.parent.getBoundingClientRect();
+        var containerRect = this.container.getBoundingClientRect();
+        var mousePos = {
+            x: pos.x - parentRect.left,
+            y: pos.y - parentRect.top
+        };
+        this.mousePos = mousePos;
+        // Compute position within parent bounds
+        var left = mousePos.x + 10;
+        var top = mousePos.y + 10;
+        if (left + containerRect.width > parentRect.right)
+            left = parentRect.right - containerRect.width;
+        if (top + containerRect.height > parentRect.bottom)
+            top = parentRect.bottom - containerRect.height;
+        if (left < parentRect.left)
+            left = parentRect.left;
+        if (top < parentRect.top)
+            top = parentRect.top;
+        this.container.style.left = "".concat(left, "px");
+        this.container.style.top = "".concat(top, "px");
+        return mousePos;
+    };
+    /**
+     * Removes event listeners bound to the parent element
+     * @param isRemoveAll - If true, removes all of event listeners bound
+     * to the parent element
+     */
+    AcEdFloatingInput.prototype.removeListener = function (isRemoveAll) {
+        if (isRemoveAll === void 0) { isRemoveAll = false; }
+        this.parent.removeEventListener('mousemove', this.boundOnMouseMove);
+        this.parent.removeEventListener('click', this.boundOnClick);
+        if (isRemoveAll) {
+            this.parent.removeEventListener('mouseenter', this.boundOnMouseEnter);
+            this.parent.removeEventListener('mouseleave', this.boundOnMouseLeave);
+        }
+    };
+    /**
+     * Handles mouse move events to show floating input.
+     * @param e The mouse leave event.
+     */
+    AcEdFloatingInput.prototype.handleMouseEnter = function (e) {
+        this.showAt(e);
+    };
+    /**
+     * Handles mouse move events to hide floating input.
+     * @param e The mouse leave event.
+     */
+    AcEdFloatingInput.prototype.handleMouseLeave = function () {
+        this.hide();
+    };
+    /**
+     * Handles mouse move events to reposition the floating input.
+     *
+     * Ensures that the input box follows the cursor while staying entirely
+     * within the bounds of the parent element. Applies a small offset
+     * to avoid overlapping the cursor.
+     *
+     * @param e The mouse move event containing the current cursor position.
+     */
+    AcEdFloatingInput.prototype.handleMouseMove = function (e) {
+        var _a;
+        if (!this.visible)
+            return;
+        var mousePos = this.setPosition({ x: e.x, y: e.y });
+        // Update input values if empty using dynamic value callback
+        var defaults = this.getDynamicValue(mousePos.x, mousePos.y);
+        this.inputs.setValue(defaults.raw);
+        // If inputs lost focus due to some reason, let's try to focus them again.
+        if (!this.inputs.focused) {
+            this.inputs.focus();
+        }
+        (_a = this.drawPreview) === null || _a === void 0 ? void 0 : _a.call(this, mousePos.x, mousePos.y);
+    };
+    /**
+     * Handles click events to commit inputs.
+     *
+     * @param e The click event containing the current cursor position.
+     */
+    AcEdFloatingInput.prototype.handleClick = function (e) {
+        var _a;
+        if (!this.visible)
+            return;
+        var mousePos = this.setPosition({ x: e.x, y: e.y });
+        var defaults = this.getDynamicValue(mousePos.x, mousePos.y);
+        (_a = this.onCommit) === null || _a === void 0 ? void 0 : _a.call(this, defaults.value);
+    };
+    /** Inject styles only once */
+    AcEdFloatingInput.stylesInjected = false;
+    return AcEdFloatingInput;
+}());
+export { AcEdFloatingInput };
+//# sourceMappingURL=AcEdFloatingInput.js.map

package/lib/editor/input/ui/AcEdFloatingInput.js.map

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

package/lib/editor/input/ui/AcEdFloatingInputBox.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Represents ONE floating input box (<input> element).
+ * Tracks whether the user has typed anything manually.
+ */
+export declare class AcEdFloatingInputBox {
+    /** The container element of this input */
+    private parent;
+    /** The actual text input element */
+    private input;
+    /** Whether the user typed something in this box */
+    userTyped: boolean;
+    /** Bound input handler for unbinding */
+    private boundOnInput;
+    /**
+     * Constructs one instance of this UI component.
+     * @param parent - The container element of this input
+     */
+    constructor(parent: HTMLElement);
+    /** Mark input as invalid */
+    markInvalid(): void;
+    /** Mark input as valid */
+    markValid(): void;
+    /** Clear validation state */
+    resetValidation(): void;
+    /** Get placeholder */
+    get placeholder(): string;
+    /** Set placeholder */
+    set placeholder(text: string);
+    /** Set value */
+    set value(v: string);
+    /** Read current text */
+    get value(): string;
+    /** Return one flag to indicate whether the input box is focused. */
+    get focused(): boolean;
+    /** Forwards focus() to the underlying element. */
+    focus(): void;
+    /** Forwards select() to the underlying element. */
+    select(): void;
+    /** Forwards remove() to the underlying element. */
+    remove(): void;
+    /** Return true if the specified event is originated from this input box. */
+    isEventTarget(e: KeyboardEvent): boolean;
+    /** Dispose the input box by unbinding events */
+    dispose(): void;
+    /**
+     * Add an event listener to the input element
+     * @param type Event type (e.g., 'input', 'keydown')
+     * @param listener Listener function
+     * @param options Optional event listener options
+     */
+    addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLInputElement, ev: HTMLElementEventMap[K]) => void, options?: boolean | AddEventListenerOptions): void;
+    /**
+     * Remove an event listener from the input element
+     * @param type Event type (e.g., 'input', 'keydown')
+     * @param listener Listener function
+     * @param options Optional event listener options
+     */
+    removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLInputElement, ev: HTMLElementEventMap[K]) => void, options?: boolean | EventListenerOptions): void;
+}
+//# sourceMappingURL=AcEdFloatingInputBox.d.ts.map

package/lib/editor/input/ui/AcEdFloatingInputBox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdFloatingInputBox.d.ts","sourceRoot":"","sources":["../../../../src/editor/input/ui/AcEdFloatingInputBox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,0CAA0C;IAC1C,OAAO,CAAC,MAAM,CAAa;IAE3B,oCAAoC;IACpC,OAAO,CAAC,KAAK,CAAkB;IAE/B,mDAAmD;IACnD,SAAS,UAAQ;IAEjB,wCAAwC;IACxC,OAAO,CAAC,YAAY,CAAY;IAEhC;;;OAGG;gBACS,MAAM,EAAE,WAAW;IAc/B,4BAA4B;IAC5B,WAAW;IAIX,0BAA0B;IAC1B,SAAS;IAIT,6BAA6B;IAC7B,eAAe;IAIf,sBAAsB;IACtB,IAAI,WAAW,IAKO,MAAM,CAH3B;IAED,sBAAsB;IACtB,IAAI,WAAW,CAAC,IAAI,EAAE,MAAM,EAE3B;IAED,gBAAgB;IAChB,IAAI,KAAK,CAAC,CAAC,EAAE,MAAM,EAElB;IAED,wBAAwB;IACxB,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,oEAAoE;IACpE,IAAI,OAAO,YAEV;IAED,kDAAkD;IAClD,KAAK;IAIL,mDAAmD;IACnD,MAAM;IAIN,mDAAmD;IACnD,MAAM;IAIN,4EAA4E;IAC5E,aAAa,CAAC,CAAC,EAAE,aAAa;IAI9B,gDAAgD;IAChD,OAAO;IAKP;;;;;OAKG;IACH,gBAAgB,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAClD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,EACtE,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB;IAK7C;;;;;OAKG;IACH,mBAAmB,CAAC,CAAC,SAAS,MAAM,mBAAmB,EACrD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,EACtE,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB;CAI3C"}

package/lib/editor/input/ui/AcEdFloatingInputBox.js

@@ -0,0 +1,113 @@
+/**
+ * Represents ONE floating input box (<input> element).
+ * Tracks whether the user has typed anything manually.
+ */
+var AcEdFloatingInputBox = /** @class */ (function () {
+    /**
+     * Constructs one instance of this UI component.
+     * @param parent - The container element of this input
+     */
+    function AcEdFloatingInputBox(parent) {
+        var _this = this;
+        /** Whether the user typed something in this box */
+        this.userTyped = false;
+        this.parent = parent;
+        this.input = document.createElement('input');
+        this.input.type = 'text';
+        // Track user input
+        this.boundOnInput = function () {
+            _this.userTyped = true;
+            _this.resetValidation();
+        };
+        this.input.addEventListener('input', this.boundOnInput);
+        this.parent.appendChild(this.input);
+    }
+    /** Mark input as invalid */
+    AcEdFloatingInputBox.prototype.markInvalid = function () {
+        this.input.classList.add('invalid');
+    };
+    /** Mark input as valid */
+    AcEdFloatingInputBox.prototype.markValid = function () {
+        this.input.classList.remove('invalid');
+    };
+    /** Clear validation state */
+    AcEdFloatingInputBox.prototype.resetValidation = function () {
+        this.input.classList.remove('invalid');
+    };
+    Object.defineProperty(AcEdFloatingInputBox.prototype, "placeholder", {
+        /** Get placeholder */
+        get: function () {
+            return this.input.placeholder;
+        },
+        /** Set placeholder */
+        set: function (text) {
+            if (text)
+                this.input.placeholder = text;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcEdFloatingInputBox.prototype, "value", {
+        /** Read current text */
+        get: function () {
+            return this.input.value;
+        },
+        /** Set value */
+        set: function (v) {
+            if (v !== undefined)
+                this.input.value = v;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AcEdFloatingInputBox.prototype, "focused", {
+        /** Return one flag to indicate whether the input box is focused. */
+        get: function () {
+            return document.activeElement === this.input;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /** Forwards focus() to the underlying element. */
+    AcEdFloatingInputBox.prototype.focus = function () {
+        this.input.focus();
+    };
+    /** Forwards select() to the underlying element. */
+    AcEdFloatingInputBox.prototype.select = function () {
+        this.input.select();
+    };
+    /** Forwards remove() to the underlying element. */
+    AcEdFloatingInputBox.prototype.remove = function () {
+        this.input.remove();
+    };
+    /** Return true if the specified event is originated from this input box. */
+    AcEdFloatingInputBox.prototype.isEventTarget = function (e) {
+        return e.target === this.input;
+    };
+    /** Dispose the input box by unbinding events */
+    AcEdFloatingInputBox.prototype.dispose = function () {
+        this.input.removeEventListener('input', this.boundOnInput);
+        this.remove();
+    };
+    /**
+     * Add an event listener to the input element
+     * @param type Event type (e.g., 'input', 'keydown')
+     * @param listener Listener function
+     * @param options Optional event listener options
+     */
+    AcEdFloatingInputBox.prototype.addEventListener = function (type, listener, options) {
+        this.input.addEventListener(type, listener, options);
+    };
+    /**
+     * Remove an event listener from the input element
+     * @param type Event type (e.g., 'input', 'keydown')
+     * @param listener Listener function
+     * @param options Optional event listener options
+     */
+    AcEdFloatingInputBox.prototype.removeEventListener = function (type, listener, options) {
+        this.input.removeEventListener(type, listener, options);
+    };
+    return AcEdFloatingInputBox;
+}());
+export { AcEdFloatingInputBox };
+//# sourceMappingURL=AcEdFloatingInputBox.js.map

package/lib/editor/input/ui/AcEdFloatingInputBox.js.map

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

package/lib/editor/input/ui/AcEdFloatingInputBoxes.d.ts

@@ -0,0 +1,104 @@
+import { AcEdFloatingInputBox } from './AcEdFloatingInputBox';
+import { AcEdFloatingInputCancelCallback, AcEdFloatingInputChangeCallback, AcEdFloatingInputCommitCallback, AcEdFloatingInputRawData, AcEdFloatingInputValidationCallback } from './AcEdFloatingInputTypes';
+/**
+ * Construction options for {@link AcEdFloatingInputBoxes}.
+ */
+export interface AcEdFloatingInputBoxesOptions<T> {
+    /**
+     * The parent element to constrain the floating input within.
+     */
+    parent: HTMLElement;
+    /**
+     * If true, display both X and Y inputs.
+     * If false, display only X input (useful for distance, angle, etc.).
+     *
+     * Default: `true`
+     */
+    twoInputs?: boolean;
+    /**
+     * Custom validation function.
+     */
+    validate: AcEdFloatingInputValidationCallback<T>;
+    /**
+     * Callback invoked when user confirms valid input by pressing Enter.
+     */
+    onCommit?: AcEdFloatingInputCommitCallback<T>;
+    /**
+     * Callback invoked on each input event after validation completes.
+     */
+    onChange?: AcEdFloatingInputChangeCallback<T>;
+    /**
+     * Callback invoked on cancellation (Escape or hide()).
+     */
+    onCancel?: AcEdFloatingInputCancelCallback;
+}
+/**
+ * Container holding one or two floating input boxes.
+ *
+ * Always contains:
+ *      - X input box
+ *
+ * Contains Y input box only if `twoInputs` is true.
+ */
+export declare class AcEdFloatingInputBoxes<T> {
+    /** Root DOM node that contains X and optional Y input boxes */
+    readonly parent: HTMLElement;
+    /** Whether this input uses X+Y fields or X-only. @private */
+    readonly twoInputs: boolean;
+    /** Always present */
+    readonly xInput: AcEdFloatingInputBox;
+    /** Only present when twoInputs = true */
+    readonly yInput?: AcEdFloatingInputBox;
+    /**
+     * Cached bound handler for keyboard events—ensures removal works.
+     */
+    private boundOnKeyDown;
+    /**
+     * Cached bound handler for input events—ensures removal works.
+     */
+    private boundOnInput;
+    private onCommit?;
+    private onChange?;
+    private onCancel?;
+    private validateFn;
+    /**
+     * Constructs one instance of this class
+     * @param parent - The container element of X and Y inputs
+     * @param twoInputs - The flag whether to show Y input
+     */
+    constructor(options: AcEdFloatingInputBoxesOptions<T>);
+    /** Returns true if user typed in ANY input box */
+    get userTyped(): boolean;
+    /** Return one flag to indicate whether one of inputs is focused. */
+    get focused(): boolean | undefined;
+    /** Focus on X input */
+    focus(): void;
+    /** Sets text value of X and Y inputs if user doesn't type value */
+    setValue(value: AcEdFloatingInputRawData): void;
+    /**
+     * Disposes the floating input widget permanently.
+     *
+     * - Removes all event listeners (keyboard, input, mouse move).
+     * - Removes the widget's DOM container from the parent.
+     * - Marks the widget as disposed; after this, it cannot be shown again.
+     *
+     * Safe to call multiple times; subsequent calls have no effect.
+     */
+    dispose(): void;
+    /**
+     * Handles input events from X or Y fields.
+     * Triggers validation and notifies listeners through `onChange`.
+     */
+    private handleInput;
+    /**
+     * Handles keyboard events (Enter for commit, Escape for cancel).
+     */
+    private handleKeyDown;
+    /**
+     * Validates the input values using either:
+     * - the user-provided custom validation function, OR
+     * - the built-in numeric parser.
+     */
+    private validate;
+}
+//# sourceMappingURL=AcEdFloatingInputBoxes.d.ts.map

package/lib/editor/input/ui/AcEdFloatingInputBoxes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdFloatingInputBoxes.d.ts","sourceRoot":"","sources":["../../../../src/editor/input/ui/AcEdFloatingInputBoxes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,EAC/B,+BAA+B,EAC/B,wBAAwB,EACxB,mCAAmC,EAEpC,MAAM,0BAA0B,CAAA;AAEjC;;GAEG;AACH,MAAM,WAAW,6BAA6B,CAAC,CAAC;IAC9C;;OAEG;IACH,MAAM,EAAE,WAAW,CAAA;IAEnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;OAEG;IACH,QAAQ,EAAE,mCAAmC,CAAC,CAAC,CAAC,CAAA;IAEhD;;OAEG;IACH,QAAQ,CAAC,EAAE,+BAA+B,CAAC,CAAC,CAAC,CAAA;IAE7C;;OAEG;IACH,QAAQ,CAAC,EAAE,+BAA+B,CAAC,CAAC,CAAC,CAAA;IAE7C;;OAEG;IACH,QAAQ,CAAC,EAAE,+BAA+B,CAAA;CAC3C;AAED;;;;;;;GAOG;AACH,qBAAa,sBAAsB,CAAC,CAAC;IACnC,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAE5B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAE3B,qBAAqB;IACrB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IAErC,yCAAyC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAA;IAEtC;;OAEG;IACH,OAAO,CAAC,cAAc,CAA4B;IAElD;;OAEG;IACH,OAAO,CAAC,YAAY,CAAY;IAKhC,OAAO,CAAC,QAAQ,CAAC,CAAoC;IACrD,OAAO,CAAC,QAAQ,CAAC,CAAoC;IACrD,OAAO,CAAC,QAAQ,CAAC,CAAiC;IAClD,OAAO,CAAC,UAAU,CAAwC;IAE1D;;;;OAIG;gBACS,OAAO,EAAE,6BAA6B,CAAC,CAAC,CAAC;IA8BrD,kDAAkD;IAClD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,oEAAoE;IACpE,IAAI,OAAO,wBAEV;IAED,uBAAuB;IACvB,KAAK;IAIL,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,wBAAwB;IAOxC;;;;;;;;OAQG;IACH,OAAO;IAYP;;;OAGG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgCrB;;;;OAIG;IACH,OAAO,CAAC,QAAQ;CAMjB"}