diff --git a/.gitignore b/.gitignore index 5c5054d4..cf60a901 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,6 @@ bower_components node_modules +!build/docs/node_modules *~ *# *.idea diff --git a/CHANGELOG.md b/CHANGELOG.md index b60642d2..85ee6ecf 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,29 @@ +# [v5.1.0](https://github.com/MyScript/myscript-math-web/tree/v5.1.0) + +## Features + +- Addition of a new Recognition Assets Builder API to dynamically build text lexicons and math grammars +- Ability to import JJIX Math content +- Style and decoration support in the JIIX exports +- New configuration options for a finer tuning of JIIX exports +- Always connected is now the default mode for better end user experience + +## Others + +- Udpdate Import jiix with math example + + + +# [v5.0.0](https://github.com/MyScript/myscript-math-web/tree/v5.0.0) + +## Features + +`myscript-math-web` now supports all the features introduced by the version [4.2.0 of MyScriptJS](https://github.com/MyScript/myscriptjs/tree/v4.2.0). + +## Breaking changes + +- We are now using Polymer 3. For more details, please refer to the [Polymer documentation](https://www.polymer-project.org/3.0/docs/about_30). + # [v4.1.1](https://github.com/MyScript/myscript-math-web/tree/v4.1.1) ## Bugs fixed diff --git a/README.md b/README.md index 149ace23..1b87b09f 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,23 @@ # MyScript Math Web + +[![npm version](https://badge.fury.io/js/myscript-math-web.svg)](https://badge.fury.io/js/myscript-math-web) +[![Published on Vaadin Directory](https://img.shields.io/badge/Vaadin%20Directory-published-00b4f0.svg)](https://vaadin.com/directory/component/MyScriptmyscript-math-web) +[![Stars on vaadin.com/directory](https://img.shields.io/vaadin-directory/star/MyScriptmyscript-math-web.svg)](https://vaadin.com/directory/component/MyScriptmyscript-math-web) +[![Published on webcomponents.org](https://img.shields.io/badge/webcomponents.org-published-blue.svg)](https://www.webcomponents.org/element/MyScript/myscript-math-web) +[![Examples](https://img.shields.io/badge/Link%20to-examples-blue.svg)](https://myscript.github.io/myscript-math-web/#/elements/myscript-math-web/demos/other-examples) +[![Documentation](https://img.shields.io/badge/Link%20to-documentation-green.svg)](https://developer.myscript.com/docs/interactive-ink/latest/web/web-components/math-element/) + +## :warning: This repository is archived :warning: +iinkJS grants you high integration flexibility by letting you choose your favorite framework or components. For this reason, we have decided to focus on iinkJS and to discontinue our ready-to-use Web components. + +For more information, please see [documentation](https://developer.myscript.com/). + +We also provide an example to integrate [iinkJS](https://github.com/MyScript/iinkJS) as webcomponent: [link](https://github.com/MyScript/web-integration-samples). + +
+ +:construction: + > The easy way to integrate mathematical expressions handwriting recognition in your web app.

