123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686 |
- const NAMESPACE = 'ionicons';
- /**
- * Virtual DOM patching algorithm based on Snabbdom by
- * Simon Friis Vindum (@paldepind)
- * Licensed under the MIT License
- * https://github.com/snabbdom/snabbdom/blob/master/LICENSE
- *
- * Modified for Stencil's renderer and slot projection
- */
- let scopeId;
- let hostTagName;
- let isSvgMode = false;
- let queuePending = false;
- const getAssetPath = (path) => {
- const assetUrl = new URL(path, plt.$resourcesUrl$);
- return assetUrl.origin !== win.location.origin ? assetUrl.href : assetUrl.pathname;
- };
- const setAssetPath = (path) => (plt.$resourcesUrl$ = path);
- const createTime = (fnName, tagName = '') => {
- {
- return () => {
- return;
- };
- }
- };
- const uniqueTime = (key, measureText) => {
- {
- return () => {
- return;
- };
- }
- };
- const HYDRATED_CSS = '{visibility:hidden}.hydrated{visibility:inherit}';
- const XLINK_NS = 'http://www.w3.org/1999/xlink';
- /**
- * Default style mode id
- */
- /**
- * Reusable empty obj/array
- * Don't add values to these!!
- */
- const EMPTY_OBJ = {};
- const isDef = (v) => v != null;
- /**
- * Check whether a value is a 'complex type', defined here as an object or a
- * function.
- *
- * @param o the value to check
- * @returns whether it's a complex type or not
- */
- const isComplexType = (o) => {
- // https://jsperf.com/typeof-fn-object/5
- o = typeof o;
- return o === 'object' || o === 'function';
- };
- /**
- * Helper method for querying a `meta` tag that contains a nonce value
- * out of a DOM's head.
- *
- * @param doc The DOM containing the `head` to query against
- * @returns The content of the meta tag representing the nonce value, or `undefined` if no tag
- * exists or the tag has no content.
- */
- function queryNonceMetaTagContent(doc) {
- var _a, _b, _c;
- return (_c = (_b = (_a = doc.head) === null || _a === void 0 ? void 0 : _a.querySelector('meta[name="csp-nonce"]')) === null || _b === void 0 ? void 0 : _b.getAttribute('content')) !== null && _c !== void 0 ? _c : undefined;
- }
- /**
- * Production h() function based on Preact by
- * Jason Miller (@developit)
- * Licensed under the MIT License
- * https://github.com/developit/preact/blob/master/LICENSE
- *
- * Modified for Stencil's compiler and vdom
- */
- // export function h(nodeName: string | d.FunctionalComponent, vnodeData: d.PropsType, child?: d.ChildType): d.VNode;
- // export function h(nodeName: string | d.FunctionalComponent, vnodeData: d.PropsType, ...children: d.ChildType[]): d.VNode;
- const h = (nodeName, vnodeData, ...children) => {
- let child = null;
- let key = null;
- let simple = false;
- let lastSimple = false;
- const vNodeChildren = [];
- const walk = (c) => {
- for (let i = 0; i < c.length; i++) {
- child = c[i];
- if (Array.isArray(child)) {
- walk(child);
- }
- else if (child != null && typeof child !== 'boolean') {
- if ((simple = typeof nodeName !== 'function' && !isComplexType(child))) {
- child = String(child);
- }
- if (simple && lastSimple) {
- // If the previous child was simple (string), we merge both
- vNodeChildren[vNodeChildren.length - 1].$text$ += child;
- }
- else {
- // Append a new vNode, if it's text, we create a text vNode
- vNodeChildren.push(simple ? newVNode(null, child) : child);
- }
- lastSimple = simple;
- }
- }
- };
- walk(children);
- if (vnodeData) {
- // normalize class / classname attributes
- if (vnodeData.key) {
- key = vnodeData.key;
- }
- {
- const classData = vnodeData.className || vnodeData.class;
- if (classData) {
- vnodeData.class =
- typeof classData !== 'object'
- ? classData
- : Object.keys(classData)
- .filter((k) => classData[k])
- .join(' ');
- }
- }
- }
- const vnode = newVNode(nodeName, null);
- vnode.$attrs$ = vnodeData;
- if (vNodeChildren.length > 0) {
- vnode.$children$ = vNodeChildren;
- }
- {
- vnode.$key$ = key;
- }
- return vnode;
- };
- /**
- * A utility function for creating a virtual DOM node from a tag and some
- * possible text content.
- *
- * @param tag the tag for this element
- * @param text possible text content for the node
- * @returns a newly-minted virtual DOM node
- */
- const newVNode = (tag, text) => {
- const vnode = {
- $flags$: 0,
- $tag$: tag,
- $text$: text,
- $elm$: null,
- $children$: null,
- };
- {
- vnode.$attrs$ = null;
- }
- {
- vnode.$key$ = null;
- }
- return vnode;
- };
- const Host = {};
- /**
- * Check whether a given node is a Host node or not
- *
- * @param node the virtual DOM node to check
- * @returns whether it's a Host node or not
- */
- const isHost = (node) => node && node.$tag$ === Host;
- /**
- * Parse a new property value for a given property type.
- *
- * While the prop value can reasonably be expected to be of `any` type as far as TypeScript's type checker is concerned,
- * it is not safe to assume that the string returned by evaluating `typeof propValue` matches:
- * 1. `any`, the type given to `propValue` in the function signature
- * 2. the type stored from `propType`.
- *
- * This function provides the capability to parse/coerce a property's value to potentially any other JavaScript type.
- *
- * Property values represented in TSX preserve their type information. In the example below, the number 0 is passed to
- * a component. This `propValue` will preserve its type information (`typeof propValue === 'number'`). Note that is
- * based on the type of the value being passed in, not the type declared of the class member decorated with `@Prop`.
- * ```tsx
- * <my-cmp prop-val={0}></my-cmp>
- * ```
- *
- * HTML prop values on the other hand, will always a string
- *
- * @param propValue the new value to coerce to some type
- * @param propType the type of the prop, expressed as a binary number
- * @returns the parsed/coerced value
- */
- const parsePropertyValue = (propValue, propType) => {
- // ensure this value is of the correct prop type
- if (propValue != null && !isComplexType(propValue)) {
- if (propType & 4 /* MEMBER_FLAGS.Boolean */) {
- // per the HTML spec, any string value means it is a boolean true value
- // but we'll cheat here and say that the string "false" is the boolean false
- return propValue === 'false' ? false : propValue === '' || !!propValue;
- }
- if (propType & 1 /* MEMBER_FLAGS.String */) {
- // could have been passed as a number or boolean
- // but we still want it as a string
- return String(propValue);
- }
- // redundant return here for better minification
- return propValue;
- }
- // not sure exactly what type we want
- // so no need to change to a different type
- return propValue;
- };
- const getElement = (ref) => (getHostRef(ref).$hostElement$ );
- /**
- * Helper function to create & dispatch a custom Event on a provided target
- * @param elm the target of the Event
- * @param name the name to give the custom Event
- * @param opts options for configuring a custom Event
- * @returns the custom Event
- */
- const emitEvent = (elm, name, opts) => {
- const ev = plt.ce(name, opts);
- elm.dispatchEvent(ev);
- return ev;
- };
- const rootAppliedStyles = /*@__PURE__*/ new WeakMap();
- const registerStyle = (scopeId, cssText, allowCS) => {
- let style = styles.get(scopeId);
- if (supportsConstructableStylesheets && allowCS) {
- style = (style || new CSSStyleSheet());
- if (typeof style === 'string') {
- style = cssText;
- }
- else {
- style.replaceSync(cssText);
- }
- }
- else {
- style = cssText;
- }
- styles.set(scopeId, style);
- };
- const addStyle = (styleContainerNode, cmpMeta, mode) => {
- var _a;
- const scopeId = getScopeId(cmpMeta);
- const style = styles.get(scopeId);
- // if an element is NOT connected then getRootNode() will return the wrong root node
- // so the fallback is to always use the document for the root node in those cases
- styleContainerNode = styleContainerNode.nodeType === 11 /* NODE_TYPE.DocumentFragment */ ? styleContainerNode : doc;
- if (style) {
- if (typeof style === 'string') {
- styleContainerNode = styleContainerNode.head || styleContainerNode;
- let appliedStyles = rootAppliedStyles.get(styleContainerNode);
- let styleElm;
- if (!appliedStyles) {
- rootAppliedStyles.set(styleContainerNode, (appliedStyles = new Set()));
- }
- if (!appliedStyles.has(scopeId)) {
- {
- styleElm = doc.createElement('style');
- styleElm.innerHTML = style;
- // Apply CSP nonce to the style tag if it exists
- const nonce = (_a = plt.$nonce$) !== null && _a !== void 0 ? _a : queryNonceMetaTagContent(doc);
- if (nonce != null) {
- styleElm.setAttribute('nonce', nonce);
- }
- styleContainerNode.insertBefore(styleElm, styleContainerNode.querySelector('link'));
- }
- if (appliedStyles) {
- appliedStyles.add(scopeId);
- }
- }
- }
- else if (!styleContainerNode.adoptedStyleSheets.includes(style)) {
- styleContainerNode.adoptedStyleSheets = [...styleContainerNode.adoptedStyleSheets, style];
- }
- }
- return scopeId;
- };
- const attachStyles = (hostRef) => {
- const cmpMeta = hostRef.$cmpMeta$;
- const elm = hostRef.$hostElement$;
- const flags = cmpMeta.$flags$;
- const endAttachStyles = createTime('attachStyles', cmpMeta.$tagName$);
- const scopeId = addStyle(elm.shadowRoot ? elm.shadowRoot : elm.getRootNode(), cmpMeta);
- if (flags & 10 /* CMP_FLAGS.needsScopedEncapsulation */) {
- // only required when we're NOT using native shadow dom (slot)
- // or this browser doesn't support native shadow dom
- // and this host element was NOT created with SSR
- // let's pick out the inner content for slot projection
- // create a node to represent where the original
- // content was first placed, which is useful later on
- // DOM WRITE!!
- elm['s-sc'] = scopeId;
- elm.classList.add(scopeId + '-h');
- }
- endAttachStyles();
- };
- const getScopeId = (cmp, mode) => 'sc-' + (cmp.$tagName$);
- /**
- * Production setAccessor() function based on Preact by
- * Jason Miller (@developit)
- * Licensed under the MIT License
- * https://github.com/developit/preact/blob/master/LICENSE
- *
- * Modified for Stencil's compiler and vdom
- */
- /**
- * When running a VDom render set properties present on a VDom node onto the
- * corresponding HTML element.
- *
- * Note that this function has special functionality for the `class`,
- * `style`, `key`, and `ref` attributes, as well as event handlers (like
- * `onClick`, etc). All others are just passed through as-is.
- *
- * @param elm the HTMLElement onto which attributes should be set
- * @param memberName the name of the attribute to set
- * @param oldValue the old value for the attribute
- * @param newValue the new value for the attribute
- * @param isSvg whether we're in an svg context or not
- * @param flags bitflags for Vdom variables
- */
- const setAccessor = (elm, memberName, oldValue, newValue, isSvg, flags) => {
- if (oldValue !== newValue) {
- let isProp = isMemberInElement(elm, memberName);
- let ln = memberName.toLowerCase();
- if (memberName === 'class') {
- const classList = elm.classList;
- const oldClasses = parseClassList(oldValue);
- const newClasses = parseClassList(newValue);
- classList.remove(...oldClasses.filter((c) => c && !newClasses.includes(c)));
- classList.add(...newClasses.filter((c) => c && !oldClasses.includes(c)));
- }
- else if (memberName === 'style') {
- // update style attribute, css properties and values
- {
- for (const prop in oldValue) {
- if (!newValue || newValue[prop] == null) {
- if (prop.includes('-')) {
- elm.style.removeProperty(prop);
- }
- else {
- elm.style[prop] = '';
- }
- }
- }
- }
- for (const prop in newValue) {
- if (!oldValue || newValue[prop] !== oldValue[prop]) {
- if (prop.includes('-')) {
- elm.style.setProperty(prop, newValue[prop]);
- }
- else {
- elm.style[prop] = newValue[prop];
- }
- }
- }
- }
- else if (memberName === 'key')
- ;
- else if (memberName === 'ref') {
- // minifier will clean this up
- if (newValue) {
- newValue(elm);
- }
- }
- else if ((!isProp ) &&
- memberName[0] === 'o' &&
- memberName[1] === 'n') {
- // Event Handlers
- // so if the member name starts with "on" and the 3rd characters is
- // a capital letter, and it's not already a member on the element,
- // then we're assuming it's an event listener
- if (memberName[2] === '-') {
- // on- prefixed events
- // allows to be explicit about the dom event to listen without any magic
- // under the hood:
- // <my-cmp on-click> // listens for "click"
- // <my-cmp on-Click> // listens for "Click"
- // <my-cmp on-ionChange> // listens for "ionChange"
- // <my-cmp on-EVENTS> // listens for "EVENTS"
- memberName = memberName.slice(3);
- }
- else if (isMemberInElement(win, ln)) {
- // standard event
- // the JSX attribute could have been "onMouseOver" and the
- // member name "onmouseover" is on the window's prototype
- // so let's add the listener "mouseover", which is all lowercased
- memberName = ln.slice(2);
- }
- else {
- // custom event
- // the JSX attribute could have been "onMyCustomEvent"
- // so let's trim off the "on" prefix and lowercase the first character
- // and add the listener "myCustomEvent"
- // except for the first character, we keep the event name case
- memberName = ln[2] + memberName.slice(3);
- }
- if (oldValue) {
- plt.rel(elm, memberName, oldValue, false);
- }
- if (newValue) {
- plt.ael(elm, memberName, newValue, false);
- }
- }
- else {
- // Set property if it exists and it's not a SVG
- const isComplex = isComplexType(newValue);
- if ((isProp || (isComplex && newValue !== null)) && !isSvg) {
- try {
- if (!elm.tagName.includes('-')) {
- const n = newValue == null ? '' : newValue;
- // Workaround for Safari, moving the <input> caret when re-assigning the same valued
- if (memberName === 'list') {
- isProp = false;
- }
- else if (oldValue == null || elm[memberName] != n) {
- elm[memberName] = n;
- }
- }
- else {
- elm[memberName] = newValue;
- }
- }
- catch (e) { }
- }
- /**
- * Need to manually update attribute if:
- * - memberName is not an attribute
- * - if we are rendering the host element in order to reflect attribute
- * - if it's a SVG, since properties might not work in <svg>
- * - if the newValue is null/undefined or 'false'.
- */
- let xlink = false;
- {
- if (ln !== (ln = ln.replace(/^xlink\:?/, ''))) {
- memberName = ln;
- xlink = true;
- }
- }
- if (newValue == null || newValue === false) {
- if (newValue !== false || elm.getAttribute(memberName) === '') {
- if (xlink) {
- elm.removeAttributeNS(XLINK_NS, memberName);
- }
- else {
- elm.removeAttribute(memberName);
- }
- }
- }
- else if ((!isProp || flags & 4 /* VNODE_FLAGS.isHost */ || isSvg) && !isComplex) {
- newValue = newValue === true ? '' : newValue;
- if (xlink) {
- elm.setAttributeNS(XLINK_NS, memberName, newValue);
- }
- else {
- elm.setAttribute(memberName, newValue);
- }
- }
- }
- }
- };
- const parseClassListRegex = /\s/;
- const parseClassList = (value) => (!value ? [] : value.split(parseClassListRegex));
- const updateElement = (oldVnode, newVnode, isSvgMode, memberName) => {
- // if the element passed in is a shadow root, which is a document fragment
- // then we want to be adding attrs/props to the shadow root's "host" element
- // if it's not a shadow root, then we add attrs/props to the same element
- const elm = newVnode.$elm$.nodeType === 11 /* NODE_TYPE.DocumentFragment */ && newVnode.$elm$.host
- ? newVnode.$elm$.host
- : newVnode.$elm$;
- const oldVnodeAttrs = (oldVnode && oldVnode.$attrs$) || EMPTY_OBJ;
- const newVnodeAttrs = newVnode.$attrs$ || EMPTY_OBJ;
- {
- // remove attributes no longer present on the vnode by setting them to undefined
- for (memberName in oldVnodeAttrs) {
- if (!(memberName in newVnodeAttrs)) {
- setAccessor(elm, memberName, oldVnodeAttrs[memberName], undefined, isSvgMode, newVnode.$flags$);
- }
- }
- }
- // add new & update changed attributes
- for (memberName in newVnodeAttrs) {
- setAccessor(elm, memberName, oldVnodeAttrs[memberName], newVnodeAttrs[memberName], isSvgMode, newVnode.$flags$);
- }
- };
- /**
- * Create a DOM Node corresponding to one of the children of a given VNode.
- *
- * @param oldParentVNode the parent VNode from the previous render
- * @param newParentVNode the parent VNode from the current render
- * @param childIndex the index of the VNode, in the _new_ parent node's
- * children, for which we will create a new DOM node
- * @param parentElm the parent DOM node which our new node will be a child of
- * @returns the newly created node
- */
- const createElm = (oldParentVNode, newParentVNode, childIndex, parentElm) => {
- // tslint:disable-next-line: prefer-const
- const newVNode = newParentVNode.$children$[childIndex];
- let i = 0;
- let elm;
- let childNode;
- if (newVNode.$text$ !== null) {
- // create text node
- elm = newVNode.$elm$ = doc.createTextNode(newVNode.$text$);
- }
- else {
- // create element
- elm = newVNode.$elm$ = (doc.createElement(newVNode.$tag$));
- // add css classes, attrs, props, listeners, etc.
- {
- updateElement(null, newVNode, isSvgMode);
- }
- if (isDef(scopeId) && elm['s-si'] !== scopeId) {
- // if there is a scopeId and this is the initial render
- // then let's add the scopeId as a css class
- elm.classList.add((elm['s-si'] = scopeId));
- }
- if (newVNode.$children$) {
- for (i = 0; i < newVNode.$children$.length; ++i) {
- // create the node
- childNode = createElm(oldParentVNode, newVNode, i);
- // return node could have been null
- if (childNode) {
- // append our new node
- elm.appendChild(childNode);
- }
- }
- }
- }
- return elm;
- };
- /**
- * Create DOM nodes corresponding to a list of {@link d.Vnode} objects and
- * add them to the DOM in the appropriate place.
- *
- * @param parentElm the DOM node which should be used as a parent for the new
- * DOM nodes
- * @param before a child of the `parentElm` which the new children should be
- * inserted before (optional)
- * @param parentVNode the parent virtual DOM node
- * @param vnodes the new child virtual DOM nodes to produce DOM nodes for
- * @param startIdx the index in the child virtual DOM nodes at which to start
- * creating DOM nodes (inclusive)
- * @param endIdx the index in the child virtual DOM nodes at which to stop
- * creating DOM nodes (inclusive)
- */
- const addVnodes = (parentElm, before, parentVNode, vnodes, startIdx, endIdx) => {
- let containerElm = (parentElm);
- let childNode;
- if (containerElm.shadowRoot && containerElm.tagName === hostTagName) {
- containerElm = containerElm.shadowRoot;
- }
- for (; startIdx <= endIdx; ++startIdx) {
- if (vnodes[startIdx]) {
- childNode = createElm(null, parentVNode, startIdx);
- if (childNode) {
- vnodes[startIdx].$elm$ = childNode;
- containerElm.insertBefore(childNode, before);
- }
- }
- }
- };
- /**
- * Remove the DOM elements corresponding to a list of {@link d.VNode} objects.
- * This can be used to, for instance, clean up after a list of children which
- * should no longer be shown.
- *
- * This function also handles some of Stencil's slot relocation logic.
- *
- * @param vnodes a list of virtual DOM nodes to remove
- * @param startIdx the index at which to start removing nodes (inclusive)
- * @param endIdx the index at which to stop removing nodes (inclusive)
- */
- const removeVnodes = (vnodes, startIdx, endIdx) => {
- for (let index = startIdx; index <= endIdx; ++index) {
- const vnode = vnodes[index];
- if (vnode) {
- const elm = vnode.$elm$;
- nullifyVNodeRefs(vnode);
- if (elm) {
- // remove the vnode's element from the dom
- elm.remove();
- }
- }
- }
- };
- /**
- * Reconcile the children of a new VNode with the children of an old VNode by
- * traversing the two collections of children, identifying nodes that are
- * conserved or changed, calling out to `patch` to make any necessary
- * updates to the DOM, and rearranging DOM nodes as needed.
- *
- * The algorithm for reconciling children works by analyzing two 'windows' onto
- * the two arrays of children (`oldCh` and `newCh`). We keep track of the
- * 'windows' by storing start and end indices and references to the
- * corresponding array entries. Initially the two 'windows' are basically equal
- * to the entire array, but we progressively narrow the windows until there are
- * no children left to update by doing the following:
- *
- * 1. Skip any `null` entries at the beginning or end of the two arrays, so
- * that if we have an initial array like the following we'll end up dealing
- * only with a window bounded by the highlighted elements:
- *
- * [null, null, VNode1 , ... , VNode2, null, null]
- * ^^^^^^ ^^^^^^
- *
- * 2. Check to see if the elements at the head and tail positions are equal
- * across the windows. This will basically detect elements which haven't
- * been added, removed, or changed position, i.e. if you had the following
- * VNode elements (represented as HTML):
- *
- * oldVNode: `<div><p><span>HEY</span></p></div>`
- * newVNode: `<div><p><span>THERE</span></p></div>`
- *
- * Then when comparing the children of the `<div>` tag we check the equality
- * of the VNodes corresponding to the `<p>` tags and, since they are the
- * same tag in the same position, we'd be able to avoid completely
- * re-rendering the subtree under them with a new DOM element and would just
- * call out to `patch` to handle reconciling their children and so on.
- *
- * 3. Check, for both windows, to see if the element at the beginning of the
- * window corresponds to the element at the end of the other window. This is
- * a heuristic which will let us identify _some_ situations in which
- * elements have changed position, for instance it _should_ detect that the
- * children nodes themselves have not changed but merely moved in the
- * following example:
- *
- * oldVNode: `<div><element-one /><element-two /></div>`
- * newVNode: `<div><element-two /><element-one /></div>`
- *
- * If we find cases like this then we also need to move the concrete DOM
- * elements corresponding to the moved children to write the re-order to the
- * DOM.
- *
- * 4. Finally, if VNodes have the `key` attribute set on them we check for any
- * nodes in the old children which have the same key as the first element in
- * our window on the new children. If we find such a node we handle calling
- * out to `patch`, moving relevant DOM nodes, and so on, in accordance with
- * what we find.
- *
- * Finally, once we've narrowed our 'windows' to the point that either of them
- * collapse (i.e. they have length 0) we then handle any remaining VNode
- * insertion or deletion that needs to happen to get a DOM state that correctly
- * reflects the new child VNodes. If, for instance, after our window on the old
- * children has collapsed we still have more nodes on the new children that
- * we haven't dealt with yet then we need to add them, or if the new children
- * collapse but we still have unhandled _old_ children then we need to make
- * sure the corresponding DOM nodes are removed.
- *
- * @param parentElm the node into which the parent VNode is rendered
- * @param oldCh the old children of the parent node
- * @param newVNode the new VNode which will replace the parent
- * @param newCh the new children of the parent node
- */
- const updateChildren = (parentElm, oldCh, newVNode, newCh) => {
- let oldStartIdx = 0;
- let newStartIdx = 0;
- let idxInOld = 0;
- let i = 0;
- let oldEndIdx = oldCh.length - 1;
- let oldStartVnode = oldCh[0];
- let oldEndVnode = oldCh[oldEndIdx];
- let newEndIdx = newCh.length - 1;
- let newStartVnode = newCh[0];
- let newEndVnode = newCh[newEndIdx];
- let node;
- let elmToMove;
- while (oldStartIdx <= oldEndIdx && newStartIdx <= newEndIdx) {
- if (oldStartVnode == null) {
- // VNode might have been moved left
- oldStartVnode = oldCh[++oldStartIdx];
- }
- else if (oldEndVnode == null) {
- oldEndVnode = oldCh[--oldEndIdx];
- }
- else if (newStartVnode == null) {
- newStartVnode = newCh[++newStartIdx];
- }
- else if (newEndVnode == null) {
- newEndVnode = newCh[--newEndIdx];
- }
- else if (isSameVnode(oldStartVnode, newStartVnode)) {
- // if the start nodes are the same then we should patch the new VNode
- // onto the old one, and increment our `newStartIdx` and `oldStartIdx`
- // indices to reflect that. We don't need to move any DOM Nodes around
- // since things are matched up in order.
- patch(oldStartVnode, newStartVnode);
- oldStartVnode = oldCh[++oldStartIdx];
- newStartVnode = newCh[++newStartIdx];
- }
- else if (isSameVnode(oldEndVnode, newEndVnode)) {
- // likewise, if the end nodes are the same we patch new onto old and
- // decrement our end indices, and also likewise in this case we don't
- // need to move any DOM Nodes.
- patch(oldEndVnode, newEndVnode);
- oldEndVnode = oldCh[--oldEndIdx];
- newEndVnode = newCh[--newEndIdx];
- }
- else if (isSameVnode(oldStartVnode, newEndVnode)) {
- patch(oldStartVnode, newEndVnode);
- // We need to move the element for `oldStartVnode` into a position which
- // will be appropriate for `newEndVnode`. For this we can use
- // `.insertBefore` and `oldEndVnode.$elm$.nextSibling`. If there is a
- // sibling for `oldEndVnode.$elm$` then we want to move the DOM node for
- // `oldStartVnode` between `oldEndVnode` and it's sibling, like so:
- //
- // <old-start-node />
- // <some-intervening-node />
- // <old-end-node />
- // <!-- -> <-- `oldStartVnode.$elm$` should be inserted here
- // <next-sibling />
- //
- // If instead `oldEndVnode.$elm$` has no sibling then we just want to put
- // the node for `oldStartVnode` at the end of the children of
- // `parentElm`. Luckily, `Node.nextSibling` will return `null` if there
- // aren't any siblings, and passing `null` to `Node.insertBefore` will
- // append it to the children of the parent element.
- parentElm.insertBefore(oldStartVnode.$elm$, oldEndVnode.$elm$.nextSibling);
- oldStartVnode = oldCh[++oldStartIdx];
- newEndVnode = newCh[--newEndIdx];
- }
- else if (isSameVnode(oldEndVnode, newStartVnode)) {
- patch(oldEndVnode, newStartVnode);
- // We've already checked above if `oldStartVnode` and `newStartVnode` are
- // the same node, so since we're here we know that they are not. Thus we
- // can move the element for `oldEndVnode` _before_ the element for
- // `oldStartVnode`, leaving `oldStartVnode` to be reconciled in the
- // future.
- parentElm.insertBefore(oldEndVnode.$elm$, oldStartVnode.$elm$);
- oldEndVnode = oldCh[--oldEndIdx];
- newStartVnode = newCh[++newStartIdx];
- }
- else {
- // Here we do some checks to match up old and new nodes based on the
- // `$key$` attribute, which is set by putting a `key="my-key"` attribute
- // in the JSX for a DOM element in the implementation of a Stencil
- // component.
- //
- // First we check to see if there are any nodes in the array of old
- // children which have the same key as the first node in the new
- // children.
- idxInOld = -1;
- {
- for (i = oldStartIdx; i <= oldEndIdx; ++i) {
- if (oldCh[i] && oldCh[i].$key$ !== null && oldCh[i].$key$ === newStartVnode.$key$) {
- idxInOld = i;
- break;
- }
- }
- }
- if (idxInOld >= 0) {
- // We found a node in the old children which matches up with the first
- // node in the new children! So let's deal with that
- elmToMove = oldCh[idxInOld];
- if (elmToMove.$tag$ !== newStartVnode.$tag$) {
- // the tag doesn't match so we'll need a new DOM element
- node = createElm(oldCh && oldCh[newStartIdx], newVNode, idxInOld);
- }
- else {
- patch(elmToMove, newStartVnode);
- // invalidate the matching old node so that we won't try to update it
- // again later on
- oldCh[idxInOld] = undefined;
- node = elmToMove.$elm$;
- }
- newStartVnode = newCh[++newStartIdx];
- }
- else {
- // We either didn't find an element in the old children that matches
- // the key of the first new child OR the build is not using `key`
- // attributes at all. In either case we need to create a new element
- // for the new node.
- node = createElm(oldCh && oldCh[newStartIdx], newVNode, newStartIdx);
- newStartVnode = newCh[++newStartIdx];
- }
- if (node) {
- // if we created a new node then handle inserting it to the DOM
- {
- oldStartVnode.$elm$.parentNode.insertBefore(node, oldStartVnode.$elm$);
- }
- }
- }
- }
- if (oldStartIdx > oldEndIdx) {
- // we have some more new nodes to add which don't match up with old nodes
- addVnodes(parentElm, newCh[newEndIdx + 1] == null ? null : newCh[newEndIdx + 1].$elm$, newVNode, newCh, newStartIdx, newEndIdx);
- }
- else if (newStartIdx > newEndIdx) {
- // there are nodes in the `oldCh` array which no longer correspond to nodes
- // in the new array, so lets remove them (which entails cleaning up the
- // relevant DOM nodes)
- removeVnodes(oldCh, oldStartIdx, oldEndIdx);
- }
- };
- /**
- * Compare two VNodes to determine if they are the same
- *
- * **NB**: This function is an equality _heuristic_ based on the available
- * information set on the two VNodes and can be misleading under certain
- * circumstances. In particular, if the two nodes do not have `key` attrs
- * (available under `$key$` on VNodes) then the function falls back on merely
- * checking that they have the same tag.
- *
- * So, in other words, if `key` attrs are not set on VNodes which may be
- * changing order within a `children` array or something along those lines then
- * we could obtain a false negative and then have to do needless re-rendering
- * (i.e. we'd say two VNodes aren't equal when in fact they should be).
- *
- * @param leftVNode the first VNode to check
- * @param rightVNode the second VNode to check
- * @returns whether they're equal or not
- */
- const isSameVnode = (leftVNode, rightVNode) => {
- // compare if two vnode to see if they're "technically" the same
- // need to have the same element tag, and same key to be the same
- if (leftVNode.$tag$ === rightVNode.$tag$) {
- // this will be set if components in the build have `key` attrs set on them
- {
- return leftVNode.$key$ === rightVNode.$key$;
- }
- }
- return false;
- };
- /**
- * Handle reconciling an outdated VNode with a new one which corresponds to
- * it. This function handles flushing updates to the DOM and reconciling the
- * children of the two nodes (if any).
- *
- * @param oldVNode an old VNode whose DOM element and children we want to update
- * @param newVNode a new VNode representing an updated version of the old one
- */
- const patch = (oldVNode, newVNode) => {
- const elm = (newVNode.$elm$ = oldVNode.$elm$);
- const oldChildren = oldVNode.$children$;
- const newChildren = newVNode.$children$;
- const text = newVNode.$text$;
- if (text === null) {
- {
- {
- // either this is the first render of an element OR it's an update
- // AND we already know it's possible it could have changed
- // this updates the element's css classes, attrs, props, listeners, etc.
- updateElement(oldVNode, newVNode, isSvgMode);
- }
- }
- if (oldChildren !== null && newChildren !== null) {
- // looks like there's child vnodes for both the old and new vnodes
- // so we need to call `updateChildren` to reconcile them
- updateChildren(elm, oldChildren, newVNode, newChildren);
- }
- else if (newChildren !== null) {
- // no old child vnodes, but there are new child vnodes to add
- if (oldVNode.$text$ !== null) {
- // the old vnode was text, so be sure to clear it out
- elm.textContent = '';
- }
- // add the new vnode children
- addVnodes(elm, null, newVNode, newChildren, 0, newChildren.length - 1);
- }
- else if (oldChildren !== null) {
- // no new child vnodes, but there are old child vnodes to remove
- removeVnodes(oldChildren, 0, oldChildren.length - 1);
- }
- }
- else if (oldVNode.$text$ !== text) {
- // update the text content for the text only vnode
- // and also only if the text is different than before
- elm.data = text;
- }
- };
- /**
- * 'Nullify' any VDom `ref` callbacks on a VDom node or its children by
- * calling them with `null`. This signals that the DOM element corresponding to
- * the VDom node has been removed from the DOM.
- *
- * @param vNode a virtual DOM node
- */
- const nullifyVNodeRefs = (vNode) => {
- {
- vNode.$attrs$ && vNode.$attrs$.ref && vNode.$attrs$.ref(null);
- vNode.$children$ && vNode.$children$.map(nullifyVNodeRefs);
- }
- };
- /**
- * The main entry point for Stencil's virtual DOM-based rendering engine
- *
- * Given a {@link d.HostRef} container and some virtual DOM nodes, this
- * function will handle creating a virtual DOM tree with a single root, patching
- * the current virtual DOM tree onto an old one (if any), dealing with slot
- * relocation, and reflecting attributes.
- *
- * @param hostRef data needed to root and render the virtual DOM tree, such as
- * the DOM node into which it should be rendered.
- * @param renderFnResults the virtual DOM nodes to be rendered
- * @param isInitialLoad whether or not this is the first call after page load
- */
- const renderVdom = (hostRef, renderFnResults, isInitialLoad = false) => {
- const hostElm = hostRef.$hostElement$;
- const cmpMeta = hostRef.$cmpMeta$;
- const oldVNode = hostRef.$vnode$ || newVNode(null, null);
- // if `renderFnResults` is a Host node then we can use it directly. If not,
- // we need to call `h` again to wrap the children of our component in a
- // 'dummy' Host node (well, an empty vnode) since `renderVdom` assumes
- // implicitly that the top-level vdom node is 1) an only child and 2)
- // contains attrs that need to be set on the host element.
- const rootVnode = isHost(renderFnResults) ? renderFnResults : h(null, null, renderFnResults);
- hostTagName = hostElm.tagName;
- if (cmpMeta.$attrsToReflect$) {
- rootVnode.$attrs$ = rootVnode.$attrs$ || {};
- cmpMeta.$attrsToReflect$.map(([propName, attribute]) => (rootVnode.$attrs$[attribute] = hostElm[propName]));
- }
- // On the first render and *only* on the first render we want to check for
- // any attributes set on the host element which are also set on the vdom
- // node. If we find them, we override the value on the VDom node attrs with
- // the value from the host element, which allows developers building apps
- // with Stencil components to override e.g. the `role` attribute on a
- // component even if it's already set on the `Host`.
- if (isInitialLoad && rootVnode.$attrs$) {
- for (const key of Object.keys(rootVnode.$attrs$)) {
- // We have a special implementation in `setAccessor` for `style` and
- // `class` which reconciles values coming from the VDom with values
- // already present on the DOM element, so we don't want to override those
- // attributes on the VDom tree with values from the host element if they
- // are present.
- //
- // Likewise, `ref` and `key` are special internal values for the Stencil
- // runtime and we don't want to override those either.
- if (hostElm.hasAttribute(key) && !['key', 'ref', 'style', 'class'].includes(key)) {
- rootVnode.$attrs$[key] = hostElm[key];
- }
- }
- }
- rootVnode.$tag$ = null;
- rootVnode.$flags$ |= 4 /* VNODE_FLAGS.isHost */;
- hostRef.$vnode$ = rootVnode;
- rootVnode.$elm$ = oldVNode.$elm$ = (hostElm.shadowRoot || hostElm );
- {
- scopeId = hostElm['s-sc'];
- }
- // synchronous patch
- patch(oldVNode, rootVnode);
- };
- const attachToAncestor = (hostRef, ancestorComponent) => {
- if (ancestorComponent && !hostRef.$onRenderResolve$ && ancestorComponent['s-p']) {
- ancestorComponent['s-p'].push(new Promise((r) => (hostRef.$onRenderResolve$ = r)));
- }
- };
- const scheduleUpdate = (hostRef, isInitialLoad) => {
- {
- hostRef.$flags$ |= 16 /* HOST_FLAGS.isQueuedForUpdate */;
- }
- if (hostRef.$flags$ & 4 /* HOST_FLAGS.isWaitingForChildren */) {
- hostRef.$flags$ |= 512 /* HOST_FLAGS.needsRerender */;
- return;
- }
- attachToAncestor(hostRef, hostRef.$ancestorComponent$);
- // there is no ancestor component or the ancestor component
- // has already fired off its lifecycle update then
- // fire off the initial update
- const dispatch = () => dispatchHooks(hostRef, isInitialLoad);
- return writeTask(dispatch) ;
- };
- /**
- * Dispatch initial-render and update lifecycle hooks, enqueuing calls to
- * component lifecycle methods like `componentWillLoad` as well as
- * {@link updateComponent}, which will kick off the virtual DOM re-render.
- *
- * @param hostRef a reference to a host DOM node
- * @param isInitialLoad whether we're on the initial load or not
- * @returns an empty Promise which is used to enqueue a series of operations for
- * the component
- */
- const dispatchHooks = (hostRef, isInitialLoad) => {
- const endSchedule = createTime('scheduleUpdate', hostRef.$cmpMeta$.$tagName$);
- const instance = hostRef.$lazyInstance$ ;
- // We're going to use this variable together with `enqueue` to implement a
- // little promise-based queue. We start out with it `undefined`. When we add
- // the first function to the queue we'll set this variable to be that
- // function's return value. When we attempt to add subsequent values to the
- // queue we'll check that value and, if it was a `Promise`, we'll then chain
- // the new function off of that `Promise` using `.then()`. This will give our
- // queue two nice properties:
- //
- // 1. If all functions added to the queue are synchronous they'll be called
- // synchronously right away.
- // 2. If all functions added to the queue are asynchronous they'll all be
- // called in order after `dispatchHooks` exits.
- let maybePromise;
- if (isInitialLoad) {
- {
- // If `componentWillLoad` returns a `Promise` then we want to wait on
- // whatever's going on in that `Promise` before we launch into
- // rendering the component, doing other lifecycle stuff, etc. So
- // in that case we assign the returned promise to the variable we
- // declared above to hold a possible 'queueing' Promise
- maybePromise = safeCall(instance, 'componentWillLoad');
- }
- }
- endSchedule();
- return enqueue(maybePromise, () => updateComponent(hostRef, instance, isInitialLoad));
- };
- /**
- * This function uses a Promise to implement a simple first-in, first-out queue
- * of functions to be called.
- *
- * The queue is ordered on the basis of the first argument. If it's
- * `undefined`, then nothing is on the queue yet, so the provided function can
- * be called synchronously (although note that this function may return a
- * `Promise`). The idea is that then the return value of that enqueueing
- * operation is kept around, so that if it was a `Promise` then subsequent
- * functions can be enqueued by calling this function again with that `Promise`
- * as the first argument.
- *
- * @param maybePromise either a `Promise` which should resolve before the next function is called or an 'empty' sentinel
- * @param fn a function to enqueue
- * @returns either a `Promise` or the return value of the provided function
- */
- const enqueue = (maybePromise, fn) => isPromisey(maybePromise) ? maybePromise.then(fn) : fn();
- /**
- * Check that a value is a `Promise`. To check, we first see if the value is an
- * instance of the `Promise` global. In a few circumstances, in particular if
- * the global has been overwritten, this is could be misleading, so we also do
- * a little 'duck typing' check to see if the `.then` property of the value is
- * defined and a function.
- *
- * @param maybePromise it might be a promise!
- * @returns whether it is or not
- */
- const isPromisey = (maybePromise) => maybePromise instanceof Promise ||
- (maybePromise && maybePromise.then && typeof maybePromise.then === 'function');
- /**
- * Update a component given reference to its host elements and so on.
- *
- * @param hostRef an object containing references to the element's host node,
- * VDom nodes, and other metadata
- * @param instance a reference to the underlying host element where it will be
- * rendered
- * @param isInitialLoad whether or not this function is being called as part of
- * the first render cycle
- */
- const updateComponent = async (hostRef, instance, isInitialLoad) => {
- var _a;
- const elm = hostRef.$hostElement$;
- const endUpdate = createTime('update', hostRef.$cmpMeta$.$tagName$);
- const rc = elm['s-rc'];
- if (isInitialLoad) {
- // DOM WRITE!
- attachStyles(hostRef);
- }
- const endRender = createTime('render', hostRef.$cmpMeta$.$tagName$);
- {
- callRender(hostRef, instance, elm, isInitialLoad);
- }
- if (rc) {
- // ok, so turns out there are some child host elements
- // waiting on this parent element to load
- // let's fire off all update callbacks waiting
- rc.map((cb) => cb());
- elm['s-rc'] = undefined;
- }
- endRender();
- endUpdate();
- {
- const childrenPromises = (_a = elm['s-p']) !== null && _a !== void 0 ? _a : [];
- const postUpdate = () => postUpdateComponent(hostRef);
- if (childrenPromises.length === 0) {
- postUpdate();
- }
- else {
- Promise.all(childrenPromises).then(postUpdate);
- hostRef.$flags$ |= 4 /* HOST_FLAGS.isWaitingForChildren */;
- childrenPromises.length = 0;
- }
- }
- };
- /**
- * Handle making the call to the VDom renderer with the proper context given
- * various build variables
- *
- * @param hostRef an object containing references to the element's host node,
- * VDom nodes, and other metadata
- * @param instance a reference to the underlying host element where it will be
- * rendered
- * @param elm the Host element for the component
- * @param isInitialLoad whether or not this function is being called as part of
- * @returns an empty promise
- */
- const callRender = (hostRef, instance, elm, isInitialLoad) => {
- try {
- instance = instance.render() ;
- {
- hostRef.$flags$ &= ~16 /* HOST_FLAGS.isQueuedForUpdate */;
- }
- {
- hostRef.$flags$ |= 2 /* HOST_FLAGS.hasRendered */;
- }
- {
- {
- // looks like we've got child nodes to render into this host element
- // or we need to update the css class/attrs on the host element
- // DOM WRITE!
- {
- renderVdom(hostRef, instance, isInitialLoad);
- }
- }
- }
- }
- catch (e) {
- consoleError(e, hostRef.$hostElement$);
- }
- return null;
- };
- const postUpdateComponent = (hostRef) => {
- const tagName = hostRef.$cmpMeta$.$tagName$;
- const elm = hostRef.$hostElement$;
- const endPostUpdate = createTime('postUpdate', tagName);
- const instance = hostRef.$lazyInstance$ ;
- const ancestorComponent = hostRef.$ancestorComponent$;
- if (!(hostRef.$flags$ & 64 /* HOST_FLAGS.hasLoadedComponent */)) {
- hostRef.$flags$ |= 64 /* HOST_FLAGS.hasLoadedComponent */;
- {
- // DOM WRITE!
- addHydratedFlag(elm);
- }
- {
- safeCall(instance, 'componentDidLoad');
- }
- endPostUpdate();
- {
- hostRef.$onReadyResolve$(elm);
- if (!ancestorComponent) {
- appDidLoad();
- }
- }
- }
- else {
- endPostUpdate();
- }
- // load events fire from bottom to top
- // the deepest elements load first then bubbles up
- {
- if (hostRef.$onRenderResolve$) {
- hostRef.$onRenderResolve$();
- hostRef.$onRenderResolve$ = undefined;
- }
- if (hostRef.$flags$ & 512 /* HOST_FLAGS.needsRerender */) {
- nextTick(() => scheduleUpdate(hostRef, false));
- }
- hostRef.$flags$ &= ~(4 /* HOST_FLAGS.isWaitingForChildren */ | 512 /* HOST_FLAGS.needsRerender */);
- }
- // ( •_•)
- // ( •_•)>⌐■-■
- // (⌐■_■)
- };
- const appDidLoad = (who) => {
- // on appload
- // we have finish the first big initial render
- {
- addHydratedFlag(doc.documentElement);
- }
- nextTick(() => emitEvent(win, 'appload', { detail: { namespace: NAMESPACE } }));
- };
- const safeCall = (instance, method, arg) => {
- if (instance && instance[method]) {
- try {
- return instance[method](arg);
- }
- catch (e) {
- consoleError(e);
- }
- }
- return undefined;
- };
- const addHydratedFlag = (elm) => elm.classList.add('hydrated')
- ;
- const getValue = (ref, propName) => getHostRef(ref).$instanceValues$.get(propName);
- const setValue = (ref, propName, newVal, cmpMeta) => {
- // check our new property value against our internal value
- const hostRef = getHostRef(ref);
- const elm = hostRef.$hostElement$ ;
- const oldVal = hostRef.$instanceValues$.get(propName);
- const flags = hostRef.$flags$;
- const instance = hostRef.$lazyInstance$ ;
- newVal = parsePropertyValue(newVal, cmpMeta.$members$[propName][0]);
- // explicitly check for NaN on both sides, as `NaN === NaN` is always false
- const areBothNaN = Number.isNaN(oldVal) && Number.isNaN(newVal);
- const didValueChange = newVal !== oldVal && !areBothNaN;
- if ((!(flags & 8 /* HOST_FLAGS.isConstructingInstance */) || oldVal === undefined) && didValueChange) {
- // gadzooks! the property's value has changed!!
- // set our new value!
- hostRef.$instanceValues$.set(propName, newVal);
- if (instance) {
- // get an array of method names of watch functions to call
- if (cmpMeta.$watchers$ && flags & 128 /* HOST_FLAGS.isWatchReady */) {
- const watchMethods = cmpMeta.$watchers$[propName];
- if (watchMethods) {
- // this instance is watching for when this property changed
- watchMethods.map((watchMethodName) => {
- try {
- // fire off each of the watch methods that are watching this property
- instance[watchMethodName](newVal, oldVal, propName);
- }
- catch (e) {
- consoleError(e, elm);
- }
- });
- }
- }
- if ((flags & (2 /* HOST_FLAGS.hasRendered */ | 16 /* HOST_FLAGS.isQueuedForUpdate */)) === 2 /* HOST_FLAGS.hasRendered */) {
- // looks like this value actually changed, so we've got work to do!
- // but only if we've already rendered, otherwise just chill out
- // queue that we need to do an update, but don't worry about queuing
- // up millions cuz this function ensures it only runs once
- scheduleUpdate(hostRef, false);
- }
- }
- }
- };
- /**
- * Attach a series of runtime constructs to a compiled Stencil component
- * constructor, including getters and setters for the `@Prop` and `@State`
- * decorators, callbacks for when attributes change, and so on.
- *
- * @param Cstr the constructor for a component that we need to process
- * @param cmpMeta metadata collected previously about the component
- * @param flags a number used to store a series of bit flags
- * @returns a reference to the same constructor passed in (but now mutated)
- */
- const proxyComponent = (Cstr, cmpMeta, flags) => {
- if (cmpMeta.$members$) {
- if (Cstr.watchers) {
- cmpMeta.$watchers$ = Cstr.watchers;
- }
- // It's better to have a const than two Object.entries()
- const members = Object.entries(cmpMeta.$members$);
- const prototype = Cstr.prototype;
- members.map(([memberName, [memberFlags]]) => {
- if ((memberFlags & 31 /* MEMBER_FLAGS.Prop */ ||
- ((flags & 2 /* PROXY_FLAGS.proxyState */) && memberFlags & 32 /* MEMBER_FLAGS.State */))) {
- // proxyComponent - prop
- Object.defineProperty(prototype, memberName, {
- get() {
- // proxyComponent, get value
- return getValue(this, memberName);
- },
- set(newValue) {
- // proxyComponent, set value
- setValue(this, memberName, newValue, cmpMeta);
- },
- configurable: true,
- enumerable: true,
- });
- }
- });
- if ((flags & 1 /* PROXY_FLAGS.isElementConstructor */)) {
- const attrNameToPropName = new Map();
- prototype.attributeChangedCallback = function (attrName, _oldValue, newValue) {
- plt.jmp(() => {
- const propName = attrNameToPropName.get(attrName);
- // In a web component lifecycle the attributeChangedCallback runs prior to connectedCallback
- // in the case where an attribute was set inline.
- // ```html
- // <my-component some-attribute="some-value"></my-component>
- // ```
- //
- // There is an edge case where a developer sets the attribute inline on a custom element and then
- // programmatically changes it before it has been upgraded as shown below:
- //
- // ```html
- // <!-- this component has _not_ been upgraded yet -->
- // <my-component id="test" some-attribute="some-value"></my-component>
- // <script>
- // // grab non-upgraded component
- // el = document.querySelector("#test");
- // el.someAttribute = "another-value";
- // // upgrade component
- // customElements.define('my-component', MyComponent);
- // </script>
- // ```
- // In this case if we do not unshadow here and use the value of the shadowing property, attributeChangedCallback
- // will be called with `newValue = "some-value"` and will set the shadowed property (this.someAttribute = "another-value")
- // to the value that was set inline i.e. "some-value" from above example. When
- // the connectedCallback attempts to unshadow it will use "some-value" as the initial value rather than "another-value"
- //
- // The case where the attribute was NOT set inline but was not set programmatically shall be handled/unshadowed
- // by connectedCallback as this attributeChangedCallback will not fire.
- //
- // https://developers.google.com/web/fundamentals/web-components/best-practices#lazy-properties
- //
- // TODO(STENCIL-16) we should think about whether or not we actually want to be reflecting the attributes to
- // properties here given that this goes against best practices outlined here
- // https://developers.google.com/web/fundamentals/web-components/best-practices#avoid-reentrancy
- if (this.hasOwnProperty(propName)) {
- newValue = this[propName];
- delete this[propName];
- }
- else if (prototype.hasOwnProperty(propName) &&
- typeof this[propName] === 'number' &&
- this[propName] == newValue) {
- // if the propName exists on the prototype of `Cstr`, this update may be a result of Stencil using native
- // APIs to reflect props as attributes. Calls to `setAttribute(someElement, propName)` will result in
- // `propName` to be converted to a `DOMString`, which may not be what we want for other primitive props.
- return;
- }
- this[propName] = newValue === null && typeof this[propName] === 'boolean' ? false : newValue;
- });
- };
- // create an array of attributes to observe
- // and also create a map of html attribute name to js property name
- Cstr.observedAttributes = members
- .filter(([_, m]) => m[0] & 15 /* MEMBER_FLAGS.HasAttribute */) // filter to only keep props that should match attributes
- .map(([propName, m]) => {
- const attrName = m[1] || propName;
- attrNameToPropName.set(attrName, propName);
- if (m[0] & 512 /* MEMBER_FLAGS.ReflectAttr */) {
- cmpMeta.$attrsToReflect$.push([propName, attrName]);
- }
- return attrName;
- });
- }
- }
- return Cstr;
- };
- const initializeComponent = async (elm, hostRef, cmpMeta, hmrVersionId, Cstr) => {
- // initializeComponent
- if ((hostRef.$flags$ & 32 /* HOST_FLAGS.hasInitializedComponent */) === 0) {
- // Let the runtime know that the component has been initialized
- hostRef.$flags$ |= 32 /* HOST_FLAGS.hasInitializedComponent */;
- {
- // lazy loaded components
- // request the component's implementation to be
- // wired up with the host element
- Cstr = loadModule(cmpMeta);
- if (Cstr.then) {
- // Await creates a micro-task avoid if possible
- const endLoad = uniqueTime();
- Cstr = await Cstr;
- endLoad();
- }
- if (!Cstr.isProxied) {
- // we've never proxied this Constructor before
- // let's add the getters/setters to its prototype before
- // the first time we create an instance of the implementation
- {
- cmpMeta.$watchers$ = Cstr.watchers;
- }
- proxyComponent(Cstr, cmpMeta, 2 /* PROXY_FLAGS.proxyState */);
- Cstr.isProxied = true;
- }
- const endNewInstance = createTime('createInstance', cmpMeta.$tagName$);
- // ok, time to construct the instance
- // but let's keep track of when we start and stop
- // so that the getters/setters don't incorrectly step on data
- {
- hostRef.$flags$ |= 8 /* HOST_FLAGS.isConstructingInstance */;
- }
- // construct the lazy-loaded component implementation
- // passing the hostRef is very important during
- // construction in order to directly wire together the
- // host element and the lazy-loaded instance
- try {
- new Cstr(hostRef);
- }
- catch (e) {
- consoleError(e);
- }
- {
- hostRef.$flags$ &= ~8 /* HOST_FLAGS.isConstructingInstance */;
- }
- {
- hostRef.$flags$ |= 128 /* HOST_FLAGS.isWatchReady */;
- }
- endNewInstance();
- fireConnectedCallback(hostRef.$lazyInstance$);
- }
- if (Cstr.style) {
- // this component has styles but we haven't registered them yet
- let style = Cstr.style;
- const scopeId = getScopeId(cmpMeta);
- if (!styles.has(scopeId)) {
- const endRegisterStyles = createTime('registerStyles', cmpMeta.$tagName$);
- registerStyle(scopeId, style, !!(cmpMeta.$flags$ & 1 /* CMP_FLAGS.shadowDomEncapsulation */));
- endRegisterStyles();
- }
- }
- }
- // we've successfully created a lazy instance
- const ancestorComponent = hostRef.$ancestorComponent$;
- const schedule = () => scheduleUpdate(hostRef, true);
- if (ancestorComponent && ancestorComponent['s-rc']) {
- // this is the initial load and this component it has an ancestor component
- // but the ancestor component has NOT fired its will update lifecycle yet
- // so let's just cool our jets and wait for the ancestor to continue first
- // this will get fired off when the ancestor component
- // finally gets around to rendering its lazy self
- // fire off the initial update
- ancestorComponent['s-rc'].push(schedule);
- }
- else {
- schedule();
- }
- };
- const fireConnectedCallback = (instance) => {
- {
- safeCall(instance, 'connectedCallback');
- }
- };
- const connectedCallback = (elm) => {
- if ((plt.$flags$ & 1 /* PLATFORM_FLAGS.isTmpDisconnected */) === 0) {
- const hostRef = getHostRef(elm);
- const cmpMeta = hostRef.$cmpMeta$;
- const endConnected = createTime('connectedCallback', cmpMeta.$tagName$);
- if (!(hostRef.$flags$ & 1 /* HOST_FLAGS.hasConnected */)) {
- // first time this component has connected
- hostRef.$flags$ |= 1 /* HOST_FLAGS.hasConnected */;
- {
- // find the first ancestor component (if there is one) and register
- // this component as one of the actively loading child components for its ancestor
- let ancestorComponent = elm;
- while ((ancestorComponent = ancestorComponent.parentNode || ancestorComponent.host)) {
- // climb up the ancestors looking for the first
- // component that hasn't finished its lifecycle update yet
- if (ancestorComponent['s-p']) {
- // we found this components first ancestor component
- // keep a reference to this component's ancestor component
- attachToAncestor(hostRef, (hostRef.$ancestorComponent$ = ancestorComponent));
- break;
- }
- }
- }
- // Lazy properties
- // https://developers.google.com/web/fundamentals/web-components/best-practices#lazy-properties
- if (cmpMeta.$members$) {
- Object.entries(cmpMeta.$members$).map(([memberName, [memberFlags]]) => {
- if (memberFlags & 31 /* MEMBER_FLAGS.Prop */ && elm.hasOwnProperty(memberName)) {
- const value = elm[memberName];
- delete elm[memberName];
- elm[memberName] = value;
- }
- });
- }
- {
- initializeComponent(elm, hostRef, cmpMeta);
- }
- }
- else {
- // fire off connectedCallback() on component instance
- if (hostRef === null || hostRef === void 0 ? void 0 : hostRef.$lazyInstance$) {
- fireConnectedCallback(hostRef.$lazyInstance$);
- }
- else if (hostRef === null || hostRef === void 0 ? void 0 : hostRef.$onReadyPromise$) {
- hostRef.$onReadyPromise$.then(() => fireConnectedCallback(hostRef.$lazyInstance$));
- }
- }
- endConnected();
- }
- };
- const disconnectInstance = (instance) => {
- {
- safeCall(instance, 'disconnectedCallback');
- }
- };
- const disconnectedCallback = async (elm) => {
- if ((plt.$flags$ & 1 /* PLATFORM_FLAGS.isTmpDisconnected */) === 0) {
- const hostRef = getHostRef(elm);
- if (hostRef === null || hostRef === void 0 ? void 0 : hostRef.$lazyInstance$) {
- disconnectInstance(hostRef.$lazyInstance$);
- }
- else if (hostRef === null || hostRef === void 0 ? void 0 : hostRef.$onReadyPromise$) {
- hostRef.$onReadyPromise$.then(() => disconnectInstance(hostRef.$lazyInstance$));
- }
- }
- };
- const bootstrapLazy = (lazyBundles, options = {}) => {
- var _a;
- const endBootstrap = createTime();
- const cmpTags = [];
- const exclude = options.exclude || [];
- const customElements = win.customElements;
- const head = doc.head;
- const metaCharset = /*@__PURE__*/ head.querySelector('meta[charset]');
- const visibilityStyle = /*@__PURE__*/ doc.createElement('style');
- const deferredConnectedCallbacks = [];
- let appLoadFallback;
- let isBootstrapping = true;
- Object.assign(plt, options);
- plt.$resourcesUrl$ = new URL(options.resourcesUrl || './', doc.baseURI).href;
- lazyBundles.map((lazyBundle) => {
- lazyBundle[1].map((compactMeta) => {
- const cmpMeta = {
- $flags$: compactMeta[0],
- $tagName$: compactMeta[1],
- $members$: compactMeta[2],
- $listeners$: compactMeta[3],
- };
- {
- cmpMeta.$members$ = compactMeta[2];
- }
- {
- cmpMeta.$attrsToReflect$ = [];
- }
- {
- cmpMeta.$watchers$ = {};
- }
- const tagName = cmpMeta.$tagName$;
- const HostElement = class extends HTMLElement {
- // StencilLazyHost
- constructor(self) {
- // @ts-ignore
- super(self);
- self = this;
- registerHost(self, cmpMeta);
- if (cmpMeta.$flags$ & 1 /* CMP_FLAGS.shadowDomEncapsulation */) {
- // this component is using shadow dom
- // and this browser supports shadow dom
- // add the read-only property "shadowRoot" to the host element
- // adding the shadow root build conditionals to minimize runtime
- {
- {
- self.attachShadow({ mode: 'open' });
- }
- }
- }
- }
- connectedCallback() {
- if (appLoadFallback) {
- clearTimeout(appLoadFallback);
- appLoadFallback = null;
- }
- if (isBootstrapping) {
- // connectedCallback will be processed once all components have been registered
- deferredConnectedCallbacks.push(this);
- }
- else {
- plt.jmp(() => connectedCallback(this));
- }
- }
- disconnectedCallback() {
- plt.jmp(() => disconnectedCallback(this));
- }
- componentOnReady() {
- return getHostRef(this).$onReadyPromise$;
- }
- };
- cmpMeta.$lazyBundleId$ = lazyBundle[0];
- if (!exclude.includes(tagName) && !customElements.get(tagName)) {
- cmpTags.push(tagName);
- customElements.define(tagName, proxyComponent(HostElement, cmpMeta, 1 /* PROXY_FLAGS.isElementConstructor */));
- }
- });
- });
- {
- visibilityStyle.innerHTML = cmpTags + HYDRATED_CSS;
- visibilityStyle.setAttribute('data-styles', '');
- // Apply CSP nonce to the style tag if it exists
- const nonce = (_a = plt.$nonce$) !== null && _a !== void 0 ? _a : queryNonceMetaTagContent(doc);
- if (nonce != null) {
- visibilityStyle.setAttribute('nonce', nonce);
- }
- head.insertBefore(visibilityStyle, metaCharset ? metaCharset.nextSibling : head.firstChild);
- }
- // Process deferred connectedCallbacks now all components have been registered
- isBootstrapping = false;
- if (deferredConnectedCallbacks.length) {
- deferredConnectedCallbacks.map((host) => host.connectedCallback());
- }
- else {
- {
- plt.jmp(() => (appLoadFallback = setTimeout(appDidLoad, 30)));
- }
- }
- // Fallback appLoad event
- endBootstrap();
- };
- /**
- * Assigns the given value to the nonce property on the runtime platform object.
- * During runtime, this value is used to set the nonce attribute on all dynamically created script and style tags.
- * @param nonce The value to be assigned to the platform nonce property.
- * @returns void
- */
- const setNonce = (nonce) => (plt.$nonce$ = nonce);
- const hostRefs = /*@__PURE__*/ new WeakMap();
- const getHostRef = (ref) => hostRefs.get(ref);
- const registerInstance = (lazyInstance, hostRef) => hostRefs.set((hostRef.$lazyInstance$ = lazyInstance), hostRef);
- const registerHost = (elm, cmpMeta) => {
- const hostRef = {
- $flags$: 0,
- $hostElement$: elm,
- $cmpMeta$: cmpMeta,
- $instanceValues$: new Map(),
- };
- {
- hostRef.$onReadyPromise$ = new Promise((r) => (hostRef.$onReadyResolve$ = r));
- elm['s-p'] = [];
- elm['s-rc'] = [];
- }
- return hostRefs.set(elm, hostRef);
- };
- const isMemberInElement = (elm, memberName) => memberName in elm;
- const consoleError = (e, el) => (0, console.error)(e, el);
- const cmpModules = /*@__PURE__*/ new Map();
- const loadModule = (cmpMeta, hostRef, hmrVersionId) => {
- // loadModuleImport
- const exportName = cmpMeta.$tagName$.replace(/-/g, '_');
- const bundleId = cmpMeta.$lazyBundleId$;
- const module = cmpModules.get(bundleId) ;
- if (module) {
- return module[exportName];
- }
- /*!__STENCIL_STATIC_IMPORT_SWITCH__*/
- return import(
- /* @vite-ignore */
- /* webpackInclude: /\.entry\.js$/ */
- /* webpackExclude: /\.system\.entry\.js$/ */
- /* webpackMode: "lazy" */
- `./${bundleId}.entry.js${''}`).then((importedModule) => {
- {
- cmpModules.set(bundleId, importedModule);
- }
- return importedModule[exportName];
- }, consoleError);
- };
- const styles = /*@__PURE__*/ new Map();
- const win = typeof window !== 'undefined' ? window : {};
- const doc = win.document || { head: {} };
- const plt = {
- $flags$: 0,
- $resourcesUrl$: '',
- jmp: (h) => h(),
- raf: (h) => requestAnimationFrame(h),
- ael: (el, eventName, listener, opts) => el.addEventListener(eventName, listener, opts),
- rel: (el, eventName, listener, opts) => el.removeEventListener(eventName, listener, opts),
- ce: (eventName, opts) => new CustomEvent(eventName, opts),
- };
- const promiseResolve = (v) => Promise.resolve(v);
- const supportsConstructableStylesheets = /*@__PURE__*/ (() => {
- try {
- new CSSStyleSheet();
- return typeof new CSSStyleSheet().replaceSync === 'function';
- }
- catch (e) { }
- return false;
- })()
- ;
- const queueDomReads = [];
- const queueDomWrites = [];
- const queueTask = (queue, write) => (cb) => {
- queue.push(cb);
- if (!queuePending) {
- queuePending = true;
- if (write && plt.$flags$ & 4 /* PLATFORM_FLAGS.queueSync */) {
- nextTick(flush);
- }
- else {
- plt.raf(flush);
- }
- }
- };
- const consume = (queue) => {
- for (let i = 0; i < queue.length; i++) {
- try {
- queue[i](performance.now());
- }
- catch (e) {
- consoleError(e);
- }
- }
- queue.length = 0;
- };
- const flush = () => {
- // always force a bunch of medium callbacks to run, but still have
- // a throttle on how many can run in a certain time
- // DOM READS!!!
- consume(queueDomReads);
- // DOM WRITES!!!
- {
- consume(queueDomWrites);
- if ((queuePending = queueDomReads.length > 0)) {
- // still more to do yet, but we've run out of time
- // let's let this thing cool off and try again in the next tick
- plt.raf(flush);
- }
- }
- };
- const nextTick = /*@__PURE__*/ (cb) => promiseResolve().then(cb);
- const writeTask = /*@__PURE__*/ queueTask(queueDomWrites, true);
- export { Host as H, setAssetPath as a, bootstrapLazy as b, getElement as c, getAssetPath as g, h, promiseResolve as p, registerInstance as r, setNonce as s };
|