bitcoin-qr
Version:
A zero-dependency, zero-framework QR code web component for Bitcoin on-chain, Lightning, and unified BIP-21 payments.
4,182 lines • 196 kB
JavaScript
const NAMESPACE = 'bitcoin-qr';
const BUILD = /* bitcoin-qr */ { allRenderFn: true, appendChildSlotFix: false, asyncLoading: true, asyncQueue: false, attachStyles: true, cloneNodeFix: false, cmpDidLoad: true, cmpDidRender: false, cmpDidUnload: false, cmpDidUpdate: false, cmpShouldUpdate: true, cmpWillLoad: true, cmpWillRender: false, cmpWillUpdate: false, connectedCallback: false, constructableCSS: false, cssAnnotations: true, devTools: true, disconnectedCallback: false, element: false, event: false, experimentalScopedSlotChanges: false, experimentalSlotFixes: false, formAssociated: false, hasRenderFn: true, hostListener: false, hostListenerTarget: false, hostListenerTargetBody: false, hostListenerTargetDocument: false, hostListenerTargetParent: false, hostListenerTargetWindow: false, hotModuleReplacement: true, hydrateClientSide: false, hydrateServerSide: false, hydratedAttribute: false, hydratedClass: true, initializeNextTick: false, invisiblePrehydration: true, isDebug: false, isDev: true, isTesting: false, lazyLoad: true, lifecycle: true, lifecycleDOMEvents: false, member: true, method: false, mode: false, observeAttribute: true, profile: true, prop: true, propBoolean: true, propMutable: true, propNumber: true, propString: true, reflect: false, scoped: false, scopedSlotTextContentFix: false, scriptDataOpts: false, shadowDelegatesFocus: false, shadowDom: true, slot: false, slotChildNodesFix: false, slotRelocation: false, state: true, style: false, svg: false, taskQueue: true, transformTagName: false, updatable: true, vdomAttribute: true, vdomClass: false, vdomFunctional: false, vdomKey: false, vdomListener: true, vdomPropOrAttr: true, vdomRef: false, vdomRender: true, vdomStyle: true, vdomText: false, vdomXlink: false, watchCallback: true };
const Env = /* bitcoin-qr */ {};
/**
* 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 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;
const Build = {
isDev: BUILD.isDev ? true : false,
isBrowser: true,
isServer: false,
isTesting: BUILD.isTesting ? true : 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 = '') => {
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, 'mark').length === 0) {
performance.mark(key);
}
return () => {
if (performance.getEntriesByName(measureText, 'measure').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 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}';
/**
* Constant for styles to be globally applied to `slot-fb` elements for pseudo-slot behavior.
*
* Two cascading rules must be used instead of a `:not()` selector due to Stencil browser
* support as of Stencil v4.
*/
const SLOT_FB_CSS = 'slot-fb{display:contents}slot-fb[hidden]{display:none}';
const XLINK_NS = 'http://www.w3.org/1999/xlink';
const FORM_ASSOCIATED_CUSTOM_ELEMENT_CALLBACKS = [
'formAssociatedCallback',
'formResetCallback',
'formDisabledCallback',
'formStateRestoreCallback',
];
/**
* 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;
/**
* 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 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);
}
if (BUILD.vdomKey && vnodeData.key) {
key = vnodeData.key;
}
if (BUILD.slotRelocation && vnodeData.name) {
slotName = vnodeData.name;
}
// normalize class / className attributes
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;
};
/**
* 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,
};
if (BUILD.vdomAttribute) {
vnode.$attrs$ = null;
}
if (BUILD.vdomKey) {
vnode.$key$ = null;
}
if (BUILD.slotRelocation) {
vnode.$name$ = 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;
/**
* Implementation of {@link d.FunctionalUtilities} for Stencil's VDom.
*
* Note that these functions convert from {@link d.VNode} to
* {@link d.ChildNode} to give functional component developers a friendly
* interface.
*/
const vdomFnUtils = {
forEach: (children, cb) => children.map(convertToPublic).forEach(cb),
map: (children, cb) => children.map(convertToPublic).map(cb).map(convertToPrivate),
};
/**
* Convert a {@link d.VNode} to a {@link d.ChildNode} in order to present a
* friendlier public interface (hence, 'convertToPublic').
*
* @param node the virtual DOM node to convert
* @returns a converted child node
*/
const convertToPublic = (node) => ({
vattrs: node.$attrs$,
vchildren: node.$children$,
vkey: node.$key$,
vname: node.$name$,
vtag: node.$tag$,
vtext: node.$text$,
});
/**
* Convert a {@link d.ChildNode} back to an equivalent {@link d.VNode} in
* order to use the resulting object in the virtual DOM. The initial object was
* likely created as part of presenting a public API, so converting it back
* involved making it 'private' again (hence, `convertToPrivate`).
*
* @param node the child node to convert
* @returns a converted virtual DOM node
*/
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"`);
}
};
/**
* Entrypoint of the client-side hydration process. Facilitates calls to hydrate the
* document and all its nodes.
*
* This process will also reconstruct the shadow root and slot DOM nodes for components using shadow DOM.
*
* @param hostElm The element to hydrate.
* @param tagName The element's tag name.
* @param hostId The host ID assigned to the element by the server.
* @param hostRef The host reference for the element.
*/
const initializeClientHydrate = (hostElm, tagName, hostId, hostRef) => {
const endHydrate = createTime('hydrateClient', tagName);
const shadowRoot = hostElm.shadowRoot;
const childRenderNodes = [];
const slotNodes = [];
const shadowRootNodes = BUILD.shadowDom && shadowRoot ? [] : null;
const vnode = (hostRef.$vnode$ = newVNode(tagName, null));
if (!plt.$orgLocNodes$) {
initializeDocumentHydrate(doc.body, (plt.$orgLocNodes$ = new Map()));
}
hostElm[HYDRATE_ID] = hostId;
hostElm.removeAttribute(HYDRATE_ID);
clientHydrate(vnode, childRenderNodes, slotNodes, shadowRootNodes, hostElm, hostElm, hostId);
childRenderNodes.map((c) => {
const orgLocationId = c.$hostId$ + '.' + c.$nodeId$;
const orgLocationNode = plt.$orgLocNodes$.get(orgLocationId);
const node = c.$elm$;
// Put the node back in its original location since the native Shadow DOM
// can handle rendering it its correct location now
if (orgLocationNode && supportsShadow && orgLocationNode['s-en'] === '') {
orgLocationNode.parentNode.insertBefore(node, orgLocationNode.nextSibling);
}
if (!shadowRoot) {
node['s-hn'] = tagName;
if (orgLocationNode) {
node['s-ol'] = orgLocationNode;
node['s-ol']['s-nr'] = node;
}
}
plt.$orgLocNodes$.delete(orgLocationId);
});
if (BUILD.shadowDom && shadowRoot) {
shadowRootNodes.map((shadowRootNode) => {
if (shadowRootNode) {
shadowRoot.appendChild(shadowRootNode);
}
});
}
endHydrate();
};
/**
* Recursively constructs the virtual node tree for a host element and its children.
* The tree is constructed by parsing the annotations set on the nodes by the server.
*
* In addition to constructing the vNode tree, we also track information about the node's
* descendants like which are slots, which should exist in the shadow root, and which
* are nodes that should be rendered as children of the parent node.
*
* @param parentVNode The vNode representing the parent node.
* @param childRenderNodes An array of all child nodes in the parent's node tree.
* @param slotNodes An array of all slot nodes in the parent's node tree.
* @param shadowRootNodes An array all nodes that should be rendered in the shadow root in the parent's node tree.
* @param hostElm The parent element.
* @param node The node to construct the vNode tree for.
* @param hostId The host ID assigned to the element by the server.
*/
const clientHydrate = (parentVNode, childRenderNodes, slotNodes, shadowRootNodes, hostElm, node, hostId) => {
let childNodeType;
let childIdSplt;
let childVNode;
let i;
if (node.nodeType === 1 /* NODE_TYPE.ElementNode */) {
childNodeType = node.getAttribute(HYDRATE_CHILD_ID);
if (childNodeType) {
// got the node data from the element's attribute
// `${hostId}.${nodeId}.${depth}.${index}`
childIdSplt = childNodeType.split('.');
if (childIdSplt[0] === hostId || childIdSplt[0] === '0') {
childVNode = {
$flags$: 0,
$hostId$: childIdSplt[0],
$nodeId$: childIdSplt[1],
$depth$: childIdSplt[2],
$index$: childIdSplt[3],
$tag$: node.tagName.toLowerCase(),
$elm$: node,
$attrs$: null,
$children$: null,
$key$: null,
$name$: null,
$text$: null,
};
childRenderNodes.push(childVNode);
node.removeAttribute(HYDRATE_CHILD_ID);
// this is a new child vnode
// so ensure its parent vnode has the vchildren array
if (!parentVNode.$children$) {
parentVNode.$children$ = [];
}
// add our child vnode to a specific index of the vnode's children
parentVNode.$children$[childVNode.$index$] = childVNode;
// this is now the new parent vnode for all the next child checks
parentVNode = childVNode;
if (shadowRootNodes && childVNode.$depth$ === '0') {
shadowRootNodes[childVNode.$index$] = childVNode.$elm$;
}
}
}
// recursively drill down, end to start so we can remove nodes
for (i = node.childNodes.length - 1; i >= 0; i--) {
clientHydrate(parentVNode, childRenderNodes, slotNodes, shadowRootNodes, hostElm, node.childNodes[i], hostId);
}
if (node.shadowRoot) {
// keep drilling down through the shadow root nodes
for (i = node.shadowRoot.childNodes.length - 1; i >= 0; i--) {
clientHydrate(parentVNode, childRenderNodes, slotNodes, shadowRootNodes, hostElm, node.shadowRoot.childNodes[i], hostId);
}
}
}
else if (node.nodeType === 8 /* NODE_TYPE.CommentNode */) {
// `${COMMENT_TYPE}.${hostId}.${nodeId}.${depth}.${index}`
childIdSplt = node.nodeValue.split('.');
if (childIdSplt[1] === hostId || childIdSplt[1] === '0') {
// comment node for either the host id or a 0 host id
childNodeType = childIdSplt[0];
childVNode = {
$flags$: 0,
$hostId$: childIdSplt[1],
$nodeId$: childIdSplt[2],
$depth$: childIdSplt[3],
$index$: childIdSplt[4],
$elm$: node,
$attrs$: null,
$children$: null,
$key$: null,
$name$: null,
$tag$: null,
$text$: null,
};
if (childNodeType === TEXT_NODE_ID) {
childVNode.$elm$ = node.nextSibling;
if (childVNode.$elm$ && childVNode.$elm$.nodeType === 3 /* NODE_TYPE.TextNode */) {
childVNode.$text$ = childVNode.$elm$.textContent;
childRenderNodes.push(childVNode);
// remove the text comment since it's no longer needed
node.remove();
if (!parentVNode.$children$) {
parentVNode.$children$ = [];
}
parentVNode.$children$[childVNode.$index$] = childVNode;
if (shadowRootNodes && childVNode.$depth$ === '0') {
shadowRootNodes[childVNode.$index$] = childVNode.$elm$;
}
}
}
else if (childVNode.$hostId$ === hostId) {
// this comment node is specifically for this host id
if (childNodeType === SLOT_NODE_ID) {
// `${SLOT_NODE_ID}.${hostId}.${nodeId}.${depth}.${index}.${slotName}`;
childVNode.$tag$ = 'slot';
if (childIdSplt[5]) {
node['s-sn'] = childVNode.$name$ = childIdSplt[5];
}
else {
node['s-sn'] = '';
}
node['s-sr'] = true;
if (BUILD.shadowDom && shadowRootNodes) {
// browser support shadowRoot and this is a shadow dom component
// create an actual slot element
childVNode.$elm$ = doc.createElement(childVNode.$tag$);
if (childVNode.$name$) {
// add the slot name attribute
childVNode.$elm$.setAttribute('name', childVNode.$name$);
}
// insert the new slot element before the slot comment
node.parentNode.insertBefore(childVNode.$elm$, node);
// remove the slot comment since it's not needed for shadow
node.remove();
if (childVNode.$depth$ === '0') {
shadowRootNodes[childVNode.$index$] = childVNode.$elm$;
}
}
slotNodes.push(childVNode);
if (!parentVNode.$children$) {
parentVNode.$children$ = [];
}
parentVNode.$children$[childVNode.$index$] = childVNode;
}
else if (childNodeType === CONTENT_REF_ID) {
// `${CONTENT_REF_ID}.${hostId}`;
if (BUILD.shadowDom && shadowRootNodes) {
// remove the content ref comment since it's not needed for shadow
node.remove();
}
else if (BUILD.slotRelocation) {
hostElm['s-cr'] = node;
node['s-cn'] = true;
}
}
}
}
}
else if (parentVNode && parentVNode.$tag$ === 'style') {
const vnode = newVNode(null, node.textContent);
vnode.$elm$ = node;
vnode.$index$ = '0';
parentVNode.$children$ = [vnode];
}
};
/**
* Recursively locate any comments representing an original location for a node in a node's
* children or shadowRoot children.
*
* @param node The node to search.
* @param orgLocNodes A map of the original location annotation and the current node being searched.
*/
const initializeDocumentHydrate = (node, orgLocNodes) => {
if (node.nodeType === 1 /* NODE_TYPE.ElementNode */) {
let i = 0;
for (; i < node.childNodes.length; i++) {
initializeDocumentHydrate(node.childNodes[i], orgLocNodes);
}
if (node.shadowRoot) {
for (i = 0; i < node.shadowRoot.childNodes.length; i++) {
initializeDocumentHydrate(node.shadowRoot.childNodes[i], orgLocNodes);
}
}
}
else if (node.nodeType === 8 /* NODE_TYPE.CommentNode */) {
const childIdSplt = node.nodeValue.split('.');
if (childIdSplt[0] === ORG_LOCATION_ID) {
orgLocNodes.set(childIdSplt[1] + '.' + childIdSplt[2], node);
node.nodeValue = '';
// useful to know if the original location is
// the root light-dom of a shadow dom component
node['s-en'] = childIdSplt[3];
}
}
};
// 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$;
/**
* 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 (BUILD.propBoolean && 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 (BUILD.propNumber && propType & 2 /* MEMBER_FLAGS.Number */) {
// force it to be a number
return parseFloat(propValue);
}
if (BUILD.propString && 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) => (BUILD.lazyLoad ? getHostRef(ref).$hostElement$ : ref);
const createEvent = (ref, name, flags) => {
const elm = getElement(ref);
return {
emit: (detail) => {
if (BUILD.isDev && !elm.isConnected) {
consoleDevWarn(`The "${name}" event was emitted, but the dispatcher node is no longer connected to the dom.`);
}
return emitEvent(elm, name, {
bubbles: !!(flags & 4 /* EVENT_FLAGS.Bubbles */),
composed: !!(flags & 2 /* EVENT_FLAGS.Composed */),
cancelable: !!(flags & 1 /* EVENT_FLAGS.Cancellable */),
detail,
});
},
};
};
/**
* 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, 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 {
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);
}
if (BUILD.hydrateServerSide || BUILD.hotModuleReplacement) {
styleElm.setAttribute(HYDRATED_STYLE_ID, scopeId);
}
styleContainerNode.insertBefore(styleElm, styleContainerNode.querySelector('link'));
}
// Add styles for `slot-fb` elements if we're using slots outside the Shadow DOM
if (cmpMeta.$flags$ & 4 /* CMP_FLAGS.hasSlotRelocation */) {
styleElm.innerHTML += SLOT_FB_CSS;
}
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$);
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{');
/**
* 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 (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 || newValue) {
// Need to account for "capture" events.
// If the event name ends with "Capture", we'll update the name to remove
// the "Capture" suffix and make sure the event listener is setup to handle the capture event.
const capture = memberName.endsWith(CAPTURE_EVENT_SUFFIX);
// Make sure we only replace the last instance of "Capture"
memberName = memberName.replace(CAPTURE_EVENT_REGEX, '');
if (oldValue) {
plt.rel(elm, memberName, oldValue, capture);
}
if (newValue) {
plt.ael(elm, memberName, newValue, capture);
}
}
}
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) {
/**
* in case someone tries to set a read-only property, e.g. "namespaceURI", we just ignore it
*/
}
}
/**
* 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/;
/**
* Parsed a string of classnames into an array
* @param value className string, e.g. "foo bar baz"
* @returns list of classes, e.g. ["foo", "bar", "baz"]
*/
const parseClassList = (value) => (!value ? [] : value.split(parseClassListRegex));
const CAPTURE_EVENT_SUFFIX = 'Capture';
const CAPTURE_EVENT_REGEX = new RegExp(CAPTURE_EVENT_SUFFIX + '$');
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 of sortedAttrNames(Object.keys(oldVnodeAttrs))) {
if (!(memberName in newVnodeAttrs)) {
setAccessor(elm, memberName, oldVnodeAttrs[memberName], undefined, isSvgMode, newVnode.$flags$);
}
}
}
// add new & update changed attributes
for (memberName of sortedAttrNames(Object.keys(newVnodeAttrs))) {
setAccessor(elm, memberName, oldVnodeAttrs[memberName], newVnodeAttrs[memberName], isSvgMode, newVnode.$flags$);
}
};
/**
* Sort a list of attribute names to ensure that all the attribute names which
* are _not_ `"ref"` come before `"ref"`. Preserve the order of the non-ref
* attributes.
*
* **Note**: if the supplied attributes do not include `'ref'` then the same
* (by reference) array will be returned without modification.
*
* @param attrNames attribute names to sort
* @returns a list of attribute names, sorted if they include `"ref"`
*/
function sortedAttrNames(attrNames) {
return attrNames.includes('ref')
? // we need to sort these to ensure that `'ref'` is the last attr
[...attrNames.filter((attr) => attr !== 'ref'), 'ref']
: // no need to sort, return the original array
attrNames;
}
/**
* 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) => {
var _a;
// 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;
}
}
}
// This needs to always happen so we can hide nodes that are projected
// to another component but don't end up in a slot
elm['s-hn'] = hostTagName;
if (BUILD.slotRelocation) {
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$ || '';
// remember the ref callback function
elm['s-rf'] = (_a = newVNode.$attrs$) === null || _a === void 0 ? void 0 : _a.ref;
// 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$) {
if (BUILD.experimentalSlotFixes) {
// we've got an old slot vnode and the wrapper is being replaced
// so let's move the old slot content to the root of the element currently being rendered
relocateToHostRoot(oldParentVNode.$elm$);
}
else {
// we've got an old slot vnode and the wrapper is being replaced
// so let's move the old slot content back to its original location
putBackInOriginalLocation(oldParentVNode.$elm$, false);
}
}
}
}
return elm;
};
/**
* Relocates all child nodes of an element that were a part of a previous slot relocation
* to the root of the Stencil component currently being rendered. This happens when a parent
* element of a slot reference node dynamically changes and triggers a re-render. We cannot use
* `putBackInOriginalLocation()` because that may relocate nodes to elements that will not be re-rendered
* and so they will not be relocated again.
*
* @param parentElm The element potentially containing relocated nodes.
*/
const relocateToHostRoot = (parentElm) => {
plt.$flags$ |= 1 /* PLATFORM_FLAGS.isTmpDisconnected */;
const host = parentElm.closest(hostTagName.toLowerCase());
if (host != null) {
const contentRefNode = Array.from(host.childNodes).find((ref) => ref['s-cr']);
const childNodeArray = Array.from(parentElm.childNodes);
// If we have a content ref, we need to invert the order of the nodes we're relocating
// to preserve the correct order of elements in the DOM on future relocations
for (const childNode of contentRefNode ? childNodeArray.reverse() : childNodeArray) {
// Only relocate nodes that were slotted in
if (childNode['s-sh'] != null) {
host.insertBefore(childNode, contentRefNode !== null && contentRefNode !== void 0 ? contentRefNode : null);
// Reset so we can correctly move the node around again.
childNode['s-sh'] = undefined;
// Need to tell the render pipeline to check to relocate slot content again
checkSlotRelocate = true;
}
}
}
plt.$flags$ &= ~1 /* PLATFORM_FLAGS.isTmpDisconnected */;
};
const putBackInOriginalLocation = (parentElm, recursive) => {
plt.$flags$ |= 1 /* PLATFORM_FLAGS.isTmpDisconnected */;
const oldSlotChildNodes = Array.from(parentElm.childNodes);
if (parentElm['s-sr'] && BUILD.experimentalSlotFixes) {
let node = parentElm;
while ((node = node.nextSibling)) {
if (node && node['s-sn'] === parentElm['s-sn'] && node['s-sh'] === hostTagName) {
oldSlotChildNodes.push(node);
}
}
}
for (let i = oldSlotChildNodes.length - 1; i >= 0; i--) {
const childNode = oldSlotChildNodes[i];
if (childNode['s-hn'] !== hostTagName && childNode['s-ol']) {
// 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 if need be
childNode['s-ol'].remove();
childNode['s-ol'] = undefined;
// Reset so we can correctly move the node around again.
childNode['s-sh'] = undefined;
checkSlotRelocate = true;
}
if (recursive) {
putBackInOriginalLocation(childNode, recursive);
}
}
plt.$flags$ &= ~1 /* PLATFORM_FLAGS.isTmpDisconnected */;
};
/**
* 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 = ((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);
}
}
}
};
/**
* 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) {
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
* @param isInitialRender whether or not this is the first render of the vdom
*/
const updateChildren = (parentElm, oldCh, newVNode, newCh, isInitialRender = false) => {
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, isInitialRender)) {
// 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, isInitialRender);
oldStartVnode = oldCh[++oldStartIdx];
newStartVnode = newCh[++newStartIdx];
}
else if (isSameVnode(oldEndVnode, newEndVnode, isInitialRender)) {
// 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, isInitialRender);
oldEndVnode = oldCh[--oldEndIdx];
newEndVnode = newCh[--newEndIdx];
}
else if (isSameVnode(oldStartVnode, newEndVnode, isInitialRender)) {
// 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, isInitialRender);
// 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, isInitialRender)) {
// 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, isInitialRender);
// 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, isInitialRender);
// 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 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
* @param isInitialRender whether or not this is the first render of the vdom
* @returns whether they're equal or not
*/
const isSameVnode = (leftVNode, rightVNode, isInitialRender = false) => {
// 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 JSX tags in the build have `key` attrs set on them
// we only want to check this if we're not on the first render since on
// first render `leftVNode.$key$` will always be `null`, so we can be led
// astray and, for instance, accidentally delete a DOM node that we want to
// keep around.
if (BUILD.vdomKey && !isInitialRender) {
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 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
* @param isInitialRender whether or not this is the first render of the vdom
*/
const patch = (oldVNode, newVNode, isInitialRender = false) => {
const elm = (newVNode.$elm$ = oldVNode.$elm$);
const oldChildren = oldVNode.$children$;
const newChildren = newVNode.$children$;
const tag = newVNode.$tag$;
const text = newVNode.$text$;
let defaultHolder;
if (!BUILD.vdomText || text === null) {
if (BUILD.svg) {
// test if we're rendering an svg element, or still rendering nodes inside of one
// only add this to the when the compiler sees we're using an svg somewhere
isSvgMode = tag === 'svg' ? true : tag === 'foreignObject' ? false : isSvgMode;
}
if (BUILD.vdomAttribute || BUILD.reflect) {
if (BUILD.slot && tag === 'slot' && !useNativeShadowDom) {
if (BUILD.experimentalSlotFixes && oldVNode.$name$ !== newVNode.$name$) {
newVNode.$elm$['s-sn'] = newVNode.$name$ || '';
relocateToHostRoot(newVNode.$elm$.parentElement);
}
}
else {
// 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 (BUILD.updatable && 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, isInitialRender);
}
else if (newChildren !== null) {
// no old child vnodes, but there are new child vnodes to add
if (BUILD.updatable && BUILD.vdomText && 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 (BUILD.updatable && oldChildren !== null) {
// no new child vnodes, but there are old child vnodes to remove
removeVnodes(oldChildren, 0, oldChildren.length - 1);
}
if (BUILD.svg && isSvgMode && tag === 'svg') {
isSvgMode = false;
}
}
else if (BUILD.vdomText && BUILD.slotRelocation && (defaultHolder = elm['s-cr'])) {
// this element has slotted content
defaultHolder.parentNode.textContent = text;
}
else if (BUILD.vdomText && 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;
}
};
/**
* Adjust the `.hidden` property as-needed on any nodes in a DOM subtree which
* are slot fallbacks nodes.
*
* A slot fallback node should be visible by default. Then, it should be
* conditionally hidden if:
*
* - it has a sibling with a `slot` property set to its slot name or if
* - it is a default fallback slot node, in which case we hide if it has any
* content
*
* @param elm the element of interest
*/
const updateFallbackSlotVisibility = (elm) => {
const childNodes = elm.childNodes;
for (const childNode of childNodes) {
if (childNode.nodeType === 1 /* NODE_TYPE.ElementNode */) {
if (childNode['s-sr']) {
// this is a slot fallback node
// get the slot name for this slot reference node
const slotName = childNode['s-sn'];
// by default always show a fallback slot node
// then hide it if there are other slots in the light dom
childNode.hidden = false;
// we need to check all of its sibling nodes in order to see if
// `childNode` should be hidden
for (const siblingNode of childNodes) {
// Don't check the node against itself
if (siblingNode !== childNode) {
if (siblingNode['s-hn'] !== childNode['s-hn'] || slotName !== '') {
// this sibling node is from a different component OR is a named
// fallback slot node
if (siblingNode.nodeType === 1 /* NODE_TYPE.ElementNode */ &&
(slotName === siblingNode.getAttribute('slot') || slotName === siblingNode['s-sn'])) {
childNode.hidden = true;
break;
}
}
else {
// this is a default fallback slot node
// any element or text node (with content)
// should hide the default fallback slot node
if (siblingNode.nodeType === 1 /* NODE_TYPE.ElementNode */ ||
(siblingNode.nodeType === 3 /* NODE_TYPE.TextNode */ && siblingNode.textContent.trim() !== '')) {
childNode.hidden = true;
break;
}
}
}
}
}
// keep drilling down
updateFallbackSlotVisibility(childNode);
}
}
};
/**
* Component-global information about nodes which are either currently being
* relocated or will be shortly.
*/
const relocateNodes = [];
/**
* Mark the contents of a slot for relocation via adding references to them to
* the {@link relocateNodes} data structure. The actual work of relocating them
* will then be handled in {@link renderVdom}.
*
* @param elm a render node whose child nodes need to be relocated
*/
const markSlotContentForRelocation = (elm) => {
// tslint:disable-next-line: prefer-const
let node;
let hostContentNodes;
let j;
for (const childNode of elm.childNodes) {
// we need to find child nodes which are slot references so we can then try
// to match them up with nodes that need to be relocated
if (childNode['s-sr'] && (node = childNode['s-cr']) && node.parentNode) {
// first get the content reference comment node ('s-cr'), then we get
// its parent, which is where all the host content is now
hostContentNodes = node.parentNode.childNodes;
const slotName = childNode['s-sn'];
// iterate through all the nodes under the location where the host was
// originally rendered
for (j = hostContentNodes.length - 1; j >= 0; j--) {
node = hostContentNodes[j];
// check that the node is not a content reference node or a node
// reference and then check that the host name does not match that of
// childNode.
// In addition, check that the slot either has not already been relocated, or
// that its current location's host is not childNode's host. This is essentially
// a check so that we don't try to relocate (and then hide) a node that is already
// where it should be.
if (!node['s-cn'] &&
!node['s-nr'] &&
node['s-hn'] !== childNode['s-hn'] &&
(!BUILD.experimentalSlotFixes || !node['s-sh'] || node['s-sh'] !== childNode['s-hn'])) {
// if `node` is located in the slot that `childNode` refers to (via the
// `'s-sn'` property) then we need to relocate it from it's current spot
// (under the host element parent) to the right slot location
if (isNodeLocatedInSlot(node, slotName)) {
// it's possible we've already decided to relocate this node
let relocateNodeData = relocateNodes.find((r) => r.$nodeToRelocate$ === node);
// made some changes to slots
// let's make sure we also double check
// fallbacks are correctly hidden or shown
checkSlotFallbackVisibility = true;
// ensure that the slot-name attr is correct
node['s-sn'] = node['s-sn'] || slotName;
if (relocateNodeData) {
relocateNodeData.$nodeToRelocate$['s-sh'] = childNode['s-hn'];
// we marked this node for relocation previously but didn't find
// out the slot reference node to which it needs to be relocated
// so write it down now!
relocateNodeData.$slotRefNode$ = childNode;
}
else {
node['s-sh'] = childNode['s-hn'];
// add to our list of nodes to relocate
relocateNodes.push({
$slotRefNode$: childNode,
$nodeToRelocate$: node,
});
}
if (node['s-sr']) {
relocateNodes.map((relocateNode) => {
if (isNodeLocatedInSlot(relocateNode.$nodeToRelocate$, node['s-sn'])) {
relocateNodeData = relocateNodes.find((r) => r.$nodeToRelocate$ === node);
if (relocateNodeData && !relocateNode.$slotRefNode$) {
relocateNode.$slotRefNode$ = relocateNodeData.$slotRefNode$;
}
}
});
}
}
else if (!relocateNodes.some((r) => r.$nodeToRelocate$ === node)) {
// the node is not found within the slot (`childNode`) that we're
// currently looking at, so we stick it into `relocateNodes` to
// handle later. If we never find a home for this element then
// we'll need to hide it
relocateNodes.push({
$nodeToRelocate$: node,
});
}
}
}
}
// if we're dealing with any type of element (capable of itself being a
// slot reference or containing one) then we recur
if (childNode.nodeType === 1 /* NODE_TYPE.ElementNode */) {
markSlotContentForRelocation(childNode);
}
}
};
/**
* Check whether a node is located in a given named slot.
*
* @param nodeToRelocate the node of interest
* @param slotName the slot name to check
* @returns whether the node is located in the slot or not
*/
const isNodeLocatedInSlot = (nodeToRelocate, slotName) => {
if (nodeToRelocate.nodeType === 1 /* NODE_TYPE.ElementNode */) {
if (nodeToRelocate.getAttribute('slot') === null && slotName === '') {
// if the node doesn't have a slot attribute, and the slot we're checking
// is not a named slot, then we assume the node should be within the slot
return true;
}
if (nodeToRelocate.getAttribute('slot') === slotName) {
return true;
}
return false;
}
if (nodeToRelocate['s-sn'] === slotName) {
return true;
}
return slotName === '';
};
/**
* '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) => {
if (BUILD.vdomRef) {
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) => {
var _a, _b, _c, _d, _e;
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;
// <Host> runtime check
if (BUILD.isDev && Array.isArray(renderFnResults) && renderFnResults.some(isHost)) {
throw new Error(`The <Host> must be the single root component.
Looks like the render() function of "${hostTagName.toLowerCase()}" is returning an array that contains the <Host>.
The render() function should look like this instead:
render() {
// Do not return an array
return (
<Host>{content}</Host>
);
}
`);
}
if (BUILD.reflect && 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$ = (BUILD.shadowDom ? hostElm.shadowRoot || hostElm : hostElm);
if (BUILD.scoped || BUILD.shadowDom) {
scopeId = hostElm['s-sc'];
}
useNativeShadowDom = supportsShadow && (cmpMeta.$flags$ & 1 /* CMP_FLAGS.shadowDomEncapsulation */) !== 0;
if (BUILD.slotRelocation) {
contentRef = hostElm['s-cr'];
// always reset
checkSlotFallbackVisibility = false;
}
// synchronous patch
patch(oldVNode, rootVnode, isInitialLoad);
if (BUILD.slotRelocation) {
// while we're moving nodes around existing nodes, temporarily disable
// the disconnectCallback from working
plt.$flags$ |= 1 /* PLATFORM_FLAGS.isTmpDisconnected */;
if (checkSlotRelocate) {
markSlotContentForRelocation(rootVnode.$elm$);
for (const relocateData of relocateNodes) {
const nodeToRelocate = relocateData.$nodeToRelocate$;
if (!nodeToRelocate['s-ol']) {
// add a reference node marking this node's original location
// keep a reference to this node for later lookups
const orgLocationNode = BUILD.isDebug || BUILD.hydrateServerSide
? originalLocationDebugNode(nodeToRelocate)
: doc.createTextNode('');
orgLocationNode['s-nr'] = nodeToRelocate;
nodeToRelocate.parentNode.insertBefore((nodeToRelocate['s-ol'] = orgLocationNode), nodeToRelocate);
}
}
for (const relocateData of relocateNodes) {
const nodeToRelocate = relocateData.$nodeToRelocate$;
const slotRefNode = relocateData.$slotRefNode$;
if (slotRefNode) {
const parentNodeRef = slotRefNode.parentNode;
// When determining where to insert content, the most simple case would be
// to relocate the node immediately following the slot reference node. We do this
// by getting a reference to the node immediately following the slot reference node
// since we will use `insertBefore` to manipulate the DOM.
//
// If there is no node immediately following the slot reference node, then we will just
// end up appending the node as the last child of the parent.
let insertBeforeNode = slotRefNode.nextSibling;
// If the node we're currently planning on inserting the new node before is an element,
// we need to do some additional checks to make sure we're inserting the node in the correct order.
// The use case here would be that we have multiple nodes being relocated to the same slot. So, we want
// to make sure they get inserted into their new home in the same order they were declared in their original location.
//
// TODO(STENCIL-914): Remove `experimentalSlotFixes` check
if (!BUILD.experimentalSlotFixes ||
(insertBeforeNode && insertBeforeNode.nodeType === 1 /* NODE_TYPE.ElementNode */)) {
let orgLocationNode = (_a = nodeToRelocate['s-ol']) === null || _a === void 0 ? void 0 : _a.previousSibling;
while (orgLocationNode) {
let refNode = (_b = orgLocationNode['s-nr']) !== null && _b !== void 0 ? _b : null;
if (refNode && refNode['s-sn'] === nodeToRelocate['s-sn'] && parentNodeRef === refNode.parentNode) {
refNode = refNode.nextSibling;
// If the refNode is the same node to be relocated or another element's slot reference, keep searching to find the
// correct relocation target
while (refNode === nodeToRelocate || (refNode === null || refNode === void 0 ? void 0 : refNode['s-sr'])) {
refNode = refNode === null || refNode === void 0 ? void 0 : refNode.nextSibling;
}
if (!refNode || !refNode['s-nr']) {
insertBeforeNode = refNode;
break;
}
}
orgLocationNode = orgLocationNode.previousSibling;
}
}
if ((!insertBeforeNode && parentNodeRef !== nodeToRelocate.parentNode) ||
nodeToRelocate.nextSibling !== insertBeforeNode) {
// we've checked that it's worth while to relocate
// since that the node to relocate
// has a different next sibling or parent relocated
if (nodeToRelocate !== insertBeforeNode) {
if (!BUILD.experimentalSlotFixes && !nodeToRelocate['s-hn'] && nodeToRelocate['s-ol']) {
// probably a component in the index.html that doesn't have its hostname set
nodeToRelocate['s-hn'] = nodeToRelocate['s-ol'].parentNode.nodeName;
}
// Add it back to the dom but in its new home
// If we get to this point and `insertBeforeNode` is `null`, that means
// we're just going to append the node as the last child of the parent. Passing
// `null` as the second arg here will trigger that behavior.
parentNodeRef.insertBefore(nodeToRelocate, insertBeforeNode);
// Reset the `hidden` value back to what it was defined as originally
// This solves a problem where a `slot` is dynamically rendered and `hidden` may have
// been set on content originally, but now it has a slot to go to so it should have
// the value it was defined as having in the DOM, not what we overrode it to.
if (nodeToRelocate.nodeType === 1 /* NODE_TYPE.ElementNode */) {
nodeToRelocate.hidden = (_c = nodeToRelocate['s-ih']) !== null && _c !== void 0 ? _c : false;
}
}
}
nodeToRelocate && typeof slotRefNode['s-rf'] === 'function' && slotRefNode['s-rf'](nodeToRelocate);
}
else {
// this node doesn't have a slot home to go to, so let's hide it
if (nodeToRelocate.nodeType === 1 /* NODE_TYPE.ElementNode */) {
// Store the initial value of `hidden` so we can reset it later when
// moving nodes around.
if (isInitialLoad) {
nodeToRelocate['s-ih'] = (_d = nodeToRelocate.hidden) !== null && _d !== void 0 ? _d : false;
}
nodeToRelocate.hidden = true;
}
}
}
}
if (checkSlotFallbackVisibility) {
updateFallbackSlotVisibility(rootVnode.$elm$);
}
// done moving nodes around
// allow the disconnect callback to work again
plt.$flags$ &= ~1 /* PLATFORM_FLAGS.isTmpDisconnected */;
// always reset
relocateNodes.length = 0;
}
// Hide any elements that were projected through, but don't have a slot to go to.
// Only an issue if there were no "slots" rendered. Otherwise, nodes are hidden correctly.
// This _only_ happens for `scoped` components!
if (BUILD.experimentalScopedSlotChanges && cmpMeta.$flags$ & 2 /* CMP_FLAGS.scopedCssEncapsulation */) {
for (const childNode of rootVnode.$elm$.childNodes) {
if (childNode['s-hn'] !== hostTagName && !childNode['s-sh']) {
// Store the initial value of `hidden` so we can reset it later when
// moving nodes around.
if (isInitialLoad && childNode['s-ih'] == null) {
childNode['s-ih'] = (_e = childNode.hidden) !== null && _e !== void 0 ? _e : false;
}
childNode.hidden = true;
}
}
}
// Clear the content ref so we don't create a memory leak
contentRef = undefined;
};
// slot comment debug nodes only created with the `--debug` flag
// otherwise these nodes are text nodes w/out content
const slotReferenceDebugNode = (slotVNode) => doc.createComment(`<slot${slotVNode.$name$ ? ' name="' + slotVNode.$name$ + '"' : ''}> (host=${hostTagName.toLowerCase()})`);
const originalLocationDebugNode = (nodeToRelocate) => doc.createComment(`org-location for ` +
(nodeToRelocate.localName
? `<${nodeToRelocate.localName}> (host=${nodeToRelocate['s-hn']})`
: `[${nodeToRelocate.textContent}]`));
const attachToAncestor = (hostRef, ancestorComponent) => {
if (BUILD.asyncLoading && ancestorComponent && !hostRef.$onRenderResolve$ && ancestorComponent['s-p']) {
ancestorComponent['s-p'].push(new Promise((r) => (hostRef.$onRenderResolve$ = r)));
}
};
const scheduleUpdate = (hostRef, isInitialLoad) => {
if (BUILD.taskQueue && BUILD.updatable) {
hostRef.$flags$ |= 16 /* HOST_FLAGS.isQueuedForUpdate */;
}
if (BUILD.asyncLoading && 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 BUILD.taskQueue ? writeTask(dispatch) : 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 elm = hostRef.$hostElement$;
const endSchedule = createTime('scheduleUpdate', hostRef.$cmpMeta$.$tagName$);
const instance = BUILD.lazyLoad ? hostRef.$lazyInstance$ : elm;
// 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 (BUILD.lazyLoad && BUILD.hostListener) {
hostRef.$flags$ |= 256 /* HOST_FLAGS.isListenReady */;
if (hostRef.$queuedListeners$) {
hostRef.$queuedListeners$.map(([methodName, event]) => safeCall(instance, methodName, event));
hostRef.$queuedListeners$ = undefined;
}
}
emitLifecycleEvent(elm, 'componentWillLoad');
if (BUILD.cmpWillLoad) {
// 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');
}
}
else {
emitLifecycleEvent(elm, 'componentWillUpdate');
if (BUILD.cmpWillUpdate) {
// Like `componentWillLoad` above, we allow Stencil component
// authors to return a `Promise` from this lifecycle callback, and
// we specify that our runtime will wait for that `Promise` to
// resolve before the component re-renders. So if the method
// returns a `Promise` we need to keep it around!
maybePromise = safeCall(instance, 'componentWillUpdate');
}
}
emitLifecycleEvent(elm, 'componentWillRender');
if (BUILD.cmpWillRender) {
maybePromise = enqueue(maybePromise, () => safeCall(instance, 'componentWillRender'));
}
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 (BUILD.style && isInitialLoad) {
// DOM WRITE!
attachStyles(hostRef);
}
const endRender = createTime('render', hostRef.$cmpMeta$.$tagName$);
if (BUILD.isDev) {
hostRef.$flags$ |= 1024 /* HOST_FLAGS.devOnRender */;
}
if (BUILD.hydrateServerSide) {
await callRender(hostRef, instance, elm, isInitialLoad);
}
else {
callRender(hostRef, instance, elm, isInitialLoad);
}
if (BUILD.isDev) {
hostRef.$renderCount$ = hostRef.$renderCount$ === undefined ? 1 : hostRef.$renderCount$ + 1;
hostRef.$flags$ &= ~1024 /* HOST_FLAGS.devOnRender */;
}
if (BUILD.hydrateServerSide) {
try {
// manually connected child components during server-side hydrate
serverSideConnected(elm);
if (isInitialLoad) {
// using only during server-side hydrate
if (hostRef.$cmpMeta$.$flags$ & 1 /* CMP_FLAGS.shadowDomEncapsulation */) {
elm['s-en'] = '';
}
else if (hostRef.$cmpMeta$.$flags$ & 2 /* CMP_FLAGS.scopedCssEncapsulation */) {
elm['s-en'] = 'c';
}
}
}
catch (e) {
consoleError(e, elm);
}
}
if (BUILD.asyncLoading && 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();
if (BUILD.asyncLoading) {
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;
}
}
else {
postUpdateComponent(hostRef);
}
};
/**
* 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) => {
// in order for bundlers to correctly tree-shake the BUILD object
// we need to ensure BUILD is not deoptimized within a try/catch
// https://rollupjs.org/guide/en/#treeshake tryCatchDeoptimization
const allRenderFn = BUILD.allRenderFn ? true : false;
const lazyLoad = BUILD.lazyLoad ? true : false;
const taskQueue = BUILD.taskQueue ? true : false;
const updatable = BUILD.updatable ? true : false;
try {
renderingRef = instance;
/**
* minification optimization: `allRenderFn` is `true` if all components have a `render`
* method, so we can call the method immediately. If not, check before calling it.
*/
instance = allRenderFn ? instance.render() : instance.render && instance.render();
if (updatable && taskQueue) {
hostRef.$flags$ &= ~16 /* HOST_FLAGS.isQueuedForUpdate */;
}
if (updatable || lazyLoad) {
hostRef.$flags$ |= 2 /* HOST_FLAGS.hasRendered */;
}
if (BUILD.hasRenderFn || BUILD.reflect) {
if (BUILD.vdomRender || BUILD.reflect) {
// 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!
if (BUILD.hydrateServerSide) {
return Promise.resolve(instance).then((value) => renderVdom(hostRef, value, isInitialLoad));
}
else {
renderVdom(hostRef, instance, isInitialLoad);
}
}
else {
const shadowRoot = elm.shadowRoot;
if (hostRef.$cmpMeta$.$flags$ & 1 /* CMP_FLAGS.shadowDomEncapsulation */) {
shadowRoot.textContent = instance;
}
else {
elm.textContent = instance;
}
}
}
}
catch (e) {
consoleError(e, hostRef.$hostElement$);
}
renderingRef = null;
return null;
};
const getRenderingRef = () => renderingRef;
const postUpdateComponent = (hostRef) => {
const tagName = hostRef.$cmpMeta$.$tagName$;
const elm = hostRef.$hostElement$;
const endPostUpdate = createTime('postUpdate', tagName);
const instance = BUILD.lazyLoad ? hostRef.$lazyInstance$ : elm;
const ancestorComponent = hostRef.$ancestorComponent$;
if (BUILD.cmpDidRender) {
if (BUILD.isDev) {
hostRef.$flags$ |= 1024 /* HOST_FLAGS.devOnRender */;
}
safeCall(instance, 'componentDidRender');
if (BUILD.isDev) {
hostRef.$flags$ &= ~1024 /* HOST_FLAGS.devOnRender */;
}
}
emitLifecycleEvent(elm, 'componentDidRender');
if (!(hostRef.$flags$ & 64 /* HOST_FLAGS.hasLoadedComponent */)) {
hostRef.$flags$ |= 64 /* HOST_FLAGS.hasLoadedComponent */;
if (BUILD.asyncLoading && BUILD.cssAnnotations) {
// DOM WRITE!
addHydratedFlag(elm);
}
if (BUILD.cmpDidLoad) {
if (BUILD.isDev) {
hostRef.$flags$ |= 2048 /* HOST_FLAGS.devOnDidLoad */;
}
safeCall(instance, 'componentDidLoad');
if (BUILD.isDev) {
hostRef.$flags$ &= ~2048 /* HOST_FLAGS.devOnDidLoad */;
}
}
emitLifecycleEvent(elm, 'componentDidLoad');
endPostUpdate();
if (BUILD.asyncLoading) {
hostRef.$onReadyResolve$(elm);
if (!ancestorComponent) {
appDidLoad(tagName);
}
}
}
else {
if (BUILD.cmpDidUpdate) {
// we've already loaded this component
// fire off the user's componentDidUpdate method (if one was provided)
// componentDidUpdate runs AFTER render() has been called
// and all child components have finished updating
if (BUILD.isDev) {
hostRef.$flags$ |= 1024 /* HOST_FLAGS.devOnRender */;
}
safeCall(instance, 'componentDidUpdate');
if (BUILD.isDev) {
hostRef.$flags$ &= ~1024 /* HOST_FLAGS.devOnRender */;
}
}
emitLifecycleEvent(elm, 'componentDidUpdate');
endPostUpdate();
}
if (BUILD.method && BUILD.lazyLoad) {
hostRef.$onInstanceResolve$(elm);
}
// load events fire from bottom to top
// the deepest elements load first then bubbles up
if (BUILD.asyncLoading) {
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 forceUpdate = (ref) => {
if (BUILD.updatable && (Build.isBrowser || Build.isTesting)) {
const hostRef = getHostRef(ref);
const isConnected = hostRef.$hostElement$.isConnected;
if (isConnected &&
(hostRef.$flags$ & (2 /* HOST_FLAGS.hasRendered */ | 16 /* HOST_FLAGS.isQueuedForUpdate */)) === 2 /* HOST_FLAGS.hasRendered */) {
scheduleUpdate(hostRef, false);
}
// Returns "true" when the forced update was successfully scheduled
return isConnected;
}
return false;
};
const appDidLoad = (who) => {
// on appload
// we have finish the first big initial render
if (BUILD.cssAnnotations) {
addHydratedFlag(doc.documentElement);
}
if (BUILD.asyncQueue) {
plt.$flags$ |= 2 /* PLATFORM_FLAGS.appLoaded */;
}
nextTick(() => emitEvent(win, 'appload', { detail: { namespace: NAMESPACE } }));
if (BUILD.profile && performance.measure) {
performance.measure(`[Stencil] ${NAMESPACE} initial load (by ${who})`, 'st:app:start');
}
};
/**
* Allows to safely call a method, e.g. `componentDidLoad`, on an instance,
* e.g. custom element node. If a build figures out that e.g. no component
* has a `componentDidLoad` method, the instance method gets removed from the
* output bundle and this function returns `undefined`.
* @param instance any object that may or may not contain methods
* @param method method name
* @param arg single arbitrary argument
* @returns result of method call if it exists, otherwise `undefined`
*/
const safeCall = (instance, method, arg) => {
if (instance && instance[method]) {
try {
return instance[method](arg);
}
catch (e) {
consoleError(e);
}
}
return undefined;
};
/**
* For debugging purposes as `BUILD.lifecycleDOMEvents` is `false` by default and will
* get removed by the compiler. Used for timing events to see how long they take.
* @param elm the target of the Event
* @param lifecycleName name of the event
*/
const emitLifecycleEvent = (elm, lifecycleName) => {
if (BUILD.lifecycleDOMEvents) {
emitEvent(elm, 'stencil_' + lifecycleName, {
bubbles: true,
composed: true,
detail: {
namespace: NAMESPACE,
},
});
}
};
const addHydratedFlag = (elm) => BUILD.hydratedClass
? elm.classList.add('hydrated')
: BUILD.hydratedAttribute
? elm.setAttribute('hydrated', '')
: undefined;
const serverSideConnected = (elm) => {
const children = elm.children;
if (children != null) {
for (let i = 0, ii = children.length; i < ii; i++) {
const childElm = children[i];
if (typeof childElm.connectedCallback === 'function') {
childElm.connectedCallback();
}
serverSideConnected(childElm);
}
}
};
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 = BUILD.lazyLoad ? hostRef.$hostElement$ : ref;
const oldVal = hostRef.$instanceValues$.get(propName);
const flags = hostRef.$flags$;
const instance = BUILD.lazyLoad ? hostRef.$lazyInstance$ : elm;
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 ((!BUILD.lazyLoad || !(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 (BUILD.isDev) {
if (hostRef.$flags$ & 1024 /* HOST_FLAGS.devOnRender */) {
consoleDevWarn(`The state/prop "${propName}" changed during rendering. This can potentially lead to infinite-loops and other bugs.`, '\nElement', elm, '\nNew value', newVal, '\nOld value', oldVal);
}
else if (hostRef.$flags$ & 2048 /* HOST_FLAGS.devOnDidLoad */) {
consoleDevWarn(`The state/prop "${propName}" changed during "componentDidLoad()", this triggers extra re-renders, try to setup on "componentWillLoad()"`, '\nElement', elm, '\nNew value', newVal, '\nOld value', oldVal);
}
}
if (!BUILD.lazyLoad || instance) {
// get an array of method names of watch functions to call
if (BUILD.watchCallback && 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 (BUILD.updatable &&
(flags & (2 /* HOST_FLAGS.hasRendered */ | 16 /* HOST_FLAGS.isQueuedForUpdate */)) === 2 /* HOST_FLAGS.hasRendered */) {
if (BUILD.cmpShouldUpdate && instance.componentShouldUpdate) {
if (instance.componentShouldUpdate(newVal, oldVal, propName) === false) {
return;
}
}
// 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) => {
var _a;
const prototype = Cstr.prototype;
/**
* proxy form associated custom element lifecycle callbacks
* @ref https://web.dev/articles/more-capable-form-controls#lifecycle_callbacks
*/
if (BUILD.formAssociated && cmpMeta.$flags$ & 64 /* CMP_FLAGS.formAssociated */ && flags & 1 /* PROXY_FLAGS.isElementConstructor */) {
FORM_ASSOCIATED_CUSTOM_ELEMENT_CALLBACKS.forEach((cbName) => Object.defineProperty(prototype, cbName, {
value(...args) {
const hostRef = getHostRef(this);
const elm = BUILD.lazyLoad ? hostRef.$hostElement$ : this;
const instance = BUILD.lazyLoad ? hostRef.$lazyInstance$ : elm;
if (!instance) {
hostRef.$onReadyPromise$.then((instance) => {
const cb = instance[cbName];
typeof cb === 'function' && cb.call(instance, ...args);
});
}
else {
const cb = instance[cbName];
typeof cb === 'function' && cb.call(instance, ...args);
}
},
}));
}
if (BUILD.member && cmpMeta.$members$) {
if (BUILD.watchCallback && Cstr.watchers) {
cmpMeta.$watchers$ = Cstr.watchers;
}
// It's better to have a const than two Object.entries()
const members = Object.entries(cmpMeta.$members$);
members.map(([memberName, [memberFlags]]) => {
if ((BUILD.prop || BUILD.state) &&
(memberFlags & 31 /* MEMBER_FLAGS.Prop */ ||
((!BUILD.lazyLoad || 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) {
// only during dev time
if (BUILD.isDev) {
const ref = getHostRef(this);
if (
// we are proxying the instance (not element)
(flags & 1 /* PROXY_FLAGS.isElementConstructor */) === 0 &&
// the element is not constructing
(ref && ref.$flags$ & 8 /* HOST_FLAGS.isConstructingInstance */) === 0 &&
// the member is a prop
(memberFlags & 31 /* MEMBER_FLAGS.Prop */) !== 0 &&
// the member is not mutable
(memberFlags & 1024 /* MEMBER_FLAGS.Mutable */) === 0) {
consoleDevWarn(`@Prop() "${memberName}" on <${cmpMeta.$tagName$}> is immutable but was modified from within the component.\nMore information: https://stenciljs.com/docs/properties#prop-mutability`);
}
}
// proxyComponent, set value
setValue(this, memberName, newValue, cmpMeta);
},
configurable: true,
enumerable: true,
});
}
else if (BUILD.lazyLoad &&
BUILD.method &&
flags & 1 /* PROXY_FLAGS.isElementConstructor */ &&
memberFlags & 64 /* MEMBER_FLAGS.Method */) {
// proxyComponent - method
Object.defineProperty(prototype, memberName, {
value(...args) {
var _a;
const ref = getHostRef(this);
return (_a = ref === null || ref === void 0 ? void 0 : ref.$onInstancePromise$) === null || _a === void 0 ? void 0 : _a.then(() => { var _a; return (_a = ref.$lazyInstance$) === null || _a === void 0 ? void 0 : _a[memberName](...args); });
},
});
}
});
if (BUILD.observeAttribute && (!BUILD.lazyLoad || flags & 1 /* PROXY_FLAGS.isElementConstructor */)) {
const attrNameToPropName = new Map();
prototype.attributeChangedCallback = function (attrName, oldValue, newValue) {
plt.jmp(() => {
var _a;
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 un-shadow 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 un-shadow 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/un-shadowed
// 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;
}
else if (propName == null) {
// At this point we should know this is not a "member", so we can treat it like watching an attribute
// on a vanilla web component
const hostRef = getHostRef(this);
const flags = hostRef === null || hostRef === void 0 ? void 0 : hostRef.$flags$;
// We only want to trigger the callback(s) if:
// 1. The instance is ready
// 2. The watchers are ready
// 3. The value has changed
if (flags &&
!(flags & 8 /* HOST_FLAGS.isConstructingInstance */) &&
flags & 128 /* HOST_FLAGS.isWatchReady */ &&
newValue !== oldValue) {
const elm = BUILD.lazyLoad ? hostRef.$hostElement$ : this;
const instance = BUILD.lazyLoad ? hostRef.$lazyInstance$ : elm;
const entry = (_a = cmpMeta.$watchers$) === null || _a === void 0 ? void 0 : _a[attrName];
entry === null || entry === void 0 ? void 0 : entry.forEach((callbackName) => {
if (instance[callbackName] != null) {
instance[callbackName].call(instance, newValue, oldValue, attrName);
}
});
}
return;
}
this[propName] = newValue === null && typeof this[propName] === 'boolean' ? false : newValue;
});
};
// Create an array of attributes to observe
// This list in comprised of all strings used within a `@Watch()` decorator
// on a component as well as any Stencil-specific "members" (`@Prop()`s and `@State()`s).
// As such, there is no way to guarantee type-safety here that a user hasn't entered
// an invalid attribute.
Cstr.observedAttributes = Array.from(new Set([
...Object.keys((_a = cmpMeta.$watchers$) !== null && _a !== void 0 ? _a : {}),
...members
.filter(([_, m]) => m[0] & 15 /* MEMBER_FLAGS.HasAttribute */)
.map(([propName, m]) => {
var _a;
const attrName = m[1] || propName;
attrNameToPropName.set(attrName, propName);
if (BUILD.reflect && m[0] & 512 /* MEMBER_FLAGS.ReflectAttr */) {
(_a = cmpMeta.$attrsToReflect$) === null || _a === void 0 ? void 0 : _a.push([propName, attrName]);
}
return attrName;
}),
]));
}
}
return Cstr;
};
/**
* Initialize a Stencil component given a reference to its host element, its
* runtime bookkeeping data structure, runtime metadata about the component,
* and (optionally) an HMR version ID.
*
* @param elm a host element
* @param hostRef the element's runtime bookkeeping object
* @param cmpMeta runtime metadata for the Stencil component
* @param hmrVersionId an (optional) HMR version ID
*/
const initializeComponent = async (elm, hostRef, cmpMeta, hmrVersionId) => {
let 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 */;
const bundleId = cmpMeta.$lazyBundleId$;
if ((BUILD.lazyLoad || BUILD.hydrateClientSide) && bundleId) {
// lazy loaded components
// request the component's implementation to be
// wired up with the host element
Cstr = loadModule(cmpMeta, hostRef, hmrVersionId);
if (Cstr.then) {
// Await creates a micro-task avoid if possible
const endLoad = uniqueTime(`st:load:${cmpMeta.$tagName$}:${hostRef.$modeName$}`, `[Stencil] Load module for <${cmpMeta.$tagName$}>`);
Cstr = await Cstr;
endLoad();
}
if ((BUILD.isDev || BUILD.isDebug) && !Cstr) {
throw new Error(`Constructor for "${cmpMeta.$tagName$}#${hostRef.$modeName$}" was not found`);
}
if (BUILD.member && !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
if (BUILD.watchCallback) {
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
if (BUILD.member) {
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);
}
if (BUILD.member) {
hostRef.$flags$ &= ~8 /* HOST_FLAGS.isConstructingInstance */;
}
if (BUILD.watchCallback) {
hostRef.$flags$ |= 128 /* HOST_FLAGS.isWatchReady */;
}
endNewInstance();
fireConnectedCallback(hostRef.$lazyInstance$);
}
else {
// sync constructor component
Cstr = elm.constructor;
// wait for the CustomElementRegistry to mark the component as ready before setting `isWatchReady`. Otherwise,
// watchers may fire prematurely if `customElements.get()`/`customElements.whenDefined()` resolves _before_
// Stencil has completed instantiating the component.
customElements.whenDefined(cmpMeta.$tagName$).then(() => (hostRef.$flags$ |= 128 /* HOST_FLAGS.isWatchReady */));
}
if (BUILD.style && Cstr.style) {
// this component has styles but we haven't registered them yet
let style = Cstr.style;
if (BUILD.mode && typeof style !== 'string') {
style = style[(hostRef.$modeName$ = computeMode(elm))];
if (BUILD.hydrateServerSide && hostRef.$modeName$) {
elm.setAttribute('s-mode', hostRef.$modeName$);
}
}
const scopeId = getScopeId(cmpMeta, hostRef.$modeName$);
if (!styles.has(scopeId)) {
const endRegisterStyles = createTime('registerStyles', cmpMeta.$tagName$);
if (!BUILD.hydrateServerSide &&
BUILD.shadowDom &&
// TODO(STENCIL-854): Remove code related to legacy shadowDomShim field
BUILD.shadowDomShim &&
cmpMeta.$flags$ & 8 /* CMP_FLAGS.needsShadowDomShim */) {
style = await import('./shadow-css-d617e121.js').then((m) => m.scopeCss(style, scopeId, false));
}
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 (BUILD.asyncLoading && 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) => {
if (BUILD.lazyLoad && BUILD.connectedCallback) {
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 (BUILD.hostListenerTargetParent) {
// only run if we have listeners being attached to a parent
addHostEventListeners(elm, hostRef, cmpMeta.$listeners$, true);
}
if (!(hostRef.$flags$ & 1 /* HOST_FLAGS.hasConnected */)) {
// first time this component has connected
hostRef.$flags$ |= 1 /* HOST_FLAGS.hasConnected */;
let hostId;
if (BUILD.hydrateClientSide) {
hostId = elm.getAttribute(HYDRATE_ID);
if (hostId) {
if (BUILD.shadowDom && supportsShadow && cmpMeta.$flags$ & 1 /* CMP_FLAGS.shadowDomEncapsulation */) {
const scopeId = BUILD.mode
? addStyle(elm.shadowRoot, cmpMeta, elm.getAttribute('s-mode'))
: addStyle(elm.shadowRoot, cmpMeta);
elm.classList.remove(scopeId + '-h', scopeId + '-s');
}
initializeClientHydrate(elm, cmpMeta.$tagName$, hostId, hostRef);
}
}
if (BUILD.slotRelocation && !hostId) {
// initUpdate
// if the slot polyfill is required we'll need to put some nodes
// in here to act as original content anchors as we move nodes around
// host element has been connected to the DOM
if (BUILD.hydrateServerSide ||
((BUILD.slot || BUILD.shadowDom) &&
// TODO(STENCIL-854): Remove code related to legacy shadowDomShim field
cmpMeta.$flags$ & (4 /* CMP_FLAGS.hasSlotRelocation */ | 8 /* CMP_FLAGS.needsShadowDomShim */))) {
setContentReference(elm);
}
}
if (BUILD.asyncLoading) {
// 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 ((BUILD.hydrateClientSide &&
ancestorComponent.nodeType === 1 /* NODE_TYPE.ElementNode */ &&
ancestorComponent.hasAttribute('s-id') &&
ancestorComponent['s-p']) ||
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 (BUILD.prop && !BUILD.hydrateServerSide && 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;
}
});
}
if (BUILD.initializeNextTick) {
// connectedCallback, taskQueue, initialLoad
// angular sets attribute AFTER connectCallback
// https://github.com/angular/angular/issues/18909
// https://github.com/angular/angular/issues/19940
nextTick(() => initializeComponent(elm, hostRef, cmpMeta));
}
else {
initializeComponent(elm, hostRef, cmpMeta);
}
}
else {
// not the first time this has connected
// reattach any event listeners to the host
// since they would have been removed when disconnected
addHostEventListeners(elm, hostRef, cmpMeta.$listeners$, false);
// 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 setContentReference = (elm) => {
// 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
const contentRefElm = (elm['s-cr'] = doc.createComment(BUILD.isDebug ? `content-ref (host=${elm.localName})` : ''));
contentRefElm['s-cn'] = true;
elm.insertBefore(contentRefElm, elm.firstChild);
};
const disconnectInstance = (instance) => {
if (BUILD.lazyLoad && BUILD.disconnectedCallback) {
safeCall(instance, 'disconnectedCallback');
}
if (BUILD.cmpDidUnload) {
safeCall(instance, 'componentDidUnload');
}
};
const disconnectedCallback = async (elm) => {
if ((plt.$flags$ & 1 /* PLATFORM_FLAGS.isTmpDisconnected */) === 0) {
const hostRef = getHostRef(elm);
if (BUILD.hostListener) {
if (hostRef.$rmListeners$) {
hostRef.$rmListeners$.map((rmListener) => rmListener());
hostRef.$rmListeners$ = undefined;
}
}
if (!BUILD.lazyLoad) {
disconnectInstance(elm);
}
else 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 patchPseudoShadowDom = (hostElementPrototype, descriptorPrototype) => {
patchCloneNode(hostElementPrototype);
patchSlotAppendChild(hostElementPrototype);
patchSlotAppend(hostElementPrototype);
patchSlotPrepend(hostElementPrototype);
patchSlotInsertAdjacentElement(hostElementPrototype);
patchSlotInsertAdjacentHTML(hostElementPrototype);
patchSlotInsertAdjacentText(hostElementPrototype);
patchTextContent(hostElementPrototype);
patchChildSlotNodes(hostElementPrototype, descriptorPrototype);
patchSlotRemoveChild(hostElementPrototype);
};
const patchCloneNode = (HostElementPrototype) => {
const orgCloneNode = HostElementPrototype.cloneNode;
HostElementPrototype.cloneNode = function (deep) {
const srcNode = this;
const isShadowDom = BUILD.shadowDom ? srcNode.shadowRoot && supportsShadow : false;
const clonedNode = orgCloneNode.call(srcNode, isShadowDom ? deep : false);
if (BUILD.slot && !isShadowDom && deep) {
let i = 0;
let slotted, nonStencilNode;
const stencilPrivates = [
's-id',
's-cr',
's-lr',
's-rc',
's-sc',
's-p',
's-cn',
's-sr',
's-sn',
's-hn',
's-ol',
's-nr',
's-si',
's-rf',
];
for (; i < srcNode.childNodes.length; i++) {
slotted = srcNode.childNodes[i]['s-nr'];
nonStencilNode = stencilPrivates.every((privateField) => !srcNode.childNodes[i][privateField]);
if (slotted) {
if (BUILD.appendChildSlotFix && clonedNode.__appendChild) {
clonedNode.__appendChild(slotted.cloneNode(true));
}
else {
clonedNode.appendChild(slotted.cloneNode(true));
}
}
if (nonStencilNode) {
clonedNode.appendChild(srcNode.childNodes[i].cloneNode(true));
}
}
}
return clonedNode;
};
};
/**
* Patches the `appendChild` method on a `scoped` Stencil component.
* The patch will attempt to find a slot with the same name as the node being appended
* and insert it into the slot reference if found. Otherwise, it falls-back to the original
* `appendChild` method.
*
* @param HostElementPrototype The Stencil component to be patched
*/
const patchSlotAppendChild = (HostElementPrototype) => {
HostElementPrototype.__appendChild = HostElementPrototype.appendChild;
HostElementPrototype.appendChild = function (newChild) {
const slotName = (newChild['s-sn'] = getSlotName(newChild));
const slotNode = getHostSlotNode(this.childNodes, slotName, this.tagName);
if (slotNode) {
const slotChildNodes = getHostSlotChildNodes(slotNode, slotName);
const appendAfter = slotChildNodes[slotChildNodes.length - 1];
const insertedNode = appendAfter.parentNode.insertBefore(newChild, appendAfter.nextSibling);
// Check if there is fallback content that should be hidden
updateFallbackSlotVisibility(this);
return insertedNode;
}
return this.__appendChild(newChild);
};
};
/**
* Patches the `removeChild` method on a `scoped` Stencil component.
* This patch attempts to remove the specified node from a slot reference
* if the slot exists. Otherwise, it falls-back to the original `removeChild` method.
*
* @param ElementPrototype The Stencil component to be patched
*/
const patchSlotRemoveChild = (ElementPrototype) => {
ElementPrototype.__removeChild = ElementPrototype.removeChild;
ElementPrototype.removeChild = function (toRemove) {
if (toRemove && typeof toRemove['s-sn'] !== 'undefined') {
const slotNode = getHostSlotNode(this.childNodes, toRemove['s-sn'], this.tagName);
if (slotNode) {
// Get all slot content
const slotChildNodes = getHostSlotChildNodes(slotNode, toRemove['s-sn']);
// See if any of the slotted content matches the node to remove
const existingNode = slotChildNodes.find((n) => n === toRemove);
if (existingNode) {
existingNode.remove();
// Check if there is fallback content that should be displayed if that
// was the last node in the slot
updateFallbackSlotVisibility(this);
return;
}
}
}
return this.__removeChild(toRemove);
};
};
/**
* Patches the `prepend` method for a slotted node inside a scoped component.
*
* @param HostElementPrototype the `Element` to be patched
*/
const patchSlotPrepend = (HostElementPrototype) => {
const originalPrepend = HostElementPrototype.prepend;
HostElementPrototype.prepend = function (...newChildren) {
newChildren.forEach((newChild) => {
if (typeof newChild === 'string') {
newChild = this.ownerDocument.createTextNode(newChild);
}
const slotName = (newChild['s-sn'] = getSlotName(newChild));
const slotNode = getHostSlotNode(this.childNodes, slotName, this.tagName);
if (slotNode) {
const slotPlaceholder = document.createTextNode('');
slotPlaceholder['s-nr'] = newChild;
slotNode['s-cr'].parentNode.__appendChild(slotPlaceholder);
newChild['s-ol'] = slotPlaceholder;
const slotChildNodes = getHostSlotChildNodes(slotNode, slotName);
const appendAfter = slotChildNodes[0];
return appendAfter.parentNode.insertBefore(newChild, appendAfter.nextSibling);
}
if (newChild.nodeType === 1 && !!newChild.getAttribute('slot')) {
newChild.hidden = true;
}
return originalPrepend.call(this, newChild);
});
};
};
/**
* Patches the `append` method for a slotted node inside a scoped component. The patched method uses
* `appendChild` under-the-hood while creating text nodes for any new children that passed as bare strings.
*
* @param HostElementPrototype the `Element` to be patched
*/
const patchSlotAppend = (HostElementPrototype) => {
HostElementPrototype.append = function (...newChildren) {
newChildren.forEach((newChild) => {
if (typeof newChild === 'string') {
newChild = this.ownerDocument.createTextNode(newChild);
}
this.appendChild(newChild);
});
};
};
/**
* Patches the `insertAdjacentHTML` method for a slotted node inside a scoped component. Specifically,
* we only need to patch the behavior for the specific `beforeend` and `afterbegin` positions so the element
* gets inserted into the DOM in the correct location.
*
* @param HostElementPrototype the `Element` to be patched
*/
const patchSlotInsertAdjacentHTML = (HostElementPrototype) => {
const originalInsertAdjacentHtml = HostElementPrototype.insertAdjacentHTML;
HostElementPrototype.insertAdjacentHTML = function (position, text) {
if (position !== 'afterbegin' && position !== 'beforeend') {
return originalInsertAdjacentHtml.call(this, position, text);
}
const container = this.ownerDocument.createElement('_');
let node;
container.innerHTML = text;
if (position === 'afterbegin') {
while ((node = container.firstChild)) {
this.prepend(node);
}
}
else if (position === 'beforeend') {
while ((node = container.firstChild)) {
this.append(node);
}
}
};
};
/**
* Patches the `insertAdjacentText` method for a slotted node inside a scoped component. Specifically,
* we only need to patch the behavior for the specific `beforeend` and `afterbegin` positions so the text node
* gets inserted into the DOM in the correct location.
*
* @param HostElementPrototype the `Element` to be patched
*/
const patchSlotInsertAdjacentText = (HostElementPrototype) => {
HostElementPrototype.insertAdjacentText = function (position, text) {
this.insertAdjacentHTML(position, text);
};
};
/**
* Patches the `insertAdjacentElement` method for a slotted node inside a scoped component. Specifically,
* we only need to patch the behavior for the specific `beforeend` and `afterbegin` positions so the element
* gets inserted into the DOM in the correct location.
*
* @param HostElementPrototype the `Element` to be patched
*/
const patchSlotInsertAdjacentElement = (HostElementPrototype) => {
const originalInsertAdjacentElement = HostElementPrototype.insertAdjacentElement;
HostElementPrototype.insertAdjacentElement = function (position, element) {
if (position !== 'afterbegin' && position !== 'beforeend') {
return originalInsertAdjacentElement.call(this, position, element);
}
if (position === 'afterbegin') {
this.prepend(element);
return element;
}
else if (position === 'beforeend') {
this.append(element);
return element;
}
return element;
};
};
/**
* Patches the text content of an unnamed slotted node inside a scoped component
* @param hostElementPrototype the `Element` to be patched
*/
const patchTextContent = (hostElementPrototype) => {
const descriptor = Object.getOwnPropertyDescriptor(Node.prototype, 'textContent');
Object.defineProperty(hostElementPrototype, '__textContent', descriptor);
if (BUILD.experimentalScopedSlotChanges) {
// Patch `textContent` to mimic shadow root behavior
Object.defineProperty(hostElementPrototype, 'textContent', {
// To mimic shadow root behavior, we need to return the text content of all
// nodes in a slot reference node
get() {
const slotRefNodes = getAllChildSlotNodes(this.childNodes);
const textContent = slotRefNodes
.map((node) => {
var _a, _b;
const text = [];
// Need to get the text content of all nodes in the slot reference node
let slotContent = node.nextSibling;
while (slotContent && slotContent['s-sn'] === node['s-sn']) {
if (slotContent.nodeType === 3 /* NODE_TYPES.TEXT_NODE */ || slotContent.nodeType === 1 /* NODE_TYPES.ELEMENT_NODE */) {
text.push((_b = (_a = slotContent.textContent) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : '');
}
slotContent = slotContent.nextSibling;
}
return text.filter((ref) => ref !== '').join(' ');
})
.filter((text) => text !== '')
.join(' ');
// Pad the string to return
return ' ' + textContent + ' ';
},
// To mimic shadow root behavior, we need to overwrite all nodes in a slot
// reference node. If a default slot reference node exists, the text content will be
// placed there. Otherwise, the new text node will be hidden
set(value) {
const slotRefNodes = getAllChildSlotNodes(this.childNodes);
slotRefNodes.forEach((node) => {
// Remove the existing content of the slot
let slotContent = node.nextSibling;
while (slotContent && slotContent['s-sn'] === node['s-sn']) {
const tmp = slotContent;
slotContent = slotContent.nextSibling;
tmp.remove();
}
// If this is a default slot, add the text node in the slot location.
// Otherwise, destroy the slot reference node
if (node['s-sn'] === '') {
const textNode = this.ownerDocument.createTextNode(value);
textNode['s-sn'] = '';
node.parentElement.insertBefore(textNode, node.nextSibling);
}
else {
node.remove();
}
});
},
});
}
else {
Object.defineProperty(hostElementPrototype, 'textContent', {
get() {
var _a;
// get the 'default slot', which would be the first slot in a shadow tree (if we were using one), whose name is
// the empty string
const slotNode = getHostSlotNode(this.childNodes, '', this.tagName);
// when a slot node is found, the textContent _may_ be found in the next sibling (text) node, depending on how
// nodes were reordered during the vdom render. first try to get the text content from the sibling.
if (((_a = slotNode === null || slotNode === void 0 ? void 0 : slotNode.nextSibling) === null || _a === void 0 ? void 0 : _a.nodeType) === 3 /* NODE_TYPES.TEXT_NODE */) {
return slotNode.nextSibling.textContent;
}
else if (slotNode) {
return slotNode.textContent;
}
else {
// fallback to the original implementation
return this.__textContent;
}
},
set(value) {
var _a;
// get the 'default slot', which would be the first slot in a shadow tree (if we were using one), whose name is
// the empty string
const slotNode = getHostSlotNode(this.childNodes, '', this.tagName);
// when a slot node is found, the textContent _may_ need to be placed in the next sibling (text) node,
// depending on how nodes were reordered during the vdom render. first try to set the text content on the
// sibling.
if (((_a = slotNode === null || slotNode === void 0 ? void 0 : slotNode.nextSibling) === null || _a === void 0 ? void 0 : _a.nodeType) === 3 /* NODE_TYPES.TEXT_NODE */) {
slotNode.nextSibling.textContent = value;
}
else if (slotNode) {
slotNode.textContent = value;
}
else {
// we couldn't find a slot, but that doesn't mean that there isn't one. if this check ran before the DOM
// loaded, we could have missed it. check for a content reference element on the scoped component and insert
// it there
this.__textContent = value;
const contentRefElm = this['s-cr'];
if (contentRefElm) {
this.insertBefore(contentRefElm, this.firstChild);
}
}
},
});
}
};
const patchChildSlotNodes = (elm, cmpMeta) => {
class FakeNodeList extends Array {
item(n) {
return this[n];
}
}
// TODO(STENCIL-854): Remove code related to legacy shadowDomShim field
if (cmpMeta.$flags$ & 8 /* CMP_FLAGS.needsShadowDomShim */) {
const childNodesFn = elm.__lookupGetter__('childNodes');
Object.defineProperty(elm, 'children', {
get() {
return this.childNodes.map((n) => n.nodeType === 1);
},
});
Object.defineProperty(elm, 'childElementCount', {
get() {
return elm.children.length;
},
});
Object.defineProperty(elm, 'childNodes', {
get() {
const childNodes = childNodesFn.call(this);
if ((plt.$flags$ & 1 /* PLATFORM_FLAGS.isTmpDisconnected */) === 0 &&
getHostRef(this).$flags$ & 2 /* HOST_FLAGS.hasRendered */) {
const result = new FakeNodeList();
for (let i = 0; i < childNodes.length; i++) {
const slot = childNodes[i]['s-nr'];
if (slot) {
result.push(slot);
}
}
return result;
}
return FakeNodeList.from(childNodes);
},
});
}
};
/**
* Recursively finds all slot reference nodes ('s-sr') in a series of child nodes.
*
* @param childNodes The set of child nodes to search for slot reference nodes.
* @returns An array of slot reference nodes.
*/
const getAllChildSlotNodes = (childNodes) => {
const slotRefNodes = [];
for (const childNode of Array.from(childNodes)) {
if (childNode['s-sr']) {
slotRefNodes.push(childNode);
}
slotRefNodes.push(...getAllChildSlotNodes(childNode.childNodes));
}
return slotRefNodes;
};
const getSlotName = (node) => node['s-sn'] || (node.nodeType === 1 && node.getAttribute('slot')) || '';
/**
* Recursively searches a series of child nodes for a slot with the provided name.
* @param childNodes the nodes to search for a slot with a specific name.
* @param slotName the name of the slot to match on.
* @param hostName the host name of the slot to match on.
* @returns a reference to the slot node that matches the provided name, `null` otherwise
*/
const getHostSlotNode = (childNodes, slotName, hostName) => {
let i = 0;
let childNode;
for (; i < childNodes.length; i++) {
childNode = childNodes[i];
if (childNode['s-sr'] && childNode['s-sn'] === slotName && childNode['s-hn'] === hostName) {
return childNode;
}
childNode = getHostSlotNode(childNode.childNodes, slotName, hostName);
if (childNode) {
return childNode;
}
}
return null;
};
const getHostSlotChildNodes = (n, slotName) => {
const childNodes = [n];
while ((n = n.nextSibling) && n['s-sn'] === slotName) {
childNodes.push(n);
}
return childNodes;
};
const defineCustomElement = (Cstr, compactMeta) => {
customElements.define(compactMeta[1], proxyCustomElement(Cstr, compactMeta));
};
const proxyCustomElement = (Cstr, compactMeta) => {
const cmpMeta = {
$flags$: compactMeta[0],
$tagName$: compactMeta[1],
};
if (BUILD.member) {
cmpMeta.$members$ = compactMeta[2];
}
if (BUILD.hostListener) {
cmpMeta.$listeners$ = compactMeta[3];
}
if (BUILD.watchCallback) {
cmpMeta.$watchers$ = Cstr.$watchers$;
}
if (BUILD.reflect) {
cmpMeta.$attrsToReflect$ = [];
}
if (BUILD.shadowDom && !supportsShadow && cmpMeta.$flags$ & 1 /* CMP_FLAGS.shadowDomEncapsulation */) {
// TODO(STENCIL-854): Remove code related to legacy shadowDomShim field
cmpMeta.$flags$ |= 8 /* CMP_FLAGS.needsShadowDomShim */;
}
// TODO(STENCIL-914): this check and `else` block can go away and be replaced by just the `scoped` check
if (BUILD.experimentalSlotFixes) {
if (BUILD.scoped && cmpMeta.$flags$ & 2 /* CMP_FLAGS.scopedCssEncapsulation */) {
// This check is intentionally not combined with the surrounding `experimentalSlotFixes` check
// since, moving forward, we only want to patch the pseudo shadow DOM when the component is scoped
patchPseudoShadowDom(Cstr.prototype, cmpMeta);
}
}
else {
if (BUILD.slotChildNodesFix) {
patchChildSlotNodes(Cstr.prototype, cmpMeta);
}
if (BUILD.cloneNodeFix) {
patchCloneNode(Cstr.prototype);
}
if (BUILD.appendChildSlotFix) {
patchSlotAppendChild(Cstr.prototype);
}
if (BUILD.scopedSlotTextContentFix && cmpMeta.$flags$ & 2 /* CMP_FLAGS.scopedCssEncapsulation */) {
patchTextContent(Cstr.prototype);
}
}
const originalConnectedCallback = Cstr.prototype.connectedCallback;
const originalDisconnectedCallback = Cstr.prototype.disconnectedCallback;
Object.assign(Cstr.prototype, {
__registerHost() {
registerHost(this, cmpMeta);
},
connectedCallback() {
connectedCallback(this);
if (BUILD.connectedCallback && originalConnectedCallback) {
originalConnectedCallback.call(this);
}
},
disconnectedCallback() {
disconnectedCallback(this);
if (BUILD.disconnectedCallback && originalDisconnectedCallback) {
originalDisconnectedCallback.call(this);
}
},
__attachShadow() {
if (supportsShadow) {
if (BUILD.shadowDelegatesFocus) {
this.attachShadow({
mode: 'open',
delegatesFocus: !!(cmpMeta.$flags$ & 16 /* CMP_FLAGS.shadowDelegatesFocus */),
});
}
else {
this.attachShadow({ mode: 'open' });
}
}
else {
this.shadowRoot = this;
}
},
});
Cstr.is = cmpMeta.$tagName$;
return proxyComponent(Cstr, cmpMeta, 1 /* PROXY_FLAGS.isElementConstructor */ | 2 /* PROXY_FLAGS.proxyState */);
};
const forceModeUpdate = (elm) => {
if (BUILD.style && BUILD.mode && !BUILD.lazyLoad) {
const mode = computeMode(elm);
const hostRef = getHostRef(elm);
if (hostRef.$modeName$ !== mode) {
const cmpMeta = hostRef.$cmpMeta$;
const oldScopeId = elm['s-sc'];
const scopeId = getScopeId(cmpMeta, mode);
const style = elm.constructor.style[mode];
const flags = cmpMeta.$flags$;
if (style) {
if (!styles.has(scopeId)) {
registerStyle(scopeId, style, !!(flags & 1 /* CMP_FLAGS.shadowDomEncapsulation */));
}
hostRef.$modeName$ = mode;
elm.classList.remove(oldScopeId + '-h', oldScopeId + '-s');
attachStyles(hostRef);
forceUpdate(elm);
}
}
}
};
/**
* Kick off hot-module-replacement for a component. In order to replace the
* component in-place we:
*
* 1. get a reference to the {@link d.HostRef} for the element
* 2. reset the element's runtime flags
* 3. re-run the initialization logic for the element (via
* {@link initializeComponent})
*
* @param hostElement the host element for the component which we want to start
* doing HMR
* @param cmpMeta runtime metadata for the component
* @param hmrVersionId the current HMR version ID
*/
const hmrStart = (hostElement, cmpMeta, hmrVersionId) => {
// ¯\_(ツ)_/¯
const hostRef = getHostRef(hostElement);
// reset state flags to only have been connected
hostRef.$flags$ = 1 /* HOST_FLAGS.hasConnected */;
// TODO
// detach any event listeners that may have been added
// because we're not passing an exact event name it'll
// remove all of this element's event, which is good
// re-initialize the component
initializeComponent(hostElement, hostRef, cmpMeta, hmrVersionId);
};
const bootstrapLazy = (lazyBundles, options = {}) => {
var _a;
if (BUILD.profile && performance.mark) {
performance.mark('st:app:start');
}
installDevTools();
const endBootstrap = createTime('bootstrapLazy');
const cmpTags = [];
const exclude = options.exclude || [];
const customElements = win.customElements;
const head = doc.head;
const metaCharset = /*@__PURE__*/ head.querySelector('meta[charset]');
const dataStyles = /*@__PURE__*/ doc.createElement('style');
const deferredConnectedCallbacks = [];
const styles = /*@__PURE__*/ doc.querySelectorAll(`[${HYDRATED_STYLE_ID}]`);
let appLoadFallback;
let isBootstrapping = true;
let i = 0;
Object.assign(plt, options);
plt.$resourcesUrl$ = new URL(options.resourcesUrl || './', doc.baseURI).href;
if (BUILD.asyncQueue) {
if (options.syncQueue) {
plt.$flags$ |= 4 /* PLATFORM_FLAGS.queueSync */;
}
}
if (BUILD.hydrateClientSide) {
// If the app is already hydrated there is not point to disable the
// async queue. This will improve the first input delay
plt.$flags$ |= 2 /* PLATFORM_FLAGS.appLoaded */;
}
if (BUILD.hydrateClientSide && BUILD.shadowDom) {
for (; i < styles.length; i++) {
registerStyle(styles[i].getAttribute(HYDRATED_STYLE_ID), convertScopedToShadow(styles[i].innerHTML), true);
}
}
let hasSlotRelocation = false;
lazyBundles.map((lazyBundle) => {
lazyBundle[1].map((compactMeta) => {
var _a;
const cmpMeta = {
$flags$: compactMeta[0],
$tagName$: compactMeta[1],
$members$: compactMeta[2],
$listeners$: compactMeta[3],
};
// Check if we are using slots outside the shadow DOM in this component.
// We'll use this information later to add styles for `slot-fb` elements
if (cmpMeta.$flags$ & 4 /* CMP_FLAGS.hasSlotRelocation */) {
hasSlotRelocation = true;
}
if (BUILD.member) {
cmpMeta.$members$ = compactMeta[2];
}
if (BUILD.hostListener) {
cmpMeta.$listeners$ = compactMeta[3];
}
if (BUILD.reflect) {
cmpMeta.$attrsToReflect$ = [];
}
if (BUILD.watchCallback) {
cmpMeta.$watchers$ = (_a = compactMeta[4]) !== null && _a !== void 0 ? _a : {};
}
if (BUILD.shadowDom && !supportsShadow && cmpMeta.$flags$ & 1 /* CMP_FLAGS.shadowDomEncapsulation */) {
// TODO(STENCIL-854): Remove code related to legacy shadowDomShim field
cmpMeta.$flags$ |= 8 /* CMP_FLAGS.needsShadowDomShim */;
}
const tagName = BUILD.transformTagName && options.transformTagName
? options.transformTagName(cmpMeta.$tagName$)
: cmpMeta.$tagName$;
const HostElement = class extends HTMLElement {
// StencilLazyHost
constructor(self) {
// @ts-ignore
super(self);
self = this;
registerHost(self, cmpMeta);
if (BUILD.shadowDom && 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
if (supportsShadow) {
if (BUILD.shadowDelegatesFocus) {
self.attachShadow({
mode: 'open',
delegatesFocus: !!(cmpMeta.$flags$ & 16 /* CMP_FLAGS.shadowDelegatesFocus */),
});
}
else {
self.attachShadow({ mode: 'open' });
}
}
else if (!BUILD.hydrateServerSide && !('shadowRoot' in self)) {
self.shadowRoot = self;
}
}
}
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$;
}
};
// TODO(STENCIL-914): this check and `else` block can go away and be replaced by just the `scoped` check
if (BUILD.experimentalSlotFixes) {
// This check is intentionally not combined with the surrounding `experimentalSlotFixes` check
// since, moving forward, we only want to patch the pseudo shadow DOM when the component is scoped
if (BUILD.scoped && cmpMeta.$flags$ & 2 /* CMP_FLAGS.scopedCssEncapsulation */) {
patchPseudoShadowDom(HostElement.prototype, cmpMeta);
}
}
else {
if (BUILD.slotChildNodesFix) {
patchChildSlotNodes(HostElement.prototype, cmpMeta);
}
if (BUILD.cloneNodeFix) {
patchCloneNode(HostElement.prototype);
}
if (BUILD.appendChildSlotFix) {
patchSlotAppendChild(HostElement.prototype);
}
if (BUILD.scopedSlotTextContentFix && cmpMeta.$flags$ & 2 /* CMP_FLAGS.scopedCssEncapsulation */) {
patchTextContent(HostElement.prototype);
}
}
// if the component is formAssociated we need to set that on the host
// element so that it will be ready for `attachInternals` to be called on
// it later on
if (BUILD.formAssociated && cmpMeta.$flags$ & 64 /* CMP_FLAGS.formAssociated */) {
HostElement.formAssociated = true;
}
if (BUILD.hotModuleReplacement) {
// if we're in an HMR dev build then we need to set up the callback
// which will carry out the work of actually replacing the module for
// this particular component
HostElement.prototype['s-hmr'] = function (hmrVersionId) {
hmrStart(this, cmpMeta, hmrVersionId);
};
}
cmpMeta.$lazyBundleId$ = lazyBundle[0];
if (!exclude.includes(tagName) && !customElements.get(tagName)) {
cmpTags.push(tagName);
customElements.define(tagName, proxyComponent(HostElement, cmpMeta, 1 /* PROXY_FLAGS.isElementConstructor */));
}
});
});
// Only bother generating CSS if we have components
// TODO(STENCIL-1118): Add test cases for CSS content based on conditionals
if (cmpTags.length > 0) {
// Add styles for `slot-fb` elements if any of our components are using slots outside the Shadow DOM
if (hasSlotRelocation) {
dataStyles.textContent += SLOT_FB_CSS;
}
// Add hydration styles
if (BUILD.invisiblePrehydration && (BUILD.hydratedClass || BUILD.hydratedAttribute)) {
dataStyles.textContent += cmpTags + HYDRATED_CSS;
}
// If we have styles, add them to the DOM
if (dataStyles.innerHTML.length) {
dataStyles.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) {
dataStyles.setAttribute('nonce', nonce);
}
// Insert the styles into the document head
// NOTE: this _needs_ to happen last so we can ensure the nonce (and other attributes) are applied
head.insertBefore(dataStyles, 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 {
if (BUILD.profile) {
plt.jmp(() => (appLoadFallback = setTimeout(appDidLoad, 30, 'timeout')));
}
else {
plt.jmp(() => (appLoadFallback = setTimeout(appDidLoad, 30)));
}
}
// Fallback appLoad event
endBootstrap();
};
const Fragment = (_, children) => children;
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;
/**
* 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 setPlatformOptions = (opts) => Object.assign(plt, opts);
/**
* Updates the DOM generated on the server with annotations such as node attributes and
* comment nodes to facilitate future client-side hydration. These annotations are used for things
* like moving elements back to their original hosts if using Shadow DOM on the client, and for quickly
* reconstructing the vNode representations of the DOM.
*
* @param doc The DOM generated by the server.
* @param staticComponents Any components that should be considered static and do not need client-side hydration.
*/
const insertVdomAnnotations = (doc, staticComponents) => {
if (doc != null) {
const docData = {
hostIds: 0,
rootLevelIds: 0,
staticComponents: new Set(staticComponents),
};
const orgLocationNodes = [];
parseVNodeAnnotations(doc, doc.body, docData, orgLocationNodes);
orgLocationNodes.forEach((orgLocationNode) => {
var _a, _b;
if (orgLocationNode != null && orgLocationNode['s-nr']) {
const nodeRef = orgLocationNode['s-nr'];
let hostId = nodeRef['s-host-id'];
let nodeId = nodeRef['s-node-id'];
let childId = `${hostId}.${nodeId}`;
if (hostId == null) {
hostId = 0;
docData.rootLevelIds++;
nodeId = docData.rootLevelIds;
childId = `${hostId}.${nodeId}`;
if (nodeRef.nodeType === 1 /* NODE_TYPE.ElementNode */) {
nodeRef.setAttribute(HYDRATE_CHILD_ID, childId);
}
else if (nodeRef.nodeType === 3 /* NODE_TYPE.TextNode */) {
if (hostId === 0) {
const textContent = (_a = nodeRef.nodeValue) === null || _a === void 0 ? void 0 : _a.trim();
if (textContent === '') {
// useless whitespace node at the document root
orgLocationNode.remove();
return;
}
}
const commentBeforeTextNode = doc.createComment(childId);
commentBeforeTextNode.nodeValue = `${TEXT_NODE_ID}.${childId}`;
(_b = nodeRef.parentNode) === null || _b === void 0 ? void 0 : _b.insertBefore(commentBeforeTextNode, nodeRef);
}
}
let orgLocationNodeId = `${ORG_LOCATION_ID}.${childId}`;
const orgLocationParentNode = orgLocationNode.parentElement;
if (orgLocationParentNode) {
if (orgLocationParentNode['s-en'] === '') {
// ending with a "." means that the parent element
// of this node's original location is a SHADOW dom element
// and this node is apart of the root level light dom
orgLocationNodeId += `.`;
}
else if (orgLocationParentNode['s-en'] === 'c') {
// ending with a ".c" means that the parent element
// of this node's original location is a SCOPED element
// and this node is apart of the root level light dom
orgLocationNodeId += `.c`;
}
}
orgLocationNode.nodeValue = orgLocationNodeId;
}
});
}
};
/**
* Recursively parses a node generated by the server and its children to set host and child id
* attributes read during client-side hydration. This function also tracks whether each node is
* an original location reference node meaning that a node has been moved via slot relocation.
*
* @param doc The DOM generated by the server.
* @param node The node to parse.
* @param docData An object containing metadata about the document.
* @param orgLocationNodes An array of nodes that have been moved via slot relocation.
*/
const parseVNodeAnnotations = (doc, node, docData, orgLocationNodes) => {
if (node == null) {
return;
}
if (node['s-nr'] != null) {
orgLocationNodes.push(node);
}
if (node.nodeType === 1 /* NODE_TYPE.ElementNode */) {
node.childNodes.forEach((childNode) => {
const hostRef = getHostRef(childNode);
if (hostRef != null && !docData.staticComponents.has(childNode.nodeName.toLowerCase())) {
const cmpData = {
nodeIds: 0,
};
insertVNodeAnnotations(doc, childNode, hostRef.$vnode$, docData, cmpData);
}
parseVNodeAnnotations(doc, childNode, docData, orgLocationNodes);
});
}
};
/**
* Insert attribute annotations on an element for its host ID and, potentially, its child ID.
* Also makes calls to insert annotations on the element's children, keeping track of the depth of
* the component tree.
*
* @param doc The DOM generated by the server.
* @param hostElm The element to insert annotations for.
* @param vnode The vNode representation of the element.
* @param docData An object containing metadata about the document.
* @param cmpData An object containing metadata about the component.
*/
const insertVNodeAnnotations = (doc, hostElm, vnode, docData, cmpData) => {
if (vnode != null) {
const hostId = ++docData.hostIds;
hostElm.setAttribute(HYDRATE_ID, hostId);
if (hostElm['s-cr'] != null) {
hostElm['s-cr'].nodeValue = `${CONTENT_REF_ID}.${hostId}`;
}
if (vnode.$children$ != null) {
const depth = 0;
vnode.$children$.forEach((vnodeChild, index) => {
insertChildVNodeAnnotations(doc, vnodeChild, cmpData, hostId, depth, index);
});
}
// If this element does not already have a child ID and has a sibling comment node
// representing a slot, we use the content of the comment to set the child ID attribute
// on the host element.
if (hostElm && vnode && vnode.$elm$ && !hostElm.hasAttribute(HYDRATE_CHILD_ID)) {
const parent = hostElm.parentElement;
if (parent && parent.childNodes) {
const parentChildNodes = Array.from(parent.childNodes);
const comment = parentChildNodes.find((node) => node.nodeType === 8 /* NODE_TYPE.CommentNode */ && node['s-sr']);
if (comment) {
const index = parentChildNodes.indexOf(hostElm) - 1;
vnode.$elm$.setAttribute(HYDRATE_CHILD_ID, `${comment['s-host-id']}.${comment['s-node-id']}.0.${index}`);
}
}
}
}
};
/**
* Recursively analyzes the type of a child vNode and inserts annotations on the vNodes's element based on its type.
* Element nodes receive a child ID attribute, text nodes have a comment with the child ID inserted before them,
* and comment nodes representing a slot have their node value set to a slot node ID containing the child ID.
*
* @param doc The DOM generated by the server.
* @param vnodeChild The vNode to insert annotations for.
* @param cmpData An object containing metadata about the component.
* @param hostId The host ID of this element's parent.
* @param depth How deep this element sits in the component tree relative to its parent.
* @param index The index of this element in its parent's children array.
*/
const insertChildVNodeAnnotations = (doc, vnodeChild, cmpData, hostId, depth, index) => {
const childElm = vnodeChild.$elm$;
if (childElm == null) {
return;
}
const nodeId = cmpData.nodeIds++;
const childId = `${hostId}.${nodeId}.${depth}.${index}`;
childElm['s-host-id'] = hostId;
childElm['s-node-id'] = nodeId;
if (childElm.nodeType === 1 /* NODE_TYPE.ElementNode */) {
childElm.setAttribute(HYDRATE_CHILD_ID, childId);
}
else if (childElm.nodeType === 3 /* NODE_TYPE.TextNode */) {
const parentNode = childElm.parentNode;
const nodeName = parentNode === null || parentNode === void 0 ? void 0 : parentNode.nodeName;
if (nodeName !== 'STYLE' && nodeName !== 'SCRIPT') {
const textNodeId = `${TEXT_NODE_ID}.${childId}`;
const commentBeforeTextNode = doc.createComment(textNodeId);
parentNode === null || parentNode === void 0 ? void 0 : parentNode.insertBefore(commentBeforeTextNode, childElm);
}
}
else if (childElm.nodeType === 8 /* NODE_TYPE.CommentNode */) {
if (childElm['s-sr']) {
const slotName = childElm['s-sn'] || '';
const slotNodeId = `${SLOT_NODE_ID}.${childId}.${slotName}`;
childElm.nodeValue = slotNodeId;
}
}
if (vnodeChild.$children$ != null) {
// Increment depth each time we recur deeper into the tree
const childDepth = depth + 1;
vnodeChild.$children$.forEach((vnode, index) => {
insertChildVNodeAnnotations(doc, vnode, cmpData, hostId, childDepth, index);
});
}
};
var _a;
/**
* A WeakMap mapping runtime component references to their corresponding host reference
* instances.
*
* **Note**: If we're in an HMR context we need to store a reference to this
* value on `window` in order to maintain the mapping of {@link d.RuntimeRef}
* to {@link d.HostRef} across HMR updates.
*
* This is necessary because when HMR updates for a component are processed by
* the browser-side dev server client the JS bundle for that component is
* re-fetched. Since the module containing {@link hostRefs} is included in
* that bundle, if we do not store a reference to it the new iteration of the
* component will not have access to the previous hostRef map, leading to a
* bug where the new version of the component cannot properly initialize.
*/
const hostRefs = BUILD.hotModuleReplacement
? ((_a = window).__STENCIL_HOSTREFS__ || (_a.__STENCIL_HOSTREFS__ = new WeakMap()))
: new WeakMap();
/**
* Given a {@link d.RuntimeRef} retrieve the corresponding {@link d.HostRef}
*
* @param ref the runtime ref of interest
* @returns the Host reference (if found) or undefined
*/
const getHostRef = (ref) => hostRefs.get(ref);
/**
* Register a lazy instance with the {@link hostRefs} object so it's
* corresponding {@link d.HostRef} can be retrieved later.
*
* @param lazyInstance the lazy instance of interest
* @param hostRef that instances `HostRef` object
* @returns a reference to the host ref WeakMap
*/
const registerInstance = (lazyInstance, hostRef) => hostRefs.set((hostRef.$lazyInstance$ = lazyInstance), hostRef);
/**
* Register a host element for a Stencil component, setting up various metadata
* and callbacks based on {@link BUILD} flags as well as the component's runtime
* metadata.
*
* @param hostElement the host element to register
* @param cmpMeta runtime metadata for that component
* @returns a reference to the host ref WeakMap
*/
const registerHost = (hostElement, cmpMeta) => {
const hostRef = {
$flags$: 0,
$hostElement$: hostElement,
$cmpMeta$: cmpMeta,
$instanceValues$: new Map(),
};
if (BUILD.isDev) {
hostRef.$renderCount$ = 0;
}
if (BUILD.method && BUILD.lazyLoad) {
hostRef.$onInstancePromise$ = new Promise((r) => (hostRef.$onInstanceResolve$ = r));
}
if (BUILD.asyncLoading) {
hostRef.$onReadyPromise$ = new Promise((r) => (hostRef.$onReadyResolve$ = r));
hostElement['s-p'] = [];
hostElement['s-rc'] = [];
}
addHostEventListeners(hostElement, hostRef, cmpMeta.$listeners$, false);
return hostRefs.set(hostElement, hostRef);
};
const isMemberInElement = (elm, memberName) => memberName in elm;
const consoleError = (e, el) => (customError || console.error)(e, el);
const STENCIL_DEV_MODE = BUILD.isTesting
? ['STENCIL:'] // E2E testing
: [
'%cstencil',
'color: white;background:#4c47ff;font-weight: bold; font-size:10px; padding:2px 6px; border-radius: 5px',
];
const consoleDevError = (...m) => console.error(...STENCIL_DEV_MODE, ...m);
const consoleDevWarn = (...m) => console.warn(...STENCIL_DEV_MODE, ...m);
const consoleDevInfo = (...m) => console.info(...STENCIL_DEV_MODE, ...m);
const setErrorHandler = (handler) => (customError = handler);
const cmpModules = /*@__PURE__*/ new Map();
const loadModule = (cmpMeta, hostRef, hmrVersionId) => {
// loadModuleImport
const exportName = cmpMeta.$tagName$.replace(/-/g, '_');
const bundleId = cmpMeta.$lazyBundleId$;
if (BUILD.isDev && typeof bundleId !== 'string') {
consoleDevError(`Trying to lazily load component <${cmpMeta.$tagName$}> with style mode "${hostRef.$modeName$}", but it does not exist.`);
return undefined;
}
const module = !BUILD.hotModuleReplacement ? cmpModules.get(bundleId) : false;
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${BUILD.hotModuleReplacement && hmrVersionId ? '?s-hmr=' + hmrVersionId : ''}`).then((importedModule) => {
if (!BUILD.hotModuleReplacement) {
cmpModules.set(bundleId, importedModule);
}
return importedModule[exportName];
}, consoleError);
};
const styles = /*@__PURE__*/ new Map();
const modeResolutionChain = [];
const win = typeof window !== 'undefined' ? window : {};
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 =
// TODO(STENCIL-854): Remove code related to legacy shadowDomShim field
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 queueDomReads = [];
const queueDomWrites = [];
const queueDomWritesLow = [];
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 consumeTimeout = (queue, timeout) => {
let i = 0;
let ts = 0;
while (i < queue.length && (ts = performance.now()) < timeout) {
try {
queue[i++](ts);
}
catch (e) {
consoleError(e);
}
}
if (i === queue.length) {
queue.length = 0;
}
else if (i !== 0) {
queue.splice(0, i);
}
};
const flush = () => {
if (BUILD.asyncQueue) {
queueCongestion++;
}
// 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!!!
if (BUILD.asyncQueue) {
const timeout = (plt.$flags$ & 6 /* PLATFORM_FLAGS.queueMask */) === 2 /* PLATFORM_FLAGS.appLoaded */
? performance.now() + 14 * Math.ceil(queueCongestion * (1.0 / 10.0))
: Infinity;
consumeTimeout(queueDomWrites, timeout);
consumeTimeout(queueDomWritesLow, timeout);
if (queueDomWrites.length > 0) {
queueDomWritesLow.push(...queueDomWrites);
queueDomWrites.length = 0;
}
if ((queuePending = queueDomReads.length + queueDomWrites.length + queueDomWritesLow.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);
}
else {
queueCongestion = 0;
}
}
else {
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 = (cb) => promiseResolve().then(cb);
const readTask = /*@__PURE__*/ queueTask(queueDomReads, false);
const writeTask = /*@__PURE__*/ queueTask(queueDomWrites, true);
export { BUILD as B, H, NAMESPACE as N, bootstrapLazy as b, consoleDevInfo as c, doc as d, getElement as g, h, promiseResolve as p, registerInstance as r, setNonce as s };