sparkforensics-cli 0.2.0 → 0.2.2

package/export-template/docs/assets/chunks/{VPLocalSearchBox.yJbZbsEo.js → VPLocalSearchBox.BkBIPFs6.js}

@@ -1,4 +1,4 @@
-var Ot=Object.defineProperty;var At=(a,e,t)=>e in a?Ot(a,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):a[e]=t;var Me=(a,e,t)=>At(a,typeof e!="symbol"?e+"":e,t);import{V as Ct,q as Be,ak as Mt,h as be,al as nt,am as Lt,an as Dt,ao as Pt,G as ce,d as zt,ap as rt,p as he,aq as Vt,ar as jt,s as $t,as as Bt,v as Le,P as ve,O as xe,a2 as Wt,at as Kt,W as Jt,R as qt,$ as Ut,o as q,b as Ht,j as T,a0 as Gt,k as P,a3 as Qt,a4 as Yt,au as Zt,c as Q,n as it,e as _e,B as st,F as at,a as pe,t as me,av as Xt,aw as ot,ax as en,a9 as tn,ae as nn,ay as rn,_ as sn}from"./framework.DSg0KOwT.js";import{u as an,c as on}from"./theme.Df2VAG9w.js";const ln={root:()=>Ct(()=>import("./@localSearchIndexroot.DNY8bVcl.js"),[])};/*!
+var Ot=Object.defineProperty;var At=(a,e,t)=>e in a?Ot(a,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):a[e]=t;var Me=(a,e,t)=>At(a,typeof e!="symbol"?e+"":e,t);import{V as Ct,q as Be,ak as Mt,h as be,al as nt,am as Lt,an as Dt,ao as Pt,G as ce,d as zt,ap as rt,p as he,aq as Vt,ar as jt,s as $t,as as Bt,v as Le,P as ve,O as xe,a2 as Wt,at as Kt,W as Jt,R as qt,$ as Ut,o as q,b as Ht,j as T,a0 as Gt,k as P,a3 as Qt,a4 as Yt,au as Zt,c as Q,n as it,e as _e,B as st,F as at,a as pe,t as me,av as Xt,aw as ot,ax as en,a9 as tn,ae as nn,ay as rn,_ as sn}from"./framework.DSg0KOwT.js";import{u as an,c as on}from"./theme.DP0u1AUq.js";const ln={root:()=>Ct(()=>import("./@localSearchIndexroot.DppnXnDE.js"),[])};/*!
 * tabbable 6.5.0
 * @license MIT, https://github.com/focus-trap/tabbable/blob/master/LICENSE
 */var gt=["input:not([inert]):not([inert] *)","select:not([inert]):not([inert] *)","textarea:not([inert]):not([inert] *)","a[href]:not([inert]):not([inert] *)","area[href]:not([inert]):not([inert] *)","button:not([inert]):not([inert] *)","[tabindex]:not(slot):not([inert]):not([inert] *)","audio[controls]:not([inert]):not([inert] *)","video[controls]:not([inert]):not([inert] *)",'[contenteditable]:not([contenteditable="false"]):not([inert]):not([inert] *)',"details>summary:first-of-type:not([inert]):not([inert] *)","details:not([inert]):not([inert] *)"],ke=gt.join(","),bt=typeof Element>"u",ae=bt?function(){}:Element.prototype.matches||Element.prototype.msMatchesSelector||Element.prototype.webkitMatchesSelector,Ne=!bt&&Element.prototype.getRootNode?function(a){var e;return a==null||(e=a.getRootNode)===null||e===void 0?void 0:e.call(a)}:function(a){return a==null?void 0:a.ownerDocument},Fe=function(e,t){var n;t===void 0&&(t=!0);var r=e==null||(n=e.getAttribute)===null||n===void 0?void 0:n.call(e,"inert"),s=r===""||r==="true",i=s||t&&e&&(typeof e.closest=="function"?e.closest("[inert]"):Fe(e.parentNode));return i},cn=function(e){var t,n=e==null||(t=e.getAttribute)===null||t===void 0?void 0:t.call(e,"contenteditable");return n===""||n==="true"},yt=function(e,t,n){if(Fe(e))return[];var r=Array.prototype.slice.apply(e.querySelectorAll(ke));return t&&ae.call(e,ke)&&r.unshift(e),r=r.filter(n),r},Re=function(e,t,n){for(var r=[],s=Array.from(e);s.length;){var i=s.shift();if(!Fe(i,!1))if(i.tagName==="SLOT"){var o=i.assignedElements(),l=o.length?o:i.children,c=Re(l,!0,n);n.flatten?r.push.apply(r,c):r.push({scopeParent:i,candidates:c})}else{var h=ae.call(i,ke);h&&n.filter(i)&&(t||!e.includes(i))&&r.push(i);var m=i.shadowRoot||typeof n.getShadowRoot=="function"&&n.getShadowRoot(i),p=!Fe(m,!1)&&(!n.shadowRootFilter||n.shadowRootFilter(i));if(m&&p){var b=Re(m===!0?i.children:m.children,!0,n);n.flatten?r.push.apply(r,b):r.push({scopeParent:i,candidates:b})}else s.unshift.apply(s,i.children)}}return r},wt=function(e){return!isNaN(parseInt(e.getAttribute("tabindex"),10))},se=function(e){if(!e)throw new Error("No node provided");return e.tabIndex<0&&(/^(AUDIO|VIDEO|DETAILS)$/.test(e.tagName)||cn(e))&&!wt(e)?0:e.tabIndex},un=function(e,t){var n=se(e);return n<0&&t&&!wt(e)?0:n},dn=function(e,t){return e.tabIndex===t.tabIndex?e.documentOrder-t.documentOrder:e.tabIndex-t.tabIndex},St=function(e){return e.tagName==="INPUT"},fn=function(e){return St(e)&&e.type==="hidden"},hn=function(e){var t=e.tagName==="DETAILS"&&Array.prototype.slice.apply(e.children).some(function(n){return n.tagName==="SUMMARY"});return t},vn=function(e,t){for(var n=0;n<e.length;n++)if(e[n].checked&&e[n].form===t)return e[n]},pn=function(e){if(!e.name)return!0;var t=e.form||Ne(e),n=function(o){return t.querySelectorAll('input[type="radio"][name="'+o+'"]')},r;if(typeof window<"u"&&typeof window.CSS<"u"&&typeof window.CSS.escape=="function")r=n(window.CSS.escape(e.name));else try{r=n(e.name)}catch(i){return console.error("Looks like you have a radio button with a name attribute containing invalid CSS selector characters and need the CSS.escape polyfill: %s",i.message),!1}var s=vn(r,e.form);return!s||s===e},mn=function(e){return St(e)&&e.type==="radio"},gn=function(e){return mn(e)&&!pn(e)},bn=function(e){var t,n=e&&Ne(e),r=(t=n)===null||t===void 0?void 0:t.host,s=!1;if(n&&n!==e){var i,o,l;for(s=!!((i=r)!==null&&i!==void 0&&(o=i.ownerDocument)!==null&&o!==void 0&&o.contains(r)||e!=null&&(l=e.ownerDocument)!==null&&l!==void 0&&l.contains(e));!s&&r;){var c,h,m;n=Ne(r),r=(c=n)===null||c===void 0?void 0:c.host,s=!!((h=r)!==null&&h!==void 0&&(m=h.ownerDocument)!==null&&m!==void 0&&m.contains(r))}}return s},lt=function(e){var t=e.getBoundingClientRect(),n=t.width,r=t.height;return n===0&&r===0},yn=function(e,t){var n=t.displayCheck,r=t.getShadowRoot;if(n==="full-native"&&"checkVisibility"in e){var s=e.checkVisibility({checkOpacity:!1,opacityProperty:!1,contentVisibilityAuto:!0,visibilityProperty:!0,checkVisibilityCSS:!0});return!s}var i=getComputedStyle(e),o=i.visibility;if(o==="hidden"||o==="collapse")return!0;var l=ae.call(e,"details>summary:first-of-type"),c=l?e.parentElement:e;if(ae.call(c,"details:not([open]) *"))return!0;if(!n||n==="full"||n==="full-native"||n==="legacy-full"){if(typeof r=="function"){for(var h=e;e;){var m=e.parentElement,p=Ne(e);if(m&&!m.shadowRoot&&r(m)===!0)return lt(e);e.assignedSlot?e=e.assignedSlot:!m&&p!==e.ownerDocument?e=p.host:e=m}e=h}if(bn(e))return!e.getClientRects().length;if(n!=="legacy-full")return!0}else if(n==="non-zero-area")return lt(e);return!1},wn=function(e){if(/^(INPUT|BUTTON|SELECT|TEXTAREA)$/.test(e.tagName))for(var t=e.parentElement;t;){if(t.tagName==="FIELDSET"&&t.disabled){for(var n=0;n<t.children.length;n++){var r=t.children.item(n);if(r.tagName==="LEGEND")return ae.call(t,"fieldset[disabled] *")?!0:!r.contains(e)}return!0}t=t.parentElement}return!1},Oe=function(e,t){return!(t.disabled||fn(t)||yn(t,e)||hn(t)||wn(t))},We=function(e,t){return!(gn(t)||se(t)<0||!Oe(e,t))},Sn=function(e){var t=parseInt(e.getAttribute("tabindex"),10);return!!(isNaN(t)||t>=0)},xt=function(e){var t=[],n=[];return e.forEach(function(r,s){var i=!!r.scopeParent,o=i?r.scopeParent:r,l=un(o,i),c=i?xt(r.candidates):o;l===0?i?t.push.apply(t,c):t.push(o):n.push({documentOrder:s,tabIndex:l,item:r,isScope:i,content:c})}),n.sort(dn).reduce(function(r,s){return s.isScope?r.push.apply(r,s.content):r.push(s.content),r},[]).concat(t)},xn=function(e,t){t=t||{};var n;return t.getShadowRoot?n=Re([e],t.includeContainer,{filter:We.bind(null,t),flatten:!1,getShadowRoot:t.getShadowRoot,shadowRootFilter:Sn}):n=yt(e,t.includeContainer,We.bind(null,t)),xt(n)},_n=function(e,t){t=t||{};var n;return t.getShadowRoot?n=Re([e],t.includeContainer,{filter:Oe.bind(null,t),flatten:!0,getShadowRoot:t.getShadowRoot}):n=yt(e,t.includeContainer,Oe.bind(null,t)),n},oe=function(e,t){if(t=t||{},!e)throw new Error("No node provided");return ae.call(e,ke)===!1?!1:We(t,e)},Tn=gt.concat("iframe:not([inert]):not([inert] *)").join(","),De=function(e,t){if(t=t||{},!e)throw new Error("No node provided");return ae.call(e,Tn)===!1?!1:Oe(t,e)};/*!

package/export-template/docs/assets/chunks/theme.DP0u1AUq.js

@@ -0,0 +1,2 @@
+const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/chunks/VPLocalSearchBox.BkBIPFs6.js","assets/chunks/framework.DSg0KOwT.js"])))=>i.map(i=>d[i]);
+import{d as p,c as d,r as u,n as T,o as r,a as B,t as x,b as g,w as m,T as _e,e as h,_ as k,u as Be,i as Ye,f as Xe,g as O,h as $,j as i,k as l,l as K,m as me,p as V,q as U,s as se,v as z,x as ye,y as $e,z as Ze,A as et,F as M,B as E,C as W,D as ie,E as b,G as He,H as D,I as Oe,J as re,K as R,L as le,M as tt,N as Fe,O as he,P as ne,Q as De,R as X,S as nt,U as at,V as ot,W as je,X as Ue,Y as st,Z as it,$ as rt,a0 as qe,a1 as lt,a2 as ct,a3 as ut,a4 as dt,a5 as xe}from"./framework.DSg0KOwT.js";const vt=p({__name:"VPBadge",props:{text:{},type:{default:"tip"}},setup(e){return(t,n)=>(r(),d("span",{class:T(["VPBadge",e.type])},[u(t.$slots,"default",{},()=>[B(x(e.text),1)])],2))}}),ft={key:0,class:"VPBackdrop"},mt=p({__name:"VPBackdrop",props:{show:{type:Boolean}},setup(e){return(t,n)=>(r(),g(_e,{name:"fade"},{default:m(()=>[e.show?(r(),d("div",ft)):h("",!0)]),_:1}))}}),ht=k(mt,[["__scopeId","data-v-c79a1216"]]),L=Be;function pt(e,t){let n,a=!1;return()=>{n&&clearTimeout(n),a?n=setTimeout(e,t):(e(),(a=!0)&&setTimeout(()=>a=!1,t))}}function pe(e){return e.startsWith("/")?e:`/${e}`}function Pe(e){const{pathname:t,search:n,hash:a,protocol:o}=new URL(e,"http://a.com");if(Ye(e)||e.startsWith("#")||!o.startsWith("http")||!Xe(t))return e;const{site:c}=L(),s=t.endsWith("/")||t.endsWith(".html")?e:e.replace(/(?:(^\.+)\/)?.*$/,`$1${t.replace(/(\.md)?$/,c.value.cleanUrls?"":".html")}${n}${a}`);return O(s)}function Z({correspondingLink:e=!1}={}){const{site:t,localeIndex:n,page:a,theme:o,hash:c}=L(),s=$(()=>{var v,y;return{label:(v=t.value.locales[n.value])==null?void 0:v.label,link:((y=t.value.locales[n.value])==null?void 0:y.link)||(n.value==="root"?"/":`/${n.value}/`)}});return{localeLinks:$(()=>Object.entries(t.value.locales).flatMap(([v,y])=>s.value.label===y.label?[]:{text:y.label,link:bt(y.link||(v==="root"?"/":`/${v}/`),o.value.i18nRouting!==!1&&e,a.value.relativePath.slice(s.value.link.length-1),!t.value.cleanUrls)+c.value})),currentLang:s}}function bt(e,t,n,a){return t?e.replace(/\/$/,"")+pe(n.replace(/(^|\/)index\.md$/,"$1").replace(/\.md$/,a?".html":"")):e}const gt={class:"NotFound"},kt={class:"code"},_t={class:"title"},yt={class:"quote"},$t={class:"action"},Pt=["href","aria-label"],Lt=p({__name:"NotFound",setup(e){const{theme:t}=L(),{currentLang:n}=Z();return(a,o)=>{var c,s,f,v,y;return r(),d("div",gt,[i("p",kt,x(((c=l(t).notFound)==null?void 0:c.code)??"404"),1),i("h1",_t,x(((s=l(t).notFound)==null?void 0:s.title)??"PAGE NOT FOUND"),1),o[0]||(o[0]=i("div",{class:"divider"},null,-1)),i("blockquote",yt,x(((f=l(t).notFound)==null?void 0:f.quote)??"But if you don't change your direction, and if you keep looking, you may end up where you are heading."),1),i("div",$t,[i("a",{class:"link",href:l(O)(l(n).link),"aria-label":((v=l(t).notFound)==null?void 0:v.linkLabel)??"go to home"},x(((y=l(t).notFound)==null?void 0:y.linkText)??"Take me home"),9,Pt)])])}}}),St=k(Lt,[["__scopeId","data-v-d6be1790"]]);function Ge(e,t){if(Array.isArray(e))return ee(e);if(e==null)return[];t=pe(t);const n=Object.keys(e).sort((o,c)=>c.split("/").length-o.split("/").length).find(o=>t.startsWith(pe(o))),a=n?e[n]:[];return Array.isArray(a)?ee(a):ee(a.items,a.base)}function Vt(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 wt(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 be(e,t){return Array.isArray(t)?t.some(n=>be(e,n)):K(e,t.link)?!0:t.items?be(e,t.items):!1}function ee(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=ee(a.items,o)),a})}function q(){const{frontmatter:e,page:t,theme:n}=L(),a=me("(min-width: 960px)"),o=V(!1),c=$(()=>{const A=n.value.sidebar,H=t.value.relativePath;return A?Ge(A,H):[]}),s=V(c.value);U(c,(A,H)=>{JSON.stringify(A)!==JSON.stringify(H)&&(s.value=c.value)});const f=$(()=>e.value.sidebar!==!1&&s.value.length>0&&e.value.layout!=="home"),v=$(()=>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),S=$(()=>f.value&&a.value),_=$(()=>f.value?Vt(s.value):[]);function P(){o.value=!0}function w(){o.value=!1}function N(){o.value?w():P()}return{isOpen:o,sidebar:s,sidebarGroups:_,hasSidebar:f,hasAside:y,leftAside:v,isSidebarEnabled:S,open:P,close:w,toggle:N}}function Tt(e,t){let n;se(()=>{n=e.value?document.activeElement:void 0}),z(()=>{window.addEventListener("keyup",a)}),ye(()=>{window.removeEventListener("keyup",a)});function a(o){o.key==="Escape"&&e.value&&(t(),n==null||n.focus())}}function xt(e){const{page:t,hash:n}=L(),a=V(!1),o=$(()=>e.value.collapsed!=null),c=$(()=>!!e.value.link),s=V(!1),f=()=>{s.value=K(t.value.relativePath,e.value.link)};U([t,e,n],f),z(f);const v=$(()=>s.value?!0:e.value.items?be(t.value.relativePath,e.value.items):!1),y=$(()=>!!(e.value.items&&e.value.items.length));se(()=>{a.value=!!(o.value&&e.value.collapsed)}),$e(()=>{(s.value||v.value)&&(a.value=!1)});function S(){o.value&&(a.value=!a.value)}return{collapsed:a,collapsible:o,isLink:c,isActiveLink:s,hasActiveLink:v,hasChildren:y,toggle:S}}function Mt(){const{hasSidebar:e}=q(),t=me("(min-width: 960px)"),n=me("(min-width: 1280px)");return{isAsideEnabled:$(()=>!n.value&&!t.value?!1:e.value?n.value:t.value)}}const Nt=/\b(?:VPBadge|header-anchor|footnote-ref|ignore-header)\b/,ge=[];function Re(e){return typeof e.outline=="object"&&!Array.isArray(e.outline)&&e.outline.label||e.outlineTitle||"On this page"}function Le(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:At(n),link:"#"+n.id,level:a}});return It(t,e)}function At(e){let t="";for(const n of e.childNodes)if(n.nodeType===1){if(Nt.test(n.className))continue;t+=n.textContent}else n.nodeType===3&&(t+=n.textContent);return t.trim()}function It(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 Bt(e,a,o)}function Ct(e,t){const{isAsideEnabled:n}=Mt(),a=pt(c,100);let o=null;z(()=>{requestAnimationFrame(c),window.addEventListener("scroll",a)}),Ze(()=>{s(location.hash)}),ye(()=>{window.removeEventListener("scroll",a)});function c(){if(!n.value)return;const f=window.scrollY,v=window.innerHeight,y=document.body.offsetHeight,S=Math.abs(f+v-y)<1,_=ge.map(({element:w,link:N})=>({link:N,top:Et(w)})).filter(({top:w})=>!Number.isNaN(w)).sort((w,N)=>w.top-N.top);if(!_.length){s(null);return}if(f<1){s(null);return}if(S){s(_[_.length-1].link);return}let P=null;for(const{link:w,top:N}of _){if(N>f+et()+4)break;P=w}s(P)}function s(f){o&&o.classList.remove("active"),f==null?o=null:o=e.value.querySelector(`a[href="${decodeURIComponent(f)}"]`);const v=o;v?(v.classList.add("active"),t.value.style.top=v.offsetTop+39+"px",t.value.style.opacity="1"):(t.value.style.top="33px",t.value.style.opacity="0")}}function Et(e){let t=0;for(;e!==document.body;){if(e===null)return NaN;t+=e.offsetTop,e=e.offsetParent}return t}function Bt(e,t,n){ge.length=0;const a=[],o=[];return e.forEach(c=>{const s={...c,children:[]};let f=o[o.length-1];for(;f&&f.level>=s.level;)o.pop(),f=o[o.length-1];if(s.element.classList.contains("ignore-header")||f&&"shouldIgnore"in f){o.push({level:s.level,shouldIgnore:!0});return}s.level>n||s.level<t||(ge.push({element:s.element,link:s.link}),f?f.children.push(s):a.push(s),o.push(s))}),a}const Ht=["href","title"],Ot=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 r(),d("ul",{class:T(["VPDocOutlineItem",e.root?"root":"nested"])},[(r(!0),d(M,null,E(e.headers,({children:c,link:s,title:f})=>(r(),d("li",null,[i("a",{class:"outline-link",href:s,onClick:t,title:f},x(f),9,Ht),c!=null&&c.length?(r(),g(o,{key:0,headers:c},null,8,["headers"])):h("",!0)]))),256))],2)}}}),ze=k(Ot,[["__scopeId","data-v-b933a997"]]),Ft={class:"content"},Dt={"aria-level":"2",class:"outline-title",id:"doc-outline-aria-label",role:"heading"},jt=p({__name:"VPDocAsideOutline",setup(e){const{frontmatter:t,theme:n}=L(),a=He([]);ie(()=>{a.value=Le(t.value.outline??n.value.outline)});const o=V(),c=V();return Ct(o,c),(s,f)=>(r(),d("nav",{"aria-labelledby":"doc-outline-aria-label",class:T(["VPDocAsideOutline",{"has-outline":a.value.length>0}]),ref_key:"container",ref:o},[i("div",Ft,[i("div",{class:"outline-marker",ref_key:"marker",ref:c},null,512),i("div",Dt,x(l(Re)(l(n))),1),b(ze,{headers:a.value,root:!0},null,8,["headers"])])],2))}}),Ut=k(jt,[["__scopeId","data-v-a5bbad30"]]),qt={class:"VPDocAsideCarbonAds"},Gt=p({__name:"VPDocAsideCarbonAds",props:{carbonAds:{}},setup(e){const t=()=>null;return(n,a)=>(r(),d("div",qt,[b(l(t),{"carbon-ads":e.carbonAds},null,8,["carbon-ads"])]))}}),Rt={class:"VPDocAside"},zt=p({__name:"VPDocAside",setup(e){const{theme:t}=L();return(n,a)=>(r(),d("div",Rt,[u(n.$slots,"aside-top",{},void 0,!0),u(n.$slots,"aside-outline-before",{},void 0,!0),b(Ut),u(n.$slots,"aside-outline-after",{},void 0,!0),a[0]||(a[0]=i("div",{class:"spacer"},null,-1)),u(n.$slots,"aside-ads-before",{},void 0,!0),l(t).carbonAds?(r(),g(Gt,{key:0,"carbon-ads":l(t).carbonAds},null,8,["carbon-ads"])):h("",!0),u(n.$slots,"aside-ads-after",{},void 0,!0),u(n.$slots,"aside-bottom",{},void 0,!0)]))}}),Kt=k(zt,[["__scopeId","data-v-3f215769"]]);function Wt(){const{theme:e,page:t}=L();return $(()=>{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 Jt(){const{page:e,theme:t,frontmatter:n}=L();return $(()=>{var y,S,_,P,w,N,A,H;const a=Ge(t.value.sidebar,e.value.relativePath),o=wt(a),c=Qt(o,F=>F.link.replace(/[?#].*$/,"")),s=c.findIndex(F=>K(e.value.relativePath,F.link)),f=((y=t.value.docFooter)==null?void 0:y.prev)===!1&&!n.value.prev||n.value.prev===!1,v=((S=t.value.docFooter)==null?void 0:S.next)===!1&&!n.value.next||n.value.next===!1;return{prev:f?void 0:{text:(typeof n.value.prev=="string"?n.value.prev:typeof n.value.prev=="object"?n.value.prev.text:void 0)??((_=c[s-1])==null?void 0:_.docFooterText)??((P=c[s-1])==null?void 0:P.text),link:(typeof n.value.prev=="object"?n.value.prev.link:void 0)??((w=c[s-1])==null?void 0:w.link)},next:v?void 0:{text:(typeof n.value.next=="string"?n.value.next:typeof n.value.next=="object"?n.value.next.text:void 0)??((N=c[s+1])==null?void 0:N.docFooterText)??((A=c[s+1])==null?void 0:A.text),link:(typeof n.value.next=="object"?n.value.next.link:void 0)??((H=c[s+1])==null?void 0:H.link)}}})}function Qt(e,t){const n=new Set;return e.filter(a=>{const o=t(a);return n.has(o)?!1:n.add(o)})}const j=p({__name:"VPLink",props:{tag:{},href:{},noIcon:{type:Boolean},target:{},rel:{}},setup(e){const t=e,n=$(()=>t.tag??(t.href?"a":"span")),a=$(()=>t.href&&Oe.test(t.href)||t.target==="_blank");return(o,c)=>(r(),g(D(n.value),{class:T(["VPLink",{link:e.href,"vp-external-link-icon":a.value,"no-icon":e.noIcon}]),href:e.href?l(Pe)(e.href):void 0,target:e.target??(a.value?"_blank":void 0),rel:e.rel??(a.value?"noreferrer":void 0)},{default:m(()=>[u(o.$slots,"default")]),_:3},8,["class","href","target","rel"]))}}),Yt={class:"VPLastUpdated"},Xt=["datetime"],Zt=p({__name:"VPDocFooterLastUpdated",setup(e){const{theme:t,page:n,lang:a}=L(),o=$(()=>new Date(n.value.lastUpdated)),c=$(()=>o.value.toISOString()),s=V("");return z(()=>{se(()=>{var f,v,y;s.value=new Intl.DateTimeFormat((v=(f=t.value.lastUpdated)==null?void 0:f.formatOptions)!=null&&v.forceLocale?a.value:void 0,((y=t.value.lastUpdated)==null?void 0:y.formatOptions)??{dateStyle:"short",timeStyle:"short"}).format(o.value)})}),(f,v)=>{var y;return r(),d("p",Yt,[B(x(((y=l(t).lastUpdated)==null?void 0:y.text)||l(t).lastUpdatedText||"Last updated")+": ",1),i("time",{datetime:c.value},x(s.value),9,Xt)])}}}),en=k(Zt,[["__scopeId","data-v-e98dd255"]]),tn={key:0,class:"VPDocFooter"},nn={key:0,class:"edit-info"},an={key:0,class:"edit-link"},on={key:1,class:"last-updated"},sn={key:1,class:"prev-next","aria-labelledby":"doc-footer-aria-label"},rn={class:"pager"},ln=["innerHTML"],cn=["innerHTML"],un={class:"pager"},dn=["innerHTML"],vn=["innerHTML"],fn=p({__name:"VPDocFooter",setup(e){const{theme:t,page:n,frontmatter:a}=L(),o=Wt(),c=Jt(),s=$(()=>t.value.editLink&&a.value.editLink!==!1),f=$(()=>n.value.lastUpdated),v=$(()=>s.value||f.value||c.value.prev||c.value.next);return(y,S)=>{var _,P,w,N;return v.value?(r(),d("footer",tn,[u(y.$slots,"doc-footer-before",{},void 0,!0),s.value||f.value?(r(),d("div",nn,[s.value?(r(),d("div",an,[b(j,{class:"edit-link-button",href:l(o).url,"no-icon":!0},{default:m(()=>[S[0]||(S[0]=i("span",{class:"vpi-square-pen edit-link-icon"},null,-1)),B(" "+x(l(o).text),1)]),_:1},8,["href"])])):h("",!0),f.value?(r(),d("div",on,[b(en)])):h("",!0)])):h("",!0),(_=l(c).prev)!=null&&_.link||(P=l(c).next)!=null&&P.link?(r(),d("nav",sn,[S[1]||(S[1]=i("span",{class:"visually-hidden",id:"doc-footer-aria-label"},"Pager",-1)),i("div",rn,[(w=l(c).prev)!=null&&w.link?(r(),g(j,{key:0,class:"pager-link prev",href:l(c).prev.link},{default:m(()=>{var A;return[i("span",{class:"desc",innerHTML:((A=l(t).docFooter)==null?void 0:A.prev)||"Previous page"},null,8,ln),i("span",{class:"title",innerHTML:l(c).prev.text},null,8,cn)]}),_:1},8,["href"])):h("",!0)]),i("div",un,[(N=l(c).next)!=null&&N.link?(r(),g(j,{key:0,class:"pager-link next",href:l(c).next.link},{default:m(()=>{var A;return[i("span",{class:"desc",innerHTML:((A=l(t).docFooter)==null?void 0:A.next)||"Next page"},null,8,dn),i("span",{class:"title",innerHTML:l(c).next.text},null,8,vn)]}),_:1},8,["href"])):h("",!0)])])):h("",!0)])):h("",!0)}}}),mn=k(fn,[["__scopeId","data-v-e257564d"]]),hn={class:"container"},pn={class:"aside-container"},bn={class:"aside-content"},gn={class:"content"},kn={class:"content-container"},_n={class:"main"},yn=p({__name:"VPDoc",setup(e){const{theme:t}=L(),n=re(),{hasSidebar:a,hasAside:o,leftAside:c}=q(),s=$(()=>n.path.replace(/[./]+/g,"_").replace(/_html$/,""));return(f,v)=>{const y=W("Content");return r(),d("div",{class:T(["VPDoc",{"has-sidebar":l(a),"has-aside":l(o)}])},[u(f.$slots,"doc-top",{},void 0,!0),i("div",hn,[l(o)?(r(),d("div",{key:0,class:T(["aside",{"left-aside":l(c)}])},[v[0]||(v[0]=i("div",{class:"aside-curtain"},null,-1)),i("div",pn,[i("div",bn,[b(Kt,null,{"aside-top":m(()=>[u(f.$slots,"aside-top",{},void 0,!0)]),"aside-bottom":m(()=>[u(f.$slots,"aside-bottom",{},void 0,!0)]),"aside-outline-before":m(()=>[u(f.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":m(()=>[u(f.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":m(()=>[u(f.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":m(()=>[u(f.$slots,"aside-ads-after",{},void 0,!0)]),_:3})])])],2)):h("",!0),i("div",gn,[i("div",kn,[u(f.$slots,"doc-before",{},void 0,!0),i("main",_n,[b(y,{class:T(["vp-doc",[s.value,l(t).externalLinkIcon&&"external-link-icon-enabled"]])},null,8,["class"])]),b(mn,null,{"doc-footer-before":m(()=>[u(f.$slots,"doc-footer-before",{},void 0,!0)]),_:3}),u(f.$slots,"doc-after",{},void 0,!0)])])]),u(f.$slots,"doc-bottom",{},void 0,!0)],2)}}}),$n=k(yn,[["__scopeId","data-v-39a288b8"]]),Pn=p({__name:"VPButton",props:{tag:{},size:{default:"medium"},theme:{default:"brand"},text:{},href:{},target:{},rel:{}},setup(e){const t=e,n=$(()=>t.href&&Oe.test(t.href)),a=$(()=>t.tag||(t.href?"a":"button"));return(o,c)=>(r(),g(D(a.value),{class:T(["VPButton",[e.size,e.theme]]),href:e.href?l(Pe)(e.href):void 0,target:t.target??(n.value?"_blank":void 0),rel:t.rel??(n.value?"noreferrer":void 0)},{default:m(()=>[B(x(e.text),1)]),_:1},8,["class","href","target","rel"]))}}),Ln=k(Pn,[["__scopeId","data-v-fa7799d5"]]),Sn=["src","alt"],Vn=p({inheritAttrs:!1,__name:"VPImage",props:{image:{},alt:{}},setup(e){return(t,n)=>{const a=W("VPImage",!0);return e.image?(r(),d(M,{key:0},[typeof e.image=="string"||"src"in e.image?(r(),d("img",R({key:0,class:"VPImage"},typeof e.image=="string"?t.$attrs:{...e.image,...t.$attrs},{src:l(O)(typeof e.image=="string"?e.image:e.image.src),alt:e.alt??(typeof e.image=="string"?"":e.image.alt||"")}),null,16,Sn)):(r(),d(M,{key:1},[b(a,R({class:"dark",image:e.image.dark,alt:e.image.alt},t.$attrs),null,16,["image","alt"]),b(a,R({class:"light",image:e.image.light,alt:e.image.alt},t.$attrs),null,16,["image","alt"])],64))],64)):h("",!0)}}}),ae=k(Vn,[["__scopeId","data-v-8426fc1a"]]),wn={class:"container"},Tn={class:"main"},xn={class:"heading"},Mn=["innerHTML"],Nn=["innerHTML"],An=["innerHTML"],In={key:0,class:"actions"},Cn={key:0,class:"image"},En={class:"image-container"},Bn=p({__name:"VPHero",props:{name:{},text:{},tagline:{},image:{},actions:{}},setup(e){const t=le("hero-image-slot-exists");return(n,a)=>(r(),d("div",{class:T(["VPHero",{"has-image":e.image||l(t)}])},[i("div",wn,[i("div",Tn,[u(n.$slots,"home-hero-info-before",{},void 0,!0),u(n.$slots,"home-hero-info",{},()=>[i("h1",xn,[e.name?(r(),d("span",{key:0,innerHTML:e.name,class:"name clip"},null,8,Mn)):h("",!0),e.text?(r(),d("span",{key:1,innerHTML:e.text,class:"text"},null,8,Nn)):h("",!0)]),e.tagline?(r(),d("p",{key:0,innerHTML:e.tagline,class:"tagline"},null,8,An)):h("",!0)],!0),u(n.$slots,"home-hero-info-after",{},void 0,!0),e.actions?(r(),d("div",In,[(r(!0),d(M,null,E(e.actions,o=>(r(),d("div",{key:o.link,class:"action"},[b(Ln,{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))])):h("",!0),u(n.$slots,"home-hero-actions-after",{},void 0,!0)]),e.image||l(t)?(r(),d("div",Cn,[i("div",En,[a[0]||(a[0]=i("div",{class:"image-bg"},null,-1)),u(n.$slots,"home-hero-image",{},()=>[e.image?(r(),g(ae,{key:0,class:"image-src",image:e.image},null,8,["image"])):h("",!0)],!0)])])):h("",!0)])],2))}}),Hn=k(Bn,[["__scopeId","data-v-4f9c455b"]]),On=p({__name:"VPHomeHero",setup(e){const{frontmatter:t}=L();return(n,a)=>l(t).hero?(r(),g(Hn,{key:0,class:"VPHomeHero",name:l(t).hero.name,text:l(t).hero.text,tagline:l(t).hero.tagline,image:l(t).hero.image,actions:l(t).hero.actions},{"home-hero-info-before":m(()=>[u(n.$slots,"home-hero-info-before")]),"home-hero-info":m(()=>[u(n.$slots,"home-hero-info")]),"home-hero-info-after":m(()=>[u(n.$slots,"home-hero-info-after")]),"home-hero-actions-after":m(()=>[u(n.$slots,"home-hero-actions-after")]),"home-hero-image":m(()=>[u(n.$slots,"home-hero-image")]),_:3},8,["name","text","tagline","image","actions"])):h("",!0)}}),Fn={class:"box"},Dn={key:0,class:"icon"},jn=["innerHTML"],Un=["innerHTML"],qn=["innerHTML"],Gn={key:4,class:"link-text"},Rn={class:"link-text-value"},zn=p({__name:"VPFeature",props:{icon:{},title:{},details:{},link:{},linkText:{},rel:{},target:{}},setup(e){return(t,n)=>(r(),g(j,{class:"VPFeature",href:e.link,rel:e.rel,target:e.target,"no-icon":!0,tag:e.link?"a":"div"},{default:m(()=>[i("article",Fn,[typeof e.icon=="object"&&e.icon.wrap?(r(),d("div",Dn,[b(ae,{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"?(r(),g(ae,{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?(r(),d("div",{key:2,class:"icon",innerHTML:e.icon},null,8,jn)):h("",!0),i("h2",{class:"title",innerHTML:e.title},null,8,Un),e.details?(r(),d("p",{key:3,class:"details",innerHTML:e.details},null,8,qn)):h("",!0),e.linkText?(r(),d("div",Gn,[i("p",Rn,[B(x(e.linkText)+" ",1),n[0]||(n[0]=i("span",{class:"vpi-arrow-right link-text-icon"},null,-1))])])):h("",!0)])]),_:1},8,["href","rel","target","tag"]))}}),Kn=k(zn,[["__scopeId","data-v-a3976bdc"]]),Wn={key:0,class:"VPFeatures"},Jn={class:"container"},Qn={class:"items"},Yn=p({__name:"VPFeatures",props:{features:{}},setup(e){const t=e,n=$(()=>{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?(r(),d("div",Wn,[i("div",Jn,[i("div",Qn,[(r(!0),d(M,null,E(e.features,c=>(r(),d("div",{key:c.title,class:T(["item",[n.value]])},[b(Kn,{icon:c.icon,title:c.title,details:c.details,link:c.link,"link-text":c.linkText,rel:c.rel,target:c.target},null,8,["icon","title","details","link","link-text","rel","target"])],2))),128))])])])):h("",!0)}}),Xn=k(Yn,[["__scopeId","data-v-a6181336"]]),Zn=p({__name:"VPHomeFeatures",setup(e){const{frontmatter:t}=L();return(n,a)=>l(t).features?(r(),g(Xn,{key:0,class:"VPHomeFeatures",features:l(t).features},null,8,["features"])):h("",!0)}}),ea=p({__name:"VPHomeContent",setup(e){const{width:t}=tt({initialWidth:0,includeScrollbar:!1});return(n,a)=>(r(),d("div",{class:"vp-doc container",style:Fe(l(t)?{"--vp-offset":`calc(50% - ${l(t)/2}px)`}:{})},[u(n.$slots,"default",{},void 0,!0)],4))}}),ta=k(ea,[["__scopeId","data-v-8e2d4988"]]),na=p({__name:"VPHome",setup(e){const{frontmatter:t,theme:n}=L();return(a,o)=>{const c=W("Content");return r(),d("div",{class:T(["VPHome",{"external-link-icon-enabled":l(n).externalLinkIcon}])},[u(a.$slots,"home-hero-before",{},void 0,!0),b(On,null,{"home-hero-info-before":m(()=>[u(a.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":m(()=>[u(a.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":m(()=>[u(a.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":m(()=>[u(a.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":m(()=>[u(a.$slots,"home-hero-image",{},void 0,!0)]),_:3}),u(a.$slots,"home-hero-after",{},void 0,!0),u(a.$slots,"home-features-before",{},void 0,!0),b(Zn),u(a.$slots,"home-features-after",{},void 0,!0),l(t).markdownStyles!==!1?(r(),g(ta,{key:0},{default:m(()=>[b(c)]),_:1})):(r(),g(c,{key:1}))],2)}}}),aa=k(na,[["__scopeId","data-v-8b561e3d"]]),oa={},sa={class:"VPPage"};function ia(e,t){const n=W("Content");return r(),d("div",sa,[u(e.$slots,"page-top"),b(n),u(e.$slots,"page-bottom")])}const ra=k(oa,[["render",ia]]),la=p({__name:"VPContent",setup(e){const{page:t,frontmatter:n}=L(),{hasSidebar:a}=q();return(o,c)=>(r(),d("div",{class:T(["VPContent",{"has-sidebar":l(a),"is-home":l(n).layout==="home"}]),id:"VPContent"},[l(t).isNotFound?u(o.$slots,"not-found",{},()=>[b(St)],!0,0):l(n).layout==="page"?(r(),g(ra,{key:1},{"page-top":m(()=>[u(o.$slots,"page-top",{},void 0,!0)]),"page-bottom":m(()=>[u(o.$slots,"page-bottom",{},void 0,!0)]),_:3})):l(n).layout==="home"?(r(),g(aa,{key:2},{"home-hero-before":m(()=>[u(o.$slots,"home-hero-before",{},void 0,!0)]),"home-hero-info-before":m(()=>[u(o.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":m(()=>[u(o.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":m(()=>[u(o.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":m(()=>[u(o.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":m(()=>[u(o.$slots,"home-hero-image",{},void 0,!0)]),"home-hero-after":m(()=>[u(o.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":m(()=>[u(o.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":m(()=>[u(o.$slots,"home-features-after",{},void 0,!0)]),_:3})):l(n).layout&&l(n).layout!=="doc"?(r(),g(D(l(n).layout),{key:3})):(r(),g($n,{key:4},{"doc-top":m(()=>[u(o.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":m(()=>[u(o.$slots,"doc-bottom",{},void 0,!0)]),"doc-footer-before":m(()=>[u(o.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":m(()=>[u(o.$slots,"doc-before",{},void 0,!0)]),"doc-after":m(()=>[u(o.$slots,"doc-after",{},void 0,!0)]),"aside-top":m(()=>[u(o.$slots,"aside-top",{},void 0,!0)]),"aside-outline-before":m(()=>[u(o.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":m(()=>[u(o.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":m(()=>[u(o.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":m(()=>[u(o.$slots,"aside-ads-after",{},void 0,!0)]),"aside-bottom":m(()=>[u(o.$slots,"aside-bottom",{},void 0,!0)]),_:3}))],2))}}),ca=k(la,[["__scopeId","data-v-1428d186"]]),ua={class:"container"},da=["innerHTML"],va=["innerHTML"],fa=p({__name:"VPFooter",setup(e){const{theme:t,frontmatter:n}=L(),{hasSidebar:a}=q();return(o,c)=>l(t).footer&&l(n).footer!==!1?(r(),d("footer",{key:0,class:T(["VPFooter",{"has-sidebar":l(a)}])},[i("div",ua,[l(t).footer.message?(r(),d("p",{key:0,class:"message",innerHTML:l(t).footer.message},null,8,da)):h("",!0),l(t).footer.copyright?(r(),d("p",{key:1,class:"copyright",innerHTML:l(t).footer.copyright},null,8,va)):h("",!0)])],2)):h("",!0)}}),ma=k(fa,[["__scopeId","data-v-e315a0ad"]]);function ha(){const{theme:e,frontmatter:t}=L(),n=He([]),a=$(()=>n.value.length>0);return ie(()=>{n.value=Le(t.value.outline??e.value.outline)}),{headers:n,hasLocalNav:a}}const pa={class:"menu-text"},ba={class:"header"},ga={class:"outline"},ka=p({__name:"VPLocalNavOutlineDropdown",props:{headers:{},navHeight:{}},setup(e){const t=e,{theme:n}=L(),a=V(!1),o=V(0),c=V(),s=V();function f(_){var P;(P=c.value)!=null&&P.contains(_.target)||(a.value=!1)}U(a,_=>{if(_){document.addEventListener("click",f);return}document.removeEventListener("click",f)}),he("Escape",()=>{a.value=!1}),ie(()=>{a.value=!1});function v(){a.value=!a.value,o.value=window.innerHeight+Math.min(window.scrollY-t.navHeight,0)}function y(_){_.target.classList.contains("outline-link")&&(s.value&&(s.value.style.transition="none"),ne(()=>{a.value=!1}))}function S(){a.value=!1,window.scrollTo({top:0,left:0,behavior:"smooth"})}return(_,P)=>(r(),d("div",{class:"VPLocalNavOutlineDropdown",style:Fe({"--vp-vh":o.value+"px"}),ref_key:"main",ref:c},[e.headers.length>0?(r(),d("button",{key:0,onClick:v,class:T({open:a.value})},[i("span",pa,x(l(Re)(l(n))),1),P[0]||(P[0]=i("span",{class:"vpi-chevron-right icon"},null,-1))],2)):(r(),d("button",{key:1,onClick:S},x(l(n).returnToTopLabel||"Return to top"),1)),b(_e,{name:"flyout"},{default:m(()=>[a.value?(r(),d("div",{key:0,ref_key:"items",ref:s,class:"items",onClick:y},[i("div",ba,[i("a",{class:"top-link",href:"#",onClick:S},x(l(n).returnToTopLabel||"Return to top"),1)]),i("div",ga,[b(ze,{headers:e.headers},null,8,["headers"])])],512)):h("",!0)]),_:1})],4))}}),_a=k(ka,[["__scopeId","data-v-8a42e2b4"]]),ya={class:"container"},$a=["aria-expanded"],Pa={class:"menu-text"},La=p({__name:"VPLocalNav",props:{open:{type:Boolean}},emits:["open-menu"],setup(e){const{theme:t,frontmatter:n}=L(),{hasSidebar:a}=q(),{headers:o}=ha(),{y:c}=De(),s=V(0);z(()=>{s.value=parseInt(getComputedStyle(document.documentElement).getPropertyValue("--vp-nav-height"))}),ie(()=>{o.value=Le(n.value.outline??t.value.outline)});const f=$(()=>o.value.length===0),v=$(()=>f.value&&!a.value),y=$(()=>({VPLocalNav:!0,"has-sidebar":a.value,empty:f.value,fixed:v.value}));return(S,_)=>l(n).layout!=="home"&&(!v.value||l(c)>=s.value)?(r(),d("div",{key:0,class:T(y.value)},[i("div",ya,[l(a)?(r(),d("button",{key:0,class:"menu","aria-expanded":e.open,"aria-controls":"VPSidebarNav",onClick:_[0]||(_[0]=P=>S.$emit("open-menu"))},[_[1]||(_[1]=i("span",{class:"vpi-align-left menu-icon"},null,-1)),i("span",Pa,x(l(t).sidebarMenuLabel||"Menu"),1)],8,$a)):h("",!0),b(_a,{headers:l(o),navHeight:s.value},null,8,["headers","navHeight"])])],2)):h("",!0)}}),Sa=k(La,[["__scopeId","data-v-a6f0e41e"]]);function Va(){const e=V(!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 c=re();return U(()=>c.path,n),{isScreenOpen:e,openScreen:t,closeScreen:n,toggleScreen:a}}const wa={},Ta={class:"VPSwitch",type:"button",role:"switch"},xa={class:"check"},Ma={key:0,class:"icon"};function Na(e,t){return r(),d("button",Ta,[i("span",xa,[e.$slots.default?(r(),d("span",Ma,[u(e.$slots,"default",{},void 0,!0)])):h("",!0)])])}const Aa=k(wa,[["render",Na],["__scopeId","data-v-1d5665e3"]]),Ia=p({__name:"VPSwitchAppearance",setup(e){const{isDark:t,theme:n}=L(),a=le("toggle-appearance",()=>{t.value=!t.value}),o=V("");return $e(()=>{o.value=t.value?n.value.lightModeSwitchTitle||"Switch to light theme":n.value.darkModeSwitchTitle||"Switch to dark theme"}),(c,s)=>(r(),g(Aa,{title:o.value,class:"VPSwitchAppearance","aria-checked":l(t),onClick:l(a)},{default:m(()=>[...s[0]||(s[0]=[i("span",{class:"vpi-sun sun"},null,-1),i("span",{class:"vpi-moon moon"},null,-1)])]),_:1},8,["title","aria-checked","onClick"]))}}),Se=k(Ia,[["__scopeId","data-v-5337faa4"]]),Ca={key:0,class:"VPNavBarAppearance"},Ea=p({__name:"VPNavBarAppearance",setup(e){const{site:t}=L();return(n,a)=>l(t).appearance&&l(t).appearance!=="force-dark"&&l(t).appearance!=="force-auto"?(r(),d("div",Ca,[b(Se)])):h("",!0)}}),Ba=k(Ea,[["__scopeId","data-v-6c893767"]]),Ve=V();let Ke=!1,ve=0;function Ha(e){const t=V(!1);if(X){!Ke&&Oa(),ve++;const n=U(Ve,a=>{var o,c,s;a===e.el.value||(o=e.el.value)!=null&&o.contains(a)?(t.value=!0,(c=e.onFocus)==null||c.call(e)):(t.value=!1,(s=e.onBlur)==null||s.call(e))});ye(()=>{n(),ve--,ve||Fa()})}return nt(t)}function Oa(){document.addEventListener("focusin",We),Ke=!0,Ve.value=document.activeElement}function Fa(){document.removeEventListener("focusin",We)}function We(){Ve.value=document.activeElement}const Da={class:"VPMenuLink"},ja=["innerHTML"],Ua=p({__name:"VPMenuLink",props:{item:{}},setup(e){const{page:t}=L();return(n,a)=>(r(),d("div",Da,[b(j,{class:T({active:l(K)(l(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:m(()=>[i("span",{innerHTML:e.item.text},null,8,ja)]),_:1},8,["class","href","target","rel","no-icon"])]))}}),ce=k(Ua,[["__scopeId","data-v-35975db6"]]),qa={class:"VPMenuGroup"},Ga={key:0,class:"title"},Ra=p({__name:"VPMenuGroup",props:{text:{},items:{}},setup(e){return(t,n)=>(r(),d("div",qa,[e.text?(r(),d("p",Ga,x(e.text),1)):h("",!0),(r(!0),d(M,null,E(e.items,a=>(r(),d(M,null,["link"in a?(r(),g(ce,{key:0,item:a},null,8,["item"])):h("",!0)],64))),256))]))}}),za=k(Ra,[["__scopeId","data-v-69e747b5"]]),Ka={class:"VPMenu"},Wa={key:0,class:"items"},Ja=p({__name:"VPMenu",props:{items:{}},setup(e){return(t,n)=>(r(),d("div",Ka,[e.items?(r(),d("div",Wa,[(r(!0),d(M,null,E(e.items,a=>(r(),d(M,{key:JSON.stringify(a)},["link"in a?(r(),g(ce,{key:0,item:a},null,8,["item"])):"component"in a?(r(),g(D(a.component),R({key:1,ref_for:!0},a.props),null,16)):(r(),g(za,{key:2,text:a.text,items:a.items},null,8,["text","items"]))],64))),128))])):h("",!0),u(t.$slots,"default",{},void 0,!0)]))}}),Qa=k(Ja,[["__scopeId","data-v-b98bc113"]]),Ya=["aria-expanded","aria-label"],Xa={key:0,class:"text"},Za=["innerHTML"],eo={key:1,class:"vpi-more-horizontal icon"},to={class:"menu"},no=p({__name:"VPFlyout",props:{icon:{},button:{},label:{},items:{}},setup(e){const t=V(!1),n=V();Ha({el:n,onBlur:a});function a(){t.value=!1}return(o,c)=>(r(),d("div",{class:"VPFlyout",ref_key:"el",ref:n,onMouseenter:c[1]||(c[1]=s=>t.value=!0),onMouseleave:c[2]||(c[2]=s=>t.value=!1)},[i("button",{type:"button",class:"button","aria-haspopup":"true","aria-expanded":t.value,"aria-label":e.label,onClick:c[0]||(c[0]=s=>t.value=!t.value)},[e.button||e.icon?(r(),d("span",Xa,[e.icon?(r(),d("span",{key:0,class:T([e.icon,"option-icon"])},null,2)):h("",!0),e.button?(r(),d("span",{key:1,innerHTML:e.button},null,8,Za)):h("",!0),c[3]||(c[3]=i("span",{class:"vpi-chevron-down text-icon"},null,-1))])):(r(),d("span",eo))],8,Ya),i("div",to,[b(Qa,{items:e.items},{default:m(()=>[u(o.$slots,"default",{},void 0,!0)]),_:3},8,["items"])])],544))}}),we=k(no,[["__scopeId","data-v-cf11d7a2"]]),ao=["href","aria-label","innerHTML"],oo=p({__name:"VPSocialLink",props:{icon:{},link:{},ariaLabel:{}},setup(e){const t=e,n=V();z(async()=>{var c;await ne();const o=(c=n.value)==null?void 0:c.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=$(()=>typeof t.icon=="object"?t.icon.svg:`<span class="vpi-social-${t.icon}"></span>`);return(o,c)=>(r(),d("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,ao))}}),so=k(oo,[["__scopeId","data-v-bd121fe5"]]),io={class:"VPSocialLinks"},ro=p({__name:"VPSocialLinks",props:{links:{}},setup(e){return(t,n)=>(r(),d("div",io,[(r(!0),d(M,null,E(e.links,({link:a,icon:o,ariaLabel:c})=>(r(),g(so,{key:a,icon:o,link:a,ariaLabel:c},null,8,["icon","link","ariaLabel"]))),128))]))}}),Te=k(ro,[["__scopeId","data-v-7bc22406"]]),lo={key:0,class:"group translations"},co={class:"trans-title"},uo={key:1,class:"group"},vo={class:"item appearance"},fo={class:"label"},mo={class:"appearance-action"},ho={key:2,class:"group"},po={class:"item social-links"},bo=p({__name:"VPNavBarExtra",setup(e){const{site:t,theme:n}=L(),{localeLinks:a,currentLang:o}=Z({correspondingLink:!0}),c=$(()=>a.value.length&&o.value.label||t.value.appearance||n.value.socialLinks);return(s,f)=>c.value?(r(),g(we,{key:0,class:"VPNavBarExtra",label:"extra navigation"},{default:m(()=>[l(a).length&&l(o).label?(r(),d("div",lo,[i("p",co,x(l(o).label),1),(r(!0),d(M,null,E(l(a),v=>(r(),g(ce,{key:v.link,item:v},null,8,["item"]))),128))])):h("",!0),l(t).appearance&&l(t).appearance!=="force-dark"&&l(t).appearance!=="force-auto"?(r(),d("div",uo,[i("div",vo,[i("p",fo,x(l(n).darkModeSwitchLabel||"Appearance"),1),i("div",mo,[b(Se)])])])):h("",!0),l(n).socialLinks?(r(),d("div",ho,[i("div",po,[b(Te,{class:"social-links-list",links:l(n).socialLinks},null,8,["links"])])])):h("",!0)]),_:1})):h("",!0)}}),go=k(bo,[["__scopeId","data-v-bb2aa2f0"]]),ko=["aria-expanded"],_o=p({__name:"VPNavBarHamburger",props:{active:{type:Boolean}},emits:["click"],setup(e){return(t,n)=>(r(),d("button",{type:"button",class:T(["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]=[i("span",{class:"container"},[i("span",{class:"top"}),i("span",{class:"middle"}),i("span",{class:"bottom"})],-1)])],10,ko))}}),yo=k(_o,[["__scopeId","data-v-e5dd9c1c"]]),$o=["innerHTML"],Po=p({__name:"VPNavBarMenuLink",props:{item:{}},setup(e){const{page:t}=L();return(n,a)=>(r(),g(j,{class:T({VPNavBarMenuLink:!0,active:l(K)(l(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:m(()=>[i("span",{innerHTML:e.item.text},null,8,$o)]),_:1},8,["class","href","target","rel","no-icon"]))}}),Lo=k(Po,[["__scopeId","data-v-e56f3d57"]]),So=p({__name:"VPNavBarMenuGroup",props:{item:{}},setup(e){const t=e,{page:n}=L(),a=c=>"component"in c?!1:"link"in c?K(n.value.relativePath,c.link,!!t.item.activeMatch):c.items.some(a),o=$(()=>a(t.item));return(c,s)=>(r(),g(we,{class:T({VPNavBarMenuGroup:!0,active:l(K)(l(n).relativePath,e.item.activeMatch,!!e.item.activeMatch)||o.value}),button:e.item.text,items:e.item.items},null,8,["class","button","items"]))}}),Vo={key:0,"aria-labelledby":"main-nav-aria-label",class:"VPNavBarMenu"},wo=p({__name:"VPNavBarMenu",setup(e){const{theme:t}=L();return(n,a)=>l(t).nav?(r(),d("nav",Vo,[a[0]||(a[0]=i("span",{id:"main-nav-aria-label",class:"visually-hidden"}," Main Navigation ",-1)),(r(!0),d(M,null,E(l(t).nav,o=>(r(),d(M,{key:JSON.stringify(o)},["link"in o?(r(),g(Lo,{key:0,item:o},null,8,["item"])):"component"in o?(r(),g(D(o.component),R({key:1,ref_for:!0},o.props),null,16)):(r(),g(So,{key:2,item:o},null,8,["item"]))],64))),128))])):h("",!0)}}),To=k(wo,[["__scopeId","data-v-dc692963"]]);function xo(e){const{localeIndex:t,theme:n}=L();function a(o){var N,A,H;const c=o.split("."),s=(N=n.value.search)==null?void 0:N.options,f=s&&typeof s=="object",v=f&&((H=(A=s.locales)==null?void 0:A[t.value])==null?void 0:H.translations)||null,y=f&&s.translations||null;let S=v,_=y,P=e;const w=c.pop();for(const F of c){let G=null;const J=P==null?void 0:P[F];J&&(G=P=J);const ue=_==null?void 0:_[F];ue&&(G=_=ue);const de=S==null?void 0:S[F];de&&(G=S=de),J||(P=G),ue||(_=G),de||(S=G)}return(S==null?void 0:S[w])??(_==null?void 0:_[w])??(P==null?void 0:P[w])??""}return a}const Mo=["aria-label"],No={class:"DocSearch-Button-Container"},Ao={class:"DocSearch-Button-Placeholder"},Me=p({__name:"VPNavBarSearchButton",setup(e){const n=xo({button:{buttonText:"Search",buttonAriaLabel:"Search"}});return(a,o)=>(r(),d("button",{type:"button",class:"DocSearch DocSearch-Button","aria-label":l(n)("button.buttonAriaLabel")},[i("span",No,[o[0]||(o[0]=i("span",{class:"vp-icon DocSearch-Search-Icon"},null,-1)),i("span",Ao,x(l(n)("button.buttonText")),1)]),o[1]||(o[1]=i("span",{class:"DocSearch-Button-Keys"},[i("kbd",{class:"DocSearch-Button-Key"}),i("kbd",{class:"DocSearch-Button-Key"},"K")],-1))],8,Mo))}}),Io={class:"VPNavBarSearch"},Co={id:"local-search"},Eo={key:1,id:"docsearch"},Bo=p({__name:"VPNavBarSearch",setup(e){const t=at(()=>ot(()=>import("./VPLocalSearchBox.BkBIPFs6.js"),__vite__mapDeps([0,1]))),n=()=>null,{theme:a}=L(),o=V(!1),c=V(!1);z(()=>{});function s(){o.value||(o.value=!0,setTimeout(f,16))}function f(){const _=new Event("keydown");_.key="k",_.metaKey=!0,window.dispatchEvent(_),setTimeout(()=>{document.querySelector(".DocSearch-Modal")||f()},16)}function v(_){const P=_.target,w=P.tagName;return P.isContentEditable||w==="INPUT"||w==="SELECT"||w==="TEXTAREA"}const y=V(!1);he("k",_=>{(_.ctrlKey||_.metaKey)&&(_.preventDefault(),y.value=!0)}),he("/",_=>{v(_)||(_.preventDefault(),y.value=!0)});const S="local";return(_,P)=>{var w;return r(),d("div",Io,[l(S)==="local"?(r(),d(M,{key:0},[y.value?(r(),g(l(t),{key:0,onClose:P[0]||(P[0]=N=>y.value=!1)})):h("",!0),i("div",Co,[b(Me,{onClick:P[1]||(P[1]=N=>y.value=!0)})])],64)):l(S)==="algolia"?(r(),d(M,{key:1},[o.value?(r(),g(l(n),{key:0,algolia:((w=l(a).search)==null?void 0:w.options)??l(a).algolia,onVnodeBeforeMount:P[2]||(P[2]=N=>c.value=!0)},null,8,["algolia"])):h("",!0),c.value?h("",!0):(r(),d("div",Eo,[b(Me,{onClick:s})]))],64)):h("",!0)])}}}),Ho=p({__name:"VPNavBarSocialLinks",setup(e){const{theme:t}=L();return(n,a)=>l(t).socialLinks?(r(),g(Te,{key:0,class:"VPNavBarSocialLinks",links:l(t).socialLinks},null,8,["links"])):h("",!0)}}),Oo=k(Ho,[["__scopeId","data-v-0394ad82"]]),Fo=["href","rel","target"],Do=["innerHTML"],jo={key:2},Uo=p({__name:"VPNavBarTitle",setup(e){const{site:t,theme:n}=L(),{hasSidebar:a}=q(),{currentLang:o}=Z(),c=$(()=>{var v;return typeof n.value.logoLink=="string"?n.value.logoLink:(v=n.value.logoLink)==null?void 0:v.link}),s=$(()=>{var v;return typeof n.value.logoLink=="string"||(v=n.value.logoLink)==null?void 0:v.rel}),f=$(()=>{var v;return typeof n.value.logoLink=="string"||(v=n.value.logoLink)==null?void 0:v.target});return(v,y)=>(r(),d("div",{class:T(["VPNavBarTitle",{"has-sidebar":l(a)}])},[i("a",{class:"title",href:c.value??l(Pe)(l(o).link),rel:s.value,target:f.value},[u(v.$slots,"nav-bar-title-before",{},void 0,!0),l(n).logo?(r(),g(ae,{key:0,class:"logo",image:l(n).logo},null,8,["image"])):h("",!0),l(n).siteTitle?(r(),d("span",{key:1,innerHTML:l(n).siteTitle},null,8,Do)):l(n).siteTitle===void 0?(r(),d("span",jo,x(l(t).title),1)):h("",!0),u(v.$slots,"nav-bar-title-after",{},void 0,!0)],8,Fo)],2))}}),qo=k(Uo,[["__scopeId","data-v-1168a8e4"]]),Go={class:"items"},Ro={class:"title"},zo=p({__name:"VPNavBarTranslations",setup(e){const{theme:t}=L(),{localeLinks:n,currentLang:a}=Z({correspondingLink:!0});return(o,c)=>l(n).length&&l(a).label?(r(),g(we,{key:0,class:"VPNavBarTranslations",icon:"vpi-languages",label:l(t).langMenuLabel||"Change language"},{default:m(()=>[i("div",Go,[i("p",Ro,x(l(a).label),1),(r(!0),d(M,null,E(l(n),s=>(r(),g(ce,{key:s.link,item:s},null,8,["item"]))),128))])]),_:1},8,["label"])):h("",!0)}}),Ko=k(zo,[["__scopeId","data-v-88af2de4"]]),Wo={class:"wrapper"},Jo={class:"container"},Qo={class:"title"},Yo={class:"content"},Xo={class:"content-body"},Zo=p({__name:"VPNavBar",props:{isScreenOpen:{type:Boolean}},emits:["toggle-screen"],setup(e){const t=e,{y:n}=De(),{hasSidebar:a}=q(),{frontmatter:o}=L(),c=V({});return $e(()=>{c.value={"has-sidebar":a.value,home:o.value.layout==="home",top:n.value===0,"screen-open":t.isScreenOpen}}),(s,f)=>(r(),d("div",{class:T(["VPNavBar",c.value])},[i("div",Wo,[i("div",Jo,[i("div",Qo,[b(qo,null,{"nav-bar-title-before":m(()=>[u(s.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":m(()=>[u(s.$slots,"nav-bar-title-after",{},void 0,!0)]),_:3})]),i("div",Yo,[i("div",Xo,[u(s.$slots,"nav-bar-content-before",{},void 0,!0),b(Bo,{class:"search"}),b(To,{class:"menu"}),b(Ko,{class:"translations"}),b(Ba,{class:"appearance"}),b(Oo,{class:"social-links"}),b(go,{class:"extra"}),u(s.$slots,"nav-bar-content-after",{},void 0,!0),b(yo,{class:"hamburger",active:e.isScreenOpen,onClick:f[0]||(f[0]=v=>s.$emit("toggle-screen"))},null,8,["active"])])])])]),f[1]||(f[1]=i("div",{class:"divider"},[i("div",{class:"divider-line"})],-1))],2))}}),es=k(Zo,[["__scopeId","data-v-6aa21345"]]),ts={key:0,class:"VPNavScreenAppearance"},ns={class:"text"},as=p({__name:"VPNavScreenAppearance",setup(e){const{site:t,theme:n}=L();return(a,o)=>l(t).appearance&&l(t).appearance!=="force-dark"&&l(t).appearance!=="force-auto"?(r(),d("div",ts,[i("p",ns,x(l(n).darkModeSwitchLabel||"Appearance"),1),b(Se)])):h("",!0)}}),os=k(as,[["__scopeId","data-v-b44890b2"]]),ss=["innerHTML"],is=p({__name:"VPNavScreenMenuLink",props:{item:{}},setup(e){const t=le("close-screen");return(n,a)=>(r(),g(j,{class:"VPNavScreenMenuLink",href:e.item.link,target:e.item.target,rel:e.item.rel,"no-icon":e.item.noIcon,onClick:l(t)},{default:m(()=>[i("span",{innerHTML:e.item.text},null,8,ss)]),_:1},8,["href","target","rel","no-icon","onClick"]))}}),rs=k(is,[["__scopeId","data-v-df37e6dd"]]),ls=["innerHTML"],cs=p({__name:"VPNavScreenMenuGroupLink",props:{item:{}},setup(e){const t=le("close-screen");return(n,a)=>(r(),g(j,{class:"VPNavScreenMenuGroupLink",href:e.item.link,target:e.item.target,rel:e.item.rel,"no-icon":e.item.noIcon,onClick:l(t)},{default:m(()=>[i("span",{innerHTML:e.item.text},null,8,ls)]),_:1},8,["href","target","rel","no-icon","onClick"]))}}),Je=k(cs,[["__scopeId","data-v-3e9c20e4"]]),us={class:"VPNavScreenMenuGroupSection"},ds={key:0,class:"title"},vs=p({__name:"VPNavScreenMenuGroupSection",props:{text:{},items:{}},setup(e){return(t,n)=>(r(),d("div",us,[e.text?(r(),d("p",ds,x(e.text),1)):h("",!0),(r(!0),d(M,null,E(e.items,a=>(r(),g(Je,{key:a.text,item:a},null,8,["item"]))),128))]))}}),fs=k(vs,[["__scopeId","data-v-8133b170"]]),ms=["aria-controls","aria-expanded"],hs=["innerHTML"],ps=["id"],bs={key:0,class:"item"},gs={key:1,class:"item"},ks={key:2,class:"group"},_s=p({__name:"VPNavScreenMenuGroup",props:{text:{},items:{}},setup(e){const t=e,n=V(!1),a=$(()=>`NavScreenGroup-${t.text.replace(" ","-").toLowerCase()}`);function o(){n.value=!n.value}return(c,s)=>(r(),d("div",{class:T(["VPNavScreenMenuGroup",{open:n.value}])},[i("button",{class:"button","aria-controls":a.value,"aria-expanded":n.value,onClick:o},[i("span",{class:"button-text",innerHTML:e.text},null,8,hs),s[0]||(s[0]=i("span",{class:"vpi-plus button-icon"},null,-1))],8,ms),i("div",{id:a.value,class:"items"},[(r(!0),d(M,null,E(e.items,f=>(r(),d(M,{key:JSON.stringify(f)},["link"in f?(r(),d("div",bs,[b(Je,{item:f},null,8,["item"])])):"component"in f?(r(),d("div",gs,[(r(),g(D(f.component),R({ref_for:!0},f.props,{"screen-menu":""}),null,16))])):(r(),d("div",ks,[b(fs,{text:f.text,items:f.items},null,8,["text","items"])]))],64))),128))],8,ps)],2))}}),ys=k(_s,[["__scopeId","data-v-b9ab8c58"]]),$s={key:0,class:"VPNavScreenMenu"},Ps=p({__name:"VPNavScreenMenu",setup(e){const{theme:t}=L();return(n,a)=>l(t).nav?(r(),d("nav",$s,[(r(!0),d(M,null,E(l(t).nav,o=>(r(),d(M,{key:JSON.stringify(o)},["link"in o?(r(),g(rs,{key:0,item:o},null,8,["item"])):"component"in o?(r(),g(D(o.component),R({key:1,ref_for:!0},o.props,{"screen-menu":""}),null,16)):(r(),g(ys,{key:2,text:o.text||"",items:o.items},null,8,["text","items"]))],64))),128))])):h("",!0)}}),Ls=p({__name:"VPNavScreenSocialLinks",setup(e){const{theme:t}=L();return(n,a)=>l(t).socialLinks?(r(),g(Te,{key:0,class:"VPNavScreenSocialLinks",links:l(t).socialLinks},null,8,["links"])):h("",!0)}}),Ss={class:"list"},Vs=p({__name:"VPNavScreenTranslations",setup(e){const{localeLinks:t,currentLang:n}=Z({correspondingLink:!0}),a=V(!1);function o(){a.value=!a.value}return(c,s)=>l(t).length&&l(n).label?(r(),d("div",{key:0,class:T(["VPNavScreenTranslations",{open:a.value}])},[i("button",{class:"title",onClick:o},[s[0]||(s[0]=i("span",{class:"vpi-languages icon lang"},null,-1)),B(" "+x(l(n).label)+" ",1),s[1]||(s[1]=i("span",{class:"vpi-chevron-down icon chevron"},null,-1))]),i("ul",Ss,[(r(!0),d(M,null,E(l(t),f=>(r(),d("li",{key:f.link,class:"item"},[b(j,{class:"link",href:f.link},{default:m(()=>[B(x(f.text),1)]),_:2},1032,["href"])]))),128))])],2)):h("",!0)}}),ws=k(Vs,[["__scopeId","data-v-858fe1a4"]]),Ts={class:"container"},xs=p({__name:"VPNavScreen",props:{open:{type:Boolean}},setup(e){const t=V(null),n=je(X?document.body:null);return(a,o)=>(r(),g(_e,{name:"fade",onEnter:o[0]||(o[0]=c=>n.value=!0),onAfterLeave:o[1]||(o[1]=c=>n.value=!1)},{default:m(()=>[e.open?(r(),d("div",{key:0,class:"VPNavScreen",ref_key:"screen",ref:t,id:"VPNavScreen"},[i("div",Ts,[u(a.$slots,"nav-screen-content-before",{},void 0,!0),b(Ps,{class:"menu"}),b(ws,{class:"translations"}),b(os,{class:"appearance"}),b(Ls,{class:"social-links"}),u(a.$slots,"nav-screen-content-after",{},void 0,!0)])],512)):h("",!0)]),_:3}))}}),Ms=k(xs,[["__scopeId","data-v-f2779853"]]),Ns={key:0,class:"VPNav"},As=p({__name:"VPNav",setup(e){const{isScreenOpen:t,closeScreen:n,toggleScreen:a}=Va(),{frontmatter:o}=L(),c=$(()=>o.value.navbar!==!1);return Ue("close-screen",n),se(()=>{X&&document.documentElement.classList.toggle("hide-nav",!c.value)}),(s,f)=>c.value?(r(),d("header",Ns,[b(es,{"is-screen-open":l(t),onToggleScreen:l(a)},{"nav-bar-title-before":m(()=>[u(s.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":m(()=>[u(s.$slots,"nav-bar-title-after",{},void 0,!0)]),"nav-bar-content-before":m(()=>[u(s.$slots,"nav-bar-content-before",{},void 0,!0)]),"nav-bar-content-after":m(()=>[u(s.$slots,"nav-bar-content-after",{},void 0,!0)]),_:3},8,["is-screen-open","onToggleScreen"]),b(Ms,{open:l(t)},{"nav-screen-content-before":m(()=>[u(s.$slots,"nav-screen-content-before",{},void 0,!0)]),"nav-screen-content-after":m(()=>[u(s.$slots,"nav-screen-content-after",{},void 0,!0)]),_:3},8,["open"])])):h("",!0)}}),Is=k(As,[["__scopeId","data-v-ae24b3ad"]]),Cs=["role","tabindex"],Es={key:1,class:"items"},Bs=p({__name:"VPSidebarItem",props:{item:{},depth:{}},setup(e){const t=e,{collapsed:n,collapsible:a,isLink:o,isActiveLink:c,hasActiveLink:s,hasChildren:f,toggle:v}=xt($(()=>t.item)),y=$(()=>f.value?"section":"div"),S=$(()=>o.value?"a":"div"),_=$(()=>f.value?t.depth+2===7?"p":`h${t.depth+2}`:"p"),P=$(()=>o.value?void 0:"button"),w=$(()=>[[`level-${t.depth}`],{collapsible:a.value},{collapsed:n.value},{"is-link":o.value},{"is-active":c.value},{"has-active":s.value}]);function N(H){"key"in H&&H.key!=="Enter"||!t.item.link&&v()}function A(){t.item.link&&v()}return(H,F)=>{const G=W("VPSidebarItem",!0);return r(),g(D(y.value),{class:T(["VPSidebarItem",w.value])},{default:m(()=>[e.item.text?(r(),d("div",R({key:0,class:"item",role:P.value},st(e.item.items?{click:N,keydown:N}:{},!0),{tabindex:e.item.items&&0}),[F[1]||(F[1]=i("div",{class:"indicator"},null,-1)),e.item.link?(r(),g(j,{key:0,tag:S.value,class:"link",href:e.item.link,rel:e.item.rel,target:e.item.target},{default:m(()=>[(r(),g(D(_.value),{class:"text",innerHTML:e.item.text},null,8,["innerHTML"]))]),_:1},8,["tag","href","rel","target"])):(r(),g(D(_.value),{key:1,class:"text",innerHTML:e.item.text},null,8,["innerHTML"])),e.item.collapsed!=null&&e.item.items&&e.item.items.length?(r(),d("div",{key:2,class:"caret",role:"button","aria-label":"toggle section",onClick:A,onKeydown:it(A,["enter"]),tabindex:"0"},[...F[0]||(F[0]=[i("span",{class:"vpi-chevron-right caret-icon"},null,-1)])],32)):h("",!0)],16,Cs)):h("",!0),e.item.items&&e.item.items.length?(r(),d("div",Es,[e.depth<5?(r(!0),d(M,{key:0},E(e.item.items,J=>(r(),g(G,{key:J.text,item:J,depth:e.depth+1},null,8,["item","depth"]))),128)):h("",!0)])):h("",!0)]),_:1},8,["class"])}}}),Hs=k(Bs,[["__scopeId","data-v-b3fd67f8"]]),Os=p({__name:"VPSidebarGroup",props:{items:{}},setup(e){const t=V(!0);let n=null;return z(()=>{n=setTimeout(()=>{n=null,t.value=!1},300)}),rt(()=>{n!=null&&(clearTimeout(n),n=null)}),(a,o)=>(r(!0),d(M,null,E(e.items,c=>(r(),d("div",{key:c.text,class:T(["group",{"no-transition":t.value}])},[b(Hs,{item:c,depth:0},null,8,["item"])],2))),128))}}),Fs=k(Os,[["__scopeId","data-v-c40bc020"]]),Ds={class:"nav",id:"VPSidebarNav","aria-labelledby":"sidebar-aria-label",tabindex:"-1"},js=p({__name:"VPSidebar",props:{open:{type:Boolean}},setup(e){const{sidebarGroups:t,hasSidebar:n}=q(),a=e,o=V(null),c=je(X?document.body:null);U([a,o],()=>{var f;a.open?(c.value=!0,(f=o.value)==null||f.focus()):c.value=!1},{immediate:!0,flush:"post"});const s=V(0);return U(t,()=>{s.value+=1},{deep:!0}),(f,v)=>l(n)?(r(),d("aside",{key:0,class:T(["VPSidebar",{open:e.open}]),ref_key:"navEl",ref:o,onClick:v[0]||(v[0]=qe(()=>{},["stop"]))},[v[2]||(v[2]=i("div",{class:"curtain"},null,-1)),i("nav",Ds,[v[1]||(v[1]=i("span",{class:"visually-hidden",id:"sidebar-aria-label"}," Sidebar Navigation ",-1)),u(f.$slots,"sidebar-nav-before",{},void 0,!0),(r(),g(Fs,{items:l(t),key:s.value},null,8,["items"])),u(f.$slots,"sidebar-nav-after",{},void 0,!0)])],2)):h("",!0)}}),Us=k(js,[["__scopeId","data-v-319d5ca6"]]),qs=p({__name:"VPSkipLink",setup(e){const{theme:t}=L(),n=re(),a=V();U(()=>n.path,()=>a.value.focus());function o({target:c}){const s=document.getElementById(decodeURIComponent(c.hash).slice(1));if(s){const f=()=>{s.removeAttribute("tabindex"),s.removeEventListener("blur",f)};s.setAttribute("tabindex","-1"),s.addEventListener("blur",f),s.focus(),window.scrollTo(0,0)}}return(c,s)=>(r(),d(M,null,[i("span",{ref_key:"backToTop",ref:a,tabindex:"-1"},null,512),i("a",{href:"#VPContent",class:"VPSkipLink visually-hidden",onClick:o},x(l(t).skipToContentLabel||"Skip to content"),1)],64))}}),Gs=k(qs,[["__scopeId","data-v-0b0ada53"]]),Rs=p({__name:"Layout",setup(e){const{isOpen:t,open:n,close:a}=q(),o=re();U(()=>o.path,a),Tt(t,a);const{frontmatter:c}=L(),s=lt(),f=$(()=>!!s["home-hero-image"]);return Ue("hero-image-slot-exists",f),(v,y)=>{const S=W("Content");return l(c).layout!==!1?(r(),d("div",{key:0,class:T(["Layout",l(c).pageClass])},[u(v.$slots,"layout-top",{},void 0,!0),b(Gs),b(ht,{class:"backdrop",show:l(t),onClick:l(a)},null,8,["show","onClick"]),b(Is,null,{"nav-bar-title-before":m(()=>[u(v.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":m(()=>[u(v.$slots,"nav-bar-title-after",{},void 0,!0)]),"nav-bar-content-before":m(()=>[u(v.$slots,"nav-bar-content-before",{},void 0,!0)]),"nav-bar-content-after":m(()=>[u(v.$slots,"nav-bar-content-after",{},void 0,!0)]),"nav-screen-content-before":m(()=>[u(v.$slots,"nav-screen-content-before",{},void 0,!0)]),"nav-screen-content-after":m(()=>[u(v.$slots,"nav-screen-content-after",{},void 0,!0)]),_:3}),b(Sa,{open:l(t),onOpenMenu:l(n)},null,8,["open","onOpenMenu"]),b(Us,{open:l(t)},{"sidebar-nav-before":m(()=>[u(v.$slots,"sidebar-nav-before",{},void 0,!0)]),"sidebar-nav-after":m(()=>[u(v.$slots,"sidebar-nav-after",{},void 0,!0)]),_:3},8,["open"]),b(ca,null,{"page-top":m(()=>[u(v.$slots,"page-top",{},void 0,!0)]),"page-bottom":m(()=>[u(v.$slots,"page-bottom",{},void 0,!0)]),"not-found":m(()=>[u(v.$slots,"not-found",{},void 0,!0)]),"home-hero-before":m(()=>[u(v.$slots,"home-hero-before",{},void 0,!0)]),"home-hero-info-before":m(()=>[u(v.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":m(()=>[u(v.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":m(()=>[u(v.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":m(()=>[u(v.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":m(()=>[u(v.$slots,"home-hero-image",{},void 0,!0)]),"home-hero-after":m(()=>[u(v.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":m(()=>[u(v.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":m(()=>[u(v.$slots,"home-features-after",{},void 0,!0)]),"doc-footer-before":m(()=>[u(v.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":m(()=>[u(v.$slots,"doc-before",{},void 0,!0)]),"doc-after":m(()=>[u(v.$slots,"doc-after",{},void 0,!0)]),"doc-top":m(()=>[u(v.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":m(()=>[u(v.$slots,"doc-bottom",{},void 0,!0)]),"aside-top":m(()=>[u(v.$slots,"aside-top",{},void 0,!0)]),"aside-bottom":m(()=>[u(v.$slots,"aside-bottom",{},void 0,!0)]),"aside-outline-before":m(()=>[u(v.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":m(()=>[u(v.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":m(()=>[u(v.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":m(()=>[u(v.$slots,"aside-ads-after",{},void 0,!0)]),_:3}),b(ma),u(v.$slots,"layout-bottom",{},void 0,!0)],2)):(r(),g(S,{key:1}))}}}),zs=k(Rs,[["__scopeId","data-v-5d98c3a5"]]),Ks={Layout:zs,enhanceApp:({app:e})=>{e.component("Badge",vt)}},Ws={id:"main-content",class:"tuning-landing"},Js={class:"hero","aria-labelledby":"page-title"},Qs={class:"container hero-grid"},Ys={class:"hero-copy"},Xs={class:"hero-actions"},Zs=["href"],ei={class:"known-term-row"},ti={class:"signal-board","aria-label":"Example symptom paths"},ni={class:"signal-list"},ai=["href"],oi=["href"],si=["href"],ii={class:"section",id:"symptoms","aria-labelledby":"symptoms-title"},ri={class:"container"},li={class:"symptom-grid"},ci={class:"symptom"},ui=["href"],di={class:"symptom"},vi=["href"],fi={class:"symptom"},mi=["href"],hi={class:"symptom"},pi=["href"],bi={class:"symptom"},gi=["href"],ki=p({__name:"TuningLanding",setup(e){const t=ct(),n=V(""),a={memory:"memory-model","memory-model":"memory-model",spill:"memory-model","spark.memory.fraction":"memory-model",shuffle:"shuffle","spark.sql.shuffle.partitions":"shuffle",joins:"joins",join:"joins","spark.sql.autobroadcastjointhreshold":"joins",aqe:"aqe","spark.sql.adaptive.enabled":"aqe",config:"config"};function o(){const c=n.value.trim().toLowerCase(),s=a[c]||"config";t.go(O(`/tuning-reference/${s}`))}return(c,s)=>(r(),d("main",Ws,[i("section",Js,[i("div",Qs,[i("div",Ys,[s[6]||(s[6]=i("p",{class:"eyebrow"},"Practical mechanics, stable references",-1)),s[7]||(s[7]=i("h1",{id:"page-title"},"Spark tuning reference",-1)),s[8]||(s[8]=i("p",{class:"hero-summary"}," Move from a job symptom to the Spark mechanics and settings that can change its outcome without treating a tuning guess as evidence. ",-1)),i("div",Xs,[i("a",{class:"button button-primary",href:l(O)("/tuning-reference/intro")},[...s[1]||(s[1]=[B("Browse the full reference ",-1),i("span",{class:"arrow","aria-hidden":"true"},"→",-1)])],8,Zs),s[5]||(s[5]=i("a",{class:"button button-secondary",href:"#symptoms"},"Choose a symptom",-1)),i("form",{class:"known-term",onSubmit:qe(o,["prevent"])},[s[3]||(s[3]=i("label",{for:"known-term-input"},"Know the term or config key?",-1)),i("div",ei,[ut(i("input",{id:"known-term-input","onUpdate:modelValue":s[0]||(s[0]=f=>n.value=f),name:"term",type:"search",list:"known-term-options",placeholder:"e.g. spark.sql.shuffle.partitions",autocomplete:"off"},null,512),[[dt,n.value]]),s[2]||(s[2]=i("button",{class:"button button-secondary",type:"submit"},"Jump to topic",-1))]),s[4]||(s[4]=xe('<small data-v-5d65fdb9>Known routes: memory, shuffle, joins, AQE, and config. Other terms open the configuration reference.</small><datalist id="known-term-options" data-v-5d65fdb9><option value="memory" data-v-5d65fdb9></option><option value="shuffle" data-v-5d65fdb9></option><option value="joins" data-v-5d65fdb9></option><option value="AQE" data-v-5d65fdb9></option><option value="config" data-v-5d65fdb9></option><option value="spark.memory.fraction" data-v-5d65fdb9></option><option value="spark.sql.shuffle.partitions" data-v-5d65fdb9></option><option value="spark.sql.adaptive.enabled" data-v-5d65fdb9></option><option value="spark.sql.autoBroadcastJoinThreshold" data-v-5d65fdb9></option></datalist>',2))],32)])]),i("aside",ti,[s[12]||(s[12]=i("div",{class:"board-label"},"evidence → mechanic → lever",-1)),i("ul",ni,[i("li",null,[i("a",{class:"signal-link",href:l(O)("/tuning-reference/memory-model")},[...s[9]||(s[9]=[i("span",{class:"signal-marker","aria-hidden":"true"},null,-1),i("span",{class:"signal-title"},"Executor memory pressure",-1),i("span",{class:"signal-destination"},"#memory-model",-1)])],8,ai)]),i("li",null,[i("a",{class:"signal-link",href:l(O)("/tuning-reference/shuffle")},[...s[10]||(s[10]=[i("span",{class:"signal-marker","aria-hidden":"true"},null,-1),i("span",{class:"signal-title"},"Slow, wide stages",-1),i("span",{class:"signal-destination"},"#shuffle",-1)])],8,oi)]),i("li",null,[i("a",{class:"signal-link",href:l(O)("/tuning-reference/joins")},[...s[11]||(s[11]=[i("span",{class:"signal-marker","aria-hidden":"true"},null,-1),i("span",{class:"signal-title"},"Join strategy drift",-1),i("span",{class:"signal-destination"},"#joins",-1)])],8,si)])])])])]),i("section",ii,[i("div",ri,[s[23]||(s[23]=i("div",{class:"section-heading"},[i("h2",{id:"symptoms-title"},"Symptoms, mapped to the right lever"),i("p",null,"Each path stays on the canonical reference document, so existing links and saved anchors continue to work."),i("p",{class:"decision-note"},[i("strong",null,"How to use this:"),B(" SparkForensics reads your Spark event log and surfaces evidence; this reference explains the mechanics and settings behind it. Diagnose the symptom, change one informed lever, then validate against the next run's evidence. Confirm behavior and defaults against your deployed Spark version and distribution. ")])],-1)),i("div",li,[i("article",ci,[s[14]||(s[14]=i("div",null,[i("h3",null,"Spill or GC pressure"),i("p",null,"Trace executor memory, object lifetime, and the trade-offs behind changing memory settings.")],-1)),i("a",{href:l(O)("/tuning-reference/memory-model")},[...s[13]||(s[13]=[B("Open memory model ",-1),i("span",{"aria-hidden":"true"},"→",-1)])],8,ui)]),i("article",di,[s[16]||(s[16]=i("div",null,[i("h3",null,"Shuffle-heavy stages"),i("p",null,"Understand write/read costs, partition size, and why moving data becomes the bottleneck.")],-1)),i("a",{href:l(O)("/tuning-reference/shuffle")},[...s[15]||(s[15]=[B("Open shuffle guide ",-1),i("span",{"aria-hidden":"true"},"→",-1)])],8,vi)]),i("article",fi,[s[18]||(s[18]=i("div",null,[i("h3",null,"Slow or skewed joins"),i("p",null,"Compare join mechanics before changing broadcast thresholds or reshaping a plan.")],-1)),i("a",{href:l(O)("/tuning-reference/joins")},[...s[17]||(s[17]=[B("Open join optimization ",-1),i("span",{"aria-hidden":"true"},"→",-1)])],8,mi)]),i("article",hi,[s[20]||(s[20]=i("div",null,[i("h3",null,"Plan adapts poorly"),i("p",null,"Use AQE's runtime choices as an inspectable mechanism, not a checkbox to enable blindly.")],-1)),i("a",{href:l(O)("/tuning-reference/aqe")},[...s[19]||(s[19]=[B("Open AQE guide ",-1),i("span",{"aria-hidden":"true"},"→",-1)])],8,pi)]),i("article",bi,[s[22]||(s[22]=i("div",null,[i("h3",null,"Need the exact setting"),i("p",null,"Check a setting's scope, default, and interaction before applying it to a cluster.")],-1)),i("a",{href:l(O)("/tuning-reference/config")},[...s[21]||(s[21]=[B("Open config reference ",-1),i("span",{"aria-hidden":"true"},"→",-1)])],8,gi)])])])]),s[24]||(s[24]=xe('<section class="section workflow" aria-labelledby="workflow-title" data-v-5d65fdb9><div class="container workflow-grid" data-v-5d65fdb9><div class="workflow-copy" data-v-5d65fdb9><h2 id="workflow-title" data-v-5d65fdb9>Let SparkForensics surface the evidence. Use this reference to reason about it.</h2><p data-v-5d65fdb9>The two tools stay deliberately separate: SparkForensics reads the event log; this static reference explains the mechanics and settings behind what you find.</p></div><ol class="steps" data-v-5d65fdb9><li data-v-5d65fdb9><span class="step-label" data-v-5d65fdb9>Observe</span><div data-v-5d65fdb9><strong data-v-5d65fdb9>Read the stage or executor behavior</strong><span data-v-5d65fdb9>Start with the event log, metrics, and plan details Spark already produces.</span></div></li><li data-v-5d65fdb9><span class="step-label" data-v-5d65fdb9>Explain</span><div data-v-5d65fdb9><strong data-v-5d65fdb9>Name the mechanism at work</strong><span data-v-5d65fdb9>Use the stable reference anchors to connect symptoms to memory, shuffle, joins, AQE, or configuration.</span></div></li><li data-v-5d65fdb9><span class="step-label" data-v-5d65fdb9>Test</span><div data-v-5d65fdb9><strong data-v-5d65fdb9>Change one informed lever</strong><span data-v-5d65fdb9>Make a measured change, then compare the evidence again rather than carrying a tuning superstition forward.</span></div></li></ol></div></section>',1))]))}}),_i=k(ki,[["__scopeId","data-v-5d65fdb9"]]),Ne="citation-chip",Ae="citation-popover",yi=150;let I=null,C=null,Q=!1,te=null,Ie=!1;function $i(){const e=new Map;return document.querySelectorAll("section.footnotes li.footnote-item[id]").forEach(t=>{const n=t.cloneNode(!0);n.querySelectorAll("a.footnote-backref").forEach(o=>o.remove());const a=n.querySelector("a[href]");e.set(t.id,{href:a?a.getAttribute("href"):null,title:(n.textContent??"").trim()})}),e}function oe(){te!==null&&(clearTimeout(te),te=null)}function ke(){oe(),te=setTimeout(()=>{Q||Y()},yi)}function Y(){oe(),I==null||I.remove(),I=null,C==null||C.removeAttribute("aria-describedby"),C==null||C.setAttribute("aria-expanded","false"),C=null,Q=!1}function Pi(e,t){const n=t.getBoundingClientRect(),a=6,{width:o,height:c}=e.getBoundingClientRect();let s=n.bottom+a;s+c>window.innerHeight-8&&(s=n.top-c-a);const f=window.innerWidth-o-8;e.style.top=`${Math.max(8,s)}px`,e.style.left=`${Math.min(Math.max(8,n.left),Math.max(8,f))}px`}function fe(e,t,n){oe();const a=C===e;if(a||C==null||C.setAttribute("aria-expanded","false"),I||(I=document.createElement("div"),I.id=Ae,I.className="citation-popover",I.setAttribute("role","tooltip"),I.addEventListener("mouseenter",oe),I.addEventListener("mouseleave",ke),document.body.appendChild(I)),I.replaceChildren(),t.href){const o=document.createElement("a");o.href=t.href,o.target="_blank",o.rel="noreferrer",o.textContent=t.title,I.appendChild(o)}else I.textContent=t.title;e.setAttribute("aria-describedby",Ae),e.setAttribute("aria-expanded","true"),C=e,n?Q=!0:a||(Q=!1),Pi(I,e)}function Li(e,t){if(e.classList.contains(Ne))return;const n=(e.getAttribute("href")??"").replace(/^#/,""),a=t.get(n);if(!a)return;e.removeAttribute("href"),e.setAttribute("role","button"),e.tabIndex=0,e.classList.add(Ne),e.setAttribute("aria-haspopup","true"),e.setAttribute("aria-expanded","false"),e.textContent=n.replace(/^fn/,"");const o=()=>{C===e&&Q?Y():fe(e,a,!0)};e.addEventListener("mouseenter",()=>fe(e,a,!1)),e.addEventListener("mouseleave",ke),e.addEventListener("focus",()=>fe(e,a,!1)),e.addEventListener("blur",ke),e.addEventListener("click",o),e.addEventListener("keydown",c=>{(c.key==="Enter"||c.key===" ")&&(c.preventDefault(),o())})}function Si(){Ie||(Ie=!0,document.addEventListener("click",e=>{if(!Q||!C)return;const t=e.target;C.contains(t)||I!=null&&I.contains(t)||Y()}),document.addEventListener("keydown",e=>{e.key==="Escape"&&Y()}))}function Ce(){Y(),Si();const e=$i();document.querySelectorAll("sup.footnote-ref > a[href]").forEach(t=>{Li(t,e)})}const Qe="shuffle-works-theme";function Vi(){try{const e=window.localStorage.getItem(Qe);return e==="light"||e==="dark"?e:null}catch{return null}}function Ee(e){const t=e?"dark":"light";try{window.localStorage.setItem(Qe,t)}catch{}document.documentElement.dataset.theme=t}const Ti={extends:Ks,enhanceApp({app:e,router:t}){if(e.component("TuningLanding",_i),!X)return;t.onAfterRouteChange=()=>{ne(()=>Ce())};const n=e.mount.bind(e);e.mount=(...a)=>{const o=n(...a);return ne(()=>Ce()),o},e.runWithContext(()=>{const{isDark:a}=Be(),o=Vi();o&&(a.value=o==="dark"),Ee(a.value),U(a,v=>Ee(v)),new MutationObserver(()=>{const v=document.documentElement.dataset.theme;if(v==="light"||v==="dark"){const y=v==="dark";a.value!==y&&(a.value=y)}}).observe(document.documentElement,{attributes:!0,attributeFilter:["data-theme"]});const s=()=>{document.querySelectorAll(".VPNavBarAppearance, .VPNavScreenAppearance, .VPNavBarExtra .appearance-action").forEach(v=>{v.hasAttribute("data-shuffle-page-controls")||v.setAttribute("data-shuffle-page-controls","")})};s(),new MutationObserver(s).observe(document.documentElement,{childList:!0,subtree:!0})})}};export{xo as c,Ti as t,L as u};

package/export-template/docs/assets/contributor-guide_architecture_board-widgets.md.CWpj01WU.js

@@ -0,0 +1 @@
+import{_ as o,o as t,c as d,a5 as c}from"./chunks/framework.DSg0KOwT.js";const u=JSON.parse('{"title":"Board widgets","description":"","frontmatter":{},"headers":[],"relativePath":"contributor-guide/architecture/board-widgets.md","filePath":"contributor-guide/architecture/board-widgets.md"}'),a={name:"contributor-guide/architecture/board-widgets.md"};function i(n,e,r,s,l,h){return t(),d("div",null,[...e[0]||(e[0]=[c('<h1 id="board-widgets" tabindex="-1">Board widgets <a class="header-anchor" href="#board-widgets" aria-label="Permalink to &quot;Board widgets&quot;">​</a></h1><h2 id="board-widgets-beyond-the-fixed-six" tabindex="-1">Beyond the fixed six <a class="header-anchor" href="#board-widgets-beyond-the-fixed-six" aria-label="Permalink to &quot;Beyond the fixed six {#board-widgets-beyond-the-fixed-six}&quot;">​</a></h2><p>(Components below live in <code>src/view/widgets/</code>, one file per widget name, e.g. <code>JobFailures.tsx</code>, <code>MemoryUtilization.tsx</code>.)</p><p>Six extra cards render in the Findings tab&#39;s active grid alongside the fixed spec §5 six: Incomplete Run, Job Failures, Caching Opportunities, Config Audit, Plan Advisor, and Autoscaling Churn, all <code>region: &#39;action&#39;</code> in <code>detector-registry.tsx</code>:</p><ul><li><p><strong>Incomplete Run</strong> (tag <code>INCMP</code>, <code>IncompleteRun.tsx</code>): app-level &quot;the capture never finished&quot; caveat (DETECTORS entry <code>incompleteRun</code>). Fires whenever <code>app.startTime</code> was observed but <code>app.endTime</code> was not, i.e. no <code>SparkListenerApplicationEnd</code> in the log: an in-flight job, a rotated-away log, or a capture cut short. Order 5, ahead of every other detector, so its card is first among the Findings tab&#39;s <code>action</code>-region active widgets when present. The Findings tab&#39;s recommendation rollup (rendered by <code>FixTheseFirst.tsx</code>) excludes <code>incompleteRun</code> from that list outright (see <a href="./widget-rendering.html#widget-rendering-order-fixed-spec-§5">Widget rendering order</a>): it&#39;s a pipeline-completeness caveat, not an addressable fix, so it never competes with other findings for a ranked slot there. Self-gates to <code>null</code> (no card in the DOM) once the run completed normally. Unrelated to <code>evidence-availability.ts</code>&#39;s own <code>trustworthy</code> gate (see <a href="./worker-protocol.html#evidence-availability-contract-v1">Evidence-availability contract</a>): that ledger only downgrades <em>absence</em> conclusions for individual evidence categories, never becomes a <code>DETECTORS</code> finding itself, and this card does not read it. No <code>docAnchor</code> is set, the same deviation as Autoscaling Churn below: this is a tool-specific signal with no upstream <code>spark-tuning-reference</code> section.</p></li><li><p><strong>Job Failures</strong> (tag <code>JOBS</code>): app-level job-failure-rate rollup (DETECTORS entry <code>jobFailureRate</code> in <code>packages/core/src/detectors.ts</code>), computed from <code>app.jobs</code> (<code>SparkListenerJobEnd</code> results): ≥10% info, ≥30% warning, ≥50% critical. Complements the per-stage, task-level Failed Tasks card (tag <code>FAIL</code>).</p></li><li><p><strong>Caching Opportunities</strong> (tag <code>CACHE</code>, <code>CachingOpportunity.tsx</code>): app-level SQL relation-reuse detector (DETECTORS entry <code>cachingOpportunity</code>), computed from <code>ctx.sql</code>. It walks each execution&#39;s <code>planTree</code> and keys every scan by its stable pre-AQE identity via <code>scanRelationId</code> (<code>plan-summary.ts</code>): <code>parquet:&lt;db.table&gt;</code>, <code>delta:&lt;db.table&gt;</code>, <code>jdbc:&lt;schema.table&gt;</code>. That dedupes relations within one execution (self-joins count once) and flags any relation scanned by <code>&gt;= minExecutions</code> (2) distinct executions. Relation identity comes from the catalog-qualified scan name (nodeName, e.g. <code>Scan parquet spark_catalog.db.t</code>), not the <code>Location:</code> path, since Spark truncates that path at ~100 chars and points it at <code>_delta_log</code> for Delta tables; internal Delta-log metadata scans are dropped. Read bytes come from the scan&#39;s <code>size of files read</code> metric (<code>0</code>/unknown for JDBC). Findings carry <code>executionReuse</code> (<code>value</code> = distinct-execution count), <code>relation</code>, <code>format</code>, <code>executionIds</code>, <code>totalReadBytes</code>, and a size-aware <code>recommendation</code> (<code>confidence</code> scaled <code>low</code>/<code>medium</code>/<code>high</code> via <code>cachingReuseConfidence</code> off reuse-execution count, plus <code>validationRequired</code>). Renders nothing when clean (no card in the DOM). One row per relation: name + format badge, reuse count, <code>Data read</code> (<code>formatBytes</code>, em-dash when unknown), recommendation, sorted by <code>totalReadBytes</code> then reuse count descending. Rows reveal 6 initially, then up to 30 more per click. Pure-RDD-API apps (no SQL executions) produce no finding: a deliberate trade-off replacing the former RDD-lineage heuristic, which surfaced only internal query-engine RDDs on DataFrame/SQL workloads.</p><p>It also detects composite reuse. When the same join/union subtree (not just a leaf scan) recurs across <code>&gt;= minExecutions</code> distinct SQL executions, the detector emits one <code>variant:&#39;composite&#39;</code> finding recommending caching the derived join/union result instead of two independent leaf-relation rows, and suppresses the leaf findings for relations fully covered by it. A relation reused beyond the composite&#39;s executions keeps a residual leaf finding for just the uncovered executions. Composite identity is structural: an anchor plan-shape fingerprint (<code>findCompositeCandidates</code>/<code>computePlanShapes</code>&#39;s <code>opts.includeDetail</code> path, <code>detectors.ts</code>) folds the join/union node&#39;s own normalized <code>detail</code> (join type, columns, literals, with expr ids, <code>plan_id=</code>, codegen-stage numbers, and AQE&#39;s BuildLeft/BuildRight stripped, and commutative equality operands canonicalized) plus its children&#39;s detail-free shapes. Descendant nodes never contribute detail text, only structural shape, so a shared join reused across differently-filtered pre-join scans still matches (a deliberate trade-off) while a different join <em>condition</em> on the same tables does not collide. Nested composites (an inner join reused both standalone and inside an outer join) dedupe one level at a time: an inner composite fully covered by a qualifying outer composite&#39;s execution set is suppressed entirely, and a superset recomputes a residual finding over just its extra executions. Reuse via pure projection/aggregation with no join/union underneath stays leaf-level, not modeled as composite. <code>variant:&#39;composite&#39;</code> findings carry <code>operator</code> (<code>&#39;join&#39;</code>|<code>&#39;union&#39;</code>), <code>relations</code> (leaf relations under the composite, for display), and <code>format:&#39;derived&#39;</code> (a sentinel: composites have no scan storage format). They render a <code>JOIN</code>/<code>UNION</code> operator badge (styled distinct from the format badges) plus a confidence marker (<code>confidence</code> scaled via <code>cachingReuseConfidence</code>, <code>validationRequired</code>) in <code>CachingOpportunity.tsx</code>.</p></li><li><p><strong>Autoscaling Churn</strong> (tag <code>CHRN</code>, <code>AutoscalingChurn.tsx</code>): app-level short-lived-executor detector (DETECTORS entry <code>autoscalingChurn</code> in <code>packages/core/src/detectors.ts</code>; reuses the same <code>executorsAdded</code>/<code>executorsRemoved</code> matching logic as <code>utilization</code>). For each added executor, finds its matching removal event (falling back to <code>app.endTime</code> for an executor still alive when the log ends) and flags it short-lived if its lifetime is under 2 minutes (<code>thresholds.shortLivedMs</code>). Warns above 30% short-lived, escalates to critical above 60% (<code>confidence</code> scales <code>low</code>/<code>medium</code>/<code>high</code> via <code>autoscalingChurnConfidence</code>, off how far the short-lived share sits past <code>warningPct</code>/<code>criticalPct</code>: these thresholds are still an unvalidated design-spike estimate, not yet checked against real autoscaling-heavy logs). Returns no finding below 5 total executors (noise floor) or when <code>app.endTime</code> is missing (truncated/still-running log). The widget itself is unchanged apart from a finding-driven verdict banner (impact dot + <code>CHRN</code> tag + recommendation) above its existing add/remove chart. The chart&#39;s muted scale-down bar coloring is untouched. No <code>docAnchor</code> is set yet: the upstream <code>shuffle-works/spark-tuning-reference</code> docs repo has no <code>bottleneck-autoscaling-churn</code> section (verified 2026-08-19), so the <code>CHRN</code> tag currently renders with no docs-panel link (a tracked follow-up).</p></li><li><p><strong>Config Audit</strong> (tag <code>CFG</code>): static Spark-config sanity findings derived from <code>app.config</code>/<code>app.resources</code> (parsed from <code>SparkListenerEnvironmentUpdate</code>): dynamic-allocation vs. shuffle-service mismatch, inverted/missing autoscaling bounds, non-Kryo serializer, low executor <code>memoryOverhead</code>. Computed outside the runtime bottleneck catalog: its findings live in the separate <code>configFindings</code> stream, not <code>catalog</code>. But <code>FixTheseFirst</code>/<code>Alerts</code> both merge <code>catalog</code> and <code>configFindings</code> (neither reads <code>region</code> any more), so a Config Audit finding is still eligible for a row in the Findings tab&#39;s recommendation rollup and still gets its own card in the active grid, alongside genuine bottleneck-catalog findings.</p></li><li><p><strong>Plan Advisor</strong> (tag <code>PLAN</code>): SQL-plan-level findings computed from <code>appModel.sql</code>&#39;s resolved <code>planTree</code> (DETECTORS entries <code>duplicatePlanSubtree</code>, <code>smallFiles</code>, <code>broadcastSizing</code> in <code>packages/core/src/detectors.ts</code>): repeated plan subtrees (≥3 nodes, ≥2 occurrences, critical if the repeated root is an <code>Exchange</code>), small-files read/write (&gt;100 files averaging ❤️ MiB), and broadcast-join sizing in both directions (missed- broadcast info finding, over-broadcast warning at &gt;1 GB). Each of the four emitted types now renders as its own card (<code>DuplicatePlanSubtree.tsx</code>, <code>SmallFiles.tsx</code>, <code>UnderBroadcast.tsx</code>, <code>OverBroadcast.tsx</code>; the 2026-09 widget/finding-type 1:1 mapping redesign split what used to be one shared <code>PlanFindings.tsx</code> card): all four still share the <code>PLAN</code> tag and the same <code>--plan-aggregate</code> badge tint (<code>src/view/plan-finding-shared.ts</code>). Their <code>docAnchor</code>s (<code>#bottleneck-duplicate-plan-subtree</code>, <code>#bottleneck-small-files</code>, <code>#bottleneck-broadcast-sizing</code>) are not yet live in the vendored docs site, so <code>npm run update-docs</code> will abort until upstream <code>spark-tuning-reference</code> adds them.</p></li></ul><p><code>detector-registry.tsx</code>&#39;s <code>REGISTRY</code> still carries <code>region: &#39;reference&#39;</code> on four entries, each its own component now: <code>memoryUtilization</code> (<code>MemoryUtilization</code>), <code>utilization</code> (<code>ExecutorUtilization</code>), <code>cacheUtilization</code> (<code>CacheUtilization</code>), and <code>coreLocality</code> (<code>CoreUsageArea</code>). <code>broadcastSizing</code> is gone from <code>REGISTRY</code> entirely (the 2026-09 widget/finding-type 1:1 mapping redesign dropped it): it never backed a real <code>Finding</code> (the <code>broadcastSizing</code> <code>DETECTORS</code> entry only ever emits <code>underBroadcast</code>/<code>overBroadcast</code>, both <code>region: &#39;action&#39;</code>, each now its own Plan Advisor card), so there is no key left for it to occupy or a clean-check line for it to render. Autoscaling Churn, the other executor-provisioning-lifecycle detector alongside <code>utilization</code>/<code>memoryUtilization</code>, was deliberately given <code>action</code> rather than <code>reference</code> (see &quot;Beyond the fixed six&quot; above).</p><p><code>region</code> decides one thing (see <a href="./widget-rendering.html#widget-rendering-order-fixed-spec-§5">Widget rendering order</a>): whether a widget always mounts. <code>isAlwaysMountedType()</code> flags exactly one of the four <code>reference</code>-region types: Core Usage by Locality. That one mounts unconditionally from <code>appModel</code> in its own small grid inside the Findings tab, regardless of finding state. Memory Utilization, Executor Utilization, and Cache Storage are <code>reference</code> too, but all three are excluded by product decision, not a component-sharing constraint (<code>ALWAYS_MOUNTED_EXCEPTIONS</code> in <code>src/view/detector-registry.tsx</code> carries <code>cacheUtilization</code>, <code>memoryUtilization</code>, and <code>utilization</code>): a clean run on any of them isn&#39;t evidence worth surfacing unconditionally, so each collapses to an ordinary <code>CleanCheckRow</code> like any other action-region type on a clean run. Every other <code>REGISTRY</code> widget still renders unconditionally as either an active card or a clean-check line, and <code>region</code> still sets <code>orderedWidgets()</code>&#39;s sort order within the active grid (<code>action</code> components first, <code>reference</code> ones after). The Full app report tab is structural-only and reads no <code>REGISTRY</code> entry. So Core Usage by Locality, the one widget still tagged <code>region: &#39;reference&#39;</code> and exempt from <code>ALWAYS_MOUNTED_EXCEPTIONS</code>, renders in the Findings tab&#39;s always-visible grid rather than inside a separate Reference region (Memory Utilization, Executor Utilization, and Cache Storage all render through the ordinary active/clean paths instead):</p><ul><li><strong>Memory Utilization</strong> (tag <code>MEM</code>): app-level card combining three sub-findings from the <code>memoryUtilization</code> DETECTORS entry (<code>packages/core/src/detectors.ts</code>): idle-cores rate (busy-core-time from the worker&#39;s run-aggregates sweep vs. peak-cores × wall-clock), per-executor memory bands (peak heap vs. allocated, gated on <code>spark.eventLog.logStageExecutorMetrics</code>: a distinct <code>dataUnavailable</code> finding renders when that config was off), and an unverified memory-waste model (<code>confidence</code> scales <code>low</code>/<code>medium</code>/<code>high</code> via <code>memoryWasteConfidence</code>, off how far the wasted/used ratio sits past the 1.5× buffer). The driver-memory half of the original spec is dropped: the worker only extracts <em>allocated</em> <code>spark.driver.memory</code>, never a driver actual-usage metric, so there is nothing to band against. The separate <code>utilization</code> DETECTORS entry (an <code>avgUtilization</code> info finding: active-executor-time fraction below 60%) has its own card, <strong>Executor Utilization</strong> (tag <code>UTIL</code>, <code>ExecutorUtilization.tsx</code>): a <code>reference</code>-region widget in its own right that renders only with an active finding, split out of this same combined widget in the 2026-09 widget/finding-type 1:1 mapping redesign (it used to render inline here; the former <code>ExecutorTimeline.tsx</code> never owned this type, despite the tag&#39;s letters).</li><li><strong>Cache Storage</strong> (tag <code>CSTOR</code>): app-level card driven by the <code>cacheUtilization</code> DETECTORS entry (<code>packages/core/src/detectors.ts</code>), evaluating two per-RDD proxies over <code>ctx.app.rddInfo</code> storage snapshots since Spark event logs carry no runtime block-access/read-count data: partial caching (<code>numCachedPartitions / numPartitions &lt; 0.90</code>, <code>&lt; 0.50</code> for the warning tier) and disk spillover for <code>MEMORY_AND_DISK*</code> RDDs (<code>diskSize / (memorySize + diskSize) &gt; 0.15</code>, <code>&gt; 0.40</code> for the warning tier; <code>DISK_ONLY</code> RDDs are never flagged). <code>confidence</code> scales <code>low</code>/<code>medium</code>/<code>high</code> via <code>cacheSampleConfidence(rdd.numPartitions)</code>, because the ratio is a point-in-time storage snapshot from stage-submission events, not a runtime read-count, and more partitions average that snapshot noise into a more stable ratio. The existing RDD table (ported from the legacy <code>src/widgets/cache-utilization.js</code> canvas widget) still renders unconditionally; flagged rows get an inline <code>CSTOR</code> tag next to the RDD name, and every flagged RDD&#39;s recommendation renders below the table, worst-first.</li><li><strong>Core Usage by Locality</strong> (tag <code>LOCAL</code>, <code>CoreUsageArea.tsx</code>): app-level non-local-task-ratio threshold (DETECTORS entry <code>coreLocality</code>; the other half of a wasted-cores-ratio check, the idle-core half already covered by Memory Utilization&#39;s <code>idleCores</code> variant above). Sums <code>RACK_LOCAL</code> + <code>ANY</code> task counts against total task count across every stage&#39;s <code>stage.localityStats</code> (pure reducer <code>computeCoreLocalityRatio</code>, <code>packages/core/src/core-locality-ratio.ts</code>). <code>NO_PREF</code> stays in the denominator only, since it&#39;s what shuffle-read stages legitimately report with no locality problem. Below 50 total tasks or below a 15% non-local ratio: no finding; 15%-35%: warning; &gt;= 35%: critical, still unvalidated design-spike thresholds (<code>confidence</code> scales <code>low</code>/<code>medium</code>/<code>high</code> via <code>coreLocalityConfidence</code>, off whichever is weaker of the non-local ratio and the sampled task count, the same evidence-strength convention as the memory-waste model above). The widget&#39;s always-rendered stacked-area chart (<code>packages/core/src/core-usage-locality.ts</code>) is unaffected. The finding only adds a threshold/impact-band section above it, a per-stage non-local breakdown below it (shown whenever any non-local tasks exist at all, independent of whether the aggregate crossed threshold), and a one-line cross-reference to Memory Utilization when its <code>idleCores</code> finding also fired (idle-core ratio itself is not duplicated here).</li></ul><p>Documented ALL-CAPS tag vocabulary: <code>SKEW</code>, <code>SHFL</code>, <code>SPILL</code>, <code>GC</code>, <code>COLD</code>, <code>UTIL</code>, <code>MEM</code> (Memory Utilization), <code>CSTOR</code> (Cache Storage), <code>LOCAL</code> (Core Usage by Locality), plus <code>FAIL</code> (Failed Tasks), <code>JOBS</code> (Job Failures), <code>CFG</code> (Config Audit), <code>PLAN</code> (Plan Advisor), <code>SFAIL</code> (stage failed outright), <code>PART</code> (partition sizing), <code>SLOW</code> (stage overall slowness), <code>SHAPE</code> (stage shape smells), <code>CACHE</code> (caching opportunity) and <code>CHRN</code> (autoscaling churn).</p><p>ETL Phase Attribution (<code>packages/core/src/etl-phases.ts</code> + <code>EtlPhases.tsx</code>), What-If Executor Scaling (<code>packages/core/src/scaling-sim.ts</code> + <code>ScalingSim.tsx</code>, design spike: makespan predictions are unvalidated and carry a Model Error indicator), and Compute Efficiency (<code>packages/core/src/efficiency-model.ts</code> + <code>EfficiencyModel.tsx</code>, design spike: driver-vs-executor waste split, two theoretical floors, and the §6 right-sizing copy) are main-thread report modules, not <code>DETECTORS</code> entries: descriptive lenses with no impact-band threshold, rendered unconditionally into the Full app report tab rather than participating in the bottleneck catalog. <code>packages/core/src/job-groups.ts</code> (<code>checkConcurrentJobGroups</code>) is likewise a report helper: it flags when concurrent SQL-execution job groups make wall-clock-based estimates unreliable, and both the scaling simulator and the efficiency model gate their precision on it, showing a caveat banner rather than suppressing the estimate.</p><h2 id="confidence-metadata" tabindex="-1">Confidence metadata <a class="header-anchor" href="#confidence-metadata" aria-label="Permalink to &quot;Confidence metadata&quot;">​</a></h2><p>Best-effort (non-deterministic) findings carry a <code>confidence</code> + <code>validationRequired</code> marker, rendered inline by each consuming widget (e.g. <code>Spill.tsx</code>, <code>DuplicatePlanSubtree.tsx</code>, <code>SmallFiles.tsx</code>, <code>UnderBroadcast.tsx</code>, <code>OverBroadcast.tsx</code>, <code>EfficiencyModel.tsx</code>) when <code>confidence</code> is present and not <code>&#39;high&#39;</code>. There is no shared helper: each widget renders its own muted &quot;N confidence: verify&quot; text, with the <code>title</code> attribute carrying <code>validationRequired</code> as a tooltip. Spill classification is <code>medium</code> when classified (skew/volume) and <code>low</code> when unclassified; plan-summary warnings are <code>low</code>. Deterministic detectors stay unmarked, treated as high confidence.</p><h2 id="visual-system" tabindex="-1">Visual system <a class="header-anchor" href="#visual-system" aria-label="Permalink to &quot;Visual system&quot;">​</a></h2><p>Tailwind CSS v4 + shadcn/ui (Base UI primitives). The design tokens (colors, including the telemetry-console dark palette) are defined as CSS variables in an <code>@theme inline</code> block and consumed via Tailwind utility classes; there is no more hand-authored BEM CSS. Theme polarity is unchanged from the legacy app: dark = bare <code>:root</code> (no attribute), light = <code>:root[data-theme=&quot;light&quot;]</code>, toggled by <code>src/theme/ThemeProvider.tsx</code> and persisted to <code>localStorage</code>. <code>index.html</code>&#39;s inline FOUC-prevention script still runs before React mounts. Mono is still the typeface for numerics (<code>--font-mono</code>), applied via a <code>.num</code>-equivalent Tailwind utility per call site rather than one global class. Charts are Recharts (<code>src/view/charts/ChartTheme.tsx</code>&#39;s <code>CHART_COLORS</code>, read from the same CSS tokens) instead of Chart.js. React re-renders on theme toggle, so chart colors update live with the theme, unlike the old Chart.js canvases, which were built once per parse. <code>ChartFrame</code> can also expose the underlying rows through a toggleable accessible table and copy them to the clipboard as TSV.</p><h2 id="templating-xss-safe" tabindex="-1">Templating (XSS-safe) <a class="header-anchor" href="#templating-xss-safe" aria-label="Permalink to &quot;Templating (XSS-safe)&quot;">​</a></h2><p>JSX auto-escapes every interpolated value by default. The hand-rolled auto-escaping <code> html</code> `` tagged template (<code>src/widgets/utils.js</code>) and its <code>no-raw-innerhtml</code> guard test are gone, and no <code>.innerHTML</code> assignment is left anywhere in the view layer.</p><p>One Base UI-specific gotcha carried no equivalent in the legacy app: <code>WidgetCard.tsx</code> passes <code>aria-expanded={String(open) as &#39;true&#39; | &#39;false&#39;}</code> rather than the raw boolean, because Base UI&#39;s <code>Collapsible.Trigger</code> otherwise overrides a boolean <code>aria-expanded</code> prop with its own internal state via prop merging. The explicit <code>String()</code> cast keeps the rendered attribute in sync with this app&#39;s own <code>open</code> state.</p>',17)])])}const p=o(a,[["render",i]]);export{u as __pageData,p as default};

package/export-template/docs/assets/contributor-guide_architecture_board-widgets.md.CWpj01WU.lean.js

@@ -0,0 +1 @@
+import{_ as o,o as t,c as d,a5 as c}from"./chunks/framework.DSg0KOwT.js";const u=JSON.parse('{"title":"Board widgets","description":"","frontmatter":{},"headers":[],"relativePath":"contributor-guide/architecture/board-widgets.md","filePath":"contributor-guide/architecture/board-widgets.md"}'),a={name:"contributor-guide/architecture/board-widgets.md"};function i(n,e,r,s,l,h){return t(),d("div",null,[...e[0]||(e[0]=[c("",17)])])}const p=o(a,[["render",i]]);export{u as __pageData,p as default};

package/export-template/docs/assets/contributor-guide_architecture_detector-contract.md.CgzUsQ6W.js

@@ -0,0 +1 @@
+import{_ as t,o,c as d,a5 as a}from"./chunks/framework.DSg0KOwT.js";const p=JSON.parse('{"title":"Detector contract","description":"","frontmatter":{},"headers":[],"relativePath":"contributor-guide/architecture/detector-contract.md","filePath":"contributor-guide/architecture/detector-contract.md"}'),c={name:"contributor-guide/architecture/detector-contract.md"};function s(i,e,r,n,l,h){return o(),d("div",null,[...e[0]||(e[0]=[a('<h1 id="detector-contract" tabindex="-1">Detector contract <a class="header-anchor" href="#detector-contract" aria-label="Permalink to &quot;Detector contract&quot;">​</a></h1><p><code>packages/core/src/detectors.ts</code> is the single source of Spark-optimization logic: one declarative <code>DETECTORS</code> entry per pattern, each carrying <code>type</code>, <code>scope</code> (<code>stage</code> / <code>app</code> / <code>config</code> / <code>sql</code>), <code>order</code>, <code>fixEffort</code>, a <code>thresholds</code> object, impactBand/copy, a <code>docAnchor</code>, and a co-located <code>detect()</code> method. Both consumers are thin loops over that array:</p><ul><li><p><code>packages/core/src/analyzer.ts</code>: <code>analyze()</code> runs every entry regardless of scope, skipping only <code>inScorecard:false</code> ones; <code>auditConfig()</code> separately runs the <code>scope:&#39;config&#39;</code> entries. The four <code>configAudit</code> entries stay out of the bottleneck catalog because each sets <code>inScorecard:false</code>, not because of <code>scope:&#39;config&#39;</code>: a future config-scope detector without that flag would run through <code>analyze()</code> too. Each finding is stamped with its entry&#39;s <code>docAnchor</code>.</p></li><li><p><code>src/view/detector-registry.tsx</code>: a <code>REGISTRY: Record&lt;findingType, {component, region}&gt;</code> replaces <code>dashboard-renderer.js</code>&#39;s <code>render:</code> bindings, one entry per emitted finding type. <code>orderedWidgets()</code> walks <code>DETECTORS</code> ascending by <code>order</code>, then sorts <code>action</code>-region components before <code>reference</code>-region ones. Every <code>finding.type</code> maps to its own component now (the 2026-09 widget/finding-type 1:1 mapping redesign split six components that used to multiplex several types each: <code>TaskSkew</code> into <code>Skew</code>/<code>StageShape</code>/<code>TinyTask</code>; <code>ShuffleIO</code> narrowed to <code>shuffle</code> only, plus a new <code>PartitionSizing</code>; <code>Failures</code> into <code>StageFailed</code>/ <code>TaskFailures</code>/<code>RetryWaste</code>; <code>ExecutorTimeline</code> into <code>SlowHost</code>/ <code>StageSlowness</code>/<code>Straggler</code>/<code>SpeculationWaste</code>/<code>ColdStart</code> (its non-finding-driven executor-count chart moved to <code>ExecutorCountChart</code>, a <code>ReferenceSection</code> tile, not a <code>REGISTRY</code> entry); <code>MemoryUtilization</code> narrowed to <code>memoryUtilization</code> only, plus a new <code>ExecutorUtilization</code> for <code>utilization</code>; <code>PlanFindings</code> into <code>DuplicatePlanSubtree</code>/<code>SmallFiles</code>/ <code>UnderBroadcast</code>/<code>OverBroadcast</code>, dropping the dead <code>broadcastSizing</code> key entirely). No two <code>REGISTRY</code> entries share a <code>component</code> value any more.</p><p>Each widget component receives the full catalog and self-gates when it has nothing to show, rendering <code>null</code> or a muted &quot;no issue&quot; card for the always-visible ones. <code>orderedWidgets()</code> itself has no empty/non-empty branching, since it iterates the static <code>DETECTORS</code> import, not the runtime <code>catalog</code>.</p></li></ul><p>Thresholds live only in each entry&#39;s <code>thresholds</code>; see <a href="#bottleneck-thresholds-spec-§4">Bottleneck thresholds</a>.</p><h2 id="confidence-disclosure" tabindex="-1">Confidence disclosure <a class="header-anchor" href="#confidence-disclosure" aria-label="Permalink to &quot;Confidence disclosure&quot;">​</a></h2><p>A <code>Detector</code> entry (or the <code>Finding</code> it returns) may carry <code>confidence: &#39;low&#39; | &#39;medium&#39; | &#39;high&#39;</code> plus a <code>validationRequired</code> string. <code>RowStatusCluster</code> (<code>src/view/RowStatusCluster.tsx</code>) is the one place that renders it, gated to Advanced density: a plain &quot;&lt;confidence&gt; confidence&quot; badge whose tooltip carries the full <code>validationRequired</code> text. A finding with no <code>confidence</code> field renders identically to a fully-validated one, so every detector whose thresholds are our own unvalidated noise floor (marked <code>NOT SOURCED</code> in a code comment) should set both fields, not just the ones that happen to already have <code>RowStatusCluster</code> wired into their widget. <code>skew</code>, <code>straggler</code>, and <code>gc</code> set <code>confidence</code> for exactly this reason: their runtime-floor thresholds carry the same kind of unvalidated-noise-floor caveat <code>coreLocality</code>, <code>autoscalingChurn</code>, and <code>memoryUtilization</code>&#39;s <code>wasteModel</code> variant already disclose. None of these hardcode a single confidence value: each scales <code>&#39;low&#39; | &#39;medium&#39; | &#39;high&#39;</code> off how far the finding sits past its own detector&#39;s threshold, via a small named helper placed just above the <code>DETECTORS</code> array (e.g. <code>skewConfidence</code>, <code>coreLocalityConfidence</code>, <code>cachingReuseConfidence</code>) rather than an inline literal.</p><h2 id="the-fixeffort-field" tabindex="-1">The <code>fixEffort</code> field <a class="header-anchor" href="#the-fixeffort-field" aria-label="Permalink to &quot;The `fixEffort` field&quot;">​</a></h2><p>Each <code>Detector</code> entry also carries <code>fixEffort: &#39;config&#39; | &#39;code&#39; | &#39;rearchitect&#39;</code>, alongside <code>order</code> and <code>thresholds</code>: a rough estimate of how much work resolving the finding takes.</p><p>No view currently reads it. The quadrant impact/effort bucketing this field was meant to feed (<code>bucketFinding</code>/<code>effortTier</code>/<code>computeImpactMagnitude</code> in a since-deleted <code>src/quadrant-bucket.ts</code>, gated behind a <code>FIX_EFFORT_MAPPING_REVIEWED</code> flag that never flipped to <code>true</code>) was removed as dead code in the recommendations-consolidation redesign: <code>FixTheseFirst</code> (<code>src/view/widgets/FixTheseFirst.tsx</code>) ranks purely by impact magnitude. See <a href="./widget-rendering.html#widget-rendering-order-fixed-spec-§5">Widget rendering order</a> for how it ranks findings today.</p><p>Two shared helpers back multiple detectors and reports. <code>packages/core/src/plan-tree-walk.ts</code>&#39;s <code>walkPlanTree(root, visit, {dedupe})</code> is the iterative pre-order plan-tree traversal used by <code>detectors.ts</code> and every <code>plan-*.ts</code> module (<code>plan-summary.ts</code>, <code>plan-duration-attribution.ts</code>, <code>plan-node-detail.ts</code>, <code>plan-dot.ts</code>). <code>packages/core/src/core-count.ts</code>&#39;s <code>computeTotalCores(app, executorsAdded)</code> is the shared core-count logic used by <code>efficiency-model.ts</code>, <code>scaling-sim.ts</code>, and <code>wasted-core-hours.ts</code>. <code>detectors.ts</code>&#39;s own <code>utilization</code> and <code>memoryUtilization</code> entries use the same file&#39;s <code>computePeakConcurrentCores</code>/<code>computePeakConcurrentExecutorCount</code> instead: <code>computeTotalCores</code> sums every <code>ExecutorAdded</code> event with no regard for overlap, so under executor churn (spot preemption, <code>dynamicAllocation</code> replacement) it double-counts a churned executor&#39;s capacity against its replacement&#39;s; the peak-concurrent sweeps don&#39;t.</p><h2 id="cross-detector-suppression" tabindex="-1">Cross-detector suppression <a class="header-anchor" href="#cross-detector-suppression" aria-label="Permalink to &quot;Cross-detector suppression&quot;">​</a></h2><p>An entry may declare an optional <code>suppressWhen(finding, out)</code> method. <code>analyzer.ts</code>&#39;s <code>push()</code>, the single choke point every finding passes through, calls it per-finding, after the null guard and before the push, and drops the finding silently when it returns <code>true</code>. <code>out</code> is the findings accumulated so far. Since <code>analyze()</code>&#39;s loop is detector-outer / stage-inner, every finding from a detector declared earlier in <code>DETECTORS</code> is already in <code>out</code> by the time a later detector runs, for every stage. That makes the pattern purely declaration-order-driven: the suppressing detector must be declared earlier in the <code>DETECTORS</code> array than the suppressed one.</p><p><code>stageSlowness</code> uses this to defer to <code>slowHost</code>. It is spliced immediately after the <code>slowHost</code> entry regardless of its <code>order</code> field (<code>order</code> only controls render sequencing, not evaluation order), and <code>tests/analyzer.test.js</code>&#39;s &quot;detector contract&quot; suite asserts the array-index ordering so a future reorder can&#39;t silently break the suppression. The mechanism is deliberately minimal: a same-array, predicate-in-<code>push()</code> filter, not a general dependency graph. <code>auditConfig()</code>&#39;s own <code>push()</code> call is unaffected, since <code>scope:&#39;config&#39;</code> entries declare no <code>suppressWhen</code>.</p><h2 id="per-operator-duration-attribution" tabindex="-1">Per-operator duration attribution <a class="header-anchor" href="#per-operator-duration-attribution" aria-label="Permalink to &quot;Per-operator duration attribution&quot;">​</a></h2><p><code>packages/core/src/plan-duration-attribution.ts</code> (entry <code>attributeStageDurationToPlan(planTree, stagesById, sqlExec)</code>) approximates how a SQL execution&#39;s stage wall-time splits across plan operators, returning a <code>Map&lt;planNode, milliseconds&gt;</code>. It cuts the plan tree at Exchange boundaries into connected components: since the Exchange write/read split (<code>resolvePlanTree</code> in <code>event-handlers.ts</code> always synthesizes a <code>read</code> node wrapping a <code>write</code> node for every raw <code>Exchange</code>/<code>BroadcastExchange</code>), the cut is keyed off <code>PlanNode.exchangeRole === &#39;read&#39;</code> on the parent, not a name regex: the write half starts the new component, the read half stays in its parent&#39;s. A node with no <code>exchangeRole</code> at all (for example <code>ReusedExchange</code>, which is never split) never starts a new component on its own, unlike the old name-based regex, which matched any Exchange-family name regardless of split state. Each component receives a stable pre-order identity and separate parent/depth/traversal metadata; the identity itself does not encode its count of Exchange ancestors. It zips components deepest-first by that explicit depth against submission-ordered stage IDs, then apportions each matched stage&#39;s wall-time across that component&#39;s nodes by timing-metric weight, falling back to an even split when no node carries a timing metric.</p><p>This is best-effort inference, not measurement. Spark&#39;s event model exposes no ground truth for per-operator time within a stage; the Exchange-boundary segmentation and deepest-component-to-earliest-stage zip are heuristics. Treat the per-operator numbers as directional hints, never as authoritative timings, and do not build hard thresholds or findings on top of them.</p><h2 id="stage-id-attribution-for-plan-advisor-findings" tabindex="-1">Stage-ID attribution for Plan Advisor findings <a class="header-anchor" href="#stage-id-attribution-for-plan-advisor-findings" aria-label="Permalink to &quot;Stage-ID attribution for Plan Advisor findings&quot;">​</a></h2><p>The Plan Advisor detectors (<code>duplicatePlanSubtree</code>, <code>smallFiles</code>, <code>broadcastSizing</code> in <code>packages/core/src/detectors.ts</code>) each attribute their finding to a narrowed <code>stageIds</code> set rather than the whole SQL execution: <code>PlanNode.stageIds</code> is resolved once per plan tree at parse time by unioning, per node, every metric&#39;s accumulator ID against a <code>taskAccumStages: Map&lt;accumulatorId, Set&lt;stageId&gt;&gt;</code> built while parsing <code>TaskEnd</code> events, then clipping the result to the execution&#39;s own stage set. An accumulator ID occasionally points to a <em>different</em> execution&#39;s stages, e.g. a <code>ReusedSubquery</code> computed once and reused verbatim, and the clip prevents misattributing that other execution&#39;s work. Each detector unions its implicated node(s)&#39; <code>stageIds</code> and falls back to the execution-wide set only when no implicated node has any coverage; a finding never partially blends a narrowed set with the execution-wide one. When an execution has no stage universe at all (no jobs ever recorded against it, which is true for 42% of real-log SQL executions with a plan tree, typically job-less/driver-only executions), the clip drops every candidate stage ID instead of passing them through: every node in that execution&#39;s tree ends up with no <code>stageIds</code> anywhere, same &quot;coverage is partial&quot; framing as below. (An earlier version of this clip treated &quot;no stage universe&quot; as &quot;no clip,&quot; which let a foreign accumulator ID collision, e.g. the <code>ReusedSubquery</code> case above, leak another execution&#39;s stages into a job-less execution&#39;s nodes; the clip is now unconditional on <code>executionStageIds</code> being present.)</p><p>Coverage is partial by Spark&#39;s own design: whole-stage-codegen wrapper nodes (<code>InputAdapter</code>, and other purely structural passthrough markers) carry no accumulators at all, and <code>BroadcastExchangeExec</code>&#39;s own metrics are computed entirely on the driver and never appear on any <code>TaskEnd</code> (real Spark behavior). Since the Exchange write/read split, those driver-computed metrics live specifically on the synthesized <em>write</em> half (<code>exchangeRole: &#39;write&#39;</code>); the <em>read</em> half always carries <code>metrics: []</code>. The write half&#39;s immediate child, which does carry executor-side metrics, is unioned in instead, see <code>overBroadcast</code>&#39;s wiring. A <code>TaskEnd</code> arriving after its stage has already been finalized is also silently excluded from <code>taskAccumStages</code>, consistent with the parser&#39;s existing out-of-order tolerance elsewhere.</p><p><code>planTree</code> itself is kept current against Spark&#39;s adaptive query execution (AQE) re-plans: <code>SparkListenerSQLAdaptiveExecutionUpdate</code> events overwrite the execution&#39;s <code>sparkPlanInfo</code>/<code>physicalPlanDescription</code> last-write-wins, so accumulator-ID evidence is matched against the plan that actually ran rather than a stale pre-AQE snapshot.</p><p>No eviction/pruning is added to <code>taskAccumStages</code>, a deliberate choice, not an oversight: measured on real logs, it holds roughly 1,050 keys per compressed MB (9,850 keys on an 11.6 MB fixture, about 29,000 keys on a 28.1 MB fixture). Extrapolated to a 240MB+ log, the scale this tool targets (see <code>CLAUDE.md</code>), that is roughly 250,000 keys, around 45 MB of heap for an equivalent synthetic <code>Map&lt;number, Set&lt;number&gt;&gt;</code>. This heap estimate is still small relative to this tool&#39;s other in-memory state. It is higher, though, than the fixture-only measurements taken when this mechanism was built suggested.</p><p>Per-execution pruning (e.g. dropping a <code>taskAccumStages</code> entry once its stage finalizes or its owning SQL execution resolves, mirroring how <code>accumState</code> is cleared in <code>endSqlExecution</code>) is deliberately not done either: unlike <code>accumState</code>, <code>taskAccumStages</code> is one global, un-scoped map read by every execution&#39;s <code>resolvePlanTree</code> call, and the <code>ReusedSubquery</code> case above depends on a stage recorded under one execution still being visible when a later execution resolves. Pruning on any single execution&#39;s lifecycle would break that cross-execution lookup. What is bounded is the growth from a single pathological event: <code>TaskEndEventSchema</code>&#39;s <code>Accumulables</code> array is capped at <code>MAX_ACCUMULABLES_PER_TASK</code> (10,000, <code>event-schemas.ts</code>), well above any real plan&#39;s per-task metric count, so a single crafted <code>TaskEnd</code> can&#39;t grow the map past that per-event bound; a <code>TaskEnd</code> exceeding it fails schema validation and the line is skipped (counted in <code>skippedLines</code>) like any other malformed event.</p><h2 id="bottleneck-thresholds-spec-§4" tabindex="-1">Bottleneck thresholds (spec §4) <a class="header-anchor" href="#bottleneck-thresholds-spec-§4" aria-label="Permalink to &quot;Bottleneck thresholds (spec §4)&quot;">​</a></h2><p>Every change to <code>packages/core/src/detectors.ts</code> should reference this table.</p><p>Every finding&#39;s <code>impactBand</code> comes from one of two places. For any finding whose <code>impactEstimate</code> carries a <code>wallClock</code> estimate (the common case for most rules below), <code>analyzer.ts</code> calls <code>deriveImpactBand()</code> (<code>packages/core/src/impact-band.ts</code>) immediately after <code>estimateImpact()</code>, which sets <code>.impactBand</code> purely from <code>wallClock.high</code> as a fraction of the app&#39;s total duration (<code>&gt;= 2%</code> critical, <code>&gt;= 0.5%</code> warning, else info: the same <code>floorPctWarn</code>/<code>floorPctCrit</code> values <code>skew</code>/<code>straggler</code> use for their own thresholds below). For those rules, the table below documents their firing gate plus their fixed fallback constant, which surfaces only when this run&#39;s finding of that type didn&#39;t get a wallClock estimate (a stage excluded from the occupancy sweep). For rules whose finding type never gets a wallClock estimate (<code>resourceOnly</code>/<code>informational</code> basis, e.g. <code>configAudit</code>, or a rule that keeps its own ratio-tiered classification per the design&#39;s Decision 2, e.g. <code>failures</code>), the full threshold table below is the real, displayed classification: <code>detectors.ts</code> sets <code>impactBand</code> directly and nothing overwrites it. <code>partitionSizing</code>&#39;s <code>maxPartitionTooBig</code> rule is a third case: it does carry a <code>wallClock</code> estimate but is explicitly exempted in <code>deriveImpactBand()</code> because it&#39;s a hardcoded-critical OOM/crash-risk safety signal, not a time-recovery one, so <code>detectors.ts</code>&#39;s own classification stands regardless of how small that estimate is relative to the run.</p><h3 id="fixed-fallback-only-usually-wallclock-derived-instead" tabindex="-1">Fixed fallback only (usually wallClock-derived instead) <a class="header-anchor" href="#fixed-fallback-only-usually-wallclock-derived-instead" aria-label="Permalink to &quot;Fixed fallback only (usually wallClock-derived instead)&quot;">​</a></h3><p>These rules&#39; <em>band</em> tiers were deleted from <code>packages/core/src/detectors.ts</code> (they were always overwritten by <code>deriveImpactBand</code> whenever a wallClock estimate was available); the constant in the last column is only a floor-case fallback. Their <em>firing</em> gate is untouched and still lives in each entry&#39;s <code>thresholds</code> object: it decides whether the rule reports anything, so it stays documented here in full.</p><table tabindex="0"><thead><tr><th>Rule</th><th>Fires when</th><th>Fallback</th></tr></thead><tbody><tr><td>Task skew</td><td><code>taskDurationP95 / taskDurationP50 &gt; 3×</code> (<code>taskDurationMax / P50</code> for stages under <code>minTasksForP95</code> = 20 tasks), <strong>and</strong> the occupancy-clipped P95−P50 (or max−P50) delta is ≥ <code>floorPctWarn</code> = 0.5% of app runtime</td><td><code>warning</code></td></tr><tr><td>Shuffle read</td><td><code>shuffleReadBytes &gt; minBytes</code> = 50 MiB</td><td><code>info</code></td></tr><tr><td>Partition sizing: skew</td><td><code>shuffleReadMax &gt; 5×</code> <code>shuffleReadP50</code> <strong>and</strong> <code>shuffleReadMax &gt; 256 MiB</code></td><td><code>warning</code></td></tr><tr><td>Partition sizing: low parallelism</td><td><code>shuffleReadBytes ≥ 1 GiB</code> <strong>and</strong> <code>taskCount ≤ 7</code></td><td><code>warning</code></td></tr><tr><td>Partition sizing: oversized partition</td><td><code>shuffleReadMax ≥ 5 GiB</code></td><td><code>critical</code></td></tr><tr><td>GC</td><td><code>executorRunTime ≥ minRunTimeMs</code> = 10 s <strong>and</strong> <code>gcPct &gt; 10%</code></td><td><code>warning</code></td></tr><tr><td>GC (low / cost)</td><td><code>executorRunTime ≥ 10 s</code> <strong>and</strong> <code>gcPct &lt; lowInfoPct100</code> = 5% (checked only when the GC row above did not fire)</td><td><code>info</code></td></tr><tr><td>Spill (magnitude v2)</td><td>any non-zero <code>memoryBytesSpilled</code>. The magnitude sub-table below classifies <em>how much</em>, but does not gate firing</td><td><code>warning</code></td></tr><tr><td>Cold start</td><td><code>firstStageSubmittedAt − app.startTime &gt; gapSeconds</code> = 30 s</td><td><code>warning</code></td></tr><tr><td>Slow host: mean-duration ratio</td><td>stage has ≥ <code>minHosts</code> = 3 hosts (or executors) and ≥ <code>minTasks</code> = 15 tasks; then per host: mean task duration / overall median ≥ <code>ratioWarn</code> = 2.0× <strong>and</strong> host task-share ≥ <code>minShare</code> = 20% <strong>and</strong> host mean ≥ <code>floorMs</code> = 1000 ms (absolute-magnitude floor, rules out sub-second noise)</td><td><code>warning</code></td></tr><tr><td>Slow host: duration-share</td><td>same stage gate as the row above; then per host: ≥ <code>shareWarn</code> = 75% of the stage&#39;s total task-duration <strong>and</strong> ≥ <code>taskShareWarn</code> = 50% of its task count</td><td><code>warning</code></td></tr><tr><td>Stage slowness: absolute fallback, suppressed when <code>slowHost</code> already fired</td><td>stage wall-clock duration ≥ <code>infoMin</code> = 15 min</td><td><code>info</code></td></tr><tr><td>Straggler / speculative-execution</td><td><code>taskCount ≥ minTasks</code> = 10, <strong>and</strong> either any speculative task ran <strong>or</strong> straggler share &gt; <code>shareWarn</code> = 5%. <code>warnPct</code>/<code>critPct</code> (10%/20% speculative share) and <code>floorPctWarn</code>/<code>floorPctCrit</code> (0.5%/2% of app runtime) no longer set the band; they rank the straggler-vs-speculative tiers that pick which <em>metric</em> the finding reports</td><td><code>info</code></td></tr><tr><td>Speculation waste (new)</td><td><code>speculationWastedAttempts ≥ minWasted</code> = 5 <strong>and</strong> <code>speculationWasteMs ≥ minWasteMs</code> = 60 s</td><td><code>warning</code></td></tr><tr><td>Retry waste</td><td><code>wastedAttempts ≥ minWasted</code> = 3 <strong>and</strong> <code>retryWasteMs ≥ minWasteMs</code> = 30 s, on a stage that still completed</td><td><code>warning</code></td></tr><tr><td>Tiny tasks</td><td><code>taskCount ≥ minTasks</code> = 100 <strong>and</strong> <code>taskDurationP50 ≤ maxP50</code> = 500 ms <strong>and</strong> <code>taskDurationP95 ≤ maxP95</code> = 1000 ms</td><td><code>info</code></td></tr><tr><td>Duplicate plan subtree</td><td>a subtree of ≥ <code>minSubtreeSize</code> = 3 nodes whose shape fingerprint repeats ≥ <code>minOccurrences</code> = 2× in the plan</td><td><code>warning</code></td></tr><tr><td>Small files read/write</td><td>per read/write side: file count &gt; <code>minFiles</code> = 100 <strong>and</strong> average file size &lt; <code>maxAvgFileSizeMB</code> = 3 MiB</td><td><code>warning</code></td></tr><tr><td>Broadcast sizing: missed</td><td>a 2-child <code>SortMergeJoin</code> whose smaller side is &lt; 10 MiB (unconditional), or &lt; 100 MiB with the larger side &gt; 10 GiB, or &lt; 1 GiB with larger &gt; 300 GiB, or &lt; 5 GiB with larger &gt; 1 TiB (<code>broadcastTiers</code> × <code>comparisonTiers</code>)</td><td><code>info</code></td></tr><tr><td>Broadcast sizing: oversized</td><td>a <code>BroadcastExchange</code> node whose <code>data size</code> metric &gt; <code>overBroadcastBytes</code> = 1 GiB</td><td><code>warning</code></td></tr></tbody></table><h4 id="spill-magnitude-tiers" tabindex="-1">Spill magnitude tiers <a class="header-anchor" href="#spill-magnitude-tiers" aria-label="Permalink to &quot;Spill magnitude tiers&quot;">​</a></h4><p>The spill row&#39;s band is a fixed <code>warning</code> fallback, but <code>computeSpillMagnitude</code> (<code>packages/core/src/detectors.ts</code>) still runs on every spill finding and sets its <code>spillMagnitude</code> field, which the Spill widget displays. Its tiers, in evaluation order (first match wins, <code>null</code> when nothing matches):</p><table tabindex="0"><thead><tr><th>Condition</th><th>Magnitude</th></tr></thead><tbody><tr><td>Single-task stage: <code>spillDiskMax ≥ singleTaskDiskGiB</code> = 1 GiB <strong>or</strong> <code>spillMemMax ≥ singleTaskMemGiB</code> = 4 GiB</td><td><code>severe</code></td></tr><tr><td>Multi-task stage: <code>spillDiskMax ≥ highDiskGiB</code> = 1 GiB, <strong>or</strong> <code>spillDiskMax / taskCount ≥ highTaskDiskMB</code> = 512 MiB (per-task proxy), <strong>or</strong> <code>spillMemMax ≥ highMemGiB</code> = 4 GiB</td><td><code>high</code></td></tr><tr><td>Multi-task stage: <code>spillDiskMax ≥ medDiskMB</code> = 256 MiB <strong>or</strong> <code>spillMemMax ≥ medMemGiB</code> = 1 GiB</td><td><code>medium</code></td></tr><tr><td>Skew (<code>taskCount ≥ skewMinTasks</code> = 10): <code>spillDiskMax / spillDiskP50 &gt; skewRatio</code> = 5× <strong>and</strong> <code>spillDiskMax ≥ skewDiskFloorMB</code> = 128 MiB</td><td><code>high</code></td></tr><tr><td>Skew (<code>taskCount ≥ 10</code>): <code>spillMemMax / spillMemP50 &gt; 5×</code> <strong>and</strong> <code>spillMemMax ≥ skewMemFloorMB</code> = 256 MiB</td><td><code>medium</code></td></tr></tbody></table><p>Disk spill is weighted worse than memory spill by design: the memory thresholds sit well above their disk counterparts at every tier.</p><h3 id="full-threshold-table-never-wallclock-derived" tabindex="-1">Full threshold table (never wallClock-derived) <a class="header-anchor" href="#full-threshold-table-never-wallclock-derived" aria-label="Permalink to &quot;Full threshold table (never wallClock-derived)&quot;">​</a></h3><table tabindex="0"><thead><tr><th>Rule</th><th>Warning</th><th>Critical</th></tr></thead><tbody><tr><td>Stage shape: PRatio</td><td><code>taskCount / totalCores &lt; 0.5</code> (info, under-parallelized)</td><td>none</td></tr><tr><td>Stage shape: OIRatio</td><td><code>outputBytes / inputBytes &gt; 10×</code> (info, data explosion)</td><td>none</td></tr><tr><td>Stage shape: TaskStageSkew</td><td><code>taskDurationMax / stageDuration &gt; 3×</code> (info)</td><td>none</td></tr><tr><td>Failed tasks</td><td>failure rate &gt; 5% (min 10 tasks)</td><td>&gt; 20%</td></tr><tr><td>Stage failed outright</td><td>none</td><td>any <code>stageFailureReason</code> present</td></tr><tr><td>Slow host: multi-dimensional</td><td>max/median ratio across taskTime/inputBytes/shuffleBytes/storageMemory ≥ 1.33× (info); each dimension&#39;s sample must also clear an absolute floor (1000 ms for taskTime, 64 MiB for the byte dimensions)</td><td>≥ 3.16× warning, ≥ 10× critical</td></tr><tr><td>Utilization</td><td>avg active executors / peak &lt; 60% (info)</td><td>none</td></tr><tr><td>Autoscaling churn: short-lived executors (design spike, unvalidated thresholds)</td><td>&gt; 30% of executors alive under 2 min (min 5 executors)</td><td>&gt; 60%</td></tr><tr><td>Job failure rate</td><td>≥ 30% (≥ 10% info)</td><td>≥ 50%</td></tr><tr><td>Idle cores</td><td>busy-core-time / (peak cores × wall-clock) idle &gt; 50% (warning)</td><td>none</td></tr><tr><td>Memory band</td><td>peak heap / allocated &gt; 95% too-small (warning); &lt; 70% over-provisioned (info)</td><td>none</td></tr><tr><td>Caching opportunity</td><td>RDD read across ≥3 stages without <code>.persist()</code></td><td>none (single tier, info)</td></tr><tr><td>Cache utilization: partial caching (this repo)</td><td><code>numCachedPartitions / numPartitions &lt; 0.90</code> (info)</td><td><code>&lt; 0.50</code> (warning)</td></tr><tr><td>Cache utilization: disk spillover (this repo)</td><td><code>diskSize / (memorySize + diskSize) &gt; 0.15</code> (info), <code>MEMORY_AND_DISK*</code> only</td><td><code>&gt; 0.40</code> (warning)</td></tr></tbody></table><p>Spill classification: ≥80% tasks with zero spill → <code>skew</code>; &lt;20% zero → <code>volume</code>; else <code>unclassified</code>. The classification badge is always shown in both compact and expanded spill widget states. This is independent of the magnitude tiers above: classification says <em>what kind</em> of spill, magnitude says <em>how much</em>.</p><h4 id="evidence-fields-stagefailed-retrywaste" tabindex="-1">Evidence fields (<code>stageFailed</code> / <code>retryWaste</code>) <a class="header-anchor" href="#evidence-fields-stagefailed-retrywaste" aria-label="Permalink to &quot;Evidence fields (`stageFailed` / `retryWaste`)&quot;">​</a></h4><p>Neither entry&#39;s <code>detect()</code> used to put anything beyond a scalar <code>metric</code>/ <code>value</code> on its finding. Both now also attach:</p><ul><li><code>numTasks</code>: <code>stage.taskCount</code> at detection time.</li><li><code>memoryBytesSpilled</code>: <code>stage.memoryBytesSpilled</code> at detection time.</li><li><code>stageFailed</code> only: <code>failedTaskDetails</code>: up to 20 <code>FailedTaskSample</code> records (<code>taskId</code>, <code>attemptNumber</code>, <code>host</code>, <code>executorId</code>, <code>reason</code>, <code>peakExecMem</code>, <code>memSpilled</code>, <code>shuffleWrite</code>) for tasks still marked failed when the stage was finalized (<code>finalizeStage</code>, <code>stage-quantiles.ts</code>).</li><li><code>retryWaste</code> only: <code>retriedTaskDetails</code>: up to 20 <code>FailedTaskSample</code> records for attempts discarded by the retry-dedup logic in <code>accumulateTask</code> (<code>event-handlers.ts</code>): captured at the moment they&#39;d otherwise be thrown away, since by finalize time only the winning attempt survives.</li></ul><p>Both sample arrays are capped at 20 entries, filled in first-encountered order (finalize order for <code>failedTaskDetails</code>, discard order for <code>retriedTaskDetails</code>), not spread across distinct hosts/executors: a stage with failures clustered on one bad host could fill the cap before a more informative failure elsewhere in the stage is ever sampled. This is the first evidence-shape documentation in this file; no other finding type has one yet.</p>',39)])])}const g=t(c,[["render",s]]);export{p as __pageData,g as default};