@ui5/webcomponents 0.0.0-e7dd012d7 → 0.0.0-ec448881d

package/src/types/TabsOverflowMode.js

@@ -0,0 +1,40 @@
+import DataType from "@ui5/webcomponents-base/dist/types/DataType.js";
+
+/**
+ * @lends sap.ui.webcomponents.main.types.TabsOverflowMode.prototype
+ * @public
+ */
+const TabsOverflowModes = {
+	/**
+	 * End type is used if there should be only one overflow with hidden the tabs at the end of the tab container.
+	 * @public
+	 * @type {End}
+	 */
+	End: "End",
+
+	/**
+	 * StartAndEnd type is used if there should be two overflows on both ends of the tab container.
+	 * @public
+	 * @type {StartAndEnd}
+	 */
+	StartAndEnd: "StartAndEnd",
+};
+
+/**
+ * @class
+ * Different types of overflow modes.
+ * @constructor
+ * @author SAP SE
+ * @alias sap.ui.webcomponents.main.types.TabsOverflowMode
+ * @public
+ * @enum {string}
+ */
+class TabsOverflowMode extends DataType {
+	static isValid(value) {
+		return !!TabsOverflowModes[value];
+	}
+}
+
+TabsOverflowMode.generateTypeAccessors(TabsOverflowModes);
+
+export default TabsOverflowMode;

package/src/types/TitleLevel.js

@@ -63,6 +63,6 @@ class TitleLevel extends DataType {
 	}
 }
 
-TitleLevel.generateTypeAcessors(TitleLevels);
+TitleLevel.generateTypeAccessors(TitleLevels);
 
 export default TitleLevel;

package/src/types/ToastPlacement.js

@@ -1,6 +1,5 @@
 import DataType from "@ui5/webcomponents-base/dist/types/DataType.js";
 
-
 /**
  * @lends sap.ui.webcomponents.main.types.ToastPlacement.prototype
  * @public
@@ -87,6 +86,6 @@ class ToastPlacement extends DataType {
 	}
 }
 
-ToastPlacement.generateTypeAcessors(ToastPlacements);
+ToastPlacement.generateTypeAccessors(ToastPlacements);
 
 export default ToastPlacement;

package/src/types/WrappingType.js

@@ -0,0 +1,41 @@
+import DataType from "@ui5/webcomponents-base/dist/types/DataType.js";
+
+/**
+ * Different types of wrapping.
+ * @lends sap.ui.webcomponents.main.types.WrappingType.prototype
+ * @public
+ */
+const WrappingTypes = {
+	/**
+	 * The text will be truncated with an ellipsis.
+	 * @public
+	 * @type {None}
+	 */
+	None: "None",
+
+	/**
+	 * The text will wrap. The words will not be broken based on hyphenation.
+	 * @public
+	 * @type {Normal}
+	 */
+	Normal: "Normal",
+};
+
+/**
+ * @class
+ * Defines how the text of a component will be displayed when there is not enough space.
+ * @constructor
+ * @author SAP SE
+ * @alias sap.ui.webcomponents.main.types.WrappingType
+ * @public
+ * @enum {string}
+ */
+class WrappingType extends DataType {
+	static isValid(value) {
+		return !!WrappingTypes[value];
+	}
+}
+
+WrappingType.generateTypeAccessors(WrappingTypes);
+
+export default WrappingType;

package/dist/ComboBoxFilters.js

@@ -1,40 +0,0 @@
-const escapeReg = /[[\]{}()*+?.\\^$|]/g;
-
-const escapeRegExp = str => {
-	return str.replace(escapeReg, "\\$&");
-};
-
-const StartsWith = (value, items) => {
-	return items.filter(item => {
-		const lowerText = item.text.toLowerCase();
-
-		return lowerText.startsWith(value.toLowerCase());
-	});
-};
-
-const StartsWithPerTerm = (value, items) => {
-	const reg = new RegExp(`(^|\\s)${escapeRegExp(value.toLowerCase())}.*`, "g");
-
-	return items.filter(item => {
-		reg.lastIndex = 0;
-
-		return reg.test(item.text.toLowerCase());
-	});
-};
-
-const Contains = (value, items) => {
-	return items.filter(item => {
-		const lowerText = item.text.toLowerCase();
-
-		return lowerText.includes(value.toLowerCase());
-	});
-};
-
-const None = (_, items) => items;
-
-export {
-	StartsWithPerTerm,
-	StartsWith,
-	Contains,
-	None,
-};

