fabric 6.2.0 → 6.3.0

package/dist-extensions/src/shapes/IText/IText.d.ts

@@ -0,0 +1,314 @@
+import type { ITextEvents } from './ITextBehavior';
+import { ITextClickBehavior } from './ITextClickBehavior';
+import type { TClassProperties, TFiller, TOptions } from '../../typedefs';
+import type { SerializedTextProps, TextProps } from '../Text/Text';
+import type { ObjectToCanvasElementOptions } from '../Object/Object';
+type CursorBoundaries = {
+    left: number;
+    top: number;
+    leftOffset: number;
+    topOffset: number;
+};
+export declare const iTextDefaultValues: Partial<TClassProperties<IText>>;
+interface UniqueITextProps {
+    selectionStart: number;
+    selectionEnd: number;
+}
+export interface SerializedITextProps extends SerializedTextProps, UniqueITextProps {
+}
+export interface ITextProps extends TextProps, UniqueITextProps {
+}
+/**
+ * @fires changed
+ * @fires selection:changed
+ * @fires editing:entered
+ * @fires editing:exited
+ * @fires dragstart
+ * @fires drag drag event firing on the drag source
+ * @fires dragend
+ * @fires copy
+ * @fires cut
+ * @fires paste
+ *
+ * #### Supported key combinations
+ * ```
+ *   Move cursor:                    left, right, up, down
+ *   Select character:               shift + left, shift + right
+ *   Select text vertically:         shift + up, shift + down
+ *   Move cursor by word:            alt + left, alt + right
+ *   Select words:                   shift + alt + left, shift + alt + right
+ *   Move cursor to line start/end:  cmd + left, cmd + right or home, end
+ *   Select till start/end of line:  cmd + shift + left, cmd + shift + right or shift + home, shift + end
+ *   Jump to start/end of text:      cmd + up, cmd + down
+ *   Select till start/end of text:  cmd + shift + up, cmd + shift + down or shift + pgUp, shift + pgDown
+ *   Delete character:               backspace
+ *   Delete word:                    alt + backspace
+ *   Delete line:                    cmd + backspace
+ *   Forward delete:                 delete
+ *   Copy text:                      ctrl/cmd + c
+ *   Paste text:                     ctrl/cmd + v
+ *   Cut text:                       ctrl/cmd + x
+ *   Select entire text:             ctrl/cmd + a
+ *   Quit editing                    tab or esc
+ * ```
+ *
+ * #### Supported mouse/touch combination
+ * ```
+ *   Position cursor:                click/touch
+ *   Create selection:               click/touch & drag
+ *   Create selection:               click & shift + click
+ *   Select word:                    double click
+ *   Select line:                    triple click
+ * ```
+ */
+export declare class IText<Props extends TOptions<ITextProps> = Partial<ITextProps>, SProps extends SerializedITextProps = SerializedITextProps, EventSpec extends ITextEvents = ITextEvents> extends ITextClickBehavior<Props, SProps, EventSpec> implements UniqueITextProps {
+    /**
+     * Index where text selection starts (or where cursor is when there is no selection)
+     * @type Number
+     * @default
+     */
+    selectionStart: number;
+    /**
+     * Index where text selection ends
+     * @type Number
+     * @default
+     */
+    selectionEnd: number;
+    compositionStart: number;
+    compositionEnd: number;
+    /**
+     * Color of text selection
+     * @type String
+     * @default
+     */
+    selectionColor: string;
+    /**
+     * Indicates whether text is in editing mode
+     * @type Boolean
+     * @default
+     */
+    isEditing: boolean;
+    /**
+     * Indicates whether a text can be edited
+     * @type Boolean
+     * @default
+     */
+    editable: boolean;
+    /**
+     * Border color of text object while it's in editing mode
+     * @type String
+     * @default
+     */
+    editingBorderColor: string;
+    /**
+     * Width of cursor (in px)
+     * @type Number
+     * @default
+     */
+    cursorWidth: number;
+    /**
+     * Color of text cursor color in editing mode.
+     * if not set (default) will take color from the text.
+     * if set to a color value that fabric can understand, it will
+     * be used instead of the color of the text at the current position.
+     * @type String
+     * @default
+     */
+    cursorColor: string;
+    /**
+     * Delay between cursor blink (in ms)
+     * @type Number
+     * @default
+     */
+    cursorDelay: number;
+    /**
+     * Duration of cursor fade in (in ms)
+     * @type Number
+     * @default
+     */
+    cursorDuration: number;
+    compositionColor: string;
+    /**
+     * Indicates whether internal text char widths can be cached
+     * @type Boolean
+     * @default
+     */
+    caching: boolean;
+    static ownDefaults: Partial<TClassProperties<IText<Partial<ITextProps>, SerializedITextProps, ITextEvents>>>;
+    static getDefaults(): Record<string, any>;
+    static type: string;
+    get type(): string;
+    /**
+     * Constructor
+     * @param {String} text Text string
+     * @param {Object} [options] Options object
+     */
+    constructor(text: string, options?: Props);
+    /**
+     * While editing handle differently
+     * @private
+     * @param {string} key
+     * @param {*} value
+     */
+    _set(key: string, value: any): this;
+    /**
+     * Sets selection start (left boundary of a selection)
+     * @param {Number} index Index to set selection start to
+     */
+    setSelectionStart(index: number): void;
+    /**
+     * Sets selection end (right boundary of a selection)
+     * @param {Number} index Index to set selection end to
+     */
+    setSelectionEnd(index: number): void;
+    /**
+     * @private
+     * @param {String} property 'selectionStart' or 'selectionEnd'
+     * @param {Number} index new position of property
+     */
+    protected _updateAndFire(property: 'selectionStart' | 'selectionEnd', index: number): void;
+    /**
+     * Fires the even of selection changed
+     * @private
+     */
+    _fireSelectionChanged(): void;
+    /**
+     * Initialize text dimensions. Render all text on given context
+     * or on a offscreen canvas to get the text width with measureText.
+     * Updates this.width and this.height with the proper values.
+     * Does not return dimensions.
+     * @private
+     */
+    initDimensions(): void;
+    /**
+     * Gets style of a current selection/cursor (at the start position)
+     * if startIndex or endIndex are not provided, selectionStart or selectionEnd will be used.
+     * @param {Number} startIndex Start index to get styles at
+     * @param {Number} endIndex End index to get styles at, if not specified selectionEnd or startIndex + 1
+     * @param {Boolean} [complete] get full style or not
+     * @return {Array} styles an array with one, zero or more Style objects
+     */
+    getSelectionStyles(startIndex?: number, endIndex?: number, complete?: boolean): Partial<import("../Text/StyledText").CompleteTextStyleDeclaration>[];
+    /**
+     * Sets style of a current selection, if no selection exist, do not set anything.
+     * @param {Object} [styles] Styles object
+     * @param {Number} [startIndex] Start index to get styles at
+     * @param {Number} [endIndex] End index to get styles at, if not specified selectionEnd or startIndex + 1
+     */
+    setSelectionStyles(styles: object, startIndex?: number, endIndex?: number): void;
+    /**
+     * Returns 2d representation (lineIndex and charIndex) of cursor (or selection start)
+     * @param {Number} [selectionStart] Optional index. When not given, current selectionStart is used.
+     * @param {Boolean} [skipWrapping] consider the location for unwrapped lines. useful to manage styles.
+     */
+    get2DCursorLocation(selectionStart?: number, skipWrapping?: boolean): {
+        lineIndex: number;
+        charIndex: number;
+    };
+    /**
+     * @private
+     * @param {CanvasRenderingContext2D} ctx Context to render on
+     */
+    render(ctx: CanvasRenderingContext2D): void;
+    /**
+     * @override block cursor/selection logic while rendering the exported canvas
+     * @todo this workaround should be replaced with a more robust solution
+     */
+    toCanvasElement(options?: ObjectToCanvasElementOptions): HTMLCanvasElement;
+    /**
+     * Renders cursor or selection (depending on what exists)
+     * it does on the contextTop. If contextTop is not available, do nothing.
+     */
+    renderCursorOrSelection(): void;
+    /**
+     * Returns cursor boundaries (left, top, leftOffset, topOffset)
+     * left/top are left/top of entire text box
+     * leftOffset/topOffset are offset from that left/top point of a text box
+     * @private
+     * @param {number} [index] index from start
+     * @param {boolean} [skipCaching]
+     */
+    _getCursorBoundaries(index?: number, skipCaching?: boolean): CursorBoundaries;
+    /**
+     * Caches and returns cursor left/top offset relative to instance's center point
+     * @private
+     * @param {number} index index from start
+     * @param {boolean} [skipCaching]
+     */
+    _getCursorBoundariesOffsets(index: number, skipCaching?: boolean): {
+        left: number;
+        top: number;
+    };
+    /**
+     * Calculates cursor left/top offset relative to instance's center point
+     * @private
+     * @param {number} index index from start
+     */
+    __getCursorBoundariesOffsets(index: number): {
+        top: number;
+        left: number;
+    };
+    /**
+     * Renders cursor on context Top, outside the animation cycle, on request
+     * Used for the drag/drop effect.
+     * If contextTop is not available, do nothing.
+     */
+    renderCursorAt(selectionStart: number): void;
+    /**
+     * Renders cursor
+     * @param {Object} boundaries
+     * @param {CanvasRenderingContext2D} ctx transformed context to draw on
+     */
+    renderCursor(ctx: CanvasRenderingContext2D, boundaries: CursorBoundaries): void;
+    _renderCursor(ctx: CanvasRenderingContext2D, boundaries: CursorBoundaries, selectionStart: number): void;
+    /**
+     * Renders text selection
+     * @param {Object} boundaries Object with left/top/leftOffset/topOffset
+     * @param {CanvasRenderingContext2D} ctx transformed context to draw on
+     */
+    renderSelection(ctx: CanvasRenderingContext2D, boundaries: CursorBoundaries): void;
+    /**
+     * Renders drag start text selection
+     */
+    renderDragSourceEffect(): void;
+    renderDropTargetEffect(e: DragEvent): void;
+    /**
+     * Renders text selection
+     * @private
+     * @param {{ selectionStart: number, selectionEnd: number }} selection
+     * @param {Object} boundaries Object with left/top/leftOffset/topOffset
+     * @param {CanvasRenderingContext2D} ctx transformed context to draw on
+     */
+    _renderSelection(ctx: CanvasRenderingContext2D, selection: {
+        selectionStart: number;
+        selectionEnd: number;
+    }, boundaries: CursorBoundaries): void;
+    /**
+     * High level function to know the height of the cursor.
+     * the currentChar is the one that precedes the cursor
+     * Returns fontSize of char at the current cursor
+     * Unused from the library, is for the end user
+     * @return {Number} Character font size
+     */
+    getCurrentCharFontSize(): number;
+    /**
+     * High level function to know the color of the cursor.
+     * the currentChar is the one that precedes the cursor
+     * Returns color (fill) of char at the current cursor
+     * if the text object has a pattern or gradient for filler, it will return that.
+     * Unused by the library, is for the end user
+     * @return {String | TFiller} Character color (fill)
+     */
+    getCurrentCharColor(): string | TFiller | null;
+    /**
+     * Returns the cursor position for the getCurrent.. functions
+     * @private
+     */
+    _getCurrentCharIndex(): {
+        l: number;
+        c: number;
+    };
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=IText.d.ts.map

package/dist-extensions/src/shapes/IText/IText.d.ts.map

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

package/dist-extensions/src/shapes/IText/ITextBehavior.d.ts

@@ -0,0 +1,299 @@
+import type { ObjectEvents, TPointerEvent, TPointerEventInfo } from '../../EventTypeDefs';
+import type { FabricObject } from '../Object/FabricObject';
+import { FabricText } from '../Text/Text';
+import type { TOnAnimationChangeCallback } from '../../util/animation/types';
+import type { ValueAnimation } from '../../util/animation/ValueAnimation';
+import type { TextStyleDeclaration } from '../Text/StyledText';
+import type { SerializedTextProps, TextProps } from '../Text/Text';
+import type { TOptions } from '../../typedefs';
+export type ITextEvents = ObjectEvents & {
+    'selection:changed': never;
+    changed: never | {
+        index: number;
+        action: string;
+    };
+    tripleclick: TPointerEventInfo;
+    'editing:entered': never | {
+        e: TPointerEvent;
+    };
+    'editing:exited': never;
+};
+export declare abstract class ITextBehavior<Props extends TOptions<TextProps> = Partial<TextProps>, SProps extends SerializedTextProps = SerializedTextProps, EventSpec extends ITextEvents = ITextEvents> extends FabricText<Props, SProps, EventSpec> {
+    abstract isEditing: boolean;
+    abstract cursorDelay: number;
+    abstract selectionStart: number;
+    abstract selectionEnd: number;
+    abstract cursorDuration: number;
+    abstract editable: boolean;
+    abstract editingBorderColor: string;
+    abstract compositionStart: number;
+    abstract compositionEnd: number;
+    abstract hiddenTextarea: HTMLTextAreaElement | null;
+    /**
+     * Helps determining when the text is in composition, so that the cursor
+     * rendering is altered.
+     */
+    protected inCompositionMode: boolean;
+    protected _reSpace: RegExp;
+    private _currentTickState?;
+    private _currentTickCompleteState?;
+    protected _currentCursorOpacity: number;
+    private _textBeforeEdit;
+    protected __selectionStartOnMouseDown: number;
+    protected selected: boolean;
+    protected cursorOffsetCache: {
+        left?: number;
+        top?: number;
+    };
+    protected _savedProps?: {
+        hasControls: boolean;
+        borderColor: string;
+        lockMovementX: boolean;
+        lockMovementY: boolean;
+        selectable: boolean;
+        hoverCursor: CSSStyleDeclaration['cursor'] | null;
+        defaultCursor?: CSSStyleDeclaration['cursor'];
+        moveCursor?: CSSStyleDeclaration['cursor'];
+    };
+    protected _selectionDirection: 'left' | 'right' | null;
+    abstract initHiddenTextarea(): void;
+    abstract _fireSelectionChanged(): void;
+    abstract renderCursorOrSelection(): void;
+    abstract getSelectionStartFromPointer(e: TPointerEvent): number;
+    abstract _getCursorBoundaries(index: number, skipCaching?: boolean): {
+        left: number;
+        top: number;
+        leftOffset: number;
+        topOffset: number;
+    };
+    /**
+     * Initializes all the interactive behavior of IText
+     */
+    initBehavior(): void;
+    onDeselect(options?: {
+        e?: TPointerEvent;
+        object?: FabricObject;
+    }): boolean;
+    /**
+     * @private
+     */
+    _animateCursor({ toValue, duration, delay, onComplete, }: {
+        toValue: number;
+        duration: number;
+        delay?: number;
+        onComplete?: TOnAnimationChangeCallback<number, void>;
+    }): ValueAnimation;
+    /**
+     * changes the cursor from visible to invisible
+     */
+    private _tick;
+    /**
+     * Changes the cursor from invisible to visible
+     */
+    private _onTickComplete;
+    /**
+     * Initializes delayed cursor
+     */
+    initDelayedCursor(restart?: boolean): void;
+    /**
+     * Aborts cursor animation, clears all timeouts and clear textarea context if necessary
+     */
+    abortCursorAnimation(): void;
+    /**
+     * Restart tue cursor animation if either is in complete state ( between animations )
+     * or if it never started before
+     */
+    restartCursorIfNeeded(): void;
+    /**
+     * Selects entire text
+     */
+    selectAll(): this;
+    /**
+     * Returns selected text
+     * @return {String}
+     */
+    getSelectedText(): string;
+    /**
+     * Find new selection index representing start of current word according to current selection index
+     * @param {Number} startFrom Current selection index
+     * @return {Number} New selection index
+     */
+    findWordBoundaryLeft(startFrom: number): number;
+    /**
+     * Find new selection index representing end of current word according to current selection index
+     * @param {Number} startFrom Current selection index
+     * @return {Number} New selection index
+     */
+    findWordBoundaryRight(startFrom: number): number;
+    /**
+     * Find new selection index representing start of current line according to current selection index
+     * @param {Number} startFrom Current selection index
+     * @return {Number} New selection index
+     */
+    findLineBoundaryLeft(startFrom: number): number;
+    /**
+     * Find new selection index representing end of current line according to current selection index
+     * @param {Number} startFrom Current selection index
+     * @return {Number} New selection index
+     */
+    findLineBoundaryRight(startFrom: number): number;
+    /**
+     * Finds index corresponding to beginning or end of a word
+     * @param {Number} selectionStart Index of a character
+     * @param {Number} direction 1 or -1
+     * @return {Number} Index of the beginning or end of a word
+     */
+    searchWordBoundary(selectionStart: number, direction: 1 | -1): number;
+    /**
+     * TODO fix: selectionStart set as 0 will be ignored?
+     * Selects a word based on the index
+     * @param {Number} selectionStart Index of a character
+     */
+    selectWord(selectionStart?: number): void;
+    /**
+     * TODO fix: selectionStart set as 0 will be ignored?
+     * Selects a line based on the index
+     * @param {Number} selectionStart Index of a character
+     */
+    selectLine(selectionStart?: number): this;
+    /**
+     * Enters editing state
+     */
+    enterEditing(e?: TPointerEvent): void;
+    /**
+     * called by {@link Canvas#textEditingManager}
+     */
+    updateSelectionOnMouseMove(e: TPointerEvent): void;
+    /**
+     * @private
+     */
+    _setEditingProps(): void;
+    /**
+     * convert from textarea to grapheme indexes
+     */
+    fromStringToGraphemeSelection(start: number, end: number, text: string): {
+        selectionStart: number;
+        selectionEnd: number;
+    };
+    /**
+     * convert from fabric to textarea values
+     */
+    fromGraphemeToStringSelection(start: number, end: number, graphemes: string[]): {
+        selectionStart: number;
+        selectionEnd: number;
+    };
+    /**
+     * @private
+     */
+    _updateTextarea(): void;
+    /**
+     * @private
+     */
+    updateFromTextArea(): void;
+    /**
+     * @private
+     */
+    updateTextareaPosition(): void;
+    /**
+     * @private
+     * @return {Object} style contains style for hiddenTextarea
+     */
+    _calcTextareaPosition(): {
+        left: string;
+        top: string;
+        fontSize?: undefined;
+        charHeight?: undefined;
+    } | {
+        left: string;
+        top: string;
+        fontSize: string;
+        charHeight: number;
+    };
+    /**
+     * @private
+     */
+    _saveEditingProps(): void;
+    /**
+     * @private
+     */
+    _restoreEditingProps(): void;
+    /**
+     * runs the actual logic that exits from editing state, see {@link exitEditing}
+     */
+    protected _exitEditing(): void;
+    /**
+     * Exits from editing state and fires relevant events
+     */
+    exitEditing(): this;
+    /**
+     * @private
+     */
+    _removeExtraneousStyles(): void;
+    /**
+     * remove and reflow a style block from start to end.
+     * @param {Number} start linear start position for removal (included in removal)
+     * @param {Number} end linear end position for removal ( excluded from removal )
+     */
+    removeStyleFromTo(start: number, end: number): void;
+    /**
+     * Shifts line styles up or down
+     * @param {Number} lineIndex Index of a line
+     * @param {Number} offset Can any number?
+     */
+    shiftLineStyles(lineIndex: number, offset: number): void;
+    /**
+     * Handle insertion of more consecutive style lines for when one or more
+     * newlines gets added to the text. Since current style needs to be shifted
+     * first we shift the current style of the number lines needed, then we add
+     * new lines from the last to the first.
+     * @param {Number} lineIndex Index of a line
+     * @param {Number} charIndex Index of a char
+     * @param {Number} qty number of lines to add
+     * @param {Array} copiedStyle Array of objects styles
+     */
+    insertNewlineStyleObject(lineIndex: number, charIndex: number, qty: number, copiedStyle?: {
+        [index: number]: TextStyleDeclaration;
+    }): void;
+    /**
+     * Inserts style object for a given line/char index
+     * @param {Number} lineIndex Index of a line
+     * @param {Number} charIndex Index of a char
+     * @param {Number} quantity number Style object to insert, if given
+     * @param {Array} copiedStyle array of style objects
+     */
+    insertCharStyleObject(lineIndex: number, charIndex: number, quantity: number, copiedStyle?: TextStyleDeclaration[]): void;
+    /**
+     * Inserts style object(s)
+     * @param {Array} insertedText Characters at the location where style is inserted
+     * @param {Number} start cursor index for inserting style
+     * @param {Array} [copiedStyle] array of style objects to insert.
+     */
+    insertNewStyleBlock(insertedText: string[], start: number, copiedStyle?: TextStyleDeclaration[]): void;
+    /**
+     * Removes characters from start/end
+     * start/end ar per grapheme position in _text array.
+     *
+     * @param {Number} start
+     * @param {Number} end default to start + 1
+     */
+    removeChars(start: number, end?: number): void;
+    /**
+     * insert characters at start position, before start position.
+     * start  equal 1 it means the text get inserted between actual grapheme 0 and 1
+     * if style array is provided, it must be as the same length of text in graphemes
+     * if end is provided and is bigger than start, old text is replaced.
+     * start/end ar per grapheme position in _text array.
+     *
+     * @param {String} text text to insert
+     * @param {Array} style array of style objects
+     * @param {Number} start
+     * @param {Number} end default to start + 1
+     */
+    insertChars(text: string, style: TextStyleDeclaration[] | undefined, start: number, end?: number): void;
+    /**
+     * Set the selectionStart and selectionEnd according to the new position of cursor
+     * mimic the key - mouse navigation when shift is pressed.
+     */
+    setSelectionStartEndWithShift(start: number, end: number, newSelection: number): void;
+}
+//# sourceMappingURL=ITextBehavior.d.ts.map

package/dist-extensions/src/shapes/IText/ITextBehavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITextBehavior.d.ts","sourceRoot":"","sources":["../../../../src/shapes/IText/ITextBehavior.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAoB/C,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG;IACvC,mBAAmB,EAAE,KAAK,CAAC;IAC3B,OAAO,EAAE,KAAK,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,WAAW,EAAE,iBAAiB,CAAC;IAC/B,iBAAiB,EAAE,KAAK,GAAG;QAAE,CAAC,EAAE,aAAa,CAAA;KAAE,CAAC;IAChD,gBAAgB,EAAE,KAAK,CAAC;CACzB,CAAC;AAEF,8BAAsB,aAAa,CACjC,KAAK,SAAS,QAAQ,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,EACtD,MAAM,SAAS,mBAAmB,GAAG,mBAAmB,EACxD,SAAS,SAAS,WAAW,GAAG,WAAW,CAC3C,SAAQ,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC;IAC5C,SAAiB,SAAS,EAAE,OAAO,CAAC;IACpC,SAAiB,WAAW,EAAE,MAAM,CAAC;IACrC,SAAiB,cAAc,EAAE,MAAM,CAAC;IACxC,SAAiB,YAAY,EAAE,MAAM,CAAC;IACtC,SAAiB,cAAc,EAAE,MAAM,CAAC;IACxC,SAAiB,QAAQ,EAAE,OAAO,CAAC;IACnC,SAAiB,kBAAkB,EAAE,MAAM,CAAC;IAE5C,SAAiB,gBAAgB,EAAE,MAAM,CAAC;IAC1C,SAAiB,cAAc,EAAE,MAAM,CAAC;IAExC,SAAiB,cAAc,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAE5D;;;OAGG;IACH,UAAkB,iBAAiB,EAAE,OAAO,CAAC;IAE7C,UAAkB,QAAQ,EAAE,MAAM,CAAC;IACnC,QAAgB,iBAAiB,CAAC,CAAiB;IACnD,QAAgB,yBAAyB,CAAC,CAAiB;IAC3D,SAAS,CAAC,qBAAqB,SAAK;IACpC,QAAgB,eAAe,CAAS;IACxC,UAAkB,2BAA2B,EAAE,MAAM,CAAC;IAEtD,UAAkB,QAAQ,EAAE,OAAO,CAAC;IACpC,UAAkB,iBAAiB,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,UAAkB,WAAW,CAAC,EAAE;QAC9B,WAAW,EAAE,OAAO,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,OAAO,CAAC;QACvB,aAAa,EAAE,OAAO,CAAC;QACvB,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;QAClD,aAAa,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC9C,UAAU,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;KAC5C,CAAC;IACF,UAAkB,mBAAmB,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAE/D,QAAQ,CAAC,kBAAkB,IAAI,IAAI;IACnC,QAAQ,CAAC,qBAAqB,IAAI,IAAI;IACtC,QAAQ,CAAC,uBAAuB,IAAI,IAAI;IACxC,QAAQ,CAAC,4BAA4B,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM;IAC/D,QAAQ,CAAC,oBAAoB,CAC3B,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,OAAO,GACpB;QACD,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB;IAED;;OAEG;IACH,YAAY;IAOZ,UAAU,CAAC,OAAO,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,aAAa,CAAC;QAAC,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE;IAMjE;;OAEG;IACH,cAAc,CAAC,EACb,OAAO,EACP,QAAQ,EACR,KAAK,EACL,UAAU,GACX,EAAE;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,0BAA0B,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;KACvD;IAkBD;;OAEG;IACH,OAAO,CAAC,KAAK;IASb;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,iBAAiB,CAAC,OAAO,CAAC,EAAE,OAAO;IAKnC;;OAEG;IACH,oBAAoB;IAmBpB;;;OAGG;IACH,qBAAqB;IAUrB;;OAEG;IACH,SAAS;IAQT;;;OAGG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;OAIG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAmB/C;;;;OAIG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAmBhD;;;;OAIG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAY/C;;;;OAIG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAYhD;;;;;OAKG;IACH,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM;IAqBrE;;;;OAIG;IACH,UAAU,CAAC,cAAc,CAAC,EAAE,MAAM;IAiBlC;;;;OAIG;IACH,UAAU,CAAC,cAAc,CAAC,EAAE,MAAM;IAYlC;;OAEG;IACH,YAAY,CAAC,CAAC,CAAC,EAAE,aAAa;IA+B9B;;OAEG;IACH,0BAA0B,CAAC,CAAC,EAAE,aAAa;IAoC3C;;OAEG;IACH,gBAAgB;IAYhB;;OAEG;IACH,6BAA6B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;;;IActE;;OAEG;IACH,6BAA6B,CAC3B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EAAE;;;;IAerB;;OAEG;IACH,eAAe;IAiBf;;OAEG;IACH,kBAAkB;IAsBlB;;OAEG;IACH,sBAAsB;IAQtB;;;OAGG;IACH,qBAAqB;;;;;;;;;;;IA4DrB;;OAEG;IACH,iBAAiB;IAajB;;OAEG;IACH,oBAAoB;IAsBpB;;OAEG;IACH,SAAS,CAAC,YAAY;IAetB;;OAEG;IACH,WAAW;IAqBX;;OAEG;IACH,uBAAuB;IAQvB;;;;OAIG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAyD5C;;;;OAIG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAajD;;;;;;;;;OASG;IACH,wBAAwB,CACtB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE;QAAE,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAAA;KAAE;IA0DzD;;;;;;OAMG;IACH,qBAAqB,CACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,oBAAoB,EAAE;IAgDtC;;;;;OAKG;IACH,mBAAmB,CACjB,YAAY,EAAE,MAAM,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,oBAAoB,EAAE;IA4DtC;;;;;;OAMG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAkB;IAUlD;;;;;;;;;;;OAWG;IACH,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,oBAAoB,EAAE,GAAG,SAAS,EACzC,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,MAAc;IAmBrB;;;OAGG;IACH,6BAA6B,CAC3B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM;CA2BvB"}