@vforsh/phaser-dev-ui 0.1.0 → 0.3.0

package/README.md

@@ -70,6 +70,15 @@ The system is designed with a fluent, chainable API and dark-theme defaults matc
 - **`createGridContainer`**: Arranges children in a grid with configurable columns, cell size, and spacing.
 - **Usage**: Group related UI elements. After adding items via `addItem()` or `addItems()`, call `.layout()` to reposition children. Containers are invisible positioning helpers and can be nested.
 
+### Utility Helpers
+
+- **`bindDebugControl`**: Two-way model binding helper for debug controls.
+  - Supports model access via object path (`target` + `path`) or custom getter/setter.
+  - Polls model on `preupdate` and pushes control changes back through control events.
+- **`anchorToViewport`**: Anchors any game object to viewport edges/corners/center with optional safe-area insets and resize updates.
+- **`getSafeAreaInsets`**: Resolves safe-area insets in game units (CSS env insets + optional extra insets).
+- **`layoutAuto`**: Dirty layout scheduler; batches `.layout()` calls and flushes once per frame.
+
 ## Example: Creating a Settings Popup
 
 ```typescript

package/dist/DebugSeparator.d.ts

@@ -0,0 +1,42 @@
+import type { HexColor, Position } from "./types.js";
+export interface CreateDebugSeparatorOptions {
+    /** Total width of the separator line (default: 200). */
+    width?: number;
+    /** Line thickness in px (default: 1). */
+    thickness?: number;
+    /** Line color (default: "#a3a3a3"). */
+    color?: HexColor;
+    /** Optional centered label text (e.g. "Physics"). Omit for a plain line. */
+    label?: string;
+    /** Label font size (default: 12). */
+    labelFontSize?: number;
+    /** Label text color (default: same as line color). */
+    labelColor?: HexColor;
+    /** Gap in px between label edges and line segments (default: 8). */
+    labelGap?: number;
+    /** Position (optional). */
+    position?: Position;
+}
+/**
+ * A thin horizontal divider line with an optional centered label.
+ *
+ * Use inside panels or layout containers to visually separate sections.
+ * Chainable API.
+ */
+export declare class DebugSeparator extends Phaser.GameObjects.Container {
+    private _line;
+    private _label;
+    private _separatorWidth;
+    private _thickness;
+    private _color;
+    private _labelGap;
+    constructor(scene: Phaser.Scene, options?: CreateDebugSeparatorOptions);
+    setLineColor(color: HexColor): this;
+    setLabel(text: string): this;
+    setThickness(thickness: number): this;
+    setSeparatorWidth(width: number): this;
+    setStyle(options: Partial<Pick<CreateDebugSeparatorOptions, "width" | "thickness" | "color" | "labelGap">>): this;
+    private redraw;
+}
+export declare function createDebugSeparator(scene: Phaser.Scene, options?: CreateDebugSeparatorOptions): DebugSeparator;
+//# sourceMappingURL=DebugSeparator.d.ts.map

package/dist/DebugSeparator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugSeparator.d.ts","sourceRoot":"","sources":["../src/DebugSeparator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGpD,MAAM,WAAW,2BAA2B;IAC3C,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uCAAuC;IACvC,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,sDAAsD;IACtD,UAAU,CAAC,EAAE,QAAQ,CAAA;IACrB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,MAAM,CAAC,WAAW,CAAC,SAAS;IAC/D,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,SAAS,CAAQ;gBAEb,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAE,2BAAgC;IAyC1E,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAMnC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAmB5B,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAMrC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC,GAAG,IAAI;IASjH,OAAO,CAAC,MAAM;CAsBd;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAE,2BAAgC,GAAG,cAAc,CAEnH"}

package/dist/DebugSeparator.js

@@ -0,0 +1,109 @@
+import { getDevicePixelRatio, hexToColorAlpha } from "./utils.js";
+/**
+ * A thin horizontal divider line with an optional centered label.
+ *
+ * Use inside panels or layout containers to visually separate sections.
+ * Chainable API.
+ */
+export class DebugSeparator extends Phaser.GameObjects.Container {
+    _line;
+    _label = null;
+    _separatorWidth;
+    _thickness;
+    _color;
+    _labelGap;
+    constructor(scene, options = {}) {
+        const { width = 200, thickness = 1, color = "#a3a3a3", label, labelFontSize = 12, labelColor, labelGap = 8, position, } = options;
+        super(scene, position?.x ?? 0, position?.y ?? 0);
+        this._separatorWidth = width;
+        this._thickness = thickness;
+        this._color = color;
+        this._labelGap = labelGap;
+        this._line = new Phaser.GameObjects.Graphics(scene);
+        this.add(this._line);
+        if (label !== undefined && label !== "") {
+            const lc = hexToColorAlpha(labelColor ?? color);
+            this._label = new Phaser.GameObjects.Text(scene, 0, 0, label, {
+                fontFamily: "Verdana",
+                fontSize: `${labelFontSize}px`,
+                color: `#${lc.color.toString(16).padStart(6, "0")}`,
+                resolution: getDevicePixelRatio(),
+            });
+            this._label.setOrigin(0.5, 0.5);
+            this._label.setAlpha(lc.alpha);
+            this.add(this._label);
+        }
+        this.redraw();
+        this.setSize(width, Math.max(thickness, this._label?.displayHeight ?? 0));
+        scene.add.existing(this);
+    }
+    setLineColor(color) {
+        this._color = color;
+        this.redraw();
+        return this;
+    }
+    setLabel(text) {
+        if (!this._label) {
+            const lc = hexToColorAlpha(this._color);
+            this._label = new Phaser.GameObjects.Text(this.scene, 0, 0, text, {
+                fontFamily: "Verdana",
+                fontSize: "12px",
+                color: `#${lc.color.toString(16).padStart(6, "0")}`,
+                resolution: getDevicePixelRatio(),
+            });
+            this._label.setOrigin(0.5, 0.5);
+            this._label.setAlpha(lc.alpha);
+            this.add(this._label);
+        }
+        else {
+            this._label.setText(text);
+        }
+        this.redraw();
+        return this;
+    }
+    setThickness(thickness) {
+        this._thickness = Math.max(1, thickness);
+        this.redraw();
+        return this;
+    }
+    setSeparatorWidth(width) {
+        this._separatorWidth = width;
+        this.setSize(width, this.height);
+        this.redraw();
+        return this;
+    }
+    setStyle(options) {
+        if (options.width !== undefined)
+            this._separatorWidth = options.width;
+        if (options.thickness !== undefined)
+            this._thickness = Math.max(1, options.thickness);
+        if (options.color !== undefined)
+            this._color = options.color;
+        if (options.labelGap !== undefined)
+            this._labelGap = options.labelGap;
+        this.redraw();
+        return this;
+    }
+    redraw() {
+        const halfW = this._separatorWidth / 2;
+        const c = hexToColorAlpha(this._color);
+        this._line.clear();
+        this._line.lineStyle(this._thickness, c.color, c.alpha);
+        if (!this._label || this._label.text === "") {
+            this._line.lineBetween(-halfW, 0, halfW, 0);
+            this.setSize(this._separatorWidth, this._thickness);
+            return;
+        }
+        const labelHalfW = this._label.displayWidth / 2;
+        const gap = this._labelGap;
+        const lineLeftEnd = -(labelHalfW + gap);
+        const lineRightStart = labelHalfW + gap;
+        this._line.lineBetween(-halfW, 0, lineLeftEnd, 0);
+        this._line.lineBetween(lineRightStart, 0, halfW, 0);
+        this.setSize(this._separatorWidth, Math.max(this._thickness, this._label.displayHeight));
+    }
+}
+export function createDebugSeparator(scene, options = {}) {
+    return new DebugSeparator(scene, options);
+}
+//# sourceMappingURL=DebugSeparator.js.map

