@intlayer/docs 8.7.7 → 8.7.8

package/docs/it/packages/express-intlayer/t.md

@@ -66,7 +66,7 @@ Per garantire che la funzionalità di internazionalizzazione fornita da `express
 
 Posiziona il middleware `app.use(intlayer())` **prima di qualsiasi route** nella tua applicazione per garantire che tutte le route beneficino dell'internazionalizzazione:
 
-```typescript {7} fileName="src/index.ts" codeFormat="typescript"
+```typescript {7} fileName="src/index.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import express, { type Express } from "express";
 import { intlayer } from "express-intlayer";
 
@@ -87,48 +87,6 @@ app.get("/", (_req, res) => {
 });
 ```
 
-```javascript {7} fileName="src/index.mjs" codeFormat="esm"
-import express from "express";
-import { intlayer } from "express-intlayer";
-
-const app = express();
-
-// Carica il gestore delle richieste di internazionalizzazione
-app.use(intlayer());
-
-// Definisci le tue route dopo aver caricato il middleware
-app.get("/", (_req, res) => {
-  res.send(
-    t({
-      en: "Hello, World!",
-      fr: "Bonjour le monde!",
-      es: "¡Hola, Mundo!",
-    })
-  );
-});
-```
-
-```javascript {7} fileName="src/index.cjs" codeFormat="commonjs"
-const express = require("express");
-const { intlayer } = require("express-intlayer");
-
-const app = express();
-
-// Carica il gestore delle richieste di internazionalizzazione
-app.use(intlayer());
-
-// Definisci le tue route dopo aver caricato il middleware
-app.get("/", (_req, res) => {
-  res.send(
-    t({
-      en: "Hello, World!",
-      fr: "Bonjour le monde!",
-      es: "¡Hola, Mundo!",
-    })
-  );
-});
-```
-
 ### Perché è Necessario
 
 - **Rilevamento della Lingua**: Il middleware `intlayer` elabora le richieste in arrivo per rilevare la lingua preferita dall'utente basandosi su header, cookie o altri metodi configurati.
