@intlayer/docs 9.4.0-canary.0 → 9.4.0

package/docs/pt/packages/intlayer/getLocalizedPath.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 A função `getLocalizedPath` converte um caminho canônico (caminho interno da aplicação) em seu equivalente localizado com base no locale fornecido e nas regras de reescrita. É particularmente útil para gerar URLs amigáveis para SEO que variam por idioma.
 
+É a contrapartida relativa de [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getLocalizedUrl.md) — para uma entrada relativa, ambas retornam o mesmo valor. Ao contrário de `getLocalizedUrl`, nunca retorna uma URL absoluta: a configuração `domains` é ignorada, portanto uma locale servida do seu próprio domínio ainda produz um caminho. Uma entrada absoluta é aceita, mas sua origem é descartada — apenas seu caminho, string de consulta e hash são mantidos.
+
 **Recursos principais:**
 
 - Suporta parâmetros de rota dinâmicos usando a sintaxe `[param]`.
@@ -60,18 +62,23 @@ getLocalizedPath(
   - **Tipo**: `string`
   - **Obrigatório**: Sim
 
-- `locale: Locales`
-  - **Descrição**: O locale alvo para o qual o caminho deve ser localizado.
-  - **Tipo**: `Locales`
-  - **Obrigatório**: Sim
-
 ### Parâmetros Opcionais
 
+- `locale?: Locales`
+  - **Description**: O locale de destino para o qual o caminho deve ser localizado.
+  - **Type**: `Locales`
+  - **Default**: O locale padrão da configuração do seu projeto.
+
 - `rewriteRules?: RoutingConfig['rewrite']`
   - **Descrição**: Um objeto que define regras de reescrita personalizadas. Se não for fornecido, assume por padrão a propriedade `routing.rewrite` da configuração do seu projeto.
   - **Tipo**: `RoutingConfig['rewrite']`
   - **Padrão**: `configuration.routing.rewrite`
 
+  - `options.locales?: Locales[]` — locales suportados. **Padrão**: `configuration.internationalization.locales`
+  - `options.defaultLocale?: Locales` — o locale padrão. **Padrão**: `configuration.internationalization.defaultLocale`
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'` — como o locale aparece no caminho. **Padrão**: `configuration.routing.mode`
+  - `options.rewrite?: RoutingConfig['rewrite']` — regras de reescrita personalizadas. **Padrão**: `configuration.routing.rewrite`
+
 ---
 
 ## Retorna
@@ -79,6 +86,28 @@ getLocalizedPath(
 - **Tipo**: `string`
 - **Descrição**: O caminho localizado para o locale especificado.
 
+O tipo é estreitado a partir das regras de reescrita declaradas na sua configuração, portanto o editor mostra o caminho resolvido em vez de uma simples `string`:
+
+```typescript codeFormat="typescript"
+// Configuração: modo 'prefix-no-default', defaultLocale 'en',
+//                { '/about': { fr: '/a-propos' }, '/product/[id]': { fr: '/produit/[id]' } }
+const about = getLocalizedPath("/about", Locales.FRENCH);
+//    ^? '/fr/a-propos'
+const product = getLocalizedPath("/product/123", Locales.FRENCH);
+//    ^? '/fr/produit/123'
+const contact = getLocalizedPath("/contact", Locales.FRENCH);
+//    ^? '/fr/contact'  (nenhuma regra de reescrita corresponde, apenas o prefixo é aplicado)
+const home = getLocalizedPath("/", Locales.FRENCH);
+//    ^? '/fr'
+```
+
+O mesmo narrowing flui para [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getLocalizedUrl.md), que aplica as regras de rewrite antes de prefixar a locale.
+
+Dois casos permanecem ampliados para `string`, porque não podem ser resolvidos em tempo de compilação:
+
+- um caminho que não é um string literal (por exemplo, um construído a partir de uma variável);
+- um caminho correspondido por uma regra usando um parâmetro multi-segmento ou opcional (`[...slug]`, `[[...slug]]`, `:param?`).
+
 ---
 
 ## Exemplo de Uso
@@ -126,8 +155,6 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 // Output: "/contactez-nous"
 ```
 
----
-
 ### Omitindo a Locale
 
 Quando nenhuma locale é fornecida, o caminho é localizado para a locale padrão configurada:

package/docs/pt/packages/intlayer/getLocalizedUrl.md

@@ -143,36 +143,6 @@ getLocalizedUrl(
 // Saída: "/about" para o locale padrão (inglês)
 ```
 
-```javascript codeFormat="esm"
-import { getLocalizedUrl, Locales } from "intlayer";
-
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH],
-  Locales.ENGLISH,
-  false
-);
-
-// Saída: "/fr/about" para o locale francês
-// Saída: "/about" para o locale padrão (inglês)
-```
-
-```javascript codeFormat="commonjs"
-const { getLocalizedUrl, Locales } = require("intlayer");
-
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH],
-  Locales.ENGLISH,
-  false
-);
-
-// Saída: "/fr/about" para o locale francês
-// Saída: "/about" para o locale padrão (inglês)
-```
-
 ### Sobrescrita Parcial de Configuração
 
 Você também pode fornecer apenas alguns dos parâmetros opcionais. A função usará a configuração do seu projeto para qualquer parâmetro que você não especificar:
@@ -249,6 +219,12 @@ getLocalizedUrl(
 - **Locales Não Suportados:**
   - Para locales não listados em `locales`, a função não aplica nenhum prefixo.
 
+- **Modos de Roteamento:**
+  - `'prefix-no-default'`: Local padrão sem prefixo, outros com prefixo (ex: `/about`, `/fr/about`)
+  - `'prefix-all'`: Todos os locais com prefixos (ex: `/en/about`, `/fr/about`)
+  - `'no-prefix'`: Sem prefixos de locale nas URLs (locale tratado em outro lugar)
+  - `'search-params'`: Locale especificado via parâmetro de query (ex: `/about?locale=fr`)
+
 ---
 
 ## Uso em Aplicações

package/docs/pt/packages/intlayer/getMultilingualUrls.md

@@ -31,6 +31,14 @@ author: aymericzip
 
 A função `getMultilingualUrls` gera um mapeamento de URLs multilíngues prefixando a URL fornecida com cada localidade suportada. Ela pode lidar tanto com URLs absolutas quanto relativas, aplicando o prefixo de localidade apropriado com base na configuração fornecida ou nos padrões.
 
+**Principais Recursos:**
+
+- Apenas 1 parâmetro é obrigatório: `url`
+- Objeto `options` opcional com `locales`, `defaultLocale`, e `mode`
+- Usa a configuração de internacionalização do seu projeto como padrões
+- Suporta múltiplos modos de roteamento: `prefix-no-default`, `prefix-all`, `no-prefix`, e `search-params`
+- Retorna um objeto de mapeamento com todas as locales como chaves e suas URLs correspondentes como valores
+
 ---
 
 ## Assinatura da Função
@@ -139,8 +147,6 @@ getMultilingualUrls(
 // }
 ```
 
----
-
 ### Diferentes Modos de Roteamento
 
 ```typescript
@@ -206,6 +212,12 @@ getMultilingualUrls("/dashboard", {
 - **Localidades Não Suportadas:**
   - Apenas as localidades fornecidas no array `locales` são consideradas para gerar as URLs.
 
+- **Modos de Roteamento:**
+  - `'prefix-no-default'`: Locale padrão sem prefixo, outras com prefixo (ex: `/dashboard`, `/fr/dashboard`)
+  - `'prefix-all'`: Todos os locales com prefixos (ex: `/en/dashboard`, `/fr/dashboard`)
+  - `'no-prefix'`: Sem prefixos de locale nas URLs (todos os locales retornam a mesma URL)
+  - `'search-params'`: Locale especificado via parâmetro de query (ex: `/dashboard?locale=fr`)
+
 ---
 
 ## Uso em Aplicações

package/docs/pt/packages/intlayer/getTranslation.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 A função `getTranslationContent` recupera o conteúdo correspondente a um local específico a partir de um conjunto de conteúdo de idioma personalizável. Se o local especificado não for encontrado, ela retorna por padrão o conteúdo do local padrão configurado no projeto.
 
+Para mais detalhes sobre como declarar traduções, consulte a [documentação de Tradução](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/translation.md).
+
 ## Parâmetros
 
 - `languageContent: CustomizableLanguageContent<Content>`

package/docs/pt/packages/next-intlayer/t.md

@@ -102,37 +102,6 @@ export const ServerComponentExample: FC = () => (
 );
 ```
 
-###Traduções Inline em Atributos
-
-A função `t` é particularmente útil para traduções inline em atributos JSX.
-Ao localizar atributos como `alt`, `title`, `href` ou `aria-label`, você pode usar `t` diretamente dentro do atributo.
-
-```jsx
-<button
-  aria-label={t({
-    en: "Submit",
-    fr: "Soumettre",
-    es: "Enviar",
-  })}
->
-  {t({
-    en: "Submit",
-    fr: "Soumettre",
-    es: "Enviar",
-  })}
-  <img
-    src="/path/to/image"
-    alt={t({
-      en: "A beautiful scenery",
-      fr: "Un beau paysage",
-      es: "Un hermoso paisaje",
-    })}
-  />
-</button>
-```
-
----
-
 ### Traduções Inline em Atributos
 
 A função `t` é particularmente útil para traduções inline em atributos JSX.
@@ -192,6 +161,23 @@ No `next-intlayer`, a localidade atual é gerida através de provedores de conte
 
 #### Exemplo:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
+import type { FC, ReactNode } from "react";
+import type { Locales } from "intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const Page: FC<{ locale: Locales; children: ReactNode }> = ({
+  locale,
+  children,
+}) => <IntlayerProvider locale={locale}>{children}</IntlayerProvider>;
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import type { Locales } from "intlayer";
@@ -207,6 +193,9 @@ const Page: FC<{ locale: Locales }> = ({ locale }) => (
 );
 ```
 
+</Tab>
+</Tabs>
+
 ---
 
 ## Erros Comuns e Solução de Problemas

package/docs/pt/packages/next-intlayer/useIntlayer.md

@@ -79,6 +79,34 @@ Instruções para configurar arquivos de declaração de conteúdo estão dispon
 
 Veja como você pode implementar o hook `useIntlayer` dentro de uma página Next.js para carregar dinamicamente conteúdo localizado com base no locale atual da aplicação:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { type NextPageIntlayer } from "next-intlayer";
+import { useIntlayer } from "next-intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const HomePage: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  const content = useIntlayer("homepage", locale);
+
+  return (
+    <IntlayerProvider locale={locale}>
+      <p>{content.introduction}</p>
+      <ClientComponentExample />
+      <ServerComponentExample />
+    </IntlayerProvider>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
 import { ClientComponentExample } from "@components/ClientComponentExample";
 import { ServerComponentExample } from "@components/ServerComponentExample";
@@ -104,6 +132,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat={["typescript", "esm"]}
 "use-client";
 

package/docs/pt/packages/next-intlayer/useLocale.md

@@ -104,6 +104,8 @@ O hook `useLocale` aceita os seguintes parâmetros:
 
 ## Valores de Retorno
 
+Quando você invoca o hook `useLocale`, ele retorna um objeto contendo as seguintes propriedades:
+
 - **`locale`**: O local atual definido no contexto do React.
 - **`defaultLocale`**: O local principal definido na configuração.
 - **`availableLocales`**: Uma lista de todos os locais disponíveis conforme definido na configuração.

package/docs/pt/packages/react-intlayer/useDictionary.md

@@ -30,8 +30,6 @@ Esta seção fornece orientações detalhadas sobre o uso do hook `useDictionary
 
 ## Exemplo de Uso no React
 
-Abaixo está um exemplo de como usar o hook `useDictionary` em um componente React:
-
 ```tsx fileName="./ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useDictionary } from "react-intlayer";

package/docs/pt/packages/react-intlayer/useI18n.md

@@ -77,6 +77,34 @@ Todas as chaves do dicionário devem ser declaradas dentro dos arquivos de decla
 
 Exemplos de uso do hook `useI18n` dentro de componentes React:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -101,6 +129,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";

package/docs/pt/packages/react-intlayer/useIntlayer.md

@@ -31,48 +31,6 @@ Esta seção fornece orientações detalhadas sobre o uso do hook `useIntlayer`
 
 ## Exemplo de Uso em React
 
-Demonstrando o hook `useIntlayer` dentro de um componente React:
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
-```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const ComponentExample: FC = () => {
-  const content = useIntlayer("component-example");
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.description}</p>
-    </div>
-  );
-};
-```
-
 ```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import { useIntlayer } from "react-intlayer/server";
 

package/docs/pt/packages/vite-intlayer/intlayerPrune.md

@@ -28,6 +28,8 @@ author: aymericzip
 
 O plugin Vite `intlayerPrune` é usado para realizar tree-shaking e podar dicionários não utilizados do bundle da sua aplicação. Isso ajuda a reduzir o tamanho final do bundle incluindo apenas o conteúdo multilíngue necessário.
 
+> O plugin já está incluído e configurado automaticamente quando você usa [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/vite-intlayer/intlayer.md). Você só precisa registrá-lo manualmente se estiver compondo a pilha de plugins você mesmo.
+
 ## Utilização
 
 ### Como parte de `intlayer()` (recomendado)

package/docs/pt/per_locale_file.md

@@ -77,6 +77,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.pt.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "pt", // Importante
+  "content": {
+    "multilingualContent": "Título do meu componente",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -95,6 +106,8 @@ module.exports = helloWorldContent;
 
 > Recomendado: Este formato é o melhor quando se utiliza o editor visual do Intlayer ou se gerenciam traduções diretamente no código.
 
+> Nota: Em ambos os casos, o arquivo de declaração de conteúdo deve seguir o padrão de nomenclatura `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` para ser reconhecido pelo Intlayer. O sufixo `.[locale]` é opcional e usado apenas como uma convenção de nomenclatura.
+
 ### Configuração Global para Arquivos por Localidade
 
 Você pode configurar a configuração global para arquivos por localidade adicionando o seguinte ao seu arquivo `intlayer.config.ts`:
@@ -146,17 +159,6 @@ const helloWorldContent = {
 export default helloWorldContent;
 ```
 
-```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "en", // Importante
-  "content": {
-    "multilingualContent": "Título do meu componente",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -170,8 +172,6 @@ export default helloWorldContent;
 
 > Importante: Certifique-se de que o campo locale está definido. Ele informa ao Intlayer qual idioma o arquivo representa.
 
-> Nota: Em ambos os casos, o arquivo de declaração de conteúdo deve seguir o padrão de nomenclatura `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` para ser reconhecido pelo Intlayer. O sufixo `.[locale]` é opcional e usado apenas como convenção de nomenclatura.
-
 ## Misturando Formatos
 
 Você pode combinar ambas as abordagens de declaração para a mesma chave de conteúdo. Por exemplo:

package/docs/pt/readme.md

@@ -225,8 +225,8 @@ Explore a nossa documentação completa para começar com o Intlayer e aprender
   <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
   <li><a href="https://intlayer.org/doc/environment/nuxt-and-vue" rel=''>Vite + Nuxt</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
-  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
-  <li>
+  <li><a href="https://intlayer.org/doc/environment/solid-start" rel=''>Solid Start</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>  <li>
      <a href="https://intlayer.org/doc/environment/express" rel=''>Backend</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ Explore a nossa documentação completa para começar com o Intlayer e aprender
       <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
       <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
       <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+      <li><a href="https://intlayer.org/doc/environment/elysia" rel=''>Elysia</a></li>
     </ul>
   </li>
 </ul>

package/docs/pt/releases/v6.md

@@ -118,6 +118,8 @@ export default config;
 
 Você ainda pode ajustar por dicionário usando o campo `autoFill` nos arquivos de conteúdo. Veja a referência completa em `doc/autoFill` e `doc/dictionary/content_file`.
 
+Você ainda pode ajustar por dicionário usando o campo `autoFill` em arquivos de conteúdo. O Intlayer primeiro considerará a configuração por dicionário e depois voltará para a configuração global. Veja a referência completa em [Auto-fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/autoFill.md) e [Referência de arquivo de conteúdo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/content_file.md).
+
 ---
 
 ## Comando fill: padrões mais seguros
@@ -175,6 +177,20 @@ Veja detalhes na documentação da [Extensão Oficial do VS Code](https://github
 
 ---
 
+Atualizado o servidor MCP para suportar os novos recursos.
+
+- Auto-fill
+- Test missing translations
+- Live updates
+- Logging
+- Validation
+- Migration notes
+- Documentation
+
+> O servidor MCP ajuda na automatização de projetos usando Intlayer. Testando traduções ausentes para código autogenerado. Ajuda a entender sua configuração e incorpora a documentação do Intlayer no seu IDE.
+
+---
+
 ## Performance: 10× mais rápido
 
 - Resolução paralela de dicionários locais e remotos
@@ -296,8 +312,6 @@ Notas:
 
 Consulte [CMS e Sincronização ao Vivo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md) e [Configuração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md) para orientações completas.
 
----
-
 ## Processo paralelo para monitorar arquivos no turbopack
 
 Ao usar Turbopack no Next.js 14 e superior como seu servidor de desenvolvimento com o comando `next dev --turbopack`, as mudanças no dicionário não serão detectadas automaticamente por padrão.

package/docs/pt/releases/v9.md

@@ -374,6 +374,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 O instalador baixa um `docker-compose.yml` e um `.env`, gera automaticamente os secrets necessários e executa `docker compose up -d`. Tudo — o dashboard, a API, o banco de dados, o armazenamento de objetos e o e-mail transacional — roda localmente em contêineres.
 
+---
+
 ## Notas de migração da v8
 
 Se você estiver atualizando da v8, observe que a v9 não inclui breaking changes. Mas aqui estão as principais mudanças: