@iwsdk/core 0.1.0

package/dist/grab/grab-system.d.ts

@@ -0,0 +1,320 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+declare const GrabSystem_base: import("elics").SystemConstructor<import("elics").SystemSchema, {
+    oneHandGrabbables: {
+        required: import("elics").Component<{
+            rotate: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            rotateMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            rotateMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            translate: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            translateMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            translateMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+        }>[];
+    };
+    twoHandsGrabbables: {
+        required: import("elics").Component<{
+            rotate: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            rotateMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            rotateMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            translate: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            translateMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            translateMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            scale: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            scaleMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            scaleMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+        }>[];
+    };
+    distanceGrabbables: {
+        required: import("elics").Component<{
+            rotate: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            rotateMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            rotateMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            translate: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            translateMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            translateMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            scale: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            scaleMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            scaleMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            movementMode: {
+                type: import("elics/lib/types.js").Types.Enum;
+                enum: {
+                    MoveFromTarget: string;
+                    MoveTowardsTarget: string;
+                    MoveAtSource: string;
+                    RotateAtSource: string;
+                };
+                default: string;
+            };
+            returnToOrigin: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: false;
+            };
+            moveSpeed: {
+                type: import("elics/lib/types.js").Types.Float32;
+                default: number;
+            };
+        }>[];
+    };
+    handles: {
+        required: import("elics").Component<{
+            instance: {
+                type: import("elics/lib/types.js").Types.Object;
+                default: undefined;
+            };
+        }>[];
+    };
+}, import("../ecs/world.js").World, import("../ecs/system.js").System<import("elics").SystemSchema, {
+    oneHandGrabbables: {
+        required: import("elics").Component<{
+            rotate: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            rotateMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            rotateMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            translate: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            translateMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            translateMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+        }>[];
+    };
+    twoHandsGrabbables: {
+        required: import("elics").Component<{
+            rotate: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            rotateMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            rotateMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            translate: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            translateMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            translateMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            scale: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            scaleMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            scaleMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+        }>[];
+    };
+    distanceGrabbables: {
+        required: import("elics").Component<{
+            rotate: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            rotateMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            rotateMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            translate: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            translateMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            translateMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            scale: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: true;
+            };
+            scaleMax: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            scaleMin: {
+                type: import("elics/lib/types.js").Types.Vec3;
+                default: [number, number, number];
+            };
+            movementMode: {
+                type: import("elics/lib/types.js").Types.Enum;
+                enum: {
+                    MoveFromTarget: string;
+                    MoveTowardsTarget: string;
+                    MoveAtSource: string;
+                    RotateAtSource: string;
+                };
+                default: string;
+            };
+            returnToOrigin: {
+                type: import("elics/lib/types.js").Types.Boolean;
+                default: false;
+            };
+            moveSpeed: {
+                type: import("elics/lib/types.js").Types.Float32;
+                default: number;
+            };
+        }>[];
+    };
+    handles: {
+        required: import("elics").Component<{
+            instance: {
+                type: import("elics/lib/types.js").Types.Object;
+                default: undefined;
+            };
+        }>[];
+    };
+}>>;
+/**
+ * Manages interactive object grabbing and manipulation for VR/AR experiences.
+ *
+ * @remarks
+ * - Uses the `@pmndrs/handle` library for precise multitouch manipulation.
+ * - Automatically creates handle instances for entities with grabbable components.
+ * - Supports three types of grab interactions: one‑hand, two‑hand, and distance grabbing.
+ * - Automatically cleans up handle instances when grabbable components are removed.
+ *
+ * @example Basic grab system setup
+ * ```ts
+ * // Add to your world to enable grab interactions
+ * world.addSystem(GrabSystem)
+ *
+ * // Create a grabbable box
+ * const box = world.createEntity()
+ * box.addComponent(OneHandGrabbable, {})
+ * ```
+ *
+ * @example Two‑handed manipulation
+ * ```ts
+ * // Create an object that can be scaled with two hands
+ * const sculpture = world.createEntity()
+ * sculpture.addComponent(TwoHandsGrabbable, {
+ *   scaleMin: [0.5, 0.5, 0.5],
+ *   scaleMax: [3, 3, 3]
+ * })
+ * ```
+ *
+ * @category Grab
+ * @see {@link OneHandGrabbable}
+ * @see {@link TwoHandsGrabbable}
+ * @see {@link DistanceGrabbable}
+ */
+export declare class GrabSystem extends GrabSystem_base {
+    init(): void;
+    update(delta: number): void;
+    private initializeOneHandHandle;
+    private initializeTwoHandsHandle;
+    private initializeDistanceHandle;
+}
+export {};
+//# sourceMappingURL=grab-system.d.ts.map

