@melt-js/docs-all 2026.11.16-1 → 2026.11.16

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.
Files changed (114) hide show
  1. package/dist/404.html +5 -5
  2. package/dist/README.html +10 -10
  3. package/dist/assets/{README.md.3oyqMuS9.js → README.md.DhKcEW_7.js} +1 -1
  4. package/dist/assets/{README.md.3oyqMuS9.lean.js → README.md.DhKcEW_7.lean.js} +1 -1
  5. package/dist/assets/{app.DQbC6m_i.js → app.F2-Avr0J.js} +1 -1
  6. package/dist/assets/chunks/@localSearchIndexroot.DXFlel7a.js +1 -0
  7. package/dist/assets/chunks/{VPLocalSearchBox.Z-GU2mRG.js → VPLocalSearchBox.LhvELOMD.js} +2 -2
  8. package/dist/assets/chunks/{framework.DvDCk5Jp.js → framework.qU75dRxB.js} +1 -1
  9. package/dist/assets/chunks/{theme.B-moiCuV.js → theme.f6-9NYKe.js} +2 -2
  10. package/dist/assets/{guide_browser-esm.md.BqfODNTi.js → guide_browser-esm.md.CexU_fRZ.js} +1 -1
  11. package/dist/assets/{guide_browser-esm.md.BqfODNTi.lean.js → guide_browser-esm.md.CexU_fRZ.lean.js} +1 -1
  12. package/dist/assets/{guide_core.md.B-2GaTvv.js → guide_core.md.Cy4oOLrM.js} +1 -1
  13. package/dist/assets/{guide_core.md.B-2GaTvv.lean.js → guide_core.md.Cy4oOLrM.lean.js} +1 -1
  14. package/dist/assets/{guide_getting-started.md.BaUTrzhp.js → guide_getting-started.md.BTeUsIYn.js} +1 -1
  15. package/dist/assets/{guide_getting-started.md.BaUTrzhp.lean.js → guide_getting-started.md.BTeUsIYn.lean.js} +1 -1
  16. package/dist/assets/{guide_introduction.md.CJ35LSsk.js → guide_introduction.md.DbHnY0iE.js} +1 -1
  17. package/dist/assets/{guide_introduction.md.CJ35LSsk.lean.js → guide_introduction.md.DbHnY0iE.lean.js} +1 -1
  18. package/dist/assets/{guide_loading.md.eRhSGzPW.js → guide_loading.md.DXPJ5dne.js} +2 -2
  19. package/dist/assets/{guide_loading.md.eRhSGzPW.lean.js → guide_loading.md.DXPJ5dne.lean.js} +1 -1
  20. package/dist/assets/{guide_remote-components-migration.md.D9opXcKu.js → guide_remote-components-migration.md.CfBojXod.js} +1 -1
  21. package/dist/assets/{guide_remote-components-migration.md.D9opXcKu.lean.js → guide_remote-components-migration.md.CfBojXod.lean.js} +1 -1
  22. package/dist/assets/{index.md.H6vS8PKh.js → index.md.CHI5A_dl.js} +1 -1
  23. package/dist/assets/{index.md.H6vS8PKh.lean.js → index.md.CHI5A_dl.lean.js} +1 -1
  24. package/dist/assets/{modules_catalog_antd.md.wRZC0lxK.js → modules_catalog_antd.md.Bo7SBEIt.js} +1 -1
  25. package/dist/assets/{modules_catalog_antd.md.wRZC0lxK.lean.js → modules_catalog_antd.md.Bo7SBEIt.lean.js} +1 -1
  26. package/dist/assets/{modules_catalog_art.md.BUIzlI0Q.js → modules_catalog_art.md.DV6UFGT7.js} +1 -1
  27. package/dist/assets/{modules_catalog_art.md.BUIzlI0Q.lean.js → modules_catalog_art.md.DV6UFGT7.lean.js} +1 -1
  28. package/dist/assets/{modules_catalog_bag.md.CzpNJ01F.js → modules_catalog_bag.md.DGaUWUT2.js} +1 -1
  29. package/dist/assets/{modules_catalog_bag.md.CzpNJ01F.lean.js → modules_catalog_bag.md.DGaUWUT2.lean.js} +1 -1
  30. package/dist/assets/{modules_catalog_basic.md.BsMKhB-I.js → modules_catalog_basic.md.agdjRCNL.js} +1 -1
  31. package/dist/assets/{modules_catalog_basic.md.BsMKhB-I.lean.js → modules_catalog_basic.md.agdjRCNL.lean.js} +1 -1
  32. package/dist/assets/{modules_catalog_core.md.C7M53s-5.js → modules_catalog_core.md.BLxyo-Ea.js} +1 -1
  33. package/dist/assets/{modules_catalog_core.md.C7M53s-5.lean.js → modules_catalog_core.md.BLxyo-Ea.lean.js} +1 -1
  34. package/dist/assets/{modules_catalog_datav.md.Bq7W-fjl.js → modules_catalog_datav.md.Cs2ZcEOi.js} +1 -1
  35. package/dist/assets/{modules_catalog_datav.md.Bq7W-fjl.lean.js → modules_catalog_datav.md.Cs2ZcEOi.lean.js} +1 -1
  36. package/dist/assets/{modules_catalog_element.md.Cb4j88LA.js → modules_catalog_element.md.BOhg5UCa.js} +1 -1
  37. package/dist/assets/{modules_catalog_element.md.Cb4j88LA.lean.js → modules_catalog_element.md.BOhg5UCa.lean.js} +1 -1
  38. package/dist/assets/{modules_catalog_fan.md.ByMAfMFa.js → modules_catalog_fan.md.DM-_cUln.js} +1 -1
  39. package/dist/assets/{modules_catalog_fan.md.ByMAfMFa.lean.js → modules_catalog_fan.md.DM-_cUln.lean.js} +1 -1
  40. package/dist/assets/{modules_catalog_finance.md.D0s5j4M-.js → modules_catalog_finance.md.Bil6fi8q.js} +1 -1
  41. package/dist/assets/{modules_catalog_finance.md.D0s5j4M-.lean.js → modules_catalog_finance.md.Bil6fi8q.lean.js} +1 -1
  42. package/dist/assets/{modules_catalog_iot.md.DjHegJUC.js → modules_catalog_iot.md.sax5E-JG.js} +1 -1
  43. package/dist/assets/{modules_catalog_iot.md.DjHegJUC.lean.js → modules_catalog_iot.md.sax5E-JG.lean.js} +1 -1
  44. package/dist/assets/{modules_catalog_leva.md.C6g1IIMg.js → modules_catalog_leva.md.DArN8WeP.js} +1 -1
  45. package/dist/assets/{modules_catalog_leva.md.C6g1IIMg.lean.js → modules_catalog_leva.md.DArN8WeP.lean.js} +1 -1
  46. package/dist/assets/{modules_catalog_medical.md.CYkl61KJ.js → modules_catalog_medical.md.CODEMAnE.js} +1 -1
  47. package/dist/assets/{modules_catalog_medical.md.CYkl61KJ.lean.js → modules_catalog_medical.md.CODEMAnE.lean.js} +1 -1
  48. package/dist/assets/{modules_catalog_picker.md.CLJxDkqS.js → modules_catalog_picker.md.CcLQZdXG.js} +1 -1
  49. package/dist/assets/{modules_catalog_picker.md.CLJxDkqS.lean.js → modules_catalog_picker.md.CcLQZdXG.lean.js} +1 -1
  50. package/dist/assets/{modules_catalog_popular.md.CnncQMJM.js → modules_catalog_popular.md.B12xaSbQ.js} +1 -1
  51. package/dist/assets/{modules_catalog_popular.md.CnncQMJM.lean.js → modules_catalog_popular.md.B12xaSbQ.lean.js} +1 -1
  52. package/dist/assets/{modules_catalog_pure.md.DF1hvvY7.js → modules_catalog_pure.md.BsB_PSSM.js} +1 -1
  53. package/dist/assets/{modules_catalog_pure.md.DF1hvvY7.lean.js → modules_catalog_pure.md.BsB_PSSM.lean.js} +1 -1
  54. package/dist/assets/{modules_catalog_qiankun.md.CMSAlH_e.js → modules_catalog_qiankun.md.D0XCiuWW.js} +1 -1
  55. package/dist/assets/{modules_catalog_qiankun.md.CMSAlH_e.lean.js → modules_catalog_qiankun.md.D0XCiuWW.lean.js} +1 -1
  56. package/dist/assets/{modules_catalog_station.md.CD0uBfy2.js → modules_catalog_station.md.Bkaxjv14.js} +1 -1
  57. package/dist/assets/{modules_catalog_station.md.CD0uBfy2.lean.js → modules_catalog_station.md.Bkaxjv14.lean.js} +1 -1
  58. package/dist/assets/{modules_catalog_tdesign.md.B-nPpETh.js → modules_catalog_tdesign.md.CHkWuylZ.js} +1 -1
  59. package/dist/assets/{modules_catalog_tdesign.md.B-nPpETh.lean.js → modules_catalog_tdesign.md.CHkWuylZ.lean.js} +1 -1
  60. package/dist/assets/{modules_catalog_tools.md.B65QzQl0.js → modules_catalog_tools.md.MW_PyYD-.js} +1 -1
  61. package/dist/assets/{modules_catalog_tools.md.B65QzQl0.lean.js → modules_catalog_tools.md.MW_PyYD-.lean.js} +1 -1
  62. package/dist/assets/{modules_catalog_vben.md.CwadHZte.js → modules_catalog_vben.md.BrdjVOHn.js} +1 -1
  63. package/dist/assets/{modules_catalog_vben.md.CwadHZte.lean.js → modules_catalog_vben.md.BrdjVOHn.lean.js} +1 -1
  64. package/dist/assets/{modules_components.md.Cs4p-whz.js → modules_components.md.BXIU-AjT.js} +1 -1
  65. package/dist/assets/{modules_components.md.Cs4p-whz.lean.js → modules_components.md.BXIU-AjT.lean.js} +1 -1
  66. package/dist/assets/{modules_demos.md.CcMubvZ-.js → modules_demos.md.C0ZBcij2.js} +1 -1
  67. package/dist/assets/{modules_demos.md.CcMubvZ-.lean.js → modules_demos.md.C0ZBcij2.lean.js} +1 -1
  68. package/dist/assets/{modules_docs-and-services.md.HM7T2-rY.js → modules_docs-and-services.md.guWEE5JY.js} +1 -1
  69. package/dist/assets/{modules_docs-and-services.md.HM7T2-rY.lean.js → modules_docs-and-services.md.guWEE5JY.lean.js} +1 -1
  70. package/dist/assets/{modules_index.md.BAfftVvl.js → modules_index.md.D0y53qiC.js} +1 -1
  71. package/dist/assets/{modules_index.md.BAfftVvl.lean.js → modules_index.md.D0y53qiC.lean.js} +1 -1
  72. package/dist/assets/{modules_libs.md.BjSRuqIN.js → modules_libs.md.CAP1L7ZR.js} +1 -1
  73. package/dist/assets/{modules_libs.md.BjSRuqIN.lean.js → modules_libs.md.CAP1L7ZR.lean.js} +1 -1
  74. package/dist/assets/{modules_templates.md.D3IIqxu2.js → modules_templates.md.Bc3EFQEE.js} +1 -1
  75. package/dist/assets/{modules_templates.md.D3IIqxu2.lean.js → modules_templates.md.Bc3EFQEE.lean.js} +1 -1
  76. package/dist/assets/style.Cp10hIad.css +1 -0
  77. package/dist/guide/browser-esm.html +10 -10
  78. package/dist/guide/core.html +9 -9
  79. package/dist/guide/getting-started.html +10 -10
  80. package/dist/guide/introduction.html +10 -10
  81. package/dist/guide/loading.html +11 -11
  82. package/dist/guide/remote-components-migration.html +9 -9
  83. package/dist/hashmap.json +1 -1
  84. package/dist/index.html +9 -9
  85. package/dist/logo.svg +11 -11
  86. package/dist/modules/catalog/antd.html +9 -9
  87. package/dist/modules/catalog/art.html +9 -9
  88. package/dist/modules/catalog/bag.html +9 -9
  89. package/dist/modules/catalog/basic.html +9 -9
  90. package/dist/modules/catalog/core.html +9 -9
  91. package/dist/modules/catalog/datav.html +9 -9
  92. package/dist/modules/catalog/element.html +9 -9
  93. package/dist/modules/catalog/fan.html +9 -9
  94. package/dist/modules/catalog/finance.html +9 -9
  95. package/dist/modules/catalog/iot.html +9 -9
  96. package/dist/modules/catalog/leva.html +9 -9
  97. package/dist/modules/catalog/medical.html +9 -9
  98. package/dist/modules/catalog/picker.html +9 -9
  99. package/dist/modules/catalog/popular.html +9 -9
  100. package/dist/modules/catalog/pure.html +9 -9
  101. package/dist/modules/catalog/qiankun.html +9 -9
  102. package/dist/modules/catalog/station.html +9 -9
  103. package/dist/modules/catalog/tdesign.html +9 -9
  104. package/dist/modules/catalog/tools.html +9 -9
  105. package/dist/modules/catalog/vben.html +9 -9
  106. package/dist/modules/components.html +9 -9
  107. package/dist/modules/demos.html +9 -9
  108. package/dist/modules/docs-and-services.html +10 -10
  109. package/dist/modules/index.html +9 -9
  110. package/dist/modules/libs.html +9 -9
  111. package/dist/modules/templates.html +9 -9
  112. package/package.json +2 -2
  113. package/dist/assets/chunks/@localSearchIndexroot.C_bK2xXO.js +0 -1
  114. package/dist/assets/style.C6SSFbtd.css +0 -1
