1"use strict";(self.webpackChunk_N_E=self.webpackChunk_N_E||[]).push([[5882],{2764:(e,t,n)=>{n.d(t,{J:()=>o}),n(10472);var r=n(12115);function o(e){let t=(0,r.useRef)(e);return t.current=e,(0,r.useCallback)(function(){for(var e=arguments.length,n=Array(e),r=0;r<e;r++)n[r]=arguments[r];return t.current(...n)},[])}},10472:(e,t,n)=>{},17714:(e,t,n)=>{n.d(t,{L:()=>s,TreeContextProvider:()=>l,t:()=>d});var r=n(95155),o=n(99987),a=n(12115),u=n(80909);let i=(0,o.q6)("TreeContext"),c=(0,o.q6)("PathContext",[]);function l(e){var t,n;let l=(0,a.useRef)(0),s=(0,o.a8)(),d=(0,a.useMemo)(()=>e.tree,[null!=(t=e.tree.$id)?t:e.tree]),f=(0,a.useMemo)(()=>{var e;return null!=(e=(0,u.oe)(d.children,s))?e:[]},[d,s]),h=null!=(n=f.findLast(e=>"folder"===e.type&&e.root))?n:d;return null!=h.$id||(h.$id=String(l.current++)),(0,r.jsx)(i.Provider,{value:(0,a.useMemo)(()=>({root:h}),[h]),children:(0,r.jsx)(c.Provider,{value:f,children:e.children})})}function s(){return c.use()}function d(){return i.use("You must wrap this component under <DocsLayout />")}},21705:(e,t,n)=>{n.d(t,{N_:()=>d,Uy:()=>i,_V:()=>s,a8:()=>c,q6:()=>f,rd:()=>l});var r=n(12115),o=n(95155),a=()=>{throw Error("You need to wrap your application inside `FrameworkProvider`.")},u=f("FrameworkContext",{useParams:a,useRouter:a,usePathname:a});function i({children:e,...t}){let n=r.useMemo(()=>({usePathname:t.usePathname,useRouter:t.useRouter,Link:t.Link,Image:t.Image,useParams:t.useParams}),[t.Link,t.usePathname,t.useRouter,t.useParams,t.Image]);return(0,o.jsx)(u.Provider,{value:n,children:e})}function c(){return u.use().usePathname()}function l(){return u.use().useRouter()}function s(e){let{Image:t}=u.use();if(!t){let{src:t,alt:n,priority:r,...a}=e;return(0,o.jsx)("img",{alt:n,src:t,fetchPriority:r?"high":"auto",...a})}return(0,o.jsx)(t,{...e})}function d(e){let{Link:t}=u.use();if(!t){let{href:t,prefetch:n,...r}=e;return(0,o.jsx)("a",{href:t,...r})}return(0,o.jsx)(t,{...e})}function f(e,t){let n=r.createContext(t);return{Provider:e=>(0,o.jsx)(n.Provider,{value:e.value,children:e.children}),use:t=>{let o=r.useContext(n);if(!o)throw Error(t??`Provider of ${e} is required but missing.`);return o}}}},40101:(e,t,n)=>{n.d(t,{A:()=>Z});var r,o,a=function(){return(a=Object.assign||function(e){for(var t,n=1,r=arguments.length;n<r;n++)for(var o in t=arguments[n])Object.prototype.hasOwnProperty.call(t,o)&&(e[o]=t[o]);return e}).apply(this,arguments)};function u(e,t){var n={};for(var r in e)Object.prototype.hasOwnProperty.call(e,r)&&0>t.indexOf(r)&&(n[r]=e[r]);if(null!=e&&"function"==typeof Object.getOwnPropertySymbols)for(var o=0,r=Object.getOwnPropertySymbols(e);o<r.length;o++)0>t.indexOf(r[o])&&Object.prototype.propertyIsEnumerable.call(e,r[o])&&(n[r[o]]=e[r[o]]);return n}Object.create;Object.create;var i=("function"==typeof SuppressedError&&SuppressedError,n(12115)),c="right-scroll-bar-position",l="width-before-scroll-bar";function s(e,t){return"function"==typeof e?e(t):e&&(e.current=t),e}var d="undefined"!=typeof window?i.useLayoutEffect:i.useEffect,f=new WeakMap;function h(e){return e}var v=function(e){void 0===e&&(e={});var t,n,r,o=(void 0===t&&(t=h),n=[],r=!1,{read:function(){if(r)throw Error("Sidecar: could not `read` from an `assigned` medium. `read` could be used only with `useMedium`.");return n.length?n[n.length-1]:null},useMedium:function(e){var o=t(e,r);return n.push(o),function(){n=n.filter(function(e){return e!==o})}},assignSyncMedium:function(e){for(r=!0;n.length;){var t=n;n=[],t.forEach(e)}n={push:function(t){return e(t)},filter:function(){return n}}},assignMedium:function(e){r=!0;var t=[];if(n.length){var o=n;n=[],o.forEach(e),t=n}var a=function(){var n=t;t=[],n.forEach(e)},u=function(){return Promise.resolve().then(a)};u(),n={push:function(e){t.push(e),u()},filter:function(e){return t=t.filter(e),n}}}});return o.options=a({async:!0,ssr:!1},e),o}(),p=function(){},m=i.forwardRef(function(e,t){var n,r,o,c,l=i.useRef(null),h=i.useState({onScrollCapture:p,onWheelCapture:p,onTouchMoveCapture:p}),m=h[0],g=h[1],y=e.forwardProps,b=e.children,w=e.className,E=e.removeScrollBar,x=e.enabled,C=e.shards,P=e.sideCar,S=e.noRelative,k=e.noIsolation,R=e.inert,j=e.allowPinchZoom,M=e.as,L=e.gapMode,N=u(e,["forwardProps","children","className","removeScrollBar","enabled","shards","sideCar","noRelative","noIsolation","inert","allowPinchZoom","as","gapMode"]),T=(n=[l,t],r=function(e){return n.forEac
1h(function(t){return s(t,e)})},(o=(0,i.useState)(function(){return{value:null,callback:r,facade:{get current(){return o.value},set current(value){var e=o.value;e!==value&&(o.value=value,o.callback(value,e))}}}})[0]).callback=r,c=o.facade,d(function(){var e=f.get(c);if(e){var t=new Set(e),r=new Set(n),o=c.current;t.forEach(function(e){r.has(e)||s(e,null)}),r.forEach(function(e){t.has(e)||s(e,o)})}f.set(c,n)},[n]),c),O=a(a({},N),m);return i.createElement(i.Fragment,null,x&&i.createElement(P,{sideCar:v,removeScrollBar:E,shards:C,noRelative:S,noIsolation:k,inert:R,setCallbacks:g,allowPinchZoom:!!j,lockRef:l,gapMode:L}),y?i.cloneElement(i.Children.only(b),a(a({},O),{ref:T})):i.createElement(void 0===M?"div":M,a({},O,{className:w,ref:T}),b))});m.defaultProps={enabled:!0,removeScrollBar:!0,inert:!1},m.classNames={fullWidth:l,zeroRight:c};var g=function(e){var t=e.sideCar,n=u(e,["sideCar"]);if(!t)throw Error("Sidecar: please provide `sideCar` property to import the right car");var r=t.read();if(!r)throw Error("Sidecar medium not found");return i.createElement(r,a({},n))};g.isSideCarExport=!0;var y=function(){var e=0,t=null;return{add:function(r){if(0==e&&(t=function(){if(!document)return null;var e=document.createElement("style");e.type="text/css";var t=o||n.nc;return t&&e.setAttribute("nonce",t),e}())){var a,u;(a=t).styleSheet?a.styleSheet.cssText=r:a.appendChild(document.createTextNode(r)),u=t,(document.head||document.getElementsByTagName("head")[0]).appendChild(u)}e++},remove:function(){--e||!t||(t.parentNode&&t.parentNode.removeChild(t),t=null)}}},b=function(){var e=y();return function(t,n){i.useEffect(function(){return e.add(t),function(){e.remove()}},[t&&n])}},w=function(){var e=b();return function(t){return e(t.styles,t.dynamic),null}},E={left:0,top:0,right:0,gap:0},x=function(e){return parseInt(e||"",10)||0},C=function(e){var t=window.getComputedStyle(document.body),n=t["padding"===e?"paddingLeft":"marginLeft"],r=t["padding"===e?"paddingTop":"marginTop"],o=t["padding"===e?"paddingRight":"marginRight"];return[x(n),x(r),x(o)]},P=function(e){if(void 0===e&&(e="margin"),"undefined"==typeof window)return E;var t=C(e),n=document.documentElement.clientWidth,r=window.innerWidth;return{left:t[0],top:t[1],right:t[2],gap:Math.max(0,r-n+t[2]-t[0])}},S=w(),k="data-scroll-locked",R=function(e,t,n,r){var o=e.left,a=e.top,u=e.right,i=e.gap;return void 0===n&&(n="margin"),"\n .".concat("with-scroll-bars-hidden"," {\n overflow: hidden ").concat(r,";\n padding-right: ").concat(i,"px ").concat(r,";\n }\n body[").concat(k,"] {\n overflow: hidden ").concat(r,";\n overscroll-behavior: contain;\n ").concat([t&&"position: relative ".concat(r,";"),"margin"===n&&"\n padding-left: ".concat(o,"px;\n padding-top: ").concat(a,"px;\n padding-right: ").concat(u,"px;\n margin-left:0;\n margin-top:0;\n margin-right: ").concat(i,"px ").concat(r,";\n "),"padding"===n&&"padding-right: ".concat(i,"px ").concat(r,";")].filter(Boolean).join(""),"\n }\n \n .").concat(c," {\n right: ").concat(i,"px ").concat(r,";\n }\n \n .").concat(l," {\n margin-right: ").concat(i,"px ").concat(r,";\n }\n \n .").concat(c," .").concat(c," {\n right: 0 ").concat(r,";\n }\n \n .").concat(l," .").concat(l," {\n margin-right: 0 ").concat(r,";\n }\n \n body[").concat(k,"] {\n ").concat("--removed-body-scroll-bar-size",": ").concat(i,"px;\n }\n")},j=function(){var e=parseInt(document.body.getAttribute(k)||"0",10);return isFinite(e)?e:0},M=function(){i.useEffect(function(){return document.body.setAttribute(k,(j()+1).toString()),function(){var e=j()-1;e<=0?document.body.removeAttribute(k):document.body.setAttribute(k,e.toString())}},[])},L=function(e){var t=e.noRelative,n=e.noImportant,r=e.gapMode,o=void 0===r?"margin":r;M();var a=i.useMemo(function(){return P(o)},[o]);return i.createElement(S,{styles:R(a,!t,o,n?"":"!important")})},N=!1;if("undefined"!=typeof window)try{var T=Object.defineProperty({},"passive",{get:function(){return N=!0,!0}});window.addEventListener("test",T,T),window.removeEventListener("test",T,T)}catch(e){N=!1}var O=!!N&&{passive:!1},A=function(e,t){if(!(e instanceof Element))return!1;var n=window.getComputedStyle(e);return"hidden"!==n[t]&&(n.overflowY!==n.overflowX||"TEXTAREA"===e.tagName||"visible"!==n[t])},I=function(e,t){var n=t.ownerDocument,r=t;do{if("undefined"!=typeof ShadowRoot&&r instanceof ShadowRoot&&(r=r.host),B(e,r)){var o=q(e,r);if(o[1]>o[2])return!0}r=r.parentNode}while(r&&r!==n.body);return!1},B=function(e,t){return"v"===e?A(t,"overflowY"):A(t,"overflowX")},q=function(e,t){return"v"===e?[t.scrollTop,t.scrollHeight,t.clientHeight]:[t.scrollLeft,t.scrollWidth,t.clientWidth]},Y=function(e,t,n,r,o){var a,u=(a=window.getComputedStyle(t).direction,"h"===e&&"rtl"===a?-1:1),i=u*r,c=n.target,l=t.contains(c),s=!1,d=i>0,f=0,h=0;
1do{if(!c)break;var v=q(e,c),p=v[0],m=v[1]-v[2]-u*p;(p||m)&&B(e,c)&&(f+=m,h+=p);var g=c.parentNode;c=g&&g.nodeType===Node.DOCUMENT_FRAGMENT_NODE?g.host:g}while(!l&&c!==document.body||l&&(t.contains(c)||t===c));return d&&(o&&1>Math.abs(f)||!o&&i>f)?s=!0:!d&&(o&&1>Math.abs(h)||!o&&-i>h)&&(s=!0),s},W=function(e){return"changedTouches"in e?[e.changedTouches[0].clientX,e.changedTouches[0].clientY]:[0,0]},_=function(e){return[e.deltaX,e.deltaY]},X=function(e){return e&&"current"in e?e.current:e},F=0,D=[];let G=(r=function(e){var t=i.useRef([]),n=i.useRef([0,0]),r=i.useRef(),o=i.useState(F++)[0],a=i.useState(w)[0],u=i.useRef(e);i.useEffect(function(){u.current=e},[e]),i.useEffect(function(){if(e.inert){document.body.classList.add("block-interactivity-".concat(o));var t=(function(e,t,n){if(n||2==arguments.length)for(var r,o=0,a=t.length;o<a;o++)!r&&o in t||(r||(r=Array.prototype.slice.call(t,0,o)),r[o]=t[o]);return e.concat(r||Array.prototype.slice.call(t))})([e.lockRef.current],(e.shards||[]).map(X),!0).filter(Boolean);return t.forEach(function(e){return e.classList.add("allow-interactivity-".concat(o))}),function(){document.body.classList.remove("block-interactivity-".concat(o)),t.forEach(function(e){return e.classList.remove("allow-interactivity-".concat(o))})}}},[e.inert,e.lockRef.current,e.shards]);var c=i.useCallback(function(e,t){if("touches"in e&&2===e.touches.length||"wheel"===e.type&&e.ctrlKey)return!u.current.allowPinchZoom;var o,a=W(e),i=n.current,c="deltaX"in e?e.deltaX:i[0]-a[0],l="deltaY"in e?e.deltaY:i[1]-a[1],s=e.target,d=Math.abs(c)>Math.abs(l)?"h":"v";if("touches"in e&&"h"===d&&"range"===s.type)return!1;var f=window.getSelection(),h=f&&f.anchorNode;if(h&&(h===s||h.contains(s)))return!1;var v=I(d,s);if(!v)return!0;if(v?o=d:(o="v"===d?"h":"v",v=I(d,s)),!v)return!1;if(!r.current&&"changedTouches"in e&&(c||l)&&(r.current=o),!o)return!0;var p=r.current||o;return Y(p,t,e,"h"===p?c:l,!0)},[]),l=i.useCallback(function(e){if(D.length&&D[D.length-1]===a){var n="deltaY"in e?_(e):W(e),r=t.current.filter(function(t){var r;return t.name===e.type&&(t.target===e.target||e.target===t.shadowParent)&&(r=t.delta,r[0]===n[0]&&r[1]===n[1])})[0];if(r&&r.should){e.cancelable&&e.preventDefault();return}if(!r){var o=(u.current.shards||[]).map(X).filter(Boolean).filter(function(t){return t.contains(e.target)});(o.length>0?c(e,o[0]):!u.current.noIsolation)&&e.cancelable&&e.preventDefault()}}},[]),s=i.useCallback(function(e,n,r,o){var a={name:e,delta:n,target:r,should:o,shadowParent:function(e){for(var t=null;null!==e;)e instanceof ShadowRoot&&(t=e.host,e=e.host),e=e.parentNode;return t}(r)};t.current.push(a),setTimeout(function(){t.current=t.current.filter(function(e){return e!==a})},1)},[]),d=i.useCallback(function(e){n.current=W(e),r.current=void 0},[]),f=i.useCallback(function(t){s(t.type,_(t),t.target,c(t,e.lockRef.current))},[]),h=i.useCallback(function(t){s(t.type,W(t),t.target,c(t,e.lockRef.current))},[]);i.useEffect(function(){return D.push(a),e.setCallbacks({onScrollCapture:f,onWheelCapture:f,onTouchMoveCapture:h}),document.addEventListener("wheel",l,O),document.addEventListener("touchmove",l,O),document.addEventListener("touchstart",d,O),function(){D=D.filter(function(e){return e!==a}),document.removeEventListener("wheel",l,O),document.removeEventListener("touchmove",l,O),document.removeEventListener("touchstart",d,O)}},[]);var v=e.removeScrollBar,p=e.inert;return i.createElement(i.Fragment,null,p?i.createElement(a,{styles:"\n .block-interactivity-".concat(o," {pointer-events: none;}\n .allow-interactivity-").concat(o," {pointer-events: all;}\n")}):null,v?i.createElement(L,{noRelative:e.noRelative,gapMode:e.gapMode}):null)},v.useMedium(r),g);var H=i.forwardRef(function(e,t){return i.createElement(m,a({},e,{ref:t,sideCar:G}))});H.classNames=m.classNames;let Z=H},44633:(e,t,n)=>{n.d(t,{T:()=>o});var r=n(12115);function o(e,t,n=function e(t,n){if(Array.isArray(t)&&Array.isArray(n))return n.length!==t.length||t.some((t,r)=>e(t,n[r]));if("object"==typeof t&&t&&"object"==typeof n&&n){let r=Object.keys(t),o=Object.keys(n);return r.length!==o.length||r.some(r=>e(t[r],n[r]))}return t!==n}){let[a,u]=(0,r.useState)(e);n(a,e)&&(t(e,a),u(e))}},53878:(e,t,n)=>{n.d(t,{I18nLabel:()=>a,s9:()=>u}),n(95155);var r=n(99987);n(2764),n(12115);let o=(0,r.q6)("I18nContext",{text:{search:"Search",searchNoResult:"No results found",toc:"On this page",tocNoHeadings:"No Headings",lastUpdate:"Last updated on",chooseLanguage:"Cho
1ose a language",nextPage:"Next Page",previousPage:"Previous Page",chooseTheme:"Theme",editOnGithub:"Edit on GitHub"}});function a(e){let{text:t}=u();return t[e.label]}function u(){return o.use()}},66218:(e,t,n)=>{n.d(t,{FX:()=>u,jH:()=>i});var r=n(12115),o=n(95155),a=r.createContext(void 0),u=e=>{let{dir:t,children:n}=e;return(0,o.jsx)(a.Provider,{value:t,children:n})};function i(e){let t=r.useContext(a);return e||t||"ltr"}},67652:(e,t,n)=>{n.d(t,{NavProvider:()=>s,StylesProvider:()=>c,h:()=>d,v:()=>i});var r=n(95155),o=n(12115),a=n(99987);let u=(0,a.q6)("StylesContext",{tocNav:"xl:hidden",toc:"max-xl:hidden"});function i(){return u.use()}function c(e){let{children:t,...n}=e;return(0,r.jsx)(u.Provider,{value:n,children:t})}let l=(0,a.q6)("NavContext",{isTransparent:!1});function s(e){let{transparentMode:t="none",children:n}=e,[a,u]=(0,o.useState)("none"!==t);return(0,o.useEffect)(()=>{if("top"!==t)return;let e=()=>{u(window.scrollY<10)};return e(),window.addEventListener("scroll",e),()=>{window.removeEventListener("scroll",e)}},[t]),(0,r.jsx)(l.Provider,{value:(0,o.useMemo)(()=>({isTransparent:a}),[a]),children:n})}function d(){return l.use()}},77222:(e,t,n)=>{n.d(t,{G:()=>s,c:()=>l});var r=n(95155),o=n(12115),a=n(99987),u=n(96824),i=n(79384);let c=(0,a.q6)("SidebarContext");function l(){return c.use()}function s(e){let{children:t}=e,n=(0,o.useRef)(!0),[l,s]=(0,o.useState)(!1),[d,f]=(0,o.useState)(!1),h=(0,a.a8)();return(0,i.T)(h,()=>{n.current&&s(!1),n.current=!0}),(0,r.jsx)(c.Provider,{value:(0,o.useMemo)(()=>({open:l,setOpen:s,collapsed:d,setCollapsed:f,closeOnRedirect:n}),[l,d]),children:(0,r.jsx)(u.GB,{open:l,onOpenChange:s,children:t})})}},79384:(e,t,n)=>{n.d(t,{T:()=>r.T});var r=n(44633);n(10472)},80909:(e,t,n)=>{function r(e,t,n){let{includePage:r=!0,includeSeparator:o=!1,includeRoot:a}=n,u=[];return t.forEach((e,n)=>{if("separator"===e.type&&o&&u.push({name:e.name}),"folder"===e.type){let r=t.at(n+1);if(r&&e.index===r)return;if(e.root){u=[];return}u.push({name:e.name,url:e.index?.url})}"page"===e.type&&r&&u.push({name:e.name,url:e.url})}),a&&u.unshift({name:e.name,url:"object"==typeof a?a.url:void 0}),u}n.d(t,{Pp:()=>r,oe:()=>function e(t,n){let r;for(let o of(n.endsWith("/")&&(n=n.slice(0,-1)),t)){if("separator"===o.type&&(r=o),"folder"===o.type){if(o.index?.url===n){let e=[];return r&&e.push(r),e.push(o,o.index),e}let t=e(o.children,n);if(t)return t.unshift(o),r&&t.unshift(r),t}if("page"===o.type&&o.url===n){let e=[];return r&&e.push(r),e.push(o),e}}return null}}),n(10472),n(12115)},96824:(e,t,n)=>{n.d(t,{GB:()=>c,Pg:()=>s,x2:()=>l}),n(10472);var r=n(12115),o=n(40101),a=n(95155),u=(0,r.createContext)(null);function i(){let e=(0,r.useContext)(u);if(!e)throw Error("Missing sidebar provider");return e}function c(e){let[t,n]=void 0===e.open?(0,r.useState)(!1):[e.open,e.onOpenChange];return(0,a.jsx)(u.Provider,{value:(0,r.useMemo)(()=>({open:t,setOpen:null!=n?n:()=>void 0}),[t,n]),children:e.children})}function l(e){let{as:t,...n}=e,{open:r,setOpen:o}=i();return(0,a.jsx)(null!=t?t:"button",{"aria-label":"Toggle Sidebar","data-open":r,onClick:()=>{o(!r)},...n})}function s(e){let{as:t,blockScrollingWidth:n,...u}=e,{open:c}=i(),[l,s]=(0,r.useState)(!1);return(0,r.useEffect)(()=>{if(!n)return;let e=window.matchMedia("(min-width: ".concat(n.toString(),"px)")),t=()=>{s(!e.matches)};return t(),e.addEventListener("change",t),()=>{e.removeEventListener("change",t)}},[n]),(0,a.jsx)(o.A,{as:null!=t?t:"aside","data-open":c,enabled:!!(l&&c),...u,children:u.children})}},99987:(e,t,n)=>{n.d(t,{Image:()=>r._V,a8:()=>r.a8,q6:()=>r.q6,rd:()=>r.rd});var r=n(21705);n(10472)}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.