@stencil/core
Version:
A Compiler for Web Components and Progressive Web Apps
1,138 lines • 145 kB
JavaScript
let scopeId;
let contentRef;
let hostTagName;
let customError;
let i = 0;
let useNativeShadowDom = false;
let checkSlotFallbackVisibility = false;
let checkSlotRelocate = false;
let isSvgMode = false;
let renderingRef = null;
let queueCongestion = 0;
let queuePending = false;
/*
Stencil Client Platform v2.18.0 | MIT Licensed | https://stenciljs.com
*/
import { BUILD, NAMESPACE } from '@stencil/core/internal/app-data';
const win = typeof window !== 'undefined' ? window : {};
const CSS = BUILD.cssVarShim ? win.CSS : null;
const doc = win.document || { head: {} };
const H = (win.HTMLElement || class {
});
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 setPlatformHelpers = (helpers) => {
Object.assign(plt, helpers);
};
const supportsShadow = BUILD.shadowDomShim && BUILD.shadowDom
? /*@__PURE__*/ (() => (doc.head.attachShadow + '').indexOf('[native') > -1)()
: true;
const supportsListenerOptions = /*@__PURE__*/ (() => {
let supportsListenerOptions = false;
try {
doc.addEventListener('e', null, Object.defineProperty({}, 'passive', {
get() {
supportsListenerOptions = true;
},
}));
}
catch (e) { }
return supportsListenerOptions;
})();
const promiseResolve = (v) => Promise.resolve(v);
const supportsConstructableStylesheets = BUILD.constructableCSS
? /*@__PURE__*/ (() => {
try {
new CSSStyleSheet();
return typeof new CSSStyleSheet().replaceSync === 'function';
}
catch (e) { }
return false;
})()
: false;
const Context = {};
const addHostEventListeners = (elm, hostRef, listeners, attachParentListeners) => {
if (BUILD.hostListener && listeners) {
// this is called immediately within the element's constructor
// initialize our event listeners on the host element
// we do this now so that we can listen to events that may
// have fired even before the instance is ready
if (BUILD.hostListenerTargetParent) {
// this component may have event listeners that should be attached to the parent
if (attachParentListeners) {
// this is being ran from within the connectedCallback
// which is important so that we know the host element actually has a parent element
// filter out the listeners to only have the ones that ARE being attached to the parent
listeners = listeners.filter(([flags]) => flags & 32 /* LISTENER_FLAGS.TargetParent */);
}
else {
// this is being ran from within the component constructor
// everything BUT the parent element listeners should be attached at this time
// filter out the listeners that are NOT being attached to the parent
listeners = listeners.filter(([flags]) => !(flags & 32 /* LISTENER_FLAGS.TargetParent */));
}
}
listeners.map(([flags, name, method]) => {
const target = BUILD.hostListenerTarget ? getHostListenerTarget(elm, flags) : elm;
const handler = hostListenerProxy(hostRef, method);
const opts = hostListenerOpts(flags);
plt.ael(target, name, handler, opts);
(hostRef.$rmListeners$ = hostRef.$rmListeners$ || []).push(() => plt.rel(target, name, handler, opts));
});
}
};
const hostListenerProxy = (hostRef, methodName) => (ev) => {
try {
if (BUILD.lazyLoad) {
if (hostRef.$flags$ & 256 /* HOST_FLAGS.isListenReady */) {
// instance is ready, let's call it's member method for this event
hostRef.$lazyInstance$[methodName](ev);
}
else {
(hostRef.$queuedListeners$ = hostRef.$queuedListeners$ || []).push([methodName, ev]);
}
}
else {
hostRef.$hostElement$[methodName](ev);
}
}
catch (e) {
consoleError(e);
}
};
const getHostListenerTarget = (elm, flags) => {
if (BUILD.hostListenerTargetDocument && flags & 4 /* LISTENER_FLAGS.TargetDocument */)
return doc;
if (BUILD.hostListenerTargetWindow && flags & 8 /* LISTENER_FLAGS.TargetWindow */)
return win;
if (BUILD.hostListenerTargetBody && flags & 16 /* LISTENER_FLAGS.TargetBody */)
return doc.body;
if (BUILD.hostListenerTargetParent && flags & 32 /* LISTENER_FLAGS.TargetParent */)
return elm.parentElement;
return elm;
};
// prettier-ignore
const hostListenerOpts = (flags) => supportsListenerOptions
? ({
passive: (flags & 1 /* LISTENER_FLAGS.Passive */) !== 0,
capture: (flags & 2 /* LISTENER_FLAGS.Capture */) !== 0,
})
: (flags & 2 /* LISTENER_FLAGS.Capture */) !== 0;
const CONTENT_REF_ID = 'r';
const ORG_LOCATION_ID = 'o';
const SLOT_NODE_ID = 's';
const TEXT_NODE_ID = 't';
const HYDRATE_ID = 's-id';
const HYDRATED_STYLE_ID = 'sty-id';
const HYDRATE_CHILD_ID = 'c-id';
const HYDRATED_CSS = '{visibility:hidden}.hydrated{visibility:inherit}';
const XLINK_NS = 'http://www.w3.org/1999/xlink';
const createTime = (fnName, tagName = '') => {
if (BUILD.profile && performance.mark) {
const key = `st:${fnName}:${tagName}:${i++}`;
// Start
performance.mark(key);
// End
return () => performance.measure(`[Stencil] ${fnName}() <${tagName}>`, key);
}
else {
return () => {
return;
};
}
};
const uniqueTime = (key, measureText) => {
if (BUILD.profile && performance.mark) {
if (performance.getEntriesByName(key).length === 0) {
performance.mark(key);
}
return () => {
if (performance.getEntriesByName(measureText).length === 0) {
performance.measure(measureText, key);
}
};
}
else {
return () => {
return;
};
}
};
const inspect = (ref) => {
const hostRef = getHostRef(ref);
if (!hostRef) {
return undefined;
}
const flags = hostRef.$flags$;
const hostElement = hostRef.$hostElement$;
return {
renderCount: hostRef.$renderCount$,
flags: {
hasRendered: !!(flags & 2 /* HOST_FLAGS.hasRendered */),
hasConnected: !!(flags & 1 /* HOST_FLAGS.hasConnected */),
isWaitingForChildren: !!(flags & 4 /* HOST_FLAGS.isWaitingForChildren */),
isConstructingInstance: !!(flags & 8 /* HOST_FLAGS.isConstructingInstance */),
isQueuedForUpdate: !!(flags & 16 /* HOST_FLAGS.isQueuedForUpdate */),
hasInitializedComponent: !!(flags & 32 /* HOST_FLAGS.hasInitializedComponent */),
hasLoadedComponent: !!(flags & 64 /* HOST_FLAGS.hasLoadedComponent */),
isWatchReady: !!(flags & 128 /* HOST_FLAGS.isWatchReady */),
isListenReady: !!(flags & 256 /* HOST_FLAGS.isListenReady */),
needsRerender: !!(flags & 512 /* HOST_FLAGS.needsRerender */),
},
instanceValues: hostRef.$instanceValues$,
ancestorComponent: hostRef.$ancestorComponent$,
hostElement,
lazyInstance: hostRef.$lazyInstance$,
vnode: hostRef.$vnode$,
modeName: hostRef.$modeName$,
onReadyPromise: hostRef.$onReadyPromise$,
onReadyResolve: hostRef.$onReadyResolve$,
onInstancePromise: hostRef.$onInstancePromise$,
onInstanceResolve: hostRef.$onInstanceResolve$,
onRenderResolve: hostRef.$onRenderResolve$,
queuedListeners: hostRef.$queuedListeners$,
rmListeners: hostRef.$rmListeners$,
['s-id']: hostElement['s-id'],
['s-cr']: hostElement['s-cr'],
['s-lr']: hostElement['s-lr'],
['s-p']: hostElement['s-p'],
['s-rc']: hostElement['s-rc'],
['s-sc']: hostElement['s-sc'],
};
};
const installDevTools = () => {
if (BUILD.devTools) {
const stencil = (win.stencil = win.stencil || {});
const originalInspect = stencil.inspect;
stencil.inspect = (ref) => {
let result = inspect(ref);
if (!result && typeof originalInspect === 'function') {
result = originalInspect(ref);
}
return result;
};
}
};
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, hostElm) => {
let scopeId = getScopeId(cmpMeta, mode);
const style = styles.get(scopeId);
if (!BUILD.attachStyles) {
return 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)) {
if (BUILD.hydrateClientSide &&
styleContainerNode.host &&
(styleElm = styleContainerNode.querySelector(`[${HYDRATED_STYLE_ID}="${scopeId}"]`))) {
// This is only happening on native shadow-dom, do not needs CSS var shim
styleElm.innerHTML = style;
}
else {
if (BUILD.cssVarShim && plt.$cssShim$) {
styleElm = plt.$cssShim$.createHostStyle(hostElm, scopeId, style, !!(cmpMeta.$flags$ & 10 /* CMP_FLAGS.needsScopedEncapsulation */));
const newScopeId = styleElm['s-sc'];
if (newScopeId) {
scopeId = newScopeId;
// we don't want to add this styleID to the appliedStyles Set
// since the cssVarShim might need to apply several different
// stylesheets for the same component
appliedStyles = null;
}
}
else {
styleElm = doc.createElement('style');
styleElm.innerHTML = style;
}
if (BUILD.hydrateServerSide || BUILD.hotModuleReplacement) {
styleElm.setAttribute(HYDRATED_STYLE_ID, scopeId);
}
styleContainerNode.insertBefore(styleElm, styleContainerNode.querySelector('link'));
}
if (appliedStyles) {
appliedStyles.add(scopeId);
}
}
}
else if (BUILD.constructableCSS && !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(BUILD.shadowDom && supportsShadow && elm.shadowRoot ? elm.shadowRoot : elm.getRootNode(), cmpMeta, hostRef.$modeName$, elm);
if ((BUILD.shadowDom || BUILD.scoped) && BUILD.cssAnnotations && 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');
if (BUILD.scoped && flags & 2 /* CMP_FLAGS.scopedCssEncapsulation */) {
elm.classList.add(scopeId + '-s');
}
}
endAttachStyles();
};
const getScopeId = (cmp, mode) => 'sc-' + (BUILD.mode && mode && cmp.$flags$ & 32 /* CMP_FLAGS.hasMode */ ? cmp.$tagName$ + '-' + mode : cmp.$tagName$);
const convertScopedToShadow = (css) => css.replace(/\/\*!@([^\/]+)\*\/[^\{]+\{/g, '$1{');
// Private
const computeMode = (elm) => modeResolutionChain.map((h) => h(elm)).find((m) => !!m);
// Public
const setMode = (handler) => modeResolutionChain.push(handler);
const getMode = (ref) => getHostRef(ref).$modeName$;
/**
* Default style mode id
*/
/**
* Reusable empty obj/array
* Don't add values to these!!
*/
const EMPTY_OBJ = {};
/**
* Namespaces
*/
const SVG_NS = 'http://www.w3.org/2000/svg';
const HTML_NS = 'http://www.w3.org/1999/xhtml';
const isDef = (v) => v != null;
const isComplexType = (o) => {
// https://jsperf.com/typeof-fn-object/5
o = typeof o;
return o === 'object' || o === 'function';
};
/**
* 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
*/
// const stack: any[] = [];
// 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 slotName = 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);
}
else if (BUILD.isDev && typeof nodeName !== 'function' && child.$flags$ === undefined) {
consoleDevError(`vNode passed as children has unexpected type.
Make sure it's using the correct h() function.
Empty objects can also be the cause, look for JSX comments that became objects.`);
}
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) {
if (BUILD.isDev && nodeName === 'input') {
validateInputProperties(vnodeData);
}
// normalize class / classname attributes
if (BUILD.vdomKey && vnodeData.key) {
key = vnodeData.key;
}
if (BUILD.slotRelocation && vnodeData.name) {
slotName = vnodeData.name;
}
if (BUILD.vdomClass) {
const classData = vnodeData.className || vnodeData.class;
if (classData) {
vnodeData.class =
typeof classData !== 'object'
? classData
: Object.keys(classData)
.filter((k) => classData[k])
.join(' ');
}
}
}
if (BUILD.isDev && vNodeChildren.some(isHost)) {
consoleDevError(`The <Host> must be the single root component. Make sure:
- You are NOT using hostData() and <Host> in the same component.
- <Host> is used once, and it's the single root component of the render() function.`);
}
if (BUILD.vdomFunctional && typeof nodeName === 'function') {
// nodeName is a functional component
return nodeName(vnodeData === null ? {} : vnodeData, vNodeChildren, vdomFnUtils);
}
const vnode = newVNode(nodeName, null);
vnode.$attrs$ = vnodeData;
if (vNodeChildren.length > 0) {
vnode.$children$ = vNodeChildren;
}
if (BUILD.vdomKey) {
vnode.$key$ = key;
}
if (BUILD.slotRelocation) {
vnode.$name$ = slotName;
}
return vnode;
};
const newVNode = (tag, text) => {
const vnode = {
$flags$: 0,
$tag$: tag,
$text$: text,
$elm$: null,
$children$: null,
};
if (BUILD.vdomAttribute) {
vnode.$attrs$ = null;
}
if (BUILD.vdomKey) {
vnode.$key$ = null;
}
if (BUILD.slotRelocation) {
vnode.$name$ = null;
}
return vnode;
};
const Host = {};
const isHost = (node) => node && node.$tag$ === Host;
const vdomFnUtils = {
forEach: (children, cb) => children.map(convertToPublic).forEach(cb),
map: (children, cb) => children.map(convertToPublic).map(cb).map(convertToPrivate),
};
const convertToPublic = (node) => ({
vattrs: node.$attrs$,
vchildren: node.$children$,
vkey: node.$key$,
vname: node.$name$,
vtag: node.$tag$,
vtext: node.$text$,
});
const convertToPrivate = (node) => {
if (typeof node.vtag === 'function') {
const vnodeData = Object.assign({}, node.vattrs);
if (node.vkey) {
vnodeData.key = node.vkey;
}
if (node.vname) {
vnodeData.name = node.vname;
}
return h(node.vtag, vnodeData, ...(node.vchildren || []));
}
const vnode = newVNode(node.vtag, node.vtext);
vnode.$attrs$ = node.vattrs;
vnode.$children$ = node.vchildren;
vnode.$key$ = node.vkey;
vnode.$name$ = node.vname;
return vnode;
};
/**
* Validates the ordering of attributes on an input element
* @param inputElm the element to validate
*/
const validateInputProperties = (inputElm) => {
const props = Object.keys(inputElm);
const value = props.indexOf('value');
if (value === -1) {
return;
}
const typeIndex = props.indexOf('type');
const minIndex = props.indexOf('min');
const maxIndex = props.indexOf('max');
const stepIndex = props.indexOf('step');
if (value < typeIndex || value < minIndex || value < maxIndex || value < stepIndex) {
consoleDevWarn(`The "value" prop of <input> should be set after "min", "max", "type" and "step"`);
}
};
/**
* 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
*/
const setAccessor = (elm, memberName, oldValue, newValue, isSvg, flags) => {
if (oldValue !== newValue) {
let isProp = isMemberInElement(elm, memberName);
let ln = memberName.toLowerCase();
if (BUILD.vdomClass && 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 (BUILD.vdomStyle && memberName === 'style') {
// update style attribute, css properties and values
if (BUILD.updatable) {
for (const prop in oldValue) {
if (!newValue || newValue[prop] == null) {
if (!BUILD.hydrateServerSide && prop.includes('-')) {
elm.style.removeProperty(prop);
}
else {
elm.style[prop] = '';
}
}
}
}
for (const prop in newValue) {
if (!oldValue || newValue[prop] !== oldValue[prop]) {
if (!BUILD.hydrateServerSide && prop.includes('-')) {
elm.style.setProperty(prop, newValue[prop]);
}
else {
elm.style[prop] = newValue[prop];
}
}
}
}
else if (BUILD.vdomKey && memberName === 'key')
;
else if (BUILD.vdomRef && memberName === 'ref') {
// minifier will clean this up
if (newValue) {
newValue(elm);
}
}
else if (BUILD.vdomListener &&
(BUILD.lazyLoad ? !isProp : !elm.__lookupSetter__(memberName)) &&
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 if (BUILD.vdomPropOrAttr) {
// 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 (BUILD.vdomXlink) {
if (ln !== (ln = ln.replace(/^xlink\:?/, ''))) {
memberName = ln;
xlink = true;
}
}
if (newValue == null || newValue === false) {
if (newValue !== false || elm.getAttribute(memberName) === '') {
if (BUILD.vdomXlink && 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 (BUILD.vdomXlink && 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;
if (BUILD.updatable) {
// 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;
let oldVNode;
if (BUILD.slotRelocation && !useNativeShadowDom) {
// remember for later we need to check to relocate nodes
checkSlotRelocate = true;
if (newVNode.$tag$ === 'slot') {
if (scopeId) {
// scoped css needs to add its scoped id to the parent element
parentElm.classList.add(scopeId + '-s');
}
newVNode.$flags$ |= newVNode.$children$
? // slot element has fallback content
2 /* VNODE_FLAGS.isSlotFallback */
: // slot element does not have fallback content
1 /* VNODE_FLAGS.isSlotReference */;
}
}
if (BUILD.isDev && newVNode.$elm$) {
consoleDevError(`The JSX ${newVNode.$text$ !== null ? `"${newVNode.$text$}" text` : `"${newVNode.$tag$}" element`} node should not be shared within the same renderer. The renderer caches element lookups in order to improve performance. However, a side effect from this is that the exact same JSX node should not be reused. For more information please see https://stenciljs.com/docs/templating-jsx#avoid-shared-jsx-nodes`);
}
if (BUILD.vdomText && newVNode.$text$ !== null) {
// create text node
elm = newVNode.$elm$ = doc.createTextNode(newVNode.$text$);
}
else if (BUILD.slotRelocation && newVNode.$flags$ & 1 /* VNODE_FLAGS.isSlotReference */) {
// create a slot reference node
elm = newVNode.$elm$ =
BUILD.isDebug || BUILD.hydrateServerSide ? slotReferenceDebugNode(newVNode) : doc.createTextNode('');
}
else {
if (BUILD.svg && !isSvgMode) {
isSvgMode = newVNode.$tag$ === 'svg';
}
// create element
elm = newVNode.$elm$ = (BUILD.svg
? doc.createElementNS(isSvgMode ? SVG_NS : HTML_NS, BUILD.slotRelocation && newVNode.$flags$ & 2 /* VNODE_FLAGS.isSlotFallback */
? 'slot-fb'
: newVNode.$tag$)
: doc.createElement(BUILD.slotRelocation && newVNode.$flags$ & 2 /* VNODE_FLAGS.isSlotFallback */
? 'slot-fb'
: newVNode.$tag$));
if (BUILD.svg && isSvgMode && newVNode.$tag$ === 'foreignObject') {
isSvgMode = false;
}
// add css classes, attrs, props, listeners, etc.
if (BUILD.vdomAttribute) {
updateElement(null, newVNode, isSvgMode);
}
if ((BUILD.shadowDom || BUILD.scoped) && 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, elm);
// return node could have been null
if (childNode) {
// append our new node
elm.appendChild(childNode);
}
}
}
if (BUILD.svg) {
if (newVNode.$tag$ === 'svg') {
// Only reset the SVG context when we're exiting <svg> element
isSvgMode = false;
}
else if (elm.tagName === 'foreignObject') {
// Reenter SVG context when we're exiting <foreignObject> element
isSvgMode = true;
}
}
}
if (BUILD.slotRelocation) {
elm['s-hn'] = hostTagName;
if (newVNode.$flags$ & (2 /* VNODE_FLAGS.isSlotFallback */ | 1 /* VNODE_FLAGS.isSlotReference */)) {
// remember the content reference comment
elm['s-sr'] = true;
// remember the content reference comment
elm['s-cr'] = contentRef;
// remember the slot name, or empty string for default slot
elm['s-sn'] = newVNode.$name$ || '';
// check if we've got an old vnode for this slot
oldVNode = oldParentVNode && oldParentVNode.$children$ && oldParentVNode.$children$[childIndex];
if (oldVNode && oldVNode.$tag$ === newVNode.$tag$ && oldParentVNode.$elm$) {
// we've got an old slot vnode and the wrapper is being replaced
// so let's move the old slot content back to it's original location
putBackInOriginalLocation(oldParentVNode.$elm$, false);
}
}
}
return elm;
};
const putBackInOriginalLocation = (parentElm, recursive) => {
plt.$flags$ |= 1 /* PLATFORM_FLAGS.isTmpDisconnected */;
const oldSlotChildNodes = parentElm.childNodes;
for (let i = oldSlotChildNodes.length - 1; i >= 0; i--) {
const childNode = oldSlotChildNodes[i];
if (childNode['s-hn'] !== hostTagName && childNode['s-ol']) {
// // this child node in the old element is from another component
// // remove this node from the old slot's parent
// childNode.remove();
// and relocate it back to it's original location
parentReferenceNode(childNode).insertBefore(childNode, referenceNode(childNode));
// remove the old original location comment entirely
// later on the patch function will know what to do
// and move this to the correct spot in need be
childNode['s-ol'].remove();
childNode['s-ol'] = undefined;
checkSlotRelocate = true;
}
if (recursive) {
putBackInOriginalLocation(childNode, recursive);
}
}
plt.$flags$ &= ~1 /* PLATFORM_FLAGS.isTmpDisconnected */;
};
const addVnodes = (parentElm, before, parentVNode, vnodes, startIdx, endIdx) => {
let containerElm = ((BUILD.slotRelocation && parentElm['s-cr'] && parentElm['s-cr'].parentNode) || parentElm);
let childNode;
if (BUILD.shadowDom && containerElm.shadowRoot && containerElm.tagName === hostTagName) {
containerElm = containerElm.shadowRoot;
}
for (; startIdx <= endIdx; ++startIdx) {
if (vnodes[startIdx]) {
childNode = createElm(null, parentVNode, startIdx, parentElm);
if (childNode) {
vnodes[startIdx].$elm$ = childNode;
containerElm.insertBefore(childNode, BUILD.slotRelocation ? referenceNode(before) : before);
}
}
}
};
const removeVnodes = (vnodes, startIdx, endIdx, vnode, elm) => {
for (; startIdx <= endIdx; ++startIdx) {
if ((vnode = vnodes[startIdx])) {
elm = vnode.$elm$;
callNodeRefs(vnode);
if (BUILD.slotRelocation) {
// we're removing this element
// so it's possible we need to show slot fallback content now
checkSlotFallbackVisibility = true;
if (elm['s-ol']) {
// remove the original location comment
elm['s-ol'].remove();
}
else {
// it's possible that child nodes of the node
// that's being removed are slot nodes
putBackInOriginalLocation(elm, true);
}
}
// 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)) {
// case: "Vnode moved right"
//
// We've found that the last node in our window on the new children is
// the same VNode as the _first_ node in our window on the old children
// we're dealing with now. Visually, this is the layout of these two
// nodes:
//
// newCh: [..., newStartVnode , ... , newEndVnode , ...]
// ^^^^^^^^^^^
// oldCh: [..., oldStartVnode , ... , oldEndVnode , ...]
// ^^^^^^^^^^^^^
//
// In this situation we need to patch `newEndVnode` onto `oldStartVnode`
// and move the DOM element for `oldStartVnode`.
if (BUILD.slotRelocation && (oldStartVnode.$tag$ === 'slot' || newEndVnode.$tag$ === 'slot')) {
putBackInOriginalLocation(oldStartVnode.$elm$.parentNode, false);
}
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)) {
// case: "Vnode moved left"
//
// We've found that the first node in our window on the new children is
// the same VNode as the _last_ node in our window on the old children.
// Visually, this is the layout of these two nodes:
//
// newCh: [..., newStartVnode , ... , newEndVnode , ...]
// ^^^^^^^^^^^^^
// oldCh: [..., oldStartVnode , ... , oldEndVnode , ...]
// ^^^^^^^^^^^
//
// In this situation we need to patch `newStartVnode` onto `oldEndVnode`
// (which will handle updating any changed attributes, reconciling their
// children etc) but we also need to move the DOM node to which
// `oldEndVnode` corresponds.
if (BUILD.slotRelocation && (oldStartVnode.$tag$ === 'slot' || newEndVnode.$tag$ === 'slot')) {
putBackInOriginalLocation(oldEndVnode.$elm$.parentNode, false);
}
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;
if (BUILD.vdomKey) {
for (i = oldStartIdx; i <= oldEndIdx; ++i) {
if (oldCh[i] && oldCh[i].$key$ !== null && oldCh[i].$key$ === newStartVnode.$key$) {
idxInOld = i;
break;
}
}
}
if (BUILD.vdomKey && 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, parentElm);
}
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, parentElm);
newStartVnode = newCh[++newStartIdx];
}
if (node) {
// if we created a new node then handle inserting it to the DOM
if (BUILD.slotRelocation) {
parentReferenceNode(oldStartVnode.$elm$).insertBefore(node, referenceNode(oldStartVnode.$elm$));
}
else {
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 (BUILD.updatable && 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 positive and then have to do needless re-rendering.
*
* @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$) {
if (BUILD.slotRelocation && leftVNode.$tag$ === 'slot') {
return leftVNode.$name$ === rightVNode.$name$;
}
// this will be set if components in the build have `key` attrs set on them
if (BUILD.vdomKey) {
return leftVNode.$key$ === rightVNode.$key$;
}
return true;
}
return false;
};
const referenceNode = (node) => {
// this node was relocated to a new location in the dom
// because of some other component's slot
// but we still have an html comment in place of where
// it's original location was according to it's original vdom
return (node && node['s-ol']) || node;
};
const parentReferenceNode = (node) => (node['s-ol'] ? node['s-ol'] : node).parentNode;
/**
* Handle reconciling an