@locker/cli 0.28.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.txt +21 -0
- package/README.md +813 -0
- package/bin/lws.mjs +209 -0
- package/dist/index.cjs.d.ts +2 -0
- package/dist/index.cjs.d.ts.map +1 -0
- package/dist/index.cjs.js +5 -0
- package/dist/index.mjs.d.ts +2 -0
- package/dist/index.mjs.d.ts.map +1 -0
- package/dist/index.mjs.js +5 -0
- package/dist/lwc-engine.js +8432 -0
- package/dist/lws-sandbox.js +18781 -0
- package/dist/purify.js +3 -0
- package/package.json +45 -0
- package/src/before-after.mjs +47 -0
- package/src/browser.mjs +186 -0
- package/src/compile-lwc.mjs +181 -0
- package/src/completion.mjs +166 -0
- package/src/constants.mjs +15 -0
- package/src/endowments.mjs +189 -0
- package/src/harness/component.html +14 -0
- package/src/harness/eval.html +12 -0
- package/src/index.ts +1 -0
- package/src/input-resolver.mjs +63 -0
- package/src/lwc-engine-entry.js +8 -0
- package/src/output.mjs +168 -0
- package/src/repl.mjs +527 -0
- package/src/runner.mjs +772 -0
- package/src/sandbox-entry.ts +7 -0
- package/src/server.mjs +256 -0
- package/src/transform.mjs +95 -0
- package/src/version-check.mjs +256 -0
- package/src/watcher.mjs +124 -0
package/dist/purify.js
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
/*! @license DOMPurify 3.2.4 | (c) Cure53 and other contributors | Released under the Apache license 2.0 and Mozilla Public License 2.0 | github.com/cure53/DOMPurify/blob/3.2.4/LICENSE */
|
|
2
|
+
!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).DOMPurify=t()}(this,(function(){"use strict";const{entries:e,setPrototypeOf:t,isFrozen:n,getPrototypeOf:o,getOwnPropertyDescriptor:r}=Object;let{freeze:i,seal:a,create:l}=Object,{apply:c,construct:s}="undefined"!=typeof Reflect&&Reflect;i||(i=function(e){return e}),a||(a=function(e){return e}),c||(c=function(e,t,n){return e.apply(t,n)}),s||(s=function(e,t){return new e(...t)});const u=R(Array.prototype.forEach),m=R(Array.prototype.lastIndexOf),p=R(Array.prototype.pop),f=R(Array.prototype.push),d=R(Array.prototype.splice),h=R(String.prototype.toLowerCase),g=R(String.prototype.toString),T=R(String.prototype.match),y=R(String.prototype.replace),E=R(String.prototype.indexOf),A=R(String.prototype.trim),_=R(Object.prototype.hasOwnProperty),S=R(RegExp.prototype.test),b=(N=TypeError,function(){for(var e=arguments.length,t=new Array(e),n=0;n<e;n++)t[n]=arguments[n];return s(N,t)});var N;function R(e){return function(t){for(var n=arguments.length,o=new Array(n>1?n-1:0),r=1;r<n;r++)o[r-1]=arguments[r];return c(e,t,o)}}function w(e,o){let r=arguments.length>2&&void 0!==arguments[2]?arguments[2]:h;t&&t(e,null);let i=o.length;for(;i--;){let t=o[i];if("string"==typeof t){const e=r(t);e!==t&&(n(o)||(o[i]=e),t=e)}e[t]=!0}return e}function O(e){for(let t=0;t<e.length;t++){_(e,t)||(e[t]=null)}return e}function D(t){const n=l(null);for(const[o,r]of e(t)){_(t,o)&&(Array.isArray(r)?n[o]=O(r):r&&"object"==typeof r&&r.constructor===Object?n[o]=D(r):n[o]=r)}return n}function v(e,t){for(;null!==e;){const n=r(e,t);if(n){if(n.get)return R(n.get);if("function"==typeof n.value)return R(n.value)}e=o(e)}return function(){return null}}const L=i(["a","abbr","acronym","address","area","article","aside","audio","b","bdi","bdo","big","blink","blockquote","body","br","button","canvas","caption","center","cite","code","col","colgroup","content","data","datalist","dd","decorator","del","details","dfn","dialog","dir","div","dl","dt","element","em","fieldset","figcaption","figure","font","footer","form","h1","h2","h3","h4","h5","h6","head","header","hgroup","hr","html","i","img","input","ins","kbd","label","legend","li","main","map","mark","marquee","menu","menuitem","meter","nav","nobr","ol","optgroup","option","output","p","picture","pre","progress","q","rp","rt","ruby","s","samp","section","select","shadow","small","source","spacer","span","strike","strong","style","sub","summary","sup","table","tbody","td","template","textarea","tfoot","th","thead","time","tr","track","tt","u","ul","var","video","wbr"]),C=i(["svg","a","altglyph","altglyphdef","altglyphitem","animatecolor","animatemotion","animatetransform","circle","clippath","defs","desc","ellipse","filter","font","g","glyph","glyphref","hkern","image","line","lineargradient","marker","mask","metadata","mpath","path","pattern","polygon","polyline","radialgradient","rect","stop","style","switch","symbol","text","textpath","title","tref","tspan","view","vkern"]),x=i(["feBlend","feColorMatrix","feComponentTransfer","feComposite","feConvolveMatrix","feDiffuseLighting","feDisplacementMap","feDistantLight","feDropShadow","feFlood","feFuncA","feFuncB","feFuncG","feFuncR","feGaussianBlur","feImage","feMerge","feMergeNode","feMorphology","feOffset","fePointLight","feSpecularLighting","feSpotLight","feTile","feTurbulence"]),M=i(["animate","color-profile","cursor","discard","font-face","font-face-format","font-face-name","font-face-src","font-face-uri","foreignobject","hatch","hatchpath","mesh","meshgradient","meshpatch","meshrow","missing-glyph","script","set","solidcolor","unknown","use"]),k=i(["math","menclose","merror","mfenced","mfrac","mglyph","mi","mlabeledtr","mmultiscripts","mn","mo","mover","mpadded","mphantom","mroot","mrow","ms","mspace","msqrt","mstyle","msub","msup","msubsup","mtable","mtd","mtext","mtr","munder","munderover","mprescripts"]),I=i(["maction","maligngroup","malignmark","mlongdiv","mscarries","mscarry","msgroup","mstack","msline","msrow","semantics","annotation","annotation-xml","mprescripts","none"]),U=i(["#text"]),z=i(["accept","action","align","alt","autocapitalize","autocomplete","autopictureinpicture","autoplay","background","bgcolor","border","capture","cellpadding","cellspacing","checked","cite","class","clear","color","cols","colspan","controls","controlslist","coords","crossorigin","datetime","decoding","default","dir","disabled","disablepictureinpicture","disableremoteplayback","download","draggable","enctype","enterkeyhint","face","for","headers","height","hidden","high","href","hreflang","id","inputmode","integrity","ismap","kind","label","lang","list","loading","loop","low","max","maxlength","media","method","min","minlength","multiple","muted","name","nonce","noshade","novalidate","nowrap","open","optimum","pattern","placeholder","playsinline","popover","popovertarget","popovertargetaction","poster","preload","pubdate","radiogroup","readonly","rel","required","rev","reversed","role","rows","rowspan","spellcheck","scope","selected","shape","size","sizes","span","srclang","start","src","srcset","step","style","summary","tabindex","title","translate","type","usemap","valign","value","width","wrap","xmlns","slot"]),P=i(["accent-height","accumulate","additive","alignment-baseline","amplitude","ascent","attributename","attributetype","azimuth","basefrequency","baseline-shift","begin","bias","by","class","clip","clippathunits","clip-path","clip-rule","color","color-interpolation","color-interpolation-filters","color-profile","color-rendering","cx","cy","d","dx","dy","diffuseconstant","direction","display","divisor","dur","edgemode","elevation","end","exponent","fill","fill-opacity","fill-rule","filter","filterunits","flood-color","flood-opacity","font-family","font-size","font-size-adjust","font-stretch","font-style","font-variant","font-weight","fx","fy","g1","g2","glyph-name","glyphref","gradientunits","gradienttransform","height","href","id","image-rendering","in","in2","intercept","k","k1","k2","k3","k4","kerning","keypoints","keysplines","keytimes","lang","lengthadjust","letter-spacing","kernelmatrix","kernelunitlength","lighting-color","local","marker-end","marker-mid","marker-start","markerheight","markerunits","markerwidth","maskcontentunits","maskunits","max","mask","media","method","mode","min","name","numoctaves","offset","operator","opacity","order","orient","orientation","origin","overflow","paint-order","path","pathlength","patterncontentunits","patterntransform","patternunits","points","preservealpha","preserveaspectratio","primitiveunits","r","rx","ry","radius","refx","refy","repeatcount","repeatdur","restart","result","rotate","scale","seed","shape-rendering","slope","specularconstant","specularexponent","spreadmethod","startoffset","stddeviation","stitchtiles","stop-color","stop-opacity","stroke-dasharray","stroke-dashoffset","stroke-linecap","stroke-linejoin","stroke-miterlimit","stroke-opacity","stroke","stroke-width","style","surfacescale","systemlanguage","tabindex","tablevalues","targetx","targety","transform","transform-origin","text-anchor","text-decoration","text-rendering","textlength","type","u1","u2","unicode","values","viewbox","visibility","version","vert-adv-y","vert-origin-x","vert-origin-y","width","word-spacing","wrap","writing-mode","xchannelselector","ychannelselector","x","x1","x2","xmlns","y","y1","y2","z","zoomandpan"]),H=i(["accent","accentunder","align","bevelled","close","columnsalign","columnlines","columnspan","denomalign","depth","dir","display","displaystyle","encoding","fence","frame","height","href","id","largeop","length","linethickness","lspace","lquote","mathbackground","mathcolor","mathsize","mathvariant","maxsize","minsize","movablelimits","notation","numalign","open","rowalign","rowlines","rowspacing","rowspan","rspace","rquote","scriptlevel","scriptminsize","scriptsizemultiplier","selection","separator","separators","stretchy","subscriptshift","supscriptshift","symmetric","voffset","width","xmlns"]),F=i(["xlink:href","xml:id","xlink:title","xml:space","xmlns:xlink"]),B=a(/\{\{[\w\W]*|[\w\W]*\}\}/gm),W=a(/<%[\w\W]*|[\w\W]*%>/gm),G=a(/\$\{[\w\W]*/gm),Y=a(/^data-[\-\w.\u00B7-\uFFFF]+$/),j=a(/^aria-[\-\w]+$/),X=a(/^(?:(?:(?:f|ht)tps?|mailto|tel|callto|sms|cid|xmpp):|[^a-z]|[a-z+.\-]+(?:[^a-z+.\-:]|$))/i),q=a(/^(?:\w+script|data):/i),$=a(/[\u0000-\u0020\u00A0\u1680\u180E\u2000-\u2029\u205F\u3000]/g),K=a(/^html$/i),V=a(/^[a-z][.\w]*(-[.\w]+)+$/i);var Z=Object.freeze({__proto__:null,ARIA_ATTR:j,ATTR_WHITESPACE:$,CUSTOM_ELEMENT:V,DATA_ATTR:Y,DOCTYPE_NAME:K,ERB_EXPR:W,IS_ALLOWED_URI:X,IS_SCRIPT_OR_DATA:q,MUSTACHE_EXPR:B,TMPLIT_EXPR:G});const J=1,Q=3,ee=7,te=8,ne=9,oe=function(){return"undefined"==typeof window?null:window};var re=function t(){let n=arguments.length>0&&void 0!==arguments[0]?arguments[0]:oe();const o=e=>t(e);if(o.version="3.2.4",o.removed=[],!n||!n.document||n.document.nodeType!==ne||!n.Element)return o.isSupported=!1,o;let{document:r}=n;const a=r,c=a.currentScript,{DocumentFragment:s,HTMLTemplateElement:N,Node:R,Element:O,NodeFilter:B,NamedNodeMap:W=n.NamedNodeMap||n.MozNamedAttrMap,HTMLFormElement:G,DOMParser:Y,trustedTypes:j}=n,q=O.prototype,$=v(q,"cloneNode"),V=v(q,"remove"),re=v(q,"nextSibling"),ie=v(q,"childNodes"),ae=v(q,"parentNode");if("function"==typeof N){const e=r.createElement("template");e.content&&e.content.ownerDocument&&(r=e.content.ownerDocument)}let le,ce="";const{implementation:se,createNodeIterator:ue,createDocumentFragment:me,getElementsByTagName:pe}=r,{importNode:fe}=a;let de={afterSanitizeAttributes:[],afterSanitizeElements:[],afterSanitizeShadowDOM:[],beforeSanitizeAttributes:[],beforeSanitizeElements:[],beforeSanitizeShadowDOM:[],uponSanitizeAttribute:[],uponSanitizeElement:[],uponSanitizeShadowNode:[]};o.isSupported="function"==typeof e&&"function"==typeof ae&&se&&void 0!==se.createHTMLDocument;const{MUSTACHE_EXPR:he,ERB_EXPR:ge,TMPLIT_EXPR:Te,DATA_ATTR:ye,ARIA_ATTR:Ee,IS_SCRIPT_OR_DATA:Ae,ATTR_WHITESPACE:_e,CUSTOM_ELEMENT:Se}=Z;let{IS_ALLOWED_URI:be}=Z,Ne=null;const Re=w({},[...L,...C,...x,...k,...U]);let we=null;const Oe=w({},[...z,...P,...H,...F]);let De=Object.seal(l(null,{tagNameCheck:{writable:!0,configurable:!1,enumerable:!0,value:null},attributeNameCheck:{writable:!0,configurable:!1,enumerable:!0,value:null},allowCustomizedBuiltInElements:{writable:!0,configurable:!1,enumerable:!0,value:!1}})),ve=null,Le=null,Ce=!0,xe=!0,Me=!1,ke=!0,Ie=!1,Ue=!0,ze=!1,Pe=!1,He=!1,Fe=!1,Be=!1,We=!1,Ge=!0,Ye=!1,je=!0,Xe=!1,qe={},$e=null;const Ke=w({},["annotation-xml","audio","colgroup","desc","foreignobject","head","iframe","math","mi","mn","mo","ms","mtext","noembed","noframes","noscript","plaintext","script","style","svg","template","thead","title","video","xmp"]);let Ve=null;const Ze=w({},["audio","video","img","source","image","track"]);let Je=null;const Qe=w({},["alt","class","for","id","label","name","pattern","placeholder","role","summary","title","value","style","xmlns"]),et="http://www.w3.org/1998/Math/MathML",tt="http://www.w3.org/2000/svg",nt="http://www.w3.org/1999/xhtml";let ot=nt,rt=!1,it=null;const at=w({},[et,tt,nt],g);let lt=w({},["mi","mo","mn","ms","mtext"]),ct=w({},["annotation-xml"]);const st=w({},["title","style","font","a","script"]);let ut=null;const mt=["application/xhtml+xml","text/html"];let pt=null,ft=null;const dt=r.createElement("form"),ht=function(e){return e instanceof RegExp||e instanceof Function},gt=function(){let e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};if(!ft||ft!==e){if(e&&"object"==typeof e||(e={}),e=D(e),ut=-1===mt.indexOf(e.PARSER_MEDIA_TYPE)?"text/html":e.PARSER_MEDIA_TYPE,pt="application/xhtml+xml"===ut?g:h,Ne=_(e,"ALLOWED_TAGS")?w({},e.ALLOWED_TAGS,pt):Re,we=_(e,"ALLOWED_ATTR")?w({},e.ALLOWED_ATTR,pt):Oe,it=_(e,"ALLOWED_NAMESPACES")?w({},e.ALLOWED_NAMESPACES,g):at,Je=_(e,"ADD_URI_SAFE_ATTR")?w(D(Qe),e.ADD_URI_SAFE_ATTR,pt):Qe,Ve=_(e,"ADD_DATA_URI_TAGS")?w(D(Ze),e.ADD_DATA_URI_TAGS,pt):Ze,$e=_(e,"FORBID_CONTENTS")?w({},e.FORBID_CONTENTS,pt):Ke,ve=_(e,"FORBID_TAGS")?w({},e.FORBID_TAGS,pt):{},Le=_(e,"FORBID_ATTR")?w({},e.FORBID_ATTR,pt):{},qe=!!_(e,"USE_PROFILES")&&e.USE_PROFILES,Ce=!1!==e.ALLOW_ARIA_ATTR,xe=!1!==e.ALLOW_DATA_ATTR,Me=e.ALLOW_UNKNOWN_PROTOCOLS||!1,ke=!1!==e.ALLOW_SELF_CLOSE_IN_ATTR,Ie=e.SAFE_FOR_TEMPLATES||!1,Ue=!1!==e.SAFE_FOR_XML,ze=e.WHOLE_DOCUMENT||!1,Fe=e.RETURN_DOM||!1,Be=e.RETURN_DOM_FRAGMENT||!1,We=e.RETURN_TRUSTED_TYPE||!1,He=e.FORCE_BODY||!1,Ge=!1!==e.SANITIZE_DOM,Ye=e.SANITIZE_NAMED_PROPS||!1,je=!1!==e.KEEP_CONTENT,Xe=e.IN_PLACE||!1,be=e.ALLOWED_URI_REGEXP||X,ot=e.NAMESPACE||nt,lt=e.MATHML_TEXT_INTEGRATION_POINTS||lt,ct=e.HTML_INTEGRATION_POINTS||ct,De=e.CUSTOM_ELEMENT_HANDLING||{},e.CUSTOM_ELEMENT_HANDLING&&ht(e.CUSTOM_ELEMENT_HANDLING.tagNameCheck)&&(De.tagNameCheck=e.CUSTOM_ELEMENT_HANDLING.tagNameCheck),e.CUSTOM_ELEMENT_HANDLING&&ht(e.CUSTOM_ELEMENT_HANDLING.attributeNameCheck)&&(De.attributeNameCheck=e.CUSTOM_ELEMENT_HANDLING.attributeNameCheck),e.CUSTOM_ELEMENT_HANDLING&&"boolean"==typeof e.CUSTOM_ELEMENT_HANDLING.allowCustomizedBuiltInElements&&(De.allowCustomizedBuiltInElements=e.CUSTOM_ELEMENT_HANDLING.allowCustomizedBuiltInElements),Ie&&(xe=!1),Be&&(Fe=!0),qe&&(Ne=w({},U),we=[],!0===qe.html&&(w(Ne,L),w(we,z)),!0===qe.svg&&(w(Ne,C),w(we,P),w(we,F)),!0===qe.svgFilters&&(w(Ne,x),w(we,P),w(we,F)),!0===qe.mathMl&&(w(Ne,k),w(we,H),w(we,F))),e.ADD_TAGS&&(Ne===Re&&(Ne=D(Ne)),w(Ne,e.ADD_TAGS,pt)),e.ADD_ATTR&&(we===Oe&&(we=D(we)),w(we,e.ADD_ATTR,pt)),e.ADD_URI_SAFE_ATTR&&w(Je,e.ADD_URI_SAFE_ATTR,pt),e.FORBID_CONTENTS&&($e===Ke&&($e=D($e)),w($e,e.FORBID_CONTENTS,pt)),je&&(Ne["#text"]=!0),ze&&w(Ne,["html","head","body"]),Ne.table&&(w(Ne,["tbody"]),delete ve.tbody),e.TRUSTED_TYPES_POLICY){if("function"!=typeof e.TRUSTED_TYPES_POLICY.createHTML)throw b('TRUSTED_TYPES_POLICY configuration option must provide a "createHTML" hook.');if("function"!=typeof e.TRUSTED_TYPES_POLICY.createScriptURL)throw b('TRUSTED_TYPES_POLICY configuration option must provide a "createScriptURL" hook.');le=e.TRUSTED_TYPES_POLICY,ce=le.createHTML("")}else void 0===le&&(le=function(e,t){if("object"!=typeof e||"function"!=typeof e.createPolicy)return null;let n=null;const o="data-tt-policy-suffix";t&&t.hasAttribute(o)&&(n=t.getAttribute(o));const r="dompurify"+(n?"#"+n:"");try{return e.createPolicy(r,{createHTML:e=>e,createScriptURL:e=>e})}catch(e){return console.warn("TrustedTypes policy "+r+" could not be created."),null}}(j,c)),null!==le&&"string"==typeof ce&&(ce=le.createHTML(""));i&&i(e),ft=e}},Tt=w({},[...C,...x,...M]),yt=w({},[...k,...I]),Et=function(e){f(o.removed,{element:e});try{ae(e).removeChild(e)}catch(t){V(e)}},At=function(e,t){try{f(o.removed,{attribute:t.getAttributeNode(e),from:t})}catch(e){f(o.removed,{attribute:null,from:t})}if(t.removeAttribute(e),"is"===e)if(Fe||Be)try{Et(t)}catch(e){}else try{t.setAttribute(e,"")}catch(e){}},_t=function(e){let t=null,n=null;if(He)e="<remove></remove>"+e;else{const t=T(e,/^[\r\n\t ]+/);n=t&&t[0]}"application/xhtml+xml"===ut&&ot===nt&&(e='<html xmlns="http://www.w3.org/1999/xhtml"><head></head><body>'+e+"</body></html>");const o=le?le.createHTML(e):e;if(ot===nt)try{t=(new Y).parseFromString(o,ut)}catch(e){}if(!t||!t.documentElement){t=se.createDocument(ot,"template",null);try{t.documentElement.innerHTML=rt?ce:o}catch(e){}}const i=t.body||t.documentElement;return e&&n&&i.insertBefore(r.createTextNode(n),i.childNodes[0]||null),ot===nt?pe.call(t,ze?"html":"body")[0]:ze?t.documentElement:i},St=function(e){return ue.call(e.ownerDocument||e,e,B.SHOW_ELEMENT|B.SHOW_COMMENT|B.SHOW_TEXT|B.SHOW_PROCESSING_INSTRUCTION|B.SHOW_CDATA_SECTION,null)},bt=function(e){return e instanceof G&&("string"!=typeof e.nodeName||"string"!=typeof e.textContent||"function"!=typeof e.removeChild||!(e.attributes instanceof W)||"function"!=typeof e.removeAttribute||"function"!=typeof e.setAttribute||"string"!=typeof e.namespaceURI||"function"!=typeof e.insertBefore||"function"!=typeof e.hasChildNodes)},Nt=function(e){return"function"==typeof R&&e instanceof R};function Rt(e,t,n){u(e,(e=>{e.call(o,t,n,ft)}))}const wt=function(e){let t=null;if(Rt(de.beforeSanitizeElements,e,null),bt(e))return Et(e),!0;const n=pt(e.nodeName);if(Rt(de.uponSanitizeElement,e,{tagName:n,allowedTags:Ne}),e.hasChildNodes()&&!Nt(e.firstElementChild)&&S(/<[/\w]/g,e.innerHTML)&&S(/<[/\w]/g,e.textContent))return Et(e),!0;if(e.nodeType===ee)return Et(e),!0;if(Ue&&e.nodeType===te&&S(/<[/\w]/g,e.data))return Et(e),!0;if(!Ne[n]||ve[n]){if(!ve[n]&&Dt(n)){if(De.tagNameCheck instanceof RegExp&&S(De.tagNameCheck,n))return!1;if(De.tagNameCheck instanceof Function&&De.tagNameCheck(n))return!1}if(je&&!$e[n]){const t=ae(e)||e.parentNode,n=ie(e)||e.childNodes;if(n&&t){for(let o=n.length-1;o>=0;--o){const r=$(n[o],!0);r.__removalCount=(e.__removalCount||0)+1,t.insertBefore(r,re(e))}}}return Et(e),!0}return e instanceof O&&!function(e){let t=ae(e);t&&t.tagName||(t={namespaceURI:ot,tagName:"template"});const n=h(e.tagName),o=h(t.tagName);return!!it[e.namespaceURI]&&(e.namespaceURI===tt?t.namespaceURI===nt?"svg"===n:t.namespaceURI===et?"svg"===n&&("annotation-xml"===o||lt[o]):Boolean(Tt[n]):e.namespaceURI===et?t.namespaceURI===nt?"math"===n:t.namespaceURI===tt?"math"===n&&ct[o]:Boolean(yt[n]):e.namespaceURI===nt?!(t.namespaceURI===tt&&!ct[o])&&!(t.namespaceURI===et&&!lt[o])&&!yt[n]&&(st[n]||!Tt[n]):!("application/xhtml+xml"!==ut||!it[e.namespaceURI]))}(e)?(Et(e),!0):"noscript"!==n&&"noembed"!==n&&"noframes"!==n||!S(/<\/no(script|embed|frames)/i,e.innerHTML)?(Ie&&e.nodeType===Q&&(t=e.textContent,u([he,ge,Te],(e=>{t=y(t,e," ")})),e.textContent!==t&&(f(o.removed,{element:e.cloneNode()}),e.textContent=t)),Rt(de.afterSanitizeElements,e,null),!1):(Et(e),!0)},Ot=function(e,t,n){if(Ge&&("id"===t||"name"===t)&&(n in r||n in dt))return!1;if(xe&&!Le[t]&&S(ye,t));else if(Ce&&S(Ee,t));else if(!we[t]||Le[t]){if(!(Dt(e)&&(De.tagNameCheck instanceof RegExp&&S(De.tagNameCheck,e)||De.tagNameCheck instanceof Function&&De.tagNameCheck(e))&&(De.attributeNameCheck instanceof RegExp&&S(De.attributeNameCheck,t)||De.attributeNameCheck instanceof Function&&De.attributeNameCheck(t))||"is"===t&&De.allowCustomizedBuiltInElements&&(De.tagNameCheck instanceof RegExp&&S(De.tagNameCheck,n)||De.tagNameCheck instanceof Function&&De.tagNameCheck(n))))return!1}else if(Je[t]);else if(S(be,y(n,_e,"")));else if("src"!==t&&"xlink:href"!==t&&"href"!==t||"script"===e||0!==E(n,"data:")||!Ve[e]){if(Me&&!S(Ae,y(n,_e,"")));else if(n)return!1}else;return!0},Dt=function(e){return"annotation-xml"!==e&&T(e,Se)},vt=function(e){Rt(de.beforeSanitizeAttributes,e,null);const{attributes:t}=e;if(!t||bt(e))return;const n={attrName:"",attrValue:"",keepAttr:!0,allowedAttributes:we,forceKeepAttr:void 0};let r=t.length;for(;r--;){const i=t[r],{name:a,namespaceURI:l,value:c}=i,s=pt(a);let m="value"===a?c:A(c);if(n.attrName=s,n.attrValue=m,n.keepAttr=!0,n.forceKeepAttr=void 0,Rt(de.uponSanitizeAttribute,e,n),m=n.attrValue,!Ye||"id"!==s&&"name"!==s||(At(a,e),m="user-content-"+m),Ue&&S(/((--!?|])>)|<\/(style|title)/i,m)){At(a,e);continue}if(n.forceKeepAttr)continue;if(At(a,e),!n.keepAttr)continue;if(!ke&&S(/\/>/i,m)){At(a,e);continue}Ie&&u([he,ge,Te],(e=>{m=y(m,e," ")}));const f=pt(e.nodeName);if(Ot(f,s,m)){if(le&&"object"==typeof j&&"function"==typeof j.getAttributeType)if(l);else switch(j.getAttributeType(f,s)){case"TrustedHTML":m=le.createHTML(m);break;case"TrustedScriptURL":m=le.createScriptURL(m)}try{l?e.setAttributeNS(l,a,m):e.setAttribute(a,m),bt(e)?Et(e):p(o.removed)}catch(e){}}}Rt(de.afterSanitizeAttributes,e,null)},Lt=function e(t){let n=null;const o=St(t);for(Rt(de.beforeSanitizeShadowDOM,t,null);n=o.nextNode();)Rt(de.uponSanitizeShadowNode,n,null),wt(n),vt(n),n.content instanceof s&&e(n.content);Rt(de.afterSanitizeShadowDOM,t,null)};return o.sanitize=function(e){let t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},n=null,r=null,i=null,l=null;if(rt=!e,rt&&(e="\x3c!--\x3e"),"string"!=typeof e&&!Nt(e)){if("function"!=typeof e.toString)throw b("toString is not a function");if("string"!=typeof(e=e.toString()))throw b("dirty is not a string, aborting")}if(!o.isSupported)return e;if(Pe||gt(t),o.removed=[],"string"==typeof e&&(Xe=!1),Xe){if(e.nodeName){const t=pt(e.nodeName);if(!Ne[t]||ve[t])throw b("root node is forbidden and cannot be sanitized in-place")}}else if(e instanceof R)n=_t("\x3c!----\x3e"),r=n.ownerDocument.importNode(e,!0),r.nodeType===J&&"BODY"===r.nodeName||"HTML"===r.nodeName?n=r:n.appendChild(r);else{if(!Fe&&!Ie&&!ze&&-1===e.indexOf("<"))return le&&We?le.createHTML(e):e;if(n=_t(e),!n)return Fe?null:We?ce:""}n&&He&&Et(n.firstChild);const c=St(Xe?e:n);for(;i=c.nextNode();)wt(i),vt(i),i.content instanceof s&&Lt(i.content);if(Xe)return e;if(Fe){if(Be)for(l=me.call(n.ownerDocument);n.firstChild;)l.appendChild(n.firstChild);else l=n;return(we.shadowroot||we.shadowrootmode)&&(l=fe.call(a,l,!0)),l}let m=ze?n.outerHTML:n.innerHTML;return ze&&Ne["!doctype"]&&n.ownerDocument&&n.ownerDocument.doctype&&n.ownerDocument.doctype.name&&S(K,n.ownerDocument.doctype.name)&&(m="<!DOCTYPE "+n.ownerDocument.doctype.name+">\n"+m),Ie&&u([he,ge,Te],(e=>{m=y(m,e," ")})),le&&We?le.createHTML(m):m},o.setConfig=function(){gt(arguments.length>0&&void 0!==arguments[0]?arguments[0]:{}),Pe=!0},o.clearConfig=function(){ft=null,Pe=!1},o.isValidAttribute=function(e,t,n){ft||gt({});const o=pt(e),r=pt(t);return Ot(o,r,n)},o.addHook=function(e,t){"function"==typeof t&&f(de[e],t)},o.removeHook=function(e,t){if(void 0!==t){const n=m(de[e],t);return-1===n?void 0:d(de[e],n,1)[0]}return p(de[e])},o.removeHooks=function(e){de[e]=[]},o.removeAllHooks=function(){de={afterSanitizeAttributes:[],afterSanitizeElements:[],afterSanitizeShadowDOM:[],beforeSanitizeAttributes:[],beforeSanitizeElements:[],beforeSanitizeShadowDOM:[],uponSanitizeAttribute:[],uponSanitizeElement:[],uponSanitizeShadowNode:[]}},o}();return re}));
|
|
3
|
+
//# sourceMappingURL=purify.min.js.map
|
package/package.json
ADDED
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@locker/cli",
|
|
3
|
+
"version": "0.28.3",
|
|
4
|
+
"license": "SEE LICENSE IN LICENSE.txt",
|
|
5
|
+
"author": "Salesforce UI Security Team",
|
|
6
|
+
"description": "Lightning Web Security CLI",
|
|
7
|
+
"type": "module",
|
|
8
|
+
"publishConfig": {
|
|
9
|
+
"access": "public"
|
|
10
|
+
},
|
|
11
|
+
"bin": {
|
|
12
|
+
"lws": "./bin/lws.mjs"
|
|
13
|
+
},
|
|
14
|
+
"files": [
|
|
15
|
+
"bin/",
|
|
16
|
+
"src/",
|
|
17
|
+
"dist/",
|
|
18
|
+
"README.md",
|
|
19
|
+
"LICENSE.txt"
|
|
20
|
+
],
|
|
21
|
+
"scripts": {
|
|
22
|
+
"build": "rollup --config .rolluprc.cjs",
|
|
23
|
+
"test": "yarn test:unit && yarn test:cli && yarn test:integration",
|
|
24
|
+
"test:unit": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --config jest.config.unit.cjs",
|
|
25
|
+
"test:cli": "jest --config jest.config.cli.cjs",
|
|
26
|
+
"test:integration": "jest --config jest.config.integration.cjs"
|
|
27
|
+
},
|
|
28
|
+
"dependencies": {
|
|
29
|
+
"@locker/rollup-plugin": "0.28.3",
|
|
30
|
+
"@locker/sandbox": "0.28.3",
|
|
31
|
+
"@lwc/engine-dom": "8.21.1",
|
|
32
|
+
"@lwc/rollup-plugin": "8.21.1",
|
|
33
|
+
"@rollup/plugin-commonjs": "21.1.0",
|
|
34
|
+
"@rollup/plugin-node-resolve": "15.1.0",
|
|
35
|
+
"@rollup/plugin-replace": "5.0.5",
|
|
36
|
+
"chokidar": "3.5.3",
|
|
37
|
+
"dompurify": "3.2.4",
|
|
38
|
+
"lwc": "8.21.1",
|
|
39
|
+
"playwright": "1.49.1",
|
|
40
|
+
"rollup": "2.79.1",
|
|
41
|
+
"rollup-plugin-ts": "3.4.5",
|
|
42
|
+
"yargs": "17.7.2"
|
|
43
|
+
},
|
|
44
|
+
"gitHead": "0d5dcf8162c0ac348e068e3b6d310405ba78b896"
|
|
45
|
+
}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import { resolveInput } from './input-resolver.mjs';
|
|
2
|
+
|
|
3
|
+
// Resolve each `--before`/`--after` value to script content, return
|
|
4
|
+
// [{ origin, content }, ...] in argv order. Each value is polymorphic:
|
|
5
|
+
// path-shaped strings (anything with `/`, a `.js`/`.mjs`/`.cjs` suffix,
|
|
6
|
+
// or that resolves to an existing file) get read from disk; everything
|
|
7
|
+
// else is treated as inline JS source. This mirrors the `eval`
|
|
8
|
+
// positional's resolution rules (see `input-resolver.mjs`), so users get
|
|
9
|
+
// one consistent file-vs-inline contract across the CLI.
|
|
10
|
+
//
|
|
11
|
+
// `origin` is either an absolute path (file case) or the literal string
|
|
12
|
+
// "<inline>" (inline case). It feeds runner-side debug logging and is
|
|
13
|
+
// useful when triaging a failed before-script (which one threw?).
|
|
14
|
+
//
|
|
15
|
+
// I/O errors here (ENOENT on a path-shaped value, EACCES) propagate and
|
|
16
|
+
// the runner surfaces them via `output.fail`. That keeps the parse
|
|
17
|
+
// layer free of I/O while still failing fast at the start of injection.
|
|
18
|
+
export async function loadScriptFiles(values) {
|
|
19
|
+
if (!values || values.length === 0) {
|
|
20
|
+
return [];
|
|
21
|
+
}
|
|
22
|
+
return Promise.all(
|
|
23
|
+
values.map(async (value) => {
|
|
24
|
+
const { source, origin } = await resolveInput(value);
|
|
25
|
+
return { origin, content: source };
|
|
26
|
+
}),
|
|
27
|
+
);
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
// Inject each loaded entry as a separate `<script>` tag in argv order.
|
|
31
|
+
// Separate tags are load-bearing: a single concatenated tag would share a
|
|
32
|
+
// script-level scope, so a `var x` in one file would shadow / collide with
|
|
33
|
+
// a `var x` in another. Per-file tags give each entry its own top-level
|
|
34
|
+
// scope, matching how independent `<script>` elements behave on a real
|
|
35
|
+
// page. A throw inside any tag's evaluation propagates as a Playwright
|
|
36
|
+
// pageerror / promise rejection from `addScriptTag`, which surfaces in
|
|
37
|
+
// the runner's try/catch.
|
|
38
|
+
export async function injectScriptTags(browser, entries) {
|
|
39
|
+
for (const { content } of entries) {
|
|
40
|
+
// Sequential, not parallel: argv order is the user's contract here.
|
|
41
|
+
// Two before-scripts that both define `globalThis.foo` must apply
|
|
42
|
+
// in the order the user wrote them on the command line, not
|
|
43
|
+
// whichever resolves first.
|
|
44
|
+
// eslint-disable-next-line no-await-in-loop
|
|
45
|
+
await browser.addScriptTag({ content });
|
|
46
|
+
}
|
|
47
|
+
}
|
package/src/browser.mjs
ADDED
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
import playwright from 'playwright';
|
|
2
|
+
|
|
3
|
+
import { BROWSER_CHANNEL_MAP, SUPPORTED_BROWSERS } from './constants.mjs';
|
|
4
|
+
|
|
5
|
+
const SUPPORTED_BROWSER_SET = new Set(SUPPORTED_BROWSERS);
|
|
6
|
+
|
|
7
|
+
// Console messages we deliberately suppress. LWS sandboxes via an iframe
|
|
8
|
+
// with both `allow-scripts` and `allow-same-origin`. Chromium emits a
|
|
9
|
+
// general-purpose warning that this combination "can escape its
|
|
10
|
+
// sandboxing" — but in LWS's threat model the same-origin-ness is
|
|
11
|
+
// load-bearing (the membrane needs DOM access) and scripts run through
|
|
12
|
+
// the membrane regardless, so the browser's generic advice doesn't apply.
|
|
13
|
+
// Filter on exact substrings to avoid hiding warnings the user actually
|
|
14
|
+
// emitted from sandboxed code.
|
|
15
|
+
const SUPPRESSED_CONSOLE_SUBSTRINGS = [
|
|
16
|
+
'allow-scripts and allow-same-origin for its sandbox attribute',
|
|
17
|
+
];
|
|
18
|
+
|
|
19
|
+
function shouldSuppressConsole(text) {
|
|
20
|
+
return SUPPRESSED_CONSOLE_SUBSTRINGS.some((s) => text.includes(s));
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
// Signal handling intentionally lives in the runner, not here. The runner
|
|
24
|
+
// is the single owner of process-exit choreography (browser → server →
|
|
25
|
+
// temp files); installing handlers here would race against the runner's
|
|
26
|
+
// own teardown and leave sockets/processes leaking on Ctrl+C.
|
|
27
|
+
export class Browser {
|
|
28
|
+
constructor({
|
|
29
|
+
browser = 'chromium',
|
|
30
|
+
headed = false,
|
|
31
|
+
consoleStream = process.stderr,
|
|
32
|
+
consoleInterceptor = null,
|
|
33
|
+
playwrightModule = playwright,
|
|
34
|
+
} = {}) {
|
|
35
|
+
if (!SUPPORTED_BROWSER_SET.has(browser)) {
|
|
36
|
+
throw new Error(`unsupported browser: ${browser}`);
|
|
37
|
+
}
|
|
38
|
+
this.browserName = browser;
|
|
39
|
+
this.headed = headed;
|
|
40
|
+
this.consoleStream = consoleStream;
|
|
41
|
+
// Optional first-look hook on every browser console message. Return
|
|
42
|
+
// `true` to indicate the message was consumed (suppress default
|
|
43
|
+
// forwarding to consoleStream). Anything else falls through. The REPL
|
|
44
|
+
// uses this to peel result-marker lines off the existing console
|
|
45
|
+
// pump instead of opening a second channel for evaluation values.
|
|
46
|
+
this.consoleInterceptor = consoleInterceptor;
|
|
47
|
+
this.playwright = playwrightModule;
|
|
48
|
+
this.browser = null;
|
|
49
|
+
this.context = null;
|
|
50
|
+
this.page = null;
|
|
51
|
+
this.disconnectPromise = null;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
async launch() {
|
|
55
|
+
// Map CLI browser names to Playwright launcher + optional channel.
|
|
56
|
+
// Branded browsers (chrome, msedge) are channels of the chromium
|
|
57
|
+
// launcher, not separate launchers — see constants.mjs.
|
|
58
|
+
const mapping = BROWSER_CHANNEL_MAP[this.browserName] ?? {
|
|
59
|
+
launcher: this.browserName,
|
|
60
|
+
};
|
|
61
|
+
const launcher = this.playwright[mapping.launcher];
|
|
62
|
+
const launchOpts = { headless: !this.headed };
|
|
63
|
+
if (mapping.channel) {
|
|
64
|
+
launchOpts.channel = mapping.channel;
|
|
65
|
+
}
|
|
66
|
+
this.browser = await launcher.launch(launchOpts);
|
|
67
|
+
this.context = await this.browser.newContext();
|
|
68
|
+
this.page = await this.context.newPage();
|
|
69
|
+
|
|
70
|
+
this.page.on('console', (msg) => {
|
|
71
|
+
const text = msg.text();
|
|
72
|
+
if (shouldSuppressConsole(text)) {
|
|
73
|
+
return;
|
|
74
|
+
}
|
|
75
|
+
const type = msg.type();
|
|
76
|
+
if (this.consoleInterceptor && this.consoleInterceptor({ type, text }) === true) {
|
|
77
|
+
return;
|
|
78
|
+
}
|
|
79
|
+
this.consoleStream.write(`[browser:${type}] ${text}\n`);
|
|
80
|
+
});
|
|
81
|
+
this.page.on('pageerror', (err) => {
|
|
82
|
+
this.consoleStream.write(`[browser:pageerror] ${err.message}\n`);
|
|
83
|
+
});
|
|
84
|
+
|
|
85
|
+
this.disconnectPromise = new Promise((resolve) => {
|
|
86
|
+
this.browser.once('disconnected', resolve);
|
|
87
|
+
});
|
|
88
|
+
|
|
89
|
+
return this;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
async goto(url, opts = {}) {
|
|
93
|
+
if (!this.page) {
|
|
94
|
+
throw new Error('browser not launched');
|
|
95
|
+
}
|
|
96
|
+
return this.page.goto(url, opts);
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
async evaluate(fn, ...args) {
|
|
100
|
+
if (!this.page) {
|
|
101
|
+
throw new Error('browser not launched');
|
|
102
|
+
}
|
|
103
|
+
return this.page.evaluate(fn, ...args);
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
async addScriptTag(opts) {
|
|
107
|
+
if (!this.page) {
|
|
108
|
+
throw new Error('browser not launched');
|
|
109
|
+
}
|
|
110
|
+
return this.page.addScriptTag(opts);
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
// `addInitScript` queues a script to run on EVERY frame load, BEFORE
|
|
114
|
+
// any other script on the page. Used to set `window.__lwsCLIEndowments`
|
|
115
|
+
// before the harness page's `<script src="/_bundle/component.js">`
|
|
116
|
+
// executes, so the CLI wrapper module can snapshot the endowments at
|
|
117
|
+
// module-init time. Playwright requires this be called before
|
|
118
|
+
// `page.goto()` for the script to apply to the resulting navigation.
|
|
119
|
+
async addInitScript(opts) {
|
|
120
|
+
if (!this.page) {
|
|
121
|
+
throw new Error('browser not launched');
|
|
122
|
+
}
|
|
123
|
+
return this.page.addInitScript(opts);
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
// Run `fn` with a one-shot `pageerror` trap. If any pageerror fires
|
|
127
|
+
// during `fn`'s execution, the returned promise rejects with that
|
|
128
|
+
// error (the first one wins). This is the only way to surface
|
|
129
|
+
// throws inside `addScriptTag`-injected <script> content as a
|
|
130
|
+
// failed run: Playwright's addScriptTag promise resolves
|
|
131
|
+
// successfully on script throws because the script was *added*,
|
|
132
|
+
// even though it errored during execution. The `--before` and
|
|
133
|
+
// `--after` contract is "throw fails the run," so the runner wraps
|
|
134
|
+
// before/after injection in this trap.
|
|
135
|
+
async withPageErrorTrap(fn) {
|
|
136
|
+
if (!this.page) {
|
|
137
|
+
throw new Error('browser not launched');
|
|
138
|
+
}
|
|
139
|
+
let trapped = null;
|
|
140
|
+
const onPageError = (err) => {
|
|
141
|
+
if (trapped === null) {
|
|
142
|
+
trapped = err;
|
|
143
|
+
}
|
|
144
|
+
};
|
|
145
|
+
this.page.on('pageerror', onPageError);
|
|
146
|
+
try {
|
|
147
|
+
await fn();
|
|
148
|
+
// Yield once so any synchronously-fired pageerror has a
|
|
149
|
+
// chance to land on the listener before we check. Playwright
|
|
150
|
+
// delivers pageerror events on the next microtask after the
|
|
151
|
+
// injecting promise settles, so awaiting Promise.resolve()
|
|
152
|
+
// is sufficient.
|
|
153
|
+
await Promise.resolve();
|
|
154
|
+
} finally {
|
|
155
|
+
this.page.off('pageerror', onPageError);
|
|
156
|
+
}
|
|
157
|
+
if (trapped !== null) {
|
|
158
|
+
throw trapped;
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
waitForDisconnect() {
|
|
163
|
+
return this.disconnectPromise;
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
async close() {
|
|
167
|
+
if (this.context) {
|
|
168
|
+
try {
|
|
169
|
+
await this.context.close();
|
|
170
|
+
} catch {
|
|
171
|
+
// Playwright may have already disconnected (e.g. user closed
|
|
172
|
+
// the browser window). Best-effort cleanup; ignore.
|
|
173
|
+
}
|
|
174
|
+
this.context = null;
|
|
175
|
+
}
|
|
176
|
+
if (this.browser) {
|
|
177
|
+
try {
|
|
178
|
+
await this.browser.close();
|
|
179
|
+
} catch {
|
|
180
|
+
// Same as above — already-disconnected is not an error here.
|
|
181
|
+
}
|
|
182
|
+
this.browser = null;
|
|
183
|
+
}
|
|
184
|
+
this.page = null;
|
|
185
|
+
}
|
|
186
|
+
}
|
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
import { promises as fs } from 'node:fs';
|
|
2
|
+
import { createRequire } from 'node:module';
|
|
3
|
+
import os from 'node:os';
|
|
4
|
+
import path from 'node:path';
|
|
5
|
+
|
|
6
|
+
import { rollup } from 'rollup';
|
|
7
|
+
|
|
8
|
+
const require = createRequire(import.meta.url);
|
|
9
|
+
const lockerRollupPlugin = require('@locker/rollup-plugin');
|
|
10
|
+
const lwcRollupPlugin = require('@lwc/rollup-plugin');
|
|
11
|
+
const { nodeResolve } = require('@rollup/plugin-node-resolve');
|
|
12
|
+
|
|
13
|
+
const DEFAULT_NAMESPACE = 'c';
|
|
14
|
+
|
|
15
|
+
// camelCase → kebab-case (e.g. `myComponent` → `my-component`,
|
|
16
|
+
// `HelloWorld` → `hello-world`, `xyz` → `xyz`). Strip the leading
|
|
17
|
+
// hyphen if the input starts with an uppercase letter.
|
|
18
|
+
export function deriveTagName(directoryName) {
|
|
19
|
+
return directoryName.replace(/[A-Z]/g, (m, i) =>
|
|
20
|
+
i === 0 ? m.toLowerCase() : `-${m.toLowerCase()}`,
|
|
21
|
+
);
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export async function validateComponentDir(directory) {
|
|
25
|
+
const stat = await fs.stat(directory).catch(() => null);
|
|
26
|
+
if (!stat || !stat.isDirectory()) {
|
|
27
|
+
throw new Error(`component directory not found: ${directory}`);
|
|
28
|
+
}
|
|
29
|
+
const dirName = path.basename(directory);
|
|
30
|
+
const jsFile = path.join(directory, `${dirName}.js`);
|
|
31
|
+
const htmlFile = path.join(directory, `${dirName}.html`);
|
|
32
|
+
const [jsExists, htmlExists] = await Promise.all([
|
|
33
|
+
fs
|
|
34
|
+
.stat(jsFile)
|
|
35
|
+
.then((s) => s.isFile())
|
|
36
|
+
.catch(() => false),
|
|
37
|
+
fs
|
|
38
|
+
.stat(htmlFile)
|
|
39
|
+
.then((s) => s.isFile())
|
|
40
|
+
.catch(() => false),
|
|
41
|
+
]);
|
|
42
|
+
if (!jsExists) {
|
|
43
|
+
throw new Error(`component JS not found: ${jsFile}`);
|
|
44
|
+
}
|
|
45
|
+
if (!htmlExists) {
|
|
46
|
+
throw new Error(`component template not found: ${htmlFile}`);
|
|
47
|
+
}
|
|
48
|
+
return { directory, dirName, jsFile, htmlFile };
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
export async function compileComponent({
|
|
52
|
+
directory,
|
|
53
|
+
name,
|
|
54
|
+
namespace = DEFAULT_NAMESPACE,
|
|
55
|
+
sandboxKey = 'cli',
|
|
56
|
+
lwcModules = [],
|
|
57
|
+
}) {
|
|
58
|
+
const { dirName, jsFile } = await validateComponentDir(directory);
|
|
59
|
+
const derivedTag = name ?? deriveTagName(dirName);
|
|
60
|
+
const fullTag = `${namespace}-${derivedTag}`;
|
|
61
|
+
|
|
62
|
+
// @lwc/rollup-plugin derives namespace/name from file paths and rejects
|
|
63
|
+
// virtual rollup IDs. So the entry must be a real file. Write it to a
|
|
64
|
+
// per-invocation temp dir alongside the bundle output. The entry is NOT
|
|
65
|
+
// an LWC component (no .html sibling) — the plugin's transform recognizes
|
|
66
|
+
// it as a regular JS file because the path doesn't fit the LWC convention.
|
|
67
|
+
const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'lws-cli-component-'));
|
|
68
|
+
const entryFile = path.join(tmpDir, 'entry.js');
|
|
69
|
+
const entrySource = [
|
|
70
|
+
`import { createElement } from 'lwc';`,
|
|
71
|
+
`import Component from ${JSON.stringify(jsFile)};`,
|
|
72
|
+
`const el = createElement('${fullTag}', { is: Component });`,
|
|
73
|
+
`document.body.appendChild(el);`,
|
|
74
|
+
].join('\n');
|
|
75
|
+
await fs.writeFile(entryFile, entrySource, 'utf8');
|
|
76
|
+
|
|
77
|
+
// Implicit modules-root: the GRANDPARENT of the component directory.
|
|
78
|
+
// LWC's module convention is `<modules-root>/<namespace>/<name>/<name>.js`.
|
|
79
|
+
// For input `./fixtures/c/helloWorld`, the namespace dir is `./fixtures/c/`
|
|
80
|
+
// (parent), and the modules-root the plugin should scan is `./fixtures/`
|
|
81
|
+
// (grandparent). This lets a component at `./fixtures/c/helloWorld/`
|
|
82
|
+
// import `c/wrappedBox` from sibling `./fixtures/c/wrappedBox/`, and
|
|
83
|
+
// covers cross-namespace imports under the same root (e.g. `c/foo`
|
|
84
|
+
// and `x/bar` siblings under `./fixtures/`).
|
|
85
|
+
const modulesRoot = path.dirname(path.dirname(directory));
|
|
86
|
+
|
|
87
|
+
// Resolve `--lwc-modules` paths against process.cwd() so users can
|
|
88
|
+
// pass relative paths from their shell. Each entry becomes a
|
|
89
|
+
// `{ dir }` module record. The LWC resolver walks the modules array
|
|
90
|
+
// in order and first-match wins, so explicit paths come BEFORE the
|
|
91
|
+
// implicit grandparent: `--lwc-modules ./vendor/components` covering
|
|
92
|
+
// `c/foo` should win over a `c/foo` that happens to exist under the
|
|
93
|
+
// implicit root.
|
|
94
|
+
const explicitModules = lwcModules.map((dir) => ({
|
|
95
|
+
dir: path.resolve(process.cwd(), dir),
|
|
96
|
+
}));
|
|
97
|
+
const moduleRecords = [...explicitModules, { dir: modulesRoot }];
|
|
98
|
+
|
|
99
|
+
const bundle = await rollup({
|
|
100
|
+
input: entryFile,
|
|
101
|
+
plugins: [
|
|
102
|
+
nodeResolve({ preferBuiltins: true }),
|
|
103
|
+
// Plugin order matters: LWC compiler MUST run before the LWS
|
|
104
|
+
// compiler. Reversing the order breaks LWC component-file
|
|
105
|
+
// resolution. This is the same constraint karma encodes in
|
|
106
|
+
// packages/integration-karma/configs/base.js (search for
|
|
107
|
+
// "When the LWC plugin is listed after the LWS").
|
|
108
|
+
lwcRollupPlugin({
|
|
109
|
+
enableLightningWebSecurityTransforms: true,
|
|
110
|
+
modules: moduleRecords,
|
|
111
|
+
}),
|
|
112
|
+
// @locker/rollup-plugin wraps user component code in
|
|
113
|
+
// `evaluateInSandbox(key, () => { ... })`. Without this plugin,
|
|
114
|
+
// the component bundle would run system-mode and bypass all
|
|
115
|
+
// LWS distortions (Worker, document.cookie, etc.) at runtime.
|
|
116
|
+
// The synthetic entry file lives in tmpDir, OUTSIDE
|
|
117
|
+
// modulesRoot, so the include filter scopes the LWS transform
|
|
118
|
+
// to user component files only. The entry's `import Component
|
|
119
|
+
// from <jsFile>` line still resolves into the modulesRoot
|
|
120
|
+
// tree, which is exactly what gets transformed.
|
|
121
|
+
lockerRollupPlugin({
|
|
122
|
+
sandboxKey,
|
|
123
|
+
// Components from BOTH the implicit grandparent root AND
|
|
124
|
+
// any `--lwc-modules` paths are treated as user code: each
|
|
125
|
+
// gets the LWS sandbox-wrapping transform. This keeps the
|
|
126
|
+
// CLI consistent with karma's behavior (every imported
|
|
127
|
+
// component is sandboxed). The first-party / system-mode
|
|
128
|
+
// story for `lightning/*` etc. is a separate design (see
|
|
129
|
+
// PLAN.md `component-first-party-resolution-design`).
|
|
130
|
+
include: [
|
|
131
|
+
path.join(modulesRoot, '**', '*.js'),
|
|
132
|
+
...explicitModules.map((m) => path.join(m.dir, '**', '*.js')),
|
|
133
|
+
],
|
|
134
|
+
exclude: ['**/node_modules/**'],
|
|
135
|
+
}),
|
|
136
|
+
],
|
|
137
|
+
// `lwc-engine.js` exposes `window.LWC` (the system-mode
|
|
138
|
+
// engine); the component bundle should resolve `lwc` imports
|
|
139
|
+
// to that global rather than re-bundling the engine.
|
|
140
|
+
// `@locker/sandbox` is externalized so the locker compiler's
|
|
141
|
+
// emitted `evaluateInSandbox` call resolves to
|
|
142
|
+
// `window.evaluateInSandbox` at runtime. The harness's
|
|
143
|
+
// /_runtime/evaluator.js installs a wrapping evaluateInSandbox
|
|
144
|
+
// that merges CLI-supplied endowments before delegating, so the
|
|
145
|
+
// user's bundle stays clean of any merge boilerplate.
|
|
146
|
+
external: ['lwc', '@locker/sandbox'],
|
|
147
|
+
treeshake: false,
|
|
148
|
+
});
|
|
149
|
+
|
|
150
|
+
const { output } = await bundle.generate({
|
|
151
|
+
format: 'iife',
|
|
152
|
+
globals: { lwc: 'LWC', '@locker/sandbox': 'window' },
|
|
153
|
+
});
|
|
154
|
+
await bundle.close();
|
|
155
|
+
|
|
156
|
+
if (output.length !== 1) {
|
|
157
|
+
throw new Error(`expected exactly one chunk, got ${output.length}`);
|
|
158
|
+
}
|
|
159
|
+
const code = cleanIifeWrapper(output[0].code);
|
|
160
|
+
|
|
161
|
+
const bundleFile = path.join(tmpDir, 'component.js');
|
|
162
|
+
await fs.writeFile(bundleFile, code, 'utf8');
|
|
163
|
+
|
|
164
|
+
return {
|
|
165
|
+
bundleFile,
|
|
166
|
+
tmpDir,
|
|
167
|
+
code,
|
|
168
|
+
tag: fullTag,
|
|
169
|
+
};
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
// Drop the `sandbox` IIFE param so the bundle reads
|
|
173
|
+
// `window.evaluateInSandbox(...)` directly instead of going through the
|
|
174
|
+
// rollup-supplied iife shim. The `lwc` param stays: component code calls
|
|
175
|
+
// into it heavily, so we keep that one as-is.
|
|
176
|
+
function cleanIifeWrapper(code) {
|
|
177
|
+
return code
|
|
178
|
+
.replace(/\(function \(lwc, sandbox\) \{/, '(function (lwc) {')
|
|
179
|
+
.replace(/sandbox\.evaluateInSandbox\(/g, 'window.evaluateInSandbox(')
|
|
180
|
+
.replace(/\}\)\(LWC, window\);\s*$/, '})(LWC);\n');
|
|
181
|
+
}
|