package/dist/generated/templates/ComboBoxItemTemplate.lit.js

@@ -1,14 +0,0 @@
-
-/* eslint no-unused-vars: 0 */
-import ifDefined from '@ui5/webcomponents-base/dist/renderer/ifDefined.js';
-import { html, svg, repeat, classMap, styleMap, unsafeHTML, setTags, setSuffix } from '@ui5/webcomponents-base/dist/renderer/LitRenderer.js';
-const block0 = (context) => { return html``; };
-
-
-const main = (context, tags, suffix) => {
-	setTags(tags);
-	setSuffix(suffix);
-	return block0(context);
-};
- 
-export default main;

package/dist/generated/templates/DateRangePickerTemplate.lit.js

@@ -1,16 +0,0 @@
-
-/* eslint no-unused-vars: 0 */
-import ifDefined from '@ui5/webcomponents-base/dist/renderer/ifDefined.js';
-import { html, svg, repeat, classMap, styleMap, unsafeHTML, setTags, setSuffix } from '@ui5/webcomponents-base/dist/renderer/LitRenderer.js';
-const block0 = (context) => { return html`<div class="ui5-date-picker-root" style="${styleMap(context.styles.main)}" @keydown=${context._onkeydown} @focusout="${context._onfocusout}"><!-- INPUT --><ui5-input id="${ifDefined(context._id)}-inner" class="ui5-date-picker-input" placeholder="${ifDefined(context._placeholder)}" type="${ifDefined(context.type)}" value="${ifDefined(context.value)}" ?disabled="${context.disabled}" ?readonly="${context.readonly}" value-state="${ifDefined(context.valueState)}" @ui5-change="${ifDefined(context._handleInputChange)}" @ui5-input="${ifDefined(context._handleInputLiveChange)}" data-sap-focus-ref ._inputAccInfo ="${ifDefined(context.accInfo)}">${ context.valueStateMessage.length ? block1(context) : undefined }${ !context.readonly ? block2(context) : undefined }</ui5-input><slot name="formSupport"></slot></div>`; };
-const block1 = (context) => { return html`<slot name="valueStateMessage" slot="valueStateMessage"></slot>`; };
-const block2 = (context) => { return html`<ui5-icon slot="icon" name="${ifDefined(context.openIconName)}" tabindex="-1" accessible-name="${ifDefined(context.openIconTitle)}" show-tooltip @click="${context.togglePicker}" input-icon ?pressed="${context._isPickerOpen}" dir="${ifDefined(context.effectiveDir)}"></ui5-icon>`; };
-
-
-const main = (context, tags, suffix) => {
-	setTags(tags);
-	setSuffix(suffix);
-	return block0(context);
-};
- 
-export default main;

package/dist/generated/templates/DurationPickerPopoverTemplate.lit.js

@@ -1,17 +0,0 @@
-
-/* eslint no-unused-vars: 0 */
-import ifDefined from '@ui5/webcomponents-base/dist/renderer/ifDefined.js';
-import { html, svg, repeat, classMap, styleMap, unsafeHTML, setTags, setSuffix } from '@ui5/webcomponents-base/dist/renderer/LitRenderer.js';
-const block0 = (context) => { return html`<ui5-responsive-popover allow-target-overlap="${ifDefined(context._respPopover.allowTargetOverlap)}" placement-type="${ifDefined(context._respPopover.placementType)}" _hide-header no-arrow no-stretch horizontal-align="${ifDefined(context._respPopover.horizontalAlign)}" stay-open-on-scroll="${ifDefined(context._respPopover.stayOpenOnScroll)}" @ui5-after-close="${ifDefined(context._respPopover._onAfterClose)}" @keydown="${context._handleKeysDown}"><div class="${classMap(context.classes.container)}" @keydown="${context._handleContainerKeysDown}">${ !context.hideHours ? block1(context) : undefined }${ !context.hideMinutes ? block2(context) : undefined }${ !context.hideSeconds ? block3(context) : undefined }</div><div slot="footer" class="ui5-duration-picker-footer" @keydown=${context._onfooterkeydown}><ui5-button id="submit" design="Emphasized" @click="${context.submitPickers}">${ifDefined(context.submitButtonLabel)}</ui5-button><ui5-button id="close" design="Transparent" @click="${context.togglePicker}">${ifDefined(context.cancelButtonLabel)}</ui5-button></div></ui5-responsive-popover>`; };
-const block1 = (context) => { return html`<ui5-wheelslider cyclic="true" ._items="${ifDefined(context.hoursArray)}" value="${ifDefined(context.selectedHours)}" class="ui5-duration-picker-wheelslider ui5-duration-picker-hours-wheelslider" label = "${ifDefined(context.hoursSliderTitle)}"></ui5-wheelslider>`; };
-const block2 = (context) => { return html`<ui5-wheelslider cyclic="true" ._items="${ifDefined(context.minutesArray)}" value="${ifDefined(context.selectedMinutes)}" class="ui5-duration-picker-wheelslider ui5-duration-picker-minutes-wheelslider" label = "${ifDefined(context.minutesSliderTitle)}"></ui5-wheelslider>`; };
-const block3 = (context) => { return html`<ui5-wheelslider cyclic="true" ._items="${ifDefined(context.secondsArray)}" value="${ifDefined(context.selectedSeconds)}" class="ui5-duration-picker-wheelslider ui5-duration-picker-seconds-wheelslider" label = "${ifDefined(context.secondsSliderTitle)}"></ui5-wheelslider>`; };
-
-
-const main = (context, tags, suffix) => {
-	setTags(tags);
-	setSuffix(suffix);
-	return block0(context);
-};
- 
-export default main;

