@react-three/rapier 1.5.0 → 2.0.0

package/dist/declarations/src/components/AnyCollider.d.ts

@@ -1,20 +1,20 @@
 import { Collider } from "@dimforge/rapier3d-compat";
-import React, { ReactNode } from "react";
-import { ColliderOptions, CuboidArgs, RoundCuboidArgs, BallArgs, CapsuleArgs, HeightfieldArgs, TrimeshArgs, ConeArgs, CylinderArgs, ConvexHullArgs, RoundCylinderArgs } from "../types.js";
-import { RoundConeArgs } from "../types.js";
+import React, { ReactNode, Ref } from "react";
+import { BallArgs, CapsuleArgs, ColliderOptions, ConeArgs, ConvexHullArgs, CuboidArgs, CylinderArgs, HeightfieldArgs, RoundConeArgs, RoundCuboidArgs, RoundCylinderArgs, TrimeshArgs } from "../types.js";
 export interface ColliderProps extends ColliderOptions<any> {
     children?: ReactNode;
+    ref?: Ref<Collider>;
 }
 /**
  * A collider is a shape that can be attached to a rigid body to define its physical properties.
  * @internal
  */
-export declare const AnyCollider: React.MemoExoticComponent<React.ForwardRefExoticComponent<ColliderProps & React.RefAttributes<Collider>>>;
-export declare type ColliderOptionsRequiredArgs<T extends unknown[]> = Omit<ColliderOptions<T>, "args"> & {
+export declare const AnyCollider: React.MemoExoticComponent<(props: ColliderProps) => import("react/jsx-runtime").JSX.Element>;
+export type ColliderOptionsRequiredArgs<T extends unknown[]> = Omit<ColliderOptions<T>, "args"> & {
     args: T;
     children?: ReactNode;
 };
-export declare type CuboidColliderProps = ColliderOptionsRequiredArgs<CuboidArgs>;
+export type CuboidColliderProps = ColliderOptionsRequiredArgs<CuboidArgs>;
 /**
  * A cuboid collider shape
  * @category Colliders
@@ -23,7 +23,7 @@ export declare const CuboidCollider: React.ForwardRefExoticComponent<Omit<Collid
     args: CuboidArgs;
     children?: ReactNode;
 } & React.RefAttributes<Collider>>;
-export declare type RoundCuboidColliderProps = ColliderOptionsRequiredArgs<RoundCuboidArgs>;
+export type RoundCuboidColliderProps = ColliderOptionsRequiredArgs<RoundCuboidArgs>;
 /**
  * A round cuboid collider shape
  * @category Colliders
@@ -32,7 +32,7 @@ export declare const RoundCuboidCollider: React.ForwardRefExoticComponent<Omit<C
     args: RoundCuboidArgs;
     children?: ReactNode;
 } & React.RefAttributes<Collider>>;
-export declare type BallColliderProps = ColliderOptionsRequiredArgs<BallArgs>;
+export type BallColliderProps = ColliderOptionsRequiredArgs<BallArgs>;
 /**
  * A ball collider shape
  * @category Colliders
@@ -41,7 +41,7 @@ export declare const BallCollider: React.ForwardRefExoticComponent<Omit<Collider
     args: BallArgs;
     children?: ReactNode;
 } & React.RefAttributes<Collider>>;
-export declare type CapsuleColliderProps = ColliderOptionsRequiredArgs<CapsuleArgs>;
+export type CapsuleColliderProps = ColliderOptionsRequiredArgs<CapsuleArgs>;
 /**
  * A capsule collider shape
  * @category Colliders
@@ -50,7 +50,7 @@ export declare const CapsuleCollider: React.ForwardRefExoticComponent<Omit<Colli
     args: CapsuleArgs;
     children?: ReactNode;
 } & React.RefAttributes<Collider>>;
-export declare type HeightfieldColliderProps = ColliderOptionsRequiredArgs<HeightfieldArgs>;
+export type HeightfieldColliderProps = ColliderOptionsRequiredArgs<HeightfieldArgs>;
 /**
  * A heightfield collider shape
  * @category Colliders
@@ -59,7 +59,7 @@ export declare const HeightfieldCollider: React.ForwardRefExoticComponent<Omit<C
     args: HeightfieldArgs;
     children?: ReactNode;
 } & React.RefAttributes<Collider>>;
-export declare type TrimeshColliderProps = ColliderOptionsRequiredArgs<TrimeshArgs>;
+export type TrimeshColliderProps = ColliderOptionsRequiredArgs<TrimeshArgs>;
 /**
  * A trimesh collider shape
  * @category Colliders
@@ -68,7 +68,7 @@ export declare const TrimeshCollider: React.ForwardRefExoticComponent<Omit<Colli
     args: TrimeshArgs;
     children?: ReactNode;
 } & React.RefAttributes<Collider>>;
-export declare type ConeColliderProps = ColliderOptionsRequiredArgs<ConeArgs>;
+export type ConeColliderProps = ColliderOptionsRequiredArgs<ConeArgs>;
 /**
  * A cone collider shape
  * @category Colliders
@@ -77,7 +77,7 @@ export declare const ConeCollider: React.ForwardRefExoticComponent<Omit<Collider
     args: ConeArgs;
     children?: ReactNode;
 } & React.RefAttributes<Collider>>;
-export declare type RoundConeColliderProps = ColliderOptionsRequiredArgs<RoundConeArgs>;
+export type RoundConeColliderProps = ColliderOptionsRequiredArgs<RoundConeArgs>;
 /**
  * A round cylinder collider shape
  * @category Colliders
@@ -86,7 +86,7 @@ export declare const RoundConeCollider: React.ForwardRefExoticComponent<Omit<Col
     args: RoundConeArgs;
     children?: ReactNode;
 } & React.RefAttributes<Collider>>;
-export declare type CylinderColliderProps = ColliderOptionsRequiredArgs<CylinderArgs>;
+export type CylinderColliderProps = ColliderOptionsRequiredArgs<CylinderArgs>;
 /**
  * A cylinder collider shape
  * @category Colliders
@@ -95,7 +95,7 @@ export declare const CylinderCollider: React.ForwardRefExoticComponent<Omit<Coll
     args: CylinderArgs;
     children?: ReactNode;
 } & React.RefAttributes<Collider>>;
-export declare type RoundCylinderColliderProps = ColliderOptionsRequiredArgs<RoundCylinderArgs>;
+export type RoundCylinderColliderProps = ColliderOptionsRequiredArgs<RoundCylinderArgs>;
 /**
  * A round cylinder collider shape
  * @category Colliders
@@ -104,7 +104,7 @@ export declare const RoundCylinderCollider: React.ForwardRefExoticComponent<Omit
     args: RoundConeArgs;
     children?: ReactNode;
 } & React.RefAttributes<Collider>>;
-export declare type ConvexHullColliderProps = ColliderOptionsRequiredArgs<ConvexHullArgs>;
+export type ConvexHullColliderProps = ColliderOptionsRequiredArgs<ConvexHullArgs>;
 /**
  * A convex hull collider shape
  * @category Colliders

package/dist/declarations/src/components/InstancedRigidBodies.d.ts

@@ -1,12 +1,13 @@
 import React, { ReactNode } from "react";
-import { RigidBodyProps } from "./RigidBody.js";
 import { RapierRigidBody } from "../types.js";
-export declare type InstancedRigidBodyProps = RigidBodyProps & {
+import { RigidBodyProps } from "./RigidBody.js";
+export type InstancedRigidBodyProps = RigidBodyProps & {
     key: string | number;
 };
-export interface InstancedRigidBodiesProps extends RigidBodyProps {
+export interface InstancedRigidBodiesProps extends Omit<RigidBodyProps, "ref"> {
     instances: InstancedRigidBodyProps[];
     colliderNodes?: ReactNode[];
     children: ReactNode;
+    ref?: React.Ref<(RapierRigidBody | null)[] | null>;
 }
-export declare const InstancedRigidBodies: React.MemoExoticComponent<React.ForwardRefExoticComponent<InstancedRigidBodiesProps & React.RefAttributes<(RapierRigidBody | null)[] | null>>>;
+export declare const InstancedRigidBodies: React.MemoExoticComponent<({ ref, ...props }: InstancedRigidBodiesProps) => import("react/jsx-runtime").JSX.Element>;

package/dist/declarations/src/components/Physics.d.ts

@@ -16,9 +16,9 @@ export interface RigidBodyState {
     scale: Vector3;
     isSleeping: boolean;
 }
-export declare type RigidBodyStateMap = Map<RigidBody["handle"], RigidBodyState>;
-export declare type WorldStepCallback = (world: World) => void;
-export declare type WorldStepCallbackSet = Set<{
+export type RigidBodyStateMap = Map<RigidBody["handle"], RigidBodyState>;
+export type WorldStepCallback = (world: World) => void;
+export type WorldStepCallbackSet = Set<{
     current: WorldStepCallback;
 }>;
 export interface ColliderState {
@@ -30,7 +30,7 @@ export interface ColliderState {
      */
     worldParent?: Object3D;
 }
