@stencil/core 2.20.0 → 2.21.0

package/internal/client/polyfills/css-shim.js

@@ -1 +1 @@
-var __assign=this&&this.__assign||function(){return(__assign=Object.assign||function(e){for(var t,r=1,n=arguments.length;r<n;r++)for(var s in t=arguments[r])Object.prototype.hasOwnProperty.call(t,s)&&(e[s]=t[s]);return e}).apply(this,arguments)},StyleNode=function(){this.start=0,this.end=0,this.previous=null,this.parent=null,this.rules=null,this.parsedCssText="",this.cssText="",this.atRule=!1,this.type=0,this.keyframesName="",this.selector="",this.parsedSelector=""};function parse(e){return parseCss(lex(e=clean(e)),e)}function clean(e){return e.replace(RX.comments,"").replace(RX.port,"")}function lex(e){var t=new StyleNode;t.start=0,t.end=e.length;for(var r=t,n=0,s=e.length;n<s;n++)if(e[n]===OPEN_BRACE){r.rules||(r.rules=[]);var o=r,a=o.rules[o.rules.length-1]||null;(r=new StyleNode).start=n+1,r.parent=o,r.previous=a,o.rules.push(r)}else e[n]===CLOSE_BRACE&&(r.end=n+1,r=r.parent||t);return t}function parseCss(e,t){var r=t.substring(e.start,e.end-1);if(e.parsedCssText=e.cssText=r.trim(),e.parent){var n=e.previous?e.previous.end:e.parent.start;r=(r=(r=_expandUnicodeEscapes(r=t.substring(n,e.start-1))).replace(RX.multipleSpaces," ")).substring(r.lastIndexOf(";")+1);var s=e.parsedSelector=e.selector=r.trim();e.atRule=0===s.indexOf(AT_START),e.atRule?0===s.indexOf(MEDIA_START)?e.type=types.MEDIA_RULE:s.match(RX.keyframesRule)&&(e.type=types.KEYFRAMES_RULE,e.keyframesName=e.selector.split(RX.multipleSpaces).pop()):0===s.indexOf(VAR_START)?e.type=types.MIXIN_RULE:e.type=types.STYLE_RULE}var o=e.rules;if(o)for(var a=0,i=o.length,l=void 0;a<i&&(l=o[a]);a++)parseCss(l,t);return e}function _expandUnicodeEscapes(e){return e.replace(/\\([0-9a-f]{1,6})\s/gi,(function(){for(var e=arguments[1],t=6-e.length;t--;)e="0"+e;return"\\"+e}))}var types={STYLE_RULE:1,KEYFRAMES_RULE:7,MEDIA_RULE:4,MIXIN_RULE:1e3},OPEN_BRACE="{",CLOSE_BRACE="}",RX={comments:/\/\*[^*]*\*+([^/*][^*]*\*+)*\//gim,port:/@import[^;]*;/gim,customProp:/(?:^[^;\-\s}]+)?--[^;{}]*?:[^{};]*?(?:[;\n]|$)/gim,mixinProp:/(?:^[^;\-\s}]+)?--[^;{}]*?:[^{};]*?{[^}]*?}(?:[;\n]|$)?/gim,mixinApply:/@apply\s*\(?[^);]*\)?\s*(?:[;\n]|$)?/gim,varApply:/[^;:]*?:[^;]*?var\([^;]*\)(?:[;\n]|$)?/gim,keyframesRule:/^@[^\s]*keyframes/,multipleSpaces:/\s+/g},VAR_START="--",MEDIA_START="@media",AT_START="@",VAR_USAGE_START=/\bvar\(/,VAR_ASSIGN_START=/\B--[\w-]+\s*:/,COMMENTS=/\/\*[^*]*\*+([^/*][^*]*\*+)*\//gim,TRAILING_LINES=/^[\t ]+\n/gm;function findRegex(e,t,r){e.lastIndex=0;var n=t.substring(r).match(e);if(n){var s=r+n.index;return{start:s,end:s+n[0].length}}return null}function resolveVar(e,t,r){return e[t]?e[t]:r?executeTemplate(r,e):""}function findVarEndIndex(e,t){for(var r=0,n=t;n<e.length;n++){var s=e[n];if("("===s)r++;else if(")"===s&&--r<=0)return n+1}return n}function parseVar(e,t){var r=findRegex(VAR_USAGE_START,e,t);if(!r)return null;var n=findVarEndIndex(e,r.start),s=e.substring(r.end,n-1).split(","),o=s[0],a=s.slice(1);return{start:r.start,end:n,propName:o.trim(),fallback:a.length>0?a.join(",").trim():void 0}}function compileVar(e,t,r){var n=parseVar(e,r);if(!n)return t.push(e.substring(r,e.length)),e.length;var s=n.propName,o=null!=n.fallback?compileTemplate(n.fallback):void 0;return t.push(e.substring(r,n.start),(function(e){return resolveVar(e,s,o)})),n.end}function executeTemplate(e,t){for(var r="",n=0;n<e.length;n++){var s=e[n];r+="string"==typeof s?s:s(t)}return r}function findEndValue(e,t){for(var r=!1,n=!1,s=t;s<e.length;s++){var o=e[s];if(r)n&&'"'===o&&(r=!1),n||"'"!==o||(r=!1);else if('"'===o)r=!0,n=!0;else if("'"===o)r=!0,n=!1;else{if(";"===o)return s+1;if("}"===o)return s}}return s}function removeCustomAssigns(e){for(var t="",r=0;;){var n=findRegex(VAR_ASSIGN_START,e,r),s=n?n.start:e.length;if(t+=e.substring(r,s),!n)break;r=findEndValue(e,s)}return t}function compileTemplate(e){var t=0;e=removeCustomAssigns(e=e.replace(COMMENTS,"")).replace(TRAILING_LINES,"");for(var r=[];t<e.length;)t=compileVar(e,r,t);return r}function resolveValues(e){var t={};e.forEach((function(e){e.declarations.forEach((function(e){t[e.prop]=e.value}))}));for(var r={},n=Object.entries(t),s=function(e){var t=!1;if(n.forEach((function(e){var n=e[0],s=executeTemplate(e[1],r);s!==r[n]&&(r[n]=s,t=!0)})),!t)return"break"},o=0;o<10;o++){if("break"===s())break}return r}function getSelectors(e,t){if(void 0===t&&(t=0),!e.rules)return[];var r=[];return e.rules.filter((function(e){return e.type===types.STYLE_RULE})).forEach((function(e){var n=getDeclarations(e.cssText);n.length>0&&e.parsedSelector.split(",").forEach((function(e){e=e.trim(),r.push({selector:e,declarations:n,specificity:computeSpecificity(),nu:t})})),t++})),r}function computeSpecificity(e){return 1}var IMPORTANT="!important",FIND_DECLARATIONS=/(?:^|[;\s{]\s*)(--[\w-]*?)\s*:\s*(?:((?:'(?:\\'|.)*?'|"(?:\\"|.)*?"|\([^)]*?\)|[^};{])+)|\{([^}]*)\}(?:(?=[;\s}])|$))/gm;function getDeclarations(e){for(var t,r=[];t=FIND_DECLARATIONS.exec(e.trim());){var n=normalizeValue(t[2]),s=n.value,o=n.important;r.push({prop:t[1].trim(),value:compileTemplate(s),important:o})}return r}function normalizeValue(e){var t=(e=e.replace(/\s+/gim," ").trim()).endsWith(IMPORTANT);return t&&(e=e.slice(0,e.length-IMPORTANT.length).trim()),{value:e,important:t}}function getActiveSelectors(e,t,r){var n=[],s=getScopesForElement(t,e);return r.forEach((function(e){return n.push(e)})),s.forEach((function(e){return n.push(e)})),sortSelectors(getSelectorsForScopes(n).filter((function(t){return matches(e,t.selector)})))}function getScopesForElement(e,t){for(var r=[];t;){var n=e.get(t);n&&r.push(n),t=t.parentElement}return r}function getSelectorsForScopes(e){var t=[];return e.forEach((function(e){t.push.apply(t,e.selectors)})),t}function sortSelectors(e){return e.sort((function(e,t){return e.specificity===t.specificity?e.nu-t.nu:e.specificity-t.specificity})),e}function matches(e,t){return":root"===t||"html"===t||e.matches(t)}function parseCSS(e){var t=parse(e),r=compileTemplate(e);return{original:e,template:r,selectors:getSelectors(t),usesCssVars:r.length>1}}function addGlobalStyle(e,t){if(e.some((function(e){return e.styleEl===t})))return!1;var r=parseCSS(t.textContent);return r.styleEl=t,e.push(r),!0}function updateGlobalScopes(e){var t=resolveValues(getSelectorsForScopes(e));e.forEach((function(e){e.usesCssVars&&(e.styleEl.textContent=executeTemplate(e.template,t))}))}function reScope(e,t){var r=e.template.map((function(r){return"string"==typeof r?replaceScope(r,e.scopeId,t):r})),n=e.selectors.map((function(r){return __assign(__assign({},r),{selector:replaceScope(r.selector,e.scopeId,t)})}));return __assign(__assign({},e),{template:r,selectors:n,scopeId:t})}function replaceScope(e,t,r){return e=replaceAll(e,"\\.".concat(t),".".concat(r))}function replaceAll(e,t,r){return e.replace(new RegExp(t,"g"),r)}function loadDocument(e,t){return loadDocumentStyles(e,t),loadDocumentLinks(e,t).then((function(){updateGlobalScopes(t)}))}function startWatcher(e,t){"undefined"!=typeof MutationObserver&&new MutationObserver((function(){loadDocumentStyles(e,t)&&updateGlobalScopes(t)})).observe(document.head,{childList:!0})}function loadDocumentLinks(e,t){for(var r=[],n=e.querySelectorAll('link[rel="stylesheet"][href]:not([data-no-shim])'),s=0;s<n.length;s++)r.push(addGlobalLink(e,t,n[s]));return Promise.all(r)}function loadDocumentStyles(e,t){return Array.from(e.querySelectorAll("style:not([data-styles]):not([data-no-shim])")).map((function(e){return addGlobalStyle(t,e)})).some(Boolean)}function addGlobalLink(e,t,r){var n=r.href;return fetch(n).then((function(e){return e.text()})).then((function(s){if(hasCssVariables(s)&&r.parentNode){hasRelativeUrls(s)&&(s=fixRelativeUrls(s,n));var o=e.createElement("style");o.setAttribute("data-styles",""),o.textContent=s,addGlobalStyle(t,o),r.parentNode.insertBefore(o,r),r.remove()}})).catch((function(e){console.error(e)}))}var CSS_VARIABLE_REGEXP=/[\s;{]--[-a-zA-Z0-9]+\s*:/m;function hasCssVariables(e){return e.indexOf("var(")>-1||CSS_VARIABLE_REGEXP.test(e)}var CSS_URL_REGEXP=/url[\s]*\([\s]*['"]?(?!(?:https?|data)\:|\/)([^\'\"\)]*)[\s]*['"]?\)[\s]*/gim;function hasRelativeUrls(e){return CSS_URL_REGEXP.lastIndex=0,CSS_URL_REGEXP.test(e)}function fixRelativeUrls(e,t){var r=t.replace(/[^/]*$/,"");return e.replace(CSS_URL_REGEXP,(function(e,t){var n=r+t;return e.replace(t,n)}))}var CustomStyle=function(){function e(e,t){this.win=e,this.doc=t,this.count=0,this.hostStyleMap=new WeakMap,this.hostScopeMap=new WeakMap,this.globalScopes=[],this.scopesMap=new Map,this.didInit=!1}return e.prototype.i=function(){var e=this;return this.didInit||!this.win.requestAnimationFrame?Promise.resolve():(this.didInit=!0,new Promise((function(t){e.win.requestAnimationFrame((function(){startWatcher(e.doc,e.globalScopes),loadDocument(e.doc,e.globalScopes).then((function(){return t()}))}))})))},e.prototype.addLink=function(e){var t=this;return addGlobalLink(this.doc,this.globalScopes,e).then((function(){t.updateGlobal()}))},e.prototype.addGlobalStyle=function(e){addGlobalStyle(this.globalScopes,e)&&this.updateGlobal()},e.prototype.createHostStyle=function(e,t,r,n){if(this.hostScopeMap.has(e))throw new Error("host style already created");var s=this.registerHostTemplate(r,t,n),o=this.doc.createElement("style");return o.setAttribute("data-no-shim",""),s.usesCssVars?n?(o["s-sc"]=t="".concat(s.scopeId,"-").concat(this.count),o.textContent="/*needs update*/",this.hostStyleMap.set(e,o),this.hostScopeMap.set(e,reScope(s,t)),this.count++):(s.styleEl=o,s.usesCssVars||(o.textContent=executeTemplate(s.template,{})),this.globalScopes.push(s),this.updateGlobal(),this.hostScopeMap.set(e,s)):o.textContent=r,o},e.prototype.removeHost=function(e){var t=this.hostStyleMap.get(e);t&&t.remove(),this.hostStyleMap.delete(e),this.hostScopeMap.delete(e)},e.prototype.updateHost=function(e){var t=this.hostScopeMap.get(e);if(t&&t.usesCssVars&&t.isScoped){var r=this.hostStyleMap.get(e);if(r){var n=resolveValues(getActiveSelectors(e,this.hostScopeMap,this.globalScopes));r.textContent=executeTemplate(t.template,n)}}},e.prototype.updateGlobal=function(){updateGlobalScopes(this.globalScopes)},e.prototype.registerHostTemplate=function(e,t,r){var n=this.scopesMap.get(t);return n||((n=parseCSS(e)).scopeId=t,n.isScoped=r,this.scopesMap.set(t,n)),n},e}();!function(e){!e||e.__cssshim||e.CSS&&e.CSS.supports&&e.CSS.supports("color","var(--c)")||(e.__cssshim=new CustomStyle(e,e.document))}("undefined"!=typeof window&&window);
+var __assign=this&&this.__assign||function(){return __assign=Object.assign||function(e){for(var t,r=1,n=arguments.length;r<n;r++)for(var s in t=arguments[r])Object.prototype.hasOwnProperty.call(t,s)&&(e[s]=t[s]);return e},__assign.apply(this,arguments)},StyleNode=function(){this.start=0,this.end=0,this.previous=null,this.parent=null,this.rules=null,this.parsedCssText="",this.cssText="",this.atRule=!1,this.type=0,this.keyframesName="",this.selector="",this.parsedSelector=""};function parse(e){return parseCss(lex(e=clean(e)),e)}function clean(e){return e.replace(RX.comments,"").replace(RX.port,"")}function lex(e){var t=new StyleNode;t.start=0,t.end=e.length;for(var r=t,n=0,s=e.length;n<s;n++)if(e[n]===OPEN_BRACE){r.rules||(r.rules=[]);var o=r,a=o.rules[o.rules.length-1]||null;(r=new StyleNode).start=n+1,r.parent=o,r.previous=a,o.rules.push(r)}else e[n]===CLOSE_BRACE&&(r.end=n+1,r=r.parent||t);return t}function parseCss(e,t){var r=t.substring(e.start,e.end-1);if(e.parsedCssText=e.cssText=r.trim(),e.parent){var n=e.previous?e.previous.end:e.parent.start;r=(r=(r=_expandUnicodeEscapes(r=t.substring(n,e.start-1))).replace(RX.multipleSpaces," ")).substring(r.lastIndexOf(";")+1);var s=e.parsedSelector=e.selector=r.trim();e.atRule=0===s.indexOf(AT_START),e.atRule?0===s.indexOf(MEDIA_START)?e.type=types.MEDIA_RULE:s.match(RX.keyframesRule)&&(e.type=types.KEYFRAMES_RULE,e.keyframesName=e.selector.split(RX.multipleSpaces).pop()):0===s.indexOf(VAR_START)?e.type=types.MIXIN_RULE:e.type=types.STYLE_RULE}var o=e.rules;if(o)for(var a=0,i=o.length,l=void 0;a<i&&(l=o[a]);a++)parseCss(l,t);return e}function _expandUnicodeEscapes(e){return e.replace(/\\([0-9a-f]{1,6})\s/gi,(function(){for(var e=arguments[1],t=6-e.length;t--;)e="0"+e;return"\\"+e}))}var types={STYLE_RULE:1,KEYFRAMES_RULE:7,MEDIA_RULE:4,MIXIN_RULE:1e3},OPEN_BRACE="{",CLOSE_BRACE="}",RX={comments:/\/\*[^*]*\*+([^/*][^*]*\*+)*\//gim,port:/@import[^;]*;/gim,customProp:/(?:^[^;\-\s}]+)?--[^;{}]*?:[^{};]*?(?:[;\n]|$)/gim,mixinProp:/(?:^[^;\-\s}]+)?--[^;{}]*?:[^{};]*?{[^}]*?}(?:[;\n]|$)?/gim,mixinApply:/@apply\s*\(?[^);]*\)?\s*(?:[;\n]|$)?/gim,varApply:/[^;:]*?:[^;]*?var\([^;]*\)(?:[;\n]|$)?/gim,keyframesRule:/^@[^\s]*keyframes/,multipleSpaces:/\s+/g},VAR_START="--",MEDIA_START="@media",AT_START="@",VAR_USAGE_START=/\bvar\(/,VAR_ASSIGN_START=/\B--[\w-]+\s*:/,COMMENTS=/\/\*[^*]*\*+([^/*][^*]*\*+)*\//gim,TRAILING_LINES=/^[\t ]+\n/gm;function findRegex(e,t,r){e.lastIndex=0;var n=t.substring(r).match(e);if(n){var s=r+n.index;return{start:s,end:s+n[0].length}}return null}function resolveVar(e,t,r){return e[t]?e[t]:r?executeTemplate(r,e):""}function findVarEndIndex(e,t){for(var r=0,n=t;n<e.length;n++){var s=e[n];if("("===s)r++;else if(")"===s&&--r<=0)return n+1}return n}function parseVar(e,t){var r=findRegex(VAR_USAGE_START,e,t);if(!r)return null;var n=findVarEndIndex(e,r.start),s=e.substring(r.end,n-1).split(","),o=s[0],a=s.slice(1);return{start:r.start,end:n,propName:o.trim(),fallback:a.length>0?a.join(",").trim():void 0}}function compileVar(e,t,r){var n=parseVar(e,r);if(!n)return t.push(e.substring(r,e.length)),e.length;var s=n.propName,o=null!=n.fallback?compileTemplate(n.fallback):void 0;return t.push(e.substring(r,n.start),(function(e){return resolveVar(e,s,o)})),n.end}function executeTemplate(e,t){for(var r="",n=0;n<e.length;n++){var s=e[n];r+="string"==typeof s?s:s(t)}return r}function findEndValue(e,t){for(var r=!1,n=!1,s=t;s<e.length;s++){var o=e[s];if(r)n&&'"'===o&&(r=!1),n||"'"!==o||(r=!1);else if('"'===o)r=!0,n=!0;else if("'"===o)r=!0,n=!1;else{if(";"===o)return s+1;if("}"===o)return s}}return s}function removeCustomAssigns(e){for(var t="",r=0;;){var n=findRegex(VAR_ASSIGN_START,e,r),s=n?n.start:e.length;if(t+=e.substring(r,s),!n)break;r=findEndValue(e,s)}return t}function compileTemplate(e){var t=0;e=removeCustomAssigns(e=e.replace(COMMENTS,"")).replace(TRAILING_LINES,"");for(var r=[];t<e.length;)t=compileVar(e,r,t);return r}function resolveValues(e){var t={};e.forEach((function(e){e.declarations.forEach((function(e){t[e.prop]=e.value}))}));for(var r={},n=Object.entries(t),s=function(e){var t=!1;if(n.forEach((function(e){var n=e[0],s=executeTemplate(e[1],r);s!==r[n]&&(r[n]=s,t=!0)})),!t)return"break"},o=0;o<10;o++){if("break"===s())break}return r}function getSelectors(e,t){if(void 0===t&&(t=0),!e.rules)return[];var r=[];return e.rules.filter((function(e){return e.type===types.STYLE_RULE})).forEach((function(e){var n=getDeclarations(e.cssText);n.length>0&&e.parsedSelector.split(",").forEach((function(e){e=e.trim(),r.push({selector:e,declarations:n,specificity:computeSpecificity(),nu:t})})),t++})),r}function computeSpecificity(e){return 1}var IMPORTANT="!important",FIND_DECLARATIONS=/(?:^|[;\s{]\s*)(--[\w-]*?)\s*:\s*(?:((?:'(?:\\'|.)*?'|"(?:\\"|.)*?"|\([^)]*?\)|[^};{])+)|\{([^}]*)\}(?:(?=[;\s}])|$))/gm;function getDeclarations(e){for(var t,r=[];t=FIND_DECLARATIONS.exec(e.trim());){var n=normalizeValue(t[2]),s=n.value,o=n.important;r.push({prop:t[1].trim(),value:compileTemplate(s),important:o})}return r}function normalizeValue(e){var t=(e=e.replace(/\s+/gim," ").trim()).endsWith(IMPORTANT);return t&&(e=e.slice(0,e.length-IMPORTANT.length).trim()),{value:e,important:t}}function getActiveSelectors(e,t,r){var n=[],s=getScopesForElement(t,e);return r.forEach((function(e){return n.push(e)})),s.forEach((function(e){return n.push(e)})),sortSelectors(getSelectorsForScopes(n).filter((function(t){return matches(e,t.selector)})))}function getScopesForElement(e,t){for(var r=[];t;){var n=e.get(t);n&&r.push(n),t=t.parentElement}return r}function getSelectorsForScopes(e){var t=[];return e.forEach((function(e){t.push.apply(t,e.selectors)})),t}function sortSelectors(e){return e.sort((function(e,t){return e.specificity===t.specificity?e.nu-t.nu:e.specificity-t.specificity})),e}function matches(e,t){return":root"===t||"html"===t||e.matches(t)}function parseCSS(e){var t=parse(e),r=compileTemplate(e);return{original:e,template:r,selectors:getSelectors(t),usesCssVars:r.length>1}}function addGlobalStyle(e,t){if(e.some((function(e){return e.styleEl===t})))return!1;var r=parseCSS(t.textContent);return r.styleEl=t,e.push(r),!0}function updateGlobalScopes(e){var t=resolveValues(getSelectorsForScopes(e));e.forEach((function(e){e.usesCssVars&&(e.styleEl.textContent=executeTemplate(e.template,t))}))}function reScope(e,t){var r=e.template.map((function(r){return"string"==typeof r?replaceScope(r,e.scopeId,t):r})),n=e.selectors.map((function(r){return __assign(__assign({},r),{selector:replaceScope(r.selector,e.scopeId,t)})}));return __assign(__assign({},e),{template:r,selectors:n,scopeId:t})}function replaceScope(e,t,r){return e=replaceAll(e,"\\.".concat(t),".".concat(r))}function replaceAll(e,t,r){return e.replace(new RegExp(t,"g"),r)}function loadDocument(e,t){return loadDocumentStyles(e,t),loadDocumentLinks(e,t).then((function(){updateGlobalScopes(t)}))}function startWatcher(e,t){"undefined"!=typeof MutationObserver&&new MutationObserver((function(){loadDocumentStyles(e,t)&&updateGlobalScopes(t)})).observe(document.head,{childList:!0})}function loadDocumentLinks(e,t){for(var r=[],n=e.querySelectorAll('link[rel="stylesheet"][href]:not([data-no-shim])'),s=0;s<n.length;s++)r.push(addGlobalLink(e,t,n[s]));return Promise.all(r)}function loadDocumentStyles(e,t){return Array.from(e.querySelectorAll("style:not([data-styles]):not([data-no-shim])")).map((function(e){return addGlobalStyle(t,e)})).some(Boolean)}function addGlobalLink(e,t,r){var n=r.href;return fetch(n).then((function(e){return e.text()})).then((function(s){if(hasCssVariables(s)&&r.parentNode){hasRelativeUrls(s)&&(s=fixRelativeUrls(s,n));var o=e.createElement("style");o.setAttribute("data-styles",""),o.textContent=s,addGlobalStyle(t,o),r.parentNode.insertBefore(o,r),r.remove()}})).catch((function(e){console.error(e)}))}var CSS_VARIABLE_REGEXP=/[\s;{]--[-a-zA-Z0-9]+\s*:/m;function hasCssVariables(e){return e.indexOf("var(")>-1||CSS_VARIABLE_REGEXP.test(e)}var CSS_URL_REGEXP=/url[\s]*\([\s]*['"]?(?!(?:https?|data)\:|\/)([^\'\"\)]*)[\s]*['"]?\)[\s]*/gim;function hasRelativeUrls(e){return CSS_URL_REGEXP.lastIndex=0,CSS_URL_REGEXP.test(e)}function fixRelativeUrls(e,t){var r=t.replace(/[^/]*$/,"");return e.replace(CSS_URL_REGEXP,(function(e,t){var n=r+t;return e.replace(t,n)}))}var CustomStyle=function(){function e(e,t){this.win=e,this.doc=t,this.count=0,this.hostStyleMap=new WeakMap,this.hostScopeMap=new WeakMap,this.globalScopes=[],this.scopesMap=new Map,this.didInit=!1}return e.prototype.i=function(){var e=this;return this.didInit||!this.win.requestAnimationFrame?Promise.resolve():(this.didInit=!0,new Promise((function(t){e.win.requestAnimationFrame((function(){startWatcher(e.doc,e.globalScopes),loadDocument(e.doc,e.globalScopes).then((function(){return t()}))}))})))},e.prototype.addLink=function(e){var t=this;return addGlobalLink(this.doc,this.globalScopes,e).then((function(){t.updateGlobal()}))},e.prototype.addGlobalStyle=function(e){addGlobalStyle(this.globalScopes,e)&&this.updateGlobal()},e.prototype.createHostStyle=function(e,t,r,n){if(this.hostScopeMap.has(e))throw new Error("host style already created");var s=this.registerHostTemplate(r,t,n),o=this.doc.createElement("style");return o.setAttribute("data-no-shim",""),s.usesCssVars?n?(o["s-sc"]=t="".concat(s.scopeId,"-").concat(this.count),o.textContent="/*needs update*/",this.hostStyleMap.set(e,o),this.hostScopeMap.set(e,reScope(s,t)),this.count++):(s.styleEl=o,s.usesCssVars||(o.textContent=executeTemplate(s.template,{})),this.globalScopes.push(s),this.updateGlobal(),this.hostScopeMap.set(e,s)):o.textContent=r,o},e.prototype.removeHost=function(e){var t=this.hostStyleMap.get(e);t&&t.remove(),this.hostStyleMap.delete(e),this.hostScopeMap.delete(e)},e.prototype.updateHost=function(e){var t=this.hostScopeMap.get(e);if(t&&t.usesCssVars&&t.isScoped){var r=this.hostStyleMap.get(e);if(r){var n=resolveValues(getActiveSelectors(e,this.hostScopeMap,this.globalScopes));r.textContent=executeTemplate(t.template,n)}}},e.prototype.updateGlobal=function(){updateGlobalScopes(this.globalScopes)},e.prototype.registerHostTemplate=function(e,t,r){var n=this.scopesMap.get(t);return n||((n=parseCSS(e)).scopeId=t,n.isScoped=r,this.scopesMap.set(t,n)),n},e}();!function(e){!e||e.__cssshim||e.CSS&&e.CSS.supports&&e.CSS.supports("color","var(--c)")||(e.__cssshim=new CustomStyle(e,e.document))}("undefined"!=typeof window&&window);

package/internal/client/shadow-css.js

@@ -1,5 +1,5 @@
 /*
- Stencil Client Platform v2.20.0 | MIT Licensed | https://stenciljs.com
+ Stencil Client Platform v2.21.0 | MIT Licensed | https://stenciljs.com
  */
 /**
  * @license

package/internal/hydrate/index.js

@@ -116,8 +116,8 @@ function hydrateApp(e, t, o, n, s) {
    const t = Array.from(i).filter((e => e.parentElement));
    return t.length > 0 ? Promise.all(t.map(g)).then(e) : m;
   }().then(l).catch(a);
- } catch (e) {
-  a(e);
+ } catch (y) {
+  a(y);
  }
 }
 

package/internal/hydrate/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/internal/hydrate",
-  "version": "2.20.0",
+  "version": "2.21.0",
   "description": "Stencil internal hydrate platform to be imported by the Stencil Compiler. Breaking changes can and will happen at any time.",
   "main": "./index.js",
   "private": true

package/internal/hydrate/runner.js

@@ -442,12 +442,12 @@ const templateWindows = new Map, isPromise = e => !!e && ("object" == typeof e |
  }, d = () => {
   let t;
   const r = [];
-  for (m(), h(r); e.length && "}" !== e.charAt(0) && (t = w() || A()); ) !1 !== t && (r.push(t), 
-  h(r));
+  for (m(), h(r); e.length && "}" !== e.charAt(0) && (t = w() || A()); ) r.push(t), 
+  h(r);
   return r;
  }, m = () => u(/^\s*/), h = e => {
   let t;
-  for (e = e || []; t = p(); ) !1 !== t && e.push(t);
+  for (e = e || []; t = p(); ) e.push(t);
   return e;
  }, p = () => {
   const t = i();
@@ -482,7 +482,7 @@ const templateWindows = new Map, isPromise = e => !!e && ("object" == typeof e |
   const e = [];
   if (!l()) return a("missing '{'");
   let t;
-  for (h(e); t = g(); ) !1 !== t && (e.push(t), h(e));
+  for (h(e); t = g(); ) e.push(t), h(e);
   return c() ? e : a("missing '}'");
  }, C = () => {
   let e;

package/internal/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/internal",
-  "version": "2.20.0",
+  "version": "2.21.0",
   "description": "Stencil internals only to be imported by the Stencil Compiler. Breaking changes can and will happen at any time.",
   "main": "./index.js",
   "types": "./index.d.ts",

package/internal/stencil-private.d.ts

@@ -132,7 +132,7 @@ export interface BuildConditionals extends Partial<BuildFeatures> {
     transformTagName?: boolean;
     attachStyles?: boolean;
 }
-export declare type ModuleFormat = 'amd' | 'cjs' | 'es' | 'iife' | 'system' | 'umd' | 'commonjs' | 'esm' | 'module' | 'systemjs';
+export type ModuleFormat = 'amd' | 'cjs' | 'es' | 'iife' | 'system' | 'umd' | 'commonjs' | 'esm' | 'module' | 'systemjs';
 export interface RollupResultModule {
     id: string;
 }
@@ -211,8 +211,8 @@ export interface BuildStyleUpdate {
     styleText: string;
     styleMode: string;
 }
-export declare type BuildTask = any;
-export declare type BuildStatus = 'pending' | 'error' | 'disabled' | 'default';
+export type BuildTask = any;
+export type BuildStatus = 'pending' | 'error' | 'disabled' | 'default';
 export interface CompilerBuildStats {
     timestamp: string;
     compiler: {
@@ -303,7 +303,7 @@ export interface BundleOutputChunk {
     };
     name: string;
 }
-export declare type SourceTarget = 'es5' | 'es2017' | 'latest';
+export type SourceTarget = 'es5' | 'es2017' | 'latest';
 export interface BundleEntryInputs {
     [entryKey: string]: string;
 }
@@ -313,7 +313,7 @@ export interface BundleEntryInputs {
  * Stencil source. As a result, some types are duplicated here for Rollup that will be used within the codebase.
  * Updates to rollup may require these typings to be updated.
  */
-export declare type RollupResult = RollupChunkResult | RollupAssetResult;
+export type RollupResult = RollupChunkResult | RollupAssetResult;
 export interface RollupAssetResult {
     type: 'asset';
     fileName: string;
@@ -346,7 +346,7 @@ export interface RollupSourceMap {
 /**
  * Result of Stencil compressing, mangling, and otherwise 'minifying' JavaScript
  */
-export declare type OptimizeJsResult = {
+export type OptimizeJsResult = {
     output: string;
     diagnostics: Diagnostic[];
     sourceMap?: SourceMap;
@@ -399,7 +399,7 @@ export interface CollectionManifest {
     compiler?: CollectionCompilerVersion;
     bundles?: CollectionBundleManifest[];
 }
-export declare type CollectionComponentEntryPath = string;
+export type CollectionComponentEntryPath = string;
 export interface CollectionBundleManifest {
     components: string[];
 }
@@ -549,8 +549,8 @@ export interface BuildOutputFile {
     name: string;
     content: string;
 }
-export declare type OnCallback = (buildStart: CompilerBuildStart) => void;
-export declare type RemoveCallback = () => boolean;
+export type OnCallback = (buildStart: CompilerBuildStart) => void;
+export type RemoveCallback = () => boolean;
 export interface CompilerCtx {
     version: number;
     activeBuildId: number;
@@ -584,7 +584,7 @@ export interface CompilerCtx {
     rollupCache: Map<string, any>;
     reset(): void;
 }
-export declare type NodeMap = WeakMap<any, ComponentCompilerMeta>;
+export type NodeMap = WeakMap<any, ComponentCompilerMeta>;
 /** Must be serializable to JSON!! */
 export interface ComponentCompilerFeatures {
     hasAttribute: boolean;
@@ -681,7 +681,7 @@ export interface ComponentCompilerLegacyContext {
     name: string;
     context: string;
 }
-export declare type Encapsulation = 'shadow' | 'scoped' | 'none';
+export type Encapsulation = 'shadow' | 'scoped' | 'none';
 /**
  * Intermediate Representation (IR) of a static property on a Stencil component
  */
@@ -708,7 +708,7 @@ export interface ComponentCompilerVirtualProperty {
     type: string;
     docs: string;
 }
-export declare type ComponentCompilerPropertyType = 'any' | 'string' | 'boolean' | 'number' | 'unknown';
+export type ComponentCompilerPropertyType = 'any' | 'string' | 'boolean' | 'number' | 'unknown';
 export interface ComponentCompilerPropertyComplexType {
     original: string;
     resolved: string;
@@ -722,7 +722,7 @@ export interface ComponentCompilerPropertyComplexType {
  *
  * Note any key can be a user defined type or a TypeScript standard type.
  */
-export declare type ComponentCompilerTypeReferences = Record<string, ComponentCompilerTypeReference>;
+export type ComponentCompilerTypeReferences = Record<string, ComponentCompilerTypeReference>;
 /**
  * Describes a reference to a type used by a component.
  */
@@ -862,7 +862,7 @@ export interface ComponentTestingConstructor extends ComponentConstructor {
 export interface ComponentNativeConstructor extends ComponentConstructor {
     cmpMeta: ComponentRuntimeMeta;
 }
-export declare type ComponentConstructorEncapsulation = 'shadow' | 'scoped' | 'none';
+export type ComponentConstructorEncapsulation = 'shadow' | 'scoped' | 'none';
 export interface ComponentConstructorProperties {
     [propName: string]: ComponentConstructorProperty;
 }
@@ -876,7 +876,7 @@ export interface ComponentConstructorProperty {
     type?: ComponentConstructorPropertyType;
     watchCallbacks?: string[];
 }
-export declare type ComponentConstructorPropertyType = StringConstructor | BooleanConstructor | NumberConstructor | 'string' | 'boolean' | 'number';
+export type ComponentConstructorPropertyType = StringConstructor | BooleanConstructor | NumberConstructor | 'string' | 'boolean' | 'number';
 export interface ComponentConstructorEvent {
     name: string;
     method: string;
@@ -961,7 +961,7 @@ export interface DevServerMessage {
         status: number;
     };
 }
-export declare type DevServerSendMessage = (msg: DevServerMessage) => void;
+export type DevServerSendMessage = (msg: DevServerMessage) => void;
 export interface DevServerContext {
     connectorHtml: string;
     dirTemplate: string;
@@ -975,7 +975,7 @@ export interface DevServerContext {
     serve500: (req: any, res: any, error: any, xSource: string) => void;
     sys: CompilerSystem;
 }
-export declare type InitServerProcess = (sendMsg: (msg: DevServerMessage) => void) => (msg: DevServerMessage) => void;
+export type InitServerProcess = (sendMsg: (msg: DevServerMessage) => void) => (msg: DevServerMessage) => void;
 export interface DevResponseHeaders {
     'cache-control'?: string;
     expires?: string;
@@ -1155,7 +1155,7 @@ export interface MinifyJsResult {
         pos: number;
     };
 }
-export declare type ModuleMap = Map<string, Module>;
+export type ModuleMap = Map<string, Module>;
 /**
  * Stencil's Intermediate Representation (IR) of a module, bundling together
  * various pieces of information like the classes declared within it, the path
@@ -1320,13 +1320,13 @@ export interface RenderNode extends HostElement {
      */
     ['s-en']?: '' | /*shadow*/ 'c';
 }
-export declare type LazyBundlesRuntimeData = LazyBundleRuntimeData[];
-export declare type LazyBundleRuntimeData = [
+export type LazyBundlesRuntimeData = LazyBundleRuntimeData[];
+export type LazyBundleRuntimeData = [
     /** bundleIds */
     string,
     ComponentRuntimeMetaCompact[]
 ];
-export declare type ComponentRuntimeMetaCompact = [
+export type ComponentRuntimeMetaCompact = [
     /** flags */
     number,
     /** tagname */
@@ -1392,7 +1392,7 @@ export interface ComponentRuntimeMembers {
  * this is intended to store are documented in the {@link MEMBER_FLAGS} enum.
  * 2. The attribute name to observe.
  */
-export declare type ComponentRuntimeMember = [number, string?];
+export type ComponentRuntimeMember = [number, string?];
 /**
  * A tuple holding information about a host listener which is relevant at
  * runtime. The field are:
@@ -1402,7 +1402,7 @@ export declare type ComponentRuntimeMember = [number, string?];
  * 2. The event name.
  * 3. The method name.
  */
-export declare type ComponentRuntimeHostListener = [number, string, string];
+export type ComponentRuntimeHostListener = [number, string, string];
 /**
  * A tuple containing information about props which are "reflected" at runtime,
  * meaning that HTML attributes on the component instance are kept in sync with
@@ -1413,12 +1413,12 @@ export declare type ComponentRuntimeHostListener = [number, string, string];
  * 1. the prop name
  * 2. the prop attribute.
  */
-export declare type ComponentRuntimeReflectingAttr = [string, string | undefined];
-export declare type ModeBundleId = ModeBundleIds | string;
+export type ComponentRuntimeReflectingAttr = [string, string | undefined];
+export type ModeBundleId = ModeBundleIds | string;
 export interface ModeBundleIds {
     [modeName: string]: string;
 }
-export declare type RuntimeRef = HostElement | {};
+export type RuntimeRef = HostElement | {};
 /**
  * Interface used to track an Element, it's virtual Node (`VNode`), and other data
  */
@@ -1451,11 +1451,11 @@ export interface PlatformRuntime {
     rel: (el: EventTarget, eventName: string, listener: EventListenerOrEventListenerObject, options: boolean | AddEventListenerOptions) => void;
     ce: (eventName: string, opts?: any) => CustomEvent;
 }
-export declare type RefMap = WeakMap<any, HostRef>;
-export declare type StyleMap = Map<string, CSSStyleSheet | string>;
-export declare type RootAppliedStyleMap = WeakMap<Element, Set<string>>;
-export declare type AppliedStyleMap = Set<string>;
-export declare type ActivelyProcessingCmpMap = Set<Element>;
+export type RefMap = WeakMap<any, HostRef>;
+export type StyleMap = Map<string, CSSStyleSheet | string>;
+export type RootAppliedStyleMap = WeakMap<Element, Set<string>>;
+export type AppliedStyleMap = Set<string>;
+export type ActivelyProcessingCmpMap = Set<Element>;
 export interface ScreenshotConnector {
     initBuild(opts: ScreenshotConnectorOptions): Promise<void>;
     completeBuild(masterBuild: ScreenshotBuild): Promise<ScreenshotBuildResults>;
@@ -2106,7 +2106,7 @@ export interface TypesModule {
     jsx: string;
     element: string;
 }
-export declare type TypeInfo = {
+export type TypeInfo = {
     name: string;
     type: string;
     optional: boolean;
@@ -2124,8 +2124,8 @@ export interface Hyperscript {
     (sel: any, data: VNodeData, children: Array<VNode | undefined | null>): VNode;
     (sel: any, data: VNodeData, children: VNode): VNode;
 }
-export declare type ChildType = VNode | number | string;
-export declare type PropsType = VNodeProdData | number | string | null;
+export type ChildType = VNode | number | string;
+export type PropsType = VNodeProdData | number | string | null;
 export interface VNodeProdData {
     key?: string | number;
     class?: {
@@ -2163,7 +2163,7 @@ export interface CompilerWorkerTask {
     reject: (msg: string) => any;
     retries?: number;
 }
-export declare type WorkerMsgHandler = (msgToWorker: MsgToWorker) => Promise<any>;
+export type WorkerMsgHandler = (msgToWorker: MsgToWorker) => Promise<any>;
 export interface WorkerTask {
     taskId: number;
     method: string;
@@ -2182,7 +2182,7 @@ export interface WorkerMessage {
     error?: string;
     exit?: boolean;
 }
-export declare type WorkerRunner = (methodName: string, args: any[]) => Promise<any>;
+export type WorkerRunner = (methodName: string, args: any[]) => Promise<any>;
 export interface WorkerRunnerOptions {
     isLongRunningTask?: boolean;
     workerKey?: string;
@@ -2216,7 +2216,7 @@ export interface TerminalInfo {
 /**
  * The task to run in order to collect the duration data point.
  */
-export declare type TelemetryCallback = (...args: any[]) => void | Promise<void>;
+export type TelemetryCallback = (...args: any[]) => void | Promise<void>;
 /**
  * The model for the data that's tracked.
  */

package/internal/stencil-public-compiler.d.ts

@@ -351,12 +351,12 @@ export interface Config extends StencilConfig {
  * conforming to a given interface. For best results, pair with a validation
  * function as shown in the example.
  */
-declare type Loose<T extends Object> = Record<string, any> & Partial<T>;
+type Loose<T extends Object> = Record<string, any> & Partial<T>;
 /**
  * A Loose version of the Config interface. This is intended to let us load a partial config
  * and have type information carry though as we construct an object which is a valid `Config`.
  */
-export declare type UnvalidatedConfig = Loose<Config>;
+export type UnvalidatedConfig = Loose<Config>;
 /**
  * Helper type to strip optional markers from keys in a type, while preserving other type information for the key.
  * This type takes a union of keys, K, in type T to allow for the type T to be gradually updated.
@@ -366,20 +366,20 @@ export declare type UnvalidatedConfig = Loose<Config>;
  * type ReqFieldFoo = RequireFields<Foo, 'bar'>; // { bar: number, baz?: string }
  * ```
  */
-declare type RequireFields<T, K extends keyof T> = T & {
+type RequireFields<T, K extends keyof T> = T & {
     [P in K]-?: T[P];
 };
 /**
  * Fields in {@link Config} to make required for {@link ValidatedConfig}
  */
-declare type StrictConfigFields = 'flags' | 'logger' | 'outputTargets' | 'rootDir' | 'sys' | 'testing';
+type StrictConfigFields = 'flags' | 'logger' | 'outputTargets' | 'rootDir' | 'sys' | 'testing';
 /**
  * A version of {@link Config} that makes certain fields required. This type represents a valid configuration entity.
  * When a configuration is received by the user, it is a bag of unverified data. In order to make stricter guarantees
  * about the data from a type-safety perspective, this type is intended to be used throughout the codebase once
  * validations have occurred at runtime.
  */
-export declare type ValidatedConfig = RequireFields<Config, StrictConfigFields>;
+export type ValidatedConfig = RequireFields<Config, StrictConfigFields>;
 export interface HydratedFlag {
     /**
      * Defaults to `hydrated`.
@@ -533,8 +533,8 @@ export interface DevServerEditor {
     supported?: boolean;
     priority?: number;
 }
-export declare type TaskCommand = 'build' | 'docs' | 'generate' | 'g' | 'help' | 'info' | 'prerender' | 'serve' | 'telemetry' | 'test' | 'version';
-export declare type PageReloadStrategy = 'hmr' | 'pageReload' | null;
+export type TaskCommand = 'build' | 'docs' | 'generate' | 'g' | 'help' | 'info' | 'prerender' | 'serve' | 'telemetry' | 'test' | 'version';
+export type PageReloadStrategy = 'hmr' | 'pageReload' | null;
 /**
  * The prerender config is used when prerendering a `www` output target.
  * Within `stencil.config.ts`, set the path to the prerendering
@@ -1225,7 +1225,7 @@ export interface HmrStyleUpdate {
     styleTag: string;
     styleText: string;
 }
-export declare type BuildOnEventRemove = () => boolean;
+export type BuildOnEventRemove = () => boolean;
 export interface BuildEvents extends BuildOnEvents, BuildEmitEvents {
     unsubscribeAll(): void;
 }
@@ -1233,19 +1233,19 @@ export interface CompilerBuildStart {
     buildId: number;
     timestamp: string;
 }
-export declare type CompilerFileWatcherCallback = (fileName: string, eventKind: CompilerFileWatcherEvent) => void;
-export declare type CompilerFileWatcherEvent = CompilerEventFileAdd | CompilerEventFileDelete | CompilerEventFileUpdate | CompilerEventDirAdd | CompilerEventDirDelete;
-export declare type CompilerEventName = CompilerEventFsChange | CompilerEventFileUpdate | CompilerEventFileAdd | CompilerEventFileDelete | CompilerEventDirAdd | CompilerEventDirDelete | CompilerEventBuildStart | CompilerEventBuildFinish | CompilerEventBuildNoChange | CompilerEventBuildLog;
-export declare type CompilerEventFsChange = 'fsChange';
-export declare type CompilerEventFileUpdate = 'fileUpdate';
-export declare type CompilerEventFileAdd = 'fileAdd';
-export declare type CompilerEventFileDelete = 'fileDelete';
-export declare type CompilerEventDirAdd = 'dirAdd';
-export declare type CompilerEventDirDelete = 'dirDelete';
-export declare type CompilerEventBuildStart = 'buildStart';
-export declare type CompilerEventBuildFinish = 'buildFinish';
-export declare type CompilerEventBuildLog = 'buildLog';
-export declare type CompilerEventBuildNoChange = 'buildNoChange';
+export type CompilerFileWatcherCallback = (fileName: string, eventKind: CompilerFileWatcherEvent) => void;
+export type CompilerFileWatcherEvent = CompilerEventFileAdd | CompilerEventFileDelete | CompilerEventFileUpdate | CompilerEventDirAdd | CompilerEventDirDelete;
+export type CompilerEventName = CompilerEventFsChange | CompilerEventFileUpdate | CompilerEventFileAdd | CompilerEventFileDelete | CompilerEventDirAdd | CompilerEventDirDelete | CompilerEventBuildStart | CompilerEventBuildFinish | CompilerEventBuildNoChange | CompilerEventBuildLog;
+export type CompilerEventFsChange = 'fsChange';
+export type CompilerEventFileUpdate = 'fileUpdate';
+export type CompilerEventFileAdd = 'fileAdd';
+export type CompilerEventFileDelete = 'fileDelete';
+export type CompilerEventDirAdd = 'dirAdd';
+export type CompilerEventDirDelete = 'dirDelete';
+export type CompilerEventBuildStart = 'buildStart';
+export type CompilerEventBuildFinish = 'buildFinish';
+export type CompilerEventBuildLog = 'buildLog';
+export type CompilerEventBuildNoChange = 'buildNoChange';
 export interface CompilerFileWatcher {
     close(): void | Promise<void>;
 }
@@ -1659,7 +1659,7 @@ export interface EmulateViewport {
  * in this array without good reason!
  */
 export declare const LOG_LEVELS: readonly ["debug", "info", "warn", "error"];
-export declare type LogLevel = typeof LOG_LEVELS[number];
+export type LogLevel = typeof LOG_LEVELS[number];
 /**
  * Common logger to be used by the compiler, dev-server and CLI. The CLI will use a
  * NodeJS based console logging and colors, and the web will use browser based
@@ -1895,7 +1895,7 @@ export interface OutputTargetBase {
      */
     type: string;
 }
-export declare type OutputTargetBuild = OutputTargetDistCollection | OutputTargetDistLazy;
+export type OutputTargetBuild = OutputTargetDistCollection | OutputTargetDistLazy;
 export interface OutputTargetAngular extends OutputTargetBase {
     type: 'angular';
     componentCorePackage: string;
@@ -1983,7 +1983,7 @@ export interface OutputTargetWww extends OutputTargetBase {
     serviceWorker?: ServiceWorkerConfig | null | false;
     appDir?: string;
 }
-export declare type OutputTarget = OutputTargetAngular | OutputTargetCopy | OutputTargetCustom | OutputTargetDist | OutputTargetDistCollection | OutputTargetDistCustomElements | OutputTargetDistCustomElementsBundle | OutputTargetDistLazy | OutputTargetDistGlobalStyles | OutputTargetDistLazyLoader | OutputTargetDocsJson | OutputTargetDocsCustom | OutputTargetDocsReadme | OutputTargetDocsVscode | OutputTargetWww | OutputTargetHydrate | OutputTargetStats | OutputTargetDistTypes;
+export type OutputTarget = OutputTargetAngular | OutputTargetCopy | OutputTargetCustom | OutputTargetDist | OutputTargetDistCollection | OutputTargetDistCustomElements | OutputTargetDistCustomElementsBundle | OutputTargetDistLazy | OutputTargetDistGlobalStyles | OutputTargetDistLazyLoader | OutputTargetDocsJson | OutputTargetDocsCustom | OutputTargetDocsReadme | OutputTargetDocsVscode | OutputTargetWww | OutputTargetHydrate | OutputTargetStats | OutputTargetDistTypes;
 export interface ServiceWorkerConfig {
     unregister?: boolean;
     swDest?: string;
@@ -2122,7 +2122,7 @@ export interface OptimizeCssInput {
  * Instead, this basically just serves as a label type to track
  * that arguments are being passed consistently.
  */
-export declare type AutoprefixerOptions = Object;
+export type AutoprefixerOptions = Object;
 /**
  * Output from CSS optimization functions, wrapping up optimized
  * CSS and any diagnostics produced during optimization.
@@ -2292,7 +2292,7 @@ export interface TranspileOptions {
      */
     sys?: CompilerSystem;
 }
-export declare type CompileTarget = 'latest' | 'esnext' | 'es2020' | 'es2019' | 'es2018' | 'es2017' | 'es2015' | 'es5' | string | undefined;
+export type CompileTarget = 'latest' | 'esnext' | 'es2020' | 'es2019' | 'es2018' | 'es2017' | 'es2015' | 'es5' | string | undefined;
 export interface TranspileResults {
     code: string;
     data?: any[];

package/internal/stencil-public-runtime.d.ts

@@ -133,7 +133,7 @@ export interface ListenOptions {
      */
     passive?: boolean;
 }
-export declare type ListenTargetOptions = 'body' | 'document' | 'window';
+export type ListenTargetOptions = 'body' | 'document' | 'window';
 export interface StateDecorator {
     (): PropertyDecorator;
 }
@@ -214,8 +214,8 @@ export declare const State: StateDecorator;
  * https://stenciljs.com/docs/reactive-data#watch-decorator
  */
 export declare const Watch: WatchDecorator;
-export declare type ResolutionHandler = (elm: HTMLElement) => string | undefined | null;
-export declare type ErrorHandler = (err: any, element?: HTMLElement) => void;
+export type ResolutionHandler = (elm: HTMLElement) => string | undefined | null;
+export type ErrorHandler = (err: any, element?: HTMLElement) => void;
 /**
  * `setMode()` is used for libraries which provide multiple "modes" for styles.
  */
@@ -433,8 +433,44 @@ interface HostAttributes {
     ref?: (el: HTMLElement | null) => void;
     [prop: string]: any;
 }
+/**
+ * Utilities for working with functional Stencil components. An object
+ * conforming to this interface is passed by the Stencil runtime as the third
+ * argument to a functional component, allowing component authors to work with
+ * features like children.
+ *
+ * The children of a functional component will be passed as the second
+ * argument, so a functional component which uses these utils to transform its
+ * children might look like the following:
+ *
+ * ```ts
+ * export const AddClass: FunctionalComponent = (_, children, utils) => (
+ *  utils.map(children, child => ({
+ *    ...child,
+ *    vattrs: {
+ *      ...child.vattrs,
+ *      class: `${child.vattrs.class} add-class`
+ *    }
+ *  }))
+ * );
+ * ```
+ *
+ * For more see the Stencil documentation, here:
+ * https://stenciljs.com/docs/functional-components
+ */
 export interface FunctionalUtilities {
+    /**
+     * Utility for reading the children of a functional component at runtime.
+     * Since the Stencil runtime uses a different interface for children it is
+     * not recommendeded to read the children directly, and is preferable to use
+     * this utility to, for instance, perform a side effect for each child.
+     */
     forEach: (children: VNode[], cb: (vnode: ChildNode, index: number, array: ChildNode[]) => void) => void;
+    /**
+     * Utility for transforming the children of a functional component. Given an
+     * array of children and a callback this will return a list of the results of
+     * passing each child to the supplied callback.
+     */
     map: (children: VNode[], cb: (vnode: ChildNode, index: number, array: ChildNode[]) => ChildNode) => VNode[];
 }
 export interface FunctionalComponent<T = {}> {

package/internal/testing/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/internal/testing",
-  "version": "2.20.0",
+  "version": "2.21.0",
   "description": "Stencil internal testing platform to be imported by the Stencil Compiler. Breaking changes can and will happen at any time.",
   "main": "./index.js",
   "private": true