react-events/release-notes.md

Declarative managed event bindings for React components

# Release Notes

## Development

[Commits](https://github.com/jhudson8/react-events/compare/v0.7.5...master)

## v0.7.5 - December 1st, 2014
- bug fix: only include on/off/trigger from event handler impl - 8a17425


[Commits](https://github.com/jhudson8/react-events/compare/v0.7.4...v0.7.5)

## v0.7.4 - November 28th, 2014
- add more visible -> as the special separator "specialName(...)->..." - 545f9a3


[Commits](https://github.com/jhudson8/react-events/compare/v0.7.3...v0.7.4)

## v0.7.3 - November 28th, 2014
- allow non-string special arguments - 39a920c


[Commits](https://github.com/jhudson8/react-events/compare/v0.7.2...v0.7.3)

## v0.7.2 - November 26th, 2014
- support event bindings declared as a tree structure - 47b5628
For example
```
events: {
  prop: {
    'foo:test1': 'test1',
    foo: {
      test2: 'test2',
      test3: 'test3'
    }
  },
  'prop:bar:test4': 'test4'
}
```
will be converted to
```
events: {
  'prop:foo:test1': 'test1',
  'prop:foo:test2': 'test2',
  'prop:foo:test3': 'test3',
  'prop:bar:test4': 'test4'
}
```


[Commits](https://github.com/jhudson8/react-events/compare/v0.7.1...v0.7.2)

## v0.7.1 - November 26th, 2014
- for AMD, you must execute the function with params (see README AMD install instructions) - ecb83cc
```
require(
  ['react', react-events'], function(React, reactEvents) {
  reactEvents(React); 
});
```


[Commits](https://github.com/jhudson8/react-events/compare/v0.7.0...v0.7.1)

## v0.7.0 - November 25th, 2014
- add "prop" declarative event - 8a8bb53
- add "listen" mixin - 44d737c
- bug fix: ensure bound handlers are saved within state - 312d8ce


[Commits](https://github.com/jhudson8/react-events/compare/v0.6.0...v0.7.0)

## v0.6.0 - November 14th, 2014
- remove DOM event handler - cd6489f

Compatibility notes:
If you are using the "dom" event handler, you must now add that event handler in your own project (to remove the jquery dependency for this project)

```
React.events.handle('dom', function(options, callback) {
  var parts = options.path.match(splitter);
  return {
    on: function() {
      $(this.getDOMNode()).on(parts[1], parts[2], callback);
    },
    off: function() {
      $(this.getDOMNode()).off(parts[1], parts[2], callback);
    }
  };
});
```

[Commits](https://github.com/jhudson8/react-events/compare/v0.5.2...v0.6.0)

## v0.5.2 - November 2nd, 2014
- [#1](https://github.com/jhudson8/react-events/issues/1) - Exception when using react-events with browserify
- add package keyword "react-mixin-manager" - a70d493

[Commits](https://github.com/jhudson8/react-events/compare/v0.5.1...v0.5.2)

## v0.5.1 - October 3rd, 2014
- $ to be provided for commonJS - aaa0faf

[Commits](https://github.com/jhudson8/react-events/compare/v0.5.0...v0.5.1)

## v0.5.0 - September 7th, 2014
- add "react-component" keyword - 39f0ce1
- remove the "triggerWith" mixin and move the triggerWith method into the "events" mixin - b489c2f
- v0.4.3 - a694dac

[Commits](https://github.com/jhudson8/react-events/compare/v0.4.3...v0.5.0)

## v0.4.3 - July 25th, 2014
- fix ref event handlers in case the ref component changed during parent renders - cc934d8

Compatibility notes:
- TODO : What might have broken?

[Commits](https://github.com/jhudson8/react-events/compare/v0.4.2...v0.4.3)

## v0.4.2 - June 17th, 2014
- fix bower.json - 9ab5bbc
- update dependencies docs - 1aa6bbc

[Commits](https://github.com/jhudson8/react-events/compare/v0.4.1...v0.4.2)

## v0.4.1 - June 16th, 2014
- update dependencies - bda8de9
- allow for customer handlers to match the path by regular expression - 0bcdca0
- add bower.json - 8372180

[Commits](https://github.com/jhudson8/react-events/compare/v0.4.0...v0.4.1)

## v0.4.0 - June 12th, 2014
- added special callback wrappers (useful for throttling, cacheing and other reusable callback wrappers) - 3085655
- add object with "callback" parameter support with instance definitions to be able to refer to "this" as the component instance when declaring the callback function. - 55d5e2a

[Commits](https://github.com/jhudson8/react-events/compare/v0.3.0...v0.4.0)

## v0.3.0 - June 4th, 2014
- add 'repeat' and '!repeat' events - 9001bbf

[Commits](https://github.com/jhudson8/react-events/compare/v0.2.1...v0.3.0)

## v0.2.1 - May 22nd, 2014
- add custom events / forceUpdate unit tests - 30ae1dd
- do not send any arguments if the handler event name is "forceUpdate" as that will throw an exception by React - b7122fe

[Commits](https://github.com/jhudson8/react-events/compare/v0.2.0...v0.2.1)

## v0.2.0 - May 18th, 2014
- expose a new mixin: "triggerWith" - b62497a, fc5eb13
- bug fix: bind external "events" (on/off/trigger) object methods to state rather than just using "this" - f351712
- change handler API (not backwards compatible) - 381a352

[Commits](https://github.com/jhudson8/react-events/compare/v0.1.2...v0.2.0)

## v0.1.2 - May 16th, 2014
- added window existence check before including window events - b71d259

[Commits](https://github.com/jhudson8/react-events/compare/v0.1.1...v0.1.2)

## v0.1.1 - May 15th, 2014
- Update README.md
- fix author email address

[Commits](https://github.com/jhudson8/react-events/compare/1341bec...v0.1.1)