@intlayer/docs 6.1.6-canary.0 → 7.0.0-canary.0

package/docs/de/packages/next-intlayer/useDictionary.md

@@ -18,6 +18,10 @@ slugs:
   - packages
   - next-intlayer
   - useDictionary
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Initiale Historie
 ---
 
 # React-Integration: `useDictionary` Hook Dokumentation
@@ -262,7 +266,3 @@ Im Gegensatz zu Integrationen mit visuellen Editoren gelten hier keine Attribute
 - **Lokalisierungsaktualisierungen**: Stellen Sie beim Aktualisieren von Inhalten sicher, dass alle Sprachversionen konsistent sind, um fehlende Übersetzungen zu vermeiden.
 
 Diese Dokumentation konzentriert sich auf die Integration des `useDictionary` Hooks und bietet einen optimierten Ansatz zur Verwaltung lokalisierter Inhalte, ohne auf Funktionen visueller Editoren angewiesen zu sein.
-
-## Dokumentationshistorie
-
-- 5.5.10 - 2025-06-29: Initiale Historie

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

@@ -18,6 +18,10 @@ slugs:
   - packages
   - next-intlayer
   - useIntlayer
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Initiale Historie
 ---
 
 # Next.js Integration: `useIntlayer` Hook Dokumentation
@@ -262,7 +266,3 @@ Um Attribute wie `alt`, `title`, `href`, `aria-label` usw. zu lokalisieren, stel
 - **Intlayer Visual Editor**: Erfahren Sie, wie Sie den visuellen Editor für eine einfachere Inhaltsverwaltung [hier](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_visual_editor.md) verwenden.
 
 Diese Dokumentation beschreibt die Verwendung des `useIntlayer` Hooks speziell in Next.js-Umgebungen und bietet eine robuste Lösung zur Verwaltung der Lokalisierung in Ihren Next.js-Anwendungen.
-
-## Dokumentationsverlauf
-
-- 5.5.10 - 2025-06-29: Initiale Historie

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

@@ -18,6 +18,10 @@ slugs:
   - packages
   - next-intlayer
   - useLocale
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Historie initialisiert
 ---
 
 # Next.js Integration: `useLocale` Hook Dokumentation für `next-intlayer`
@@ -125,7 +129,3 @@ Wenn Sie den `useLocale` Hook aufrufen, gibt er ein Objekt mit den folgenden Eig
 ## Fazit
 
 Der `useLocale` Hook von `next-intlayer` ist ein wichtiges Werkzeug zur Verwaltung von Sprachversionen in Next.js-Anwendungen. Er bietet einen integrierten Ansatz, um Ihre Anwendung nahtlos für mehrere Sprachen anzupassen, indem er die Speicherung der Sprache, das Zustandsmanagement und die URL-Anpassungen übernimmt.
-
-## Dokumentationshistorie
-
-- 5.5.10 - 2025-06-29: Historie initialisiert

package/docs/de/packages/react-intlayer/t.md

@@ -17,6 +17,10 @@ slugs:
   - packages
   - react-intlayer
   - t
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Initiale Historie
 ---
 
 # Dokumentation: `t` Funktion in `react-intlayer`
@@ -296,7 +300,3 @@ Für detailliertere Anleitungen und erweiterte Funktionen konsultieren Sie bitte
 ---
 
 **Hinweis**: Denken Sie daran, Ihren `IntlayerProvider` richtig einzurichten, damit die aktuelle Locale korrekt an Ihre Komponenten weitergegeben wird. Dies ist entscheidend dafür, dass die `t`-Funktion die richtigen Übersetzungen zurückgibt.
-
-## Dokumentationshistorie
-
-- 5.5.10 - 2025-06-29: Initiale Historie

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

@@ -17,6 +17,10 @@ slugs:
   - package
   - react-intlayer
   - useDictionary
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Historie initialisiert
 ---
 
 # React-Integration: `useDictionary` Hook Dokumentation