package/dist/grab/grab-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grab-system.d.ts","sourceRoot":"","sources":["../../src/grab/grab-system.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,UAAW,SAAQ,eAa9B;IACA,IAAI;IAgDJ,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAY3B,OAAO,CAAC,uBAAuB;IAgC/B,OAAO,CAAC,wBAAwB;IA+ChC,OAAO,CAAC,wBAAwB;CA8DjC"}

package/dist/grab/grab-system.js

@@ -0,0 +1,239 @@
+import { HandleStore } from '@pmndrs/handle';
+import { createSystem } from '../ecs/system.js';
+import '../ecs/world.js';
+import 'elics';
+import '../ecs/component-registry.js';
+import '../runtime/three.js';
+import { DistanceGrabbable } from './distance-grabbable.js';
+import { Handle, DistanceGrabHandle, MovementMode } from './handles.js';
+import { OneHandGrabbable } from './one-hand-grabbable.js';
+import { TwoHandsGrabbable } from './two-hands-grabbable.js';
+import { Object3D } from 'three';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Manages interactive object grabbing and manipulation for VR/AR experiences.
+ *
+ * @remarks
+ * - Uses the `@pmndrs/handle` library for precise multitouch manipulation.
+ * - Automatically creates handle instances for entities with grabbable components.
+ * - Supports three types of grab interactions: one‑hand, two‑hand, and distance grabbing.
+ * - Automatically cleans up handle instances when grabbable components are removed.
+ *
+ * @example Basic grab system setup
+ * ```ts
+ * // Add to your world to enable grab interactions
+ * world.addSystem(GrabSystem)
+ *
+ * // Create a grabbable box
+ * const box = world.createEntity()
+ * box.addComponent(OneHandGrabbable, {})
+ * ```
+ *
+ * @example Two‑handed manipulation
+ * ```ts
+ * // Create an object that can be scaled with two hands
+ * const sculpture = world.createEntity()
+ * sculpture.addComponent(TwoHandsGrabbable, {
+ *   scaleMin: [0.5, 0.5, 0.5],
+ *   scaleMax: [3, 3, 3]
+ * })
+ * ```
+ *
+ * @category Grab
+ * @see {@link OneHandGrabbable}
+ * @see {@link TwoHandsGrabbable}
+ * @see {@link DistanceGrabbable}
+ */
+class GrabSystem extends createSystem({
+    oneHandGrabbables: {
+        required: [OneHandGrabbable],
+    },
+    twoHandsGrabbables: {
+        required: [TwoHandsGrabbable],
+    },
+    distanceGrabbables: {
+        required: [DistanceGrabbable],
+    },
+    handles: {
+        required: [Handle],
+    },
+}) {
+    init() {
+        // Ensure Handle component is registered in the world before queries rely on it
+        if (!Handle.bitmask) {
+            this.world.registerComponent(Handle);
+        }
+        // Reactive handle creation per grabbable type
+        this.queries.oneHandGrabbables.subscribe('qualify', (entity) => {
+            this.initializeOneHandHandle(entity);
+        });
+        this.queries.twoHandsGrabbables.subscribe('qualify', (entity) => {
+            this.initializeTwoHandsHandle(entity);
+        });
+        this.queries.distanceGrabbables.subscribe('qualify', (entity) => {
+            this.initializeDistanceHandle(entity);
+        });
+        // Unified cleanup for any handle
+        this.queries.handles.subscribe('disqualify', (entity) => {
+            const h = Handle.data.instance[entity.index];
+            if (h) {
+                try {
+                    h.cancel();
+                }
+                catch (_a) { }
+            }
+            if (entity.object3D) {
+                entity.object3D.pointerEventsType = 'all';
+            }
+        });
+        // Initial pass for already-eligible entities (qualify doesn't fire retroactively)
+        this.queries.oneHandGrabbables.entities.forEach((e) => this.initializeOneHandHandle(e));
+        this.queries.twoHandsGrabbables.entities.forEach((e) => this.initializeTwoHandsHandle(e));
+        this.queries.distanceGrabbables.entities.forEach((e) => this.initializeDistanceHandle(e));
+        // Enable grab sub-pointer per hand when GrabSystem is active
+        this.input.multiPointers.left.toggleSubPointer('grab', true);
+        this.input.multiPointers.right.toggleSubPointer('grab', true);
+    }
+    update(delta) {
+        // Unified handle updates
+        this.queries.handles.entities.forEach((entity) => {
+            const h = Handle.data.instance[entity.index];
+            if (h) {
+                h.update(delta);
+            }
+        });
+    }
+    initializeOneHandHandle(entity) {
+        if (entity.hasComponent(Handle))
+            return;
+        const object = entity.object3D;
+        if (!(object instanceof Object3D))
+            return;
+        const obj = object;
+        const rotateMax = entity.getVectorView(OneHandGrabbable, 'rotateMax');
+        const rotateMin = entity.getVectorView(OneHandGrabbable, 'rotateMin');
+        const translateMax = entity.getVectorView(OneHandGrabbable, 'translateMax');
+        const translateMin = entity.getVectorView(OneHandGrabbable, 'translateMin');
+        const handle = new HandleStore(obj, () => ({
+            rotate: entity.getValue(OneHandGrabbable, 'rotate')
+                ? {
+                    x: [rotateMin[0], rotateMax[0]],
+                    y: [rotateMin[1], rotateMax[1]],
+                    z: [rotateMin[2], rotateMax[2]],
+                }
+                : false,
+            translate: entity.getValue(OneHandGrabbable, 'translate')
+                ? {
+                    x: [translateMin[0], translateMax[0]],
+                    y: [translateMin[1], translateMax[1]],
+                    z: [translateMin[2], translateMax[2]],
+                }
+                : false,
+            projectRays: false,
+            multitouch: false,
+        }));
+        handle.bind(obj);
+        obj.pointerEventsType = { deny: 'ray' };
+        entity.addComponent(Handle, { instance: handle });
+    }
+    initializeTwoHandsHandle(entity) {
+        if (entity.hasComponent(Handle))
+            return;
+        const object = entity.object3D;
+        if (!(object instanceof Object3D))
+            return;
+        const obj = object;
+        const rotateMax = entity.getVectorView(TwoHandsGrabbable, 'rotateMax');
+        const rotateMin = entity.getVectorView(TwoHandsGrabbable, 'rotateMin');
+        const translateMax = entity.getVectorView(TwoHandsGrabbable, 'translateMax');
+        const translateMin = entity.getVectorView(TwoHandsGrabbable, 'translateMin');
+        const scaleMax = entity.getVectorView(TwoHandsGrabbable, 'scaleMax');
+        const scaleMin = entity.getVectorView(TwoHandsGrabbable, 'scaleMin');
+        const handle = new HandleStore(obj, () => ({
+            rotate: entity.getValue(TwoHandsGrabbable, 'rotate')
+                ? {
+                    x: [rotateMin[0], rotateMax[0]],
+                    y: [rotateMin[1], rotateMax[1]],
+                    z: [rotateMin[2], rotateMax[2]],
+                }
+                : false,
+            translate: entity.getValue(TwoHandsGrabbable, 'translate')
+                ? {
+                    x: [translateMin[0], translateMax[0]],
+                    y: [translateMin[1], translateMax[1]],
+                    z: [translateMin[2], translateMax[2]],
+                }
+                : false,
+            scale: entity.getValue(TwoHandsGrabbable, 'scale')
+                ? {
+                    x: [scaleMin[0], scaleMax[0]],
+                    y: [scaleMin[1], scaleMax[1]],
+                    z: [scaleMin[2], scaleMax[2]],
+                }
+                : false,
+            projectRays: false,
+            multitouch: true,
+        }));
+        handle.bind(obj);
+        obj.pointerEventsType = { deny: 'ray' };
+        entity.addComponent(Handle, { instance: handle });
+    }
+    initializeDistanceHandle(entity) {
+        var _a;
+        if (entity.hasComponent(Handle))
+            return;
+        const object = entity.object3D;
+        if (!(object instanceof Object3D))
+            return;
+        const obj = object;
+        const rotateMax = entity.getVectorView(DistanceGrabbable, 'rotateMax');
+        const rotateMin = entity.getVectorView(DistanceGrabbable, 'rotateMin');
+        const translateMax = entity.getVectorView(DistanceGrabbable, 'translateMax');
+        const translateMin = entity.getVectorView(DistanceGrabbable, 'translateMin');
+        const scaleMax = entity.getVectorView(DistanceGrabbable, 'scaleMax');
+        const scaleMin = entity.getVectorView(DistanceGrabbable, 'scaleMin');
+        const movementMode = entity.getValue(DistanceGrabbable, 'movementMode');
+        const returnToOrigin = Boolean(entity.getValue(DistanceGrabbable, 'returnToOrigin'));
+        const opts = () => ({
+            rotate: entity.getValue(DistanceGrabbable, 'rotate')
+                ? {
+                    x: [rotateMin[0], rotateMax[0]],
+                    y: [rotateMin[1], rotateMax[1]],
+                    z: [rotateMin[2], rotateMax[2]],
+                }
+                : false,
+            translate: movementMode === MovementMode.RotateAtSource
+                ? 'as-rotate'
+                : entity.getValue(DistanceGrabbable, 'translate')
+                    ? {
+                        x: [translateMin[0], translateMax[0]],
+                        y: [translateMin[1], translateMax[1]],
+                        z: [translateMin[2], translateMax[2]],
+                    }
+                    : false,
+            scale: movementMode === MovementMode.RotateAtSource
+                ? false
+                : entity.getValue(DistanceGrabbable, 'scale')
+                    ? {
+                        x: [scaleMin[0], scaleMax[0]],
+                        y: [scaleMin[1], scaleMax[1]],
+                        z: [scaleMin[2], scaleMax[2]],
+                    }
+                    : false,
+            projectRays: false,
+        });
+        const handle = new DistanceGrabHandle(obj, opts, movementMode, returnToOrigin, (_a = entity.getValue(DistanceGrabbable, 'moveSpeed')) !== null && _a !== void 0 ? _a : 0.1);
+        handle.bind(obj);
+        obj.pointerEventsType = { deny: 'grab' };
+        entity.addComponent(Handle, { instance: handle });
+    }
+}
+
+export { GrabSystem };
+//# sourceMappingURL=grab-system.js.map

