From 7adad0ae63a495ebea52cb2de8fd58131348804c Mon Sep 17 00:00:00 2001
From: Peter Burns <rictic@google.com>
Date: Wed, 2 May 2018 12:49:49 -0700
Subject: [PATCH 1/3] Make scrolling to anchors more robust.

Especially around iron-doc-module.

Part of https://github.com/Polymer/docs/issues/2541
---
 demo/iron-doc-module.html     | 11 ++++++
 iron-doc-viewer-behavior.html | 66 +++++++++++++++++++++--------------
 2 files changed, 50 insertions(+), 27 deletions(-)

diff --git a/demo/iron-doc-module.html b/demo/iron-doc-module.html
index 0ce908b..b5a4172 100644
--- a/demo/iron-doc-module.html
+++ b/demo/iron-doc-module.html
@@ -1,5 +1,6 @@
 <link rel="import" href="../default-theme.html">
 <link rel="import" href="../iron-doc-module.html">
+<script src="../../webcomponentsjs/webcomponents-loader.js"></script>
 
 <custom-style>
   <style is="custom-style" include="iron-doc-default-theme">
@@ -11,3 +12,13 @@
 </custom-style>
 
 <iron-doc-module module-specifier="@polymer/polymer/lib/mixins/element-mixin.js" base-href="/3.0/docs/api" descriptor="{&quot;schema_version&quot;:&quot;1.0&quot;,&quot;functions&quot;:[{&quot;name&quot;:&quot;register&quot;,&quot;description&quot;:&quot;Registers a class prototype for telemetry purposes.&quot;,&quot;summary&quot;:&quot;&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;lib/mixins/element-mixin.js&quot;,&quot;start&quot;:{&quot;line&quot;:712,&quot;column&quot;:7},&quot;end&quot;:{&quot;line&quot;:715,&quot;column&quot;:1}},&quot;privacy&quot;:&quot;protected&quot;,&quot;params&quot;:[{&quot;type&quot;:&quot;HTMLElement&quot;,&quot;desc&quot;:&quot;Element prototype to register&quot;,&quot;name&quot;:&quot;prototype&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;}},{&quot;name&quot;:&quot;dumpRegistrations&quot;,&quot;description&quot;:&quot;Logs all elements registered with an `is` to the console.&quot;,&quot;summary&quot;:&quot;&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;lib/mixins/element-mixin.js&quot;,&quot;start&quot;:{&quot;line&quot;:722,&quot;column&quot;:7},&quot;end&quot;:{&quot;line&quot;:724,&quot;column&quot;:1}},&quot;privacy&quot;:&quot;public&quot;,&quot;params&quot;:[],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;}},{&quot;name&quot;:&quot;updateStyles&quot;,&quot;description&quot;:&quot;When using the ShadyCSS scoping and custom property shim, causes all\nshimmed `styles` (via `custom-style`) in the document (and its subtree)\nto be updated based 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: `updateStyles({&apos;--color&apos;: &apos;blue&apos;})`\n\nThese properties are retained unless a value of `null` is set.&quot;,&quot;summary&quot;:&quot;&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;lib/mixins/element-mixin.js&quot;,&quot;start&quot;:{&quot;line&quot;:743,&quot;column&quot;:28},&quot;end&quot;:{&quot;line&quot;:747,&quot;column&quot;:1}},&quot;privacy&quot;:&quot;public&quot;,&quot;params&quot;:[{&quot;type&quot;:&quot;Object=&quot;,&quot;desc&quot;:&quot;Bag of custom property key/values to\n  apply to the document.&quot;,&quot;name&quot;:&quot;props&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;}}],&quot;mixins&quot;:[{&quot;description&quot;:&quot;Element class mixin that provides the core API for Polymer&apos;s meta-programming\nfeatures including template stamping, data-binding, attribute deserialization,\nand property change observation.\n\nSubclassers may provide the following static getters to return metadata\nused to configure Polymer&apos;s features for the class:\n\n- `static get is()`: When the template is provided via a `dom-module`,\n  users should return the `dom-module` id from a static `is` getter.  If\n  no template is needed or the template is provided directly via the\n  `template` getter, there is no need to define `is` for the element.\n\n- `static get template()`: Users may provide the template directly (as\n  opposed to via `dom-module`) by implementing a static `template` getter.\n  The getter may return an `HTMLTemplateElement` or a string, which will\n  automatically be parsed into a template.\n\n- `static get properties()`: Should return an object describing\n  property-related metadata used by Polymer features (key: property name\n  value: object containing property metadata). Valid keys in per-property\n  metadata include:\n  - `type` (String|Number|Object|Array|...): Used by\n    `attributeChangedCallback` to determine how string-based attributes\n    are deserialized to JavaScript property values.\n  - `notify` (boolean): Causes a change in the property to fire a\n    non-bubbling event called `&lt;property>-changed`. Elements that have\n    enabled two-way binding to the property use this event to observe changes.\n  - `readOnly` (boolean): Creates a getter for the property, but no setter.\n    To set a read-only property, use the private setter method\n    `_setProperty(property, value)`.\n  - `observer` (string): Observer method name that will be called when\n    the property changes. The arguments of the method are\n    `(value, previousValue)`.\n  - `computed` (string): String describing method and dependent properties\n    for computing the value of this property (e.g. `&apos;computeFoo(bar, zot)&apos;`).\n    Computed properties are read-only by default and can only be changed\n    via the return value of the computing method.\n\n- `static get observers()`: Array of strings describing multi-property\n  observer methods and their dependent properties (e.g.\n  `&apos;observeABC(a, b, c)&apos;`).\n\nThe base class provides default implementations for the following standard\ncustom element lifecycle callbacks; users may override these, but should\ncall the super method to ensure\n- `constructor`: Run when the element is created or upgraded\n- `connectedCallback`: Run each time the element is connected to the\n  document\n- `disconnectedCallback`: Run each time the element is disconnected from\n  the document\n- `attributeChangedCallback`: Run each time an attribute in\n  `observedAttributes` is set or removed (note: this element&apos;s default\n  `observedAttributes` implementation will automatically return an array\n  of dash-cased attributes based on `properties`)&quot;,&quot;summary&quot;:&quot;&quot;,&quot;path&quot;:&quot;lib/mixins/element-mixin.js&quot;,&quot;properties&quot;:[{&quot;name&quot;:&quot;__dataClientsReady&quot;,&quot;type&quot;:&quot;boolean&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1143,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1143,&quot;column&quot;:30}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__dataPendingClients&quot;,&quot;type&quot;:&quot;Array&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1145,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1145,&quot;column&quot;:32}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__dataToNotify&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1147,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1147,&quot;column&quot;:26}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__dataLinkedPaths&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1149,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1149,&quot;column&quot;:29}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__dataHasPaths&quot;,&quot;type&quot;:&quot;boolean&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1151,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1151,&quot;column&quot;:26}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__dataCompoundStorage&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1153,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1153,&quot;column&quot;:33}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__dataHost&quot;,&quot;type&quot;:&quot;Polymer_PropertyEffects&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1155,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1155,&quot;column&quot;:22}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__dataTemp&quot;,&quot;type&quot;:&quot;!Object&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1157,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1157,&quot;column&quot;:22}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__dataClientsInitialized&quot;,&quot;type&quot;:&quot;boolean&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1159,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1159,&quot;column&quot;:36}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__data&quot;,&quot;type&quot;:&quot;!Object&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1161,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1161,&quot;column&quot;:18}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__dataPending&quot;,&quot;type&quot;:&quot;!Object&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1163,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1163,&quot;column&quot;:25}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__dataOld&quot;,&quot;type&quot;:&quot;!Object&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1165,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1165,&quot;column&quot;:21}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__computeEffects&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1167,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1167,&quot;column&quot;:28}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__reflectEffects&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1169,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1169,&quot;column&quot;:28}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__notifyEffects&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1171,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1171,&quot;column&quot;:27}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__propagateEffects&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1173,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1173,&quot;column&quot;:30}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__observeEffects&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1175,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1175,&quot;column&quot;:28}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__readOnly&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1177,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1177,&quot;column&quot;:22}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__templateInfo&quot;,&quot;type&quot;:&quot;!TemplateInfo&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1179,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:1179,&quot;column&quot;:26}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;PROPERTY_EFFECT_TYPES&quot;,&quot;type&quot;:&quot;?&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1182,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1184,&quot;column&quot;:5}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:true}},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_template&quot;,&quot;type&quot;:&quot;HTMLTemplateElement&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:429,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:429,&quot;column&quot;:21}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}}},{&quot;name&quot;:&quot;_importPath&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:431,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:431,&quot;column&quot;:23}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}}},{&quot;name&quot;:&quot;rootPath&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:433,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:433,&quot;column&quot;:20}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}}},{&quot;name&quot;:&quot;importPath&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:435,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:435,&quot;column&quot;:22}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}}},{&quot;name&quot;:&quot;root&quot;,&quot;type&quot;:&quot;(StampedTemplate | HTMLElement | ShadowRoot)&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:437,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:437,&quot;column&quot;:16}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}}},{&quot;name&quot;:&quot;$&quot;,&quot;type&quot;:&quot;!Object.&lt;string, !Element>&quot;,&quot;description&quot;:&quot;&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:439,&quot;column&quot;:6},&quot;end&quot;:{&quot;line&quot;:439,&quot;column&quot;:13}},&quot;metadata&quot;:{&quot;polymer&quot;:{&quot;readOnly&quot;:false}}}],&quot;methods&quot;:[{&quot;name&quot;:&quot;_stampTemplate&quot;,&quot;description&quot;:&quot;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`&apos;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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2419,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2444,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;template&quot;,&quot;type&quot;:&quot;!HTMLTemplateElement&quot;,&quot;description&quot;:&quot;Template to stamp&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;!StampedTemplate&quot;,&quot;desc&quot;:&quot;Cloned template content&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_addMethodEventListenerToNode&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;template-stamp.js&quot;,&quot;start&quot;:{&quot;line&quot;:446,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:451,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;node&quot;,&quot;type&quot;:&quot;!Node&quot;,&quot;description&quot;:&quot;Node to add listener on&quot;},{&quot;name&quot;:&quot;eventName&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of event&quot;},{&quot;name&quot;:&quot;methodName&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of method&quot;},{&quot;name&quot;:&quot;context&quot;,&quot;type&quot;:&quot;*=&quot;,&quot;description&quot;:&quot;Context the method will be called on (defaults\n  to `node`)&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;Function&quot;,&quot;desc&quot;:&quot;Generated handler function&quot;},&quot;inheritedFrom&quot;:&quot;TemplateStamp&quot;},{&quot;name&quot;:&quot;_addEventListenerToNode&quot;,&quot;description&quot;:&quot;Override point for adding custom or simulated event handling.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;template-stamp.js&quot;,&quot;start&quot;:{&quot;line&quot;:461,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:463,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;node&quot;,&quot;type&quot;:&quot;!Node&quot;,&quot;description&quot;:&quot;Node to add event listener to&quot;},{&quot;name&quot;:&quot;eventName&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of event&quot;},{&quot;name&quot;:&quot;handler&quot;,&quot;type&quot;:&quot;function (!Event): void&quot;,&quot;description&quot;:&quot;Listener function to add&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;TemplateStamp&quot;},{&quot;name&quot;:&quot;_removeEventListenerFromNode&quot;,&quot;description&quot;:&quot;Override point for adding custom or simulated event handling.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;template-stamp.js&quot;,&quot;start&quot;:{&quot;line&quot;:473,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:475,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;node&quot;,&quot;type&quot;:&quot;Node&quot;,&quot;description&quot;:&quot;Node to remove event listener from&quot;},{&quot;name&quot;:&quot;eventName&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of event&quot;},{&quot;name&quot;:&quot;handler&quot;,&quot;type&quot;:&quot;function (!Event): void&quot;,&quot;description&quot;:&quot;Listener function to remove&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;TemplateStamp&quot;},{&quot;name&quot;:&quot;_createPropertyAccessor&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:100,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:109,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of the property&quot;},{&quot;name&quot;:&quot;readOnly&quot;,&quot;type&quot;:&quot;boolean=&quot;,&quot;description&quot;:&quot;When true, no setter is created; the\n  protected `_setProperty` function must be used to set the property&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_addPropertyToAttributeMap&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:118,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:126,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of the property&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_definePropertyAccessor&quot;,&quot;description&quot;:&quot;Defines a property accessor for the given property.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:134,&quot;column&quot;:5},&quot;end&quot;:{&quot;line&quot;:147,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of the property&quot;},{&quot;name&quot;:&quot;readOnly&quot;,&quot;type&quot;:&quot;boolean=&quot;,&quot;description&quot;:&quot;When true, no setter is created&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;ready&quot;,&quot;description&quot;:&quot;Stamps the element template.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:547,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:553,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;}},{&quot;name&quot;:&quot;_initializeProperties&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:454,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:487,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;}},{&quot;name&quot;:&quot;_initializeInstanceProperties&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:216,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:218,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;props&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;Bag of property values that were overwritten\n  when creating property accessors.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_setProperty&quot;,&quot;description&quot;:&quot;Updates the local storage for a property (via `_setPendingProperty`)\nand enqueues a `_proeprtiesChanged` callback.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:229,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:233,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of the property&quot;},{&quot;name&quot;:&quot;value&quot;,&quot;type&quot;:&quot;*&quot;,&quot;description&quot;:&quot;Value to set&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_getProperty&quot;,&quot;description&quot;:&quot;Returns the value for the given property.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:241,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:243,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of property&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;*&quot;,&quot;desc&quot;:&quot;Value for the given property&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_setPendingProperty&quot;,&quot;description&quot;:&quot;Updates the local storage for a property, records the previous value,\nand adds it to the set of \&quot;pending changes\&quot; that will be passed to the\n`_propertiesChanged` callback.  This method does not enqueue the\n`_propertiesChanged` callback.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:258,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:274,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of the property&quot;},{&quot;name&quot;:&quot;value&quot;,&quot;type&quot;:&quot;*&quot;,&quot;description&quot;:&quot;Value to set&quot;},{&quot;name&quot;:&quot;ext&quot;,&quot;type&quot;:&quot;boolean=&quot;,&quot;description&quot;:&quot;Not used here; affordance for closure&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;boolean&quot;,&quot;desc&quot;:&quot;Returns true if the property changed&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_invalidateProperties&quot;,&quot;description&quot;:&quot;Marks the properties as invalid, and enqueues an async\n`_propertiesChanged` callback.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:284,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:294,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_enableProperties&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:307,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:316,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_flushProperties&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:327,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:336,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_shouldPropertiesChange&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:350,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:352,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;currentProps&quot;,&quot;type&quot;:&quot;!Object&quot;,&quot;description&quot;:&quot;Bag of all current accessor values&quot;},{&quot;name&quot;:&quot;changedProps&quot;,&quot;type&quot;:&quot;!Object&quot;,&quot;description&quot;:&quot;Bag of properties changed since the last\n  call to `_propertiesChanged`&quot;},{&quot;name&quot;:&quot;oldProps&quot;,&quot;type&quot;:&quot;!Object&quot;,&quot;description&quot;:&quot;Bag of previous values for each property\n  in `changedProps`&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;boolean&quot;,&quot;desc&quot;:&quot;true if changedProps is truthy&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_propertiesChanged&quot;,&quot;description&quot;:&quot;Callback called when any properties with accessors created via\n`_createPropertyAccessor` have been set.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:366,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:367,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;currentProps&quot;,&quot;type&quot;:&quot;!Object&quot;,&quot;description&quot;:&quot;Bag of all current accessor values&quot;},{&quot;name&quot;:&quot;changedProps&quot;,&quot;type&quot;:&quot;!Object&quot;,&quot;description&quot;:&quot;Bag of properties changed since the last\n  call to `_propertiesChanged`&quot;},{&quot;name&quot;:&quot;oldProps&quot;,&quot;type&quot;:&quot;!Object&quot;,&quot;description&quot;:&quot;Bag of previous values for each property\n  in `changedProps`&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_shouldPropertyChange&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:387,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:394,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;},{&quot;name&quot;:&quot;value&quot;,&quot;type&quot;:&quot;*&quot;,&quot;description&quot;:&quot;New property value&quot;},{&quot;name&quot;:&quot;old&quot;,&quot;type&quot;:&quot;*&quot;,&quot;description&quot;:&quot;Previous property value&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;boolean&quot;,&quot;desc&quot;:&quot;Whether the property should be considered a change\n  and enqueue a `_proeprtiesChanged` callback&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;attributeChangedCallback&quot;,&quot;description&quot;:&quot;Implements native Custom Elements `attributeChangedCallback` to\nset an attribute value to a property via `_attributeToProperty`.&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:407,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:414,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;name&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of attribute that changed&quot;},{&quot;name&quot;:&quot;old&quot;,&quot;type&quot;:&quot;?string&quot;,&quot;description&quot;:&quot;Old attribute value&quot;},{&quot;name&quot;:&quot;value&quot;,&quot;type&quot;:&quot;?string&quot;,&quot;description&quot;:&quot;New attribute value&quot;},{&quot;name&quot;:&quot;namespace&quot;,&quot;type&quot;:&quot;?string&quot;,&quot;description&quot;:&quot;Attribute namespace.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_attributeToProperty&quot;,&quot;description&quot;:&quot;Deserializes an attribute to its associated property.\n\nThis method calls the `_deserializeValue` method to convert the string to\na typed value.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:428,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:435,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;attribute&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of attribute to deserialize.&quot;},{&quot;name&quot;:&quot;value&quot;,&quot;type&quot;:&quot;?string&quot;,&quot;description&quot;:&quot;of the attribute.&quot;},{&quot;name&quot;:&quot;type&quot;,&quot;type&quot;:&quot;*=&quot;,&quot;description&quot;:&quot;type to deserialize to, defaults to the value\nreturned from `typeForProperty`&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_propertyToAttribute&quot;,&quot;description&quot;:&quot;Serializes a property to its associated attribute.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:447,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:453,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name to reflect.&quot;},{&quot;name&quot;:&quot;attribute&quot;,&quot;type&quot;:&quot;string=&quot;,&quot;description&quot;:&quot;Attribute name to reflect to.&quot;},{&quot;name&quot;:&quot;value&quot;,&quot;type&quot;:&quot;*=&quot;,&quot;description&quot;:&quot;Property value to refect.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_valueToNodeAttribute&quot;,&quot;description&quot;:&quot;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`).&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:468,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:475,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;node&quot;,&quot;type&quot;:&quot;Element&quot;,&quot;description&quot;:&quot;Element to set attribute to.&quot;},{&quot;name&quot;:&quot;value&quot;,&quot;type&quot;:&quot;*&quot;,&quot;description&quot;:&quot;Value to serialize.&quot;},{&quot;name&quot;:&quot;attribute&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Attribute name to serialize to.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_serializeValue&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:488,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:495,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;value&quot;,&quot;type&quot;:&quot;*&quot;,&quot;description&quot;:&quot;Property value to serialize.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;(string | undefined)&quot;,&quot;desc&quot;:&quot;String serialized from the provided\nproperty  value.&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_deserializeValue&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:509,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:518,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;value&quot;,&quot;type&quot;:&quot;?string&quot;,&quot;description&quot;:&quot;Value to deserialize.&quot;},{&quot;name&quot;:&quot;type&quot;,&quot;type&quot;:&quot;*=&quot;,&quot;description&quot;:&quot;Type to deserialize the string to.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;*&quot;,&quot;desc&quot;:&quot;Typed value deserialized from the provided string.&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;_initializeProtoProperties&quot;,&quot;description&quot;:&quot;Overrides `PropertyAccessors` implementation to provide a\nmore efficient implementation of initializing properties from\nthe prototype on the instance.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1213,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1217,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;props&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;Properties to initialize on the prototype&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_ensureAttribute&quot;,&quot;description&quot;:&quot;Ensures the element has the given attribute. If it does not,\nassigns the given value to the attribute.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-accessors.js&quot;,&quot;start&quot;:{&quot;line&quot;:186,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:191,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;attribute&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of attribute to ensure is set.&quot;},{&quot;name&quot;:&quot;value&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;of the attribute.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyAccessors&quot;},{&quot;name&quot;:&quot;_hasAccessor&quot;,&quot;description&quot;:&quot;Returns true if this library created an accessor for the given property.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-accessors.js&quot;,&quot;start&quot;:{&quot;line&quot;:293,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:295,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;boolean&quot;,&quot;desc&quot;:&quot;True if an accessor was created&quot;},&quot;inheritedFrom&quot;:&quot;PropertyAccessors&quot;},{&quot;name&quot;:&quot;_isPropertyPending&quot;,&quot;description&quot;:&quot;Returns true if the specified property has a pending change.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-accessors.js&quot;,&quot;start&quot;:{&quot;line&quot;:304,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:306,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;prop&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;boolean&quot;,&quot;desc&quot;:&quot;True if property has a pending change&quot;},&quot;inheritedFrom&quot;:&quot;PropertyAccessors&quot;},{&quot;name&quot;:&quot;_addPropertyEffect&quot;,&quot;description&quot;:&quot;Equivalent to static `addPropertyEffect` API but can be called on\nan instance to add effects at runtime.  See that method for\nfull API docs.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1251,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1259,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property that should trigger the effect&quot;},{&quot;name&quot;:&quot;type&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Effect type, from this.PROPERTY_EFFECT_TYPES&quot;},{&quot;name&quot;:&quot;effect&quot;,&quot;type&quot;:&quot;Object=&quot;,&quot;description&quot;:&quot;Effect metadata object&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_removePropertyEffect&quot;,&quot;description&quot;:&quot;Removes the given property effect.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1269,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1275,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property the effect was associated with&quot;},{&quot;name&quot;:&quot;type&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Effect type, from this.PROPERTY_EFFECT_TYPES&quot;},{&quot;name&quot;:&quot;effect&quot;,&quot;type&quot;:&quot;Object=&quot;,&quot;description&quot;:&quot;Effect metadata object to remove&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_hasPropertyEffect&quot;,&quot;description&quot;:&quot;Returns whether the current prototype/instance has a property effect\nof a certain type.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1286,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1289,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;},{&quot;name&quot;:&quot;type&quot;,&quot;type&quot;:&quot;string=&quot;,&quot;description&quot;:&quot;Effect type, from this.PROPERTY_EFFECT_TYPES&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;boolean&quot;,&quot;desc&quot;:&quot;True if the prototype/instance has an effect of this type&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_hasReadOnlyEffect&quot;,&quot;description&quot;:&quot;Returns whether the current prototype/instance has a \&quot;read only\&quot;\naccessor for the given property.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1299,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1301,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;boolean&quot;,&quot;desc&quot;:&quot;True if the prototype/instance has an effect of this type&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_hasNotifyEffect&quot;,&quot;description&quot;:&quot;Returns whether the current prototype/instance has a \&quot;notify\&quot;\nproperty effect for the given property.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1311,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1313,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;boolean&quot;,&quot;desc&quot;:&quot;True if the prototype/instance has an effect of this type&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_hasReflectEffect&quot;,&quot;description&quot;:&quot;Returns whether the current prototype/instance has a \&quot;reflect to attribute\&quot;\nproperty effect for the given property.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1323,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1325,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;boolean&quot;,&quot;desc&quot;:&quot;True if the prototype/instance has an effect of this type&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_hasComputedEffect&quot;,&quot;description&quot;:&quot;Returns whether the current prototype/instance has a \&quot;computed\&quot;\nproperty effect for the given property.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1335,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1337,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;boolean&quot;,&quot;desc&quot;:&quot;True if the prototype/instance has an effect of this type&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_setPendingPropertyOrPath&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1369,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1401,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;path&quot;,&quot;type&quot;:&quot;(string | !Array.&lt;(number | string)>)&quot;,&quot;description&quot;:&quot;Path to set&quot;},{&quot;name&quot;:&quot;value&quot;,&quot;type&quot;:&quot;*&quot;,&quot;description&quot;:&quot;Value to set&quot;},{&quot;name&quot;:&quot;shouldNotify&quot;,&quot;type&quot;:&quot;boolean=&quot;,&quot;description&quot;:&quot;Set to true if this change should\n cause a property notification event dispatch&quot;},{&quot;name&quot;:&quot;isPathNotification&quot;,&quot;type&quot;:&quot;boolean=&quot;,&quot;description&quot;:&quot;If the path being set is a path\n  notification of an already changed value, as opposed to a request\n  to set and notify the change.  In the latter `false` case, a dirty\n  check is performed and then the value is set to the path before\n  enqueuing the pending property change.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;boolean&quot;,&quot;desc&quot;:&quot;Returns true if the property/path was enqueued in\n  the pending changes bag.&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_setUnmanagedPropertyToNode&quot;,&quot;description&quot;:&quot;Applies a value to a non-Polymer element/node&apos;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 `&lt;input>.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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1424,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1432,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;node&quot;,&quot;type&quot;:&quot;!Node&quot;,&quot;description&quot;:&quot;The node to set a property on&quot;},{&quot;name&quot;:&quot;prop&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;The property to set&quot;},{&quot;name&quot;:&quot;value&quot;,&quot;type&quot;:&quot;*&quot;,&quot;description&quot;:&quot;The value to set&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_enqueueClient&quot;,&quot;description&quot;:&quot;Enqueues the given client on a list of pending clients, whose\npending property changes can later be flushed via a call to\n`_flushClients`.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1539,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1544,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;client&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;PropertyEffects client to enqueue&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_flushClients&quot;,&quot;description&quot;:&quot;Flushes any clients previously enqueued via `_enqueueClient`, causing\ntheir `_flushProperties` method to run.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1565,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1576,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;__enableOrFlushClients&quot;,&quot;description&quot;:&quot;(c) the stamped dom enables.&quot;,&quot;privacy&quot;:&quot;private&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1590,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1603,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_readyClients&quot;,&quot;description&quot;:&quot;Implements `PropertyEffects`&apos;s `_readyClients` call. Attaches\nelement dom by calling `_attachDom` with the dom stamped from the\nelement&apos;s template via `_stampTemplate`. Note that this allows\nclient dom to be attached to the element prior to any observers\nrunning.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:565,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:574,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;}},{&quot;name&quot;:&quot;setProperties&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1632,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1643,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;props&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;Bag of one or more key-value pairs whose key is\n  a property and value is the new value to set for that property.&quot;},{&quot;name&quot;:&quot;setReadOnly&quot;,&quot;type&quot;:&quot;boolean=&quot;,&quot;description&quot;:&quot;When true, any private values set in\n  `props` will be set. By default, `setProperties` will not set\n  `readOnly: true` root properties.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_propagatePropertyChanges&quot;,&quot;description&quot;:&quot;Called to propagate any property changes to stamped template nodes\nmanaged by this element.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1730,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1740,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;changedProps&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;Bag of changed properties&quot;},{&quot;name&quot;:&quot;oldProps&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;Bag of previous values for changed properties&quot;},{&quot;name&quot;:&quot;hasPaths&quot;,&quot;type&quot;:&quot;boolean&quot;,&quot;description&quot;:&quot;True with `props` contains one or more paths&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;linkPaths&quot;,&quot;description&quot;:&quot;Aliases one data path as another, such that path notifications from one\nare routed to the other.&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1751,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1756,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;to&quot;,&quot;type&quot;:&quot;(string | !Array.&lt;(string | number)>)&quot;,&quot;description&quot;:&quot;Target path to link.&quot;},{&quot;name&quot;:&quot;from&quot;,&quot;type&quot;:&quot;(string | !Array.&lt;(string | number)>)&quot;,&quot;description&quot;:&quot;Source path to link.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;unlinkPaths&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1768,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1773,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;path&quot;,&quot;type&quot;:&quot;(string | !Array.&lt;(string | number)>)&quot;,&quot;description&quot;:&quot;Target path to unlink.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;notifySplices&quot;,&quot;description&quot;:&quot;Notify that an array has changed.\n\nExample:\n\n    this.items = [ {name: &apos;Jim&apos;}, {name: &apos;Todd&apos;}, {name: &apos;Bill&apos;} ];\n    ...\n    this.items.splice(1, 1, {name: &apos;Sam&apos;});\n    this.items.push({name: &apos;Bob&apos;});\n    this.notifySplices(&apos;items&apos;, [\n      { index: 1, removed: [{name: &apos;Todd&apos;}], addedCount: 1, object: this.items, type: &apos;splice&apos; },\n      { index: 3, removed: [], addedCount: 1, object: this.items, type: &apos;splice&apos;}\n    ]);&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1805,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1809,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;path&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Path that should be notified.&quot;},{&quot;name&quot;:&quot;splices&quot;,&quot;type&quot;:&quot;Array&quot;,&quot;description&quot;:&quot;Array of splice records indicating ordered\n  changes that occurred to the array. Each record should have the\n  following fields:\n   * index: index at which the change occurred\n   * removed: array of items that were removed from this index\n   * addedCount: number of new items added at this index\n   * object: a reference to the array in question\n   * type: the string literal &apos;splice&apos;\n\n  Note that splice records _must_ be normalized such that they are\n  reported in index order (raw results from `Object.observe` are not\n  ordered and must be normalized/merged before notifying).&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;get&quot;,&quot;description&quot;:&quot;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).&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1830,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1832,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;path&quot;,&quot;type&quot;:&quot;(string | !Array.&lt;(string | number)>)&quot;,&quot;description&quot;:&quot;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. `[&apos;foo.bar&apos;, &apos;baz&apos;]`).  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 `[&apos;users&apos;, 12, &apos;name&apos;]`).&quot;},{&quot;name&quot;:&quot;root&quot;,&quot;type&quot;:&quot;Object=&quot;,&quot;description&quot;:&quot;Root object from which the path is evaluated.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;*&quot;,&quot;desc&quot;:&quot;Value at the path, or `undefined` if any part of the path\n  is undefined.&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;set&quot;,&quot;description&quot;:&quot;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).&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1855,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1865,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;path&quot;,&quot;type&quot;:&quot;(string | !Array.&lt;(string | number)>)&quot;,&quot;description&quot;:&quot;Path to the value\n  to write.  The path may be specified as a string (e.g. `&apos;foo.bar.baz&apos;`)\n  or an array of path parts (e.g. `[&apos;foo.bar&apos;, &apos;baz&apos;]`).  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. `&apos;users.12.name&apos;` or `[&apos;users&apos;, 12, &apos;name&apos;]`).&quot;},{&quot;name&quot;:&quot;value&quot;,&quot;type&quot;:&quot;*&quot;,&quot;description&quot;:&quot;Value to set at the specified path.&quot;},{&quot;name&quot;:&quot;root&quot;,&quot;type&quot;:&quot;Object=&quot;,&quot;description&quot;:&quot;Root object from which the path is evaluated.\n  When specified, no notification will occur.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;push&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1881,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1890,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;path&quot;,&quot;type&quot;:&quot;(string | !Array.&lt;(string | number)>)&quot;,&quot;description&quot;:&quot;Path to array.&quot;},{&quot;name&quot;:&quot;items&quot;,&quot;type&quot;:&quot;...*&quot;,&quot;rest&quot;:true,&quot;description&quot;:&quot;Items to push onto array&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;number&quot;,&quot;desc&quot;:&quot;New length of the array.&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;pop&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1905,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1914,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;path&quot;,&quot;type&quot;:&quot;(string | !Array.&lt;(string | number)>)&quot;,&quot;description&quot;:&quot;Path to array.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;*&quot;,&quot;desc&quot;:&quot;Item that was removed.&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;splice&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1933,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1970,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;path&quot;,&quot;type&quot;:&quot;(string | !Array.&lt;(string | number)>)&quot;,&quot;description&quot;:&quot;Path to array.&quot;},{&quot;name&quot;:&quot;start&quot;,&quot;type&quot;:&quot;number&quot;,&quot;description&quot;:&quot;Index from which to start removing/inserting.&quot;},{&quot;name&quot;:&quot;deleteCount&quot;,&quot;type&quot;:&quot;number&quot;,&quot;description&quot;:&quot;Number of items to remove.&quot;},{&quot;name&quot;:&quot;items&quot;,&quot;type&quot;:&quot;...*&quot;,&quot;rest&quot;:true,&quot;description&quot;:&quot;Items to insert into array.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;Array&quot;,&quot;desc&quot;:&quot;Array of removed items.&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;shift&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:1985,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:1994,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;path&quot;,&quot;type&quot;:&quot;(string | !Array.&lt;(string | number)>)&quot;,&quot;description&quot;:&quot;Path to array.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;*&quot;,&quot;desc&quot;:&quot;Item that was removed.&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;unshift&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2010,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2018,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;path&quot;,&quot;type&quot;:&quot;(string | !Array.&lt;(string | number)>)&quot;,&quot;description&quot;:&quot;Path to array.&quot;},{&quot;name&quot;:&quot;items&quot;,&quot;type&quot;:&quot;...*&quot;,&quot;rest&quot;:true,&quot;description&quot;:&quot;Items to insert info array&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;number&quot;,&quot;desc&quot;:&quot;New length of the array.&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;notifyPath&quot;,&quot;description&quot;:&quot;Notify that a path has changed.\n\nExample:\n\n    this.item.user.name = &apos;Bob&apos;;\n    this.notifyPath(&apos;item.user.name&apos;);&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2033,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2050,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;path&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Path that should be notified.&quot;},{&quot;name&quot;:&quot;value&quot;,&quot;type&quot;:&quot;*=&quot;,&quot;description&quot;:&quot;Value at the path (optional).&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_createReadOnlyProperty&quot;,&quot;description&quot;:&quot;Equivalent to static `createReadOnlyProperty` API but can be called on\nan instance to add effects at runtime.  See that method for\nfull API docs.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2063,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2070,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;},{&quot;name&quot;:&quot;protectedSetter&quot;,&quot;type&quot;:&quot;boolean=&quot;,&quot;description&quot;:&quot;Creates a custom protected setter\n  when `true`.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_createPropertyObserver&quot;,&quot;description&quot;:&quot;Equivalent to static `createPropertyObserver` API but can be called on\nan instance to add effects at runtime.  See that method for\nfull API docs.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2084,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2094,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;},{&quot;name&quot;:&quot;method&quot;,&quot;type&quot;:&quot;(string | function (*, *))&quot;,&quot;description&quot;:&quot;Function or name of observer method to call&quot;},{&quot;name&quot;:&quot;dynamicFn&quot;,&quot;type&quot;:&quot;boolean=&quot;,&quot;description&quot;:&quot;Whether the method name should be included as\n  a dependency to the effect.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_createMethodObserver&quot;,&quot;description&quot;:&quot;Equivalent to static `createMethodObserver` API but can be called on\nan instance to add effects at runtime.  See that method for\nfull API docs.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2107,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2113,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;expression&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Method expression&quot;},{&quot;name&quot;:&quot;dynamicFn&quot;,&quot;type&quot;:&quot;(boolean | Object)=&quot;,&quot;description&quot;:&quot;Boolean or object map indicating\n  whether method names should be included as a dependency to the effect.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_createNotifyingProperty&quot;,&quot;description&quot;:&quot;Equivalent to static `createNotifyingProperty` API but can be called on\nan instance to add effects at runtime.  See that method for\nfull API docs.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2124,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2132,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_createReflectedProperty&quot;,&quot;description&quot;:&quot;Equivalent to static `createReflectedProperty` API but can be called on\nan instance to add effects at runtime.  See that method for\nfull API docs.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2143,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2156,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_createComputedProperty&quot;,&quot;description&quot;:&quot;Equivalent to static `createComputedProperty` API but can be called on\nan instance to add effects at runtime.  See that method for\nfull API docs.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2170,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2176,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of computed property to set&quot;},{&quot;name&quot;:&quot;expression&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Method expression&quot;},{&quot;name&quot;:&quot;dynamicFn&quot;,&quot;type&quot;:&quot;(boolean | Object)=&quot;,&quot;description&quot;:&quot;Boolean or object map indicating\n  whether method names should be included as a dependency to the effect.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_bindTemplate&quot;,&quot;description&quot;:&quot;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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2353,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2376,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;template&quot;,&quot;type&quot;:&quot;!HTMLTemplateElement&quot;,&quot;description&quot;:&quot;Template containing binding\n  bindings&quot;},{&quot;name&quot;:&quot;instanceBinding&quot;,&quot;type&quot;:&quot;boolean=&quot;,&quot;description&quot;:&quot;When false (default), performs\n  \&quot;prototypical\&quot; binding of the template and overwrites any previously\n  bound template for the class. When true (as passed from\n  `_stampTemplate`), the template info is instanced and linked into\n  the list of bound templates.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;!TemplateInfo&quot;,&quot;desc&quot;:&quot;Template metadata object; for `runtimeBinding`,\n  this is an instance of the prototypical template info&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_removeBoundDom&quot;,&quot;description&quot;:&quot;Removes and unbinds the nodes previously contained in the provided\nDocumentFragment returned from `_stampTemplate`.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2455,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2476,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;dom&quot;,&quot;type&quot;:&quot;!StampedTemplate&quot;,&quot;description&quot;:&quot;DocumentFragment previously returned\n  from `_stampTemplate` associated with the nodes to be removed&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;connectedCallback&quot;,&quot;description&quot;:&quot;Provides a default implementation of the standard Custom Elements\n`connectedCallback`.\n\nThe default implementation enables the property effects system and\nflushes any pending properties, and updates shimmed CSS properties\nwhen using the ShadyCSS scoping/custom properties polyfill.&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:534,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:539,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;}},{&quot;name&quot;:&quot;disconnectedCallback&quot;,&quot;description&quot;:&quot;Called when the element is removed from a document&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-mixin.js&quot;,&quot;start&quot;:{&quot;line&quot;:210,&quot;column&quot;:3},&quot;end&quot;:{&quot;line&quot;:214,&quot;column&quot;:4}},&quot;metadata&quot;:{},&quot;params&quot;:[],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesMixin&quot;},{&quot;name&quot;:&quot;_attachDom&quot;,&quot;description&quot;:&quot;Attaches an element&apos;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.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:588,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:604,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;dom&quot;,&quot;type&quot;:&quot;StampedTemplate&quot;,&quot;description&quot;:&quot;to attach to the element.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;ShadowRoot&quot;,&quot;desc&quot;:&quot;node to which the dom has been attached.&quot;}},{&quot;name&quot;:&quot;updateStyles&quot;,&quot;description&quot;:&quot;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({&apos;--color&apos;: &apos;blue&apos;})`\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`.&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:627,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:631,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;properties&quot;,&quot;type&quot;:&quot;Object=&quot;,&quot;description&quot;:&quot;Bag of custom property key/values to\n  apply to this element.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;}},{&quot;name&quot;:&quot;resolveUrl&quot;,&quot;description&quot;:&quot;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`.&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:648,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:653,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;url&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;URL to resolve.&quot;},{&quot;name&quot;:&quot;base&quot;,&quot;type&quot;:&quot;string=&quot;,&quot;description&quot;:&quot;Optional base URL to resolve against, defaults\nto the element&apos;s `importPath`&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;string&quot;,&quot;desc&quot;:&quot;Rewritten URL relative to base&quot;}}],&quot;staticMethods&quot;:[{&quot;name&quot;:&quot;_parseTemplate&quot;,&quot;description&quot;:&quot;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&apos;s for generating `$` map\n        id: {string},\n        // `on-event=\&quot;handler\&quot;` metadata\n        events: [\n          {\n            name: {string},   // event name\n            value: {string},  // handler method name\n          }, ...\n        ],\n        // Notes when the template contained a `&lt;slot>` for shady DOM\n        // optimization purposes\n        hasInsertionPoint: {boolean},\n        // For nested `&lt;template>`` nodes, nested template metadata\n        templateInfo: {object}, // nested template metadata\n        // Metadata to allow efficient retrieval of instanced node\n        // corresponding to this metadata\n        parentInfo: {number},   // reference to parent nodeInfo>\n        parentIndex: {number},  // index in parent&apos;s `childNodes` collection\n        infoIndex: {number},    // index of this `nodeInfo` in `templateInfo.nodeInfoList`\n      },\n      ...\n    ],\n    // When true, the template had the `strip-whitespace` attribute\n    // or was nested in a template with that setting\n    stripWhitespace: {boolean},\n    // For nested templates, nested template content is moved into\n    // a document fragment stored here; this is an optimization to\n    // avoid the cost of nested template cloning\n    content: {DocumentFragment}\n  }\n```\n\nThis method kicks off a recursive treewalk as follows:\n\n```\n   _parseTemplate &lt;---------------------+\n     _parseTemplateContent              |\n       _parseTemplateNode  &lt;------------|--+\n         _parseTemplateNestedTemplate --+  |\n         _parseTemplateChildNodes ---------+\n         _parseTemplateNodeAttributes\n           _parseTemplateNodeAttribute\n\n```\n\nThese methods may be overridden to add custom metadata about templates\nto either `templateInfo` or `nodeInfo`.\n\nNote that this method may be destructive to the template, in that\ne.g. event annotations may be removed after being noted in the\ntemplate metadata.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;template-stamp.js&quot;,&quot;start&quot;:{&quot;line&quot;:191,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:202,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;template&quot;,&quot;type&quot;:&quot;!HTMLTemplateElement&quot;,&quot;description&quot;:&quot;Template to parse&quot;},{&quot;name&quot;:&quot;outerTemplateInfo&quot;,&quot;type&quot;:&quot;TemplateInfo=&quot;,&quot;description&quot;:&quot;Template metadata from the outer\n  template, for parsing nested templates&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;!TemplateInfo&quot;,&quot;desc&quot;:&quot;Parsed template metadata&quot;},&quot;inheritedFrom&quot;:&quot;TemplateStamp&quot;},{&quot;name&quot;:&quot;_parseTemplateContent&quot;,&quot;description&quot;:&quot;Overrides `PropertyAccessors` to add map of dynamic functions on\ntemplate info, for consumption by `PropertyEffects` template binding\ncode. This map determines which method templates should have accessors\ncreated for them.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:664,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:667,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;template&quot;},{&quot;name&quot;:&quot;templateInfo&quot;},{&quot;name&quot;:&quot;nodeInfo&quot;}]},{&quot;name&quot;:&quot;_parseTemplateNode&quot;,&quot;description&quot;:&quot;Overrides default `TemplateStamp` implementation to add support for\nparsing bindings from `TextNode`&apos;s&apos; `textContent`.  A `bindings`\narray is added to `nodeInfo` and populated with binding metadata\nwith information capturing the binding target, and a `parts` array\nwith one or more metadata objects capturing the source(s) of the\nbinding.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2495,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2509,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;node&quot;,&quot;type&quot;:&quot;Node&quot;,&quot;description&quot;:&quot;Node to parse&quot;},{&quot;name&quot;:&quot;templateInfo&quot;,&quot;type&quot;:&quot;TemplateInfo&quot;,&quot;description&quot;:&quot;Template metadata for current template&quot;},{&quot;name&quot;:&quot;nodeInfo&quot;,&quot;type&quot;:&quot;NodeInfo&quot;,&quot;description&quot;:&quot;Node metadata for current template node&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;boolean&quot;,&quot;desc&quot;:&quot;`true` if the visited node added node-specific\n  metadata to `nodeInfo`&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_parseTemplateChildNodes&quot;,&quot;description&quot;:&quot;Parses template child nodes for the given root node.\n\nThis method also wraps whitelisted legacy template extensions\n(`is=\&quot;dom-if\&quot;` and `is=\&quot;dom-repeat\&quot;`) with their equivalent element\nwrappers, collapses text nodes, and strips whitespace from the template\nif the `templateInfo.stripWhitespace` setting was provided.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;template-stamp.js&quot;,&quot;start&quot;:{&quot;line&quot;:252,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:289,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;root&quot;,&quot;type&quot;:&quot;Node&quot;,&quot;description&quot;:&quot;Root node whose `childNodes` will be parsed&quot;},{&quot;name&quot;:&quot;templateInfo&quot;,&quot;type&quot;:&quot;!TemplateInfo&quot;,&quot;description&quot;:&quot;Template metadata for current template&quot;},{&quot;name&quot;:&quot;nodeInfo&quot;,&quot;type&quot;:&quot;!NodeInfo&quot;,&quot;description&quot;:&quot;Node metadata for current template.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;TemplateStamp&quot;},{&quot;name&quot;:&quot;_parseTemplateNestedTemplate&quot;,&quot;description&quot;:&quot;Overrides default `TemplateStamp` implementation to add support for\nbinding the properties that a nested template depends on to the template\nas `_host_&lt;property>`.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2587,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2597,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;node&quot;,&quot;type&quot;:&quot;Node&quot;,&quot;description&quot;:&quot;Node to parse&quot;},{&quot;name&quot;:&quot;templateInfo&quot;,&quot;type&quot;:&quot;TemplateInfo&quot;,&quot;description&quot;:&quot;Template metadata for current template&quot;},{&quot;name&quot;:&quot;nodeInfo&quot;,&quot;type&quot;:&quot;NodeInfo&quot;,&quot;description&quot;:&quot;Node metadata for current template node&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;boolean&quot;,&quot;desc&quot;:&quot;`true` if the visited node added node-specific\n  metadata to `nodeInfo`&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_parseTemplateNodeAttributes&quot;,&quot;description&quot;:&quot;Parses template node attributes and adds node metadata to `nodeInfo`\nfor nodes of interest.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;template-stamp.js&quot;,&quot;start&quot;:{&quot;line&quot;:327,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:336,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;node&quot;,&quot;type&quot;:&quot;Element&quot;,&quot;description&quot;:&quot;Node to parse&quot;},{&quot;name&quot;:&quot;templateInfo&quot;,&quot;type&quot;:&quot;TemplateInfo&quot;,&quot;description&quot;:&quot;Template metadata for current template&quot;},{&quot;name&quot;:&quot;nodeInfo&quot;,&quot;type&quot;:&quot;NodeInfo&quot;,&quot;description&quot;:&quot;Node metadata for current template.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;boolean&quot;,&quot;desc&quot;:&quot;`true` if the visited node added node-specific\n  metadata to `nodeInfo`&quot;},&quot;inheritedFrom&quot;:&quot;TemplateStamp&quot;},{&quot;name&quot;:&quot;_parseTemplateNodeAttribute&quot;,&quot;description&quot;:&quot;Overrides default `TemplateStamp` implementation to add support for\nparsing bindings from attributes.  A `bindings`\narray is added to `nodeInfo` and populated with binding metadata\nwith information capturing the binding target, and a `parts` array\nwith one or more metadata objects capturing the source(s) of the\nbinding.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2530,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2571,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;node&quot;,&quot;type&quot;:&quot;Element&quot;,&quot;description&quot;:&quot;Node to parse&quot;},{&quot;name&quot;:&quot;templateInfo&quot;,&quot;type&quot;:&quot;TemplateInfo&quot;,&quot;description&quot;:&quot;Template metadata for current template&quot;},{&quot;name&quot;:&quot;nodeInfo&quot;,&quot;type&quot;:&quot;NodeInfo&quot;,&quot;description&quot;:&quot;Node metadata for current template node&quot;},{&quot;name&quot;:&quot;name&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Attribute name&quot;},{&quot;name&quot;:&quot;value&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Attribute value&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;boolean&quot;,&quot;desc&quot;:&quot;`true` if the visited node added node-specific\n  metadata to `nodeInfo`&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_contentForTemplate&quot;,&quot;description&quot;:&quot;Returns the `content` document fragment for a given template.\n\nFor nested templates, Polymer performs an optimization to cache nested\ntemplate content to avoid the cost of cloning deeply nested templates.\nThis method retrieves the cached content for a given template.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;template-stamp.js&quot;,&quot;start&quot;:{&quot;line&quot;:382,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:385,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;template&quot;,&quot;type&quot;:&quot;HTMLTemplateElement&quot;,&quot;description&quot;:&quot;Template to retrieve `content` for&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;DocumentFragment&quot;,&quot;desc&quot;:&quot;Content fragment&quot;},&quot;inheritedFrom&quot;:&quot;TemplateStamp&quot;},{&quot;name&quot;:&quot;createProperties&quot;,&quot;description&quot;:&quot;Override of PropertiesChanged createProperties to create accessors\nand property effects for all of the properties.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:320,&quot;column&quot;:5},&quot;end&quot;:{&quot;line&quot;:324,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;props&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;}},{&quot;name&quot;:&quot;attributeNameForProperty&quot;,&quot;description&quot;:&quot;Returns an attribute name that corresponds to the given property.\nThe attribute name is the lowercased property name. Override to\ncustomize this mapping.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-changed.js&quot;,&quot;start&quot;:{&quot;line&quot;:71,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:73,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property to convert&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;string&quot;,&quot;desc&quot;:&quot;Attribute name corresponding to the given property.&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesChanged&quot;},{&quot;name&quot;:&quot;typeForProperty&quot;,&quot;description&quot;:&quot;Overrides `PropertiesChanged` method to return type specified in the\nstatic `properties` object for the given property.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-mixin.js&quot;,&quot;start&quot;:{&quot;line&quot;:175,&quot;column&quot;:3},&quot;end&quot;:{&quot;line&quot;:178,&quot;column&quot;:4}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;name&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of property&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;*&quot;,&quot;desc&quot;:&quot;Type to which to deserialize attribute&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesMixin&quot;},{&quot;name&quot;:&quot;createPropertiesForAttributes&quot;,&quot;description&quot;:&quot;Generates property accessors for all attributes in the standard\nstatic `observedAttributes` array.\n\nAttribute names are mapped to property names using the `dash-case` to\n`camelCase` convention&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-accessors.js&quot;,&quot;start&quot;:{&quot;line&quot;:122,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:127,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyAccessors&quot;},{&quot;name&quot;:&quot;addPropertyEffect&quot;,&quot;description&quot;:&quot;Ensures an accessor exists for the specified property, and adds\nto a list of \&quot;property effects\&quot; that will run when the accessor for\nthe specified property is set.  Effects are grouped by \&quot;type\&quot;, which\nroughly corresponds to a phase in effect processing.  The effect\nmetadata should be in the following form:\n\n    {\n      fn: effectFunction, // Reference to function to call to perform effect\n      info: { ... }       // Effect metadata passed to function\n      trigger: {          // Optional triggering metadata; if not provided\n        name: string      // the property is treated as a wildcard\n        structured: boolean\n        wildcard: boolean\n      }\n    }\n\nEffects are called from `_propertiesChanged` in the following order by\ntype:\n\n1. COMPUTE\n2. PROPAGATE\n3. REFLECT\n4. OBSERVE\n5. NOTIFY\n\nEffect functions are called with the following signature:\n\n    effectFunction(inst, path, props, oldProps, info, hasPaths)&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2216,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2218,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property that should trigger the effect&quot;},{&quot;name&quot;:&quot;type&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Effect type, from this.PROPERTY_EFFECT_TYPES&quot;},{&quot;name&quot;:&quot;effect&quot;,&quot;type&quot;:&quot;Object=&quot;,&quot;description&quot;:&quot;Effect metadata object&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;createPropertyObserver&quot;,&quot;description&quot;:&quot;Creates a single-property observer for the given property.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2230,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2232,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;},{&quot;name&quot;:&quot;method&quot;,&quot;type&quot;:&quot;(string | function (*, *))&quot;,&quot;description&quot;:&quot;Function or name of observer method to call&quot;},{&quot;name&quot;:&quot;dynamicFn&quot;,&quot;type&quot;:&quot;boolean=&quot;,&quot;description&quot;:&quot;Whether the method name should be included as\n  a dependency to the effect.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;createMethodObserver&quot;,&quot;description&quot;:&quot;Creates a multi-property \&quot;method observer\&quot; based on the provided\nexpression, which should be a string in the form of a normal JavaScript\nfunction signature: `&apos;methodName(arg1, [..., argn])&apos;`.  Each argument\nshould correspond to a property or path in the context of this\nprototype (or instance), or may be a literal string or number.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2247,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2249,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;expression&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Method expression&quot;},{&quot;name&quot;:&quot;dynamicFn&quot;,&quot;type&quot;:&quot;(boolean | Object)=&quot;,&quot;description&quot;:&quot;Boolean or object map indicating&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;,&quot;desc&quot;:&quot;whether method names should be included as a dependency to the effect.&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;createNotifyingProperty&quot;,&quot;description&quot;:&quot;Causes the setter for the given property to dispatch `&lt;property>-changed`\nevents to notify of changes to the property.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2259,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2261,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;createReadOnlyProperty&quot;,&quot;description&quot;:&quot;Creates a read-only accessor for the given property.\n\nTo set the property, use the protected `_setProperty` API.\nTo create a custom protected setter (e.g. `_setMyProp()` for\nproperty `myProp`), pass `true` for `protectedSetter`.\n\nNote, if the property will have other property effects, this method\nshould be called first, before adding other effects.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2279,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2281,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;},{&quot;name&quot;:&quot;protectedSetter&quot;,&quot;type&quot;:&quot;boolean=&quot;,&quot;description&quot;:&quot;Creates a custom protected setter\n  when `true`.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;createReflectedProperty&quot;,&quot;description&quot;:&quot;Causes the setter for the given property to reflect the property value\nto a (dash-cased) attribute of the same name.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2291,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2293,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property name&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;createComputedProperty&quot;,&quot;description&quot;:&quot;Creates a computed property whose value is set to the result of the\nmethod described by the given `expression` each time one or more\narguments to the method changes.  The expression should be a string\nin the form of a normal JavaScript function signature:\n`&apos;methodName(arg1, [..., argn])&apos;`&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2309,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2311,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;property&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Name of computed property to set&quot;},{&quot;name&quot;:&quot;expression&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Method expression&quot;},{&quot;name&quot;:&quot;dynamicFn&quot;,&quot;type&quot;:&quot;(boolean | Object)=&quot;,&quot;description&quot;:&quot;Boolean or object map indicating whether\n  method names should be included as a dependency to the effect.&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;bindTemplate&quot;,&quot;description&quot;:&quot;Parses the provided template to ensure binding effects are created\nfor them, and then ensures property accessors are created for any\ndependent properties in the template.  Binding effects for bound\ntemplates are stored in a linked list on the instance so that\ntemplates can be efficiently stamped and unstamped.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2325,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2327,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;template&quot;,&quot;type&quot;:&quot;!HTMLTemplateElement&quot;,&quot;description&quot;:&quot;Template containing binding\n  bindings&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;!TemplateInfo&quot;,&quot;desc&quot;:&quot;Template metadata object&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_addTemplatePropertyEffect&quot;,&quot;description&quot;:&quot;Adds a property effect to the given template metadata, which is run\nat the \&quot;propagate\&quot; stage of `_propertiesChanged` when the template\nhas been bound to the element via `_bindTemplate`.\n\nThe `effect` object should match the format in `_addPropertyEffect`.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2391,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2397,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;templateInfo&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;Template metadata to add effect to&quot;},{&quot;name&quot;:&quot;prop&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property that should trigger the effect&quot;},{&quot;name&quot;:&quot;effect&quot;,&quot;type&quot;:&quot;Object=&quot;,&quot;description&quot;:&quot;Effect metadata object&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_parseBindings&quot;,&quot;description&quot;:&quot;Called to parse text in a template (either attribute values or\ntextContent) into binding metadata.\n\nAny overrides of this method should return an array of binding part\nmetadata  representing one or more bindings found in the provided text\nand any \&quot;literal\&quot; text in between.  Any non-literal parts will be passed\nto `_evaluateBinding` when any dependencies change.  The only required\nfields of each \&quot;part\&quot; in the returned array are as follows:\n\n- `dependencies` - Array containing trigger metadata for each property\n  that should trigger the binding to update\n- `literal` - String containing text if the part represents a literal;\n  in this case no `dependencies` are needed\n\nAdditional metadata for use by `_evaluateBinding` may be provided in\neach part object as needed.\n\nThe default implementation handles the following types of bindings\n(one or more may be intermixed with literal strings):\n- Property binding: `[[prop]]`\n- Path binding: `[[object.prop]]`\n- Negated property or path bindings: `[[!prop]]` or `[[!object.prop]]`\n- Two-way property or path bindings (supports negation):\n  `{{prop}}`, `{{object.prop}}`, `{{!prop}}` or `{{!object.prop}}`\n- Inline computed method (supports negation):\n  `[[compute(a, &apos;literal&apos;, b)]]`, `[[!compute(a, &apos;literal&apos;, b)]]`\n\nThe default implementation uses a regular expression for best\nperformance. However, the regular expression uses a white-list of\nallowed characters in a data-binding, which causes problems for\ndata-bindings that do use characters not in this white-list.\n\nInstead of updating the white-list with all allowed characters,\nthere is a StrictBindingParser (see lib/mixins/strict-binding-parser)\nthat uses a state machine instead. This state machine is able to handle\nall characters. However, it is slightly less performant, therefore we\nextracted it into a separate optional mixin.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2643,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2708,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;text&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Text to parse from attribute or textContent&quot;},{&quot;name&quot;:&quot;templateInfo&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;Current template metadata&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;Array.&lt;!BindingPart>&quot;,&quot;desc&quot;:&quot;Array of binding part metadata&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;_evaluateBinding&quot;,&quot;description&quot;:&quot;Called to evaluate a previously parsed binding part based on a set of\none or more changed dependencies.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;property-effects.js&quot;,&quot;start&quot;:{&quot;line&quot;:2724,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:2741,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;inst&quot;,&quot;type&quot;:&quot;this&quot;,&quot;description&quot;:&quot;Element that should be used as scope for\n  binding dependencies&quot;},{&quot;name&quot;:&quot;part&quot;,&quot;type&quot;:&quot;BindingPart&quot;,&quot;description&quot;:&quot;Binding part metadata&quot;},{&quot;name&quot;:&quot;path&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Property/path that triggered this effect&quot;},{&quot;name&quot;:&quot;props&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;Bag of current property changes&quot;},{&quot;name&quot;:&quot;oldProps&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;Bag of previous values for changed properties&quot;},{&quot;name&quot;:&quot;hasPaths&quot;,&quot;type&quot;:&quot;boolean&quot;,&quot;description&quot;:&quot;True with `props` contains one or more paths&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;*&quot;,&quot;desc&quot;:&quot;Value the binding part evaluated to&quot;},&quot;inheritedFrom&quot;:&quot;PropertyEffects&quot;},{&quot;name&quot;:&quot;finalize&quot;,&quot;description&quot;:&quot;Finalizes an element definition, including ensuring any super classes\nare also finalized. This includes ensuring property\naccessors exist on the element prototype. This method calls\n`_finalizeClass` to finalize each constructor in the prototype chain.&quot;,&quot;privacy&quot;:&quot;public&quot;,&quot;sourceRange&quot;:{&quot;file&quot;:&quot;properties-mixin.js&quot;,&quot;start&quot;:{&quot;line&quot;:123,&quot;column&quot;:3},&quot;end&quot;:{&quot;line&quot;:132,&quot;column&quot;:4}},&quot;metadata&quot;:{},&quot;params&quot;:[],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;},&quot;inheritedFrom&quot;:&quot;PropertiesMixin&quot;},{&quot;name&quot;:&quot;_finalizeClass&quot;,&quot;description&quot;:&quot;Override of PropertiesMixin _finalizeClass to create observers and\nfind the template.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:288,&quot;column&quot;:3},&quot;end&quot;:{&quot;line&quot;:311,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;}},{&quot;name&quot;:&quot;createObservers&quot;,&quot;description&quot;:&quot;Creates observers for the given `observers` array.\nLeverages `PropertyEffects` to create observers.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:337,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:342,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;observers&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;Array of observer descriptors for\n  this class&quot;},{&quot;name&quot;:&quot;dynamicFns&quot;,&quot;type&quot;:&quot;Object&quot;,&quot;description&quot;:&quot;Object containing keys for any properties\n  that are functions and should trigger the effect when the function\n  reference is changed&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;}},{&quot;name&quot;:&quot;_processStyleText&quot;,&quot;description&quot;:&quot;Gather style text for a style element in the template.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:497,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:499,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;cssText&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Text containing styling to process&quot;},{&quot;name&quot;:&quot;baseURI&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Base URI to rebase CSS paths against&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;string&quot;,&quot;desc&quot;:&quot;The processed CSS text&quot;}},{&quot;name&quot;:&quot;_finalizeTemplate&quot;,&quot;description&quot;:&quot;Configures an element `proto` to function with a given `template`.\nThe element name `is` and extends `ext` must be specified for ShadyCSS\nstyle scoping.&quot;,&quot;privacy&quot;:&quot;protected&quot;,&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:510,&quot;column&quot;:4},&quot;end&quot;:{&quot;line&quot;:521,&quot;column&quot;:5}},&quot;metadata&quot;:{},&quot;params&quot;:[{&quot;name&quot;:&quot;is&quot;,&quot;type&quot;:&quot;string&quot;,&quot;description&quot;:&quot;Tag name (or type extension name) for this element&quot;}],&quot;return&quot;:{&quot;type&quot;:&quot;void&quot;}}],&quot;demos&quot;:[],&quot;metadata&quot;:{},&quot;sourceRange&quot;:{&quot;start&quot;:{&quot;line&quot;:88,&quot;column&quot;:7},&quot;end&quot;:{&quot;line&quot;:672,&quot;column&quot;:3}},&quot;privacy&quot;:&quot;public&quot;,&quot;name&quot;:&quot;ElementMixin&quot;,&quot;attributes&quot;:[],&quot;events&quot;:[],&quot;styling&quot;:{&quot;cssVariables&quot;:[],&quot;selectors&quot;:[]},&quot;slots&quot;:[],&quot;mixins&quot;:[&quot;PropertyEffects&quot;,&quot;PropertiesMixin&quot;]}]}"></iron-doc-module>