@@ -1,2 +1,2 @@
1
- const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/chunks/VPLocalSearchBox.Z-GU2mRG.js","assets/chunks/framework.DvDCk5Jp.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 ue,e as m,_ as g,u as Ce,i as He,f as Be,g as de,h as y,j as d,k as i,l as z,m as se,p as S,q as F,s as X,v as U,x as ve,y as fe,z as Ee,A as Fe,F as x,B as A,C as W,D as Y,E as k,G as $e,H as B,I as ye,J as Q,K as G,L as Z,M as De,N as Pe,O as ie,P as Le,Q as Ve,R as ee,S as Oe,U as Ge,V as Ue,W as Se,X as Te,Y as je,Z as ze,$ as We,a0 as Ke,a1 as Re}from"./framework.DvDCk5Jp.js";const qe=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))}}),Je={key:0,class:"VPBackdrop"},Xe=p({__name:"VPBackdrop",props:{show:{type:Boolean}},setup(e){return(t,n)=>(s(),_(ue,{name:"fade"},{default:h(()=>[e.show?(s(),u("div",Je)):m("",!0)]),_:1}))}}),Ye=g(Xe,[["__scopeId","data-v-cbdabefa"]]),L=Ce;function Qe(e,t){let n,a=!1;return()=>{n&&clearTimeout(n),a?n=setTimeout(e,t):(e(),(a=!0)&&setTimeout(()=>a=!1,t))}}function re(e){return e.startsWith("/")?e:`/${e}`}function he(e){const{pathname:t,search:n,hash:a,protocol:o}=new URL(e,"http://a.com");if(He(e)||e.startsWith("#")||!o.startsWith("http")||!Be(t))return e;const{site:r}=L(),l=t.endsWith("/")||t.endsWith(".html")?e:e.replace(/(?:(^\.+)\/)?.*$/,`$1${t.replace(/(\.md)?$/,r.value.cleanUrls?"":".html")}${n}${a}`);return de(l)}function R({correspondingLink:e=!1}={}){const{site:t,localeIndex:n,page:a,theme:o,hash:r}=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:Ze($.link||(f==="root"?"/":`/${f}/`),o.value.i18nRouting!==!1&&e,a.value.relativePath.slice(l.value.link.length-1),!t.value.cleanUrls)+r.value})),currentLang:l}}function Ze(e,t,n,a){return t?e.replace(/\/$/,"")+re(n.replace(/(^|\/)index\.md$/,"$1").replace(/\.md$/,a?".html":"")):e}const et={class:"NotFound"},tt={class:"code"},nt={class:"title"},at={class:"quote"},ot={class:"action"},st=["href","aria-label"],it=p({__name:"NotFound",setup(e){const{theme:t}=L(),{currentLang:n}=R();return(a,o)=>{var r,l,v,f,$;return s(),u("div",et,[d("p",tt,M(((r=i(t).notFound)==null?void 0:r.code)??"404"),1),d("h1",nt,M(((l=i(t).notFound)==null?void 0:l.title)??"PAGE NOT FOUND"),1),o[0]||(o[0]=d("div",{class:"divider"},null,-1)),d("blockquote",at,M(((v=i(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",ot,[d("a",{class:"link",href:i(de)(i(n).link),"aria-label":((f=i(t).notFound)==null?void 0:f.linkLabel)??"go to home"},M((($=i(t).notFound)==null?void 0:$.linkText)??"Take me home"),9,st)])])}}}),rt=g(it,[["__scopeId","data-v-01c77438"]]);function Ne(e,t){if(Array.isArray(e))return q(e);if(e==null)return[];t=re(t);const n=Object.keys(e).sort((o,r)=>r.split("/").length-o.split("/").length).find(o=>t.startsWith(re(o))),a=n?e[n]:[];return Array.isArray(a)?q(a):q(a.items,a.base)}function lt(e){const t=[];let n=0;for(const a in e){const o=e[a];if(o.items){n=t.push(o);continue}t[n]||t.push({items:[]}),t[n].items.push(o)}return t}function ct(e){const t=[];function n(a){for(const o of a)o.text&&o.link&&t.push({text:o.text,link:o.link,docFooterText:o.docFooterText}),o.items&&n(o.items)}return n(e),t}function le(e,t){return Array.isArray(t)?t.some(n=>le(e,n)):z(e,t.link)?!0:t.items?le(e,t.items):!1}function q(e,t){return[...e].map(n=>{const a={...n},o=a.base||t;return o&&a.link&&(a.link=o+a.link),a.items&&(a.items=q(a.items,o)),a})}function D(){const{frontmatter:e,page:t,theme:n}=L(),a=se("(min-width: 960px)"),o=S(!1),r=y(()=>{const w=n.value.sidebar,C=t.value.relativePath;return w?Ne(w,C):[]}),l=S(r.value);F(r,(w,C)=>{JSON.stringify(w)!==JSON.stringify(C)&&(l.value=r.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&&a.value),b=y(()=>v.value?lt(l.value):[]);function P(){o.value=!0}function T(){o.value=!1}function I(){o.value?T():P()}return{isOpen:o,sidebar:l,sidebarGroups:b,hasSidebar:v,hasAside:$,leftAside:f,isSidebarEnabled:V,open:P,close:T,toggle:I}}function ut(e,t){let n;X(()=>{n=e.value?document.activeElement:void 0}),U(()=>{window.addEventListener("keyup",a)}),ve(()=>{window.removeEventListener("keyup",a)});function a(o){o.key==="Escape"&&e.value&&(t(),n==null||n.focus())}}function dt(e){const{page:t,hash:n}=L(),a=S(!1),o=y(()=>e.value.collapsed!=null),r=y(()=>!!e.value.link),l=S(!1),v=()=>{l.value=z(t.value.relativePath,e.value.link)};F([t,e,n],v),U(v);const f=y(()=>l.value?!0:e.value.items?le(t.value.relativePath,e.value.items):!1),$=y(()=>!!(e.value.items&&e.value.items.length));X(()=>{a.value=!!(o.value&&e.value.collapsed)}),fe(()=>{(l.value||f.value)&&(a.value=!1)});function V(){o.value&&(a.value=!a.value)}return{collapsed:a,collapsible:o,isLink:r,isActiveLink:l,hasActiveLink:f,hasChildren:$,toggle:V}}function vt(){const{hasSidebar:e}=D(),t=se("(min-width: 960px)"),n=se("(min-width: 1280px)");return{isAsideEnabled:y(()=>!n.value&&!t.value?!1:e.value?n.value:t.value)}}const ft=/\b(?:VPBadge|header-anchor|footnote-ref|ignore-header)\b/,ce=[];function Me(e){return typeof e.outline=="object"&&!Array.isArray(e.outline)&&e.outline.label||e.outlineTitle||"On this page"}function me(e){const t=[...document.querySelectorAll(".VPDoc :where(h1,h2,h3,h4,h5,h6)")].filter(n=>n.id&&n.hasChildNodes()).map(n=>{const a=Number(n.tagName[1]);return{element:n,title:ht(n),link:"#"+n.id,level:a}});return mt(t,e)}function ht(e){let t="";for(const n of e.childNodes)if(n.nodeType===1){if(ft.test(n.className))continue;t+=n.textContent}else n.nodeType===3&&(t+=n.textContent);return t.trim()}function mt(e,t){if(t===!1)return[];const n=(typeof t=="object"&&!Array.isArray(t)?t.level:t)||2,[a,o]=typeof n=="number"?[n,n]:n==="deep"?[2,6]:n;return _t(e,a,o)}function pt(e,t){const{isAsideEnabled:n}=vt(),a=Qe(r,100);let o=null;U(()=>{requestAnimationFrame(r),window.addEventListener("scroll",a)}),Ee(()=>{l(location.hash)}),ve(()=>{window.removeEventListener("scroll",a)});function r(){if(!n.value)return;const v=window.scrollY,f=window.innerHeight,$=document.body.offsetHeight,V=Math.abs(v+f-$)<1,b=ce.map(({element:T,link:I})=>({link:I,top:kt(T)})).filter(({top:T})=>!Number.isNaN(T)).sort((T,I)=>T.top-I.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:I}of b){if(I>v+Fe()+4)break;P=T}l(P)}function l(v){o&&o.classList.remove("active"),v==null?o=null:o=e.value.querySelector(`a[href="${decodeURIComponent(v)}"]`);const f=o;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 kt(e){let t=0;for(;e!==document.body;){if(e===null)return NaN;t+=e.offsetTop,e=e.offsetParent}return t}function _t(e,t,n){ce.length=0;const a=[],o=[];return e.forEach(r=>{const l={...r,children:[]};let v=o[o.length-1];for(;v&&v.level>=l.level;)o.pop(),v=o[o.length-1];if(l.element.classList.contains("ignore-header")||v&&"shouldIgnore"in v){o.push({level:l.level,shouldIgnore:!0});return}l.level>n||l.level<t||(ce.push({element:l.element,link:l.link}),v?v.children.push(l):a.push(l),o.push(l))}),a}const bt=["href","title"],gt=p({__name:"VPDocOutlineItem",props:{headers:{},root:{type:Boolean}},setup(e){function t({target:n}){const a=n.href.split("#")[1],o=document.getElementById(decodeURIComponent(a));o==null||o.focus({preventScroll:!0})}return(n,a)=>{const o=W("VPDocOutlineItem",!0);return s(),u("ul",{class:N(["VPDocOutlineItem",e.root?"root":"nested"])},[(s(!0),u(x,null,A(e.headers,({children:r,link:l,title:v})=>(s(),u("li",null,[d("a",{class:"outline-link",href:l,onClick:t,title:v},M(v),9,bt),r!=null&&r.length?(s(),_(o,{key:0,headers:r},null,8,["headers"])):m("",!0)]))),256))],2)}}}),xe=g(gt,[["__scopeId","data-v-6b41460f"]]),$t={class:"content"},yt={"aria-level":"2",class:"outline-title",id:"doc-outline-aria-label",role:"heading"},Pt=p({__name:"VPDocAsideOutline",setup(e){const{frontmatter:t,theme:n}=L(),a=$e([]);Y(()=>{a.value=me(t.value.outline??n.value.outline)});const o=S(),r=S();return pt(o,r),(l,v)=>(s(),u("nav",{"aria-labelledby":"doc-outline-aria-label",class:N(["VPDocAsideOutline",{"has-outline":a.value.length>0}]),ref_key:"container",ref:o},[d("div",$t,[d("div",{class:"outline-marker",ref_key:"marker",ref:r},null,512),d("div",yt,M(i(Me)(i(n))),1),k(xe,{headers:a.value,root:!0},null,8,["headers"])])],2))}}),Lt=g(Pt,[["__scopeId","data-v-0d7cf2a5"]]),Vt={class:"VPDocAsideCarbonAds"},St=p({__name:"VPDocAsideCarbonAds",props:{carbonAds:{}},setup(e){const t=()=>null;return(n,a)=>(s(),u("div",Vt,[k(i(t),{"carbon-ads":e.carbonAds},null,8,["carbon-ads"])]))}}),Tt={class:"VPDocAside"},Nt=p({__name:"VPDocAside",setup(e){const{theme:t}=L();return(n,a)=>(s(),u("div",Tt,[c(n.$slots,"aside-top",{},void 0,!0),c(n.$slots,"aside-outline-before",{},void 0,!0),k(Lt),c(n.$slots,"aside-outline-after",{},void 0,!0),a[0]||(a[0]=d("div",{class:"spacer"},null,-1)),c(n.$slots,"aside-ads-before",{},void 0,!0),i(t).carbonAds?(s(),_(St,{key:0,"carbon-ads":i(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)]))}}),Mt=g(Nt,[["__scopeId","data-v-f998ffc2"]]);function xt(){const{theme:e,page:t}=L();return y(()=>{const{text:n="Edit this page",pattern:a=""}=e.value.editLink||{};let o;return typeof a=="function"?o=a(t.value):o=a.replace(/:path/g,t.value.filePath),{url:o,text:n}})}function It(){const{page:e,theme:t,frontmatter:n}=L();return y(()=>{var $,V,b,P,T,I,w,C;const a=Ne(t.value.sidebar,e.value.relativePath),o=ct(a),r=wt(o,H=>H.link.replace(/[?#].*$/,"")),l=r.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=r[l-1])==null?void 0:b.docFooterText)??((P=r[l-1])==null?void 0:P.text),link:(typeof n.value.prev=="object"?n.value.prev.link:void 0)??((T=r[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)??((I=r[l+1])==null?void 0:I.docFooterText)??((w=r[l+1])==null?void 0:w.text),link:(typeof n.value.next=="object"?n.value.next.link:void 0)??((C=r[l+1])==null?void 0:C.link)}}})}function wt(e,t){const n=new Set;return e.filter(a=>{const o=t(a);return n.has(o)?!1:n.add(o)})}const E=p({__name:"VPLink",props:{tag:{},href:{},noIcon:{type:Boolean},target:{},rel:{}},setup(e){const t=e,n=y(()=>t.tag??(t.href?"a":"span")),a=y(()=>t.href&&ye.test(t.href)||t.target==="_blank");return(o,r)=>(s(),_(B(n.value),{class:N(["VPLink",{link:e.href,"vp-external-link-icon":a.value,"no-icon":e.noIcon}]),href:e.href?i(he)(e.href):void 0,target:e.target??(a.value?"_blank":void 0),rel:e.rel??(a.value?"noreferrer":void 0)},{default:h(()=>[c(o.$slots,"default")]),_:3},8,["class","href","target","rel"]))}}),At={class:"VPLastUpdated"},Ct=["datetime"],Ht=p({__name:"VPDocFooterLastUpdated",setup(e){const{theme:t,page:n,lang:a}=L(),o=y(()=>new Date(n.value.lastUpdated)),r=y(()=>o.value.toISOString()),l=S("");return U(()=>{X(()=>{var v,f,$;l.value=new Intl.DateTimeFormat((f=(v=t.value.lastUpdated)==null?void 0:v.formatOptions)!=null&&f.forceLocale?a.value:void 0,(($=t.value.lastUpdated)==null?void 0:$.formatOptions)??{dateStyle:"short",timeStyle:"short"}).format(o.value)})}),(v,f)=>{var $;return s(),u("p",At,[j(M((($=i(t).lastUpdated)==null?void 0:$.text)||i(t).lastUpdatedText||"Last updated")+": ",1),d("time",{datetime:r.value},M(l.value),9,Ct)])}}}),Bt=g(Ht,[["__scopeId","data-v-d44629be"]]),Et={key:0,class:"VPDocFooter"},Ft={key:0,class:"edit-info"},Dt={key:0,class:"edit-link"},Ot={key:1,class:"last-updated"},Gt={key:1,class:"prev-next","aria-labelledby":"doc-footer-aria-label"},Ut={class:"pager"},jt=["innerHTML"],zt=["innerHTML"],Wt={class:"pager"},Kt=["innerHTML"],Rt=["innerHTML"],qt=p({__name:"VPDocFooter",setup(e){const{theme:t,page:n,frontmatter:a}=L(),o=xt(),r=It(),l=y(()=>t.value.editLink&&a.value.editLink!==!1),v=y(()=>n.value.lastUpdated),f=y(()=>l.value||v.value||r.value.prev||r.value.next);return($,V)=>{var b,P,T,I;return f.value?(s(),u("footer",Et,[c($.$slots,"doc-footer-before",{},void 0,!0),l.value||v.value?(s(),u("div",Ft,[l.value?(s(),u("div",Dt,[k(E,{class:"edit-link-button",href:i(o).url,"no-icon":!0},{default:h(()=>[V[0]||(V[0]=d("span",{class:"vpi-square-pen edit-link-icon"},null,-1)),j(" "+M(i(o).text),1)]),_:1},8,["href"])])):m("",!0),v.value?(s(),u("div",Ot,[k(Bt)])):m("",!0)])):m("",!0),(b=i(r).prev)!=null&&b.link||(P=i(r).next)!=null&&P.link?(s(),u("nav",Gt,[V[1]||(V[1]=d("span",{class:"visually-hidden",id:"doc-footer-aria-label"},"Pager",-1)),d("div",Ut,[(T=i(r).prev)!=null&&T.link?(s(),_(E,{key:0,class:"pager-link prev",href:i(r).prev.link},{default:h(()=>{var w;return[d("span",{class:"desc",innerHTML:((w=i(t).docFooter)==null?void 0:w.prev)||"Previous page"},null,8,jt),d("span",{class:"title",innerHTML:i(r).prev.text},null,8,zt)]}),_:1},8,["href"])):m("",!0)]),d("div",Wt,[(I=i(r).next)!=null&&I.link?(s(),_(E,{key:0,class:"pager-link next",href:i(r).next.link},{default:h(()=>{var w;return[d("span",{class:"desc",innerHTML:((w=i(t).docFooter)==null?void 0:w.next)||"Next page"},null,8,Kt),d("span",{class:"title",innerHTML:i(r).next.text},null,8,Rt)]}),_:1},8,["href"])):m("",!0)])])):m("",!0)])):m("",!0)}}}),Jt=g(qt,[["__scopeId","data-v-839c5058"]]),Xt={class:"container"},Yt={class:"aside-container"},Qt={class:"aside-content"},Zt={class:"content"},en={class:"content-container"},tn={class:"main"},nn=p({__name:"VPDoc",setup(e){const{theme:t}=L(),n=Q(),{hasSidebar:a,hasAside:o,leftAside:r}=D(),l=y(()=>n.path.replace(/[./]+/g,"_").replace(/_html$/,""));return(v,f)=>{const $=W("Content");return s(),u("div",{class:N(["VPDoc",{"has-sidebar":i(a),"has-aside":i(o)}])},[c(v.$slots,"doc-top",{},void 0,!0),d("div",Xt,[i(o)?(s(),u("div",{key:0,class:N(["aside",{"left-aside":i(r)}])},[f[0]||(f[0]=d("div",{class:"aside-curtain"},null,-1)),d("div",Yt,[d("div",Qt,[k(Mt,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",Zt,[d("div",en,[c(v.$slots,"doc-before",{},void 0,!0),d("main",tn,[k($,{class:N(["vp-doc",[l.value,i(t).externalLinkIcon&&"external-link-icon-enabled"]])},null,8,["class"])]),k(Jt,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)}}}),an=g(nn,[["__scopeId","data-v-be4efa22"]]),on=p({__name:"VPButton",props:{tag:{},size:{default:"medium"},theme:{default:"brand"},text:{},href:{},target:{},rel:{}},setup(e){const t=e,n=y(()=>t.href&&ye.test(t.href)),a=y(()=>t.tag||(t.href?"a":"button"));return(o,r)=>(s(),_(B(a.value),{class:N(["VPButton",[e.size,e.theme]]),href:e.href?i(he)(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"]))}}),sn=g(on,[["__scopeId","data-v-9af4d9d5"]]),rn=["src","alt"],ln=p({inheritAttrs:!1,__name:"VPImage",props:{image:{},alt:{}},setup(e){return(t,n)=>{const a=W("VPImage",!0);return e.image?(s(),u(x,{key:0},[typeof e.image=="string"||"src"in e.image?(s(),u("img",G({key:0,class:"VPImage"},typeof e.image=="string"?t.$attrs:{...e.image,...t.$attrs},{src:i(de)(typeof e.image=="string"?e.image:e.image.src),alt:e.alt??(typeof e.image=="string"?"":e.image.alt||"")}),null,16,rn)):(s(),u(x,{key:1},[k(a,G({class:"dark",image:e.image.dark,alt:e.image.alt},t.$attrs),null,16,["image","alt"]),k(a,G({class:"light",image:e.image.light,alt:e.image.alt},t.$attrs),null,16,["image","alt"])],64))],64)):m("",!0)}}}),J=g(ln,[["__scopeId","data-v-4a658ba6"]]),cn={class:"container"},un={class:"main"},dn={class:"heading"},vn=["innerHTML"],fn=["innerHTML"],hn=["innerHTML"],mn={key:0,class:"actions"},pn={key:0,class:"image"},kn={class:"image-container"},_n=p({__name:"VPHero",props:{name:{},text:{},tagline:{},image:{},actions:{}},setup(e){const t=Z("hero-image-slot-exists");return(n,a)=>(s(),u("div",{class:N(["VPHero",{"has-image":e.image||i(t)}])},[d("div",cn,[d("div",un,[c(n.$slots,"home-hero-info-before",{},void 0,!0),c(n.$slots,"home-hero-info",{},()=>[d("h1",dn,[e.name?(s(),u("span",{key:0,innerHTML:e.name,class:"name clip"},null,8,vn)):m("",!0),e.text?(s(),u("span",{key:1,innerHTML:e.text,class:"text"},null,8,fn)):m("",!0)]),e.tagline?(s(),u("p",{key:0,innerHTML:e.tagline,class:"tagline"},null,8,hn)):m("",!0)],!0),c(n.$slots,"home-hero-info-after",{},void 0,!0),e.actions?(s(),u("div",mn,[(s(!0),u(x,null,A(e.actions,o=>(s(),u("div",{key:o.link,class:"action"},[k(sn,{tag:"a",size:"medium",theme:o.theme,text:o.text,href:o.link,target:o.target,rel:o.rel},null,8,["theme","text","href","target","rel"])]))),128))])):m("",!0),c(n.$slots,"home-hero-actions-after",{},void 0,!0)]),e.image||i(t)?(s(),u("div",pn,[d("div",kn,[a[0]||(a[0]=d("div",{class:"image-bg"},null,-1)),c(n.$slots,"home-hero-image",{},()=>[e.image?(s(),_(J,{key:0,class:"image-src",image:e.image},null,8,["image"])):m("",!0)],!0)])])):m("",!0)])],2))}}),bn=g(_n,[["__scopeId","data-v-48fa6eb1"]]),gn=p({__name:"VPHomeHero",setup(e){const{frontmatter:t}=L();return(n,a)=>i(t).hero?(s(),_(bn,{key:0,class:"VPHomeHero",name:i(t).hero.name,text:i(t).hero.text,tagline:i(t).hero.tagline,image:i(t).hero.image,actions:i(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)}}),$n={class:"box"},yn={key:0,class:"icon"},Pn=["innerHTML"],Ln=["innerHTML"],Vn=["innerHTML"],Sn={key:4,class:"link-text"},Tn={class:"link-text-value"},Nn=p({__name:"VPFeature",props:{icon:{},title:{},details:{},link:{},linkText:{},rel:{},target:{}},setup(e){return(t,n)=>(s(),_(E,{class:"VPFeature",href:e.link,rel:e.rel,target:e.target,"no-icon":!0,tag:e.link?"a":"div"},{default:h(()=>[d("article",$n,[typeof e.icon=="object"&&e.icon.wrap?(s(),u("div",yn,[k(J,{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(),_(J,{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,Pn)):m("",!0),d("h2",{class:"title",innerHTML:e.title},null,8,Ln),e.details?(s(),u("p",{key:3,class:"details",innerHTML:e.details},null,8,Vn)):m("",!0),e.linkText?(s(),u("div",Sn,[d("p",Tn,[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"]))}}),Mn=g(Nn,[["__scopeId","data-v-779b8eb0"]]),xn={key:0,class:"VPFeatures"},In={class:"container"},wn={class:"items"},An=p({__name:"VPFeatures",props:{features:{}},setup(e){const t=e,n=y(()=>{const a=t.features.length;if(a){if(a===2)return"grid-2";if(a===3)return"grid-3";if(a%3===0)return"grid-6";if(a>3)return"grid-4"}else return});return(a,o)=>e.features?(s(),u("div",xn,[d("div",In,[d("div",wn,[(s(!0),u(x,null,A(e.features,r=>(s(),u("div",{key:r.title,class:N(["item",[n.value]])},[k(Mn,{icon:r.icon,title:r.title,details:r.details,link:r.link,"link-text":r.linkText,rel:r.rel,target:r.target},null,8,["icon","title","details","link","link-text","rel","target"])],2))),128))])])])):m("",!0)}}),Cn=g(An,[["__scopeId","data-v-3ab5c7c9"]]),Hn=p({__name:"VPHomeFeatures",setup(e){const{frontmatter:t}=L();return(n,a)=>i(t).features?(s(),_(Cn,{key:0,class:"VPHomeFeatures",features:i(t).features},null,8,["features"])):m("",!0)}}),Bn=p({__name:"VPHomeContent",setup(e){const{width:t}=De({initialWidth:0,includeScrollbar:!1});return(n,a)=>(s(),u("div",{class:"vp-doc container",style:Pe(i(t)?{"--vp-offset":`calc(50% - ${i(t)/2}px)`}:{})},[c(n.$slots,"default",{},void 0,!0)],4))}}),En=g(Bn,[["__scopeId","data-v-9b3bd41d"]]),Fn=p({__name:"VPHome",setup(e){const{frontmatter:t,theme:n}=L();return(a,o)=>{const r=W("Content");return s(),u("div",{class:N(["VPHome",{"external-link-icon-enabled":i(n).externalLinkIcon}])},[c(a.$slots,"home-hero-before",{},void 0,!0),k(gn,null,{"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)]),_:3}),c(a.$slots,"home-hero-after",{},void 0,!0),c(a.$slots,"home-features-before",{},void 0,!0),k(Hn),c(a.$slots,"home-features-after",{},void 0,!0),i(t).markdownStyles!==!1?(s(),_(En,{key:0},{default:h(()=>[k(r)]),_:1})):(s(),_(r,{key:1}))],2)}}}),Dn=g(Fn,[["__scopeId","data-v-970c9ea4"]]),On={},Gn={class:"VPPage"};function Un(e,t){const n=W("Content");return s(),u("div",Gn,[c(e.$slots,"page-top"),k(n),c(e.$slots,"page-bottom")])}const jn=g(On,[["render",Un]]),zn=p({__name:"VPContent",setup(e){const{page:t,frontmatter:n}=L(),{hasSidebar:a}=D();return(o,r)=>(s(),u("div",{class:N(["VPContent",{"has-sidebar":i(a),"is-home":i(n).layout==="home"}]),id:"VPContent"},[i(t).isNotFound?c(o.$slots,"not-found",{},()=>[k(rt)],!0,0):i(n).layout==="page"?(s(),_(jn,{key:1},{"page-top":h(()=>[c(o.$slots,"page-top",{},void 0,!0)]),"page-bottom":h(()=>[c(o.$slots,"page-bottom",{},void 0,!0)]),_:3})):i(n).layout==="home"?(s(),_(Dn,{key:2},{"home-hero-before":h(()=>[c(o.$slots,"home-hero-before",{},void 0,!0)]),"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)]),"home-hero-after":h(()=>[c(o.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":h(()=>[c(o.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":h(()=>[c(o.$slots,"home-features-after",{},void 0,!0)]),_:3})):i(n).layout&&i(n).layout!=="doc"?(s(),_(B(i(n).layout),{key:3})):(s(),_(an,{key:4},{"doc-top":h(()=>[c(o.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":h(()=>[c(o.$slots,"doc-bottom",{},void 0,!0)]),"doc-footer-before":h(()=>[c(o.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":h(()=>[c(o.$slots,"doc-before",{},void 0,!0)]),"doc-after":h(()=>[c(o.$slots,"doc-after",{},void 0,!0)]),"aside-top":h(()=>[c(o.$slots,"aside-top",{},void 0,!0)]),"aside-outline-before":h(()=>[c(o.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":h(()=>[c(o.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":h(()=>[c(o.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":h(()=>[c(o.$slots,"aside-ads-after",{},void 0,!0)]),"aside-bottom":h(()=>[c(o.$slots,"aside-bottom",{},void 0,!0)]),_:3}))],2))}}),Wn=g(zn,[["__scopeId","data-v-9b7b2129"]]),Kn={class:"container"},Rn=["innerHTML"],qn=["innerHTML"],Jn=p({__name:"VPFooter",setup(e){const{theme:t,frontmatter:n}=L(),{hasSidebar:a}=D();return(o,r)=>i(t).footer&&i(n).footer!==!1?(s(),u("footer",{key:0,class:N(["VPFooter",{"has-sidebar":i(a)}])},[d("div",Kn,[i(t).footer.message?(s(),u("p",{key:0,class:"message",innerHTML:i(t).footer.message},null,8,Rn)):m("",!0),i(t).footer.copyright?(s(),u("p",{key:1,class:"copyright",innerHTML:i(t).footer.copyright},null,8,qn)):m("",!0)])],2)):m("",!0)}}),Xn=g(Jn,[["__scopeId","data-v-ef238f81"]]);function Yn(){const{theme:e,frontmatter:t}=L(),n=$e([]),a=y(()=>n.value.length>0);return Y(()=>{n.value=me(t.value.outline??e.value.outline)}),{headers:n,hasLocalNav:a}}const Qn={class:"menu-text"},Zn={class:"header"},ea={class:"outline"},ta=p({__name:"VPLocalNavOutlineDropdown",props:{headers:{},navHeight:{}},setup(e){const t=e,{theme:n}=L(),a=S(!1),o=S(0),r=S(),l=S();function v(b){var P;(P=r.value)!=null&&P.contains(b.target)||(a.value=!1)}F(a,b=>{if(b){document.addEventListener("click",v);return}document.removeEventListener("click",v)}),ie("Escape",()=>{a.value=!1}),Y(()=>{a.value=!1});function f(){a.value=!a.value,o.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"),Le(()=>{a.value=!1}))}function V(){a.value=!1,window.scrollTo({top:0,left:0,behavior:"smooth"})}return(b,P)=>(s(),u("div",{class:"VPLocalNavOutlineDropdown",style:Pe({"--vp-vh":o.value+"px"}),ref_key:"main",ref:r},[e.headers.length>0?(s(),u("button",{key:0,onClick:f,class:N({open:a.value})},[d("span",Qn,M(i(Me)(i(n))),1),P[0]||(P[0]=d("span",{class:"vpi-chevron-right icon"},null,-1))],2)):(s(),u("button",{key:1,onClick:V},M(i(n).returnToTopLabel||"Return to top"),1)),k(ue,{name:"flyout"},{default:h(()=>[a.value?(s(),u("div",{key:0,ref_key:"items",ref:l,class:"items",onClick:$},[d("div",Zn,[d("a",{class:"top-link",href:"#",onClick:V},M(i(n).returnToTopLabel||"Return to top"),1)]),d("div",ea,[k(xe,{headers:e.headers},null,8,["headers"])])],512)):m("",!0)]),_:1})],4))}}),na=g(ta,[["__scopeId","data-v-5482fd1e"]]),aa={class:"container"},oa=["aria-expanded"],sa={class:"menu-text"},ia=p({__name:"VPLocalNav",props:{open:{type:Boolean}},emits:["open-menu"],setup(e){const{theme:t,frontmatter:n}=L(),{hasSidebar:a}=D(),{headers:o}=Yn(),{y:r}=Ve(),l=S(0);U(()=>{l.value=parseInt(getComputedStyle(document.documentElement).getPropertyValue("--vp-nav-height"))}),Y(()=>{o.value=me(n.value.outline??t.value.outline)});const v=y(()=>o.value.length===0),f=y(()=>v.value&&!a.value),$=y(()=>({VPLocalNav:!0,"has-sidebar":a.value,empty:v.value,fixed:f.value}));return(V,b)=>i(n).layout!=="home"&&(!f.value||i(r)>=l.value)?(s(),u("div",{key:0,class:N($.value)},[d("div",aa,[i(a)?(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",sa,M(i(t).sidebarMenuLabel||"Menu"),1)],8,oa)):m("",!0),k(na,{headers:i(o),navHeight:l.value},null,8,["headers","navHeight"])])],2)):m("",!0)}}),ra=g(ia,[["__scopeId","data-v-db4e71d3"]]);function la(){const e=S(!1);function t(){e.value=!0,window.addEventListener("resize",o)}function n(){e.value=!1,window.removeEventListener("resize",o)}function a(){e.value?n():t()}function o(){window.outerWidth>=768&&n()}const r=Q();return F(()=>r.path,n),{isScreenOpen:e,openScreen:t,closeScreen:n,toggleScreen:a}}const ca={},ua={class:"VPSwitch",type:"button",role:"switch"},da={class:"check"},va={key:0,class:"icon"};function fa(e,t){return s(),u("button",ua,[d("span",da,[e.$slots.default?(s(),u("span",va,[c(e.$slots,"default",{},void 0,!0)])):m("",!0)])])}const ha=g(ca,[["render",fa],["__scopeId","data-v-f7422736"]]),ma=p({__name:"VPSwitchAppearance",setup(e){const{isDark:t,theme:n}=L(),a=Z("toggle-appearance",()=>{t.value=!t.value}),o=S("");return fe(()=>{o.value=t.value?n.value.lightModeSwitchTitle||"Switch to light theme":n.value.darkModeSwitchTitle||"Switch to dark theme"}),(r,l)=>(s(),_(ha,{title:o.value,class:"VPSwitchAppearance","aria-checked":i(t),onClick:i(a)},{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"]))}}),pe=g(ma,[["__scopeId","data-v-a72aa556"]]),pa={key:0,class:"VPNavBarAppearance"},ka=p({__name:"VPNavBarAppearance",setup(e){const{site:t}=L();return(n,a)=>i(t).appearance&&i(t).appearance!=="force-dark"&&i(t).appearance!=="force-auto"?(s(),u("div",pa,[k(pe)])):m("",!0)}}),_a=g(ka,[["__scopeId","data-v-3ade31e0"]]),ke=S();let Ie=!1,oe=0;function ba(e){const t=S(!1);if(ee){!Ie&&ga(),oe++;const n=F(ke,a=>{var o,r,l;a===e.el.value||(o=e.el.value)!=null&&o.contains(a)?(t.value=!0,(r=e.onFocus)==null||r.call(e)):(t.value=!1,(l=e.onBlur)==null||l.call(e))});ve(()=>{n(),oe--,oe||$a()})}return Oe(t)}function ga(){document.addEventListener("focusin",we),Ie=!0,ke.value=document.activeElement}function $a(){document.removeEventListener("focusin",we)}function we(){ke.value=document.activeElement}const ya={class:"VPMenuLink"},Pa=["innerHTML"],La=p({__name:"VPMenuLink",props:{item:{}},setup(e){const{page:t}=L();return(n,a)=>(s(),u("div",ya,[k(E,{class:N({active:i(z)(i(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,Pa)]),_:1},8,["class","href","target","rel","no-icon"])]))}}),te=g(La,[["__scopeId","data-v-0e20c28c"]]),Va={class:"VPMenuGroup"},Sa={key:0,class:"title"},Ta=p({__name:"VPMenuGroup",props:{text:{},items:{}},setup(e){return(t,n)=>(s(),u("div",Va,[e.text?(s(),u("p",Sa,M(e.text),1)):m("",!0),(s(!0),u(x,null,A(e.items,a=>(s(),u(x,null,["link"in a?(s(),_(te,{key:0,item:a},null,8,["item"])):m("",!0)],64))),256))]))}}),Na=g(Ta,[["__scopeId","data-v-740d7c62"]]),Ma={class:"VPMenu"},xa={key:0,class:"items"},Ia=p({__name:"VPMenu",props:{items:{}},setup(e){return(t,n)=>(s(),u("div",Ma,[e.items?(s(),u("div",xa,[(s(!0),u(x,null,A(e.items,a=>(s(),u(x,{key:JSON.stringify(a)},["link"in a?(s(),_(te,{key:0,item:a},null,8,["item"])):"component"in a?(s(),_(B(a.component),G({key:1,ref_for:!0},a.props),null,16)):(s(),_(Na,{key:2,text:a.text,items:a.items},null,8,["text","items"]))],64))),128))])):m("",!0),c(t.$slots,"default",{},void 0,!0)]))}}),wa=g(Ia,[["__scopeId","data-v-1ac967ae"]]),Aa=["aria-expanded","aria-label"],Ca={key:0,class:"text"},Ha=["innerHTML"],Ba={key:1,class:"vpi-more-horizontal icon"},Ea={class:"menu"},Fa=p({__name:"VPFlyout",props:{icon:{},button:{},label:{},items:{}},setup(e){const t=S(!1),n=S();ba({el:n,onBlur:a});function a(){t.value=!1}return(o,r)=>(s(),u("div",{class:"VPFlyout",ref_key:"el",ref:n,onMouseenter:r[1]||(r[1]=l=>t.value=!0),onMouseleave:r[2]||(r[2]=l=>t.value=!1)},[d("button",{type:"button",class:"button","aria-haspopup":"true","aria-expanded":t.value,"aria-label":e.label,onClick:r[0]||(r[0]=l=>t.value=!t.value)},[e.button||e.icon?(s(),u("span",Ca,[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,Ha)):m("",!0),r[3]||(r[3]=d("span",{class:"vpi-chevron-down text-icon"},null,-1))])):(s(),u("span",Ba))],8,Aa),d("div",Ea,[k(wa,{items:e.items},{default:h(()=>[c(o.$slots,"default",{},void 0,!0)]),_:3},8,["items"])])],544))}}),_e=g(Fa,[["__scopeId","data-v-4beed614"]]),Da=["href","aria-label","innerHTML"],Oa=p({__name:"VPSocialLink",props:{icon:{},link:{},ariaLabel:{}},setup(e){const t=e,n=S();U(async()=>{var r;await Le();const o=(r=n.value)==null?void 0:r.children[0];o instanceof HTMLElement&&o.className.startsWith("vpi-social-")&&(getComputedStyle(o).maskImage||getComputedStyle(o).webkitMaskImage)==="none"&&o.style.setProperty("--icon",`url('https://api.iconify.design/simple-icons/${t.icon}.svg')`)});const a=y(()=>typeof t.icon=="object"?t.icon.svg:`<span class="vpi-social-${t.icon}"></span>`);return(o,r)=>(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:a.value},null,8,Da))}}),Ga=g(Oa,[["__scopeId","data-v-143b8c56"]]),Ua={class:"VPSocialLinks"},ja=p({__name:"VPSocialLinks",props:{links:{}},setup(e){return(t,n)=>(s(),u("div",Ua,[(s(!0),u(x,null,A(e.links,({link:a,icon:o,ariaLabel:r})=>(s(),_(Ga,{key:a,icon:o,link:a,ariaLabel:r},null,8,["icon","link","ariaLabel"]))),128))]))}}),be=g(ja,[["__scopeId","data-v-c961277f"]]),za={key:0,class:"group translations"},Wa={class:"trans-title"},Ka={key:1,class:"group"},Ra={class:"item appearance"},qa={class:"label"},Ja={class:"appearance-action"},Xa={key:2,class:"group"},Ya={class:"item social-links"},Qa=p({__name:"VPNavBarExtra",setup(e){const{site:t,theme:n}=L(),{localeLinks:a,currentLang:o}=R({correspondingLink:!0}),r=y(()=>a.value.length&&o.value.label||t.value.appearance||n.value.socialLinks);return(l,v)=>r.value?(s(),_(_e,{key:0,class:"VPNavBarExtra",label:"extra navigation"},{default:h(()=>[i(a).length&&i(o).label?(s(),u("div",za,[d("p",Wa,M(i(o).label),1),(s(!0),u(x,null,A(i(a),f=>(s(),_(te,{key:f.link,item:f},null,8,["item"]))),128))])):m("",!0),i(t).appearance&&i(t).appearance!=="force-dark"&&i(t).appearance!=="force-auto"?(s(),u("div",Ka,[d("div",Ra,[d("p",qa,M(i(n).darkModeSwitchLabel||"Appearance"),1),d("div",Ja,[k(pe)])])])):m("",!0),i(n).socialLinks?(s(),u("div",Xa,[d("div",Ya,[k(be,{class:"social-links-list",links:i(n).socialLinks},null,8,["links"])])])):m("",!0)]),_:1})):m("",!0)}}),Za=g(Qa,[["__scopeId","data-v-a0060c18"]]),eo=["aria-expanded"],to=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]=a=>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,eo))}}),no=g(to,[["__scopeId","data-v-da85dfe0"]]),ao=["innerHTML"],oo=p({__name:"VPNavBarMenuLink",props:{item:{}},setup(e){const{page:t}=L();return(n,a)=>(s(),_(E,{class:N({VPNavBarMenuLink:!0,active:i(z)(i(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,ao)]),_:1},8,["class","href","target","rel","no-icon"]))}}),so=g(oo,[["__scopeId","data-v-2a6af2e3"]]),io=p({__name:"VPNavBarMenuGroup",props:{item:{}},setup(e){const t=e,{page:n}=L(),a=r=>"component"in r?!1:"link"in r?z(n.value.relativePath,r.link,!!t.item.activeMatch):r.items.some(a),o=y(()=>a(t.item));return(r,l)=>(s(),_(_e,{class:N({VPNavBarMenuGroup:!0,active:i(z)(i(n).relativePath,e.item.activeMatch,!!e.item.activeMatch)||o.value}),button:e.item.text,items:e.item.items},null,8,["class","button","items"]))}}),ro={key:0,"aria-labelledby":"main-nav-aria-label",class:"VPNavBarMenu"},lo=p({__name:"VPNavBarMenu",setup(e){const{theme:t}=L();return(n,a)=>i(t).nav?(s(),u("nav",ro,[a[0]||(a[0]=d("span",{id:"main-nav-aria-label",class:"visually-hidden"}," Main Navigation ",-1)),(s(!0),u(x,null,A(i(t).nav,o=>(s(),u(x,{key:JSON.stringify(o)},["link"in o?(s(),_(so,{key:0,item:o},null,8,["item"])):"component"in o?(s(),_(B(o.component),G({key:1,ref_for:!0},o.props),null,16)):(s(),_(io,{key:2,item:o},null,8,["item"]))],64))),128))])):m("",!0)}}),co=g(lo,[["__scopeId","data-v-332e24b2"]]);function uo(e){const{localeIndex:t,theme:n}=L();function a(o){var I,w,C;const r=o.split("."),l=(I=n.value.search)==null?void 0:I.options,v=l&&typeof l=="object",f=v&&((C=(w=l.locales)==null?void 0:w[t.value])==null?void 0:C.translations)||null,$=v&&l.translations||null;let V=f,b=$,P=e;const T=r.pop();for(const H of r){let O=null;const K=P==null?void 0:P[H];K&&(O=P=K);const ne=b==null?void 0:b[H];ne&&(O=b=ne);const ae=V==null?void 0:V[H];ae&&(O=V=ae),K||(P=O),ne||(b=O),ae||(V=O)}return(V==null?void 0:V[T])??(b==null?void 0:b[T])??(P==null?void 0:P[T])??""}return a}const vo=["aria-label"],fo={class:"DocSearch-Button-Container"},ho={class:"DocSearch-Button-Placeholder"},ge=p({__name:"VPNavBarSearchButton",setup(e){const n=uo({button:{buttonText:"Search",buttonAriaLabel:"Search"}});return(a,o)=>(s(),u("button",{type:"button",class:"DocSearch DocSearch-Button","aria-label":i(n)("button.buttonAriaLabel")},[d("span",fo,[o[0]||(o[0]=d("span",{class:"vp-icon DocSearch-Search-Icon"},null,-1)),d("span",ho,M(i(n)("button.buttonText")),1)]),o[1]||(o[1]=d("span",{class:"DocSearch-Button-Keys"},[d("kbd",{class:"DocSearch-Button-Key"}),d("kbd",{class:"DocSearch-Button-Key"},"K")],-1))],8,vo))}}),mo={class:"VPNavBarSearch"},po={id:"local-search"},ko={key:1,id:"docsearch"},_o=p({__name:"VPNavBarSearch",setup(e){const t=Ge(()=>Ue(()=>import("./VPLocalSearchBox.Z-GU2mRG.js"),__vite__mapDeps([0,1]))),n=()=>null,{theme:a}=L(),o=S(!1),r=S(!1);U(()=>{});function l(){o.value||(o.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);ie("k",b=>{(b.ctrlKey||b.metaKey)&&(b.preventDefault(),$.value=!0)}),ie("/",b=>{f(b)||(b.preventDefault(),$.value=!0)});const V="local";return(b,P)=>{var T;return s(),u("div",mo,[i(V)==="local"?(s(),u(x,{key:0},[$.value?(s(),_(i(t),{key:0,onClose:P[0]||(P[0]=I=>$.value=!1)})):m("",!0),d("div",po,[k(ge,{onClick:P[1]||(P[1]=I=>$.value=!0)})])],64)):i(V)==="algolia"?(s(),u(x,{key:1},[o.value?(s(),_(i(n),{key:0,algolia:((T=i(a).search)==null?void 0:T.options)??i(a).algolia,onVnodeBeforeMount:P[2]||(P[2]=I=>r.value=!0)},null,8,["algolia"])):m("",!0),r.value?m("",!0):(s(),u("div",ko,[k(ge,{onClick:l})]))],64)):m("",!0)])}}}),bo=p({__name:"VPNavBarSocialLinks",setup(e){const{theme:t}=L();return(n,a)=>i(t).socialLinks?(s(),_(be,{key:0,class:"VPNavBarSocialLinks",links:i(t).socialLinks},null,8,["links"])):m("",!0)}}),go=g(bo,[["__scopeId","data-v-8b2782df"]]),$o=["href","rel","target"],yo=["innerHTML"],Po={key:2},Lo=p({__name:"VPNavBarTitle",setup(e){const{site:t,theme:n}=L(),{hasSidebar:a}=D(),{currentLang:o}=R(),r=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":i(a)}])},[d("a",{class:"title",href:r.value??i(he)(i(o).link),rel:l.value,target:v.value},[c(f.$slots,"nav-bar-title-before",{},void 0,!0),i(n).logo?(s(),_(J,{key:0,class:"logo",image:i(n).logo},null,8,["image"])):m("",!0),i(n).siteTitle?(s(),u("span",{key:1,innerHTML:i(n).siteTitle},null,8,yo)):i(n).siteTitle===void 0?(s(),u("span",Po,M(i(t).title),1)):m("",!0),c(f.$slots,"nav-bar-title-after",{},void 0,!0)],8,$o)],2))}}),Vo=g(Lo,[["__scopeId","data-v-2a0e2186"]]),So={class:"items"},To={class:"title"},No=p({__name:"VPNavBarTranslations",setup(e){const{theme:t}=L(),{localeLinks:n,currentLang:a}=R({correspondingLink:!0});return(o,r)=>i(n).length&&i(a).label?(s(),_(_e,{key:0,class:"VPNavBarTranslations",icon:"vpi-languages",label:i(t).langMenuLabel||"Change language"},{default:h(()=>[d("div",So,[d("p",To,M(i(a).label),1),(s(!0),u(x,null,A(i(n),l=>(s(),_(te,{key:l.link,item:l},null,8,["item"]))),128))])]),_:1},8,["label"])):m("",!0)}}),Mo=g(No,[["__scopeId","data-v-decc3d7f"]]),xo={class:"wrapper"},Io={class:"container"},wo={class:"title"},Ao={class:"content"},Co={class:"content-body"},Ho=p({__name:"VPNavBar",props:{isScreenOpen:{type:Boolean}},emits:["toggle-screen"],setup(e){const t=e,{y:n}=Ve(),{hasSidebar:a}=D(),{frontmatter:o}=L(),r=S({});return fe(()=>{r.value={"has-sidebar":a.value,home:o.value.layout==="home",top:n.value===0,"screen-open":t.isScreenOpen}}),(l,v)=>(s(),u("div",{class:N(["VPNavBar",r.value])},[d("div",xo,[d("div",Io,[d("div",wo,[k(Vo,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",Ao,[d("div",Co,[c(l.$slots,"nav-bar-content-before",{},void 0,!0),k(_o,{class:"search"}),k(co,{class:"menu"}),k(Mo,{class:"translations"}),k(_a,{class:"appearance"}),k(go,{class:"social-links"}),k(Za,{class:"extra"}),c(l.$slots,"nav-bar-content-after",{},void 0,!0),k(no,{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))}}),Bo=g(Ho,[["__scopeId","data-v-ace07cb7"]]),Eo={key:0,class:"VPNavScreenAppearance"},Fo={class:"text"},Do=p({__name:"VPNavScreenAppearance",setup(e){const{site:t,theme:n}=L();return(a,o)=>i(t).appearance&&i(t).appearance!=="force-dark"&&i(t).appearance!=="force-auto"?(s(),u("div",Eo,[d("p",Fo,M(i(n).darkModeSwitchLabel||"Appearance"),1),k(pe)])):m("",!0)}}),Oo=g(Do,[["__scopeId","data-v-c1808109"]]),Go=["innerHTML"],Uo=p({__name:"VPNavScreenMenuLink",props:{item:{}},setup(e){const t=Z("close-screen");return(n,a)=>(s(),_(E,{class:"VPNavScreenMenuLink",href:e.item.link,target:e.item.target,rel:e.item.rel,"no-icon":e.item.noIcon,onClick:i(t)},{default:h(()=>[d("span",{innerHTML:e.item.text},null,8,Go)]),_:1},8,["href","target","rel","no-icon","onClick"]))}}),jo=g(Uo,[["__scopeId","data-v-14b842cb"]]),zo=["innerHTML"],Wo=p({__name:"VPNavScreenMenuGroupLink",props:{item:{}},setup(e){const t=Z("close-screen");return(n,a)=>(s(),_(E,{class:"VPNavScreenMenuGroupLink",href:e.item.link,target:e.item.target,rel:e.item.rel,"no-icon":e.item.noIcon,onClick:i(t)},{default:h(()=>[d("span",{innerHTML:e.item.text},null,8,zo)]),_:1},8,["href","target","rel","no-icon","onClick"]))}}),Ae=g(Wo,[["__scopeId","data-v-abda698e"]]),Ko={class:"VPNavScreenMenuGroupSection"},Ro={key:0,class:"title"},qo=p({__name:"VPNavScreenMenuGroupSection",props:{text:{},items:{}},setup(e){return(t,n)=>(s(),u("div",Ko,[e.text?(s(),u("p",Ro,M(e.text),1)):m("",!0),(s(!0),u(x,null,A(e.items,a=>(s(),_(Ae,{key:a.text,item:a},null,8,["item"]))),128))]))}}),Jo=g(qo,[["__scopeId","data-v-b68092a9"]]),Xo=["aria-controls","aria-expanded"],Yo=["innerHTML"],Qo=["id"],Zo={key:0,class:"item"},es={key:1,class:"item"},ts={key:2,class:"group"},ns=p({__name:"VPNavScreenMenuGroup",props:{text:{},items:{}},setup(e){const t=e,n=S(!1),a=y(()=>`NavScreenGroup-${t.text.replace(" ","-").toLowerCase()}`);function o(){n.value=!n.value}return(r,l)=>(s(),u("div",{class:N(["VPNavScreenMenuGroup",{open:n.value}])},[d("button",{class:"button","aria-controls":a.value,"aria-expanded":n.value,onClick:o},[d("span",{class:"button-text",innerHTML:e.text},null,8,Yo),l[0]||(l[0]=d("span",{class:"vpi-plus button-icon"},null,-1))],8,Xo),d("div",{id:a.value,class:"items"},[(s(!0),u(x,null,A(e.items,v=>(s(),u(x,{key:JSON.stringify(v)},["link"in v?(s(),u("div",Zo,[k(Ae,{item:v},null,8,["item"])])):"component"in v?(s(),u("div",es,[(s(),_(B(v.component),G({ref_for:!0},v.props,{"screen-menu":""}),null,16))])):(s(),u("div",ts,[k(Jo,{text:v.text,items:v.items},null,8,["text","items"])]))],64))),128))],8,Qo)],2))}}),as=g(ns,[["__scopeId","data-v-d61f08b3"]]),os={key:0,class:"VPNavScreenMenu"},ss=p({__name:"VPNavScreenMenu",setup(e){const{theme:t}=L();return(n,a)=>i(t).nav?(s(),u("nav",os,[(s(!0),u(x,null,A(i(t).nav,o=>(s(),u(x,{key:JSON.stringify(o)},["link"in o?(s(),_(jo,{key:0,item:o},null,8,["item"])):"component"in o?(s(),_(B(o.component),G({key:1,ref_for:!0},o.props,{"screen-menu":""}),null,16)):(s(),_(as,{key:2,text:o.text||"",items:o.items},null,8,["text","items"]))],64))),128))])):m("",!0)}}),is=p({__name:"VPNavScreenSocialLinks",setup(e){const{theme:t}=L();return(n,a)=>i(t).socialLinks?(s(),_(be,{key:0,class:"VPNavScreenSocialLinks",links:i(t).socialLinks},null,8,["links"])):m("",!0)}}),rs={class:"list"},ls=p({__name:"VPNavScreenTranslations",setup(e){const{localeLinks:t,currentLang:n}=R({correspondingLink:!0}),a=S(!1);function o(){a.value=!a.value}return(r,l)=>i(t).length&&i(n).label?(s(),u("div",{key:0,class:N(["VPNavScreenTranslations",{open:a.value}])},[d("button",{class:"title",onClick:o},[l[0]||(l[0]=d("span",{class:"vpi-languages icon lang"},null,-1)),j(" "+M(i(n).label)+" ",1),l[1]||(l[1]=d("span",{class:"vpi-chevron-down icon chevron"},null,-1))]),d("ul",rs,[(s(!0),u(x,null,A(i(t),v=>(s(),u("li",{key:v.link,class:"item"},[k(E,{class:"link",href:v.link},{default:h(()=>[j(M(v.text),1)]),_:2},1032,["href"])]))),128))])],2)):m("",!0)}}),cs=g(ls,[["__scopeId","data-v-aceb9f6a"]]),us={class:"container"},ds=p({__name:"VPNavScreen",props:{open:{type:Boolean}},setup(e){const t=S(null),n=Se(ee?document.body:null);return(a,o)=>(s(),_(ue,{name:"fade",onEnter:o[0]||(o[0]=r=>n.value=!0),onAfterLeave:o[1]||(o[1]=r=>n.value=!1)},{default:h(()=>[e.open?(s(),u("div",{key:0,class:"VPNavScreen",ref_key:"screen",ref:t,id:"VPNavScreen"},[d("div",us,[c(a.$slots,"nav-screen-content-before",{},void 0,!0),k(ss,{class:"menu"}),k(cs,{class:"translations"}),k(Oo,{class:"appearance"}),k(is,{class:"social-links"}),c(a.$slots,"nav-screen-content-after",{},void 0,!0)])],512)):m("",!0)]),_:3}))}}),vs=g(ds,[["__scopeId","data-v-d142b7e1"]]),fs={key:0,class:"VPNav"},hs=p({__name:"VPNav",setup(e){const{isScreenOpen:t,closeScreen:n,toggleScreen:a}=la(),{frontmatter:o}=L(),r=y(()=>o.value.navbar!==!1);return Te("close-screen",n),X(()=>{ee&&document.documentElement.classList.toggle("hide-nav",!r.value)}),(l,v)=>r.value?(s(),u("header",fs,[k(Bo,{"is-screen-open":i(t),onToggleScreen:i(a)},{"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(vs,{open:i(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)}}),ms=g(hs,[["__scopeId","data-v-32bdb076"]]),ps=["role","tabindex"],ks={key:1,class:"items"},_s=p({__name:"VPSidebarItem",props:{item:{},depth:{}},setup(e){const t=e,{collapsed:n,collapsible:a,isLink:o,isActiveLink:r,hasActiveLink:l,hasChildren:v,toggle:f}=dt(y(()=>t.item)),$=y(()=>v.value?"section":"div"),V=y(()=>o.value?"a":"div"),b=y(()=>v.value?t.depth+2===7?"p":`h${t.depth+2}`:"p"),P=y(()=>o.value?void 0:"button"),T=y(()=>[[`level-${t.depth}`],{collapsible:a.value},{collapsed:n.value},{"is-link":o.value},{"is-active":r.value},{"has-active":l.value}]);function I(C){"key"in C&&C.key!=="Enter"||!t.item.link&&f()}function w(){t.item.link&&f()}return(C,H)=>{const O=W("VPSidebarItem",!0);return s(),_(B($.value),{class:N(["VPSidebarItem",T.value])},{default:h(()=>[e.item.text?(s(),u("div",G({key:0,class:"item",role:P.value},je(e.item.items?{click:I,keydown:I}:{},!0),{tabindex:e.item.items&&0}),[H[1]||(H[1]=d("div",{class:"indicator"},null,-1)),e.item.link?(s(),_(E,{key:0,tag:V.value,class:"link",href:e.item.link,rel:e.item.rel,target:e.item.target},{default:h(()=>[(s(),_(B(b.value),{class:"text",innerHTML:e.item.text},null,8,["innerHTML"]))]),_:1},8,["tag","href","rel","target"])):(s(),_(B(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:w,onKeydown:ze(w,["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",ks,[e.depth<5?(s(!0),u(x,{key:0},A(e.item.items,K=>(s(),_(O,{key:K.text,item:K,depth:e.depth+1},null,8,["item","depth"]))),128)):m("",!0)])):m("",!0)]),_:1},8,["class"])}}}),bs=g(_s,[["__scopeId","data-v-2a2cc58a"]]),gs=p({__name:"VPSidebarGroup",props:{items:{}},setup(e){const t=S(!0);let n=null;return U(()=>{n=setTimeout(()=>{n=null,t.value=!1},300)}),We(()=>{n!=null&&(clearTimeout(n),n=null)}),(a,o)=>(s(!0),u(x,null,A(e.items,r=>(s(),u("div",{key:r.text,class:N(["group",{"no-transition":t.value}])},[k(bs,{item:r,depth:0},null,8,["item"])],2))),128))}}),$s=g(gs,[["__scopeId","data-v-cf197235"]]),ys={class:"nav",id:"VPSidebarNav","aria-labelledby":"sidebar-aria-label",tabindex:"-1"},Ps=p({__name:"VPSidebar",props:{open:{type:Boolean}},setup(e){const{sidebarGroups:t,hasSidebar:n}=D(),a=e,o=S(null),r=Se(ee?document.body:null);F([a,o],()=>{var v;a.open?(r.value=!0,(v=o.value)==null||v.focus()):r.value=!1},{immediate:!0,flush:"post"});const l=S(0);return F(t,()=>{l.value+=1},{deep:!0}),(v,f)=>i(n)?(s(),u("aside",{key:0,class:N(["VPSidebar",{open:e.open}]),ref_key:"navEl",ref:o,onClick:f[0]||(f[0]=Ke(()=>{},["stop"]))},[f[2]||(f[2]=d("div",{class:"curtain"},null,-1)),d("nav",ys,[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(),_($s,{items:i(t),key:l.value},null,8,["items"])),c(v.$slots,"sidebar-nav-after",{},void 0,!0)])],2)):m("",!0)}}),Ls=g(Ps,[["__scopeId","data-v-3bd28f60"]]),Vs=p({__name:"VPSkipLink",setup(e){const{theme:t}=L(),n=Q(),a=S();F(()=>n.path,()=>a.value.focus());function o({target:r}){const l=document.getElementById(decodeURIComponent(r.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(r,l)=>(s(),u(x,null,[d("span",{ref_key:"backToTop",ref:a,tabindex:"-1"},null,512),d("a",{href:"#VPContent",class:"VPSkipLink visually-hidden",onClick:o},M(i(t).skipToContentLabel||"Skip to content"),1)],64))}}),Ss=g(Vs,[["__scopeId","data-v-7f8d064b"]]),Ts=p({__name:"Layout",setup(e){const{isOpen:t,open:n,close:a}=D(),o=Q();F(()=>o.path,a),ut(t,a);const{frontmatter:r}=L(),l=Re(),v=y(()=>!!l["home-hero-image"]);return Te("hero-image-slot-exists",v),(f,$)=>{const V=W("Content");return i(r).layout!==!1?(s(),u("div",{key:0,class:N(["Layout",i(r).pageClass])},[c(f.$slots,"layout-top",{},void 0,!0),k(Ss),k(Ye,{class:"backdrop",show:i(t),onClick:i(a)},null,8,["show","onClick"]),k(ms,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(ra,{open:i(t),onOpenMenu:i(n)},null,8,["open","onOpenMenu"]),k(Ls,{open:i(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(Wn,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(Xn),c(f.$slots,"layout-bottom",{},void 0,!0)],2)):(s(),_(V,{key:1}))}}}),Ns=g(Ts,[["__scopeId","data-v-a36a6c58"]]),Ms={Layout:Ns,enhanceApp:({app:e})=>{e.component("Badge",qe)}},Is={...Ms};export{Is as R,uo as c,L as u};
1
+ const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/chunks/VPLocalSearchBox.LhvELOMD.js","assets/chunks/framework.qU75dRxB.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 ue,e as m,_ as g,u as Ce,i as He,f as Be,g as de,h as y,j as d,k as i,l as z,m as se,p as S,q as F,s as X,v as U,x as ve,y as fe,z as Ee,A as Fe,F as x,B as A,C as W,D as Y,E as k,G as $e,H as B,I as ye,J as Q,K as G,L as Z,M as De,N as Pe,O as ie,P as Le,Q as Ve,R as ee,S as Oe,U as Ge,V as Ue,W as Se,X as Te,Y as je,Z as ze,$ as We,a0 as Ke,a1 as Re}from"./framework.qU75dRxB.js";const qe=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))}}),Je={key:0,class:"VPBackdrop"},Xe=p({__name:"VPBackdrop",props:{show:{type:Boolean}},setup(e){return(t,n)=>(s(),_(ue,{name:"fade"},{default:h(()=>[e.show?(s(),u("div",Je)):m("",!0)]),_:1}))}}),Ye=g(Xe,[["__scopeId","data-v-72ae660b"]]),L=Ce;function Qe(e,t){let n,a=!1;return()=>{n&&clearTimeout(n),a?n=setTimeout(e,t):(e(),(a=!0)&&setTimeout(()=>a=!1,t))}}function re(e){return e.startsWith("/")?e:`/${e}`}function he(e){const{pathname:t,search:n,hash:a,protocol:o}=new URL(e,"http://a.com");if(He(e)||e.startsWith("#")||!o.startsWith("http")||!Be(t))return e;const{site:r}=L(),l=t.endsWith("/")||t.endsWith(".html")?e:e.replace(/(?:(^\.+)\/)?.*$/,`$1${t.replace(/(\.md)?$/,r.value.cleanUrls?"":".html")}${n}${a}`);return de(l)}function R({correspondingLink:e=!1}={}){const{site:t,localeIndex:n,page:a,theme:o,hash:r}=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:Ze($.link||(f==="root"?"/":`/${f}/`),o.value.i18nRouting!==!1&&e,a.value.relativePath.slice(l.value.link.length-1),!t.value.cleanUrls)+r.value})),currentLang:l}}function Ze(e,t,n,a){return t?e.replace(/\/$/,"")+re(n.replace(/(^|\/)index\.md$/,"$1").replace(/\.md$/,a?".html":"")):e}const et={class:"NotFound"},tt={class:"code"},nt={class:"title"},at={class:"quote"},ot={class:"action"},st=["href","aria-label"],it=p({__name:"NotFound",setup(e){const{theme:t}=L(),{currentLang:n}=R();return(a,o)=>{var r,l,v,f,$;return s(),u("div",et,[d("p",tt,M(((r=i(t).notFound)==null?void 0:r.code)??"404"),1),d("h1",nt,M(((l=i(t).notFound)==null?void 0:l.title)??"PAGE NOT FOUND"),1),o[0]||(o[0]=d("div",{class:"divider"},null,-1)),d("blockquote",at,M(((v=i(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",ot,[d("a",{class:"link",href:i(de)(i(n).link),"aria-label":((f=i(t).notFound)==null?void 0:f.linkLabel)??"go to home"},M((($=i(t).notFound)==null?void 0:$.linkText)??"Take me home"),9,st)])])}}}),rt=g(it,[["__scopeId","data-v-1e66b723"]]);function Ne(e,t){if(Array.isArray(e))return q(e);if(e==null)return[];t=re(t);const n=Object.keys(e).sort((o,r)=>r.split("/").length-o.split("/").length).find(o=>t.startsWith(re(o))),a=n?e[n]:[];return Array.isArray(a)?q(a):q(a.items,a.base)}function lt(e){const t=[];let n=0;for(const a in e){const o=e[a];if(o.items){n=t.push(o);continue}t[n]||t.push({items:[]}),t[n].items.push(o)}return t}function ct(e){const t=[];function n(a){for(const o of a)o.text&&o.link&&t.push({text:o.text,link:o.link,docFooterText:o.docFooterText}),o.items&&n(o.items)}return n(e),t}function le(e,t){return Array.isArray(t)?t.some(n=>le(e,n)):z(e,t.link)?!0:t.items?le(e,t.items):!1}function q(e,t){return[...e].map(n=>{const a={...n},o=a.base||t;return o&&a.link&&(a.link=o+a.link),a.items&&(a.items=q(a.items,o)),a})}function D(){const{frontmatter:e,page:t,theme:n}=L(),a=se("(min-width: 960px)"),o=S(!1),r=y(()=>{const w=n.value.sidebar,C=t.value.relativePath;return w?Ne(w,C):[]}),l=S(r.value);F(r,(w,C)=>{JSON.stringify(w)!==JSON.stringify(C)&&(l.value=r.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&&a.value),b=y(()=>v.value?lt(l.value):[]);function P(){o.value=!0}function T(){o.value=!1}function I(){o.value?T():P()}return{isOpen:o,sidebar:l,sidebarGroups:b,hasSidebar:v,hasAside:$,leftAside:f,isSidebarEnabled:V,open:P,close:T,toggle:I}}function ut(e,t){let n;X(()=>{n=e.value?document.activeElement:void 0}),U(()=>{window.addEventListener("keyup",a)}),ve(()=>{window.removeEventListener("keyup",a)});function a(o){o.key==="Escape"&&e.value&&(t(),n==null||n.focus())}}function dt(e){const{page:t,hash:n}=L(),a=S(!1),o=y(()=>e.value.collapsed!=null),r=y(()=>!!e.value.link),l=S(!1),v=()=>{l.value=z(t.value.relativePath,e.value.link)};F([t,e,n],v),U(v);const f=y(()=>l.value?!0:e.value.items?le(t.value.relativePath,e.value.items):!1),$=y(()=>!!(e.value.items&&e.value.items.length));X(()=>{a.value=!!(o.value&&e.value.collapsed)}),fe(()=>{(l.value||f.value)&&(a.value=!1)});function V(){o.value&&(a.value=!a.value)}return{collapsed:a,collapsible:o,isLink:r,isActiveLink:l,hasActiveLink:f,hasChildren:$,toggle:V}}function vt(){const{hasSidebar:e}=D(),t=se("(min-width: 960px)"),n=se("(min-width: 1280px)");return{isAsideEnabled:y(()=>!n.value&&!t.value?!1:e.value?n.value:t.value)}}const ft=/\b(?:VPBadge|header-anchor|footnote-ref|ignore-header)\b/,ce=[];function Me(e){return typeof e.outline=="object"&&!Array.isArray(e.outline)&&e.outline.label||e.outlineTitle||"On this page"}function me(e){const t=[...document.querySelectorAll(".VPDoc :where(h1,h2,h3,h4,h5,h6)")].filter(n=>n.id&&n.hasChildNodes()).map(n=>{const a=Number(n.tagName[1]);return{element:n,title:ht(n),link:"#"+n.id,level:a}});return mt(t,e)}function ht(e){let t="";for(const n of e.childNodes)if(n.nodeType===1){if(ft.test(n.className))continue;t+=n.textContent}else n.nodeType===3&&(t+=n.textContent);return t.trim()}function mt(e,t){if(t===!1)return[];const n=(typeof t=="object"&&!Array.isArray(t)?t.level:t)||2,[a,o]=typeof n=="number"?[n,n]:n==="deep"?[2,6]:n;return _t(e,a,o)}function pt(e,t){const{isAsideEnabled:n}=vt(),a=Qe(r,100);let o=null;U(()=>{requestAnimationFrame(r),window.addEventListener("scroll",a)}),Ee(()=>{l(location.hash)}),ve(()=>{window.removeEventListener("scroll",a)});function r(){if(!n.value)return;const v=window.scrollY,f=window.innerHeight,$=document.body.offsetHeight,V=Math.abs(v+f-$)<1,b=ce.map(({element:T,link:I})=>({link:I,top:kt(T)})).filter(({top:T})=>!Number.isNaN(T)).sort((T,I)=>T.top-I.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:I}of b){if(I>v+Fe()+4)break;P=T}l(P)}function l(v){o&&o.classList.remove("active"),v==null?o=null:o=e.value.querySelector(`a[href="${decodeURIComponent(v)}"]`);const f=o;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 kt(e){let t=0;for(;e!==document.body;){if(e===null)return NaN;t+=e.offsetTop,e=e.offsetParent}return t}function _t(e,t,n){ce.length=0;const a=[],o=[];return e.forEach(r=>{const l={...r,children:[]};let v=o[o.length-1];for(;v&&v.level>=l.level;)o.pop(),v=o[o.length-1];if(l.element.classList.contains("ignore-header")||v&&"shouldIgnore"in v){o.push({level:l.level,shouldIgnore:!0});return}l.level>n||l.level<t||(ce.push({element:l.element,link:l.link}),v?v.children.push(l):a.push(l),o.push(l))}),a}const bt=["href","title"],gt=p({__name:"VPDocOutlineItem",props:{headers:{},root:{type:Boolean}},setup(e){function t({target:n}){const a=n.href.split("#")[1],o=document.getElementById(decodeURIComponent(a));o==null||o.focus({preventScroll:!0})}return(n,a)=>{const o=W("VPDocOutlineItem",!0);return s(),u("ul",{class:N(["VPDocOutlineItem",e.root?"root":"nested"])},[(s(!0),u(x,null,A(e.headers,({children:r,link:l,title:v})=>(s(),u("li",null,[d("a",{class:"outline-link",href:l,onClick:t,title:v},M(v),9,bt),r!=null&&r.length?(s(),_(o,{key:0,headers:r},null,8,["headers"])):m("",!0)]))),256))],2)}}}),xe=g(gt,[["__scopeId","data-v-4e3ae89d"]]),$t={class:"content"},yt={"aria-level":"2",class:"outline-title",id:"doc-outline-aria-label",role:"heading"},Pt=p({__name:"VPDocAsideOutline",setup(e){const{frontmatter:t,theme:n}=L(),a=$e([]);Y(()=>{a.value=me(t.value.outline??n.value.outline)});const o=S(),r=S();return pt(o,r),(l,v)=>(s(),u("nav",{"aria-labelledby":"doc-outline-aria-label",class:N(["VPDocAsideOutline",{"has-outline":a.value.length>0}]),ref_key:"container",ref:o},[d("div",$t,[d("div",{class:"outline-marker",ref_key:"marker",ref:r},null,512),d("div",yt,M(i(Me)(i(n))),1),k(xe,{headers:a.value,root:!0},null,8,["headers"])])],2))}}),Lt=g(Pt,[["__scopeId","data-v-e1b5d7b1"]]),Vt={class:"VPDocAsideCarbonAds"},St=p({__name:"VPDocAsideCarbonAds",props:{carbonAds:{}},setup(e){const t=()=>null;return(n,a)=>(s(),u("div",Vt,[k(i(t),{"carbon-ads":e.carbonAds},null,8,["carbon-ads"])]))}}),Tt={class:"VPDocAside"},Nt=p({__name:"VPDocAside",setup(e){const{theme:t}=L();return(n,a)=>(s(),u("div",Tt,[c(n.$slots,"aside-top",{},void 0,!0),c(n.$slots,"aside-outline-before",{},void 0,!0),k(Lt),c(n.$slots,"aside-outline-after",{},void 0,!0),a[0]||(a[0]=d("div",{class:"spacer"},null,-1)),c(n.$slots,"aside-ads-before",{},void 0,!0),i(t).carbonAds?(s(),_(St,{key:0,"carbon-ads":i(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)]))}}),Mt=g(Nt,[["__scopeId","data-v-b2e2d543"]]);function xt(){const{theme:e,page:t}=L();return y(()=>{const{text:n="Edit this page",pattern:a=""}=e.value.editLink||{};let o;return typeof a=="function"?o=a(t.value):o=a.replace(/:path/g,t.value.filePath),{url:o,text:n}})}function It(){const{page:e,theme:t,frontmatter:n}=L();return y(()=>{var $,V,b,P,T,I,w,C;const a=Ne(t.value.sidebar,e.value.relativePath),o=ct(a),r=wt(o,H=>H.link.replace(/[?#].*$/,"")),l=r.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=r[l-1])==null?void 0:b.docFooterText)??((P=r[l-1])==null?void 0:P.text),link:(typeof n.value.prev=="object"?n.value.prev.link:void 0)??((T=r[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)??((I=r[l+1])==null?void 0:I.docFooterText)??((w=r[l+1])==null?void 0:w.text),link:(typeof n.value.next=="object"?n.value.next.link:void 0)??((C=r[l+1])==null?void 0:C.link)}}})}function wt(e,t){const n=new Set;return e.filter(a=>{const o=t(a);return n.has(o)?!1:n.add(o)})}const E=p({__name:"VPLink",props:{tag:{},href:{},noIcon:{type:Boolean},target:{},rel:{}},setup(e){const t=e,n=y(()=>t.tag??(t.href?"a":"span")),a=y(()=>t.href&&ye.test(t.href)||t.target==="_blank");return(o,r)=>(s(),_(B(n.value),{class:N(["VPLink",{link:e.href,"vp-external-link-icon":a.value,"no-icon":e.noIcon}]),href:e.href?i(he)(e.href):void 0,target:e.target??(a.value?"_blank":void 0),rel:e.rel??(a.value?"noreferrer":void 0)},{default:h(()=>[c(o.$slots,"default")]),_:3},8,["class","href","target","rel"]))}}),At={class:"VPLastUpdated"},Ct=["datetime"],Ht=p({__name:"VPDocFooterLastUpdated",setup(e){const{theme:t,page:n,lang:a}=L(),o=y(()=>new Date(n.value.lastUpdated)),r=y(()=>o.value.toISOString()),l=S("");return U(()=>{X(()=>{var v,f,$;l.value=new Intl.DateTimeFormat((f=(v=t.value.lastUpdated)==null?void 0:v.formatOptions)!=null&&f.forceLocale?a.value:void 0,(($=t.value.lastUpdated)==null?void 0:$.formatOptions)??{dateStyle:"short",timeStyle:"short"}).format(o.value)})}),(v,f)=>{var $;return s(),u("p",At,[j(M((($=i(t).lastUpdated)==null?void 0:$.text)||i(t).lastUpdatedText||"Last updated")+": ",1),d("time",{datetime:r.value},M(l.value),9,Ct)])}}}),Bt=g(Ht,[["__scopeId","data-v-04352d80"]]),Et={key:0,class:"VPDocFooter"},Ft={key:0,class:"edit-info"},Dt={key:0,class:"edit-link"},Ot={key:1,class:"last-updated"},Gt={key:1,class:"prev-next","aria-labelledby":"doc-footer-aria-label"},Ut={class:"pager"},jt=["innerHTML"],zt=["innerHTML"],Wt={class:"pager"},Kt=["innerHTML"],Rt=["innerHTML"],qt=p({__name:"VPDocFooter",setup(e){const{theme:t,page:n,frontmatter:a}=L(),o=xt(),r=It(),l=y(()=>t.value.editLink&&a.value.editLink!==!1),v=y(()=>n.value.lastUpdated),f=y(()=>l.value||v.value||r.value.prev||r.value.next);return($,V)=>{var b,P,T,I;return f.value?(s(),u("footer",Et,[c($.$slots,"doc-footer-before",{},void 0,!0),l.value||v.value?(s(),u("div",Ft,[l.value?(s(),u("div",Dt,[k(E,{class:"edit-link-button",href:i(o).url,"no-icon":!0},{default:h(()=>[V[0]||(V[0]=d("span",{class:"vpi-square-pen edit-link-icon"},null,-1)),j(" "+M(i(o).text),1)]),_:1},8,["href"])])):m("",!0),v.value?(s(),u("div",Ot,[k(Bt)])):m("",!0)])):m("",!0),(b=i(r).prev)!=null&&b.link||(P=i(r).next)!=null&&P.link?(s(),u("nav",Gt,[V[1]||(V[1]=d("span",{class:"visually-hidden",id:"doc-footer-aria-label"},"Pager",-1)),d("div",Ut,[(T=i(r).prev)!=null&&T.link?(s(),_(E,{key:0,class:"pager-link prev",href:i(r).prev.link},{default:h(()=>{var w;return[d("span",{class:"desc",innerHTML:((w=i(t).docFooter)==null?void 0:w.prev)||"Previous page"},null,8,jt),d("span",{class:"title",innerHTML:i(r).prev.text},null,8,zt)]}),_:1},8,["href"])):m("",!0)]),d("div",Wt,[(I=i(r).next)!=null&&I.link?(s(),_(E,{key:0,class:"pager-link next",href:i(r).next.link},{default:h(()=>{var w;return[d("span",{class:"desc",innerHTML:((w=i(t).docFooter)==null?void 0:w.next)||"Next page"},null,8,Kt),d("span",{class:"title",innerHTML:i(r).next.text},null,8,Rt)]}),_:1},8,["href"])):m("",!0)])])):m("",!0)])):m("",!0)}}}),Jt=g(qt,[["__scopeId","data-v-7828e31e"]]),Xt={class:"container"},Yt={class:"aside-container"},Qt={class:"aside-content"},Zt={class:"content"},en={class:"content-container"},tn={class:"main"},nn=p({__name:"VPDoc",setup(e){const{theme:t}=L(),n=Q(),{hasSidebar:a,hasAside:o,leftAside:r}=D(),l=y(()=>n.path.replace(/[./]+/g,"_").replace(/_html$/,""));return(v,f)=>{const $=W("Content");return s(),u("div",{class:N(["VPDoc",{"has-sidebar":i(a),"has-aside":i(o)}])},[c(v.$slots,"doc-top",{},void 0,!0),d("div",Xt,[i(o)?(s(),u("div",{key:0,class:N(["aside",{"left-aside":i(r)}])},[f[0]||(f[0]=d("div",{class:"aside-curtain"},null,-1)),d("div",Yt,[d("div",Qt,[k(Mt,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",Zt,[d("div",en,[c(v.$slots,"doc-before",{},void 0,!0),d("main",tn,[k($,{class:N(["vp-doc",[l.value,i(t).externalLinkIcon&&"external-link-icon-enabled"]])},null,8,["class"])]),k(Jt,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)}}}),an=g(nn,[["__scopeId","data-v-ecd06071"]]),on=p({__name:"VPButton",props:{tag:{},size:{default:"medium"},theme:{default:"brand"},text:{},href:{},target:{},rel:{}},setup(e){const t=e,n=y(()=>t.href&&ye.test(t.href)),a=y(()=>t.tag||(t.href?"a":"button"));return(o,r)=>(s(),_(B(a.value),{class:N(["VPButton",[e.size,e.theme]]),href:e.href?i(he)(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"]))}}),sn=g(on,[["__scopeId","data-v-573a094b"]]),rn=["src","alt"],ln=p({inheritAttrs:!1,__name:"VPImage",props:{image:{},alt:{}},setup(e){return(t,n)=>{const a=W("VPImage",!0);return e.image?(s(),u(x,{key:0},[typeof e.image=="string"||"src"in e.image?(s(),u("img",G({key:0,class:"VPImage"},typeof e.image=="string"?t.$attrs:{...e.image,...t.$attrs},{src:i(de)(typeof e.image=="string"?e.image:e.image.src),alt:e.alt??(typeof e.image=="string"?"":e.image.alt||"")}),null,16,rn)):(s(),u(x,{key:1},[k(a,G({class:"dark",image:e.image.dark,alt:e.image.alt},t.$attrs),null,16,["image","alt"]),k(a,G({class:"light",image:e.image.light,alt:e.image.alt},t.$attrs),null,16,["image","alt"])],64))],64)):m("",!0)}}}),J=g(ln,[["__scopeId","data-v-0723c290"]]),cn={class:"container"},un={class:"main"},dn={class:"heading"},vn=["innerHTML"],fn=["innerHTML"],hn=["innerHTML"],mn={key:0,class:"actions"},pn={key:0,class:"image"},kn={class:"image-container"},_n=p({__name:"VPHero",props:{name:{},text:{},tagline:{},image:{},actions:{}},setup(e){const t=Z("hero-image-slot-exists");return(n,a)=>(s(),u("div",{class:N(["VPHero",{"has-image":e.image||i(t)}])},[d("div",cn,[d("div",un,[c(n.$slots,"home-hero-info-before",{},void 0,!0),c(n.$slots,"home-hero-info",{},()=>[d("h1",dn,[e.name?(s(),u("span",{key:0,innerHTML:e.name,class:"name clip"},null,8,vn)):m("",!0),e.text?(s(),u("span",{key:1,innerHTML:e.text,class:"text"},null,8,fn)):m("",!0)]),e.tagline?(s(),u("p",{key:0,innerHTML:e.tagline,class:"tagline"},null,8,hn)):m("",!0)],!0),c(n.$slots,"home-hero-info-after",{},void 0,!0),e.actions?(s(),u("div",mn,[(s(!0),u(x,null,A(e.actions,o=>(s(),u("div",{key:o.link,class:"action"},[k(sn,{tag:"a",size:"medium",theme:o.theme,text:o.text,href:o.link,target:o.target,rel:o.rel},null,8,["theme","text","href","target","rel"])]))),128))])):m("",!0),c(n.$slots,"home-hero-actions-after",{},void 0,!0)]),e.image||i(t)?(s(),u("div",pn,[d("div",kn,[a[0]||(a[0]=d("div",{class:"image-bg"},null,-1)),c(n.$slots,"home-hero-image",{},()=>[e.image?(s(),_(J,{key:0,class:"image-src",image:e.image},null,8,["image"])):m("",!0)],!0)])])):m("",!0)])],2))}}),bn=g(_n,[["__scopeId","data-v-87f9eef1"]]),gn=p({__name:"VPHomeHero",setup(e){const{frontmatter:t}=L();return(n,a)=>i(t).hero?(s(),_(bn,{key:0,class:"VPHomeHero",name:i(t).hero.name,text:i(t).hero.text,tagline:i(t).hero.tagline,image:i(t).hero.image,actions:i(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)}}),$n={class:"box"},yn={key:0,class:"icon"},Pn=["innerHTML"],Ln=["innerHTML"],Vn=["innerHTML"],Sn={key:4,class:"link-text"},Tn={class:"link-text-value"},Nn=p({__name:"VPFeature",props:{icon:{},title:{},details:{},link:{},linkText:{},rel:{},target:{}},setup(e){return(t,n)=>(s(),_(E,{class:"VPFeature",href:e.link,rel:e.rel,target:e.target,"no-icon":!0,tag:e.link?"a":"div"},{default:h(()=>[d("article",$n,[typeof e.icon=="object"&&e.icon.wrap?(s(),u("div",yn,[k(J,{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(),_(J,{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,Pn)):m("",!0),d("h2",{class:"title",innerHTML:e.title},null,8,Ln),e.details?(s(),u("p",{key:3,class:"details",innerHTML:e.details},null,8,Vn)):m("",!0),e.linkText?(s(),u("div",Sn,[d("p",Tn,[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"]))}}),Mn=g(Nn,[["__scopeId","data-v-ce605f93"]]),xn={key:0,class:"VPFeatures"},In={class:"container"},wn={class:"items"},An=p({__name:"VPFeatures",props:{features:{}},setup(e){const t=e,n=y(()=>{const a=t.features.length;if(a){if(a===2)return"grid-2";if(a===3)return"grid-3";if(a%3===0)return"grid-6";if(a>3)return"grid-4"}else return});return(a,o)=>e.features?(s(),u("div",xn,[d("div",In,[d("div",wn,[(s(!0),u(x,null,A(e.features,r=>(s(),u("div",{key:r.title,class:N(["item",[n.value]])},[k(Mn,{icon:r.icon,title:r.title,details:r.details,link:r.link,"link-text":r.linkText,rel:r.rel,target:r.target},null,8,["icon","title","details","link","link-text","rel","target"])],2))),128))])])])):m("",!0)}}),Cn=g(An,[["__scopeId","data-v-0697a0a8"]]),Hn=p({__name:"VPHomeFeatures",setup(e){const{frontmatter:t}=L();return(n,a)=>i(t).features?(s(),_(Cn,{key:0,class:"VPHomeFeatures",features:i(t).features},null,8,["features"])):m("",!0)}}),Bn=p({__name:"VPHomeContent",setup(e){const{width:t}=De({initialWidth:0,includeScrollbar:!1});return(n,a)=>(s(),u("div",{class:"vp-doc container",style:Pe(i(t)?{"--vp-offset":`calc(50% - ${i(t)/2}px)`}:{})},[c(n.$slots,"default",{},void 0,!0)],4))}}),En=g(Bn,[["__scopeId","data-v-92970b0a"]]),Fn=p({__name:"VPHome",setup(e){const{frontmatter:t,theme:n}=L();return(a,o)=>{const r=W("Content");return s(),u("div",{class:N(["VPHome",{"external-link-icon-enabled":i(n).externalLinkIcon}])},[c(a.$slots,"home-hero-before",{},void 0,!0),k(gn,null,{"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)]),_:3}),c(a.$slots,"home-hero-after",{},void 0,!0),c(a.$slots,"home-features-before",{},void 0,!0),k(Hn),c(a.$slots,"home-features-after",{},void 0,!0),i(t).markdownStyles!==!1?(s(),_(En,{key:0},{default:h(()=>[k(r)]),_:1})):(s(),_(r,{key:1}))],2)}}}),Dn=g(Fn,[["__scopeId","data-v-32d7d5ba"]]),On={},Gn={class:"VPPage"};function Un(e,t){const n=W("Content");return s(),u("div",Gn,[c(e.$slots,"page-top"),k(n),c(e.$slots,"page-bottom")])}const jn=g(On,[["render",Un]]),zn=p({__name:"VPContent",setup(e){const{page:t,frontmatter:n}=L(),{hasSidebar:a}=D();return(o,r)=>(s(),u("div",{class:N(["VPContent",{"has-sidebar":i(a),"is-home":i(n).layout==="home"}]),id:"VPContent"},[i(t).isNotFound?c(o.$slots,"not-found",{},()=>[k(rt)],!0,0):i(n).layout==="page"?(s(),_(jn,{key:1},{"page-top":h(()=>[c(o.$slots,"page-top",{},void 0,!0)]),"page-bottom":h(()=>[c(o.$slots,"page-bottom",{},void 0,!0)]),_:3})):i(n).layout==="home"?(s(),_(Dn,{key:2},{"home-hero-before":h(()=>[c(o.$slots,"home-hero-before",{},void 0,!0)]),"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)]),"home-hero-after":h(()=>[c(o.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":h(()=>[c(o.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":h(()=>[c(o.$slots,"home-features-after",{},void 0,!0)]),_:3})):i(n).layout&&i(n).layout!=="doc"?(s(),_(B(i(n).layout),{key:3})):(s(),_(an,{key:4},{"doc-top":h(()=>[c(o.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":h(()=>[c(o.$slots,"doc-bottom",{},void 0,!0)]),"doc-footer-before":h(()=>[c(o.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":h(()=>[c(o.$slots,"doc-before",{},void 0,!0)]),"doc-after":h(()=>[c(o.$slots,"doc-after",{},void 0,!0)]),"aside-top":h(()=>[c(o.$slots,"aside-top",{},void 0,!0)]),"aside-outline-before":h(()=>[c(o.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":h(()=>[c(o.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":h(()=>[c(o.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":h(()=>[c(o.$slots,"aside-ads-after",{},void 0,!0)]),"aside-bottom":h(()=>[c(o.$slots,"aside-bottom",{},void 0,!0)]),_:3}))],2))}}),Wn=g(zn,[["__scopeId","data-v-0d61d52e"]]),Kn={class:"container"},Rn=["innerHTML"],qn=["innerHTML"],Jn=p({__name:"VPFooter",setup(e){const{theme:t,frontmatter:n}=L(),{hasSidebar:a}=D();return(o,r)=>i(t).footer&&i(n).footer!==!1?(s(),u("footer",{key:0,class:N(["VPFooter",{"has-sidebar":i(a)}])},[d("div",Kn,[i(t).footer.message?(s(),u("p",{key:0,class:"message",innerHTML:i(t).footer.message},null,8,Rn)):m("",!0),i(t).footer.copyright?(s(),u("p",{key:1,class:"copyright",innerHTML:i(t).footer.copyright},null,8,qn)):m("",!0)])],2)):m("",!0)}}),Xn=g(Jn,[["__scopeId","data-v-76c562a4"]]);function Yn(){const{theme:e,frontmatter:t}=L(),n=$e([]),a=y(()=>n.value.length>0);return Y(()=>{n.value=me(t.value.outline??e.value.outline)}),{headers:n,hasLocalNav:a}}const Qn={class:"menu-text"},Zn={class:"header"},ea={class:"outline"},ta=p({__name:"VPLocalNavOutlineDropdown",props:{headers:{},navHeight:{}},setup(e){const t=e,{theme:n}=L(),a=S(!1),o=S(0),r=S(),l=S();function v(b){var P;(P=r.value)!=null&&P.contains(b.target)||(a.value=!1)}F(a,b=>{if(b){document.addEventListener("click",v);return}document.removeEventListener("click",v)}),ie("Escape",()=>{a.value=!1}),Y(()=>{a.value=!1});function f(){a.value=!a.value,o.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"),Le(()=>{a.value=!1}))}function V(){a.value=!1,window.scrollTo({top:0,left:0,behavior:"smooth"})}return(b,P)=>(s(),u("div",{class:"VPLocalNavOutlineDropdown",style:Pe({"--vp-vh":o.value+"px"}),ref_key:"main",ref:r},[e.headers.length>0?(s(),u("button",{key:0,onClick:f,class:N({open:a.value})},[d("span",Qn,M(i(Me)(i(n))),1),P[0]||(P[0]=d("span",{class:"vpi-chevron-right icon"},null,-1))],2)):(s(),u("button",{key:1,onClick:V},M(i(n).returnToTopLabel||"Return to top"),1)),k(ue,{name:"flyout"},{default:h(()=>[a.value?(s(),u("div",{key:0,ref_key:"items",ref:l,class:"items",onClick:$},[d("div",Zn,[d("a",{class:"top-link",href:"#",onClick:V},M(i(n).returnToTopLabel||"Return to top"),1)]),d("div",ea,[k(xe,{headers:e.headers},null,8,["headers"])])],512)):m("",!0)]),_:1})],4))}}),na=g(ta,[["__scopeId","data-v-6ce9e49d"]]),aa={class:"container"},oa=["aria-expanded"],sa={class:"menu-text"},ia=p({__name:"VPLocalNav",props:{open:{type:Boolean}},emits:["open-menu"],setup(e){const{theme:t,frontmatter:n}=L(),{hasSidebar:a}=D(),{headers:o}=Yn(),{y:r}=Ve(),l=S(0);U(()=>{l.value=parseInt(getComputedStyle(document.documentElement).getPropertyValue("--vp-nav-height"))}),Y(()=>{o.value=me(n.value.outline??t.value.outline)});const v=y(()=>o.value.length===0),f=y(()=>v.value&&!a.value),$=y(()=>({VPLocalNav:!0,"has-sidebar":a.value,empty:v.value,fixed:f.value}));return(V,b)=>i(n).layout!=="home"&&(!f.value||i(r)>=l.value)?(s(),u("div",{key:0,class:N($.value)},[d("div",aa,[i(a)?(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",sa,M(i(t).sidebarMenuLabel||"Menu"),1)],8,oa)):m("",!0),k(na,{headers:i(o),navHeight:l.value},null,8,["headers","navHeight"])])],2)):m("",!0)}}),ra=g(ia,[["__scopeId","data-v-948a2bb1"]]);function la(){const e=S(!1);function t(){e.value=!0,window.addEventListener("resize",o)}function n(){e.value=!1,window.removeEventListener("resize",o)}function a(){e.value?n():t()}function o(){window.outerWidth>=768&&n()}const r=Q();return F(()=>r.path,n),{isScreenOpen:e,openScreen:t,closeScreen:n,toggleScreen:a}}const ca={},ua={class:"VPSwitch",type:"button",role:"switch"},da={class:"check"},va={key:0,class:"icon"};function fa(e,t){return s(),u("button",ua,[d("span",da,[e.$slots.default?(s(),u("span",va,[c(e.$slots,"default",{},void 0,!0)])):m("",!0)])])}const ha=g(ca,[["render",fa],["__scopeId","data-v-9addbbf0"]]),ma=p({__name:"VPSwitchAppearance",setup(e){const{isDark:t,theme:n}=L(),a=Z("toggle-appearance",()=>{t.value=!t.value}),o=S("");return fe(()=>{o.value=t.value?n.value.lightModeSwitchTitle||"Switch to light theme":n.value.darkModeSwitchTitle||"Switch to dark theme"}),(r,l)=>(s(),_(ha,{title:o.value,class:"VPSwitchAppearance","aria-checked":i(t),onClick:i(a)},{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"]))}}),pe=g(ma,[["__scopeId","data-v-0be14ed2"]]),pa={key:0,class:"VPNavBarAppearance"},ka=p({__name:"VPNavBarAppearance",setup(e){const{site:t}=L();return(n,a)=>i(t).appearance&&i(t).appearance!=="force-dark"&&i(t).appearance!=="force-auto"?(s(),u("div",pa,[k(pe)])):m("",!0)}}),_a=g(ka,[["__scopeId","data-v-286d34df"]]),ke=S();let Ie=!1,oe=0;function ba(e){const t=S(!1);if(ee){!Ie&&ga(),oe++;const n=F(ke,a=>{var o,r,l;a===e.el.value||(o=e.el.value)!=null&&o.contains(a)?(t.value=!0,(r=e.onFocus)==null||r.call(e)):(t.value=!1,(l=e.onBlur)==null||l.call(e))});ve(()=>{n(),oe--,oe||$a()})}return Oe(t)}function ga(){document.addEventListener("focusin",we),Ie=!0,ke.value=document.activeElement}function $a(){document.removeEventListener("focusin",we)}function we(){ke.value=document.activeElement}const ya={class:"VPMenuLink"},Pa=["innerHTML"],La=p({__name:"VPMenuLink",props:{item:{}},setup(e){const{page:t}=L();return(n,a)=>(s(),u("div",ya,[k(E,{class:N({active:i(z)(i(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,Pa)]),_:1},8,["class","href","target","rel","no-icon"])]))}}),te=g(La,[["__scopeId","data-v-76678a4b"]]),Va={class:"VPMenuGroup"},Sa={key:0,class:"title"},Ta=p({__name:"VPMenuGroup",props:{text:{},items:{}},setup(e){return(t,n)=>(s(),u("div",Va,[e.text?(s(),u("p",Sa,M(e.text),1)):m("",!0),(s(!0),u(x,null,A(e.items,a=>(s(),u(x,null,["link"in a?(s(),_(te,{key:0,item:a},null,8,["item"])):m("",!0)],64))),256))]))}}),Na=g(Ta,[["__scopeId","data-v-f4306f77"]]),Ma={class:"VPMenu"},xa={key:0,class:"items"},Ia=p({__name:"VPMenu",props:{items:{}},setup(e){return(t,n)=>(s(),u("div",Ma,[e.items?(s(),u("div",xa,[(s(!0),u(x,null,A(e.items,a=>(s(),u(x,{key:JSON.stringify(a)},["link"in a?(s(),_(te,{key:0,item:a},null,8,["item"])):"component"in a?(s(),_(B(a.component),G({key:1,ref_for:!0},a.props),null,16)):(s(),_(Na,{key:2,text:a.text,items:a.items},null,8,["text","items"]))],64))),128))])):m("",!0),c(t.$slots,"default",{},void 0,!0)]))}}),wa=g(Ia,[["__scopeId","data-v-00f4385c"]]),Aa=["aria-expanded","aria-label"],Ca={key:0,class:"text"},Ha=["innerHTML"],Ba={key:1,class:"vpi-more-horizontal icon"},Ea={class:"menu"},Fa=p({__name:"VPFlyout",props:{icon:{},button:{},label:{},items:{}},setup(e){const t=S(!1),n=S();ba({el:n,onBlur:a});function a(){t.value=!1}return(o,r)=>(s(),u("div",{class:"VPFlyout",ref_key:"el",ref:n,onMouseenter:r[1]||(r[1]=l=>t.value=!0),onMouseleave:r[2]||(r[2]=l=>t.value=!1)},[d("button",{type:"button",class:"button","aria-haspopup":"true","aria-expanded":t.value,"aria-label":e.label,onClick:r[0]||(r[0]=l=>t.value=!t.value)},[e.button||e.icon?(s(),u("span",Ca,[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,Ha)):m("",!0),r[3]||(r[3]=d("span",{class:"vpi-chevron-down text-icon"},null,-1))])):(s(),u("span",Ba))],8,Aa),d("div",Ea,[k(wa,{items:e.items},{default:h(()=>[c(o.$slots,"default",{},void 0,!0)]),_:3},8,["items"])])],544))}}),_e=g(Fa,[["__scopeId","data-v-4548827a"]]),Da=["href","aria-label","innerHTML"],Oa=p({__name:"VPSocialLink",props:{icon:{},link:{},ariaLabel:{}},setup(e){const t=e,n=S();U(async()=>{var r;await Le();const o=(r=n.value)==null?void 0:r.children[0];o instanceof HTMLElement&&o.className.startsWith("vpi-social-")&&(getComputedStyle(o).maskImage||getComputedStyle(o).webkitMaskImage)==="none"&&o.style.setProperty("--icon",`url('https://api.iconify.design/simple-icons/${t.icon}.svg')`)});const a=y(()=>typeof t.icon=="object"?t.icon.svg:`<span class="vpi-social-${t.icon}"></span>`);return(o,r)=>(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:a.value},null,8,Da))}}),Ga=g(Oa,[["__scopeId","data-v-6b445de0"]]),Ua={class:"VPSocialLinks"},ja=p({__name:"VPSocialLinks",props:{links:{}},setup(e){return(t,n)=>(s(),u("div",Ua,[(s(!0),u(x,null,A(e.links,({link:a,icon:o,ariaLabel:r})=>(s(),_(Ga,{key:a,icon:o,link:a,ariaLabel:r},null,8,["icon","link","ariaLabel"]))),128))]))}}),be=g(ja,[["__scopeId","data-v-1ef06a68"]]),za={key:0,class:"group translations"},Wa={class:"trans-title"},Ka={key:1,class:"group"},Ra={class:"item appearance"},qa={class:"label"},Ja={class:"appearance-action"},Xa={key:2,class:"group"},Ya={class:"item social-links"},Qa=p({__name:"VPNavBarExtra",setup(e){const{site:t,theme:n}=L(),{localeLinks:a,currentLang:o}=R({correspondingLink:!0}),r=y(()=>a.value.length&&o.value.label||t.value.appearance||n.value.socialLinks);return(l,v)=>r.value?(s(),_(_e,{key:0,class:"VPNavBarExtra",label:"extra navigation"},{default:h(()=>[i(a).length&&i(o).label?(s(),u("div",za,[d("p",Wa,M(i(o).label),1),(s(!0),u(x,null,A(i(a),f=>(s(),_(te,{key:f.link,item:f},null,8,["item"]))),128))])):m("",!0),i(t).appearance&&i(t).appearance!=="force-dark"&&i(t).appearance!=="force-auto"?(s(),u("div",Ka,[d("div",Ra,[d("p",qa,M(i(n).darkModeSwitchLabel||"Appearance"),1),d("div",Ja,[k(pe)])])])):m("",!0),i(n).socialLinks?(s(),u("div",Xa,[d("div",Ya,[k(be,{class:"social-links-list",links:i(n).socialLinks},null,8,["links"])])])):m("",!0)]),_:1})):m("",!0)}}),Za=g(Qa,[["__scopeId","data-v-0971638d"]]),eo=["aria-expanded"],to=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]=a=>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,eo))}}),no=g(to,[["__scopeId","data-v-888db669"]]),ao=["innerHTML"],oo=p({__name:"VPNavBarMenuLink",props:{item:{}},setup(e){const{page:t}=L();return(n,a)=>(s(),_(E,{class:N({VPNavBarMenuLink:!0,active:i(z)(i(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,ao)]),_:1},8,["class","href","target","rel","no-icon"]))}}),so=g(oo,[["__scopeId","data-v-8381090b"]]),io=p({__name:"VPNavBarMenuGroup",props:{item:{}},setup(e){const t=e,{page:n}=L(),a=r=>"component"in r?!1:"link"in r?z(n.value.relativePath,r.link,!!t.item.activeMatch):r.items.some(a),o=y(()=>a(t.item));return(r,l)=>(s(),_(_e,{class:N({VPNavBarMenuGroup:!0,active:i(z)(i(n).relativePath,e.item.activeMatch,!!e.item.activeMatch)||o.value}),button:e.item.text,items:e.item.items},null,8,["class","button","items"]))}}),ro={key:0,"aria-labelledby":"main-nav-aria-label",class:"VPNavBarMenu"},lo=p({__name:"VPNavBarMenu",setup(e){const{theme:t}=L();return(n,a)=>i(t).nav?(s(),u("nav",ro,[a[0]||(a[0]=d("span",{id:"main-nav-aria-label",class:"visually-hidden"}," Main Navigation ",-1)),(s(!0),u(x,null,A(i(t).nav,o=>(s(),u(x,{key:JSON.stringify(o)},["link"in o?(s(),_(so,{key:0,item:o},null,8,["item"])):"component"in o?(s(),_(B(o.component),G({key:1,ref_for:!0},o.props),null,16)):(s(),_(io,{key:2,item:o},null,8,["item"]))],64))),128))])):m("",!0)}}),co=g(lo,[["__scopeId","data-v-c9551fc0"]]);function uo(e){const{localeIndex:t,theme:n}=L();function a(o){var I,w,C;const r=o.split("."),l=(I=n.value.search)==null?void 0:I.options,v=l&&typeof l=="object",f=v&&((C=(w=l.locales)==null?void 0:w[t.value])==null?void 0:C.translations)||null,$=v&&l.translations||null;let V=f,b=$,P=e;const T=r.pop();for(const H of r){let O=null;const K=P==null?void 0:P[H];K&&(O=P=K);const ne=b==null?void 0:b[H];ne&&(O=b=ne);const ae=V==null?void 0:V[H];ae&&(O=V=ae),K||(P=O),ne||(b=O),ae||(V=O)}return(V==null?void 0:V[T])??(b==null?void 0:b[T])??(P==null?void 0:P[T])??""}return a}const vo=["aria-label"],fo={class:"DocSearch-Button-Container"},ho={class:"DocSearch-Button-Placeholder"},ge=p({__name:"VPNavBarSearchButton",setup(e){const n=uo({button:{buttonText:"Search",buttonAriaLabel:"Search"}});return(a,o)=>(s(),u("button",{type:"button",class:"DocSearch DocSearch-Button","aria-label":i(n)("button.buttonAriaLabel")},[d("span",fo,[o[0]||(o[0]=d("span",{class:"vp-icon DocSearch-Search-Icon"},null,-1)),d("span",ho,M(i(n)("button.buttonText")),1)]),o[1]||(o[1]=d("span",{class:"DocSearch-Button-Keys"},[d("kbd",{class:"DocSearch-Button-Key"}),d("kbd",{class:"DocSearch-Button-Key"},"K")],-1))],8,vo))}}),mo={class:"VPNavBarSearch"},po={id:"local-search"},ko={key:1,id:"docsearch"},_o=p({__name:"VPNavBarSearch",setup(e){const t=Ge(()=>Ue(()=>import("./VPLocalSearchBox.LhvELOMD.js"),__vite__mapDeps([0,1]))),n=()=>null,{theme:a}=L(),o=S(!1),r=S(!1);U(()=>{});function l(){o.value||(o.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);ie("k",b=>{(b.ctrlKey||b.metaKey)&&(b.preventDefault(),$.value=!0)}),ie("/",b=>{f(b)||(b.preventDefault(),$.value=!0)});const V="local";return(b,P)=>{var T;return s(),u("div",mo,[i(V)==="local"?(s(),u(x,{key:0},[$.value?(s(),_(i(t),{key:0,onClose:P[0]||(P[0]=I=>$.value=!1)})):m("",!0),d("div",po,[k(ge,{onClick:P[1]||(P[1]=I=>$.value=!0)})])],64)):i(V)==="algolia"?(s(),u(x,{key:1},[o.value?(s(),_(i(n),{key:0,algolia:((T=i(a).search)==null?void 0:T.options)??i(a).algolia,onVnodeBeforeMount:P[2]||(P[2]=I=>r.value=!0)},null,8,["algolia"])):m("",!0),r.value?m("",!0):(s(),u("div",ko,[k(ge,{onClick:l})]))],64)):m("",!0)])}}}),bo=p({__name:"VPNavBarSocialLinks",setup(e){const{theme:t}=L();return(n,a)=>i(t).socialLinks?(s(),_(be,{key:0,class:"VPNavBarSocialLinks",links:i(t).socialLinks},null,8,["links"])):m("",!0)}}),go=g(bo,[["__scopeId","data-v-33d7e6dd"]]),$o=["href","rel","target"],yo=["innerHTML"],Po={key:2},Lo=p({__name:"VPNavBarTitle",setup(e){const{site:t,theme:n}=L(),{hasSidebar:a}=D(),{currentLang:o}=R(),r=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":i(a)}])},[d("a",{class:"title",href:r.value??i(he)(i(o).link),rel:l.value,target:v.value},[c(f.$slots,"nav-bar-title-before",{},void 0,!0),i(n).logo?(s(),_(J,{key:0,class:"logo",image:i(n).logo},null,8,["image"])):m("",!0),i(n).siteTitle?(s(),u("span",{key:1,innerHTML:i(n).siteTitle},null,8,yo)):i(n).siteTitle===void 0?(s(),u("span",Po,M(i(t).title),1)):m("",!0),c(f.$slots,"nav-bar-title-after",{},void 0,!0)],8,$o)],2))}}),Vo=g(Lo,[["__scopeId","data-v-74c2a9a9"]]),So={class:"items"},To={class:"title"},No=p({__name:"VPNavBarTranslations",setup(e){const{theme:t}=L(),{localeLinks:n,currentLang:a}=R({correspondingLink:!0});return(o,r)=>i(n).length&&i(a).label?(s(),_(_e,{key:0,class:"VPNavBarTranslations",icon:"vpi-languages",label:i(t).langMenuLabel||"Change language"},{default:h(()=>[d("div",So,[d("p",To,M(i(a).label),1),(s(!0),u(x,null,A(i(n),l=>(s(),_(te,{key:l.link,item:l},null,8,["item"]))),128))])]),_:1},8,["label"])):m("",!0)}}),Mo=g(No,[["__scopeId","data-v-7a47cfd4"]]),xo={class:"wrapper"},Io={class:"container"},wo={class:"title"},Ao={class:"content"},Co={class:"content-body"},Ho=p({__name:"VPNavBar",props:{isScreenOpen:{type:Boolean}},emits:["toggle-screen"],setup(e){const t=e,{y:n}=Ve(),{hasSidebar:a}=D(),{frontmatter:o}=L(),r=S({});return fe(()=>{r.value={"has-sidebar":a.value,home:o.value.layout==="home",top:n.value===0,"screen-open":t.isScreenOpen}}),(l,v)=>(s(),u("div",{class:N(["VPNavBar",r.value])},[d("div",xo,[d("div",Io,[d("div",wo,[k(Vo,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",Ao,[d("div",Co,[c(l.$slots,"nav-bar-content-before",{},void 0,!0),k(_o,{class:"search"}),k(co,{class:"menu"}),k(Mo,{class:"translations"}),k(_a,{class:"appearance"}),k(go,{class:"social-links"}),k(Za,{class:"extra"}),c(l.$slots,"nav-bar-content-after",{},void 0,!0),k(no,{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))}}),Bo=g(Ho,[["__scopeId","data-v-5a9cffff"]]),Eo={key:0,class:"VPNavScreenAppearance"},Fo={class:"text"},Do=p({__name:"VPNavScreenAppearance",setup(e){const{site:t,theme:n}=L();return(a,o)=>i(t).appearance&&i(t).appearance!=="force-dark"&&i(t).appearance!=="force-auto"?(s(),u("div",Eo,[d("p",Fo,M(i(n).darkModeSwitchLabel||"Appearance"),1),k(pe)])):m("",!0)}}),Oo=g(Do,[["__scopeId","data-v-6a2323f9"]]),Go=["innerHTML"],Uo=p({__name:"VPNavScreenMenuLink",props:{item:{}},setup(e){const t=Z("close-screen");return(n,a)=>(s(),_(E,{class:"VPNavScreenMenuLink",href:e.item.link,target:e.item.target,rel:e.item.rel,"no-icon":e.item.noIcon,onClick:i(t)},{default:h(()=>[d("span",{innerHTML:e.item.text},null,8,Go)]),_:1},8,["href","target","rel","no-icon","onClick"]))}}),jo=g(Uo,[["__scopeId","data-v-49e05f69"]]),zo=["innerHTML"],Wo=p({__name:"VPNavScreenMenuGroupLink",props:{item:{}},setup(e){const t=Z("close-screen");return(n,a)=>(s(),_(E,{class:"VPNavScreenMenuGroupLink",href:e.item.link,target:e.item.target,rel:e.item.rel,"no-icon":e.item.noIcon,onClick:i(t)},{default:h(()=>[d("span",{innerHTML:e.item.text},null,8,zo)]),_:1},8,["href","target","rel","no-icon","onClick"]))}}),Ae=g(Wo,[["__scopeId","data-v-498377cf"]]),Ko={class:"VPNavScreenMenuGroupSection"},Ro={key:0,class:"title"},qo=p({__name:"VPNavScreenMenuGroupSection",props:{text:{},items:{}},setup(e){return(t,n)=>(s(),u("div",Ko,[e.text?(s(),u("p",Ro,M(e.text),1)):m("",!0),(s(!0),u(x,null,A(e.items,a=>(s(),_(Ae,{key:a.text,item:a},null,8,["item"]))),128))]))}}),Jo=g(qo,[["__scopeId","data-v-b128e013"]]),Xo=["aria-controls","aria-expanded"],Yo=["innerHTML"],Qo=["id"],Zo={key:0,class:"item"},es={key:1,class:"item"},ts={key:2,class:"group"},ns=p({__name:"VPNavScreenMenuGroup",props:{text:{},items:{}},setup(e){const t=e,n=S(!1),a=y(()=>`NavScreenGroup-${t.text.replace(" ","-").toLowerCase()}`);function o(){n.value=!n.value}return(r,l)=>(s(),u("div",{class:N(["VPNavScreenMenuGroup",{open:n.value}])},[d("button",{class:"button","aria-controls":a.value,"aria-expanded":n.value,onClick:o},[d("span",{class:"button-text",innerHTML:e.text},null,8,Yo),l[0]||(l[0]=d("span",{class:"vpi-plus button-icon"},null,-1))],8,Xo),d("div",{id:a.value,class:"items"},[(s(!0),u(x,null,A(e.items,v=>(s(),u(x,{key:JSON.stringify(v)},["link"in v?(s(),u("div",Zo,[k(Ae,{item:v},null,8,["item"])])):"component"in v?(s(),u("div",es,[(s(),_(B(v.component),G({ref_for:!0},v.props,{"screen-menu":""}),null,16))])):(s(),u("div",ts,[k(Jo,{text:v.text,items:v.items},null,8,["text","items"])]))],64))),128))],8,Qo)],2))}}),as=g(ns,[["__scopeId","data-v-64ac07c5"]]),os={key:0,class:"VPNavScreenMenu"},ss=p({__name:"VPNavScreenMenu",setup(e){const{theme:t}=L();return(n,a)=>i(t).nav?(s(),u("nav",os,[(s(!0),u(x,null,A(i(t).nav,o=>(s(),u(x,{key:JSON.stringify(o)},["link"in o?(s(),_(jo,{key:0,item:o},null,8,["item"])):"component"in o?(s(),_(B(o.component),G({key:1,ref_for:!0},o.props,{"screen-menu":""}),null,16)):(s(),_(as,{key:2,text:o.text||"",items:o.items},null,8,["text","items"]))],64))),128))])):m("",!0)}}),is=p({__name:"VPNavScreenSocialLinks",setup(e){const{theme:t}=L();return(n,a)=>i(t).socialLinks?(s(),_(be,{key:0,class:"VPNavScreenSocialLinks",links:i(t).socialLinks},null,8,["links"])):m("",!0)}}),rs={class:"list"},ls=p({__name:"VPNavScreenTranslations",setup(e){const{localeLinks:t,currentLang:n}=R({correspondingLink:!0}),a=S(!1);function o(){a.value=!a.value}return(r,l)=>i(t).length&&i(n).label?(s(),u("div",{key:0,class:N(["VPNavScreenTranslations",{open:a.value}])},[d("button",{class:"title",onClick:o},[l[0]||(l[0]=d("span",{class:"vpi-languages icon lang"},null,-1)),j(" "+M(i(n).label)+" ",1),l[1]||(l[1]=d("span",{class:"vpi-chevron-down icon chevron"},null,-1))]),d("ul",rs,[(s(!0),u(x,null,A(i(t),v=>(s(),u("li",{key:v.link,class:"item"},[k(E,{class:"link",href:v.link},{default:h(()=>[j(M(v.text),1)]),_:2},1032,["href"])]))),128))])],2)):m("",!0)}}),cs=g(ls,[["__scopeId","data-v-83363e92"]]),us={class:"container"},ds=p({__name:"VPNavScreen",props:{open:{type:Boolean}},setup(e){const t=S(null),n=Se(ee?document.body:null);return(a,o)=>(s(),_(ue,{name:"fade",onEnter:o[0]||(o[0]=r=>n.value=!0),onAfterLeave:o[1]||(o[1]=r=>n.value=!1)},{default:h(()=>[e.open?(s(),u("div",{key:0,class:"VPNavScreen",ref_key:"screen",ref:t,id:"VPNavScreen"},[d("div",us,[c(a.$slots,"nav-screen-content-before",{},void 0,!0),k(ss,{class:"menu"}),k(cs,{class:"translations"}),k(Oo,{class:"appearance"}),k(is,{class:"social-links"}),c(a.$slots,"nav-screen-content-after",{},void 0,!0)])],512)):m("",!0)]),_:3}))}}),vs=g(ds,[["__scopeId","data-v-cf9782ac"]]),fs={key:0,class:"VPNav"},hs=p({__name:"VPNav",setup(e){const{isScreenOpen:t,closeScreen:n,toggleScreen:a}=la(),{frontmatter:o}=L(),r=y(()=>o.value.navbar!==!1);return Te("close-screen",n),X(()=>{ee&&document.documentElement.classList.toggle("hide-nav",!r.value)}),(l,v)=>r.value?(s(),u("header",fs,[k(Bo,{"is-screen-open":i(t),onToggleScreen:i(a)},{"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(vs,{open:i(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)}}),ms=g(hs,[["__scopeId","data-v-bd330aa5"]]),ps=["role","tabindex"],ks={key:1,class:"items"},_s=p({__name:"VPSidebarItem",props:{item:{},depth:{}},setup(e){const t=e,{collapsed:n,collapsible:a,isLink:o,isActiveLink:r,hasActiveLink:l,hasChildren:v,toggle:f}=dt(y(()=>t.item)),$=y(()=>v.value?"section":"div"),V=y(()=>o.value?"a":"div"),b=y(()=>v.value?t.depth+2===7?"p":`h${t.depth+2}`:"p"),P=y(()=>o.value?void 0:"button"),T=y(()=>[[`level-${t.depth}`],{collapsible:a.value},{collapsed:n.value},{"is-link":o.value},{"is-active":r.value},{"has-active":l.value}]);function I(C){"key"in C&&C.key!=="Enter"||!t.item.link&&f()}function w(){t.item.link&&f()}return(C,H)=>{const O=W("VPSidebarItem",!0);return s(),_(B($.value),{class:N(["VPSidebarItem",T.value])},{default:h(()=>[e.item.text?(s(),u("div",G({key:0,class:"item",role:P.value},je(e.item.items?{click:I,keydown:I}:{},!0),{tabindex:e.item.items&&0}),[H[1]||(H[1]=d("div",{class:"indicator"},null,-1)),e.item.link?(s(),_(E,{key:0,tag:V.value,class:"link",href:e.item.link,rel:e.item.rel,target:e.item.target},{default:h(()=>[(s(),_(B(b.value),{class:"text",innerHTML:e.item.text},null,8,["innerHTML"]))]),_:1},8,["tag","href","rel","target"])):(s(),_(B(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:w,onKeydown:ze(w,["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",ks,[e.depth<5?(s(!0),u(x,{key:0},A(e.item.items,K=>(s(),_(O,{key:K.text,item:K,depth:e.depth+1},null,8,["item","depth"]))),128)):m("",!0)])):m("",!0)]),_:1},8,["class"])}}}),bs=g(_s,[["__scopeId","data-v-5197b7ef"]]),gs=p({__name:"VPSidebarGroup",props:{items:{}},setup(e){const t=S(!0);let n=null;return U(()=>{n=setTimeout(()=>{n=null,t.value=!1},300)}),We(()=>{n!=null&&(clearTimeout(n),n=null)}),(a,o)=>(s(!0),u(x,null,A(e.items,r=>(s(),u("div",{key:r.text,class:N(["group",{"no-transition":t.value}])},[k(bs,{item:r,depth:0},null,8,["item"])],2))),128))}}),$s=g(gs,[["__scopeId","data-v-5bec1c30"]]),ys={class:"nav",id:"VPSidebarNav","aria-labelledby":"sidebar-aria-label",tabindex:"-1"},Ps=p({__name:"VPSidebar",props:{open:{type:Boolean}},setup(e){const{sidebarGroups:t,hasSidebar:n}=D(),a=e,o=S(null),r=Se(ee?document.body:null);F([a,o],()=>{var v;a.open?(r.value=!0,(v=o.value)==null||v.focus()):r.value=!1},{immediate:!0,flush:"post"});const l=S(0);return F(t,()=>{l.value+=1},{deep:!0}),(v,f)=>i(n)?(s(),u("aside",{key:0,class:N(["VPSidebar",{open:e.open}]),ref_key:"navEl",ref:o,onClick:f[0]||(f[0]=Ke(()=>{},["stop"]))},[f[2]||(f[2]=d("div",{class:"curtain"},null,-1)),d("nav",ys,[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(),_($s,{items:i(t),key:l.value},null,8,["items"])),c(v.$slots,"sidebar-nav-after",{},void 0,!0)])],2)):m("",!0)}}),Ls=g(Ps,[["__scopeId","data-v-b3580139"]]),Vs=p({__name:"VPSkipLink",setup(e){const{theme:t}=L(),n=Q(),a=S();F(()=>n.path,()=>a.value.focus());function o({target:r}){const l=document.getElementById(decodeURIComponent(r.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(r,l)=>(s(),u(x,null,[d("span",{ref_key:"backToTop",ref:a,tabindex:"-1"},null,512),d("a",{href:"#VPContent",class:"VPSkipLink visually-hidden",onClick:o},M(i(t).skipToContentLabel||"Skip to content"),1)],64))}}),Ss=g(Vs,[["__scopeId","data-v-932c1003"]]),Ts=p({__name:"Layout",setup(e){const{isOpen:t,open:n,close:a}=D(),o=Q();F(()=>o.path,a),ut(t,a);const{frontmatter:r}=L(),l=Re(),v=y(()=>!!l["home-hero-image"]);return Te("hero-image-slot-exists",v),(f,$)=>{const V=W("Content");return i(r).layout!==!1?(s(),u("div",{key:0,class:N(["Layout",i(r).pageClass])},[c(f.$slots,"layout-top",{},void 0,!0),k(Ss),k(Ye,{class:"backdrop",show:i(t),onClick:i(a)},null,8,["show","onClick"]),k(ms,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(ra,{open:i(t),onOpenMenu:i(n)},null,8,["open","onOpenMenu"]),k(Ls,{open:i(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(Wn,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(Xn),c(f.$slots,"layout-bottom",{},void 0,!0)],2)):(s(),_(V,{key:1}))}}}),Ns=g(Ts,[["__scopeId","data-v-f3720c7e"]]),Ms={Layout:Ns,enhanceApp:({app:e})=>{e.component("Badge",qe)}},Is={...Ms};export{Is as R,uo as c,L as u};
@@ -1,4 +1,4 @@
1
- import{_ as i,o as a,c as e,a2 as t}from"./chunks/framework.DvDCk5Jp.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 &quot;原生 HTML 使用 libs 与远程组件&quot;">​</a></h1><h2 id="esm-与-umd-两种浏览器交付" tabindex="-1">ESM 与 UMD 两种浏览器交付 <a class="header-anchor" href="#esm-与-umd-两种浏览器交付" aria-label="Permalink to &quot;ESM 与 UMD 两种浏览器交付&quot;">​</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>&lt;script&gt;</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: &#39;umd&#39;</code> 生成,多入口逐个生成,动态 import 内联。业务在最终压缩后混淆,第三方独立为 vendor。全局入口统一为 <code>window.MeltPackages[&#39;@melt-js/包名/子路径&#39;]</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 &quot;入口与交付&quot;">​</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 &quot;Vue 3 最小接入&quot;">​</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;">&lt;</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;">&quot;https://unpkg.com/vue@3.5.45/dist/vue.global.prod.js&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt;&lt;/</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">script</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt;</span></span>
1
+ import{_ as i,o as a,c as e,a2 as t}from"./chunks/framework.qU75dRxB.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 &quot;原生 HTML 使用 libs 与远程组件&quot;">​</a></h1><h2 id="esm-与-umd-两种浏览器交付" tabindex="-1">ESM 与 UMD 两种浏览器交付 <a class="header-anchor" href="#esm-与-umd-两种浏览器交付" aria-label="Permalink to &quot;ESM 与 UMD 两种浏览器交付&quot;">​</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>&lt;script&gt;</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: &#39;umd&#39;</code> 生成,多入口逐个生成,动态 import 内联。业务在最终压缩后混淆,第三方独立为 vendor。全局入口统一为 <code>window.MeltPackages[&#39;@melt-js/包名/子路径&#39;]</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 &quot;入口与交付&quot;">​</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 &quot;Vue 3 最小接入&quot;">​</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;">&lt;</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;">&quot;https://unpkg.com/vue@3.5.45/dist/vue.global.prod.js&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt;&lt;/</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">script</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt;</span></span>
2
2
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&lt;</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;">&quot;importmap&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt;</span></span>
3
3
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
4
4
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> &quot;imports&quot;: {</span></span>
@@ -1 +1 @@
1
- import{_ as i,o as a,c as e,a2 as t}from"./chunks/framework.DvDCk5Jp.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};
1
+ import{_ as i,o as a,c as e,a2 as t}from"./chunks/framework.qU75dRxB.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};
@@ -1 +1 @@
1
- import{_ as o,o as d,c as t,a2 as c}from"./chunks/framework.DvDCk5Jp.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 &quot;核心分层与 API 收敛&quot;">​</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 &quot;分层职责&quot;">​</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 &quot;当前已有&quot;">​</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 &quot;接下来收敛什么&quot;">​</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};
1
+ import{_ as o,o as d,c as t,a2 as c}from"./chunks/framework.qU75dRxB.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 &quot;核心分层与 API 收敛&quot;">​</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 &quot;分层职责&quot;">​</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 &quot;当前已有&quot;">​</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 &quot;接下来收敛什么&quot;">​</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};
@@ -1 +1 @@
1
- import{_ as o,o as d,c as t,a2 as c}from"./chunks/framework.DvDCk5Jp.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};
1
+ import{_ as o,o as d,c as t,a2 as c}from"./chunks/framework.qU75dRxB.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};
@@ -1,4 +1,4 @@
1
- import{_ as i,o as a,c as n,a2 as t}from"./chunks/framework.DvDCk5Jp.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 &quot;快速上手&quot;">​</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 &quot;运行一个现有示例&quot;">​</a></h2><p>仓库使用 <code>pnpm@12.18.0</code>,Node.js 要求 <code>&gt;=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>
1
+ import{_ as i,o as a,c as n,a2 as t}from"./chunks/framework.qU75dRxB.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 &quot;快速上手&quot;">​</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 &quot;运行一个现有示例&quot;">​</a></h2><p>仓库使用 <code>pnpm@12.18.0</code>,Node.js 要求 <code>&gt;=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
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
3
  <span class="line"></span>
4
4
  <span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># 终端二:宿主示例,端口 30050</span></span>
@@ -1 +1 @@
1
- import{_ as i,o as a,c as n,a2 as t}from"./chunks/framework.DvDCk5Jp.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};
1
+ import{_ as i,o as a,c as n,a2 as t}from"./chunks/framework.qU75dRxB.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};
@@ -1,4 +1,4 @@
1
- import{_ as e,o as s,c as o,a2 as t}from"./chunks/framework.DvDCk5Jp.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 &quot;项目介绍&quot;">​</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 &quot;两种加载方式,一套开发体验&quot;">​</a></h2><ul><li><strong>高频组件预加载</strong>:导航、布局、常用表单等在启动阶段准备好,业务层继续 <code>import x from &#39;@melt-js/xxx&#39;</code>,不必到处编写远程加载代码。</li><li><strong>低频组件懒加载</strong>:偶发弹窗、重型图表、领域扩展等在真正使用时加载,目标是几行代码即可接入,并内置加载态、报错 fallback 等默认行为。</li></ul><p>两者应复用同一套底层加载、地址解析和错误规范,不各自维护一套远程协议。预加载仍有网络成本,只是把等待前置到启动阶段;懒加载的粒度取决于远程包的拆分,不等于每个组件天然独立下载。</p><h2 id="模块如何配合" tabindex="-1">模块如何配合 <a class="header-anchor" href="#模块如何配合" aria-label="Permalink to &quot;模块如何配合&quot;">​</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>
1
+ import{_ as e,o as s,c as o,a2 as t}from"./chunks/framework.qU75dRxB.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 &quot;项目介绍&quot;">​</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 &quot;两种加载方式,一套开发体验&quot;">​</a></h2><ul><li><strong>高频组件预加载</strong>:导航、布局、常用表单等在启动阶段准备好,业务层继续 <code>import x from &#39;@melt-js/xxx&#39;</code>,不必到处编写远程加载代码。</li><li><strong>低频组件懒加载</strong>:偶发弹窗、重型图表、领域扩展等在真正使用时加载,目标是几行代码即可接入,并内置加载态、报错 fallback 等默认行为。</li></ul><p>两者应复用同一套底层加载、地址解析和错误规范,不各自维护一套远程协议。预加载仍有网络成本,只是把等待前置到启动阶段;懒加载的粒度取决于远程包的拆分,不等于每个组件天然独立下载。</p><h2 id="模块如何配合" tabindex="-1">模块如何配合 <a class="header-anchor" href="#模块如何配合" aria-label="Permalink to &quot;模块如何配合&quot;">​</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
2
  <span class="line"><span> ├─ 高频:启动预加载 → 像本地包一样 import</span></span>
3
3
  <span class="line"><span> └─ 低频:首次使用 → 框架适配层 → 默认加载态 / 错误兜底</span></span>
4
4
  <span class="line"><span> ↓</span></span>
@@ -1 +1 @@
1
- import{_ as e,o as s,c as o,a2 as t}from"./chunks/framework.DvDCk5Jp.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};
1
+ import{_ as e,o as s,c as o,a2 as t}from"./chunks/framework.qU75dRxB.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};
@@ -1,4 +1,4 @@
1
- import{_ as e,o as i,c as a,a2 as t}from"./chunks/framework.DvDCk5Jp.js";const k=JSON.parse('{"title":"预加载与懒加载","description":"","frontmatter":{},"headers":[],"relativePath":"guide/loading.md","filePath":"guide/loading.md","lastUpdated":1794799239000}'),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 &quot;预加载与懒加载&quot;">​</a></h1><p>核心不是让业务感知“远程”,而是让它用最少的接入代码获得公共组件。加载策略由宿主决定,远程细节由公共层承接。</p><h2 id="高频组件预加载" tabindex="-1">高频组件预加载 <a class="header-anchor" href="#高频组件预加载" aria-label="Permalink to &quot;高频组件预加载&quot;">​</a></h2><p>适合布局、常驻导航、首屏高频交互等启动后很快就要使用的能力。</p><ol><li>在应用入口配置远程地址和共享运行时。</li><li>预加载必要模块,确认导出已就绪。</li><li>动态进入 <code>loadApp</code> 业务入口;页面直接 <code>import { Comp } from &#39;@melt-js/xxx&#39;</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;"> &#39;@melt-js/libs-core&#39;</span></span>
1
+ import{_ as e,o as i,c as a,a2 as t}from"./chunks/framework.qU75dRxB.js";const k=JSON.parse('{"title":"预加载与懒加载","description":"","frontmatter":{},"headers":[],"relativePath":"guide/loading.md","filePath":"guide/loading.md","lastUpdated":1794734946000}'),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 &quot;预加载与懒加载&quot;">​</a></h1><p>核心不是让业务感知“远程”,而是让它用最少的接入代码获得公共组件。加载策略由宿主决定,远程细节由公共层承接。</p><h2 id="高频组件预加载" tabindex="-1">高频组件预加载 <a class="header-anchor" href="#高频组件预加载" aria-label="Permalink to &quot;高频组件预加载&quot;">​</a></h2><p>适合布局、常驻导航、首屏高频交互等启动后很快就要使用的能力。</p><ol><li>在应用入口配置远程地址和共享运行时。</li><li>预加载必要模块,确认导出已就绪。</li><li>动态进入 <code>loadApp</code> 业务入口;页面直接 <code>import { Comp } from &#39;@melt-js/xxx&#39;</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;"> &#39;@melt-js/libs-core&#39;</span></span>
2
2
  <span class="line"></span>
3
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
4
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> type: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;custom&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
@@ -11,7 +11,7 @@ import{_ as e,o as i,c as a,a2 as t}from"./chunks/framework.DvDCk5Jp.js";const k
11
11
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ],</span></span>
12
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
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;">=&gt;</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;">&#39;./loadApp&#39;</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 &quot;tpl / demo 统一入口&quot;">​</a></h3><p>试点为 <code>demo-vue3</code>:<code>main</code> 只做共享运行时绑定、高频预加载与启动错误展示,成功后 <code>await import(&#39;./loadApp&#39;)</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: { text: &#39;正在准备应用…&#39;, background: &#39;#050f33&#39;, color: &#39;#38bdf8&#39; }</code>。已有自身 loading 的模板沿用原实现,不自动叠加公共遮罩;demo-vue3 显式开启。</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: () =&gt; import(&#39;./loadApp&#39;).then(app =&gt; 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 &#39;@melt-js/comps-vue3&#39;</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 &quot;地址预设与版本协议&quot;">​</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_&lt;SLOT&gt;_HOST</code> / <code>VUE_APP_&lt;SLOT&gt;_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: &#39;comps-vue3&#39;, host: &#39;http://localhost:20020&#39;, requiredExports: [&#39;HelloWorld&#39;] }</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 &quot;低频组件懒加载&quot;">​</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;"> &#39;@melt-js/libs-core&#39;</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 &quot;tpl / demo 统一入口&quot;">​</a></h3><p>试点为 <code>demo-vue3</code>:<code>main</code> 只做共享运行时绑定、高频预加载与启动错误展示,成功后 <code>await import(&#39;./loadApp&#39;)</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: { text: &#39;正在准备应用…&#39;, background: &#39;#050f33&#39;, color: &#39;#38bdf8&#39; }</code>。已有自身 loading 的模板沿用原实现,不自动叠加公共遮罩;demo-vue3 显式开启。</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: () =&gt; import(&#39;./loadApp&#39;).then(app =&gt; 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 &#39;@melt-js/comps-vue3&#39;</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 &quot;地址预设与版本协议&quot;">​</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 在本仓库对应 SFTP 托管的 HTTP 地址,传 <code>base: import.meta.env.VITE_SFTP_PUBLIC_URL</code> 即可。根 <code>.env</code> 的 <code>SFTP_PUBLIC_URL</code> 是公共站点根(<code>http://xx.xx.xx.xx</code>),不是某个包的产物地址;修改后执行 <code>pnpm env:sync</code>。Vue 2 使用 <code>process.env.VUE_APP_SFTP_PUBLIC_URL</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: &#39;comps-vue3&#39;, host: &#39;http://localhost:20020&#39;, requiredExports: [&#39;HelloWorld&#39;] }</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 &quot;低频组件懒加载&quot;">​</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;"> &#39;@melt-js/libs-core&#39;</span></span>
15
15
  <span class="line"></span>
16
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
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;">&#39;@example/comps-charts&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, { type: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;github&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> })</span></span>
@@ -1 +1 @@
1
- import{_ as e,o as i,c as a,a2 as t}from"./chunks/framework.DvDCk5Jp.js";const k=JSON.parse('{"title":"预加载与懒加载","description":"","frontmatter":{},"headers":[],"relativePath":"guide/loading.md","filePath":"guide/loading.md","lastUpdated":1794799239000}'),d={name:"guide/loading.md"};function o(l,s,p,n,c,h){return i(),a("div",null,[...s[0]||(s[0]=[t("",48)])])}const E=e(d,[["render",o]]);export{k as __pageData,E as default};
1
+ import{_ as e,o as i,c as a,a2 as t}from"./chunks/framework.qU75dRxB.js";const k=JSON.parse('{"title":"预加载与懒加载","description":"","frontmatter":{},"headers":[],"relativePath":"guide/loading.md","filePath":"guide/loading.md","lastUpdated":1794734946000}'),d={name:"guide/loading.md"};function o(l,s,p,n,c,h){return i(),a("div",null,[...s[0]||(s[0]=[t("",48)])])}const E=e(d,[["render",o]]);export{k as __pageData,E as default};