[WIP] Towards 1.0.0

.eslintrc

@@ -1,22 +1,35 @@
 {
+    "extends": "eslint:recommended",
+
     "rules": {
+        "no-shadow": 2,
+        "no-catch-shadow": 2,
+        "no-shadow-restricted-names": 2,
         "radix": 2,
-        "vars-on-top": 2,
+
         "wrap-iife": 2,
-
+        "yoda": 2,
+        "semi": 2,
         "indent": 2,
         "camelcase": 2,
         "brace-style": 2,
         "comma-spacing": 2,
         "comma-style": 2,
-        "quotes": [2, "simple"],
-
+        "quotes": [2, "single", "avoid-escape"],
+        "no-spaced-func": 2,
+        "space-after-keywords": 2,
+        "space-before-blocks": 2,
+        "space-before-function-paren": [2, {"anonymous": "always", "named": "never"}],
+        "space-in-parens": 2,
+        "space-infix-ops": 2,
+        "space-return-throw-case": 2,
+        "space-unary-ops": 2,
         "no-trailing-spaces": 0,
         "no-underscore-dangle": 0
     },
-    
+
     "env": {
-        "browser": true,
+        "es6": true,
         "node": true
     }
-}
+}

.gitignore

@@ -1,4 +1,2 @@
 coverage
-out
-docs
 node_modules

.travis.yml

@@ -1,5 +1,7 @@
 language: node_js
+sudo: false
 node_js:
-  - "0.12"
-  - "0.10"
-  - iojs
+  - 4.2.6
+  - 5.5.0
+after_success:
+  - npm run coveralls

CHANGELOG.md