package/dist/DebugSeparator.js.map

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

package/dist/DebugSlider.d.ts

@@ -0,0 +1,79 @@
+import type { HexColor, Position } from "./types.js";
+export interface DebugSliderStyleOptions {
+    width?: number;
+    height?: number;
+    trackHeight?: number;
+    thumbRadius?: number;
+    trackColor?: HexColor;
+    fillColor?: HexColor;
+    thumbColor?: HexColor;
+}
+export interface CreateDebugSliderOptions extends DebugSliderStyleOptions {
+    /** Current value (default: 0, clamped to min–max range). */
+    value?: number;
+    /** Minimum value (default: 0). */
+    min?: number;
+    /** Maximum value (default: 1). */
+    max?: number;
+    /** Step size — 0 = continuous (default: 0). */
+    step?: number;
+    /** Whether the slider accepts input (default: true). */
+    enabled?: boolean;
+    /** Called when the value changes. */
+    onChange?: (value: number, slider: DebugSlider) => void;
+    /** Position (optional). */
+    position?: Position;
+}
+/**
+ * An interactive horizontal slider for debug HUD.
+ *
+ * Supports min/max range, step snapping, and drag interaction.
+ * Emits `"value-changed"` event. Chainable API.
+ */
+export declare class DebugSlider extends Phaser.GameObjects.Container {
+    private _track;
+    private _fill;
+    private _thumb;
+    private _hitZone;
+    private _value;
+    private _min;
+    private _max;
+    private _step;
+    private _isEnabled;
+    private _isDragging;
+    private _sliderWidth;
+    private _sliderHeight;
+    private _trackHeight;
+    private _thumbRadius;
+    private _trackColor;
+    private _fillColor;
+    private _thumbColor;
+    private _onChangeCallbacks;
+    private _boundOnPointerMove;
+    private _boundOnPointerUp;
+    constructor(scene: Phaser.Scene, options?: CreateDebugSliderOptions);
+    getValue(): number;
+    setValue(value: number): this;
+    isEnabled(): boolean;
+    setEnabled(enabled: boolean): this;
+    onValueChanged(handler: (value: number, slider: DebugSlider) => void): this;
+    setTrackColor(color: HexColor): this;
+    setFillColor(color: HexColor): this;
+    setThumbColor(color: HexColor): this;
+    setRange(min: number, max: number): this;
+    setStep(step: number): this;
+    setSliderSize(width: number, height: number): this;
+    setStyle(options: DebugSliderStyleOptions): this;
+    destroy(fromScene?: boolean): void;
+    private handlePointerDown;
+    private handlePointerMove;
+    private handlePointerUp;
+    private stopDragging;
+    private updateValueFromPointer;
+    private clampAndSnap;
+    private fireOnChange;
+    private applyEnabledState;
+    private redraw;
+}
+export declare function createDebugSlider(scene: Phaser.Scene, options?: CreateDebugSliderOptions): DebugSlider;
+//# sourceMappingURL=DebugSlider.d.ts.map