@@ -143,31 +101,7 @@ app.get("/", (_req, res) => {
 
 Servi contenuti localizzati in diverse lingue:
 
-```typescript fileName="src/index.ts" codeFormat="typescript"
-app.get("/", (_req, res) => {
-  res.send(
-    t({
-      en: "Welcome!",
-      fr: "Bienvenue!",
-      es: "¡Bienvenido!",
-    })
-  );
-});
-```
-
-```javascript fileName="src/index.mjs" codeFormat="esm"
-app.get("/", (_req, res) => {
-  res.send(
-    t({
-      en: "Welcome!",
-      fr: "Bienvenue!",
-      es: "¡Bienvenido!",
-    })
-  );
-});
-```
-
-```javascript fileName="src/index.cjs" codeFormat="commonjs"
+```typescript fileName="src/index.ts" codeFormat={["typescript", "esm", "commonjs"]}
 app.get("/", (_req, res) => {
   res.send(
     t({
@@ -189,31 +123,7 @@ app.get("/", (_req, res) => {
 
 Fornire messaggi di errore in più lingue:
 
-```typescript fileName="src/index.ts" codeFormat="typescript"
-app.get("/error", (_req, res) => {
-  res.status(500).send(
-    t({
-      en: "An unexpected error occurred.",
-      fr: "Une erreur inattendue s'est produite.",
-      es: "Ocurrió un error inesperado.",
-    })
-  );
-});
-```
-
-```javascript fileName="src/index.mjs" codeFormat="esm"
-app.get("/error", (_req, res) => {
-  res.status(500).send(
-    t({
-      en: "An unexpected error occurred.",
-      fr: "Une erreur inattendue s'est produite.",
-      es: "Ocurrió un error inesperado.",
-    })
-  );
-});
-```
-
-```javascript fileName="src/index.cjs" codeFormat="commonjs"
+```typescript fileName="src/index.ts" codeFormat={["typescript", "esm", "commonjs"]}
 app.get("/error", (_req, res) => {
   res.status(500).send(
     t({
@@ -281,7 +191,7 @@ app.get("/greet", (_req, res) => {
 
 Se un locale preferito non è disponibile, la funzione `t` utilizzerà come fallback il locale predefinito definito nella configurazione:
 
-```typescript {5-6} fileName="intlayer.config.ts" codeFormat="typescript"
+```typescript {5-6} fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { Locales, type IntlayerConfig } from "intlayer";
 
 const config = {
@@ -294,34 +204,6 @@ const config = {
 export default config;
 ```
 
-```javascript {5-6} fileName="intlayer.config.mjs" codeFormat="esm"
-import { Locales } from "intlayer";
-
-/** @type {import('intlayer').IntlayerConfig} */
-const config = {
-  internationalization: {
-    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
-    defaultLocale: Locales.ENGLISH,
-  },
-};
-
-export default config;
-```
-
-```javascript {5-6} fileName="intlayer.config.cjs" codeFormat="commonjs"
-const { Locales } = require("intlayer");
-
-/** @type {import('intlayer').IntlayerConfig} */
-const config = {
-  internationalization: {
-    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
-    defaultLocale: Locales.ENGLISH,
-  },
-};
-
-module.exports = config;
-```
-
 Per esempio:
 
 - Se `defaultLocale` è `Locales.CHINESE` e un client richiede `Locales.DUTCH`, la traduzione restituita sarà quella di `Locales.CHINESE`.
@@ -341,7 +223,7 @@ Configura la funzione `t` per far rispettare rigorosamente le localizzazioni dic
 
 Esempio di configurazione:
 
-```typescript {7} fileName="intlayer.config.ts" codeFormat="typescript"
+```typescript {7} fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { type IntlayerConfig } from "intlayer";
 
 const config = {
@@ -355,40 +237,13 @@ const config = {
 export default config;
 ```
 
-```javascript {7} fileName="intlayer.config.mjs" codeFormat="esm"
-import { type IntlayerConfig } from "intlayer";
-
-const config = {
-  // ... La tua configurazione esistente
-  internationalization: {
-    // ... La tua configurazione di internazionalizzazione esistente
-    strictMode: "strict", // Applica la modalità rigorosa
-  },
-};
-
-export default config;
-```
-
-```javascript {7} fileName="intlayer.config.cjs" codeFormat="commonjs"
-/** @type {import('intlayer').IntlayerConfig} */
-const config = {
-  // ... La tua configurazione esistente
-  internationalization: {
-    // ... La tua configurazione di internazionalizzazione esistente
-    strictMode: "strict", // Applica la modalità rigorosa
-  },
-};
-
-module.exports = config;
-```
-
 ---
 
 ### Integrazione con TypeScript
 
 La funzione `t` è type-safe quando usata con TypeScript. Definisci un oggetto di traduzioni type-safe:
 
-```typescript fileName="src/index.ts" codeFormat="typescript"
+```typescript fileName="src/index.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { type LanguageContent } from "express-intlayer";
 
 const translations: LanguageContent<string> = {
@@ -402,36 +257,6 @@ app.get("/morning", (_req, res) => {
 });
 ```
 
-```javascript fileName="src/index.mjs" codeFormat="esm"
-import { type LanguageContent } from "express-intlayer";
-
-/** @type {import('express-intlayer').LanguageContent<string>} */
-const translations = {
-  en: "Good morning!",
-  fr: "Bonjour!",
-  es: "¡Buenos días!",
-};
-
-app.get("/morning", (_req, res) => {
-  res.send(t(translations));
-});
-```
-
-```javascript fileName="src/index.cjs" codeFormat="commonjs"
-const { type LanguageContent } = require("express-intlayer");
-
-/** @type {import('express-intlayer').LanguageContent<string>} */
-const translations = {
-  en: "Good morning!",
-  fr: "Bonjour!",
-  es: "¡Buenos días!",
-};
-
-app.get("/morning", (_req, res) => {
-  res.send(t(translations));
-});
-```
-
 ---
 
 ### Errori Comuni e Risoluzione dei Problemi

package/docs/it/packages/hono-intlayer/t.md

@@ -65,7 +65,7 @@ Per garantire che la funzionalità di internazionalizzazione fornita da `hono-in
 
 Posiziona il middleware `app.use("*", intlayer())` **prima di qualsiasi rotta** nella tua applicazione per assicurarti che tutte le rotte beneficino dell'internazionalizzazione:
 
-```typescript {6} fileName="src/index.ts" codeFormat="typescript"
+```typescript {6} fileName="src/index.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { Hono } from "hono";
 import { intlayer } from "hono-intlayer";
 
@@ -87,50 +87,6 @@ app.get("/", (c) => {
 });
 ```
 
-```javascript {6} fileName="src/index.mjs" codeFormat="esm"
-import { Hono } from "hono";
-import { intlayer } from "hono-intlayer";
-
-const app = new Hono();
-
-// Carica il gestore delle richieste di internazionalizzazione
-app.use("*", intlayer());
-
-// Definisci le tue rotte dopo aver caricato il middleware
-app.get("/", (c) => {
-  return c.text(
-    t({
-      en: "Hello, World!",
-      fr: "Bonjour le monde!",
-      es: "¡Hola, Mundo!",
-      it: "Ciao, Mondo!",
-    })
-  );
-});
-```
-
-```javascript {6} fileName="src/index.cjs" codeFormat="commonjs"
-const { Hono } = require("hono");
-const { intlayer, t } = require("hono-intlayer");
-
-const app = new Hono();
-
-// Carica il gestore delle richieste di internazionalizzazione
-app.use("*", intlayer());
-
-// Definisci le tue rotte dopo aver caricato il middleware
-app.get("/", (c) => {
-  return c.text(
-    t({
-      en: "Hello, World!",
-      fr: "Bonjour le monde!",
-      es: "¡Hola, Mundo!",
-      it: "Ciao, Mondo!",
-    })
-  );
-});
-```
-
 ### Perché Questo è Necessario
 
 - **Rilevamento della Locale**: Il middleware `intlayer` elabora le richieste in entrata per rilevare la locale preferita dell'utente in base a intestazioni, cookie o altri metodi configurati.

package/docs/it/packages/intlayer/getConfiguration.md

@@ -53,7 +53,7 @@ Consulta la [documentazione sulla configurazione di Intlayer](https://github.com
 
 ### Recuperare la configurazione completa
 
-```typescript codeFormat="typescript"
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
 import { getConfiguration } from "intlayer";
 
 const config = getConfiguration();
@@ -67,39 +67,11 @@ console.log(config);
 // }
 ```
 
-```javascript codeFormat="esm"
-import { getConfiguration } from "intlayer";
-
-const config = getConfiguration();
-console.log(config);
-// Output:
-// {
-//   internationalization: { ... },
-//   middleware: { ... },
-//   content: { ... },
-//   editor: { ... }
-// }
-```
-
-```javascript codeFormat="commonjs"
-const { getConfiguration } = require("intlayer");
-
-const config = getConfiguration();
-console.log(config);
-// Output:
-// {
-//   internationalization: { ... },
-//   middleware: { ... },
-//   content: { ... },
-//   editor: { ... }
-// }
-```
-
 ### Estrazione di `availableLocales` e `defaultLocale`
 
 La sezione `internationalization` della configurazione fornisce impostazioni relative alle localizzazioni come `locales` (localizzazioni disponibili) e `defaultLocale` (lingua di fallback).
 
-```typescript codeFormat="typescript"
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
 import { getConfiguration } from "intlayer";
 
 const { internationalization, middleware } = getConfiguration();
@@ -111,30 +83,6 @@ console.log(defaultLocale); // Esempio di output: "en"
 console.log(cookieName); // Output: "INTLAYER_LOCALE"
 ```
 
-```javascript codeFormat="esm"
-import { getConfiguration } from "intlayer";
-
-const { internationalization, middleware } = getConfiguration();
-const { locales: availableLocales, defaultLocale } = internationalization;
-const { cookieName } = middleware;
-
-console.log(availableLocales); // Esempio di output: ["en", "fr", "es"]
-console.log(defaultLocale); // Esempio di output: "en"
-console.log(cookieName); // Output: "INTLAYER_LOCALE"
-```
-
-```javascript codeFormat="commonjs"
-const { getConfiguration } = require("intlayer");
-
-const { internationalization, middleware } = getConfiguration();
-const { locales: availableLocales, defaultLocale } = internationalization;
-const { cookieName } = middleware;
-
-console.log(availableLocales); // Esempio di output: ["en", "fr", "es"]
-console.log(defaultLocale); // Esempio di output: "en"
-console.log(cookieName); // Output: "INTLAYER_LOCALE"
-```
-
 ## Note
 
 - Assicurarsi che tutte le variabili d'ambiente richieste siano correttamente impostate prima di chiamare questa funzione. Variabili mancanti causeranno errori durante l'inizializzazione.

package/docs/it/packages/intlayer/getEnumeration.md

@@ -50,7 +50,7 @@ La funzione `getEnumeration` recupera il contenuto corrispondente a una quantit
 
 ### Utilizzo base
 
-```typescript codeFormat="typescript"
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
 import { getEnumeration } from "intlayer";
 
 const content = getEnumeration(
@@ -66,53 +66,9 @@ const content = getEnumeration(
 console.log(content); // Output: "Hai due"
 ```
 
-```javascript codeFormat="esm"
-import { getEnumeration } from "intlayer";
-
-const content = getEnumeration(
-  {
-    "<1": "Hai meno di uno",
-    "2": "Hai due",
-    ">=3": "Hai tre o più",
-  },
-  2
-);
-
-console.log(content); // Output: "Hai due"
-```
-
-```javascript codeFormat="commonjs"
-const { getEnumeration } = require("intlayer");
-
-const content = getEnumeration(
-  {
-    "<1": "Hai meno di uno",
-    "2": "Hai due",
-    ">=3": "Hai tre o più",
-  },
-  2
-);
-
-console.log(content); // Output: "Hai due"
-```
-
 ### Priorità delle condizioni
 
-```typescript codeFormat="typescript"
-import { getEnumeration } from "intlayer";
-
-const content = getEnumeration(
-  {
-    "<4": "Hai meno di quattro",
-    "2": "Hai due",
-  },
-  2
-);
-
-console.log(content); // Output: "Hai meno di quattro"
-```
-
-```javascript codeFormat="esm"
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
 import { getEnumeration } from "intlayer";
 
 const content = getEnumeration(
@@ -126,20 +82,6 @@ const content = getEnumeration(
 console.log(content); // Output: "Hai meno di quattro"
 ```
 
-```javascript codeFormat="commonjs"
-const { getEnumeration } = require("intlayer");
-
-const content = getEnumeration(
-  {
-    "<4": "Hai meno di quattro",
-    "2": "Hai due",
-  },
-  2
-);
-
-console.log(content); // Output: "Hai meno di quattro"
-```
-
 ## Casi limite
 
 - **Nessuna condizione corrispondente:**

package/docs/it/packages/intlayer/getHTMLTextDir.md

@@ -48,7 +48,7 @@ La funzione `getHTMLTextDir` determina la direzione del testo (`ltr`, `rtl` o `a
 
 ### Determinare la direzione del testo
 
-```typescript codeFormat="typescript"
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
 import { getHTMLTextDir } from "intlayer";
 
 getHTMLTextDir(Locales.ENGLISH); // Output: "ltr"
@@ -56,22 +56,6 @@ getHTMLTextDir(Locales.FRENCH); // Output: "ltr"
 getHTMLTextDir(Locales.ARABIC); // Output: "rtl"
 ```
 
-```javascript codeFormat="esm"
-import { getHTMLTextDir } from "intlayer";
-
-getHTMLTextDir(Locales.ENGLISH); // Output: "ltr"
-getHTMLTextDir(Locales.FRENCH); // Output: "ltr"
-getHTMLTextDir(Locales.ARABIC); // Output: "rtl"
-```
-
-```javascript codeFormat="commonjs"
-const { getHTMLTextDir } = require("intlayer");
-
-getHTMLTextDir(Locales.ENGLISH); // Output: "ltr"
-getHTMLTextDir(Locales.FRENCH); // Output: "ltr"
-getHTMLTextDir(Locales.ARABIC); // Output: "rtl"
-```
-
 ## Casi limite
 
 - **Nessuna locale fornita:**
@@ -84,7 +68,7 @@ getHTMLTextDir(Locales.ARABIC); // Output: "rtl"
 
 La funzione `getHTMLTextDir` può essere utilizzata per impostare dinamicamente l'attributo `dir` in un documento HTML per una corretta visualizzazione del testo in base alla località.
 
-```tsx codeFormat="typescript"
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import { getHTMLTextDir, type Locales } from "intlayer";
 
@@ -98,24 +82,4 @@ export const HTMLLayout: FC<PropsWithChildren<{ locale: Locales }>> = ({
 );
 ```
 
-```jsx codeFormat="esm"
-import { getHTMLTextDir } from "intlayer";
-
-const HTMLLayout = ({ children, locale }) => (
-  <html dir={getHTMLTextDir(locale)} locale={locale}>
-    <body>{children}</body>
-  </html>
-);
-```
-
-```jsx codeFormat="commonjs"
-const { getHTMLTextDir } = require("intlayer");
-
-const HTMLLayout = ({ children, locale }) => (
-  <html dir={getHTMLTextDir(locale)} locale={locale}>
-    <body>{children}</body>
-  </html>
-);
-```
-
 Nell'esempio sopra, l'attributo `dir` viene impostato dinamicamente in base alla località.

package/docs/it/packages/intlayer/getLocaleLang.md

@@ -45,7 +45,7 @@ La funzione `getLocaleLang` estrae il codice della lingua da una stringa di loca
 
 ### Estrazione dei codici lingua:
 
-```typescript codeFormat="typescript"
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
 import { getLocaleLang, Locales } from "intlayer";
 
 getLocaleLang(Locales.ENGLISH_UNITED_STATES); // Output: "en"
@@ -54,25 +54,6 @@ getLocaleLang(Locales.FRENCH_CANADA); // Output: "fr"
 getLocaleLang(Locales.FRENCH); // Output: "fr"
 ```
 
-```javascript codeFormat="esm"
-import { getLocaleLang } from "intlayer";
-
-getLocaleLang(Locales.ENGLISH_UNITED_STATES); // Output: "en"
-getLocaleLang(Locales.ENGLISH); // Output: "en"
-getLocaleLang(Locales.FRENCH_CANADA); // Output: "fr"
-getLocaleLang(Locales.FRENCH); // Output: "fr"
-```
-
-```javascript codeFormat="commonjs"
-const { getLocaleLang } = require("intlayer");
-
-// Nessuna localizzazione fornita:
-getLocaleLang(Locales.ENGLISH_UNITED_STATES); // Output: "en"
-getLocaleLang(Locales.ENGLISH); // Output: "en"
-getLocaleLang(Locales.FRENCH_CANADA); // Output: "fr"
-getLocaleLang(Locales.FRENCH); // Output: "fr"
-```
-
 ## Casi limite
 
 - **Nessuna localizzazione fornita:**

package/docs/it/packages/intlayer/getLocaleName.md

@@ -50,7 +50,7 @@ La funzione `getLocaleName` restituisce il nome localizzato di una determinata l
 
 ## Esempio di utilizzo
 
-```typescript codeFormat="typescript"
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
 import { Locales, getLocaleName } from "intlayer";
 
 getLocaleName(Locales.ENGLISH); // Output: "English"
@@ -71,48 +71,6 @@ getLocaleName(Locales.CHINESE, Locales.ENGLISH); // Output: "Chinese"
 getLocaleName("unknown-locale"); // Output: "Unknown locale"
 ```
 
-```javascript codeFormat="esm"
-import { Locales, getLocaleName } from "intlayer";
-
-getLocaleName(Locales.ENGLISH); // Output: "English"
-getLocaleName(Locales.ENGLISH, Locales.FRENCH); // Output: "Anglais"
-getLocaleName(Locales.ENGLISH, Locales.ESPANOL); // Output: "Inglés"
-getLocaleName(Locales.ENGLISH, Locales.ENGLISH); // Output: "English"
-
-getLocaleName(Locales.FRENCH); // Output: "Français"
-getLocaleName(Locales.FRENCH, Locales.FRENCH); // Output: "Français"
-getLocaleName(Locales.FRENCH, Locales.ESPANOL); // Output: "Francés"
-getLocaleName(Locales.FRENCH, Locales.ENGLISH); // Output: "French"
-
-getLocaleName(Locales.CHINESE); // Output: "中文"
-getLocaleName(Locales.CHINESE, Locales.FRENCH); // Output: "Chinois"
-getLocaleName(Locales.CHINESE, Locales.ESPANOL); // Output: "Chino"
-getLocaleName(Locales.CHINESE, Locales.ENGLISH); // Output: "Chinese"
-
-getLocaleName("unknown-locale"); // Output: "Unknown locale"
-```
-
-```javascript codeFormat="commonjs"
-const { Locales, getLocaleName } = require("intlayer");
-
-getLocaleName(Locales.ENGLISH); // Output: "English"
-getLocaleName(Locales.ENGLISH, Locales.FRENCH); // Output: "Anglais"
-getLocaleName(Locales.ENGLISH, Locales.ESPANOL); // Output: "Inglés"
-getLocaleName(Locales.ENGLISH, Locales.ENGLISH); // Output: "English"
-
-getLocaleName(Locales.FRENCH); // Output: "Français"
-getLocaleName(Locales.FRENCH, Locales.FRENCH); // Output: "Français"
-getLocaleName(Locales.FRENCH, Locales.ESPANOL); // Output: "Francés"
-getLocaleName(Locales.FRENCH, Locales.ENGLISH); // Output: "French"
-
-getLocaleName(Locales.CHINESE); // Output: "中文"
-getLocaleName(Locales.CHINESE, Locales.FRENCH); // Output: "Chinois"
-getLocaleName(Locales.CHINESE, Locales.ESPANOL); // Output: "Chino"
-getLocaleName(Locales.CHINESE, Locales.ENGLISH); // Output: "Chinese"
-
-getLocaleName("unknown-locale"); // Output: "Unknown locale"
-```
-
 ## Casi limite
 
 - **Nessun `targetLocale` fornito:**