From 5a130ffe4841e94dab13d9a6d6dd9577f50db3cf Mon Sep 17 00:00:00 2001
From: Ben Holmes <hey@bholmes.dev>
Date: Fri, 27 May 2022 16:56:18 -0400
Subject: [PATCH 01/41] New: markdown `rawContent()` and `compiledContent()`
 helpers (#668)

* new: rawContent and rawContent.html docs with examples

* format: tab code blocks inline with bullets

* fix: reading time ex syntax errors

* edit: change to new content.raw() and content.compiled()

* nit: capitalize Markdown

* refactor: change API to rawContent, compiledContent
---
 src/pages/en/guides/markdown-content.md | 36 +++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/src/pages/en/guides/markdown-content.md b/src/pages/en/guides/markdown-content.md
index 721808f7464f4..bd799dd122a79 100644
--- a/src/pages/en/guides/markdown-content.md
+++ b/src/pages/en/guides/markdown-content.md
@@ -222,6 +222,42 @@ Each Markdown file exports the following properties:
 - `file`: The absolute path of this file (e.g. `/home/user/projects/.../file.md`).
 - `url`: If it's a page, URL of the page (e.g. `/en/guides/markdown-content`).
 - `getHeaders()`: An async function that returns the headers of the Markdown file. The response follows this type: `{ depth: number; slug: string; text: string }[]`.
+- `rawContent()`: A function that returns the raw content of the Markdown file (excluding the frontmatter block) as a string. This is helpful when, say, calculating "minutes read." This example uses the [popular reading-time package](https://www.npmjs.com/package/reading-time):
+
+  ```astro
+  ---
+  import readingTime from 'reading-time';
+  const posts = await Astro.glob('./posts/**/*.md');
+  ---
+
+  {posts.map((post) => (
+    <Fragment>
+      <h2>{post.frontmatter.title}</h2>
+      <p>{readingTime(post.rawContent()).text}</p>
+    </Fragment>
+  ))}
+  ```
+
+- `compiledContent()`: An asynchronous function that returns the raw content parsed to valid Astro syntax. Note: **This does not parse `{jsx expressions}`, `<Components />` or layouts**! Only standard Markdown blocks like `## headings` and `- lists` will be parsed to HTML. This is useful when, say, rendering a summary block for a blog post. Since Astro syntax is valid HTML, we can use popular libraries like [node-html-parser](https://www.npmjs.com/package/node-html-parser) to query for the first paragraph like so:
+
+  ```astro
+  ---
+  import { parse } from 'node-html-parser';
+  const posts = await Astro.glob('./posts/**/*.md');
+  ---
+
+  {posts.map(async (post) => {
+    const firstParagraph = parse(await post.compiledContent())
+      .querySelector('p:first-of-type');
+    return (
+      <Fragment>
+        <h2>{post.frontmatter.title}</h2>
+        {firstParagraph ? <p>{firstParagraph.innerText}</p> : null}
+      </Fragment>
+    );
+  })}
+  ```
+
 - `Content`: A component that renders the contents of the Markdown file. Here is an example:
 
   ```astro

From a5279885203710bcff84e526a66dd0dcd14160a0 Mon Sep 17 00:00:00 2001
From: Raimund <git@rai-canzler.de>
Date: Sat, 28 May 2022 00:34:50 +0200
Subject: [PATCH 02/41] i18n(de): add `core-concepts/astro-pages.md` (#671)

* i18n(de): add `core-concepts/astro-pages.md`

* use German heading in link

* Fix typos and wording

* Apply suggestions from code review

Co-authored-by: hippotastic <6137925+hippotastic@users.noreply.github.com>

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
Co-authored-by: hippotastic <6137925+hippotastic@users.noreply.github.com>
---
 src/pages/de/core-concepts/astro-pages.md | 129 ++++++++++++++++++++++
 1 file changed, 129 insertions(+)
 create mode 100644 src/pages/de/core-concepts/astro-pages.md

diff --git a/src/pages/de/core-concepts/astro-pages.md b/src/pages/de/core-concepts/astro-pages.md
new file mode 100644
index 0000000000000..f7763e0d8aa25
--- /dev/null
+++ b/src/pages/de/core-concepts/astro-pages.md
@@ -0,0 +1,129 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Seiten
+description: Eine Einführung in die Astro-Seiten
+---
+
+**Seiten** sind ein spezieller Typ von [Astro-Komponenten](/de/core-concepts/astro-components/), die sich im Unterverzeichnis `src/pages/` befinden. Sie sind verantwortlich für das Routing, das Laden von Daten und das gesamte Seitenlayout für jede HTML-Seite in deiner Website.
+
+### Dateibasiertes Routing
+
+Astro nutzt eine Routing-Strategie, die **dateibasiertes Routing** genannt wird. Jede `.astro`-Datei im `src/pages`-Verzeichnis wird zu einer Seite oder einem Endpunkt auf deiner Website, basierend auf ihrem Dateipfad.
+
+📚 Lies mehr über [Routing in Astro](/de/core-concepts/routing/)
+
+### Seiten-HTML
+
+Astro-Seiten müssen eine vollständige `<html>...</html>`-Seitenantwort zurückgeben, einschließlich `<head>` und `<body>`. (`<!doctype html>` ist optional und wird automatisch hinzugefügt.)
+
+```astro
+---
+// Beispiel: src/pages/index.astro
+---
+<html>
+  <head>
+    <title>Meine Homepage</title>
+  </head>
+  <body>
+    <h1>Willkommen auf meiner Website!</h1>
+  </body>
+</html>
+```
+
+### Nutzung von Seitenlayouts
+
+Um zu vermeiden, dass sich dieselben HTML-Elemente auf jeder Seite wiederholen, kannst du gemeinsame `<head>`- und `<body>`-Elemente in ihre eigenen [Layout-Komponenten](/de/core-concepts/layouts/) verschieben. Du kannst so viele oder so wenige Layout-Komponenten verwenden, wie du möchtest.
+
+```astro
+---
+// Beispiel: src/pages/index.astro
+import MeinLayout from '../layouts/MeinLayout.astro';
+---
+<MeinLayout>
+  <p>Mein Seiteninhalt, umgeben von einem Layout!</p>
+</MeinLayout>
+```
+
+📚 Lies mehr über [Layout-Komponenten](/de/core-concepts/layouts/) in Astro.
+
+
+## Markdown-Seiten
+
+Astro behandelt auch alle Markdown-Dateien (`.md`) innerhalb von `/src/pages/` als Seiten in deiner finalen Website. Diese werden üblicherweise für textlastige Seiten wie Blogbeiträge und Dokumentationen verwendet.
+
+Seitenlayouts sind besonders nützlich für [Markdown-Dateien](#markdown-seiten). Markdown-Dateien können die spezielle Frontmatter-Eigenschaft `layout` verwenden, um eine [Layout-Komponente](/de/core-concepts/layouts/) zu spezifizieren, welche den Markdown-Inhalt in ein vollständiges `<html>...</html>`-Dokument einbettet.
+
+```md
+---
+# Beispiel: src/pages/page.md
+layout: '../layouts/MeinLayout.astro'
+title: 'Meine Markdown-Seite'
+---
+# Titel
+
+Das hier ist meine Seite, geschrieben in **Markdown.**
+```
+
+📚 Lies mehr über [Markdown](/de/guides/markdown-content/) in Astro.
+
+
+## Nicht-HTML-Seiten
+
+Nicht-HTML-Seiten, z. B. `.json`, `.xml` oder sogar Bilder, können über API-Routen erstellt werden, die gemeinhin als **Dateirouten** bezeichnet werden.
+
+**Dateirouten** sind Skriptdateien, die mit der Erweiterung `.js` oder `.ts` enden und sich im Verzeichnis `src/pages/` befinden.
+
+Erstellte Dateinamen und Erweiterungen basieren auf den Namen der Quelldateien. Die Datei `src/pages/data.json.ts` wird z. B. so erstellt, dass sie der `/data.json`-Route in deinem endgültigen Build entspricht.
+
+Bei SSR (server-side rendering) spielt die Erweiterung keine Rolle und kann weggelassen werden, da zum Zeitpunkt der Erstellung keine Dateien erzeugt werden. Stattdessen erzeugt Astro eine einzige Serverdatei.
+
+```js
+// Beispiel: src/pages/builtwith.json.ts
+// Ausgabe: /builtwith.json
+
+// Dateirouten exportieren eine get()-Funktion, die aufgerufen wird, um die Datei zu erzeugen.
+// Gib ein Objekt mit `body` zurück, um den Inhalt der Datei in deinem endgültigen Build zu speichern.
+export async function get() {
+  return {
+    body: JSON.stringify({
+      name: 'Astro',
+      url: 'https://astro.build/',
+    }),
+  };
+}
+```
+
+API-Routen erhalten ein `APIContext`-Objekt, das [Parameter (params)](/de/reference/api-reference/#params) und eine [Anfrage (request)](https://developer.mozilla.org/en-US/docs/Web/API/Request) enthält:
+
+```ts
+import type { APIContext } from 'astro';
+
+export async function get({ params, request }: APIContext) {
+  return {
+    body: JSON.stringify({
+      path: new URL(request.url).pathname
+    })
+  };
+}
+```
+
+Optional kannst du deine API-Routenfunktionen auch unter Verwendung des Typs `APIRoute` eingeben. Dadurch erhältst du bessere Fehlermeldungen, wenn deine API-Route den falschen Typ zurückgibt:
+
+```ts
+import type { APIRoute } from 'astro';
+
+export const get: APIRoute = ({ params, request }) => {
+  return {
+    body: JSON.stringify({
+      path: new URL(request.url).pathname
+    })
+  };
+};
+```
+
+## Benutzerdefinierte 404-Fehlerseite
+
+Für eine benutzerdefinierte 404-Fehlerseite kannst du eine Datei namens `404.astro` oder `404.md` in `/src/pages` erstellen.
+
+Aus dieser wird die Seite `404.html` erstellt. Die meisten [Hosting-Anbieter](/de/guides/deploy/) werden sie finden und verwenden.
+

From 36d1b6acf9f798f320a2e7b7f27a09be65a78e7e Mon Sep 17 00:00:00 2001
From: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com>
Date: Fri, 27 May 2022 21:43:23 -0300
Subject: [PATCH 03/41] Update pt-BR `markdown-content.md` (#680)

---
 src/pages/pt-BR/guides/markdown-content.md | 34 ++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/src/pages/pt-BR/guides/markdown-content.md b/src/pages/pt-BR/guides/markdown-content.md
index babbaca5d0aca..99e55cb46ec5b 100644
--- a/src/pages/pt-BR/guides/markdown-content.md
+++ b/src/pages/pt-BR/guides/markdown-content.md
@@ -221,6 +221,40 @@ Cada arquivo Markdown exporta as seguintes propriedades:
 - `file`: O caminho absoluto deste arquivo (e.g. `/home/user/projects/.../file.md`).
 - `url`: Se é uma página, o URL da página (e.g. `/pt-BR/guides/markdown-content`).
 - `getHeaders()`: Uma função assíncrona que retorna os cabeçalhos do arquivo Markdown. A resposta é desse tipo: `{ depth: number; slug: string; text: string }[]`.
+- `rawContent()`: Uma função que retorna o conteúdo bruto do arquivo Markdown (excluindo o bloco de frontmatter) como uma string. Isso é útil quando, digamos, formos calcular o tempo médio de leitura. Este exemplo utiliza o [popular pacote reading-time](https://www.npmjs.com/package/reading-time):
+
+  ```astro
+  ---
+  import readingTime from 'reading-time';
+  const posts = await Astro.glob('./posts/**/*.md');
+  ---
+  {posts.map((post) => (
+    <Fragment>
+      <h2>{post.frontmatter.title}</h2>
+      <p>{readingTime(post.rawContent()).text}</p>
+    </Fragment>
+  ))}
+  ```
+
+- `compiledContent()`: Uma função assíncrona que retorna o conteúdo bruto após parse, sendo sintaxe válida do Astro. Nota: **Isso não faz parse de `{expressões jsx}`, `<Componentes />` ou layouts**! Apenas blocos de Markdown padrão como `## cabeçalhos` e `- listas` passarão por parse para HTML. Isso é útil quando, digamos, formos renderizar um bloco de sumário para uma postagem de blog. Como a sintaxe do Astro é HTML válido, podemos utilizar bibliotecas populares como [node-html-parser](https://www.npmjs.com/package/node-html-parser) para fazer query do primeiro parágrafo assim:
+
+  ```astro
+  ---
+  import { parse } from 'node-html-parser';
+  const posts = await Astro.glob('./posts/**/*.md');
+  ---
+  {posts.map(async (post) => {
+    const primeiroParagrafo = parse(await post.compiledContent())
+      .querySelector('p:first-of-type');
+    return (
+      <Fragment>
+        <h2>{post.frontmatter.title}</h2>
+        {primeiroParagrafo ? <p>{primeiroParagrafo.innerText}</p> : null}
+      </Fragment>
+    );
+  })}
+  ```
+  
 - `Content`: Um componente que renderiza o conteúdo do arquivo Markdown. Eis um exemplo:
 
   ```astro

From fb7ee47b76517ff55813851ce98872b44bc1d0e5 Mon Sep 17 00:00:00 2001
From: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com>
Date: Sat, 28 May 2022 10:19:23 -0300
Subject: [PATCH 04/41] i18n(pt-BR): Add `directives-reference.md` translation
 (#605)

* Add `directives-reference.md` PT-BR translation

* Fix broken links

* Apply suggestions

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>

* Fix broken links

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>
---
 src/i18n/pt-BR/nav.ts                         |   1 +
 .../pt-BR/core-concepts/astro-components.md   |   2 +-
 .../core-concepts/framework-components.md     |   4 +-
 .../pt-BR/reference/directives-reference.md   | 229 ++++++++++++++++++
 4 files changed, 233 insertions(+), 3 deletions(-)
 create mode 100644 src/pages/pt-BR/reference/directives-reference.md

diff --git a/src/i18n/pt-BR/nav.ts b/src/i18n/pt-BR/nav.ts
index b2c7631208e13..039537af93a60 100644
--- a/src/i18n/pt-BR/nav.ts
+++ b/src/i18n/pt-BR/nav.ts
@@ -23,6 +23,7 @@ export default NavDictionary({
 	'guides/server-side-rendering': 'Renderização no lado do Servidor (SSR)',
 	'guides/typescript': 'TypeScript',
 	reference: 'Referência',
+	'reference/directives-reference': 'Diretivas de Template',
 	'reference/adapter-reference': 'API de Adaptadores',
 	'reference/integrations-reference': 'API de Integrações',
 });
diff --git a/src/pages/pt-BR/core-concepts/astro-components.md b/src/pages/pt-BR/core-concepts/astro-components.md
index 84c94e9bc0b88..3103144a6f5b4 100644
--- a/src/pages/pt-BR/core-concepts/astro-components.md
+++ b/src/pages/pt-BR/core-concepts/astro-components.md
@@ -371,7 +371,7 @@ Múltiplas tags `<script>` podem ser usadas no mesmo arquivo `.astro` combinando
 
 > **Nota:** Adicionar `type="module"` ou qualquer outro atributo em uma tag `<script>` irá desabilitar o comportamente padrão de empacotamento do Astro, tratando a tag como se houvesse a diretiva `is:inline`.
 
-📚 Veja nossa página de [referência de diretivas](/pt-BR/reference/directives-reference/#script--style-directives) para mais informação sobre as diretivas disponíveis em tags `<script>`.
+📚 Veja nossa página de [referência de diretivas](/pt-BR/reference/directives-reference/#diretivas-de-script-e-estilização) para mais informação sobre as diretivas disponíveis em tags `<script>`.
 
 #### Carregando Scripts Externos
 
diff --git a/src/pages/pt-BR/core-concepts/framework-components.md b/src/pages/pt-BR/core-concepts/framework-components.md
index 946162954e2c6..496d6d9f937fc 100644
--- a/src/pages/pt-BR/core-concepts/framework-components.md
+++ b/src/pages/pt-BR/core-concepts/framework-components.md
@@ -65,7 +65,7 @@ Por padrão, seus componentes de frameworks serão renderizados como HTML estát
 
 Um componente de framework pode ser tornar interativo (hidratado) utilizando uma das diretivas `client:*`. Isso é um atributo de componente que define como seu componente deve ser **renderizado** e **hidratado**.
 
-Uma [diretiva de cliente](/pt-BR/reference/directives-reference/#client-directives) descreve se o seu componente deve ou não ser renderizado no momento de build e quando o JavaScript do seu componente deve ser carregado pelo navegador, no lado do cliente.
+Uma [diretiva de cliente](/pt-BR/reference/directives-reference/#diretivas-de-cliente) descreve se o seu componente deve ou não ser renderizado no momento de build e quando o JavaScript do seu componente deve ser carregado pelo navegador, no lado do cliente.
 
 A maioria das diretivas irá renderizar o componente no servidor no momento de build. O JavaScript do componente será enviado ao cliente de acordo com a diretiva especificada. O componente será hidratado quando o seu JS terminar de ser importado.
 
@@ -88,7 +88,7 @@ import ContagemInterativa from '../components/ContagemInterativa.jsx';
 
 Há diversas diretivas de hidratação disponíveis para componentes de frameworks de UI: `client:load`, `client:idle`, `client:visible`, `client:media={QUERY}` e `client:only={FRAMEWORK}`.
 
-📚 Veja nossa página de [referência de diretivas](/pt-BR/reference/directives-reference/#client-directives) para uma descrição completa destas diretivas de hidratação e seus usos.
+📚 Veja nossa página de [referência de diretivas](/pt-BR/reference/directives-reference/#diretivas-de-cliente) para uma descrição completa destas diretivas de hidratação e seus usos.
 
 ## Misturando Frameworks
 
diff --git a/src/pages/pt-BR/reference/directives-reference.md b/src/pages/pt-BR/reference/directives-reference.md
new file mode 100644
index 0000000000000..80efd5a69108a
--- /dev/null
+++ b/src/pages/pt-BR/reference/directives-reference.md
@@ -0,0 +1,229 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Referência de Diretivas de Template
+i18nReady: true
+---
+
+**Diretivas de template** são um tipo especial de atributo HTML disponível dentro do template de qualquer componente Astro (arquivos `.astro`).
+
+Diretivas de template são utilizadas para controlar o comportamento de um elemento ou componente de alguma forma. Uma diretiva de template pode habilitar alguma funcionalidade do compilador que facilitaria sua vida (como utilizar `class:list` ao invés de `class`). Ou então, uma diretiva pode dizer para o compilador do Astro fazer algo especial com aquele componente (como hidratá-lo com `client:load`).
+
+Esta página descreve todas as diretivas de template disponíveis para você no Astro e como elas funcionam.
+
+## Regras
+
+Para uma diretiva de template ser válida, ela deve:
+
+- Incluir um dois-pontos `:` em seu nome, utilizando o padrão `X:Y` (ex: `client:load`).
+- Ser visível ao compilador (ex.:`X {...atributo}` não funcionaria se `atributo` contivesse uma diretiva).
+
+Algumas diretivas de template, mas não todas, podem receber um valor customizado:
+- `<X client:load />` (recebe nenhum valor)
+- `<X class:list={['alguma-classe-css']} />` (recebe um array)
+
+Uma diretiva de template nunca é inclusa diretamente no HTML final resultante de um componente.
+
+## Diretivas Comuns
+### `class:list`
+
+`class:list={...}` recebe um array de valores de classes e as converte em uma string de classes. Isso é inspirado pela famosa biblioteca utilitária [clsx](https://github.com/lukeed/clsx) feita por @lukeed, mas inserida diretamente no próprio Astro.
+
+`class:list` recebe um array de vários diferentes tipos de valores:
+- `string`: Adicionadas ao elemento `class`
+- `Object`: Todas as chaves com valor `truthy` são adicionadas ao elemento `class`
+- `Array`: Inserido como uma string dos valores
+- `Set`: Inserido como uma string dos valores
+
+```astro
+<!-- Isso -->
+<span class:list={[ 'ola tchau', { ola: true, mundo: true }, new Set([ 'ola', 'amigo' ]) ]} />
+<!-- Se torna -->
+<span class="olá tchau mundo amigo"></span>
+```
+
+Valores duplicados são removidos automaticamente.
+
+### `set:html`
+
+`set:html={string}` injeta uma string HTML em um elemento, similar a se utilizar `el.innerHTML`.
+
+**O valor não é automaticamente sanitizado pelo Astro!** Tenha certeza de que o valor inserido é seguro, ou que você o sanitizou manualmente antes de passá-lo ao template. Esquecer disto vai te deixar exposto a [ataques de Cross Site Scripting](https://owasp.org/www-community/attacks/xss/).
+
+```astro
+---
+const stringHtmlBruta = "Olá <strong>Mundo</strong>"
+---
+<h1>{stringHtmlBruta}</h1>
+  <!-- Resultado final: <h1>Olá &lt;strong&gt;Mundo&lt;/strong&gt;</h1> -->
+<h1 set:html={stringHtmlBruta} />
+  <!-- Resultado final: <h1>Olá <strong>Mundo</strong></h1> -->
+```
+
+Você também pode utilizar `set:html` em um `<Fragment>` para evitar adicionar um elemento wrapper desnecessário. Isso pode ser especialmente útil ao se buscar HTML de um CMS.
+
+```astro
+---
+const conteudoCMS = await buscarHtmlCMS();
+---
+<Fragment set:html={conteudoCMS}>
+```
+
+### `set:text`
+
+`set:text={string}` injeta uma string de texto em um elemento, similar a se utilizar `el.innerText`. Diferente de `set:html`, o valor `string` que é passado é automaticamente sanitizado pelo Astro.
+
+Isso é equivalente a apenas passar uma variável em uma expressão de template diretamente (ex: `<div>{algumTexto}</div>`) e por isso, essa diretiva não é comumente utilizada.
+
+## Diretivas de Cliente
+
+Estas diretivas controlam como [componentes de Frameworks de UI](/pt-BR/core-concepts/framework-components/) são hidratados na página.
+
+Por padrão, um componente de framework de UI não é hidratado no cliente, Se nenhuma diretiva `client:*` é providenciada, seu HTML é renderizado na página sem nenhum JavaScript.
+
+### `client:load`
+
+- **Prioridade:** Alta
+- **Útil para:** Elementos de UI imediatamente visíveis que precisam ser interativos o mais rápido possível.
+
+Carrega e hidrata o JavaScript do componente imediatamente ao carregar a página.
+
+```astro
+<BotaoComprar client:load />
+```
+### `client:idle`
+
+- **Prioridade:** Média
+- **Útil para:** Elementos de UI de baixa prioridade, que não precisam ser imediatamente interativos.
+
+Carrega e hidrata o JavaScript do componente assim que a página termina seu carregamento inicial e o evento `requestIdleCallback` é disparado. Se você estiver em um navegador que não suporta [`requestIdleCallback`](https://developer.mozilla.org/pt-BR/docs/Web/API/Window/requestIdleCallback), então o evento [load](https://developer.mozilla.org/pt-BR/docs/Web/API/Window/load_event) é utilizado.
+
+```astro
+<BotaoMostraEEsconde client:idle />
+```
+### `client:visible`
+
+- **Prioridade:** Baixa
+- **Útil para:** Elementos de UI de baixa prioridade que ou estão mais para baixo ("fora da tela") ou que consomem muitos recursos e que você prefere que não sejam carregados a não ser que o usuário veja o elemento.
+
+Carrega e hidrata o JavaScript do componente uma vez que o componente entrou na janela de exibição do usuário. Isto utiliza `IntersectionObserver` internamente para observar a visibilidade.
+
+```astro
+<CarrosselDeImagensPesado client:visible />
+```
+
+### `client:media`
+
+- **Prioridade:** Baixa
+- **Útil para:** Toggles de barras laterais ou outros elementos que podem ser visíveis apenas em certos tamanhos de tela.
+
+`client:media={string}` carrega e hidrata o JavaScript do componente assim que uma certa media query de CSS é atingida.
+
+Nota: Se o componente já está escondido e é mostrado por uma media query no seu CSS, então pode ser mais fácil apenas utilizar `client:visible` ao invés de passar a mesma media query para a diretiva.
+
+```astro
+<ToggleBarraLateral client:media="(max-width: 50em)" />
+```
+### `client:only`
+
+`client:only={string}` **pula** renderização de HTML no servidor e renderiza apenas no cliente. É similar a `client:load` no sentido em que ele carrega, renderiza e hidrata o componente imediatamente na página.
+
+**Você deve passar o framework correto do componente como valor!** Pois como o Astro não executa o componente durante a build / no servidor, Astro não sabe que framework seu componente utiliza a não ser que você o diga explicitamente.
+
+```astro
+<AlgumComponenteReact client:only="react" />
+<AlgumComponentePreact client:only="preact" />
+<AlgumComponenteSvelte client:only="svelte" />
+<AlgumComponenteVue client:only="vue" />
+<AlgumComponenteSolid client:only="solid-js" />
+```
+
+## Diretivas de Script e Estilização
+
+Estas diretivas só podem ser utilizadas nas tags `<script>` e `<style>` do HTML, para controlar como o seu JavaScript e CSS no lado do cliente são utilizados pela página. 
+
+### `is:global`
+
+Por padrão, Astro automaticamente escopa as regras de CSS de `<style>` ao componente. Você pode remover esse comportamento com a diretiva `is:global`.
+
+`is:global` faz com que o conteúdo de uma tag `<style>` seja aplicado globalmente na página quando o componente está incluso. Isso desabilita o sistema de escopo de CSS do Astro. É o equivalente a envolver todos os seus seletores numa tag `<style>` com `:global()`.
+
+Você pode combinar `<style>` e `<style is:global>` no mesmo componente, para criar algumas regras de estilo globais enquanto ainda escopa a maioria do CSS do seu componente.
+
+Veja a página [Estilização & CSS](/pt-BR/guides/styling/#estilos-globais) para mais detalhas em como estilos globais funcionam.
+
+```astro
+<style is:global>
+  body a { color: red; }
+</style>
+```
+
+### `is:inline`
+
+Por padrão, Astro irá processar, otimizar e fazer o bundle de tags `<script>` e `<style>` que ele ver na página. Você pode remover esse comportamento com a diretiva `is:inline`.
+
+`is:inline` diz ao Astro para deixar a tag `<script>` ou `<style>` como se fosse o HTML final resultante. Seus conteúdos não serão processados, otimizados ou passarão por bundle. Isso limita algumas funcionalidades do Astro, como importar pacotes npm ou utilizar uma linguagem que compila para CSS como Sass. 
+
+A diretiva `is:inline` significa que tags `<style>` ou `<script>`:
+- Não passarão por bundle em um arquivo externo.
+- Tags duplicadas não serão removidas - o elemento irá aparecer quantas vezes ele for renderizado.
+- Não terá suas referências de `import`/`@import`/`url()` resolvidas relativamente ao arquivo `.astro`.
+- Serão pré-processadas, por exemplo o atributo `<style lang="sass">` vai continuar gerando CSS puro.
+- Serão renderizadas no HTML final resultante exatamente como foram escritas.
+- Estilos serão globais e não escopados ao componente.
+
+> ⚠️ A diretiva `is:inline` é implícita sempre que qualquer outro atributo que não seja `src` é utilizado em uma tag `<script>` ou `<style>`.
+
+```astro
+<style is:inline>
+  /* inline: importações relativas e de pacotes npm não são suportadas. */
+  @import '/assets/algum-css-publico.css';
+  span { color: green; }
+</style>
+
+<script is:inline>
+  /* inline: importações relativas e de pacotes npm não são suportadas. */
+  console.log('Eu sou assim tanto aqui quanto no HTML final resultante.');
+</script>
+```
+
+📚 Veja como [scripts no lado do cliente](/pt-BR/core-concepts/astro-components/#scripts-no-lado-do-cliente) funcionam em componentes Astro.
+
+### `define:vars`
+
+`define:vars={...}` pode passar variáveis do front matter do seu componente no lado do servidor para o `<script>` ou `<style>` do cliente. Qualquer variável de front matter *serializável* é suportada, incluindo props passadas ao seu componente através de `Astro.props`.
+
+```astro
+---
+const corPrimeiroPlano = "rgb(221 243 228)";
+const corPlanoDeFundo = "rgb(24 121 78)";
+const mensagem = "Astro é incrível!";
+---
+<style define:vars={{ corTexto: corPrimeiroPlano, corPlanoDeFundo }}>
+  h1 {
+    background-color: var(--corPlanoDeFundo);
+    color: var(--corTexto);
+  }
+</style>
+
+<script define:vars={{ mensagem }}>
+  alert(mensagem);
+</script>
+```
+
+>⚠️ Utilizar `define:vars` em uma tag `<script>` ou `<style>` implica na diretiva `is:inline`, o que significa que seus scripts ou estilos não passarão por bundle e serão inseridos diretamente no seu HTML. Veja a [seção dedicada](#isinline) a `is:inline` para mais detalhes.
+
+## Diretivas Avançadas
+### `is:raw`
+
+`is:raw` instrui o compilador do Astro a tratar qualquer elemento-filho do elemento como texto. Isso significa que toda a sintaxe de template especial do Astro será ignorada dentro desse componente.
+
+Utilizada internamente no componente `<Markdown />`.
+
+Por exemplo, se você tivesse um componente Katex customizado que converte algum texto para HTML, usuários poderiam fazer isso:
+
+```astro
+---
+import Katex from '../components/Katex.astro';
+---
+<Katex is:raw>Alguma {sintaxe} conflitante aqui</Katex>
+```

From 60f9148a338f01bb7585265861ff32db7d839ae4 Mon Sep 17 00:00:00 2001
From: Astroalex <alexis31.balthazard@gmail.com>
Date: Sat, 28 May 2022 15:23:15 +0200
Subject: [PATCH 05/41] i18n(fr): Adding `install/auto.md` translation (#675)

* i18n(fr): Adding `install/auto.md` translation

* Fix link check

* Apply changes from code review

* Update node.js version requirements translation

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/pages/fr/install/auto.md | 151 +++++++++++++++++++++++++++++++++++
 1 file changed, 151 insertions(+)
 create mode 100644 src/pages/fr/install/auto.md

diff --git a/src/pages/fr/install/auto.md b/src/pages/fr/install/auto.md
new file mode 100644
index 0000000000000..3470dc86bf55d
--- /dev/null
+++ b/src/pages/fr/install/auto.md
@@ -0,0 +1,151 @@
+---
+title: Installation d'Astro avec l'ILC automatique
+description: Comment installer Astro avec NPM, PNPM, ou Yarn via l'outil de création create-astro inclus dans l'ILC.
+layout: ~/layouts/MainLayout.astro
+setup: import InstallGuideTabGroup from '~/components/TabGroup/InstallGuideTabGroup.astro';
+---
+
+Prêt à installer Astro ? Suivez notre guide d'installation automatique ou manuel pour commencer.
+
+#### Prérequis
+
+- **Node.js** - version `14.15.0`, `v16.0.0`, ou supérieure.
+- **Éditeur de code** - Nous recommandons [VS Code](https://code.visualstudio.com/) avec notre [extension officielle Astro](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode).
+- **Console de terminal** - Astro est accessible via son interface par ligne de commande (ILC).
+
+<InstallGuideTabGroup />
+
+#### Installation
+
+`create-astro` est le moyen le plus rapide et le plus simple de démarrer un nouveau projet Astro à partir de zéro.
+
+## 1. Utiliser l'<abbr title="Interface par ligne de commande">ILC</abbr>
+
+Lancez la commande suivante dans votre terminal pour démarrer notre assistant d'installation, `create-astro`. Vous serez guidé dans la création de votre premier projet Astro à l'intérieur du répertoire où vous l'avez lancé.
+
+Pas besoin de créer un répertoire ! L'assistant d'installation créera automatiquement un répertoire pour vous.
+
+```shell
+# NPM
+npm create astro@latest
+
+# Yarn
+yarn create astro
+
+# PNPM
+pnpm create astro@latest
+```
+
+En fonction de votre gestionnaire de Packages, vous pourriez recevoir une demande de confirmation pour installer `create-astro@latest`. Il vous sera par la suite demandé de choisir un dossier pour votre projet (ex: `./my-astro-site`) qui crééra un nouveau répertoire.
+
+### Choisir un Template de Démarrage
+
+Vous allez ensuite apercevoir une petite liste de Templates de démarrage dans laquelle choisir :
+
+- `Just the basics`: Un excellent modèle de démarrage pour tous ceux qui veulent explorer Astro.
+- `Blog`, `Documentation`, `Portfolio`: thèmes prédéfinis pour des cas d'utilisation spécifiques.
+- `Completely empty`: Un modèle minimal qui ne contient que les éléments essentiels pour commencer.
+
+Utilisez les flèches directionnelles (haut et bas) pour naviguer vers le Template que vous souhaitez installer, puis appuyez sur la touche entrée pour valider.
+
+> 💡 Vous voulez jeter un oeil aux Templates dans votre navigateur avant de choisir ? Allez sur [astro.new](https://astro.new/)
+
+## 2. Installer les Dépendances (Optionnel)
+
+L'assiistant d'installation vous proposera d'exécuter la commande `install` pour vous, qui est optionnelle.
+
+> ⚠️ Si vous ne le faites pas maintenant, vous devrez [installer les dépendances](/fr/install/auto/#2-installer-les-dépendances) après l'assistant d'installation, avant de commencer votre projet.
+
+### Installer Une ou Plusieurs Intégrations Astro (Optionnel)
+
+Il vous sera demandé à ce moment d'ajouter n'importe quelle [intégration de Framework UI](/fr/core-concepts/framework-components/) (React, Svelte, Vue, Solid, Preact, Lit) et d'ajouter ensuite d'autres intégrations officielles (tel que Tailwind, Partytown, Sitemap) en exécutant `astro add --yes`.
+
+Pour sélectionner les intégrations Astro que vous souhaitez inclure dans votre projet, utilisez les flèches directionnelles (haut et bas) pour naviguer et la touche espace pour sélectionner ou désélectionner. Vous pouvez sélectionner plusieurs éléments à la fois, ou continuer sans sélectionner d'intégrations.
+
+Quand vous êtes satisfait de votre sélection, appuyez sur la touche entrée pour valider.
+
+> Ces intégrations, et toutes les [intégrations de la communauté Astro](https://astro.build/integrations/), peuvent également être ajoutées plus tard en suivant les instructions dans notre [guide d'intégrations](/fr/guides/integrations-guide/).
+
+Après avoir sélectionné vos intégrations à ajouter, vous devriez voir le message suivant dans votre terminal pour vous affirmer que `create-astro` va appliquer les changements à votre fichier `astro.config.mjs` :
+
+```bash
+Astro will make the following changes to your config file:
+# Peut se traduire par : "Astro va faire les changements suivants dans votre fichier de configuration :"
+```
+
+Ce message vous informe que vos intégrations ont été ajoutées avec succès à votre fichier de configuration. (Si ce n'est pas le cas, vous pouvez toujours les ajouter manuellement plus tard.)
+
+### Initialiser un Dépot `.git` (Optionnel)
+
+À cette dernière étape, vous pouvez choisir d'initialiser un dépot Git dans votre nouveau répertoire. C'est optionnel, mais utile si vous souhaitez utiliser l'outil [Git](https://git-scm.com/) pour votre projet.
+
+### Étapes Suivantes
+
+Quand l'assistant d'installation `create-astro` est terminé, vous devriez voir quelques instructions recommandées sur votre écran ("Next Steps") qui vont vous aider à compléter votre configuration et démarrer votre nouveau projet.
+
+## 2. Installer les Dépendances
+
+Si vous n'avez pas installé les dépendances de votre projet avec l'assistant d'installation, vous allez maintenant en faire avec votre gestionnaire de Package préféré :
+
+```bash
+# NPM
+npm install
+
+# Yarn
+yarn
+
+# PNPM
+pnpm install
+```
+
+## 3. Lancer Astro ✨
+
+Vous pouvez vous attendre à utiliser le serveur de développement intégré d'Astro pour la plupart de vos projets. C'est de cette manière que vous lancerez votre projet localement pendant le développement.
+
+Pour commencer, utilisez votre gestionnaire de Packages pour lancer le script de démarrage par défaut :
+
+```bash
+# NPM
+npm run dev
+
+# Yarn
+yarn start
+
+# PNPM
+pnpm run dev
+```
+
+Si tout se passe comme prévu, Astro devrait maintenant être en train de faire tourner votre projet à l'addresse [http://localhost:3000/](http://localhost:3000/) !
+
+Astro va également suivre les modifications de fichiers dans le répertoire `src/`, vous n'aurez donc pas besoin de redémarrer le serveur à chaque fois que vous apporterez des modifications au cours du développement.
+
+Si vous n'arrivez pas à ouvrir votre projet dans le navigateur, revenez au terminal où vous avez lancé le script `start` pour voir ce qui a mal tourné.
+
+## 4. Déployer sur le Web
+
+Il est temps de déployer votre projet sur la toile ! Lancez la commande `build` dans votre projet pour construire votre site web statique vers un nouveau répertoire nommé `dist/`.
+
+```bash
+# NPM
+npm run build
+
+# Yarn
+yarn build
+
+# PNPM
+pnpm run build
+```
+
+Quand la commande se termine, vous devriez avoir un nouveau répertoire `dist/` dans votre projet que vous pouvez déployer directement sur votre hébergeur web favori.
+
+Pour commencer à déployer votre site web gratuitement, allez jeter un oeil à notre fier partenaire d'hébergement, [Netlify](https://www.netlify.com/). Pour obtenir des instructions sur la mise en place d'un déploiement, lisez notre [guide de déploiement](/fr/guides/deploy/).
+
+## Étapes Suivantes
+
+Bravo ! Vous êtes maintenant prêt à développer avec Astro !
+
+📚 En apprendre plus sur la structure de votre projet Astro dans notre [Guide de structure de projet](/fr/core-concepts/project-structure/).
+
+📚 En apprendre plus sur la structure des composants d'Astro dans notre [Guide de structure des composants](/fr/core-concepts/astro-components/).
+
+📚 En apprendre plus sur le routage par pages d'Astro dans notre [Guide de routage](/fr/core-concepts/astro-pages/).

From a54fe438c0ec5507b704bd24b83ac20762da56df Mon Sep 17 00:00:00 2001
From: Astroalex <alexis31.balthazard@gmail.com>
Date: Sat, 28 May 2022 15:26:51 +0200
Subject: [PATCH 06/41] i18n(fr): Adding `install/manual.md` translation (#676)

* i18n(fr): Adding `install/manual.md` translation

* Adding a missing slash that i didn't saw

* Apply changes from code review

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/pages/fr/install/manual.md | 136 +++++++++++++++++++++++++++++++++
 1 file changed, 136 insertions(+)
 create mode 100644 src/pages/fr/install/manual.md

diff --git a/src/pages/fr/install/manual.md b/src/pages/fr/install/manual.md
new file mode 100644
index 0000000000000..2fd0a5e7085be
--- /dev/null
+++ b/src/pages/fr/install/manual.md
@@ -0,0 +1,136 @@
+---
+title: Installer Astro manuellement
+description: Comment installer Astro manuellement avec NPM, PNPM, ou Yarn.
+layout: ~/layouts/MainLayout.astro
+setup: import InstallGuideTabGroup from '~/components/TabGroup/InstallGuideTabGroup.astro';
+---
+
+Prêt à installer Astro ? Suivez notre guide d'installation automatique ou manuel pour commencer.
+
+#### Prérequis
+
+- **Node.js** - version `14.15.0`, `v16.0.0`, ou supérieure.
+- **Éditeur de code** - Nous recommandons [VS Code](https://code.visualstudio.com/) avec notre [extension officielle Astro](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode).
+- **Console de terminal** - Astro est accessible via son interface de ligne de commande (ILC).
+
+<InstallGuideTabGroup />
+
+#### Installation
+
+Si vous préférez ne pas utiliser notre outil via lignes de commandes `create-astro`, vous pouvez configurer votre projet vous-même en suivant le guide ci-dessous.
+
+## 1. Créez votre Répertoire
+
+Créez un répertoire vide avec le nom de votre projet, puis naviguez dans celui-ci.
+
+```bash
+mkdir my-astro-project
+cd my-astro-project
+```
+
+Maintenant que vous êtes dans votre nouveau répertoire, créez votre fichier `package.json`. C'est avec ce fichier que vous pourrez gérer les dépendances de votre projet, y compris Astro. Si vous n'êtes pas familier avec ce format de fichier, lancez la commande suivante pour en créer un.
+
+```bash
+npm init --yes
+```
+
+## 2. Installer Astro
+
+Premièrement, installez les dépendances d'Astro dans votre projet.
+
+```bash
+npm install astro
+```
+
+Ensuite, remplacez la section "scripts" de votre `package.json` par les lignes suivantes :
+
+```diff
+  "scripts": \{
+-    "test": "echo \"Error: no test specified\" && exit 1"
++    "dev": "astro dev",
++    "start": "astro dev",
++    "build": "astro build",
++    "preview": "astro preview"
+  },
+```
+
+Vous aurez besoin de ces scripts plus tard dans le guide pour démarrer Astro et exécuter ses différentes commandes.
+
+## 3. Créez votre Première Page
+
+Dans votre éditeur de texte, créez un nouveau fichier dans votre répertoire à l'emplacement `src/pages/index.astro`. Cela sera votre première page Astro.
+
+Pour ce guide, copiez-collez le code suivant (y compris les tirets `---`) dans votre tout nouveau fichier :
+
+```astro
+---
+// Bienvenue dans Astro ! Tout ce qui est entre les barres de code "---"
+// est le "Frontmatter" de votre composant. Il n'est jamais exécuté sur le navigateur.
+console.log('Ceci ce lance dans votre terminal, pas sur le navigateur !');
+---
+<!-- Tout ce qui se situe en dessous est votre "Template" de composant.
+     Ce n'est que du HTML, mais avec quelques paillettes et un peu de magie
+     pour vous aider à construire de grande choses. -->
+<html>
+  <body>
+    <h1>Hello, World!</h1>
+  </body>
+</html>
+<style>
+  h1 {
+    color: orange;
+  }
+</style>
+```
+
+## 4. Créez votre Premier Fichier Statique
+
+Vous devriez aussi créer un répertoire `public/` pour stocker vos fichiers statiques. Astro injectera toujours ces fichiers dans votre Build final, vous pouvez donc les référencer de manière sûre depuis vos Templates de composants.
+
+Dans votre éditeur de texte, créez un nouveau fichier dans votre répertoire avec le nom `public/robots.txt`. `robots.txt` est un fichier simple que la plupart des sites incluent pour dire aux moteurs de recherche comme Google comment traiter votre site.
+
+Pour ce guide, copiez-collez le code suivant dans votre nouveau fichier :
+
+```
+# Exemple: Autorisez tous les robots à parcourir et indexer votre site.
+# Syntaxe Complète: https://developers.google.com/search/docs/advanced/robots/create-robots-txt
+User-agent: *
+Allow: /
+```
+
+## 5. Créez votre Fichier `astro.config.mjs`
+
+Astro est configuré pour utiliser `astro.config.mjs` comme fichier de configuration. Ce fichier est optionnel si vous ne souhaitez pas configurer Astro, mais vous pouvez le créer maintenant.
+
+Créez le fichier `astro.config.mjs` à la racine de votre projet, et copiez le code ci-dessous dans le fichier :
+
+```
+import { defineConfig } from 'astro/config';
+
+// https://astro.build/config/
+export default defineConfig({});
+```
+
+Si vous souhaitez inclure un [composant de Framework](/fr/core-concepts/framework-components/) comme React, Svelte, etc... ou utiliser d'autres outils tel que Tailwind ou Partytown dans votre projet, c'est le bon endroit pour les [importer et configurer ces intégrations](/fr/guides/integrations-guide/).
+
+📚 Lisez l'[API de référence](/fr/reference/configuration-reference/) d'Astro pour plus d'informations.
+
+## 6. Étapes Suivantes
+
+Si vous avez suivi les étapes ci-dessus, votre répertoire de projet devrait maintenant ressembler à ça :
+
+```
+├── node_modules/
+├── src/
+│   └── pages/
+│   │   └── index.astro
+├── public/
+│   ├── robots.txt
+├── astro.config.mjs
+├── package.json
+└── package-lock.json (ou bien : yarn.lock, pnpm-lock.yaml, etc...)
+```
+
+Bien joué, vous êtes prêt à utiliser Astro !
+
+Si vous avez suivi ce guide jusqu'au bout, vous pouvez aller directement à l'[Étape 3: Lancer Astro ✨](/fr/install/auto/#3-lancer-astro-) pour continuer et apprendre comment lancer Astro pour la première fois.

From 5eb63ba95867110bc05342302f82bfdb7a11ea67 Mon Sep 17 00:00:00 2001
From: Astroalex <alexis31.balthazard@gmail.com>
Date: Sat, 28 May 2022 15:29:55 +0200
Subject: [PATCH 07/41] i18n(fr): Adding `integrations.md` translation (#677)

* i18n(fr): Adding `integrations.md` translation

* Apply changes from code review

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/pages/fr/integrations/integrations.md | 62 +++++++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 src/pages/fr/integrations/integrations.md

diff --git a/src/pages/fr/integrations/integrations.md b/src/pages/fr/integrations/integrations.md
new file mode 100644
index 0000000000000..eb5df00d4b5e9
--- /dev/null
+++ b/src/pages/fr/integrations/integrations.md
@@ -0,0 +1,62 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Créé avec Astro
+---
+
+Les membres de la communauté d'Astro ont intégré avec succès plusieurs services et outils tiers dans leurs sites Astro !
+
+Voici quelques sites déployés, des dépôts, des articles de blog et des vidéos de la communauté montrant comment vous pouvez connecter Astro avec une variété d'outils populaires de CMS, eCommerce, Authentification/Autorisation, Recherche et Commentaires.
+
+> À la recherche d'une intégration spécifique ? Jetez un oeil à notre [bibliothèque d'intégrations](https://astro.build/integrations/), et apprenez comment [ajouter vos intégrations](/fr/guides/publish-to-npm/#bibliothèque-dintégration) à la bibliothèque !
+
+> ⚠️ Les sites et articles suivants sont majoritairement en anglais.
+
+## Sites Déployés
+
+[Replicant Band](https://replicant.band/) - Astro / GraphCMS / Snipcart / Tailwind
+
+[Design Buddy](https://design-buddy.netlify.app/) - Astro / Tailwind / React / Cloudinary
+
+[Spread Bagelry](https://spreadbagelry.com/) - Astro / Vue / Tailwind / Strapi CMS / Cloudinary
+
+[Public Transport Forum New Zealand](https://publictransportforum.nz/articles) - Astro / Netlify CMS
+
+[My Workshops Live](https://myworkshops.live/) - Astro / Svelte / Firebase / Vonage / Web Speech API / reveal.js
+
+[Rafid Muhymin Wafi](https://softhardsystem.com/) -  Astro / Tailwind / WordPress: Headless CMS, comments, search
+
+[meizuflux](https://meizuflux.com/) - Astro / GraphCMS
+
+[Sarah Rainsberger](https://www.rainsberger.ca/) - Astro / GitHub Giscus (Comments)
+
+[Astro Docs](https://github.com/withastro/docs) - Notre propre documentation utilise Algolia search dans Astro !
+
+## Articles de Blog / Videos
+
+[NavillusBlog](https://navillus.dev/blog/astro-plus-snipcart) - **Article de Blog**: Astro + Snipcart repository and demo site
+
+[Cassidy Williams](https://www.netlify.com/blog/2021/07/23/build-a-modern-shopping-site-with-astro-and-serverless-functions/) - **Article de Blog**: Building Shopify Stores with Astro and the Storefront API
+
+[Learn With Jason](https://youtube.com/watch?v=FJOJmKFngLI) - **Video**: Building a custom cart in Astro with Shopify Storefront API
+
+[Chris Bongers](https://blog.openreplay.com/building-an-astro-website-with-wordpress-as-a-headless-cms) - **Article de Blog**: Building an Astro Website with WordPress as a Headless CMS
+
+[Front End Horse](https://www.youtube.com/watch?v=qFUfuDSLdxM) - **Video**: Building with Astro & Prismic
+
+[Jaydan Urwin](https://www.youtube.com/watch?v=-jAWLTfsSQw) - **Video**: Create your own Blog with Astro and Sanity.io
+
+[Aftab Alam](https://aalam.vercel.app/blog/astro-and-git-cms-netlify) - **Article de Blog**: Author your Astro site's content with Git-based CMSs
+
+[Chris Bongers](https://aviyel.com/post/1006/adding-typesense-search-to-an-astro-static-generated-website) - **Article de Blog**: Adding Typesense Search to an Astro Website
+
+[The Net Ninja](https://www.youtube.com/playlist?list=PL4cUxeGkcC9hZm9NYpd4G-jhoeEk0ls--) - **Video**: Figma and Astro Static Site Build
+
+## Dépots / Templates de démarrage
+
+[delucis/astro-netlify-cms](https://github.com/delucis/astro-netlify-cms/) - Astro Starter Template with Netlify CMS
+
+[PhilDL/astro-starter-ghost](https://github.com/PhilDL/astro-starter-ghost) - A starter template for a static blog using Ghost CMS and Astro
+
+[p13rnd/centauri](https://github.com/p13rnd/centauri) - Astro template: Tailwind, Svelte and authentication with Supabase
+
+> Voir plus d'exemples de modèles de démarrage et de sites construits avec Astro à cet addresse : [Awesome Astro](https://github.com/one-aalam/awesome-astro#%E2%84%B9%EF%B8%8F-repositoriesstarter-kitscomponents)
\ No newline at end of file

From 984c942e638de0fc2b1d99b2d2881c18b5e09e06 Mon Sep 17 00:00:00 2001
From: Astroalex <alexis31.balthazard@gmail.com>
Date: Sat, 28 May 2022 15:35:46 +0200
Subject: [PATCH 08/41] i18n(fr): Adding `editor-setup.md` translation (#658)

* i18n(fr): Adding `editor-setup.md` translation

* Apply changes from code review

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/pages/fr/editor-setup.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 src/pages/fr/editor-setup.md

diff --git a/src/pages/fr/editor-setup.md b/src/pages/fr/editor-setup.md
new file mode 100644
index 0000000000000..c781ff42661d9
--- /dev/null
+++ b/src/pages/fr/editor-setup.md
@@ -0,0 +1,35 @@
+---
+layout: ~/layouts/MainLayout.astro
+setup: |
+  import Badge from '~/components/Badge.astro';
+title: Configuration de l'éditeur de code
+description: Configurez votre éditeur de code pour construire avec Astro.
+---
+
+Customisez votre éditeur de code pour améliorer l'expérience de développement avec Astro et débloquer de nouvelles fonctionnalités.
+
+## VS Code
+
+[VS Code](https://code.visualstudio.com/) est un éditeur de code populaire pour les développeurs web, développé par Microsoft. Le moteur de code VS Code est également utilisé par des éditeurs de code _"In-Browser"_ comme [GitHub Codespaces](https://github.com/features/codespaces) ou [Gitpod](https://gitpod.io/).
+
+Astro fonctionne dans n'importe quel éditeur de texte. Cependant, VS Code est l'éditeur que nous recommandons pour les projets Astro. Nous maintenons une [extension Astro pour VS Code](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode) officielle qui débloque de nombreuses fonctionnalités et améliorations d'expérience pour les projets Astro.
+
+- Coloration syntaxique pour les fichiers `.astro`.
+- Informations de typage TypeScript pour les fichiers `.astro`.
+- [Intellisense VS Code](https://code.visualstudio.com/docs/editor/intellisense) pour l'autocomplétion, les suggestions et plus.
+
+Pour commencer, installez l'extension [Astro VS Code](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode) maintenant.
+
+## Autres éditeurs de code
+
+Notre superbe communauté de développeurs maintient plusieurs extensions pour d'autres éditeurs populaires, comme :
+
+- [Extension VS Code pour Open VSX](https://open-vsx.org/extension/astro-build/astro-vscode) <span style="margin: 0.25em;"><Badge variant="accent">Officiel</Badge></span> - L'extension officielle pour VS Code, disponible sur le registre Open VSX pour les plateformes ouvertes comme [VSCodium](https://vscodium.com/)
+- [Extension Nova](https://extensions.panic.com/extensions/sciencefidelity/sciencefidelity.astro/)<span style="margin: 0.25em;"><Badge variant="neutral">Communauté</Badge></span> - Coloration syntaxique, IntelliSense, autocomplétion pour Astro
+
+## Éditeur de code "In-Browser"
+
+En plus des éditeurs locaux, Astro fonctionne aussi bien sur les éditeurs _"In-Browser"_ hébergés, comme :
+
+- [StackBlitz](https://stackblitz.com/) et [CodeSandbox](https://codesandbox.io/) sont des éditeurs en ligne qui s'exécutent dans votre navigateur, avec le support de coloration syntaxique pour les fichiers `.astro`. Pas d'installation ou de configuration nécessaire !
+- [GitHub.dev](https://github.dev/) vous permet d'installer l'extension VS Code pour Astro en une [extension web](https://code.visualstudio.com/api/extension-guides/web-extensions), qui vous donne accès à seulement quelques fonctionnalités complètes. Actuellement, seule la coloration syntaxique est supportée.

From fe735e4ddfb042fcf62a0209eed0d113ee168e37 Mon Sep 17 00:00:00 2001
From: Astroalex <alexis31.balthazard@gmail.com>
Date: Sat, 28 May 2022 15:42:13 +0200
Subject: [PATCH 09/41] i18n(fr): Adding `partial-hydration.md` &
 `project-structure.md` translations (#464)

* Adding `partial-hydration.md` & `project-structure.md` to fr translation

* Apply changes from code review (#462)

* updating partial-hydration.md following withastro#594

* Apply changes from code review

* Adding changes from code review

* Apply changes from code review

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 .../fr/core-concepts/partial-hydration.md     |  70 ++++++++++++
 .../fr/core-concepts/project-structure.md     | 105 ++++++++++++++++++
 2 files changed, 175 insertions(+)
 create mode 100644 src/pages/fr/core-concepts/partial-hydration.md
 create mode 100644 src/pages/fr/core-concepts/project-structure.md

diff --git a/src/pages/fr/core-concepts/partial-hydration.md b/src/pages/fr/core-concepts/partial-hydration.md
new file mode 100644
index 0000000000000..b1e287163958e
--- /dev/null
+++ b/src/pages/fr/core-concepts/partial-hydration.md
@@ -0,0 +1,70 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Hydratation Partielle dans Astro
+description: Apprend comment l'Hydratation Partielle fonctionne dans Astro avec l' "Island Architecture".
+setup: |
+  import IslandsDiagram from '~/components/IslandsDiagram.astro';
+---
+
+**Astro génère n'importe quel site sans aucun JavaScript côté client par défaut.** Peu importe le Framework que vous utilisez ([React](https://reactjs.org/), [Preact](https://preactjs.com/), [Svelte](https://svelte.dev/), [Vue](https://vuejs.org/), [SolidJS](https://www.solidjs.com/), [AlpineJS](https://alpinejs.dev/) et [Lit](https://lit.dev/)), le site sera généré automatiquement en HTML. Cela permet de garder chaque site ultra-rapide par défaut.
+
+```astro
+---
+// Exemple: Utiliser un composant React statique sur une page, sans JavaScript.
+import MyReactComponent from '../components/MyReactComponent.jsx';
+---
+<!-- 100% HTML, Aucun JavaScript ! -->
+<MyReactComponent />
+```
+
+Mais par moments, vous avez besoin d'un composant UI interactif. Quand vous trouvez que vous avez d'un besoin sur la page, Astro ne vous forcera pas à utiliser du JavaScript sur la totalité de la page. Au contraire, Astro utilise une technique appelée **"Partial Hydration" (ou Hydratation Partielle)** qui vous permet d' "hydrater" des composants individuels sur la page. Cela signifie que vous n'envoyez que le JavaScript nécessaire pour exécuter votre page.
+
+```astro
+---
+// Exemple: Utiliser un composant React dynamique sur une page.
+import MyReactComponent from '../components/MyReactComponent.jsx';
+---
+<!-- Ce composant est maintenant interactif sur votre page !
+     Le reste de votre site reste le même. -->
+<MyReactComponent client:load />
+```
+
+La vaste majorité de votre site est purement en HTML et CSS, avec des **îles d'interactivité** isolées du reste du contenu.
+
+## Hydration Partielle
+
+Il y a de nombreux cas où vous pourriez avoir besoin d'un composant UI interactif qui demande une exécution dans le navigateur :
+
+- Un slider de présentation d'images
+- Une barre de recherche avec autocomplétion
+- Un bouton pour afficher/masquer une navigation mobile
+- Un bouton "Ajouter au panier"
+
+Dans Astro, c'est votre responsabilité de définir les composants qui doivent être hydratés dans le navigateur. Astro ne va hydrater que ce qui est nécessaire pour le fonctionnement de votre site et laisser le reste de votre site en HTML statique.
+
+**L'Hydratation Partielle est le secret pour lequel Astro est connu comme "fast-by-default" en terme de performances.**
+
+## Architecture Isolée
+
+**Island Architecture (ou Architecture Isolée)** est l'idée d'utiliser l'Hydratation Partielle pour construire des sites en entier. L'Architecture Isolée est une alternative à la construction de site sous JavaScript qui doit être envoyé au visiteur de celui-ci.
+
+> L'idée générale d'une Architecture dite "Isolée" est simple comme bonjour : Rendre les pages HTML sur le serveur, et injecter des emplacements ou des espaces restreints autour de régions dynamiques.
+> <br/> -- [Islands Architecture: Jason Miller (EN)](https://jasonformat.com/islands-architecture/)
+
+Autre que les avantages évidents de ne pas envoyer de JavaScript au navigateur, il y a deux avantages clés à l'Architecture Isolée :
+
+- **Les composants sont chargés individuellement.** Les composants plus légers (comme une navigation sur téléphone) ne sont pas bloqués par des composants plus lourds de la page.
+- **Les composants sont isolés.** Chaque composant de la page sont isolés, les performances de la page ne seront donc pas affectées par les autres.
+
+<IslandsDiagram>
+    <Fragment slot="headerApp">Header "app"</Fragment>
+    <Fragment slot="sidebarApp">Sidebar "app"</Fragment>
+    <Fragment slot="main">
+        Contenu HTML rendu côté serveur comme du texte, des images, etc...
+    </Fragment>
+    <Fragment slot="carouselApp">Carrousel d'images "app"</Fragment>
+    <Fragment slot="advertisement">Publicitée<br/>(rendu côté serveur)</Fragment>
+    <Fragment slot="footer">Footer (HTML rendu côté serveur)</Fragment>
+</IslandsDiagram>
+
+_Source: [Islands Architecture: Jason Miller (EN)](https://jasonformat.com/islands-architecture/)_
diff --git a/src/pages/fr/core-concepts/project-structure.md b/src/pages/fr/core-concepts/project-structure.md
new file mode 100644
index 0000000000000..5d7817197733b
--- /dev/null
+++ b/src/pages/fr/core-concepts/project-structure.md
@@ -0,0 +1,105 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Structure du Projet
+description: Apprends à structurer un projet avec Astro.
+---
+
+Votre tout nouveau projet Astro généré à partir de l'assistant de création `create-astro` possède déjà quelques fichiers et dossiers. En ce qui concerne les autres fichiers, vous pourrez les créer vous-même et les ajouter à la structure de fichiers d'Astro.
+
+Voici comment un projet Astro est organisé, ainsi que quelques fichiers que vous trouverez dans votre nouveau projet.
+
+## Répertoires et fichiers
+
+Astro promeut une certaine façon d'organiser vos dossiers dans votre projet. Chaque projet Astro doit inclure les répertoires et fichiers suivants :
+
+- `src/*` - Le code source de votre projet (composants, pages, styles, etc...)
+- `public/*` - Tout ce qui n'est pas du code et/ou des fichiers qui n'ont pas à être traités (polices d'écritures, icônes, etc...)
+- `package.json` - Le manifeste de votre projet.
+- `astro.config.mjs` - Un fichier de configuration d'Astro (optionnel).
+
+### Exemple de structure de projet
+
+Un projet Astro assez commun peut ressembler à ça :
+
+```
+├── src/
+│   ├── components/
+│   │   ├── Header.astro
+│   │   └-─ Button.jsx
+│   ├── layouts/
+│   │   └-─ PostLayout.astro
+│   └── pages/
+│   │   ├── posts/
+│   │   │   ├── post1.md
+│   │   │   ├── post2.md
+│   │   │   └── post3.md
+│   │   └── index.astro
+│   └── styles/
+│       └-─ global.css
+├── public/
+│   ├── robots.txt
+│   ├── favicon.svg
+│   └-─ social-image.png
+├── astro.config.mjs
+└── package.json
+
+```
+
+### `src/`
+
+Le code source de votre project se trouve dans le dossier `src/`. Il comprend en général :
+
+- [Des composants Pages](/fr/core-concepts/astro-pages/)
+- [Des composants Layouts](/fr/core-concepts/layouts/)
+- [Des composants Astro](/fr/core-concepts/astro-components/)
+- [Des composants Frontend (React, etc...)](/fr/core-concepts/framework-components/)
+- [Des fichiers de style (CSS, Sass)](/fr/guides/styling/)
+- [Du Markdown](/fr/guides/markdown-content/)
+
+Astro traite, optimise et regroupe les fichiers `src/` pour créer le site web final qui est délivré au navigateur. Contrairement au répertoire statique `public/`, les fichiers `src/` sont traités et assemblés pour vous par Astro.
+
+Quelques fichiers (comme les composants Astro) ne sont pas envoyés au navigateur tel quel, mais plutôt en temps qu'HTML statique. D'autres fichiers (CSS par exemple) sont envoyés au navigateur, mais peuvent être optimisés ou regroupés avec d'autres fichiers CSS pour améliorer les performances.
+
+### `src/components`
+
+**Les composants** sont généralement du code réutilisable pour vos pages HTML. Ils peuvent être des [composants Astro](/fr/core-concepts/astro-components/), ou des [composants Frontend](/fr/core-concepts/framework-components/) comme React ou Vue. Il est commun de grouper et d'organiser tous les composants de votre projet dans ce dossier.
+
+C'est une convention commune dans les projets Astro, mais elle n'est pas obligatoire. Organisez vos composants comme vous le voulez, si vous le souhaitez !
+
+### `src/layouts`
+
+[Les composants Layouts](/fr/core-concepts/layouts/) sont des types de composants particuliers qui s'appliquent à des pages. Ils sont généralement utilisés par les [Pages Astro](/fr/core-concepts/astro-pages/) et les [Pages Markdown](/fr/guides/markdown-content/) pour définir leur mise en page.
+
+Comme `src/components`, organisez vos composants Layouts comme vous le souhaitez, ils ne sont pas obligatoires.
+
+### `src/pages`
+
+[Les composants Pages](/fr/core-concepts/astro-pages/) sont des types de composants particuliers utilisés pour créer de nouvelles pages. Une Page peut être un composant Astro (`.astro`) ou un fichier Markdown (`.md`) qui représente une page de contenu pour votre site.
+
+> ⚠️ `src/pages` est un dossier **obligatoire** dans votre projet Astro. Sans ça, votre site n'aura aucune page ni route !
+
+### `src/styles`
+
+C'est une convention commune de stocker vos fichiers CSS ou Sass dans le dossier `src/styles`, mais ce n'est pas obligatoire. Du moment que vos fichiers de style sont quelque part dans le dossier `src/`, Astro va les gérer et les optimiser.
+
+### `public/`
+
+Le dossier `public/` est là pour les fichiers et les ressources qui n'ont pas besoin d'être traités durant le processus de compilation d'Astro. Ces fichiers seront copiés dans le dossier de compilation sans modification.
+
+Ce comportement fait du dossier `public/` un endroit idéal pour les ressources communes comme des images, polices d'écriture, ou même pour des fichiers spéciaux comme `robots.txt` et `manifest.webmanifest`.
+
+Vous pouvez placer des fichiers CSS et JavaScript dans le dossier `public/`, mais gardez à l'esprit que ces fichiers ne seront pas regroupés et/ou optimisés dans votre build final.
+
+> 💡 *En règle générale, tout CSS ou JavaScript que vous ajoutez devrait être mis dans le dossier `src/`*
+
+### `package.json`
+
+C'est un fichier utilisé par les gestionnaires de paquets JavaScript pour gérer vos dépendances. Il définit également les scripts qui sont utilisés pour exécuter Astro (ex: `npm start`, `npm run build`).
+
+Pour plus d'informations en ce qui concerne la création d'un nouveau fichier `package.json` pour votre projet, consultez les instructions de [configuration manuelle](/fr/install/manual/).
+
+### `astro.config.mjs`
+
+Ce fichier est généré dans chaque modèle de démarrage et contient des options de configuration pour votre projet Astro. Ici, vous pouvez spécifier les intégrations à utiliser, les options de compilation, les options du serveur, et plus encore.
+
+Allez voir la [documentation de configuration](/fr/reference/configuration-reference/) pour plus d'informations sur les options de configuration.

From 6ddce20731861a5b530b6688725cd6ed08abdf38 Mon Sep 17 00:00:00 2001
From: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com>
Date: Sat, 28 May 2022 10:48:12 -0300
Subject: [PATCH 10/41] i18n(pt-BR): Add `rss.md` translation (#562)

* Add `rss.md` translation

* Fix broken link

* Apply suggestions

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/i18n/pt-BR/nav.ts         |   1 +
 src/pages/pt-BR/guides/rss.md | 165 ++++++++++++++++++++++++++++++++++
 2 files changed, 166 insertions(+)
 create mode 100644 src/pages/pt-BR/guides/rss.md

diff --git a/src/i18n/pt-BR/nav.ts b/src/i18n/pt-BR/nav.ts
index 039537af93a60..46c15fd87a503 100644
--- a/src/i18n/pt-BR/nav.ts
+++ b/src/i18n/pt-BR/nav.ts
@@ -21,6 +21,7 @@ export default NavDictionary({
 	'guides/aliases': 'Atalhos de Importação',
 	'guides/integrations-guide': 'Integrações',
 	'guides/server-side-rendering': 'Renderização no lado do Servidor (SSR)',
+	'guides/rss': 'RSS',
 	'guides/typescript': 'TypeScript',
 	reference: 'Referência',
 	'reference/directives-reference': 'Diretivas de Template',
diff --git a/src/pages/pt-BR/guides/rss.md b/src/pages/pt-BR/guides/rss.md
new file mode 100644
index 0000000000000..3ee78f3dc0b4b
--- /dev/null
+++ b/src/pages/pt-BR/guides/rss.md
@@ -0,0 +1,165 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: RSS
+description: Uma introdução a RSS em Astro
+i18nReady: true
+---
+
+Astro suporta geração rápida e automática de feeds RSS para blogs e outros websites orientados a conteúdo. Para mais informações sobre feeds RSS como um todo, veja [aboutfeeds.com](https://aboutfeeds.com/).
+
+## Usando `@astrojs/rss` (recomendado)
+
+O pacote `@astrojs/rss` fornece utilitários para a geração de feeds RSS utilizando [endpoints de API](/pt-BR/core-concepts/astro-pages/#páginas-não-html). Isso permite construções estáticas *e* geração sob demanda quando você estiver utilizando um [adaptador de SSR](/pt-BR/guides/server-side-rendering/#habilitando-o-ssr-em-seu-projeto).
+
+Primeiro, instale `@astrojs/rss` utilizando seu gerenciador de pacotes favorito:
+
+```bash
+# npm
+npm i @astrojs/rss
+# yarn
+yarn add @astrojs/rss
+# pnpm
+pnpm i @astrojs/rss
+```
+
+Então, garanta de que você [configurou `site`](/pt-BR/reference/configuration-reference/#site) no `astro.config` do seu projeto. Você utilizará essa opção para gerar os links do seu feed RSS [a partir da variável de ambiente `SITE`](/pt-BR/guides/environment-variables/#default-environment-variables).
+
+> Nota: A variável de ambiente `SITE` apenas existe na recente versão Astro 1.0 beta. Atualize para a versão mais recente do Astro (`astro@latest`), ou escreva seu `site` manualmente se isso não for possível (veja exemplos abaixo).
+
+Agora, vamos gerar nosso primeiro feed RSS! Crie um arquivo `rss.xml.js` no seu diretório `src/pages/`. `rss.xml` vai ser a URL final, então sinta-se livre para renomeá-lo se preferir.
+
+Em seguida, importe o utilitário `rss` do pacote `@astrojs/rss` e o invoque com os seguintes parâmetros:
+
+```js
+// src/pages/rss.xml.js
+import rss from '@astrojs/rss';
+
+export const get = () => rss({
+    // campo `<title>` no xml final
+    title: 'Blog do Buzz',
+    // campo `<description>` no xml final
+    description: 'O guia de um humilde Astronauta para as estrelas',
+    // URL base para links <item> do RSS
+    // SITE irá utilizar o "site" do astro.config do seu projeto.
+    site: import.meta.env.SITE,
+    // lista de `<item>`s no xml final
+    // exemplo simples: gerar itens para cada arquivo md em /src/pages
+    // veja a seção "Gerando Items" para saber o frontmatter necessário e casos de uso mais avançados
+    items: import.meta.glob('./**/*.md'),
+    // (opcional) injete xml customizado
+    customData: `<language>pt-BR</language>`,
+  });
+```
+
+### Gerando `items`
+
+O campo `items` aceita uma dessas opções:
+1. [Um resultado de `import.meta.glob(...)`](#1-resultado-de-importmetaglob) **(apenas use isso para arquivos `.md` dentro do diretório `src/pages/`!)**
+2. [Uma lista de objetos de feed RSS](#2-lista-de-objetos-de-feed-rss), cada um com `link`, `title`, `pubDate`, e os campos opcionais `description` e `customData`.
+
+#### 1. Resultado de `import.meta.glob`
+
+Nós recomendados essa opção como um atalho conveniente para arquivos `.md` em `src/pages/`. Cada postagem deve ter `title`, `pubData` e opcionalmente os campos `description` e `customData` em seu frontmatter. Se isso não for possível, ou você preferir gerar esse frontmatter por código, [veja a opção 2](#2-lista-de-objetos-de-feed-rss).
+
+Digamos que as postagens do seu blog estão armanezadas no diretório `src/pages/blog`. Você pode gerar um feed RSS assim:
+
+```js
+// src/pages/rss.xml.js
+import rss from '@astrojs/rss';
+
+export const get = () => rss({
+    title: 'Blog do Buzz',
+    description: 'O guia de um humilde Astronauta para as estrelas',
+    site: import.meta.env.SITE,
+    items: import.meta.glob('./blog/**/*.md'),
+  });
+```
+
+Veja a [documentação da importação por glob do Vite](https://vitejs.dev/guide/features.html#glob-import) para mais detalhes nessa sintaxe de importação.
+
+#### 2. Lista de objetos de feed RSS
+
+Nós recomendamos essa opção para arquivos `.md` fora do diretório `pages`. Isso é comum quando estiver gerando rotas [via `getStaticPaths`](/pt-BR/reference/api-reference/#getstaticpaths).
+
+Por exemplo, digamos que suas postagens `.md` estão armazenadas no diretório `src/postagens/`. Cada post tem `title`, `pubDate` e `slug` em seu frontmatter, aonde `slug` corresponde a URL final do seu site. Nós podemos gerar um feed RSS utilizando [o helper do Vite `import.meta.globEager`](https://vitejs.dev/guide/features.html#glob-import) assim:
+
+```js
+// src/pages/rss.xml.js
+import rss from '@astrojs/rss';
+
+const resultadoImportacaoPostagens = import.meta.globEager('../postagens/**/*.md');
+const postagens = Object.values(resultadoImportacaoPostagens);
+
+export const get = () => rss({
+    title: 'Blog do Buzz',
+    description: 'O guia de um humilde Astronauta para as estrelas',
+    site: import.meta.env.SITE,
+    items: postagens.map((postagem) => ({
+      link: postagem.frontmatter.slug,
+      title: postagem.frontmatter.title,
+      pubDate: postagem.frontmatter.pubDate,
+    }))
+  });
+```
+
+### Adicionando uma folha de estilos
+
+Você pode estilizar seu feed RSS para tornar a experiência do usuário mais agradável quando estiver visualizando o arquivo em seu navegador.
+
+Utilize a opção `stylesheet` da função `rss` para especificar um caminho absoluto para sua folha de estilos.
+
+```js
+rss({
+  // ex. utiliza sua folha de estilos de "public/rss/styles.xsl"
+  stylesheet: '/rss/styles.xsl',
+  // ...
+});
+```
+
+Se você não tem uma folha de estilos RSS em mente, nós recomendamos [a folha de estilos padrão do Pretty Feed v3](https://github.com/genmon/aboutfeeds/blob/main/tools/pretty-feed-v3.xsl), que você pode baixar do GitHub e salvar no diretório `public/` do seu projeto.
+
+## Utilizando `getStaticPaths()`
+
+> **Nota:** Este método foi descontinuado e será removido antes do lançamento oficial da `v1.0.0`. Por favor utilize `@astrojs/rss` no lugar.
+
+Você também pode criar um feed RSS a partir de qualquer página Astro que utilize a função `getStaticPaths()` para roteamento. Apenas rotas dinâmicas podem utilizar `getStaticPaths()` atualmente. (veja [Roteamento](/pt-BR/core-concepts/routing/)).
+
+Crie um feed RSS chamando a função `rss()` que é passada como um argumento de `getStaticPaths()`. Isso irá criar um arquivo `rss.xml` na sua construçãop final (ou aonde você especificar utilizando `dest`) baseado nos dados que você passar através do array `items`.
+
+```js
+// Exemplo: /src/pages/postagens/[...pagina].astro
+// Coloque essa função dentro do script do seu componente Astro.
+export async function getStaticPaths({rss}) {
+  const todasPostagens = await Astro.glob('../postagens/*.md');
+  const postagensFiltradas = todasPostagens.sort((a, b) => Date.parse(b.frontmatter.data) - Date.parse(a.frontmatter.data));
+  // Gera um feed RSS a partir dessa coleção
+  rss({
+    // Título, descrição e metadados customizados do feed RSS.
+    title: 'Blog do Don',
+    // Veja a seção "Estilizando" abaixo
+    stylesheet: true,
+    description: 'Um blog de exemplo no Astro',
+    customData: `<language>pt-BR</language>`,
+    // A lista de itens do seu feed RSS em ordem.
+    items: postagensFiltradas.map(item => ({
+      title: item.frontmatter.titulo,
+      description: item.frontmatter.descricao,
+      link: item.url,
+      pubDate: item.frontmatter.data,
+    })),
+    // Opcional: Customize aonde o arquivo será escrito.
+    // Caso não, será "/rss.xml" por padrão.
+    dest: '/meu/customizado/feed.xml',
+  });
+  // Retorna os seus caminhos
+  return [...];
+}
+```
+
+Nota: feeds RSS **não** serão construidos durante o desenvolvimento enquanto estiver utilizando este método.
+
+### Adicionando uma folha de estilos
+
+Enquanto estiver utilizando o método `getStaticPaths`, nós iremos gerar opcionalmente uma folha de estilos para você. Passe a opção `stylesheet: true` para puxar a folha de estilos XSL do [Pretty Feed](https://github.com/genmon/aboutfeeds/blob/main/tools/pretty-feed-v3.xsl).
+
+Caso queira utilizar uma folha de estilos XSL customizada, você pode passar uma string como `stylesheet; '/minha-folha-de-estilos-customizada.xsl'`. Este arquivo deve estar no seu diretório `public/` (nesse caso, em `/public/minha-folha-de-estilos-customizada.xsl` ).

From 45d10fa0663f5850e3aef70b623761cbca4b2dd1 Mon Sep 17 00:00:00 2001
From: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com>
Date: Sat, 28 May 2022 10:55:07 -0300
Subject: [PATCH 11/41] i18n(pt-BR): Add `publish-to-npm.md` translation (#566)

* Add `publish-to-npm.md` PT-BR translation

* Fix broken link

* Apply suggestions

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>

* Fix broken link

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>
---
 src/i18n/pt-BR/nav.ts                        |   1 +
 src/pages/pt-BR/guides/publish-to-npm.md     | 282 +++++++++++++++++++
 src/pages/pt-BR/integrations/integrations.md |   2 +-
 3 files changed, 284 insertions(+), 1 deletion(-)
 create mode 100644 src/pages/pt-BR/guides/publish-to-npm.md

diff --git a/src/i18n/pt-BR/nav.ts b/src/i18n/pt-BR/nav.ts
index 46c15fd87a503..2ff9ede758fa4 100644
--- a/src/i18n/pt-BR/nav.ts
+++ b/src/i18n/pt-BR/nav.ts
@@ -21,6 +21,7 @@ export default NavDictionary({
 	'guides/aliases': 'Atalhos de Importação',
 	'guides/integrations-guide': 'Integrações',
 	'guides/server-side-rendering': 'Renderização no lado do Servidor (SSR)',
+	'guides/publish-to-npm': 'Publique no NPM',
 	'guides/rss': 'RSS',
 	'guides/typescript': 'TypeScript',
 	reference: 'Referência',
diff --git a/src/pages/pt-BR/guides/publish-to-npm.md b/src/pages/pt-BR/guides/publish-to-npm.md
new file mode 100644
index 0000000000000..e662b93ecb73e
--- /dev/null
+++ b/src/pages/pt-BR/guides/publish-to-npm.md
@@ -0,0 +1,282 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Publique no NPM
+description: Aprenda como publicar componentes Astro no NPM
+i18nReady: true
+---
+
+Está construindo um novo componente Astro? **Publique-o ao [npm!](https://npmjs.com/)**
+
+Publicar um componente Astro é uma ótima forma de reutilizar o seu trabalho entre projetos e o compartilhar com a grande comunidade do Astro. Componentes Astro podem ser publicados diretamente e instalados pelo NPM, assim como qualquer outro pacote JavaScript.
+
+Procurando por inspiração? Veja alguns dos nossos [temas](https://astro.build/themes/) e [componentes](https://astro.build/integrations/) favoritos da comunidade do Astro. Você também pode [pesquisar pelo npm](https://www.npmjs.com/search?q=keywords:astro-component) para ver o catálogo público inteiro.
+
+> Não quer começar do zero? Veja o [template de componente da comunidade do Astro](https://github.com/astro-community/component-template) e comece com um template mantido pela comunidade!
+
+
+## Início Rápido
+
+Para começar a desenvolver seu componente rapidamente, nós temos um template configurado para você.
+
+```bash
+# Inicialize o template de Componente Astro em um novo diretório
+npm create astro@latest diretorio-do-meu-novo-componente -- --template component
+# yarn
+yarn create astro diretorio-do-meu-novo-componente --template component
+# pnpm
+npm create astro@latest diretorio-do-meu-novo-componente -- --template component
+```
+
+## Criando um pacote
+
+> Antes de se aprofundar, será útil ter um entendimento básico de:
+>
+> - [Módulos Node](https://docs.npmjs.com/creating-node-js-modules)
+> - [Manifesto do Pacote (`package.json`)](https://docs.npmjs.com/creating-a-package-json-file)
+> - [Workspaces](https://docs.npmjs.com/cli/v7/configuring-npm/package-json#workspaces)
+
+Para criar um pacote nós fortemente recomendados configurar seu ambiente de desenvolvimento para utilizar **workspaces** em um projeto. Isso irá permitir que você desenvolva o seu componente ao lado de uma cópia funcional do Astro.
+
+```
+diretorio-do-meu-novo-componente/
+├─ demo/
+| └─ ... para testes e demonstração
+├─ package.json
+└─ packages/
+  └─ meu-componente/
+      ├─ index.js
+      ├─ package.json
+      └─ ... arquivos adicionais usados pelo pacote
+```
+
+Nesse exemplo, chamado de `meu-projeto`, nós criamos um projeto com um único pacote, chamado de `meu-componente` e um diretório `demo` para testes e demonstração do componente.
+
+Isso é configurado no arquivo da raiz do projeto `package.json`.
+
+```json
+{
+  "name": "meu-projeto",
+  "workspaces": ["demo", "packages/*"]
+}
+```
+
+Nesse exemplo, múltiplos pacotes podem ser desenvolvidos juntos a partir do diretório `packages`. Esses pacotes podem ser referenciados de `demo`, aonde você pode instalar uma cópia funcional do Astro.
+
+```shell
+npm create astro@latest demo -- --template minimal
+# yarn
+yarn create astro my-new-component-directory --template minimal
+# pnpm
+pnpm create astro@latest my-new-component-directory -- --template minimal
+```
+
+Há dois arquivos iniciais que irão fazer parte do seu pacote individual: `package.json` e `index.js`.
+
+### `package.json`
+
+O `package.json` no diretório do pacote inclui todas as informações relacionadas ao seu pacote, como sua descrição, dependências e outros metadados do pacote.
+
+```json
+{
+  "name": "meu-componente",
+  "description": "Descrição do componente",
+  "version": "1.0.0",
+  "homepage": "https://github.com/dono/projeto#readme",
+  "type": "module",
+  "exports": {
+    ".": "./index.js",
+    "./astro": "./MeuComponenteAstro.astro",
+    "./react": "./MeuComponenteReact.jsx"
+  },
+  "files": ["index.js", "MeuComponenteAstro.astro", "MeuComponenteReact.jsx"],
+  "keywords": ["astro","astro-component", "...", "..."]
+}
+```
+
+#### `description`
+
+Uma pequena descrição do seu componente, utilizada para ajudar outros a entender o que seu pacote faz.
+
+```json
+{
+  "description": "Um gerador de elementos Astro"
+}
+```
+
+#### `type`
+
+O formato de módulo utilizado pelo Node.js e pelo Astro para interpretar seus arquivos `index.js`.
+
+```json
+{
+  "type": "module"
+}
+```
+
+Nós recomendados utilizar `"type": "module"` para que assim seu `index.js` possa ser usado como ponto de entrada com `import` e `export`.
+
+### `package.json#homepage`
+
+A url da página inicial do seu projeto.
+
+```json
+{
+  "homepage": "https://github.com/dono/projeto#readme"
+}
+```
+
+Essa é uma ótima forma de direcionar usuários a uma demonstração online, documentação ou a página inicial do seu projeto.
+
+#### `package.json#exports`
+
+Os pontos de entrada de um pacote quando importado pelo seu nome.
+
+```json
+{
+  "exports": {
+    ".": "./index.js",
+    "./astro": "./MeuComponenteAstro.astro",
+    "./react": "./MeuComponenteReact.jsx"
+  }
+}
+```
+
+Neste exemplo, importar `meu-componente` utilizaria `index.js`, enquanto importar `meu-componente/astro` ou `meu-componente/react` utilizaria `MeuComponenteAstro.astro` ou `MeuComponenteReact.jsx` respectivamente.
+
+#### `files`
+
+Esta é uma otimização opcional para excluir arquivos desnecessários do empacotamento enviado aos usuários via npm. Note de que **apenas arquivos listados aqui serão incluídos no seu pacote**, então se você adicionar ou modificar arquivos necessários para seu pacote funcionar, você precisar atualizar essa lista de acordo.
+
+```json
+{
+  "files": ["index.js", "MeuComponenteAstro.astro", "MeuComponenteReact.jsx"]
+}
+```
+
+#### `keywords`
+
+Um array de palavras-chave relevantes para o seu componente que será utilizado para ajudar outros a encontrar [seu pacote no npm](https://www.npmjs.com/search?q=keywords:astro-component) e em outros catálogos de pesquisa.
+
+Nós recomendados adicionar `astro-component` como uma palavra-chave especial para maximizar a sua descoberta no ecossistema Astro.
+
+```json
+{
+  "keywords": ["astro-component", "... etc", "... etc"]
+}
+```
+
+> Palavras-chave também são utilizadas por nossa [biblioteca de integrações](https://astro.build/integrations/)! [Veja abaixo](#biblioteca-de-integrações) para uma lista completa das palavras-chave que procuramos por no NPM.
+
+---
+
+### `index.js`
+
+O **ponto de entrada principal do pacote** é utilizado sempre que seu pacote é importado.
+
+```js
+export { default as MeuComponenteAstro } from './MeuComponenteAstro.astro';
+
+export { default as MeuComponenteReact } from './MeuComponenteReact.jsx';
+```
+
+Isso permite que você empacote múltiplos componentes juntos em uma única interface.
+
+#### Exemplo: Utilizando Importações Nomeadas
+
+```astro
+---
+import { MeuComponenteAstro } from 'meu-componente';
+import { MeuComponenteReact } from 'meu-componente';
+---
+<MeuComponenteAstro />
+<MeuComponenteReact />
+```
+
+#### Exemplo: Utilizando Importações de Namespace
+
+```astro
+---
+import * as Exemplo from 'componente-astro-exemplo';
+---
+<Exemplo.MeuComponenteAstro />
+<Exemplo.MeuComponenteReact />
+```
+
+#### Exemplo: Utilizando Importações Individuais
+
+```astro
+---
+import MeuComponenteAstro from 'componente-astro-exemplo/astro';
+import MeuComponenteReact from 'componente-astro-exemplo/react';
+---
+<MeuComponenteAstro />
+<MeuComponenteReact />
+```
+
+---
+
+## Desenvolvendo seu pacote 
+
+Astro não possui um "modo pacote" dedicado para desenvolvimento. Nesse caso, você deve utilizar um projeto demonstrativo para desenvolver e testar seu pacote dentro do seu projeto. Pode ser um website privado apenas para desenvolvimento ou uma demonstração/documentação pública para o seu pacote.
+
+Se você estiver extraindo componentes de um projeto existente, você pode até mesmo continuar a utilizar aquele projeto para desenvolver os seus componentes extraídos.
+
+## Testando seu componente
+
+Astro atualmente não vem com um executador de testes. Isso é algo que gostaríamos de resolver. _(Se você estiver interessado em ajudar, [junte-se a nós no Discord!](https://astro.build/chat/))_
+
+Enquanto isso, nossas recomendações atuais para testes é: 
+
+1. Adicionar um diretório `fixtures` ao seu diretório `demo/src/pages`.
+2. Adicionar uma nova página para cada teste que você deseja executar.
+3. Cada página deve ter algum uso diferente do componente que você gostaria de testar.
+4. Execute `astro build` para construir suas fixtures, então compare o resultado final do diretório `dist/__fixtures__/` com o resultado esperado.
+
+```bash
+meu-projeto/demo/src/pages/__fixtures__/
+  ├─ nome-teste-01.astro
+  ├─ nome-teste-02.astro
+  └─ nome-teste-03.astro
+```
+
+## Publicando seu componente
+
+Assim que você tiver seu pacote pronto, você pode publicá-lo no npm!
+
+Para publicar um pacote no npm, utilize o comando `npm publish`. Se o comando falhar, certifique-se de que você está logado via `npm login` e que seu `package.json` está correto. Se o comando funcionou, você terminou!
+
+Entenda que não há uma etapa de `build` para pacotes Astro. Quaisquer tipos de arquivos que o Astro suporta podem ser publicados diretamente sem uma etapa de construção, pois sabemos que o Astro já os suporta nativamente. Isso inclui arquivos com extensões como `.astro`, `.ts`, `.jsx` e `.css`.
+
+Se você precisar de outro tipo de arquivo que não é nativamente suportado pelo Astro, sinta-se livre para adicionar uma etapa de construção ao seu pacote. Esta prática avançada fica por sua conta.
+
+## Biblioteca de Integrações
+
+Compartilhe o seu trabalho árduo adicionando sua integração a nossa [biblioteca de integrações](https://astro.build/integrations/)!
+
+### Dados do `package.json` 
+
+A biblioteca é automaticamente atualizada toda noite, puxando cada pacote publicado no NPM com a palavra-chave `astro-component`.
+
+A biblioteca de integrações lê os dados `name`, `description`, `repository` e `homepage` do seu `package.json`.
+
+Avatars são uma ótima forma de destacar a sua marca na biblioteca! Assim que seu pacote estiver publicado você pode [adicionar um GitHub issue](https://github.com/withastro/astro.build/issues/new/choose) com o seu avatar anexado e nós iremos adicionar a sua listagem.
+
+> Precisa sobrescrever a informação que nossa biblioteca lê do NPM? Sem problema! [Adicione uma issue](https://github.com/withastro/astro.build/issues/new/choose) com as informações atualizadas e nós nos certificaremos que o `name`, `description` ou `homepage` customizado seja utilizado no lugar.
+
+### Coleções
+
+Em adição a palavra-chave obrigatória `astro-component`, outras palavras-chave são utilizadas para automaticamente organizar os pacotes. Incluindo qualquer uma das palavras-chave abaixo, que irão adicionar sua integração a uma coleção em nossa biblioteca de integrações. 
+
+| Coleção     | palavras-chave                           |
+|------------ | ---------------------------------------- |
+| Todos       | `astro-component`                        |
+| Análise     | `analytics`                              |
+| CMS         | `cms`, `database`                        |
+| CSS + UI    | `css`, `ui`, `icon`, `icons`, `renderer` |
+| E-commerce  | `ecommerce`, `e-commerce`                |
+| Performance | `performance`, `perf`                    |
+| SEO         | `seo`, `performance`, `perf`             |
+
+## Compartilhe
+
+Nós incentivamos que você compartilhe o seu trabalho, assim como amamos ver o que nossos talentosos Astronautas criaram. Venha e compartilhe o que você criou conosco em nosso [Discord](https://astro.build/chat/) ou mencione [@astrodotbuild](https://twitter.com/astrodotbuild) em um Tweet!
diff --git a/src/pages/pt-BR/integrations/integrations.md b/src/pages/pt-BR/integrations/integrations.md
index 0c507e2fbf011..27374896c7712 100644
--- a/src/pages/pt-BR/integrations/integrations.md
+++ b/src/pages/pt-BR/integrations/integrations.md
@@ -8,7 +8,7 @@ Membros da comunidade Astro tem integrado com sucesso as ferramentas e serviços
 
 Aqui estão alguns sites em produção, repositórios, postagens em blogs e vídeos da comunidade demonstrando como você pode conectar Astro com uma variedade de tecnologias populares de CMS, eCommerce, Autenticação/Autorização, Pesquisa e Comentários.
 
-> Procurando por uma integração específica? Veja a nossa nova [biblioteca de integrações](https://astro.build/integrations) e aprenda como [adicionar suas integrações](/pt-BR/guides/publish-to-npm/#integrations-library) à biblioteca!
+> Procurando por uma integração específica? Veja a nossa nova [biblioteca de integrações](https://astro.build/integrations) e aprenda como [adicionar suas integrações](/pt-BR/guides/publish-to-npm/#biblioteca-de-integrações) à biblioteca!
 
 > Nota dos tradutores: Apesar das descrições abaixo estarem traduzidas, o conteúdo dos links é em Inglês.
 

From 1e5ef2a46188792423134728eeae61846d38aa0e Mon Sep 17 00:00:00 2001
From: Astroalex <alexis31.balthazard@gmail.com>
Date: Sat, 28 May 2022 17:03:29 +0200
Subject: [PATCH 12/41] i18n(fr): Update `markdown-content.md` to latest
 changes (#682)

* i18n(fr): Update `markdown-content.md` to latest changes

* Apply changes from code review
---
 src/pages/fr/guides/markdown-content.md | 36 ++++++++++++++++++++++++-
 1 file changed, 35 insertions(+), 1 deletion(-)

diff --git a/src/pages/fr/guides/markdown-content.md b/src/pages/fr/guides/markdown-content.md
index 106f5c5ca73a7..54919c01d009c 100644
--- a/src/pages/fr/guides/markdown-content.md
+++ b/src/pages/fr/guides/markdown-content.md
@@ -217,8 +217,42 @@ Chaque fichier Markdown exporte les propriétés suivantes :
 
 - `frontmatter` : Toutes les données spécifiées dans le Frontmatter de ce fichier, utilisant la syntaxe YAML.
 - `file` : Le chemin absolu de ce fichier (par exemple, `/home/user/projets/.../file.md`).
-- `url` : Si c'est une Page, son URL (par exemple, `/en/guides/markdown-content`).
+- `url` : Si c'est une Page, son URL (par exemple, `/fr/guides/markdown-content/`).
 - `getHeaders()` : Une fonction asynchrone qui renvoie les entêtes du fichier Markdown. La réponse suit ce type : `{ depth: number; slug: string; text: string }[]`.
+- `rawContent()` : Une fonction qui retourne le contenu brut du fichier Markdown (sans le Frontmatter) en tant que `string`. C'est pratique lorsque vous souhaitez calculer par exemple le "temps de lecture". Cet exemple utilise le [Package populaire "reading-time"](https://www.npmjs.com/package/reading-time) :
+
+  ```astro
+  ---
+  import readingTime from 'reading-time';
+  const posts = await Astro.glob('./posts/**/*.md');
+  ---
+  {posts.map((post) => (
+    <Fragment>
+      <h2>{post.frontmatter.title}</h2>
+      <p>{readingTime(post.rawContent()).text}</p>
+    </Fragment>
+  ))}
+  ```
+
+- `compiledContent()` : Une fonction asynchrone qui retourne le contenu brut après le Build dans une syntaxe valide pour Astro. Notez que **cela n'évalue pas les `{expressions JSX}`, les `<Composants />` ou même les Layouts**! Seuls les blocs Markdown standards comme les `## titres` et les `- listes` seront transformés en HTML. C'est assez utile dans les cas où vous souhaitez afficher le résumé d'un article de blog. Comme la syntaxe Astro est compatible en HTML, nous pouvons utiliser des librairies comme ["node-html-parser"](https://www.npmjs.com/package/node-html-parser) pour récupérer le premier paragraphe de cette façon :
+
+  ```astro
+  ---
+  import { parse } from 'node-html-parser';
+  const posts = await Astro.glob('./posts/**/*.md');
+  ---
+  {posts.map(async (post) => {
+    const firstParagraph = parse(await post.compiledContent())
+      .querySelector('p:first-of-type');
+    return (
+      <Fragment>
+        <h2>{post.frontmatter.title}</h2>
+        {firstParagraph ? <p>{firstParagraph.innerText}</p> : null}
+      </Fragment>
+    );
+  })}
+  ```
+
 - `Content` : Un composant qui affiche le contenu du fichier Markdown. Voici un exemple :
 
   ```astro

From aaaf54cc968b5d50b325f166f4e404d6c8ecd376 Mon Sep 17 00:00:00 2001
From: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com>
Date: Sat, 28 May 2022 12:35:57 -0300
Subject: [PATCH 13/41] i18n(pt-BR): Add `data-fetching.md` and
 `enviroment-variables.md` translations + fix on `astro-components.md` (#552)

* Add `data-fetching.md` and `envoriment-variables.md` translations + fix on `astro-components.md`

* Fix broken links

* Apply suggestions

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>

* Fix `rss.md` broken link

* Fix `styling.md` broken link

* Fix `typescript.md` broken link

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>
---
 src/i18n/pt-BR/nav.ts                         |   2 +
 .../pt-BR/core-concepts/astro-components.md   |   2 +-
 src/pages/pt-BR/guides/data-fetching.md       | 102 +++++++++++++++++
 .../pt-BR/guides/environment-variables.md     | 108 ++++++++++++++++++
 src/pages/pt-BR/guides/imports.md             |   2 +-
 src/pages/pt-BR/guides/rss.md                 |   2 +-
 src/pages/pt-BR/guides/styling.md             |   4 +-
 src/pages/pt-BR/guides/typescript.md          |   2 +-
 8 files changed, 218 insertions(+), 6 deletions(-)
 create mode 100644 src/pages/pt-BR/guides/data-fetching.md
 create mode 100644 src/pages/pt-BR/guides/environment-variables.md

diff --git a/src/i18n/pt-BR/nav.ts b/src/i18n/pt-BR/nav.ts
index 2ff9ede758fa4..0d3f1a067baed 100644
--- a/src/i18n/pt-BR/nav.ts
+++ b/src/i18n/pt-BR/nav.ts
@@ -21,6 +21,8 @@ export default NavDictionary({
 	'guides/aliases': 'Atalhos de Importação',
 	'guides/integrations-guide': 'Integrações',
 	'guides/server-side-rendering': 'Renderização no lado do Servidor (SSR)',
+	'guides/environment-variables': 'Variáveis de Ambiente',
+	'guides/data-fetching': 'Busca de Dados',
 	'guides/publish-to-npm': 'Publique no NPM',
 	'guides/rss': 'RSS',
 	'guides/typescript': 'TypeScript',
diff --git a/src/pages/pt-BR/core-concepts/astro-components.md b/src/pages/pt-BR/core-concepts/astro-components.md
index 3103144a6f5b4..8442408860c06 100644
--- a/src/pages/pt-BR/core-concepts/astro-components.md
+++ b/src/pages/pt-BR/core-concepts/astro-components.md
@@ -39,7 +39,7 @@ import Botao from './Botao.astro';
 ```
 
 
-### Script do Componente
+### O Script do Componente
 
 Astro utiliza uma cerca de código (`---`) para identificar o script do seu componente Astro. Se você já escreveu Markdown antes, você já deve estar familiar com um conceito similar chamado de *frontmatter*. A ideia do Astro de um script do componente foi diretamente inspirado por este conceito.
 
diff --git a/src/pages/pt-BR/guides/data-fetching.md b/src/pages/pt-BR/guides/data-fetching.md
new file mode 100644
index 0000000000000..2c129b1cded13
--- /dev/null
+++ b/src/pages/pt-BR/guides/data-fetching.md
@@ -0,0 +1,102 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Busca de Dados
+description: Aprenda como buscar dados remotamente com Astro utilizando a API fetch.
+i18nReady: true
+---
+
+Arquivos `.astro` podem buscar dados remotamente em tempo de construção para te ajudar a gerar suas páginas.
+
+## `fetch()` em Astro
+
+Todos os [componentes Astro](/pt-BR/core-concepts/astro-components/) tem acesso a [função global `fetch()`](https://developer.mozilla.org/pt-BR/docs/Web/API/fetch) em seus scripts do componente para fazer requisições HTTP a APIs. Essa chamada ao `fetch` será executada em tempo de construção, e os dados estarão disponíveis ao template do componente para gerar HTML dinâmico.
+
+💡 Se aproveite de [**top-level await**](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/await#top_level_await) dentro do script do seu componente Astro.
+
+💡 Passe os dados buscados para componentes Astro e de outros frameworks como props.
+
+```astro
+---
+// src/components/Usuario.astro
+import Contato from '../components/Contato.jsx';
+import Localizacao from '../components/Localizacao.astro';
+
+const resposta = await fetch('https://randomuser.me/api/');
+const dados = await resposta.json();
+const usuarioAleatorio = dados.results[0]
+---
+<!-- Dados buscados em tempo de construção podem ser renderizados no HTML -->
+<h1>Usuário</h1>
+<h2>{usuarioAleatorio.name.first} {usuarioAleatorio.name.last}</h2>
+
+<!-- Dados buscados em tempo de construção podem ser passados aos componentes como props -->
+<Contato client:load email={usuarioAleatorio.email} />
+<Localizacao city={usuarioAleatorio.location.city} />
+```
+
+### Consultas GraphQL
+
+Astro também pode utilizar `fetch()` para consultar um servidor GraphQL com qualquer consulta GraphQL válida.
+
+```astro
+---
+const resposta = await fetch("https://graphql-weather-api.herokuapp.com",
+  {
+    method:'POST',
+    headers: {'Content-Type':'application/json'},
+    body: JSON.stringify({
+      query: `
+        query getWeather($name:String!) {
+            getCityByName(name: $name){
+              name
+              country
+              weather {
+                summary {
+                    description
+                }
+              }
+            }
+          }
+        `,
+      variables: {
+          name: "Toronto",
+      },
+    }),
+  })
+
+const json = await resposta.json();
+const clima = json.data
+---
+<h1>Buscando o clima em tempo de construção</h1>
+<h2>{clima.getCityByName.name}, {clima.getCityByName.country}</h2>
+<p>Clima: {clima.getCityByName.clima.summary.description}</p>
+```
+
+> 💡 Lembre-se, todos os dados em componentes Astro são buscados quando o componente é renderizado.
+
+Seu site Astro após o deploy irá buscar os dados **uma vez, em tempo de construção**. No desenvolvimento, você verá a busca de dados ao recarregar componentes. Se você precisa buscar dados múltiplas vezes no lado do cliente, utilize um [componente de framework](/pt-BR/core-concepts/framework-components/) ou um [script no lado do cliente](/pt-BR/core-concepts/astro-components/#scripts-no-lado-do-cliente) em um componente Astro.
+
+## `fetch()` em Componentes de Frameworks
+
+A função `fetch()` também está globalmente disponível a qualquer [componente de framework](/pt-BR/core-concepts/framework-components/):
+
+```tsx
+// Filmes.tsx
+import type { FunctionalComponent } from 'preact';
+import { h } from 'preact';
+
+const dados = await fetch('https://exemplo.com/filmes.json').then((resposta) =>
+  resposta.json()
+);
+
+// Componentes que são renderizados no momento de construção também fazem logs na interface de linha de comando.
+// Quando renderizado com uma diretiva client:*, eles também irão fazer logs no console do navegador.
+console.log(dados);
+
+const Filmes: FunctionalComponent = () => {
+// Exibe o resultado na página
+  return <div>{JSON.stringify(dados)}</div>;
+};
+
+export default Filmes;
+```
diff --git a/src/pages/pt-BR/guides/environment-variables.md b/src/pages/pt-BR/guides/environment-variables.md
new file mode 100644
index 0000000000000..a3a450a520542
--- /dev/null
+++ b/src/pages/pt-BR/guides/environment-variables.md
@@ -0,0 +1,108 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Usando variáveis de ambiente
+description: Aprenda como utilizar variáveis de ambiente em um projeto Astro.
+i18nReady: true
+setup: |
+  import ImportMetaEnv from '~/components/ImportMetaEnv.astro';
+---
+
+Astro utiliza Vite para suas variáveis de ambiente e o permite [utilizar qualquer um de seus métodos](https://vitejs.dev/guide/env-and-mode.html) para obter e definir variáveis de ambiente.
+
+Note que enquanto _todas_ as variáveis de ambiente estão disponíveis em código no lado do servidor, apenas variáveis de ambiente com o prefixo `PUBLIC_` estão disponíveis em código no lado do cliente por segurança.
+
+Veja o exemplo oficial de [variáveis de ambiente](https://github.com/withastro/astro/tree/main/examples/env-vars) para entender as melhores práticas.
+
+```ini
+SENHA_SECRETA=senha123
+PUBLICO_TODOS=there
+```
+<p>
+Nesse exemplo, <code>PUBLICO_TODOS</code> (acessível via <ImportMetaEnv path=".PUBLICO_TODOS" />) estará disponível no código do cliente e do servidor, enquanto <code>SENHA_SECRETA</code> (acessível via <ImportMetaEnv path=".SENHA_SECRETA" />) estará apenas no lado do servidor.
+</p>
+
+## Variáveis de ambiente padrões
+
+Astro inclui algumas variáveis de ambiente por padrão:
+<ul>
+<li> <ImportMetaEnv path=".MODE" /> (<code>development</code> (desenvolvimento) | <code>production</code> (produção)): o modo no qual o seu site está sendo executado. Seu valor é <code>development</code> quando estiver executando <code>astro dev</code> e será <code>production</code> quando estiver executando <code>astro build</code>.</li>
+
+<li> <ImportMetaEnv path=".BASE_URL" /> (<code>string</code>): a URL base na qual o seu site está sendo acessado. Isso é determinado pela <a href="/pt-BR/reference/configuration-reference/#base">opção <code>base</code> da configuração</a>.</li>
+
+<li> <ImportMetaEnv path=".PROD" /> (<code>boolean</code>): Se o seu site está sendo executado em produção.</li>
+
+<li> <ImportMetaEnv path=".DEV" /> (<code>boolean</code>): Se o seu site está sendo executado em desenvolvimento (sempre o contrário de <ImportMetaEnv path=".PROD" />).</li>
+<li><ImportMetaEnv path=".SITE" /> (<code>string</code>): <a href="/pt-BR/reference/configuration-reference/#site">A opção <code>site</code></a> especificada no <code>astro.config</code> do seu projeto.</li>
+</ul>
+
+## Definindo variáveis de ambiente
+
+Variáveis de ambiente podem ser carregadas de arquivos `.env` no diretório do seu projeto.
+
+Você também pode adicionar um modo (entre `production` ou `development`) ao nome do arquivo, como `.env.production` ou `env.development`, que faz com que a variável de ambiente apenas funcione nesse modo.
+
+Simplesmente crie um arquivo `.env` no diretório do seu projeto e adicione algumas variáveis a ele.
+
+```bash
+# .env
+# Isso só estará disponível enquando executado no servidor!
+SENHA_BD="foobar"
+# Isso estará disponível em todo lugar!
+PUBLIC_POKEAPI="https://pokeapi.co/api/v2"
+```
+
+```ini
+.env                # carregado em todos os casos
+.env.local          # carregado em todos os casos, ignorado pelo git
+.env.[modo]         # carregado apenas no modo especificado
+.env.[modo].local   # carregado apenas no modo especificado, ignorado pelo git
+```
+
+## Obtendo variáveis de ambiente
+
+<p>
+
+Ao invés de utilizar `process.env` com o Vite, você pode utilizar <ImportMetaEnv />, que usa a funcionalidade `import.meta` adicionado no ES2020.
+</p>
+<p>
+
+Por exemplo, utilize <ImportMetaEnv path=".PUBLIC_POKEAPI" /> para obter a variável de ambiente `PUBLIC_POKEAPI`.
+</p>
+
+```js
+// Quando import.meta.env.SSR === true
+const dados = await db(import.meta.env.SENHA_BD);
+
+// Quando import.meta.env.SSR === false
+const dados = fetch(`${import.meta.env.PUBLIC_POKEAPI}/pokemon/squirtle`);
+```
+
+_Não se preocupe com a compatilidade com navegadores! Vite substitui todas as menções de <ImportMetaEnv /> com valores estáticos._
+
+> ⚠️AVISO⚠️:
+> Como O Vite estaticamente substitui <ImportMetaEnv />, você não pode acessá-lo com chaves dinâmicas como <ImportMetaEnv path="[chave]" />.
+
+
+
+## IntelliSense para TypeScript
+
+<p>
+
+Por padrão, Vite fornece definições de tipo para <ImportMetaEnv /> em `vite/client.d.ts`. 
+</p>
+
+Embora você possa definir mais variáveis customizadas em arquivos `.env.[modo]`, você pode querer IntelliSense para TypeScript para variáveis de ambiente definidas por usuários que são prefixadas com `PUBLIC_`.
+
+Para realizar isso, você pode criar um `env.d.ts` em `src/` e configurar `ImportMetaEnv` assim:
+
+```ts
+interface ImportMetaEnv {
+  readonly SENHA_BD: string;
+  readonly PUBLIC_POKEAPI: string;
+  // mais variáveis de ambiente...
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}
+```
diff --git a/src/pages/pt-BR/guides/imports.md b/src/pages/pt-BR/guides/imports.md
index 49d2461b6814b..1c6fc28986b39 100644
--- a/src/pages/pt-BR/guides/imports.md
+++ b/src/pages/pt-BR/guides/imports.md
@@ -43,7 +43,7 @@ import { getUsuario } from './usuario.ts';
 import type { TipoUsuario } from './usuario.ts';
 ```
 
-Astro inclui suporte por padrão para [TypeScript](https://www.typescriptlang.org/). Você pode importar arquivos `.ts` e `.tsx` diretamente em seu projeto Astro e até escrever código TypeScript dentro de seu [componente Astro](/pt-BR/core-concepts/astro-components/#script-do-componente).
+Astro inclui suporte por padrão para [TypeScript](https://www.typescriptlang.org/). Você pode importar arquivos `.ts` e `.tsx` diretamente em seu projeto Astro e até escrever código TypeScript dentro de seu [componente Astro](/pt-BR/core-concepts/astro-components/#o-script-do-componente).
 
 **Astro não realiza checagem de tipo**. A checagem de tipo deve ser feita fora do Astro, em sua IDE ou em scripts separados. A [Extensão Astro no VSCode](/pt-BR/editor-setup/) provê automaticamente dicas e erros de TypeScript em seus arquivos abertos.
 
diff --git a/src/pages/pt-BR/guides/rss.md b/src/pages/pt-BR/guides/rss.md
index 3ee78f3dc0b4b..86d21c12304f6 100644
--- a/src/pages/pt-BR/guides/rss.md
+++ b/src/pages/pt-BR/guides/rss.md
@@ -22,7 +22,7 @@ yarn add @astrojs/rss
 pnpm i @astrojs/rss
 ```
 
-Então, garanta de que você [configurou `site`](/pt-BR/reference/configuration-reference/#site) no `astro.config` do seu projeto. Você utilizará essa opção para gerar os links do seu feed RSS [a partir da variável de ambiente `SITE`](/pt-BR/guides/environment-variables/#default-environment-variables).
+Então, garanta de que você [configurou `site`](/pt-BR/reference/configuration-reference/#site) no `astro.config` do seu projeto. Você utilizará essa opção para gerar os links do seu feed RSS [a partir da variável de ambiente `SITE`](/pt-BR/guides/environment-variables/#variáveis-de-ambiente-padrões).
 
 > Nota: A variável de ambiente `SITE` apenas existe na recente versão Astro 1.0 beta. Atualize para a versão mais recente do Astro (`astro@latest`), ou escreva seu `site` manualmente se isso não for possível (veja exemplos abaixo).
 
diff --git a/src/pages/pt-BR/guides/styling.md b/src/pages/pt-BR/guides/styling.md
index 3fbc65ee0365a..da98556869d9c 100644
--- a/src/pages/pt-BR/guides/styling.md
+++ b/src/pages/pt-BR/guides/styling.md
@@ -98,7 +98,7 @@ Há duas formas para incluir folhas de estilos globais e externas: um importaç
 
 ### Importe uma Folha de Estilos
 
-Você pode importar folhas de estilos no front matter do seu componente Astro usando a sintaxe de importação ESM. Importação de CSS funcionam como [qualquer outro importação ESM em um componente Astro](/pt-BR/core-concepts/astro-components/#script-do-componente), que deve ser referenciado **relativo para o componente** e obrigatoriamente deve ser escrito no **início** do script do seu componente junto com outras importações.
+Você pode importar folhas de estilos no front matter do seu componente Astro usando a sintaxe de importação ESM. Importação de CSS funcionam como [qualquer outro importação ESM em um componente Astro](/pt-BR/core-concepts/astro-components/#o-script-do-componente), que deve ser referenciado **relativo para o componente** e obrigatoriamente deve ser escrito no **início** do script do seu componente junto com outras importações.
 
 ```astro
 ---
@@ -259,4 +259,4 @@ Veja a [documentação do Vite](https://vitejs.dev/guide/assets.html#importing-a
 [tailwind]: https://github.com/withastro/astro/tree/main/packages/integrations/tailwind
 [vite-preprocessors]: https://vitejs.dev/guide/features.html#css-pre-processors
 [vue-css-modules]: https://vue-loader.vuejs.org/guide/css-modules.html
-[vue-scoped]: https://vue-loader.vuejs.org/guide/scoped-css.html
\ No newline at end of file
+[vue-scoped]: https://vue-loader.vuejs.org/guide/scoped-css.html
diff --git a/src/pages/pt-BR/guides/typescript.md b/src/pages/pt-BR/guides/typescript.md
index 59596aae4c661..eaa2a55e08285 100644
--- a/src/pages/pt-BR/guides/typescript.md
+++ b/src/pages/pt-BR/guides/typescript.md
@@ -5,7 +5,7 @@ description: Aprenda como utilizar o suporte integrado a TypeScript do Astro.
 i18nReady: true
 ---
 
-Astro vem com suporte integrado para [TypeScript](https://www.typescriptlang.org/). Você pode importar arquivos `.ts` e `.tsx` em seu projeto Astro, e até mesmo escrever código TypeScript dentro de seu [componente Astro](/pt-BR/core-concepts/astro-components/#script-do-componente).
+Astro vem com suporte integrado para [TypeScript](https://www.typescriptlang.org/). Você pode importar arquivos `.ts` e `.tsx` em seu projeto Astro, e até mesmo escrever código TypeScript dentro de seu [componente Astro](/pt-BR/core-concepts/astro-components/#o-script-do-componente).
 
 O Astro em si não realiza checagem de tipo. A checagem de tipo deve ser realizada fora do Astro, seja pela sua IDE ou por um script separado. A [extensão para VSCode do Astro](/pt-BR/editor-setup/) automaticamente providencia dicas e erros do TypeScript em seus arquivos abertos.
 

From 5a6ad426c689877932fdc633fe510b7ccf9c4a90 Mon Sep 17 00:00:00 2001
From: Astroalex <alexis31.balthazard@gmail.com>
Date: Sat, 28 May 2022 22:46:48 +0200
Subject: [PATCH 14/41] i18n(fr): Normalize `getting-started.md` with newer
 pages (#683)

---
 src/pages/fr/getting-started.md | 24 +++++++++++-------------
 1 file changed, 11 insertions(+), 13 deletions(-)

diff --git a/src/pages/fr/getting-started.md b/src/pages/fr/getting-started.md
index b3b5a2b3a3d21..9df866113d750 100644
--- a/src/pages/fr/getting-started.md
+++ b/src/pages/fr/getting-started.md
@@ -6,19 +6,18 @@ layout: ~/layouts/MainLayout.astro
 title: Bien démarrer
 description: Une intro basique à Astro.
 ---
-Générateur de sites statiques  🚀  Amenez votre propre Framework  🚀  Expédiez moins de JavaScript
 
+Générateur de sites statiques  🚀  Amenez votre propre Framework  🚀  Expédiez moins de JavaScript
 
 > Vous avez un ancien projet à dépoussiérer ? Le [guide de migration](/fr/migrate/) vous permettra de le mettre à jour vers la version beta 1.0 !
 
-
 ## Essayez Astro
 
 Nous avons simplifié au maximum votre début dans Astro, que ce soit dans votre navigateur ou sur votre machine !
 
 ### Environnements d'essais en ligne
 
-Visitez [astro.new](https://astro.new) pour la façon la plus simple d' "essayer avant d'acheter". Choisissez parmi une variété de modèles de démarrage et commencez à construire une version complète et fonctionnelle d'Astro dans votre navigateur !
+Visitez [astro.new](https://astro.new/) pour la façon la plus simple "d'essayer avant d'acheter". Choisissez parmi une variété de Templates de démarrage et commencez à construire une version complète et fonctionnelle d'Astro dans votre navigateur !
 
 Ou alors, **lancez instantanément notre projet de démarrage basique** d'un simple clic de bouton :
 
@@ -31,16 +30,16 @@ Ou alors, **lancez instantanément notre projet de démarrage basique** d'un sim
 
 Prêt à installer ?
 
-Créez un nouveau projet prêt localement et en un rien de temps avec notre assistant de création via terminal de commande `create-astro` !
+Créez un nouveau projet prêt localement et en un rien de temps avec notre assistant de création `create-astro` depuis votre terminal de commandes !
 
 ```bash
-# Créez un nouveau projet avec npm
+# Créez un nouveau projet avec NPM
 npm create astro@latest
 
-# ou avec yarn
+# ou avec Yarn
 yarn create astro
 
-# ou bien pnpm
+# ou bien PNPM
 pnpm create astro@latest
 ```
 
@@ -74,17 +73,17 @@ Voici quelques exemples de concepts et modèles de sites construits avec Astro !
 
 ## Étendre l'écosystème Astro
 
-🧰 Démarrez votre prochain projet avec un [thème pré-construit](https://astro.build/themes)
+🧰 Démarrez votre prochain projet avec un [Thème Pré-construit](https://astro.build/themes/).
 
-🧰 Personnalisez votre site avec des [plugins et composants](https://astro.build/integrations/) officiels et communautaires.
+🧰 Personnalisez votre site avec des [Plugins et Composants](https://astro.build/integrations/) officiels et communautaires.
 
-🧰 Inspirez-vous en visitant notre [présentation de sites](https://astro.build/showcase).
+🧰 Inspirez-vous en visitant notre [Présentation de Sites](https://astro.build/showcase/).
 
-*... allez voir notre [guide d'utilisation des intégrations](/fr/guides/integrations-guide/)*
+*... allez voir notre [Guide d'utilisation des Intégrations](/fr/guides/integrations-guide/)*
 
 ## Rejoindre notre communauté
 
-Rejoignez [le Discord d'Astro](https://astro.build/chat) pour partager vos créations et obtenir l'aide d'une communauté active et conviviale !
+Rejoignez [le Discord d'Astro](https://astro.build/chat/) pour partager vos créations et obtenir l'aide d'une communauté active et conviviale !
 
 💬 Dites bonjour dans notre salon `#introduce-yourself` !
 
@@ -100,7 +99,6 @@ Rejoignez [le Discord d'Astro](https://astro.build/chat) pour partager vos créa
 
 [Guide de Migration d'Astro](/fr/migrate/)
 
-
 ## Contribuez
 
 Cette documentation vous a été fournie par toutes ces personnes formidables. [Rejoignez-nous sur GitHub !](https://github.com/withastro/docs)

From 8f19fa9f6bed62e1c467d3460b52044539394f51 Mon Sep 17 00:00:00 2001
From: Kevin Zuniga Cuellar
 <46791833+kevinzunigacuellar@users.noreply.github.com>
Date: Sat, 28 May 2022 23:11:26 -0400
Subject: [PATCH 15/41] i18n(es): translate markdown-content (#678)

* translate markdown-content

* fix typos

* more typos

* update content to match #668

* fix typo

Co-authored-by: Agustin Mulet <31162600+agustinmulet@users.noreply.github.com>

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
Co-authored-by: Agustin Mulet <31162600+agustinmulet@users.noreply.github.com>
---
 src/i18n/es/nav.ts                      |   1 +
 src/pages/es/guides/markdown-content.md | 476 ++++++++++++++++++++++++
 2 files changed, 477 insertions(+)
 create mode 100644 src/pages/es/guides/markdown-content.md

diff --git a/src/i18n/es/nav.ts b/src/i18n/es/nav.ts
index b69df76bdc5d8..a84597e8378fc 100644
--- a/src/i18n/es/nav.ts
+++ b/src/i18n/es/nav.ts
@@ -10,4 +10,5 @@ export default NavDictionary({
 	'core-concepts/project-structure': 'Estructura de proyecto',
 	'core-concepts/routing': 'Reglas de enrutamiento',
 	'core-concepts/partial-hydration': 'Hidratación parcial',
+	'guides/markdown-content': 'Markdown',
 });
diff --git a/src/pages/es/guides/markdown-content.md b/src/pages/es/guides/markdown-content.md
new file mode 100644
index 0000000000000..1eaa488762f4b
--- /dev/null
+++ b/src/pages/es/guides/markdown-content.md
@@ -0,0 +1,476 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Markdown
+description: Usando Markdown en Astro
+i18nReady: true
+---
+
+El contenido de Markdown se usa comúnmente para crear contenido con mucho texto, como artículos de blog y documentación. Astro incluye soporte integrado para markdown con algunas características adicionales como soporte para expresiones JavaScript y componentes de Astro.
+
+## Páginas de Markdown
+
+Astro trata cualquier archivo `.md` dentro de la carpeta `/src/pages` como una página. Al colocar un archivo en esta carpeta, o en cualquier subcarpeta, se creará automáticamente una ruta de página utilizando la ruta del archivo.
+
+📚 Obtenga más información sobre [enrutamiento basado en archivos](/es/core-concepts/routing/) en Astro.
+
+### Ejemplo básico
+
+La forma más fácil de comenzar a usar Markdown en Astro es crear una ruta de la página de inicio `src/pages/index.md` en su proyecto. Copie el codigo a continuación en su proyecto y luego podrá ver el HTML renderizado en la página de inicio de su proyecto. Por lo general, se encuentra en [http://localhost:3000/](http://localhost:3000/).
+
+```markdown
+---
+# Ejemplo: src/pages/index.md
+title: Hola mundo
+---
+
+# Hola!
+
+Esta es su primera página de Markdown. Probablemente no tenga mucho estilo, aunque
+Markdown soporta **negrita** y _cursiva._
+
+Para obtener más información sobre cómo agregar una plantilla a su página, 
+lea la siguiente sección sobre **Plantillas de Markdown**
+```
+
+### Plantillas de Markdown
+
+Las páginas de Markdown tienen una propiedad frontmatter especial para `layout` que define **la ruta relativa** a un [componente plantilla](/es/core-concepts/layouts/) de Astro. Este componente envolverá su contenido Markdown, proporcionando una capa común que incluirá cualquier otro elemento plantilla que desee agregar.
+
+```markdown
+---
+layout: ../layouts/BaseLayout.astro
+---
+```
+
+Un diseño típico de las páginas de Markdown incluyen:
+
+1. la propiedad `content` para acceder a los metadatos de la página de Markdown.
+2. un [`<slot />`](/es/core-concepts/astro-components/#slots) predeterminado para indicar dónde debe mostrarse el contenido Markdown de la página.
+
+```astro
+---
+// src/layouts/BaseLayout.astro
+// 1. La propiedad content le dará acceso a los datos de frontmatter.
+const { content } = Astro.props;
+---
+<html>
+  <head>
+    <!-- Agregue elementos de Head aquí, como estilos y etiquetas meta. -->
+    <title>{content.title}</title>
+  </head>
+  <body>
+    <!-- Agregue aquí otros componentes de UI, como encabezados y pies de página -->
+    <h1>{content.title} by {content.author}</h1>
+    <!-- 2. El HTML renderizado se pasará al slot. -->
+    <slot />
+    <p>Escrito en: {content.date}</p>
+  </body>
+</html>
+```
+
+La propiedad `content` también contiene una propiedad `astro` con metadatos adicionales sobre la página, como el texto Markdown fuente y un objeto `headers`.
+
+Un ejemplo del objeto `content` de un artículo de blog podría verse así:
+
+```json
+{
+  /** Frontmatter de un artículo de blog
+  "title": "Astro actualización 0.18",
+  "date": "Martes, Julio 27 2021",
+  "author": "Matthew Phillips",
+  "description": "Astro 0.18 es nuestra mayor actualización desde el lanzamiento de Astro.",
+  "draft": false,
+  "keywords": ["astro", "actualización", "anuncio"]
+  **/
+  "astro": {
+    "headers": [
+      {
+        "depth": 1,
+        "text": "Astro actualización 0.18",
+        "slug": "astro-018-release"
+      },
+      {
+        "depth": 2,
+        "text": "Hidratación parcial adaptativa",
+        "slug": "responsive-partial-hydration"
+      }
+      /* ... */
+    ],
+    "source": "# Astro actualización 0.18\nHace poco más de un mes, la primera beta pública [...]"
+  },
+  "url": ""
+}
+```
+
+> 💡 `astro` y `url` son las únicas propiedades garantizadas proporcionadas por Astro en la propiedad `content`. El resto del objeto está definido por sus variables de frontmatter.
+
+### Frontmatter como props
+
+Cualquier componente de Astro (¡no solo las plantillas!) pueden recibir valores definidos en el frontmatter del Markdown como props. También puedes especificar varios tipos de datos usando YAML en el frontmatter y capturar metadatos de cada publicación de blog para usar en su proyecto de Astro.
+
+Acceda a estos valores en cualquier archivo `.astro` como lo haría en un componente plantilla, como se describe anteriormente.
+
+### IDs de título
+
+Astro agregará identificaciones generadas automáticamente a todos los títulos y subtítulos en los archivos Markdown usando [github-slugger](https://github.com/Flet/github-slugger). Pero, si se especifica una identificación personalizada, no será sobreescrita.
+
+Estas identificaciones se agregarán _después_ de que se ejecuten todos los demás complementos, por lo que si tiene un complemento como `rehype-toc` que necesita identificaciones, deberá agregar su propio plugin de slug (como `rehype-slug`).
+
+### Borradores en Markdown
+
+`draft: true` es un valor opcional que marcará una página o artículo individual `.md` como "borrador". De forma predeterminada, esta página se excluirá de la compilación final de su proyecto.
+
+Las páginas de Markdown sin la propiedad `draft` o aquellas con `draft: false` no se verán afectadas y se incluirán en la compilación final.
+
+```markdown
+---
+# src/pages/post/blog-post.md
+layout: ../../layouts/BaseLayout.astro
+title: Mi artículo de blog
+draft: true
+---
+
+Este es mi artículo de blog en progreso.
+
+No se creará ninguna página para esta publicación.
+
+Para crear y publicar esta publicación:
+
+- actualice el frontmatter a `draft: false` o
+- elimine la propiedad `draft` por completo.
+```
+
+> ⚠️ Aunque `draft: true` evitará que se construya la página de su proyecto, este archivo estará disponible para `Astro.glob()` el cual devuelve **todos los archivos Markdown** en la ruta especificada.
+
+Para excluir los datos (p. ej., título, enlace, descripción) de un artículo borrador para que no se incluyan en la lista de artículos más recientes, asegúrese que la función `Astro.glob()` **filtre cualquier borrador de la lista de artículos**.
+
+⚙️ Para habilitar la creación de páginas de borrador:
+
+Agregue `drafts: true` a `markdown` en `astro.config.mjs`
+
+```js
+// astro.config.mjs
+export default defineConfig({
+  markdown: {
+    drafts: true,
+  },
+});
+```
+
+💡 ¡También puedes agregar la extensión `--drafts` al ejecutar `astro build` para incluir la creación de páginas borrador!
+
+## Autoría de Markdown
+
+Además de admitir la sintaxis estándar de Markdown, Astro también extiende Markdown para que su contenido sea aún más expresivo. A continuación se muestran algunas características de Markdown que solo existen en Astro.
+
+### Usando variables en Markdown
+
+Las variables de frontmatter se pueden usar directamente en Markdown como propiedades del objeto `frontmatter`.
+
+```markdown
+---
+author: Leon
+age: 42
+---
+
+# Acerca del author
+
+{frontmatter.author} tiene {frontmatter.age} y vive en Toronto, Canadá.
+```
+
+### Usando componentes en Markdown
+
+Puedes importar componentes en su archivo Markdown con `setup` y usarlos junto con su contenido Markdown. El objeto `frontmatter` también está disponible para cualquier componente importado.
+
+```markdown
+---
+layout: ../layouts/BaseLayout.astro
+setup: |
+  import Author from '../../components/Author.astro'
+  import Biography from '../components/Biography.jsx'
+author: Leon
+---
+
+<Author name={frontmatter.author}/>
+<Biography client:visible>
+  {frontmatter.author} vive en Toronto, Canadá y disfruta de la fotografía.
+</Biography>
+```
+
+## Importando Markdown
+
+¡Puedes importar archivos Markdown directamente en sus archivos Astro! Puedes importar una página específica con `import` o varias con `Astro.glob()`
+
+```astro
+---
+// Importe Markdown. ¡La importación dinámica usando import() también es compatible!
+import * as greatPost from '../pages/post/great-post.md';
+
+// Además, puede importar varios archivos con Astro.glob
+const posts = await Astro.glob('../pages/post/*.md');
+---
+
+Genial artículo: <a href={greatPost.url}>{greatPost.frontmatter.title}</a>
+
+<ul>
+  {posts.map(post => <li>{post.frontmatter.title}</li>)}
+</ul>
+```
+
+Cada archivo Markdown exporta las siguientes propiedades:
+
+- `frontmatter`: cualquier dato especificado en el frontmatter YAML de este archivo.
+- `file`: La ruta absoluta de este archivo (por ejemplo, `/home/user/projects/.../file.md`).
+- `url`: si es una página, URL de la página (por ejemplo, `/es/guides/markdown-content`).
+- `getHeaders()`: una función asíncrona que devuelve los títulos del archivo Markdown. La respuesta sigue este tipo: `{ depth: number; slug: string; text: string }[]`.
+- `rawContent()`: Una función que devuelve el contenido sin procesar del archivo Markdown (excluyendo el bloque frontmatter) como un string. Esto es útil cuando, por ejemplo, se calculan los "minutos leídos". Este ejemplo usa el popular paquete [reading-time](https://www.npmjs.com/package/reading-time):
+
+  ```astro
+  ---
+  import readingTime from 'reading-time';
+  const posts = await Astro.glob('./posts/**/*.md');
+  ---
+  {posts.map((post) => (
+    <Fragment>
+      <h2>{post.frontmatter.title}</h2>
+      <p>{readingTime(post.rawContent()).text}</p>
+    </Fragment>
+  ))}
+  ```
+
+
+- `compiledContent()`: Una función asíncrona que devuelve el contenido compilado a una sintaxis de Astro válida. Nota: **¡Esto no analiza `{expresiones jsx}`, `<Componentes />` o componentes plantilla**! Solo los bloques de Markdown estándar como `##títulos` y `-listas` se compilarán a HTML. Esto es útil cuando, por ejemplo, tienes un bloque de resumen dentro del artículo de blog. Dado que la sintaxis de Astro es HTML válido, podemos usar bibliotecas populares como [node-html-parser](https://www.npmjs.com/package/node-html-parser) para consultar el primer párrafo de la siguiente manera:
+
+  ```astro
+  ---
+  import { parse } from 'node-html-parser';
+  const posts = await Astro.glob('./posts/**/*.md');
+  ---
+  {posts.map(async (post) => {
+    const firstParagraph = parse(await post.compiledContent())
+      .querySelector('p:first-of-type');
+    return (
+      <Fragment>
+        <h2>{post.frontmatter.title}</h2>
+        {firstParagraph ? <p>{firstParagraph.innerText}</p> : null}
+      </Fragment>
+    );
+  })}
+  ```
+
+- `Content`: un componente que representa el contenido del archivo Markdown. Aquí hay un ejemplo:
+
+```astro
+---
+import {Content as PromoBanner} from '../components/promoBanner.md';
+---
+
+<h2>Today's promo</h2>
+<PromoBanner />
+```
+
+Opcionalmente, puedes proporcionar un tipo para la variable `frontmatter` usando un genérico de TypeScript:
+
+```astro
+---
+interface Frontmatter {
+  title: string;
+  description?: string;
+}
+const posts = await Astro.glob<Frontmatter>('../pages/post/*.md');
+---
+
+<ul>
+  {posts.map(post => <li>{post.title}</li>)}
+  <!-- post.title será un `string`! -->
+</ul>
+```
+
+## Componente Markdown
+
+> NOTA: El componente `<Markdown />` no funciona en SSR y puede eliminarse antes que Astro alcance la v1.0. Debe evitarse si es posible. Para usar Markdown en sus plantillas, use un archivo `.md` separado y luego [`importe` Markdown](/es/guides/markdown-content/#importando-markdown) en su plantilla como componente.
+
+Puede importar el [componente Markdown](/es/reference/api-reference/#markdown-) de Astro en el script de su componente y escribir cualquier Mdoarkdown que desee entre las etiquetas `<Markdown></Markdown>`.
+
+````astro
+---
+import { Markdown } from 'astro/components';
+import Layout from '../layouts/Layout.astro';
+
+const expressions = 'Lorem ipsum';
+---
+<Layout>
+  <Markdown>
+    # ¡Hola Mundo!
+
+    **Todo** lo soportado en un archivo `.md` también es compatible aquí.
+
+    No hay ninguna sobrecarga en tiempo de ejecución.
+
+    Además, Astro admite:
+    - {Expresiones de Astro}
+    - Normalización automática de indentación
+    - Escape automático de expresiones dentro de bloques de código.
+
+    ```js
+      // ¡Este contenido no se transformará!
+      const object = { someOtherValue };
+    ```
+
+    - Compatibilidad con componentes de UI como cualquier archivo `.astro`.
+    - Compatibilidad con Markdown recursivo (los componentes secundarios también se procesan como Markdown)
+  </Markdown>
+</Layout>
+````
+
+### Markdown remoto
+
+> NOTA: El componente `<Markdown />` no funciona en SSR y puede eliminarse antes que Astro alcance la v1.0. Debe evitarse si es posible. Para usar Markdown en sus plantillas, use un archivo '.md' separado y luego 'impórtelo' a su plantilla como un componente. Lea esta [discusión de RFC](https://github.com/withastro/rfcs/discussions/179) para obtener más información.
+
+Si tiene Markdown en una fuente remota, puede pasarlo directamente al componente Markdown a través del atributo `content`.
+
+```astro
+---
+import { Markdown } from 'astro/components';
+
+const content = await fetch('https://raw.githubusercontent.com/withastro/docs/main/README.md').then(res => res.text());
+---
+<Layout>
+  <Markdown content={content} />
+</Layout>
+```
+
+### Markdown anidado
+
+> NOTA: El componente `<Markdown />` no funciona en SSR y puede eliminarse antes que Astro alcance la v1.0. Debe evitarse si es posible. Para usar Markdown en sus plantillas, use un archivo '.md' separado y luego 'impórtelo' a su plantilla como un componente. Lea esta [discusión de RFC](https://github.com/withastro/rfcs/discussions/179) para obtener más información.
+
+Los componentes `<Markdown />` pueden ser anidados.
+
+```astro
+---
+import { Markdown } from 'astro/components';
+
+const content = await fetch('https://raw.githubusercontent.com/withastro/docs/main/README.md').then(res => res.text());
+---
+
+<Layout>
+  <Markdown>
+    ## Ejemplo Markdown 
+
+    Aquí tenemos algo de código __Markdown__. También podemos renderizar dinámicamente contenido remoto.
+
+    <Markdown content={content} />
+  </Markdown>
+</Layout>
+```
+
+>⚠️ El uso del componente `Markdown` para renderizar Markdown remoto puede exponerlo a un ataque [cross-site scripting (XSS)](https://en.wikipedia.org/wiki/Cross-site_scripting). Si está renderizando contenido que no es de confianza, asegúrese de _desinfectar su contenido **antes** de renderizarlo_.
+
+## Configuración de Markdown
+
+Puedes personalizar el parseo de Markdown modificando el archivo `astro.config.mjs`. [Lea aquí la referencia completa](/es/reference/configuration-reference/#markdown-options). 
+
+### Plugins de Markdown
+
+Astro es compatible con plugins externos como [remark](https://github.com/remarkjs/remark) y [rehype](https://github.com/rehypejs/rehype). Puedes proporcionar los plugins en `astro.config.mjs`.
+
+> **Nota:** De forma predeterminada, Astro viene con [GitHub flavored markdown](https://github.com/remarkjs/remark-gfm) y [remark-smartypants](https://github.com/silvenon/remark-smartypants) por defecto. Habilitar `remarkPlugins` o `rehypePlugins` personalizados eliminará estos complementos integrados y deberá agregarlos explícitamente si lo desea.
+
+#### ¿Cómo agregar plugins de Markdown a Astro?
+
+1. Instale la dependencia del paquete npm en su proyecto.
+
+2. Actualice `remarkPlugins` o `rehypePlugins` dentro de las opciones `markdown`:
+
+   ```js
+   // astro.config.mjs
+   export default {
+     markdown: {
+       remarkPlugins: [
+         // Agregue el plugin de remark que desee habilitar para su proyecto.
+         // Si necesita proporcionar opciones para el plugin, puede usar un array y colocar las opciones en el segundo elemento.
+         // ['remark-autolink-headings', { behavior: 'prepend'}],
+       ],
+       rehypePlugins: [
+         // Agregue un plugin de rehype que desee habilitar para su proyecto.
+         // Si necesita proporcionar opciones para el plugin, puede usar un array y colocar las opciones en el segundo elemento.
+         // 'rehype-slug',
+         // ['rehype-autolink-headings', { behavior: 'prepend'}],
+       ],
+     },
+   };
+   ```
+
+   Puede proporcionar nombres de los plugins e importarlos:
+
+   ```js
+   // astro.config.mjs
+   import autolinkHeadings from 'remark-autolink-headings';
+
+   export default {
+     markdown: {
+       remarkPlugins: [[autolinkHeadings, { behavior: 'prepend' }]],
+     },
+   };
+   ```
+
+### Resaltado de sintaxis
+
+Astro viene con soporte integrado para [Shiki](https://shiki.matsu.io/) y [Prism](https://prismjs.com/). Esto proporciona un resaltado de sintaxis instantáneo para:
+
+- todas las vallas de codigo (\`\`\`) usadas en los archivos markdown (`.md`) y el [componente `<Markdown />`](#componente-markdown).
+- el contenido dentro del [componente `<Code />`](/es/reference/api-reference/#code-) (con la tecnología de Shiki), o el [componente `<Prism />`](/es/reference/api-reference/#prism-) impulsado por Prism.
+
+Shiki está habilitado de forma predeterminada, preconfigurado con el tema `github-dark`. La salida compilada se limitará a estilos en línea sin clases CSS extrañas, hojas de estilo o JS del lado del cliente.
+
+Si opta por usar Prism, aplicaremos las clases CSS de Prism en su lugar. ¡Tenga en cuenta que **necesita traer su propia hoja de estilo CSS** para que aparezca el resaltado de sintaxis! Consulte la [sección de configuración de Prism](#configuración-de-prism) para obtener más detalles.
+
+#### Escoja un resaltador de sintaxis
+
+Shiki es nuestro resaltador de sintaxis predeterminado. Si desea cambiar a `'prism'` o deshabilitar el resaltado de sintaxis por completo, puede usar el objeto de configuración `markdown`:
+
+```js
+// astro.config.mjs
+export default {
+  markdown: {
+    // Puede ser 'shiki' (predeterminado), 'prism' o false para deshabilitar el resaltado
+    syntaxHighlight: 'prism',
+  },
+};
+```
+
+#### Configuración de Shiki
+
+Al usar Shiki, configurará todas las opciones a través del objeto `shikiConfig` así:
+
+```js
+// astro.config.mjs
+export default {
+  markdown: {
+    shikiConfig: {
+      // Escoja entre los temas integrados de Shiki (o agregue los suyos propios)
+      // https://github.com/shikijs/shiki/blob/main/docs/themes.md
+      theme: 'dracula',
+      // Agregar lenguajes de programación personalizados
+      // Nota: Shiki tiene innumerables lenguajes de programación incorporados, ¡incluido .astro!
+      // https://github.com/shikijs/shiki/blob/main/docs/languages.md
+      langs: [],
+      // Habilite word wrap para evitar el desplazamiento horizontal
+      wrap: true,
+    },
+  },
+};
+```
+
+También sugerimos [leer la documentación de Shiki sobre sus temas](https://github.com/shikijs/shiki/blob/main/docs/themes.md#loading-theme) para explorar la carga de un tema personalizado, alternar entre el modo claro y el oscuro, o estilar a través de variables de CSS.
+
+#### Configuración de Prism
+
+Cuando use Prism, deberá agregar una hoja de estilos a su proyecto para resaltar la sintaxis. Si recién empieza y prefiere usar Prism en lugar de Shiki, le sugerimos:
+
+1. [Configurar `syntaxHighlight: 'prism'`](#escoja-un-resaltador-de-sintaxis) desde su configuración `@astrojs/markdown-remark`.
+2. Escoger una hoja de estilo prediseñada de los [temas de Prism](https://github.com/PrismJS/prism-themes) disponibles.
+3. Agregar esta hoja de estilo a la [carpeta `public/`](/es/core-concepts/project-structure/#public) de su proyecto.
+4. Cargar esto en el [`<head>` de su página](/es/core-concepts/astro-pages/#páginas-html) a través de una etiqueta `<link>`.
+
+También puedes visitar la [lista de lenguajes de programación admitidos por Prism](https://prismjs.com/#supported-languages) para conocer las opciones y el uso.

From aed54952a55bb9d6d5326bb24881211ec2bfa0cf Mon Sep 17 00:00:00 2001
From: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com>
Date: Sun, 29 May 2022 09:43:57 -0300
Subject: [PATCH 16/41] i18n(pt-BR): Add `routing.md` translation (#555)

* Add `routing.md` translations

* Apply suggestions

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>

* Update `routing.md` based on #611 and #608 changes

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/i18n/pt-BR/nav.ts                    |   1 +
 src/pages/pt-BR/core-concepts/routing.md | 284 +++++++++++++++++++++++
 2 files changed, 285 insertions(+)
 create mode 100644 src/pages/pt-BR/core-concepts/routing.md

diff --git a/src/i18n/pt-BR/nav.ts b/src/i18n/pt-BR/nav.ts
index 0d3f1a067baed..666eedb4c90df 100644
--- a/src/i18n/pt-BR/nav.ts
+++ b/src/i18n/pt-BR/nav.ts
@@ -13,6 +13,7 @@ export default NavDictionary({
 	'core-concepts/astro-components': 'Componentes',
 	'core-concepts/astro-pages': 'Páginas',
 	'core-concepts/layouts': 'Layouts',
+  'core-concepts/routing': 'Roteamento',
 	features: 'Funcionalidades',
 	'guides/configuring-astro': 'Configurando Astro',
 	'guides/styling': 'Estilização e CSS',
diff --git a/src/pages/pt-BR/core-concepts/routing.md b/src/pages/pt-BR/core-concepts/routing.md
new file mode 100644
index 0000000000000..40d8b7ba2d770
--- /dev/null
+++ b/src/pages/pt-BR/core-concepts/routing.md
@@ -0,0 +1,284 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Roteamento
+description: Uma introdução a roteamento com Astro.
+i18nReady: true
+---
+
+Astro utiliza **roteamento baseado em arquivos** para gerar suas URLs na construção com base no layout dos arquivos no diretório `src/pages` do seu projeto. Quando um arquivo é adicionado ao diretório `src/pages` do seu projeto, ele é automaticamente disponibilizado como uma rota baseada no seu nome de arquivo.
+
+## Rotas estáticas
+
+Componentes Astro (`.astro`) e arquivos Markdown (`.md`) no diretório `src/pages` **automaticamente se tornam páginas no seu website**. A rota de cada página corresponde ao seu caminho e nome no diretório `src/pages`.
+
+```bash
+# Exemplo: Rotas estáticas
+src/pages/index.astro        -> meusite.com/
+src/pages/sobre.astro        -> meusite.com/sobre
+src/pages/sobre/index.astro  -> meusite.com/sobre
+src/pages/sobre/mim.astro     -> meusite.com/sobre/mim
+src/pages/postagens/1.md         -> meusite.com/postagens/1
+```
+
+> Não existe uma "configuração de roteamento" separada para se manter em um projeto Astro. Páginas estáticas são criadas colocando arquivos no diretório `/src/pages/`.
+
+## Rotas dinâmicas
+
+Um único componente de página Astro pode também especificar parâmetros dinâmicos de rota em seu nome de arquivo para gerar múltiplas rotas que cumprem certos critérios. Você pode criar várias páginas relacionadas de uma vez, como páginas de autores, ou uma página para cada categoria de um blog. Parâmetros nomeados te permitem especificar valores para níveis "nomeados" desses caminhos de rotas, e parâmetros rest permitem rotas mais flexíveis que "pegam-tudo".
+
+> 💡 Até mesmo páginas e rotas dinamicamente criadas são geradas em tempo de construção.
+
+Páginas Astro que criam rotas dinâmicas devem:
+
+1. usar notação de `[colchetes]`~para identificar os parâmetros dinâmicos
+
+2. exportar uma função `getStaticPaths()` para especificar exatamente quais caminhos serão pré-renderizados pelo Astro.
+
+### Parâmetros Nomeados
+
+Você pode gerar rotas com um parâmetro `[nomeado]` providenciando a sua função `getStaticPaths()` os valores para utilizá-la assim:
+
+```astro
+---
+// src/pages/cachorros/[cachorro].astro
+
+export function getStaticPaths() {
+  return [
+    // Gera: /cachorros/clifford
+    {params: {cachorro: 'clifford'}},
+    // Gera: /cachorros/rover
+    {params: {cachorro: 'rover'}},
+    // Gera: /cachorros/spot
+    {params: {cachorro: 'spot'}},
+  ];
+}
+---
+```
+
+📚 Aprenda mais sobre [`getStaticPaths()`](/pt-BR/reference/api-reference/#getstaticpaths).
+
+Rotas podem ser geradas a partir de múltiplos parâmetros nomeados, a qualquer nível do caminho de arquivo:
+
+- `pages/blog/[slug].astro` → (`/blog/ola-mundo`, `/blog/postagem-2`, etc.)
+- `pages/[nomeusuario]/configuracoes.astro` → (`/fred/configuracoes`, `/drew/configuracoes`, etc.)
+- `pages/[lingua]-[versao]/info.astro` → (`/en-v1/info`, `/fr-v2/info`, etc.)
+
+#### O objeto `Astro.params`
+
+Componentes Astro que geram rotas dinamicamente tem acesso ao objeto `Astro.params` para cada rota. Isso te permite utilizar as partes geradas de uma URL em seu script e template do componente.
+
+```astro
+---
+// Exemplo: src/pages/postagens/[id].astro
+const { id } = Astro.params;
+---
+<p>Postagem: { id }</p>
+
+
+// Objeto Astro.params passado para a rota `/postagens/abc`
+{ "id": "abc" }
+```
+
+Múltiplos segmentos dinâmicos de rota podem ser combinados para trabalharem da mesma forma.
+
+```astro
+---
+// Exemplo: src/pages/postagens/[id]/[comentario].astro
+const { id, comentario } = Astro.params;
+---
+
+// Objeto Astro.params passado para a rota `/postagens/abc/um-comentario`
+{ "id": "abc", "comentario": "um-comentario" }
+```
+
+### Parâmetros Rest
+
+Se você precisa de mais flexibilidade no roteamento de sua URL, você pode utilizar um parâmetro rest no nome do seu arquivo `.astro` como um pega-tudo universal para caminhos de arquivos de qualquer profundidade adicionando três pontos (`...`) dentro de seus colchetes.
+
+Por exemplo:
+
+- `pages/postagens/[...slug].astro` → (`/postagens/a`, `/postagens/a/b`, `/postagens/a/b/c`, etc.)
+
+Parâmetros correspondentes serão passados como um parâmetro de consulta (`slug` nesse exemplo) para a página.
+
+```json
+// Objeto Astro.params passado para a rota `/postagens/a/b/c`
+{ "slug": "a/b/c" }
+```
+
+> Parâmetros rest são opcionais por padrão, então `pages/postagens/[...slug].astro` pode corresponder com `/postagens/` também.
+
+#### Exemplo: Parâmetros rest
+
+Como um exemplo do mundo real, você pode implementar o visualizador de arquivos do GitHub com os seguintes parâmetros nomeados e rest:
+
+```
+/[org]/[repo]/tree/[branch]/[...arquivo]
+```
+
+Nesse exemplo, uma requisição a `/withastro/astro/tree/main/docs/public/favicon.svg` iria resultar nos seguintes parâmetros sendo disponibilizados em sua página:
+
+```js
+{
+	org: 'withastro',
+	repo: 'astro',
+	branch: 'main',
+	arquivo: 'docs/public/favicon.svg'
+}
+```
+
+## Ordem de Prioridade de Rotas
+
+É possível que múltiplas rotas correspondam ao mesmo caminho de URL. Por exemplo, cada uma destas rotas iria corresponder a `postagens/criar`:
+
+```
+└── pages/
+│       ├── postagens/
+│       │   ├── criar.astro
+│       │   ├── [pid].astro
+│       │   └── [...slug].astro
+
+```
+
+Astro precisa saber qual rota deve ser utilizada para construir a página. Para fazer isso, Astro as ordena de acordo com as seguintes regras:
+
+- Rotas estáticas sem parâmetros de caminho terão precedência sobre todas as outras rotas
+- Rotas dinâmicas utilizando parâmetros nomeados terão precedência sobre parâmetros rest
+- Parâmetros rest terão a menor prioridade
+- Empates são resolvidos alfabeticamente
+
+Com base no exemplo acima, aqui estão alguns exemplos de como as regras irão corresponder a URL requisitada para a rota utilizada para construir o HTML:
+
+- `pages/postagens/criar.astro` - irá construir `/postagens/criar`
+- `pages/postagens/[pid].astro` - irá construir `/postagens/1`, `/postagens/abc`, etc. Mas não `/postagens/criar`
+- `pages/postagens/[...slug].astro` - irã construir `/postagens/1/2`, `/postagens/a/b/c`, etc. Mas não `/postagens/criar`, `/postagens/1`, `/postagens/abc`
+
+## Paginação
+
+Astro suporta paginação de forma integrada para grandes coleções de dados que precisam ser dividos em múltiplas páginas. Astro irá gerar propriedades comuns de paginação, como URLs de anterior/próxima página, número total de páginas, e mais.
+
+Nomes de rotas paginadas devem utilizar a mesma sintaxe em `[colchetes]` de rotas dinâmicas comuns. Por exemplo, o nome de arquivo `/astronautas/[pagina].astro` irá gerar rotas para `/astronautas/1`, `/astronautas/2`, etc, onde `[pagina]` é o número gerado da página.
+
+Você pode utilizar a função `paginate()` para gerar estas páginas a partir um array de valores como abaixo:
+
+```astro
+---
+// Exemplo: /src/pages/astronautas/[pagina].astro
+export async function getStaticPaths({ paginate }) {
+  const paginasAstronautas = [{
+    astronauta: 'Neil Armstrong',
+  }, {
+    astronauta: 'Buzz Aldrin',
+  }, {
+    astronauta: 'Sally Ride',
+  }, {
+    astronauta: 'John Glenn',
+  }];
+  // Gera páginas a partir de nosso array de astronautas, com 2 por página
+  return paginate(paginasAstronautas, { pageSize: 2 });
+}
+// Todos os dados paginados são passados para a prop "page".
+const { page } = Astro.props;
+---
+
+<!--Mostra o número da página atual. Astro.params.page também pode ser utilizado!-->
+<h1>Página {page.currentPage}</h1>
+<ul>
+  <!--Lista o array de informações sobre astronautas-->
+  {page.data.map(({ astronauta }) => <li>{astronauta}</li>)}
+</ul>
+```
+Isso gera as seguintes páginas, com 2 itens por página:
+- `/astronautas/1` - Página 1: Mostra "Neil Armstrong" e "Buzz Aldrin"
+- `/astronautas/2` - Página 2: Mostra "Sally Ride" e "John Glenn"
+
+### A prop `page`
+
+Quando você utiliza a função `paginate()`, cada página na coleção passará seus dados através da prop `page`. A prop `page` tem diversas propriedades úteis, mas a mais importante é `page.data`. Esse é o array contendo os pedaços de dados da página que você passou para a função `paginate()`.
+
+Quando você utiliza a função `paginate()`, cada página terá seus dados passados através da prop `page`. A prop `page` tem diversas propriedades úteis, mas aqui estão as mais importantes:
+- **page.data** - array contendo um pedaço dos dados da página que você passou para a função `paginate()`
+- **page.url.next** - link para a próxima página no conjunto
+- **page.url.prev** - link para a página anterior no conjunto
+
+```astro
+---
+// Exemplo: /src/pages/astronautas/[pagina].astro
+// Faz a paginação da mesma lista de objetos de { astronauta } do exemplo anterior
+export async function getStaticPaths({ paginate }) { /* ... */ }
+const { page } = Astro.props;
+---
+<h1>Página {page.currentPage}</h1>
+<ul>
+  {page.data.map(({ astronauta }) => <li>{astronauta}</li>)}
+</ul>
+{page.url.prev ? <a href={page.url.prev}>Anterior</a> : null}
+{page.url.next ? <a href={page.url.next}>Próximo</a> : null}
+```
+
+
+### Referência completa da API
+
+```ts
+interface Page<T = any> {
+	/** resultado */
+	data: T[];
+	/** metadados */
+	/** A contagem do primeiro item na página, começando por 0 */
+	start: number;
+	/** A contagem do último item na página, começando por 0 */
+	end: number;
+	/** número total de resultados */
+	total: number;
+	/** número da página atual, começando por 1 */
+	currentPage: number;
+	/** número de itens por página (padrão: 25) */
+	size: number;
+	/** número da última página */
+	lastPage: number;
+	url: {
+		/** url da página atual*/
+		current: string;
+		/** url da página anterior (se existir) */
+		prev: string | undefined;
+		/** url da próxima página (se existir) */
+		next: string | undefined;
+	};
+}
+```
+
+## Paginação Aninhada
+
+Um caso de uso mais avançado para página é a **paginação aninhada**. Isso é quando a paginação é combinada com outros parâmetros dinâmicos de rota. Você pode usar paginação aninhada para agrupar suas coleções paginadas por alguma propriedade ou etiqueta.
+
+Por exemplo, se você quiser agrupar suas postagens em Markdown por alguma etiqueta, você pode usar a paginação aninhada criando uma página `/src/pages/[etiqueta]/[pagina].astro` que iria corresponder com as seguintes URLs:
+
+- `/vermelho/1` (etiqueta=vermelho)
+- `/vermelho/2` (etiqueta=vermelho)
+- `/azul/1` (etiqueta=azul)
+- `/verde/1` (etiqueta=verde)
+
+Paginação aninhada funciona retornando um array de resultados do `paginate()` a partir do `getStaticPaths()`, sendo uma para cada agrupamento.
+
+No exemplo abaixo, nós iremos implementar a paginação aninhada para construir as URLs listados acima:
+
+```astro
+---
+// Exemplo: /src/pages/[etiqueta]/[pagina].astro
+export function getStaticPaths({paginate}) {
+  const todasEtiquetas = ['vermelho', 'azul', 'verde'];
+  const todasPostagens = await Astro.glob('../../postagens/*.md');
+  // Para cada etiqueta, retorna um resultado de paginate().
+  // Se certifique de que você passou `{params: {etiqueta}}` ao `paginate()`
+  // para que o Astro saiba qual agrupamento de etiqueta o resultado é para.
+  return todasEtiquetas.map((etiqueta) => {
+    const postagensFiltradas = todasPostagens.filter((postagem) => postagem.frontmatter.etiqueta === etiqueta);
+    return paginate(postagensFiltradas, {
+      params: { etiqueta },
+      pageSize: 10
+    });
+  });
+}
+const { page } = Astro.props;
+const params = Astro.params;
+```

From bc1a6478174b38cb3e755ee8c9dbf10253c47adf Mon Sep 17 00:00:00 2001
From: victor0x16 <100092662+victor0x16@users.noreply.github.com>
Date: Sun, 29 May 2022 10:01:37 -0300
Subject: [PATCH 17/41] i18n(pt-BR): update `styling.md` page (#685)

* i18n(pt-BR): update `styling.md` page

* fix broken link

* apply suggestions

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/pages/pt-BR/guides/styling.md | 56 +++++++++++++++++++++++++++----
 1 file changed, 49 insertions(+), 7 deletions(-)

diff --git a/src/pages/pt-BR/guides/styling.md b/src/pages/pt-BR/guides/styling.md
index da98556869d9c..5b5f1a7a7e841 100644
--- a/src/pages/pt-BR/guides/styling.md
+++ b/src/pages/pt-BR/guides/styling.md
@@ -12,7 +12,7 @@ Astro foi desenvolvido pensando em tornar a estilização e a escrita de CSS fá
 
 ## Estilização em Astro
 
-Estlizar um componente Astro é tão fácil quanto adicionar uma tag `<style>` no seu componente ou template de página. E quando você coloca uma tag `<style>` dentro de um componente astro, Astro vai detectar o CSS e manipular os estilos para você automaticamente.
+Estilizar um componente Astro é tão fácil quanto adicionar uma tag `<style>` no seu componente ou template de página. E quando você coloca uma tag `<style>` dentro de um componente Astro, Astro vai detectar o CSS e manipular os estilos para você automaticamente.
 
 ```astro
 <style>
@@ -64,7 +64,7 @@ Você pode também mesclar regras CSS globais e com escopo juntas na mesma tag `
 <article><slot /></article>
 ```
 
-Isto é uma ótima forma de estilizar coisas como posts de blogs ou documentos alimentados por conteúdos de um CMS, onde o conteúdo fica fora do Astro. Contudo, seja cuidadoso: os componentes cuja aparência muda de acordo com a condição de que ele tem um certo parente, torna mais difícil solucionar problemas futuros que o envolvam.
+Isto é uma ótima forma de estilizar coisas como postagens em blogs ou documentos alimentados por conteúdos de um CMS, onde o conteúdo fica fora do Astro. Contudo, seja cuidadoso: os componentes cuja aparência muda de acordo com a condição de que ele tem um certo parente, torna mais difícil solucionar problemas futuros que o envolvam.
 
 Estilos com escopo são recomendados para serem usados sempre que possível. E estilos globais, quando necessários.
 
@@ -92,13 +92,15 @@ const corPlanoFundo = "rgb(24 121 78)";
 
 ## Estilos Externos
 
-Há duas formas para incluir folhas de estilos globais e externas: um importação ESM para arquivos dentro de seu projeto, e com um link URL absoluto para arquivos em seu diretório `public/` ou disponíveis fora de seu projeto.
+Há duas formas para incluir folhas de estilos globais e externas: uma importação ESM para arquivos dentro de seu projeto, e com um link URL absoluto para arquivos em seu diretório `public/` ou disponíveis fora de seu projeto.
 
 📚 Leia mais sobre como utilizar [assets estáticos](/pt-BR/guides/imports/) localizados no diretório `public/` ou `src/`.
 
-### Importe uma Folha de Estilos
+### Importe uma Folha de Estilos Local
 
-Você pode importar folhas de estilos no front matter do seu componente Astro usando a sintaxe de importação ESM. Importação de CSS funcionam como [qualquer outro importação ESM em um componente Astro](/pt-BR/core-concepts/astro-components/#o-script-do-componente), que deve ser referenciado **relativo para o componente** e obrigatoriamente deve ser escrito no **início** do script do seu componente junto com outras importações.
+> ⚠️ Você talvez precise atualizar o seu astro.config quando estiver importando CSS de pacotes do npm. Veja a [seção de importação de uma folha de estilos de um pacote do npm](#importe-uma-folha-de-estilos-de-um-pacote-do-npm) abaixo.
+
+Você pode importar folhas de estilos no front matter do seu componente Astro usando a sintaxe de importação ESM. Importação de CSS funcionam como [qualquer outra importação ESM em um componente Astro](/pt-BR/core-concepts/astro-components/#o-script-do-componente), que deve ser referenciada **relativo para o componente** e obrigatoriamente deve ser escrito no **início** do script do seu componente junto com outras importações.
 
 ```astro
 ---
@@ -111,7 +113,47 @@ import '../estilos/utils.css';
 
 `import` de CSS por meio de ESM é suportado dentro de qualquer arquivo JavaScript, incluindo componentes JSX como React e Preact. Isto pode ser útil para escrever estilos por componente de forma granular para seus componentes React.
 
-### Inclua uma folha de Estilos Externa
+### Importe uma Folha de Estilos de um Pacote do NPM
+
+Você talvez precise incluir uma folha de estilos de um pacote externo. Isso é especialmente comum para utilitários como [Open Props](https://open-props.style/). Se seu pacote **recomenda usar uma extensão de arquivo** (ex.: `nome-do-pacote/estilos.css` ao invés de `nome-do-pacote/estilos`), isso deve funcionar como qualquer importação de uma folha de estilos local.
+
+```astro
+---
+// src/pages/página-qualquer.astro
+import 'nome-do-pacote/estilos.css';
+---
+<html><!-- Sua página aqui --></html>
+```
+Se seu pacote **não recomenda usar uma extensão de arquivo** (ex.: `nome-do-pacote/estilos`), antes, você vai precisar atualizar sua configuração Astro!
+
+Digamos que você está importando um arquivo CSS de um `nome-do-pacote` chamado `normalize` (com a extensão omitida). Para garantir que nós podemos pré-renderizar sua página corretamente, adicione `nome-do-pacote` para [o array vite.ssr.noExternal](https://vitejs.dev/config/#ssr-noexternal): 
+
+```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config';
+
+export default defineConfig({
+  vite: {
+    ssr: {
+      noExternal: ['nome-do-pacote'],
+    }
+  }
+})
+```
+
+> Nota: Isso é uma configuração [específica do Vite](https://vitejs.dev/config/#ssr-noexternal) que não tem relação com (ou necessita de) [SSR do Astro](/pt-BR/guides/server-side-rendering/).
+
+Agora, você está livre para importar `nome-do-pacote/normalize`. Isto passará por bundle e será otimizado pelo Astro como qualquer outra folha de estilos local.
+
+```astro
+---
+// src/pages/página-qualquer.astro
+import 'nome-do-pacote/normalize';
+---
+<html><!-- Sua página aqui --></html>
+```
+
+### Inclua uma Folha de Estilos Estática via "link" tags
 
 Você pode também usar o elemento `<link>` para incluir uma folha de estilos na página. Isto deve ser um caminho de URL absoluto para um arquivo CSS localizado no seu diretório `/public`, ou uma URL para um website externo. Note que valores relativos de href para o elemento `<link>` não são suportados.
 
@@ -125,7 +167,7 @@ Você pode também usar o elemento `<link>` para incluir uma folha de estilos na
 </head>
 ```
 
-Como esta abordagem usa o diretório `public/`, ela pula o processamento normal do CSS, o processo de bundle e outras otimizações feitas por Astro. Sendo assim, se você precisa desses recursos, use o método de [importe uma folha de estilos](#importe-uma-folha-de-estilos) ensinado acima.
+Como esta abordagem usa o diretório `public/`, ela pula o processamento normal do CSS, o processo de bundle e outras otimizações feitas por Astro. Sendo assim, se você precisa desses recursos, use o método de [importe uma folha de estilos](#importe-uma-folha-de-estilos-local) ensinado acima.
 
 
 ## Integrações CSS

From 9e1855c5f6c99914a67fed656f96d168a61f7347 Mon Sep 17 00:00:00 2001
From: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com>
Date: Sun, 29 May 2022 12:15:37 -0300
Subject: [PATCH 18/41] i18n(pt-BR): Add `api-reference.md` translation (#684)

* Add pt-BR `api-reference.md` translation

* Fix typo and broken link

* Apply suggestions

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/i18n/pt-BR/nav.ts                         |   1 +
 .../pt-BR/core-concepts/astro-components.md   |   2 +-
 src/pages/pt-BR/reference/api-reference.md    | 526 ++++++++++++++++++
 3 files changed, 528 insertions(+), 1 deletion(-)
 create mode 100644 src/pages/pt-BR/reference/api-reference.md

diff --git a/src/i18n/pt-BR/nav.ts b/src/i18n/pt-BR/nav.ts
index 666eedb4c90df..4e731a41dfe01 100644
--- a/src/i18n/pt-BR/nav.ts
+++ b/src/i18n/pt-BR/nav.ts
@@ -31,4 +31,5 @@ export default NavDictionary({
 	'reference/directives-reference': 'Diretivas de Template',
 	'reference/adapter-reference': 'API de Adaptadores',
 	'reference/integrations-reference': 'API de Integrações',
+	'reference/api-reference': 'API de Runtime',
 });
diff --git a/src/pages/pt-BR/core-concepts/astro-components.md b/src/pages/pt-BR/core-concepts/astro-components.md
index 8442408860c06..a48426307ecbd 100644
--- a/src/pages/pt-BR/core-concepts/astro-components.md
+++ b/src/pages/pt-BR/core-concepts/astro-components.md
@@ -399,6 +399,6 @@ Astro detecta estas importações de JavaScript no lado do cliente e então cons
 
 ## Próximos Passos
 
-📚 Leia sobre os [componentes internos de Astro](/pt-BR/reference/api-reference/#built-in-components).
+📚 Leia sobre os [componentes internos de Astro](/pt-BR/reference/api-reference/#componentes-integrados).
 
 📚 Aprenda sobre como utilizar [componentes de frameworks JavaScript](/pt-BR/core-concepts/framework-components/) em seu projeto Astro.
diff --git a/src/pages/pt-BR/reference/api-reference.md b/src/pages/pt-BR/reference/api-reference.md
new file mode 100644
index 0000000000000..2c975367ba91e
--- /dev/null
+++ b/src/pages/pt-BR/reference/api-reference.md
@@ -0,0 +1,526 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Referência da API
+i18nReady: true
+setup: |
+  import ImportMetaEnv from '~/components/ImportMetaEnv.astro';
+---
+
+## Global `Astro`
+
+A global `Astro` está disponível em todos os contextos em arquivos `.astro`. Ela tem as seguintes funções:
+
+### `Astro.glob()`
+
+`Astro.glob()` é uma forma de carregar vários arquivos locais em seu site estático.
+
+```astro
+---
+// ./src/components/meu-componente.astro
+const posts = await Astro.glob('../pages/post/*.md'); // retorna um array de postagens que estão em ./src/pages/post/*.md
+---
+
+<div>
+{posts.slice(0, 3).map((post) => (
+  <article>
+    <h1>{post.frontmatter.titulo}</h1>
+    <p>{post.frontmatter.descricao}</p>
+    <a href={post.frontmatter.url}>Leia mais</a>
+  </article>
+))}
+</div>
+```
+
+`.glob()` recebe apenas um parâmetro: uma URL relativa dos arquivos locais que você gostaria de importar. Ela é assíncrona e retorna um array das exportações dos arquivos correspondentes.
+
+#### Arquivos Markdown
+
+Arquivos Markdown tem a seguinte interface:
+
+```ts
+export interface MarkdownInstance<T extends Record<string, any>> {
+  /* Quaisquer dados especificados no frontmatter YAML deste arquivo */
+	frontmatter: T;
+  /* O caminho do arquivo deste arquivo */
+	file: string;
+  /* O caminho renderizado deste arquivo */
+	url: string | undefined;
+  /* Componente Astro que renderiza os conteúdos deste arquivo */
+	Content: AstroComponent;
+  /* Função que retorna um array de elementos h1...h6 deste arquivo */
+	getHeaders(): Promise<{ depth: number; slug: string; text: string }[]>;
+}
+```
+  
+Você pode opcionalmente oferecer um tipo para a variável `frontmatter` utilizando um generic do TypeScript.
+
+```astro
+---
+interface Frontmatter {
+  titulo: string;
+  descricao?: string;
+}
+const posts = await Astro.glob<Frontmatter>('../pages/post/*.md');
+---
+
+<ul>
+  {posts.map(post => <li>{post.titulo}</li>)}
+</ul>
+```
+
+#### Arquivos Astro
+
+Arquivos Astro tem a seguinte interface:
+
+```ts
+export interface AstroInstance {
+	default: AstroComponent;
+}
+```
+
+#### Outros Arquivos
+
+Outros arquivos podem ter várias diferentes interfaces, mas `Astro.glob()` aceita um generic do TypeScript se você souber exatamente o que o tipo de um arquivo desconhecido contém.
+
+```ts
+---
+interface DadosCustomizadosArquivo {
+  default: Record<string, any>;
+}
+const dados = await Astro.glob<DadosCustomizadosArquivo>('../dados/**/*.js');
+---
+```
+
+### `Astro.request`
+
+`Astro.request` é um objeto [Request](https://developer.mozilla.org/pt-BR/docs/Web/API/Request) padrão. Ele pode ser utilizado para obter a `url`, `headers`, `method` e até mesmo o body de uma requisição. Utilize `new URL(Astro.request.url)` para obter um objeto URL.
+
+```astro
+---
+const url = new URL(Astro.request.url);
+---
+<h1>Origem {url.origin}</h1>
+```
+
+### `Astro.response`
+
+`Astro.response` é um objeto [ResponseInit](https://developer.mozilla.org/en-US/docs/Web/API/Response/Response#init) padrão. Ele pode ser utilizado para definir o `status`, `statusText` e `headers` para a resposta de uma página.
+
+```astro
+---
+if(condicao) {
+  Astro.response.status = 404;
+  Astro.response.statusText = 'Não encontrado';
+}
+---
+```
+
+Ou para definir um header:
+
+```astro
+---
+Astro.response.headers.set('Set-Cookie', 'a=b; Path=/;');
+---
+```
+
+### `Astro.canonicalURL`
+
+A [URL canônica][canonical] da página atual. Se a opção `site` estiver definida, a origem do site será a origem dessa URL.
+
+Você também pode utilizar `canonicalURL` para adquirir o `pathname` da página atual.
+
+```astro
+---
+const caminho = Astro.canonicalURL.pathname;
+---
+
+<h1>Bem-vindo a {caminho}</h1>
+```
+
+### `Astro.site`
+
+`Astro.site` retorna a `URL` feita a partir do `.site` na sua configuração do Astro. Se for `undefined`, isso irá retornar uma URL gerada a partir de `localhost`.
+
+
+### `Astro.slots`
+
+`Astro.slots` contém funções utilitárias para modificar os filhos em slots de um componente Astro.
+
+
+| Nome           | Tipo                                              | Descrição                                        |
+| :------------- | :------------------------------------------------ | :------------------------------------------------- |
+| `has`          | `(name: string) => boolean`                       | Se o conteúdo para o slot com esse nome existe          |
+| `render`       | `(name: string, args?: any[]) => Promise<string>` | Renderiza esse slot de forma assíncrona e retorna HTML   |
+
+```astro
+---
+let html: string = '';
+if (Astro.slots.has('default')) {
+  html = await Astro.slots.render('default')
+}
+---
+<Fragment set:html={html} />
+```
+
+`Astro.slots.render` opcionalmente aceita um segundo argumento, um array de parâmetros que serão passados para os filhos de qualquer função. Isso é extremamente útil para componentes de utilidade customizados.
+
+Dado o seguinte componente `Mensagem.astro`...
+
+```astro
+---
+let html: string = '';
+if (Astro.slots.has('default')) {
+  html = await Astro.slots.render('default', Astro.props.messages)
+}
+---
+<Fragment set:html={html} />
+```
+
+Você pode passar uma função de callback que renderiza a mensagem:
+
+```astro
+<div><Mensagem mensagens={['Olá', 'mundo!']}>{(mensagens) => mensagens.join(' ')}</Mensagem></div>
+<!-- é renderizado como -->
+<div>Olá mundo!</div>
+```
+
+### `Astro.self`
+
+`Astro.self` permite que componentes Astro sejam recursivamente invocados. Este comportamento te permite renderizar um componente Astro em si mesmo utilizando `<Astro.self>` no template do co mponente. Isto pode ser útil para iterar sobre grandes coleções e estruturas de dados aninhadas. 
+
+```astro
+---
+// ListaAninhada.astro
+const { itens } = Astro.props;
+---
+<ul class="lista-aninhada">
+  <li>{itens.map((item) => {
+    if (Array.isArray(item)) {
+      // Se houver uma estrutura de dados aninhada nós renderizamos `<Astro.self>`
+      // e podemos passar props através da invocação recursiva
+      return <Astro.self itens={item} />;
+    } else {
+      return item;
+    }
+  })}</li>
+</ul>
+```
+
+Este componente pode ser utilizado assim:
+
+```astro
+---
+import ListaAninhada from './ListaAninhada.astro';
+---
+<ListaAninhada itens={['A', ['B', 'C'], 'D']} />
+```
+
+E renderizaria HTML assim:
+
+```html
+<ul class="lista-aninhada">
+  <li>A</li>
+  <li>
+    <ul class="lista-aninhada">
+      <li>B</li>
+      <li>C</li>
+    </ul>
+  </li>
+  <li>D</li>
+</ul>
+```
+
+## `getStaticPaths()`
+
+Se uma página utiliza parâmetros dinâmicos em seu nome de arquivo, tal componente precisará exportar uma função `getStaticPaths()`.
+
+Esta função é necessária pois Astro é um gerador de sites estáticos. Isso significa que o seu site inteiro é construído previamente. Se Astro não sabe como gerar uma página em tempo de build, seus usuários não o irão ver quando visitarem o seu site.
+
+```astro
+---
+export async function getStaticPaths() {
+  return [
+    { params: { /* obrigatório */ }, props: { /* opcional */ } },
+    { params: { ... } },
+    { params: { ... } },
+    // ...
+  ];
+}
+---
+<!-- O seu template HTML aqui. -->
+```
+
+A função `getStaticPaths()` deve retornar um array de objetos para determinar quais caminhos serão pré-renderizados pelo Astro.
+
+⚠️ A função `getStaticPaths()` é executada em seu próprio escopo isolado unicamente, antes de qualquer página carregar. Portanto você não pode referenciar nada de seu escopo parente além de importações de arquivos. O compilador irá te avisar se você quebrar esse requisito.
+
+### `params`
+
+A chave `params` de todos os objetos retornados diz ao Astro quais rotas construir. Os parâmetros retornados devem ser mapeados de volta para os parâmetros dinâmicos e rest definidos no caminho de arquivo do seu componente.
+
+`params` são codificados na URL, então apenas strings e números são suportados como valores. O valor para cada objeto `params` deve corresponder aos parâmetros utilizados no nome da página.
+
+Por exemplo, suponha que você tem uma página em `src/pages/posts/[id].astro`. Se você exportar `getStaticPaths` dessa página e retornar os seguintes caminhos:
+
+```astro
+---
+export async function getStaticPaths() {
+  return [
+    { params: { id: '1' } },
+    { params: { id: '2' } },
+    { params: { id:  3 } }
+  ];
+}
+
+const { id } = Astro.params;
+---
+<h1>{id}</h1>
+```
+
+Então Astro irá estaticamente gerar `posts/1,`, `posts/2`, e `posts/3` em tempo de build.
+
+### Passagem de Dados com `props`
+
+Para passar dados adicionais para cada página gerada, você também pode definir um valor a `props` para cada objeto de caminho retornado. Diferente de `params`, `props` não são codificadas na URL, então não estão limitadas a apenas strings.
+
+Por exemplo, supomos que você gera páginas baseando-se em dados buscados a partir de uma API remota. Você pode passar o objeto inteiro dos dados para o componente da página dentro de `getStaticPaths`:
+
+```astro
+---
+export async function getStaticPaths() {
+  const dados = await fetch('...').then(resposta => resposta.json());
+
+  return dados.map((post) => {
+    return {
+      params: { id: post.id },
+      props: { post },
+    };
+  });
+}
+
+const { id } = Astro.params;
+const { post } = Astro.props;
+---
+<h1>{id}: {post.nome}</h1>
+```
+
+Você também pode passar um array normal, que pode ser útil quando for gerar ou esboçar uma lista conhecida de rotas.
+
+```astro
+---
+export async function getStaticPaths() {
+  const posts = [
+    {id: '1', categoria: "astro", titulo: "Referência da API"},
+    {id: '2', categoria: "react", titulo: "Criando um contador com React!"}
+  ];
+  return posts.map((post) => {
+    return {
+      params: { id: post.id },
+      props: { post }
+    };
+  });
+}
+const {id} = Astro.params;
+const {post} = Astro.props;
+---
+<body>
+  <h1>{id}: {post.titulo}</h1>
+  <h2>Categoria: {post.categoria}</h2>
+</body>
+```
+
+Então Astro irá estaticamente gerar `posts/1` e `posts/2` em tempo de build utilizando o componente da página em `pages/posts/[id].astro`. A página pode referenciar esses dados utilizando `Astro.props`:
+
+### `paginate()`
+
+Paginação é um caso de uso comum para websites que Astro nativamente suporta através da função `paginate()`. `paginate()` irá automaticamente gerar o array para retornar de `getStaticPaths()` que cria uma URL para cada página da coleção paginada. O número da página será passado como um parâmetro, e os dados da página serão passados como a prop `page`.
+
+```js
+export async function getStaticPaths({ paginate }) {
+  // Carregue seus dados com fetch(), Astro.glob(), etc.
+  const resposta = await fetch(`https://pokeapi.co/api/v2/pokemon?limit=150`);
+  const resultado = await resposta.json();
+  const todosPokemons = resultado.results;
+
+  // Retorna a coleção paginada de caminhos para todas as postagens
+  return paginate(todosPokemons, { pageSize: 10 });/*-
+}
+
+// Se configurado propriamente, a prop page agora tem tudo
+// o que você precisa para renderizar uma única página (veja a próxima seção)
+const { page } = Astro.props;
+```
+`paginate()` assume um nome de arquivo `[page].astro` ou `[...page].astro`. O parâmetro `page` se torna o número da página em sua URL:
+
+- `/posts/[page].astro` geraria as URLs `/posts/1`, `/posts/2`, `/posts/3`, etc.
+- `/posts/[...page].astro` geraria as URLs `/posts`, `/posts/2`, `/posts/3`, etc.
+
+#### A prop `page` da paginação
+
+A paginação irá passar a prop `page` para cada página renderizada que representa uma única página de dados na coleção paginada. Isso inclui dados que você paginou (`page.data`) assim como metadados para a página (`page.url`, `page.start`, `page.end`, `page.total`, etc). Estes metadados são úteis para coisas como um botão de "Próxima Página" ou uma mensagem "Mostrando 1-10 de 100".
+
+| Name               |         Type          | Descrição                                                                                                                       |
+| :----------------- | :-------------------: | :-------------------------------------------------------------------------------------------------------------------------------- |
+| `page.data`        |        `Array`        | Array dos dados retornados de `data()` para a página atual.                                                                        |
+| `page.start`       |       `number`        | Índice do primeiro item na página atual, começando em `0` (e.x. se `pageSize: 25`, isso seria `0` na página 1, `25` na página 2, etc.). |
+| `page.end`         |       `number`        | Índice do último item na página atual.                                                                                               |
+| `page.size`        |       `number`        | Quantos itens há por página.                                                                                                          |
+| `page.total`       |       `number`        | O número total de itens em todas as páginas.                                                                                       |
+| `page.currentPage` |       `number`        | O número da página atual, começando por `1`.                                                                                       |
+| `page.lastPage`    |       `number`        | O número total de páginas.                                                                                                        |
+| `page.url.current` |       `string`        | URL da página atual (útil para URLs canônicas)                                                                       |
+| `page.url.prev`    | `string \| undefined` | URL da página anterior (será `undefined` se estiver na página 1).                                                              |
+| `page.url.next`    | `string \| undefined` | URL da próxima página (será `undefined` se não houverem mais páginas).                                                              |
+
+### `rss()`
+
+Feeds RSS são outro comum caso de uso que Astro suporta nativamente. Invoque a função `rss( )` para  gerar um feed `/rss.xml` em seu projeto utilizando os mesmos dados que você carregou para a página. A localização desse arquivo pode ser customizado (veja abaixo).
+
+```js
+// Exemplo: /src/pages/posts/[...page].astro
+// Coloque esta função dentro do script do seu componente Astro.
+export async function getStaticPaths({rss}) {
+  const todosPosts = Astro.glob('../post/*.md');
+  const postsOrdenados = todosPosts.sort((a, b) => Date.parse(b.date) - Date.parse(a.date));
+
+  // Gera um feed RSS a partir dessa coleção
+  rss({
+    // O título, descrição e metadados customizados do feed RSS.
+    title: 'Blog do Don',
+    description: 'Um blog de exemplo no Astro',
+    customData: `<language>pt-BR</language>`,
+    // A lista de itens do seu feed RSS, ordenados.
+    items: postsOrdenados.map(item => ({
+      title: item.frontmatter.titulo,
+      description: item.frontmatter.descricao,
+      link: item.url,
+      pubDate: item.frontmatter.dataPub,
+    })),
+    // Opcional: Customize aonde o arquivo será escrito.
+    // Por padrão, "/rss.xml"
+    dest: "/meu/customizado/feed.xml",
+  });
+
+  // Retorna uma coleção paginada dos caminhos de todos os posts
+  return [ ... ];
+}
+```
+
+```ts
+// A completa definição da tipagem do argumento da função rss():
+interface RSSArgument {
+  /** (obrigatório) Título do feed RSS */
+  title: string;
+  /** (obrigatório) Descrição do feed RSS */
+  description: string;
+  /** Especifica metadados arbitrários no início da tag <xml> */
+  xmlns?: Record<string, string>;
+  /** Especifica dados customizados no início do arquivo */
+  customData?: string;
+  /**
+   * Especifica aonde o arquivo RSS xml deve ser escrito.
+   * Relativo ao diretório final da build. Exemplo: '/foo/bar.xml'
+   * Por padrão, '/rss.xml'.
+   */
+  dest?: string;
+  /** Dados de retorno de cada item */
+  items: {
+    /** (obrigatório) Título do item */
+    title: string;
+    /** (obrigatório) Link para o item */
+    link: string;
+    /** Data de publicação do item */
+    pubDate?: Date;
+    /** Descrição do item */
+    description?: string;
+    /** Anexe outros dados XML a esse item */
+    customData?: string;
+  }[];
+}
+```
+
+## `import.meta`
+
+<p>
+
+Todos os módulos ESM incluem a propriedade `import.meta`. Astro adiciona <ImportMetaEnv /> através do [Vite](https://vitejs.dev/guide/env-and-mode.html).
+</p>
+
+**<ImportMetaEnv path=".SSR" />** pode ser utilizado para saber quando se está sendo renderizado no servidor. As vezes você pode querer uma lógica diferente, por exemplo, para um componente que deve ser apenas renderizado no cliente:
+
+```jsx
+import { h } from 'preact';
+
+export default function () {
+  return import.meta.env.SSR ? <div class="spinner"></div> : <ComponenteComplexo />;
+}
+```
+## Componentes Integrados
+
+Astro inclui vários componentes integrados para você utilizar em seus projetos. Todos os componentes integrados estão disponíveis em arquivos `.astro` via `import {} from 'astro/components';`.
+
+### `<Markdown />`
+
+> NOTA: O componente `<Markdown />` não funciona em SSR e pode ser removido antes da v1.0. Ele deve ser evitado se possível. Para usar Markdown em seus templates, utilize um arquivo `.md` separado e então [`import` Markdown](/pt-BR/guides/markdown-content/#importar-markdown) em seu template como um componente.
+
+```astro
+---
+import { Markdown } from 'astro/components';
+---
+<Markdown>
+  # Sintaxe do Markdown agora é suportada! **Yay!**
+</Markdown>
+```
+
+Veja nosso [Guia de Markdown](/pt-BR/guides/markdown-content/) para mais informações.
+
+### `<Code />`
+
+```astro
+---
+import { Code } from 'astro/components';
+---
+<!-- Adicione syntax highlight de algum código JavaScript. -->
+<Code code={`const foo = 'bar';`} lang="js" />
+<!-- Opcional: customize seu tema. -->
+<Code code={`const foo = 'bar';`} lang="js" theme="dark-plus" />
+<!-- Opcional: Habilite quebra de texto. -->
+<Code code={`const foo = 'bar';`} lang="js" wrap />
+```
+
+Este componente providencia syntax highlighting para blocos de código em tempo de build (sem JavaScript no lado do cliente). O componente é viabilizado internamente por Shiki e suporta todos os [temas](https://github.com/shikijs/shiki/blob/main/docs/themes.md) e [linguagens](https://github.com/shikijs/shiki/blob/main/docs/languages.md) populares. Além disso, você pode adicionar temas e linguagens customizadas as passando para `theme` e `lang` respectivamente.
+
+### `<Prism />`
+
+```astro
+---
+import { Prism } from '@astrojs/prism';
+---
+<Prism lang="js" code={`const foo = 'bar';`} />
+```
+
+> **`@astrojs/prism`** é integrado como parte do pacote `astro`. Não é necessário o instalar como uma dependência separada ainda! Porém, note que planejamos extrair `@astrojs/prism` para um pacote instalável separado no futuro.
+
+Este componente providencia syntax highlighting de linguagens específicas para blocos de código aplicando as classes CSS do Prism. Note que **você precisa providenciar uma folha de estilos CSS do Prism** (ou utilizar sua própria) para aparecer o syntax highlighting! Veja a [seção de configuração do Prism](/pt-BR/guides/markdown-content/#configuração-prism) para mais detalhes.
+
+Veja a [lista de linguagens suportadas pelo Prism](https://prismjs.com/#supported-languages) aonde você pode ver o alias correspondente de uma linguagem. E, você também pode mostrar seus blocos de código Astro com `lang="astro"`!
+
+### `<Debug />`
+
+```astro
+---
+import { Debug } from 'astro/components';
+const objetoDoServidor = {
+  a: 0,
+  b: "string",
+  c: {
+    aninhado: "object"
+  }
+}
+---
+<Debug {objetoDoServidor} />
+```
+
+Este componente providencia uma forma de inspecionar valores no lado do cliente, sem utilizar JavaScript.
+
+[canonical]: https://en.wikipedia.org/wiki/Canonical_link_element

From 56c3c775b6ebc01df9c104a0d2eb112d590fd9f1 Mon Sep 17 00:00:00 2001
From: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com>
Date: Sun, 29 May 2022 12:26:03 -0300
Subject: [PATCH 19/41] i18n(pt-BR): Add `cli-reference.md` translation (#681)

* Add pt-BR `cli-reference.md` page

* Apply suggestions

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>

* Add missing comma

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>
---
 src/i18n/pt-BR/nav.ts                      |   1 +
 src/pages/pt-BR/reference/cli-reference.md | 121 +++++++++++++++++++++
 2 files changed, 122 insertions(+)
 create mode 100644 src/pages/pt-BR/reference/cli-reference.md

diff --git a/src/i18n/pt-BR/nav.ts b/src/i18n/pt-BR/nav.ts
index 4e731a41dfe01..de4a9937ba72e 100644
--- a/src/i18n/pt-BR/nav.ts
+++ b/src/i18n/pt-BR/nav.ts
@@ -31,5 +31,6 @@ export default NavDictionary({
 	'reference/directives-reference': 'Diretivas de Template',
 	'reference/adapter-reference': 'API de Adaptadores',
 	'reference/integrations-reference': 'API de Integrações',
+	'reference/cli-reference': 'Interface de Linha de Comando',
 	'reference/api-reference': 'API de Runtime',
 });
diff --git a/src/pages/pt-BR/reference/cli-reference.md b/src/pages/pt-BR/reference/cli-reference.md
new file mode 100644
index 0000000000000..4c01abb7c6b8f
--- /dev/null
+++ b/src/pages/pt-BR/reference/cli-reference.md
@@ -0,0 +1,121 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Referência da Interface de Linha de Comando
+i18nReady: true
+---
+
+## Comandos
+
+### `astro dev`
+
+Executa o servidor de `dev` do Astro. Isso inicia um servidor HTTP que responde a requisições por rotas ou páginas que foram especificadas no diretório `src/pages` (a não ser que tenham sido sobrescritas pela sua opção `pages` definida na [configuração do projeto](/pt-BR/reference/configuration-reference/)).
+
+
+**Flags**
+
+#### `--port`
+
+Especifica em qual porta executar. Por padrão, `3000`.
+
+#### `--host [endereço opcional do host]`
+
+Define em que endereços de IP o servidor de desenvolvimento deve ser escutado em (e.x. IPs que não sejam localhost).
+- `--host` - escuta em todos os endereços, incluindo endereços LAN e públicos.
+- `--host [endereço-customizado]` - é exposto em um endereço de IP em `[endereço-customizado]`
+
+### `astro build`
+
+Faz a build do seu site para produção.
+
+### `astro preview`
+
+Inicia um servidor local de arquivos estáticos para servir o seu diretório `dist/` que foi construído. Útil para visualizar sua build estática localmente, antes de fazer seu deploy.
+
+Esse comando foi feito apenas para testes locais, e não foi projetado para ser executado em produção. Para ajuda com hospedagens para produção, veja o nosso guia em [Fazendo Deploy de um Website Astro](/pt-BR/guides/deploy/).
+
+
+### `astro check`
+
+Roda diagnósticos (como checar a tipagem de arquivos `.astro`) em seu projeto e reporta erros no console. Se algum error for encontrado durante o processo, ele será finalizado com o código **1**.
+
+Esse comando foi feito para ser usado em fluxos de trabalho de CI.
+
+> Note que esse comando apenas checa a tipagem em arquivos `.astro`.  
+> 📚 Leia mais sobre o [suporte para TypeScript no Astro](/pt-BR/guides/typescript/).
+
+### `astro add`
+
+Adiciona uma integração a sua configuração.
+
+### `astro docs`
+
+Abre o website de documentação do Astro diretamente do seu terminal.
+
+### `astro telemetry`
+
+Defnie a configuração de telemetria para o usuário atual. Telemetria são dados anônimos que provém informações sobre quais funcionalidades são mais utilizadas.
+
+Telemetria pode ser desabilitada com o esse comando de linha de comando:
+
+
+```shell
+astro telemetry disable
+```
+
+Telemetria pode ser posteriormente habilitada com:
+
+```shell
+astro telemetry enable
+```
+
+O comando `clear` reseta os dados de telemetria:
+
+```shell
+astro telemetry clear
+```
+
+> Gostaria de desabilitar telemetria em ambientes de CI? Se certifique de que você adicionou o comando `astro telemetry disable` em seus scripts de CI.
+
+## Flags Globais
+
+### `--config path`
+
+Especifica o caminho para seu arquivo de configuração. Por padrão, `astro.config.mjs`. Use isso se você utiliza um nome diferente para o seu arquivo de configuração ou você tem seu arquivo de configuração em outra pasta.
+
+```shell
+astro --config config/astro.config.mjs dev
+```
+
+### `--root path`
+
+Especifica o caminho para a raiz do projeto. Se não for especificado, o diretório de trabalho atual é assumido como a raiz.
+
+A raiz é utilizada para encontrar o arquivo de configuração Astro.
+
+```shell
+astro --root minhaPastaRaiz/minhaPastaDoProjeto dev
+```
+
+### `--reload`
+
+Limpa o cache (dependências são construídas em aplicações Astro).
+
+### `--verbose`
+
+Habilita logging verboso, que é útil para depurar um problema.
+
+### `--silent`
+
+Habilita logging silencioso, que é útil quando você não quer ver logs do Astro.
+
+### `--version`
+
+Mostra o número de versão do Astro.
+
+### `--drafts`
+
+Inclui páginas Markdown `draft` na build.
+
+### `--help`
+
+Mostra a mensagem de ajuda e sai.
\ No newline at end of file

From 3d1c4134e745212529f6368d9bccad4ed4a9ff75 Mon Sep 17 00:00:00 2001
From: victor0x16 <100092662+victor0x16@users.noreply.github.com>
Date: Mon, 30 May 2022 10:06:00 -0300
Subject: [PATCH 20/41] Fix error logging for ContributorList (#696)

---
 src/components/ContributorList.astro | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/components/ContributorList.astro b/src/components/ContributorList.astro
index 97387762ea135..464ce598fb583 100644
--- a/src/components/ContributorList.astro
+++ b/src/components/ContributorList.astro
@@ -9,7 +9,7 @@ const { githubRepo = 'withastro/docs' } = Astro.props as Props;
 const contributorsLink = `https://github.com/${githubRepo}/graphs/contributors`;
 
 const printError = (e) =>
-	console.warn(`[error]  /src/components/AvatarList.astro\n         ${e?.message ?? e}`);
+	console.warn(`[error]  /src/components/ContributorList.astro\n         ${e?.message ?? e}`);
 
 async function getContributors(repo, page = 1) {
 	try {

From 41f1915bbd080097567dfc207dcc37ba815c1428 Mon Sep 17 00:00:00 2001
From: Sarah Rainsberger <sarah@rainsberger.ca>
Date: Mon, 30 May 2022 10:24:58 -0300
Subject: [PATCH 21/41] update the config-reference generated header for i18n
 (#687)

---
 scripts/docgen.mjs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/scripts/docgen.mjs b/scripts/docgen.mjs
index 5319b504b57e2..1a8f95a3706b3 100644
--- a/scripts/docgen.mjs
+++ b/scripts/docgen.mjs
@@ -11,6 +11,7 @@ const HEADER = `---
 
 layout: ~/layouts/MainLayout.astro
 title: Configuration Reference
+i18nReady: true
 setup: |
   import Since from '../../../components/Since.astro';
 ---
@@ -90,4 +91,4 @@ export async function run() {
     fs.writeFileSync('src/pages/en/reference/configuration-reference.md', HEADER + result + FOOTER, 'utf8');
 }
 
-run();
\ No newline at end of file
+run();

From cdb9f201446846921c46027891a18edfff77b640 Mon Sep 17 00:00:00 2001
From: Kyosuke <kyosuke@users.noreply.github.com>
Date: Mon, 30 May 2022 22:32:39 +0900
Subject: [PATCH 22/41] i18n(ja): Add Japanese
 `core-concepts/astro-components.md` (#686)

* Create astro-components.md

* Update src/pages/ja/core-concepts/astro-components.md

Co-authored-by: yuto <43196286+yuto343@users.noreply.github.com>

* Update src/pages/ja/core-concepts/astro-components.md

Co-authored-by: yuto <43196286+yuto343@users.noreply.github.com>

* Update astro-components.md

Co-authored-by: yuto <43196286+yuto343@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 .../ja/core-concepts/astro-components.md      | 412 ++++++++++++++++++
 1 file changed, 412 insertions(+)
 create mode 100644 src/pages/ja/core-concepts/astro-components.md

diff --git a/src/pages/ja/core-concepts/astro-components.md b/src/pages/ja/core-concepts/astro-components.md
new file mode 100644
index 0000000000000..672d4058c12c9
--- /dev/null
+++ b/src/pages/ja/core-concepts/astro-components.md
@@ -0,0 +1,412 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Astroコンポーネント
+description: Astroコンポーネント構文の紹介です。
+i18nReady: true
+---
+
+**Astroコンポーネント**は、あらゆるAstroプロジェクトの基本的な構成要素です。クライアントサイドのランタイムを持たない、HTMLのみのテンプレートコンポーネントです。
+
+Astroコンポーネントの構文は、HTMLのスーパーセットです。この構文は、[HTMLやJSXを書いたことのある人なら誰でも親しみやすいように設計されています](/ja/comparing-astro-vs-other-tools/#astro-vs-jsx)。また、コンポーネントとJavaScript式を含むためのサポートも追加されています。Astroコンポーネントは、ファイル拡張子が`.astro`なので、すぐ見分けられます。
+
+Astroコンポーネントは非常に柔軟です。多くの場合、Astroコンポーネントは、ヘッダーやプロフィールカードのような、ページ上で**再利用可能なUI**を含むことになります。また、Astroコンポーネントには、SEO対策を容易にする一般的な`<meta>`タグのコレクションのような、小さなHTMLのスニペットが含まれることもあります。Astroコンポーネントは、ページ全体のレイアウトを含められます。
+
+Astroコンポーネントについて知っておくべき最も重要なことは、**ビルド中にHTMLに変換される**ことです。コンポーネントの内部でJavaScriptコードを実行しても、すべて事前に実行され、ユーザーに送られる最終ページからは取り除かれます。その結果、デフォルトでは、追加されるJavaScriptの痕跡のない、より高速なサイトが実現します。
+
+## コンポーネントの概要
+
+Astroコンポーネントは、**コンポーネントスクリプト**と**コンポーネントテンプレート**という2つの主要な部分で構成されています。それぞれのパーツは異なる仕事を行いますが、この2つを組み合わせることで、使いやすさと、どんなものにも対応できる表現力を兼ね備えたフレームワークを提供することを目指しています。
+
+
+```astro
+---
+// コンポーネントスクリプト (JavaScript)
+---
+<!-- コンポーネントテンプレート (HTML + JS Expressions) -->
+```
+
+コンポーネントを他のコンポーネントの内部で使用し、より高度なUIを構築できます。たとえば、`Button`コンポーネントを使用して、`ButtonGroup`コンポーネントを作成すると、次のようになります。
+
+```astro
+---
+// 例: ButtonGroup.astro
+import Button from './Button.astro';
+---
+<div>
+  <Button title="Button 1" />
+  <Button title="Button 2" />
+  <Button title="Button 3" />
+</div>
+```
+
+
+### コンポーネントスクリプト
+
+Astroでは、Astroコンポーネント内のコンポーネントスクリプトを識別するためにコードフェンス（`---`）を使用します。Markdownを書いたことがある方なら、すでに*front-matter*という同様の概念に馴染みがあるかもしれません。Astroのコンポーネントスクリプトの考え方は、この概念から直接着想を得ています。
+
+コンポーネントスクリプトを使用して、テンプレートをレンダリングするために必要なあらゆるJavaScriptコードを記述できます。
+
+- 他のAstroコンポーネントのインポート
+- 他のフレームワークコンポーネント（Reactなど）のインポート
+- データ（JSONファイルなど）のインポート
+- APIやデータベースからコンテンツを取得するコード
+- テンプレートで参照する変数の作成
+
+```astro
+---
+// メモ: importはファイルの先頭に記述する必要があります。
+import SomeAstroComponent from '../components/SomeAstroComponent.astro';
+import SomeReactComponent from '../components/SomeReactComponent.jsx';
+import someData from '../data/pokemon.json';
+
+// 渡されたコンポーネントのprops（`<X title="Hello, World" />`など）にアクセスする。
+const {title} = Astro.props;
+// 外部データを取得する（プライベートAPIやデータベースからでも可）
+const data = await fetch('SOME_SECRET_API_URL/users').then(r => r.json());
+---
+<!-- テンプレートはここに書きます -->
+```
+
+コードフェンスは、その中に書かれたJavaScriptが「守られる」ことを保証するために設計されています。フロントエンドのアプリケーションに漏れたり、ユーザーの手に渡ったりしません。高コストなコードや機密性の高いコード（プライベートなデータベースの呼び出しなど）が、ユーザーのブラウザに届くことを心配せずに、安全にコードを書けます。
+
+>💡 コンポーネントスクリプトの中には、TypeScriptも書けます。
+
+### コンポーネントテンプレート
+
+コンポーネントスクリプトの下には、コンポーネントテンプレートがあります。コンポーネントテンプレートは、コンポーネントの出力するHTMLを決定します。
+
+ここにプレーンなHTMLを書けば、そのコンポーネントはAstroのページでインポートされて使用される際にそのHTMLをレンダリングします。
+
+ただし、Astroのコンポーネントテンプレート構文は、**JavaScript式**、**インポートしたコンポーネント**、[**特別なAstroディレクティブ**](/ja/reference/directives-reference/)もサポートしています。コンポーネントスクリプトで（ページ構築時に）定義されたデータと値は、コンポーネントテンプレートで使用され、動的に作成されたHTMLを生成できます。
+
+```astro
+---
+// コンポーネントスクリプトはここに書きます
+import ReactPokemonComponent from '../components/ReactPokemonComponent.jsx';
+const myFavoritePokemon = [/* ... */];
+---
+<!-- HTMLコメントに対応しています -->
+
+<h1>Hello, world!</h1>
+
+<!-- propsやコンポーネントスクリプトの変数を使用します。 -->
+<p>好きなポケモンは: {Astro.props.title}</p>
+
+<!-- `client:`ディレクティブで他のコンポーネントをハイドレートに含める -->
+<ReactPokemonComponent client:visible />
+
+<!-- JSXと同じように、HTMLとJavaScriptの式を混ぜる -->
+<ul>
+  {myFavoritePokemon.map((data) => <li>{data.name}</li>)}
+<ul>
+
+<!-- テンプレートディレクティブを使って、エスケープされていないHTML文字列を要素に入れる -->
+<p set:html={rawHTMLString} />
+```
+
+### 動的なJSX式
+
+Astroコンポーネントは、front-matterのコンポーネントスクリプト内でローカル変数を定義できます。スクリプト変数はすべて、その下のコンポーネントのHTMLテンプレートで自動的に利用可能になります。
+
+#### 動的な値
+
+ローカル変数は、HTML出力として使用される値を渡すために中括弧で囲んで使用できます。
+
+```astro
+---
+const name = "Astro";
+---
+<div>
+  <h1>Hello {name}!</h1>
+</div>
+```
+
+#### 動的な属性
+
+ローカル変数は、HTML要素やコンポーネントに属性値を渡すために中括弧で囲んで使用できます。
+
+```astro
+---
+const name = "Astro";
+---
+<h1 class={name}>属性式がサポートされています</h1>
+
+<MyComponent templateLiteralNameAttribute={`MyNameIs${name}`} />
+```
+
+#### 動的なHTML
+
+ローカル変数は、JSXのような関数で使用でき、動的に生成されたHTML要素を生成できます。
+
+```astro
+---
+const items = ["犬", "猫", "カモノハシ"];
+---
+<ul>
+  {items.map((item) => (
+    <li>{item}</li>
+  ))}
+</ul>
+```
+
+#### フラグメントと複数要素
+
+Astroコンポーネントテンプレートは、複数の要素をレンダリングすることができ、すべてを1つの `<div>` または `<>` で囲む必要はありません。
+
+しかし、AstroのJSXのような式を使用して動的に要素を作成する場合、JavaScriptやJSXと同じように、これらの複数の要素を**フラグメント**で包む必要があります。Astroでは、`<Fragment> </Fragment>` または `<> </>` のどちらかを使用できます。
+
+```astro
+---
+const items = ["犬", "猫", "カモノハシ"];
+---
+<ul>
+  {items.map((item) => (
+    <>
+      <li>赤い{item}</li>
+      <li>青い{item}</li>
+      <li>緑の{item}</li>
+    </>
+  ))}
+</ul>
+```
+
+
+### コンポーネントのprops
+
+Astroコンポーネントは、propsを定義し、受け取れます。propsは、HTMLをレンダリングするためにコンポーネントテンプレートで利用できます。propsは、front-matterスクリプトのグローバルな `Astro.props` で利用できます。
+
+以下は、`greeting`と`name`のpropsを受け取るコンポーネントの例です。受け取るpropsは、グローバルな `Astro.props` オブジェクトから再構成されることに注意してください。
+
+
+```astro
+---
+// 例: GreetingHeadline.astro
+// 使い方: <GreetingHeadline greeting="Howdy" name="Partner" />
+const { greeting, name } = Astro.props
+---
+<h2>{greeting}, {name}!</h2>
+```
+
+`Props`型のインタフェースをエクスポートすることで、TypeScriptでpropsを定義できます。Astroはエクスポートされた`Props`インターフェースを自動的に検出し、プロジェクトに対して型の警告やエラーを出します。propsは、`Astro.props`から再構成する際に、デフォルト値を与えることもできます。
+
+```astro
+---
+// src/components/GreetingHeadline.astro
+export interface Props {
+  name: string;
+  greeting?: string;
+}
+
+const { greeting = "Hello", name } = Astro.props as Props;
+---
+<h2>{greeting}, {name}!</h2>
+```
+
+このコンポーネントをインポートして、他のAstroコンポーネント、レイアウト、ページでレンダリングする場合、属性としてこれらのpropsを渡せます。
+
+```astro
+---
+// src/components/GreetingCard.astro
+import GreetingHeadline from './GreetingHeadline.astro';
+const name = "Astro"
+---
+<h1>グリーティングカード</h1>
+<GreetingHeadline greeting="Hi" name={name} />
+<p>素敵な一日をお過ごしください！</p>
+```
+
+### スロット
+
+`<slot />` 要素は外部HTMLコンテンツのプレースホルダーで、他のファイルからコンポーネントテンプレートに子要素を注入（はめ込む＝スロット）できます。
+
+
+デフォルトでは、コンポーネントに渡されたすべての子要素は、その `<slot />` 内でレンダリングされます。
+
+> 💡 _props_（Astroコンポーネントに渡される属性で、`Astro.props()`でコンポーネント全体で使用することができます）とは異なり、_slot_は子要素が書かれた場所にレンダリングされます。
+
+
+```astro
+---
+// src/components/Wrapper.astro
+import Header from './Header.astro';
+import Logo from './Logo.astro';
+import Footer from './Footer.astro';
+
+const { title } = Astro.props
+---
+<div id="content-wrapper">
+  <Header />
+  <Logo />
+  <h1>{title}</h1>
+  <slot />  <!-- 子要素はここに入ります -->
+  <Footer />
+</div>
+```
+
+```astro
+---
+// src/pages/fred.astro
+import Wrapper from '../components/Wrapper.astro';
+---
+<Wrapper title="Fred's Page">
+  <h2>フレッドについて</h2>
+  <p>ここでは、フレッドについて紹介します。</p>
+</Wrapper>
+```
+
+このパターンはAstroレイアウトコンポーネントの基本です。HTMLコンテンツのページ全体を「`<Layout></Layout>`」タグで囲んでレイアウトコンポーネントに送り、共通のページ要素の中にレンダリングさせられます。
+
+
+#### 名前付きスロット
+
+Astroコンポーネントは、名前付きスロットも使えます。これを利用すると、対応するスロット名を持つHTML要素のみをスロットの場所に渡せます。
+
+
+```astro
+---
+// src/components/Wrapper.astro
+import Header from './Header.astro';
+import Logo from './Logo.astro';
+import Footer from './Footer.astro';
+
+const { title } = Astro.props
+---
+<div id="content-wrapper">
+  <Header />
+  <slot name="after-header"/>  <!--  `slot="after-header"` 属性を持つ子要素はここに入ります。 -->
+  <Logo />
+  <h1>{title}</h1>
+  <slot />  <!--  `slot`属性をもたない子要素、`slot="default"`属性を持つ子要素はここに入ります。 -->
+  <Footer />
+  <slot name="after-footer"/>  <!--  `slot="after-footer"` 属性を持つ子要素はここに入ります。 -->
+</div>
+```
+
+```astro
+---
+// src/pages/fred.astro
+import Wrapper from '../components/Wrapper.astro';
+---
+<Wrapper title="フレッドのページ">
+  <img src="https://my.photo/fred.jpg" slot="after-header">
+  <h2>フレッドについて</h2>
+  <p>ここでは、フレッドについて紹介します。</p>
+  <p slot="after-footer">Copyright 2022</p>
+</Wrapper>
+```
+
+子要素の `slot="my-slot"` 属性を使用して、コンポーネント内の `<slot name="my-slot" />` にマッチするプレースホルダに渡します。
+
+> ⚠️ これは、他のAstroコンポーネントにスロットを渡す場合のみ機能します。他の[UI framework components](/ja/core-concepts/framework-components/) をAstroファイルに含めることについてはこちらをご覧ください。
+
+
+#### スロットのフォールバックコンテンツ
+
+スロットは、**フォールバックコンテンツ**をレンダリングすることもできます。スロットに渡される子要素がない場合、 `<slot />` 要素はそれ自身のプレースホルダーの子要素をレンダリングします。
+
+```astro
+---
+// src/components/Wrapper.astro
+import Header from './Header.astro';
+import Logo from './Logo.astro';
+import Footer from './Footer.astro';
+
+const { title } = Astro.props
+---
+<div id="content-wrapper">
+  <Header />
+  <Logo />
+  <h1>{title}</h1>
+  <slot>
+    <p>これは、スロットに渡された子要素がない場合の代替コンテンツです。</p>
+  </slot>
+  <Footer />
+</div>
+```
+
+### CSSスタイル
+
+CSSの `<style>` タグも、コンポーネントテンプレートの内部でサポートされています。
+
+これらのタグはコンポーネントのスタイル設定に使えます。すべてのスタイルルールはそのコンポーネントに自動的にスコープが作られ、大規模なアプリでのCSSのコンフリクトを防げます。
+
+```astro
+---
+// コンポーネントスクリプトはここに書く
+---
+<style>
+  /* コンポーネントでスコープが作られ、ページ上の他のh1要素には影響しません */
+  h1 { color: red }
+</style>
+
+<h1>Hello, world!</h1>
+```
+
+> ⚠️ ここで定義されたスタイルは、そのコンポーネント自身のコンポーネントテンプレートに直接書かれたコンテンツにのみ適用されます。子コンポーネントやインポートされたコンポーネントは、デフォルトではスタイルが**適用されません**。
+
+📚 スタイルの適用に関する詳細は、[スタイリングガイド](/ja/guides/styling/)を参照してください。
+
+
+### クライアントサイドスクリプト
+
+[フレームワークコンポーネント](/ja/core-concepts/framework-components/) (React, Svelte, Vue, Preact, SolidJS, AlpineJS, Lit) や [Astroインテグレーション](https://astro.build/integrations/) (astro-XElement 等) を使わずにブラウザに JavaScript を送信するには、Astro コンポーネントのテンプレートで `<script>` タグを使ってグローバルスコープ内で実行される JavaScript をブラウザに送信して下さい。
+
+デフォルトでは、`<script>` タグはAstroによって処理されます。
+
+- インポートされたものはバンドルされ、ローカルファイルやNodeモジュールのインポートができます。
+- 処理されたスクリプトは、ページの `<head>` に [`type="module"`](https://developer.mozilla.org/ja/docs/Web/JavaScript/Guide/Modules) と共に挿入されます。
+- コンポーネントがページ内で何度も使用される場合、scriptタグは一度だけ含まれます。
+
+> ⚠️ 現在、クライアントサイドスクリプトとして直接TypeScriptを書くことはできません。しかし、TypeScriptを使いたければ、別ファイルとして分けたTypescriptファイルをインポートして読み込めます。
+
+```astro
+<script>
+  // 処理、バンドルされます。ESMのインポートは、npmパッケージに対しても機能します。
+</script>
+```
+
+スクリプトをバンドルしないようにするには、 `is:inline` 属性を使用します。
+
+```astro
+<script is:inline>
+  // 書かれたとおりにHTMLにレンダリングされます!
+  // ESM import はファイルからの相対パスで解決されません。
+</script>
+```
+
+上記の方法を組み合わせることで、同じ `.astro` ファイルに複数の `<script>` タグを使用することができます。
+
+> **注意:** `<script>` タグに `type="module"` やその他の属性を追加すると、Astro のデフォルトのバンドル動作が無効になり、 `is:inline` ディレクティブがあるかのようにタグが処理されます。
+
+📚 `<script>` タグで使用できるディレクティブの詳細については、[ディレクティブリファレンス](/ja/reference/directives-reference/#script--style-directives)を参照してください。
+
+
+#### 外部スクリプトの読み込み
+
+**使用するタイミング:** JavaScriptファイルが `public/` 内にある場合。
+
+この方法では、以下に説明する `import` メソッドを使用したときに、Astroが提供するJavaScriptの処理、バンドル、最適化をスキップすることに注意してください。
+
+```astro
+// 絶対URLパス
+<script is:inline src="/some-external-script.js"></script>
+```
+#### `src/`に配置されたスクリプトを使用する
+
+**使用するタイミング:** 外部スクリプトが `src/` 内にあり、かつ、ESMモジュールタイプをサポートしている場合。
+
+Astroは、これらのJavaScriptクライアントサイドインポートを検出し、自動的にJSをビルドし、最適化し、ページに追加します。
+
+```astro
+// ESM import
+<script>
+  import './some-external-script.js';
+</script>
+```
+
+
+## 次のステップ
+
+📚 [Astroの組み込みコンポーネント](/ja/reference/api-reference/#built-in-components)を学びます。
+
+📚 Astroプロジェクトでの[JavaScriptフレームワークコンポーネント](/ja/core-concepts/framework-components/)の使用方法について学びます。

From bf123f20eee018547103f947be7610b4d5d8873f Mon Sep 17 00:00:00 2001
From: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com>
Date: Mon, 30 May 2022 22:32:51 -0300
Subject: [PATCH 23/41] i18n(pt-BR) Add `migrate.md` translation (#688)

* Add pt-BR `migrate.md` translation

* Fix broken link

* Apply suggestions

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/i18n/pt-BR/nav.ts      |   1 +
 src/pages/pt-BR/migrate.md | 510 +++++++++++++++++++++++++++++++++++++
 2 files changed, 511 insertions(+)
 create mode 100644 src/pages/pt-BR/migrate.md

diff --git a/src/i18n/pt-BR/nav.ts b/src/i18n/pt-BR/nav.ts
index de4a9937ba72e..1ffd8570b859a 100644
--- a/src/i18n/pt-BR/nav.ts
+++ b/src/i18n/pt-BR/nav.ts
@@ -5,6 +5,7 @@ export default NavDictionary({
 	'getting-started': 'Introdução',
 	install: 'Instalação',
 	'editor-setup': 'Configuração do Editor',
+	migrate: 'Guia de Migração', 
 	'integrations/integrations': 'Feito com Astro',
 	coreConcepts: 'Principais Conceitos',
 	'core-concepts/partial-hydration': 'Hidratação Parcial',
diff --git a/src/pages/pt-BR/migrate.md b/src/pages/pt-BR/migrate.md
new file mode 100644
index 0000000000000..e1fec324605de
--- /dev/null
+++ b/src/pages/pt-BR/migrate.md
@@ -0,0 +1,510 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Guia de Migração
+description: Como migrar seu projeto para a versão mais recente do Astro.
+i18nReady: true
+---
+
+Este guia vai te ajudar a migrar de versões mais antigas do Astro para a mais atualizada e recente versão.
+
+Leia o guia abaixo para os maiores destaques e instruções em como lidar com mudanças radicais (em inglês, "breaking changes").
+
+
+## Beta do Astro 1.0
+
+Em 4 de Abril, 2022, nós lançamos a Beta do Astro 1.0! 🎉 
+
+**Nós não planejamos fazer mais mudanças radicais durante o período dessa beta até o lançamento oficial da v1.0.0 (planejado para 8 de Junho, 2022).**
+
+Se qualquer mudança radical precisar se feita, nós iremos a apontá-la nesta seção.
+
+## Migrando para a v1.0.0-beta.0
+
+O lançamento `v1.0.0-beta.0` do Astro não teve nenhuma mudança radical.
+
+Se você estiver vindo da v0.25 ou anterior, se certifique de que você leu e seguiu o [Guia de Migração da v0.26](#migrando-para-a-v026) abaixo, que conteve várias grandes mudanças radicais.
+
+## Migrando para a v0.26
+### Nova API de Configuração
+
+Nossa API de Configuração foi reprojetada para resolver alguns pontos evidentes de confusão que foram se acumulando desde o ano passado. A maior parte da configuração foi apenas movida ou renomeada, o que esperamos ser só uma rápida atualização para a maioria dos usuários. Algumas opções foram mais refatoradas e podem necessitar outras mudanças adicionais:
+
+- `.buildOptions.site` foi substituída por `.site` (o seu domínio de deploy) e a nova opção `.base` (o subcaminho do seu deploy).
+- `.markdownOptions` foi substituída por `.markdown`, um objeto de configuração similar com algumas pequenas mudanças para simplificar a configuração de Markdown.
+- `.sitemap` foi movida para a integração [@astrojs/sitemap](https://www.npmjs.com/package/@astrojs/sitemap).
+
+Se você executar Astro com uma configuração desatualizada, você irá ver um aviso com instruções em como atualizar. Veja nossa atualizada [Referência de Configuração](/pt-BR/reference/configuration-reference/) para mais informações em como atualizar.
+
+Leia [RFC0019](https://github.com/withastro/rfcs/blob/main/proposals/0019-config-finalization.md) para um maior contexto sobre estas mudanças.
+
+### Nova API de Markdown
+
+Astro v0.26 lançou uma completamente nova API de Markdown para o seu conteúdo. Isso inclui três principais mudanças para o usuário:
+- Agora você pode usar `import`/`import()` para conteúdo markdown utilizando uma importação ESM diretamente.
+- A nova API `Astro.glob()`, para importações glob mais fáceis (especialmente para Markdown).
+- **MUDANÇA RADICAL:** `Astro.fetchContent()` foi removido e substituído por `Astro.glob()`
+- **MUDANÇA RADICAL:** Objetos Markdown tem uma nova interface atualizada.
+
+```diff
+// v0.25
+- let todosPosts = Astro.fetchContent('./posts/*.md');
+// v0.26+
++ let todosPosts = await Astro.glob('./posts/*.md');
+```
+
+Quando migrar, tome cuidado com a nova interface do objeto Markdown. Frontmatter, por exemplo, foi movido para a propriedade `.frontmatter`, então referências como `post.titulo` devem ser modificadas para `post.frontmatter.title`.
+
+Isto deve resolver muitos dos problemas dos usuários de Markdown, incluindo algumas melhorias de performance para sites grandes.
+
+Leia [RFC0017](https://github.com/withastro/rfcs/blob/main/proposals/0017-markdown-content-redesign.md) para um maior contexto sobre estas mudanças.
+
+### Novo Comportamento Padrão de Script
+
+Tags `<script>` em componentes Astro agora passam por build, bundle e são otimizadas por padrão. Isso completa uma mudança de longo prazo para fazer a nossa sintaxe de componentes Astro mais consistente, correspondendo ao comportamento padrão otimizado que nossas tags `<style>` tem hoje.
+
+Isso inclui algumas mudanças para se estar atento sobre:
+
+- **RADICAL:** `<script hoist>` é o novo comportamento padrão de `<script>`. O atributo `hoist` foi removido. Para utilizar o novo comportamento padrão, se certifique de que não há outros atributos na tag `<script>`. Por exemplo, remova `type="module"` se você o estava utilizando antes.
+- Nova diretiva `<script is:inline>`, para reverter uma tag `<script>` ao comportamento padrão anterior (sem passar por build, bundle, sem ser modificada pelo Astro).
+- Nova diretiva `<style is:inline>`, para deixar uma tag style inline no template da página (similar ao comportamento anterior de `<script>`).
+- Nova diretiva `<style is:global>` para substituir `<style global>` em futuros lançamentos.
+
+
+```diff
+// v0.25
+- <script hoist type="module">
+// v0.26+
++ <script>
+```
+
+Veja como utilizar [scripts no lado do cliente](/pt-BR/core-concepts/astro-components/#scripts-no-lado-do-cliente) no Astro para mais detalhes.
+
+Leia [RFC0016](https://github.com/withastro/rfcs/blob/main/proposals/0016-style-script-defaults.md) para mais contexto sobre estas mudanças.
+
+### API `Astro.request` Atualizada
+
+`Astro.request` foi mudada de nosso objeto customizado para um objeto `Request` padrão. Isto é parte de nosso projeto para usar mais APIs padrões da web, especialmente aonde SSR é uma preocupação. 
+
+Isso inclui algumas mudanças para se estar atento sobre:
+
+- Muda `Astro.request` para se tornar um objeto [Request](https://developer.mozilla.org/pt-BR/docs/Web/API/Request).
+- Move `Astro.request.params` para `Astro.params`.
+- Move `Astro.request.canonicalURL` para `Astro.canonicalURL`.
+
+Leia [RFC0018](https://github.com/withastro/rfcs/blob/main/proposals/0018-astro-request.md) para mais contexto sobre essas mudanças.
+
+
+### Outras Mudanças
+
+- Melhora a API de `Astro.slots` para suportar a passagem de argumentos para slots baseados em funções. Isto permite componentes utilitários mais ergonômicos que aceitam uma função de callback como um filho.
+- Atualiza a formatação da interface de linha de comando, especialmente de relatório de erros.
+- Atualiza `@astrojs/compiler`, corrigindo alguns bugs relacionadas a utilização de RegExp no frontmatter.
+
+## Migrando para a v0.25
+
+### Integrações Astro
+
+A configuração `renderers` foi substituída por um novo e oficial, sistema de integrações! Isto permite algumas novas funcionalidades realmente animadoras para o Astro. Você pode ler nosso guia [Usando Integrações](/pt-BR/guides/integrations-guide/) para mais detalhes em como utilizar esse novo sistema.
+
+Integrações substituem nosso conceito original de `renderers`, vindo com algumas mudanças radicais e novos padrões para usuários existentes. Essas mudanças são abordadas abaixo.
+
+#### Removido: Suporte Integrado para Frameworks
+
+Anteriormente, React, Preact, Svelte e Vue eram todos inclusos no Astro por padrão. A partir da v0.25.0, Astro não virá mais com qualquer renderizador integrado. Se você não tinha uma entrada `renderers` já definida no seu projeto, você agora precisará instalar esses frameworks por si mesmo.
+
+Leia nosso [guia passo-a-passo](/pt-BR/guides/integrations-guide/) para aprender como adicionar uma nova integração Astro para o(s) framework(s) que você atualmente utiliza.
+
+#### Descontinuado: Renderers
+
+> *Leia esta seção se você já tiver "renderers" customizados definidos no seu arquivo de configuração.*
+
+O novo sistema de integrações substitui o antigo sistema de `renderers`, incluindo os pacotes `@astrojs/renderer-*` publicados no npm. De agora em diante, `@astrojs/renderer-react` se torna `@astrojs/react`, `@astrojs/renderer-vue` se torna `@astrojs/vue`, e por aí vai.
+
+
+**Para migrar:** atualize Astro para a `v0.25.0` e então execute `astro dev` ou `astro build` com o seu antigo arquivo de configuração contendo a desatualizada configuração `"renderers"`. Você irá imediatamente ver um aviso te dizendo as exatas modificações que você precisa fazer em seu arquivo `astro.config.mjs`, baseado na configuração atual. Você também pode atualizar seus pacotes por si mesmo, utilizando a tabela abaixo.
+
+Para um passo-a-passo mais detalhado, veja nosso [guia passo-a-passo](/pt-BR/guides/integrations-guide/) para aprender como substituir renderers existentes com uma nova integração de framework no Astro.
+
+```diff
+# Instale suas novas integrações e frameworks:
+# (Leia o passo-a-passo completo: https://docs.astro.build/pt-BR/guides/integrations-guide)
++ npm install @astrojs/lit lit
++ npm install @astrojs/react react react-dom
+```
+```diff
+# Então, atualize seu arquivo `astro.config.mjs`:
+# (Leia o passo-a-passo completo: https://docs.astro.build/pt-BR/guides/integrations-guide)
++ import lit from '@astrojs/lit';
++ import react from '@astrojs/react';
+
+export default {
+-   renderers: ['@astrojs/renderer-lit', '@astrojs/renderer-react'],
++   integrations: [lit(), react()],
+}
+```
+
+
+| Renderers descontinuados no npm | Integrações no npm para a v0.25+ |
+| --------------------------- | -------------------------- |
+| @astrojs/renderer-react     | @astrojs/react             |
+| @astrojs/renderer-preact    | @astrojs/preact            |
+| @astrojs/renderer-solid     | @astrojs/solid-js          |
+| @astrojs/renderer-vue       | @astrojs/vue               |
+| @astrojs/renderer-svelte    | @astrojs/svelte            |
+
+#### Lidando com Dependências de Pares
+
+> *Leia esta seção se: Você está no Node v14 **ou** se você utiliza algum gerenciador de pacotes que não seja o npm.*
+
+Diferente dos antigos renderers, integrações não mais marcam os próprios frameworks ("react", "svelte", "vue", etc.) como dependências diretas da integração. No lugar, você deve agora instalar os pacotes dos seus frameworks *assim como* suas integrações.
+
+```diff
+# Exemplo: Instale integrações e frameworks juntos
+- npm install @astrojs/react
++ npm install @astrojs/react react react-dom
+```
+
+Se você ver um aviso `"Cannot find package 'react'"` (ou similar) quando você inicia o Astro, isso significa que você precisa instalar tal pacote em seu projeto. Veja nossa [nota em dependências de pares](/pt-BR/guides/integrations-guide/#lidando-com-dependências-de-integrações) no guia de integrações para mais informações.
+
+Se você estiver utilizando `npm` e Node v16+, então isso pode ser feito automaticamente para você pelo `npm`, desde a última versão do `npm` (v7+) ele instala dependências de pares assim automaticamente para você. Nesse caso, instalar um framework como "react" em seu projeto é opcional mas ainda uma etapa recomendada.
+
+### Atualizado: Syntax Highlighting
+
+Nós amamos encontrar padrões sensíveis que "apenas funcionam". Por conta disso, nós decidimos fazer [Shiki](https://github.com/shikijs/shiki) nosso novo sistema de syntax highlight. Ele vem pré-configurado com o tema `github-dark`, providenciando highlighting para seus blocos de código com nenhuma configuração ou classes CSS, folhas de estilo ou JS no lado do cliente. 
+
+Verifique nossa nova [documentação de syntax highlighting](/pt-BR/guides/markdown-content/#syntax-highlighting) para mais detalhes. **Se você prefere manter Prism como seu syntax highlighter**, [defina a opção `syntaxHighlight` para `'prism'`](/pt-BR/guides/markdown-content/#configuração-prism) na configuração de Markdown do seu projeto.
+
+#### O componente `<Prism />` tem um novo lar
+
+Como parte de nossa missão de manter o núcleo do Astro o mais leve possível, nós movemos o componente integrado `Prism` de `astro/components` para o pacote `@astrojs/prism`. Agora você pode importar este componente de `@astrojs/prism` assim:
+
+
+```astro
+---
+import { Prism } from '@astrojs/prism';
+---
+```
+
+Já que o pacote `@astrojs/prism` ainda vem junto com o núcleo do `astro`, você não precisa instalar nada novo, nem adicionar Prism como uma integração! Porém, note que nós _planejamos_ extrair `@astrojs/prism` (e o syntax highlighting do Prism como um todo) para um pacote instalável e separado no futuro. veja a [referência da API do componente `<Prism />`](/pt-BR/reference/api-reference/#prism-) para saber mais.
+
+### Aprimoramento do Parser de CSS
+
+Nosso parser de CSS interno foi atualizado, e agora vem com melhor suporte para sintaxe CSS avançada, como container queries. Isto deve ser na maior parte uma mudança invisível para a maioria dos usuários, mas esperamos que usuário mais avançados irão aproveitar o suporte a novas funcionalidades do CSS.
+
+## Migrando para a v0.24
+
+> A nova estratégia de build é o padrão da v0.24. Se você tiver problemas, você pode continuar utilizando a antiga estratégia de build passando a flag `--legacy-build`. Por favor [abra uma issue](https://github.com/withastro/astro/issues/new/choose) para que possamos resolver problemas na nova estratégia de build.
+
+A v0.24 introduziu uma nova estratégia de *build estática* que modifica o comportamento de algumas funcionalidades. Em versões anteriores do Astro isso estava disponível como um comportamento que você poderia optar por utilizando a flag: `--experimental-static-build`.
+
+Para migrar dessa transição, esteja ciente das seguintes mudanças que vão ser necessárias para mover para o novo motor de build. Você pode fazer essas mudanças na sua base de código a qualquer momento para que você esteja a frente do previsto.
+
+### Descontinuado: `Astro.resolve()`
+
+`Astro.resolve()` permite que você consiga URLs resolvidas para assets que você gostaria de referenciar no navegador. Isto era mais comumente utilizado dentro das tags `<link>` e `<img>` para carregar arquivos CSS e imagens quando necessário. Infelizmente, isso não vai mais funcionar por conta do Astro agora fazer build de assets em *tempo de build* ao invés de fazer em *tempo de renderização*. Você vai querer atualizar suas referências a assets para uma das opções seguras para o futuro a partir de agora:
+
+#### Como Resolver Arquivos CSS
+
+**1. Importação ESM (Recomendado)**
+
+**Exemplo:** `import './estilo.css';`
+**Quando utilizar isto:** Se o seu arquivo CSS está dentro do diretório `src/`, e você quiser funcionalidades de build e otimização automática de CSS.
+
+Utilize uma importação ESM para adicionar algum CSS na página. Astro detecta essas importações de CSS e então faz build, otimiza e adicionar o CSS para a página automaticamente. Esta é a forma mais fácil de migrar de `Astro.resolve()` ao mesmo tempo que se mantém as etapas de build/bundle automáticas que o Astro providencia.
+
+```astro
+---
+// Exemplo: Astro irá incluir e otimizar este CSS para você automaticamente
+import './estilo.css';
+---
+<html><!-- Sua página aqui --></html>
+```
+
+Importar arquivos CSS devem funcionar em qualquer lugar em que importações ESM são suportadas, assim como em:
+- Arquivos JavaScript
+- Arquivos TypeScript
+- Frontmatter de componentes Astro
+- Componentes de frameworks como React, Svelte e outros
+
+Quando um arquivo CSS é importado utilizando este método, qualquer declaração de `@import` também é resolvida e colocada inline no arquivo CSS importado. Todas as referências de `url()` também são resolvidas relativas ao arquivo fonte, e quaisquer assets referenciados de `url()` serão incluidos na build final.
+
+
+**2. URL de Caminho Absoluto**
+
+**Exemplo:** `<link href="/estilo.css">`
+**Quando utilizar isto:** Se o seu arquivo CSS está dentro de `public/`, e você prefere criar o seu elemento HTML `link` por si mesmo.
+
+Você pode referenciar qualquer arquivo dentro do diretório `public/` usando um URL de caminho absoluto no template do seu componente. Esta é uma boa opção se você quiser controlar a tag `<link>` na página por si mesmo. Porém, essa abordagem pula o processamento de CSS, o bundle e otimizações que são providenciadas pelo Astro quando você utiliza o método com `import` descrito acima.
+
+Nós recomendados utilizar a abordagem com `import` no lugar da abordagem utilizando uma URL de caminho absoluto, já que providencia a melhor performance e funcionalidades do CSS por padrão.
+
+#### Como Resolver Arquivos JavaScript
+
+
+**1. URL de Caminho Absoluto**
+
+**Exemplo:** `<script src="/algum-script-externo.js" />`
+**Quando utilizar isto:** Se o seu arquivo JavaScript está dentro de `public/`.
+
+Você pode refenciar qualquer arquivo dentro do diretório `public/` com uma URL de caminho absoluto nos templates de seus componentes Astro. Esta é uma boa opção por padrão para scripts externos, já que isto te permite controlar a tag `<script>` na página por si mesmo.
+
+Note que esta abordagem pula o processamento, o bundle e otimizações de JavaScript que são providenciadas pelo Astro quando você utiliza o método com `import` descrito acima. Porém, isso pode ser preferível para quaisquer scripts externos que já foram publicados e minificados separadamente do Astro. Se o seu script foi baixado de uma fonte externa, então este método é provavelmente preferível.
+
+**2. Importação ESM via `<script hoist>`**
+
+**Exemplo:** `<script hoist>import './algum-script-externo.js';</script>`
+**Quando utilizar isto:** Se o seu script externo está dentro de `src/` e ele suporta o tipo de módulo ESM.
+
+Utilize uma importação ESM dentro de um elemento `<script hoist>` em seu template Astro, e então Astro irá incluir o arquivo JavaScript em sua build final. Astro detecta estas importações de JavaScript no lado do cliente e então faz build, otimiza e adicionar o JavaScript à página automaticamente. Esta é a forma mais fácil de migrar de `Astro.resolve()` enquanto se mantém as etapas de build/bundle automáticas que o Astro providencia.
+
+```astro
+<script hoist>
+  import './algum-script-externo.js';
+</script>
+```
+
+Note que o Astro irá fazer bundle deste script externo com o resto do seu JavaScript no lado do cliente, e irá carregá-lo no contexto de script `type="module"`. Alguns arquivos JavaScript mais antigos podem não ter sido escritos para o contexto `module`, nesse caso, eles podem precisar ser atualizados para utilizar este método.
+
+#### Como Resolver Imagens e Outros Assets
+
+**1. URL de Caminho Absoluto (Recomendado)**
+
+**Exemplo:** `<img src="/pinguin.png">`
+**Quando utilizar isto:** Se o seu asset está dentro de `public/`.
+
+Se você colocar suas imagens dentro de `public/` você pode então referenciá-las de forma segura por uma URL de caminho diretamente nos templates de seus componentes. Esta é a forma mais simples de referenciar um asset que você pode utilizar hoje, e é recomendado para a maioria dos usuários que estão começando com Astro.
+
+**2. Importação ESM**
+
+**Exemplo:** `import urlImg from './pinguin.png'`
+**Quando utilizar isto:** Se o seu asset está dentro do diretório `src/` e você quer funcionalidades de otimização automática como fazer hash de nomes de arquivos.
+
+Isto funciona dentro de qualquer componente JavaScript ou Astro, e retorna a URL resolvida para a imagem final. Assim que você tiver resolvido a URL, você pode utilizá-la em qualquer lugar dentro do template do componente.
+
+```astro
+---
+// Exemplo: Astro irá incluir esta imagem na sua build final
+import urlImg from './pinguin.png';
+---
+<img src={urlImg} />
+```
+
+Similar a forma com que Astro lida com CSS, a importação ESM permite ao Astro realizar algumas simples otimizações de build para você automaticamente. Por exemplo, qualquer asset dentro de `src/` que é importado utilizando uma importação ESM (ex: `import urlImg from '/pinguin.png'`) terá seu nome de arquivo em hash automaticamente. Isto te permite fazer um cache mais agressivo do arquivo no servidor, melhorando a performance do usuário. No futuro, Astro pode adicionar mais otimizações como esta. 
+
+**Dica:** Se você não gosta de importações ESM estáticas, Astro também suporta importações ESM dinâmicas. Nós apenas recomendados esta opção se você prefere esta sintaxe: `<img src={(await import('./pinguin.png')).default} />`.
+
+### Descontinuado: Processamento Padrão de `<script>`
+
+Anteriormente, todos os elementos `<script>` eram lidos a partir do HTML final resultante e eram processados + passsam por bundle automaticamente. Esse comportamento não é mais o padrão. A partir da v0.24, você deve optar pelo processamento do elemento `<script>` através do atributo `hoist`. O `type="module"` também é necessário para módulos hoisted. 
+
+```astro
+<script>
+  // Será renderizado no HTML exatamente como escrito!
+  // Importações ESM não serão resolvidas de forma relativa ao arquivo.
+</script>
+<script type="module" hoist>
+  // Processado! Passou por bundle! Importações ESM funcionam, até mesmo em pacotes do npm.
+</script>
+```
+
+
+## Migrando para a v0.23
+
+### Erro Sass Não Encontrado
+
+```
+Preprocessor dependency "sass" not found. Did you install it?
+```
+
+Em nossa missão para reduzir o tamanho de npm install, nós movemos o [Sass](https://sass-lang.com/) como uma dependência opcional. Se você utiliza Sass em seu projeto, você vai querer se certificar de que executou `npm install sass --save-dev` para salvá-lo como uma dependência.
+
+### Descontinuado: HTML não Sanitizado
+
+No Astro v0.23+, conteúdo HTML não sanitizado em expressões não é mais possível.
+Em lançamentos futuros, conteúdo em expressões terão strings sanitizadas para protegê-lo de injeção HTML não-intencional.
+
+```diff
+- <h1>{titulo}</h1> <!-- <h1>Olá <strong>Mundo</strong></h1> -->
++ <h1>{titulo}</h1> <!-- <h1>Olá &lt;strong&gt;Mundo&lt;/strong&gt;</h1> -->
+```
+
+Para continuar injetando HTML não-sanitizado, agora você pode utilizar `set:html`.
+
+```diff
+- <h1>{titulo}</h1>
++ <h1 set:html={titulo} />
+```
+
+Para evitar o uso de um elemento de invólucro, `set:html` pode ser utilizado com `<Fragment>`.
+
+```diff
+- <h1>{titulo}!</h1>
++ <h1><Fragment set:html={titulo}>!</h1>
+```
+
+Você também pode ser proteger de injeção não-intencional de HTML com `set:text`.
+
+```astro
+<h1 set:text={titulo} /> <!-- <h1>Olá &lt;strong&gt;Mundo&lt;/strong&gt;</h1> -->
+```
+
+## Migrando para a v0.21
+
+### Vite
+
+A partir da v0.21, Astro é construído com [Vite].
+Por consequência, configurações escritas em `snowpack.config.mjs` devem ser movidas para `astro.config.mjs`.
+
+
+```js
+// @ts-check
+
+/** @type {import('astro').AstroUserConfig} */
+export default {
+  renderers: [],
+  vite: {
+    plugins: [],
+  },
+};
+```
+
+Para aprender mais sobre como configurar o Vite, por favor visite seu [guia de configuração](https://vitejs.dev/config/).
+
+#### Plugins Vite
+
+Em Astro v0.21+, plugins Vite podem ser configurados em `astro.config.mjs`.
+
+```js
+import { imagetools } from 'vite-imagetools';
+
+export default {
+  vite: {
+    plugins: [imagetools()],
+  },
+};
+```
+
+Para aprender mais sobre plugins Vite, por favor visite seu [guia de plugins](https://vitejs.dev/guide/using-plugins.html).
+
+#### Mudanças do Vite para Renderers
+
+Em Astro v0.21+, plugins agora devem utilizar `viteConfig()`.
+
+```diff
+// renderer-svelte/index.js
++ import { svelte } from '@sveltejs/vite-plugin-svelte';
+
+export default {
+  name: '@astrojs/renderer-svelte',
+  client: './client.js',
+  server: './server.js',
+-  snowpackPlugin: '@snowpack/plugin-svelte',
+-  snowpackPluginOptions: { compilerOptions: { hydratable: true } },
++  viteConfig() {
++    return {
++      optimizeDeps: {
++        include: ['@astrojs/renderer-svelte/client.js', 'svelte', 'svelte/internal'],
++        exclude: ['@astrojs/renderer-svelte/server.js'],
++      },
++      plugins: [
++        svelte({
++          emitCss: true,
++          compilerOptions: { hydratable: true },
++        }),
++      ],
++    };
++  },
+}
+```
+
+Para aprender mais sobre plugins Vite, por favor visite seu [guia de plugins](https://vitejs.dev/guide/using-plugins.html).
+
+> Em lançamentos anteriores, esses plugins eram configurados com `snowpackPlugin` ou `snowpackPluginOptions`.
+
+### Atalhos
+
+Em Astro v0.21+, atalhos de importação podem ser adicionados em `tsconfig.json` ou `jsconfig.json`.
+
+```json
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/components/*": ["src/components/*"]
+    }
+  }
+}
+```
+
+_Estes aliases são automaticamente integrados no [VSCode](https://code.visualstudio.com/docs/languages/jsconfig) e em outros editores._
+
+### Extensões de Arquivos em Importações
+
+Em Astro v0.21+, arquivos precisam ser referenciados com suas extensões, exatamente como estão no disco. Neste exemplo, `Div.tsx` precisaria ser referenciado como `Div.tsx`, não `Div.jsx`.
+
+```diff
+- import Div from './Div.jsx' // Astro v0.20
++ import Div from './Div.tsx' // Astro v0.21
+```
+
+Esta mesma mudança se aplica para arquivos que são compilados para CSS como `Div.scss`:
+
+```diff
+- <link rel="stylesheet" href={Astro.resolve('./Div.css')}>
++ <link rel="stylesheet" href={Astro.resolve('./Div.scss')}>
+```
+
+### Removido: Componentes no Frontmatter
+
+Anteriormente, você poderia criar mini componentes Astro dentro do Frontmatter Astro, utilizando sintaxe JSX ao invés da sintaxe de componentes Astro. Isto sempre foi um tipo de hack, mas no novo compilador isto se tornou impossível de dar suporte. Nós esperamos reintroduzir esta funcionalidade em um lançamento futuro do Astro utilizando uma API diferente e independente do JSX. 
+
+Para migrar para a v0.21+, por favor converta todos os componentes Astro JSX (qualquer componente Astro criado dentro do frontmatter de outro componente) como seus próprios componentes isolados.
+
+
+### Mudanças na Estilização
+
+#### Autoprefixer
+
+Autoprefixer não é mais executado por padrão. Para habilitá-lo:
+
+1. Instale a versão mais recente (`npm i autoprefixer`)
+2. Crie um arquivo `postcss.config.cjs` na raiz do seu projeto com:
+   ```js
+   module.exports = {
+     plugins: {
+       autoprefixer: {},
+     },
+   };
+   ```
+
+#### Tailwind CSS
+
+Certifique-se de que você tem PostCSS instalado. Isto era opcional em versões anteriores, mas é obrigatório agora:
+
+1. Instale a versão mais recente do postcss (`npm i -D postcss`)
+2. Crie um arquivo `postcss.config.cjs` na raiz do seu projeto com:
+   ```js
+   module.exports = {
+     plugins: {
+       tailwindcss: {},
+     },
+   };
+   ```
+  Para mais informações, leia a [documentação do Tailwind CSS](https://tailwindcss.com/docs/installation#add-tailwind-as-a-post-css-plugin).
+
+
+### Problemas Conhecidos
+
+#### Importações no Topo
+
+No Astro v0.21+, um bug que foi introduzido faz com que seja obrigatório importações dentro de seus componentes estarem no topo do seu frontmatter.
+
+```astro
+---
+import Componente from '../components/Componente.astro'
+const aondeColocarMInhasImportacoes = "no topo!"
+---
+```
+
+
+[vite]: https://vitejs.dev

From c5fc59300789bc6214eac9b172f5949abaca5b5f Mon Sep 17 00:00:00 2001
From: Tony Sullivan <tony.f.sullivan@outlook.com>
Date: Tue, 31 May 2022 15:02:10 +0000
Subject: [PATCH 24/41] Updating PNPM engine version to 7.0 to match astro core
 (#701)

* updating PNPM engine version to 7.0 to match astro core

* didn't mean to include an Astro version bump for this PR

* matching previous version pattern
---
 package.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/package.json b/package.json
index e6c868a0f8286..9dd635478950d 100644
--- a/package.json
+++ b/package.json
@@ -52,7 +52,7 @@
   },
   "engines": {
     "node": "^14.15.0 || >=16.0.0",
-    "pnpm": ">=6.32.3"
+    "pnpm": ">=7.0.0"
   },
-  "packageManager": "pnpm@6.32.3"
+  "packageManager": "pnpm@7.0.0"
 }

From 868955a363d0495890652463a74410725633d51f Mon Sep 17 00:00:00 2001
From: Kyosuke <kyosuke@users.noreply.github.com>
Date: Wed, 1 Jun 2022 16:57:38 +0900
Subject: [PATCH 25/41] Create astro-pages.md (#698)

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
---
 src/pages/ja/core-concepts/astro-pages.md | 131 ++++++++++++++++++++++
 1 file changed, 131 insertions(+)
 create mode 100644 src/pages/ja/core-concepts/astro-pages.md

diff --git a/src/pages/ja/core-concepts/astro-pages.md b/src/pages/ja/core-concepts/astro-pages.md
new file mode 100644
index 0000000000000..39d322c704f0e
--- /dev/null
+++ b/src/pages/ja/core-concepts/astro-pages.md
@@ -0,0 +1,131 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: ページ
+description: Astroページの紹介
+i18nReady: true
+---
+
+**ページ**は、`src/pages/`サブディレクトリにある[Astroコンポーネント](/ja/core-concepts/astro-components/)の特殊なタイプです。Webサイトの各HTMLページのルーティング、データロード、全体的なページレイアウトを処理する役割を担っています。
+
+### ファイルベースルーティング
+
+Astroは、**ファイルベースルーティング**と呼ばれるルーティング手法を採用しています。 `src/pages`ディレクトリ内のすべての`.astro`ファイルは、そのファイルパスに基づいてサイトのページ、またはエンドポイントになります。
+
+📚 [Astroのルーティング](/ja/core-concepts/routing/)について詳しくみる。
+
+### ページのHTML
+
+Astroページは、`<head>` と `<body>` を含む完全な `<html>...</html>` ページレスポンスを返す必要があります。（`<!doctype html>` はオプションで、書かなくても自動的に追加されます）。
+
+```astro
+---
+// 例: src/pages/index.astro
+---
+<html>
+  <head>
+    <title>ホームページ</title>
+  </head>
+  <body>
+    <h1>私のホームページへようこそ！</h1>
+  </body>
+</html>
+```
+
+### ページレイアウトの活用
+
+すべてのページで同じHTML要素を繰り返すことを避けるために、共通の `<head>` と `<body>` 要素を独自の[レイアウトコンポーネント](/ja/core-concepts/layouts/)に移動できます。レイアウトコンポーネントはいくつでも使えます。
+
+```astro
+---
+// 例: src/pages/index.astro
+import MySiteLayout from '../layouts/MySiteLayout.astro';
+---
+<MySiteLayout>
+  <p>レイアウトに包まれたコンテンツ！</p>
+</MySiteLayout>
+```
+
+📚 Astroの[レイアウトコンポーネント](/ja/core-concepts/layouts/)について詳しくみる。
+
+
+## Markdownページ
+
+Astroは `/src/pages/` にあるMarkdown (`.md`) ファイルも、最終的なWebサイトのページとして扱います。これらは一般的に、ブログの投稿やドキュメントのような、テキストを多用するページに使用されます。
+
+ページレイアウトは[Markdownファイル](#markdownページ)に対して特に有効です。Markdownファイルは特別な `layout`というfront-matterプロパティを使用して、Markdownコンテンツを `<html>...</html>` ページドキュメントにラップする [レイアウトコンポーネント](/ja/core-concepts/layouts/)を指定できます。
+
+
+```md
+---
+# 例: src/pages/page.md
+layout: '../layouts/MySiteLayout.astro'
+title: 'Markdownページ'
+---
+# タイトル
+
+これは**Markdown**で書かれたページです。
+```
+
+📚 Astroの[Markdown](/ja/guides/markdown-content/)について詳しくみる。
+
+
+## HTMLではないページ
+
+`.json`や`.xml`などのHTMLではないページや、画像などのアセットも、一般的に**ファイルルート**と呼ばれるAPIルートで構築できます。
+
+**ファイルルート**は、拡張子が `.js` または `.ts` であるスクリプトファイルで、`src/pages/` ディレクトリに配置されたものです。
+
+ビルドされるファイル名と拡張子はソースファイルの名前に基づいています。たとえば、`src/pages/data.json.ts` は、最終的に `/data.json` のパスとマッチするようにビルドされます。
+
+SSR（サーバーサイドレンダリング）では、拡張子は関係ないので省略できます。これは、ビルド時にファイルが生成されないためです。その代わり、Astroは1つのサーバーファイルを生成します。
+
+```js
+// 例: src/pages/builtwith.json.ts
+// 出力先: /builtwith.json
+
+// ファイルルートはget()関数をエクスポートし、それがファイルを生成するために呼び出されます。
+// 最終的なビルドでファイルの内容を保存するために、`body` を持つオブジェクトを返します。
+export async function get() {
+  return {
+    body: JSON.stringify({
+      name: 'Astro',
+      url: 'https://astro.build/',
+    }),
+  };
+}
+```
+
+APIルートは、[params](/ja/reference/api-reference/#params)と[Request](https://developer.mozilla.org/ja/docs/Web/API/Request) を含む `APIContext` オブジェクトを受け取ります。
+
+
+```ts
+import type { APIContext } from 'astro';
+
+export async function get({ params, request }: APIContext) {
+  return {
+    body: JSON.stringify({
+      path: new URL(request.url).pathname
+    })
+  };
+}
+```
+
+オプションで、APIルートの関数を `APIRoute` 型にもできます。これにより、APIルートが間違った型を返した場合に、より適切なエラーメッセージを表示できます。
+
+```ts
+import type { APIRoute } from 'astro';
+
+export const get: APIRoute = ({ params, request }) => {
+  return {
+    body: JSON.stringify({
+      path: new URL(request.url).pathname
+    })
+  };
+};
+```
+
+## カスタム404エラーページ
+
+カスタムの404エラーページを作成するには、`src/pages`に `404.astro` または `404.md` ファイルを作成します。
+
+これは `404.html` ページにビルドされます。ほとんどの[デプロイサービス](/ja/guides/deploy/)はこのファイルを見つけて使用します。

From e77a78688096b38a06012f78db66afe07123d6a2 Mon Sep 17 00:00:00 2001
From: Maurer Krisztian <48491140+MaurerKrisztian@users.noreply.github.com>
Date: Wed, 1 Jun 2022 19:13:03 +0200
Subject: [PATCH 26/41] i18n(pages-hu): Fix typo (#706)

---
 src/pages/hu/getting-started.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/pages/hu/getting-started.md b/src/pages/hu/getting-started.md
index 9250af9b436de..9d4310188d345 100644
--- a/src/pages/hu/getting-started.md
+++ b/src/pages/hu/getting-started.md
@@ -73,7 +73,7 @@ Nem minden verizó kiadás érdemel meg egy külön posztot, de minden verzióho
 
 ## Valami hiányzik?
 
-Ha valami hiányzik a dokumentációból, vagy valami féélreérthető, kérjük [készíts egy bejelentést hozzá](https://github.com/withastro/astro/issues/new/choose) a javaslataiddal, vagy tweetelj az [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter fiókunknak. Örömmel hallanánk mit gondolsz!
+Ha valami hiányzik a dokumentációból, vagy valami félreérthető, kérjük [készíts egy bejelentést hozzá](https://github.com/withastro/astro/issues/new/choose) a javaslataiddal, vagy tweetelj az [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter fiókunknak. Örömmel hallanánk mit gondolsz!
 
 ## Elismerés
 

From 46d79ebb7a05088d6ebff9dbb3507046f402a147 Mon Sep 17 00:00:00 2001
From: George B <705427+georgeblahblah@users.noreply.github.com>
Date: Wed, 1 Jun 2022 18:30:06 +0100
Subject: [PATCH 27/41] typo: Remove duplicate "should" text (#703)

---
 src/pages/en/guides/markdown-content.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/pages/en/guides/markdown-content.md b/src/pages/en/guides/markdown-content.md
index bd799dd122a79..f0977975133a2 100644
--- a/src/pages/en/guides/markdown-content.md
+++ b/src/pages/en/guides/markdown-content.md
@@ -288,7 +288,7 @@ const posts = await Astro.glob<Frontmatter>('../pages/post/*.md');
 
 ## Markdown Component
 
-> NOTE: The `<Markdown />` component does not work in SSR and may be removed before v1.0. It should should be avoided if possible. To use Markdown in your templates, use a separate `.md` file and then [`import` Markdown](/en/guides/markdown-content/#importing-markdown) into your template as a component.
+> NOTE: The `<Markdown />` component does not work in SSR and may be removed before v1.0. It should be avoided if possible. To use Markdown in your templates, use a separate `.md` file and then [`import` Markdown](/en/guides/markdown-content/#importing-markdown) into your template as a component.
 
 You can import the [built-in Astro Markdown component](/en/reference/api-reference/#markdown-) in your component script and then write any Markdown you want between `<Markdown></Markdown>` tags.
 
@@ -325,7 +325,7 @@ const expressions = 'Lorem ipsum';
 
 ### Remote Markdown
 
-> NOTE: The `<Markdown />` component does not work in SSR and may be removed before v1.0. It should should be avoided if possible. To use Markdown in your templates, use a separate `.md` file and then `import` it into your template as a component. Read this [RFC Discussion](https://github.com/withastro/rfcs/discussions/179) to learn more.
+> NOTE: The `<Markdown />` component does not work in SSR and may be removed before v1.0. It should be avoided if possible. To use Markdown in your templates, use a separate `.md` file and then `import` it into your template as a component. Read this [RFC Discussion](https://github.com/withastro/rfcs/discussions/179) to learn more.
 
 If you have Markdown in a remote source, you may pass it directly to the Markdown component through the `content` attribute.
 
@@ -342,7 +342,7 @@ const content = await fetch('https://raw.githubusercontent.com/withastro/docs/ma
 
 ### Nested Markdown
 
-> NOTE: The `<Markdown />` component does not work in SSR and may be removed before v1.0. It should should be avoided if possible. To use Markdown in your templates, use a separate `.md` file and then `import` it into your template as a component. Read this [RFC Discussion](https://github.com/withastro/rfcs/discussions/179) to learn more.
+> NOTE: The `<Markdown />` component does not work in SSR and may be removed before v1.0. It should be avoided if possible. To use Markdown in your templates, use a separate `.md` file and then `import` it into your template as a component. Read this [RFC Discussion](https://github.com/withastro/rfcs/discussions/179) to learn more.
 
 `<Markdown />` components can be nested.
 

From 713169b7f0d9952ab769ab03029e7fa55abca538 Mon Sep 17 00:00:00 2001
From: Sarah Rainsberger <sarah@rainsberger.ca>
Date: Wed, 1 Jun 2022 14:52:32 -0300
Subject: [PATCH 28/41] Text improvements to Partial Hydration (#699)

* Text improvements to Partial Hydration

Some wording updates based docs feedback on Ben's live stream.

* stop falsely claiming we can use ANY frontend UI component in the whole world

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
---
 src/pages/en/core-concepts/partial-hydration.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/pages/en/core-concepts/partial-hydration.md b/src/pages/en/core-concepts/partial-hydration.md
index e603e656a8265..0edbc0cd350d0 100644
--- a/src/pages/en/core-concepts/partial-hydration.md
+++ b/src/pages/en/core-concepts/partial-hydration.md
@@ -7,7 +7,7 @@ setup: |
 i18nReady: true
 ---
 
-**Astro generates every website with zero client-side JavaScript, by default.** Use any frontend UI component that you'd like ([React](https://reactjs.org/), [Preact](https://preactjs.com/), [Svelte](https://svelte.dev/), [Vue](https://vuejs.org/), [SolidJS](https://www.solidjs.com/), [AlpineJS](https://alpinejs.dev/) and [Lit](https://lit.dev/)) and Astro will automatically render it to HTML at build-time and strip away all JavaScript. This keeps every site fast by default.
+**Astro generates every website with zero client-side JavaScript, by default.** Use a frontend UI component built with [React](https://reactjs.org/), [Preact](https://preactjs.com/), [Svelte](https://svelte.dev/), [Vue](https://vuejs.org/), [SolidJS](https://www.solidjs.com/), [AlpineJS](https://alpinejs.dev/) or [Lit](https://lit.dev/) and Astro will automatically render it to HTML at build-time and strip away all JavaScript. This keeps every site fast by default.
 
 ```astro
 ---
@@ -18,7 +18,7 @@ import MyReactComponent from '../components/MyReactComponent.jsx';
 <MyReactComponent />
 ```
 
-But sometimes, client-side JavaScript is required for creating interactive UI. When you find yourself needing interactive UI on the page, Astro doesn't force you to go 100% JavaScript on the entire page. Instead, Astro uses a technique called **partial hydration** that lets you hydrate individual components on the page. This way, you only send down the absolutely essential JavaScript that you need to run your page. 
+But sometimes, client-side JavaScript is required for creating interactive UIs. When you find yourself needing interactive UI on the page, Astro doesn't force you to go 100% JavaScript on the entire page. Instead, Astro uses a technique called **partial hydration** that lets you hydrate individual components on the page. This way, you only send down the absolutely essential JavaScript that you need to run your page. 
 
 ```astro
 ---

From 7198014ade2c085cfee97df2e4a7458e29c228a1 Mon Sep 17 00:00:00 2001
From: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com>
Date: Wed, 1 Jun 2022 16:12:02 -0300
Subject: [PATCH 29/41] i18n(pt-BR): Update `partial-hydration.md` based on
 #699 changes (#707)

* Update PT-BR `partial-hydration.md` based on #699 changes

* Remove extra parenthesis

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>

* Change from plural to singular

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
---
 src/pages/pt-BR/core-concepts/partial-hydration.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/pages/pt-BR/core-concepts/partial-hydration.md b/src/pages/pt-BR/core-concepts/partial-hydration.md
index f0aa54d615b2d..c5921b76e5895 100644
--- a/src/pages/pt-BR/core-concepts/partial-hydration.md
+++ b/src/pages/pt-BR/core-concepts/partial-hydration.md
@@ -7,7 +7,7 @@ setup: |
 i18nReady: true
 ---
 
-**Astro gera todo website com zero JavaScript no lado do cliente, por padrão.** Use qualquer componente de UI frontend que você queira ([React](https://reactjs.org/), [Preact](https://preactjs.com/), [Svelte](https://svelte.dev/), [Vue](https://vuejs.org/), [SolidJS](https://www.solidjs.com/), [AlpineJS](https://alpinejs.dev/) e [Lit](https://lit.dev/)) e o Astro irá automaticamente renderizá-lo como HTML em tempo de build e remover todo o JavaScript. Isso faz todos os sites rápidos por padrão.
+**Astro gera todo website com zero JavaScript no lado do cliente, por padrão.** Utilize um componente de UI frontend feito com [React](https://reactjs.org/), [Preact](https://preactjs.com/), [Svelte](https://svelte.dev/), [Vue](https://vuejs.org/), [SolidJS](https://www.solidjs.com/), [AlpineJS](https://alpinejs.dev/) ou [Lit](https://lit.dev/) e Astro irá automaticamente renderizá-lo como HTML em tempo de build e remover todo o JavaScript. Isso faz todos os sites rápidos por padrão.
 
 
 ```astro
@@ -19,7 +19,7 @@ import MeuComponenteReact from '../components/MeuComponenteReact.jsx';
 <MeuComponenteReact />
 ```
 
-Porém as vezes, JavaScript no lado do cliente é necessário para criar interfaces de usuário interativas. Quando você se ver precisando de UI interativa na página, Astro não te força a utilizar JavaScript em 100% da página. Em vez disso, Astro utiliza uma técnica chamada **hidratação parcial** (do inglês, "Partial Hydration") que te deixa hidratar componentes individualmente na página. Dessa forma, você envia apenas o JavaScript absolutamente necessário que você precisa para carregar a página.
+Porém as vezes, JavaScript no lado do cliente é necessário para criar UIs interativas. Quando você se ver precisando de UI interativa na página, Astro não te força a utilizar JavaScript em 100% da página. Em vez disso, Astro utiliza uma técnica chamada **hidratação parcial** (do inglês, "Partial Hydration") que te deixa hidratar componentes individualmente na página. Dessa forma, você envia apenas o JavaScript absolutamente necessário que você precisa para carregar a página.
 
 
 ```astro

From 8becea48ecec51eba7d52cfce83b3a83819338d5 Mon Sep 17 00:00:00 2001
From: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com>
Date: Wed, 1 Jun 2022 21:39:22 -0300
Subject: [PATCH 30/41] i18n(pt-BR): Add `comparing-astro-vs-other-tools.md`
 translation (#690)

* Add PT-BR `comparing-astro-vs-other-tools.md`

* Apply suggestions

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>

* Apply more suggestions

* Apply even more suggestions

Co-authored-by: victor0x16 <100092662+victor0x16@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/i18n/pt-BR/nav.ts                         |   1 +
 .../pt-BR/comparing-astro-vs-other-tools.md   | 298 ++++++++++++++++++
 2 files changed, 299 insertions(+)
 create mode 100644 src/pages/pt-BR/comparing-astro-vs-other-tools.md

diff --git a/src/i18n/pt-BR/nav.ts b/src/i18n/pt-BR/nav.ts
index 1ffd8570b859a..8dc46719c4188 100644
--- a/src/i18n/pt-BR/nav.ts
+++ b/src/i18n/pt-BR/nav.ts
@@ -5,6 +5,7 @@ export default NavDictionary({
 	'getting-started': 'Introdução',
 	install: 'Instalação',
 	'editor-setup': 'Configuração do Editor',
+  'comparing-astro-vs-other-tools': 'Astro vs. X',
 	migrate: 'Guia de Migração', 
 	'integrations/integrations': 'Feito com Astro',
 	coreConcepts: 'Principais Conceitos',
diff --git a/src/pages/pt-BR/comparing-astro-vs-other-tools.md b/src/pages/pt-BR/comparing-astro-vs-other-tools.md
new file mode 100644
index 0000000000000..e47119c91eae9
--- /dev/null
+++ b/src/pages/pt-BR/comparing-astro-vs-other-tools.md
@@ -0,0 +1,298 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Astro vs. X
+description: Comparando Astro com outros geradores de sites estáticos como Gatsby, Next.js, Nuxt, Hugo, Eleventy e outros.
+i18nReady: true
+---
+
+Isso nos é perguntado frequentemente, "Como Astro se compara ao meu projeto favorito, **\_\_\_\_**?"
+
+Este guia foi escrito para te ajudar a responder essa pergunta para diversos construtores de sites e alternativas ao Astro.
+
+Duas funcionalidades-chave que fazem o Astro diferente da maioria das alternativas:
+
+- [Hidratação parcial](/pt-BR/core-concepts/partial-hydration/)
+- [Usar seu(s) framework(s) favoritos](/pt-BR/core-concepts/framework-components/)
+
+Para mais detalhes, você pode ver nossas comparações aprofundadas nesta página.
+
+Se você não ver o seu construtor de sites favorito listado aqui, [nos pergunte no Discord](https://astro.build/chat/).
+
+## Docusaurus vs. Astro
+
+[Docusaurus](https://docusaurus.io/) é um popular construtor de websites de documentação. Docusaurus utiliza React para gerar a UI do seu website enquanto Astro suporta React, Preact, Vue.js, Svelte, SolidJS, AlpineJS, Lit e templates HTML.
+
+Docusaurus foi projetado para construir websites de documentação e tem algumas funcionalidades específicas para websites de documentação que o Astro não possui. No lugar, Astro oferece funcionalidades específicas para documentações através do tema oficial [`docs`](https://github.com/withastro/astro/tree/main/examples/docs) que você pode utilizar para o seu site. Este website foi feito utilizando esse template!
+
+#### Comparando a Performance do Docusaurus vs. Astro
+
+Na maioria dos casos, websites Astro irão carregar significantemente mais rápido do que websites Docusaurus. Isso acontece pois Astro automaticamente remove JavaScript desnecessário da página, hidratando apenas os componentes individuais que o precisam. Essa funcionalidade é chamada de [hidratação parcial](/pt-BR/core-concepts/partial-hydration/).
+
+Docusaurus não suporta hidratação parcial, fazendo o usuário carregar e hidratar novamente a página inteira no navegador, mesmo que a maioria do conteúdo da página seja estático. Isso cria um carregamento mais lento da página e piora a performance do seu website. Não há nenhuma forma de desabilitar esse comportamento no Docusaurus.
+
+#### Estudo de Caso: Construindo um Website de Documentação
+
+[docusaurus.io/docs](https://docusaurus.io/docs) é o website oficial da documentação do Docusaurus, construído com Docusaurus. O website oferece um conjunto parecido o suficiente de funcionalidades e design para ser comparado com o website da documentação oficial do Astro. Isso nos dá uma comparação **realista e aproximada** entre os dois construtores de sites.
+
+- **Pontuação de performance do Docusaurus**: 53 de 100 [(relatório completo)](/lighthouse/docusaurus/)
+- **Pontuação de performance do Astro**: 92 de 100 [(relatório completo)](/lighthouse/astro/)
+
+## Elder.js vs. Astro
+
+[Elder.js](https://elderguide.com/tech/elderjs/) é um gerador de sites estáticos opinativo construído para Svelte.
+
+Elder.js utiliza Svelte para renderizar seu website. Astro é mais flexível: você está livre para construir sua UI com qualquer biblioteca de componentes (React, Preact, Vue, Svelte, Solid e outros) ou a sintaxe integrada de componentes que é similar a HTML + JSX.
+
+Elder.js é único nessa lista por ser o único outro gerador de sites estáticos que suporta [hidratação parcial](/pt-BR/core-concepts/partial-hydration/). Ambos Astro e Elder.js automaticamente removem JavaScript desnecessário da página, hidratando apenas os componentes que o precisam individualmente. A API do Elder para hidratação parcial é um pouco diferente e Astro suporta algumas funcionalidades que o Elder.js não suporta (como `client:media`). Porém, quando se trata de performance, ambos os projetos irão construir websites bem similares.
+
+Elder.js utiliza uma solução customizada de roteamento que pode soar pouco familiar para novos desenvolvedores. Astro utiliza [roteamento baseado em arquivos](/pt-BR/core-concepts/routing/) que deve soar familiar para qualquer um que tenha vindo do Next.js, SvelteKit e até de outros geradores de sites estáticos como Eleventy.
+
+Elder.js foi projetado para ser executado em websites grandes, assim como diz construir um website com aproximadamente 20 mil páginas em menos de 10 minutos (em uma máquina virtual modesta). No momento de escrita, Astro constrói aproximadamente mil páginas em 66 segundos mas ainda não foi testado em projetos com mais de 20 mil páginas.
+
+Elder.js suporta ambas a Geração de Sites Estáticos (SSG) e Renderização no Lado do Servidor (SSR). Astro pode fazer builds estaticamente via SSG, ou passar para deploy em ambientes de SSR via [adaptadores](/pt-BR/guides/server-side-rendering/#habilitando-o-ssr-em-seu-projeto): Deno, serverless da Vercel, serverless da Netlify e Node.js, com mais vindo no futuro.
+
+## Eleventy vs. Astro
+
+[Eleventy](https://www.11ty.dev/) é um popular gerador de sites estáticos, feito com Node.js.
+
+Eleventy utiliza várias [linguagens antigas de template de HTML](https://www.11ty.dev/docs/languages/) para renderizar seu website: Nunjuncks, Liquid, Pug, EJS, e outras. Astro deixa você criar páginas utilizando suas bibliotecas de componentes de UI favoritas (React, Preact, Vue, Svelte, e outras) ou a sintaxe integrada de componentes que é similar a HTML + JSX. Eleventy não suporta utilizar componentes de UI modernos para fazer o template do seu HTML.
+
+#### Comparando a Performance do Eleventy vs. Astro
+
+Conceitualmente, Eleventy e Astro compartilham a mesma visão de "minimizar o JavaScript no lado do cliente" para o desenvolvimento web. Ambos Eleventy e Astro oferecem uma performance similar por terem zero JavaScript por padrão.
+
+Eleventy realiza isso te forçando a evitar JavaScript inteiramente. Sites utilizando Eleventy são geralmente escritos com pouco e até nenhum JavaScript. Isso se torna um problema quando você precisa ter JavaScript no lado do cliente. Fica em suas mãos construir o seu próprio processo de build de assets para Eleventy. Isso pode ser desgastante e o força a configurar bundling, minificação e outras otimizações por si mesmo.
+
+Em contraste, Astro automaticamente faz build de seu JavaScript no lado do cliente e CSS para você. Astro automaticamente remove qualquer JavaScript desnecessário da página, hidratando apenas os componentes que o precisam individualmente. Essa funcionalidade é chamada de [hidratação parcial](/pt-BR/core-concepts/partial-hydration/). Enquanto se é possível realizar isso por si mesmo no Eleventy, Astro oferece por padrão.
+
+#### Estudo de Caso: Construindo um Website de Documentação
+
+[11ty.dev/docs](https://www.11ty.dev/docs/) é o website oficial da documentação do 11ty, construído com 11ty. Esse website possui um conjunto de funcionalidades e design similar o suficiente para ser comparado com o website oficial da documentação do Astro. Isso nos dá uma comparação **realista e aproximada** entre os dois construtores de sites.
+
+- **Pontuação de performance do 11ty**: 86 de 100 [(relatório completo)](/lighthouse/11ty/)
+- **Pontuação de performance do Astro**: 92 de 100 [(relatório completo)](/lighthouse/astro/)
+
+## Gatsby vs. Astro
+
+[Gatsby](https://www.gatsbyjs.com/) é um popular framework de websites e aplicações para React.
+
+Gatsby utiliza React para renderizar seu website. Astro é mais flexível: você está livre para construir sua UI com qualquer biblioteca de componentes popular (React, Preact, Vue, Svelte, Solid e outros) ou a sintaxe de componentes do Astro que é similar a HTML + JSX.
+
+Gatsby v4 suporta tanto a Geração Estática de Sites (SSG) com rebuilds incrementais, a Geração Estática Deferida (DSG) e Renderização no Lado do Servidor (SSR). Astro pode fazer builds estaticamente via SSG, ou passar para deploy em ambientes de SSR via [adaptadores](/pt-BR/guides/server-side-rendering/#habilitando-o-ssr-em-seu-projeto): Deno, serverless da Vercel, serverless da Netlify e Node.js, com mais vindo no futuro.
+
+Gatsby requer uma API customizada de GraphQL para funcionar com todo o conteúdo do seu site. Enquanto alguns desenvolvedores gostam desse modelo, uma crítica comum ao Gatsby é que esse modelo se torna muito complexo e difícil de se manter conforme o tempo, especialmente em relação ao quanto os sites crescem. Astro não necessita de GraphQL, providenciando APIs familiares (como `fetch()` ou top-level `await`) para carregamento de dados próximo de onde os dados são necessários. Porém, você está livre para escolher utilizar qualquer biblioteca GraphQL no lado do servidor ou no lado do cliente com Astro.
+
+#### Comparando a Performance do Gatsby vs. Astro
+
+Na maioria dos casos, websites Astro irão carregar significantemente mais rápido que websites Gatsby. Isso acontece pois Astro automaticamente remove qualquer JavaScript desnecessário da página, hidratando apenas os componentes que o precisam individualmente. Essa funcionalidade é chamada de [hidratação parcial](/pt-BR/core-concepts/partial-hydration/).
+
+Gatsby não suporta hidratação parcial, e ao invés disso faz o usuário carregar e hidratar novamente a página inteira no navegador, mesmo que a maioria do conteúdo da página seja estático. Isso cria um carregamento mais lento da página e piora a performance do seu website. Gatsby tem um [plugin da comunidade](https://www.gatsbyjs.com/plugins/gatsby-plugin-no-javascript/) para remover todo o JavaScript da página, porém isso quebraria muitos websites. Isso te deixa numa situação de tudo ou nada com a interatividade de cada página.
+
+Gatsby tem um ótimo ecossistema de plugins, enquanto a [coleção de integrações](https://astro.build/integrations/) do Astro é menor, porém em constante crescimento. Gatsby fornece o plugin [gatsby-plugin-image](https://www.gatsbyjs.com/plugins/gatsby-plugin-image/) para otimizações avançadas de imagens. Enquanto Astro não tem uma solução oficial comparável, [astro-imagetools](https://github.com/RafidMuhymin/astro-imagetools#readme) é uma integração popular da comunidade para otimização de imagens, imagens de fundo e geração de imagens responsivas.
+
+#### Estudo de Caso: Construindo um Website de Documentação
+
+[gatsbyjs.com/docs](https://www.gatsbyjs.com/docs/quick-start/) é o website oficial da documentação do Gatsby, construído com Gatsby. O website possui um conjunto de funcionalidades e um design semelhante o suficiente para ser comparado com o website oficial da documentação do Astro. Isso nos dá uma comparação **_realista e aproximada_** entre os dois construtores de sites para esse comum caso de uso.
+
+- **Pontuação de Performance do Gatsby**: 46 de 100 [(relatório completo)](/lighthouse/gatsby/)
+- **Pontuação de Performance do Astro**: 92 de 100 [(relatório completo)](/lighthouse/astro/)
+
+## Hugo vs. Astro
+
+[Hugo](https://gohugo.io/) é um popular gerador de sites estáticos, feito em Go.
+
+Hugo utiliza uma [linguagem de templates](https://gohugo.io/templates/introduction/) customizada para renderizar seu website. Astro te permite criar páginas utilizando sua biblioteca favorita de componentes de UI (React, Preact, Vue, Svelte, e outros) ou utilizar a sintaxe integrada de componentes que é similar ao HTML + JSX. Hugo não suporta utilizar componentes de UI modernos para fazer o template do seu HTML.
+
+#### Comparando a Performance do Hugo vs. Astro 
+
+Conceitualmente, Hugo e Astro compartilham a mesma visão de "minimizar o JavaScript no lado do cliente" para o desenvolvimento web. Ambos Hugo e Astro oferecem uma performance similar por terem zero JavaScript por padrão.
+
+Ambos Hugo e Astro oferecem suporte integrado para fazer build, bundle e minificação de JavaScript. Astro automaticamente remove qualquer JavaScript desnecessário da página, hidratando apenas os componentes que o precisam individualmente. Esta funcionalidade é chamada de [hidratação parcial](/pt-BR/core-concepts/partial-hydration/). Apesar de ser possível realizar isso você mesmo no Hugo, Astro oferece isso de forma integrada por padrão.
+
+#### Estudo de Caso: Construindo um Website de Documentação
+
+[gohugo.io/documentation/](https://gohugo.io/documentation/) é o website oficial da documentação do Hugo, construído com Hugo. O website oferece um conjunto parecido o suficiente de funcionalidades e design para ser comparado com o website da documentação oficial do Astro. Isso nos dá uma comparação **realista e aproximada** entre os dois construtores de sites.
+
+- **Pontuação de Performance do Hugo**: 98 de 100 [(relatório completo)](/lighthouse/hugo/)
+- **Pontuação de Performance do Astro**: 92 de 100 [(relatório completo)](/lighthouse/astro/)
+
+
+## Jekyll vs. Astro
+
+[Jekyll](https://jekyllrb.com/) é um popular gerador de sites estáticos, feito com Ruby.
+
+Jekyll utiliza uma velha [linguagem de templates](https://jekyllrb.com/docs/liquid/) para renderizar o seu website chamado Liquid. Astro te permite criar páginas utilizando suas bibliotecas de componentes de UI favoritas (React, Preact, Vue, Svelte e outras) ou a sintaxe de componentes do Astro que é similar a HTML + JSX. Jekyll não suporta utilizar componentes de UI modernos para fazer o template do seu HTML.
+
+#### Comparando a Performance de Jekyll vs. Astro
+
+Conceitualmente, Jekyll e Astro compartilham a mesma visão de "minimizar o JavaScript no lado do cliente" para o desenvolvimento web. Ambos Jekyll e Astro oferecem uma performance similar por terem zero JavaScript por padrão.
+
+Jekyll realiza isso te forçando a evitar JavaScript inteiramente. Sites utilizando Jekyll são geralmente escritos com pouco e até nenhum JavaScript, e no lugar promove renderização de HTML no lado do servidor. Isso se torna um problema quando você precisa ter JavaScript no lado do cliente. Fica em suas mãos construir o seu próprio processo de build para Jekyll. Isso pode ser desgastante e o força a configurar bundling, minificação e outras otimizações por si mesmo.
+
+Em contraste, Astro automaticamente faz build de seu JavaScript no lado do cliente para você. Astro apenas envia a mínima quantidade de JavaScript para o navegador, minificado, com bundle feito e otimizado para produção. Enquanto se é possível realizar isso por si mesmo no Jekyll, Astro oferece por padrão.
+
+#### Estudo de Caso: Construindo um Website de Documentação
+
+[jekyllrb.com/docs](https://jekyllrb.com/docs) é o website oficial da documentação do Jekyll, construído com Jekyll. O website oferece um conjunto parecido o suficiente de funcionalidades e design para ser comparado com o website da documentação oficial do Astro. Isso nos dá uma comparação **realista e aproximada** entre os dois construtores de sites.
+
+- **Pontuação de performance do Jekyll**: 96 de 100 [(relatório completo)](/lighthouse/jekyll/)
+- **Pontuação de performance do Astro**: 92 de 100 [(relatório completo)](/lighthouse/astro/)
+
+## SvelteKit vs. Astro
+
+[SvelteKit](https://kit.svelte.dev/) é um popular framework de websites e aplicações para Svelte.
+
+SvelteKit utiliza Svelte para renderizar seu website. Astro é mais flexível: você está livre para construir sua UI com qualquer biblioteca de componentes (React, Preact, Vue, Svelte, Solid e outros) ou a sintaxe integrada de componentes que é similar a HTML + JSX.
+
+Ambos SvelteKit e Astro são frameworks para construir websites. SvelteKit é melhor em websites altamente dinâmicos (como painéis de controle e caixas de entrada) enquanto Astro é melhor em websites altamente estáticos (como websites de conteúdo e Ecommerce).
+
+SvelteKit suporta ambas a Geração Estática de Sites (SSG) e a Renderização no Lado do Servidor (SSR). Astro pode fazer builds estaticamente via SSG, ou passar para deploy em ambientes de SSR via [adaptadores](/pt-BR/guides/server-side-rendering/#habilitando-o-ssr-em-seu-projeto): Deno, serverless da Vercel, serverless da Netlify e Node.js, com mais vindo no futuro.
+
+#### Comparando a Performance de SvelteKit vs. Astro
+
+Na maioria dos casos, websites Astro irão carregar mais rápido que websites SvelteKit. Isso acontece pois Astro automaticamente remove JavaScript desnecessário da página, hidratando apenas os componentes individuais que o precisam. Essa funcionalidade é chamada de [hidratação parcial](/pt-BR/core-concepts/partial-hydration/).
+
+SvelteKit não suporta hidratação parcial, fazendo o usuário carregar e hidratar novamente a página inteira no navegador, mesmo que a maioria do conteúdo da página seja estático. Isso cria um carregamento mais lento da página e piora a performance do seu website. SvelteKit oferece suporte para [páginas estáticas com zero JavaScript](https://kit.svelte.dev/docs#ssr-and-javascript-hydrate). Porém, não há suporte planejado para hidratar componentes individuais na página. Isso te deixa numa situação de tudo ou nada com a interatividade de cada página.
+
+#### Estudo de Caso: Criando um Website de Documentação
+
+[kit.svelte.dev](https://kit.svelte.dev/docs#ssr-and-javascript-hydrate) é o website oficial da documentação do SvelteKit, construído com SvelteKit. O website oferece um conjunto parecido o suficiente de funcionalidades e design para ser comparado com o website da documentação oficial do Astro. Isso nos dá uma comparação **realista e aproximada** entre os dois construtores de sites.
+
+Uma notável diferença entre ambos os websites sendo testados: A documentação do SvelteKit é servida como uma única página, enquanto a do Astro é dividida em várias páginas. Este maior carregamento de conteúdo deve causar um certo impacto negativo na performance que não é relacionado a ferramenta em si.
+
+- **Pontuação de Performance do SvelteKit**: 91 de 100 [(relatório completo)](/lighthouse/sveltekit/)
+- **Pontuação de Performance do Astro**: 92 de 100 [(relatório completo)](/lighthouse/astro/)
+
+SvelteKit performou semelhantemente ao Astro nesse teste.
+
+## Next.js vs. Astro
+
+[Next.js](https://nextjs.org/) é um popular framework de websites e aplicações para React.
+
+Next.js utiliza React para renderizar seu website. Astro é mais flexível: você está livre para construir sua UI com qualquer biblioteca de componentes (React, Preact, Vue, Svelte, Solid e outros) ou a sintaxe integrada de componentes que é similar a HTML + JSX.
+
+Ambos Next.js e Astro são frameworks para construir websites. Next.js é melhor em websites altamente dinâmicos (como painéis de controle e caixas de entrada) enquanto Astro é melhor em websites altamente estáticos (como websites de conteúdo e Ecommerce).
+
+Next.js suporta ambas a Geração de Sites Estáticos (SSG) e Renderização no Lado do Servidor (SSR). Astro pode fazer builds estaticamente via SSG, ou passar para deploy em ambientes de SSR via [adaptadores](/pt-BR/guides/server-side-rendering/#habilitando-o-ssr-em-seu-projeto): Deno, serverless da Vercel, serverless da Netlify e Node.js, com mais vindo no futuro.
+
+
+#### Comparando a Performance do Next.js vs. Astro
+
+Na maioria dos casos, websites Astro irão carregar significantemente mais rápido do que websites Next.js. Isso acontece pois Astro automaticamente remove JavaScript desnecessário da página, hidratando apenas os componentes individuais que o precisam. Essa funcionalidade é chamada de [hidratação parcial](/pt-BR/core-concepts/partial-hydration/).
+
+Next.js não suporta hidratação parcial, fazendo o usuário carregar e hidratar novamente a página inteira no navegador, mesmo que a maioria do conteúdo da página seja estático. Isso cria um carregamento mais lento da página e piora a performance do seu website. Next.js tem [suporte experimental](https://piccalil.li/blog/new-year-new-website/#heading-no-client-side-react-code) para páginas completamente estáticas, sem JavaScript. Porém, não há suporte planejado para hidratação de componentes individuais na página. Isso te deixa numa situação de tudo ou nada com a interatividade de cada página.
+
+Next.js tem ótimas otimizações de imagens integrada. Enquanto Astro não tem uma solução oficial comparável, [astro-imagetools](https://github.com/RafidMuhymin/astro-imagetools#readme) é uma integração popular da comunidade para otimização de imagens, imagens de fundo e geração de imagens responsivas.
+
+#### Estudo de Caso: Criando um Website de Documentação
+
+[nextjs.org/docs](https://nextjs.org/docs/getting-started) é o website oficial da documentação do Next.js, construído com Next.js. O website oferece um conjunto parecido o suficiente de funcionalidades e design para ser comparado com o website da documentação oficial do Astro. Isso nos dá uma comparação **realista e aproximada** entre os dois construtores de sites.
+
+- **Pontuação de Performance do Next.js**: 71 de 100 [(relatório completo)](/lighthouse/next/)
+- **Pontuação de Performance do Astro**: 92 de 100 [(relatório completo)](/lighthouse/astro/)
+
+## Nuxt vs. Astro
+
+[Nuxt](https://nuxtjs.org/) é um popular framework de websites e aplicações para Vue. Ele é similar a Next.js.
+
+Nuxt utiliza Vue para renderizar seu website. Astro é mais flexível: você está livre para construir sua UI com qualquer biblioteca de componentes (React, Preact, Vue, Svelte, Solid e outros) ou a sintaxe integrada de componentes que é similar a HTML + JSX.
+
+Ambos Nuxt e Astro são frameworks para construir websites. Nuxt é melhor em websites altamente dinâmicos (como painéis de controle e caixas de entrada) enquanto Astro é melhor em websites altamente estáticos (como websites de conteúdo e Ecommerce).
+
+Nuxt suporta ambas a Geração de Sites Estáticos (SSG) e Renderização no Lado do Servidor (SSR). Astro pode fazer builds estaticamente via SSG, ou passar para deploy em ambientes de SSR via [adaptadores](/pt-BR/guides/server-side-rendering/#habilitando-o-ssr-em-seu-projeto): Deno, serverless da Vercel, serverless da Netlify e Node.js, com mais vindo no futuro.
+
+
+#### Comparando a Performance do Nuxt vs. Astro
+
+Na maioria dos casos, websites Astro irão carregar significantemente mais rápido do que websites Nuxt. Isso acontece pois Astro automaticamente remove JavaScript desnecessário da página, hidratando apenas os componentes individuais que o precisam. Essa funcionalidade é chamada de [hidratação parcial](/pt-BR/core-concepts/partial-hydration/).
+
+Nuxt não suporta hidratação parcial, fazendo o usuário carregar e hidratar novamente a página inteira no navegador, mesmo que a maioria do conteúdo da página seja estático. Isso cria um carregamento mais lento da página e piora a performance do seu website. Não há nenhuma forma de desabilitar esse comportamento no Nuxt.
+
+Nuxt tem ótimas otimizações de imagens integrada. Enquanto Astro não tem uma solução oficial comparável, [astro-imagetools](https://github.com/RafidMuhymin/astro-imagetools#readme) é uma integração popular da comunidade para otimização de imagens, imagens de fundo e geração de imagens responsivas.
+
+#### Estudo de Caso: Criando um Website de Documentação
+
+[nuxtjs.org/docs](https://nuxtjs.org/docs/2.x/get-started/installation) é o website oficial da documentação do Nuxt, construído com Nuxt. O website oferece um conjunto parecido o suficiente de funcionalidades e design para ser comparado com o website da documentação oficial do Astro. Isso nos dá uma comparação **realista e aproximada** entre os dois construtores de sites.
+
+- **Pontuação de Performance do Nuxt**: 50 de 100 [(relatório completo)](/lighthouse/nuxt/)
+- **Pontuação de Performance do Astro**: 92 de 100 [(relatório completo)](/lighthouse/astro/)
+
+## Remix vs. Astro
+
+[Remix](https://remix.run/) é um framework React inspirado no React Router.
+
+Remix utiliza React para renderizar seu website. Astro é mais flexível: você está livre para construir sua UI com qualquer biblioteca de componentes (React, Preact, Vue, Svelte, Solid e outros) ou a sintaxe integrada de componentes que é similar a HTML + JSX.
+
+Remix suporta apenas renderização no lado do servidor (SSR). Astro pode fazer builds estaticamente via SSG, ou passar para deploy em ambientes de SSR via [adaptadores](/pt-BR/guides/server-side-rendering/#habilitando-o-ssr-em-seu-projeto): Deno, serverless da Vercel, serverless da Netlify e Node.js, com mais vindo no futuro.
+
+
+#### Estudo de Caso: Criando um Website de Documentação
+
+[remix.run/docs](https://remix.run/docs/) é o website oficial da documentação do Remix, construído com Remix. O website oferece um conjunto parecido o suficiente de funcionalidades e design para ser comparado com o website da documentação oficial do Astro. Isso nos dá uma comparação **realista e aproximada** entre os dois construtores de sites.
+
+- **Pontuação de Performance do Remix**: 89 de 100 [(relatório completo)](/lighthouse/remix/)
+- **Pontuação de Performance do Astro**: 92 de 100 [(relatório completo)](/lighthouse/astro/)
+
+## VuePress vs. Astro
+
+[VuePress](https://vuepress.vuejs.org/guide/) é um popular construtor de websites de documentação dos criadores do Vue.js. VuePress utiliza Vue.js para gerar a UI do seu website enquanto Astro suporta React, Vue.js, Svelte, e templates HTML.
+
+VuePress foi projetado para construir websites de documentação e tem algumas funcionalidades específicas para websites de documentação que o Astro não possui. No lugar, Astro oferece funcionalidades específicas para documentações através do tema oficial [`docs`](https://github.com/withastro/astro/tree/main/examples/docs) que você pode utilizar para o seu site. Este website foi feito utilizando esse template!
+
+Evan You (criador do Vue.js) está atualmente trabalhando em uma nova versão do Vuepress chamada [VitePress](https://vitepress.vuejs.org/). Se você quiser uma alternativa moderna ao VuePress, [veja a postagem do Evan](https://github.com/withastro/astro/issues/1159#issue-974035962) do porquê VitePress pode ser uma opção melhor.
+
+#### Comparando a Performance do VuePress vs. Astro
+
+Na maioria dos casos, websites Astro irão carregar significantemente mais rápido do que websites VuePress. Isso acontece pois Astro automaticamente remove JavaScript desnecessário da página, hidratando apenas os componentes individuais que o precisam. Essa funcionalidade é chamada de [hidratação parcial](/pt-BR/core-concepts/partial-hydration/).
+
+VuePress não suporta hidratação parcial, fazendo o usuário carregar e hidratar novamente a página inteira no navegador, mesmo que a maioria do conteúdo da página seja estático. Isso cria um carregamento mais lento da página e piora a performance do seu website. Não há nenhuma forma de desabilitar esse comportamento no Vuepress.
+
+#### Estudo de Caso: Criando um Website de Documentação
+
+[vuepress.vuejs.org](https://vuepress.vuejs.org/guide/) é o website oficial da documentação do VuePress, construído com VuePress. O website oferece um conjunto parecido o suficiente de funcionalidades e design para ser comparado com o website da documentação oficial do Astro. Isso nos dá uma comparação **realista e aproximada** entre os dois construtores de sites.
+
+- **Pontuação de Performance do Vuepress**: 67 de 100 [(relatório completo)](/lighthouse/vuepress/)
+- **Pontuação de Performance do Astro**: 92 de 100 [(relatório completo)](/lighthouse/astro/)
+
+## Zola vs. Astro
+
+[Zola](https://www.getzola.org/) é um popular e rápido gerador de sites estáticos, feito com Rust.
+
+Zola utiliza [Tera](https://tera.netlify.app/) para renderizar seu website. Astro te permite construir sua UI com qualquer biblioteca de componentes (React, Preact, Vue, Svelte, Solid e outros) ou a sintaxe integrada de componentes que é similar a HTML + JSX. Zola não suporta utilizar componentes de UI modernos para fazer o template do seu HTML.
+
+#### Comparando a Performance do Zola vs. Astro
+
+Conceitualmente, Zola e Astro compartilham a mesma visão de "minimizar o JavaScript no lado do cliente" para o desenvolvimento web. Ambos Jekyll e Astro oferecem uma performance similar por terem zero JavaScript por padrão.
+
+Astro oferece suporte integrado para fazer build, bundle e minificação de JavaScript. Astro automaticamente remove qualquer JavaScript desnecessário da página, hidratando apenas os componentes que o precisam individualmente. Esta funcionalidade é chamada de [hidratação parcial](/pt-BR/core-concepts/partial-hydration/). Apesar de ser possível realizar isso você mesmo no Zola, Astro oferece isso de forma integrada por padrão.
+
+#### Estudo de Caso: Criando um Website de Documentação
+
+[getzola.org/documentation](https://www.getzola.org/documentation/getting-started/overview/) é o website oficial da documentação do Zola, construído com Zola. O website oferece um conjunto parecido o suficiente de funcionalidades e design para ser comparado com o website da documentação oficial do Astro. Isso nos dá uma comparação **realista e aproximada** entre os dois construtores de sites.
+
+- **Pontuação de Performance do Zola**: 91 de 100 [(relatório completo)](/lighthouse/zola/)
+- **Pontuação de Performance do Astro**: 92 de 100 [(relatório completo)](/lighthouse/astro/)
+
+## `.astro` vs `.jsx`
+
+A sintaxe de componentes Astro é um superset do HTML. Ela foi projetada para parecer familiar para qualquer um com experiência com HTML ou JSX.
+
+**Se você sabe HTML, você já sabe o suficiente para escrever seu primeiro componente Astro.**
+
+| Funcionalidade                      | Astro | JSX  |
+| ---------------------------- | ----- | --------- |
+| Extensão de arquivo               | `.astro` | `.jsx` ou `.tsx` |
+| Componentes Definidos pelo Usuário      | `<Capitalizado>` | `<Capitalizado>`  |
+| Sintaxe de Expressões            | `{}` | `{}` |
+| Atributos Spread            | `{...props}` | `{...props}` |
+| Atributos Boolean           | `autocomplete` === `autocomplete={true}` | `autocomplete` === `autocomplete={true}` |
+| Funções Inline             | `{itens.map(item => <li>{item}</li>)}`  | `{itens.map(item => <li>{item}</li>)}` |
+| Renderização Condicional             | `{condicao &&  <p>texto<p>}`  | `{condicao &&  <p>texto<p>}` |
+| Suporte de IDE                  | [VS Code (incluindo Open VSX), Nova](/pt-BR/editor-setup/) | Fenomenal |
+| Requer Importação de JS           | Não    | Sim, `jsxPragma` (`React` ou `h`) devem estar no escopo |
+| Fragmentos                    | Automático e top-level, `<Fragment>` ou `<>` dentro de funções | Envolver com `<Fragment>` ou `<>` |
+| Múltiplos frameworks por arquivo | Sim | Não |
+| Modificar `<head>`           | Apenas utilize `<head>` em páginas top-level | Por framework (`<Head>`, `<svelte:head>`, etc) |
+| Estilo de Comentários                | `<!-- HTML -->` | `{/_ JavaScript _/}`  |
+| Caracteres Especiais           | `&nbsp;`  | `&nbsp;`  |
+| Atributos                   | `dash-case` | `camelCase`|

From 301aff48a3d7861f0ffbf35ee1e4b7b37200c73a Mon Sep 17 00:00:00 2001
From: Kyosuke <kyosuke@users.noreply.github.com>
Date: Thu, 2 Jun 2022 16:54:20 +0900
Subject: [PATCH 31/41] i18n(ja): Add Japanese `core-concepts/layouts.md`
 (#705)

* i18n(ja): Add Japanese `core-concepts/layouts.md`

* Update layouts.md

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
---
 src/pages/ja/core-concepts/layouts.md | 88 +++++++++++++++++++++++++++
 1 file changed, 88 insertions(+)
 create mode 100644 src/pages/ja/core-concepts/layouts.md

diff --git a/src/pages/ja/core-concepts/layouts.md b/src/pages/ja/core-concepts/layouts.md
new file mode 100644
index 0000000000000..64bee6d0245a0
--- /dev/null
+++ b/src/pages/ja/core-concepts/layouts.md
@@ -0,0 +1,88 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: レイアウト
+description: レイアウトの紹介です。Astroコンポーネントの一種で、共通のレイアウトのためにページ間で共有されます。
+i18nReady: true
+---
+
+**レイアウト**は、再利用可能なページテンプレートを作成するのに便利な[Astroコンポーネント](/ja/core-concepts/astro-components/)の特殊なタイプです。
+
+レイアウトコンポーネントは、慣習的に [`.astro` または `.md` ページ](/ja/core-concepts/astro-pages/)に**ページシェル**（`<html>`, `<head>`, `<body>` タグ）と、レイアウト内のどこにページ内容を挿入するか指定する `<slot />` を提供するために使用されています。
+
+レイアウトは多くの場合、共通の `<head>` 要素や、ヘッダー、ナビゲーションバー、フッターなどのページの共通UI要素を提供します。
+
+レイアウトコンポーネントは一般的に、プロジェクト内の `src/layouts` ディレクトリに配置されます。
+
+
+## レイアウトのサンプル
+
+```astro
+---
+// 例: src/layouts/MySiteLayout.astro
+---
+<html>
+  <head>
+    <!-- ... -->
+  </head>
+  <body>
+    <nav>
+      <a href="#">ホーム</a>
+      <a href="#">ブログ</a>
+      <a href="#">お問い合わせ</a>
+    </nav>
+    <article>
+      <slot /> <!-- ここにコンテンツが挿入されます -->
+    </article>
+  </body>
+</html>
+```
+
+```astro
+---
+// 例: src/pages/index.astro
+import MySiteLayout from '../layouts/MySiteLayout.astro';
+---
+<MySiteLayout>
+  <p>レイアウトに包まれたページのコンテンツ</p>
+</MySiteLayout>
+```
+
+📚 [スロット](/ja/core-concepts/astro-components/#スロット)についてもっと学ぶ。
+
+
+## レイアウトの入れ子
+
+レイアウトコンポーネントは、ページ全体に相当するHTMLを含む必要はありません。レイアウトをより小さなコンポーネントに分割し、そのコンポーネントを再利用して、プロジェクトでさらに柔軟で強力なレイアウトを作成できます。
+
+たとえば、ブログの記事によくあるレイアウトは、タイトル、日付、作者を表示するものです。`BlogPostLayout.Astro`レイアウトコンポーネントは、このUIをページに追加し、さらに大きなサイト全体のレイアウトを利用して、ページの残りの部分を処理できます。
+
+```astro
+---
+// 例: src/layout/BlogPostLayout.astro
+import BaseLayout from '../layouts/BaseLayout.astro'
+const {content} = Astro.props;
+---
+<BaseLayout>
+  <h1>{content.title}</h1>
+  <h2>投稿者: {content.author}</h2>
+  <slot />
+</BaseLayout>
+```
+
+## Markdownのレイアウト
+
+ページレイアウトはとくに[Markdownファイル](/ja/guides/markdown-content/#markdown-pages)に対して便利です。Markdownファイルは特別な `layout`というfront-matterのプロパティを使用して、MarkdownコンテンツをフルページのHTMLドキュメントで包むレイアウトコンポーネントを指定できます。
+
+Markdownページがレイアウトを使用する場合、レイアウトにはすべてのMarkdownのfront-matterデータと最終的なHTML出力を含む、単一の `content` プロパティを渡します。 レイアウトコンポーネントでこの `content` プロパティをどのように使用するかは、上記の `BlogPostLayout.Astro` の例を参照してください。
+
+```markdown
+// src/pages/posts/post-1.md
+---
+title: ブログ記事
+description: 最初のブログ記事
+layout: ../layouts/BlogPostLayout.astro
+---
+これはMarkdownで書かれた投稿です。
+```
+
+📚 AstroのMarkdownサポートについては、[Markdownガイド](/ja/guides/markdown-content/)で詳しく説明しています。

From 791671fe7954dac0fbfa404e6d037e042bcb8fb1 Mon Sep 17 00:00:00 2001
From: Kevin Zuniga Cuellar
 <46791833+kevinzunigacuellar@users.noreply.github.com>
Date: Thu, 2 Jun 2022 18:18:41 -0400
Subject: [PATCH 32/41] i18n(es): update `astro-pages.md` (#689)

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
---
 src/pages/es/core-concepts/astro-pages.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/pages/es/core-concepts/astro-pages.md b/src/pages/es/core-concepts/astro-pages.md
index 07f2b5b26d512..3a475459b6cea 100644
--- a/src/pages/es/core-concepts/astro-pages.md
+++ b/src/pages/es/core-concepts/astro-pages.md
@@ -33,7 +33,7 @@ Las páginas de Astro deben devolver una respuesta completa de la página `<html
 
 ### Aprovechando las plantillas de página
 
-Para evitar repetir los mismos elementos HTML en cada página, puedes mover los elementos comunes `<head>` y `<body>` a sus propios [componentes de plantilla](/es/core-concepts/layouts/). Puede usar tantos o tan pocos componentes como crea conveniente.
+Para evitar repetir los mismos elementos HTML en cada página, puedes mover los elementos comunes `<head>` y `<body>` a sus propios [componentes plantilla](/es/core-concepts/layouts/). Puede usar tantos o tan pocos componentes como crea conveniente.
 
 ```astro
 ---
@@ -45,14 +45,14 @@ import MySiteLayout from '../layouts/MySiteLayout.astro';
 </MySiteLayout>
 ```
 
-📚 Lea más sobre [componentes de plantilla](/es/core-concepts/layouts/) en Astro.
+📚 Lea más sobre [componentes plantilla](/es/core-concepts/layouts/) en Astro.
 
 
 ## Páginas Markdown 
 
 Astro también trata cualquier archivo Markdown (`.md`) dentro de `/src/pages/` como páginas en su proyecto. Estos se usan comúnmente para páginas con mucho texto, como artículos de blog y documentación.
 
-Las plantillas de página son especialmente útiles para [archivos Markdown](#páginas-markdown). Los archivos Markdown pueden usar la propiedad especial `layout` para especificar un [componente de plantilla](/es/core-concepts/layouts/) que envolverá su contenido Markdown en un documento completo de página `<html>...</html>`.
+Los componentes plantilla son especialmente útiles para [archivos Markdown](#páginas-markdown). Los archivos Markdown pueden usar la propiedad especial `layout` para especificar un [componente plantilla](/es/core-concepts/layouts/) que envolverá su contenido Markdown en un documento de página completo `<html>...</html>`.
 
 ```md
 ---
@@ -83,7 +83,7 @@ En SSR (server-side rendering), la extensión no importa y se puede omitir. Esto
 // Resultado: /builtwith.json
 
 // Las rutas de archivo exportan una función get(), que se llama para generar el archivo.
-// Devuelve un objeto con `body` para guardar el contenido del archivo en tu compilación final.
+// Devuelve un objeto con `body` para guardar el contenido del archivo en la compilación final.
 export async function get() {
   return {
     body: JSON.stringify({
@@ -122,8 +122,8 @@ export const get: APIRoute = ({ params, request }) => {
 };
 ```
 
-## Página 404 personalizada
+## Página de error 404 personalizada
 
-Para crear una página de error 404 personalizada, puedes crear un archivo `404.astro` en `/src/pages`.
+Para crear una página de error 404 personalizada, puedes crear un archivo `404.astro` o `404.md` en `/src/pages`.
 
 Esto generará una página `404.html` que la mayoría de los [servicios de despliegue](/es/guides/deploy/) encontrarán y usarán.

From 9bdd7bf33f15083186eb2581189a431536de6def Mon Sep 17 00:00:00 2001
From: Kevin Zuniga Cuellar
 <46791833+kevinzunigacuellar@users.noreply.github.com>
Date: Thu, 2 Jun 2022 18:24:11 -0400
Subject: [PATCH 33/41] i18n(es): Update `core-concepts/routing.md` (#691)

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
---
 src/i18n/es/ui.ts                     |  2 +-
 src/pages/es/core-concepts/routing.md | 97 +++++++++++++++++----------
 2 files changed, 61 insertions(+), 38 deletions(-)

diff --git a/src/i18n/es/ui.ts b/src/i18n/es/ui.ts
index f05a0b8998c0e..a0bd1d5a13c7e 100644
--- a/src/i18n/es/ui.ts
+++ b/src/i18n/es/ui.ts
@@ -25,7 +25,7 @@ export default UIDictionary({
 	'rightSidebar.github': 'Documentación de Astro en GitHub',
 	// Used in previous/next page links at the bottom of pages
 	'articleNav.nextPage': 'Siguiente página',
-	'articleNav.prevPage': 'Atras',
+	'articleNav.prevPage': 'Página anterior',
 	// Used in `<Since>`: Added in: v0.24.0 [NEW]
 	'since.addedIn': 'Agregado en:',
 	'since.new': 'Nuevo',
diff --git a/src/pages/es/core-concepts/routing.md b/src/pages/es/core-concepts/routing.md
index d2d7e2eab623d..2cf33b15b5c45 100644
--- a/src/pages/es/core-concepts/routing.md
+++ b/src/pages/es/core-concepts/routing.md
@@ -40,16 +40,16 @@ Puedes generar rutas con un parámetro `[nombrado]` proporcionando a la función
 
 ```astro
 ---
-// src/pages/dogs/[dog].astro
+// src/pages/perros/[perro].astro
 
 export function getStaticPaths() {
   return [
-    // Generates: /dogs/clifford
-    {params: {dog: 'clifford'}},
-    // Generates: /dogs/rover
-    {params: {dog: 'rover'}},
-    // Generates: /dogs/spot
-    {params: {dog: 'spot'}},
+    // Genera: /perros/clifford
+    {params: {perro: 'clifford'}},
+    // Genera: /perros/rover
+    {params: {perro: 'rover'}},
+    // Genera: /perros/spot
+    {params: {perro: 'spot'}},
   ];
 }
 ---
@@ -65,7 +65,7 @@ Las rutas pueden ser generadas a partir de uno o varios parámetros nombrados, e
 
 #### El objeto `Astro.params`
 
-Los componentes de Astro que generan rutas dinámicamente tienen acceso al objeto `Astro.params` para cada ruta. Esto le permite usar las variables de la URL en su script y maquetado.
+Los componentes de Astro que generan rutas dinámicamente tienen acceso al objeto `Astro.params` para cada ruta. Esto le permite usar las variables de la URL dentro del script y maquetado.
 
 ```astro
 ---
@@ -126,13 +126,9 @@ En este ejemplo, una solicitud a `/withastro/astro/tree/main/docs/public/favicon
 }
 ```
 
-### Advertencias
+### Orden de prioridad de rutas
 
-Las solicitudes de consulta de parámetros no siempre coincidirán con todas las rutas existentes en su proyecto.
-
-Las rutas estáticas sin parámetros tendrán prioridad sobre todas las demás rutas, y no coincidirán con las consultas de parámetros de ruta dinámicas. De manera similar, las rutas nombradas tienen prioridad sobre las rutas comodín.
-
-Considere el siguiente proyecto:
+Es posible que varias rutas coincidan con la misma ruta URL. Por ejemplo, cada una de estas rutas coincidiría con `/posts/create`:
 
 ```
 └── pages/
@@ -143,54 +139,81 @@ Considere el siguiente proyecto:
 
 ```
 
-- `pages/post/create.astro` - Coincidirá con `/post/create`
-- `pages/post/[pid].astro` - Coincidirá con `/post/1`, `/post/abc`, etc. Pero no con `/post/create`
-- `pages/post/[...slug].astro` - Coincidirá con `/post/1/2`, `/post/a/b/c`, etc. Pero no con `/post/create`, `/post/1`, `/post/abc`
+Astro necesita saber qué ruta debe usarse para construir la página. Para ello, los ordena de acuerdo con las siguientes reglas:
+
+- Las rutas estáticas sin parámetros de ruta tendrán prioridad sobre todas las demás rutas
+- Las rutas dinámicas que usan parámetros nombrados tienen prioridad sobre los parámetros comodín
+- Los parámetros comodín tienen la prioridad más baja.
+- Los empates se resuelven alfabéticamente
 
+Dado el ejemplo anterior, aquí hay algunos ejemplos de cómo las reglas harán coincidir una URL solicitada con la ruta utilizada al compilar el HTML:
+
+- `pages/posts/create.astro` - Construirá `/posts/create`
+- `pages/posts/[pid].astro` - Construirá `/posts/1`, `/posts/abc`, etc. Pero no `/posts/create`
+- `pages/posts/[...slug].astro` - Construirá `/posts/1/2`, `/posts/a/b/c`, etc. Pero no `/posts/create`, ` /mensajes/1`, `/mensajes/abc`
 ## Paginación
 
-Astro mantiene la paginación automática integrada para grandes colecciones de datos que deben dividirse en varias páginas. Astro incluirá automáticamente metadatos de paginación para cosas como la URL de la página anterior/siguiente, el número total de páginas y más.
+Astro mantiene la paginación automática integrada para grandes colecciones de datos que deben dividirse en varias páginas. Astro incluirá automáticamente metadatos de paginación como la URL de la página anterior/siguiente, el número total de páginas y más.
+
+Los nombres de rutas paginadas deben usar la misma sintaxis `[corchete]` que una ruta dinámica estándar. Por ejemplo, el nombre de archivo `/astronautas/[page].astro` generará rutas para `/astronautas/1`, `/astronautas/2`, etc., donde `[page]` es el número de página generado.
+
+Puedes usar la función `paginate()` para generar estas páginas para un array de valores como este:
 
 ```astro
 ---
-// Ejemplo: Usando paginate() en una ruta dinámica
+// Ejemplo: /src/pages/astronauts/[page].astro
 export async function getStaticPaths({ paginate }) {
-  // Carga tus datos:
-  const response = await fetch(`https://pokeapi.co/api/v2/pokemon?limit=150`);
-  const result = await response.json();
-  const allPokemon = result.results;
-  // Devuelve una colección paginada de rutas:
-  return paginate(allPokemon, { pageSize: 10 });
+  const astronautPages = [{
+    astronaut: 'Neil Armstrong',
+  }, {
+    astronaut: 'Buzz Aldrin',
+  }, {
+    astronaut: 'Sally Ride',
+  }, {
+    astronaut: 'John Glenn',
+  }];
+  // Genera páginas para nuestro array de astronautas, con 2 elementos por página
+  return paginate(astronautPages, { pageSize: 2 });
 }
-// Los datos paginados se pasan como prop a cada página.
+// Todos los datos paginados se pasan en la prop "page"
 const { page } = Astro.props;
 ---
-<!-- ... -->
-```
 
-La paginación es útil cuando se necesita generar varias páginas enumeradas a partir de un conjunto de datos más amplios:
+<!--Muestra el número de página actual. ¡También puedes utilizar Astro.params.page!-->
+<h1>Page {page.currentPage}</h1>
+<ul>
+  <!--Enumera el array con información sobre astronautas-->
+  {page.data.map(({ astronaut }) => <li>{astronaut}</li>)}
+</ul>
+```
 
-- `/posts/1` (Página 1: Muestra los artículos del 1-10)
-- `/posts/2` (Página 2: Muestra los artículos del 11-20)
-- `/posts/3` (Página 3: Muestra los artículos del 21-30)
+Esto genera las siguientes páginas, con 2 elementos por página:
+- `/astronauts/1` - Página 1: muestra "Neil Armstrong" y "Buzz Aldrin"
+- `/astronauts/2` - Página 2: Muestra "Sally Ride" y "John Glenn"
 
 ### La prop `page` 
 
-Cuando usas la función `paginate()`, a cada página de la colección se le pasarán sus datos a través de una prop `page`. La prop `page` tiene varias propiedades útiles, pero la más importante es `page.data`. Esta es el array que contiene la porción de datos de la página que pasaste a la función `paginate()`.
+Cuando usas la función `paginate()`, a cada página se le pasarán los datos a través de una prop `page`. La prop `page` tiene muchas propiedades útiles, pero estas son las más destacadas:
+- **page.data** - array que contiene la porción de datos de página que introdujo a la función `paginate()`
+- **page.url.next** - enlace a la página siguiente del mismo conjunto de datos
+- **page.url.prev** - enlace a la página anterior del mismo conjunto de datos
 
 ```astro
 ---
-// Ejemplo: Usando la prop `page` de la paginación
-export async function getStaticPaths() { /* ... */ }
+// Ejemplo: /src/pages/astronauts/[page].astro
+// Paginar la misma lista de objetos { astronaut } como en el ejemplo anterior
+export async function getStaticPaths({ paginate }) { /* ... */ }
 const { page } = Astro.props;
 ---
 <h1>Page {page.currentPage}</h1>
 <ul>
-  {page.data.map(item => <li>{item.title}</li>)}
+  {page.data.map(({ astronaut }) => <li>{astronaut}</li>)}
 </ul>
+{page.url.prev ? <a href={page.url.prev}>Previous</a> : null}
+{page.url.next ? <a href={page.url.next}>Next</a> : null}
 ```
 
-La propiedad `page` también incluye otros metadatos útiles, como `page.url.next`, `page.url.prev`, `page.total` y más.
+#### Referencia API completa
 
 ```ts
 interface Page<T = any> {

From 22358aa7e73828a36229e72556462d782fa817a2 Mon Sep 17 00:00:00 2001
From: Kevin Zuniga Cuellar
 <46791833+kevinzunigacuellar@users.noreply.github.com>
Date: Thu, 2 Jun 2022 18:28:00 -0400
Subject: [PATCH 34/41] i18n(es): add configuring-astro.md (#693)

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
---
 src/i18n/es/nav.ts                       |   1 +
 src/pages/es/guides/configuring-astro.md | 113 +++++++++++++++++++++++
 2 files changed, 114 insertions(+)
 create mode 100644 src/pages/es/guides/configuring-astro.md

diff --git a/src/i18n/es/nav.ts b/src/i18n/es/nav.ts
index a84597e8378fc..eb74bf3ea9b4b 100644
--- a/src/i18n/es/nav.ts
+++ b/src/i18n/es/nav.ts
@@ -11,4 +11,5 @@ export default NavDictionary({
 	'core-concepts/routing': 'Reglas de enrutamiento',
 	'core-concepts/partial-hydration': 'Hidratación parcial',
 	'guides/markdown-content': 'Markdown',
+	'guides/configuring-astro': 'Configuración de Astro',
 });
diff --git a/src/pages/es/guides/configuring-astro.md b/src/pages/es/guides/configuring-astro.md
new file mode 100644
index 0000000000000..5992d3710ad9d
--- /dev/null
+++ b/src/pages/es/guides/configuring-astro.md
@@ -0,0 +1,113 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Configuración de Astro
+i18nReady: true
+---
+
+Personalice cómo funciona Astro agregando un archivo `astro.config.mjs` en su proyecto. Este es un archivo común en todos los proyectos de Astro; todas plantillas y temas de ejemplos oficiales se encuentran con uno de forma predeterminada.
+
+📚 Lea la [referencia de configuración](/es/reference/configuration-reference/) de Astro para obtener una descripción general y completa de todas las opciones de configuración.
+
+## Archivo de configuración de Astro
+
+Un archivo de configuración de Astro válido exporta la configuración usando la exportación `default`, además recomendamos usar `defineConfig` para definir la configuración de una manera más fácil.
+
+```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+  // sus opciones de configuración van aquí...
+  // https://docs.astro.build/es/reference/configuration-reference/
+})
+```
+
+Se recomienda usar `defineConfig()` para sugerencias de tipos automáticas en su IDE, pero también es opcional. Un archivo de configuración absolutamente mínimo y válido se vería así:
+
+```js
+// Ejemplo: Archivo de configuración mínimo y vacío
+export default {}
+```
+
+## Tipos de archivo de configuración compatibles
+
+Astro es compatible con varios formatos para el archivo de configuración de JavaScript como: `astro.config.js`, `astro.config.mjs`, `astro.config.cjs` y `astro.config.ts`.
+
+La carga del archivo de configuración de TypeScript se maneja usando [`tsm`](https://github.com/lukeed/tsm) el cual respetará las opciones de tsconfig de su proyecto.
+
+## Resolución de archivos de configuración
+
+Astro intentará resolver automáticamente el archivo de configuración llamado `astro.config.mjs` dentro de la raíz del proyecto. Si no se encuentra ningún archivo de configuración en la raíz de su proyecto, se utilizarán las opciones predeterminadas de Astro.
+
+```bash
+# Ejemplo: Lee la configuración desde ./astro.config.mjs
+astro build
+```
+
+Puedes configurar explícitamente un archivo de configuración usando el indicador CLI `--config`. Este indicador CLI siempre se resuelve en relación a la carpeta de trabajo actual desde donde se ejecutó el comando CLI `astro`.
+
+```bash
+# Ejemplo: Lee la configuración de este archivo
+astro build --config my-config-file.js
+```
+
+## Configurar Intellisense
+
+Astro recomienda usar `defineConfig()` en su archivo de configuración. `defineConfig()` proporciona IntelliSense automático para su IDE. Los editores como VSCode pueden leer las definiciones de tipo TypeScript de Astro y proporcionar sugerencias de tipo jsdoc automáticas, incluso si su archivo de configuración no está escrito en TypeScript.
+
+```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+  // sus opciones de configuración van aquí...
+  // https://docs.astro.build/es/reference/configuration-reference/
+})
+```
+
+También puedes proporcionar definiciones de tipo manualmente a VSCode, utilizando la notación JSDoc:
+
+```js
+// astro.config.mjs
+ export default /** @type {import('astro').AstroUserConfig} */ ({
+  // sus opciones de configuración van aquí...
+  // https://docs.astro.build/es/reference/configuration-reference/
+}
+```
+
+## Referenciando archivos relativos
+
+Si proporciona una ruta relativa a `root` o el indicador de CLI `--root`, Astro lo resolverá desde la carpeta de trabajo actual donde ejecutó el comando CLI `astro`.
+
+```js
+export default defineConfig({
+    // Se resuelve a la carpeta "./foo" con relación a la carpeta de trabajo actual
+    root: 'foo'
+})
+```
+
+Astro resolverá todos los archivos y carpetas relativos a la carpeta raíz del proyecto especificada en su archivo de configuración.
+
+```js
+export default defineConfig({
+    // Se resuelve a la carpeta "./foo" con relación a la carpeta de trabajo actual
+    root: 'foo',
+    // Se resuelve a la carpeta "./foo/public" con relación a la carpeta de trabajo actual
+    publicDir: 'public',
+})
+```
+
+Para hacer referencia a un archivo o carpeta relativo al archivo de configuración, use `import.meta.url` (a menos que esté escribiendo un archivo common.js `astro.config.cjs`).
+
+```js
+export default defineConfig({
+    // Se resuelve a la carpeta "./foo" con relación a este archivo de configuración
+    root: new URL("./foo", import.meta.url),
+    // Se resuelve a la carpeta "./public" con relación a este archivo de configuración
+    publicDir: new URL("./public", import.meta.url),
+})
+```
+
+## Referencia de configuración
+
+📚 Lea la [referencia de configuración](/es/reference/configuration-reference/) de Astro para obtener una descripción general y completa de todas las opciones de configuración.

From b26b7a4e417e1070d0e9585ec31950787caab17f Mon Sep 17 00:00:00 2001
From: Kevin Zuniga Cuellar
 <46791833+kevinzunigacuellar@users.noreply.github.com>
Date: Thu, 2 Jun 2022 18:31:47 -0400
Subject: [PATCH 35/41] i18n(es): Update `partial-hydration.md` (#708)

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
---
 src/pages/es/core-concepts/partial-hydration.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/pages/es/core-concepts/partial-hydration.md b/src/pages/es/core-concepts/partial-hydration.md
index 52f1d37fbf19f..e09dedf2dd688 100644
--- a/src/pages/es/core-concepts/partial-hydration.md
+++ b/src/pages/es/core-concepts/partial-hydration.md
@@ -7,7 +7,7 @@ setup: |
 i18nReady: true
 ---
 
-**Astro por defecto genera todas las páginas web sin JavaScript del lado del cliente.** Use cualquier componente de interfaz de usuario que desee ([React](https://reactjs.org/), [Preact](https://preactjs.com/), [Svelte](https://svelte.dev/), [Vue](https://vuejs.org/), [SolidJS](https://www.solidjs.com/), [AlpineJS](https://alpinejs.dev/) y [Lit](https://lit.dev/)), Astro lo renderizará automáticamente a HTML en la compilación final y eliminará todo el JavaScript. Esto mantiene cada página más rápida por defecto.
+**Astro por defecto genera todas las páginas web sin JavaScript del lado del cliente.** Use componentes de interfaz de usuario como [React](https://reactjs.org/), [Preact](https://preactjs.com/), [Svelte](https://svelte.dev/), [Vue](https://vuejs.org/), [SolidJS](https://www.solidjs.com/), [AlpineJS](https://alpinejs.dev/) o [Lit](https://lit.dev/), Astro lo renderizará automáticamente a HTML en la compilación final y eliminará todo el JavaScript. Esto mantiene cada página más rápida por defecto.
 
 ```astro
 ---
@@ -18,7 +18,7 @@ import MyReactComponent from '../components/MyReactComponent.jsx';
 <MyReactComponent />
 ```
 
-A veces, se requiere JavaScript del lado del cliente para crear una interfaz de usuario interactiva. Cuando necesites una interfaz de usuario interactiva en la página, Astro no lo obliga a usar 100% JavaScript en toda la página. En cambio, Astro usa una técnica llamada **hidratación parcial** que le permite hidratar componentes individuales en la página. De esta manera, solo envía el JavaScript absolutamente esencial que necesita para ejecutar su página.
+A veces, se requiere JavaScript del lado del cliente para crear interfaz de usuario interactivas. Cuando necesites una interfaz de usuario interactiva en la página, Astro no lo obliga a usar 100% JavaScript en toda la página. En cambio, Astro usa una técnica llamada **hidratación parcial** que le permite hidratar componentes individuales en la página. De esta manera, solo se envía el JavaScript absolutamente esencial para ejecutar su página.
 
 ```astro
 ---
@@ -30,7 +30,7 @@ import MyReactComponent from '../components/MyReactComponent.jsx';
 <MyReactComponent client:load />
 ```
 
-La gran mayoría de su página web sigue siendo HTML y CSS, puro y ligero, con **islas de interactividad** aisladas.
+La gran mayoría de su página web sigue siendo HTML y CSS, puro y ligero, junto con **islas de interactividad** aisladas.
 
 ## Hidratación parcial
 
@@ -47,7 +47,7 @@ En Astro, depende de usted como desarrollador optar explícitamente por cualquie
 
 ## Arquitectura de Islas
 
-La **arquitectura de islas** es la idea de usar hidratación parcial para construir páginas web. La arquitectura de islas es una alternativa al proceso común de construir una página web desde un paquete de JavaScript del lado del cliente que se envía al usuario.
+La **arquitectura de islas** es la idea de usar hidratación parcial para construir páginas web interactivas. La arquitectura de islas es una alternativa al proceso común de construir una página web desde un paquete de JavaScript del lado del cliente que se envía al usuario.
 
 > La idea general de una "arquitectura de islas" es muy simple: renderiza las páginas HTML en el servidor e inyecta marcadores de posición o ranuras alrededor de regiones altamente dinámicas.
 > <br/> -- [Arquitectura de Islas: Jason Miller](https://jasonformat.com/islands-architecture/)

From 8e38f2bf3b795eb8909e5f174adabb1fa00d3306 Mon Sep 17 00:00:00 2001
From: Kevin Zuniga Cuellar
 <46791833+kevinzunigacuellar@users.noreply.github.com>
Date: Thu, 2 Jun 2022 18:37:41 -0400
Subject: [PATCH 36/41] i18n(es): add `guides/aliases.md` (#709)

Co-authored-by: delucis <swithinbank@gmail.com>
---
 src/i18n/es/nav.ts             |  1 +
 src/pages/es/guides/aliases.md | 47 ++++++++++++++++++++++++++++++++++
 2 files changed, 48 insertions(+)
 create mode 100644 src/pages/es/guides/aliases.md

diff --git a/src/i18n/es/nav.ts b/src/i18n/es/nav.ts
index eb74bf3ea9b4b..357fb742ff25c 100644
--- a/src/i18n/es/nav.ts
+++ b/src/i18n/es/nav.ts
@@ -12,4 +12,5 @@ export default NavDictionary({
 	'core-concepts/partial-hydration': 'Hidratación parcial',
 	'guides/markdown-content': 'Markdown',
 	'guides/configuring-astro': 'Configuración de Astro',
+	'guides/aliases': 'Aliases de importación',
 });
diff --git a/src/pages/es/guides/aliases.md b/src/pages/es/guides/aliases.md
new file mode 100644
index 0000000000000..9f11a875d1acb
--- /dev/null
+++ b/src/pages/es/guides/aliases.md
@@ -0,0 +1,47 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Aliases
+description: Introducción a los alias en Astro.
+i18nReady: true
+---
+
+Un **alias** es una forma de crear atajos para sus importaciones.
+
+Los alias ayudan a mejorar la experiencia de desarrollo en repositorios con muchas carpetas o importaciones relativas.
+
+```astro
+---
+// my-project/src/pages/about/company.astro
+
+import Button from '../../components/controls/Button.astro';
+import logoUrl from '../../assets/logo.png?url';
+---
+```
+
+En este ejemplo, un desarrollador necesitaría comprender la relación de archivos entre `src/pages/about/company.astro`, `src/components/controls/Button.astro` y `src/assets/logo.png`. Y luego, si se moviera el archivo `company.astro`, estas importaciones también tendrían que actualizarse.
+
+Puedes agregar alias de importación desde `tsconfig.json` o `jsconfig.json`.
+
+```json
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@components/*": ["src/components/*"]
+    }
+  }
+}
+```
+
+Con este cambio, ahora puedes importar usando los alias desde cualquier parte de su proyecto:
+
+```astro
+---
+// my-project/src/pages/about/company.astro
+
+import Button from '@components/Button';
+import logoUrl from '@assets/logo.png';
+---
+```
+
+Estos alias también se integran automáticamente a [VSCode](https://code.visualstudio.com/docs/languages/jsconfig) y otros editores.

From 5a540668ceee8ebea0a0afe142190bd3bf68abc7 Mon Sep 17 00:00:00 2001
From: Kevin Zuniga Cuellar
 <46791833+kevinzunigacuellar@users.noreply.github.com>
Date: Thu, 2 Jun 2022 18:44:20 -0400
Subject: [PATCH 37/41] i18n(es): add `data-fetching.md` (#711)

Co-authored-by: delucis <swithinbank@gmail.com>
---
 src/i18n/es/nav.ts                   |   1 +
 src/pages/es/guides/data-fetching.md | 102 +++++++++++++++++++++++++++
 2 files changed, 103 insertions(+)
 create mode 100644 src/pages/es/guides/data-fetching.md

diff --git a/src/i18n/es/nav.ts b/src/i18n/es/nav.ts
index 357fb742ff25c..a88184532c838 100644
--- a/src/i18n/es/nav.ts
+++ b/src/i18n/es/nav.ts
@@ -12,5 +12,6 @@ export default NavDictionary({
 	'core-concepts/partial-hydration': 'Hidratación parcial',
 	'guides/markdown-content': 'Markdown',
 	'guides/configuring-astro': 'Configuración de Astro',
+	'guides/data-fetching': 'Obtención de datos',
 	'guides/aliases': 'Aliases de importación',
 });
diff --git a/src/pages/es/guides/data-fetching.md b/src/pages/es/guides/data-fetching.md
new file mode 100644
index 0000000000000..a75193935d849
--- /dev/null
+++ b/src/pages/es/guides/data-fetching.md
@@ -0,0 +1,102 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Obtención de datos
+description: Aprenda como obtener datos remotos con Astro utilizando la API de fetch.
+i18nReady: true
+---
+
+Los archivos `.astro` pueden obtener datos remotos al momento de la compilación para ayudar a generar sus páginas.
+
+## `fetch()` en Astro
+
+Todos los [componentes de Astro](/es/core-concepts/astro-components/) tienen acceso a la función global [`fetch()`](https://developer.mozilla.org/en-US/docs/Web/API/fetch) en el script de su componente para realizar solicitudes HTTP a las APIs. Esta llamada se ejecutará en el momento de la compilación y los datos estarán disponibles en su componente para generar el HTML dinámico.
+
+💡 Aproveche el [**top-level await**](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/await#top_level_await) dentro del script de su componente de Astro.
+
+💡 Pase los datos obtenidos a los componentes de Astro u otros UI frameworks, como props.
+
+```astro
+---
+// src/components/User.astro
+import Contact from '../components/Contact.jsx';
+import Location from '../components/Location.astro';
+
+const response = await fetch('https://randomuser.me/api/');
+const data = await response.json();
+const randomUser = data.results[0]
+---
+<!-- Los datos obtenidos en la compilación pueden ser usados en el HTML -->
+<h1>User</h1>
+<h2>{randomUser.name.first} {randomUser.name.last}</h2>
+
+<!-- Los datos obtenidos en la compilación pueden pasados como props a otros componentes -->
+<Contact client:load email={randomUser.email} />
+<Location city={randomUser.location.city} />
+```
+
+### Consultas en GraphQL
+
+Astro también puede usar `fetch()` para consultar a un servidor GraphQL con cualquier query de GraphQL válida.
+
+```astro
+---
+const response = await fetch("https://graphql-weather-api.herokuapp.com",
+  {
+    method:'POST',
+    headers: {'Content-Type':'application/json'},
+    body: JSON.stringify({
+      query: `
+        query getWeather($name:String!) {
+            getCityByName(name: $name){
+              name
+              country
+              weather {
+                summary {
+                    description
+                }
+              }
+            }
+          }
+        `,
+      variables: {
+          name: "Toronto",
+      },
+    }),
+  })
+
+const json = await response.json();
+const weather = json.data
+---
+<h1>Obtenega datos sobre el clima en el momento de la compilación</h1>
+<h2>{weather.getCityByName.name}, {weather.getCityByName.country}</h2>
+<p>Clima: {weather.getCityByName.weather.summary.description}</p>
+```
+
+> 💡 Recuerde, todos los datos en los componentes de Astro se recuperan cuando un componente es renderizado.
+
+Al desplegar, su proyecto de Astro solicitará los datos **una sola vez en el momento de la compilación**. En desarrollo, verá solicitudes de datos al actualizar los componentes. Si necesita volver a obtener datos varias veces del lado del cliente, use un [componente de framework](/es/core-concepts/framework-components/) o un [script del lado del cliente](/es/core-concepts/astro-components/#scripts-del-lado-del-cliente) en un componente de Astro.
+
+## `fetch()` en componentes de framework
+
+La función `fetch()` también está disponible globalmente para cualquier [componentes de framework](/es/core-concepts/framework-components/):
+
+```tsx
+// Movies.tsx
+import type { FunctionalComponent } from 'preact';
+import { h } from 'preact';
+
+const data = await fetch('https://example.com/movies.json').then((response) =>
+  response.json()
+);
+
+// Los componentes que se renderizan en tiempo de compilación también se registran en la CLI.
+// Cuando se representan con una directiva client:*, también se registran en la consola del navegador.
+console.log(data);
+
+const Movies: FunctionalComponent = () => {
+// Envía el resultado a la página.
+  return <div>{JSON.stringify(data)}</div>;
+};
+
+export default Movies;
+```

From 55c8eb55a41d486150a5344ee378a7ddeb385f6a Mon Sep 17 00:00:00 2001
From: yuto <43196286+yuto343@users.noreply.github.com>
Date: Fri, 3 Jun 2022 09:47:20 +0900
Subject: [PATCH 38/41] i18n(ja): Add Japanese configuring-astro.md (#713)

* i18n(ja): Add Japanese configuring-astro.md

* update configuring-astro.md

* update configuiing-astro.md

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/pages/ja/guides/configuring-astro.md | 111 +++++++++++++++++++++++
 1 file changed, 111 insertions(+)
 create mode 100644 src/pages/ja/guides/configuring-astro.md

diff --git a/src/pages/ja/guides/configuring-astro.md b/src/pages/ja/guides/configuring-astro.md
new file mode 100644
index 0000000000000..28863056aeb9e
--- /dev/null
+++ b/src/pages/ja/guides/configuring-astro.md
@@ -0,0 +1,111 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: Astroの設定
+i18nReady: true
+---
+
+プロジェクトに`astro.config.mjs`ファイルを追加することで、Astroの動作をカスタマイズできます。これはAstroプロジェクトではよく使われるファイルで、公式のサンプルテンプレートやテーマはすべて、デフォルトでこのファイルを含んでいます。
+
+📚 サポートされているすべてのオプションの概要については、Astroの[API設定リファレンス](/ja/reference/configuration-reference/)をお読みください。
+
+## Astroの設定ファイル
+
+有効なAstro設定ファイルは、`default`エクスポートを使用して、設定をエクスポートします。`defineConfig`ヘルパーを用いるのがおすすめです。
+
+```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+  // オプションをここに書きます...
+  // https://docs.astro.build/ja/reference/configuration-reference/
+})
+```
+
+`defineConfig()`を使うと、IDEで自動的にタイプヒントを表示できるのでおすすめですが、これはオプションです。最低限必要で、有効な設定ファイルは次のようなものです。
+
+```js
+// 例: 最低限必要な空の設定ファイル
+export default {}
+```
+
+## サポートされている設定ファイルの種類
+
+Astroは、JavaScriptの設定ファイルとして、次のようないくつかのファイル形式をサポートしています。 `astro.config.js`,`astro.config.mjs`,`astro.config.cjs`,`astro.config.ts`
+
+TypeScriptの設定ファイルの読み込みは、[`tsm`](https://github.com/lukeed/tsm)を使って処理され、プロジェクトのtsconfigのオプションを尊重します。
+## 設定ファイルの指定
+
+Astroは、プロジェクトルート内にある`astro.config.mjs`という名前の設定ファイルを自動的に使用しようとします。プロジェクトルートに設定ファイルがない場合、Astroのデフォルトのオプションが使用されます。
+
+```bash
+# 例: ./astro.config.mjs から設定を読み込みます。 
+astro build
+```
+
+`--config`フラグを使用して、使用する設定ファイルを明示的に設定できます。このCLIフラグは、常に`astro`コマンドを実行した現在の作業ディレクトリから相対パスで指定されます。
+
+```bash
+# 例: このファイルから設定を読み込みます。
+astro build --config my-config-file.js
+```
+
+## 設定のインテリセンス
+
+Astroでは、設定ファイルに`defineConfig()`ヘルパーを使用することをおすすめします。`defineConfig()`はIDEに自動的にインテリセンスを提供します。VSCodeのようなエディタは、設定ファイルがTypeScriptで書かれていなくても、AstroのTypeScriptの型定義を読み込んで、自動的にjsdocの型ヒントを提供してくれます。
+
+```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+  // オプションをここに書きます...
+  // https://docs.astro.build/ja/reference/configuration-reference/
+})
+```
+また、以下のJSDoc記法を用いてVSCodeに手動で型定義を提供できます。
+
+```js
+// astro.config.mjs
+ export default /** @type {import('astro').AstroUserConfig} */ ({
+  // オプションをここに書きます...
+  // https://docs.astro.build/ja/reference/configuration-reference/
+})
+```
+
+## 相対ファイルの参照
+
+`root`または`--root`フラグで相対パスを指定すると、`astro`コマンドを実行した現在の作業ディレクトリに反して、指定した相対パスをルートとして使用します。
+
+```js
+export default defineConfig({
+    // 現在の作業ディレクトリにある "./foo"ディレクトリを指します。
+    root: 'foo'
+})
+```
+
+Astroは、他のすべての相対ファイルおよび相対ディレクトリを、プロジェクトルートからの相対パスとして解決します。
+
+```js
+export default defineConfig({
+    // 現在の作業ディレクトリにある "./foo"ディレクトリを指します。
+    root: 'foo',
+    // 現在の作業ディレクトリの "./foo/public" ディレクトリを指します。
+    publicDir: 'public',
+})
+```
+
+設定ファイルから相対的にファイルやディレクトリを参照するには、`import.meta.url`を使用します（common.jsの`astro.config.cjs`ファイルを記述する場合を除きます）。
+
+```js
+export default defineConfig({
+    // この設定ファイルからの相対パスで、"./foo"ディレクトリを指します。
+    root: new URL("./foo", import.meta.url),
+    // この設定ファイルから相対パスで、"./public "ディレクトリを指します。
+    publicDir: new URL("./public", import.meta.url),
+})
+```
+
+## 設定リファレンス
+
+📚 サポートされているすべての設定オプションの概要については、Astroの[API設定リファレンス](/ja/reference/configuration-reference/)を参照してください。

From 63b88389533d54af2988c0cdad7eb3ba30cae09e Mon Sep 17 00:00:00 2001
From: yuto <43196286+yuto343@users.noreply.github.com>
Date: Fri, 3 Jun 2022 09:50:05 +0900
Subject: [PATCH 39/41] i18n(ja): Add Japanese migrate.md (#712)

* i18n(ja): Add Japanese migrate.md

* fix link error

* update ja/migrate.md

* update migrate.md

* update migrate.md

* update migrate.md

* update migrate.md

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/pages/ja/migrate.md | 505 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 505 insertions(+)
 create mode 100644 src/pages/ja/migrate.md

diff --git a/src/pages/ja/migrate.md b/src/pages/ja/migrate.md
new file mode 100644
index 0000000000000..77be0abf4989f
--- /dev/null
+++ b/src/pages/ja/migrate.md
@@ -0,0 +1,505 @@
+---
+layout: ~/layouts/MainLayout.astro
+title: アップグレードガイド
+description: プロジェクトをAstroの最新バージョンにアップグレードする。
+i18nReady: true
+---
+
+このガイドは古いバージョンのAstroから最新のバージョンへの移行を支援するものです。
+
+主なハイライトと、破壊的変更への対処方法については以下のガイドをご覧ください。
+
+## Astro 1.0 Beta
+
+2022年4月4日、1.0 Betaがリリースされました！🎉
+
+**正式なv1.0.0リリース(2022年6月8日予定)に向けて、このベータ期間中にこれ以上の破壊的変更を加えることは予定していません。**
+
+もし、何らかの破壊的変更が必要な場合は、このセクションで呼びかけます。
+
+## v1.0.0-beta.0へアップグレード
+
+`v1.0.0-beta.0`に破壊的変更はありません。
+
+v0.25以前からアップグレードする人は、いくつかの破壊的変更を含んだ以下の[v0.26へアップグレード](#v026へアップグレード)を読み、それに従っているか確認してください。
+
+## v0.26へアップグレード
+### 新しいConfiguration API
+
+Configuration APIは、昨年以来蓄積されたいくつかの顕著な混乱ポイントを解決するために再設計されました。ほとんどの設定は移動または名前が変更されているだけなので、ほとんどのユーザーはすぐにアップデートできるでしょう。いくつかのオプションは大きくリファクタリングされており、追加で変更が必要になるかもしれません。
+
+- `.buildOptions.site`は`.site`(デプロイ先ドメイン)と新たな`.base`(デプロイ先のサブパス)オプションに置き換えられました。
+- `.markdownOptions`は、Markdownの設定を簡素化するためにいくつかの小さな変更を加えた、ほぼ同様の設定オブジェクトである`.markdown`に置き換わりました。
+- `.sitemap`は[@astrojs/sitemap](https://www.npmjs.com/package/@astrojs/sitemap)インテグレーションに移動しました。
+
+レガシーな構成でAstroを実行すると、アップデート方法を示す警告が表示されます。アップグレードの詳細については、更新された[設定方法](/ja/reference/configuration-reference/)を参照してください。
+
+これらの変更の背景については、[RFC0019](https://github.com/withastro/rfcs/blob/main/proposals/0019-config-finalization.md)をご覧ください。
+
+### 新しいMarkdown API
+
+Astro v0.26は、コンテンツのために全く新しいMarkdown APIをリリースします。これには3つの大きな変更が含まれています。
+- ESMのimport(`import`/`import()`)を使用してマークダウンコンテンツを直接インポートできるようになりました。 
+- 新しい`Astro.glob()`APIは、globのインポートをより簡単にします。(特に Markdownで)。
+- **破壊的変更:** `Astro.fetchContent()`は削除され、`Astro.glob()`に置き換わりました。
+- **破壊的変更:** Markdownオブジェクトのインターフェイスが更新されました。
+
+```diff
+// v0.25
+- let allPosts = Astro.fetchContent('./posts/*.md');
+// v0.26+
++ let allPosts = await Astro.glob('./posts/*.md');
+```
+
+アップグレードする際は、新しいMarkdownオブジェクトのインターフェースに注意してください。例えば、front-matterは `.frontmatter` プロパティに移動したので、`post.title`のような参照は`post.frontmatter.title`に変更する必要があります。
+
+これは、大規模なサイトにおけるパフォーマンスの向上を含む、Markdownユーザーにとっての多くの問題を解決するはずです。
+
+これらの変更の背景については、[RFC0017](https://github.com/withastro/rfcs/blob/main/proposals/0017-markdown-content-redesign.md)をご覧ください。
+
+### スクリプトの新しいデフォルト動作
+
+Astroコンポーネントの`<script>`タグは、デフォルトでビルド、バンドル、最適化されるようになりました。これは、Astroコンポーネントの構文をより一貫したものにし、現在の`<style>`タグが行っている、デフォルトで最適化された動作と一致させるという長期的な移行を完成させるものです。
+
+これには、注意すべきいくつかの変更点があります。
+
+- **破壊的変更:**`<script hoist>`の動作は新しいデフォルトの`<script>`の動作になりました。`hoist`属性は削除されました。 
+- 新しい`<script is:inline>`ディレクティブは、`<script>`タグを以前のデフォルトの動作(ビルドなし、バンドルなし、Astroによる変更なし)に戻すためのものです。
+- 新しい`<style is:inline>`ディレクティブは、スタイルタグをページテンプレートにインラインで残せます(以前の`<script>`の動作に似ています)。
+- 新しい`<style is:global>`ディレクティブは、将来のリリースで`<style global>`を置き換える予定です。
+
+```diff
+// v0.25
+- <script hoist>
+// v0.26+
++ <script>
+```
+詳しくは、Astroの[クライアントサイドスクリプト](/ja/core-concepts/astro-components/#クライアントサイドスクリプト)の使い方をご覧ください。
+
+これらの変更の背景については、[RFC0016](https://github.com/withastro/rfcs/blob/main/proposals/0016-style-script-defaults.md)をご覧ください。
+
+### `Astro.request`APIの更新
+
+`Astro.request`はカスタムオブジェクトから標準の`Request`オブジェクトに変更されました。これは、特にSSRに関連した、よりWeb標準のAPIを使用するプロジェクトの一部です。
+
+これには、注意すべきいくつかの変更点があります。
+
+- `Astro.request`を[Request](https://developer.mozilla.org/ja/docs/Web/API/Request)オブジェクトに変更しました。
+- `Astro.request.params`を`Astro.params`に移動しました。
+- `Astro.request.canonicalURL`を`Astro.canonicalURL`に移動しました。
+
+これらの変更の背景については、[RFC0018](https://github.com/withastro/rfcs/blob/main/proposals/0018-astro-request.md)をご覧ください。
+
+### その他変更
+
+- `Astro.slots`APIを改良し、関数ベースのスロットに引数を渡せるようになりました。これにより、コールバック関数を子関数として受け取る、より人間工学的なユーティリティコンポーネントが可能になります。
+- CLI出力のフォーマット、特にエラーレポート周りを更新しました。
+- `@astrojs/compiler`を更新し、front-matterでの正規表現の使用に関するバグを修正しました。
+
+## v0.25へアップグレード
+
+### Astroインテグレーション
+
+`renderers`の設定が新しい公式のインテグレーションシステムに置き換えられました！ これにより、Astroの非常にエキサイティングな新機能がいくつか追加されます。この新しいシステムの使用方法の詳細については、[インテグレーションを使用する](/ja/guides/integrations-guide/)ガイドを参照してください。
+
+
+インテグレーションは,`renderers`の概念に代わるもので、いくつかの破壊的変更と、既存ユーザ向けの新しいデフォルト機能が付属しています。これらの変更については以下で説明します。
+
+#### 削除: ビルトインのフレームワークサポート
+
+以前は、React、Preact、Svelte、VueのすべてがAstroにデフォルトで含まれていました。v0.25.0 以降、Astroにはビルトインのレンダラーが付属しなくなりました。プロジェクトに`renderers`の設定項目が定義されていない場合、これらのフレームワークを自分でインストールする必要があります。
+
+現在使用しているフレームワークに新しいAstroインテグレーションを追加する方法については、[ステップバイステップのチュートリアル](/ja/guides/integrations-guide/)をご覧ください。
+
+#### 非推奨: Renderers
+
+> *カスタムした"renderers"をすでに設定ファイルに定義している場合は、このセクションをご覧ください。*
+
+
+新しいインテグレーションシステムは、npmで公開されている`@astrojs/renderer-*`パッケージを含む、以前の`renderers`システムを置き換えるものです。今後、`@astrojs/renderer-react`は`@astrojs/react`に、`@astrojs/renderer-vue`は`@astrojs/vue`といった具合になります。
+
+**アップグレード方法:** Astroを`v0.25.0`にアップデートし、古い`"renderers"`の設定を含む設定ファイルを使用して`astro dev`または`astro build`を実行します。現在の設定に基づき、`astro.config.mjs`ファイルに必要な変更を伝える通知がすぐに表示されます。また、以下の表を使用して、自分でパッケージを更新することもできます。
+
+より詳しい説明は、[ステップバイステップガイド](/ja/guides/integrations-guide/)をチェックして、既存のレンダラーを新しいAstroフレームワークインテグレーションに置き換える方法を学んでください。
+
+```diff
+# 新しいインテグレーションやフレームワークをインストールする:
+# (チュートリアルの詳細を読む: https://docs.astro.build/ja/guides/integrations-guide)
++ npm install @astrojs/lit lit
++ npm install @astrojs/react react react-dom
+```
+```diff
+# そして、`astro.config.mjs`ファイルをアップデートする:
+# (チュートリアルの詳細を読む: https://docs.astro.build/ja/guides/integrations-guide)
++ import lit from '@astrojs/lit';
++ import react from '@astrojs/react';
+
+export default {
+-   renderers: ['@astrojs/renderer-lit', '@astrojs/renderer-react'],
++   integrations: [lit(), react()],
+}
+```
+
+
+| npm上にある非推奨のレンダラー | v0.25+ npm上にあるインテグレーション |
+| --------------------------- | -------------------------- |
+| @astrojs/renderer-react     | @astrojs/react             |
+| @astrojs/renderer-preact    | @astrojs/preact            |
+| @astrojs/renderer-solid     | @astrojs/solid-js          |
+| @astrojs/renderer-vue       | @astrojs/vue               |
+| @astrojs/renderer-svelte    | @astrojs/svelte            |
+
+#### Peer Dependenciesのハンドリング
+
+> *以下の場合は、このセクションをご覧ください。Node v14を使用している場合**または**npm以外のパッケージマネージャを使用している場合*
+
+旧renderersとは異なり、インテグレーションはフレームワーク自体（react、svelte、vueなど）を直接の依存対象としてマークしなくなりました。その代わり、フレームワークのパッケージを、インテグレーションに**加えて**インストールする必要があります。
+
+
+```diff
+# 例: インテグレーションとともにフレームワークもインストールする
+- npm install @astrojs/react
++ npm install @astrojs/react react react-dom
+```
+
+Astroの起動時に「Cannot find package 'react'」（または同様の警告）が表示された場合、そのパッケージをプロジェクトにインストールする必要があることを意味します。詳細については、インテグレーションの[peer dependenciesに関する注意書き](/ja/guides/integrations-guide/#handling-integration-dependencies)を参照してください。
+
+npmとNode v16+を使用している場合、npmの最新バージョン（v7+）がこのようなpeer dependenciesを自動的にインストールするため、npmによって自動的に処理される場合があります。その場合、reactのようなフレームワークをプロジェクトにインストールすることは、必須ではありませんが、おすすめのステップです。
+
+### 更新: シンタックスハイライト
+
+私たちはすぐに使える気の利いたデフォルト機能を見つけることが大好きです。 その一環として[Shiki](https://github.com/shikijs/shiki)を新しいデフォルトのシンタックスハイライターに決定しました。 これは`github-dark`テーマにあらかじめ設定されていて、余計なCSSクラス、スタイルシート、クライアントサイドのjsなしで、設定せずともシンタックスハイライトを提供してくれます。
+
+詳細については新しい[シンタックスハイライトのドキュメント](/ja/guides/markdown-content/#syntax-highlighting)をご覧ください。 **もし、シンタックスハイライトにPrismを使用したい場合は、** プロジェクトのマークダウン設定で[`syntaxHighlight`オプションを`prism`](/ja/guides/markdown-content/#prism-configuration)に設定してください。
+
+#### `<Prism />`コンポーネントを新しい場所へ
+
+Astroのコアをできるだけスリムにするというミッションの一環として、ビルドインだった`Prism`コンポーネントを`astro/components`から`@astrojs/prism`パッケージに移動させました。このコンポーネントは`@astrojs/prism`から以下のようにインポートできます。
+
+```astro
+---
+import { Prism } from '@astrojs/prism';
+---
+```
+
+`@astrojs/prism`パッケージは`astro`のコアにバンドルされているので、新たにインストールする必要はありませんし、Prismをインテグレーションとして追加する必要もありません！しかし、将来的には`@astrojs/prism`(およびPrismのシンタックスハイライト全般)を別のインストール可能なパッケージとして切り出す予定であることに注意してください。詳しくは[`<Prism />`コンポーネントAPIリファレンス](/ja/reference/api-reference/#prism-)を参照してください。
+
+### CSSパーサーの更新
+
+内部のCSSパーサーが更新され、コンテナクエリなどの高度なCSS構文がより良くサポートされるようになりました。これはほとんどのユーザーにとって目に見えない変更ですが、上級ユーザーが新しいCSS機能のサポートを享受できることを期待しています。
+
+## v0.24へアップグレード
+
+> 0.24では、新しいビルド方法がデフォルトで有効になっています。もし問題が発生した場合は、`--legacy-build`フラグを指定することで、古いビルド方法を使用し続けられます。新しいビルド方法に関する問題を解決するために、[issueを登録](https://github.com/withastro/astro/issues/new/choose)してください。
+
+0.24 では、いくつかの機能の動作を変更する新しい *静的ビルド* 戦略を導入しました。以前のバージョンのAstroでは、これは`--experimental-static-build`フラグを付与した際の動作でした。
+
+アップグレードに向けて、この新しいビルドエンジンに移行するために必要な以下の変更点に注意してください。これらの変更はいつでもコードに加えられるので、想定より早く準備できるでしょう。
+
+### 非推奨: `Astro.resolve()`
+
+`Astro.resolve()`を使うと、ブラウザで参照したいアセットの解決済みのURLを取得できます。これは、必要に応じてCSSファイルや画像を読み込むために、`<link>`タグや`<img>`タグの内部で最もよく使用されていました。しかし残念ながら、Astroが *レンダリング時* ではなく *ビルド時* にアセットを構築するようになったため、機能しなくなりました。今後利用可能な以下の将来性のあるオプションのいずれかに、参照先をアップグレードすることをおすすめします。
+
+#### CSSファイルのパス解決
+
+**1. ESM Import (おすすめ)**
+
+**例:** `import './style.css';`
+**使いどころ:** CSSファイルが `src/` ディレクトリ内にあり、CSSのビルドと最適化の機能が必要な場合。
+
+ESM Importを使用して、ページにCSSを追加します。AstroはこれらのCSSインポートを検出し、CSSを自動的にビルド、最適化、およびページに追加します。これは、Astroが提供するビルド/バンドルシステムを使いながらも`Astro.resolve()`から移行する最も簡単な方法です。
+
+```astro
+---
+// 例: AstroはCSSを自動的にインクルードし最適化します。
+import './style.css';
+---
+<html><!-- ページ内容 --></html>
+```
+CSSファイルのインポートは、次のようなESMのimportがサポートされている場所であれば動作します。
+
+- JavaScriptファイル
+- TypeScript ファイル
+- Astroコンポーネントのfront-matter
+- ReactやSvelteなどの非Astroコンポーネント
+
+この方法でCSSファイルをインポートすると、`@import`も解決され、インポートされたCSSファイルにインライン化されます。すべての`url()`関数もソースファイルからの相対パスで解決され、`url()`が参照するアセットが最終的なビルドに含まれるようになります。
+
+**2. 絶対パス**
+
+**例:** `<link href="/style.css">`
+**使いどころ:** CSSファイルが`public/`ディレクトリ内にあり、HTMLの`link`要素を自分で作りたい場合。 
+
+`public/`ディレクトリ内の任意のファイルはコンポーネントテンプレート内で絶対パスにより参照できます。これは、ページ上の`<link>`タグを自分で制御したい場合に有効なオプションです。ただし、この方法は上述した`ESM Import`を使用した場合にAstroが提供する、バンドル、最適化といったCSS処理をスキップします。
+
+デフォルトで最高のCSSパフォーマンスと機能を提供するため、絶対パスを指定するよりも`import`を使用することをおすすめします。
+
+#### JavaScriptファイルのパス解決
+
+**1. 絶対パス**
+
+**例:** `<script src="/some-external-script.js" />`
+**使いどころ:** JavaScriptファイルが `public/` の中にある場合。
+
+Astroコンポーネントのテンプレートでは、`public/`ディレクトリ内の任意のファイルを絶対パスで参照できます。これは、ページ上の`<script>`タグをページ自体で制御できるため、外部スクリプトのデフォルトオプションとして適しています。
+
+この方法では、後述の`import`を使用した場合に、Astroが提供するJavaScriptの処理、バンドル、最適化が省略されることに注意してください。しかし、すでにAstroとは別に公開され、最小化されている外部スクリプトの場合は、この方法が好ましいかもしれません。スクリプトが外部ソースからダウンロードされる場合は、この方法が良いでしょう。
+
+**2. `<script hoist>`によるESM Import**
+
+**例:** `<script hoist>import './some-external-script.js';</script>`
+**使いどころ:** 外部スクリプトが`src/`ディレクトリ内にあり、それがES Modulesをサポートしている場合。
+
+Astroテンプレート内の`<script hoist>`要素内でESMのimportを使用すると、Astroは最終的なビルドにJavaScriptファイルを含めます。AstroはこれらのJavaScriptのクライアントサイドインポートを検出し、ビルド、最適化、およびページへのJavaScriptの追加を自動的に行います。これは、Astroが提供するビルド/バンドルシステムを使いながらも`Astro.resolve()`から移行する最も簡単な方法です。
+
+```astro
+<script hoist>
+  import './some-external-script.js';
+</script>
+```
+
+Astroはこの外部スクリプトを残りのクライアントサイドJavaScriptと一緒にバンドルし、`type="module"`で読み込むことに注意してください。古いJavaScriptファイルは `type="module"`の文脈で書かれていない場合があり、その場合はこの方法を使用するために更新する必要があるかもしれません。
+
+#### 画像や他のアセットのパスを解決する方法
+
+**1. 絶対パス(おすすめ)**
+
+**例:** `<img src="/penguin.png">`
+**使いどころ:** アセットが`public/`ディレクトリ内にある場合
+
+`public/`の中に画像を配置すれば、コンポーネントテンプレート内で直接絶対パスで安全に参照できます。これは現在使用できる最もシンプルなアセットを参照する方法であり、Astroを使い始めたほとんどのユーザーにおすすめの方法です。
+
+**2. ESM Import**
+
+**例:** `import imgUrl from './penguin.png'`
+**使いどころ:** アセットが `src/` ディレクトリ内にあり、ファイル名のハッシュ化のような自動最適化機能が必要な場合。 
+
+これは、あらゆるJavaScriptまたはAstroコンポーネントの内部で動作し、最終的な画像への解決されたURLを返します。そのURLはコンポーネントテンプレート内のどこでも使用できます。
+
+```astro
+---
+// 例: Astroはこの画像を最終的なビルドに含めます。
+import imgUrl from './penguin.png';
+---
+<img src={imgUrl} />
+```
+
+AstroがCSSを処理する方法と同様に、ESMのimportによってAstroはいくつかの簡単なビルドの最適化を自動的に実行できます。例えば、ESMのimportを使用してインポートされた`src/`内のアセット（例：`import imgUrl from './penguin.png'`）には、そのファイル名が自動的にハッシュ化されます。これにより、サーバー上でより積極的にファイルをキャッシュでき、ユーザーのパフォーマンスを向上させます。将来、Astroはこのような最適化をさらに追加する可能性があります。
+
+**ヒント:** 静的なESMのimportが嫌いな場合は、Astroは動的なESMのimportもサポートしています。このオプションを推奨するのは、この構文が好きな場合のみです。: `<img src={(await import('./penguin.png')).default} />`.
+
+
+### 非推奨: `<script>`のデフォルト処理
+
+以前は、すべての`<script>`要素が最終的なHTML出力から読み込まれ、自動的に処理、バンドルされていました。この動作は、もはやデフォルトではありません。0.24からは、`<script>`要素に`hoist`属性を明示する必要があります。また、hoistされたモジュールには、`type="module"`が必要です。
+
+```astro
+<script>
+  // 書かれたとおりにHTMLにレンダリングされます！
+  // ESMのimportはファイルからの相対パスでは解決はされません。
+</script>
+<script type="module" hoist>
+  // 処理、バンドルされます! ESMのimportは、npmパッケージに対しても機能します。
+</script>
+```
+
+
+## v0.23へアップグレード
+
+### Sassが欠落するエラー
+
+```
+Preprocessor dependency "sass" not found. Did you install it?
+```
+
+npmのインストールサイズを小さくするために、Sassをオプションの依存関係に移動しました。プロジェクトでSassを使用する場合は、`npm install sass --save-dev`を実行して依存関係として保存したか確認することをおすすめします。
+
+### 非推奨: エスケープされていないHTML
+
+Astro v0.23+では、コード中のエスケープされていないHTMLコンテンツは非推奨になりました。
+今後のリリースでは、意図しないHTMLインジェクションから保護するために、コード内のコンテンツは文字列がエスケープされるようになります。
+
+```diff
+- <h1>{title}</h1> <!-- <h1>Hello <strong>World</strong></h1> -->
++ <h1>{title}</h1> <!-- <h1>Hello &lt;strong&gt;World&lt;/strong&gt;</h1> -->
+```
+
+エスケープされていないHTMLを注入する場合、今後は`set:html`を使用する必要があります。
+
+```diff
+- <h1>{title}</h1>
++ <h1 set:html={title} />
+```
+
+ラッパー要素を避けるために、`set:html`は`<Fragment>`と一緒に動作します。
+
+```diff
+- <h1>{title}!</h1>
++ <h1><Fragment set:html={title}>!</h1>
+```
+
+また、`set:text`を使えば、意図しないHTMLインジェクションから保護することができます。
+
+```astro
+<h1 set:text={title} /> <!-- <h1>Hello &lt;strong&gt;World&lt;/strong&gt;</h1> -->
+```
+
+## v0.21へアップグレード
+
+### Vite
+
+v0.21から、Astroは[Vite]でビルドされるようになりました。
+そのため、`snowpack.config.mjs`に書かれている設定は`astro.config.mjs`に移動する必要があります。
+
+```js
+// @ts-check
+
+/** @type {import('astro').AstroUserConfig} */
+export default {
+  renderers: [],
+  vite: {
+    plugins: [],
+  },
+};
+```
+
+Viteの設定について詳しく知りたい方は、Viteの[設定ガイド](https://vitejs.dev/config/)をご覧ください。
+
+#### Viteプラグイン
+
+Astro v0.21+では、Viteプラグインは`astro.config.mjs`内で設定できます。
+
+```js
+import { imagetools } from 'vite-imagetools';
+
+export default {
+  vite: {
+    plugins: [imagetools()],
+  },
+};
+```
+
+Viteプラグインの詳細については、Viteの[プラグインガイド](https://vitejs.dev/guide/using-plugins.html)をご覧ください。
+
+#### レンダラーに関するViteの変更
+
+Astro v0.21+では、プラグインは`viteConfig()`を使用するようになりました。
+
+```diff
+// renderer-svelte/index.js
++ import { svelte } from '@sveltejs/vite-plugin-svelte';
+
+export default {
+  name: '@astrojs/renderer-svelte',
+  client: './client.js',
+  server: './server.js',
+-  snowpackPlugin: '@snowpack/plugin-svelte',
+-  snowpackPluginOptions: { compilerOptions: { hydratable: true } },
++  viteConfig() {
++    return {
++      optimizeDeps: {
++        include: ['@astrojs/renderer-svelte/client.js', 'svelte', 'svelte/internal'],
++        exclude: ['@astrojs/renderer-svelte/server.js'],
++      },
++      plugins: [
++        svelte({
++          emitCss: true,
++          compilerOptions: { hydratable: true },
++        }),
++      ],
++    };
++  },
+}
+```
+
+Viteプラグインの詳細については、Viteの[プラグインガイド](https://vitejs.dev/guide/using-plugins.html)をご覧ください。
+
+> 以前のリリースでは、これらは`snowpackPlugin`または`snowpackPluginOptions`で設定されていました。
+
+
+### エイリアス
+
+Astro v0.21+ では、インポートエイリアスを`tsconfig.json`または`jsconfig.json`から追加できるようになりました。
+
+```json
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/components/*": ["src/components/*"]
+    }
+  }
+}
+```
+
+_これらのエイリアスは、[VSCode](https://code.visualstudio.com/docs/languages/jsconfig)や他のエディタに自動的に統合されます_。
+
+### インポート時の拡張子
+
+Astro v0.21+では、ファイルはディスク上のものと同じ実際の拡張子で参照する必要があります。この例では、`Div.tsx`は`Div.jsx`ではなく`Div.tsx`として参照される必要があります。
+
+```diff
+- import Div from './Div.jsx' // Astro v0.20
++ import Div from './Div.tsx' // Astro v0.21
+```
+
+この変更は、`Div.scss`のようなコンパイル済みのCSSファイルにも同様に適用されます。
+
+```diff
+- <link rel="stylesheet" href={Astro.resolve('./Div.css')}>
++ <link rel="stylesheet" href={Astro.resolve('./Div.scss')}>
+```
+
+### 削除: front-matter内のコンポーネント
+
+以前は、Astroのコンポーネント構文ではなくJSX構文を使って、Astroのfront-matterの中にミニAstroコンポーネントを作成できました。これは常にちょっとしたハックでしたが、新しいコンパイラではサポートが不可能になりました。Astroの将来のリリースでは、JSXではない別のAPIを使用して、この機能を再導入したいと考えています。
+
+v0.21+に移行するには、すべてのJSX Astroコンポーネント（つまり、他のコンポーネントのfront-matter内に作成されたAstroコンポーネント）を独立したコンポーネントに変換してください。
+
+### スタイリングの変更
+
+#### Autoprefixer
+
+Autoprefixerは、デフォルトでは実行されなくなりました。有効にするには
+
+1. 最新版をインストールする。（`npm i autoprefixer`）
+2. プロジェクトルートに`postcss.config.cjs`ファイルを以下のように作成する。
+   ```js
+   module.exports = {
+     plugins: {
+       autoprefixer: {},
+     },
+   };
+   ```
+
+#### Tailwind CSS
+
+PostCSSがインストールされていることを確認します。これは以前のリリースではオプションでしたが、現在は必須です。
+
+1. 最新版のpostcssをインストールする(`npm i -D postcss`)
+2. プロジェクトのルートに以下のように`postcss.config.cjs`ファイルを作成する。
+   ```js
+   module.exports = {
+     plugins: {
+       tailwindcss: {},
+     },
+   };
+   ```
+   詳しくは、[Tailwind CSSドキュメント](https://tailwindcss.com/docs/installation#add-tailwind-as-a-post-css-plugin)をご覧ください。
+
+
+### 既知の問題
+
+#### トップでのインポート
+
+Astro v0.21+では、コンポーネント内のインポートがfront-matterの先頭になければならないバグがあります。
+
+```astro
+---
+import Component from '../components/Component.astro'
+const whereShouldIPutMyImports = "on top!"
+---
+```
+
+
+[vite]: https://vitejs.dev

From 00a052267df4bbb403791ccd0f187f58855852c7 Mon Sep 17 00:00:00 2001
From: Yosuke Ota <otameshiyo23@gmail.com>
Date: Fri, 3 Jun 2022 16:52:32 +0900
Subject: [PATCH 40/41] Use ESLint on .astro and .ts files (#710)

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
---
 .eslintignore                                 |    5 +
 .eslintrc.js                                  |   33 +
 package.json                                  |    9 +-
 pnpm-lock.yaml                                | 1012 +++++++++++------
 scripts/lib/linkcheck/base/base.ts            |    4 +-
 scripts/lib/linkcheck/checks/target-exists.ts |    2 +-
 scripts/lib/linkcheck/steps/find-issues.ts    |    4 +-
 scripts/lib/linkcheck/steps/output-issues.ts  |    2 +-
 src/components/Card.astro                     |    4 +-
 src/components/HeadCommon.astro               |    1 +
 src/components/LeftSidebar/LeftSidebar.astro  |    2 +-
 src/components/TabBox.astro                   |    2 +-
 src/pages/index.astro                         |    1 -
 13 files changed, 698 insertions(+), 383 deletions(-)
 create mode 100644 .eslintignore
 create mode 100644 .eslintrc.js

diff --git a/.eslintignore b/.eslintignore
new file mode 100644
index 0000000000000..e83b4b129913c
--- /dev/null
+++ b/.eslintignore
@@ -0,0 +1,5 @@
+dist
+node_modules
+.github
+.changeset
+/src/pages/lighthouse
diff --git a/.eslintrc.js b/.eslintrc.js
new file mode 100644
index 0000000000000..c86a4b4c4fb3e
--- /dev/null
+++ b/.eslintrc.js
@@ -0,0 +1,33 @@
+module.exports = {
+  env: {
+    node: true,
+    es2022: true,
+    browser: true,
+  },
+  extends: ['eslint:recommended', 'plugin:astro/recommended'],
+  parserOptions: {
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+  },
+  rules: {},
+  overrides: [
+    {
+      files: ["*.astro"],
+      parser: "astro-eslint-parser",
+      parserOptions: {
+        parser: "@typescript-eslint/parser",
+        extraFileExtensions: [".astro"],
+      },
+      rules: {},
+    },
+    {
+      files: ['*.ts'],
+      parser: '@typescript-eslint/parser',
+      extends: ['plugin:@typescript-eslint/recommended'],
+      rules: {
+        '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_', destructuredArrayIgnorePattern: '^_' }],
+        '@typescript-eslint/no-non-null-assertion': 'off',
+      },
+    },
+  ],
+};
diff --git a/package.json b/package.json
index 9dd635478950d..d1b13b0e6bc19 100644
--- a/package.json
+++ b/package.json
@@ -15,6 +15,7 @@
     "lint:linkcheck": "astro build && tsm --require=./scripts/lib/filter-warnings.cjs ./scripts/lint-linkcheck.ts",
     "lint:linkcheck:nobuild": "tsm --require=./scripts/lib/filter-warnings.cjs ./scripts/lint-linkcheck.ts",
     "lint:slugcheck": "node ./scripts/lint-slugcheck.mjs",
+    "lint:eslint": "eslint . --ext .js,.ts,.astro",
     "github:translation-status": "node ./scripts/github-translation-status.mjs"
   },
   "devDependencies": {
@@ -25,9 +26,14 @@
     "@astrojs/sitemap": "^0.1.0",
     "@babel/core": "^7.17.9",
     "@types/react": "^17.0.43",
+    "@typescript-eslint/eslint-plugin": "^5.27.0",
+    "@typescript-eslint/parser": "^5.27.0",
     "astro": "^1.0.0-beta.17",
+    "astro-eslint-parser": "^0.2.2",
     "bcp-47-normalize": "^2.1.0",
     "dedent-js": "^1.0.1",
+    "eslint": "^8.16.0",
+    "eslint-plugin-astro": "^0.8.1",
     "fast-glob": "^3.2.11",
     "htmlparser2": "^7.2.0",
     "kleur": "^4.1.4",
@@ -38,7 +44,8 @@
     "react": "^17.0.2",
     "react-dom": "^17.0.2",
     "simple-git": "^3.7.1",
-    "tsm": "^2.2.1"
+    "tsm": "^2.2.1",
+    "typescript": "^4.7.2"
   },
   "dependencies": {
     "@astropub/icons": "^0.2.0",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index f3c0017320cb0..626a9492a11e5 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -10,9 +10,14 @@ specifiers:
   '@babel/core': ^7.17.9
   '@docsearch/react': ^3.0.0
   '@types/react': ^17.0.43
+  '@typescript-eslint/eslint-plugin': ^5.27.0
+  '@typescript-eslint/parser': ^5.27.0
   astro: ^1.0.0-beta.17
+  astro-eslint-parser: ^0.2.2
   bcp-47-normalize: ^2.1.0
   dedent-js: ^1.0.1
+  eslint: ^8.16.0
+  eslint-plugin-astro: ^0.8.1
   fast-glob: ^3.2.11
   htmlparser2: ^7.2.0
   jsdoc-api: ^7.1.1
@@ -30,6 +35,7 @@ specifiers:
   sass: ^1.50.0
   simple-git: ^3.7.1
   tsm: ^2.2.1
+  typescript: ^4.7.2
 
 dependencies:
   '@astropub/icons': 0.2.0_astro@1.0.0-beta.17
@@ -49,9 +55,14 @@ devDependencies:
   '@astrojs/sitemap': 0.1.0
   '@babel/core': 7.17.9
   '@types/react': 17.0.43
+  '@typescript-eslint/eslint-plugin': 5.27.0_dszb5tb7atwkjjijmmov4qhi7i
+  '@typescript-eslint/parser': 5.27.0_xztl6dhthcahlo6akmb2bmjmle
   astro: 1.0.0-beta.17_sass@1.50.0
+  astro-eslint-parser: 0.2.2
   bcp-47-normalize: 2.1.0
   dedent-js: 1.0.1
+  eslint: 8.16.0
+  eslint-plugin-astro: 0.8.1_wtnyy2apyieggkncrmd6jlo5ja
   fast-glob: 3.2.11
   htmlparser2: 7.2.0
   kleur: 4.1.4
@@ -63,6 +74,7 @@ devDependencies:
   react-dom: 17.0.2_react@17.0.2
   simple-git: 3.7.1
   tsm: 2.2.1
+  typescript: 4.7.2
 
 packages:
 
@@ -111,7 +123,6 @@ packages:
 
   /@algolia/cache-common/4.13.0:
     resolution: {integrity: sha512-f9mdZjskCui/dA/fA/5a+6hZ7xnHaaZI5tM/Rw9X8rRB39SUlF/+o3P47onZ33n/AwkpSbi5QOyhs16wHd55kA==}
-    dev: true
 
   /@algolia/cache-in-memory/4.12.2:
     resolution: {integrity: sha512-opWpbBUloP1fcTG3wBDnAfcoyNXW5GFDgGtLXrSANdfnelPKkr3O8j01ZTkRlPIuBDR0izGZG8MVWMDlTf71Bw==}
@@ -148,7 +159,6 @@ packages:
     dependencies:
       '@algolia/requester-common': 4.13.0
       '@algolia/transporter': 4.13.0
-    dev: true
 
   /@algolia/client-personalization/4.12.2:
     resolution: {integrity: sha512-JBW3vYFGIm5sAAy3cLUdmUCpmSAdreo5S1fERg7xgF6KyxGrwyy5BViTNWrOKG+av2yusk1wKydOYJ1Fbpbaxw==}
@@ -172,7 +182,6 @@ packages:
       '@algolia/client-common': 4.13.0
       '@algolia/requester-common': 4.13.0
       '@algolia/transporter': 4.13.0
-    dev: true
 
   /@algolia/logger-common/4.12.2:
     resolution: {integrity: sha512-iOiJAymLjq137G7+8EQuUEkrgta0cZGMg6scp8s4hJ+X6k+6By4nyptdkCWYwKLsW/Xy927QcIhGlkWV78vQIQ==}
@@ -180,7 +189,6 @@ packages:
 
   /@algolia/logger-common/4.13.0:
     resolution: {integrity: sha512-8yqXk7rMtmQJ9wZiHOt/6d4/JDEg5VCk83gJ39I+X/pwUPzIsbKy9QiK4uJ3aJELKyoIiDT1hpYVt+5ia+94IA==}
-    dev: true
 
   /@algolia/logger-console/4.12.2:
     resolution: {integrity: sha512-veuQZyTSqHoHJtr9mLMnYeal9Mee6hCie4eqY+645VbeOrgT9p/kCMbKg5GLJGoLPlXGu7C0XpHyUj5k7/NQyw==}
@@ -200,7 +208,6 @@ packages:
 
   /@algolia/requester-common/4.13.0:
     resolution: {integrity: sha512-BRTDj53ecK+gn7ugukDWOOcBRul59C4NblCHqj4Zm5msd5UnHFjd/sGX+RLOEoFMhetILAnmg6wMrRrQVac9vw==}
-    dev: true
 
   /@algolia/requester-node-http/4.12.2:
     resolution: {integrity: sha512-UXfJNZt2KMwjBjiOa3cJ/PyoXWZa/F1vy6rdyG4xQeZDcLbqKP3O2b+bOJcGPmFbmdwBhtAyMVLt+hvAvAVfOw==}
@@ -222,20 +229,24 @@ packages:
       '@algolia/cache-common': 4.13.0
       '@algolia/logger-common': 4.13.0
       '@algolia/requester-common': 4.13.0
-    dev: true
 
   /@ampproject/remapping/2.1.2:
     resolution: {integrity: sha512-hoyByceqwKirw7w3Z7gnIIZC3Wx3J484Y3L/cMpXFbr7d9ZQj2mODrirNzcJa+SM3UlpWXYvKV4RlRpFXlWgXg==}
     engines: {node: '>=6.0.0'}
     dependencies:
       '@jridgewell/trace-mapping': 0.3.4
-    dev: true
 
   /@astrojs/compiler/0.14.2:
     resolution: {integrity: sha512-kLj3iWkzPNk9TXWDY7bqGXRQ0XZbpwJNulQ7WrJCdv2zre7TG0E51x5ab8tCsiiTRZ2xORHuIz+gH2qFotXrKw==}
     dependencies:
       tsm: 2.2.1
       uvu: 0.5.3
+
+  /@astrojs/compiler/0.15.2:
+    resolution: {integrity: sha512-YsxIyx026zPWbxv3wYrudr1jh8u6oSnhP6MW+9OAgiFuICHjSX4Rw+qm8wJj1D5IkJ3HsDtE+kFMMYIozZ5bvQ==}
+    dependencies:
+      tsm: 2.2.1
+      uvu: 0.5.3
     dev: true
 
   /@astrojs/language-server/0.13.4:
@@ -254,7 +265,6 @@ packages:
       vscode-languageserver-textdocument: 1.0.4
       vscode-languageserver-types: 3.16.0
       vscode-uri: 3.0.3
-    dev: true
 
   /@astrojs/markdown-remark/0.9.2:
     resolution: {integrity: sha512-0yOV1ucOvDyA9Bg1Rs56Zfe8EGtPxBfMReUQTAW/1hLZgIu8WgTCHuTRRT/z7UkjJHX8TiT9XMsUtBOI20cYWQ==}
@@ -280,7 +290,6 @@ packages:
       unist-util-visit: 4.1.0
     transitivePeerDependencies:
       - supports-color
-    dev: true
 
   /@astrojs/preact/0.0.2_4aogvlozmxuufv32kpculfbxce:
     resolution: {integrity: sha512-rpmQ+nffweQFQQnuSf6tGT8RDVzYURSve8R/fuuf02P0fTU7ZoqBzfG+BlQsAzkqJU8L9BHsnyRJOUoETrfK8w==}
@@ -298,7 +307,6 @@ packages:
   /@astrojs/prism/0.4.1:
     resolution: {integrity: sha512-JxkrXFiFhfunOFBI2Xxwru9t4IzrLw+nfA7RkNnV8qP65BLidrwWS+NfZhOSVGTrbf+cQfF8QNe6O4gAX8wQHw==}
     engines: {node: ^14.15.0 || >=16.0.0}
-    dev: true
 
   /@astrojs/react/0.1.0_6nyponiwjib2clhkbtejle6l5y:
     resolution: {integrity: sha512-WWowT/TsrV5iiBuUstUdm2fBzDkL8EJt5B71xgEEC8OUcLonSD9+cHohVtbgOrNKHqEpm3Shoxx9GrjhK9tZPg==}
@@ -327,11 +335,9 @@ packages:
       svelte2tsx: 0.5.7_liohzkyisnst3glff4denqdl5m
     transitivePeerDependencies:
       - typescript
-    dev: true
 
   /@astrojs/webapi/0.11.1:
     resolution: {integrity: sha512-pZXhYWz1C4dOAznnO1Qst58O+iZfkzn5QypiH4xHVl5GU9gkbq/mAJ/wZ34127GayF4AnCZO37DMlTOLR4fBAQ==}
-    dev: true
 
   /@astropub/icons/0.2.0_astro@1.0.0-beta.17:
     resolution: {integrity: sha512-qM/ldW/9rVHULNOZgz/23Yzgm2r3Iy2JJ1FuvJB6sFU67n61o1ImuXdHiaWSNoEHubD+IUkD9WG0hbhINgszqA==}
@@ -346,12 +352,10 @@ packages:
     engines: {node: '>=6.9.0'}
     dependencies:
       '@babel/highlight': 7.17.9
-    dev: true
 
   /@babel/compat-data/7.17.7:
     resolution: {integrity: sha512-p8pdE6j0a29TNGebNm7NzYZWB3xVZJBZ7XGs42uAKzQo8VQ3F0By/cQCtUEABwIqw5zo6WA4NbmxsfzADzMKnQ==}
     engines: {node: '>=6.9.0'}
-    dev: true
 
   /@babel/core/7.17.9:
     resolution: {integrity: sha512-5ug+SfZCpDAkVp9SFIZAzlW18rlzsOcJGaetCjkySnrXXDUw9AR8cDUm1iByTmdWM6yxX6/zycaV76w3YTF2gw==}
@@ -374,7 +378,6 @@ packages:
       semver: 6.3.0
     transitivePeerDependencies:
       - supports-color
-    dev: true
 
   /@babel/generator/7.17.9:
     resolution: {integrity: sha512-rAdDousTwxbIxbz5I7GEQ3lUip+xVCXooZNbsydCWs3xA7ZsYOv+CFRdzGxRX78BmQHu9B1Eso59AOZQOJDEdQ==}
@@ -383,7 +386,6 @@ packages:
       '@babel/types': 7.17.0
       jsesc: 2.5.2
       source-map: 0.5.7
-    dev: true
 
   /@babel/helper-annotate-as-pure/7.16.7:
     resolution: {integrity: sha512-s6t2w/IPQVTAET1HitoowRGXooX8mCgtuP5195wD/QJPV6wYjpujCGF7JuMODVX2ZAJOf1GT6DT9MHEZvLOFSw==}
@@ -403,14 +405,12 @@ packages:
       '@babel/helper-validator-option': 7.16.7
       browserslist: 4.20.2
       semver: 6.3.0
-    dev: true
 
   /@babel/helper-environment-visitor/7.16.7:
     resolution: {integrity: sha512-SLLb0AAn6PkUeAfKJCCOl9e1R53pQlGAfc4y4XuMRZfqeMYLE0dM1LMhqbGAlGQY0lfw5/ohoYWAe9V1yibRag==}
     engines: {node: '>=6.9.0'}
     dependencies:
       '@babel/types': 7.17.0
-    dev: true
 
   /@babel/helper-function-name/7.17.9:
     resolution: {integrity: sha512-7cRisGlVtiVqZ0MW0/yFB4atgpGLWEHUVYnb448hZK4x+vih0YO5UoS11XIYtZYqHd0dIPMdUSv8q5K4LdMnIg==}
@@ -418,21 +418,18 @@ packages:
     dependencies:
       '@babel/template': 7.16.7
       '@babel/types': 7.17.0
-    dev: true
 
   /@babel/helper-hoist-variables/7.16.7:
     resolution: {integrity: sha512-m04d/0Op34H5v7pbZw6pSKP7weA6lsMvfiIAMeIvkY/R4xQtBSMFEigu9QTZ2qB/9l22vsxtM8a+Q8CzD255fg==}
     engines: {node: '>=6.9.0'}
     dependencies:
       '@babel/types': 7.17.0
-    dev: true
 
   /@babel/helper-module-imports/7.16.7:
     resolution: {integrity: sha512-LVtS6TqjJHFc+nYeITRo6VLXve70xmq7wPhWTqDJusJEgGmkAACWwMiTNrvfoQo6hEhFwAIixNkvB0jPXDL8Wg==}
     engines: {node: '>=6.9.0'}
     dependencies:
       '@babel/types': 7.17.0
-    dev: true
 
   /@babel/helper-module-transforms/7.17.7:
     resolution: {integrity: sha512-VmZD99F3gNTYB7fJRDTi+u6l/zxY0BE6OIxPSU7a50s6ZUQkHwSDmV92FfM+oCG0pZRVojGYhkR8I0OGeCVREw==}
@@ -448,7 +445,6 @@ packages:
       '@babel/types': 7.17.0
     transitivePeerDependencies:
       - supports-color
-    dev: true
 
   /@babel/helper-plugin-utils/7.16.7:
     resolution: {integrity: sha512-Qg3Nk7ZxpgMrsox6HreY1ZNKdBq7K72tDSliA6dCl5f007jR4ne8iD5UzuNnCJH2xBf2BEEVGr+/OL6Gdp7RxA==}
@@ -460,14 +456,12 @@ packages:
     engines: {node: '>=6.9.0'}
     dependencies:
       '@babel/types': 7.17.0
-    dev: true
 
   /@babel/helper-split-export-declaration/7.16.7:
     resolution: {integrity: sha512-xbWoy/PFoxSWazIToT9Sif+jJTlrMcndIsaOKvTA6u7QEo7ilkRZpjew18/W3c7nm8fXdUDXh02VXTbZ0pGDNw==}
     engines: {node: '>=6.9.0'}
     dependencies:
       '@babel/types': 7.17.0
-    dev: true
 
   /@babel/helper-validator-identifier/7.16.7:
     resolution: {integrity: sha512-hsEnFemeiW4D08A5gUAZxLBTXpZ39P+a+DGDsHw1yxqyQ/jzFEnxf5uTEGp+3bzAbNOxU1paTgYS4ECU/IgfDw==}
@@ -476,7 +470,6 @@ packages:
   /@babel/helper-validator-option/7.16.7:
     resolution: {integrity: sha512-TRtenOuRUVo9oIQGPC5G9DgK4743cdxvtOw0weQNpZXaS16SCBi5MNjZF8vba3ETURjZpTbVn7Vvcf2eAwFozQ==}
     engines: {node: '>=6.9.0'}
-    dev: true
 
   /@babel/helpers/7.17.9:
     resolution: {integrity: sha512-cPCt915ShDWUEzEp3+UNRktO2n6v49l5RSnG9M5pS24hA+2FAc5si+Pn1i4VVbQQ+jh+bIZhPFQOJOzbrOYY1Q==}
@@ -487,7 +480,6 @@ packages:
       '@babel/types': 7.17.0
     transitivePeerDependencies:
       - supports-color
-    dev: true
 
   /@babel/highlight/7.17.9:
     resolution: {integrity: sha512-J9PfEKCbFIv2X5bjTMiZu6Vf341N05QIY+d6FvVKynkG1S7G0j3I0QoRtWIrXhZ+/Nlb5Q0MzqL7TokEJ5BNHg==}
@@ -496,7 +488,6 @@ packages:
       '@babel/helper-validator-identifier': 7.16.7
       chalk: 2.4.2
       js-tokens: 4.0.0
-    dev: true
 
   /@babel/parser/7.17.8:
     resolution: {integrity: sha512-BoHhDJrJXqcg+ZL16Xv39H9n+AqJ4pcDrQBGZN+wHxIysrLZ3/ECwCBUch/1zUNhnsXULcONU3Ei5Hmkfk6kiQ==}
@@ -512,7 +503,6 @@ packages:
     hasBin: true
     dependencies:
       '@babel/types': 7.17.0
-    dev: true
 
   /@babel/plugin-syntax-jsx/7.16.7_@babel+core@7.17.9:
     resolution: {integrity: sha512-Esxmk7YjA8QysKeT3VhTXvF6y77f/a91SIs4pWb4H2eWGQkCKFgQaG6hdoEVZtGsrAcb2K5BW66XsOErD4WU3Q==}
@@ -545,7 +535,6 @@ packages:
       '@babel/code-frame': 7.16.7
       '@babel/parser': 7.17.9
       '@babel/types': 7.17.0
-    dev: true
 
   /@babel/traverse/7.17.9:
     resolution: {integrity: sha512-PQO8sDIJ8SIwipTPiR71kJQCKQYB5NGImbOviK8K+kg5xkNSYXLBupuX9QhatFowrsvo9Hj8WgArg3W7ijNAQw==}
@@ -563,7 +552,6 @@ packages:
       globals: 11.12.0
     transitivePeerDependencies:
       - supports-color
-    dev: true
 
   /@babel/types/7.17.0:
     resolution: {integrity: sha512-TmKSNO4D5rzhL5bjWFcVHHLETzfQ/AmbKpKPOSjlP0WoHZ6L911fgoOKY4Alp/emzG4cHJdyN49zpgkbXFEHHw==}
@@ -598,33 +586,59 @@ packages:
     resolution: {integrity: sha512-87pltuCPt99aL+y9xS6GPZ+Wmmyhll2WXH73gG/xpGcQ84DRnptBsI2r0BeIQ0EB/SQTOe2ANPqFqj3Rj5FOGA==}
     dependencies:
       '@emmetio/scanner': 1.0.0
-    dev: true
 
   /@emmetio/css-abbreviation/2.1.4:
     resolution: {integrity: sha512-qk9L60Y+uRtM5CPbB0y+QNl/1XKE09mSO+AhhSauIfr2YOx/ta3NJw2d8RtCFxgzHeRqFRr8jgyzThbu+MZ4Uw==}
     dependencies:
       '@emmetio/scanner': 1.0.0
-    dev: true
 
   /@emmetio/scanner/1.0.0:
     resolution: {integrity: sha512-8HqW8EVqjnCmWXVpqAOZf+EGESdkR27odcMMMGefgKXtar00SoYNSryGv//TELI4T3QFsECo78p+0lmalk/CFA==}
+
+  /@eslint/eslintrc/1.3.0:
+    resolution: {integrity: sha512-UWW0TMTmk2d7hLcWD1/e2g5HDM/HQ3csaLSqXCfqwh4uNDuNqlaKWXmEsL4Cs41Z0KnILNvwbHAah3C2yt06kw==}
+    engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+    dependencies:
+      ajv: 6.12.6
+      debug: 4.3.4
+      espree: 9.3.2
+      globals: 13.15.0
+      ignore: 5.2.0
+      import-fresh: 3.3.0
+      js-yaml: 4.1.0
+      minimatch: 3.1.2
+      strip-json-comments: 3.1.1
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /@humanwhocodes/config-array/0.9.5:
+    resolution: {integrity: sha512-ObyMyWxZiCu/yTisA7uzx81s40xR2fD5Cg/2Kq7G02ajkNubJf6BopgDTmDyc3U7sXpNKM8cYOw7s7Tyr+DnCw==}
+    engines: {node: '>=10.10.0'}
+    dependencies:
+      '@humanwhocodes/object-schema': 1.2.1
+      debug: 4.3.4
+      minimatch: 3.1.2
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /@humanwhocodes/object-schema/1.2.1:
+    resolution: {integrity: sha512-ZnQMnLV4e7hDlUvw8H+U8ASL02SS2Gn6+9Ac3wGGLIe7+je2AeAOxPY+izIPJDfFDb7eDjev0Us8MO1iFRN8hA==}
     dev: true
 
   /@jridgewell/resolve-uri/3.0.5:
     resolution: {integrity: sha512-VPeQ7+wH0itvQxnG+lIzWgkysKIr3L9sslimFW55rHMdGu/qCQ5z5h9zq4gI8uBtqkpHhsF4Z/OwExufUCThew==}
     engines: {node: '>=6.0.0'}
-    dev: true
 
   /@jridgewell/sourcemap-codec/1.4.11:
     resolution: {integrity: sha512-Fg32GrJo61m+VqYSdRSjRXMjQ06j8YIYfcTqndLYVAaHmroZHLJZCydsWBOTDqXS2v+mjxohBWEMfg97GXmYQg==}
-    dev: true
 
   /@jridgewell/trace-mapping/0.3.4:
     resolution: {integrity: sha512-vFv9ttIedivx0ux3QSjhgtCVjPZd5l46ZOMDSCwnH1yUO2e964gO8LZGyv2QkqcgR6TnBU1v+1IFqmeoG+0UJQ==}
     dependencies:
       '@jridgewell/resolve-uri': 3.0.5
       '@jridgewell/sourcemap-codec': 1.4.11
-    dev: true
 
   /@kwsites/file-exists/1.1.1:
     resolution: {integrity: sha512-m9/5YGR18lIwxSFDwfE3oA7bWuq9kdau6ugN4H2rJeyhFQZcG9AgSHkQtSD15a8WvTgfz9aikZMrKPHvbpqFiw==}
@@ -640,7 +654,6 @@ packages:
 
   /@ljharb/has-package-exports-patterns/0.0.2:
     resolution: {integrity: sha512-4/RWEeXDO6bocPONheFe6gX/oQdP/bEpv0oL4HqjPP5DCenBSt0mHgahppY49N0CpsaqffdwPq+TlX9CYOq2Dw==}
-    dev: true
 
   /@nodelib/fs.scandir/2.1.5:
     resolution: {integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==}
@@ -648,12 +661,10 @@ packages:
     dependencies:
       '@nodelib/fs.stat': 2.0.5
       run-parallel: 1.2.0
-    dev: true
 
   /@nodelib/fs.stat/2.0.5:
     resolution: {integrity: sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==}
     engines: {node: '>= 8'}
-    dev: true
 
   /@nodelib/fs.walk/1.2.8:
     resolution: {integrity: sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==}
@@ -661,18 +672,27 @@ packages:
     dependencies:
       '@nodelib/fs.scandir': 2.1.5
       fastq: 1.13.0
+
+  /@pkgr/utils/2.2.0:
+    resolution: {integrity: sha512-/+EeY/T/NLCfF4rvgUetl7ERNwoPz5q/p+8CYeAIFblsKSQbVJjmMccs/Y7CsOPv47hXcBrhk5IqOf9AqRNfhg==}
+    engines: {node: '>=12'}
+    dependencies:
+      cross-spawn: 7.0.3
+      is-glob: 4.0.3
+      open: 8.4.0
+      picocolors: 1.0.0
+      tiny-glob: 0.2.9
+      tslib: 2.4.0
     dev: true
 
   /@polka/url/1.0.0-next.21:
     resolution: {integrity: sha512-a5Sab1C4/icpTZVzZc5Ghpz88yQtGOyNqYXcZgOssB2uuAr+wF/MvN6bgtW32q7HHrvBki+BsZ0OuNv6EV3K9g==}
-    dev: true
 
   /@proload/core/0.2.2:
     resolution: {integrity: sha512-HYQEblYXIpW77kvGyW4penEl9D9e9MouPhTqVaDz9+QVFliYjsq18inTfnfTa81s3oraPVtTk60tqCWOf2fKGQ==}
     dependencies:
       deepmerge: 4.2.2
       escalade: 3.1.1
-    dev: true
 
   /@proload/plugin-tsm/0.1.1_@proload+core@0.2.2:
     resolution: {integrity: sha512-qfGegg6I3YBCZDjYR9xb41MTc2EfL0sQQmw49Z/yi9OstIpUa/67MBy4AuNhoyG9FuOXia9gPoeBk5pGnBOGtA==}
@@ -681,13 +701,11 @@ packages:
     dependencies:
       '@proload/core': 0.2.2
       tsm: 2.2.1
-    dev: true
 
   /@types/acorn/4.0.6:
     resolution: {integrity: sha512-veQTnWP+1D/xbxVrPC3zHnCZRjSrKfhbMUlEA43iMZLu7EsnTtkJklIuwrCPbOi8YkvDQAiW05VQQFvvz9oieQ==}
     dependencies:
       '@types/estree': 0.0.51
-    dev: true
 
   /@types/debug/4.1.7:
     resolution: {integrity: sha512-9AonUzyTjXXhEOa0DnqpzZi6VHlqKMswga9EXjpXnnqxwLtdvPPtlO8evrI5D9S6asFRCQ6v+wpiUKbw+vKqyg==}
@@ -698,24 +716,24 @@ packages:
     resolution: {integrity: sha512-gcLAYiMfQklDCPjQegGn0TBAn9it05ISEsEhlKQUddIk7o2XDokOcTN7HBO8tznM0D9dGezvHEfRZBfZf6me0A==}
     dependencies:
       '@types/estree': 0.0.51
-    dev: true
 
   /@types/estree/0.0.50:
     resolution: {integrity: sha512-C6N5s2ZFtuZRj54k2/zyRhNDjJwwcViAM3Nbm8zjBpbqAdZ00mr0CFxvSKeO8Y/e03WVFLpQMdHYVfUd6SB+Hw==}
-    dev: true
 
   /@types/estree/0.0.51:
     resolution: {integrity: sha512-CuPgU6f3eT/XgKKPqKd/gLZV1Xmvf1a2R5POBOGQa6uv82xpls89HU5zKeVoyR8XzHd1RGNOlQlvUe3CFkjWNQ==}
-    dev: true
 
   /@types/hast/2.3.4:
     resolution: {integrity: sha512-wLEm0QvaoawEDoTRwzTXp4b4jpwiJDvR5KMnFnVodm3scufTlBOWRD6N1OBf9TZMhjlNsSfcO5V+7AF4+Vy+9g==}
     dependencies:
       '@types/unist': 2.0.6
 
+  /@types/json-schema/7.0.11:
+    resolution: {integrity: sha512-wOuvG1SN4Us4rez+tylwwwCV1psiNVOkJeM3AUWUNWg/jDQY2+HE/444y5gc+jBmRqASOm2Oeh5c1axHobwRKQ==}
+    dev: true
+
   /@types/json5/0.0.30:
     resolution: {integrity: sha512-sqm9g7mHlPY/43fcSNrCYfOeX9zkTTK+euO5E6+CVijSMm5tTjkVdwdqRkY3ljjIAf8679vps5jKUoJBCLsMDA==}
-    dev: true
 
   /@types/linkify-it/3.0.2:
     resolution: {integrity: sha512-HZQYqbiFVWufzCwexrvh694SOim8z2d+xJl5UNamcvQFejLY/2YUtzXHYi3cHdI7PMlS8ejH2slRAOJQ32aNbA==}
@@ -750,11 +768,9 @@ packages:
 
   /@types/parse5/6.0.3:
     resolution: {integrity: sha512-SuT16Q1K51EAVPz1K29DJ/sXjhSQ0zjvsypYJ6tlwVsRV9jwW5Adq2ch8Dq8kDBCkYnELS7N7VNCSB5nC56t/g==}
-    dev: true
 
   /@types/prop-types/15.7.4:
     resolution: {integrity: sha512-rZ5drC/jWjrArrS8BR6SIr4cWpW09RNTYt9AMZo3Jwwif+iacXAqgVjm0B0Bv/S1jhDXKHqRVNCbACkJ89RAnQ==}
-    dev: true
 
   /@types/react/17.0.43:
     resolution: {integrity: sha512-8Q+LNpdxf057brvPu1lMtC5Vn7J119xrP1aq4qiaefNioQUYANF/CYeK4NsKorSZyUGJ66g0IM+4bbjwx45o2A==}
@@ -762,11 +778,9 @@ packages:
       '@types/prop-types': 15.7.4
       '@types/scheduler': 0.16.2
       csstype: 3.0.11
-    dev: true
 
   /@types/resolve/1.20.1:
     resolution: {integrity: sha512-Ku5+GPFa12S3W26Uwtw+xyrtIpaZsGYHH6zxNbZlstmlvMYSZRzOwzwsXbxlVUbHyUucctSyuFtu6bNxwYomIw==}
-    dev: true
 
   /@types/sax/1.2.4:
     resolution: {integrity: sha512-pSAff4IAxJjfAXUG6tFkO7dsSbTmf8CtUpfhhZ5VhkRpC4628tJhh3+V6H1E+/Gs9piSzYKT5yzHO5M4GG9jkw==}
@@ -776,11 +790,136 @@ packages:
 
   /@types/scheduler/0.16.2:
     resolution: {integrity: sha512-hppQEBDmlwhFAXKJX2KnWLYu5yMfi91yazPb2l+lbJiwW+wdo1gNeRA+3RgNSO39WYX2euey41KEwnqesU2Jew==}
-    dev: true
 
   /@types/unist/2.0.6:
     resolution: {integrity: sha512-PBjIUxZHOuj0R15/xuwJYjFi+KZdNFrehocChv4g5hu6aFroHue8m0lBP0POdK2nKzbw0cgV1mws8+V/JAcEkQ==}
 
+  /@typescript-eslint/eslint-plugin/5.27.0_dszb5tb7atwkjjijmmov4qhi7i:
+    resolution: {integrity: sha512-DDrIA7GXtmHXr1VCcx9HivA39eprYBIFxbQEHI6NyraRDxCGpxAFiYQAT/1Y0vh1C+o2vfBiy4IuPoXxtTZCAQ==}
+    engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+    peerDependencies:
+      '@typescript-eslint/parser': ^5.0.0
+      eslint: ^6.0.0 || ^7.0.0 || ^8.0.0
+      typescript: '*'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+    dependencies:
+      '@typescript-eslint/parser': 5.27.0_xztl6dhthcahlo6akmb2bmjmle
+      '@typescript-eslint/scope-manager': 5.27.0
+      '@typescript-eslint/type-utils': 5.27.0_xztl6dhthcahlo6akmb2bmjmle
+      '@typescript-eslint/utils': 5.27.0_xztl6dhthcahlo6akmb2bmjmle
+      debug: 4.3.4
+      eslint: 8.16.0
+      functional-red-black-tree: 1.0.1
+      ignore: 5.2.0
+      regexpp: 3.2.0
+      semver: 7.3.7
+      tsutils: 3.21.0_typescript@4.7.2
+      typescript: 4.7.2
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /@typescript-eslint/parser/5.27.0_xztl6dhthcahlo6akmb2bmjmle:
+    resolution: {integrity: sha512-8oGjQF46c52l7fMiPPvX4It3u3V3JipssqDfHQ2hcR0AeR8Zge+OYyKUCm5b70X72N1qXt0qgHenwN6Gc2SXZA==}
+    engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+    peerDependencies:
+      eslint: ^6.0.0 || ^7.0.0 || ^8.0.0
+      typescript: '*'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+    dependencies:
+      '@typescript-eslint/scope-manager': 5.27.0
+      '@typescript-eslint/types': 5.27.0
+      '@typescript-eslint/typescript-estree': 5.27.0_typescript@4.7.2
+      debug: 4.3.4
+      eslint: 8.16.0
+      typescript: 4.7.2
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /@typescript-eslint/scope-manager/5.27.0:
+    resolution: {integrity: sha512-VnykheBQ/sHd1Vt0LJ1JLrMH1GzHO+SzX6VTXuStISIsvRiurue/eRkTqSrG0CexHQgKG8shyJfR4o5VYioB9g==}
+    engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+    dependencies:
+      '@typescript-eslint/types': 5.27.0
+      '@typescript-eslint/visitor-keys': 5.27.0
+    dev: true
+
+  /@typescript-eslint/type-utils/5.27.0_xztl6dhthcahlo6akmb2bmjmle:
+    resolution: {integrity: sha512-vpTvRRchaf628Hb/Xzfek+85o//zEUotr1SmexKvTfs7czXfYjXVT/a5yDbpzLBX1rhbqxjDdr1Gyo0x1Fc64g==}
+    engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+    peerDependencies:
+      eslint: '*'
+      typescript: '*'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+    dependencies:
+      '@typescript-eslint/utils': 5.27.0_xztl6dhthcahlo6akmb2bmjmle
+      debug: 4.3.4
+      eslint: 8.16.0
+      tsutils: 3.21.0_typescript@4.7.2
+      typescript: 4.7.2
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /@typescript-eslint/types/5.27.0:
+    resolution: {integrity: sha512-lY6C7oGm9a/GWhmUDOs3xAVRz4ty/XKlQ2fOLr8GAIryGn0+UBOoJDWyHer3UgrHkenorwvBnphhP+zPmzmw0A==}
+    engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+    dev: true
+
+  /@typescript-eslint/typescript-estree/5.27.0_typescript@4.7.2:
+    resolution: {integrity: sha512-QywPMFvgZ+MHSLRofLI7BDL+UczFFHyj0vF5ibeChDAJgdTV8k4xgEwF0geFhVlPc1p8r70eYewzpo6ps+9LJQ==}
+    engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+    peerDependencies:
+      typescript: '*'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+    dependencies:
+      '@typescript-eslint/types': 5.27.0
+      '@typescript-eslint/visitor-keys': 5.27.0
+      debug: 4.3.4
+      globby: 11.1.0
+      is-glob: 4.0.3
+      semver: 7.3.7
+      tsutils: 3.21.0_typescript@4.7.2
+      typescript: 4.7.2
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /@typescript-eslint/utils/5.27.0_xztl6dhthcahlo6akmb2bmjmle:
+    resolution: {integrity: sha512-nZvCrkIJppym7cIbP3pOwIkAefXOmfGPnCM0LQfzNaKxJHI6VjI8NC662uoiPlaf5f6ymkTy9C3NQXev2mdXmA==}
+    engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+    peerDependencies:
+      eslint: ^6.0.0 || ^7.0.0 || ^8.0.0
+    dependencies:
+      '@types/json-schema': 7.0.11
+      '@typescript-eslint/scope-manager': 5.27.0
+      '@typescript-eslint/types': 5.27.0
+      '@typescript-eslint/typescript-estree': 5.27.0_typescript@4.7.2
+      eslint: 8.16.0
+      eslint-scope: 5.1.1
+      eslint-utils: 3.0.0_eslint@8.16.0
+    transitivePeerDependencies:
+      - supports-color
+      - typescript
+    dev: true
+
+  /@typescript-eslint/visitor-keys/5.27.0:
+    resolution: {integrity: sha512-46cYrteA2MrIAjv9ai44OQDUoCZyHeGIc4lsjCUX2WT6r4C+kidz1bNiR4017wHOPUythYeH+Sc7/cFP97KEAA==}
+    engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+    dependencies:
+      '@typescript-eslint/types': 5.27.0
+      eslint-visitor-keys: 3.3.0
+    dev: true
+
   /@vscode/emmet-helper/2.8.4:
     resolution: {integrity: sha512-lUki5QLS47bz/U8IlG9VQ+1lfxMtxMZENmU5nu4Z71eOD5j9FK0SmYGL5NiVJg9WBWeAU0VxRADMY2Qpq7BfVg==}
     dependencies:
@@ -790,6 +929,28 @@ packages:
       vscode-languageserver-types: 3.16.0
       vscode-nls: 5.0.0
       vscode-uri: 2.1.2
+
+  /acorn-jsx/5.3.2_acorn@8.7.1:
+    resolution: {integrity: sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==}
+    peerDependencies:
+      acorn: ^6.0.0 || ^7.0.0 || ^8.0.0
+    dependencies:
+      acorn: 8.7.1
+    dev: true
+
+  /acorn/8.7.1:
+    resolution: {integrity: sha512-Xx54uLJQZ19lKygFXOWsscKUbsBZW0CPykPhVQdhIeIwrbPmJzqeASDInc8nKBnp/JT6igTs82qPXz069H8I/A==}
+    engines: {node: '>=0.4.0'}
+    hasBin: true
+    dev: true
+
+  /ajv/6.12.6:
+    resolution: {integrity: sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==}
+    dependencies:
+      fast-deep-equal: 3.1.3
+      fast-json-stable-stringify: 2.1.0
+      json-schema-traverse: 0.4.1
+      uri-js: 4.4.1
     dev: true
 
   /algoliasearch/4.12.2:
@@ -815,36 +976,30 @@ packages:
     resolution: {integrity: sha512-IOfwwBF5iczOjp/WeY4YxyjqAFMQoZufdQWDd19SEExbVLNXqvpzSJ/M7Za4/sCPmQ0+GRquoA7bGcINcxew6w==}
     dependencies:
       string-width: 4.2.3
-    dev: true
 
   /ansi-regex/5.0.1:
     resolution: {integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==}
     engines: {node: '>=8'}
-    dev: true
 
   /ansi-regex/6.0.1:
     resolution: {integrity: sha512-n5M855fKb2SsfMIiFFoVrABHJC8QtHwVx+mHWP3QcEqBHYienj5dHSgjbxtC0WEZXYt4wcD6zrQElDPhFuZgfA==}
     engines: {node: '>=12'}
-    dev: true
 
   /ansi-styles/3.2.1:
     resolution: {integrity: sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==}
     engines: {node: '>=4'}
     dependencies:
       color-convert: 1.9.3
-    dev: true
 
   /ansi-styles/4.3.0:
     resolution: {integrity: sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==}
     engines: {node: '>=8'}
     dependencies:
       color-convert: 2.0.1
-    dev: true
 
   /ansi-styles/6.1.0:
     resolution: {integrity: sha512-VbqNsoz55SYGczauuup0MFUyXNQviSpFTj1RQtFzmQLk18qbVSpTFFGMT293rmDaQuKCT6InmbuEyUne4mTuxQ==}
     engines: {node: '>=12'}
-    dev: true
 
   /anymatch/3.1.2:
     resolution: {integrity: sha512-P43ePfOAIupkguHUycrc4qJ9kz8ZiuOUijaETwX7THt0Y/GNK7v0aa8rY816xWjZ7rJdA5XdMcpVFTKMq+RvWg==}
@@ -852,7 +1007,6 @@ packages:
     dependencies:
       normalize-path: 3.0.0
       picomatch: 2.3.1
-    dev: false
 
   /arg/5.0.1:
     resolution: {integrity: sha512-e0hDa9H2Z9AwFkk2qDlwhoMYE4eToKarchkQHovNdLTCYMHZHeRjI71crOh+dio4K6u1IcwubQqo79Ga4CyAQA==}
@@ -862,11 +1016,9 @@ packages:
     resolution: {integrity: sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==}
     dependencies:
       sprintf-js: 1.0.3
-    dev: true
 
   /argparse/2.0.1:
     resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==}
-    dev: false
 
   /array-back/1.0.4:
     resolution: {integrity: sha1-ZEun8JX3/898Q7Xw3DnTwfA8Bjs=}
@@ -893,6 +1045,11 @@ packages:
   /array-iterate/1.1.4:
     resolution: {integrity: sha512-sNRaPGh9nnmdC8Zf+pT3UqP8rnWj5Hf9wiFGsX3wUQ2yVSIhO2ShFwCoceIPpB41QF6i2OEmrHmCo36xronCVA==}
 
+  /array-union/2.1.0:
+    resolution: {integrity: sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==}
+    engines: {node: '>=8'}
+    dev: true
+
   /assert/2.0.0:
     resolution: {integrity: sha512-se5Cd+js9dXJnu6Ag2JFc00t+HmHOen+8Q+L7O9zI0PqQXr20uk2J0XQqMxZEeo5U50o8Nvmmx7dZrl+Ufr35A==}
     dependencies:
@@ -900,13 +1057,25 @@ packages:
       is-nan: 1.3.2
       object-is: 1.1.5
       util: 0.12.4
-    dev: true
 
   /ast-types/0.14.2:
     resolution: {integrity: sha512-O0yuUDnZeQDL+ncNGlJ78BiO4jnYI3bvMsD5prT0/nsgijG/LpNBIr63gTjVTNsiGkgQhiyCShTgxt8oXOrklA==}
     engines: {node: '>=4'}
     dependencies:
       tslib: 2.3.1
+
+  /astro-eslint-parser/0.2.2:
+    resolution: {integrity: sha512-/b5kFxGN+e/YmRfilRF4YfgDqXC98mFlUxz+Ir2WlB2eL2yGXoSq/AJCGjvj5roJ5IsgQjPxfmvmIAGgCpfFTw==}
+    engines: {node: ^14.17.0 || >=16.0.0}
+    dependencies:
+      '@astrojs/compiler': 0.15.2
+      '@typescript-eslint/types': 5.27.0
+      debug: 4.3.4
+      eslint-visitor-keys: 3.3.0
+      espree: 9.3.2
+      synckit: 0.7.1
+    transitivePeerDependencies:
+      - supports-color
     dev: true
 
   /astro/1.0.0-beta.17_sass@1.50.0:
@@ -978,23 +1147,19 @@ packages:
       - stylus
       - supports-color
       - ts-node
-    dev: true
 
   /available-typed-arrays/1.0.5:
     resolution: {integrity: sha512-DMD0KiN46eipeziST1LPP/STfDU0sufISXmjSgvVsoU2tqxctQeASejWcfNtxYKqETM1UxQ8sp2OrSBWpHY6sw==}
     engines: {node: '>= 0.4'}
-    dev: true
 
   /bail/2.0.2:
     resolution: {integrity: sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==}
 
   /balanced-match/1.0.2:
     resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==}
-    dev: false
 
   /base64-js/1.5.1:
     resolution: {integrity: sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==}
-    dev: true
 
   /bcp-47-match/2.0.2:
     resolution: {integrity: sha512-zy5swVXwQ25ttElhoN9Dgnqm6VFlMkeDNljvHSGqGNr4zClUosdFzxD+fQHJVmx3g3KY+r//wV/fmBHsa1ErnA==}
@@ -1018,7 +1183,6 @@ packages:
   /binary-extensions/2.2.0:
     resolution: {integrity: sha512-jDctJ/IVQbZoJykoeHbhXpOlNBqGNcwXJKJog42E5HDPUwQTSdjCHdihjj0DlnheQ7blbT6dHOafNAiS8ooQKA==}
     engines: {node: '>=8'}
-    dev: false
 
   /bl/5.0.0:
     resolution: {integrity: sha512-8vxFNZ0pflFfi0WXA3WQXlj6CaMEwsmh63I1CNp0q+wWv8sD0ARx1KovSQd0l2GkwrMIOyedq0EF1FxI+RCZLQ==}
@@ -1026,7 +1190,6 @@ packages:
       buffer: 6.0.3
       inherits: 2.0.4
       readable-stream: 3.6.0
-    dev: true
 
   /bluebird/3.7.2:
     resolution: {integrity: sha512-XpNj6GDQzdfW+r2Wnn7xiSAd7TM3jzkxGXBGTtWKuSXv1xUV+azxAm8jdWZN06QTQk+2N2XB9jRDkvbmQmcRtg==}
@@ -1044,14 +1207,12 @@ packages:
       type-fest: 2.12.2
       widest-line: 4.0.1
       wrap-ansi: 8.0.1
-    dev: true
 
   /brace-expansion/1.1.11:
     resolution: {integrity: sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==}
     dependencies:
       balanced-match: 1.0.2
       concat-map: 0.0.1
-    dev: false
 
   /braces/3.0.2:
     resolution: {integrity: sha512-b8um+L1RzM3WDSzvhm6gIz1yfTbBt6YTlcEKAvsmqCZZFw46z626lVj9j1yEPW33H5H+lBQpZMP1k8l+78Ha0A==}
@@ -1069,14 +1230,12 @@ packages:
       escalade: 3.1.1
       node-releases: 2.0.2
       picocolors: 1.0.0
-    dev: true
 
   /buffer/6.0.3:
     resolution: {integrity: sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==}
     dependencies:
       base64-js: 1.5.1
       ieee754: 1.2.1
-    dev: true
 
   /cache-point/2.0.0:
     resolution: {integrity: sha512-4gkeHlFpSKgm3vm2gJN5sPqfmijYRFYCQ6tv5cLw0xVmT6r1z1vd4FNnpuOREco3cBs1G709sZ72LdgddKvL5w==}
@@ -1092,16 +1251,18 @@ packages:
     dependencies:
       function-bind: 1.1.1
       get-intrinsic: 1.1.1
+
+  /callsites/3.1.0:
+    resolution: {integrity: sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==}
+    engines: {node: '>=6'}
     dev: true
 
   /camelcase/6.3.0:
     resolution: {integrity: sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==}
     engines: {node: '>=10'}
-    dev: true
 
   /caniuse-lite/1.0.30001325:
     resolution: {integrity: sha512-sB1bZHjseSjDtijV1Hb7PB2Zd58Kyx+n/9EotvZ4Qcz2K3d0lWB8dB4nb8wN/TsOGFq3UuAm0zQZNQ4SoR7TrQ==}
-    dev: true
 
   /catharsis/0.9.0:
     resolution: {integrity: sha512-prMTQVpcns/tzFgFVkVp6ak6RykZyWb3gu8ckUpd6YkTlacOd3DXGJjIpD4Q6zJirizvaiAjSSHlOsA+6sNh2A==}
@@ -1120,7 +1281,6 @@ packages:
       ansi-styles: 3.2.1
       escape-string-regexp: 1.0.5
       supports-color: 5.5.0
-    dev: true
 
   /chalk/4.1.2:
     resolution: {integrity: sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==}
@@ -1128,27 +1288,22 @@ packages:
     dependencies:
       ansi-styles: 4.3.0
       supports-color: 7.2.0
-    dev: true
 
   /chalk/5.0.1:
     resolution: {integrity: sha512-Fo07WOYGqMfCWHOzSXOt2CxDbC6skS/jO9ynEcmpANMoPrD+W1r1K6Vx7iNm+AQmETU1Xr2t+n8nzkV9t6xh3w==}
     engines: {node: ^12.17.0 || ^14.13 || >=16.0.0}
-    dev: true
 
   /character-entities-html4/2.1.0:
     resolution: {integrity: sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==}
-    dev: true
 
   /character-entities-legacy/3.0.0:
     resolution: {integrity: sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==}
-    dev: true
 
   /character-entities/2.0.1:
     resolution: {integrity: sha512-OzmutCf2Kmc+6DrFrrPS8/tDh2+DpnrfzdICHWhcVC9eOd0N1PXmQEE1a8iM4IziIAG+8tmTq3K+oo0ubH6RRQ==}
 
   /character-reference-invalid/2.0.1:
     resolution: {integrity: sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==}
-    dev: true
 
   /chokidar/3.5.3:
     resolution: {integrity: sha512-Dr3sfKRP6oTcjf2JmUmFJfeVMvXBdegxB0iVQ5eb2V10uFJUCAS8OByZdVAyVb8xXNz3GjjTgj9kLWsZTqE6kw==}
@@ -1163,33 +1318,27 @@ packages:
       readdirp: 3.6.0
     optionalDependencies:
       fsevents: 2.3.2
-    dev: false
 
   /ci-info/3.3.0:
     resolution: {integrity: sha512-riT/3vI5YpVH6/qomlDnJow6TBee2PBKSEpx3O32EGPYbWGIRsIlGRms3Sm74wYE1JMo8RnO04Hb12+v1J5ICw==}
-    dev: true
 
   /cli-boxes/3.0.0:
     resolution: {integrity: sha512-/lzGpEWL/8PfI0BmBOPRwp0c/wFNX1RdUML3jK/RcSBA9T8mZDdQpqYBKtCFTOfQbwPqWEOpjqW+Fnayc0969g==}
     engines: {node: '>=10'}
-    dev: true
 
   /cli-cursor/4.0.0:
     resolution: {integrity: sha512-VGtlMu3x/4DOtIUwEkRezxUZ2lBacNJCHash0N0WeZDBS+7Ux1dm3XWAgWYxLJFMMdOeXMHXorshEFhbMSGelg==}
     engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
     dependencies:
       restore-cursor: 4.0.0
-    dev: true
 
   /cli-spinners/2.6.1:
     resolution: {integrity: sha512-x/5fWmGMnbKQAaNwN+UZlV79qBLM9JFnJuJ03gIi5whrob0xV0ofNVHy9DhwGdsMJQc2OKv0oGmLzvaqvAVv+g==}
     engines: {node: '>=6'}
-    dev: true
 
   /clone/1.0.4:
     resolution: {integrity: sha1-2jCcwmPfFZlMaIypAheco8fNfH4=}
     engines: {node: '>=0.8'}
-    dev: true
 
   /collect-all/1.0.4:
     resolution: {integrity: sha512-RKZhRwJtJEP5FWul+gkSMEnaK6H3AGPTTWOiRimCcs+rc/OmQE3Yhy1Q7A7KsdkG3ZXVdZq68Y6ONSdvkeEcKA==}
@@ -1203,40 +1352,32 @@ packages:
     resolution: {integrity: sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==}
     dependencies:
       color-name: 1.1.3
-    dev: true
 
   /color-convert/2.0.1:
     resolution: {integrity: sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==}
     engines: {node: '>=7.0.0'}
     dependencies:
       color-name: 1.1.4
-    dev: true
 
   /color-name/1.1.3:
-    resolution: {integrity: sha1-p9BVi9icQveV3UIyj3QIMcpTvCU=}
-    dev: true
+    resolution: {integrity: sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==}
 
   /color-name/1.1.4:
     resolution: {integrity: sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==}
-    dev: true
 
   /comma-separated-tokens/2.0.2:
     resolution: {integrity: sha512-G5yTt3KQN4Yn7Yk4ed73hlZ1evrFKXeUW3086p3PRFNp7m2vIjI6Pg+Kgb+oyzhd9F2qdcoj67+y3SdxL5XWsg==}
-    dev: true
 
   /common-ancestor-path/1.0.1:
     resolution: {integrity: sha512-L3sHRo1pXXEqX8VU28kfgUY+YGsk09hPqZiZmLacNib6XNTCM8ubYeT7ryXQw8asB1sKgcU5lkB7ONug08aB8w==}
-    dev: true
 
   /concat-map/0.0.1:
     resolution: {integrity: sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=}
-    dev: false
 
   /convert-source-map/1.8.0:
     resolution: {integrity: sha512-+OQdjP49zViI/6i7nIJpA8rAl4sV/JdPfU9nZs3VqOwGIgizICvuN2ru6fMd+4llL0tar18UYJXfZ/TWtmhUjA==}
     dependencies:
       safe-buffer: 5.1.2
-    dev: true
 
   /cross-spawn/7.0.3:
     resolution: {integrity: sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==}
@@ -1245,11 +1386,9 @@ packages:
       path-key: 3.1.1
       shebang-command: 2.0.0
       which: 2.0.2
-    dev: true
 
   /csstype/3.0.11:
     resolution: {integrity: sha512-sa6P2wJ+CAbgyy4KFssIb/JNMLxFvKF1pCYCSXS8ZMuqZnMsrxqI2E5sPyoTpxoPU/gVZMzr2zjOfg8GIZOMsw==}
-    dev: true
 
   /data-uri-to-buffer/4.0.0:
     resolution: {integrity: sha512-Vr3mLBA8qWmcuschSLAOogKgQ/Jwxulv3RNE4FXnYWRGujzrRWQI4m12fQqRkwX06C0KanhLr4hK+GydchZsaA==}
@@ -1274,17 +1413,23 @@ packages:
 
   /dedent-js/1.0.1:
     resolution: {integrity: sha1-vuX7fJ5yfYXf+iRZDRDsGrElUwU=}
+
+  /deep-is/0.1.4:
+    resolution: {integrity: sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==}
     dev: true
 
   /deepmerge/4.2.2:
     resolution: {integrity: sha512-FJ3UgI4gIl+PHZm53knsuSFpE+nESMr7M4v9QcgB7S63Kj/6WqMiFQJpBBYz1Pt+66bZpP3Q7Lye0Oo9MPKEdg==}
     engines: {node: '>=0.10.0'}
-    dev: true
 
   /defaults/1.0.3:
     resolution: {integrity: sha1-xlYFHpgX2f8I7YgUd/P+QBnz730=}
     dependencies:
       clone: 1.0.4
+
+  /define-lazy-prop/2.0.0:
+    resolution: {integrity: sha512-Ds09qNh8yw3khSjiJjiUInaGX9xlqZDY7JVryGxdxV7NPeuqQfplOpQ66yJFZut3jLa5zOwkXw1g9EI2uKh4Og==}
+    engines: {node: '>=8'}
     dev: true
 
   /define-properties/1.1.3:
@@ -1292,7 +1437,6 @@ packages:
     engines: {node: '>= 0.4'}
     dependencies:
       object-keys: 1.1.1
-    dev: true
 
   /dequal/2.0.2:
     resolution: {integrity: sha512-q9K8BlJVxK7hQYqa6XISGmBZbtQQWVXSrRrWreHC94rMt1QL/Impruc+7p2CYSYuVIUr+YCt6hjrs1kkdJRTug==}
@@ -1302,24 +1446,35 @@ packages:
     resolution: {integrity: sha512-/VTCrvm5Z0JGty/BWHljh+BAiw3IK+2j87NGMu8Nwc/f48WoDAC395uomO9ZD117ZOBaHmkX1oyLvkVM/aIT3w==}
     engines: {node: '>=0.3.1'}
 
+  /dir-glob/3.0.1:
+    resolution: {integrity: sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==}
+    engines: {node: '>=8'}
+    dependencies:
+      path-type: 4.0.0
+    dev: true
+
+  /doctrine/3.0.0:
+    resolution: {integrity: sha512-yS+Q5i3hBf7GBkd4KG8a7eBNNWNGLTaEwwYWUijIYM7zrlYDM0BFXHjjPWlWZ1Rg7UaddZeIDmi9jF3HmqiQ2w==}
+    engines: {node: '>=6.0.0'}
+    dependencies:
+      esutils: 2.0.3
+    dev: true
+
   /dom-serializer/1.3.2:
     resolution: {integrity: sha512-5c54Bk5Dw4qAxNOI1pFEizPSjVsx5+bpJKmL2kPn8JhBUq2q09tTCa3mjijun2NfK78NMouDYNMBkOrPZiS+ig==}
     dependencies:
       domelementtype: 2.3.0
       domhandler: 4.3.1
       entities: 2.2.0
-    dev: true
 
   /domelementtype/2.3.0:
     resolution: {integrity: sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==}
-    dev: true
 
   /domhandler/4.3.1:
     resolution: {integrity: sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ==}
     engines: {node: '>= 4'}
     dependencies:
       domelementtype: 2.3.0
-    dev: true
 
   /domutils/2.8.0:
     resolution: {integrity: sha512-w96Cjofp72M5IIhpjgobBimYEfoPjx1Vx0BSX9P30WBdZW2WIKU0T1Bd0kz2eNZ9ikjKgHbEyKx8BB6H1L3h3A==}
@@ -1327,30 +1482,24 @@ packages:
       dom-serializer: 1.3.2
       domelementtype: 2.3.0
       domhandler: 4.3.1
-    dev: true
 
   /eastasianwidth/0.2.0:
     resolution: {integrity: sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==}
-    dev: true
 
   /electron-to-chromium/1.4.106:
     resolution: {integrity: sha512-ZYfpVLULm67K7CaaGP7DmjyeMY4naxsbTy+syVVxT6QHI1Ww8XbJjmr9fDckrhq44WzCrcC5kH3zGpdusxwwqg==}
-    dev: true
 
   /emmet/2.3.6:
     resolution: {integrity: sha512-pLS4PBPDdxuUAmw7Me7+TcHbykTsBKN/S9XJbUOMFQrNv9MoshzyMFK/R57JBm94/6HSL4vHnDeEmxlC82NQ4A==}
     dependencies:
       '@emmetio/abbreviation': 2.2.3
       '@emmetio/css-abbreviation': 2.1.4
-    dev: true
 
   /emoji-regex/8.0.0:
     resolution: {integrity: sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==}
-    dev: true
 
   /emoji-regex/9.2.2:
     resolution: {integrity: sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==}
-    dev: true
 
   /entities/2.1.0:
     resolution: {integrity: sha512-hCx1oky9PFrJ611mf0ifBLBRW8lUUVRlFolb5gWRfIELabBlbp9xZvrqZLZAs+NxFnbfQoeGd8wDkygjg7U85w==}
@@ -1358,16 +1507,13 @@ packages:
 
   /entities/2.2.0:
     resolution: {integrity: sha512-p92if5Nz619I0w+akJrLZH0MX0Pb5DX39XOwQTtXSdQQOaYH03S1uIQp4mhOZtAXrxq4ViO67YTiLBo2638o9A==}
-    dev: true
 
   /entities/3.0.1:
     resolution: {integrity: sha512-WiyBqoomrwMdFG1e0kqvASYfnlb0lp8M5o5Fw2OFq1hNZxxcNk8Ik0Xm7LxzBhuidnZB/UtBqVCgUz3kBOP51Q==}
     engines: {node: '>=0.12'}
-    dev: true
 
   /eol/0.9.1:
     resolution: {integrity: sha512-Ds/TEoZjwggRoz/Q2O7SE3i4Jm66mqTDfmdHdq/7DKVk3bro9Q8h6WdXKdPqFLMoqxrDK5SVRzHVPOS6uuGtrg==}
-    dev: true
 
   /es-abstract/1.19.2:
     resolution: {integrity: sha512-gfSBJoZdlL2xRiOCy0g8gLMryhoe1TlimjzU99L/31Z8QEGIhVQI+EWwt5lT+AuU9SnorVupXFqqOGqGfsyO6w==}
@@ -1393,11 +1539,9 @@ packages:
       string.prototype.trimend: 1.0.4
       string.prototype.trimstart: 1.0.4
       unbox-primitive: 1.0.1
-    dev: true
 
   /es-module-lexer/0.10.5:
     resolution: {integrity: sha512-+7IwY/kiGAacQfY+YBhKMvEmyAJnw5grTUgjG85Pe7vcUI/6b7pZjZG8nQ7+48YhzEAEqrEgD2dCz/JIK+AYvw==}
-    dev: true
 
   /es-to-primitive/1.2.1:
     resolution: {integrity: sha512-QCOllgZJtaUo9miYBcLChTUaHNjJF3PYs1VidD7AwiEj1kYxKeQTctLAezAOH5ZKRH0g2IgPn6KwB4IT8iRpvA==}
@@ -1406,11 +1550,9 @@ packages:
       is-callable: 1.2.4
       is-date-object: 1.0.5
       is-symbol: 1.0.4
-    dev: true
 
   /es6-object-assign/1.1.0:
     resolution: {integrity: sha1-wsNYJlYkfDnqEHyx5mUrb58kUjw=}
-    dev: true
 
   /esbuild-android-64/0.14.38:
     resolution: {integrity: sha512-aRFxR3scRKkbmNuGAK+Gee3+yFxkTJO/cx83Dkyzo4CnQl/2zVSurtG6+G86EQIZ+w+VYngVyK7P3HyTBKu3nw==}
@@ -1418,7 +1560,6 @@ packages:
     cpu: [x64]
     os: [android]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-android-arm64/0.14.38:
@@ -1427,7 +1568,6 @@ packages:
     cpu: [arm64]
     os: [android]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-darwin-64/0.14.38:
@@ -1436,7 +1576,6 @@ packages:
     cpu: [x64]
     os: [darwin]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-darwin-arm64/0.14.38:
@@ -1445,7 +1584,6 @@ packages:
     cpu: [arm64]
     os: [darwin]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-freebsd-64/0.14.38:
@@ -1454,7 +1592,6 @@ packages:
     cpu: [x64]
     os: [freebsd]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-freebsd-arm64/0.14.38:
@@ -1463,7 +1600,6 @@ packages:
     cpu: [arm64]
     os: [freebsd]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-linux-32/0.14.38:
@@ -1472,7 +1608,6 @@ packages:
     cpu: [ia32]
     os: [linux]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-linux-64/0.14.38:
@@ -1481,7 +1616,6 @@ packages:
     cpu: [x64]
     os: [linux]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-linux-arm/0.14.38:
@@ -1490,7 +1624,6 @@ packages:
     cpu: [arm]
     os: [linux]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-linux-arm64/0.14.38:
@@ -1499,7 +1632,6 @@ packages:
     cpu: [arm64]
     os: [linux]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-linux-mips64le/0.14.38:
@@ -1508,7 +1640,6 @@ packages:
     cpu: [mips64el]
     os: [linux]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-linux-ppc64le/0.14.38:
@@ -1517,7 +1648,6 @@ packages:
     cpu: [ppc64]
     os: [linux]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-linux-riscv64/0.14.38:
@@ -1526,7 +1656,6 @@ packages:
     cpu: [riscv64]
     os: [linux]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-linux-s390x/0.14.38:
@@ -1535,7 +1664,6 @@ packages:
     cpu: [s390x]
     os: [linux]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-netbsd-64/0.14.38:
@@ -1544,7 +1672,6 @@ packages:
     cpu: [x64]
     os: [netbsd]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-openbsd-64/0.14.38:
@@ -1553,7 +1680,6 @@ packages:
     cpu: [x64]
     os: [openbsd]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-sunos-64/0.14.38:
@@ -1562,7 +1688,6 @@ packages:
     cpu: [x64]
     os: [sunos]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-windows-32/0.14.38:
@@ -1571,7 +1696,6 @@ packages:
     cpu: [ia32]
     os: [win32]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-windows-64/0.14.38:
@@ -1580,7 +1704,6 @@ packages:
     cpu: [x64]
     os: [win32]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild-windows-arm64/0.14.38:
@@ -1589,7 +1712,6 @@ packages:
     cpu: [arm64]
     os: [win32]
     requiresBuild: true
-    dev: true
     optional: true
 
   /esbuild/0.14.38:
@@ -1618,46 +1740,176 @@ packages:
       esbuild-windows-32: 0.14.38
       esbuild-windows-64: 0.14.38
       esbuild-windows-arm64: 0.14.38
-    dev: true
 
   /escalade/3.1.1:
     resolution: {integrity: sha512-k0er2gUkLf8O0zKJiAhmkTnJlTvINGv7ygDNPbeIsX/TJjGJZHuh9B2UxbsaEkmlEo9MfhrSzmhIlhRlI2GXnw==}
     engines: {node: '>=6'}
-    dev: true
 
   /escape-string-regexp/1.0.5:
-    resolution: {integrity: sha1-G2HAViGQqN/2rjuyzwIAyhMLhtQ=}
+    resolution: {integrity: sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==}
     engines: {node: '>=0.8.0'}
-    dev: true
 
   /escape-string-regexp/2.0.0:
     resolution: {integrity: sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w==}
     engines: {node: '>=8'}
     dev: false
 
+  /escape-string-regexp/4.0.0:
+    resolution: {integrity: sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==}
+    engines: {node: '>=10'}
+    dev: true
+
   /escape-string-regexp/5.0.0:
     resolution: {integrity: sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==}
     engines: {node: '>=12'}
 
+  /eslint-plugin-astro/0.8.1_wtnyy2apyieggkncrmd6jlo5ja:
+    resolution: {integrity: sha512-Bex3lMm9L+azm97Ar1eCcPWy97n9E7eESeVwOxcsHVsoSE5NdvqKOug18rTT/9jBHCk6blQteg5Lu9QodliD7Q==}
+    peerDependencies:
+      '@typescript-eslint/parser': ^5.25.0
+      astro-eslint-parser: ^0.2.0
+    dependencies:
+      '@typescript-eslint/parser': 5.27.0_xztl6dhthcahlo6akmb2bmjmle
+      '@typescript-eslint/types': 5.27.0
+      astro-eslint-parser: 0.2.2
+      eslint-utils: 3.0.0_eslint@8.16.0
+    transitivePeerDependencies:
+      - eslint
+    dev: true
+
+  /eslint-scope/5.1.1:
+    resolution: {integrity: sha512-2NxwbF/hZ0KpepYN0cNbo+FN6XoK7GaHlQhgx/hIZl6Va0bF45RQOOwhLIy8lQDbuCiadSLCBnH2CFYquit5bw==}
+    engines: {node: '>=8.0.0'}
+    dependencies:
+      esrecurse: 4.3.0
+      estraverse: 4.3.0
+    dev: true
+
+  /eslint-scope/7.1.1:
+    resolution: {integrity: sha512-QKQM/UXpIiHcLqJ5AOyIW7XZmzjkzQXYE54n1++wb0u9V/abW3l9uQnxX8Z5Xd18xyKIMTUAyQ0k1e8pz6LUrw==}
+    engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+    dependencies:
+      esrecurse: 4.3.0
+      estraverse: 5.3.0
+    dev: true
+
+  /eslint-utils/3.0.0_eslint@8.16.0:
+    resolution: {integrity: sha512-uuQC43IGctw68pJA1RgbQS8/NP7rch6Cwd4j3ZBtgo4/8Flj4eGE7ZYSZRN3iq5pVUv6GPdW5Z1RFleo84uLDA==}
+    engines: {node: ^10.0.0 || ^12.0.0 || >= 14.0.0}
+    peerDependencies:
+      eslint: '>=5'
+    dependencies:
+      eslint: 8.16.0
+      eslint-visitor-keys: 2.1.0
+    dev: true
+
+  /eslint-visitor-keys/2.1.0:
+    resolution: {integrity: sha512-0rSmRBzXgDzIsD6mGdJgevzgezI534Cer5L/vyMX0kHzT/jiB43jRhd9YUlMGYLQy2zprNmoT8qasCGtY+QaKw==}
+    engines: {node: '>=10'}
+    dev: true
+
+  /eslint-visitor-keys/3.3.0:
+    resolution: {integrity: sha512-mQ+suqKJVyeuwGYHAdjMFqjCyfl8+Ldnxuyp3ldiMBFKkvytrXUZWaiPCEav8qDHKty44bD+qV1IP4T+w+xXRA==}
+    engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+    dev: true
+
+  /eslint/8.16.0:
+    resolution: {integrity: sha512-MBndsoXY/PeVTDJeWsYj7kLZ5hQpJOfMYLsF6LicLHQWbRDG19lK5jOix4DPl8yY4SUFcE3txy86OzFLWT+yoA==}
+    engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+    hasBin: true
+    dependencies:
+      '@eslint/eslintrc': 1.3.0
+      '@humanwhocodes/config-array': 0.9.5
+      ajv: 6.12.6
+      chalk: 4.1.2
+      cross-spawn: 7.0.3
+      debug: 4.3.4
+      doctrine: 3.0.0
+      escape-string-regexp: 4.0.0
+      eslint-scope: 7.1.1
+      eslint-utils: 3.0.0_eslint@8.16.0
+      eslint-visitor-keys: 3.3.0
+      espree: 9.3.2
+      esquery: 1.4.0
+      esutils: 2.0.3
+      fast-deep-equal: 3.1.3
+      file-entry-cache: 6.0.1
+      functional-red-black-tree: 1.0.1
+      glob-parent: 6.0.2
+      globals: 13.15.0
+      ignore: 5.2.0
+      import-fresh: 3.3.0
+      imurmurhash: 0.1.4
+      is-glob: 4.0.3
+      js-yaml: 4.1.0
+      json-stable-stringify-without-jsonify: 1.0.1
+      levn: 0.4.1
+      lodash.merge: 4.6.2
+      minimatch: 3.1.2
+      natural-compare: 1.4.0
+      optionator: 0.9.1
+      regexpp: 3.2.0
+      strip-ansi: 6.0.1
+      strip-json-comments: 3.1.1
+      text-table: 0.2.0
+      v8-compile-cache: 2.3.0
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /espree/9.3.2:
+    resolution: {integrity: sha512-D211tC7ZwouTIuY5x9XnS0E9sWNChB7IYKX/Xp5eQj3nFXhqmiUDB9q27y76oFl8jTg3pXcQx/bpxMfs3CIZbA==}
+    engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+    dependencies:
+      acorn: 8.7.1
+      acorn-jsx: 5.3.2_acorn@8.7.1
+      eslint-visitor-keys: 3.3.0
+    dev: true
+
   /esprima/4.0.1:
     resolution: {integrity: sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==}
     engines: {node: '>=4'}
     hasBin: true
+
+  /esquery/1.4.0:
+    resolution: {integrity: sha512-cCDispWt5vHHtwMY2YrAQ4ibFkAL8RbH5YGBnZBc90MolvvfkkQcJro/aZiAQUlQ3qgrYS6D6v8Gc5G5CQsc9w==}
+    engines: {node: '>=0.10'}
+    dependencies:
+      estraverse: 5.3.0
+    dev: true
+
+  /esrecurse/4.3.0:
+    resolution: {integrity: sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==}
+    engines: {node: '>=4.0'}
+    dependencies:
+      estraverse: 5.3.0
+    dev: true
+
+  /estraverse/4.3.0:
+    resolution: {integrity: sha512-39nnKffWz8xN1BU/2c79n9nB9HDzo0niYUqx6xyqUnyoAnQyyWpOTdZEeiCch8BBu515t4wp9ZmgVfVhn9EBpw==}
+    engines: {node: '>=4.0'}
+    dev: true
+
+  /estraverse/5.3.0:
+    resolution: {integrity: sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==}
+    engines: {node: '>=4.0'}
     dev: true
 
   /estree-util-is-identifier-name/2.0.0:
     resolution: {integrity: sha512-aXXZFVMnBBDRP81vS4YtAYJ0hUkgEsXea7lNKWCOeaAquGb1Jm2rcONPB5fpzwgbNxulTvrWuKnp9UElUGAKeQ==}
-    dev: true
 
   /estree-util-visit/1.1.0:
     resolution: {integrity: sha512-3lXJ4Us9j8TUif9cWcQy81t9p5OLasnDuuhrFiqb+XstmKC1d1LmrQWYsY49/9URcfHE64mPypDBaNK9NwWDPQ==}
     dependencies:
       '@types/estree-jsx': 0.0.1
       '@types/unist': 2.0.6
-    dev: true
 
   /estree-walker/3.0.1:
     resolution: {integrity: sha512-woY0RUD87WzMBUiZLx8NsYr23N5BKsOMZHhu2hoNRVh6NXGfoiT1KOL8G3UHlJAnEDGmfa5ubNA/AacfG+Kb0g==}
+
+  /esutils/2.0.3:
+    resolution: {integrity: sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==}
+    engines: {node: '>=0.10.0'}
     dev: true
 
   /execa/6.1.0:
@@ -1673,18 +1925,20 @@ packages:
       onetime: 6.0.0
       signal-exit: 3.0.7
       strip-final-newline: 3.0.0
-    dev: true
 
   /extend-shallow/2.0.1:
     resolution: {integrity: sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=}
     engines: {node: '>=0.10.0'}
     dependencies:
       is-extendable: 0.1.1
-    dev: true
 
   /extend/3.0.2:
     resolution: {integrity: sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==}
 
+  /fast-deep-equal/3.1.3:
+    resolution: {integrity: sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==}
+    dev: true
+
   /fast-glob/3.2.11:
     resolution: {integrity: sha512-xrO3+1bxSo3ZVHAnqzyuewYT6aMFHRAd4Kcs92MAonjwQZLsK9d0SF1IyQ3k5PoirxTW0Oe/RqFgMQ6TcNE5Ew==}
     engines: {node: '>=8.6.0'}
@@ -1694,6 +1948,13 @@ packages:
       glob-parent: 5.1.2
       merge2: 1.4.1
       micromatch: 4.0.5
+
+  /fast-json-stable-stringify/2.1.0:
+    resolution: {integrity: sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==}
+    dev: true
+
+  /fast-levenshtein/2.0.6:
+    resolution: {integrity: sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==}
     dev: true
 
   /fast-xml-parser/4.0.7:
@@ -1701,13 +1962,11 @@ packages:
     hasBin: true
     dependencies:
       strnum: 1.0.5
-    dev: true
 
   /fastq/1.13.0:
     resolution: {integrity: sha512-YpkpUnK8od0o1hmeSc7UUs/eB/vIPWJYjKck2QKIzAf71Vm1AAQ3EbuZB3g2JIy+pg+ERD0vqI79KyZiB2e2Nw==}
     dependencies:
       reusify: 1.0.4
-    dev: true
 
   /fetch-blob/3.1.5:
     resolution: {integrity: sha512-N64ZpKqoLejlrwkIAnb9iLSA3Vx/kjgzpcDhygcqJ2KKjky8nCgUQ+dzXtbrLaWZGZNmNfQTsiQ0weZ1svglHg==}
@@ -1717,6 +1976,13 @@ packages:
       web-streams-polyfill: 3.2.0
     dev: true
 
+  /file-entry-cache/6.0.1:
+    resolution: {integrity: sha512-7Gps/XWymbLk2QLYK4NzpMOrYjMhdIxXuIvy2QBsLE6ljuodKvdkWs/cpyJJ3CVIVpH0Oi1Hvg1ovbMzLdFBBg==}
+    engines: {node: ^10.12.0 || >=12.0.0}
+    dependencies:
+      flat-cache: 3.0.4
+    dev: true
+
   /file-set/4.0.2:
     resolution: {integrity: sha512-fuxEgzk4L8waGXaAkd8cMr73Pm0FxOVkn8hztzUW7BAHhOGH90viQNXbiOsnecCWmfInqU6YmAMwxRMdKETceQ==}
     engines: {node: '>=10'}
@@ -1737,7 +2003,6 @@ packages:
     dependencies:
       locate-path: 5.0.0
       path-exists: 4.0.0
-    dev: true
 
   /find-up/5.0.0:
     resolution: {integrity: sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==}
@@ -1745,18 +2010,27 @@ packages:
     dependencies:
       locate-path: 6.0.0
       path-exists: 4.0.0
-    dev: true
 
   /find-yarn-workspace-root2/1.2.16:
     resolution: {integrity: sha512-hr6hb1w8ePMpPVUK39S4RlwJzi+xPLuVuG8XlwXU3KD5Yn3qgBWVfy3AzNlDhWvE1EORCE65/Qm26rFQt3VLVA==}
     dependencies:
       micromatch: 4.0.5
       pkg-dir: 4.2.0
+
+  /flat-cache/3.0.4:
+    resolution: {integrity: sha512-dm9s5Pw7Jc0GvMYbshN6zchCA9RgQlzzEZX3vylR9IqFfS8XciblUXOKfW6SiuJ0e13eDYZoZV5wdrev7P3Nwg==}
+    engines: {node: ^10.12.0 || >=12.0.0}
+    dependencies:
+      flatted: 3.2.5
+      rimraf: 3.0.2
+    dev: true
+
+  /flatted/3.2.5:
+    resolution: {integrity: sha512-WIWGi2L3DyTUvUrwRKgGi9TwxQMUEqPOPQBVi71R96jZXJdFskXEmf54BoZaS1kknGODoIGASGEzBUYdyMCBJg==}
     dev: true
 
   /foreach/2.0.5:
     resolution: {integrity: sha1-C+4AUBiusmDQo6865ljdATbsG5k=}
-    dev: true
 
   /formdata-polyfill/4.0.10:
     resolution: {integrity: sha512-buewHzMvYL29jdeQTVILecSaZKnt/RJWjoZCF5OW60Z67/GmSLBkOFM7qh1PI3zFNtJbaZL5eQu1vLfazOwj4g==}
@@ -1771,8 +2045,7 @@ packages:
     dev: false
 
   /fs.realpath/1.0.0:
-    resolution: {integrity: sha1-FQStJSMVjKpA20onh8sBQRmU6k8=}
-    dev: false
+    resolution: {integrity: sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==}
 
   /fsevents/2.3.2:
     resolution: {integrity: sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==}
@@ -1783,12 +2056,14 @@ packages:
 
   /function-bind/1.1.1:
     resolution: {integrity: sha512-yIovAzMX49sF8Yl58fSCWJ5svSLuaibPxXQJFLmBObTuCr0Mf1KiPopGM9NiFjiYBCbfaa2Fh6breQ6ANVTI0A==}
+
+  /functional-red-black-tree/1.0.1:
+    resolution: {integrity: sha512-dsKNQNdj6xA3T+QlADDA7mOSlX0qiMINjn0cgr+eGHGsbSHzTabcIogz2+p/iqP1Xs6EP/sS2SbqH+brGTbq0g==}
     dev: true
 
   /gensync/1.0.0-beta.2:
     resolution: {integrity: sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==}
     engines: {node: '>=6.9.0'}
-    dev: true
 
   /get-intrinsic/1.1.1:
     resolution: {integrity: sha512-kWZrnVM42QCiEA2Ig1bG8zjoIMOgxWwYCEeNdwY6Tv/cOSeGpcoX4pXHfKUxNKVoArnrEr2e9srnAxxGIraS9Q==}
@@ -1796,12 +2071,10 @@ packages:
       function-bind: 1.1.1
       has: 1.0.3
       has-symbols: 1.0.3
-    dev: true
 
   /get-stream/6.0.1:
     resolution: {integrity: sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==}
     engines: {node: '>=10'}
-    dev: true
 
   /get-symbol-description/1.0.0:
     resolution: {integrity: sha512-2EmdH1YvIQiZpltCNgkuiUnyukzxM/R6NDJX31Ke3BG1Nq5b0S2PhX59UKi9vZpPDQVdqn+1IcaAwnzTT5vCjw==}
@@ -1809,7 +2082,6 @@ packages:
     dependencies:
       call-bind: 1.0.2
       get-intrinsic: 1.1.1
-    dev: true
 
   /github-slugger/1.4.0:
     resolution: {integrity: sha512-w0dzqw/nt51xMVmlaV1+JRzN+oCa1KfcgGEWhxUG16wbdA+Xnt/yoFO8Z8x/V82ZcZ0wy6ln9QDup5avbhiDhQ==}
@@ -1820,6 +2092,13 @@ packages:
     dependencies:
       is-glob: 4.0.3
 
+  /glob-parent/6.0.2:
+    resolution: {integrity: sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==}
+    engines: {node: '>=10.13.0'}
+    dependencies:
+      is-glob: 4.0.3
+    dev: true
+
   /glob/7.2.0:
     resolution: {integrity: sha512-lmLf6gtyrPq8tTjSmrO94wBeQbFR3HbLHbuyD69wuyQkImp2hWqMGB47OX65FBkPffO641IP9jWa1z4ivqG26Q==}
     dependencies:
@@ -1829,16 +2108,40 @@ packages:
       minimatch: 3.1.2
       once: 1.4.0
       path-is-absolute: 1.0.1
-    dev: false
 
   /globals/11.12.0:
     resolution: {integrity: sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==}
     engines: {node: '>=4'}
+
+  /globals/13.15.0:
+    resolution: {integrity: sha512-bpzcOlgDhMG070Av0Vy5Owklpv1I6+j96GhUI7Rh7IzDCKLzboflLrrfqMu8NquDbiR4EOQk7XzJwqVJxicxog==}
+    engines: {node: '>=8'}
+    dependencies:
+      type-fest: 0.20.2
+    dev: true
+
+  /globalyzer/0.1.0:
+    resolution: {integrity: sha512-40oNTM9UfG6aBmuKxk/giHn5nQ8RVz/SS4Ir6zgzOv9/qC3kKZ9v4etGTcJbEl/NyVQH7FGU7d+X1egr57Md2Q==}
+    dev: true
+
+  /globby/11.1.0:
+    resolution: {integrity: sha512-jhIXaOzy1sb8IyocaruWSn1TjmnBVs8Ayhcy83rmxNJ8q2uWKCAj3CnJY+KpGSXCueAPc0i05kVvVKtP1t9S3g==}
+    engines: {node: '>=10'}
+    dependencies:
+      array-union: 2.1.0
+      dir-glob: 3.0.1
+      fast-glob: 3.2.11
+      ignore: 5.2.0
+      merge2: 1.4.1
+      slash: 3.0.0
+    dev: true
+
+  /globrex/0.1.2:
+    resolution: {integrity: sha512-uHJgbwAMwNFf5mLst7IWLNg14x1CkeqglJb/K3doi4dw6q2IvAAmM/Y81kevy83wP+Sst+nutFTYOGg3d1lsxg==}
     dev: true
 
   /graceful-fs/4.2.10:
     resolution: {integrity: sha512-9ByhssR2fPVsNZj478qUUbKfmL0+t5BDVyjShtyZZLiK7ZDAArFFfopyOTj0M05wE2tJPisA4iTnnXl2YoPvOA==}
-    dev: true
 
   /gray-matter/4.0.3:
     resolution: {integrity: sha512-5v6yZd4JK3eMI3FqqCouswVqwugaA9r4dNZB1wwcmrD02QkV5H0y7XBQW8QwQqEaZY1pM9aqORSORhJRdNK44Q==}
@@ -1848,46 +2151,38 @@ packages:
       kind-of: 6.0.3
       section-matter: 1.0.0
       strip-bom-string: 1.0.0
-    dev: true
 
   /has-bigints/1.0.1:
     resolution: {integrity: sha512-LSBS2LjbNBTf6287JEbEzvJgftkF5qFkmCo9hDRpAzKhUOlJ+hx8dd4USs00SgsUNwc4617J9ki5YtEClM2ffA==}
-    dev: true
 
   /has-flag/3.0.0:
-    resolution: {integrity: sha1-tdRU3CGZriJWmfNGfloH87lVuv0=}
+    resolution: {integrity: sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==}
     engines: {node: '>=4'}
-    dev: true
 
   /has-flag/4.0.0:
     resolution: {integrity: sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==}
     engines: {node: '>=8'}
-    dev: true
 
   /has-package-exports/1.3.0:
     resolution: {integrity: sha512-e9OeXPQnmPhYoJ63lXC4wWe34TxEGZDZ3OQX9XRqp2VwsfLl3bQBy7VehLnd34g3ef8CmYlBLGqEMKXuz8YazQ==}
     dependencies:
       '@ljharb/has-package-exports-patterns': 0.0.2
-    dev: true
 
   /has-symbols/1.0.3:
     resolution: {integrity: sha512-l3LCuF6MgDNwTDKkdYGEihYjt5pRPbEg46rtlmnSPlUbgmB8LOIrKJbYYFBSbnPaJexMKtiPO8hmeRjRz2Td+A==}
     engines: {node: '>= 0.4'}
-    dev: true
 
   /has-tostringtag/1.0.0:
     resolution: {integrity: sha512-kFjcSNhnlGV1kyoGk7OXKSawH5JOb/LzUc5w9B02hOTO0dfFRjbHQKvg1d6cf3HbeUmtU9VbbV3qzZ2Teh97WQ==}
     engines: {node: '>= 0.4'}
     dependencies:
       has-symbols: 1.0.3
-    dev: true
 
   /has/1.0.3:
     resolution: {integrity: sha512-f2dvO0VU6Oej7RkWJGrehjbzMAjFp5/VKPp5tTpWIV4JHHZK1/BxbFRtf/siA2SWTe09caDmVtYYzWEIbBS4zw==}
     engines: {node: '>= 0.4.0'}
     dependencies:
       function-bind: 1.1.1
-    dev: true
 
   /hast-to-hyperscript/10.0.1:
     resolution: {integrity: sha512-dhIVGoKCQVewFi+vz3Vt567E4ejMppS1haBRL6TEmeLeJVB1i/FJIIg/e6s1Bwn0g5qtYojHEKvyGA+OZuyifw==}
@@ -1899,7 +2194,6 @@ packages:
       style-to-object: 0.3.0
       unist-util-is: 5.1.1
       web-namespaces: 2.0.1
-    dev: true
 
   /hast-util-from-parse5/7.1.0:
     resolution: {integrity: sha512-m8yhANIAccpU4K6+121KpPP55sSl9/samzQSQGpb0mTExcNh2WlvjtMwSWFhg6uqD4Rr6Nfa8N6TMypQM51rzQ==}
@@ -1912,7 +2206,6 @@ packages:
       vfile: 5.3.2
       vfile-location: 4.0.1
       web-namespaces: 2.0.1
-    dev: true
 
   /hast-util-has-property/2.0.0:
     resolution: {integrity: sha512-4Qf++8o5v14us4Muv3HRj+Er6wTNGA/N9uCaZMty4JWvyFKLdhULrv4KE1b65AthsSO9TXSZnjuxS8ecIyhb0w==}
@@ -1932,7 +2225,6 @@ packages:
     resolution: {integrity: sha512-AyjlI2pTAZEOeu7GeBPZhROx0RHBnydkQIXlhnFzDi0qfXTmGUWoCYZtomHbrdrheV4VFUlPcfJ6LMF5T6sQzg==}
     dependencies:
       '@types/hast': 2.3.4
-    dev: true
 
   /hast-util-raw/7.2.1:
     resolution: {integrity: sha512-wgtppqXVdXzkDXDFclLLdAyVUJSKMYYi6LWIAbA8oFqEdwksYIcPGM3RkKV1Dfn5GElvxhaOCs0jmCOMayxd3A==}
@@ -1948,7 +2240,6 @@ packages:
       vfile: 5.3.2
       web-namespaces: 2.0.1
       zwitch: 2.0.2
-    dev: true
 
   /hast-util-to-html/8.0.3:
     resolution: {integrity: sha512-/D/E5ymdPYhHpPkuTHOUkSatxr4w1ZKrZsG0Zv/3C2SRVT0JFJG53VS45AMrBtYk0wp5A7ksEhiC8QaOZM95+A==}
@@ -1963,7 +2254,6 @@ packages:
       space-separated-tokens: 2.0.1
       stringify-entities: 4.0.2
       unist-util-is: 5.1.1
-    dev: true
 
   /hast-util-to-parse5/7.0.0:
     resolution: {integrity: sha512-YHiS6aTaZ3N0Q3nxaY/Tj98D6kM8QX5Q8xqgg8G45zR7PvWnPGPP0vcKCgb/moIydEJ/QWczVrX0JODCVeoV7A==}
@@ -1974,7 +2264,6 @@ packages:
       property-information: 6.1.1
       web-namespaces: 2.0.1
       zwitch: 2.0.2
-    dev: true
 
   /hast-util-to-string/2.0.0:
     resolution: {integrity: sha512-02AQ3vLhuH3FisaMM+i/9sm4OXGSq1UhOOCpTLLQtHdL3tZt7qil69r8M8iDkZYyC0HCFylcYoP+8IO7ddta1A==}
@@ -1983,7 +2272,6 @@ packages:
 
   /hast-util-whitespace/2.0.0:
     resolution: {integrity: sha512-Pkw+xBHuV6xFeJprJe2BBEoDV+AvQySaz3pPDRUs5PNZEMQjpXJJueqrpcHIXxnWTcAGi/UOCgVShlkY6kLoqg==}
-    dev: true
 
   /hastscript/7.0.2:
     resolution: {integrity: sha512-uA8ooUY4ipaBvKcMuPehTAB/YfFLSSzCwFSwT6ltJbocFUKH/GDHLN+tflq7lSRf9H86uOuxOFkh1KgIy3Gg2g==}
@@ -1993,19 +2281,15 @@ packages:
       hast-util-parse-selector: 3.1.0
       property-information: 6.1.1
       space-separated-tokens: 2.0.1
-    dev: true
 
   /html-entities/2.3.3:
     resolution: {integrity: sha512-DV5Ln36z34NNTDgnz0EWGBLZENelNAtkiFA4kyNOG2tDI6Mz1uSWiq1wAKdyjnJwyDiDO7Fa2SO1CTxPXL8VxA==}
-    dev: true
 
   /html-escaper/3.0.3:
     resolution: {integrity: sha512-RuMffC89BOWQoY0WKGpIhn5gX3iI54O6nRA0yC124NYVtzjmFWBIiFd8M0x+ZdX0P9R4lADg1mgP8C7PxGOWuQ==}
-    dev: true
 
   /html-void-elements/2.0.1:
     resolution: {integrity: sha512-0quDb7s97CfemeJAnW9wC0hw78MtW7NU3hqtCD75g2vFlDLt36llsYD7uB7SUzojLMP24N5IatXf7ylGXiGG9A==}
-    dev: true
 
   /htmlparser2/7.2.0:
     resolution: {integrity: sha512-H7MImA4MS6cw7nbyURtLPO1Tms7C5H602LRETv95z1MxO/7CP7rDVROehUYeYBUYEON94NXXDEPmZuq+hX4sog==}
@@ -2014,34 +2298,46 @@ packages:
       domhandler: 4.3.1
       domutils: 2.8.0
       entities: 3.0.1
-    dev: true
 
   /human-signals/3.0.1:
     resolution: {integrity: sha512-rQLskxnM/5OCldHo+wNXbpVgDn5A17CUoKX+7Sokwaknlq7CdSnphy0W39GU8dw59XiCXmFXDg4fRuckQRKewQ==}
     engines: {node: '>=12.20.0'}
-    dev: true
 
   /ieee754/1.2.1:
     resolution: {integrity: sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==}
+
+  /ignore/5.2.0:
+    resolution: {integrity: sha512-CmxgYGiEPCLhfLnpPp1MoRmifwEIOgjcHXxOBjv7mY96c+eWScsOP9c112ZyLdWHi0FxHjI+4uVhKYp/gcdRmQ==}
+    engines: {node: '>= 4'}
     dev: true
 
   /immutable/4.0.0:
     resolution: {integrity: sha512-zIE9hX70qew5qTUjSS7wi1iwj/l7+m54KWU247nhM3v806UdGj1yDndXj+IOYxxtW9zyLI+xqFNZjTuDaLUqFw==}
-    dev: false
+
+  /import-fresh/3.3.0:
+    resolution: {integrity: sha512-veYYhQa+D1QBKznvhUHxb8faxlrwUnxseDAbAp457E0wLNio2bOSKnjYDhMj+YiAq61xrMGhQk9iXVk5FzgQMw==}
+    engines: {node: '>=6'}
+    dependencies:
+      parent-module: 1.0.1
+      resolve-from: 4.0.0
+    dev: true
+
+  /imurmurhash/0.1.4:
+    resolution: {integrity: sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==}
+    engines: {node: '>=0.8.19'}
+    dev: true
 
   /inflight/1.0.6:
-    resolution: {integrity: sha1-Sb1jMdfQLQwJvJEKEHW6gWW1bfk=}
+    resolution: {integrity: sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==}
     dependencies:
       once: 1.4.0
       wrappy: 1.0.2
-    dev: false
 
   /inherits/2.0.4:
     resolution: {integrity: sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==}
 
   /inline-style-parser/0.1.1:
     resolution: {integrity: sha512-7NXolsK4CAS5+xvdj5OMMbI962hU/wvwoxk+LWR9Ek9bVtyuuYScDN6eS0rUm6TxApFpw7CX1o4uJzcd4AyD3Q==}
-    dev: true
 
   /internal-slot/1.0.3:
     resolution: {integrity: sha512-O0DB1JC/sPyZl7cIo78n5dR7eUSwwpYPiXRhTzNxZVAMUuB8vlnRFyLxdrVToks6XPLVnFfbzaVd5WLjhgg+vA==}
@@ -2050,18 +2346,15 @@ packages:
       get-intrinsic: 1.1.1
       has: 1.0.3
       side-channel: 1.0.4
-    dev: true
 
   /is-alphabetical/2.0.1:
     resolution: {integrity: sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==}
-    dev: true
 
   /is-alphanumerical/2.0.1:
     resolution: {integrity: sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==}
     dependencies:
       is-alphabetical: 2.0.1
       is-decimal: 2.0.1
-    dev: true
 
   /is-arguments/1.1.1:
     resolution: {integrity: sha512-8Q7EARjzEnKpt/PCD7e1cgUS0a6X8u5tdSiMqXhojOdoV9TsMsiO+9VLC5vAmO8N7/GmXn7yjR8qnA6bVAEzfA==}
@@ -2069,20 +2362,17 @@ packages:
     dependencies:
       call-bind: 1.0.2
       has-tostringtag: 1.0.0
-    dev: true
 
   /is-bigint/1.0.4:
     resolution: {integrity: sha512-zB9CruMamjym81i2JZ3UMn54PKGsQzsJeo6xvN3HJJ4CAsQNB6iRutp2To77OfCNuoxspsIhzaPoO1zyCEhFOg==}
     dependencies:
       has-bigints: 1.0.1
-    dev: true
 
   /is-binary-path/2.1.0:
     resolution: {integrity: sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==}
     engines: {node: '>=8'}
     dependencies:
       binary-extensions: 2.2.0
-    dev: false
 
   /is-boolean-object/1.1.2:
     resolution: {integrity: sha512-gDYaKHJmnj4aWxyj6YHyXVpdQawtVLHU5cb+eztPGczf6cjuTdwve5ZIEfgXqH4e57An1D1AKf8CZ3kYrQRqYA==}
@@ -2090,7 +2380,6 @@ packages:
     dependencies:
       call-bind: 1.0.2
       has-tostringtag: 1.0.0
-    dev: true
 
   /is-buffer/2.0.5:
     resolution: {integrity: sha512-i2R6zNFDwgEHJyQUtJEk0XFi1i0dPFn/oqjK3/vPCcDeJvW5NQ83V8QbicfF1SupOaB0h8ntgBC2YiE7dfyctQ==}
@@ -2099,45 +2388,44 @@ packages:
   /is-callable/1.2.4:
     resolution: {integrity: sha512-nsuwtxZfMX67Oryl9LCQ+upnC0Z0BgpwntpS89m1H/TLF0zNfzfLMV/9Wa/6MZsj0acpEjAO0KF1xT6ZdLl95w==}
     engines: {node: '>= 0.4'}
-    dev: true
 
   /is-core-module/2.8.1:
     resolution: {integrity: sha512-SdNCUs284hr40hFTFP6l0IfZ/RSrMXF3qgoRHd3/79unUTvrFO/JoXwkGm+5J/Oe3E/b5GsnG330uUNgRpu1PA==}
     dependencies:
       has: 1.0.3
-    dev: true
 
   /is-date-object/1.0.5:
     resolution: {integrity: sha512-9YQaSxsAiSwcvS33MBk3wTCVnWK+HhF8VZR2jRxehM16QcVOdHqPn4VPHmRK4lSr38n9JriurInLcP90xsYNfQ==}
     engines: {node: '>= 0.4'}
     dependencies:
       has-tostringtag: 1.0.0
-    dev: true
 
   /is-decimal/2.0.1:
     resolution: {integrity: sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==}
+
+  /is-docker/2.2.1:
+    resolution: {integrity: sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==}
+    engines: {node: '>=8'}
+    hasBin: true
     dev: true
 
   /is-extendable/0.1.1:
     resolution: {integrity: sha1-YrEQ4omkcUGOPsNqYX1HLjAd/Ik=}
     engines: {node: '>=0.10.0'}
-    dev: true
 
   /is-extglob/2.1.1:
-    resolution: {integrity: sha1-qIwCU1eR8C7TfHahueqXc8gz+MI=}
+    resolution: {integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==}
     engines: {node: '>=0.10.0'}
 
   /is-fullwidth-code-point/3.0.0:
     resolution: {integrity: sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==}
     engines: {node: '>=8'}
-    dev: true
 
   /is-generator-function/1.0.10:
     resolution: {integrity: sha512-jsEjy9l3yiXEQ+PsXdmBwEPcOxaXWLspKdplFUVI9vq1iZgIekeC0L167qeu86czQaxed3q/Uzuw0swL0irL8A==}
     engines: {node: '>= 0.4'}
     dependencies:
       has-tostringtag: 1.0.0
-    dev: true
 
   /is-glob/4.0.3:
     resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==}
@@ -2147,12 +2435,10 @@ packages:
 
   /is-hexadecimal/2.0.1:
     resolution: {integrity: sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==}
-    dev: true
 
   /is-interactive/2.0.0:
     resolution: {integrity: sha512-qP1vozQRI+BMOPcjFzrjXuQvdak2pHNUMZoeG2eRbiSqyvbEf/wQtEOTOX1guk6E3t36RkaqiSt8A/6YElNxLQ==}
     engines: {node: '>=12'}
-    dev: true
 
   /is-nan/1.3.2:
     resolution: {integrity: sha512-E+zBKpQ2t6MEo1VsonYmluk9NxGrbzpeeLC2xIViuO2EjU2xsXsBPwTr3Ykv9l08UYEVEdWeRZNouaZqF6RN0w==}
@@ -2160,19 +2446,16 @@ packages:
     dependencies:
       call-bind: 1.0.2
       define-properties: 1.1.3
-    dev: true
 
   /is-negative-zero/2.0.2:
     resolution: {integrity: sha512-dqJvarLawXsFbNDeJW7zAz8ItJ9cd28YufuuFzh0G8pNHjJMnY08Dv7sYX2uF5UpQOwieAeOExEYAWWfu7ZZUA==}
     engines: {node: '>= 0.4'}
-    dev: true
 
   /is-number-object/1.0.7:
     resolution: {integrity: sha512-k1U0IRzLMo7ZlYIfzRu23Oh6MiIFasgpb9X76eqfFZAqwH44UI4KTBvBYIZ1dSL9ZzChTB9ShHfLkR4pdW5krQ==}
     engines: {node: '>= 0.4'}
     dependencies:
       has-tostringtag: 1.0.0
-    dev: true
 
   /is-number/7.0.0:
     resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==}
@@ -2188,32 +2471,27 @@ packages:
     dependencies:
       call-bind: 1.0.2
       has-tostringtag: 1.0.0
-    dev: true
 
   /is-shared-array-buffer/1.0.2:
     resolution: {integrity: sha512-sqN2UDu1/0y6uvXyStCOzyhAjCSlHceFoMKJW8W9EU9cvic/QdsZ0kEU93HEy3IUEFZIiH/3w+AH/UQbPHNdhA==}
     dependencies:
       call-bind: 1.0.2
-    dev: true
 
   /is-stream/3.0.0:
     resolution: {integrity: sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA==}
     engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
-    dev: true
 
   /is-string/1.0.7:
     resolution: {integrity: sha512-tE2UXzivje6ofPW7l23cjDOMa09gb7xlAqG6jG5ej6uPV32TlWP3NKPigtaGeHNu9fohccRYvIiZMfOOnOYUtg==}
     engines: {node: '>= 0.4'}
     dependencies:
       has-tostringtag: 1.0.0
-    dev: true
 
   /is-symbol/1.0.4:
     resolution: {integrity: sha512-C/CPBqKWnvdcxqIARxyOh4v1UUEOCHpgDa0WYgpKDFMszcrPcffg5uhwSgPCLD2WWxmq6isisz87tzT01tuGhg==}
     engines: {node: '>= 0.4'}
     dependencies:
       has-symbols: 1.0.3
-    dev: true
 
   /is-typed-array/1.1.8:
     resolution: {integrity: sha512-HqH41TNZq2fgtGT8WHVFVJhBVGuY3AnP3Q36K8JKXUxSxRgk/d+7NjmwG2vo2mYmXK8UYZKu0qH8bVP5gEisjA==}
@@ -2224,26 +2502,28 @@ packages:
       es-abstract: 1.19.2
       foreach: 2.0.5
       has-tostringtag: 1.0.0
-    dev: true
 
   /is-unicode-supported/1.2.0:
     resolution: {integrity: sha512-wH+U77omcRzevfIG8dDhTS0V9zZyweakfD01FULl97+0EHiJTTZtJqxPSkIIo/SDPv/i07k/C9jAPY+jwLLeUQ==}
     engines: {node: '>=12'}
-    dev: true
 
   /is-weakref/1.0.2:
     resolution: {integrity: sha512-qctsuLZmIQ0+vSSMfoVvyFe2+GSEvnmZ2ezTup1SBse9+twCCeial6EEi3Nc2KFcf6+qz2FBPnjXsk8xhKSaPQ==}
     dependencies:
       call-bind: 1.0.2
+
+  /is-wsl/2.2.0:
+    resolution: {integrity: sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww==}
+    engines: {node: '>=8'}
+    dependencies:
+      is-docker: 2.2.1
     dev: true
 
   /isexe/2.0.0:
-    resolution: {integrity: sha1-6PvzdNxVb/iUehDcsFctYz8s+hA=}
-    dev: true
+    resolution: {integrity: sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==}
 
   /js-tokens/4.0.0:
     resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==}
-    dev: true
 
   /js-yaml/3.14.1:
     resolution: {integrity: sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==}
@@ -2251,6 +2531,12 @@ packages:
     dependencies:
       argparse: 1.0.10
       esprima: 4.0.1
+
+  /js-yaml/4.1.0:
+    resolution: {integrity: sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==}
+    hasBin: true
+    dependencies:
+      argparse: 2.0.1
     dev: true
 
   /js2xmlparser/4.0.2:
@@ -2300,26 +2586,29 @@ packages:
     resolution: {integrity: sha512-OYu7XEzjkCQ3C5Ps3QIZsQfNpqoJyZZA99wd9aWd05NCtC5pWOkShK2mkL6HXQR6/Cy2lbNdPlZBpuQHXE63gA==}
     engines: {node: '>=4'}
     hasBin: true
+
+  /json-schema-traverse/0.4.1:
+    resolution: {integrity: sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==}
+    dev: true
+
+  /json-stable-stringify-without-jsonify/1.0.1:
+    resolution: {integrity: sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==}
     dev: true
 
   /json5/2.2.1:
     resolution: {integrity: sha512-1hqLFMSrGHRHxav9q9gNjJ5EXznIxGVO09xQRrwplcS8qs28pZ8s8hupZAmqDwZUmVZ2Qb2jnyPOWcDH8m8dlA==}
     engines: {node: '>=6'}
     hasBin: true
-    dev: true
 
   /jsonc-parser/2.3.1:
     resolution: {integrity: sha512-H8jvkz1O50L3dMZCsLqiuB2tA7muqbSg1AtGEkN0leAqGjsUzDJir3Zwr02BhqdcITPg3ei3mZ+HjMocAknhhg==}
-    dev: true
 
   /jsonc-parser/3.0.0:
     resolution: {integrity: sha512-fQzRfAbIBnR0IQvftw9FJveWiHp72Fg20giDrHz6TdfB12UH/uue0D3hm57UB5KgAVuniLMCaS8P1IMj9NR7cA==}
-    dev: true
 
   /kind-of/6.0.3:
     resolution: {integrity: sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==}
     engines: {node: '>=0.10.0'}
-    dev: true
 
   /klaw/4.0.1:
     resolution: {integrity: sha512-pgsE40/SvC7st04AHiISNewaIMUbY5V/K8b21ekiPiFoYs/EYSdsGa+FJArB1d441uq4Q8zZyIxvAzkGNlBdRw==}
@@ -2329,16 +2618,22 @@ packages:
   /kleur/3.0.3:
     resolution: {integrity: sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==}
     engines: {node: '>=6'}
-    dev: true
 
   /kleur/4.1.4:
     resolution: {integrity: sha512-8QADVssbrFjivHWQU7KkMgptGTl6WAcSdlbBPY4uNF+mWr6DGcKrvY2w4FQJoXch7+fKMjj0dRrL75vk3k23OA==}
     engines: {node: '>=6'}
 
+  /levn/0.4.1:
+    resolution: {integrity: sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==}
+    engines: {node: '>= 0.8.0'}
+    dependencies:
+      prelude-ls: 1.2.1
+      type-check: 0.4.0
+    dev: true
+
   /lilconfig/2.0.5:
     resolution: {integrity: sha512-xaYmXZtTHPAw5m+xLN8ab9C+3a8YmV3asNSPOATITbtwrfbwaLJj8h66H1WMIpALCkqsIzK3h7oQ+PdX+LQ9Eg==}
     engines: {node: '>=10'}
-    dev: true
 
   /linkify-it/3.0.3:
     resolution: {integrity: sha512-ynTsyrFSdE5oZ/O9GEf00kPngmOfVwazR5GKDq6EYfhlpFug3J2zybX56a2PRRpc9P+FuSoGNAwjlbDs9jJBPQ==}
@@ -2354,20 +2649,21 @@ packages:
       js-yaml: 3.14.1
       pify: 4.0.1
       strip-bom: 3.0.0
-    dev: true
 
   /locate-path/5.0.0:
     resolution: {integrity: sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==}
     engines: {node: '>=8'}
     dependencies:
       p-locate: 4.1.0
-    dev: true
 
   /locate-path/6.0.0:
     resolution: {integrity: sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==}
     engines: {node: '>=10'}
     dependencies:
       p-locate: 5.0.0
+
+  /lodash.merge/4.6.2:
+    resolution: {integrity: sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==}
     dev: true
 
   /lodash/4.17.21:
@@ -2379,7 +2675,6 @@ packages:
     dependencies:
       chalk: 5.0.1
       is-unicode-supported: 1.2.0
-    dev: true
 
   /longest-streak/3.0.1:
     resolution: {integrity: sha512-cHlYSUpL2s7Fb3394mYxwTYj8niTaNHUCLr0qdiCXQfSjfuA7CKofpX2uSwEfFDQ0EB7JcnMnm+GjbqqoinYYg==}
@@ -2389,26 +2684,22 @@ packages:
     hasBin: true
     dependencies:
       js-tokens: 4.0.0
-    dev: true
 
   /lower-case/2.0.2:
     resolution: {integrity: sha512-7fm3l3NAF9WfN6W3JOmf5drwpVqX78JtoGJ3A6W0a6ZnldM41w2fV5D490psKFTpMds8TJse/eHLFFsNHHjHgg==}
     dependencies:
-      tslib: 2.3.1
-    dev: true
+      tslib: 2.4.0
 
   /lru-cache/6.0.0:
     resolution: {integrity: sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==}
     engines: {node: '>=10'}
     dependencies:
       yallist: 4.0.0
-    dev: true
 
   /magic-string/0.25.9:
     resolution: {integrity: sha512-RmF0AsMzgt25qzqqLc1+MbHmhdx0ojF2Fvs4XnOqz2ZOBXzzkEwc/dJQZCYHAn7v1jbVOjAZfK8msRn4BxO4VQ==}
     dependencies:
       sourcemap-codec: 1.4.8
-    dev: true
 
   /markdown-it-anchor/8.4.1_2zb4u3vubltivolgu556vv4aom:
     resolution: {integrity: sha512-sLODeRetZ/61KkKLJElaU3NuU2z7MhXf12Ml1WJMSdwpngeofneCRF+JBbat8HiSqhniOMuTemXMrsI7hA6XyA==}
@@ -2446,7 +2737,6 @@ packages:
       '@types/mdast': 3.0.10
       '@types/unist': 2.0.6
       unist-util-visit: 3.1.0
-    dev: true
 
   /mdast-util-find-and-replace/2.1.0:
     resolution: {integrity: sha512-1w1jbqAd13oU78QPBf5223+xB+37ecNtQ1JElq2feWols5oEYAl+SgNDnOZipe7NfLemoEt362yUS15/wip4mw==}
@@ -2532,7 +2822,6 @@ packages:
       mdast-util-to-markdown: 1.3.0
     transitivePeerDependencies:
       - supports-color
-    dev: true
 
   /mdast-util-mdx-jsx/1.2.0:
     resolution: {integrity: sha512-5+ot/kfxYd3ChgEMwsMUO71oAfYjyRI3pADEK4I7xTmWLGQ8Y7ghm1CG36zUoUvDPxMlIYwQV/9DYHAUWdG4dA==}
@@ -2545,7 +2834,6 @@ packages:
       unist-util-remove-position: 4.0.1
       unist-util-stringify-position: 3.0.2
       vfile-message: 3.1.2
-    dev: true
 
   /mdast-util-to-hast/12.1.1:
     resolution: {integrity: sha512-qE09zD6ylVP14jV4mjLIhDBOrpFdShHZcEsYvvKGABlr9mGbV7mTlRWdoFxL/EYSTNDiC9GZXy7y8Shgb9Dtzw==}
@@ -2560,7 +2848,6 @@ packages:
       unist-util-generated: 2.0.0
       unist-util-position: 4.0.3
       unist-util-visit: 4.1.0
-    dev: true
 
   /mdast-util-to-markdown/1.3.0:
     resolution: {integrity: sha512-6tUSs4r+KK4JGTTiQ7FfHmVOaDrLQJPmpjD6wPMlHGUVXoG9Vjc3jIeP+uyBWRf8clwB2blM+W7+KrlMYQnftA==}
@@ -2581,12 +2868,10 @@ packages:
 
   /merge-stream/2.0.0:
     resolution: {integrity: sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==}
-    dev: true
 
   /merge2/1.4.1:
     resolution: {integrity: sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==}
     engines: {node: '>= 8'}
-    dev: true
 
   /micromark-core-commonmark/1.0.6:
     resolution: {integrity: sha512-K+PkJTxqjFfSNkfAhp4GB+cZPfQd6dxtTXnf+RjZOV7T4EEXnvgzOcnp+eSTmpGk9d1S9sL6/lqrgSNn/s0HZA==}
@@ -2686,7 +2971,6 @@ packages:
       micromark-util-types: 1.0.2
       uvu: 0.5.3
       vfile-message: 3.1.2
-    dev: true
 
   /micromark-factory-destination/1.0.0:
     resolution: {integrity: sha512-eUBA7Rs1/xtTVun9TmV3gjfPz2wEwgK5R5xcbIM5ZYAtvGF6JkyaDsj0agx8urXnO31tEO6Ug83iVH3tdedLnw==}
@@ -2714,7 +2998,6 @@ packages:
       unist-util-position-from-estree: 1.1.1
       uvu: 0.5.3
       vfile-message: 3.1.2
-    dev: true
 
   /micromark-factory-space/1.0.0:
     resolution: {integrity: sha512-qUmqs4kj9a5yBnk3JMLyjtWYN6Mzfcx8uJfi5XAveBniDevmZasdGBba5b4QsvRcAkmvGo5ACmSUmyGiKTLZew==}
@@ -2788,7 +3071,6 @@ packages:
       micromark-util-types: 1.0.2
       uvu: 0.5.3
       vfile-message: 3.1.2
-    dev: true
 
   /micromark-util-html-tag-name/1.0.0:
     resolution: {integrity: sha512-NenEKIshW2ZI/ERv9HtFNsrn3llSPZtY337LID/24WeLqMzeZhBEE6BQ0vS2ZBjshm5n40chKtJ3qjAbVV8S0g==}
@@ -2853,33 +3135,27 @@ packages:
     dependencies:
       braces: 3.0.2
       picomatch: 2.3.1
-    dev: true
 
   /micromorph/0.1.2:
     resolution: {integrity: sha512-pDEgWjUoCMBwME8z8UiCOO6FKH0It1LASFh8hFSk8uSyfyw6rqY4PBk2LiIEPaVHwtLDhozp4Pr0I+yAUfCpiA==}
-    dev: true
 
   /mime/3.0.0:
     resolution: {integrity: sha512-jSCU7/VB1loIWBZe14aEYHU/+1UMEHoaO7qxCOVJOw9GgH72VAWppxNcjU+x9a2k3GSIBXNKxXQFqRvvZ7vr3A==}
     engines: {node: '>=10.0.0'}
     hasBin: true
-    dev: true
 
   /mimic-fn/2.1.0:
     resolution: {integrity: sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==}
     engines: {node: '>=6'}
-    dev: true
 
   /mimic-fn/4.0.0:
     resolution: {integrity: sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw==}
     engines: {node: '>=12'}
-    dev: true
 
   /minimatch/3.1.2:
     resolution: {integrity: sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==}
     dependencies:
       brace-expansion: 1.1.11
-    dev: false
 
   /mkdirp/1.0.4:
     resolution: {integrity: sha512-vVqVZQyf3WLx2Shd0qJ9xuvqgAyKPLAiqITEtqW0oIUjzo3PePDd6fW9iFz30ef7Ysp/oiWqbhszeGWW2T6Gzw==}
@@ -2898,7 +3174,6 @@ packages:
   /mrmime/1.0.0:
     resolution: {integrity: sha512-a70zx7zFfVO7XpnQ2IX1Myh9yY4UYvfld/dikWRnsXxbyvMcfz+u6UfgNAtH+k2QqtJuzVpv6eLTx1G2+WKZbQ==}
     engines: {node: '>=10'}
-    dev: true
 
   /ms/2.1.2:
     resolution: {integrity: sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==}
@@ -2907,6 +3182,9 @@ packages:
     resolution: {integrity: sha512-CuHBogktKwpm5g2sRgv83jEy2ijFzBwMoYA60orPDR7ynsLijJDqgsi4RDGj3OJpy3Ieb+LYwiRmIOGyytgITA==}
     engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
     hasBin: true
+
+  /natural-compare/1.4.0:
+    resolution: {integrity: sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==}
     dev: true
 
   /nlcst-to-string/2.0.4:
@@ -2921,8 +3199,7 @@ packages:
     resolution: {integrity: sha512-fgAN3jGAh+RoxUGZHTSOLJIqUc2wmoBwGR4tbpNAKmmovFoWq0OdRkb0VkldReO2a2iBT/OEulG9XSUc10r3zg==}
     dependencies:
       lower-case: 2.0.2
-      tslib: 2.3.1
-    dev: true
+      tslib: 2.4.0
 
   /node-domexception/1.0.0:
     resolution: {integrity: sha512-/jKZoMpw0F8GRwl4/eLROPA3cfcXtLApP0QzLmUT/HuPCZWyB7IY9ZrMeKw2O/nFIqPQB3PVM9aYm0F312AXDQ==}
@@ -2940,28 +3217,23 @@ packages:
 
   /node-releases/2.0.2:
     resolution: {integrity: sha512-XxYDdcQ6eKqp/YjI+tb2C5WM2LgjnZrfYg4vgQt49EK268b6gYCHsBLrK2qvJo4FmCtqmKezb0WZFK4fkrZNsg==}
-    dev: true
 
   /normalize-path/3.0.0:
     resolution: {integrity: sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==}
     engines: {node: '>=0.10.0'}
-    dev: false
 
   /npm-run-path/5.1.0:
     resolution: {integrity: sha512-sJOdmRGrY2sjNTRMbSvluQqg+8X7ZK61yvzBEIDhz4f8z1TZFYABsqjjCBd/0PUNE9M6QDgHJXQkGUEm7Q+l9Q==}
     engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
     dependencies:
       path-key: 4.0.0
-    dev: true
 
   /object-assign/4.1.1:
     resolution: {integrity: sha1-IQmtx5ZYh8/AXLvUQsrIv7s2CGM=}
     engines: {node: '>=0.10.0'}
-    dev: true
 
   /object-inspect/1.12.0:
     resolution: {integrity: sha512-Ho2z80bVIvJloH+YzRmpZVQe87+qASmBUKZDWgx9cu+KDrX2ZDH/3tMy+gXbZETVGs2M8YdxObOh7XAtim9Y0g==}
-    dev: true
 
   /object-is/1.1.5:
     resolution: {integrity: sha512-3cyDsyHgtmi7I7DfSSI2LDp6SK2lwvtbg0p0R1e0RvTqF5ceGx+K2dfSjm1bKDMVCFEDAQvy+o8c6a7VujOddw==}
@@ -2969,12 +3241,10 @@ packages:
     dependencies:
       call-bind: 1.0.2
       define-properties: 1.1.3
-    dev: true
 
   /object-keys/1.1.1:
     resolution: {integrity: sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==}
     engines: {node: '>= 0.4'}
-    dev: true
 
   /object-to-spawn-args/2.0.1:
     resolution: {integrity: sha512-6FuKFQ39cOID+BMZ3QaphcC8Y4cw6LXBLyIgPU+OhIYwviJamPAn+4mITapnSBQrejB+NNp+FMskhD8Cq+Ys3w==}
@@ -2989,26 +3259,43 @@ packages:
       define-properties: 1.1.3
       has-symbols: 1.0.3
       object-keys: 1.1.1
-    dev: true
 
   /once/1.4.0:
     resolution: {integrity: sha1-WDsap3WWHUsROsF9nFC6753Xa9E=}
     dependencies:
       wrappy: 1.0.2
-    dev: false
 
   /onetime/5.1.2:
     resolution: {integrity: sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==}
     engines: {node: '>=6'}
     dependencies:
       mimic-fn: 2.1.0
-    dev: true
 
   /onetime/6.0.0:
     resolution: {integrity: sha512-1FlR+gjXK7X+AsAHso35MnyN5KqGwJRi/31ft6x0M194ht7S+rWAvd7PHss9xSKMzE0asv1pyIHaJYq+BbacAQ==}
     engines: {node: '>=12'}
     dependencies:
       mimic-fn: 4.0.0
+
+  /open/8.4.0:
+    resolution: {integrity: sha512-XgFPPM+B28FtCCgSb9I+s9szOC1vZRSwgWsRUA5ylIxRTgKozqjOCrVOqGsYABPYK5qnfqClxZTFBa8PKt2v6Q==}
+    engines: {node: '>=12'}
+    dependencies:
+      define-lazy-prop: 2.0.0
+      is-docker: 2.2.1
+      is-wsl: 2.2.0
+    dev: true
+
+  /optionator/0.9.1:
+    resolution: {integrity: sha512-74RlY5FCnhq4jRxVUPKDaRwrVNXMqsGsiW6AJw4XK8hmtm10wC0ypZBLw5IIp85NZMr91+qd1RvvENwg7jjRFw==}
+    engines: {node: '>= 0.8.0'}
+    dependencies:
+      deep-is: 0.1.4
+      fast-levenshtein: 2.0.6
+      levn: 0.4.1
+      prelude-ls: 1.2.1
+      type-check: 0.4.0
+      word-wrap: 1.2.3
     dev: true
 
   /ora/6.1.0:
@@ -3024,39 +3311,40 @@ packages:
       log-symbols: 5.1.0
       strip-ansi: 7.0.1
       wcwidth: 1.0.1
-    dev: true
 
   /p-limit/2.3.0:
     resolution: {integrity: sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==}
     engines: {node: '>=6'}
     dependencies:
       p-try: 2.2.0
-    dev: true
 
   /p-limit/3.1.0:
     resolution: {integrity: sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==}
     engines: {node: '>=10'}
     dependencies:
       yocto-queue: 0.1.0
-    dev: true
 
   /p-locate/4.1.0:
     resolution: {integrity: sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==}
     engines: {node: '>=8'}
     dependencies:
       p-limit: 2.3.0
-    dev: true
 
   /p-locate/5.0.0:
     resolution: {integrity: sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==}
     engines: {node: '>=10'}
     dependencies:
       p-limit: 3.1.0
-    dev: true
 
   /p-try/2.2.0:
     resolution: {integrity: sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==}
     engines: {node: '>=6'}
+
+  /parent-module/1.0.1:
+    resolution: {integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==}
+    engines: {node: '>=6'}
+    dependencies:
+      callsites: 3.1.0
     dev: true
 
   /parse-entities/4.0.0:
@@ -3070,7 +3358,6 @@ packages:
       is-alphanumerical: 2.0.1
       is-decimal: 2.0.1
       is-hexadecimal: 2.0.1
-    dev: true
 
   /parse-latin/5.0.0:
     resolution: {integrity: sha512-Ht+4/+AUySMS5HKGAiQpBmkFsHSoGrj6Y83flLCa5OIBdtsVkO3UD4OtboJ0O0vZiOznH02x8qlwg9KLUVXuNg==}
@@ -3081,50 +3368,45 @@ packages:
 
   /parse5/6.0.1:
     resolution: {integrity: sha512-Ofn/CTFzRGTTxwpNEs9PP93gXShHcTq255nzRYSKe8AkVpZY7e1fpmTfOyoIvjP5HG7Z2ZM7VS9PPhQGW2pOpw==}
-    dev: true
 
   /pascal-case/3.1.2:
     resolution: {integrity: sha512-uWlGT3YSnK9x3BQJaOdcZwrnV6hPpd8jFH1/ucpiLRPh/2zCVJKS19E4GvYHvaCcACn3foXZ0cLB9Wrx1KGe5g==}
     dependencies:
       no-case: 3.0.4
-      tslib: 2.3.1
-    dev: true
+      tslib: 2.4.0
 
   /path-browserify/1.0.1:
     resolution: {integrity: sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==}
-    dev: true
 
   /path-exists/4.0.0:
     resolution: {integrity: sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==}
     engines: {node: '>=8'}
-    dev: true
 
   /path-is-absolute/1.0.1:
     resolution: {integrity: sha1-F0uSaHNVNP+8es5r9TpanhtcX18=}
     engines: {node: '>=0.10.0'}
-    dev: false
 
   /path-key/3.1.1:
     resolution: {integrity: sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==}
     engines: {node: '>=8'}
-    dev: true
 
   /path-key/4.0.0:
     resolution: {integrity: sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==}
     engines: {node: '>=12'}
-    dev: true
 
   /path-parse/1.0.7:
     resolution: {integrity: sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==}
-    dev: true
 
   /path-to-regexp/6.2.0:
     resolution: {integrity: sha512-f66KywYG6+43afgE/8j/GoiNyygk/bnoCbps++3ErRKsIYkGGupyv07R2Ok5m9i67Iqc+T2g1eAUGUPzWhYTyg==}
+
+  /path-type/4.0.0:
+    resolution: {integrity: sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==}
+    engines: {node: '>=8'}
     dev: true
 
   /picocolors/1.0.0:
     resolution: {integrity: sha512-1fygroTLlHu66zi26VoTDv8yRgm0Fccecssto+MhsZ0D/DGW2sm8E8AjW7NU5VVTRt5GxbeZ5qBuJr+HyLYkjQ==}
-    dev: true
 
   /picomatch/2.3.1:
     resolution: {integrity: sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==}
@@ -3133,14 +3415,12 @@ packages:
   /pify/4.0.1:
     resolution: {integrity: sha512-uB80kBFb/tfd68bVleG9T5GGsGPjJrLAUpR5PZIrhBnIaRTQRjqdJSsIKkOP6OAIFbj7GOrcudc5pNjZ+geV2g==}
     engines: {node: '>=6'}
-    dev: true
 
   /pkg-dir/4.2.0:
     resolution: {integrity: sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==}
     engines: {node: '>=8'}
     dependencies:
       find-up: 4.1.0
-    dev: true
 
   /postcss-load-config/3.1.4_postcss@8.4.12:
     resolution: {integrity: sha512-6DiM4E7v4coTE4uzA8U//WhtPwyhiim3eyjEMFCnUpzbrkK9wJHgKDT2mR+HbtSrd/NubVaYTOpSpjUl8NQeRg==}
@@ -3157,7 +3437,6 @@ packages:
       lilconfig: 2.0.5
       postcss: 8.4.12
       yaml: 1.10.2
-    dev: true
 
   /postcss/8.4.12:
     resolution: {integrity: sha512-lg6eITwYe9v6Hr5CncVbK70SoioNQIq81nsaG86ev5hAidQvmOeETBqs7jm43K2F5/Ley3ytDtriImV6TpNiSg==}
@@ -3166,7 +3445,6 @@ packages:
       nanoid: 3.3.2
       picocolors: 1.0.0
       source-map-js: 1.0.2
-    dev: true
 
   /preact-render-to-string/5.1.20_preact@10.7.1:
     resolution: {integrity: sha512-ivh2oOGzth0o7XqbatWUQ81WQGoJwSqDKP5z917SoqTWYCAr7dlBzMv3SAMTAu3Gr5g47BJwrvyO44H2Y10ubg==}
@@ -3189,6 +3467,10 @@ packages:
       find-yarn-workspace-root2: 1.2.16
       path-exists: 4.0.0
       which-pm: 2.0.0
+
+  /prelude-ls/1.2.1:
+    resolution: {integrity: sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==}
+    engines: {node: '>= 0.8.0'}
     dev: true
 
   /prettier/2.6.2:
@@ -3204,7 +3486,6 @@ packages:
   /prismjs/1.28.0:
     resolution: {integrity: sha512-8aaXdYvl1F7iC7Xm1spqSaY/OJBpYW3v+KJ+F17iYxvdc8sfjW194COK5wVhMZX45tGteiBQgdvD/nhxcRwylw==}
     engines: {node: '>=6'}
-    dev: true
 
   /prompts/2.4.2:
     resolution: {integrity: sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==}
@@ -3212,21 +3493,22 @@ packages:
     dependencies:
       kleur: 3.0.3
       sisteransi: 1.0.5
-    dev: true
 
   /property-information/6.1.1:
     resolution: {integrity: sha512-hrzC564QIl0r0vy4l6MvRLhafmUowhO/O3KgVSoXIbbA2Sz4j8HGpJc6T2cubRVwMwpdiG/vKGfhT4IixmKN9w==}
+
+  /punycode/2.1.1:
+    resolution: {integrity: sha512-XRsRjdf+j5ml+y/6GKHPZbrF/8p2Yga0JPtdqTIY2Xe5ohJPD9saDJJLPvp9+NSBprVvevdXZybnj2cv8OEd0A==}
+    engines: {node: '>=6'}
     dev: true
 
   /queue-microtask/1.2.3:
     resolution: {integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==}
-    dev: true
 
   /randombytes/2.1.0:
     resolution: {integrity: sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==}
     dependencies:
       safe-buffer: 5.2.1
-    dev: true
 
   /react-dom/17.0.2_react@17.0.2:
     resolution: {integrity: sha512-s4h96KtLDUQlsENhMn1ar8t2bEa+q/YAtj8pPPdIjPDGBDIVNsrD9aXNWqspUe6AzKCIG0C1HZZLqLV7qpOBGA==}
@@ -3237,7 +3519,6 @@ packages:
       object-assign: 4.1.1
       react: 17.0.2
       scheduler: 0.20.2
-    dev: true
 
   /react/17.0.2:
     resolution: {integrity: sha512-gnhPt75i/dq/z3/6q/0asP78D0u592D5L1pd7M8P+dck6Fu/jJeL6iVVK23fptSUZj8Vjf++7wXA8UNclGQcbA==}
@@ -3245,7 +3526,6 @@ packages:
     dependencies:
       loose-envify: 1.4.0
       object-assign: 4.1.1
-    dev: true
 
   /readable-stream/3.6.0:
     resolution: {integrity: sha512-BViHy7LKeTz4oNnkcLJ+lVSL6vpiFeX6/d3oSH8zCW7UxP2onchk+vTGB143xuFjHS3deTgkKoXXymXqymiIdA==}
@@ -3254,14 +3534,12 @@ packages:
       inherits: 2.0.4
       string_decoder: 1.3.0
       util-deprecate: 1.0.2
-    dev: true
 
   /readdirp/3.6.0:
     resolution: {integrity: sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==}
     engines: {node: '>=8.10.0'}
     dependencies:
       picomatch: 2.3.1
-    dev: false
 
   /recast/0.20.5:
     resolution: {integrity: sha512-E5qICoPoNL4yU0H0NoBDntNB0Q5oMSNh9usFctYniLBluTthi3RsQVBXIJNbApOlvSwW/RGxIuokPcAc59J5fQ==}
@@ -3271,6 +3549,10 @@ packages:
       esprima: 4.0.1
       source-map: 0.6.1
       tslib: 2.3.1
+
+  /regexpp/3.2.0:
+    resolution: {integrity: sha512-pq2bWo9mVD43nbts2wGv17XLiNLya+GklZ8kaDLV2Z08gDCsGpnKn9BFMepvWuHCbyVvY7J5o5+BVvoQbmlJLg==}
+    engines: {node: '>=8'}
     dev: true
 
   /rehype-autolink-headings/6.1.1:
@@ -3291,7 +3573,6 @@ packages:
       '@types/hast': 2.3.4
       hast-util-raw: 7.2.1
       unified: 10.1.2
-    dev: true
 
   /rehype-slug/5.0.1:
     resolution: {integrity: sha512-X5v3wV/meuOX9NFcGhJvUpEjIvQl2gDvjg3z40RVprYFt7q3th4qMmYLULiu3gXvbNX1ppx+oaa6JyY1W67pTA==}
@@ -3310,7 +3591,6 @@ packages:
       '@types/hast': 2.3.4
       hast-util-to-html: 8.0.3
       unified: 10.1.2
-    dev: true
 
   /remark-gfm/3.0.1:
     resolution: {integrity: sha512-lEFDoi2PICJyNrACFOfDD3JlLkuSbOa5Wd8EPt06HUdptv8Gn0bxYTdbU/XXQ3swAPkEaGxxPN9cbnMHvVu1Ig==}
@@ -3330,7 +3610,6 @@ packages:
       unified: 10.1.2
     transitivePeerDependencies:
       - supports-color
-    dev: true
 
   /remark-rehype/10.1.0:
     resolution: {integrity: sha512-EFmR5zppdBp0WQeDVZ/b66CWJipB2q2VLNFMabzDSGR66Z2fQii83G5gTBbgGEnEEA0QRussvrFHxk1HWGJskw==}
@@ -3339,7 +3618,6 @@ packages:
       '@types/mdast': 3.0.10
       mdast-util-to-hast: 12.1.1
       unified: 10.1.2
-    dev: true
 
   /remark-smartypants/2.0.0:
     resolution: {integrity: sha512-Rc0VDmr/yhnMQIz8n2ACYXlfw/P/XZev884QU1I5u+5DgJls32o97Vc1RbK3pfumLsJomS2yy8eT4Fxj/2MDVA==}
@@ -3355,6 +3633,11 @@ packages:
       lodash: 4.17.21
     dev: false
 
+  /resolve-from/4.0.0:
+    resolution: {integrity: sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==}
+    engines: {node: '>=4'}
+    dev: true
+
   /resolve/1.22.0:
     resolution: {integrity: sha512-Hhtrw0nLeSrFQ7phPp4OOcVjLPIeMnRlr5mcnVuMe7M/7eBn98A3hmFRLoFo3DLZkivSYwhRUJTyPyWAk56WLw==}
     hasBin: true
@@ -3362,7 +3645,6 @@ packages:
       is-core-module: 2.8.1
       path-parse: 1.0.7
       supports-preserve-symlinks-flag: 1.0.0
-    dev: true
 
   /restore-cursor/4.0.0:
     resolution: {integrity: sha512-I9fPXU9geO9bHOt9pHHOhOkYerIMsmVaWB0rA2AI9ERh/+x/i7MV5HKBNrg+ljO5eoPVgCcnFuRjJ9uH6I/3eg==}
@@ -3370,7 +3652,6 @@ packages:
     dependencies:
       onetime: 5.1.2
       signal-exit: 3.0.7
-    dev: true
 
   /retext-latin/3.1.0:
     resolution: {integrity: sha512-5MrD1tuebzO8ppsja5eEu+ZbBeUNCjoEarn70tkXOS7Bdsdf6tNahsv2bY0Z8VooFF6cw7/6S+d3yI/TMlMVVQ==}
@@ -3406,6 +3687,12 @@ packages:
   /reusify/1.0.4:
     resolution: {integrity: sha512-U9nH88a3fc/ekCF1l0/UP1IosiuIjyTh7hBvXVMHYgVcfGvt897Xguj2UOLDeI5BG2m7/uwyaLVT6fbtCwTyzw==}
     engines: {iojs: '>=1.0.0', node: '>=0.10.0'}
+
+  /rimraf/3.0.2:
+    resolution: {integrity: sha512-JZkJMZkAGFFPP2YqXZXPbMlMBgsxzE8ILs4lMIX/2o0L9UBw9O/Y3o6wFw/i9YLapcUJWwqbi3kdxIPdC62TIA==}
+    hasBin: true
+    dependencies:
+      glob: 7.2.0
     dev: true
 
   /rollup/2.70.2:
@@ -3414,13 +3701,11 @@ packages:
     hasBin: true
     optionalDependencies:
       fsevents: 2.3.2
-    dev: true
 
   /run-parallel/1.2.0:
     resolution: {integrity: sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==}
     dependencies:
       queue-microtask: 1.2.3
-    dev: true
 
   /sade/1.8.1:
     resolution: {integrity: sha512-xal3CZX1Xlo/k4ApwCFrHVACi9fBqJ7V+mwhBsuf/1IOKbBy098Fex+Wa/5QMubw09pSZ/u8EY8PWgevJsXp1A==}
@@ -3430,11 +3715,9 @@ packages:
 
   /safe-buffer/5.1.2:
     resolution: {integrity: sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==}
-    dev: true
 
   /safe-buffer/5.2.1:
     resolution: {integrity: sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==}
-    dev: true
 
   /sass/1.50.0:
     resolution: {integrity: sha512-cLsD6MEZ5URXHStxApajEh7gW189kkjn4Rc8DQweMyF+o5HF5nfEz8QYLMlPsTOD88DknatTmBWkOcw5/LnJLQ==}
@@ -3444,7 +3727,6 @@ packages:
       chokidar: 3.5.3
       immutable: 4.0.0
       source-map-js: 1.0.2
-    dev: false
 
   /sax/1.2.4:
     resolution: {integrity: sha512-NqVDv9TpANUjFm0N8uM5GxL36UgKi9/atZw+x7YFnQ8ckwFGKrl4xX4yWtrey3UJm5nP1kUbnYgLopqWNSRhWw==}
@@ -3455,7 +3737,6 @@ packages:
     dependencies:
       loose-envify: 1.4.0
       object-assign: 4.1.1
-    dev: true
 
   /section-matter/1.0.0:
     resolution: {integrity: sha512-vfD3pmTzGpufjScBh50YHKzEu2lxBWhVEHsNGoEXmCmn2hKGfeNLYMzCJpe8cD7gqX7TJluOVpBkAequ6dgMmA==}
@@ -3463,12 +3744,10 @@ packages:
     dependencies:
       extend-shallow: 2.0.1
       kind-of: 6.0.3
-    dev: true
 
   /semver/6.3.0:
     resolution: {integrity: sha512-b39TBaTSfV6yBrapU89p5fKekE2m/NwnDocOVruQFS1/veMgdzuPcnOM34M6CwxW8jH/lxEa5rBoDeUwu5HHTw==}
     hasBin: true
-    dev: true
 
   /semver/7.3.7:
     resolution: {integrity: sha512-QlYTucUYOews+WeEujDoEGziz4K6c47V/Bd+LjSSYcA94p+DmINdf7ncaUinThfvZyu13lN9OY1XDxt8C0Tw0g==}
@@ -3476,25 +3755,21 @@ packages:
     hasBin: true
     dependencies:
       lru-cache: 6.0.0
-    dev: true
 
   /serialize-javascript/6.0.0:
     resolution: {integrity: sha512-Qr3TosvguFt8ePWqsvRfrKyQXIiW+nGbYpy8XK24NQHE83caxWt+mIymTT19DGFbNWNLfEwsrkSmN64lVWB9ag==}
     dependencies:
       randombytes: 2.1.0
-    dev: true
 
   /shebang-command/2.0.0:
     resolution: {integrity: sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==}
     engines: {node: '>=8'}
     dependencies:
       shebang-regex: 3.0.0
-    dev: true
 
   /shebang-regex/3.0.0:
     resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==}
     engines: {node: '>=8'}
-    dev: true
 
   /shiki/0.10.1:
     resolution: {integrity: sha512-VsY7QJVzU51j5o1+DguUd+6vmCmZ5v/6gYu4vyYAhzjuNQU6P/vmSy4uQaOhvje031qQMiW0d2BwgMH52vqMng==}
@@ -3502,11 +3777,9 @@ packages:
       jsonc-parser: 3.0.0
       vscode-oniguruma: 1.6.2
       vscode-textmate: 5.2.0
-    dev: true
 
   /shorthash/0.0.2:
     resolution: {integrity: sha1-WbJo7sveWQOLMNogK8+93rLEpOs=}
-    dev: true
 
   /side-channel/1.0.4:
     resolution: {integrity: sha512-q5XPytqFEIKHkGdiMIrY10mvLRvnQh42/+GoBlFW3b2LXLE2xxJpZFdm94we0BaoV3RwJyGqg5wS7epxTv0Zvw==}
@@ -3514,11 +3787,9 @@ packages:
       call-bind: 1.0.2
       get-intrinsic: 1.1.1
       object-inspect: 1.12.0
-    dev: true
 
   /signal-exit/3.0.7:
     resolution: {integrity: sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==}
-    dev: true
 
   /simple-git/3.7.1:
     resolution: {integrity: sha512-+Osjtsumbtew2y9to0pOYjNzSIr4NkKGBg7Po5SUtjQhaJf2QBmiTX/9E9cv9rmc7oUiSGFIB9e7ys5ibnT9+A==}
@@ -3537,11 +3808,9 @@ packages:
       '@polka/url': 1.0.0-next.21
       mrmime: 1.0.0
       totalist: 3.0.0
-    dev: true
 
   /sisteransi/1.0.5:
     resolution: {integrity: sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==}
-    dev: true
 
   /sitemap/7.1.1:
     resolution: {integrity: sha512-mK3aFtjz4VdJN0igpIJrinf3EO8U8mxOPsTBzSsy06UtjZQJ3YY3o3Xa7zSc5nMqcMrRwlChHZ18Kxg0caiPBg==}
@@ -3554,10 +3823,14 @@ packages:
       sax: 1.2.4
     dev: true
 
+  /slash/3.0.0:
+    resolution: {integrity: sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==}
+    engines: {node: '>=8'}
+    dev: true
+
   /slash/4.0.0:
     resolution: {integrity: sha512-3dOsAHXXUkQTpOYcoAxLIorMTp4gIQr5IW3iVb7A7lFIp0VHhnynm9izx6TssdrIcVIESAlVjtnO2K8bg+Coew==}
     engines: {node: '>=12'}
-    dev: true
 
   /source-map-js/1.0.2:
     resolution: {integrity: sha512-R0XvVJ9WusLiqTCEiGCmICCMplcCkIwwR11mOSD9CR5u+IXYdiseeEuXCVAjS54zqwkLcPNnmU4OeJ6tUrWhDw==}
@@ -3566,29 +3839,23 @@ packages:
   /source-map/0.5.7:
     resolution: {integrity: sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=}
     engines: {node: '>=0.10.0'}
-    dev: true
 
   /source-map/0.6.1:
     resolution: {integrity: sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==}
     engines: {node: '>=0.10.0'}
-    dev: true
 
   /source-map/0.7.3:
     resolution: {integrity: sha512-CkCj6giN3S+n9qrYiBTX5gystlENnRW5jZeNLHpe6aue+SrHcG5VYwujhW9s4dY31mEGsxBDrHR6oI69fTXsaQ==}
     engines: {node: '>= 8'}
-    dev: true
 
   /sourcemap-codec/1.4.8:
     resolution: {integrity: sha512-9NykojV5Uih4lgo5So5dtw+f0JgJX30KCNI8gwhz2J9A15wD0Ml6tjHKwf6fTSa6fAdVBdZeNOs9eJ71qCk8vA==}
-    dev: true
 
   /space-separated-tokens/2.0.1:
     resolution: {integrity: sha512-ekwEbFp5aqSPKaqeY1PGrlGQxPNaq+Cnx4+bE2D8sciBQrHpbwoBbawqTN2+6jPs9IdWxxiUcN0K2pkczD3zmw==}
-    dev: true
 
   /sprintf-js/1.0.3:
     resolution: {integrity: sha1-BOaSb2YolTVPPdAVIDYzuFcpfiw=}
-    dev: true
 
   /stream-connect/1.0.2:
     resolution: {integrity: sha1-GLyB8u2zW4tdmoAJIAqYUxRCipc=}
@@ -3609,7 +3876,6 @@ packages:
       emoji-regex: 8.0.0
       is-fullwidth-code-point: 3.0.0
       strip-ansi: 6.0.1
-    dev: true
 
   /string-width/5.1.2:
     resolution: {integrity: sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==}
@@ -3618,113 +3884,94 @@ packages:
       eastasianwidth: 0.2.0
       emoji-regex: 9.2.2
       strip-ansi: 7.0.1
-    dev: true
 
   /string.prototype.trimend/1.0.4:
     resolution: {integrity: sha512-y9xCjw1P23Awk8EvTpcyL2NIr1j7wJ39f+k6lvRnSMz+mz9CGz9NYPelDk42kOz6+ql8xjfK8oYzy3jAP5QU5A==}
     dependencies:
       call-bind: 1.0.2
       define-properties: 1.1.3
-    dev: true
 
   /string.prototype.trimstart/1.0.4:
     resolution: {integrity: sha512-jh6e984OBfvxS50tdY2nRZnoC5/mLFKOREQfw8t5yytkoUsJRNxvI/E39qu1sD0OtWI3OC0XgKSmcWwziwYuZw==}
     dependencies:
       call-bind: 1.0.2
       define-properties: 1.1.3
-    dev: true
 
   /string_decoder/1.3.0:
     resolution: {integrity: sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==}
     dependencies:
       safe-buffer: 5.2.1
-    dev: true
 
   /stringify-entities/4.0.2:
     resolution: {integrity: sha512-MTxTVcEkorNtBbNpoFJPEh0kKdM6+QbMjLbaxmvaPMmayOXdr/AIVIIJX7FReUVweRBFJfZepK4A4AKgwuFpMQ==}
     dependencies:
       character-entities-html4: 2.1.0
       character-entities-legacy: 3.0.0
-    dev: true
 
   /strip-ansi/6.0.1:
     resolution: {integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==}
     engines: {node: '>=8'}
     dependencies:
       ansi-regex: 5.0.1
-    dev: true
 
   /strip-ansi/7.0.1:
     resolution: {integrity: sha512-cXNxvT8dFNRVfhVME3JAe98mkXDYN2O1l7jmcwMnOslDeESg1rF/OZMtK0nRAhiari1unG5cD4jG3rapUAkLbw==}
     engines: {node: '>=12'}
     dependencies:
       ansi-regex: 6.0.1
-    dev: true
 
   /strip-bom-string/1.0.0:
     resolution: {integrity: sha1-5SEekiQ2n7uB1jOi8ABE3IztrZI=}
     engines: {node: '>=0.10.0'}
-    dev: true
 
   /strip-bom/3.0.0:
     resolution: {integrity: sha1-IzTBjpx1n3vdVv3vfprj1YjmjtM=}
     engines: {node: '>=4'}
-    dev: true
 
   /strip-bom/4.0.0:
     resolution: {integrity: sha512-3xurFv5tEgii33Zi8Jtp55wEIILR9eh34FAW00PZf+JnSsTmV/ioewSgQl97JHvgjoRGwPShsWm+IdrxB35d0w==}
     engines: {node: '>=8'}
-    dev: true
 
   /strip-final-newline/3.0.0:
     resolution: {integrity: sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw==}
     engines: {node: '>=12'}
-    dev: true
 
   /strip-json-comments/3.1.1:
     resolution: {integrity: sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==}
     engines: {node: '>=8'}
-    dev: false
 
   /strnum/1.0.5:
     resolution: {integrity: sha512-J8bbNyKKXl5qYcR36TIO8W3mVGVHrmmxsd5PAItGkmyzwJvybiw2IVq5nqd0i4LSNSkB/sx9VHllbfFdr9k1JA==}
-    dev: true
 
   /style-to-object/0.3.0:
     resolution: {integrity: sha512-CzFnRRXhzWIdItT3OmF8SQfWyahHhjq3HwcMNCNLn+N7klOOqPjMeG/4JSu77D7ypZdGvSzvkrbyeTMizz2VrA==}
     dependencies:
       inline-style-parser: 0.1.1
-    dev: true
 
   /supports-color/5.5.0:
     resolution: {integrity: sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==}
     engines: {node: '>=4'}
     dependencies:
       has-flag: 3.0.0
-    dev: true
 
   /supports-color/7.2.0:
     resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==}
     engines: {node: '>=8'}
     dependencies:
       has-flag: 4.0.0
-    dev: true
 
   /supports-esm/1.0.0:
     resolution: {integrity: sha512-96Am8CDqUaC0I2+C/swJ0yEvM8ZnGn4unoers/LSdE4umhX7mELzqyLzx3HnZAluq5PXIsGMKqa7NkqaeHMPcg==}
     dependencies:
       has-package-exports: 1.3.0
-    dev: true
 
   /supports-preserve-symlinks-flag/1.0.0:
     resolution: {integrity: sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==}
     engines: {node: '>= 0.4'}
-    dev: true
 
   /svelte/3.46.6:
     resolution: {integrity: sha512-o9nNft/OzCz/9kJpmWa1S52GAM+huCjPIsNWydYmgei74ZWlOA9/hN9+Z12INdklghu31seEXZMRHhS1+8DETw==}
     engines: {node: '>= 8'}
-    dev: true
 
   /svelte2tsx/0.5.7_liohzkyisnst3glff4denqdl5m:
     resolution: {integrity: sha512-rekPWR5at7DNvIlJRSCyKFZ6Go/KyqjDRL/zRWQSNMbvTIocsm/gDtSbLz64ZP5Qz3tUeod7QzDqX13lF60kCg==}
@@ -3736,6 +3983,13 @@ packages:
       pascal-case: 3.1.2
       svelte: 3.46.6
       typescript: 4.6.3
+
+  /synckit/0.7.1:
+    resolution: {integrity: sha512-Cvv0Nzgs4Z0V6761qp4CU2+C15HRmnHaDd+sAtisbOnzIZ5wgl3ne076k28cHo+oY6eN/w0RNzRrf7CJz8dWJg==}
+    engines: {node: '>=12.20'}
+    dependencies:
+      '@pkgr/utils': 2.2.0
+      tslib: 2.4.0
     dev: true
 
   /taffydb/2.6.2:
@@ -3746,6 +4000,17 @@ packages:
     resolution: {integrity: sha1-JLFUOXOrRCiW2a02fdnL2/r+kYs=}
     dev: false
 
+  /text-table/0.2.0:
+    resolution: {integrity: sha1-f17oI66AUgfACvLfSoTsP8+lcLQ=}
+    dev: true
+
+  /tiny-glob/0.2.9:
+    resolution: {integrity: sha512-g/55ssRPUjShh+xkfx9UPDXqhckHEsHr4Vd9zX55oSdGZc/MD0m3sferOkwWtp98bv+kcVfEHtRJgBVJzelrzg==}
+    dependencies:
+      globalyzer: 0.1.0
+      globrex: 0.1.2
+    dev: true
+
   /to-fast-properties/2.0.0:
     resolution: {integrity: sha1-3F5pjL0HkmW8c+A3doGk5Og/YW4=}
     engines: {node: '>=4'}
@@ -3759,7 +4024,6 @@ packages:
   /totalist/3.0.0:
     resolution: {integrity: sha512-eM+pCBxXO/njtF7vdFsHuqb+ElbxqtI4r5EAvk6grfAFyJ6IvWlSkfZ5T9ozC6xWw3Fj1fGoSmrl0gUs46JVIw==}
     engines: {node: '>=6'}
-    dev: true
 
   /trough/2.1.0:
     resolution: {integrity: sha512-AqTiAOLcj85xS7vQ8QkAV41hPDIJ71XJB4RCUrzo/1GM2CQwhkJGaf9Hgr7BOugMRpgGUrqRg/DrBDl4H40+8g==}
@@ -3773,11 +4037,16 @@ packages:
       resolve: 1.22.0
       strip-bom: 4.0.0
       type-fest: 0.13.1
+
+  /tslib/1.14.1:
+    resolution: {integrity: sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==}
     dev: true
 
   /tslib/2.3.1:
     resolution: {integrity: sha512-77EbyPPpMz+FRFRuAFlWMtmgUWGe9UOG2Z25NqCwiIjRhOf5iKGuzSe5P2w1laq+FkRy4p+PCuVkJSGkzTEKVw==}
-    dev: true
+
+  /tslib/2.4.0:
+    resolution: {integrity: sha512-d6xOpEDfsi2CZVlPQzGeux8XMwLT9hssAsaPYExaQMuYskwb+x1x7J371tWlbBdWHroy99KnVB6qIkUbs5X3UQ==}
 
   /tsm/2.2.1:
     resolution: {integrity: sha512-qvJB0baPnxQJolZru11mRgGTdNlx17WqgJnle7eht3Vhb+VUR4/zFA5hFl6NqRe7m8BD9w/6yu0B2XciRrdoJA==}
@@ -3785,6 +4054,15 @@ packages:
     hasBin: true
     dependencies:
       esbuild: 0.14.38
+
+  /tsutils/3.21.0_typescript@4.7.2:
+    resolution: {integrity: sha512-mHKK3iUXL+3UF6xL5k0PEhKRUBKPBCv/+RkEOpjRWxxx27KKRBmmA60A9pgOUvMi8GKhRMPEmjBRPzs2W7O1OA==}
+    engines: {node: '>= 6'}
+    peerDependencies:
+      typescript: '>=2.8.0 || >= 3.2.0-dev || >= 3.3.0-dev || >= 3.4.0-dev || >= 3.5.0-dev || >= 3.6.0-dev || >= 3.6.0-beta || >= 3.7.0-dev || >= 3.7.0-beta'
+    dependencies:
+      tslib: 1.14.1
+      typescript: 4.7.2
     dev: true
 
   /tunnel/0.0.6:
@@ -3792,20 +4070,35 @@ packages:
     engines: {node: '>=0.6.11 <=0.7.0 || >=0.7.3'}
     dev: true
 
+  /type-check/0.4.0:
+    resolution: {integrity: sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==}
+    engines: {node: '>= 0.8.0'}
+    dependencies:
+      prelude-ls: 1.2.1
+    dev: true
+
   /type-fest/0.13.1:
     resolution: {integrity: sha512-34R7HTnG0XIJcBSn5XhDd7nNFPRcXYRZrBB2O2jdKqYODldSzBAqzsWoZYYvduky73toYS/ESqxPvkDf/F0XMg==}
     engines: {node: '>=10'}
+
+  /type-fest/0.20.2:
+    resolution: {integrity: sha512-Ne+eE4r0/iWnpAxD852z3A+N0Bt5RN//NjJwRd2VFHEmrywxf5vsZlh4R6lixl6B+wz/8d+maTSAkN1FIkI3LQ==}
+    engines: {node: '>=10'}
     dev: true
 
   /type-fest/2.12.2:
     resolution: {integrity: sha512-qt6ylCGpLjZ7AaODxbpyBZSs9fCI9SkL3Z9q2oxMBQhs/uyY+VD8jHA8ULCGmWQJlBgqvO3EJeAngOHD8zQCrQ==}
     engines: {node: '>=12.20'}
-    dev: true
 
   /typescript/4.6.3:
     resolution: {integrity: sha512-yNIatDa5iaofVozS/uQJEl3JRWLKKGJKh6Yaiv0GLGSuhpFJe7P3SbHZ8/yjAHRQwKRoA6YZqlfjXWmVzoVSMw==}
     engines: {node: '>=4.2.0'}
     hasBin: true
+
+  /typescript/4.7.2:
+    resolution: {integrity: sha512-Mamb1iX2FDUpcTRzltPxgWMKy3fhg0TN378ylbktPGPK/99KbDtMQ4W1hwgsbPAsG3a0xKa1vmw4VKZQbkvz5A==}
+    engines: {node: '>=4.2.0'}
+    hasBin: true
     dev: true
 
   /typical/2.6.1:
@@ -3823,7 +4116,6 @@ packages:
       has-bigints: 1.0.1
       has-symbols: 1.0.3
       which-boxed-primitive: 1.0.2
-    dev: true
 
   /underscore/1.13.2:
     resolution: {integrity: sha512-ekY1NhRzq0B08g4bGuX4wd2jZx5GnKz6mKSqFL4nqBlfyMGiG10gDFhDTMEfYmDL6Jy0FUIZp7wiRB+0BP7J2g==}
@@ -3859,11 +4151,9 @@ packages:
     resolution: {integrity: sha512-GFxmfEAa0vi9i5sd0R2kcrI9ks0r82NasRq5QHh2ysGngrc6GiqD5CDf1FjPenY4vApmFASBIIlk/jj5J5YbmQ==}
     dependencies:
       '@types/unist': 2.0.6
-    dev: true
 
   /unist-util-generated/2.0.0:
     resolution: {integrity: sha512-TiWE6DVtVe7Ye2QxOVW9kqybs6cZexNwTwSMVgkfjEReqy/xwGpAXb99OxktoWwmL+Z+Epb0Dn8/GNDYP1wnUw==}
-    dev: true
 
   /unist-util-is/5.1.1:
     resolution: {integrity: sha512-F5CZ68eYzuSvJjGhCLPL3cYx45IxkqXSetCcRgUXtbcm50X2L9oOWQlfUfDdAf+6Pd27YDblBfdtmsThXmwpbQ==}
@@ -3872,7 +4162,6 @@ packages:
     resolution: {integrity: sha512-TOLoGOyT6pYI3JjTBZ1z76Rp7g+xcfgzuQDESuOUTZIkqpOIXsqZTvI25fKCYjMAmADbeulxusIgoB5IBPGZuQ==}
     dependencies:
       '@types/unist': 2.0.6
-    dev: true
 
   /unist-util-modify-children/2.0.0:
     resolution: {integrity: sha512-HGrj7JQo9DwZt8XFsX8UD4gGqOsIlCih9opG6Y+N11XqkBGKzHo8cvDi+MfQQgiZ7zXRUiQREYHhjOBHERTMdg==}
@@ -3883,20 +4172,17 @@ packages:
     resolution: {integrity: sha512-xtoY50b5+7IH8tFbkw64gisG9tMSpxDjhX9TmaJJae/XuxQ9R/Kc8Nv1eOsf43Gt4KV/LkriMy9mptDr7XLcaw==}
     dependencies:
       '@types/unist': 2.0.6
-    dev: true
 
   /unist-util-position/4.0.3:
     resolution: {integrity: sha512-p/5EMGIa1qwbXjA+QgcBXaPWjSnZfQ2Sc3yBEEfgPwsEmJd8Qh+DSk3LGnmOM4S1bY2C0AjmMnB8RuEYxpPwXQ==}
     dependencies:
       '@types/unist': 2.0.6
-    dev: true
 
   /unist-util-remove-position/4.0.1:
     resolution: {integrity: sha512-0yDkppiIhDlPrfHELgB+NLQD5mfjup3a8UYclHruTJWmY74je8g+CIFr79x5f6AkmzSwlvKLbs63hC0meOMowQ==}
     dependencies:
       '@types/unist': 2.0.6
       unist-util-visit: 4.1.0
-    dev: true
 
   /unist-util-stringify-position/3.0.2:
     resolution: {integrity: sha512-7A6eiDCs9UtjcwZOcCpM4aPII3bAAGv13E96IkawkOAW0OhH+yRxtY0lzo8KiHpzEMfH7Q+FizUmwp8Iqy5EWg==}
@@ -3924,7 +4210,6 @@ packages:
       '@types/unist': 2.0.6
       unist-util-is: 5.1.1
       unist-util-visit-parents: 4.1.1
-    dev: true
 
   /unist-util-visit/4.1.0:
     resolution: {integrity: sha512-n7lyhFKJfVZ9MnKtqbsqkQEk5P1KShj0+//V7mAcoI6bpbUjh3C/OG8HVD+pBihfh6Ovl01m8dkcv9HNqYajmQ==}
@@ -3933,9 +4218,14 @@ packages:
       unist-util-is: 5.1.1
       unist-util-visit-parents: 5.1.0
 
+  /uri-js/4.4.1:
+    resolution: {integrity: sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==}
+    dependencies:
+      punycode: 2.1.1
+    dev: true
+
   /util-deprecate/1.0.2:
     resolution: {integrity: sha1-RQ1Nyfpw3nMnYvvS1KKJgUGaDM8=}
-    dev: true
 
   /util/0.12.4:
     resolution: {integrity: sha512-bxZ9qtSlGUWSOy9Qa9Xgk11kSslpuZwaxCg4sNIDj6FLucDab2JxnHwyNTCpHMtK1MjoQiWQ6DiUMZYbSrO+Sw==}
@@ -3946,7 +4236,6 @@ packages:
       is-typed-array: 1.1.8
       safe-buffer: 5.2.1
       which-typed-array: 1.1.7
-    dev: true
 
   /uvu/0.5.3:
     resolution: {integrity: sha512-brFwqA3FXzilmtnIyJ+CxdkInkY/i4ErvP7uV0DnUVxQcQ55reuHphorpF+tZoVHK2MniZ/VJzI7zJQoc9T9Yw==}
@@ -3958,12 +4247,15 @@ packages:
       kleur: 4.1.4
       sade: 1.8.1
 
+  /v8-compile-cache/2.3.0:
+    resolution: {integrity: sha512-l8lCEmLcLYZh4nbunNZvQCJc5pv7+RCwa8q/LdUx8u7lsWvPDKmpodJAJNwkAhJC//dFY48KuIEmjtd4RViDrA==}
+    dev: true
+
   /vfile-location/4.0.1:
     resolution: {integrity: sha512-JDxPlTbZrZCQXogGheBHjbRWjESSPEak770XwWPfw5mTc1v1nWGLB/apzZxsx8a0SJVfF8HK8ql8RD308vXRUw==}
     dependencies:
       '@types/unist': 2.0.6
       vfile: 5.3.2
-    dev: true
 
   /vfile-message/3.1.2:
     resolution: {integrity: sha512-QjSNP6Yxzyycd4SVOtmKKyTsSvClqBPJcd00Z0zuPj3hOIjg0rUPG6DbFGPvUKRgYyaIWLPKpuEclcuvb3H8qA==}
@@ -4002,7 +4294,6 @@ packages:
       sass: 1.50.0
     optionalDependencies:
       fsevents: 2.3.2
-    dev: true
 
   /vscode-css-languageservice/5.4.1:
     resolution: {integrity: sha512-W7D3GKFXf97ReAaU4EZ2nxVO1kQhztbycJgc1b/Ipr0h8zYWr88BADmrXu02z+lsCS84D7Sr4hoUzDKeaFn2Kg==}
@@ -4011,7 +4302,6 @@ packages:
       vscode-languageserver-types: 3.16.0
       vscode-nls: 5.0.0
       vscode-uri: 3.0.3
-    dev: true
 
   /vscode-html-languageservice/4.2.4:
     resolution: {integrity: sha512-1HqvXKOq9WlZyW4HTD+0XzrjZoZ/YFrgQY2PZqktbRloHXVAUKm6+cAcvZi4YqKPVn05/CK7do+KBHfuSaEdbg==}
@@ -4020,54 +4310,43 @@ packages:
       vscode-languageserver-types: 3.16.0
       vscode-nls: 5.0.0
       vscode-uri: 3.0.3
-    dev: true
 
   /vscode-jsonrpc/6.0.0:
     resolution: {integrity: sha512-wnJA4BnEjOSyFMvjZdpiOwhSq9uDoK8e/kpRJDTaMYzwlkrhG1fwDIZI94CLsLzlCK5cIbMMtFlJlfR57Lavmg==}
     engines: {node: '>=8.0.0 || >=10.0.0'}
-    dev: true
 
   /vscode-languageserver-protocol/3.16.0:
     resolution: {integrity: sha512-sdeUoAawceQdgIfTI+sdcwkiK2KU+2cbEYA0agzM2uqaUy2UpnnGHtWTHVEtS0ES4zHU0eMFRGN+oQgDxlD66A==}
     dependencies:
       vscode-jsonrpc: 6.0.0
       vscode-languageserver-types: 3.16.0
-    dev: true
 
   /vscode-languageserver-textdocument/1.0.4:
     resolution: {integrity: sha512-/xhqXP/2A2RSs+J8JNXpiiNVvvNM0oTosNVmQnunlKvq9o4mupHOBAnnzH0lwIPKazXKvAKsVp1kr+H/K4lgoQ==}
-    dev: true
 
   /vscode-languageserver-types/3.16.0:
     resolution: {integrity: sha512-k8luDIWJWyenLc5ToFQQMaSrqCHiLwyKPHKPQZ5zz21vM+vIVUSvsRpcbiECH4WR88K2XZqc4ScRcZ7nk/jbeA==}
-    dev: true
 
   /vscode-languageserver/7.0.0:
     resolution: {integrity: sha512-60HTx5ID+fLRcgdHfmz0LDZAXYEV68fzwG0JWwEPBode9NuMYTIxuYXPg4ngO8i8+Ou0lM7y6GzaYWbiDL0drw==}
     hasBin: true
     dependencies:
       vscode-languageserver-protocol: 3.16.0
-    dev: true
 
   /vscode-nls/5.0.0:
     resolution: {integrity: sha512-u0Lw+IYlgbEJFF6/qAqG2d1jQmJl0eyAGJHoAJqr2HT4M2BNuQYSEiSE75f52pXHSJm8AlTjnLLbBFPrdz2hpA==}
-    dev: true
 
   /vscode-oniguruma/1.6.2:
     resolution: {integrity: sha512-KH8+KKov5eS/9WhofZR8M8dMHWN2gTxjMsG4jd04YhpbPR91fUj7rYQ2/XjeHCJWbg7X++ApRIU9NUwM2vTvLA==}
-    dev: true
 
   /vscode-textmate/5.2.0:
     resolution: {integrity: sha512-Uw5ooOQxRASHgu6C7GVvUxisKXfSgW4oFlO+aa+PAkgmH89O3CXxEEzNRNtHSqtXFTl0nAC1uYj0GMSH27uwtQ==}
-    dev: true
 
   /vscode-uri/2.1.2:
     resolution: {integrity: sha512-8TEXQxlldWAuIODdukIb+TR5s+9Ds40eSJrw+1iDDA9IFORPjMELarNQE3myz5XIkWWpdprmJjm1/SxMlWOC8A==}
-    dev: true
 
   /vscode-uri/3.0.3:
     resolution: {integrity: sha512-EcswR2S8bpR7fD0YPeS7r2xXExrScVMxg4MedACaWHEtx9ftCF/qHG1xGkolzTPcEmjTavCQgbVzHUIdTMzFGA==}
-    dev: true
 
   /walk-back/5.1.0:
     resolution: {integrity: sha512-Uhxps5yZcVNbLEAnb+xaEEMdgTXl9qAQDzKYejG2AZ7qPwRQ81lozY9ECDbjLPNWm7YsO1IK5rsP1KoQzXAcGA==}
@@ -4078,11 +4357,9 @@ packages:
     resolution: {integrity: sha1-8LDc+RW8X/FSivrbLA4XtTLaL+g=}
     dependencies:
       defaults: 1.0.3
-    dev: true
 
   /web-namespaces/2.0.1:
     resolution: {integrity: sha512-bKr1DkiNa2krS7qxNtdrtHAmzuYGFQLiQ13TsorsdT6ULTkPLKuu5+GsFpDlg6JFjUTwX2DyhMPG2be8uPrqsQ==}
-    dev: true
 
   /web-streams-polyfill/3.2.0:
     resolution: {integrity: sha512-EqPmREeOzttaLRm5HS7io98goBgZ7IVz79aDvqjD0kYXLtFZTc0T/U6wHTPKyIjb+MdN7DFIIX6hgdBEpWmfPA==}
@@ -4097,7 +4374,6 @@ packages:
       is-number-object: 1.0.7
       is-string: 1.0.7
       is-symbol: 1.0.4
-    dev: true
 
   /which-pm/2.0.0:
     resolution: {integrity: sha512-Lhs9Pmyph0p5n5Z3mVnN0yWcbQYUAD7rbQUiMsQxOJ3T57k7RFe35SUwWMf7dsbDZks1uOmw4AecB/JMDj3v/w==}
@@ -4105,7 +4381,6 @@ packages:
     dependencies:
       load-yaml-file: 0.2.0
       path-exists: 4.0.0
-    dev: true
 
   /which-typed-array/1.1.7:
     resolution: {integrity: sha512-vjxaB4nfDqwKI0ws7wZpxIlde1XrLX5uB0ZjpfshgmapJMD7jJWhZI+yToJTqaFByF0eNBcYxbjmCzoRP7CfEw==}
@@ -4117,7 +4392,6 @@ packages:
       foreach: 2.0.5
       has-tostringtag: 1.0.0
       is-typed-array: 1.1.8
-    dev: true
 
   /which/2.0.2:
     resolution: {integrity: sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==}
@@ -4125,13 +4399,16 @@ packages:
     hasBin: true
     dependencies:
       isexe: 2.0.0
-    dev: true
 
   /widest-line/4.0.1:
     resolution: {integrity: sha512-o0cyEG0e8GPzT4iGHphIOh0cJOV8fivsXxddQasHPHfoZf1ZexrfeA21w2NaEN1RHE+fXlfISmOE8R9N3u3Qig==}
     engines: {node: '>=12'}
     dependencies:
       string-width: 5.1.2
+
+  /word-wrap/1.2.3:
+    resolution: {integrity: sha512-Hz/mrNwitNRh/HUAtM/VT/5VH+ygD6DV7mYKZAtHOrbs8U7lvPS6xf7EJKMF0uW1KJCl0H701g3ZGus+muE5vQ==}
+    engines: {node: '>=0.10.0'}
     dev: true
 
   /wrap-ansi/8.0.1:
@@ -4141,11 +4418,9 @@ packages:
       ansi-styles: 6.1.0
       string-width: 5.1.2
       strip-ansi: 7.0.1
-    dev: true
 
   /wrappy/1.0.2:
     resolution: {integrity: sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8=}
-    dev: false
 
   /xmlcreate/2.0.4:
     resolution: {integrity: sha512-nquOebG4sngPmGPICTS5EnxqhKbCmz5Ox5hsszI2T6U5qdrJizBc+0ilYSEjTSzU0yZcmvppztXe/5Al5fUwdg==}
@@ -4153,26 +4428,21 @@ packages:
 
   /yallist/4.0.0:
     resolution: {integrity: sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==}
-    dev: true
 
   /yaml/1.10.2:
     resolution: {integrity: sha512-r3vXyErRCYJ7wg28yvBY5VSoAF8ZvlcW9/BwUzEtUsjvX/DKs24dIkuwjtuprwJJHsbyUbLApepYTR1BN4uHrg==}
     engines: {node: '>= 6'}
-    dev: true
 
   /yargs-parser/21.0.1:
     resolution: {integrity: sha512-9BK1jFpLzJROCI5TzwZL/TU4gqjK5xiHV/RfWLOahrjAko/e4DJkRDZQXfvqAsiZzzYhgAzbgz6lg48jcm4GLg==}
     engines: {node: '>=12'}
-    dev: true
 
   /yocto-queue/0.1.0:
     resolution: {integrity: sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==}
     engines: {node: '>=10'}
-    dev: true
 
   /zod/3.14.4:
     resolution: {integrity: sha512-U9BFLb2GO34Sfo9IUYp0w3wJLlmcyGoMd75qU9yf+DrdGA4kEx6e+l9KOkAlyUO0PSQzZCa3TR4qVlcmwqSDuw==}
-    dev: true
 
   /zwitch/2.0.2:
     resolution: {integrity: sha512-JZxotl7SxAJH0j7dN4pxsTV6ZLXoLdGME+PsjkL/DaBrVryK9kTGq06GfKrwcSOqypP+fdXGoCHE36b99fWVoA==}
diff --git a/scripts/lib/linkcheck/base/base.ts b/scripts/lib/linkcheck/base/base.ts
index 3421160a07dcf..794a871fb8c3d 100644
--- a/scripts/lib/linkcheck/base/base.ts
+++ b/scripts/lib/linkcheck/base/base.ts
@@ -24,8 +24,8 @@ export function indexOfHref (input: string, href: string, startIndex?: number) {
 	let i = input.indexOf(href, startIndex);
 	while (i !== -1) {
 		// Get the characters surrounding the current match (if any)
-		let charBefore = input[i - 1] || '';
-		let charAfter = input[i + href.length] || '';
+		const charBefore = input[i - 1] || '';
+		const charAfter = input[i + href.length] || '';
 		// If both characters are not a part of URLs in Markdown,
 		// we have a proper (non-partial) match, so return the index
 		if ((charBefore + charAfter).match(/^[\s"'()[\],.]*$/))
diff --git a/scripts/lib/linkcheck/checks/target-exists.ts b/scripts/lib/linkcheck/checks/target-exists.ts
index 7af961d6e089f..c5b9e12d27f06 100644
--- a/scripts/lib/linkcheck/checks/target-exists.ts
+++ b/scripts/lib/linkcheck/checks/target-exists.ts
@@ -33,7 +33,7 @@ export class TargetExists extends CheckBase {
 				return;
 
 			// Report links to missing page fragments (unknown URL hashes)
-			let decodedHash = url.hash && decodeURIComponent(url.hash);
+			const decodedHash = url.hash && decodeURIComponent(url.hash);
 			if (decodedHash && !linkedPage.hashes.includes(decodedHash)) {
 				context.report({
 					type: TargetExists.BrokenFragmentLink,
diff --git a/scripts/lib/linkcheck/steps/find-issues.ts b/scripts/lib/linkcheck/steps/find-issues.ts
index 3f7c14b7c0989..d111861e6b998 100644
--- a/scripts/lib/linkcheck/steps/find-issues.ts
+++ b/scripts/lib/linkcheck/steps/find-issues.ts
@@ -14,7 +14,7 @@ export function findLinkIssues (
 	options: LinkCheckerOptions,
 	state: LinkCheckerState,
 ) {
-	var linkIssues: LinkIssue[] = [];
+	const linkIssues: LinkIssue[] = [];
 
 	Object.values(allPages).forEach(page => {
 		linkIssues.push(...findLinkIssuesOnPage(page, allPages, options, state));
@@ -30,7 +30,7 @@ function findLinkIssuesOnPage (
 	state: LinkCheckerState,
 	checkSingleLinkHref?: string,
 ) {
-	var linkIssues: LinkIssue[] = [];
+	const linkIssues: LinkIssue[] = [];
 
 	options.checks.forEach(check => {
 		check.checkHtmlPage({
diff --git a/scripts/lib/linkcheck/steps/output-issues.ts b/scripts/lib/linkcheck/steps/output-issues.ts
index 4e64cba970987..0e3c98fcb247b 100644
--- a/scripts/lib/linkcheck/steps/output-issues.ts
+++ b/scripts/lib/linkcheck/steps/output-issues.ts
@@ -66,7 +66,7 @@ export function outputIssues (linkIssues: LinkIssue[], state: LinkCheckerState)
 	console.log();
 
 	if (issuesNotFoundInSource > 0) {
-		let warningText = dedentMd`*** Warning:
+		const warningText = dedentMd`*** Warning:
 			${formatCount(issuesNotFoundInSource, 'issue was|issues were')}
 			found in the build output, but not the Markdown source.
 			
diff --git a/src/components/Card.astro b/src/components/Card.astro
index 1c45c83ff4777..bc83f44afd750 100644
--- a/src/components/Card.astro
+++ b/src/components/Card.astro
@@ -1,5 +1,5 @@
 ---
-const { data, index } = Astro.props;
+const { data } = Astro.props;
 const hasScreenshot = !!data.demo;
 const backgroundStyle = hasScreenshot
 	? `url('https://v1.screenshot.11ty.dev/${encodeURIComponent(data.demo)}/medium/9:16/')`
@@ -32,7 +32,7 @@ const backgroundStyle = hasScreenshot
 		border-radius: 2px;
 		border: 1px solid var(--theme-glow-highlight);
 		box-shadow:
-		  0 0 var(--theme-glow-blur) var(--theme-glow-diffuse),
+			0 0 var(--theme-glow-blur) var(--theme-glow-diffuse),
 			inset 0 0 var(--theme-glow-blur) var(--theme-glow-diffuse);
 	}
 	.card-header {
diff --git a/src/components/HeadCommon.astro b/src/components/HeadCommon.astro
index eb54a6eb91cc7..5f5eb7574d10e 100644
--- a/src/components/HeadCommon.astro
+++ b/src/components/HeadCommon.astro
@@ -49,6 +49,7 @@
 <!-- Global site tag (gtag.js) - Google Analytics -->
 <script async src="https://www.googletagmanager.com/gtag/js?id=UA-130280175-15"></script>
 <script>
+	/* globals dataLayer */
 	window.dataLayer = window.dataLayer || [];
 	function gtag() {
 		dataLayer.push(arguments);
diff --git a/src/components/LeftSidebar/LeftSidebar.astro b/src/components/LeftSidebar/LeftSidebar.astro
index 161d27057b9c4..181eb63f06c5a 100644
--- a/src/components/LeftSidebar/LeftSidebar.astro
+++ b/src/components/LeftSidebar/LeftSidebar.astro
@@ -50,7 +50,7 @@ for (const section of sidebarSections) {
 </nav>
 
 <script>
-	window.addEventListener('DOMContentLoaded', (event) => {
+	window.addEventListener('DOMContentLoaded', () => {
 		var target = document.querySelector('[aria-current="page"]');
 		if (target && target.offsetTop > window.innerHeight - 100) {
 			document.querySelector('.nav-groups').scrollTop = target.offsetTop;
diff --git a/src/components/TabBox.astro b/src/components/TabBox.astro
index fe20b545c685e..e33cba5240bd8 100644
--- a/src/components/TabBox.astro
+++ b/src/components/TabBox.astro
@@ -65,7 +65,7 @@ npm create astro@latest
 npm install
 
 # start developing!
-npm run dev`}/ >
+npm run dev`}/>
     </div>
     <div id="yarn" class="hidden">
         <Code lang="bash" code={`# prerequisite: check that Node.js is 14.15.0+, or 16+
diff --git a/src/pages/index.astro b/src/pages/index.astro
index 5e867d05b6e04..cfd02a5c17698 100644
--- a/src/pages/index.astro
+++ b/src/pages/index.astro
@@ -1,5 +1,4 @@
 ---
-import Layout from '../layouts/MainLayout.astro';
 
 /*
 NOTE: The following code used to be included in a script tag on the page.

From a0cf158f53f89a82a49a7fc992846842fc06822b Mon Sep 17 00:00:00 2001
From: Mayank <9084735+mayank99@users.noreply.github.com>
Date: Fri, 3 Jun 2022 05:11:04 -0400
Subject: [PATCH 41/41] a11y: Improve focus styling and tab order (#692)

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
---
 src/components/Header/Header.astro             | 5 ++++-
 src/components/Header/LanguageSelect.css       | 5 -----
 src/components/LeftSidebar/LeftSidebar.astro   | 2 +-
 src/components/RightSidebar/RightSidebar.astro | 2 +-
 src/layouts/MainLayout.astro                   | 8 ++++----
 5 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/src/components/Header/Header.astro b/src/components/Header/Header.astro
index dff878df14eb9..8aa0af4621728 100644
--- a/src/components/Header/Header.astro
+++ b/src/components/Header/Header.astro
@@ -128,11 +128,14 @@ const t = useTranslations(Astro);
 
 	.logo a:hover,
 	.logo a:focus {
-		outline: none;
 		opacity: 1;
 		transform: translateY(-2px);
 	}
 
+	.logo a:focus:not(:focus-visible) {
+		outline: none;
+	}
+
 	.logo h1 {
 		font: inherit;
 		color: inherit;
diff --git a/src/components/Header/LanguageSelect.css b/src/components/Header/LanguageSelect.css
index 7b00a918ec3ee..527499f7880a6 100644
--- a/src/components/Header/LanguageSelect.css
+++ b/src/components/Header/LanguageSelect.css
@@ -17,7 +17,6 @@
 	flex-grow: 1;
 	padding: 0.55em 1.75rem;
 	line-height: inherit;
-	outline: 0;
 	/* Add dropdown arrow */
 	background-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 20 20'%3e%3cpath stroke='%236b7280' stroke-linecap='round' stroke-linejoin='round' stroke-width='1.5' d='M6 8l4 4 4-4'/%3e%3c/svg%3e");
 	background-position: 97%;
@@ -30,10 +29,6 @@
 	background-position: 3%;
 }
 
-.language-select:focus-visible {
-	border-color: var(--border-color-hocus);
-}
-
 @media (hover: hover) {
 	.language-select-wrapper > svg {
 		inset-inline-start: 0.6rem;
diff --git a/src/components/LeftSidebar/LeftSidebar.astro b/src/components/LeftSidebar/LeftSidebar.astro
index 181eb63f06c5a..18fd1a35af0df 100644
--- a/src/components/LeftSidebar/LeftSidebar.astro
+++ b/src/components/LeftSidebar/LeftSidebar.astro
@@ -34,7 +34,7 @@ for (const section of sidebarSections) {
 }
 ---
 
-<nav aria-labelledby="grid-left">
+<nav aria-label={t('leftSidebar.a11yTitle')}>
 	<SidebarToggleTabGroup 
 		client:load 
 		defaultActiveTab={activeTab} 
diff --git a/src/components/RightSidebar/RightSidebar.astro b/src/components/RightSidebar/RightSidebar.astro
index ac7e8fe468d09..8fba717948eaa 100644
--- a/src/components/RightSidebar/RightSidebar.astro
+++ b/src/components/RightSidebar/RightSidebar.astro
@@ -10,7 +10,7 @@ const { content, githubEditUrl } = Astro.props;
 const headers = content.astro?.headers;
 ---
 
-<nav class="sidebar-nav" aria-labelledby="grid-right">
+<nav class="sidebar-nav" aria-label={t('rightSidebar.a11yTitle')}>
 	<div class="sidebar-nav-inner">
 		{headers && (
 			<TableOfContents
diff --git a/src/layouts/MainLayout.astro b/src/layouts/MainLayout.astro
index 89d386eac0303..6a566e8e9848e 100644
--- a/src/layouts/MainLayout.astro
+++ b/src/layouts/MainLayout.astro
@@ -137,17 +137,17 @@ if (isFallback) canonicalURL.pathname = canonicalURL.pathname.replace(`/${lang}/
 	<body>
 		<Header {currentPage} />
 		<main class="layout">
-			<aside id="grid-left" class="grid-sidebar" title={t('leftSidebar.a11yTitle')}>
+			<aside id="grid-left" class="grid-sidebar">
 				<LeftSidebar {currentPage} />
 			</aside>
+			<aside id="grid-right" class="grid-sidebar">
+				{!hideRightSidebar && <RightSidebar content={content} githubEditUrl={githubEditUrl} />}
+			</aside>
 			<div id="grid-main" lang={isFallback && 'en'}>
 				<PageContent {content} {githubEditUrl} {currentPage} {isFallback}>
 					<slot />
 				</PageContent>
 			</div>
-			<aside id="grid-right" class="grid-sidebar" title={t('rightSidebar.a11yTitle')}>
-				{!hideRightSidebar && <RightSidebar content={content} githubEditUrl={githubEditUrl} />}
-			</aside>
 		</main>
 	</body>
 </html>