@intlayer/docs 5.8.1-canary.0 → 6.0.0-canary.0

package/docs/hi/testing.md

@@ -0,0 +1,200 @@
+---
+createdAt: 2025-03-01
+updatedAt: 2025-09-20
+title: आपकी सामग्री का परीक्षण
+description: Intlayer के साथ अपनी सामग्री का परीक्षण कैसे करें, जानें।
+keywords:
+  - परीक्षण
+  - Intlayer
+  - अंतर्राष्ट्रीयकरण
+  - CMS
+  - सामग्री प्रबंधन प्रणाली
+  - विज़ुअल एडिटर
+slugs:
+  - doc
+  - testing
+---
+
+# आपकी सामग्री का परीक्षण
+
+यह मार्गदर्शिका दिखाती है कि कैसे अपने शब्दकोशों की पूर्णता को स्वचालित रूप से सत्यापित करें, शिपिंग से पहले गायब अनुवाद पकड़ें, और अपने ऐप में स्थानीयकृत UI का परीक्षण करें।
+
+---
+
+## आप क्या परीक्षण कर सकते हैं
+
+- **गायब अनुवाद**: यदि किसी भी शब्दकोश के लिए आवश्यक स्थानीय भाषाएँ गायब हैं तो CI असफल हो जाएगा।
+- **स्थानीयकृत UI रेंडरिंग**: किसी विशिष्ट स्थानीय प्रदाता के साथ घटकों को रेंडर करें और दिखाई देने वाले टेक्स्ट/विशेषताओं पर सत्यापन करें।
+- **बिल्ड-टाइम ऑडिट**: CLI के माध्यम से स्थानीय रूप से एक त्वरित ऑडिट चलाएं।
+
+---
+
+## त्वरित प्रारंभ: CLI के माध्यम से ऑडिट
+
+अपने प्रोजेक्ट रूट से ऑडिट चलाएं:
+
+```bash
+npx intlayer content test
+```
+
+उपयोगी फ्लैग्स:
+
+- `--env-file [path]`: किसी फ़ाइल से पर्यावरण चर लोड करें।
+- `-e, --env [name]`: एक पर्यावरण प्रोफ़ाइल चुनें।
+- `--base-dir [path]`: समाधान के लिए ऐप बेस डायरेक्टरी सेट करें।
+- `--verbose`: विस्तृत लॉग दिखाएं।
+- `--prefix [label]`: लॉग लाइनों के लिए उपसर्ग जोड़ें।
+
+ध्यान दें: CLI एक विस्तृत रिपोर्ट प्रिंट करता है लेकिन विफलताओं पर गैर-शून्य कोड के साथ बाहर नहीं निकलता। CI गेटिंग के लिए, एक यूनिट टेस्ट (नीचे) जोड़ें जो यह सुनिश्चित करे कि कोई आवश्यक स्थानीय भाषा गायब न हो।
+
+---
+
+## प्रोग्रामेटिक परीक्षण (Vitest/Jest)
+
+अपने आवश्यक स्थानीय भाषाओं के लिए कोई गायब अनुवाद न होने का सत्यापन करने के लिए Intlayer CLI API का उपयोग करें।
+
+```ts file=i18n.test.ts
+/* @vitest-environment node */
+import { listMissingTranslations } from "intlayer/cli";
+import { describe, expect, it } from "vitest";
+
+describe("अनुवाद", () => {
+  it("कोई आवश्यक स्थानीय भाषा गायब नहीं है", () => {
+    const result = listMissingTranslations();
+
+    if (result.missingRequiredLocales.length > 0) {
+      // जब परीक्षण स्थानीय रूप से या CI में विफल होता है तो सहायक
+      console.log(result.missingTranslations);
+    }
+
+    expect(result.missingRequiredLocales).toHaveLength(0);
+  });
+});
+```
+
+Jest समतुल्य:
+
+```ts file=i18n.test.ts
+import { listMissingTranslations } from "intlayer/cli";
+
+test("कोई आवश्यक स्थानीय भाषा गायब नहीं है", () => {
+  const result = listMissingTranslations();
+
+  if (result.missingRequiredLocales.length > 0) {
+    // eslint-disable-next-line no-console
+    console.log(result.missingTranslations);
+  }
+
+  expect(result.missingRequiredLocales).toHaveLength(0);
+});
+```
+
+यह कैसे काम करता है:
+
+- Intlayer आपकी कॉन्फ़िगरेशन (locales, requiredLocales) और घोषित शब्दकोशों को पढ़ता है, फिर रिपोर्ट करता है:
+  - `missingTranslations`: प्रति-कुंजी, कौन-कौन सी स्थानीय भाषाएँ गायब हैं और किस फ़ाइल से।
+  - `missingLocales`: सभी गायब स्थानीय भाषाओं का संघ।
+  - `missingRequiredLocales`: `requiredLocales` तक सीमित उपसमूह (या यदि `requiredLocales` सेट नहीं है तो सभी स्थानीय भाषाएँ)।
+
+---
+
+## स्थानीयकृत UI का परीक्षण (React / Next.js)
+
+Intlayer प्रदाता के अंतर्गत घटकों को रेंडर करें और दृश्य सामग्री पर सत्यापन करें।
+
+React उदाहरण (Testing Library):
+
+```tsx
+import { IntlayerProvider } from "react-intlayer/client";
+import { render, screen } from "@testing-library/react";
+import { MyComponent } from "./MyComponent";
+
+test("अंग्रेज़ी में स्थानीयकृत शीर्षक रेंडर करता है", () => {
+  render(
+    <IntlayerProvider locale="en-US">
+      <MyComponent />
+    </IntlayerProvider>
+  );
+
+  expect(screen.getByText("अपेक्षित अंग्रेज़ी शीर्षक")).toBeInTheDocument();
+});
+```
+
+Next.js (App Router) उदाहरण: फ्रेमवर्क रैपर का उपयोग करें:
+
+```tsx
+import { IntlayerClientProvider } from "next-intlayer/client";
+import { render, screen } from "@testing-library/react";
+import { MyPage } from "./MyPage";
+
+test("फ्रेंच में स्थानीयकृत शीर्षक प्रदर्शित करता है", () => {
+  render(
+    <IntlayerClientProvider locale="fr-FR">
+      <MyPage />
+    </IntlayerClientProvider>
+  );
+  expect(
+    screen.getByRole("heading", { name: "Titre attendu" })
+  ).toBeInTheDocument();
+});
+```
+
+टिप्स:
+
+- जब आपको गुणों के लिए कच्चे स्ट्रिंग मानों की आवश्यकता हो (जैसे, `aria-label`), तो React में `useIntlayer` द्वारा लौटाए गए `.value` फ़ील्ड तक पहुँचें।
+- आसान यूनिट परीक्षण और सफाई के लिए शब्दकोशों को घटकों के साथ ही रखें।
+
+---
+
+## सतत एकीकरण
+
+एक ऐसा परीक्षण जोड़ें जो आवश्यक अनुवादों के गायब होने पर बिल्ड को विफल कर दे।
+
+`package.json`:
+
+```json
+{
+  "scripts": {
+    "test:i18n": "vitest run -c"
+  }
+}
+```
+
+GitHub Actions उदाहरण:
+
+```yaml
+name: CI
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci
+      - run: npm run test:i18n
+```
+
+वैकल्पिक: परीक्षणों के साथ-साथ एक मानव-पठनीय सारांश के लिए CLI ऑडिट चलाएं:
+
+```bash
+npx intlayer content test --verbose
+```
+
+---
+
+## समस्या निवारण
+
+- सुनिश्चित करें कि आपका Intlayer कॉन्फ़िगरेशन `locales` और (वैकल्पिक रूप से) `requiredLocales` को परिभाषित करता है।
+- यदि आपका ऐप डायनामिक या रिमोट शब्दकोशों का उपयोग करता है, तो ऐसे वातावरण में परीक्षण चलाएं जहां शब्दकोश उपलब्ध हों।
+- मिश्रित मोनोरिपोज़ के लिए, CLI को सही एप्लिकेशन रूट पर इंगित करने के लिए `--base-dir` का उपयोग करें।
+
+---
+
+## दस्तावेज़ इतिहास
+
+| संस्करण | तिथि       | परिवर्तन         |
+| ------- | ---------- | ---------------- |
+| 6.0.0   | 2025-09-20 | परीक्षण का परिचय |