@@ -295,7 +299,3 @@ Im Gegensatz zu Integrationen mit visuellen Editoren gelten hier keine Attribute
 - **Aktualisierungen der Lokalisierung**: Stellen Sie bei Inhaltsaktualisierungen sicher, dass alle Sprachen konsistent sind, um fehlende Übersetzungen zu vermeiden.
 
 Diese Dokumentation konzentriert sich auf die Integration des `useDictionary` Hooks und bietet einen optimierten Ansatz zur Verwaltung lokalisierter Inhalte, ohne auf Funktionen visueller Editoren angewiesen zu sein.
-
-## Dokumentationsverlauf
-
-- 5.5.10 - 2025-06-29: Historie initialisiert

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

@@ -19,6 +19,10 @@ slugs:
   - packages
   - react-intlayer
   - useI18n
+history:
+  - version: 6.0.0
+    date: 2025-06-29
+    changes: Erste Erstellung der Dokumentation zum `useI18n` Hook
 ---
 
 # React-Integration: `useI18n` Hook Dokumentation
@@ -244,7 +248,3 @@ Beim Lokalisieren von Attributen greifen Sie entsprechend auf die Übersetzungsw
 - **Intlayer Visual Editor**: Für eine intuitivere Verwaltung von Inhalten konsultieren Sie die Dokumentation des visuellen Editors [hier](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_visual_editor.md).
 
 Dieser Abschnitt behandelt speziell die Integration des `useI18n`-Hooks in React-Anwendungen, vereinfacht den Lokalisierungsprozess und gewährleistet Konsistenz der Inhalte über verschiedene Sprachversionen hinweg.
-
-## Dokumentationshistorie
-
-- 6.0.0 - 2025-06-29: Erste Erstellung der Dokumentation zum `useI18n` Hook

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

@@ -18,6 +18,10 @@ slugs:
   - packages
   - react-intlayer
   - useIntlayer
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Initiale Historie
 ---
 
 # React-Integration: `useIntlayer` Hook Dokumentation
@@ -261,7 +265,3 @@ Beim Lokalisieren von Attributen greifen Sie entsprechend auf die Inhaltswerte z
 - **Intlayer Visual Editor**: Für eine intuitivere Verwaltung von Inhalten finden Sie die Dokumentation zum visuellen Editor [hier](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_visual_editor.md).
 
 Dieser Abschnitt richtet sich speziell an die Integration des `useIntlayer` Hooks in React-Anwendungen, um den Lokalisierungsprozess zu vereinfachen und die Konsistenz der Inhalte über verschiedene Sprachversionen hinweg sicherzustellen.
-
-## Dokumentationshistorie
-
-- 5.5.10 - 2025-06-29: Initiale Historie

package/docs/de/packages/react-intlayer/useLocale.md

@@ -18,6 +18,10 @@ slugs:
   - packages
   - react-intlayer
   - useLocale
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Initiale Historie
 ---
 
 # React-Integration: `useLocale` Hook Dokumentation