package/dist/DebugSlider.d.ts.map

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

package/dist/DebugSlider.js

@@ -0,0 +1,233 @@
+import { hexToColorAlpha } from "./utils.js";
+/**
+ * An interactive horizontal slider for debug HUD.
+ *
+ * Supports min/max range, step snapping, and drag interaction.
+ * Emits `"value-changed"` event. Chainable API.
+ */
+export class DebugSlider extends Phaser.GameObjects.Container {
+    _track;
+    _fill;
+    _thumb;
+    _hitZone;
+    _value;
+    _min;
+    _max;
+    _step;
+    _isEnabled;
+    _isDragging = false;
+    _sliderWidth;
+    _sliderHeight;
+    _trackHeight;
+    _thumbRadius;
+    _trackColor;
+    _fillColor;
+    _thumbColor;
+    _onChangeCallbacks = [];
+    _boundOnPointerMove;
+    _boundOnPointerUp;
+    constructor(scene, options = {}) {
+        const { value = 0, min = 0, max = 1, step = 0, enabled = true, width = 200, height = 24, trackHeight = 6, thumbRadius = 10, trackColor = "#333333", fillColor = "#4caf50", thumbColor = "#ffffff", onChange, position, } = options;
+        super(scene, position?.x ?? 0, position?.y ?? 0);
+        this._min = min;
+        this._max = max;
+        this._step = step;
+        this._isEnabled = enabled;
+        this._sliderWidth = width;
+        this._sliderHeight = height;
+        this._trackHeight = trackHeight;
+        this._thumbRadius = thumbRadius;
+        this._trackColor = trackColor;
+        this._fillColor = fillColor;
+        this._thumbColor = thumbColor;
+        this._value = this.clampAndSnap(value);
+        if (onChange)
+            this._onChangeCallbacks.push(onChange);
+        this._track = new Phaser.GameObjects.Graphics(scene);
+        this._fill = new Phaser.GameObjects.Graphics(scene);
+        this._thumb = new Phaser.GameObjects.Graphics(scene);
+        this._hitZone = new Phaser.GameObjects.Zone(scene, 0, 0, width, height);
+        this._hitZone.setInteractive({ useHandCursor: true });
+        this._hitZone.on("pointerdown", this.handlePointerDown, this);
+        this._boundOnPointerMove = this.handlePointerMove.bind(this);
+        this._boundOnPointerUp = this.handlePointerUp.bind(this);
+        this.add([this._track, this._fill, this._thumb, this._hitZone]);
+        this.setSize(width, height);
+        this.applyEnabledState();
+        this.redraw();
+        scene.add.existing(this);
+    }
+    getValue() {
+        return this._value;
+    }
+    setValue(value) {
+        const clamped = this.clampAndSnap(value);
+        if (clamped === this._value)
+            return this;
+        const prev = this._value;
+        this._value = clamped;
+        this.redraw();
+        this.emit("value-changed", clamped, prev);
+        this.fireOnChange();
+        return this;
+    }
+    isEnabled() {
+        return this._isEnabled;
+    }
+    setEnabled(enabled) {
+        this._isEnabled = enabled;
+        this.applyEnabledState();
+        return this;
+    }
+    onValueChanged(handler) {
+        this._onChangeCallbacks.push(handler);
+        return this;
+    }
+    setTrackColor(color) {
+        this._trackColor = color;
+        this.redraw();
+        return this;
+    }
+    setFillColor(color) {
+        this._fillColor = color;
+        this.redraw();
+        return this;
+    }
+    setThumbColor(color) {
+        this._thumbColor = color;
+        this.redraw();
+        return this;
+    }
+    setRange(min, max) {
+        this._min = min;
+        this._max = max;
+        this._value = this.clampAndSnap(this._value);
+        this.redraw();
+        return this;
+    }
+    setStep(step) {
+        this._step = Math.max(0, step);
+        this._value = this.clampAndSnap(this._value);
+        this.redraw();
+        return this;
+    }
+    setSliderSize(width, height) {
+        this._sliderWidth = width;
+        this._sliderHeight = height;
+        this._hitZone.setSize(width, height);
+        this.setSize(width, height);
+        this.redraw();
+        return this;
+    }
+    setStyle(options) {
+        if (options.trackColor !== undefined)
+            this._trackColor = options.trackColor;
+        if (options.fillColor !== undefined)
+            this._fillColor = options.fillColor;
+        if (options.thumbColor !== undefined)
+            this._thumbColor = options.thumbColor;
+        if (options.trackHeight !== undefined)
+            this._trackHeight = options.trackHeight;
+        if (options.thumbRadius !== undefined)
+            this._thumbRadius = options.thumbRadius;
+        if (options.width !== undefined || options.height !== undefined) {
+            this._sliderWidth = options.width ?? this._sliderWidth;
+            this._sliderHeight = options.height ?? this._sliderHeight;
+            this._hitZone.setSize(this._sliderWidth, this._sliderHeight);
+            this.setSize(this._sliderWidth, this._sliderHeight);
+        }
+        this.redraw();
+        return this;
+    }
+    destroy(fromScene) {
+        this.stopDragging();
+        super.destroy(fromScene);
+    }
+    handlePointerDown(pointer) {
+        if (!this._isEnabled)
+            return;
+        this._isDragging = true;
+        this.updateValueFromPointer(pointer);
+        this.scene.input.on("pointermove", this._boundOnPointerMove);
+        this.scene.input.on("pointerup", this._boundOnPointerUp);
+    }
+    handlePointerMove(pointer) {
+        if (!this._isDragging)
+            return;
+        this.updateValueFromPointer(pointer);
+    }
+    handlePointerUp() {
+        this.stopDragging();
+    }
+    stopDragging() {
+        if (!this._isDragging)
+            return;
+        this._isDragging = false;
+        this.scene?.input?.off("pointermove", this._boundOnPointerMove);
+        this.scene?.input?.off("pointerup", this._boundOnPointerUp);
+    }
+    updateValueFromPointer(pointer) {
+        const matrix = this.getWorldTransformMatrix();
+        const tmp = new Phaser.Math.Vector2();
+        matrix.applyInverse(pointer.worldX, pointer.worldY, tmp);
+        const halfW = this._sliderWidth / 2;
+        const ratio = Phaser.Math.Clamp((tmp.x + halfW) / this._sliderWidth, 0, 1);
+        const rawValue = this._min + ratio * (this._max - this._min);
+        this.setValue(rawValue);
+    }
+    clampAndSnap(value) {
+        let v = Phaser.Math.Clamp(value, this._min, this._max);
+        if (this._step > 0) {
+            v = Math.round((v - this._min) / this._step) * this._step + this._min;
+            v = Phaser.Math.Clamp(v, this._min, this._max);
+        }
+        return v;
+    }
+    fireOnChange() {
+        for (const cb of this._onChangeCallbacks) {
+            cb(this._value, this);
+        }
+    }
+    applyEnabledState() {
+        this.setAlpha(this._isEnabled ? 1 : 0.5);
+        if (this._isEnabled) {
+            this._hitZone.setInteractive({ useHandCursor: true });
+        }
+        else {
+            this._hitZone.disableInteractive();
+        }
+    }
+    redraw() {
+        const w = this._sliderWidth;
+        const halfW = w / 2;
+        const th = this._trackHeight;
+        const halfTH = th / 2;
+        const trackRadius = halfTH;
+        // Normalized position 0–1
+        const range = this._max - this._min;
+        const ratio = range > 0 ? (this._value - this._min) / range : 0;
+        const thumbX = -halfW + ratio * w;
+        // Track
+        const tc = hexToColorAlpha(this._trackColor);
+        this._track.clear();
+        this._track.fillStyle(tc.color, tc.alpha);
+        this._track.fillRoundedRect(-halfW, -halfTH, w, th, trackRadius);
+        // Fill
+        const fc = hexToColorAlpha(this._fillColor);
+        const fillWidth = ratio * w;
+        this._fill.clear();
+        if (fillWidth > 0) {
+            this._fill.fillStyle(fc.color, fc.alpha);
+            this._fill.fillRect(-halfW, -halfTH, fillWidth, th);
+        }
+        // Thumb
+        const thumbC = hexToColorAlpha(this._thumbColor);
+        this._thumb.clear();
+        this._thumb.fillStyle(thumbC.color, thumbC.alpha);
+        this._thumb.fillCircle(thumbX, 0, this._thumbRadius);
+    }
+}
+export function createDebugSlider(scene, options = {}) {
+    return new DebugSlider(scene, options);
+}
+//# sourceMappingURL=DebugSlider.js.map