package/dist/grab/grab-system.js.map

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

package/dist/grab/handles.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { HandleOptions, HandleStore } from '@pmndrs/handle';
+import { Types } from '../ecs/index.js';
+import { Object3D } from '../runtime/index.js';
+export declare const Handle: import("elics").Component<{
+    instance: {
+        type: Types.Object;
+        default: undefined;
+    };
+}>;
+/** MovementMode for {@link DistanceGrabbable}. @category Grab */
+export declare const MovementMode: {
+    /** Object smoothly moves with the ray cast end point of the grabbing controller. */
+    MoveFromTarget: string;
+    /** Object smoothly moves toward the input source that's grabbing. */
+    MoveTowardsTarget: string;
+    /** Object moves relative to controller delta movement while maintaining distance. */
+    MoveAtSource: string;
+    /** Object rotates in place without translation or scaling. */
+    RotateAtSource: string;
+};
+export declare class DistanceGrabHandle<T> extends HandleStore<T> {
+    readonly target_: Object3D | {
+        current?: Object3D | null;
+    };
+    readonly getOptions: () => HandleOptions<T>;
+    readonly movementMode: string;
+    readonly returnToOrigin: Boolean;
+    readonly moveSpeed: number;
+    private previousPointerOrigin;
+    private static _tmp;
+    constructor(target_: Object3D | {
+        current?: Object3D | null;
+    }, getOptions: (() => HandleOptions<T>) | undefined, movementMode: string, returnToOrigin: Boolean, moveSpeed?: number);
+    update(time: number): void;
+    protected apply(target: Object3D): T;
+}
+//# sourceMappingURL=handles.d.ts.map

package/dist/grab/handles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handles.d.ts","sourceRoot":"","sources":["../../src/grab/handles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAmB,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAW,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,MAAM;;;;;EAMlB,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,YAAY;IACvB,oFAAoF;;IAEpF,qEAAqE;;IAErE,qFAAqF;;IAErF,8DAA8D;;CAE/D,CAAC;AAEF,qBAAa,kBAAkB,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IAKrD,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG;QAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;KAAE;aAC1C,UAAU,EAAE,MAAM,aAAa,CAAC,CAAC,CAAC;aAClC,YAAY,EAAE,MAAM;aACpB,cAAc,EAAE,OAAO;aACvB,SAAS,EAAE,MAAM;IARnC,OAAO,CAAC,qBAAqB,CAAsB;IACnD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAiB;gBAGzB,OAAO,EAAE,QAAQ,GAAG;QAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;KAAE,EAC1C,UAAU,GAAE,MAAM,aAAa,CAAC,CAAC,CAAC,aAAa,EAC/C,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,OAAO,EACvB,SAAS,GAAE,MAAY;IAKzC,MAAM,CAAC,IAAI,EAAE,MAAM;IA6FnB,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,GAAG,CAAC;CAcrC"}