canvasengine 2.0.0-beta.6 → 2.0.0-beta.61

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"}

package/dist/directives/KeyboardControls.d.ts

@@ -0,0 +1,219 @@
+import { ControlsBase, ControlOptions, Controls, BoundKey } from './ControlsBase';
+export declare enum Input {
+    Break = "break",
+    Backspace = "backspace",
+    Tab = "tab",
+    Clear = "clear",
+    Enter = "enter",
+    Shift = "shift",
+    Ctrl = "ctrl",
+    Alt = "alt",
+    Pause = "pause/break",
+    CapsLock = "caps lock",
+    Escape = "escape",
+    Conversion = "conversion",
+    NonConversion = "non-conversion",
+    Space = "space",
+    PageUp = "page up",
+    PageDown = "page down",
+    End = "end",
+    Home = "home",
+    Left = 4,
+    Up = 1,
+    Right = 2,
+    Down = 3,
+    Select = "select",
+    Print = "print",
+    Execute = "execute",
+    PrintScreen = "Print Screen",
+    Insert = "insert",
+    Delete = "delete",
+    Zero = "0",
+    One = "1",
+    Two = "2",
+    Three = "3",
+    Four = "4",
+    Five = "5",
+    Six = "6",
+    Seven = "7",
+    Height = "8",
+    Nine = "9",
+    Equal = "=",
+    Semicolon = "semicolon (firefox), equals",
+    LessThan = "<",
+    Equals = "equals (firefox)",
+    Beta = "\u00DF",
+    At = "@",
+    A = "a",
+    B = "b",
+    C = "c",
+    D = "d",
+    E = "e",
+    F = "f",
+    G = "g",
+    H = "h",
+    I = "i",
+    J = "j",
+    K = "k",
+    L = "l",
+    M = "m",
+    N = "n",
+    O = "o",
+    P = "p",
+    Q = "q",
+    R = "r",
+    S = "s",
+    T = "t",
+    U = "u",
+    V = "v",
+    W = "w",
+    X = "x",
+    Y = "y",
+    Z = "z",
+    SearchKey = "Windows Key / Left \u2318 / Chromebook Search key",
+    NumPad0 = "numpad 0",
+    NumPad1 = "numpad 1",
+    NumPad2 = "numpad 2",
+    NumPad3 = "numpad 3",
+    NumPad4 = "numpad 4",
+    NumPad5 = "numpad 5",
+    NumPad6 = "numpad 6",
+    NumPad7 = "numpad 7",
+    NumPad8 = "numpad 8",
+    NumPad9 = "numpad 9",
+    Multiply = "multiply",
+    Add = "add",
+    Subtract = "subtract",
+    DecimalPoint = "decimal point",
+    Divide = "divide",
+    F1 = "f1",
+    F2 = "f2",
+    F3 = "f3",
+    F4 = "f4",
+    F5 = "f5",
+    F6 = "f6",
+    F7 = "f7",
+    F8 = "f8",
+    F9 = "f9",
+    F10 = "f10",
+    F11 = "f11",
+    F12 = "f12",
+    F13 = "f13",
+    F14 = "f14",
+    F15 = "f15",
+    F16 = "f16",
+    F17 = "f17",
+    F18 = "f18",
+    F19 = "f19",
+    F20 = "f20",
+    F21 = "f21",
+    F22 = "f22",
+    F23 = "f23",
+    F24 = "f24",
+    NumLock = "num lock",
+    ScrollLock = "scroll lock",
+    CircumflexAccent = "^",
+    ExclamationMark = "!",
+    Hash = "#",
+    Dollar = "$",
+    AccentU = "\u00F9",
+    PageBackward = "page backward",
+    PageForWard = "page forward",
+    Star = "*",
+    DecreaseVolume = "decrease volume level",
+    IncreaseVolume = "increase volume level",
+    Next = "next",
+    Previous = "previous",
+    Stop = "stop",
+    PlayPause = "play/pause",
+    Email = "e-mail",
+    SemiColon = "semi-colon / \u00F1",
+    EqualSign = "equal sign",
+    Comma = "comma",
+    Dash = "dash",
+    FowardSlach = "forward slash / \u00E7",
+    GraveAccent = "grave accent / \u00F1 / \u00E6",
+    OpenBracket = "open bracket",
+    BackSlach = "back slash",
+    CloseBracket = "close bracket / \u00E5",
+    SingleQuote = "single quote / \u00F8",
+    BackQuote = "`",
+    Altgr = "altgr"
+}
+export type { ControlOptions, Controls, BoundKey };
+/**
+ * Keyboard input controls implementation
+ *
+ * Handles keyboard input events and maps them to control actions.
+ * Supports composite directions (diagonal movement) and key repeat functionality.
+ *
+ * @example
+ * ```ts
+ * const keyboardControls = new KeyboardControls();
+ * keyboardControls.setInputs({
+ *   up: {
+ *     repeat: true,
+ *     bind: Input.Up,
+ *     keyDown() {
+ *       console.log('Up pressed');
+ *     }
+ *   }
+ * });
+ * keyboardControls.start();
+ * ```
+ */
+export declare class KeyboardControls extends ControlsBase {
+    private keyState;
+    private lastKeyPressed;
+    private lastActionTimes;
+    private directionState;
+    /**
+     * Setup keyboard event listeners
+     */
+    protected setupListeners(): void;
+    /**
+     * Cleanup keyboard event listeners
+     */
+    protected cleanup(): void;
+    /**
+     * Process keyboard inputs each step
+     */
+    protected preStep(): void;
+    /**
+     * Apply input for a keyboard key
+     * Overrides base implementation to handle key state and repeat logic
+     */
+    protected applyInput(keyName: string): void;
+    private applyKeyDown;
+    private applyKeyUp;
+    private applyKeyPress;
+    private onKeyChange;
+    private updateDirectionState;
+    private getDirection;
+    /**
+     * Apply a control action programmatically
+     * Triggers keyboard events to simulate key presses
+     *
+     * @param controlName - Name of the control
+     * @param isDown - Whether the key is pressed (true) or released (false)
+     * @returns Promise that resolves when the action is complete
+     * @example
+     * ```ts
+     * // Press a key
+     * await keyboardControls.applyControl('action', true);
+     *
+     * // Release a key
+     * await keyboardControls.applyControl('action', false);
+     *
+     * // Press and release (default)
+     * await keyboardControls.applyControl('action');
+     * ```
+     */
+    applyControl(controlName: string | number, isDown?: boolean | undefined): Promise<void>;
+    /**
+     * Resume listening to inputs after stopInputs() was called
+     * Also resets keyboard state
+     */
+    listenInputs(): void;
+}
+//# sourceMappingURL=KeyboardControls.d.ts.map

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

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

