@directivegames/genesys.js 3.1.24

package/dist/src/xr/VRControllerManager.js

@@ -0,0 +1,539 @@
+/**
+ * VRControllerManager - manages WebXR motion controllers and hand tracking.
+ *
+ * Refactored to use VRInputDevice abstraction for cleaner code and better separation of concerns.
+ * - Handles automatic detection and setup of VR controllers/hands
+ * - Uses VRController and VRHand classes for device-specific logic
+ * - Updates all input devices every frame
+ * - Supports both motion controllers and hand tracking
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Instantiate in VR applications that need controller representation
+ * - Call setupWithRenderer() to connect to XR session events
+ * - Call updateControllers() in your animation loop
+ * - Subscribe to delegates for controller events
+ */
+import { Delegate } from '../utils/Delegate.js';
+import { VRInputDevice } from './VRInputDevice.js';
+export var XRButton;
+(function (XRButton) {
+    /** Primary trigger - required for all xr-standard controllers */
+    XRButton["Trigger"] = "Trigger";
+    /** Primary squeeze button - optional */
+    XRButton["Squeeze"] = "Squeeze";
+    /** Primary touchpad - optional */
+    XRButton["Touchpad"] = "Touchpad";
+    /** Primary thumbstick - optional */
+    XRButton["Thumbstick"] = "Thumbstick";
+})(XRButton || (XRButton = {}));
+export var XRAxis;
+(function (XRAxis) {
+    XRAxis["TouchpadX"] = "TouchpadX";
+    XRAxis["TouchpadY"] = "TouchpadY";
+    XRAxis["ThumbstickX"] = "ThumbstickX";
+    XRAxis["ThumbstickY"] = "ThumbstickY";
+})(XRAxis || (XRAxis = {}));
+/**
+ * XR Button indices according to the "xr-standard" mapping
+ * https://www.w3.org/TR/webxr-gamepads-module/#xr-standard-gamepad-mapping
+ */
+// Internal index mappings (xr-standard gamepad mapping)
+const XR_BUTTON_TO_INDEX = {
+    [XRButton.Trigger]: 0,
+    [XRButton.Squeeze]: 1,
+    [XRButton.Touchpad]: 2,
+    [XRButton.Thumbstick]: 3
+};
+const INDEX_TO_XR_BUTTON = {
+    0: XRButton.Trigger,
+    1: XRButton.Squeeze,
+    2: XRButton.Touchpad,
+    3: XRButton.Thumbstick
+};
+const XR_AXIS_TO_INDEX = {
+    [XRAxis.TouchpadX]: 0,
+    [XRAxis.TouchpadY]: 1,
+    [XRAxis.ThumbstickX]: 2,
+    [XRAxis.ThumbstickY]: 3
+};
+const INDEX_TO_XR_AXIS = {
+    0: XRAxis.TouchpadX,
+    1: XRAxis.TouchpadY,
+    2: XRAxis.ThumbstickX,
+    3: XRAxis.ThumbstickY
+};
+export class VRControllerManager {
+    // Public helpers: indexes are internal; expose enum <-> index mapping only here
+    static getButtonIndex(button) { return XR_BUTTON_TO_INDEX[button]; }
+    static getAxisIndex(axis) { return XR_AXIS_TO_INDEX[axis]; }
+    constructor(world, options = {}) {
+        Object.defineProperty(this, "devices", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        }); // Array of 2 devices (index 0 = left, index 1 = right)
+        Object.defineProperty(this, "world", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "renderer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "options", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        // Button state tracking
+        Object.defineProperty(this, "previousButtonStates", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        // Axis state tracking for thumbsticks and touchpads
+        Object.defineProperty(this, "previousAxisStates", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        /** Fired when a controller is added */
+        Object.defineProperty(this, "onControllerAdded", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        /** Fired when a controller is removed */
+        Object.defineProperty(this, "onControllerRemoved", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        /** Fired when controller position/state updates */
+        Object.defineProperty(this, "onControllerUpdated", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        /** Fired when an XR controller button is pressed */
+        Object.defineProperty(this, "onButtonDown", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        /** Fired when an XR controller button is released */
+        Object.defineProperty(this, "onButtonUp", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        /** Fired when an XR controller button value changes (for analog buttons) */
+        Object.defineProperty(this, "onButtonValueChanged", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        /** Fired when an XR controller axis value changes (thumbsticks, touchpads) */
+        Object.defineProperty(this, "onAxisChanged", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        /** Fired when a squeeze gesture starts (grab/pinch) */
+        Object.defineProperty(this, "onSqueezeStart", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        /** Fired when a squeeze gesture ends successfully */
+        Object.defineProperty(this, "onSqueeze", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        /** Fired when a squeeze gesture ends (success or failure) */
+        Object.defineProperty(this, "onSqueezeEnd", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        /** Fired when a select action starts (trigger/tap) */
+        Object.defineProperty(this, "onSelectStart", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        /** Fired when a select action completes successfully */
+        Object.defineProperty(this, "onSelect", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        /** Fired when a select action ends (success or failure) */
+        Object.defineProperty(this, "onSelectEnd", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        this.world = world;
+        this.options = {
+            rayVisualizationEnabled: options.rayVisualizationEnabled ?? true,
+            maxRayDistance: options.maxRayDistance ?? 10
+        };
+    }
+    /**
+     * Get the renderer instance
+     */
+    getRenderer() {
+        return this.renderer;
+    }
+    /**
+     * Setup the controller manager with a WebXR renderer
+     */
+    setupWithRenderer(renderer) {
+        this.renderer = renderer;
+        // Create VR input devices for both controller indices
+        this.createVRDevices();
+        renderer.xr.addEventListener('sessionstart', () => {
+            const session = renderer.xr.getSession();
+            if (session) {
+                // Add squeeze event listeners for hand tracking and controller gestures
+                session.addEventListener('squeezestart', (event) => {
+                    const squeezeEvent = {
+                        inputSource: event.inputSource,
+                        frame: event.frame
+                    };
+                    this.onSqueezeStart.invoke(squeezeEvent);
+                });
+                session.addEventListener('squeeze', (event) => {
+                    const squeezeEvent = {
+                        inputSource: event.inputSource,
+                        frame: event.frame,
+                        success: true
+                    };
+                    this.onSqueeze.invoke(squeezeEvent);
+                    // Note: squeeze completion doesn't need additional InputManager forwarding
+                    // The press is already handled in squeezestart
+                });
+                session.addEventListener('squeezeend', (event) => {
+                    const squeezeEvent = {
+                        inputSource: event.inputSource,
+                        frame: event.frame,
+                        success: false
+                    };
+                    this.onSqueezeEnd.invoke(squeezeEvent);
+                });
+                // Add select event listeners for primary actions (trigger/tap)
+                session.addEventListener('selectstart', (event) => {
+                    const selectEvent = {
+                        inputSource: event.inputSource,
+                        frame: event.frame
+                    };
+                    this.onSelectStart.invoke(selectEvent);
+                });
+                session.addEventListener('select', (event) => {
+                    const selectEvent = {
+                        inputSource: event.inputSource,
+                        frame: event.frame,
+                        success: true
+                    };
+                    this.onSelect.invoke(selectEvent);
+                    // Note: select completion doesn't need additional InputManager forwarding
+                    // The press is already handled in selectstart
+                });
+                session.addEventListener('selectend', (event) => {
+                    const selectEvent = {
+                        inputSource: event.inputSource,
+                        frame: event.frame,
+                        success: false
+                    };
+                    this.onSelectEnd.invoke(selectEvent);
+                });
+            }
+        });
+        renderer.xr.addEventListener('sessionend', () => {
+            this.cleanup();
+        });
+    }
+    /**
+     * Create VR input devices for both controller indices
+     */
+    createVRDevices() {
+        if (!this.renderer) {
+            console.warn('[VRControllerManager] No renderer available for device creation');
+            return;
+        }
+        // Create devices for both controller indices (0 and 1)
+        for (let i = 0; i < 2; i++) {
+            const device = new VRInputDevice(i, this.world, this.renderer, this.options);
+            // Set up device event handlers
+            device.onControllerConnected.add((inputSource) => {
+                this.onControllerAdded.invoke({
+                    inputSource,
+                    device
+                });
+            });
+            device.onControllerDisconnected.add((inputSource) => {
+                this.onControllerRemoved.invoke(inputSource);
+            });
+            device.onControllerUpdated.add((inputSource) => {
+                // Process button and axis events from XR gamepad
+                this.processInputEvents(inputSource);
+                // Fire update delegate
+                this.onControllerUpdated.invoke(inputSource, device);
+            });
+            this.devices[i] = device;
+        }
+    }
+    /**
+     * Update all controllers (call this every frame)
+     */
+    updateControllers() {
+        if (!this.renderer)
+            return;
+        const session = this.renderer.xr.getSession();
+        if (!session)
+            return;
+        // Update all devices
+        this.devices.forEach((device) => {
+            device.update();
+        });
+        // Allow device handlers to run per-frame hooks (e.g., fingertip collider updates)
+        this.devices.forEach((device) => {
+            const handler = device.currentHandler;
+            if (handler && typeof handler.update === 'function') {
+                handler.update();
+            }
+        });
+    }
+    /**
+     * Get device by handedness
+     */
+    getDeviceByHandedness(handedness) {
+        for (const device of this.devices) {
+            if (device.getHandedness() === handedness) {
+                return device;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get Three.js target ray group by handedness (for pointing/raycasting)
+     */
+    getTargetRayGroup(handedness) {
+        const device = this.getDeviceByHandedness(handedness);
+        return device?.getTargetRayGroup() ?? null;
+    }
+    /**
+     * Get Three.js controller grip group by handedness
+     */
+    getControllerGripGroup(handedness) {
+        const device = this.getDeviceByHandedness(handedness);
+        return device?.getGripGroup() ?? null;
+    }
+    /**
+     * Get target ray pose directly from input source (extracted from group)
+     */
+    getTargetRayPose(inputSource) {
+        const device = this.getDeviceByInputSource(inputSource);
+        return device?.getTargetRayPose() ?? null;
+    }
+    /**
+     * Get grip pose directly from input source (extracted from group)
+     */
+    getGripPose(inputSource) {
+        const device = this.getDeviceByInputSource(inputSource);
+        return device?.getGripPose() ?? null;
+    }
+    /**
+     * Get device by input source
+     */
+    getDeviceByInputSource(inputSource) {
+        for (const device of this.devices) {
+            if (device.getInputSource() === inputSource) {
+                return device;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get all active controllers
+     */
+    getControllers() {
+        const controllers = [];
+        this.devices.forEach((device) => {
+            const inputSource = device.getInputSource();
+            if (inputSource) {
+                controllers.push({
+                    inputSource,
+                    device
+                });
+            }
+        });
+        return controllers;
+    }
+    /**
+     * Get controller by handedness
+     */
+    getControllerByHand(handedness) {
+        const device = this.getDeviceByHandedness(handedness);
+        if (device) {
+            const inputSource = device.getInputSource();
+            if (inputSource) {
+                return {
+                    inputSource,
+                    device
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Cleanup all controllers
+     */
+    cleanup() {
+        this.devices.forEach((device) => {
+            device.dispose();
+        });
+        this.devices = [];
+        this.previousButtonStates.clear();
+        this.previousAxisStates.clear();
+    }
+    /**
+     * Process button and axis events for an XR input source
+     */
+    processInputEvents(inputSource) {
+        // Only process if we have a gamepad
+        if (!inputSource.gamepad)
+            return;
+        const gamepad = inputSource.gamepad;
+        // Process button events
+        this.processButtonChanges(inputSource, gamepad);
+        // Process axis events (thumbsticks, touchpads)
+        this.processAxisChanges(inputSource, gamepad);
+    }
+    /**
+     * Process button changes for an XR input source
+     */
+    processButtonChanges(inputSource, gamepad) {
+        let prevButtonStates = this.previousButtonStates.get(inputSource);
+        // Initialize previous states if this is the first frame
+        if (!prevButtonStates) {
+            prevButtonStates = new Map();
+            this.previousButtonStates.set(inputSource, prevButtonStates);
+        }
+        // Process each button according to the xr-standard mapping
+        for (let i = 0; i < gamepad.buttons.length; i++) {
+            const button = gamepad.buttons[i];
+            const currentState = {
+                pressed: button.pressed,
+                touched: button.touched,
+                value: button.value
+            };
+            const prevState = prevButtonStates.get(i) ?? { pressed: false, touched: false, value: 0 };
+            // Check for button down events
+            if (currentState.pressed && !prevState.pressed) {
+                const event = {
+                    inputSource,
+                    button: INDEX_TO_XR_BUTTON[i],
+                    buttonState: currentState
+                };
+                this.onButtonDown.invoke(event);
+            }
+            // Check for button up events
+            if (!currentState.pressed && prevState.pressed) {
+                const event = {
+                    inputSource,
+                    button: INDEX_TO_XR_BUTTON[i],
+                    buttonState: currentState
+                };
+                this.onButtonUp.invoke(event);
+            }
+            // Check for value changes (for analog buttons like triggers)
+            if (Math.abs(currentState.value - prevState.value) > 0.001) {
+                const event = {
+                    inputSource,
+                    button: INDEX_TO_XR_BUTTON[i],
+                    buttonState: currentState
+                };
+                this.onButtonValueChanged.invoke(event);
+            }
+            // Update previous state
+            prevButtonStates.set(i, currentState);
+        }
+    }
+    /**
+     * Process axis changes for an XR input source (thumbsticks, touchpads)
+     */
+    processAxisChanges(inputSource, gamepad) {
+        let prevAxisStates = this.previousAxisStates.get(inputSource);
+        // Initialize previous states if this is the first frame
+        if (!prevAxisStates) {
+            prevAxisStates = new Map();
+            this.previousAxisStates.set(inputSource, prevAxisStates);
+        }
+        // Process each axis (thumbsticks and touchpads)
+        for (let i = 0; i < gamepad.axes.length; i++) {
+            const currentValue = gamepad.axes[i];
+            const prevValue = prevAxisStates.get(i) ?? 0;
+            // Check for significant axis changes (with deadzone)
+            if (Math.abs(currentValue - prevValue) > 0.01) {
+                const event = {
+                    inputSource,
+                    axis: INDEX_TO_XR_AXIS[i],
+                    axisValue: currentValue,
+                    previousValue: prevValue
+                };
+                this.onAxisChanged.invoke(event);
+                // Update previous state
+                prevAxisStates.set(i, currentValue);
+            }
+        }
+    }
+    /**
+     * Enable or disable ray visualization for all devices
+     */
+    setRayVisualizationEnabled(enabled) {
+        this.options.rayVisualizationEnabled = enabled;
+        this.devices.forEach((device) => {
+            device.setRayVisualizationEnabled(enabled);
+        });
+    }
+    /**
+     * Check if ray visualization is enabled
+     */
+    isRayVisualizationEnabled() {
+        return this.options.rayVisualizationEnabled;
+    }
+    /**
+     * Set controller model visibility by handedness (only affects motion controllers, not hands)
+     */
+    setControllerVisible(handedness, visible) {
+        const device = this.getDeviceByHandedness(handedness);
+        if (device) {
+            device.setControllerVisible(visible);
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVlJDb250cm9sbGVyTWFuYWdlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy94ci9WUkNvbnRyb2xsZXJNYW5hZ2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7Ozs7OztHQWNHO0FBR0gsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBRWhELE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQWlCbkQsTUFBTSxDQUFOLElBQVksUUFTWDtBQVRELFdBQVksUUFBUTtJQUNsQixpRUFBaUU7SUFDakUsK0JBQW1CLENBQUE7SUFDbkIsd0NBQXdDO0lBQ3hDLCtCQUFtQixDQUFBO0lBQ25CLGtDQUFrQztJQUNsQyxpQ0FBcUIsQ0FBQTtJQUNyQixvQ0FBb0M7SUFDcEMscUNBQXlCLENBQUE7QUFDM0IsQ0FBQyxFQVRXLFFBQVEsS0FBUixRQUFRLFFBU25CO0FBRUQsTUFBTSxDQUFOLElBQVksTUFLWDtBQUxELFdBQVksTUFBTTtJQUNoQixpQ0FBdUIsQ0FBQTtJQUN2QixpQ0FBdUIsQ0FBQTtJQUN2QixxQ0FBMkIsQ0FBQTtJQUMzQixxQ0FBMkIsQ0FBQTtBQUM3QixDQUFDLEVBTFcsTUFBTSxLQUFOLE1BQU0sUUFLakI7QUFHRDs7O0dBR0c7QUFDSCx3REFBd0Q7QUFDeEQsTUFBTSxrQkFBa0IsR0FBNkI7SUFDbkQsQ0FBQyxRQUFRLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztJQUNyQixDQUFDLFFBQVEsQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDO0lBQ3JCLENBQUMsUUFBUSxDQUFDLFFBQVEsQ0FBQyxFQUFFLENBQUM7SUFDdEIsQ0FBQyxRQUFRLENBQUMsVUFBVSxDQUFDLEVBQUUsQ0FBQztDQUN6QixDQUFDO0FBRUYsTUFBTSxrQkFBa0IsR0FBNkI7SUFDbkQsQ0FBQyxFQUFFLFFBQVEsQ0FBQyxPQUFPO0lBQ25CLENBQUMsRUFBRSxRQUFRLENBQUMs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

package/dist/src/xr/VRDeviceHandler.d.ts

@@ -0,0 +1,47 @@
+/**
+ * VRDeviceHandler - Abstract base class for VR device-specific logic
+ *
+ * This provides a clean abstraction for handling controller vs hand-specific functionality
+ * without any branching logic in the concrete implementations.
+ */
+import type { World } from '../game/World.js';
+import type * as THREE from 'three';
+export declare abstract class VRDeviceHandler {
+    protected inputSource: XRInputSource;
+    protected renderer: THREE.WebGLRenderer;
+    protected world: World;
+    protected controllerIndex: number;
+    constructor(inputSource: XRInputSource, renderer: THREE.WebGLRenderer, world: World, controllerIndex: number);
+    /**
+     * Get the input source
+     */
+    getInputSource(): XRInputSource;
+    /**
+     * Get handedness of this device
+     */
+    getHandedness(): 'left' | 'right' | 'none';
+    /**
+     * Get controller index
+     */
+    getControllerIndex(): number;
+    /**
+     * Get the Three.js target ray group (for pointing/raycasting)
+     */
+    abstract getTargetRayGroup(): THREE.Group | null;
+    /**
+     * Get the Three.js grip group (for object attachment)
+     */
+    abstract getGripGroup(): THREE.Group | null;
+    /**
+     * Create and setup the visual model for this device
+     */
+    abstract createVisualModel(): void;
+    /**
+     * Clean up resources and dispose of visual models
+     */
+    abstract dispose(): void;
+    /**
+     * Per-frame update hook. Default no-op.
+     */
+    update(_deltaTime?: number): void;
+}

package/dist/src/xr/VRDeviceHandler.js

@@ -0,0 +1,61 @@
+/**
+ * VRDeviceHandler - Abstract base class for VR device-specific logic
+ *
+ * This provides a clean abstraction for handling controller vs hand-specific functionality
+ * without any branching logic in the concrete implementations.
+ */
+export class VRDeviceHandler {
+    constructor(inputSource, renderer, world, controllerIndex) {
+        Object.defineProperty(this, "inputSource", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "renderer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "world", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "controllerIndex", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.inputSource = inputSource;
+        this.renderer = renderer;
+        this.world = world;
+        this.controllerIndex = controllerIndex;
+    }
+    /**
+     * Get the input source
+     */
+    getInputSource() {
+        return this.inputSource;
+    }
+    /**
+     * Get handedness of this device
+     */
+    getHandedness() {
+        return this.inputSource.handedness;
+    }
+    /**
+     * Get controller index
+     */
+    getControllerIndex() {
+        return this.controllerIndex;
+    }
+    /**
+     * Per-frame update hook. Default no-op.
+     */
+    update(_deltaTime) { }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVlJEZXZpY2VIYW5kbGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3hyL1ZSRGV2aWNlSGFuZGxlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7R0FLRztBQU1ILE1BQU0sT0FBZ0IsZUFBZTtJQU1uQyxZQUNFLFdBQTBCLEVBQzFCLFFBQTZCLEVBQzdCLEtBQVksRUFDWixlQUF1QjtRQVRmOzs7OztXQUEyQjtRQUMzQjs7Ozs7V0FBOEI7UUFDOUI7Ozs7O1dBQWE7UUFDYjs7Ozs7V0FBd0I7UUFRaEMsSUFBSSxDQUFDLFdBQVcsR0FBRyxXQUFXLENBQUM7UUFDL0IsSUFBSSxDQUFDLFFBQVEsR0FBRyxRQUFRLENBQUM7UUFDekIsSUFBSSxDQUFDLEtBQUssR0FBRyxLQUFLLENBQUM7UUFDbkIsSUFBSSxDQUFDLGVBQWUsR0FBRyxlQUFlLENBQUM7SUFDekMsQ0FBQztJQUVEOztPQUVHO0lBQ0ksY0FBYztRQUNuQixPQUFPLElBQUksQ0FBQyxXQUFXLENBQUM7SUFDMUIsQ0FBQztJQUVEOztPQUVHO0lBQ0ksYUFBYTtRQUNsQixPQUFPLElBQUksQ0FBQyxXQUFXLENBQUMsVUFBdUMsQ0FBQztJQUNsRSxDQUFDO0lBRUQ7O09BRUc7SUFDSSxrQkFBa0I7UUFDdkIsT0FBTyxJQUFJLENBQUMsZUFBZSxDQUFDO0lBQzlCLENBQUM7SUF3QkQ7O09BRUc7SUFDSSxNQUFNLENBQUMsVUFBbUIsSUFBaUMsQ0FBQztDQUNwRSJ9