package/dist/generated/templates/DurationPickerTemplate.lit.js

@@ -1,16 +0,0 @@
-
-/* eslint no-unused-vars: 0 */
-import ifDefined from '@ui5/webcomponents-base/dist/renderer/ifDefined.js';
-import { html, svg, repeat, classMap, styleMap, unsafeHTML, setTags, setSuffix } from '@ui5/webcomponents-base/dist/renderer/LitRenderer.js';
-const block0 = (context) => { return html`<div class="ui5-duration-picker-root"><ui5-input value="${ifDefined(context.value)}" ?disabled="${context.disabled}" ?readonly="${context.readonly}" value-state="${ifDefined(context.valueState)}" @ui5-change="${ifDefined(context._handleInputChange)}" @ui5-input="${ifDefined(context._handleInputLiveChange)}" @keydown="${context._onkeydown}" class="ui5-duration-picker-input">${ !context.readonly ? block1(context) : undefined }${ context.valueStateMessage.length ? block2(context) : undefined }</ui5-input></div>`; };
-const block1 = (context) => { return html`<ui5-icon slot="icon" name="fob-watch" tabindex="-1" show-tooltip @click="${context.togglePicker}" input-icon ?pressed="${context._isPickerOpen}" class="ui5-duration-picker-input-icon-button"></ui5-icon>`; };
-const block2 = (context) => { return html`<slot name="valueStateMessage" slot="valueStateMessage"></slot>`; };
-
-
-const main = (context, tags, suffix) => {
-	setTags(tags);
-	setSuffix(suffix);
-	return block0(context);
-};
- 
-export default main;

package/dist/generated/templates/TabSeparatorTemplate.lit.js

@@ -1,14 +0,0 @@
-
-/* eslint no-unused-vars: 0 */
-import ifDefined from '@ui5/webcomponents-base/dist/renderer/ifDefined.js';
-import { html, svg, repeat, classMap, styleMap, unsafeHTML, setTags, setSuffix } from '@ui5/webcomponents-base/dist/renderer/LitRenderer.js';
-const block0 = (context) => { return html`<li id="${ifDefined(context._id)}" role="separator" style="list-style-type: none;"></li>`; };
-
-
-const main = (context, tags, suffix) => {
-	setTags(tags);
-	setSuffix(suffix);
-	return block0(context);
-};
- 
-export default main;

package/dist/generated/themes/ComboBoxItem.css.js

@@ -1,8 +0,0 @@
-import { registerThemeProperties } from "@ui5/webcomponents-base/dist/asset-registries/Themes.js";
-
-import defaultThemeBase from "@ui5/webcomponents-theme-base/dist/generated/themes/sap_fiori_3/parameters-bundle.css.js";
-import defaultTheme from "./sap_fiori_3/parameters-bundle.css.js";
-
-registerThemeProperties("@ui5/webcomponents-theme-base", "sap_fiori_3", defaultThemeBase);
-registerThemeProperties("@ui5/webcomponents", "sap_fiori_3", defaultTheme);
-export default "";

