canvasengine 2.0.0-beta.5 → 2.0.0-beta.51

package/dist/directives/Flash.d.ts

@@ -0,0 +1,116 @@
+import { Container } from 'pixi.js';
+import { Directive } from '../engine/directive';
+import { Element } from '../engine/reactive';
+import { Trigger } from '../engine/trigger';
+import { SignalOrPrimitive } from '../components/types';
+export type FlashType = 'alpha' | 'tint' | 'both';
+export type FlashProps = {
+    /**
+     * Trigger that activates the flash animation
+     * When the trigger is activated, the flash animation will start
+     */
+    trigger?: Trigger<any>;
+    /**
+     * Type of flash effect: 'alpha' (opacity), 'tint' (color), or 'both'
+     * @default 'alpha'
+     */
+    type?: SignalOrPrimitive<FlashType>;
+    /**
+     * Duration of the flash animation in milliseconds
+     * @default 300
+     */
+    duration?: SignalOrPrimitive<number>;
+    /**
+     * Number of flash cycles (flash on/off)
+     * @default 1
+     */
+    cycles?: SignalOrPrimitive<number>;
+    /**
+     * Alpha value when flashing (0 to 1)
+     * Only used when type is 'alpha' or 'both'
+     * @default 0.3
+     */
+    alpha?: SignalOrPrimitive<number>;
+    /**
+     * Tint color when flashing (hex color value)
+     * Only used when type is 'tint' or 'both'
+     * @default 0xffffff (white)
+     */
+    tint?: SignalOrPrimitive<number>;
+    /**
+     * Original alpha value to restore after flash
+     * If not provided, uses the current alpha value
+     */
+    originalAlpha?: number;
+    /**
+     * Original tint value to restore after flash
+     * If not provided, uses the current tint value
+     */
+    originalTint?: number;
+    /**
+     * Callback function called when flash starts
+     */
+    onStart?: () => void;
+    /**
+     * Callback function called when flash completes
+     */
+    onComplete?: () => void;
+};
+/**
+ * Flash directive that animates a display object's alpha and/or tint when a trigger is activated.
+ * Creates a flash effect by rapidly changing opacity or color.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with trigger
+ * const flashTrigger = trigger();
+ *
+ * onMount(element) {
+ *   // Element will flash when trigger is activated
+ *   element.props.flash = { trigger: flashTrigger };
+ * }
+ *
+ * // Trigger the flash
+ * flashTrigger.start();
+ * ```
+ */
+export declare class Flash extends Directive {
+    private elementRef;
+    private progressSignal;
+    private flashSubscription;
+    private alphaEffect;
+    private tintEffect;
+    private originalAlpha;
+    private originalTint;
+    private currentFlashConfig;
+    /**
+     * Initializes the flash directive
+     * @param element - The element to attach the flash effect to
+     */
+    onInit(element: Element<Container>): void;
+    /**
+     * Mounts the flash directive and sets up trigger listener
+     * @param element - The element being mounted
+     */
+    onMount(element: Element<Container>): void;
+    /**
+     * Gets the flash props with default values
+     * @returns FlashProps with defaults applied
+     */
+    get flashProps(): FlashProps;
+    /**
+     * Performs the flash animation using animatedSignal
+     * @param data - Optional data passed from the trigger that can override default options
+     */
+    private performFlash;
+    /**
+     * Updates the flash directive when props change
+     * @param props - Updated props
+     */
+    onUpdate(props: any): void;
+    /**
+     * Cleans up the flash directive
+     */
+    onDestroy(): void;
+}
+//# sourceMappingURL=Flash.d.ts.map

package/dist/directives/Flash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Flash.d.ts","sourceRoot":"","sources":["../../src/directives/Flash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,SAAS,EAAqB,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAiB,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIxD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACvB;;;OAGG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC;;;;OAIG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAClC;;;;OAIG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,KAAM,SAAQ,SAAS;IAChC,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,kBAAkB,CAMV;IAEhB;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC;IAIlC;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC;IAgCnC;;;OAGG;IACH,IAAI,UAAU,IAAI,UAAU,CAS3B;IAED;;;OAGG;YACW,YAAY;IAgM1B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG;IAUnB;;OAEG;IACH,SAAS;CA4CZ"}

