` ([#6514](https://github.com/stenciljs/core/issues/6514)) ([cdcd873](https://github.com/stenciljs/core/commit/cdcd873a03de2534715320e6c758a808cab08ce1))\n* **testing:** jest / mixin related errors ([#6512](https://github.com/stenciljs/core/issues/6512)) ([5c17422](https://github.com/stenciljs/core/commit/5c17422eee67ffff6f1166374e43d218ba82905f))\n* **types:** components.d.ts - correctly import / export used enums ([#6522](https://github.com/stenciljs/core/issues/6522)) ([e243c6f](https://github.com/stenciljs/core/commit/e243c6f73ff8632851152b0b2f6a88eaa87c1bf4))\n\n\n### Features\n\n* **dev-server:** new `strictPort` property ([#6523](https://github.com/stenciljs/core/issues/6523)) ([cc12853](https://github.com/stenciljs/core/commit/cc1285363d85d87d5e686adcb7f5e9d93b7829b7))\n* **runtime:** support tsconfig `jsxImportSource` (`h` import no longer necessary) ([#6525](https://github.com/stenciljs/core/issues/6525)) ([6482533](https://github.com/stenciljs/core/commit/648253360793cc6909aa631fe44dd34599e9d4e2))\n\n\n\n## 🐂 [4.40.1](https://github.com/stenciljs/core/compare/v4.40.0...v4.40.1) (2025-12-23)\n\n\n### Bug Fixes\n\n* **compiler:** docs generation when using `excludedComponents` ([#6509](https://github.com/stenciljs/core/issues/6509)) ([4209437](https://github.com/stenciljs/core/commit/4209437ff371671a13fd0085611ab92abb73c1f5))\n* **css:** `@container` query parsing ([#6508](https://github.com/stenciljs/core/issues/6508)) ([208a105](https://github.com/stenciljs/core/commit/208a1050c23d6de985c33d4f4a273d93e7b39a3b))\n* **css:** escape backslashes ([#6506](https://github.com/stenciljs/core/issues/6506)) ([758b8ee](https://github.com/stenciljs/core/commit/758b8ee024a26da938dd335bf3c96be7269d9317))\n* **runtime:** more robust `supportsConstructableStylesheets` test ([#6510](https://github.com/stenciljs/core/issues/6510)) ([484b1b8](https://github.com/stenciljs/core/commit/484b1b8682bc0ff9becedb5f180afa66e50c46fb))\n\n\n\n# 🍌 [4.40.0](https://github.com/stenciljs/core/compare/v4.39.0...v4.40.0) (2025-12-23)\n\n\n### Bug Fixes\n\n* **compiler:** minify dist-custom-elements and hydrate-script ([#6482](https://github.com/stenciljs/core/issues/6482)) ([ec043cd](https://github.com/stenciljs/core/commit/ec043cdd0fc0fe5179e7b125039afbd034ea41a6))\n* **compiler:** resolve node_modules css imports ([#6493](https://github.com/stenciljs/core/issues/6493)) ([84ac5b8](https://github.com/stenciljs/core/commit/84ac5b8cbe85be26cdf01bfa5d34fe455b853e6e))\n* **css:** css imports with functions and media queries ([#6474](https://github.com/stenciljs/core/issues/6474)) ([249f84a](https://github.com/stenciljs/core/commit/249f84aab3f3597d132563907732b80d6ae1aade))\n* **css:** enable parsing of native, nested css selectors ([#6480](https://github.com/stenciljs/core/issues/6480)) ([3506686](https://github.com/stenciljs/core/commit/35066867e13669ac1d19fb168e3ae85dc4dd42b6))\n* **css:** pseudo-element selectors in nested media queries ([#6486](https://github.com/stenciljs/core/issues/6486)) ([20ce1ce](https://github.com/stenciljs/core/commit/20ce1ce3d5dd801f3648e5052891efff4965212b))\n* **css:** strip comments before adding css to js ([#6487](https://github.com/stenciljs/core/issues/6487)) ([2892b4f](https://github.com/stenciljs/core/commit/2892b4f486f79db7ba19ab54b9c500e210cda926))\n* **css:** vanilla css live-reload & added globalStyles to dev `\\n\\n\\n This Stencil app is disabled for this browser. \\n\\n Developers: \\n \\n ES5 builds are disabled during development to take advantage of 2x faster build times. \\n Please see the example below or our config docs if you would like to develop on a browser that does not fully support ES2017 and custom elements. \\n Note that by default, ES5 builds and polyfills are enabled during production builds. \\n When testing browsers it is recommended to always test in production mode, and ES5 builds should always be enabled during production builds. \\n This is only an experiment and if it slows down app development then we will revert this and enable ES5 builds during dev. \\n\\n\\n Enabling ES5 builds during development: \\n \\n npm run dev --es5\\n \\n For stencil-component-starter, use:
\\n \\n npm start --es5\\n \\n\\n\\n Enabling full production builds during development: \\n \\n npm run dev --prod\\n \\n For stencil-component-starter, use:
\\n \\n npm start --prod\\n \\n\\n Current Browser\\'s Support: \\n \\n\\n Current Browser: \\n \\n \\n';\n\n document.getElementById('current-browser-output').textContent = window.navigator.userAgent;\n document.getElementById('es-modules-test').textContent = supportsEsModules;\n document.getElementById('es-dynamic-modules-test').textContent = supportsDynamicImports();\n document.getElementById('shadow-dom-test').textContent = !!(document.head.attachShadow);\n document.getElementById('custom-elements-test').textContent = !!(window.customElements);\n document.getElementById('css-variables-test').textContent = !!(window.CSS && window.CSS.supports && window.CSS.supports('color', 'var(--c)'));\n document.getElementById('fetch-test').textContent = !!(window.fetch);\n } else {\n document.body.innerHTML = '\\n \\n\\n\\n\\n Update src/index.html \\n\\n Stencil recently changed how scripts are loaded in order to improve performance.
\\n\\n BEFORE: \\n Previously, a single script was included that handled loading the correct JavaScript based on browser support.
\\n \\n <script src="/build/app.js"></script>\\n\\n \\n\\n AFTER: \\n The index.html should now include two scripts using the modern ES Module script pattern.\\n Note that only one file will actually be requested and loaded based on the browser\\'s native support for ES Modules.\\n For more info, please see Using JavaScript modules on the web .\\n
\\n \\n <script type=\"module\" src=\"/build/app.esm .js\"></script>\\n <script nomodule src="/build/app.js"></script>\\n \\n';\n }\n }\n\n setTimeout(checkSupport);\n})();"
},
{
"path": "screenshot/compare/build/index.esm.js",
"content": ""
},
{
"path": "screenshot/compare/build/p-081b0641.js",
"content": "function t(t,n,r){const s=o(t,n,r),c=localStorage.getItem(s);if(\"string\"==typeof c){const t=parseInt(c,10);if(!isNaN(t))return t}return null}function n(t,n,r,s){const c=o(t,n,r);localStorage.setItem(c,String(s))}function o(t,n,o){return`screenshot_mismatch_${t}_${n}_${o}`}export{t as g,n as s}"
},
{
"path": "screenshot/compare/build/p-227a1e18.entry.js",
"content": "import{r as t,h as s,g as e,c as o}from\"./p-fbbae598.js\";import{A as i}from\"./p-e2efe0df.js\";import{m as n,a as r,s as a,b as h,c,d as l,e as u,f as p,g as d,h as f,i as g,j as y,k as m,l as b,n as w,o as P,p as v}from\"./p-9b6a9315.js\";class O{constructor(s){t(this,s)}render(){return s(\"stencil-router\",{class:\"full-screen\"},s(\"stencil-route-switch\",null,s(\"stencil-route\",{url:\"/:buildIdA/:buildIdB\",exact:!0,component:\"screenshot-compare\",class:\"full-screen\"}),s(\"stencil-route\",{url:\"/:buildId\",component:\"screenshot-preview\",class:\"full-screen\"}),s(\"stencil-route\",{url:\"/\",component:\"screenshot-preview\",exact:!0,class:\"full-screen\"})))}}class j{constructor(s){t(this,s),this.group=null,this.match=null,this.componentProps={},this.exact=!1,this.scrollOnNextRender=!1,this.previousMatch=null}computeMatch(t){const s=null!=this.group||null!=this.el.parentElement&&\"stencil-route-switch\"===this.el.parentElement.tagName.toLowerCase();if(t&&!s)return this.previousMatch=this.match,this.match=n(t.pathname,{path:this.url,exact:this.exact,strict:!0})}async loadCompleted(){let t={};this.history&&this.history.location.hash?t={scrollToId:this.history.location.hash.substr(1)}:this.scrollTopOffset&&(t={scrollTopOffset:this.scrollTopOffset}),\"function\"==typeof this.componentUpdated?this.componentUpdated(t):this.match&&!r(this.match,this.previousMatch)&&this.routeViewsUpdated&&this.routeViewsUpdated(t)}async componentDidUpdate(){await this.loadCompleted()}async componentDidLoad(){await this.loadCompleted()}render(){if(!this.match||!this.history)return null;const t=Object.assign({},this.componentProps,{history:this.history,match:this.match});return this.routeRender?this.routeRender(Object.assign({},t,{component:this.component})):this.component?s(this.component,Object.assign({},t)):void 0}get el(){return e(this)}static get watchers(){return{location:[\"computeMatch\"]}}}i.injectProps(j,[\"location\",\"history\",\"historyType\",\"routeViewsUpdated\"]),j.style=\"stencil-route.inactive{display:none}\";const L=t=>\"STENCIL-ROUTE\"===t.tagName;class S{constructor(s){t(this,s),this.group=((1e17*Math.random()).toString().match(/.{4}/g)||[]).join(\"-\"),this.subscribers=[],this.queue=o(this,\"queue\")}componentWillLoad(){null!=this.location&&this.regenerateSubscribers(this.location)}async regenerateSubscribers(t){if(null==t)return;let s=-1;if(this.subscribers=Array.prototype.slice.call(this.el.children).filter(L).map((e,o)=>{const i=n(t.pathname,{path:e.url,exact:e.exact,strict:!0});return i&&-1===s&&(s=o),{el:e,match:i}}),-1===s)return;if(this.activeIndex===s)return void(this.subscribers[s].el.match=this.subscribers[s].match);this.activeIndex=s;const e=this.subscribers[this.activeIndex];this.scrollTopOffset&&(e.el.scrollTopOffset=this.scrollTopOffset),e.el.group=this.group,e.el.match=e.match,e.el.componentUpdated=t=>{this.queue.write(()=>{this.subscribers.forEach((t,s)=>{if(t.el.componentUpdated=void 0,s===this.activeIndex)return t.el.style.display=\"\";this.scrollTopOffset&&(t.el.scrollTopOffset=this.scrollTopOffset),t.el.group=this.group,t.el.match=null,t.el.style.display=\"none\"})}),this.routeViewsUpdated&&this.routeViewsUpdated(Object.assign({scrollTopOffset:this.scrollTopOffset},t))}}render(){return s(\"slot\",null)}get el(){return e(this)}static get watchers(){return{location:[\"regenerateSubscribers\"]}}}i.injectProps(S,[\"location\",\"routeViewsUpdated\"]);const U=(t,...s)=>{t||console.warn(...s)},k=()=>{let t,s=[];return{setPrompt:s=>(U(null==t,\"A history supports only one prompt at a time\"),t=s,()=>{t===s&&(t=null)}),confirmTransitionTo:(s,e,o,i)=>{if(null!=t){const n=\"function\"==typeof t?t(s,e):t;\"string\"==typeof n?\"function\"==typeof o?o(n,i):(U(!1,\"A history needs a getUserConfirmation function in order to use a prompt message\"),i(!0)):i(!1!==n)}else i(!0)},appendListener:t=>{let e=!0;const o=(...s)=>{e&&t(...s)};return s.push(o),()=>{e=!1,s=s.filter(t=>t!==o)}},notifyListeners:(...t)=>{s.forEach(s=>s(...t))}}},H=(t,s=\"scrollPositions\")=>{let e=new Map;const o=(s,o)=>{if(e.set(s,o),a(t,\"sessionStorage\")){const s=[];e.forEach((t,e)=>{s.push([e,t])}),t.sessionStorage.setItem(\"scrollPositions\",JSON.stringify(s))}};if(a(t,\"sessionStorage\")){const o=t.sessionStorage.getItem(s);e=o?new Map(JSON.parse(o)):e}return\"scrollRestoration\"in t.history&&(history.scrollRestoration=\"manual\"),{set:o,get:t=>e.get(t),has:t=>e.has(t),capture:s=>{o(s,[t.scrollX,t.scrollY])}}},T={hashbang:{encodePath:t=>\"!\"===t.charAt(0)?t:\"!/\"+P(t),decodePath:t=>\"!\"===t.charAt(0)?t.substr(1):t},noslash:{encodePath:P,decodePath:u},slash:{encodePath:u,decodePath:u}},E=(t,s)=>{const e=0==t.pathname.indexOf(s)?\"/\"+t.pathname.slice(s.length):t.pathname;return Object.assign({},t,{pathname:e})},A={browser:(t,s={})=>{let e=!1;const o=t.history,i=t.location,n=t.navigator,r=h(t),a=!c(n),w=H(t),P=null!=s.forceRefresh&&s.forceRefresh,v=null!=s.getUserConfirmation?s.getUserConfirmation:m,O=null!=s.keyLength?s.keyLength:6,j=s.basename?l(u(s.basename)):\"\",L=()=>{try{return t.history.state||{}}catch(t){return{}}},S=t=>{t=t||{};const{key:s,state:e}=t,{pathname:o,search:n,hash:r}=i;let a=o+n+r;return U(!j||f(a,j),'You are attempting to use a basename on a page whose URL path does not begin with the basename. Expected path \"'+a+'\" to begin with \"'+j+'\".'),j&&(a=g(a,j)),p(a,e,s||d(O))},T=k(),E=t=>{w.capture(q.location.key),Object.assign(q,t),q.location.scrollPosition=w.get(q.location.key),q.length=o.length,T.notifyListeners(q.location,q.action)},A=t=>{b(n,t)||C(S(t.state))},x=()=>{C(S(L()))},C=t=>{if(e)e=!1,E();else{const s=\"POP\";T.confirmTransitionTo(t,s,v,e=>{e?E({action:s,location:t}):R(t)})}},R=t=>{let s=B.indexOf(q.location.key),o=B.indexOf(t.key);-1===s&&(s=0),-1===o&&(o=0);const i=s-o;i&&(e=!0,N(i))},M=S(L());let B=[M.key],I=0,_=!1;const Y=t=>j+y(t),N=t=>{o.go(t)},V=s=>{I+=s,1===I?(t.addEventListener(\"popstate\",A),a&&t.addEventListener(\"hashchange\",x)):0===I&&(t.removeEventListener(\"popstate\",A),a&&t.removeEventListener(\"hashchange\",x))},q={length:o.length,action:\"POP\",location:M,createHref:Y,push:(t,s)=>{U(!(\"object\"==typeof t&&void 0!==t.state&&void 0!==s),\"You should avoid providing a 2nd state argument to push when the 1st argument is a location-like object that already has state; it is ignored\");const e=p(t,s,d(O),q.location);T.confirmTransitionTo(e,\"PUSH\",v,t=>{if(!t)return;const s=Y(e),{key:n,state:a}=e;if(r)if(o.pushState({key:n,state:a},\"\",s),P)i.href=s;else{const t=B.indexOf(q.location.key),s=B.slice(0,-1===t?0:t+1);s.push(e.key),B=s,E({action:\"PUSH\",location:e})}else U(void 0===a,\"Browser history cannot push state in browsers that do not support HTML5 history\"),i.href=s})},replace:(t,s)=>{U(!(\"object\"==typeof t&&void 0!==t.state&&void 0!==s),\"You should avoid providing a 2nd state argument to replace when the 1st argument is a location-like object that already has state; it is ignored\");const e=p(t,s,d(O),q.location);T.confirmTransitionTo(e,\"REPLACE\",v,t=>{if(!t)return;const s=Y(e),{key:n,state:a}=e;if(r)if(o.replaceState({key:n,state:a},\"\",s),P)i.replace(s);else{const t=B.indexOf(q.location.key);-1!==t&&(B[t]=e.key),E({action:\"REPLACE\",location:e})}else U(void 0===a,\"Browser history cannot replace state in browsers that do not support HTML5 history\"),i.replace(s)})},go:N,goBack:()=>N(-1),goForward:()=>N(1),block:(t=\"\")=>{const s=T.setPrompt(t);return _||(V(1),_=!0),()=>(_&&(_=!1,V(-1)),s())},listen:t=>{const s=T.appendListener(t);return V(1),()=>{V(-1),s()}},win:t};return q},hash:(t,s={})=>{let e=!1,o=null,i=0,n=!1;const r=t.location,a=t.history,h=w(t.navigator),c=null!=s.keyLength?s.keyLength:6,{getUserConfirmation:b=m,hashType:P=\"slash\"}=s,O=s.basename?l(u(s.basename)):\"\",{encodePath:j,decodePath:L}=T[P],S=()=>{const t=r.href,s=t.indexOf(\"#\");return-1===s?\"\":t.substring(s+1)},H=t=>{const s=r.href.indexOf(\"#\");r.replace(r.href.slice(0,s>=0?s:0)+\"#\"+t)},E=()=>{let t=L(S());return U(!O||f(t,O),'You are attempting to use a basename on a page whose URL path does not begin with the basename. Expected path \"'+t+'\" to begin with \"'+O+'\".'),O&&(t=g(t,O)),p(t,void 0,d(c))},A=k(),x=t=>{Object.assign(q,t),q.length=a.length,A.notifyListeners(q.location,q.action)},C=()=>{const t=S(),s=j(t);if(t!==s)H(s);else{const t=E(),s=q.location;if(!e&&v(s,t))return;if(o===y(t))return;o=null,R(t)}},R=t=>{if(e)e=!1,x();else{const s=\"POP\";A.confirmTransitionTo(t,s,b,e=>{e?x({action:s,location:t}):M(t)})}},M=t=>{let s=Y.lastIndexOf(y(q.location)),o=Y.lastIndexOf(y(t));-1===s&&(s=0),-1===o&&(o=0);const i=s-o;i&&(e=!0,N(i))},B=S(),I=j(B);B!==I&&H(I);const _=E();let Y=[y(_)];const N=t=>{U(h,\"Hash history go(n) causes a full page reload in this browser\"),a.go(t)},V=(t,s)=>{i+=s,1===i?t.addEventListener(\"hashchange\",C):0===i&&t.removeEventListener(\"hashchange\",C)},q={length:a.length,action:\"POP\",location:_,createHref:t=>\"#\"+j(O+y(t)),push:(t,s)=>{U(void 0===s,\"Hash history cannot push state; it is ignored\");const e=p(t,void 0,d(c),q.location);A.confirmTransitionTo(e,\"PUSH\",b,t=>{if(!t)return;const s=y(e),i=j(O+s);if(S()!==i){o=s,(t=>{r.hash=t})(i);const t=Y.lastIndexOf(y(q.location)),n=Y.slice(0,-1===t?0:t+1);n.push(s),Y=n,x({action:\"PUSH\",location:e})}else U(!1,\"Hash history cannot PUSH the same path; a new entry will not be added to the history stack\"),x()})},replace:(t,s)=>{U(void 0===s,\"Hash history cannot replace state; it is ignored\");const e=p(t,void 0,d(c),q.location);A.confirmTransitionTo(e,\"REPLACE\",b,t=>{if(!t)return;const s=y(e),i=j(O+s);S()!==i&&(o=s,H(i));const n=Y.indexOf(y(q.location));-1!==n&&(Y[n]=s),x({action:\"REPLACE\",location:e})})},go:N,goBack:()=>N(-1),goForward:()=>N(1),block:(s=\"\")=>{const e=A.setPrompt(s);return n||(V(t,1),n=!0),()=>(n&&(n=!1,V(t,-1)),e())},listen:s=>{const e=A.appendListener(s);return V(t,1),()=>{V(t,-1),e()}},win:t};return q}};class x{constructor(s){t(this,s),this.root=\"/\",this.historyType=\"browser\",this.titleSuffix=\"\",this.routeViewsUpdated=(t={})=>{if(this.history&&t.scrollToId&&\"browser\"===this.historyType){const s=this.history.win.document.getElementById(t.scrollToId);if(s)return s.scrollIntoView()}this.scrollTo(t.scrollTopOffset||this.scrollTopOffset)},this.isServer=o(this,\"isServer\"),this.queue=o(this,\"queue\")}componentWillLoad(){this.history=A[this.historyType](this.el.ownerDocument.defaultView),this.history.listen(t=>{t=E(t,this.root),this.location=t}),this.location=E(this.history.location,this.root)}scrollTo(t){const s=this.history;if(null!=t&&!this.isServer&&s)return\"POP\"===s.action&&Array.isArray(s.location.scrollPosition)?this.queue.write(()=>{s&&s.location&&Array.isArray(s.location.scrollPosition)&&s.win.scrollTo(s.location.scrollPosition[0],s.location.scrollPosition[1])}):this.queue.write(()=>{s.win.scrollTo(0,t)})}render(){if(this.location&&this.history)return s(i.Provider,{state:{historyType:this.historyType,location:this.location,titleSuffix:this.titleSuffix,root:this.root,history:this.history,routeViewsUpdated:this.routeViewsUpdated}},s(\"slot\",null))}get el(){return e(this)}}export{O as app_root,j as stencil_route,S as stencil_route_switch,x as stencil_router}"
},
{
"path": "screenshot/compare/build/p-2c298727.entry.js",
"content": "import{r as e,h as t}from\"./p-fbbae598.js\";class s{constructor(t){e(this,t),this.appSrcUrl=\"\",this.imagesUrl=\"/data/images/\",this.buildsUrl=\"/data/builds/\"}async componentWillLoad(){let e=\"master\";this.match&&this.match.params.buildId&&(e=this.match.params.buildId.substr(0,7));let t=`${this.buildsUrl}${e}.json`;\"master\"===e&&(t+=\"?ts=\"+Date.now());const s=await fetch(t);s.ok&&(this.build=await s.json(),document.title=`${this.build.id} Preview: ${this.build.message}`)}render(){const e=[];return this.build&&this.build.screenshots.forEach(t=>{const s=t.testPath.split(\"/\");s.pop();const i=`/data/tests/${this.build.id}/${s.join(\"/\")}/`;if(!e.some(e=>e.url===i)){const s={desc:t.desc.split(\",\")[0],url:i};e.push(s)}}),e.sort((e,t)=>e.desc.toLowerCase()t.desc.toLowerCase()?1:0),[t(\"compare-header\",{appSrcUrl:this.appSrcUrl}),t(\"section\",{class:\"scroll-y\"},t(\"section\",{class:\"content\"},this.build?t(\"h1\",null,t(\"a\",{href:this.build.url},this.build.message)):null,e.map(e=>t(\"div\",null,t(\"a\",{href:e.url},e.desc)))))]}}s.style=\"screenshot-preview{display:block}screenshot-preview .scroll-y{width:100%}screenshot-preview h1{color:var(--analysis-data-color);font-size:16px;margin:0}screenshot-preview .content{padding:80px 20px 140px 20px}screenshot-preview a{display:block;padding:8px;color:var(--analysis-data-color);text-decoration:none}screenshot-preview a:hover{text-decoration:underline}screenshot-preview compare-header{left:0;padding:0;width:100%;width:100%;height:auto;padding-top:env(safe-area-inset-top)}screenshot-preview compare-header compare-filter{display:none}@media (max-width: 480px){screenshot-preview a{padding:12px;font-size:18px}screenshot-preview a:hover{text-decoration:none}}\";export{s as screenshot_preview}"
},
{
"path": "screenshot/compare/build/p-5479268c.entry.js",
"content": "import{r as t,h as s}from\"./p-fbbae598.js\";import{g as i}from\"./p-081b0641.js\";function e(t,s){const i=Object.assign({},t,s),e=Object.keys(i),o=[];return e.map(t=>{const s=i[t];!0===s?o.push(t):null!=s&&\"\"!==s&&o.push(t+\"-\"+s)}),window.location.hash=o.sort().join(\";\"),i}class o{constructor(s){t(this,s),this.appSrcUrl=\"\",this.imagesUrl=\"/data/images/\",this.buildsUrl=\"/data/builds/\",this.comparesUrl=\"/data/compares/\",this.jsonpUrl=null,this.diffs=[]}async componentWillLoad(){this.match&&this.match.params.buildIdA&&this.match.params.buildIdB&&await this.loadBuilds(this.match.params.buildIdA,this.match.params.buildIdB),this.diffs=await function(t,s,e){const o=[];return s&&e?(e.screenshots.forEach(s=>{o.push({id:s.id,desc:s.desc,testPath:s.testPath,imageA:null,imageUrlA:null,imageB:s.image,imageUrlB:`${t}${s.image}`,identical:!1,comparable:!1,mismatchedPixels:null,width:s.width,height:s.height,deviceScaleFactor:s.deviceScaleFactor,device:s.device||s.userAgent,show:!1,hasIntersected:!1,threshold:\"number\"==typeof s.threshold?s.threshold:.05})}),s.screenshots.forEach(s=>{const i=o.find(t=>t.id===s.id);i&&(i.imageA=s.image,i.imageUrlA=`${t}${s.image}`)}),o.forEach(t=>{if(t.comparable=null!=t.imageA&&null!=t.imageB,t.identical=t.comparable&&t.imageA===t.imageB,t.identical)t.mismatchedPixels=0;else{const s=i(t.imageA,t.imageB,t.threshold);\"number\"==typeof s&&(t.mismatchedPixels=s,0===t.mismatchedPixels&&(t.identical=!0))}}),o):o}(this.imagesUrl,this.a,this.b),this.filter=function(){const t={},s=location.hash.replace(\"#\",\"\");return\"\"!==s&&s.split(\";\").forEach(s=>{const i=s.split(\"-\");t[i[0]]=!(i.length>1)||i[1]}),t}(),this.updateDiffs()}componentDidLoad(){if(\"IntersectionObserver\"in window){const t={root:document.querySelector(\".scroll-y\"),rootMargin:\"1200px\"},s=new IntersectionObserver(t=>{let s=!1;t.forEach(t=>{if(t.isIntersecting){const i=this.diffs.find(s=>t.target.id===\"d-\"+s.id);i&&(i.hasIntersected=!0,s=!0)}}),s&&(window.requestIdleCallback?window.requestIdleCallback(()=>{this.updateDiffs()}):window.requestAnimationFrame(()=>{this.updateDiffs()}))},t),i=document.querySelectorAll(\"compare-row\");for(let t=0;t{t.hasIntersected=!0}),this.updateDiffs();this.filter&&this.filter.diff&&this.navToDiff(this.filter.diff)}async loadBuilds(t,s){let i=`${this.buildsUrl}${t}.json`;\"master\"===t&&(i+=\"?ts=\"+Date.now());let e=`${this.buildsUrl}${s}.json`;\"master\"===s&&(e+=\"?ts=\"+Date.now());const o=await Promise.all([fetch(i),fetch(e)]),n=await o[0],a=await o[1];n.ok&&a.ok&&(this.a=await n.json(),this.b=await a.json())}filterChange(t){this.filter=e(this.filter,t.detail),this.updateDiffs()}diffNavChange(t){const s=t.detail;this.filter=e(this.filter,{diff:s}),this.updateDiffs(),this.navToDiff(s)}navToDiff(t){const s=document.getElementById(\"d-\"+t),i=document.querySelector(\".scroll-y\");s&&i&&(i.scrollTop=s.offsetTop-84)}compareLoaded(t){const s=t.detail,i=this.diffs.find(t=>t.id===s.id);i&&(i.mismatchedPixels=s.mismatchedPixels),this.updateDiffs()}updateDiffs(){var t;this.diffs=(t=this.filter,this.diffs.map(s=>(s=Object.assign({},s),function(t,s){const i=!t.device||t.device===s.device,e=!t.search||s.desc.includes(t.search);let o=!0;return t.diff&&t.diff===s.id?o=!0:t.mismatch?null!=s.mismatchedPixels&&\"all\"!==t.mismatch&&(o=parseInt(t.mismatch,10)0||null==s.mismatchedPixels,s.show=i&&e&&o,s}(t,s))).sort((t,s)=>t.mismatchedPixels>s.mismatchedPixels?-1:t.mismatchedPixelss.desc.toLowerCase()?1:t.device.toLowerCase()s.device.toLowerCase()?1:0))}render(){return[s(\"compare-header\",{diffs:this.diffs,filter:this.filter,appSrcUrl:this.appSrcUrl}),s(\"section\",{class:\"scroll-x\"},s(\"compare-thead\",{a:this.a,b:this.b,diffs:this.diffs}),s(\"section\",{class:\"scroll-y\"},s(\"compare-table\",null,s(\"compare-tbody\",null,this.diffs.map(t=>s(\"compare-row\",{key:t.id,aId:this.a.id,bId:this.b.id,id:\"d-\"+t.id,show:t.show,hidden:!t.show,imagesUrl:this.imagesUrl,jsonpUrl:this.jsonpUrl,diff:t}))))))]}}export{o as screenshot_compare}"
},
{
"path": "screenshot/compare/build/p-573ec8a4.entry.js",
"content": "import{r as l,d as t,h as d}from\"./p-fbbae598.js\";class a{constructor(d){l(this,d),this.mismatchedPixels=null,this.diffNavChange=t(this,\"diffNavChange\",7)}navToDiff(l){l.preventDefault(),l.stopPropagation(),this.diffNavChange.emit(this.diff.id)}render(){const l=this.diff,t=\"number\"==typeof this.mismatchedPixels,a=t?this.mismatchedPixels/(l.width*l.deviceScaleFactor*(l.height*l.deviceScaleFactor)):null;let i=\"\";t?this.mismatchedPixels>0&&(i=\"has-mismatch\"):i=\"not-calculated\";const n=l.testPath.split(\"/\");n.pop();const s=n.join(\"/\");return[d(\"p\",{class:\"test-path\"},l.testPath),d(\"dl\",null,d(\"div\",null,d(\"dt\",null,\"Diff\"),d(\"dd\",null,d(\"a\",{href:\"#diff-\"+l.id,onClick:this.navToDiff.bind(this)},l.id))),l.comparable?[d(\"div\",{class:i},d(\"dt\",null,\"Mismatched Pixels\"),d(\"dd\",null,t?this.mismatchedPixels:\"--\")),d(\"div\",{class:i},d(\"dt\",null,\"Mismatched Ratio\"),d(\"dd\",null,t?a.toFixed(4):\"--\"))]:null,d(\"div\",null,d(\"dt\",null,\"Device\"),d(\"dd\",null,l.device)),d(\"div\",null,d(\"dt\",null,\"Width\"),d(\"dd\",null,l.width)),d(\"div\",null,d(\"dt\",null,\"Height\"),d(\"dd\",null,l.height)),d(\"div\",null,d(\"dt\",null,\"Device Scale Factor\"),d(\"dd\",null,l.deviceScaleFactor)),l.imageA?d(\"div\",null,d(\"dt\",null,\"Left Preview\"),d(\"dd\",null,d(\"a\",{href:`/data/tests/${this.aId}/${s}/`,target:\"_blank\"},\"HTML\"))):null,l.imageB?d(\"div\",null,d(\"dt\",null,\"Right Preview\"),d(\"dd\",null,d(\"a\",{href:`/data/tests/${this.bId}/${s}/`,target:\"_blank\"},\"HTML\"))):null,d(\"div\",{class:\"desc\"},d(\"dt\",null,\"Description\"),d(\"dd\",null,l.desc)))]}}a.style=\".test-path{margin-top:0;padding-top:0;font-size:10px;color:var(--analysis-data-color)}dl{padding:0;margin:0;font-size:var(--analysis-data-font-size);line-height:28px}div{display:flex;width:260px}dt{display:inline;flex:2;font-weight:500}dd{display:inline;flex:1;color:var(--analysis-data-color)}.desc,.desc dt{display:block}.desc dd{display:block;margin:0;line-height:22px}.not-calculated dd{color:#cccccc}.has-mismatch dd{color:#ff6200}p{padding-top:14px;font-size:var(--analysis-data-font-size)}a{color:var(--analysis-data-color)}a:hover{text-decoration:none}\";export{a as compare_analysis}"
},
{
"path": "screenshot/compare/build/p-6ba08604.entry.js",
"content": "import{r as t,h as i}from\"./p-fbbae598.js\";class o{constructor(i){t(this,i),this.a=\"\",this.b=\"\"}async componentWillLoad(){const t=\"/data/builds/master.json?ts=\"+Date.now(),i=await fetch(t);i.ok&&(this.build=await i.json())}onSubmit(t){t.preventDefault(),t.stopPropagation();let i=this.a.trim().toLowerCase(),o=this.b.trim().toLowerCase();i&&o&&(i=i.substring(0,7),o=o.substring(0,7),window.location.href=`/${i}/${o}`)}render(){return[i(\"header\",null,i(\"div\",{class:\"logo\"},i(\"a\",{href:\"/\"},i(\"img\",{src:\"/assets/logo.png?1\"})))),i(\"section\",null,this.build?i(\"section\",{class:\"master\"},i(\"p\",null,i(\"a\",{href:\"/master\"},this.build.message))):null,i(\"form\",{onSubmit:this.onSubmit.bind(this)},i(\"div\",null,i(\"input\",{onInput:t=>this.a=t.target.value})),i(\"div\",null,i(\"input\",{onInput:t=>this.b=t.target.value})),i(\"div\",null,i(\"button\",{type:\"submit\"},\"Compare Screenshots\"))))]}}o.style=\"header{padding:8px;background:white;box-shadow:var(--header-box-shadow)}img{width:174px;height:32px}.logo{flex:1;padding:7px}a{padding:8px;color:var(--analysis-data-color);text-decoration:none}.master{text-align:center}a:hover{text-decoration:underline}form{width:160px;margin:40px auto}form div{margin:10px}input{width:100%}\";export{o as screenshot_lookup}"
},
{
"path": "screenshot/compare/build/p-6bc63295.entry.js",
"content": "import{r as s,g as t}from\"./p-fbbae598.js\";import{A as e}from\"./p-e2efe0df.js\";class i{constructor(t){s(this,t),this.when=!0,this.message=\"\"}enable(s){this.unblock&&this.unblock(),this.history&&(this.unblock=this.history.block(s))}disable(){this.unblock&&(this.unblock(),this.unblock=void 0)}componentWillLoad(){this.when&&this.enable(this.message)}updateMessage(s,t){this.when?this.when&&t===s||this.enable(this.message):this.disable()}componentDidUnload(){this.disable()}render(){return null}get el(){return t(this)}static get watchers(){return{message:[\"updateMessage\"],when:[\"updateMessage\"]}}}e.injectProps(i,[\"history\"]);export{i as stencil_router_prompt}"
},
{
"path": "screenshot/compare/build/p-7a3759fd.entry.js",
"content": "import{r as e,d as t,h as i}from\"./p-fbbae598.js\";class s{constructor(i){e(this,i),this.filterChange=t(this,\"filterChange\",7)}render(){if(!this.diffs||0===this.diffs.length||!this.filter)return;const e=this.diffs.reduce((e,t)=>(e.some(e=>e.value===t.device)||e.push({text:t.device,value:t.device}),e),[{text:\"All Devices\",value:\"\"}]);return i(\"section\",null,i(\"div\",{class:\"showing\"},\"Showing \",this.diffs.filter(e=>e.show).length),i(\"div\",{class:\"search\"},i(\"input\",{type:\"search\",onInput:e=>{this.filterChange.emit({search:e.target.value})},value:this.filter.search||\"\"})),e.length>1?i(\"div\",{class:\"device\"},i(\"select\",{onInput:e=>{this.filterChange.emit({device:e.target.value})}},e.map(e=>i(\"option\",{key:e.value,selected:e.value===this.filter.device,value:e.value},e.text)))):null,i(\"div\",{class:\"mismatch\"},i(\"select\",{onInput:e=>{this.filterChange.emit({mismatch:e.target.value})}},i(\"option\",{value:\"\",selected:\"\"===this.filter.mismatch},\"> 0\"),i(\"option\",{value:\"100\",selected:\"100\"===this.filter.mismatch},\"> 100\"),i(\"option\",{value:\"250\",selected:\"250\"===this.filter.mismatch},\"> 250\"),i(\"option\",{value:\"500\",selected:\"500\"===this.filter.mismatch},\"> 500\"),i(\"option\",{value:\"1000\",selected:\"1000\"===this.filter.mismatch},\"> 1,000\"),i(\"option\",{value:\"2500\",selected:\"2500\"===this.filter.mismatch},\"> 2,500\"),i(\"option\",{value:\"5000\",selected:\"5000\"===this.filter.mismatch},\"> 5,000\"),i(\"option\",{value:\"10000\",selected:\"10000\"===this.filter.mismatch},\"> 10,000\"),i(\"option\",{value:\"25000\",selected:\"25000\"===this.filter.mismatch},\"> 25,000\"),i(\"option\",{value:\"50000\",selected:\"50000\"===this.filter.mismatch},\"> 50,000\"),i(\"option\",{value:\"all\",selected:\"all\"===this.filter.mismatch},\"All Screenshots\"))))}}s.style=\"select{font-size:10px}input{font-size:10px}.showing{font-size:12px;white-space:nowrap;margin:17px 8px 0 0;color:var(--analysis-data-color)}section{display:flex;justify-content:flex-end}.search{margin:13px 8px 0 0}.device{margin:13px 8px 0 0}.mismatch{margin:13px 8px 0 0}\";class a{constructor(t){e(this,t)}render(){return[i(\"header\",null,i(\"div\",{class:\"logo\"},i(\"a\",{href:\"/\"},i(\"img\",{src:this.appSrcUrl+\"/assets/logo.png?1\"}))),i(\"compare-filter\",{diffs:this.diffs,filter:this.filter}))]}}a.style=\":host{background:white;box-shadow:var(--header-box-shadow)}nav{padding:4px 4px}nav a{font-size:14px;text-decoration:none;color:var(--breadcrumb-color);display:inline-block;padding:0 4px 0 4px}nav a:hover{text-decoration:underline}header{display:flex;width:calc(100% - 115px);padding:8px}img{width:174px;height:32px}.logo{flex:1;padding:7px}compare-filter{flex:1}h1{margin:0;padding:0;font-size:18px}\";export{s as compare_filter,a as compare_header}"
},
{
"path": "screenshot/compare/build/p-7b4e3ba7.js",
"content": "import{p as e,b as r}from\"./p-fbbae598.js\";e().then(e=>r([[\"p-5479268c\",[[0,\"screenshot-compare\",{appSrcUrl:[1,\"app-src-url\"],imagesUrl:[1,\"images-url\"],buildsUrl:[1,\"builds-url\"],comparesUrl:[1,\"compares-url\"],jsonpUrl:[1,\"jsonp-url\"],match:[16],a:[1040],b:[1040],filter:[32],diffs:[32]},[[0,\"filterChange\",\"filterChange\"],[0,\"diffNavChange\",\"diffNavChange\"],[0,\"compareLoaded\",\"compareLoaded\"]]]]],[\"p-2c298727\",[[0,\"screenshot-preview\",{appSrcUrl:[1,\"app-src-url\"],imagesUrl:[1,\"images-url\"],buildsUrl:[1,\"builds-url\"],match:[16]}]]],[\"p-f0b99977\",[[0,\"context-consumer\",{context:[16],renderer:[16],subscribe:[16],unsubscribe:[32]}]]],[\"p-6ba08604\",[[1,\"screenshot-lookup\"]]],[\"p-ec2f13e0\",[[0,\"stencil-async-content\",{documentLocation:[1,\"document-location\"],content:[32]}]]],[\"p-d1bf53f5\",[[4,\"stencil-route-link\",{url:[1],urlMatch:[1,\"url-match\"],activeClass:[1,\"active-class\"],exact:[4],strict:[4],custom:[1],anchorClass:[1,\"anchor-class\"],anchorRole:[1,\"anchor-role\"],anchorTitle:[1,\"anchor-title\"],anchorTabIndex:[1,\"anchor-tab-index\"],anchorId:[1,\"anchor-id\"],history:[16],location:[16],root:[1],ariaHaspopup:[1,\"aria-haspopup\"],ariaPosinset:[1,\"aria-posinset\"],ariaSetsize:[2,\"aria-setsize\"],ariaLabel:[1,\"aria-label\"],match:[32]}]]],[\"p-b4cc611c\",[[0,\"stencil-route-title\",{titleSuffix:[1,\"title-suffix\"],pageTitle:[1,\"page-title\"]}]]],[\"p-6bc63295\",[[0,\"stencil-router-prompt\",{when:[4],message:[1],history:[16],unblock:[32]}]]],[\"p-e8ca6d97\",[[0,\"stencil-router-redirect\",{history:[16],root:[1],url:[1]}]]],[\"p-573ec8a4\",[[1,\"compare-analysis\",{aId:[1,\"a-id\"],bId:[1,\"b-id\"],diff:[16],mismatchedPixels:[2,\"mismatched-pixels\"]}]]],[\"p-f4745c2f\",[[0,\"compare-row\",{aId:[1,\"a-id\"],bId:[1,\"b-id\"],imagesUrl:[1,\"images-url\"],jsonpUrl:[1,\"jsonp-url\"],diff:[16],show:[4],imageASrc:[32],imageBSrc:[32],imageAClass:[32],imageBClass:[32],canvasClass:[32]}],[1,\"compare-thead\",{a:[16],b:[16],diffs:[16]}]]],[\"p-227a1e18\",[[0,\"app-root\"],[0,\"stencil-route\",{group:[513],componentUpdated:[16],match:[1040],url:[1],component:[1],componentProps:[16],exact:[4],routeRender:[16],scrollTopOffset:[2,\"scroll-top-offset\"],routeViewsUpdated:[16],location:[16],history:[16],historyType:[1,\"history-type\"]}],[4,\"stencil-route-switch\",{group:[513],scrollTopOffset:[2,\"scroll-top-offset\"],location:[16],routeViewsUpdated:[16]}],[4,\"stencil-router\",{root:[1],historyType:[1,\"history-type\"],titleSuffix:[1,\"title-suffix\"],scrollTopOffset:[2,\"scroll-top-offset\"],location:[32],history:[32]}]]],[\"p-7a3759fd\",[[1,\"compare-header\",{appSrcUrl:[1,\"app-src-url\"],diffs:[16],filter:[16]}],[1,\"compare-filter\",{diffs:[16],filter:[16]}]]]],e));"
},
{
"path": "screenshot/compare/build/p-988eb362.css",
"content": ":root{--font-family:-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;--font-color:rgb(32, 32, 32);--background-color:#f7f8fb;--breadcrumb-color:#8e9bb2;--header-box-shadow:0px 1px 4px rgba(0, 12, 32, 0.12), 0px 1px 0px rgba(0,12,32,0.02);--screenshot-box-shadow:0px 0px 4px rgba(0, 0, 0, 0.08), 0px 1px 3px rgba(0,0,0,0.12);--screenshot-border-radius:4px;--analysis-data-font-size:12px;--analysis-data-color:rgb(111, 111, 111)}*{box-sizing:border-box}body{padding:0;margin:0;font-family:var(--font-family);background:var(--background-color);color:var(--font-color)}compare-table{display:table;width:100%;margin-top:84px;margin-bottom:12px}compare-tbody{display:table-row-group}compare-tbody compare-cell{padding-top:12px}compare-row{display:table-row}compare-row[hidden]{display:none}compare-cell{display:table-cell;vertical-align:top;padding:3px 10px}body{overflow:hidden;position:absolute;width:100%;height:100vh}screenshot-compare{position:absolute;display:block;top:0px;width:100%;height:100vh}compare-header{display:block;position:absolute;z-index:1;display:block;top:0;left:-100px;padding-left:100px;width:calc(100% + 200px);height:84px}compare-thead{position:relative;top:64px;z-index:1}.scroll-x{position:absolute;top:0;width:100%;height:100vh;overflow-x:scroll;overflow-y:hidden}.scroll-y{position:absolute;top:0;height:100vh;overflow-x:hidden;overflow-y:scroll;-webkit-overflow-scrolling:touch;will-change:scroll-position}"
},
{
"path": "screenshot/compare/build/p-9b6a9315.js",
"content": "const r=new RegExp([\"(\\\\\\\\.)\",\"(?:\\\\:(\\\\w+)(?:\\\\(((?:\\\\\\\\.|[^\\\\\\\\()])+)\\\\))?|\\\\(((?:\\\\\\\\.|[^\\\\\\\\()])+)\\\\))([+*?])?\"].join(\"|\"),\"g\"),e=r=>r.replace(/([.+*?=^!:${}()[\\]|/\\\\])/g,\"\\\\$1\"),t=r=>r.replace(/([=!:$/()])/g,\"\\\\$1\"),n=r=>r&&r.sensitive?\"\":\"i\",a=(r,t,a)=>{for(var o=(a=a||{}).strict,s=!1!==a.end,i=e(a.delimiter||\"/\"),l=a.delimiters||\"./\",c=[].concat(a.endsWith||[]).map(e).concat(\"$\").join(\"|\"),u=\"\",f=!1,p=0;p-1;else{var h=e(d.prefix||\"\"),v=d.repeat?\"(?:\"+d.pattern+\")(?:\"+h+\"(?:\"+d.pattern+\"))*\":d.pattern;t&&t.push(d),u+=d.optional?d.partial?h+\"(\"+v+\")?\":\"(?:\"+h+\"(\"+v+\"))?\":h+\"(\"+v+\")\"}}return s?(o||(u+=\"(?:\"+i+\")?\"),u+=\"$\"===c?\"$\":\"(?=\"+c+\")\"):(o||(u+=\"(?:\"+i+\"(?=\"+c+\"))?\"),f||(u+=\"(?=\"+i+\"|\"+c+\")\")),new RegExp(\"^\"+u,n(a))},o=(s,i,l)=>s instanceof RegExp?((r,e)=>{if(!e)return r;var t=r.source.match(/\\((?!\\?)/g);if(t)for(var n=0;n{for(var a=[],s=0;sa(((n,a)=>{for(var o,s=[],i=0,l=0,c=\"\",u=a&&a.delimiter||\"/\",f=a&&a.delimiters||\"./\",p=!1;null!==(o=r.exec(n));){var d=o[0],h=o[1],v=o.index;if(c+=n.slice(l,v),l=v+d.length,h)c+=h[1],p=!0;else{var g=\"\",y=n[l],E=o[2],x=o[3],R=o[4],m=o[5];if(!p&&c.length){var $=c.length-1;f.indexOf(c[$])>-1&&(g=c[$],c=c.slice(0,$))}c&&(s.push(c),c=\"\",p=!1);var O=g||u,_=x||R;s.push({name:E||i++,prefix:g,delimiter:O,optional:\"?\"===m||\"*\"===m,repeat:\"+\"===m||\"*\"===m,partial:\"\"!==g&&void 0!==y&&y!==g,pattern:_?t(_):\"[^\"+e(O)+\"]+?\"})}}return(c||lnew RegExp(\"^\"+e+\"(\\\\/|\\\\?|#|$)\",\"i\").test(r),i=(r,e)=>s(r,e)?r.substr(e.length):r,l=r=>\"/\"===r.charAt(r.length-1)?r.slice(0,-1):r,c=r=>\"/\"===r.charAt(0)?r:\"/\"+r,u=r=>\"/\"===r.charAt(0)?r.substr(1):r,f=r=>{const{pathname:e,search:t,hash:n}=r;let a=e||\"/\";return t&&\"?\"!==t&&(a+=\"?\"===t.charAt(0)?t:\"?\"+t),n&&\"#\"!==n&&(a+=\"#\"===n.charAt(0)?n:\"#\"+n),a},p=r=>\"/\"===r.charAt(0),d=r=>Math.random().toString(36).substr(2,r),h=(r,e)=>{for(let t=e,n=t+1,a=r.length;n{if(r===e)return!0;if(null==r||null==e)return!1;if(Array.isArray(r))return Array.isArray(e)&&r.length===e.length&&r.every((r,t)=>v(r,e[t]));const t=typeof r;if(t!==typeof e)return!1;if(\"object\"===t){const t=r.valueOf(),n=e.valueOf();if(t!==r||n!==e)return v(t,n);const a=Object.keys(r),o=Object.keys(e);return a.length===o.length&&a.every(t=>v(r[t],e[t]))}return!1},g=(r,e)=>r.pathname===e.pathname&&r.search===e.search&&r.hash===e.hash&&r.key===e.key&&v(r.state,e.state),y=(r,e,t,n)=>{let a;\"string\"==typeof r?(a=(r=>{let e=r||\"/\",t=\"\",n=\"\";const a=e.indexOf(\"#\");-1!==a&&(n=e.substr(a),e=e.substr(0,a));const o=e.indexOf(\"?\");return-1!==o&&(t=e.substr(o),e=e.substr(0,o)),{pathname:e,search:\"?\"===t?\"\":t,hash:\"#\"===n?\"\":n,query:{},key:\"\"}})(r),void 0!==e&&(a.state=e)):(a=Object.assign({pathname:\"\"},r),a.search&&\"?\"!==a.search.charAt(0)&&(a.search=\"?\"+a.search),a.hash&&\"#\"!==a.hash.charAt(0)&&(a.hash=\"#\"+a.hash),void 0!==e&&void 0===a.state&&(a.state=e));try{a.pathname=decodeURI(a.pathname)}catch(r){throw r instanceof URIError?new URIError('Pathname \"'+a.pathname+'\" could not be decoded. This is likely caused by an invalid percent-encoding.'):r}var o;return a.key=t,n?a.pathname?\"/\"!==a.pathname.charAt(0)&&(a.pathname=((r,e=\"\")=>{let t,n=e&&e.split(\"/\")||[],a=0;const o=r&&r.split(\"/\")||[],s=r&&p(r),i=e&&p(e),l=s||i;if(r&&p(r)?n=o:o.length&&(n.pop(),n=n.concat(o)),!n.length)return\"/\";if(n.length){const r=n[n.length-1];t=\".\"===r||\"..\"===r||\"\"===r}else t=!1;for(let r=n.length;r>=0;r--){const e=n[r];\".\"===e?h(n,r):\"..\"===e?(h(n,r),a++):a&&(h(n,r),a--)}if(!l)for(;a--;a)n.unshift(\"..\");!l||\"\"===n[0]||n[0]&&p(n[0])||n.unshift(\"\");let c=n.join(\"/\");return t&&\"/\"!==c.substr(-1)&&(c+=\"/\"),c})(a.pathname,n.pathname)):a.pathname=n.pathname:a.pathname||(a.pathname=\"/\"),a.query=(o=a.search||\"\")?(/^[?#]/.test(o)?o.slice(1):o).split(\"&\").reduce((r,e)=>{let[t,n]=e.split(\"=\");return r[t]=n?decodeURIComponent(n.replace(/\\+/g,\" \")):\"\",r},{}):{},a};let E=0;const x={},R=(r,e={})=>{\"string\"==typeof e&&(e={path:e});const{path:t=\"/\",exact:n=!1,strict:a=!1}=e,{re:s,keys:i}=((r,e)=>{const t=`${e.end}${e.strict}`,n=x[t]||(x[t]={}),a=JSON.stringify(r);if(n[a])return n[a];const s=[],i={re:o(r,s,e),keys:s};return E<1e4&&(n[a]=i,E+=1),i})(t,{end:n,strict:a}),l=s.exec(r);if(!l)return null;const[c,...u]=l,f=r===c;return n&&!f?null:{path:t,url:\"/\"===t&&\"\"===c?\"/\":c,isExact:f,params:i.reduce((r,e,t)=>(r[e.name]=u[t],r),{})}},m=(r,e)=>null==r&&null==e||null!=e&&r&&e&&r.path===e.path&&r.url===e.url&&v(r.params,e.params),$=(r,e,t)=>t(r.confirm(e)),O=r=>r.metaKey||r.altKey||r.ctrlKey||r.shiftKey,_=r=>{const e=r.navigator.userAgent;return(-1===e.indexOf(\"Android 2.\")&&-1===e.indexOf(\"Android 4.0\")||-1===e.indexOf(\"Mobile Safari\")||-1!==e.indexOf(\"Chrome\")||-1!==e.indexOf(\"Windows Phone\"))&&r.history&&\"pushState\"in r.history},b=r=>-1===r.userAgent.indexOf(\"Trident\"),w=r=>-1===r.userAgent.indexOf(\"Firefox\"),A=(r,e)=>void 0===e.state&&-1===r.userAgent.indexOf(\"CriOS\"),j=(r,e)=>{const t=r[e],n=\"__storage_test__\";try{return t.setItem(n,n),t.removeItem(n),!0}catch(r){return r instanceof DOMException&&(22===r.code||1014===r.code||\"QuotaExceededError\"===r.name||\"NS_ERROR_DOM_QUOTA_REACHED\"===r.name)&&0!==t.length}};export{m as a,_ as b,b as c,l as d,c as e,y as f,d as g,s as h,i,f as j,$ as k,A as l,R as m,w as n,u as o,g as p,O as q,j as s}"
},
{
"path": "screenshot/compare/build/p-b4cc611c.entry.js",
"content": "import{r as t,g as e}from\"./p-fbbae598.js\";import{A as s}from\"./p-e2efe0df.js\";class i{constructor(e){t(this,e),this.titleSuffix=\"\",this.pageTitle=\"\"}updateDocumentTitle(){const t=this.el;t.ownerDocument&&(t.ownerDocument.title=`${this.pageTitle}${this.titleSuffix||\"\"}`)}componentWillLoad(){this.updateDocumentTitle()}get el(){return e(this)}static get watchers(){return{pageTitle:[\"updateDocumentTitle\"]}}}s.injectProps(i,[\"titleSuffix\"]);export{i as stencil_route_title}"
},
{
"path": "screenshot/compare/build/p-d1bf53f5.entry.js",
"content": "import{r as t,h as i,g as s}from\"./p-fbbae598.js\";import{A as h}from\"./p-e2efe0df.js\";import{m as a,q as e}from\"./p-9b6a9315.js\";class r{constructor(i){t(this,i),this.unsubscribe=()=>{},this.activeClass=\"link-active\",this.exact=!1,this.strict=!0,this.custom=\"a\",this.match=null}componentWillLoad(){this.computeMatch()}computeMatch(){this.location&&(this.match=a(this.location.pathname,{path:this.urlMatch||this.url,exact:this.exact,strict:this.strict}))}handleClick(t){var i,s;if(!e(t)&&this.history&&this.url&&this.root)return t.preventDefault(),this.history.push((s=this.root,\"/\"==(i=this.url).charAt(0)&&\"/\"==s.charAt(s.length-1)?s.slice(0,s.length-1)+i:s+i))}render(){let t={class:{[this.activeClass]:null!==this.match},onClick:this.handleClick.bind(this)};return this.anchorClass&&(t.class[this.anchorClass]=!0),\"a\"===this.custom&&(t=Object.assign({},t,{href:this.url,title:this.anchorTitle,role:this.anchorRole,tabindex:this.anchorTabIndex,\"aria-haspopup\":this.ariaHaspopup,id:this.anchorId,\"aria-posinset\":this.ariaPosinset,\"aria-setsize\":this.ariaSetsize,\"aria-label\":this.ariaLabel})),i(this.custom,Object.assign({},t),i(\"slot\",null))}get el(){return s(this)}static get watchers(){return{location:[\"computeMatch\"]}}}h.injectProps(r,[\"history\",\"location\",\"root\"]);export{r as stencil_route_link}"
},
{
"path": "screenshot/compare/build/p-e2efe0df.js",
"content": "import{h as t}from\"./p-fbbae598.js\";const e=(()=>{let e=new Map,r={historyType:\"browser\",location:{pathname:\"\",query:{},key:\"\"},titleSuffix:\"\",root:\"/\",routeViewsUpdated:()=>{}};const o=(t,e)=>{Array.isArray(t)?[...t].forEach(t=>{e[t]=r[t]}):e[t]=Object.assign({},r)},s=(t,r)=>(e.has(t)||(e.set(t,r),o(r,t)),()=>{e.has(t)&&e.delete(t)});return{Provider:({state:t},s)=>(r=t,e.forEach(o),s),Consumer:(e,r)=>((e,r)=>t(\"context-consumer\",{subscribe:e,renderer:r}))(s,r[0]),injectProps:(t,r)=>{const o=t.prototype,n=o.connectedCallback,i=o.disconnectedCallback;o.connectedCallback=function(){if(s(this,r),n)return n.call(this)},o.disconnectedCallback=function(){e.delete(this),i&&i.call(this)}}}})();export{e as A}"
},
{
"path": "screenshot/compare/build/p-e8ca6d97.entry.js",
"content": "import{r as t,g as r}from\"./p-fbbae598.js\";import{A as s}from\"./p-e2efe0df.js\";class i{constructor(r){t(this,r)}componentWillLoad(){if(this.history&&this.root&&this.url)return this.history.replace((r=this.root,\"/\"==(t=this.url).charAt(0)&&\"/\"==r.charAt(r.length-1)?r.slice(0,r.length-1)+t:r+t));var t,r}get el(){return r(this)}}s.injectProps(i,[\"history\",\"root\"]);export{i as stencil_router_redirect}"
},
{
"path": "screenshot/compare/build/p-ec2f13e0.entry.js",
"content": "import{r as t,h as e}from\"./p-fbbae598.js\";class n{constructor(e){t(this,e),this.content=\"\"}componentWillLoad(){if(null!=this.documentLocation)return this.fetchNewContent(this.documentLocation)}fetchNewContent(t){return fetch(t).then(t=>t.text()).then(t=>{this.content=t})}render(){return e(\"div\",{innerHTML:this.content})}static get watchers(){return{documentLocation:[\"fetchNewContent\"]}}}export{n as stencil_async_content}"
},
{
"path": "screenshot/compare/build/p-f0b99977.entry.js",
"content": "import{r as t,g as s}from\"./p-fbbae598.js\";class e{constructor(s){t(this,s),this.context={},this.renderer=()=>null}connectedCallback(){null!=this.subscribe&&(this.unsubscribe=this.subscribe(this.el,\"context\"))}disconnectedCallback(){null!=this.unsubscribe&&this.unsubscribe()}render(){return this.renderer(Object.assign({},this.context))}get el(){return s(this)}}export{e as context_consumer}"
},
{
"path": "screenshot/compare/build/p-f4745c2f.entry.js",
"content": "import{r as t,d as s,h as i,g as e}from\"./p-fbbae598.js\";import{s as n}from\"./p-081b0641.js\";const h={threshold:.1,includeAA:!1,alpha:.1,aaColor:[255,255,0],diffColor:[255,0,0],diffColorAlt:null,diffMask:!1};function o(t){return ArrayBuffer.isView(t)&&1===t.constructor.BYTES_PER_ELEMENT}function r(t,s,i,e,n,h){const o=Math.max(s-1,0),r=Math.max(i-1,0),c=Math.min(s+1,e-1),d=Math.min(i+1,n-1),f=4*(i*e+s);let u,p,m,g,w=s===o||s===c||i===r||i===d?1:0,y=0,v=0;for(let n=o;n<=c;n++)for(let h=r;h<=d;h++){if(n===s&&h===i)continue;const o=l(t,t,f,4*(h*e+n),!0);if(0===o){if(w++,w>2)return!1}else ov&&(v=o,m=n,g=h)}return 0!==y&&0!==v&&(a(t,u,p,e,n)&&a(h,u,p,e,n)||a(t,m,g,e,n)&&a(h,m,g,e,n))}function a(t,s,i,e,n){const h=Math.max(s-1,0),o=Math.max(i-1,0),r=Math.min(s+1,e-1),a=Math.min(i+1,n-1),l=4*(i*e+s);let c=s===h||s===r||i===o||i===a?1:0;for(let n=h;n<=r;n++)for(let h=o;h<=a;h++){if(n===s&&h===i)continue;const o=4*(h*e+n);if(t[l]===t[o]&&t[l+1]===t[o+1]&&t[l+2]===t[o+2]&&t[l+3]===t[o+3]&&c++,c>2)return!0}return!1}function l(t,s,i,e,n){let h=t[i+0],o=t[i+1],r=t[i+2],a=t[i+3],l=s[e+0],p=s[e+1],m=s[e+2],g=s[e+3];if(a===g&&h===l&&o===p&&r===m)return 0;a<255&&(a/=255,h=u(h,a),o=u(o,a),r=u(r,a)),g<255&&(g/=255,l=u(l,g),p=u(p,g),m=u(m,g));const w=c(h,o,r),y=c(l,p,m),v=w-y;if(n)return v;const b=d(h,o,r)-d(l,p,m),x=f(h,o,r)-f(l,p,m),M=.5053*v*v+.299*b*b+.1957*x*x;return w>y?-M:M}function c(t,s,i){return.29889531*t+.58662247*s+.11448223*i}function d(t,s,i){return.59597799*t-.2741761*s-.32180189*i}function f(t,s,i){return.21147017*t-.52261711*s+.31114694*i}function u(t,s){return 255+(t-255)*s}function p(t,s,i,e,n){t[s+0]=i,t[s+1]=e,t[s+2]=n,t[s+3]=255}function m(t,s,i,e){const n=u(c(t[s+0],t[s+1],t[s+2]),i*t[s+3]/255);p(e,s,n,n,n)}function g(t,s,i){if(y.has(s))return void i(y.get(s));if(w.has(s))return void w.get(s).push(i);w.set(s,[i]);const e=document.createElement(\"script\");e.src=`${t}screenshot_${s}.js`,document.head.appendChild(e)}window.loadScreenshot=(t,s)=>{const i=w.get(t);i&&(i.forEach(t=>t(s)),w.delete(t)),y.set(t,s)};const w=new Map,y=new Map;class v{constructor(i){t(this,i),this.imageASrc=null,this.imageBSrc=null,this.imageAClass=\"is-loading\",this.imageBClass=\"is-loading\",this.canvasClass=\"is-loading\",this.imagesLoaded=new Set,this.isImageALoaded=!1,this.isImageBLoaded=!1,this.isMismatchInitialized=!1,this.hasCalculatedMismatch=!1,this.compareLoaded=s(this,\"compareLoaded\",7)}componentWillLoad(){this.loadScreenshots()}componentWillUpdate(){this.loadScreenshots()}loadScreenshots(){if(this.show&&this.diff.hasIntersected)return this.diff.identical?(this.imageASrc=this.imagesUrl+this.diff.imageA,this.isImageALoaded=!0,this.imageAClass=\"has-loaded\",this.imageBSrc=this.imagesUrl+this.diff.imageB,this.isImageBLoaded=!0,void(this.imageBClass=\"has-loaded\")):void(this.isMismatchInitialized||(this.isMismatchInitialized=!0,null!=this.jsonpUrl?(null!=this.diff.imageA&&g(this.jsonpUrl,this.diff.imageA,t=>{this.imageASrc=t}),null!=this.diff.imageB&&g(this.jsonpUrl,this.diff.imageB,t=>{this.imageBSrc=t})):(this.imageASrc=this.imagesUrl+this.diff.imageA,this.imageBSrc=this.imagesUrl+this.diff.imageB)))}async compareImages(){const t=this.diff;this.isImageALoaded&&this.isImageBLoaded&&!this.hasCalculatedMismatch&&t.comparable&&(this.hasCalculatedMismatch=!0,t.mismatchedPixels=await function(t,s,i,e,n,a){let c=-1;try{const d=document.createElement(\"canvas\");d.width=e,d.height=n;const f=document.createElement(\"canvas\");f.width=e,f.height=n;const u=d.getContext(\"2d\");u.drawImage(t,0,0);const g=f.getContext(\"2d\");g.drawImage(s,0,0);const w=document.createElement(\"canvas\").getContext(\"2d\");w.drawImage(t,0,0),w.getImageData(0,0,e,n);const y=u.getImageData(0,0,e,n).data,v=g.getImageData(0,0,e,n).data,b=i.getContext(\"2d\"),x=b.createImageData(e,d.height);c=function(t,s,i,e,n,a){if(!o(t)||!o(s)||i&&!o(i))throw new Error(\"Image data: Uint8Array, Uint8ClampedArray or Buffer expected.\");if(t.length!==s.length||i&&i.length!==t.length)throw new Error(\"Image sizes do not match.\");if(t.length!==e*n*4)throw new Error(\"Image data size does not match width/height.\");a=Object.assign({},h,a);const c=e*n,d=new Uint32Array(t.buffer,t.byteOffset,c),f=new Uint32Array(s.buffer,s.byteOffset,c);let u=!0;for(let t=0;tg?a.includeAA||!r(t,o,h,e,n,s)&&!r(s,o,h,e,n,t)?(i&&p(i,c,...d<0&&a.diffColorAlt||a.diffColor),w++):i&&!a.diffMask&&p(i,c,...a.aaColor):i&&(a.diffMask||m(t,c,a.alpha,i))}return w}(y,v,x.data,e,n,{threshold:a}),b.putImageData(x,0,0)}catch(t){console.error(t)}return c}(this.imageA,this.imageB,this.canvas,Math.round(t.width*t.deviceScaleFactor),Math.round(t.height*t.deviceScaleFactor),t.threshold),this.canvasClass=\"has-loaded\",n(t.imageA,t.imageB,t.mismatchedPixels,t.threshold),this.compareLoaded.emit(t))}render(){const t=this.diff,s={width:t.width+\"px\",height:t.height+\"px\"};return[i(\"compare-cell\",null,null!=t.imageA?i(\"a\",{href:this.imagesUrl+t.imageA,target:\"_blank\"},i(\"img\",{src:this.imageASrc,class:this.imageAClass,style:s,onLoad:this.diff.identical?null:()=>{this.isImageALoaded=!0,this.imageAClass=\"has-loaded\",this.compareImages()},ref:t=>this.imageA=t})):i(\"img\",{style:s,class:\"is-loading\"})),i(\"compare-cell\",null,null!=t.imageB?i(\"a\",{href:this.imagesUrl+t.imageB,target:\"_blank\"},i(\"img\",{src:this.imageBSrc,class:this.imageBClass,style:s,onLoad:this.diff.identical?null:()=>{this.isImageBLoaded=!0,this.imageBClass=\"has-loaded\",this.compareImages()},ref:t=>this.imageB=t})):i(\"img\",{style:s,class:\"is-loading\"})),i(\"compare-cell\",null,this.diff.identical?i(\"img\",{style:s,src:this.imageASrc}):i(\"canvas\",{width:Math.round(t.width*t.deviceScaleFactor),height:Math.round(t.height*t.deviceScaleFactor),class:this.canvasClass,style:s,hidden:!t.comparable,ref:t=>this.canvas=t})),i(\"compare-cell\",null,i(\"compare-analysis\",{aId:this.aId,bId:this.bId,mismatchedPixels:this.diff.mismatchedPixels,diff:this.diff}))]}get elm(){return e(this)}}v.style=\"compare-row img,compare-row canvas{display:block;box-shadow:var(--screenshot-box-shadow);border-radius:var(--screenshot-border-radius)}compare-row a{display:block}.is-loading{visibility:hidden}\";class b{constructor(s){t(this,s)}render(){if(!this.a||!this.b||!this.diffs)return;let t=0;this.diffs.forEach(s=>{s.width>t&&(t=s.width)}),t-=6;const s={width:t+\"px\"};return[i(\"th-cell\",null,i(\"div\",{style:s},i(\"a\",{href:this.a.url,target:\"_blank\"},this.a.message))),i(\"th-cell\",null,i(\"div\",{style:s},i(\"a\",{href:this.b.url,target:\"_blank\"},this.b.message))),i(\"th-cell\",null,i(\"div\",{style:s},i(\"a\",{href:`https://github.com/ionic-team/ionic/compare/${this.a.id}...${this.b.id}`,target:\"_blank\"},\"Compare: \",this.a.id,\" - \",this.b.id))),i(\"th-cell\",{class:\"analysis\"},i(\"div\",null,\"Analysis\"))]}}b.style=\":host{display:flex}th-cell{display:block;flex:1;font-weight:500;font-size:12px}th-cell div{padding-left:12px;padding-right:12px;overflow:hidden;white-space:nowrap;text-overflow:ellipsis}th-cell a{color:var(--font-color);text-decoration:none}th-cell a:hover{color:var(--analysis-data-color);text-decoration:underline}.analysis div{width:262px}\";export{v as compare_row,b as compare_thead}"
},
{
"path": "screenshot/compare/build/p-fbbae598.js",
"content": "let e,t,n,l=!1,o=!1,s=!1,r=0,i=!1;const c=\"undefined\"!=typeof window?window:{},a=c.document||{head:{}},f={t:0,l:\"\",jmp:e=>e(),raf:e=>requestAnimationFrame(e),ael:(e,t,n,l)=>e.addEventListener(t,n,l),rel:(e,t,n,l)=>e.removeEventListener(t,n,l)},u=e=>Promise.resolve(e),d=(()=>{try{return new CSSStyleSheet,!0}catch(e){}return!1})(),p={},$=(e,t,n)=>{n&&n.map(([n,l,o])=>{const s=e,r=m(t,o),i=h(n);f.ael(s,l,r,i),(t.o=t.o||[]).push(()=>f.rel(s,l,r,i))})},m=(e,t)=>n=>{256&e.t?e.s[t](n):(e.i=e.i||[]).push([t,n])},h=e=>0!=(2&e),y=\"http://www.w3.org/1999/xlink\",b=new WeakMap,w=e=>\"sc-\"+e.u,k={},v=e=>\"object\"==(e=typeof e)||\"function\"===e,g=(e,t,...n)=>{let l=null,o=null,s=null,r=!1,i=!1,c=[];const a=t=>{for(let n=0;ne[t]).join(\" \"))}}if(\"function\"==typeof e)return e(null===t?{}:t,c,M);const f=S(e,null);return f.$=t,c.length>0&&(f.m=c),f.h=o,f.k=s,f},S=(e,t)=>({t:0,v:e,p:t,g:null,m:null,$:null,h:null,k:null}),j={},M={forEach:(e,t)=>e.map(U).forEach(t),map:(e,t)=>e.map(U).map(t).map(C)},U=e=>({vattrs:e.$,vchildren:e.m,vkey:e.h,vname:e.k,vtag:e.v,vtext:e.p}),C=e=>{const t=S(e.vtag,e.vtext);return t.$=e.vattrs,t.m=e.vchildren,t.h=e.vkey,t.k=e.vname,t},R=(e,t,n,l,o,s)=>{if(n!==l){let r=de(e,t),i=t.toLowerCase();if(\"class\"===t){const t=e.classList,o=L(n),s=L(l);t.remove(...o.filter(e=>e&&!s.includes(e))),t.add(...s.filter(e=>e&&!o.includes(e)))}else if(\"style\"===t){for(const t in n)l&&null!=l[t]||(t.includes(\"-\")?e.style.removeProperty(t):e.style[t]=\"\");for(const t in l)n&&l[t]===n[t]||(t.includes(\"-\")?e.style.setProperty(t,l[t]):e.style[t]=l[t])}else if(\"key\"===t);else if(\"ref\"===t)l&&l(e);else if(r||\"o\"!==t[0]||\"n\"!==t[1]){const c=v(l);if((r||c&&null!==l)&&!o)try{if(e.tagName.includes(\"-\"))e[t]=l;else{let o=null==l?\"\":l;\"list\"===t?r=!1:null!=n&&e[t]==o||(e[t]=o)}}catch(e){}let a=!1;i!==(i=i.replace(/^xlink\\:?/,\"\"))&&(t=i,a=!0),null==l||!1===l?a?e.removeAttributeNS(y,t):e.removeAttribute(t):(!r||4&s||o)&&!c&&(l=!0===l?\"\":l,a?e.setAttributeNS(y,t,l):e.setAttribute(t,l))}else t=\"-\"===t[2]?t.slice(3):de(c,i)?i.slice(2):i[2]+t.slice(3),n&&f.rel(e,t,n,!1),l&&f.ael(e,t,l,!1)}},x=/\\s/,L=e=>e?e.split(x):[],O=(e,t,n,l)=>{const o=11===t.g.nodeType&&t.g.host?t.g.host:t.g,s=e&&e.$||k,r=t.$||k;for(l in s)l in r||R(o,l,s[l],void 0,n,t.t);for(l in r)R(o,l,s[l],r[l],n,t.t)},P=(o,r,i,c)=>{let f,u,d,p=r.m[i],$=0;if(l||(s=!0,\"slot\"===p.v&&(e&&c.classList.add(e+\"-s\"),p.t|=p.m?2:1)),null!==p.p)f=p.g=a.createTextNode(p.p);else if(1&p.t)f=p.g=a.createTextNode(\"\");else if(f=p.g=a.createElement(2&p.t?\"slot-fb\":p.v),O(null,p,!1),null!=e&&f[\"s-si\"]!==e&&f.classList.add(f[\"s-si\"]=e),p.m)for($=0;${f.t|=1;const l=e.childNodes;for(let e=l.length-1;e>=0;e--){const o=l[e];o[\"s-hn\"]!==n&&o[\"s-ol\"]&&(A(o).insertBefore(o,q(o)),o[\"s-ol\"].remove(),o[\"s-ol\"]=void 0,s=!0),t&&T(o,t)}f.t&=-2},E=(e,t,l,o,s,r)=>{let i,c=e[\"s-cr\"]&&e[\"s-cr\"].parentNode||e;for(c.shadowRoot&&c.tagName===n&&(c=c.shadowRoot);s<=r;++s)o[s]&&(i=P(null,l,s,e),i&&(o[s].g=i,c.insertBefore(i,q(t))))},W=(e,t,n,l,s)=>{for(;t<=n;++t)(l=e[t])&&(s=l.g,z(l),o=!0,s[\"s-ol\"]?s[\"s-ol\"].remove():T(s,!0),s.remove())},D=(e,t)=>e.v===t.v&&(\"slot\"===e.v?e.k===t.k:e.h===t.h),q=e=>e&&e[\"s-ol\"]||e,A=e=>(e[\"s-ol\"]?e[\"s-ol\"]:e).parentNode,F=(e,t)=>{const n=t.g=e.g,l=e.m,o=t.m,s=t.p;let r;null===s?(\"slot\"===t.v||O(e,t,!1),null!==l&&null!==o?((e,t,n,l)=>{let o,s,r=0,i=0,c=0,a=0,f=t.length-1,u=t[0],d=t[f],p=l.length-1,$=l[0],m=l[p];for(;r<=f&&i<=p;)if(null==u)u=t[++r];else if(null==d)d=t[--f];else if(null==$)$=l[++i];else if(null==m)m=l[--p];else if(D(u,$))F(u,$),u=t[++r],$=l[++i];else if(D(d,m))F(d,m),d=t[--f],m=l[--p];else if(D(u,m))\"slot\"!==u.v&&\"slot\"!==m.v||T(u.g.parentNode,!1),F(u,m),e.insertBefore(u.g,d.g.nextSibling),u=t[++r],m=l[--p];else if(D(d,$))\"slot\"!==u.v&&\"slot\"!==m.v||T(d.g.parentNode,!1),F(d,$),e.insertBefore(d.g,u.g),d=t[--f],$=l[++i];else{for(c=-1,a=r;a<=f;++a)if(t[a]&&null!==t[a].h&&t[a].h===$.h){c=a;break}c>=0?(s=t[c],s.v!==$.v?o=P(t&&t[i],n,c,e):(F(s,$),t[c]=void 0,o=s.g),$=l[++i]):(o=P(t&&t[i],n,i,e),$=l[++i]),o&&A(u.g).insertBefore(o,q(u.g))}r>f?E(e,null==l[p+1]?null:l[p+1].g,n,l,i,p):i>p&&W(t,r,f)})(n,l,t,o):null!==o?(null!==e.p&&(n.textContent=\"\"),E(n,null,t,o,0,o.length-1)):null!==l&&W(l,0,l.length-1)):(r=n[\"s-cr\"])?r.parentNode.textContent=s:e.p!==s&&(n.data=s)},N=e=>{let t,n,l,o,s,r,i=e.childNodes;for(n=0,l=i.length;n{let t,n,l,s,r,i,c=0,a=e.childNodes,f=a.length;for(;c=0;i--)n=l[i],n[\"s-cn\"]||n[\"s-nr\"]||n[\"s-hn\"]===t[\"s-hn\"]||(_(n,s)?(r=H.find(e=>e.S===n),o=!0,n[\"s-sn\"]=n[\"s-sn\"]||s,r?r.j=t:H.push({j:t,S:n}),n[\"s-sr\"]&&H.map(e=>{_(e.S,n[\"s-sn\"])&&(r=H.find(e=>e.S===n),r&&!e.j&&(e.j=r.j))})):H.some(e=>e.S===n)||H.push({S:n}));1===t.nodeType&&V(t)}},_=(e,t)=>1===e.nodeType?null===e.getAttribute(\"slot\")&&\"\"===t||e.getAttribute(\"slot\")===t:e[\"s-sn\"]===t||\"\"===t,z=e=>{e.$&&e.$.ref&&e.$.ref(null),e.m&&e.m.map(z)},B=e=>ae(e).M,G=(e,t,n)=>{const l=B(e);return{emit:e=>I(l,t,{bubbles:!!(4&n),composed:!!(2&n),cancelable:!!(1&n),detail:e})}},I=(e,t,n)=>{const l=new CustomEvent(t,n);return e.dispatchEvent(l),l},J=(e,t)=>{t&&!e.U&&t[\"s-p\"]&&t[\"s-p\"].push(new Promise(t=>e.U=t))},K=(e,t)=>{if(e.t|=16,!(4&e.t))return J(e,e.C),Me(()=>Q(e,t));e.t|=512},Q=(e,t)=>{const n=e.s;let l;return t?(e.t|=256,e.i&&(e.i.map(([e,t])=>te(n,e,t)),e.i=null),l=te(n,\"componentWillLoad\")):l=te(n,\"componentWillUpdate\"),ne(l,()=>X(e,n,t))},X=(r,i,c)=>{const u=r.M,d=u[\"s-rc\"];c&&(e=>{const t=e.R,n=e.M,l=t.t,o=((e,t)=>{let n=w(t),l=he.get(n);if(e=11===e.nodeType?e:a,l)if(\"string\"==typeof l){let t,o=b.get(e=e.head||e);o||b.set(e,o=new Set),o.has(n)||(t=a.createElement(\"style\"),t.innerHTML=l,e.insertBefore(t,e.querySelector(\"link\")),o&&o.add(n))}else e.adoptedStyleSheets.includes(l)||(e.adoptedStyleSheets=[...e.adoptedStyleSheets,l]);return n})(n.shadowRoot?n.shadowRoot:n.getRootNode(),t);10&l&&(n[\"s-sc\"]=o,n.classList.add(o+\"-h\"))})(r),((r,i)=>{const c=r.M,u=r.R,d=r.L||S(null,null),p=(e=>e&&e.v===j)(i)?i:g(null,null,i);if(n=c.tagName,u.O&&(p.$=p.$||{},u.O.map(([e,t])=>p.$[t]=c[e])),p.v=null,p.t|=4,r.L=p,p.g=d.g=c.shadowRoot||c,e=c[\"s-sc\"],t=c[\"s-cr\"],l=0!=(1&u.t),o=!1,F(d,p),f.t|=1,s){let e,t,n,l,o,s;V(p.g);let r=0;for(;re()),u[\"s-rc\"]=void 0);{const e=u[\"s-p\"],t=()=>Z(r);0===e.length?t():(Promise.all(e).then(t),r.t|=4,e.length=0)}},Y=(e,t)=>{try{t=t.render&&t.render(),e.t&=-17,e.t|=2}catch(e){pe(e)}return t},Z=e=>{const t=e.M,n=e.s,l=e.C;64&e.t?te(n,\"componentDidUpdate\"):(e.t|=64,le(t),te(n,\"componentDidLoad\"),e.P(t),l||ee()),e.U&&(e.U(),e.U=void 0),512&e.t&&Se(()=>K(e,!1)),e.t&=-517},ee=()=>{le(a.documentElement),f.t|=2,Se(()=>I(c,\"appload\",{detail:{namespace:\"app\"}}))},te=(e,t,n)=>{if(e&&e[t])try{return e[t](n)}catch(e){pe(e)}},ne=(e,t)=>e&&e.then?e.then(t):t(),le=e=>e.classList.add(\"hydrated\"),oe=(e,t,n)=>{if(t.T){e.watchers&&(t.W=e.watchers);const l=Object.entries(t.T),o=e.prototype;if(l.map(([e,[l]])=>{(31&l||2&n&&32&l)&&Object.defineProperty(o,e,{get(){return((e,t)=>ae(this).D.get(t))(0,e)},set(n){((e,t,n,l)=>{const o=ae(this),s=o.D.get(t),r=o.t,i=o.s;if(n=((e,t)=>null==e||v(e)?e:4&t?\"false\"!==e&&(\"\"===e||!!e):2&t?parseFloat(e):1&t?e+\"\":e)(n,l.T[t][0]),!(8&r&&void 0!==s||n===s)&&(o.D.set(t,n),i)){if(l.W&&128&r){const e=l.W[t];e&&e.map(e=>{try{i[e](n,s,t)}catch(e){pe(e)}})}2==(18&r)&&K(o,!1)}})(0,e,n,t)},configurable:!0,enumerable:!0})}),1&n){const n=new Map;o.attributeChangedCallback=function(e,t,l){f.jmp(()=>{const t=n.get(e);this[t]=(null!==l||\"boolean\"!=typeof this[t])&&l})},e.observedAttributes=l.filter(([e,t])=>15&t[0]).map(([e,l])=>{const o=l[1]||e;return n.set(o,e),512&l[0]&&t.O.push([e,o]),o})}}return e},se=e=>{te(e,\"connectedCallback\")},re=(e,t={})=>{const n=[],l=t.exclude||[],o=c.customElements,s=a.head,r=s.querySelector(\"meta[charset]\"),i=a.createElement(\"style\"),u=[];let p,m=!0;Object.assign(f,t),f.l=new URL(t.resourcesUrl||\"./\",a.baseURI).href,t.syncQueue&&(f.t|=4),e.map(e=>e[1].map(t=>{const s={t:t[0],u:t[1],T:t[2],q:t[3]};s.T=t[2],s.q=t[3],s.O=[],s.W={};const r=s.u,i=class extends HTMLElement{constructor(e){super(e),ue(e=this,s),1&s.t&&e.attachShadow({mode:\"open\"})}connectedCallback(){p&&(clearTimeout(p),p=null),m?u.push(this):f.jmp(()=>(e=>{if(0==(1&f.t)){const t=ae(e),n=t.R,l=()=>{};if(1&t.t)$(e,t,n.q),se(t.s);else{t.t|=1,12&n.t&&(e=>{const t=e[\"s-cr\"]=a.createComment(\"\");t[\"s-cn\"]=!0,e.insertBefore(t,e.firstChild)})(e);{let n=e;for(;n=n.parentNode||n.host;)if(n[\"s-p\"]){J(t,t.C=n);break}}n.T&&Object.entries(n.T).map(([t,[n]])=>{if(31&n&&e.hasOwnProperty(t)){const n=e[t];delete e[t],e[t]=n}}),Se(()=>(async(e,t,n,l,o)=>{if(0==(32&t.t)){t.t|=32;{if((o=me(n)).then){const e=()=>{};o=await o,e()}o.isProxied||(n.W=o.watchers,oe(o,n,2),o.isProxied=!0);const e=()=>{};t.t|=8;try{new o(t)}catch(e){pe(e)}t.t&=-9,t.t|=128,e(),se(t.s)}const e=w(n);if(!he.has(e)&&o.style){const t=()=>{};((e,t,n)=>{let l=he.get(e);d&&n?(l=l||new CSSStyleSheet,l.replace(t)):l=t,he.set(e,l)})(e,o.style,!!(1&n.t)),t()}}const s=t.C,r=()=>K(t,!0);s&&s[\"s-rc\"]?s[\"s-rc\"].push(r):r()})(0,t,n))}l()}})(this))}disconnectedCallback(){f.jmp(()=>(()=>{if(0==(1&f.t)){const e=ae(this),t=e.s;e.o&&(e.o.map(e=>e()),e.o=void 0),te(t,\"disconnectedCallback\"),te(t,\"componentDidUnload\")}})())}forceUpdate(){(()=>{{const e=ae(this);e.M.isConnected&&2==(18&e.t)&&K(e,!1)}})()}componentOnReady(){return ae(this).A}};s.F=e[0],l.includes(r)||o.get(r)||(n.push(r),o.define(r,oe(i,s,1)))})),i.innerHTML=n+\"{visibility:hidden}.hydrated{visibility:inherit}\",i.setAttribute(\"data-styles\",\"\"),s.insertBefore(i,r?r.nextSibling:s.firstChild),m=!1,u.length?u.map(e=>e.connectedCallback()):f.jmp(()=>p=setTimeout(ee,30))},ie=(e,t)=>t in p?p[t]:\"window\"===t?c:\"document\"===t?a:\"isServer\"!==t&&\"isPrerender\"!==t&&(\"isClient\"===t||(\"resourcesUrl\"===t||\"publicPath\"===t?(()=>{const e=new URL(\".\",f.l);return e.origin!==c.location.origin?e.href:e.pathname})():\"queue\"===t?{write:Me,read:je,tick:{then:e=>Se(e)}}:void 0)),ce=new WeakMap,ae=e=>ce.get(e),fe=(e,t)=>ce.set(t.s=e,t),ue=(e,t)=>{const n={t:0,M:e,R:t,D:new Map};return n.A=new Promise(e=>n.P=e),e[\"s-p\"]=[],e[\"s-rc\"]=[],$(e,n,t.q),ce.set(e,n)},de=(e,t)=>t in e,pe=e=>console.error(e),$e=new Map,me=e=>{const t=e.u.replace(/-/g,\"_\"),n=e.F,l=$e.get(n);return l?l[t]:import(`./${n}.entry.js`).then(e=>($e.set(n,e),e[t]),pe)},he=new Map,ye=[],be=[],we=[],ke=(e,t)=>n=>{e.push(n),i||(i=!0,t&&4&f.t?Se(ge):f.raf(ge))},ve=(e,t)=>{let n=0,l=0;for(;n{r++,(e=>{for(let t=0;t0&&(we.push(...be),be.length=0),(i=ye.length+be.length+we.length>0)?f.raf(ge):r=0}},Se=e=>u().then(e),je=ke(ye,!1),Me=ke(be,!0),Ue=()=>u(),Ce=()=>{const e=import.meta.url,t={};return\"\"!==e&&(t.resourcesUrl=new URL(\".\",e).href),u(t)};export{Ue as a,re as b,ie as c,G as d,B as g,g as h,Ce as p,fe as r}"
},
{
"path": "screenshot/compare/host.config.json",
"content": "{\n \"hosting\": {\n \"headers\": [\n {\n \"source\": \"/build/p-*\",\n \"headers\": [\n {\n \"key\": \"Cache-Control\",\n \"value\": \"max-age=31556952, s-maxage=31556952, immutable\"\n }\n ]\n }\n ]\n }\n}"
},
{
"path": "screenshot/compare/index.html",
"content": " Stencil Screenshot Visual Diff ) {\n const opts = getOptions(process.cwd(), {\n isProd: args.includes('--prod'),\n isCI: args.includes('--ci'),\n isWatch: args.includes('--watch'),\n });\n\n try {\n if (args.includes('--release')) {\n await release(rootDir, args);\n return;\n }\n\n if (args.includes('--validate-build')) {\n await validateBuild(rootDir);\n return;\n }\n await buildAll(opts);\n } catch (e) {\n console.error(e);\n process.exit(1);\n }\n}\n\nexport async function buildAll(opts: BuildOptions) {\n await Promise.all([\n buildCli(opts),\n buildCompiler(opts),\n buildDevServer(opts),\n buildMockDoc(opts),\n buildScreenshot(opts),\n buildSysNode(opts),\n buildTesting(opts),\n buildInternal(opts),\n ]);\n}\n"
},
{
"path": "scripts/esbuild/cli.ts",
"content": "import type { BuildOptions as ESBuildOptions } from 'esbuild';\nimport fs from 'fs-extra';\nimport { join } from 'path';\n\nimport { getBanner } from '../utils/banner';\nimport { BuildOptions } from '../utils/options';\nimport { writePkgJson } from '../utils/write-pkg-json';\nimport { externalNodeModules, getBaseEsbuildOptions, getEsbuildAliases, runBuilds } from './utils';\n\n/**\n * Runs esbuild to bundle the `cli` submodule\n *\n * @param opts build options\n * @returns a promise for this bundle's build output\n */\nexport async function buildCli(opts: BuildOptions) {\n // clear out rollup stuff\n await fs.emptyDir(opts.output.cliDir);\n\n const inputDir = join(opts.srcDir, 'cli');\n const buildDir = join(opts.buildDir, 'cli');\n\n const outputDir = opts.output.cliDir;\n const esmFilename = 'index.js';\n const cjsFilename = 'index.cjs';\n\n const dtsFilename = 'index.d.ts';\n\n const cliAliases = getEsbuildAliases();\n // this isn't strictly necessary to alias - however, this minimizes cuts down the bundle size by ~70kb.\n cliAliases['prompts'] = 'prompts/lib/index.js';\n\n const external = [...externalNodeModules, '../testing/*'];\n\n const cliEsbuildOptions = {\n ...getBaseEsbuildOptions(),\n alias: cliAliases,\n entryPoints: [join(inputDir, 'index.ts')],\n external,\n platform: 'node',\n } satisfies ESBuildOptions;\n\n // ESM build options\n const esmOptions: ESBuildOptions = {\n ...cliEsbuildOptions,\n outfile: join(outputDir, esmFilename),\n format: 'esm',\n banner: {\n js: getBanner(opts, `Stencil CLI`, true),\n },\n };\n\n // CommonJS build options\n const cjsOptions: ESBuildOptions = {\n ...cliEsbuildOptions,\n outfile: join(outputDir, cjsFilename),\n platform: 'node',\n format: 'cjs',\n banner: {\n js: getBanner(opts, `Stencil CLI (CommonJS)`, true),\n },\n };\n\n // create public d.ts\n let dts = await fs.readFile(join(buildDir, 'public.d.ts'), 'utf8');\n dts = dts.replace('@stencil/core/internal', '../internal/index');\n await fs.writeFile(join(opts.output.cliDir, dtsFilename), dts);\n\n // copy config-flags.d.ts\n let configDts = await fs.readFile(join(buildDir, 'config-flags.d.ts'), 'utf8');\n configDts = configDts.replace('@stencil/core/declarations', '../internal/index');\n await fs.writeFile(join(opts.output.cliDir, 'config-flags.d.ts'), configDts);\n\n // write cli/package.json\n writePkgJson(opts, opts.output.cliDir, {\n name: '@stencil/core/cli',\n description: 'Stencil CLI.',\n main: cjsFilename,\n module: esmFilename,\n types: dtsFilename,\n });\n\n return runBuilds([esmOptions, cjsOptions], opts);\n}\n"
},
{
"path": "scripts/esbuild/compiler.ts",
"content": "import type { BuildOptions as ESBuildOptions } from 'esbuild';\nimport { replace } from 'esbuild-plugin-replace';\nimport fs from 'fs-extra';\nimport { join } from 'path';\n\nimport { getBanner } from '../utils/banner';\nimport { BuildOptions, createReplaceData } from '../utils/options';\nimport { writePkgJson } from '../utils/write-pkg-json';\nimport { externalNodeModules, getBaseEsbuildOptions, getEsbuildAliases, runBuilds } from './utils';\nimport { bundleParse5 } from './utils/parse5';\nimport { bundleTerser } from './utils/terser';\nimport { bundleTypeScriptSource, tsCacheFilePath } from './utils/typescript-source';\n\nexport async function buildCompiler(opts: BuildOptions) {\n const inputDir = join(opts.buildDir, 'compiler');\n const srcDir = join(opts.srcDir, 'compiler');\n const compilerFileName = 'stencil.js';\n const compilerDtsName = compilerFileName.replace('.js', '.d.ts');\n\n // clear out rollup stuff and ensure directory exists\n await fs.emptyDir(opts.output.compilerDir);\n\n // create public d.ts\n let dts = await fs.readFile(join(inputDir, 'public.d.ts'), 'utf8');\n dts = dts.replace('@stencil/core/internal', '../internal/index');\n await fs.writeFile(join(opts.output.compilerDir, compilerDtsName), dts);\n\n // write @stencil/core/compiler/package.json\n writePkgJson(opts, opts.output.compilerDir, {\n name: '@stencil/core/compiler',\n description: 'Stencil Compiler.',\n main: compilerFileName,\n types: compilerDtsName,\n });\n\n // copy and edit compiler/sys/in-memory-fs.d.ts\n let inMemoryFsDts = await fs.readFile(join(inputDir, 'sys', 'in-memory-fs.d.ts'), 'utf8');\n inMemoryFsDts = inMemoryFsDts.replace('@stencil/core/internal', '../../internal/index');\n await fs.ensureDir(join(opts.output.compilerDir, 'sys'));\n await fs.writeFile(join(opts.output.compilerDir, 'sys', 'in-memory-fs.d.ts'), inMemoryFsDts);\n\n // copy and edit compiler/transpile.d.ts\n let transpileDts = await fs.readFile(join(inputDir, 'transpile.d.ts'), 'utf8');\n transpileDts = transpileDts.replace('@stencil/core/internal', '../internal/index');\n await fs.writeFile(join(opts.output.compilerDir, 'transpile.d.ts'), transpileDts);\n\n const alias: Record = {\n ...getEsbuildAliases(),\n glob: './sys/node/glob.js',\n '@sys-api-node': '../sys/node/index.js',\n };\n\n const external = [\n ...externalNodeModules,\n '../mock-doc/index.cjs',\n '../sys/node/autoprefixer.js',\n '../sys/node/index.js',\n ];\n\n // get replace data, which replaces certain strings within the output with\n // build-time constants.\n //\n // this setup was originally designed for use with the Rollup `replace`\n // plugin, but there is an esbuild plugin which provides equivalent\n // functionality\n //\n // note that the `bundleTypeScriptSource` function implicitly depends on\n // `createReplaceData` being called before it\n const replaceData = createReplaceData(opts);\n\n // stuff to patch typescript before bundling\n const tsPath = require.resolve('typescript');\n await bundleTypeScriptSource(tsPath, opts);\n const tsFilePath = tsCacheFilePath(opts);\n alias['typescript'] = tsFilePath;\n\n // same for terser\n const [, terserPath] = await bundleTerser(opts);\n alias['terser'] = terserPath;\n\n // and parse5\n const [, parse5path] = await bundleParse5(opts);\n alias['parse5'] = parse5path;\n\n const compilerEsbuildOptions: ESBuildOptions = {\n ...getBaseEsbuildOptions(),\n banner: { js: getBanner(opts, 'Stencil Compiler', true) },\n entryPoints: [join(srcDir, 'index.ts')],\n platform: 'node',\n external,\n format: 'cjs',\n alias,\n plugins: [replace(replaceData)],\n outfile: join(opts.output.compilerDir, compilerFileName),\n // workaround for fdir https://github.com/thecodrr/fdir/issues/163\n inject: [join(opts.bundleHelpersDir, 'import-meta-url.js')],\n define: {\n 'import.meta.url': 'import_meta_url',\n },\n };\n\n // copy typescript default lib dts files\n const tsLibNames = await getTypeScriptDefaultLibNames(opts);\n await Promise.all(tsLibNames.map((f) => fs.copy(join(opts.typescriptLibDir, f), join(opts.output.compilerDir, f))));\n\n return runBuilds([compilerEsbuildOptions], opts);\n}\n\n/**\n * Helper function that reads in the `lib.*.d.ts` files in the TypeScript lib/ directory on disk.\n * @param opts the Stencil build options, which includes the location of the TypeScript lib/\n * @returns all file names that match the `lib.*.d.ts` format\n */\nasync function getTypeScriptDefaultLibNames(opts: BuildOptions): Promise {\n return (await fs.readdir(opts.typescriptLibDir)).filter((f) => f.startsWith('lib.') && f.endsWith('.d.ts'));\n}\n"
},
{
"path": "scripts/esbuild/dev-server.ts",
"content": "import { builtinModules } from 'node:module';\nimport { join } from 'node:path';\n\nimport type { BuildOptions as ESBuildOptions, Plugin } from 'esbuild';\nimport { replace } from 'esbuild-plugin-replace';\nimport fs from 'fs-extra';\nimport ts from 'typescript';\n\nimport { getBanner } from '../utils/banner';\nimport { type BuildOptions, createReplaceData } from '../utils/options';\nimport { writePkgJson } from '../utils/write-pkg-json';\nimport { externalAlias, getBaseEsbuildOptions, getEsbuildAliases, getFirstOutputFile, runBuilds } from './utils';\nimport { createContentTypeData } from './utils/content-types';\n\nconst CONNECTOR_NAME = 'connector.html';\n\n/**\n * Runs esbuild to bundle the `dev-server` submodule\n *\n * @param opts build options\n * @returns a promise for this bundle's build output\n */\nexport async function buildDevServer(opts: BuildOptions) {\n // create dir of not existing already\n await fs.ensureDir(opts.output.devServerDir);\n // clear out rollup stuff\n await fs.emptyDir(opts.output.devServerDir);\n\n const inputDir = join(opts.buildDir, 'dev-server');\n\n // create public d.ts\n let dts = await fs.readFile(join(opts.buildDir, 'dev-server', 'index.d.ts'), 'utf8');\n dts = dts.replace('../declarations', '../internal/index');\n await fs.writeFile(join(opts.output.devServerDir, 'index.d.ts'), dts);\n\n // write package.json\n writePkgJson(opts, opts.output.devServerDir, {\n name: '@stencil/core/dev-server',\n description: 'Stencil Development Server which communicates with the Stencil Compiler.',\n main: 'index.js',\n types: 'index.d.ts',\n });\n\n // copy static files\n await fs.copy(join(opts.srcDir, 'dev-server', 'static'), join(opts.output.devServerDir, 'static'));\n\n // copy server-worker-thread.js\n await fs.copy(\n join(opts.srcDir, 'dev-server', 'server-worker-thread.js'),\n join(opts.output.devServerDir, 'server-worker-thread.js'),\n );\n\n // copy template files\n await fs.copy(join(opts.srcDir, 'dev-server', 'templates'), join(opts.output.devServerDir, 'templates'));\n\n // open-in-editor's visualstudio.vbs file\n const visualstudioVbsSrc = join(opts.nodeModulesDir, 'open-in-editor', 'lib', 'editors', 'visualstudio.vbs');\n const visualstudioVbsDesc = join(opts.output.devServerDir, 'visualstudio.vbs');\n await fs.copy(visualstudioVbsSrc, visualstudioVbsDesc);\n\n // copy open's xdg-open file\n const xdgOpenSrcPath = join(opts.nodeModulesDir, 'open', 'xdg-open');\n const xdgOpenDestPath = join(opts.output.devServerDir, 'xdg-open');\n await fs.copy(xdgOpenSrcPath, xdgOpenDestPath);\n\n const external = [...builtinModules];\n const devServerAliases = {\n ...getEsbuildAliases(),\n glob: '../../sys/node/glob.js',\n '@stencil/core/mock-doc': '../../mock-doc/index.cjs',\n };\n const devServerIndexEsbuildOptions = {\n ...getBaseEsbuildOptions(),\n alias: devServerAliases,\n entryPoints: [join(inputDir, 'index.js')],\n outfile: join(opts.output.devServerDir, 'index.js'),\n external: ['@dev-server-process', ...external],\n format: 'cjs',\n platform: 'node',\n write: false,\n plugins: [serverProcessAliasPlugin(), replace(createReplaceData(opts))],\n banner: {\n js: getBanner(opts, `Stencil Dev Server`, true),\n },\n } satisfies ESBuildOptions;\n\n const devServerProcessEsbuildOptions = {\n ...getBaseEsbuildOptions(),\n alias: {\n ...devServerAliases,\n glob: '../../sys/node/glob.js',\n '@stencil/core/mock-doc': '../../mock-doc/index.cjs',\n '@sys-api-node': '../sys/node/index.js',\n },\n entryPoints: [join(inputDir, 'server-process.js')],\n outfile: join(opts.output.devServerDir, 'server-process.js'),\n external: [...external, '../sys/node/index.js'],\n format: 'cjs',\n platform: 'node',\n write: false,\n plugins: [\n esm2CJSPlugin(),\n contentTypesPlugin(opts),\n replace(createReplaceData(opts)),\n externalAlias('graceful-fs', '../sys/node/graceful-fs.js'),\n ],\n banner: {\n js: getBanner(opts, `Stencil Dev Server Process`, true),\n },\n } satisfies ESBuildOptions;\n\n const connectorAlias = {\n glob: '../../sys/node/glob.js',\n '@stencil/core/dev-server/client': join(inputDir, 'client', 'index.js'),\n '@stencil/core/mock-doc': '../../mock-doc/index.cjs',\n };\n const connectorEsbuildOptions = {\n ...getBaseEsbuildOptions(),\n alias: connectorAlias,\n entryPoints: [join(inputDir, 'dev-server-client', 'index.js')],\n outfile: join(opts.output.devServerDir, CONNECTOR_NAME),\n format: 'cjs',\n platform: 'node',\n write: false,\n plugins: [appErrorCssPlugin(opts), clientConnectorPlugin(opts), replace(createReplaceData(opts))],\n } satisfies ESBuildOptions;\n\n await fs.ensureDir(join(opts.output.devServerDir, 'client'));\n // copy dev server client dts files\n await fs.copy(join(opts.buildDir, 'dev-server', 'client'), join(opts.output.devServerDir, 'client'), {\n filter: (src) => {\n if (src.endsWith('.d.ts')) {\n return true;\n }\n const stats = fs.statSync(src);\n if (stats.isDirectory()) {\n return true;\n }\n return false;\n },\n });\n\n // write package.json\n writePkgJson(opts, join(opts.output.devServerDir, 'client'), {\n name: '@stencil/core/dev-server/client',\n description: 'Stencil Dev Server Client.',\n main: 'index.js',\n types: 'index.d.ts',\n });\n\n const devServerClientEsbuildOptions = {\n ...getBaseEsbuildOptions(),\n entryPoints: [join(opts.buildDir, 'dev-server', 'client', 'index.js')],\n outfile: join(opts.output.devServerDir, 'client', 'index.js'),\n format: 'esm',\n platform: 'node',\n plugins: [appErrorCssPlugin(opts), replace(createReplaceData(opts))],\n banner: {\n js: getBanner(opts, `Stencil Dev Server Client`, true),\n },\n } satisfies ESBuildOptions;\n\n return runBuilds(\n [\n devServerIndexEsbuildOptions,\n devServerProcessEsbuildOptions,\n connectorEsbuildOptions,\n devServerClientEsbuildOptions,\n ],\n opts,\n );\n}\n\n/**\n * Load CSS files and export them as a string\n * @param opts build options\n * @returns an esbuild plugin\n */\nfunction appErrorCssPlugin(opts: BuildOptions): Plugin {\n return {\n name: 'appErrorCss',\n setup(build) {\n build.onResolve({ filter: /app-error\\.css$/ }, () => ({\n path: join(opts.srcDir, 'dev-server', 'client', 'app-error.css'),\n }));\n build.onLoad({ filter: /app-error\\.css$/ }, async (args) => {\n const code = await fs.readFile(args.path, 'utf8');\n const css = code.replace(/\\n/g, ' ').trim();\n const minified = css.replace(/ /g, ' ');\n return { contents: `export default ${JSON.stringify(minified)};` };\n });\n },\n };\n}\n\n/**\n * Transform connector client script into a HTML file\n * @param opts build options\n * @returns an esbuild plugin\n */\nfunction clientConnectorPlugin(opts: BuildOptions): Plugin {\n return {\n name: 'clientConnectorPlugin',\n setup(build) {\n build.onEnd(async (buildResult) => {\n const bundle = buildResult.outputFiles?.find((b) => b.path.endsWith(CONNECTOR_NAME));\n if (!bundle) {\n throw \"Couldn't find build result!\";\n }\n let code = Buffer.from(bundle.contents).toString();\n\n const tsResults = ts.transpileModule(code, {\n compilerOptions: {\n target: ts.ScriptTarget.ES5,\n },\n });\n\n if (tsResults.diagnostics?.length) {\n throw new Error(tsResults.diagnostics as any);\n }\n\n code = tsResults.outputText;\n code = intro + code + outro;\n\n if (opts.isProd) {\n const { minify } = await import('terser');\n const minifyResults = await minify(code, {\n compress: { hoist_vars: true, hoist_funs: true, ecma: 5 },\n format: { ecma: 5 },\n });\n if (minifyResults.code) {\n code = minifyResults.code;\n }\n }\n\n code = banner + code + footer;\n code = code.replace(/__VERSION:STENCIL__/g, opts.version);\n return fs.writeFile(bundle.path, code);\n });\n },\n };\n}\n\n/**\n * esbuild plugin to support alias of dynamic import. Transforming a path within a dynamic import\n * does not seem to be supported yet.\n * @see https://github.com/evanw/esbuild/issues/700\n * @returns an esbuild plugin\n */\nfunction serverProcessAliasPlugin(): Plugin {\n return {\n name: 'serverProcessAlias',\n setup(build) {\n build.onEnd(async (buildResult) => {\n const bundle = getFirstOutputFile(buildResult);\n let code = Buffer.from(bundle.contents).toString();\n code = code.replace('await import(\"@dev-server-process\")', '(await import(\"./server-process.js\")).default');\n return fs.writeFile(bundle.path, code);\n });\n },\n };\n}\n\n/**\n * The `open` NPM package is build as ESM module and uses ESM runtime features like `import.meta.url`.\n * This plugin transforms this into CJS compliant code.\n * @returns an esbuild plugin\n */\nfunction esm2CJSPlugin(): Plugin {\n return {\n name: 'esm2CJS',\n setup(build) {\n build.onEnd(async (buildResult) => {\n const bundle = getFirstOutputFile(buildResult);\n let code = Buffer.from(bundle.contents).toString();\n code = code.replace('import_meta.url', 'new (require(\"url\").URL)(\"file:\" + __filename).href');\n return fs.writeFile(bundle.path, code);\n });\n },\n };\n}\n\n/**\n * Populates the `content-types-db.json` file with the content types of the `mime-db` package.\n * @param opts build options\n * @returns an esbuild plugin\n */\nfunction contentTypesPlugin(opts: BuildOptions): Plugin {\n return {\n name: 'contentTypesPlugin',\n setup(build) {\n build.onLoad({ filter: /content-types-db\\.json$/ }, async () => {\n const contents = await createContentTypeData(opts);\n return { contents };\n });\n },\n };\n}\n\nconst banner = `Stencil Dev Server Connector __VERSION:STENCIL__ ⚡ \n\nStencil Dev Server Connector __VERSION:STENCIL__ ⚡\n\n`;\n"
},
{
"path": "scripts/esbuild/helpers/empty.js",
"content": "module.exports = {};\n"
},
{
"path": "scripts/esbuild/helpers/import-meta-url.js",
"content": "export var import_meta_url = require('url').pathToFileURL(__filename);\n"
},
{
"path": "scripts/esbuild/helpers/jest/jest-environment.js",
"content": "const { getCreateJestPuppeteerEnvironment } = require('./index.js');\nconst createJestPuppeteerEnvironment = getCreateJestPuppeteerEnvironment();\nmodule.exports = createJestPuppeteerEnvironment();\n"
},
{
"path": "scripts/esbuild/helpers/jest/jest-preprocessor.js",
"content": "const { getJestPreprocessor } = require('./index.js');\nconst jestPreprocessor = getJestPreprocessor();\nmodule.exports = jestPreprocessor;\n"
},
{
"path": "scripts/esbuild/helpers/jest/jest-preset.js",
"content": "const { getJestPreset } = require('./index.js');\nmodule.exports = getJestPreset();\n"
},
{
"path": "scripts/esbuild/helpers/jest/jest-runner.js",
"content": "const { getCreateJestTestRunner } = require('./index.js');\nconst createTestRunner = getCreateJestTestRunner();\nmodule.exports = createTestRunner();\n"
},
{
"path": "scripts/esbuild/helpers/jest/jest-setuptestframework.js",
"content": "const { getJestSetupTestFramework } = require('./index.js');\nconst jestSetupTestFramework = getJestSetupTestFramework();\njestSetupTestFramework();\n"
},
{
"path": "scripts/esbuild/helpers/lazy-require.js",
"content": "// eslint-disable-next-line @typescript-eslint/no-unused-vars\nfunction _lazyRequire(moduleId) {\n return new Proxy(\n {},\n {\n get(_target, propertyKey) {\n const importedModule = require(moduleId);\n return Reflect.get(importedModule, propertyKey);\n },\n set(_target, propertyKey, value) {\n const importedModule = require(moduleId);\n return Reflect.set(importedModule, propertyKey, value);\n },\n },\n );\n}\n"
},
{
"path": "scripts/esbuild/helpers/path-is-absolute.js",
"content": "import { isAbsolute } from 'path';\n\nexport default isAbsolute;\n"
},
{
"path": "scripts/esbuild/internal-app-data.ts",
"content": "import type { BuildOptions as ESBuildOptions } from 'esbuild';\nimport fs from 'fs-extra';\nimport { join } from 'path';\n\nimport { BuildOptions } from '../utils/options';\nimport { writePkgJson } from '../utils/write-pkg-json';\nimport { getBaseEsbuildOptions } from './utils';\n\n/**\n * Get an object containing ESbuild options to build the internal app data\n * file. This function also performs relevant side-effects, like writing a\n * `package.json` file to disk.\n *\n * @param opts build options\n * @returns a Promise wrapping an array of ESbuild option objects\n */\nexport async function getInternalAppDataBundles(opts: BuildOptions): Promise {\n const appDataBuildDir = join(opts.buildDir, 'app-data');\n const appDataSrcDir = join(opts.srcDir, 'app-data');\n const outputInternalAppDataDir = join(opts.output.internalDir, 'app-data');\n\n await fs.emptyDir(outputInternalAppDataDir);\n\n // copy @stencil/core/internal/app-data/index.d.ts\n await fs.copyFile(join(appDataBuildDir, 'index.d.ts'), join(outputInternalAppDataDir, 'index.d.ts'));\n\n // write @stencil/core/internal/app-data/package.json\n writePkgJson(opts, outputInternalAppDataDir, {\n name: '@stencil/core/internal/app-data',\n description: 'Used for default app data and build conditionals within builds.',\n main: 'index.cjs',\n module: 'index.js',\n types: 'index.d.ts',\n sideEffects: false,\n });\n\n const appDataBaseOptions: ESBuildOptions = {\n ...getBaseEsbuildOptions(),\n entryPoints: [join(appDataSrcDir, 'index.ts')],\n platform: 'node',\n };\n\n const appDataESM: ESBuildOptions = {\n ...appDataBaseOptions,\n format: 'esm',\n outfile: join(outputInternalAppDataDir, 'index.js'),\n };\n\n const appDataCJS: ESBuildOptions = {\n ...appDataBaseOptions,\n format: 'cjs',\n outfile: join(outputInternalAppDataDir, 'index.cjs'),\n };\n\n return [appDataESM, appDataCJS];\n}\n"
},
{
"path": "scripts/esbuild/internal-app-globals.ts",
"content": "import type { BuildOptions as ESBuildOptions } from 'esbuild';\nimport fs from 'fs-extra';\nimport { join } from 'path';\n\nimport { BuildOptions } from '../utils/options';\nimport { writePkgJson } from '../utils/write-pkg-json';\nimport { getBaseEsbuildOptions } from './utils';\n\n/**\n * Get an object containing ESbuild options to build the internal app globals\n * file. This function also performs relevant side-effects, like writing a\n * `package.json` file to disk.\n *\n * @param opts build options\n * @returns a Promise wrapping an array of ESbuild option objects\n */\nexport async function getInternalAppGlobalsBundles(opts: BuildOptions): Promise {\n const appGlobalsBuildDir = join(opts.buildDir, 'app-globals');\n const appGlobalsSrcDir = join(opts.srcDir, 'app-globals');\n const outputInternalAppDataDir = join(opts.output.internalDir, 'app-globals');\n\n await fs.emptyDir(outputInternalAppDataDir);\n\n // copy @stencil/core/internal/app-globals/index.d.ts\n await fs.copyFile(join(appGlobalsBuildDir, 'index.d.ts'), join(outputInternalAppDataDir, 'index.d.ts'));\n\n // write @stencil/core/internal/app-globals/package.json\n writePkgJson(opts, outputInternalAppDataDir, {\n name: '@stencil/core/internal/app-globals',\n description: 'Used for default app globals.',\n main: 'index.js',\n module: 'index.js',\n sideEffects: false,\n });\n\n const appGlobalsBaseOptions: ESBuildOptions = {\n ...getBaseEsbuildOptions(),\n entryPoints: [join(appGlobalsSrcDir, 'index.ts')],\n platform: 'node',\n };\n\n const appGlobalsESM: ESBuildOptions = {\n ...appGlobalsBaseOptions,\n format: 'esm',\n outfile: join(outputInternalAppDataDir, 'index.js'),\n };\n\n return [appGlobalsESM];\n}\n"
},
{
"path": "scripts/esbuild/internal-platform-client.ts",
"content": "import type { BuildOptions as ESBuildOptions, Plugin } from 'esbuild';\nimport { replace } from 'esbuild-plugin-replace';\nimport fs from 'fs-extra';\nimport { glob } from 'glob';\nimport { join } from 'path';\n\nimport { getBanner } from '../utils/banner';\nimport { BuildOptions, createReplaceData } from '../utils/options';\nimport { writePkgJson } from '../utils/write-pkg-json';\nimport { externalAlias, externalNodeModules, getBaseEsbuildOptions, getEsbuildAliases } from './utils';\n\n/**\n * Create objects containing ESbuild options for the two bundles which need to\n * be written to `internal/client`. This also performs relevant side-effects,\n * like clearing out the directory and writing a `package.json` script to disk.\n *\n * @param opts build options\n * @returns an array of ESBuild option objects\n */\nexport async function getInternalClientBundles(opts: BuildOptions): Promise {\n const inputClientDir = join(opts.srcDir, 'client');\n const outputInternalClientDir = join(opts.output.internalDir, 'client');\n const outputInternalClientPolyfillsDir = join(outputInternalClientDir, 'polyfills');\n\n await fs.emptyDir(outputInternalClientDir);\n await fs.emptyDir(outputInternalClientPolyfillsDir);\n\n await copyPolyfills(opts, outputInternalClientPolyfillsDir);\n\n // write @stencil/core/internal/client/package.json\n writePkgJson(opts, outputInternalClientDir, {\n name: '@stencil/core/internal/client',\n description:\n 'Stencil internal client platform to be imported by the Stencil Compiler and internal runtime. Breaking changes can and will happen at any time.',\n exports: './index.js',\n main: './index.js',\n type: 'module',\n sideEffects: false,\n });\n\n const internalClientAliases = getEsbuildAliases();\n internalClientAliases['@platform'] = join(inputClientDir, 'index.ts');\n\n const clientExternal = externalNodeModules;\n\n const internalClientBundle: ESBuildOptions = {\n ...getBaseEsbuildOptions(),\n entryPoints: [join(inputClientDir, 'index.ts')],\n format: 'esm',\n // we do 'write: false' here because we write the build to disk in our\n // `findAndReplaceLoadModule` plugin below\n write: false,\n outfile: join(outputInternalClientDir, 'index.js'),\n platform: 'node',\n external: clientExternal,\n alias: internalClientAliases,\n banner: {\n js: getBanner(opts, 'Stencil Client Platform'),\n },\n plugins: [\n replace(createReplaceData(opts)),\n externalAlias('@app-data', '@stencil/core/internal/app-data'),\n externalAlias('@app-globals', '@stencil/core/internal/app-globals'),\n externalAlias('@utils/shadow-css', './shadow-css.js'),\n findAndReplaceLoadModule(),\n ],\n };\n\n const patchBrowserAliases = getEsbuildAliases();\n\n const polyfills = await fs.readdir(join(opts.srcDir, 'client', 'polyfills'));\n for (const polyFillFile of polyfills) {\n patchBrowserAliases[`polyfills/${polyFillFile}`] = join(opts.srcDir, 'client', 'polyfills');\n }\n\n const patchBrowserExternal = [...externalNodeModules, '@stencil/core', '@stencil/core/mock-doc'];\n\n const internalClientPatchBrowserBundle: ESBuildOptions = {\n ...getBaseEsbuildOptions(),\n entryPoints: [join(inputClientDir, 'client-patch-browser.ts')],\n format: 'esm',\n outfile: join(outputInternalClientDir, 'patch-browser.js'),\n platform: 'node',\n external: patchBrowserExternal,\n alias: patchBrowserAliases,\n banner: {\n js: getBanner(opts, 'Stencil Client Patch Browser'),\n },\n plugins: [\n replace(createReplaceData(opts)),\n externalAlias('@platform', '@stencil/core'),\n externalAlias('@app-data', '@stencil/core/internal/app-data'),\n externalAlias('@app-globals', '@stencil/core/internal/app-globals'),\n ],\n };\n\n return [internalClientBundle, internalClientPatchBrowserBundle];\n}\n\n/**\n * We need to manually find-and-replace a bit of code in\n * `client-load-module.ts` in order to prevent Esbuild from analyzing /\n * transforming the input by ensuring it does not start with `\"./\"`. However\n * some _other_ bundlers will _not_ work with such an import if it _lacks_ a\n * leading `\"./\"`, so we thus we have to do a little dance where we manually\n * replace it here after it's been run through Esbuild.\n *\n * @returns an Esbuild plugin\n */\nexport function findAndReplaceLoadModule(): Plugin {\n return {\n name: 'findAndReplaceLoadModule',\n setup(build) {\n build.onEnd(async (result) => {\n for (const file of result.outputFiles!) {\n const { path, text } = file;\n\n await fs.writeFile(path, text.replace(/\\${MODULE_IMPORT_PREFIX}/, './'));\n }\n });\n },\n };\n}\n\nasync function copyPolyfills(opts: BuildOptions, outputInternalClientPolyfillsDir: string) {\n const srcPolyfillsDir = join(opts.srcDir, 'client', 'polyfills');\n\n const srcPolyfillFiles = glob.sync('*.js', { cwd: srcPolyfillsDir });\n\n await Promise.all(\n srcPolyfillFiles.map(async (fileName) => {\n const src = join(srcPolyfillsDir, fileName);\n const dest = join(outputInternalClientPolyfillsDir, fileName);\n await fs.copyFile(src, dest);\n }),\n );\n}\n"
},
{
"path": "scripts/esbuild/internal-platform-hydrate.ts",
"content": "import type { BuildOptions as ESBuildOptions } from 'esbuild';\nimport fs from 'fs-extra';\nimport { join } from 'path';\n\nimport { getBanner } from '../utils/banner';\nimport { bundleDts } from '../utils/bundle-dts';\nimport { BuildOptions } from '../utils/options';\nimport { writePkgJson } from '../utils/write-pkg-json';\nimport { externalAlias, externalNodeModules, getBaseEsbuildOptions, getEsbuildAliases } from './utils';\n\n/**\n * Create objects containing ESbuild options for the two bundles comprising\n * the hydrate platform. This also performs relevant side-effects, like\n * clearing out a directory and writing a `package.json` script to disk.\n *\n * @param opts build options\n * @returns an array of ESBuild option objects\n */\nexport async function getInternalPlatformHydrateBundles(opts: BuildOptions): Promise {\n const inputHydrateDir = join(opts.buildDir, 'hydrate');\n const hydrateSrcDir = join(opts.srcDir, 'hydrate');\n const outputInternalHydrateDir = join(opts.output.internalDir, 'hydrate');\n\n await fs.emptyDir(outputInternalHydrateDir);\n\n // write @stencil/core/internal/hydrate/package.json\n writePkgJson(opts, outputInternalHydrateDir, {\n name: '@stencil/core/internal/hydrate',\n description:\n 'Stencil internal hydrate platform to be imported by the Stencil Compiler. Breaking changes can and will happen at any time.',\n main: 'index.js',\n });\n\n await createHydrateRunnerDtsBundle(opts, inputHydrateDir, outputInternalHydrateDir);\n\n const hydratePlatformInput = join(hydrateSrcDir, 'platform', 'index.js');\n\n const external = externalNodeModules;\n\n const internalHydrateAliases = getEsbuildAliases();\n internalHydrateAliases['@platform'] = hydratePlatformInput;\n\n const internalHydratePlatformBundle: ESBuildOptions = {\n ...getBaseEsbuildOptions(),\n entryPoints: [hydratePlatformInput],\n format: 'esm',\n platform: 'node',\n outfile: join(outputInternalHydrateDir, 'index.js'),\n external,\n alias: internalHydrateAliases,\n banner: {\n js: getBanner(opts, 'Stencil Hydrate Platform'),\n },\n plugins: [\n externalAlias('@utils/shadow-css', '../client/shadow-css.js'),\n externalAlias('@app-data', '@stencil/core/internal/app-data'),\n externalAlias('@app-globals', '@stencil/core/internal/app-globals'),\n ],\n };\n\n const internalHydrateRunnerBundle: ESBuildOptions = {\n ...getBaseEsbuildOptions(),\n entryPoints: [join(hydrateSrcDir, 'runner', 'index.js')],\n external,\n format: 'esm',\n platform: 'node',\n outfile: join(outputInternalHydrateDir, 'runner.js'),\n banner: {\n js: getBanner(opts, 'Stencil Hydrate Runner'),\n },\n plugins: [\n externalAlias('@utils/shadow-css', '../client/shadow-css.js'),\n externalAlias('@app-data', '@stencil/core/internal/app-data'),\n externalAlias('@hydrate-factory', '@stencil/core/hydrate-factory'),\n ],\n };\n\n return [internalHydratePlatformBundle, internalHydrateRunnerBundle];\n}\n\nasync function createHydrateRunnerDtsBundle(opts: BuildOptions, inputHydrateDir: string, outputDir: string) {\n // bundle @stencil/core/internal/hydrate/runner.d.ts\n const dtsEntry = join(inputHydrateDir, 'runner', 'index.d.ts');\n const dtsContent = await bundleDts(opts, dtsEntry);\n\n const outputPath = join(outputDir, 'runner.d.ts');\n await fs.writeFile(outputPath, dtsContent);\n}\n"
},
{
"path": "scripts/esbuild/internal-platform-testing.ts",
"content": "import type { BuildOptions as ESBuildOptions } from 'esbuild';\nimport fs from 'fs-extra';\nimport { join } from 'path';\n\nimport { BuildOptions } from '../utils/options';\nimport { writePkgJson } from '../utils/write-pkg-json';\nimport { externalAlias, externalNodeModules, getBaseEsbuildOptions, getEsbuildAliases } from './utils';\n\n/**\n * Get an ESBuild configuration object for the internal testing bundle. This\n * function also has side-effects which set things up for the bundle to be built\n * correctly, like writing a `package.json` file to disk.\n *\n * @param opts build options\n * @returns a promise wrapping an object holding options for ESBuild\n */\nexport async function getInternalTestingBundle(opts: BuildOptions): Promise {\n const inputTestingPlatform = join(opts.srcDir, 'testing', 'platform', 'index.ts');\n const outputTestingPlatformDir = join(opts.output.internalDir, 'testing');\n\n await fs.emptyDir(outputTestingPlatformDir);\n\n // write @stencil/core/internal/testing/package.json\n writePkgJson(opts, outputTestingPlatformDir, {\n name: '@stencil/core/internal/testing',\n description:\n 'Stencil internal testing platform to be imported by the Stencil Compiler. Breaking changes can and will happen at any time.',\n main: 'index.js',\n });\n\n // Copy JSX runtime files for automatic JSX transform support\n const srcJsxDir = join(opts.srcDir, 'internal', 'testing');\n const jsxFiles = ['jsx-runtime.js', 'jsx-runtime.d.ts', 'jsx-dev-runtime.js', 'jsx-dev-runtime.d.ts'];\n await Promise.all(jsxFiles.map((file) => fs.copyFile(join(srcJsxDir, file), join(outputTestingPlatformDir, file))));\n\n const internalTestingAliases = {\n ...getEsbuildAliases(),\n '@platform': inputTestingPlatform,\n '@stencil/core/mock-doc': '../../mock-doc/index.cjs',\n };\n\n const external: string[] = [...externalNodeModules, '../../mock-doc/index.cjs'];\n\n const internalTestingBuildOptions: ESBuildOptions = {\n ...getBaseEsbuildOptions(),\n entryPoints: [inputTestingPlatform],\n bundle: true,\n format: 'cjs',\n outfile: join(outputTestingPlatformDir, 'index.js'),\n platform: 'node',\n logLevel: 'info',\n external,\n alias: internalTestingAliases,\n plugins: [\n externalAlias('@app-data', '@stencil/core/internal/app-data'),\n externalAlias('@utils/shadow-css', '../client/shadow-css.js'),\n ],\n };\n return internalTestingBuildOptions;\n}\n"
},
{
"path": "scripts/esbuild/internal.ts",
"content": "import { generateDtsBundle } from 'dts-bundle-generator';\nimport type { BuildOptions as ESBuildOptions } from 'esbuild';\nimport fs from 'fs-extra';\nimport { join } from 'path';\n\nimport { bundleDts, cleanDts } from '../utils/bundle-dts';\nimport type { BuildOptions } from '../utils/options';\nimport { writePkgJson } from '../utils/write-pkg-json';\nimport { getInternalAppDataBundles } from './internal-app-data';\nimport { getInternalAppGlobalsBundles } from './internal-app-globals';\nimport { getInternalClientBundles } from './internal-platform-client';\nimport { getInternalPlatformHydrateBundles } from './internal-platform-hydrate';\nimport { getInternalTestingBundle } from './internal-platform-testing';\nimport { getBaseEsbuildOptions, runBuilds } from './utils';\n\n/**\n * Run the build for the `internal/` directory, copying and modifying files\n * as-needed while also creating and then building the various bundles that need\n * to be written to `internal/`.\n *\n * @param opts Build options for the current build\n * @returns a Promise wrapping the state of the build\n */\nexport async function buildInternal(opts: BuildOptions) {\n const inputInternalDir = join(opts.buildDir, 'internal');\n\n await fs.emptyDir(opts.output.internalDir);\n\n await copyStencilInternalDts(opts, opts.output.internalDir);\n\n await copyUtilsDtsFiles(opts);\n\n await copyStencilCoreEntry(opts);\n\n // copy @stencil/core/internal default entry, which defaults to client\n // but we're not exposing all of Stencil's internal code (only the types)\n await fs.copyFile(join(inputInternalDir, 'default.js'), join(opts.output.internalDir, 'index.js'));\n\n // write @stencil/core/internal/package.json\n writePkgJson(opts, opts.output.internalDir, {\n name: '@stencil/core/internal',\n description:\n 'Stencil internals only to be imported by the Stencil Compiler. Breaking changes can and will happen at any time.',\n main: 'index.js',\n types: 'index.d.ts',\n sideEffects: false,\n });\n\n // this is used in several of our bundles, so we bundle it here in one spot\n const shadowCSSBundle: ESBuildOptions = {\n ...getBaseEsbuildOptions(),\n entryPoints: [join(opts.srcDir, 'utils', 'shadow-css.ts')],\n format: 'esm',\n outfile: join(opts.output.internalDir, 'client', 'shadow-css.js'),\n platform: 'node',\n };\n\n const clientPlatformBundles = await getInternalClientBundles(opts);\n const hydratePlatformBundles = await getInternalPlatformHydrateBundles(opts);\n const appDataBundles = await getInternalAppDataBundles(opts);\n const appGlobalsBundles = await getInternalAppGlobalsBundles(opts);\n const internalTestingBundle = await getInternalTestingBundle(opts);\n\n return runBuilds(\n [\n shadowCSSBundle,\n ...clientPlatformBundles,\n ...hydratePlatformBundles,\n internalTestingBundle,\n ...appDataBundles,\n ...appGlobalsBundles,\n ],\n opts,\n );\n}\n\nasync function copyStencilCoreEntry(opts: BuildOptions) {\n // write @stencil/core entry\n const stencilCoreSrcDir = join(opts.srcDir, 'internal', 'stencil-core');\n const stencilCoreDstDir = join(opts.output.internalDir, 'stencil-core');\n await fs.ensureDir(stencilCoreDstDir);\n await fs.copy(stencilCoreSrcDir, stencilCoreDstDir);\n}\n\n/**\n * Copy `.d.ts` files built from `src/utils` to `internal/utils` so that types\n * exported from utility modules can be referenced by other typedefs (in\n * particular by our declarations).\n *\n * Some modules within `@utils` incorporate external types which aren't bundled\n * so we selectively copy only `.d.ts` files which are 1) standalone and 2) export\n * a type that other modules in the codebase (in, for instance, `src/compiler/`\n * or `src/cli/`) depend on.\n *\n * @param opts options for the rollup build\n */\nconst copyUtilsDtsFiles = async (opts: BuildOptions) => {\n const outputDirPath = join(opts.output.internalDir, 'utils');\n await fs.ensureDir(outputDirPath);\n\n // copy the `.d.ts` file corresponding to `src/utils/result.ts`\n const resultDtsFilePath = join(opts.buildDir, 'utils', 'result.d.ts');\n const resultDtsOutputFilePath = join(opts.output.internalDir, 'utils', 'result.d.ts');\n await fs.copyFile(resultDtsFilePath, resultDtsOutputFilePath);\n\n const utilsIndexDtsPath = join(opts.output.internalDir, 'utils', 'index.d.ts');\n // here we write a simple module that re-exports `./result` so that imports\n // elsewhere like `import { result } from '@utils'` will resolve correctly\n await fs.writeFile(utilsIndexDtsPath, `export * as result from \"./result\"`);\n};\n\nasync function copyStencilInternalDts(opts: BuildOptions, outputInternalDir: string) {\n const declarationsInputDir = join(opts.buildDir, 'declarations');\n\n // copy to @stencil/core/internal\n\n // @stencil/core/internal/index.d.ts\n const indexDtsSrcPath = join(declarationsInputDir, 'index.d.ts');\n const indexDtsDestPath = join(outputInternalDir, 'index.d.ts');\n let indexDts = cleanDts(await fs.readFile(indexDtsSrcPath, 'utf8'));\n indexDts = prependExtModules(indexDts);\n await fs.writeFile(indexDtsDestPath, indexDts);\n\n // @stencil/core/internal/stencil-private.d.ts\n const privateDtsSrcPath = join(declarationsInputDir, 'stencil-private.d.ts');\n const privateDtsDestPath = join(outputInternalDir, 'stencil-private.d.ts');\n let privateDts = cleanDts(await fs.readFile(privateDtsSrcPath, 'utf8'));\n\n // @stencil/core/internal/child_process.d.ts\n const childProcessSrcPath = join(declarationsInputDir, 'child_process.d.ts');\n const childProcessDestPath = join(outputInternalDir, 'child_process.d.ts');\n\n // we generate a tiny tiny bundle here of just\n // `src/declarations/child_process.ts` so that `internal/stencil-private.d.ts`\n // can import from `'./child_process'` without worrying about resolving the\n // types from `node_modules`.\n const childProcessDts = generateDtsBundle([\n {\n filePath: childProcessSrcPath,\n libraries: {\n // we need to mark this library so that types imported from it are inlined\n inlinedLibraries: ['child_process'],\n },\n output: {\n noBanner: true,\n exportReferencedTypes: false,\n },\n },\n ]).join('\\n');\n await fs.writeFile(childProcessDestPath, childProcessDts);\n\n // the private `.d.ts` imports the `Result` type from the `@utils` module, so\n // we need to rewrite the path so it imports from the right relative path\n privateDts = privateDts.replace('@utils', './utils');\n await fs.writeFile(privateDtsDestPath, privateDts);\n\n // @stencil/core/internal/stencil-public.compiler.d.ts\n const compilerDtsSrcPath = join(declarationsInputDir, 'stencil-public-compiler.d.ts');\n const compilerDtsDestPath = join(outputInternalDir, 'stencil-public-compiler.d.ts');\n const compilerDts = cleanDts(await fs.readFile(compilerDtsSrcPath, 'utf8'));\n await fs.writeFile(compilerDtsDestPath, compilerDts);\n\n // @stencil/core/internal/stencil-public-docs.d.ts\n const docsDtsSrcPath = join(declarationsInputDir, 'stencil-public-docs.d.ts');\n const docsDtsDestPath = join(outputInternalDir, 'stencil-public-docs.d.ts');\n // We bundle with `dts-bundle-generator` here to ensure that when the `docs-json`\n // OT writes a `docs.d.ts` file based on this file it is fully portable.\n const docsDts = await bundleDts(opts, docsDtsSrcPath, {\n // we want to suppress the `dts-bundle-generator` banner here because we do\n // our own later on\n noBanner: true,\n // we also don't want the types which are inlined into our bundled file to\n // be re-exported, which will change the 'surface' of the module\n exportReferencedTypes: false,\n });\n await fs.writeFile(docsDtsDestPath, docsDts);\n\n // @stencil/core/internal/stencil-public-runtime.d.ts\n const runtimeDtsSrcPath = join(declarationsInputDir, 'stencil-public-runtime.d.ts');\n const runtimeDtsDestPath = join(outputInternalDir, 'stencil-public-runtime.d.ts');\n const runtimeDts = cleanDts(await fs.readFile(runtimeDtsSrcPath, 'utf8'));\n await fs.writeFile(runtimeDtsDestPath, runtimeDts);\n\n // @stencil/core/internal/stencil-ext-modules.d.ts (.svg/.css)\n const srcExtModuleOutput = join(opts.srcDir, 'declarations', 'stencil-ext-modules.d.ts');\n const dstExtModuleOutput = join(outputInternalDir, 'stencil-ext-modules.d.ts');\n await fs.copyFile(srcExtModuleOutput, dstExtModuleOutput);\n}\n\nfunction prependExtModules(content: string) {\n return `/// (async (resolveBundle, rejectBundle) => {\n const outputFile = path.join(outputDir, entryFileName);\n const cachedFile = path.join(cachedDir, entryFileName) + (opts.isProd ? '.min.js' : '');\n\n const cachedExists = fs.existsSync(cachedFile);\n if (cachedExists) {\n await fs.copyFile(cachedFile, outputFile);\n resolveBundle();\n return;\n }\n\n const whitelist = new Set(['child_process', 'os', 'typescript']);\n const webpackConfig: Configuration = {\n entry: path.join(opts.srcDir, 'sys', 'node', 'bundles', entryFileName),\n output: {\n path: outputDir,\n filename: entryFileName,\n libraryTarget: 'commonjs',\n },\n target: 'node',\n node: {\n __dirname: false,\n __filename: false,\n },\n externals(data, callback) {\n const { request } = data;\n\n if (request?.match(/^(\\.{0,2})\\//)) {\n // absolute and relative paths are not externals\n return callback(null, undefined);\n }\n\n if (request === '@stencil/core/mock-doc') {\n return callback(null, '../../mock-doc');\n }\n\n if (typeof request === 'string' && whitelist.has(request)) {\n // we specifically do not want to bundle these imports\n resolve.sync(request);\n return callback(null, request);\n }\n\n // bundle this import\n callback(undefined, undefined);\n },\n resolve: {\n alias: {\n '@utils': path.join(opts.buildDir, 'utils', 'index.js'),\n postcss: path.join(opts.nodeModulesDir, 'postcss'),\n 'source-map': path.join(opts.nodeModulesDir, 'source-map'),\n chalk: path.join(opts.bundleHelpersDir, 'empty.js'),\n },\n },\n optimization: {\n minimize: false,\n },\n mode: 'production',\n };\n\n console.log(`[sys-node] bundleExternal ${entryFileName} via webpack`);\n webpack(webpackConfig, async (err, stats) => {\n try {\n console.log(`[sys-node] bundleExternal ${entryFileName} success, err: ${err}, stats: ${stats}`);\n const { minify } = await import('terser');\n if (err && err.message) {\n rejectBundle(err);\n } else if (stats) {\n const info = stats.toJson({ errors: true });\n if (stats.hasErrors() && info && info.errors) {\n const webpackError = info.errors.join('\\n');\n rejectBundle(webpackError);\n } else {\n let code = await fs.readFile(outputFile, 'utf8');\n\n if (opts.isProd) {\n try {\n const minifyResults = await minify(code);\n if (minifyResults.code) {\n code = minifyResults.code;\n }\n } catch (e) {\n rejectBundle(e);\n return;\n }\n }\n await fs.writeFile(cachedFile, code);\n await fs.writeFile(outputFile, code);\n\n resolveBundle();\n }\n }\n } catch (e) {\n rejectBundle(e);\n }\n });\n });\n}\n"
},
{
"path": "scripts/esbuild/testing.ts",
"content": "import type { BuildOptions as ESBuildOptions, Plugin } from 'esbuild';\nimport fs from 'fs-extra';\nimport path from 'path';\n\nimport { getBanner } from '../utils/banner';\nimport type { BuildOptions } from '../utils/options';\nimport { writePkgJson } from '../utils/write-pkg-json';\nimport {\n externalAlias,\n externalNodeModules,\n getBaseEsbuildOptions,\n getEsbuildAliases,\n getFirstOutputFile,\n runBuilds,\n} from './utils';\n\nconst EXTERNAL_TESTING_MODULES = [\n 'constants',\n 'rollup',\n '@rollup/plugin-commonjs',\n '@rollup/plugin-node-resolve',\n 'yargs',\n 'zlib',\n];\n\nexport async function buildTesting(opts: BuildOptions) {\n const inputDir = path.join(opts.buildDir, 'testing');\n const sourceDir = path.join(opts.srcDir, 'testing');\n await fs.emptyDir(opts.output.testingDir);\n\n await Promise.all([\n // copy jest testing entry files\n fs.copy(path.join(opts.scriptsBundlesDir, 'helpers', 'jest'), opts.output.testingDir),\n copyTestingInternalDts(opts, inputDir),\n ]);\n\n // write package.json\n writePkgJson(opts, opts.output.testingDir, {\n name: '@stencil/core/testing',\n description: 'Stencil testing suite.',\n main: 'index.js',\n types: 'index.d.ts',\n });\n\n const external = [\n ...EXTERNAL_TESTING_MODULES,\n ...externalNodeModules,\n '../internal/testing/*',\n '../cli/index.cjs',\n '../sys/node/index.js',\n '../compiler/stencil.js',\n ];\n\n const aliases = getEsbuildAliases();\n const testingEsbuildOptions: ESBuildOptions = {\n ...getBaseEsbuildOptions(),\n entryPoints: [path.join(sourceDir, 'index.ts')],\n bundle: true,\n format: 'cjs',\n outfile: path.join(opts.output.testingDir, 'index.js'),\n platform: 'node',\n logLevel: 'info',\n external,\n /**\n * set `write: false` so that we can run the `onEnd` hook\n * in `lazyRequirePlugin` and modify the imports\n */\n write: false,\n alias: aliases,\n banner: { js: getBanner(opts, `Stencil Testing`, true) },\n plugins: [\n externalAlias('@app-data', '@stencil/core/internal/app-data'),\n externalAlias('@platform', '@stencil/core/internal/testing'),\n externalAlias('../internal/testing/index.js', '@stencil/core/internal/testing'),\n externalAlias('@stencil/core/dev-server', '../dev-server/index.js'),\n externalAlias('@stencil/core/mock-doc', '../mock-doc/index.cjs'),\n lazyRequirePlugin(opts, [\n '@stencil/core/internal/app-data',\n '@stencil/core/internal/testing',\n '../dev-server/index.js',\n '../internal/testing/index.js',\n '../mock-doc/index.cjs',\n ]),\n ignorePuppeteerDependency(opts),\n ],\n };\n\n return runBuilds([testingEsbuildOptions], opts);\n}\n\nfunction getLazyRequireFn(opts: BuildOptions) {\n return fs.readFileSync(path.join(opts.bundleHelpersDir, 'lazy-require.js'), 'utf8').trim();\n}\n\nfunction lazyRequirePlugin(opts: BuildOptions, moduleIds: string[]): Plugin {\n return {\n name: 'lazyRequirePlugin',\n setup(build) {\n build.onEnd(async (buildResult) => {\n const bundle = getFirstOutputFile(buildResult);\n let code = Buffer.from(bundle.contents).toString();\n\n for (const moduleId of moduleIds) {\n const str = `require(\"${moduleId}\")`;\n while (code.includes(str)) {\n code = code.replace(str, `_lazyRequire(\"${moduleId}\")`);\n }\n }\n\n code = code.replace(`\"use strict\";`, `\"use strict\";\\n\\n${getLazyRequireFn(opts)}`);\n return fs.writeFile(bundle.path, code);\n });\n },\n };\n}\n\n/**\n * To avoid having user to install puppeteer for building their app (even if\n * they don't use e2e testing), we ignore the puppeteer dependency in the\n * generated d.ts file.\n *\n * @param opts build options\n * @returns an ESbuild plugin\n */\nfunction ignorePuppeteerDependency(opts: BuildOptions): Plugin {\n return {\n name: 'ignorePuppeteerDependency',\n setup(build) {\n build.onEnd(async () => {\n await writePatchedPuppeteerDts(opts);\n });\n },\n };\n}\n\nexport async function copyTestingInternalDts(opts: BuildOptions, inputDir: string) {\n // copy testing d.ts files\n\n await fs.copy(path.join(inputDir), path.join(opts.output.testingDir), {\n filter: (f) => {\n if (f.endsWith('.d.ts')) {\n return true;\n }\n if (fs.statSync(f).isDirectory() && !f.includes('platform')) {\n return true;\n }\n return false;\n },\n });\n}\n\n/**\n * Write a patched version of\n * `src/testing/puppeteer/puppeteer-declarations.d.ts` which has a `@ts-ignore`\n * added to prevent a type-checking error if a Stencil project does not have\n * puppeteer installed.\n *\n * @param opts build options\n */\nexport async function writePatchedPuppeteerDts(opts: BuildOptions) {\n const typeFilePath = path.join(opts.output.testingDir, 'puppeteer', 'puppeteer-declarations.d.ts');\n const updatedFileContent = (await fs.readFile(typeFilePath, 'utf8'))\n .split('\\n')\n .reduce((lines, line) => {\n if (line.endsWith(`from 'puppeteer';`)) {\n lines.push('// @ts-ignore - avoid requiring puppeteer as dependency');\n }\n lines.push(line);\n return lines;\n }, [] as string[])\n .join('\\n');\n await fs.writeFile(typeFilePath, updatedFileContent);\n}\n"
},
{
"path": "scripts/esbuild/utils/alias-plugin.ts",
"content": "import { join } from 'path';\nimport type { PartialResolvedId, Plugin } from 'rollup';\n\nimport type { BuildOptions } from '../../utils/options';\n\n/**\n * Creates a rollup plugin for resolving identifiers while simultaneously externalizing them\n * @param opts the options being used during a build\n * @returns a rollup plugin with a build hook for resolving various identifiers\n */\nexport function aliasPlugin(opts: BuildOptions): Plugin {\n const alias = new Map([\n ['@app-data', '@stencil/core/internal/app-data'],\n ['@app-globals', '@stencil/core/internal/app-globals'],\n ['@hydrate-factory', '@stencil/core/hydrate-factory'],\n ['@stencil/core/mock-doc', '@stencil/core/mock-doc'],\n ['@stencil/core/testing', '@stencil/core/testing'],\n ['@dev-server-process', './server-process.js'],\n ]);\n\n // ensure we use the same one\n const helperResolvers = new Set(['is-resolvable', 'path-is-absolute']);\n\n // ensure we use the same one\n const nodeResolvers = new Map([['source-map', join(opts.nodeModulesDir, 'source-map', 'source-map.js')]]);\n\n const empty = new Set([\n // we never use chalk, but many projects still pull it in\n 'chalk',\n ]);\n\n return {\n name: 'aliasPlugin',\n /**\n * A rollup build hook for resolving identifiers. [Source](https://rollupjs.org/guide/en/#resolveid)\n * @param id the importee exactly as it is written in an import statement in the source code\n * @returns a resolution to an import to a different id, potentially externalizing it from the bundle simultaneously\n */\n resolveId(id: string): PartialResolvedId | string | null | undefined {\n const externalId = alias.get(id);\n if (externalId) {\n return {\n id: externalId,\n external: true,\n };\n }\n if (id === '@runtime') {\n return join(opts.buildDir, 'runtime', 'index.js');\n }\n if (id === '@utils') {\n return join(opts.buildDir, 'utils', 'index.js');\n }\n if (id === '@utils/shadow-css') {\n return join(opts.buildDir, 'utils', 'shadow-css.js');\n }\n if (id === '@environment') {\n return join(opts.buildDir, 'compiler', 'sys', 'environment.js');\n }\n if (id === '@sys-api-node') {\n return join(opts.buildDir, 'sys', 'node', 'index.js');\n }\n if (id === '@stencil/core/cli') {\n return join(opts.buildDir, 'cli', 'index.js');\n }\n if (helperResolvers.has(id)) {\n return join(opts.bundleHelpersDir, `${id}.js`);\n }\n if (empty.has(id)) {\n return join(opts.bundleHelpersDir, 'empty.js');\n }\n if (nodeResolvers.has(id)) {\n return nodeResolvers.get(id);\n }\n return null;\n },\n };\n}\n"
},
{
"path": "scripts/esbuild/utils/content-types.ts",
"content": "import fs from 'fs-extra';\nimport { join } from 'path';\n\nimport type { BuildOptions } from '../../utils/options';\n\nexport async function createContentTypeData(opts: BuildOptions) {\n // create a focused content-type lookup object from\n // the mime db json file\n const mimeDbSrcPath = join(opts.nodeModulesDir, 'mime-db', 'db.json');\n const mimeDbJson = await fs.readJson(mimeDbSrcPath);\n\n const extData: { ext: string; mimeType: string }[] = [];\n\n Object.keys(mimeDbJson).forEach((mimeType) => {\n const mimeTypeData = mimeDbJson[mimeType];\n if (Array.isArray(mimeTypeData.extensions)) {\n mimeTypeData.extensions.forEach((ext: string) => {\n extData.push({\n ext,\n mimeType,\n });\n });\n }\n });\n\n const exts: Record = {};\n extData\n .sort((a, b) => {\n if (a.ext < b.ext) return -1;\n if (a.ext > b.ext) return 1;\n return 0;\n })\n .forEach((x: any) => (exts[x.ext] = x.mimeType));\n\n return `export default ${JSON.stringify(exts)}`;\n}\n"
},
{
"path": "scripts/esbuild/utils/index.ts",
"content": "import type { BuildOptions as ESBuildOptions, BuildResult as ESBuildResult, OutputFile, Plugin } from 'esbuild';\nimport { build, context } from 'esbuild';\n\nimport { BuildOptions } from '../../utils/options';\n\n/**\n * Aliases which map the module identifiers we set in `paths` in `tsconfig.json` to\n * bundles (built either with esbuild or with rollup).\n *\n * @returns a map of aliases to bundle entry points, relative to the root directory\n */\nexport function getEsbuildAliases(): Record {\n return {\n // node module redirection\n chalk: 'ansi-colors',\n\n // mapping aliases to top-level bundle entrypoints\n '@stencil/core/testing': '../testing/index.js',\n '@stencil/core/compiler': '../compiler/stencil.js',\n '@stencil/core/dev-server': '../dev-server/index.js',\n '@stencil/core/mock-doc': '../mock-doc/index.cjs',\n '@stencil/core/internal/testing': '../internal/testing/index.js',\n '@stencil/core/cli': '../cli/index.cjs',\n '@sys-api-node': '../sys/node/index.js',\n };\n}\n\n/**\n * Node modules which should be universally marked as external\n *\n * Note that we should not rely on this to mark node.js built-in modules as\n * external. Doing so will override esbuild's automatic marking of those modules\n * as side-effect-free, which allows imports from them to be properly\n * tree-shaken.\n */\nexport const externalNodeModules = [\n '@jest/core',\n '@jest/reporters',\n '@microsoft/typescript-etw',\n 'expect',\n 'fsevents',\n 'jest',\n 'jest-cli',\n 'jest-config',\n 'jest-message-id',\n 'jest-pnp-resolver',\n 'jest-environment-node',\n 'jest-runner',\n 'puppeteer',\n 'puppeteer-core',\n 'yargs',\n];\n\n/**\n * A helper which runs an array of esbuild, uh, _builds_\n *\n * This accepts an array of build configurations and will either run a\n * synchronous build _or_ run them all in watch mode, depending on the\n * {@link BuildOptions['isWatch']} setting.\n *\n * @param builds the array of outputs to build\n * @param opts Stencil build options\n * @returns a Promise representing the execution of the builds\n */\nexport function runBuilds(builds: ESBuildOptions[], opts: BuildOptions): Promise<(void | ESBuildResult)[]> {\n if (opts.isWatch) {\n return Promise.all(\n builds.map(async (buildConfig) => {\n const ctx = await context(buildConfig);\n return ctx.watch();\n }),\n );\n } else {\n return Promise.all(builds.map(build));\n }\n}\n\n/**\n * Get base esbuild options which we want to always have set for all of our\n * bundles\n *\n * @returns a base set of options\n */\nexport function getBaseEsbuildOptions(): ESBuildOptions {\n const options: ESBuildOptions = {\n bundle: true,\n legalComments: 'inline',\n logLevel: 'info',\n target: getEsbuildTargets(),\n };\n\n // if the `build` sub-command is called with the `DEBUG` env var, like\n //\n // DEBUG=true npm run build\n //\n // then we should produce sourcemaps.\n if (process.env.DEBUG) {\n options.sourcemap = 'linked';\n }\n\n return options;\n}\n\n/**\n * Get build targets with minimal supported browser versions\n * @see https://stenciljs.com/docs/support-policy#browser-support\n * @returns an array of build targets\n */\nexport function getEsbuildTargets(): string[] {\n return ['node16', 'chrome79', 'edge79', 'firefox70', 'safari14'];\n}\n\n/**\n * Alias and mark a module as external at the same time\n *\n * @param moduleId the module ID to alias and externalize\n * @param resolveToPath the path to which imports of the module should be rewritten\n * @returns an Esbuild plugin\n */\nexport function externalAlias(moduleId: string, resolveToPath: string): Plugin {\n return {\n name: 'externalAliases',\n setup(build) {\n build.onResolve({ filter: new RegExp(`^${moduleId}$`) }, () => {\n return {\n path: resolveToPath,\n external: true,\n };\n });\n },\n };\n}\n\n/**\n * Extract the first {@link OutputFile} record from an Esbuild\n * {@link BuildResult}. This _may_ not be present, so in order to guarantee\n * type safety this function throws if such an `OutputFile` cannot be found.\n *\n * @throws if no `OutputFile` can be found.\n * @param buildResult the Esbuild build result in which to look\n * @returns the OutputFile\n */\nexport function getFirstOutputFile(buildResult: ESBuildResult): OutputFile {\n const bundle = buildResult.outputFiles?.[0];\n if (!bundle) {\n throw new Error('Could not find an output file in the BuildResult!');\n }\n return bundle;\n}\n"
},
{
"path": "scripts/esbuild/utils/parse5.ts",
"content": "import rollupCommonjs from '@rollup/plugin-commonjs';\nimport rollupResolve from '@rollup/plugin-node-resolve';\nimport fs from 'fs-extra';\nimport { join } from 'path';\nimport { rollup } from 'rollup';\n\nimport type { BuildOptions } from '../../utils/options';\nimport { aliasPlugin } from './alias-plugin';\n\n/**\n * Bundles parse5 to be used in the Stencil output. Writes the results to disk and returns its contents. The file\n * written to disk may be used as a simple cache to speed up subsequent build times.\n * @param opts the options being used during a build of the Stencil compiler\n * @returns a tuple holding 1) contents of the file containing parse5 and 2) the file path where it's written\n */\nexport async function bundleParse5(opts: BuildOptions): Promise<[contents: string, path: string]> {\n const fileName = `parse5-${opts.parse5Version.replace(/\\./g, '_')}-bundle-cache${opts.isProd ? '.min' : ''}.js`;\n const cacheFile = join(opts.scriptsBuildDir, fileName);\n\n try {\n return [await fs.readFile(cacheFile, 'utf8'), cacheFile];\n } catch (e) {}\n\n const rollupBuild = await rollup({\n input: '@parse5-entry',\n plugins: [\n {\n name: 'parse5EntryPlugin',\n /**\n * A rollup build hook for resolving @parse5-entry [Source](https://rollupjs.org/guide/en/#resolveid)\n * @param id the importee exactly as it is written in an import statement in the source code\n * @returns a string that resolves an import to some id\n */\n resolveId(id: string): string | null {\n if (id === '@parse5-entry') {\n return id;\n }\n return null;\n },\n /**\n * A rollup build hook for intercepting how parse5's entry package is processed\n * [Source](https://rollupjs.org/guide/en/#load)\n * @param id the path of the module to load\n * @returns source code to act as a proxy for @parse5-entry\n */\n load(id: string): string | null {\n if (id === '@parse5-entry') {\n return `export { parse, parseFragment } from 'parse5';`;\n }\n return null;\n },\n },\n aliasPlugin(opts),\n rollupResolve(),\n rollupCommonjs(),\n ],\n });\n\n const { output } = await rollupBuild.generate({\n format: 'iife',\n name: 'PARSE5',\n footer: ['export const parse = PARSE5.parse;', 'export const parseFragment = PARSE5.parseFragment;'].join('\\n'),\n strict: false,\n });\n\n let code = output[0].code;\n\n const { minify } = await import('terser');\n\n if (opts.isProd) {\n const minified = await minify(code, {\n ecma: 2018,\n module: true,\n compress: {\n ecma: 2018,\n passes: 2,\n },\n format: {\n ecma: 2018,\n comments: false,\n },\n });\n if (minified.code) {\n code = minified.code;\n }\n }\n\n code = `// Parse5 ${opts.parse5Version}\\n` + code;\n\n await fs.writeFile(cacheFile, code);\n\n return [code, cacheFile];\n}\n"
},
{
"path": "scripts/esbuild/utils/terser.ts",
"content": "import fs from 'fs-extra';\nimport { join } from 'path';\nimport { rollup } from 'rollup';\n\nimport type { BuildOptions } from '../../utils/options';\n\n/**\n * Creates a bundle containing Terser\n * @param opts the options being used during a build\n * @returns a tuple containing the bundled Terser code and the path where it\n * was written\n */\nexport async function bundleTerser(opts: BuildOptions): Promise<[content: string, path: string]> {\n if (!opts.terserVersion) {\n throw new Error('Terser version not set on build opts!');\n }\n\n const fileName = `terser-${opts.terserVersion.replace(/\\./g, '_')}-bundle-cache${opts.isProd ? '.min' : ''}.js`;\n const cacheFile = join(opts.scriptsBuildDir, fileName);\n\n try {\n const content = await fs.readFile(cacheFile, 'utf8');\n return [content, cacheFile];\n } catch (e) {}\n\n const rollupBuild = await rollup({\n input: join(opts.nodeModulesDir, 'terser', 'main.js'),\n external: ['source-map'],\n });\n\n const { output } = await rollupBuild.generate({\n format: 'es',\n strict: false,\n });\n\n let code = output[0].code;\n\n const { minify } = await import('terser');\n\n if (opts.isProd) {\n const minified = await minify(code, {\n ecma: 2018,\n compress: {\n ecma: 2018,\n passes: 2,\n },\n format: {\n ecma: 2018,\n comments: false,\n },\n });\n if (minified.code) {\n code = minified.code;\n }\n }\n\n code = `// Terser ${opts.terserVersion}\\n` + code;\n\n await fs.writeFile(cacheFile, code);\n\n return [code, cacheFile];\n}\n"
},
{
"path": "scripts/esbuild/utils/typescript-source.ts",
"content": "import fs from 'fs-extra';\nimport { join } from 'path';\n\nimport type { BuildOptions } from '../../utils/options';\n\n/**\n * Bundles the TypeScript compiler in the Stencil output. This function also performs several optimizations and\n * modifications to the TypeScript source.\n * @param tsPath a path to the TypeScript compiler\n * @param opts the options being used during a build of the Stencil compiler\n * @returns the modified TypeScript source\n */\nexport async function bundleTypeScriptSource(tsPath: string, opts: BuildOptions): Promise {\n const cacheFile = tsCacheFilePath(opts);\n\n try {\n // check if we've already cached this bundle\n return await fs.readFile(cacheFile, 'utf8');\n } catch (e) {}\n\n // get the source typescript.js file to modify\n let code = await fs.readFile(tsPath, 'utf8');\n\n // As of 5.0, because typescript is now bundled with esbuild the structure of\n // the file we're dealing with here (`lib/typescript.js`) has changed.\n // Previously there was an iife which got an object as an argument and just\n // stuck properties onto it, something like\n //\n // ```js\n // var ts = (function (ts) {\n // ts.someMethod = () => { ... };\n // })(ts || ts = {});\n // ```\n //\n // as of 5.0 it instead looks (conceptually) something like:\n //\n // ```js\n // var ts = (function () {\n // const ts = {}\n // const define = (name, value) => {\n // Object.defineProperty(ts, name, value, { enumerable: true })\n // }\n // define('someMethod', () => { ... })\n // return ts;\n // })();\n // ```\n //\n // Note that the call to `Object.defineProperty` does not set `configurable` to `true`\n // (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty#description)\n // which means that later calls to do something like\n //\n // ```ts\n // import ts from 'typescript';\n //\n // ts.someMethod = function myReplacementForSomeMethod () {\n // ...\n // };\n // ```\n //\n // will fail because without `configurable: true` you can't re-assign\n // properties.\n //\n // All well and good, except for the fact that our patching of typescript to\n // use for instance the in-memory file system depends on us being able to\n // monkey-patch typescript in exactly this way. So in order to retain our\n // current approach to patching TypeScript we need to edit this file in order\n // to add `configurable: true` to the options passed to\n // `Object.defineProperty`:\n const TS_PROP_DEFINER = `__defProp(target, name, { get: all[name], enumerable: true });`;\n const TS_PROP_DEFINER_RECONFIGURABLE = `__defProp(target, name, { get: all[name], enumerable: true, configurable: true });`;\n\n code = code.replace(TS_PROP_DEFINER, TS_PROP_DEFINER_RECONFIGURABLE);\n\n const jestTypesciptFilename = join(opts.scriptsBuildDir, 'typescript-modified-for-jest.js');\n await fs.writeFile(jestTypesciptFilename, code);\n\n // TODO(STENCIL-839): investigate minification issue w/ typescript 5.0\n // const { minify } = await import('terser');\n\n // if (opts.isProd) {\n // const minified = await minify(code, {\n // ecma: 2018,\n // // module: true,\n // compress: {\n // ecma: 2018,\n // passes: 2,\n // },\n // format: {\n // ecma: 2018,\n // comments: false,\n // },\n // });\n // code = minified.code;\n // }\n\n await fs.writeFile(cacheFile, code);\n\n return code;\n}\n\n/**\n * Get the file path to which the cached, modified version of TypeScript will\n * be written\n *\n * @param opts build options for the current Stencil build\n * @returns the path where the modified TypeScript source can be found\n */\nexport function tsCacheFilePath(opts: BuildOptions): string {\n const fileName = `typescript-${opts.typescriptVersion.replace(/\\./g, '_')}-bundle-cache${\n opts.isProd ? '.min' : ''\n }.js`;\n const cacheFile = join(opts.scriptsBuildDir, fileName);\n return cacheFile;\n}\n"
},
{
"path": "scripts/index.ts",
"content": "import { join } from 'path';\n\nimport * as build from './build';\n\n// This path is relative to the final location of the compiled script, not its TypeScript source\nconst stencilProjectRoot = join(__dirname, '..');\nconst args = process.argv.slice(2);\nbuild.run(stencilProjectRoot, args);\n"
},
{
"path": "scripts/release-tasks.ts",
"content": "import color from 'ansi-colors';\nimport Listr, { ListrTask } from 'listr';\n\nimport { buildAll } from './build';\nimport { BuildOptions } from './utils/options';\nimport { isPrereleaseVersion, isValidVersionInput, SEMVER_INCREMENTS, updateChangeLog } from './utils/release-utils';\n\n/**\n * We have to wrap `execa` in a promise to ensure it works with `Listr`. `Listr` uses rxjs under the hood which\n * seems to have issues with `execa`'s `ResultPromise` as it never resolves a task.\n * @param command command to run\n * @param args arguments to pass to the command\n * @param options `execa` options\n * @returns a promise that resolves with the stdout and stderr of the command\n */\nasync function execa(command: string, args: string[], options?: any) {\n /**\n * consecutive imports are cached and don't have an impact on the execution speed\n */\n const { execa: execaOrig } = await import('execa');\n\n return new Promise<{ stdout: string; stderr: string }>((resolve, reject) => {\n const run = execaOrig(command, args, options);\n run.then(\n ({ stdout, stderr }) =>\n resolve({\n stdout: stdout as unknown as string,\n stderr: stderr as unknown as string,\n }),\n (err) => reject(err),\n );\n });\n}\n\n/**\n * Runs a litany of tasks used to ensure a safe release of a new version of Stencil\n * @param opts build options containing the metadata needed to release a new version of Stencil\n * @param args stringified arguments used to influence the release steps that are taken\n */\nexport async function runReleaseTasks(opts: BuildOptions, args: ReadonlyArray): Promise {\n const rootDir = opts.rootDir;\n const pkg = opts.packageJson;\n const tasks: ListrTask[] = [];\n const newVersion = opts.version;\n const isDryRun = args.includes('--dry-run') || opts.version.includes('dryrun');\n let tagPrefix: string;\n\n if (isDryRun) {\n console.log(color.bold.yellow(`\\n 🏃 Dry Run!\\n`));\n }\n\n if (!opts.isPublishRelease) {\n /**\n * For automated and manual releases, always verify that the version provided to the release scripts is a valid\n * semver 'word' (e.g. 'major', 'minor', etc.) or version (e.g. 1.0.0)\n */\n tasks.push({\n title: 'Validate version',\n task: () => {\n if (!isValidVersionInput(opts.version)) {\n throw new Error(`Version should be either ${SEMVER_INCREMENTS.join(', ')}, or a valid semver version.`);\n }\n },\n skip: () => isDryRun,\n });\n }\n\n if (opts.isPublishRelease) {\n tasks.push({\n title: 'Check for pre-release version',\n task: () => {\n if (!pkg.private && isPrereleaseVersion(newVersion) && !opts.tag) {\n throw new Error(\n 'You must specify a dist-tag using --tag when publishing a pre-release version. This prevents accidentally tagging unstable versions as \"latest\". https://docs.npmjs.com/cli/dist-tag',\n );\n }\n },\n });\n }\n\n tasks.push({\n /**\n * When we both pre-release and release, it's beneficial to ensure that the tag does not already exist in git.\n * Doing so ought to catch out of the ordinary circumstances that ought to be investigated.\n */\n title: 'Check git tag existence',\n task: () =>\n execa('git', ['fetch'])\n // Retrieve the prefix for a version string - https://docs.npmjs.com/cli/v7/using-npm/config#tag-version-prefix\n .then(() => execa('npm', ['config', 'get', 'tag-version-prefix']))\n .then(\n ({ stdout }) => (tagPrefix = stdout),\n () => {},\n )\n // verify that a tag for the new version string does not already exist by checking the output of\n // `git rev-parse --verify`\n .then(() => execa('git', ['rev-parse', '--quiet', '--verify', `refs/tags/${tagPrefix}${newVersion}`]))\n .then(\n ({ stdout }) => {\n if (stdout) {\n throw new Error(`Git tag \\`${tagPrefix}${newVersion}\\` already exists.`);\n }\n },\n (err) => {\n // Command fails with code 1 and no output if the tag does not exist, even though `--quiet` is provided\n // https://github.com/sindresorhus/np/pull/73#discussion_r72385685\n if (err.stdout !== '' || err.stderr !== '') {\n throw err;\n }\n },\n ),\n skip: () => isDryRun,\n });\n\n tasks.push(\n {\n title: `Install npm dependencies ${color.dim('(npm ci)')}`,\n task: () => execa('npm', ['ci'], { cwd: rootDir }),\n // for pre-releases, this step will occur in GitHub after the PR has been created.\n // for actual releases, we'll need to build + bundle stencil in order to publish it to npm.\n skip: () => !opts.isPublishRelease,\n },\n {\n title: `Transpile Stencil ${color.dim('(tsc.prod)')}`,\n task: () => execa('npm', ['run', 'tsc.prod'], { cwd: rootDir }),\n // for pre-releases, this step will occur in GitHub after the PR has been created.\n // for actual releases, we'll need to build + bundle stencil in order to publish it to npm.\n skip: () => !opts.isPublishRelease,\n },\n {\n title: `Bundle @stencil/core ${color.dim('(' + opts.buildId + ')')}`,\n task: () => buildAll(opts),\n // for pre-releases, this step will occur in GitHub after the PR has been created.\n // for actual releases, we'll need to build + bundle stencil in order to publish it to npm.\n skip: () => !opts.isPublishRelease,\n },\n );\n\n if (!opts.isPublishRelease) {\n tasks.push(\n {\n title: `Set package.json version to ${color.bold.yellow(opts.version)}`,\n task: async () => {\n // use `--no-git-tag-version` to ensure that the tag for the release is not prematurely created\n await execa('npm', ['version', '--no-git-tag-version', opts.version], { cwd: rootDir });\n },\n },\n {\n title: `Generate ${opts.version} Changelog ${opts.vermoji}`,\n task: async () => {\n await updateChangeLog(opts);\n },\n },\n );\n }\n\n if (opts.isPublishRelease) {\n tasks.push(\n {\n title: 'Publish @stencil/core to npm',\n task: () => {\n const cmd = 'npm';\n const cmdArgs = ['publish'].concat(opts.tag ? ['--tag', opts.tag] : []).concat(['--provenance']);\n\n if (isDryRun) {\n return console.log(`[dry-run] ${cmd} ${cmdArgs.join(' ')}`);\n }\n return execa(cmd, cmdArgs, { cwd: rootDir });\n },\n },\n {\n title: 'Tagging the latest git commit',\n task: () => {\n const cmd = 'git';\n const cmdArgs = ['tag', `v${opts.version}`];\n\n if (isDryRun) {\n return console.log(`[dry-run] ${cmd} ${cmdArgs.join(' ')}`);\n }\n return execa(cmd, cmdArgs, { cwd: rootDir });\n },\n },\n {\n title: 'Pushing git tags',\n task: () => {\n const cmd = 'git';\n const cmdArgs = ['push', '--tags'];\n\n if (isDryRun) {\n return console.log(`[dry-run] ${cmd} ${cmdArgs.join(' ')}`);\n }\n return execa(cmd, cmdArgs, { cwd: rootDir });\n },\n },\n );\n }\n\n const listr = new Listr(tasks);\n\n try {\n await listr.run();\n } catch (err: any) {\n console.log(`\\n🤒 ${color.red(err)}\\n`);\n console.log(err);\n process.exit(1);\n }\n if (opts.isPublishRelease) {\n console.log(\n `\\n ${opts.vermoji} ${color.bold.magenta(pkg.name)} ${color.bold.yellow(newVersion)} published!! ${\n opts.vermoji\n }\\n`,\n );\n } else {\n console.log(\n `\\n ${opts.vermoji} ${color.bold.magenta(pkg.name)} ${color.bold.yellow(\n newVersion,\n )} prepared, check the diffs and commit ${opts.vermoji}\\n`,\n );\n }\n}\n"
},
{
"path": "scripts/release.ts",
"content": "import color from 'ansi-colors';\nimport fs from 'fs-extra';\nimport { join } from 'path';\n\nimport { runReleaseTasks } from './release-tasks';\nimport { BuildOptions, getOptions } from './utils/options';\nimport { getNewVersion } from './utils/release-utils';\nimport { getLatestVermoji } from './utils/vermoji';\n\n/**\n * Runner for creating a release of Stencil\n * @param rootDir the root directory of the Stencil repository\n * @param args stringified arguments used to influence the release steps that are taken\n * @returns a void promise\n */\nexport async function release(rootDir: string, args: ReadonlyArray): Promise {\n const buildDir = join(rootDir, 'build');\n\n if (args.includes('--ci-prepare')) {\n await fs.emptyDir(buildDir);\n const prepareOpts = getOptions(rootDir, {\n isCI: true,\n isPublishRelease: false,\n isProd: true,\n });\n\n const versionIdx = args.indexOf('--version');\n if (versionIdx === -1 || versionIdx === args.length) {\n console.log(`\\n${color.bold.red('No `--version [VERSION]` argument was found. Exiting')}\\n`);\n process.exit(1);\n }\n if (prepareOpts.packageJson.version) {\n prepareOpts.version = getNewVersion(prepareOpts.packageJson.version, args[versionIdx + 1]);\n }\n\n await prepareRelease(prepareOpts, args);\n console.log(`${color.bold.blue('Release Prepared!')}`);\n }\n\n if (args.includes('--ci-publish')) {\n const prepareOpts = getOptions(rootDir, {\n isCI: true,\n isPublishRelease: false,\n isProd: true,\n });\n // this was bumped already, we just need to copy it from package.json into this field\n if (prepareOpts.packageJson.version) {\n prepareOpts.version = prepareOpts.packageJson.version;\n }\n\n // we generated a vermoji during the preparation step, let's grab it from the changelog\n prepareOpts.vermoji = getLatestVermoji(prepareOpts.changelogPath);\n\n const tagIdx = args.indexOf('--tag');\n let newTag = null;\n if (tagIdx === -1 || tagIdx === args.length) {\n console.log(`\\n${color.bold.yellow('No `--tag [TAG]` argument was found.')}\\n`);\n } else if (args[tagIdx + 1] === 'use_pkg_json_version') {\n console.log(\n `\\n${color.bold.green(\n 'The default package.json version will be used for the tag. No additional tags will be applied.',\n )}\\n`,\n );\n } else {\n newTag = args[tagIdx + 1];\n console.log(`\\n${color.bold.green(`Set '--tag' argument to '${newTag}'.`)}\\n`);\n }\n\n console.log(`${color.bold.blue(`Version: ${prepareOpts.version}`)}`);\n console.log(`${color.bold.blue(`Tag: ${newTag}`)}`);\n\n const publishOpts = getOptions(rootDir, {\n buildId: prepareOpts.buildId,\n version: prepareOpts.version,\n vermoji: prepareOpts.vermoji,\n isCI: prepareOpts.isCI,\n isPublishRelease: true,\n isProd: true,\n tag: newTag ?? undefined,\n });\n return await publishRelease(publishOpts, args);\n }\n}\n\n/**\n * Prepares a release of Stencil\n * @param opts build options containing the metadata needed to release a new version of Stencil\n * @param args stringified arguments used to influence the release steps that are taken\n */\nasync function prepareRelease(opts: BuildOptions, args: ReadonlyArray): Promise {\n const pkg = opts.packageJson;\n const oldVersion = opts.packageJson.version;\n console.log(\n `\\nPrepare to publish ${opts.vermoji} ${color.bold.magenta(pkg.name)} ${color.dim(`(currently ${oldVersion})`)}\\n`,\n );\n\n try {\n await runReleaseTasks(opts, args);\n } catch (err: any) {\n console.log('\\n', color.red(err), '\\n');\n process.exit(0);\n }\n}\n\n/**\n * Initiates publishing a Stencil release.\n * @param opts build options containing the metadata needed to publish a new version of Stencil\n * @param args stringified arguments used to influence the steps that are taken\n * @returns a void promise\n */\nasync function publishRelease(opts: BuildOptions, args: ReadonlyArray): Promise {\n const pkg = opts.packageJson;\n if (opts.version !== pkg.version) {\n throw new Error(\n `Prepare release data (${opts.version}) and package.json (${pkg.version}) versions do not match. Try re-running release prepare.`,\n );\n }\n\n console.log(`\\nPublish ${opts.vermoji} ${color.bold.magenta(pkg.name)} ${color.yellow(`${opts.version}`)}\\n`);\n\n try {\n await runReleaseTasks(opts, args);\n } catch (err: any) {\n console.log('\\n', color.red(err), '\\n');\n process.exit(0);\n }\n}\n"
},
{
"path": "scripts/test/copy-readme.js",
"content": "/**\n * This script copies a supplemental README file to the location where it will be overwritten\n * during the `docs-readme` output target test. The purpose of this step is to ensure that\n * the file is in a known state before the test runs, avoiding issues with Git detecting\n * unexpected changes to the file.\n *\n * Context:\n * - During the `docs-readme` tests, a README file is overwritten as part of the test process.\n * - The expected result of the test must be tracked by Git; otherwise, Git will detect a \"dirty\"\n * state and the test will fail.\n * - This behaviour can be used to our advantage: if the file is overwritten with the supplemental\n * file but not overwritten back to the expected result, Git will detect a dirty state, causing\n * the test to fail. This ensures that the correct action is taken by the code being tested.\n *\n * Usage:\n * - This script is executed as part of the `prepare.readmes` npm script.\n * - It copies `readme-supplemental.md` to `readme.md` in the appropriate directory.\n */\n\nconst fs = require('fs');\nconst path = require('path');\n\n// Define source and destination paths\nconst src = path.resolve(\n __dirname,\n '../../test/docs-readme/custom-readme-output-overwrite/components/styleurls-component/readme-supplemental.md',\n);\nconst dest = path.resolve(\n __dirname,\n '../../test/docs-readme/custom-readme-output-overwrite/components/styleurls-component/readme.md',\n);\n\n// Copy the file\ntry {\n fs.copyFileSync(src, dest);\n console.log(`Copied ${src} to ${dest}`);\n} catch (err) {\n console.error(`Error copying file: ${err.message}`);\n process.exit(1);\n}\n"
},
{
"path": "scripts/test/validate-build.ts",
"content": "import fs from 'fs-extra';\nimport { dirname, join, relative } from 'path';\nimport { rollup } from 'rollup';\nimport ts, { ModuleResolutionKind, ScriptTarget } from 'typescript';\nimport url from 'url';\n\nimport { NODE_BUILTINS } from '../utils/constants';\nimport { BuildOptions, getOptions } from '../utils/options';\nimport { PackageData } from '../utils/write-pkg-json';\n\n/**\n * Used to triple check that the final build files\n * ready to be published are good to go\n */\nconst pkgs: TestPackage[] = [\n {\n // cli\n packageJson: 'cli/package.json',\n },\n {\n // compiler\n packageJson: 'compiler/package.json',\n files: ['compiler/lib.d.ts', 'compiler/lib.dom.d.ts'],\n },\n {\n // dev-server\n packageJson: 'dev-server/package.json',\n files: [\n 'dev-server/static/favicon.ico',\n 'dev-server/templates/directory-index.html',\n 'dev-server/templates/initial-load.html',\n 'dev-server/connector.html',\n 'dev-server/server-process.js',\n 'dev-server/server-worker-thread.js',\n 'dev-server/visualstudio.vbs',\n 'dev-server/xdg-open',\n ],\n },\n {\n // internal/app-data\n packageJson: 'internal/app-data/package.json',\n },\n {\n // internal/client\n packageJson: 'internal/client/package.json',\n files: ['internal/client/polyfills/'],\n },\n {\n // internal/hydrate\n packageJson: 'internal/hydrate/package.json',\n files: ['internal/hydrate/runner.d.ts', 'internal/hydrate/runner.js'],\n },\n {\n // internal/testing\n packageJson: 'internal/testing/package.json',\n },\n {\n // internal\n packageJson: 'internal/package.json',\n files: [\n 'internal/stencil-core/index.cjs',\n 'internal/stencil-core/index.js',\n 'internal/stencil-core/index.d.ts',\n 'internal/stencil-ext-modules.d.ts',\n 'internal/stencil-private.d.ts',\n 'internal/stencil-public-compiler.d.ts',\n 'internal/stencil-public-docs.d.ts',\n 'internal/stencil-public-runtime.d.ts',\n ],\n },\n {\n // mock-doc\n packageJson: 'mock-doc/package.json',\n },\n {\n // screenshot\n packageJson: 'screenshot/package.json',\n files: [\n 'screenshot/compare/',\n 'screenshot/connector.js',\n 'screenshot/local-connector.js',\n 'screenshot/pixel-match.js',\n ],\n },\n {\n // sys/node\n packageJson: 'sys/node/package.json',\n files: ['sys/node/autoprefixer.js', 'sys/node/graceful-fs.js', 'sys/node/node-fetch.js'],\n },\n {\n // testing\n packageJson: 'testing/package.json',\n files: [\n 'testing/jest-environment.js',\n 'testing/jest-preprocessor.js',\n 'testing/jest-preset.js',\n 'testing/jest-runner.js',\n 'testing/jest-setuptestframework.js',\n ],\n },\n {\n // @stencil/core\n packageJson: 'package.json',\n packageJsonFiles: [\n 'bin/',\n 'cli/',\n 'compiler/',\n 'dev-server/',\n 'internal/',\n 'mock-doc/',\n 'screenshot/',\n 'sys/',\n 'testing/',\n ],\n files: ['CHANGELOG.md', 'LICENSE.md', 'readme.md'],\n hasBin: true,\n },\n];\n\n/**\n * Validate that certain files were written to disk during the build, and that\n * these files tree-shake correctly.\n *\n * @param rootDir the root of the Stencil repository\n */\nexport async function validateBuild(rootDir: string): Promise {\n const dtsEntries: string[] = [];\n const opts = getOptions(rootDir);\n pkgs.forEach((testPkg) => {\n validatePackage(opts, testPkg, dtsEntries);\n });\n console.log(`🐡 Validated packages`);\n\n validateDts(opts, dtsEntries);\n\n await validateCompiler(opts);\n await validateTreeshaking(opts);\n}\n\n/**\n * Validates a bundled package/sub-module. Validation steps include verifying that various fields in `package.json` are\n * filled out and file references are valid.\n * @param opts build options to be used to validate a package\n * @param testPkg the package to validate\n * @param dtsEntries a reference to .d.ts files to collect while validating the package\n */\nfunction validatePackage(opts: BuildOptions, testPkg: TestPackage, dtsEntries: string[]): void {\n const rootDir = opts.rootDir;\n\n if (testPkg.packageJson) {\n testPkg.packageJson = join(rootDir, testPkg.packageJson);\n const pkgDir = dirname(testPkg.packageJson);\n const pkgJson: PackageData = require(testPkg.packageJson);\n\n if (!pkgJson.name) {\n throw new Error('missing package.json name: ' + testPkg.packageJson);\n }\n\n if (!pkgJson.main) {\n throw new Error('missing package.json main: ' + testPkg.packageJson);\n }\n\n if (testPkg.packageJsonFiles) {\n if (!Array.isArray(pkgJson.files)) {\n throw new Error(testPkg.packageJson + ' missing \"files\" property');\n }\n pkgJson.files.forEach((f) => {\n if (f === '!**/*.map' || f === '!**/*.stub.ts' || f === '!**/*.stub.tsx') {\n // skip sourcemaps, stub files\n return;\n }\n const pkgFile = join(pkgDir, f);\n fs.accessSync(pkgFile);\n });\n testPkg.packageJsonFiles.forEach((testPkgFile) => {\n if (!pkgJson.files?.includes(testPkgFile)) {\n throw new Error(testPkg.packageJson + ' missing file ' + testPkgFile);\n }\n\n const filePath = join(pkgDir, testPkgFile);\n fs.accessSync(filePath);\n });\n }\n\n if (testPkg.hasBin && !pkgJson.bin) {\n throw new Error(testPkg.packageJson + ' missing bin');\n }\n\n if (pkgJson.bin) {\n Object.keys(pkgJson.bin).forEach((k) => {\n if (pkgJson.bin?.[k]) {\n const binExe = join(pkgDir, pkgJson.bin[k]);\n fs.accessSync(binExe);\n }\n });\n }\n\n const mainIndex = join(pkgDir, pkgJson.main);\n fs.accessSync(mainIndex);\n\n if (pkgJson.module) {\n const moduleIndex = join(pkgDir, pkgJson.module);\n fs.accessSync(moduleIndex);\n }\n\n if (pkgJson.browser) {\n const browserIndex = join(pkgDir, pkgJson.browser);\n fs.accessSync(browserIndex);\n }\n\n if (pkgJson.types) {\n const pkgTypes = join(pkgDir, pkgJson.types);\n fs.accessSync(pkgTypes);\n dtsEntries.push(pkgTypes);\n }\n }\n\n if (testPkg.files) {\n testPkg.files.forEach((file) => {\n const filePath = join(rootDir, file);\n fs.statSync(filePath);\n });\n }\n}\n\n/**\n * Validate the .d.ts files used in the output are semantically and syntactically correct\n * @param opts build options to be used to validate .d.ts files\n * @param dtsEntries the .d.ts files to validate\n */\nfunction validateDts(opts: BuildOptions, dtsEntries: string[]): void {\n const program = ts.createProgram(dtsEntries, {\n baseUrl: '.',\n paths: {\n '@stencil/core/mock-doc': [join(opts.rootDir, 'mock-doc', 'index.d.ts')],\n '@stencil/core/internal': [join(opts.rootDir, 'internal', 'index.d.ts')],\n '@stencil/core/internal/testing': [join(opts.rootDir, 'internal', 'testing', 'index.d.ts')],\n },\n moduleResolution: ModuleResolutionKind.NodeJs,\n target: ScriptTarget.ES2016,\n });\n\n const tsDiagnostics = program.getSemanticDiagnostics().concat(program.getSyntacticDiagnostics());\n\n if (tsDiagnostics.length > 0) {\n const host = {\n getCurrentDirectory: () => ts.sys.getCurrentDirectory(),\n getNewLine: () => ts.sys.newLine,\n getCanonicalFileName: (f: string) => f,\n };\n throw new Error('🧨 ' + ts.formatDiagnostics(tsDiagnostics, host));\n }\n console.log(`🐟 Validated dts files`);\n}\n\n/**\n * Validates the Stencil compiler. This includes verifying that the compiler, CLI and sys API can be instantiated,\n * smoke testing the compiler's transpilation, and running a small task in the CLI.\n * @param opts build options to be used to validate the compiler\n */\nasync function validateCompiler(opts: BuildOptions): Promise {\n const compilerPath = url.pathToFileURL(join(opts.output.compilerDir, 'stencil.js')).pathname;\n const cliPath = url.pathToFileURL(join(opts.output.cliDir, 'index.cjs')).pathname;\n const sysNodePath = url.pathToFileURL(join(opts.output.sysNodeDir, 'index.js')).pathname;\n\n const compiler = await import(compilerPath);\n const cli = await import(cliPath);\n const sysNodeApi = await import(sysNodePath);\n\n const nodeLogger = sysNodeApi.createNodeLogger();\n const nodeSys = sysNodeApi.createNodeSys({ process });\n\n if (!nodeSys || nodeSys.name !== 'node' || nodeSys.version.length < 4) {\n throw new Error(`🧨 unable to validate sys node`);\n }\n console.log(`🐳 Validated sys node, current ${nodeSys.name} version: ${nodeSys.version}`);\n\n const validated = await compiler.loadConfig({\n config: {\n logger: nodeLogger,\n sys: nodeSys,\n },\n });\n console.log(`${compiler.vermoji} Validated compiler: ${compiler.version}`);\n\n const transpileResults = compiler.transpileSync('const m: string = `transpile!`;', {\n target: 'es5',\n });\n if (\n !transpileResults ||\n transpileResults.diagnostics.length > 0 ||\n !transpileResults.code.startsWith(`var m = \"transpile!\";`)\n ) {\n console.error(transpileResults);\n throw new Error(`🧨 transpileSync error`);\n }\n console.log(`🐋 Validated compiler.transpileSync()`);\n\n const orgConsoleLog = console.log;\n let loggedVersion = '';\n console.log = (value: string) => (loggedVersion = value);\n\n // this runTask is intentionally not wrapped in telemetry helpers\n await cli.runTask(compiler, validated.config, 'version');\n\n console.log = orgConsoleLog;\n\n if (typeof loggedVersion !== 'string' || loggedVersion.length < 4) {\n throw new Error(`🧨 unable to validate compiler. loggedVersion: \"${loggedVersion}\"`);\n }\n\n console.log(`🐬 Validated cli`);\n}\n\n/**\n * Validate tree shaking for various modules in the output\n * @param opts build options to be used to validate tree-shaking\n */\nasync function validateTreeshaking(opts: BuildOptions) {\n await validateModuleTreeshake(opts, 'app-data', join(opts.output.internalDir, 'app-data', 'index.js'));\n await validateModuleTreeshake(opts, 'client', join(opts.output.internalDir, 'client', 'index.js'));\n await validateModuleTreeshake(opts, 'patch-browser', join(opts.output.internalDir, 'client', 'patch-browser.js'));\n await validateModuleTreeshake(opts, 'shadow-css', join(opts.output.internalDir, 'client', 'shadow-css.js'));\n await validateModuleTreeshake(opts, 'hydrate', join(opts.output.internalDir, 'hydrate', 'index.js'));\n await validateModuleTreeshake(opts, 'stencil-core', join(opts.output.internalDir, 'stencil-core', 'index.js'));\n await validateModuleTreeshake(opts, 'cli', join(opts.output.cliDir, 'index.js'));\n}\n\n/**\n * Validates tree-shaking for a single module & entrypoint\n * @param opts build options to be used to validate tree-shaking for a specific module\n * @param moduleName the module to validate\n * @param entryModulePath the entrypoint to validate\n */\nasync function validateModuleTreeshake(opts: BuildOptions, moduleName: string, entryModulePath: string): Promise {\n // this is a song, 'agadoo' by Black Lace\n const virtualInputId = `@g@doo`;\n const entryId = `@entry-module`;\n const outputFile = join(opts.scriptsBuildDir, `treeshake_${moduleName}.js`);\n\n const bundle = await rollup({\n external: NODE_BUILTINS,\n input: virtualInputId,\n treeshake: {\n moduleSideEffects: false,\n },\n plugins: [\n {\n name: 'stencilResolver',\n resolveId(id) {\n if (id === '@stencil/core/internal/client' || id === '@stencil/core') {\n return join(opts.output.internalDir, 'client', 'index.js');\n }\n if (id === '@stencil/core/internal/app-data') {\n return join(opts.output.internalDir, 'app-data', 'index.js');\n }\n if (id === '@stencil/core/internal/app-globals') {\n return id;\n }\n if (id === virtualInputId) {\n return id;\n }\n if (id === entryId) {\n return entryModulePath;\n }\n },\n load(id) {\n if (id === '@stencil/core/internal/app-globals') {\n return 'export const globalScripts = () => {};\\nexport const globalStyles = \"\";';\n }\n if (id === virtualInputId) {\n return `import \"${entryId}\";`;\n }\n },\n },\n ],\n onwarn(warning) {\n if (warning.code !== 'EMPTY_BUNDLE') {\n throw warning;\n }\n },\n });\n\n const o = await bundle.generate({\n format: 'es',\n });\n\n const output = o.output[0];\n const outputCode = output.code.trim();\n\n await fs.writeFile(outputFile, outputCode);\n\n if (outputCode !== '') {\n console.error(`\\nTreeshake output: ${outputFile}\\n`);\n\n throw new Error(`🧨 Not all code was not treeshaken (treeshooken? treeshaked?)`);\n }\n\n console.log(`🌳 validated treeshake: ${relative(opts.rootDir, entryModulePath)}`);\n}\n\n/**\n * Represents a package/submodule of the bundled Stencil output to validate\n */\ninterface TestPackage {\n packageJson?: string;\n packageJsonFiles?: string[];\n files?: string[];\n hasBin?: boolean;\n}\n"
},
{
"path": "scripts/test/validate-testing.js",
"content": "const testing = require('../../testing/index.js');\n\nconst input = `\nimport { Component, Prop } from '@stencil/core';\n@Component({\n tag: 'my-cmp'\n})\nexport class MyCmp {\n @Prop() prop: boolean;\n}\n`;\n\nconst output = testing.transpile(input);\n\nif (output.diagnostics.length > 0) {\n const msg = output.diagnostics.map((d) => d.messageText).join('\\n');\n throw new Error('Testing transpile error: \\n' + msg);\n}\n\nconsole.log(`🐠 Validated testing suite`);\n"
},
{
"path": "scripts/tsconfig.json",
"content": "{\n \"compilerOptions\": {\n \"alwaysStrict\": true,\n \"strict\": true,\n \"allowSyntheticDefaultImports\": true,\n \"esModuleInterop\": true,\n \"forceConsistentCasingInFileNames\": true,\n \"lib\": [\n \"dom\",\n \"es2021\"\n ],\n \"module\": \"NodeNext\",\n \"moduleResolution\": \"nodenext\",\n \"skipLibCheck\": true,\n \"outDir\": \"build/\",\n \"pretty\": true,\n \"target\": \"ES2020\",\n \"incremental\": false,\n \"useUnknownInCatchVariables\": true\n },\n \"include\": [\n \"**/*.ts\",\n \"types/*.d.ts\"\n ],\n \"exclude\": [\n \"**/*.spec.ts\"\n ]\n}\n"
},
{
"path": "scripts/types/rollup-plugin-node-resolve.d.ts",
"content": "declare module '@rollup/plugin-node-resolve';\n"
},
{
"path": "scripts/updateSelectorEngine.ts",
"content": "import cp from 'node:child_process';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\n\n/**\n * This script updates the JQuery selector engine for the mock-doc package\n * to the latest version.\n *\n * To run it, use the following command:\n * ```sh\n * npm run tsc.scripts\n * npm run build.updateSelectorEngine\n * ```\n */\n\nconst rootDir = path.resolve(__dirname, '..');\nconst jqueryDepDir = path.resolve(rootDir, 'node_modules', 'jquery');\nconst WINDOW_MOCK = `{\n document: {\n createElement() {\n return {};\n },\n nodeType: 9,\n documentElement: {\n nodeType: 1,\n nodeName: 'HTML'\n }\n }\n}`;\n\nasync function run() {\n console.log('updating JQuery Selector engine...');\n\n await runCommand(`npm install --ignore-scripts`, jqueryDepDir);\n await runCommand(`npm run build -- --include=selector`, jqueryDepDir);\n\n const jqueryPkgJSON = JSON.parse(await fs.readFile(path.resolve(jqueryDepDir, 'package.json'), 'utf8'));\n const thirdPartyDir = path.resolve(__dirname, '../../src/mock-doc/third-party');\n await fs.mkdir(thirdPartyDir, { recursive: true });\n\n const originalContent = await fs.readFile(path.resolve(jqueryDepDir, 'dist', 'jquery.js'), 'utf8');\n\n /**\n * This is a hack to make the jQuery selector engine work with the mock-doc package.\n * Using the original jQuery bundle would cause a \"RegExpCompiler Allocation failed - process out of memory\"\n * error due to the way the jQuery object is constructed. The following tweaks to the jQuery bundle\n * resolve the issue:\n */\n const fixedJQuery = originalContent\n /**\n * Never run the short-circuiting code due to usage of too many RegExp objects\n */\n .replace('if ( !seed ) {', 'if ( false ) {')\n /**\n * Make jQuery an object to have it garbage collected\n */\n .replace('var version = \"', `const jQuery = {} as { find: Function };\\nvar version = \"`)\n /**\n * Inject window mock directly into iife\n */\n .replace(`typeof window !== \"undefined\" ? window : this`, WINDOW_MOCK)\n /**\n * Rename the original jQuery function to jQueryOrig\n */\n .replace('jQuery = function( selector, context ) {', 'jQueryOrig = function( selector, context ) {')\n /**\n * Replace use of `jQuery.attr` with `elem.getAttribute` to avoid having to include\n * the attributes plugin to the bundle\n */\n .replace('jQuery.attr( elem, name )', 'elem.getAttribute( name )')\n /**\n * make it return jQuery directly rather than relying on a module system\n */\n .replace('module.exports = factory( global, true );', 'return factory( global, true );')\n .replace('if ( typeof module === \"object\" && typeof module.exports === \"object\" ) {', 'if (true) {');\n\n const newContent = `/* eslint-disable */\n// @ts-nocheck\n\n/**\n * ATTENTION: DO NOT MODIFY THIS FILE\n *\n * This file is generated by \"scripts/updateSelectorEngine.ts\" and can be overwritten\n * at any time. Don't make changes in here as they will get lost!\n */\nexport default ${fixedJQuery};\n`;\n fs.writeFile(path.resolve(thirdPartyDir, 'jquery.ts'), newContent, 'utf8');\n\n console.log(`\\nJQuery Selector engine updated to version ${jqueryPkgJSON.version}`);\n console.log(`at ${thirdPartyDir} 🎉`);\n}\n\nfunction runCommand(cmd: string, cwd: string) {\n return new Promise((resolve, reject) => {\n console.log(`> ${cmd}`);\n const child = cp.spawn(cmd, { cwd, shell: true });\n child.on('error', reject);\n child.on('exit', (code) => (code === 0 ? resolve(child) : reject()));\n });\n}\n\nif (require.main === module) {\n run();\n}\n"
},
{
"path": "scripts/utils/banner.ts",
"content": "import { BuildOptions } from './options';\n\nexport function getBanner(opts: BuildOptions, fileName: string, license = false) {\n return [\n `/*${license ? '!' : ''}`,\n ` ${fileName} v${opts.version} | MIT Licensed | https://stenciljs.com`,\n ` */`,\n ].join('\\n');\n}\n"
},
{
"path": "scripts/utils/bundle-dts.ts",
"content": "import { EntryPointConfig, generateDtsBundle, OutputOptions } from 'dts-bundle-generator';\nimport fs from 'fs-extra';\n\nimport { BuildOptions } from './options';\n\n/**\n * A thin wrapper for `dts-bundle-generator` which uses our build options to\n * set a few things up\n *\n * **Note**: this file caches its output to disk, and will return any\n * previously cached file if not in a prod environment!\n *\n * @param opts an object holding information about the current build of Stencil\n * @param inputFile the path to the file which should be bundled\n * @param outputOptions options for bundling the file\n * @param useCache whether or not the bundled file should be cached to disk\n * @returns a string containing the bundled typedef\n */\nexport async function bundleDts(\n opts: BuildOptions,\n inputFile: string,\n outputOptions?: OutputOptions,\n useCache = true,\n): Promise {\n const cachedDtsOutput = inputFile + '-bundled.d.ts';\n\n if (!opts.isProd && useCache) {\n try {\n return await fs.readFile(cachedDtsOutput, 'utf8');\n } catch (e) {}\n }\n\n const config: EntryPointConfig = {\n filePath: inputFile,\n };\n\n if (outputOptions) {\n config.output = outputOptions;\n }\n\n const outputCode = cleanDts(generateDtsBundle([config]).join('\\n'));\n\n if (useCache) {\n await fs.writeFile(cachedDtsOutput, outputCode);\n }\n\n return outputCode;\n}\n\nexport function cleanDts(dtsContent: string) {\n dtsContent = dtsContent.replace(/\\/\\/\\/ = {}): BuildOptions {\n const srcDir = join(rootDir, 'src');\n const packageJsonPath = join(rootDir, 'package.json');\n const packageLockJsonPath = join(rootDir, 'package-lock.json');\n const changelogPath = join(rootDir, 'CHANGELOG.md');\n const nodeModulesDir = join(rootDir, 'node_modules');\n const typescriptDir = join(nodeModulesDir, 'typescript');\n const typescriptLibDir = join(typescriptDir, 'lib');\n const buildDir = join(rootDir, 'build');\n const scriptsDir = join(rootDir, 'scripts');\n const scriptsBuildDir = join(scriptsDir, 'build');\n const scriptsBundlesDir = join(scriptsDir, 'esbuild');\n const bundleHelpersDir = join(scriptsBundlesDir, 'helpers');\n const packageJson: PackageData = JSON.parse(readFileSync(packageJsonPath, 'utf8'));\n const buildId = inputOpts.buildId ?? getBuildId();\n const version = inputOpts.version ?? getDevVersionId({ buildId, semverVersion: packageJson?.version });\n\n const vermoji =\n inputOpts.isProd && !inputOpts.vermoji\n ? getVermoji(inputOpts.changelogPath ?? changelogPath)\n : inputOpts.vermoji ?? '💎';\n\n const typescriptPkg = require(join(typescriptDir, 'package.json'));\n const typescriptVersion = typescriptPkg.version;\n\n const terserPkg = getPkg(nodeModulesDir, 'terser');\n const terserVersion = terserPkg.version;\n\n const rollupPkg = getPkg(nodeModulesDir, 'rollup');\n const rollupVersion = rollupPkg.version;\n\n const parse5Pkg = getPkg(nodeModulesDir, 'parse5');\n const parse5Version = parse5Pkg.version;\n\n const jqueryPkg = getPkg(nodeModulesDir, 'jquery');\n const jqueryVersion = jqueryPkg.version;\n\n const opts: BuildOptions = {\n ghRepoOrg: 'ionic-team',\n ghRepoName: 'stencil',\n rootDir,\n srcDir,\n packageJsonPath,\n packageLockJsonPath,\n changelogPath,\n nodeModulesDir,\n typescriptDir,\n typescriptLibDir,\n packageJson,\n buildDir,\n scriptsDir,\n scriptsBuildDir,\n scriptsBundlesDir,\n bundleHelpersDir,\n output: {\n cliDir: join(rootDir, 'cli'),\n compilerDir: join(rootDir, 'compiler'),\n devServerDir: join(rootDir, 'dev-server'),\n internalDir: join(rootDir, 'internal'),\n mockDocDir: join(rootDir, 'mock-doc'),\n screenshotDir: join(rootDir, 'screenshot'),\n sysNodeDir: join(rootDir, 'sys', 'node'),\n testingDir: join(rootDir, 'testing'),\n },\n version,\n buildId,\n isProd: false,\n isCI: false,\n isWatch: false,\n isPublishRelease: false,\n vermoji,\n tag: 'dev',\n jqueryVersion,\n parse5Version,\n rollupVersion,\n terserVersion,\n typescriptVersion,\n };\n\n Object.assign(opts, inputOpts);\n\n if (opts.isPublishRelease) {\n if (!opts.isProd) {\n throw new Error('release must also be a prod build');\n }\n }\n\n return opts;\n}\n\n/**\n * Generates an object containing versioning information of various packages\n * installed at build time\n *\n * **NOTE** this will mutate the `opts` parameter, adding information about\n * the versions used for various dependencies\n *\n * @param opts the options being used during a build\n * @returns an object that contains package names/versions installed at the time a build was invoked\n */\nexport function createReplaceData(opts: BuildOptions): Record {\n const CACHE_BUSTER = 7;\n\n const typescriptPkg = require(join(opts.typescriptDir, 'package.json'));\n const transpileId = typescriptPkg.name + typescriptPkg.version + '_' + CACHE_BUSTER;\n\n const terserPkg = getPkg(opts.nodeModulesDir, 'terser');\n const minifyJsId = terserPkg.name + terserPkg.version + '_' + CACHE_BUSTER;\n\n const rollupPkg = getPkg(opts.nodeModulesDir, 'rollup');\n const bundlerId = rollupPkg.name + rollupPkg.version + '_' + CACHE_BUSTER;\n\n const autoprefixerPkg = getPkg(opts.nodeModulesDir, 'autoprefixer');\n const postcssPkg = getPkg(opts.nodeModulesDir, 'postcss');\n\n const optimizeCssId =\n autoprefixerPkg.name + autoprefixerPkg.version + '_' + postcssPkg.name + postcssPkg.version + '_' + CACHE_BUSTER;\n\n return {\n __BUILDID__: opts.buildId,\n '__BUILDID:BUNDLER__': bundlerId,\n '__BUILDID:MINIFYJS__': minifyJsId,\n '__BUILDID:OPTIMIZECSS__': optimizeCssId,\n '__BUILDID:TRANSPILE__': transpileId,\n\n '__VERSION:STENCIL__': opts.version,\n '__VERSION:PARSE5__': opts.parse5Version,\n '__VERSION:ROLLUP__': opts.rollupVersion,\n '__VERSION:JQUERY__': opts.jqueryVersion,\n '__VERSION:TERSER__': opts.terserVersion,\n '__VERSION:TYPESCRIPT__': opts.typescriptVersion,\n\n __VERMOJI__: opts.vermoji,\n };\n}\n\ntype VersionedPackageData = PackageData & { version: string };\n\n/**\n * Retrieves a package from the `node_modules` directory in the given `opts` parameter\n * @param nodeModulesDir the node modules directory to search\n * @param pkgName the name of the NPM package to retrieve\n * @returns information about the retrieved package\n */\nfunction getPkg(nodeModulesDir: string, pkgName: string): VersionedPackageData {\n const packageJson = require(join(nodeModulesDir, pkgName, 'package.json'));\n if (!packageJson.version) {\n throw Error(`Didn't find a version in the packageJson for ${pkgName}!`);\n }\n return packageJson;\n}\n\nexport interface BuildOptions {\n buildDir: string;\n bundleHelpersDir: string;\n ghRepoName: string;\n ghRepoOrg: string;\n nodeModulesDir: string;\n rootDir: string;\n scriptsBuildDir: string;\n scriptsBundlesDir: string;\n scriptsDir: string;\n srcDir: string;\n typescriptDir: string;\n typescriptLibDir: string;\n\n output: {\n cliDir: string;\n compilerDir: string;\n devServerDir: string;\n internalDir: string;\n mockDocDir: string;\n screenshotDir: string;\n sysNodeDir: string;\n testingDir: string;\n };\n\n buildId: string;\n changelogPath: string;\n isCI: boolean;\n isProd: boolean;\n isPublishRelease: boolean;\n isWatch: boolean;\n jqueryVersion: string;\n packageJson: PackageData;\n packageJsonPath: string;\n packageLockJsonPath: string;\n parse5Version: string;\n rollupVersion: string;\n tag: string;\n terserVersion: string;\n typescriptVersion: string;\n vermoji: string;\n version: string;\n}\n\n/**\n * Generate a build identifier, which is the Epoch Time in seconds\n * @returns the generated build ID\n */\nfunction getBuildId(): string {\n return Date.now().toString(10).slice(0, -3);\n}\n\n/**\n * Describes the contents of a version string for Stencil used in 'non-production' builds (e.g. a one-off dev build)\n */\ninterface DevVersionContents {\n /**\n * The build identifier string, used to uniquely identify when the build was generated\n */\n buildId: string;\n /**\n * A semver-compliant string to add to the one-off build version sting, used to identify a base version of Stencil\n * that was used in the build.\n */\n semverVersion: string | undefined;\n}\n\n/**\n * Helper function to return the first seven characters of a git SHA\n *\n * We use the first seven characters for two reasons:\n * 1. Seven characters _should_ be enough to uniquely ID a commit in Stencil\n * 2. It matches the number of characters used in our CHANGELOG.md\n *\n * @returns the seven character SHA\n */\nfunction getSevenCharGitSha(): string {\n return execSync('git rev-parse HEAD').toString().trim().slice(0, 7);\n}\n\n/**\n * Helper function to generate a dev build version string of the format:\n *\n * [BASE_VERSION]-dev.[BUILD_IDENTIFIER].[GIT_SHA]\n *\n * where:\n * - BASE_VERSION is the version of Stencil currently assigned in `package.json`\n * - BUILD_IDENTIFIER is a unique identifier for this particular build\n * - GIT_SHA is the SHA of the HEAD of the branch this build was created from\n *\n * @param devVersionContents an object containing the necessary arguments to build a dev-version identifier\n * @returns the generated version string\n */\nfunction getDevVersionId(devVersionContents: DevVersionContents): string {\n const { buildId, semverVersion } = devVersionContents;\n // if `package.json#package` is empty, default to a value that doesn't imply any particular version of Stencil\n const version = semverVersion ?? '0.0.0';\n // '-' and '-dev.' are a magic substrings that may get checked on startup of a Stencil process.\n return version + '-dev.' + buildId + '.' + getSevenCharGitSha();\n}\n"
},
{
"path": "scripts/utils/postcss-bundle",
"content": "#!/bin/bash\n\ncd ../build\n#rm -rf ./postcss\n#git clone https://github.com/postcss/postcss.git --depth 1\ncd ../..\necho $PWD\n./node_modules/.bin/rollup -c ./scripts/utils/postcss-rollup.js"
},
{
"path": "scripts/utils/postcss-rollup.js",
"content": "import fs from 'fs-extra';\nimport path from 'path';\n\nconst input = require.resolve('postcss');\nconst output = path.join(__dirname, '..', 'bundles', 'helpers', 'postcss.js');\nconst postcssPkg = fs.readJSONSync(path.join(input, '..', '..', 'package.json'));\n\nexport default {\n input,\n output: {\n format: 'esm',\n file: output,\n banner: `// postcss esm build from ${postcssPkg.version}`,\n },\n plugins: [\n {\n resolveId(importee, importer) {\n if (importee.startsWith('.')) {\n if (importer && importer.endsWith('.es6')) {\n const dir = path.dirname(importer);\n return path.join(dir, importee + '.es6');\n }\n }\n },\n },\n ],\n};\n"
},
{
"path": "scripts/utils/release-utils.ts",
"content": "import color from 'ansi-colors';\nimport fs from 'fs-extra';\nimport { join } from 'path';\nimport semver from 'semver';\n\nimport { BuildOptions } from './options';\n\nexport const SEMVER_INCREMENTS: ReadonlyArray = [\n 'patch',\n 'minor',\n 'major',\n 'prepatch',\n 'preminor',\n 'premajor',\n 'prerelease',\n];\n\nexport const PRERELEASE_VERSIONS: ReadonlyArray = ['prepatch', 'preminor', 'premajor', 'prerelease'];\n\n/**\n * Helper function to help determine if a version is valid semver\n * @param input the version string to validate\n * @returns true if the `input` is valid semver, false otherwise\n */\nexport const isValidVersion = (input: string) => Boolean(semver.valid(input));\n\n/**\n * Determines whether or not a version string is valid. A version string is considered to be 'valid' if it meets one of\n * two criteria:\n * - it is a valid semver name (e.g. 'patch', 'major', etc.)\n * - it is a valid semver string (e.g. '1.0.2')\n * @param input the version string to validate\n * @returns true if the string is valid, false otherwise\n */\nexport const isValidVersionInput = (input: string): boolean =>\n SEMVER_INCREMENTS.indexOf(input) !== -1 || isValidVersion(input);\n\n/**\n * Determines if the provided `version` is a semver pre-release or not\n * @param version the version string to evaluate\n * @returns true if the `version` is a pre-release, false otherwise\n */\nexport const isPrereleaseVersion = (version: string): boolean =>\n PRERELEASE_VERSIONS.indexOf(version) !== -1 || Boolean(semver.prerelease(version));\n\n/**\n * Determine the 'next' version string for a release. The next version can take one of two formats:\n * 1. An alphabetic string that is a valid semver name (e.g. 'patch', 'major', etc.)\n * 2. A valid semver string (e.g. '1.0.2')\n * The value returned by this function is predicated on the format of `oldVersion`. If `oldVersion` is an alphabetic\n * semver name, a semver name will be returned (e.g. 'major'). If a valid semver string is provided (e.g. 1.0.2), the\n * incremented semver string will be returned (e.g. 2.0.0)\n * @param oldVersion the old/current version of the library\n * @param input the desired increment unit\n * @returns new version's string\n */\nexport function getNewVersion(oldVersion: string, input: any): string {\n const isValidSemverName = SEMVER_INCREMENTS.indexOf(input) === -1;\n const incrementedSemverString = semver.inc(oldVersion, input);\n\n if (isValidSemverName) return input;\n if (incrementedSemverString !== null) return incrementedSemverString;\n throw new Error(`Version should be either ${SEMVER_INCREMENTS.join(', ')} or a valid semver version.`);\n}\n\n/**\n * Pretty printer for a new version of the library. Generates a new version string based on `inc`\n * @param oldVersion the old/current version of Stencil\n * @param inc the unit of increment for the new version\n * @returns a pretty printed string containing the new version number\n */\nexport function prettyVersionDiff(oldVersion: string, inc: any): string {\n const newVersion = getNewVersion(oldVersion, inc).split('.');\n const splitOldVersion = oldVersion.split('.');\n let firstVersionChange = false;\n const output = [];\n\n for (let i = 0; i < newVersion.length; i++) {\n if (newVersion[i] !== splitOldVersion[i] && !firstVersionChange) {\n output.push(`${color.dim.cyan(newVersion[i])}`);\n firstVersionChange = true;\n } else if (newVersion[i].indexOf('-') >= 1) {\n let preVersion = [];\n preVersion = newVersion[i].split('-');\n output.push(`${color.dim.cyan(`${preVersion[0]}-${preVersion[1]}`)}`);\n } else {\n output.push(color.reset.dim(newVersion[i]));\n }\n }\n return output.join(color.reset.dim('.'));\n}\n\n/**\n * Write changes to the local CHANGELOG.md on disk.\n *\n * Stencil uses the Angular-variant of conventional commits; commits must be formatted accordingly in order to be added\n * to the changelog properly.\n * @param opts build options to be used to update the changelog\n */\nexport async function updateChangeLog(opts: BuildOptions): Promise {\n const ccPath = join(opts.nodeModulesDir, '.bin', 'conventional-changelog');\n const ccConfigPath = join(__dirname, 'conventional-changelog-config.js');\n const { execa } = await import('execa');\n // API Docs for conventional-changelog: https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-core#api\n await execa(\n 'node',\n [\n ccPath,\n '--preset',\n 'angular',\n '--infile',\n opts.changelogPath,\n '--outfile',\n '--same-file',\n '--config',\n ccConfigPath,\n ],\n {\n cwd: opts.rootDir,\n },\n );\n\n let changelog = await fs.readFile(opts.changelogPath, 'utf8');\n changelog = changelog.replace(/\\# \\[/, '# ' + opts.vermoji + ' [');\n await fs.writeFile(opts.changelogPath, changelog);\n}\n\n/**\n * Generate a GitHub release and create it. This function assumes that the CHANGELOG.md file has been written to disk.\n * @param opts build options to be used to create a GitHub release\n */\nexport async function postGithubRelease(opts: BuildOptions): Promise {\n const versionTag = `v${opts.version}`;\n const title = `${opts.vermoji} ${opts.version}`;\n\n const lines = (await fs.readFile(opts.changelogPath, 'utf8')).trim().split('\\n');\n\n let body = '';\n for (let i = 1; i < 500; i++) {\n const currentLine = lines[i];\n\n if (currentLine == undefined) {\n // we don't test this as `!currentLine`, as an empty string is permitted in the changelog\n break;\n }\n\n const isMajorOrMinorVersionHeader = currentLine.startsWith('# ');\n const isPatchVersionHeader = currentLine.startsWith('## ');\n if (isMajorOrMinorVersionHeader || isPatchVersionHeader) {\n break;\n }\n body += currentLine + '\\n';\n }\n\n // https://docs.github.com/en/github/administering-a-repository/automation-for-release-forms-with-query-parameters\n const url = new URL(`https://github.com/${opts.ghRepoOrg}/${opts.ghRepoName}/releases/new`);\n url.searchParams.set('tag', versionTag);\n\n const timestamp = new Date().toISOString().substring(0, 10);\n\n // this will be automatically encoded for us, no need to call `encodeURIComponent` here. doing so will result in a\n // double encoding, which does not render properly in GitHub\n url.searchParams.set('title', `${title} (${timestamp})`);\n\n url.searchParams.set('body', body.trim());\n if (opts.tag === 'next' || opts.tag === 'test') {\n url.searchParams.set('prerelease', '1');\n }\n\n const open = (await import('open')).default;\n await open(url.href);\n}\n"
},
{
"path": "scripts/utils/test/options.spec.ts",
"content": "import path from 'path';\n\nimport { BuildOptions, getOptions } from '../options';\nimport * as Vermoji from '../vermoji';\n\ndescribe('release options', () => {\n describe('getOptions', () => {\n const ROOT_DIR = path.join(__dirname, '../../..');\n // Friday, February 24, 2023 2:42:09.123 PM, GMT\n const FAKE_SYSTEM_TIME_MS = 1677249729123;\n const FAKE_SYSTEM_TIME_S = FAKE_SYSTEM_TIME_MS.toString(10).slice(0, -3);\n\n beforeEach(() => {\n jest.useFakeTimers();\n jest.setSystemTime(FAKE_SYSTEM_TIME_MS);\n });\n\n afterEach(() => {\n jest.useRealTimers();\n });\n\n it('returns the correct default value', () => {\n const buildOpts = getOptions(ROOT_DIR);\n\n expect(buildOpts).toEqual({\n buildDir: path.join(ROOT_DIR, 'build'),\n // More focused tests for `buildId` can be found in another testing suite in this file\n buildId: expect.any(String),\n bundleHelpersDir: path.join(ROOT_DIR, 'scripts', 'esbuild', 'helpers'),\n changelogPath: path.join(ROOT_DIR, 'CHANGELOG.md'),\n ghRepoName: 'stencil',\n ghRepoOrg: 'ionic-team',\n isCI: false,\n isProd: false,\n isPublishRelease: false,\n isWatch: false,\n nodeModulesDir: path.join(ROOT_DIR, 'node_modules'),\n output: {\n cliDir: path.join(ROOT_DIR, 'cli'),\n compilerDir: path.join(ROOT_DIR, 'compiler'),\n devServerDir: path.join(ROOT_DIR, 'dev-server'),\n internalDir: path.join(ROOT_DIR, 'internal'),\n mockDocDir: path.join(ROOT_DIR, 'mock-doc'),\n screenshotDir: path.join(ROOT_DIR, 'screenshot'),\n sysNodeDir: path.join(ROOT_DIR, 'sys', 'node'),\n testingDir: path.join(ROOT_DIR, 'testing'),\n },\n // reads in package.json, skip it verifying it\n packageJson: expect.any(Object),\n packageJsonPath: path.join(ROOT_DIR, 'package.json'),\n packageLockJsonPath: path.join(ROOT_DIR, 'package-lock.json'),\n rootDir: ROOT_DIR,\n scriptsBuildDir: path.join(ROOT_DIR, 'scripts', 'build'),\n scriptsBundlesDir: path.join(ROOT_DIR, 'scripts', 'esbuild'),\n scriptsDir: path.join(ROOT_DIR, 'scripts'),\n srcDir: path.join(ROOT_DIR, 'src'),\n tag: 'dev',\n typescriptDir: path.join(ROOT_DIR, 'node_modules', 'typescript'),\n typescriptLibDir: path.join(ROOT_DIR, 'node_modules', 'typescript', 'lib'),\n vermoji: '💎',\n // More focused tests for `version` can be found in another testing suite in this file\n version: expect.any(String),\n jqueryVersion: expect.any(String),\n parse5Version: expect.any(String),\n terserVersion: expect.any(String),\n rollupVersion: expect.any(String),\n typescriptVersion: expect.any(String),\n });\n });\n\n describe('buildId', () => {\n it('defaults the buildId if none is provided', () => {\n const { buildId } = getOptions(ROOT_DIR);\n\n expect(buildId).toBeDefined();\n expect(buildId).toBe(FAKE_SYSTEM_TIME_S);\n });\n\n it('uses the provided the buildId', () => {\n const expectedBuildId = 'test-build-id';\n const { buildId } = getOptions(ROOT_DIR, { buildId: expectedBuildId });\n\n expect(buildId).toBeDefined();\n expect(buildId).toBe(expectedBuildId);\n });\n });\n\n describe('version', () => {\n it('defaults the version if none is provided', () => {\n const { version } = getOptions(ROOT_DIR);\n\n expect(version).toBeDefined();\n // Expect a version string with the format 0.0.0-dev-[EPOCH_TIME]-[GIT_SHA_7_CHARS]\n // or, contain a possible pre-release string like 0.0.0-beta.0-dev-[EPOCH_TIME]-[GIT_SHA_7_CHARS]\n\n expect(version).toMatch(new RegExp(`\\\\d+\\\\.\\\\d+\\\\.\\\\d+(-(.{1,}))?-dev.${FAKE_SYSTEM_TIME_S}.\\\\w{7}`));\n });\n\n it('uses the provided version', () => {\n const expectedVersion = '3.0.0-dev-1234';\n const { version } = getOptions(ROOT_DIR, { version: expectedVersion });\n\n expect(version).toBeDefined();\n expect(version).toBe(expectedVersion);\n });\n });\n\n describe('publish + prod check', () => {\n it(\"throws an error if 'isPublishRelease' is set, but Stencil is not built for 'isProd'\", () => {\n expect(() => getOptions(ROOT_DIR, { isProd: false, isPublishRelease: true })).toThrow(\n 'release must also be a prod build',\n );\n });\n\n it.each>([\n { isProd: false },\n { isPublishRelease: false },\n { isProd: false, isPublishRelease: false },\n { isProd: true, isPublishRelease: false },\n { isProd: true, isPublishRelease: true },\n ])(\"does not throw an error for other combinations of 'isPublishRelease' and 'isProd'\", (buildOpts) => {\n expect(() => getOptions(ROOT_DIR, buildOpts)).not.toThrow();\n });\n });\n\n describe('vermoji', () => {\n let getVermojiSpy: jest.SpyInstance, Parameters>;\n\n beforeEach(() => {\n getVermojiSpy = jest.spyOn(Vermoji, 'getVermoji');\n getVermojiSpy.mockImplementation((_changelogPath) => '🧀');\n });\n\n afterEach(() => {\n getVermojiSpy.mockRestore();\n });\n\n it('defaults to 💎 for non-prod builds', () => {\n expect(getOptions(ROOT_DIR).vermoji).toBe('💎');\n });\n\n it.each>([\n { isProd: true, vermoji: '🦄' },\n { isProd: false, vermoji: '🦄' },\n ])(\"uses the provided vermoji, regardless of 'isProd'\", () => {\n const expectedVermoji = '🦄';\n const { vermoji } = getOptions(ROOT_DIR, { vermoji: expectedVermoji });\n expect(vermoji).toEqual('🦄');\n });\n\n it('picks a new vermoji when none is provided for prod builds', () => {\n const { vermoji } = getOptions(ROOT_DIR, { isProd: true });\n expect(vermoji).toEqual('🧀');\n });\n });\n });\n});\n"
},
{
"path": "scripts/utils/test/release-utils.spec.ts",
"content": "import fs from 'fs-extra';\n\nimport { BuildOptions } from '../options';\n\n// `open` must be mocked before importing the module under test\nconst openMock = jest.fn();\njest.mock('open', () => openMock);\n\nimport { postGithubRelease } from '../release-utils';\n\ndescribe('release-utils', () => {\n describe('postGithubRelease', () => {\n jest.useFakeTimers().setSystemTime(new Date('2022-01-01').getTime());\n\n let buildOptions: BuildOptions;\n\n let mockReadFile: jest.SpyInstance, Parameters>;\n\n beforeEach(() => {\n mockReadFile = jest.spyOn(fs, 'readFile');\n\n buildOptions = {\n changelogPath: 'some/mock/CHANGELOG.md',\n ghRepoName: 'stencil',\n ghRepoOrg: 'ionic-team',\n tag: 'dev',\n vermoji: '🚗',\n version: '0.0.0',\n };\n });\n\n afterEach(() => {\n jest.clearAllMocks();\n });\n\n afterAll(() => {\n jest.resetAllMocks();\n });\n\n it('creates an empty body if the changelog is empty', async () => {\n // Jest isn't smart enough to pick the correct overloaded method, so we must do type assertions to get our spy to\n // return a string (as if we called the original with an encoding argument)\n mockReadFile.mockResolvedValue('' as unknown as Buffer);\n\n await postGithubRelease(buildOptions);\n\n expect(openMock).toHaveBeenCalledTimes(1);\n expect(openMock).toHaveBeenCalledWith(\n 'https://github.com/ionic-team/stencil/releases/new?tag=v0.0.0&title=%F0%9F%9A%97+0.0.0+%282022-01-01%29&body=',\n );\n });\n\n it('splits a minor release from a previous patch release', async () => {\n const minorReleaseFollowingPatch = `# 🍣 [2.13.0](https://github.com/ionic-team/stencil/compare/v2.12.1...v2.13.0) (2022-01-24)\n\n\n### Features\n\n* **mock-doc:** add simple MockEvent#composedPath() impl ([#3204](https://github.com/ionic-team/stencil/issues/3204)) ([7b47d96](https://github.com/ionic-team/stencil/commit/7b47d96e1e3c6c821d5c416fbe987646b4cd1551))\n* **test:** jest 27 support ([#3189](https://github.com/ionic-team/stencil/issues/3189)) ([10efeb6](https://github.com/ionic-team/stencil/commit/10efeb6f74888f05a13a47d8afc00b5e83a3f3db))\n\n\n\n## 🍔 [2.12.1](https://github.com/ionic-team/stencil/compare/v2.12.0...v2.12.1) (2022-01-04)\n\n\n### Bug Fixes\n\n* **vdom:** properly warn for step attr on input ([#3196](https://github.com/ionic-team/stencil/issues/3196)) ([7ffc02e](https://github.com/ionic-team/stencil/commit/7ffc02e5d07b05de45cbaf4f0cce3f3e165b3eb0))\n\n\n### Features\n\n* **typings:** add optional key and ref to slot elements ([#3177](https://github.com/ionic-team/stencil/issues/3177)) ([ce27a18](https://github.com/ionic-team/stencil/commit/ce27a18ba8ecdb2cc5401470747a7e9d91e40a44))\n`;\n\n // Jest isn't smart enough to pick the correct overloaded method, so we must do type assertions to get our spy to\n // return a string (as if we called the original with an encoding argument)\n mockReadFile.mockResolvedValue(minorReleaseFollowingPatch as unknown as Buffer);\n\n await postGithubRelease(buildOptions);\n\n expect(openMock).toHaveBeenCalledTimes(1);\n expect(openMock).toHaveBeenCalledWith(\n 'https://github.com/ionic-team/stencil/releases/new?tag=v0.0.0&title=%F0%9F%9A%97+0.0.0+%282022-01-01%29&body=%23%23%23+Features%0A%0A*+**mock-doc%3A**+add+simple+MockEvent%23composedPath%28%29+impl+%28%5B%233204%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fissues%2F3204%29%29+%28%5B7b47d96%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fcommit%2F7b47d96e1e3c6c821d5c416fbe987646b4cd1551%29%29%0A*+**test%3A**+jest+27+support+%28%5B%233189%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fissues%2F3189%29%29+%28%5B10efeb6%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fcommit%2F10efeb6f74888f05a13a47d8afc00b5e83a3f3db%29%29',\n );\n });\n\n it('splits a minor release from a previous minor release', async () => {\n const minorReleaseFollowingMinor = `# ⛸ [2.12.0](https://github.com/ionic-team/stencil/compare/v2.11.0...v2.12.0) (2021-12-13)\n\n\n### Bug Fixes\n\n* **cli:** wait for help task to finish before exiting ([#3160](https://github.com/ionic-team/stencil/issues/3160)) ([f10cee1](https://github.com/ionic-team/stencil/commit/f10cee12a8d00e7581fcf13216f01ded46227f49))\n* **mock-doc:** make Node.contains() return true for self ([#3150](https://github.com/ionic-team/stencil/issues/3150)) ([f164407](https://github.com/ionic-team/stencil/commit/f164407f7463faba7a3c39afca942c2a26210b82))\n* **mock-doc:** allow urls as css values ([#2857](https://github.com/ionic-team/stencil/issues/2857)) ([6faa5f2](https://github.com/ionic-team/stencil/commit/6faa5f2f196ff786ffc4b818ac09708ba5de9b35))\n* **sourcemaps:** do not encode inline sourcemaps ([#3163](https://github.com/ionic-team/stencil/issues/3163)) ([b2eb083](https://github.com/ionic-team/stencil/commit/b2eb083306802645ee6e31987917dea942882e46)), closes [#3147](https://github.com/ionic-team/stencil/issues/3147)\n\n\n### Features\n\n* **dist-custom-elements-bundle:** add deprecation warning ([#3167](https://github.com/ionic-team/stencil/issues/3167)) ([c7b07c6](https://github.com/ionic-team/stencil/commit/c7b07c65265c7d4715f29835632cc6538ea63585))\n\n\n\n# 🐌 [2.11.0](https://github.com/ionic-team/stencil/compare/v2.11.0-0...v2.11.0) (2021-11-22)\n\n\n### Bug Fixes\n\n* **dist-custom-elements:** add ssr checks ([#3131](https://github.com/ionic-team/stencil/issues/3131)) ([9a232ea](https://github.com/ionic-team/stencil/commit/9a232ea368324f49993bd079cfdbc344abd0c69e))\n\n\n### Features\n\n* **css:** account for escaped ':' in css selectors ([#3087](https://github.com/ionic-team/stencil/issues/3087)) ([6000681](https://github.com/ionic-team/stencil/commit/600068168c86dba9ea610b5e8a0dbba00ff4d1f4))\n`;\n\n // Jest isn't smart enough to pick the correct overloaded method, so we must do type assertions to get our spy to\n // return a string (as if we called the original with an encoding argument)\n mockReadFile.mockResolvedValue(minorReleaseFollowingMinor as unknown as Buffer);\n\n await postGithubRelease(buildOptions);\n\n expect(openMock).toHaveBeenCalledTimes(1);\n expect(openMock).toHaveBeenCalledWith(\n 'https://github.com/ionic-team/stencil/releases/new?tag=v0.0.0&title=%F0%9F%9A%97+0.0.0+%282022-01-01%29&body=%23%23%23+Bug+Fixes%0A%0A*+**cli%3A**+wait+for+help+task+to+finish+before+exiting+%28%5B%233160%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fissues%2F3160%29%29+%28%5Bf10cee1%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fcommit%2Ff10cee12a8d00e7581fcf13216f01ded46227f49%29%29%0A*+**mock-doc%3A**+make+Node.contains%28%29+return+true+for+self+%28%5B%233150%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fissues%2F3150%29%29+%28%5Bf164407%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fcommit%2Ff164407f7463faba7a3c39afca942c2a26210b82%29%29%0A*+**mock-doc%3A**+allow+urls+as+css+values+%28%5B%232857%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fissues%2F2857%29%29+%28%5B6faa5f2%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fcommit%2F6faa5f2f196ff786ffc4b818ac09708ba5de9b35%29%29%0A*+**sourcemaps%3A**+do+not+encode+inline+sourcemaps+%28%5B%233163%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fissues%2F3163%29%29+%28%5Bb2eb083%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fcommit%2Fb2eb083306802645ee6e31987917dea942882e46%29%29%2C+closes+%5B%233147%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fissues%2F3147%29%0A%0A%0A%23%23%23+Features%0A%0A*+**dist-custom-elements-bundle%3A**+add+deprecation+warning+%28%5B%233167%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fissues%2F3167%29%29+%28%5Bc7b07c6%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fcommit%2Fc7b07c65265c7d4715f29835632cc6538ea63585%29%29',\n );\n });\n\n it('splits a patch release from a previous patch release', async () => {\n const patchReleaseFollowingPatch = `## ♨️ [2.12.2](https://github.com/ionic-team/stencil/compare/v2.12.1...v2.12.2) (2022-01-24)\n\n\n### Features\n\n* **mock-doc:** add simple MockEvent#composedPath() impl ([#3204](https://github.com/ionic-team/stencil/issues/3204)) ([7b47d96](https://github.com/ionic-team/stencil/commit/7b47d96e1e3c6c821d5c416fbe987646b4cd1551))\n* **test:** jest 27 support ([#3189](https://github.com/ionic-team/stencil/issues/3189)) ([10efeb6](https://github.com/ionic-team/stencil/commit/10efeb6f74888f05a13a47d8afc00b5e83a3f3db))\n\n\n\n## 🍔 [2.12.1](https://github.com/ionic-team/stencil/compare/v2.12.0...v2.12.1) (2022-01-04)\n\n\n### Bug Fixes\n\n* **vdom:** properly warn for step attr on input ([#3196](https://github.com/ionic-team/stencil/issues/3196)) ([7ffc02e](https://github.com/ionic-team/stencil/commit/7ffc02e5d07b05de45cbaf4f0cce3f3e165b3eb0))\n\n\n### Features\n\n* **typings:** add optional key and ref to slot elements ([#3177](https://github.com/ionic-team/stencil/issues/3177)) ([ce27a18](https://github.com/ionic-team/stencil/commit/ce27a18ba8ecdb2cc5401470747a7e9d91e40a44))\n`;\n\n // Jest isn't smart enough to pick the correct overloaded method, so we must do type assertions to get our spy to\n // return a string (as if we called the original with an encoding argument)\n mockReadFile.mockResolvedValue(patchReleaseFollowingPatch as unknown as Buffer);\n\n await postGithubRelease(buildOptions);\n\n expect(openMock).toHaveBeenCalledTimes(1);\n expect(openMock).toHaveBeenCalledWith(\n 'https://github.com/ionic-team/stencil/releases/new?tag=v0.0.0&title=%F0%9F%9A%97+0.0.0+%282022-01-01%29&body=%23%23%23+Features%0A%0A*+**mock-doc%3A**+add+simple+MockEvent%23composedPath%28%29+impl+%28%5B%233204%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fissues%2F3204%29%29+%28%5B7b47d96%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fcommit%2F7b47d96e1e3c6c821d5c416fbe987646b4cd1551%29%29%0A*+**test%3A**+jest+27+support+%28%5B%233189%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fissues%2F3189%29%29+%28%5B10efeb6%5D%28https%3A%2F%2Fgithub.com%2Fionic-team%2Fstencil%2Fcommit%2F10efeb6f74888f05a13a47d8afc00b5e83a3f3db%29%29',\n );\n });\n });\n});\n"
},
{
"path": "scripts/utils/vermoji.ts",
"content": "import fs from 'fs-extra';\n\nconst UNKNOWN_VERMOJI = '❓';\n\nlet vermojis = [\n '💯',\n '☀️',\n '☕️',\n '♨️',\n '✈️',\n '✨',\n '❄️',\n '❤️',\n '☎️',\n '⚡️',\n '⚽️',\n '⚾️',\n '⛄️',\n '⛑',\n '⛰',\n '⛱',\n '⛲️',\n '⛳️',\n '⛴',\n '⛵️',\n '⛷',\n '⛸',\n '⛹',\n '⛺️',\n '⭐️',\n '🌀',\n '🌁',\n '🌃',\n '🌄',\n '🌅',\n '🌇',\n '🌈',\n '🌍',\n '🌎',\n '🌏',\n '🌐',\n '🌙',\n '🌜',\n '🌝',\n '🌞',\n '🌟',\n '🌪',\n '🌭',\n '🌮',\n '🌯',\n '🌱',\n '🌲',\n '🌳',\n '🌴',\n '🌵',\n '🌶',\n '🌷',\n '🌸',\n '🌹',\n '🌺',\n '🌻',\n '🌼',\n '🍀',\n '🍁',\n '🍅',\n '🍇',\n '🍈',\n '🍉',\n '🍊',\n '🍋',\n '🍌',\n '🍍',\n '🍎',\n '🍏',\n '🍐',\n '🍒',\n '🍓',\n '🍔',\n '🍕',\n '🍖',\n '🍗',\n '🍜',\n '🍝',\n '🍞',\n '🍟',\n '🍡',\n '🍣',\n '🍤',\n '🍦',\n '🍧',\n '🍨',\n '🍩',\n '🍪',\n '🍫',\n '🍬',\n '🍭',\n '🍮',\n '🍯',\n '🍰',\n '🍲',\n '🍵',\n '🍷',\n '🍸',\n '🍹',\n '🍺',\n '🍻',\n '🥃',\n '🍾',\n '🍿',\n '🎀',\n '🎁',\n '🎂',\n '🎆',\n '🎇',\n '🎈',\n '🎉',\n '🎊',\n '🎖',\n '🎙',\n '🎠',\n '🎡',\n '🎢',\n '🎤',\n '🎨',\n '🎩',\n '🎪',\n '🎬',\n '🎭',\n '🎯',\n '🎰',\n '🎱',\n '🎲',\n '🎳',\n '🎷',\n '🎸',\n '🎹',\n '🎺',\n '🎻',\n '🎾',\n '🎿',\n '🏀',\n '🏁',\n '🏂',\n '🏃',\n '🏄',\n '🏅',\n '🏆',\n '🏇',\n '🏈',\n '🏉',\n '🏊',\n '🏋',\n '🏌',\n '🏍',\n '🏎',\n '🏏',\n '🏐',\n '🏑',\n '🏒',\n '🏓',\n '🏔',\n '🏕',\n '🏖',\n '🏙',\n '🏜',\n '🏝',\n '🏰',\n '🏵',\n '🏸',\n '🏹',\n '🐁',\n '🐂',\n '🐄',\n '🐅',\n '🐆',\n '🐇',\n '🐈',\n '🐉',\n '🐊',\n '🐋',\n '🐌',\n '🐍',\n '🐎',\n '🐏',\n '🐐',\n '🐒',\n '🐓',\n '🐔',\n '🐕',\n '🐖',\n '🐗',\n '🐘',\n '🐙',\n '🐚',\n '🐛',\n '🐝',\n '🐞',\n '🐟',\n '🐠',\n '🐡',\n '🐣',\n '🐤',\n '🐥',\n '🐦',\n '🐧',\n '🐨',\n '🐩',\n '🐫',\n '🐬',\n '🐭',\n '🐮',\n '🐯',\n '🐰',\n '🐱',\n '🐳',\n '🐴',\n '🐵',\n '🐶',\n '🐷',\n '🐸',\n '🐹',\n '🐺',\n '🐻',\n '🐼',\n '🐽',\n '🐿',\n '👑',\n '👒',\n '👻',\n '👽',\n '👾',\n '💍',\n '💙',\n '💚',\n '💛',\n '💡',\n '💥',\n '💪',\n '💫',\n '💾',\n '💿',\n '📌',\n '📍',\n '📟',\n '🛰',\n '📢',\n '📣',\n '📬',\n '📷',\n '📺',\n '📻',\n '🔈',\n '🔋',\n '🔔',\n '🔥',\n '🔬',\n '🔭',\n '🔮',\n '🕊',\n '🕹',\n '🖍',\n '🗻',\n '😀',\n '😃',\n '😄',\n '😈',\n '😊',\n '😋',\n '😎',\n '😛',\n '😜',\n '😸',\n '🤓',\n '🤖',\n '🚀',\n '🚁',\n '🚂',\n '🚃',\n '🚅',\n '🚋',\n '🚌',\n '🚍',\n '🚎',\n '🚐',\n '🚑',\n '🚒',\n '🚓',\n '🚔',\n '🚕',\n '🚖',\n '🚗',\n '🚘',\n '🚙',\n '🚚',\n '🚛',\n '🚜',\n '🚞',\n '🚟',\n '🚠',\n '🚡',\n '🚢',\n '🚣',\n '🚤',\n '🚦',\n '🚨',\n '🚩',\n '🛠',\n '🛥',\n '🛩',\n '🛳',\n '🤘',\n '🦀',\n '🦁',\n '🦂',\n '🦃',\n '🦄',\n '🧀',\n];\n\n// filter out the 'unknown version vermoji'\nvermojis = vermojis.filter((vermoji) => vermoji !== UNKNOWN_VERMOJI);\n\nexport function getVermoji(changelogPath: string) {\n const changelog = fs.readFileSync(changelogPath, 'utf8');\n\n while (true) {\n const randomIndex = Math.floor(Math.random() * vermojis.length);\n const vermoji = vermojis[randomIndex];\n if (changelog.includes(vermoji)) {\n vermojis.splice(randomIndex, 1);\n\n if (vermojis.length === 0) {\n console.warn(`We're out of Vermoji! Create a task to add some more!`);\n return UNKNOWN_VERMOJI;\n }\n } else {\n return vermoji;\n }\n }\n}\n\n/**\n * Pull the most recently used vermoji for the provided changelog path\n * @param changelogPath the path to the changelog to parse\n * @returns the vermoji found in the changelog, otherwise use a default value.\n */\nexport function getLatestVermoji(changelogPath: string) {\n let changelogContents = null;\n try {\n changelogContents = fs.readFileSync(changelogPath, 'utf8');\n } catch (err: unknown) {\n console.error(`Unable to read the changelog at path '${changelogPath}' - ${err}.`);\n console.error(`Defaulting to ${UNKNOWN_VERMOJI}`);\n return UNKNOWN_VERMOJI;\n }\n\n if (!changelogContents) {\n console.error(`The changelog at '${changelogPath}' was empty!`);\n console.error(`Defaulting to ${UNKNOWN_VERMOJI}`);\n return UNKNOWN_VERMOJI;\n }\n\n // grab the first line of the changelog\n const firstLine = changelogContents.trimStart().split('\\n')[0];\n // match the first line of the changelog with a string that has:\n // - one or more pound signs (#), followed by a space\n // - capture the first non-space character(s)\n const match = firstLine.match(/^#+\\s(\\S+)/);\n // if a match was found, return the value in the first capture group. otherwise, use the default vermoji\n return match ? match[1] : UNKNOWN_VERMOJI;\n}\n"
},
{
"path": "scripts/utils/write-pkg-json.ts",
"content": "import fs from 'fs-extra';\nimport path from 'path';\n\nimport { BuildOptions } from './options';\n\nexport function writePkgJson(opts: BuildOptions, pkgDir: string, pkgData: PackageData) {\n pkgData.version = opts.version;\n pkgData.private = true;\n\n if (pkgData.main && !pkgData.main.startsWith('.')) {\n pkgData.main = `./${pkgData.main}`;\n }\n if (pkgData.module && !pkgData.module.startsWith('.')) {\n pkgData.module = `./${pkgData.module}`;\n }\n if (pkgData.types && !pkgData.types.startsWith('.')) {\n pkgData.types = `./${pkgData.types}`;\n }\n\n if (pkgData.module && pkgData.main) {\n pkgData.type = 'module';\n pkgData.exports = {\n import: pkgData.module,\n require: pkgData.main,\n };\n }\n\n // idk, i just like a nice pretty standardized order of package.json properties\n const formatedPkg: any = {};\n PROPS_ORDER.forEach((pkgProp) => {\n if (pkgProp in pkgData) {\n formatedPkg[pkgProp] = pkgData[pkgProp as keyof PackageData];\n }\n });\n\n fs.writeFileSync(path.join(pkgDir, 'package.json'), JSON.stringify(formatedPkg, null, 2) + '\\n');\n}\n\nconst PROPS_ORDER = [\n 'name',\n 'version',\n 'description',\n 'bin',\n 'main',\n 'module',\n 'browser',\n 'types',\n 'exports',\n 'type',\n 'files',\n 'private',\n 'sideEffects',\n];\n\nexport interface PackageData {\n name: string;\n description: string;\n main: string;\n module?: string;\n browser?: string;\n exports?: any;\n type?: string;\n types?: string;\n version?: string;\n dependencies?: string[];\n private?: boolean;\n license?: string | any;\n licenses?: string | any;\n author?: string | any;\n contributors?: string | any;\n homepage?: string;\n repository?: any;\n files?: string[];\n bin?: { [key: string]: string };\n sideEffects?: false;\n}\n"
},
{
"path": "src/app-data/index.ts",
"content": "import type { BuildConditionals } from '@stencil/core/internal';\n\n/**\n * A collection of default build flags for a Stencil project.\n *\n * This collection can be found throughout the Stencil codebase, often imported from the `@app-data` module like so:\n * ```ts\n * import { BUILD } from '@app-data';\n * ```\n * and is used to determine if a portion of the output of a Stencil _project_'s compilation step can be eliminated.\n *\n * e.g. When `BUILD.allRenderFn` evaluates to `false`, the compiler will eliminate conditional statements like:\n * ```ts\n * if (BUILD.allRenderFn) {\n * // some code that will be eliminated if BUILD.allRenderFn is false\n * }\n * ```\n *\n * `@app-data`, the module that `BUILD` is imported from, is an alias for the `@stencil/core/internal/app-data`, and is\n * partially referenced by {@link STENCIL_APP_DATA_ID}. The `src/compiler/bundle/app-data-plugin.ts` references\n * `STENCIL_APP_DATA_ID` uses it to replace these defaults with {@link BuildConditionals} that are derived from a\n * Stencil project's contents (i.e. metadata from the components). This replacement happens at a Stencil project's\n * compile time. Such code can be found at `src/compiler/app-core/app-data.ts`.\n */\nexport const BUILD: BuildConditionals = {\n allRenderFn: false,\n element: true,\n event: true,\n hasRenderFn: true,\n hostListener: true,\n hostListenerTargetWindow: true,\n hostListenerTargetDocument: true,\n hostListenerTargetBody: true,\n hostListenerTargetParent: false,\n hostListenerTarget: true,\n member: true,\n method: true,\n mode: true,\n observeAttribute: true,\n prop: true,\n propMutable: true,\n reflect: true,\n scoped: true,\n shadowDom: true,\n slot: true,\n cssAnnotations: true,\n state: true,\n style: true,\n formAssociated: false,\n svg: true,\n updatable: true,\n vdomAttribute: true,\n vdomXlink: true,\n vdomClass: true,\n vdomFunctional: true,\n vdomKey: true,\n vdomListener: true,\n vdomRef: true,\n vdomPropOrAttr: true,\n vdomRender: true,\n vdomStyle: true,\n vdomText: true,\n propChangeCallback: true,\n taskQueue: true,\n hotModuleReplacement: false,\n isDebug: false,\n isDev: false,\n isTesting: false,\n hydrateServerSide: false,\n hydrateClientSide: false,\n lifecycleDOMEvents: false,\n lazyLoad: false,\n profile: false,\n slotRelocation: true,\n // TODO(STENCIL-914): remove this option when `experimentalSlotFixes` is the default behavior\n appendChildSlotFix: false,\n // TODO(STENCIL-914): remove this option when `experimentalSlotFixes` is the default behavior\n cloneNodeFix: false,\n hydratedAttribute: false,\n hydratedClass: true,\n // TODO(STENCIL-1305): remove this option\n scriptDataOpts: false,\n // TODO(STENCIL-914): remove this option when `experimentalSlotFixes` is the default behavior\n scopedSlotTextContentFix: false,\n // TODO(STENCIL-854): Remove code related to legacy shadowDomShim field\n shadowDomShim: false,\n // TODO(STENCIL-914): remove this option when `experimentalSlotFixes` is the default behavior\n slotChildNodesFix: false,\n invisiblePrehydration: true,\n propBoolean: true,\n propNumber: true,\n propString: true,\n constructableCSS: true,\n devTools: false,\n shadowDelegatesFocus: true,\n shadowSlotAssignmentManual: false,\n initializeNextTick: false,\n asyncLoading: true,\n asyncQueue: false,\n // TODO: deprecated in favour of `setTagTransformer` and `transformTag`. Remove in 5.0\n transformTagName: false,\n attachStyles: true,\n // TODO(STENCIL-914): remove this option when `experimentalSlotFixes` is the default behavior\n experimentalSlotFixes: false,\n};\n\nexport const Env = {};\n\nexport const NAMESPACE = /* default */ 'app' as string;\n"
},
{
"path": "src/app-globals/index.ts",
"content": "export const globalScripts = /* default */ () => {\n /**/\n};\n\nexport const globalStyles = /* default */ '';\n"
},
{
"path": "src/cli/check-version.ts",
"content": "import { isFunction } from '@utils';\n\nimport type { ValidatedConfig } from '../declarations';\n\n/**\n * Retrieve a reference to the active `CompilerSystem`'s `checkVersion` function\n * @param config the Stencil configuration associated with the currently compiled project\n * @param currentVersion the Stencil compiler's version string\n * @returns a reference to `checkVersion`, or `null` if one does not exist on the current `CompilerSystem`\n */\nexport const startCheckVersion = async (\n config: ValidatedConfig,\n currentVersion: string,\n): Promise<(() => void) | null> => {\n if (config.devMode && !config.flags.ci && !currentVersion.includes('-dev.') && isFunction(config.sys.checkVersion)) {\n return config.sys.checkVersion(config.logger, currentVersion);\n }\n return null;\n};\n\n/**\n * Print the results of running the provided `versionChecker`.\n *\n * Does not print if no `versionChecker` is provided.\n *\n * @param versionChecker the function to invoke.\n */\nexport const printCheckVersionResults = async (versionChecker: Promise<(() => void) | null>): Promise => {\n if (versionChecker) {\n const checkVersionResults = await versionChecker;\n if (isFunction(checkVersionResults)) {\n checkVersionResults();\n }\n }\n};\n"
},
{
"path": "src/cli/config-flags.ts",
"content": "import type { LogLevel, TaskCommand } from '@stencil/core/declarations';\n\n/**\n * All the Boolean options supported by the Stencil CLI\n */\nexport const BOOLEAN_CLI_FLAGS = [\n 'build',\n 'cache',\n 'checkVersion',\n 'ci',\n 'compare',\n 'debug',\n 'dev',\n 'devtools',\n 'docs',\n // @deprecated - integrated testing will be removed in Stencil v5. See https://github.com/stenciljs/core/issues/6584.\n 'e2e',\n 'es5',\n 'esm',\n 'help',\n 'log',\n 'open',\n 'prerender',\n 'prerenderExternal',\n 'prod',\n 'profile',\n 'serviceWorker',\n // @deprecated - screenshot testing will be removed in Stencil v5. See https://github.com/stenciljs/core/issues/6584.\n 'screenshot',\n 'serve',\n 'skipNodeCheck',\n // @deprecated - integrated testing will be removed in Stencil v5. See https://github.com/stenciljs/core/issues/6584.\n 'spec',\n 'ssr',\n // @deprecated - screenshot testing will be removed in Stencil v5. See https://github.com/stenciljs/core/issues/6584.\n 'updateScreenshot',\n 'verbose',\n 'version',\n 'watch',\n\n // @deprecated - all JEST CLI options below are only used by integrated testing, which will be removed in Stencil v5.\n // See https://github.com/stenciljs/core/issues/6584.\n // JEST CLI OPTIONS\n 'all',\n 'automock',\n 'bail',\n // 'cache', Stencil already supports this argument\n 'changedFilesWithAncestor',\n // 'ci', Stencil already supports this argument\n 'clearCache',\n 'clearMocks',\n 'collectCoverage',\n 'color',\n 'colors',\n 'coverage',\n // 'debug', Stencil already supports this argument\n 'detectLeaks',\n 'detectOpenHandles',\n 'errorOnDeprecated',\n 'expand',\n 'findRelatedTests',\n 'forceExit',\n 'init',\n 'injectGlobals',\n 'json',\n 'lastCommit',\n 'listTests',\n 'logHeapUsage',\n 'noStackTrace',\n 'notify',\n 'onlyChanged',\n 'onlyFailures',\n 'passWithNoTests',\n 'resetMocks',\n 'resetModules',\n 'restoreMocks',\n 'runInBand',\n 'runTestsByPath',\n 'showConfig',\n 'silent',\n 'skipFilter',\n 'testLocationInResults',\n 'updateSnapshot',\n 'useStderr',\n // 'verbose', Stencil already supports this argument\n // 'version', Stencil already supports this argument\n // 'watch', Stencil already supports this argument\n 'watchAll',\n 'watchman',\n] as const;\n\n/**\n * All the Number options supported by the Stencil CLI\n */\nexport const NUMBER_CLI_FLAGS = [\n 'port',\n // @deprecated - all JEST CLI args below are only used by integrated testing, which will be removed in Stencil v5.\n // See https://github.com/stenciljs/core/issues/6584.\n // JEST CLI ARGS\n 'maxConcurrency',\n 'testTimeout',\n] as const;\n\n/**\n * All the String options supported by the Stencil CLI\n */\nexport const STRING_CLI_FLAGS = [\n 'address',\n 'config',\n 'docsApi',\n 'docsJson',\n 'emulate',\n 'root',\n // @deprecated - screenshot testing will be removed in Stencil v5. See https://github.com/stenciljs/core/issues/6584.\n 'screenshotConnector',\n\n // @deprecated - all JEST CLI args below are only used by integrated testing, which will be removed in Stencil v5.\n // See https://github.com/stenciljs/core/issues/6584.\n // JEST CLI ARGS\n 'cacheDirectory',\n 'changedSince',\n 'collectCoverageFrom',\n // 'config', Stencil already supports this argument\n 'coverageDirectory',\n 'coverageThreshold',\n 'env',\n 'filter',\n 'globalSetup',\n 'globalTeardown',\n 'globals',\n 'haste',\n 'moduleNameMapper',\n 'notifyMode',\n 'outputFile',\n 'preset',\n 'prettierPath',\n 'resolver',\n 'rootDir',\n 'runner',\n 'testEnvironment',\n 'testEnvironmentOptions',\n 'testFailureExitCode',\n 'testNamePattern',\n 'testResultsProcessor',\n 'testRunner',\n 'testSequencer',\n 'testURL',\n 'timers',\n 'transform',\n] as const;\n\n// @deprecated - all entries below are JEST CLI args only used by integrated testing, which will be removed in Stencil v5.\n// See https://github.com/stenciljs/core/issues/6584.\nexport const STRING_ARRAY_CLI_FLAGS = [\n 'collectCoverageOnlyFrom',\n 'coveragePathIgnorePatterns',\n 'coverageReporters',\n 'moduleDirectories',\n 'moduleFileExtensions',\n 'modulePathIgnorePatterns',\n 'modulePaths',\n 'projects',\n 'reporters',\n 'roots',\n 'selectProjects',\n 'setupFiles',\n 'setupFilesAfterEnv',\n 'snapshotSerializers',\n 'testMatch',\n 'testPathIgnorePatterns',\n 'testPathPattern',\n 'testRegex',\n 'transformIgnorePatterns',\n 'unmockedModulePathPatterns',\n 'watchPathIgnorePatterns',\n] as const;\n\n/**\n * All the CLI arguments which may have string or number values\n *\n * `maxWorkers` is an argument which is used both by Stencil _and_ by Jest,\n * which means that we need to support parsing both string and number values.\n */\nexport const STRING_NUMBER_CLI_FLAGS = ['maxWorkers'] as const;\n\n/**\n * All the CLI arguments which may have boolean or string values.\n */\nexport const BOOLEAN_STRING_CLI_FLAGS = [\n /**\n * `headless` is an argument passed through to Puppeteer (which is passed to Chrome) for end-to-end testing.\n *\n * {@see https://developer.chrome.com/blog/chrome-headless-shell/}\n */\n 'headless',\n /**\n * `stats` is an argument that can optionally accept a file path where stats should be written.\n * When used as a boolean (--stats), it defaults to 'stencil-stats.json'.\n * When used with a path (--stats dist/stats.json), it writes to that path.\n */\n 'stats',\n] as const;\n\n/**\n * All the LogLevel-type options supported by the Stencil CLI\n *\n * This is a bit silly since there's only one such argument atm,\n * but this approach lets us make sure that we're handling all\n * our arguments in a type-safe way.\n */\nexport const LOG_LEVEL_CLI_FLAGS = ['logLevel'] as const;\n\n/**\n * A type which gives the members of a `ReadonlyArray` as\n * an enum-like type which can be used for e.g. keys in a `Record`\n * (as in the `AliasMap` type below)\n */\ntype ArrayValuesAsUnion> = T[number];\n\nexport type BooleanCLIFlag = ArrayValuesAsUnion;\nexport type StringCLIFlag = ArrayValuesAsUnion;\nexport type StringArrayCLIFlag = ArrayValuesAsUnion;\nexport type NumberCLIFlag = ArrayValuesAsUnion;\nexport type StringNumberCLIFlag = ArrayValuesAsUnion;\nexport type BooleanStringCLIFlag = ArrayValuesAsUnion;\nexport type LogCLIFlag = ArrayValuesAsUnion;\n\nexport type KnownCLIFlag =\n | BooleanCLIFlag\n | StringCLIFlag\n | StringArrayCLIFlag\n | NumberCLIFlag\n | StringNumberCLIFlag\n | BooleanStringCLIFlag\n | LogCLIFlag;\n\ntype AliasMap = Partial>;\n\n/**\n * For a small subset of CLI options we support a short alias e.g. `'h'` for `'help'`\n */\nexport const CLI_FLAG_ALIASES: AliasMap = {\n c: 'config',\n h: 'help',\n p: 'port',\n v: 'version',\n\n // JEST SPECIFIC CLI FLAGS\n // these are defined in\n // https://github.com/facebook/jest/blob/4156f86/packages/jest-cli/src/args.ts\n b: 'bail',\n e: 'expand',\n f: 'onlyFailures',\n i: 'runInBand',\n o: 'onlyChanged',\n t: 'testNamePattern',\n u: 'updateSnapshot',\n w: 'maxWorkers',\n};\n\n/**\n * A regular expression which can be used to match a CLI flag for one of our\n * short aliases.\n */\nexport const CLI_FLAG_REGEX = new RegExp(`^-[chpvbewofitu]{1}$`);\n\n/**\n * Given two types `K` and `T` where `K` extends `ReadonlyArray`,\n * construct a type which maps the strings in `K` as keys to values of type `T`.\n *\n * Because we use types derived this way to construct an interface (`ConfigFlags`)\n * for which we want optional keys, we make all the properties optional (w/ `'?'`)\n * and possibly null.\n */\ntype ObjectFromKeys, T> = {\n [key in K[number]]?: T | null;\n};\n\n/**\n * Type containing the possible Boolean configuration flags, to be included\n * in ConfigFlags, below\n */\ntype BooleanConfigFlags = ObjectFromKeys;\n\n/**\n * Type containing the possible String configuration flags, to be included\n * in ConfigFlags, below\n */\ntype StringConfigFlags = ObjectFromKeys;\n\n/**\n * Type containing the possible String Array configuration flags. This is\n * one of the 'constituent types' for `ConfigFlags`.\n */\ntype StringArrayConfigFlags = ObjectFromKeys;\n\n/**\n * Type containing the possible numeric configuration flags, to be included\n * in ConfigFlags, below\n */\ntype NumberConfigFlags = ObjectFromKeys;\n\n/**\n * Type containing the configuration flags which may be set to either string\n * or number values.\n */\ntype StringNumberConfigFlags = ObjectFromKeys;\n\n/**\n * Type containing the configuration flags which may be set to either string\n * or boolean values.\n */\ntype BooleanStringConfigFlags = ObjectFromKeys;\n\n/**\n * Type containing the possible LogLevel configuration flags, to be included\n * in ConfigFlags, below\n */\ntype LogLevelFlags = ObjectFromKeys;\n\n/**\n * The configuration flags which can be set by the user on the command line.\n * This interface captures both known arguments (which are enumerated and then\n * parsed according to their types) and unknown arguments which the user may\n * pass at the CLI.\n *\n * Note that this interface is constructed by extending `BooleanConfigFlags`,\n * `StringConfigFlags`, etc. These types are in turn constructed from types\n * extending `ReadonlyArray` which we declare in another module. This\n * allows us to record our known CLI arguments in one place, using a\n * `ReadonlyArray` to get both a type-level representation of what CLI\n * options we support and a runtime list of strings which can be used to match\n * on actual flags passed by the user.\n */\nexport interface ConfigFlags\n extends BooleanConfigFlags,\n StringConfigFlags,\n StringArrayConfigFlags,\n NumberConfigFlags,\n StringNumberConfigFlags,\n BooleanStringConfigFlags,\n LogLevelFlags {\n task: TaskCommand | null;\n args: string[];\n knownArgs: string[];\n unknownArgs: string[];\n}\n\n/**\n * Helper function for initializing a `ConfigFlags` object. Provide any overrides\n * for default values and off you go!\n *\n * @param init an object with any overrides for default values\n * @returns a complete CLI flag object\n */\nexport const createConfigFlags = (init: Partial = {}): ConfigFlags => {\n const flags: ConfigFlags = {\n task: null,\n args: [],\n knownArgs: [],\n unknownArgs: [],\n ...init,\n };\n\n return flags;\n};\n"
},
{
"path": "src/cli/find-config.ts",
"content": "import { buildError, isString, normalizePath, result } from '@utils';\n\nimport type { CompilerSystem, Diagnostic } from '../declarations';\n\n/**\n * An object containing the {@link CompilerSystem} used to find the configuration file, as well as the location on disk\n * to search for a Stencil configuration\n */\nexport type FindConfigOptions = {\n sys: CompilerSystem;\n configPath?: string | null;\n};\n\n/**\n * The results of attempting to find a Stencil configuration file on disk\n */\nexport type FindConfigResults = {\n configPath: string;\n rootDir: string;\n};\n\n/**\n * Attempt to find a Stencil configuration file on the file system\n * @param opts the options needed to find the configuration file\n * @returns the results of attempting to find a configuration file on disk\n */\nexport const findConfig = async (opts: FindConfigOptions): Promise> => {\n const sys = opts.sys;\n const cwd = sys.getCurrentDirectory();\n const rootDir = normalizePath(cwd);\n\n let configPath = opts.configPath;\n\n if (isString(configPath)) {\n if (!sys.platformPath.isAbsolute(configPath)) {\n // passed in a custom stencil config location,\n // but it's relative, so prefix the cwd\n configPath = normalizePath(sys.platformPath.join(cwd, configPath));\n } else {\n // config path already an absolute path, we're good here\n configPath = normalizePath(configPath);\n }\n } else {\n // nothing was passed in, use the current working directory\n configPath = rootDir;\n }\n\n const results: FindConfigResults = {\n configPath,\n rootDir: normalizePath(cwd),\n };\n\n const stat = await sys.stat(configPath);\n if (stat.error) {\n const diagnostics: Diagnostic[] = [];\n const diagnostic = buildError(diagnostics);\n diagnostic.absFilePath = configPath;\n diagnostic.header = `Invalid config path`;\n diagnostic.messageText = `Config path \"${configPath}\" not found`;\n return result.err(diagnostics);\n }\n\n if (stat.isFile) {\n results.configPath = configPath;\n results.rootDir = sys.platformPath.dirname(configPath);\n } else if (stat.isDirectory) {\n // this is only a directory, so let's make some assumptions\n for (const configName of ['stencil.config.ts', 'stencil.config.js']) {\n const testConfigFilePath = sys.platformPath.join(configPath, configName);\n const stat = await sys.stat(testConfigFilePath);\n if (stat.isFile) {\n results.configPath = testConfigFilePath;\n results.rootDir = sys.platformPath.dirname(testConfigFilePath);\n break;\n }\n }\n }\n\n return result.ok(results);\n};\n"
},
{
"path": "src/cli/index.ts",
"content": "export { BOOLEAN_CLI_FLAGS, ConfigFlags } from './config-flags';\nexport { parseFlags } from './parse-flags';\nexport { run, runTask } from './run';\n"
},
{
"path": "src/cli/ionic-config.ts",
"content": "import type * as d from '../declarations';\nimport { readJson, UUID_REGEX, uuidv4 } from './telemetry/helpers';\n\nexport const isTest = () => process.env.JEST_WORKER_ID !== undefined;\n\nexport const defaultConfig = (sys: d.CompilerSystem) =>\n sys.resolvePath(`${sys.homeDir()}/.ionic/${isTest() ? 'tmp-config.json' : 'config.json'}`);\n\nexport const defaultConfigDirectory = (sys: d.CompilerSystem) => sys.resolvePath(`${sys.homeDir()}/.ionic`);\n\n/**\n * Reads an Ionic configuration file from disk, parses it, and performs any necessary corrections to it if certain\n * values are deemed to be malformed\n * @param sys The system where the command is invoked\n * @returns the config read from disk that has been potentially been updated\n */\nexport async function readConfig(sys: d.CompilerSystem): Promise {\n let config: d.TelemetryConfig = await readJson(sys, defaultConfig(sys));\n\n if (!config) {\n config = {\n 'tokens.telemetry': uuidv4(),\n 'telemetry.stencil': true,\n };\n\n await writeConfig(sys, config);\n } else if (!config['tokens.telemetry'] || !UUID_REGEX.test(config['tokens.telemetry'])) {\n const newUuid = uuidv4();\n await writeConfig(sys, { ...config, 'tokens.telemetry': newUuid });\n config['tokens.telemetry'] = newUuid;\n }\n\n return config;\n}\n\n/**\n * Writes an Ionic configuration file to disk.\n * @param sys The system where the command is invoked\n * @param config The config passed into the Stencil command\n * @returns boolean If the command was successful\n */\nexport async function writeConfig(sys: d.CompilerSystem, config: d.TelemetryConfig): Promise {\n let result = false;\n try {\n await sys.createDir(defaultConfigDirectory(sys), { recursive: true });\n await sys.writeFile(defaultConfig(sys), JSON.stringify(config, null, 2));\n result = true;\n } catch (error) {\n console.error(`Stencil Telemetry: couldn't write configuration file to ${defaultConfig(sys)} - ${error}.`);\n }\n\n return result;\n}\n\n/**\n * Update a subset of the Ionic config.\n * @param sys The system where the command is invoked\n * @param newOptions The new options to save\n * @returns boolean If the command was successful\n */\nexport async function updateConfig(sys: d.CompilerSystem, newOptions: d.TelemetryConfig): Promise {\n const config = await readConfig(sys);\n return await writeConfig(sys, Object.assign(config, newOptions));\n}\n"
},
{
"path": "src/cli/load-compiler.ts",
"content": "import type { CompilerSystem } from '../declarations';\n\nexport const loadCoreCompiler = async (sys: CompilerSystem): Promise => {\n return await sys.dynamicImport!(sys.getCompilerExecutingPath());\n};\n\nexport type CoreCompiler = typeof import('@stencil/core/compiler');\n"
},
{
"path": "src/cli/logs.ts",
"content": "import type { CompilerSystem, Logger, TaskCommand, ValidatedConfig } from '../declarations';\nimport type { ConfigFlags } from './config-flags';\nimport type { CoreCompiler } from './load-compiler';\n\n/**\n * Log the name of this package (`@stencil/core`) to an output stream\n *\n * The output stream is determined by the {@link Logger} instance that is provided as an argument to this function\n *\n * The name of the package may not be logged, by design, for certain `task` types and logging levels\n *\n * @param logger the logging entity to use to output the name of the package\n * @param task the current task\n */\nexport const startupLog = (logger: Logger, task: TaskCommand): void => {\n if (task === 'info' || task === 'serve' || task === 'version') {\n return;\n }\n\n logger.info(logger.cyan(`@stencil/core`));\n};\n\n/**\n * Log this package's version to an output stream\n *\n * The output stream is determined by the {@link Logger} instance that is provided as an argument to this function\n *\n * The package version may not be logged, by design, for certain `task` types and logging levels\n *\n * @param logger the logging entity to use for output\n * @param task the current task\n * @param coreCompiler the compiler instance to derive version information from\n */\nexport const startupLogVersion = (logger: Logger, task: TaskCommand, coreCompiler: CoreCompiler): void => {\n if (task === 'info' || task === 'serve' || task === 'version') {\n return;\n }\n const isDevBuild = coreCompiler.version.includes('-dev.');\n\n let startupMsg: string;\n\n if (isDevBuild) {\n startupMsg = logger.yellow(`[LOCAL DEV] v${coreCompiler.version}`);\n } else {\n startupMsg = logger.cyan(`v${coreCompiler.version}`);\n }\n startupMsg += logger.emoji(' ' + coreCompiler.vermoji);\n\n logger.info(startupMsg);\n};\n\n/**\n * Log details from a {@link CompilerSystem} used by Stencil to an output stream\n *\n * The output stream is determined by the {@link Logger} instance that is provided as an argument to this function\n *\n * @param sys the `CompilerSystem` to report details on\n * @param logger the logging entity to use for output\n * @param flags user set flags for the current invocation of Stencil\n * @param coreCompiler the compiler instance being used for this invocation of Stencil\n */\nexport const loadedCompilerLog = (\n sys: CompilerSystem,\n logger: Logger,\n flags: ConfigFlags,\n coreCompiler: CoreCompiler,\n): void => {\n const sysDetails = sys.details;\n const runtimeInfo = `${sys.name} ${sys.version}`;\n\n const platformInfo = sysDetails\n ? `${sysDetails.platform}, ${sysDetails.cpuModel}`\n : `Unknown Platform, Unknown CPU Model`;\n const statsInfo = sysDetails\n ? `cpus: ${sys.hardwareConcurrency}, freemem: ${Math.round(\n sysDetails.freemem() / 1000000,\n )}MB, totalmem: ${Math.round(sysDetails.totalmem / 1000000)}MB`\n : 'Unknown CPU Core Count, Unknown Memory';\n\n if (logger.getLevel() === 'debug') {\n logger.debug(runtimeInfo);\n logger.debug(platformInfo);\n logger.debug(statsInfo);\n logger.debug(`compiler: ${sys.getCompilerExecutingPath()}`);\n logger.debug(`build: ${coreCompiler.buildId}`);\n } else if (flags.ci) {\n logger.info(runtimeInfo);\n logger.info(platformInfo);\n logger.info(statsInfo);\n }\n};\n\n/**\n * Log various warnings to an output stream\n *\n * The output stream is determined by the {@link Logger} instance attached to the `config` argument to this function\n *\n * @param coreCompiler the compiler instance being used for this invocation of Stencil\n * @param config a validated configuration object to be used for this run of Stencil\n */\nexport const startupCompilerLog = (coreCompiler: CoreCompiler, config: ValidatedConfig) => {\n if (config.suppressLogs === true) {\n return;\n }\n\n const { logger } = config;\n const isDebug = logger.getLevel() === 'debug';\n const isPrerelease = coreCompiler.version.includes('-');\n const isDevBuild = coreCompiler.version.includes('-dev.');\n\n if (isPrerelease && !isDevBuild) {\n logger.warn(\n logger.yellow(\n `This is a prerelease build, undocumented changes might happen at any time. Technical support is not available for prereleases, but any assistance testing is appreciated.`,\n ),\n );\n }\n\n if (config.devMode && !isDebug) {\n if (config.buildEs5) {\n logger.warn(\n `Generating ES5 during development is a very task expensive, initial and incremental builds will be much slower. Drop the '--es5' flag and use a modern browser for development.`,\n );\n }\n\n if (!config.enableCache) {\n logger.warn(`Disabling cache during development will slow down incremental builds.`);\n }\n }\n};\n"
},
{
"path": "src/cli/parse-flags.ts",
"content": "import { readOnlyArrayHasStringMember, toCamelCase } from '@utils';\n\nimport { LOG_LEVELS, LogLevel, TaskCommand } from '../declarations';\nimport {\n BOOLEAN_CLI_FLAGS,\n BOOLEAN_STRING_CLI_FLAGS,\n CLI_FLAG_ALIASES,\n CLI_FLAG_REGEX,\n ConfigFlags,\n createConfigFlags,\n LOG_LEVEL_CLI_FLAGS,\n NUMBER_CLI_FLAGS,\n STRING_ARRAY_CLI_FLAGS,\n STRING_CLI_FLAGS,\n STRING_NUMBER_CLI_FLAGS,\n} from './config-flags';\n\n/**\n * Parse command line arguments into a structured `ConfigFlags` object\n *\n * @param args an array of CLI flags\n * @returns a structured ConfigFlags object\n */\nexport const parseFlags = (args: string[]): ConfigFlags => {\n const flags: ConfigFlags = createConfigFlags();\n\n // cmd line has more priority over npm scripts cmd\n flags.args = Array.isArray(args) ? args.slice() : [];\n if (flags.args.length > 0 && flags.args[0] && !flags.args[0].startsWith('-')) {\n flags.task = flags.args[0] as TaskCommand;\n // if the first argument was a \"task\" (like `build`, `test`, etc) then\n // we go on to parse the _rest_ of the CLI args\n parseArgs(flags, args.slice(1));\n } else {\n // we didn't find a leading flag, so we should just parse them all\n parseArgs(flags, flags.args);\n }\n\n if (flags.task != null) {\n const i = flags.args.indexOf(flags.task);\n if (i > -1) {\n flags.args.splice(i, 1);\n }\n }\n\n return flags;\n};\n\n/**\n * Parse the supported command line flags which are enumerated in the\n * `config-flags` module. Handles leading dashes on arguments, aliases that are\n * defined for a small number of arguments, and parsing values for non-boolean\n * arguments (e.g. port number for the dev server).\n *\n * This parses the following grammar:\n *\n * CLIArguments → \"\"\n * | CLITerm ( \" \" CLITerm )* ;\n * CLITerm → EqualsArg\n * | AliasEqualsArg\n * | AliasArg\n * | NegativeDashArg\n * | NegativeArg\n * | SimpleArg ;\n * EqualsArg → \"--\" ArgName \"=\" CLIValue ;\n * AliasEqualsArg → \"-\" AliasName \"=\" CLIValue ;\n * AliasArg → \"-\" AliasName ( \" \" CLIValue )? ;\n * NegativeDashArg → \"--no-\" ArgName ;\n * NegativeArg → \"--no\" ArgName ;\n * SimpleArg → \"--\" ArgName ( \" \" CLIValue )? ;\n * ArgName → /^[a-zA-Z-]+$/ ;\n * AliasName → /^[a-z]{1}$/ ;\n * CLIValue → '\"' /^[a-zA-Z0-9]+$/ '\"'\n * | /^[a-zA-Z0-9]+$/ ;\n *\n * There are additional constraints (not shown in the grammar for brevity's sake)\n * on the type of `CLIValue` which will be associated with a particular argument.\n * We enforce this by declaring lists of boolean, string, etc arguments and\n * checking the types of values before setting them.\n *\n * We don't need to turn the list of CLI arg tokens into any kind of\n * intermediate representation since we aren't concerned with doing anything\n * other than setting the correct values on our ConfigFlags object. So we just\n * parse the array of string arguments using a recursive-descent approach\n * (which is not very deep since our grammar is pretty simple) and make the\n * modifications we need to make to the {@link ConfigFlags} object as we go.\n *\n * @param flags a ConfigFlags object to which parsed arguments will be added\n * @param args an array of command-line arguments to parse\n */\nconst parseArgs = (flags: ConfigFlags, args: string[]) => {\n const argsCopy = args.concat();\n while (argsCopy.length > 0) {\n // there are still unprocessed args to deal with\n parseCLITerm(flags, argsCopy);\n }\n};\n\n/**\n * Given an array of CLI arguments, parse it and perform a series of side\n * effects (setting values on the provided `ConfigFlags` object).\n *\n * @param flags a {@link ConfigFlags} object which is updated as we parse the CLI\n * arguments\n * @param args a list of args to work through. This function (and some functions\n * it calls) calls `Array.prototype.shift` to get the next argument to look at,\n * so this parameter will be modified.\n */\nconst parseCLITerm = (flags: ConfigFlags, args: string[]) => {\n // pull off the first arg from the argument array\n const arg = args.shift();\n\n // array is empty, we're done!\n if (arg === undefined) return;\n\n // capture whether this is a special case of a negated boolean or boolean-string before we start to test each case\n const isNegatedBoolean =\n !readOnlyArrayHasStringMember(BOOLEAN_CLI_FLAGS, normalizeFlagName(arg)) &&\n readOnlyArrayHasStringMember(BOOLEAN_CLI_FLAGS, normalizeNegativeFlagName(arg));\n const isNegatedBooleanOrString =\n !readOnlyArrayHasStringMember(BOOLEAN_STRING_CLI_FLAGS, normalizeFlagName(arg)) &&\n readOnlyArrayHasStringMember(BOOLEAN_STRING_CLI_FLAGS, normalizeNegativeFlagName(arg));\n\n // EqualsArg → \"--\" ArgName \"=\" CLIValue ;\n if (arg.startsWith('--') && arg.includes('=')) {\n // we're dealing with an EqualsArg, we have a special helper for that\n const [originalArg, value] = parseEqualsArg(arg);\n setCLIArg(flags, arg.split('=')[0], normalizeFlagName(originalArg), value);\n }\n\n // AliasEqualsArg → \"-\" AliasName \"=\" CLIValue ;\n else if (arg.startsWith('-') && arg.includes('=')) {\n // we're dealing with an AliasEqualsArg, we have a special helper for that\n const [originalArg, value] = parseEqualsArg(arg);\n setCLIArg(flags, desugarRawAlias(originalArg), normalizeFlagName(originalArg), value);\n }\n\n // AliasArg → \"-\" AliasName ( \" \" CLIValue )? ;\n else if (CLI_FLAG_REGEX.test(arg)) {\n // this is a short alias, like `-c` for Config\n setCLIArg(flags, desugarRawAlias(arg), normalizeFlagName(arg), parseCLIValue(args));\n }\n\n // NegativeDashArg → \"--no-\" ArgName ;\n else if (arg.startsWith('--no-') && arg.length > '--no-'.length) {\n // this is a `NegativeDashArg` term, so we need to normalize the negative\n // flag name and then set an appropriate value\n const normalized = normalizeNegativeFlagName(arg);\n setCLIArg(flags, arg, normalized, '');\n }\n\n // NegativeArg → \"--no\" ArgName ;\n else if (arg.startsWith('--no') && (isNegatedBoolean || isNegatedBooleanOrString)) {\n // possibly dealing with a `NegativeArg` here. There is a little ambiguity\n // here because we have arguments that already begin with `no` like\n // `notify`, so we need to test if a normalized form of the raw argument is\n // a valid and supported boolean flag.\n setCLIArg(flags, arg, normalizeNegativeFlagName(arg), '');\n }\n\n // SimpleArg → \"--\" ArgName ( \" \" CLIValue )? ;\n else if (arg.startsWith('--') && arg.length > '--'.length) {\n setCLIArg(flags, arg, normalizeFlagName(arg), parseCLIValue(args));\n } else {\n // if we get here then `arg` is not an argument in our list of supported\n // arguments. This doesn't necessarily mean we want to report an error or\n // anything though! Instead, with unknown / unrecognized arguments we want\n // to stick them into the `unknownArgs` array, which is used when we pass\n // CLI args to Jest, for instance.\n flags.unknownArgs.push(arg);\n }\n};\n\n/**\n * Normalize a 'negative' flag name, just to do a little pre-processing before\n * we pass it to {@link setCLIArg}.\n *\n * @param flagName the flag name to normalize\n * @returns a normalized flag name\n */\nconst normalizeNegativeFlagName = (flagName: string): string => {\n const trimmed = flagName.replace(/^--no[-]?/, '');\n return normalizeFlagName(trimmed.charAt(0).toLowerCase() + trimmed.slice(1));\n};\n\n/**\n * Normalize a flag name by:\n *\n * - replacing any leading dashes (`--foo` -> `foo`)\n * - converting `dash-case` to camelCase (if necessary)\n *\n * Normalizing in this context basically means converting the various\n * supported flag spelling variants to the variant defined in our lists of\n * supported arguments (e.g. BOOLEAN_CLI_FLAGS, etc). So, for instance,\n * `--log-level` should be converted to `logLevel`.\n *\n * @param flagName the flag name to normalize\n * @returns a normalized flag name\n *\n */\nconst normalizeFlagName = (flagName: string): string => {\n const trimmed = flagName.replace(/^-+/, '');\n return trimmed.includes('-') ? toCamelCase(trimmed) : trimmed;\n};\n\n/**\n * Set a value on a provided {@link ConfigFlags} object, given an argument\n * name and a raw string value. This function dispatches to other functions\n * which make sure that the string value can be properly parsed into a JS\n * runtime value of the right type (e.g. number, string, etc).\n *\n * @throws if a value cannot be parsed to the right type for a given flag\n * @param flags a {@link ConfigFlags} object\n * @param rawArg the raw argument name matched by the parser\n * @param normalizedArg an argument with leading control characters (`--`,\n * `--no-`, etc) removed\n * @param value the raw value to be set onto the config flags object\n */\nconst setCLIArg = (flags: ConfigFlags, rawArg: string, normalizedArg: string, value: CLIValueResult) => {\n normalizedArg = desugarAlias(normalizedArg);\n\n // We're setting a boolean!\n if (readOnlyArrayHasStringMember(BOOLEAN_CLI_FLAGS, normalizedArg)) {\n const parsed =\n typeof value === 'string'\n ? // check if the value is `'true'`\n value === 'true'\n : // no value was supplied, default to true\n true;\n\n flags[normalizedArg] = parsed;\n flags.knownArgs.push(rawArg);\n\n if (typeof value === 'string' && value !== '') {\n flags.knownArgs.push(value);\n }\n }\n\n // We're setting a string!\n else if (readOnlyArrayHasStringMember(STRING_CLI_FLAGS, normalizedArg)) {\n if (typeof value === 'string') {\n flags[normalizedArg] = value;\n flags.knownArgs.push(rawArg);\n flags.knownArgs.push(value);\n } else {\n throwCLIParsingError(rawArg, 'expected a string argument but received nothing');\n }\n }\n\n // We're setting a string, but it's one where the user can pass multiple values,\n // like `--reporters=\"default\" --reporters=\"jest-junit\"`\n else if (readOnlyArrayHasStringMember(STRING_ARRAY_CLI_FLAGS, normalizedArg)) {\n if (typeof value === 'string') {\n if (!Array.isArray(flags[normalizedArg])) {\n flags[normalizedArg] = [];\n }\n\n const targetArray = flags[normalizedArg];\n // this is irritating, but TS doesn't know that the `!Array.isArray`\n // check above guarantees we have an array to work with here, and it\n // doesn't want to narrow the type of `flags[normalizedArg]`, so we need\n // to grab a reference to that array and then `Array.isArray` that. Bah!\n if (Array.isArray(targetArray)) {\n targetArray.push(value);\n flags.knownArgs.push(rawArg);\n flags.knownArgs.push(value);\n }\n } else {\n throwCLIParsingError(rawArg, 'expected a string argument but received nothing');\n }\n }\n\n // We're setting a number!\n else if (readOnlyArrayHasStringMember(NUMBER_CLI_FLAGS, normalizedArg)) {\n if (typeof value === 'string') {\n const parsed = parseInt(value, 10);\n\n if (isNaN(parsed)) {\n throwNumberParsingError(rawArg, value);\n } else {\n flags[normalizedArg] = parsed;\n flags.knownArgs.push(rawArg);\n flags.knownArgs.push(value);\n }\n } else {\n throwCLIParsingError(rawArg, 'expected a number argument but received nothing');\n }\n }\n\n // We're setting a value which could be either a string _or_ a number\n else if (readOnlyArrayHasStringMember(STRING_NUMBER_CLI_FLAGS, normalizedArg)) {\n if (typeof value === 'string') {\n if (CLI_ARG_STRING_REGEX.test(value)) {\n // if it matches the regex we treat it like a string\n flags[normalizedArg] = value;\n } else {\n const parsed = Number(value);\n\n if (isNaN(parsed)) {\n // parsing didn't go so well, we gotta get out of here\n // this is unlikely given our regex guard above\n // but hey, this is ultimately JS so let's be safe\n throwNumberParsingError(rawArg, value);\n } else {\n flags[normalizedArg] = parsed;\n }\n }\n flags.knownArgs.push(rawArg);\n flags.knownArgs.push(value);\n } else {\n throwCLIParsingError(rawArg, 'expected a string or a number but received nothing');\n }\n }\n\n // We're setting a value which could be either a boolean _or_ a string\n else if (readOnlyArrayHasStringMember(BOOLEAN_STRING_CLI_FLAGS, normalizedArg)) {\n const derivedValue =\n typeof value === 'string'\n ? value\n ? value // use the supplied value if it's a non-empty string\n : false // otherwise, default to false for the empty string\n : true; // no value was supplied, default to true\n flags[normalizedArg] = derivedValue;\n flags.knownArgs.push(rawArg);\n if (typeof derivedValue === 'string' && derivedValue) {\n flags.knownArgs.push(derivedValue);\n }\n }\n\n // We're setting the log level, which can only be a set of specific string values\n else if (readOnlyArrayHasStringMember(LOG_LEVEL_CLI_FLAGS, normalizedArg)) {\n if (typeof value === 'string') {\n if (isLogLevel(value)) {\n flags[normalizedArg] = value;\n flags.knownArgs.push(rawArg);\n flags.knownArgs.push(value);\n } else {\n throwCLIParsingError(rawArg, `expected to receive a valid log level but received \"${String(value)}\"`);\n }\n } else {\n throwCLIParsingError(rawArg, 'expected to receive a valid log level but received nothing');\n }\n } else {\n // we haven't found this flag in any of our lists of arguments, so we\n // should put it in our list of unknown arguments\n flags.unknownArgs.push(rawArg);\n\n if (typeof value === 'string') {\n flags.unknownArgs.push(value);\n }\n }\n};\n\n/**\n * We use this regular expression to detect CLI parameters which\n * should be parsed as string values (as opposed to numbers) for\n * the argument types for which we support both a string and a\n * number value.\n *\n * The regex tests for the presence of at least one character which is\n * _not_ a digit (`\\d`), a period (`\\.`), or one of the characters `\"e\"`,\n * `\"E\"`, `\"+\"`, or `\"-\"` (the latter four characters are necessary to\n * support the admittedly unlikely use of scientific notation, like `\"4e+0\"`\n * for `4`).\n *\n * Thus we'll match a string like `\"50%\"`, but not a string like `\"50\"` or\n * `\"5.0\"`. If it matches a given string we conclude that the string should\n * be parsed as a string literal, rather than using `Number` to convert it\n * to a number.\n */\nconst CLI_ARG_STRING_REGEX = /[^\\d\\.Ee\\+\\-]+/g;\n\nexport const Empty = Symbol('Empty');\n\n/**\n * The result of trying to parse a CLI arg. This will be a `string` if a\n * well-formed value is present, or `Empty` to indicate that nothing was matched\n * or that the input was malformed.\n */\ntype CLIValueResult = string | typeof Empty;\n\n/**\n * A little helper which tries to parse a CLI value (as opposed to a flag) off\n * of the argument array.\n *\n * We support a variety of different argument formats for flags (as opposed to\n * values), but all of them start with `-`, so we can check the first character\n * to test whether the next token in our array of CLI arguments is a flag name\n * or a value.\n *\n * @param args an array of CLI args\n * @returns either a string result or an Empty sentinel\n */\nconst parseCLIValue = (args: string[]): CLIValueResult => {\n // it's possible the arguments array is empty, if so, return empty\n if (args[0] === undefined) {\n return Empty;\n }\n\n // all we're concerned with here is that it does not start with `\"-\"`,\n // which would indicate it should be parsed as a CLI flag and not a value.\n if (!args[0].startsWith('-')) {\n // It's not a flag, so we return the value and defer any specific parsing\n // until later on.\n const value = args.shift();\n if (typeof value === 'string') {\n return value;\n }\n }\n return Empty;\n};\n\n/**\n * Parse an 'equals' argument, which is a CLI argument-value pair in the\n * format `--foobar=12` (as opposed to a space-separated format like\n * `--foobar 12`).\n *\n * To parse this we split on the `=`, returning the first part as the argument\n * name and the second part as the value. We join the value on `\"=\"` in case\n * there is another `\"=\"` in the argument.\n *\n * This function is safe to call with any arg, and can therefore be used as\n * an argument 'normalizer'. If CLI argument is not an 'equals' argument then\n * the return value will be a tuple of the original argument and an empty\n * string `\"\"` for the value.\n *\n * In code terms, if you do:\n *\n * ```ts\n * const [arg, value] = parseEqualsArg(\"--myArgument\")\n * ```\n *\n * Then `arg` will be `\"--myArgument\"` and `value` will be `\"\"`, whereas if\n * you do:\n *\n *\n * ```ts\n * const [arg, value] = parseEqualsArg(\"--myArgument=myValue\")\n * ```\n *\n * Then `arg` will be `\"--myArgument\"` and `value` will be `\"myValue\"`.\n *\n * @param arg the arg in question\n * @returns a tuple containing the arg name and the value (if present)\n */\nexport const parseEqualsArg = (arg: string): [string, CLIValueResult] => {\n const [originalArg, ...splitSections] = arg.split('=');\n const value = splitSections.join('=');\n\n return [originalArg, value === '' ? Empty : value];\n};\n\n/**\n * Small helper for getting type-system-level assurance that a `string` can be\n * narrowed to a `LogLevel`\n *\n * @param maybeLogLevel the string to check\n * @returns whether this is a `LogLevel`\n */\nconst isLogLevel = (maybeLogLevel: string): maybeLogLevel is LogLevel =>\n readOnlyArrayHasStringMember(LOG_LEVELS, maybeLogLevel);\n\n/**\n * A little helper for constructing and throwing an error message with info\n * about what went wrong\n *\n * @param flag the flag which encountered the error\n * @param message a message specific to the error which was encountered\n */\nconst throwCLIParsingError = (flag: string, message: string) => {\n throw new Error(`when parsing CLI flag \"${flag}\": ${message}`);\n};\n\n/**\n * Throw a specific error for the situation where we ran into an issue parsing\n * a number.\n *\n * @param flag the flag for which we encountered the issue\n * @param value what we were trying to parse\n */\nconst throwNumberParsingError = (flag: string, value: string) => {\n throwCLIParsingError(flag, `expected a number but received \"${value}\"`);\n};\n\n/**\n * A little helper to 'desugar' a flag alias, meaning expand it to its full\n * name. For instance, the alias `\"c\"` will desugar to `\"config\"`.\n *\n * If no expansion is found for the possible alias we just return the passed\n * string unmodified.\n *\n * @param maybeAlias a string which _could_ be an alias to a full flag name\n * @returns the full aliased flag name, if found, or the passed string if not\n */\nconst desugarAlias = (maybeAlias: string): string => {\n const possiblyDesugared = CLI_FLAG_ALIASES[maybeAlias];\n\n if (typeof possiblyDesugared === 'string') {\n return possiblyDesugared;\n }\n return maybeAlias;\n};\n\n/**\n * Desugar a 'raw' alias (with a leading dash) and return an equivalent,\n * desugared argument.\n *\n * For instance, passing `\"-c` will return `\"--config\"`.\n *\n * The reason we'd like to do this is not so much for our own code, but so that\n * we can transform an alias like `\"-u\"` to `\"--updateSnapshot\"` in order to\n * pass it along to Jest.\n *\n * @param rawAlias a CLI flag alias as found on the command line (like `\"-c\"`)\n * @returns an equivalent full command (like `\"--config\"`)\n */\nconst desugarRawAlias = (rawAlias: string): string => '--' + desugarAlias(normalizeFlagName(rawAlias));\n"
},
{
"path": "src/cli/public.ts",
"content": "import type { CliInitOptions, Config, Logger, TaskCommand } from '@stencil/core/internal';\n\nimport type { ConfigFlags } from './config-flags';\n\n/**\n * Runs the CLI with the given options. This is used by Stencil's default `bin/stencil` file,\n * but can be used externally too.\n * @param init a set of initialization options needed to run Stencil from its CLI\n * @returns an empty promise\n */\nexport declare function run(init: CliInitOptions): Promise;\n\n/**\n * Run individual CLI tasks.\n * @param coreCompiler The core Stencil compiler to be used. The `run()` method handles loading the core compiler, however, `runTask()` must be passed it.\n * @param config Assumes the config has already been validated and has the \"sys\" and \"logger\" properties.\n * @param task The task command to run, such as `build`.\n * @returns an empty promise\n */\nexport declare function runTask(coreCompiler: any, config: Config, task: TaskCommand): Promise;\n\nexport declare function parseFlags(args: string[]): ConfigFlags;\n\nexport { Config, ConfigFlags, Logger, TaskCommand };\n"
},
{
"path": "src/cli/run.ts",
"content": "import { hasError, isFunction, result, shouldIgnoreError } from '@utils';\n\nimport type * as d from '../declarations';\nimport { ValidatedConfig } from '../declarations';\nimport { createConfigFlags } from './config-flags';\nimport { findConfig } from './find-config';\nimport { CoreCompiler, loadCoreCompiler } from './load-compiler';\nimport { loadedCompilerLog, startupLog, startupLogVersion } from './logs';\nimport { parseFlags } from './parse-flags';\nimport { taskBuild } from './task-build';\nimport { taskDocs } from './task-docs';\nimport { taskGenerate } from './task-generate';\nimport { taskHelp } from './task-help';\nimport { taskInfo } from './task-info';\nimport { taskPrerender } from './task-prerender';\nimport { taskServe } from './task-serve';\nimport { taskTelemetry } from './task-telemetry';\nimport { taskTest } from './task-test';\nimport { telemetryAction } from './telemetry/telemetry';\n\n/**\n * Main entry point for the Stencil CLI\n *\n * Take care of parsing CLI arguments, initializing various components needed\n * by the rest of the program, and kicking off the correct task (build, test,\n * etc).\n *\n * @param init initial CLI options\n * @returns an empty promise\n */\nexport const run = async (init: d.CliInitOptions) => {\n const { args, logger, sys } = init;\n\n try {\n const flags = parseFlags(args);\n const task = flags.task;\n\n if (flags.debug || flags.verbose) {\n logger.setLevel('debug');\n }\n\n if (flags.ci) {\n logger.enableColors(false);\n }\n\n if (isFunction(sys.applyGlobalPatch)) {\n sys.applyGlobalPatch(sys.getCurrentDirectory());\n }\n\n if ((task && task === 'version') || flags.version) {\n // we need to load the compiler here to get the version, but we don't\n // want to load it in the case that we're going to just log the help\n // message and then exit below (if there's no `task` defined) so we load\n // it just within our `if` scope here.\n const coreCompiler = await loadCoreCompiler(sys);\n console.log(coreCompiler.version);\n return;\n }\n\n if (!task || task === 'help' || flags.help) {\n await taskHelp(createConfigFlags({ task: 'help', args }), logger, sys);\n\n return;\n }\n\n startupLog(logger, task);\n\n const findConfigResults = await findConfig({ sys, configPath: flags.config });\n if (findConfigResults.isErr) {\n logger.printDiagnostics(findConfigResults.value);\n return sys.exit(1);\n }\n\n const coreCompiler = await loadCoreCompiler(sys);\n\n startupLogVersion(logger, task, coreCompiler);\n\n loadedCompilerLog(sys, logger, flags, coreCompiler);\n\n if (task === 'info') {\n taskInfo(coreCompiler, sys, logger);\n return;\n }\n\n const foundConfig = result.unwrap(findConfigResults);\n const validated = await coreCompiler.loadConfig({\n config: {\n flags,\n },\n configPath: foundConfig.configPath,\n logger,\n sys,\n });\n\n if (validated.diagnostics.length > 0) {\n logger.printDiagnostics(validated.diagnostics);\n if (hasError(validated.diagnostics)) {\n return sys.exit(1);\n }\n }\n\n if (isFunction(sys.applyGlobalPatch)) {\n sys.applyGlobalPatch(validated.config.rootDir);\n }\n\n await telemetryAction(sys, validated.config, coreCompiler, async () => {\n await runTask(coreCompiler, validated.config, task, sys);\n });\n } catch (e) {\n if (!shouldIgnoreError(e)) {\n const details = `${logger.getLevel() === 'debug' && e instanceof Error ? e.stack : ''}`;\n logger.error(`uncaught cli error: ${e}${details}`);\n return sys.exit(1);\n }\n }\n};\n\n/**\n * Run a specified task\n *\n * @param coreCompiler an instance of a minimal, bootstrap compiler for running the specified task\n * @param config a configuration for the Stencil project to apply to the task run\n * @param task the task to run\n * @param sys the {@link d.CompilerSystem} for interacting with the operating system\n * @public\n * @returns a void promise\n */\nexport const runTask = async (\n coreCompiler: CoreCompiler,\n config: d.Config,\n task: d.TaskCommand,\n sys: d.CompilerSystem,\n): Promise => {\n const flags = createConfigFlags(config.flags ?? { task });\n config.flags = flags;\n\n if (!config.sys) {\n config.sys = sys;\n }\n const strictConfig: ValidatedConfig = coreCompiler.validateConfig(config, {}).config;\n\n switch (task) {\n case 'build':\n await taskBuild(coreCompiler, strictConfig);\n break;\n\n case 'docs':\n await taskDocs(coreCompiler, strictConfig);\n break;\n\n case 'generate':\n case 'g':\n await taskGenerate(strictConfig);\n break;\n\n case 'help':\n await taskHelp(strictConfig.flags, strictConfig.logger, sys);\n break;\n\n case 'prerender':\n await taskPrerender(coreCompiler, strictConfig);\n break;\n\n case 'serve':\n await taskServe(strictConfig);\n break;\n\n case 'telemetry':\n await taskTelemetry(strictConfig.flags, sys, strictConfig.logger);\n break;\n\n case 'test':\n await taskTest(strictConfig);\n break;\n\n case 'version':\n console.log(coreCompiler.version);\n break;\n\n default:\n strictConfig.logger.error(\n `${strictConfig.logger.emoji('❌ ')}Invalid stencil command, please see the options below:`,\n );\n await taskHelp(strictConfig.flags, strictConfig.logger, sys);\n return config.sys.exit(1);\n }\n};\n"
},
{
"path": "src/cli/task-build.ts",
"content": "import type * as d from '../declarations';\nimport { printCheckVersionResults, startCheckVersion } from './check-version';\nimport type { CoreCompiler } from './load-compiler';\nimport { startupCompilerLog } from './logs';\nimport { runPrerenderTask } from './task-prerender';\nimport { taskWatch } from './task-watch';\nimport { telemetryBuildFinishedAction } from './telemetry/telemetry';\n\nexport const taskBuild = async (coreCompiler: CoreCompiler, config: d.ValidatedConfig) => {\n if (config.flags.watch) {\n // watch build\n await taskWatch(coreCompiler, config);\n return;\n }\n\n // one-time build\n let exitCode = 0;\n\n try {\n startupCompilerLog(coreCompiler, config);\n\n const versionChecker = startCheckVersion(config, coreCompiler.version);\n\n const compiler = await coreCompiler.createCompiler(config);\n const results = await compiler.build();\n\n await telemetryBuildFinishedAction(config.sys, config, coreCompiler, results);\n\n await compiler.destroy();\n\n if (results.hasError) {\n exitCode = 1;\n } else if (config.flags.prerender) {\n const prerenderDiagnostics = await runPrerenderTask(\n coreCompiler,\n config,\n results.hydrateAppFilePath,\n results.componentGraph,\n undefined,\n );\n config.logger.printDiagnostics(prerenderDiagnostics);\n\n if (prerenderDiagnostics.some((d) => d.level === 'error')) {\n exitCode = 1;\n }\n }\n\n await printCheckVersionResults(versionChecker);\n } catch (e) {\n exitCode = 1;\n config.logger.error(e);\n }\n\n if (exitCode > 0) {\n return config.sys.exit(exitCode);\n }\n};\n"
},
{
"path": "src/cli/task-docs.ts",
"content": "import { isOutputTargetDocs } from '@utils';\n\nimport type { ValidatedConfig } from '../declarations';\nimport type { CoreCompiler } from './load-compiler';\nimport { startupCompilerLog } from './logs';\n\nexport const taskDocs = async (coreCompiler: CoreCompiler, config: ValidatedConfig) => {\n config.devServer = {};\n config.outputTargets = config.outputTargets.filter(isOutputTargetDocs);\n config.devMode = true;\n\n startupCompilerLog(coreCompiler, config);\n\n const compiler = await coreCompiler.createCompiler(config);\n await compiler.build();\n\n await compiler.destroy();\n};\n"
},
{
"path": "src/cli/task-generate.ts",
"content": "import { normalizePath, validateComponentTag } from '@utils';\nimport { join, parse, relative } from 'path';\n\nimport type { ValidatedConfig } from '../declarations';\n\n/**\n * Task to generate component boilerplate and write it to disk. This task can\n * cause the program to exit with an error under various circumstances, such as\n * being called in an inappropriate place, being asked to overwrite files that\n * already exist, etc.\n *\n * @param config the user-supplied config, which we need here to access `.sys`.\n * @returns a void promise\n */\nexport const taskGenerate = async (config: ValidatedConfig): Promise => {\n if (!config.configPath) {\n config.logger.error('Please run this command in your root directory (i. e. the one containing stencil.config.ts).');\n return config.sys.exit(1);\n }\n\n const absoluteSrcDir = config.srcDir;\n\n if (!absoluteSrcDir) {\n config.logger.error(`Stencil's srcDir was not specified.`);\n return config.sys.exit(1);\n }\n\n const { prompt } = await import('prompts');\n\n const input =\n config.flags.unknownArgs.find((arg) => !arg.startsWith('-')) ||\n ((await prompt({ name: 'tagName', type: 'text', message: 'Component tag name (dash-case):' })).tagName as string);\n\n if (undefined === input) {\n // in some shells (e.g. Windows PowerShell), hitting Ctrl+C results in a TypeError printed to the console.\n // explicitly return here to avoid printing the error message.\n return;\n }\n const { dir, base: componentName } = parse(input);\n\n const tagError = validateComponentTag(componentName);\n if (tagError) {\n config.logger.error(tagError);\n return config.sys.exit(1);\n }\n\n let cssExtension: GeneratableStylingExtension = 'css';\n if (!!config.plugins.find((plugin) => plugin.name === 'sass')) {\n cssExtension = await chooseSassExtension();\n } else if (!!config.plugins.find((plugin) => plugin.name === 'less')) {\n cssExtension = 'less';\n }\n const filesToGenerateExt = await chooseFilesToGenerate(cssExtension);\n if (!filesToGenerateExt) {\n // in some shells (e.g. Windows PowerShell), hitting Ctrl+C results in a TypeError printed to the console.\n // explicitly return here to avoid printing the error message.\n return;\n }\n const extensionsToGenerate: GeneratableExtension[] = ['tsx', ...filesToGenerateExt];\n const testFolder = extensionsToGenerate.some(isTest) ? 'test' : '';\n\n const outDir = join(absoluteSrcDir, 'components', dir, componentName);\n await config.sys.createDir(normalizePath(join(outDir, testFolder)), { recursive: true });\n\n const filesToGenerate: readonly BoilerplateFile[] = extensionsToGenerate.map((extension) => ({\n extension,\n path: getFilepathForFile(outDir, componentName, extension),\n }));\n await checkForOverwrite(filesToGenerate, config);\n\n const writtenFiles = await Promise.all(\n filesToGenerate.map((file) =>\n getBoilerplateAndWriteFile(\n config,\n componentName,\n extensionsToGenerate.includes('css') ||\n extensionsToGenerate.includes('sass') ||\n extensionsToGenerate.includes('scss') ||\n extensionsToGenerate.includes('less'),\n file,\n cssExtension,\n ),\n ),\n ).catch((error) => config.logger.error(error));\n\n if (!writtenFiles) {\n return config.sys.exit(1);\n }\n\n // We use `console.log` here rather than our `config.logger` because we don't want\n // our TUI messages to be prefixed with timestamps and so on.\n //\n // See STENCIL-424 for details.\n console.log();\n console.log(`${config.logger.gray('$')} stencil generate ${input}`);\n console.log();\n console.log(config.logger.bold('The following files have been generated:'));\n\n const absoluteRootDir = config.rootDir;\n writtenFiles.map((file) => console.log(` - ${relative(absoluteRootDir, file)}`));\n};\n\n/**\n * Show a checkbox prompt to select the files to be generated.\n *\n * @param cssExtension the extension of the CSS file to be generated\n * @returns a read-only array of `GeneratableExtension`, the extensions that the user has decided\n * to generate\n */\nconst chooseFilesToGenerate = async (cssExtension: string): Promise> => {\n const { prompt } = await import('prompts');\n return (\n await prompt({\n name: 'filesToGenerate',\n type: 'multiselect',\n message: 'Which additional files do you want to generate?',\n choices: [\n { value: cssExtension, title: `Stylesheet (.${cssExtension})`, selected: true },\n { value: 'spec.tsx', title: 'Spec Test (.spec.tsx)', selected: true },\n { value: 'e2e.ts', title: 'E2E Test (.e2e.ts)', selected: true },\n ],\n })\n ).filesToGenerate;\n};\n\nconst chooseSassExtension = async () => {\n const { prompt } = await import('prompts');\n return (\n await prompt({\n name: 'sassFormat',\n type: 'select',\n message:\n 'Which Sass format would you like to use? (More info: https://sass-lang.com/documentation/syntax/#the-indented-syntax)',\n choices: [\n { value: 'sass', title: `*.sass Format`, selected: true },\n { value: 'scss', title: '*.scss Format' },\n ],\n })\n ).sassFormat;\n};\n\n/**\n * Get a filepath for a file we want to generate!\n *\n * The filepath for a given file depends on the path, the user-supplied\n * component name, the extension, and whether we're inside of a test directory.\n *\n * @param filePath path to where we're going to generate the component\n * @param componentName the user-supplied name for the generated component\n * @param extension the file extension\n * @returns the full filepath to the component (with a possible `test` directory\n * added)\n */\nconst getFilepathForFile = (filePath: string, componentName: string, extension: GeneratableExtension): string =>\n isTest(extension)\n ? normalizePath(join(filePath, 'test', `${componentName}.${extension}`))\n : normalizePath(join(filePath, `${componentName}.${extension}`));\n\n/**\n * Get the boilerplate for a file and write it to disk\n *\n * @param config the current config, needed for file operations\n * @param componentName the component name (user-supplied)\n * @param withCss are we generating CSS?\n * @param file the file we want to write\n * @param styleExtension extension used for styles\n * @returns a `Promise` which holds the full filepath we've written to,\n * used to print out a little summary of our activity to the user.\n */\nconst getBoilerplateAndWriteFile = async (\n config: ValidatedConfig,\n componentName: string,\n withCss: boolean,\n file: BoilerplateFile,\n styleExtension: GeneratableStylingExtension,\n): Promise => {\n const boilerplate = getBoilerplateByExtension(componentName, file.extension, withCss, styleExtension);\n await config.sys.writeFile(normalizePath(file.path), boilerplate);\n return file.path;\n};\n\n/**\n * Check to see if any of the files we plan to write already exist and would\n * therefore be overwritten if we proceed, because we'd like to not overwrite\n * people's code!\n *\n * This function will check all the filepaths and if it finds any files log an\n * error and exit with an error code. If it doesn't find anything it will just\n * peacefully return `Promise`.\n *\n * @param files the files we want to check\n * @param config the Config object, used here to get access to `sys.readFile`\n */\nconst checkForOverwrite = async (files: readonly BoilerplateFile[], config: ValidatedConfig): Promise => {\n const alreadyPresent: string[] = [];\n\n await Promise.all(\n files.map(async ({ path }) => {\n if ((await config.sys.readFile(path)) !== undefined) {\n alreadyPresent.push(path);\n }\n }),\n );\n\n if (alreadyPresent.length > 0) {\n config.logger.error(\n 'Generating code would overwrite the following files:',\n ...alreadyPresent.map((path) => '\\t' + normalizePath(path)),\n );\n await config.sys.exit(1);\n }\n};\n\n/**\n * Check if an extension is for a test\n *\n * @param extension the extension we want to check\n * @returns a boolean indicating whether or not its a test\n */\nconst isTest = (extension: GeneratableExtension): boolean => {\n return extension === 'e2e.ts' || extension === 'spec.tsx';\n};\n\n/**\n * Get the boilerplate for a file by its extension.\n *\n * @param tagName the name of the component we're generating\n * @param extension the file extension we want boilerplate for (.css, tsx, etc)\n * @param withCss a boolean indicating whether we're generating a CSS file\n * @param styleExtension extension used for styles\n * @returns a string container the file boilerplate for the supplied extension\n */\nexport const getBoilerplateByExtension = (\n tagName: string,\n extension: GeneratableExtension,\n withCss: boolean,\n styleExtension: GeneratableStylingExtension,\n): string => {\n switch (extension) {\n case 'tsx':\n return getComponentBoilerplate(tagName, withCss, styleExtension);\n\n case 'css':\n case 'less':\n case 'sass':\n case 'scss':\n return getStyleUrlBoilerplate(styleExtension);\n\n case 'spec.tsx':\n return getSpecTestBoilerplate(tagName);\n\n case 'e2e.ts':\n return getE2eTestBoilerplate(tagName);\n\n default:\n throw new Error(`Unkown extension \"${extension}\".`);\n }\n};\n\n/**\n * Get the boilerplate for a file containing the definition of a component\n * @param tagName the name of the tag to give the component\n * @param hasStyle designates if the component has an external stylesheet or not\n * @param styleExtension extension used for styles\n * @returns the contents of a file that defines a component\n */\nconst getComponentBoilerplate = (\n tagName: string,\n hasStyle: boolean,\n styleExtension: GeneratableStylingExtension,\n): string => {\n const decorator = [`{`];\n decorator.push(` tag: '${tagName}',`);\n if (hasStyle) {\n decorator.push(` styleUrl: '${tagName}.${styleExtension}',`);\n }\n decorator.push(` shadow: true,`);\n decorator.push(`}`);\n\n return `import { Component, Host, h } from '@stencil/core';\n\n@Component(${decorator.join('\\n')})\nexport class ${toPascalCase(tagName)} {\n render() {\n return (\n \n \n );\n }\n}\n`;\n};\n\n/**\n * Get the boilerplate for style for a generated component\n * @param ext extension used for styles\n * @returns a boilerplate CSS block\n */\nconst getStyleUrlBoilerplate = (ext: GeneratableExtension): string =>\n ext === 'sass'\n ? `:host\n display: block\n`\n : `:host {\n display: block;\n}\n`;\n\n/**\n * Get the boilerplate for a file containing a spec (unit) test for a component\n * @param tagName the name of the tag associated with the component under test\n * @returns the contents of a file that unit tests a component\n */\nconst getSpecTestBoilerplate = (tagName: string): string =>\n `import { newSpecPage } from '@stencil/core/testing';\nimport { ${toPascalCase(tagName)} } from '../${tagName}';\n\ndescribe('${tagName}', () => {\n it('renders', async () => {\n const page = await newSpecPage({\n components: [${toPascalCase(tagName)}],\n html: \\`<${tagName}>\\`,\n });\n expect(page.root).toEqualHtml(\\`\n <${tagName}>\n \n \n \n \\`);\n });\n});\n`;\n\n/**\n * Get the boilerplate for a file containing an end-to-end (E2E) test for a component\n * @param tagName the name of the tag associated with the component under test\n * @returns the contents of a file that E2E tests a component\n */\nconst getE2eTestBoilerplate = (tagName: string): string =>\n `import { newE2EPage } from '@stencil/core/testing';\n\ndescribe('${tagName}', () => {\n it('renders', async () => {\n const page = await newE2EPage();\n await page.setContent('<${tagName}>');\n\n const element = await page.find('${tagName}');\n expect(element).toHaveClass('hydrated');\n });\n});\n`;\n\n/**\n * Convert a dash case string to pascal case.\n * @param str the string to convert\n * @returns the converted input as pascal case\n */\nconst toPascalCase = (str: string): string =>\n str.split('-').reduce((res, part) => res + part[0].toUpperCase() + part.slice(1), '');\n\n/**\n * Extensions available to generate.\n */\nexport type GeneratableExtension = 'tsx' | 'spec.tsx' | 'e2e.ts' | GeneratableStylingExtension;\n\n/**\n * Extensions available to generate.\n */\nexport type GeneratableStylingExtension = 'css' | 'sass' | 'scss' | 'less';\n\n/**\n * A little interface to wrap up the info we need to pass around for generating\n * and writing boilerplate.\n */\nexport interface BoilerplateFile {\n extension: GeneratableExtension;\n /**\n * The full path to the file we want to generate.\n */\n path: string;\n}\n"
},
{
"path": "src/cli/task-help.ts",
"content": "import type * as d from '../declarations';\nimport { ConfigFlags } from './config-flags';\nimport { taskTelemetry } from './task-telemetry';\n\n/**\n * Entrypoint for the Help task, providing Stencil usage context to the user\n * @param flags configuration flags provided to Stencil when a task was call (either this task or a task that invokes\n * telemetry)\n * @param logger a logging implementation to log the results out to the user\n * @param sys the abstraction for interfacing with the operating system\n */\nexport const taskHelp = async (flags: ConfigFlags, logger: d.Logger, sys: d.CompilerSystem): Promise => {\n const prompt = logger.dim(sys.details?.platform === 'windows' ? '>' : '$');\n\n console.log(`\n ${logger.bold('Build:')} ${logger.dim('Build components for development or production.')}\n\n ${prompt} ${logger.green('stencil build [--dev] [--watch] [--prerender] [--debug]')}\n\n ${logger.cyan('--dev')} ${logger.dim('.............')} Development build\n ${logger.cyan('--watch')} ${logger.dim('...........')} Rebuild when files update\n ${logger.cyan('--serve')} ${logger.dim('...........')} Start the dev-server\n ${logger.cyan('--prerender')} ${logger.dim('.......')} Prerender the application\n ${logger.cyan('--docs')} ${logger.dim('............')} Generate component readme.md docs\n ${logger.cyan('--config')} ${logger.dim('..........')} Set stencil config file\n ${logger.cyan('--stats')} ${logger.dim('...........')} Write stats, optional file path (default: stencil-stats.json)\n ${logger.cyan('--log')} ${logger.dim('.............')} Write stencil-build.log file\n ${logger.cyan('--debug')} ${logger.dim('...........')} Set the log level to debug\n\n\n ${logger.bold('Test:')} ${logger.dim('Run unit and end-to-end tests.')}\n\n ${prompt} ${logger.green('stencil test [--spec] [--e2e]')}\n\n ${logger.cyan('--spec')} ${logger.dim('............')} Run unit tests with Jest\n ${logger.cyan('--e2e')} ${logger.dim('.............')} Run e2e tests with Puppeteer\n\n\n ${logger.bold('Generate:')} ${logger.dim('Bootstrap components.')}\n\n ${prompt} ${logger.green('stencil generate')} or ${logger.green('stencil g')}\n\n`);\n\n await taskTelemetry(flags, sys, logger);\n\n console.log(`\n ${logger.bold('Examples:')}\n\n ${prompt} ${logger.green('stencil build --dev --watch --serve')}\n ${prompt} ${logger.green('stencil build --prerender')}\n ${prompt} ${logger.green('stencil test --spec --e2e')}\n ${prompt} ${logger.green('stencil telemetry on')}\n ${prompt} ${logger.green('stencil generate')}\n ${prompt} ${logger.green('stencil g my-component')}\n`);\n};\n"
},
{
"path": "src/cli/task-info.ts",
"content": "import type { CompilerSystem, Logger } from '../declarations';\nimport type { CoreCompiler } from './load-compiler';\n\n/**\n * Generate the output for Stencils 'info' task, and log that output - `npx stencil info`\n * @param coreCompiler the compiler instance to derive certain version information from\n * @param sys the compiler system instance that provides details about the system Stencil is running on\n * @param logger the logger instance to use to log information out to\n */\nexport const taskInfo = (coreCompiler: CoreCompiler, sys: CompilerSystem, logger: Logger): void => {\n const details = sys.details;\n const versions = coreCompiler.versions;\n\n console.log(``);\n console.log(`${logger.cyan(' System:')} ${sys.name} ${sys.version}`);\n if (details) {\n console.log(`${logger.cyan(' Platform:')} ${details.platform} (${details.release})`);\n console.log(\n `${logger.cyan(' CPU Model:')} ${details.cpuModel} (${sys.hardwareConcurrency} cpu${\n sys.hardwareConcurrency !== 1 ? 's' : ''\n })`,\n );\n }\n console.log(`${logger.cyan(' Compiler:')} ${sys.getCompilerExecutingPath()}`);\n console.log(`${logger.cyan(' Build:')} ${coreCompiler.buildId}`);\n console.log(`${logger.cyan(' Stencil:')} ${coreCompiler.version}${logger.emoji(' ' + coreCompiler.vermoji)}`);\n console.log(`${logger.cyan(' TypeScript:')} ${versions.typescript}`);\n console.log(`${logger.cyan(' Rollup:')} ${versions.rollup}`);\n console.log(`${logger.cyan(' Parse5:')} ${versions.parse5}`);\n console.log(`${logger.cyan(' jQuery:')} ${versions.jquery}`);\n console.log(`${logger.cyan(' Terser:')} ${versions.terser}`);\n console.log(``);\n};\n"
},
{
"path": "src/cli/task-prerender.ts",
"content": "import { catchError } from '@utils';\n\nimport type { BuildResultsComponentGraph, Diagnostic, ValidatedConfig } from '../declarations';\nimport type { CoreCompiler } from './load-compiler';\nimport { startupCompilerLog } from './logs';\n\nexport const taskPrerender = async (coreCompiler: CoreCompiler, config: ValidatedConfig) => {\n startupCompilerLog(coreCompiler, config);\n\n const hydrateAppFilePath = config.flags.unknownArgs[0];\n\n if (typeof hydrateAppFilePath !== 'string') {\n config.logger.error(`Missing hydrate app script path`);\n return config.sys.exit(1);\n }\n\n const srcIndexHtmlPath = config.srcIndexHtml;\n\n const diagnostics = await runPrerenderTask(coreCompiler, config, hydrateAppFilePath, undefined, srcIndexHtmlPath);\n config.logger.printDiagnostics(diagnostics);\n\n if (diagnostics.some((d) => d.level === 'error')) {\n return config.sys.exit(1);\n }\n};\n\nexport const runPrerenderTask = async (\n coreCompiler: CoreCompiler,\n config: ValidatedConfig,\n hydrateAppFilePath?: string,\n componentGraph?: BuildResultsComponentGraph,\n srcIndexHtmlPath?: string,\n) => {\n const diagnostics: Diagnostic[] = [];\n\n try {\n const prerenderer = await coreCompiler.createPrerenderer(config);\n const results = await prerenderer.start({\n hydrateAppFilePath,\n componentGraph,\n srcIndexHtmlPath,\n });\n\n diagnostics.push(...results.diagnostics);\n } catch (e: any) {\n catchError(diagnostics, e);\n }\n\n return diagnostics;\n};\n"
},
{
"path": "src/cli/task-serve.ts",
"content": "import { isString } from '@utils';\n\nimport type { ValidatedConfig } from '../declarations';\n\nexport const taskServe = async (config: ValidatedConfig) => {\n config.suppressLogs = true;\n\n config.flags.serve = true;\n config.devServer.openBrowser = !!config.flags.open;\n config.devServer.reloadStrategy = null;\n config.devServer.initialLoadUrl = '/';\n config.devServer.websocket = false;\n config.maxConcurrentWorkers = 1;\n config.devServer.root = isString(config.flags.root) ? config.flags.root : config.sys.getCurrentDirectory();\n\n if (!config.sys.getDevServerExecutingPath || !config.sys.dynamicImport || !config.sys.onProcessInterrupt) {\n throw new Error(\n `Environment doesn't provide required functions: getDevServerExecutingPath, dynamicImport, onProcessInterrupt`,\n );\n }\n\n const devServerPath = config.sys.getDevServerExecutingPath();\n const { start }: typeof import('@stencil/core/dev-server') = await config.sys.dynamicImport(devServerPath);\n const devServer = await start(config.devServer, config.logger);\n\n console.log(`${config.logger.cyan(' Root:')} ${devServer.root}`);\n console.log(`${config.logger.cyan(' Address:')} ${devServer.address}`);\n console.log(`${config.logger.cyan(' Port:')} ${devServer.port}`);\n console.log(`${config.logger.cyan(' Server:')} ${devServer.browserUrl}`);\n console.log(``);\n\n config.sys.onProcessInterrupt(() => {\n if (devServer) {\n config.logger.debug(`dev server close: ${devServer.browserUrl}`);\n devServer.close();\n }\n });\n};\n"
},
{
"path": "src/cli/task-telemetry.ts",
"content": "import type * as d from '../declarations';\nimport { ConfigFlags } from './config-flags';\nimport { checkTelemetry, disableTelemetry, enableTelemetry } from './telemetry/telemetry';\n\n/**\n * Entrypoint for the Telemetry task\n * @param flags configuration flags provided to Stencil when a task was called (either this task or a task that invokes\n * telemetry)\n * @param sys the abstraction for interfacing with the operating system\n * @param logger a logging implementation to log the results out to the user\n */\nexport const taskTelemetry = async (flags: ConfigFlags, sys: d.CompilerSystem, logger: d.Logger): Promise => {\n const prompt = logger.dim(sys.details?.platform === 'windows' ? '>' : '$');\n const isEnabling = flags.args.includes('on');\n const isDisabling = flags.args.includes('off');\n const INFORMATION = `Opt in or out of telemetry. Information about the data we collect is available on our website: ${logger.bold(\n 'https://stenciljs.com/telemetry',\n )}`;\n const THANK_YOU = `Thank you for helping to make Stencil better! 💖`;\n const ENABLED_MESSAGE = `${logger.green('Enabled')}. ${THANK_YOU}\\n\\n`;\n const DISABLED_MESSAGE = `${logger.red('Disabled')}\\n\\n`;\n const hasTelemetry = await checkTelemetry(sys);\n\n if (isEnabling) {\n const result = await enableTelemetry(sys);\n result\n ? console.log(`\\n ${logger.bold('Telemetry is now ') + ENABLED_MESSAGE}`)\n : console.log(`Something went wrong when enabling Telemetry.`);\n return;\n }\n\n if (isDisabling) {\n const result = await disableTelemetry(sys);\n result\n ? console.log(`\\n ${logger.bold('Telemetry is now ') + DISABLED_MESSAGE}`)\n : console.log(`Something went wrong when disabling Telemetry.`);\n return;\n }\n\n console.log(` ${logger.bold('Telemetry:')} ${logger.dim(INFORMATION)}`);\n\n console.log(`\\n ${logger.bold('Status')}: ${hasTelemetry ? ENABLED_MESSAGE : DISABLED_MESSAGE}`);\n\n console.log(` ${prompt} ${logger.green('stencil telemetry [off|on]')}\n\n ${logger.cyan('off')} ${logger.dim('.............')} Disable sharing anonymous usage data\n ${logger.cyan('on')} ${logger.dim('..............')} Enable sharing anonymous usage data\n `);\n};\n"
},
{
"path": "src/cli/task-test.ts",
"content": "import type { TestingRunOptions, ValidatedConfig } from '../declarations';\n\n/**\n * Entrypoint for any Stencil tests\n * @param config a validated Stencil configuration entity\n * @returns a void promise\n */\nexport const taskTest = async (config: ValidatedConfig): Promise => {\n config.logger.warn(\n config.logger.yellow(\n `[DEPRECATION] Stencil's integrated testing (the 'test' task, --spec and --e2e flags) is deprecated and will be removed in Stencil v5. ` +\n `Migrate spec tests to @stencil/vitest (https://github.com/stenciljs/vitest) and ` +\n `e2e / browser tests to either @stencil/vitest (https://github.com/stenciljs/vitest) or ` +\n `@stencil/playwright (https://github.com/stenciljs/playwright). ` +\n `See https://github.com/stenciljs/core/issues/6584 for full details.`,\n ),\n );\n config.buildDocs = false;\n const testingRunOpts: TestingRunOptions = {\n e2e: !!config.flags.e2e,\n screenshot: !!config.flags.screenshot,\n spec: !!config.flags.spec,\n updateScreenshot: !!config.flags.updateScreenshot,\n };\n\n // always ensure we have jest modules installed\n const ensureModuleIds = ['@types/jest', 'jest', 'jest-cli'];\n\n if (testingRunOpts.e2e) {\n // if it's an e2e test, also make sure we're got\n // puppeteer modules installed and if browserExecutablePath is provided don't download Chromium use only puppeteer-core instead\n const puppeteer = config.testing.browserExecutablePath ? 'puppeteer-core' : 'puppeteer';\n\n ensureModuleIds.push(puppeteer);\n\n if (testingRunOpts.screenshot) {\n // ensure we've got pixelmatch for screenshots\n config.logger.warn(\n config.logger.yellow(\n `EXPERIMENTAL: screenshot visual diff testing is currently under heavy development and has not reached a stable status. However, any assistance testing would be appreciated.`,\n ),\n );\n }\n }\n\n // ensure we've got the required modules installed\n const diagnostics = await config.sys.lazyRequire?.ensure(config.rootDir, ensureModuleIds);\n if (diagnostics && diagnostics.length > 0) {\n config.logger.printDiagnostics(diagnostics);\n return config.sys.exit(1);\n }\n\n try {\n /**\n * We dynamically import the testing submodule here in order for Stencil's lazy module checking to work properly.\n *\n * Prior to this call, we create a collection of string-based node module names and ensure that they're installed &\n * on disk. The testing submodule includes `jest` (amongst other) testing libraries in its dependency chain. We need\n * to run the lazy module check _before_ we include `jest` et al. in our dependency chain otherwise, the lazy module\n * checking would fail to run properly (because we'd import `jest`, which wouldn't exist, before we even checked if\n * it was installed).\n */\n const { createTesting } = await import('@stencil/core/testing');\n const testing = await createTesting(config);\n const passed = await testing.run(testingRunOpts);\n await testing.destroy();\n\n if (!passed) {\n return config.sys.exit(1);\n }\n } catch (e) {\n config.logger.error(e);\n return config.sys.exit(1);\n }\n};\n"
},
{
"path": "src/cli/task-watch.ts",
"content": "import type { DevServer, ValidatedConfig } from '../declarations';\nimport { printCheckVersionResults, startCheckVersion } from './check-version';\nimport type { CoreCompiler } from './load-compiler';\nimport { startupCompilerLog } from './logs';\n\nexport const taskWatch = async (coreCompiler: CoreCompiler, config: ValidatedConfig) => {\n let devServer: DevServer | null = null;\n let exitCode = 0;\n\n try {\n startupCompilerLog(coreCompiler, config);\n\n const versionChecker = startCheckVersion(config, coreCompiler.version);\n\n const compiler = await coreCompiler.createCompiler(config);\n const watcher = await compiler.createWatcher();\n\n if (!config.sys.getDevServerExecutingPath || !config.sys.dynamicImport || !config.sys.onProcessInterrupt) {\n throw new Error(\n `Environment doesn't provide required functions: getDevServerExecutingPath, dynamicImport, onProcessInterrupt`,\n );\n }\n\n if (config.flags.serve) {\n const devServerPath = config.sys.getDevServerExecutingPath();\n const { start }: typeof import('@stencil/core/dev-server') = await config.sys.dynamicImport(devServerPath);\n devServer = await start(config.devServer, config.logger, watcher);\n }\n\n config.sys.onProcessInterrupt(() => {\n config.logger.debug(`close watch`);\n compiler && compiler.destroy();\n });\n\n const rmVersionCheckerLog = watcher.on('buildFinish', async () => {\n // log the version check one time\n rmVersionCheckerLog();\n printCheckVersionResults(versionChecker);\n });\n\n if (devServer) {\n const rmDevServerLog = watcher.on('buildFinish', () => {\n // log the dev server url one time\n rmDevServerLog();\n const url = devServer?.browserUrl ?? 'UNKNOWN URL';\n config.logger.info(`${config.logger.cyan(url)}\\n`);\n });\n }\n\n const closeResults = await watcher.start();\n if (closeResults.exitCode > 0) {\n exitCode = closeResults.exitCode;\n }\n } catch (e) {\n exitCode = 1;\n config.logger.error(e);\n }\n\n if (devServer) {\n await devServer.close();\n }\n\n if (exitCode > 0) {\n return config.sys.exit(exitCode);\n }\n};\n"
},
{
"path": "src/cli/telemetry/helpers.ts",
"content": "import type * as d from '../../declarations';\nimport { ConfigFlags } from '../config-flags';\n\nexport const tryFn = async Promise, R>(fn: T, ...args: any[]): Promise => {\n try {\n return await fn(...args);\n } catch {\n // ignore\n }\n\n return null;\n};\n\nexport const isInteractive = (sys: d.CompilerSystem, flags: ConfigFlags, object?: d.TerminalInfo): boolean => {\n const terminalInfo =\n object ||\n Object.freeze({\n tty: sys.isTTY() ? true : false,\n ci:\n ['CI', 'BUILD_ID', 'BUILD_NUMBER', 'BITBUCKET_COMMIT', 'CODEBUILD_BUILD_ARN'].filter(\n (v) => !!sys.getEnvironmentVar?.(v),\n ).length > 0 || !!flags.ci,\n });\n\n return terminalInfo.tty && !terminalInfo.ci;\n};\n\nexport const UUID_REGEX = new RegExp(/^[0-9A-F]{8}-[0-9A-F]{4}-4[0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/i);\n\n// Plucked from https://github.com/ionic-team/capacitor/blob/b893a57aaaf3a16e13db9c33037a12f1a5ac92e0/cli/src/util/uuid.ts\nexport function uuidv4(): string {\n return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\n const r = (Math.random() * 16) | 0;\n const v = c == 'x' ? r : (r & 0x3) | 0x8;\n\n return v.toString(16);\n });\n}\n\n/**\n * Reads and parses a JSON file from the given `path`\n * @param sys The system where the command is invoked\n * @param path the path on the file system to read and parse\n * @returns the parsed JSON\n */\nexport async function readJson(sys: d.CompilerSystem, path: string): Promise {\n const file = await sys.readFile(path);\n return !!file && JSON.parse(file);\n}\n\n/**\n * Does the command have the debug flag?\n * @param flags The configuration flags passed into the Stencil command\n * @returns true if --debug has been passed, otherwise false\n */\nexport function hasDebug(flags: ConfigFlags): boolean {\n return !!flags.debug;\n}\n\n/**\n * Does the command have the verbose and debug flags?\n * @param flags The configuration flags passed into the Stencil command\n * @returns true if both --debug and --verbose have been passed, otherwise false\n */\nexport function hasVerbose(flags: ConfigFlags): boolean {\n return !!flags.verbose && hasDebug(flags);\n}\n"
},
{
"path": "src/cli/telemetry/shouldTrack.ts",
"content": "import * as d from '../../declarations';\nimport { isInteractive } from './helpers';\nimport { checkTelemetry } from './telemetry';\n\n/**\n * Used to determine if tracking should occur.\n * @param config The config passed into the Stencil command\n * @param sys The system where the command is invoked\n * @param ci whether or not the process is running in a Continuous Integration (CI) environment\n * @returns true if telemetry should be sent, false otherwise\n */\nexport async function shouldTrack(config: d.ValidatedConfig, sys: d.CompilerSystem, ci?: boolean) {\n return !ci && isInteractive(sys, config.flags) && (await checkTelemetry(sys));\n}\n"
},
{
"path": "src/cli/telemetry/telemetry.ts",
"content": "import { isOutputTargetHydrate, WWW } from '@utils';\n\nimport type * as d from '../../declarations';\nimport { readConfig, updateConfig, writeConfig } from '../ionic-config';\nimport { CoreCompiler } from '../load-compiler';\nimport { hasDebug, hasVerbose, readJson, tryFn, uuidv4 } from './helpers';\nimport { shouldTrack } from './shouldTrack';\n\n/**\n * Used to within taskBuild to provide the component_count property.\n *\n * @param sys The system where the command is invoked\n * @param config The config passed into the Stencil command\n * @param coreCompiler The compiler used to do builds\n * @param result The results of a compiler build.\n */\nexport async function telemetryBuildFinishedAction(\n sys: d.CompilerSystem,\n config: d.ValidatedConfig,\n coreCompiler: CoreCompiler,\n result: d.CompilerBuildResults,\n) {\n const tracking = await shouldTrack(config, sys, !!config.flags.ci);\n\n if (!tracking) {\n return;\n }\n\n const component_count = result.componentGraph ? Object.keys(result.componentGraph).length : undefined;\n\n const data = await prepareData(coreCompiler, config, sys, result.duration, component_count);\n\n await sendMetric(sys, config, 'stencil_cli_command', data);\n\n config.logger.debug(`${config.logger.blue('Telemetry')}: ${config.logger.gray(JSON.stringify(data))}`);\n}\n\n/**\n * A function to wrap a compiler task function around. Will send telemetry if, and only if, the machine allows.\n *\n * @param sys The system where the command is invoked\n * @param config The config passed into the Stencil command\n * @param coreCompiler The compiler used to do builds\n * @param action A Promise-based function to call in order to get the duration of any given command.\n * @returns void\n */\nexport async function telemetryAction(\n sys: d.CompilerSystem,\n config: d.ValidatedConfig,\n coreCompiler: CoreCompiler,\n action?: d.TelemetryCallback,\n) {\n const tracking = await shouldTrack(config, sys, !!config.flags.ci);\n\n let duration = undefined;\n let error: any;\n\n if (action) {\n const start = new Date();\n\n try {\n await action();\n } catch (e) {\n error = e;\n }\n\n const end = new Date();\n duration = end.getTime() - start.getTime();\n }\n\n // We'll get componentCount details inside the taskBuild, so let's not send two messages.\n if (!tracking || (config.flags.task == 'build' && !config.flags.args.includes('--watch'))) {\n return;\n }\n\n const data = await prepareData(coreCompiler, config, sys, duration);\n\n await sendMetric(sys, config, 'stencil_cli_command', data);\n config.logger.debug(`${config.logger.blue('Telemetry')}: ${config.logger.gray(JSON.stringify(data))}`);\n\n if (error) {\n throw error;\n }\n}\n\n/**\n * Helper function to determine if a Stencil configuration builds an application.\n *\n * This function is a rough approximation whether an application is generated as a part of a Stencil build, based on\n * contents of the project's `stencil.config.ts` file.\n *\n * @param config the configuration used by the Stencil project\n * @returns true if we believe the project generates an application, false otherwise\n */\nexport function hasAppTarget(config: d.ValidatedConfig): boolean {\n return config.outputTargets.some(\n (target) => target.type === WWW && (!!target.serviceWorker || (!!target.baseUrl && target.baseUrl !== '/')),\n );\n}\n\nexport function isUsingYarn(sys: d.CompilerSystem) {\n return sys.getEnvironmentVar?.('npm_execpath')?.includes('yarn') || false;\n}\n\n/**\n * Build a list of the different types of output targets used in a Stencil configuration.\n *\n * Duplicate entries will not be returned from the list\n *\n * @param config the configuration used by the Stencil project\n * @returns a unique list of output target types found in the Stencil configuration\n */\nexport function getActiveTargets(config: d.ValidatedConfig): string[] {\n const result = config.outputTargets.map((t) => t.type);\n return Array.from(new Set(result));\n}\n\n/**\n * Prepare data for telemetry\n *\n * @param coreCompiler the core compiler\n * @param config the current Stencil config\n * @param sys the compiler system instance in use\n * @param duration_ms the duration of the action being tracked\n * @param component_count the number of components being built (optional)\n * @returns a Promise wrapping data for the telemetry endpoint\n */\nexport const prepareData = async (\n coreCompiler: CoreCompiler,\n config: d.ValidatedConfig,\n sys: d.CompilerSystem,\n duration_ms: number | undefined,\n component_count: number | undefined = undefined,\n): Promise => {\n const { typescript, rollup } = coreCompiler.versions || { typescript: 'unknown', rollup: 'unknown' };\n const { packages, packagesNoVersions } = await getInstalledPackages(sys, config);\n const targets = getActiveTargets(config);\n const yarn = isUsingYarn(sys);\n const stencil = coreCompiler.version || 'unknown';\n const system = `${sys.name} ${sys.version}`;\n const os_name = sys.details?.platform;\n const os_version = sys.details?.release;\n const cpu_model = sys.details?.cpuModel;\n const build = coreCompiler.buildId || 'unknown';\n const has_app_pwa_config = hasAppTarget(config);\n const anonymizedConfig = anonymizeConfigForTelemetry(config);\n\n return {\n arguments: config.flags.args,\n build,\n component_count,\n config: anonymizedConfig,\n cpu_model,\n duration_ms,\n has_app_pwa_config,\n os_name,\n os_version,\n packages,\n packages_no_versions: packagesNoVersions,\n rollup,\n stencil,\n system,\n system_major: getMajorVersion(system),\n targets,\n task: config.flags.task,\n typescript,\n yarn,\n };\n};\n\n// Setting a key type to `never` excludes it from a mapped type, so we\n// can get only keys which map to a string value by excluding all keys `K`\n// where `d.Config[K]` does not extend `string`.\ntype ConfigStringKeys = keyof {\n [K in keyof d.Config as Required[K] extends string ? K : never]: d.Config[K];\n};\n\n// props in output targets for which we retain their original values when\n// preparing a config for telemetry\n//\n// we omit the values of all other fields on output targets.\nconst OUTPUT_TARGET_KEYS_TO_KEEP: ReadonlyArray = ['type'];\n\n// top-level config props that we anonymize for telemetry\nconst CONFIG_PROPS_TO_ANONYMIZE: ReadonlyArray = [\n 'rootDir',\n 'fsNamespace',\n 'packageJsonFilePath',\n 'namespace',\n 'srcDir',\n 'srcIndexHtml',\n 'buildLogFilePath',\n 'cacheDir',\n 'configPath',\n 'tsconfig',\n];\n\n// Props we delete entirely from the config for telemetry\n//\n// TODO(STENCIL-469): Investigate improving anonymization for tsCompilerOptions and devServer\nconst CONFIG_PROPS_TO_DELETE: ReadonlyArray = [\n 'commonjs',\n 'devServer',\n 'env',\n 'logger',\n 'rollupConfig',\n 'sys',\n 'testing',\n 'tsCompilerOptions',\n];\n\n/**\n * Anonymize the config for telemetry, replacing potentially revealing config props\n * with a placeholder string if they are present (this lets us still track how frequently\n * these config options are being used)\n *\n * @param config the config to anonymize\n * @returns an anonymized copy of the same config\n */\nexport const anonymizeConfigForTelemetry = (config: d.ValidatedConfig): d.Config => {\n const anonymizedConfig: d.Config = { ...config };\n\n for (const prop of CONFIG_PROPS_TO_ANONYMIZE) {\n if (anonymizedConfig[prop] !== undefined) {\n anonymizedConfig[prop] = 'omitted';\n }\n }\n\n anonymizedConfig.outputTargets = config.outputTargets.map((target) => {\n // Anonymize the outputTargets on our configuration, taking advantage of the\n // optional 2nd argument to `JSON.stringify`. If anything is not a string\n // we retain it so that any nested properties are handled, else we check\n // whether it's in our 'keep' list to decide whether to keep it or replace it\n // with `\"omitted\"`.\n const anonymizedOT = JSON.parse(\n JSON.stringify(target, (key, value) => {\n if (!(typeof value === 'string')) {\n return value;\n }\n if (OUTPUT_TARGET_KEYS_TO_KEEP.includes(key)) {\n return value;\n }\n return 'omitted';\n }),\n );\n\n // this prop has to be handled separately because it is an array\n // so the replace function above will be called with all of its\n // members, giving us `[\"omitted\", \"omitted\", ...]`.\n //\n // Instead, we check for its presence and manually copy over.\n if (isOutputTargetHydrate(target) && target.external) {\n anonymizedOT['external'] = target.external.concat();\n }\n return anonymizedOT;\n });\n\n // TODO(STENCIL-469): Investigate improving anonymization for tsCompilerOptions and devServer\n for (const prop of CONFIG_PROPS_TO_DELETE) {\n delete anonymizedConfig[prop];\n }\n\n return anonymizedConfig;\n};\n\n/**\n * Reads package-lock.json, yarn.lock, and package.json files in order to cross-reference\n * the dependencies and devDependencies properties. Pulls up the current installed version\n * of each package under the @stencil, @ionic, and @capacitor scopes.\n *\n * @param sys the system instance where telemetry is invoked\n * @param config the Stencil configuration associated with the current task that triggered telemetry\n * @returns an object listing all dev and production dependencies under the aforementioned scopes\n */\nasync function getInstalledPackages(\n sys: d.CompilerSystem,\n config: d.ValidatedConfig,\n): Promise<{ packages: string[]; packagesNoVersions: string[] }> {\n let packages: string[] = [];\n let packagesNoVersions: string[] = [];\n const yarn = isUsingYarn(sys);\n\n try {\n // Read package.json and package-lock.json\n const appRootDir = sys.getCurrentDirectory();\n\n const packageJson: d.PackageJsonData | null = await tryFn(\n readJson,\n sys,\n sys.resolvePath(appRootDir + '/package.json'),\n );\n\n // They don't have a package.json for some reason? Eject button.\n if (!packageJson) {\n return { packages, packagesNoVersions };\n }\n\n const rawPackages: [string, string][] = Object.entries({\n ...packageJson.devDependencies,\n ...packageJson.dependencies,\n });\n\n // Collect packages only in the stencil, ionic, or capacitor org's:\n // https://www.npmjs.com/org/stencil\n const ionicPackages = rawPackages.filter(\n ([k]) => k.startsWith('@stencil/') || k.startsWith('@ionic/') || k.startsWith('@capacitor/'),\n );\n\n try {\n packages = yarn ? await yarnPackages(sys, ionicPackages) : await npmPackages(sys, ionicPackages);\n } catch (e) {\n packages = ionicPackages.map(([k, v]) => `${k}@${v.replace('^', '')}`);\n }\n\n packagesNoVersions = ionicPackages.map(([k]) => `${k}`);\n\n return { packages, packagesNoVersions };\n } catch (err) {\n hasDebug(config.flags) && console.error(err);\n return { packages, packagesNoVersions };\n }\n}\n\n/**\n * Visits the npm lock file to find the exact versions that are installed\n * @param sys The system where the command is invoked\n * @param ionicPackages a list of the found packages matching `@stencil`, `@capacitor`, or `@ionic` from the package.json file.\n * @returns an array of strings of all the packages and their versions.\n */\nasync function npmPackages(sys: d.CompilerSystem, ionicPackages: [string, string][]): Promise {\n const appRootDir = sys.getCurrentDirectory();\n const packageLockJson: any = await tryFn(readJson, sys, sys.resolvePath(appRootDir + '/package-lock.json'));\n\n return ionicPackages.map(([k, v]) => {\n let version = packageLockJson?.dependencies[k]?.version ?? packageLockJson?.devDependencies[k]?.version ?? v;\n version = version.includes('file:') ? sanitizeDeclaredVersion(v) : version;\n return `${k}@${version}`;\n });\n}\n\n/**\n * Visits the yarn lock file to find the exact versions that are installed\n * @param sys The system where the command is invoked\n * @param ionicPackages a list of the found packages matching `@stencil`, `@capacitor`, or `@ionic` from the package.json file.\n * @returns an array of strings of all the packages and their versions.\n */\nasync function yarnPackages(sys: d.CompilerSystem, ionicPackages: [string, string][]): Promise {\n const appRootDir = sys.getCurrentDirectory();\n const yarnLock = sys.readFileSync(sys.resolvePath(appRootDir + '/yarn.lock'));\n const yarnLockYml = sys.parseYarnLockFile?.(yarnLock);\n\n return ionicPackages.map(([k, v]) => {\n const identifiedVersion = `${k}@${v}`;\n let version = yarnLockYml?.object[identifiedVersion]?.version;\n version = version && version.includes('undefined') ? sanitizeDeclaredVersion(identifiedVersion) : version;\n return `${k}@${version}`;\n });\n}\n\n/**\n * This function is used for fallback purposes, where an npm or yarn lock file doesn't exist in the consumers directory.\n * This will strip away '*', '^' and '~' from the declared package versions in a package.json.\n * @param version the raw semver pattern identifier version string\n * @returns a cleaned up representation without any qualifiers\n */\nfunction sanitizeDeclaredVersion(version: string): string {\n return version.replace(/[*^~]/g, '');\n}\n\n/**\n * If telemetry is enabled, send a metric to an external data store\n *\n * @param sys the system instance where telemetry is invoked\n * @param config the Stencil configuration associated with the current task that triggered telemetry\n * @param name the name of a trackable metric. Note this name is not necessarily a scalar value to track, like\n * \"Stencil Version\". For example, \"stencil_cli_command\" is a name that is used to track all CLI command information.\n * @param value the data to send to the external data store under the provided name argument\n */\nexport async function sendMetric(\n sys: d.CompilerSystem,\n config: d.ValidatedConfig,\n name: string,\n value: d.TrackableData,\n): Promise {\n const session_id = await getTelemetryToken(sys);\n\n const message: d.Metric = {\n name,\n timestamp: new Date().toISOString(),\n source: 'stencil_cli',\n value,\n session_id,\n };\n\n await sendTelemetry(sys, config, message);\n}\n\n/**\n * Used to read the config file's tokens.telemetry property.\n *\n * @param sys The system where the command is invoked\n * @returns string\n */\nasync function getTelemetryToken(sys: d.CompilerSystem) {\n const config = await readConfig(sys);\n if (config['tokens.telemetry'] === undefined) {\n config['tokens.telemetry'] = uuidv4();\n await writeConfig(sys, config);\n }\n return config['tokens.telemetry'];\n}\n\n/**\n * Issues a request to the telemetry server.\n * @param sys The system where the command is invoked\n * @param config The config passed into the Stencil command\n * @param data Data to be tracked\n */\nasync function sendTelemetry(sys: d.CompilerSystem, config: d.ValidatedConfig, data: d.Metric): Promise {\n try {\n const now = new Date().toISOString();\n\n const body = {\n metrics: [data],\n sent_at: now,\n };\n\n if (!sys.fetch) {\n throw new Error('No fetch implementation available');\n }\n\n // This request is only made if telemetry is on.\n const response = await sys.fetch('https://api.ionicjs.com/events/metrics', {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(body),\n });\n\n hasVerbose(config.flags) &&\n console.debug('\\nSent %O metric to events service (status: %O)', data.name, response.status, '\\n');\n\n if (response.status !== 204) {\n hasVerbose(config.flags) &&\n console.debug('\\nBad response from events service. Request body: %O', response.body.toString(), '\\n');\n }\n } catch (e) {\n hasVerbose(config.flags) && console.debug('Telemetry request failed:', e);\n }\n}\n\n/**\n * Checks if telemetry is enabled on this machine\n * @param sys The system where the command is invoked\n * @returns true if telemetry is enabled, false otherwise\n */\nexport async function checkTelemetry(sys: d.CompilerSystem): Promise {\n const config = await readConfig(sys);\n if (config['telemetry.stencil'] === undefined) {\n config['telemetry.stencil'] = true;\n await writeConfig(sys, config);\n }\n return config['telemetry.stencil'];\n}\n\n/**\n * Writes to the config file, enabling telemetry for this machine.\n * @param sys The system where the command is invoked\n * @returns true if writing the file was successful, false otherwise\n */\nexport async function enableTelemetry(sys: d.CompilerSystem): Promise {\n return await updateConfig(sys, { 'telemetry.stencil': true });\n}\n\n/**\n * Writes to the config file, disabling telemetry for this machine.\n * @param sys The system where the command is invoked\n * @returns true if writing the file was successful, false otherwise\n */\nexport async function disableTelemetry(sys: d.CompilerSystem): Promise {\n return await updateConfig(sys, { 'telemetry.stencil': false });\n}\n\n/**\n * Takes in a semver string in order to return the major version.\n * @param version The fully qualified semver version\n * @returns a string of the major version\n */\nfunction getMajorVersion(version: string): string {\n const parts = version.split('.');\n return parts[0];\n}\n"
},
{
"path": "src/cli/telemetry/test/helpers.spec.ts",
"content": "import { createSystem } from '../../../compiler/sys/stencil-sys';\nimport { ConfigFlags, createConfigFlags } from '../../config-flags';\nimport { hasDebug, hasVerbose, isInteractive, tryFn, uuidv4 } from '../helpers';\n\ndescribe('hasDebug', () => {\n it('returns true when the \"debug\" flag is true', () => {\n const flags = createConfigFlags({\n debug: true,\n });\n\n expect(hasDebug(flags)).toBe(true);\n });\n\n it('returns false when the \"debug\" flag is false', () => {\n const flags = createConfigFlags({\n debug: false,\n });\n\n expect(hasDebug(flags)).toBe(false);\n });\n\n it('returns false when a flag is not passed', () => {\n const flags = createConfigFlags({});\n\n expect(hasDebug(flags)).toBe(false);\n });\n});\n\ndescribe('hasVerbose', () => {\n it.each>([\n { debug: true, verbose: false },\n { debug: false, verbose: true },\n { debug: false, verbose: false },\n ])('returns false when debug=$debug and verbose=$verbose', (flagOverrides) => {\n const flags = createConfigFlags(flagOverrides);\n\n expect(hasVerbose(flags)).toBe(false);\n });\n\n it('returns true when debug=true and verbose=true', () => {\n const flags = createConfigFlags({\n debug: true,\n verbose: true,\n });\n\n expect(hasVerbose(flags)).toBe(true);\n });\n});\n\ndescribe('uuidv4', () => {\n it('outputs a UUID', () => {\n const pattern = new RegExp(/^[0-9A-F]{8}-[0-9A-F]{4}-4[0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/i);\n const uuid = uuidv4();\n expect(!!uuid.match(pattern)).toBe(true);\n });\n});\n\ndescribe('isInteractive', () => {\n const sys = createSystem();\n\n it('returns false by default', () => {\n const result = isInteractive(sys, createConfigFlags({ ci: false }), { ci: false, tty: false });\n expect(result).toBe(false);\n });\n\n it('returns false when tty is false', () => {\n const result = isInteractive(sys, createConfigFlags({ ci: true }), { ci: true, tty: false });\n expect(result).toBe(false);\n });\n\n it('returns false when ci is true', () => {\n const result = isInteractive(sys, createConfigFlags({ ci: true }), { ci: true, tty: true });\n expect(result).toBe(false);\n });\n\n it('returns true when tty is true and ci is false', () => {\n const result = isInteractive(sys, createConfigFlags({ ci: false }), { ci: false, tty: true });\n expect(result).toBe(true);\n });\n});\n\ndescribe('tryFn', () => {\n it('handles failures correctly', async () => {\n const result = await tryFn(async () => {\n throw new Error('Uh oh!');\n });\n\n expect(result).toBe(null);\n });\n\n it('handles success correctly', async () => {\n const result = await tryFn(async () => {\n return true;\n });\n\n expect(result).toBe(true);\n });\n\n it('handles returning false correctly', async () => {\n const result = await tryFn(async () => {\n return false;\n });\n\n expect(result).toBe(false);\n });\n});\n"
},
{
"path": "src/cli/telemetry/test/telemetry.spec.ts",
"content": "import * as coreCompiler from '@stencil/core/compiler';\nimport { mockValidatedConfig } from '@stencil/core/testing';\nimport { DIST, DIST_CUSTOM_ELEMENTS, DIST_HYDRATE_SCRIPT, WWW } from '@utils';\n\nimport { createConfigFlags } from '../../../cli/config-flags';\nimport { createSystem } from '../../../compiler/sys/stencil-sys';\nimport type * as d from '../../../declarations';\nimport * as shouldTrack from '../shouldTrack';\nimport * as telemetry from '../telemetry';\nimport { anonymizeConfigForTelemetry } from '../telemetry';\n\ndescribe('telemetryBuildFinishedAction', () => {\n let config: d.ValidatedConfig;\n let sys: d.CompilerSystem;\n\n beforeEach(() => {\n sys = createSystem();\n config = mockValidatedConfig({\n flags: createConfigFlags({ task: 'build' }),\n outputTargets: [],\n sys,\n });\n });\n\n it('issues a network request when complete', async () => {\n const spyShouldTrack = jest.spyOn(shouldTrack, 'shouldTrack');\n spyShouldTrack.mockReturnValue(\n new Promise((resolve) => {\n resolve(true);\n }),\n );\n\n const results = {\n componentGraph: {},\n duration: 100,\n } as d.CompilerBuildResults;\n\n await telemetry.telemetryBuildFinishedAction(sys, config, coreCompiler, results);\n expect(spyShouldTrack).toHaveBeenCalled();\n\n spyShouldTrack.mockRestore();\n });\n});\n\ndescribe('telemetryAction', () => {\n let config: d.ValidatedConfig;\n let sys: d.CompilerSystem;\n\n beforeEach(() => {\n sys = createSystem();\n config = mockValidatedConfig({\n flags: createConfigFlags({ task: 'build' }),\n outputTargets: [],\n sys,\n });\n });\n\n it('issues a network request when no async function is passed', async () => {\n const spyShouldTrack = jest.spyOn(shouldTrack, 'shouldTrack');\n spyShouldTrack.mockReturnValue(\n new Promise((resolve) => {\n resolve(true);\n }),\n );\n\n await telemetry.telemetryAction(sys, config, coreCompiler, () => {});\n expect(spyShouldTrack).toHaveBeenCalled();\n\n spyShouldTrack.mockRestore();\n });\n\n it('issues a network request when passed async function is complete', async () => {\n const spyShouldTrack = jest.spyOn(shouldTrack, 'shouldTrack');\n spyShouldTrack.mockReturnValue(\n new Promise((resolve) => {\n resolve(true);\n }),\n );\n\n await telemetry.telemetryAction(sys, config, coreCompiler, async () => {\n new Promise((resolve) => {\n setTimeout(() => {\n resolve(true);\n }, 1000);\n });\n });\n\n expect(spyShouldTrack).toHaveBeenCalled();\n\n spyShouldTrack.mockRestore();\n });\n});\n\ndescribe('checkTelemetry', () => {\n const sys = createSystem();\n\n it('will read and write from a file, returning the correct status', async () => {\n await telemetry.enableTelemetry(sys);\n expect(await telemetry.checkTelemetry(sys)).toBe(true);\n await telemetry.disableTelemetry(sys);\n expect(await telemetry.checkTelemetry(sys)).toBe(false);\n await telemetry.enableTelemetry(sys);\n expect(await telemetry.checkTelemetry(sys)).toBe(true);\n });\n});\n\ndescribe('hasAppTarget()', () => {\n let config: d.ValidatedConfig;\n let sys: d.CompilerSystem;\n\n beforeEach(() => {\n sys = createSystem();\n config = mockValidatedConfig({ sys });\n });\n\n it(\"returns 'false' when `outputTargets` is empty\", () => {\n config.outputTargets = [];\n expect(telemetry.hasAppTarget(config)).toBe(false);\n });\n\n it(\"returns 'false' when `outputTargets` contains `www` with no `baseUrl` and no service worker\", () => {\n config.outputTargets = [{ type: WWW }];\n expect(telemetry.hasAppTarget(config)).toBe(false);\n });\n\n it(\"returns 'false' when `outputTargets` contains `www` with '/' baseUrl value\", () => {\n config.outputTargets = [{ type: WWW, baseUrl: '/' }];\n expect(telemetry.hasAppTarget(config)).toBe(false);\n });\n\n it(\"returns 'true' when `outputTargets` contains `www` with a service worker\", () => {\n config.outputTargets = [{ type: WWW, serviceWorker: { swDest: './tmp' } }];\n expect(telemetry.hasAppTarget(config)).toBe(true);\n });\n\n it(\"returns 'true' when `outputTargets` contains `www` with baseUrl\", () => {\n config.outputTargets = [{ type: WWW, baseUrl: 'https://example.com' }];\n expect(telemetry.hasAppTarget(config)).toBe(true);\n });\n\n it(\"returns 'true' when `outputTargets` contains `www` with serviceWorker and baseUrl\", () => {\n config.outputTargets = [{ type: WWW, baseUrl: 'https://example.com', serviceWorker: { swDest: './tmp' } }];\n expect(telemetry.hasAppTarget(config)).toBe(true);\n });\n});\n\ndescribe('prepareData', () => {\n let config: d.ValidatedConfig;\n let sys: d.CompilerSystem;\n\n beforeEach(() => {\n config = mockValidatedConfig();\n sys = config.sys;\n // set static name + versions, otherwise tests will pull in the dev build's data (which changes per build)\n sys.name = 'in-memory';\n sys.version = '__VERSION:STENCIL__';\n });\n\n it('prepares an object to send to ionic', async () => {\n const data = await telemetry.prepareData(coreCompiler, config, sys, 1000);\n expect(data).toEqual({\n arguments: [],\n build: coreCompiler.buildId,\n component_count: undefined,\n // the configuration generation is tested elsewhere, just verify we're sending something under this flag\n config: expect.any(Object),\n cpu_model: '',\n duration_ms: 1000,\n has_app_pwa_config: false,\n os_name: '',\n os_version: '',\n packages: [],\n packages_no_versions: [],\n rollup: coreCompiler.versions.rollup,\n stencil: coreCompiler.versions.stencil,\n system: 'in-memory __VERSION:STENCIL__',\n system_major: 'in-memory __VERSION:STENCIL__',\n targets: [],\n task: null,\n typescript: coreCompiler.versions.typescript,\n yarn: false,\n });\n });\n\n describe('has_app_pwa_config property', () => {\n it('sets `has_app_pwa_config` to true when there is a service worker', async () => {\n const config = mockValidatedConfig({\n outputTargets: [{ type: 'www', baseUrl: 'https://example.com' }],\n });\n\n const data = await telemetry.prepareData(coreCompiler, config, sys, 1000);\n\n expect(data.has_app_pwa_config).toBe(true);\n });\n\n it(\"sets `has_app_pwa_config` to true for a non '/' baseUrl\", async () => {\n const config = mockValidatedConfig({\n outputTargets: [{ type: 'www', serviceWorker: { swDest: './tmp' } }],\n });\n\n const data = await telemetry.prepareData(coreCompiler, config, sys, 1000);\n\n expect(data.has_app_pwa_config).toBe(true);\n });\n });\n\n it('sends a component count when one is provided', async () => {\n const COMPONENT_COUNT = 12;\n\n const config = mockValidatedConfig({\n outputTargets: [{ type: 'www' }],\n });\n\n const data = await telemetry.prepareData(coreCompiler, config, sys, 1000, COMPONENT_COUNT);\n\n expect(data.component_count).toEqual(COMPONENT_COUNT);\n });\n});\n\ndescribe('anonymizeConfigForTelemetry', () => {\n let config: d.ValidatedConfig;\n let sys: d.CompilerSystem;\n\n beforeEach(() => {\n sys = createSystem();\n config = mockValidatedConfig({ sys });\n });\n\n it.each([\n 'rootDir',\n 'fsNamespace',\n 'packageJsonFilePath',\n 'namespace',\n 'srcDir',\n 'srcIndexHtml',\n 'buildLogFilePath',\n 'cacheDir',\n 'configPath',\n 'tsconfig',\n ])(\"should anonymize top-level string prop '%s'\", (prop: keyof d.ValidatedConfig) => {\n const anonymizedConfig = anonymizeConfigForTelemetry({\n ...config,\n [prop]: \"shouldn't see this!\",\n outputTargets: [],\n });\n expect(anonymizedConfig[prop]).toBe('omitted');\n expect(anonymizedConfig.outputTargets).toEqual([]);\n });\n\n it.each([\n 'commonjs',\n 'devServer',\n 'env',\n 'logger',\n 'rollupConfig',\n 'sys',\n 'testing',\n 'tsCompilerOptions',\n ])(\"should remove objects under prop '%s'\", (prop: keyof d.ValidatedConfig) => {\n const anonymizedConfig = anonymizeConfigForTelemetry({ ...config, [prop]: {}, outputTargets: [] });\n expect(anonymizedConfig.hasOwnProperty(prop)).toBe(false);\n expect(anonymizedConfig.outputTargets).toEqual([]);\n });\n\n it('should retain outputTarget props on the keep list', () => {\n const anonymizedConfig = anonymizeConfigForTelemetry({\n ...config,\n outputTargets: [\n { type: WWW, baseUrl: 'https://example.com' },\n { type: DIST_HYDRATE_SCRIPT, external: ['beep', 'boop'], dir: 'shoud/go/away' },\n { type: DIST_CUSTOM_ELEMENTS },\n { type: DIST_CUSTOM_ELEMENTS, generateTypeDeclarations: true },\n { type: DIST, typesDir: 'my-types' },\n ],\n });\n\n expect(anonymizedConfig.outputTargets).toEqual([\n { type: WWW, baseUrl: 'omitted' },\n { type: DIST_HYDRATE_SCRIPT, external: ['beep', 'boop'], dir: 'omitted' },\n { type: DIST_CUSTOM_ELEMENTS },\n { type: DIST_CUSTOM_ELEMENTS, generateTypeDeclarations: true },\n { type: DIST, typesDir: 'omitted' },\n ]);\n });\n});\n"
},
{
"path": "src/cli/test/ionic-config.spec.ts",
"content": "import { mockCompilerSystem } from '@stencil/core/testing';\n\nimport { createSystem } from '../../compiler/sys/stencil-sys';\nimport { defaultConfig, readConfig, updateConfig, writeConfig } from '../ionic-config';\nimport { UUID_REGEX } from '../telemetry/helpers';\n\nconst UUID1 = '5588e0f0-02b5-4afa-8194-5d8f78683b36';\nconst UUID2 = 'e5609819-5c24-4fa2-8817-e05ca10b8cae';\n\ndescribe('readConfig', () => {\n const sys = mockCompilerSystem();\n\n beforeEach(async () => {\n await sys.removeFile(defaultConfig(sys));\n });\n\n it('should create a file if it does not exist', async () => {\n const result = await sys.stat(defaultConfig(sys));\n\n // expect the file to have been deleted by the test setup\n expect(result.isFile).toBe(false);\n\n const config = await readConfig(sys);\n\n expect(Object.keys(config).join()).toBe('tokens.telemetry,telemetry.stencil');\n });\n\n it(\"should fix the telemetry token if it's a string, but an invalid UUID\", async () => {\n await writeConfig(sys, { 'telemetry.stencil': true, 'tokens.telemetry': 'aaaa' });\n\n const result = await sys.stat(defaultConfig(sys));\n\n expect(result.isFile).toBe(true);\n\n const config = await readConfig(sys);\n\n expect(Object.keys(config).join()).toBe('telemetry.stencil,tokens.telemetry');\n expect(config['telemetry.stencil']).toBe(true);\n expect(config['tokens.telemetry']).toMatch(UUID_REGEX);\n });\n\n it('handles a non-string telemetry token', async () => {\n // our typings state that `tokens.telemetry` is of type `string | undefined`, but technically this value could be\n // anything. use `undefined` to make the typings happy (this should cover all non-string telemetry tokens). the\n // important thing here is that the value is _not_ a string for this test!\n await writeConfig(sys, { 'telemetry.stencil': true, 'tokens.telemetry': undefined });\n\n const config = await readConfig(sys);\n\n expect(Object.keys(config).join()).toBe('telemetry.stencil,tokens.telemetry');\n expect(config['telemetry.stencil']).toBe(true);\n expect(config['tokens.telemetry']).toMatch(UUID_REGEX);\n });\n\n it('handles a non-existent telemetry token', async () => {\n await writeConfig(sys, { 'telemetry.stencil': true });\n\n const config = await readConfig(sys);\n\n expect(Object.keys(config).join()).toBe('telemetry.stencil,tokens.telemetry');\n expect(config['telemetry.stencil']).toBe(true);\n expect(config['tokens.telemetry']).toMatch(UUID_REGEX);\n });\n\n it('should read a file if it exists', async () => {\n await writeConfig(sys, { 'telemetry.stencil': true, 'tokens.telemetry': UUID1 });\n\n const result = await sys.stat(defaultConfig(sys));\n\n expect(result.isFile).toBe(true);\n\n const config = await readConfig(sys);\n\n expect(Object.keys(config).join()).toBe('telemetry.stencil,tokens.telemetry');\n expect(config['telemetry.stencil']).toBe(true);\n expect(config['tokens.telemetry']).toBe(UUID1);\n });\n});\n\ndescribe('updateConfig', () => {\n const sys = createSystem();\n\n it('should edit a file', async () => {\n await writeConfig(sys, { 'telemetry.stencil': true, 'tokens.telemetry': UUID1 });\n\n const result = await sys.stat(defaultConfig(sys));\n\n expect(result.isFile).toBe(true);\n\n const configPre = await readConfig(sys);\n\n expect(typeof configPre).toBe('object');\n expect(Object.keys(configPre).join()).toBe('telemetry.stencil,tokens.telemetry');\n expect(configPre['telemetry.stencil']).toBe(true);\n expect(configPre['tokens.telemetry']).toBe(UUID1);\n\n await updateConfig(sys, { 'telemetry.stencil': false, 'tokens.telemetry': UUID2 });\n\n const configPost = await readConfig(sys);\n\n expect(typeof configPost).toBe('object');\n // Should keep the previous order\n expect(Object.keys(configPost).join()).toBe('telemetry.stencil,tokens.telemetry');\n expect(configPost['telemetry.stencil']).toBe(false);\n expect(configPost['tokens.telemetry']).toBe(UUID2);\n });\n});\n"
},
{
"path": "src/cli/test/parse-flags.spec.ts",
"content": "import { toDashCase } from '@utils';\n\nimport { LogLevel } from '../../declarations';\nimport {\n BOOLEAN_CLI_FLAGS,\n BOOLEAN_STRING_CLI_FLAGS,\n BooleanStringCLIFlag,\n ConfigFlags,\n NUMBER_CLI_FLAGS,\n STRING_ARRAY_CLI_FLAGS,\n STRING_CLI_FLAGS,\n StringArrayCLIFlag,\n} from '../config-flags';\nimport { Empty, parseEqualsArg, parseFlags } from '../parse-flags';\n\ndescribe('parseFlags', () => {\n it('should get known and unknown args', () => {\n const args = ['serve', '--address', '127.0.0.1', '--potatoArgument', '--flimflammery', 'test.spec.ts'];\n\n const flags = parseFlags(args);\n expect(flags.task).toBe('serve');\n expect(flags.args[0]).toBe('--address');\n expect(flags.args[1]).toBe('127.0.0.1');\n expect(flags.args[2]).toBe('--potatoArgument');\n expect(flags.args[3]).toBe('--flimflammery');\n expect(flags.args[4]).toBe('test.spec.ts');\n expect(flags.knownArgs).toEqual(['--address', '127.0.0.1']);\n expect(flags.unknownArgs[0]).toBe('--potatoArgument');\n expect(flags.unknownArgs[1]).toBe('--flimflammery');\n expect(flags.unknownArgs[2]).toBe('test.spec.ts');\n });\n\n it('should parse cli for dev server', () => {\n // user command line args\n // $ npm run serve --port 4444\n\n // args.slice(2)\n // [ 'serve', '--address', '127.0.0.1', '--port', '4444' ]\n\n const args = ['serve', '--address', '127.0.0.1', '--port', '4444'];\n\n const flags = parseFlags(args);\n expect(flags.task).toBe('serve');\n expect(flags.address).toBe('127.0.0.1');\n expect(flags.port).toBe(4444);\n expect(flags.knownArgs).toEqual(['--address', '127.0.0.1', '--port', '4444']);\n });\n\n it('should parse task', () => {\n const flags = parseFlags(['build']);\n expect(flags.task).toBe('build');\n });\n\n it('should parse no task', () => {\n const flags = parseFlags(['--flag']);\n expect(flags.task).toBe(null);\n });\n\n /**\n * these comprehensive tests of all the supported boolean args serve as\n * regression tests against duplicating any of the arguments in the arrays.\n * Because of the way that the arg parsing algorithm works having a dupe\n * will result in a value like `[true, true]` being set on ConfigFlags, which\n * will cause these tests to start failing.\n */\n describe.each(BOOLEAN_CLI_FLAGS)('should parse boolean flag %s', (cliArg) => {\n it('should parse arg', () => {\n const flags = parseFlags([`--${cliArg}`]);\n expect(flags.knownArgs).toEqual([`--${cliArg}`]);\n expect(flags[cliArg]).toBe(true);\n });\n\n it(`should parse --no${cliArg}`, () => {\n const negativeFlag = '--no' + cliArg.charAt(0).toUpperCase() + cliArg.slice(1);\n const flags = parseFlags([negativeFlag]);\n expect(flags.knownArgs).toEqual([negativeFlag]);\n expect(flags[cliArg]).toBe(false);\n });\n\n it(`should override --${cliArg} with --no${cliArg}`, () => {\n const negativeFlag = '--no' + cliArg.charAt(0).toUpperCase() + cliArg.slice(1);\n const flags = parseFlags([`--${cliArg}`, negativeFlag]);\n expect(flags.knownArgs).toEqual([`--${cliArg}`, negativeFlag]);\n expect(flags[cliArg]).toBe(false);\n });\n\n it('should not set value if not present', () => {\n const flags = parseFlags([]);\n expect(flags.knownArgs).toEqual([]);\n expect(flags[cliArg]).toBe(undefined);\n });\n\n it.each([true, false])(`should set the value with --${cliArg}=%p`, (value) => {\n const flags = parseFlags([`--${cliArg}=${value}`]);\n expect(flags.knownArgs).toEqual([`--${cliArg}`, String(value)]);\n expect(flags[cliArg]).toBe(value);\n });\n });\n\n describe.each(STRING_CLI_FLAGS)('should parse string flag %s', (cliArg) => {\n it(`should parse \"--${cliArg} value\"`, () => {\n const flags = parseFlags([`--${cliArg}`, 'test-value']);\n expect(flags.knownArgs).toEqual([`--${cliArg}`, 'test-value']);\n expect(flags.unknownArgs).toEqual([]);\n expect(flags[cliArg]).toBe('test-value');\n });\n\n it(`should parse \"--${cliArg}=value\"`, () => {\n const flags = parseFlags([`--${cliArg}=path/to/file.js`]);\n expect(flags.knownArgs).toEqual([`--${cliArg}`, 'path/to/file.js']);\n expect(flags.unknownArgs).toEqual([]);\n expect(flags[cliArg]).toBe('path/to/file.js');\n });\n\n it(`should parse \"--${toDashCase(cliArg)} value\"`, () => {\n const flags = parseFlags([`--${toDashCase(cliArg)}`, 'path/to/file.js']);\n expect(flags.knownArgs).toEqual([`--${toDashCase(cliArg)}`, 'path/to/file.js']);\n expect(flags.unknownArgs).toEqual([]);\n expect(flags[cliArg]).toBe('path/to/file.js');\n });\n\n it(`should parse \"--${toDashCase(cliArg)}=value\"`, () => {\n const flags = parseFlags([`--${toDashCase(cliArg)}=path/to/file.js`]);\n expect(flags.knownArgs).toEqual([`--${toDashCase(cliArg)}`, 'path/to/file.js']);\n expect(flags.unknownArgs).toEqual([]);\n expect(flags[cliArg]).toBe('path/to/file.js');\n });\n });\n\n it.each(NUMBER_CLI_FLAGS)('should parse number flag %s', (cliArg) => {\n const flags = parseFlags([`--${cliArg}`, '42']);\n expect(flags.knownArgs).toEqual([`--${cliArg}`, '42']);\n expect(flags.unknownArgs).toEqual([]);\n expect(flags[cliArg]).toBe(42);\n });\n\n it('should override --config with second --config', () => {\n const args = ['--config', '/config-1.js', '--config', '/config-2.js'];\n const flags = parseFlags(args);\n expect(flags.config).toBe('/config-2.js');\n });\n\n describe.each(BOOLEAN_STRING_CLI_FLAGS)('boolean-string flag - %s', (cliArg: BooleanStringCLIFlag) => {\n it('parses a boolean-string flag as a boolean with no arg', () => {\n const args = [`--${cliArg}`];\n const flags = parseFlags(args);\n expect(flags[cliArg]).toBe(true);\n expect(flags.knownArgs).toEqual([`--${cliArg}`]);\n });\n\n it(`parses a boolean-string flag as a falsy boolean with \"no\" arg - --no-${cliArg}`, () => {\n const args = [`--no-${cliArg}`];\n const flags = parseFlags(args);\n expect(flags[cliArg]).toBe(false);\n expect(flags.knownArgs).toEqual([`--no-${cliArg}`]);\n });\n\n it(`parses a boolean-string flag as a falsy boolean with \"no\" arg - --no${\n cliArg.charAt(0).toUpperCase() + cliArg.slice(1)\n }`, () => {\n const negativeFlag = '--no' + cliArg.charAt(0).toUpperCase() + cliArg.slice(1);\n const flags = parseFlags([negativeFlag]);\n expect(flags[cliArg]).toBe(false);\n expect(flags.knownArgs).toEqual([negativeFlag]);\n });\n\n it('parses a boolean-string flag as a string with a string arg', () => {\n const args = [`--${cliArg}`, 'shell'];\n const flags = parseFlags(args);\n expect(flags[cliArg]).toBe('shell');\n expect(flags.knownArgs).toEqual([`--${cliArg}`, 'shell']);\n });\n\n it('parses a boolean-string flag as a string with a string arg using equality', () => {\n const args = [`--${cliArg}=shell`];\n const flags = parseFlags(args);\n expect(flags[cliArg]).toBe('shell');\n expect(flags.knownArgs).toEqual([`--${cliArg}`, 'shell']);\n });\n });\n\n describe.each(['info', 'warn', 'error', 'debug'])('logLevel %s', (level) => {\n it(\"should parse '--logLevel %s'\", () => {\n const args = ['--logLevel', level];\n const flags = parseFlags(args);\n expect(flags.logLevel).toBe(level);\n });\n\n it('should parse --logLevel=%s', () => {\n const args = [`--logLevel=${level}`];\n const flags = parseFlags(args);\n expect(flags.logLevel).toBe(level);\n });\n\n it(\"should parse '--log-level %s'\", () => {\n const flags = parseFlags(['--log-level', level]);\n expect(flags.logLevel).toBe(level);\n });\n\n it('should parse --log-level=%s', () => {\n const flags = parseFlags([`--log-level=${level}`]);\n expect(flags.logLevel).toBe(level);\n });\n });\n\n /**\n * maxWorkers is (as of this writing) our only StringNumberCLIArg, meaning it\n * may be a string (like \"50%\") or a number (like 4). For this reason we have\n * some tests just for it.\n */\n describe('maxWorkers', () => {\n it.each([\n ['--maxWorkers', '4'],\n ['--maxWorkers=4'],\n ['--max-workers', '4'],\n ['--maxWorkers', '4e+0'],\n ['--maxWorkers', '40e-1'],\n ])('should parse %p, %p', (...args) => {\n const flags = parseFlags(args);\n expect(flags.maxWorkers).toBe(4);\n });\n\n it('should parse --maxWorkers 4', () => {\n const flags = parseFlags(['--maxWorkers', '4']);\n expect(flags.maxWorkers).toBe(4);\n });\n\n it('should parse --maxWorkers=4', () => {\n const flags = parseFlags(['--maxWorkers=4']);\n expect(flags.maxWorkers).toBe(4);\n });\n\n it('should parse --max-workers 4', () => {\n const flags = parseFlags(['--max-workers', '4']);\n expect(flags.maxWorkers).toBe(4);\n });\n\n it('should parse --maxWorkers=50%', function () {\n // see https://jestjs.io/docs/27.x/cli#--maxworkersnumstring\n const flags = parseFlags(['--maxWorkers=50%']);\n expect(flags.maxWorkers).toBe('50%');\n });\n\n it('should parse --max-workers=1', () => {\n const flags = parseFlags(['--max-workers=1']);\n expect(flags.maxWorkers).toBe(1);\n });\n\n it('should not parse --max-workers', () => {\n const flags = parseFlags([]);\n expect(flags.maxWorkers).toBe(undefined);\n });\n });\n\n describe('aliases', () => {\n describe('-p (alias for port)', () => {\n it('should parse -p=4444', () => {\n const flags = parseFlags(['-p=4444']);\n expect(flags.port).toBe(4444);\n });\n it('should parse -p 4444', () => {\n const flags = parseFlags(['-p', '4444']);\n expect(flags.port).toBe(4444);\n });\n });\n\n it('should parse -h (alias for help)', () => {\n const flags = parseFlags(['-h']);\n expect(flags.help).toBe(true);\n });\n\n it('should parse -v (alias for version)', () => {\n const flags = parseFlags(['-v']);\n expect(flags.version).toBe(true);\n });\n\n describe('-c alias for config', () => {\n it('should parse -c /my-config.js', () => {\n const flags = parseFlags(['-c', '/my-config.js']);\n expect(flags.config).toBe('/my-config.js');\n expect(flags.knownArgs).toEqual(['--config', '/my-config.js']);\n });\n\n it('should parse -c=/my-config.js', () => {\n const flags = parseFlags(['-c=/my-config.js']);\n expect(flags.config).toBe('/my-config.js');\n expect(flags.knownArgs).toEqual(['--config', '/my-config.js']);\n });\n });\n\n describe('Jest aliases', () => {\n it.each([\n ['w', 'maxWorkers', '4'],\n ['t', 'testNamePattern', 'testname'],\n ])('should support the string Jest alias %p for %p', (alias, fullArgument, value) => {\n const flags = parseFlags([`-${alias}`, value]);\n expect(flags.knownArgs).toEqual([`--${fullArgument}`, value]);\n expect(flags.unknownArgs).toHaveLength(0);\n });\n\n it.each([\n ['w', 'maxWorkers', '4'],\n ['t', 'testNamePattern', 'testname'],\n ])('should support the string Jest alias %p for %p in an AliasEqualsArg', (alias, fullArgument, value) => {\n const flags = parseFlags([`-${alias}=${value}`]);\n expect(flags.knownArgs).toEqual([`--${fullArgument}`, value]);\n expect(flags.unknownArgs).toHaveLength(0);\n });\n\n it.each<[string, keyof ConfigFlags]>([\n ['b', 'bail'],\n ['e', 'expand'],\n ['o', 'onlyChanged'],\n ['f', 'onlyFailures'],\n ['i', 'runInBand'],\n ['u', 'updateSnapshot'],\n ])('should support the boolean Jest alias %p for %p', (alias, fullArgument) => {\n const flags = parseFlags([`-${alias}`]);\n expect(flags.knownArgs).toEqual([`--${fullArgument}`]);\n expect(flags[fullArgument]).toBe(true);\n expect(flags.unknownArgs).toHaveLength(0);\n });\n });\n });\n\n it('should parse many', () => {\n const args = ['-v', '--help', '-c=./myconfig.json'];\n const flags = parseFlags(args);\n expect(flags.version).toBe(true);\n expect(flags.help).toBe(true);\n expect(flags.config).toBe('./myconfig.json');\n });\n\n describe('parseEqualsArg', () => {\n it.each([\n ['--fooBar=baz', '--fooBar', 'baz'],\n ['--foo-bar=4', '--foo-bar', '4'],\n ['--fooBar=twenty=3*4', '--fooBar', 'twenty=3*4'],\n ['--fooBar', '--fooBar', Empty],\n ['--foo-bar', '--foo-bar', Empty],\n ['--foo-bar=\"\"', '--foo-bar', '\"\"'],\n ])('should parse %s correctly', (testArg, expectedArg, expectedValue) => {\n const [arg, value] = parseEqualsArg(testArg);\n expect(arg).toBe(expectedArg);\n expect(value).toEqual(expectedValue);\n });\n });\n\n describe.each(STRING_ARRAY_CLI_FLAGS)('should parse string flag %s', (cliArg: StringArrayCLIFlag) => {\n it(`should parse single value: \"--${cliArg} test-value\"`, () => {\n const flags = parseFlags([`--${cliArg}`, 'test-value']);\n expect(flags.knownArgs).toEqual([`--${cliArg}`, 'test-value']);\n expect(flags.unknownArgs).toEqual([]);\n expect(flags[cliArg]).toEqual(['test-value']);\n });\n\n it(`should parse multiple values: \"--${cliArg} test-value\"`, () => {\n const flags = parseFlags([`--${cliArg}`, 'test-value', `--${cliArg}`, 'second-test-value']);\n expect(flags.knownArgs).toEqual([`--${cliArg}`, 'test-value', `--${cliArg}`, 'second-test-value']);\n expect(flags.unknownArgs).toEqual([]);\n expect(flags[cliArg]).toEqual(['test-value', 'second-test-value']);\n });\n\n it(`should parse \"--${cliArg}=value\"`, () => {\n const flags = parseFlags([`--${cliArg}=path/to/file.js`]);\n expect(flags.knownArgs).toEqual([`--${cliArg}`, 'path/to/file.js']);\n expect(flags.unknownArgs).toEqual([]);\n expect(flags[cliArg]).toEqual(['path/to/file.js']);\n });\n\n it(`should parse multiple values: \"--${cliArg}=test-value\"`, () => {\n const flags = parseFlags([`--${cliArg}=test-value`, `--${cliArg}=second-test-value`]);\n expect(flags.knownArgs).toEqual([`--${cliArg}`, 'test-value', `--${cliArg}`, 'second-test-value']);\n expect(flags.unknownArgs).toEqual([]);\n expect(flags[cliArg]).toEqual(['test-value', 'second-test-value']);\n });\n\n it(`should parse \"--${toDashCase(cliArg)} value\"`, () => {\n const flags = parseFlags([`--${toDashCase(cliArg)}`, 'path/to/file.js']);\n expect(flags.knownArgs).toEqual([`--${toDashCase(cliArg)}`, 'path/to/file.js']);\n expect(flags.unknownArgs).toEqual([]);\n expect(flags[cliArg]).toEqual(['path/to/file.js']);\n });\n\n it(`should parse multiple values: \"--${toDashCase(cliArg)} test-value\"`, () => {\n const flags = parseFlags([\n `--${toDashCase(cliArg)}`,\n 'test-value',\n `--${toDashCase(cliArg)}`,\n 'second-test-value',\n ]);\n expect(flags.knownArgs).toEqual([\n `--${toDashCase(cliArg)}`,\n 'test-value',\n `--${toDashCase(cliArg)}`,\n 'second-test-value',\n ]);\n expect(flags.unknownArgs).toEqual([]);\n expect(flags[cliArg]).toEqual(['test-value', 'second-test-value']);\n });\n\n it(`should parse \"--${toDashCase(cliArg)}=value\"`, () => {\n const flags = parseFlags([`--${toDashCase(cliArg)}=path/to/file.js`]);\n expect(flags.knownArgs).toEqual([`--${toDashCase(cliArg)}`, 'path/to/file.js']);\n expect(flags.unknownArgs).toEqual([]);\n expect(flags[cliArg]).toEqual(['path/to/file.js']);\n });\n\n it(`should parse multiple values: \"--${toDashCase(cliArg)}=test-value\"`, () => {\n const flags = parseFlags([`--${toDashCase(cliArg)}=test-value`, `--${toDashCase(cliArg)}=second-test-value`]);\n expect(flags.knownArgs).toEqual([\n `--${toDashCase(cliArg)}`,\n 'test-value',\n `--${toDashCase(cliArg)}`,\n 'second-test-value',\n ]);\n expect(flags.unknownArgs).toEqual([]);\n expect(flags[cliArg]).toEqual(['test-value', 'second-test-value']);\n });\n });\n\n describe('error reporting', () => {\n it('should throw if you pass no argument to a string flag', () => {\n expect(() => {\n parseFlags(['--cacheDirectory', '--someOtherFlag']);\n }).toThrow('when parsing CLI flag \"--cacheDirectory\": expected a string argument but received nothing');\n });\n\n it('should throw if you pass no argument to a string array flag', () => {\n expect(() => {\n parseFlags(['--reporters', '--someOtherFlag']);\n }).toThrow('when parsing CLI flag \"--reporters\": expected a string argument but received nothing');\n });\n\n it('should throw if you pass no argument to a number flag', () => {\n expect(() => {\n parseFlags(['--port', '--someOtherFlag']);\n }).toThrow('when parsing CLI flag \"--port\": expected a number argument but received nothing');\n });\n\n it('should throw if you pass a non-number argument to a number flag', () => {\n expect(() => {\n parseFlags(['--port', 'stringy']);\n }).toThrow('when parsing CLI flag \"--port\": expected a number but received \"stringy\"');\n });\n\n it('should throw if you pass a bad number argument to a number flag', () => {\n expect(() => {\n parseFlags(['--port=NaN']);\n }).toThrow('when parsing CLI flag \"--port\": expected a number but received \"NaN\"');\n });\n\n it('should throw if you pass no argument to a string/number flag', () => {\n expect(() => {\n parseFlags(['--maxWorkers']);\n }).toThrow('when parsing CLI flag \"--maxWorkers\": expected a string or a number but received nothing');\n });\n\n it('should throw if you pass an invalid log level for --logLevel', () => {\n expect(() => {\n parseFlags(['--logLevel', 'potato']);\n }).toThrow('when parsing CLI flag \"--logLevel\": expected to receive a valid log level but received \"potato\"');\n });\n\n it('should throw if you pass no argument to --logLevel', () => {\n expect(() => {\n parseFlags(['--logLevel']);\n }).toThrow('when parsing CLI flag \"--logLevel\": expected to receive a valid log level but received nothing');\n });\n });\n});\n"
},
{
"path": "src/cli/test/run.spec.ts",
"content": "import * as coreCompiler from '@stencil/core/compiler';\nimport { mockCompilerSystem, mockConfig, mockLogger as createMockLogger } from '@stencil/core/testing';\n\nimport type * as d from '../../declarations';\nimport { createTestingSystem } from '../../testing/testing-sys';\nimport { createConfigFlags } from '../config-flags';\nimport * as ParseFlags from '../parse-flags';\nimport { run, runTask } from '../run';\nimport * as BuildTask from '../task-build';\nimport * as DocsTask from '../task-docs';\nimport * as GenerateTask from '../task-generate';\nimport * as HelpTask from '../task-help';\nimport * as PrerenderTask from '../task-prerender';\nimport * as ServeTask from '../task-serve';\nimport * as TelemetryTask from '../task-telemetry';\nimport * as TestTask from '../task-test';\n\ndescribe('run', () => {\n describe('run()', () => {\n let cliInitOptions: d.CliInitOptions;\n let mockLogger: d.Logger;\n let mockSystem: d.CompilerSystem;\n\n let parseFlagsSpy: jest.SpyInstance<\n ReturnType,\n Parameters\n >;\n\n beforeEach(() => {\n mockLogger = createMockLogger();\n mockSystem = createTestingSystem();\n\n cliInitOptions = {\n args: [],\n logger: mockLogger,\n sys: mockSystem,\n };\n\n parseFlagsSpy = jest.spyOn(ParseFlags, 'parseFlags');\n parseFlagsSpy.mockReturnValue(\n createConfigFlags({\n // use the 'help' task as a reasonable default for all calls to this function.\n // code paths that require a different task can always override this value as needed.\n task: 'help',\n }),\n );\n });\n\n afterEach(() => {\n parseFlagsSpy.mockRestore();\n });\n\n describe('help task', () => {\n let taskHelpSpy: jest.SpyInstance, Parameters>;\n\n beforeEach(() => {\n taskHelpSpy = jest.spyOn(HelpTask, 'taskHelp');\n taskHelpSpy.mockReturnValue(Promise.resolve());\n });\n\n afterEach(() => {\n taskHelpSpy.mockRestore();\n });\n\n it(\"calls the help task when the 'task' field is set to 'help'\", async () => {\n await run(cliInitOptions);\n\n expect(taskHelpSpy).toHaveBeenCalledTimes(1);\n expect(taskHelpSpy).toHaveBeenCalledWith(\n {\n task: 'help',\n args: [],\n knownArgs: [],\n unknownArgs: [],\n },\n mockLogger,\n mockSystem,\n );\n\n taskHelpSpy.mockRestore();\n });\n\n it(\"calls the help task when the 'task' field is set to null\", async () => {\n parseFlagsSpy.mockReturnValue(\n createConfigFlags({\n task: null,\n }),\n );\n\n await run(cliInitOptions);\n\n expect(taskHelpSpy).toHaveBeenCalledTimes(1);\n expect(taskHelpSpy).toHaveBeenCalledWith(\n {\n task: 'help',\n args: [],\n knownArgs: [],\n unknownArgs: [],\n },\n mockLogger,\n mockSystem,\n );\n\n taskHelpSpy.mockRestore();\n });\n\n it(\"calls the help task when the 'help' field is set on flags\", async () => {\n parseFlagsSpy.mockReturnValue(\n createConfigFlags({\n help: true,\n }),\n );\n\n await run(cliInitOptions);\n\n expect(taskHelpSpy).toHaveBeenCalledTimes(1);\n expect(taskHelpSpy).toHaveBeenCalledWith(\n {\n task: 'help',\n args: [],\n unknownArgs: [],\n knownArgs: [],\n },\n mockLogger,\n mockSystem,\n );\n\n taskHelpSpy.mockRestore();\n });\n });\n });\n\n describe('runTask()', () => {\n let sys: d.CompilerSystem;\n let unvalidatedConfig: d.UnvalidatedConfig;\n\n let taskBuildSpy: jest.SpyInstance, Parameters>;\n let taskDocsSpy: jest.SpyInstance, Parameters>;\n let taskGenerateSpy: jest.SpyInstance<\n ReturnType,\n Parameters\n >;\n let taskHelpSpy: jest.SpyInstance, Parameters>;\n let taskPrerenderSpy: jest.SpyInstance<\n ReturnType,\n Parameters\n >;\n let taskServeSpy: jest.SpyInstance, Parameters>;\n let taskTelemetrySpy: jest.SpyInstance<\n ReturnType,\n Parameters\n >;\n let taskTestSpy: jest.SpyInstance, Parameters>;\n\n beforeEach(() => {\n sys = mockCompilerSystem();\n sys.exit = jest.fn();\n\n unvalidatedConfig = mockConfig({ outputTargets: [], sys, fsNamespace: 'testing' });\n\n taskBuildSpy = jest.spyOn(BuildTask, 'taskBuild');\n taskBuildSpy.mockResolvedValue();\n\n taskDocsSpy = jest.spyOn(DocsTask, 'taskDocs');\n taskDocsSpy.mockResolvedValue();\n\n taskGenerateSpy = jest.spyOn(GenerateTask, 'taskGenerate');\n taskGenerateSpy.mockResolvedValue();\n\n taskHelpSpy = jest.spyOn(HelpTask, 'taskHelp');\n taskHelpSpy.mockResolvedValue();\n\n taskPrerenderSpy = jest.spyOn(PrerenderTask, 'taskPrerender');\n taskPrerenderSpy.mockResolvedValue();\n\n taskServeSpy = jest.spyOn(ServeTask, 'taskServe');\n taskServeSpy.mockResolvedValue();\n\n taskTelemetrySpy = jest.spyOn(TelemetryTask, 'taskTelemetry');\n taskTelemetrySpy.mockResolvedValue();\n\n taskTestSpy = jest.spyOn(TestTask, 'taskTest');\n taskTestSpy.mockResolvedValue();\n });\n\n afterEach(() => {\n taskBuildSpy.mockRestore();\n taskDocsSpy.mockRestore();\n taskGenerateSpy.mockRestore();\n taskHelpSpy.mockRestore();\n taskPrerenderSpy.mockRestore();\n taskServeSpy.mockRestore();\n taskTelemetrySpy.mockRestore();\n taskTestSpy.mockRestore();\n });\n\n describe('default configuration', () => {\n describe('sys property', () => {\n it('uses the sys argument if one is provided', async () => {\n // remove the `CompilerSystem` on the config, just to be sure we don't accidentally use it\n unvalidatedConfig.sys = undefined;\n\n await runTask(coreCompiler, unvalidatedConfig, 'build', sys);\n const validated = coreCompiler.validateConfig(unvalidatedConfig, { sys });\n\n // first validate there was one call, and that call had two arguments\n expect(taskBuildSpy).toHaveBeenCalledTimes(1);\n expect(taskBuildSpy).toHaveBeenCalledWith(coreCompiler, validated.config);\n\n const compilerSystemUsed: d.CompilerSystem = taskBuildSpy.mock.calls[0][1].sys;\n expect(compilerSystemUsed).toBe(sys);\n });\n });\n });\n\n it('calls the build task', async () => {\n await runTask(coreCompiler, unvalidatedConfig, 'build', sys);\n const validated = coreCompiler.validateConfig(unvalidatedConfig, {});\n\n expect(taskBuildSpy).toHaveBeenCalledTimes(1);\n expect(taskBuildSpy).toHaveBeenCalledWith(coreCompiler, validated.config);\n });\n\n it('calls the docs task', async () => {\n await runTask(coreCompiler, unvalidatedConfig, 'docs', sys);\n const validated = coreCompiler.validateConfig(unvalidatedConfig, {});\n\n expect(taskDocsSpy).toHaveBeenCalledTimes(1);\n expect(taskDocsSpy).toHaveBeenCalledWith(coreCompiler, validated.config);\n });\n\n describe('generate task', () => {\n it(\"calls the generate task for the argument 'generate'\", async () => {\n await runTask(coreCompiler, unvalidatedConfig, 'generate', sys);\n const validated = coreCompiler.validateConfig(unvalidatedConfig, {});\n\n expect(taskGenerateSpy).toHaveBeenCalledTimes(1);\n expect(taskGenerateSpy).toHaveBeenCalledWith(validated.config);\n });\n\n it(\"calls the generate task for the argument 'g'\", async () => {\n await runTask(coreCompiler, unvalidatedConfig, 'g', sys);\n const validated = coreCompiler.validateConfig(unvalidatedConfig, {});\n\n expect(taskGenerateSpy).toHaveBeenCalledTimes(1);\n expect(taskGenerateSpy).toHaveBeenCalledWith(validated.config);\n });\n });\n\n it('calls the help task', async () => {\n await runTask(coreCompiler, unvalidatedConfig, 'help', sys);\n const validated = coreCompiler.validateConfig(unvalidatedConfig, {});\n\n expect(taskHelpSpy).toHaveBeenCalledTimes(1);\n expect(taskHelpSpy).toHaveBeenCalledWith(validated.config.flags, validated.config.logger, sys);\n });\n\n it('calls the prerender task', async () => {\n await runTask(coreCompiler, unvalidatedConfig, 'prerender', sys);\n const validated = coreCompiler.validateConfig(unvalidatedConfig, {});\n\n expect(taskPrerenderSpy).toHaveBeenCalledTimes(1);\n expect(taskPrerenderSpy).toHaveBeenCalledWith(coreCompiler, validated.config);\n });\n\n it('calls the serve task', async () => {\n await runTask(coreCompiler, unvalidatedConfig, 'serve', sys);\n\n expect(taskServeSpy).toHaveBeenCalledTimes(1);\n expect(taskServeSpy).toHaveBeenCalledWith(coreCompiler.validateConfig(unvalidatedConfig, {}).config);\n });\n\n describe('telemetry task', () => {\n it('calls the telemetry task when a compiler system is present', async () => {\n await runTask(coreCompiler, unvalidatedConfig, 'telemetry', sys);\n const validated = coreCompiler.validateConfig(unvalidatedConfig, {});\n\n expect(taskTelemetrySpy).toHaveBeenCalledTimes(1);\n expect(taskTelemetrySpy).toHaveBeenCalledWith(validated.config.flags, sys, validated.config.logger);\n });\n });\n\n it('calls the test task', async () => {\n await runTask(coreCompiler, unvalidatedConfig, 'test', sys);\n\n expect(taskTestSpy).toHaveBeenCalledTimes(1);\n expect(taskTestSpy).toHaveBeenCalledWith(coreCompiler.validateConfig(unvalidatedConfig, {}).config);\n });\n\n it('defaults to the help task for an unaccounted for task name', async () => {\n // info is a valid task name, but isn't used in the `switch` statement of `runTask`\n await runTask(coreCompiler, unvalidatedConfig, 'info', sys);\n const validated = coreCompiler.validateConfig(unvalidatedConfig, {});\n\n expect(taskHelpSpy).toHaveBeenCalledTimes(1);\n expect(taskHelpSpy).toHaveBeenCalledWith(validated.config.flags, validated.config.logger, sys);\n });\n\n it('defaults to the provided task if no flags exist on the provided config', async () => {\n unvalidatedConfig = mockConfig({ flags: undefined, sys });\n\n await runTask(coreCompiler, unvalidatedConfig, 'help', sys);\n const validated = coreCompiler.validateConfig(unvalidatedConfig, {});\n\n expect(taskHelpSpy).toHaveBeenCalledTimes(1);\n expect(taskHelpSpy).toHaveBeenCalledWith(createConfigFlags({ task: 'help' }), validated.config.logger, sys);\n });\n });\n});\n"
},
{
"path": "src/cli/test/task-generate.spec.ts",
"content": "import { mockCompilerSystem, mockValidatedConfig } from '@stencil/core/testing';\n\nimport type * as d from '../../declarations';\nimport * as utils from '../../utils/validation';\nimport { createConfigFlags } from '../config-flags';\nimport { BoilerplateFile, getBoilerplateByExtension, taskGenerate } from '../task-generate';\n\nconst promptMock = jest.fn().mockResolvedValue('my-component');\n\njest.mock('prompts', () => ({\n prompt: promptMock,\n}));\n\nlet formatToPick = 'css';\n\nconst setup = async (plugins: any[] = []) => {\n const sys = mockCompilerSystem();\n const config: d.ValidatedConfig = mockValidatedConfig({\n configPath: '/testing-path',\n flags: createConfigFlags({ task: 'generate' }),\n srcDir: '/src',\n sys,\n plugins,\n });\n\n // set up some mocks / spies\n config.sys.exit = jest.fn();\n const errorSpy = jest.spyOn(config.logger, 'error');\n const validateTagSpy = jest.spyOn(utils, 'validateComponentTag').mockReturnValue(undefined);\n\n // mock prompt usage: tagName and filesToGenerate are the keys used for\n // different calls, so we can cheat here and just do a single\n // mockResolvedValue\n let format = formatToPick;\n promptMock.mockImplementation((params) => {\n if (params.name === 'sassFormat') {\n format = 'sass';\n return { sassFormat: 'sass' };\n }\n return {\n tagName: 'my-component',\n filesToGenerate: [format, 'spec.tsx', 'e2e.ts'],\n };\n });\n\n return { config, errorSpy, validateTagSpy };\n};\n\n/**\n * Little test helper function which just temporarily silences\n * console.log calls, so we can avoid spewing a bunch of stuff.\n * @param config the user-supplied config to forward to `taskGenerate`\n */\nasync function silentGenerate(config: d.ValidatedConfig): Promise {\n const tmp = console.log;\n console.log = jest.fn();\n await taskGenerate(config);\n console.log = tmp;\n}\n\ndescribe('generate task', () => {\n afterEach(() => {\n jest.restoreAllMocks();\n jest.clearAllMocks();\n jest.resetModules();\n formatToPick = 'css';\n });\n\n afterAll(() => {\n jest.resetAllMocks();\n });\n\n it('should exit with an error if no `configPath` is supplied', async () => {\n const { config, errorSpy } = await setup();\n config.configPath = undefined;\n await taskGenerate(config);\n expect(config.sys.exit).toHaveBeenCalledWith(1);\n expect(errorSpy).toHaveBeenCalledWith(\n 'Please run this command in your root directory (i. e. the one containing stencil.config.ts).',\n );\n });\n\n it('should exit with an error if no `srcDir` is supplied', async () => {\n const { config, errorSpy } = await setup();\n config.srcDir = undefined;\n await taskGenerate(config);\n expect(config.sys.exit).toHaveBeenCalledWith(1);\n expect(errorSpy).toHaveBeenCalledWith(\"Stencil's srcDir was not specified.\");\n });\n\n it('should exit with an error if the component name does not validate', async () => {\n const { config, errorSpy, validateTagSpy } = await setup();\n validateTagSpy.mockReturnValue('error error error');\n await taskGenerate(config);\n expect(config.sys.exit).toHaveBeenCalledWith(1);\n expect(errorSpy).toHaveBeenCalledWith('error error error');\n });\n\n it.each([true, false])('should create a directory for the generated components', async (includeTests) => {\n const { config } = await setup();\n if (!includeTests) {\n promptMock.mockResolvedValue({\n tagName: 'my-component',\n // simulate the user picking only the css option\n filesToGenerate: ['css'],\n });\n }\n\n const createDirSpy = jest.spyOn(config.sys, 'createDir');\n await silentGenerate(config);\n expect(createDirSpy).toHaveBeenCalledWith(\n includeTests ? `${config.srcDir}/components/my-component/test` : `${config.srcDir}/components/my-component`,\n { recursive: true },\n );\n });\n\n it('should generate the files the user picked', async () => {\n const { config } = await setup();\n const writeFileSpy = jest.spyOn(config.sys, 'writeFile');\n await silentGenerate(config);\n const userChoices: ReadonlyArray = [\n { extension: 'tsx', path: '/src/components/my-component/my-component.tsx' },\n { extension: 'css', path: '/src/components/my-component/my-component.css' },\n { extension: 'spec.tsx', path: '/src/components/my-component/test/my-component.spec.tsx' },\n { extension: 'e2e.ts', path: '/src/components/my-component/test/my-component.e2e.ts' },\n ];\n\n userChoices.forEach((file) => {\n expect(writeFileSpy).toHaveBeenCalledWith(\n file.path,\n getBoilerplateByExtension('my-component', file.extension, true, 'css'),\n );\n });\n });\n\n it('should error without writing anything if a to-be-generated file is already present', async () => {\n const { config, errorSpy } = await setup();\n jest.spyOn(config.sys, 'readFile').mockResolvedValue('some file contents');\n await silentGenerate(config);\n expect(errorSpy).toHaveBeenCalledWith(\n 'Generating code would overwrite the following files:',\n '\\t/src/components/my-component/my-component.tsx',\n '\\t/src/components/my-component/my-component.css',\n '\\t/src/components/my-component/test/my-component.spec.tsx',\n '\\t/src/components/my-component/test/my-component.e2e.ts',\n );\n expect(config.sys.exit).toHaveBeenCalledWith(1);\n });\n\n it('should generate files for sass projects', async () => {\n const { config } = await setup([{ name: 'sass' }]);\n const writeFileSpy = jest.spyOn(config.sys, 'writeFile');\n await silentGenerate(config);\n const userChoices: ReadonlyArray = [\n { extension: 'tsx', path: '/src/components/my-component/my-component.tsx' },\n { extension: 'sass', path: '/src/components/my-component/my-component.sass' },\n { extension: 'spec.tsx', path: '/src/components/my-component/test/my-component.spec.tsx' },\n { extension: 'e2e.ts', path: '/src/components/my-component/test/my-component.e2e.ts' },\n ];\n\n userChoices.forEach((file) => {\n expect(writeFileSpy).toHaveBeenCalledWith(\n file.path,\n getBoilerplateByExtension('my-component', file.extension, true, 'sass'),\n );\n });\n });\n\n it('should generate files for less projects', async () => {\n formatToPick = 'less';\n const { config } = await setup([{ name: 'less' }]);\n const writeFileSpy = jest.spyOn(config.sys, 'writeFile');\n await silentGenerate(config);\n const userChoices: ReadonlyArray = [\n { extension: 'tsx', path: '/src/components/my-component/my-component.tsx' },\n { extension: 'less', path: '/src/components/my-component/my-component.less' },\n { extension: 'spec.tsx', path: '/src/components/my-component/test/my-component.spec.tsx' },\n { extension: 'e2e.ts', path: '/src/components/my-component/test/my-component.e2e.ts' },\n ];\n\n userChoices.forEach((file) => {\n expect(writeFileSpy).toHaveBeenCalledWith(\n file.path,\n getBoilerplateByExtension('my-component', file.extension, true, 'less'),\n );\n });\n });\n});\n"
},
{
"path": "src/client/client-build.ts",
"content": "import { BUILD } from '@app-data';\n\nimport type * as d from '../declarations';\n\nexport const Build: d.UserBuildConditionals = {\n isDev: BUILD.isDev ? true : false,\n isBrowser: true,\n isServer: false,\n isTesting: BUILD.isTesting ? true : false,\n};\n"
},
{
"path": "src/client/client-host-ref.ts",
"content": "import { BUILD } from '@app-data';\nimport { CMP_FLAGS } from '@utils/constants';\nimport { reWireGetterSetter } from '@utils/es2022-rewire-class-members';\n\nimport type * as d from '../declarations';\n\n/**\n * Given a {@link d.RuntimeRef} retrieve the corresponding {@link d.HostRef}\n *\n * @param ref the runtime ref of interest\n * @returns the Host reference (if found) or undefined\n */\nexport const getHostRef = (ref: d.RuntimeRef): d.HostRef | undefined => {\n if (ref.__stencil__getHostRef) {\n return ref.__stencil__getHostRef();\n }\n\n return undefined;\n};\n\n/**\n * Register a lazy instance with the {@link hostRefs} object so it's\n * corresponding {@link d.HostRef} can be retrieved later.\n *\n * @param lazyInstance the lazy instance of interest\n * @param hostRef that instances `HostRef` object\n */\nexport const registerInstance = (lazyInstance: any, hostRef: d.HostRef) => {\n if (!hostRef) return;\n lazyInstance.__stencil__getHostRef = () => hostRef;\n hostRef.$lazyInstance$ = lazyInstance;\n\n if (hostRef.$cmpMeta$.$flags$ & CMP_FLAGS.hasModernPropertyDecls && (BUILD.state || BUILD.prop)) {\n reWireGetterSetter(lazyInstance, hostRef);\n }\n};\n\n/**\n * Register a host element for a Stencil component, setting up various metadata\n * and callbacks based on {@link BUILD} flags as well as the component's runtime\n * metadata.\n *\n * @param hostElement the host element to register\n * @param cmpMeta runtime metadata for that component\n * @returns a reference to the host ref WeakMap\n */\nexport const registerHost = (hostElement: d.HostElement, cmpMeta: d.ComponentRuntimeMeta) => {\n const hostRef: d.HostRef = {\n $flags$: 0,\n $hostElement$: hostElement,\n $cmpMeta$: cmpMeta,\n $instanceValues$: new Map(),\n $serializerValues$: new Map(),\n };\n if (BUILD.isDev) {\n hostRef.$renderCount$ = 0;\n }\n if (BUILD.method && BUILD.lazyLoad) {\n hostRef.$onInstancePromise$ = new Promise((r) => (hostRef.$onInstanceResolve$ = r));\n }\n if (BUILD.asyncLoading) {\n hostRef.$onReadyPromise$ = new Promise((r) => (hostRef.$onReadyResolve$ = r));\n hostElement['s-p'] = [];\n hostElement['s-rc'] = [];\n }\n if (BUILD.lazyLoad) {\n hostRef.$fetchedCbList$ = [];\n }\n\n const ref = hostRef;\n hostElement.__stencil__getHostRef = () => ref;\n\n if (!BUILD.lazyLoad && cmpMeta.$flags$ & CMP_FLAGS.hasModernPropertyDecls && (BUILD.state || BUILD.prop)) {\n reWireGetterSetter(hostElement, hostRef);\n }\n\n return ref;\n};\n\nexport const isMemberInElement = (elm: any, memberName: string) => memberName in elm;\n"
},
{
"path": "src/client/client-load-module.ts",
"content": "import { BUILD } from '@app-data';\n\nimport type * as d from '../declarations';\nimport { consoleDevError, consoleError } from './client-log';\n\nexport const cmpModules = /*@__PURE__*/ new Map();\n\n/**\n * We need to separate out this prefix so that Esbuild doesn't try to resolve\n * the below, but instead retains a dynamic `import()` statement in the\n * emitted code.\n *\n * See here for details https://esbuild.github.io/api/#non-analyzable-imports\n *\n * We need to do this in order to prevent Esbuild from analyzing / transforming\n * the input. However some _other_ bundlers will _not_ work with such an import\n * if it _lacks_ a leading `\"./\"`, so we thus we have to do a little dance\n * where here in the source code it must be like this, so that an undesirable\n * transformation that Esbuild would otherwise carry out doesn't occur, but we\n * actually need to then manually edit the bundled Esbuild code later on to fix\n * that. We do this with plugins in the Esbuild and Rollup bundles which\n * include this file.\n */\nconst MODULE_IMPORT_PREFIX = './';\n\nexport const loadModule = (\n cmpMeta: d.ComponentRuntimeMeta,\n hostRef: d.HostRef,\n hmrVersionId?: string,\n): Promise | d.ComponentConstructor | undefined => {\n // loadModuleImport\n const exportName = cmpMeta.$tagName$.replace(/-/g, '_');\n const bundleId = cmpMeta.$lazyBundleId$;\n if (BUILD.isDev && typeof bundleId !== 'string') {\n consoleDevError(\n `Trying to lazily load component <${cmpMeta.$tagName$}> with style mode \"${hostRef.$modeName$}\", but it does not exist.`,\n );\n return undefined;\n } else if (!bundleId) {\n return undefined;\n }\n const module = !BUILD.hotModuleReplacement ? cmpModules.get(bundleId) : false;\n if (module) {\n return module[exportName];\n }\n /*!__STENCIL_STATIC_IMPORT_SWITCH__*/\n return import(\n /* @vite-ignore */\n /* webpackInclude: /\\.entry\\.js$/ */\n /* webpackExclude: /\\.system\\.entry\\.js$/ */\n /* webpackMode: \"lazy\" */\n `${MODULE_IMPORT_PREFIX}${bundleId}.entry.js${\n BUILD.hotModuleReplacement && hmrVersionId ? '?s-hmr=' + hmrVersionId : ''\n }`\n ).then(\n (importedModule) => {\n if (!BUILD.hotModuleReplacement) {\n cmpModules.set(bundleId, importedModule);\n }\n return importedModule[exportName];\n },\n (e: Error) => {\n consoleError(e, hostRef.$hostElement$);\n },\n );\n};\n"
},
{
"path": "src/client/client-log.ts",
"content": "import { BUILD } from '@app-data';\n\nimport type * as d from '../declarations';\n\nlet customError: d.ErrorHandler;\n\nexport const consoleError: d.ErrorHandler = (e: any, el?: HTMLElement) => (customError || console.error)(e, el);\n\nexport const STENCIL_DEV_MODE = BUILD.isTesting\n ? ['STENCIL:'] // E2E testing\n : [\n '%cstencil',\n 'color: white;background:#4c47ff;font-weight: bold; font-size:10px; padding:2px 6px; border-radius: 5px',\n ];\n\nexport const consoleDevError = (...m: any[]) => console.error(...STENCIL_DEV_MODE, ...m);\n\nexport const consoleDevWarn = (...m: any[]) => console.warn(...STENCIL_DEV_MODE, ...m);\n\nexport const consoleDevInfo = (...m: any[]) => console.info(...STENCIL_DEV_MODE, ...m);\n\nexport const setErrorHandler = (handler: d.ErrorHandler) => (customError = handler);\n"
},
{
"path": "src/client/client-patch-browser.ts",
"content": "import { BUILD, NAMESPACE } from '@app-data';\nimport { consoleDevInfo, H, promiseResolve, win } from '@platform';\n\nimport type * as d from '../declarations';\n\nexport const patchBrowser = (): Promise => {\n // NOTE!! This fn cannot use async/await!\n if (BUILD.isDev && !BUILD.isTesting) {\n consoleDevInfo('Running in development mode.');\n }\n\n if (BUILD.cloneNodeFix) {\n // opted-in to polyfill cloneNode() for slot polyfilled components\n patchCloneNodeFix((H as any).prototype);\n }\n\n const scriptElm = BUILD.scriptDataOpts\n ? win.document &&\n Array.from(win.document.querySelectorAll('script')).find(\n (s) =>\n new RegExp(`\\/${NAMESPACE}(\\\\.esm)?\\\\.js($|\\\\?|#)`).test(s.src) ||\n s.getAttribute('data-stencil-namespace') === NAMESPACE,\n )\n : null;\n const importMeta = import.meta.url;\n const opts = BUILD.scriptDataOpts ? ((scriptElm as any) || {})['data-opts'] || {} : {};\n\n if (importMeta !== '') {\n opts.resourcesUrl = new URL('.', importMeta).href;\n }\n\n return promiseResolve(opts);\n};\n\nconst patchCloneNodeFix = (HTMLElementPrototype: any) => {\n const nativeCloneNodeFn = HTMLElementPrototype.cloneNode;\n\n HTMLElementPrototype.cloneNode = function (this: Node, deep: boolean) {\n if (this.nodeName === 'TEMPLATE') {\n return nativeCloneNodeFn.call(this, deep);\n }\n const clonedNode = nativeCloneNodeFn.call(this, false);\n const srcChildNodes = this.childNodes;\n if (deep) {\n for (let i = 0; i < srcChildNodes.length; i++) {\n // Node.ATTRIBUTE_NODE === 2, and checking because IE11\n if (srcChildNodes[i].nodeType !== 2) {\n clonedNode.appendChild(srcChildNodes[i].cloneNode(true));\n }\n }\n }\n return clonedNode;\n };\n};\n"
},
{
"path": "src/client/client-style.ts",
"content": "import type * as d from '../declarations';\n\nexport const styles: d.StyleMap = /*@__PURE__*/ new Map();\nexport const modeResolutionChain: d.ResolutionHandler[] = [];\nexport const setScopedSSR = (_opts: d.HydrateFactoryOptions) => {};\nexport const needsScopedSSR = () => false;\n"
},
{
"path": "src/client/client-task-queue.ts",
"content": "import { BUILD } from '@app-data';\n\nimport type * as d from '../declarations';\nimport { PLATFORM_FLAGS } from '../runtime/runtime-constants';\nimport { consoleError } from './client-log';\nimport { plt, promiseResolve } from './client-window';\n\nlet queueCongestion = 0;\nlet queuePending = false;\n\nconst queueDomReads: d.RafCallback[] = [];\nconst queueDomWrites: d.RafCallback[] = [];\nconst queueDomWritesLow: d.RafCallback[] = [];\n\nconst queueTask = (queue: d.RafCallback[], write: boolean) => (cb: d.RafCallback) => {\n queue.push(cb);\n\n if (!queuePending) {\n queuePending = true;\n if (write && plt.$flags$ & PLATFORM_FLAGS.queueSync) {\n nextTick(flush);\n } else {\n plt.raf(flush);\n }\n }\n};\n\nconst consume = (queue: d.RafCallback[]) => {\n for (let i = 0; i < queue.length; i++) {\n try {\n queue[i](performance.now());\n } catch (e) {\n consoleError(e);\n }\n }\n queue.length = 0;\n};\n\nconst consumeTimeout = (queue: d.RafCallback[], timeout: number) => {\n let i = 0;\n let ts = 0;\n while (i < queue.length && (ts = performance.now()) < timeout) {\n try {\n queue[i++](ts);\n } catch (e) {\n consoleError(e);\n }\n }\n if (i === queue.length) {\n queue.length = 0;\n } else if (i !== 0) {\n queue.splice(0, i);\n }\n};\n\nconst flush = () => {\n if (BUILD.asyncQueue) {\n queueCongestion++;\n }\n\n // always force a bunch of medium callbacks to run, but still have\n // a throttle on how many can run in a certain time\n\n // DOM READS!!!\n consume(queueDomReads);\n\n // DOM WRITES!!!\n if (BUILD.asyncQueue) {\n const timeout =\n (plt.$flags$ & PLATFORM_FLAGS.queueMask) === PLATFORM_FLAGS.appLoaded\n ? performance.now() + 14 * Math.ceil(queueCongestion * (1.0 / 10.0))\n : Infinity;\n\n consumeTimeout(queueDomWrites, timeout);\n consumeTimeout(queueDomWritesLow, timeout);\n\n if (queueDomWrites.length > 0) {\n queueDomWritesLow.push(...queueDomWrites);\n queueDomWrites.length = 0;\n }\n\n if ((queuePending = queueDomReads.length + queueDomWrites.length + queueDomWritesLow.length > 0)) {\n // still more to do yet, but we've run out of time\n // let's let this thing cool off and try again in the next tick\n plt.raf(flush);\n } else {\n queueCongestion = 0;\n }\n } else {\n consume(queueDomWrites);\n if ((queuePending = queueDomReads.length > 0)) {\n // still more to do yet, but we've run out of time\n // let's let this thing cool off and try again in the next tick\n plt.raf(flush);\n }\n }\n};\n\nexport const nextTick = (cb: () => void) => promiseResolve().then(cb);\n\nexport const readTask = /*@__PURE__*/ queueTask(queueDomReads, false);\n\nexport const writeTask = /*@__PURE__*/ queueTask(queueDomWrites, true);\n"
},
{
"path": "src/client/client-window.ts",
"content": "import { BUILD } from '@app-data';\n\nimport type * as d from '../declarations';\n\ninterface StencilWindow extends Omit {\n document?: Document;\n}\n\nexport const win = (typeof window !== 'undefined' ? window : ({} as StencilWindow)) as StencilWindow;\n\nexport const H = ((win as any).HTMLElement || (class {} as any)) as HTMLElement;\n\nexport const plt: d.PlatformRuntime = {\n $flags$: 0,\n $resourcesUrl$: '',\n jmp: (h) => h(),\n raf: (h) => requestAnimationFrame(h),\n ael: (el, eventName, listener, opts) => el.addEventListener(eventName, listener, opts),\n rel: (el, eventName, listener, opts) => el.removeEventListener(eventName, listener, opts),\n ce: (eventName, opts) => new CustomEvent(eventName, opts),\n};\n\nexport const setPlatformHelpers = (helpers: {\n jmp?: (c: any) => any;\n raf?: (c: any) => number;\n ael?: (el: any, eventName: string, listener: any, options: any) => void;\n rel?: (el: any, eventName: string, listener: any, options: any) => void;\n ce?: (eventName: string, opts?: any) => any;\n}) => {\n Object.assign(plt, helpers);\n};\n\nexport const supportsShadow = BUILD.shadowDom;\n\nexport const supportsListenerOptions = /*@__PURE__*/ (() => {\n let supportsListenerOptions = false;\n try {\n win.document?.addEventListener(\n 'e',\n null,\n Object.defineProperty({}, 'passive', {\n get() {\n supportsListenerOptions = true;\n },\n }),\n );\n } catch (e) {}\n return supportsListenerOptions;\n})();\n\nexport const promiseResolve = (v?: any) => Promise.resolve(v);\n\nexport const supportsConstructableStylesheets = BUILD.constructableCSS\n ? /*@__PURE__*/ (() => {\n try {\n if (!win.document.adoptedStyleSheets) {\n return false;\n }\n new CSSStyleSheet();\n return typeof new CSSStyleSheet().replaceSync === 'function';\n } catch (e) {}\n return false;\n })()\n : false;\n\n// https://github.com/salesforce/lwc/blob/5af18fdd904bc6cfcf7b76f3c539490ff11515b2/packages/%40lwc/engine-dom/src/renderer.ts#L41-L43\nexport const supportsMutableAdoptedStyleSheets = supportsConstructableStylesheets\n ? /*@__PURE__*/ (() =>\n !!win.document && Object.getOwnPropertyDescriptor(win.document.adoptedStyleSheets, 'length')!.writable)()\n : false;\n\nexport { H as HTMLElement };\n"
},
{
"path": "src/client/index.ts",
"content": "export * from './client-build';\nexport * from './client-host-ref';\nexport * from './client-load-module';\nexport * from './client-log';\nexport * from './client-style';\nexport * from './client-task-queue';\nexport * from './client-window';\nexport { BUILD, Env, NAMESPACE } from '@app-data';\nexport * from '@runtime';\n"
},
{
"path": "src/client/polyfills/core-js.js",
"content": "/**\n * core-js 3.6.5\n * https://github.com/zloirock/core-js\n * License: http://rock.mit-license.org\n * © 2019 Denis Pushkarev (zloirock.ru)\n */\n!function(t){\"use strict\";!function(t){var n={};function e(r){if(n[r])return n[r].exports;var o=n[r]={i:r,l:!1,exports:{}};return t[r].call(o.exports,o,o.exports,e),o.l=!0,o.exports}e.m=t,e.c=n,e.d=function(t,n,r){e.o(t,n)||Object.defineProperty(t,n,{enumerable:!0,get:r})},e.r=function(t){\"undefined\"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(t,Symbol.toStringTag,{value:\"Module\"}),Object.defineProperty(t,\"__esModule\",{value:!0})},e.t=function(t,n){if(1&n&&(t=e(t)),8&n)return t;if(4&n&&\"object\"==typeof t&&t&&t.__esModule)return t;var r=Object.create(null);if(e.r(r),Object.defineProperty(r,\"default\",{enumerable:!0,value:t}),2&n&&\"string\"!=typeof t)for(var o in t)e.d(r,o,function(n){return t[n]}.bind(null,o));return r},e.n=function(t){var n=t&&t.__esModule?function(){return t.default}:function(){return t};return e.d(n,\"a\",n),n},e.o=function(t,n){return Object.prototype.hasOwnProperty.call(t,n)},e.p=\"\",e(e.s=0)}([function(t,n,e){e(1),e(55),e(62),e(68),e(70),e(71),e(72),e(73),e(75),e(76),e(78),e(87),e(88),e(89),e(98),e(99),e(101),e(102),e(103),e(105),e(106),e(107),e(108),e(110),e(111),e(112),e(113),e(114),e(115),e(116),e(117),e(118),e(127),e(130),e(131),e(133),e(135),e(136),e(137),e(138),e(139),e(141),e(143),e(146),e(148),e(150),e(151),e(153),e(154),e(155),e(156),e(157),e(159),e(160),e(162),e(163),e(164),e(165),e(166),e(167),e(168),e(169),e(170),e(172),e(173),e(183),e(184),e(185),e(189),e(191),e(192),e(193),e(194),e(195),e(196),e(198),e(201),e(202),e(203),e(204),e(208),e(209),e(212),e(213),e(214),e(215),e(216),e(217),e(218),e(219),e(221),e(222),e(223),e(226),e(227),e(228),e(229),e(230),e(231),e(232),e(233),e(234),e(235),e(236),e(237),e(238),e(240),e(241),e(243),e(248),t.exports=e(246)},function(t,n,e){var r=e(2),o=e(6),i=e(45),a=e(14),u=e(46),c=e(39),f=e(47),s=e(48),l=e(52),p=e(49),h=e(53),v=p(\"isConcatSpreadable\"),g=h>=51||!o((function(){var t=[];return t[v]=!1,t.concat()[0]!==t})),d=l(\"concat\"),y=function(t){if(!a(t))return!1;var n=t[v];return void 0!==n?!!n:i(t)};r({target:\"Array\",proto:!0,forced:!g||!d},{concat:function(t){var n,e,r,o,i,a=u(this),l=s(a,0),p=0;for(n=-1,r=arguments.length;n9007199254740991)throw TypeError(\"Maximum allowed index exceeded\");for(e=0;e=9007199254740991)throw TypeError(\"Maximum allowed index exceeded\");f(l,p++,i)}return l.length=p,l}})},function(t,n,e){var r=e(3),o=e(4).f,i=e(18),a=e(21),u=e(22),c=e(32),f=e(44);t.exports=function(t,n){var e,s,l,p,h,v=t.target,g=t.global,d=t.stat;if(e=g?r:d?r[v]||u(v,{}):(r[v]||{}).prototype)for(s in n){if(p=n[s],l=t.noTargetGet?(h=o(e,s))&&h.value:e[s],!f(g?s:v+(d?\".\":\"#\")+s,t.forced)&&void 0!==l){if(typeof p==typeof l)continue;c(p,l)}(t.sham||l&&l.sham)&&i(p,\"sham\",!0),a(e,s,p,t)}}},function(t,n){var e=function(t){return t&&t.Math==Math&&t};t.exports=e(\"object\"==typeof globalThis&&globalThis)||e(\"object\"==typeof window&&window)||e(\"object\"==typeof self&&self)||e(\"object\"==typeof global&&global)||Function(\"return this\")()},function(t,n,e){var r=e(5),o=e(7),i=e(8),a=e(9),u=e(13),c=e(15),f=e(16),s=Object.getOwnPropertyDescriptor;n.f=r?s:function(t,n){if(t=a(t),n=u(n,!0),f)try{return s(t,n)}catch(t){}if(c(t,n))return i(!o.f.call(t,n),t[n])}},function(t,n,e){var r=e(6);t.exports=!r((function(){return 7!=Object.defineProperty({},1,{get:function(){return 7}})[1]}))},function(t,n){t.exports=function(t){try{return!!t()}catch(t){return!0}}},function(t,n,e){var r={}.propertyIsEnumerable,o=Object.getOwnPropertyDescriptor,i=o&&!r.call({1:2},1);n.f=i?function(t){var n=o(this,t);return!!n&&n.enumerable}:r},function(t,n){t.exports=function(t,n){return{enumerable:!(1&t),configurable:!(2&t),writable:!(4&t),value:n}}},function(t,n,e){var r=e(10),o=e(12);t.exports=function(t){return r(o(t))}},function(t,n,e){var r=e(6),o=e(11),i=\"\".split;t.exports=r((function(){return!Object(\"z\").propertyIsEnumerable(0)}))?function(t){return\"String\"==o(t)?i.call(t,\"\"):Object(t)}:Object},function(t,n){var e={}.toString;t.exports=function(t){return e.call(t).slice(8,-1)}},function(t,n){t.exports=function(t){if(null==t)throw TypeError(\"Can't call method on \"+t);return t}},function(t,n,e){var r=e(14);t.exports=function(t,n){if(!r(t))return t;var e,o;if(n&&\"function\"==typeof(e=t.toString)&&!r(o=e.call(t)))return o;if(\"function\"==typeof(e=t.valueOf)&&!r(o=e.call(t)))return o;if(!n&&\"function\"==typeof(e=t.toString)&&!r(o=e.call(t)))return o;throw TypeError(\"Can't convert object to primitive value\")}},function(t,n){t.exports=function(t){return\"object\"==typeof t?null!==t:\"function\"==typeof t}},function(t,n){var e={}.hasOwnProperty;t.exports=function(t,n){return e.call(t,n)}},function(t,n,e){var r=e(5),o=e(6),i=e(17);t.exports=!r&&!o((function(){return 7!=Object.defineProperty(i(\"div\"),\"a\",{get:function(){return 7}}).a}))},function(t,n,e){var r=e(3),o=e(14),i=r.document,a=o(i)&&o(i.createElement);t.exports=function(t){return a?i.createElement(t):{}}},function(t,n,e){var r=e(5),o=e(19),i=e(8);t.exports=r?function(t,n,e){return o.f(t,n,i(1,e))}:function(t,n,e){return t[n]=e,t}},function(t,n,e){var r=e(5),o=e(16),i=e(20),a=e(13),u=Object.defineProperty;n.f=r?u:function(t,n,e){if(i(t),n=a(n,!0),i(e),o)try{return u(t,n,e)}catch(t){}if(\"get\"in e||\"set\"in e)throw TypeError(\"Accessors not supported\");return\"value\"in e&&(t[n]=e.value),t}},function(t,n,e){var r=e(14);t.exports=function(t){if(!r(t))throw TypeError(String(t)+\" is not an object\");return t}},function(t,n,e){var r=e(3),o=e(18),i=e(15),a=e(22),u=e(23),c=e(25),f=c.get,s=c.enforce,l=String(String).split(\"String\");(t.exports=function(t,n,e,u){var c=!!u&&!!u.unsafe,f=!!u&&!!u.enumerable,p=!!u&&!!u.noTargetGet;\"function\"==typeof e&&(\"string\"!=typeof n||i(e,\"name\")||o(e,\"name\",n),s(e).source=l.join(\"string\"==typeof n?n:\"\")),t!==r?(c?!p&&t[n]&&(f=!0):delete t[n],f?t[n]=e:o(t,n,e)):f?t[n]=e:a(n,e)})(Function.prototype,\"toString\",(function(){return\"function\"==typeof this&&f(this).source||u(this)}))},function(t,n,e){var r=e(3),o=e(18);t.exports=function(t,n){try{o(r,t,n)}catch(e){r[t]=n}return n}},function(t,n,e){var r=e(24),o=Function.toString;\"function\"!=typeof r.inspectSource&&(r.inspectSource=function(t){return o.call(t)}),t.exports=r.inspectSource},function(t,n,e){var r=e(3),o=e(22),i=r[\"__core-js_shared__\"]||o(\"__core-js_shared__\",{});t.exports=i},function(t,n,e){var r,o,i,a=e(26),u=e(3),c=e(14),f=e(18),s=e(15),l=e(27),p=e(31),h=u.WeakMap;if(a){var v=new h,g=v.get,d=v.has,y=v.set;r=function(t,n){return y.call(v,t,n),n},o=function(t){return g.call(v,t)||{}},i=function(t){return d.call(v,t)}}else{var x=l(\"state\");p[x]=!0,r=function(t,n){return f(t,x,n),n},o=function(t){return s(t,x)?t[x]:{}},i=function(t){return s(t,x)}}t.exports={set:r,get:o,has:i,enforce:function(t){return i(t)?o(t):r(t,{})},getterFor:function(t){return function(n){var e;if(!c(n)||(e=o(n)).type!==t)throw TypeError(\"Incompatible receiver, \"+t+\" required\");return e}}}},function(t,n,e){var r=e(3),o=e(23),i=r.WeakMap;t.exports=\"function\"==typeof i&&/native code/.test(o(i))},function(t,n,e){var r=e(28),o=e(30),i=r(\"keys\");t.exports=function(t){return i[t]||(i[t]=o(t))}},function(t,n,e){var r=e(29),o=e(24);(t.exports=function(t,n){return o[t]||(o[t]=void 0!==n?n:{})})(\"versions\",[]).push({version:\"3.6.5\",mode:r?\"pure\":\"global\",copyright:\"© 2020 Denis Pushkarev (zloirock.ru)\"})},function(t,n){t.exports=!1},function(t,n){var e=0,r=Math.random();t.exports=function(t){return\"Symbol(\"+String(void 0===t?\"\":t)+\")_\"+(++e+r).toString(36)}},function(t,n){t.exports={}},function(t,n,e){var r=e(15),o=e(33),i=e(4),a=e(19);t.exports=function(t,n){for(var e=o(n),u=a.f,c=i.f,f=0;fc;)r(u,e=n[c++])&&(~i(f,e)||f.push(e));return f}},function(t,n,e){var r=e(9),o=e(39),i=e(41),a=function(t){return function(n,e,a){var u,c=r(n),f=o(c.length),s=i(a,f);if(t&&e!=e){for(;f>s;)if((u=c[s++])!=u)return!0}else for(;f>s;s++)if((t||s in c)&&c[s]===e)return t||s||0;return!t&&-1}};t.exports={includes:a(!0),indexOf:a(!1)}},function(t,n,e){var r=e(40),o=Math.min;t.exports=function(t){return t>0?o(r(t),9007199254740991):0}},function(t,n){var e=Math.ceil,r=Math.floor;t.exports=function(t){return isNaN(t=+t)?0:(t>0?r:e)(t)}},function(t,n,e){var r=e(40),o=Math.max,i=Math.min;t.exports=function(t,n){var e=r(t);return e<0?o(e+n,0):i(e,n)}},function(t,n){t.exports=[\"constructor\",\"hasOwnProperty\",\"isPrototypeOf\",\"propertyIsEnumerable\",\"toLocaleString\",\"toString\",\"valueOf\"]},function(t,n){n.f=Object.getOwnPropertySymbols},function(t,n,e){var r=e(6),o=/#|\\.prototype\\./,i=function(t,n){var e=u[a(t)];return e==f||e!=c&&(\"function\"==typeof n?r(n):!!n)},a=i.normalize=function(t){return String(t).replace(o,\".\").toLowerCase()},u=i.data={},c=i.NATIVE=\"N\",f=i.POLYFILL=\"P\";t.exports=i},function(t,n,e){var r=e(11);t.exports=Array.isArray||function(t){return\"Array\"==r(t)}},function(t,n,e){var r=e(12);t.exports=function(t){return Object(r(t))}},function(t,n,e){var r=e(13),o=e(19),i=e(8);t.exports=function(t,n,e){var a=r(n);a in t?o.f(t,a,i(0,e)):t[a]=e}},function(t,n,e){var r=e(14),o=e(45),i=e(49)(\"species\");t.exports=function(t,n){var e;return o(t)&&(\"function\"!=typeof(e=t.constructor)||e!==Array&&!o(e.prototype)?r(e)&&null===(e=e[i])&&(e=void 0):e=void 0),new(void 0===e?Array:e)(0===n?0:n)}},function(t,n,e){var r=e(3),o=e(28),i=e(15),a=e(30),u=e(50),c=e(51),f=o(\"wks\"),s=r.Symbol,l=c?s:s&&s.withoutSetter||a;t.exports=function(t){return i(f,t)||(u&&i(s,t)?f[t]=s[t]:f[t]=l(\"Symbol.\"+t)),f[t]}},function(t,n,e){var r=e(6);t.exports=!!Object.getOwnPropertySymbols&&!r((function(){return!String(Symbol())}))},function(t,n,e){var r=e(50);t.exports=r&&!Symbol.sham&&\"symbol\"==typeof Symbol.iterator},function(t,n,e){var r=e(6),o=e(49),i=e(53),a=o(\"species\");t.exports=function(t){return i>=51||!r((function(){var n=[];return(n.constructor={})[a]=function(){return{foo:1}},1!==n[t](Boolean).foo}))}},function(t,n,e){var r,o,i=e(3),a=e(54),u=i.process,c=u&&u.versions,f=c&&c.v8;f?o=(r=f.split(\".\"))[0]+r[1]:a&&(!(r=a.match(/Edge\\/(\\d+)/))||r[1]>=74)&&(r=a.match(/Chrome\\/(\\d+)/))&&(o=r[1]),t.exports=o&&+o},function(t,n,e){var r=e(34);t.exports=r(\"navigator\",\"userAgent\")||\"\"},function(t,n,e){var r=e(2),o=e(56),i=e(57);r({target:\"Array\",proto:!0},{copyWithin:o}),i(\"copyWithin\")},function(t,n,e){var r=e(46),o=e(41),i=e(39),a=Math.min;t.exports=[].copyWithin||function(t,n){var e=r(this),u=i(e.length),c=o(t,u),f=o(n,u),s=arguments.length>2?arguments[2]:void 0,l=a((void 0===s?u:o(s,u))-f,u-c),p=1;for(f0;)f in e?e[c]=e[f]:delete e[c],c+=p,f+=p;return e}},function(t,n,e){var r=e(49),o=e(58),i=e(19),a=r(\"unscopables\"),u=Array.prototype;null==u[a]&&i.f(u,a,{configurable:!0,value:o(null)}),t.exports=function(t){u[a][t]=!0}},function(t,n,e){var r,o=e(20),i=e(59),a=e(42),u=e(31),c=e(61),f=e(17),s=e(27),l=s(\"IE_PROTO\"),p=function(){},h=function(t){return\"\n`)}\n \n\n AFTER: \n The index.html should now include two scripts using the modern ES Module script pattern.\n Note that only one file will actually be requested and loaded based on the browser's native support for ES Modules.\n For more info, please see Using JavaScript modules on the web .\n
\n \n ${escapeHtml(`type=\"module\" src=\"/build/${\n config.fsNamespace\n }.esm .js\"${escapeHtml(`>`)}\n ${escapeHtml(`nomodule ${escapeHtml(\n `src=\"/build/${config.fsNamespace}.js\">`,\n )} \n \n `;\n return `${generatePreamble(config)}\n(function() {\n function checkSupport() {\n if (!document.body) {\n setTimeout(checkSupport);\n return;\n }\n function supportsDynamicImports() {\n try {\n new Function('import(\"\")');\n return true;\n } catch (e) {}\n return false;\n }\n var supportsEsModules = !!('noModule' in document.createElement('script'));\n\n if (!supportsEsModules) {\n document.body.innerHTML = '${inlineHTML(htmlLegacy)}';\n\n document.getElementById('current-browser-output').textContent = window.navigator.userAgent;\n document.getElementById('es-modules-test').textContent = supportsEsModules;\n document.getElementById('es-dynamic-modules-test').textContent = supportsDynamicImports();\n document.getElementById('shadow-dom-test').textContent = !!(document.head.attachShadow);\n document.getElementById('custom-elements-test').textContent = !!(window.customElements);\n document.getElementById('css-variables-test').textContent = !!(window.CSS && window.CSS.supports && window.CSS.supports('color', 'var(--c)'));\n document.getElementById('fetch-test').textContent = !!(window.fetch);\n } else {\n document.body.innerHTML = '${inlineHTML(htmlUpdate)}';\n }\n }\n\n setTimeout(checkSupport);\n})();`;\n};\n\nconst inlineHTML = (html: string) => {\n return html.replace(/\\n/g, '\\\\n').replace(/\\'/g, `\\\\'`).trim();\n};\n"
},
{
"path": "src/compiler/app-core/app-polyfills.ts",
"content": "import { join } from '@utils';\n\nimport type * as d from '../../declarations';\n\nexport const getClientPolyfill = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n polyfillFile: string,\n) => {\n const polyfillFilePath = join(\n config.sys.getCompilerExecutingPath(),\n '..',\n '..',\n 'internal',\n 'client',\n 'polyfills',\n polyfillFile,\n );\n return compilerCtx.fs.readFile(polyfillFilePath);\n};\n\nexport const getAppBrowserCorePolyfills = async (config: d.ValidatedConfig, compilerCtx: d.CompilerCtx) => {\n // read all the polyfill content, in this particular order\n const polyfills = INLINE_POLYFILLS.slice();\n\n const results = await Promise.all(\n polyfills.map((polyfillFile) => getClientPolyfill(config, compilerCtx, polyfillFile)),\n );\n\n // concat the polyfills\n return results.join('\\n').trim();\n};\n\n// order of the polyfills matters!! test test test\n// actual source of the polyfills are found in /src/client/polyfills/\nconst INLINE_POLYFILLS = ['core-js.js', 'dom.js', 'es5-html-element.js', 'system.js'];\n"
},
{
"path": "src/compiler/app-core/bundle-app-core.ts",
"content": "import type { OutputAsset, OutputChunk, OutputOptions, RollupBuild } from 'rollup';\n\nimport type * as d from '../../declarations';\nimport { STENCIL_CORE_ID } from '../bundle/entry-alias-ids';\n\n/**\n * Generate rollup output based on a rollup build and a series of options.\n *\n * @param build a rollup build\n * @param options output options for rollup\n * @param config a user-supplied configuration object\n * @param entryModules a list of entry modules, for checking which chunks\n * contain components\n * @returns a Promise wrapping either build results or `null`\n */\nexport const generateRollupOutput = async (\n build: RollupBuild,\n options: OutputOptions,\n config: d.ValidatedConfig,\n entryModules: d.EntryModule[],\n): Promise => {\n if (build == null) {\n return null;\n }\n\n const { output }: { output: [OutputChunk, ...(OutputChunk | OutputAsset)[]] } = await build.generate(options);\n return output.map((chunk: OutputChunk | OutputAsset) => {\n if (chunk.type === 'chunk') {\n const isCore = Object.keys(chunk.modules).some((m) => m.includes(STENCIL_CORE_ID));\n return {\n type: 'chunk',\n fileName: chunk.fileName,\n map: chunk.map\n ? {\n ...chunk.map,\n sourcesContent: chunk.map.sourcesContent || [],\n }\n : undefined,\n code: chunk.code,\n moduleFormat: options.format,\n entryKey: chunk.name,\n imports: chunk.imports,\n isEntry: !!chunk.isEntry,\n isComponent: !!chunk.isEntry && entryModules.some((m) => m.entryKey === chunk.name),\n isBrowserLoader: chunk.isEntry && chunk.name === config.fsNamespace,\n isIndex: chunk.isEntry && chunk.name === 'index',\n isCore,\n };\n } else {\n return {\n type: 'asset',\n fileName: chunk.fileName,\n content: chunk.source as any,\n };\n }\n });\n};\n"
},
{
"path": "src/compiler/build/build-ctx.ts",
"content": "import { hasError, hasWarning, result } from '@utils';\n\nimport type * as d from '../../declarations';\nimport { validateConfig } from '../config/validate-config';\n\n/**\n * A new BuildCtx object is created for every build\n * and rebuild.\n */\nexport class BuildContext implements d.BuildCtx {\n buildId = -1;\n buildMessages: string[] = [];\n buildResults: d.CompilerBuildResults = null;\n bundleBuildCount = 0;\n collections: d.CollectionCompilerMeta[] = [];\n completedTasks: d.BuildTask[] = [];\n compilerCtx: d.CompilerCtx;\n components: d.ComponentCompilerMeta[] = [];\n componentGraph = new Map();\n config: d.ValidatedConfig;\n data: any = {};\n buildStats?: result.Result = undefined;\n esmBrowserComponentBundle: d.BundleModule[];\n esmComponentBundle: d.BundleModule[];\n es5ComponentBundle: d.BundleModule[];\n systemComponentBundle: d.BundleModule[];\n commonJsComponentBundle: d.BundleModule[];\n diagnostics: d.Diagnostic[] = [];\n dirsAdded: string[] = [];\n dirsDeleted: string[] = [];\n entryModules: d.EntryModule[] = [];\n filesAdded: string[] = [];\n filesChanged: string[] = [];\n filesDeleted: string[] = [];\n filesUpdated: string[] = [];\n filesWritten: string[] = [];\n globalStyle: string = undefined;\n hasConfigChanges = false;\n hasFinished = false;\n hasHtmlChanges = false;\n hasPrintedResults = false;\n hasServiceWorkerChanges = false;\n hasScriptChanges = true;\n hasStyleChanges = true;\n hydrateAppFilePath: string = null;\n indexBuildCount = 0;\n indexDoc: Document = undefined;\n isRebuild = false;\n moduleFiles: d.Module[] = [];\n outputs: d.BuildOutput[] = [];\n packageJson: d.PackageJsonData = {};\n packageJsonFilePath: string = null;\n pendingCopyTasks: Promise[] = [];\n requiresFullBuild = true;\n scriptsAdded: string[] = [];\n scriptsDeleted: string[] = [];\n startTime = Date.now();\n styleBuildCount = 0;\n stylesPromise: Promise = null;\n stylesUpdated: d.BuildStyleUpdate[] = [];\n timeSpan: d.LoggerTimeSpan = null;\n timestamp: string;\n transpileBuildCount = 0;\n validateTypesPromise: Promise;\n\n constructor(config: d.Config, compilerCtx: d.CompilerCtx) {\n this.config = validateConfig(config, {}).config;\n this.compilerCtx = compilerCtx;\n this.buildId = ++this.compilerCtx.activeBuildId;\n\n this.debug = config.logger.debug.bind(config.logger);\n }\n\n start() {\n // get the build id from the incremented activeBuildId\n // print out a good message\n const msg = `${this.isRebuild ? 'rebuild' : 'build'}, ${this.config.fsNamespace}, ${\n this.config.devMode ? 'dev' : 'prod'\n } mode, started`;\n\n const buildLog: d.BuildLog = {\n buildId: this.buildId,\n messages: [],\n progress: 0,\n };\n this.compilerCtx.events.emit('buildLog', buildLog);\n\n // create a timespan for this build\n this.timeSpan = this.createTimeSpan(msg);\n\n // create a build timestamp for this build\n this.timestamp = getBuildTimestamp();\n\n // debug log our new build\n this.debug(`start build, ${this.timestamp}`);\n\n const buildStart: d.CompilerBuildStart = {\n buildId: this.buildId,\n timestamp: this.timestamp,\n };\n this.compilerCtx.events.emit('buildStart', buildStart);\n }\n\n createTimeSpan(msg: string, debug?: boolean) {\n if (!this.hasFinished || debug) {\n if (debug) {\n if (this.config.watch) {\n msg = `${this.config.logger.cyan('[' + this.buildId + ']')} ${msg}`;\n }\n }\n const timeSpan = this.config.logger.createTimeSpan(msg, debug, this.buildMessages);\n\n if (!debug && this.compilerCtx.events) {\n const buildLog: d.BuildLog = {\n buildId: this.buildId,\n messages: this.buildMessages,\n progress: getProgress(this.completedTasks),\n };\n this.compilerCtx.events.emit('buildLog', buildLog);\n }\n\n return {\n duration: () => {\n return timeSpan.duration();\n },\n finish: (finishedMsg: string, color?: string, bold?: boolean, newLineSuffix?: boolean) => {\n if (!this.hasFinished || debug) {\n if (debug) {\n if (this.config.watch) {\n finishedMsg = `${this.config.logger.cyan('[' + this.buildId + ']')} ${finishedMsg}`;\n }\n }\n\n timeSpan.finish(finishedMsg, color, bold, newLineSuffix);\n\n if (!debug) {\n const buildLog: d.BuildLog = {\n buildId: this.buildId,\n messages: this.buildMessages.slice(),\n progress: getProgress(this.completedTasks),\n };\n this.compilerCtx.events.emit('buildLog', buildLog);\n }\n }\n return timeSpan.duration();\n },\n };\n }\n\n return {\n duration() {\n return 0;\n },\n finish() {\n return 0;\n },\n };\n }\n\n debug(msg: string) {\n this.config.logger.debug(msg);\n }\n\n get hasError() {\n return hasError(this.diagnostics);\n }\n\n get hasWarning() {\n return hasWarning(this.diagnostics);\n }\n\n progress(t: d.BuildTask) {\n this.completedTasks.push(t);\n }\n\n async validateTypesBuild() {\n if (this.hasError) {\n // no need to wait on this one since\n // we already aborted this build\n return;\n }\n\n if (!this.validateTypesPromise) {\n // there is no pending validate types promise\n // so it probably already finished\n // so no need to wait on anything\n return;\n }\n\n if (!this.config.watch) {\n // this is not a watch build, so we need to make\n // sure that the type validation has finished\n this.debug(`build, non-watch, waiting on validateTypes`);\n await this.validateTypesPromise;\n this.debug(`build, non-watch, finished waiting on validateTypes`);\n }\n }\n}\n\n/**\n * Generate a timestamp of the format `YYYY-MM-DDThh:mm:ss`, using the number of seconds that have elapsed since\n * January 01, 1970, and the time this function was called\n * @returns the generated timestamp\n */\nexport const getBuildTimestamp = () => {\n const d = new Date();\n\n // YYYY-MM-DDThh:mm:ss\n let timestamp = d.getUTCFullYear() + '-';\n timestamp += ('0' + (d.getUTCMonth() + 1)).slice(-2) + '-';\n timestamp += ('0' + d.getUTCDate()).slice(-2) + 'T';\n timestamp += ('0' + d.getUTCHours()).slice(-2) + ':';\n timestamp += ('0' + d.getUTCMinutes()).slice(-2) + ':';\n timestamp += ('0' + d.getUTCSeconds()).slice(-2);\n\n return timestamp;\n};\n\nconst getProgress = (completedTasks: d.BuildTask[]) => {\n let progressIndex = 0;\n const taskKeys = Object.keys(ProgressTask);\n\n taskKeys.forEach((taskKey, index) => {\n if (completedTasks.includes((ProgressTask as any)[taskKey])) {\n progressIndex = index;\n }\n });\n\n return (progressIndex + 1) / taskKeys.length;\n};\n\nexport const ProgressTask = {\n emptyOutputTargets: {},\n transpileApp: {},\n generateStyles: {},\n generateOutputTargets: {},\n validateTypesBuild: {},\n writeBuildFiles: {},\n};\n"
},
{
"path": "src/compiler/build/build-finish.ts",
"content": "import { isFunction, isRemoteUrl, relative } from '@utils';\n\nimport type * as d from '../../declarations';\nimport { generateBuildResults } from './build-results';\nimport { generateBuildStats, writeBuildStats } from './build-stats';\n\n/**\n * Finish a build as having completed successfully\n * @param buildCtx the build context for the build being aborted\n * @returns the build results\n */\nexport const buildFinish = async (buildCtx: d.BuildCtx): Promise => {\n const results = await buildDone(buildCtx.config, buildCtx.compilerCtx, buildCtx, false);\n\n const buildLog: d.BuildLog = {\n buildId: buildCtx.buildId,\n messages: buildCtx.buildMessages.slice(),\n progress: 1,\n };\n\n buildCtx.compilerCtx.events.emit('buildLog', buildLog);\n\n return results;\n};\n\n/**\n * Finish a build early due to failure. During the build process, a fatal error has occurred where the compiler cannot\n * continue further\n * @param buildCtx the build context for the build being aborted\n * @returns the build results\n */\nexport const buildAbort = (buildCtx: d.BuildCtx): Promise => {\n return buildDone(buildCtx.config, buildCtx.compilerCtx, buildCtx, true);\n};\n\n/**\n * Mark a build as done\n * @param config the Stencil configuration used for the build\n * @param compilerCtx the compiler context associated with the build\n * @param buildCtx the build context associated with the build to mark as done\n * @param aborted true if the build ended early due to failure, false otherwise\n * @returns the build results\n */\nconst buildDone = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n buildCtx: d.BuildCtx,\n aborted: boolean,\n): Promise => {\n if (buildCtx.hasFinished && buildCtx.buildResults) {\n // we've already marked this build as finished and\n // already created the build results, just return these\n return buildCtx.buildResults;\n }\n\n // create the build results data\n buildCtx.buildResults = generateBuildResults(config, compilerCtx, buildCtx);\n\n // After the build results are available on the buildCtx, call the stats and set it.\n // We will use this later to write the files.\n buildCtx.buildStats = generateBuildStats(config, buildCtx);\n\n await writeBuildStats(config, buildCtx.buildStats);\n\n buildCtx.debug(`${aborted ? 'aborted' : 'finished'} build, ${buildCtx.buildResults.duration}ms`);\n\n // log any errors/warnings\n if (!buildCtx.hasFinished) {\n // haven't set this build as finished yet\n if (!buildCtx.hasPrintedResults) {\n cleanDiagnosticsRelativePath(config, buildCtx.buildResults.diagnostics);\n config.logger.printDiagnostics(buildCtx.buildResults.diagnostics);\n }\n\n const hasChanges = buildCtx.hasScriptChanges || buildCtx.hasStyleChanges;\n if (buildCtx.isRebuild && hasChanges && buildCtx.buildResults.hmr && !aborted) {\n // this is a rebuild, and we've got hmr data\n // and this build hasn't been aborted\n logHmr(config.logger, buildCtx.buildResults.hmr);\n }\n\n // create a nice pretty message stating what happened\n const buildText = buildCtx.isRebuild ? 'rebuild' : 'build';\n const watchText = config.watch ? ', watching for changes...' : '';\n let buildStatus = 'finished';\n let statusColor = 'green';\n\n if (buildCtx.hasError) {\n // gosh darn, build had errors\n // ಥ_ಥ\n buildStatus = 'failed';\n statusColor = 'red';\n } else {\n // successful build!\n // ┏(°.°)┛ ┗(°.°)┓ ┗(°.°)┛ ┏(°.°)┓\n compilerCtx.changedFiles.clear();\n compilerCtx.hasSuccessfulBuild = true;\n buildCtx.buildResults.hasSuccessfulBuild = true;\n }\n\n // print out the time it took to build\n // and add the duration to the build results\n if (!buildCtx.hasPrintedResults) {\n buildCtx.timeSpan.finish(`${buildText} ${buildStatus}${watchText}`, statusColor, true, true);\n buildCtx.hasPrintedResults = true;\n }\n\n // emit a buildFinish event for anyone who cares\n compilerCtx.events.emit('buildFinish', buildCtx.buildResults);\n\n // write all of our logs to disk if config'd to do so\n // do this even if there are errors or not the active build\n if (isFunction(config.logger.writeLogs)) {\n config.logger.writeLogs(buildCtx.isRebuild);\n }\n }\n\n // it's official, this build has finished\n buildCtx.hasFinished = true;\n\n if (!config.watch) {\n compilerCtx.reset();\n if (global.gc) {\n buildCtx.debug(`triggering forced gc`);\n global.gc();\n buildCtx.debug(`forced gc finished`);\n }\n }\n\n return buildCtx.buildResults;\n};\n\n/**\n * In a Hot Module Replacement (HMR) context, log what changed between builds\n * @param logger the instance of the logger to report what's changed\n * @param hmr the HMR data, which includes what's changed between builds\n */\nconst logHmr = (logger: d.Logger, hmr: d.HotModuleReplacement): void => {\n if (hmr.componentsUpdated) {\n cleanupUpdateMsg(logger, `updated component`, hmr.componentsUpdated);\n }\n\n if (hmr.inlineStylesUpdated) {\n const inlineStyles = hmr.inlineStylesUpdated\n .map((s) => s.styleTag)\n .reduce((arr, v) => {\n if (!arr.includes(v)) {\n arr.push(v);\n }\n return arr;\n }, [] as string[]);\n cleanupUpdateMsg(logger, `updated style`, inlineStyles);\n }\n\n if (hmr.externalStylesUpdated) {\n cleanupUpdateMsg(logger, `updated stylesheet`, hmr.externalStylesUpdated);\n }\n\n if (hmr.imagesUpdated) {\n cleanupUpdateMsg(logger, `updated image`, hmr.imagesUpdated);\n }\n};\n\nconst cleanupUpdateMsg = (logger: d.Logger, msg: string, fileNames: string[]) => {\n if (fileNames.length > 0) {\n let fileMsg = '';\n\n if (fileNames.length > 7) {\n const remaining = fileNames.length - 6;\n fileNames = fileNames.slice(0, 6);\n fileMsg = fileNames.join(', ') + `, +${remaining} others`;\n } else {\n fileMsg = fileNames.join(', ');\n }\n\n if (fileNames.length > 1) {\n msg += 's';\n }\n\n logger.info(`${msg}: ${logger.cyan(fileMsg)}`);\n }\n};\n\n/**\n * Update the relative file path for diagnostics. The updates are done in place.\n * @param config the Stencil configuration associated with the current build\n * @param diagnostics the diagnostics to update\n */\nconst cleanDiagnosticsRelativePath = (config: d.Config, diagnostics: ReadonlyArray): void => {\n diagnostics.forEach((diagnostic) => {\n if (!diagnostic.relFilePath && diagnostic.absFilePath && !isRemoteUrl(diagnostic.absFilePath) && config.rootDir) {\n diagnostic.relFilePath = relative(config.rootDir, diagnostic.absFilePath);\n }\n });\n};\n"
},
{
"path": "src/compiler/build/build-hmr.ts",
"content": "import { isGlob, isOutputTargetWww, normalizePath, sortBy } from '@utils';\nimport { minimatch } from 'minimatch';\nimport { basename } from 'path';\n\nimport type * as d from '../../declarations';\nimport { getScopeId } from '../style/scope-css';\n\nexport const generateHmr = (config: d.Config, compilerCtx: d.CompilerCtx, buildCtx: d.BuildCtx) => {\n if (config.devServer?.reloadStrategy == null) {\n return null;\n }\n\n const hmr: d.HotModuleReplacement = {\n reloadStrategy: config.devServer.reloadStrategy,\n versionId: Date.now().toString().substring(6) + '' + Math.round(Math.random() * 89999 + 10000),\n };\n\n if (buildCtx.scriptsAdded.length > 0) {\n hmr.scriptsAdded = buildCtx.scriptsAdded.slice();\n }\n\n if (buildCtx.scriptsDeleted.length > 0) {\n hmr.scriptsDeleted = buildCtx.scriptsDeleted.slice();\n }\n\n const excludeHmr = excludeHmrFiles(config, config.devServer.excludeHmr, buildCtx.filesChanged);\n if (excludeHmr.length > 0) {\n hmr.excludeHmr = excludeHmr.slice();\n }\n\n if (buildCtx.hasHtmlChanges) {\n hmr.indexHtmlUpdated = true;\n }\n\n if (buildCtx.hasServiceWorkerChanges) {\n hmr.serviceWorkerUpdated = true;\n }\n\n const outputTargetsWww = config.outputTargets.filter(isOutputTargetWww);\n\n const componentsUpdated = getComponentsUpdated(compilerCtx, buildCtx);\n if (componentsUpdated) {\n hmr.componentsUpdated = componentsUpdated;\n }\n\n if (Object.keys(buildCtx.stylesUpdated).length > 0) {\n hmr.inlineStylesUpdated = sortBy(\n buildCtx.stylesUpdated.map((s) => {\n return {\n styleId: getScopeId(s.styleTag, s.styleMode),\n styleTag: s.styleTag,\n styleText: s.styleText,\n } as d.HmrStyleUpdate;\n }),\n (s) => s.styleId,\n );\n }\n\n const externalStylesUpdated = getExternalStylesUpdated(buildCtx, outputTargetsWww);\n if (externalStylesUpdated) {\n hmr.externalStylesUpdated = externalStylesUpdated;\n }\n\n const externalImagesUpdated = getImagesUpdated(buildCtx, outputTargetsWww);\n if (externalImagesUpdated) {\n hmr.imagesUpdated = externalImagesUpdated;\n }\n\n return hmr;\n};\n\nconst getComponentsUpdated = (compilerCtx: d.CompilerCtx, buildCtx: d.BuildCtx) => {\n // find all of the components that would be affected from the file changes\n if (!buildCtx.filesChanged) {\n return null;\n }\n\n const filesToLookForImporters = buildCtx.filesChanged.filter((f) => {\n return f.endsWith('.ts') || f.endsWith('.tsx') || f.endsWith('.js') || f.endsWith('.jsx');\n });\n\n if (filesToLookForImporters.length === 0) {\n return null;\n }\n\n const changedScriptFiles: string[] = [];\n const checkedFiles = new Set();\n const allModuleFiles = buildCtx.moduleFiles.filter((m) => m.localImports && m.localImports.length > 0);\n\n while (filesToLookForImporters.length > 0) {\n const scriptFile = filesToLookForImporters.shift();\n addTsFileImporters(allModuleFiles, filesToLookForImporters, checkedFiles, changedScriptFiles, scriptFile);\n }\n\n const tags = changedScriptFiles.reduce((tags, changedTsFile) => {\n const moduleFile = compilerCtx.moduleMap.get(changedTsFile);\n if (moduleFile != null) {\n moduleFile.cmps.forEach((cmp) => {\n if (typeof cmp.tagName === 'string') {\n if (!tags.includes(cmp.tagName)) {\n tags.push(cmp.tagName);\n }\n }\n });\n }\n return tags;\n }, [] as string[]);\n\n if (tags.length === 0) {\n return null;\n }\n\n return tags.sort();\n};\n\nconst addTsFileImporters = (\n allModuleFiles: d.Module[],\n filesToLookForImporters: string[],\n checkedFiles: Set,\n changedScriptFiles: string[],\n scriptFile: string,\n) => {\n if (!changedScriptFiles.includes(scriptFile)) {\n // add it to our list of files to transpile\n changedScriptFiles.push(scriptFile);\n }\n\n if (checkedFiles.has(scriptFile)) {\n // already checked this file\n return;\n }\n checkedFiles.add(scriptFile);\n\n // get all the ts files that import this ts file\n const tsFilesThatImportsThisTsFile = allModuleFiles.reduce((arr, moduleFile) => {\n moduleFile.localImports.forEach((localImport) => {\n let checkFile = localImport;\n\n if (checkFile === scriptFile) {\n arr.push(moduleFile.sourceFilePath);\n return;\n }\n\n checkFile = localImport + '.tsx';\n if (checkFile === scriptFile) {\n arr.push(moduleFile.sourceFilePath);\n return;\n }\n\n checkFile = localImport + '.ts';\n if (checkFile === scriptFile) {\n arr.push(moduleFile.sourceFilePath);\n return;\n }\n\n checkFile = localImport + '.js';\n if (checkFile === scriptFile) {\n arr.push(moduleFile.sourceFilePath);\n return;\n }\n });\n return arr;\n }, [] as string[]);\n\n // add all the files that import this ts file to the list of ts files we need to look through\n tsFilesThatImportsThisTsFile.forEach((tsFileThatImportsThisTsFile) => {\n // if we add to this array, then the while look will keep working until it's empty\n filesToLookForImporters.push(tsFileThatImportsThisTsFile);\n });\n};\n\nconst getExternalStylesUpdated = (buildCtx: d.BuildCtx, outputTargetsWww: d.OutputTargetWww[]) => {\n if (!buildCtx.isRebuild || outputTargetsWww.length === 0) {\n return null;\n }\n\n const cssFiles = buildCtx.filesWritten.filter((f) => f.endsWith('.css'));\n if (cssFiles.length === 0) {\n return null;\n }\n\n return cssFiles.map((cssFile) => basename(cssFile)).sort();\n};\n\nconst getImagesUpdated = (buildCtx: d.BuildCtx, outputTargetsWww: d.OutputTargetWww[]) => {\n if (outputTargetsWww.length === 0) {\n return null;\n }\n\n const imageFiles = buildCtx.filesChanged.reduce((arr, filePath) => {\n if (IMAGE_EXT.some((ext) => filePath.toLowerCase().endsWith(ext))) {\n const fileName = basename(filePath);\n if (!arr.includes(fileName)) {\n arr.push(fileName);\n }\n }\n return arr;\n }, []);\n\n if (imageFiles.length === 0) {\n return null;\n }\n\n return imageFiles.sort();\n};\n\n/**\n * Determine a list of files (if any) which should be excluded from HMR updates.\n *\n * @param config a user-supplied config\n * @param excludeHmr a list of glob patterns that should be used to determine\n * whether to exclude a file or not (a file will be excluded if it matches one\n * @param filesChanged an array of files which are changed in the HMR update\n * currently under consideration\n * @returns a sorted list of files to exclude\n */\nconst excludeHmrFiles = (config: d.Config, excludeHmr: string[], filesChanged: string[]): string[] => {\n const excludeFiles: string[] = [];\n\n if (!excludeHmr || excludeHmr.length === 0) {\n return excludeFiles;\n }\n\n excludeHmr.forEach((excludeHmr) => {\n return filesChanged\n .map((fileChanged) => {\n let shouldExclude = false;\n\n if (isGlob(excludeHmr)) {\n shouldExclude = minimatch(fileChanged, excludeHmr);\n } else {\n shouldExclude = normalizePath(excludeHmr) === normalizePath(fileChanged);\n }\n\n if (shouldExclude) {\n config.logger.debug(`excludeHmr: ${fileChanged}`);\n excludeFiles.push(basename(fileChanged));\n }\n\n return shouldExclude;\n })\n .some((r) => r);\n });\n\n return excludeFiles.sort();\n};\n\nconst IMAGE_EXT = ['.png', '.jpg', '.jpeg', '.gif', '.webp', '.ico', '.svg'];\n"
},
{
"path": "src/compiler/build/build-results.ts",
"content": "import { fromEntries, hasError, isString, normalizeDiagnostics } from '@utils';\n\nimport type * as d from '../../declarations';\nimport { getBuildTimestamp } from './build-ctx';\nimport { generateHmr } from './build-hmr';\n\nexport const generateBuildResults = (config: d.Config, compilerCtx: d.CompilerCtx, buildCtx: d.BuildCtx) => {\n const componentGraph = buildCtx.componentGraph ? fromEntries(buildCtx.componentGraph.entries()) : undefined;\n\n const buildResults: d.CompilerBuildResults = {\n buildId: buildCtx.buildId,\n diagnostics: normalizeDiagnostics(compilerCtx, buildCtx.diagnostics),\n dirsAdded: buildCtx.dirsAdded.slice().sort(),\n dirsDeleted: buildCtx.dirsDeleted.slice().sort(),\n duration: Date.now() - buildCtx.startTime,\n filesAdded: buildCtx.filesAdded.slice().sort(),\n filesChanged: buildCtx.filesChanged.slice().sort(),\n filesDeleted: buildCtx.filesDeleted.slice().sort(),\n filesUpdated: buildCtx.filesUpdated.slice().sort(),\n hasError: hasError(buildCtx.diagnostics),\n hasSuccessfulBuild: compilerCtx.hasSuccessfulBuild,\n isRebuild: buildCtx.isRebuild,\n namespace: config.namespace,\n outputs: compilerCtx.fs.getBuildOutputs(),\n rootDir: config.rootDir,\n srcDir: config.srcDir,\n timestamp: getBuildTimestamp(),\n componentGraph,\n };\n\n const hmr = generateHmr(config, compilerCtx, buildCtx);\n if (hmr != null) {\n buildResults.hmr = hmr;\n }\n\n if (isString(buildCtx.hydrateAppFilePath)) {\n buildResults.hydrateAppFilePath = buildCtx.hydrateAppFilePath;\n }\n\n compilerCtx.lastBuildResults = Object.assign({}, buildResults as any);\n\n return buildResults;\n};\n"
},
{
"path": "src/compiler/build/build-stats.ts",
"content": "import { byteSize, isOutputTargetStats, result, sortBy } from '@utils';\n\nimport type * as d from '../../declarations';\n\n/**\n * Generates the Build Stats from the buildCtx. Writes any files to the file system.\n * @param config the project build configuration\n * @param buildCtx An instance of the build which holds the details about the build\n * @returns CompilerBuildStats or an Object including diagnostics.\n */\nexport function generateBuildStats(\n config: d.ValidatedConfig,\n buildCtx: d.BuildCtx,\n): result.Result {\n // TODO(STENCIL-461): Investigate making this return only a single type\n const buildResults = buildCtx.buildResults;\n\n try {\n if (buildResults.hasError) {\n return result.err({\n diagnostics: buildResults.diagnostics,\n });\n } else {\n const stats: d.CompilerBuildStats = {\n timestamp: buildResults.timestamp,\n compiler: {\n name: config.sys.name,\n version: config.sys.version,\n },\n app: {\n namespace: config.namespace,\n fsNamespace: config.fsNamespace,\n components: Object.keys(buildResults.componentGraph ?? {}).length,\n entries: Object.keys(buildResults.componentGraph ?? {}).length,\n bundles: buildResults.outputs.reduce((total, en) => total + en.files.length, 0),\n outputs: getAppOutputs(config, buildResults),\n },\n options: {\n minifyJs: !!config.minifyJs,\n minifyCss: !!config.minifyCss,\n hashFileNames: !!config.hashFileNames,\n hashedFileNameLength: config.hashedFileNameLength,\n buildEs5: !!config.buildEs5,\n },\n formats: {\n esmBrowser: sanitizeBundlesForStats(buildCtx.esmBrowserComponentBundle),\n esm: sanitizeBundlesForStats(buildCtx.esmComponentBundle),\n es5: sanitizeBundlesForStats(buildCtx.es5ComponentBundle),\n system: sanitizeBundlesForStats(buildCtx.systemComponentBundle),\n commonjs: sanitizeBundlesForStats(buildCtx.commonJsComponentBundle),\n },\n components: getComponentsFileMap(config, buildCtx),\n entries: buildCtx.entryModules,\n componentGraph: buildResults.componentGraph ?? {},\n sourceGraph: getSourceGraph(config, buildCtx),\n rollupResults: buildCtx.rollupResults ?? { modules: [] },\n collections: getCollections(config, buildCtx),\n };\n return result.ok(stats);\n }\n } catch (e: unknown) {\n const diagnostic: d.Diagnostic = {\n level: `error`,\n lines: [],\n messageText: `Generate Build Stats Error: ` + e,\n type: `build`,\n };\n return result.err({\n diagnostics: [diagnostic],\n });\n }\n}\n\n/**\n * Writes the files from the stats config to the file system\n * @param config the project build configuration\n * @param data the information to write out to disk (as specified by each stats output target specified in the provided\n * config)\n */\nexport async function writeBuildStats(\n config: d.ValidatedConfig,\n data: result.Result,\n): Promise {\n const statsTargets = config.outputTargets.filter(isOutputTargetStats);\n\n await result.map(data, async (compilerBuildStats) => {\n await Promise.all(\n statsTargets.map(async (outputTarget) => {\n if (outputTarget.file) {\n const result = await config.sys.writeFile(outputTarget.file, JSON.stringify(compilerBuildStats, null, 2));\n\n if (result.error) {\n config.logger.warn([`Stats failed to write file to ${outputTarget.file}`]);\n }\n }\n }),\n );\n });\n}\n\nfunction sanitizeBundlesForStats(bundleArray: ReadonlyArray): ReadonlyArray {\n if (!bundleArray) {\n return [];\n }\n\n return bundleArray.map((bundle) => {\n return {\n key: bundle.entryKey,\n components: bundle.cmps.map((c) => c.tagName),\n bundleId: bundle.output.bundleId,\n fileName: bundle.output.fileName,\n imports: bundle.rollupResult.imports,\n // code: bundle.rollupResult.code, // (use this to debug)\n // Currently, this number is inaccurate vs what seems to be on disk.\n originalByteSize: byteSize(bundle.rollupResult.code),\n };\n });\n}\n\nfunction getSourceGraph(config: d.ValidatedConfig, buildCtx: d.BuildCtx) {\n const sourceGraph: d.BuildSourceGraph = {};\n\n sortBy(buildCtx.moduleFiles, (m) => m.sourceFilePath).forEach((moduleFile) => {\n const key = relativePath(config, moduleFile.sourceFilePath);\n sourceGraph[key] = moduleFile.localImports.map((localImport) => relativePath(config, localImport)).sort();\n });\n\n return sourceGraph;\n}\n\nfunction getAppOutputs(config: d.ValidatedConfig, buildResults: d.CompilerBuildResults) {\n return buildResults.outputs.map((output) => {\n return {\n name: output.type,\n files: output.files.length,\n generatedFiles: output.files.map((file) => relativePath(config, file)),\n };\n });\n}\n\nfunction getComponentsFileMap(config: d.ValidatedConfig, buildCtx: d.BuildCtx) {\n return buildCtx.components.map((component) => {\n return {\n tag: component.tagName,\n path: relativePath(config, component.jsFilePath),\n source: relativePath(config, component.sourceFilePath),\n elementRef: component.elementRef,\n componentClassName: component.componentClassName,\n assetsDirs: component.assetsDirs,\n dependencies: component.dependencies,\n dependents: component.dependents,\n directDependencies: component.directDependencies,\n directDependents: component.directDependents,\n docs: component.docs,\n encapsulation: component.encapsulation,\n excludeFromCollection: component.excludeFromCollection,\n events: component.events,\n internal: component.internal,\n listeners: component.listeners,\n methods: component.methods,\n potentialCmpRefs: component.potentialCmpRefs,\n properties: component.properties,\n shadowDelegatesFocus: component.shadowDelegatesFocus,\n states: component.states,\n };\n });\n}\n\nfunction getCollections(config: d.ValidatedConfig, buildCtx: d.BuildCtx): d.CompilerBuildStatCollection[] {\n return buildCtx.collections\n .map((c) => {\n return {\n name: c.collectionName,\n source: relativePath(config, c.moduleDir),\n tags: c.moduleFiles.map((m) => m.cmps.map((cmp: d.ComponentCompilerMeta) => cmp.tagName)).sort(),\n };\n })\n .sort((a, b) => {\n if (a.name < b.name) return -1;\n if (a.name > b.name) return 1;\n return 0;\n });\n}\n\nfunction relativePath(config: d.ValidatedConfig, file: string) {\n return config.sys.normalizePath(config.sys.platformPath.relative(config.rootDir, file));\n}\n"
},
{
"path": "src/compiler/build/build.ts",
"content": "import { createDocument } from '@stencil/core/mock-doc';\nimport { catchError, isString, readPackageJson } from '@utils';\nimport ts from 'typescript';\n\nimport type * as d from '../../declarations';\nimport { generateOutputTargets } from '../output-targets';\nimport { emptyOutputTargets } from '../output-targets/empty-dir';\nimport { generateGlobalStyles } from '../style/global-styles';\nimport { runTsProgram, validateTypesAfterGeneration } from '../transpile/run-program';\nimport { buildAbort, buildFinish } from './build-finish';\nimport { writeBuild } from './write-build';\n\nexport const build = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n buildCtx: d.BuildCtx,\n tsBuilder: ts.BuilderProgram,\n) => {\n try {\n // reset process.cwd() for 3rd-party plugins\n process.chdir(config.rootDir);\n\n // empty the directories on the first build\n await emptyOutputTargets(config, compilerCtx, buildCtx);\n if (buildCtx.hasError) return buildAbort(buildCtx);\n\n if (config.srcIndexHtml) {\n const indexSrcHtml = await compilerCtx.fs.readFile(config.srcIndexHtml);\n if (isString(indexSrcHtml)) {\n buildCtx.indexDoc = createDocument(indexSrcHtml);\n }\n }\n\n await readPackageJson(config, compilerCtx, buildCtx);\n if (buildCtx.hasError) return buildAbort(buildCtx);\n\n // run typescript program\n const tsTimeSpan = buildCtx.createTimeSpan('transpile started');\n const emittedDts = await runTsProgram(config, compilerCtx, buildCtx, tsBuilder);\n tsTimeSpan.finish('transpile finished');\n if (buildCtx.hasError) return buildAbort(buildCtx);\n\n // generate types and validate AFTER components.d.ts is written\n const { hasTypesChanged, needsRebuild } = await validateTypesAfterGeneration(\n config,\n compilerCtx,\n buildCtx,\n tsBuilder,\n emittedDts,\n );\n if (buildCtx.hasError) return buildAbort(buildCtx);\n\n if (needsRebuild || (config.watch && hasTypesChanged)) {\n // Abort and signal that a rebuild is needed:\n // - needsRebuild: components.d.ts was just generated, need fresh TS program\n // - watch mode with types changed: let watch trigger rebuild\n return null;\n }\n\n // preprocess and generate styles before any outputTarget starts\n buildCtx.stylesPromise = generateGlobalStyles(config, compilerCtx, buildCtx);\n if (buildCtx.hasError) return buildAbort(buildCtx);\n\n // create outputs\n await generateOutputTargets(config, compilerCtx, buildCtx);\n if (buildCtx.hasError) return buildAbort(buildCtx);\n\n // write outputs\n await buildCtx.stylesPromise;\n await writeBuild(config, compilerCtx, buildCtx);\n } catch (e: any) {\n // ¯\\_(ツ)_/¯\n catchError(buildCtx.diagnostics, e);\n }\n\n // TODO\n // clear changed files\n compilerCtx.changedFiles.clear();\n\n // return what we've learned today\n return buildFinish(buildCtx);\n};\n"
},
{
"path": "src/compiler/build/compiler-ctx.ts",
"content": "import { join, noop, normalizePath } from '@utils';\nimport { basename, dirname, extname } from 'path';\n\nimport type * as d from '../../declarations';\nimport { buildEvents } from '../events';\nimport { InMemoryFileSystem } from '../sys/in-memory-fs';\n\n/**\n * The CompilerCtx is a persistent object that's reused throughout\n * all builds and rebuilds. The data within this object is used\n * for in-memory caching, and can be reset, but the object itself\n * is always the same.\n */\nexport class CompilerContext implements d.CompilerCtx {\n version = 2;\n activeBuildId = -1;\n activeFilesAdded: string[] = [];\n activeFilesDeleted: string[] = [];\n activeFilesUpdated: string[] = [];\n activeDirsAdded: string[] = [];\n activeDirsDeleted: string[] = [];\n addWatchDir: (path: string) => void = noop;\n addWatchFile: (path: string) => void = noop;\n cache: d.Cache;\n cssModuleImports = new Map();\n changedFiles = new Set();\n changedModules = new Set();\n collections: d.CollectionCompilerMeta[] = [];\n compilerOptions: any = null;\n events = buildEvents();\n fs: InMemoryFileSystem;\n hasSuccessfulBuild = false;\n isActivelyBuilding = false;\n lastBuildResults: d.CompilerBuildResults = null;\n moduleMap: d.ModuleMap = new Map();\n nodeMap = new WeakMap();\n resolvedCollections = new Set();\n rollupCache = new Map();\n rollupCacheHydrate: any = null;\n rollupCacheLazy: any = null;\n rollupCacheNative: any = null;\n cachedGlobalStyle: string;\n styleModeNames = new Set();\n worker: d.CompilerWorkerContext = null;\n\n reset() {\n this.cache.clear();\n this.cssModuleImports.clear();\n this.cachedGlobalStyle = null;\n this.collections.length = 0;\n this.compilerOptions = null;\n this.hasSuccessfulBuild = false;\n this.rollupCacheHydrate = null;\n this.rollupCacheLazy = null;\n this.rollupCacheNative = null;\n this.moduleMap.clear();\n this.resolvedCollections.clear();\n\n if (this.fs != null) {\n this.fs.clearCache();\n }\n }\n}\n\n/**\n * Get a {@link d.Module} from the current compiler context which corresponds\n * to a supplied source file path. If a module record corresponding to the\n * supplied path is not yet allocated, create one, save it in the compiler\n * context, and then return the module record.\n *\n * @param compilerCtx the current compiler context\n * @param sourceFilePath the path for which we want a module record\n * @returns a module record corresponding to the supplied source file path\n */\nexport const getModuleLegacy = (compilerCtx: d.CompilerCtx, sourceFilePath: string): d.Module => {\n sourceFilePath = normalizePath(sourceFilePath);\n\n const moduleFile = compilerCtx.moduleMap.get(sourceFilePath);\n if (moduleFile != null) {\n return moduleFile;\n } else {\n const sourceFileDir = dirname(sourceFilePath);\n const sourceFileExt = extname(sourceFilePath);\n const sourceFileName = basename(sourceFilePath, sourceFileExt);\n const jsFilePath = join(sourceFileDir, sourceFileName + '.js');\n\n const moduleFile: d.Module = {\n sourceFilePath: sourceFilePath,\n jsFilePath: jsFilePath,\n cmps: [],\n isExtended: false,\n isMixin: false,\n hasExportableMixins: false,\n coreRuntimeApis: [],\n outputTargetCoreRuntimeApis: {},\n collectionName: null,\n dtsFilePath: null,\n excludeFromCollection: false,\n externalImports: [],\n hasVdomAttribute: false,\n hasVdomXlink: false,\n hasVdomClass: false,\n hasVdomFunctional: false,\n hasVdomKey: false,\n hasVdomListener: false,\n hasVdomPropOrAttr: false,\n hasVdomRef: false,\n hasVdomRender: false,\n hasVdomStyle: false,\n hasVdomText: false,\n htmlAttrNames: [],\n htmlTagNames: [],\n htmlParts: [],\n isCollectionDependency: false,\n isLegacy: false,\n localImports: [],\n functionalComponentDeps: [],\n originalCollectionComponentPath: null,\n originalImports: [],\n potentialCmpRefs: [],\n staticSourceFile: null,\n staticSourceFileText: '',\n sourceMapPath: null,\n sourceMapFileText: null,\n };\n compilerCtx.moduleMap.set(sourceFilePath, moduleFile);\n return moduleFile;\n }\n};\n\n/**\n * Reset a module record, mutating the supplied object to reset values to\n * defaults.\n *\n * @param moduleFile the module record to reset\n */\nexport const resetModuleLegacy = (moduleFile: d.Module) => {\n moduleFile.cmps.length = 0;\n moduleFile.coreRuntimeApis.length = 0;\n moduleFile.collectionName = null;\n moduleFile.dtsFilePath = null;\n moduleFile.excludeFromCollection = false;\n moduleFile.externalImports.length = 0;\n moduleFile.isCollectionDependency = false;\n moduleFile.localImports.length = 0;\n moduleFile.originalCollectionComponentPath = null;\n moduleFile.originalImports.length = 0;\n\n moduleFile.hasVdomXlink = false;\n moduleFile.hasVdomAttribute = false;\n moduleFile.hasVdomClass = false;\n moduleFile.hasVdomFunctional = false;\n moduleFile.hasVdomKey = false;\n moduleFile.hasVdomListener = false;\n moduleFile.hasVdomRef = false;\n moduleFile.hasVdomRender = false;\n moduleFile.hasVdomStyle = false;\n moduleFile.hasVdomText = false;\n moduleFile.htmlAttrNames.length = 0;\n moduleFile.htmlTagNames.length = 0;\n moduleFile.potentialCmpRefs.length = 0;\n};\n"
},
{
"path": "src/compiler/build/full-build.ts",
"content": "import ts from 'typescript';\n\nimport type * as d from '../../declarations';\nimport { createTsBuildProgram } from '../transpile/create-build-program';\nimport { build } from './build';\nimport { BuildContext } from './build-ctx';\n\n/**\n * Build a callable function to perform a full build of a Stencil project\n * @param config a Stencil configuration to apply to a full build of a Stencil project\n * @param compilerCtx the current Stencil compiler context\n * @returns the results of a full build of Stencil\n */\nexport const createFullBuild = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n): Promise => {\n return new Promise((resolve) => {\n let tsWatchProgram: ts.WatchOfConfigFile = null;\n\n compilerCtx.events.on('fileUpdate', (p) => {\n config.logger.debug(`fileUpdate: ${p}`);\n compilerCtx.fs.clearFileCache(p);\n });\n\n /**\n * A function that kicks off the transpilation process for both the TypeScript and Stencil compilers\n * @param tsBuilder the manager of the {@link ts.Program} state\n */\n const onBuild = async (tsBuilder: ts.BuilderProgram): Promise => {\n const buildCtx = new BuildContext(config, compilerCtx);\n buildCtx.isRebuild = false;\n buildCtx.requiresFullBuild = true;\n buildCtx.start();\n\n const result = await build(config, compilerCtx, buildCtx, tsBuilder);\n if (result !== null) {\n if (tsWatchProgram) {\n tsWatchProgram.close();\n tsWatchProgram = null;\n }\n resolve(result);\n } else {\n // Build returned null, indicating a rebuild is needed (e.g., components.d.ts was just generated).\n // Close the current TS program and create a fresh one that includes components.d.ts.\n if (tsWatchProgram) {\n tsWatchProgram.close();\n tsWatchProgram = null;\n }\n config.logger.debug('Rebuilding with fresh TypeScript program after components.d.ts generation');\n createTsBuildProgram(config, onBuild).then((program) => {\n tsWatchProgram = program;\n });\n }\n };\n\n createTsBuildProgram(config, onBuild).then((program) => {\n tsWatchProgram = program;\n });\n });\n};\n"
},
{
"path": "src/compiler/build/test/build-stats.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\nimport { mockBuildCtx, mockCompilerCtx, mockValidatedConfig } from '@stencil/core/testing';\nimport { result } from '@utils';\n\nimport { generateBuildResults } from '../build-results';\nimport { generateBuildStats } from '../build-stats';\n\ndescribe('generateBuildStats', () => {\n let config: d.ValidatedConfig;\n let compilerCtx: d.CompilerCtx;\n let buildCtx: d.BuildCtx;\n\n beforeEach(() => {\n config = mockValidatedConfig();\n compilerCtx = mockCompilerCtx(config);\n buildCtx = mockBuildCtx(config, compilerCtx);\n });\n\n it('should return a structured json object', async () => {\n buildCtx.buildResults = generateBuildResults(config, compilerCtx, buildCtx);\n\n const compilerBuildStats = result.unwrap(generateBuildStats(config, buildCtx));\n\n if (compilerBuildStats.hasOwnProperty('timestamp')) {\n delete compilerBuildStats.timestamp;\n }\n\n if (compilerBuildStats.hasOwnProperty('compiler') && compilerBuildStats.compiler.hasOwnProperty('version')) {\n delete compilerBuildStats.compiler.version;\n }\n\n expect(compilerBuildStats).toStrictEqual({\n app: { bundles: 0, components: 0, entries: 0, fsNamespace: 'testing', namespace: 'Testing', outputs: [] },\n collections: [],\n compiler: { name: 'in-memory' },\n componentGraph: {},\n components: [],\n entries: [],\n formats: { commonjs: [], es5: [], esm: [], esmBrowser: [], system: [] },\n options: {\n buildEs5: false,\n hashFileNames: false,\n hashedFileNameLength: 8,\n minifyCss: false,\n minifyJs: false,\n },\n rollupResults: {\n modules: [],\n },\n sourceGraph: {},\n });\n });\n\n it('should return diagnostics if an error is hit', async () => {\n buildCtx.buildResults = generateBuildResults(config, compilerCtx, buildCtx);\n\n buildCtx.buildResults.hasError = true;\n const diagnostic: d.Diagnostic = {\n level: 'error',\n type: 'horrible',\n messageText: 'the worst error _possible_ has just occurred',\n lines: [],\n };\n buildCtx.buildResults.diagnostics = [diagnostic];\n const diagnostics = result.unwrapErr(generateBuildStats(config, buildCtx));\n\n expect(diagnostics).toStrictEqual({\n diagnostics: [diagnostic],\n });\n });\n});\n"
},
{
"path": "src/compiler/build/test/write-export-maps.spec.ts",
"content": "import { mockBuildCtx, mockValidatedConfig } from '@stencil/core/testing';\nimport childProcess from 'child_process';\n\nimport * as d from '../../../declarations';\nimport { stubComponentCompilerMeta } from '../../types/tests/ComponentCompilerMeta.stub';\nimport { writeExportMaps } from '../write-export-maps';\n\ndescribe('writeExportMaps', () => {\n let config: d.ValidatedConfig;\n let buildCtx: d.BuildCtx;\n let execSyncSpy: jest.SpyInstance;\n\n beforeEach(() => {\n config = mockValidatedConfig();\n buildCtx = mockBuildCtx(config);\n\n execSyncSpy = jest.spyOn(childProcess, 'execSync').mockImplementation(() => '');\n });\n\n afterEach(() => {\n jest.clearAllMocks();\n });\n\n it('should not generate any exports if there are no output targets', () => {\n writeExportMaps(config, buildCtx);\n\n expect(execSyncSpy).toHaveBeenCalledTimes(0);\n });\n\n it('should generate the default exports for the lazy build if present', () => {\n config.outputTargets = [\n {\n type: 'dist',\n dir: '/dist',\n typesDir: '/dist/types',\n },\n ];\n\n writeExportMaps(config, buildCtx);\n\n expect(execSyncSpy).toHaveBeenCalledTimes(3);\n expect(execSyncSpy).toHaveBeenCalledWith(`npm pkg set \"exports[.][import]\"=\"./dist/index.js\"`);\n expect(execSyncSpy).toHaveBeenCalledWith(`npm pkg set \"exports[.][require]\"=\"./dist/index.cjs.js\"`);\n expect(execSyncSpy).toHaveBeenCalledWith(`npm pkg set \"exports[.][types]\"=\"./dist/types/index.d.ts\"`);\n });\n\n it('should generate the default exports for the custom elements build if present', () => {\n config.outputTargets = [\n {\n type: 'dist-custom-elements',\n dir: '/dist/components',\n generateTypeDeclarations: true,\n },\n ];\n\n writeExportMaps(config, buildCtx);\n\n expect(execSyncSpy).toHaveBeenCalledTimes(2);\n expect(execSyncSpy).toHaveBeenCalledWith(`npm pkg set \"exports[.][import]\"=\"./dist/components/index.js\"`);\n expect(execSyncSpy).toHaveBeenCalledWith(`npm pkg set \"exports[.][types]\"=\"./dist/components/index.d.ts\"`);\n });\n\n it('should generate the lazy loader exports if the output target is present', () => {\n config.rootDir = '/';\n config.outputTargets.push({\n type: 'dist-lazy-loader',\n dir: '/dist/lazy-loader',\n empty: true,\n esmDir: '/dist/esm',\n cjsDir: '/dist/cjs',\n componentDts: '/dist/components.d.ts',\n });\n\n writeExportMaps(config, buildCtx);\n\n expect(execSyncSpy).toHaveBeenCalledTimes(3);\n expect(execSyncSpy).toHaveBeenCalledWith(`npm pkg set \"exports[./loader][import]\"=\"./dist/lazy-loader/index.js\"`);\n expect(execSyncSpy).toHaveBeenCalledWith(`npm pkg set \"exports[./loader][require]\"=\"./dist/lazy-loader/index.cjs\"`);\n expect(execSyncSpy).toHaveBeenCalledWith(`npm pkg set \"exports[./loader][types]\"=\"./dist/lazy-loader/index.d.ts\"`);\n });\n\n it('should generate the custom elements exports if the output target is present', () => {\n config.rootDir = '/';\n config.outputTargets.push({\n type: 'dist-custom-elements',\n dir: '/dist/components',\n generateTypeDeclarations: true,\n });\n\n buildCtx.components = [\n stubComponentCompilerMeta({\n tagName: 'my-component',\n componentClassName: 'MyComponent',\n }),\n ];\n\n writeExportMaps(config, buildCtx);\n\n expect(execSyncSpy).toHaveBeenCalledTimes(4);\n expect(execSyncSpy).toHaveBeenCalledWith(\n `npm pkg set \"exports[./my-component][import]\"=\"./dist/components/my-component.js\"`,\n );\n expect(execSyncSpy).toHaveBeenCalledWith(\n `npm pkg set \"exports[./my-component][types]\"=\"./dist/components/my-component.d.ts\"`,\n );\n });\n\n it('should generate the custom elements exports for multiple components', () => {\n config.rootDir = '/';\n config.outputTargets.push({\n type: 'dist-custom-elements',\n dir: '/dist/components',\n generateTypeDeclarations: true,\n });\n\n buildCtx.components = [\n stubComponentCompilerMeta({\n tagName: 'my-component',\n componentClassName: 'MyComponent',\n }),\n stubComponentCompilerMeta({\n tagName: 'my-other-component',\n componentClassName: 'MyOtherComponent',\n }),\n ];\n\n writeExportMaps(config, buildCtx);\n\n expect(execSyncSpy).toHaveBeenCalledTimes(6);\n expect(execSyncSpy).toHaveBeenCalledWith(\n `npm pkg set \"exports[./my-component][import]\"=\"./dist/components/my-component.js\"`,\n );\n expect(execSyncSpy).toHaveBeenCalledWith(\n `npm pkg set \"exports[./my-component][types]\"=\"./dist/components/my-component.d.ts\"`,\n );\n expect(execSyncSpy).toHaveBeenCalledWith(\n `npm pkg set \"exports[./my-other-component][import]\"=\"./dist/components/my-other-component.js\"`,\n );\n expect(execSyncSpy).toHaveBeenCalledWith(\n `npm pkg set \"exports[./my-other-component][types]\"=\"./dist/components/my-other-component.d.ts\"`,\n );\n });\n});\n"
},
{
"path": "src/compiler/build/validate-files.ts",
"content": "import type * as d from '../../declarations';\nimport { validateManifestJson } from '../html/validate-manifest-json';\nimport { validateBuildPackageJson } from '../types/validate-build-package-json';\n\n/**\n * Validate the existence and contents of certain files that were generated after writing the results of the build to\n * disk\n * @param config the Stencil configuration used for the build\n * @param compilerCtx the compiler context associated with the build\n * @param buildCtx the build context associated with the current build\n * @returns an array containing empty-Promise results\n */\nexport const validateBuildFiles = (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n buildCtx: d.BuildCtx,\n): Promise<(void | void[] | null)[]> | null => {\n if (buildCtx.hasError) {\n return null;\n }\n\n return Promise.all([\n validateBuildPackageJson(config, compilerCtx, buildCtx),\n validateManifestJson(config, compilerCtx, buildCtx),\n ]);\n};\n"
},
{
"path": "src/compiler/build/watch-build.ts",
"content": "import { isString, resolve } from '@utils';\nimport { dirname } from 'path';\nimport type ts from 'typescript';\n\nimport type * as d from '../../declarations';\nimport { compilerRequest } from '../bundle/dev-module';\nimport {\n filesChanged,\n hasHtmlChanges,\n hasScriptChanges,\n hasStyleChanges,\n isWatchIgnorePath,\n scriptsAdded,\n scriptsDeleted,\n} from '../fs-watch/fs-watch-rebuild';\nimport { hasServiceWorkerChanges } from '../service-worker/generate-sw';\nimport { createTsWatchProgram } from '../transpile/create-watch-program';\nimport { build } from './build';\nimport { BuildContext } from './build-ctx';\n\n/**\n * This method contains context and functionality for a TS watch build. This is called via\n * the compiler when running a build in watch mode (i.e. `stencil build --watch`).\n *\n * In essence, this method tracks all files that change while the program is running to trigger\n * a rebuild of a Stencil project using a {@link ts.EmitAndSemanticDiagnosticsBuilderProgram}.\n *\n * @param config The validated config for the Stencil project\n * @param compilerCtx The compiler context for the project\n * @returns An object containing helper methods for the dev-server's watch program\n */\nexport const createWatchBuild = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n): Promise => {\n let isRebuild = false;\n let tsWatchProgram: {\n program: ts.WatchOfConfigFile;\n rebuild: () => void;\n };\n let closeResolver: Function;\n const watchWaiter = new Promise((resolve) => (closeResolver = resolve));\n\n const dirsAdded = new Set();\n const dirsDeleted = new Set();\n const filesAdded = new Set();\n const filesUpdated = new Set();\n const filesDeleted = new Set();\n\n /**\n * A callback function that is invoked to trigger a rebuild of a Stencil project. This will\n * update the build context with the associated file changes (these are used downstream to trigger\n * HMR) and then calls the `build()` function to execute the Stencil build.\n *\n * @param tsBuilder A {@link ts.BuilderProgram} to be passed to the `build()` function.\n */\n const onBuild = async (tsBuilder: ts.BuilderProgram) => {\n const buildCtx = new BuildContext(config, compilerCtx);\n buildCtx.isRebuild = isRebuild;\n buildCtx.requiresFullBuild = !isRebuild;\n buildCtx.dirsAdded = Array.from(dirsAdded.keys()).sort();\n buildCtx.dirsDeleted = Array.from(dirsDeleted.keys()).sort();\n buildCtx.filesAdded = Array.from(filesAdded.keys()).sort();\n buildCtx.filesUpdated = Array.from(filesUpdated.keys()).sort();\n buildCtx.filesDeleted = Array.from(filesDeleted.keys()).sort();\n buildCtx.filesChanged = filesChanged(buildCtx);\n buildCtx.scriptsAdded = scriptsAdded(buildCtx);\n buildCtx.scriptsDeleted = scriptsDeleted(buildCtx);\n buildCtx.hasScriptChanges = hasScriptChanges(buildCtx);\n buildCtx.hasStyleChanges = hasStyleChanges(buildCtx);\n buildCtx.hasHtmlChanges = hasHtmlChanges(config, buildCtx);\n buildCtx.hasServiceWorkerChanges = hasServiceWorkerChanges(config, buildCtx);\n\n if (config.flags.debug) {\n config.logger.debug(`WATCH_BUILD::watchBuild::onBuild filesAdded: ${formatFilesForDebug(buildCtx.filesAdded)}`);\n config.logger.debug(\n `WATCH_BUILD::watchBuild::onBuild filesDeleted: ${formatFilesForDebug(buildCtx.filesDeleted)}`,\n );\n config.logger.debug(\n `WATCH_BUILD::watchBuild::onBuild filesUpdated: ${formatFilesForDebug(buildCtx.filesUpdated)}`,\n );\n config.logger.debug(\n `WATCH_BUILD::watchBuild::onBuild filesWritten: ${formatFilesForDebug(buildCtx.filesWritten)}`,\n );\n }\n\n // Make sure all files in the module map are still in the fs\n // Otherwise, we can run into build errors because the compiler can think\n // there are two component files with the same tag name\n Array.from(compilerCtx.moduleMap.keys()).forEach((key) => {\n if (filesUpdated.has(key) || filesDeleted.has(key)) {\n // Check if the file exists in the fs\n const fileExists = compilerCtx.fs.accessSync(key);\n if (!fileExists) {\n compilerCtx.moduleMap.delete(key);\n }\n }\n });\n\n // Make sure all added/updated files are watched\n // We need to check both added/updates since the TS watch program behaves kinda weird\n // and doesn't always handle file renames the same way\n new Set([...filesUpdated, ...filesAdded]).forEach((filePath) => {\n compilerCtx.addWatchFile(filePath);\n });\n\n dirsAdded.clear();\n dirsDeleted.clear();\n filesAdded.clear();\n filesUpdated.clear();\n filesDeleted.clear();\n\n emitFsChange(compilerCtx, buildCtx);\n\n buildCtx.start();\n\n // Rebuild the project\n const result = await build(config, compilerCtx, buildCtx, tsBuilder);\n\n if (result && !result.hasError) {\n isRebuild = true;\n }\n };\n\n /**\n * Utility method for formatting a debug message that must either list a number of files, or the word 'none' if the\n * provided list is empty\n *\n * @param files a list of files, the list may be empty\n * @returns the provided list if it is not empty. otherwise, return the word 'none'\n */\n const formatFilesForDebug = (files: ReadonlyArray): string => {\n /**\n * In the created message, it's important that there's no whitespace prior to the file name.\n * Stencil's logger will split messages by whitespace according to the width of the terminal window.\n * Since file names can be fully qualified paths (and therefore quite long), putting whitespace between a '-' and\n * the path can lead to formatted messages where the '-' is on its own line\n */\n return files.length > 0 ? files.map((filename: string) => `-${filename}`).join('\\n') : 'none';\n };\n\n /**\n * Utility method to start/construct the watch program. This will mark\n * all relevant files to be watched and then call a method to build the TS\n * program responsible for building the project.\n *\n * @returns A promise of the result of creating the watch program.\n */\n const start = async () => {\n /**\n * Stencil watches the following directories for changes:\n */\n await Promise.all([\n /**\n * the `srcDir` directory, e.g. component files\n */\n watchFiles(compilerCtx, config.srcDir),\n /**\n * the root directory, e.g. `stencil.config.ts`\n */\n watchFiles(compilerCtx, config.rootDir, {\n recursive: false,\n }),\n /**\n * the external directories, defined in `watchExternalDirs`, e.g. `node_modules`\n */\n ...(config.watchExternalDirs || []).map((dir) => watchFiles(compilerCtx, dir)),\n ]);\n\n tsWatchProgram = await createTsWatchProgram(config, onBuild);\n return watchWaiter;\n };\n\n /**\n * A map of absolute directory paths and their associated {@link d.CompilerFileWatcher} (which contains\n * the ability to teardown the watcher for the specific directory)\n */\n const watchingDirs = new Map();\n /**\n * A map of absolute file paths and their associated {@link d.CompilerFileWatcher} (which contains\n * the ability to teardown the watcher for the specific file)\n */\n const watchingFiles = new Map();\n\n /**\n * Callback method that will execute whenever TS alerts us that a file change\n * has occurred. This will update the appropriate set with the file path based on the\n * type of change, and then will kick off a rebuild of the project.\n *\n * @param filePath The absolute path to the file in the Stencil project\n * @param eventKind The type of file change that occurred (update, add, delete)\n */\n const onFsChange: d.CompilerFileWatcherCallback = (filePath, eventKind) => {\n if (tsWatchProgram && !isWatchIgnorePath(config, filePath)) {\n updateCompilerCtxCache(config, compilerCtx, filePath, eventKind);\n\n switch (eventKind) {\n case 'dirAdd':\n dirsAdded.add(filePath);\n break;\n case 'dirDelete':\n dirsDeleted.add(filePath);\n break;\n case 'fileAdd':\n filesAdded.add(filePath);\n break;\n case 'fileUpdate':\n filesUpdated.add(filePath);\n break;\n case 'fileDelete':\n filesDeleted.add(filePath);\n break;\n }\n\n config.logger.debug(\n `WATCH_BUILD::fs_event_change - type=${eventKind}, path=${filePath}, time=${new Date().getTime()}`,\n );\n\n // Trigger a rebuild of the project\n tsWatchProgram.rebuild();\n }\n };\n\n /**\n * Callback method that will execute when TS alerts us that a directory modification has occurred.\n * This will just call the `onFsChange()` callback method with the same arguments.\n *\n * @param filePath The absolute path to the file in the Stencil project\n * @param eventKind The type of file change that occurred (update, add, delete)\n */\n const onDirChange: d.CompilerFileWatcherCallback = (filePath, eventKind) => {\n if (eventKind != null) {\n onFsChange(filePath, eventKind);\n }\n };\n\n /**\n * Utility method to teardown the TS watch program and close/clear all watched files.\n *\n * @returns An object with the `exitCode` status of the teardown.\n */\n const close = async () => {\n watchingDirs.forEach((w) => w.close());\n watchingFiles.forEach((w) => w.close());\n watchingDirs.clear();\n watchingFiles.clear();\n\n if (tsWatchProgram) {\n tsWatchProgram.program.close();\n tsWatchProgram = null;\n }\n\n const watcherCloseResults: d.WatcherCloseResults = {\n exitCode: 0,\n };\n closeResolver(watcherCloseResults);\n return watcherCloseResults;\n };\n\n const request = async (data: d.CompilerRequest) => compilerRequest(config, compilerCtx, data);\n\n // Add a definition to the `compilerCtx` for `addWatchFile`\n // This method will add the specified file path to the watched files collection and instruct\n // the `CompilerSystem` what to do when a file change occurs (the `onFsChange()` callback)\n compilerCtx.addWatchFile = (filePath) => {\n if (isString(filePath) && !watchingFiles.has(filePath) && !isWatchIgnorePath(config, filePath)) {\n watchingFiles.set(filePath, config.sys.watchFile(filePath, onFsChange));\n }\n };\n\n // Add a definition to the `compilerCtx` for `addWatchDir`\n // This method will add the specified file path to the watched directories collection and instruct\n // the `CompilerSystem` what to do when a directory change occurs (the `onDirChange()` callback)\n compilerCtx.addWatchDir = (dirPath, recursive) => {\n if (isString(dirPath) && !watchingDirs.has(dirPath) && !isWatchIgnorePath(config, dirPath)) {\n watchingDirs.set(dirPath, config.sys.watchDirectory(dirPath, onDirChange, recursive));\n }\n };\n\n // When the compiler system destroys, we need to also destroy this watch program\n config.sys.addDestroy(close);\n\n return {\n start,\n close,\n on: compilerCtx.events.on,\n request,\n };\n};\n\n/**\n * A list of directories that are excluded from being watched for changes.\n */\nconst EXCLUDE_DIRS = ['.cache', '.git', '.github', '.stencil', '.vscode', 'node_modules'];\n\n/**\n * A list of file extensions that are excluded from being watched for changes.\n */\nconst EXCLUDE_EXTENSIONS = [\n '.md',\n '.markdown',\n '.txt',\n '.spec.ts',\n '.spec.tsx',\n '.e2e.ts',\n '.e2e.tsx',\n '.gitignore',\n '.editorconfig',\n];\n\n/**\n * Marks all root files of a Stencil project to be watched for changes. Whenever\n * one of these files is determined as changed (according to TS), a rebuild of the project will execute.\n *\n * @param compilerCtx The compiler context for the Stencil project\n * @param dir The directory to watch for changes\n * @param options The options to watch files in the directory\n * @param options.recursive Whether to watch files recursively\n * @param options.excludeDirNames A list of directories to exclude from being watched\n * @param options.excludeExtensions A list of file extensions to exclude from being watched for changes\n */\nconst watchFiles = async (\n compilerCtx: d.CompilerCtx,\n dir: string,\n options?: {\n recursive?: boolean;\n excludeDirNames?: string[];\n excludeExtensions?: string[];\n },\n) => {\n const recursive = options?.recursive ?? true;\n const excludeDirNames = options?.excludeDirNames ?? EXCLUDE_DIRS;\n const excludeExtensions = options?.excludeExtensions ?? EXCLUDE_EXTENSIONS;\n\n /**\n * non-src files that cause a rebuild\n * mainly for root level config files, and getting an event when they change\n */\n const rootFiles = await compilerCtx.fs.readdir(dir, {\n recursive,\n excludeDirNames,\n excludeExtensions,\n });\n\n /**\n * If the directory is watched recursively, we need to watch the directory itself.\n */\n if (recursive) {\n compilerCtx.addWatchDir(dir, true);\n }\n\n /**\n * Iterate over each file in the collection (filter out directories) and add\n * a watcher for each\n */\n rootFiles.filter(({ isFile }) => isFile).forEach(({ absPath }) => compilerCtx.addWatchFile(absPath));\n};\n\nconst emitFsChange = (compilerCtx: d.CompilerCtx, buildCtx: BuildContext) => {\n if (\n buildCtx.dirsAdded.length > 0 ||\n buildCtx.dirsDeleted.length > 0 ||\n buildCtx.filesUpdated.length > 0 ||\n buildCtx.filesAdded.length > 0 ||\n buildCtx.filesDeleted.length > 0\n ) {\n compilerCtx.events.emit('fsChange', {\n dirsAdded: buildCtx.dirsAdded.slice(),\n dirsDeleted: buildCtx.dirsDeleted.slice(),\n filesUpdated: buildCtx.filesUpdated.slice(),\n filesAdded: buildCtx.filesAdded.slice(),\n filesDeleted: buildCtx.filesDeleted.slice(),\n });\n }\n};\n\nconst updateCompilerCtxCache = (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n path: string,\n kind: d.CompilerFileWatcherEvent,\n) => {\n compilerCtx.fs.clearFileCache(path);\n compilerCtx.changedFiles.add(path);\n\n if (kind === 'fileDelete') {\n compilerCtx.moduleMap.delete(path);\n } else if (kind === 'dirDelete') {\n const fsRootDir = resolve('/');\n compilerCtx.moduleMap.forEach((_, moduleFilePath) => {\n let moduleAncestorDir = dirname(moduleFilePath);\n\n for (let i = 0; i < 50; i++) {\n if (moduleAncestorDir === config.rootDir || moduleAncestorDir === fsRootDir) {\n break;\n }\n\n if (moduleAncestorDir === path) {\n compilerCtx.fs.clearFileCache(moduleFilePath);\n compilerCtx.moduleMap.delete(moduleFilePath);\n compilerCtx.changedFiles.add(moduleFilePath);\n break;\n }\n\n moduleAncestorDir = dirname(moduleAncestorDir);\n }\n });\n }\n};\n"
},
{
"path": "src/compiler/build/write-build.ts",
"content": "import { catchError } from '@utils';\n\nimport * as d from '../../declarations';\nimport { outputServiceWorkers } from '../output-targets/output-service-workers';\nimport { validateBuildFiles } from './validate-files';\nimport { writeExportMaps } from './write-export-maps';\n\n/**\n * Writes files to disk as a result of compilation\n * @param config the Stencil configuration used for the build\n * @param compilerCtx the compiler context associated with the build\n * @param buildCtx the build context associated with the current build\n */\nexport const writeBuild = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n buildCtx: d.BuildCtx,\n): Promise => {\n const timeSpan = buildCtx.createTimeSpan(`writeBuildFiles started`, true);\n\n let totalFilesWrote = 0;\n\n try {\n // commit all the `writeFile`, `mkdir`, `rmdir` and `unlink` operations to disk\n const commitResults = await compilerCtx.fs.commit();\n\n // get the results from the write to disk commit\n buildCtx.filesWritten = commitResults.filesWritten;\n buildCtx.filesDeleted = commitResults.filesDeleted;\n buildCtx.dirsDeleted = commitResults.dirsDeleted;\n buildCtx.dirsAdded = commitResults.dirsAdded;\n totalFilesWrote = commitResults.filesWritten.length;\n\n // successful write\n // kick off writing the cached file stuff\n await compilerCtx.cache.commit();\n buildCtx.debug(`in-memory-fs: ${compilerCtx.fs.getMemoryStats()}`);\n buildCtx.debug(`cache: ${compilerCtx.cache.getMemoryStats()}`);\n\n if (config.generateExportMaps) {\n writeExportMaps(config, buildCtx);\n }\n\n await outputServiceWorkers(config, buildCtx);\n await validateBuildFiles(config, compilerCtx, buildCtx);\n } catch (e: any) {\n catchError(buildCtx.diagnostics, e);\n }\n\n timeSpan.finish(`writeBuildFiles finished, files wrote: ${totalFilesWrote}`);\n};\n"
},
{
"path": "src/compiler/build/write-export-maps.ts",
"content": "import {\n isEligiblePrimaryPackageOutputTarget,\n isOutputTargetDistCustomElements,\n isOutputTargetDistLazyLoader,\n} from '@utils';\nimport { relative } from '@utils';\nimport { execSync } from 'child_process';\n\nimport * as d from '../../declarations';\nimport { PRIMARY_PACKAGE_TARGET_CONFIGS } from '../types/validate-primary-package-output-target';\n\n/**\n * Create export map entry point definitions for the `package.json` file using the npm CLI.\n * This will generate a root entry point for the package, as well as entry points for each component and\n * the lazy loader (if applicable).\n *\n * @param config The validated Stencil config\n * @param buildCtx The build context containing the components to generate export maps for\n */\nexport const writeExportMaps = (config: d.ValidatedConfig, buildCtx: d.BuildCtx) => {\n const eligiblePrimaryTargets = config.outputTargets.filter(isEligiblePrimaryPackageOutputTarget);\n if (eligiblePrimaryTargets.length > 0) {\n const primaryTarget =\n eligiblePrimaryTargets.find((o) => o.isPrimaryPackageOutputTarget) ?? eligiblePrimaryTargets[0];\n const outputTargetConfig = PRIMARY_PACKAGE_TARGET_CONFIGS[primaryTarget.type];\n\n if (outputTargetConfig.getModulePath) {\n const importPath = outputTargetConfig.getModulePath(config.rootDir, primaryTarget.dir!);\n\n if (importPath) {\n execSync(`npm pkg set \"exports[.][import]\"=\"${importPath}\"`);\n }\n }\n\n if (outputTargetConfig.getMainPath) {\n const requirePath = outputTargetConfig.getMainPath(config.rootDir, primaryTarget.dir!);\n\n if (requirePath) {\n execSync(`npm pkg set \"exports[.][require]\"=\"${requirePath}\"`);\n }\n }\n\n if (outputTargetConfig.getTypesPath) {\n const typesPath = outputTargetConfig.getTypesPath(config.rootDir, primaryTarget);\n\n if (typesPath) {\n execSync(`npm pkg set \"exports[.][types]\"=\"${typesPath}\"`);\n }\n }\n }\n\n const distLazyLoader = config.outputTargets.find(isOutputTargetDistLazyLoader);\n if (distLazyLoader != null) {\n // Calculate relative path from project root to lazy-loader output directory\n let outDir = relative(config.rootDir, distLazyLoader.dir);\n if (!outDir.startsWith('.')) {\n outDir = './' + outDir;\n }\n\n execSync(`npm pkg set \"exports[./loader][import]\"=\"${outDir}/index.js\"`);\n execSync(`npm pkg set \"exports[./loader][require]\"=\"${outDir}/index.cjs\"`);\n execSync(`npm pkg set \"exports[./loader][types]\"=\"${outDir}/index.d.ts\"`);\n }\n\n const distCustomElements = config.outputTargets.find(isOutputTargetDistCustomElements);\n if (distCustomElements != null) {\n // Calculate relative path from project root to custom elements output directory\n let outDir = relative(config.rootDir, distCustomElements.dir!);\n if (!outDir.startsWith('.')) {\n outDir = './' + outDir;\n }\n\n buildCtx.components.forEach((cmp) => {\n execSync(`npm pkg set \"exports[./${cmp.tagName}][import]\"=\"${outDir}/${cmp.tagName}.js\"`);\n\n if (distCustomElements.generateTypeDeclarations) {\n execSync(`npm pkg set \"exports[./${cmp.tagName}][types]\"=\"${outDir}/${cmp.tagName}.d.ts\"`);\n }\n });\n }\n};\n"
},
{
"path": "src/compiler/bundle/app-data-plugin.ts",
"content": "import { createJsVarName, isString, loadTypeScriptDiagnostics, normalizePath } from '@utils';\nimport MagicString from 'magic-string';\nimport { basename } from 'path';\nimport type { LoadResult, Plugin, ResolveIdResult, TransformResult } from 'rollup';\nimport ts from 'typescript';\n\nimport type * as d from '../../declarations';\nimport type { BundlePlatform } from './bundle-interface';\nimport { removeCollectionImports } from '../transformers/remove-collection-imports';\nimport { APP_DATA_CONDITIONAL, STENCIL_APP_DATA_ID, STENCIL_APP_GLOBALS_ID } from './entry-alias-ids';\n\n/**\n * A Rollup plugin which bundles application data.\n *\n * @param config the Stencil configuration for a particular project\n * @param compilerCtx the current compiler context\n * @param buildCtx the current build context\n * @param buildConditionals the set build conditionals for the build\n * @param platform the platform that is being built\n * @returns a Rollup plugin which carries out the necessary work\n */\nexport const appDataPlugin = (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n buildCtx: d.BuildCtx,\n buildConditionals: d.BuildConditionals,\n platform: BundlePlatform,\n): Plugin => {\n if (!platform) {\n return {\n name: 'appDataPlugin',\n };\n }\n const globalScripts = getGlobalScriptData(config, compilerCtx);\n\n return {\n name: 'appDataPlugin',\n\n resolveId(id: string, importer: string | undefined): ResolveIdResult {\n if (id === STENCIL_APP_DATA_ID || id === STENCIL_APP_GLOBALS_ID) {\n if (platform === 'worker') {\n this.error('@stencil/core packages cannot be imported from a worker.');\n }\n\n if (platform === 'hydrate' || STENCIL_APP_GLOBALS_ID) {\n // hydrate will always bundle app-data and runtime\n // and the load() fn will build a custom globals import\n return id;\n } else if (platform === 'client' && importer && importer.endsWith(APP_DATA_CONDITIONAL)) {\n // since the importer ends with ?app-data=conditional we know that\n // we need to build custom app-data based off of component metadata\n // return the same \"id\" so that the \"load()\" method knows to\n // build custom app-data\n return id;\n }\n // for a client build that does not have ?app-data=conditional at the end then we\n // do not want to create custom app-data, but should use the default\n }\n return null;\n },\n\n async load(id: string): Promise {\n if (id === STENCIL_APP_GLOBALS_ID) {\n const s = new MagicString(``);\n appendGlobalScripts(globalScripts, s);\n await appendGlobalStyles(buildCtx, s, platform);\n return s.toString();\n }\n if (id === STENCIL_APP_DATA_ID) {\n // build custom app-data based off of component metadata\n const s = new MagicString(``);\n appendNamespace(config, s);\n appendBuildConditionals(config, buildConditionals, s);\n appendEnv(config, s);\n return s.toString();\n }\n if (id !== config.globalScript) {\n return null;\n }\n\n const module = compilerCtx.moduleMap.get(config.globalScript);\n if (!module) {\n return null;\n } else if (!module.sourceMapFileText) {\n return {\n code: module.staticSourceFileText,\n map: null,\n };\n }\n\n const sourceMap: d.SourceMap = JSON.parse(module.sourceMapFileText);\n sourceMap.sources = sourceMap.sources.map((src) => basename(src));\n return { code: module.staticSourceFileText, map: sourceMap };\n },\n\n transform(code: string, id: string): TransformResult {\n id = normalizePath(id);\n if (globalScripts.some((s) => s.path === id)) {\n const program = this.parse(code, {});\n const needsDefault = !(program as any).body.some((s: any) => s.type === 'ExportDefaultDeclaration');\n\n if (needsDefault) {\n const diagnostic: d.Diagnostic = {\n level: 'warn',\n type: 'build',\n header: 'Missing default export in globalScript',\n messageText: `globalScript should export a default function.\\nSee: https://stenciljs.com/docs/config#globalscript`,\n relFilePath: id,\n lines: [],\n };\n buildCtx.diagnostics.push(diagnostic);\n }\n\n const defaultExport = needsDefault ? '\\nexport const globalFn = () => {};\\nexport default globalFn;' : '';\n code = code + defaultExport;\n\n const compilerOptions: ts.CompilerOptions = { ...config.tsCompilerOptions };\n compilerOptions.module = ts.ModuleKind.ESNext;\n\n const results = ts.transpileModule(code, {\n compilerOptions,\n fileName: id,\n transformers: {\n after: [removeCollectionImports(compilerCtx)],\n },\n });\n buildCtx.diagnostics.push(...loadTypeScriptDiagnostics(results.diagnostics));\n\n if (config.sourceMap) {\n // generate the sourcemap for global script\n const codeMs = new MagicString(code);\n const codeMap = codeMs.generateMap({\n source: id,\n // this is the name of the sourcemap, not to be confused with the `file` field in a generated sourcemap\n file: id + '.map',\n includeContent: true,\n hires: true,\n });\n\n return {\n code: results.outputText,\n map: {\n ...codeMap,\n // MagicString changed their types in this PR: https://github.com/Rich-Harris/magic-string/pull/235\n // so that their `sourcesContent` is of type `(string | null)[]`. But, it will only return `[null]` if\n // `includeContent` is set to `false`. Since we explicitly set `includeContent: true`, we can override\n // the type to satisfy Rollup's type expectation\n sourcesContent: codeMap.sourcesContent as string[],\n },\n };\n }\n\n return { code: results.outputText };\n }\n return null;\n },\n };\n};\n\nexport const getGlobalScriptData = (config: d.ValidatedConfig, compilerCtx: d.CompilerCtx) => {\n const globalScripts: GlobalScript[] = [];\n\n if (isString(config.globalScript)) {\n const mod = compilerCtx.moduleMap.get(config.globalScript);\n const globalScript = compilerCtx.version === 2 ? config.globalScript : mod && mod.jsFilePath;\n\n if (globalScript) {\n globalScripts.push({\n defaultName: createJsVarName(config.namespace + 'GlobalScript'),\n path: normalizePath(globalScript),\n });\n }\n }\n\n compilerCtx.collections.forEach((collection) => {\n if (collection.global != null && isString(collection.global.sourceFilePath)) {\n let defaultName = createJsVarName(collection.collectionName + 'GlobalScript');\n if (globalScripts.some((s) => s.defaultName === defaultName)) {\n defaultName += globalScripts.length;\n }\n globalScripts.push({\n defaultName,\n path: normalizePath(collection.global.sourceFilePath),\n });\n }\n });\n\n return globalScripts;\n};\n\nconst appendGlobalScripts = (globalScripts: GlobalScript[], s: MagicString) => {\n if (globalScripts.length === 1) {\n s.prepend(`import * as appGlobalScriptNs from '${globalScripts[0].path}';\\n`);\n s.prepend(`const appGlobalScript = appGlobalScriptNs.default || (() => {});\\n`);\n s.append(`export const globalScripts = appGlobalScript;\\n`);\n } else if (globalScripts.length > 1) {\n globalScripts.forEach((globalScript) => {\n s.prepend(`import * as ${globalScript.defaultName}Ns from '${globalScript.path}';\\n`);\n s.prepend(`const ${globalScript.defaultName} = ${globalScript.defaultName}Ns.default || (() => {});\\n`);\n });\n\n s.append(`export const globalScripts = () => {\\n`);\n s.append(` return Promise.all([\\n`);\n globalScripts.forEach((globalScript) => {\n s.append(` ${globalScript.defaultName}(),\\n`);\n });\n s.append(` ]);\\n`);\n s.append(`};\\n`);\n } else {\n s.append(`export const globalScripts = () => {};\\n`);\n }\n};\n\n/**\n * Appends the global styles to the MagicString.\n *\n * @param buildCtx the build context\n * @param s the MagicString to append the global styles onto\n * @param platform the platform that is being built\n */\nconst appendGlobalStyles = async (buildCtx: d.BuildCtx, s: MagicString, platform: BundlePlatform) => {\n const { addGlobalStyleToComponents } = buildCtx.config.extras;\n const shouldIncludeGlobalStyles =\n addGlobalStyleToComponents === true || (addGlobalStyleToComponents === 'client' && platform === 'client');\n const globalStyles = buildCtx.config.globalStyle && shouldIncludeGlobalStyles ? await buildCtx.stylesPromise : '';\n s.append(`export const globalStyles = ${JSON.stringify(globalStyles)};\\n`);\n};\n\n/**\n * Generates the `BUILD` constant that is used at compile-time in a Stencil project\n *\n * **This function mutates the provided {@link MagicString} argument**\n *\n * @param config the configuration associated with the Stencil project\n * @param buildConditionals the build conditionals to serialize into a JS object\n * @param s a `MagicString` to append the generated constant onto\n */\nexport const appendBuildConditionals = (\n config: d.ValidatedConfig,\n buildConditionals: d.BuildConditionals,\n s: MagicString,\n): void => {\n const buildData = Object.keys(buildConditionals)\n .sort()\n .map((key) => key + ': ' + JSON.stringify((buildConditionals as any)[key]))\n .join(', ');\n\n s.append(`export const BUILD = /* ${config.fsNamespace} */ { ${buildData} };\\n`);\n};\n\nconst appendEnv = (config: d.ValidatedConfig, s: MagicString) => {\n s.append(`export const Env = /* ${config.fsNamespace} */ ${JSON.stringify(config.env)};\\n`);\n};\n\nconst appendNamespace = (config: d.ValidatedConfig, s: MagicString) => {\n s.append(`export const NAMESPACE = '${config.fsNamespace}';\\n`);\n};\n\ninterface GlobalScript {\n defaultName: string;\n path: string;\n}\n"
},
{
"path": "src/compiler/bundle/bundle-interface.ts",
"content": "import type { PreserveEntrySignaturesOption } from 'rollup';\nimport type { SourceFile, TransformerFactory } from 'typescript';\n\nimport type { BuildConditionals } from '../../declarations';\n\n/**\n * Options for bundled output passed on Rollup\n *\n * This covers the ID for the bundle, the platform it runs on, input modules,\n * and more\n */\nexport interface BundleOptions {\n id: string;\n conditionals?: BuildConditionals;\n /**\n * When `true`, all `@stencil/core/*` packages will be treated as external\n * and omitted from the generated bundle.\n */\n externalRuntime?: boolean;\n platform: BundlePlatform;\n /**\n * A collection of TypeScript transformation factories to apply during the \"before\" stage of the TypeScript\n * compilation pipeline (before built-in .js transformations)\n */\n customBeforeTransformers?: TransformerFactory[];\n /**\n * This is equivalent to the Rollup `input` configuration option. It's\n * an object mapping names to entry points which tells Rollup to bundle\n * each thing up as a separate output chunk.\n *\n * @see {@link https://rollupjs.org/guide/en/#input}\n */\n inputs: { [entryKey: string]: string };\n /**\n * A map of strings which are passed to the Stencil-specific loader plugin\n * which we use to resolve the imports of Stencil project files when building\n * with Rollup.\n *\n * @see {@link loader-plugin:loaderPlugin}\n */\n loader?: { [id: string]: string };\n /**\n * Duplicate of Rollup's `inlineDynamicImports` output option.\n *\n * Creates dynamic imports (i.e. `import()` calls) as a part of the same\n * chunk being bundled. Rather than being created as separate chunks.\n *\n * @see {@link https://rollupjs.org/guide/en/#outputinlinedynamicimports}\n */\n inlineDynamicImports?: boolean;\n inlineWorkers?: boolean;\n /**\n * Duplicate of Rollup's `preserveEntrySignatures` option.\n *\n * \"Controls if Rollup tries to ensure that entry chunks have the same\n * exports as the underlying entry module.\"\n *\n * @see {@link https://rollupjs.org/guide/en/#preserveentrysignatures}\n */\n preserveEntrySignatures?: PreserveEntrySignaturesOption;\n}\n\nexport type BundlePlatform = 'client' | 'hydrate' | 'worker';\n"
},
{
"path": "src/compiler/bundle/bundle-output.ts",
"content": "import rollupCommonjsPlugin from '@rollup/plugin-commonjs';\nimport rollupJsonPlugin from '@rollup/plugin-json';\nimport rollupNodeResolvePlugin from '@rollup/plugin-node-resolve';\nimport rollupReplacePlugin from '@rollup/plugin-replace';\nimport { createOnWarnFn, isString, loadRollupDiagnostics } from '@utils';\nimport { type ObjectHook, PluginContext, rollup, RollupOptions, TreeshakingOptions } from 'rollup';\n\nimport type * as d from '../../declarations';\nimport { lazyComponentPlugin } from '../output-targets/dist-lazy/lazy-component-plugin';\nimport { appDataPlugin } from './app-data-plugin';\nimport type { BundleOptions } from './bundle-interface';\nimport { coreResolvePlugin } from './core-resolve-plugin';\nimport { devNodeModuleResolveId } from './dev-node-module-resolve';\nimport { extFormatPlugin } from './ext-format-plugin';\nimport { extTransformsPlugin } from './ext-transforms-plugin';\nimport { fileLoadPlugin } from './file-load-plugin';\nimport { loaderPlugin } from './loader-plugin';\nimport { pluginHelper } from './plugin-helper';\nimport { serverPlugin } from './server-plugin';\nimport { resolveIdWithTypeScript, typescriptPlugin } from './typescript-plugin';\nimport { userIndexPlugin } from './user-index-plugin';\nimport { workerPlugin } from './worker-plugin';\n\nexport const bundleOutput = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n buildCtx: d.BuildCtx,\n bundleOpts: BundleOptions,\n) => {\n try {\n const rollupOptions = getRollupOptions(config, compilerCtx, buildCtx, bundleOpts);\n const rollupBuild = await rollup(rollupOptions);\n\n compilerCtx.rollupCache.set(bundleOpts.id, rollupBuild.cache);\n return rollupBuild;\n } catch (e: any) {\n if (!buildCtx.hasError) {\n // TODO(STENCIL-353): Implement a type guard that balances using our own copy of Rollup types (which are\n // breakable) and type safety (so that the error variable may be something other than `any`)\n loadRollupDiagnostics(config, compilerCtx, buildCtx, e);\n }\n }\n return undefined;\n};\n\n/**\n * Build the rollup options that will be used to transpile, minify, and otherwise transform a Stencil project\n * @param config the Stencil configuration for the project\n * @param compilerCtx the current compiler context\n * @param buildCtx a context object containing information about the current build\n * @param bundleOpts Rollup bundling options to apply to the base configuration setup by this function\n * @returns the rollup options to be used\n */\nexport const getRollupOptions = (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n buildCtx: d.BuildCtx,\n bundleOpts: BundleOptions,\n): RollupOptions => {\n const nodeResolvePlugin = rollupNodeResolvePlugin({\n mainFields: ['collection:main', 'jsnext:main', 'es2017', 'es2015', 'module', 'main'],\n browser: bundleOpts.platform !== 'hydrate',\n rootDir: config.rootDir,\n exportConditions: ['default', 'module', 'import', 'require'],\n extensions: ['.tsx', '.ts', '.mts', '.cts', '.js', '.mjs', '.cjs', '.json', '.d.ts', '.d.mts', '.d.cts'],\n ...config.nodeResolve,\n });\n\n // @ts-expect-error - this is required now.\n nodeResolvePlugin.resolve = async function () {\n // Investigate if we can use this to leverage Stencil's in-memory fs\n };\n\n // @ts-expect-error - this is required now.\n nodeResolvePlugin.warn = (log) => {\n const onWarn = createOnWarnFn(buildCtx.diagnostics);\n if (typeof log === 'string') {\n onWarn({ message: log });\n } else if (typeof log === 'function') {\n const result = log();\n if (typeof result === 'string') {\n onWarn({ message: result });\n } else {\n onWarn(result);\n }\n } else {\n onWarn(log);\n }\n };\n\n assertIsObjectHook(nodeResolvePlugin.resolveId);\n // remove default 'post' order\n nodeResolvePlugin.resolveId.order = null;\n const orgNodeResolveId = nodeResolvePlugin.resolveId.handler;\n\n const orgNodeResolveId2 = (nodeResolvePlugin.resolveId.handler = async function (importee: string, importer: string) {\n const [realImportee, query] = importee.split('?');\n const resolved = await orgNodeResolveId.call(\n nodeResolvePlugin as unknown as PluginContext,\n realImportee,\n importer,\n {\n attributes: {},\n isEntry: true,\n },\n );\n if (resolved) {\n if (isString(resolved)) {\n return query ? resolved + '?' + query : resolved;\n }\n return {\n ...resolved,\n id: query ? resolved.id + '?' + query : resolved.id,\n };\n }\n return resolved;\n });\n if (config.devServer?.experimentalDevModules) {\n nodeResolvePlugin.resolveId = async function (importee: string, importer: string) {\n const resolvedId = await orgNodeResolveId2.call(\n nodeResolvePlugin as unknown as PluginContext,\n importee,\n importer,\n );\n return devNodeModuleResolveId(config, compilerCtx.fs, resolvedId, importee);\n };\n }\n\n const beforePlugins = config.rollupPlugins.before || [];\n const afterPlugins = config.rollupPlugins.after || [];\n\n const rollupOptions: RollupOptions = {\n input: bundleOpts.inputs,\n output: {\n inlineDynamicImports: bundleOpts.inlineDynamicImports ?? false,\n },\n\n plugins: [\n coreResolvePlugin(\n config,\n compilerCtx,\n bundleOpts.platform,\n !!bundleOpts.externalRuntime,\n bundleOpts.conditionals?.lazyLoad ?? false,\n ),\n appDataPlugin(config, compilerCtx, buildCtx, bundleOpts.conditionals, bundleOpts.platform),\n lazyComponentPlugin(buildCtx),\n loaderPlugin(bundleOpts.loader),\n userIndexPlugin(config, compilerCtx),\n typescriptPlugin(compilerCtx, bundleOpts, config),\n extFormatPlugin(config),\n extTransformsPlugin(config, compilerCtx, buildCtx),\n workerPlugin(config, compilerCtx, buildCtx, bundleOpts.platform, !!bundleOpts.inlineWorkers),\n serverPlugin(config, bundleOpts.platform),\n ...beforePlugins,\n nodeResolvePlugin,\n resolveIdWithTypeScript(config, compilerCtx),\n rollupCommonjsPlugin({\n include: /node_modules/,\n sourceMap: config.sourceMap,\n transformMixedEsModules: false,\n ...config.commonjs,\n }),\n ...afterPlugins,\n pluginHelper(config, buildCtx, bundleOpts.platform),\n rollupJsonPlugin({\n preferConst: true,\n }),\n rollupReplacePlugin({\n 'process.env.NODE_ENV': config.devMode ? '\"development\"' : '\"production\"',\n preventAssignment: true,\n }),\n fileLoadPlugin(compilerCtx.fs),\n ],\n\n treeshake: getTreeshakeOption(config, bundleOpts),\n preserveEntrySignatures: bundleOpts.preserveEntrySignatures ?? 'strict',\n\n onwarn: createOnWarnFn(buildCtx.diagnostics),\n\n cache: compilerCtx.rollupCache.get(bundleOpts.id),\n\n external: config.rollupConfig.inputOptions.external,\n\n maxParallelFileOps: config.rollupConfig.inputOptions.maxParallelFileOps,\n };\n\n return rollupOptions;\n};\n\nconst getTreeshakeOption = (config: d.ValidatedConfig, bundleOpts: BundleOptions): TreeshakingOptions | boolean => {\n if (bundleOpts.platform === 'hydrate') {\n return {\n propertyReadSideEffects: false,\n tryCatchDeoptimization: false,\n };\n }\n\n const treeshake =\n !config.devMode && config.rollupConfig.inputOptions.treeshake !== false\n ? {\n propertyReadSideEffects: false,\n tryCatchDeoptimization: false,\n }\n : false;\n return treeshake;\n};\n\nfunction assertIsObjectHook(hook: ObjectHook): asserts hook is { handler: T; order?: 'pre' | 'post' | null } {\n if (typeof hook !== 'object') throw new Error(`expected the rollup plugin hook ${hook} to be an object`);\n}\n"
},
{
"path": "src/compiler/bundle/constants.ts",
"content": "export const DEV_MODULE_CACHE_BUSTER = 0;\n\nexport const DEV_MODULE_DIR = `~dev-module`;\n"
},
{
"path": "src/compiler/bundle/core-resolve-plugin.ts",
"content": "import { isRemoteUrl, join, normalizeFsPath, normalizePath } from '@utils';\nimport { dirname } from 'path';\nimport type { Plugin } from 'rollup';\n\nimport type * as d from '../../declarations';\nimport type { BundlePlatform } from './bundle-interface';\nimport { HYDRATED_CSS } from '../../runtime/runtime-constants';\nimport { fetchModuleAsync } from '../sys/fetch/fetch-module-async';\nimport { getStencilModuleUrl, packageVersions } from '../sys/fetch/fetch-utils';\nimport {\n APP_DATA_CONDITIONAL,\n STENCIL_CORE_ID,\n STENCIL_INTERNAL_CLIENT_ID,\n STENCIL_INTERNAL_CLIENT_PATCH_BROWSER_ID,\n STENCIL_INTERNAL_HYDRATE_ID,\n STENCIL_INTERNAL_ID,\n STENCIL_JSX_DEV_RUNTIME_ID,\n STENCIL_JSX_RUNTIME_ID,\n} from './entry-alias-ids';\n\nexport const coreResolvePlugin = (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n platform: BundlePlatform,\n externalRuntime: boolean,\n lazyLoad: boolean,\n): Plugin => {\n const compilerExe = config.sys.getCompilerExecutingPath();\n const internalClient = getStencilInternalModule(config, compilerExe, 'client/index.js');\n const internalClientPatchBrowser = getStencilInternalModule(config, compilerExe, 'client/patch-browser.js');\n const internalHydrate = getStencilInternalModule(config, compilerExe, 'hydrate/index.js');\n\n return {\n name: 'coreResolvePlugin',\n\n resolveId(id) {\n if (id === STENCIL_CORE_ID || id === STENCIL_INTERNAL_ID) {\n if (platform === 'client') {\n if (externalRuntime) {\n return {\n id: STENCIL_INTERNAL_CLIENT_ID,\n external: true,\n };\n }\n if (lazyLoad) {\n // with a lazy / dist build, add `?app-data=conditional` as an identifier to ensure we don't\n // use the default app-data, but build a custom one based on component meta\n return internalClient + APP_DATA_CONDITIONAL;\n }\n // for a non-lazy / dist-custom-elements build, use the default, complete core.\n // This ensures all features are available for any importer library\n return internalClient;\n }\n if (platform === 'hydrate') {\n return internalHydrate;\n }\n }\n if (id === STENCIL_INTERNAL_CLIENT_ID) {\n if (externalRuntime) {\n // not bundling the client runtime and the user's component together this\n // must be the custom elements build, where @stencil/core/internal/client\n // is an import, rather than bundling\n return {\n id: STENCIL_INTERNAL_CLIENT_ID,\n external: true,\n };\n }\n // importing @stencil/core/internal/client directly, so it shouldn't get\n // the custom app-data conditionals\n return internalClient;\n }\n if (id === STENCIL_INTERNAL_CLIENT_PATCH_BROWSER_ID) {\n if (externalRuntime) {\n return {\n id: STENCIL_INTERNAL_CLIENT_PATCH_BROWSER_ID,\n external: true,\n };\n }\n return internalClientPatchBrowser;\n }\n if (id === STENCIL_INTERNAL_HYDRATE_ID) {\n return internalHydrate;\n }\n // Handle jsx-runtime and jsx-dev-runtime imports\n // These must resolve to the same internal client path as @stencil/core\n // to prevent Rollup from bundling duplicate runtime code with different\n // minified property names, which causes VNode property mismatches during hydration\n if (id === STENCIL_JSX_RUNTIME_ID || id === STENCIL_JSX_DEV_RUNTIME_ID) {\n if (platform === 'client') {\n if (externalRuntime) {\n return {\n id: STENCIL_INTERNAL_CLIENT_ID,\n external: true,\n };\n }\n if (lazyLoad) {\n // with a lazy / dist build, add `?app-data=conditional` as an identifier to ensure we don't\n // use the default app-data, but build a custom one based on component meta\n return internalClient + APP_DATA_CONDITIONAL;\n }\n // for a non-lazy / dist-custom-elements build, use the default, complete core.\n return internalClient;\n }\n if (platform === 'hydrate') {\n return internalHydrate;\n }\n }\n return null;\n },\n\n async load(filePath) {\n if (filePath && !filePath.startsWith('\\0')) {\n filePath = normalizeFsPath(filePath);\n\n if (filePath === internalClient || filePath === internalHydrate) {\n if (platform === 'worker') {\n return `\nexport const Build = {\n isDev: ${config.devMode},\n isBrowser: true,\n isServer: false,\n isTesting: false,\n};`;\n }\n let code = await compilerCtx.fs.readFile(filePath);\n\n if (typeof code !== 'string' && isRemoteUrl(compilerExe)) {\n const url = getStencilModuleUrl(compilerExe, filePath);\n code = await fetchModuleAsync(config.sys, compilerCtx.fs, packageVersions, url, filePath);\n }\n\n if (typeof code === 'string') {\n const hydratedFlag = config.hydratedFlag;\n if (hydratedFlag) {\n const hydratedFlagHead = getHydratedFlagHead(hydratedFlag);\n if (HYDRATED_CSS !== hydratedFlagHead) {\n code = code.replace(HYDRATED_CSS, hydratedFlagHead);\n if (hydratedFlag.name !== 'hydrated') {\n code = code.replace(`.classList.add(\"hydrated\")`, `.classList.add(\"${hydratedFlag.name}\")`);\n code = code.replace(`.classList.add('hydrated')`, `.classList.add('${hydratedFlag.name}')`);\n code = code.replace(`.setAttribute(\"hydrated\",`, `.setAttribute(\"${hydratedFlag.name}\",`);\n code = code.replace(`.setAttribute('hydrated',`, `.setAttribute('${hydratedFlag.name}',`);\n }\n }\n } else {\n code = code.replace(HYDRATED_CSS, '{}');\n }\n }\n\n return code;\n }\n }\n return null;\n },\n };\n};\n\nexport const getStencilInternalModule = (config: d.ValidatedConfig, compilerExe: string, internalModule: string) => {\n if (isRemoteUrl(compilerExe)) {\n return normalizePath(\n config.sys.getLocalModulePath({\n rootDir: config.rootDir,\n moduleId: '@stencil/core',\n path: 'internal/' + internalModule,\n }),\n );\n }\n\n const compilerExeDir = dirname(compilerExe);\n return normalizePath(join(compilerExeDir, '..', 'internal', internalModule));\n};\n\nexport const getHydratedFlagHead = (h: d.HydratedFlag) => {\n // {visibility:hidden}.hydrated{visibility:inherit}\n\n let initial: string;\n let hydrated: string;\n\n if (!String(h.initialValue) || h.initialValue === '' || h.initialValue == null) {\n initial = '';\n } else {\n initial = `{${h.property}:${h.initialValue}}`;\n }\n\n const selector = h.selector === 'attribute' ? `[${h.name}]` : `.${h.name}`;\n\n if (!String(h.hydratedValue) || h.hydratedValue === '' || h.hydratedValue == null) {\n hydrated = '';\n } else {\n hydrated = `${selector}{${h.property}:${h.hydratedValue}}`;\n }\n\n return initial + hydrated;\n};\n"
},
{
"path": "src/compiler/bundle/dev-module.ts",
"content": "import { generatePreamble, join, relative } from '@utils';\nimport { basename, dirname } from 'path';\nimport { OutputOptions, rollup } from 'rollup';\n\nimport type * as d from '../../declarations';\nimport { BuildContext } from '../build/build-ctx';\nimport { getRollupOptions } from './bundle-output';\nimport { DEV_MODULE_CACHE_BUSTER, DEV_MODULE_DIR } from './constants';\n\nexport const compilerRequest = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n data: d.CompilerRequest,\n) => {\n const results: d.CompilerRequestResponse = {\n path: data.path,\n nodeModuleId: null,\n nodeModuleVersion: null,\n nodeResolvedPath: null,\n cachePath: null,\n cacheHit: false,\n content: '',\n status: 404,\n };\n\n try {\n const parsedUrl = parseDevModuleUrl(config, data.path);\n Object.assign(results, parsedUrl);\n\n if (parsedUrl.nodeModuleId) {\n if (!parsedUrl.nodeModuleVersion) {\n results.content = `/* invalid module version */`;\n results.status = 400;\n return results;\n }\n if (!parsedUrl.nodeResolvedPath) {\n results.content = `/* invalid resolved path */`;\n results.status = 400;\n return results;\n }\n\n const useCache = await useDevModuleCache(config, parsedUrl.nodeResolvedPath);\n\n let cachePath: string = null;\n if (useCache) {\n cachePath = getDevModuleCachePath(config, parsedUrl);\n\n const cachedContent = await config.sys.readFile(cachePath);\n if (typeof cachedContent === 'string') {\n results.content = cachedContent;\n results.cachePath = cachePath;\n results.cacheHit = true;\n results.status = 200;\n return results;\n }\n }\n\n await bundleDevModule(config, compilerCtx, parsedUrl, results);\n\n if (results.status === 200 && useCache) {\n results.cachePath = cachePath;\n writeCachedFile(config, results);\n }\n } else {\n results.content = `/* invalid dev module */`;\n results.status = 400;\n return results;\n }\n } catch (e: unknown) {\n if (e) {\n if (e instanceof Error && e.stack) {\n results.content = `/*\\n${e.stack}\\n*/`;\n } else {\n results.content = `/*\\n${e}\\n*/`;\n }\n }\n results.status = 500;\n }\n\n return results;\n};\n\nconst bundleDevModule = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n parsedUrl: ParsedDevModuleUrl,\n results: d.CompilerRequestResponse,\n) => {\n const buildCtx = new BuildContext(config, compilerCtx);\n\n try {\n const inputOpts = getRollupOptions(config, compilerCtx, buildCtx, {\n id: parsedUrl.nodeModuleId,\n platform: 'client',\n inputs: {\n index: parsedUrl.nodeResolvedPath,\n },\n });\n const rollupBuild = await rollup(inputOpts);\n\n const outputOpts: OutputOptions = {\n banner: generatePreamble(config),\n format: 'es',\n };\n\n if (parsedUrl.nodeModuleId) {\n const commentPath = relative(config.rootDir, parsedUrl.nodeResolvedPath);\n outputOpts.intro = `/**\\n * Dev Node Module: ${parsedUrl.nodeModuleId}, v${parsedUrl.nodeModuleVersion}\\n * Entry: ${commentPath}\\n * DEVELOPMENT PURPOSES ONLY!!\\n */`;\n inputOpts.input = parsedUrl.nodeResolvedPath;\n }\n\n const r = await rollupBuild.generate(outputOpts);\n\n if (buildCtx.hasError) {\n results.status = 500;\n results.content = `console.error(${JSON.stringify(buildCtx.diagnostics)})`;\n } else if (r && r.output && r.output.length > 0) {\n results.content = r.output[0].code;\n results.status = 200;\n }\n } catch (e) {\n results.status = 500;\n const errorMsg = e instanceof Error ? e.stack : e + '';\n results.content = `console.error(${JSON.stringify(errorMsg)})`;\n }\n};\n\nconst useDevModuleCache = async (config: d.ValidatedConfig, p: string) => {\n if (config.enableCache) {\n for (let i = 0; i < 10; i++) {\n const n = basename(p);\n if (n === 'node_modules') {\n return true;\n }\n const isSymbolicLink = await config.sys.isSymbolicLink(p);\n if (isSymbolicLink) {\n return false;\n }\n p = dirname(p);\n }\n }\n return false;\n};\n\nconst writeCachedFile = async (config: d.ValidatedConfig, results: d.CompilerRequestResponse) => {\n try {\n await config.sys.createDir(config.cacheDir);\n config.sys.writeFile(results.cachePath, results.content);\n } catch (e) {\n console.error(e);\n }\n};\n\nconst parseDevModuleUrl = (config: d.ValidatedConfig, u: string) => {\n const parsedUrl: ParsedDevModuleUrl = {\n nodeModuleId: null,\n nodeModuleVersion: null,\n nodeResolvedPath: null,\n };\n\n if (u && u.includes(DEV_MODULE_DIR) && u.endsWith('.js')) {\n const url = new URL(u, 'https://stenciljs.com');\n let reqPath = basename(url.pathname);\n reqPath = reqPath.substring(0, reqPath.length - 3);\n\n const splt = reqPath.split('@');\n if (splt.length === 2) {\n parsedUrl.nodeModuleId = decodeURIComponent(splt[0]);\n parsedUrl.nodeModuleVersion = decodeURIComponent(splt[1]);\n\n parsedUrl.nodeResolvedPath = url.searchParams.get('p');\n if (parsedUrl.nodeResolvedPath) {\n parsedUrl.nodeResolvedPath = decodeURIComponent(parsedUrl.nodeResolvedPath);\n parsedUrl.nodeResolvedPath = join(config.rootDir, parsedUrl.nodeResolvedPath);\n }\n }\n }\n\n return parsedUrl;\n};\n\nconst getDevModuleCachePath = (config: d.ValidatedConfig, parsedUrl: ParsedDevModuleUrl) => {\n return join(\n config.cacheDir,\n `dev_module_${parsedUrl.nodeModuleId}_${parsedUrl.nodeModuleVersion}_${DEV_MODULE_CACHE_BUSTER}.log`,\n );\n};\n\ninterface ParsedDevModuleUrl {\n nodeModuleId: string;\n nodeModuleVersion: string;\n nodeResolvedPath: string;\n}\n"
},
{
"path": "src/compiler/bundle/dev-node-module-resolve.ts",
"content": "import { join, relative } from '@utils';\nimport { basename, dirname } from 'path';\nimport { ResolveIdResult } from 'rollup';\n\nimport type * as d from '../../declarations';\nimport { InMemoryFileSystem } from '../sys/in-memory-fs';\nimport { DEV_MODULE_DIR } from './constants';\n\nexport const devNodeModuleResolveId = async (\n config: d.ValidatedConfig,\n inMemoryFs: InMemoryFileSystem,\n resolvedId: ResolveIdResult,\n importee: string,\n) => {\n if (!shouldCheckDevModule(resolvedId, importee)) {\n return resolvedId;\n }\n\n if (typeof resolvedId === 'string' || !resolvedId) {\n return resolvedId;\n }\n\n const resolvedPath = resolvedId.id;\n\n const pkgPath = getPackageJsonPath(resolvedPath, importee);\n if (!pkgPath) {\n return resolvedId;\n }\n\n const pkgJsonStr = await inMemoryFs.readFile(pkgPath);\n if (!pkgJsonStr) {\n return resolvedId;\n }\n\n let pkgJsonData: d.PackageJsonData;\n try {\n pkgJsonData = JSON.parse(pkgJsonStr);\n } catch (e) {}\n\n if (!pkgJsonData || !pkgJsonData.version) {\n return resolvedId;\n }\n\n resolvedId.id = serializeDevNodeModuleUrl(config, pkgJsonData.name, pkgJsonData.version, resolvedPath);\n resolvedId.external = true;\n\n return resolvedId;\n};\n\nconst shouldCheckDevModule = (resolvedId: ResolveIdResult, importee: string) =>\n resolvedId &&\n importee &&\n typeof resolvedId !== 'string' &&\n resolvedId.id &&\n resolvedId.id.includes('node_modules') &&\n (resolvedId.id.endsWith('.js') || resolvedId.id.endsWith('.mjs')) &&\n !resolvedId.external &&\n !importee.startsWith('.') &&\n !importee.startsWith('/');\n\nconst getPackageJsonPath = (resolvedPath: string, importee: string): string => {\n let currentPath = resolvedPath;\n for (let i = 0; i < 10; i++) {\n currentPath = dirname(currentPath);\n const aBasename = basename(currentPath);\n\n const upDir = dirname(currentPath);\n const bBasename = basename(upDir);\n if (aBasename === importee && bBasename === 'node_modules') {\n return join(currentPath, 'package.json');\n }\n }\n return null;\n};\n\nconst serializeDevNodeModuleUrl = (\n config: d.ValidatedConfig,\n moduleId: string,\n moduleVersion: string,\n resolvedPath: string,\n) => {\n resolvedPath = relative(config.rootDir, resolvedPath);\n\n let id = `/${DEV_MODULE_DIR}/`;\n id += encodeURIComponent(moduleId) + '@';\n id += encodeURIComponent(moduleVersion) + '.js';\n id += '?p=' + encodeURIComponent(resolvedPath);\n return id;\n};\n"
},
{
"path": "src/compiler/bundle/entry-alias-ids.ts",
"content": "export const STENCIL_CORE_ID = '@stencil/core';\nexport const STENCIL_INTERNAL_ID = '@stencil/core/internal';\nexport const STENCIL_APP_DATA_ID = '@stencil/core/internal/app-data';\nexport const STENCIL_APP_GLOBALS_ID = '@stencil/core/internal/app-globals';\nexport const STENCIL_HYDRATE_FACTORY_ID = '@stencil/core/hydrate-factory';\nexport const STENCIL_INTERNAL_CLIENT_ID = '@stencil/core/internal/client';\nexport const STENCIL_INTERNAL_CLIENT_PATCH_BROWSER_ID = '@stencil/core/internal/client/patch-browser';\nexport const STENCIL_INTERNAL_HYDRATE_ID = '@stencil/core/internal/hydrate';\nexport const STENCIL_MOCK_DOC_ID = '@stencil/core/mock-doc';\nexport const STENCIL_JSX_RUNTIME_ID = '@stencil/core/jsx-runtime';\nexport const STENCIL_JSX_DEV_RUNTIME_ID = '@stencil/core/jsx-dev-runtime';\nexport const APP_DATA_CONDITIONAL = '?app-data=conditional';\nexport const LAZY_BROWSER_ENTRY_ID = '@lazy-browser-entrypoint' + APP_DATA_CONDITIONAL;\nexport const LAZY_EXTERNAL_ENTRY_ID = '@lazy-external-entrypoint' + APP_DATA_CONDITIONAL;\nexport const USER_INDEX_ENTRY_ID = '@user-index-entrypoint';\n"
},
{
"path": "src/compiler/bundle/ext-format-plugin.ts",
"content": "import { createJsVarName, normalizeFsPathQuery } from '@utils';\nimport { basename } from 'path';\nimport type { Plugin, TransformPluginContext, TransformResult } from 'rollup';\n\nimport type * as d from '../../declarations';\n\nexport const extFormatPlugin = (config: d.ValidatedConfig): Plugin => {\n return {\n name: 'extFormatPlugin',\n\n transform(code: string, importPath: string): TransformResult {\n if (/\\0/.test(importPath)) {\n return null;\n }\n\n const { ext, filePath, format } = normalizeFsPathQuery(importPath);\n\n // ?format= param takes precedence before file extension\n switch (format) {\n case 'url':\n return { code: formatUrl(config, this, code, filePath, ext), map: null };\n case 'text':\n return { code: formatText(code, filePath), map: null };\n }\n\n // didn't provide a ?format= param\n // check if it's a known extension we should format\n if (ext != null && FORMAT_TEXT_EXTS.includes(ext)) {\n return { code: formatText(code, filePath), map: null };\n }\n\n if (ext != null && FORMAT_URL_MIME[ext]) {\n return { code: formatUrl(config, this, code, filePath, ext), map: null };\n }\n\n return null;\n },\n };\n};\n\nconst FORMAT_TEXT_EXTS = ['txt', 'frag', 'vert'];\n\nconst FORMAT_URL_MIME: any = {\n svg: 'image/svg+xml',\n};\n\nconst DATAURL_MAX_IMAGE_SIZE = 4 * 1024; // 4KiB\n\nconst formatText = (code: string, filePath: string) => {\n const varName = createJsVarName(basename(filePath));\n return `const ${varName} = ${JSON.stringify(code)};export default ${varName};`;\n};\n\nconst formatUrl = (\n config: d.ValidatedConfig,\n pluginCtx: TransformPluginContext,\n code: string,\n filePath: string,\n ext: string | null,\n) => {\n const mime = ext != null ? FORMAT_URL_MIME[ext] : null;\n if (!mime) {\n pluginCtx.warn(`Unsupported url format for \"${ext}\" extension.`);\n return formatText('', filePath);\n }\n\n const varName = createJsVarName(basename(filePath));\n const base64 = config.sys.encodeToBase64(code);\n if (config.devMode && base64.length > DATAURL_MAX_IMAGE_SIZE) {\n pluginCtx.warn(`Importing large files will bloat your bundle size, please use external assets instead.`);\n }\n\n return `const ${varName} = 'data:${mime};base64,${base64}';export default ${varName};`;\n};\n"
},
{
"path": "src/compiler/bundle/ext-transforms-plugin.ts",
"content": "import { hasError, isOutputTargetDistCollection, join, mergeIntoWith, normalizeFsPath, relative } from '@utils';\nimport type { Plugin } from 'rollup';\n\nimport type * as d from '../../declarations';\nimport { runPluginTransformsEsmImports } from '../plugin/plugin';\nimport { getScopeId } from '../style/scope-css';\nimport { parseImportPath } from '../transformers/stencil-import-path';\n\n/**\n * This keeps a map of all the component styles we've seen already so we can create\n * a correct state of all styles when we're doing a rebuild. This map helps by\n * storing the state of all styles as follows, e.g.:\n *\n * ```\n * {\n * 'cmp-a-$': {\n * '/path/to/project/cmp-a.scss': 'button{color:red}',\n * '/path/to/project/cmp-a.md.scss': 'button{color:blue}'\n * }\n * ```\n *\n * Whenever one of the files change, we can propagate a correct concatenated\n * version of all styles to the browser by setting `buildCtx.stylesUpdated`.\n */\ntype ComponentStyleMap = Map;\nconst allCmpStyles = new Map();\n\n/**\n * A Rollup plugin which bundles up some transformation of CSS imports as well\n * as writing some files to disk for the `DIST_COLLECTION` output target.\n *\n * @param config a user-supplied configuration\n * @param compilerCtx the current compiler context\n * @param buildCtx the current build context\n * @returns a Rollup plugin which carries out the necessary work\n */\nexport const extTransformsPlugin = (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n buildCtx: d.BuildCtx,\n): Plugin => {\n return {\n name: 'extTransformsPlugin',\n\n /**\n * A custom function targeting the `transform` build hook in Rollup. See here for details:\n * https://rollupjs.org/guide/en/#transform\n *\n * Here we are ignoring the first argument (which contains the module's source code) and\n * only looking at the `id` argument. We use that `id` to get information about the module\n * in question from disk ourselves so that we can then do some transformations on it.\n *\n * @param _ an unused parameter (normally the code for a given module)\n * @param id the id of a module\n * @returns metadata for Rollup or null if no transformation should be done\n */\n async transform(_, id) {\n if (/\\0/.test(id)) {\n return null;\n }\n\n /**\n * Make sure compiler context has a registered worker. The interface suggests that it\n * potentially can be undefined, therefore check for it here.\n */\n if (!compilerCtx.worker) {\n return null;\n }\n\n // The `id` here was possibly previously updated using\n // `serializeImportPath` to annotate the filepath with various metadata\n // serialized to query-params. If that was done for this particular `id`\n // then the `data` prop will not be null.\n const { data } = parseImportPath(id);\n\n if (data != null) {\n let cmpStyles: ComponentStyleMap | undefined = undefined;\n let cmp: d.ComponentCompilerMeta | undefined = undefined;\n const filePath = normalizeFsPath(id);\n const code = await compilerCtx.fs.readFile(filePath);\n if (typeof code !== 'string') {\n return null;\n }\n\n /**\n * add file to watch list if it is outside of the `srcDir` config path\n */\n if (config.watch && (id.startsWith('/') || id.startsWith('.')) && !id.startsWith(config.srcDir)) {\n compilerCtx.addWatchFile(id.split('?')[0]);\n }\n\n const pluginTransforms = await runPluginTransformsEsmImports(config, compilerCtx, buildCtx, code, filePath);\n\n if (data.tag) {\n cmp = buildCtx.components.find((c) => c.tagName === data.tag);\n const moduleFile = cmp && !cmp.isCollectionDependency && compilerCtx.moduleMap.get(cmp.sourceFilePath);\n\n if (moduleFile) {\n const collectionDirs = config.outputTargets.filter(isOutputTargetDistCollection);\n const relPath = relative(config.srcDir, pluginTransforms.id);\n\n // If we found a `moduleFile` in the module map above then we\n // should write the transformed CSS file (found in the return value\n // of `runPluginTransformsEsmImports`, above) to disk.\n await Promise.all(\n collectionDirs.map(async (outputTarget) => {\n const collectionPath = join(outputTarget.collectionDir, relPath);\n await compilerCtx.fs.writeFile(collectionPath, pluginTransforms.code);\n }),\n );\n }\n\n /**\n * initiate map for component styles\n */\n const scopeId = getScopeId(data.tag, data.mode);\n if (!allCmpStyles.has(scopeId)) {\n allCmpStyles.set(scopeId, new Map());\n }\n cmpStyles = allCmpStyles.get(scopeId);\n }\n\n const cssTransformResults = await compilerCtx.worker.transformCssToEsm({\n file: pluginTransforms.id,\n input: pluginTransforms.code,\n tag: data.tag,\n tags: buildCtx.components.map((c) => c.tagName),\n addTagTransformers: !!buildCtx.config.extras.additionalTagTransformers,\n encapsulation: data.encapsulation,\n mode: data.mode,\n sourceMap: config.sourceMap,\n minify: config.minifyCss,\n autoprefixer: config.autoprefixCss,\n docs: config.buildDocs,\n });\n\n /**\n * persist component styles for transformed stylesheet\n */\n if (cmpStyles) {\n cmpStyles.set(filePath, cssTransformResults.styleText);\n }\n\n // Set style docs\n if (cmp) {\n cmp.styleDocs ||= [];\n mergeIntoWith(cmp.styleDocs, cssTransformResults.styleDocs, (docs) => `${docs.name},${docs.mode}`);\n }\n\n // Track dependencies\n for (const dep of pluginTransforms.dependencies) {\n this.addWatchFile(dep);\n compilerCtx.addWatchFile(dep);\n }\n\n buildCtx.diagnostics.push(...pluginTransforms.diagnostics);\n buildCtx.diagnostics.push(...cssTransformResults.diagnostics);\n const didError = hasError(cssTransformResults.diagnostics) || hasError(pluginTransforms.diagnostics);\n if (didError) {\n this.error('Plugin CSS transform error');\n }\n\n const hasUpdatedStyle = buildCtx.stylesUpdated.some((s) => {\n return s.styleTag === data.tag && s.styleMode === data.mode && s.styleText === cssTransformResults.styleText;\n });\n\n /**\n * if the style has updated, compose all styles for the component\n */\n if (!hasUpdatedStyle && data.tag && data.mode) {\n const externalStyles = cmp?.styles?.[0]?.externalStyles;\n\n /**\n * if component has external styles, use a list to keep the order to which\n * styles are applied.\n */\n const styleText = cmpStyles\n ? externalStyles\n ? /**\n * attempt to find the original `filePath` key through `originalComponentPath`\n * and `absolutePath` as path can differ based on how Stencil is installed\n * e.g. through `npm link` or `npm install`\n */\n externalStyles\n .map((es) => cmpStyles.get(es.originalComponentPath) || cmpStyles.get(es.absolutePath))\n .join('\\n')\n : /**\n * if `externalStyles` is not defined, then created the style text in the\n * order of which the styles were compiled.\n */\n [...cmpStyles.values()].join('\\n')\n : /**\n * if `cmpStyles` is not defined, then use the style text from the transform\n * as it is not connected to a component.\n */\n cssTransformResults.styleText;\n\n buildCtx.stylesUpdated.push({\n styleTag: data.tag,\n styleMode: data.mode,\n styleText,\n });\n }\n\n return {\n code: cssTransformResults.output,\n map: cssTransformResults.map,\n moduleSideEffects: false,\n };\n }\n\n return null;\n },\n };\n};\n"
},
{
"path": "src/compiler/bundle/file-load-plugin.ts",
"content": "import { isDtsFile, normalizeFsPath } from '@utils';\nimport type { Plugin } from 'rollup';\n\nimport { InMemoryFileSystem } from '../sys/in-memory-fs';\n\nexport const fileLoadPlugin = (fs: InMemoryFileSystem): Plugin => {\n return {\n name: 'fileLoadPlugin',\n\n load(id) {\n const fsFilePath = normalizeFsPath(id);\n if (isDtsFile(fsFilePath)) {\n return '';\n }\n return fs.readFile(fsFilePath);\n },\n };\n};\n"
},
{
"path": "src/compiler/bundle/loader-plugin.ts",
"content": "import type { LoadResult, Plugin, ResolveIdResult } from 'rollup';\n\n/**\n * Rollup plugin that aids in resolving the entry points (1 or more files) for a Stencil project. For example, a project\n * using the `dist-custom-elements` output target may have a single 'entry point' for each file containing a component.\n * Each of those files will be independently resolved and loaded by this plugin for further processing by Rollup later\n * in the bundling process.\n *\n * @param entries the Stencil project files to process. It should be noted that the keys in this object may not\n * necessarily be an absolute or relative path to a file, but may be a Rollup Virtual Module (which begin with \\0).\n * @returns the rollup plugin that loads and process a Stencil project's entry points\n */\nexport const loaderPlugin = (entries: { [id: string]: string } = {}): Plugin => {\n return {\n name: 'stencilLoaderPlugin',\n /**\n * A rollup build hook for resolving the imports of individual Stencil project files. This hook only resolves\n * modules that are contained in the plugin's `entries` argument. [Source](https://rollupjs.org/guide/en/#resolveid)\n * @param id the importee to resolve\n * @returns a string that resolves an import to some id, null otherwise\n */\n resolveId(id: string): ResolveIdResult {\n if (id in entries) {\n return {\n id,\n };\n }\n return null;\n },\n /**\n * A rollup build hook for loading individual Stencil project files [Source](https://rollupjs.org/guide/en/#load)\n * @param id the path of the module to load. It should be noted that the keys in this object may not necessarily\n * be an absolute or relative path to a file, but may be a Rollup Virtual Module.\n * @returns the module matched, null otherwise\n */\n load(id: string): LoadResult {\n if (id in entries) {\n return entries[id];\n }\n return null;\n },\n };\n};\n"
},
{
"path": "src/compiler/bundle/plugin-helper.ts",
"content": "import { buildError, relative } from '@utils';\n\nimport type * as d from '../../declarations';\nimport type { BundlePlatform } from './bundle-interface';\n\nexport const pluginHelper = (config: d.ValidatedConfig, builtCtx: d.BuildCtx, platform: BundlePlatform) => {\n return {\n name: 'pluginHelper',\n resolveId(importee: string, importer: string): null {\n if (/\\0/.test(importee)) {\n // ignore IDs with null character, these belong to other plugins\n return null;\n }\n\n if (importee.endsWith('/')) {\n importee = importee.slice(0, -1);\n }\n\n if (builtIns.has(importee)) {\n let fromMsg = '';\n if (importer) {\n fromMsg = ` from ${relative(config.rootDir, importer)}`;\n }\n const diagnostic = buildError(builtCtx.diagnostics);\n diagnostic.header = `Node Polyfills Required`;\n diagnostic.messageText = `For the import \"${importee}\" to be bundled${fromMsg}, ensure the \"rollup-plugin-node-polyfills\" plugin is installed and added to the stencil config plugins (${platform}). Please see the bundling docs for more information.\n Further information: https://stenciljs.com/docs/module-bundling`;\n }\n return null;\n },\n };\n};\n\nconst builtIns = new Set([\n 'child_process',\n 'cluster',\n 'dgram',\n 'dns',\n 'module',\n 'net',\n 'readline',\n 'repl',\n 'tls',\n\n 'assert',\n 'console',\n 'constants',\n 'domain',\n 'events',\n 'path',\n 'punycode',\n 'querystring',\n '_stream_duplex',\n '_stream_passthrough',\n '_stream_readable',\n '_stream_writable',\n '_stream_transform',\n 'string_decoder',\n 'sys',\n 'tty',\n\n 'crypto',\n 'fs',\n\n 'Buffer',\n 'buffer',\n 'global',\n 'http',\n 'https',\n 'os',\n 'process',\n 'stream',\n 'timers',\n 'url',\n 'util',\n 'vm',\n 'zlib',\n]);\n"
},
{
"path": "src/compiler/bundle/server-plugin.ts",
"content": "import { isOutputTargetHydrate, isString, normalizeFsPath } from '@utils';\nimport { isAbsolute } from 'path';\nimport type { Plugin } from 'rollup';\n\nimport type * as d from '../../declarations';\nimport type { BundlePlatform } from './bundle-interface';\n\nexport const serverPlugin = (config: d.ValidatedConfig, platform: BundlePlatform): Plugin => {\n const isHydrateBundle = platform === 'hydrate';\n const serverVarid = `@removed-server-code`;\n\n const isServerOnlyModule = (id: string) => {\n if (isString(id)) {\n id = normalizeFsPath(id);\n return id.includes('.server/') || id.endsWith('.server');\n }\n return false;\n };\n\n const externals = isHydrateBundle\n ? config.outputTargets.filter(isOutputTargetHydrate).flatMap((o) => o.external)\n : [];\n\n return {\n name: 'serverPlugin',\n\n resolveId(id, importer) {\n if (id === serverVarid) {\n return id;\n }\n if (isHydrateBundle) {\n if (externals.includes(id)) {\n // don't attempt to bundle node builtins for the hydrate bundle\n return {\n id,\n external: true,\n };\n }\n if (isServerOnlyModule(importer) && !id.startsWith('.') && !isAbsolute(id)) {\n // do not bundle if the importer is a server-only module\n // and the module it is importing is a node module\n return {\n id,\n external: true,\n };\n }\n } else {\n if (isServerOnlyModule(id)) {\n // any path that has .server in it shouldn't actually\n // be bundled in the web build, only the hydrate build\n return serverVarid;\n }\n }\n return null;\n },\n\n load(id) {\n if (id === serverVarid) {\n return {\n code: 'export default {};',\n syntheticNamedExports: true,\n };\n }\n return null;\n },\n };\n};\n"
},
{
"path": "src/compiler/bundle/test/app-data-plugin.spec.ts",
"content": "import * as d from '@stencil/core/declarations';\nimport { mockValidatedConfig } from '@stencil/core/testing';\nimport MagicString from 'magic-string';\n\nimport { appendBuildConditionals } from '../app-data-plugin';\n\nfunction setup() {\n const config = mockValidatedConfig();\n const magicString = new MagicString('');\n return { config, magicString };\n}\n\ndescribe('app data plugin', () => {\n it('should include the fsNamespace in the appended BUILD constant', () => {\n const { config, magicString } = setup();\n appendBuildConditionals(config, {}, magicString);\n expect(magicString.toString().includes(`export const BUILD = /* ${config.fsNamespace} */`)).toBe(true);\n });\n\n it.each([true, false])('should include hydratedAttribute when %p', (hydratedAttribute) => {\n const conditionals: d.BuildConditionals = {\n hydratedAttribute,\n };\n const { config, magicString } = setup();\n appendBuildConditionals(config, conditionals, magicString);\n expect(magicString.toString().includes(`hydratedAttribute: ${String(hydratedAttribute)}`)).toBe(true);\n });\n\n it.each([true, false])('should include hydratedClass when %p', (hydratedClass) => {\n const conditionals: d.BuildConditionals = {\n hydratedClass,\n };\n const { config, magicString } = setup();\n appendBuildConditionals(config, conditionals, magicString);\n expect(magicString.toString().includes(`hydratedClass: ${String(hydratedClass)}`)).toBe(true);\n });\n\n it('should append hydratedSelectorName', () => {\n const conditionals: d.BuildConditionals = {\n hydratedSelectorName: 'boop',\n };\n const { config, magicString } = setup();\n appendBuildConditionals(config, conditionals, magicString);\n expect(magicString.toString().includes('hydratedSelectorName: \"boop\"')).toBe(true);\n });\n});\n"
},
{
"path": "src/compiler/bundle/test/core-resolve-plugin.spec.ts",
"content": "import { mockCompilerCtx, mockValidatedConfig } from '@stencil/core/testing';\n\nimport { createSystem } from '../../../compiler/sys/stencil-sys';\nimport type * as d from '../../../declarations';\nimport { coreResolvePlugin, getHydratedFlagHead, getStencilInternalModule } from '../core-resolve-plugin';\nimport { APP_DATA_CONDITIONAL, STENCIL_JSX_RUNTIME_ID } from '../entry-alias-ids';\n\ndescribe('core resolve plugin', () => {\n const config: d.ValidatedConfig = mockValidatedConfig({\n rootDir: '/',\n sys: createSystem(),\n });\n\n it('http localhost with port url path', () => {\n const compilerExe = 'http://localhost:3333/@stencil/core/compiler/stencil.js?v=1.2.3';\n const internalModule = 'hydrate/index.js';\n const m = getStencilInternalModule(config, compilerExe, internalModule);\n expect(m).toBe('/node_modules/@stencil/core/internal/hydrate/index.js');\n });\n\n it('node path', () => {\n const compilerExe = '/Users/me/node_modules/stencil/compiler/stencil.js';\n const internalModule = 'client/index.js';\n const m = getStencilInternalModule(config, compilerExe, internalModule);\n expect(m).toBe('/Users/me/node_modules/stencil/internal/client/index.js');\n });\n\n it('should not set initialValue', () => {\n const o = getHydratedFlagHead({\n name: 'yup',\n selector: 'class',\n property: 'display',\n initialValue: null,\n hydratedValue: 'block',\n });\n expect(o).toBe(`.yup{display:block}`);\n });\n\n it('should not set hydratedValue', () => {\n const o = getHydratedFlagHead({\n name: 'yup',\n selector: 'class',\n property: 'display',\n initialValue: 'none',\n hydratedValue: null,\n });\n expect(o).toBe(`{display:none}`);\n });\n\n it('should set class selector', () => {\n const o = getHydratedFlagHead({\n name: 'yup',\n selector: 'class',\n property: 'display',\n initialValue: 'none',\n hydratedValue: 'block',\n });\n expect(o).toBe(`{display:none}.yup{display:block}`);\n });\n\n it('should set attribute selector', () => {\n const o = getHydratedFlagHead({\n name: 'yup',\n selector: 'attribute',\n property: 'display',\n initialValue: 'none',\n hydratedValue: 'block',\n });\n expect(o).toBe(`{display:none}[yup]{display:block}`);\n });\n\n describe('jsx-runtime resolution', () => {\n it('should resolve jsx-runtime to same path as @stencil/core for lazy builds', () => {\n const compilerCtx = mockCompilerCtx(config);\n const plugin = coreResolvePlugin(config, compilerCtx, 'client', false, true);\n const resolved = (plugin.resolveId as Function)(STENCIL_JSX_RUNTIME_ID);\n expect(resolved).toContain('internal/client/index.js');\n expect(resolved).toContain(APP_DATA_CONDITIONAL);\n });\n });\n});\n"
},
{
"path": "src/compiler/bundle/test/ext-transforms-plugin.spec.ts",
"content": "import { mockBuildCtx, mockCompilerCtx, mockModule, mockValidatedConfig } from '@stencil/core/testing';\nimport { normalizePath } from '@utils';\n\nimport * as importPathLib from '../../transformers/stencil-import-path';\nimport { stubComponentCompilerMeta } from '../../types/tests/ComponentCompilerMeta.stub';\nimport { BundleOptions } from '../bundle-interface';\nimport { extTransformsPlugin } from '../ext-transforms-plugin';\n\ndescribe('extTransformsPlugin', () => {\n function setup(bundleOptsOverrides: Partial = {}) {\n const config = mockValidatedConfig({\n plugins: [],\n outputTargets: [\n {\n type: 'dist-collection',\n dir: 'dist/',\n collectionDir: 'dist/collectionDir',\n },\n ],\n srcDir: '/some/stubbed/path',\n });\n const compilerCtx = mockCompilerCtx(config);\n const buildCtx = mockBuildCtx(config, compilerCtx);\n\n const compilerComponentMeta = stubComponentCompilerMeta({\n tagName: 'my-component',\n componentClassName: 'MyComponent',\n });\n\n buildCtx.components = [compilerComponentMeta];\n\n compilerCtx.moduleMap.set(\n compilerComponentMeta.sourceFilePath,\n mockModule({\n cmps: [compilerComponentMeta],\n }),\n );\n\n const bundleOpts: BundleOptions = {\n id: 'test-bundle',\n platform: 'client',\n inputs: {},\n ...bundleOptsOverrides,\n };\n\n const cssText = ':host { text: pink; }';\n\n // mock out the read for our CSS\n jest.spyOn(compilerCtx.fs, 'readFile').mockResolvedValue(cssText);\n\n // mock out compilerCtx.worker.transformCssToEsm because 1) we want to\n // test what arguments are passed to it and 2) calling it un-mocked causes\n // the infamous autoprefixer-spew-issue :(\n const transformCssToEsmSpy = jest.spyOn(compilerCtx.worker, 'transformCssToEsm').mockResolvedValue({\n styleText: cssText,\n output: cssText,\n map: null,\n diagnostics: [],\n imports: [],\n defaultVarName: 'foo',\n styleDocs: [],\n });\n\n const writeFileSpy = jest.spyOn(compilerCtx.fs, 'writeFile');\n return {\n plugin: extTransformsPlugin(config, compilerCtx, buildCtx),\n config,\n compilerCtx,\n buildCtx,\n bundleOpts,\n writeFileSpy,\n transformCssToEsmSpy,\n cssText,\n };\n }\n\n describe('transform function', () => {\n it('should set name', () => {\n expect(setup().plugin.name).toBe('extTransformsPlugin');\n });\n\n it('should return early if no data can be gleaned from the id', async () => {\n const { plugin } = setup();\n // @ts-ignore we're testing something which shouldn't normally happen,\n // but might if an argument of the wrong type were passed as `id`\n const parseSpy = jest.spyOn(importPathLib, 'parseImportPath').mockReturnValue({ data: null });\n // @ts-ignore the Rollup plugins expect to be called in a Rollup context\n expect(await plugin.transform('asdf', 'foo.css')).toBe(null);\n parseSpy.mockRestore();\n });\n\n it('should write CSS files if associated with a tag', async () => {\n const { plugin, writeFileSpy } = setup();\n\n // @ts-ignore the Rollup plugins expect to be called in a Rollup context\n await plugin.transform('asdf', '/some/stubbed/path/foo.css?tag=my-component');\n\n const [path, css] = writeFileSpy.mock.calls[0];\n\n expect(normalizePath(path)).toBe('./dist/collectionDir/foo.css');\n\n expect(css).toBe(':host { text: pink; }');\n });\n });\n});\n"
},
{
"path": "src/compiler/bundle/typescript-plugin.ts",
"content": "import { isDtsFile, isString, normalizeFsPath } from '@utils';\nimport { basename, isAbsolute } from 'path';\nimport type { LoadResult, Plugin, TransformResult } from 'rollup';\nimport ts from 'typescript';\n\nimport type * as d from '../../declarations';\nimport { tsResolveModuleName } from '../sys/typescript/typescript-resolve-module';\nimport { getModule } from '../transpile/transpiled-module';\nimport type { BundleOptions } from './bundle-interface';\n\n/**\n * Rollup plugin that aids in resolving the TypeScript files and performing the transpilation step.\n * @param compilerCtx the current compiler context\n * @param bundleOpts Rollup bundling options to apply during TypeScript compilation\n * @param config the Stencil configuration for the project\n * @returns the rollup plugin for handling TypeScript files.\n */\nexport const typescriptPlugin = (\n compilerCtx: d.CompilerCtx,\n bundleOpts: BundleOptions,\n config: d.ValidatedConfig,\n): Plugin => {\n return {\n name: `${bundleOpts.id}TypescriptPlugin`,\n\n /**\n * A rollup build hook for loading TypeScript files and their associated source maps (if they exist).\n * [Source](https://rollupjs.org/guide/en/#load)\n * @param id the path of the file to load\n * @returns the module matched (with its sourcemap if it exists), null otherwise\n */\n load(id: string): LoadResult {\n if (isAbsolute(id)) {\n const fsFilePath = normalizeFsPath(id);\n const module = getModule(compilerCtx, fsFilePath);\n\n if (module) {\n if (!module.sourceMapFileText) {\n return { code: module.staticSourceFileText, map: null };\n }\n\n const sourceMap: d.SourceMap = JSON.parse(module.sourceMapFileText);\n sourceMap.sources = sourceMap.sources.map((src) => basename(src));\n return { code: module.staticSourceFileText, map: sourceMap };\n }\n }\n return null;\n },\n /**\n * Performs TypeScript compilation/transpilation, including applying any transformations against the Abstract Syntax\n * Tree (AST) specific to stencil\n * @param _code the code to modify, unused\n * @param id module's identifier\n * @returns the transpiled code, with its associated sourcemap. null otherwise\n */\n transform(_code: string, id: string): TransformResult {\n if (isAbsolute(id)) {\n const fsFilePath = normalizeFsPath(id);\n const mod = getModule(compilerCtx, fsFilePath);\n if (mod?.cmps) {\n const tsResult = ts.transpileModule(mod.staticSourceFileText, {\n compilerOptions: config.tsCompilerOptions,\n fileName: mod.sourceFilePath,\n transformers: {\n before: bundleOpts.customBeforeTransformers ?? [],\n },\n });\n const sourceMap: d.SourceMap = tsResult.sourceMapText ? JSON.parse(tsResult.sourceMapText) : null;\n return { code: tsResult.outputText, map: sourceMap };\n }\n }\n return null;\n },\n };\n};\n\nexport const resolveIdWithTypeScript = (config: d.ValidatedConfig, compilerCtx: d.CompilerCtx): Plugin => {\n return {\n name: `resolveIdWithTypeScript`,\n\n async resolveId(importee, importer) {\n if (/\\0/.test(importee) || !isString(importer)) {\n return null;\n }\n\n const tsResolved = tsResolveModuleName(config, compilerCtx, importee, importer);\n if (tsResolved && tsResolved.resolvedModule) {\n // this is probably a .d.ts file for whatever reason in how TS resolves this\n // use this resolved file as the \"importer\"\n const tsResolvedPath = tsResolved.resolvedModule.resolvedFileName;\n if (isString(tsResolvedPath) && !isDtsFile(tsResolvedPath)) {\n return tsResolvedPath;\n }\n }\n\n return null;\n },\n };\n};\n"
},
{
"path": "src/compiler/bundle/user-index-plugin.ts",
"content": "import { join } from '@utils';\nimport type { Plugin } from 'rollup';\n\nimport type * as d from '../../declarations';\nimport { USER_INDEX_ENTRY_ID } from './entry-alias-ids';\n\nexport const userIndexPlugin = (config: d.ValidatedConfig, compilerCtx: d.CompilerCtx): Plugin => {\n return {\n name: 'userIndexPlugin',\n\n async resolveId(importee) {\n if (importee === USER_INDEX_ENTRY_ID) {\n const usersIndexJsPath = join(config.srcDir, 'index.ts');\n const hasUserIndex = await compilerCtx.fs.access(usersIndexJsPath);\n if (hasUserIndex) {\n return usersIndexJsPath;\n }\n return importee;\n }\n return null;\n },\n\n async load(id) {\n if (id === USER_INDEX_ENTRY_ID) {\n return `//! Autogenerated index`;\n }\n return null;\n },\n };\n};\n"
},
{
"path": "src/compiler/bundle/worker-plugin.ts",
"content": "import { generatePreamble, hasError, normalizeFsPath } from '@utils';\nimport type { Plugin, PluginContext, TransformResult } from 'rollup';\n\nimport type * as d from '../../declarations';\nimport type { BundlePlatform } from './bundle-interface';\nimport { optimizeModule } from '../optimize/optimize-module';\nimport { bundleOutput } from './bundle-output';\nimport { STENCIL_INTERNAL_ID } from './entry-alias-ids';\n\nexport const workerPlugin = (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n buildCtx: d.BuildCtx,\n platform: BundlePlatform,\n inlineWorkers: boolean,\n): Plugin => {\n if (platform === 'worker' || platform === 'hydrate') {\n return {\n name: 'workerPlugin',\n transform(_, id) {\n if (id.endsWith('?worker') || id.endsWith('?worker-inline')) {\n return getMockedWorkerMain();\n }\n return null;\n },\n };\n }\n\n const workersMap = new Map();\n\n return {\n name: 'workerPlugin',\n\n buildStart() {\n workersMap.clear();\n },\n\n resolveId(id) {\n if (id === WORKER_HELPER_ID) {\n return {\n id,\n moduleSideEffects: false,\n };\n }\n return null;\n },\n\n load(id) {\n if (id === WORKER_HELPER_ID) {\n return WORKER_HELPERS;\n }\n return null;\n },\n\n async transform(_, id): Promise {\n if (/\\0/.test(id)) {\n return null;\n }\n\n // Canonical worker path\n if (id.endsWith('?worker')) {\n const workerEntryPath = normalizeFsPath(id);\n const workerName = getWorkerName(workerEntryPath);\n const { code, dependencies, workerMsgId } = await getWorker(\n config,\n compilerCtx,\n buildCtx,\n this,\n workersMap,\n workerEntryPath,\n );\n const referenceId = this.emitFile({\n type: 'asset',\n source: code,\n name: workerName + '.js',\n });\n dependencies.forEach((id) => this.addWatchFile(id));\n return {\n code: getWorkerMain(referenceId, workerName, workerMsgId),\n moduleSideEffects: false,\n };\n } else if (id.endsWith('?worker-inline')) {\n const workerEntryPath = normalizeFsPath(id);\n const workerName = getWorkerName(workerEntryPath);\n const { code, dependencies, workerMsgId } = await getWorker(\n config,\n compilerCtx,\n buildCtx,\n this,\n workersMap,\n workerEntryPath,\n );\n const referenceId = this.emitFile({\n type: 'asset',\n source: code,\n name: workerName + '.js',\n });\n dependencies.forEach((id) => this.addWatchFile(id));\n return {\n code: getInlineWorker(referenceId, workerName, workerMsgId),\n moduleSideEffects: false,\n };\n }\n\n // Proxy worker path\n const workerEntryPath = getWorkerEntryPath(id);\n if (workerEntryPath != null) {\n const worker = await getWorker(config, compilerCtx, buildCtx, this, workersMap, workerEntryPath);\n if (worker) {\n if (inlineWorkers) {\n return {\n code: getInlineWorkerProxy(workerEntryPath, worker.workerMsgId, worker.exports),\n moduleSideEffects: false,\n };\n } else {\n return {\n code: getWorkerProxy(workerEntryPath, worker.exports),\n moduleSideEffects: false,\n };\n }\n }\n }\n return null;\n },\n };\n};\n\nconst getWorkerEntryPath = (id: string) => {\n if (WORKER_SUFFIX.some((p) => id.endsWith(p))) {\n return normalizeFsPath(id);\n }\n return null;\n};\n\ninterface WorkerMeta {\n code: string;\n workerMsgId: string;\n exports: string[];\n dependencies: string[];\n}\n\nconst getWorker = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n buildCtx: d.BuildCtx,\n ctx: PluginContext,\n workersMap: Map,\n workerEntryPath: string,\n): Promise => {\n let worker = workersMap.get(workerEntryPath);\n if (!worker) {\n worker = await buildWorker(config, compilerCtx, buildCtx, ctx, workerEntryPath);\n workersMap.set(workerEntryPath, worker);\n }\n return worker;\n};\n\nconst getWorkerName = (id: string) => {\n const parts = id.split('/').filter((i) => !i.includes('index'));\n id = parts[parts.length - 1];\n return id.replace('.tsx', '').replace('.ts', '');\n};\n\nconst buildWorker = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n buildCtx: d.BuildCtx,\n ctx: PluginContext,\n workerEntryPath: string,\n) => {\n const workerName = getWorkerName(workerEntryPath);\n const workerMsgId = `stencil.${workerName}`;\n const build = await bundleOutput(config, compilerCtx, buildCtx, {\n platform: 'worker',\n id: workerName,\n inputs: {\n [workerName]: workerEntryPath,\n },\n inlineDynamicImports: true,\n });\n\n if (build) {\n // Generate commonjs output so we can intercept exports at runtime\n const output = await build.generate({\n format: 'commonjs',\n banner: `${generatePreamble(config)}\\n(()=>{\\n`,\n footer: '})();',\n intro: getWorkerIntro(workerMsgId, config.devMode),\n esModule: false,\n externalLiveBindings: false,\n });\n const entryPoint = output.output[0];\n if (entryPoint.imports.length > 0) {\n ctx.error('Workers should not have any external imports: ' + JSON.stringify(entryPoint.imports));\n }\n\n // Optimize code\n let code = entryPoint.code;\n const results = await optimizeModule(config, compilerCtx, {\n input: code,\n sourceTarget: config.buildEs5 ? 'es5' : 'es2017',\n isCore: false,\n minify: config.minifyJs,\n inlineHelpers: true,\n });\n buildCtx.diagnostics.push(...results.diagnostics);\n if (!hasError(results.diagnostics)) {\n code = results.output;\n }\n\n return {\n code,\n exports: entryPoint.exports,\n workerMsgId,\n dependencies: Object.keys(entryPoint.modules).filter((id) => !/\\0/.test(id) && id !== workerEntryPath),\n };\n }\n return null;\n};\n\nconst WORKER_SUFFIX = ['.worker.ts', '.worker.tsx', '.worker/index.ts', '.worker/index.tsx'];\n\nconst WORKER_HELPER_ID = '@worker-helper';\n\nconst GET_TRANSFERABLES = `\nconst isInstanceOf = (value, className) => {\n const C = globalThis[className];\n return C != null && value instanceof C;\n}\nconst getTransferables = (value) => {\n if (value != null) {\n if (\n isInstanceOf(value, \"ArrayBuffer\") ||\n isInstanceOf(value, \"MessagePort\") ||\n isInstanceOf(value, \"ImageBitmap\") ||\n isInstanceOf(value, \"OffscreenCanvas\")\n ) {\n return [value];\n }\n if (typeof value === \"object\") {\n if (value.constructor === Object) {\n value = Object.values(value);\n }\n if (Array.isArray(value)) {\n return value.flatMap(getTransferables);\n }\n return getTransferables(value.buffer);\n }\n }\n return [];\n};`;\nconst getWorkerIntro = (workerMsgId: string, isDev: boolean) => `\n${GET_TRANSFERABLES}\nconst exports = {};\nconst workerMsgId = '${workerMsgId}';\nconst workerMsgCallbackId = workerMsgId + '.cb';\naddEventListener('message', async ({data}) => {\n if (data && data[0] === workerMsgId) {\n let id = data[1];\n let method = data[2];\n let args = data[3];\n let i = 0;\n let argsLen = args.length;\n let value;\n let err;\n\n try {\n for (; i < argsLen; i++) {\n if (Array.isArray(args[i]) && args[i][0] === workerMsgCallbackId) {\n const callbackId = args[i][1];\n args[i] = (...cbArgs) => {\n postMessage(\n [workerMsgCallbackId, callbackId, cbArgs]\n );\n };\n }\n }\n ${\n isDev\n ? `\n value = exports[method](...args);\n if (!value || !value.then) {\n throw new Error('The exported method \"' + method + '\" does not return a Promise, make sure it is an \"async\" function');\n }\n value = await value;\n `\n : `\n value = await exports[method](...args);`\n }\n\n } catch (e) {\n value = null;\n if (e instanceof Error) {\n err = {\n isError: true,\n value: {\n message: e.message,\n name: e.name,\n stack: e.stack,\n }\n };\n } else {\n err = {\n isError: false,\n value: e\n };\n }\n value = undefined;\n }\n\n const transferables = getTransferables(value);\n ${isDev ? `if (transferables.length > 0) console.debug('Transfering', transferables);` : ''}\n\n postMessage(\n [workerMsgId, id, value, err],\n transferables\n );\n }\n});\n`;\n\nexport const WORKER_HELPERS = `\nimport { consoleError } from '${STENCIL_INTERNAL_ID}';\n\n${GET_TRANSFERABLES}\n\nlet pendingIds = 0;\nlet callbackIds = 0;\nconst pending = new Map();\nconst callbacks = new Map();\n\nexport const createWorker = (workerPath, workerName, workerMsgId) => {\n const worker = new Worker(workerPath, {name:workerName});\n\n worker.addEventListener('message', ({data}) => {\n if (data) {\n const workerMsg = data[0];\n const id = data[1];\n const value = data[2];\n\n if (workerMsg === workerMsgId) {\n const err = data[3];\n const [resolve, reject, callbackIds] = pending.get(id);\n pending.delete(id);\n\n if (err) {\n const errObj = (err.isError)\n ? Object.assign(new Error(err.value.message), err.value)\n : err.value;\n\n consoleError(errObj);\n reject(errObj);\n } else {\n if (callbackIds) {\n callbackIds.forEach(id => callbacks.delete(id));\n }\n resolve(value);\n }\n } else if (workerMsg === workerMsgId + '.cb') {\n try {\n callbacks.get(id)(...value);\n } catch (e) {\n consoleError(e);\n }\n }\n }\n });\n\n return worker;\n};\n\nexport const createWorkerProxy = (worker, workerMsgId, exportedMethod) => (\n (...args) => new Promise((resolve, reject) => {\n let pendingId = pendingIds++;\n let i = 0;\n let argLen = args.length;\n let mainData = [resolve, reject];\n pending.set(pendingId, mainData);\n\n for (; i < argLen; i++) {\n if (typeof args[i] === 'function') {\n const callbackId = callbackIds++;\n callbacks.set(callbackId, args[i]);\n args[i] = [workerMsgId + '.cb', callbackId];\n (mainData[2] = mainData[2] || []).push(callbackId);\n }\n }\n const postMessage = (w) => (\n w.postMessage(\n [workerMsgId, pendingId, exportedMethod, args],\n getTransferables(args)\n )\n );\n if (worker.then) {\n worker.then(postMessage);\n } else {\n postMessage(worker);\n }\n })\n);\n`;\n\nconst getWorkerMain = (referenceId: string, workerName: string, workerMsgId: string) => {\n return `\nimport { createWorker } from '${WORKER_HELPER_ID}';\nexport const workerName = '${workerName}';\nexport const workerMsgId = '${workerMsgId}';\nexport const workerPath = /*@__PURE__*/import.meta.ROLLUP_FILE_URL_${referenceId};\nexport const worker = /*@__PURE__*/createWorker(workerPath, workerName, workerMsgId);\n`;\n};\n\nconst getInlineWorker = (referenceId: string, workerName: string, workerMsgId: string) => {\n return `\nimport { createWorker } from '${WORKER_HELPER_ID}';\nexport const workerName = '${workerName}';\nexport const workerMsgId = '${workerMsgId}';\nexport const workerPath = /*@__PURE__*/import.meta.ROLLUP_FILE_URL_${referenceId};\nexport let worker;\ntry {\n // first try directly starting the worker with the URL\n worker = /*@__PURE__*/createWorker(workerPath, workerName, workerMsgId);\n} catch(e) {\n // probably a cross-origin issue, try using a Blob instead\n const blob = new Blob(['importScripts(\"' + workerPath + '\")'], { type: 'text/javascript' });\n const url = URL.createObjectURL(blob);\n worker = /*@__PURE__*/createWorker(url, workerName, workerMsgId);\n URL.revokeObjectURL(url);\n}\n`;\n};\n\nconst getMockedWorkerMain = () => {\n // for the hydrate build the workers won't actually work\n // however, we still need to make the {worker} export\n // kick-in otherwise bundling chokes\n return `\nexport const workerName = 'mocked-worker';\nexport const workerMsgId = workerName;\nexport const workerPath = workerName;\nexport const worker = { name: workerName };\n`;\n};\n\nconst getWorkerProxy = (workerEntryPath: string, exportedMethods: string[]) => {\n return `\nimport { createWorkerProxy } from '${WORKER_HELPER_ID}';\nimport { worker, workerName, workerMsgId } from '${workerEntryPath}?worker';\n${exportedMethods\n .map((exportedMethod) => {\n return `export const ${exportedMethod} = /*@__PURE__*/createWorkerProxy(worker, workerMsgId, '${exportedMethod}');`;\n })\n .join('\\n')}\n`;\n};\n\nconst getInlineWorkerProxy = (workerEntryPath: string, workerMsgId: string, exportedMethods: string[]) => {\n return `\nimport { createWorkerProxy } from '${WORKER_HELPER_ID}';\nconst workerPromise = import('${workerEntryPath}?worker-inline').then(m => m.worker);\n${exportedMethods\n .map((exportedMethod) => {\n return `export const ${exportedMethod} = /*@__PURE__*/createWorkerProxy(workerPromise, '${workerMsgId}', '${exportedMethod}');`;\n })\n .join('\\n')}\n`;\n};\n"
},
{
"path": "src/compiler/cache.ts",
"content": "import { join } from '@utils';\n\nimport type * as d from '../declarations';\nimport { InMemoryFileSystem } from './sys/in-memory-fs';\n\nexport class Cache implements d.Cache {\n private failed = 0;\n private skip = false;\n private sys: d.CompilerSystem;\n private logger: d.Logger;\n private buildCacheDir: string;\n\n constructor(\n private config: d.ValidatedConfig,\n private cacheFs: InMemoryFileSystem,\n ) {\n this.sys = config.sys;\n this.logger = config.logger;\n }\n\n async initCacheDir() {\n if (this.config._isTesting || !this.config.cacheDir) {\n return;\n }\n\n this.buildCacheDir = join(this.config.cacheDir, '.build');\n\n if (!this.config.enableCache || !this.cacheFs) {\n this.config.logger.info(`cache optimizations disabled`);\n this.clearDiskCache();\n return;\n }\n\n this.config.logger.debug(`cache enabled, cacheDir: ${this.buildCacheDir}`);\n\n try {\n const readmeFilePath = join(this.buildCacheDir, '_README.log');\n await this.cacheFs.writeFile(readmeFilePath, CACHE_DIR_README);\n } catch (e) {\n this.logger.error(`Cache, initCacheDir: ${e}`);\n this.config.enableCache = false;\n }\n }\n\n async get(key: string) {\n if (!this.config.enableCache || this.skip) {\n return null;\n }\n\n if (this.failed >= MAX_FAILED) {\n if (!this.skip) {\n this.skip = true;\n this.logger.debug(`cache had ${this.failed} failed ops, skip disk ops for remainder of build`);\n }\n return null;\n }\n\n let result: string | null;\n try {\n result = await this.cacheFs.readFile(this.getCacheFilePath(key));\n this.failed = 0;\n this.skip = false;\n } catch (e: unknown) {\n this.failed++;\n result = null;\n }\n\n return result;\n }\n\n async put(key: string, value: string) {\n if (!this.config.enableCache) {\n return false;\n }\n\n try {\n await this.cacheFs.writeFile(this.getCacheFilePath(key), value);\n return true;\n } catch (e: unknown) {\n this.failed++;\n return false;\n }\n }\n\n async has(key: string) {\n const val = await this.get(key);\n return typeof val === 'string';\n }\n\n async createKey(domain: string, ...args: any[]) {\n if (!this.config.enableCache || !this.sys.generateContentHash) {\n return domain + Math.random() * 9999999;\n }\n\n const hash = await this.sys.generateContentHash(JSON.stringify(args), 32);\n return domain + '_' + hash;\n }\n\n async commit() {\n if (this.config.enableCache) {\n this.skip = false;\n this.failed = 0;\n await this.cacheFs.commit();\n await this.clearExpiredCache();\n }\n }\n\n clear() {\n if (this.cacheFs != null) {\n this.cacheFs.clearCache();\n }\n }\n\n async clearExpiredCache() {\n if (this.cacheFs == null || this.sys.cacheStorage == null) {\n return;\n }\n\n const now = Date.now();\n\n const lastClear = (await this.sys.cacheStorage.get(EXP_STORAGE_KEY)) as number;\n if (lastClear != null) {\n const diff = now - lastClear;\n if (diff < ONE_DAY) {\n return;\n }\n\n const fs = this.cacheFs.sys;\n const cachedFileNames = await fs.readDir(this.buildCacheDir);\n const cachedFilePaths = cachedFileNames.map((f) => join(this.buildCacheDir, f));\n\n let totalCleared = 0;\n\n const promises = cachedFilePaths.map(async (filePath) => {\n const stat = await fs.stat(filePath);\n const lastModified = stat.mtimeMs;\n\n if (lastModified && now - lastModified > ONE_WEEK) {\n await fs.removeFile(filePath);\n totalCleared++;\n }\n });\n\n await Promise.all(promises);\n\n this.logger.debug(`clearExpiredCache, cachedFileNames: ${cachedFileNames.length}, totalCleared: ${totalCleared}`);\n }\n\n this.logger.debug(`clearExpiredCache, set last clear`);\n await this.sys.cacheStorage.set(EXP_STORAGE_KEY, now);\n }\n\n async clearDiskCache() {\n if (this.cacheFs != null) {\n const hasAccess = await this.cacheFs.access(this.buildCacheDir);\n if (hasAccess) {\n await this.cacheFs.remove(this.buildCacheDir);\n await this.cacheFs.commit();\n }\n }\n }\n\n private getCacheFilePath(key: string): string {\n return join(this.buildCacheDir, key) + '.log';\n }\n\n getMemoryStats(): string | null {\n if (this.cacheFs != null) {\n return this.cacheFs.getMemoryStats();\n }\n return null;\n }\n}\n\nconst MAX_FAILED = 100;\nconst ONE_DAY = 1000 * 60 * 60 * 24;\nconst ONE_WEEK = ONE_DAY * 7;\nconst EXP_STORAGE_KEY = `last_clear_expired_cache`;\n\nconst CACHE_DIR_README = `# Stencil Cache Directory\n\nThis directory contains files which the compiler has\ncached for faster builds. To disable caching, please set\n\"enableCache: false\" within the stencil config.\n\nTo change the cache directory, please update the\n\"cacheDir\" property within the stencil config.\n`;\n"
},
{
"path": "src/compiler/compiler.ts",
"content": "import { isFunction } from '@utils';\nimport ts from 'typescript';\n\nimport type { Compiler, Config, Diagnostic, ValidatedConfig } from '../declarations';\nimport { CompilerContext } from './build/compiler-ctx';\nimport { createFullBuild } from './build/full-build';\nimport { createWatchBuild } from './build/watch-build';\nimport { Cache } from './cache';\nimport { getConfig } from './sys/config';\nimport { createInMemoryFs } from './sys/in-memory-fs';\nimport { resolveModuleIdAsync } from './sys/resolve/resolve-module-async';\nimport { patchTypescript } from './sys/typescript/typescript-sys';\nimport { createSysWorker } from './sys/worker/sys-worker';\n\n/**\n * Generate a Stencil compiler instance\n * @param userConfig a user-provided Stencil configuration to apply to the compiler instance\n * @returns a new instance of a Stencil compiler\n * @public\n */\nexport const createCompiler = async (userConfig: Config): Promise => {\n // actual compiler code\n const config: ValidatedConfig = getConfig(userConfig);\n const diagnostics: Diagnostic[] = [];\n const sys = config.sys;\n const compilerCtx = new CompilerContext();\n\n if (isFunction(config.sys.setupCompiler)) {\n config.sys.setupCompiler({ ts });\n }\n\n compilerCtx.fs = createInMemoryFs(sys);\n compilerCtx.cache = new Cache(config, createInMemoryFs(sys));\n await compilerCtx.cache.initCacheDir();\n\n sys.resolveModuleId = (opts) => resolveModuleIdAsync(sys, compilerCtx.fs, opts);\n compilerCtx.worker = createSysWorker(config);\n\n if (sys.events) {\n // Pipe events from sys.events to compilerCtx\n sys.events.on(compilerCtx.events.emit);\n }\n patchTypescript(config, compilerCtx.fs);\n\n const build = () => createFullBuild(config, compilerCtx);\n\n const createWatcher = () => createWatchBuild(config, compilerCtx);\n\n const destroy = async () => {\n compilerCtx.reset();\n compilerCtx.events.unsubscribeAll();\n await sys.destroy();\n };\n\n const compiler: Compiler = {\n build,\n createWatcher,\n destroy,\n sys,\n };\n\n config.logger.printDiagnostics(diagnostics);\n\n return compiler;\n};\n"
},
{
"path": "src/compiler/config/config-utils.ts",
"content": "import { isBoolean, join } from '@utils';\nimport { isAbsolute } from 'path';\n\nimport type { ConfigFlags } from '../../cli/config-flags';\nimport type * as d from '../../declarations';\n\nexport const getAbsolutePath = (config: d.ValidatedConfig, dir: string) => {\n if (!isAbsolute(dir)) {\n dir = join(config.rootDir, dir);\n }\n return dir;\n};\n\n/**\n * This function does two things:\n *\n * 1. If you pass a `flagName`, it will hoist that `flagName` out of the\n * `ConfigFlags` object and onto the 'root' level (if you will) of the\n * `config` under the `configName` (`keyof d.Config`) that you pass.\n * 2. If you _don't_ pass a `flagName` it will just set the value you supply\n * on the config.\n *\n * @param config the config that we want to update\n * @param configName the key we're setting on the config\n * @param flagName either the name of a ConfigFlag prop we want to hoist up or null\n * @param defaultValue the default value we should set!\n */\nexport const setBooleanConfig = (\n config: d.UnvalidatedConfig,\n configName: (K & keyof ConfigFlags) | K,\n flagName: keyof ConfigFlags | null,\n defaultValue: d.Config[K],\n) => {\n if (flagName) {\n const flagValue = config.flags?.[flagName];\n if (isBoolean(flagValue)) {\n config[configName] = flagValue;\n }\n }\n\n const userConfigName = getUserConfigName(config, configName);\n\n if (typeof config[userConfigName] === 'function') {\n config[userConfigName] = !!config[userConfigName]();\n }\n\n if (isBoolean(config[userConfigName])) {\n config[configName] = config[userConfigName];\n } else {\n config[configName] = defaultValue;\n }\n};\n\n/**\n * Find any possibly mis-capitalized configuration names on the config, logging\n * and warning if one is found.\n *\n * @param config the user-supplied config that we're dealing with\n * @param correctConfigName the configuration name that we're checking for right now\n * @returns a string container a mis-capitalized config name found on the\n * config object, if any.\n */\nconst getUserConfigName = (config: d.UnvalidatedConfig, correctConfigName: keyof d.Config): string => {\n const userConfigNames = Object.keys(config);\n\n for (const userConfigName of userConfigNames) {\n if (userConfigName.toLowerCase() === correctConfigName.toLowerCase()) {\n if (userConfigName !== correctConfigName) {\n config.logger?.warn(`config \"${userConfigName}\" should be \"${correctConfigName}\"`);\n return userConfigName;\n }\n break;\n }\n }\n\n return correctConfigName;\n};\n"
},
{
"path": "src/compiler/config/constants.ts",
"content": "import type * as d from '../../declarations';\n\ntype DefaultTargetComponentConfig = d.Config['docs']['markdown']['targetComponent'];\n\nexport const DEFAULT_DEV_MODE = false;\nexport const DEFAULT_HASHED_FILENAME_LENGTH = 8;\nexport const MIN_HASHED_FILENAME_LENGTH = 4;\nexport const MAX_HASHED_FILENAME_LENGTH = 32;\nexport const DEFAULT_NAMESPACE = 'App';\nexport const DEFAULT_TARGET_COMPONENT_STYLES: DefaultTargetComponentConfig = {\n background: '#f9f',\n textColor: '#333',\n};\n"
},
{
"path": "src/compiler/config/load-config.ts",
"content": "import { createNodeSys } from '@sys-api-node';\nimport { buildError, catchError, hasError, isString, normalizePath } from '@utils';\nimport { dirname } from 'path';\n\nimport type { Diagnostic, LoadConfigInit, LoadConfigResults, UnvalidatedConfig } from '../../declarations';\nimport { nodeRequire } from '../sys/node-require';\nimport { validateTsConfig } from '../sys/typescript/typescript-config';\nimport { validateConfig } from './validate-config';\n\n/**\n * Load and validate a configuration to use throughout the lifetime of any Stencil task (build, test, etc.).\n *\n * Users can provide configurations multiple ways simultaneously:\n * - as an object of the `init` argument to this function\n * - through a path to a configuration file that exists on disk\n *\n * In the case of both being present, the two configurations will be merged. The fields of the former will take precedence\n * over the fields of the latter.\n *\n * @param init the initial configuration provided by the user (or generated by Stencil) used to bootstrap configuration\n * loading and validation\n * @returns the results of loading a configuration\n * @public\n */\nexport const loadConfig = async (init: LoadConfigInit = {}): Promise => {\n const results: LoadConfigResults = {\n config: null,\n diagnostics: [],\n tsconfig: {\n path: null,\n compilerOptions: null,\n files: null,\n include: null,\n exclude: null,\n extends: null,\n },\n };\n\n const unknownConfig: UnvalidatedConfig = {};\n\n try {\n const config = init.config || {};\n let configPath = init.configPath || config.configPath;\n\n // Pull the {@link CompilerSystem} out of the initialization object, or create one if it does not exist.\n // This entity is needed to load the project's configuration (and therefore needs to be created before it can be\n // attached to a configuration entity, validated or otherwise)\n const sys = init.sys ?? createNodeSys();\n\n const loadedConfigFile = await loadConfigFile(results.diagnostics, configPath);\n if (hasError(results.diagnostics)) {\n return results;\n }\n\n if (loadedConfigFile !== null) {\n // merge the user's config object into their loaded config file\n configPath = loadedConfigFile.configPath;\n unknownConfig.config = { ...loadedConfigFile, ...config };\n unknownConfig.config.configPath = configPath;\n unknownConfig.config.rootDir =\n typeof config.rootDir === 'string' ? config.rootDir : normalizePath(dirname(configPath));\n } else {\n // no stencil.config.ts or .js file, which is fine\n unknownConfig.config = { ...config };\n unknownConfig.config.configPath = null;\n unknownConfig.config.rootDir = normalizePath(sys.getCurrentDirectory());\n }\n\n unknownConfig.config.sys = sys;\n\n const validated = validateConfig(unknownConfig.config, init);\n results.diagnostics.push(...validated.diagnostics);\n if (hasError(results.diagnostics)) {\n return results;\n }\n\n results.config = validated.config;\n\n if (!hasError(results.diagnostics)) {\n const tsConfigResults = await validateTsConfig(results.config, sys, init);\n results.diagnostics.push(...tsConfigResults.diagnostics);\n\n results.config.tsconfig = tsConfigResults.path;\n results.config.tsCompilerOptions = tsConfigResults.compilerOptions;\n results.config.tsWatchOptions = tsConfigResults.watchOptions;\n\n results.tsconfig.path = tsConfigResults.path;\n results.tsconfig.compilerOptions = JSON.parse(JSON.stringify(tsConfigResults.compilerOptions));\n results.tsconfig.files = tsConfigResults.files;\n results.tsconfig.include = tsConfigResults.include;\n results.tsconfig.exclude = tsConfigResults.exclude;\n results.tsconfig.extends = tsConfigResults.extends;\n }\n } catch (e: any) {\n catchError(results.diagnostics, e);\n }\n\n return results;\n};\n\n/**\n * Load a Stencil configuration file from disk\n *\n * @param diagnostics a series of diagnostics used to track errors & warnings\n * throughout the loading process. Entries may be added to this list in the\n * event of an error.\n * @param configPath the path to the configuration file to load\n * @returns an unvalidated configuration. In the event of an error, additional\n * diagnostics may be pushed to the provided `diagnostics` argument and `null`\n * will be returned.\n */\nconst loadConfigFile = async (diagnostics: Diagnostic[], configPath: string): Promise => {\n let config: UnvalidatedConfig | null = null;\n\n if (isString(configPath)) {\n // the passed in config was a string, so it's probably a path to the config we need to load\n const configFileData = await evaluateConfigFile(diagnostics, configPath);\n if (hasError(diagnostics)) {\n return config;\n }\n\n if (!configFileData.config) {\n const err = buildError(diagnostics);\n err.messageText = `Invalid Stencil configuration file \"${configPath}\". Missing \"config\" property.`;\n err.absFilePath = configPath;\n return config;\n }\n config = configFileData.config;\n config.configPath = normalizePath(configPath);\n }\n\n return config;\n};\n\n/**\n * Load the configuration file, based on the environment that Stencil is being run in\n *\n * @param diagnostics a series of diagnostics used to track errors & warnings\n * throughout the loading process. Entries may be added to this list in the\n * event of an error.\n * @param configFilePath the path to the configuration file to load\n * @returns an unvalidated configuration. In the event of an error, additional\n * diagnostics may be pushed to the provided `diagnostics` argument and `null`\n * will be returned.\n */\nconst evaluateConfigFile = async (\n diagnostics: Diagnostic[],\n configFilePath: string,\n): Promise<{ config?: UnvalidatedConfig } | null> => {\n let configFileData: { config?: UnvalidatedConfig } | null = null;\n\n try {\n const results = nodeRequire(configFilePath);\n diagnostics.push(...results.diagnostics);\n configFileData = results.module;\n } catch (e: any) {\n catchError(diagnostics, e);\n }\n\n return configFileData;\n};\n"
},
{
"path": "src/compiler/config/outputs/index.ts",
"content": "import { buildError, isValidConfigOutputTarget, VALID_CONFIG_OUTPUT_TARGETS } from '@utils';\n\nimport type * as d from '../../../declarations';\nimport { validateCollection } from './validate-collection';\nimport { validateCustomElement } from './validate-custom-element';\nimport { validateCustomOutput } from './validate-custom-output';\nimport { validateDist } from './validate-dist';\nimport { validateDocs } from './validate-docs';\nimport { validateHydrateScript } from './validate-hydrate-script';\nimport { validateLazy } from './validate-lazy';\nimport { validateStats } from './validate-stats';\nimport { validateWww } from './validate-www';\n\nexport const validateOutputTargets = (config: d.ValidatedConfig, diagnostics: d.Diagnostic[]) => {\n const userOutputs = (config.outputTargets || []).slice();\n\n userOutputs.forEach((outputTarget) => {\n if (!isValidConfigOutputTarget(outputTarget.type)) {\n const err = buildError(diagnostics);\n err.messageText = `Invalid outputTarget type \"${\n outputTarget.type\n }\". Valid outputTarget types include: ${VALID_CONFIG_OUTPUT_TARGETS.map((t) => `\"${t}\"`).join(', ')}`;\n }\n });\n\n config.outputTargets = [\n ...validateCollection(config, userOutputs),\n ...validateCustomElement(config, userOutputs),\n ...validateCustomOutput(config, diagnostics, userOutputs),\n ...validateLazy(config, userOutputs),\n ...validateWww(config, diagnostics, userOutputs),\n ...validateDist(config, userOutputs),\n ...validateDocs(config, diagnostics, userOutputs),\n ...validateStats(config, userOutputs),\n ];\n\n // hydrate also gets info from the www output\n config.outputTargets = [\n ...config.outputTargets,\n ...validateHydrateScript(config, [...userOutputs, ...config.outputTargets]),\n ];\n};\n"
},
{
"path": "src/compiler/config/outputs/validate-collection.ts",
"content": "import { isBoolean, isOutputTargetDistCollection } from '@utils';\n\nimport type * as d from '../../../declarations';\nimport { getAbsolutePath } from '../config-utils';\n\n/**\n * Validate and return DIST_COLLECTION output targets, ensuring that the `dir`\n * property is set on them.\n *\n * @param config a validated configuration object\n * @param userOutputs an array of output targets\n * @returns an array of validated DIST_COLLECTION output targets\n */\nexport const validateCollection = (\n config: d.ValidatedConfig,\n userOutputs: d.OutputTarget[],\n): d.OutputTargetDistCollection[] => {\n return userOutputs.filter(isOutputTargetDistCollection).map((outputTarget) => {\n return {\n ...outputTarget,\n transformAliasedImportPaths: isBoolean(outputTarget.transformAliasedImportPaths)\n ? outputTarget.transformAliasedImportPaths\n : true,\n dir: getAbsolutePath(config, outputTarget.dir ?? 'dist/collection'),\n };\n });\n};\n"
},
{
"path": "src/compiler/config/outputs/validate-custom-element.ts",
"content": "import { COPY, DIST_TYPES, isBoolean, isOutputTargetDistCustomElements, join } from '@utils';\n\nimport type {\n OutputTarget,\n OutputTargetCopy,\n OutputTargetDistCustomElements,\n OutputTargetDistTypes,\n ValidatedConfig,\n} from '../../../declarations';\nimport { CustomElementsExportBehaviorOptions } from '../../../declarations';\nimport { getAbsolutePath } from '../config-utils';\nimport { validateCopy } from '../validate-copy';\n\n/**\n * Validate one or more `dist-custom-elements` output targets. Validation of an output target may involve back-filling\n * fields that are omitted with sensible defaults and/or creating additional supporting output targets that were not\n * explicitly defined by the user\n * @param config the Stencil configuration associated with the project being compiled\n * @param userOutputs the output target(s) specified by the user\n * @returns the validated output target(s)\n */\nexport const validateCustomElement = (\n config: ValidatedConfig,\n userOutputs: ReadonlyArray,\n): ReadonlyArray => {\n const defaultDir = 'dist';\n\n return userOutputs.filter(isOutputTargetDistCustomElements).reduce(\n (outputs, o) => {\n const outputTarget = {\n ...o,\n dir: getAbsolutePath(config, o.dir || join(defaultDir, 'components')),\n };\n if (!isBoolean(outputTarget.empty)) {\n outputTarget.empty = true;\n }\n if (!isBoolean(outputTarget.externalRuntime)) {\n outputTarget.externalRuntime = true;\n }\n if (!isBoolean(outputTarget.generateTypeDeclarations)) {\n outputTarget.generateTypeDeclarations = true;\n }\n // Export behavior must be defined on the validated target config and must\n // be one of the export behavior valid values\n if (\n outputTarget.customElementsExportBehavior == null ||\n !CustomElementsExportBehaviorOptions.includes(outputTarget.customElementsExportBehavior)\n ) {\n outputTarget.customElementsExportBehavior = 'default';\n }\n\n // Normalize autoLoader option\n if (outputTarget.autoLoader === true) {\n outputTarget.autoLoader = {\n fileName: 'loader',\n autoStart: true,\n };\n } else if (outputTarget.autoLoader && typeof outputTarget.autoLoader === 'object') {\n outputTarget.autoLoader = {\n fileName: outputTarget.autoLoader.fileName || 'loader',\n autoStart: outputTarget.autoLoader.autoStart !== false,\n };\n }\n\n // unlike other output targets, Stencil does not allow users to define the output location of types at this time\n if (outputTarget.generateTypeDeclarations) {\n const typesDirectory = getAbsolutePath(config, join(defaultDir, 'types'));\n outputs.push({\n type: DIST_TYPES,\n dir: outputTarget.dir,\n typesDir: typesDirectory,\n });\n }\n\n outputTarget.copy = validateCopy(outputTarget.copy, []);\n\n if (outputTarget.copy.length > 0) {\n outputs.push({\n type: COPY,\n dir: config.rootDir,\n copy: [...outputTarget.copy],\n });\n }\n outputs.push(outputTarget);\n\n return outputs;\n },\n [] as (OutputTargetDistCustomElements | OutputTargetCopy | OutputTargetDistTypes)[],\n );\n};\n"
},
{
"path": "src/compiler/config/outputs/validate-custom-output.ts",
"content": "import { catchError, COPY, isOutputTargetCustom } from '@utils';\n\nimport type * as d from '../../../declarations';\n\nexport const validateCustomOutput = (\n config: d.ValidatedConfig,\n diagnostics: d.Diagnostic[],\n userOutputs: d.OutputTarget[],\n) => {\n return userOutputs.filter(isOutputTargetCustom).map((o) => {\n if (o.validate) {\n const localDiagnostics: d.Diagnostic[] = [];\n try {\n o.validate(config, diagnostics);\n } catch (e: any) {\n catchError(localDiagnostics, e);\n }\n if (o.copy && o.copy.length > 0) {\n config.outputTargets.push({\n type: COPY,\n dir: config.rootDir,\n copy: [...o.copy],\n });\n }\n diagnostics.push(...localDiagnostics);\n }\n return o;\n });\n};\n"
},
{
"path": "src/compiler/config/outputs/validate-dist.ts",
"content": "import {\n COPY,\n DIST_COLLECTION,\n DIST_GLOBAL_STYLES,\n DIST_LAZY,\n DIST_LAZY_LOADER,\n DIST_TYPES,\n getComponentsDtsTypesFilePath,\n isBoolean,\n isOutputTargetDist,\n isString,\n join,\n resolve,\n} from '@utils';\nimport { isAbsolute } from 'path';\n\nimport type * as d from '../../../declarations';\nimport { getAbsolutePath } from '../config-utils';\nimport { validateCopy } from '../validate-copy';\n\n/**\n * Validate that the \"dist\" output targets are valid and ready to go.\n *\n * This function will also add in additional output targets to its output, based on the input supplied.\n *\n * @param config the compiler config, what else?\n * @param userOutputs a user-supplied list of output targets.\n * @returns a list of OutputTargets which have been validated for us.\n */\nexport const validateDist = (config: d.ValidatedConfig, userOutputs: d.OutputTarget[]): d.OutputTarget[] => {\n const distOutputTargets = userOutputs.filter(isOutputTargetDist);\n\n const outputs: d.OutputTarget[] = [];\n\n for (const outputTarget of distOutputTargets) {\n const distOutputTarget = validateOutputTargetDist(config, outputTarget);\n outputs.push(distOutputTarget);\n\n const namespace = config.fsNamespace || 'app';\n const lazyDir = join(distOutputTarget.buildDir, namespace);\n\n // Lazy build for CDN in dist\n outputs.push({\n type: DIST_LAZY,\n esmDir: lazyDir,\n systemDir: config.buildEs5 ? lazyDir : undefined,\n systemLoaderFile: config.buildEs5 ? join(lazyDir, namespace + '.js') : undefined,\n legacyLoaderFile: join(distOutputTarget.buildDir, namespace + '.js'),\n polyfills: outputTarget.polyfills !== undefined ? !!distOutputTarget.polyfills : true,\n isBrowserBuild: true,\n empty: distOutputTarget.empty,\n });\n outputs.push({\n type: COPY,\n dir: lazyDir,\n copyAssets: 'dist',\n copy: (distOutputTarget.copy ?? []).concat(),\n });\n outputs.push({\n type: DIST_GLOBAL_STYLES,\n file: join(lazyDir, `${config.fsNamespace}.css`),\n });\n\n outputs.push({\n type: DIST_TYPES,\n dir: distOutputTarget.dir,\n typesDir: distOutputTarget.typesDir,\n });\n\n if (config.buildDist) {\n if (distOutputTarget.collectionDir) {\n outputs.push({\n type: DIST_COLLECTION,\n dir: distOutputTarget.dir,\n collectionDir: distOutputTarget.collectionDir,\n empty: distOutputTarget.empty,\n transformAliasedImportPaths: distOutputTarget.transformAliasedImportPathsInCollection,\n });\n outputs.push({\n type: COPY,\n dir: distOutputTarget.collectionDir,\n copyAssets: 'collection',\n copy: [...distOutputTarget.copy, { src: '**/*.svg' }, { src: '**/*.js' }],\n });\n }\n\n const esmDir = join(distOutputTarget.dir, 'esm');\n const esmEs5Dir = config.buildEs5 ? join(distOutputTarget.dir, 'esm-es5') : undefined;\n const cjsDir = join(distOutputTarget.dir, 'cjs');\n\n // Create lazy output-target\n outputs.push({\n type: DIST_LAZY,\n esmDir,\n esmEs5Dir,\n cjsDir,\n\n cjsIndexFile: join(distOutputTarget.dir, 'index.cjs.js'),\n esmIndexFile: join(distOutputTarget.dir, 'index.js'),\n polyfills: true,\n empty: distOutputTarget.empty,\n });\n\n // Create output target that will generate the /loader entry-point\n outputs.push({\n type: DIST_LAZY_LOADER,\n dir: distOutputTarget.esmLoaderPath,\n\n esmDir,\n esmEs5Dir,\n cjsDir,\n componentDts: getComponentsDtsTypesFilePath(distOutputTarget),\n empty: distOutputTarget.empty,\n });\n }\n }\n\n return outputs;\n};\n\n/**\n * Validate that an OutputTargetDist object has what it needs to do it's job.\n * To enforce this, we have this function return\n * `Required`, giving us a compile-time check that all\n * properties are defined (with either user-supplied or default values).\n *\n * @param config the current config\n * @param o the OutputTargetDist object we want to validate\n * @returns `Required`, i.e. `d.OutputTargetDist` with all\n * optional properties rendered un-optional.\n */\nconst validateOutputTargetDist = (config: d.ValidatedConfig, o: d.OutputTargetDist): Required => {\n // we need to create an object with a bunch of default values here so that\n // the typescript compiler can infer their types correctly\n const outputTarget = {\n ...o,\n dir: getAbsolutePath(config, o.dir || DEFAULT_DIR),\n buildDir: isString(o.buildDir) ? o.buildDir : DEFAULT_BUILD_DIR,\n collectionDir: o.collectionDir !== undefined ? o.collectionDir : DEFAULT_COLLECTION_DIR,\n typesDir: o.typesDir || DEFAULT_TYPES_DIR,\n esmLoaderPath: o.esmLoaderPath || DEFAULT_ESM_LOADER_DIR,\n copy: validateCopy(o.copy ?? [], []),\n polyfills: isBoolean(o.polyfills) ? o.polyfills : false,\n empty: isBoolean(o.empty) ? o.empty : true,\n transformAliasedImportPathsInCollection: isBoolean(o.transformAliasedImportPathsInCollection)\n ? o.transformAliasedImportPathsInCollection\n : true,\n isPrimaryPackageOutputTarget: o.isPrimaryPackageOutputTarget ?? false,\n } satisfies Required;\n\n if (!isAbsolute(outputTarget.buildDir)) {\n outputTarget.buildDir = join(outputTarget.dir, outputTarget.buildDir);\n }\n\n if (outputTarget.collectionDir && !isAbsolute(outputTarget.collectionDir)) {\n outputTarget.collectionDir = join(outputTarget.dir, outputTarget.collectionDir);\n }\n\n if (!isAbsolute(outputTarget.esmLoaderPath)) {\n outputTarget.esmLoaderPath = resolve(outputTarget.dir, outputTarget.esmLoaderPath);\n }\n\n if (!isAbsolute(outputTarget.typesDir)) {\n outputTarget.typesDir = join(outputTarget.dir, outputTarget.typesDir);\n }\n\n return outputTarget;\n};\n\nconst DEFAULT_DIR = 'dist';\nconst DEFAULT_BUILD_DIR = '';\nconst DEFAULT_COLLECTION_DIR = 'collection';\nconst DEFAULT_TYPES_DIR = 'types';\nconst DEFAULT_ESM_LOADER_DIR = 'loader';\n"
},
{
"path": "src/compiler/config/outputs/validate-docs.ts",
"content": "import {\n buildError,\n DOCS_JSON,\n DOCS_README,\n isFunction,\n isOutputTargetDocsCustom,\n isOutputTargetDocsCustomElementsManifest,\n isOutputTargetDocsJson,\n isOutputTargetDocsReadme,\n isOutputTargetDocsVscode,\n isString,\n join,\n} from '@utils';\nimport { isAbsolute } from 'path';\n\nimport type * as d from '../../../declarations';\nimport { NOTE } from '../../docs/constants';\n\nexport const validateDocs = (config: d.ValidatedConfig, diagnostics: d.Diagnostic[], userOutputs: d.OutputTarget[]) => {\n const docsOutputs: d.OutputTarget[] = [];\n\n // json docs flag\n if (isString(config.flags.docsJson)) {\n docsOutputs.push(\n validateJsonDocsOutputTarget(config, diagnostics, {\n type: DOCS_JSON,\n file: config.flags.docsJson,\n }),\n );\n }\n\n // json docs\n const jsonDocsOutputs = userOutputs.filter(isOutputTargetDocsJson);\n jsonDocsOutputs.forEach((jsonDocsOutput) => {\n docsOutputs.push(validateJsonDocsOutputTarget(config, diagnostics, jsonDocsOutput));\n });\n\n // readme docs flag\n if (config.flags.docs || config.flags.task === 'docs') {\n if (!userOutputs.some(isOutputTargetDocsReadme)) {\n // didn't provide a docs config, so let's add one\n docsOutputs.push(validateReadmeOutputTarget(config, { type: DOCS_README }));\n }\n }\n\n // readme docs\n const readmeDocsOutputs = userOutputs.filter(isOutputTargetDocsReadme);\n readmeDocsOutputs.forEach((readmeDocsOutput) => {\n docsOutputs.push(validateReadmeOutputTarget(config, readmeDocsOutput));\n });\n\n // custom docs\n const customDocsOutputs = userOutputs.filter(isOutputTargetDocsCustom);\n customDocsOutputs.forEach((jsonDocsOutput) => {\n docsOutputs.push(validateCustomDocsOutputTarget(diagnostics, jsonDocsOutput));\n });\n\n // vscode docs\n const vscodeDocsOutputs = userOutputs.filter(isOutputTargetDocsVscode);\n vscodeDocsOutputs.forEach((vscodeDocsOutput) => {\n docsOutputs.push(validateVScodeDocsOutputTarget(diagnostics, vscodeDocsOutput));\n });\n\n // custom elements manifest docs\n const customElementsManifestOutputs = userOutputs.filter(isOutputTargetDocsCustomElementsManifest);\n customElementsManifestOutputs.forEach((cemOutput) => {\n docsOutputs.push(validateCustomElementsManifestOutputTarget(config, cemOutput));\n });\n\n return docsOutputs;\n};\n\nconst validateReadmeOutputTarget = (config: d.ValidatedConfig, outputTarget: d.OutputTargetDocsReadme) => {\n if (!isString(outputTarget.dir)) {\n outputTarget.dir = config.srcDir;\n }\n\n if (!isAbsolute(outputTarget.dir)) {\n outputTarget.dir = join(config.rootDir, outputTarget.dir);\n }\n\n if (outputTarget.footer == null) {\n outputTarget.footer = NOTE;\n }\n outputTarget.strict = !!outputTarget.strict;\n return outputTarget;\n};\n\nconst validateJsonDocsOutputTarget = (\n config: d.ValidatedConfig,\n diagnostics: d.Diagnostic[],\n outputTarget: d.OutputTargetDocsJson,\n) => {\n if (!isString(outputTarget.file)) {\n const err = buildError(diagnostics);\n err.messageText = `docs-json outputTarget missing the \"file\" option`;\n }\n\n outputTarget.file = join(config.rootDir, outputTarget.file);\n if (isString(outputTarget.typesFile)) {\n outputTarget.typesFile = join(config.rootDir, outputTarget.typesFile);\n } else if (outputTarget.typesFile !== null && outputTarget.file.endsWith('.json')) {\n outputTarget.typesFile = outputTarget.file.replace(/\\.json$/, '.d.ts');\n }\n outputTarget.strict = !!outputTarget.strict;\n return outputTarget;\n};\n\nconst validateCustomDocsOutputTarget = (diagnostics: d.Diagnostic[], outputTarget: d.OutputTargetDocsCustom) => {\n if (!isFunction(outputTarget.generator)) {\n const err = buildError(diagnostics);\n err.messageText = `docs-custom outputTarget missing the \"generator\" function`;\n }\n\n outputTarget.strict = !!outputTarget.strict;\n return outputTarget;\n};\n\nconst validateVScodeDocsOutputTarget = (diagnostics: d.Diagnostic[], outputTarget: d.OutputTargetDocsVscode) => {\n if (!isString(outputTarget.file)) {\n const err = buildError(diagnostics);\n err.messageText = `docs-vscode outputTarget missing the \"file\" path`;\n }\n return outputTarget;\n};\n\nconst validateCustomElementsManifestOutputTarget = (\n config: d.ValidatedConfig,\n outputTarget: d.OutputTargetDocsCustomElementsManifest,\n) => {\n if (!isString(outputTarget.file)) {\n outputTarget.file = 'custom-elements.json';\n }\n outputTarget.file = join(config.rootDir, outputTarget.file);\n outputTarget.strict = !!outputTarget.strict;\n return outputTarget;\n};\n"
},
{
"path": "src/compiler/config/outputs/validate-hydrate-script.ts",
"content": "import {\n DIST_HYDRATE_SCRIPT,\n isBoolean,\n isOutputTargetDist,\n isOutputTargetHydrate,\n isOutputTargetWww,\n isString,\n join,\n} from '@utils';\nimport { isAbsolute } from 'path';\n\nimport type * as d from '../../../declarations';\n\nexport const validateHydrateScript = (config: d.ValidatedConfig, userOutputs: d.OutputTarget[]) => {\n const output: d.OutputTargetHydrate[] = [];\n\n const hasHydrateOutputTarget = userOutputs.some(isOutputTargetHydrate);\n\n if (!hasHydrateOutputTarget) {\n // we don't already have a hydrate output target\n // let's still see if we require one because of other output targets\n\n const hasWwwOutput = userOutputs.filter(isOutputTargetWww).some((o) => isString(o.indexHtml));\n const shouldBuildHydrate = config.flags.prerender || config.flags.ssr;\n\n if (hasWwwOutput && shouldBuildHydrate) {\n // we're prerendering a www output target, so we'll need a hydrate app\n let hydrateDir: string;\n const distOutput = userOutputs.find(isOutputTargetDist);\n if (distOutput != null && isString(distOutput.dir)) {\n hydrateDir = join(distOutput.dir, 'hydrate');\n } else {\n hydrateDir = 'dist/hydrate';\n }\n\n const hydrateForWwwOutputTarget: d.OutputTargetHydrate = {\n type: DIST_HYDRATE_SCRIPT,\n dir: hydrateDir,\n };\n userOutputs.push(hydrateForWwwOutputTarget);\n }\n }\n\n const hydrateOutputTargets = userOutputs.filter(isOutputTargetHydrate);\n\n hydrateOutputTargets.forEach((outputTarget) => {\n if (!isString(outputTarget.dir)) {\n // no directory given, see if we've got a dist to go off of\n outputTarget.dir = 'hydrate';\n }\n\n if (!isAbsolute(outputTarget.dir)) {\n outputTarget.dir = join(config.rootDir, outputTarget.dir);\n }\n\n if (!isBoolean(outputTarget.empty)) {\n outputTarget.empty = true;\n }\n\n if (!isBoolean(outputTarget.minify)) {\n outputTarget.minify = false;\n }\n\n if (!isBoolean(outputTarget.generatePackageJson)) {\n outputTarget.generatePackageJson = true;\n }\n\n outputTarget.external = outputTarget.external || [];\n\n outputTarget.external.push('fs');\n outputTarget.external.push('path');\n outputTarget.external.push('crypto');\n\n output.push(outputTarget);\n });\n\n return output;\n};\n"
},
{
"path": "src/compiler/config/outputs/validate-lazy.ts",
"content": "import { DIST_LAZY, isBoolean, isOutputTargetDistLazy, join } from '@utils';\n\nimport type * as d from '../../../declarations';\nimport { getAbsolutePath } from '../config-utils';\n\nexport const validateLazy = (config: d.ValidatedConfig, userOutputs: d.OutputTarget[]) => {\n return userOutputs.filter(isOutputTargetDistLazy).map((o) => {\n const dir = getAbsolutePath(config, o.dir || join('dist', config.fsNamespace));\n const lazyOutput: d.OutputTargetDistLazy = {\n type: DIST_LAZY,\n esmDir: dir,\n systemDir: config.buildEs5 ? dir : undefined,\n systemLoaderFile: config.buildEs5 ? join(dir, `${config.fsNamespace}.js`) : undefined,\n polyfills: !!o.polyfills,\n isBrowserBuild: true,\n empty: isBoolean(o.empty) ? o.empty : true,\n };\n return lazyOutput;\n });\n};\n"
},
{
"path": "src/compiler/config/outputs/validate-stats.ts",
"content": "import { isOutputTargetStats, join, STATS } from '@utils';\nimport { isAbsolute } from 'path';\n\nimport type * as d from '../../../declarations';\n\nexport const validateStats = (userConfig: d.ValidatedConfig, userOutputs: d.OutputTarget[]) => {\n const outputTargets: d.OutputTargetStats[] = [];\n\n if (userConfig.flags.stats) {\n const hasOutputTarget = userOutputs.some(isOutputTargetStats);\n if (!hasOutputTarget) {\n const statsOutput: d.OutputTargetStats = {\n type: STATS,\n };\n\n // If --stats was provided with a path (string), use it; otherwise use default\n if (typeof userConfig.flags.stats === 'string') {\n statsOutput.file = userConfig.flags.stats;\n }\n\n outputTargets.push(statsOutput);\n }\n }\n\n outputTargets.push(...userOutputs.filter(isOutputTargetStats));\n outputTargets.forEach((outputTarget) => {\n if (!outputTarget.file) {\n outputTarget.file = 'stencil-stats.json';\n }\n\n if (!isAbsolute(outputTarget.file)) {\n outputTarget.file = join(userConfig.rootDir, outputTarget.file);\n }\n });\n\n return outputTargets;\n};\n"
},
{
"path": "src/compiler/config/outputs/validate-www.ts",
"content": "import {\n buildError,\n COPY,\n DIST_GLOBAL_STYLES,\n DIST_LAZY,\n isBoolean,\n isOutputTargetDist,\n isOutputTargetWww,\n isString,\n join,\n WWW,\n} from '@utils';\nimport { isAbsolute } from 'path';\n\nimport type * as d from '../../../declarations';\nimport { getAbsolutePath } from '../config-utils';\nimport { validateCopy } from '../validate-copy';\nimport { validatePrerender } from '../validate-prerender';\nimport { validateServiceWorker } from '../validate-service-worker';\n\nexport const validateWww = (config: d.ValidatedConfig, diagnostics: d.Diagnostic[], userOutputs: d.OutputTarget[]) => {\n const hasOutputTargets = userOutputs.length > 0;\n const hasE2eTests = !!config.flags.e2e;\n const userWwwOutputs = userOutputs.filter(isOutputTargetWww);\n\n if (\n !hasOutputTargets ||\n (hasE2eTests && !userOutputs.some(isOutputTargetWww) && !userOutputs.some(isOutputTargetDist))\n ) {\n userWwwOutputs.push({ type: WWW });\n }\n\n if (config.flags.prerender && userWwwOutputs.length === 0) {\n const err = buildError(diagnostics);\n err.messageText = `You need at least one \"www\" output target configured in your stencil.config.ts, when the \"--prerender\" flag is used`;\n }\n\n return userWwwOutputs.reduce(\n (\n outputs: (d.OutputTargetWww | d.OutputTargetDistLazy | d.OutputTargetCopy | d.OutputTargetDistGlobalStyles)[],\n o,\n ) => {\n const outputTarget = validateWwwOutputTarget(config, o, diagnostics);\n outputs.push(outputTarget);\n\n // Add dist-lazy output target\n const buildDir = outputTarget.buildDir;\n outputs.push({\n type: DIST_LAZY,\n dir: buildDir,\n esmDir: buildDir,\n systemDir: config.buildEs5 ? buildDir : undefined,\n systemLoaderFile: config.buildEs5 ? join(buildDir, `${config.fsNamespace}.js`) : undefined,\n polyfills: outputTarget.polyfills,\n isBrowserBuild: true,\n });\n\n // Copy for dist\n outputs.push({\n type: COPY,\n dir: buildDir,\n copyAssets: 'dist',\n });\n\n // Copy for www\n outputs.push({\n type: COPY,\n dir: outputTarget.appDir,\n copy: validateCopy(outputTarget.copy, [\n { src: 'assets', warn: false },\n { src: 'manifest.json', warn: false },\n ]),\n });\n\n // Generate global style with original name\n outputs.push({\n type: DIST_GLOBAL_STYLES,\n file: join(buildDir, `${config.fsNamespace}.css`),\n });\n\n return outputs;\n },\n [],\n );\n};\n\nconst validateWwwOutputTarget = (\n config: d.ValidatedConfig,\n outputTarget: d.OutputTargetWww,\n diagnostics: d.Diagnostic[],\n) => {\n if (!isString(outputTarget.baseUrl)) {\n outputTarget.baseUrl = '/';\n }\n\n if (!outputTarget.baseUrl.endsWith('/')) {\n // Make sure the baseUrl always finish with \"/\"\n outputTarget.baseUrl += '/';\n }\n\n outputTarget.dir = getAbsolutePath(config, outputTarget.dir || 'www');\n\n // Fix \"dir\" to account\n const pathname = new URL(outputTarget.baseUrl, 'http://localhost/').pathname;\n outputTarget.appDir = join(outputTarget.dir, pathname);\n if (outputTarget.appDir.endsWith('/') || outputTarget.appDir.endsWith('\\\\')) {\n outputTarget.appDir = outputTarget.appDir.substring(0, outputTarget.appDir.length - 1);\n }\n\n if (!isString(outputTarget.buildDir)) {\n outputTarget.buildDir = 'build';\n }\n\n if (!isAbsolute(outputTarget.buildDir)) {\n outputTarget.buildDir = join(outputTarget.appDir, outputTarget.buildDir);\n }\n\n if (!isString(outputTarget.indexHtml)) {\n outputTarget.indexHtml = 'index.html';\n }\n\n if (!isAbsolute(outputTarget.indexHtml)) {\n outputTarget.indexHtml = join(outputTarget.appDir, outputTarget.indexHtml);\n }\n\n if (!isBoolean(outputTarget.empty)) {\n outputTarget.empty = true;\n }\n\n validatePrerender(config, diagnostics, outputTarget);\n validateServiceWorker(config, outputTarget);\n\n if (outputTarget.polyfills === undefined) {\n outputTarget.polyfills = true;\n }\n outputTarget.polyfills = !!outputTarget.polyfills;\n\n return outputTarget;\n};\n"
},
{
"path": "src/compiler/config/test/fixtures/stencil.config.ts",
"content": "import { Config } from '../../../../declarations';\n\nexport const config: Config = {\n hashedFileNameLength: 13,\n};\n"
},
{
"path": "src/compiler/config/test/fixtures/stencil.config2.ts",
"content": "import { Config } from '../../../../declarations';\n\nexport const config: Config = {\n hashedFileNameLength: 27,\n flags: {\n dev: true,\n },\n extras: {\n enableImportInjection: true,\n },\n};\n"
},
{
"path": "src/compiler/config/test/load-config.spec.ts",
"content": "import { mockCompilerSystem } from '@stencil/core/testing';\nimport path from 'path';\nimport ts from 'typescript';\n\nimport { ConfigFlags } from '../../../cli/config-flags';\nimport type * as d from '../../../declarations';\nimport { normalizePath } from '../../../utils';\nimport { loadConfig } from '../load-config';\n\ndescribe('load config', () => {\n const configPath = require.resolve('./fixtures/stencil.config.ts');\n const configPath2 = require.resolve('./fixtures/stencil.config2.ts');\n\n let sys: d.CompilerSystem;\n\n beforeEach(() => {\n sys = mockCompilerSystem();\n\n jest.spyOn(ts, 'getParsedCommandLineOfConfigFile').mockReturnValue({\n options: {\n target: ts.ScriptTarget.ES2017,\n module: ts.ModuleKind.ESNext,\n },\n fileNames: [],\n errors: [],\n });\n });\n\n afterEach(() => {\n jest.clearAllMocks();\n });\n\n it(\"merges a user's configuration with a stencil.config file on disk\", async () => {\n const loadedConfig = await loadConfig({\n configPath: configPath2,\n sys,\n config: {\n hashedFileNameLength: 9,\n rootDir: '/foo/bar',\n },\n initTsConfig: true,\n });\n\n expect(loadedConfig.diagnostics).toHaveLength(0);\n\n const actualConfig = loadedConfig.config;\n // this field is defined on the `init` argument, and should override the value found in the config on disk\n expect(actualConfig).toBeDefined();\n expect(actualConfig.hashedFileNameLength).toEqual(9);\n // these fields are defined in the config file on disk, and should be present\n expect(actualConfig.flags).toEqual({ dev: true });\n expect(actualConfig.extras).toBeDefined();\n expect(actualConfig.extras!.enableImportInjection).toBe(true);\n // respects custom root dir\n expect(actualConfig.rootDir).toBe('/foo/bar');\n });\n\n it('uses the provided config path when no initial config provided', async () => {\n const loadedConfig = await loadConfig({\n configPath,\n sys,\n initTsConfig: true,\n });\n\n expect(loadedConfig.diagnostics).toHaveLength(0);\n\n const actualConfig = loadedConfig.config;\n expect(actualConfig).toBeDefined();\n // set the config path based on the one provided in the init object\n expect(actualConfig.configPath).toBe(normalizePath(configPath));\n // this field is defined in the config file on disk, and should be present\n expect(actualConfig.hashedFileNameLength).toBe(13);\n // this field should default to an empty object literal, since it wasn't present in the config file\n expect(actualConfig.flags).toEqual({});\n });\n\n describe('empty initialization argument', () => {\n it('provides sensible default values with no config', async () => {\n const loadedConfig = await loadConfig({ initTsConfig: true, sys });\n\n const actualConfig = loadedConfig.config;\n expect(actualConfig).toBeDefined();\n expect(actualConfig.sys).toBeDefined();\n expect(actualConfig.logger).toBeDefined();\n expect(actualConfig.configPath).toBe(null);\n });\n\n it('creates a tsconfig file when \"initTsConfig\" set', async () => {\n const tsconfigPath = path.resolve(path.dirname(configPath), 'tsconfig.json');\n expect(sys.accessSync(tsconfigPath)).toBe(false);\n const loadedConfig = await loadConfig({ initTsConfig: true, configPath, sys });\n expect(sys.accessSync(tsconfigPath)).toBe(true);\n expect(loadedConfig.diagnostics).toHaveLength(0);\n });\n\n it('errors that a tsconfig file could not be created when \"initTsConfig\" isn\\'t present', async () => {\n const loadedConfig = await loadConfig({ configPath, sys });\n expect(loadedConfig.diagnostics).toHaveLength(1);\n expect(loadedConfig.diagnostics[0]).toEqual({\n absFilePath: undefined,\n header: 'Missing tsconfig.json',\n level: 'error',\n lines: [],\n messageText: `Unable to load TypeScript config file. Please create a \"tsconfig.json\" file within the \"${normalizePath(\n path.dirname(configPath),\n )}\" directory.`,\n relFilePath: undefined,\n type: 'build',\n });\n });\n });\n\n describe('no initialization argument', () => {\n it('errors that a tsconfig file cannot be found', async () => {\n const loadConfigResults = await loadConfig({ sys });\n expect(loadConfigResults.diagnostics).toHaveLength(1);\n expect(loadConfigResults.diagnostics[0]).toEqual({\n absFilePath: undefined,\n header: 'Missing tsconfig.json',\n level: 'error',\n lines: [],\n messageText: expect.stringMatching(\n `Unable to load TypeScript config file. Please create a \"tsconfig.json\" file within the`,\n ),\n relFilePath: undefined,\n type: 'build',\n });\n });\n });\n});\n"
},
{
"path": "src/compiler/config/test/tsconfig.json",
"content": "{\n \"extends\": \"../../../testing/tsconfig.internal.json\"\n}\n"
},
{
"path": "src/compiler/config/test/validate-config-sourcemap.spec.ts",
"content": "import { mockCompilerSystem, mockLoadConfigInit } from '@stencil/core/testing';\nimport ts from 'typescript';\n\nimport type * as d from '../../../declarations';\nimport { loadConfig } from '../load-config';\nimport { validateConfig } from '../validate-config';\n\ndescribe('stencil config - sourceMap option', () => {\n const configPath = require.resolve('./fixtures/stencil.config.ts');\n let sys = mockCompilerSystem();\n\n /**\n * Test helper for generating default `d.LoadConfigInit` objects.\n *\n * This function assumes the fields in the enclosing scope have been initialized.\n * @param overrides the properties on the default `d.LoadConfigInit` entity to manually override\n * @returns the default configuration initialization object, with any overrides applied\n */\n const getLoadConfigForTests = (overrides?: Partial): d.LoadConfigInit => {\n const defaults: d.LoadConfigInit = {\n configPath,\n sys: sys as any,\n config: {},\n initTsConfig: true,\n };\n\n return mockLoadConfigInit({ ...defaults, ...overrides });\n };\n\n /**\n * Test helper for mocking the {@link ts.getParsedCommandLineOfConfigFile} function. This function returns the appropriate\n * `options` object based on the `sourceMap` argument.\n *\n * @param sourceMap The `sourceMap` option from the Stencil config.\n */\n const mockTsConfigParser = (sourceMap: boolean) => {\n jest.spyOn(ts, 'getParsedCommandLineOfConfigFile').mockReturnValue({\n options: {\n target: ts.ScriptTarget.ES2017,\n module: ts.ModuleKind.ESNext,\n sourceMap,\n inlineSources: sourceMap,\n },\n fileNames: [],\n errors: [],\n });\n };\n\n beforeEach(() => {\n sys = mockCompilerSystem();\n });\n\n afterEach(() => {\n jest.clearAllMocks();\n });\n\n it('sets sourceMap to true when explicitly set to true', async () => {\n const userConfig: d.UnvalidatedConfig = { sourceMap: true };\n const { config: validatedConfig } = validateConfig(userConfig, {});\n expect(validatedConfig.sourceMap).toBe(true);\n\n mockTsConfigParser(validatedConfig.sourceMap);\n const testConfig = getLoadConfigForTests({ config: userConfig });\n const loadConfigResults = await loadConfig(testConfig);\n\n const { sourceMap, inlineSources } = loadConfigResults.config.tsCompilerOptions;\n expect(sourceMap).toBe(true);\n expect(inlineSources).toBe(true);\n });\n\n it('sets sourceMap to false when explicitly set to false', async () => {\n const userConfig: d.UnvalidatedConfig = { sourceMap: false };\n const { config: validatedConfig } = validateConfig(userConfig, {});\n expect(validatedConfig.sourceMap).toBe(false);\n\n mockTsConfigParser(validatedConfig.sourceMap);\n const testConfig = getLoadConfigForTests({ config: userConfig });\n const loadConfigResults = await loadConfig(testConfig);\n\n const { sourceMap, inlineSources } = loadConfigResults.config.tsCompilerOptions;\n expect(sourceMap).toBe(false);\n expect(inlineSources).toBe(false);\n });\n\n it('defaults to \"dev\" behavior (false in prod mode)', async () => {\n const userConfig: d.UnvalidatedConfig = { devMode: false };\n const { config: validatedConfig } = validateConfig(userConfig, {});\n expect(validatedConfig.sourceMap).toBe(false);\n\n mockTsConfigParser(validatedConfig.sourceMap);\n const testConfig = getLoadConfigForTests({ config: userConfig });\n const loadConfigResults = await loadConfig(testConfig);\n\n const { sourceMap, inlineSources } = loadConfigResults.config.tsCompilerOptions;\n expect(sourceMap).toBe(false);\n expect(inlineSources).toBe(false);\n });\n\n it('defaults to \"dev\" behavior (true in dev mode)', async () => {\n const userConfig: d.UnvalidatedConfig = { devMode: true };\n const { config: validatedConfig } = validateConfig(userConfig, {});\n expect(validatedConfig.sourceMap).toBe(true);\n\n mockTsConfigParser(validatedConfig.sourceMap);\n const testConfig = getLoadConfigForTests({ config: userConfig });\n const loadConfigResults = await loadConfig(testConfig);\n\n const { sourceMap, inlineSources } = loadConfigResults.config.tsCompilerOptions;\n expect(sourceMap).toBe(true);\n expect(inlineSources).toBe(true);\n });\n\n it('resolves \"dev\" to true when devMode is true', async () => {\n const userConfig: d.UnvalidatedConfig = { sourceMap: 'dev', devMode: true };\n const { config: validatedConfig } = validateConfig(userConfig, {});\n expect(validatedConfig.sourceMap).toBe(true);\n\n mockTsConfigParser(validatedConfig.sourceMap);\n const testConfig = getLoadConfigForTests({ config: userConfig });\n const loadConfigResults = await loadConfig(testConfig);\n\n const { sourceMap, inlineSources } = loadConfigResults.config.tsCompilerOptions;\n expect(sourceMap).toBe(true);\n expect(inlineSources).toBe(true);\n });\n\n it('resolves \"dev\" to false when devMode is false', async () => {\n const userConfig: d.UnvalidatedConfig = { sourceMap: 'dev', devMode: false };\n const { config: validatedConfig } = validateConfig(userConfig, {});\n expect(validatedConfig.sourceMap).toBe(false);\n\n mockTsConfigParser(validatedConfig.sourceMap);\n const testConfig = getLoadConfigForTests({ config: userConfig });\n const loadConfigResults = await loadConfig(testConfig);\n\n const { sourceMap, inlineSources } = loadConfigResults.config.tsCompilerOptions;\n expect(sourceMap).toBe(false);\n expect(inlineSources).toBe(false);\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-config.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\nimport { mockCompilerSystem, mockLoadConfigInit, mockLogger } from '@stencil/core/testing';\nimport { DOCS_CUSTOM, DOCS_JSON, DOCS_README, DOCS_VSCODE } from '@utils';\n\nimport { createConfigFlags } from '../../../cli/config-flags';\nimport { isWatchIgnorePath } from '../../fs-watch/fs-watch-rebuild';\nimport { validateConfig } from '../validate-config';\n\ndescribe('validation', () => {\n let userConfig: d.UnvalidatedConfig;\n let bootstrapConfig: d.LoadConfigInit;\n const logger = mockLogger();\n const sys = mockCompilerSystem();\n\n beforeEach(() => {\n userConfig = {\n sys: sys,\n logger: logger,\n rootDir: '/User/some/path/',\n namespace: 'Testing',\n };\n bootstrapConfig = mockLoadConfigInit();\n });\n\n describe('caching', () => {\n it('should cache the validated config between calls if the same config is passed back in', () => {\n const { config } = validateConfig(userConfig, {});\n const { config: secondRound } = validateConfig(config, {});\n // we should have object identity\n expect(config === secondRound).toBe(true);\n // objects should be deepEqual as well\n expect(config).toEqual(secondRound);\n });\n\n it('should bust the cache if a different config is supplied than the cached one', () => {\n // validate once, caching that result\n const { config } = validateConfig(userConfig, {});\n // pass a new initial configuration\n const { config: secondRound } = validateConfig({ ...userConfig }, {});\n // shouldn't have object equality with the earlier one\n expect(config === secondRound).toBe(false);\n });\n });\n\n describe('flags', () => {\n it('adds a default \"flags\" object if none is provided', () => {\n userConfig.flags = undefined;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.flags).toEqual({});\n });\n\n it('serializes a provided \"flags\" object', () => {\n userConfig.flags = createConfigFlags({ dev: false });\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.flags).toEqual(createConfigFlags({ dev: false }));\n });\n\n describe('devMode', () => {\n it('defaults \"devMode\" to false when \"flag.prod\" is truthy', () => {\n userConfig.flags = createConfigFlags({ prod: true });\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.devMode).toBe(false);\n });\n\n it('defaults \"devMode\" to true when \"flag.dev\" is truthy', () => {\n userConfig.flags = createConfigFlags({ dev: true });\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.devMode).toBe(true);\n });\n\n it('defaults \"devMode\" to false when \"flag.prod\" & \"flag.dev\" are truthy', () => {\n userConfig.flags = createConfigFlags({ dev: true, prod: true });\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.devMode).toBe(false);\n });\n\n it('sets \"devMode\" to false if the user provided flag isn\\'t a boolean', () => {\n // the branch under test explicitly requires a value whose type is not allowed by the type system\n const devMode = 'not-a-bool' as unknown as boolean;\n userConfig = { devMode };\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.devMode).toBe(false);\n });\n });\n });\n\n describe('allowInlineScripts', () => {\n it('set allowInlineScripts true', () => {\n userConfig.allowInlineScripts = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.allowInlineScripts).toBe(true);\n });\n\n it('set allowInlineScripts false', () => {\n userConfig.allowInlineScripts = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.allowInlineScripts).toBe(false);\n });\n\n it('default allowInlineScripts true', () => {\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.allowInlineScripts).toBe(true);\n });\n });\n\n describe('transformAliasedImportPaths', () => {\n it.each([true, false])('set transformAliasedImportPaths %p', (bool) => {\n userConfig.transformAliasedImportPaths = bool;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.transformAliasedImportPaths).toBe(bool);\n });\n\n it('defaults `transformAliasedImportPaths` to true', () => {\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.transformAliasedImportPaths).toBe(true);\n });\n });\n\n describe('suppressReservedPublicNameWarnings', () => {\n it.each([true, false])('sets suppressReservedPublicNameWarnings to %p when provided', (bool) => {\n userConfig.suppressReservedPublicNameWarnings = bool;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.suppressReservedPublicNameWarnings).toBe(bool);\n });\n\n it('defaults suppressReservedPublicNameWarnings to false', () => {\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.suppressReservedPublicNameWarnings).toBe(false);\n });\n });\n\n describe('enableCache', () => {\n it('set enableCache true', () => {\n userConfig.enableCache = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.enableCache).toBe(true);\n });\n\n it('set enableCache false', () => {\n userConfig.enableCache = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.enableCache).toBe(false);\n });\n\n it('default enableCache true', () => {\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.enableCache).toBe(true);\n });\n });\n\n describe('buildAppCore', () => {\n it('set buildAppCore true', () => {\n userConfig.buildAppCore = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.buildAppCore).toBe(true);\n });\n\n it('set buildAppCore false', () => {\n userConfig.buildAppCore = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.buildAppCore).toBe(false);\n });\n\n it('default buildAppCore true', () => {\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.buildAppCore).toBe(true);\n });\n });\n\n describe('es5 build', () => {\n it('set buildEs5 false', () => {\n userConfig.buildEs5 = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.buildEs5).toBe(false);\n });\n\n it('set buildEs5 true', () => {\n userConfig.buildEs5 = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.buildEs5).toBe(true);\n });\n\n it('set buildEs5 true, dev mode', () => {\n userConfig.devMode = true;\n userConfig.buildEs5 = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.buildEs5).toBe(true);\n });\n\n it('prod mode, set modern and es5', () => {\n userConfig.devMode = false;\n userConfig.buildEs5 = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.buildEs5).toBe(true);\n });\n\n it('build es5 when set to \"prod\" and in prod', () => {\n userConfig.devMode = false;\n userConfig.buildEs5 = 'prod';\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.buildEs5).toBe(true);\n });\n\n it('do not build es5 when set to \"prod\" and in dev', () => {\n userConfig.devMode = true;\n userConfig.buildEs5 = 'prod';\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.buildEs5).toBe(false);\n });\n\n it('prod mode default to only modern and not es5', () => {\n userConfig.devMode = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.buildEs5).toBe(false);\n });\n });\n\n describe('hashed filenames', () => {\n it('should error when hashedFileNameLength too large', () => {\n userConfig.hashedFileNameLength = 33;\n const validated = validateConfig(userConfig, bootstrapConfig);\n expect(validated.diagnostics).toHaveLength(1);\n });\n\n it('should error when hashedFileNameLength too small', () => {\n userConfig.hashedFileNameLength = 3;\n const validated = validateConfig(userConfig, bootstrapConfig);\n expect(validated.diagnostics).toHaveLength(1);\n });\n\n it('should set from hashedFileNameLength', () => {\n userConfig.hashedFileNameLength = 28;\n const validated = validateConfig(userConfig, bootstrapConfig);\n expect(validated.config.hashedFileNameLength).toBe(28);\n });\n\n it('should set hashedFileNameLength', () => {\n userConfig.hashedFileNameLength = 6;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.hashedFileNameLength).toBe(6);\n });\n\n it('should default hashedFileNameLength', () => {\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.hashedFileNameLength).toBe(8);\n });\n\n it('should default hashFileNames to false in watch mode despite prod mode', () => {\n userConfig.watch = true;\n userConfig.devMode = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.hashFileNames).toBe(true);\n });\n\n it('should default hashFileNames to true in prod mode', () => {\n userConfig.devMode = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.hashFileNames).toBe(true);\n });\n\n it('should default hashFileNames to false in dev mode', () => {\n userConfig.devMode = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.hashFileNames).toBe(false);\n });\n\n it.each([true, false])('should set hashFileNames when hashFileNames===%b', (hashFileNames) => {\n userConfig.hashFileNames = hashFileNames;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.hashFileNames).toBe(hashFileNames);\n });\n\n it('should set hashFileNames from function', () => {\n (userConfig as any).hashFileNames = () => {\n return true;\n };\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.hashFileNames).toBe(true);\n });\n });\n\n describe('minifyJs', () => {\n it('should set minifyJs to true', () => {\n userConfig.devMode = true;\n userConfig.minifyJs = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.minifyJs).toBe(true);\n });\n\n it('should default minifyJs to true in prod mode', () => {\n userConfig.devMode = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.minifyJs).toBe(true);\n });\n\n it('should default minifyJs to false in dev mode', () => {\n userConfig.devMode = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.minifyJs).toBe(false);\n });\n });\n\n describe('minifyCss', () => {\n it('should set minifyCss to true', () => {\n userConfig.devMode = true;\n userConfig.minifyCss = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.minifyCss).toBe(true);\n });\n\n it('should default minifyCss to true in prod mode', () => {\n userConfig.devMode = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.minifyCss).toBe(true);\n });\n\n it('should default minifyCss to false in dev mode', () => {\n userConfig.devMode = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.minifyCss).toBe(false);\n });\n });\n\n it('should default watch to false', () => {\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.watch).toBe(false);\n });\n\n it('should set devMode to false', () => {\n userConfig.devMode = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.devMode).toBe(false);\n });\n\n it('should set devMode to true', () => {\n userConfig.devMode = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.devMode).toBe(true);\n });\n\n it('should default devMode to false', () => {\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.devMode).toBe(false);\n });\n\n it.each([DOCS_JSON, DOCS_CUSTOM, DOCS_README, DOCS_VSCODE])(\n 'should not add \"%s\" output target by default',\n (targetType) => {\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.outputTargets.some((o) => o.type === targetType)).toBe(false);\n },\n );\n\n it('should set devInspector false', () => {\n userConfig.devInspector = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.devInspector).toBe(false);\n });\n\n it('should set devInspector true', () => {\n userConfig.devInspector = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.devInspector).toBe(true);\n });\n\n it('should default devInspector false when devMode is false', () => {\n userConfig.devMode = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.devInspector).toBe(false);\n });\n\n it('should default devInspector true when devMode is true', () => {\n userConfig.devMode = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.devInspector).toBe(true);\n });\n\n it('should default dist false and www true', () => {\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.outputTargets.some((o) => o.type === 'dist')).toBe(false);\n expect(config.outputTargets.some((o) => o.type === 'www')).toBe(true);\n });\n\n it('should error for invalid outputTarget type', () => {\n userConfig.outputTargets = [\n {\n type: 'whatever',\n } as any,\n ];\n const validated = validateConfig(userConfig, bootstrapConfig);\n expect(validated.diagnostics).toHaveLength(1);\n });\n\n it('should default outputTargets with www', () => {\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.outputTargets.some((o) => o.type === 'www')).toBe(true);\n });\n\n it('should set extras defaults', () => {\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.extras.appendChildSlotFix).toBe(false);\n expect(config.extras.cloneNodeFix).toBe(false);\n expect(config.extras.lifecycleDOMEvents).toBe(false);\n expect(config.extras.scriptDataOpts).toBe(false);\n expect(config.extras.slotChildNodesFix).toBe(false);\n expect(config.extras.initializeNextTick).toBe(false);\n expect(config.extras.tagNameTransform).toBe(false);\n expect(config.extras.additionalTagTransformers).toBe(false);\n expect(config.extras.scopedSlotTextContentFix).toBe(false);\n expect(config.extras.addGlobalStyleToComponents).toBe('client');\n expect(config.extras.additionalTagTransformers).toBe(false);\n });\n\n describe('extras.additionalTagTransformers', () => {\n it('set extras.additionalTagTransformers false', () => {\n userConfig.extras = { additionalTagTransformers: false };\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.extras.additionalTagTransformers).toBe(false);\n });\n\n it('set extras.additionalTagTransformers true', () => {\n userConfig.extras = { additionalTagTransformers: true };\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.extras.additionalTagTransformers).toBe(true);\n });\n\n it('set extras.additionalTagTransformers true, dev mode', () => {\n userConfig.devMode = true;\n userConfig.extras = { additionalTagTransformers: true };\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.extras.additionalTagTransformers).toBe(true);\n });\n\n it('prod mode, set extras.additionalTagTransformers', () => {\n userConfig.devMode = false;\n userConfig.extras = { additionalTagTransformers: true };\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.extras.additionalTagTransformers).toBe(true);\n });\n\n it('build extras.additionalTagTransformers when set to \"prod\" and in prod', () => {\n userConfig.devMode = false;\n userConfig.extras = { additionalTagTransformers: 'prod' };\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.extras.additionalTagTransformers).toBe(true);\n });\n\n it('do not build extras.additionalTagTransformers when set to \"prod\" and in dev', () => {\n userConfig.devMode = true;\n userConfig.extras = { additionalTagTransformers: 'prod' };\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.extras.additionalTagTransformers).toBe(false);\n });\n\n it('prod mode default to only modern and not extras.additionalTagTransformers', () => {\n userConfig.devMode = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.extras.additionalTagTransformers).toBe(false);\n });\n });\n\n it('should set slot config based on `experimentalSlotFixes`', () => {\n userConfig.extras = {};\n userConfig.extras.experimentalSlotFixes = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.extras.appendChildSlotFix).toBe(true);\n expect(config.extras.cloneNodeFix).toBe(true);\n expect(config.extras.slotChildNodesFix).toBe(true);\n expect(config.extras.scopedSlotTextContentFix).toBe(true);\n });\n\n it('should override slot fix config based on `experimentalSlotFixes`', () => {\n // This test is to verify the flags get overwritten correctly even if an\n // invalid config is ingested. Hence, the `any` cast\n userConfig.extras = {\n appendChildSlotFix: false,\n slotChildNodesFix: false,\n cloneNodeFix: false,\n scopedSlotTextContentFix: false,\n experimentalSlotFixes: true,\n } as any;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.extras.appendChildSlotFix).toBe(true);\n expect(config.extras.cloneNodeFix).toBe(true);\n expect(config.extras.slotChildNodesFix).toBe(true);\n expect(config.extras.scopedSlotTextContentFix).toBe(true);\n });\n\n it('should set extras experimentalScopedSlotChanges `true` if set in user config', () => {\n userConfig.extras = {\n experimentalScopedSlotChanges: true,\n };\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.extras.experimentalScopedSlotChanges).toBe(true);\n });\n\n it('should set taskQueue \"async\" by default', () => {\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.taskQueue).toBe('async');\n });\n\n it('should set taskQueue', () => {\n userConfig.taskQueue = 'congestionAsync';\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.taskQueue).toBe('congestionAsync');\n });\n\n it('empty watchIgnoredRegex, all valid', () => {\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.watchIgnoredRegex).toEqual([]);\n expect(isWatchIgnorePath(config, '/some/image.gif')).toBe(false);\n expect(isWatchIgnorePath(config, '/some/typescript.ts')).toBe(false);\n });\n\n it('should change a single watchIgnoredRegex to an array', () => {\n userConfig.watchIgnoredRegex = /\\.(gif|jpe?g|png)$/i;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.watchIgnoredRegex).toHaveLength(1);\n expect((config.watchIgnoredRegex as any[])[0]).toEqual(/\\.(gif|jpe?g|png)$/i);\n expect(isWatchIgnorePath(config, '/some/image.gif')).toBe(true);\n expect(isWatchIgnorePath(config, '/some/typescript.ts')).toBe(false);\n });\n\n it('should clean up valid watchIgnoredRegex', () => {\n userConfig.watchIgnoredRegex = [/\\.(gif|jpe?g)$/i, null, 'me-regex' as any, /\\.(png)$/i];\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.watchIgnoredRegex).toHaveLength(2);\n expect((config.watchIgnoredRegex as any[])[0]).toEqual(/\\.(gif|jpe?g)$/i);\n expect((config.watchIgnoredRegex as any[])[1]).toEqual(/\\.(png)$/i);\n expect(isWatchIgnorePath(config, '/some/image.gif')).toBe(true);\n expect(isWatchIgnorePath(config, '/some/image.jpg')).toBe(true);\n expect(isWatchIgnorePath(config, '/some/image.png')).toBe(true);\n expect(isWatchIgnorePath(config, '/some/typescript.ts')).toBe(false);\n });\n\n describe('sourceMap', () => {\n it('sets the field to true when the set to true in the config', () => {\n userConfig.sourceMap = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.sourceMap).toBe(true);\n });\n\n it('sets the field to false when set to false in the config', () => {\n userConfig.sourceMap = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.sourceMap).toBe(false);\n });\n\n it('defaults to \"dev\" behavior when not set (true in dev mode)', () => {\n userConfig.devMode = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.sourceMap).toBe(true);\n });\n\n it('defaults to \"dev\" behavior when not set (false in prod mode)', () => {\n userConfig.devMode = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.sourceMap).toBe(false);\n });\n\n it('sets the field to true when set to \"dev\" and devMode is true', () => {\n userConfig.sourceMap = 'dev';\n userConfig.devMode = true;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.sourceMap).toBe(true);\n });\n\n it('sets the field to false when set to \"dev\" and devMode is false', () => {\n userConfig.sourceMap = 'dev';\n userConfig.devMode = false;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.sourceMap).toBe(false);\n });\n\n it('sets the field to true when set to \"dev\" and --dev flag is passed', () => {\n userConfig.sourceMap = 'dev';\n userConfig.flags = createConfigFlags({ dev: true });\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.sourceMap).toBe(true);\n });\n\n it('sets the field to false when set to \"dev\" and --prod flag is passed', () => {\n userConfig.sourceMap = 'dev';\n userConfig.flags = createConfigFlags({ prod: true });\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.sourceMap).toBe(false);\n });\n });\n\n describe('buildDist', () => {\n it.each([true, false])('should set the field based on the config flag (%p)', (flag) => {\n userConfig.flags = createConfigFlags({ esm: flag });\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.buildDist).toBe(flag);\n });\n\n it.each([true, false])('should fallback to !devMode', (devMode) => {\n userConfig.devMode = devMode;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.buildDist).toBe(!devMode);\n });\n\n it.each([true, false])('should fallback to buildEs5 in devMode', (buildEs5) => {\n userConfig.devMode = true;\n userConfig.buildEs5 = buildEs5;\n const { config } = validateConfig(userConfig, bootstrapConfig);\n expect(config.buildDist).toBe(config.buildEs5);\n });\n });\n\n describe('validatePrimaryPackageOutputTarget', () => {\n it('should default to false', () => {\n const { config } = validateConfig(userConfig, bootstrapConfig);\n\n expect(config.validatePrimaryPackageOutputTarget).toBe(false);\n });\n\n it.each([true, false])(\n 'should set validatePrimaryPackageOutputTarget to %p',\n (validatePrimaryPackageOutputTarget) => {\n userConfig.validatePrimaryPackageOutputTarget = validatePrimaryPackageOutputTarget;\n\n const { config } = validateConfig(userConfig, bootstrapConfig);\n\n expect(config.validatePrimaryPackageOutputTarget).toBe(validatePrimaryPackageOutputTarget);\n },\n );\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-copy.spec.ts",
"content": "import type * as d from '../../../declarations';\nimport { validateCopy } from '../validate-copy';\n\ndescribe('validate-copy', () => {\n describe('validateCopy', () => {\n it.each([false, null, undefined, []])('returns an empty array when the copy task is `%s`', (copyValue) => {\n expect(validateCopy(copyValue, [])).toEqual([]);\n });\n\n it('pushes default tasks not found in the original copy list', () => {\n const defaultCopyTasks: d.CopyTask[] = [\n { src: 'defaultSrc' },\n { src: 'anotherDefaultSrc', dest: 'anotherDefaultDest' },\n ];\n\n expect(validateCopy([], defaultCopyTasks)).toEqual(defaultCopyTasks);\n });\n\n it('combines provided and default tasks', () => {\n const tasksToValidate: d.CopyTask[] = [{ src: 'someSrc', dest: 'someDest', keepDirStructure: true, warn: false }];\n const defaultCopyTasks: d.CopyTask[] = [\n { src: 'defaultSrc' },\n { src: 'anotherDefaultSrc', dest: 'anotherDefaultDest' },\n ];\n\n expect(validateCopy(tasksToValidate, defaultCopyTasks)).toEqual([...tasksToValidate, ...defaultCopyTasks]);\n });\n\n it('prefers provided tasks over default tasks', () => {\n const tasksToValidate: d.CopyTask[] = [\n { src: 'aDuplicateSrc', dest: 'someDest', keepDirStructure: true, warn: false },\n ];\n const defaultCopyTasks: d.CopyTask[] = [\n { src: 'aDuplicateSrc' },\n { src: 'anotherDefaultSrc', dest: 'anotherDefaultDest' },\n ];\n\n // the first task from the default task list is not used\n expect(validateCopy(tasksToValidate, defaultCopyTasks)).toEqual([\n { src: 'aDuplicateSrc', dest: 'someDest', keepDirStructure: true, warn: false },\n { src: 'anotherDefaultSrc', dest: 'anotherDefaultDest' },\n ]);\n });\n\n it('de-duplicates copy tasks', () => {\n const copyTask: d.CopyTask = { src: 'aDuplicateSrc', dest: 'someDest', keepDirStructure: true, warn: false };\n const tasksToValidate: d.CopyTask[] = [{ ...copyTask }, { ...copyTask }];\n\n expect(validateCopy(tasksToValidate, [])).toEqual([{ ...copyTask }]);\n });\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-custom.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\nimport { mockConfig, mockLoadConfigInit } from '@stencil/core/testing';\nimport { buildWarn } from '@utils';\n\nimport { validateConfig } from '../validate-config';\n\ndescribe('validateCustom', () => {\n let userConfig: d.Config;\n\n beforeEach(() => {\n userConfig = mockConfig();\n });\n\n it('should log warning', () => {\n userConfig.outputTargets = [\n {\n type: 'custom',\n name: 'test',\n validate: (_, diagnostics) => {\n const warn = buildWarn(diagnostics);\n warn.messageText = 'test warning';\n },\n generator: async () => {\n return;\n },\n },\n ];\n const { diagnostics } = validateConfig(userConfig, mockLoadConfigInit());\n // TODO(STENCIL-1107): Decrement the right-hand side value from 2 to 1\n expect(diagnostics.length).toBe(2);\n // TODO(STENCIL-1107): Keep this assertion\n expect(diagnostics[0]).toEqual({\n header: 'Build Warn',\n level: 'warn',\n lines: [],\n messageText: 'test warning',\n type: 'build',\n });\n // TODO(STENCIL-1107): Remove this assertion\n expect(diagnostics[1]).toEqual({\n header: 'Build Warn',\n level: 'warn',\n lines: [],\n messageText:\n 'nodeResolve.customResolveOptions is a deprecated option in a Stencil Configuration file. If you need this option, please open a new issue in the Stencil repository (https://github.com/stenciljs/core/issues/new/choose)',\n type: 'build',\n });\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-dev-server.spec.ts",
"content": "import { mockLoadConfigInit } from '@stencil/core/testing';\nimport path from 'path';\n\nimport { ConfigFlags, createConfigFlags } from '../../../cli/config-flags';\nimport type * as d from '../../../declarations';\nimport { normalizePath } from '../../../utils';\nimport { validateConfig } from '../validate-config';\n\ndescribe('validateDevServer', () => {\n const root = path.resolve('/');\n let inputConfig: d.UnvalidatedConfig;\n let inputDevServerConfig: d.DevServerConfig;\n let flags: ConfigFlags;\n\n beforeEach(() => {\n inputDevServerConfig = {};\n flags = createConfigFlags({ serve: true });\n inputConfig = {\n sys: {} as any,\n rootDir: normalizePath(path.join(root, 'some', 'path')),\n devServer: inputDevServerConfig,\n flags,\n namespace: 'Testing',\n };\n });\n\n it('should default address', () => {\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.address).toBe('0.0.0.0');\n });\n\n it.each(['https://localhost', 'http://localhost', 'https://localhost/', 'http://localhost/', 'localhost/'])(\n 'should remove extraneous stuff from address %p',\n (address) => {\n inputConfig.devServer = { ...inputDevServerConfig, address };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.address).toBe('localhost');\n },\n );\n\n it('should set address', () => {\n inputConfig.devServer = { ...inputDevServerConfig, address: '123.123.123.123' };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.address).toBe('123.123.123.123');\n });\n\n it('should set address from flags', () => {\n inputConfig.flags = { ...flags, address: '123.123.123.123' };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.address).toBe('123.123.123.123');\n });\n\n it('should get custom baseUrl', () => {\n inputConfig.outputTargets = [\n {\n type: 'www',\n baseUrl: '/my-base-url',\n } as d.OutputTargetWww,\n ];\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.basePath).toBe('/my-base-url/');\n });\n\n it('should get custom baseUrl with domain', () => {\n inputConfig.outputTargets = [\n {\n type: 'www',\n baseUrl: 'http://stenciljs.com/my-base-url',\n } as d.OutputTargetWww,\n ];\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.basePath).toBe('/my-base-url/');\n });\n\n it('should default basePath', () => {\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.basePath).toBe('/');\n });\n\n it('should default root', () => {\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.root).toBe(normalizePath(path.join(root, 'some', 'path', 'www')));\n });\n\n it('should set relative root', () => {\n inputConfig.devServer = { ...inputDevServerConfig, root: 'my-rel-root' };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.root).toBe(normalizePath(path.join(root, 'some', 'path', 'my-rel-root')));\n });\n\n it('should set absolute root', () => {\n inputConfig.devServer = {\n ...inputDevServerConfig,\n root: normalizePath(path.join(root, 'some', 'path', 'my-abs-root')),\n };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.root).toBe(normalizePath(path.join(root, 'some', 'path', 'my-abs-root')));\n });\n\n it('should default gzip', () => {\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.gzip).toBe(true);\n });\n\n it('should set gzip', () => {\n inputConfig.devServer = { ...inputDevServerConfig, gzip: false };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.gzip).toBe(false);\n });\n\n it.each(['localhost', '192.12.12.10', '127.0.0.1'])('should default port with address %p', () => {\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.port).toBe(3333);\n });\n\n it.each(['https://subdomain.stenciljs.com:3000', 'localhost:3000/', 'localhost:3000'])(\n 'should override port in address with port property',\n (address) => {\n inputConfig.devServer = { ...inputDevServerConfig, address, port: 1234 };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.port).toBe(1234);\n },\n );\n\n it('should not set default port if null', () => {\n // we intentionally set the value to `null` for the purposes of this test, hence the type assertion\n inputConfig.devServer = { ...inputDevServerConfig, port: null as unknown as number };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.port).toBe(null);\n });\n\n it('sets the port to 3333 if the port is undefined', () => {\n inputConfig.devServer = { ...inputDevServerConfig, port: undefined };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.port).toBe(3333);\n });\n\n it.each(['localhost:20/', 'localhost:20'])('should set port from address %p if no port prop', (address) => {\n inputConfig.devServer = { ...inputDevServerConfig, address };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.port).toBe(20);\n expect(config.devServer.address).toBe('localhost');\n });\n\n it('should set address, port null, protocol', () => {\n inputConfig.devServer = { ...inputDevServerConfig, address: 'https://subdomain.stenciljs.com/' };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.port).toBe(undefined);\n expect(config.devServer.address).toBe('subdomain.stenciljs.com');\n expect(config.devServer.protocol).toBe('https');\n });\n\n it('should set port', () => {\n inputConfig.devServer = { ...inputDevServerConfig, port: 4444 };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.port).toBe(4444);\n });\n\n it('should set port from flags', () => {\n inputConfig.flags = { ...flags, port: 4444 };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.port).toBe(4444);\n });\n\n it('should default strictPort to false', () => {\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.strictPort).toBe(false);\n });\n\n it('should set strictPort to true', () => {\n inputConfig.devServer = { ...inputDevServerConfig, strictPort: true };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.strictPort).toBe(true);\n });\n\n it('should set strictPort to false', () => {\n inputConfig.devServer = { ...inputDevServerConfig, strictPort: false };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.strictPort).toBe(false);\n });\n\n it('should default historyApiFallback', () => {\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.historyApiFallback).toBeDefined();\n expect(config.devServer.historyApiFallback!.index).toBe('index.html');\n });\n\n it.each([1, []])('should default historyApiFallback when an invalid value (%s) is provided', (badValue) => {\n // this test explicitly checks for a bad value in the stencil.config file, hence the type assertion\n inputConfig.devServer = { ...inputDevServerConfig, historyApiFallback: badValue as any };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.historyApiFallback).toBeDefined();\n expect(config.devServer.historyApiFallback!.index).toBe('index.html');\n });\n\n it('should set historyApiFallback', () => {\n inputConfig.devServer = { ...inputDevServerConfig, historyApiFallback: {} };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.historyApiFallback).toBeDefined();\n expect(config.devServer.historyApiFallback!.index).toBe('index.html');\n });\n\n it('should sets the historyApiFallback when undefined is provided', () => {\n inputConfig.devServer = { ...inputDevServerConfig, historyApiFallback: undefined };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.historyApiFallback).toBeDefined();\n expect(config.devServer.historyApiFallback!.disableDotRule).toBe(false);\n expect(config.devServer.historyApiFallback!.index).toBe('index.html');\n });\n\n it('should disable historyApiFallback', () => {\n // we intentionally set the value to `null` for the purposes of this test, hence the type assertion\n inputConfig.devServer = { ...inputDevServerConfig, historyApiFallback: null as unknown as d.HistoryApiFallback };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.historyApiFallback).toBe(null);\n });\n\n it('should default reloadStrategy hmr', () => {\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.reloadStrategy).toBe('hmr');\n });\n\n it('should set reloadStrategy pageReload', () => {\n inputConfig.devServer = { ...inputDevServerConfig, reloadStrategy: 'pageReload' };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.reloadStrategy).toBe('pageReload');\n });\n\n it('should default openBrowser', () => {\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.openBrowser).toBe(true);\n });\n\n it('should set openBrowser', () => {\n inputConfig.devServer = { ...inputDevServerConfig, openBrowser: false };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.openBrowser).toBe(false);\n });\n\n it('should set openBrowser from flag', () => {\n // the flags field should have been set up in the `beforeEach` block for this test, hence the bang operator\n inputConfig.flags!.open = false;\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.openBrowser).toBe(false);\n });\n\n it('should default http protocol', () => {\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.protocol).toBe('http');\n });\n\n it('should set https protocol if credentials are set', () => {\n inputConfig.devServer = { ...inputDevServerConfig, https: { key: 'fake-key', cert: 'fake-cert' } };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.protocol).toBe('https');\n });\n\n it('should set ssr true', () => {\n inputConfig.devServer = { ssr: true };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.ssr).toBe(true);\n });\n\n it('should set ssr false', () => {\n inputConfig.devServer = { ssr: false };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.ssr).toBe(false);\n });\n\n it('should set ssr from flag', () => {\n inputConfig.flags = { ...flags, ssr: true };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.ssr).toBe(true);\n });\n\n it('should set ssr false by default', () => {\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.ssr).toBe(false);\n });\n\n it('should set default srcIndexHtml from config', () => {\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.srcIndexHtml).toBe(normalizePath(path.join(root, 'some', 'path', 'src', 'index.html')));\n });\n\n it('should set srcIndexHtml from config', () => {\n const wwwOutputTarget: d.OutputTargetWww = {\n type: 'www',\n prerenderConfig: normalizePath(path.join(root, 'some', 'path', 'prerender.config.ts')),\n };\n inputConfig.outputTargets = [wwwOutputTarget];\n inputConfig.flags = { ...flags, ssr: true };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.prerenderConfig).toBe(wwwOutputTarget.prerenderConfig);\n });\n\n describe('pingRoute', () => {\n it('should default to /ping', () => {\n // Ensure the pingRoute is not set in the inputConfig so we know we're testing the\n // default value added during validation\n delete inputConfig.devServer.pingRoute;\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.pingRoute).toBe('/ping');\n });\n\n it('should set user defined pingRoute', () => {\n inputConfig.devServer = { ...inputDevServerConfig, pingRoute: '/my-ping' };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.pingRoute).toBe('/my-ping');\n });\n\n it('should prefix pingRoute with a \"/\"', () => {\n inputConfig.devServer = { ...inputDevServerConfig, pingRoute: 'my-ping' };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.pingRoute).toBe('/my-ping');\n });\n\n it('should clear ping route if set to null', () => {\n inputConfig.devServer = { ...inputDevServerConfig, pingRoute: null };\n const { config } = validateConfig(inputConfig, mockLoadConfigInit());\n expect(config.devServer.pingRoute).toBe(null);\n });\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-docs.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\nimport { mockConfig, mockLoadConfigInit } from '@stencil/core/testing';\n\nimport { DEFAULT_TARGET_COMPONENT_STYLES } from '../constants';\nimport { validateConfig } from '../validate-config';\n\ndescribe('validateDocs', () => {\n let userConfig: d.Config;\n\n beforeEach(() => {\n userConfig = mockConfig();\n });\n\n it('readme docs dir', () => {\n // the flags field is expected to have been set by the mock creation function for unvalidated configs, hence the\n // bang operator\n userConfig.flags!.docs = true;\n userConfig.outputTargets = [\n {\n type: 'docs-readme',\n dir: 'my-dir',\n } as d.OutputTargetDocsReadme,\n ];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const o = config.outputTargets.find((o) => o.type === 'docs-readme') as d.OutputTargetDocsReadme;\n expect(o.dir).toContain('my-dir');\n });\n\n it('default no docs, not remove docs output target', () => {\n userConfig.outputTargets = [{ type: 'docs-readme' }];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets.some((o) => o.type === 'docs-readme')).toBe(true);\n });\n\n it('default no docs, no output target', () => {\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets.some((o) => o.type === 'docs-readme')).toBe(false);\n });\n\n it('should use default values for docs.markdown.targetComponent', () => {\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.docs.markdown.targetComponent.background).toBe(DEFAULT_TARGET_COMPONENT_STYLES.background);\n });\n\n it('should use user values for docs.markdown.targetComponent.background', () => {\n userConfig = mockConfig({\n docs: {\n markdown: {\n targetComponent: {\n background: '#123',\n },\n },\n },\n });\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.docs.markdown.targetComponent.background).toBe(userConfig.docs.markdown.targetComponent.background);\n });\n\n it('should use user values for docs.markdown.targetComponent.textColor', () => {\n userConfig = mockConfig({\n docs: {\n markdown: {\n targetComponent: {\n textColor: '#123',\n },\n },\n },\n });\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.docs.markdown.targetComponent.textColor).toBe(userConfig.docs.markdown.targetComponent.textColor);\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-hydrated.spec.ts",
"content": "import * as d from '@stencil/core/declarations';\n\nimport { validateHydrated } from '../validate-hydrated';\n\ndescribe('validate-hydrated', () => {\n describe('validateHydrated', () => {\n let inputConfig: d.UnvalidatedConfig;\n let inputHydrateFlagConfig: d.HydratedFlag;\n\n beforeEach(() => {\n inputHydrateFlagConfig = {};\n inputConfig = {\n hydratedFlag: inputHydrateFlagConfig,\n };\n });\n\n it.each([null, false])('returns undefined for hydratedFlag=%s', (badValue) => {\n // this test explicitly checks for a bad value in the stencil.config file, hence the type assertion\n (inputConfig.hydratedFlag as any) = badValue;\n const actual = validateHydrated(inputConfig);\n expect(actual).toBeNull();\n });\n\n it.each([[], true])('returns a default value when hydratedFlag=%s', (badValue) => {\n // this test explicitly checks for a bad value in the stencil.config file, hence the type assertion\n (inputConfig.hydratedFlag as any) = badValue;\n const actual = validateHydrated(inputConfig);\n expect(actual).toEqual({\n hydratedValue: 'inherit',\n initialValue: 'hidden',\n name: 'hydrated',\n property: 'visibility',\n selector: 'class',\n });\n });\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-namespace.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\n\nimport { validateNamespace } from '../validate-namespace';\n\n// TODO(STENCIL-968): Update tests to check diagnostic messages\ndescribe('validateNamespace', () => {\n const diagnostics: d.Diagnostic[] = [];\n\n beforeEach(() => {\n diagnostics.length = 0;\n });\n\n it('should not allow special characters in namespace', () => {\n validateNamespace('My/Namespace', undefined, diagnostics);\n expect(diagnostics).toHaveLength(1);\n\n diagnostics.length = 0;\n validateNamespace('My%20Namespace', undefined, diagnostics);\n expect(diagnostics).toHaveLength(1);\n\n diagnostics.length = 0;\n validateNamespace('My:Namespace', undefined, diagnostics);\n expect(diagnostics).toHaveLength(1);\n });\n\n it('should not allow spaces in namespace', () => {\n validateNamespace('My Namespace', undefined, diagnostics);\n expect(diagnostics).toHaveLength(1);\n });\n\n it('should not allow dash for last character of namespace', () => {\n validateNamespace('MyNamespace-', undefined, diagnostics);\n expect(diagnostics).toHaveLength(1);\n });\n\n it('should not allow dash for first character of namespace', () => {\n validateNamespace('-MyNamespace', undefined, diagnostics);\n expect(diagnostics).toHaveLength(1);\n });\n\n it('should not allow number for first character of namespace', () => {\n validateNamespace('88MyNamespace', undefined, diagnostics);\n expect(diagnostics).toHaveLength(1);\n });\n\n it('should enforce namespace being at least 3 characters', () => {\n validateNamespace('ab', undefined, diagnostics);\n expect(diagnostics).toHaveLength(1);\n });\n\n it('should allow $ in the namespace', () => {\n const { namespace, fsNamespace } = validateNamespace('$MyNamespace', undefined, diagnostics);\n expect(namespace).toBe('$MyNamespace');\n expect(fsNamespace).toBe('$mynamespace');\n });\n\n it('should allow underscore in the namespace', () => {\n const { namespace, fsNamespace } = validateNamespace('My_Namespace', undefined, diagnostics);\n expect(namespace).toBe('My_Namespace');\n expect(fsNamespace).toBe('my_namespace');\n });\n\n it('should allow dash in the namespace', () => {\n const { namespace, fsNamespace } = validateNamespace('My-Namespace', undefined, diagnostics);\n expect(namespace).toBe('MyNamespace');\n expect(fsNamespace).toBe('my-namespace');\n });\n\n it('should set user namespace', () => {\n const { namespace, fsNamespace } = validateNamespace('MyNamespace', undefined, diagnostics);\n expect(namespace).toBe('MyNamespace');\n expect(fsNamespace).toBe('mynamespace');\n });\n\n it('should set default namespace', () => {\n const { namespace, fsNamespace } = validateNamespace(undefined, undefined, diagnostics);\n expect(namespace).toBe('App');\n expect(fsNamespace).toBe('app');\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-output-dist-collection.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\nimport { mockConfig, mockLoadConfigInit } from '@stencil/core/testing';\nimport { join, resolve } from '@utils';\n\nimport { validateConfig } from '../validate-config';\n\ndescribe('validateDistCollectionOutputTarget', () => {\n let config: d.Config;\n\n const rootDir = resolve('/');\n const defaultDir = join(rootDir, 'dist', 'collection');\n\n beforeEach(() => {\n config = mockConfig();\n });\n\n it('sets correct default values', () => {\n const target: d.OutputTargetDistCollection = {\n type: 'dist-collection',\n empty: false,\n dir: null,\n collectionDir: null,\n };\n config.outputTargets = [target];\n\n const { config: validatedConfig } = validateConfig(config, mockLoadConfigInit());\n\n expect(validatedConfig.outputTargets).toEqual([\n {\n type: 'dist-collection',\n empty: false,\n dir: defaultDir,\n collectionDir: null,\n transformAliasedImportPaths: true,\n },\n ]);\n });\n\n it('sets specified directory', () => {\n const target: d.OutputTargetDistCollection = {\n type: 'dist-collection',\n empty: false,\n dir: '/my-dist',\n collectionDir: null,\n };\n config.outputTargets = [target];\n\n const { config: validatedConfig } = validateConfig(config, mockLoadConfigInit());\n\n expect(validatedConfig.outputTargets).toEqual([\n {\n type: 'dist-collection',\n empty: false,\n dir: '/my-dist',\n collectionDir: null,\n transformAliasedImportPaths: true,\n },\n ]);\n });\n\n describe('transformAliasedImportPaths', () => {\n it.each([false, true])(\n \"sets option '%s' when explicitly '%s' in config\",\n (transformAliasedImportPaths: boolean) => {\n const target: d.OutputTargetDistCollection = {\n type: 'dist-collection',\n empty: false,\n dir: null,\n collectionDir: null,\n transformAliasedImportPaths,\n };\n config.outputTargets = [target];\n\n const { config: validatedConfig } = validateConfig(config, mockLoadConfigInit());\n\n expect(validatedConfig.outputTargets).toEqual([\n {\n type: 'dist-collection',\n empty: false,\n dir: defaultDir,\n collectionDir: null,\n transformAliasedImportPaths,\n },\n ]);\n },\n );\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-output-dist-custom-element.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\nimport { mockConfig, mockLoadConfigInit } from '@stencil/core/testing';\nimport { COPY, DIST_CUSTOM_ELEMENTS, DIST_TYPES, join } from '@utils';\nimport path from 'path';\n\nimport { validateConfig } from '../validate-config';\n\ndescribe('validate-output-dist-custom-element', () => {\n describe('validateCustomElement', () => {\n // use Node's resolve() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on)\n const rootDir = path.resolve('/');\n const defaultDistDir = join(rootDir, 'dist', 'components');\n const distCustomElementsDir = 'my-dist-custom-elements';\n let userConfig: d.Config;\n\n beforeEach(() => {\n userConfig = mockConfig();\n });\n\n it('generates a default dist-custom-elements output target', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toEqual([\n {\n type: DIST_TYPES,\n dir: defaultDistDir,\n typesDir: join(rootDir, 'dist', 'types'),\n },\n {\n type: DIST_CUSTOM_ELEMENTS,\n copy: [],\n dir: defaultDistDir,\n empty: true,\n externalRuntime: true,\n generateTypeDeclarations: true,\n customElementsExportBehavior: 'default',\n },\n ]);\n });\n\n it('uses a provided export behavior over the default value', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n customElementsExportBehavior: 'single-export-module',\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toEqual([\n {\n type: DIST_TYPES,\n dir: defaultDistDir,\n typesDir: join(rootDir, 'dist', 'types'),\n },\n {\n type: DIST_CUSTOM_ELEMENTS,\n copy: [],\n dir: defaultDistDir,\n empty: true,\n externalRuntime: true,\n generateTypeDeclarations: true,\n customElementsExportBehavior: 'single-export-module',\n },\n ]);\n });\n\n it('uses the default export behavior if the specified value is invalid', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n customElementsExportBehavior: 'not-a-valid-option' as d.CustomElementsExportBehavior,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toEqual([\n {\n type: DIST_TYPES,\n dir: defaultDistDir,\n typesDir: join(rootDir, 'dist', 'types'),\n },\n {\n type: DIST_CUSTOM_ELEMENTS,\n copy: [],\n dir: defaultDistDir,\n empty: true,\n externalRuntime: true,\n generateTypeDeclarations: true,\n customElementsExportBehavior: 'default',\n },\n ]);\n });\n\n it('uses a provided dir field over a default directory', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n dir: distCustomElementsDir,\n generateTypeDeclarations: false,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toEqual([\n {\n type: DIST_CUSTOM_ELEMENTS,\n copy: [],\n dir: join(rootDir, distCustomElementsDir),\n empty: true,\n externalRuntime: true,\n generateTypeDeclarations: false,\n customElementsExportBehavior: 'default',\n },\n ]);\n });\n\n describe('\"empty\" field', () => {\n it('defaults the \"empty\" field to true if not provided', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n externalRuntime: false,\n generateTypeDeclarations: false,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toEqual([\n {\n type: DIST_CUSTOM_ELEMENTS,\n copy: [],\n dir: defaultDistDir,\n empty: true,\n externalRuntime: false,\n generateTypeDeclarations: false,\n customElementsExportBehavior: 'default',\n },\n ]);\n });\n\n it('defaults the \"empty\" field to true it\\'s not a boolean', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n empty: undefined,\n externalRuntime: false,\n generateTypeDeclarations: false,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toEqual([\n {\n type: DIST_CUSTOM_ELEMENTS,\n copy: [],\n dir: defaultDistDir,\n empty: true,\n externalRuntime: false,\n generateTypeDeclarations: false,\n customElementsExportBehavior: 'default',\n },\n ]);\n });\n });\n\n describe('\"externalRuntime\" field', () => {\n it('defaults the \"externalRuntime\" field to true if not provided', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n empty: false,\n generateTypeDeclarations: false,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toEqual([\n {\n type: DIST_CUSTOM_ELEMENTS,\n copy: [],\n dir: defaultDistDir,\n empty: false,\n externalRuntime: true,\n generateTypeDeclarations: false,\n customElementsExportBehavior: 'default',\n },\n ]);\n });\n\n it('defaults the \"externalRuntime\" field to true it\\'s not a boolean', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n empty: false,\n externalRuntime: undefined,\n generateTypeDeclarations: false,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toEqual([\n {\n type: DIST_CUSTOM_ELEMENTS,\n copy: [],\n dir: defaultDistDir,\n empty: false,\n externalRuntime: true,\n generateTypeDeclarations: false,\n customElementsExportBehavior: 'default',\n },\n ]);\n });\n });\n\n describe('\"generateTypeDeclarations\" field', () => {\n it('defaults the \"generateTypeDeclarations\" field to true if not provided', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n empty: false,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toEqual([\n {\n type: DIST_TYPES,\n dir: defaultDistDir,\n typesDir: join(rootDir, 'dist', 'types'),\n },\n {\n type: DIST_CUSTOM_ELEMENTS,\n copy: [],\n dir: defaultDistDir,\n empty: false,\n externalRuntime: true,\n generateTypeDeclarations: true,\n customElementsExportBehavior: 'default',\n },\n ]);\n });\n\n it('defaults the \"generateTypeDeclarations\" field to true it\\'s not a boolean', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n empty: false,\n generateTypeDeclarations: undefined,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toEqual([\n {\n type: DIST_TYPES,\n dir: defaultDistDir,\n typesDir: join(rootDir, 'dist', 'types'),\n },\n {\n type: DIST_CUSTOM_ELEMENTS,\n copy: [],\n dir: defaultDistDir,\n empty: false,\n externalRuntime: true,\n generateTypeDeclarations: true,\n customElementsExportBehavior: 'default',\n },\n ]);\n });\n\n it('creates a types directory when \"generateTypeDeclarations\" is true', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n empty: false,\n externalRuntime: false,\n generateTypeDeclarations: true,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toEqual([\n {\n type: DIST_TYPES,\n dir: defaultDistDir,\n typesDir: join(rootDir, 'dist', 'types'),\n },\n {\n type: DIST_CUSTOM_ELEMENTS,\n copy: [],\n dir: defaultDistDir,\n empty: false,\n externalRuntime: false,\n generateTypeDeclarations: true,\n customElementsExportBehavior: 'default',\n },\n ]);\n });\n\n it('creates a types directory for a custom directory', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n dir: distCustomElementsDir,\n empty: false,\n externalRuntime: false,\n generateTypeDeclarations: true,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toEqual([\n {\n type: DIST_TYPES,\n dir: join(rootDir, distCustomElementsDir),\n typesDir: join(rootDir, 'dist', 'types'),\n },\n {\n type: DIST_CUSTOM_ELEMENTS,\n copy: [],\n dir: join(rootDir, distCustomElementsDir),\n empty: false,\n externalRuntime: false,\n generateTypeDeclarations: true,\n customElementsExportBehavior: 'default',\n },\n ]);\n });\n\n it('doesn\\'t create a types directory when \"generateTypeDeclarations\" is false', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n empty: false,\n externalRuntime: false,\n generateTypeDeclarations: false,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toEqual([\n {\n type: DIST_CUSTOM_ELEMENTS,\n copy: [],\n dir: defaultDistDir,\n empty: false,\n externalRuntime: false,\n generateTypeDeclarations: false,\n customElementsExportBehavior: 'default',\n },\n ]);\n });\n });\n\n describe('copy tasks', () => {\n it('copies existing copy tasks over to the output target', () => {\n const copyOutputTarget: d.CopyTask = {\n src: 'mock/src',\n dest: 'mock/dest',\n };\n const copyOutputTarget2: d.CopyTask = {\n src: 'mock/src2',\n dest: 'mock/dest2',\n };\n\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n copy: [copyOutputTarget, copyOutputTarget2],\n dir: distCustomElementsDir,\n empty: false,\n externalRuntime: false,\n generateTypeDeclarations: false,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toEqual([\n {\n type: COPY,\n dir: rootDir,\n copy: [copyOutputTarget, copyOutputTarget2],\n },\n {\n type: DIST_CUSTOM_ELEMENTS,\n copy: [copyOutputTarget, copyOutputTarget2],\n dir: join(rootDir, distCustomElementsDir),\n empty: false,\n externalRuntime: false,\n generateTypeDeclarations: false,\n customElementsExportBehavior: 'default',\n },\n ]);\n });\n });\n\n describe('\"autoLoader\" field', () => {\n it('normalizes autoLoader: true to an object with defaults', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n autoLoader: true,\n generateTypeDeclarations: false,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const distCustomElementsTarget = config.outputTargets.find(\n (o) => o.type === DIST_CUSTOM_ELEMENTS,\n ) as d.OutputTargetDistCustomElements;\n\n expect(distCustomElementsTarget.autoLoader).toEqual({\n fileName: 'loader',\n autoStart: true,\n });\n });\n\n it('normalizes autoLoader object with partial options', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n autoLoader: { fileName: 'my-loader' },\n generateTypeDeclarations: false,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const distCustomElementsTarget = config.outputTargets.find(\n (o) => o.type === DIST_CUSTOM_ELEMENTS,\n ) as d.OutputTargetDistCustomElements;\n\n expect(distCustomElementsTarget.autoLoader).toEqual({\n fileName: 'my-loader',\n autoStart: true,\n });\n });\n\n it('normalizes autoLoader object with autoStart: false', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n autoLoader: { autoStart: false },\n generateTypeDeclarations: false,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const distCustomElementsTarget = config.outputTargets.find(\n (o) => o.type === DIST_CUSTOM_ELEMENTS,\n ) as d.OutputTargetDistCustomElements;\n\n expect(distCustomElementsTarget.autoLoader).toEqual({\n fileName: 'loader',\n autoStart: false,\n });\n });\n\n it('does not set autoLoader when not provided', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n generateTypeDeclarations: false,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const distCustomElementsTarget = config.outputTargets.find(\n (o) => o.type === DIST_CUSTOM_ELEMENTS,\n ) as d.OutputTargetDistCustomElements;\n\n expect(distCustomElementsTarget.autoLoader).toBeUndefined();\n });\n\n it('does not set autoLoader when explicitly false', () => {\n const outputTarget: d.OutputTargetDistCustomElements = {\n type: DIST_CUSTOM_ELEMENTS,\n autoLoader: false,\n generateTypeDeclarations: false,\n };\n userConfig.outputTargets = [outputTarget];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const distCustomElementsTarget = config.outputTargets.find(\n (o) => o.type === DIST_CUSTOM_ELEMENTS,\n ) as d.OutputTargetDistCustomElements;\n\n expect(distCustomElementsTarget.autoLoader).toBe(false);\n });\n });\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-output-dist.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\nimport { mockConfig, mockLoadConfigInit } from '@stencil/core/testing';\nimport { join } from '@utils';\nimport path from 'path';\n\nimport { validateConfig } from '../validate-config';\n\ndescribe('validateDistOutputTarget', () => {\n // use Node's resolve() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on)\n const rootDir = path.resolve('/');\n\n let userConfig: d.Config;\n beforeEach(() => {\n userConfig = mockConfig({ fsNamespace: 'testing' });\n });\n\n it('should set dist values', () => {\n const outputTarget: d.OutputTargetDist = {\n type: 'dist',\n dir: 'my-dist',\n buildDir: 'my-build',\n empty: false,\n };\n userConfig.outputTargets = [outputTarget];\n userConfig.buildDist = true;\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toEqual([\n {\n buildDir: join(rootDir, 'my-dist', 'my-build'),\n collectionDir: join(rootDir, 'my-dist', 'collection'),\n copy: [],\n dir: join(rootDir, 'my-dist'),\n empty: false,\n esmLoaderPath: join(rootDir, 'my-dist', 'loader'),\n type: 'dist',\n polyfills: false,\n typesDir: join(rootDir, 'my-dist', 'types'),\n transformAliasedImportPathsInCollection: true,\n isPrimaryPackageOutputTarget: false,\n },\n {\n esmDir: join(rootDir, 'my-dist', 'my-build', 'testing'),\n empty: false,\n isBrowserBuild: true,\n legacyLoaderFile: join(rootDir, 'my-dist', 'my-build', 'testing.js'),\n polyfills: true,\n systemDir: undefined,\n systemLoaderFile: undefined,\n type: 'dist-lazy',\n },\n {\n copyAssets: 'dist',\n copy: [],\n dir: join(rootDir, 'my-dist', 'my-build', 'testing'),\n type: 'copy',\n },\n {\n file: join(rootDir, 'my-dist', 'my-build', 'testing', 'testing.css'),\n type: 'dist-global-styles',\n },\n {\n dir: join(rootDir, 'my-dist'),\n type: 'dist-types',\n typesDir: join(rootDir, 'my-dist', 'types'),\n },\n {\n collectionDir: join(rootDir, 'my-dist', 'collection'),\n dir: join(rootDir, '/my-dist'),\n empty: false,\n transformAliasedImportPaths: true,\n type: 'dist-collection',\n },\n {\n copy: [{ src: '**/*.svg' }, { src: '**/*.js' }],\n copyAssets: 'collection',\n dir: join(rootDir, 'my-dist', 'collection'),\n type: 'copy',\n },\n {\n type: 'dist-lazy',\n cjsDir: join(rootDir, 'my-dist', 'cjs'),\n cjsIndexFile: join(rootDir, 'my-dist', 'index.cjs.js'),\n empty: false,\n esmDir: join(rootDir, 'my-dist', 'esm'),\n esmEs5Dir: undefined,\n esmIndexFile: join(rootDir, 'my-dist', 'index.js'),\n polyfills: true,\n },\n {\n cjsDir: join(rootDir, 'my-dist', 'cjs'),\n componentDts: join(rootDir, 'my-dist', 'types', 'components.d.ts'),\n dir: join(rootDir, 'my-dist', 'loader'),\n empty: false,\n esmDir: join(rootDir, 'my-dist', 'esm'),\n esmEs5Dir: undefined,\n type: 'dist-lazy-loader',\n },\n ]);\n });\n\n it('should set defaults when outputTargets dist is empty', () => {\n userConfig.outputTargets = [{ type: 'dist' }];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const outputTarget = config.outputTargets.find((o) => o.type === 'dist') as d.OutputTargetDist;\n expect(outputTarget).toBeDefined();\n expect(outputTarget.dir).toBe(join(rootDir, 'dist'));\n expect(outputTarget.buildDir).toBe(join(rootDir, '/dist'));\n expect(outputTarget.empty).toBe(true);\n });\n\n it('should default to not add dist when outputTargets exists, but without dist', () => {\n userConfig.outputTargets = [];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets.some((o) => o.type === 'dist')).toBe(false);\n });\n\n it('sets option to transform aliased import paths when enabled', () => {\n const outputTarget: d.OutputTargetDist = {\n type: 'dist',\n dir: 'my-dist',\n buildDir: 'my-build',\n empty: false,\n transformAliasedImportPathsInCollection: true,\n };\n userConfig.outputTargets = [outputTarget];\n userConfig.buildDist = true;\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.outputTargets).toEqual([\n {\n buildDir: join(rootDir, 'my-dist', 'my-build'),\n collectionDir: join(rootDir, 'my-dist', 'collection'),\n copy: [],\n dir: join(rootDir, 'my-dist'),\n empty: false,\n esmLoaderPath: join(rootDir, 'my-dist', 'loader'),\n type: 'dist',\n polyfills: false,\n typesDir: join(rootDir, 'my-dist', 'types'),\n transformAliasedImportPathsInCollection: true,\n isPrimaryPackageOutputTarget: false,\n },\n {\n esmDir: join(rootDir, 'my-dist', 'my-build', 'testing'),\n empty: false,\n isBrowserBuild: true,\n legacyLoaderFile: join(rootDir, 'my-dist', 'my-build', 'testing.js'),\n polyfills: true,\n systemDir: undefined,\n systemLoaderFile: undefined,\n type: 'dist-lazy',\n },\n {\n copyAssets: 'dist',\n copy: [],\n dir: join(rootDir, 'my-dist', 'my-build', 'testing'),\n type: 'copy',\n },\n {\n file: join(rootDir, 'my-dist', 'my-build', 'testing', 'testing.css'),\n type: 'dist-global-styles',\n },\n {\n dir: join(rootDir, 'my-dist'),\n type: 'dist-types',\n typesDir: join(rootDir, 'my-dist', 'types'),\n },\n {\n collectionDir: join(rootDir, 'my-dist', 'collection'),\n dir: join(rootDir, '/my-dist'),\n empty: false,\n transformAliasedImportPaths: true,\n type: 'dist-collection',\n },\n {\n copy: [{ src: '**/*.svg' }, { src: '**/*.js' }],\n copyAssets: 'collection',\n dir: join(rootDir, 'my-dist', 'collection'),\n type: 'copy',\n },\n {\n type: 'dist-lazy',\n cjsDir: join(rootDir, 'my-dist', 'cjs'),\n cjsIndexFile: join(rootDir, 'my-dist', 'index.cjs.js'),\n empty: false,\n esmDir: join(rootDir, 'my-dist', 'esm'),\n esmEs5Dir: undefined,\n esmIndexFile: join(rootDir, 'my-dist', 'index.js'),\n polyfills: true,\n },\n {\n cjsDir: join(rootDir, 'my-dist', 'cjs'),\n componentDts: join(rootDir, 'my-dist', 'types', 'components.d.ts'),\n dir: join(rootDir, 'my-dist', 'loader'),\n empty: false,\n esmDir: join(rootDir, 'my-dist', 'esm'),\n esmEs5Dir: undefined,\n type: 'dist-lazy-loader',\n },\n ]);\n });\n\n it('sets option to validate primary package output target when enabled', () => {\n const outputTarget: d.OutputTargetDist = {\n type: 'dist',\n dir: 'my-dist',\n buildDir: 'my-build',\n empty: false,\n isPrimaryPackageOutputTarget: true,\n };\n userConfig.outputTargets = [outputTarget];\n userConfig.buildDist = true;\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.outputTargets).toEqual([\n {\n buildDir: join(rootDir, 'my-dist', 'my-build'),\n collectionDir: join(rootDir, 'my-dist', 'collection'),\n copy: [],\n dir: join(rootDir, 'my-dist'),\n empty: false,\n esmLoaderPath: join(rootDir, 'my-dist', 'loader'),\n type: 'dist',\n polyfills: false,\n typesDir: join(rootDir, 'my-dist', 'types'),\n transformAliasedImportPathsInCollection: true,\n isPrimaryPackageOutputTarget: true,\n },\n {\n esmDir: join(rootDir, 'my-dist', 'my-build', 'testing'),\n empty: false,\n isBrowserBuild: true,\n legacyLoaderFile: join(rootDir, 'my-dist', 'my-build', 'testing.js'),\n polyfills: true,\n systemDir: undefined,\n systemLoaderFile: undefined,\n type: 'dist-lazy',\n },\n {\n copyAssets: 'dist',\n copy: [],\n dir: join(rootDir, 'my-dist', 'my-build', 'testing'),\n type: 'copy',\n },\n {\n file: join(rootDir, 'my-dist', 'my-build', 'testing', 'testing.css'),\n type: 'dist-global-styles',\n },\n {\n dir: join(rootDir, 'my-dist'),\n type: 'dist-types',\n typesDir: join(rootDir, 'my-dist', 'types'),\n },\n {\n collectionDir: join(rootDir, 'my-dist', 'collection'),\n dir: join(rootDir, '/my-dist'),\n empty: false,\n transformAliasedImportPaths: true,\n type: 'dist-collection',\n },\n {\n copy: [{ src: '**/*.svg' }, { src: '**/*.js' }],\n copyAssets: 'collection',\n dir: join(rootDir, 'my-dist', 'collection'),\n type: 'copy',\n },\n {\n type: 'dist-lazy',\n cjsDir: join(rootDir, 'my-dist', 'cjs'),\n cjsIndexFile: join(rootDir, 'my-dist', 'index.cjs.js'),\n empty: false,\n esmDir: join(rootDir, 'my-dist', 'esm'),\n esmEs5Dir: undefined,\n esmIndexFile: join(rootDir, 'my-dist', 'index.js'),\n polyfills: true,\n },\n {\n cjsDir: join(rootDir, 'my-dist', 'cjs'),\n componentDts: join(rootDir, 'my-dist', 'types', 'components.d.ts'),\n dir: join(rootDir, 'my-dist', 'loader'),\n empty: false,\n esmDir: join(rootDir, 'my-dist', 'esm'),\n esmEs5Dir: undefined,\n type: 'dist-lazy-loader',\n },\n ]);\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-output-www.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\nimport { mockLoadConfigInit } from '@stencil/core/testing';\nimport { isOutputTargetCopy, isOutputTargetHydrate, isOutputTargetWww, join } from '@utils';\nimport path from 'path';\n\nimport { ConfigFlags, createConfigFlags } from '../../../cli/config-flags';\nimport { validateConfig } from '../validate-config';\n\ndescribe('validateOutputTargetWww', () => {\n // use Node's resolve() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on)\n const rootDir = path.resolve('/');\n let userConfig: d.Config;\n let flags: ConfigFlags;\n\n beforeEach(() => {\n flags = createConfigFlags();\n userConfig = {\n rootDir: rootDir,\n flags,\n };\n });\n\n it('should have default value', () => {\n const outputTarget: d.OutputTargetWww = {\n type: 'www',\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n dir: path.join('www', 'docs'),\n };\n userConfig.outputTargets = [outputTarget];\n userConfig.buildEs5 = false;\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.outputTargets).toEqual([\n {\n appDir: join(rootDir, 'www', 'docs'),\n baseUrl: '/',\n buildDir: join(rootDir, 'www', 'docs', 'build'),\n dir: join(rootDir, 'www', 'docs'),\n empty: true,\n indexHtml: join(rootDir, 'www', 'docs', 'index.html'),\n polyfills: true,\n serviceWorker: {\n dontCacheBustURLsMatching: /p-\\w{8}/,\n globDirectory: join(rootDir, 'www', 'docs'),\n globIgnores: [\n '**/host.config.json',\n '**/*.system.entry.js',\n '**/*.system.js',\n '**/app.js',\n '**/app.esm.js',\n '**/app.css',\n ],\n globPatterns: ['*.html', '**/*.{js,css,json}'],\n swDest: join(rootDir, 'www', 'docs', 'sw.js'),\n },\n type: 'www',\n },\n {\n dir: join(rootDir, 'www', 'docs', 'build'),\n esmDir: join(rootDir, 'www', 'docs', 'build'),\n isBrowserBuild: true,\n polyfills: true,\n systemDir: undefined,\n systemLoaderFile: undefined,\n type: 'dist-lazy',\n },\n {\n copyAssets: 'dist',\n dir: join(rootDir, 'www', 'docs', 'build'),\n type: 'copy',\n },\n {\n copy: [\n {\n src: 'assets',\n warn: false,\n },\n {\n src: 'manifest.json',\n warn: false,\n },\n ],\n dir: join(rootDir, 'www', 'docs'),\n type: 'copy',\n },\n {\n file: join(rootDir, 'www', 'docs', 'build', 'app.css'),\n type: 'dist-global-styles',\n },\n ]);\n });\n\n it('should www with sub directory', () => {\n const outputTarget: d.OutputTargetWww = {\n type: 'www',\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n dir: path.join('www', 'docs'),\n };\n userConfig.outputTargets = [outputTarget];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const www = config.outputTargets.find(isOutputTargetWww) as d.OutputTargetWww;\n\n expect(www.dir).toBe(join(rootDir, 'www', 'docs'));\n expect(www.appDir).toBe(join(rootDir, 'www', 'docs'));\n expect(www.buildDir).toBe(join(rootDir, 'www', 'docs', 'build'));\n expect(www.indexHtml).toBe(join(rootDir, 'www', 'docs', 'index.html'));\n });\n\n it('should set www values', () => {\n const outputTarget: d.OutputTargetWww = {\n type: 'www',\n dir: 'my-www',\n buildDir: 'my-build',\n indexHtml: 'my-index.htm',\n empty: false,\n };\n userConfig.outputTargets = [outputTarget];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const www = config.outputTargets.find(isOutputTargetWww) as d.OutputTargetWww;\n\n expect(www.type).toBe('www');\n expect(www.dir).toBe(join(rootDir, 'my-www'));\n expect(www.buildDir).toBe(join(rootDir, 'my-www', 'my-build'));\n expect(www.indexHtml).toBe(join(rootDir, 'my-www', 'my-index.htm'));\n expect(www.empty).toBe(false);\n });\n\n it('should default to add www when outputTargets is undefined', () => {\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets).toHaveLength(5);\n\n const outputTarget = config.outputTargets.find(isOutputTargetWww) as d.OutputTargetWww;\n expect(outputTarget.dir).toBe(join(rootDir, 'www'));\n expect(outputTarget.buildDir).toBe(join(rootDir, 'www', 'build'));\n expect(outputTarget.indexHtml).toBe(join(rootDir, 'www', 'index.html'));\n expect(outputTarget.empty).toBe(true);\n });\n\n describe('baseUrl', () => {\n it('baseUrl does not end with / with dir set', () => {\n const outputTarget: d.OutputTargetWww = {\n type: 'www',\n dir: 'my-www',\n baseUrl: '/docs',\n };\n userConfig.outputTargets = [outputTarget];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const www = config.outputTargets.find(isOutputTargetWww) as d.OutputTargetWww;\n\n expect(www.type).toBe('www');\n expect(www.dir).toBe(join(rootDir, 'my-www'));\n expect(www.baseUrl).toBe('/docs/');\n expect(www.appDir).toBe(join(rootDir, 'my-www/docs'));\n\n expect(www.buildDir).toBe(join(rootDir, 'my-www', 'docs', 'build'));\n expect(www.indexHtml).toBe(join(rootDir, 'my-www', 'docs', 'index.html'));\n });\n\n it('baseUrl does not end with /', () => {\n const outputTarget: d.OutputTargetWww = {\n type: 'www',\n baseUrl: '/docs',\n };\n userConfig.outputTargets = [outputTarget];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const www = config.outputTargets.find(isOutputTargetWww) as d.OutputTargetWww;\n\n expect(www.type).toBe('www');\n expect(www.dir).toBe(join(rootDir, 'www'));\n expect(www.baseUrl).toBe('/docs/');\n expect(www.appDir).toBe(join(rootDir, 'www/docs'));\n\n expect(www.buildDir).toBe(join(rootDir, 'www', 'docs', 'build'));\n expect(www.indexHtml).toBe(join(rootDir, 'www', 'docs', 'index.html'));\n });\n\n it('baseUrl is a full url', () => {\n const outputTarget: d.OutputTargetWww = {\n type: 'www',\n baseUrl: 'https://example.com/docs',\n };\n userConfig.outputTargets = [outputTarget];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const www = config.outputTargets.find(isOutputTargetWww) as d.OutputTargetWww;\n\n expect(www.type).toBe('www');\n expect(www.dir).toBe(join(rootDir, 'www'));\n expect(www.baseUrl).toBe('https://example.com/docs/');\n expect(www.appDir).toBe(join(rootDir, 'www/docs'));\n\n expect(www.buildDir).toBe(join(rootDir, 'www', 'docs', 'build'));\n expect(www.indexHtml).toBe(join(rootDir, 'www', 'docs', 'index.html'));\n });\n });\n\n describe('copy', () => {\n it('should add copy tasks', () => {\n const outputTarget: d.OutputTargetWww = {\n type: 'www',\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n dir: path.join('www', 'docs'),\n copy: [\n {\n src: 'index-modules.html',\n dest: 'index-2.html',\n },\n ],\n };\n userConfig.outputTargets = [outputTarget];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n const copyTargets = config.outputTargets.filter(isOutputTargetCopy);\n expect(copyTargets).toEqual([\n {\n copyAssets: 'dist',\n dir: join(rootDir, 'www', 'docs', 'build'),\n type: 'copy',\n },\n {\n copy: [\n {\n dest: 'index-2.html',\n src: 'index-modules.html',\n },\n {\n src: 'assets',\n warn: false,\n },\n {\n src: 'manifest.json',\n warn: false,\n },\n ],\n dir: join(rootDir, 'www', 'docs'),\n type: 'copy',\n },\n ]);\n });\n\n it('should replace copy tasks', () => {\n const outputTarget: d.OutputTargetWww = {\n type: 'www',\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n dir: path.join('www', 'docs'),\n copy: [\n {\n src: 'assets',\n dest: 'assets2',\n },\n ],\n };\n userConfig.outputTargets = [outputTarget];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n const copyTargets = config.outputTargets.filter(isOutputTargetCopy);\n expect(copyTargets).toEqual([\n {\n copyAssets: 'dist',\n dir: join(rootDir, 'www', 'docs', 'build'),\n type: 'copy',\n },\n {\n copy: [\n {\n dest: 'assets2',\n src: 'assets',\n },\n {\n src: 'manifest.json',\n warn: false,\n },\n ],\n dir: join(rootDir, 'www', 'docs'),\n type: 'copy',\n },\n ]);\n });\n\n it('should disable copy tasks', () => {\n const outputTarget: d.OutputTargetWww = {\n type: 'www',\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n dir: path.join('www', 'docs'),\n copy: null,\n };\n userConfig.outputTargets = [outputTarget];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n const copyTargets = config.outputTargets.filter(isOutputTargetCopy);\n expect(copyTargets).toEqual([\n {\n copyAssets: 'dist',\n dir: join(rootDir, 'www', 'docs', 'build'),\n type: 'copy',\n },\n {\n copy: [],\n dir: join(rootDir, 'www', 'docs'),\n type: 'copy',\n },\n ]);\n });\n });\n\n describe('dist-hydrate-script', () => {\n it('should not add hydrate by default', () => {\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets.some((o) => o.type === 'dist-hydrate-script')).toBe(false);\n expect(config.outputTargets.some((o) => o.type === 'www')).toBe(true);\n });\n\n it('should not add hydrate with user www', () => {\n const wwwOutputTarget: d.OutputTargetWww = {\n type: 'www',\n };\n userConfig.outputTargets = [wwwOutputTarget];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets.some((o) => o.type === 'dist-hydrate-script')).toBe(false);\n expect(config.outputTargets.some((o) => o.type === 'www')).toBe(true);\n });\n\n it('should add hydrate with user hydrate and www outputs', () => {\n const wwwOutputTarget: d.OutputTargetWww = {\n type: 'www',\n };\n const hydrateOutputTarget: d.OutputTargetHydrate = {\n type: 'dist-hydrate-script',\n };\n userConfig.outputTargets = [wwwOutputTarget, hydrateOutputTarget];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets.some((o) => o.type === 'dist-hydrate-script')).toBe(true);\n expect(config.outputTargets.some((o) => o.type === 'www')).toBe(true);\n });\n\n it('should add hydrate with --prerender flag', () => {\n userConfig.flags = { ...flags, prerender: true };\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets.some((o) => o.type === 'dist-hydrate-script')).toBe(true);\n expect(config.outputTargets.some((o) => o.type === 'www')).toBe(true);\n });\n\n it('should add hydrate with --ssr flag', () => {\n userConfig.flags = { ...flags, ssr: true };\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets.some((o) => o.type === 'dist-hydrate-script')).toBe(true);\n expect(config.outputTargets.some((o) => o.type === 'www')).toBe(true);\n });\n\n it('should add externals and defaults', () => {\n const hydrateOutputTarget: d.OutputTargetHydrate = {\n type: 'dist-hydrate-script',\n external: ['lodash', 'left-pad'],\n };\n userConfig.outputTargets = [hydrateOutputTarget];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const o = config.outputTargets.find(isOutputTargetHydrate) as d.OutputTargetHydrate;\n expect(o.external).toContain('lodash');\n expect(o.external).toContain('left-pad');\n expect(o.external).toContain('fs');\n expect(o.external).toContain('path');\n expect(o.external).toContain('crypto');\n });\n\n it('should add node builtins to external by default', () => {\n userConfig.flags = { ...flags, prerender: true };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const o = config.outputTargets.find(isOutputTargetHydrate) as d.OutputTargetHydrate;\n expect(o.external).toContain('fs');\n expect(o.external).toContain('path');\n expect(o.external).toContain('crypto');\n });\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-paths.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\nimport { mockCompilerSystem, mockLoadConfigInit, mockLogger } from '@stencil/core/testing';\nimport { join } from '@utils';\nimport path from 'path';\n\nimport { validateConfig } from '../validate-config';\n\ndescribe('validatePaths', () => {\n let userConfig: d.Config;\n const logger = mockLogger();\n const sys = mockCompilerSystem();\n\n // use Node's resolve() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on)\n const ROOT = path.resolve('/');\n\n beforeEach(() => {\n userConfig = {\n sys: sys as any,\n logger: logger,\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n rootDir: path.join(ROOT, 'User', 'my-app'),\n namespace: 'Testing',\n };\n });\n\n it('should set absolute cacheDir', () => {\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n userConfig.cacheDir = path.join(ROOT, 'some', 'custom', 'cache');\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.cacheDir).toBe(join(ROOT, 'some', 'custom', 'cache'));\n });\n\n it('should set relative cacheDir', () => {\n userConfig.cacheDir = 'custom-cache';\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.cacheDir).toBe(join(ROOT, 'User', 'my-app', 'custom-cache'));\n });\n\n it('should set default cacheDir', () => {\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.cacheDir).toBe(join(ROOT, 'User', 'my-app', '.stencil'));\n });\n\n it('should set default wwwIndexHtml and convert to absolute path', () => {\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(path.basename((config.outputTargets as d.OutputTargetWww[])[0].indexHtml!)).toBe('index.html');\n expect(path.isAbsolute((config.outputTargets as d.OutputTargetWww[])[0].indexHtml!)).toBe(true);\n });\n\n it('should convert a custom wwwIndexHtml to absolute path', () => {\n userConfig.outputTargets = [\n {\n type: 'www',\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n indexHtml: path.join('assets', 'custom-index.html'),\n },\n ] as d.OutputTargetWww[];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(path.basename((config.outputTargets as d.OutputTargetWww[])[0].indexHtml!)).toBe('custom-index.html');\n expect(path.isAbsolute((config.outputTargets as d.OutputTargetWww[])[0].indexHtml!)).toBe(true);\n });\n\n it('should set default indexHtmlSrc and convert to absolute path', () => {\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(path.basename(config.srcIndexHtml)).toBe('index.html');\n expect(path.isAbsolute(config.srcIndexHtml)).toBe(true);\n });\n\n it('should set emptyDist to false', () => {\n userConfig.outputTargets = [\n {\n type: 'www',\n empty: false,\n },\n ] as d.OutputTargetWww[];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect((config.outputTargets as d.OutputTargetWww[])[0].empty).toBe(false);\n });\n\n it('should set default emptyWWW to true', () => {\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect((config.outputTargets as d.OutputTargetWww[])[0].empty).toBe(true);\n });\n\n it('should set emptyWWW to false', () => {\n userConfig.outputTargets = [\n {\n type: 'www',\n empty: false,\n },\n ] as d.OutputTargetWww[];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect((config.outputTargets as d.OutputTargetWww[])[0].empty).toBe(false);\n });\n\n it('should set default collection dir and convert to absolute path', () => {\n userConfig.outputTargets = [\n {\n type: 'dist',\n },\n ];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(path.basename((config.outputTargets as d.OutputTargetDist[])[0].collectionDir!)).toBe('collection');\n expect(path.isAbsolute((config.outputTargets as d.OutputTargetDist[])[0].collectionDir!)).toBe(true);\n });\n\n it('should set default types dir and convert to absolute path', () => {\n userConfig.outputTargets = [\n {\n type: 'dist',\n },\n ];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(path.basename((config.outputTargets as d.OutputTargetDist[])[0].typesDir!)).toBe('types');\n expect(path.isAbsolute((config.outputTargets as d.OutputTargetDist[])[0].typesDir!)).toBe(true);\n });\n\n it('should set default build dir and convert to absolute path', () => {\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n // the path will be normalized by Stencil us use '/', split on that regardless of platform\n const parts = (config.outputTargets as d.OutputTargetDist[])[0].buildDir!.split('/');\n expect(parts[parts.length - 1]).toBe('build');\n expect(parts[parts.length - 2]).toBe('www');\n expect(path.isAbsolute((config.outputTargets as d.OutputTargetDist[])[0].buildDir!)).toBe(true);\n });\n\n it('should set build dir w/ custom www', () => {\n userConfig.outputTargets = [\n {\n type: 'www',\n dir: 'custom-www',\n },\n ] as d.OutputTargetWww[];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n // the path will be normalized by Stencil us use '/', split on that regardless of platform\n const parts = (config.outputTargets as d.OutputTargetDist[])[0].buildDir!.split('/');\n expect(parts[parts.length - 1]).toBe('build');\n expect(parts[parts.length - 2]).toBe('custom-www');\n expect(path.isAbsolute((config.outputTargets as d.OutputTargetDist[])[0].buildDir!)).toBe(true);\n });\n\n it('should set default src dir and convert to absolute path', () => {\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(path.basename(config.srcDir)).toBe('src');\n expect(path.isAbsolute(config.srcDir)).toBe(true);\n });\n\n it('should set src dir and convert to absolute path', () => {\n userConfig.srcDir = 'app';\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(path.basename(config.srcDir)).toBe('app');\n expect(path.isAbsolute(config.srcDir)).toBe(true);\n });\n\n it('should convert globalScript to absolute path, if a globalScript property was provided', () => {\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n userConfig.globalScript = path.join('src', 'global', 'index.ts');\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(path.basename(config.globalScript!)).toBe('index.ts');\n expect(path.isAbsolute(config.globalScript!)).toBe(true);\n });\n\n it('should convert globalStyle string to absolute path array, if a globalStyle property was provided', () => {\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n userConfig.globalStyle = path.join('src', 'global', 'styles.css');\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(path.basename(config.globalStyle!)).toBe('styles.css');\n expect(path.isAbsolute(config.globalStyle!)).toBe(true);\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-rollup-config.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\n\nimport { validateRollupConfig } from '../validate-rollup-config';\n\ndescribe('validateStats', () => {\n let config: d.Config;\n\n beforeEach(() => {\n config = {};\n });\n\n it('should use default if no config provided', () => {\n const rollupConfig = validateRollupConfig(config);\n expect(rollupConfig).toEqual({\n inputOptions: {},\n outputOptions: {},\n });\n });\n\n it('should set based on inputOptions if provided', () => {\n config.rollupConfig = {\n inputOptions: {\n context: 'window',\n },\n };\n const rollupConfig = validateRollupConfig(config);\n expect(rollupConfig).toEqual({\n inputOptions: {\n context: 'window',\n },\n outputOptions: {},\n });\n });\n\n it('should use default if inputOptions is not provided but outputOptions is', () => {\n config.rollupConfig = {\n outputOptions: {\n globals: {\n jquery: '$',\n },\n },\n };\n\n const rollupConfig = validateRollupConfig(config);\n expect(rollupConfig).toEqual({\n inputOptions: {},\n outputOptions: {\n globals: {\n jquery: '$',\n },\n },\n });\n });\n\n it('should pass all valid config data through and not those that are extraneous', () => {\n config.rollupConfig = {\n inputOptions: {\n context: 'window',\n external: 'external_symbol',\n notAnOption: {},\n },\n outputOptions: {\n globals: {\n jquery: '$',\n },\n },\n } as d.RollupConfig;\n\n const rollupConfig = validateRollupConfig(config);\n expect(rollupConfig).toEqual({\n inputOptions: {\n context: 'window',\n external: 'external_symbol',\n },\n outputOptions: {\n globals: {\n jquery: '$',\n },\n },\n });\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-service-worker.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\nimport { OutputTargetWww } from '@stencil/core/declarations';\nimport { mockCompilerSystem, mockLogger, mockValidatedConfig } from '@stencil/core/testing';\n\nimport { createConfigFlags } from '../../../cli/config-flags';\nimport { validateServiceWorker } from '../validate-service-worker';\n\ndescribe('validateServiceWorker', () => {\n let config: d.ValidatedConfig;\n\n let outputTarget: d.OutputTargetWww;\n\n beforeEach(() => {\n config = mockValidatedConfig({\n devMode: false,\n flags: createConfigFlags(),\n fsNamespace: 'app',\n hydratedFlag: null,\n logger: mockLogger(),\n outputTargets: [],\n packageJsonFilePath: '/package.json',\n rootDir: '/',\n sys: mockCompilerSystem(),\n testing: {},\n transformAliasedImportPaths: true,\n });\n });\n\n /**\n * A little util to work around a typescript annoyance. Because\n * `outputTarget.serviceWorker` is typed as\n * `serviceWorker?: ServiceWorkerConfig | null | false;` we get type errors\n * all over if we try to just access it directly. So instead, do a little\n * check to see if it's falsy. If not, we return it, and if it is we fail the test.\n *\n * @param target the output target from which we want to pull the serviceWorker\n * @returns a serviceWorker object or `void`, with a `void` return being\n * accompanied by a manually-triggered test failure.\n */\n function getServiceWorker(target: OutputTargetWww) {\n if (target.serviceWorker) {\n return target.serviceWorker;\n } else {\n throw new Error('the serviceWorker on the provided target was unexpectedly falsy, so this test needs to fail!');\n }\n }\n\n it('should add host.config.json to globIgnores', () => {\n outputTarget = {\n type: 'www',\n appDir: '/User/me/app/www/',\n };\n validateServiceWorker(config, outputTarget);\n expect(getServiceWorker(outputTarget).globIgnores).toContain('**/host.config.json');\n });\n\n it('should set globIgnores from string', () => {\n outputTarget = {\n type: 'www',\n appDir: '/User/me/app/www/',\n serviceWorker: {\n globIgnores: '**/some-file.js',\n },\n };\n validateServiceWorker(config, outputTarget);\n expect(getServiceWorker(outputTarget).globIgnores).toContain('**/some-file.js');\n });\n\n it('should set globDirectory', () => {\n outputTarget = {\n type: 'www',\n appDir: '/User/me/app/www/',\n serviceWorker: {\n globDirectory: '/custom/www',\n },\n };\n validateServiceWorker(config, outputTarget);\n expect(getServiceWorker(outputTarget).globDirectory).toBe('/custom/www');\n });\n\n it('should set default globDirectory', () => {\n outputTarget = {\n type: 'www',\n appDir: '/User/me/app/www/',\n };\n validateServiceWorker(config, outputTarget);\n expect(getServiceWorker(outputTarget).globDirectory).toBe('/User/me/app/www/');\n });\n\n it('should set globPatterns array', () => {\n outputTarget = {\n type: 'www',\n appDir: '/www',\n serviceWorker: {\n globPatterns: ['**/*.{png,svg}'],\n },\n };\n validateServiceWorker(config, outputTarget);\n expect(getServiceWorker(outputTarget).globPatterns).toEqual(['**/*.{png,svg}']);\n });\n\n it('should set globPatterns string', () => {\n outputTarget = {\n type: 'www',\n appDir: '/www',\n serviceWorker: {\n globPatterns: '**/*.{png,svg}' as any,\n },\n };\n validateServiceWorker(config, outputTarget);\n expect(getServiceWorker(outputTarget).globPatterns).toEqual(['**/*.{png,svg}']);\n });\n\n it('should create default globPatterns', () => {\n outputTarget = {\n type: 'www',\n appDir: '/www',\n };\n validateServiceWorker(config, outputTarget);\n expect(getServiceWorker(outputTarget).globPatterns).toEqual(['*.html', '**/*.{js,css,json}']);\n });\n\n it('should create default sw config when www type and prod mode', () => {\n outputTarget = {\n type: 'www',\n appDir: '/www',\n };\n validateServiceWorker(config, outputTarget);\n expect(outputTarget.serviceWorker).not.toBe(null);\n });\n\n it('should not create default sw config when www type and devMode', () => {\n outputTarget = {\n type: 'www',\n appDir: '/www',\n };\n config.devMode = true;\n validateServiceWorker(config, outputTarget);\n expect(outputTarget.serviceWorker).toBe(null);\n });\n\n it('should create default sw config when true boolean, even if devMode', () => {\n outputTarget = {\n type: 'www',\n appDir: '/www',\n serviceWorker: true as any,\n };\n config.devMode = true;\n validateServiceWorker(config, outputTarget);\n expect(outputTarget.serviceWorker).not.toBe(true);\n });\n\n it('should not create sw config when in devMode', () => {\n outputTarget = {\n type: 'www',\n appDir: '/www',\n serviceWorker: true as any,\n };\n config.devMode = true;\n validateServiceWorker(config, outputTarget);\n expect(outputTarget.serviceWorker).toBe(null);\n });\n\n it('should create sw config when in devMode if flag serviceWorker', () => {\n outputTarget = {\n type: 'www',\n appDir: '/www',\n serviceWorker: true as any,\n };\n config.devMode = true;\n config.flags.serviceWorker = true;\n validateServiceWorker(config, outputTarget);\n expect(outputTarget.serviceWorker).not.toBe(null);\n });\n\n it('should stay null', () => {\n outputTarget = {\n type: 'www',\n serviceWorker: null,\n };\n validateServiceWorker(config, outputTarget);\n expect(outputTarget.serviceWorker).toBe(null);\n });\n\n it('should stay false', () => {\n outputTarget = {\n type: 'www',\n serviceWorker: false,\n };\n validateServiceWorker(config, outputTarget);\n expect(outputTarget.serviceWorker).toBe(false);\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-stats.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\nimport { mockConfig, mockLoadConfigInit } from '@stencil/core/testing';\n\nimport { validateConfig } from '../validate-config';\n\ndescribe('validateStats', () => {\n let userConfig: d.Config;\n\n beforeEach(() => {\n userConfig = mockConfig();\n });\n\n it('adds stats from flags, w/ no outputTargets', () => {\n // the flags field is expected to have been set by the mock creation function for unvalidated configs, hence the\n // bang operator\n userConfig.flags!.stats = true;\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const o = config.outputTargets.find((o) => o.type === 'stats') as d.OutputTargetStats;\n expect(o).toBeDefined();\n expect(o.file).toContain('stencil-stats.json');\n });\n\n it('uses stats config, custom path', () => {\n userConfig.outputTargets = [\n {\n type: 'stats',\n file: 'custom-path.json',\n } as d.OutputTargetStats,\n ];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const o = config.outputTargets.find((o) => o.type === 'stats') as d.OutputTargetStats;\n expect(o).toBeDefined();\n expect(o.file).toContain('custom-path.json');\n });\n\n it('uses stats config, defaults file', () => {\n userConfig.outputTargets = [\n {\n type: 'stats',\n },\n ];\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const o = config.outputTargets.find((o) => o.type === 'stats') as d.OutputTargetStats;\n expect(o).toBeDefined();\n expect(o.file).toContain('stencil-stats.json');\n });\n\n it('default no stats', () => {\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.outputTargets.some((o) => o.type === 'stats')).toBe(false);\n });\n\n it('adds stats from flags with custom path string', () => {\n // Test --stats dist/stats.json behavior\n userConfig.flags!.stats = 'dist/custom-stats.json';\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const o = config.outputTargets.find((o) => o.type === 'stats') as d.OutputTargetStats;\n expect(o).toBeDefined();\n expect(o.file).toContain('dist/custom-stats.json');\n });\n\n it('adds stats from flags with custom path (absolute)', () => {\n // Test --stats /tmp/stats.json behavior\n userConfig.flags!.stats = '/tmp/absolute-stats.json';\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const o = config.outputTargets.find((o) => o.type === 'stats') as d.OutputTargetStats;\n expect(o).toBeDefined();\n expect(o.file).toBe('/tmp/absolute-stats.json');\n });\n\n it('flags stats path takes precedence over default when no outputTarget', () => {\n // When --stats has a path, it should be used instead of the default\n userConfig.flags!.stats = 'custom-location/stats.json';\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const o = config.outputTargets.find((o) => o.type === 'stats') as d.OutputTargetStats;\n expect(o).toBeDefined();\n expect(o.file).toContain('custom-location/stats.json');\n expect(o.file).not.toContain('stencil-stats.json');\n });\n\n it('does not override existing stats outputTarget when flag has path', () => {\n // When there's already a stats outputTarget in config, flag should not add another\n userConfig.outputTargets = [\n {\n type: 'stats',\n file: 'config-defined.json',\n } as d.OutputTargetStats,\n ];\n userConfig.flags!.stats = 'flag-defined.json';\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n const statsTargets = config.outputTargets.filter((o) => o.type === 'stats');\n expect(statsTargets.length).toBe(1);\n expect(statsTargets[0].file).toContain('config-defined.json');\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-testing.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\nimport { mockCompilerSystem, mockLoadConfigInit, mockLogger } from '@stencil/core/testing';\nimport { join } from '@utils';\nimport path from 'path';\n\nimport { ConfigFlags, createConfigFlags } from '../../../cli/config-flags';\nimport { validateConfig } from '../validate-config';\n\ndescribe('validateTesting', () => {\n // use Node's resolve() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on)\n const ROOT = path.resolve('/');\n const sys = mockCompilerSystem();\n const logger = mockLogger();\n let userConfig: d.Config;\n let flags: ConfigFlags;\n\n beforeEach(() => {\n flags = createConfigFlags();\n userConfig = {\n sys: sys as any,\n logger: logger,\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n rootDir: path.join(ROOT, 'User', 'some', 'path'),\n srcDir: path.join(ROOT, 'User', 'some', 'path', 'src'),\n flags,\n namespace: 'Testing',\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n configPath: path.join(ROOT, 'User', 'some', 'path', 'stencil.config.ts'),\n };\n userConfig.outputTargets = [\n {\n type: 'www',\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n dir: path.join(ROOT, 'www'),\n } as any as d.OutputTargetStats,\n ];\n });\n\n describe('no testing flags', () => {\n it('returns an empty testing config when no testing config nor testing flags are provided', () => {\n userConfig.flags = { ...flags, e2e: false, spec: false };\n delete userConfig.testing;\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing).toEqual({});\n });\n\n it('returns the provided testing config when neither testing flag is provided', () => {\n const testingConfig: d.TestingConfig = {\n bail: false,\n };\n userConfig.flags = { ...flags, e2e: false, spec: false };\n userConfig.testing = testingConfig;\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing).toEqual(testingConfig);\n });\n });\n\n describe('browserHeadless', () => {\n const originalCI = process.env.CI;\n beforeEach(() => {\n delete process.env.CI;\n });\n\n afterEach(() => {\n process.env.CI = originalCI;\n });\n\n describe(\"using 'headless' value from cli\", () => {\n it.each([false, 'shell'])('sets browserHeadless to %s', (headless) => {\n userConfig.flags = { ...flags, e2e: true, headless };\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.testing.browserHeadless).toBe(headless);\n });\n\n it('throws if browser headless is set to deprecated value `true`', () => {\n userConfig.flags = { ...flags, e2e: true, headless: true };\n expect(() => validateConfig(userConfig, mockLoadConfigInit())).toThrow(\n 'Setting \"browserHeadless\" config to `true` is not supported anymore, please set it to \"shell\"!',\n );\n });\n\n it('defaults to \"shell\" outside of CI', () => {\n userConfig.flags = { ...flags, e2e: true };\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.testing.browserHeadless).toBe('shell');\n });\n });\n\n describe('with ci enabled', () => {\n it(\"forces using the shell headless mode when 'headless: false'\", () => {\n userConfig.flags = { ...flags, ci: true, e2e: true, headless: false };\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.testing.browserHeadless).toBe('shell');\n });\n\n it('allows the shell headless mode to be used', () => {\n userConfig.flags = { ...flags, ci: true, e2e: true, headless: 'shell' };\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.testing.browserHeadless).toBe('shell');\n });\n });\n\n describe('`testing` configuration', () => {\n beforeEach(() => {\n userConfig.flags = { ...flags, e2e: true, headless: undefined };\n });\n\n it.each([false, 'shell'])(\n 'uses %s browserHeadless mode from testing config',\n (browserHeadlessValue) => {\n userConfig.testing = { browserHeadless: browserHeadlessValue };\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.testing.browserHeadless).toBe(browserHeadlessValue);\n },\n );\n\n it('throws if browser headless is set to deprecated value `true`', () => {\n userConfig.testing = { browserHeadless: true };\n expect(() => validateConfig(userConfig, mockLoadConfigInit())).toThrow(\n 'Setting \"browserHeadless\" config to `true` is not supported anymore, please set it to \"shell\"!',\n );\n });\n\n it('defaults the headless mode to \"shell\" when browserHeadless is not provided', () => {\n userConfig.testing = {};\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.testing.browserHeadless).toBe('shell');\n });\n });\n });\n\n describe('devTools', () => {\n const originalCI = process.env.CI;\n beforeEach(() => {\n delete process.env.CI;\n });\n\n afterEach(() => {\n process.env.CI = originalCI;\n });\n\n it('ignores devTools settings if CI is enabled', () => {\n userConfig.flags = { ...flags, ci: true, devtools: true, e2e: true };\n userConfig.testing = {};\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.browserDevtools).toBeUndefined();\n });\n\n it('sets browserDevTools to true when the devtools flag is set', () => {\n userConfig.flags = { ...flags, devtools: true, e2e: true };\n userConfig.testing = {};\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.browserDevtools).toBe(true);\n // browserHeadless must be false to enabled dev tools (which are headful by definition)\n expect(config.testing.browserHeadless).toBe(false);\n });\n\n it(\"sets browserDevTools to true when set in a project's config\", () => {\n userConfig.flags = { ...flags, devtools: false, e2e: true };\n userConfig.testing = { browserDevtools: true };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.browserDevtools).toBe(true);\n // browserHeadless must be false to enabled dev tools (which are headful by definition)\n expect(config.testing.browserHeadless).toBe(false);\n });\n });\n\n describe('browserWaitUntil', () => {\n it('sets the default to \"load\" if no value is provided', () => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {};\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.browserWaitUntil).toBe('load');\n });\n\n it('does not override a provided value', () => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n browserWaitUntil: 'domcontentloaded',\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.browserWaitUntil).toBe('domcontentloaded');\n });\n });\n\n describe('browserArgs', () => {\n const originalCI = process.env.CI;\n beforeEach(() => {\n delete process.env.CI;\n });\n\n afterEach(() => {\n process.env.CI = originalCI;\n });\n\n it('does not add duplicate default fields', () => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n browserArgs: ['--unique', '--font-render-hinting=medium'],\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.browserArgs).toEqual(['--unique', '--font-render-hinting=medium', '--incognito']);\n });\n\n describe('adds default browser args', () => {\n const originalCI = process.env.CI;\n\n beforeAll(() => {\n delete process.env.CI;\n });\n\n afterAll(() => {\n process.env.CI = originalCI;\n });\n\n it('adds default browser args when not in CI', () => {\n userConfig.flags = { ...flags, e2e: true };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.browserArgs).toEqual(['--font-render-hinting=medium', '--incognito']);\n });\n });\n\n it(\"adds additional browser args when the 'ci' flag is set\", () => {\n userConfig.flags = { ...flags, ci: true, e2e: true };\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.testing.browserArgs).toEqual([\n '--font-render-hinting=medium',\n '--incognito',\n '--no-sandbox',\n '--disable-setuid-sandbox',\n '--disable-dev-shm-usage',\n ]);\n });\n\n describe('adds additional browser args when process.env.CI is set', () => {\n const originalCI = process.env.CI;\n beforeAll(() => {\n process.env.CI = 'true';\n });\n\n afterAll(() => {\n process.env.CI = originalCI;\n });\n\n it('adds default browser args when CI is set', () => {\n userConfig.flags = { ...flags, ci: true, e2e: true };\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.testing.browserArgs).toEqual([\n '--font-render-hinting=medium',\n '--incognito',\n '--no-sandbox',\n '--disable-setuid-sandbox',\n '--disable-dev-shm-usage',\n ]);\n });\n });\n });\n\n describe('browserArgs in CI', () => {\n const originalCI = process.env.CI;\n beforeEach(() => {\n process.env.CI = 'true';\n });\n\n afterEach(() => {\n process.env.CI = originalCI;\n });\n\n it(\"adds additional browser args when 'CI' environment variable is set\", () => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n browserArgs: ['--unique', '--font-render-hinting=medium'],\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.browserArgs).toEqual([\n '--unique',\n '--font-render-hinting=medium',\n '--incognito',\n '--no-sandbox',\n '--disable-setuid-sandbox',\n '--disable-dev-shm-usage',\n ]);\n });\n });\n\n describe('screenshotConnector', () => {\n it('assigns the screenshotConnector value from the provided flags', () => {\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n userConfig.flags = { ...flags, e2e: true, screenshotConnector: path.join(ROOT, 'mock', 'path') };\n userConfig.testing = { screenshotConnector: path.join(ROOT, 'another', 'mock', 'path') };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.screenshotConnector).toBe(join(ROOT, 'mock', 'path'));\n });\n\n it(\"uses the config's root dir to make the screenshotConnector path absolute\", () => {\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n userConfig.flags = { ...flags, e2e: true, screenshotConnector: path.join('mock', 'path') };\n userConfig.testing = { screenshotConnector: path.join('another', 'mock', 'path') };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.screenshotConnector).toBe(join(ROOT, 'User', 'some', 'path', 'mock', 'path'));\n });\n\n it('sets screenshotConnector if a non-string is provided', () => {\n userConfig.flags = { ...flags, e2e: true };\n // the nature of this test is to evaluate a non-string, hence the type assertion\n userConfig.testing = { screenshotConnector: true as unknown as string };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.screenshotConnector).toBe(join('screenshot', 'local-connector.js'));\n });\n });\n\n describe('screenshotTimeout', () => {\n it('sets screenshotTimeout to null if not provided', () => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {};\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.testing.screenshotTimeout).toEqual(null);\n });\n\n it('sets screenshotTimeout to null if it has an unexpected value', () => {\n userConfig.flags = { ...flags, e2e: true };\n // @ts-expect-error - the nature of this test requires a non-string value\n userConfig.testing = { screenshotTimeout: '4s' };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.testing.screenshotTimeout).toEqual(null);\n });\n\n it('keeps the value if set correctly', () => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = { screenshotTimeout: 4000 };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.testing.screenshotTimeout).toEqual(4000);\n });\n });\n\n describe('testPathIgnorePatterns', () => {\n it('does not alter a provided testPathIgnorePatterns', () => {\n userConfig.flags = { ...flags, e2e: true };\n\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n const mockPath1 = path.join('this', 'is', 'a', 'mock', 'path');\n const mockPath2 = path.join('this', 'is', 'another', 'mock', 'path');\n userConfig.testing = { testPathIgnorePatterns: [mockPath1, mockPath2] };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.testPathIgnorePatterns).toEqual([mockPath1, mockPath2]);\n });\n\n it('sets the default testPathIgnorePatterns if no array is provided', () => {\n userConfig.flags = { ...flags, e2e: true };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.testPathIgnorePatterns).toEqual([\n join(ROOT, 'User', 'some', 'path', '.vscode'),\n join(ROOT, 'User', 'some', 'path', '.stencil'),\n join(ROOT, 'User', 'some', 'path', 'node_modules'),\n // use Node's join() here as the normalization process doesn't necessarily occur for this field\n path.join(ROOT, 'www'),\n ]);\n });\n\n it('sets the default testPathIgnorePatterns with custom outputTargets', () => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.outputTargets = [\n { type: 'dist', dir: 'dist-folder' },\n { type: 'www', dir: 'www-folder' },\n { type: 'docs-readme', dir: 'docs' },\n ];\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.testPathIgnorePatterns).toEqual([\n join(ROOT, 'User', 'some', 'path', '.vscode'),\n join(ROOT, 'User', 'some', 'path', '.stencil'),\n join(ROOT, 'User', 'some', 'path', 'node_modules'),\n join(ROOT, 'User', 'some', 'path', 'www-folder'),\n join(ROOT, 'User', 'some', 'path', 'dist-folder'),\n ]);\n });\n });\n\n describe('preset', () => {\n it.each([null, true])(\"uses stencil's default preset if a non-string (%s) is provided\", (nonStringPreset) => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n // the nature of this test requires a non-string value, hence the type assertion\n preset: nonStringPreset as unknown as string,\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n // 'testing' is the internal directory where `jest-preset.js` can be found\n expect(config.testing.preset).toEqual('testing');\n });\n\n it('forces a provided preset path to be absolute', () => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n preset: path.join('mock', 'path'),\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.preset).toEqual(join(ROOT, 'User', 'some', 'path', 'mock', 'path'));\n });\n\n it('does not change an already absolute preset path', () => {\n userConfig.flags = { ...flags, e2e: true };\n\n // use Node's join() here to simulate a user using either Win/Posix separators (depending on the platform these\n // tests are run on) for their input\n const presetPath = path.join(ROOT, 'mock', 'path');\n userConfig.testing = {\n preset: presetPath,\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n // per the test name, we should not change an already absolute path - assert against the preset path that was\n // generated using Node's join()\n expect(config.testing.preset).toEqual(presetPath);\n });\n });\n\n describe('setupFilesAfterEnv', () => {\n it.each([null, true])('forces a non-array (%s) of setup files to a default', (nonSetupFiles) => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n // the nature of this test requires a non-string value, hence the type assertion\n setupFilesAfterEnv: nonSetupFiles as unknown as string[],\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n // 'testing' is the internal directory where the default setup file can be found\n expect(config.testing.setupFilesAfterEnv).toEqual([join('testing', 'jest-setuptestframework.js')]);\n });\n\n it.each([[[]], [['mock-setup-file.js']]])(\n \"prepends stencil's default file to an array: %s\",\n (setupFilesAfterEnv) => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n setupFilesAfterEnv: [...setupFilesAfterEnv],\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.setupFilesAfterEnv).toEqual([\n // 'testing' is the internal directory where the default setup file can be found\n join('testing', 'jest-setuptestframework.js'),\n ...setupFilesAfterEnv,\n ]);\n },\n );\n });\n\n describe('testEnvironment', () => {\n it('sets a relative testEnvironment to absolute', () => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n testEnvironment: './rel-path.js',\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(path.isAbsolute(config.testing.testEnvironment)).toBe(true);\n expect(path.basename(config.testing.testEnvironment)).toEqual('rel-path.js');\n });\n\n it('allows a node module testEnvironment', () => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n testEnvironment: 'jsdom',\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.testEnvironment).toEqual('jsdom');\n });\n\n it('does nothing for an empty testEnvironment', () => {\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.testing.testEnvironment).toBeUndefined();\n });\n });\n\n describe('allowableMismatchedPixels', () => {\n it.each([0, 123])('does nothing is a non-negative number (%s) is provided', (pixelCount) => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n allowableMismatchedPixels: pixelCount,\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.allowableMismatchedPixels).toBe(pixelCount);\n });\n\n it('creates an error if a negative number is provided', () => {\n const pixelCount = -1;\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n allowableMismatchedPixels: pixelCount,\n };\n\n const { config, diagnostics } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.allowableMismatchedPixels).toBe(pixelCount);\n expect(diagnostics).toHaveLength(1);\n expect(diagnostics[0]).toEqual({\n absFilePath: undefined,\n header: 'Build Error',\n level: 'error',\n lines: [],\n messageText: 'allowableMismatchedPixels must be a value that is 0 or greater',\n relFilePath: undefined,\n type: 'build',\n });\n });\n\n it.each([true, null])('defaults to a reasonable value if a non-number (%s) is provided', (pixelCount) => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n // the nature of this test requires using a non-number, hence th type assertion\n allowableMismatchedPixels: pixelCount as unknown as number,\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.allowableMismatchedPixels).toBe(100);\n });\n });\n\n describe('allowableMismatchedRatio', () => {\n it.each([-0, 0, 0.5, 1.0])(\n 'does nothing if a value between 0 and 1 is provided (%s)',\n (allowableMismatchedRatio) => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n allowableMismatchedRatio,\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.allowableMismatchedRatio).toBe(allowableMismatchedRatio);\n },\n );\n\n it.each([-1, -0.1, 1.1, 2])(\n 'creates an error if a number outside 0 and 1 is provided (%s)',\n (allowableMismatchedRatio) => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n allowableMismatchedRatio,\n };\n\n const { config, diagnostics } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.allowableMismatchedRatio).toBe(allowableMismatchedRatio);\n expect(diagnostics).toHaveLength(1);\n expect(diagnostics[0]).toEqual({\n absFilePath: undefined,\n header: 'Build Error',\n level: 'error',\n lines: [],\n messageText: 'allowableMismatchedRatio must be a value ranging from 0 to 1',\n relFilePath: undefined,\n type: 'build',\n });\n },\n );\n\n it.each([true, null])('does nothing when a non-number (%s) is provided', (allowableMismatchedRatio) => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n // the nature of this test requires using a non-number, hence th type assertion\n allowableMismatchedRatio: allowableMismatchedRatio as unknown as number,\n };\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.testing.allowableMismatchedRatio).toBe(allowableMismatchedRatio);\n });\n });\n\n describe('pixelmatchThreshold', () => {\n it.each([-0, 0, 0.5, 1.0])('does nothing if a value between 0 and 1 is provided (%s)', (pixelmatchThreshold) => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n pixelmatchThreshold,\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.pixelmatchThreshold).toBe(pixelmatchThreshold);\n });\n\n it.each([-0.1, -1, 1.1, 2])(\n 'creates an error if a number outside 0 and 1 is provided (%s)',\n (pixelmatchThreshold) => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n pixelmatchThreshold,\n };\n\n const { config, diagnostics } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.pixelmatchThreshold).toBe(pixelmatchThreshold);\n expect(diagnostics).toHaveLength(1);\n expect(diagnostics[0]).toEqual({\n absFilePath: undefined,\n header: 'Build Error',\n level: 'error',\n lines: [],\n messageText: 'pixelmatchThreshold must be a value ranging from 0 to 1',\n relFilePath: undefined,\n type: 'build',\n });\n },\n );\n\n it.each([true, null])('defaults to a reasonable value if a non-number (%s) is provided', (pixelmatchThreshold) => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n // the nature of this test requires using a non-number, hence th type assertion\n pixelmatchThreshold: pixelmatchThreshold as unknown as number,\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.allowableMismatchedPixels).toBe(100);\n });\n });\n\n describe('testRegex', () => {\n let testRegex: RegExp;\n\n beforeEach(() => {\n userConfig.flags = { ...flags, spec: true };\n\n const { testing: testConfig } = validateConfig(userConfig, mockLoadConfigInit()).config;\n const testRegexSetting = testConfig?.testRegex;\n\n if (!testRegexSetting) {\n throw new Error('No testRegex was found in the Stencil TestingConfig. Failing test.');\n }\n\n testRegex = new RegExp(testRegexSetting[0]);\n });\n\n describe('test.* extensions', () => {\n it.each([\n 'my-component.test.ts',\n 'my-component.test.tsx',\n 'my-component.test.js',\n 'my-component.test.jsx',\n 'some/path/test.ts',\n 'some/path/test.tsx',\n 'some/path/test.js',\n 'some/path/test.jsx',\n ])(`matches the file '%s'`, (filename) => {\n expect(testRegex.test(filename)).toBe(true);\n });\n\n it.each([\n 'my-component.test.ts.snap',\n 'my-component.test.tsx.snap',\n 'my-component.test.js.snap',\n 'my-component.test.jsx.snap',\n 'my-component-test.ts',\n 'my-component-test.tsx',\n 'my-component-test.js',\n 'my-component-test.jsx',\n 'my-component.test.t',\n 'my-component.test.j',\n ])(`doesn't match the file '%s'`, (filename) => {\n expect(testRegex.test(filename)).toBe(false);\n });\n });\n\n describe('spec.* extensions', () => {\n it.each([\n 'my-component.spec.ts',\n 'my-component.spec.tsx',\n 'my-component.spec.js',\n 'my-component.spec.jsx',\n 'some/path/spec.ts',\n 'some/path/spec.tsx',\n 'some/path/spec.js',\n 'some/path/spec.jsx',\n ])(`matches the file '%s'`, (filename) => {\n expect(testRegex.test(filename)).toBe(true);\n });\n\n it.each([\n 'my-component.spec.ts.snap',\n 'my-component.spec.tsx.snap',\n 'my-component.spec.js.snap',\n 'my-component.spec.jsx.snap',\n 'my-component-spec.ts',\n 'my-component-spec.tsx',\n 'my-component-spec.js',\n 'my-component-spec.jsx',\n 'my-component.spec.t',\n 'my-component.spec.j',\n ])(`doesn't match the file '%s'`, (filename) => {\n expect(testRegex.test(filename)).toBe(false);\n });\n });\n\n describe('e2e.* extensions', () => {\n it.each([\n 'my-component.e2e.ts',\n 'my-component.e2e.tsx',\n 'my-component.e2e.js',\n 'my-component.e2e.jsx',\n 'some/path/e2e.ts',\n 'some/path/e2e.tsx',\n 'some/path/e2e.js',\n 'some/path/e2e.jsx',\n ])(`matches the file '%s'`, (filename) => {\n expect(testRegex.test(filename)).toBe(true);\n });\n\n it.each([\n 'my-component.e2e.ts.snap',\n 'my-component.e2e.tsx.snap',\n 'my-component.e2e.js.snap',\n 'my-component.e2e.jsx.snap',\n 'my-component-e2e.ts',\n 'my-component-e2e.tsx',\n 'my-component-e2e.js',\n 'my-component-e2e.jsx',\n 'my-component.e2e.t',\n 'my-component.e2e.j',\n ])(`doesn't match the file '%s'`, (filename) => {\n expect(testRegex.test(filename)).toBe(false);\n });\n });\n });\n\n describe('testMatch', () => {\n it('removes testRegex from the config when testMatch is an array', () => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n testMatch: ['mockMatcher'],\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.testMatch).toEqual(['mockMatcher']);\n expect(config.testing.testRegex).toBeUndefined();\n });\n\n it('removes testMatch from the config when testRegex is a string', () => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n testMatch: undefined,\n testRegex: ['/regexStr/'],\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.testMatch).toBeUndefined();\n expect(config.testing.testRegex).toEqual(['/regexStr/']);\n });\n\n it('transforms testRegex to an array if passed in as string', () => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n testMatch: undefined,\n // @ts-expect-error invalid type because of type update\n testRegex: '/regexStr/',\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.testMatch).toBeUndefined();\n expect(config.testing.testRegex).toEqual(['/regexStr/']);\n });\n });\n\n describe('runner', () => {\n it('does nothing if the runner property is a string', () => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n runner: 'my-runner.js',\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.runner).toEqual('my-runner.js');\n });\n\n it('sets the runner if a non-string value is provided', () => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n runner: undefined,\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n // 'testing' is the internal directory where the default runner file can be found\n expect(config.testing.runner).toEqual(join('testing', 'jest-runner.js'));\n });\n });\n\n describe('waitBeforeScreenshot', () => {\n it.each([-0, 0, 0.5, 1.0])('does nothing for a non-negative value (%s)', (waitBeforeScreenshot) => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n waitBeforeScreenshot,\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.waitBeforeScreenshot).toBe(waitBeforeScreenshot);\n });\n\n it('creates an error if the value provided is negative', () => {\n const waitBeforeScreenshot = -1;\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n waitBeforeScreenshot,\n };\n\n const { config, diagnostics } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.waitBeforeScreenshot).toBe(waitBeforeScreenshot);\n expect(diagnostics).toHaveLength(1);\n expect(diagnostics[0]).toEqual({\n absFilePath: undefined,\n header: 'Build Error',\n level: 'error',\n lines: [],\n messageText: 'waitBeforeScreenshot must be a value that is 0 or greater',\n relFilePath: undefined,\n type: 'build',\n });\n });\n\n it.each([true, null])('defaults to a reasonable value if a non-number (%s) is provided', (waitBeforeScreenshot) => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n // the nature of this test requires using a non-number, hence the type assertion\n pixelmatchThreshold: waitBeforeScreenshot as unknown as number,\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.waitBeforeScreenshot).toBe(10);\n });\n });\n\n describe('emulate', () => {\n it.each([[undefined], [[]]])('provides a reasonable default for %s', (emulate) => {\n userConfig.flags = { ...flags, e2e: true };\n userConfig.testing = {\n emulate,\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.emulate).toEqual([\n {\n userAgent: 'default',\n viewport: {\n width: 600,\n height: 600,\n deviceScaleFactor: 1,\n isMobile: false,\n hasTouch: false,\n isLandscape: false,\n },\n },\n ]);\n });\n\n it('does nothing when a non-zero length array is provided', () => {\n userConfig.flags = { ...flags, e2e: true };\n\n const emulateConfig: d.EmulateConfig = {\n userAgent: 'mockAgent',\n viewport: {\n width: 100,\n height: 100,\n deviceScaleFactor: 1,\n isMobile: true,\n hasTouch: true,\n isLandscape: false,\n },\n };\n userConfig.testing = {\n emulate: [emulateConfig],\n };\n\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n\n expect(config.testing.emulate).toEqual([emulateConfig]);\n });\n });\n});\n"
},
{
"path": "src/compiler/config/test/validate-workers.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\nimport { mockLoadConfigInit, mockLogger } from '@stencil/core/testing';\nimport path from 'path';\n\nimport { createConfigFlags } from '../../../cli/config-flags';\nimport { validateConfig } from '../validate-config';\n\ndescribe('validate-workers', () => {\n let userConfig: d.Config;\n const logger = mockLogger();\n\n beforeEach(() => {\n userConfig = {\n sys: {\n path: path,\n } as any,\n logger: logger,\n rootDir: '/',\n namespace: 'Testing',\n };\n });\n\n it('set maxConcurrentWorkers, but dont let it go under 0', () => {\n userConfig.maxConcurrentWorkers = -1;\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.maxConcurrentWorkers).toBe(0);\n });\n\n it('set maxConcurrentWorkers from ci flags', () => {\n userConfig.flags = createConfigFlags({\n ci: true,\n });\n userConfig.maxConcurrentWorkers = 2;\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.maxConcurrentWorkers).toBe(4);\n });\n\n it('set maxConcurrentWorkers from flags', () => {\n userConfig.flags = createConfigFlags({\n maxWorkers: 1,\n });\n userConfig.maxConcurrentWorkers = 4;\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.maxConcurrentWorkers).toBe(1);\n });\n\n it('set maxConcurrentWorkers', () => {\n userConfig.maxConcurrentWorkers = 4;\n const { config } = validateConfig(userConfig, mockLoadConfigInit());\n expect(config.maxConcurrentWorkers).toBe(4);\n });\n});\n"
},
{
"path": "src/compiler/config/transpile-options.ts",
"content": "import { isString } from '@utils';\nimport type { CompilerOptions } from 'typescript';\n\nimport type {\n CompilerSystem,\n Config,\n ImportData,\n TransformCssToEsmInput,\n TransformOptions,\n TranspileOptions,\n TranspileResults,\n} from '../../declarations';\nimport { STENCIL_INTERNAL_CLIENT_ID } from '../bundle/entry-alias-ids';\nimport { parseImportPath } from '../transformers/stencil-import-path';\n\nexport const getTranspileResults = (code: string, input: TranspileOptions) => {\n if (!isString(input.file)) {\n input.file = 'module.tsx';\n }\n const parsedImport = parseImportPath(input.file);\n\n const results: TranspileResults = {\n code: typeof code === 'string' ? code : '',\n data: [],\n diagnostics: [],\n inputFileExtension: parsedImport.ext,\n inputFilePath: input.file,\n imports: [],\n map: null,\n outputFilePath: null,\n };\n\n return {\n importData: parsedImport.data,\n results,\n };\n};\n\nconst transpileCtx = { sys: null as CompilerSystem };\n\n/**\n * Configuration necessary for transpilation\n */\ninterface TranspileConfig {\n compileOpts: TranspileOptions;\n config: Config;\n transformOpts: TransformOptions;\n}\n\n/**\n * Get configuration necessary to carry out transpilation, including a Stencil\n * configuration, transformation options, and transpilation options.\n *\n * @param input options for Stencil's transpiler (string-to-string compiler)\n * @returns the options and configuration necessary for transpilation\n */\nexport const getTranspileConfig = (input: TranspileOptions): TranspileConfig => {\n if (input.sys) {\n transpileCtx.sys = input.sys;\n } else if (!transpileCtx.sys) {\n transpileCtx.sys = require('../sys/node/index.js').createNodeSys();\n }\n\n const compileOpts: TranspileOptions = {\n componentExport: getTranspileConfigOpt(input.componentExport, VALID_EXPORT, 'customelement'),\n componentMetadata: getTranspileConfigOpt(input.componentMetadata, VALID_METADATA, null),\n coreImportPath: isString(input.coreImportPath) ? input.coreImportPath : STENCIL_INTERNAL_CLIENT_ID,\n currentDirectory: isString(input.currentDirectory)\n ? input.currentDirectory\n : transpileCtx.sys.getCurrentDirectory(),\n file: input.file,\n proxy: getTranspileConfigOpt(input.proxy, VALID_PROXY, 'defineproperty'),\n module: getTranspileConfigOpt(input.module, VALID_MODULE, 'esm'),\n sourceMap: input.sourceMap === 'inline' ? 'inline' : input.sourceMap !== false,\n style: getTranspileConfigOpt(input.style, VALID_STYLE, 'static'),\n styleImportData: getTranspileConfigOpt(input.styleImportData, VALID_STYLE_IMPORT_DATA, 'queryparams'),\n target: getTranspileConfigOpt(input.target, VALID_TARGET, 'latest'),\n };\n\n const tsCompilerOptions: CompilerOptions = {\n // ensure we uses legacy decorators\n experimentalDecorators: true,\n\n // best we always set this to true\n allowSyntheticDefaultImports: true,\n\n // best we always set this to true\n esModuleInterop: true,\n\n // always get source maps\n sourceMap: compileOpts.sourceMap !== false,\n\n // isolated per file transpiling\n isolatedModules: true,\n\n // transpileModule does not write anything to disk so there is no need to verify that there are no conflicts between input and output paths.\n suppressOutputPathCheck: true,\n\n // Filename can be non-ts file.\n allowNonTsExtensions: true,\n\n // We are not returning a sourceFile for lib file when asked by the program,\n // so pass --noLib to avoid reporting a file not found error.\n noLib: true,\n\n noResolve: true,\n\n // NOTE: \"module\" and \"target\" configs will be set later\n // after the \"ts\" object has been loaded\n };\n\n if (isString(input.baseUrl)) {\n compileOpts.baseUrl = input.baseUrl;\n tsCompilerOptions.baseUrl = compileOpts.baseUrl;\n }\n\n if (input.paths) {\n compileOpts.paths = { ...input.paths };\n tsCompilerOptions.paths = { ...compileOpts.paths };\n }\n\n if (input.jsx !== undefined) {\n tsCompilerOptions.jsx = input.jsx;\n }\n\n if (isString(input.jsxImportSource)) {\n tsCompilerOptions.jsxImportSource = input.jsxImportSource;\n }\n\n const transformOpts: TransformOptions = {\n coreImportPath: compileOpts.coreImportPath,\n componentExport: compileOpts.componentExport as any,\n componentMetadata: compileOpts.componentMetadata as any,\n currentDirectory: compileOpts.currentDirectory,\n isolatedModules: true,\n module: compileOpts.module as any,\n proxy: compileOpts.proxy as any,\n file: compileOpts.file,\n style: compileOpts.style as any,\n styleImportData: compileOpts.styleImportData as any,\n target: compileOpts.target as any,\n };\n\n const config: Config = {\n _isTesting: true,\n devMode: true,\n enableCache: false,\n minifyCss: true,\n minifyJs: false,\n rootDir: compileOpts.currentDirectory,\n srcDir: compileOpts.currentDirectory,\n sys: transpileCtx.sys,\n transformAliasedImportPaths: input.transformAliasedImportPaths,\n tsCompilerOptions,\n validateTypes: false,\n };\n\n return {\n compileOpts,\n config,\n transformOpts,\n };\n};\n\nexport const getTranspileCssConfig = (\n compileOpts: TranspileOptions,\n importData: ImportData,\n results: TranspileResults,\n) => {\n const transformInput: TransformCssToEsmInput = {\n file: results.inputFilePath,\n input: results.code,\n tag: importData && importData.tag,\n tags: [...(compileOpts.tagsToTransform || importData?.tag)],\n addTagTransformers: compileOpts && compileOpts.additionalTagTransformers === true,\n encapsulation: importData && importData.encapsulation,\n mode: importData && importData.mode,\n sourceMap: compileOpts.sourceMap !== false,\n minify: false,\n autoprefixer: false,\n module: compileOpts.module,\n styleImportData: compileOpts.styleImportData,\n };\n return transformInput;\n};\n\nconst getTranspileConfigOpt = (value: any, validValues: Set, defaultValue: string) => {\n if (value === null || value === 'null') {\n return null;\n }\n value = isString(value) ? value.toLowerCase().trim() : null;\n if (validValues.has(value)) {\n return value;\n }\n return defaultValue;\n};\n\nconst VALID_EXPORT = new Set(['customelement', 'module']);\nconst VALID_METADATA = new Set(['compilerstatic', null]);\nconst VALID_MODULE = new Set(['cjs', 'esm']);\nconst VALID_PROXY = new Set(['defineproperty', null]);\nconst VALID_STYLE = new Set(['static']);\nconst VALID_STYLE_IMPORT_DATA = new Set(['queryparams']);\nconst VALID_TARGET = new Set(['latest', 'esnext', 'es2020', 'es2019', 'es2018', 'es2017', 'es2016', 'es2015', 'es5']);\n"
},
{
"path": "src/compiler/config/validate-config.ts",
"content": "import { createNodeLogger, createNodeSys } from '@sys-api-node';\nimport { buildError, buildWarn, isBoolean, isNumber, isString, sortBy } from '@utils';\n\nimport {\n ConfigBundle,\n ConfigExtras,\n Diagnostic,\n LoadConfigInit,\n LogLevel,\n UnvalidatedConfig,\n ValidatedConfig,\n} from '../../declarations';\nimport { setBooleanConfig } from './config-utils';\nimport {\n DEFAULT_DEV_MODE,\n DEFAULT_HASHED_FILENAME_LENGTH,\n MAX_HASHED_FILENAME_LENGTH,\n MIN_HASHED_FILENAME_LENGTH,\n} from './constants';\nimport { validateOutputTargets } from './outputs';\nimport { validateDevServer } from './validate-dev-server';\nimport { validateDocs } from './validate-docs';\nimport { validateHydrated } from './validate-hydrated';\nimport { validateDistNamespace } from './validate-namespace';\nimport { validateNamespace } from './validate-namespace';\nimport { validatePaths } from './validate-paths';\nimport { validatePlugins } from './validate-plugins';\nimport { validateRollupConfig } from './validate-rollup-config';\nimport { validateTesting } from './validate-testing';\nimport { validateWorkers } from './validate-workers';\n\n/**\n * Represents the results of validating a previously unvalidated configuration\n */\ntype ConfigValidationResults = {\n /**\n * The validated configuration, with well-known default values set if they weren't previously provided\n */\n config: ValidatedConfig;\n /**\n * A collection of errors and warnings that occurred during the configuration validation process\n */\n diagnostics: Diagnostic[];\n};\n\n/**\n * We never really want to re-run validation for a Stencil configuration.\n * Besides the cost of doing so, our validation pipeline is unfortunately not\n * idempotent, so we want to have a guarantee that even if we call\n * {@link validateConfig} in a few places that the same configuration object\n * won't be passed through multiple times. So we cache the result of our work\n * here.\n */\nlet CACHED_VALIDATED_CONFIG: ValidatedConfig | null = null;\n\n/**\n * Validate a Config object, ensuring that all its field are present and\n * consistent with our expectations. This function transforms an\n * {@link UnvalidatedConfig} to a {@link ValidatedConfig}.\n *\n * **NOTE**: this function _may_ return a previously-cached configuration\n * object. It will do so if the cached object is `===` to the one passed in.\n *\n * @param userConfig an unvalidated config that we've gotten from a user\n * @param bootstrapConfig the initial configuration provided by the user (or\n * generated by Stencil) used to bootstrap configuration loading and validation\n * @returns an object with config and diagnostics props\n */\nexport const validateConfig = (\n userConfig: UnvalidatedConfig = {},\n bootstrapConfig: LoadConfigInit,\n): ConfigValidationResults => {\n const diagnostics: Diagnostic[] = [];\n\n if (CACHED_VALIDATED_CONFIG !== null && CACHED_VALIDATED_CONFIG === userConfig) {\n // We've previously done the work to validate a Stencil config. Since our\n // overall validation pipeline is unfortunately not idempotent we do not\n // want to simply validate again. Leaving aside the performance\n // implications of needlessly repeating the validation, we don't want to do\n // certain operations multiple times.\n //\n // For the sake of correctness we check both that the cache is not null and\n // that it's the same object as the one passed in.\n return {\n config: userConfig as ValidatedConfig,\n diagnostics,\n };\n }\n\n const config = Object.assign({}, userConfig);\n\n const logger = bootstrapConfig.logger || config.logger || createNodeLogger();\n\n // flags _should_ be JSON safe here\n //\n // we access `'flags'` on validated config to avoid having to introduce an\n // import of the CLI module\n const flags: ValidatedConfig['flags'] = JSON.parse(JSON.stringify(config.flags || {}));\n\n // default level is 'info'\n let logLevel: LogLevel = 'info';\n if (flags.debug || flags.verbose) {\n logLevel = 'debug';\n } else if (flags.logLevel) {\n logLevel = flags.logLevel;\n }\n\n logger.setLevel(logLevel);\n\n let devMode = config.devMode ?? DEFAULT_DEV_MODE;\n if (flags.prod) {\n devMode = false;\n } else if (flags.dev) {\n devMode = true;\n } else if (!isBoolean(config.devMode)) {\n devMode = DEFAULT_DEV_MODE;\n }\n\n const hashFileNames = config.hashFileNames ?? !devMode;\n\n const validatedConfig: ValidatedConfig = {\n devServer: {}, // assign `devServer` before spreading `config`, in the event 'devServer' is not a key on `config`\n ...config,\n buildEs5: config.buildEs5 === true || (!devMode && config.buildEs5 === 'prod'),\n devMode,\n extras: config.extras || {},\n flags,\n generateExportMaps: isBoolean(config.generateExportMaps) ? config.generateExportMaps : false,\n hashFileNames,\n hashedFileNameLength: config.hashedFileNameLength ?? DEFAULT_HASHED_FILENAME_LENGTH,\n hydratedFlag: validateHydrated(config),\n logLevel,\n logger,\n minifyCss: config.minifyCss ?? !devMode,\n minifyJs: config.minifyJs ?? !devMode,\n outputTargets: config.outputTargets ?? [],\n rollupConfig: validateRollupConfig(config),\n sourceMap:\n config.sourceMap === true || (devMode && (config.sourceMap === 'dev' || typeof config.sourceMap === 'undefined')),\n sys: config.sys ?? bootstrapConfig.sys ?? createNodeSys({ logger }),\n testing: config.testing ?? {},\n docs: validateDocs(config, logger),\n transformAliasedImportPaths: isBoolean(userConfig.transformAliasedImportPaths)\n ? userConfig.transformAliasedImportPaths\n : true,\n validatePrimaryPackageOutputTarget: userConfig.validatePrimaryPackageOutputTarget ?? false,\n ...validateNamespace(config.namespace, config.fsNamespace, diagnostics),\n ...validatePaths(config),\n };\n\n validatedConfig.extras.lifecycleDOMEvents = !!validatedConfig.extras.lifecycleDOMEvents;\n validatedConfig.extras.scriptDataOpts = !!validatedConfig.extras.scriptDataOpts;\n validatedConfig.extras.initializeNextTick = !!validatedConfig.extras.initializeNextTick;\n validatedConfig.extras.tagNameTransform = !!validatedConfig.extras.tagNameTransform;\n validatedConfig.extras.additionalTagTransformers =\n validatedConfig.extras.additionalTagTransformers === true ||\n (!devMode && validatedConfig.extras.additionalTagTransformers === 'prod');\n validatedConfig.extras.addGlobalStyleToComponents = isBoolean(validatedConfig.extras.addGlobalStyleToComponents)\n ? validatedConfig.extras.addGlobalStyleToComponents\n : 'client';\n\n // TODO(STENCIL-914): remove when `experimentalSlotFixes` is the default behavior\n // If the user set `experimentalSlotFixes` and any individual slot fix flags to `false`, we need to log a warning\n // to the user that we will \"override\" the individual flags\n if (validatedConfig.extras.experimentalSlotFixes === true) {\n const possibleFlags: (keyof ConfigExtras)[] = [\n 'appendChildSlotFix',\n 'slotChildNodesFix',\n 'cloneNodeFix',\n 'scopedSlotTextContentFix',\n 'experimentalScopedSlotChanges',\n ];\n const conflictingFlags = possibleFlags.filter((flag) => validatedConfig.extras[flag] === false);\n if (conflictingFlags.length > 0) {\n const warning = buildError(diagnostics);\n warning.level = 'warn';\n warning.messageText = `If the 'experimentalSlotFixes' flag is enabled it will override any slot fix flags which are disabled. In particular, the following currently-disabled flags will be ignored: ${conflictingFlags.join(\n ', ',\n )}. Please update your Stencil config accordingly.`;\n }\n }\n\n // TODO(STENCIL-914): remove `experimentalSlotFixes` when it's the default behavior\n validatedConfig.extras.experimentalSlotFixes = !!validatedConfig.extras.experimentalSlotFixes;\n if (validatedConfig.extras.experimentalSlotFixes === true) {\n validatedConfig.extras.appendChildSlotFix = true;\n validatedConfig.extras.cloneNodeFix = true;\n validatedConfig.extras.slotChildNodesFix = true;\n validatedConfig.extras.scopedSlotTextContentFix = true;\n validatedConfig.extras.experimentalScopedSlotChanges = true;\n } else {\n validatedConfig.extras.appendChildSlotFix = !!validatedConfig.extras.appendChildSlotFix;\n validatedConfig.extras.cloneNodeFix = !!validatedConfig.extras.cloneNodeFix;\n validatedConfig.extras.slotChildNodesFix = !!validatedConfig.extras.slotChildNodesFix;\n validatedConfig.extras.scopedSlotTextContentFix = !!validatedConfig.extras.scopedSlotTextContentFix;\n // TODO(STENCIL-1086): remove this option when it's the default behavior\n validatedConfig.extras.experimentalScopedSlotChanges = !!validatedConfig.extras.experimentalScopedSlotChanges;\n }\n\n setBooleanConfig(validatedConfig, 'watch', 'watch', false);\n setBooleanConfig(validatedConfig, 'buildDocs', 'docs', !validatedConfig.devMode);\n setBooleanConfig(validatedConfig, 'buildDist', 'esm', !validatedConfig.devMode || !!validatedConfig.buildEs5);\n setBooleanConfig(validatedConfig, 'profile', 'profile', validatedConfig.devMode);\n setBooleanConfig(validatedConfig, 'writeLog', 'log', false);\n setBooleanConfig(validatedConfig, 'buildAppCore', null, true);\n setBooleanConfig(validatedConfig, 'autoprefixCss', null, validatedConfig.buildEs5);\n setBooleanConfig(validatedConfig, 'validateTypes', null, !validatedConfig._isTesting);\n setBooleanConfig(validatedConfig, 'allowInlineScripts', null, true);\n setBooleanConfig(validatedConfig, 'suppressReservedPublicNameWarnings', null, false);\n\n if (!isString(validatedConfig.taskQueue)) {\n validatedConfig.taskQueue = 'async';\n }\n\n // hash file names\n if (!isBoolean(validatedConfig.hashFileNames)) {\n validatedConfig.hashFileNames = !validatedConfig.devMode;\n }\n if (!isNumber(validatedConfig.hashedFileNameLength)) {\n validatedConfig.hashedFileNameLength = DEFAULT_HASHED_FILENAME_LENGTH;\n }\n if (validatedConfig.hashedFileNameLength < MIN_HASHED_FILENAME_LENGTH) {\n const err = buildError(diagnostics);\n err.messageText = `validatedConfig.hashedFileNameLength must be at least ${MIN_HASHED_FILENAME_LENGTH} characters`;\n }\n if (validatedConfig.hashedFileNameLength > MAX_HASHED_FILENAME_LENGTH) {\n const err = buildError(diagnostics);\n err.messageText = `validatedConfig.hashedFileNameLength cannot be more than ${MAX_HASHED_FILENAME_LENGTH} characters`;\n }\n if (!validatedConfig.env) {\n validatedConfig.env = {};\n }\n\n // outputTargets\n validateOutputTargets(validatedConfig, diagnostics);\n\n // plugins\n validatePlugins(validatedConfig, diagnostics);\n\n // dev server\n validatedConfig.devServer = validateDevServer(validatedConfig, diagnostics);\n\n // testing\n validateTesting(validatedConfig, diagnostics);\n\n // bundles\n if (Array.isArray(validatedConfig.bundles)) {\n validatedConfig.bundles = sortBy(validatedConfig.bundles, (a: ConfigBundle) => a.components.length);\n } else {\n validatedConfig.bundles = [];\n }\n\n // exclude components (tag list)\n if (!Array.isArray(validatedConfig.excludeComponents)) {\n validatedConfig.excludeComponents = [];\n }\n\n // validate how many workers we can use\n validateWorkers(validatedConfig);\n\n // default devInspector to whatever devMode is\n setBooleanConfig(validatedConfig, 'devInspector', null, validatedConfig.devMode);\n\n if (!validatedConfig._isTesting) {\n validateDistNamespace(validatedConfig, diagnostics);\n }\n\n setBooleanConfig(validatedConfig, 'enableCache', 'cache', true);\n\n if (!Array.isArray(validatedConfig.watchIgnoredRegex) && validatedConfig.watchIgnoredRegex != null) {\n validatedConfig.watchIgnoredRegex = [validatedConfig.watchIgnoredRegex];\n }\n validatedConfig.watchIgnoredRegex = ((validatedConfig.watchIgnoredRegex as RegExp[]) || []).reduce((arr, reg) => {\n if (reg instanceof RegExp) {\n arr.push(reg);\n }\n return arr;\n }, [] as RegExp[]);\n\n // TODO(STENCIL-1107): Remove this check. It'll be unneeded (and raise a compilation error when we build Stencil) once\n // this property is removed.\n if (validatedConfig.nodeResolve?.customResolveOptions) {\n const warn = buildWarn(diagnostics);\n // this message is particularly long - let the underlying logger implementation take responsibility for breaking it\n // up to fit in a terminal window\n warn.messageText = `nodeResolve.customResolveOptions is a deprecated option in a Stencil Configuration file. If you need this option, please open a new issue in the Stencil repository (https://github.com/stenciljs/core/issues/new/choose)`;\n }\n\n CACHED_VALIDATED_CONFIG = validatedConfig;\n\n return {\n config: validatedConfig,\n diagnostics,\n };\n};\n"
},
{
"path": "src/compiler/config/validate-copy.ts",
"content": "import { unique } from '@utils';\n\nimport type * as d from '../../declarations';\n\n/**\n * Validate a series of {@link d.CopyTask}s\n * @param copy the copy tasks to validate, or a boolean to specify if copy tasks are enabled\n * @param defaultCopy default copy tasks to add to the returned validated list if not present in the first argument\n * @returns the validated copy tasks\n */\nexport const validateCopy = (\n copy: d.CopyTask[] | boolean | null | undefined,\n defaultCopy: d.CopyTask[] = [],\n): d.CopyTask[] => {\n if (copy === null || copy === false) {\n return [];\n }\n if (!Array.isArray(copy)) {\n copy = [];\n }\n copy = copy.slice();\n for (const task of defaultCopy) {\n if (copy.every((t) => t.src !== task.src)) {\n copy.push(task);\n }\n }\n return unique(copy, (task) => `${task.src}:${task.dest}:${task.keepDirStructure}`);\n};\n"
},
{
"path": "src/compiler/config/validate-dev-server.ts",
"content": "import { buildError, isBoolean, isNumber, isOutputTargetWww, isString, join, normalizePath } from '@utils';\nimport { isAbsolute } from 'path';\n\nimport type * as d from '../../declarations';\n\nexport const validateDevServer = (config: d.ValidatedConfig, diagnostics: d.Diagnostic[]): d.DevServerConfig => {\n if ((config.devServer === null || (config.devServer as any)) === false) {\n return {};\n }\n\n const { flags } = config;\n const devServer = { ...config.devServer };\n\n if (flags.address && isString(flags.address)) {\n devServer.address = flags.address;\n } else if (!isString(devServer.address)) {\n devServer.address = '0.0.0.0';\n }\n\n // default to http for local dev\n let addressProtocol: 'http' | 'https' = 'http';\n if (devServer.address.toLowerCase().startsWith('http://')) {\n devServer.address = devServer.address.substring(7);\n addressProtocol = 'http';\n } else if (devServer.address.toLowerCase().startsWith('https://')) {\n devServer.address = devServer.address.substring(8);\n addressProtocol = 'https';\n }\n\n devServer.address = devServer.address.split('/')[0];\n\n // Validate \"ping\" route option\n if (devServer.pingRoute !== null) {\n let pingRoute = isString(devServer.pingRoute) ? devServer.pingRoute : '/ping';\n if (!pingRoute.startsWith('/')) {\n pingRoute = `/${pingRoute}`;\n }\n\n devServer.pingRoute = pingRoute;\n }\n\n // split on `:` to get the domain and the (possibly present) port\n // separately. we've already sliced off the protocol (if present) above\n // so we can safely split on `:` here.\n const addressSplit = devServer.address.split(':');\n\n const isLocalhost = addressSplit[0] === 'localhost' || !isNaN(addressSplit[0].split('.')[0] as any);\n\n // if localhost we use 3333 as a default port\n let addressPort: number | undefined = isLocalhost ? 3333 : undefined;\n\n if (addressSplit.length > 1) {\n if (!isNaN(addressSplit[1] as any)) {\n devServer.address = addressSplit[0];\n addressPort = parseInt(addressSplit[1], 10);\n }\n }\n\n if (isNumber(flags.port)) {\n devServer.port = flags.port;\n } else if (devServer.port !== null && !isNumber(devServer.port)) {\n if (isNumber(addressPort)) {\n devServer.port = addressPort;\n }\n }\n\n if (devServer.reloadStrategy === undefined) {\n devServer.reloadStrategy = 'hmr';\n } else if (\n devServer.reloadStrategy !== 'hmr' &&\n devServer.reloadStrategy !== 'pageReload' &&\n devServer.reloadStrategy !== null\n ) {\n const err = buildError(diagnostics);\n err.messageText = `Invalid devServer reloadStrategy \"${devServer.reloadStrategy}\". Valid configs include \"hmr\", \"pageReload\" and null.`;\n }\n\n if (!isBoolean(devServer.gzip)) {\n devServer.gzip = true;\n }\n\n if (!isBoolean(devServer.openBrowser)) {\n devServer.openBrowser = true;\n }\n\n if (!isBoolean(devServer.websocket)) {\n devServer.websocket = true;\n }\n\n if (!isBoolean(devServer.strictPort)) {\n devServer.strictPort = false;\n }\n\n if (flags.ssr) {\n devServer.ssr = true;\n } else {\n devServer.ssr = !!devServer.ssr;\n }\n\n if (devServer.ssr) {\n const wwwOutput = (config.outputTargets ?? []).find(isOutputTargetWww);\n devServer.prerenderConfig = wwwOutput?.prerenderConfig;\n }\n\n if (isString(config.srcIndexHtml)) {\n devServer.srcIndexHtml = normalizePath(config.srcIndexHtml);\n }\n\n if (devServer.protocol !== 'http' && devServer.protocol !== 'https') {\n devServer.protocol = devServer.https ? 'https' : addressProtocol ? addressProtocol : 'http';\n }\n\n if (devServer.historyApiFallback !== null) {\n if (Array.isArray(devServer.historyApiFallback) || typeof devServer.historyApiFallback !== 'object') {\n devServer.historyApiFallback = {};\n }\n\n if (!isString(devServer.historyApiFallback.index)) {\n devServer.historyApiFallback.index = 'index.html';\n }\n\n if (!isBoolean(devServer.historyApiFallback.disableDotRule)) {\n devServer.historyApiFallback.disableDotRule = false;\n }\n }\n\n if (flags.open === false) {\n devServer.openBrowser = false;\n } else if (flags.prerender && !config.watch) {\n devServer.openBrowser = false;\n }\n\n let serveDir: string;\n let basePath: string;\n const wwwOutputTarget = (config.outputTargets ?? []).find(isOutputTargetWww);\n\n if (wwwOutputTarget) {\n const baseUrl = new URL(wwwOutputTarget.baseUrl ?? '', 'http://config.stenciljs.com');\n basePath = baseUrl.pathname;\n serveDir = wwwOutputTarget.appDir ?? '';\n } else {\n basePath = '';\n serveDir = config.rootDir ?? '';\n }\n\n if (!isString(basePath) || basePath.trim() === '') {\n basePath = `/`;\n }\n\n basePath = normalizePath(basePath);\n\n if (!basePath.startsWith('/')) {\n basePath = '/' + basePath;\n }\n\n if (!basePath.endsWith('/')) {\n basePath += '/';\n }\n\n if (!isBoolean(devServer.logRequests)) {\n devServer.logRequests = config.logLevel === 'debug';\n }\n\n if (!isString(devServer.root)) {\n devServer.root = serveDir;\n }\n\n if (!isString(devServer.basePath)) {\n devServer.basePath = basePath;\n }\n\n if (isString((devServer as any).baseUrl)) {\n const err = buildError(diagnostics);\n err.messageText = `devServer config \"baseUrl\" has been renamed to \"basePath\", and should not include a domain or protocol.`;\n }\n\n if (!isAbsolute(devServer.root)) {\n devServer.root = join(config.rootDir as string, devServer.root);\n }\n devServer.root = normalizePath(devServer.root);\n\n if (devServer.excludeHmr) {\n if (!Array.isArray(devServer.excludeHmr)) {\n const err = buildError(diagnostics);\n err.messageText = `dev server excludeHmr must be an array of glob strings`;\n }\n } else {\n devServer.excludeHmr = [];\n }\n\n if (!config.devMode || config.buildEs5) {\n devServer.experimentalDevModules = false;\n } else {\n devServer.experimentalDevModules = !!devServer.experimentalDevModules;\n }\n\n return devServer;\n};\n"
},
{
"path": "src/compiler/config/validate-docs.ts",
"content": "import * as d from '../../declarations';\nimport { UnvalidatedConfig } from '../../declarations';\nimport { isHexColor } from '../docs/readme/docs-util';\nimport { DEFAULT_TARGET_COMPONENT_STYLES } from './constants';\n\n/**\n * Validate the `.docs` property on the supplied config object and\n * return a properly-validated value.\n *\n * @param config the configuration we're examining\n * @param logger the logger that will be set on the config\n * @returns a suitable/default value for the docs property\n */\nexport const validateDocs = (config: UnvalidatedConfig, logger: d.Logger): d.ValidatedConfig['docs'] => {\n const { background: defaultBackground, textColor: defaultTextColor } = DEFAULT_TARGET_COMPONENT_STYLES;\n\n let { background = defaultBackground, textColor = defaultTextColor } =\n config.docs?.markdown?.targetComponent ?? DEFAULT_TARGET_COMPONENT_STYLES;\n\n if (!isHexColor(background)) {\n logger.warn(\n `'${background}' is not a valid hex color. The default value for diagram backgrounds ('${defaultBackground}') will be used.`,\n );\n background = defaultBackground;\n }\n\n if (!isHexColor(textColor)) {\n logger.warn(\n `'${textColor}' is not a valid hex color. The default value for diagram text ('${defaultTextColor}') will be used.`,\n );\n textColor = defaultTextColor;\n }\n\n return {\n markdown: {\n targetComponent: {\n background,\n textColor,\n },\n },\n };\n};\n"
},
{
"path": "src/compiler/config/validate-hydrated.ts",
"content": "import { isString } from '@utils';\n\nimport { HydratedFlag, UnvalidatedConfig } from '../../declarations';\n\n/**\n * Validate the `.hydratedFlag` property on the supplied config object and\n * return a properly-validated value.\n *\n * @param config the configuration we're examining\n * @returns a suitable value for the hydratedFlag property\n */\nexport const validateHydrated = (config: UnvalidatedConfig): HydratedFlag | null => {\n /**\n * If `config.hydratedFlag` is set to `null` that is an explicit signal that we\n * should _not_ create a default configuration when validating and should instead\n * just return `null`. It may also have been set to `false`; this is an invalid\n * value as far as the type system is concerned, but users may ignore this.\n *\n * See {@link HydratedFlag} for more details.\n */\n if (config.hydratedFlag === null || (config.hydratedFlag as unknown as boolean) === false) {\n return null;\n }\n\n // Here we start building up a default config since `.hydratedFlag` wasn't set to\n // `null` on the provided config.\n const hydratedFlag: HydratedFlag = { ...(config.hydratedFlag ?? {}) };\n\n if (!isString(hydratedFlag.name) || hydratedFlag.property === '') {\n hydratedFlag.name = `hydrated`;\n }\n\n if (hydratedFlag.selector === 'attribute') {\n hydratedFlag.selector = `attribute`;\n } else {\n hydratedFlag.selector = `class`;\n }\n\n if (!isString(hydratedFlag.property) || hydratedFlag.property === '') {\n hydratedFlag.property = `visibility`;\n }\n\n if (!isString(hydratedFlag.initialValue) && hydratedFlag.initialValue !== null) {\n hydratedFlag.initialValue = `hidden`;\n }\n\n if (!isString(hydratedFlag.hydratedValue) && hydratedFlag.initialValue !== null) {\n hydratedFlag.hydratedValue = `inherit`;\n }\n\n return hydratedFlag;\n};\n"
},
{
"path": "src/compiler/config/validate-namespace.ts",
"content": "import { buildError, dashToPascalCase, isOutputTargetDist, isString } from '@utils';\n\nimport type * as d from '../../declarations';\nimport { DEFAULT_NAMESPACE } from './constants';\n\n/**\n * Ensures that the `namespace` and `fsNamespace` properties on a project's\n * Stencil config are valid strings. A valid namespace means:\n * - at least 3 characters\n * - cannot start with a number or dash\n * - cannot end with a dash\n * - must only contain alphanumeric, dash, and dollar sign characters\n *\n * If any conditions are not met, a diagnostic is added to the provided array.\n *\n * If a namespace is not provided, the default value is `App`.\n *\n * @param namespace The namespace to validate\n * @param fsNamespace The fsNamespace to validate\n * @param diagnostics The array of diagnostics to add to if the namespace is invalid\n * @returns The validated namespace and fsNamespace\n */\nexport const validateNamespace = (\n namespace: string | undefined,\n fsNamespace: string | undefined,\n diagnostics: d.Diagnostic[],\n) => {\n namespace = isString(namespace) ? namespace : DEFAULT_NAMESPACE;\n namespace = namespace.trim();\n\n const invalidNamespaceChars = namespace.replace(/(\\w)|(\\-)|(\\$)/g, '');\n if (invalidNamespaceChars !== '') {\n const err = buildError(diagnostics);\n err.messageText = `Namespace \"${namespace}\" contains invalid characters: ${invalidNamespaceChars}`;\n }\n if (namespace.length < 3) {\n const err = buildError(diagnostics);\n err.messageText = `Namespace \"${namespace}\" must be at least 3 characters`;\n }\n if (/^\\d+$/.test(namespace.charAt(0))) {\n const err = buildError(diagnostics);\n err.messageText = `Namespace \"${namespace}\" cannot have a number for the first character`;\n }\n if (namespace.charAt(0) === '-') {\n const err = buildError(diagnostics);\n err.messageText = `Namespace \"${namespace}\" cannot have a dash for the first character`;\n }\n if (namespace.charAt(namespace.length - 1) === '-') {\n const err = buildError(diagnostics);\n err.messageText = `Namespace \"${namespace}\" cannot have a dash for the last character`;\n }\n\n // the file system namespace is the one\n // used in filenames and seen in the url\n if (!isString(fsNamespace)) {\n fsNamespace = namespace.toLowerCase().trim();\n }\n\n if (namespace.includes('-')) {\n // convert to PascalCase\n namespace = dashToPascalCase(namespace);\n }\n\n return { namespace, fsNamespace };\n};\n\nexport const validateDistNamespace = (config: d.UnvalidatedConfig, diagnostics: d.Diagnostic[]) => {\n const hasDist = (config.outputTargets ?? []).some(isOutputTargetDist);\n if (hasDist) {\n if (!isString(config.namespace) || config.namespace.toLowerCase() === 'app') {\n const err = buildError(diagnostics);\n err.messageText = `When generating a distribution it is recommended to choose a unique namespace rather than the default setting \"App\". Please updated the \"namespace\" config property within the stencil config.`;\n }\n }\n};\n"
},
{
"path": "src/compiler/config/validate-paths.ts",
"content": "import { join, normalizePath } from '@utils';\nimport { isAbsolute } from 'path';\n\nimport type * as d from '../../declarations';\n\n/**\n * The paths validated in this module. These fields can be incorporated into a\n * {@link d.ValidatedConfig} object.\n */\ninterface ConfigPaths {\n rootDir: string;\n srcDir: string;\n packageJsonFilePath: string;\n cacheDir: string;\n srcIndexHtml: string;\n globalScript?: string;\n globalStyle?: string;\n buildLogFilePath?: string;\n}\n\n/**\n * Do logical-level validation (as opposed to type-level validation)\n * for various properties in the user-supplied config which represent\n * filesystem paths.\n *\n * @param config a validated user-supplied configuration\n * @returns an object holding the validated paths\n */\nexport const validatePaths = (config: d.Config): ConfigPaths => {\n const rootDir = typeof config.rootDir !== 'string' ? '/' : config.rootDir;\n\n let srcDir = typeof config.srcDir !== 'string' ? DEFAULT_SRC_DIR : config.srcDir;\n\n if (!isAbsolute(srcDir)) {\n srcDir = join(rootDir, srcDir);\n }\n\n let cacheDir = typeof config.cacheDir !== 'string' ? DEFAULT_CACHE_DIR : config.cacheDir;\n\n if (!isAbsolute(cacheDir)) {\n cacheDir = join(rootDir, cacheDir);\n } else {\n cacheDir = normalizePath(cacheDir);\n }\n\n let srcIndexHtml = typeof config.srcIndexHtml !== 'string' ? join(srcDir, DEFAULT_INDEX_HTML) : config.srcIndexHtml;\n\n if (!isAbsolute(srcIndexHtml)) {\n srcIndexHtml = join(rootDir, srcIndexHtml);\n }\n\n const packageJsonFilePath = join(rootDir, 'package.json');\n\n const validatedPaths: ConfigPaths = {\n rootDir,\n srcDir,\n cacheDir,\n srcIndexHtml,\n packageJsonFilePath,\n };\n\n if (typeof config.globalScript === 'string' && !isAbsolute(config.globalScript)) {\n validatedPaths.globalScript = join(rootDir, config.globalScript);\n }\n\n if (typeof config.globalStyle === 'string' && !isAbsolute(config.globalStyle)) {\n validatedPaths.globalStyle = join(rootDir, config.globalStyle);\n }\n\n if (config.writeLog) {\n validatedPaths.buildLogFilePath =\n typeof config.buildLogFilePath === 'string' ? config.buildLogFilePath : DEFAULT_BUILD_LOG_FILE_NAME;\n\n if (!isAbsolute(validatedPaths.buildLogFilePath)) {\n validatedPaths.buildLogFilePath = join(rootDir, config.buildLogFilePath);\n }\n }\n\n return validatedPaths;\n};\n\nconst DEFAULT_BUILD_LOG_FILE_NAME = 'stencil-build.log';\nconst DEFAULT_CACHE_DIR = '.stencil';\nconst DEFAULT_INDEX_HTML = 'index.html';\nconst DEFAULT_SRC_DIR = 'src';\n"
},
{
"path": "src/compiler/config/validate-plugins.ts",
"content": "import { buildWarn } from '@utils';\n\nimport type * as d from '../../declarations';\n\nexport const validatePlugins = (config: d.UnvalidatedConfig, diagnostics: d.Diagnostic[]) => {\n const userPlugins = config.plugins;\n\n if (!config.rollupPlugins) {\n config.rollupPlugins = {};\n }\n if (!Array.isArray(userPlugins)) {\n config.plugins = [];\n return;\n }\n\n const rollupPlugins = userPlugins.filter((plugin) => {\n return !!(plugin && typeof plugin === 'object' && !plugin.pluginType);\n });\n\n const hasResolveNode = rollupPlugins.some((p) => p.name === 'node-resolve');\n const hasCommonjs = rollupPlugins.some((p) => p.name === 'commonjs');\n\n if (hasCommonjs) {\n const warn = buildWarn(diagnostics);\n warn.messageText = `Stencil already uses \"@rollup/plugin-commonjs\", please remove it from your \"stencil.config.ts\" plugins.\n You can configure the commonjs settings using the \"commonjs\" property in \"stencil.config.ts`;\n }\n\n if (hasResolveNode) {\n const warn = buildWarn(diagnostics);\n warn.messageText = `Stencil already uses \"@rollup/plugin-commonjs\", please remove it from your \"stencil.config.ts\" plugins.\n You can configure the commonjs settings using the \"commonjs\" property in \"stencil.config.ts`;\n }\n\n config.rollupPlugins.before = [\n ...(config.rollupPlugins.before || []),\n ...rollupPlugins.filter(({ name }) => name !== 'node-resolve' && name !== 'commonjs'),\n ];\n\n config.plugins = userPlugins.filter((plugin) => {\n return !!(plugin && typeof plugin === 'object' && plugin.pluginType);\n });\n};\n"
},
{
"path": "src/compiler/config/validate-prerender.ts",
"content": "import { buildError, isString, join, normalizePath } from '@utils';\nimport { isAbsolute } from 'path';\n\nimport type * as d from '../../declarations';\n\nexport const validatePrerender = (\n config: d.ValidatedConfig,\n diagnostics: d.Diagnostic[],\n outputTarget: d.OutputTargetWww,\n) => {\n if (!config.flags.ssr && !config.flags.prerender && config.flags.task !== 'prerender') {\n return;\n }\n\n outputTarget.baseUrl = normalizePath(outputTarget.baseUrl);\n\n if (!outputTarget.baseUrl.startsWith('http://') && !outputTarget.baseUrl.startsWith('https://')) {\n const err = buildError(diagnostics);\n err.messageText = `When prerendering, the \"baseUrl\" output target config must be a full URL and start with either \"http://\" or \"https://\". The config can be updated in the \"www\" output target within the stencil config.`;\n }\n\n try {\n new URL(outputTarget.baseUrl);\n } catch (e) {\n const err = buildError(diagnostics);\n err.messageText = `invalid \"baseUrl\": ${e}`;\n }\n\n if (!outputTarget.baseUrl.endsWith('/')) {\n outputTarget.baseUrl += '/';\n }\n\n if (isString(outputTarget.prerenderConfig)) {\n if (!isAbsolute(outputTarget.prerenderConfig)) {\n outputTarget.prerenderConfig = join(config.rootDir, outputTarget.prerenderConfig);\n }\n }\n};\n"
},
{
"path": "src/compiler/config/validate-rollup-config.ts",
"content": "import { isObject, pluck } from '@utils';\n\nimport type * as d from '../../declarations';\n\n/**\n * Ensure that a valid baseline rollup configuration is set on the validated\n * config.\n *\n * If a config is present this will return a new config based on the user\n * supplied one.\n *\n * If no config is present, this will return a default config.\n *\n * @param config a validated user-supplied configuration object\n * @returns a validated rollup configuration\n */\nexport const validateRollupConfig = (config: d.Config): d.RollupConfig => {\n let cleanRollupConfig = { ...DEFAULT_ROLLUP_CONFIG };\n\n const rollupConfig = config.rollupConfig;\n\n if (!rollupConfig || !isObject(rollupConfig)) {\n return cleanRollupConfig;\n }\n\n if (rollupConfig.inputOptions && isObject(rollupConfig.inputOptions)) {\n cleanRollupConfig = {\n ...cleanRollupConfig,\n inputOptions: pluck(rollupConfig.inputOptions, [\n 'context',\n 'moduleContext',\n 'treeshake',\n 'external',\n 'maxParallelFileOps',\n ]),\n };\n }\n\n if (rollupConfig.outputOptions && isObject(rollupConfig.outputOptions)) {\n cleanRollupConfig = {\n ...cleanRollupConfig,\n outputOptions: pluck(rollupConfig.outputOptions, ['globals']),\n };\n }\n\n return cleanRollupConfig;\n};\n\nconst DEFAULT_ROLLUP_CONFIG: d.RollupConfig = {\n inputOptions: {},\n outputOptions: {},\n};\n"
},
{
"path": "src/compiler/config/validate-service-worker.ts",
"content": "import { isString, join } from '@utils';\nimport { isAbsolute } from 'path';\n\nimport type * as d from '../../declarations';\n\n/**\n * Validate that a service worker configuration is valid, if it is present and\n * accounted for.\n *\n * Note that our service worker configuration / support is based on\n * Workbox, a package for automatically generating Service Workers to cache\n * assets on the client. More here: https://developer.chrome.com/docs/workbox/\n *\n * This function first checks that the service worker config set on the\n * supplied `OutputTarget` is not empty and that we are not currently in\n * development mode. In those cases it will early return.\n *\n * If we do find a service worker configuration we do some validation to ensure\n * that things are set up correctly.\n *\n * @param config the current, validated configuration\n * @param outputTarget the `www` outputTarget whose service worker\n * configuration we want to validate. **Note**: the `.serviceWorker` object\n * _will be mutated_ if it is present.\n */\nexport const validateServiceWorker = (config: d.ValidatedConfig, outputTarget: d.OutputTargetWww): void => {\n if (outputTarget.serviceWorker === false) {\n return;\n }\n if (config.devMode && !config.flags.serviceWorker) {\n outputTarget.serviceWorker = null;\n return;\n }\n\n if (outputTarget.serviceWorker === null) {\n outputTarget.serviceWorker = null;\n return;\n }\n\n if (!outputTarget.serviceWorker && config.devMode) {\n outputTarget.serviceWorker = null;\n return;\n }\n\n const globDirectory =\n typeof outputTarget.serviceWorker?.globDirectory === 'string'\n ? outputTarget.serviceWorker.globDirectory\n : outputTarget.appDir;\n\n outputTarget.serviceWorker = {\n ...outputTarget.serviceWorker,\n globDirectory,\n swDest: isString(outputTarget.serviceWorker?.swDest)\n ? outputTarget.serviceWorker.swDest\n : join(outputTarget.appDir ?? '', DEFAULT_FILENAME),\n };\n\n if (!Array.isArray(outputTarget.serviceWorker.globPatterns)) {\n if (typeof outputTarget.serviceWorker.globPatterns === 'string') {\n outputTarget.serviceWorker.globPatterns = [outputTarget.serviceWorker.globPatterns];\n } else if (typeof outputTarget.serviceWorker.globPatterns !== 'string') {\n outputTarget.serviceWorker.globPatterns = DEFAULT_GLOB_PATTERNS.slice();\n }\n }\n\n if (typeof outputTarget.serviceWorker.globIgnores === 'string') {\n outputTarget.serviceWorker.globIgnores = [outputTarget.serviceWorker.globIgnores];\n }\n\n outputTarget.serviceWorker.globIgnores = outputTarget.serviceWorker.globIgnores || [];\n\n addGlobIgnores(config, outputTarget.serviceWorker.globIgnores);\n\n outputTarget.serviceWorker.dontCacheBustURLsMatching = /p-\\w{8}/;\n\n if (isString(outputTarget.serviceWorker.swSrc) && !isAbsolute(outputTarget.serviceWorker.swSrc)) {\n outputTarget.serviceWorker.swSrc = join(config.rootDir, outputTarget.serviceWorker.swSrc);\n }\n\n if (isString(outputTarget.serviceWorker.swDest) && !isAbsolute(outputTarget.serviceWorker.swDest)) {\n outputTarget.serviceWorker.swDest = join(outputTarget.appDir ?? '', outputTarget.serviceWorker.swDest);\n }\n};\n\n/**\n * Add file glob patterns to the `globIgnores` for files we don't want to cache\n * with the service worker.\n *\n * @param config the current, validated configuration\n * @param globIgnores list of file ignore patterns. **Note**: will be mutated.\n */\nconst addGlobIgnores = (config: d.ValidatedConfig, globIgnores: string[]) => {\n globIgnores.push(\n `**/host.config.json`, // the filename of the host configuration\n `**/*.system.entry.js`,\n `**/*.system.js`,\n `**/${config.fsNamespace}.js`,\n `**/${config.fsNamespace}.esm.js`,\n `**/${config.fsNamespace}.css`,\n );\n};\n\nconst DEFAULT_GLOB_PATTERNS = ['*.html', '**/*.{js,css,json}'];\n\nconst DEFAULT_FILENAME = 'sw.js';\n"
},
{
"path": "src/compiler/config/validate-testing.ts",
"content": "import { buildError, isOutputTargetDist, isOutputTargetWww, isString, join, normalizePath } from '@utils';\nimport { basename, dirname, isAbsolute } from 'path';\n\nimport type * as d from '../../declarations';\nimport { isLocalModule } from '../sys/resolve/resolve-utils';\n\nexport const validateTesting = (config: d.ValidatedConfig, diagnostics: d.Diagnostic[]) => {\n const testing = (config.testing = Object.assign({}, config.testing || {}));\n\n if (!config.flags.e2e && !config.flags.spec) {\n return;\n }\n\n let configPathDir = config.configPath!;\n if (isString(configPathDir)) {\n if (basename(configPathDir).includes('.')) {\n configPathDir = dirname(configPathDir);\n }\n } else {\n configPathDir = config.rootDir!;\n }\n\n if (typeof config.flags.headless === 'boolean' || config.flags.headless === 'shell') {\n testing.browserHeadless = config.flags.headless;\n } else if (typeof testing.browserHeadless !== 'boolean' && testing.browserHeadless !== 'shell') {\n testing.browserHeadless = 'shell';\n }\n\n /**\n * Using the deprecated `browserHeadless: true` flag causes Chrome to crash when running tests.\n * Ensure users don't run into this by throwing a deliberate error.\n */\n if (typeof testing.browserHeadless === 'boolean' && testing.browserHeadless) {\n throw new Error(`Setting \"browserHeadless\" config to \\`true\\` is not supported anymore, please set it to \"shell\"!`);\n }\n\n if (!testing.browserWaitUntil) {\n testing.browserWaitUntil = 'load';\n }\n\n /**\n * ensure we always test on stable Chrome\n */\n if (!isString(testing.browserChannel)) {\n testing.browserChannel = 'chrome';\n }\n\n testing.browserArgs = testing.browserArgs || [];\n addTestingConfigOption(testing.browserArgs, '--font-render-hinting=medium');\n addTestingConfigOption(testing.browserArgs, '--incognito');\n if (config.flags.ci || process.env.CI) {\n addTestingConfigOption(testing.browserArgs, '--no-sandbox');\n addTestingConfigOption(testing.browserArgs, '--disable-setuid-sandbox');\n addTestingConfigOption(testing.browserArgs, '--disable-dev-shm-usage');\n testing.browserHeadless = 'shell';\n } else if (config.flags.devtools || testing.browserDevtools) {\n testing.browserDevtools = true;\n testing.browserHeadless = false;\n }\n\n if (typeof testing.rootDir === 'string') {\n if (!isAbsolute(testing.rootDir)) {\n testing.rootDir = join(config.rootDir!, testing.rootDir);\n }\n } else {\n testing.rootDir = config.rootDir;\n }\n\n if (typeof config.flags.screenshotConnector === 'string') {\n testing.screenshotConnector = config.flags.screenshotConnector;\n }\n\n if (typeof testing.screenshotConnector === 'string') {\n if (!isAbsolute(testing.screenshotConnector)) {\n testing.screenshotConnector = join(config.rootDir!, testing.screenshotConnector);\n } else {\n testing.screenshotConnector = normalizePath(testing.screenshotConnector);\n }\n } else {\n testing.screenshotConnector = join(\n config.sys!.getCompilerExecutingPath(),\n '..',\n '..',\n 'screenshot',\n 'local-connector.js',\n );\n }\n\n /**\n * We only allow numbers or null for the screenshotTimeout, so if we detect anything\n * else, we set it to null.\n */\n if (typeof testing.screenshotTimeout != 'number') {\n testing.screenshotTimeout = null;\n }\n\n if (!Array.isArray(testing.testPathIgnorePatterns)) {\n testing.testPathIgnorePatterns = DEFAULT_IGNORE_PATTERNS.map((ignorePattern) => {\n return join(testing.rootDir!, ignorePattern);\n });\n\n (config.outputTargets ?? [])\n .filter(\n (o): o is d.OutputTargetWww | d.OutputTargetDist => (isOutputTargetDist(o) || isOutputTargetWww(o)) && !!o.dir,\n )\n .forEach((outputTarget) => {\n testing.testPathIgnorePatterns?.push(outputTarget.dir!);\n });\n }\n\n if (typeof testing.preset !== 'string') {\n testing.preset = join(config.sys!.getCompilerExecutingPath(), '..', '..', 'testing');\n } else if (!isAbsolute(testing.preset)) {\n testing.preset = join(configPathDir, testing.preset);\n }\n\n if (!Array.isArray(testing.setupFilesAfterEnv)) {\n testing.setupFilesAfterEnv = [];\n }\n\n testing.setupFilesAfterEnv.unshift(\n join(config.sys!.getCompilerExecutingPath(), '..', '..', 'testing', 'jest-setuptestframework.js'),\n );\n\n if (isString(testing.testEnvironment)) {\n if (!isAbsolute(testing.testEnvironment) && isLocalModule(testing.testEnvironment)) {\n testing.testEnvironment = join(configPathDir, testing.testEnvironment);\n }\n }\n\n if (typeof testing.allowableMismatchedPixels === 'number') {\n if (testing.allowableMismatchedPixels < 0) {\n const err = buildError(diagnostics);\n err.messageText = `allowableMismatchedPixels must be a value that is 0 or greater`;\n }\n } else {\n testing.allowableMismatchedPixels = DEFAULT_ALLOWABLE_MISMATCHED_PIXELS;\n }\n\n if (typeof testing.allowableMismatchedRatio === 'number') {\n if (testing.allowableMismatchedRatio < 0 || testing.allowableMismatchedRatio > 1) {\n const err = buildError(diagnostics);\n err.messageText = `allowableMismatchedRatio must be a value ranging from 0 to 1`;\n }\n }\n\n if (typeof testing.pixelmatchThreshold === 'number') {\n if (testing.pixelmatchThreshold < 0 || testing.pixelmatchThreshold > 1) {\n const err = buildError(diagnostics);\n err.messageText = `pixelmatchThreshold must be a value ranging from 0 to 1`;\n }\n } else {\n testing.pixelmatchThreshold = DEFAULT_PIXEL_MATCH_THRESHOLD;\n }\n\n if (testing.testRegex === undefined) {\n /**\n * The test regex covers cases of:\n * - files under a `__tests__` directory\n * - the case where a test file has a name such as `test.ts`, `spec.ts` or `e2e.ts`.\n * - these files can use any of the following file extensions: .ts, .tsx, .js, .jsx.\n * - this regex only handles the entire path of a file, e.g. `/some/path/e2e.ts`\n * - the case where a test file ends with `.test.ts`, `.spec.ts`, or `.e2e.ts`.\n * - these files can use any of the following file extensions: .ts, .tsx, .js, .jsx.\n * - this regex case shall match file names such as `my-cmp.spec.ts`, `test.spec.ts`\n * - this regex case shall not match file names such as `attest.ts`, `bespec.ts`\n */\n testing.testRegex = ['(/__tests__/.*|(\\\\.|/)(test|spec|e2e))\\\\.[jt]sx?$'];\n } else if (typeof testing.testRegex === 'string') {\n testing.testRegex = [testing.testRegex];\n }\n\n if (Array.isArray(testing.testMatch)) {\n delete testing.testRegex;\n } else if (typeof testing.testRegex === 'string') {\n delete testing.testMatch;\n }\n\n if (typeof testing.runner !== 'string') {\n testing.runner = join(config.sys!.getCompilerExecutingPath(), '..', '..', 'testing', 'jest-runner.js');\n }\n\n if (typeof testing.waitBeforeScreenshot === 'number') {\n if (testing.waitBeforeScreenshot < 0) {\n const err = buildError(diagnostics);\n err.messageText = `waitBeforeScreenshot must be a value that is 0 or greater`;\n }\n } else {\n testing.waitBeforeScreenshot = 10;\n }\n\n if (!Array.isArray(testing.emulate) || testing.emulate.length === 0) {\n testing.emulate = [\n {\n userAgent: 'default',\n viewport: {\n width: 600,\n height: 600,\n deviceScaleFactor: 1,\n isMobile: false,\n hasTouch: false,\n isLandscape: false,\n },\n },\n ];\n }\n};\n\nconst addTestingConfigOption = (setArray: string[], option: string) => {\n if (!setArray.includes(option)) {\n setArray.push(option);\n }\n};\n\nconst DEFAULT_ALLOWABLE_MISMATCHED_PIXELS = 100;\nconst DEFAULT_PIXEL_MATCH_THRESHOLD = 0.1;\nconst DEFAULT_IGNORE_PATTERNS = ['.vscode', '.stencil', 'node_modules'];\n"
},
{
"path": "src/compiler/config/validate-workers.ts",
"content": "import type * as d from '../../declarations';\n\nexport const validateWorkers = (config: d.ValidatedConfig) => {\n if (typeof config.maxConcurrentWorkers !== 'number') {\n config.maxConcurrentWorkers = 8;\n }\n\n if (typeof config.flags.maxWorkers === 'number') {\n config.maxConcurrentWorkers = config.flags.maxWorkers;\n } else if (config.flags.ci) {\n config.maxConcurrentWorkers = 4;\n }\n\n config.maxConcurrentWorkers = Math.max(Math.min(config.maxConcurrentWorkers, 16), 0);\n\n if (config.devServer) {\n config.devServer.worker = config.maxConcurrentWorkers > 0;\n }\n};\n"
},
{
"path": "src/compiler/docs/cem/index.ts",
"content": "import { dashToPascalCase, isOutputTargetDocsCustomElementsManifest } from '@utils';\n\nimport type * as d from '../../../declarations';\n\n/**\n * Generate Custom Elements Manifest (custom-elements.json) output\n * conforming to the Custom Elements Manifest specification.\n * @see https://github.com/webcomponents/custom-elements-manifest\n *\n * @param compilerCtx the current compiler context\n * @param docsData the generated docs data from Stencil components\n * @param outputTargets the output targets configured for the build\n */\nexport const generateCustomElementsManifestDocs = async (\n compilerCtx: d.CompilerCtx,\n docsData: d.JsonDocs,\n outputTargets: d.OutputTarget[],\n): Promise => {\n const cemOutputTargets = outputTargets.filter(isOutputTargetDocsCustomElementsManifest);\n if (cemOutputTargets.length === 0) {\n return;\n }\n\n const manifest = generateManifest(docsData);\n const jsonContent = JSON.stringify(manifest, null, 2);\n\n await Promise.all(cemOutputTargets.map((outputTarget) => compilerCtx.fs.writeFile(outputTarget.file!, jsonContent)));\n};\n\n/**\n * Generate the Custom Elements Manifest from Stencil docs data\n * @param docsData the generated docs data\n * @returns the Custom Elements Manifest object\n */\nconst generateManifest = (docsData: d.JsonDocs): CustomElementsManifest => {\n // Group components by their source file path\n const componentsByFile = new Map();\n\n for (const component of docsData.components) {\n const filePath = component.filePath;\n if (!componentsByFile.has(filePath)) {\n componentsByFile.set(filePath, []);\n }\n componentsByFile.get(filePath)!.push(component);\n }\n\n const modules: JavaScriptModule[] = [];\n\n for (const [filePath, components] of componentsByFile) {\n const declarations: CustomElementDeclaration[] = components.map((component) => componentToDeclaration(component));\n\n const exports: (JavaScriptExport | CustomElementExport)[] = components.flatMap((component) => {\n const className = dashToPascalCase(component.tag);\n return [\n {\n kind: 'js' as const,\n name: className,\n declaration: {\n name: className,\n },\n },\n {\n kind: 'custom-element-definition' as const,\n name: component.tag,\n declaration: {\n name: className,\n },\n },\n ];\n });\n\n modules.push({\n kind: 'javascript-module',\n path: filePath,\n declarations,\n exports,\n });\n }\n\n return {\n schemaVersion: '2.1.0',\n modules,\n };\n};\n\n/**\n * Convert Stencil's ComponentCompilerTypeReferences to CEM TypeReference array\n * @param references Stencil's type references map\n * @returns CEM TypeReference array\n */\nconst convertTypeReferences = (references?: d.ComponentCompilerTypeReferences): TypeReference[] | undefined => {\n if (!references || Object.keys(references).length === 0) {\n return undefined;\n }\n\n return Object.entries(references).map(([name, ref]) => ({\n name,\n // Global types (like HTMLElement, Array) get 'global:' package\n ...(ref.location === 'global' && { package: 'global:' }),\n // Imported types get their module path\n ...(ref.location === 'import' && ref.path && { module: ref.path }),\n // Local types don't need package or module (they're in the same module)\n }));\n};\n\n/**\n * Create a CEM Type object from a type string and optional references\n * @param text the type string\n * @param references Stencil's type references map\n * @returns CEM Type object\n */\nconst createType = (text: string, references?: d.ComponentCompilerTypeReferences): Type => {\n const typeRefs = convertTypeReferences(references);\n return {\n text,\n ...(typeRefs && { references: typeRefs }),\n };\n};\n\n/**\n * Convert a Stencil component to a Custom Element Declaration\n * @param component the Stencil component docs data\n * @returns the Custom Element Declaration\n */\nconst componentToDeclaration = (component: d.JsonDocsComponent): CustomElementDeclaration => {\n const className = dashToPascalCase(component.tag);\n\n const attributes: Attribute[] = component.props\n .filter((prop) => prop.attr !== undefined)\n .map((prop) => ({\n name: prop.attr!,\n ...(prop.docs && { description: prop.docs }),\n ...(prop.type && { type: createType(prop.type, prop.complexType?.references) }),\n ...(prop.default !== undefined && { default: prop.default }),\n fieldName: prop.name,\n ...(prop.deprecation !== undefined && { deprecated: prop.deprecation || true }),\n }));\n\n const members: (CustomElementField | ClassMethod)[] = [\n // Fields (properties)\n ...component.props.map(\n (prop): CustomElementField => ({\n kind: 'field',\n name: prop.name,\n ...(prop.docs && { description: prop.docs }),\n ...(prop.type && { type: createType(prop.type, prop.complexType?.references) }),\n ...(prop.default !== undefined && { default: prop.default }),\n ...(prop.deprecation !== undefined && { deprecated: prop.deprecation || true }),\n ...(!prop.mutable && { readonly: true }),\n ...(prop.attr && { attribute: prop.attr }),\n ...(prop.reflectToAttr && { reflects: true }),\n }),\n ),\n // Methods\n ...component.methods.map(\n (method): ClassMethod => ({\n kind: 'method',\n name: method.name,\n ...(method.docs && { description: method.docs }),\n ...(method.deprecation !== undefined && { deprecated: method.deprecation || true }),\n ...(method.parameters &&\n method.parameters.length > 0 && {\n parameters: method.parameters.map((param) => ({\n name: param.name,\n ...(param.docs && { description: param.docs }),\n ...(param.type && { type: createType(param.type, method.complexType?.references) }),\n })),\n }),\n ...(method.returns && {\n return: {\n ...(method.returns.type && { type: createType(method.returns.type, method.complexType?.references) }),\n ...(method.returns.docs && { description: method.returns.docs }),\n },\n }),\n }),\n ),\n ];\n\n const events: Event[] = component.events.map((event) => ({\n name: event.event,\n ...(event.docs && { description: event.docs }),\n type: createType(event.detail ? `CustomEvent<${event.detail}>` : 'CustomEvent', event.complexType?.references),\n ...(event.deprecation !== undefined && { deprecated: event.deprecation || true }),\n }));\n\n const slots: Slot[] = component.slots.map((slot) => ({\n name: slot.name,\n ...(slot.docs && { description: slot.docs }),\n }));\n\n const cssParts: CssPart[] = component.parts.map((part) => ({\n name: part.name,\n ...(part.docs && { description: part.docs }),\n }));\n\n const cssProperties: CssCustomProperty[] = component.styles\n .filter((style) => style.annotation === 'prop')\n .map((style) => ({\n name: style.name,\n ...(style.docs && { description: style.docs }),\n }));\n\n // Generate demos from usage examples\n const demos: Demo[] = Object.entries(component.usage || {}).map(([name, content]) => ({\n // Create relative URL from usagesDir + filename\n url: component.usagesDir ? `${component.usagesDir}/${name}.md` : `${name}.md`,\n ...(content && { description: content }),\n }));\n\n return {\n kind: 'class',\n customElement: true,\n tagName: component.tag,\n name: className,\n ...(component.docs && { description: component.docs }),\n ...(component.deprecation !== undefined && { deprecated: component.deprecation || true }),\n ...(attributes.length > 0 && { attributes }),\n ...(members.length > 0 && { members }),\n ...(events.length > 0 && { events }),\n ...(slots.length > 0 && { slots }),\n ...(cssParts.length > 0 && { cssParts }),\n ...(cssProperties.length > 0 && { cssProperties }),\n ...(component.customStates.length > 0 && {\n customStates: component.customStates.map((state) => ({\n name: state.name,\n initialValue: state.initialValue,\n ...(state.docs && { description: state.docs }),\n })),\n }),\n ...(demos.length > 0 && { demos }),\n };\n};\n\n// Custom Elements Manifest Types\n// Based on https://github.com/webcomponents/custom-elements-manifest/blob/main/schema.d.ts\n\ninterface CustomElementsManifest {\n schemaVersion: string;\n modules: JavaScriptModule[];\n}\n\ninterface JavaScriptModule {\n kind: 'javascript-module';\n path: string;\n declarations?: CustomElementDeclaration[];\n exports?: (JavaScriptExport | CustomElementExport)[];\n}\n\ninterface JavaScriptExport {\n kind: 'js';\n name: string;\n declaration: Reference;\n}\n\ninterface CustomElementExport {\n kind: 'custom-element-definition';\n name: string;\n declaration: Reference;\n}\n\ninterface Reference {\n name: string;\n package?: string;\n module?: string;\n}\n\ninterface CustomElementDeclaration {\n kind: 'class';\n customElement: true;\n tagName: string;\n name: string;\n description?: string;\n deprecated?: boolean | string;\n attributes?: Attribute[];\n members?: (CustomElementField | ClassMethod)[];\n events?: Event[];\n slots?: Slot[];\n cssParts?: CssPart[];\n cssProperties?: CssCustomProperty[];\n customStates?: CustomState[];\n demos?: Demo[];\n}\n\ninterface Demo {\n url: string;\n description?: string;\n}\n\ninterface Attribute {\n name: string;\n description?: string;\n type?: Type;\n default?: string;\n fieldName?: string;\n deprecated?: boolean | string;\n}\n\ninterface Type {\n text: string;\n references?: TypeReference[];\n}\n\ninterface TypeReference {\n name: string;\n package?: string;\n module?: string;\n}\n\ninterface CustomElementField {\n kind: 'field';\n name: string;\n description?: string;\n type?: Type;\n default?: string;\n deprecated?: boolean | string;\n readonly?: boolean;\n attribute?: string;\n reflects?: boolean;\n}\n\ninterface ClassMethod {\n kind: 'method';\n name: string;\n description?: string;\n deprecated?: boolean | string;\n parameters?: Parameter[];\n return?: {\n type?: Type;\n description?: string;\n };\n}\n\ninterface Parameter {\n name: string;\n description?: string;\n type?: Type;\n}\n\ninterface Event {\n name: string;\n description?: string;\n type: Type;\n deprecated?: boolean | string;\n}\n\ninterface Slot {\n name: string;\n description?: string;\n}\n\ninterface CssPart {\n name: string;\n description?: string;\n}\n\n/**\n * Custom state that can be targeted with the CSS :state() pseudo-class.\n * This is a custom extension to the CEM spec.\n */\ninterface CustomState {\n name: string;\n initialValue: boolean;\n description?: string;\n}\n\ninterface CssCustomProperty {\n name: string;\n description?: string;\n}\n"
},
{
"path": "src/compiler/docs/constants.ts",
"content": "export const AUTO_GENERATE_COMMENT = ``;\nexport const NOTE = `*Built with [StencilJS](https://stenciljs.com/)*`;\n"
},
{
"path": "src/compiler/docs/custom/index.ts",
"content": "import { isOutputTargetDocsCustom } from '@utils';\n\nimport type * as d from '../../../declarations';\n\nexport const generateCustomDocs = async (\n config: d.ValidatedConfig,\n docsData: d.JsonDocs,\n outputTargets: d.OutputTarget[],\n) => {\n const customOutputTargets = outputTargets.filter(isOutputTargetDocsCustom);\n if (customOutputTargets.length === 0) {\n return;\n }\n await Promise.all(\n customOutputTargets.map(async (customOutput) => {\n try {\n await customOutput.generator(docsData, config);\n } catch (e) {\n config.logger.error(`uncaught custom docs error: ${e}`);\n }\n }),\n );\n};\n"
},
{
"path": "src/compiler/docs/generate-doc-data.ts",
"content": "import {\n DEFAULT_STYLE_MODE,\n flatOne,\n isOutputTargetDocsJson,\n join,\n normalizePath,\n relative,\n sortBy,\n unique,\n} from '@utils';\nimport { basename, dirname } from 'path';\n\nimport type * as d from '../../declarations';\nimport { JsonDocsValue } from '../../declarations';\nimport { typescriptVersion, version } from '../../version';\nimport { getBuildTimestamp } from '../build/build-ctx';\nimport { addFileToLibrary, getTypeLibrary } from '../transformers/type-library';\nimport { AUTO_GENERATE_COMMENT } from './constants';\n\n/**\n * Generate metadata that will be used to generate any given documentation-related\n * output target(s)\n *\n * @param config the configuration associated with the current Stencil task run\n * @param compilerCtx the current compiler context\n * @param buildCtx the build context for the current Stencil task run\n * @returns the generated metadata\n */\nexport const generateDocData = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n buildCtx: d.BuildCtx,\n): Promise => {\n const jsonOutputTargets = config.outputTargets.filter(isOutputTargetDocsJson);\n const supplementalPublicTypes = findSupplementalPublicTypes(jsonOutputTargets);\n\n if (supplementalPublicTypes !== '') {\n // if supplementalPublicTypes is set then we want to add all the public\n // types in that file to the type library so that output targets producing\n // documentation can make use of that data later.\n addFileToLibrary(config, supplementalPublicTypes);\n }\n\n const typeLibrary = getTypeLibrary();\n\n return {\n timestamp: getBuildTimestamp(),\n compiler: {\n name: '@stencil/core',\n version,\n typescriptVersion,\n },\n components: await getDocsComponents(config, compilerCtx, buildCtx),\n typeLibrary,\n };\n};\n\n/**\n * If the `supplementalPublicTypes` option is set on one output target, find that value and return it.\n *\n * @param outputTargets an array of docs-json output targets\n * @returns the first value encountered for supplementalPublicTypes or an empty string\n */\nfunction findSupplementalPublicTypes(outputTargets: d.OutputTargetDocsJson[]): string {\n for (const docsJsonOT of outputTargets) {\n if (docsJsonOT.supplementalPublicTypes) {\n return docsJsonOT.supplementalPublicTypes;\n }\n }\n return '';\n}\n\n/**\n * Derive the metadata for each Stencil component\n *\n * @param config the configuration associated with the current Stencil task run\n * @param compilerCtx the current compiler context\n * @param buildCtx the build context for the current Stencil task run\n * @returns the derived metadata\n */\nconst getDocsComponents = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n buildCtx: d.BuildCtx,\n): Promise => {\n const results = await Promise.all(\n buildCtx.moduleFiles.map(async (moduleFile) => {\n const filePath = moduleFile.sourceFilePath;\n const dirPath = normalizePath(dirname(filePath));\n const readmePath = normalizePath(join(dirPath, 'readme.md'));\n const usagesDir = normalizePath(join(dirPath, 'usage'));\n const readme = await getUserReadmeContent(compilerCtx, readmePath);\n const usage = await generateUsages(compilerCtx, usagesDir);\n\n return moduleFile.cmps\n .filter((cmp: d.ComponentCompilerMeta) => !cmp.internal && !cmp.isCollectionDependency)\n .map((cmp: d.ComponentCompilerMeta) => ({\n dirPath,\n filePath: normalizePath(relative(config.rootDir, filePath), false),\n fileName: basename(filePath),\n readmePath,\n usagesDir,\n tag: cmp.tagName,\n readme,\n overview: cmp.docs.text,\n usage,\n docs: generateDocs(readme, cmp.docs),\n docsTags: cmp.docs.tags,\n encapsulation: getDocsEncapsulation(cmp),\n dependents: cmp.directDependents,\n dependencies: cmp.directDependencies,\n dependencyGraph: buildDocsDepGraph(cmp, buildCtx.components),\n deprecation: getDocsDeprecationText(cmp.docs.tags),\n\n props: getDocsProperties(cmp),\n methods: getDocsMethods(cmp.methods),\n events: getDocsEvents(cmp.events),\n styles: getDocsStyles(cmp),\n slots: getDocsSlots(cmp.docs.tags),\n parts: getDocsParts(cmp.htmlParts, cmp.docs.tags),\n customStates: getDocsCustomStates(cmp),\n listeners: getDocsListeners(cmp.listeners),\n }));\n }),\n );\n\n return sortBy(flatOne(results), (cmp) => cmp.tag);\n};\n\nconst buildDocsDepGraph = (\n cmp: d.ComponentCompilerMeta,\n cmps: d.ComponentCompilerMeta[],\n): d.JsonDocsDependencyGraph => {\n const dependencies: d.JsonDocsDependencyGraph = {};\n function walk(tagName: string): void {\n if (!dependencies[tagName]) {\n const cmp = cmps.find((c) => c.tagName === tagName);\n const deps = cmp?.directDependencies;\n if (deps?.length > 0) {\n dependencies[tagName] = deps;\n deps.forEach(walk);\n }\n }\n }\n walk(cmp.tagName);\n\n // load dependents\n cmp.directDependents.forEach((tagName) => {\n if (dependencies[tagName] && !dependencies[tagName].includes(cmp.tagName)) {\n dependencies[tagName].push(cmp.tagName);\n } else {\n dependencies[tagName] = [cmp.tagName];\n }\n });\n return dependencies;\n};\n\n/**\n * Determines the encapsulation string to use, based on the provided compiler metadata\n * @param cmp the metadata for a single component\n * @returns the encapsulation level, expressed as a string\n */\nconst getDocsEncapsulation = (cmp: d.ComponentCompilerMeta): 'shadow' | 'scoped' | 'none' => {\n if (cmp.encapsulation === 'shadow') {\n return 'shadow';\n } else if (cmp.encapsulation === 'scoped') {\n return 'scoped';\n } else {\n return 'none';\n }\n};\n\n/**\n * Generate a collection of JSDoc metadata for both real and virtual props\n * @param cmpMeta the component metadata to derive JSDoc metadata from\n * @returns the derived metadata\n */\nconst getDocsProperties = (cmpMeta: d.ComponentCompilerMeta): d.JsonDocsProp[] => {\n return sortBy(\n [...getRealProperties(cmpMeta.properties), ...getVirtualProperties(cmpMeta.virtualProperties)],\n (p) => p.name,\n );\n};\n\n/**\n * Generate a collection of JSDoc metadata for props on a component\n * @param properties the component's property metadata to derive JSDoc metadata from\n * @returns the derived metadata\n */\nconst getRealProperties = (properties: d.ComponentCompilerProperty[]): d.JsonDocsProp[] => {\n return properties\n .filter((member) => !member.internal)\n .map((member) => ({\n name: member.name,\n type: member.complexType.resolved,\n complexType: member.complexType,\n mutable: member.mutable,\n attr: member.attribute,\n reflectToAttr: !!member.reflect,\n docs: member.docs.text,\n docsTags: member.docs.tags,\n default: member.defaultValue,\n deprecation: getDocsDeprecationText(member.docs.tags),\n values: parseTypeIntoValues(member.complexType.resolved),\n\n optional: member.optional,\n required: member.required,\n\n getter: member.getter,\n setter: member.setter,\n }));\n};\n\n/**\n * Generate a collection of JSDoc metadata for props on a component\n * @param virtualProps the component's virtual property metadata to derive JSDoc metadata from\n * @returns the derived metadata\n */\nconst getVirtualProperties = (virtualProps: d.ComponentCompilerVirtualProperty[]): d.JsonDocsProp[] => {\n return virtualProps.map(\n (member): d.JsonDocsProp => ({\n name: member.name,\n type: member.type,\n mutable: false,\n attr: member.name,\n reflectToAttr: false,\n docs: member.docs,\n docsTags: [],\n default: undefined,\n deprecation: undefined,\n values: parseTypeIntoValues(member.type),\n\n optional: true,\n required: false,\n\n getter: undefined,\n setter: undefined,\n }),\n );\n};\n\nconst parseTypeIntoValues = (type: string): d.JsonDocsValue[] => {\n if (typeof type === 'string') {\n const unions = type.split('|').map((u) => u.trim());\n const parsedUnions: JsonDocsValue[] = [];\n unions.forEach((u) => {\n if (u === 'true') {\n parsedUnions.push({\n value: 'true',\n type: 'boolean',\n });\n return;\n }\n if (u === 'false') {\n parsedUnions.push({\n value: 'false',\n type: 'boolean',\n });\n return;\n }\n if (!Number.isNaN(parseFloat(u))) {\n // union is a number\n parsedUnions.push({\n value: u,\n type: 'number',\n });\n return;\n }\n if (/^(\"|').+(\"|')$/gm.test(u)) {\n // ionic is a string\n parsedUnions.push({\n value: u.slice(1, -1),\n type: 'string',\n });\n return;\n }\n parsedUnions.push({\n type: u,\n });\n });\n return parsedUnions;\n }\n return [];\n};\n\nconst getDocsMethods = (methods: d.ComponentCompilerMethod[]): d.JsonDocsMethod[] => {\n return sortBy(methods, (member) => member.name)\n .filter((member) => !member.internal)\n .map(\n (member) =>\n {\n name: member.name,\n returns: {\n type: member.complexType.return,\n docs: member.docs.tags\n .filter((t) => t.name === 'return' || t.name === 'returns')\n .map((t) => t.text)\n .join('\\n'),\n },\n complexType: member.complexType,\n signature: `${member.name}${member.complexType.signature}`,\n parameters: member.complexType.parameters,\n docs: member.docs.text,\n docsTags: member.docs.tags,\n deprecation: getDocsDeprecationText(member.docs.tags),\n },\n );\n};\n\nconst getDocsEvents = (events: d.ComponentCompilerEvent[]): d.JsonDocsEvent[] => {\n return sortBy(events, (eventMeta) => eventMeta.name.toLowerCase())\n .filter((eventMeta) => !eventMeta.internal)\n .map((eventMeta) => ({\n event: eventMeta.name,\n detail: eventMeta.complexType.resolved,\n bubbles: eventMeta.bubbles,\n complexType: eventMeta.complexType,\n cancelable: eventMeta.cancelable,\n composed: eventMeta.composed,\n docs: eventMeta.docs.text,\n docsTags: eventMeta.docs.tags,\n deprecation: getDocsDeprecationText(eventMeta.docs.tags),\n }));\n};\n\n/**\n * Transforms the {@link d.CompilerStyleDoc} metadata for a component into a {@link d.JsonDocsStyle}, providing sensible\n * defaults where needed.\n * @param cmpMeta the metadata for a single Stencil component, which contains the compiler style metadata\n * @returns a new series containing a {@link d.JsonDocsStyle} entry for each {@link d.CompilerStyleDoc} entry.\n */\nexport const getDocsStyles = (cmpMeta: d.ComponentCompilerMeta): d.JsonDocsStyle[] => {\n if (!cmpMeta.styleDocs) {\n return [];\n }\n\n return sortBy(\n cmpMeta.styleDocs,\n (compilerStyleDoc) => `${compilerStyleDoc.name.toLowerCase()},${compilerStyleDoc.mode.toLowerCase()}}`,\n ).map((compilerStyleDoc) => {\n return {\n name: compilerStyleDoc.name,\n annotation: compilerStyleDoc.annotation || '',\n docs: compilerStyleDoc.docs || '',\n mode: compilerStyleDoc.mode && compilerStyleDoc.mode !== DEFAULT_STYLE_MODE ? compilerStyleDoc.mode : undefined,\n };\n });\n};\n\nconst getDocsListeners = (listeners: d.ComponentCompilerListener[]): d.JsonDocsListener[] => {\n return listeners.map((listener) => ({\n event: listener.name,\n target: listener.target,\n capture: listener.capture,\n passive: listener.passive,\n }));\n};\n\n/**\n * Get the text associated with a `@deprecated` tag, if one exists\n * @param tags the tags associated with a JSDoc block on a node in the AST\n * @returns the text associated with the first found `@deprecated` tag. If a `@deprecated` tag exists but does not\n * have associated text, an empty string is returned. If no such tag is found, return `undefined`\n */\nconst getDocsDeprecationText = (tags: d.JsonDocsTag[]): string | undefined => {\n const deprecation = tags.find((t) => t.name === 'deprecated');\n if (deprecation) {\n return deprecation.text || '';\n }\n return undefined;\n};\n\nconst getDocsSlots = (tags: d.JsonDocsTag[]): d.JsonDocsSlot[] => {\n return sortBy(\n getNameText('slot', tags).map(([name, docs]) => ({ name, docs })),\n (a) => a.name,\n );\n};\n\nconst getDocsParts = (vdom: string[], tags: d.JsonDocsTag[]): d.JsonDocsSlot[] => {\n const docsParts = getNameText('part', tags).map(([name, docs]) => ({ name, docs }));\n const vdomParts = vdom.map((name) => ({ name, docs: '' }));\n return sortBy(\n unique([...docsParts, ...vdomParts], (p) => p.name),\n (p) => p.name,\n );\n};\n\n/**\n * Extract custom states documentation from component metadata\n *\n * @param cmpMeta the component metadata to extract custom states from\n * @returns array of custom state documentation objects\n */\nconst getDocsCustomStates = (cmpMeta: d.ComponentCompilerMeta): d.JsonDocsCustomState[] => {\n if (!cmpMeta.attachInternalsCustomStates || cmpMeta.attachInternalsCustomStates.length === 0) {\n return [];\n }\n\n return sortBy(\n cmpMeta.attachInternalsCustomStates.map((state) => ({\n name: state.name,\n initialValue: state.initialValue,\n docs: state.docs || '',\n })),\n (state) => state.name,\n );\n};\n\nexport const getNameText = (name: string, tags: d.JsonDocsTag[]) => {\n return tags\n .filter((tag) => tag.name === name && tag.text)\n .map(({ text }) => {\n const [namePart, ...rest] = (' ' + text).split(' - ');\n return [namePart.trim(), rest.join(' - ').trim()];\n });\n};\n\n/**\n * Attempts to read a pre-existing README.md file from disk, returning any content generated by the user.\n *\n * For simplicity's sake, it is assumed that all user-generated content will fall before {@link AUTO_GENERATE_COMMENT}\n *\n * @param compilerCtx the current compiler context\n * @param readmePath the path to the README file to read\n * @returns the user generated content that occurs before {@link AUTO_GENERATE_COMMENT}. If no user generated content\n * exists, or if there was an issue reading the file, return `undefined`\n */\nexport const getUserReadmeContent = async (\n compilerCtx: d.CompilerCtx,\n readmePath: string,\n): Promise => {\n try {\n const existingContent = await compilerCtx.fs.readFile(readmePath);\n // subtract one to get everything up to, but not including the auto generated comment\n const userContentIndex = existingContent.indexOf(AUTO_GENERATE_COMMENT) - 1;\n if (userContentIndex >= 0) {\n return existingContent.substring(0, userContentIndex);\n }\n } catch (e) {}\n return undefined;\n};\n\n/**\n * Generate documentation for a given component based on the provided JSDoc and README contents\n * @param readme the contents of a component's README file, without any autogenerated contents\n * @param jsdoc the JSDoc associated with the component's declaration\n * @returns the generated documentation\n */\nconst generateDocs = (readme: string | undefined, jsdoc: d.CompilerJsDoc): string => {\n const docs = jsdoc.text;\n if (docs !== '' || !readme) {\n // just return the existing docs if they exist. these would have been captured earlier in the compilation process.\n // if they don't exist, and there's no README to process, return an empty string.\n return docs;\n }\n\n /**\n * Parse the README, storing the first section of content.\n * Content is defined as the area between two non-consecutive lines that start with a '#':\n * ```\n * # Header 1\n * This is some content\n * # Header 2\n * This is more content\n * # Header 3\n * Again, content\n * ```\n * In the example above, this chunk of code is designed to capture \"This is some content\"\n */\n let isContent = false;\n const lines = readme.split('\\n');\n const contentLines = [];\n for (const line of lines) {\n const isHeader = line.startsWith('#');\n if (isHeader && isContent) {\n // we were actively parsing content, but found a new header, break out\n break;\n }\n if (!isHeader && !isContent) {\n // we've found content for the first time, set this sentinel to `true`\n isContent = true;\n }\n if (isContent) {\n // we're actively parsing the first found block of content, add it to our list for later\n contentLines.push(line);\n }\n }\n return contentLines.join('\\n').trim();\n};\n\n/**\n * This function is responsible for reading the contents of all markdown files in a provided `usage` directory and\n * returning their contents\n * @param compilerCtx the current compiler context\n * @param usagesDir the directory to read usage markdown files from\n * @returns an object that maps the filename containing the usage example, to the file's contents. If an error occurs,\n * an empty object is returned.\n */\nconst generateUsages = async (compilerCtx: d.CompilerCtx, usagesDir: string): Promise => {\n const rtn: d.JsonDocsUsage = {};\n\n try {\n const usageFilePaths = await compilerCtx.fs.readdir(usagesDir);\n\n const usages: d.JsonDocsUsage = {};\n\n await Promise.all(\n usageFilePaths.map(async (f) => {\n if (!f.isFile) {\n return;\n }\n\n const fileName = basename(f.relPath);\n if (!fileName.toLowerCase().endsWith('.md')) {\n return;\n }\n\n const parts = fileName.split('.');\n parts.pop();\n const key = parts.join('.');\n\n usages[key] = await compilerCtx.fs.readFile(f.absPath);\n }),\n );\n\n Object.keys(usages)\n .sort()\n .forEach((key) => {\n rtn[key] = usages[key];\n });\n } catch (e) {}\n\n return rtn;\n};\n"
},
{
"path": "src/compiler/docs/json/index.ts",
"content": "import { isOutputTargetDocsJson, join } from '@utils';\n\nimport type * as d from '../../../declarations';\n\nexport const generateJsonDocs = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n docsData: d.JsonDocs,\n outputTargets: d.OutputTarget[],\n) => {\n const jsonOutputTargets = outputTargets.filter(isOutputTargetDocsJson);\n if (jsonOutputTargets.length === 0) {\n return;\n }\n const docsDtsPath = join(config.sys.getCompilerExecutingPath(), '..', '..', 'internal', 'stencil-public-docs.d.ts');\n let docsDts = await compilerCtx.fs.readFile(docsDtsPath);\n // this file was written by dts-bundle-generator, which uses tabs for\n // indentation. Instead, let's replace those with spaces!\n docsDts = docsDts\n .split('\\n')\n .map((line) => line.replace(/\\t/g, ' '))\n .join('\\n');\n\n const typesContent = `\n/**\n * This is an autogenerated file created by the Stencil compiler.\n * DO NOT MODIFY IT MANUALLY\n */\n${docsDts}\ndeclare const _default: JsonDocs;\nexport default _default;\n`;\n\n const json = {\n ...docsData,\n components: docsData.components.map((cmp) => ({\n filePath: cmp.filePath,\n\n encapsulation: cmp.encapsulation,\n tag: cmp.tag,\n readme: cmp.readme,\n docs: cmp.docs,\n docsTags: cmp.docsTags,\n usage: cmp.usage,\n props: cmp.props,\n methods: cmp.methods,\n events: cmp.events,\n listeners: cmp.listeners,\n styles: cmp.styles,\n slots: cmp.slots,\n parts: cmp.parts,\n states: cmp.customStates,\n dependents: cmp.dependents,\n dependencies: cmp.dependencies,\n dependencyGraph: cmp.dependencyGraph,\n deprecation: cmp.deprecation,\n })),\n };\n const jsonContent = JSON.stringify(json, null, 2);\n await Promise.all(\n jsonOutputTargets.map((jsonOutput) => {\n return writeDocsOutput(compilerCtx, jsonOutput, jsonContent, typesContent);\n }),\n );\n};\n\nexport const writeDocsOutput = async (\n compilerCtx: d.CompilerCtx,\n jsonOutput: d.OutputTargetDocsJson,\n jsonContent: string,\n typesContent: string,\n) => {\n return Promise.all([\n compilerCtx.fs.writeFile(jsonOutput.file, jsonContent),\n jsonOutput.typesFile ? compilerCtx.fs.writeFile(jsonOutput.typesFile, typesContent) : (Promise.resolve() as any),\n ]);\n};\n"
},
{
"path": "src/compiler/docs/readme/docs-util.ts",
"content": "export class MarkdownTable {\n private rows: RowData[] = [];\n\n addHeader(data: string[]) {\n this.addRow(data, true);\n }\n\n addRow(data: string[], isHeader = false) {\n const colData: ColumnData[] = [];\n\n data.forEach((text) => {\n const col: ColumnData = {\n text: escapeMarkdownTableColumn(text),\n width: text.length,\n };\n colData.push(col);\n });\n\n this.rows.push({\n columns: colData,\n isHeader: isHeader,\n });\n }\n\n toMarkdown() {\n return createTable(this.rows);\n }\n}\n\nconst escapeMarkdownTableColumn = (text: string) => {\n text = text.replace(/\\r?\\n/g, ' ');\n text = text.replace(/\\|/g, '\\\\|');\n return text;\n};\n\nconst createTable = (rows: RowData[]) => {\n const content: string[] = [];\n if (rows.length === 0) {\n return content;\n }\n\n normalizeColumCount(rows);\n normalizeColumnWidth(rows);\n\n const th = rows.find((r) => r.isHeader);\n if (th) {\n const headerRow = createRow(th);\n content.push(headerRow);\n content.push(createBorder(th));\n }\n\n const tds = rows.filter((r) => !r.isHeader);\n tds.forEach((td) => {\n content.push(createRow(td));\n });\n\n return content;\n};\n\nconst createBorder = (th: RowData) => {\n const border: RowData = {\n columns: [],\n isHeader: false,\n };\n\n th.columns.forEach((c) => {\n const borderCol: ColumnData = {\n text: '',\n width: c.width,\n };\n while (borderCol.text.length < borderCol.width) {\n borderCol.text += '-';\n }\n border.columns.push(borderCol);\n });\n\n return createRow(border);\n};\n\nconst createRow = (row: RowData) => {\n const content: string[] = ['| '];\n\n row.columns.forEach((c) => {\n content.push(c.text);\n content.push(' | ');\n });\n\n return content.join('').trim();\n};\n\nconst normalizeColumCount = (rows: RowData[]) => {\n let columnCount = 0;\n\n rows.forEach((r) => {\n if (r.columns.length > columnCount) {\n columnCount = r.columns.length;\n }\n });\n\n rows.forEach((r) => {\n while (r.columns.length < columnCount) {\n r.columns.push({\n text: ``,\n width: 0,\n });\n }\n });\n};\n\nconst normalizeColumnWidth = (rows: RowData[]) => {\n const columnCount = rows[0].columns.length;\n\n for (let columnIndex = 0; columnIndex < columnCount; columnIndex++) {\n let longestText = 0;\n\n rows.forEach((r) => {\n const col = r.columns[columnIndex];\n if (col.text.length > longestText) {\n longestText = col.text.length;\n }\n });\n\n rows.forEach((r) => {\n const col = r.columns[columnIndex];\n col.width = longestText;\n while (col.text.length < longestText) {\n col.text += ' ';\n }\n });\n }\n};\n\n/**\n * Checks if a given string is a valid hexadecimal color representation.\n *\n * @param str - The string to be checked.\n * @returns `true` if the string is a valid hex color (e.g., '#FF00AA', '#f0f'), `false` otherwise.\n *\n * @example\n * isHexColor('#FF00AA'); // true\n * isHexColor('#f0f'); // true\n * isHexColor('#abcde'); // false (too many characters)\n * isHexColor('FF00AA'); // false (missing #)\n */\nexport const isHexColor = (str: string): boolean => {\n const hexColorRegex = /^#([0-9A-Fa-f]{3}){1,2}$/;\n return hexColorRegex.test(str);\n};\n\ninterface ColumnData {\n text: string;\n width: number;\n}\n\ninterface RowData {\n columns: ColumnData[];\n isHeader?: boolean;\n}\n"
},
{
"path": "src/compiler/docs/readme/index.ts",
"content": "import { isOutputTargetDocsReadme } from '@utils';\n\nimport type * as d from '../../../declarations';\nimport { generateReadme } from './output-docs';\n\nexport const generateReadmeDocs = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n docsData: d.JsonDocs,\n outputTargets: d.OutputTarget[],\n) => {\n const readmeOutputTargets = outputTargets.filter(isOutputTargetDocsReadme);\n if (readmeOutputTargets.length === 0) {\n return;\n }\n const strictCheck = readmeOutputTargets.some((o) => o.strict);\n if (strictCheck) {\n strictCheckDocs(config, docsData);\n }\n\n await Promise.all(\n docsData.components.map((cmpData) => {\n return generateReadme(config, compilerCtx, readmeOutputTargets, cmpData, docsData.components);\n }),\n );\n};\n\nexport const strictCheckDocs = (config: d.ValidatedConfig, docsData: d.JsonDocs) => {\n docsData.components.forEach((component) => {\n component.props.forEach((prop) => {\n if (!prop.docs && prop.deprecation === undefined) {\n config.logger.warn(`Property \"${prop.name}\" of \"${component.tag}\" is not documented. ${component.filePath}`);\n }\n });\n component.methods.forEach((method) => {\n if (!method.docs && method.deprecation === undefined) {\n config.logger.warn(`Method \"${method.name}\" of \"${component.tag}\" is not documented. ${component.filePath}`);\n }\n });\n component.events.forEach((ev) => {\n if (!ev.docs && ev.deprecation === undefined) {\n config.logger.warn(`Event \"${ev.event}\" of \"${component.tag}\" is not documented. ${component.filePath}`);\n }\n });\n component.parts.forEach((ev) => {\n if (ev.docs === '') {\n config.logger.warn(`Part \"${ev.name}\" of \"${component.tag}\" is not documented. ${component.filePath}`);\n }\n });\n });\n};\n"
},
{
"path": "src/compiler/docs/readme/markdown-css-props.ts",
"content": "import type * as d from '../../../declarations';\nimport { MarkdownTable } from './docs-util';\n\nexport const stylesToMarkdown = (styles: d.JsonDocsStyle[]) => {\n const content: string[] = [];\n if (styles.length === 0) {\n return content;\n }\n\n content.push(`## CSS Custom Properties`);\n content.push(``);\n\n const table = new MarkdownTable();\n table.addHeader(['Name', 'Description']);\n\n styles.forEach((style) => {\n table.addRow([`\\`${style.name}\\``, style.docs]);\n });\n\n content.push(...table.toMarkdown());\n content.push(``);\n content.push(``);\n\n return content;\n};\n"
},
{
"path": "src/compiler/docs/readme/markdown-custom-states.ts",
"content": "import type * as d from '../../../declarations';\nimport { MarkdownTable } from './docs-util';\n\n/**\n * Converts a list of Custom States metadata to a table written in Markdown\n * @param customStates the Custom States metadata to convert\n * @returns a list of strings that make up the Markdown table\n */\nexport const customStatesToMarkdown = (customStates: d.JsonDocsCustomState[]): ReadonlyArray => {\n const content: string[] = [];\n if (customStates.length === 0) {\n return content;\n }\n\n content.push(`## Custom States`);\n content.push(``);\n\n const table = new MarkdownTable();\n table.addHeader(['State', 'Initial Value', 'Description']);\n\n customStates.forEach((state) => {\n table.addRow([`\\`:state(${state.name})\\``, state.initialValue ? '`true`' : '`false`', state.docs]);\n });\n\n content.push(...table.toMarkdown());\n content.push(``);\n content.push(``);\n\n return content;\n};\n"
},
{
"path": "src/compiler/docs/readme/markdown-dependencies.ts",
"content": "import { normalizePath, relative } from '@utils';\n\nimport type * as d from '../../../declarations';\n\nexport const depsToMarkdown = (cmp: d.JsonDocsComponent, cmps: d.JsonDocsComponent[], config: d.ValidatedConfig) => {\n const content: string[] = [];\n\n const deps = Object.entries(cmp.dependencyGraph);\n\n if (deps.length === 0) {\n return content;\n }\n\n content.push(`## Dependencies`);\n content.push(``);\n\n if (cmp.dependents.length > 0) {\n const usedBy = cmp.dependents.map((tag) => ' - ' + getCmpLink(cmp, tag, cmps));\n\n content.push(`### Used by`);\n content.push(``);\n content.push(...usedBy);\n content.push(``);\n }\n\n if (cmp.dependencies.length > 0) {\n const dependsOn = cmp.dependencies.map((tag) => '- ' + getCmpLink(cmp, tag, cmps));\n\n content.push(`### Depends on`);\n content.push(``);\n content.push(...dependsOn);\n content.push(``);\n }\n\n content.push(`### Graph`);\n content.push('```mermaid');\n content.push('graph TD;');\n deps.forEach(([key, deps]) => {\n deps.forEach((dep) => {\n content.push(` ${key} --> ${dep}`);\n });\n });\n\n const { background, textColor } = config.docs.markdown.targetComponent;\n\n content.push(` style ${cmp.tag} fill:${background},stroke:${textColor},stroke-width:4px`);\n\n content.push('```');\n\n content.push(``);\n\n return content;\n};\n\nconst getCmpLink = (from: d.JsonDocsComponent, to: string, cmps: d.JsonDocsComponent[]) => {\n const destCmp = cmps.find((c) => c.tag === to);\n if (destCmp) {\n const cmpRelPath = normalizePath(relative(from.dirPath, destCmp.dirPath));\n return `[${to}](${cmpRelPath})`;\n }\n return to;\n};\n"
},
{
"path": "src/compiler/docs/readme/markdown-events.ts",
"content": "import type * as d from '../../../declarations';\nimport { MarkdownTable } from './docs-util';\n\nexport const eventsToMarkdown = (events: d.JsonDocsEvent[]) => {\n const content: string[] = [];\n if (events.length === 0) {\n return content;\n }\n\n content.push(`## Events`);\n content.push(``);\n\n const table = new MarkdownTable();\n\n table.addHeader(['Event', 'Description', 'Type']);\n\n events.forEach((ev) => {\n table.addRow([`\\`${ev.event}\\``, getDocsField(ev), `\\`CustomEvent<${ev.detail}>\\``]);\n });\n\n content.push(...table.toMarkdown());\n content.push(``);\n content.push(``);\n\n return content;\n};\n\nconst getDocsField = (prop: d.JsonDocsEvent) => {\n return `${\n prop.deprecation !== undefined\n ? `**[DEPRECATED]** ${prop.deprecation}**[DEPRECATED]** ${prop.deprecation} => {\n if (!overview) {\n return [];\n }\n\n const content: string[] = [];\n content.push(`## Overview`);\n content.push('');\n content.push(`${overview.trim()}`);\n content.push('');\n\n return content;\n};\n"
},
{
"path": "src/compiler/docs/readme/markdown-parts.ts",
"content": "import type * as d from '../../../declarations';\nimport { MarkdownTable } from './docs-util';\n\n/**\n * Converts a list of Shadow Parts metadata to a table written in Markdown\n * @param parts the Shadow parts metadata to convert\n * @returns a list of strings that make up the Markdown table\n */\nexport const partsToMarkdown = (parts: d.JsonDocsPart[]): ReadonlyArray => {\n const content: string[] = [];\n if (parts.length === 0) {\n return content;\n }\n\n content.push(`## Shadow Parts`);\n content.push(``);\n\n const table = new MarkdownTable();\n table.addHeader(['Part', 'Description']);\n\n parts.forEach((style) => {\n table.addRow([style.name === '' ? '' : `\\`\"${style.name}\"\\``, style.docs]);\n });\n\n content.push(...table.toMarkdown());\n content.push(``);\n content.push(``);\n\n return content;\n};\n"
},
{
"path": "src/compiler/docs/readme/markdown-props.ts",
"content": "import type * as d from '../../../declarations';\nimport { MarkdownTable } from './docs-util';\n\nexport const propsToMarkdown = (props: d.JsonDocsProp[]) => {\n const content: string[] = [];\n if (props.length === 0) {\n return content;\n }\n\n content.push(`## Properties`);\n content.push(``);\n\n const table = new MarkdownTable();\n\n table.addHeader(['Property', 'Attribute', 'Description', 'Type', 'Default']);\n\n props.forEach((prop) => {\n table.addRow([\n getPropertyField(prop),\n getAttributeField(prop),\n getDocsField(prop),\n getTypeField(prop),\n getDefaultValueField(prop),\n ]);\n });\n\n content.push(...table.toMarkdown());\n content.push(``);\n content.push(``);\n\n return content;\n};\n\nconst getPropertyField = (prop: d.JsonDocsProp) => {\n return `\\`${prop.name}\\`${prop.required ? ' _(required)_' : ''}`;\n};\n\nconst getAttributeField = (prop: d.JsonDocsProp) => {\n return prop.attr ? `\\`${prop.attr}\\`` : '--';\n};\n\nconst getDocsField = (prop: d.JsonDocsProp) => {\n return `${\n prop.deprecation !== undefined\n ? `**[DEPRECATED]** ${prop.deprecation} => {\n const content: string[] = [];\n if (slots.length === 0) {\n return content;\n }\n\n content.push(`## Slots`);\n content.push(``);\n\n const table = new MarkdownTable();\n table.addHeader(['Slot', 'Description']);\n\n slots.forEach((style) => {\n table.addRow([style.name === '' ? '' : `\\`\"${style.name}\"\\``, style.docs]);\n });\n\n content.push(...table.toMarkdown());\n content.push(``);\n content.push(``);\n\n return content;\n};\n"
},
{
"path": "src/compiler/docs/readme/markdown-usage.ts",
"content": "import { toTitleCase } from '@utils';\n\nimport type * as d from '../../../declarations';\n\nexport const usageToMarkdown = (usages: d.JsonDocsUsage) => {\n const content: string[] = [];\n const merged = mergeUsages(usages);\n if (merged.length === 0) {\n return content;\n }\n\n content.push(`## Usage`);\n\n merged.forEach(({ name, text }) => {\n content.push('');\n content.push(`### ${toTitleCase(name)}`);\n content.push('');\n content.push(text);\n content.push('');\n }),\n content.push('');\n content.push('');\n\n return content;\n};\n\nexport const mergeUsages = (usages: d.JsonDocsUsage) => {\n const keys = Object.keys(usages);\n const map = new Map();\n keys.forEach((key) => {\n const usage = usages[key].trim();\n const array = map.get(usage) || [];\n array.push(key);\n map.set(usage, array);\n });\n const merged: { name: string; text: string }[] = [];\n map.forEach((value, key) => {\n merged.push({\n name: value.join(' / '),\n text: key,\n });\n });\n return merged;\n};\n"
},
{
"path": "src/compiler/docs/readme/output-docs.ts",
"content": "import { join, normalizePath, relative } from '@utils';\n\nimport type * as d from '../../../declarations';\nimport { AUTO_GENERATE_COMMENT } from '../constants';\nimport { getUserReadmeContent } from '../generate-doc-data';\nimport { stylesToMarkdown } from './markdown-css-props';\nimport { customStatesToMarkdown } from './markdown-custom-states';\nimport { depsToMarkdown } from './markdown-dependencies';\nimport { eventsToMarkdown } from './markdown-events';\nimport { methodsToMarkdown } from './markdown-methods';\nimport { overviewToMarkdown } from './markdown-overview';\nimport { partsToMarkdown } from './markdown-parts';\nimport { propsToMarkdown } from './markdown-props';\nimport { slotsToMarkdown } from './markdown-slots';\nimport { usageToMarkdown } from './markdown-usage';\n\n/**\n * Generate a README for a given component and write it to disk.\n *\n * Typically the README is going to be a 'sibling' to the component's source\n * code (i.e. written to the same directory) but the user may also configure a\n * custom output directory by setting {@link d.OutputTargetDocsReadme.dir}.\n *\n * Output readme files also include {@link AUTO_GENERATE_COMMENT}, and any\n * text located _above_ that comment is preserved when the new readme is written\n * to disk.\n *\n * @param config a validated Stencil config\n * @param compilerCtx the current compiler context\n * @param readmeOutputs docs-readme output targets\n * @param docsData documentation data for the component of interest\n * @param cmps metadata for all the components in the project\n */\nexport const generateReadme = async (\n config: d.ValidatedConfig,\n compilerCtx: d.CompilerCtx,\n readmeOutputs: d.OutputTargetDocsReadme[],\n docsData: d.JsonDocsComponent,\n cmps: d.JsonDocsComponent[],\n) => {\n const isUpdate = !!docsData.readme;\n const userContent = isUpdate ? docsData.readme : getDefaultReadme(docsData);\n\n await Promise.all(\n readmeOutputs.map(async (readmeOutput) => {\n if (readmeOutput.dir) {\n const relativeReadmePath = relative(config.srcDir, docsData.readmePath);\n const readmeOutputPath = join(readmeOutput.dir, relativeReadmePath);\n\n const currentReadmeContent =\n readmeOutput.overwriteExisting === true\n ? // Overwrite explicitly requested: always use the provided user content.\n userContent\n : normalizePath(readmeOutput.dir) !== normalizePath(config.srcDir)\n ? (readmeOutput.overwriteExisting === 'if-missing' &&\n // Validate a file exists at the output path\n (await compilerCtx.fs.access(readmeOutputPath))) ||\n // False and undefined case: follow the changes made in #5648\n (readmeOutput.overwriteExisting ?? false) === false\n ? // Existing file found: The user set a custom `.dir` property, which is\n // where we're going to write the updated README. We need to read the\n // non-automatically generated content from that file and preserve that.\n await getUserReadmeContent(compilerCtx, readmeOutputPath)\n : // No existing file found: use the provided user content.\n userContent\n : // Default case: writing to srcDir, so use the provided user content.\n userContent;\n\n // CSS Custom Properties preservation is now handled centrally in outputDocs\n const readmeContent = generateMarkdown(currentReadmeContent, docsData, cmps, readmeOutput, config);\n\n const results = await compilerCtx.fs.writeFile(readmeOutputPath, readmeContent);\n if (results.changedContent) {\n if (isUpdate) {\n config.logger.info(`updated readme docs: ${docsData.tag}`);\n } else {\n config.logger.info(`created readme docs: ${docsData.tag}`);\n }\n }\n }\n }),\n );\n};\n\nexport const generateMarkdown = (\n userContent: string | undefined,\n cmp: d.JsonDocsComponent,\n cmps: d.JsonDocsComponent[],\n readmeOutput: d.OutputTargetDocsReadme,\n config?: d.ValidatedConfig,\n) => {\n //If the readmeOutput.dependencies is true or undefined the dependencies will be generated.\n const dependencies = readmeOutput.dependencies !== false ? depsToMarkdown(cmp, cmps, config) : [];\n\n return [\n userContent || '',\n AUTO_GENERATE_COMMENT,\n '',\n '',\n ...getDocsDeprecation(cmp),\n ...overviewToMarkdown(cmp.overview),\n ...usageToMarkdown(cmp.usage),\n ...propsToMarkdown(cmp.props),\n ...eventsToMarkdown(cmp.events),\n ...methodsToMarkdown(cmp.methods),\n ...slotsToMarkdown(cmp.slots),\n ...partsToMarkdown(cmp.parts),\n ...customStatesToMarkdown(cmp.customStates),\n ...stylesToMarkdown(cmp.styles),\n ...dependencies,\n `----------------------------------------------`,\n '',\n readmeOutput.footer,\n '',\n ].join('\\n');\n};\n\nconst getDocsDeprecation = (cmp: d.JsonDocsComponent) => {\n if (cmp.deprecation !== undefined) {\n return [`> **[DEPRECATED]** ${cmp.deprecation}`, ''];\n }\n return [];\n};\n\n/**\n * Get a minimal default README for a Stencil component\n *\n * @param docsData documentation data for the component of interest\n * @returns a minimal README template for that component\n */\nconst getDefaultReadme = (docsData: d.JsonDocsComponent) => {\n return [`# ${docsData.tag}`, '', '', ''].join('\\n');\n};\n\n/**\n * Extract the existing CSS Custom Properties section from a README file.\n * This is used to preserve CSS props documentation when running `stencil docs`\n * without building styles.\n *\n * @param compilerCtx the current compiler context\n * @param readmePath the path to the README file to read\n * @returns array of CSS custom properties styles, or undefined if none found\n */\nexport const extractExistingCssProps = async (\n compilerCtx: d.CompilerCtx,\n readmePath: string,\n): Promise => {\n try {\n const existingContent = await compilerCtx.fs.readFile(readmePath);\n\n // Find the CSS Custom Properties section\n const cssPropsSectionMatch = existingContent.match(\n /## CSS Custom Properties\\s*\\n\\s*\\n([\\s\\S]*?)(?=\\n##|\\n-{4,}|$)/,\n );\n if (!cssPropsSectionMatch) {\n return undefined;\n }\n\n const cssPropsSection = cssPropsSectionMatch[1];\n const styles: d.JsonDocsStyle[] = [];\n\n // Parse the markdown table to extract CSS custom properties\n // Table format:\n // | Name | Description |\n // | ---- | ----------- |\n // | `--prop-name` | Description text |\n const lines = cssPropsSection.split('\\n');\n let inTable = false;\n\n for (const line of lines) {\n const trimmedLine = line.trim();\n\n // Skip header and separator rows\n if (trimmedLine.startsWith('| Name') || trimmedLine.startsWith('| ---')) {\n inTable = true;\n continue;\n }\n\n // Parse table rows\n if (inTable && trimmedLine.startsWith('|')) {\n const parts = trimmedLine\n .split('|')\n .map((p) => p.trim())\n .filter((p) => p);\n if (parts.length >= 2) {\n // Extract the CSS variable name (remove backticks)\n const name = parts[0].replace(/`/g, '').trim();\n const docs = parts[1].trim();\n\n if (name.startsWith('--')) {\n styles.push({\n name,\n docs,\n annotation: 'prop',\n mode: undefined,\n });\n }\n }\n }\n }\n\n return styles.length > 0 ? styles : undefined;\n } catch (e) {\n return undefined;\n }\n};\n"
},
{
"path": "src/compiler/docs/style-docs.ts",
"content": "import type * as d from '../../declarations';\n\n/**\n * Parse CSS docstrings that Stencil supports, as documented here:\n * https://stenciljs.com/docs/docs-json#css-variables\n *\n * Docstrings found in the supplied style text will be added to the\n * `styleDocs` param\n *\n * @param styleDocs the array to hold formatted CSS docstrings\n * @param styleText the CSS text we're working with\n * @param mode a mode associated with the parsed style, if applicable (e.g. this is not applicable for global styles)\n */\nexport function parseStyleDocs(styleDocs: d.StyleDoc[], styleText: string | null, mode?: string | undefined) {\n if (typeof styleText !== 'string') {\n return;\n }\n\n // Using `match` allows us to know which substring matched the regex and the starting\n // index at which the match was found\n let match = styleText.match(CSS_DOC_START);\n while (match !== null) {\n styleText = styleText.substring(match.index + match[0].length);\n\n const endIndex = styleText.indexOf(CSS_DOC_END);\n if (endIndex === -1) {\n break;\n }\n\n const comment = styleText.substring(0, endIndex);\n parseCssComment(styleDocs, comment, mode);\n\n styleText = styleText.substring(endIndex + CSS_DOC_END.length);\n match = styleText.match(CSS_DOC_START);\n }\n}\n\n/**\n * Parse a CSS comment string and insert it into the provided array of\n * style docstrings.\n *\n * @param styleDocs an array which will be modified with the docstring\n * @param comment the comment string\n * @param mode a mode associated with the parsed style, if applicable (e.g. this is not applicable for global styles)\n */\nfunction parseCssComment(styleDocs: d.StyleDoc[], comment: string, mode: string | undefined): void {\n /**\n * @prop --max-width: Max width of the alert\n */\n // (the above is an example of what these comments might look like)\n\n const lines = comment.split(/\\r?\\n/).map((line) => {\n line = line.trim();\n\n while (line.startsWith('*')) {\n line = line.substring(1).trim();\n }\n\n return line;\n });\n\n comment = lines.join(' ').replace(/\\t/g, ' ').trim();\n\n while (comment.includes(' ')) {\n comment = comment.replace(' ', ' ');\n }\n\n const docs = comment.split(CSS_PROP_ANNOTATION);\n\n docs.forEach((d) => {\n const cssDocument = d.trim();\n\n if (!cssDocument.startsWith(`--`)) {\n return;\n }\n\n const splt = cssDocument.split(`:`);\n const styleDoc: d.StyleDoc = {\n name: splt[0].trim(),\n docs: (splt.shift() && splt.join(`:`)).trim(),\n annotation: 'prop',\n mode,\n };\n\n if (!styleDocs.some((c) => c.name === styleDoc.name && c.annotation === 'prop')) {\n styleDocs.push(styleDoc);\n }\n });\n}\n\n/**\n * Opening syntax for a CSS docstring.\n * This will match a traditional docstring or a \"loud\" comment in sass\n */\nconst CSS_DOC_START = /\\/\\*(\\*|\\!)/;\n/**\n * Closing syntax for a CSS docstring\n */\nconst CSS_DOC_END = '*/';\n/**\n * The `@prop` annotation we support within CSS docstrings\n */\nconst CSS_PROP_ANNOTATION = '@prop';\n"
},
{
"path": "src/compiler/docs/test/custom-elements-manifest.spec.ts",
"content": "import { mockCompilerCtx, mockValidatedConfig } from '@stencil/core/testing';\n\nimport type * as d from '../../../declarations';\nimport { generateCustomElementsManifestDocs } from '../cem';\n\ndescribe('custom-elements-manifest', () => {\n let compilerCtx: d.CompilerCtx;\n let writeFileSpy: jest.SpyInstance;\n\n beforeEach(() => {\n const config = mockValidatedConfig();\n compilerCtx = mockCompilerCtx(config);\n writeFileSpy = jest.spyOn(compilerCtx.fs, 'writeFile');\n });\n\n afterEach(() => {\n writeFileSpy.mockRestore();\n });\n\n it('does nothing when no custom-elements-manifest output targets are configured', async () => {\n const docsData: d.JsonDocs = {\n timestamp: 'test',\n compiler: { name: '@stencil/core', version: '1.0.0', typescriptVersion: '4.0.0' },\n components: [],\n typeLibrary: {},\n };\n\n await generateCustomElementsManifestDocs(compilerCtx, docsData, []);\n\n expect(writeFileSpy).not.toHaveBeenCalled();\n });\n\n it('generates manifest with correct schema version', async () => {\n const docsData: d.JsonDocs = {\n timestamp: 'test',\n compiler: { name: '@stencil/core', version: '1.0.0', typescriptVersion: '4.0.0' },\n components: [],\n typeLibrary: {},\n };\n const outputTargets: d.OutputTargetDocsCustomElementsManifest[] = [\n { type: 'docs-custom-elements-manifest', file: '/output/custom-elements.json' },\n ];\n\n await generateCustomElementsManifestDocs(compilerCtx, docsData, outputTargets);\n\n expect(writeFileSpy).toHaveBeenCalledTimes(1);\n const writtenContent = JSON.parse(writeFileSpy.mock.calls[0][1]);\n expect(writtenContent.schemaVersion).toBe('2.1.0');\n expect(writtenContent.modules).toEqual([]);\n });\n\n it('generates module for each component file', async () => {\n const docsData: d.JsonDocs = {\n timestamp: 'test',\n compiler: { name: '@stencil/core', version: '1.0.0', typescriptVersion: '4.0.0' },\n components: [\n createMockComponent({\n tag: 'my-component',\n filePath: 'src/components/my-component/my-component.tsx',\n }),\n ],\n typeLibrary: {},\n };\n const outputTargets: d.OutputTargetDocsCustomElementsManifest[] = [\n { type: 'docs-custom-elements-manifest', file: '/output/custom-elements.json' },\n ];\n\n await generateCustomElementsManifestDocs(compilerCtx, docsData, outputTargets);\n\n const writtenContent = JSON.parse(writeFileSpy.mock.calls[0][1]);\n expect(writtenContent.modules).toHaveLength(1);\n expect(writtenContent.modules[0].kind).toBe('javascript-module');\n expect(writtenContent.modules[0].path).toBe('src/components/my-component/my-component.tsx');\n });\n\n it('converts tag name to PascalCase class name', async () => {\n const docsData: d.JsonDocs = {\n timestamp: 'test',\n compiler: { name: '@stencil/core', version: '1.0.0', typescriptVersion: '4.0.0' },\n components: [\n createMockComponent({\n tag: 'my-awesome-component',\n filePath: 'src/my-component.tsx',\n }),\n ],\n typeLibrary: {},\n };\n const outputTargets: d.OutputTargetDocsCustomElementsManifest[] = [\n { type: 'docs-custom-elements-manifest', file: '/output/custom-elements.json' },\n ];\n\n await generateCustomElementsManifestDocs(compilerCtx, docsData, outputTargets);\n\n const writtenContent = JSON.parse(writeFileSpy.mock.calls[0][1]);\n const declaration = writtenContent.modules[0].declarations[0];\n expect(declaration.name).toBe('MyAwesomeComponent');\n expect(declaration.tagName).toBe('my-awesome-component');\n });\n\n it('includes component description', async () => {\n const docsData: d.JsonDocs = {\n timestamp: 'test',\n compiler: { name: '@stencil/core', version: '1.0.0', typescriptVersion: '4.0.0' },\n components: [\n createMockComponent({\n tag: 'my-component',\n filePath: 'src/my-component.tsx',\n docs: 'This is a test component',\n }),\n ],\n typeLibrary: {},\n };\n const outputTargets: d.OutputTargetDocsCustomElementsManifest[] = [\n { type: 'docs-custom-elements-manifest', file: '/output/custom-elements.json' },\n ];\n\n await generateCustomElementsManifestDocs(compilerCtx, docsData, outputTargets);\n\n const writtenContent = JSON.parse(writeFileSpy.mock.calls[0][1]);\n const declaration = writtenContent.modules[0].declarations[0];\n expect(declaration.description).toBe('This is a test component');\n });\n\n it('includes attributes from props with attr set', async () => {\n const docsData: d.JsonDocs = {\n timestamp: 'test',\n compiler: { name: '@stencil/core', version: '1.0.0', typescriptVersion: '4.0.0' },\n components: [\n createMockComponent({\n tag: 'my-component',\n filePath: 'src/my-component.tsx',\n props: [\n {\n name: 'firstName',\n attr: 'first-name',\n type: 'string',\n docs: 'The first name',\n default: \"'John'\",\n mutable: false,\n reflectToAttr: true,\n docsTags: [],\n values: [],\n optional: false,\n required: false,\n getter: false,\n setter: false,\n },\n ],\n }),\n ],\n typeLibrary: {},\n };\n const outputTargets: d.OutputTargetDocsCustomElementsManifest[] = [\n { type: 'docs-custom-elements-manifest', file: '/output/custom-elements.json' },\n ];\n\n await generateCustomElementsManifestDocs(compilerCtx, docsData, outputTargets);\n\n const writtenContent = JSON.parse(writeFileSpy.mock.calls[0][1]);\n const declaration = writtenContent.modules[0].declarations[0];\n expect(declaration.attributes).toHaveLength(1);\n expect(declaration.attributes[0]).toEqual({\n name: 'first-name',\n description: 'The first name',\n type: { text: 'string' },\n default: \"'John'\",\n fieldName: 'firstName',\n });\n });\n\n it('includes members (fields) from props', async () => {\n const docsData: d.JsonDocs = {\n timestamp: 'test',\n compiler: { name: '@stencil/core', version: '1.0.0', typescriptVersion: '4.0.0' },\n components: [\n createMockComponent({\n tag: 'my-component',\n filePath: 'src/my-component.tsx',\n props: [\n {\n name: 'count',\n type: 'number',\n docs: 'The count value',\n default: '0',\n mutable: false,\n reflectToAttr: false,\n docsTags: [],\n values: [],\n optional: false,\n required: false,\n getter: false,\n setter: false,\n },\n ],\n }),\n ],\n typeLibrary: {},\n };\n const outputTargets: d.OutputTargetDocsCustomElementsManifest[] = [\n { type: 'docs-custom-elements-manifest', file: '/output/custom-elements.json' },\n ];\n\n await generateCustomElementsManifestDocs(compilerCtx, docsData, outputTargets);\n\n const writtenContent = JSON.parse(writeFileSpy.mock.calls[0][1]);\n const declaration = writtenContent.modules[0].declarations[0];\n const field = declaration.members.find((m: any) => m.kind === 'field');\n expect(field).toBeDefined();\n expect(field.name).toBe('count');\n expect(field.type).toEqual({ text: 'number' });\n expect(field.readonly).toBe(true);\n });\n\n it('includes methods', async () => {\n const docsData: d.JsonDocs = {\n timestamp: 'test',\n compiler: { name: '@stencil/core', version: '1.0.0', typescriptVersion: '4.0.0' },\n components: [\n createMockComponent({\n tag: 'my-component',\n filePath: 'src/my-component.tsx',\n methods: [\n {\n name: 'doSomething',\n docs: 'Does something',\n docsTags: [],\n returns: { type: 'Promise', docs: 'Returns nothing' },\n signature: 'doSomething(value: string) => Promise',\n parameters: [{ name: 'value', type: 'string', docs: 'The value to use' }],\n complexType: {\n signature: '(value: string) => Promise',\n parameters: [{ name: 'value', type: 'string', docs: 'The value to use' }],\n return: 'Promise',\n references: {},\n },\n },\n ],\n }),\n ],\n typeLibrary: {},\n };\n const outputTargets: d.OutputTargetDocsCustomElementsManifest[] = [\n { type: 'docs-custom-elements-manifest', file: '/output/custom-elements.json' },\n ];\n\n await generateCustomElementsManifestDocs(compilerCtx, docsData, outputTargets);\n\n const writtenContent = JSON.parse(writeFileSpy.mock.calls[0][1]);\n const declaration = writtenContent.modules[0].declarations[0];\n const method = declaration.members.find((m: any) => m.kind === 'method');\n expect(method).toBeDefined();\n expect(method.name).toBe('doSomething');\n expect(method.description).toBe('Does something');\n expect(method.parameters).toHaveLength(1);\n expect(method.return.type).toEqual({ text: 'Promise' });\n });\n\n it('includes type references from complexType', async () => {\n const docsData: d.JsonDocs = {\n timestamp: 'test',\n compiler: { name: '@stencil/core', version: '1.0.0', typescriptVersion: '4.0.0' },\n components: [\n createMockComponent({\n tag: 'my-component',\n filePath: 'src/my-component.tsx',\n props: [\n {\n name: 'items',\n type: 'MyItem[]',\n docs: 'Array of items',\n mutable: false,\n reflectToAttr: false,\n docsTags: [],\n values: [],\n optional: false,\n required: false,\n getter: false,\n setter: false,\n complexType: {\n original: 'MyItem[]',\n resolved: '{ id: string; name: string }[]',\n references: {\n MyItem: {\n location: 'import',\n path: './types',\n id: 'src/types.ts::MyItem',\n },\n },\n },\n },\n {\n name: 'element',\n type: 'HTMLElement',\n docs: 'An HTML element',\n mutable: false,\n reflectToAttr: false,\n docsTags: [],\n values: [],\n optional: false,\n required: false,\n getter: false,\n setter: false,\n complexType: {\n original: 'HTMLElement',\n resolved: 'HTMLElement',\n references: {\n HTMLElement: {\n location: 'global',\n path: '',\n id: 'global::HTMLElement',\n },\n },\n },\n },\n ],\n events: [\n {\n event: 'itemSelected',\n docs: 'Fired when item is selected',\n detail: 'MyItem',\n bubbles: true,\n cancelable: false,\n composed: true,\n docsTags: [],\n complexType: {\n original: 'MyItem',\n resolved: '{ id: string; name: string }',\n references: {\n MyItem: {\n location: 'import',\n path: './types',\n id: 'src/types.ts::MyItem',\n },\n },\n },\n },\n ],\n }),\n ],\n typeLibrary: {},\n };\n const outputTargets: d.OutputTargetDocsCustomElementsManifest[] = [\n { type: 'docs-custom-elements-manifest', file: '/output/custom-elements.json' },\n ];\n\n await generateCustomElementsManifestDocs(compilerCtx, docsData, outputTargets);\n\n const writtenContent = JSON.parse(writeFileSpy.mock.calls[0][1]);\n const declaration = writtenContent.modules[0].declarations[0];\n\n // Check prop with imported type reference\n const itemsField = declaration.members.find((m: any) => m.name === 'items');\n expect(itemsField.type.text).toBe('MyItem[]');\n expect(itemsField.type.references).toEqual([{ name: 'MyItem', module: './types' }]);\n\n // Check prop with global type reference\n const elementField = declaration.members.find((m: any) => m.name === 'element');\n expect(elementField.type.text).toBe('HTMLElement');\n expect(elementField.type.references).toEqual([{ name: 'HTMLElement', package: 'global:' }]);\n\n // Check event with type reference\n const event = declaration.events[0];\n expect(event.type.text).toBe('CustomEvent');\n expect(event.type.references).toEqual([{ name: 'MyItem', module: './types' }]);\n });\n\n it('includes events', async () => {\n const docsData: d.JsonDocs = {\n timestamp: 'test',\n compiler: { name: '@stencil/core', version: '1.0.0', typescriptVersion: '4.0.0' },\n components: [\n createMockComponent({\n tag: 'my-component',\n filePath: 'src/my-component.tsx',\n events: [\n {\n event: 'myEvent',\n docs: 'Fired when something happens',\n detail: 'string',\n bubbles: true,\n cancelable: true,\n composed: true,\n docsTags: [],\n complexType: {\n original: 'string',\n resolved: 'string',\n references: {},\n },\n },\n ],\n }),\n ],\n typeLibrary: {},\n };\n const outputTargets: d.OutputTargetDocsCustomElementsManifest[] = [\n { type: 'docs-custom-elements-manifest', file: '/output/custom-elements.json' },\n ];\n\n await generateCustomElementsManifestDocs(compilerCtx, docsData, outputTargets);\n\n const writtenContent = JSON.parse(writeFileSpy.mock.calls[0][1]);\n const declaration = writtenContent.modules[0].declarations[0];\n expect(declaration.events).toHaveLength(1);\n expect(declaration.events[0]).toEqual({\n name: 'myEvent',\n description: 'Fired when something happens',\n type: { text: 'CustomEvent' },\n });\n });\n\n it('includes slots', async () => {\n const docsData: d.JsonDocs = {\n timestamp: 'test',\n compiler: { name: '@stencil/core', version: '1.0.0', typescriptVersion: '4.0.0' },\n components: [\n createMockComponent({\n tag: 'my-component',\n filePath: 'src/my-component.tsx',\n slots: [\n { name: '', docs: 'Default slot content' },\n { name: 'header', docs: 'Header slot' },\n ],\n }),\n ],\n typeLibrary: {},\n };\n const outputTargets: d.OutputTargetDocsCustomElementsManifest[] = [\n { type: 'docs-custom-elements-manifest', file: '/output/custom-elements.json' },\n ];\n\n await generateCustomElementsManifestDocs(compilerCtx, docsData, outputTargets);\n\n const writtenContent = JSON.parse(writeFileSpy.mock.calls[0][1]);\n const declaration = writtenContent.modules[0].declarations[0];\n expect(declaration.slots).toHaveLength(2);\n expect(declaration.slots[0]).toEqual({ name: '', description: 'Default slot content' });\n expect(declaration.slots[1]).toEqual({ name: 'header', description: 'Header slot' });\n });\n\n it('includes demos from usage examples', async () => {\n const docsData: d.JsonDocs = {\n timestamp: 'test',\n compiler: { name: '@stencil/core', version: '1.0.0', typescriptVersion: '4.0.0' },\n components: [\n createMockComponent({\n tag: 'my-component',\n filePath: 'src/components/my-component/my-component.tsx',\n usagesDir: 'src/components/my-component/usage',\n usage: {\n angular: '```html\\n = {}): d.JsonDocsComponent {\n return {\n dirPath: '',\n fileName: 'my-component.tsx',\n filePath: 'src/my-component.tsx',\n readmePath: 'src/readme.md',\n usagesDir: 'src/usage',\n tag: 'my-component',\n readme: '',\n overview: '',\n usage: {},\n docs: '',\n docsTags: [],\n encapsulation: 'shadow',\n dependents: [],\n dependencies: [],\n dependencyGraph: {},\n props: [],\n methods: [],\n events: [],\n styles: [],\n slots: [],\n parts: [],\n customStates: [],\n listeners: [],\n ...overrides,\n };\n}\n"
},
{
"path": "src/compiler/docs/test/docs-util.spec.ts",
"content": "import { isHexColor, MarkdownTable } from '../../docs/readme/docs-util';\n\ndescribe('markdown-table', () => {\n it('header', () => {\n const t = new MarkdownTable();\n t.addHeader(['Column 1', 'Column 22', 'Column\\n333']);\n t.addRow(['Text 1', 'Text 2']);\n const o = t.toMarkdown();\n expect(o).toEqual([\n '| Column 1 | Column 22 | Column 333 |',\n '| -------- | --------- | ---------- |',\n '| Text 1 | Text 2 | |',\n ]);\n });\n\n it('longest column', () => {\n const t = new MarkdownTable();\n t.addRow(['Text aa', 'Text b', 'Text c']);\n t.addRow(['Text a', 'Text bb', 'Text c']);\n t.addRow(['Text a', 'Text bb', 'Text cc']);\n const o = t.toMarkdown();\n expect(o).toEqual([\n '| Text aa | Text b | Text c |',\n '| Text a | Text bb | Text c |',\n '| Text a | Text bb | Text cc |',\n ]);\n });\n\n it('3 columns', () => {\n const t = new MarkdownTable();\n t.addRow(['Text 1', 'Text 2', 'Text 3']);\n const o = t.toMarkdown();\n expect(o).toEqual(['| Text 1 | Text 2 | Text 3 |']);\n });\n\n it('one column', () => {\n const t = new MarkdownTable();\n t.addRow(['Text']);\n const o = t.toMarkdown();\n expect(o).toEqual(['| Text |']);\n });\n\n it('do nothing', () => {\n const t = new MarkdownTable();\n const o = t.toMarkdown();\n expect(o).toEqual([]);\n });\n});\n\ndescribe('isHexColor', () => {\n it('should return true for valid hex colors', () => {\n expect(isHexColor('#FFF')).toBe(true);\n expect(isHexColor('#FFFFFF')).toBe(true);\n expect(isHexColor('#000000')).toBe(true);\n expect(isHexColor('#f0f0f0')).toBe(true);\n expect(isHexColor('#aBcDeF')).toBe(true);\n });\n\n it('should return false for invalid hex colors', () => {\n expect(isHexColor('FFF')).toBe(false);\n expect(isHexColor('#GGGGGG')).toBe(false);\n expect(isHexColor('#FF')).toBe(false);\n expect(isHexColor('#FFFFFFF')).toBe(false);\n expect(isHexColor('#FF0000FF')).toBe(false);\n });\n\n it('should return false for non-string inputs', () => {\n expect(isHexColor('123')).toBe(false);\n expect(isHexColor('true')).toBe(false);\n expect(isHexColor('{}')).toBe(false);\n expect(isHexColor('[]')).toBe(false);\n });\n});\n"
},
{
"path": "src/compiler/docs/test/generate-doc-data.spec.ts",
"content": "import { mockBuildCtx, mockCompilerCtx, mockModule, mockValidatedConfig } from '@stencil/core/testing';\nimport { DEFAULT_STYLE_MODE, getComponentsFromModules } from '@utils';\n\nimport type * as d from '../../../declarations';\nimport { stubComponentCompilerMeta } from '../../types/tests/ComponentCompilerMeta.stub';\nimport { AUTO_GENERATE_COMMENT } from '../constants';\nimport { generateDocData, getDocsStyles } from '../generate-doc-data';\n\ndescribe('generate-doc-data', () => {\n describe('getDocsComponents', () => {\n let moduleCmpWithJsdoc: d.Module;\n let moduleCmpNoJsdoc: d.Module;\n\n beforeEach(() => {\n moduleCmpWithJsdoc = mockModule({\n cmps: [\n stubComponentCompilerMeta({\n docs: {\n tags: [],\n text: 'This is the overview of `my-component`',\n },\n }),\n ],\n });\n moduleCmpNoJsdoc = mockModule({\n cmps: [\n stubComponentCompilerMeta({\n docs: {\n tags: [],\n text: '',\n },\n }),\n ],\n });\n });\n\n /**\n * Setup function for the {@link generateDocData} function exported by the module under test\n * @param moduleMap a map of {@link d.ModuleMap} entities to add to the returned compiler and build contexts\n * @returns the arguments required to invoke the method under test\n */\n const setup = (\n moduleMap: d.ModuleMap,\n ): { validatedConfig: d.ValidatedConfig; compilerCtx: d.CompilerCtx; buildCtx: d.BuildCtx } => {\n const validatedConfig: d.ValidatedConfig = mockValidatedConfig();\n\n const compilerCtx: d.CompilerCtx = mockCompilerCtx(validatedConfig);\n compilerCtx.moduleMap = moduleMap;\n\n const modules = Array.from(compilerCtx.moduleMap.values());\n const buildCtx: d.BuildCtx = mockBuildCtx(validatedConfig, compilerCtx);\n buildCtx.moduleFiles = modules;\n buildCtx.components = getComponentsFromModules(modules);\n\n return { validatedConfig, compilerCtx, buildCtx };\n };\n\n describe('component JSDoc overview', () => {\n it(\"takes the value from the component's JSDoc\", async () => {\n const moduleMap: d.ModuleMap = new Map();\n moduleMap.set('path/to/component.tsx', moduleCmpWithJsdoc);\n const { validatedConfig, compilerCtx, buildCtx } = setup(moduleMap);\n\n const generatedDocData = await generateDocData(validatedConfig, compilerCtx, buildCtx);\n\n expect(generatedDocData.components).toHaveLength(1);\n const componentDocData = generatedDocData.components[0];\n expect(componentDocData.overview).toBe('This is the overview of `my-component`');\n });\n\n it('sets the value to the empty string when there is no JSDoc', async () => {\n const moduleMap: d.ModuleMap = new Map();\n moduleMap.set('path/to/component.tsx', moduleCmpNoJsdoc);\n const { validatedConfig, compilerCtx, buildCtx } = setup(moduleMap);\n\n const generatedDocData = await generateDocData(validatedConfig, compilerCtx, buildCtx);\n\n expect(generatedDocData.components).toHaveLength(1);\n const componentDocData = generatedDocData.components[0];\n expect(componentDocData.overview).toBe('');\n });\n });\n\n describe('docs content', () => {\n it(\"sets the field's contents to the jsdoc text if present\", async () => {\n const moduleMap: d.ModuleMap = new Map();\n moduleMap.set('path/to/component.tsx', moduleCmpWithJsdoc);\n const { validatedConfig, compilerCtx, buildCtx } = setup(moduleMap);\n\n const generatedDocData = await generateDocData(validatedConfig, compilerCtx, buildCtx);\n\n expect(generatedDocData.components).toHaveLength(1);\n const componentDocData = generatedDocData.components[0];\n expect(componentDocData.docs).toBe('This is the overview of `my-component`');\n });\n\n it(\"sets the field's contents to an empty string if neither the readme, nor jsdoc are set\", async () => {\n const moduleMap: d.ModuleMap = new Map();\n moduleMap.set('path/to/component.tsx', moduleCmpNoJsdoc);\n const { validatedConfig, compilerCtx, buildCtx } = setup(moduleMap);\n\n const generatedDocData = await generateDocData(validatedConfig, compilerCtx, buildCtx);\n\n expect(generatedDocData.components).toHaveLength(1);\n const componentDocData = generatedDocData.components[0];\n expect(componentDocData.docs).toBe('');\n });\n\n it(\"sets the field's contents to an empty string if the readme doesn't contain the autogenerated comment\", async () => {\n const moduleMap: d.ModuleMap = new Map();\n moduleMap.set('path/to/component.tsx', moduleCmpNoJsdoc);\n const { validatedConfig, compilerCtx, buildCtx } = setup(moduleMap);\n\n await compilerCtx.fs.writeFile('readme.md', 'this is manually generated user content');\n\n const generatedDocData = await generateDocData(validatedConfig, compilerCtx, buildCtx);\n\n expect(generatedDocData.components).toHaveLength(1);\n const componentDocData = generatedDocData.components[0];\n expect(componentDocData.docs).toBe('');\n });\n\n it(\"sets the field's contents to manually generated content when the autogenerated comment is present\", async () => {\n const moduleMap: d.ModuleMap = new Map();\n moduleMap.set('path/to/component.tsx', moduleCmpNoJsdoc);\n const { validatedConfig, compilerCtx, buildCtx } = setup(moduleMap);\n\n await compilerCtx.fs.writeFile(\n 'readme.md',\n `this is manually generated user content\\n${AUTO_GENERATE_COMMENT}\\nauto-generated content`,\n );\n\n const generatedDocData = await generateDocData(validatedConfig, compilerCtx, buildCtx);\n\n expect(generatedDocData.components).toHaveLength(1);\n const componentDocData = generatedDocData.components[0];\n expect(componentDocData.docs).toBe('this is manually generated user content');\n });\n\n it(\"sets the field's contents to a subset of the manually generated content\", async () => {\n const moduleMap: d.ModuleMap = new Map();\n moduleMap.set('path/to/component.tsx', moduleCmpNoJsdoc);\n const { validatedConfig, compilerCtx, buildCtx } = setup(moduleMap);\n\n const readmeContent = `\nthis is manually generated user content\n\n# user header\nuser content\n\n# another user header\nmore user content\n\n${AUTO_GENERATE_COMMENT}\n\n#some-header\n\nauto-generated content\n`;\n await compilerCtx.fs.writeFile('readme.md', readmeContent);\n\n const generatedDocData = await generateDocData(validatedConfig, compilerCtx, buildCtx);\n\n expect(generatedDocData.components).toHaveLength(1);\n const componentDocData = generatedDocData.components[0];\n expect(componentDocData.docs).toBe('this is manually generated user content');\n });\n\n it(\"sets the field's contents to a an empty string when the manually generated content starts with a '#'\", async () => {\n const moduleMap: d.ModuleMap = new Map();\n moduleMap.set('path/to/component.tsx', moduleCmpNoJsdoc);\n const { validatedConfig, compilerCtx, buildCtx } = setup(moduleMap);\n\n const readmeContent = `\n# header that leads to skipping\nthis is manually generated user content\n\n# user header\nuser content\n\n# another user header\nmore user content\n\n${AUTO_GENERATE_COMMENT}\n\n#some-header\n\nauto-generated content\n`;\n await compilerCtx.fs.writeFile('readme.md', readmeContent);\n\n const generatedDocData = await generateDocData(validatedConfig, compilerCtx, buildCtx);\n\n expect(generatedDocData.components).toHaveLength(1);\n const componentDocData = generatedDocData.components[0];\n expect(componentDocData.docs).toBe('');\n });\n });\n });\n\n describe('getDocsStyles', () => {\n it('returns an empty array if no styleDocs exist on the compiler metadata', () => {\n const compilerMeta = stubComponentCompilerMeta();\n // @ts-ignore - the intent of this test is to verify allocation of a new array if for some reason this is missing\n compilerMeta.styleDocs = null;\n\n const actual = getDocsStyles(compilerMeta);\n\n expect(actual).toEqual([]);\n });\n\n it('returns an empty array if empty styleDocs exist on the compiler metadata', () => {\n const compilerMeta = stubComponentCompilerMeta({ styleDocs: [] });\n\n const actual = getDocsStyles(compilerMeta);\n\n expect(actual).toEqual([]);\n });\n\n it(\"returns a 'sorted' array of one CompilerStyleDoc\", () => {\n const compilerStyleDoc: d.CompilerStyleDoc = {\n annotation: 'prop',\n docs: 'these are the docs for this prop',\n name: 'my-style-one',\n mode: 'md',\n };\n const compilerMeta = stubComponentCompilerMeta({ styleDocs: [compilerStyleDoc] });\n\n const actual = getDocsStyles(compilerMeta);\n\n expect(actual).toEqual([compilerStyleDoc]);\n });\n\n it('returns a sorted array from multiple CompilerStyleDoc', () => {\n const compilerStyleDocOne: d.CompilerStyleDoc = {\n annotation: 'prop',\n docs: 'these are the docs for my-style-a',\n name: 'my-style-a',\n mode: 'ios',\n };\n const compilerStyleDocTwo: d.CompilerStyleDoc = {\n annotation: 'prop',\n docs: 'these are more docs for my-style-b',\n name: 'my-style-b',\n mode: 'ios',\n };\n const compilerStyleDocThree: d.CompilerStyleDoc = {\n annotation: 'prop',\n docs: 'these are more docs for my-style-c',\n name: 'my-style-c',\n mode: 'ios',\n };\n const compilerMeta = stubComponentCompilerMeta({\n styleDocs: [compilerStyleDocOne, compilerStyleDocThree, compilerStyleDocTwo],\n });\n\n const actual = getDocsStyles(compilerMeta);\n\n expect(actual).toEqual([compilerStyleDocOne, compilerStyleDocTwo, compilerStyleDocThree]);\n });\n\n it('returns a sorted array from based on mode for the same name', () => {\n const mdCompilerStyle: d.CompilerStyleDoc = {\n annotation: 'prop',\n docs: 'these are the docs for my-style-a',\n name: 'my-style-a',\n mode: 'md',\n };\n const iosCompilerStyle: d.CompilerStyleDoc = {\n annotation: 'prop',\n docs: 'these are the docs for my-style-a',\n name: 'my-style-a',\n mode: 'ios',\n };\n const compilerMeta = stubComponentCompilerMeta({\n styleDocs: [mdCompilerStyle, iosCompilerStyle],\n });\n\n const actual = getDocsStyles(compilerMeta);\n\n expect(actual).toEqual([iosCompilerStyle, mdCompilerStyle]);\n });\n });\n\n it(\"returns CompilerStyleDoc with the same name in the order they're provided\", () => {\n const compilerStyleDocOne: d.CompilerStyleDoc = {\n annotation: 'prop',\n docs: 'these are the docs for my-style-a (first lowercase)',\n name: 'my-style-a',\n mode: 'ios',\n };\n const compilerStyleDocTwo: d.CompilerStyleDoc = {\n annotation: 'prop',\n docs: 'these are more docs for my-style-A (only capital)',\n name: 'my-style-A',\n mode: 'ios',\n };\n const compilerStyleDocThree: d.CompilerStyleDoc = {\n annotation: 'prop',\n docs: 'these are more docs for my-style-a (second lowercase)',\n name: 'my-style-a',\n mode: 'ios',\n };\n const compilerMeta = stubComponentCompilerMeta({\n styleDocs: [compilerStyleDocOne, compilerStyleDocThree, compilerStyleDocTwo],\n });\n\n const actual = getDocsStyles(compilerMeta);\n\n expect(actual).toEqual([compilerStyleDocOne, compilerStyleDocThree, compilerStyleDocTwo]);\n });\n\n describe('default values', () => {\n it.each(['', null, undefined])(\n \"defaults the annotation to an empty string if '%s' is provided\",\n (annotationValue) => {\n const compilerStyleDoc: d.CompilerStyleDoc = {\n annotation: 'prop',\n docs: 'these are the docs for this prop',\n name: 'my-style-one',\n mode: DEFAULT_STYLE_MODE,\n };\n // @ts-ignore the intent of this test to verify the fallback of this field if it's falsy\n compilerStyleDoc.annotation = annotationValue;\n\n const compilerMeta = stubComponentCompilerMeta({ styleDocs: [compilerStyleDoc] });\n\n const actual = getDocsStyles(compilerMeta);\n\n expect(actual).toEqual([\n {\n annotation: '',\n docs: 'these are the docs for this prop',\n name: 'my-style-one',\n },\n ]);\n },\n );\n\n it.each(['', null, undefined])(\"defaults the docs to an empty string if '%s' is provided\", (docsValue) => {\n const compilerStyleDoc: d.CompilerStyleDoc = {\n annotation: 'prop',\n docs: 'these are the docs for this prop',\n name: 'my-style-one',\n mode: DEFAULT_STYLE_MODE,\n };\n // @ts-ignore the intent of this test to verify the fallback of this field if it's falsy\n compilerStyleDoc.docs = docsValue;\n\n const compilerMeta = stubComponentCompilerMeta({ styleDocs: [compilerStyleDoc] });\n\n const actual = getDocsStyles(compilerMeta);\n\n expect(actual).toEqual([\n {\n annotation: 'prop',\n docs: '',\n name: 'my-style-one',\n },\n ]);\n });\n\n it.each(['', undefined, null, DEFAULT_STYLE_MODE])(\n \"uses 'undefined' for the mode value when '%s' is provided\",\n (modeValue) => {\n const compilerStyleDoc: d.CompilerStyleDoc = {\n annotation: 'prop',\n docs: 'these are the docs for this prop',\n name: 'my-style-one',\n // we intentionally set this to non-compliant types for the purpose of this test, hence the type assertion\n mode: modeValue as unknown as string,\n };\n\n const compilerMeta = stubComponentCompilerMeta({ styleDocs: [compilerStyleDoc] });\n\n const actual = getDocsStyles(compilerMeta);\n\n expect(actual).toEqual([\n {\n annotation: 'prop',\n docs: 'these are the docs for this prop',\n name: 'my-style-one',\n mode: undefined,\n },\n ]);\n },\n );\n\n it('uses the mode value, when a valid string is provided', () => {\n const compilerStyleDoc: d.CompilerStyleDoc = {\n annotation: 'prop',\n docs: 'these are the docs for this prop',\n name: 'my-style-one',\n mode: 'valid-string',\n };\n\n const compilerMeta = stubComponentCompilerMeta({ styleDocs: [compilerStyleDoc] });\n\n const actual = getDocsStyles(compilerMeta);\n\n expect(actual).toEqual([\n {\n annotation: 'prop',\n docs: 'these are the docs for this prop',\n name: 'my-style-one',\n mode: 'valid-string',\n },\n ]);\n });\n });\n});\n"
},
{
"path": "src/compiler/docs/test/markdown-dependencies.spec.ts",
"content": "import type * as d from '../../../declarations';\nimport { DEFAULT_TARGET_COMPONENT_STYLES } from '../../config/constants';\nimport { depsToMarkdown } from '../readme/markdown-dependencies';\n\ndescribe('depsToMarkdown()', () => {\n it('should use default settings if docs.markdown configuration was not provided', () => {\n const mockConfig = {\n docs: {\n markdown: {\n targetComponent: {\n ...DEFAULT_TARGET_COMPONENT_STYLES,\n },\n },\n },\n } as d.ValidatedConfig;\n const md = depsToMarkdown(\n {\n dependencies: [],\n dependencyGraph: {\n 's-test': ['s-test-dep1'],\n },\n dependents: [],\n docs: '',\n docsTags: [],\n encapsulation: undefined,\n events: [],\n listeners: [],\n methods: [],\n parts: [],\n customStates: [],\n props: [],\n readme: '',\n slots: [],\n styles: [],\n tag: '',\n usage: undefined,\n },\n [],\n mockConfig,\n );\n expect(md).toEqual([\n '## Dependencies',\n '',\n '### Graph',\n '```mermaid',\n 'graph TD;',\n ' s-test --> s-test-dep1',\n ` style fill:${DEFAULT_TARGET_COMPONENT_STYLES.background},stroke:${DEFAULT_TARGET_COMPONENT_STYLES.textColor},stroke-width:4px`,\n '```',\n '',\n ]);\n });\n\n it('should use provided background settings for generated dependencies graph', () => {\n const mockColor = '#445334';\n const mockConfig = {\n docs: {\n markdown: {\n targetComponent: {\n background: mockColor,\n textColor: DEFAULT_TARGET_COMPONENT_STYLES.textColor,\n },\n },\n },\n } as d.ValidatedConfig;\n const md = depsToMarkdown(\n {\n dependencies: [],\n dependencyGraph: {\n 's-test': ['s-test-dep1'],\n },\n dependents: [],\n docs: '',\n docsTags: [],\n encapsulation: undefined,\n events: [],\n listeners: [],\n methods: [],\n parts: [],\n customStates: [],\n props: [],\n readme: '',\n slots: [],\n styles: [],\n tag: '',\n usage: undefined,\n },\n [],\n mockConfig,\n );\n expect(md).toEqual([\n '## Dependencies',\n '',\n '### Graph',\n '```mermaid',\n 'graph TD;',\n ' s-test --> s-test-dep1',\n ` style fill:${mockColor},stroke:${DEFAULT_TARGET_COMPONENT_STYLES.textColor},stroke-width:4px`,\n '```',\n '',\n ]);\n });\n\n it('should use provided text color settings for generated dependencies graph', () => {\n const mockColor = '#445334';\n const mockConfig = {\n docs: {\n markdown: {\n targetComponent: {\n background: DEFAULT_TARGET_COMPONENT_STYLES.background,\n textColor: mockColor,\n },\n },\n },\n } as d.ValidatedConfig;\n const md = depsToMarkdown(\n {\n dependencies: [],\n dependencyGraph: {\n 's-test': ['s-test-dep1'],\n },\n dependents: [],\n docs: '',\n docsTags: [],\n encapsulation: undefined,\n events: [],\n listeners: [],\n methods: [],\n parts: [],\n customStates: [],\n props: [],\n readme: '',\n slots: [],\n styles: [],\n tag: '',\n usage: undefined,\n },\n [],\n mockConfig,\n );\n expect(md).toEqual([\n '## Dependencies',\n '',\n '### Graph',\n '```mermaid',\n 'graph TD;',\n ' s-test --> s-test-dep1',\n ` style fill:${DEFAULT_TARGET_COMPONENT_STYLES.background},stroke:${mockColor},stroke-width:4px`,\n '```',\n '',\n ]);\n });\n});\n"
},
{
"path": "src/compiler/docs/test/markdown-overview.spec.ts",
"content": "import { overviewToMarkdown } from '../readme/markdown-overview';\n\ndescribe('markdown-overview', () => {\n describe('overviewToMarkdown', () => {\n it('returns no overview if no docs exist', () => {\n const generatedOverview = overviewToMarkdown('').join('\\n');\n\n expect(generatedOverview).toBe('');\n });\n\n it('generates a single line overview', () => {\n const generatedOverview = overviewToMarkdown('This is a custom button component').join('\\n');\n\n expect(generatedOverview).toBe(`## Overview\n\nThis is a custom button component\n`);\n });\n\n it('generates a multi-line overview', () => {\n const description = `This is a custom button component.\nIt is to be used throughout the design system.\n\nThis is a comment followed by a newline.\n`;\n const generatedOverview = overviewToMarkdown(description).join('\\n');\n\n expect(generatedOverview).toBe(`## Overview\n\nThis is a custom button component.\nIt is to be used throughout the design system.\n\nThis is a comment followed by a newline.\n`);\n });\n\n it('trims all leading newlines & leaves one at the end', () => {\n const description = `\nThis is a custom button component.\n\n`;\n const generatedOverview = overviewToMarkdown(description).join('\\n');\n\n expect(generatedOverview).toBe(`## Overview\n\nThis is a custom button component.\n`);\n });\n });\n});\n"
},
{
"path": "src/compiler/docs/test/markdown-props.spec.ts",
"content": "import { propsToMarkdown } from '../../docs/readme/markdown-props';\n\ndescribe('markdown props', () => {\n it('advanced union types', () => {\n const markdown = propsToMarkdown([\n {\n name: 'hello',\n attr: 'hello',\n docs: 'This is a prop',\n default: 'false',\n type: 'boolean | string',\n mutable: false,\n optional: false,\n required: false,\n reflectToAttr: false,\n docsTags: [],\n values: [],\n getter: false,\n setter: false,\n },\n {\n name: 'hello',\n attr: undefined,\n docs: 'This is a prop',\n default: 'false',\n type: 'boolean | string',\n mutable: false,\n optional: false,\n required: false,\n reflectToAttr: false,\n docsTags: [],\n values: [],\n getter: false,\n setter: false,\n },\n ]).join('\\n');\n expect(markdown).toEqual(`## Properties\n\n| Property | Attribute | Description | Type | Default |\n| -------- | --------- | -------------- | ------------------- | ------- |\n| \\`hello\\` | \\`hello\\` | This is a prop | \\`boolean \\\\| string\\` | \\`false\\` |\n| \\`hello\\` | -- | This is a prop | \\`boolean \\\\| string\\` | \\`false\\` |\n\n`);\n });\n\n it('escapes template literal types', () => {\n const markdown = propsToMarkdown([\n {\n name: 'width',\n attr: 'width',\n docs: 'Width of the button',\n default: 'undefined',\n type: '`${number}px` | `${number}%`',\n mutable: false,\n optional: false,\n required: false,\n reflectToAttr: false,\n docsTags: [],\n values: [],\n getter: false,\n setter: false,\n },\n ]).join('\\n');\n\n expect(markdown).toEqual(`## Properties\n\n| Property | Attribute | Description | Type | Default |\n| -------- | --------- | ------------------- | ----------------------------------- | ----------- |\n| \\`width\\` | \\`width\\` | Width of the button | \\`\\` \\`\\${number}px\\` \\\\| \\`\\${number}%\\` \\`\\` | \\`undefined\\` |\n\n`);\n });\n\n it('escapes backticks in default value', () => {\n const markdown = propsToMarkdown([\n {\n name: 'quote',\n attr: 'quote',\n docs: 'Quote character',\n default: \"'`'\",\n type: 'string',\n mutable: false,\n optional: false,\n required: false,\n reflectToAttr: false,\n docsTags: [],\n values: [],\n getter: false,\n setter: false,\n },\n ]).join('\\n');\n\n expect(markdown).toEqual(`## Properties\n\n| Property | Attribute | Description | Type | Default |\n| -------- | --------- | --------------- | -------- | --------- |\n| \\`quote\\` | \\`quote\\` | Quote character | \\`string\\` | \\`\\` '\\`' \\`\\` |\n\n`);\n });\n\n it('outputs `undefined` in default column when `prop.default` is undefined', () => {\n const markdown = propsToMarkdown([\n {\n name: 'first',\n attr: 'first',\n docs: 'First name',\n default: undefined,\n type: 'string',\n mutable: false,\n optional: false,\n required: false,\n reflectToAttr: false,\n docsTags: [],\n values: [],\n getter: false,\n setter: false,\n },\n ]).join('\\n');\n\n expect(markdown).toBe(`## Properties\n\n| Property | Attribute | Description | Type | Default |\n| -------- | --------- | ----------- | -------- | ----------- |\n| \\`first\\` | \\`first\\` | First name | \\`string\\` | \\`undefined\\` |\n\n`);\n });\n});\n"
},
{
"path": "src/compiler/docs/test/output-docs.spec.ts",
"content": "import type * as d from '../../../declarations';\nimport { generateMarkdown } from '../readme/output-docs';\n\ndescribe('css-props to markdown', () => {\n describe('generateMarkdown', () => {\n const mockReadmeOutput: d.OutputTargetDocsReadme = {\n type: 'docs-readme',\n footer: '*Built with StencilJS*',\n };\n\n const mockComponent: d.JsonDocsComponent = {\n tag: 'my-component',\n filePath: 'src/components/my-component/my-component.tsx',\n fileName: 'my-component.tsx',\n dirPath: 'src/components/my-component',\n readmePath: 'src/components/my-component/readme.md',\n usagesDir: 'src/components/my-component/usage',\n encapsulation: 'shadow',\n docs: '',\n docsTags: [],\n usage: {},\n props: [],\n methods: [],\n events: [],\n listeners: [],\n styles: [],\n slots: [],\n parts: [],\n dependents: [],\n dependencies: [],\n dependencyGraph: {},\n customStates: [],\n readme: '',\n };\n\n it.each([\n {\n name: 'component styles when available',\n componentStyles: [\n { name: '--background', docs: 'Background color', annotation: 'prop' as const, mode: undefined },\n { name: '--color', docs: 'Text color', annotation: 'prop' as const, mode: undefined },\n ],\n shouldContain: ['## CSS Custom Properties', '`--background`', 'Background color', '`--color`', 'Text color'],\n shouldNotContain: [],\n },\n {\n name: 'preserved CSS props (already in component.styles)',\n componentStyles: [\n {\n name: '--bg',\n docs: 'Defaults to var(--nano-color-blue-cerulean-1000);',\n annotation: 'prop' as const,\n mode: undefined,\n },\n { name: '--text-color', docs: 'Text color of the component', annotation: 'prop' as const, mode: undefined },\n ],\n shouldContain: ['## CSS Custom Properties', '`--bg`', 'Defaults to var(--nano-color-blue-cerulean-1000);'],\n shouldNotContain: [],\n },\n {\n name: 'no CSS section when styles are empty',\n componentStyles: [],\n shouldContain: [],\n shouldNotContain: ['## CSS Custom Properties'],\n },\n {\n name: 'updated component styles',\n componentStyles: [\n { name: '--new-prop', docs: 'New property from build', annotation: 'prop' as const, mode: undefined },\n ],\n shouldContain: ['`--new-prop`', 'New property from build'],\n shouldNotContain: [],\n },\n ])('should use $name', ({ componentStyles, shouldContain, shouldNotContain }) => {\n const component: d.JsonDocsComponent = {\n ...mockComponent,\n styles: componentStyles,\n };\n\n const markdown = generateMarkdown('# my-component', component, [], mockReadmeOutput);\n\n shouldContain.forEach((expected) => {\n expect(markdown).toContain(expected);\n });\n\n shouldNotContain.forEach((unexpected) => {\n expect(markdown).not.toContain(unexpected);\n });\n });\n\n it('should escape special characters in CSS prop descriptions', () => {\n const component: d.JsonDocsComponent = {\n ...mockComponent,\n styles: [\n {\n name: '--bg',\n docs: 'Defaults to var(--nano-color-blue-cerulean-1000); with | pipes',\n annotation: 'prop',\n mode: undefined,\n },\n ],\n };\n\n const markdown = generateMarkdown('# my-component', component, [], mockReadmeOutput);\n\n // Pipe characters are escaped in markdown tables\n expect(markdown).toContain('Defaults to var(--nano-color-blue-cerulean-1000); with \\\\| pipes');\n });\n });\n});\n"
},
{
"path": "src/compiler/docs/test/style-docs.spec.ts",
"content": "import type * as d from '@stencil/core/declarations';\nimport { DEFAULT_STYLE_MODE } from '@utils';\n\nimport { parseStyleDocs } from '../style-docs';\n\ndescribe('style-docs', () => {\n let styleDocs: d.StyleDoc[];\n\n beforeEach(() => {\n styleDocs = [];\n });\n\n it('no docs', () => {\n const styleText = `\n /**\n * @prop --max-width\n */\n\n body {\n color: red;\n }\n `;\n parseStyleDocs(styleDocs, styleText);\n expect(styleDocs).toEqual([{ name: `--max-width`, docs: ``, annotation: 'prop' }]);\n });\n\n it('multiline', () => {\n const styleText = `\n /**\n * @prop --color: This is the docs\n * for color.\n @prop --background : This is the docs\n for background. It is two\n * sentences and some :: man.\n */\n body {\n color: red;\n }\n `;\n parseStyleDocs(styleDocs, styleText);\n expect(styleDocs).toEqual([\n { name: `--color`, docs: `This is the docs for color.`, annotation: 'prop' },\n {\n name: `--background`,\n docs: `This is the docs for background. It is two sentences and some :: man.`,\n annotation: 'prop',\n },\n ]);\n });\n\n it('docs', () => {\n const styleText = `\n /**\n * @prop --max-width: Max width of the alert\n * @prop --color: Descript with : in it\n * * @prop --background: background docs\n @prop --font-weight: font-weight docs\n */\n\n html {\n height: 100%;\n }\n\n /**\n * @prop --border: border docs\n * @prop --font-size: font-size docs\n */\n\n /** @prop --padding: padding docs */\n\n body {\n color: red;\n }\n `;\n parseStyleDocs(styleDocs, styleText);\n expect(styleDocs).toEqual([\n { name: `--max-width`, docs: `Max width of the alert`, annotation: 'prop' },\n { name: `--color`, docs: `Descript with : in it`, annotation: 'prop' },\n { name: `--background`, docs: `background docs`, annotation: 'prop' },\n { name: `--font-weight`, docs: `font-weight docs`, annotation: 'prop' },\n { name: `--border`, docs: `border docs`, annotation: 'prop' },\n { name: `--font-size`, docs: `font-size docs`, annotation: 'prop' },\n { name: `--padding`, docs: `padding docs`, annotation: 'prop' },\n ]);\n });\n\n it('invalid css prop comment', () => {\n const styleText = `\n /**\n * hello\n * @prop max-width: Max width of the alert\n * --max-width: Max width of the alert\n */\n /*\n * @prop --max-width\n */\n /* hi i'm normal comments */\n body {\n color: red;\n }\n `;\n parseStyleDocs(styleDocs, styleText);\n expect(styleDocs).toEqual([]);\n });\n\n it('no closing comments', () => {\n const styleText = `\n /**\n body {\n color: red;\n }\n `;\n parseStyleDocs(styleDocs, styleText);\n expect(styleDocs).toEqual([]);\n });\n\n it('no comments', () => {\n const styleText = `\n body {\n color: red;\n }\n `;\n parseStyleDocs(styleDocs, styleText);\n expect(styleDocs).toEqual([]);\n });\n\n it('empty styleText', () => {\n const styleText = ``;\n parseStyleDocs(styleDocs, styleText);\n expect(styleDocs).toEqual([]);\n });\n\n it('null styleText', () => {\n const styleText: null = null;\n parseStyleDocs(styleDocs, styleText);\n expect(styleDocs).toEqual([]);\n });\n\n it('works with sass loud comments', () => {\n const styleText = `\n /*!\n * @prop --max-width: Max width of the alert\n */\n body {\n color: red;\n }\n `;\n parseStyleDocs(styleDocs, styleText);\n expect(styleDocs).toEqual([{ name: `--max-width`, docs: `Max width of the alert`, annotation: 'prop' }]);\n });\n\n it('works with multiple, mixed comment types', () => {\n const styleText = `\n /**\n * @prop --max-width: Max width of the alert\n */\n /*!\n * @prop --max-width-loud: Max width of the alert (loud)\n */\n body {\n color: red;\n }\n `;\n parseStyleDocs(styleDocs, styleText);\n expect(styleDocs).toEqual([\n { name: `--max-width`, docs: `Max width of the alert`, annotation: 'prop' },\n { name: `--max-width-loud`, docs: `Max width of the alert (loud)`, annotation: 'prop' },\n ]);\n });\n\n it.each(['ios', 'md', undefined, '', DEFAULT_STYLE_MODE])(\"attaches mode metadata for a style mode '%s'\", (mode) => {\n const styleText = `\n /*!\n * @prop --max-width: Max width of the alert\n */\n body {\n color: red;\n }\n `;\n\n parseStyleDocs(styleDocs, styleText, mode);\n\n expect(styleDocs).toEqual([{ name: `--max-width`, docs: `Max width of the alert`, annotation: 'prop', mode }]);\n });\n});\n"
},
{
"path": "src/compiler/docs/test/tsconfig.json",
"content": "{\n \"extends\": \"../../../testing/tsconfig.internal.json\"\n}\n"
},
{
"path": "src/compiler/docs/vscode/index.ts",
"content": "import { isOutputTargetDocsVscode, join } from '@utils';\n\nimport type * as d from '../../../declarations';\nimport { getNameText } from '../generate-doc-data';\n\n/**\n * Generate [custom data](https://github.com/microsoft/vscode-custom-data) to augment existing HTML types in VS Code.\n * This function writes the custom data as a JSON file to disk, which can be used in VS Code to inform the IDE about\n * custom elements generated by Stencil.\n *\n * The JSON generated by this function must conform to the\n * [HTML custom data schema](https://github.com/microsoft/vscode-html-languageservice/blob/e7ae8a7170df5e721a13cee1b86e293b24eb3b20/docs/customData.schema.json).\n *\n * This function generates custom data for HTML only at this time (it does not generate custom data for CSS).\n *\n * @param compilerCtx the current compiler context\n * @param docsData an intermediate representation documentation derived from compiled Stencil components\n * @param outputTargets the output target(s) the associated with the current build\n */\nexport const generateVscodeDocs = async (\n compilerCtx: d.CompilerCtx,\n docsData: d.JsonDocs,\n outputTargets: d.OutputTarget[],\n): Promise => {\n const vsCodeOutputTargets = outputTargets.filter(isOutputTargetDocsVscode);\n if (vsCodeOutputTargets.length === 0) {\n return;\n }\n\n await Promise.all(\n vsCodeOutputTargets.map(async (outputTarget: d.OutputTargetDocsVscode): Promise => {\n const json = {\n /**\n * the 'version' top-level field is required by the schema. changes to the JSON generated by Stencil must:\n * - comply with v1.X of the schema _OR_\n * - increment this field as a part of updating the JSON generation. This should be considered a breaking change\n *\n * {@link https://github.com/microsoft/vscode-html-languageservice/blob/e7ae8a7170df5e721a13cee1b86e293b24eb3b20/src/htmlLanguageTypes.ts#L184}\n */\n version: 1.1,\n tags: docsData.components.map((cmp: d.JsonDocsComponent) => ({\n name: cmp.tag,\n description: {\n kind: 'markdown',\n value: cmp.docs,\n },\n attributes: cmp.props\n .filter((p: d.JsonDocsProp): p is DocPropWithAttribute => p.attr !== undefined && p.attr.length > 0)\n .map(serializeAttribute),\n references: getReferences(cmp, outputTarget.sourceCodeBaseUrl),\n })),\n };\n\n // fields in the custom data may have a value of `undefined`. calling `stringify` will remove such fields.\n const jsonContent = JSON.stringify(json, null, 2);\n await compilerCtx.fs.writeFile(outputTarget.file, jsonContent);\n }),\n );\n};\n\n/**\n * This type describes external references for a custom element.\n *\n * An internal representation of Microsoft/VS Code's [`IReference` type](https://github.com/microsoft/vscode-html-languageservice/blob/e7ae8a7170df5e721a13cee1b86e293b24eb3b20/src/htmlLanguageTypes.ts#L153).\n */\ntype TagReference = {\n name: string;\n url: string;\n};\n\n/**\n * Generate a 'references' section for a component's documentation.\n * @param cmp the Stencil component to generate a references section for\n * @param repoBaseUrl an optional URL, that when provided, will add a reference to the source code for the component\n * @returns the generated references section, or undefined if no references could be generated\n */\nconst getReferences = (cmp: d.JsonDocsComponent, repoBaseUrl: string | undefined): TagReference[] | undefined => {\n // collect any `@reference` JSDoc tags on the component\n const references = getNameText('reference', cmp.docsTags).map(([name, url]) => ({ name, url }));\n\n if (repoBaseUrl) {\n references.push({\n name: 'Source code',\n url: join(repoBaseUrl, cmp.filePath ?? ''),\n });\n }\n if (references.length > 0) {\n return references;\n }\n return undefined;\n};\n\n/**\n * A type that describes the attributes that can be used with a custom element.\n *\n * An internal representation of Microsoft/VS Code's [`IAttributeData` type](https://github.com/microsoft/vscode-html-languageservice/blob/e7ae8a7170df5e721a13cee1b86e293b24eb3b20/src/htmlLanguageTypes.ts#L165).\n */\ntype AttributeData = {\n name: string;\n description: string;\n values?: { name: string }[];\n};\n\n/**\n * Utility that provides a type-safe way of making a key K on a type T required.\n *\n * This is preferable than using an intersection of `T & {K: someType}` as it ensures that:\n * - the type of K will always match the type T[K]\n * - it should error should K not exist in `keyof T`\n */\ntype WithRequired