package/docs/it/autoFill.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-06-29
+updatedAt: 2025-09-20
 title: Compilazione Automatica
-description: Scopri come utilizzare la funzionalità di compilazione automatica in Intlayer per popolare automaticamente i contenuti basati su schemi predefiniti. Segui questa documentazione per implementare efficacemente le funzionalità di compilazione automatica nel tuo progetto.
+description: Scopri come utilizzare la funzionalità di compilazione automatica in Intlayer per popolare automaticamente i contenuti basati su modelli predefiniti. Segui questa documentazione per implementare efficacemente le funzionalità di compilazione automatica nel tuo progetto.
 keywords:
   - Compilazione Automatica
-  - Automazione Contenuti
+  - Automazione dei Contenuti
   - Contenuto Dinamico
   - Intlayer
   - Next.js
@@ -17,36 +17,36 @@ slugs:
   - auto-fill
 ---
 
-# Traduzioni dei File di Dichiarazione Contenuti con Compilazione Automatica
+# Traduzioni dei File di Dichiarazione del Contenuto con Compilazione Automatica
+
+I **file di dichiarazione del contenuto con compilazione automatica** sono un modo per velocizzare il tuo flusso di lavoro di sviluppo.
 
-**I file di dichiarazione contenuti con compilazione automatica** sono un modo per velocizzare il tuo flusso di lavoro di sviluppo.
 Il meccanismo di compilazione automatica funziona attraverso una relazione _master-slave_ tra i file di dichiarazione dei contenuti. Quando il file principale (master) viene aggiornato, Intlayer applicherà automaticamente tali modifiche ai file di dichiarazione derivati (compilati automaticamente).
 
 ```ts fileName="src/components/example/example.content.ts"
 import { Locales, type Dictionary } from "intlayer";
 
-// Definizione del contenuto di esempio con compilazione automatica abilitata
 const exampleContent = {
   key: "example",
   locale: Locales.ENGLISH,
   autoFill: "./example.content.json",
   content: {
-    contentExample: "This is an example of content",
+    contentExample: "Questo è un esempio di contenuto", // esempio di contenuto
   },
 } satisfies Dictionary;
 
 export default exampleContent;
 ```
 