package/dist/directives/FocusNavigation.d.ts

@@ -0,0 +1,52 @@
+import { Directive } from '../engine/directive';
+import { Element } from '../engine/reactive';
+import { CanvasFocusContainer } from '../components/FocusContainer';
+/**
+ * FocusNavigation directive for wiring Controls with FocusContainer
+ *
+ * This directive integrates with the Controls system and lets external
+ * control handlers update the FocusContainer tabindex signal.
+ *
+ * The directive is automatically applied when a FocusContainer has a `controls` prop.
+ * It keeps the Controls directive in sync with the provided controls config.
+ *
+ * @example
+ * ```typescript
+ * // Automatic navigation with Controls
+ * <FocusContainer tabindex={0} controls={controlsConfig}>
+ *   <Button tabindex={0} text="Button 1" />
+ *   <Button tabindex={1} text="Button 2" />
+ * </FocusContainer>
+ * ```
+ */
+export declare class FocusNavigationDirective extends Directive {
+    private element;
+    private controlsDirective;
+    private controlsSubscription;
+    /**
+     * Initialize the focus navigation directive
+     *
+     * @param element - FocusContainer element
+     */
+    onInit(element: Element<CanvasFocusContainer>): void;
+    /**
+     * Mount hook
+     *
+     * @param element - FocusContainer element
+     */
+    onMount(element: Element<CanvasFocusContainer>): void;
+    /**
+     * Update hook
+     *
+     * @param props - Updated properties
+     * @param element - FocusContainer element
+     */
+    onUpdate(props: any, element: Element<CanvasFocusContainer>): void;
+    /**
+     * Destroy hook
+     *
+     * @param element - FocusContainer element
+     */
+    onDestroy(element: Element<CanvasFocusContainer>): void;
+}
+//# sourceMappingURL=FocusNavigation.d.ts.map

package/dist/directives/FocusNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FocusNavigation.d.ts","sourceRoot":"","sources":["../../src/directives/FocusNavigation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqC,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,wBAAyB,SAAQ,SAAS;IACrD,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,oBAAoB,CAAa;IAEzC;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAI7C;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAmC9C;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAU3D;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC;CAUjD"}

package/dist/directives/GamepadControls.d.ts