package/dist/generated/themes/DurationPicker.css.js

@@ -1,8 +0,0 @@
-import { registerThemeProperties } from "@ui5/webcomponents-base/dist/asset-registries/Themes.js";
-
-import defaultThemeBase from "@ui5/webcomponents-theme-base/dist/generated/themes/sap_fiori_3/parameters-bundle.css.js";
-import defaultTheme from "./sap_fiori_3/parameters-bundle.css.js";
-
-registerThemeProperties("@ui5/webcomponents-theme-base", "sap_fiori_3", defaultThemeBase);
-registerThemeProperties("@ui5/webcomponents", "sap_fiori_3", defaultTheme);
-export default ":host(:not([hidden])){display:inline-block}:host{color:var(--sapField_TextColor);background-color:var(--sapField_Background)}:host .ui5-duration-picker-input{width:100%;color:inherit;background-color:inherit}.ui5-duration-picker-input-icon-button:hover{cursor:pointer;background:var(--sapButton_Hover_Background)}.ui5-duration-picker-input-icon-button:active{background-color:var(--sapButton_Active_Background);color:var(--sapButton_Active_TextColor)}.ui5-duration-picker-input-icon-button[pressed]{background-color:var(--sapButton_Active_Background);color:var(--sapButton_Active_TextColor)}";

package/dist/generated/themes/DurationPickerPopover.css.js

@@ -1,8 +0,0 @@
-import { registerThemeProperties } from "@ui5/webcomponents-base/dist/asset-registries/Themes.js";
-
-import defaultThemeBase from "@ui5/webcomponents-theme-base/dist/generated/themes/sap_fiori_3/parameters-bundle.css.js";
-import defaultTheme from "./sap_fiori_3/parameters-bundle.css.js";
-
-registerThemeProperties("@ui5/webcomponents-theme-base", "sap_fiori_3", defaultThemeBase);
-registerThemeProperties("@ui5/webcomponents", "sap_fiori_3", defaultTheme);
-export default ".ui5-duration-picker-sliders-container{display:flex;justify-content:center;align-items:stretch;direction:ltr;padding:.5rem;min-width:18rem}.ui5-duration-picker-sliders-container.ui5-phone{height:90vh}.ui5-duration-picker-wheelslider{padding-left:.25rem;padding-right:.25rem}.ui5-duration-picker-footer{height:fit-content;display:flex;justify-content:flex-end;width:100%}.ui5-duration-picker-footer>[ui5-button]{margin:1%;min-width:20%}";

package/dist/popup-utils/PopupUtils.js

@@ -1,84 +0,0 @@
-let currentZIndex = 100;
-
-const getFocusedElement = () => {
-	let element = document.activeElement;
-
-	while (element && element.shadowRoot && element.shadowRoot.activeElement) {
-		element = element.shadowRoot.activeElement;
-	}
-
-	return (element && typeof element.focus === "function") ? element : null;
-};
-
-const isFocusedElementWithinNode = node => {
-	const fe = getFocusedElement();
-
-	if (fe) {
-		return isNodeContainedWithin(node, fe);
-	}
-
-	return false;
-};
-
-const isNodeContainedWithin = (parent, child) => {
-	let currentNode = parent;
-
-	if (currentNode.shadowRoot) {
-		currentNode = Array.from(currentNode.shadowRoot.children).find(n => n.localName !== "style");
-	}
-
-	if (currentNode === child) {
-		return true;
-	}
-
-	const childNodes = currentNode.localName === "slot" ? currentNode.assignedNodes() : currentNode.children;
-
-	if (childNodes) {
-		return Array.from(childNodes).some(n => isNodeContainedWithin(n, child));
-	}
-};
-
-const isPointInRect = (x, y, rect) => {
-	return x >= rect.left && x <= rect.right
-		&& y >= rect.top && y <= rect.bottom;
-};
-
-const isClickInRect = (event, rect) => {
-	let x;
-	let y;
-
-	if (event.touches) {
-		const touch = event.touches[0];
-		x = touch.clientX;
-		y = touch.clientY;
-	} else {
-		x = event.clientX;
-		y = event.clientY;
-	}
-
-	return isPointInRect(x, y, rect);
-};
-
-const getClosedPopupParent = el => {
-	const parent = el.parentElement || (el.getRootNode && el.getRootNode().host);
-
-	if (parent && ((parent.openBy && parent.isUI5Element) || (parent.open && parent.isUI5Element) || parent === document.documentElement)) {
-		return parent;
-	}
-
-	return getClosedPopupParent(parent);
-};
-
-
-const getNextZIndex = () => {
-	currentZIndex += 2;
-	return currentZIndex;
-};
-
-export {
-	getFocusedElement,
-	isClickInRect,
-	getClosedPopupParent,
-	getNextZIndex,
-	isFocusedElementWithinNode,
-};