-export declare type ColliderStateMap = Map<Collider["handle"], ColliderState>;
+export type ColliderStateMap = Map<Collider["handle"], ColliderState>;
 export interface RapierContext {
     /**
      * Used by the world to keep track of RigidBody states
@@ -131,7 +131,7 @@ export interface RapierContext {
     isDebug: boolean;
 }
 export declare const rapierContext: React.Context<RapierContext | undefined>;
-export declare type EventMapValue = {
+export type EventMapValue = {
     onSleep?(): void;
     onWake?(): void;
     onCollisionEnter?: CollisionEnterHandler;
@@ -140,7 +140,7 @@ export declare type EventMapValue = {
     onIntersectionExit?: IntersectionExitHandler;
     onContactForce?: ContactForceHandler;
 };
-export declare type EventMap = Map<ColliderHandle | RigidBodyHandle, EventMapValue>;
+export type EventMap = Map<ColliderHandle | RigidBodyHandle, EventMapValue>;
 export interface PhysicsProps {
     children: ReactNode;
     /**

package/dist/declarations/src/components/RigidBody.d.ts

@@ -1,22 +1,20 @@
-import React, { MutableRefObject, RefObject } from "react";
-import { ReactNode } from "react";
+import React, { ReactNode, Ref, RefObject } from "react";
 import { Object3D } from "three";
 import { RapierRigidBody, RigidBodyOptions } from "../types.js";
-export declare const RigidBodyContext: React.Context<{
-    ref: RefObject<Object3D> | MutableRefObject<Object3D>;
-    getRigidBody: () => RapierRigidBody;
-    options: RigidBodyOptions;
-}>;
-export declare const useRigidBodyContext: () => {
-    ref: RefObject<Object3D> | MutableRefObject<Object3D>;
+type RigidBodyContextType = {
+    ref: RefObject<Object3D>;
     getRigidBody: () => RapierRigidBody;
     options: RigidBodyOptions;
 };
+export declare const RigidBodyContext: React.Context<RigidBodyContextType>;
+export declare const useRigidBodyContext: () => RigidBodyContextType;
 export interface RigidBodyProps extends RigidBodyOptions {
     children?: ReactNode;
+    ref?: Ref<RapierRigidBody>;
 }
 /**
  * A rigid body is a physical object that can be simulated by the physics engine.
  * @category Components
  */
-export declare const RigidBody: React.MemoExoticComponent<React.ForwardRefExoticComponent<RigidBodyProps & React.RefAttributes<RapierRigidBody>>>;
+export declare const RigidBody: React.MemoExoticComponent<(props: RigidBodyProps) => import("react/jsx-runtime").JSX.Element>;
+export {};

package/dist/declarations/src/hooks/hooks.d.ts

@@ -1,4 +1,4 @@
-import React, { MutableRefObject } from "react";
+import { RefObject } from "react";
 import { RapierContext, WorldStepCallback } from "../components/Physics.js";
 import { Object3D } from "three";
 import { ColliderProps, RigidBodyProps } from "../index.js";
@@ -20,4 +20,4 @@ export declare const useAfterPhysicsStep: (callback: WorldStepCallback) => void;
 /**
  * @internal
  */
-export declare const useChildColliderProps: <O extends Object3D<import("three").Object3DEventMap>>(ref: React.MutableRefObject<O | null | undefined>, options: RigidBodyProps, ignoreMeshColliders?: boolean) => ColliderProps[];
+export declare const useChildColliderProps: <O extends Object3D>(ref: RefObject<O | undefined | null>, options: RigidBodyProps, ignoreMeshColliders?: boolean) => ColliderProps[];

package/dist/declarations/src/hooks/joints.d.ts

@@ -5,7 +5,7 @@ import type Rapier from "@dimforge/rapier3d-compat";
 /**
  * @internal
  */
-export declare const useImpulseJoint: <JointType extends ImpulseJoint>(body1: RefObject<RapierRigidBody>, body2: RefObject<RapierRigidBody>, params: Rapier.JointData) => import("react").MutableRefObject<JointType | undefined>;
+export declare const useImpulseJoint: <JointType extends ImpulseJoint>(body1: RefObject<RapierRigidBody>, body2: RefObject<RapierRigidBody>, params: Rapier.JointData) => RefObject<JointType | undefined>;
 /**
  * A fixed joint ensures that two rigid-bodies don't move relative to each other.
  * Fixed joints are characterized by one local frame (represented by an isometry) on each rigid-body.

package/dist/declarations/src/types.d.ts

@@ -1,23 +1,23 @@
-import { MutableRefObject, RefObject } from "react";
+import { RefObject } from "react";
 import { ActiveCollisionTypes, CoefficientCombineRule, ImpulseJoint, InteractionGroups, Collider as RapierCollider, RigidBody as RapierRigidBody, TempContactManifold } from "@dimforge/rapier3d-compat";
 import { Rotation, Vector } from "@dimforge/rapier3d-compat/math";
-import { Object3DProps, Quaternion, Vector3 } from "@react-three/fiber";
+import { Quaternion, ThreeElements, Vector3 } from "@react-three/fiber";
 import { Object3D } from "three";
 import { ColliderProps } from "./index.js";
 import { RigidBodyState } from "./components/Physics.js";
 export { CoefficientCombineRule as CoefficientCombineRule } from "@dimforge/rapier3d-compat";
 export { RapierCollider, RapierRigidBody };
-export declare type RefGetter<T> = MutableRefObject<() => T | undefined>;
-export declare type RigidBodyAutoCollider = "ball" | "cuboid" | "hull" | "trimesh" | false;
-export declare type CuboidArgs = [
+export type RefGetter<T> = RefObject<() => T | undefined>;
+export type RigidBodyAutoCollider = "ball" | "cuboid" | "hull" | "trimesh" | false;
+export type CuboidArgs = [
     halfWidth: number,
     halfHeight: number,
     halfDepth: number
 ];
-export declare type BallArgs = [radius: number];
-export declare type CapsuleArgs = [halfHeight: number, radius: number];
-export declare type ConvexHullArgs = [vertices: ArrayLike<number>];
-export declare type HeightfieldArgs = [
+export type BallArgs = [radius: number];
+export type CapsuleArgs = [halfHeight: number, radius: number];
+export type ConvexHullArgs = [vertices: ArrayLike<number>];
+export type HeightfieldArgs = [
     width: number,
     height: number,
     heights: number[],
@@ -27,66 +27,54 @@ export declare type HeightfieldArgs = [
         z: number;
     }
 ];
-export declare type TrimeshArgs = [
+export type TrimeshArgs = [
     vertices: ArrayLike<number>,
     indices: ArrayLike<number>
 ];
-export declare type PolylineArgs = [vertices: Float32Array, indices: Uint32Array];
-export declare type RoundCuboidArgs = [
+export type PolylineArgs = [vertices: Float32Array, indices: Uint32Array];
+export type RoundCuboidArgs = [
     halfWidth: number,
     halfHeight: number,
     halfDepth: number,
     borderRadius: number
 ];
-export declare type CylinderArgs = [halfHeight: number, radius: number];
-export declare type RoundCylinderArgs = [
+export type CylinderArgs = [halfHeight: number, radius: number];
+export type RoundCylinderArgs = [
     halfHeight: number,
     radius: number,
     borderRadius: number
 ];
-export declare type ConeArgs = [halfHeight: number, radius: number];
-export declare type RoundConeArgs = [
+export type ConeArgs = [halfHeight: number, radius: number];
+export type RoundConeArgs = [
     halfHeight: number,
     radius: number,
     borderRadius: number
 ];
-export declare type ConvexMeshArgs = [
+export type ConvexMeshArgs = [
     vertices: ArrayLike<number>,
     indices: ArrayLike<number>
 ];
-export declare type RoundConvexHullArgs = [
+export type RoundConvexHullArgs = [
     vertices: ArrayLike<number>,
     indices: ArrayLike<number>,
     borderRadius: number
 ];
-export declare type RoundConvexMeshArgs = [
+export type RoundConvexMeshArgs = [
     vertices: ArrayLike<number>,
     indices: ArrayLike<number>,
     borderRadius: number
 ];
-export declare type UseBodyOptions = Omit<RigidBodyOptions, "shape">;
-export declare type RigidBodyTypeString = "fixed" | "dynamic" | "kinematicPosition" | "kinematicVelocity";
-export declare type ColliderShape = "cuboid" | "trimesh" | "ball" | "capsule" | "convexHull" | "heightfield" | "polyline" | "roundCuboid" | "cylinder" | "roundCylinder" | "cone" | "roundCone" | "convexMesh" | "roundConvexHull" | "roundConvexMesh";
-export declare type Vector3Tuple = [x: number, y: number, z: number];
-export declare type Vector4Tuple = [x: number, y: number, z: number, w: number];
-export declare type Boolean3Tuple = [x: boolean, y: boolean, z: boolean];
-export declare type Vector3Object = {
+export type UseBodyOptions = Omit<RigidBodyOptions, "shape">;
+export type RigidBodyTypeString = "fixed" | "dynamic" | "kinematicPosition" | "kinematicVelocity";
+export type ColliderShape = "cuboid" | "trimesh" | "ball" | "capsule" | "convexHull" | "heightfield" | "polyline" | "roundCuboid" | "cylinder" | "roundCylinder" | "cone" | "roundCone" | "convexMesh" | "roundConvexHull" | "roundConvexMesh";
+export type Vector3Tuple = [x: number, y: number, z: number];
+export type Vector4Tuple = [x: number, y: number, z: number, w: number];
+export type Boolean3Tuple = [x: boolean, y: boolean, z: boolean];
+export type Vector3Object = {
     x: number;
     y: number;
     z: number;
 };
-/**
- * @deprecated use Vector3Tuple instead
- */
-export declare type Vector3Array = Vector3Tuple;
-/**
- * @deprecated use Vector4Tuple instead
- * */
-export declare type Vector4Array = Vector4Tuple;
-/**
- * @deprecated use Boolean3Tuple instead
- * */
-export declare type Boolean3Array = Boolean3Tuple;
 export interface ColliderOptions<ColliderArgs extends Array<unknown>> {
     /**
      * The optional name passed to THREE's Object3D
@@ -125,19 +113,19 @@ export interface ColliderOptions<ColliderArgs extends Array<unknown>> {
     /**
      * The position of this collider relative to the rigid body
      */
-    position?: Object3DProps["position"];
+    position?: ThreeElements["object3D"]["position"];
     /**
      * The rotation of this collider relative to the rigid body
      */
-    rotation?: Object3DProps["rotation"];
+    rotation?: ThreeElements["object3D"]["rotation"];
     /**
      * The rotation, as a Quaternion, of this collider relative to the rigid body
      */
-    quaternion?: Object3DProps["quaternion"];
+    quaternion?: ThreeElements["object3D"]["quaternion"];
     /**
      * The scale of this collider relative to the rigid body
      */
-    scale?: Object3DProps["scale"];
+    scale?: ThreeElements["object3D"]["scale"];
     /**
      * Callback when this collider collideas with another collider.
      */
@@ -218,13 +206,13 @@ export interface ColliderOptions<ColliderArgs extends Array<unknown>> {
      */
     sensor?: boolean;
 }
-export declare type CollisionTarget = {
+export type CollisionTarget = {
     rigidBody?: RapierRigidBody;
     collider: RapierCollider;
     rigidBodyObject?: Object3D;
     colliderObject?: Object3D;
 };
-export declare type CollisionPayload = {
+export type CollisionPayload = {
     /** the object firing the event */
     target: CollisionTarget;
     /** the other object involved in the event */
@@ -238,25 +226,25 @@ export declare type CollisionPayload = {
     /** deprecated use `payload.other.colliderObject` instead */
     colliderObject?: Object3D;
 };
-export declare type CollisionEnterPayload = CollisionPayload & {
+export type CollisionEnterPayload = CollisionPayload & {
     manifold: TempContactManifold;
     flipped: boolean;
 };
-export declare type CollisionExitPayload = CollisionPayload;
-export declare type IntersectionEnterPayload = CollisionPayload;
-export declare type IntersectionExitPayload = CollisionPayload;
-export declare type ContactForcePayload = CollisionPayload & {
+export type CollisionExitPayload = CollisionPayload;
+export type IntersectionEnterPayload = CollisionPayload;
+export type IntersectionExitPayload = CollisionPayload;
+export type ContactForcePayload = CollisionPayload & {
     totalForce: Vector;
     totalForceMagnitude: number;
     maxForceDirection: Vector;
     maxForceMagnitude: number;
 };
-export declare type CollisionEnterHandler = (payload: CollisionEnterPayload) => void;
-export declare type CollisionExitHandler = (payload: CollisionExitPayload) => void;
-export declare type IntersectionEnterHandler = (payload: IntersectionEnterPayload) => void;
-export declare type IntersectionExitHandler = (payload: IntersectionExitPayload) => void;
-export declare type ContactForceHandler = (payload: ContactForcePayload) => void;
-export interface RigidBodyOptions extends ColliderProps {
+export type CollisionEnterHandler = (payload: CollisionEnterPayload) => void;
+export type CollisionExitHandler = (payload: CollisionExitPayload) => void;
+export type IntersectionEnterHandler = (payload: IntersectionEnterPayload) => void;
+export type IntersectionExitHandler = (payload: IntersectionExitPayload) => void;
+export type ContactForceHandler = (payload: ContactForcePayload) => void;
+export interface RigidBodyOptions extends Omit<ColliderProps, "ref"> {
     /**
      * Specify the type of this rigid body
      */
@@ -315,11 +303,11 @@ export interface RigidBodyOptions extends ColliderProps {
     /**
      * Initial position of the RigidBody
      */
-    position?: Object3DProps["position"];
+    position?: ThreeElements["object3D"]["position"];
     /**
      * Initial rotation of the RigidBody
      */
-    rotation?: Object3DProps["rotation"];
+    rotation?: ThreeElements["object3D"]["rotation"];
     /**
      * Automatically generate colliders based on meshes inside this
      * rigid body.
@@ -391,7 +379,7 @@ export interface RigidBodyOptions extends ColliderProps {
     /**
      * Passed down to the object3d representing this collider.
      */
-    userData?: Object3DProps["userData"];
+    userData?: ThreeElements["object3D"]["userData"];
     /**
      * Include invisible objects on the collider creation estimation.
      */
@@ -402,31 +390,31 @@ export interface RigidBodyOptions extends ColliderProps {
      */
     transformState?: (state: RigidBodyState) => RigidBodyState;
 }
-export declare type SphericalJointParams = [body1Anchor: Vector3, body2Anchor: Vector3];
-export declare type FixedJointParams = [
+export type SphericalJointParams = [body1Anchor: Vector3, body2Anchor: Vector3];
+export type FixedJointParams = [
     body1Anchor: Vector3,
     body1LocalFrame: Quaternion,
     body2Anchor: Vector3,
     body2LocalFrame: Quaternion
 ];
-export declare type PrismaticJointParams = [
+export type PrismaticJointParams = [
     body1Anchor: Vector3,
     body2Anchor: Vector3,
     axis: Vector3,
     limits?: [min: number, max: number]
 ];
-export declare type RevoluteJointParams = [
+export type RevoluteJointParams = [
     body1Anchor: Vector3,
     body2Anchor: Vector3,
     axis: Vector3,
     limits?: [min: number, max: number]
 ];
-export declare type RopeJointParams = [
+export type RopeJointParams = [
     body1Anchor: Vector3,
     body2Anchor: Vector3,
     length: number
 ];
-export declare type SpringJointParams = [
+export type SpringJointParams = [
     body1Anchor: Vector3,
     body2Anchor: Vector3,
     restLength: number,

package/dist/declarations/src/utils/interaction-groups.d.ts

@@ -31,4 +31,4 @@ import { InteractionGroups } from "@dimforge/rapier3d-compat";
  * @param filters Groups the interaction group should filter against. (Values can range from 0 to 15.)
  * @returns An InteractionGroup bitmask.
  */
-export declare const interactionGroups: (memberships: number | number[], filters?: number | number[] | undefined) => InteractionGroups;
+export declare const interactionGroups: (memberships: number | number[], filters?: number | number[]) => InteractionGroups;