package/dist/directives/Scheduler.d.ts

@@ -0,0 +1,36 @@
+import { Directive } from '../engine/directive';
+import { Element } from '../engine/reactive';
+export interface Tick {
+    timestamp: number;
+    deltaTime: number;
+    frame: number;
+    deltaRatio: number;
+}
+export declare class Scheduler extends Directive {
+    private maxFps?;
+    private fps;
+    private deltaTime;
+    frame: number;
+    private timestamp;
+    private requestedDelay;
+    private lastTimestamp;
+    private _stop;
+    private running;
+    private tick;
+    onInit(element: Element): void;
+    onDestroy(): void;
+    onMount(element: Element): void;
+    onUpdate(props: any): void;
+    nextTick(timestamp: number): void;
+    /**
+     * start the schedule
+     * @return {Scheduler} returns this scheduler instance
+     */
+    start(options?: {
+        maxFps?: number;
+        fps?: number;
+        delay?: number;
+    }): this;
+    stop(): void;
+}
+//# sourceMappingURL=Scheduler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Scheduler.d.ts","sourceRoot":"","sources":["../../src/directives/Scheduler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAqB,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,MAAM,WAAW,IAAI;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;CACrB;AAED,qBAAa,SAAU,SAAQ,SAAS;IACpC,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,SAAS,CAAY;IACtB,KAAK,EAAE,MAAM,CAAI;IACxB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,cAAc,CAAY;IAClC,OAAO,CAAC,aAAa,CAAY;IACjC,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,IAAI,CAA6B;IAEzC,MAAM,CAAC,OAAO,EAAE,OAAO;IAIvB,SAAS;IAGT,OAAO,CAAC,OAAO,EAAE,OAAO;IACxB,QAAQ,CAAC,KAAK,EAAE,GAAG;IAEnB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAqB1B;;;OAGG;IACH,KAAK,CAAC,OAAO,GAAE;QACX,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAA;KACZ;IA+CN,IAAI;CAIP"}