package/dist/types/AvatarFitType.js

@@ -1,40 +0,0 @@
-import DataType from "@ui5/webcomponents-base/dist/types/DataType.js";
-
-/**
- * Different types of AvatarFitType.
- * @lends sap.ui.webcomponents.main.types.AvatarFitType.prototype
- * @public
- */
-const AvatarFitTypes = {
-	/**
-	 *
-	 * @type {Cover}
-	 * @public
-	 */
-	Cover: "Cover",
-
-	/**
-	 * @type {Contain}
-	 * @public
-	 */
-	Contain: "Contain",
-};
-
-/**
- * @class
- * Different types of AvatarFitType.
- * @constructor
- * @author SAP SE
- * @alias sap.ui.webcomponents.main.types.AvatarFitType
- * @public
- * @enum {string}
- */
-class AvatarFitType extends DataType {
-	static isValid(value) {
-		return !!AvatarFitTypes[value];
-	}
-}
-
-AvatarFitType.generateTypeAcessors(AvatarFitTypes);
-
-export default AvatarFitType;

package/dist/webcomponentsjs/LICENSE.md

@@ -1,19 +0,0 @@
-# License
-
-Everything in this repo is BSD style license unless otherwise specified.
-
-Copyright (c) 2015 The Polymer Authors. All rights reserved.
-
-Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
-
-* Redistributions of source code must retain the above copyright
-notice, this list of conditions and the following disclaimer.
-* Redistributions in binary form must reproduce the above
-copyright notice, this list of conditions and the following disclaimer
-in the documentation and/or other materials provided with the
-distribution.
-* Neither the name of Google Inc. nor the names of its
-contributors may be used to endorse or promote products derived from
-this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/dist/webcomponentsjs/README.md