-Ecco un [file di dichiarazione del contenuto per ogni locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/per_locale_file.md) che utilizza l'istruzione `autoFill`.
+Ecco un [file di dichiarazione dei contenuti per locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/per_locale_file.md) che utilizza l'istruzione `autoFill`.
 
-Successivamente, quando esegui il seguente comando:
+Quindi, quando esegui il seguente comando:
 
 ```bash
 npx intlayer fill --file 'src/components/example/example.content.ts'
 ```
 
-Intlayer genererà automaticamente il file di dichiarazione derivato in `src/components/example/example.content.json`, compilando tutte le localizzazioni non ancora dichiarate nel file principale.
+Intlayer genererà automaticamente il file di dichiarazione derivato in `src/components/example/example.content.json`, compilando tutte le localizzazioni non già dichiarate nel file principale.
 
 ```json5 fileName="src/components/example/example.content.json"
 {
@@ -63,11 +63,11 @@ Intlayer genererà automaticamente il file di dichiarazione derivato in `src/com
 }
 ```
 
-Successivamente, entrambi i file di dichiarazione saranno uniti in un unico dizionario, accessibile utilizzando il consueto hook `useIntlayer("example")` (react) / composable (vue).
+Successivamente, entrambi i file di dichiarazione saranno uniti in un unico dizionario, accessibile tramite il consueto hook `useIntlayer("example")` (react) / composable (vue).
 
-## Formato del file compilato automaticamente
+## Formato del File Compilato Automaticamente
 
-Il formato consigliato per i file di dichiarazione autofillati è **JSON**, che aiuta a evitare vincoli di formattazione. Tuttavia, Intlayer supporta anche i formati `.ts`, `.js`, `.mjs`, `.cjs` e altri.
+Il formato consigliato per i file di dichiarazione compilati automaticamente è **JSON**, che aiuta a evitare vincoli di formattazione. Tuttavia, Intlayer supporta anche i formati `.ts`, `.js`, `.mjs`, `.cjs` e altri.
 
 ```ts fileName="src/components/example/example.content.ts"
 const exampleContent = {
@@ -85,10 +85,10 @@ Questo genererà il file in:
 src/components/example/example.filled.content.ts
 ```
 
-> La generazione di file `.js`, `.ts` e simili funziona come segue:
+> La generazione dei file `.js`, `.ts` e simili funziona come segue:
 >
 > - Se il file esiste già, Intlayer lo analizzerà usando l'AST (Abstract Syntax Tree) per individuare ogni campo e inserire eventuali traduzioni mancanti.
-> - Se il file non esiste, Intlayer lo genererà utilizzando il modello di file di dichiarazione del contenuto predefinito.
+> - Se il file non esiste, Intlayer lo genererà utilizzando il modello predefinito di file di dichiarazione del contenuto.
 
 ## Percorsi Assoluti
 
@@ -110,9 +110,9 @@ Questo genererà il file in:
 /messages/example.content.json
 ```
 
-## Generazione Automatica di File di Dichiarazione del Contenuto per Locale
+## Generazione Automatica di File di Dichiarazione Contenuti Per Locale
 
-Il campo `autoFill` supporta anche la generazione di file di dichiarazione del contenuto **per locale**.
+Il campo `autoFill` supporta anche la generazione di file di dichiarazione contenuti **per locale**.
 
 ```ts fileName="src/components/example/example.content.ts"
 const exampleContent = {
@@ -132,9 +132,11 @@ Questo genererà due file separati:
 - `src/components/example/example.fr.content.json`
 - `src/components/example/example.es.content.json`
 
-## Filtrare l'AutoFill per Locale Specifico
+> In questo caso, se l'oggetto non contiene tutte le localizzazioni, Intlayer salta la generazione delle localizzazioni rimanenti.
+
+## Filtrare l'Autocompletamento per Localizzazione Specifica
 
-Usare un oggetto per il campo `autoFill` permette di applicare filtri e generare solo i file per i locali specifici.
+Usare un oggetto per il campo `autoFill` permette di applicare filtri e generare solo file di localizzazione specifici.
 
 ```ts fileName="src/components/example/example.content.ts"
 const exampleContent = {
@@ -150,16 +152,17 @@ const exampleContent = {
 
 Questo genererà solo il file di traduzione in francese.
 
-## Variabili nei Percorsi
+## Variabili di Percorso
 
 Puoi usare variabili all'interno del percorso `autoFill` per risolvere dinamicamente i percorsi di destinazione per i file generati.
 
 **Variabili disponibili:**
 
-- `{{locale}}` – Codice della lingua (es. `fr`, `es`)
+- `{{locale}}` – Codice della localizzazione (es. `fr`, `es`)
+- `{{fileName}}` – Nome del file (es. `index`)
 - `{{key}}` – Chiave del dizionario (es. `example`)
 
-```ts fileName="src/components/example/example.content.ts"
+```ts fileName="src/components/example/index.content.ts"
 const exampleContent = {
   key: "example",
   autoFill: "/messages/{{locale}}/{{key}}.content.json",
@@ -174,6 +177,25 @@ Questo genererà:
 - `/messages/fr/example.content.json`
 - `/messages/es/example.content.json`
 
-## Cronologia Documentazione
+```ts fileName="src/components/example/index.content.ts"
+const exampleContent = {
+  key: "example",
+  autoFill: "./{{fileName}}.content.json",
+  content: {
+    // Il tuo contenuto
+  },
+};
+```
+
+Questo genererà:
+
+- `./index.content.json`
+- `./index.content.json`
+
+## Cronologia della Documentazione
 
-- 5.5.10 - 2025-06-29: Inizio cronologia
+| Versione | Data       | Modifiche                   |
+| -------- | ---------- | --------------------------- |
+| 6.0.0    | 2025-09-20 | Aggiunta configurazione globale |
+| 6.0.0    | 2025-09-17 | Aggiunta variabile `{{fileName}}` |
+| 5.5.10   | 2025-06-29 | Inizializzazione cronologia  |