diff --git a/404.html b/404.html index 97298de48..114133ae9 100644 --- a/404.html +++ b/404.html @@ -10,10 +10,10 @@ - - + + -
Skip to main content

Page Not Found

We could not find what you were looking for.

Please contact the owner of the site that linked you to the original URL and let them know their link is broken.

+
Skip to main content

Page Not Found

We could not find what you were looking for.

Please contact the owner of the site that linked you to the original URL and let them know their link is broken.

\ No newline at end of file diff --git a/assets/js/48914889.a9588c3e.js b/assets/js/48914889.a9588c3e.js deleted file mode 100644 index 6b329dd41..000000000 --- a/assets/js/48914889.a9588c3e.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdefang_docs=self.webpackChunkdefang_docs||[]).push([[3372],{4104:(e,s,n)=>{n.r(s),n.d(s,{assets:()=>p,contentTitle:()=>h,default:()=>u,frontMatter:()=>d,metadata:()=>l,toc:()=>m});var t=n(7624),i=n(2172),a=n(1478),r=n(1636),o=n(4688),c=n(5560);const d={title:"Samples",description:"Sample projects to help you launch services faster with Defang.",sidebar_position:500},h="Samples",l={id:"samples",title:"Samples",description:"Sample projects to help you launch services faster with Defang.",source:"@site/docs/samples.md",sourceDirName:".",slug:"/samples",permalink:"/docs/samples",draft:!1,unlisted:!1,editUrl:"https://github.com/defang-io/defang-docs/tree/main/docs/samples.md",tags:[],version:"current",sidebarPosition:500,frontMatter:{title:"Samples",description:"Sample projects to help you launch services faster with Defang.",sidebar_position:500},sidebar:"docsSidebar",previous:{title:"Use Cases",permalink:"/docs/use-cases/"},next:{title:"FAQ",permalink:"/docs/faq"}},p={},m=[{value:"Basic Service",id:"basic-service",level:2},{value:"AI-ML Music Recommendations",id:"ai-ml-music-recommendations",level:2},{value:"AWS S3",id:"aws-s3",level:2},{value:"ChatGPT API",id:"chatgpt-api",level:2},{value:"Fetch and return JSON",id:"fetch-and-return-json",level:2},{value:"Webpage and Form Post",id:"webpage-and-form-post",level:2}];function g(e){const s={code:"code",h1:"h1",h2:"h2",p:"p",pre:"pre",...(0,i.M)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(s.h1,{id:"samples",children:"Samples"}),"\n",(0,t.jsx)(s.p,{children:"Check out our sample projects here to get some inspiration and get a sense of how defang works."}),"\n",(0,t.jsx)(s.h2,{id:"basic-service",children:"Basic Service"}),"\n",(0,t.jsxs)(a.c,{sx:{pb:2},children:[(0,t.jsx)(r.c,{children:"Try it in: "}),(0,t.jsxs)(o.c,{variant:"outlined",children:[(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/python/Basic%20Service",children:"Python"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/nodejs/Basic%20Service",children:"Node.js"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/golang/Basic%20Service",children:"Golang"})]})]}),"\n",(0,t.jsx)(s.p,{children:"This sample shows you how to get started with Defang. It demonstrates how to deploy one of the most basic type of services you can run on Defang: a simple web server that returns the contents of the request."}),"\n",(0,t.jsx)(s.h2,{id:"ai-ml-music-recommendations",children:"AI-ML Music Recommendations"}),"\n",(0,t.jsxs)(a.c,{sx:{pb:2},children:[(0,t.jsx)(r.c,{children:"Try it in: "}),(0,t.jsx)(o.c,{variant:"outlined",children:(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/python/AI-ML%20Music",children:"Python"})})]}),"\n",(0,t.jsx)(s.p,{children:"An AI-driven music recommendation system. This example demonstrates how to request GPUs for your Defang services:"}),"\n",(0,t.jsx)(s.pre,{children:(0,t.jsx)(s.code,{className:"language-yaml",children:'services:\n service1:\n deploy:\n resources:\n reservations:\n devices:\n - capabilities: ["gpu"]\n'})}),"\n",(0,t.jsx)(s.h2,{id:"aws-s3",children:"AWS S3"}),"\n",(0,t.jsxs)(a.c,{sx:{pb:2},children:[(0,t.jsx)(r.c,{children:"Try it in: "}),(0,t.jsxs)(o.c,{variant:"outlined",children:[(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/python/AWS%20S3",children:"Python"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/nodejs/AWS%20S3",children:"Node.js"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/golang/AWS%20S3",children:"Golang"})]})]}),"\n",(0,t.jsxs)(s.p,{children:["This sample shows you how to upload and download files from AWS S3 using Defang. It demonstrates how to configure services that require secrets using the ",(0,t.jsx)(s.code,{children:"defang secrets set"})," command."]}),"\n",(0,t.jsx)(s.h2,{id:"chatgpt-api",children:"ChatGPT API"}),"\n",(0,t.jsxs)(a.c,{sx:{pb:2},children:[(0,t.jsx)(r.c,{children:"Try it in: "}),(0,t.jsxs)(o.c,{variant:"outlined",children:[(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/python/ChatGPT%20API",children:"Python"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/nodejs/ChatGPT%20API",children:"Node.js"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/golang/ChatGPT%20API",children:"Golang"})]})]}),"\n",(0,t.jsxs)(s.p,{children:["This sample shows you how to build a simple service using the OpenAI Chat Completions API. It also demonstrates how to configure services that require secrets using the ",(0,t.jsx)(s.code,{children:"defang secrets set"})," command."]}),"\n",(0,t.jsx)(s.h2,{id:"fetch-and-return-json",children:"Fetch and return JSON"}),"\n",(0,t.jsxs)(a.c,{sx:{pb:2},children:[(0,t.jsx)(r.c,{children:"Try it in: "}),(0,t.jsxs)(o.c,{variant:"outlined",children:[(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/python/Fetch%20and%20Return%20JSON",children:"Python"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/nodejs/Fetch%20and%20Return%20JSON",children:"Node.js"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/golang/Fetch%20and%20Return%20JSON",children:"Golang"})]})]}),"\n",(0,t.jsx)(s.p,{children:"This sample shows you how to build a basic service that interacts with and api and returns some JSON."}),"\n",(0,t.jsx)(s.h2,{id:"webpage-and-form-post",children:"Webpage and Form Post"}),"\n",(0,t.jsxs)(a.c,{sx:{pb:2},children:[(0,t.jsx)(r.c,{children:"Try it in: "}),(0,t.jsxs)(o.c,{variant:"outlined",children:[(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/python/Web%20Page%20and%20Form%20Post",children:"Python"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/nodejs/Web%20Page%20and%20Form%20Post",children:"Node.js"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/golang/Web%20Page%20and%20Form%20Post",children:"Golang"})]})]}),"\n",(0,t.jsx)(s.p,{children:"This sample shows you how to build a simple website with a form that posts to a backend service."})]})}function u(e={}){const{wrapper:s}={...(0,i.M)(),...e.components};return s?(0,t.jsx)(s,{...e,children:(0,t.jsx)(g,{...e})}):g(e)}}}]); \ No newline at end of file diff --git a/assets/js/48914889.e09fe661.js b/assets/js/48914889.e09fe661.js new file mode 100644 index 000000000..28882d18b --- /dev/null +++ b/assets/js/48914889.e09fe661.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdefang_docs=self.webpackChunkdefang_docs||[]).push([[3372],{4104:(e,s,n)=>{n.r(s),n.d(s,{assets:()=>p,contentTitle:()=>h,default:()=>u,frontMatter:()=>d,metadata:()=>l,toc:()=>m});var t=n(7624),i=n(2172),a=n(1478),r=n(1636),o=n(4688),c=n(5560);const d={title:"Samples",description:"Sample projects to help you launch services faster with Defang.",sidebar_position:500},h="Samples",l={id:"samples",title:"Samples",description:"Sample projects to help you launch services faster with Defang.",source:"@site/docs/samples.md",sourceDirName:".",slug:"/samples",permalink:"/docs/samples",draft:!1,unlisted:!1,editUrl:"https://github.com/defang-io/defang-docs/tree/main/docs/samples.md",tags:[],version:"current",sidebarPosition:500,frontMatter:{title:"Samples",description:"Sample projects to help you launch services faster with Defang.",sidebar_position:500},sidebar:"docsSidebar",previous:{title:"Build and deploy using Pulumi",permalink:"/docs/tutorials/deploy-using-pulumi"},next:{title:"FAQ",permalink:"/docs/faq"}},p={},m=[{value:"Basic Service",id:"basic-service",level:2},{value:"AI-ML Music Recommendations",id:"ai-ml-music-recommendations",level:2},{value:"AWS S3",id:"aws-s3",level:2},{value:"ChatGPT API",id:"chatgpt-api",level:2},{value:"Fetch and return JSON",id:"fetch-and-return-json",level:2},{value:"Webpage and Form Post",id:"webpage-and-form-post",level:2}];function g(e){const s={code:"code",h1:"h1",h2:"h2",p:"p",pre:"pre",...(0,i.M)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(s.h1,{id:"samples",children:"Samples"}),"\n",(0,t.jsx)(s.p,{children:"Check out our sample projects here to get some inspiration and get a sense of how defang works."}),"\n",(0,t.jsx)(s.h2,{id:"basic-service",children:"Basic Service"}),"\n",(0,t.jsxs)(a.c,{sx:{pb:2},children:[(0,t.jsx)(r.c,{children:"Try it in: "}),(0,t.jsxs)(o.c,{variant:"outlined",children:[(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/python/Basic%20Service",children:"Python"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/nodejs/Basic%20Service",children:"Node.js"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/golang/Basic%20Service",children:"Golang"})]})]}),"\n",(0,t.jsx)(s.p,{children:"This sample shows you how to get started with Defang. It demonstrates how to deploy one of the most basic type of services you can run on Defang: a simple web server that returns the contents of the request."}),"\n",(0,t.jsx)(s.h2,{id:"ai-ml-music-recommendations",children:"AI-ML Music Recommendations"}),"\n",(0,t.jsxs)(a.c,{sx:{pb:2},children:[(0,t.jsx)(r.c,{children:"Try it in: "}),(0,t.jsx)(o.c,{variant:"outlined",children:(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/python/AI-ML%20Music",children:"Python"})})]}),"\n",(0,t.jsx)(s.p,{children:"An AI-driven music recommendation system. This example demonstrates how to request GPUs for your Defang services:"}),"\n",(0,t.jsx)(s.pre,{children:(0,t.jsx)(s.code,{className:"language-yaml",children:'services:\n service1:\n deploy:\n resources:\n reservations:\n devices:\n - capabilities: ["gpu"]\n'})}),"\n",(0,t.jsx)(s.h2,{id:"aws-s3",children:"AWS S3"}),"\n",(0,t.jsxs)(a.c,{sx:{pb:2},children:[(0,t.jsx)(r.c,{children:"Try it in: "}),(0,t.jsxs)(o.c,{variant:"outlined",children:[(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/python/AWS%20S3",children:"Python"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/nodejs/AWS%20S3",children:"Node.js"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/golang/AWS%20S3",children:"Golang"})]})]}),"\n",(0,t.jsxs)(s.p,{children:["This sample shows you how to upload and download files from AWS S3 using Defang. It demonstrates how to configure services that require secrets using the ",(0,t.jsx)(s.code,{children:"defang secrets set"})," command."]}),"\n",(0,t.jsx)(s.h2,{id:"chatgpt-api",children:"ChatGPT API"}),"\n",(0,t.jsxs)(a.c,{sx:{pb:2},children:[(0,t.jsx)(r.c,{children:"Try it in: "}),(0,t.jsxs)(o.c,{variant:"outlined",children:[(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/python/ChatGPT%20API",children:"Python"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/nodejs/ChatGPT%20API",children:"Node.js"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/golang/ChatGPT%20API",children:"Golang"})]})]}),"\n",(0,t.jsxs)(s.p,{children:["This sample shows you how to build a simple service using the OpenAI Chat Completions API. It also demonstrates how to configure services that require secrets using the ",(0,t.jsx)(s.code,{children:"defang secrets set"})," command."]}),"\n",(0,t.jsx)(s.h2,{id:"fetch-and-return-json",children:"Fetch and return JSON"}),"\n",(0,t.jsxs)(a.c,{sx:{pb:2},children:[(0,t.jsx)(r.c,{children:"Try it in: "}),(0,t.jsxs)(o.c,{variant:"outlined",children:[(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/python/Fetch%20and%20Return%20JSON",children:"Python"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/nodejs/Fetch%20and%20Return%20JSON",children:"Node.js"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/golang/Fetch%20and%20Return%20JSON",children:"Golang"})]})]}),"\n",(0,t.jsx)(s.p,{children:"This sample shows you how to build a basic service that interacts with and api and returns some JSON."}),"\n",(0,t.jsx)(s.h2,{id:"webpage-and-form-post",children:"Webpage and Form Post"}),"\n",(0,t.jsxs)(a.c,{sx:{pb:2},children:[(0,t.jsx)(r.c,{children:"Try it in: "}),(0,t.jsxs)(o.c,{variant:"outlined",children:[(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/python/Web%20Page%20and%20Form%20Post",children:"Python"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/nodejs/Web%20Page%20and%20Form%20Post",children:"Node.js"}),(0,t.jsx)(c.c,{href:"https://github.com/defang-io/defang/tree/main/samples/golang/Web%20Page%20and%20Form%20Post",children:"Golang"})]})]}),"\n",(0,t.jsx)(s.p,{children:"This sample shows you how to build a simple website with a form that posts to a backend service."})]})}function u(e={}){const{wrapper:s}={...(0,i.M)(),...e.components};return s?(0,t.jsx)(s,{...e,children:(0,t.jsx)(g,{...e})}):g(e)}}}]); \ No newline at end of file diff --git a/assets/js/706c2971.3bf9a422.js b/assets/js/706c2971.3bf9a422.js deleted file mode 100644 index 11cd709a0..000000000 --- a/assets/js/706c2971.3bf9a422.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdefang_docs=self.webpackChunkdefang_docs||[]).push([[7616],{1676:(e,s,a)=>{a.r(s),a.d(s,{assets:()=>c,contentTitle:()=>i,default:()=>u,frontMatter:()=>o,metadata:()=>r,toc:()=>l});var t=a(7624),n=a(2172);const o={sidebar_position:100,title:"Use Cases",description:"Use cases for Defang."},i="Use Cases",r={id:"use-cases/use-cases",title:"Use Cases",description:"Use cases for Defang.",source:"@site/docs/use-cases/use-cases.md",sourceDirName:"use-cases",slug:"/use-cases/",permalink:"/docs/use-cases/",draft:!1,unlisted:!1,editUrl:"https://github.com/defang-io/defang-docs/tree/main/docs/use-cases/use-cases.md",tags:[],version:"current",sidebarPosition:100,frontMatter:{sidebar_position:100,title:"Use Cases",description:"Use cases for Defang."},sidebar:"docsSidebar",previous:{title:"Build and deploy using Pulumi",permalink:"/docs/tutorials/deploy-using-pulumi"},next:{title:"Samples",permalink:"/docs/samples"}},c={},l=[{value:"Web Services and APIs",id:"web-services-and-apis",level:2},{value:"Mobile App Backends",id:"mobile-app-backends",level:2},{value:"Hosting LLMs",id:"hosting-llms",level:2},{value:"Stateful Services",id:"stateful-services",level:2},{value:"Data Stores",id:"data-stores",level:2}];function d(e){const s={a:"a",h1:"h1",h2:"h2",p:"p",...(0,n.M)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(s.h1,{id:"use-cases",children:"Use Cases"}),"\n",(0,t.jsxs)(s.p,{children:["Defang can be used for a wide variety of use cases, generally in line with the ",(0,t.jsx)(s.a,{href:"https://12factor.net/",children:"12 Factor architecture"}),". In this section we'll document some examples. At the end of this section we will also cover use cases that are not supported by Defang."]}),"\n",(0,t.jsx)(s.h2,{id:"web-services-and-apis",children:"Web Services and APIs"}),"\n",(0,t.jsx)(s.p,{children:"Defang can be used to deploy web services and APIs. You can use any programming language you like, and you can use the built-in AI assistant to help you get started."}),"\n",(0,t.jsxs)(s.p,{children:["Defang is a great choice for stateless web services and APIs because it takes care of all the heavy lifting such as configuring ",(0,t.jsx)(s.a,{href:"../concepts/networking.md",children:"networking"}),", ",(0,t.jsx)(s.a,{href:"/docs/concepts/security",children:"security"}),", and ",(0,t.jsx)(s.a,{href:"/docs/concepts/observability",children:"observability"}),", and will give you a nice, ",(0,t.jsx)(s.a,{href:"https://12factor.net/concurrency",children:"horizontally scalable"})," deployment."]}),"\n",(0,t.jsxs)(s.p,{children:["If you are using ",(0,t.jsx)(s.a,{href:"/docs/concepts/defang-byoc",children:"Defang BYOC"}),", you can easily connect to databases, storage, and other services that you have running in your cloud account."]}),"\n",(0,t.jsx)(s.h2,{id:"mobile-app-backends",children:"Mobile App Backends"}),"\n",(0,t.jsx)(s.p,{children:"A mobile app backend is a web service or API that is used by a mobile app. Defang is a great choice for mobile app backends because it helps you deploy horizontally scalable web services and APIs. It's also particularly useful for mobile app developers who aren't familiar with cloud infrastructure: you don't need to be a cloud expert, or even a web expert to use Defang and properly provision all the necessary infrastructure for your app's backend."}),"\n",(0,t.jsx)(s.h2,{id:"hosting-llms",children:"Hosting LLMs"}),"\n",(0,t.jsx)(s.p,{children:"LLMs (Large Language Models) are a type of AI model that can be used for a wide variety of tasks such as text generation, translation, summarization, and more. Defang can be used to host LLMs and provide an API for them. Configuring cloud providers like AWS to easily run containerized workloads that depend on GPUs can be quite challenging, but Defang makes it easy."}),"\n",(0,t.jsx)(s.h1,{id:"anti-patterns",children:"Anti-patterns"}),"\n",(0,t.jsxs)(s.p,{children:["While Defang is great for a wide variety of use cases, there are some use cases that are not a good fit for Defang. Generally, the use-cases that are Defang anti-patterns are the same as the ones that are ",(0,t.jsx)(s.a,{href:"https://12factor.net/",children:"12 Factor"})," anti-patterns. Here are some examples:"]}),"\n",(0,t.jsx)(s.h2,{id:"stateful-services",children:"Stateful Services"}),"\n",(0,t.jsxs)(s.p,{children:["Some applications are designed to run in stateful environments. For example, a CMS like WordPress can be coerced to work in a stateless environment, but most of the tooling for it expects to have a long-lived filesystem and a database. Defang is not a good fit for these types of applications, because ",(0,t.jsx)(s.a,{href:"https://12factor.net/processes",children:"containers are ephemeral and can be replaced at any time"}),"."]}),"\n",(0,t.jsx)(s.h2,{id:"data-stores",children:"Data Stores"}),"\n",(0,t.jsx)(s.p,{children:"Defang is not a good fit for data stores like databases, caches, and message queues. These types of services are designed to be long-lived and to store data. Defang is primarily designed for stateless workloads, and it's not a good fit for stateful workloads: if a container is replaced, all the data in it is lost. You could probably coerce a data store to work in a stateless environment with certain replication strategies, but it's not a good fit."})]})}function u(e={}){const{wrapper:s}={...(0,n.M)(),...e.components};return s?(0,t.jsx)(s,{...e,children:(0,t.jsx)(d,{...e})}):d(e)}},2172:(e,s,a)=>{a.d(s,{I:()=>r,M:()=>i});var t=a(1504);const n={},o=t.createContext(n);function i(e){const s=t.useContext(o);return t.useMemo((function(){return"function"==typeof e?e(s):{...s,...e}}),[s,e])}function r(e){let s;return s=e.disableParentContext?"function"==typeof e.components?e.components(n):e.components||n:i(e.components),t.createElement(o.Provider,{value:s},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/706c2971.b250ef90.js b/assets/js/706c2971.b250ef90.js new file mode 100644 index 000000000..225ac0a5a --- /dev/null +++ b/assets/js/706c2971.b250ef90.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdefang_docs=self.webpackChunkdefang_docs||[]).push([[7616],{1676:(e,s,a)=>{a.r(s),a.d(s,{assets:()=>c,contentTitle:()=>i,default:()=>u,frontMatter:()=>o,metadata:()=>r,toc:()=>d});var t=a(7624),n=a(2172);const o={sidebar_position:100,title:"Use Cases",description:"Use cases for Defang."},i="Use Cases",r={id:"use-cases/use-cases",title:"Use Cases",description:"Use cases for Defang.",source:"@site/docs/use-cases/use-cases.md",sourceDirName:"use-cases",slug:"/use-cases/",permalink:"/docs/use-cases/",draft:!1,unlisted:!1,editUrl:"https://github.com/defang-io/defang-docs/tree/main/docs/use-cases/use-cases.md",tags:[],version:"current",sidebarPosition:100,frontMatter:{sidebar_position:100,title:"Use Cases",description:"Use cases for Defang."},sidebar:"docsSidebar",previous:{title:"Update Services",permalink:"/docs/getting-started/update"},next:{title:"Concepts",permalink:"/docs/category/concepts"}},c={},d=[{value:"Web Services and APIs",id:"web-services-and-apis",level:2},{value:"Mobile App Backends",id:"mobile-app-backends",level:2},{value:"Hosting LLMs",id:"hosting-llms",level:2},{value:"Stateful Services",id:"stateful-services",level:2},{value:"Data Stores",id:"data-stores",level:2}];function l(e){const s={a:"a",h1:"h1",h2:"h2",p:"p",...(0,n.M)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(s.h1,{id:"use-cases",children:"Use Cases"}),"\n",(0,t.jsxs)(s.p,{children:["Defang can be used for a wide variety of use cases, generally in line with the ",(0,t.jsx)(s.a,{href:"https://12factor.net/",children:"12 Factor architecture"}),". In this section we'll document some examples. At the end of this section we will also cover use cases that are not supported by Defang."]}),"\n",(0,t.jsx)(s.h2,{id:"web-services-and-apis",children:"Web Services and APIs"}),"\n",(0,t.jsx)(s.p,{children:"Defang can be used to deploy web services and APIs. You can use any programming language you like, and you can use the built-in AI assistant to help you get started."}),"\n",(0,t.jsxs)(s.p,{children:["Defang is a great choice for stateless web services and APIs because it takes care of all the heavy lifting such as configuring ",(0,t.jsx)(s.a,{href:"/docs/concepts/networking",children:"networking"}),", ",(0,t.jsx)(s.a,{href:"/docs/concepts/security",children:"security"}),", and ",(0,t.jsx)(s.a,{href:"/docs/concepts/observability",children:"observability"}),", and will give you a nice, ",(0,t.jsx)(s.a,{href:"https://12factor.net/concurrency",children:"horizontally scalable"})," deployment."]}),"\n",(0,t.jsxs)(s.p,{children:["If you are using ",(0,t.jsx)(s.a,{href:"/docs/concepts/defang-byoc",children:"Defang BYOC"}),", you can easily connect to databases, storage, and other services that you have running in your cloud account."]}),"\n",(0,t.jsx)(s.h2,{id:"mobile-app-backends",children:"Mobile App Backends"}),"\n",(0,t.jsx)(s.p,{children:"A mobile app backend is a web service or API that is used by a mobile app. Defang is a great choice for mobile app backends because it helps you deploy horizontally scalable web services and APIs. It's also particularly useful for mobile app developers who aren't familiar with cloud infrastructure: you don't need to be a cloud expert, or even a web expert to use Defang and properly provision all the necessary infrastructure for your app's backend."}),"\n",(0,t.jsx)(s.h2,{id:"hosting-llms",children:"Hosting LLMs"}),"\n",(0,t.jsx)(s.p,{children:"LLMs (Large Language Models) are a type of AI model that can be used for a wide variety of tasks such as text generation, translation, summarization, and more. Defang can be used to host LLMs and provide an API for them. Configuring cloud providers like AWS to easily run containerized workloads that depend on GPUs can be quite challenging, but Defang makes it easy."}),"\n",(0,t.jsx)(s.h1,{id:"anti-patterns",children:"Anti-patterns"}),"\n",(0,t.jsxs)(s.p,{children:["While Defang is great for a wide variety of use cases, there are some use cases that are not a good fit for Defang. Generally, the use-cases that are Defang anti-patterns are the same as the ones that are ",(0,t.jsx)(s.a,{href:"https://12factor.net/",children:"12 Factor"})," anti-patterns. Here are some examples:"]}),"\n",(0,t.jsx)(s.h2,{id:"stateful-services",children:"Stateful Services"}),"\n",(0,t.jsxs)(s.p,{children:["Some applications are designed to run in stateful environments. For example, a CMS like WordPress can be coerced to work in a stateless environment, but most of the tooling for it expects to have a long-lived filesystem and a database. Defang is not a good fit for these types of applications, because ",(0,t.jsx)(s.a,{href:"https://12factor.net/processes",children:"containers are ephemeral and can be replaced at any time"}),"."]}),"\n",(0,t.jsx)(s.h2,{id:"data-stores",children:"Data Stores"}),"\n",(0,t.jsx)(s.p,{children:"Defang is not a good fit for data stores like databases, caches, and message queues. These types of services are designed to be long-lived and to store data. Defang is primarily designed for stateless workloads, and it's not a good fit for stateful workloads: if a container is replaced, all the data in it is lost. You could probably coerce a data store to work in a stateless environment with certain replication strategies, but it's not a good fit."})]})}function u(e={}){const{wrapper:s}={...(0,n.M)(),...e.components};return s?(0,t.jsx)(s,{...e,children:(0,t.jsx)(l,{...e})}):l(e)}},2172:(e,s,a)=>{a.d(s,{I:()=>r,M:()=>i});var t=a(1504);const n={},o=t.createContext(n);function i(e){const s=t.useContext(o);return t.useMemo((function(){return"function"==typeof e?e(s):{...s,...e}}),[s,e])}function r(e){let s;return s=e.disableParentContext?"function"==typeof e.components?e.components(n):e.components||n:i(e.components),t.createElement(o.Provider,{value:s},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/935f2afb.d4903de0.js b/assets/js/935f2afb.c68cf81e.js similarity index 70% rename from assets/js/935f2afb.d4903de0.js rename to assets/js/935f2afb.c68cf81e.js index 91b6606f9..7b98e7125 100644 --- a/assets/js/935f2afb.d4903de0.js +++ b/assets/js/935f2afb.c68cf81e.js @@ -1 +1 @@ -"use strict";(self.webpackChunkdefang_docs=self.webpackChunkdefang_docs||[]).push([[5696],{5988:e=>{e.exports=JSON.parse('{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"docsSidebar":[{"type":"link","label":"Overview","href":"/docs/intro","docId":"intro","unlisted":false},{"type":"category","label":"Getting Started","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Installing","href":"/docs/getting-started/installing","docId":"getting-started/installing","unlisted":false},{"type":"link","label":"Authenticating","href":"/docs/getting-started/authenticating","docId":"getting-started/authenticating","unlisted":false},{"type":"link","label":"Build & Deploy Services","href":"/docs/getting-started/build-and-deploy","docId":"getting-started/build-and-deploy","unlisted":false},{"type":"link","label":"Monitor Services","href":"/docs/getting-started/monitor","docId":"getting-started/monitor","unlisted":false},{"type":"link","label":"Update Services","href":"/docs/getting-started/update","docId":"getting-started/update","unlisted":false}],"href":"/docs/getting-started/"},{"type":"category","label":"Concepts","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Defang Playground","href":"/docs/concepts/defang-playground","docId":"concepts/defang-playground","unlisted":false},{"type":"link","label":"Defang BYOC","href":"/docs/concepts/defang-byoc","docId":"concepts/defang-byoc","unlisted":false},{"type":"link","label":"Accounts","href":"/docs/concepts/accounts","docId":"concepts/accounts","unlisted":false},{"type":"link","label":"AI","href":"/docs/concepts/ai","docId":"concepts/ai","unlisted":false},{"type":"link","label":"Compose","href":"/docs/concepts/compose","docId":"concepts/compose","unlisted":false},{"type":"link","label":"Pulumi","href":"/docs/concepts/pulumi","docId":"concepts/pulumi","unlisted":false},{"type":"link","label":"Services","href":"/docs/concepts/services","docId":"concepts/services","unlisted":false},{"type":"link","label":"Configuration","href":"/docs/concepts/configuration","docId":"concepts/configuration","unlisted":false},{"type":"link","label":"Secrets","href":"/docs/concepts/secrets","docId":"concepts/secrets","unlisted":false},{"type":"link","label":"Security","href":"/docs/concepts/security","docId":"concepts/security","unlisted":false},{"type":"link","label":"Networking","href":"/docs/concepts/networking","docId":"concepts/networking","unlisted":false},{"type":"link","label":"Resources","href":"/docs/concepts/resources","docId":"concepts/resources","unlisted":false},{"type":"link","label":"Deployment","href":"/docs/concepts/deployments","docId":"concepts/deployments","unlisted":false},{"type":"link","label":"Observability","href":"/docs/concepts/observability","docId":"concepts/observability","unlisted":false},{"type":"link","label":"Portal","href":"/docs/concepts/portal","docId":"concepts/portal","unlisted":false}],"href":"/docs/category/concepts"},{"type":"category","label":"Providers","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"AWS","href":"/docs/providers/aws","docId":"providers/aws","unlisted":false},{"type":"link","label":"Azure","href":"/docs/providers/azure","docId":"providers/azure","unlisted":false},{"type":"link","label":"GCP","href":"/docs/providers/gcp","docId":"providers/gcp","unlisted":false}],"href":"/docs/category/providers"},{"type":"category","label":"Tutorials","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Create an outline using AI","href":"/docs/tutorials/generate-new-code-using-ai","docId":"tutorials/generate-new-code-using-ai","unlisted":false},{"type":"link","label":"Build and deploy code","href":"/docs/tutorials/deploy-code-compose","docId":"tutorials/deploy-code-compose","unlisted":false},{"type":"link","label":"Deploy pre-built container","href":"/docs/tutorials/deploy-container-using-the-cli","docId":"tutorials/deploy-container-using-the-cli","unlisted":false},{"type":"link","label":"Build and deploy using Pulumi","href":"/docs/tutorials/deploy-using-pulumi","docId":"tutorials/deploy-using-pulumi","unlisted":false}],"href":"/docs/category/tutorials"},{"type":"link","label":"Use Cases","href":"/docs/use-cases/","docId":"use-cases/use-cases","unlisted":false},{"type":"link","label":"Samples","href":"/docs/samples","docId":"samples","unlisted":false},{"type":"link","label":"FAQ","href":"/docs/faq","docId":"faq","unlisted":false}]},"docs":{"concepts/accounts":{"id":"concepts/accounts","title":"Accounts","description":"How accounts are organized in Defang.","sidebar":"docsSidebar"},"concepts/ai":{"id":"concepts/ai","title":"AI","description":"How Defang uses AI to help you build and deploy your cloud applications.","sidebar":"docsSidebar"},"concepts/compose":{"id":"concepts/compose","title":"Compose","description":"Defang allows you to use the compose.yaml specification to deploy your application to the cloud.","sidebar":"docsSidebar"},"concepts/configuration":{"id":"concepts/configuration","title":"Configuration","description":"Configuring your Defang application.","sidebar":"docsSidebar"},"concepts/defang-byoc":{"id":"concepts/defang-byoc","title":"Defang BYOC","description":"Defang allows you deploy services, defined as containers, to your own cloud accounts.","sidebar":"docsSidebar"},"concepts/defang-playground":{"id":"concepts/defang-playground","title":"Defang Playground","description":"Defang Playground allows you to get a feel for how Defang works without running production workloads in your own cloud accounts.","sidebar":"docsSidebar"},"concepts/deployments":{"id":"concepts/deployments","title":"Deployment","description":"Defang will build your services in the cloud and manage the deployment process for you.","sidebar":"docsSidebar"},"concepts/networking":{"id":"concepts/networking","title":"Networking","description":"Defang helps you safely configure your services\' networking.","sidebar":"docsSidebar"},"concepts/observability":{"id":"concepts/observability","title":"Observability","description":"Monitor and debug your Defang services with the Defang CLI and portal.","sidebar":"docsSidebar"},"concepts/portal":{"id":"concepts/portal","title":"Portal","description":"You can log into the Defang portal to view the state of your defang services.","sidebar":"docsSidebar"},"concepts/pulumi":{"id":"concepts/pulumi","title":"Pulumi","description":"Define your Defang services with Pulumi to integrate with other cloud resources.","sidebar":"docsSidebar"},"concepts/resources":{"id":"concepts/resources","title":"Resources","description":"Customize the resources your Defang services use.","sidebar":"docsSidebar"},"concepts/secrets":{"id":"concepts/secrets","title":"Secrets","description":"Secrets are a way to securely store sensitive information such as API keys, passwords, and other credentials.","sidebar":"docsSidebar"},"concepts/security":{"id":"concepts/security","title":"Security","description":"Defang configures your cloud applications and services with security best practices.","sidebar":"docsSidebar"},"concepts/services":{"id":"concepts/services","title":"Services","description":"Defang allows you deploy services, defined as containers, to the cloud.","sidebar":"docsSidebar"},"faq":{"id":"faq","title":"FAQ","description":"Frequently asked questions about Defang.","sidebar":"docsSidebar"},"getting-started/authenticating":{"id":"getting-started/authenticating","title":"Authenticating","description":"Authenticate with Defang.","sidebar":"docsSidebar"},"getting-started/build-and-deploy":{"id":"getting-started/build-and-deploy","title":"Build & Deploy Services","description":"Build and deploy services with Defang.","sidebar":"docsSidebar"},"getting-started/getting-started":{"id":"getting-started/getting-started","title":"Getting Started","description":"Get started with Defang.","sidebar":"docsSidebar"},"getting-started/installing":{"id":"getting-started/installing","title":"Installing","description":"How to install Defang.","sidebar":"docsSidebar"},"getting-started/monitor":{"id":"getting-started/monitor","title":"Monitor Services","description":"Monitor services with Defang.","sidebar":"docsSidebar"},"getting-started/update":{"id":"getting-started/update","title":"Update Services","description":"Update services with Defang.","sidebar":"docsSidebar"},"intro":{"id":"intro","title":"Overview","description":"Overview of Defang, a radically simpler way to build, deploy, and optimize production-ready cloud apps.","sidebar":"docsSidebar"},"providers/aws":{"id":"providers/aws","title":"AWS","description":"Defang allows you to easily create and manage full, scalable applications with AWS.","sidebar":"docsSidebar"},"providers/azure":{"id":"providers/azure","title":"Azure","description":"Defang will allow you to easily create and manage full, scalable applications with Azure.","sidebar":"docsSidebar"},"providers/gcp":{"id":"providers/gcp","title":"GCP","description":"Defang will allow you to easily create and manage full, scalable applications with GCP.","sidebar":"docsSidebar"},"samples":{"id":"samples","title":"Samples","description":"Sample projects to help you launch services faster with Defang.","sidebar":"docsSidebar"},"tutorials/deploy-code-compose":{"id":"tutorials/deploy-code-compose","title":"Build and deploy code","description":"This tutorial assumes that the code normally gets built into a container and has a Dockerfile file in the current folder.","sidebar":"docsSidebar"},"tutorials/deploy-container-using-the-cli":{"id":"tutorials/deploy-container-using-the-cli","title":"Deploy pre-built container","description":"This example is useful if you already have a Docker container built manually or through a CI/CD system and have that the resulting image is available in a public or private repository accessible by Defang.","sidebar":"docsSidebar"},"tutorials/deploy-using-pulumi":{"id":"tutorials/deploy-using-pulumi","title":"Build and deploy using Pulumi","description":"Installing Dependencies","sidebar":"docsSidebar"},"tutorials/generate-new-code-using-ai":{"id":"tutorials/generate-new-code-using-ai","title":"Create an outline using AI","description":"Defang supports generating new project outlines using integration with an AI model. Using this feature, you can describe what you would like the service to do and the CLI will then generate a project outline with all the files required to make it work.","sidebar":"docsSidebar"},"use-cases/use-cases":{"id":"use-cases/use-cases","title":"Use Cases","description":"Use cases for Defang.","sidebar":"docsSidebar"}}}')}}]); \ No newline at end of file +"use strict";(self.webpackChunkdefang_docs=self.webpackChunkdefang_docs||[]).push([[5696],{5988:e=>{e.exports=JSON.parse('{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"docsSidebar":[{"type":"link","label":"Overview","href":"/docs/intro","docId":"intro","unlisted":false},{"type":"category","label":"Getting Started","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Installing","href":"/docs/getting-started/installing","docId":"getting-started/installing","unlisted":false},{"type":"link","label":"Authenticating","href":"/docs/getting-started/authenticating","docId":"getting-started/authenticating","unlisted":false},{"type":"link","label":"Build & Deploy Services","href":"/docs/getting-started/build-and-deploy","docId":"getting-started/build-and-deploy","unlisted":false},{"type":"link","label":"Monitor Services","href":"/docs/getting-started/monitor","docId":"getting-started/monitor","unlisted":false},{"type":"link","label":"Update Services","href":"/docs/getting-started/update","docId":"getting-started/update","unlisted":false}],"href":"/docs/getting-started/"},{"type":"link","label":"Use Cases","href":"/docs/use-cases/","docId":"use-cases/use-cases","unlisted":false},{"type":"category","label":"Concepts","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Defang Playground","href":"/docs/concepts/defang-playground","docId":"concepts/defang-playground","unlisted":false},{"type":"link","label":"Defang BYOC","href":"/docs/concepts/defang-byoc","docId":"concepts/defang-byoc","unlisted":false},{"type":"link","label":"Accounts","href":"/docs/concepts/accounts","docId":"concepts/accounts","unlisted":false},{"type":"link","label":"AI","href":"/docs/concepts/ai","docId":"concepts/ai","unlisted":false},{"type":"link","label":"Compose","href":"/docs/concepts/compose","docId":"concepts/compose","unlisted":false},{"type":"link","label":"Pulumi","href":"/docs/concepts/pulumi","docId":"concepts/pulumi","unlisted":false},{"type":"link","label":"Services","href":"/docs/concepts/services","docId":"concepts/services","unlisted":false},{"type":"link","label":"Configuration","href":"/docs/concepts/configuration","docId":"concepts/configuration","unlisted":false},{"type":"link","label":"Secrets","href":"/docs/concepts/secrets","docId":"concepts/secrets","unlisted":false},{"type":"link","label":"Security","href":"/docs/concepts/security","docId":"concepts/security","unlisted":false},{"type":"link","label":"Networking","href":"/docs/concepts/networking","docId":"concepts/networking","unlisted":false},{"type":"link","label":"Resources","href":"/docs/concepts/resources","docId":"concepts/resources","unlisted":false},{"type":"link","label":"Deployment","href":"/docs/concepts/deployments","docId":"concepts/deployments","unlisted":false},{"type":"link","label":"Observability","href":"/docs/concepts/observability","docId":"concepts/observability","unlisted":false},{"type":"link","label":"Portal","href":"/docs/concepts/portal","docId":"concepts/portal","unlisted":false}],"href":"/docs/category/concepts"},{"type":"category","label":"Providers","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"AWS","href":"/docs/providers/aws","docId":"providers/aws","unlisted":false},{"type":"link","label":"Azure","href":"/docs/providers/azure","docId":"providers/azure","unlisted":false},{"type":"link","label":"GCP","href":"/docs/providers/gcp","docId":"providers/gcp","unlisted":false}],"href":"/docs/category/providers"},{"type":"category","label":"Tutorials","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Create an outline using AI","href":"/docs/tutorials/generate-new-code-using-ai","docId":"tutorials/generate-new-code-using-ai","unlisted":false},{"type":"link","label":"Build and deploy code","href":"/docs/tutorials/deploy-code-compose","docId":"tutorials/deploy-code-compose","unlisted":false},{"type":"link","label":"Deploy pre-built container","href":"/docs/tutorials/deploy-container-using-the-cli","docId":"tutorials/deploy-container-using-the-cli","unlisted":false},{"type":"link","label":"Build and deploy using Pulumi","href":"/docs/tutorials/deploy-using-pulumi","docId":"tutorials/deploy-using-pulumi","unlisted":false}],"href":"/docs/category/tutorials"},{"type":"link","label":"Samples","href":"/docs/samples","docId":"samples","unlisted":false},{"type":"link","label":"FAQ","href":"/docs/faq","docId":"faq","unlisted":false}]},"docs":{"concepts/accounts":{"id":"concepts/accounts","title":"Accounts","description":"How accounts are organized in Defang.","sidebar":"docsSidebar"},"concepts/ai":{"id":"concepts/ai","title":"AI","description":"How Defang uses AI to help you build and deploy your cloud applications.","sidebar":"docsSidebar"},"concepts/compose":{"id":"concepts/compose","title":"Compose","description":"Defang allows you to use the compose.yaml specification to deploy your application to the cloud.","sidebar":"docsSidebar"},"concepts/configuration":{"id":"concepts/configuration","title":"Configuration","description":"Configuring your Defang application.","sidebar":"docsSidebar"},"concepts/defang-byoc":{"id":"concepts/defang-byoc","title":"Defang BYOC","description":"Defang allows you deploy services, defined as containers, to your own cloud accounts.","sidebar":"docsSidebar"},"concepts/defang-playground":{"id":"concepts/defang-playground","title":"Defang Playground","description":"Defang Playground allows you to get a feel for how Defang works without running production workloads in your own cloud accounts.","sidebar":"docsSidebar"},"concepts/deployments":{"id":"concepts/deployments","title":"Deployment","description":"Defang will build your services in the cloud and manage the deployment process for you.","sidebar":"docsSidebar"},"concepts/networking":{"id":"concepts/networking","title":"Networking","description":"Defang helps you safely configure your services\' networking.","sidebar":"docsSidebar"},"concepts/observability":{"id":"concepts/observability","title":"Observability","description":"Monitor and debug your Defang services with the Defang CLI and portal.","sidebar":"docsSidebar"},"concepts/portal":{"id":"concepts/portal","title":"Portal","description":"You can log into the Defang portal to view the state of your defang services.","sidebar":"docsSidebar"},"concepts/pulumi":{"id":"concepts/pulumi","title":"Pulumi","description":"Define your Defang services with Pulumi to integrate with other cloud resources.","sidebar":"docsSidebar"},"concepts/resources":{"id":"concepts/resources","title":"Resources","description":"Customize the resources your Defang services use.","sidebar":"docsSidebar"},"concepts/secrets":{"id":"concepts/secrets","title":"Secrets","description":"Secrets are a way to securely store sensitive information such as API keys, passwords, and other credentials.","sidebar":"docsSidebar"},"concepts/security":{"id":"concepts/security","title":"Security","description":"Defang configures your cloud applications and services with security best practices.","sidebar":"docsSidebar"},"concepts/services":{"id":"concepts/services","title":"Services","description":"Defang allows you deploy services, defined as containers, to the cloud.","sidebar":"docsSidebar"},"faq":{"id":"faq","title":"FAQ","description":"Frequently asked questions about Defang.","sidebar":"docsSidebar"},"getting-started/authenticating":{"id":"getting-started/authenticating","title":"Authenticating","description":"Authenticate with Defang.","sidebar":"docsSidebar"},"getting-started/build-and-deploy":{"id":"getting-started/build-and-deploy","title":"Build & Deploy Services","description":"Build and deploy services with Defang.","sidebar":"docsSidebar"},"getting-started/getting-started":{"id":"getting-started/getting-started","title":"Getting Started","description":"Get started with Defang.","sidebar":"docsSidebar"},"getting-started/installing":{"id":"getting-started/installing","title":"Installing","description":"How to install Defang.","sidebar":"docsSidebar"},"getting-started/monitor":{"id":"getting-started/monitor","title":"Monitor Services","description":"Monitor services with Defang.","sidebar":"docsSidebar"},"getting-started/update":{"id":"getting-started/update","title":"Update Services","description":"Update services with Defang.","sidebar":"docsSidebar"},"intro":{"id":"intro","title":"Overview","description":"Overview of Defang, a radically simpler way to build, deploy, and optimize production-ready cloud apps.","sidebar":"docsSidebar"},"providers/aws":{"id":"providers/aws","title":"AWS","description":"Defang allows you to easily create and manage full, scalable applications with AWS.","sidebar":"docsSidebar"},"providers/azure":{"id":"providers/azure","title":"Azure","description":"Defang will allow you to easily create and manage full, scalable applications with Azure.","sidebar":"docsSidebar"},"providers/gcp":{"id":"providers/gcp","title":"GCP","description":"Defang will allow you to easily create and manage full, scalable applications with GCP.","sidebar":"docsSidebar"},"samples":{"id":"samples","title":"Samples","description":"Sample projects to help you launch services faster with Defang.","sidebar":"docsSidebar"},"tutorials/deploy-code-compose":{"id":"tutorials/deploy-code-compose","title":"Build and deploy code","description":"This tutorial assumes that the code normally gets built into a container and has a Dockerfile file in the current folder.","sidebar":"docsSidebar"},"tutorials/deploy-container-using-the-cli":{"id":"tutorials/deploy-container-using-the-cli","title":"Deploy pre-built container","description":"This example is useful if you already have a Docker container built manually or through a CI/CD system and have that the resulting image is available in a public or private repository accessible by Defang.","sidebar":"docsSidebar"},"tutorials/deploy-using-pulumi":{"id":"tutorials/deploy-using-pulumi","title":"Build and deploy using Pulumi","description":"Installing Dependencies","sidebar":"docsSidebar"},"tutorials/generate-new-code-using-ai":{"id":"tutorials/generate-new-code-using-ai","title":"Create an outline using AI","description":"Defang supports generating new project outlines using integration with an AI model. Using this feature, you can describe what you would like the service to do and the CLI will then generate a project outline with all the files required to make it work.","sidebar":"docsSidebar"},"use-cases/use-cases":{"id":"use-cases/use-cases","title":"Use Cases","description":"Use cases for Defang.","sidebar":"docsSidebar"}}}')}}]); \ No newline at end of file diff --git a/assets/js/980f8111.32c31966.js b/assets/js/980f8111.32c31966.js deleted file mode 100644 index b3b2d2fc7..000000000 --- a/assets/js/980f8111.32c31966.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdefang_docs=self.webpackChunkdefang_docs||[]).push([[1516],{5884:(e,n,i)=>{i.r(n),i.d(n,{assets:()=>a,contentTitle:()=>r,default:()=>u,frontMatter:()=>l,metadata:()=>s,toc:()=>d});var t=i(7624),o=i(2172);const l={title:"Build and deploy using Pulumi",sidebar_position:400},r="Deploy using Pulumi",s={id:"tutorials/deploy-using-pulumi",title:"Build and deploy using Pulumi",description:"Installing Dependencies",source:"@site/docs/tutorials/deploy-using-pulumi.mdx",sourceDirName:"tutorials",slug:"/tutorials/deploy-using-pulumi",permalink:"/docs/tutorials/deploy-using-pulumi",draft:!1,unlisted:!1,editUrl:"https://github.com/defang-io/defang-docs/tree/main/docs/tutorials/deploy-using-pulumi.mdx",tags:[],version:"current",sidebarPosition:400,frontMatter:{title:"Build and deploy using Pulumi",sidebar_position:400},sidebar:"docsSidebar",previous:{title:"Deploy pre-built container",permalink:"/docs/tutorials/deploy-container-using-the-cli"},next:{title:"Use Cases",permalink:"/docs/use-cases/"}},a={},d=[{value:"Installing Dependencies",id:"installing-dependencies",level:2},{value:"Project Directory Setup",id:"project-directory-setup",level:2},{value:"Initialize the Project",id:"initialize-the-project",level:2},{value:"Install the Defang Provider",id:"install-the-defang-provider",level:2},{value:"Write the Pulumi Code",id:"write-the-pulumi-code",level:2},{value:"Deploy to Defang",id:"deploy-to-defang",level:2},{value:"Monitor the Deployment",id:"monitor-the-deployment",level:2},{value:"Logging Into Minio",id:"logging-into-minio",level:2},{value:"Clean Up",id:"clean-up",level:2}];function c(e){const n={a:"a",admonition:"admonition",code:"code",h1:"h1",h2:"h2",p:"p",pre:"pre",...(0,o.M)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.h1,{id:"deploy-using-pulumi",children:"Deploy using Pulumi"}),"\n",(0,t.jsx)(n.h2,{id:"installing-dependencies",children:"Installing Dependencies"}),"\n",(0,t.jsxs)(n.p,{children:["Make sure to install the ",(0,t.jsx)(n.a,{href:"https://www.pulumi.com/docs/install/",children:"Pulumi CLI"})," and the ",(0,t.jsx)(n.a,{href:"/docs/getting-started/installing",children:"Defang CLI"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:["Make sure you are logged into the ",(0,t.jsx)(n.a,{href:"/docs/getting-started/authenticating",children:"Defang CLI"}),". Don't worry about the Pulumi CLI for now."]}),"\n",(0,t.jsx)(n.h2,{id:"project-directory-setup",children:"Project Directory Setup"}),"\n",(0,t.jsx)(n.p,{children:"Create a new directory for your project and navigate to it."}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"mkdir project && cd project\n"})}),"\n",(0,t.jsx)(n.p,{children:"If you're familiar with Pulumi and/or are already logged in with the Pulumi CLI, you can skip the next step."}),"\n",(0,t.jsx)(n.p,{children:'If you are new to pulumi and/or don\'t have an account, you can "login" to the filesystem by running the following command:'}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"pulumi login file://./\n"})}),"\n",(0,t.jsx)(n.p,{children:"This will make the Pulumi CLI store the state of your infrastructure in the current directory."}),"\n",(0,t.jsx)(n.h2,{id:"initialize-the-project",children:"Initialize the Project"}),"\n",(0,t.jsx)(n.p,{children:"Run the following command to set your encryption passphrase for this terminal session:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:'export PULUMI_CONFIG_PASSPHRASE="super-secure-passphrase"\n'})}),"\n",(0,t.jsx)(n.p,{children:"Now let's initialize the Pulumi project:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"pulumi new typescript -y --force\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This will create a new Pulumi project in the current directory and will create a Pulumi stack called ",(0,t.jsx)(n.code,{children:"dev"})," by default. We use the ",(0,t.jsx)(n.code,{children:"--force"})," flag because the directory isn't empty (we created a folder when we logged in with the Pulumi CLI)."]}),"\n",(0,t.jsxs)(n.p,{children:["Run the following command to add to the ",(0,t.jsx)(n.code,{children:".gitignore"})," file:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:'echo ".pulumi" >> .gitignore\n'})}),"\n",(0,t.jsx)(n.h2,{id:"install-the-defang-provider",children:"Install the Defang Provider"}),"\n",(0,t.jsx)(n.p,{children:"Run the following command to install the Defang provider:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"npm install @defang-io/pulumi-defang\n"})}),"\n",(0,t.jsx)(n.h2,{id:"write-the-pulumi-code",children:"Write the Pulumi Code"}),"\n",(0,t.jsxs)(n.p,{children:["Your ",(0,t.jsx)(n.code,{children:"index.ts"})," file should look like this:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-typescript",children:"import * as defang from '@defang-io/pulumi-defang/lib';\n\nexport const service = new defang.DefangService('minio', {\n name: 'minio',\n image: 'quay.io/minio/minio',\n // starts the server with the console address set to :9001\n command: ['server', '--console-address', ':9001', '/data'],\n // Set the root username\n environment: {\n MINIO_ROOT_USER: 'minio',\n },\n secrets: [\n // Set the root password as a secret which will be encrypted at rest\n {\n source: 'MINIO_ROOT_PASSWORD',\n value: 'minio123',\n },\n ],\n // Run a healthcheck every 30 seconds\n healthcheck: {\n test: ['CMD', 'curl', 'http://localhost:9000/minio/health/live'],\n interval: 30,\n timeout: 5,\n retries: 3,\n },\n // Expose the server on port 9000 and the console on port 9001\n ports: [\n {\n target: 9000,\n protocol: 'http',\n mode: 'ingress',\n },\n {\n target: 9001,\n protocol: 'http',\n mode: 'ingress',\n },\n ],\n});\n"})}),"\n",(0,t.jsx)(n.h2,{id:"deploy-to-defang",children:"Deploy to Defang"}),"\n",(0,t.jsx)(n.admonition,{type:"warning",children:(0,t.jsxs)(n.p,{children:["At the time of writing, the Defang Pulumi Provider only works with ",(0,t.jsx)(n.a,{href:"/docs/concepts/defang-playground",children:"Defang Playground"}),". We are working on ",(0,t.jsx)(n.a,{href:"/docs/concepts/defang-byoc",children:"BYOC"})," support."]})}),"\n",(0,t.jsx)(n.p,{children:"Run the following command to deploy your service:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"pulumi up --stack=dev\n"})}),"\n",(0,t.jsx)(n.h2,{id:"monitor-the-deployment",children:"Monitor the Deployment"}),"\n",(0,t.jsx)(n.p,{children:"You can monitor the deployment by running the following command:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"defang tail --name minio\n"})}),"\n",(0,t.jsx)(n.h2,{id:"logging-into-minio",children:"Logging Into Minio"}),"\n",(0,t.jsxs)(n.p,{children:["The ",(0,t.jsx)(n.a,{href:"/docs/concepts/defang-playground",children:"Defang Playground"})," will give you a domain, which you can obtain by running the following command:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"defang ls | grep 'minio.*9001'\n"})}),"\n",(0,t.jsxs)(n.p,{children:["If you navigate to the domain in your browser, you will be prompted to log in. Use the username ",(0,t.jsx)(n.code,{children:"minio"})," and the password ",(0,t.jsx)(n.code,{children:"minio123"}),"."]}),"\n",(0,t.jsx)(n.h2,{id:"clean-up",children:"Clean Up"}),"\n",(0,t.jsx)(n.p,{children:"To clean up the deployment, run the following command:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"pulumi destroy --stack=dev\n"})})]})}function u(e={}){const{wrapper:n}={...(0,o.M)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(c,{...e})}):c(e)}},2172:(e,n,i)=>{i.d(n,{I:()=>s,M:()=>r});var t=i(1504);const o={},l=t.createContext(o);function r(e){const n=t.useContext(l);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function s(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(o):e.components||o:r(e.components),t.createElement(l.Provider,{value:n},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/980f8111.3b423900.js b/assets/js/980f8111.3b423900.js new file mode 100644 index 000000000..b51be235c --- /dev/null +++ b/assets/js/980f8111.3b423900.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdefang_docs=self.webpackChunkdefang_docs||[]).push([[1516],{5884:(e,n,i)=>{i.r(n),i.d(n,{assets:()=>a,contentTitle:()=>r,default:()=>u,frontMatter:()=>l,metadata:()=>s,toc:()=>d});var t=i(7624),o=i(2172);const l={title:"Build and deploy using Pulumi",sidebar_position:400},r="Deploy using Pulumi",s={id:"tutorials/deploy-using-pulumi",title:"Build and deploy using Pulumi",description:"Installing Dependencies",source:"@site/docs/tutorials/deploy-using-pulumi.mdx",sourceDirName:"tutorials",slug:"/tutorials/deploy-using-pulumi",permalink:"/docs/tutorials/deploy-using-pulumi",draft:!1,unlisted:!1,editUrl:"https://github.com/defang-io/defang-docs/tree/main/docs/tutorials/deploy-using-pulumi.mdx",tags:[],version:"current",sidebarPosition:400,frontMatter:{title:"Build and deploy using Pulumi",sidebar_position:400},sidebar:"docsSidebar",previous:{title:"Deploy pre-built container",permalink:"/docs/tutorials/deploy-container-using-the-cli"},next:{title:"Samples",permalink:"/docs/samples"}},a={},d=[{value:"Installing Dependencies",id:"installing-dependencies",level:2},{value:"Project Directory Setup",id:"project-directory-setup",level:2},{value:"Initialize the Project",id:"initialize-the-project",level:2},{value:"Install the Defang Provider",id:"install-the-defang-provider",level:2},{value:"Write the Pulumi Code",id:"write-the-pulumi-code",level:2},{value:"Deploy to Defang",id:"deploy-to-defang",level:2},{value:"Monitor the Deployment",id:"monitor-the-deployment",level:2},{value:"Logging Into Minio",id:"logging-into-minio",level:2},{value:"Clean Up",id:"clean-up",level:2}];function c(e){const n={a:"a",admonition:"admonition",code:"code",h1:"h1",h2:"h2",p:"p",pre:"pre",...(0,o.M)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.h1,{id:"deploy-using-pulumi",children:"Deploy using Pulumi"}),"\n",(0,t.jsx)(n.h2,{id:"installing-dependencies",children:"Installing Dependencies"}),"\n",(0,t.jsxs)(n.p,{children:["Make sure to install the ",(0,t.jsx)(n.a,{href:"https://www.pulumi.com/docs/install/",children:"Pulumi CLI"})," and the ",(0,t.jsx)(n.a,{href:"/docs/getting-started/installing",children:"Defang CLI"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:["Make sure you are logged into the ",(0,t.jsx)(n.a,{href:"/docs/getting-started/authenticating",children:"Defang CLI"}),". Don't worry about the Pulumi CLI for now."]}),"\n",(0,t.jsx)(n.h2,{id:"project-directory-setup",children:"Project Directory Setup"}),"\n",(0,t.jsx)(n.p,{children:"Create a new directory for your project and navigate to it."}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"mkdir project && cd project\n"})}),"\n",(0,t.jsx)(n.p,{children:"If you're familiar with Pulumi and/or are already logged in with the Pulumi CLI, you can skip the next step."}),"\n",(0,t.jsx)(n.p,{children:'If you are new to pulumi and/or don\'t have an account, you can "login" to the filesystem by running the following command:'}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"pulumi login file://./\n"})}),"\n",(0,t.jsx)(n.p,{children:"This will make the Pulumi CLI store the state of your infrastructure in the current directory."}),"\n",(0,t.jsx)(n.h2,{id:"initialize-the-project",children:"Initialize the Project"}),"\n",(0,t.jsx)(n.p,{children:"Run the following command to set your encryption passphrase for this terminal session:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:'export PULUMI_CONFIG_PASSPHRASE="super-secure-passphrase"\n'})}),"\n",(0,t.jsx)(n.p,{children:"Now let's initialize the Pulumi project:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"pulumi new typescript -y --force\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This will create a new Pulumi project in the current directory and will create a Pulumi stack called ",(0,t.jsx)(n.code,{children:"dev"})," by default. We use the ",(0,t.jsx)(n.code,{children:"--force"})," flag because the directory isn't empty (we created a folder when we logged in with the Pulumi CLI)."]}),"\n",(0,t.jsxs)(n.p,{children:["Run the following command to add to the ",(0,t.jsx)(n.code,{children:".gitignore"})," file:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:'echo ".pulumi" >> .gitignore\n'})}),"\n",(0,t.jsx)(n.h2,{id:"install-the-defang-provider",children:"Install the Defang Provider"}),"\n",(0,t.jsx)(n.p,{children:"Run the following command to install the Defang provider:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"npm install @defang-io/pulumi-defang\n"})}),"\n",(0,t.jsx)(n.h2,{id:"write-the-pulumi-code",children:"Write the Pulumi Code"}),"\n",(0,t.jsxs)(n.p,{children:["Your ",(0,t.jsx)(n.code,{children:"index.ts"})," file should look like this:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-typescript",children:"import * as defang from '@defang-io/pulumi-defang/lib';\n\nexport const service = new defang.DefangService('minio', {\n name: 'minio',\n image: 'quay.io/minio/minio',\n // starts the server with the console address set to :9001\n command: ['server', '--console-address', ':9001', '/data'],\n // Set the root username\n environment: {\n MINIO_ROOT_USER: 'minio',\n },\n secrets: [\n // Set the root password as a secret which will be encrypted at rest\n {\n source: 'MINIO_ROOT_PASSWORD',\n value: 'minio123',\n },\n ],\n // Run a healthcheck every 30 seconds\n healthcheck: {\n test: ['CMD', 'curl', 'http://localhost:9000/minio/health/live'],\n interval: 30,\n timeout: 5,\n retries: 3,\n },\n // Expose the server on port 9000 and the console on port 9001\n ports: [\n {\n target: 9000,\n protocol: 'http',\n mode: 'ingress',\n },\n {\n target: 9001,\n protocol: 'http',\n mode: 'ingress',\n },\n ],\n});\n"})}),"\n",(0,t.jsx)(n.h2,{id:"deploy-to-defang",children:"Deploy to Defang"}),"\n",(0,t.jsx)(n.admonition,{type:"warning",children:(0,t.jsxs)(n.p,{children:["At the time of writing, the Defang Pulumi Provider only works with ",(0,t.jsx)(n.a,{href:"/docs/concepts/defang-playground",children:"Defang Playground"}),". We are working on ",(0,t.jsx)(n.a,{href:"/docs/concepts/defang-byoc",children:"BYOC"})," support."]})}),"\n",(0,t.jsx)(n.p,{children:"Run the following command to deploy your service:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"pulumi up --stack=dev\n"})}),"\n",(0,t.jsx)(n.h2,{id:"monitor-the-deployment",children:"Monitor the Deployment"}),"\n",(0,t.jsx)(n.p,{children:"You can monitor the deployment by running the following command:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"defang tail --name minio\n"})}),"\n",(0,t.jsx)(n.h2,{id:"logging-into-minio",children:"Logging Into Minio"}),"\n",(0,t.jsxs)(n.p,{children:["The ",(0,t.jsx)(n.a,{href:"/docs/concepts/defang-playground",children:"Defang Playground"})," will give you a domain, which you can obtain by running the following command:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"defang ls | grep 'minio.*9001'\n"})}),"\n",(0,t.jsxs)(n.p,{children:["If you navigate to the domain in your browser, you will be prompted to log in. Use the username ",(0,t.jsx)(n.code,{children:"minio"})," and the password ",(0,t.jsx)(n.code,{children:"minio123"}),"."]}),"\n",(0,t.jsx)(n.h2,{id:"clean-up",children:"Clean Up"}),"\n",(0,t.jsx)(n.p,{children:"To clean up the deployment, run the following command:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"pulumi destroy --stack=dev\n"})})]})}function u(e={}){const{wrapper:n}={...(0,o.M)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(c,{...e})}):c(e)}},2172:(e,n,i)=>{i.d(n,{I:()=>s,M:()=>r});var t=i(1504);const o={},l=t.createContext(o);function r(e){const n=t.useContext(l);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function s(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(o):e.components||o:r(e.components),t.createElement(l.Provider,{value:n},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/db1fbb7d.a63fa0d5.js b/assets/js/db1fbb7d.a61c7cfb.js similarity index 59% rename from assets/js/db1fbb7d.a63fa0d5.js rename to assets/js/db1fbb7d.a61c7cfb.js index fc0b5192e..0afc15ba1 100644 --- a/assets/js/db1fbb7d.a63fa0d5.js +++ b/assets/js/db1fbb7d.a61c7cfb.js @@ -1 +1 @@ -"use strict";(self.webpackChunkdefang_docs=self.webpackChunkdefang_docs||[]).push([[7792],{6652:e=>{e.exports=JSON.parse('{"title":"Concepts","description":"Some concepts to help explain how the Defang system is organized and tooling that will help you manage your applications.","slug":"/category/concepts","permalink":"/docs/category/concepts","navigation":{"previous":{"title":"Update Services","permalink":"/docs/getting-started/update"},"next":{"title":"Defang Playground","permalink":"/docs/concepts/defang-playground"}}}')}}]); \ No newline at end of file +"use strict";(self.webpackChunkdefang_docs=self.webpackChunkdefang_docs||[]).push([[7792],{6652:e=>{e.exports=JSON.parse('{"title":"Concepts","description":"Some concepts to help explain how the Defang system is organized and tooling that will help you manage your applications.","slug":"/category/concepts","permalink":"/docs/category/concepts","navigation":{"previous":{"title":"Use Cases","permalink":"/docs/use-cases/"},"next":{"title":"Defang Playground","permalink":"/docs/concepts/defang-playground"}}}')}}]); \ No newline at end of file diff --git a/assets/js/eb08e5ec.67245636.js b/assets/js/eb08e5ec.67245636.js deleted file mode 100644 index 084f2e52c..000000000 --- a/assets/js/eb08e5ec.67245636.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdefang_docs=self.webpackChunkdefang_docs||[]).push([[3768],{7460:(e,t,n)=>{n.r(t),n.d(t,{assets:()=>d,contentTitle:()=>r,default:()=>u,frontMatter:()=>o,metadata:()=>a,toc:()=>c});var i=n(7624),s=n(2172);const o={sidebar_position:500,title:"Update Services",description:"Update services with Defang."},r="Update Services",a={id:"getting-started/update",title:"Update Services",description:"Update services with Defang.",source:"@site/docs/getting-started/update.md",sourceDirName:"getting-started",slug:"/getting-started/update",permalink:"/docs/getting-started/update",draft:!1,unlisted:!1,editUrl:"https://github.com/defang-io/defang-docs/tree/main/docs/getting-started/update.md",tags:[],version:"current",sidebarPosition:500,frontMatter:{sidebar_position:500,title:"Update Services",description:"Update services with Defang."},sidebar:"docsSidebar",previous:{title:"Monitor Services",permalink:"/docs/getting-started/monitor"},next:{title:"Concepts",permalink:"/docs/category/concepts"}},d={},c=[];function p(e){const t={a:"a",admonition:"admonition",code:"code",h1:"h1",p:"p",...(0,s.M)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(t.h1,{id:"update-services",children:"Update Services"}),"\n",(0,i.jsxs)(t.p,{children:["To update your app (for example, updating the base image of your container, or making changes to your code) you can run the ",(0,i.jsx)(t.code,{children:"defang compose up"})," command and it will build and deploy a new version with zero downtime. Your current version of the service will keep running and handling traffic while the new version is being built and deployed. Only after the new version passes the health checks and accepts traffic will the older version be stopped."]}),"\n",(0,i.jsx)(t.admonition,{type:"info",children:(0,i.jsxs)(t.p,{children:["If you are using ",(0,i.jsx)(t.a,{href:"/docs/concepts/compose",children:"compose files"})," to define your services, you can add/remove services, make changes to code, etc. When you run ",(0,i.jsx)(t.code,{children:"defang compose up"}),", the update will be diffed against the current state and any necessary changes will be applied to make the current state match the desired state."]})})]})}function u(e={}){const{wrapper:t}={...(0,s.M)(),...e.components};return t?(0,i.jsx)(t,{...e,children:(0,i.jsx)(p,{...e})}):p(e)}},2172:(e,t,n)=>{n.d(t,{I:()=>a,M:()=>r});var i=n(1504);const s={},o=i.createContext(s);function r(e){const t=i.useContext(o);return i.useMemo((function(){return"function"==typeof e?e(t):{...t,...e}}),[t,e])}function a(e){let t;return t=e.disableParentContext?"function"==typeof e.components?e.components(s):e.components||s:r(e.components),i.createElement(o.Provider,{value:t},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/eb08e5ec.d8b4112d.js b/assets/js/eb08e5ec.d8b4112d.js new file mode 100644 index 000000000..59168e98f --- /dev/null +++ b/assets/js/eb08e5ec.d8b4112d.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdefang_docs=self.webpackChunkdefang_docs||[]).push([[3768],{7460:(e,t,n)=>{n.r(t),n.d(t,{assets:()=>d,contentTitle:()=>r,default:()=>u,frontMatter:()=>o,metadata:()=>a,toc:()=>c});var s=n(7624),i=n(2172);const o={sidebar_position:500,title:"Update Services",description:"Update services with Defang."},r="Update Services",a={id:"getting-started/update",title:"Update Services",description:"Update services with Defang.",source:"@site/docs/getting-started/update.md",sourceDirName:"getting-started",slug:"/getting-started/update",permalink:"/docs/getting-started/update",draft:!1,unlisted:!1,editUrl:"https://github.com/defang-io/defang-docs/tree/main/docs/getting-started/update.md",tags:[],version:"current",sidebarPosition:500,frontMatter:{sidebar_position:500,title:"Update Services",description:"Update services with Defang."},sidebar:"docsSidebar",previous:{title:"Monitor Services",permalink:"/docs/getting-started/monitor"},next:{title:"Use Cases",permalink:"/docs/use-cases/"}},d={},c=[];function p(e){const t={a:"a",admonition:"admonition",code:"code",h1:"h1",p:"p",...(0,i.M)(),...e.components};return(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(t.h1,{id:"update-services",children:"Update Services"}),"\n",(0,s.jsxs)(t.p,{children:["To update your app (for example, updating the base image of your container, or making changes to your code) you can run the ",(0,s.jsx)(t.code,{children:"defang compose up"})," command and it will build and deploy a new version with zero downtime. Your current version of the service will keep running and handling traffic while the new version is being built and deployed. Only after the new version passes the health checks and accepts traffic will the older version be stopped."]}),"\n",(0,s.jsx)(t.admonition,{type:"info",children:(0,s.jsxs)(t.p,{children:["If you are using ",(0,s.jsx)(t.a,{href:"/docs/concepts/compose",children:"compose files"})," to define your services, you can add/remove services, make changes to code, etc. When you run ",(0,s.jsx)(t.code,{children:"defang compose up"}),", the update will be diffed against the current state and any necessary changes will be applied to make the current state match the desired state."]})})]})}function u(e={}){const{wrapper:t}={...(0,i.M)(),...e.components};return t?(0,s.jsx)(t,{...e,children:(0,s.jsx)(p,{...e})}):p(e)}},2172:(e,t,n)=>{n.d(t,{I:()=>a,M:()=>r});var s=n(1504);const i={},o=s.createContext(i);function r(e){const t=s.useContext(o);return s.useMemo((function(){return"function"==typeof e?e(t):{...t,...e}}),[t,e])}function a(e){let t;return t=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:r(e.components),s.createElement(o.Provider,{value:t},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/main.d6668cb6.js b/assets/js/main.2386e6b6.js similarity index 78% rename from assets/js/main.d6668cb6.js rename to assets/js/main.2386e6b6.js index 89abc77ff..a248c30fb 100644 --- a/assets/js/main.d6668cb6.js +++ b/assets/js/main.2386e6b6.js @@ -1,2 +1,2 @@ -/*! For license information please see main.d6668cb6.js.LICENSE.txt */ -(self.webpackChunkdefang_docs=self.webpackChunkdefang_docs||[]).push([[1590],{628:(e,t,n)=>{"use strict";n.d(t,{c:()=>p});n(1504);var r=n(8852),o=n.n(r),a=n(4504);const i={"0097bd4c":[()=>n.e(8936).then(n.bind(n,2984)),"@site/docs/concepts/resources.md",2984],"00e45465":[()=>n.e(8608).then(n.bind(n,2795)),"@site/docs/getting-started/authenticating.md",2795],"015126ef":[()=>n.e(2304).then(n.t.bind(n,9624,19)),"~blog/default/blog-tags-aws-4f8.json",9624],"01a85c17":[()=>Promise.all([n.e(2176),n.e(8412)]).then(n.bind(n,3024)),"@theme/BlogTagsListPage",3024],"02dae591":[()=>n.e(5176).then(n.t.bind(n,9312,19)),"~blog/default/blog-tags-aws-4f8-list.json",9312],"0341194c":[()=>n.e(8636).then(n.bind(n,6552)),"@site/docs/getting-started/monitor.md",6552],"0480b142":[()=>n.e(5277).then(n.bind(n,8640)),"@site/docs/faq.md",8640],"054d460f":[()=>n.e(8132).then(n.bind(n,2652)),"@site/src/pages/docs.tsx",2652],"0e384e19":[()=>n.e(6328).then(n.bind(n,9404)),"@site/docs/intro.md",9404],"10a686b8":[()=>n.e(1144).then(n.bind(n,9044)),"@site/docs/tutorials/deploy-code-compose.mdx",9044],"14eb3368":[()=>Promise.all([n.e(2176),n.e(9576)]).then(n.bind(n,6248)),"@theme/DocCategoryGeneratedIndexPage",6248],"15bf1199":[()=>n.e(3797).then(n.bind(n,3736)),"@site/docs/concepts/ai.md",3736],17896441:[()=>Promise.all([n.e(2176),n.e(7472),n.e(6752)]).then(n.bind(n,104)),"@theme/DocItem",104],"1cda7ed0":[()=>n.e(444).then(n.bind(n,8248)),"@site/docs/concepts/defang-byoc.md",8248],"1df93b7f":[()=>n.e(8552).then(n.bind(n,9396)),"@site/src/pages/index.tsx",9396],"1faab2ed":[()=>n.e(3292).then(n.bind(n,4364)),"@site/docs/concepts/deployments.md",4364],"27026ce7":[()=>n.e(1204).then(n.t.bind(n,8163,19)),"~blog/default/blog-tags-generative-ai-340.json",8163],"275a6541":[()=>n.e(6172).then(n.bind(n,5280)),"@site/docs/providers/azure.md",5280],"292f356a":[()=>n.e(7964).then(n.t.bind(n,8664,19)),"~blog/default/blog-tags-no-dev-ops-6c4-list.json",8664],"3ed61fc5":[()=>n.e(7912).then(n.bind(n,2188)),"@site/docs/getting-started/installing.md",2188],44549577:[()=>n.e(8736).then(n.bind(n,5700)),"@site/docs/concepts/services.md",5700],"452cbd2b":[()=>n.e(2072).then(n.bind(n,2588)),"@site/docs/concepts/accounts.md",2588],45692823:[()=>n.e(232).then(n.bind(n,4012)),"@site/docs/concepts/security.md",4012],48914889:[()=>Promise.all([n.e(8036),n.e(3372)]).then(n.bind(n,4104)),"@site/docs/samples.md",4104],"48c1143d":[()=>n.e(3704).then(n.bind(n,5868)),"@site/docs/concepts/compose.md",5868],"50100fe2":[()=>Promise.all([n.e(2176),n.e(3136)]).then(n.bind(n,708)),"@site/docs/concepts/pulumi.md",708],"55ffee55":[()=>n.e(8336).then(n.bind(n,776)),"@site/docs/concepts/observability.md",776],"57228d2a":[()=>n.e(9168).then(n.t.bind(n,2080,19)),"/home/runner/work/defang-docs/defang-docs/.docusaurus/docusaurus-plugin-content-docs/default/plugin-route-context-module-100.json",2080],"596d4ebd":[()=>n.e(9978).then(n.bind(n,4148)),"@site/docs/providers/gcp.md",4148],"598340dd":[()=>n.e(304).then(n.t.bind(n,895,19)),"~blog/default/blog-tags-no-dev-ops-6c4.json",895],"5bf48768":[()=>n.e(8168).then(n.bind(n,6700)),"@site/docs/concepts/secrets.md",6700],"5e95c892":[()=>n.e(4304).then(n.bind(n,3564)),"@theme/DocsRoot",3564],"5e9f5e1a":[()=>Promise.resolve().then(n.bind(n,7768)),"@generated/docusaurus.config",7768],"63384ed2":[()=>n.e(9922).then(n.bind(n,7388)),"@site/docs/getting-started/getting-started.md",7388],"6875c492":[()=>Promise.all([n.e(2176),n.e(7472),n.e(606),n.e(2392)]).then(n.bind(n,2948)),"@theme/BlogTagsPostsPage",2948],"706c2971":[()=>n.e(7616).then(n.bind(n,1676)),"@site/docs/use-cases/use-cases.md",1676],"709d119d":[()=>n.e(4472).then(n.bind(n,3636)),"@site/blog/2024-02-12-announcing-defang-public-beta.md?truncated=true",3636],"814f3328":[()=>n.e(5512).then(n.t.bind(n,4352,19)),"~blog/default/blog-post-list-prop-default.json",4352],"8487ea16":[()=>n.e(920).then(n.bind(n,1956)),"@site/docs/concepts/defang-playground.md",1956],"857c1664":[()=>n.e(8908).then(n.t.bind(n,9088,19)),"~blog/default/blog-tags-byoc-af4.json",9088],"935f2afb":[()=>n.e(5696).then(n.t.bind(n,5988,19)),"~docs/default/version-current-metadata-prop-751.json",5988],"980f8111":[()=>n.e(1516).then(n.bind(n,5884)),"@site/docs/tutorials/deploy-using-pulumi.mdx",5884],"9c7a4702":[()=>Promise.all([n.e(2176),n.e(7024)]).then(n.bind(n,532)),"@site/docs/concepts/networking.mdx",532],"9e4087bc":[()=>n.e(7028).then(n.bind(n,6140)),"@theme/BlogArchivePage",6140],a6aa9e1f:[()=>Promise.all([n.e(2176),n.e(7472),n.e(606),n.e(4976)]).then(n.bind(n,4328)),"@theme/BlogListPage",4328],a7023ddc:[()=>n.e(9112).then(n.t.bind(n,1568,19)),"~blog/default/blog-tags-tags-4c2.json",1568],a7bd4aaa:[()=>n.e(6500).then(n.bind(n,2e3)),"@theme/DocVersionRoot",2e3],a86eff0c:[()=>n.e(3635).then(n.t.bind(n,3456,19)),"~blog/default/blog-tags-byoc-af4-list.json",3456],a94703ab:[()=>Promise.all([n.e(2176),n.e(4666)]).then(n.bind(n,996)),"@theme/DocRoot",996],aaa8c21e:[()=>n.e(8668).then(n.bind(n,9364)),"@site/docs/getting-started/build-and-deploy.md",9364],ac8a6a5b:[()=>n.e(5160).then(n.bind(n,9636)),"@site/docs/tutorials/generate-new-code-using-ai.mdx",9636],b0dc3a73:[()=>n.e(9160).then(n.t.bind(n,5872,19)),"~docs/default/category-docs-docssidebar-category-providers-57b.json",5872],b1513dc1:[()=>n.e(5528).then(n.t.bind(n,2624,19)),"~blog/default/blog-tags-cloud-d01-list.json",2624],b2b675dd:[()=>n.e(6292).then(n.t.bind(n,6180,19)),"~blog/default/blog-c06.json",6180],b2f554cd:[()=>n.e(6880).then(n.t.bind(n,8256,19)),"~blog/default/blog-archive-80c.json",8256],b99569e0:[()=>n.e(2616).then(n.bind(n,4388)),"@site/docs/providers/aws.md",4388],bba3f49c:[()=>n.e(7176).then(n.t.bind(n,6792,19)),"/home/runner/work/defang-docs/defang-docs/.docusaurus/docusaurus-plugin-content-blog/default/plugin-route-context-module-100.json",6792],c18dada4:[()=>n.e(9524).then(n.bind(n,7120)),"@site/docs/tutorials/deploy-container-using-the-cli.mdx",7120],caf24779:[()=>n.e(5024).then(n.t.bind(n,9502,19)),"~blog/default/blog-tags-generative-ai-340-list.json",9502],ccc49370:[()=>Promise.all([n.e(2176),n.e(7472),n.e(606),n.e(6344)]).then(n.bind(n,8320)),"@theme/BlogPostPage",8320],cd8849b9:[()=>n.e(180).then(n.t.bind(n,590,19)),"/home/runner/work/defang-docs/defang-docs/.docusaurus/docusaurus-plugin-content-pages/default/plugin-route-context-module-100.json",590],d07f7b52:[()=>n.e(5128).then(n.bind(n,3652)),"@site/blog/2024-02-12-announcing-defang-public-beta.md",3652],db1fbb7d:[()=>n.e(7792).then(n.t.bind(n,6652,19)),"~docs/default/category-docs-docssidebar-category-concepts-89b.json",6652],dba64712:[()=>n.e(3296).then(n.t.bind(n,3984,19)),"~docs/default/category-docs-docssidebar-category-tutorials-f46.json",3984],ddd66c52:[()=>n.e(308).then(n.bind(n,8188)),"@site/blog/2023-06-29-Announcing-the-Private-Beta-for-the-DOP.md",8188],eb08e5ec:[()=>n.e(3768).then(n.bind(n,7460)),"@site/docs/getting-started/update.md",7460],f1e9199e:[()=>n.e(9456).then(n.bind(n,5688)),"@site/blog/2023-06-29-Announcing-the-Private-Beta-for-the-DOP.md?truncated=true",5688],f2c7afce:[()=>n.e(9772).then(n.bind(n,512)),"@site/docs/concepts/portal.md",512],f3543915:[()=>n.e(6152).then(n.t.bind(n,4120,19)),"~blog/default/blog-tags-cloud-d01.json",4120],f35e2962:[()=>n.e(388).then(n.bind(n,9548)),"@site/docs/concepts/configuration.md",9548]};var l=n(7624);function s(e){let{error:t,retry:n,pastDelay:r}=e;return t?(0,l.jsxs)("div",{style:{textAlign:"center",color:"#fff",backgroundColor:"#fa383e",borderColor:"#fa383e",borderStyle:"solid",borderRadius:"0.25rem",borderWidth:"1px",boxSizing:"border-box",display:"block",padding:"1rem",flex:"0 0 50%",marginLeft:"25%",marginRight:"25%",marginTop:"5rem",maxWidth:"50%",width:"100%"},children:[(0,l.jsx)("p",{children:String(t)}),(0,l.jsx)("div",{children:(0,l.jsx)("button",{type:"button",onClick:n,children:"Retry"})})]}):r?(0,l.jsx)("div",{style:{display:"flex",justifyContent:"center",alignItems:"center",height:"100vh"},children:(0,l.jsx)("svg",{id:"loader",style:{width:128,height:110,position:"absolute",top:"calc(100vh - 64%)"},viewBox:"0 0 45 45",xmlns:"http://www.w3.org/2000/svg",stroke:"#61dafb",children:(0,l.jsxs)("g",{fill:"none",fillRule:"evenodd",transform:"translate(1 1)",strokeWidth:"2",children:[(0,l.jsxs)("circle",{cx:"22",cy:"22",r:"6",strokeOpacity:"0",children:[(0,l.jsx)("animate",{attributeName:"r",begin:"1.5s",dur:"3s",values:"6;22",calcMode:"linear",repeatCount:"indefinite"}),(0,l.jsx)("animate",{attributeName:"stroke-opacity",begin:"1.5s",dur:"3s",values:"1;0",calcMode:"linear",repeatCount:"indefinite"}),(0,l.jsx)("animate",{attributeName:"stroke-width",begin:"1.5s",dur:"3s",values:"2;0",calcMode:"linear",repeatCount:"indefinite"})]}),(0,l.jsxs)("circle",{cx:"22",cy:"22",r:"6",strokeOpacity:"0",children:[(0,l.jsx)("animate",{attributeName:"r",begin:"3s",dur:"3s",values:"6;22",calcMode:"linear",repeatCount:"indefinite"}),(0,l.jsx)("animate",{attributeName:"stroke-opacity",begin:"3s",dur:"3s",values:"1;0",calcMode:"linear",repeatCount:"indefinite"}),(0,l.jsx)("animate",{attributeName:"stroke-width",begin:"3s",dur:"3s",values:"2;0",calcMode:"linear",repeatCount:"indefinite"})]}),(0,l.jsx)("circle",{cx:"22",cy:"22",r:"8",children:(0,l.jsx)("animate",{attributeName:"r",begin:"0s",dur:"1.5s",values:"6;1;2;3;4;5;6",calcMode:"linear",repeatCount:"indefinite"})})]})})}):null}var c=n(8120),u=n(5548);function d(e,t){if("*"===e)return o()({loading:s,loader:()=>n.e(4552).then(n.bind(n,4552)),modules:["@theme/NotFound"],webpack:()=>[4552],render(e,t){const n=e.default;return(0,l.jsx)(u.Y,{value:{plugin:{name:"native",id:"default"}},children:(0,l.jsx)(n,{...t})})}});const r=a[`${e}-${t}`],d={},p=[],f=[],g=(0,c.c)(r);return Object.entries(g).forEach((e=>{let[t,n]=e;const r=i[n];r&&(d[t]=r[0],p.push(r[1]),f.push(r[2]))})),o().Map({loading:s,loader:d,modules:p,webpack:()=>f,render(t,n){const o=JSON.parse(JSON.stringify(r));Object.entries(t).forEach((t=>{let[n,r]=t;const a=r.default;if(!a)throw new Error(`The page component at ${e} doesn't have a default export. This makes it impossible to render anything. Consider default-exporting a React component.`);"object"!=typeof a&&"function"!=typeof a||Object.keys(r).filter((e=>"default"!==e)).forEach((e=>{a[e]=r[e]}));let i=o;const l=n.split(".");l.slice(0,-1).forEach((e=>{i=i[e]})),i[l[l.length-1]]=a}));const a=o.__comp;delete o.__comp;const i=o.__context;return delete o.__context,(0,l.jsx)(u.Y,{value:i,children:(0,l.jsx)(a,{...o,...n})})}})}const p=[{path:"/blog",component:d("/blog","284"),exact:!0},{path:"/blog/announcement",component:d("/blog/announcement","aff"),exact:!0},{path:"/blog/announcing-defang-public-beta",component:d("/blog/announcing-defang-public-beta","e39"),exact:!0},{path:"/blog/archive",component:d("/blog/archive","ad6"),exact:!0},{path:"/blog/tags",component:d("/blog/tags","78c"),exact:!0},{path:"/blog/tags/aws",component:d("/blog/tags/aws","453"),exact:!0},{path:"/blog/tags/byoc",component:d("/blog/tags/byoc","2a5"),exact:!0},{path:"/blog/tags/cloud",component:d("/blog/tags/cloud","e5e"),exact:!0},{path:"/blog/tags/generative-ai",component:d("/blog/tags/generative-ai","766"),exact:!0},{path:"/blog/tags/no-dev-ops",component:d("/blog/tags/no-dev-ops","883"),exact:!0},{path:"/docs",component:d("/docs","9c2"),exact:!0},{path:"/docs",component:d("/docs","706"),routes:[{path:"/docs",component:d("/docs","4bc"),routes:[{path:"/docs",component:d("/docs","119"),routes:[{path:"/docs/category/concepts",component:d("/docs/category/concepts","803"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/category/providers",component:d("/docs/category/providers","639"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/category/tutorials",component:d("/docs/category/tutorials","126"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/concepts/accounts",component:d("/docs/concepts/accounts","6a3"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/concepts/ai",component:d("/docs/concepts/ai","713"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/concepts/compose",component:d("/docs/concepts/compose","439"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/concepts/configuration",component:d("/docs/concepts/configuration","d18"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/concepts/defang-byoc",component:d("/docs/concepts/defang-byoc","c29"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/concepts/defang-playground",component:d("/docs/concepts/defang-playground","35f"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/concepts/deployments",component:d("/docs/concepts/deployments","fc1"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/concepts/networking",component:d("/docs/concepts/networking","c65"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/concepts/observability",component:d("/docs/concepts/observability","014"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/concepts/portal",component:d("/docs/concepts/portal","71d"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/concepts/pulumi",component:d("/docs/concepts/pulumi","f69"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/concepts/resources",component:d("/docs/concepts/resources","d13"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/concepts/secrets",component:d("/docs/concepts/secrets","51f"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/concepts/security",component:d("/docs/concepts/security","8a6"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/concepts/services",component:d("/docs/concepts/services","568"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/faq",component:d("/docs/faq","76c"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/getting-started",component:d("/docs/getting-started","301"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/getting-started/authenticating",component:d("/docs/getting-started/authenticating","541"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/getting-started/build-and-deploy",component:d("/docs/getting-started/build-and-deploy","274"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/getting-started/installing",component:d("/docs/getting-started/installing","6f5"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/getting-started/monitor",component:d("/docs/getting-started/monitor","0df"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/getting-started/update",component:d("/docs/getting-started/update","0c4"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/intro",component:d("/docs/intro","f79"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/providers/aws",component:d("/docs/providers/aws","ab7"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/providers/azure",component:d("/docs/providers/azure","d47"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/providers/gcp",component:d("/docs/providers/gcp","11a"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/samples",component:d("/docs/samples","267"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/tutorials/deploy-code-compose",component:d("/docs/tutorials/deploy-code-compose","242"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/tutorials/deploy-container-using-the-cli",component:d("/docs/tutorials/deploy-container-using-the-cli","24c"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/tutorials/deploy-using-pulumi",component:d("/docs/tutorials/deploy-using-pulumi","965"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/tutorials/generate-new-code-using-ai",component:d("/docs/tutorials/generate-new-code-using-ai","dc4"),exact:!0,sidebar:"docsSidebar"},{path:"/docs/use-cases",component:d("/docs/use-cases","c81"),exact:!0,sidebar:"docsSidebar"}]}]}]},{path:"/",component:d("/","e3a"),exact:!0},{path:"*",component:d("*")}]},240:(e,t,n)=>{"use strict";n.d(t,{e:()=>a,g:()=>i});var r=n(1504),o=n(7624);const a=r.createContext(!1);function i(e){let{children:t}=e;const[n,i]=(0,r.useState)(!1);return(0,r.useEffect)((()=>{i(!0)}),[]),(0,o.jsx)(a.Provider,{value:n,children:t})}},8808:(e,t,n)=>{"use strict";var r=n(1504),o=n(8352),a=n(440),i=n(2160),l=n(8684);const s=[n(1462),n(5396),n(9596),n(1496)];var c=n(628),u=n(5592),d=n(5464),p=n(7624);function f(e){let{children:t}=e;return(0,p.jsx)(p.Fragment,{children:t})}var g=n(6952),m=n(8264),h=n(964),y=n(1824),b=n(5756),v=n(1616),w=n(204),k=n(4456),x=n(5684),S=n(8712);function E(){const{i18n:{currentLocale:e,defaultLocale:t,localeConfigs:n}}=(0,m.c)(),r=(0,v.D)(),o=n[e].htmlLang,a=e=>e.replace("-","_");return(0,p.jsxs)(g.c,{children:[Object.entries(n).map((e=>{let[t,{htmlLang:n}]=e;return(0,p.jsx)("link",{rel:"alternate",href:r.createUrl({locale:t,fullyQualified:!0}),hrefLang:n},t)})),(0,p.jsx)("link",{rel:"alternate",href:r.createUrl({locale:t,fullyQualified:!0}),hrefLang:"x-default"}),(0,p.jsx)("meta",{property:"og:locale",content:a(o)}),Object.values(n).filter((e=>o!==e.htmlLang)).map((e=>(0,p.jsx)("meta",{property:"og:locale:alternate",content:a(e.htmlLang)},`meta-og-${e.htmlLang}`)))]})}function C(e){let{permalink:t}=e;const{siteConfig:{url:n}}=(0,m.c)(),r=function(){const{siteConfig:{url:e,baseUrl:t,trailingSlash:n}}=(0,m.c)(),{pathname:r}=(0,u.IT)();return e+(0,x.applyTrailingSlash)((0,h.c)(r),{trailingSlash:n,baseUrl:t})}(),o=t?`${n}${t}`:r;return(0,p.jsxs)(g.c,{children:[(0,p.jsx)("meta",{property:"og:url",content:o}),(0,p.jsx)("link",{rel:"canonical",href:o})]})}function _(){const{i18n:{currentLocale:e}}=(0,m.c)(),{metadata:t,image:n}=(0,y.y)();return(0,p.jsxs)(p.Fragment,{children:[(0,p.jsxs)(g.c,{children:[(0,p.jsx)("meta",{name:"twitter:card",content:"summary_large_image"}),(0,p.jsx)("body",{className:w.m})]}),n&&(0,p.jsx)(b.U7,{image:n}),(0,p.jsx)(C,{}),(0,p.jsx)(E,{}),(0,p.jsx)(S.c,{tag:k.e6,locale:e}),(0,p.jsx)(g.c,{children:t.map(((e,t)=>(0,p.jsx)("meta",{...e},t)))})]})}const T=new Map;function j(e){if(T.has(e.pathname))return{...e,pathname:T.get(e.pathname)};if((0,d.C)(c.c,e.pathname).some((e=>{let{route:t}=e;return!0===t.exact})))return T.set(e.pathname,e.pathname),e;const t=e.pathname.trim().replace(/(?:\/index)?\.html$/,"")||"/";return T.set(e.pathname,t),{...e,pathname:t}}var N=n(240),A=n(136),R=n(5288);function L(e){for(var t=arguments.length,n=new Array(t>1?t-1:0),r=1;r{const r=t.default?.[e]??t[e];return r?.(...n)}));return()=>o.forEach((e=>e?.()))}const P=function(e){let{children:t,location:n,previousLocation:r}=e;return(0,R.c)((()=>{r!==n&&(!function(e){let{location:t,previousLocation:n}=e;if(!n)return;const r=t.pathname===n.pathname,o=t.hash===n.hash,a=t.search===n.search;if(r&&o&&!a)return;const{hash:i}=t;if(i){const e=decodeURIComponent(i.substring(1)),t=document.getElementById(e);t?.scrollIntoView()}else window.scrollTo(0,0)}({location:n,previousLocation:r}),L("onRouteDidUpdate",{previousLocation:r,location:n}))}),[r,n]),t};function O(e){const t=Array.from(new Set([e,decodeURI(e)])).map((e=>(0,d.C)(c.c,e))).flat();return Promise.all(t.map((e=>e.route.component.preload?.())))}class I extends r.Component{previousLocation;routeUpdateCleanupCb;constructor(e){super(e),this.previousLocation=null,this.routeUpdateCleanupCb=l.c.canUseDOM?L("onRouteUpdate",{previousLocation:null,location:this.props.location}):()=>{},this.state={nextRouteHasLoaded:!0}}shouldComponentUpdate(e,t){if(e.location===this.props.location)return t.nextRouteHasLoaded;const n=e.location;return this.previousLocation=this.props.location,this.setState({nextRouteHasLoaded:!1}),this.routeUpdateCleanupCb=L("onRouteUpdate",{previousLocation:this.previousLocation,location:n}),O(n.pathname).then((()=>{this.routeUpdateCleanupCb(),this.setState({nextRouteHasLoaded:!0})})).catch((e=>{console.warn(e),window.location.reload()})),!1}render(){const{children:e,location:t}=this.props;return(0,p.jsx)(P,{previousLocation:this.previousLocation,location:t,children:(0,p.jsx)(u.kX,{location:t,render:()=>e})})}}const D=I,M="__docusaurus-base-url-issue-banner-container",F="__docusaurus-base-url-issue-banner",z="__docusaurus-base-url-issue-banner-suggestion-container";function B(e){return`\ndocument.addEventListener('DOMContentLoaded', function maybeInsertBanner() {\n var shouldInsert = typeof window['docusaurus'] === 'undefined';\n shouldInsert && insertBanner();\n});\n\nfunction insertBanner() {\n var bannerContainer = document.createElement('div');\n bannerContainer.id = '${M}';\n var bannerHtml = ${JSON.stringify(function(e){return`\n
\n

Your Docusaurus site did not load properly.

\n

A very common reason is a wrong site baseUrl configuration.

\n

Current configured baseUrl = ${e} ${"/"===e?" (default value)":""}

\n

We suggest trying baseUrl =

\n
\n`}(e)).replace(/{if("undefined"==typeof document)return void n();const r=document.createElement("link");r.setAttribute("rel","prefetch"),r.setAttribute("href",e),r.onload=()=>t(),r.onerror=()=>n();const o=document.getElementsByTagName("head")[0]??document.getElementsByName("script")[0]?.parentNode;o?.appendChild(r)}))}:function(e){return new Promise(((t,n)=>{const r=new XMLHttpRequest;r.open("GET",e,!0),r.withCredentials=!0,r.onload=()=>{200===r.status?t():n()},r.send(null)}))};var K=n(8120);const Z=new Set,J=new Set,X=()=>navigator.connection?.effectiveType.includes("2g")||navigator.connection?.saveData,ee={prefetch(e){if(!(e=>!X()&&!J.has(e)&&!Z.has(e))(e))return!1;Z.add(e);const t=(0,d.C)(c.c,e).flatMap((e=>{return t=e.route.path,Object.entries(Q).filter((e=>{let[n]=e;return n.replace(/-[^-]+$/,"")===t})).flatMap((e=>{let[,t]=e;return Object.values((0,K.c)(t))}));var t}));return Promise.all(t.map((e=>{const t=n.gca(e);return t&&!t.includes("undefined")?Y(t).catch((()=>{})):Promise.resolve()})))},preload:e=>!!(e=>!X()&&!J.has(e))(e)&&(J.add(e),O(e))},te=Object.freeze(ee),ne=Boolean(!0);if(l.c.canUseDOM){window.docusaurus=te;const e=document.getElementById("__docusaurus"),t=(0,p.jsx)(i.EN,{children:(0,p.jsx)(a.kn,{children:(0,p.jsx)(V,{})})}),n=(e,t)=>{console.error("Docusaurus React Root onRecoverableError:",e,t)},l=()=>{if(ne)r.startTransition((()=>{o.hydrateRoot(e,t,{onRecoverableError:n})}));else{const a=o.createRoot(e,{onRecoverableError:n});r.startTransition((()=>{a.render(t)}))}};O(window.location.pathname).then(l)}},136:(e,t,n)=>{"use strict";n.d(t,{e:()=>d,y:()=>p});var r=n(1504),o=n(7768);const a=JSON.parse('{"docusaurus-lunr-search":{"default":{"fileNames":{"searchDoc":"search-doc-1707951005272.json","lunrIndex":"lunr-index-1707951005272.json"}}},"docusaurus-plugin-content-docs":{"default":{"path":"/docs","versions":[{"name":"current","label":"Next","isLast":true,"path":"/docs","mainDocId":"intro","docs":[{"id":"concepts/accounts","path":"/docs/concepts/accounts","sidebar":"docsSidebar"},{"id":"concepts/ai","path":"/docs/concepts/ai","sidebar":"docsSidebar"},{"id":"concepts/compose","path":"/docs/concepts/compose","sidebar":"docsSidebar"},{"id":"concepts/configuration","path":"/docs/concepts/configuration","sidebar":"docsSidebar"},{"id":"concepts/defang-byoc","path":"/docs/concepts/defang-byoc","sidebar":"docsSidebar"},{"id":"concepts/defang-playground","path":"/docs/concepts/defang-playground","sidebar":"docsSidebar"},{"id":"concepts/deployments","path":"/docs/concepts/deployments","sidebar":"docsSidebar"},{"id":"concepts/networking","path":"/docs/concepts/networking","sidebar":"docsSidebar"},{"id":"concepts/observability","path":"/docs/concepts/observability","sidebar":"docsSidebar"},{"id":"concepts/portal","path":"/docs/concepts/portal","sidebar":"docsSidebar"},{"id":"concepts/pulumi","path":"/docs/concepts/pulumi","sidebar":"docsSidebar"},{"id":"concepts/resources","path":"/docs/concepts/resources","sidebar":"docsSidebar"},{"id":"concepts/secrets","path":"/docs/concepts/secrets","sidebar":"docsSidebar"},{"id":"concepts/security","path":"/docs/concepts/security","sidebar":"docsSidebar"},{"id":"concepts/services","path":"/docs/concepts/services","sidebar":"docsSidebar"},{"id":"faq","path":"/docs/faq","sidebar":"docsSidebar"},{"id":"getting-started/authenticating","path":"/docs/getting-started/authenticating","sidebar":"docsSidebar"},{"id":"getting-started/build-and-deploy","path":"/docs/getting-started/build-and-deploy","sidebar":"docsSidebar"},{"id":"getting-started/getting-started","path":"/docs/getting-started/","sidebar":"docsSidebar"},{"id":"getting-started/installing","path":"/docs/getting-started/installing","sidebar":"docsSidebar"},{"id":"getting-started/monitor","path":"/docs/getting-started/monitor","sidebar":"docsSidebar"},{"id":"getting-started/update","path":"/docs/getting-started/update","sidebar":"docsSidebar"},{"id":"intro","path":"/docs/intro","sidebar":"docsSidebar"},{"id":"providers/aws","path":"/docs/providers/aws","sidebar":"docsSidebar"},{"id":"providers/azure","path":"/docs/providers/azure","sidebar":"docsSidebar"},{"id":"providers/gcp","path":"/docs/providers/gcp","sidebar":"docsSidebar"},{"id":"samples","path":"/docs/samples","sidebar":"docsSidebar"},{"id":"tutorials/deploy-code-compose","path":"/docs/tutorials/deploy-code-compose","sidebar":"docsSidebar"},{"id":"tutorials/deploy-container-using-the-cli","path":"/docs/tutorials/deploy-container-using-the-cli","sidebar":"docsSidebar"},{"id":"tutorials/deploy-using-pulumi","path":"/docs/tutorials/deploy-using-pulumi","sidebar":"docsSidebar"},{"id":"tutorials/generate-new-code-using-ai","path":"/docs/tutorials/generate-new-code-using-ai","sidebar":"docsSidebar"},{"id":"use-cases/use-cases","path":"/docs/use-cases/","sidebar":"docsSidebar"},{"id":"/category/concepts","path":"/docs/category/concepts","sidebar":"docsSidebar"},{"id":"/category/providers","path":"/docs/category/providers","sidebar":"docsSidebar"},{"id":"/category/tutorials","path":"/docs/category/tutorials","sidebar":"docsSidebar"}],"draftIds":[],"sidebars":{"docsSidebar":{"link":{"path":"/docs/intro","label":"intro"}}}}],"breadcrumbs":true}}}'),i=JSON.parse('{"defaultLocale":"en","locales":["en"],"path":"i18n","currentLocale":"en","localeConfigs":{"en":{"label":"English","direction":"ltr","htmlLang":"en","calendar":"gregory","path":"en"}}}');var l=n(144);const s=JSON.parse('{"docusaurusVersion":"3.0.0","siteVersion":"0.0.0","pluginVersions":{"docusaurus-plugin-content-docs":{"type":"package","name":"@docusaurus/plugin-content-docs","version":"3.0.0"},"docusaurus-plugin-content-blog":{"type":"package","name":"@docusaurus/plugin-content-blog","version":"3.0.0"},"docusaurus-plugin-content-pages":{"type":"package","name":"@docusaurus/plugin-content-pages","version":"3.0.0"},"docusaurus-plugin-sitemap":{"type":"package","name":"@docusaurus/plugin-sitemap","version":"3.0.0"},"docusaurus-theme-classic":{"type":"package","name":"@docusaurus/theme-classic","version":"3.0.0"},"docusaurus-lunr-search":{"type":"package","name":"docusaurus-lunr-search","version":"3.3.2"}}}');var c=n(7624);const u={siteConfig:o.default,siteMetadata:s,globalData:a,i18n:i,codeTranslations:l},d=r.createContext(u);function p(e){let{children:t}=e;return(0,c.jsx)(d.Provider,{value:u,children:t})}},5852:(e,t,n)=>{"use strict";n.d(t,{c:()=>f});var r=n(1504),o=n(8684),a=n(6952),i=n(5684),l=n(4820),s=n(7624);function c(e){let{error:t,tryAgain:n}=e;return(0,s.jsxs)("div",{style:{display:"flex",flexDirection:"column",justifyContent:"center",alignItems:"flex-start",minHeight:"100vh",width:"100%",maxWidth:"80ch",fontSize:"20px",margin:"0 auto",padding:"1rem"},children:[(0,s.jsx)("h1",{style:{fontSize:"3rem"},children:"This page crashed"}),(0,s.jsx)("button",{type:"button",onClick:n,style:{margin:"1rem 0",fontSize:"2rem",cursor:"pointer",borderRadius:20,padding:"1rem"},children:"Try again"}),(0,s.jsx)(u,{error:t})]})}function u(e){let{error:t}=e;const n=(0,i.getErrorCausalChain)(t).map((e=>e.message)).join("\n\nCause:\n");return(0,s.jsx)("p",{style:{whiteSpace:"pre-wrap"},children:n})}function d(e){let{error:t,tryAgain:n}=e;return(0,s.jsxs)(f,{fallback:()=>(0,s.jsx)(c,{error:t,tryAgain:n}),children:[(0,s.jsx)(a.c,{children:(0,s.jsx)("title",{children:"Page Error"})}),(0,s.jsx)(l.c,{children:(0,s.jsx)(c,{error:t,tryAgain:n})})]})}const p=e=>(0,s.jsx)(d,{...e});class f extends r.Component{constructor(e){super(e),this.state={error:null}}componentDidCatch(e){o.c.canUseDOM&&this.setState({error:e})}render(){const{children:e}=this.props,{error:t}=this.state;if(t){const e={error:t,tryAgain:()=>this.setState({error:null})};return(this.props.fallback??p)(e)}return e??null}}},8684:(e,t,n)=>{"use strict";n.d(t,{c:()=>o});const r="undefined"!=typeof window&&"document"in window&&"createElement"in window.document,o={canUseDOM:r,canUseEventListeners:r&&("addEventListener"in window||"attachEvent"in window),canUseIntersectionObserver:r&&"IntersectionObserver"in window,canUseViewport:r&&"screen"in window}},6952:(e,t,n)=>{"use strict";n.d(t,{c:()=>a});n(1504);var r=n(2160),o=n(7624);function a(e){return(0,o.jsx)(r.So,{...e})}},6016:(e,t,n)=>{"use strict";n.d(t,{c:()=>f});var r=n(1504),o=n(440),a=n(5684),i=n(8264),l=n(8136),s=n(8684),c=n(7624);const u=r.createContext({collectLink:()=>{}});var d=n(964);function p(e,t){let{isNavLink:n,to:p,href:f,activeClassName:g,isActive:m,"data-noBrokenLinkCheck":h,autoAddBaseUrl:y=!0,...b}=e;const{siteConfig:{trailingSlash:v,baseUrl:w}}=(0,i.c)(),{withBaseUrl:k}=(0,d.E)(),x=(0,r.useContext)(u),S=(0,r.useRef)(null);(0,r.useImperativeHandle)(t,(()=>S.current));const E=p||f;const C=(0,l.c)(E),_=E?.replace("pathname://","");let T=void 0!==_?(j=_,y&&(e=>e.startsWith("/"))(j)?k(j):j):void 0;var j;T&&C&&(T=(0,a.applyTrailingSlash)(T,{trailingSlash:v,baseUrl:w}));const N=(0,r.useRef)(!1),A=n?o.Af:o.cH,R=s.c.canUseIntersectionObserver,L=(0,r.useRef)(),P=()=>{N.current||null==T||(window.docusaurus.preload(T),N.current=!0)};(0,r.useEffect)((()=>(!R&&C&&null!=T&&window.docusaurus.prefetch(T),()=>{R&&L.current&&L.current.disconnect()})),[L,T,R,C]);const O=T?.startsWith("#")??!1,I=!T||!C||O;return I||h||x.collectLink(T),I?(0,c.jsx)("a",{ref:S,href:T,...E&&!C&&{target:"_blank",rel:"noopener noreferrer"},...b}):(0,c.jsx)(A,{...b,onMouseEnter:P,onTouchStart:P,innerRef:e=>{S.current=e,R&&e&&C&&(L.current=new window.IntersectionObserver((t=>{t.forEach((t=>{e===t.target&&(t.isIntersecting||t.intersectionRatio>0)&&(L.current.unobserve(e),L.current.disconnect(),null!=T&&window.docusaurus.prefetch(T))}))})),L.current.observe(e))},to:T,...n&&{isActive:m,activeClassName:g}})}const f=r.forwardRef(p)},4357:(e,t,n)=>{"use strict";n.d(t,{c:()=>c,G:()=>s});var r=n(1504),o=n(7624);function a(e,t){const n=e.split(/(\{\w+\})/).map(((e,n)=>{if(n%2==1){const n=t?.[e.slice(1,-1)];if(void 0!==n)return n}return e}));return n.some((e=>(0,r.isValidElement)(e)))?n.map(((e,t)=>(0,r.isValidElement)(e)?r.cloneElement(e,{key:t}):e)).filter((e=>""!==e)):n.join("")}var i=n(144);function l(e){let{id:t,message:n}=e;if(void 0===t&&void 0===n)throw new Error("Docusaurus translation declarations must have at least a translation id or a default translation message");return i[t??n]??n??t}function s(e,t){let{message:n,id:r}=e;return a(l({message:n,id:r}),t)}function c(e){let{children:t,id:n,values:r}=e;if(t&&"string"!=typeof t)throw console.warn("Illegal children",t),new Error("The Docusaurus component only accept simple string values");const i=l({message:t,id:n});return(0,o.jsx)(o.Fragment,{children:a(i,r)})}},2488:(e,t,n)=>{"use strict";n.d(t,{M:()=>r});const r="default"},8136:(e,t,n)=>{"use strict";function r(e){return/^(?:\w*:|\/\/)/.test(e)}function o(e){return void 0!==e&&!r(e)}n.d(t,{_:()=>r,c:()=>o})},964:(e,t,n)=>{"use strict";n.d(t,{E:()=>i,c:()=>l});var r=n(1504),o=n(8264),a=n(8136);function i(){const{siteConfig:{baseUrl:e,url:t}}=(0,o.c)(),n=(0,r.useCallback)(((n,r)=>function(e,t,n,r){let{forcePrependBaseUrl:o=!1,absolute:i=!1}=void 0===r?{}:r;if(!n||n.startsWith("#")||(0,a._)(n))return n;if(o)return t+n.replace(/^\//,"");if(n===t.replace(/\/$/,""))return t;const l=n.startsWith(t)?n:t+n.replace(/^\//,"");return i?e+l:l}(t,e,n,r)),[t,e]);return{withBaseUrl:n}}function l(e,t){void 0===t&&(t={});const{withBaseUrl:n}=i();return n(e,t)}},8264:(e,t,n)=>{"use strict";n.d(t,{c:()=>a});var r=n(1504),o=n(136);function a(){return(0,r.useContext)(o.e)}},3160:(e,t,n)=>{"use strict";n.d(t,{MP:()=>i,mm:()=>a});var r=n(8264),o=n(2488);function a(e,t){void 0===t&&(t={});const n=function(){const{globalData:e}=(0,r.c)();return e}()[e];if(!n&&t.failfast)throw new Error(`Docusaurus plugin global data not found for "${e}" plugin.`);return n}function i(e,t,n){void 0===t&&(t=o.M),void 0===n&&(n={});const r=a(e),i=r?.[t];if(!i&&n.failfast)throw new Error(`Docusaurus plugin global data not found for "${e}" plugin with id "${t}".`);return i}},3664:(e,t,n)=>{"use strict";n.d(t,{c:()=>a});var r=n(1504),o=n(240);function a(){return(0,r.useContext)(o.e)}},5288:(e,t,n)=>{"use strict";n.d(t,{c:()=>o});var r=n(1504);const o=n(8684).c.canUseDOM?r.useLayoutEffect:r.useEffect},8120:(e,t,n)=>{"use strict";n.d(t,{c:()=>o});const r=e=>"object"==typeof e&&!!e&&Object.keys(e).length>0;function o(e){const t={};return function e(n,o){Object.entries(n).forEach((n=>{let[a,i]=n;const l=o?`${o}.${a}`:a;r(i)?e(i,l):t[l]=i}))}(e),t}},5548:(e,t,n)=>{"use strict";n.d(t,{Y:()=>i,e:()=>a});var r=n(1504),o=n(7624);const a=r.createContext(null);function i(e){let{children:t,value:n}=e;const i=r.useContext(a),l=(0,r.useMemo)((()=>function(e){let{parent:t,value:n}=e;if(!t){if(!n)throw new Error("Unexpected: no Docusaurus route context found");if(!("plugin"in n))throw new Error("Unexpected: Docusaurus topmost route context has no `plugin` attribute");return n}const r={...t.data,...n?.data};return{plugin:t.plugin,data:r}}({parent:i,value:n})),[i,n]);return(0,o.jsx)(a.Provider,{value:l,children:t})}},5172:(e,t,n)=>{"use strict";n.d(t,{wB:()=>f,UF:()=>u,L0:()=>s,i8:()=>g,OK:()=>c,aA:()=>p,gN:()=>d});var r=n(5592),o=n(3160);const a=e=>e.versions.find((e=>e.isLast));function i(e,t){const n=function(e,t){const n=a(e);return[...e.versions.filter((e=>e!==n)),n].find((e=>!!(0,r.ot)(t,{path:e.path,exact:!1,strict:!1})))}(e,t),o=n?.docs.find((e=>!!(0,r.ot)(t,{path:e.path,exact:!0,strict:!1})));return{activeVersion:n,activeDoc:o,alternateDocVersions:o?function(t){const n={};return e.versions.forEach((e=>{e.docs.forEach((r=>{r.id===t&&(n[e.name]=r)}))})),n}(o.id):{}}}const l={},s=()=>(0,o.mm)("docusaurus-plugin-content-docs")??l,c=e=>(0,o.MP)("docusaurus-plugin-content-docs",e,{failfast:!0});function u(e){void 0===e&&(e={});const t=s(),{pathname:n}=(0,r.IT)();return function(e,t,n){void 0===n&&(n={});const o=Object.entries(e).sort(((e,t)=>t[1].path.localeCompare(e[1].path))).find((e=>{let[,n]=e;return!!(0,r.ot)(t,{path:n.path,exact:!1,strict:!1})})),a=o?{pluginId:o[0],pluginData:o[1]}:void 0;if(!a&&n.failfast)throw new Error(`Can't find active docs plugin for "${t}" pathname, while it was expected to be found. Maybe you tried to use a docs feature that can only be used on a docs-related page? Existing docs plugin paths are: ${Object.values(e).map((e=>e.path)).join(", ")}`);return a}(t,n,e)}function d(e){return c(e).versions}function p(e){const t=c(e);return a(t)}function f(e){const t=c(e),{pathname:n}=(0,r.IT)();return i(t,n)}function g(e){const t=c(e),{pathname:n}=(0,r.IT)();return function(e,t){const n=a(e);return{latestDocSuggestion:i(e,t).alternateDocVersions[n.name],latestVersionSuggestion:n}}(t,n)}},9596:(e,t,n)=>{"use strict";n.r(t),n.d(t,{default:()=>a});var r=n(2272),o=n.n(r);o().configure({showSpinner:!1});const a={onRouteUpdate(e){let{location:t,previousLocation:n}=e;if(n&&t.pathname!==n.pathname){const e=window.setTimeout((()=>{o().start()}),200);return()=>window.clearTimeout(e)}},onRouteDidUpdate(){o().done()}}},5396:(e,t,n)=>{"use strict";n.r(t);var r=n(6756),o=n(7768);!function(e){const{themeConfig:{prism:t}}=o.default,{additionalLanguages:r}=t;globalThis.Prism=e,r.forEach((e=>{"php"===e&&n(1808),n(8660)(`./prism-${e}`)})),delete globalThis.Prism}(r.sp)},6448:(e,t,n)=>{"use strict";n.d(t,{c:()=>c});n(1504);var r=n(4971),o=n(4357),a=n(1824),i=n(6016);const l={anchorWithStickyNavbar:"anchorWithStickyNavbar_LWe7",anchorWithHideOnScrollNavbar:"anchorWithHideOnScrollNavbar_WYt5"};var s=n(7624);function c(e){let{as:t,id:n,...c}=e;const{navbar:{hideOnScroll:u}}=(0,a.y)();if("h1"===t||!n)return(0,s.jsx)(t,{...c,id:void 0});const d=(0,o.G)({id:"theme.common.headingLinkTitle",message:"Direct link to {heading}",description:"Title for link to heading"},{heading:"string"==typeof c.children?c.children:n});return(0,s.jsxs)(t,{...c,className:(0,r.c)("anchor",u?l.anchorWithHideOnScrollNavbar:l.anchorWithStickyNavbar,c.className),id:n,children:[c.children,(0,s.jsx)(i.c,{className:"hash-link",to:`#${n}`,"aria-label":d,title:d,children:"\u200b"})]})}},3232:(e,t,n)=>{"use strict";n.d(t,{c:()=>a});n(1504);const r={iconExternalLink:"iconExternalLink_nPIU"};var o=n(7624);function a(e){let{width:t=13.5,height:n=13.5}=e;return(0,o.jsx)("svg",{width:t,height:n,"aria-hidden":"true",viewBox:"0 0 24 24",className:r.iconExternalLink,children:(0,o.jsx)("path",{fill:"currentColor",d:"M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"})})}},8164:(e,t,n)=>{"use strict";n.d(t,{c:()=>u});n(1504);var r=n(6016),o=n(964),a=n(8264),i=n(1824),l=n(1964),s=n(7624);function c(e){let{logo:t,alt:n,imageClassName:r}=e;const a={light:(0,o.c)(t.src),dark:(0,o.c)(t.srcDark||t.src)},i=(0,s.jsx)(l.c,{className:t.className,sources:a,height:t.height,width:t.width,alt:n,style:t.style});return r?(0,s.jsx)("div",{className:r,children:i}):i}function u(e){const{siteConfig:{title:t}}=(0,a.c)(),{navbar:{title:n,logo:l}}=(0,i.y)(),{imageClassName:u,titleClassName:d,...p}=e,f=(0,o.c)(l?.href||"/"),g=n?"":t,m=l?.alt??g;return(0,s.jsxs)(r.c,{to:f,...p,...l?.target&&{target:l.target},children:[l&&(0,s.jsx)(c,{logo:l,alt:m,imageClassName:u}),null!=n&&(0,s.jsx)("b",{className:d,children:n})]})}},8712:(e,t,n)=>{"use strict";n.d(t,{c:()=>a});n(1504);var r=n(6952),o=n(7624);function a(e){let{locale:t,version:n,tag:a}=e;const i=t;return(0,o.jsxs)(r.c,{children:[t&&(0,o.jsx)("meta",{name:"docusaurus_locale",content:t}),n&&(0,o.jsx)("meta",{name:"docusaurus_version",content:n}),a&&(0,o.jsx)("meta",{name:"docusaurus_tag",content:a}),i&&(0,o.jsx)("meta",{name:"docsearch:language",content:i}),n&&(0,o.jsx)("meta",{name:"docsearch:version",content:n}),a&&(0,o.jsx)("meta",{name:"docsearch:docusaurus_tag",content:a})]})}},1964:(e,t,n)=>{"use strict";n.d(t,{c:()=>u});var r=n(1504),o=n(4971),a=n(3664),i=n(6528);const l={themedComponent:"themedComponent_mlkZ","themedComponent--light":"themedComponent--light_NVdE","themedComponent--dark":"themedComponent--dark_xIcU"};var s=n(7624);function c(e){let{className:t,children:n}=e;const c=(0,a.c)(),{colorMode:u}=(0,i.U)();return(0,s.jsx)(s.Fragment,{children:(c?"dark"===u?["dark"]:["light"]:["light","dark"]).map((e=>{const a=n({theme:e,className:(0,o.c)(t,l.themedComponent,l[`themedComponent--${e}`])});return(0,s.jsx)(r.Fragment,{children:a},e)}))})}function u(e){const{sources:t,className:n,alt:r,...o}=e;return(0,s.jsx)(c,{className:n,children:e=>{let{theme:n,className:a}=e;return(0,s.jsx)("img",{src:t[n],alt:r,className:a,...o})}})}},8448:(e,t,n)=>{"use strict";n.d(t,{U:()=>y,a:()=>c});var r=n(1504),o=n(8684),a=n(5288),i=n(3856),l=n(7624);const s="ease-in-out";function c(e){let{initialState:t}=e;const[n,o]=(0,r.useState)(t??!1),a=(0,r.useCallback)((()=>{o((e=>!e))}),[]);return{collapsed:n,setCollapsed:o,toggleCollapsed:a}}const u={display:"none",overflow:"hidden",height:"0px"},d={display:"block",overflow:"visible",height:"auto"};function p(e,t){const n=t?u:d;e.style.display=n.display,e.style.overflow=n.overflow,e.style.height=n.height}function f(e){let{collapsibleRef:t,collapsed:n,animation:o}=e;const a=(0,r.useRef)(!1);(0,r.useEffect)((()=>{const e=t.current;function r(){const t=e.scrollHeight,n=o?.duration??function(e){if((0,i.I)())return 1;const t=e/36;return Math.round(10*(4+15*t**.25+t/5))}(t);return{transition:`height ${n}ms ${o?.easing??s}`,height:`${t}px`}}function l(){const t=r();e.style.transition=t.transition,e.style.height=t.height}if(!a.current)return p(e,n),void(a.current=!0);return e.style.willChange="height",function(){const t=requestAnimationFrame((()=>{n?(l(),requestAnimationFrame((()=>{e.style.height=u.height,e.style.overflow=u.overflow}))):(e.style.display="block",requestAnimationFrame((()=>{l()})))}));return()=>cancelAnimationFrame(t)}()}),[t,n,o])}function g(e){if(!o.c.canUseDOM)return e?u:d}function m(e){let{as:t="div",collapsed:n,children:o,animation:a,onCollapseTransitionEnd:i,className:s,disableSSRStyle:c}=e;const u=(0,r.useRef)(null);return f({collapsibleRef:u,collapsed:n,animation:a}),(0,l.jsx)(t,{ref:u,style:c?void 0:g(n),onTransitionEnd:e=>{"height"===e.propertyName&&(p(u.current,n),i?.(n))},className:s,children:o})}function h(e){let{collapsed:t,...n}=e;const[o,i]=(0,r.useState)(!t),[s,c]=(0,r.useState)(t);return(0,a.c)((()=>{t||i(!0)}),[t]),(0,a.c)((()=>{o&&c(t)}),[o,t]),o?(0,l.jsx)(m,{...n,collapsed:s}):null}function y(e){let{lazy:t,...n}=e;const r=t?h:m;return(0,l.jsx)(r,{...n})}},3868:(e,t,n)=>{"use strict";n.d(t,{el:()=>m,qu:()=>g});var r=n(1504),o=n(3664),a=n(1148),i=n(1100),l=n(1824),s=n(7624);const c=(0,a.GS)("docusaurus.announcement.dismiss"),u=(0,a.GS)("docusaurus.announcement.id"),d=()=>"true"===c.get(),p=e=>c.set(String(e)),f=r.createContext(null);function g(e){let{children:t}=e;const n=function(){const{announcementBar:e}=(0,l.y)(),t=(0,o.c)(),[n,a]=(0,r.useState)((()=>!!t&&d()));(0,r.useEffect)((()=>{a(d())}),[]);const i=(0,r.useCallback)((()=>{p(!0),a(!0)}),[]);return(0,r.useEffect)((()=>{if(!e)return;const{id:t}=e;let n=u.get();"annoucement-bar"===n&&(n="announcement-bar");const r=t!==n;u.set(t),r&&p(!1),!r&&d()||a(!1)}),[e]),(0,r.useMemo)((()=>({isActive:!!e&&!n,close:i})),[e,n,i])}();return(0,s.jsx)(f.Provider,{value:n,children:t})}function m(){const e=(0,r.useContext)(f);if(!e)throw new i.AH("AnnouncementBarProvider");return e}},6528:(e,t,n)=>{"use strict";n.d(t,{C:()=>h,U:()=>y});var r=n(1504),o=n(8684),a=n(1100),i=n(1148),l=n(1824),s=n(7624);const c=r.createContext(void 0),u="theme",d=(0,i.GS)(u),p={light:"light",dark:"dark"},f=e=>e===p.dark?p.dark:p.light,g=e=>o.c.canUseDOM?f(document.documentElement.getAttribute("data-theme")):f(e),m=e=>{d.set(f(e))};function h(e){let{children:t}=e;const n=function(){const{colorMode:{defaultMode:e,disableSwitch:t,respectPrefersColorScheme:n}}=(0,l.y)(),[o,a]=(0,r.useState)(g(e));(0,r.useEffect)((()=>{t&&d.del()}),[t]);const i=(0,r.useCallback)((function(t,r){void 0===r&&(r={});const{persist:o=!0}=r;t?(a(t),o&&m(t)):(a(n?window.matchMedia("(prefers-color-scheme: dark)").matches?p.dark:p.light:e),d.del())}),[n,e]);(0,r.useEffect)((()=>{document.documentElement.setAttribute("data-theme",f(o))}),[o]),(0,r.useEffect)((()=>{if(t)return;const e=e=>{if(e.key!==u)return;const t=d.get();null!==t&&i(f(t))};return window.addEventListener("storage",e),()=>window.removeEventListener("storage",e)}),[t,i]);const s=(0,r.useRef)(!1);return(0,r.useEffect)((()=>{if(t&&!n)return;const e=window.matchMedia("(prefers-color-scheme: dark)"),r=()=>{window.matchMedia("print").matches||s.current?s.current=window.matchMedia("print").matches:i(null)};return e.addListener(r),()=>e.removeListener(r)}),[i,t,n]),(0,r.useMemo)((()=>({colorMode:o,setColorMode:i,get isDarkTheme(){return o===p.dark},setLightTheme(){i(p.light)},setDarkTheme(){i(p.dark)}})),[o,i])}();return(0,s.jsx)(c.Provider,{value:n,children:t})}function y(){const e=(0,r.useContext)(c);if(null==e)throw new a.AH("ColorModeProvider","Please see https://docusaurus.io/docs/api/themes/configuration#use-color-mode.");return e}},4592:(e,t,n)=>{"use strict";n.d(t,{gc:()=>y,iy:()=>v});var r=n(1504),o=n(5172),a=n(2488),i=n(1824),l=n(5492),s=n(1100),c=n(1148),u=n(7624);const d=e=>`docs-preferred-version-${e}`,p={save:(e,t,n)=>{(0,c.GS)(d(e),{persistence:t}).set(n)},read:(e,t)=>(0,c.GS)(d(e),{persistence:t}).get(),clear:(e,t)=>{(0,c.GS)(d(e),{persistence:t}).del()}},f=e=>Object.fromEntries(e.map((e=>[e,{preferredVersionName:null}])));const g=r.createContext(null);function m(){const e=(0,o.L0)(),t=(0,i.y)().docs.versionPersistence,n=(0,r.useMemo)((()=>Object.keys(e)),[e]),[a,l]=(0,r.useState)((()=>f(n)));(0,r.useEffect)((()=>{l(function(e){let{pluginIds:t,versionPersistence:n,allDocsData:r}=e;function o(e){const t=p.read(e,n);return r[e].versions.some((e=>e.name===t))?{preferredVersionName:t}:(p.clear(e,n),{preferredVersionName:null})}return Object.fromEntries(t.map((e=>[e,o(e)])))}({allDocsData:e,versionPersistence:t,pluginIds:n}))}),[e,t,n]);return[a,(0,r.useMemo)((()=>({savePreferredVersion:function(e,n){p.save(e,t,n),l((t=>({...t,[e]:{preferredVersionName:n}})))}})),[t])]}function h(e){let{children:t}=e;const n=m();return(0,u.jsx)(g.Provider,{value:n,children:t})}function y(e){let{children:t}=e;return l.c1?(0,u.jsx)(h,{children:t}):(0,u.jsx)(u.Fragment,{children:t})}function b(){const e=(0,r.useContext)(g);if(!e)throw new s.AH("DocsPreferredVersionContextProvider");return e}function v(e){void 0===e&&(e=a.M);const t=(0,o.OK)(e),[n,i]=b(),{preferredVersionName:l}=n[e];return{preferredVersion:t.versions.find((e=>e.name===l))??null,savePreferredVersionName:(0,r.useCallback)((t=>{i.savePreferredVersion(e,t)}),[i,e])}}},6192:(e,t,n)=>{"use strict";n.d(t,{m:()=>c,y:()=>s});var r=n(1504),o=n(1100),a=n(7624);const i=Symbol("EmptyContext"),l=r.createContext(i);function s(e){let{children:t,name:n,items:o}=e;const i=(0,r.useMemo)((()=>n&&o?{name:n,items:o}:null),[n,o]);return(0,a.jsx)(l.Provider,{value:i,children:t})}function c(){const e=(0,r.useContext)(l);if(e===i)throw new o.AH("DocsSidebarProvider");return e}},9920:(e,t,n)=>{"use strict";n.d(t,{E:()=>s,Q:()=>l});var r=n(1504),o=n(1100),a=n(7624);const i=r.createContext(null);function l(e){let{children:t,version:n}=e;return(0,a.jsx)(i.Provider,{value:n,children:t})}function s(){const e=(0,r.useContext)(i);if(null===e)throw new o.AH("DocsVersionProvider");return e}},8200:(e,t,n)=>{"use strict";n.d(t,{q:()=>f,y:()=>p});var r=n(1504),o=n(5168),a=n(1432),i=n(632),l=n(1824),s=n(1100),c=n(7624);const u=r.createContext(void 0);function d(){const e=function(){const e=(0,o.MF)(),{items:t}=(0,l.y)().navbar;return 0===t.length&&!e.component}(),t=(0,a.U)(),n=!e&&"mobile"===t,[s,c]=(0,r.useState)(!1);(0,i.a4)((()=>{if(s)return c(!1),!1}));const u=(0,r.useCallback)((()=>{c((e=>!e))}),[]);return(0,r.useEffect)((()=>{"desktop"===t&&c(!1)}),[t]),(0,r.useMemo)((()=>({disabled:e,shouldRender:n,toggle:u,shown:s})),[e,n,u,s])}function p(e){let{children:t}=e;const n=d();return(0,c.jsx)(u.Provider,{value:n,children:t})}function f(){const e=r.useContext(u);if(void 0===e)throw new s.AH("NavbarMobileSidebarProvider");return e}},5168:(e,t,n)=>{"use strict";n.d(t,{MF:()=>s,Mx:()=>c,Ub:()=>l});var r=n(1504),o=n(1100),a=n(7624);const i=r.createContext(null);function l(e){let{children:t}=e;const n=(0,r.useState)({component:null,props:null});return(0,a.jsx)(i.Provider,{value:n,children:t})}function s(){const e=(0,r.useContext)(i);if(!e)throw new o.AH("NavbarSecondaryMenuContentProvider");return e[0]}function c(e){let{component:t,props:n}=e;const a=(0,r.useContext)(i);if(!a)throw new o.AH("NavbarSecondaryMenuContentProvider");const[,l]=a,s=(0,o.Mh)(n);return(0,r.useEffect)((()=>{l({component:t,props:s})}),[l,t,s]),(0,r.useEffect)((()=>()=>l({component:null,props:null})),[l]),null}},204:(e,t,n)=>{"use strict";n.d(t,{m:()=>o,W:()=>a});var r=n(1504);const o="navigation-with-keyboard";function a(){(0,r.useEffect)((()=>{function e(e){"keydown"===e.type&&"Tab"===e.key&&document.body.classList.add(o),"mousedown"===e.type&&document.body.classList.remove(o)}return document.addEventListener("keydown",e),document.addEventListener("mousedown",e),()=>{document.body.classList.remove(o),document.removeEventListener("keydown",e),document.removeEventListener("mousedown",e)}}),[])}},1432:(e,t,n)=>{"use strict";n.d(t,{U:()=>l});var r=n(1504),o=n(8684);const a={desktop:"desktop",mobile:"mobile",ssr:"ssr"},i=996;function l(){const[e,t]=(0,r.useState)((()=>"ssr"));return(0,r.useEffect)((()=>{function e(){t(function(){if(!o.c.canUseDOM)throw new Error("getWindowSize() should only be called after React hydration");return window.innerWidth>i?a.desktop:a.mobile}())}return e(),window.addEventListener("resize",e),()=>{window.removeEventListener("resize",e)}}),[]),e}},5864:(e,t,n)=>{"use strict";n.d(t,{W:()=>r});const r={page:{blogListPage:"blog-list-page",blogPostPage:"blog-post-page",blogTagsListPage:"blog-tags-list-page",blogTagPostListPage:"blog-tags-post-list-page",docsDocPage:"docs-doc-page",docsTagsListPage:"docs-tags-list-page",docsTagDocListPage:"docs-tags-doc-list-page",mdxPage:"mdx-page"},wrapper:{main:"main-wrapper",blogPages:"blog-wrapper",docsPages:"docs-wrapper",mdxPages:"mdx-wrapper"},common:{editThisPage:"theme-edit-this-page",lastUpdated:"theme-last-updated",backToTopButton:"theme-back-to-top-button",codeBlock:"theme-code-block",admonition:"theme-admonition",unlistedBanner:"theme-unlisted-banner",admonitionType:e=>`theme-admonition-${e}`},layout:{},docs:{docVersionBanner:"theme-doc-version-banner",docVersionBadge:"theme-doc-version-badge",docBreadcrumbs:"theme-doc-breadcrumbs",docMarkdown:"theme-doc-markdown",docTocMobile:"theme-doc-toc-mobile",docTocDesktop:"theme-doc-toc-desktop",docFooter:"theme-doc-footer",docFooterTagsRow:"theme-doc-footer-tags-row",docFooterEditMetaRow:"theme-doc-footer-edit-meta-row",docSidebarContainer:"theme-doc-sidebar-container",docSidebarMenu:"theme-doc-sidebar-menu",docSidebarItemCategory:"theme-doc-sidebar-item-category",docSidebarItemLink:"theme-doc-sidebar-item-link",docSidebarItemCategoryLevel:e=>`theme-doc-sidebar-item-category-level-${e}`,docSidebarItemLinkLevel:e=>`theme-doc-sidebar-item-link-level-${e}`},blog:{}}},3856:(e,t,n)=>{"use strict";function r(){return window.matchMedia("(prefers-reduced-motion: reduce)").matches}n.d(t,{I:()=>r})},5492:(e,t,n)=>{"use strict";n.d(t,{Ab:()=>E,Gw:()=>g,ML:()=>T,Md:()=>b,Qf:()=>C,Uj:()=>_,_4:()=>f,b7:()=>S,c1:()=>p,js:()=>x,mg:()=>w,wt:()=>m});var r=n(1504),o=n(5592),a=n(5464),i=n(5172),l=n(4592),s=n(9920),c=n(6192),u=n(7128),d=n(3376);const p=!!i.L0;function f(e){const t=(0,s.E)();if(!e)return;const n=t.docs[e];if(!n)throw new Error(`no version doc found by id=${e}`);return n}function g(e){return"link"!==e.type||e.unlisted?"category"===e.type?function(e){if(e.href&&!e.linkUnlisted)return e.href;for(const t of e.items){const e=g(t);if(e)return e}}(e):void 0:e.href}function m(){const{pathname:e}=(0,o.IT)(),t=(0,c.m)();if(!t)throw new Error("Unexpected: cant find current sidebar in context");const n=k({sidebarItems:t.items,pathname:e,onlyCategories:!0}).slice(-1)[0];if(!n)throw new Error(`${e} is not associated with a category. useCurrentSidebarCategory() should only be used on category index pages.`);return n}const h=(e,t)=>void 0!==e&&(0,d.Sc)(e,t),y=(e,t)=>e.some((e=>b(e,t)));function b(e,t){return"link"===e.type?h(e.href,t):"category"===e.type&&(h(e.href,t)||y(e.items,t))}function v(e,t){switch(e.type){case"category":return b(e,t)||e.items.some((e=>v(e,t)));case"link":return!e.unlisted||b(e,t);default:return!1}}function w(e,t){return(0,r.useMemo)((()=>e.filter((e=>v(e,t)))),[e,t])}function k(e){let{sidebarItems:t,pathname:n,onlyCategories:r=!1}=e;const o=[];return function e(t){for(const a of t)if("category"===a.type&&((0,d.Sc)(a.href,n)||e(a.items))||"link"===a.type&&(0,d.Sc)(a.href,n)){return r&&"category"!==a.type||o.unshift(a),!0}return!1}(t),o}function x(){const e=(0,c.m)(),{pathname:t}=(0,o.IT)(),n=(0,i.UF)()?.pluginData.breadcrumbs;return!1!==n&&e?k({sidebarItems:e.items,pathname:t}):null}function S(e){const{activeVersion:t}=(0,i.wB)(e),{preferredVersion:n}=(0,l.iy)(e),o=(0,i.aA)(e);return(0,r.useMemo)((()=>(0,u.U)([t,n,o].filter(Boolean))),[t,n,o])}function E(e,t){const n=S(t);return(0,r.useMemo)((()=>{const t=n.flatMap((e=>e.sidebars?Object.entries(e.sidebars):[])),r=t.find((t=>t[0]===e));if(!r)throw new Error(`Can't find any sidebar with id "${e}" in version${n.length>1?"s":""} ${n.map((e=>e.name)).join(", ")}".\nAvailable sidebar ids are:\n- ${t.map((e=>e[0])).join("\n- ")}`);return r[1]}),[e,n])}function C(e,t){const n=S(t);return(0,r.useMemo)((()=>{const t=n.flatMap((e=>e.docs)),r=t.find((t=>t.id===e));if(!r){if(n.flatMap((e=>e.draftIds)).includes(e))return null;throw new Error(`Couldn't find any doc with id "${e}" in version${n.length>1?"s":""} "${n.map((e=>e.name)).join(", ")}".\nAvailable doc ids are:\n- ${(0,u.U)(t.map((e=>e.id))).join("\n- ")}`)}return r}),[e,n])}function _(e){let{route:t}=e;const n=(0,o.IT)(),r=(0,s.E)(),i=t.routes,l=i.find((e=>(0,o.ot)(n.pathname,e)));if(!l)return null;const c=l.sidebar,u=c?r.docsSidebars[c]:void 0;return{docElement:(0,a.k)(i),sidebarName:c,sidebarItems:u}}function T(e){return e.filter((e=>!("category"===e.type||"link"===e.type)||!!g(e)))}},632:(e,t,n)=>{"use strict";n.d(t,{_M:()=>l,a4:()=>i});var r=n(1504),o=n(5592),a=n(1100);function i(e){!function(e){const t=(0,o.Uz)(),n=(0,a.yA)(e);(0,r.useEffect)((()=>t.block(((e,t)=>n(e,t)))),[t,n])}(((t,n)=>{if("POP"===n)return e(t,n)}))}function l(e){return function(e){const t=(0,o.Uz)();return(0,r.useSyncExternalStore)(t.listen,(()=>e(t)),(()=>e(t)))}((t=>null===e?null:new URLSearchParams(t.location.search).get(e)))}},7128:(e,t,n)=>{"use strict";function r(e,t){return void 0===t&&(t=(e,t)=>e===t),e.filter(((n,r)=>e.findIndex((e=>t(e,n)))!==r))}function o(e){return Array.from(new Set(e))}n.d(t,{U:()=>o,w:()=>r})},5756:(e,t,n)=>{"use strict";n.d(t,{cr:()=>f,U7:()=>d,w7:()=>g});var r=n(1504),o=n(4971),a=n(6952),i=n(5548);function l(){const e=r.useContext(i.e);if(!e)throw new Error("Unexpected: no Docusaurus route context found");return e}var s=n(964),c=n(8264);var u=n(7624);function d(e){let{title:t,description:n,keywords:r,image:o,children:i}=e;const l=function(e){const{siteConfig:t}=(0,c.c)(),{title:n,titleDelimiter:r}=t;return e?.trim().length?`${e.trim()} ${r} ${n}`:n}(t),{withBaseUrl:d}=(0,s.E)(),p=o?d(o,{absolute:!0}):void 0;return(0,u.jsxs)(a.c,{children:[t&&(0,u.jsx)("title",{children:l}),t&&(0,u.jsx)("meta",{property:"og:title",content:l}),n&&(0,u.jsx)("meta",{name:"description",content:n}),n&&(0,u.jsx)("meta",{property:"og:description",content:n}),r&&(0,u.jsx)("meta",{name:"keywords",content:Array.isArray(r)?r.join(","):r}),p&&(0,u.jsx)("meta",{property:"og:image",content:p}),p&&(0,u.jsx)("meta",{name:"twitter:image",content:p}),i]})}const p=r.createContext(void 0);function f(e){let{className:t,children:n}=e;const i=r.useContext(p),l=(0,o.c)(i,t);return(0,u.jsxs)(p.Provider,{value:l,children:[(0,u.jsx)(a.c,{children:(0,u.jsx)("html",{className:l})}),n]})}function g(e){let{children:t}=e;const n=l(),r=`plugin-${n.plugin.name.replace(/docusaurus-(?:plugin|theme)-(?:content-)?/gi,"")}`;const a=`plugin-id-${n.plugin.id}`;return(0,u.jsx)(f,{className:(0,o.c)(r,a),children:t})}},1100:(e,t,n)=>{"use strict";n.d(t,{AH:()=>s,Mh:()=>c,i0:()=>l,qY:()=>u,yA:()=>i});var r=n(1504),o=n(5288),a=n(7624);function i(e){const t=(0,r.useRef)(e);return(0,o.c)((()=>{t.current=e}),[e]),(0,r.useCallback)((function(){return t.current(...arguments)}),[])}function l(e){const t=(0,r.useRef)();return(0,o.c)((()=>{t.current=e})),t.current}class s extends Error{constructor(e,t){super(),this.name="ReactContextError",this.message=`Hook ${this.stack?.split("\n")[1]?.match(/at (?:\w+\.)?(?\w+)/)?.groups.name??""} is called outside the <${e}>. ${t??""}`}}function c(e){const t=Object.entries(e);return t.sort(((e,t)=>e[0].localeCompare(t[0]))),(0,r.useMemo)((()=>e),t.flat())}function u(e){return t=>{let{children:n}=t;return(0,a.jsx)(a.Fragment,{children:e.reduceRight(((e,t)=>(0,a.jsx)(t,{children:e})),n)})}}},3376:(e,t,n)=>{"use strict";n.d(t,{Sc:()=>i,Y5:()=>l});var r=n(1504),o=n(628),a=n(8264);function i(e,t){const n=e=>(!e||e.endsWith("/")?e:`${e}/`)?.toLowerCase();return n(e)===n(t)}function l(){const{baseUrl:e}=(0,a.c)().siteConfig;return(0,r.useMemo)((()=>function(e){let{baseUrl:t,routes:n}=e;function r(e){return e.path===t&&!0===e.exact}function o(e){return e.path===t&&!e.exact}return function e(t){if(0===t.length)return;return t.find(r)||e(t.filter(o).flatMap((e=>e.routes??[])))}(n)}({routes:o.c,baseUrl:e})),[e])}},3943:(e,t,n)=>{"use strict";n.d(t,{MV:()=>g,S2:()=>u,SM:()=>f,yI:()=>m});var r=n(1504),o=n(8684),a=n(3664),i=n(5288),l=n(1100),s=n(7624);const c=r.createContext(void 0);function u(e){let{children:t}=e;const n=function(){const e=(0,r.useRef)(!0);return(0,r.useMemo)((()=>({scrollEventsEnabledRef:e,enableScrollEvents:()=>{e.current=!0},disableScrollEvents:()=>{e.current=!1}})),[])}();return(0,s.jsx)(c.Provider,{value:n,children:t})}function d(){const e=(0,r.useContext)(c);if(null==e)throw new l.AH("ScrollControllerProvider");return e}const p=()=>o.c.canUseDOM?{scrollX:window.pageXOffset,scrollY:window.pageYOffset}:null;function f(e,t){void 0===t&&(t=[]);const{scrollEventsEnabledRef:n}=d(),o=(0,r.useRef)(p()),a=(0,l.yA)(e);(0,r.useEffect)((()=>{const e=()=>{if(!n.current)return;const e=p();a(e,o.current),o.current=e},t={passive:!0};return e(),window.addEventListener("scroll",e,t),()=>window.removeEventListener("scroll",e,t)}),[a,n,...t])}function g(){const e=d(),t=function(){const e=(0,r.useRef)({elem:null,top:0}),t=(0,r.useCallback)((t=>{e.current={elem:t,top:t.getBoundingClientRect().top}}),[]),n=(0,r.useCallback)((()=>{const{current:{elem:t,top:n}}=e;if(!t)return{restored:!1};const r=t.getBoundingClientRect().top-n;return r&&window.scrollBy({left:0,top:r}),e.current={elem:null,top:0},{restored:0!==r}}),[]);return(0,r.useMemo)((()=>({save:t,restore:n})),[n,t])}(),n=(0,r.useRef)(void 0),o=(0,r.useCallback)((r=>{t.save(r),e.disableScrollEvents(),n.current=()=>{const{restored:r}=t.restore();if(n.current=void 0,r){const t=()=>{e.enableScrollEvents(),window.removeEventListener("scroll",t)};window.addEventListener("scroll",t)}else e.enableScrollEvents()}}),[e,t]);return(0,i.c)((()=>{queueMicrotask((()=>n.current?.()))})),{blockElementScrollPositionUntilNextRender:o}}function m(){const e=(0,r.useRef)(null),t=(0,a.c)()&&"smooth"===getComputedStyle(document.documentElement).scrollBehavior;return{startScroll:n=>{e.current=t?function(e){return window.scrollTo({top:e,behavior:"smooth"}),()=>{}}(n):function(e){let t=null;const n=document.documentElement.scrollTop>e;return function r(){const o=document.documentElement.scrollTop;(n&&o>e||!n&&ot&&cancelAnimationFrame(t)}(n)},cancelScroll:()=>e.current?.()}}},4456:(e,t,n)=>{"use strict";n.d(t,{SE:()=>o,e6:()=>r});n(8264);const r="default";function o(e,t){return`docs-${e}-${t}`}},1148:(e,t,n)=>{"use strict";n.d(t,{GS:()=>c,IN:()=>u});var r=n(1504);const o="localStorage";function a(e){let{key:t,oldValue:n,newValue:r,storage:o}=e;if(n===r)return;const a=document.createEvent("StorageEvent");a.initStorageEvent("storage",!1,!1,t,n,r,window.location.href,o),window.dispatchEvent(a)}function i(e){if(void 0===e&&(e=o),"undefined"==typeof window)throw new Error("Browser storage is not available on Node.js/Docusaurus SSR process.");if("none"===e)return null;try{return window[e]}catch(n){return t=n,l||(console.warn("Docusaurus browser storage is not available.\nPossible reasons: running Docusaurus in an iframe, in an incognito browser session, or using too strict browser privacy settings.",t),l=!0),null}var t}let l=!1;const s={get:()=>null,set:()=>{},del:()=>{},listen:()=>()=>{}};function c(e,t){if("undefined"==typeof window)return function(e){function t(){throw new Error(`Illegal storage API usage for storage key "${e}".\nDocusaurus storage APIs are not supposed to be called on the server-rendering process.\nPlease only call storage APIs in effects and event handlers.`)}return{get:t,set:t,del:t,listen:t}}(e);const n=i(t?.persistence);return null===n?s:{get:()=>{try{return n.getItem(e)}catch(t){return console.error(`Docusaurus storage error, can't get key=${e}`,t),null}},set:t=>{try{const r=n.getItem(e);n.setItem(e,t),a({key:e,oldValue:r,newValue:t,storage:n})}catch(r){console.error(`Docusaurus storage error, can't set ${e}=${t}`,r)}},del:()=>{try{const t=n.getItem(e);n.removeItem(e),a({key:e,oldValue:t,newValue:null,storage:n})}catch(t){console.error(`Docusaurus storage error, can't delete key=${e}`,t)}},listen:t=>{try{const r=r=>{r.storageArea===n&&r.key===e&&t(r)};return window.addEventListener("storage",r),()=>window.removeEventListener("storage",r)}catch(r){return console.error(`Docusaurus storage error, can't listen for changes of key=${e}`,r),()=>{}}}}}function u(e,t){const n=(0,r.useRef)((()=>null===e?s:c(e,t))).current(),o=(0,r.useCallback)((e=>"undefined"==typeof window?()=>{}:n.listen(e)),[n]);return[(0,r.useSyncExternalStore)(o,(()=>"undefined"==typeof window?null:n.get()),(()=>null)),n]}},1616:(e,t,n)=>{"use strict";n.d(t,{D:()=>i});var r=n(8264),o=n(5592),a=n(5684);function i(){const{siteConfig:{baseUrl:e,url:t,trailingSlash:n},i18n:{defaultLocale:i,currentLocale:l}}=(0,r.c)(),{pathname:s}=(0,o.IT)(),c=(0,a.applyTrailingSlash)(s,{trailingSlash:n,baseUrl:e}),u=l===i?e:e.replace(`/${l}/`,"/"),d=c.replace(e,"");return{createUrl:function(e){let{locale:n,fullyQualified:r}=e;return`${r?t:""}${function(e){return e===i?`${u}`:`${u}${e}/`}(n)}${d}`}}}},7124:(e,t,n)=>{"use strict";n.d(t,{c:()=>i});var r=n(1504),o=n(5592),a=n(1100);function i(e){const t=(0,o.IT)(),n=(0,a.i0)(t),i=(0,a.yA)(e);(0,r.useEffect)((()=>{n&&t!==n&&i({location:t,previousLocation:n})}),[i,t,n])}},1824:(e,t,n)=>{"use strict";n.d(t,{y:()=>o});var r=n(8264);function o(){return(0,r.c)().siteConfig.themeConfig}},1600:(e,t)=>{"use strict";Object.defineProperty(t,"__esModule",{value:!0}),t.default=function(e,t){const{trailingSlash:n,baseUrl:r}=t;if(e.startsWith("#"))return e;if(void 0===n)return e;const[o]=e.split(/[#?]/),a="/"===o||o===r?o:(i=o,n?function(e){return e.endsWith("/")?e:`${e}/`}(i):function(e){return e.endsWith("/")?e.slice(0,-1):e}(i));var i;return e.replace(o,a)}},4292:(e,t)=>{"use strict";Object.defineProperty(t,"__esModule",{value:!0}),t.getErrorCausalChain=void 0,t.getErrorCausalChain=function e(t){return t.cause?[t,...e(t.cause)]:[t]}},5684:function(e,t,n){"use strict";var r=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0}),t.getErrorCausalChain=t.applyTrailingSlash=t.blogPostContainerID=void 0,t.blogPostContainerID="__blog-post-container";var o=n(1600);Object.defineProperty(t,"applyTrailingSlash",{enumerable:!0,get:function(){return r(o).default}});var a=n(4292);Object.defineProperty(t,"getErrorCausalChain",{enumerable:!0,get:function(){return a.getErrorCausalChain}})},4820:(e,t,n)=>{"use strict";n.d(t,{c:()=>bt});var r=n(5592),o=n(1504),a=n(4971),i=n(5852),l=n(5756),s=n(4357),c=n(7124),u=n(7624);const d="__docusaurus_skipToContent_fallback";function p(e){e.setAttribute("tabindex","-1"),e.focus(),e.removeAttribute("tabindex")}function f(){const e=(0,o.useRef)(null),{action:t}=(0,r.Uz)(),n=(0,o.useCallback)((e=>{e.preventDefault();const t=document.querySelector("main:first-of-type")??document.getElementById(d);t&&p(t)}),[]);return(0,c.c)((n=>{let{location:r}=n;e.current&&!r.hash&&"PUSH"===t&&p(e.current)})),{containerRef:e,onClick:n}}const g=(0,s.G)({id:"theme.common.skipToMainContent",description:"The skip to content label used for accessibility, allowing to rapidly navigate to main content with keyboard tab/enter navigation",message:"Skip to main content"});function m(e){const t=e.children??g,{containerRef:n,onClick:r}=f();return(0,u.jsx)("div",{ref:n,role:"region","aria-label":g,children:(0,u.jsx)("a",{...e,href:`#${d}`,onClick:r,children:t})})}var h=n(5864),y=n(204);const b={skipToContent:"skipToContent_fXgn"};function v(){return(0,u.jsx)(m,{className:b.skipToContent})}var w=n(1824),k=n(3868);function x(e){let{width:t=21,height:n=21,color:r="currentColor",strokeWidth:o=1.2,className:a,...i}=e;return(0,u.jsx)("svg",{viewBox:"0 0 15 15",width:t,height:n,...i,children:(0,u.jsx)("g",{stroke:r,strokeWidth:o,children:(0,u.jsx)("path",{d:"M.75.75l13.5 13.5M14.25.75L.75 14.25"})})})}const S={closeButton:"closeButton_CVFx"};function E(e){return(0,u.jsx)("button",{type:"button","aria-label":(0,s.G)({id:"theme.AnnouncementBar.closeButtonAriaLabel",message:"Close",description:"The ARIA label for close button of announcement bar"}),...e,className:(0,a.c)("clean-btn close",S.closeButton,e.className),children:(0,u.jsx)(x,{width:14,height:14,strokeWidth:3.1})})}const C={content:"content_knG7"};function _(e){const{announcementBar:t}=(0,w.y)(),{content:n}=t;return(0,u.jsx)("div",{...e,className:(0,a.c)(C.content,e.className),dangerouslySetInnerHTML:{__html:n}})}const T={announcementBar:"announcementBar_mb4j",announcementBarPlaceholder:"announcementBarPlaceholder_vyr4",announcementBarClose:"announcementBarClose_gvF7",announcementBarContent:"announcementBarContent_xLdY"};function j(){const{announcementBar:e}=(0,w.y)(),{isActive:t,close:n}=(0,k.el)();if(!t)return null;const{backgroundColor:r,textColor:o,isCloseable:a}=e;return(0,u.jsxs)("div",{className:T.announcementBar,style:{backgroundColor:r,color:o},role:"banner",children:[a&&(0,u.jsx)("div",{className:T.announcementBarPlaceholder}),(0,u.jsx)(_,{className:T.announcementBarContent}),a&&(0,u.jsx)(E,{onClick:n,className:T.announcementBarClose})]})}var N=n(8200),A=n(3943);var R=n(1100),L=n(5168);const P=o.createContext(null);function O(e){let{children:t}=e;const n=function(){const e=(0,N.q)(),t=(0,L.MF)(),[n,r]=(0,o.useState)(!1),a=null!==t.component,i=(0,R.i0)(a);return(0,o.useEffect)((()=>{a&&!i&&r(!0)}),[a,i]),(0,o.useEffect)((()=>{a?e.shown||r(!0):r(!1)}),[e.shown,a]),(0,o.useMemo)((()=>[n,r]),[n])}();return(0,u.jsx)(P.Provider,{value:n,children:t})}function I(e){if(e.component){const t=e.component;return(0,u.jsx)(t,{...e.props})}}function D(){const e=(0,o.useContext)(P);if(!e)throw new R.AH("NavbarSecondaryMenuDisplayProvider");const[t,n]=e,r=(0,o.useCallback)((()=>n(!1)),[n]),a=(0,L.MF)();return(0,o.useMemo)((()=>({shown:t,hide:r,content:I(a)})),[r,a,t])}function M(e){let{header:t,primaryMenu:n,secondaryMenu:r}=e;const{shown:o}=D();return(0,u.jsxs)("div",{className:"navbar-sidebar",children:[t,(0,u.jsxs)("div",{className:(0,a.c)("navbar-sidebar__items",{"navbar-sidebar__items--show-secondary":o}),children:[(0,u.jsx)("div",{className:"navbar-sidebar__item menu",children:n}),(0,u.jsx)("div",{className:"navbar-sidebar__item menu",children:r})]})]})}var F=n(6528),z=n(3664);function B(e){return(0,u.jsx)("svg",{viewBox:"0 0 24 24",width:24,height:24,...e,children:(0,u.jsx)("path",{fill:"currentColor",d:"M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"})})}function U(e){return(0,u.jsx)("svg",{viewBox:"0 0 24 24",width:24,height:24,...e,children:(0,u.jsx)("path",{fill:"currentColor",d:"M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"})})}const $={toggle:"toggle_vylO",toggleButton:"toggleButton_gllP",darkToggleIcon:"darkToggleIcon_wfgR",lightToggleIcon:"lightToggleIcon_pyhR",toggleButtonDisabled:"toggleButtonDisabled_aARS"};function q(e){let{className:t,buttonClassName:n,value:r,onChange:o}=e;const i=(0,z.c)(),l=(0,s.G)({message:"Switch between dark and light mode (currently {mode})",id:"theme.colorToggle.ariaLabel",description:"The ARIA label for the navbar color mode toggle"},{mode:"dark"===r?(0,s.G)({message:"dark mode",id:"theme.colorToggle.ariaLabel.mode.dark",description:"The name for the dark color mode"}):(0,s.G)({message:"light mode",id:"theme.colorToggle.ariaLabel.mode.light",description:"The name for the light color mode"})});return(0,u.jsx)("div",{className:(0,a.c)($.toggle,t),children:(0,u.jsxs)("button",{className:(0,a.c)("clean-btn",$.toggleButton,!i&&$.toggleButtonDisabled,n),type:"button",onClick:()=>o("dark"===r?"light":"dark"),disabled:!i,title:l,"aria-label":l,"aria-live":"polite",children:[(0,u.jsx)(B,{className:(0,a.c)($.toggleIcon,$.lightToggleIcon)}),(0,u.jsx)(U,{className:(0,a.c)($.toggleIcon,$.darkToggleIcon)})]})})}const H=o.memo(q),G={darkNavbarColorModeToggle:"darkNavbarColorModeToggle_X3D1"};function W(e){let{className:t}=e;const n=(0,w.y)().navbar.style,r=(0,w.y)().colorMode.disableSwitch,{colorMode:o,setColorMode:a}=(0,F.U)();return r?null:(0,u.jsx)(H,{className:t,buttonClassName:"dark"===n?G.darkNavbarColorModeToggle:void 0,value:o,onChange:a})}var V=n(8164);function Q(){return(0,u.jsx)(V.c,{className:"navbar__brand",imageClassName:"navbar__logo",titleClassName:"navbar__title text--truncate"})}function Y(){const e=(0,N.q)();return(0,u.jsx)("button",{type:"button","aria-label":(0,s.G)({id:"theme.docs.sidebar.closeSidebarButtonAriaLabel",message:"Close navigation bar",description:"The ARIA label for close button of mobile sidebar"}),className:"clean-btn navbar-sidebar__close",onClick:()=>e.toggle(),children:(0,u.jsx)(x,{color:"var(--ifm-color-emphasis-600)"})})}function K(){return(0,u.jsxs)("div",{className:"navbar-sidebar__brand",children:[(0,u.jsx)(Q,{}),(0,u.jsx)(W,{className:"margin-right--md"}),(0,u.jsx)(Y,{})]})}var Z=n(6016),J=n(964),X=n(8136);function ee(e,t){return void 0!==e&&void 0!==t&&new RegExp(e,"gi").test(t)}var te=n(3232);function ne(e){let{activeBasePath:t,activeBaseRegex:n,to:r,href:o,label:a,html:i,isDropdownLink:l,prependBaseUrlToHref:s,...c}=e;const d=(0,J.c)(r),p=(0,J.c)(t),f=(0,J.c)(o,{forcePrependBaseUrl:!0}),g=a&&o&&!(0,X.c)(o),m=i?{dangerouslySetInnerHTML:{__html:i}}:{children:(0,u.jsxs)(u.Fragment,{children:[a,g&&(0,u.jsx)(te.c,{...l&&{width:12,height:12}})]})};return o?(0,u.jsx)(Z.c,{href:s?f:o,...c,...m}):(0,u.jsx)(Z.c,{to:d,isNavLink:!0,...(t||n)&&{isActive:(e,t)=>n?ee(n,t.pathname):t.pathname.startsWith(p)},...c,...m})}function re(e){let{className:t,isDropdownItem:n=!1,...r}=e;const o=(0,u.jsx)(ne,{className:(0,a.c)(n?"dropdown__link":"navbar__item navbar__link",t),isDropdownLink:n,...r});return n?(0,u.jsx)("li",{children:o}):o}function oe(e){let{className:t,isDropdownItem:n,...r}=e;return(0,u.jsx)("li",{className:"menu__list-item",children:(0,u.jsx)(ne,{className:(0,a.c)("menu__link",t),...r})})}function ae(e){let{mobile:t=!1,position:n,...r}=e;const o=t?oe:re;return(0,u.jsx)(o,{...r,activeClassName:r.activeClassName??(t?"menu__link--active":"navbar__link--active")})}var ie=n(8448),le=n(3376),se=n(8264);function ce(e,t){return e.some((e=>function(e,t){return!!(0,le.Sc)(e.to,t)||!!ee(e.activeBaseRegex,t)||!(!e.activeBasePath||!t.startsWith(e.activeBasePath))}(e,t)))}function ue(e){let{items:t,position:n,className:r,onClick:i,...l}=e;const s=(0,o.useRef)(null),[c,d]=(0,o.useState)(!1);return(0,o.useEffect)((()=>{const e=e=>{s.current&&!s.current.contains(e.target)&&d(!1)};return document.addEventListener("mousedown",e),document.addEventListener("touchstart",e),document.addEventListener("focusin",e),()=>{document.removeEventListener("mousedown",e),document.removeEventListener("touchstart",e),document.removeEventListener("focusin",e)}}),[s]),(0,u.jsxs)("div",{ref:s,className:(0,a.c)("navbar__item","dropdown","dropdown--hoverable",{"dropdown--right":"right"===n,"dropdown--show":c}),children:[(0,u.jsx)(ne,{"aria-haspopup":"true","aria-expanded":c,role:"button",href:l.to?void 0:"#",className:(0,a.c)("navbar__link",r),...l,onClick:l.to?void 0:e=>e.preventDefault(),onKeyDown:e=>{"Enter"===e.key&&(e.preventDefault(),d(!c))},children:l.children??l.label}),(0,u.jsx)("ul",{className:"dropdown__menu",children:t.map(((e,t)=>(0,o.createElement)(je,{isDropdownItem:!0,activeClassName:"dropdown__link--active",...e,key:t})))})]})}function de(e){let{items:t,className:n,position:i,onClick:l,...s}=e;const c=function(){const{siteConfig:{baseUrl:e}}=(0,se.c)(),{pathname:t}=(0,r.IT)();return t.replace(e,"/")}(),d=ce(t,c),{collapsed:p,toggleCollapsed:f,setCollapsed:g}=(0,ie.a)({initialState:()=>!d});return(0,o.useEffect)((()=>{d&&g(!d)}),[c,d,g]),(0,u.jsxs)("li",{className:(0,a.c)("menu__list-item",{"menu__list-item--collapsed":p}),children:[(0,u.jsx)(ne,{role:"button",className:(0,a.c)("menu__link menu__link--sublist menu__link--sublist-caret",n),...s,onClick:e=>{e.preventDefault(),f()},children:s.children??s.label}),(0,u.jsx)(ie.U,{lazy:!0,as:"ul",className:"menu__list",collapsed:p,children:t.map(((e,t)=>(0,o.createElement)(je,{mobile:!0,isDropdownItem:!0,onClick:l,activeClassName:"menu__link--active",...e,key:t})))})]})}function pe(e){let{mobile:t=!1,...n}=e;const r=t?de:ue;return(0,u.jsx)(r,{...n})}var fe=n(1616);function ge(e){let{width:t=20,height:n=20,...r}=e;return(0,u.jsx)("svg",{viewBox:"0 0 24 24",width:t,height:n,"aria-hidden":!0,...r,children:(0,u.jsx)("path",{fill:"currentColor",d:"M12.87 15.07l-2.54-2.51.03-.03c1.74-1.94 2.98-4.17 3.71-6.53H17V4h-7V2H8v2H1v1.99h11.17C11.5 7.92 10.44 9.75 9 11.35 8.07 10.32 7.3 9.19 6.69 8h-2c.73 1.63 1.73 3.17 2.98 4.56l-5.09 5.02L4 19l5-5 3.11 3.11.76-2.04zM18.5 10h-2L12 22h2l1.12-3h4.75L21 22h2l-4.5-12zm-2.62 7l1.62-4.33L19.12 17h-3.24z"})})}const me="iconLanguage_nlXk";var he=n(3160),ye=n(3508),be=n.n(ye);function ve(){const e=(0,r.IT)(),t=(0,r.Uz)(),{siteConfig:{baseUrl:n}}=(0,se.c)(),[a,i]=(0,o.useState)({wordToHighlight:"",isTitleSuggestion:!1,titleText:""});return(0,o.useEffect)((()=>{if(!e.state?.highlightState||0===e.state.highlightState.wordToHighlight.length)return;i(e.state.highlightState);const{highlightState:n,...r}=e.state;t.replace({...e,state:r})}),[e.state?.highlightState,t,e]),(0,o.useEffect)((()=>{if(0===a.wordToHighlight.length)return;const e=document.getElementsByTagName("article")[0]??document.getElementsByTagName("main")[0];if(!e)return;const t=new(be())(e),n={ignoreJoiners:!0};return t.mark(a.wordToHighlight,n),()=>t.unmark(n)}),[a,n]),null}const we=e=>{const t=(0,o.useRef)(!1),i=(0,o.useRef)(null),[l,s]=(0,o.useState)(!1),c=(0,r.Uz)(),{siteConfig:d={}}=(0,se.c)(),p=(d.plugins||[]).find((e=>Array.isArray(e)&&"string"==typeof e[0]&&e[0].includes("docusaurus-lunr-search"))),f=(0,z.c)(),{baseUrl:g}=d,m=p&&p[1]?.assetUrl||g,h=(0,he.MP)("docusaurus-lunr-search"),y=()=>{t.current||(Promise.all([fetch(`${m}${h.fileNames.searchDoc}`).then((e=>e.json())),fetch(`${m}${h.fileNames.lunrIndex}`).then((e=>e.json())),Promise.all([n.e(40),n.e(3444)]).then(n.bind(n,6920)),Promise.all([n.e(2176),n.e(6140)]).then(n.bind(n,8520))]).then((e=>{let[t,n,{default:r}]=e;const{searchDocs:o,options:a}=t;o&&0!==o.length&&(((e,t,n,r)=>{new n({searchDocs:e,searchIndex:t,baseUrl:g,inputSelector:"#search_input_react",handleSelected:(e,t,n)=>{const o=n.url||"/";document.createElement("a").href=o,e.setVal(""),t.target.blur();let a="";if(r.highlightResult)try{const e=(n.text||n.subcategory||n.title).match(new RegExp("\\w*","g"));if(e&&e.length>0){const t=document.createElement("div");t.innerHTML=e[0],a=t.textContent}}catch(i){console.log(i)}c.push(o,{highlightState:{wordToHighlight:a}})},maxHits:r.maxHits})})(o,n,r,a),s(!0))})),t.current=!0)},b=(0,o.useCallback)((t=>{i.current.contains(t.target)||i.current.focus(),e.handleSearchBarToggle&&e.handleSearchBarToggle(!e.isSearchBarExpanded)}),[e.isSearchBarExpanded]);let v;return f&&(y(),v=window.navigator.platform.startsWith("Mac")?"Search \u2318+K":"Search Ctrl+K"),(0,u.jsxs)("div",{className:"navbar__search",children:[(0,u.jsx)("span",{"aria-label":"expand searchbar",role:"button",className:(0,a.c)("search-icon",{"search-icon-hidden":e.isSearchBarExpanded}),onClick:b,onKeyDown:b,tabIndex:0}),(0,u.jsx)("input",{id:"search_input_react",type:"search",placeholder:l?v:"Loading...","aria-label":"Search",className:(0,a.c)("navbar__search-input",{"search-bar-expanded":e.isSearchBarExpanded},{"search-bar":!e.isSearchBarExpanded}),onClick:y,onMouseOver:y,onFocus:b,onBlur:b,ref:i,disabled:!l}),(0,u.jsx)(ve,{})]},"search-box")},ke={navbarSearchContainer:"navbarSearchContainer_Bca1"};function xe(e){let{children:t,className:n}=e;return(0,u.jsx)("div",{className:(0,a.c)(n,ke.navbarSearchContainer),children:t})}var Se=n(5172),Ee=n(5492);var Ce=n(4592);const _e=e=>e.docs.find((t=>t.id===e.mainDocId));const Te={default:ae,localeDropdown:function(e){let{mobile:t,dropdownItemsBefore:n,dropdownItemsAfter:o,queryString:a="",...i}=e;const{i18n:{currentLocale:l,locales:c,localeConfigs:d}}=(0,se.c)(),p=(0,fe.D)(),{search:f,hash:g}=(0,r.IT)(),m=[...n,...c.map((e=>{const n=`${`pathname://${p.createUrl({locale:e,fullyQualified:!1})}`}${f}${g}${a}`;return{label:d[e].label,lang:d[e].htmlLang,to:n,target:"_self",autoAddBaseUrl:!1,className:e===l?t?"menu__link--active":"dropdown__link--active":""}})),...o],h=t?(0,s.G)({message:"Languages",id:"theme.navbar.mobileLanguageDropdown.label",description:"The label for the mobile language switcher dropdown"}):d[l].label;return(0,u.jsx)(pe,{...i,mobile:t,label:(0,u.jsxs)(u.Fragment,{children:[(0,u.jsx)(ge,{className:me}),h]}),items:m})},search:function(e){let{mobile:t,className:n}=e;return t?null:(0,u.jsx)(xe,{className:n,children:(0,u.jsx)(we,{})})},dropdown:pe,html:function(e){let{value:t,className:n,mobile:r=!1,isDropdownItem:o=!1}=e;const i=o?"li":"div";return(0,u.jsx)(i,{className:(0,a.c)({navbar__item:!r&&!o,"menu__list-item":r},n),dangerouslySetInnerHTML:{__html:t}})},doc:function(e){let{docId:t,label:n,docsPluginId:r,...o}=e;const{activeDoc:a}=(0,Se.wB)(r),i=(0,Ee.Qf)(t,r),l=a?.path===i?.path;return null===i||i.unlisted&&!l?null:(0,u.jsx)(ae,{exact:!0,...o,isActive:()=>l||!!a?.sidebar&&a.sidebar===i.sidebar,label:n??i.id,to:i.path})},docSidebar:function(e){let{sidebarId:t,label:n,docsPluginId:r,...o}=e;const{activeDoc:a}=(0,Se.wB)(r),i=(0,Ee.Ab)(t,r).link;if(!i)throw new Error(`DocSidebarNavbarItem: Sidebar with ID "${t}" doesn't have anything to be linked to.`);return(0,u.jsx)(ae,{exact:!0,...o,isActive:()=>a?.sidebar===t,label:n??i.label,to:i.path})},docsVersion:function(e){let{label:t,to:n,docsPluginId:r,...o}=e;const a=(0,Ee.b7)(r)[0],i=t??a.label,l=n??(e=>e.docs.find((t=>t.id===e.mainDocId)))(a).path;return(0,u.jsx)(ae,{...o,label:i,to:l})},docsVersionDropdown:function(e){let{mobile:t,docsPluginId:n,dropdownActiveClassDisabled:o,dropdownItemsBefore:a,dropdownItemsAfter:i,...l}=e;const{search:c,hash:d}=(0,r.IT)(),p=(0,Se.wB)(n),f=(0,Se.gN)(n),{savePreferredVersionName:g}=(0,Ce.iy)(n),m=[...a,...f.map((e=>{const t=p.alternateDocVersions[e.name]??_e(e);return{label:e.label,to:`${t.path}${c}${d}`,isActive:()=>e===p.activeVersion,onClick:()=>g(e.name)}})),...i],h=(0,Ee.b7)(n)[0],y=t&&m.length>1?(0,s.G)({id:"theme.navbar.mobileVersionsDropdown.label",message:"Versions",description:"The label for the navbar versions dropdown on mobile view"}):h.label,b=t&&m.length>1?void 0:_e(h).path;return m.length<=1?(0,u.jsx)(ae,{...l,mobile:t,label:y,to:b,isActive:o?()=>!1:void 0}):(0,u.jsx)(pe,{...l,mobile:t,label:y,to:b,items:m,isActive:o?()=>!1:void 0})}};function je(e){let{type:t,...n}=e;const r=function(e,t){return e&&"default"!==e?e:"items"in t?"dropdown":"default"}(t,n),o=Te[r];if(!o)throw new Error(`No NavbarItem component found for type "${t}".`);return(0,u.jsx)(o,{...n})}function Ne(){const e=(0,N.q)(),t=(0,w.y)().navbar.items;return(0,u.jsx)("ul",{className:"menu__list",children:t.map(((t,n)=>(0,o.createElement)(je,{mobile:!0,...t,onClick:()=>e.toggle(),key:n})))})}function Ae(e){return(0,u.jsx)("button",{...e,type:"button",className:"clean-btn navbar-sidebar__back",children:(0,u.jsx)(s.c,{id:"theme.navbar.mobileSidebarSecondaryMenu.backButtonLabel",description:"The label of the back button to return to main menu, inside the mobile navbar sidebar secondary menu (notably used to display the docs sidebar)",children:"\u2190 Back to main menu"})})}function Re(){const e=0===(0,w.y)().navbar.items.length,t=D();return(0,u.jsxs)(u.Fragment,{children:[!e&&(0,u.jsx)(Ae,{onClick:()=>t.hide()}),t.content]})}function Le(){const e=(0,N.q)();var t;return void 0===(t=e.shown)&&(t=!0),(0,o.useEffect)((()=>(document.body.style.overflow=t?"hidden":"visible",()=>{document.body.style.overflow="visible"})),[t]),e.shouldRender?(0,u.jsx)(M,{header:(0,u.jsx)(K,{}),primaryMenu:(0,u.jsx)(Ne,{}),secondaryMenu:(0,u.jsx)(Re,{})}):null}const Pe={navbarHideable:"navbarHideable_m1mJ",navbarHidden:"navbarHidden_jGov"};function Oe(e){return(0,u.jsx)("div",{role:"presentation",...e,className:(0,a.c)("navbar-sidebar__backdrop",e.className)})}function Ie(e){let{children:t}=e;const{navbar:{hideOnScroll:n,style:r}}=(0,w.y)(),i=(0,N.q)(),{navbarRef:l,isNavbarVisible:d}=function(e){const[t,n]=(0,o.useState)(e),r=(0,o.useRef)(!1),a=(0,o.useRef)(0),i=(0,o.useCallback)((e=>{null!==e&&(a.current=e.getBoundingClientRect().height)}),[]);return(0,A.SM)(((t,o)=>{let{scrollY:i}=t;if(!e)return;if(i=l?n(!1):i+c{if(!e)return;const o=t.location.hash;if(o?document.getElementById(o.substring(1)):void 0)return r.current=!0,void n(!1);n(!0)})),{navbarRef:i,isNavbarVisible:t}}(n);return(0,u.jsxs)("nav",{ref:l,"aria-label":(0,s.G)({id:"theme.NavBar.navAriaLabel",message:"Main",description:"The ARIA label for the main navigation"}),className:(0,a.c)("navbar","navbar--fixed-top",n&&[Pe.navbarHideable,!d&&Pe.navbarHidden],{"navbar--dark":"dark"===r,"navbar--primary":"primary"===r,"navbar-sidebar--show":i.shown}),children:[t,(0,u.jsx)(Oe,{onClick:i.toggle}),(0,u.jsx)(Le,{})]})}var De=n(5684);const Me={errorBoundaryError:"errorBoundaryError_a6uf",errorBoundaryFallback:"errorBoundaryFallback_VBag"};function Fe(e){return(0,u.jsx)("button",{type:"button",...e,children:(0,u.jsx)(s.c,{id:"theme.ErrorPageContent.tryAgain",description:"The label of the button to try again rendering when the React error boundary captures an error",children:"Try again"})})}function ze(e){let{error:t}=e;const n=(0,De.getErrorCausalChain)(t).map((e=>e.message)).join("\n\nCause:\n");return(0,u.jsx)("p",{className:Me.errorBoundaryError,children:n})}class Be extends o.Component{componentDidCatch(e,t){throw this.props.onError(e,t)}render(){return this.props.children}}const Ue="right";function $e(e){let{width:t=30,height:n=30,className:r,...o}=e;return(0,u.jsx)("svg",{className:r,width:t,height:n,viewBox:"0 0 30 30","aria-hidden":"true",...o,children:(0,u.jsx)("path",{stroke:"currentColor",strokeLinecap:"round",strokeMiterlimit:"10",strokeWidth:"2",d:"M4 7h22M4 15h22M4 23h22"})})}function qe(){const{toggle:e,shown:t}=(0,N.q)();return(0,u.jsx)("button",{onClick:e,"aria-label":(0,s.G)({id:"theme.docs.sidebar.toggleSidebarButtonAriaLabel",message:"Toggle navigation bar",description:"The ARIA label for hamburger menu button of mobile navigation"}),"aria-expanded":t,className:"navbar__toggle clean-btn",type:"button",children:(0,u.jsx)($e,{})})}const He={colorModeToggle:"colorModeToggle_DEke"};function Ge(e){let{items:t}=e;return(0,u.jsx)(u.Fragment,{children:t.map(((e,t)=>(0,u.jsx)(Be,{onError:t=>new Error(`A theme navbar item failed to render.\nPlease double-check the following navbar item (themeConfig.navbar.items) of your Docusaurus config:\n${JSON.stringify(e,null,2)}`,{cause:t}),children:(0,u.jsx)(je,{...e})},t)))})}function We(e){let{left:t,right:n}=e;return(0,u.jsxs)("div",{className:"navbar__inner",children:[(0,u.jsx)("div",{className:"navbar__items",children:t}),(0,u.jsx)("div",{className:"navbar__items navbar__items--right",children:n})]})}function Ve(){const e=(0,N.q)(),t=(0,w.y)().navbar.items,[n,r]=function(e){function t(e){return"left"===(e.position??Ue)}return[e.filter(t),e.filter((e=>!t(e)))]}(t),o=t.find((e=>"search"===e.type));return(0,u.jsx)(We,{left:(0,u.jsxs)(u.Fragment,{children:[!e.disabled&&(0,u.jsx)(qe,{}),(0,u.jsx)(Q,{}),(0,u.jsx)(Ge,{items:n})]}),right:(0,u.jsxs)(u.Fragment,{children:[(0,u.jsx)(Ge,{items:r}),(0,u.jsx)(W,{className:He.colorModeToggle}),!o&&(0,u.jsx)(xe,{children:(0,u.jsx)(we,{})})]})})}function Qe(){return(0,u.jsx)(Ie,{children:(0,u.jsx)(Ve,{})})}function Ye(e){let{item:t}=e;const{to:n,href:r,label:o,prependBaseUrlToHref:a,...i}=t,l=(0,J.c)(n),s=(0,J.c)(r,{forcePrependBaseUrl:!0});return(0,u.jsxs)(Z.c,{className:"footer__link-item",...r?{href:a?s:r}:{to:l},...i,children:[o,r&&!(0,X.c)(r)&&(0,u.jsx)(te.c,{})]})}function Ke(e){let{item:t}=e;return t.html?(0,u.jsx)("li",{className:"footer__item",dangerouslySetInnerHTML:{__html:t.html}}):(0,u.jsx)("li",{className:"footer__item",children:(0,u.jsx)(Ye,{item:t})},t.href??t.to)}function Ze(e){let{column:t}=e;return(0,u.jsxs)("div",{className:"col footer__col",children:[(0,u.jsx)("div",{className:"footer__title",children:t.title}),(0,u.jsx)("ul",{className:"footer__items clean-list",children:t.items.map(((e,t)=>(0,u.jsx)(Ke,{item:e},t)))})]})}function Je(e){let{columns:t}=e;return(0,u.jsx)("div",{className:"row footer__links",children:t.map(((e,t)=>(0,u.jsx)(Ze,{column:e},t)))})}function Xe(){return(0,u.jsx)("span",{className:"footer__link-separator",children:"\xb7"})}function et(e){let{item:t}=e;return t.html?(0,u.jsx)("span",{className:"footer__link-item",dangerouslySetInnerHTML:{__html:t.html}}):(0,u.jsx)(Ye,{item:t})}function tt(e){let{links:t}=e;return(0,u.jsx)("div",{className:"footer__links text--center",children:(0,u.jsx)("div",{className:"footer__links",children:t.map(((e,n)=>(0,u.jsxs)(o.Fragment,{children:[(0,u.jsx)(et,{item:e}),t.length!==n+1&&(0,u.jsx)(Xe,{})]},n)))})})}function nt(e){let{links:t}=e;return function(e){return"title"in e[0]}(t)?(0,u.jsx)(Je,{columns:t}):(0,u.jsx)(tt,{links:t})}var rt=n(1964);const ot={footerLogoLink:"footerLogoLink_BH7S"};function at(e){let{logo:t}=e;const{withBaseUrl:n}=(0,J.E)(),r={light:n(t.src),dark:n(t.srcDark??t.src)};return(0,u.jsx)(rt.c,{className:(0,a.c)("footer__logo",t.className),alt:t.alt,sources:r,width:t.width,height:t.height,style:t.style})}function it(e){let{logo:t}=e;return t.href?(0,u.jsx)(Z.c,{href:t.href,className:ot.footerLogoLink,target:t.target,children:(0,u.jsx)(at,{logo:t})}):(0,u.jsx)(at,{logo:t})}function lt(e){let{copyright:t}=e;return(0,u.jsx)("div",{className:"footer__copyright",dangerouslySetInnerHTML:{__html:t}})}function st(e){let{style:t,links:n,logo:r,copyright:o}=e;return(0,u.jsx)("footer",{className:(0,a.c)("footer",{"footer--dark":"dark"===t}),children:(0,u.jsxs)("div",{className:"container container-fluid",children:[n,(r||o)&&(0,u.jsxs)("div",{className:"footer__bottom text--center",children:[r&&(0,u.jsx)("div",{className:"margin-bottom--sm",children:r}),o]})]})})}function ct(){const{footer:e}=(0,w.y)();if(!e)return null;const{copyright:t,links:n,logo:r,style:o}=e;return(0,u.jsx)(st,{style:o,links:n&&n.length>0&&(0,u.jsx)(nt,{links:n}),logo:r&&(0,u.jsx)(it,{logo:r}),copyright:t&&(0,u.jsx)(lt,{copyright:t})})}const ut=o.memo(ct),dt=(0,R.qY)([F.C,k.qu,A.S2,Ce.gc,l.w7,function(e){let{children:t}=e;return(0,u.jsx)(L.Ub,{children:(0,u.jsx)(N.y,{children:(0,u.jsx)(O,{children:t})})})}]);function pt(e){let{children:t}=e;return(0,u.jsx)(dt,{children:t})}var ft=n(6448);function gt(e){let{error:t,tryAgain:n}=e;return(0,u.jsx)("main",{className:"container margin-vert--xl",children:(0,u.jsx)("div",{className:"row",children:(0,u.jsxs)("div",{className:"col col--6 col--offset-3",children:[(0,u.jsx)(ft.c,{as:"h1",className:"hero__title",children:(0,u.jsx)(s.c,{id:"theme.ErrorPageContent.title",description:"The title of the fallback page when the page crashed",children:"This page crashed."})}),(0,u.jsx)("div",{className:"margin-vert--lg",children:(0,u.jsx)(Fe,{onClick:n,className:"button button--primary shadow--lw"})}),(0,u.jsx)("hr",{}),(0,u.jsx)("div",{className:"margin-vert--md",children:(0,u.jsx)(ze,{error:t})})]})})})}const mt={mainWrapper:"mainWrapper_z2l0"};function ht(e){const{children:t,noFooter:n,wrapperClassName:r,title:o,description:s}=e;return(0,y.W)(),(0,u.jsxs)(pt,{children:[(0,u.jsx)(l.U7,{title:o,description:s}),(0,u.jsx)(v,{}),(0,u.jsx)(j,{}),(0,u.jsx)(Qe,{}),(0,u.jsx)("div",{id:d,className:(0,a.c)(h.W.wrapper.main,mt.mainWrapper,r),children:(0,u.jsx)(i.c,{fallback:e=>(0,u.jsx)(gt,{...e}),children:t})}),!n&&(0,u.jsx)(ut,{})]})}let yt;function bt(e){const t=(0,r.IT)();return(0,o.useEffect)((()=>{window?.analytics?.page()}),[t]),(0,o.useEffect)((()=>{window.document.getElementById("search_input_react").onchange=e=>{yt&&clearTimeout(yt),yt=setTimeout((()=>{window?.analytics?.track("docsSearch",{searchQuery:e.target.value})}),1e3)}}),[]),(0,u.jsx)(u.Fragment,{children:(0,u.jsx)(ht,{...e})})}},4971:(e,t,n)=>{"use strict";function r(e){var t,n,o="";if("string"==typeof e||"number"==typeof e)o+=e;else if("object"==typeof e)if(Array.isArray(e))for(t=0;to});const o=function(){for(var e,t,n=0,o="";n{"use strict";n.d(t,{iU:()=>w,Yf:()=>_,gh:()=>f,Wi:()=>j,Ep:()=>p});var r=n(5072);function o(e){return"/"===e.charAt(0)}function a(e,t){for(var n=t,r=n+1,o=e.length;r=0;p--){var f=i[p];"."===f?a(i,p):".."===f?(a(i,p),d++):d&&(a(i,p),d--)}if(!c)for(;d--;d)i.unshift("..");!c||""===i[0]||i[0]&&o(i[0])||i.unshift("");var g=i.join("/");return n&&"/"!==g.substr(-1)&&(g+="/"),g};var l=n(4812);function s(e){return"/"===e.charAt(0)?e:"/"+e}function c(e){return"/"===e.charAt(0)?e.substr(1):e}function u(e,t){return function(e,t){return 0===e.toLowerCase().indexOf(t.toLowerCase())&&-1!=="/?#".indexOf(e.charAt(t.length))}(e,t)?e.substr(t.length):e}function d(e){return"/"===e.charAt(e.length-1)?e.slice(0,-1):e}function p(e){var t=e.pathname,n=e.search,r=e.hash,o=t||"/";return n&&"?"!==n&&(o+="?"===n.charAt(0)?n:"?"+n),r&&"#"!==r&&(o+="#"===r.charAt(0)?r:"#"+r),o}function f(e,t,n,o){var a;"string"==typeof e?(a=function(e){var t=e||"/",n="",r="",o=t.indexOf("#");-1!==o&&(r=t.substr(o),t=t.substr(0,o));var a=t.indexOf("?");return-1!==a&&(n=t.substr(a),t=t.substr(0,a)),{pathname:t,search:"?"===n?"":n,hash:"#"===r?"":r}}(e),a.state=t):(void 0===(a=(0,r.c)({},e)).pathname&&(a.pathname=""),a.search?"?"!==a.search.charAt(0)&&(a.search="?"+a.search):a.search="",a.hash?"#"!==a.hash.charAt(0)&&(a.hash="#"+a.hash):a.hash="",void 0!==t&&void 0===a.state&&(a.state=t));try{a.pathname=decodeURI(a.pathname)}catch(l){throw l instanceof URIError?new URIError('Pathname "'+a.pathname+'" could not be decoded. This is likely caused by an invalid percent-encoding.'):l}return n&&(a.key=n),o?a.pathname?"/"!==a.pathname.charAt(0)&&(a.pathname=i(a.pathname,o.pathname)):a.pathname=o.pathname:a.pathname||(a.pathname="/"),a}function g(){var e=null;var t=[];return{setPrompt:function(t){return e=t,function(){e===t&&(e=null)}},confirmTransitionTo:function(t,n,r,o){if(null!=e){var a="function"==typeof e?e(t,n):e;"string"==typeof a?"function"==typeof r?r(a,o):o(!0):o(!1!==a)}else o(!0)},appendListener:function(e){var n=!0;function r(){n&&e.apply(void 0,arguments)}return t.push(r),function(){n=!1,t=t.filter((function(e){return e!==r}))}},notifyListeners:function(){for(var e=arguments.length,n=new Array(e),r=0;rt?n.splice(t,n.length-t,o):n.push(o),d({action:r,location:o,index:t,entries:n})}}))},replace:function(e,t){var r="REPLACE",o=f(e,t,m(),w.location);u.confirmTransitionTo(o,r,n,(function(e){e&&(w.entries[w.index]=o,d({action:r,location:o}))}))},go:v,goBack:function(){v(-1)},goForward:function(){v(1)},canGo:function(e){var t=w.index+e;return t>=0&&t{"use strict";var r=n(9819),o={childContextTypes:!0,contextType:!0,contextTypes:!0,defaultProps:!0,displayName:!0,getDefaultProps:!0,getDerivedStateFromError:!0,getDerivedStateFromProps:!0,mixins:!0,propTypes:!0,type:!0},a={name:!0,length:!0,prototype:!0,caller:!0,callee:!0,arguments:!0,arity:!0},i={$$typeof:!0,compare:!0,defaultProps:!0,displayName:!0,propTypes:!0,type:!0},l={};function s(e){return r.isMemo(e)?i:l[e.$$typeof]||o}l[r.ForwardRef]={$$typeof:!0,render:!0,defaultProps:!0,displayName:!0,propTypes:!0},l[r.Memo]=i;var c=Object.defineProperty,u=Object.getOwnPropertyNames,d=Object.getOwnPropertySymbols,p=Object.getOwnPropertyDescriptor,f=Object.getPrototypeOf,g=Object.prototype;e.exports=function e(t,n,r){if("string"!=typeof n){if(g){var o=f(n);o&&o!==g&&e(t,o,r)}var i=u(n);d&&(i=i.concat(d(n)));for(var l=s(t),m=s(n),h=0;h{"use strict";var n="function"==typeof Symbol&&Symbol.for,r=n?Symbol.for("react.element"):60103,o=n?Symbol.for("react.portal"):60106,a=n?Symbol.for("react.fragment"):60107,i=n?Symbol.for("react.strict_mode"):60108,l=n?Symbol.for("react.profiler"):60114,s=n?Symbol.for("react.provider"):60109,c=n?Symbol.for("react.context"):60110,u=n?Symbol.for("react.async_mode"):60111,d=n?Symbol.for("react.concurrent_mode"):60111,p=n?Symbol.for("react.forward_ref"):60112,f=n?Symbol.for("react.suspense"):60113,g=n?Symbol.for("react.suspense_list"):60120,m=n?Symbol.for("react.memo"):60115,h=n?Symbol.for("react.lazy"):60116,y=n?Symbol.for("react.block"):60121,b=n?Symbol.for("react.fundamental"):60117,v=n?Symbol.for("react.responder"):60118,w=n?Symbol.for("react.scope"):60119;function k(e){if("object"==typeof e&&null!==e){var t=e.$$typeof;switch(t){case r:switch(e=e.type){case u:case d:case a:case l:case i:case f:return e;default:switch(e=e&&e.$$typeof){case c:case p:case h:case m:case s:return e;default:return t}}case o:return t}}}function x(e){return k(e)===d}t.AsyncMode=u,t.ConcurrentMode=d,t.ContextConsumer=c,t.ContextProvider=s,t.Element=r,t.ForwardRef=p,t.Fragment=a,t.Lazy=h,t.Memo=m,t.Portal=o,t.Profiler=l,t.StrictMode=i,t.Suspense=f,t.isAsyncMode=function(e){return x(e)||k(e)===u},t.isConcurrentMode=x,t.isContextConsumer=function(e){return k(e)===c},t.isContextProvider=function(e){return k(e)===s},t.isElement=function(e){return"object"==typeof e&&null!==e&&e.$$typeof===r},t.isForwardRef=function(e){return k(e)===p},t.isFragment=function(e){return k(e)===a},t.isLazy=function(e){return k(e)===h},t.isMemo=function(e){return k(e)===m},t.isPortal=function(e){return k(e)===o},t.isProfiler=function(e){return k(e)===l},t.isStrictMode=function(e){return k(e)===i},t.isSuspense=function(e){return k(e)===f},t.isValidElementType=function(e){return"string"==typeof e||"function"==typeof e||e===a||e===d||e===l||e===i||e===f||e===g||"object"==typeof e&&null!==e&&(e.$$typeof===h||e.$$typeof===m||e.$$typeof===s||e.$$typeof===c||e.$$typeof===p||e.$$typeof===b||e.$$typeof===v||e.$$typeof===w||e.$$typeof===y)},t.typeOf=k},9819:(e,t,n)=>{"use strict";e.exports=n(6560)},9328:e=>{"use strict";e.exports=function(e,t,n,r,o,a,i,l){if(!e){var s;if(void 0===t)s=new Error("Minified exception occurred; use the non-minified dev environment for the full error message and additional helpful warnings.");else{var c=[n,r,o,a,i,l],u=0;(s=new Error(t.replace(/%s/g,(function(){return c[u++]})))).name="Invariant Violation"}throw s.framesToPop=1,s}}},9600:e=>{e.exports=Array.isArray||function(e){return"[object Array]"==Object.prototype.toString.call(e)}},3508:function(e){e.exports=function(){"use strict";var e="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},t=function(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")},n=function(){function e(e,t){for(var n=0;n1&&void 0!==arguments[1])||arguments[1],o=arguments.length>2&&void 0!==arguments[2]?arguments[2]:[],a=arguments.length>3&&void 0!==arguments[3]?arguments[3]:5e3;t(this,e),this.ctx=n,this.iframes=r,this.exclude=o,this.iframesTimeout=a}return n(e,[{key:"getContexts",value:function(){var e=[];return(void 0!==this.ctx&&this.ctx?NodeList.prototype.isPrototypeOf(this.ctx)?Array.prototype.slice.call(this.ctx):Array.isArray(this.ctx)?this.ctx:"string"==typeof this.ctx?Array.prototype.slice.call(document.querySelectorAll(this.ctx)):[this.ctx]:[]).forEach((function(t){var n=e.filter((function(e){return e.contains(t)})).length>0;-1!==e.indexOf(t)||n||e.push(t)})),e}},{key:"getIframeContents",value:function(e,t){var n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:function(){},r=void 0;try{var o=e.contentWindow;if(r=o.document,!o||!r)throw new Error("iframe inaccessible")}catch(a){n()}r&&t(r)}},{key:"isIframeBlank",value:function(e){var t="about:blank",n=e.getAttribute("src").trim();return e.contentWindow.location.href===t&&n!==t&&n}},{key:"observeIframeLoad",value:function(e,t,n){var r=this,o=!1,a=null,i=function i(){if(!o){o=!0,clearTimeout(a);try{r.isIframeBlank(e)||(e.removeEventListener("load",i),r.getIframeContents(e,t,n))}catch(l){n()}}};e.addEventListener("load",i),a=setTimeout(i,this.iframesTimeout)}},{key:"onIframeReady",value:function(e,t,n){try{"complete"===e.contentWindow.document.readyState?this.isIframeBlank(e)?this.observeIframeLoad(e,t,n):this.getIframeContents(e,t,n):this.observeIframeLoad(e,t,n)}catch(r){n()}}},{key:"waitForIframes",value:function(e,t){var n=this,r=0;this.forEachIframe(e,(function(){return!0}),(function(e){r++,n.waitForIframes(e.querySelector("html"),(function(){--r||t()}))}),(function(e){e||t()}))}},{key:"forEachIframe",value:function(t,n,r){var o=this,a=arguments.length>3&&void 0!==arguments[3]?arguments[3]:function(){},i=t.querySelectorAll("iframe"),l=i.length,s=0;i=Array.prototype.slice.call(i);var c=function(){--l<=0&&a(s)};l||c(),i.forEach((function(t){e.matches(t,o.exclude)?c():o.onIframeReady(t,(function(e){n(t)&&(s++,r(e)),c()}),c)}))}},{key:"createIterator",value:function(e,t,n){return document.createNodeIterator(e,t,n,!1)}},{key:"createInstanceOnIframe",value:function(t){return new e(t.querySelector("html"),this.iframes)}},{key:"compareNodeIframe",value:function(e,t,n){if(e.compareDocumentPosition(n)&Node.DOCUMENT_POSITION_PRECEDING){if(null===t)return!0;if(t.compareDocumentPosition(n)&Node.DOCUMENT_POSITION_FOLLOWING)return!0}return!1}},{key:"getIteratorNode",value:function(e){var t=e.previousNode();return{prevNode:t,node:(null===t||e.nextNode())&&e.nextNode()}}},{key:"checkIframeFilter",value:function(e,t,n,r){var o=!1,a=!1;return r.forEach((function(e,t){e.val===n&&(o=t,a=e.handled)})),this.compareNodeIframe(e,t,n)?(!1!==o||a?!1===o||a||(r[o].handled=!0):r.push({val:n,handled:!0}),!0):(!1===o&&r.push({val:n,handled:!1}),!1)}},{key:"handleOpenIframes",value:function(e,t,n,r){var o=this;e.forEach((function(e){e.handled||o.getIframeContents(e.val,(function(e){o.createInstanceOnIframe(e).forEachNode(t,n,r)}))}))}},{key:"iterateThroughNodes",value:function(e,t,n,r,o){for(var a=this,i=this.createIterator(t,e,r),l=[],s=[],c=void 0,u=void 0,d=function(){var e=a.getIteratorNode(i);return u=e.prevNode,c=e.node};d();)this.iframes&&this.forEachIframe(t,(function(e){return a.checkIframeFilter(c,u,e,l)}),(function(t){a.createInstanceOnIframe(t).forEachNode(e,(function(e){return s.push(e)}),r)})),s.push(c);s.forEach((function(e){n(e)})),this.iframes&&this.handleOpenIframes(l,e,n,r),o()}},{key:"forEachNode",value:function(e,t,n){var r=this,o=arguments.length>3&&void 0!==arguments[3]?arguments[3]:function(){},a=this.getContexts(),i=a.length;i||o(),a.forEach((function(a){var l=function(){r.iterateThroughNodes(e,a,t,n,(function(){--i<=0&&o()}))};r.iframes?r.waitForIframes(a,l):l()}))}}],[{key:"matches",value:function(e,t){var n="string"==typeof t?[t]:t,r=e.matches||e.matchesSelector||e.msMatchesSelector||e.mozMatchesSelector||e.oMatchesSelector||e.webkitMatchesSelector;if(r){var o=!1;return n.every((function(t){return!r.call(e,t)||(o=!0,!1)})),o}return!1}}]),e}(),a=function(){function a(e){t(this,a),this.ctx=e,this.ie=!1;var n=window.navigator.userAgent;(n.indexOf("MSIE")>-1||n.indexOf("Trident")>-1)&&(this.ie=!0)}return n(a,[{key:"log",value:function(t){var n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:"debug",r=this.opt.log;this.opt.debug&&"object"===(void 0===r?"undefined":e(r))&&"function"==typeof r[n]&&r[n]("mark.js: "+t)}},{key:"escapeStr",value:function(e){return e.replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g,"\\$&")}},{key:"createRegExp",value:function(e){return"disabled"!==this.opt.wildcards&&(e=this.setupWildcardsRegExp(e)),e=this.escapeStr(e),Object.keys(this.opt.synonyms).length&&(e=this.createSynonymsRegExp(e)),(this.opt.ignoreJoiners||this.opt.ignorePunctuation.length)&&(e=this.setupIgnoreJoinersRegExp(e)),this.opt.diacritics&&(e=this.createDiacriticsRegExp(e)),e=this.createMergedBlanksRegExp(e),(this.opt.ignoreJoiners||this.opt.ignorePunctuation.length)&&(e=this.createJoinersRegExp(e)),"disabled"!==this.opt.wildcards&&(e=this.createWildcardsRegExp(e)),e=this.createAccuracyRegExp(e)}},{key:"createSynonymsRegExp",value:function(e){var t=this.opt.synonyms,n=this.opt.caseSensitive?"":"i",r=this.opt.ignoreJoiners||this.opt.ignorePunctuation.length?"\0":"";for(var o in t)if(t.hasOwnProperty(o)){var a=t[o],i="disabled"!==this.opt.wildcards?this.setupWildcardsRegExp(o):this.escapeStr(o),l="disabled"!==this.opt.wildcards?this.setupWildcardsRegExp(a):this.escapeStr(a);""!==i&&""!==l&&(e=e.replace(new RegExp("("+this.escapeStr(i)+"|"+this.escapeStr(l)+")","gm"+n),r+"("+this.processSynomyms(i)+"|"+this.processSynomyms(l)+")"+r))}return e}},{key:"processSynomyms",value:function(e){return(this.opt.ignoreJoiners||this.opt.ignorePunctuation.length)&&(e=this.setupIgnoreJoinersRegExp(e)),e}},{key:"setupWildcardsRegExp",value:function(e){return(e=e.replace(/(?:\\)*\?/g,(function(e){return"\\"===e.charAt(0)?"?":"\x01"}))).replace(/(?:\\)*\*/g,(function(e){return"\\"===e.charAt(0)?"*":"\x02"}))}},{key:"createWildcardsRegExp",value:function(e){var t="withSpaces"===this.opt.wildcards;return e.replace(/\u0001/g,t?"[\\S\\s]?":"\\S?").replace(/\u0002/g,t?"[\\S\\s]*?":"\\S*")}},{key:"setupIgnoreJoinersRegExp",value:function(e){return e.replace(/[^(|)\\]/g,(function(e,t,n){var r=n.charAt(t+1);return/[(|)\\]/.test(r)||""===r?e:e+"\0"}))}},{key:"createJoinersRegExp",value:function(e){var t=[],n=this.opt.ignorePunctuation;return Array.isArray(n)&&n.length&&t.push(this.escapeStr(n.join(""))),this.opt.ignoreJoiners&&t.push("\\u00ad\\u200b\\u200c\\u200d"),t.length?e.split(/\u0000+/).join("["+t.join("")+"]*"):e}},{key:"createDiacriticsRegExp",value:function(e){var t=this.opt.caseSensitive?"":"i",n=this.opt.caseSensitive?["a\xe0\xe1\u1ea3\xe3\u1ea1\u0103\u1eb1\u1eaf\u1eb3\u1eb5\u1eb7\xe2\u1ea7\u1ea5\u1ea9\u1eab\u1ead\xe4\xe5\u0101\u0105","A\xc0\xc1\u1ea2\xc3\u1ea0\u0102\u1eb0\u1eae\u1eb2\u1eb4\u1eb6\xc2\u1ea6\u1ea4\u1ea8\u1eaa\u1eac\xc4\xc5\u0100\u0104","c\xe7\u0107\u010d","C\xc7\u0106\u010c","d\u0111\u010f","D\u0110\u010e","e\xe8\xe9\u1ebb\u1ebd\u1eb9\xea\u1ec1\u1ebf\u1ec3\u1ec5\u1ec7\xeb\u011b\u0113\u0119","E\xc8\xc9\u1eba\u1ebc\u1eb8\xca\u1ec0\u1ebe\u1ec2\u1ec4\u1ec6\xcb\u011a\u0112\u0118","i\xec\xed\u1ec9\u0129\u1ecb\xee\xef\u012b","I\xcc\xcd\u1ec8\u0128\u1eca\xce\xcf\u012a","l\u0142","L\u0141","n\xf1\u0148\u0144","N\xd1\u0147\u0143","o\xf2\xf3\u1ecf\xf5\u1ecd\xf4\u1ed3\u1ed1\u1ed5\u1ed7\u1ed9\u01a1\u1edf\u1ee1\u1edb\u1edd\u1ee3\xf6\xf8\u014d","O\xd2\xd3\u1ece\xd5\u1ecc\xd4\u1ed2\u1ed0\u1ed4\u1ed6\u1ed8\u01a0\u1ede\u1ee0\u1eda\u1edc\u1ee2\xd6\xd8\u014c","r\u0159","R\u0158","s\u0161\u015b\u0219\u015f","S\u0160\u015a\u0218\u015e","t\u0165\u021b\u0163","T\u0164\u021a\u0162","u\xf9\xfa\u1ee7\u0169\u1ee5\u01b0\u1eeb\u1ee9\u1eed\u1eef\u1ef1\xfb\xfc\u016f\u016b","U\xd9\xda\u1ee6\u0168\u1ee4\u01af\u1eea\u1ee8\u1eec\u1eee\u1ef0\xdb\xdc\u016e\u016a","y\xfd\u1ef3\u1ef7\u1ef9\u1ef5\xff","Y\xdd\u1ef2\u1ef6\u1ef8\u1ef4\u0178","z\u017e\u017c\u017a","Z\u017d\u017b\u0179"]:["a\xe0\xe1\u1ea3\xe3\u1ea1\u0103\u1eb1\u1eaf\u1eb3\u1eb5\u1eb7\xe2\u1ea7\u1ea5\u1ea9\u1eab\u1ead\xe4\xe5\u0101\u0105A\xc0\xc1\u1ea2\xc3\u1ea0\u0102\u1eb0\u1eae\u1eb2\u1eb4\u1eb6\xc2\u1ea6\u1ea4\u1ea8\u1eaa\u1eac\xc4\xc5\u0100\u0104","c\xe7\u0107\u010dC\xc7\u0106\u010c","d\u0111\u010fD\u0110\u010e","e\xe8\xe9\u1ebb\u1ebd\u1eb9\xea\u1ec1\u1ebf\u1ec3\u1ec5\u1ec7\xeb\u011b\u0113\u0119E\xc8\xc9\u1eba\u1ebc\u1eb8\xca\u1ec0\u1ebe\u1ec2\u1ec4\u1ec6\xcb\u011a\u0112\u0118","i\xec\xed\u1ec9\u0129\u1ecb\xee\xef\u012bI\xcc\xcd\u1ec8\u0128\u1eca\xce\xcf\u012a","l\u0142L\u0141","n\xf1\u0148\u0144N\xd1\u0147\u0143","o\xf2\xf3\u1ecf\xf5\u1ecd\xf4\u1ed3\u1ed1\u1ed5\u1ed7\u1ed9\u01a1\u1edf\u1ee1\u1edb\u1edd\u1ee3\xf6\xf8\u014dO\xd2\xd3\u1ece\xd5\u1ecc\xd4\u1ed2\u1ed0\u1ed4\u1ed6\u1ed8\u01a0\u1ede\u1ee0\u1eda\u1edc\u1ee2\xd6\xd8\u014c","r\u0159R\u0158","s\u0161\u015b\u0219\u015fS\u0160\u015a\u0218\u015e","t\u0165\u021b\u0163T\u0164\u021a\u0162","u\xf9\xfa\u1ee7\u0169\u1ee5\u01b0\u1eeb\u1ee9\u1eed\u1eef\u1ef1\xfb\xfc\u016f\u016bU\xd9\xda\u1ee6\u0168\u1ee4\u01af\u1eea\u1ee8\u1eec\u1eee\u1ef0\xdb\xdc\u016e\u016a","y\xfd\u1ef3\u1ef7\u1ef9\u1ef5\xffY\xdd\u1ef2\u1ef6\u1ef8\u1ef4\u0178","z\u017e\u017c\u017aZ\u017d\u017b\u0179"],r=[];return e.split("").forEach((function(o){n.every((function(n){if(-1!==n.indexOf(o)){if(r.indexOf(n)>-1)return!1;e=e.replace(new RegExp("["+n+"]","gm"+t),"["+n+"]"),r.push(n)}return!0}))})),e}},{key:"createMergedBlanksRegExp",value:function(e){return e.replace(/[\s]+/gim,"[\\s]+")}},{key:"createAccuracyRegExp",value:function(e){var t=this,n="!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~\xa1\xbf",r=this.opt.accuracy,o="string"==typeof r?r:r.value,a="string"==typeof r?[]:r.limiters,i="";switch(a.forEach((function(e){i+="|"+t.escapeStr(e)})),o){case"partially":default:return"()("+e+")";case"complementary":return"()([^"+(i="\\s"+(i||this.escapeStr(n)))+"]*"+e+"[^"+i+"]*)";case"exactly":return"(^|\\s"+i+")("+e+")(?=$|\\s"+i+")"}}},{key:"getSeparatedKeywords",value:function(e){var t=this,n=[];return e.forEach((function(e){t.opt.separateWordSearch?e.split(" ").forEach((function(e){e.trim()&&-1===n.indexOf(e)&&n.push(e)})):e.trim()&&-1===n.indexOf(e)&&n.push(e)})),{keywords:n.sort((function(e,t){return t.length-e.length})),length:n.length}}},{key:"isNumeric",value:function(e){return Number(parseFloat(e))==e}},{key:"checkRanges",value:function(e){var t=this;if(!Array.isArray(e)||"[object Object]"!==Object.prototype.toString.call(e[0]))return this.log("markRanges() will only accept an array of objects"),this.opt.noMatch(e),[];var n=[],r=0;return e.sort((function(e,t){return e.start-t.start})).forEach((function(e){var o=t.callNoMatchOnInvalidRanges(e,r),a=o.start,i=o.end;o.valid&&(e.start=a,e.length=i-a,n.push(e),r=i)})),n}},{key:"callNoMatchOnInvalidRanges",value:function(e,t){var n=void 0,r=void 0,o=!1;return e&&void 0!==e.start?(r=(n=parseInt(e.start,10))+parseInt(e.length,10),this.isNumeric(e.start)&&this.isNumeric(e.length)&&r-t>0&&r-n>0?o=!0:(this.log("Ignoring invalid or overlapping range: "+JSON.stringify(e)),this.opt.noMatch(e))):(this.log("Ignoring invalid range: "+JSON.stringify(e)),this.opt.noMatch(e)),{start:n,end:r,valid:o}}},{key:"checkWhitespaceRanges",value:function(e,t,n){var r=void 0,o=!0,a=n.length,i=t-a,l=parseInt(e.start,10)-i;return(r=(l=l>a?a:l)+parseInt(e.length,10))>a&&(r=a,this.log("End range automatically set to the max value of "+a)),l<0||r-l<0||l>a||r>a?(o=!1,this.log("Invalid range: "+JSON.stringify(e)),this.opt.noMatch(e)):""===n.substring(l,r).replace(/\s+/g,"")&&(o=!1,this.log("Skipping whitespace only range: "+JSON.stringify(e)),this.opt.noMatch(e)),{start:l,end:r,valid:o}}},{key:"getTextNodes",value:function(e){var t=this,n="",r=[];this.iterator.forEachNode(NodeFilter.SHOW_TEXT,(function(e){r.push({start:n.length,end:(n+=e.textContent).length,node:e})}),(function(e){return t.matchesExclude(e.parentNode)?NodeFilter.FILTER_REJECT:NodeFilter.FILTER_ACCEPT}),(function(){e({value:n,nodes:r})}))}},{key:"matchesExclude",value:function(e){return o.matches(e,this.opt.exclude.concat(["script","style","title","head","html"]))}},{key:"wrapRangeInTextNode",value:function(e,t,n){var r=this.opt.element?this.opt.element:"mark",o=e.splitText(t),a=o.splitText(n-t),i=document.createElement(r);return i.setAttribute("data-markjs","true"),this.opt.className&&i.setAttribute("class",this.opt.className),i.textContent=o.textContent,o.parentNode.replaceChild(i,o),a}},{key:"wrapRangeInMappedTextNode",value:function(e,t,n,r,o){var a=this;e.nodes.every((function(i,l){var s=e.nodes[l+1];if(void 0===s||s.start>t){if(!r(i.node))return!1;var c=t-i.start,u=(n>i.end?i.end:n)-i.start,d=e.value.substr(0,i.start),p=e.value.substr(u+i.start);if(i.node=a.wrapRangeInTextNode(i.node,c,u),e.value=d+p,e.nodes.forEach((function(t,n){n>=l&&(e.nodes[n].start>0&&n!==l&&(e.nodes[n].start-=u),e.nodes[n].end-=u)})),n-=u,o(i.node.previousSibling,i.start),!(n>i.end))return!1;t=i.end}return!0}))}},{key:"wrapMatches",value:function(e,t,n,r,o){var a=this,i=0===t?0:t+1;this.getTextNodes((function(t){t.nodes.forEach((function(t){t=t.node;for(var o=void 0;null!==(o=e.exec(t.textContent))&&""!==o[i];)if(n(o[i],t)){var l=o.index;if(0!==i)for(var s=1;s{"use strict";n.r(t)},1496:(e,t,n)=>{"use strict";n.r(t)},2272:function(e,t,n){var r,o;r=function(){var e,t,n={version:"0.2.0"},r=n.settings={minimum:.08,easing:"ease",positionUsing:"",speed:200,trickle:!0,trickleRate:.02,trickleSpeed:800,showSpinner:!0,barSelector:'[role="bar"]',spinnerSelector:'[role="spinner"]',parent:"body",template:'
'};function o(e,t,n){return en?n:e}function a(e){return 100*(-1+e)}function i(e,t,n){var o;return(o="translate3d"===r.positionUsing?{transform:"translate3d("+a(e)+"%,0,0)"}:"translate"===r.positionUsing?{transform:"translate("+a(e)+"%,0)"}:{"margin-left":a(e)+"%"}).transition="all "+t+"ms "+n,o}n.configure=function(e){var t,n;for(t in e)void 0!==(n=e[t])&&e.hasOwnProperty(t)&&(r[t]=n);return this},n.status=null,n.set=function(e){var t=n.isStarted();e=o(e,r.minimum,1),n.status=1===e?null:e;var a=n.render(!t),c=a.querySelector(r.barSelector),u=r.speed,d=r.easing;return a.offsetWidth,l((function(t){""===r.positionUsing&&(r.positionUsing=n.getPositioningCSS()),s(c,i(e,u,d)),1===e?(s(a,{transition:"none",opacity:1}),a.offsetWidth,setTimeout((function(){s(a,{transition:"all "+u+"ms linear",opacity:0}),setTimeout((function(){n.remove(),t()}),u)}),u)):setTimeout(t,u)})),this},n.isStarted=function(){return"number"==typeof n.status},n.start=function(){n.status||n.set(0);var e=function(){setTimeout((function(){n.status&&(n.trickle(),e())}),r.trickleSpeed)};return r.trickle&&e(),this},n.done=function(e){return e||n.status?n.inc(.3+.5*Math.random()).set(1):this},n.inc=function(e){var t=n.status;return t?("number"!=typeof e&&(e=(1-t)*o(Math.random()*t,.1,.95)),t=o(t+e,0,.994),n.set(t)):n.start()},n.trickle=function(){return n.inc(Math.random()*r.trickleRate)},e=0,t=0,n.promise=function(r){return r&&"resolved"!==r.state()?(0===t&&n.start(),e++,t++,r.always((function(){0==--t?(e=0,n.done()):n.set((e-t)/e)})),this):this},n.render=function(e){if(n.isRendered())return document.getElementById("nprogress");u(document.documentElement,"nprogress-busy");var t=document.createElement("div");t.id="nprogress",t.innerHTML=r.template;var o,i=t.querySelector(r.barSelector),l=e?"-100":a(n.status||0),c=document.querySelector(r.parent);return s(i,{transition:"all 0 linear",transform:"translate3d("+l+"%,0,0)"}),r.showSpinner||(o=t.querySelector(r.spinnerSelector))&&f(o),c!=document.body&&u(c,"nprogress-custom-parent"),c.appendChild(t),t},n.remove=function(){d(document.documentElement,"nprogress-busy"),d(document.querySelector(r.parent),"nprogress-custom-parent");var e=document.getElementById("nprogress");e&&f(e)},n.isRendered=function(){return!!document.getElementById("nprogress")},n.getPositioningCSS=function(){var e=document.body.style,t="WebkitTransform"in e?"Webkit":"MozTransform"in e?"Moz":"msTransform"in e?"ms":"OTransform"in e?"O":"";return t+"Perspective"in e?"translate3d":t+"Transform"in e?"translate":"margin"};var l=function(){var e=[];function t(){var n=e.shift();n&&n(t)}return function(n){e.push(n),1==e.length&&t()}}(),s=function(){var e=["Webkit","O","Moz","ms"],t={};function n(e){return e.replace(/^-ms-/,"ms-").replace(/-([\da-z])/gi,(function(e,t){return t.toUpperCase()}))}function r(t){var n=document.body.style;if(t in n)return t;for(var r,o=e.length,a=t.charAt(0).toUpperCase()+t.slice(1);o--;)if((r=e[o]+a)in n)return r;return t}function o(e){return e=n(e),t[e]||(t[e]=r(e))}function a(e,t,n){t=o(t),e.style[t]=n}return function(e,t){var n,r,o=arguments;if(2==o.length)for(n in t)void 0!==(r=t[n])&&t.hasOwnProperty(n)&&a(e,n,r);else a(e,o[1],o[2])}}();function c(e,t){return("string"==typeof e?e:p(e)).indexOf(" "+t+" ")>=0}function u(e,t){var n=p(e),r=n+t;c(n,t)||(e.className=r.substring(1))}function d(e,t){var n,r=p(e);c(e,t)&&(n=r.replace(" "+t+" "," "),e.className=n.substring(1,n.length-1))}function p(e){return(" "+(e.className||"")+" ").replace(/\s+/gi," ")}function f(e){e&&e.parentNode&&e.parentNode.removeChild(e)}return n},void 0===(o="function"==typeof r?r.call(t,n,t,e):r)||(e.exports=o)},6872:(e,t,n)=>{var r=n(9600);e.exports=f,e.exports.parse=a,e.exports.compile=function(e,t){return l(a(e,t),t)},e.exports.tokensToFunction=l,e.exports.tokensToRegExp=p;var o=new RegExp(["(\\\\.)","([\\/.])?(?:(?:\\:(\\w+)(?:\\(((?:\\\\.|[^\\\\()])+)\\))?|\\(((?:\\\\.|[^\\\\()])+)\\))([+*?])?|(\\*))"].join("|"),"g");function a(e,t){for(var n,r=[],a=0,i=0,l="",u=t&&t.delimiter||"/";null!=(n=o.exec(e));){var d=n[0],p=n[1],f=n.index;if(l+=e.slice(i,f),i=f+d.length,p)l+=p[1];else{var g=e[i],m=n[2],h=n[3],y=n[4],b=n[5],v=n[6],w=n[7];l&&(r.push(l),l="");var k=null!=m&&null!=g&&g!==m,x="+"===v||"*"===v,S="?"===v||"*"===v,E=n[2]||u,C=y||b;r.push({name:h||a++,prefix:m||"",delimiter:E,optional:S,repeat:x,partial:k,asterisk:!!w,pattern:C?c(C):w?".*":"[^"+s(E)+"]+?"})}}return i{e.exports&&(e.exports={core:{meta:{path:"components/prism-core.js",option:"mandatory"},core:"Core"},themes:{meta:{path:"themes/{id}.css",link:"index.html?theme={id}",exclusive:!0},prism:{title:"Default",option:"default"},"prism-dark":"Dark","prism-funky":"Funky","prism-okaidia":{title:"Okaidia",owner:"ocodia"},"prism-twilight":{title:"Twilight",owner:"remybach"},"prism-coy":{title:"Coy",owner:"tshedor"},"prism-solarizedlight":{title:"Solarized Light",owner:"hectormatos2011 "},"prism-tomorrow":{title:"Tomorrow Night",owner:"Rosey"}},languages:{meta:{path:"components/prism-{id}",noCSS:!0,examplesPath:"examples/prism-{id}",addCheckAll:!0},markup:{title:"Markup",alias:["html","xml","svg","mathml","ssml","atom","rss"],aliasTitles:{html:"HTML",xml:"XML",svg:"SVG",mathml:"MathML",ssml:"SSML",atom:"Atom",rss:"RSS"},option:"default"},css:{title:"CSS",option:"default",modify:"markup"},clike:{title:"C-like",option:"default"},javascript:{title:"JavaScript",require:"clike",modify:"markup",optional:"regex",alias:"js",option:"default"},abap:{title:"ABAP",owner:"dellagustin"},abnf:{title:"ABNF",owner:"RunDevelopment"},actionscript:{title:"ActionScript",require:"javascript",modify:"markup",owner:"Golmote"},ada:{title:"Ada",owner:"Lucretia"},agda:{title:"Agda",owner:"xy-ren"},al:{title:"AL",owner:"RunDevelopment"},antlr4:{title:"ANTLR4",alias:"g4",owner:"RunDevelopment"},apacheconf:{title:"Apache Configuration",owner:"GuiTeK"},apex:{title:"Apex",require:["clike","sql"],owner:"RunDevelopment"},apl:{title:"APL",owner:"ngn"},applescript:{title:"AppleScript",owner:"Golmote"},aql:{title:"AQL",owner:"RunDevelopment"},arduino:{title:"Arduino",require:"cpp",alias:"ino",owner:"dkern"},arff:{title:"ARFF",owner:"Golmote"},armasm:{title:"ARM Assembly",alias:"arm-asm",owner:"RunDevelopment"},arturo:{title:"Arturo",alias:"art",optional:["bash","css","javascript","markup","markdown","sql"],owner:"drkameleon"},asciidoc:{alias:"adoc",title:"AsciiDoc",owner:"Golmote"},aspnet:{title:"ASP.NET (C#)",require:["markup","csharp"],owner:"nauzilus"},asm6502:{title:"6502 Assembly",owner:"kzurawel"},asmatmel:{title:"Atmel AVR Assembly",owner:"cerkit"},autohotkey:{title:"AutoHotkey",owner:"aviaryan"},autoit:{title:"AutoIt",owner:"Golmote"},avisynth:{title:"AviSynth",alias:"avs",owner:"Zinfidel"},"avro-idl":{title:"Avro IDL",alias:"avdl",owner:"RunDevelopment"},awk:{title:"AWK",alias:"gawk",aliasTitles:{gawk:"GAWK"},owner:"RunDevelopment"},bash:{title:"Bash",alias:["sh","shell"],aliasTitles:{sh:"Shell",shell:"Shell"},owner:"zeitgeist87"},basic:{title:"BASIC",owner:"Golmote"},batch:{title:"Batch",owner:"Golmote"},bbcode:{title:"BBcode",alias:"shortcode",aliasTitles:{shortcode:"Shortcode"},owner:"RunDevelopment"},bbj:{title:"BBj",owner:"hyyan"},bicep:{title:"Bicep",owner:"johnnyreilly"},birb:{title:"Birb",require:"clike",owner:"Calamity210"},bison:{title:"Bison",require:"c",owner:"Golmote"},bnf:{title:"BNF",alias:"rbnf",aliasTitles:{rbnf:"RBNF"},owner:"RunDevelopment"},bqn:{title:"BQN",owner:"yewscion"},brainfuck:{title:"Brainfuck",owner:"Golmote"},brightscript:{title:"BrightScript",owner:"RunDevelopment"},bro:{title:"Bro",owner:"wayward710"},bsl:{title:"BSL (1C:Enterprise)",alias:"oscript",aliasTitles:{oscript:"OneScript"},owner:"Diversus23"},c:{title:"C",require:"clike",owner:"zeitgeist87"},csharp:{title:"C#",require:"clike",alias:["cs","dotnet"],owner:"mvalipour"},cpp:{title:"C++",require:"c",owner:"zeitgeist87"},cfscript:{title:"CFScript",require:"clike",alias:"cfc",owner:"mjclemente"},chaiscript:{title:"ChaiScript",require:["clike","cpp"],owner:"RunDevelopment"},cil:{title:"CIL",owner:"sbrl"},cilkc:{title:"Cilk/C",require:"c",alias:"cilk-c",owner:"OpenCilk"},cilkcpp:{title:"Cilk/C++",require:"cpp",alias:["cilk-cpp","cilk"],owner:"OpenCilk"},clojure:{title:"Clojure",owner:"troglotit"},cmake:{title:"CMake",owner:"mjrogozinski"},cobol:{title:"COBOL",owner:"RunDevelopment"},coffeescript:{title:"CoffeeScript",require:"javascript",alias:"coffee",owner:"R-osey"},concurnas:{title:"Concurnas",alias:"conc",owner:"jasontatton"},csp:{title:"Content-Security-Policy",owner:"ScottHelme"},cooklang:{title:"Cooklang",owner:"ahue"},coq:{title:"Coq",owner:"RunDevelopment"},crystal:{title:"Crystal",require:"ruby",owner:"MakeNowJust"},"css-extras":{title:"CSS Extras",require:"css",modify:"css",owner:"milesj"},csv:{title:"CSV",owner:"RunDevelopment"},cue:{title:"CUE",owner:"RunDevelopment"},cypher:{title:"Cypher",owner:"RunDevelopment"},d:{title:"D",require:"clike",owner:"Golmote"},dart:{title:"Dart",require:"clike",owner:"Golmote"},dataweave:{title:"DataWeave",owner:"machaval"},dax:{title:"DAX",owner:"peterbud"},dhall:{title:"Dhall",owner:"RunDevelopment"},diff:{title:"Diff",owner:"uranusjr"},django:{title:"Django/Jinja2",require:"markup-templating",alias:"jinja2",owner:"romanvm"},"dns-zone-file":{title:"DNS zone file",owner:"RunDevelopment",alias:"dns-zone"},docker:{title:"Docker",alias:"dockerfile",owner:"JustinBeckwith"},dot:{title:"DOT (Graphviz)",alias:"gv",optional:"markup",owner:"RunDevelopment"},ebnf:{title:"EBNF",owner:"RunDevelopment"},editorconfig:{title:"EditorConfig",owner:"osipxd"},eiffel:{title:"Eiffel",owner:"Conaclos"},ejs:{title:"EJS",require:["javascript","markup-templating"],owner:"RunDevelopment",alias:"eta",aliasTitles:{eta:"Eta"}},elixir:{title:"Elixir",owner:"Golmote"},elm:{title:"Elm",owner:"zwilias"},etlua:{title:"Embedded Lua templating",require:["lua","markup-templating"],owner:"RunDevelopment"},erb:{title:"ERB",require:["ruby","markup-templating"],owner:"Golmote"},erlang:{title:"Erlang",owner:"Golmote"},"excel-formula":{title:"Excel Formula",alias:["xlsx","xls"],owner:"RunDevelopment"},fsharp:{title:"F#",require:"clike",owner:"simonreynolds7"},factor:{title:"Factor",owner:"catb0t"},false:{title:"False",owner:"edukisto"},"firestore-security-rules":{title:"Firestore security rules",require:"clike",owner:"RunDevelopment"},flow:{title:"Flow",require:"javascript",owner:"Golmote"},fortran:{title:"Fortran",owner:"Golmote"},ftl:{title:"FreeMarker Template Language",require:"markup-templating",owner:"RunDevelopment"},gml:{title:"GameMaker Language",alias:"gamemakerlanguage",require:"clike",owner:"LiarOnce"},gap:{title:"GAP (CAS)",owner:"RunDevelopment"},gcode:{title:"G-code",owner:"RunDevelopment"},gdscript:{title:"GDScript",owner:"RunDevelopment"},gedcom:{title:"GEDCOM",owner:"Golmote"},gettext:{title:"gettext",alias:"po",owner:"RunDevelopment"},gherkin:{title:"Gherkin",owner:"hason"},git:{title:"Git",owner:"lgiraudel"},glsl:{title:"GLSL",require:"c",owner:"Golmote"},gn:{title:"GN",alias:"gni",owner:"RunDevelopment"},"linker-script":{title:"GNU Linker Script",alias:"ld",owner:"RunDevelopment"},go:{title:"Go",require:"clike",owner:"arnehormann"},"go-module":{title:"Go module",alias:"go-mod",owner:"RunDevelopment"},gradle:{title:"Gradle",require:"clike",owner:"zeabdelkhalek-badido18"},graphql:{title:"GraphQL",optional:"markdown",owner:"Golmote"},groovy:{title:"Groovy",require:"clike",owner:"robfletcher"},haml:{title:"Haml",require:"ruby",optional:["css","css-extras","coffeescript","erb","javascript","less","markdown","scss","textile"],owner:"Golmote"},handlebars:{title:"Handlebars",require:"markup-templating",alias:["hbs","mustache"],aliasTitles:{mustache:"Mustache"},owner:"Golmote"},haskell:{title:"Haskell",alias:"hs",owner:"bholst"},haxe:{title:"Haxe",require:"clike",optional:"regex",owner:"Golmote"},hcl:{title:"HCL",owner:"outsideris"},hlsl:{title:"HLSL",require:"c",owner:"RunDevelopment"},hoon:{title:"Hoon",owner:"matildepark"},http:{title:"HTTP",optional:["csp","css","hpkp","hsts","javascript","json","markup","uri"],owner:"danielgtaylor"},hpkp:{title:"HTTP Public-Key-Pins",owner:"ScottHelme"},hsts:{title:"HTTP Strict-Transport-Security",owner:"ScottHelme"},ichigojam:{title:"IchigoJam",owner:"BlueCocoa"},icon:{title:"Icon",owner:"Golmote"},"icu-message-format":{title:"ICU Message Format",owner:"RunDevelopment"},idris:{title:"Idris",alias:"idr",owner:"KeenS",require:"haskell"},ignore:{title:".ignore",owner:"osipxd",alias:["gitignore","hgignore","npmignore"],aliasTitles:{gitignore:".gitignore",hgignore:".hgignore",npmignore:".npmignore"}},inform7:{title:"Inform 7",owner:"Golmote"},ini:{title:"Ini",owner:"aviaryan"},io:{title:"Io",owner:"AlesTsurko"},j:{title:"J",owner:"Golmote"},java:{title:"Java",require:"clike",owner:"sherblot"},javadoc:{title:"JavaDoc",require:["markup","java","javadoclike"],modify:"java",optional:"scala",owner:"RunDevelopment"},javadoclike:{title:"JavaDoc-like",modify:["java","javascript","php"],owner:"RunDevelopment"},javastacktrace:{title:"Java stack trace",owner:"RunDevelopment"},jexl:{title:"Jexl",owner:"czosel"},jolie:{title:"Jolie",require:"clike",owner:"thesave"},jq:{title:"JQ",owner:"RunDevelopment"},jsdoc:{title:"JSDoc",require:["javascript","javadoclike","typescript"],modify:"javascript",optional:["actionscript","coffeescript"],owner:"RunDevelopment"},"js-extras":{title:"JS Extras",require:"javascript",modify:"javascript",optional:["actionscript","coffeescript","flow","n4js","typescript"],owner:"RunDevelopment"},json:{title:"JSON",alias:"webmanifest",aliasTitles:{webmanifest:"Web App Manifest"},owner:"CupOfTea696"},json5:{title:"JSON5",require:"json",owner:"RunDevelopment"},jsonp:{title:"JSONP",require:"json",owner:"RunDevelopment"},jsstacktrace:{title:"JS stack trace",owner:"sbrl"},"js-templates":{title:"JS Templates",require:"javascript",modify:"javascript",optional:["css","css-extras","graphql","markdown","markup","sql"],owner:"RunDevelopment"},julia:{title:"Julia",owner:"cdagnino"},keepalived:{title:"Keepalived Configure",owner:"dev-itsheng"},keyman:{title:"Keyman",owner:"mcdurdin"},kotlin:{title:"Kotlin",alias:["kt","kts"],aliasTitles:{kts:"Kotlin Script"},require:"clike",owner:"Golmote"},kumir:{title:"KuMir (\u041a\u0443\u041c\u0438\u0440)",alias:"kum",owner:"edukisto"},kusto:{title:"Kusto",owner:"RunDevelopment"},latex:{title:"LaTeX",alias:["tex","context"],aliasTitles:{tex:"TeX",context:"ConTeXt"},owner:"japborst"},latte:{title:"Latte",require:["clike","markup-templating","php"],owner:"nette"},less:{title:"Less",require:"css",optional:"css-extras",owner:"Golmote"},lilypond:{title:"LilyPond",require:"scheme",alias:"ly",owner:"RunDevelopment"},liquid:{title:"Liquid",require:"markup-templating",owner:"cinhtau"},lisp:{title:"Lisp",alias:["emacs","elisp","emacs-lisp"],owner:"JuanCaicedo"},livescript:{title:"LiveScript",owner:"Golmote"},llvm:{title:"LLVM IR",owner:"porglezomp"},log:{title:"Log file",optional:"javastacktrace",owner:"RunDevelopment"},lolcode:{title:"LOLCODE",owner:"Golmote"},lua:{title:"Lua",owner:"Golmote"},magma:{title:"Magma (CAS)",owner:"RunDevelopment"},makefile:{title:"Makefile",owner:"Golmote"},markdown:{title:"Markdown",require:"markup",optional:"yaml",alias:"md",owner:"Golmote"},"markup-templating":{title:"Markup templating",require:"markup",owner:"Golmote"},mata:{title:"Mata",owner:"RunDevelopment"},matlab:{title:"MATLAB",owner:"Golmote"},maxscript:{title:"MAXScript",owner:"RunDevelopment"},mel:{title:"MEL",owner:"Golmote"},mermaid:{title:"Mermaid",owner:"RunDevelopment"},metafont:{title:"METAFONT",owner:"LaeriExNihilo"},mizar:{title:"Mizar",owner:"Golmote"},mongodb:{title:"MongoDB",owner:"airs0urce",require:"javascript"},monkey:{title:"Monkey",owner:"Golmote"},moonscript:{title:"MoonScript",alias:"moon",owner:"RunDevelopment"},n1ql:{title:"N1QL",owner:"TMWilds"},n4js:{title:"N4JS",require:"javascript",optional:"jsdoc",alias:"n4jsd",owner:"bsmith-n4"},"nand2tetris-hdl":{title:"Nand To Tetris HDL",owner:"stephanmax"},naniscript:{title:"Naninovel Script",owner:"Elringus",alias:"nani"},nasm:{title:"NASM",owner:"rbmj"},neon:{title:"NEON",owner:"nette"},nevod:{title:"Nevod",owner:"nezaboodka"},nginx:{title:"nginx",owner:"volado"},nim:{title:"Nim",owner:"Golmote"},nix:{title:"Nix",owner:"Golmote"},nsis:{title:"NSIS",owner:"idleberg"},objectivec:{title:"Objective-C",require:"c",alias:"objc",owner:"uranusjr"},ocaml:{title:"OCaml",owner:"Golmote"},odin:{title:"Odin",owner:"edukisto"},opencl:{title:"OpenCL",require:"c",modify:["c","cpp"],owner:"Milania1"},openqasm:{title:"OpenQasm",alias:"qasm",owner:"RunDevelopment"},oz:{title:"Oz",owner:"Golmote"},parigp:{title:"PARI/GP",owner:"Golmote"},parser:{title:"Parser",require:"markup",owner:"Golmote"},pascal:{title:"Pascal",alias:"objectpascal",aliasTitles:{objectpascal:"Object Pascal"},owner:"Golmote"},pascaligo:{title:"Pascaligo",owner:"DefinitelyNotAGoat"},psl:{title:"PATROL Scripting Language",owner:"bertysentry"},pcaxis:{title:"PC-Axis",alias:"px",owner:"RunDevelopment"},peoplecode:{title:"PeopleCode",alias:"pcode",owner:"RunDevelopment"},perl:{title:"Perl",owner:"Golmote"},php:{title:"PHP",require:"markup-templating",owner:"milesj"},phpdoc:{title:"PHPDoc",require:["php","javadoclike"],modify:"php",owner:"RunDevelopment"},"php-extras":{title:"PHP Extras",require:"php",modify:"php",owner:"milesj"},"plant-uml":{title:"PlantUML",alias:"plantuml",owner:"RunDevelopment"},plsql:{title:"PL/SQL",require:"sql",owner:"Golmote"},powerquery:{title:"PowerQuery",alias:["pq","mscript"],owner:"peterbud"},powershell:{title:"PowerShell",owner:"nauzilus"},processing:{title:"Processing",require:"clike",owner:"Golmote"},prolog:{title:"Prolog",owner:"Golmote"},promql:{title:"PromQL",owner:"arendjr"},properties:{title:".properties",owner:"Golmote"},protobuf:{title:"Protocol Buffers",require:"clike",owner:"just-boris"},pug:{title:"Pug",require:["markup","javascript"],optional:["coffeescript","ejs","handlebars","less","livescript","markdown","scss","stylus","twig"],owner:"Golmote"},puppet:{title:"Puppet",owner:"Golmote"},pure:{title:"Pure",optional:["c","cpp","fortran"],owner:"Golmote"},purebasic:{title:"PureBasic",require:"clike",alias:"pbfasm",owner:"HeX0R101"},purescript:{title:"PureScript",require:"haskell",alias:"purs",owner:"sriharshachilakapati"},python:{title:"Python",alias:"py",owner:"multipetros"},qsharp:{title:"Q#",require:"clike",alias:"qs",owner:"fedonman"},q:{title:"Q (kdb+ database)",owner:"Golmote"},qml:{title:"QML",require:"javascript",owner:"RunDevelopment"},qore:{title:"Qore",require:"clike",owner:"temnroegg"},r:{title:"R",owner:"Golmote"},racket:{title:"Racket",require:"scheme",alias:"rkt",owner:"RunDevelopment"},cshtml:{title:"Razor C#",alias:"razor",require:["markup","csharp"],optional:["css","css-extras","javascript","js-extras"],owner:"RunDevelopment"},jsx:{title:"React JSX",require:["markup","javascript"],optional:["jsdoc","js-extras","js-templates"],owner:"vkbansal"},tsx:{title:"React TSX",require:["jsx","typescript"]},reason:{title:"Reason",require:"clike",owner:"Golmote"},regex:{title:"Regex",owner:"RunDevelopment"},rego:{title:"Rego",owner:"JordanSh"},renpy:{title:"Ren'py",alias:"rpy",owner:"HyuchiaDiego"},rescript:{title:"ReScript",alias:"res",owner:"vmarcosp"},rest:{title:"reST (reStructuredText)",owner:"Golmote"},rip:{title:"Rip",owner:"ravinggenius"},roboconf:{title:"Roboconf",owner:"Golmote"},robotframework:{title:"Robot Framework",alias:"robot",owner:"RunDevelopment"},ruby:{title:"Ruby",require:"clike",alias:"rb",owner:"samflores"},rust:{title:"Rust",owner:"Golmote"},sas:{title:"SAS",optional:["groovy","lua","sql"],owner:"Golmote"},sass:{title:"Sass (Sass)",require:"css",optional:"css-extras",owner:"Golmote"},scss:{title:"Sass (SCSS)",require:"css",optional:"css-extras",owner:"MoOx"},scala:{title:"Scala",require:"java",owner:"jozic"},scheme:{title:"Scheme",owner:"bacchus123"},"shell-session":{title:"Shell session",require:"bash",alias:["sh-session","shellsession"],owner:"RunDevelopment"},smali:{title:"Smali",owner:"RunDevelopment"},smalltalk:{title:"Smalltalk",owner:"Golmote"},smarty:{title:"Smarty",require:"markup-templating",optional:"php",owner:"Golmote"},sml:{title:"SML",alias:"smlnj",aliasTitles:{smlnj:"SML/NJ"},owner:"RunDevelopment"},solidity:{title:"Solidity (Ethereum)",alias:"sol",require:"clike",owner:"glachaud"},"solution-file":{title:"Solution file",alias:"sln",owner:"RunDevelopment"},soy:{title:"Soy (Closure Template)",require:"markup-templating",owner:"Golmote"},sparql:{title:"SPARQL",require:"turtle",owner:"Triply-Dev",alias:"rq"},"splunk-spl":{title:"Splunk SPL",owner:"RunDevelopment"},sqf:{title:"SQF: Status Quo Function (Arma 3)",require:"clike",owner:"RunDevelopment"},sql:{title:"SQL",owner:"multipetros"},squirrel:{title:"Squirrel",require:"clike",owner:"RunDevelopment"},stan:{title:"Stan",owner:"RunDevelopment"},stata:{title:"Stata Ado",require:["mata","java","python"],owner:"RunDevelopment"},iecst:{title:"Structured Text (IEC 61131-3)",owner:"serhioromano"},stylus:{title:"Stylus",owner:"vkbansal"},supercollider:{title:"SuperCollider",alias:"sclang",owner:"RunDevelopment"},swift:{title:"Swift",owner:"chrischares"},systemd:{title:"Systemd configuration file",owner:"RunDevelopment"},"t4-templating":{title:"T4 templating",owner:"RunDevelopment"},"t4-cs":{title:"T4 Text Templates (C#)",require:["t4-templating","csharp"],alias:"t4",owner:"RunDevelopment"},"t4-vb":{title:"T4 Text Templates (VB)",require:["t4-templating","vbnet"],owner:"RunDevelopment"},tap:{title:"TAP",owner:"isaacs",require:"yaml"},tcl:{title:"Tcl",owner:"PeterChaplin"},tt2:{title:"Template Toolkit 2",require:["clike","markup-templating"],owner:"gflohr"},textile:{title:"Textile",require:"markup",optional:"css",owner:"Golmote"},toml:{title:"TOML",owner:"RunDevelopment"},tremor:{title:"Tremor",alias:["trickle","troy"],owner:"darach",aliasTitles:{trickle:"trickle",troy:"troy"}},turtle:{title:"Turtle",alias:"trig",aliasTitles:{trig:"TriG"},owner:"jakubklimek"},twig:{title:"Twig",require:"markup-templating",owner:"brandonkelly"},typescript:{title:"TypeScript",require:"javascript",optional:"js-templates",alias:"ts",owner:"vkbansal"},typoscript:{title:"TypoScript",alias:"tsconfig",aliasTitles:{tsconfig:"TSConfig"},owner:"dkern"},unrealscript:{title:"UnrealScript",alias:["uscript","uc"],owner:"RunDevelopment"},uorazor:{title:"UO Razor Script",owner:"jaseowns"},uri:{title:"URI",alias:"url",aliasTitles:{url:"URL"},owner:"RunDevelopment"},v:{title:"V",require:"clike",owner:"taggon"},vala:{title:"Vala",require:"clike",optional:"regex",owner:"TemplarVolk"},vbnet:{title:"VB.Net",require:"basic",owner:"Bigsby"},velocity:{title:"Velocity",require:"markup",owner:"Golmote"},verilog:{title:"Verilog",owner:"a-rey"},vhdl:{title:"VHDL",owner:"a-rey"},vim:{title:"vim",owner:"westonganger"},"visual-basic":{title:"Visual Basic",alias:["vb","vba"],aliasTitles:{vba:"VBA"},owner:"Golmote"},warpscript:{title:"WarpScript",owner:"RunDevelopment"},wasm:{title:"WebAssembly",owner:"Golmote"},"web-idl":{title:"Web IDL",alias:"webidl",owner:"RunDevelopment"},wgsl:{title:"WGSL",owner:"Dr4gonthree"},wiki:{title:"Wiki markup",require:"markup",owner:"Golmote"},wolfram:{title:"Wolfram language",alias:["mathematica","nb","wl"],aliasTitles:{mathematica:"Mathematica",nb:"Mathematica Notebook"},owner:"msollami"},wren:{title:"Wren",owner:"clsource"},xeora:{title:"Xeora",require:"markup",alias:"xeoracube",aliasTitles:{xeoracube:"XeoraCube"},owner:"freakmaxi"},"xml-doc":{title:"XML doc (.net)",require:"markup",modify:["csharp","fsharp","vbnet"],owner:"RunDevelopment"},xojo:{title:"Xojo (REALbasic)",owner:"Golmote"},xquery:{title:"XQuery",require:"markup",owner:"Golmote"},yaml:{title:"YAML",alias:"yml",owner:"hason"},yang:{title:"YANG",owner:"RunDevelopment"},zig:{title:"Zig",owner:"RunDevelopment"}},plugins:{meta:{path:"plugins/{id}/prism-{id}",link:"plugins/{id}/"},"line-highlight":{title:"Line Highlight",description:"Highlights specific lines and/or line ranges."},"line-numbers":{title:"Line Numbers",description:"Line number at the beginning of code lines.",owner:"kuba-kubula"},"show-invisibles":{title:"Show Invisibles",description:"Show hidden characters such as tabs and line breaks.",optional:["autolinker","data-uri-highlight"]},autolinker:{title:"Autolinker",description:"Converts URLs and emails in code to clickable links. Parses Markdown links in comments."},wpd:{title:"WebPlatform Docs",description:'Makes tokens link to WebPlatform.org documentation. The links open in a new tab.'},"custom-class":{title:"Custom Class",description:"This plugin allows you to prefix Prism's default classes (.comment can become .namespace--comment) or replace them with your defined ones (like .editor__comment). You can even add new classes.",owner:"dvkndn",noCSS:!0},"file-highlight":{title:"File Highlight",description:"Fetch external files and highlight them with Prism. Used on the Prism website itself.",noCSS:!0},"show-language":{title:"Show Language",description:"Display the highlighted language in code blocks (inline code does not show the label).",owner:"nauzilus",noCSS:!0,require:"toolbar"},"jsonp-highlight":{title:"JSONP Highlight",description:"Fetch content with JSONP and highlight some interesting content (e.g. GitHub/Gists or Bitbucket API).",noCSS:!0,owner:"nauzilus"},"highlight-keywords":{title:"Highlight Keywords",description:"Adds special CSS classes for each keyword for fine-grained highlighting.",owner:"vkbansal",noCSS:!0},"remove-initial-line-feed":{title:"Remove initial line feed",description:"Removes the initial line feed in code blocks.",owner:"Golmote",noCSS:!0},"inline-color":{title:"Inline color",description:"Adds a small inline preview for colors in style sheets.",require:"css-extras",owner:"RunDevelopment"},previewers:{title:"Previewers",description:"Previewers for angles, colors, gradients, easing and time.",require:"css-extras",owner:"Golmote"},autoloader:{title:"Autoloader",description:"Automatically loads the needed languages to highlight the code blocks.",owner:"Golmote",noCSS:!0},"keep-markup":{title:"Keep Markup",description:"Prevents custom markup from being dropped out during highlighting.",owner:"Golmote",optional:"normalize-whitespace",noCSS:!0},"command-line":{title:"Command Line",description:"Display a command line with a prompt and, optionally, the output/response from the commands.",owner:"chriswells0"},"unescaped-markup":{title:"Unescaped Markup",description:"Write markup without having to escape anything."},"normalize-whitespace":{title:"Normalize Whitespace",description:"Supports multiple operations to normalize whitespace in code blocks.",owner:"zeitgeist87",optional:"unescaped-markup",noCSS:!0},"data-uri-highlight":{title:"Data-URI Highlight",description:"Highlights data-URI contents.",owner:"Golmote",noCSS:!0},toolbar:{title:"Toolbar",description:"Attach a toolbar for plugins to easily register buttons on the top of a code block.",owner:"mAAdhaTTah"},"copy-to-clipboard":{title:"Copy to Clipboard Button",description:"Add a button that copies the code block to the clipboard when clicked.",owner:"mAAdhaTTah",require:"toolbar",noCSS:!0},"download-button":{title:"Download Button",description:"A button in the toolbar of a code block adding a convenient way to download a code file.",owner:"Golmote",require:"toolbar",noCSS:!0},"match-braces":{title:"Match braces",description:"Highlights matching braces.",owner:"RunDevelopment"},"diff-highlight":{title:"Diff Highlight",description:"Highlights the code inside diff blocks.",owner:"RunDevelopment",require:"diff"},"filter-highlight-all":{title:"Filter highlightAll",description:"Filters the elements the highlightAll and highlightAllUnder methods actually highlight.",owner:"RunDevelopment",noCSS:!0},treeview:{title:"Treeview",description:"A language with special styles to highlight file system tree structures.",owner:"Golmote"}}})},452:(e,t,n)=>{const r=n(7248),o=n(8284),a=new Set;function i(e){void 0===e?e=Object.keys(r.languages).filter((e=>"meta"!=e)):Array.isArray(e)||(e=[e]);const t=[...a,...Object.keys(Prism.languages)];o(r,e,t).load((e=>{if(!(e in r.languages))return void(i.silent||console.warn("Language does not exist: "+e));const t="./prism-"+e;delete n.c[n(1976).resolve(t)],delete Prism.languages[e],n(1976)(t),a.add(e)}))}i.silent=!1,e.exports=i},1808:()=>{!function(e){function t(e,t){return"___"+e.toUpperCase()+t+"___"}Object.defineProperties(e.languages["markup-templating"]={},{buildPlaceholders:{value:function(n,r,o,a){if(n.language===r){var i=n.tokenStack=[];n.code=n.code.replace(o,(function(e){if("function"==typeof a&&!a(e))return e;for(var o,l=i.length;-1!==n.code.indexOf(o=t(r,l));)++l;return i[l]=e,o})),n.grammar=e.languages.markup}}},tokenizePlaceholders:{value:function(n,r){if(n.language===r&&n.tokenStack){n.grammar=e.languages[r];var o=0,a=Object.keys(n.tokenStack);!function i(l){for(var s=0;s=a.length);s++){var c=l[s];if("string"==typeof c||c.content&&"string"==typeof c.content){var u=a[o],d=n.tokenStack[u],p="string"==typeof c?c:c.content,f=t(r,u),g=p.indexOf(f);if(g>-1){++o;var m=p.substring(0,g),h=new e.Token(r,e.tokenize(d,n.grammar),"language-"+r,d),y=p.substring(g+f.length),b=[];m&&b.push.apply(b,i([m])),b.push(h),y&&b.push.apply(b,i([y])),"string"==typeof c?l.splice.apply(l,[s,1].concat(b)):c.content=b}}else c.content&&i(c.content)}return l}(n.tokens)}}}})}(Prism)},8660:(e,t,n)=>{var r={"./":452};function o(e){var t=a(e);return n(t)}function a(e){if(!n.o(r,e)){var t=new Error("Cannot find module '"+e+"'");throw t.code="MODULE_NOT_FOUND",t}return r[e]}o.keys=function(){return Object.keys(r)},o.resolve=a,e.exports=o,o.id=8660},1976:(e,t,n)=>{var r={"./":452};function o(e){var t=a(e);return n(t)}function a(e){if(!n.o(r,e)){var t=new Error("Cannot find module '"+e+"'");throw t.code="MODULE_NOT_FOUND",t}return r[e]}o.keys=function(){return Object.keys(r)},o.resolve=a,e.exports=o,o.id=1976},8284:e=>{"use strict";var t=function(){var e=function(){};function t(e,t){Array.isArray(e)?e.forEach(t):null!=e&&t(e,0)}function n(e){for(var t={},n=0,r=e.length;n "));var l={},s=e[r];if(s){function c(t){if(!(t in e))throw new Error(r+" depends on an unknown component "+t);if(!(t in l))for(var i in o(t,a),l[t]=!0,n[t])l[i]=!0}t(s.require,c),t(s.optional,c),t(s.modify,c)}n[r]=l,a.pop()}}return function(e){var t=n[e];return t||(o(e,r),t=n[e]),t}}function o(e){for(var t in e)return!0;return!1}return function(a,i,l){var s=function(e){var t={};for(var n in e){var r=e[n];for(var o in r)if("meta"!=o){var a=r[o];t[o]="string"==typeof a?{title:a}:a}}return t}(a),c=function(e){var n;return function(r){if(r in e)return r;if(!n)for(var o in n={},e){var a=e[o];t(a&&a.alias,(function(t){if(t in n)throw new Error(t+" cannot be alias for both "+o+" and "+n[t]);if(t in e)throw new Error(t+" cannot be alias of "+o+" because it is a component.");n[t]=o}))}return n[r]||r}}(s);i=i.map(c),l=(l||[]).map(c);var u=n(i),d=n(l);i.forEach((function e(n){var r=s[n];t(r&&r.require,(function(t){t in d||(u[t]=!0,e(t))}))}));for(var p,f=r(s),g=u;o(g);){for(var m in p={},g){var h=s[m];t(h&&h.modify,(function(e){e in d&&(p[e]=!0)}))}for(var y in d)if(!(y in u))for(var b in f(y))if(b in u){p[y]=!0;break}for(var v in g=p)u[v]=!0}var w={getIds:function(){var e=[];return w.load((function(t){e.push(t)})),e},load:function(t,n){return function(t,n,r,o){var a=o?o.series:void 0,i=o?o.parallel:e,l={},s={};function c(e){if(e in l)return l[e];s[e]=!0;var o,u=[];for(var d in t(e))d in n&&u.push(d);if(0===u.length)o=r(e);else{var p=i(u.map((function(e){var t=c(e);return delete s[e],t})));a?o=a(p,(function(){return r(e)})):r(e)}return l[e]=o}for(var u in n)c(u);var d=[];for(var p in s)d.push(l[p]);return i(d)}(f,u,t,n)}};return w}}();e.exports=t},9776:(e,t,n)=>{"use strict";var r=n(9143);function o(){}function a(){}a.resetWarningCache=o,e.exports=function(){function e(e,t,n,o,a,i){if(i!==r){var l=new Error("Calling PropTypes validators directly is not supported by the `prop-types` package. Use PropTypes.checkPropTypes() to call them. Read more at http://fb.me/use-check-prop-types");throw l.name="Invariant Violation",l}}function t(){return e}e.isRequired=e;var n={array:e,bigint:e,bool:e,func:e,number:e,object:e,string:e,symbol:e,any:e,arrayOf:t,element:e,elementType:e,instanceOf:t,node:e,objectOf:t,oneOf:t,oneOfType:t,shape:t,exact:t,checkPropTypes:a,resetWarningCache:o};return n.PropTypes=n,n}},3268:(e,t,n)=>{e.exports=n(9776)()},9143:e=>{"use strict";e.exports="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED"},9516:(e,t,n)=>{"use strict";var r=n(1504),o=n(4712);function a(e){for(var t="https://reactjs.org/docs/error-decoder.html?invariant="+e,n=1;n