@@ -1,229 +0,0 @@
-[![Build Status](https://travis-ci.org/webcomponents/webcomponentsjs.svg?branch=master)](https://travis-ci.org/webcomponents/webcomponentsjs)
-
-webcomponents.js (v1 spec polyfills)
-================
-
-> **Note**. For polyfills that work with the older Custom Elements and Shadow DOM v0 specs,
-see the [v0 branch](https://github.com/webcomponents/webcomponentsjs/tree/v0).
-
-> **Note**. For polyfills that include HTML Imports,
-see the [v1 branch](https://github.com/webcomponents/webcomponentsjs/tree/v1).
-
-A suite of polyfills supporting the [Web Components](http://webcomponents.org) specs:
-
-- **Custom Elements v1**: allows authors to define their own custom tags ([spec](https://w3c.github.io/webcomponents/spec/custom/), [tutorial](https://developers.google.com/web/fundamentals/getting-started/primers/customelements), [polyfill](https://github.com/webcomponents/custom-elements)).
-- **Shadow DOM v1**: provides encapsulation by hiding DOM subtrees under shadow roots ([spec](https://w3c.github.io/webcomponents/spec/shadow/), [tutorial](https://developers.google.com/web/fundamentals/getting-started/primers/shadowdom),
-[shadydom polyfill](https://github.com/webcomponents/shadydom), [shadycss polyfill](https://github.com/webcomponents/shadycss)).
-
-For browsers that need it, there are also some minor polyfills included:
-- [`HTMLTemplateElement`](https://github.com/webcomponents/template)
-- [`Promise`](https://github.com/taylorhakes/promise-polyfill)
-- `Event`, `CustomEvent`, `MouseEvent` constructors and `Object.assign`, `Array.from`
-(see [webcomponents-platform](https://github.com/webcomponents/webcomponents-platform))
-- [`URL constructor`](https://github.com/webcomponents/URL)
-
-## How to use
-### Install polyfills
-```bash
-npm install @webcomponents/webcomponentsjs
-```
-
-You can also load the code from a CDN such as unpkg: https://unpkg.com/@webcomponents/webcomponentsjs@^2/
-
-### Using `webcomponents-bundle.js`
-
-The `webcomponents-bundle.js` contains all of the web components polyfills and is
-suitable for use on any supported browser. All of the polyfill code will be loaded
-but each polyfill will only be used based on feature detection.
-The bundle includes Custom Elements, Shady DOM/CSS and generic platform polyfills
-(such as ES6 Promise, Constructable events, etc.) (needed by Internet Explorer 11),
-and Template (needed by IE 11 and Edge).
-
-The `webcomponents-bundle.js` is very simple to use but it does load code
-that is not needed on most modern browsers, slowing page load. For best performance,
-use the `webcomponents-loader.js`.
-
-Here's an example:
-
-```html
-<!-- load webcomponents bundle, which includes all the necessary polyfills -->
-<script src="node_modules/@webcomponents/webcomponentsjs/webcomponents-bundle.js"></script>
-
-<!-- load the element -->
-<script type="module" src="my-element.js"></script>
-
-<!-- use the element -->
-<my-element></my-element>
-```
-
-### Using `webcomponents-loader.js`
-
-The `webcomponents-loader.js` is a client-side loader that dynamically loads the
-minimum polyfill bundle, using feature detection.
-
-`webcomponents-loader.js` can be loaded synchronously, or asynchronously depending on your needs.
-
-#### Inlining
-
-If you have inlined the source of `webcomponent-loader.js`, then you should specify `window.WebComponents.root` as the root from which to load the polyfills.
-For example:
-
-```html
-<script>
-  window.WebComponents = window.WebComponents || {};
-  window.WebComponents.root = 'node_modules/@webcomponents/webcomponentsjs/';
-</script>
-```
-
-#### Synchronous
-When loaded synchronously, `webcomponents-loader.js` behaves similarly to `webcomponents-bundle.js`.
-
-The appropriate bundle will be loaded with `document.write()` to ensure that WebComponent polyfills are available for subsequent scripts and modules.
-
-Here's an example:
-
-```html
-<!-- load the webcomponents loader, which injects the necessary polyfill bundle -->
-<script src="node_modules/@webcomponents/webcomponentsjs/webcomponents-loader.js"></script>
-
-<!-- load the element -->
-<script type="module" src="my-element.js"></script>
-
-<!-- use the element -->
-<my-element></my-element>
-```
-
-#### Asynchronous
-When loaded asychronously with the `defer` attribute, polyfill bundles will be loaded asynchronously,
-which means that scripts and modules that depend on webcomponents APIs *must* be loaded
-using `WebComponents.waitFor` function.
-
-The `WebComponents.waitFor` function takes a callback function as an argument, and will evaluate that callback after the polyfill bundle has been loaded.
-
-The callback function should load scripts that need the polyfills (typically via `import('my-script.js')`) and
-should return a promise that resolves when all scripts have loaded.
-
-Here's an example:
-
-```html
-<!-- Load polyfills; note that "loader" will load these async -->
-<script src="node_modules/@webcomponents/webcomponentsjs/webcomponents-loader.js" defer></script>
-
-<!-- Load a custom element definitions in `waitFor` and return a promise -->
-<script type="module">
-  WebComponents.waitFor(() => {
-    // At this point we are guaranteed that all required polyfills have
-    // loaded, and can use web components API's.
-    // The standard pattern is to load element definitions that call
-    // `customElements.define` here.
-    // Note: returning the import's promise causes the custom elements
-    // polyfill to wait until all definitions are loaded and then upgrade
-    // the document in one batch, for better performance.
-    return import('my-element.js');
-  });
-</script>
-
-<!-- Use the custom element -->
-<my-element></my-element>
-```
-
-The `WebComponents.waitFor` function may be called multiple times, and the callback functions will be processed in order.
-
-Here's a more complicated example:
-
-```html
-<!-- Load polyfills; note that "loader" will load these async -->
-<script src="node_modules/@webcomponents/webcomponentsjs/webcomponents-loader.js" defer></script>
-
-<script type="module">
-  WebComponents.waitFor(async () => {
-    if (!window.fetch) {
-      await import('node_modules/fetch-polyfill/fetch.js');
-    }
-    return import('my-element.js');
-  })
-</script>
-
-<script type="module">
-</script>
-```
-
-### WebComponentsReady event
-
-The `WebComponentsReady` event is fired when polyfills and user scripts have loaded and custom elements have been upgraded. This event is generally not needed; however, it may be useful in some cases like testing. If imperative code should wait until a specific custom element definition has loaded, it can use the platform `customElements.whenDefined` API.
-
-### `custom-elements-es5-adapter.js`
-According to the spec, only ES6 classes (https://html.spec.whatwg.org/multipage/scripting.html#custom-element-conformance) may be passed to the _native_ `customElements.define` API. For best performnace, ES6 should be served to browsers that support it, and ES5 code should be serve to those that don't. Since this may not always be possible, it may make sense to compile and serve ES5 to all browsers. However, if you do so, ES5-style custom element classes will now **not** work on browsers with native Custom Elements because ES5-style classes cannot properly extend ES6 classes, like `HTMLElement`.
-
-As a workaround, if your project has been compiled to ES5, load `custom-elements-es5-adapter.js` before defining Custom Elements.  This adapter will automatically wrap ES5.
-
-**The adapter must NOT be compiled.**
-
-## Browser Support
-
-The polyfills are intended to work in the latest versions of evergreen browsers. See below
-for our complete browser support matrix:
-
-| Polyfill   | Edge | IE11+ | Chrome* | Firefox* | Safari 9+* | Chrome Android* | Mobile Safari* |
-| ---------- |:----:|:-----:|:-------:|:--------:|:----------:|:---------------:|:--------------:|
-| Custom Elements | ✓ | ✓ | ✓ | ✓ | ✓ | ✓| ✓ |
-| Shady CSS/DOM | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
-
-\*Indicates the current version of the browser
-
-The polyfills may work in older browsers, however require additional polyfills (such as classList, or other [platform](https://github.com/webcomponents/webcomponents-platform)
-polyfills) to be used. We cannot guarantee support for browsers outside of our compatibility matrix.
-
-
-### Manually Building
-
-If you wish to build the bundles yourself, you'll need `node` and `npm` on your system:
-
- * install [node.js](http://nodejs.org/) using the instructions on their website
- * use `npm` to install [gulp.js](http://gulpjs.com/): `npm install -g gulp`
- * make sure you have Java installed per https://www.npmjs.com/package/google-closure-compiler#java-version
-
-Now you are ready to build the polyfills with:
-
-    # install dependencies
-    npm install
-    # build
-    npm run build
-
-The builds will be placed into the root directory.
-
-## Contribute
-
-See the [contributing guide](CONTRIBUTING.md)
-
-## License
-
-Everything in this repository is BSD style license unless otherwise specified.
-
-Copyright (c) 2015 The Polymer Authors. All rights reserved.
-
-## Changes in version 2.x
-
-* The HTML Imports polyfill has been removed. Given that ES modules have shipped in
-most browsers, the expectation is that web components code will be loaded via
-ES modules.
-* When using `webcomponents-loader.js` with the `defer` attribute, scripts that rely on the polyfills *must* be loaded using `WebComponents.waitFor(loadCallback)`.
-
-## Known Issues
-
-  * [ShadowDOM CSS is not encapsulated out of the box](#shadycss)
-  * [Custom element's constructor property is unreliable](#constructor)
-  * [ShadyCSS: :host(.zot:not(.bar:nth-child(2))) doesn't work](#nestedparens)
-
-### ShadowDOM CSS is not encapsulated out of the box <a id="shadycss"></a>
-The ShadowDOM polyfill is not able to encapsulate CSS in ShadowDOM out of the box. You need to use specific code from the ShadyCSS library, included with the polyfill. See [ShadyCSS instructions](https://github.com/webcomponents/shadycss).
-
-### Custom element's constructor property is unreliable <a id="constructor"></a>
-See [#215](https://github.com/webcomponents/webcomponentsjs/issues/215) for background.
-
-In Edge and IE, instances of Custom Elements have a `constructor` property of `HTMLUnknownElementConstructor` and `HTMLUnknownElement`, respectively. It's unsafe to rely on this property for checking element types.
-
-It's worth noting that `customElement.__proto__.__proto__.constructor` is `HTMLElementPrototype` and that the prototype chain isn't modified by the polyfills(onto `ElementPrototype`, etc.)
-
-### ShadyCSS: :host(.zot:not(.bar:nth-child(2))) doesn't work <a id="nestedparens"></a>
-ShadyCSS `:host()` rules can only have (at most) 1-level of nested parentheses in its argument selector under ShadyCSS. For example, `:host(.zot)` and `:host(.zot:not(.bar))` both work, but `:host(.zot:not(.bar:nth-child(2)))` does not.