docusaurus/assets/js/62b37705.3bf8a77d.js

"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([["2410"],{15028:function(e,n,t){t.d(n,{A:()=>r});let r={copyButtonCopied:"copyButtonCopied_wDuR",copyButtonIcons:"copyButtonIcons_gMWc",copyButtonIcon:"copyButtonIcon_GXfb",copyButtonSuccessIcon:"copyButtonSuccessIcon_ktUX"}},143:function(e,n,t){t.d(n,{A:()=>r});let r={wordWrapButtonIcon:"wordWrapButtonIcon___5r",wordWrapButtonEnabled:"wordWrapButtonEnabled_nam_"}},75864:function(e,n,t){t.d(n,{A:()=>r});let r={buttonGroup:"buttonGroup_KXnS"}},37322:function(e,n,t){t.d(n,{A:()=>r});let r={codeBlockContainer:"codeBlockContainer_jDV4"}},81772:function(e,n,t){t.d(n,{A:()=>r});let r={codeBlock:"codeBlock_Gebt",codeBlockStandalone:"codeBlockStandalone_i_cY",codeBlockLines:"codeBlockLines_FJaf",codeBlockLinesWithNumbering:"codeBlockLinesWithNumbering_FU9Q"}},73215:function(e,n,t){t.d(n,{A:()=>r});let r={codeBlockContent:"codeBlockContent_cKMj",codeBlockTitle:"codeBlockTitle_U6Q0",codeBlock:"codeBlock_QST6"}},631:function(e,n,t){t.d(n,{A:()=>r});let r={codeLine:"codeLine_qRmp",codeLineNumber:"codeLineNumber_dS_J",codeLineContent:"codeLineContent_XF5l"}},41452:function(e,n,t){t.d(n,{A:()=>r});let r={tabItem:"tabItem_pnkT"}},18416:function(e,n,t){t.d(n,{A:()=>r});let r={tabList:"tabList_Qoir",tabItem:"tabItem_AQgk"}},85120:function(e,n,t){t.d(n,{A:()=>r});let r={playgroundContainer:"playgroundContainer_TDLX"}},19304:function(e,n,t){t.d(n,{A:()=>r});let r={playgroundEditor:"playgroundEditor_uqZ4"}},79820:function(e,n,t){t.d(n,{A:()=>r});let r={playgroundHeader:"playgroundHeader_h_Hu"}},60477:function(e,n,t){t.d(n,{A:()=>r});let r={playgroundPreview:"playgroundPreview_u2xE"}},10608:function(e,n,t){t.r(n),t.d(n,{assets:()=>d,contentTitle:()=>u,default:()=>p,frontMatter:()=>i,metadata:()=>r,toc:()=>h});var r=t(37218),a=t(74848),s=t(56151),c=t(14729),o=t(13899),l=t(42743);let i={},u="Canary releases",d={},h=[{value:"Canary npm dist tag",id:"canary-npm-dist-tag",level:2},{value:"Using a canary release",id:"using-a-canary-release",level:2}];function m(e){let n={a:"a",admonition:"admonition",code:"code",h1:"h1",h2:"h2",header:"header",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,s.R)(),...e.components};return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(n.header,{children:(0,a.jsx)(n.h1,{id:"canary-releases",children:"Canary releases"})}),"\n","\n",(0,a.jsxs)(l.tu,{children:[(0,a.jsx)(n.p,{children:"Docusaurus has a canary releases system."}),(0,a.jsxs)(n.p,{children:["It permits you to ",(0,a.jsx)(n.strong,{children:"test new unreleased features"})," as soon as the pull requests are merged."]}),(0,a.jsxs)(n.p,{children:["It is a good way to ",(0,a.jsx)(n.strong,{children:"give feedback to maintainers"}),", ensuring the newly implemented feature works as intended."]}),(0,a.jsxs)(n.admonition,{type:"note",children:[(0,a.jsx)(n.p,{children:"Using a canary release in production might seem risky, but in practice, it's not."}),(0,a.jsx)(n.p,{children:"A canary release passes all automated tests and is used in production by the Docusaurus site itself."})]}),(0,a.jsx)(l.jL,{children:(0,a.jsx)(n.admonition,{type:"warning",children:(0,a.jsxs)(n.p,{children:["The canary version shown below ",(0,a.jsx)(n.strong,{children:"may not be up-to-date"}),". Please go to the ",(0,a.jsx)(n.a,{href:"https://www.npmjs.com/package/@docusaurus/core?activeTab=versions",children:"npm page"})," to find the actual version name."]})})}),(0,a.jsx)(l.uA,{children:(0,a.jsx)(n.admonition,{type:"tip",children:(0,a.jsxs)(n.p,{children:["The canary version shown below is directly fetched from npm and ",(0,a.jsx)(n.strong,{children:"is up-to-date"}),". You can directly use these numbers in your package.json."]})})}),(0,a.jsx)(n.h2,{id:"canary-npm-dist-tag",children:"Canary npm dist tag"}),(0,a.jsxs)(n.p,{children:["For any code-related commit on ",(0,a.jsx)(n.code,{children:"main"}),", the continuous integration will publish a canary release under the ",(0,a.jsx)(n.code,{children:"@canary"})," npm dist tag. It generally takes up to 10 minutes."]}),(0,a.jsxs)(n.p,{children:["You can see on ",(0,a.jsx)(n.a,{href:"https://www.npmjs.com/package/@docusaurus/core?activeTab=versions",children:"npm"})," the current dist tags:"]}),(0,a.jsxs)(n.ul,{children:["\n",(0,a.jsxs)(n.li,{children:[(0,a.jsx)(n.code,{children:"latest"}),": stable releases (Current: ",(0,a.jsx)(l.ex,{}),")"]}),"\n",(0,a.jsxs)(n.li,{children:[(0,a.jsx)(n.code,{children:"canary"}),": canary releases (",(0,a.jsx)(l.X0,{}),")"]}),"\n"]}),(0,a.jsx)(n.admonition,{type:"tip",children:(0,a.jsxs)(n.p,{children:["Make sure to use the latest canary release and check the publication date (sometimes the publish process fails). ",(0,a.jsx)(l.xs,{})]})}),(0,a.jsx)(n.admonition,{type:"note",children:(0,a.jsxs)(n.p,{children:["Canary versions follow the naming convention ",(0,a.jsx)(n.code,{children:"0.0.0-commitNumber"}),"."]})}),(0,a.jsx)(n.h2,{id:"using-a-canary-release",children:"Using a canary release"}),(0,a.jsxs)(n.p,{children:["Take the latest version published under the ",(0,a.jsx)(n.a,{href:"https://www.npmjs.com/package/@docusaurus/core?activeTab=versions",children:"canary npm dist tag"})," (",(0,a.jsx)(l.X0,{}),")."]}),(0,a.jsxs)(n.p,{children:["Use it for all the ",(0,a.jsx)(n.code,{children:"@docusaurus/*"})," dependencies in your ",(0,a.jsx)(n.code,{children:"package.json"}),":"]}),(0,a.jsx)(l.Cj,{}),(0,a.jsx)(n.p,{children:"Then, install the dependencies again and start your site:"}),(0,a.jsxs)(c.A,{children:[(0,a.jsx)(o.A,{value:"npm",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-bash",children:"npm install\nnpm start\n"})})}),(0,a.jsx)(o.A,{value:"yarn",label:"Yarn",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-bash",children:"yarn install\nyarn start\n"})})}),(0,a.jsx)(o.A,{value:"pnpm",label:"pnpm",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-bash",children:"pnpm install\npnpm start\n"})})}),(0,a.jsx)(o.A,{value:"bun",label:"Bun",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-bash",children:"bun install\nbun start\n"})})})]}),(0,a.jsxs)(n.p,{children:["You can also upgrade the ",(0,a.jsx)(n.code,{children:"@docusaurus/*"})," packages with command line:"]}),(0,a.jsxs)(c.A,{children:[(0,a.jsx)(o.A,{value:"npm",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-bash",children:"npm install --save-exact @docusaurus/core@canary @docusaurus/preset-classic@canary\n"})})}),(0,a.jsx)(o.A,{value:"yarn",label:"Yarn",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-bash",children:"yarn add --exact @docusaurus/core@canary @docusaurus/preset-classic@canary\n"})})}),(0,a.jsx)(o.A,{value:"pnpm",label:"pnpm",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-bash",children:"pnpm add --save-exact @docusaurus/core@canary @docusaurus/preset-classic@canary\n"})})}),(0,a.jsx)(o.A,{value:"bun",label:"Bun",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-bash",children:"bun add --exact @docusaurus/core@canary @docusaurus/preset-classic@canary\n"})})})]}),(0,a.jsxs)(n.admonition,{type:"warning",children:[(0,a.jsxs)(n.p,{children:["Make sure to include all the ",(0,a.jsx)(n.code,{children:"@docusaurus/*"})," packages."]}),(0,a.jsxs)(n.p,{children:["For canary releases, prefer using an exact version instead of a semver range (avoid the ",(0,a.jsx)(n.code,{children:"^"})," prefix)."]})]})]})]})}function p(e={}){let{wrapper:n}={...(0,s.R)(),...e.components};return n?(0,a.jsx)(n,{...e,children:(0,a.jsx)(m,{...e})}):m(e)}},14992:function(e,n,t){t.d(n,{A:()=>s});var r=t(74848);t(96540);var a=t(11118);function s({className:e,...n}){return(0,r.jsx)("button",{type:"button",...n,className:(0,a.A)("clean-btn",e)})}},46221:function(e,n,t){t.d(n,{A:()=>h});var r=t(74848),a=t(96540),s=t(11118),c=t(33977),o=t(47466),l=t(14992),i=t(11912),u=t(32732),d=t(15028);function h({className:e}){let{copyCode:n,isCopied:t}=function(){let{metadata:{code:e}}=(0,o.Ph)(),[n,t]=(0,a.useState)(!1),r=(0,a.useRef)(void 0),s=(0,a.useCallback)(()=>{navigator.clipboard.writeText(e).then(()=>{t(!0),r.current=window.setTimeout(()=>{t(!1)},1e3)})},[e]);return(0,a.useEffect)(()=>()=>window.clearTimeout(r.current),[]),{copyCode:s,isCopied:n}}();return(0,r.jsx)(l.A,{"aria-label":t?(0,c.T)({id:"theme.CodeBlock.copied",message:"Copied",description:"The copied button label on code blocks"}):(0,c.T)({id:"theme.CodeBlock.copyButtonAriaLabel",message:"Copy code to clipboard",description:"The ARIA label for copy code blocks button"}),title:(0,c.T)({id:"theme.CodeBlock.copy",message:"Copy",description:"The copy button label on code blocks"}),className:(0,s.A)(e,d.A.copyButton,t&&d.A.copyButtonCopied),onClick:n,children:(0,r.jsxs)("span",{className:d.A.copyButtonIcons,"aria-hidden":"true",children:[(0,r.jsx)(i.A,{className:d.A.copyButtonIcon}),(0,r.jsx)(u.A,{className:d.A.copyButtonSuccessIcon})]})})}},90644:function(e,n,t){t.d(n,{A:()=>u});var r=t(74848);t(96540);var a=t(11118),s=t(33977),c=t(47466),o=t(14992),l=t(22993),i=t(143);function u({className:e}){let{wordWrap:n}=(0,c.Ph)();if(!(n.isEnabled||n.isCodeScrollable))return!1;let t=(0,s.T)({id:"theme.CodeBlock.wordWrapToggle",message:"Toggle word wrap",description:"The title attribute for toggle word wrapping button of code block lines"});return(0,r.jsx)(o.A,{onClick:()=>n.toggle(),className:(0,a.A)(e,n.isEnabled&&i.A.wordWrapButtonEnabled),"aria-label":t,title:t,children:(0,r.jsx)(l.A,{className:i.A.wordWrapButtonIcon,"aria-hidden":"true"})})}},22207:function(e,n,t){t.d(n,{A:()=>i});var r=t(74848);t(96540);var a=t(11118),s=t(74253),c=t(46221),o=t(90644),l=t(75864);function i({className:e}){return(0,r.jsx)(s.A,{children:()=>(0,r.jsxs)("div",{className:(0,a.A)(e,l.A.buttonGroup),children:[(0,r.jsx)(o.A,{}),(0,r.jsx)(c.A,{})]})})}},78209:function(e,n,t){t.d(n,{A:()=>i});var r=t(74848);t(96540);var a=t(11118),s=t(2933),c=t(85208),o=t(47466),l=t(37322);function i({as:e,...n}){let t=(0,s.A)(),i=(0,o.M$)(t);return(0,r.jsx)(e,{...n,style:i,className:(0,a.A)(n.className,l.A.codeBlockContainer,c.G.common.codeBlock)})}},52779:function(e,n,t){t.d(n,{A:()=>o});var r=t(74848);t(96540);var a=t(11118),s=t(78209),c=t(81772);function o({children:e,className:n}){return(0,r.jsx)(s.A,{as:"pre",tabIndex:0,className:(0,a.A)(c.A.codeBlockStandalone,"thin-scrollbar",n),children:(0,r.jsx)("code",{className:c.A.codeBlockLines,children:e})})}},15318:function(e,n,t){t.d(n,{A:()=>l});var r=t(74848);t(96540);var a=t(60191),s=t(47466),c=t(38542),o=t(57940);function l(e){let n=function(e){let{prism:n}=(0,a.p)();return(0,s.mU)({code:e.children,className:e.className,metastring:e.metastring,magicComments:n.magicComments,defaultLanguage:n.defaultLanguage,language:e.language,title:e.title,showLineNumbers:e.showLineNumbers})}(e),t=(0,c.f)();return(0,r.jsx)(s.l8,{metadata:n,wordWrap:t,children:(0,r.jsx)(o.A,{})})}},31415:function(e,n,t){t.d(n,{A:()=>m});var r=t(74848),a=t(96540),s=t(11118),c=t(47466),o=t(2933),l=t(57767),i=t(4520),u=t(81772);let d=a.forwardRef((e,n)=>(0,r.jsx)("pre",{ref:n,tabIndex:0,...e,className:(0,s.A)(e.className,u.A.codeBlock,"thin-scrollbar")}));function h(e){let{metadata:n}=(0,c.Ph)();return(0,r.jsx)("code",{...e,className:(0,s.A)(e.className,u.A.codeBlockLines,void 0!==n.lineNumbersStart&&u.A.codeBlockLinesWithNumbering),style:{...e.style,counterReset:void 0===n.lineNumbersStart?void 0:`line-count ${n.lineNumbersStart-1}`}})}function m({className:e}){let{metadata:n,wordWrap:t}=(0,c.Ph)(),a=(0,o.A)(),{code:u,language:m,lineNumbersStart:p,lineClassNames:f}=n;return(0,r.jsx)(l.f4,{theme:a,code:u,language:m,children:({className:n,style:a,tokens:c,getLineProps:o,getTokenProps:l})=>(0,r.jsx)(d,{ref:t.codeBlockRef,className:(0,s.A)(e,n),style:a,children:(0,r.jsx)(h,{children:c.map((e,n)=>(0,r.jsx)(i.A,{line:e,getLineProps:o,getTokenProps:l,classNames:f[n],showLineNumbers:void 0!==p},n))})})})}},57940:function(e,n,t){t.d(n,{A:()=>d});var r=t(74848);t(96540);var a=t(11118),s=t(47466),c=t(78209),o=t(11684),l=t(31415),i=t(22207),u=t(73215);function d({className:e}){let{metadata:n}=(0,s.Ph)();return(0,r.jsxs)(c.A,{as:"div",className:(0,a.A)(e,n.className),children:[n.title&&(0,r.jsx)("div",{className:u.A.codeBlockTitle,children:(0,r.jsx)(o.A,{children:n.title})}),(0,r.jsxs)("div",{className:u.A.codeBlockContent,children:[(0,r.jsx)(l.A,{}),(0,r.jsx)(i.A,{})]})]})}},80510:function(e,n,t){t.d(n,{A:()=>a});var r=t(74848);function a({line:e,token:n,...t}){return(0,r.jsx)("span",{...t})}t(96540)},4520:function(e,n,t){t.d(n,{A:()=>l});var r=t(74848);t(96540);var a=t(11118),s=t(80510),c=t(631);function o(){return(0,r.jsx)("br",{})}function l({line:e,classNames:n,showLineNumbers:t,getLineProps:l,getTokenProps:i}){let u,d=(u=1===e.length&&"\n"===e[0].content?e[0]:void 0)?[{...u,content:""}]:e,h=l({line:d,className:(0,a.A)(n,t&&c.A.codeLine)}),m=d.map((e,n)=>{let t=i({token:e});return(0,r.jsx)(s.A,{...t,line:d,token:e,children:t.children},n)});return(0,r.jsxs)("div",{...h,children:[t?(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)("span",{className:c.A.codeLineNumber}),(0,r.jsx)("span",{className:c.A.codeLineContent,children:m})]}):m,(0,r.jsx)(o,{})]})}},11684:function(e,n,t){t.d(n,{A:()=>r});function r({children:e}){return e}},26473:function(e,n,t){t.d(n,{A:()=>l});var r=t(74848),a=t(96540),s=t(30926),c=t(52779),o=t(15318);function l({children:e,...n}){let t=(0,s.A)(),l=a.Children.toArray(e).some(e=>(0,a.isValidElement)(e))?e:Array.isArray(e)?e.join(""):e,i="string"==typeof l?o.A:c.A;return(0,r.jsx)(i,{...n,children:l},String(t))}},11912:function(e,n,t){t.d(n,{A:()=>a});var r=t(74848);function a(e){return(0,r.jsx)("svg",{viewBox:"0 0 24 24",...e,children:(0,r.jsx)("path",{fill:"currentColor",d:"M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"})})}t(96540)},32732:function(e,n,t){t.d(n,{A:()=>a});var r=t(74848);function a(e){return(0,r.jsx)("svg",{viewBox:"0 0 24 24",...e,children:(0,r.jsx)("path",{fill:"currentColor",d:"M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"})})}t(96540)},22993:function(e,n,t){t.d(n,{A:()=>a});var r=t(74848);function a(e){return(0,r.jsx)("svg",{viewBox:"0 0 24 24",...e,children:(0,r.jsx)("path",{fill:"currentColor",d:"M4 19h6v-2H4v2zM20 5H4v2h16V5zm-3 6H4v2h13.25c1.1 0 2 .9 2 2s-.9 2-2 2H15v-2l-3 3l3 3v-2h2c2.21 0 4-1.79 4-4s-1.79-4-4-4z"})})}t(96540)},13899:function(e,n,t){t.d(n,{A:()=>c});var r=t(74848);t(96540);var a=t(11118),s=t(41452);function c({children:e,hidden:n,className:t}){return(0,r.jsx)("div",{role:"tabpanel",className:(0,a.A)(s.A.tabItem,t),hidden:n,children:e})}},14729:function(e,n,t){t.d(n,{A:()=>p});var r=t(74848),a=t(96540),s=t(11118),c=t(85208),o=t(31191),l=t(17060),i=t(30926),u=t(18416);function d({className:e,block:n,selectedValue:t,selectValue:a,tabValues:c}){let l=[],{blockElementScrollPositionUntilNextRender:i}=(0,o.a_)(),d=e=>{let n=e.currentTarget,r=c[l.indexOf(n)].value;r!==t&&(i(n),a(r))},h=e=>{let n=null;switch(e.key){case"Enter":d(e);break;case"ArrowRight":{let t=l.indexOf(e.currentTarget)+1;n=l[t]??l[0];break}case"ArrowLeft":{let t=l.indexOf(e.currentTarget)-1;n=l[t]??l[l.length-1]}}n?.focus()};return(0,r.jsx)("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,s.A)("tabs",{"tabs--block":n},e),children:c.map(({value:e,label:n,attributes:a})=>(0,r.jsx)("li",{role:"tab",tabIndex:t===e?0:-1,"aria-selected":t===e,ref:e=>{l.push(e)},onKeyDown:h,onClick:d,...a,className:(0,s.A)("tabs__item",u.A.tabItem,a?.className,{"tabs__item--active":t===e}),children:n??e},e))})}function h({lazy:e,children:n,selectedValue:t}){let c=(Array.isArray(n)?n:[n]).filter(Boolean);if(e){let e=c.find(e=>e.props.value===t);return e?(0,a.cloneElement)(e,{className:(0,s.A)("margin-top--md",e.props.className)}):null}return(0,r.jsx)("div",{className:"margin-top--md",children:c.map((e,n)=>(0,a.cloneElement)(e,{key:n,hidden:e.props.value!==t}))})}function m(e){let n=(0,l.u)(e);return(0,r.jsxs)("div",{className:(0,s.A)(c.G.tabs.container,"tabs-container",u.A.tabList),children:[(0,r.jsx)(d,{...n,...e}),(0,r.jsx)(h,{...n,...e})]})}function p(e){let n=(0,i.A)();return(0,r.jsx)(m,{...e,children:(0,l.v)(e.children)},String(n))}},38542:function(e,n,t){t.d(n,{f:()=>s});var r=t(96540),a=t(93802);function s(){let[e,n]=(0,r.useState)(!1),[t,s]=(0,r.useState)(!1),c=(0,r.useRef)(null),o=(0,r.useCallback)(()=>{let t=c.current.querySelector("code");e?t.removeAttribute("style"):(t.style.whiteSpace="pre-wrap",t.style.overflowWrap="anywhere"),n(e=>!e)},[c,e]),l=(0,r.useCallback)(()=>{let{scrollWidth:e,clientWidth:n}=c.current;s(e>n||c.current.querySelector("code").hasAttribute("style"))},[c]);return!function(e,n){let[t,s]=(0,r.useState)(),c=(0,r.useCallback)(()=>{s(e.current?.closest("[role=tabpanel][hidden]"))},[e,s]);(0,r.useEffect)(()=>{c()},[c]),(0,a.P)(t,e=>{e.forEach(e=>{"attributes"===e.type&&"hidden"===e.attributeName&&(n(),c())})},{attributes:!0,characterData:!1,childList:!1,subtree:!1})}(c,l),(0,r.useEffect)(()=>{l()},[e,l]),(0,r.useEffect)(()=>(window.addEventListener("resize",l,{passive:!0}),()=>{window.removeEventListener("resize",l)}),[l]),{codeBlockRef:c,isEnabled:e,isCodeScrollable:t,toggle:o}}},93802:function(e,n,t){t.d(n,{P:()=>c});var r=t(96540),a=t(28413);let s={attributes:!0,characterData:!0,childList:!0,subtree:!0};function c(e,n,t=s){let o=(0,a._q)(n),l=(0,a.Be)(t);(0,r.useEffect)(()=>{let n=new MutationObserver(o);return e&&n.observe(e,l),()=>n.disconnect()},[e,o,l])}},2933:function(e,n,t){t.d(n,{A:()=>s});var r=t(51696),a=t(60191);function s(){let{prism:e}=(0,a.p)(),{colorMode:n}=(0,r.G)(),t=e.theme,s=e.darkTheme||t;return"dark"===n?s:t}},47466:function(e,n,t){t.d(n,{M$:()=>x,Ph:()=>g,l8:()=>b,mU:()=>f});var r=t(74848),a=t(96540),s=t(11118),c=t(19934),o=t.n(c),l=t(28413);let i=/title=(?<quote>["'])(?<title>.*?)\1/,u=/\{(?<range>[\d,-]+)\}/,d={js:{start:"\\/\\/",end:""},jsBlock:{start:"\\/\\*",end:"\\*\\/"},jsx:{start:"\\{\\s*\\/\\*",end:"\\*\\/\\s*\\}"},bash:{start:"#",end:""},html:{start:"\x3c!--",end:"--\x3e"}},h={...d,lua:{start:"--",end:""},wasm:{start:"\\;\\;",end:""},tex:{start:"%",end:""},vb:{start:"['\u2018\u2019]",end:""},vbnet:{start:"(?:_\\s*)?['\u2018\u2019]",end:""},rem:{start:"[Rr][Ee][Mm]\\b",end:""},f90:{start:"!",end:""},ml:{start:"\\(\\*",end:"\\*\\)"},cobol:{start:"\\*>",end:""}},m=Object.keys(d);function p(e,n){let t=e.map(e=>{let{start:t,end:r}=h[e];return`(?:${t}\\s*(${n.flatMap(e=>[e.line,e.block?.start,e.block?.end].filter(Boolean)).join("|")})\\s*${r})`}).join("|");return RegExp(`^\\s*(?:${t})\\s*$`)}function f(e){var n,t,r,a,c;let l,d=(t=(n={language:e.language,defaultLanguage:e.defaultLanguage,className:e.className}).language??function(e){if(!e)return;let n=e.split(" ").find(e=>e.startsWith("language-"));return n?.replace(/language-/,"")}(n.className)??n.defaultLanguage,t?.toLowerCase()??"text"),{lineClassNames:h,code:f}=(r=e.code,a={metastring:e.metastring,magicComments:e.magicComments,language:d},function(e,{metastring:n,magicComments:t}){if(n&&u.test(n)){let r=n.match(u).groups.range;if(0===t.length)throw Error(`A highlight range has been given in code block's metastring (\`\`\` ${n}), but no magic comment config is available. Docusaurus applies the first magic comment entry's className for metastring ranges.`);let a=t[0].className;return{lineClassNames:Object.fromEntries(o()(r).filter(e=>e>0).map(e=>[e-1,[a]])),code:e}}return null}(l=r.replace(/\r?\n$/,""),{...a})??function(e,n){let{language:t,magicComments:r}=n;if(void 0===t)return{lineClassNames:{},code:e};let a=function(e,n){switch(e){case"js":case"javascript":case"ts":case"typescript":return p(["js","jsBlock"],n);case"jsx":case"tsx":return p(["js","jsBlock","jsx"],n);case"html":return p(["js","jsBlock","html"],n);case"python":case"py":case"bash":return p(["bash"],n);case"markdown":case"md":return p(["html","jsx","bash"],n);case"tex":case"latex":case"matlab":return p(["tex"],n);case"lua":case"haskell":return p(["lua"],n);case"sql":return p(["lua","jsBlock"],n);case"wasm":return p(["wasm"],n);case"vb":case"vba":case"visual-basic":return p(["vb","rem"],n);case"vbnet":return p(["vbnet","rem"],n);case"batch":return p(["rem"],n);case"basic":return p(["rem","f90"],n);case"fsharp":return p(["js","ml"],n);case"ocaml":case"sml":return p(["ml"],n);case"fortran":return p(["f90"],n);case"cobol":return p(["cobol"],n);default:return p(m,n)}}(t,r),s=e.split(/\r?\n/),c=Object.fromEntries(r.map(e=>[e.className,{start:0,range:""}])),l=Object.fromEntries(r.filter(e=>e.line).map(({className:e,line:n})=>[n,e])),i=Object.fromEntries(r.filter(e=>e.block).map(({className:e,block:n})=>[n.start,e])),u=Object.fromEntries(r.filter(e=>e.block).map(({className:e,block:n})=>[n.end,e]));for(let e=0;e<s.length;){let n=s[e].match(a);if(!n){e+=1;continue}let t=n.slice(1).find(e=>void 0!==e);l[t]?c[l[t]].range+=`${e},`:i[t]?c[i[t]].start=e:u[t]&&(c[u[t]].range+=`${c[u[t]].start}-${e-1},`),s.splice(e,1)}let d={};return Object.entries(c).forEach(([e,{range:n}])=>{o()(n).forEach(n=>{d[n]??=[],d[n].push(e)})}),{code:s.join("\n"),lineClassNames:d}}(l,{...a})),x=function({className:e,language:n}){return(0,s.A)(e,n&&!e?.includes(`language-${n}`)&&`language-${n}`)}({className:e.className,language:d}),j=(c=e.metastring,(c?.match(i)?.groups.title??"")||e.title),b=function({showLineNumbers:e,metastring:n}){if("boolean"==typeof e)return e?1:void 0;if("number"==typeof e)return e;let t=n?.split(" ").find(e=>e.startsWith("showLineNumbers"));if(t)return t.startsWith("showLineNumbers=")?parseInt(t.replace("showLineNumbers=",""),10):1}({showLineNumbers:e.showLineNumbers,metastring:e.metastring});return{codeInput:e.code,code:f,className:x,language:d,title:j,lineNumbersStart:b,lineClassNames:h}}function x(e){let n={color:"--prism-color",backgroundColor:"--prism-background-color"},t={};return Object.entries(e.plain).forEach(([e,r])=>{let a=n[e];a&&"string"==typeof r&&(t[a]=r)}),t}let j=(0,a.createContext)(null);function b({metadata:e,wordWrap:n,children:t}){let s=(0,a.useMemo)(()=>({metadata:e,wordWrap:n}),[e,n]);return(0,r.jsx)(j.Provider,{value:s,children:t})}function g(){let e=(0,a.useContext)(j);if(null===e)throw new l.dV("CodeBlockContextProvider");return e}},17060:function(e,n,t){t.d(n,{u:()=>d,v:()=>i});var r=t(96540),a=t(49519),s=t(57190),c=t(11864),o=t(84329),l=t(34123);function i(e){return r.Children.toArray(e).filter(e=>"\n"!==e).map(e=>{if(!e||(0,r.isValidElement)(e)&&function(e){let{props:n}=e;return!!n&&"object"==typeof n&&"value"in n}(e))return e;throw Error(`Docusaurus error: Bad <Tabs> child <${"string"==typeof e.type?e.type:e.type.name}>: all children of the <Tabs> component should be <TabItem>, and every <TabItem> should have a unique "value" prop.`)})?.filter(Boolean)??[]}function u({value:e,tabValues:n}){return n.some(n=>n.value===e)}function d(e){let n,{defaultValue:t,queryString:d=!1,groupId:h}=e,m=function(e){let{values:n,children:t}=e;return(0,r.useMemo)(()=>{let e=n??i(t).map(({props:{value:e,label:n,attributes:t,default:r}})=>({value:e,label:n,attributes:t,default:r})),r=(0,o.XI)(e,(e,n)=>e.value===n.value);if(r.length>0)throw Error(`Docusaurus error: Duplicate values "${r.map(e=>e.value).join(", ")}" found in <Tabs>. Every value needs to be unique.`);return e},[n,t])}(e),[p,f]=(0,r.useState)(()=>(function({defaultValue:e,tabValues:n}){if(0===n.length)throw Error("Docusaurus error: the <Tabs> component requires at least one <TabItem> children component");if(e){if(!u({value:e,tabValues:n}))throw Error(`Docusaurus error: The <Tabs> has a defaultValue "${e}" but none of its children has the corresponding value. Available values are: ${n.map(e=>e.value).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return e}let t=n.find(e=>e.default)??n[0];if(!t)throw Error("Unexpected error: 0 tabValues");return t.value})({defaultValue:t,tabValues:m})),[x,j]=function({queryString:e=!1,groupId:n}){let t=(0,a.W6)(),s=function({queryString:e=!1,groupId:n}){if("string"==typeof e)return e;if(!1===e)return null;if(!0===e&&!n)throw Error('Docusaurus error: The <Tabs> component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return n??null}({queryString:e,groupId:n});return[(0,c.aZ)(s),(0,r.useCallback)(e=>{if(!s)return;let n=new URLSearchParams(t.location.search);n.set(s,e),t.replace({...t.location,search:n.toString()})},[s,t])]}({queryString:d,groupId:h}),[b,g]=function({groupId:e}){let n=e?`docusaurus.tab.${e}`:null,[t,a]=(0,l.Dv)(n);return[t,(0,r.useCallback)(e=>{n&&a.set(e)},[n,a])]}({groupId:h}),v=u({value:n=x??b,tabValues:m})?n:null;return(0,s.A)(()=>{v&&f(v)},[v]),{selectedValue:p,selectValue:(0,r.useCallback)(e=>{if(!u({value:e,tabValues:m}))throw Error(`Can't select invalid tab value=${e}`);f(e),j(e),g(e)},[j,g,m]),tabValues:m}}},78020:function(e,n,t){t.d(n,{A:()=>c});var r=t(74848);t(96540);var a=t(26473),s=t(18738);function c(e){return e.live?(0,r.jsx)(s.A,{...e}):(0,r.jsx)(a.A,{...e})}},18738:function(e,n,t){t.d(n,{A:()=>c});var r=t(74848);t(96540);var a=t(8607),s=t(92883);function c(e){return(0,r.jsx)(a.A,{scope:s.A,...e})}},151:function(e,n,t){t.d(n,{A:()=>s});var r=t(74848);t(96540);var a=t(85120);function s({children:e}){return(0,r.jsx)("div",{className:a.A.playgroundContainer,children:e})}},50045:function(e,n,t){t.d(n,{A:()=>i});var r=t(74848);t(96540);var a=t(370),s=t(30926),c=t(33977),o=t(98673),l=t(19304);function i(){let e=(0,s.A)();return(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(o.A,{children:(0,r.jsx)(c.A,{id:"theme.Playground.liveEditor",description:"The live editor label of the live codeblocks",children:"Live Editor"})}),(0,r.jsx)(a.w,{className:l.A.playgroundEditor},String(e))]})}},98673:function(e,n,t){t.d(n,{A:()=>c});var r=t(74848);t(96540);var a=t(11118),s=t(79820);function c({children:e}){return(0,r.jsx)("div",{className:(0,a.A)(s.A.playgroundHeader),children:e})}},89142:function(e,n,t){t.d(n,{A:()=>o});var r=t(74848);t(96540);var a=t(60191),s=t(89344),c=t(50045);function o(){let{playgroundPosition:e}=(0,a.p)().liveCodeBlock;return(0,r.jsx)(r.Fragment,{children:"top"===e?(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(s.A,{}),(0,r.jsx)(c.A,{})]}):(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(c.A,{}),(0,r.jsx)(s.A,{})]})})}},89344:function(e,n,t){t.d(n,{A:()=>m});var r=t(74848);t(96540);var a=t(370),s=t(74253),c=t(65840),o=t(78339),l=t(33977),i=t(98673),u=t(60477);function d(){return(0,r.jsx)("div",{children:"Loading..."})}function h(){return(0,r.jsx)(s.A,{fallback:(0,r.jsx)(d,{}),children:()=>(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(o.A,{fallback:e=>(0,r.jsx)(c.MN,{...e}),children:(0,r.jsx)(a.pA,{})}),(0,r.jsx)(a.p1,{})]})})}function m(){return(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(i.A,{children:(0,r.jsx)(l.A,{id:"theme.Playground.result",description:"The result label of the live codeblocks",children:"Result"})}),(0,r.jsx)("div",{className:u.A.playgroundPreview,children:(0,r.jsx)(h,{})})]})}},65593:function(e,n,t){t.d(n,{A:()=>o});var r=t(74848);t(96540);var a=t(370),s=t(2933);let c=e=>`${e};`;function o({code:e,children:n,...t}){let o=(0,s.A)(),l=t.metastring?.includes("noInline")??!1;return(0,r.jsx)(a.Q,{noInline:l,theme:o,...t,code:e?.replace(/\n$/,""),transformCode:t.transformCode??c,children:n})}},8607:function(e,n,t){t.d(n,{A:()=>o});var r=t(74848);t(96540);var a=t(65593),s=t(151),c=t(89142);function o({children:e,transformCode:n,...t}){return(0,r.jsx)(s.A,{children:(0,r.jsx)(a.A,{code:e,...t,children:(0,r.jsx)(c.A,{})})})}},74253:function(e,n,t){t.d(n,{A:()=>s});var r=t(74848);t(96540);var a=t(30926);function s({children:e,fallback:n}){return(0,a.A)()?(0,r.jsx)(r.Fragment,{children:e?.()}):n??null}},42743:function(e,n,t){t.d(n,{Af:()=>b,Cj:()=>A,Cu:()=>u,X0:()=>p,ex:()=>f,jL:()=>g,p1:()=>j,tu:()=>h,uA:()=>v,xs:()=>y});var r=t(74848),a=t(96540),s=t(2691),c=t(86151),o=t(33977),l=t(55831),i=t(70590);let u=parseInt(t(48301)["0"].split(".")[0],10),d=a.createContext(null);function h({children:e}){let[n,t]=(0,a.useState)(null),s=(0,a.useRef)(!0);return(0,a.useEffect)(()=>(s.current=!0,()=>{s.current=!1}),[]),(0,a.useEffect)(()=>{fetch("https://registry.npmjs.org/@docusaurus/core").then(e=>e.json()).then(e=>{if(!s.current)return;let n=Object.keys(e.versions).at(-1),r=e.time[n];t({name:n,time:r})})},[]),(0,r.jsx)(d.Provider,{value:n,children:e})}function m(){let e=(0,s.g1)("default").preferredVersion?.name,n=(0,c.jh)("default"),t=(n.find(e=>"current"!==e.name)??n[0]).name;return e&&"current"!==e?e:t}function p(){let e=(0,a.useContext)(d);return e?(0,r.jsx)("span",{children:(0,r.jsx)(o.A,{description:"The hint text for the current canary version tag.",values:{canaryVersionName:(0,r.jsx)("b",{children:e.name})},children:"Current: {canaryVersionName}"})}):(0,r.jsx)("span",{children:(0,r.jsx)(o.A,{description:"An example canary version tag when the actual version can't be fetched.",children:"Example: 0.0.0-4922"})})}function f(){let e=m();return(0,r.jsx)("span",{children:e})}function x({branch:e}){return(0,r.jsx)(l.A,{to:`https://github.com/facebook/docusaurus/tree/${e}`,children:(0,r.jsx)("code",{children:e})})}function j(){return(0,r.jsx)("code",{children:`docusaurus-v${u}`})}function b(){return(0,r.jsx)(x,{branch:"main"})}function g({children:e}){return(0,a.useContext)(d)?null:e}function v({children:e}){return(0,a.useContext)(d)?e:null}function A(){let e=(0,a.useContext)(d)?.name??"0.0.0-4922",n=m();return(0,r.jsx)(i.A,{language:"diff",children:`-  "@docusaurus/core": "^${n}",
-  "@docusaurus/preset-classic": "^${n}",
+  "@docusaurus/core": "${e}",
+  "@docusaurus/preset-classic": "${e}",
`})}function y(){let e=(0,a.useContext)(d)?.time;return e?(0,r.jsx)(o.A,{values:{time:(0,r.jsx)("b",{children:new Date(e).toLocaleString()})},children:"The latest canary version that's available on npm is published at {time}."}):null}},70590:function(e,n,t){t.d(n,{A:()=>s});var r=t(74848);t(96540);var a=t(78020);function s(e){return(0,r.jsx)(a.A,{...e})}},93721:function(e,n,t){t.r(n),t.d(n,{ButtonExample:()=>a});var r=t(74848);function a(e){return(0,r.jsx)("button",{type:"button",...e,style:{backgroundColor:"white",color:"black",border:"solid red",borderRadius:20,padding:10,cursor:"pointer",...e.style}})}t(96540)},92883:function(e,n,t){t.d(n,{A:()=>s});var r=t(96540),a=t(93721);let s={React:r,...r,...a}},37218:function(e){e.exports=JSON.parse('{"id":"canary","title":"Canary releases","description":"Docusaurus has a canary releases system.","source":"@site/community/4-canary.mdx","sourceDirName":".","slug":"/canary","permalink":"/community/canary","draft":false,"unlisted":false,"editUrl":"https://github.com/facebook/docusaurus/edit/main/website/community/4-canary.mdx","tags":[],"version":"current","lastUpdatedBy":"dependabot[bot]","lastUpdatedAt":1765289882000,"sidebarPosition":4,"frontMatter":{},"sidebar":"community","previous":{"title":"Contributing","permalink":"/community/contributing"},"next":{"title":"Release process","permalink":"/community/release-process"}}')},48301:function(e){e.exports=["3.9.2"]}}]);