@@ -0,0 +1,224 @@
+import { ControlsBase, Controls } from './ControlsBase';
+import { WritableSignal } from '@signe/reactive';
+/**
+ * Gamepad configuration interface
+ *
+ * @example
+ * ```ts
+ * const gamepadConfig: GamepadConfig = {
+ *   enabled: true,
+ *   buttonMapping: {
+ *     'button_0': 'action',
+ *     'button_1': 'back'
+ *   },
+ *   axisMapping: {
+ *     'top': 'up',
+ *     'bottom': 'down',
+ *     'left': 'left',
+ *     'right': 'right'
+ *   },
+ *   moveInterval: 400,
+ *   onConnect: () => console.log('Gamepad connected!'),
+ *   onDisconnect: () => console.log('Gamepad disconnected!')
+ * };
+ * ```
+ */
+export interface GamepadConfig {
+    /** Whether gamepad is enabled (default: true) */
+    enabled?: boolean;
+    /** Mapping of gamepad button names to control names */
+    buttonMapping?: {
+        [buttonName: string]: string;
+    };
+    /** Mapping of axis directions to control directions */
+    axisMapping?: {
+        [axisDirection: string]: string;
+    };
+    /** Threshold for axis movement detection (default: 0.5) */
+    axisThreshold?: number;
+    /** Interval in milliseconds for repeating movement actions (default: 400) */
+    moveInterval?: number;
+    /** Callback called when a gamepad is connected */
+    onConnect?: () => void;
+    /** Callback called when a gamepad is disconnected */
+    onDisconnect?: () => void;
+    /** Signal that tracks gamepad connection status (optional) */
+    gamepadConnected?: WritableSignal<boolean>;
+}
+/**
+ * Gamepad input controls implementation
+ *
+ * Handles gamepad input events using joypad.js library and maps them to control actions.
+ * Supports button presses and analog stick movement with configurable mappings.
+ *
+ * The gamepad controls are automatically activated when joypad.js is available and enabled.
+ *
+ * @example
+ * ```ts
+ * const gamepadControls = new GamepadControls();
+ * gamepadControls.setInputs({
+ *   up: {
+ *     repeat: true,
+ *     bind: 'up',
+ *     keyDown() {
+ *       console.log('Up pressed');
+ *     }
+ *   }
+ * });
+ * gamepadControls.updateGamepadConfig({
+ *   enabled: true,
+ *   buttonMapping: {
+ *     'button_0': 'action'
+ *   }
+ * });
+ * gamepadControls.start();
+ * ```
+ */
+export declare class GamepadControls extends ControlsBase {
+    private gamepadEnabled;
+    private gamepadConfig;
+    private gamepadMoving;
+    private gamepadDirections;
+    private gamepadAxisDate;
+    private gamepadMoveInterval;
+    private joypad;
+    private connectCallbacks;
+    private disconnectCallbacks;
+    private currentPower;
+    /**
+     * Setup gamepad event listeners
+     * Initializes joypad.js if available
+     */
+    protected setupListeners(): void;
+    /**
+     * Cleanup gamepad event listeners and intervals
+     */
+    protected cleanup(): void;
+    /**
+     * Initialize joypad.js library if available
+     */
+    private initGamepad;
+    /**
+     * Handle gamepad connection event
+     */
+    private handleGamepadConnect;
+    /**
+     * Handle gamepad disconnection event
+     */
+    private handleGamepadDisconnect;
+    /**
+     * Handle gamepad button press event
+     *
+     * @param e - Button press event from joypad.js
+     */
+    private handleGamepadButtonPress;
+    /**
+     * Handle gamepad axis movement event
+     *
+     * @param e - Axis move event from joypad.js
+     */
+    private handleGamepadAxisMove;
+    /**
+     * Process continuous gamepad movement
+     * Called at intervals to repeat movement actions while axes are active
+     */
+    private processGamepadMovement;
+    /**
+     * Process gamepad inputs each step
+     * Handles timeout for stopping movements after axis inactivity
+     */
+    protected preStep(): void;
+    /**
+     * Update gamepad configuration
+     * Merges provided config with defaults
+     * Automatically registers callbacks from config
+     *
+     * @param config - Partial gamepad configuration
+     */
+    updateGamepadConfig(config: Partial<GamepadConfig>): void;
+    /**
+     * Extract gamepad config from controls configuration and update
+     * Note: Callbacks are stored but not automatically registered, they should be registered in mount()
+     *
+     * @param inputs - Controls configuration that may contain a 'gamepad' property
+     */
+    extractGamepadConfig(inputs: Controls & {
+        gamepad?: GamepadConfig;
+    }): void;
+    /**
+     * Get the current gamepad configuration
+     *
+     * @returns The gamepad configuration object
+     */
+    getGamepadConfig(): GamepadConfig;
+    /**
+     * Apply a control action programmatically
+     * Uses the bound controls to trigger actions
+     *
+     * @param controlName - Name of the control
+     * @param isDown - Whether the control is pressed (true) or released (false)
+     * @param payload - Optional payload to pass to keyDown/keyUp callbacks (e.g., { power: 0.8 })
+     * @returns Promise that resolves when the action is complete
+     */
+    applyControl(controlName: string | number, isDown?: boolean, payload?: any): Promise<void>;
+    /**
+     * Override setInputs to extract gamepad config
+     */
+    setInputs(inputs: Controls & {
+        gamepad?: GamepadConfig;
+    }): void;
+    /**
+     * Register a callback to be called when a gamepad is connected
+     *
+     * @param callback - Function to call when gamepad connects
+     * @example
+     * ```ts
+     * gamepadControls.onConnect(() => {
+     *   console.log('Gamepad connected!');
+     * });
+     * ```
+     */
+    onConnect(callback: () => void): void;
+    /**
+     * Register a callback to be called when a gamepad is disconnected
+     *
+     * @param callback - Function to call when gamepad disconnects
+     * @example
+     * ```ts
+     * gamepadControls.onDisconnect(() => {
+     *   console.log('Gamepad disconnected!');
+     * });
+     * ```
+     */
+    onDisconnect(callback: () => void): void;
+    /**
+     * Remove a connect callback
+     *
+     * @param callback - Callback to remove
+     */
+    offConnect(callback: () => void): void;
+    /**
+     * Remove a disconnect callback
+     *
+     * @param callback - Callback to remove
+     */
+    offDisconnect(callback: () => void): void;
+    /**
+     * Check if gamepad is currently connected
+     *
+     * @returns true if gamepad is connected, false otherwise
+     */
+    isConnected(): boolean;
+    /**
+     * Reinitialize gamepad listeners
+     * Useful if joypad.js becomes available after initialization
+     *
+     * @example
+     * ```ts
+     * // If joypad.js loads later
+     * gamepadControls.reinit();
+     * ```
+     */
+    reinit(): void;
+}
+//# sourceMappingURL=GamepadControls.d.ts.map