@@ -29,9 +48,9 @@ It integrates all you need: If you're not familiar with MyScript and Interactive Ink, consider discovering its major features with our [math demo](http://webdemo.myscript.com/views/math.html). -You can find on our examples page a [simple example](https://myscript.github.io/myscript-math-web/components/myscript-math-web/#/elements/myscript-math-web/demos/get-started-[v4]) of `myscript-math-web`. +[Simple example](https://myscript.github.io/myscript-math-web/#/elements/myscript-math-web/demos/get-started-[v4]) of `myscript-math-web`. -We also provide several examples to show the features of `myscript-math-web`. Those examples can be found on our [examples page](https://myscript.github.io/myscript-math-web/components/myscript-math-web/#/elements/myscript-math-web/demos/other-examples) with the source codes in [this directory](https://github.com/MyScript/myscript-math-web/tree/master/examples). +[All our examples](https://myscript.github.io/myscript-math-web/#/elements/myscript-math-web/demos/other-examples) with the [source codes](https://github.com/MyScript/myscript-math-web/tree/master/src/demo-app/examples). ## Features @@ -49,37 +68,48 @@ You can discover all the math features on our [Developer website](https://develo ## Requirements -1. Have [bower](https://bower.io/#install-bower) installed. +1. Have [npm](https://www.npmjs.com/get-npm) or [yarn](https://yarnpkg.com/en/docs/install) installed. 2. Have a MyScript developer account. You can create one [here](https://dev.myscript.com/). 2. Get your keys and the free monthly quota to access MyScript Cloud at [developer.myscript.com](https://developer.myscript.com) ## Installation -1. Download myscript-math-web. +Use an existing project or start a fresh one. + +```shell +npm init +``` + +Install `myscript-math-web` and use it as showed in the [Usage](https://github.com/MyScript/myscript-math-web#usage) section. + ```shell -bower install myscript-math-web +npm install myscript-math-web ``` + ## Usage 1. Create an `index.html` file in the same directory. 2. Add the following lines in the `head` section to import the library and the webcomponents polyfill. + ```html - - + + ``` 3. Still in the `head` section, add the following style: + ```html ``` -4. Use the component in the `body` section with the keys you received by mail. +4. Use the component in the `body` section with the keys you received by mail. + ```html - - + + @@ -108,9 +139,10 @@ bower install myscript-math-web ``` -6. Launch a local Web server like the one below and open the page in your browser (at [0.0.0.0:8000](http://0.0.0.0:8000) if you used the one below) to start using it! +6. Launch a local Web server to start using it! We recommend to use the polymer one, you can find more information on the [Polymer website](https://www.polymer-project.org/3.0/start/install-3-0). + ``` -python -m SimpleHTTPServer +polymer serve ``` You can find this guide and a more complete example on the [MyScript Developer website](https://developer.myscript.com/docs/interactive-ink/latest/web/web-components/math-element/get-started/). @@ -126,7 +158,7 @@ You can find a complete documentation with the following sections on our Develop * **Export content**: [how to export your content](https://developer.myscript.com/docs/interactive-ink/latest/web/web-components/math-element/import-and-export/), * **Styling**: [how to style content](https://developer.myscript.com/docs/interactive-ink/latest/web/web-components/math-element/styling/). -We also provide a complete [API Reference](https://myscript.github.io/myscript-math-web/components/myscript-math-web/#/elements/myscript-math-web). +We also provide a complete [API Reference](https://myscript.github.io/myscript-math-web/#/elements/myscript-math-web). ## Getting support diff --git a/analysis.json b/analysis.json index 58e70fd7..f6c54f5f 100644 --- a/analysis.json +++ b/analysis.json @@ -4,7 +4,7 @@ { "description": "", "summary": "", - "path": "katex-component.html", + "path": "katex-component.js", "properties": [ { "name": "__dataClientsReady", @@ -12,14 +12,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1139, - "column": 8 + "line": 1090, + "column": 6 }, "end": { - "line": 1139, - "column": 32 + "line": 1090, + "column": 30 } }, "metadata": { @@ -27,7 +27,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__dataPendingClients", @@ -35,14 +35,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1141, - "column": 8 + "line": 1092, + "column": 6 }, "end": { - "line": 1141, - "column": 34 + "line": 1092, + "column": 32 } }, "metadata": { @@ -50,7 +50,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__dataToNotify", @@ -58,14 +58,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1143, - "column": 8 + "line": 1094, + "column": 6 }, "end": { - "line": 1143, - "column": 28 + "line": 1094, + "column": 26 } }, "metadata": { @@ -73,7 +73,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__dataLinkedPaths", @@ -81,14 +81,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1145, - "column": 8 + "line": 1096, + "column": 6 }, "end": { - "line": 1145, - "column": 31 + "line": 1096, + "column": 29 } }, "metadata": { @@ -96,7 +96,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__dataHasPaths", @@ -104,14 +104,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1147, - "column": 8 + "line": 1098, + "column": 6 }, "end": { - "line": 1147, - "column": 28 + "line": 1098, + "column": 26 } }, "metadata": { @@ -119,7 +119,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__dataCompoundStorage", @@ -127,14 +127,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1149, - "column": 8 + "line": 1100, + "column": 6 }, "end": { - "line": 1149, - "column": 35 + "line": 1100, + "column": 33 } }, "metadata": { @@ -142,7 +142,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__dataHost", @@ -150,14 +150,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1151, - "column": 8 + "line": 1102, + "column": 6 }, "end": { - "line": 1151, - "column": 24 + "line": 1102, + "column": 22 } }, "metadata": { @@ -165,7 +165,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__dataTemp", @@ -173,14 +173,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1153, - "column": 8 + "line": 1104, + "column": 6 }, "end": { - "line": 1153, - "column": 24 + "line": 1104, + "column": 22 } }, "metadata": { @@ -188,7 +188,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__dataClientsInitialized", @@ -196,14 +196,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1155, - "column": 8 + "line": 1106, + "column": 6 }, "end": { - "line": 1155, - "column": 38 + "line": 1106, + "column": 36 } }, "metadata": { @@ -211,7 +211,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__data", @@ -219,14 +219,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1157, - "column": 8 + "line": 1108, + "column": 6 }, "end": { - "line": 1157, - "column": 20 + "line": 1108, + "column": 18 } }, "metadata": { @@ -234,7 +234,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__dataPending", @@ -242,14 +242,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1159, - "column": 8 + "line": 1110, + "column": 6 }, "end": { - "line": 1159, - "column": 27 + "line": 1110, + "column": 25 } }, "metadata": { @@ -257,7 +257,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__dataOld", @@ -265,14 +265,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1161, - "column": 8 + "line": 1112, + "column": 6 }, "end": { - "line": 1161, - "column": 23 + "line": 1112, + "column": 21 } }, "metadata": { @@ -280,7 +280,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__computeEffects", @@ -288,14 +288,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1163, - "column": 8 + "line": 1114, + "column": 6 }, "end": { - "line": 1163, - "column": 30 + "line": 1114, + "column": 28 } }, "metadata": { @@ -303,7 +303,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__reflectEffects", @@ -311,14 +311,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1165, - "column": 8 + "line": 1116, + "column": 6 }, "end": { - "line": 1165, - "column": 30 + "line": 1116, + "column": 28 } }, "metadata": { @@ -326,7 +326,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__notifyEffects", @@ -334,14 +334,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1167, - "column": 8 + "line": 1118, + "column": 6 }, "end": { - "line": 1167, - "column": 29 + "line": 1118, + "column": 27 } }, "metadata": { @@ -349,7 +349,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__propagateEffects", @@ -357,14 +357,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1169, - "column": 8 + "line": 1120, + "column": 6 }, "end": { - "line": 1169, - "column": 32 + "line": 1120, + "column": 30 } }, "metadata": { @@ -372,7 +372,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__observeEffects", @@ -380,14 +380,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1171, - "column": 8 + "line": 1122, + "column": 6 }, "end": { - "line": 1171, - "column": 30 + "line": 1122, + "column": 28 } }, "metadata": { @@ -395,7 +395,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__readOnly", @@ -403,14 +403,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1173, - "column": 8 + "line": 1124, + "column": 6 }, "end": { - "line": 1173, - "column": 24 + "line": 1124, + "column": 22 } }, "metadata": { @@ -418,7 +418,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__templateInfo", @@ -426,14 +426,14 @@ "description": "", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1175, - "column": 8 + "line": 1126, + "column": 6 }, "end": { - "line": 1175, - "column": 28 + "line": 1126, + "column": 26 } }, "metadata": { @@ -441,7 +441,30 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" + }, + { + "name": "PROPERTY_EFFECT_TYPES", + "type": "?", + "description": "", + "privacy": "public", + "sourceRange": { + "file": "../@polymer/polymer/lib/mixins/property-effects.js", + "start": { + "line": 1129, + "column": 4 + }, + "end": { + "line": 1131, + "column": 5 + } + }, + "metadata": { + "polymer": { + "readOnly": true + } + }, + "inheritedFrom": "PropertyEffects" }, { "name": "_template", @@ -449,14 +472,14 @@ "description": "", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/element-mixin.html", + "file": "../@polymer/polymer/lib/mixins/element-mixin.js", "start": { - "line": 421, - "column": 8 + "line": 490, + "column": 6 }, "end": { - "line": 421, - "column": 23 + "line": 490, + "column": 21 } }, "metadata": { @@ -464,7 +487,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.ElementMixin" + "inheritedFrom": "ElementMixin" }, { "name": "_importPath", @@ -472,14 +495,14 @@ "description": "", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/element-mixin.html", + "file": "../@polymer/polymer/lib/mixins/element-mixin.js", "start": { - "line": 423, - "column": 8 + "line": 492, + "column": 6 }, "end": { - "line": 423, - "column": 25 + "line": 492, + "column": 23 } }, "metadata": { @@ -487,7 +510,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.ElementMixin" + "inheritedFrom": "ElementMixin" }, { "name": "rootPath", @@ -495,14 +518,14 @@ "description": "", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/element-mixin.html", + "file": "../@polymer/polymer/lib/mixins/element-mixin.js", "start": { - "line": 425, - "column": 8 + "line": 494, + "column": 6 }, "end": { - "line": 425, - "column": 22 + "line": 494, + "column": 20 } }, "metadata": { @@ -510,7 +533,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.ElementMixin" + "inheritedFrom": "ElementMixin" }, { "name": "importPath", @@ -518,14 +541,14 @@ "description": "", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/element-mixin.html", + "file": "../@polymer/polymer/lib/mixins/element-mixin.js", "start": { - "line": 427, - "column": 8 + "line": 496, + "column": 6 }, "end": { - "line": 427, - "column": 24 + "line": 496, + "column": 22 } }, "metadata": { @@ -533,22 +556,22 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.ElementMixin" + "inheritedFrom": "ElementMixin" }, { "name": "root", - "type": "(StampedTemplate|HTMLElement|ShadowRoot)", + "type": "(StampedTemplate | HTMLElement | ShadowRoot)", "description": "", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/element-mixin.html", + "file": "../@polymer/polymer/lib/mixins/element-mixin.js", "start": { - "line": 429, - "column": 8 + "line": 498, + "column": 6 }, "end": { - "line": 429, - "column": 18 + "line": 498, + "column": 16 } }, "metadata": { @@ -556,7 +579,7 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.ElementMixin" + "inheritedFrom": "ElementMixin" }, { "name": "$", @@ -564,14 +587,14 @@ "description": "", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/element-mixin.html", + "file": "../@polymer/polymer/lib/mixins/element-mixin.js", "start": { - "line": 431, - "column": 8 + "line": 500, + "column": 6 }, "end": { - "line": 431, - "column": 15 + "line": 500, + "column": 13 } }, "metadata": { @@ -579,27 +602,28 @@ "readOnly": false } }, - "inheritedFrom": "Polymer.ElementMixin" + "inheritedFrom": "ElementMixin" }, { "name": "value", - "type": "string", + "type": "string | null | undefined", "description": "", "privacy": "public", "sourceRange": { "start": { - "line": 987, - "column": 20 + "line": 988, + "column": 6 }, "end": { - "line": 992, - "column": 21 + "line": 993, + "column": 7 } }, "metadata": { "polymer": { "notify": true, - "observer": "\"_valueChanged\"" + "observer": "\"_valueChanged\"", + "attributeType": "String" } } } @@ -610,14 +634,14 @@ "description": "Stamps the provided template and performs instance-time setup for\nPolymer template features, including data bindings, declarative event\nlisteners, and the `this.$` map of `id`'s to nodes. A document fragment\nis returned containing the stamped DOM, ready for insertion into the\nDOM.\n\nThis method may be called more than once; however note that due to\n`shadycss` polyfill limitations, only styles from templates prepared\nusing `ShadyCSS.prepareTemplate` will be correctly polyfilled (scoped\nto the shadow root and support CSS custom properties), and note that\n`ShadyCSS.prepareTemplate` may only be called once per element. As such,\nany styles required by in runtime-stamped templates must be included\nin the main element template.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 2415, - "column": 6 + "line": 2416, + "column": 4 }, "end": { - "line": 2440, - "column": 7 + "line": 2441, + "column": 5 } }, "metadata": {}, @@ -632,28 +656,28 @@ "type": "!StampedTemplate", "desc": "Cloned template content" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_addMethodEventListenerToNode", "description": "Adds an event listener by method name for the event provided.\n\nThis method generates a handler function that looks up the method\nname at handling time.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/template-stamp.html", + "file": "../@polymer/polymer/lib/mixins/template-stamp.js", "start": { - "line": 452, - "column": 6 + "line": 454, + "column": 4 }, "end": { - "line": 457, - "column": 7 + "line": 459, + "column": 5 } }, "metadata": {}, "params": [ { "name": "node", - "type": "!Node", + "type": "!EventTarget", "description": "Node to add listener on" }, { @@ -676,28 +700,28 @@ "type": "Function", "desc": "Generated handler function" }, - "inheritedFrom": "Polymer.TemplateStamp" + "inheritedFrom": "TemplateStamp" }, { "name": "_addEventListenerToNode", "description": "Override point for adding custom or simulated event handling.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/template-stamp.html", + "file": "../@polymer/polymer/lib/mixins/template-stamp.js", "start": { - "line": 467, - "column": 6 + "line": 470, + "column": 4 }, "end": { - "line": 469, - "column": 7 + "line": 472, + "column": 5 } }, "metadata": {}, "params": [ { "name": "node", - "type": "!Node", + "type": "!EventTarget", "description": "Node to add event listener to" }, { @@ -714,28 +738,28 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.TemplateStamp" + "inheritedFrom": "TemplateStamp" }, { "name": "_removeEventListenerFromNode", "description": "Override point for adding custom or simulated event handling.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/template-stamp.html", + "file": "../@polymer/polymer/lib/mixins/template-stamp.js", "start": { - "line": 479, - "column": 6 + "line": 483, + "column": 4 }, "end": { - "line": 481, - "column": 7 + "line": 485, + "column": 5 } }, "metadata": {}, "params": [ { "name": "node", - "type": "Node", + "type": "!EventTarget", "description": "Node to remove event listener from" }, { @@ -752,21 +776,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.TemplateStamp" + "inheritedFrom": "TemplateStamp" }, { "name": "_createPropertyAccessor", "description": "Creates a setter/getter pair for the named property with its own\nlocal storage. The getter returns the value in the local storage,\nand the setter calls `_setProperty`, which updates the local storage\nfor the property and enqueues a `_propertiesChanged` callback.\n\nThis method may be called on a prototype or an instance. Calling\nthis method may overwrite a property value that already exists on\nthe prototype/instance by creating the accessor.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { "line": 106, - "column": 8 + "column": 4 }, "end": { "line": 115, - "column": 9 + "column": 5 } }, "metadata": {}, @@ -785,21 +809,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "_addPropertyToAttributeMap", "description": "Adds the given `property` to a map matching attribute names\nto property names, using `attributeNameForProperty`. This map is\nused when deserializing attribute values to properties.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 124, - "column": 8 + "line": 125, + "column": 4 }, "end": { - "line": 132, - "column": 9 + "line": 133, + "column": 5 } }, "metadata": {}, @@ -810,21 +834,24 @@ "description": "Name of the property" } ], - "inheritedFrom": "Polymer.PropertiesChanged" + "return": { + "type": "void" + }, + "inheritedFrom": "PropertiesChanged" }, { "name": "_definePropertyAccessor", "description": "Defines a property accessor for the given property.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 140, - "column": 9 + "line": 142, + "column": 5 }, "end": { - "line": 153, - "column": 9 + "line": 155, + "column": 5 } }, "metadata": {}, @@ -843,21 +870,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "ready", "description": "Stamps the element template.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/element-mixin.html", + "file": "../@polymer/polymer/lib/mixins/element-mixin.js", "start": { - "line": 540, - "column": 6 + "line": 608, + "column": 4 }, "end": { - "line": 546, - "column": 7 + "line": 614, + "column": 5 } }, "metadata": {}, @@ -865,21 +892,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.ElementMixin" + "inheritedFrom": "ElementMixin" }, { "name": "_initializeProperties", - "description": "Overrides the default `Polymer.PropertyAccessors` to ensure class\nmetaprogramming related to property accessors and effects has\ncompleted (calls `finalize`).\n\nIt also initializes any property defaults provided via `value` in\n`properties` metadata.", + "description": "Overrides the default `PropertyAccessors` to ensure class\nmetaprogramming related to property accessors and effects has\ncompleted (calls `finalize`).\n\nIt also initializes any property defaults provided via `value` in\n`properties` metadata.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/element-mixin.html", + "file": "../@polymer/polymer/lib/mixins/element-mixin.js", "start": { - "line": 446, - "column": 6 + "line": 515, + "column": 4 }, "end": { - "line": 480, - "column": 7 + "line": 548, + "column": 5 } }, "metadata": {}, @@ -887,21 +914,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.ElementMixin" + "inheritedFrom": "ElementMixin" }, { "name": "_initializeInstanceProperties", "description": "Called at ready time with bag of instance properties that overwrote\naccessors when the element upgraded.\n\nThe default implementation sets these properties back into the\nsetter at ready time. This method is provided as an override\npoint for customizing or providing more efficient initialization.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 222, - "column": 8 + "line": 227, + "column": 4 }, "end": { - "line": 224, - "column": 9 + "line": 229, + "column": 5 } }, "metadata": {}, @@ -915,21 +942,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "_setProperty", "description": "Updates the local storage for a property (via `_setPendingProperty`)\nand enqueues a `_proeprtiesChanged` callback.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 235, - "column": 8 + "line": 241, + "column": 4 }, "end": { - "line": 239, - "column": 9 + "line": 245, + "column": 5 } }, "metadata": {}, @@ -948,21 +975,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "_getProperty", "description": "Returns the value for the given property.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 247, - "column": 8 + "line": 254, + "column": 4 }, "end": { - "line": 249, - "column": 9 + "line": 256, + "column": 5 } }, "metadata": {}, @@ -977,21 +1004,21 @@ "type": "*", "desc": "Value for the given property" }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "_setPendingProperty", "description": "Updates the local storage for a property, records the previous value,\nand adds it to the set of \"pending changes\" that will be passed to the\n`_propertiesChanged` callback. This method does not enqueue the\n`_propertiesChanged` callback.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 264, - "column": 8 + "line": 272, + "column": 4 }, "end": { - "line": 280, - "column": 9 + "line": 288, + "column": 5 } }, "metadata": {}, @@ -1016,21 +1043,21 @@ "type": "boolean", "desc": "Returns true if the property changed" }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "_invalidateProperties", "description": "Marks the properties as invalid, and enqueues an async\n`_propertiesChanged` callback.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 290, - "column": 8 + "line": 299, + "column": 4 }, "end": { - "line": 300, - "column": 9 + "line": 309, + "column": 5 } }, "metadata": {}, @@ -1038,21 +1065,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "_enableProperties", "description": "Call to enable property accessor processing. Before this method is\ncalled accessor values will be set but side effects are\nqueued. When called, any pending side effects occur immediately.\nFor elements, generally `connectedCallback` is a normal spot to do so.\nIt is safe to call this method multiple times as it only turns on\nproperty accessors once.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 313, - "column": 8 + "line": 323, + "column": 4 }, "end": { - "line": 322, - "column": 9 + "line": 332, + "column": 5 } }, "metadata": {}, @@ -1060,21 +1087,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "_flushProperties", "description": "Calls the `_propertiesChanged` callback with the current set of\npending changes (and old values recorded when pending changes were\nset), and resets the pending set of changes. Generally, this method\nshould not be called in user code.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 333, - "column": 8 + "line": 344, + "column": 4 }, "end": { - "line": 339, - "column": 9 + "line": 353, + "column": 5 } }, "metadata": {}, @@ -1082,21 +1109,60 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" + }, + { + "name": "_shouldPropertiesChange", + "description": "Called in `_flushProperties` to determine if `_propertiesChanged`\nshould be called. The default implementation returns true if\nproperties are pending. Override to customize when\n`_propertiesChanged` is called.", + "privacy": "protected", + "sourceRange": { + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", + "start": { + "line": 368, + "column": 4 + }, + "end": { + "line": 370, + "column": 5 + } + }, + "metadata": {}, + "params": [ + { + "name": "currentProps", + "type": "!Object", + "description": "Bag of all current accessor values" + }, + { + "name": "changedProps", + "type": "?Object", + "description": "Bag of properties changed since the last\n call to `_propertiesChanged`" + }, + { + "name": "oldProps", + "type": "?Object", + "description": "Bag of previous values for each property\n in `changedProps`" + } + ], + "return": { + "type": "boolean", + "desc": "true if changedProps is truthy" + }, + "inheritedFrom": "PropertiesChanged" }, { "name": "_propertiesChanged", "description": "Callback called when any properties with accessors created via\n`_createPropertyAccessor` have been set.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 353, - "column": 8 + "line": 385, + "column": 4 }, "end": { - "line": 354, - "column": 9 + "line": 386, + "column": 5 } }, "metadata": {}, @@ -1108,33 +1174,33 @@ }, { "name": "changedProps", - "type": "!Object", + "type": "?Object", "description": "Bag of properties changed since the last\n call to `_propertiesChanged`" }, { "name": "oldProps", - "type": "!Object", + "type": "?Object", "description": "Bag of previous values for each property\n in `changedProps`" } ], "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "_shouldPropertyChange", "description": "Method called to determine whether a property value should be\nconsidered as a change and cause the `_propertiesChanged` callback\nto be enqueued.\n\nThe default implementation returns `true` if a strict equality\ncheck fails. The method always returns false for `NaN`.\n\nOverride this method to e.g. provide stricter checking for\nObjects/Arrays when using immutable patterns.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 374, - "column": 8 + "line": 407, + "column": 4 }, "end": { - "line": 381, - "column": 9 + "line": 414, + "column": 5 } }, "metadata": {}, @@ -1159,21 +1225,21 @@ "type": "boolean", "desc": "Whether the property should be considered a change\n and enqueue a `_proeprtiesChanged` callback" }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "attributeChangedCallback", "description": "Implements native Custom Elements `attributeChangedCallback` to\nset an attribute value to a property via `_attributeToProperty`.", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 393, - "column": 8 + "line": 428, + "column": 4 }, "end": { - "line": 400, - "column": 9 + "line": 435, + "column": 5 } }, "metadata": {}, @@ -1192,26 +1258,31 @@ "name": "value", "type": "?string", "description": "New attribute value" + }, + { + "name": "namespace", + "type": "?string", + "description": "Attribute namespace." } ], "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "_attributeToProperty", "description": "Deserializes an attribute to its associated property.\n\nThis method calls the `_deserializeValue` method to convert the string to\na typed value.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 414, - "column": 8 + "line": 450, + "column": 4 }, "end": { - "line": 421, - "column": 9 + "line": 457, + "column": 5 } }, "metadata": {}, @@ -1235,21 +1306,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "_propertyToAttribute", "description": "Serializes a property to its associated attribute.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 433, - "column": 8 + "line": 470, + "column": 4 }, "end": { - "line": 439, - "column": 9 + "line": 476, + "column": 5 } }, "metadata": {}, @@ -1273,21 +1344,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "_valueToNodeAttribute", "description": "Sets a typed value to an HTML attribute on a node.\n\nThis method calls the `_serializeValue` method to convert the typed\nvalue to a string. If the `_serializeValue` method returns `undefined`,\nthe attribute will be removed (this is the default for boolean\ntype `false`).", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 454, - "column": 8 + "line": 492, + "column": 4 }, "end": { - "line": 461, - "column": 9 + "line": 499, + "column": 5 } }, "metadata": {}, @@ -1311,21 +1382,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "_serializeValue", "description": "Converts a typed JavaScript value to a string.\n\nThis method is called when setting JS property values to\nHTML attributes. Users may override this method to provide\nserialization for custom types.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 474, - "column": 8 + "line": 513, + "column": 4 }, "end": { - "line": 481, - "column": 9 + "line": 520, + "column": 5 } }, "metadata": {}, @@ -1337,24 +1408,24 @@ } ], "return": { - "type": "(string|undefined)", + "type": "(string | undefined)", "desc": "String serialized from the provided\nproperty value." }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "_deserializeValue", "description": "Converts a string to a typed JavaScript value.\n\nThis method is called when reading HTML attribute values to\nJS properties. Users may override this method to provide\ndeserialization for custom `type`s. Types for `Boolean`, `String`,\nand `Number` convert attributes to the expected types.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-changed.html", + "file": "../@polymer/polymer/lib/mixins/properties-changed.js", "start": { - "line": 495, - "column": 8 + "line": 535, + "column": 4 }, "end": { - "line": 504, - "column": 9 + "line": 544, + "column": 5 } }, "metadata": {}, @@ -1374,21 +1445,21 @@ "type": "*", "desc": "Typed value deserialized from the provided string." }, - "inheritedFrom": "Polymer.PropertiesChanged" + "inheritedFrom": "PropertiesChanged" }, { "name": "_initializeProtoProperties", - "description": "Overrides `Polymer.PropertyAccessors` implementation to provide a\nmore efficient implementation of initializing properties from\nthe prototype on the instance.", + "description": "Overrides `PropertyAccessors` implementation to provide a\nmore efficient implementation of initializing properties from\nthe prototype on the instance.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1209, - "column": 6 + "line": 1160, + "column": 4 }, "end": { - "line": 1213, - "column": 7 + "line": 1164, + "column": 5 } }, "metadata": {}, @@ -1402,21 +1473,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_ensureAttribute", "description": "Ensures the element has the given attribute. If it does not,\nassigns the given value to the attribute.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-accessors.html", + "file": "../@polymer/polymer/lib/mixins/property-accessors.js", "start": { - "line": 192, - "column": 6 + "line": 185, + "column": 4 }, "end": { - "line": 197, - "column": 7 + "line": 190, + "column": 5 } }, "metadata": {}, @@ -1435,21 +1506,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyAccessors" + "inheritedFrom": "PropertyAccessors" }, { "name": "_hasAccessor", "description": "Returns true if this library created an accessor for the given property.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-accessors.html", + "file": "../@polymer/polymer/lib/mixins/property-accessors.js", "start": { - "line": 299, - "column": 6 + "line": 292, + "column": 4 }, "end": { - "line": 301, - "column": 7 + "line": 294, + "column": 5 } }, "metadata": {}, @@ -1464,21 +1535,21 @@ "type": "boolean", "desc": "True if an accessor was created" }, - "inheritedFrom": "Polymer.PropertyAccessors" + "inheritedFrom": "PropertyAccessors" }, { "name": "_isPropertyPending", "description": "Returns true if the specified property has a pending change.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-accessors.html", + "file": "../@polymer/polymer/lib/mixins/property-accessors.js", "start": { - "line": 310, - "column": 6 + "line": 303, + "column": 4 }, "end": { - "line": 312, - "column": 7 + "line": 305, + "column": 5 } }, "metadata": {}, @@ -1493,21 +1564,21 @@ "type": "boolean", "desc": "True if property has a pending change" }, - "inheritedFrom": "Polymer.PropertyAccessors" + "inheritedFrom": "PropertyAccessors" }, { "name": "_addPropertyEffect", "description": "Equivalent to static `addPropertyEffect` API but can be called on\nan instance to add effects at runtime. See that method for\nfull API docs.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1247, - "column": 6 + "line": 1198, + "column": 4 }, "end": { - "line": 1255, - "column": 7 + "line": 1206, + "column": 5 } }, "metadata": {}, @@ -1531,21 +1602,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_removePropertyEffect", "description": "Removes the given property effect.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1265, - "column": 6 + "line": 1216, + "column": 4 }, "end": { - "line": 1271, - "column": 7 + "line": 1222, + "column": 5 } }, "metadata": {}, @@ -1569,21 +1640,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_hasPropertyEffect", "description": "Returns whether the current prototype/instance has a property effect\nof a certain type.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1282, - "column": 6 + "line": 1233, + "column": 4 }, "end": { - "line": 1285, - "column": 7 + "line": 1236, + "column": 5 } }, "metadata": {}, @@ -1603,21 +1674,21 @@ "type": "boolean", "desc": "True if the prototype/instance has an effect of this type" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_hasReadOnlyEffect", "description": "Returns whether the current prototype/instance has a \"read only\"\naccessor for the given property.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1295, - "column": 6 + "line": 1246, + "column": 4 }, "end": { - "line": 1297, - "column": 7 + "line": 1248, + "column": 5 } }, "metadata": {}, @@ -1632,21 +1703,21 @@ "type": "boolean", "desc": "True if the prototype/instance has an effect of this type" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_hasNotifyEffect", "description": "Returns whether the current prototype/instance has a \"notify\"\nproperty effect for the given property.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1307, - "column": 6 + "line": 1258, + "column": 4 }, "end": { - "line": 1309, - "column": 7 + "line": 1260, + "column": 5 } }, "metadata": {}, @@ -1661,21 +1732,21 @@ "type": "boolean", "desc": "True if the prototype/instance has an effect of this type" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_hasReflectEffect", "description": "Returns whether the current prototype/instance has a \"reflect to attribute\"\nproperty effect for the given property.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1319, - "column": 6 + "line": 1270, + "column": 4 }, "end": { - "line": 1321, - "column": 7 + "line": 1272, + "column": 5 } }, "metadata": {}, @@ -1690,21 +1761,21 @@ "type": "boolean", "desc": "True if the prototype/instance has an effect of this type" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_hasComputedEffect", "description": "Returns whether the current prototype/instance has a \"computed\"\nproperty effect for the given property.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1331, - "column": 6 + "line": 1282, + "column": 4 }, "end": { - "line": 1333, - "column": 7 + "line": 1284, + "column": 5 } }, "metadata": {}, @@ -1719,28 +1790,28 @@ "type": "boolean", "desc": "True if the prototype/instance has an effect of this type" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_setPendingPropertyOrPath", "description": "Sets a pending property or path. If the root property of the path in\nquestion had no accessor, the path is set, otherwise it is enqueued\nvia `_setPendingProperty`.\n\nThis function isolates relatively expensive functionality necessary\nfor the public API (`set`, `setProperties`, `notifyPath`, and property\nchange listeners via {{...}} bindings), such that it is only done\nwhen paths enter the system, and not at every propagation step. It\nalso sets a `__dataHasPaths` flag on the instance which is used to\nfast-path slower path-matching code in the property effects host paths.\n\n`path` can be a path string or array of path parts as accepted by the\npublic API.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1365, - "column": 6 + "line": 1316, + "column": 4 }, "end": { - "line": 1397, - "column": 7 + "line": 1348, + "column": 5 } }, "metadata": {}, "params": [ { "name": "path", - "type": "(string|!Array.<(number|string)>)", + "type": "(string | !Array.<(number | string)>)", "description": "Path to set" }, { @@ -1763,21 +1834,21 @@ "type": "boolean", "desc": "Returns true if the property/path was enqueued in\n the pending changes bag." }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_setUnmanagedPropertyToNode", "description": "Applies a value to a non-Polymer element/node's property.\n\nThe implementation makes a best-effort at binding interop:\nSome native element properties have side-effects when\nre-setting the same value (e.g. setting `.value` resets the\ncursor position), so we do a dirty-check before setting the value.\nHowever, for better interop with non-Polymer custom elements that\naccept objects, we explicitly re-set object changes coming from the\nPolymer world (which may include deep object changes without the\ntop reference changing), erring on the side of providing more\ninformation.\n\nUsers may override this method to provide alternate approaches.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1420, - "column": 6 + "line": 1371, + "column": 4 }, "end": { - "line": 1428, - "column": 7 + "line": 1379, + "column": 5 } }, "metadata": {}, @@ -1801,21 +1872,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_enqueueClient", "description": "Enqueues the given client on a list of pending clients, whose\npending property changes can later be flushed via a call to\n`_flushClients`.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1535, - "column": 6 + "line": 1486, + "column": 4 }, "end": { - "line": 1540, - "column": 7 + "line": 1491, + "column": 5 } }, "metadata": {}, @@ -1829,21 +1900,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_flushClients", "description": "Flushes any clients previously enqueued via `_enqueueClient`, causing\ntheir `_flushProperties` method to run.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1561, - "column": 6 + "line": 1512, + "column": 4 }, "end": { - "line": 1572, - "column": 7 + "line": 1523, + "column": 5 } }, "metadata": {}, @@ -1851,40 +1922,43 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "__enableOrFlushClients", "description": "(c) the stamped dom enables.", "privacy": "private", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1586, - "column": 6 + "line": 1537, + "column": 4 }, "end": { - "line": 1599, - "column": 7 + "line": 1550, + "column": 5 } }, "metadata": {}, "params": [], - "inheritedFrom": "Polymer.PropertyEffects" + "return": { + "type": "void" + }, + "inheritedFrom": "PropertyEffects" }, { "name": "_readyClients", "description": "Implements `PropertyEffects`'s `_readyClients` call. Attaches\nelement dom by calling `_attachDom` with the dom stamped from the\nelement's template via `_stampTemplate`. Note that this allows\nclient dom to be attached to the element prior to any observers\nrunning.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/element-mixin.html", + "file": "../@polymer/polymer/lib/mixins/element-mixin.js", "start": { - "line": 558, - "column": 6 + "line": 626, + "column": 4 }, "end": { - "line": 567, - "column": 7 + "line": 635, + "column": 5 } }, "metadata": {}, @@ -1892,21 +1966,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.ElementMixin" + "inheritedFrom": "ElementMixin" }, { "name": "setProperties", "description": "Sets a bag of property changes to this instance, and\nsynchronously processes all effects of the properties as a batch.\n\nProperty names must be simple properties, not paths. Batched\npath propagation is not supported.", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1628, - "column": 6 + "line": 1579, + "column": 4 }, "end": { - "line": 1639, - "column": 7 + "line": 1590, + "column": 5 } }, "metadata": {}, @@ -1925,21 +1999,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_propagatePropertyChanges", "description": "Called to propagate any property changes to stamped template nodes\nmanaged by this element.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1726, - "column": 6 + "line": 1677, + "column": 4 }, "end": { - "line": 1736, - "column": 7 + "line": 1687, + "column": 5 } }, "metadata": {}, @@ -1963,82 +2037,82 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "linkPaths", "description": "Aliases one data path as another, such that path notifications from one\nare routed to the other.", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1747, - "column": 6 + "line": 1698, + "column": 4 }, "end": { - "line": 1752, - "column": 7 + "line": 1703, + "column": 5 } }, "metadata": {}, "params": [ { "name": "to", - "type": "(string|!Array.<(string|number)>)", + "type": "(string | !Array.<(string | number)>)", "description": "Target path to link." }, { "name": "from", - "type": "(string|!Array.<(string|number)>)", + "type": "(string | !Array.<(string | number)>)", "description": "Source path to link." } ], "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "unlinkPaths", "description": "Removes a data path alias previously established with `_linkPaths`.\n\nNote, the path to unlink should be the target (`to`) used when\nlinking the paths.", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1764, - "column": 6 + "line": 1715, + "column": 4 }, "end": { - "line": 1769, - "column": 7 + "line": 1720, + "column": 5 } }, "metadata": {}, "params": [ { "name": "path", - "type": "(string|!Array.<(string|number)>)", + "type": "(string | !Array.<(string | number)>)", "description": "Target path to unlink." } ], "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "notifySplices", "description": "Notify that an array has changed.\n\nExample:\n\n this.items = [ {name: 'Jim'}, {name: 'Todd'}, {name: 'Bill'} ];\n ...\n this.items.splice(1, 1, {name: 'Sam'});\n this.items.push({name: 'Bob'});\n this.notifySplices('items', [\n { index: 1, removed: [{name: 'Todd'}], addedCount: 1, object: this.items, type: 'splice' },\n { index: 3, removed: [], addedCount: 1, object: this.items, type: 'splice'}\n ]);", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1801, - "column": 6 + "line": 1752, + "column": 4 }, "end": { - "line": 1805, - "column": 7 + "line": 1756, + "column": 5 } }, "metadata": {}, @@ -2057,28 +2131,28 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "get", "description": "Convenience method for reading a value from a path.\n\nNote, if any part in the path is undefined, this method returns\n`undefined` (this method does not throw when dereferencing undefined\npaths).", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1826, - "column": 6 + "line": 1777, + "column": 4 }, "end": { - "line": 1828, - "column": 7 + "line": 1779, + "column": 5 } }, "metadata": {}, "params": [ { "name": "path", - "type": "(string|!Array.<(string|number)>)", + "type": "(string | !Array.<(string | number)>)", "description": "Path to the value\n to read. The path may be specified as a string (e.g. `foo.bar.baz`)\n or an array of path parts (e.g. `['foo.bar', 'baz']`). Note that\n bracketed expressions are not supported; string-based path parts\n *must* be separated by dots. Note that when dereferencing array\n indices, the index may be used as a dotted part directly\n (e.g. `users.12.name` or `['users', 12, 'name']`)." }, { @@ -2091,28 +2165,28 @@ "type": "*", "desc": "Value at the path, or `undefined` if any part of the path\n is undefined." }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "set", "description": "Convenience method for setting a value to a path and notifying any\nelements bound to the same path.\n\nNote, if any part in the path except for the last is undefined,\nthis method does nothing (this method does not throw when\ndereferencing undefined paths).", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1851, - "column": 6 + "line": 1802, + "column": 4 }, "end": { - "line": 1861, - "column": 7 + "line": 1812, + "column": 5 } }, "metadata": {}, "params": [ { "name": "path", - "type": "(string|!Array.<(string|number)>)", + "type": "(string | !Array.<(string | number)>)", "description": "Path to the value\n to write. The path may be specified as a string (e.g. `'foo.bar.baz'`)\n or an array of path parts (e.g. `['foo.bar', 'baz']`). Note that\n bracketed expressions are not supported; string-based path parts\n *must* be separated by dots. Note that when dereferencing array\n indices, the index may be used as a dotted part directly\n (e.g. `'users.12.name'` or `['users', 12, 'name']`)." }, { @@ -2129,60 +2203,63 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "push", "description": "Adds items onto the end of the array at the path specified.\n\nThe arguments after `path` and return value match that of\n`Array.prototype.push`.\n\nThis method notifies other paths to the same array that a\nsplice occurred to the array.", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1877, - "column": 6 + "line": 1828, + "column": 4 }, "end": { - "line": 1886, - "column": 7 + "line": 1837, + "column": 5 } }, "metadata": {}, "params": [ { "name": "path", - "type": "(string|!Array.<(string|number)>)", + "type": "(string | !Array.<(string | number)>)", "description": "Path to array." }, { - "name": "...items" + "name": "items", + "type": "...*", + "rest": true, + "description": "Items to push onto array" } ], "return": { "type": "number", "desc": "New length of the array." }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "pop", "description": "Removes an item from the end of array at the path specified.\n\nThe arguments after `path` and return value match that of\n`Array.prototype.pop`.\n\nThis method notifies other paths to the same array that a\nsplice occurred to the array.", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1901, - "column": 6 + "line": 1852, + "column": 4 }, "end": { - "line": 1910, - "column": 7 + "line": 1861, + "column": 5 } }, "metadata": {}, "params": [ { "name": "path", - "type": "(string|!Array.<(string|number)>)", + "type": "(string | !Array.<(string | number)>)", "description": "Path to array." } ], @@ -2190,28 +2267,28 @@ "type": "*", "desc": "Item that was removed." }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "splice", "description": "Starting from the start index specified, removes 0 or more items\nfrom the array and inserts 0 or more new items in their place.\n\nThe arguments after `path` and return value match that of\n`Array.prototype.splice`.\n\nThis method notifies other paths to the same array that a\nsplice occurred to the array.", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1929, - "column": 6 + "line": 1880, + "column": 4 }, "end": { - "line": 1966, - "column": 7 + "line": 1917, + "column": 5 } }, "metadata": {}, "params": [ { "name": "path", - "type": "(string|!Array.<(string|number)>)", + "type": "(string | !Array.<(string | number)>)", "description": "Path to array." }, { @@ -2221,39 +2298,42 @@ }, { "name": "deleteCount", - "type": "number", + "type": "number=", "description": "Number of items to remove." }, { - "name": "...items" + "name": "items", + "type": "...*", + "rest": true, + "description": "Items to insert into array." } ], "return": { "type": "Array", "desc": "Array of removed items." }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "shift", "description": "Removes an item from the beginning of array at the path specified.\n\nThe arguments after `path` and return value match that of\n`Array.prototype.pop`.\n\nThis method notifies other paths to the same array that a\nsplice occurred to the array.", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 1981, - "column": 6 + "line": 1932, + "column": 4 }, "end": { - "line": 1990, - "column": 7 + "line": 1941, + "column": 5 } }, "metadata": {}, "params": [ { "name": "path", - "type": "(string|!Array.<(string|number)>)", + "type": "(string | !Array.<(string | number)>)", "description": "Path to array." } ], @@ -2261,53 +2341,56 @@ "type": "*", "desc": "Item that was removed." }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "unshift", "description": "Adds items onto the beginning of the array at the path specified.\n\nThe arguments after `path` and return value match that of\n`Array.prototype.push`.\n\nThis method notifies other paths to the same array that a\nsplice occurred to the array.", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 2006, - "column": 6 + "line": 1957, + "column": 4 }, "end": { - "line": 2014, - "column": 7 + "line": 1965, + "column": 5 } }, "metadata": {}, "params": [ { "name": "path", - "type": "(string|!Array.<(string|number)>)", + "type": "(string | !Array.<(string | number)>)", "description": "Path to array." }, { - "name": "...items" + "name": "items", + "type": "...*", + "rest": true, + "description": "Items to insert info array" } ], "return": { "type": "number", "desc": "New length of the array." }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "notifyPath", "description": "Notify that a path has changed.\n\nExample:\n\n this.item.user.name = 'Bob';\n this.notifyPath('item.user.name');", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 2029, - "column": 6 + "line": 1980, + "column": 4 }, "end": { - "line": 2046, - "column": 7 + "line": 1997, + "column": 5 } }, "metadata": {}, @@ -2326,21 +2409,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_createReadOnlyProperty", "description": "Equivalent to static `createReadOnlyProperty` API but can be called on\nan instance to add effects at runtime. See that method for\nfull API docs.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 2059, - "column": 6 + "line": 2010, + "column": 4 }, "end": { - "line": 2066, - "column": 7 + "line": 2017, + "column": 5 } }, "metadata": {}, @@ -2359,21 +2442,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_createPropertyObserver", "description": "Equivalent to static `createPropertyObserver` API but can be called on\nan instance to add effects at runtime. See that method for\nfull API docs.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 2080, - "column": 6 + "line": 2031, + "column": 4 }, "end": { - "line": 2090, - "column": 7 + "line": 2041, + "column": 5 } }, "metadata": {}, @@ -2385,7 +2468,7 @@ }, { "name": "method", - "type": "(string|function (*, *))", + "type": "(string | function (*, *))", "description": "Function or name of observer method to call" }, { @@ -2397,21 +2480,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_createMethodObserver", "description": "Equivalent to static `createMethodObserver` API but can be called on\nan instance to add effects at runtime. See that method for\nfull API docs.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 2103, - "column": 6 + "line": 2054, + "column": 4 }, "end": { - "line": 2109, - "column": 7 + "line": 2060, + "column": 5 } }, "metadata": {}, @@ -2423,28 +2506,28 @@ }, { "name": "dynamicFn", - "type": "(boolean|Object)=", + "type": "(boolean | Object)=", "description": "Boolean or object map indicating\n whether method names should be included as a dependency to the effect." } ], "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_createNotifyingProperty", "description": "Equivalent to static `createNotifyingProperty` API but can be called on\nan instance to add effects at runtime. See that method for\nfull API docs.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 2120, - "column": 6 + "line": 2071, + "column": 4 }, "end": { - "line": 2128, - "column": 7 + "line": 2079, + "column": 5 } }, "metadata": {}, @@ -2458,21 +2541,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_createReflectedProperty", "description": "Equivalent to static `createReflectedProperty` API but can be called on\nan instance to add effects at runtime. See that method for\nfull API docs.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 2139, - "column": 6 + "line": 2090, + "column": 4 }, "end": { - "line": 2152, - "column": 7 + "line": 2103, + "column": 5 } }, "metadata": {}, @@ -2486,21 +2569,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_createComputedProperty", "description": "Equivalent to static `createComputedProperty` API but can be called on\nan instance to add effects at runtime. See that method for\nfull API docs.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 2166, - "column": 6 + "line": 2117, + "column": 4 }, "end": { - "line": 2172, - "column": 7 + "line": 2123, + "column": 5 } }, "metadata": {}, @@ -2517,28 +2600,67 @@ }, { "name": "dynamicFn", - "type": "(boolean|Object)=", + "type": "(boolean | Object)=", "description": "Boolean or object map indicating\n whether method names should be included as a dependency to the effect." } ], "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" + }, + { + "name": "_marshalArgs", + "description": "Gather the argument values for a method specified in the provided array\nof argument metadata.\n\nThe `path` and `value` arguments are used to fill in wildcard descriptor\nwhen the method is being called as a result of a path notification.", + "privacy": "private", + "sourceRange": { + "file": "../@polymer/polymer/lib/mixins/property-effects.js", + "start": { + "line": 2138, + "column": 4 + }, + "end": { + "line": 2173, + "column": 5 + } + }, + "metadata": {}, + "params": [ + { + "name": "args", + "type": "!Array.", + "description": "Array of argument metadata" + }, + { + "name": "path", + "type": "string", + "description": "Property/path name that triggered the method effect" + }, + { + "name": "props", + "type": "Object", + "description": "Bag of current property changes" + } + ], + "return": { + "type": "Array.<*>", + "desc": "Array of argument values" + }, + "inheritedFrom": "PropertyEffects" }, { "name": "_bindTemplate", "description": "Equivalent to static `bindTemplate` API but can be called on\nan instance to add effects at runtime. See that method for\nfull API docs.\n\nThis method may be called on the prototype (for prototypical template\nbinding, to avoid creating accessors every instance) once per prototype,\nand will be called with `runtimeBinding: true` by `_stampTemplate` to\ncreate and link an instance of the template metadata associated with a\nparticular stamping.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 2349, - "column": 6 + "line": 2350, + "column": 4 }, "end": { - "line": 2372, - "column": 7 + "line": 2373, + "column": 5 } }, "metadata": {}, @@ -2558,21 +2680,21 @@ "type": "!TemplateInfo", "desc": "Template metadata object; for `runtimeBinding`,\n this is an instance of the prototypical template info" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "_removeBoundDom", "description": "Removes and unbinds the nodes previously contained in the provided\nDocumentFragment returned from `_stampTemplate`.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/property-effects.html", + "file": "../@polymer/polymer/lib/mixins/property-effects.js", "start": { - "line": 2451, - "column": 6 + "line": 2452, + "column": 4 }, "end": { - "line": 2472, - "column": 7 + "line": 2473, + "column": 5 } }, "metadata": {}, @@ -2586,7 +2708,7 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertyEffects" + "inheritedFrom": "PropertyEffects" }, { "name": "connectedCallback", @@ -2594,30 +2716,33 @@ "privacy": "public", "sourceRange": { "start": { - "line": 996, - "column": 12 + "line": 997, + "column": 2 }, "end": { - "line": 999, - "column": 13 + "line": 1000, + "column": 3 } }, "metadata": {}, - "params": [] + "params": [], + "return": { + "type": "void" + } }, { "name": "disconnectedCallback", "description": "Called when the element is removed from a document", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/properties-mixin.html", + "file": "../@polymer/polymer/lib/mixins/properties-mixin.js", "start": { - "line": 215, - "column": 6 + "line": 216, + "column": 3 }, "end": { - "line": 219, - "column": 7 + "line": 220, + "column": 4 } }, "metadata": {}, @@ -2625,21 +2750,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.PropertiesMixin" + "inheritedFrom": "PropertiesMixin" }, { "name": "_attachDom", "description": "Attaches an element's stamped dom to itself. By default,\nthis method creates a `shadowRoot` and adds the dom to it.\nHowever, this method may be overridden to allow an element\nto put its dom in another location.", "privacy": "protected", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/element-mixin.html", + "file": "../@polymer/polymer/lib/mixins/element-mixin.js", "start": { - "line": 581, - "column": 6 + "line": 649, + "column": 4 }, "end": { - "line": 597, - "column": 7 + "line": 665, + "column": 5 } }, "metadata": {}, @@ -2654,21 +2779,21 @@ "type": "ShadowRoot", "desc": "node to which the dom has been attached." }, - "inheritedFrom": "Polymer.ElementMixin" + "inheritedFrom": "ElementMixin" }, { "name": "updateStyles", - "description": "When using the ShadyCSS scoping and custom property shim, causes all\nshimmed styles in this element (and its subtree) to be updated\nbased on current custom property values.\n\nThe optional parameter overrides inline custom property styles with an\nobject of properties where the keys are CSS properties, and the values\nare strings.\n\nExample: `this.updateStyles({'--color': 'blue'})`\n\nThese properties are retained unless a value of `null` is set.", + "description": "When using the ShadyCSS scoping and custom property shim, causes all\nshimmed styles in this element (and its subtree) to be updated\nbased on current custom property values.\n\nThe optional parameter overrides inline custom property styles with an\nobject of properties where the keys are CSS properties, and the values\nare strings.\n\nExample: `this.updateStyles({'--color': 'blue'})`\n\nThese properties are retained unless a value of `null` is set.\n\nNote: This function does not support updating CSS mixins.\nYou can not dynamically change the value of an `@apply`.", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/element-mixin.html", + "file": "../@polymer/polymer/lib/mixins/element-mixin.js", "start": { - "line": 617, - "column": 6 + "line": 688, + "column": 4 }, "end": { - "line": 621, - "column": 7 + "line": 692, + "column": 5 } }, "metadata": {}, @@ -2682,21 +2807,21 @@ "return": { "type": "void" }, - "inheritedFrom": "Polymer.ElementMixin" + "inheritedFrom": "ElementMixin" }, { "name": "resolveUrl", "description": "Rewrites a given URL relative to a base URL. The base URL defaults to\nthe original location of the document containing the `dom-module` for\nthis element. This method will return the same URL before and after\nbundling.\n\nNote that this function performs no resolution for URLs that start\nwith `/` (absolute URLs) or `#` (hash identifiers). For general purpose\nURL resolution, use `window.URL`.", "privacy": "public", "sourceRange": { - "file": "bower_components/polymer/lib/mixins/element-mixin.html", + "file": "../@polymer/polymer/lib/mixins/element-mixin.js", "start": { - "line": 638, - "column": 6 + "line": 709, + "column": 4 }, "end": { - "line": 643, - "column": 7 + "line": 714, + "column": 5 } }, "metadata": {}, @@ -2716,7 +2841,7 @@ "type": "string", "desc": "Rewritten URL relative to base" }, - "inheritedFrom": "Polymer.ElementMixin" + "inheritedFrom": "ElementMixin" }, { "name": "_valueChanged", @@ -2724,12 +2849,12 @@ "privacy": "protected", "sourceRange": { "start": { - "line": 1001, - "column": 12 + "line": 1002, + "column": 2 }, "end": { - "line": 1011, - "column": 13 + "line": 1012, + "column": 3 } }, "metadata": {}, @@ -2737,7 +2862,10 @@ { "name": "value" } - ] + ], + "return": { + "type": "void" + } } ], "staticMethods": [ @@ -2746,14 +2874,14 @@ "description": "Scans a template to produce template metadata.\n\nTemplate-specific metadata are stored in the object returned, and node-\nspecific metadata are stored in objects in its flattened `nodeInfoList`\narray. Only nodes in the template that were parsed as nodes of\ninterest contain an object in `nodeInfoList`. Each `nodeInfo` object\ncontains an `index` (`childNodes` index in parent) and optionally\n`parent`, which points to node info of its parent (including its index).\n\nThe template metadata object returned from this method has the following\nstructure (many fields optional):\n\n```js\n {\n // Flattened list of node metadata (for nodes that generated metadata)\n nodeInfoList: [\n {\n // `id` attribute for any nodes with id's for generating `$` map\n id: {string},\n // `on-event=\"handler\"` metadata\n events: [\n {\n name: {string}, // event name\n value: {string}, // handler method name\n }, ...\n ],\n // Notes when the template contained a `` for shady DOM\n // optimization purposes\n hasInsertionPoint: {boolean},\n // For nested `