Stable Release v2.1.0

New Features

• Polymer.passiveTouchGestures
  • The passiveTouchGestures setting allows an app to specify that gesture events like tap and track generated from touch will not be preventable, allowing for better scrolling performance.
  • Since this could break elements or apps that depended on being able to call gestureEvent.preventDefault() to prevent scrolling, this is an opt-in setting.
  • Use Polymer.setPassiveTouchGestures(true) to enable

Meaningful Changes

• An assortment of minor changes to help facilitate easier automated conversions to ES Modules for Polymer 3.x
• Fix event path for gestures generated by touch events
• Add documentation for Polymer.sanitizeDOMValue
  • sanitizeDOMValue is a global callback that can be used to plug into XSS sanitization libraries before the databinding system sets values.
• Fix ordering of <link rel="import" type="css"> stylesheets to always be prepended, more aligned with their usage in 1.x
• The <dom-bind> element is now exposed on Polymer as Polymer.DomBind.
• All <dom-*> elements are now explicitly styled as display: none

Raw Notes

• [ci skip] bump version to 2.1.0 (commit)

• Port #3844 to 2.x (commit)

• Provide a Polymer.setPassiveTouchGestures() function (commit)

• Make sure closure types have braces (commit)

• a few more comments in return (commit)

• Fix setting, add smoke test (commit)

• Optional passive touch listeners for gestures (commit)

• Don't have return /** comment */ lines (commit)

• [ci skip] disable closure lint for now (travis java errors) (commit)

• try to avoid introducing spelling errors in changelogs (commit)

• spelling: webcomponents (commit)

• spelling: veiling (commit)

• spelling: unnecessary (commit)

• spelling: toolkit (commit)

• spelling: together (commit)

• spelling: there-when (commit)

• spelling: theming (commit)

• spelling: supported (commit)

• spelling: stylesheet (commit)

• spelling: static (commit)

• spelling: sometimes (commit)

• spelling: shuffling (commit)

• spelling: returns (commit)

• spelling: restart (commit)

• spelling: responsive (commit)

• spelling: resilient (commit)

• spelling: resetting (commit)

• spelling: reentrancy (commit)

• spelling: readonly (commit)

• spelling: prototype (commit)

• spelling: protocols (commit)

• spelling: properties (commit)

• spelling: preferring (commit)

• spelling: polyfill (commit)

• spelling: parameterize (commit)

• spelling: omit (commit)

• spelling: offset (commit)

• spelling: notification (commit)

• spelling: name (commit)

• spelling: multiple (commit)

• spelling: loaded (commit)

• spelling: jquery (commit)

• spelling: javascript (commit)

• spelling: instead (commit)

• spelling: initial (commit)

• spelling: increments (commit)

• spelling: identify (commit)

• spelling: github (commit)

• spelling: getting (commit)

• spelling: function (commit)

• spelling: falsy (commit)

• spelling: enqueuing (commit)

• spelling: element (commit)

• spelling: effective (commit)

• spelling: doesn't (commit)

• spelling: does (commit)

• spelling: disappearing (commit)

• spelling: deserialized (commit)

• spelling: customize (commit)

• spelling: containing (commit)

• spelling: components (commit)

• spelling: collection (commit)

• spelling: children (commit)

• spelling: changed (commit)

• spelling: behavior (commit)

• spelling: attribute (commit)

• spelling: attached (commit)

• spelling: asynchronous (commit)