package/dist/directives/GamepadControls.d.ts.map

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

package/dist/directives/JoystickControls.d.ts

@@ -0,0 +1,171 @@
+import { ControlsBase, Controls } from './ControlsBase';
+/**
+ * Joystick directions reported by the Joystick component
+ */
+export type JoystickDirection = 'left' | 'right' | 'top' | 'bottom' | 'top_left' | 'top_right' | 'bottom_left' | 'bottom_right';
+/**
+ * Joystick change event payload
+ */
+export interface JoystickChangeEvent {
+    angle: number;
+    direction: JoystickDirection;
+    power: number;
+}
+/**
+ * Joystick configuration interface
+ *
+ * @example
+ * ```ts
+ * const joystickConfig: JoystickConfig = {
+ *   enabled: true,
+ *   directionMapping: {
+ *     'top': 'up',
+ *     'bottom': 'down',
+ *     'left': 'left',
+ *     'right': 'right',
+ *     'top_left': ['up', 'left'],
+ *     'top_right': ['up', 'right'],
+ *     'bottom_left': ['down', 'left'],
+ *     'bottom_right': ['down', 'right']
+ *   },
+ *   moveInterval: 50,
+ *   threshold: 0.1
+ * };
+ * ```
+ */
+export interface JoystickConfig {
+    /** Whether joystick is enabled (default: true) */
+    enabled?: boolean;
+    /** Mapping of joystick direction names to control names (can be single string or array for diagonals) */
+    directionMapping?: {
+        [joystickDirection: string]: string | string[];
+    };
+    /** Interval in milliseconds for repeating movement actions (default: 50) */
+    moveInterval?: number;
+    /** Threshold for power value to trigger movement (default: 0.1) */
+    threshold?: number;
+}
+/**
+ * Joystick input controls implementation
+ *
+ * Handles joystick input events from the Joystick component and maps them to control actions.
+ * Supports directional movement with configurable mappings, including diagonal directions.
+ *
+ * The joystick controls work by receiving change events from a Joystick component instance.
+ *
+ * @example
+ * ```ts
+ * const joystickControls = new JoystickControls();
+ * joystickControls.setInputs({
+ *   up: {
+ *     repeat: true,
+ *     bind: 'up',
+ *     keyDown() {
+ *       console.log('Up pressed');
+ *     }
+ *   }
+ * });
+ * joystickControls.updateJoystickConfig({
+ *   enabled: true,
+ *   directionMapping: {
+ *     'top': 'up'
+ *   }
+ * });
+ * joystickControls.start();
+ *
+ * // Later, when joystick changes:
+ * joystickControls.handleJoystickChange({ angle: 90, direction: Direction.TOP, power: 0.8 });
+ * ```
+ */
+export declare class JoystickControls extends ControlsBase {
+    private joystickEnabled;
+    private joystickConfig;
+    private joystickMoving;
+    private joystickDirections;
+    private joystickLastUpdate;
+    private joystickMoveInterval;
+    private currentPower;
+    /**
+     * Setup joystick event listeners
+     * Note: Joystick events are handled via handleJoystickChange() method
+     */
+    protected setupListeners(): void;
+    /**
+     * Cleanup joystick intervals
+     */
+    protected cleanup(): void;
+    /**
+     * Process joystick inputs each step
+     * Continuous actions are handled by the interval; no inactivity timeout here.
+     */
+    protected preStep(): void;
+    /**
+     * Handle joystick change event
+     * Called by the Joystick component when its position changes
+     *
+     * @param event - Joystick change event containing angle, direction, and power
+     */
+    handleJoystickChange(event: JoystickChangeEvent): void;
+    /**
+     * Handle joystick start event
+     * Called when user starts interacting with the joystick
+     */
+    handleJoystickStart(): void;
+    /**
+     * Handle joystick end event
+     * Called when user stops interacting with the joystick
+     */
+    handleJoystickEnd(): void;
+    /**
+     * Stop all active joystick movements
+     */
+    private stopAllMovements;
+    /**
+     * Process continuous joystick movement
+     * Called at intervals to repeat movement actions while joystick is active
+     */
+    private processJoystickMovement;
+    /**
+     * Update joystick configuration
+     * Merges provided config with defaults
+     *
+     * @param config - Partial joystick configuration
+     */
+    updateJoystickConfig(config: Partial<JoystickConfig>): void;
+    /**
+     * Extract joystick config from controls configuration and update
+     *
+     * @param inputs - Controls configuration that may contain a 'joystick' property
+     */
+    extractJoystickConfig(inputs: Controls & {
+        joystick?: JoystickConfig;
+    }): void;
+    /**
+     * Get the current joystick configuration
+     *
+     * @returns The joystick configuration object
+     */
+    getJoystickConfig(): JoystickConfig;
+    /**
+     * Apply a control action programmatically
+     * Uses the bound controls to trigger actions
+     *
+     * @param controlName - Name of the control
+     * @param isDown - Whether the control is pressed (true) or released (false)
+     * @returns Promise that resolves when the action is complete
+     */
+    applyControl(controlName: string | number, isDown?: boolean, payload?: any): Promise<void>;
+    /**
+     * Override setInputs to extract joystick config
+     */
+    setInputs(inputs: Controls & {
+        joystick?: JoystickConfig;
+    }): void;
+    /**
+     * Check if joystick is currently active
+     *
+     * @returns true if joystick is moving, false otherwise
+     */
+    isActive(): boolean;
+}
+//# sourceMappingURL=JoystickControls.d.ts.map

