## News

v3.0.5
* Add instanceId to Object3D.userData if available
* Add instruction to use superhands with aframe 1.5.0 and onward

v3.0.4
* A-Frame 1.4.0 support confirmation
  * Updated dependencies and fixed tests and examples
  * No API changes

v3.0.3
* A-Frame 1.3.0 support confirmation
  * Updated dependencies and fixed tests and examples
  * No API changes

v3.0.1

* A-Frame 1.0.4 support confirmation
  * Updated dependencies and fixed tests
  * No notable changes

v3.0.0

* The 'Less is More' update. This package has scope has been narrowed to keep
  it maintainable, increase the frequency of updates, and allow for focus on
  implementing new gestures instead of peripheral components.
  * `progressive-controls` and `a-locomotor` removed from this repo.
    I understand `progressive-controls` was fairly popular, but is has a
    [compatibility issue](https://github.com/aframevr/aframe/issues/3610)
    with the latest A-Frame which was holding up releases for the entire
    package.
    I intend to refactor it and release it in another library, but you can
    still use the last version by including
    [its source file](https://github.com/c-frame/aframe-super-hands-component/blob/dc1a601b7fa9d606a05ec2d3500f8f141c65c20c/misc_components/progressive-controls.js) in your project.
* Smarter raycasting support: chooses nearest intersected entity first,
  reordering stack as distances change (\* if the raycaster in use updates
  intersection objects' distances)
* Improved nested entity handling: only one component can react to each
  gesture event.
* Improved stretching of complex physics bodies: all shapes, child entity
  shapes, and offsets are updated
* Added support for `'worker'` and other `aframe-physics-system` drivers
  in `grabbable`
* v2.x deprecations removed: `drag-droppable` component and
  `super-hands.colliderState` property.

v2.1.0

* A-Frame v0.8.0 (WIP/master branch) support
* Deprecate `super-hands.colliderState`
  * `colliderEndEvent` and `colliderEndEventProperty` now supported by
    `sphere-collider`
* Deprecate `drag-droppable`; replace with separate `draggable` and `droppable`
  reaction components. `droppable` can selectively accept or reject attempted
  'drag-drop' gestures depending on the entity being dropped on it.
* `progressive-controls` updates
  * Use mixins for customization
  * Remove extra controller on ground from single controller setups
  * Add `controllerModel` option to bypass default controller models

v2.0.2

* A-Frame v0.7.0 and master support
* Implement [aframe-machinima-testing](https://github.com/wmurphyrd/aframe-machinima-testing)
  for automated functional testing using motion captured user input
* Bug fixes:
  * Improved handling of touch (eliminate doubled events)
  * Fix odd behavior of repeatedly or simultaneously grabbed objects

v2.0.1

* Bug fixes:
  * `'mouseup'` now fires correctly on target entities
  * Fixed lingering hover when `progressive-controls` advances from gaze mode
  * Fixed lingering hovers when `progressive-controls` in point mode
  * Fixed some new files being excluded from babelify & breaking uglify

v2.0.0

* Consistent experience across devices: `super-hands` now provides interactivity
  for all levels of VR controls: desktop mouse, mobile touch ("magic window"),
  cardboard button,
  3DOF (GearVR and Daydram), and 6DOF (Vive and Oculus Touch)
  * `progressive-controls` meta-component to automatically setup interactive
    controls on **any** device from desktop to Vive
  * Upgraded `grabbable` reaction component.
    * Now works with pointing and moving at a distance, e.g. with
      3DOF controllers and `laser-controls`, using controller orientation
      and position to move grabbed entities
* Button mapping for reaction components: each reaction component now has
  `startButtons` and `endButtons` schema properties to specify acceptable
  buttons. This allows different entities to react to different buttons.
  [For example](https://c-frame.github.io/aframe-super-hands-component/examples/#sticky)
  `a-locomotor`'s `grabbable` can be set to respond to different
  buttons than other `grabbable` entities so that
  grabbing entities and locomotion are separate gestures for the user.
* `a-locomotor` now functions independently from colliders;
  removed `add-to-colliders` attribute.
* Performance improvements in `grabbable` and `stretchable`
* Gesture initiation changed to occur only on button press rather than
  button press and collision. Pressing a button in empty space and then
  moving into an object will no long scoop it up in a grab.

v1.1.0

* Compatibility with desktop mouse control via A-Frame `cursor` component
  * Added new schema property `colliderEventProperty` to configure
    where in the `event.details` to look for the collision target
  * Requires some configuration of schema properties, see new example: [Mouse Controls](https://c-frame.github.io/aframe-super-hands-component/examples/#mouse)
* Select examples now have `avatar-replayer` to preview actions without needing
  VR equipment

v1.0.1

* A-Frame v0.6.0 compatibility: fixed issue with camera freezing when using
  `a-locomotor`'s automatic camera config
* Updated documentation and examples with latest versions of `aframe-extras` and
  `aframe-physics-system`.

v1.0.0

* `a-locomotor`: drop-in freedom of motion for WebVR experiences
  with this new primitive
* Maturation of A-Frame style API: Reaction components now need to cancel
  gesture events in order to communicate acceptance of the gesture to `super-hands`.
  This improves state tracking and handling of overlapping/nested
  entities
* Improved Global Event Handlers integration:
    * When overlapping entities create multiple potential targets for GEH
      events, the events fire on all potential targets
    * `click` now functions more like its mouse counterpart, only firing
      if a mouseup occurs after a mousedown and without losing collision
      with the target entity
* Two-handed grabbing: `grabbable` can now process grabs from multiple
  `super-hands` entities. In non-physics interactions, this makes passing
  entities between hands much easier. In physics-based interactions, this
  creates multiple constraints for advanced handling
* `strechable` flexibility: state tracking of hands attempting to
  stretch moved from `super-hands` to `strechable`. This should allow for
  different avatars in a multi-user setting to stretch a single entity
  cooperatively
* Added [machinima testing](https://github.com/wmurphyrd/aframe-machinima-testing)
  for automated testing based on motion-captured user input to improve
  regression detection