• Explicitly set display none on dom-* elements (#4821) (commit)

• Publish DomBind in Polymer. scope (commit)

• Fix missing semi-colons in test folder (commit)

• Enable ESLint 'semi' rule (commit)

• [ci skip] update package-lock (commit)

• [ci skip] Add license headers to externs (commit)

• Polymer.Path.get accepts both a string path or an Array path, so functions that call this should allow for either as well. Already changed for Polymer.prototype.push here: (commit)

• lint with closure as well (commit)

• Update closure compiler to support polymer pass v2 (commit)

• Revert "Adds restamp mode to dom-repeat." (commit)

• Add test to verify that importHref can be called twice (commit)

• Fix compiling with Polymer({}) calls (commit)

• Remove double space (commit)

• Add development workflow-related files to gitignore (#4612) (commit)

• Allow arbitrary whitespace in CSS imports (commit)

• Fix dom-module API docs with static import function (commit)

• [ci skip] update externs more from #4776 (commit)

• imported css modules should always be before element's styles (commit)

• Update closure annotation for Polymer.prototype.push (commit)

• Fixed formatting. (commit)

• Fix formatting of code in API docs (#4771) (commit)

• Lint clean. (commit)

• Separate scripts that modify configuration properties, as their ordering constraints are unusual. (commit)

• test: convert XNestedR...

Stable Release v1.10.0

Meaningful Changes

• Add Polymer.Settings.passiveTouchGestures
  • passiveTouchGestures is backported from Polymer 2.1, passive (non-preventable) touch event listeners for gesture events such as tap and track.
  • This can increase scrolling performance, at the cost of no longer being able to call trackEvent.preventDefault() to stop scrolling behavior.
  • This setting is false by default and meant as an opt-in.

Raw Notes

• Backport passive touch gestures #4829 (commit)

• [ci skip] Update CHANGELOG (commit)

• Be more precise about the origin of webcomponentsjs (commit)

Stable Release v1.9.3

Meaningful Changes

• Support Polymer 2 Hybrid styles with :host, html selector
  • This is the best replacement for :root selector in style modules

Raw Notes

• Support :host > * as well (commit)

• Support Polymer 2.x shared styles (commit)

• [ci skip] Update Changelog (commit)

• [ci skip] fix "gulp release" for master -> 1.x in dev branch (commit)

Stable Release v2.0.2

Meaningful Changes

• Full Closure Compiler compatibility with Polymer Pass version 2
  • --polymer_version 2 flag to Closure Compiler
  • Available with the next release of Closure Compiler
• Fix for elements that stamp templates as children instead of using Shadow DOM
• Fix DocumentFragment issues on IE 11
• Allow spaces inside of functions in template binding syntax
• Fix dom-repeat to always notify on observed properties changing

Raw Notes

• remove broken npm script (commit)

• depend on webcomponentsjs 1.0.2 (commit)

• cleanup and update npm dependencies (commit)

• Update LegacyElementMixin.distributeContent (commit)

• Remove crufty test (commit)

• [ci skip] remove one new closure warning for updating closure (commit)

• Meaningful closure fixes from @ChadKillingsworth (commit)

• [ci skip] clean up mixin fn and regen externs (commit)

• address some concerns from kschaaf (commit)

• zero warnings left (commit)

• [ci skip] Fix link closing quotes. (commit)

• Remove @Suppress {missingProperties} (commit)

• Annotate Debouncer summary. (#4691) (commit)

• Fix typo in templatize.html (commit)

• Move Debouncer memberof annotation to right place, and add a summary. (#4690) (commit)

• remove PolymerPropertyEffects type, inline DataTrigger and DataEffect types (commit)

• remove polymer-element dependency introduced by a merge conflict (commit)

• update closure log (commit)

• remove dommodule imports (commit)

• Create style-gather.html (commit)

• README: fix typo (commit)

• Remove unused __needFullRefresh (commit)

• Fixes #4650: if an observed path changes, the repeat should render but in addition, the path should be notified. This is necessary since “mutableData” is optional. (commit)

• last two stragglers (commit)

• fix eslint warnings (commit)

• Down to 30ish warnings, need PolymerPass v2 (commit)

• Add lib/utils/settings.html to hold legacy settings and rootPath (commit)

• Fix typo in dom-repeat.html (commit)

• guard all dommodule references (commit)

• add more missing imports (commit)

• Add mixin.html import to gesture-event-listeners.html (commit)

• more fixes (commit)

• rebaseline warnings with NTI specific warnings disabled, for now (commit)

• Fix parsing for argument whitespace. Fixes #4643. (commit)

• Upgrade babel-preset-babili to include RegExp fix from babel/minify#490 (commit)

• Not an RC anymore (commit)

• Just ensure content frag from _contentForTemplate is inert. Edge does not seem to always use the exact same owner document for templates. (commit)

• Fix typo in prop of FlattenedNodesObserver (commit)

• [ci skip] Update Changelog (commit)

• Fix some ElementMixin warnings. (commit)

• Fix template.assetpath with typedef (commit)

• fix dom-module related errors (commit)

• Fix fn binding error (commit)

• Reduce closure warnings in PropertyAccessors (commit)

• reduce closure warnings in TemplateStamp (commit)

• [ci skip] paramaterize entries for closure task (commit)

• [ci skip] generating externs should be explicit (commit)

• Avoid firstElementChild on DocFrag for IE11 (commit)

• update externs for merge, update dependencies (commit)

• Fix impl of _contentForTemplate. Add template-stamp tests. Fixes #4597 (commit)

• ensure latest closure, stay on polymer-build 1.1 until warnings can be ignored (commit)

• @mixes -> @appliesMixin (commit)

• @polymerMixin/@polymerMixinClass -> @mixinFunction/@mixinClass (commit)

• @PolymerElement -> @customElement/@Polymer (commit)

• fix lint error (commit)

• remove all "global this" warnings (commit)

• remove TemplateStamp’s implicit dependency on _initializeProperties (commit)

• fix typing for Polymer.Element (commit)

• inline cachingMixin into deduplicatingMixin (commit)

• initialize properties in _initializeProperties rather than constructor (allows work to be done before _initializeProperties and is needed for proto/instance property initialization . (commit)

• LegacyElementMixin to @unrestricted (commit)

• set isAttached constructor (for closure) but set to undefined so not picked up as proto property (avoids initial binding value) (commit)

• Fix dedupingMixin (commit)

• Fix more closure warnings (commit)

• Fix more closure warnings (commit)

• Fix more closure warnings. (commit)

• Fix more closure warnings. (commit)

• Fix more closure warnings. (commit)

• Fix more closure warnings. (commit)

• slighly better typing for mixin funcion (commit)

• gesture fixes (commit)

• Fix more closure warnings. (commit)

• Fix some closure warnings. (commit)

• Fix some closure warnings. (commit)

• automate generating closure externs (commit)

• Fix some closure warnings. (commit)

• fix some closure warnings. (commit)

Stable Release v1.9.2

Meaningful Changes

• For elements using disable-upgrade, the detached() callback should now only be called after the element has upgraded.

Raw Notes

• Update custom-style.html (commit)

• Add more tests. (commit)

• Avoid calling detached before an element is readied. When an element is readied, if attachment is pending only call attached if the element is actually attached. (commit)

• Fixes #4550. Ensure that detached cannot run before an element is “readied.” This fixes an issue that allowed an element with disable-upgrade to process the detached callback. (commit)

• Change dev version to 1.x (commit)

• [ci skip] Update CHANGELOG (commit)

Stable Release v2.0.1

Meaningful Changes

• Fix for data propagation issues and observers not firing when an element is stamped by <iron-list>

Raw Notes

• [ci skip] Prepare 2.0.1 (commit)

• Improve comment more (commit)

• Improve comment (commit)

• Add comment. (commit)

• • Improve clarity: change __dataInitialized to __dataReady
  • When _flushClients is called, ensure that clients are always enabled or flushed as appropriate. This ensures that (1) clients that are enabled before the host is enabled flush properly, and (2) clients that are stamped but not enabled properly enable when the host flushes. (commit)

• Fix typo in runBindingEffect documentation (commit)

• Fixes #4601. Client elements can be readied that have already enabled properties. This can happen when templatize is used to create instances with no properties. In this case, in order for properties to flush properly to clients, clients must be flushed. (commit)

• [ci skip] Update Changelog (commit)

Stable Release 2.0.0

Breaking & Meaningful Changes

• Please see https://www.polymer-project.org/2.0/docs/about_20 for all the new features, changes, and non-changes that Polymer 2.0 brings!

Raw Notes

• [ci skip] bump version to 2.0.0 (commit)

• [ci skip] Update Changelog (commit)

Preview Release v2.0.0-rc.9

Meaningful Changes

• Fix a bug where setting a property inside of a notification event listener and break the guarantee that clients should be ready before host side effects are processed
• Split _flushProperties into two functions
  • _enableProperties to set up property accessors on an element
  • _flushProperties now only handles batching changed properties to effects like observers
  • Neither function should need to be called by user code, but exist as override points for databinding

Raw Notes

• [skip ci] doc fixes (commit)

• Docs and slight renaming. (commit)

• Add tests. (commit)

• Move hostStack to property-effects and make readyClients explicit (commit)

• Turn on accessors (via __dataInitialized) only after clients have completely flushed. (commit)

• Adds _enableProperties as a new entry point that must be called to turn on properties. Prevents a bug where _readyClients can be called twice. (commit)

• [ci skip] Fix doc createPropertyEffect -> addPropertyEffect (commit)

• [ci skip] Update Changelog (commit)

Preview Release v2.0.0-rc.8

Meaningful Changes

• Remove disable-upgrade feature for 2.0 release
  • This feature is complicated to use in class-based elements, leading to "easy to write and hard to debug errors" in user code.
  • disable-upgrade may return in a a future minor release as a mixin or patch to customElements.define
• Fix warning logs for dyanmically bound functions
• Fix for observers firing before ready()
• Add new static API for creating property effects which mirror the instance versions
  • PropertyEffects.addPropertyEffect
  • PropertyEffects.createPropertyObserver
  • PropertyEffects.createMethodObserver
  • PropertyEffects.createNotifyingProperty
  • PropertyEffects.createReadOnlyProperty
  • PropertyEffects.createReflectedProperty
  • PropertyEffects.createComputedProperty
  • PropertyEffects.bindTemplate

Raw Notes

• Add test for boolean dynamicFn (commit)

• Accept boolean or object map for dynamicFns (commit)

• update dependencies for v1 polyfills (commit)

• Null the links when unbinding. (commit)

• Dedupe API docs. (commit)

• Move setup to suiteSetup (commit)

• Uncomment previous tests (commit)

• Add tests (commit)

• [ci skip] port gen-changelog from 1.x (commit)

• Add static API for creating property fx and minor code refactoring. (commit)

• [ci skip] remove bower.json version, add npm devDependencies & np publish config (commit)

• Fix comment. (commit)

• Fixes #4585. Data notifications do not flush host if host has not initialized clients. This preserves the Polymer 1.x guarantee that client dom is fully “readied” when data observers run. (commit)

• Ensure no warnings for dynamic fns. Fixes #4575 (commit)

• Corrected minor Method comments (commit)

• Removes the disable-upgrade feature from Polymer 2.0. Due to #4550, the feature has a flaw for native ES6 classes and would be better implemented as either a mixin or patch to customElements.define. (commit)

• Fix jsBin link. (commit)

• Ensure tags in markdown are backtracked. Short-term stopgap to ensure they are not rendered in HTML. (commit)

• Clean up gulpfile (commit)

• bump wct version (commit)

• Disabling lint-closure until the error count is driven to 0 (commit)

• fix test failures on safari 9 and chrome 41 w/focus event (commit)

• update debounce example. (commit)

• Fixes #4553, #4554 (commit)

• save closure warnings to "closure.log" file (commit)

• use shadycss externs directly, now only 498 warnings (commit)

• add gulp task to lint for closure warnings (commit)

Preview Release v2.0.0-rc.7

Meaningful Changes

• Fix linkPaths() to handle aliased paths
• Fix lazily-upgraded elements with bound properties on Safari

Raw Notes

• Add more tests. (commit)

• Update jsBin template for 2.0 (commit)

• [ci skip] Update link to jsBin template for 2.0. (commit)

• Move computeLinkedPaths out of hot path and into sync setter. (commit)

• [ci skip] Add note re: purpose of test (commit)

• Fix test for fallback _readyClients. Fixes #4547 (commit)

• Process paths regardless of accessor, & loop on computeLinkedPaths. Fixes #4542 (commit)