Version 1.16.0
Merge commit '515dd47e58fb883c77bdfc114c88fc27884d7c9e' into stable
diff --git a/CHANGELOG.md b/CHANGELOG.md
index af5ee69..27d3383 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,15 +1,97 @@
-## 1.16.0
+## 1.16.0 - 2016-04-26
### Core library changes
* `dart:convert`
* Added `BASE64URL` codec and corresponding `Base64Codec.urlSafe` constructor.
+
+ * Introduce `ChunkedConverter` and deprecate chunked methods on `Converter`.
+
+* `dart:html`
+
+ There have been a number of **BREAKING** changes to align APIs with recent
+ changes in Chrome. These include:
+
+ * Chrome's `ShadowRoot` interface no longer has the methods `getElementById`,
+ `getElementsByClassName`, and `getElementsByTagName`, e.g.,
+
+ ```dart
+ elem.shadowRoot.getElementsByClassName('clazz')
+ ```
+
+ should become:
+
+ ```dart
+ elem.shadowRoot.querySelectorAll('.clazz')
+ ```
+
+ * The `clipboardData` property has been removed from `KeyEvent`
+ and `Event`. It has been moved to the new `ClipboardEvent` class, which is
+ now used by `copy`, `cut`, and `paste` events.
+
+ * The `layer` property has been removed from `KeyEvent` and
+ `UIEvent`. It has been moved to `MouseEvent`.
+
+ * The `Point get page` property has been removed from `UIEvent`.
+ It still exists on `MouseEvent` and `Touch`.
+
+ There have also been a number of other additions and removals to `dart:html`,
+ `dart:indexed_db`, `dart:svg`, `dart:web_audio`, and `dart:web_gl` that
+ correspond to changes to Chrome APIs between v39 and v45. Many of the breaking
+ changes represent APIs that would have caused runtime exceptions when compiled
+ to Javascript and run on recent Chrome releases.
+
* `dart:io`
* Added `SecurityContext.alpnSupported`, which is true if a platform
supports ALPN, and false otherwise.
-* `dart:convert`
- * Introduce `ChunkedConverter` and deprecate chunked methods on `Converter`.
+### JavaScript interop
+
+For performance reasons, a potentially **BREAKING** change was added for
+libraries that use JS interop.
+Any Dart file that uses `@JS` annotations on declarations (top-level functions,
+classes or class members) to interop with JavaScript code will require that the
+file have the annotation `@JS()` on a library directive.
+
+```dart
+@JS()
+library my_library;
+```
+
+The analyzer will enforce this by generating the error:
+
+The `@JS()` annotation can only be used if it is also declared on the library
+directive.
+
+If part file uses the `@JS()` annotation, the library that uses the part should
+have the `@JS()` annotation e.g.,
+
+```dart
+// library_1.dart
+@JS()
+library library_1;
+
+import 'package:js/js.dart';
+
+part 'part_1.dart';
+```
+
+```dart
+// part_1.dart
+part of library_1;
+
+@JS("frameworkStabilizers")
+external List<FrameworkStabilizer> get frameworkStabilizers;
+```
+
+If your library already has a JS module e.g.,
+
+```dart
+@JS('array.utils')
+library my_library;
+```
+
+Then your library will work without any additional changes.
### Analyzer
diff --git a/tools/VERSION b/tools/VERSION
index da869b8..5f18786 100644
--- a/tools/VERSION
+++ b/tools/VERSION
@@ -23,9 +23,9 @@
# * Making cherry-picks to stable channel
# - increase PATCH by 1
#
-CHANNEL dev
+CHANNEL stable
MAJOR 1
MINOR 16
PATCH 0
-PRERELEASE 5
-PRERELEASE_PATCH 5
+PRERELEASE 0
+PRERELEASE_PATCH 0