package/dist/directives/JoystickControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JoystickControls.d.ts","sourceRoot":"","sources":["../../src/directives/JoystickControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACvB,MAAM,GACN,OAAO,GACP,KAAK,GACL,QAAQ,GACR,UAAU,GACV,WAAW,GACX,aAAa,GACb,cAAc,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,iBAAiB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,cAAc;IAC3B,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yGAAyG;IACzG,gBAAgB,CAAC,EAAE;QACf,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;KAClD,CAAC;IACF,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAC9C,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,cAAc,CAKpB;IACF,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,kBAAkB,CAAwC;IAClE,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,oBAAoB,CAAa;IACzC,OAAO,CAAC,YAAY,CAAa;IAEjC;;;OAGG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;IAKhC;;OAEG;IACH,SAAS,CAAC,OAAO,IAAI,IAAI;IAOzB;;;OAGG;IACH,SAAS,CAAC,OAAO,IAAI,IAAI;IAKzB;;;;;OAKG;IACH,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAwEtD;;;OAGG;IACH,mBAAmB,IAAI,IAAI;IAM3B;;;OAGG;IACH,iBAAiB,IAAI,IAAI;IAKzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAa/B;;;;;OAKG;IACH,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAS3D;;;;OAIG;IACH,qBAAqB,CAAC,MAAM,EAAE,QAAQ,GAAG;QAAE,QAAQ,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,IAAI;IAM7E;;;;OAIG;IACH,iBAAiB,IAAI,cAAc;IAInC;;;;;;;OAOG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAsDhG;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG;QAAE,QAAQ,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,IAAI;IAKjE;;;;OAIG;IACH,QAAQ,IAAI,OAAO;CAGtB"}