@melt-js/docs-all 0.0.0-stage → 2026.11.16-2
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/README.md +52 -3
- package/dist/404.html +23 -0
- package/dist/README.html +31 -0
- package/dist/assets/README.md.DU0RzawF.js +6 -0
- package/dist/assets/README.md.DU0RzawF.lean.js +1 -0
- package/dist/assets/app.BTy_em6e.js +1 -0
- package/dist/assets/chunks/@localSearchIndexroot.Dh_2cf1v.js +1 -0
- package/dist/assets/chunks/VPLocalSearchBox.Bi9Y__e6.js +3 -0
- package/dist/assets/chunks/framework.B8fSEufx.js +4 -0
- package/dist/assets/chunks/theme.HCUg5ewQ.js +2 -0
- package/dist/assets/guide_browser-esm.md.6yZe9uuS.js +33 -0
- package/dist/assets/guide_browser-esm.md.6yZe9uuS.lean.js +1 -0
- package/dist/assets/guide_core.md.BhtxX816.js +1 -0
- package/dist/assets/guide_core.md.BhtxX816.lean.js +1 -0
- package/dist/assets/guide_getting-started.md.BQRE6Qt8.js +33 -0
- package/dist/assets/guide_getting-started.md.BQRE6Qt8.lean.js +1 -0
- package/dist/assets/guide_introduction.md.CaRb6pD3.js +7 -0
- package/dist/assets/guide_introduction.md.CaRb6pD3.lean.js +1 -0
- package/dist/assets/guide_loading.md.DXyITe0U.js +26 -0
- package/dist/assets/guide_loading.md.DXyITe0U.lean.js +1 -0
- package/dist/assets/guide_remote-components-migration.md.kgyKN8C0.js +1 -0
- package/dist/assets/guide_remote-components-migration.md.kgyKN8C0.lean.js +1 -0
- package/dist/assets/index.md.BjataINt.js +1 -0
- package/dist/assets/index.md.BjataINt.lean.js +1 -0
- package/dist/assets/inter-italic-cyrillic-ext.r48I6akx.woff2 +0 -0
- package/dist/assets/inter-italic-cyrillic.By2_1cv3.woff2 +0 -0
- package/dist/assets/inter-italic-greek-ext.1u6EdAuj.woff2 +0 -0
- package/dist/assets/inter-italic-greek.DJ8dCoTZ.woff2 +0 -0
- package/dist/assets/inter-italic-latin-ext.CN1xVJS-.woff2 +0 -0
- package/dist/assets/inter-italic-latin.C2AdPX0b.woff2 +0 -0
- package/dist/assets/inter-italic-vietnamese.BSbpV94h.woff2 +0 -0
- package/dist/assets/inter-roman-cyrillic-ext.BBPuwvHQ.woff2 +0 -0
- package/dist/assets/inter-roman-cyrillic.C5lxZ8CY.woff2 +0 -0
- package/dist/assets/inter-roman-greek-ext.CqjqNYQ-.woff2 +0 -0
- package/dist/assets/inter-roman-greek.BBVDIX6e.woff2 +0 -0
- package/dist/assets/inter-roman-latin-ext.4ZJIpNVo.woff2 +0 -0
- package/dist/assets/inter-roman-latin.Di8DUHzh.woff2 +0 -0
- package/dist/assets/inter-roman-vietnamese.BjW4sHH5.woff2 +0 -0
- package/dist/assets/modules_catalog_antd.md.Cgd56o0B.js +1 -0
- package/dist/assets/modules_catalog_antd.md.Cgd56o0B.lean.js +1 -0
- package/dist/assets/modules_catalog_art.md.DQ5m39nM.js +1 -0
- package/dist/assets/modules_catalog_art.md.DQ5m39nM.lean.js +1 -0
- package/dist/assets/modules_catalog_bag.md.CzjJb77W.js +1 -0
- package/dist/assets/modules_catalog_bag.md.CzjJb77W.lean.js +1 -0
- package/dist/assets/modules_catalog_basic.md.BC0y8SSq.js +1 -0
- package/dist/assets/modules_catalog_basic.md.BC0y8SSq.lean.js +1 -0
- package/dist/assets/modules_catalog_core.md.CYL5pYd1.js +1 -0
- package/dist/assets/modules_catalog_core.md.CYL5pYd1.lean.js +1 -0
- package/dist/assets/modules_catalog_datav.md.Dh186R8u.js +1 -0
- package/dist/assets/modules_catalog_datav.md.Dh186R8u.lean.js +1 -0
- package/dist/assets/modules_catalog_element.md.DDh1tkSP.js +1 -0
- package/dist/assets/modules_catalog_element.md.DDh1tkSP.lean.js +1 -0
- package/dist/assets/modules_catalog_fan.md.hGUCeHFP.js +1 -0
- package/dist/assets/modules_catalog_fan.md.hGUCeHFP.lean.js +1 -0
- package/dist/assets/modules_catalog_finance.md.BL-3mKOX.js +1 -0
- package/dist/assets/modules_catalog_finance.md.BL-3mKOX.lean.js +1 -0
- package/dist/assets/modules_catalog_iot.md.HUB4zqvP.js +1 -0
- package/dist/assets/modules_catalog_iot.md.HUB4zqvP.lean.js +1 -0
- package/dist/assets/modules_catalog_leva.md.xnY3IHiZ.js +1 -0
- package/dist/assets/modules_catalog_leva.md.xnY3IHiZ.lean.js +1 -0
- package/dist/assets/modules_catalog_medical.md.CM6D1vOA.js +1 -0
- package/dist/assets/modules_catalog_medical.md.CM6D1vOA.lean.js +1 -0
- package/dist/assets/modules_catalog_picker.md.CC2mijW_.js +1 -0
- package/dist/assets/modules_catalog_picker.md.CC2mijW_.lean.js +1 -0
- package/dist/assets/modules_catalog_popular.md.VJkfyFdA.js +1 -0
- package/dist/assets/modules_catalog_popular.md.VJkfyFdA.lean.js +1 -0
- package/dist/assets/modules_catalog_pure.md.Cl7QTO45.js +1 -0
- package/dist/assets/modules_catalog_pure.md.Cl7QTO45.lean.js +1 -0
- package/dist/assets/modules_catalog_qiankun.md.CAf0jwQz.js +1 -0
- package/dist/assets/modules_catalog_qiankun.md.CAf0jwQz.lean.js +1 -0
- package/dist/assets/modules_catalog_station.md.CbDnVFa5.js +1 -0
- package/dist/assets/modules_catalog_station.md.CbDnVFa5.lean.js +1 -0
- package/dist/assets/modules_catalog_tdesign.md.Gp96ctSt.js +1 -0
- package/dist/assets/modules_catalog_tdesign.md.Gp96ctSt.lean.js +1 -0
- package/dist/assets/modules_catalog_tools.md.DRRPRcDA.js +1 -0
- package/dist/assets/modules_catalog_tools.md.DRRPRcDA.lean.js +1 -0
- package/dist/assets/modules_catalog_vben.md.dLilYUhJ.js +1 -0
- package/dist/assets/modules_catalog_vben.md.dLilYUhJ.lean.js +1 -0
- package/dist/assets/modules_components.md.BHx-IKxf.js +1 -0
- package/dist/assets/modules_components.md.BHx-IKxf.lean.js +1 -0
- package/dist/assets/modules_demos.md.PSC2QqBk.js +1 -0
- package/dist/assets/modules_demos.md.PSC2QqBk.lean.js +1 -0
- package/dist/assets/modules_docs-and-services.md.BskjIpiB.js +7 -0
- package/dist/assets/modules_docs-and-services.md.BskjIpiB.lean.js +1 -0
- package/dist/assets/modules_index.md.BpBrncv3.js +1 -0
- package/dist/assets/modules_index.md.BpBrncv3.lean.js +1 -0
- package/dist/assets/modules_libs.md.BErgFb5b.js +1 -0
- package/dist/assets/modules_libs.md.BErgFb5b.lean.js +1 -0
- package/dist/assets/modules_templates.md.BkCEYHfn.js +1 -0
- package/dist/assets/modules_templates.md.BkCEYHfn.lean.js +1 -0
- package/dist/assets/style.DjxGp8js.css +1 -0
- package/dist/favicon.ico +0 -0
- package/dist/guide/browser-esm.html +58 -0
- package/dist/guide/core.html +26 -0
- package/dist/guide/getting-started.html +58 -0
- package/dist/guide/introduction.html +32 -0
- package/dist/guide/loading.html +51 -0
- package/dist/guide/remote-components-migration.html +26 -0
- package/dist/hashmap.json +1 -0
- package/dist/index.html +26 -0
- package/dist/logo.svg +11 -0
- package/dist/modules/catalog/antd.html +26 -0
- package/dist/modules/catalog/art.html +26 -0
- package/dist/modules/catalog/bag.html +26 -0
- package/dist/modules/catalog/basic.html +26 -0
- package/dist/modules/catalog/core.html +26 -0
- package/dist/modules/catalog/datav.html +26 -0
- package/dist/modules/catalog/element.html +26 -0
- package/dist/modules/catalog/fan.html +26 -0
- package/dist/modules/catalog/finance.html +26 -0
- package/dist/modules/catalog/iot.html +26 -0
- package/dist/modules/catalog/leva.html +26 -0
- package/dist/modules/catalog/medical.html +26 -0
- package/dist/modules/catalog/picker.html +26 -0
- package/dist/modules/catalog/popular.html +26 -0
- package/dist/modules/catalog/pure.html +26 -0
- package/dist/modules/catalog/qiankun.html +26 -0
- package/dist/modules/catalog/station.html +26 -0
- package/dist/modules/catalog/tdesign.html +26 -0
- package/dist/modules/catalog/tools.html +26 -0
- package/dist/modules/catalog/vben.html +26 -0
- package/dist/modules/components.html +26 -0
- package/dist/modules/demos.html +26 -0
- package/dist/modules/docs-and-services.html +32 -0
- package/dist/modules/index.html +26 -0
- package/dist/modules/libs.html +26 -0
- package/dist/modules/templates.html +26 -0
- package/dist/vp-icons.css +0 -0
- package/package.json +25 -3
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/chunks/VPLocalSearchBox.Bi9Y__e6.js","assets/chunks/framework.B8fSEufx.js"])))=>i.map(i=>d[i]);
|
|
2
|
+
import{d as p,c as u,r as c,n as N,o as s,a as j,t as M,b as _,w as h,T as he,e as m,_ as g,u as Ue,i as Ge,f as je,g as me,h as y,j as d,k as r,l as z,m as ie,p as S,q as O,s as Y,v as G,x as pe,y as ke,z as ze,A as We,F as w,B as A,C as W,D as Q,E as k,G as Te,H as E,I as Ne,J as Z,K as U,L as ee,M as Ke,N as Me,O as le,P as we,Q as xe,R as te,S as Re,U as qe,V as Je,W as Ie,X as Ae,Y as Xe,Z as Ye,$ as Qe,a0 as Ze,a1 as et}from"./framework.B8fSEufx.js";const tt=p({__name:"VPBadge",props:{text:{},type:{default:"tip"}},setup(e){return(t,n)=>(s(),u("span",{class:N(["VPBadge",e.type])},[c(t.$slots,"default",{},()=>[j(M(e.text),1)])],2))}}),nt={key:0,class:"VPBackdrop"},ot=p({__name:"VPBackdrop",props:{show:{type:Boolean}},setup(e){return(t,n)=>(s(),_(he,{name:"fade"},{default:h(()=>[e.show?(s(),u("div",nt)):m("",!0)]),_:1}))}}),at=g(ot,[["__scopeId","data-v-72ae660b"]]),L=Ue;function st(e,t){let n,o=!1;return()=>{n&&clearTimeout(n),o?n=setTimeout(e,t):(e(),(o=!0)&&setTimeout(()=>o=!1,t))}}function ce(e){return e.startsWith("/")?e:`/${e}`}function _e(e){const{pathname:t,search:n,hash:o,protocol:a}=new URL(e,"http://a.com");if(Ge(e)||e.startsWith("#")||!a.startsWith("http")||!je(t))return e;const{site:i}=L(),l=t.endsWith("/")||t.endsWith(".html")?e:e.replace(/(?:(^\.+)\/)?.*$/,`$1${t.replace(/(\.md)?$/,i.value.cleanUrls?"":".html")}${n}${o}`);return me(l)}function R({correspondingLink:e=!1}={}){const{site:t,localeIndex:n,page:o,theme:a,hash:i}=L(),l=y(()=>{var f,$;return{label:(f=t.value.locales[n.value])==null?void 0:f.label,link:(($=t.value.locales[n.value])==null?void 0:$.link)||(n.value==="root"?"/":`/${n.value}/`)}});return{localeLinks:y(()=>Object.entries(t.value.locales).flatMap(([f,$])=>l.value.label===$.label?[]:{text:$.label,link:rt($.link||(f==="root"?"/":`/${f}/`),a.value.i18nRouting!==!1&&e,o.value.relativePath.slice(l.value.link.length-1),!t.value.cleanUrls)+i.value})),currentLang:l}}function rt(e,t,n,o){return t?e.replace(/\/$/,"")+ce(n.replace(/(^|\/)index\.md$/,"$1").replace(/\.md$/,o?".html":"")):e}const it={class:"NotFound"},lt={class:"code"},ct={class:"title"},ut={class:"quote"},dt={class:"action"},vt=["href","aria-label"],ft=p({__name:"NotFound",setup(e){const{theme:t}=L(),{currentLang:n}=R();return(o,a)=>{var i,l,v,f,$;return s(),u("div",it,[d("p",lt,M(((i=r(t).notFound)==null?void 0:i.code)??"404"),1),d("h1",ct,M(((l=r(t).notFound)==null?void 0:l.title)??"PAGE NOT FOUND"),1),a[0]||(a[0]=d("div",{class:"divider"},null,-1)),d("blockquote",ut,M(((v=r(t).notFound)==null?void 0:v.quote)??"But if you don't change your direction, and if you keep looking, you may end up where you are heading."),1),d("div",dt,[d("a",{class:"link",href:r(me)(r(n).link),"aria-label":((f=r(t).notFound)==null?void 0:f.linkLabel)??"go to home"},M((($=r(t).notFound)==null?void 0:$.linkText)??"Take me home"),9,vt)])])}}}),ht=g(ft,[["__scopeId","data-v-1e66b723"]]);function Ce(e,t){if(Array.isArray(e))return J(e);if(e==null)return[];t=ce(t);const n=Object.keys(e).sort((a,i)=>i.split("/").length-a.split("/").length).find(a=>t.startsWith(ce(a))),o=n?e[n]:[];return Array.isArray(o)?J(o):J(o.items,o.base)}function mt(e){const t=[];let n=0;for(const o in e){const a=e[o];if(a.items){n=t.push(a);continue}t[n]||t.push({items:[]}),t[n].items.push(a)}return t}function pt(e){const t=[];function n(o){for(const a of o)a.text&&a.link&&t.push({text:a.text,link:a.link,docFooterText:a.docFooterText}),a.items&&n(a.items)}return n(e),t}function ue(e,t){return Array.isArray(t)?t.some(n=>ue(e,n)):z(e,t.link)?!0:t.items?ue(e,t.items):!1}function J(e,t){return[...e].map(n=>{const o={...n},a=o.base||t;return a&&o.link&&(o.link=a+o.link),o.items&&(o.items=J(o.items,a)),o})}function F(){const{frontmatter:e,page:t,theme:n}=L(),o=ie("(min-width: 960px)"),a=S(!1),i=y(()=>{const I=n.value.sidebar,C=t.value.relativePath;return I?Ce(I,C):[]}),l=S(i.value);O(i,(I,C)=>{JSON.stringify(I)!==JSON.stringify(C)&&(l.value=i.value)});const v=y(()=>e.value.sidebar!==!1&&l.value.length>0&&e.value.layout!=="home"),f=y(()=>$?e.value.aside==null?n.value.aside==="left":e.value.aside==="left":!1),$=y(()=>e.value.layout==="home"?!1:e.value.aside!=null?!!e.value.aside:n.value.aside!==!1),V=y(()=>v.value&&o.value),b=y(()=>v.value?mt(l.value):[]);function P(){a.value=!0}function T(){a.value=!1}function x(){a.value?T():P()}return{isOpen:a,sidebar:l,sidebarGroups:b,hasSidebar:v,hasAside:$,leftAside:f,isSidebarEnabled:V,open:P,close:T,toggle:x}}function kt(e,t){let n;Y(()=>{n=e.value?document.activeElement:void 0}),G(()=>{window.addEventListener("keyup",o)}),pe(()=>{window.removeEventListener("keyup",o)});function o(a){a.key==="Escape"&&e.value&&(t(),n==null||n.focus())}}function _t(e){const{page:t,hash:n}=L(),o=S(!1),a=y(()=>e.value.collapsed!=null),i=y(()=>!!e.value.link),l=S(!1),v=()=>{l.value=z(t.value.relativePath,e.value.link)};O([t,e,n],v),G(v);const f=y(()=>l.value?!0:e.value.items?ue(t.value.relativePath,e.value.items):!1),$=y(()=>!!(e.value.items&&e.value.items.length));Y(()=>{o.value=!!(a.value&&e.value.collapsed)}),ke(()=>{(l.value||f.value)&&(o.value=!1)});function V(){a.value&&(o.value=!o.value)}return{collapsed:o,collapsible:a,isLink:i,isActiveLink:l,hasActiveLink:f,hasChildren:$,toggle:V}}function bt(){const{hasSidebar:e}=F(),t=ie("(min-width: 960px)"),n=ie("(min-width: 1280px)");return{isAsideEnabled:y(()=>!n.value&&!t.value?!1:e.value?n.value:t.value)}}const gt=/\b(?:VPBadge|header-anchor|footnote-ref|ignore-header)\b/,de=[];function He(e){return typeof e.outline=="object"&&!Array.isArray(e.outline)&&e.outline.label||e.outlineTitle||"On this page"}function be(e){const t=[...document.querySelectorAll(".VPDoc :where(h1,h2,h3,h4,h5,h6)")].filter(n=>n.id&&n.hasChildNodes()).map(n=>{const o=Number(n.tagName[1]);return{element:n,title:$t(n),link:"#"+n.id,level:o}});return yt(t,e)}function $t(e){let t="";for(const n of e.childNodes)if(n.nodeType===1){if(gt.test(n.className))continue;t+=n.textContent}else n.nodeType===3&&(t+=n.textContent);return t.trim()}function yt(e,t){if(t===!1)return[];const n=(typeof t=="object"&&!Array.isArray(t)?t.level:t)||2,[o,a]=typeof n=="number"?[n,n]:n==="deep"?[2,6]:n;return Vt(e,o,a)}function Pt(e,t){const{isAsideEnabled:n}=bt(),o=st(i,100);let a=null;G(()=>{requestAnimationFrame(i),window.addEventListener("scroll",o)}),ze(()=>{l(location.hash)}),pe(()=>{window.removeEventListener("scroll",o)});function i(){if(!n.value)return;const v=window.scrollY,f=window.innerHeight,$=document.body.offsetHeight,V=Math.abs(v+f-$)<1,b=de.map(({element:T,link:x})=>({link:x,top:Lt(T)})).filter(({top:T})=>!Number.isNaN(T)).sort((T,x)=>T.top-x.top);if(!b.length){l(null);return}if(v<1){l(null);return}if(V){l(b[b.length-1].link);return}let P=null;for(const{link:T,top:x}of b){if(x>v+We()+4)break;P=T}l(P)}function l(v){a&&a.classList.remove("active"),v==null?a=null:a=e.value.querySelector(`a[href="${decodeURIComponent(v)}"]`);const f=a;f?(f.classList.add("active"),t.value.style.top=f.offsetTop+39+"px",t.value.style.opacity="1"):(t.value.style.top="33px",t.value.style.opacity="0")}}function Lt(e){let t=0;for(;e!==document.body;){if(e===null)return NaN;t+=e.offsetTop,e=e.offsetParent}return t}function Vt(e,t,n){de.length=0;const o=[],a=[];return e.forEach(i=>{const l={...i,children:[]};let v=a[a.length-1];for(;v&&v.level>=l.level;)a.pop(),v=a[a.length-1];if(l.element.classList.contains("ignore-header")||v&&"shouldIgnore"in v){a.push({level:l.level,shouldIgnore:!0});return}l.level>n||l.level<t||(de.push({element:l.element,link:l.link}),v?v.children.push(l):o.push(l),a.push(l))}),o}const St=["href","title"],Tt=p({__name:"VPDocOutlineItem",props:{headers:{},root:{type:Boolean}},setup(e){function t({target:n}){const o=n.href.split("#")[1],a=document.getElementById(decodeURIComponent(o));a==null||a.focus({preventScroll:!0})}return(n,o)=>{const a=W("VPDocOutlineItem",!0);return s(),u("ul",{class:N(["VPDocOutlineItem",e.root?"root":"nested"])},[(s(!0),u(w,null,A(e.headers,({children:i,link:l,title:v})=>(s(),u("li",null,[d("a",{class:"outline-link",href:l,onClick:t,title:v},M(v),9,St),i!=null&&i.length?(s(),_(a,{key:0,headers:i},null,8,["headers"])):m("",!0)]))),256))],2)}}}),Ee=g(Tt,[["__scopeId","data-v-4e3ae89d"]]),Nt={class:"content"},Mt={"aria-level":"2",class:"outline-title",id:"doc-outline-aria-label",role:"heading"},wt=p({__name:"VPDocAsideOutline",setup(e){const{frontmatter:t,theme:n}=L(),o=Te([]);Q(()=>{o.value=be(t.value.outline??n.value.outline)});const a=S(),i=S();return Pt(a,i),(l,v)=>(s(),u("nav",{"aria-labelledby":"doc-outline-aria-label",class:N(["VPDocAsideOutline",{"has-outline":o.value.length>0}]),ref_key:"container",ref:a},[d("div",Nt,[d("div",{class:"outline-marker",ref_key:"marker",ref:i},null,512),d("div",Mt,M(r(He)(r(n))),1),k(Ee,{headers:o.value,root:!0},null,8,["headers"])])],2))}}),xt=g(wt,[["__scopeId","data-v-e1b5d7b1"]]),It={class:"VPDocAsideCarbonAds"},At=p({__name:"VPDocAsideCarbonAds",props:{carbonAds:{}},setup(e){const t=()=>null;return(n,o)=>(s(),u("div",It,[k(r(t),{"carbon-ads":e.carbonAds},null,8,["carbon-ads"])]))}}),Ct={class:"VPDocAside"},Ht=p({__name:"VPDocAside",setup(e){const{theme:t}=L();return(n,o)=>(s(),u("div",Ct,[c(n.$slots,"aside-top",{},void 0,!0),c(n.$slots,"aside-outline-before",{},void 0,!0),k(xt),c(n.$slots,"aside-outline-after",{},void 0,!0),o[0]||(o[0]=d("div",{class:"spacer"},null,-1)),c(n.$slots,"aside-ads-before",{},void 0,!0),r(t).carbonAds?(s(),_(At,{key:0,"carbon-ads":r(t).carbonAds},null,8,["carbon-ads"])):m("",!0),c(n.$slots,"aside-ads-after",{},void 0,!0),c(n.$slots,"aside-bottom",{},void 0,!0)]))}}),Et=g(Ht,[["__scopeId","data-v-b2e2d543"]]);function Bt(){const{theme:e,page:t}=L();return y(()=>{const{text:n="Edit this page",pattern:o=""}=e.value.editLink||{};let a;return typeof o=="function"?a=o(t.value):a=o.replace(/:path/g,t.value.filePath),{url:a,text:n}})}function Ot(){const{page:e,theme:t,frontmatter:n}=L();return y(()=>{var $,V,b,P,T,x,I,C;const o=Ce(t.value.sidebar,e.value.relativePath),a=pt(o),i=Ft(a,H=>H.link.replace(/[?#].*$/,"")),l=i.findIndex(H=>z(e.value.relativePath,H.link)),v=(($=t.value.docFooter)==null?void 0:$.prev)===!1&&!n.value.prev||n.value.prev===!1,f=((V=t.value.docFooter)==null?void 0:V.next)===!1&&!n.value.next||n.value.next===!1;return{prev:v?void 0:{text:(typeof n.value.prev=="string"?n.value.prev:typeof n.value.prev=="object"?n.value.prev.text:void 0)??((b=i[l-1])==null?void 0:b.docFooterText)??((P=i[l-1])==null?void 0:P.text),link:(typeof n.value.prev=="object"?n.value.prev.link:void 0)??((T=i[l-1])==null?void 0:T.link)},next:f?void 0:{text:(typeof n.value.next=="string"?n.value.next:typeof n.value.next=="object"?n.value.next.text:void 0)??((x=i[l+1])==null?void 0:x.docFooterText)??((I=i[l+1])==null?void 0:I.text),link:(typeof n.value.next=="object"?n.value.next.link:void 0)??((C=i[l+1])==null?void 0:C.link)}}})}function Ft(e,t){const n=new Set;return e.filter(o=>{const a=t(o);return n.has(a)?!1:n.add(a)})}const B=p({__name:"VPLink",props:{tag:{},href:{},noIcon:{type:Boolean},target:{},rel:{}},setup(e){const t=e,n=y(()=>t.tag??(t.href?"a":"span")),o=y(()=>t.href&&Ne.test(t.href)||t.target==="_blank");return(a,i)=>(s(),_(E(n.value),{class:N(["VPLink",{link:e.href,"vp-external-link-icon":o.value,"no-icon":e.noIcon}]),href:e.href?r(_e)(e.href):void 0,target:e.target??(o.value?"_blank":void 0),rel:e.rel??(o.value?"noreferrer":void 0)},{default:h(()=>[c(a.$slots,"default")]),_:3},8,["class","href","target","rel"]))}}),Dt={class:"VPLastUpdated"},Ut=["datetime"],Gt=p({__name:"VPDocFooterLastUpdated",setup(e){const{theme:t,page:n,lang:o}=L(),a=y(()=>new Date(n.value.lastUpdated)),i=y(()=>a.value.toISOString()),l=S("");return G(()=>{Y(()=>{var v,f,$;l.value=new Intl.DateTimeFormat((f=(v=t.value.lastUpdated)==null?void 0:v.formatOptions)!=null&&f.forceLocale?o.value:void 0,(($=t.value.lastUpdated)==null?void 0:$.formatOptions)??{dateStyle:"short",timeStyle:"short"}).format(a.value)})}),(v,f)=>{var $;return s(),u("p",Dt,[j(M((($=r(t).lastUpdated)==null?void 0:$.text)||r(t).lastUpdatedText||"Last updated")+": ",1),d("time",{datetime:i.value},M(l.value),9,Ut)])}}}),jt=g(Gt,[["__scopeId","data-v-04352d80"]]),zt={key:0,class:"VPDocFooter"},Wt={key:0,class:"edit-info"},Kt={key:0,class:"edit-link"},Rt={key:1,class:"last-updated"},qt={key:1,class:"prev-next","aria-labelledby":"doc-footer-aria-label"},Jt={class:"pager"},Xt=["innerHTML"],Yt=["innerHTML"],Qt={class:"pager"},Zt=["innerHTML"],en=["innerHTML"],tn=p({__name:"VPDocFooter",setup(e){const{theme:t,page:n,frontmatter:o}=L(),a=Bt(),i=Ot(),l=y(()=>t.value.editLink&&o.value.editLink!==!1),v=y(()=>n.value.lastUpdated),f=y(()=>l.value||v.value||i.value.prev||i.value.next);return($,V)=>{var b,P,T,x;return f.value?(s(),u("footer",zt,[c($.$slots,"doc-footer-before",{},void 0,!0),l.value||v.value?(s(),u("div",Wt,[l.value?(s(),u("div",Kt,[k(B,{class:"edit-link-button",href:r(a).url,"no-icon":!0},{default:h(()=>[V[0]||(V[0]=d("span",{class:"vpi-square-pen edit-link-icon"},null,-1)),j(" "+M(r(a).text),1)]),_:1},8,["href"])])):m("",!0),v.value?(s(),u("div",Rt,[k(jt)])):m("",!0)])):m("",!0),(b=r(i).prev)!=null&&b.link||(P=r(i).next)!=null&&P.link?(s(),u("nav",qt,[V[1]||(V[1]=d("span",{class:"visually-hidden",id:"doc-footer-aria-label"},"Pager",-1)),d("div",Jt,[(T=r(i).prev)!=null&&T.link?(s(),_(B,{key:0,class:"pager-link prev",href:r(i).prev.link},{default:h(()=>{var I;return[d("span",{class:"desc",innerHTML:((I=r(t).docFooter)==null?void 0:I.prev)||"Previous page"},null,8,Xt),d("span",{class:"title",innerHTML:r(i).prev.text},null,8,Yt)]}),_:1},8,["href"])):m("",!0)]),d("div",Qt,[(x=r(i).next)!=null&&x.link?(s(),_(B,{key:0,class:"pager-link next",href:r(i).next.link},{default:h(()=>{var I;return[d("span",{class:"desc",innerHTML:((I=r(t).docFooter)==null?void 0:I.next)||"Next page"},null,8,Zt),d("span",{class:"title",innerHTML:r(i).next.text},null,8,en)]}),_:1},8,["href"])):m("",!0)])])):m("",!0)])):m("",!0)}}}),nn=g(tn,[["__scopeId","data-v-7828e31e"]]),on={class:"container"},an={class:"aside-container"},sn={class:"aside-content"},rn={class:"content"},ln={class:"content-container"},cn={class:"main"},un=p({__name:"VPDoc",setup(e){const{theme:t}=L(),n=Z(),{hasSidebar:o,hasAside:a,leftAside:i}=F(),l=y(()=>n.path.replace(/[./]+/g,"_").replace(/_html$/,""));return(v,f)=>{const $=W("Content");return s(),u("div",{class:N(["VPDoc",{"has-sidebar":r(o),"has-aside":r(a)}])},[c(v.$slots,"doc-top",{},void 0,!0),d("div",on,[r(a)?(s(),u("div",{key:0,class:N(["aside",{"left-aside":r(i)}])},[f[0]||(f[0]=d("div",{class:"aside-curtain"},null,-1)),d("div",an,[d("div",sn,[k(Et,null,{"aside-top":h(()=>[c(v.$slots,"aside-top",{},void 0,!0)]),"aside-bottom":h(()=>[c(v.$slots,"aside-bottom",{},void 0,!0)]),"aside-outline-before":h(()=>[c(v.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":h(()=>[c(v.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":h(()=>[c(v.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":h(()=>[c(v.$slots,"aside-ads-after",{},void 0,!0)]),_:3})])])],2)):m("",!0),d("div",rn,[d("div",ln,[c(v.$slots,"doc-before",{},void 0,!0),d("main",cn,[k($,{class:N(["vp-doc",[l.value,r(t).externalLinkIcon&&"external-link-icon-enabled"]])},null,8,["class"])]),k(nn,null,{"doc-footer-before":h(()=>[c(v.$slots,"doc-footer-before",{},void 0,!0)]),_:3}),c(v.$slots,"doc-after",{},void 0,!0)])])]),c(v.$slots,"doc-bottom",{},void 0,!0)],2)}}}),dn=g(un,[["__scopeId","data-v-ecd06071"]]),vn=p({__name:"VPButton",props:{tag:{},size:{default:"medium"},theme:{default:"brand"},text:{},href:{},target:{},rel:{}},setup(e){const t=e,n=y(()=>t.href&&Ne.test(t.href)),o=y(()=>t.tag||(t.href?"a":"button"));return(a,i)=>(s(),_(E(o.value),{class:N(["VPButton",[e.size,e.theme]]),href:e.href?r(_e)(e.href):void 0,target:t.target??(n.value?"_blank":void 0),rel:t.rel??(n.value?"noreferrer":void 0)},{default:h(()=>[j(M(e.text),1)]),_:1},8,["class","href","target","rel"]))}}),fn=g(vn,[["__scopeId","data-v-573a094b"]]),hn=["src","alt"],mn=p({inheritAttrs:!1,__name:"VPImage",props:{image:{},alt:{}},setup(e){return(t,n)=>{const o=W("VPImage",!0);return e.image?(s(),u(w,{key:0},[typeof e.image=="string"||"src"in e.image?(s(),u("img",U({key:0,class:"VPImage"},typeof e.image=="string"?t.$attrs:{...e.image,...t.$attrs},{src:r(me)(typeof e.image=="string"?e.image:e.image.src),alt:e.alt??(typeof e.image=="string"?"":e.image.alt||"")}),null,16,hn)):(s(),u(w,{key:1},[k(o,U({class:"dark",image:e.image.dark,alt:e.image.alt},t.$attrs),null,16,["image","alt"]),k(o,U({class:"light",image:e.image.light,alt:e.image.alt},t.$attrs),null,16,["image","alt"])],64))],64)):m("",!0)}}}),X=g(mn,[["__scopeId","data-v-0723c290"]]),pn={class:"container"},kn={class:"main"},_n={class:"heading"},bn=["innerHTML"],gn=["innerHTML"],$n=["innerHTML"],yn={key:0,class:"actions"},Pn={key:0,class:"image"},Ln={class:"image-container"},Vn=p({__name:"VPHero",props:{name:{},text:{},tagline:{},image:{},actions:{}},setup(e){const t=ee("hero-image-slot-exists");return(n,o)=>(s(),u("div",{class:N(["VPHero",{"has-image":e.image||r(t)}])},[d("div",pn,[d("div",kn,[c(n.$slots,"home-hero-info-before",{},void 0,!0),c(n.$slots,"home-hero-info",{},()=>[d("h1",_n,[e.name?(s(),u("span",{key:0,innerHTML:e.name,class:"name clip"},null,8,bn)):m("",!0),e.text?(s(),u("span",{key:1,innerHTML:e.text,class:"text"},null,8,gn)):m("",!0)]),e.tagline?(s(),u("p",{key:0,innerHTML:e.tagline,class:"tagline"},null,8,$n)):m("",!0)],!0),c(n.$slots,"home-hero-info-after",{},void 0,!0),e.actions?(s(),u("div",yn,[(s(!0),u(w,null,A(e.actions,a=>(s(),u("div",{key:a.link,class:"action"},[k(fn,{tag:"a",size:"medium",theme:a.theme,text:a.text,href:a.link,target:a.target,rel:a.rel},null,8,["theme","text","href","target","rel"])]))),128))])):m("",!0),c(n.$slots,"home-hero-actions-after",{},void 0,!0)]),e.image||r(t)?(s(),u("div",Pn,[d("div",Ln,[o[0]||(o[0]=d("div",{class:"image-bg"},null,-1)),c(n.$slots,"home-hero-image",{},()=>[e.image?(s(),_(X,{key:0,class:"image-src",image:e.image},null,8,["image"])):m("",!0)],!0)])])):m("",!0)])],2))}}),Sn=g(Vn,[["__scopeId","data-v-87f9eef1"]]),Tn=p({__name:"VPHomeHero",setup(e){const{frontmatter:t}=L();return(n,o)=>r(t).hero?(s(),_(Sn,{key:0,class:"VPHomeHero",name:r(t).hero.name,text:r(t).hero.text,tagline:r(t).hero.tagline,image:r(t).hero.image,actions:r(t).hero.actions},{"home-hero-info-before":h(()=>[c(n.$slots,"home-hero-info-before")]),"home-hero-info":h(()=>[c(n.$slots,"home-hero-info")]),"home-hero-info-after":h(()=>[c(n.$slots,"home-hero-info-after")]),"home-hero-actions-after":h(()=>[c(n.$slots,"home-hero-actions-after")]),"home-hero-image":h(()=>[c(n.$slots,"home-hero-image")]),_:3},8,["name","text","tagline","image","actions"])):m("",!0)}}),Nn={class:"box"},Mn={key:0,class:"icon"},wn=["innerHTML"],xn=["innerHTML"],In=["innerHTML"],An={key:4,class:"link-text"},Cn={class:"link-text-value"},Hn=p({__name:"VPFeature",props:{icon:{},title:{},details:{},link:{},linkText:{},rel:{},target:{}},setup(e){return(t,n)=>(s(),_(B,{class:"VPFeature",href:e.link,rel:e.rel,target:e.target,"no-icon":!0,tag:e.link?"a":"div"},{default:h(()=>[d("article",Nn,[typeof e.icon=="object"&&e.icon.wrap?(s(),u("div",Mn,[k(X,{image:e.icon,alt:e.icon.alt,height:e.icon.height||48,width:e.icon.width||48},null,8,["image","alt","height","width"])])):typeof e.icon=="object"?(s(),_(X,{key:1,image:e.icon,alt:e.icon.alt,height:e.icon.height||48,width:e.icon.width||48},null,8,["image","alt","height","width"])):e.icon?(s(),u("div",{key:2,class:"icon",innerHTML:e.icon},null,8,wn)):m("",!0),d("h2",{class:"title",innerHTML:e.title},null,8,xn),e.details?(s(),u("p",{key:3,class:"details",innerHTML:e.details},null,8,In)):m("",!0),e.linkText?(s(),u("div",An,[d("p",Cn,[j(M(e.linkText)+" ",1),n[0]||(n[0]=d("span",{class:"vpi-arrow-right link-text-icon"},null,-1))])])):m("",!0)])]),_:1},8,["href","rel","target","tag"]))}}),En=g(Hn,[["__scopeId","data-v-ce605f93"]]),Bn={key:0,class:"VPFeatures"},On={class:"container"},Fn={class:"items"},Dn=p({__name:"VPFeatures",props:{features:{}},setup(e){const t=e,n=y(()=>{const o=t.features.length;if(o){if(o===2)return"grid-2";if(o===3)return"grid-3";if(o%3===0)return"grid-6";if(o>3)return"grid-4"}else return});return(o,a)=>e.features?(s(),u("div",Bn,[d("div",On,[d("div",Fn,[(s(!0),u(w,null,A(e.features,i=>(s(),u("div",{key:i.title,class:N(["item",[n.value]])},[k(En,{icon:i.icon,title:i.title,details:i.details,link:i.link,"link-text":i.linkText,rel:i.rel,target:i.target},null,8,["icon","title","details","link","link-text","rel","target"])],2))),128))])])])):m("",!0)}}),Un=g(Dn,[["__scopeId","data-v-0697a0a8"]]),Gn=p({__name:"VPHomeFeatures",setup(e){const{frontmatter:t}=L();return(n,o)=>r(t).features?(s(),_(Un,{key:0,class:"VPHomeFeatures",features:r(t).features},null,8,["features"])):m("",!0)}}),jn=p({__name:"VPHomeContent",setup(e){const{width:t}=Ke({initialWidth:0,includeScrollbar:!1});return(n,o)=>(s(),u("div",{class:"vp-doc container",style:Me(r(t)?{"--vp-offset":`calc(50% - ${r(t)/2}px)`}:{})},[c(n.$slots,"default",{},void 0,!0)],4))}}),zn=g(jn,[["__scopeId","data-v-92970b0a"]]),Wn=p({__name:"VPHome",setup(e){const{frontmatter:t,theme:n}=L();return(o,a)=>{const i=W("Content");return s(),u("div",{class:N(["VPHome",{"external-link-icon-enabled":r(n).externalLinkIcon}])},[c(o.$slots,"home-hero-before",{},void 0,!0),k(Tn,null,{"home-hero-info-before":h(()=>[c(o.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":h(()=>[c(o.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":h(()=>[c(o.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":h(()=>[c(o.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":h(()=>[c(o.$slots,"home-hero-image",{},void 0,!0)]),_:3}),c(o.$slots,"home-hero-after",{},void 0,!0),c(o.$slots,"home-features-before",{},void 0,!0),k(Gn),c(o.$slots,"home-features-after",{},void 0,!0),r(t).markdownStyles!==!1?(s(),_(zn,{key:0},{default:h(()=>[k(i)]),_:1})):(s(),_(i,{key:1}))],2)}}}),Kn=g(Wn,[["__scopeId","data-v-32d7d5ba"]]),Rn={},qn={class:"VPPage"};function Jn(e,t){const n=W("Content");return s(),u("div",qn,[c(e.$slots,"page-top"),k(n),c(e.$slots,"page-bottom")])}const Xn=g(Rn,[["render",Jn]]),Yn=p({__name:"VPContent",setup(e){const{page:t,frontmatter:n}=L(),{hasSidebar:o}=F();return(a,i)=>(s(),u("div",{class:N(["VPContent",{"has-sidebar":r(o),"is-home":r(n).layout==="home"}]),id:"VPContent"},[r(t).isNotFound?c(a.$slots,"not-found",{},()=>[k(ht)],!0,0):r(n).layout==="page"?(s(),_(Xn,{key:1},{"page-top":h(()=>[c(a.$slots,"page-top",{},void 0,!0)]),"page-bottom":h(()=>[c(a.$slots,"page-bottom",{},void 0,!0)]),_:3})):r(n).layout==="home"?(s(),_(Kn,{key:2},{"home-hero-before":h(()=>[c(a.$slots,"home-hero-before",{},void 0,!0)]),"home-hero-info-before":h(()=>[c(a.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":h(()=>[c(a.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":h(()=>[c(a.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":h(()=>[c(a.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":h(()=>[c(a.$slots,"home-hero-image",{},void 0,!0)]),"home-hero-after":h(()=>[c(a.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":h(()=>[c(a.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":h(()=>[c(a.$slots,"home-features-after",{},void 0,!0)]),_:3})):r(n).layout&&r(n).layout!=="doc"?(s(),_(E(r(n).layout),{key:3})):(s(),_(dn,{key:4},{"doc-top":h(()=>[c(a.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":h(()=>[c(a.$slots,"doc-bottom",{},void 0,!0)]),"doc-footer-before":h(()=>[c(a.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":h(()=>[c(a.$slots,"doc-before",{},void 0,!0)]),"doc-after":h(()=>[c(a.$slots,"doc-after",{},void 0,!0)]),"aside-top":h(()=>[c(a.$slots,"aside-top",{},void 0,!0)]),"aside-outline-before":h(()=>[c(a.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":h(()=>[c(a.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":h(()=>[c(a.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":h(()=>[c(a.$slots,"aside-ads-after",{},void 0,!0)]),"aside-bottom":h(()=>[c(a.$slots,"aside-bottom",{},void 0,!0)]),_:3}))],2))}}),Qn=g(Yn,[["__scopeId","data-v-0d61d52e"]]),Zn={class:"container"},eo=["innerHTML"],to=["innerHTML"],no=p({__name:"VPFooter",setup(e){const{theme:t,frontmatter:n}=L(),{hasSidebar:o}=F();return(a,i)=>r(t).footer&&r(n).footer!==!1?(s(),u("footer",{key:0,class:N(["VPFooter",{"has-sidebar":r(o)}])},[d("div",Zn,[r(t).footer.message?(s(),u("p",{key:0,class:"message",innerHTML:r(t).footer.message},null,8,eo)):m("",!0),r(t).footer.copyright?(s(),u("p",{key:1,class:"copyright",innerHTML:r(t).footer.copyright},null,8,to)):m("",!0)])],2)):m("",!0)}}),oo=g(no,[["__scopeId","data-v-76c562a4"]]);function ao(){const{theme:e,frontmatter:t}=L(),n=Te([]),o=y(()=>n.value.length>0);return Q(()=>{n.value=be(t.value.outline??e.value.outline)}),{headers:n,hasLocalNav:o}}const so={class:"menu-text"},ro={class:"header"},io={class:"outline"},lo=p({__name:"VPLocalNavOutlineDropdown",props:{headers:{},navHeight:{}},setup(e){const t=e,{theme:n}=L(),o=S(!1),a=S(0),i=S(),l=S();function v(b){var P;(P=i.value)!=null&&P.contains(b.target)||(o.value=!1)}O(o,b=>{if(b){document.addEventListener("click",v);return}document.removeEventListener("click",v)}),le("Escape",()=>{o.value=!1}),Q(()=>{o.value=!1});function f(){o.value=!o.value,a.value=window.innerHeight+Math.min(window.scrollY-t.navHeight,0)}function $(b){b.target.classList.contains("outline-link")&&(l.value&&(l.value.style.transition="none"),we(()=>{o.value=!1}))}function V(){o.value=!1,window.scrollTo({top:0,left:0,behavior:"smooth"})}return(b,P)=>(s(),u("div",{class:"VPLocalNavOutlineDropdown",style:Me({"--vp-vh":a.value+"px"}),ref_key:"main",ref:i},[e.headers.length>0?(s(),u("button",{key:0,onClick:f,class:N({open:o.value})},[d("span",so,M(r(He)(r(n))),1),P[0]||(P[0]=d("span",{class:"vpi-chevron-right icon"},null,-1))],2)):(s(),u("button",{key:1,onClick:V},M(r(n).returnToTopLabel||"Return to top"),1)),k(he,{name:"flyout"},{default:h(()=>[o.value?(s(),u("div",{key:0,ref_key:"items",ref:l,class:"items",onClick:$},[d("div",ro,[d("a",{class:"top-link",href:"#",onClick:V},M(r(n).returnToTopLabel||"Return to top"),1)]),d("div",io,[k(Ee,{headers:e.headers},null,8,["headers"])])],512)):m("",!0)]),_:1})],4))}}),co=g(lo,[["__scopeId","data-v-6ce9e49d"]]),uo={class:"container"},vo=["aria-expanded"],fo={class:"menu-text"},ho=p({__name:"VPLocalNav",props:{open:{type:Boolean}},emits:["open-menu"],setup(e){const{theme:t,frontmatter:n}=L(),{hasSidebar:o}=F(),{headers:a}=ao(),{y:i}=xe(),l=S(0);G(()=>{l.value=parseInt(getComputedStyle(document.documentElement).getPropertyValue("--vp-nav-height"))}),Q(()=>{a.value=be(n.value.outline??t.value.outline)});const v=y(()=>a.value.length===0),f=y(()=>v.value&&!o.value),$=y(()=>({VPLocalNav:!0,"has-sidebar":o.value,empty:v.value,fixed:f.value}));return(V,b)=>r(n).layout!=="home"&&(!f.value||r(i)>=l.value)?(s(),u("div",{key:0,class:N($.value)},[d("div",uo,[r(o)?(s(),u("button",{key:0,class:"menu","aria-expanded":e.open,"aria-controls":"VPSidebarNav",onClick:b[0]||(b[0]=P=>V.$emit("open-menu"))},[b[1]||(b[1]=d("span",{class:"vpi-align-left menu-icon"},null,-1)),d("span",fo,M(r(t).sidebarMenuLabel||"Menu"),1)],8,vo)):m("",!0),k(co,{headers:r(a),navHeight:l.value},null,8,["headers","navHeight"])])],2)):m("",!0)}}),mo=g(ho,[["__scopeId","data-v-948a2bb1"]]);function po(){const e=S(!1);function t(){e.value=!0,window.addEventListener("resize",a)}function n(){e.value=!1,window.removeEventListener("resize",a)}function o(){e.value?n():t()}function a(){window.outerWidth>=768&&n()}const i=Z();return O(()=>i.path,n),{isScreenOpen:e,openScreen:t,closeScreen:n,toggleScreen:o}}const ko={},_o={class:"VPSwitch",type:"button",role:"switch"},bo={class:"check"},go={key:0,class:"icon"};function $o(e,t){return s(),u("button",_o,[d("span",bo,[e.$slots.default?(s(),u("span",go,[c(e.$slots,"default",{},void 0,!0)])):m("",!0)])])}const yo=g(ko,[["render",$o],["__scopeId","data-v-9addbbf0"]]),Po=p({__name:"VPSwitchAppearance",setup(e){const{isDark:t,theme:n}=L(),o=ee("toggle-appearance",()=>{t.value=!t.value}),a=S("");return ke(()=>{a.value=t.value?n.value.lightModeSwitchTitle||"Switch to light theme":n.value.darkModeSwitchTitle||"Switch to dark theme"}),(i,l)=>(s(),_(yo,{title:a.value,class:"VPSwitchAppearance","aria-checked":r(t),onClick:r(o)},{default:h(()=>[...l[0]||(l[0]=[d("span",{class:"vpi-sun sun"},null,-1),d("span",{class:"vpi-moon moon"},null,-1)])]),_:1},8,["title","aria-checked","onClick"]))}}),ge=g(Po,[["__scopeId","data-v-0be14ed2"]]),Lo={key:0,class:"VPNavBarAppearance"},Vo=p({__name:"VPNavBarAppearance",setup(e){const{site:t}=L();return(n,o)=>r(t).appearance&&r(t).appearance!=="force-dark"&&r(t).appearance!=="force-auto"?(s(),u("div",Lo,[k(ge)])):m("",!0)}}),So=g(Vo,[["__scopeId","data-v-286d34df"]]),$e=S();let Be=!1,se=0;function To(e){const t=S(!1);if(te){!Be&&No(),se++;const n=O($e,o=>{var a,i,l;o===e.el.value||(a=e.el.value)!=null&&a.contains(o)?(t.value=!0,(i=e.onFocus)==null||i.call(e)):(t.value=!1,(l=e.onBlur)==null||l.call(e))});pe(()=>{n(),se--,se||Mo()})}return Re(t)}function No(){document.addEventListener("focusin",Oe),Be=!0,$e.value=document.activeElement}function Mo(){document.removeEventListener("focusin",Oe)}function Oe(){$e.value=document.activeElement}const wo={class:"VPMenuLink"},xo=["innerHTML"],Io=p({__name:"VPMenuLink",props:{item:{}},setup(e){const{page:t}=L();return(n,o)=>(s(),u("div",wo,[k(B,{class:N({active:r(z)(r(t).relativePath,e.item.activeMatch||e.item.link,!!e.item.activeMatch)}),href:e.item.link,target:e.item.target,rel:e.item.rel,"no-icon":e.item.noIcon},{default:h(()=>[d("span",{innerHTML:e.item.text},null,8,xo)]),_:1},8,["class","href","target","rel","no-icon"])]))}}),ne=g(Io,[["__scopeId","data-v-76678a4b"]]),Ao={class:"VPMenuGroup"},Co={key:0,class:"title"},Ho=p({__name:"VPMenuGroup",props:{text:{},items:{}},setup(e){return(t,n)=>(s(),u("div",Ao,[e.text?(s(),u("p",Co,M(e.text),1)):m("",!0),(s(!0),u(w,null,A(e.items,o=>(s(),u(w,null,["link"in o?(s(),_(ne,{key:0,item:o},null,8,["item"])):m("",!0)],64))),256))]))}}),Eo=g(Ho,[["__scopeId","data-v-f4306f77"]]),Bo={class:"VPMenu"},Oo={key:0,class:"items"},Fo=p({__name:"VPMenu",props:{items:{}},setup(e){return(t,n)=>(s(),u("div",Bo,[e.items?(s(),u("div",Oo,[(s(!0),u(w,null,A(e.items,o=>(s(),u(w,{key:JSON.stringify(o)},["link"in o?(s(),_(ne,{key:0,item:o},null,8,["item"])):"component"in o?(s(),_(E(o.component),U({key:1,ref_for:!0},o.props),null,16)):(s(),_(Eo,{key:2,text:o.text,items:o.items},null,8,["text","items"]))],64))),128))])):m("",!0),c(t.$slots,"default",{},void 0,!0)]))}}),Do=g(Fo,[["__scopeId","data-v-00f4385c"]]),Uo=["aria-expanded","aria-label"],Go={key:0,class:"text"},jo=["innerHTML"],zo={key:1,class:"vpi-more-horizontal icon"},Wo={class:"menu"},Ko=p({__name:"VPFlyout",props:{icon:{},button:{},label:{},items:{}},setup(e){const t=S(!1),n=S();To({el:n,onBlur:o});function o(){t.value=!1}return(a,i)=>(s(),u("div",{class:"VPFlyout",ref_key:"el",ref:n,onMouseenter:i[1]||(i[1]=l=>t.value=!0),onMouseleave:i[2]||(i[2]=l=>t.value=!1)},[d("button",{type:"button",class:"button","aria-haspopup":"true","aria-expanded":t.value,"aria-label":e.label,onClick:i[0]||(i[0]=l=>t.value=!t.value)},[e.button||e.icon?(s(),u("span",Go,[e.icon?(s(),u("span",{key:0,class:N([e.icon,"option-icon"])},null,2)):m("",!0),e.button?(s(),u("span",{key:1,innerHTML:e.button},null,8,jo)):m("",!0),i[3]||(i[3]=d("span",{class:"vpi-chevron-down text-icon"},null,-1))])):(s(),u("span",zo))],8,Uo),d("div",Wo,[k(Do,{items:e.items},{default:h(()=>[c(a.$slots,"default",{},void 0,!0)]),_:3},8,["items"])])],544))}}),ye=g(Ko,[["__scopeId","data-v-4548827a"]]),Ro=["href","aria-label","innerHTML"],qo=p({__name:"VPSocialLink",props:{icon:{},link:{},ariaLabel:{}},setup(e){const t=e,n=S();G(async()=>{var i;await we();const a=(i=n.value)==null?void 0:i.children[0];a instanceof HTMLElement&&a.className.startsWith("vpi-social-")&&(getComputedStyle(a).maskImage||getComputedStyle(a).webkitMaskImage)==="none"&&a.style.setProperty("--icon",`url('https://api.iconify.design/simple-icons/${t.icon}.svg')`)});const o=y(()=>typeof t.icon=="object"?t.icon.svg:`<span class="vpi-social-${t.icon}"></span>`);return(a,i)=>(s(),u("a",{ref_key:"el",ref:n,class:"VPSocialLink no-icon",href:e.link,"aria-label":e.ariaLabel??(typeof e.icon=="string"?e.icon:""),target:"_blank",rel:"noopener",innerHTML:o.value},null,8,Ro))}}),Jo=g(qo,[["__scopeId","data-v-6b445de0"]]),Xo={class:"VPSocialLinks"},Yo=p({__name:"VPSocialLinks",props:{links:{}},setup(e){return(t,n)=>(s(),u("div",Xo,[(s(!0),u(w,null,A(e.links,({link:o,icon:a,ariaLabel:i})=>(s(),_(Jo,{key:o,icon:a,link:o,ariaLabel:i},null,8,["icon","link","ariaLabel"]))),128))]))}}),Pe=g(Yo,[["__scopeId","data-v-1ef06a68"]]),Qo={key:0,class:"group translations"},Zo={class:"trans-title"},ea={key:1,class:"group"},ta={class:"item appearance"},na={class:"label"},oa={class:"appearance-action"},aa={key:2,class:"group"},sa={class:"item social-links"},ra=p({__name:"VPNavBarExtra",setup(e){const{site:t,theme:n}=L(),{localeLinks:o,currentLang:a}=R({correspondingLink:!0}),i=y(()=>o.value.length&&a.value.label||t.value.appearance||n.value.socialLinks);return(l,v)=>i.value?(s(),_(ye,{key:0,class:"VPNavBarExtra",label:"extra navigation"},{default:h(()=>[r(o).length&&r(a).label?(s(),u("div",Qo,[d("p",Zo,M(r(a).label),1),(s(!0),u(w,null,A(r(o),f=>(s(),_(ne,{key:f.link,item:f},null,8,["item"]))),128))])):m("",!0),r(t).appearance&&r(t).appearance!=="force-dark"&&r(t).appearance!=="force-auto"?(s(),u("div",ea,[d("div",ta,[d("p",na,M(r(n).darkModeSwitchLabel||"Appearance"),1),d("div",oa,[k(ge)])])])):m("",!0),r(n).socialLinks?(s(),u("div",aa,[d("div",sa,[k(Pe,{class:"social-links-list",links:r(n).socialLinks},null,8,["links"])])])):m("",!0)]),_:1})):m("",!0)}}),ia=g(ra,[["__scopeId","data-v-0971638d"]]),la=["aria-expanded"],ca=p({__name:"VPNavBarHamburger",props:{active:{type:Boolean}},emits:["click"],setup(e){return(t,n)=>(s(),u("button",{type:"button",class:N(["VPNavBarHamburger",{active:e.active}]),"aria-label":"mobile navigation","aria-expanded":e.active,"aria-controls":"VPNavScreen",onClick:n[0]||(n[0]=o=>t.$emit("click"))},[...n[1]||(n[1]=[d("span",{class:"container"},[d("span",{class:"top"}),d("span",{class:"middle"}),d("span",{class:"bottom"})],-1)])],10,la))}}),ua=g(ca,[["__scopeId","data-v-888db669"]]),da=["innerHTML"],va=p({__name:"VPNavBarMenuLink",props:{item:{}},setup(e){const{page:t}=L();return(n,o)=>(s(),_(B,{class:N({VPNavBarMenuLink:!0,active:r(z)(r(t).relativePath,e.item.activeMatch||e.item.link,!!e.item.activeMatch)}),href:e.item.link,target:e.item.target,rel:e.item.rel,"no-icon":e.item.noIcon,tabindex:"0"},{default:h(()=>[d("span",{innerHTML:e.item.text},null,8,da)]),_:1},8,["class","href","target","rel","no-icon"]))}}),fa=g(va,[["__scopeId","data-v-8381090b"]]),ha=p({__name:"VPNavBarMenuGroup",props:{item:{}},setup(e){const t=e,{page:n}=L(),o=i=>"component"in i?!1:"link"in i?z(n.value.relativePath,i.link,!!t.item.activeMatch):i.items.some(o),a=y(()=>o(t.item));return(i,l)=>(s(),_(ye,{class:N({VPNavBarMenuGroup:!0,active:r(z)(r(n).relativePath,e.item.activeMatch,!!e.item.activeMatch)||a.value}),button:e.item.text,items:e.item.items},null,8,["class","button","items"]))}}),ma={key:0,"aria-labelledby":"main-nav-aria-label",class:"VPNavBarMenu"},pa=p({__name:"VPNavBarMenu",setup(e){const{theme:t}=L();return(n,o)=>r(t).nav?(s(),u("nav",ma,[o[0]||(o[0]=d("span",{id:"main-nav-aria-label",class:"visually-hidden"}," Main Navigation ",-1)),(s(!0),u(w,null,A(r(t).nav,a=>(s(),u(w,{key:JSON.stringify(a)},["link"in a?(s(),_(fa,{key:0,item:a},null,8,["item"])):"component"in a?(s(),_(E(a.component),U({key:1,ref_for:!0},a.props),null,16)):(s(),_(ha,{key:2,item:a},null,8,["item"]))],64))),128))])):m("",!0)}}),ka=g(pa,[["__scopeId","data-v-c9551fc0"]]);function _a(e){const{localeIndex:t,theme:n}=L();function o(a){var x,I,C;const i=a.split("."),l=(x=n.value.search)==null?void 0:x.options,v=l&&typeof l=="object",f=v&&((C=(I=l.locales)==null?void 0:I[t.value])==null?void 0:C.translations)||null,$=v&&l.translations||null;let V=f,b=$,P=e;const T=i.pop();for(const H of i){let D=null;const K=P==null?void 0:P[H];K&&(D=P=K);const oe=b==null?void 0:b[H];oe&&(D=b=oe);const ae=V==null?void 0:V[H];ae&&(D=V=ae),K||(P=D),oe||(b=D),ae||(V=D)}return(V==null?void 0:V[T])??(b==null?void 0:b[T])??(P==null?void 0:P[T])??""}return o}const ba=["aria-label"],ga={class:"DocSearch-Button-Container"},$a={class:"DocSearch-Button-Placeholder"},Le=p({__name:"VPNavBarSearchButton",setup(e){const n=_a({button:{buttonText:"Search",buttonAriaLabel:"Search"}});return(o,a)=>(s(),u("button",{type:"button",class:"DocSearch DocSearch-Button","aria-label":r(n)("button.buttonAriaLabel")},[d("span",ga,[a[0]||(a[0]=d("span",{class:"vp-icon DocSearch-Search-Icon"},null,-1)),d("span",$a,M(r(n)("button.buttonText")),1)]),a[1]||(a[1]=d("span",{class:"DocSearch-Button-Keys"},[d("kbd",{class:"DocSearch-Button-Key"}),d("kbd",{class:"DocSearch-Button-Key"},"K")],-1))],8,ba))}}),ya={class:"VPNavBarSearch"},Pa={id:"local-search"},La={key:1,id:"docsearch"},Va=p({__name:"VPNavBarSearch",setup(e){const t=qe(()=>Je(()=>import("./VPLocalSearchBox.Bi9Y__e6.js"),__vite__mapDeps([0,1]))),n=()=>null,{theme:o}=L(),a=S(!1),i=S(!1);G(()=>{});function l(){a.value||(a.value=!0,setTimeout(v,16))}function v(){const b=new Event("keydown");b.key="k",b.metaKey=!0,window.dispatchEvent(b),setTimeout(()=>{document.querySelector(".DocSearch-Modal")||v()},16)}function f(b){const P=b.target,T=P.tagName;return P.isContentEditable||T==="INPUT"||T==="SELECT"||T==="TEXTAREA"}const $=S(!1);le("k",b=>{(b.ctrlKey||b.metaKey)&&(b.preventDefault(),$.value=!0)}),le("/",b=>{f(b)||(b.preventDefault(),$.value=!0)});const V="local";return(b,P)=>{var T;return s(),u("div",ya,[r(V)==="local"?(s(),u(w,{key:0},[$.value?(s(),_(r(t),{key:0,onClose:P[0]||(P[0]=x=>$.value=!1)})):m("",!0),d("div",Pa,[k(Le,{onClick:P[1]||(P[1]=x=>$.value=!0)})])],64)):r(V)==="algolia"?(s(),u(w,{key:1},[a.value?(s(),_(r(n),{key:0,algolia:((T=r(o).search)==null?void 0:T.options)??r(o).algolia,onVnodeBeforeMount:P[2]||(P[2]=x=>i.value=!0)},null,8,["algolia"])):m("",!0),i.value?m("",!0):(s(),u("div",La,[k(Le,{onClick:l})]))],64)):m("",!0)])}}}),Sa=p({__name:"VPNavBarSocialLinks",setup(e){const{theme:t}=L();return(n,o)=>r(t).socialLinks?(s(),_(Pe,{key:0,class:"VPNavBarSocialLinks",links:r(t).socialLinks},null,8,["links"])):m("",!0)}}),Ta=g(Sa,[["__scopeId","data-v-33d7e6dd"]]),Na=["href","rel","target"],Ma=["innerHTML"],wa={key:2},xa=p({__name:"VPNavBarTitle",setup(e){const{site:t,theme:n}=L(),{hasSidebar:o}=F(),{currentLang:a}=R(),i=y(()=>{var f;return typeof n.value.logoLink=="string"?n.value.logoLink:(f=n.value.logoLink)==null?void 0:f.link}),l=y(()=>{var f;return typeof n.value.logoLink=="string"||(f=n.value.logoLink)==null?void 0:f.rel}),v=y(()=>{var f;return typeof n.value.logoLink=="string"||(f=n.value.logoLink)==null?void 0:f.target});return(f,$)=>(s(),u("div",{class:N(["VPNavBarTitle",{"has-sidebar":r(o)}])},[d("a",{class:"title",href:i.value??r(_e)(r(a).link),rel:l.value,target:v.value},[c(f.$slots,"nav-bar-title-before",{},void 0,!0),r(n).logo?(s(),_(X,{key:0,class:"logo",image:r(n).logo},null,8,["image"])):m("",!0),r(n).siteTitle?(s(),u("span",{key:1,innerHTML:r(n).siteTitle},null,8,Ma)):r(n).siteTitle===void 0?(s(),u("span",wa,M(r(t).title),1)):m("",!0),c(f.$slots,"nav-bar-title-after",{},void 0,!0)],8,Na)],2))}}),Ia=g(xa,[["__scopeId","data-v-74c2a9a9"]]),Aa={class:"items"},Ca={class:"title"},Ha=p({__name:"VPNavBarTranslations",setup(e){const{theme:t}=L(),{localeLinks:n,currentLang:o}=R({correspondingLink:!0});return(a,i)=>r(n).length&&r(o).label?(s(),_(ye,{key:0,class:"VPNavBarTranslations",icon:"vpi-languages",label:r(t).langMenuLabel||"Change language"},{default:h(()=>[d("div",Aa,[d("p",Ca,M(r(o).label),1),(s(!0),u(w,null,A(r(n),l=>(s(),_(ne,{key:l.link,item:l},null,8,["item"]))),128))])]),_:1},8,["label"])):m("",!0)}}),Ea=g(Ha,[["__scopeId","data-v-7a47cfd4"]]),Ba={class:"wrapper"},Oa={class:"container"},Fa={class:"title"},Da={class:"content"},Ua={class:"content-body"},Ga=p({__name:"VPNavBar",props:{isScreenOpen:{type:Boolean}},emits:["toggle-screen"],setup(e){const t=e,{y:n}=xe(),{hasSidebar:o}=F(),{frontmatter:a}=L(),i=S({});return ke(()=>{i.value={"has-sidebar":o.value,home:a.value.layout==="home",top:n.value===0,"screen-open":t.isScreenOpen}}),(l,v)=>(s(),u("div",{class:N(["VPNavBar",i.value])},[d("div",Ba,[d("div",Oa,[d("div",Fa,[k(Ia,null,{"nav-bar-title-before":h(()=>[c(l.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":h(()=>[c(l.$slots,"nav-bar-title-after",{},void 0,!0)]),_:3})]),d("div",Da,[d("div",Ua,[c(l.$slots,"nav-bar-content-before",{},void 0,!0),k(Va,{class:"search"}),k(ka,{class:"menu"}),k(Ea,{class:"translations"}),k(So,{class:"appearance"}),k(Ta,{class:"social-links"}),k(ia,{class:"extra"}),c(l.$slots,"nav-bar-content-after",{},void 0,!0),k(ua,{class:"hamburger",active:e.isScreenOpen,onClick:v[0]||(v[0]=f=>l.$emit("toggle-screen"))},null,8,["active"])])])])]),v[1]||(v[1]=d("div",{class:"divider"},[d("div",{class:"divider-line"})],-1))],2))}}),ja=g(Ga,[["__scopeId","data-v-5a9cffff"]]),za={key:0,class:"VPNavScreenAppearance"},Wa={class:"text"},Ka=p({__name:"VPNavScreenAppearance",setup(e){const{site:t,theme:n}=L();return(o,a)=>r(t).appearance&&r(t).appearance!=="force-dark"&&r(t).appearance!=="force-auto"?(s(),u("div",za,[d("p",Wa,M(r(n).darkModeSwitchLabel||"Appearance"),1),k(ge)])):m("",!0)}}),Ra=g(Ka,[["__scopeId","data-v-6a2323f9"]]),qa=["innerHTML"],Ja=p({__name:"VPNavScreenMenuLink",props:{item:{}},setup(e){const t=ee("close-screen");return(n,o)=>(s(),_(B,{class:"VPNavScreenMenuLink",href:e.item.link,target:e.item.target,rel:e.item.rel,"no-icon":e.item.noIcon,onClick:r(t)},{default:h(()=>[d("span",{innerHTML:e.item.text},null,8,qa)]),_:1},8,["href","target","rel","no-icon","onClick"]))}}),Xa=g(Ja,[["__scopeId","data-v-49e05f69"]]),Ya=["innerHTML"],Qa=p({__name:"VPNavScreenMenuGroupLink",props:{item:{}},setup(e){const t=ee("close-screen");return(n,o)=>(s(),_(B,{class:"VPNavScreenMenuGroupLink",href:e.item.link,target:e.item.target,rel:e.item.rel,"no-icon":e.item.noIcon,onClick:r(t)},{default:h(()=>[d("span",{innerHTML:e.item.text},null,8,Ya)]),_:1},8,["href","target","rel","no-icon","onClick"]))}}),Fe=g(Qa,[["__scopeId","data-v-498377cf"]]),Za={class:"VPNavScreenMenuGroupSection"},es={key:0,class:"title"},ts=p({__name:"VPNavScreenMenuGroupSection",props:{text:{},items:{}},setup(e){return(t,n)=>(s(),u("div",Za,[e.text?(s(),u("p",es,M(e.text),1)):m("",!0),(s(!0),u(w,null,A(e.items,o=>(s(),_(Fe,{key:o.text,item:o},null,8,["item"]))),128))]))}}),ns=g(ts,[["__scopeId","data-v-b128e013"]]),os=["aria-controls","aria-expanded"],as=["innerHTML"],ss=["id"],rs={key:0,class:"item"},is={key:1,class:"item"},ls={key:2,class:"group"},cs=p({__name:"VPNavScreenMenuGroup",props:{text:{},items:{}},setup(e){const t=e,n=S(!1),o=y(()=>`NavScreenGroup-${t.text.replace(" ","-").toLowerCase()}`);function a(){n.value=!n.value}return(i,l)=>(s(),u("div",{class:N(["VPNavScreenMenuGroup",{open:n.value}])},[d("button",{class:"button","aria-controls":o.value,"aria-expanded":n.value,onClick:a},[d("span",{class:"button-text",innerHTML:e.text},null,8,as),l[0]||(l[0]=d("span",{class:"vpi-plus button-icon"},null,-1))],8,os),d("div",{id:o.value,class:"items"},[(s(!0),u(w,null,A(e.items,v=>(s(),u(w,{key:JSON.stringify(v)},["link"in v?(s(),u("div",rs,[k(Fe,{item:v},null,8,["item"])])):"component"in v?(s(),u("div",is,[(s(),_(E(v.component),U({ref_for:!0},v.props,{"screen-menu":""}),null,16))])):(s(),u("div",ls,[k(ns,{text:v.text,items:v.items},null,8,["text","items"])]))],64))),128))],8,ss)],2))}}),us=g(cs,[["__scopeId","data-v-64ac07c5"]]),ds={key:0,class:"VPNavScreenMenu"},vs=p({__name:"VPNavScreenMenu",setup(e){const{theme:t}=L();return(n,o)=>r(t).nav?(s(),u("nav",ds,[(s(!0),u(w,null,A(r(t).nav,a=>(s(),u(w,{key:JSON.stringify(a)},["link"in a?(s(),_(Xa,{key:0,item:a},null,8,["item"])):"component"in a?(s(),_(E(a.component),U({key:1,ref_for:!0},a.props,{"screen-menu":""}),null,16)):(s(),_(us,{key:2,text:a.text||"",items:a.items},null,8,["text","items"]))],64))),128))])):m("",!0)}}),fs=p({__name:"VPNavScreenSocialLinks",setup(e){const{theme:t}=L();return(n,o)=>r(t).socialLinks?(s(),_(Pe,{key:0,class:"VPNavScreenSocialLinks",links:r(t).socialLinks},null,8,["links"])):m("",!0)}}),hs={class:"list"},ms=p({__name:"VPNavScreenTranslations",setup(e){const{localeLinks:t,currentLang:n}=R({correspondingLink:!0}),o=S(!1);function a(){o.value=!o.value}return(i,l)=>r(t).length&&r(n).label?(s(),u("div",{key:0,class:N(["VPNavScreenTranslations",{open:o.value}])},[d("button",{class:"title",onClick:a},[l[0]||(l[0]=d("span",{class:"vpi-languages icon lang"},null,-1)),j(" "+M(r(n).label)+" ",1),l[1]||(l[1]=d("span",{class:"vpi-chevron-down icon chevron"},null,-1))]),d("ul",hs,[(s(!0),u(w,null,A(r(t),v=>(s(),u("li",{key:v.link,class:"item"},[k(B,{class:"link",href:v.link},{default:h(()=>[j(M(v.text),1)]),_:2},1032,["href"])]))),128))])],2)):m("",!0)}}),ps=g(ms,[["__scopeId","data-v-83363e92"]]),ks={class:"container"},_s=p({__name:"VPNavScreen",props:{open:{type:Boolean}},setup(e){const t=S(null),n=Ie(te?document.body:null);return(o,a)=>(s(),_(he,{name:"fade",onEnter:a[0]||(a[0]=i=>n.value=!0),onAfterLeave:a[1]||(a[1]=i=>n.value=!1)},{default:h(()=>[e.open?(s(),u("div",{key:0,class:"VPNavScreen",ref_key:"screen",ref:t,id:"VPNavScreen"},[d("div",ks,[c(o.$slots,"nav-screen-content-before",{},void 0,!0),k(vs,{class:"menu"}),k(ps,{class:"translations"}),k(Ra,{class:"appearance"}),k(fs,{class:"social-links"}),c(o.$slots,"nav-screen-content-after",{},void 0,!0)])],512)):m("",!0)]),_:3}))}}),bs=g(_s,[["__scopeId","data-v-cf9782ac"]]),gs={key:0,class:"VPNav"},$s=p({__name:"VPNav",setup(e){const{isScreenOpen:t,closeScreen:n,toggleScreen:o}=po(),{frontmatter:a}=L(),i=y(()=>a.value.navbar!==!1);return Ae("close-screen",n),Y(()=>{te&&document.documentElement.classList.toggle("hide-nav",!i.value)}),(l,v)=>i.value?(s(),u("header",gs,[k(ja,{"is-screen-open":r(t),onToggleScreen:r(o)},{"nav-bar-title-before":h(()=>[c(l.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":h(()=>[c(l.$slots,"nav-bar-title-after",{},void 0,!0)]),"nav-bar-content-before":h(()=>[c(l.$slots,"nav-bar-content-before",{},void 0,!0)]),"nav-bar-content-after":h(()=>[c(l.$slots,"nav-bar-content-after",{},void 0,!0)]),_:3},8,["is-screen-open","onToggleScreen"]),k(bs,{open:r(t)},{"nav-screen-content-before":h(()=>[c(l.$slots,"nav-screen-content-before",{},void 0,!0)]),"nav-screen-content-after":h(()=>[c(l.$slots,"nav-screen-content-after",{},void 0,!0)]),_:3},8,["open"])])):m("",!0)}}),ys=g($s,[["__scopeId","data-v-bd330aa5"]]),Ps=["role","tabindex"],Ls={key:1,class:"items"},Vs=p({__name:"VPSidebarItem",props:{item:{},depth:{}},setup(e){const t=e,{collapsed:n,collapsible:o,isLink:a,isActiveLink:i,hasActiveLink:l,hasChildren:v,toggle:f}=_t(y(()=>t.item)),$=y(()=>v.value?"section":"div"),V=y(()=>a.value?"a":"div"),b=y(()=>v.value?t.depth+2===7?"p":`h${t.depth+2}`:"p"),P=y(()=>a.value?void 0:"button"),T=y(()=>[[`level-${t.depth}`],{collapsible:o.value},{collapsed:n.value},{"is-link":a.value},{"is-active":i.value},{"has-active":l.value}]);function x(C){"key"in C&&C.key!=="Enter"||!t.item.link&&f()}function I(){t.item.link&&f()}return(C,H)=>{const D=W("VPSidebarItem",!0);return s(),_(E($.value),{class:N(["VPSidebarItem",T.value])},{default:h(()=>[e.item.text?(s(),u("div",U({key:0,class:"item",role:P.value},Xe(e.item.items?{click:x,keydown:x}:{},!0),{tabindex:e.item.items&&0}),[H[1]||(H[1]=d("div",{class:"indicator"},null,-1)),e.item.link?(s(),_(B,{key:0,tag:V.value,class:"link",href:e.item.link,rel:e.item.rel,target:e.item.target},{default:h(()=>[(s(),_(E(b.value),{class:"text",innerHTML:e.item.text},null,8,["innerHTML"]))]),_:1},8,["tag","href","rel","target"])):(s(),_(E(b.value),{key:1,class:"text",innerHTML:e.item.text},null,8,["innerHTML"])),e.item.collapsed!=null&&e.item.items&&e.item.items.length?(s(),u("div",{key:2,class:"caret",role:"button","aria-label":"toggle section",onClick:I,onKeydown:Ye(I,["enter"]),tabindex:"0"},[...H[0]||(H[0]=[d("span",{class:"vpi-chevron-right caret-icon"},null,-1)])],32)):m("",!0)],16,Ps)):m("",!0),e.item.items&&e.item.items.length?(s(),u("div",Ls,[e.depth<5?(s(!0),u(w,{key:0},A(e.item.items,K=>(s(),_(D,{key:K.text,item:K,depth:e.depth+1},null,8,["item","depth"]))),128)):m("",!0)])):m("",!0)]),_:1},8,["class"])}}}),Ss=g(Vs,[["__scopeId","data-v-5197b7ef"]]),Ts=p({__name:"VPSidebarGroup",props:{items:{}},setup(e){const t=S(!0);let n=null;return G(()=>{n=setTimeout(()=>{n=null,t.value=!1},300)}),Qe(()=>{n!=null&&(clearTimeout(n),n=null)}),(o,a)=>(s(!0),u(w,null,A(e.items,i=>(s(),u("div",{key:i.text,class:N(["group",{"no-transition":t.value}])},[k(Ss,{item:i,depth:0},null,8,["item"])],2))),128))}}),Ns=g(Ts,[["__scopeId","data-v-5bec1c30"]]),Ms={class:"nav",id:"VPSidebarNav","aria-labelledby":"sidebar-aria-label",tabindex:"-1"},ws=p({__name:"VPSidebar",props:{open:{type:Boolean}},setup(e){const{sidebarGroups:t,hasSidebar:n}=F(),o=e,a=S(null),i=Ie(te?document.body:null);O([o,a],()=>{var v;o.open?(i.value=!0,(v=a.value)==null||v.focus()):i.value=!1},{immediate:!0,flush:"post"});const l=S(0);return O(t,()=>{l.value+=1},{deep:!0}),(v,f)=>r(n)?(s(),u("aside",{key:0,class:N(["VPSidebar",{open:e.open}]),ref_key:"navEl",ref:a,onClick:f[0]||(f[0]=Ze(()=>{},["stop"]))},[f[2]||(f[2]=d("div",{class:"curtain"},null,-1)),d("nav",Ms,[f[1]||(f[1]=d("span",{class:"visually-hidden",id:"sidebar-aria-label"}," Sidebar Navigation ",-1)),c(v.$slots,"sidebar-nav-before",{},void 0,!0),(s(),_(Ns,{items:r(t),key:l.value},null,8,["items"])),c(v.$slots,"sidebar-nav-after",{},void 0,!0)])],2)):m("",!0)}}),xs=g(ws,[["__scopeId","data-v-b3580139"]]),Is=p({__name:"VPSkipLink",setup(e){const{theme:t}=L(),n=Z(),o=S();O(()=>n.path,()=>o.value.focus());function a({target:i}){const l=document.getElementById(decodeURIComponent(i.hash).slice(1));if(l){const v=()=>{l.removeAttribute("tabindex"),l.removeEventListener("blur",v)};l.setAttribute("tabindex","-1"),l.addEventListener("blur",v),l.focus(),window.scrollTo(0,0)}}return(i,l)=>(s(),u(w,null,[d("span",{ref_key:"backToTop",ref:o,tabindex:"-1"},null,512),d("a",{href:"#VPContent",class:"VPSkipLink visually-hidden",onClick:a},M(r(t).skipToContentLabel||"Skip to content"),1)],64))}}),As=g(Is,[["__scopeId","data-v-932c1003"]]),Cs=p({__name:"Layout",setup(e){const{isOpen:t,open:n,close:o}=F(),a=Z();O(()=>a.path,o),kt(t,o);const{frontmatter:i}=L(),l=et(),v=y(()=>!!l["home-hero-image"]);return Ae("hero-image-slot-exists",v),(f,$)=>{const V=W("Content");return r(i).layout!==!1?(s(),u("div",{key:0,class:N(["Layout",r(i).pageClass])},[c(f.$slots,"layout-top",{},void 0,!0),k(As),k(at,{class:"backdrop",show:r(t),onClick:r(o)},null,8,["show","onClick"]),k(ys,null,{"nav-bar-title-before":h(()=>[c(f.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":h(()=>[c(f.$slots,"nav-bar-title-after",{},void 0,!0)]),"nav-bar-content-before":h(()=>[c(f.$slots,"nav-bar-content-before",{},void 0,!0)]),"nav-bar-content-after":h(()=>[c(f.$slots,"nav-bar-content-after",{},void 0,!0)]),"nav-screen-content-before":h(()=>[c(f.$slots,"nav-screen-content-before",{},void 0,!0)]),"nav-screen-content-after":h(()=>[c(f.$slots,"nav-screen-content-after",{},void 0,!0)]),_:3}),k(mo,{open:r(t),onOpenMenu:r(n)},null,8,["open","onOpenMenu"]),k(xs,{open:r(t)},{"sidebar-nav-before":h(()=>[c(f.$slots,"sidebar-nav-before",{},void 0,!0)]),"sidebar-nav-after":h(()=>[c(f.$slots,"sidebar-nav-after",{},void 0,!0)]),_:3},8,["open"]),k(Qn,null,{"page-top":h(()=>[c(f.$slots,"page-top",{},void 0,!0)]),"page-bottom":h(()=>[c(f.$slots,"page-bottom",{},void 0,!0)]),"not-found":h(()=>[c(f.$slots,"not-found",{},void 0,!0)]),"home-hero-before":h(()=>[c(f.$slots,"home-hero-before",{},void 0,!0)]),"home-hero-info-before":h(()=>[c(f.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":h(()=>[c(f.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":h(()=>[c(f.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":h(()=>[c(f.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":h(()=>[c(f.$slots,"home-hero-image",{},void 0,!0)]),"home-hero-after":h(()=>[c(f.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":h(()=>[c(f.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":h(()=>[c(f.$slots,"home-features-after",{},void 0,!0)]),"doc-footer-before":h(()=>[c(f.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":h(()=>[c(f.$slots,"doc-before",{},void 0,!0)]),"doc-after":h(()=>[c(f.$slots,"doc-after",{},void 0,!0)]),"doc-top":h(()=>[c(f.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":h(()=>[c(f.$slots,"doc-bottom",{},void 0,!0)]),"aside-top":h(()=>[c(f.$slots,"aside-top",{},void 0,!0)]),"aside-bottom":h(()=>[c(f.$slots,"aside-bottom",{},void 0,!0)]),"aside-outline-before":h(()=>[c(f.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":h(()=>[c(f.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":h(()=>[c(f.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":h(()=>[c(f.$slots,"aside-ads-after",{},void 0,!0)]),_:3}),k(oo),c(f.$slots,"layout-bottom",{},void 0,!0)],2)):(s(),_(V,{key:1}))}}}),Hs=g(Cs,[["__scopeId","data-v-f3720c7e"]]),q={Layout:Hs,enhanceApp:({app:e})=>{e.component("Badge",tt)}},ve="unpkg.com",De="@melt-js",re=".github.io",Es=new Set(["localhost","127.0.0.1","0.0.0.0","::1","[::1]"]),Bs=/^[a-z0-9][a-z0-9._-]*$/i,Ve=new WeakSet;function Os(e){let t;try{t=new URL(e)}catch{return null}if(t.protocol!=="https:"&&t.protocol!=="http:"||t.hostname.toLowerCase()!==ve)return null;const n=t.pathname.split("/");if(n[1]!==De)return null;const o=n[2]||"",a=o.indexOf("@"),i=a===-1?o:o.slice(0,a);if(!i||!Bs.test(i))return null;const l=n.slice(3).join("/");return{name:i,tail:l?"/"+l:"",suffix:t.search+t.hash}}function Fs(e,t){const n=Os(e);if(!n)return null;const o=t.hostname.toLowerCase();if(o===ve||o.endsWith("."+ve)||Es.has(o))return null;const a=n.tail+n.suffix;if(o.endsWith(re)){const i=o.slice(0,-re.length);return i?`${t.protocol}//${i}${re}/${n.name}${a}`:null}return`${t.origin}/${De}/${n.name}${a}`}function fe(e,t){const n=e.getAttribute("href");if(!n)return;const o=Fs(n,t);!o||o===n||e.setAttribute("href",o)}function Se(e,t){e instanceof Element&&e.tagName==="A"&&fe(e,t),e.querySelectorAll("a[href]").forEach(n=>fe(n,t))}function Ds(e={}){if(typeof window>"u"||typeof document>"u")return;const t=e.document||document,n=e.location||window.location;if(Ve.has(t))return;Ve.add(t),Se(t,n),new MutationObserver(a=>{for(const i of a){if(i.type==="attributes"){i.target instanceof Element&&fe(i.target,n);continue}i.addedNodes.forEach(l=>{l instanceof Element&&Se(l,n)})}}).observe(t.documentElement,{childList:!0,subtree:!0,attributes:!0,attributeFilter:["href"]})}const Gs={...q,enhanceApp(e){var t;(t=q.enhanceApp)==null||t.call(q,e),Ds()}};export{Gs as R,_a as c,L as u};
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import{_ as i,o as a,c as e,a2 as t}from"./chunks/framework.B8fSEufx.js";const E=JSON.parse('{"title":"原生 HTML 使用 libs 与远程组件","description":"","frontmatter":{},"headers":[],"relativePath":"guide/browser-esm.md","filePath":"guide/browser-esm.md","lastUpdated":1794754595000}'),n={name:"guide/browser-esm.md"};function l(p,s,h,d,k,o){return a(),e("div",null,[...s[0]||(s[0]=[t(`<h1 id="原生-html-使用-libs-与远程组件" tabindex="-1">原生 HTML 使用 libs 与远程组件 <a class="header-anchor" href="#原生-html-使用-libs-与远程组件" aria-label="Permalink to "原生 HTML 使用 libs 与远程组件""></a></h1><h2 id="esm-与-umd-两种浏览器交付" tabindex="-1">ESM 与 UMD 两种浏览器交付 <a class="header-anchor" href="#esm-与-umd-两种浏览器交付" aria-label="Permalink to "ESM 与 UMD 两种浏览器交付""></a></h2><p>所有有浏览器 API 的 libs/comps 额外生成主产物目录下的 <code>cdn/</code>。普通库在 <code>dist/cdn</code>,HEL 远程包在 <code>hel_dist/cdn</code>。保留原 npm 与 workspace 入口;新增公开子路径 <code>包名/cdn/*</code>。</p><table tabindex="0"><thead><tr><th>文件</th><th>用途</th></tr></thead><tbody><tr><td><code>manifest.json</code></td><td>固定版本、入口、依赖脚本及样式清单;不读取部署环境或写入私有地址</td></tr><tr><td><code>*.umd.cjs</code></td><td>普通 <code><script></code>、CommonJS 或 AMD 使用;<code>.cjs</code> 应以 JavaScript MIME 托管</td></tr><tr><td><code>vendor.umd.cjs</code></td><td>普通库的第三方依赖,只压缩,不混淆;Vue/React 继续共享宿主对象</td></tr><tr><td><code>example-umd.html</code></td><td>按依赖顺序载入框架、vendor 与 UMD,可用普通 HTTP 静态服务打开</td></tr><tr><td><code>example-esm.html</code></td><td>固定版本的 CDN 与 import map,使用原生 ESM</td></tr></tbody></table><p>普通库的 UMD 由 Rollup 原生 <code>format: 'umd'</code> 生成,多入口逐个生成,动态 import 内联。业务在最终压缩后混淆,第三方独立为 vendor。全局入口统一为 <code>window.MeltPackages['@melt-js/包名/子路径']</code>;core 另提供 <code>window.MeltCore</code>。UMD 仍需要先加载清单列明的外部依赖,不能只复制业务文件。</p><p>远程包复用已有 Rollup UMD/ESM 代理,复制到主产物目录的 <code>cdn/index.umd.cjs</code>、<code>cdn/index.esm.mjs</code>。HTML 先用 core 预加载同目录上层的 <code>hel-meta.json</code>,再读取代理;真实实现仍通过 HEL 加载并保护,不把整套组件应用重新合并为一个 UMD。其全局名称保留 <code>window[appGroupName]</code>。因此 SFTP/GitHub 只上传主目录也能提供两种 HTML 接入。</p><p><code>libs-fan</code> 的默认 npm 入口还含 Node 构建插件。浏览器使用新增 <code>@melt-js/libs-fan/browser</code>,包含 composables、hotkeys、settings、themes 和类型对应的运行 API;版权构建插件、resolver、CLI 保留 Node 入口。<code>libs-vben/design</code> 的原生 ESM 映射到 <code>design.browser.js</code>,HTML 单独加载提取的 CSS。<code>libs-bag-create</code> 是 Node 脚手架,没有浏览器 API,不生成无意义的 UMD。</p><p>每包 <code>browserFormats</code> 指定输出目录与浏览器入口。<code>hel-browser-formats</code> 只构建调用包;<code>hel-package-artifacts</code> 在产物生成完成后调用它。仓库级 <code>pnpm run browser:formats</code> 按依赖拓扑处理已有编译产物,不能替代各包自己的源码构建。使用新 CLI 前应先发布包含该命令的新 core,再发布消费包。</p><p>构建前原 <code>cdn/</code> 保留到本包 <code>.tmp/browser-format-history</code>。浏览器产物不含 source map,不为 UMD 增加 <code>src</code> 到 <code>files</code>,不改 workspace 源码解析。HTML 中的 unpkg 地址要等对应新版本实际发布后才可访问;本地验收将本次内包 URL 指向真实本地产物,框架及第三方仍访问真实 CDN。</p><p>验证命令:<code>node --test libs-core/tests/browser-formats.test.mjs</code>、<code>node scripts/verify-browser-formats.mjs</code>。浏览器日志、截图保存到 <code>.tmp/browser-formats-browser</code>。后者要求安装工作区测试依赖和 Edge;远程组件的主产物需要预先按正确验收地址构建。测试不代表所有子路径、所有交互或 HMR 都已覆盖。</p><p>不需要宿主打包器:HTML 使用 importmap 和原生 ESM;远程 libs/comps 继续由 HEL 加载实现,共享宿主 Vue/React。<code>.mjs</code> 可以最终混淆,文件扩展名不影响这一点;公开导出、属性、动态 import 和运行时协议保持可用。</p><h2 id="入口与交付" tabindex="-1">入口与交付 <a class="header-anchor" href="#入口与交付" aria-label="Permalink to "入口与交付""></a></h2><table tabindex="0"><thead><tr><th>包类型</th><th>HTML 入口</th><th>注意</th></tr></thead><tbody><tr><td>libs-core</td><td><code>dist/browser.mjs</code></td><td>保留相对依赖 <code>dist/vendor/hel-runtime.mjs</code></td></tr><tr><td>core demo 公共能力</td><td><code>dist/demo/browser.mjs</code></td><td>importmap 的 <code>@melt-js/libs-core/demo</code> 映射到这里</td></tr><tr><td>core Vue2/Vue3/React 适配层</td><td><code>dist/index.mjs</code></td><td>core、vue/react 由 importmap 提供</td></tr><tr><td>HEL 远程 libs/comps</td><td><code>hel_proxy_es/entry.js</code></td><td>先加载 <code>hel_dist/hel-meta.json</code>,再 import 代理</td></tr><tr><td>普通 libs-fan/libs-vben</td><td><code>dist</code> 中对应 ESM 子入口</td><td>外部依赖也要配置 importmap;Node 子路径除外</td></tr></tbody></table><p>npm 的 <code>files</code> 范围保持按交付用途确定,默认不增加 <code>src</code>。workspace 原源码入口保留;发布入口由 <code>publishConfig</code> 指向产物。SFTP/GitHub 默认只上传主产物目录,独立于 npm 清单;HTML 可从 npm CDN 获取代理和 core,静态服务器提供 HEL 主产物。不要为 HTML 自动扩大静态上传范围。</p><h2 id="vue-3-最小接入" tabindex="-1">Vue 3 最小接入 <a class="header-anchor" href="#vue-3-最小接入" aria-label="Permalink to "Vue 3 最小接入""></a></h2><p>下例在本次新增入口实际发布后使用。示例版本用于说明接入方式,部署前将 core、适配层和组件固定到已发布且已验收的版本;不要让多个 core 版本各自创建 HEL 缓存。</p><div class="language-html vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">html</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"><</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">script</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> src</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"https://unpkg.com/vue@3.5.45/dist/vue.global.prod.js"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">></</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">script</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">></span></span>
|
|
2
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"><</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">script</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> type</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"importmap"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">></span></span>
|
|
3
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
|
|
4
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> "imports": {</span></span>
|
|
5
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> "@melt-js/libs-core": "https://unpkg.com/@melt-js/libs-core/dist/browser.mjs",</span></span>
|
|
6
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> "hel-lib-proxy": "https://unpkg.com/@melt-js/libs-core/dist/browser.mjs",</span></span>
|
|
7
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> "@melt-js/libs-core-vue3": "https://unpkg.com/@melt-js/libs-core-vue3/dist/index.mjs",</span></span>
|
|
8
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> "@melt-js/comps-vue3-picker": "https://unpkg.com/@melt-js/comps-vue3-picker/hel_proxy_es/entry.js",</span></span>
|
|
9
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> "vue": "data:text/javascript,export default window.Vue;export const {defineComponent,h,onBeforeUnmount,onErrorCaptured,onMounted,shallowRef}=window.Vue"</span></span>
|
|
10
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
|
|
11
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span>
|
|
12
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"></</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">script</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">></span></span>
|
|
13
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"><</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">div</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> id</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"app"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">></</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">div</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">></span></span>
|
|
14
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"><</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">script</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> type</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"module"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">></span></span>
|
|
15
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { preloadHelLibs, bindVueRuntime } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> '@melt-js/libs-core'</span></span>
|
|
16
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> bindVueRuntime</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({ Vue: window.Vue })</span></span>
|
|
17
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> preloadHelLibs</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({ deps: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'@melt-js/comps-vue3-picker'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">] })</span></span>
|
|
18
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> const</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { </span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">default</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">remote</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'@melt-js/comps-vue3-picker'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
|
|
19
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> const</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">defineHelComponent</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'@melt-js/libs-core-vue3'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
|
|
20
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> Picker</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineHelComponent</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
|
|
21
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> exportName: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'CategoryPicker'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">loader</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: () </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=></span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> Promise</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">resolve</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(remote),</span></span>
|
|
22
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> })</span></span>
|
|
23
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> Vue.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">createApp</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
|
|
24
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> setup</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">() {</span></span>
|
|
25
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> value</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> Vue.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">ref</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">null</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
|
|
26
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> return</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> () </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=></span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> Vue.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">h</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(Picker, {</span></span>
|
|
27
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> modelValue: value.value,</span></span>
|
|
28
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> option: { datas: [{ key: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'native'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, title: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Native ESM'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }] },</span></span>
|
|
29
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> 'onUpdate:modelValue'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">next</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =></span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { value.value </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> next },</span></span>
|
|
30
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> })</span></span>
|
|
31
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
|
|
32
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">mount</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'#app'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
|
|
33
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"></</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">script</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">></span></span></code></pre></div><p>不要在预加载前静态 import 远程代理:ESM 会先求值静态依赖,代理可能读到尚未注册的模块。也可使用 <code>preloadHelLibs({ deps, loadApp: () => import('./app.mjs') })</code>,把代理静态导入放入 app 模块。</p><p>Vue 2 使用其生产 CDN 与 <code>export default window.Vue</code> 的 ESM 桥;React 使用 React/ReactDOM/ReactIs 的兼容版本并先调用 <code>bindReactRuntime({ React, ReactDOM, ReactIs })</code>。适配层分别映射到 core-vue2/core-react 的 <code>dist/index.mjs</code>;框架 CDN、适配层及 HEL 组件必须共享同一对象。不要给每个第三方依赖引入第二份框架。</p><p>普通模块库保留外部依赖。例如 libs-fan 的 Vue/VueUse 子入口,需要将其实际 imports 映射到兼容的浏览器 ESM,并核验共享 Vue。不会把 Node CLI、resolver、Iconify 构建工具声明为浏览器能力。</p><h2 id="样式与混淆" tabindex="-1">样式与混淆 <a class="header-anchor" href="#样式与混淆" aria-label="Permalink to "样式与混淆""></a></h2><p><code>libs-vben/design</code> 的常规入口保留 CSS import,供 Vite 等打包器使用。原生 HTML 使用 <code>dist/design.browser.js</code>(公开子路径 <code>design/browser</code>),另用 <code><link rel="stylesheet" href="…/dist/libs-vben.css"></code>。若其他模块导入 <code>@melt-js/libs-vben/design</code>,在 importmap 将这个键映射到 browser 入口。SCSS、Tailwind 源入口仍需要样式构建,不能直接当浏览器 CSS。</p><p>core、三个 core 适配层、fan 的最终 ESM 使用共享 <code>build-protected-esm.mjs</code>;vben 使用最终 bundle 混淆插件。第三方保留 external 或拆为 vendor,只压缩与 gzip。空壳 HEL 代理无需混淆,实际业务实现在 <code>hel_dist</code> 保护。<code>libs-bag-create</code> 及 Node 工具是交付例外。混淆不能保证防逆向。</p><h2 id="本地复现" tabindex="-1">本地复现 <a class="header-anchor" href="#本地复现" aria-label="Permalink to "本地复现""></a></h2><p>先构建 core、三个适配层;再构建 libs-utils 和 comps-vue3-picker,将它们的 <code>HEL_APP_HOME_PAGE</code> 指向测试服务器的准确版本路径,例如 <code>http://127.0.0.1:41881/@melt-js/libs-utils@版本/hel_dist</code>,同时设置 <code>HEL_DEPLOY_TARGET=unpkg</code>。然后运行:</p><div class="language-powershell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">powershell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">node scripts</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">/</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">verify</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">-</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">browser</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">-</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">esm.mjs</span></span></code></pre></div><p>打开日志中的 <code>/vue3.html</code>、<code>/vue2.html</code>、<code>/react.html</code>。Vue3 验证真实远程 picker;Vue2/React 验证实际远程 libs-utils 与本地计数夹具经混淆适配层交互。三个页面都使用真实 CDN,不通过 Vite、源码别名或模拟 HEL 加载。HTML 与 app 模块保存在 <code>.tmp/browser-esm-audit</code>,服务器只提供公开产物。测试地址构建保留作验收证据,正式发布须按目标地址重新构建。</p><p>本轮浏览器测试不等同于所有组件、普通库所有子路径或源码 HMR 的全覆盖测试。发布新增共享脚本时仍先发布 core,再发布消费包。</p>`,28)])])}const c=i(n,[["render",l]]);export{E as __pageData,c as default};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{_ as i,o as a,c as e,a2 as t}from"./chunks/framework.B8fSEufx.js";const E=JSON.parse('{"title":"原生 HTML 使用 libs 与远程组件","description":"","frontmatter":{},"headers":[],"relativePath":"guide/browser-esm.md","filePath":"guide/browser-esm.md","lastUpdated":1794754595000}'),n={name:"guide/browser-esm.md"};function l(p,s,h,d,k,o){return a(),e("div",null,[...s[0]||(s[0]=[t("",28)])])}const c=i(n,[["render",l]]);export{E as __pageData,c as default};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{_ as o,o as d,c as t,a2 as c}from"./chunks/framework.B8fSEufx.js";const h=JSON.parse('{"title":"核心分层与 API 收敛","description":"","frontmatter":{},"headers":[],"relativePath":"guide/core.md","filePath":"guide/core.md","lastUpdated":1794658922000}'),l={name:"guide/core.md"};function a(i,e,r,s,p,n){return d(),t("div",null,[...e[0]||(e[0]=[c('<h1 id="核心分层与-api-收敛" tabindex="-1">核心分层与 API 收敛 <a class="header-anchor" href="#核心分层与-api-收敛" aria-label="Permalink to "核心分层与 API 收敛""></a></h1><p>原则:<strong>能够统一的方法尽量都沉到 <code>libs-core</code>;确实依赖框架的部分,才进入 <code>libs-core-vue2</code>、<code>libs-core-vue3</code>、<code>libs-core-react</code>。</strong> 不在每个 demo 和 tpl 里再维护一套加载体系。</p><h2 id="分层职责" tabindex="-1">分层职责 <a class="header-anchor" href="#分层职责" aria-label="Permalink to "分层职责""></a></h2><table tabindex="0"><thead><tr><th>层级</th><th>放什么</th><th>不放什么</th></tr></thead><tbody><tr><td><code>libs-core</code></td><td>框架无关的加载、地址解析、导出校验、错误规范;可复用的请求协调等</td><td>Vue / React 组件、VNode、hooks 和具体业务清单</td></tr><tr><td><code>libs-core-vue2</code></td><td>Vue 2 生命周期、参数/事件/插槽透传、加载与错误展示</td><td>重复实现底层远程协议</td></tr><tr><td><code>libs-core-vue3</code></td><td>Vue 3 生命周期、参数/事件/插槽透传、加载与错误展示</td><td>重复实现底层远程协议</td></tr><tr><td><code>libs-core-react</code></td><td>React 生命周期、props/children/ref 透传与渲染错误边界</td><td>重复实现底层远程协议</td></tr><tr><td><code>comps-*</code> / 专题 <code>libs-*</code></td><td>公共组件与领域能力本身</td><td>面向所有应用的通用加载器</td></tr><tr><td><code>demo-*</code> / <code>tpl-*</code></td><td>选择模块、版本与加载时机,编排业务</td><td>复制一套本可共用的核心逻辑</td></tr></tbody></table><p>适配层是薄封装,不是三个互不相干的 SDK。能复用的状态逻辑与配置语义保持一致,只有组件模型和生命周期差异留在各框架里。</p><h2 id="当前已有" tabindex="-1">当前已有 <a class="header-anchor" href="#当前已有" aria-label="Permalink to "当前已有""></a></h2><p><code>libs-core</code> 是宿主侧工具箱,不维护具体应用的远程依赖清单,也不构建为远程组件。目前提供:</p><ul><li><code>loadHelLib</code>:单模块加载。</li><li><code>preloadHelLibs</code>:统一 <code>{ type, base, deps }</code>,按 libs、comps、其他三批阻塞加载。</li><li><code>resolveHelDep</code> / <code>resolveHelDeps</code>:解析包名、版本、完整 URL 和加载顺序;只解析,不下载。</li><li><code>HEL_BASES</code>:通用 unpkg 站点;GitHub 从依赖的 <code>@scope</code> 推导组织,或由调用方传入 <code>base</code>,公共库不内置组织名。</li><li><code>createHelLoader</code>:创建独立加载器,默认导出的加载方法共享同一个实例。</li><li><code>loadHelLibsSerial</code>:按顺序加载多个模块。</li><li><code>assertHelExports</code>:检查所需导出。</li><li><code>HelLoadError</code>:携带模块、地址和加载阶段等信息的统一错误。</li><li><code>isHelMetaHost</code> / <code>resolveHelHost</code>:元数据地址识别与部署地址解析。</li><li><code>loadHelComponent</code>:加载并检查指定组件导出。</li><li><code>createHelComponentResource</code>:各框架共用的加载、错误、手动重试与卸载状态协调。</li></ul><p>预加载与单包按需加载共用请求缓存和串行队列;失败请求会释放,允许显式重试。同一平台、同一组名绑定不同地址或版本会报配置错误。地址协议见<a href="./loading.html">预加载与懒加载</a>。</p><h2 id="接下来收敛什么" tabindex="-1">接下来收敛什么 <a class="header-anchor" href="#接下来收敛什么" aria-label="Permalink to "接下来收敛什么""></a></h2><ol><li>已收敛模块描述、地址、加载、请求复用与错误语义,继续保持 demo/tpl 使用同一核心。</li><li>后续若增加超时、取消和自动重试策略,优先放入 <code>libs-core</code>,不让适配层分别实现。</li><li>三个框架适配层均提供 <code>defineHelComponent</code>,组件包装、默认加载态、报错 fallback 与生命周期处理已落地。</li><li>高频场景保留普通 import;低频场景让开发者几行代码即可接入,默认行为足够完整。</li><li>用现有 demo 验证后逐步迁移 tpl,再补充正式 API 文档。</li></ol><div class="warning custom-block"><p class="custom-block-title">状态边界</p><p>三个 <code>libs-core-*</code> 框架适配包已经提供加载提示、下载/导出错误提示、渲染错误兜底与手动重试。框架运行时绑定和业务注入仍由宿主负责;超时、网络取消和自动重试未内置。适配包是普通本地依赖,无需再远程预加载。</p></div>',12)])])}const u=o(l,[["render",a]]);export{h as __pageData,u as default};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{_ as o,o as d,c as t,a2 as c}from"./chunks/framework.B8fSEufx.js";const h=JSON.parse('{"title":"核心分层与 API 收敛","description":"","frontmatter":{},"headers":[],"relativePath":"guide/core.md","filePath":"guide/core.md","lastUpdated":1794658922000}'),l={name:"guide/core.md"};function a(i,e,r,s,p,n){return d(),t("div",null,[...e[0]||(e[0]=[c("",12)])])}const u=o(l,[["render",a]]);export{h as __pageData,u as default};
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import{_ as i,o as a,c as n,a2 as t}from"./chunks/framework.B8fSEufx.js";const o=JSON.parse('{"title":"快速上手","description":"","frontmatter":{},"headers":[],"relativePath":"guide/getting-started.md","filePath":"guide/getting-started.md","lastUpdated":1794714723000}'),p={name:"guide/getting-started.md"};function l(e,s,h,k,d,r){return a(),n("div",null,[...s[0]||(s[0]=[t(`<h1 id="快速上手" tabindex="-1">快速上手 <a class="header-anchor" href="#快速上手" aria-label="Permalink to "快速上手""></a></h1><p>先体验现有模块,再按<a href="./loading.html">加载策略</a>选择自己的接入方式。预加载和按需加载都使用 <code>libs-core</code> 的统一地址协议。</p><h2 id="运行一个现有示例" tabindex="-1">运行一个现有示例 <a class="header-anchor" href="#运行一个现有示例" aria-label="Permalink to "运行一个现有示例""></a></h2><p>仓库使用 <code>pnpm@12.18.0</code>,Node.js 要求 <code>>=22.12</code>。在仓库根目录安装依赖:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">pnpm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span></span></code></pre></div><p>在两个终端分别启动 Vue 3 + Element Plus 的提供方和消费方:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># 终端一:远程组件提供方,端口 20050</span></span>
|
|
2
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">pnpm</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --filter</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> @melt-js/comps-vue3-ele</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> dev</span></span>
|
|
3
|
+
<span class="line"></span>
|
|
4
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># 终端二:宿主示例,端口 30050</span></span>
|
|
5
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">pnpm</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --filter</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> @melt-js/demo-vue3-ele</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> dev</span></span></code></pre></div><p>打开消费方页面即可查看远程组件及属性面板。该示例还会加载 <code>libs-vue3-leva</code>,需要本地属性面板时,在第三个终端执行 <code>pnpm --filter @melt-js/libs-vue3-leva run dev</code>(端口 10040)。本地远程服务需全部就绪,才能完成示例的启动预加载。</p><h2 id="高频模块-预加载后正常-import" tabindex="-1">高频模块:预加载后正常 import <a class="header-anchor" href="#高频模块-预加载后正常-import" aria-label="Permalink to "高频模块:预加载后正常 import""></a></h2><p>下面使用统一的 <code>preloadHelLibs</code> 和 <code>comps-vue3-ele</code> 导出形态说明关键时序。它适用于已安装对应代理包与依赖的宿主;样式和共享运行时仍需按所选组件包的约定配置。</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// main.ts:先绑定宿主运行时,再预加载,最后动态进入业务入口</span></span>
|
|
6
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> *</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> as</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> Vue </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> 'vue'</span></span>
|
|
7
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { bindVueRuntime } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> 'hel-micro'</span></span>
|
|
8
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { preloadHelLibs } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> '@melt-js/libs-core'</span></span>
|
|
9
|
+
<span class="line"></span>
|
|
10
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">async</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> function</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> bootstrap</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">() {</span></span>
|
|
11
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> bindVueRuntime</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({ Vue })</span></span>
|
|
12
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> preloadHelLibs</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
|
|
13
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> type: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'unpkg'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
14
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> deps: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'@melt-js/comps-vue3-ele'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">],</span></span>
|
|
15
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> loading: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// 缺少启动 loading 时显式开启;公共 API 默认关闭。</span></span>
|
|
16
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> loadApp</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: () </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=></span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'./loadApp'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">),</span></span>
|
|
17
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> })</span></span>
|
|
18
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span>
|
|
19
|
+
<span class="line"></span>
|
|
20
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bootstrap</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">().</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">catch</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">((</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">error</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=></span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
|
|
21
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> console.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">error</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'应用启动失败'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, error)</span></span>
|
|
22
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> root</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> document.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getElementById</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'app'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
|
|
23
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (root) root.textContent </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> '组件准备失败,请稍后刷新重试。'</span></span>
|
|
24
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">})</span></span></code></pre></div><div class="language-vue vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">vue</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"><!-- 由 loadApp 进入的业务组件:仍然是普通 import --></span></span>
|
|
25
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"><</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">script</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> setup</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> lang</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"ts"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">></span></span>
|
|
26
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> remote </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> '@melt-js/comps-vue3-ele'</span></span>
|
|
27
|
+
<span class="line"></span>
|
|
28
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> RemoteApp</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> remote.App</span></span>
|
|
29
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"></</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">script</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">></span></span>
|
|
30
|
+
<span class="line"></span>
|
|
31
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"><</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">template</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">></span></span>
|
|
32
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> <</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">RemoteApp</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"Melt JS"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> /></span></span>
|
|
33
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"></</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">template</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">></span></span></code></pre></div><p>远程包的 npm 入口提供轻量代理与类型,实际组件实现由远程加载。<strong>普通 import 本身不会替你预加载</strong>;不要在 <code>main.ts</code> 静态引入依赖远程代理的业务入口,否则它可能在远程模块就绪前求值。</p><p>短包名自动推导应用组名(这里是 <code>comps-vue3-ele</code>)。本地开发时把 deps 项改成 <code>{ name: 'comps-vue3-ele', host: 'http://localhost:20050', requiredExports: ['App'] }</code>。完整 URL、自定义 base、GitHub 预设与版本规则见<a href="./loading.html#地址预设与版本协议">地址协议</a>。</p><h2 id="低频模块-在使用处调用同一加载器" tabindex="-1">低频模块:在使用处调用同一加载器 <a class="header-anchor" href="#低频模块-在使用处调用同一加载器" aria-label="Permalink to "低频模块:在使用处调用同一加载器""></a></h2><p>目标体验是“声明模块与导出 → 像普通组件一样渲染”,默认具备加载态和报错 fallback,不要求开发者每次手写 loader、错误组件和重试逻辑。</p><p>直接加载模块用 <code>loadHelLib('包名@版本', { type: 'unpkg' })</code>;直接使用组件则从 <code>@melt-js/libs-core-vue2</code>、<code>@melt-js/libs-core-vue3</code> 或 <code>@melt-js/libs-core-react</code> 导入 <code>defineHelComponent({ dep: '包名', exportName: '组件名' })</code>。组件挂载时才加载,默认提供加载提示、错误展示和手动重试,共用核心地址协议、缓存与队列。参见<a href="./loading.html#低频组件懒加载">懒加载约定</a>。</p>`,17)])])}const g=i(p,[["render",l]]);export{o as __pageData,g as default};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{_ as i,o as a,c as n,a2 as t}from"./chunks/framework.B8fSEufx.js";const o=JSON.parse('{"title":"快速上手","description":"","frontmatter":{},"headers":[],"relativePath":"guide/getting-started.md","filePath":"guide/getting-started.md","lastUpdated":1794714723000}'),p={name:"guide/getting-started.md"};function l(e,s,h,k,d,r){return a(),n("div",null,[...s[0]||(s[0]=[t("",17)])])}const g=i(p,[["render",l]]);export{o as __pageData,g as default};
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import{_ as e,o as s,c as o,a2 as t}from"./chunks/framework.B8fSEufx.js";const u=JSON.parse('{"title":"项目介绍","description":"","frontmatter":{},"headers":[],"relativePath":"guide/introduction.md","filePath":"guide/introduction.md","lastUpdated":1794731419000}'),n={name:"guide/introduction.md"};function l(i,a,c,r,p,d){return s(),o("div",null,[...a[0]||(a[0]=[t(`<h1 id="项目介绍" tabindex="-1">项目介绍 <a class="header-anchor" href="#项目介绍" aria-label="Permalink to "项目介绍""></a></h1><p>Melt JS(<code>hel-components</code>)围绕一件事组织:<strong>从应用里提取公共组件,让多个应用复用同一份远程能力,同时尽量保持本地开发体验。</strong></p><p>应用负责页面、路由、状态与业务编排;公共组件和通用能力独立维护,适合远程交付的部分通过 Hel 加载。不把每个业务页面都变成远程模块,也不要求仓库内所有包都远程化。</p><h2 id="两种加载方式-一套开发体验" tabindex="-1">两种加载方式,一套开发体验 <a class="header-anchor" href="#两种加载方式-一套开发体验" aria-label="Permalink to "两种加载方式,一套开发体验""></a></h2><ul><li><strong>高频组件预加载</strong>:导航、布局、常用表单等在启动阶段准备好,业务层继续 <code>import x from '@melt-js/xxx'</code>,不必到处编写远程加载代码。</li><li><strong>低频组件懒加载</strong>:偶发弹窗、重型图表、领域扩展等在真正使用时加载,目标是几行代码即可接入,并内置加载态、报错 fallback 等默认行为。</li></ul><p>两者应复用同一套底层加载、地址解析和错误规范,不各自维护一套远程协议。预加载仍有网络成本,只是把等待前置到启动阶段;懒加载的粒度取决于远程包的拆分,不等于每个组件天然独立下载。</p><h2 id="模块如何配合" tabindex="-1">模块如何配合 <a class="header-anchor" href="#模块如何配合" aria-label="Permalink to "模块如何配合""></a></h2><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>业务应用(demo / tpl / 你的项目)</span></span>
|
|
2
|
+
<span class="line"><span> ├─ 高频:启动预加载 → 像本地包一样 import</span></span>
|
|
3
|
+
<span class="line"><span> └─ 低频:首次使用 → 框架适配层 → 默认加载态 / 错误兜底</span></span>
|
|
4
|
+
<span class="line"><span> ↓</span></span>
|
|
5
|
+
<span class="line"><span> libs-core(通用加载能力)</span></span>
|
|
6
|
+
<span class="line"><span> ↓</span></span>
|
|
7
|
+
<span class="line"><span> 远程 libs / comps(公共能力)</span></span></code></pre></div><p><code>libs-core-vue2</code>、<code>libs-core-vue3</code>、<code>libs-core-react</code> 已提供框架适配和 <code>defineHelComponent</code>。各包迁移进度与具体导出仍以实现为准,参见 <a href="./../modules/catalog/core.html">Core 专题</a>。</p><h2 id="文档怎么读" tabindex="-1">文档怎么读 <a class="header-anchor" href="#文档怎么读" aria-label="Permalink to "文档怎么读""></a></h2><ol><li><a href="./getting-started.html">快速上手</a>:先跑一个现有示例,再理解普通 import 与预加载的关系。</li><li><a href="./loading.html">预加载与懒加载</a>:决定哪些模块应该提前准备,哪些按需获取。</li><li><a href="./core.html">核心分层与 API 收敛</a>:约定能力该沉到哪里,避免重复实现。</li><li><a href="./../modules/">模块总览</a>:按职责查找现有模块;Bag 的完整专题继续由 <code>docs-bag</code> 承载。</li></ol><div class="tip custom-block"><p class="custom-block-title">当前阶段</p><p><code>libs-core</code> 已提供统一 <code>{ type, base, deps }</code> 预加载与同协议按需加载;框架 UI 适配仍待沉淀。仓库中的新入口需要随新版核心发布后才能从 registry 安装使用,不能把旧版本视作已包含这些 API。</p></div>`,12)])])}const m=e(n,[["render",l]]);export{u as __pageData,m as default};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{_ as e,o as s,c as o,a2 as t}from"./chunks/framework.B8fSEufx.js";const u=JSON.parse('{"title":"项目介绍","description":"","frontmatter":{},"headers":[],"relativePath":"guide/introduction.md","filePath":"guide/introduction.md","lastUpdated":1794731419000}'),n={name:"guide/introduction.md"};function l(i,a,c,r,p,d){return s(),o("div",null,[...a[0]||(a[0]=[t("",12)])])}const m=e(n,[["render",l]]);export{u as __pageData,m as default};
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import{_ as e,o as i,c as a,a2 as t}from"./chunks/framework.B8fSEufx.js";const k=JSON.parse('{"title":"预加载与懒加载","description":"","frontmatter":{},"headers":[],"relativePath":"guide/loading.md","filePath":"guide/loading.md","lastUpdated":1794829930000}'),d={name:"guide/loading.md"};function o(l,s,p,n,c,h){return i(),a("div",null,[...s[0]||(s[0]=[t(`<h1 id="预加载与懒加载" tabindex="-1">预加载与懒加载 <a class="header-anchor" href="#预加载与懒加载" aria-label="Permalink to "预加载与懒加载""></a></h1><p>核心不是让业务感知“远程”,而是让它用最少的接入代码获得公共组件。加载策略由宿主决定,远程细节由公共层承接。</p><h2 id="高频组件预加载" tabindex="-1">高频组件预加载 <a class="header-anchor" href="#高频组件预加载" aria-label="Permalink to "高频组件预加载""></a></h2><p>适合布局、常驻导航、首屏高频交互等启动后很快就要使用的能力。</p><ol><li>在应用入口配置远程地址和共享运行时。</li><li>预加载必要模块,确认导出已就绪。</li><li>动态进入 <code>loadApp</code> 业务入口;页面直接 <code>import { Comp } from '@melt-js/xxx'</code>。</li></ol><p>业务层不重复写加载器,统一调用 <code>preloadHelLibs({ type, base, deps })</code>。核心层先等待全部 <code>libs-*</code>,再加载 <code>comps-*</code>,最后加载其他依赖;每批内也按声明顺序串行。任一依赖失败就停止后续加载。串行沿用仓库已有的 Hel custom 注册约束。</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { preloadHelLibs } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> '@melt-js/libs-core'</span></span>
|
|
2
|
+
<span class="line"></span>
|
|
3
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> preloadHelLibs</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
|
|
4
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> type: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'custom'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
5
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> base: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'http://xx.xx.xx.xx'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
6
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> deps: [</span></span>
|
|
7
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> '@melt-js/comps-vue3'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
8
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> 'https://xxx.com/xxx-melt-js/comps-vue3-antd@1.1.1'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
9
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> 'libs-xxx@1.1.1'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
10
|
+
<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> '/@melt-js/comps-vue3'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
11
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ],</span></span>
|
|
12
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> loading: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// 预加载 loading 默认关闭,没有启动 loading 的示例显式开启。</span></span>
|
|
13
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> loadApp</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: () </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=></span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'./loadApp'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">),</span></span>
|
|
14
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">})</span></span></code></pre></div><p>示例中先加载 <code>libs-xxx@1.1.1</code>;两个 <code>comps-vue3</code> 引用只会实际加载一次。示例域名与包名用于解释协议,需要部署相应资源后才能运行。</p><h3 id="tpl-demo-统一入口" tabindex="-1">tpl / demo 统一入口 <a class="header-anchor" href="#tpl-demo-统一入口" aria-label="Permalink to "tpl / demo 统一入口""></a></h3><p>试点为 <code>demo-vue3</code>:<code>main</code> 只做共享运行时绑定、高频预加载与启动错误展示,成功后 <code>await import('./loadApp')</code>;<code>loadApp</code> 才引入 App、router 和组件包,执行实际初始化与挂载。</p><p>启动遮罩由 <code>libs-core</code> 提供,Vue 2 / Vue 3 / React 适配包转出同一 API。默认关闭;缺少 loading 的示例显式设置 <code>loading: true</code>,或 <code>loading: { type, text: '正在准备应用…', background: '#050f33', color: '#38bdf8' }</code>。已有自身 loading 的模板沿用原实现,不自动叠加公共遮罩;demo-vue3 显式开启。</p><p><code>type</code> 选择遮罩动效:<code>dots</code>(默认,三点弹跳,提取自 Pure 模板首屏动画)或 <code>blocks</code>(四方块形变);不传或传未知值按 <code>dots</code> 处理。</p><p>HTML 首屏动画与应用内 loading 分别覆盖不同阶段,只有后者不能覆盖入口脚本下载、共享运行时下载和远程预加载:</p><ul><li>Vben 的 Element Plus 和 Ant Design 模板在 HTML 内保留跳动方块;首个异步路由就绪并挂载后,由 <code>unmountGlobalLoading</code> 淡出并移除动画及样式。启动失败也会撤掉遮罩并显示错误。</li><li>Art 在 HTML 内显示四点旋转动画,挂载时随 <code>#app</code> 占位内容清除;应用内的路由 loading 继续由原有服务管理。</li><li>Pure 和 Pure Full 保留 HTML 内的三点动画,等待配置、远程依赖及首个路由就绪后挂载并清除。</li><li>Fan 两个模板通过 <code>vite-plugin-app-loading</code> 注入 <code>loading.html</code>;React Ant Design Pro 通过 <code>headScripts</code> 加载原有 <code>public/scripts/loading.js</code>。</li><li>变电站大屏的场景/模型 loading 只覆盖应用启动后的资源加载;Naive Bag 与 React TDesign Pro 目前没有 HTML 首屏全屏动画。这些入口仍存在脚本下载阶段的空档。</li></ul><p>运行 <code>node scripts/verify-tpl-startup-loading.cjs</code> 可在无头 Chrome 中检查前六个模板的源码 HTML(有 <code>dist/index.html</code> 时也检查产物):阻止应用脚本加载,确认动画已经存在,再用 Vue 挂载验证占位内容与 Vben 淡出样式的清理。此检查不替代实际业务路由和远程服务的端到端验证。</p><p><code>loadApp</code> 回调在依赖就绪后执行,等待其 Promise 完成再清理遮罩;失败同样清理并向调用方抛错。异步路由/挂载需要返回对应 Promise,例如 <code>loadApp: () => import('./loadApp').then(app => app.ready)</code>,由业务入口导出 <code>ready</code>。手动控制可调用 <code>showHelLoading</code>,返回的清理函数放在 <code>finally</code> 中。公共遮罩从预加载调用时开始,不覆盖 HTML 与入口脚本的下载阶段。</p><p>提供方参照 comps-react-tdesign 的具名代理导出:<code>const lib = exposeLib(LIB_NAME); export const Comp = lib.Comp</code>。包根的运行时 exports 必须指向代理,类型指向类型入口。不得从实现源码 export *,否则会把实现打入宿主。默认导出保留兼容。</p><p>业务可直接使用 <code>import { MagneticButton } from '@melt-js/comps-vue3'</code>,不再经过 @/remote、#remote 或逐项 getter。具名导出在模块求值时读取代理,因此 main 不得静态引入业务依赖树;只在 mount 前等待无法保证安全。</p><p>普通接收方的 dev 与 build 默认连接托管产物;只有修改组件时才显式切换 REMOTE_TARGET=local。地址由包内配置选择,源码模板必须包含 src、public、配置与默认环境文件,且直接声明可安装的 npm 代理依赖。新增具名导出需要发布新代理版本,静态托管不能替代缺失的 npm 包。</p><h3 id="地址预设与版本协议" tabindex="-1">地址预设与版本协议 <a class="header-anchor" href="#地址预设与版本协议" aria-label="Permalink to "地址预设与版本协议""></a></h3><table tabindex="0"><thead><tr><th>type</th><th>默认 base</th><th>包路径规则</th></tr></thead><tbody><tr><td><code>unpkg</code>(默认)</td><td><code>https://unpkg.com</code></td><td>保留原始包名、scope 和版本,不补组织名</td></tr><tr><td><code>github</code></td><td>从 <code>@owner/包名</code> 推导 <code>https://owner.github.io</code>;无 scope 需传 <code>base</code></td><td><code>/包名[@版本]/hel_dist/hel-meta.json</code></td></tr><tr><td><code>custom</code></td><td>由用户传入</td><td><code>/comps-vue3@1.1.1/hel_dist/hel-meta.json</code></td></tr></tbody></table><p><code>type</code> 选择地址拼接策略;允许传入 <code>base</code> 覆盖。公共库不内置 <code>melt-js</code> 组织或 <code>@melt-js</code> scope。<code>@melt-js/libs-xxx@1.1.1</code> 和 <code>libs-xxx@1.1.1</code> 在 unpkg 是两个不同包,分别解析到 <code>/@melt-js/libs-xxx@1.1.1/hel_dist/hel-meta.json</code> 与 <code>/libs-xxx@1.1.1/hel_dist/hel-meta.json</code>。其他组织也按相同规则处理。</p><p>GitHub 的 <code>@example/comps-chart</code> 默认解析到 <code>https://example.github.io/comps-chart/hel_dist/hel-meta.json</code>;若 npm scope 与 GitHub owner 不同,传 <code>base</code>。SFTP base 只填站点根;完整 npm 包名决定命名空间。<code>@melt-js/comps-vue3</code>、<code>@other/comps-vue3</code>、<code>comps-vue3</code> 对应三个不同路径,不自动补 scope。旧 base 末尾若有 <code>/@scope</code>,完整 scoped 引用会替换该段,避免重复。</p><p>GitHub 按每包独立仓库部署:组件入口如 <code>https://melt-js.github.io/comps-vue3/hel_dist/hel-meta.json</code>,模板入口如 <code>https://melt-js.github.io/tpl-vue3-admin-antd-vben/dist/index.html</code>。解析 <code>tpl-*</code> / <code>demo-*</code> 或完整 <code>dist</code> URL 时自动使用 <code>dist/index.html</code>;普通应用要通过 Hel 加载仍须自行提供模块注册。</p><p>custom 对应自定义 HTTP 托管地址,<code>base</code> 由应用显式提供。仓库的 <code>SFTP_PUBLIC_URL</code> 只在 Node 构建端用于计算选中的远程地址,不再自动生成 <code>VITE_SFTP_PUBLIC_URL</code> / <code>VUE_APP_SFTP_PUBLIC_URL</code>;应用使用对应的 <code>VITE_<SLOT>_HOST</code> / <code>VUE_APP_<SLOT>_HOST</code>,或在运行时配置自定义 <code>base</code>。选中并用于请求的地址仍可被浏览器用户看到。修改根部署配置后执行 <code>pnpm env:sync</code>,部署凭据仅保存在忽略的 <code>.env.local</code>。</p><p>GitHub 发布默认推导 <code>https://github.com/{owner}/{project}.git</code>,owner 取 Pages 域名或 npm scope,project 取项目目录;不写死组织名。可用 <code>DEPLOY_GITHUB_REPOSITORY</code> 覆盖,支持两个占位符。每包独立仓库上传到仓库根;固定共享仓库默认上传到项目子目录。unpkg 继续按 npm 包名、各依赖自身版本和产物目录解析。</p><p><code>/comps-vue3</code> 与 <code>comps-vue3</code> 都接在 base 的目录后面,不会丢掉 base 里的 <code>/@melt-js</code>。完整 URL 使用自己的域名和路径,并自动补齐缺失的 <code>hel_dist/hel-meta.json</code>;已有该后缀、<code>hel_dist</code> 或显式 <code>index.html</code> 不会重复追加,查询参数也会保留。</p><p>不写版本或写 <code>@latest</code> 指向不带版本的最新入口;<code>@1.1.1</code> 固定到对应版本目录。GitHub/custom 的版本目录必须由部署端提供;当前根部署脚本只更新不带版本的项目目录,未提供的版本会加载失败,不会改用最新版本。</p><p>本地 dev server 没有元数据时,传入显式对象:<code>{ name: 'comps-vue3', host: 'http://localhost:20020', requiredExports: ['HelloWorld'] }</code>。显式 <code>host</code> 是完整入口,不做后缀拼接;核心会据此选择元数据或 HTML 入口模式。</p><p><code>resolveHelDep</code> / <code>resolveHelDeps</code> 可只查看解析结果而不下载。原有 <code>loadHelLibsSerial</code> 保留调用方声明的顺序,适合有额外依赖约束的场景。</p><div class="warning custom-block"><p class="custom-block-title">不是把所有组件都提前加载</p><p>预加载会增加启动等待和网络开销。只把首屏和高频必需模块放进去,并为启动失败提供明确提示,避免白屏。</p></div><h2 id="低频组件懒加载" tabindex="-1">低频组件懒加载 <a class="header-anchor" href="#低频组件懒加载" aria-label="Permalink to "低频组件懒加载""></a></h2><p>适合偶发弹窗、重型图表、三维场景和低频领域功能。首次使用时才获取模块,而不是启动时统一下载。</p><p>按需加载使用同一个内核,在页面或交互触发时才调用:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { loadHelLib } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> '@melt-js/libs-core'</span></span>
|
|
15
|
+
<span class="line"></span>
|
|
16
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">async</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> function</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> openChart</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">() {</span></span>
|
|
17
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> lib</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> loadHelLib</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'@example/comps-charts'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, { type: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'github'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> })</span></span>
|
|
18
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> // 在这里把所需导出交给框架渲染;comps-charts 仅作包引用示例。</span></span>
|
|
19
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> return</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> lib</span></span>
|
|
20
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p>同一个模块在预加载与按需加载间复用请求;网络失败后可再次调用重试,没有自动重试。demo-vue3 的 Picker 使用同一方式,通过 <code>defineHelComponent({ dep, exportName })</code> 在 Picker 组件挂载时才获取模块,不会阻塞其他页面启动。</p><p>两种加载时机共用同一套 <code>type</code> / <code>base</code> 与包引用协议,版本、完整 URL 和 scope 的规则相同。<code>deps: []</code> 不会发起请求。字符串引用默认以包名末段作为 Hel 注册组名;不同 npm 包若使用同一个组名且地址不同,会明确报冲突,提供方需声明不同组名并以显式依赖对象传入。</p><p>三套框架适配使用同一 API,下面以 Vue 3 为例(Vue 2 / React 只需更换导入包):</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { defineHelComponent } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> '@melt-js/libs-core-vue3'</span></span>
|
|
21
|
+
<span class="line"></span>
|
|
22
|
+
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> Chart</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineHelComponent</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
|
|
23
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> type: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'github'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
24
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> dep: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'@example/comps-charts'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
25
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> exportName: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'Chart'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
26
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">})</span></span></code></pre></div><p>包名仅用于说明协议。组件挂载时才开始加载,props、事件和插槽正常透传。默认提供加载提示、报错提示和“重试”按钮,也能捕获远程子组件的渲染错误;可通过 <code>loadingComponent</code> / <code>errorComponent</code> 覆盖展示,错误组件接收 <code>error</code> 与 <code>retry</code>。<code>onError</code> 接收原始错误,便于宿主上报。</p><p>如果加载前需要宿主注入运行时,可以传 <code>loader: loadRemoteLib</code> 替代 <code>dep</code>,loader 返回模块对象,仍通过 <code>exportName</code> 选择组件。loader 内调用核心 <code>loadHelLib</code> 即可与预加载复用请求。</p><table tabindex="0"><thead><tr><th>已实现能力</th><th>行为</th></tr></thead><tbody><tr><td>加载态</td><td>请求期间展示占位,避免无反馈</td></tr><tr><td>报错 fallback</td><td>网络失败、导出缺失或渲染错误时展示错误</td></tr><tr><td>重试</td><td>支持用户点击重试;不自动重试</td></tr><tr><td>复用(已实现)</td><td>相同模块请求由核心复用,预加载和按需加载共用串行队列</td></tr><tr><td>最小配置</td><td>默认可用,允许业务按需覆盖文案或 fallback</td></tr></tbody></table><p>加载和导出检查归 <code>libs-core</code>;“如何把状态渲染为 Vue / React 组件”归对应适配层。组件渲染期错误与远程下载失败不是同一种错误,需要框架层分别处理,不能只依赖网络加载的 <code>catch</code>。</p><div class="info custom-block"><p class="custom-block-title">实现状态</p><p>当前已有统一地址协议、请求复用、串行队列、导出检查和统一加载错误,三个框架适配包已提供 UI fallback、渲染期错误处理和手动重试。卸载后忽略晚到的响应;不取消共享网络请求。超时、网络取消和自动重试未内置。先发布包含新增核心 API 的 libs-core,再发布适配包与消费方。</p></div><h2 id="如何选择" tabindex="-1">如何选择 <a class="header-anchor" href="#如何选择" aria-label="Permalink to "如何选择""></a></h2><table tabindex="0"><thead><tr><th>场景</th><th>建议</th></tr></thead><tbody><tr><td>首屏必需、几乎每次都会使用</td><td>启动预加载</td></tr><tr><td>路由进入后才需要</td><td>页面或路由级懒加载</td></tr><tr><td>用户偶尔点开的重型功能</td><td>交互触发懒加载</td></tr><tr><td>高频与低频导出在同一大包</td><td>先评估拆包;单组件懒加载不保证减少整个包的下载量</td></tr></tbody></table><h2 id="两种策略共用的底线" tabindex="-1">两种策略共用的底线 <a class="header-anchor" href="#两种策略共用的底线" aria-label="Permalink to "两种策略共用的底线""></a></h2><p>各组件包入口检查结果与宿主改造进度见 <a href="./remote-components-migration.html">迁移批次</a>。</p><ul><li>使用可信的远程来源,生产环境按需固定版本,避免不可控的远端变更。</li><li>统一模块身份、地址和错误信息,加载策略变了也不让业务重写一套配置。</li><li>Vue / React 运行时和样式归属按提供方约定处理;远程加载不代表天然完成依赖共享或样式隔离。</li><li>预加载和懒加载尽量复用同一底层能力,框架层只补组件、生命周期和展示差异。</li></ul>`,49)])])}const E=e(d,[["render",o]]);export{k as __pageData,E as default};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{_ as e,o as i,c as a,a2 as t}from"./chunks/framework.B8fSEufx.js";const k=JSON.parse('{"title":"预加载与懒加载","description":"","frontmatter":{},"headers":[],"relativePath":"guide/loading.md","filePath":"guide/loading.md","lastUpdated":1794829930000}'),d={name:"guide/loading.md"};function o(l,s,p,n,c,h){return i(),a("div",null,[...s[0]||(s[0]=[t("",49)])])}const E=e(d,[["render",o]]);export{k as __pageData,E as default};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{_ as t,o,c as d,a2 as l}from"./chunks/framework.B8fSEufx.js";const u=JSON.parse('{"title":"远程组件具名导出与宿主迁移批次","description":"","frontmatter":{},"headers":[],"relativePath":"guide/remote-components-migration.md","filePath":"guide/remote-components-migration.md","lastUpdated":1794829930000}'),a={name:"guide/remote-components-migration.md"};function i(r,e,c,n,s,p){return o(),d("div",null,[...e[0]||(e[0]=[l('<h1 id="远程组件具名导出与宿主迁移批次" tabindex="-1">远程组件具名导出与宿主迁移批次 <a class="header-anchor" href="#远程组件具名导出与宿主迁移批次" aria-label="Permalink to "远程组件具名导出与宿主迁移批次""></a></h1><p>2026-11-15 首轮检查中,本文列出 21 个公开 <code>comps-*</code> 包的实现入口、代理源码和 package.json 解析入口检查结果。下方数字仅对应本文范围,后续新增包另行检查。这里记录批次进度;接入规范仍以 <code>.agents/skills/melt-remote-components/SKILL.md</code> 为准。</p><p>检查开始时:5 个远程包已有业务具名代理导出,14 个只提供整包代理,2 个是普通插件包。<code>export const dtlib = exposeLib(...)</code> 本身不算组件具名导出。下表“已有”仅表示存在具名导出,不表示已逐项验证全部公开能力。</p><table tabindex="0"><thead><tr><th>包</th><th>检查结果 / 本批进度</th><th>后续关注</th></tr></thead><tbody><tr><td>comps-art</td><td><strong>第 3 批完成</strong>:69 个具名能力</td><td>61 个组件、集合、安装器、运行时注入 / 查询与组名;根代理与自包含类型</td></tr><tr><td>comps-bag-shop</td><td>普通插件包,dist 默认导出</td><td>保持插件入口,不能按远程组件机械改造</td></tr><tr><td>comps-bag-sys</td><td>普通插件包,dist 默认导出</td><td>保持插件入口,不能按远程组件机械改造</td></tr><tr><td>comps-fan</td><td><strong>第 4 批接入</strong>:54 个具名能力</td><td>48 个 Fa* 组件、4 个 useFa* hooks、examples 与 LIB_NAME;保留 dtlib/default</td></tr><tr><td>comps-pure</td><td><strong>第 2 批完成</strong>:145 个具名能力</td><td>组件、布局、hooks、工具及注入 API;ESM 根代理与自包含类型</td></tr><tr><td>comps-react</td><td><strong>第 10 批接入</strong>:业务具名代理</td><td>基础 demo 已迁移;公开类型不再依赖未声明的 JS 实现</td></tr><tr><td>comps-react-antd</td><td><strong>第 13 批修正</strong>:仅 TestExport 自封装组件</td><td>原生 Antd 由宿主 CDN 提供,声明随代理交付</td></tr><tr><td>comps-react-fin</td><td><strong>第 10 批接入</strong>:业务具名代理</td><td>金融 demo 已迁移,契约覆盖真实 libReady 清单与引用身份</td></tr><tr><td>comps-react-tdesign</td><td><strong>第 13 批修正</strong>:仅 MyComp 自封装组件</td><td>原生 TDesign 由宿主 CDN 提供,声明随代理交付</td></tr><tr><td>comps-vben</td><td><strong>第 5 批接入</strong>:90 个具名能力</td><td>79 个业务 API、10 个命名空间与 LIB_NAME;ESM 根代理</td></tr><tr><td>comps-vue2</td><td><strong>第 1 批完成</strong>:8 个具名能力</td><td>保留 dtlib/default,根入口解析到代理</td></tr><tr><td>comps-vue2-antd</td><td><strong>第 7 批完成</strong>:业务具名代理</td><td>组件及 install / rules 等能力,保留默认入口</td></tr><tr><td>comps-vue2-ele</td><td><strong>第 1 批完成</strong>:44 个具名能力</td><td>包含组件、install、version 和工具集合</td></tr><tr><td>comps-vue3</td><td>已有业务具名代理</td><td>demo-vue3 接入试点;第 9 批清理面板转发层</td></tr><tr><td>comps-vue3-antd</td><td>已有 App / HelloWorld 具名代理</td><td>第 8 批清理 demo 面板和工具栏</td></tr><tr><td>comps-vue3-datav</td><td><strong>第 1 批完成</strong>:20 个具名能力</td><td>自包含类型入口,ESM 根代理</td></tr><tr><td>comps-vue3-ele</td><td><strong>第 3 批完成</strong>:2 个具名组件</td><td>App / HelloWorld,根代理与 Vue 公共类型</td></tr><tr><td>comps-vue3-fin</td><td><strong>第 6 批完成</strong>:业务具名代理</td><td>App / Fin*,默认入口兼容</td></tr><tr><td>comps-vue3-iot</td><td><strong>第 6 批完成</strong>:业务具名代理</td><td>App / Iot*,默认入口兼容</td></tr><tr><td>comps-vue3-med</td><td><strong>第 6 批完成</strong>:业务具名代理</td><td>App / Med*,默认入口兼容</td></tr><tr><td>comps-vue3-picker</td><td>仅 dtlib,待迁移</td><td>现有懒加载可继续按 exportName 使用;具名 import 需先补代理</td></tr></tbody></table><p>上表随批次更新;各批正文中的数量是该批完成时的记录,不代表当前整个仓库的汇总。新增公开能力仍需核对真实 libReady 对象和代理。</p><h2 id="第-1-批宿主" tabindex="-1">第 1 批宿主 <a class="header-anchor" href="#第-1-批宿主" aria-label="Permalink to "第 1 批宿主""></a></h2><ul><li><code>demo-vue3-datav</code>:删除 configs/remote 与 remote/set/get;增加 loadApp;地图、选择器、行政区数据和工具直接从包根具名引入。页面事件类型仅保留业务需要的字段。</li><li><code>tpl-vue2-admin-ele</code>:继续保留两个入口,使用具名组件;preload 的 loadApp 回调等待首屏异步路由与实际挂载,启动失败显示可见提示。</li><li>两者原先无启动遮罩,因此显式 <code>loading: true</code>;不修改公共默认值。</li><li>两者默认 dev/build 使用托管实现;修改提供方时显式 <code>REMOTE_TARGET=local</code>。组件实现不混入代理或宿主,旧默认导出保持兼容。</li></ul><p>根 <code>pnpm run test:comps-exports</code> 对本批三个包核对真实 libReady 对象的名称和引用身份,并禁止代理读取实现模块;该检查已加入 CI。新增迁移包时补入契约覆盖范围。</p><p>Vue CLI 4 模板显式 <code>transpileDependencies: ['@melt-js/libs-core']</code>,保证独立安装后 node_modules 中的 <code>.mjs</code> 也经 Babel;workspace 内构建通过不足以证明这一点。两个 Vue 2 提供方的 dev lint 排除共享 leva 与 core/demo,避免对链接依赖误用本包 ESLint 配置。</p><h2 id="第-2-批宿主-复杂-pure-代理层" tabindex="-1">第 2 批宿主:复杂 Pure 代理层 <a class="header-anchor" href="#第-2-批宿主-复杂-pure-代理层" aria-label="Permalink to "第 2 批宿主:复杂 Pure 代理层""></a></h2><p>按复杂代理层优先选择 <code>tpl-vue3-admin-ele-pure</code> 与 <code>tpl-vue3-admin-ele-pure-full</code>,共用 <code>comps-pure</code>。</p><ul><li>删除两个模板的 remote/config、remote/index 与 remote/setup;不再缓存模块、排队注册图标或逐项转发函数。所有业务、API、hooks、图标、弹窗和路由组件都直接从 <code>@melt-js/comps-pure</code> 具名 import。</li><li><code>main.js</code> 绑定 Vue / Element Plus 并预加载,然后动态导入 <code>loadApp.js</code>,等待其 <code>ready</code>。平台配置 → pinia → <code>plugins/pure.js</code> 宿主注入 → router → storage / 插件 → 首次路由就绪 → mount 的顺序保持。<code>plugins/pure.js</code> 只负责真实宿主能力与全局注册。</li><li>整包已经预加载,布局与异常页直接作为路由组件;本地业务页继续按路由动态 import。离线图标在 loadApp 的模块求值阶段直接注册,无需队列。</li><li>两个模板的 index.html 已有三圆点 loading,沿用并省略公共 loading。远程加载或平台配置失败时显示可见错误,移除原 loading。</li><li><code>.env</code> 默认托管实现;本轮预览以进程环境 <code>REMOTE_TARGET=local</code> 联调 20070 的提供方。模板包同时交付源码、public、mock、构建配置与默认环境;完整版包含 locales / Tailwind 配置,排除 <code>.local</code> 与部署配置。组件包同步补齐独立构建所需文件。</li></ul><p>本批完成后,9 个远程包具备业务具名代理,10 个待迁移,2 个普通插件包保持原交付模型。契约检查扩展到 Pure 的真实 libReady 清单与引用身份,代理不引用组件实现。构建、dev / preview 浏览器登录、布局、异常页、完整版用户列表 / 远程弹窗 / 刷新及失败反馈已通过;保留原 loading,无叠加遮罩。源码包外验证使用本地待发布 tarball,不能作为 npm 已发布证明。</p><h2 id="第-3-批宿主-art-与-vue3-element-demo" tabindex="-1">第 3 批宿主:Art 与 Vue3 Element demo <a class="header-anchor" href="#第-3-批宿主-art-与-vue3-element-demo" aria-label="Permalink to "第 3 批宿主:Art 与 Vue3 Element demo""></a></h2><ul><li><code>tpl-vue3-admin-ele-art</code>:删除 remote/config、remote/index、remote/setup。main 只共享运行时与预加载,loadApp 等待 router ready 后挂载。真实 store / hooks / utils / config / echarts 注入与组件注册保留在 <code>plugins/art.ts</code>,在首次导航前完成。</li><li>全局组件开关、表格操作组件与编辑器直接从 <code>@melt-js/comps-art</code> 具名 import;61 个全局组件的类型引用包根类型,不再维护独立的宽泛组件声明。</li><li><code>demo-vue3-ele</code>:移除 configs/remote 加载转发;App 与 PropsPlayground 直接具名 import。main 预加载 leva / comps 后动态进入 loadApp,等待首屏导航和挂载。</li><li>Art 保留自身路由 loading,不叠加公共遮罩;demo 显式 <code>loading: true</code>,等待、成功清理和提供方失败反馈均在浏览器验证。</li><li>默认 dev/build 使用托管实现;本轮联调通过进程环境 <code>REMOTE_TARGET=local</code>。两个宿主与提供方补齐独立构建文件,不携带 local / 部署配置。demo 在 Vite 内显式使用包内 PostCSS 配置,避免向上读取仓库根配置。</li><li>新提供方加入真实 libReady 名称及引用身份契约检查。Art 的 HTTP 内容类型先收窄到 string,兼容当前 Axios 类型,模板 typecheck 通过。</li></ul><p>本批全仓 CI、两个提供方构建、两个宿主构建与 Art 类型检查通过;四个修改包均通过仓库外 tarball 安装和独立构建。包外宿主 dev / production preview 使用真实提供方,验证 demo 计数 / props 面板、Art 滑块登录 / 工作台 / 用户和角色列表与新增弹窗 / 动态表单,以及提供方失败时的可见反馈。生产预览同时使用构建后的 leva,避免开发依赖中的 HMR 代码要求生产 Vue 提供开发运行时。</p><p>包外验证发现 <code>allowJs: true</code> 会让 Rollup TypeScript 插件创建临时 outDir,在不同磁盘布局下与代理输出目录冲突;Vue3 Element 的 tsconfig.rollup 单独设 <code>allowJs: false</code>,仅编译 TS 代理与组名,不改变组件实现的 Vite 构建。</p><p>第 2 批的包外验证还发现图标插件可能经 local-pkg 解析到 Vue 2 compiler,生成无效图标模块;Pure 两个模板已改用现有 Iconify 数据与渲染组件,删除该插件。最终包外安装后的 dev 与 build 浏览器检查均通过。</p><h2 id="第-4-批宿主-fan-两个模板" tabindex="-1">第 4 批宿主:Fan 两个模板 <a class="header-anchor" href="#第-4-批宿主-fan-两个模板" aria-label="Permalink to "第 4 批宿主:Fan 两个模板""></a></h2><ul><li><code>tpl-vue3-admin-ele-fan</code> 与 <code>tpl-vue3-admin-reka-fan</code>:main 绑定 Vue、设置宿主雪碧图、预加载,然后动态进入 loadApp 并等待路由与挂载。删除原 remote/config、index、setup,沿用 Fan 的启动动画,失败时清理动画并显示错误。</li><li>业务直接 <code>import { FaCheckbox, useFaToast } from '@melt-js/comps-fan'</code>,组件保留 <code>Fa</code> 前缀、hooks 保留 <code>useFa</code> 前缀。Reka 的 44 个组件示例页改成直接标签和页面状态,保留 207 个演示场景;页面不再使用 examples 或外层动态 component。</li><li>两个 main 在远程 CSS 到达前声明 <code>uno-preflight, comps-fan-base</code> 的层叠顺序,避免业务入口后加载的 reset 覆盖远程组件的 <code>m-4</code>。组件与宿主各自保留原有样式构建。</li><li>默认 dev/build 使用托管实现,提供方联调显式设置 <code>REMOTE_TARGET=local</code>。四个 hooks 自动导入指向包根;提供方增加公开 package.json 子路径,使独立安装时可读取已安装版本。模板直接声明所用 Node 类型依赖。</li><li>保留所有包原有 files 交付范围。模板源码分享目录验证独立安装和构建,npm 模板包按静态 dist 交付验证;本地 tarball 不代表已发布。</li></ul><h2 id="第-5-批宿主-vben" tabindex="-1">第 5 批宿主:Vben <a class="header-anchor" href="#第-5-批宿主-vben" aria-label="Permalink to "第 5 批宿主:Vben""></a></h2><ul><li>两个 tpl(ele-vben、antd-vben)删除 remote 转发与缓存,页面、表单、布局、插件直接从提供方包根具名 import。main 预加载后动态进入 loadApp,等待首次路由与挂载,保留原动画和失败提示。</li><li>Vite 元数据从已安装包公开 package.json 读取版本,移除兄弟目录引用;直接声明 hel-micro / vue-i18n,修正 Vue 类型路径与路由异步组件映射。默认托管,组件开发显式 REMOTE_TARGET=local。</li><li>comps-vben 提供方构建、两个 tpl 生产构建与类型检查、全仓 CI、导出名称与引用身份检查通过。用户已确认 Vben Antd 本地效果基本正常。</li><li>公共 TDZ 扫描器修正 switch 判别式作用域误报,回归覆盖外层读取与真正 case / 模块 TDZ;comps-vben 保留 metadata 前的 TDZ 检查。</li><li>保留原 files;不提交发布。新增 npm 代理与远程实现仍需匹配版本后再对外交付。</li></ul><h2 id="第-6-批宿主-医疗、金融、iot-demo" tabindex="-1">第 6 批宿主:医疗、金融、IoT demo <a class="header-anchor" href="#第-6-批宿主-医疗、金融、iot-demo" aria-label="Permalink to "第 6 批宿主:医疗、金融、IoT demo""></a></h2><ul><li>med / fin / iot 三个提供方补齐 App 与各自 Med* / Fin* / Iot* 具名代理,保留默认导出与 dtlib;包根解析到轻量代理,schema 通过公开子路径读取。</li><li>三个 demo 预加载领域组件与公共 leva 后动态进入 loadApp,等待首次路由与挂载;业务直接具名导入组件及 PropsPlayground,移除 remote 缓存与加载包装。</li><li>六个包的仓库内及源码分享目录独立安装、构建通过,全仓 CI 与代理引用身份检查通过。三个开发 demo 已由用户确认效果,生产预览浏览器验收未记录为通过。</li><li>保留各包原有 files,不提交发布;本地 tarball 不代表已发布版本。</li></ul><h2 id="第-7-批宿主-vue-2-与-vue-2-antd-demo" tabindex="-1">第 7 批宿主:Vue 2 与 Vue 2 Antd demo <a class="header-anchor" href="#第-7-批宿主-vue-2-与-vue-2-antd-demo" aria-label="Permalink to "第 7 批宿主:Vue 2 与 Vue 2 Antd demo""></a></h2><ul><li>comps-vue2-antd 补齐 24 项业务具名代理(组件、install、rules、validate、utils、directives),保留 default / dtlib;ESM 与真实 CommonJS 入口通过 package exports 公开,metadata 前增加公共 TDZ 扫描。</li><li>两个 demo 改为 main 预加载组件、leva、utils 与 lodash,再动态进入 loadApp;ready 等待 router.onReady 与挂载,启动失败显示页面错误。组件、面板、工具方法直接从已安装包根导入,删除 remoteLibs、Df 转发与 LevaPlayground 加载层。</li><li>按用户要求删除 Hamburger 示例页、导航、链接与模板源码依赖。默认托管,本地组件联调显式 REMOTE_TARGET=local;Vue CLI 转换 libs-core,生成代理不套用宿主 ESLint 配置。</li><li>提供方与两个 demo 的构建、两个 demo 的 lint、全仓 CI 通过;三个源码分享目录独立安装和构建通过。安装后的 Antd ESM / CommonJS 代理验证全部 24 项具名导出与 default 引用身份。</li><li>开发浏览器验证 App / DfEmpty 属性更新、模型双向同步、远程 libs 重新执行、插件安装与表单校验、穿梭弹窗与确认弹窗。保留原 files:demo 的 npm tarball 仍用于静态 dist 托管。</li></ul><h2 id="第-8-批宿主-vue-3-antd-与-element-plus-demo" tabindex="-1">第 8 批宿主:Vue 3 Antd 与 Element Plus demo <a class="header-anchor" href="#第-8-批宿主-vue-3-antd-与-element-plus-demo" aria-label="Permalink to "第 8 批宿主:Vue 3 Antd 与 Element Plus demo""></a></h2><ul><li>两个 demo 删除仅转发参数的 LevaPlayground,远程页面直接具名导入 PropsPlayground 并传入 components / schemas / presets;工具栏直接具名导入 DemoToolbar,取消重复的懒加载包装。</li><li>沿用 main 预加载后动态进入 loadApp、等待首次路由与挂载的启动顺序。预加载校验覆盖 PropsPlayground / DemoTabs / DemoToolbar,启动错误通过页面 alert 显示。</li><li>两个宿主构建、全仓 CI 通过。保留原 files:Antd tarball 按静态 dist 验证,源码分享目录独立安装构建;Element Plus 从实际 tarball 解包后独立安装构建。</li><li>开发浏览器验证计数、props 更新、Antd 输入框和 Element Plus 全屏进出;包外生产宿主通过显式 hel-meta.json 地址加载构建后的提供方和 leva,验证两个页面渲染与计数。生产 Vue 不与带 HMR 的开发版提供方混用。验证使用本地构建产物,不代表已发布托管版本验收。</li></ul><h2 id="第-9-批宿主-vue-2-element、vue-3-基础与-datav-demo" tabindex="-1">第 9 批宿主:Vue 2 Element、Vue 3 基础与 Datav demo <a class="header-anchor" href="#第-9-批宿主-vue-2-element、vue-3-基础与-datav-demo" aria-label="Permalink to "第 9 批宿主:Vue 2 Element、Vue 3 基础与 Datav demo""></a></h2><ul><li><code>demo-vue2-ele</code> 改为入口预加载组件、leva、utils / lodash,再动态进入 loadApp;Element UI、RocketRender 和全局面板注册在业务入口完成,ready 等待首次路由和挂载。组件及工具直接具名导入,删除 remoteLibs、Tc 转发和面板加载层,移除 Hamburger 示例及模板源码依赖。</li><li><code>demo-vue3</code> 的 42 处面板实例直接导入 PropsPlayground,使用公开的 components / schemas / presets / listeners / slotHtml / stageStyles 映射,删除本地 LevaPlayground。Picker 保留按路由懒加载及其 platform / exportName 配置。顶部 DemoTabs 放回内容宽度容器,与标题及正文对齐。</li><li><code>demo-vue3-datav</code> 工具栏直接具名导入 DemoToolbar;三个入口校验面板所需导出,并在启动失败时显示 alert。沿用默认托管、本地联调显式 REMOTE_TARGET=local 的约定。</li><li>按用户要求删除 <code>libs-utils</code> / <code>libs-lodash</code> 自带的 “Cool, as you see…” 调试页与启动导入,入口仅注册工具 API,避免宿主底部追加调试 DOM。</li><li>三个宿主与两个工具库构建、Vue 2 Element lint 及修改后的全仓 <code>pnpm run ci</code> 通过。三个宿主及两个工具库的源码分享目录在仓库外独立安装、构建通过;Vue 3 宿主从实际 tarball 解包验证,Vue 2 Element / Datav tarball 保持静态 dist 交付。保留各包原有 files,验证使用本地待发布产物。</li><li>开发浏览器验证 Vue 2 按钮计数 / 禁用属性、Vue 3 面板事件 / 文案更新与 Picker 选择、Datav 地图及全屏进出。包外生产页面验证 Vue 2 按钮、远程工具重新执行与调试 DOM 移除、Vue 3 面板点击事件及 Datav 安徽 16 个要素渲染;导航布局通过浏览器实测对齐。生产依赖使用构建后的提供方和 leva,并显式指定 hel-meta.json。临时跨域预览需以 <code>HEL_RELATIVE_PATH=0</code> 保留提供方绝对资源地址,避免继承相对路径构建设置后贴图请求落到宿主。</li></ul><h2 id="第-10-批宿主-react-基础与金融-demo" tabindex="-1">第 10 批宿主:React 基础与金融 demo <a class="header-anchor" href="#第-10-批宿主-react-基础与金融-demo" aria-label="Permalink to "第 10 批宿主:React 基础与金融 demo""></a></h2><ul><li><code>demo-react</code> / <code>demo-react-fin</code> 由 index 绑定共享运行时并声明预加载依赖,再动态进入 loadApp 挂载。显式开启公共启动 loading,校验组件、DemoTabs / DemoStage / PropsPanel / 工具栏等实际使用的导出,失败后清理遮罩并显示 alert。开发与构建默认托管实现,提供方联调显式设置 REMOTE_TARGET=local。</li><li>删除 configs/remote 加载转发与重复的面板加载状态;组件、PropsPanel、PropsPlayground、SplitPane、DemoToolbar、DemoStage 都从公共包入口具名导入。基础 demo 删除 LevaPlayground 参数转发;远程预览保留组件选择、属性状态与刷新等业务编排,下载配置保持纯数据。</li><li>同一组件包已预加载,原 lazy 页面改成 React.lazy + Suspense 按路由下载页面代码,并准确说明复用已就绪的远程组件。本地调试页在启动时自动选择本地提供方,进入 / 离开时刷新文档,避免同一应用组混用线上 / 本地实现。</li><li>金融 demo 补齐 libs-core 的 Vite 预构建配置;两个宿主显式限定包内 PostCSS 并使用 bundler 类型解析,保证仓库外能读取公共 exports 的类型。comps-react 的公开类型与 JS 示例实现解耦,HelloButton 共享同一份 props 类型,代理构建显式 external hel-lib-proxy 并使用 named exports。</li><li>libs-react-leva 的独立调试页只挂载自己的 container,不再回退到宿主 root,避免预加载过程中短暂渲染 Toy 或争用 React 根节点。两个 React 提供方加入公开代理名称、默认入口与 comps 别名引用身份契约检查;下载示例测试兼容直接导入公共 React DemoStage。</li><li>两个宿主的仓库内构建 / TypeScript 检查、提供方实现与基础组件代理构建通过;源码分享目录在仓库外通过本地 tarball 安装、构建和类型检查。libs-react-leva 的实际 tarball 也已在仓库外独立安装和完整构建通过。npm demo tarball 保持原 files: ["dist"],在仓库外核对静态页面、相对资源、默认托管地址及独立页面 chunk;未扩充发布内容。</li><li>开发浏览器验证首屏、组件选择、按钮文案 / 禁用属性、实验台及全屏进出;包外生产宿主使用构建后的组件与 leva、显式 hel-meta.json,验证属性同步、全屏和按需页面。失败地址验证启动遮罩清理与页面错误,修复后的 leva 不再往宿主根节点挂调试页。以上均为本地待发布产物验证。</li></ul><p>本批过程中的完整 CI 曾通过;最后收尾复跑时,构建检查中的 comps-react-fin 父进程曾超时,该包单独复跑通过,端口与 44 项环境测试通过。随后工作区并行修改 libs-core 的 files 清单、移除 scripts,最终全仓 CI 因 scripts.test / vdoc-parser.test 两项打包契约失败;该发布清单变更不属于本批 React 迁移,未在本批回退。上述包外验证使用修改清单前生成并核验的实际 tarball。</p><h2 id="第-11-批宿主-react-antd-与-tdesign-demo" tabindex="-1">第 11 批宿主:React Antd 与 TDesign demo <a class="header-anchor" href="#第-11-批宿主-react-antd-与-tdesign-demo" aria-label="Permalink to "第 11 批宿主:React Antd 与 TDesign demo""></a></h2><p>本批曾扩大为原生组件库代理;该边界已由第 13 批修正。下面保留当时验证记录,当前公开导出以第 13 批及包入口为准。</p><ul><li>两个 demo 由 index 绑定共享 React 运行时、校验预加载依赖,再动态进入 loadApp 挂载;显式启用公共 loading,启动失败显示 alert。开发与构建默认托管实现,提供方联调显式设置 REMOTE_TARGET=local。</li><li>删除 configs/remote 与组件、面板的重复加载状态。组件预览、组件矩阵、PropsPanel、SplitPane、DemoToolbar、DemoStage 均从公共包根具名导入;configs/demo、remoteComponents、demoComponents 只保留演示数据与业务配置。</li><li>lazy 路由使用 React.lazy / Suspense 下载页面代码,准确说明组件实现复用启动预加载;本地调试页自动连接本地组件与面板,进入 / 离开时刷新文档。保留原 npm files、ReactDOM.render 和页面布局;宿主限定包内 PostCSS、预构建 libs-core,并通过 bundler 类型解析读取公开 exports。</li><li>核对真实 antd / tdesign-react 的导出,补齐 Antd 的 App / Flex / TimePicker 等及 TDesign 的 Rate / Space / Typography 等代理。TDesign 代理 external hel-lib-proxy,保留 default / lib / comps;24 个包的名称与引用身份契约检查通过,两个 UI 包按实际安装库的键检查,避免 mock 忽略整库展开。</li><li>实际 tarball 检查发现两个提供方和 libs-react-leva 的 types 指向未打包源码。三者新增独立声明构建,将声明放入已有 hel_proxy_es/types 并调整公开类型入口;UI 代理使用公开依赖的索引类型,避免泄漏 pnpm 内部路径。两个提供方移除引用未打包文件的欢迎信息 postinstall;各包 files 范围保持原样。根契约检查先生成这三个包的声明。</li><li>两个宿主的构建、TypeScript 检查,两个提供方的远程实现 / metadata / 代理构建,Leva 完整构建及最终全仓 pnpm run ci 通过。重新打出的实际提供方 / Leva / core tarball 在仓库外安装到两个源码分享目录,默认托管构建与类型检查通过;demo npm tarball 仍按静态 dist 交付验证。</li><li>开发与包外生产浏览器验证组件矩阵、属性修改、Antd 禁用属性 / 全屏进出及 TDesign MyComp 弹窗;按需页面能结束加载。生产提供方与面板使用构建产物和显式 hel-meta.json,控制台无错误;无效提供方地址显示可见错误且 loading 数量为 0。验证为本地待发布产物,不代表已发布版本。</li></ul><h2 id="第-12-批宿主-qiankun-vue-2-两个子应用" tabindex="-1">第 12 批宿主:Qiankun Vue 2 两个子应用 <a class="header-anchor" href="#第-12-批宿主-qiankun-vue-2-两个子应用" aria-label="Permalink to "第 12 批宿主:Qiankun Vue 2 两个子应用""></a></h2><ul><li><code>tpl-qiankun2-vue2-app1</code> / <code>tpl-qiankun2-vue2-app2</code> 删除 <code>src/remote/comps.js</code>。两个表单与 app2 排行榜在页面直接从公共 Vue 2 适配层导入 <code>defineHelComponent</code>,只声明 <code>dep</code> 与 <code>exportName</code>,不再转发加载器、缓存代理或提前读取导出。</li><li>组件仅出现在特定路由,保留按需加载;首页不预加载,也不为统一形式增加启动等待。共享 Vue 在入口绑定,<code>public-path</code> 仍最先执行;qiankun 的 UMD 生命周期与资源路径保留。</li><li>修复子应用重新执行入口后,用空的旧 <code>microName</code> 查询缓存导致表单丢失的问题:mount 按 <code>props.name</code> 取缓存,unmount 等待缓存处理完成。回归测试覆盖新入口恢复缓存 vnode / router.apps,以及异步卸载完成时机。</li><li>两包默认 dev / build 使用托管地址,组件开发显式设置 <code>REMOTE_TARGET=local</code>;Vue CLI 4 显式转换安装后的 core 与 Vue 2 适配层。README 更新为实际公共 API,删除旧 computed / preFetchLib 转发说明。</li><li>两个宿主的仓库内构建、仓库外源码分享目录安装与默认构建,以及最终全仓 <code>pnpm run ci</code> 通过(收尾复跑曾遇 Windows 临时目录 EPERM,重新完整执行后通过)。包外安装使用实际 core / Vue 2 适配层 / 组件 / leva tarball;保留原 <code>files: ["dist", "README.md"]</code>,两个 npm 包在仓库外解包检查静态 HTML、相对资源、默认托管地址与 UMD 生命周期导出,不扩充源码发布范围。</li><li>开发浏览器验证两个表单、排行榜使用说明交互及主应用切换保活;仓库外生产宿主使用构建后的提供方和完整 hel-meta.json,验证独立页面与主应用内渲染、切换后字段保留,主应用控制台无错误。失败夹具返回 404 时显示错误与重试,恢复提供方后手动重试成功;首页未新增远程请求。验证使用本地待发布产物,未发布。</li></ul><h2 id="后续批次与发布前置" tabindex="-1">后续批次与发布前置 <a class="header-anchor" href="#后续批次与发布前置" aria-label="Permalink to "后续批次与发布前置""></a></h2><p>按提供方依赖链选择少量宿主,每批完成源码、类型、代理构建、CI、浏览器 dev/build 验收及包外安装验证,再推进下一批。两个 React 模板(Antd Pro / TDesign Pro)已在第 13 批完成 CDN 边界修正;没有远程依赖的模板无需为了统一形式新增预加载。<code>demo-vue3-ele-cmdmodal</code> 当前实际入口是本地命令式弹窗实验,不按遗留未使用的 remote 文件推断它需要迁移。</p><p>以上迁移批次均未发布。npm 新具名代理需发布新版本后才能供外部安装;SFTP 托管实现不能替代 npm 代理。包外用本地 tarball 验证只证明待发布内容可安装,不能当作已发布版本证明。第 1 批两个宿主的 npm files 仍是静态页交付;第 2 / 3 批宿主已补齐源码交付清单,不携带 .local 或凭据。</p><h3 id="本地联调地址选择" tabindex="-1">本地联调地址选择 <a class="header-anchor" href="#本地联调地址选择" aria-label="Permalink to "本地联调地址选择""></a></h3><p>四个 React demo 的预加载依赖通过 <code>libs-core/demo</code> 的 <code>setupDemoRemoteDebug</code> 声明 <code>host</code>:开发环境 <code>REMOTE_TARGET=local</code> 指向本地提供方,生产构建指向托管地址。预加载前校验地址;其他路由保留包内默认托管地址及显式环境覆盖。</p><p>本地服务需先启动。启动失败页直接列出实际请求的组件和面板地址,提供重试;恢复操作不依赖尚未加载的远程 UI。业务组件继续具名 import,公共逻辑未进入业务页面。下载示例仍指向 unpkg。新增公共能力尚未发布,包外验证使用本地 tarball。</p><p><code>libs-react-leva</code> 的开发入口自行执行 React 插件提供的 Fast Refresh preamble,使普通构建预览也能连接 Vite 面板开发服务,不依赖宿主恰好也是 Vite dev。四个宿主把 <code>libs-core/demo</code> 加入预构建,避免 workspace 的公共 CommonJS 地址模块直接进入浏览器。</p><p>验证:四个宿主类型检查、默认构建和 npm 静态包资源检查通过;core 新 tarball 在仓库外安装后,四个宿主类型检查及构建通过。浏览器验证四个开发页连接真实本地服务、历史前进后退和 404 后重试 / 返回默认示例;最终根 <code>pnpm run ci</code> 通过。预览 31196–31199 已更新,尚未发布。</p><h2 id="第-13-批-react-原生-ui-cdn-与自封装组件边界" tabindex="-1">第 13 批:React 原生 UI CDN 与自封装组件边界 <a class="header-anchor" href="#第-13-批-react-原生-ui-cdn-与自封装组件边界" aria-label="Permalink to "第 13 批:React 原生 UI CDN 与自封装组件边界""></a></h2><ul><li><code>comps-react-antd</code> 仅导出 <code>TestExport</code>,<code>comps-react-tdesign</code> 仅导出 <code>MyComp</code>,保留 default / lib / comps。移除原生组件库和扩展命名空间代理,两个 HEL 构建 external 主组件库;不通过远程包转发 Button 等原生组件。</li><li>两个 Pro 模板直接依赖并保留 <code>antd</code> / <code>tdesign-react</code> 原生 import。入口先绑定共享 React,再等待固定版本 CDN,最后动态进入 loadApp;网络失败显示页面错误。模板未使用自封装组件,因此移除无用的 comps 预加载和依赖。</li><li>Antd 6.7.0 / Dayjs 1.11.23 与 TDesign 1.18.6 JS/CSS 由 CDN 提供。图标、图表、ProComponents、X 和 antd-style 继续按原生依赖打包。Webpack external 与 Vite CDN 桥同时覆盖开发和构建,最终模块审计确认主组件库实现未进入模板 bundle。</li><li>通用 CDN 顺序加载、并发复用、超时及失败重试能力放在 <code>libs-core</code>。TDesign demo 和下载 HTML 在加载 MyComp 前准备 TDesign;两个 demo 的组件清单只展示自封装组件。</li><li>两个提供方完整 HEL 构建、两个模板构建/类型/边界检查、两个 demo 构建/类型检查、公共 CDN/下载测试与整仓 <code>pnpm run ci</code> 通过。五个实际 tarball 在仓库外解包检查,未发现意外源码、映射或环境文件;core 与提供方安装后的公开工具、代理和类型可用。两个源码分享目录独立安装、构建、类型和边界检查通过。证据保留在 <code>C:/Users/COLORFUL/AppData/Local/Temp/hel-react-cdn-20261115</code>。</li><li>浏览器验证两个模板 dev/production 页面、生产仪表盘/表格,以及两个 demo 加载生产与本地提供方;MyComp 日期选择和弹窗可用。Antd 提供方源码修改后刷新宿主可见更新,但自动 HMR 本次未通过,不能记为完整热更新验收;测试修改已还原。demo 仍有原有 ReactDOM.render 与面板 key 警告,未声称控制台零告警。</li><li>保留既有 files 范围,未提交或发布;共享 core 新能力需先发布,再发布消费者。本地 tarball 验证不代表线上版本已具备这些入口。</li></ul>',48)])])}const b=t(a,[["render",i]]);export{u as __pageData,b as default};
|