+
+
+<script>
+   window.addEventListener('WebComponentsReady', function() {
+     document.querySelector('iron-doc-module').scrollToAnchor();
+   });
+   window.addEventListener('hashchange', function() {
+     document.querySelector('iron-doc-module').scrollToAnchor();
+   });
+</script>
diff --git a/iron-doc-viewer-behavior.html b/iron-doc-viewer-behavior.html
index ccb9221..e7bc096 100644
--- a/iron-doc-viewer-behavior.html
+++ b/iron-doc-viewer-behavior.html
@@ -85,33 +85,45 @@
      */
     scrollToAnchor: function(hash) {
       hash = hash || window.location.hash;
-      if (hash && hash.length > 0) {
-        if (hash.indexOf('#') === 0) {
-          hash = hash.substring(1);
-        }
-        // Ensure dom-repeats have stamped.
-        Polymer.dom.flush();
-        var anchor = this.fragmentPrefix + hash;
-        var element = this.$$('[anchor-id="' + anchor + '"]');
-        if (element) {
-          // Don't scroll until we've drawn the next frame, otherwise our
-          // element might not know it's final screen position yet.
-          Polymer.RenderStatus.afterNextRender(this, function() {
-            element.scrollIntoView({behavior: 'smooth'});
-            // Highlight the section for a moment so we can tell where
-            // exactly we were deep-linked.
-            element.classList.add('scrolled');
-            this.async(function() {
-              element.classList.remove('scrolled');
-            }, 1000);
-          });
-
-        } else {
-          // Maybe our API section has this anchor.
-          var api = this.$$('iron-doc-api');
-          if (api) {
-            api.scrollToAnchor(hash);
-          }
+      if (!hash || hash.length == 0) {
+        return;
+      }
+      if (hash.indexOf('#') === 0) {
+        hash = hash.substring(1);
+      }
+      // Ensure dom-repeats have stamped.
+      Polymer.dom.flush();
+      var anchor = this.fragmentPrefix + hash;
+      var element = this.$$('[anchor-id="' + anchor + '"]');
+      if (element) {
+        // Don't scroll until we've drawn the next frame, otherwise our
+        // element might not know it's final screen position yet.
+        Polymer.RenderStatus.afterNextRender(this, function() {
+          element.scrollIntoView({behavior: 'smooth'});
+          // Highlight the section for a moment so we can tell where
+          // exactly we were deep-linked.
+          element.classList.add('scrolled');
+          this.async(function() {
+            element.classList.remove('scrolled');
+          }, 1000);
+        });
+        return;
+      }
+      // Maybe our API section has this anchor.
+      var api = this.$$('iron-doc-api');
+      if (api) {
+        api.scrollToAnchor(hash);
+        return;
+      }
+
+      // Maybe some other subsection has the anchor.
+      var subElements = this.root.querySelectorAll('*');
+      for (var i = 0; i < subElements.length; i++) {
+        var element = subElements[i];
+        if (element.fragmentPrefix && element.scrollToAnchor
+            && hash.indexOf(element.fragmentPrefix) === 0) {
+          element.scrollToAnchor(hash.slice(element.fragmentPrefix.length));
+          return;
         }
       }
     },

From dcf5f6f80d0e478e8e893d61a1c5cb67d281ab8c Mon Sep 17 00:00:00 2001
From: Peter Burns <rictic@google.com>
Date: Wed, 2 May 2018 12:56:23 -0700
Subject: [PATCH 2/3] format

---
 demo/iron-doc-module.html     | 12 ++++++------
 iron-doc-viewer-behavior.html |  4 ++--
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/demo/iron-doc-module.html b/demo/iron-doc-module.html
index b5a4172..6c7efea 100644
--- a/demo/iron-doc-module.html
+++ b/demo/iron-doc-module.html
@@ -15,10 +15,10 @@
 
 
 <script>
-   window.addEventListener('WebComponentsReady', function() {
-     document.querySelector('iron-doc-module').scrollToAnchor();
-   });
-   window.addEventListener('hashchange', function() {
-     document.querySelector('iron-doc-module').scrollToAnchor();
-   });
+  window.addEventListener('WebComponentsReady', function() {
+    document.querySelector('iron-doc-module').scrollToAnchor();
+  });
+  window.addEventListener('hashchange', function() {
+    document.querySelector('iron-doc-module').scrollToAnchor();
+  });
 </script>
diff --git a/iron-doc-viewer-behavior.html b/iron-doc-viewer-behavior.html
index e7bc096..c7df824 100644
--- a/iron-doc-viewer-behavior.html
+++ b/iron-doc-viewer-behavior.html
@@ -120,8 +120,8 @@
       var subElements = this.root.querySelectorAll('*');
       for (var i = 0; i < subElements.length; i++) {
         var element = subElements[i];
-        if (element.fragmentPrefix && element.scrollToAnchor
-            && hash.indexOf(element.fragmentPrefix) === 0) {
+        if (element.fragmentPrefix && element.scrollToAnchor &&
+            hash.indexOf(element.fragmentPrefix) === 0) {
           element.scrollToAnchor(hash.slice(element.fragmentPrefix.length));
           return;
         }

From 83be0d2c1b9e29f481672332a903c56481e636b5 Mon Sep 17 00:00:00 2001
From: Peter Burns <rictic@google.com>
Date: Wed, 2 May 2018 14:31:04 -0700
Subject: [PATCH 3/3] == -> ===

---
 iron-doc-viewer-behavior.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/iron-doc-viewer-behavior.html b/iron-doc-viewer-behavior.html
index c7df824..fb5e50c 100644
--- a/iron-doc-viewer-behavior.html
+++ b/iron-doc-viewer-behavior.html
@@ -85,7 +85,7 @@
      */
     scrollToAnchor: function(hash) {
       hash = hash || window.location.hash;
-      if (!hash || hash.length == 0) {
+      if (!hash || hash.length === 0) {
         return;
       }
       if (hash.indexOf('#') === 0) {