package/dist/DebugSlider.js.map

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

package/dist/DebugToggle.d.ts

@@ -0,0 +1,57 @@
+import type { HexColor, Position } from "./types.js";
+export interface DebugToggleStyleOptions {
+    width?: number;
+    height?: number;
+    onColor?: HexColor;
+    offColor?: HexColor;
+    thumbColor?: HexColor;
+    thumbPadding?: number;
+}
+export interface CreateDebugToggleOptions extends DebugToggleStyleOptions {
+    /** Initial value (default: false). */
+    value?: boolean;
+    /** Whether the toggle accepts input (default: true). */
+    enabled?: boolean;
+    /** Called when the value changes. */
+    onChange?: (value: boolean, toggle: DebugToggle) => void;
+    /** Position (optional). */
+    position?: Position;
+}
+/**
+ * A boolean on/off pill toggle switch for debug HUD.
+ *
+ * Click to flip state. Emits `"value-changed"` event.
+ * Supports enabled/disabled state and chainable API.
+ */
+export declare class DebugToggle extends Phaser.GameObjects.Container {
+    private _track;
+    private _thumb;
+    private _hitZone;
+    private _isOn;
+    private _isEnabled;
+    private _onColor;
+    private _offColor;
+    private _thumbColor;
+    private _toggleWidth;
+    private _toggleHeight;
+    private _thumbPadding;
+    private _onChangeCallbacks;
+    constructor(scene: Phaser.Scene, options?: CreateDebugToggleOptions);
+    getValue(): boolean;
+    setValue(value: boolean): this;
+    toggle(): this;
+    isEnabled(): boolean;
+    setEnabled(enabled: boolean): this;
+    onValueChanged(handler: (value: boolean, toggle: DebugToggle) => void): this;
+    setOnColor(color: HexColor): this;
+    setOffColor(color: HexColor): this;
+    setThumbColor(color: HexColor): this;
+    setToggleSize(width: number, height: number): this;
+    setStyle(options: DebugToggleStyleOptions): this;
+    private handleClick;
+    private fireOnChange;
+    private applyEnabledState;
+    private redraw;
+}
+export declare function createDebugToggle(scene: Phaser.Scene, options?: CreateDebugToggleOptions): DebugToggle;
+//# sourceMappingURL=DebugToggle.d.ts.map

package/dist/DebugToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugToggle.d.ts","sourceRoot":"","sources":["../src/DebugToggle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGpD,MAAM,WAAW,uBAAuB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,QAAQ,CAAA;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,UAAU,CAAC,EAAE,QAAQ,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,wBAAyB,SAAQ,uBAAuB;IACxE,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IACxD,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB;AAED;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,MAAM,CAAC,WAAW,CAAC,SAAS;IAC5D,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,kBAAkB,CAA2D;gBAEzE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAE,wBAA6B;IA0CvE,QAAQ,IAAI,OAAO;IAInB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAS9B,MAAM,IAAI,IAAI;IAId,SAAS,IAAI,OAAO;IAIpB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAMlC,cAAc,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAK5E,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAMjC,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAMlC,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAMpC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IASlD,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAehD,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,MAAM;CAsBd;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAE,wBAA6B,GAAG,WAAW,CAE1G"}