@@ -0,0 +1,220 @@
+# Change log
+
+This is a log of all API changes to the library, version per version. It follows advices from [keepachangelog.com](http://keepachangelog.com/).
+All releases following v1.0.0 follow semantic versioning ‒ for previous releases, read the change log for more information.
+
+## [v1.0.0](https://github.com/matteodelabre/midijs/releases/tag/v1.0.0) ― 2016-01-24
+
+*See pull request [#3](https://github.com/matteodelabre/midijs/pull/3) for* more information.
+
+#### Added
+
+* `Event` accepts strings in some arguments (`Event` type can be given with a string, `PROGRAM_CHANGE` accepts a string for specifying the instrument, `CONTROLLER` accepts a string for specifying the controller).
+* `CONTROLLER` now supports all kinds of controllers.
+* `NOTE_OFF`, `NOTE_ON` and `NOTE_AFTERTOUCH` accept English-written notes such as "C" or "D2#".
+* New `TYPE` property on `SysexEvent`s for consistency.
+* `encode` and `decode` methods on `File`, replacing previous ones.
+* New API on `File` for creating tunes from the code.
+* `Event` subclasses are now publicly exposed.
+
+#### Changed
+
+* `gm` module. Instruments literals have been integrated into `ChannelEvent`.
+* `CONTROLLER#controller` has been renamed to `CONTROLLER#type`.
+* `PROGRAM_CHANGE#program` has been renamed to `PROGRAM_CHANGE#instrument`.
+* `TIME_SIGNATURE#clockSignalsPerBeat` has been renamed to `TIME_SIGNATURE#notated32ndsPerMIDIBeat`.
+* `NOTE_AFTERTOUCH#pressure` defaults to 127 instead of 0.
+* Unknown events doesn't generate exceptions but sets an `unknown` flag to true. (Thanks to [@corentingurtner](https://github.com/corentingurtner)).
+
+#### Removed
+
+* `connect` module. Use the WebMIDI API or `node-midi` for this purpose.
+* `Error` subclasses.
+* `Event` class.
+* All previous methods of `File`, including support for streams.
+
+## [v0.12.0](https://github.com/matteodelabre/midijs/releases/tag/v0.12.0) ― 2015-05-08
+
+#### Added
+
+* Support `MIDI_PORT` meta event.
+
+#### Changed
+
+* Rename `CHANNEL_PREFIX` meta event to `MIDI_CHANNEL`.
+
+## [v0.11.2](https://github.com/matteodelabre/midijs/releases/tag/v0.11.2) ― 2015-05-01
+
+#### Changed
+
+* Improve error messages.
+
+## [v0.11.1](https://github.com/matteodelabre/midijs/releases/tag/v0.11.1) ― 2015-04-30
+
+#### Changed
+
+* Rename the `instruments` module to `GM` (despite the release number, this is a breaking change).
+
+## [v0.11.0](https://github.com/matteodelabre/midijs/releases/tag/v0.11.0) ― 2015-02-18
+
+#### Added
+
+* Default values in `Event`.
+* Custom error classes.
+
+#### Changed
+
+* Improved streams support in `File`.
+
+## [v0.10.2](https://github.com/matteodelabre/midijs/releases/tag/v0.10.2) ― 2015-02-14
+
+*No visible changes.*
+
+## [v0.10.1](https://github.com/matteodelabre/midijs/releases/tag/v0.10.1) ― 2015-02-14
+
+*No visible changes.*
+
+## [v0.10.0](https://github.com/matteodelabre/midijs/releases/tag/v0.10.0) ― 2015-02-14
+
+#### Added
+
+* New `File` class merging `Reader` and `Writer`.
+
+#### Removed
+
+* `Reader` and `Writer` classes, merged in `File`.
+
+## [v0.9.0](https://github.com/matteodelabre/midijs/releases/tag/v0.9.0) ― 2015-02-14
+
+#### Changed
+
+* Use constants instead of strings for `Event` types.
+
+#### Deprecated
+
+* Portions of internal, non-documented code.
+
+## [v0.8.0](https://github.com/matteodelabre/midijs/releases/tag/v0.8.0) ― 2015-02-13
+
+#### Changed
+
+* Documentation improvements.
+* Rewrite the test suite.
+
+## [v0.7.5](https://github.com/matteodelabre/midijs/releases/tag/v0.7.5) ― 2015-02-01
+
+#### Fixed
+
+* Fix `Output#send` producing wrong MIDI data.
+
+## [v0.7.4](https://github.com/matteodelabre/midijs/releases/tag/v0.7.4) ― 2015-02-01
+
+#### Fixed
+
+* Fix wrong subtype checks.
+
+## [v0.7.3](https://github.com/matteodelabre/midijs/releases/tag/v0.7.3) ― 2015-02-01
+
+#### Changed
+
+* Added `repository` field in package.json.
+
+#### Fixed
+
+* Fixed `Driver#send` method.
+
+## [v0.7.2](https://github.com/matteodelabre/midijs/releases/tag/v0.7.2) ― 2015-02-01
+
+#### Fixed
+
+* Tried to fix `Driver#send` method (and failed; use 0.7.3 instead).
+
+## [v0.7.1](https://github.com/matteodelabre/midijs/releases/tag/v0.7.1) ― 2015-02-01
+
+#### Fixed
+
+* Do not crash with falsy `Input`/`Output` values.
+
+## [v0.7.0](https://github.com/matteodelabre/midijs/releases/tag/v0.7.1) ― 2015-02-01
+
+#### Added
+
+* Add port metadata in `Input`/`Output`.
+
+## [v0.6.0](https://github.com/matteodelabre/midijs/releases/tag/v0.6.0) ― 2015-02-01
+
+#### Added
+
+* Support inputs in `connect` module.
+
+## [v0.5.0](https://github.com/matteodelabre/midijs/releases/tag/v0.5.0) ― 2015-02-01
+
+#### Changed
+
+* `connect` is only supported in the browser.
+
+## [v0.4.2](https://github.com/matteodelabre/midijs/releases/tag/v0.4.2) ― 2015-01-31
+
+#### Added
+
+* Support for the `SMTPEOffset` meta event.
+
+## [v0.4.1](https://github.com/matteodelabre/midijs/releases/tag/v0.4.1) ― 2015-01-31
+
+#### Removed
+
+* Remove keyOffset in `programs` (despite the release number, this is a breaking change).
+
+#### Fixed
+
+* Typos in paths.
+
+## [v0.4.0](https://github.com/matteodelabre/midijs/releases/tag/v0.4.0) ― 2015-01-31
+
+#### Added
+
+* Support streams with `Reader` and `Writer`.
+
+#### Changed
+
+* `FileReader` and `FileWriter` have been renamed to `Reader` and `Writer`.
+
+## [v0.3.1](https://github.com/matteodelabre/midijs/releases/tag/v0.3.1) ― 2015-01-25
+
+*No visible changes.*
+
+## [v0.3.0](https://github.com/matteodelabre/midijs/releases/tag/v0.3.0) ― 2015-01-25
+
+#### Added
+
+* `FileReader`, `FileWriter` instead of `File`.
+* Test suite for `FileReader`.
+
+#### Changed
+
+* Wrote a real README file.
+
+#### Removed
+
+* `Event` constructor's running status parameter. Stored internally instead.
+
+## [v0.2.0](https://github.com/matteodelabre/midijs/releases/tag/v0.2.0) ― 2015-01-25
+
+#### Added
+
+* Added LICENSE and README.
+
+#### Changed
+
+* `File` doesn't load files by itself. Use `fs.readFile` or a XHR object instead.
+* Error messages are now in English.
+* Use JSLint instead of JSHint for code-style checking.
+
+#### Removed
+
+* `programs` doesn't provide localized instrument names anymore.
+* Remove undocumented internal method in `File` (`File#_parseMetaEvent`, `File#_parseEvent`, `File#_parseSystemEvent`, `File#_parseChannelEvent`).
+
+## [v0.1.0](https://github.com/matteodelabre/midijs/releases/tag/v0.1.0) ― 2014-12-30
+
+*Initial release.*

CONTRIBUTING.md

@@ -0,0 +1,54 @@
+# Contributing
+
+Thank you for your interest in contributing to this repo!  
+All contributions (even small ones) are welcome.
+In order to keep this repo consistent, please
+try to follow these rules.
+
+Many thanks to those who contributed to this project:
+
+* [@corentingurtner](https://github.com/corentingurtner)
+
+## 1. Commit tags
+
+All commits should be tagged with emojis whenever possible
+to make the commit list more readable.
+
+| Emoji      | Commit content        |
+|:----------:|:--------------------- |
+| :book:     | Documentation updates |
+| :bug:      | Bug fixes             |
+| :ledger:   | Moving files          |
+| :bulb:     | New features          |
+| :lipstick: | Fixing coding style   |
+
+## 2. Branches
+
+Please use a branch name that differs from `master`
+when making pull requests, so that the network
+history is more readable.
+
+For example, if you wanted to fix the issue
+"improve documentation", you could have
+chosen the following branch name: `improve-docs`.
+
+## 3. Coding style
+
+Javascript can be authored by following
+[a](https://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml)
+[lot](https://github.com/airbnb/javascript)
+[of](https://github.com/felixge/node-style-guide)
+[different](https://contribute.jquery.org/style-guide/js/)
+[style guides](https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Coding_Style)
+but we decided to be a bit soft on that.
+
+As a rule of thumb, use [ESLint](http://eslint.org/) to check if your code complies
+with our style conventions. Here are some of the rules:
+
+* use the radix parameter in `parseInt()` calls;
+* use the *one true brace style;*
+* put one space after commas, and no space before;
+* put your comma at the end of the lines;
+* use simple quotes;
+* use camelcase;
+* use 4 spaces for indentation.

LICENSE → LICENSE.md

@@ -1,3 +1,7 @@
+# License
+
+_The MIT license._
+
 Copyright (c) 2014-2015 Mattéo DELABRE
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -16,4 +20,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+THE SOFTWARE.