@@ -204,7 +208,3 @@ const LocaleSelector = () => {
 ## Fazit
 
 Der `useLocale` Hook von `react-intlayer` ist ein unverzichtbares Werkzeug zur Verwaltung von Sprach- und Ländereinstellungen in Ihren React-Anwendungen und bietet die notwendige Funktionalität, um Ihre Anwendung effektiv an verschiedene internationale Zielgruppen anzupassen.
-
-## Dokumentationshistorie
-
-- 5.5.10 - 2025-06-29: Initiale Historie

package/docs/de/per_locale_file.md

@@ -14,6 +14,10 @@ slugs:
   - doc
   - concept
   - per-locale-file
+history:
+  - version: 5.5.10
+    date: 29.06.2025 
+    changes: Historie initialisiert
 ---
 
 # Deklaration von `Per-Locale` Inhaltsdeklaration in Intlayer
@@ -317,7 +321,3 @@ console.log(JSON.stringify(intlayer, null, 2));
 ### Automatische Übersetzungserstellung
 
 Verwenden Sie die [intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_cli.md), um fehlende Übersetzungen basierend auf Ihren bevorzugten Diensten automatisch zu ergänzen.
-
-## Dokumentationsverlauf
-
-- 5.5.10 - 29.06.2025: Historie initialisiert

package/docs/de/roadmap.md

@@ -13,6 +13,13 @@ keywords:
 slugs:
   - doc
   - roadmap
+history:
+  - version: 5.5.10
+    date: 2025-06-30
+    changes: Unterstützung für Preact und Nuxt hinzugefügt, MCP-Server, CLI aktualisiert
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Historie initialisiert
 ---
 
 # Intlayer: Funktionsübersicht & Fahrplan
@@ -344,8 +351,3 @@ Intlayer strebt danach, eine All-in-One-Lösung für Content-Management und Inte
 Bleiben Sie gespannt auf kommende Releases und zögern Sie nicht, die bestehenden Funktionen zu erkunden, um zu sehen, wie Intlayer Ihre Content-Management-Prozesse heute zentralisieren und optimieren kann!
 
 ---
-
-## Dokumentationshistorie
-
-- 5.5.10 - 2025-06-30: Unterstützung für Preact und Nuxt hinzugefügt, MCP-Server, CLI aktualisiert
-- 5.5.10 - 2025-06-29: Historie initialisiert

package/docs/de/testing.md

@@ -13,6 +13,10 @@ keywords:
 slugs:
   - doc
   - testing
+history:
+  - version: 6.0.0
+    date: 2025-09-20
+    changes: Einführung von Tests
 ---
 
 # Testen Ihres Inhalts
@@ -81,7 +85,6 @@ test("hat keine fehlenden erforderlichen Sprachversionen", () => {
   const result = listMissingTranslations();
 
   if (result.missingRequiredLocales.length > 0) {
-    // eslint-disable-next-line no-console
     console.log(result.missingTranslations);
   }
 
@@ -192,9 +195,3 @@ npx intlayer content test --verbose
 - Für gemischte Monorepos verwenden Sie `--base-dir`, um die CLI auf das richtige Anwendungs-Stammverzeichnis zu verweisen.
 
 ---
-
-## Dokumentationsverlauf
-
-| Version | Datum      | Änderungen           |
-| ------- | ---------- | -------------------- |
-| 6.0.0   | 2025-09-20 | Einführung von Tests |

package/docs/de/vs_code_extension.md

@@ -15,6 +15,19 @@ keywords:
 slugs:
   - doc
   - vs-code-extension
+history:
+  - version: 6.1.5
+    date: 2025-09-30
+    changes: Demo-GIF hinzugefügt
+  - version: 6.1.0
+    date: 2025-09-24
+    changes: Abschnitt zur Umgebungs-Auswahl hinzugefügt
+  - version: 6.0.0
+    date: 2025-09-22
+    changes: Intlayer-Tab / Befehle zum Ausfüllen & Testen
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Historie initialisiert
 ---
 
 # Offizielle VS Code Erweiterung
@@ -111,12 +124,3 @@ Die Erweiterung kann Umgebungsvariablen aus Ihrem Arbeitsbereich laden, um Intla
 #### Monorepos und benutzerdefinierte Verzeichnisse
 
 Wenn sich Ihre `.env`-Dateien außerhalb des Arbeitsbereichs-Stammverzeichnisses befinden, legen Sie das **Basisverzeichnis** unter `Einstellungen → Erweiterungen → Intlayer` fest. Der Loader sucht dann nach `.env`-Dateien relativ zu diesem Verzeichnis.
-
-## Dokumentationshistorie
-
-| Version | Datum      | Änderungen                                    |
-| ------- | ---------- | --------------------------------------------- |
-| 6.1.5   | 2025-09-30 | Demo-GIF hinzugefügt                          |
-| 6.1.0   | 2025-09-24 | Abschnitt zur Umgebungs-Auswahl hinzugefügt   |
-| 6.0.0   | 2025-09-22 | Intlayer-Tab / Befehle zum Ausfüllen & Testen |
-| 5.5.10  | 2025-06-29 | Historie initialisiert                        |

package/docs/en/CI_CD.md

@@ -15,6 +15,10 @@ slugs:
   - doc
   - concept
   - ci-cd
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Init history
 ---
 
 # Auto-Generate Translations in a CI/CD Pipeline
@@ -188,9 +192,3 @@ To set up the environment variables, go to GitHub → Settings → Secrets and v
 > By default, the `--git-diff` argument filters dictionaries that include changes from base (default `origin/main`) to current branch (default: `HEAD`).
 
 > For more information about Intlayer CLI commands and their usage, refer to the [CLI documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md).
-
-## Doc History
-
-| Version | Date       | Changes      |
-| ------- | ---------- | ------------ |
-| 5.5.10  | 2025-06-29 | Init history |

package/docs/en/autoFill.md

@@ -15,13 +15,68 @@ slugs:
   - doc
   - concept
   - auto-fill
+history:
+  - version: 7.0.0
+    date: 2025-10-23
+    changes: Rename `autoFill` to `fill` and update behavior
+  - version: 6.0.0
+    date: 2025-09-20
+    changes: Add global configuration
+  - version: 6.0.0
+    date: 2025-09-17
+    changes: Add `{{fileName}}` variable
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Init history
 ---
 
-# Autofill Content Declaration File Translations
+# Fill Content Declaration File Translations
 
-**Autofill content declaration files** are a way to speed up your development workflow.
+**Autofill content declaration files** in your CI are a way to speed up your development workflow.
 
-The autofill mechanism works through a _master-slave_ relationship between content declaration files. When the main (master) file is updated, Intlayer will automatically apply those changes to the derived (autofilled) declaration files.
+## Default Behavior
+
+By default, `fill` is set to `true` globally, which means Intlayer will automatically fill all content files and edit the file itself. This behavior can be customized in several ways:
+
+### Global Configuration Options
+
+1. **`fill: true` (default)** - Automatically fill all locales and edit the current file
+2. **`fill: false`** - Disable auto-fill for this content file
+3. **`fill: "path/to/file"`** - Create/update the specified file without editing the current one
+4. **`fill: { [key in Locales]?: string }`** - Create/update the specified file for each locale
+
+### v7 Behavior Changes
+
+In v7, the `fill` command behavior has been updated:
+
+- **`fill: true`** - Rewrites the current file with filled content for all locales
+- **`fill: "path/to/file"`** - Fills the specified file without modifying the current file
+- **`fill: false`** - Disables auto-fill completely
+
+When using a path option to write to another file, the fill mechanism works through a _master-slave_ relationship between content declaration files. The main (master) file serves as the source of truth, and when it's updated, Intlayer will automatically apply those changes to the derived (filled) declaration files specified by the path.
+
+### Per-Locale Customization
+
+You can also customize the behavior for each locale by using an object:
+
+```ts fileName="intlayer.config.ts"
+const config: IntlayerConfig = {
+  content: {
+    internationalization: {
+      locales: [Locales.ENGLISH, Locales.FRENCH, Locales.POLISH],
+      defaultLocale: Locales.ENGLISH,
+      requiredLocales: [Locales.ENGLISH], // Recommended to avoid Property 'pl' is missing in type '{ en: string; xxx } on your t function if
+    },
+    fill: {
+      en: true, // Fill and edit the current file for English
+      fr: "./translations/fr.json", // Create separate file for French
+      es: false, // Disable fill for Spanish
+    },
+  },
+};
+```
+
+This allows you to have different fill behaviors for different locales within the same project.
 
 ```ts fileName="src/components/example/example.content.ts"
 import { Locales, type Dictionary } from "intlayer";
@@ -29,7 +84,7 @@ import { Locales, type Dictionary } from "intlayer";
 const exampleContent = {
   key: "example",
   locale: Locales.ENGLISH,
-  autoFill: "./example.content.json",
+  fill: "./example.content.json",
   content: {
     contentExample: "This is an example of content",
   },
@@ -38,7 +93,7 @@ const exampleContent = {
 export default exampleContent;
 ```
 
-Here is a [per-locale content declaration file](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/per_locale_file.md) using the `autoFill` instruction.
+Here is a [per-locale content declaration file](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/per_locale_file.md) using the `fill` instruction.
 
 Then, when you run the following command:
 
@@ -80,13 +135,13 @@ const config: IntlayerConfig = {
   },
   content: {
     // Auto-generate missing translations for all dictionaries
-    autoFill: "./{{fileName}}Filled.content.ts",
+    fill: "./{{fileName}}Filled.content.ts",
     //
-    // autoFill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
+    // fill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
     //
-    // autoFill: true, // auto-generate missing translations for all dictionaries like using "./{{fileName}}.content.json"
+    // fill: true, // auto-generate missing translations for all dictionaries like using "./{{fileName}}.content.json"
     //
-    // autoFill: {
+    // fill: {
     //   en: "./{{fileName}}.en.content.json",
     //   fr: "./{{fileName}}.fr.content.json",
     //   es: "./{{fileName}}.es.content.json",
@@ -97,7 +152,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-You can still fine‑tune per dictionary using the `autoFill` field in content files. Intlayer will first consider the per dictionary configuration and then fallback to the global configuration.
+You can still fine‑tune per dictionary using the `fill` field in content files. Intlayer will first consider the per dictionary configuration and then fallback to the global configuration.
 
 ## Autofilled File Format
 
@@ -106,7 +161,7 @@ The recommended format for autofilled declaration files is **JSON**, which helps
 ```ts fileName="src/components/example/example.content.ts"
 const exampleContent = {
   key: "example",
-  autoFill: "./example.filled.content.ts",
+  fill: "./example.filled.content.ts",
   content: {
     // Your content
   },
@@ -126,12 +181,12 @@ src/components/example/example.filled.content.ts
 
 ## Absolute Paths
 
-The `autoFill` field also supports absolute paths.
+The `fill` field also supports absolute paths.
 
 ```ts fileName="src/components/example/example.content.ts"
 const exampleContent = {
   key: "example",
-  autoFill: "/messages/example.content.json",
+  fill: "/messages/example.content.json",
   content: {
     // Your content
   },
@@ -146,12 +201,12 @@ This will generate the file at:
 
 ## Autogenerate Per-Locale Content Declaration Files
 
-The `autoFill` field also supports generation of **per-locale** content declaration files.
+The `fill` field also supports generation of **per-locale** content declaration files.
 
 ```ts fileName="src/components/example/example.content.ts"
 const exampleContent = {
   key: "example",
-  autoFill: {
+  fill: {
     fr: "./example.fr.content.json",
     es: "./example.es.content.json",
   },
@@ -170,12 +225,12 @@ This will generate two separate files:
 
 ## Filter Specific Locale Autofill
 
-Using an object for the `autoFill` field allows you to apply filters and generate only specific locale files.
+Using an object for the `fill` field allows you to apply filters and generate only specific locale files.
 
 ```ts fileName="src/components/example/example.content.ts"
 const exampleContent = {
   key: "example",
-  autoFill: {
+  fill: {
     fr: "./example.fr.content.json",
   },
   content: {
@@ -188,7 +243,7 @@ This will only generate the French translation file.
 
 ## Path Variables
 
-You can use variables inside the `autoFill` path to dynamically resolve the target paths for the generated files.
+You can use variables inside the `fill` path to dynamically resolve the target paths for the generated files.
 
 **Available variables:**
 
@@ -199,7 +254,7 @@ You can use variables inside the `autoFill` path to dynamically resolve the targ
 ```ts fileName="src/components/example/index.content.ts"
 const exampleContent = {
   key: "example",
-  autoFill: "/messages/{{locale}}/{{key}}.content.json",
+  fill: "/messages/{{locale}}/{{key}}.content.json",
   content: {
     // Your content
   },
@@ -214,7 +269,7 @@ This will generate:
 ```ts fileName="src/components/example/index.content.ts"
 const exampleContent = {
   key: "example",
-  autoFill: "./{{fileName}}.content.json",
+  fill: "./{{fileName}}.content.json",
   content: {
     // Your content
   },
@@ -225,11 +280,3 @@ This will generate:
 
 - `./index.content.json`
 - `./index.content.json`
-
-## Doc History
-
-| Version | Date       | Changes                     |
-| ------- | ---------- | --------------------------- |
-| 6.0.0   | 2025-09-20 | Add global configuration    |
-| 6.0.0   | 2025-09-17 | Add `{{fileName}}` variable |
-| 5.5.10  | 2025-06-29 | Init history                |