@intlayer/docs 8.2.3 → 8.3.0-canary.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (128) hide show
  1. package/dist/cjs/_virtual/_rolldown/runtime.cjs +1 -0
  2. package/dist/cjs/blog.cjs.map +1 -1
  3. package/dist/cjs/common.cjs +1 -1
  4. package/dist/cjs/common.cjs.map +1 -1
  5. package/dist/cjs/doc.cjs.map +1 -1
  6. package/dist/cjs/frequentQuestions.cjs.map +1 -1
  7. package/dist/cjs/generated/blog.entry.cjs +1 -1
  8. package/dist/cjs/generated/blog.entry.cjs.map +1 -1
  9. package/dist/cjs/generated/docs.entry.cjs +1 -1
  10. package/dist/cjs/generated/docs.entry.cjs.map +1 -1
  11. package/dist/cjs/generated/frequentQuestions.entry.cjs +1 -1
  12. package/dist/cjs/generated/frequentQuestions.entry.cjs.map +1 -1
  13. package/dist/cjs/generated/legal.entry.cjs +1 -1
  14. package/dist/cjs/generated/legal.entry.cjs.map +1 -1
  15. package/dist/cjs/legal.cjs.map +1 -1
  16. package/dist/esm/blog.mjs.map +1 -1
  17. package/dist/esm/common.mjs +1 -1
  18. package/dist/esm/common.mjs.map +1 -1
  19. package/dist/esm/doc.mjs.map +1 -1
  20. package/dist/esm/frequentQuestions.mjs.map +1 -1
  21. package/dist/esm/generated/blog.entry.mjs.map +1 -1
  22. package/dist/esm/generated/docs.entry.mjs.map +1 -1
  23. package/dist/esm/generated/frequentQuestions.entry.mjs.map +1 -1
  24. package/dist/esm/generated/legal.entry.mjs.map +1 -1
  25. package/dist/esm/legal.mjs.map +1 -1
  26. package/dist/types/blog.d.ts +1 -1
  27. package/dist/types/common.d.ts +1 -1
  28. package/dist/types/common.d.ts.map +1 -1
  29. package/dist/types/doc.d.ts +1 -1
  30. package/dist/types/frequentQuestions.d.ts +1 -1
  31. package/dist/types/generated/blog.entry.d.ts +1 -1
  32. package/dist/types/generated/docs.entry.d.ts +1 -1
  33. package/dist/types/generated/frequentQuestions.entry.d.ts +1 -1
  34. package/dist/types/generated/legal.entry.d.ts +1 -1
  35. package/dist/types/legal.d.ts +1 -1
  36. package/docs/ar/compiler.md +73 -8
  37. package/docs/ar/configuration.md +53 -17
  38. package/docs/ar/intlayer_with_nextjs_compiler.md +13 -5
  39. package/docs/ar/intlayer_with_vite+react_compiler.md +13 -5
  40. package/docs/ar/per_locale_file.md +1 -1
  41. package/docs/de/compiler.md +74 -9
  42. package/docs/de/configuration.md +49 -13
  43. package/docs/de/intlayer_with_nextjs_compiler.md +12 -4
  44. package/docs/de/intlayer_with_vite+react_compiler.md +12 -4
  45. package/docs/de/per_locale_file.md +1 -1
  46. package/docs/en/compiler.md +79 -1
  47. package/docs/en/configuration.md +39 -1
  48. package/docs/en/intlayer_with_nextjs_compiler.md +9 -1
  49. package/docs/en/intlayer_with_vite+react_compiler.md +9 -1
  50. package/docs/en/per_locale_file.md +1 -1
  51. package/docs/en-GB/compiler.md +72 -6
  52. package/docs/en-GB/configuration.md +39 -2
  53. package/docs/en-GB/intlayer_with_nextjs_compiler.md +22 -3
  54. package/docs/en-GB/intlayer_with_vite+react_compiler.md +22 -3
  55. package/docs/en-GB/per_locale_file.md +1 -1
  56. package/docs/es/compiler.md +71 -6
  57. package/docs/es/configuration.md +52 -16
  58. package/docs/es/intlayer_with_nextjs_compiler.md +9 -1
  59. package/docs/es/intlayer_with_vite+react_compiler.md +9 -1
  60. package/docs/fr/compiler.md +69 -4
  61. package/docs/fr/configuration.md +50 -14
  62. package/docs/fr/intlayer_with_nextjs_compiler.md +9 -1
  63. package/docs/fr/intlayer_with_vite+react_compiler.md +9 -1
  64. package/docs/hi/compiler.md +74 -9
  65. package/docs/hi/configuration.md +49 -13
  66. package/docs/hi/intlayer_with_nextjs_compiler.md +15 -7
  67. package/docs/hi/intlayer_with_vite+react_compiler.md +15 -7
  68. package/docs/hi/per_locale_file.md +1 -1
  69. package/docs/id/compiler.md +73 -8
  70. package/docs/id/configuration.md +46 -10
  71. package/docs/id/intlayer_with_nextjs_compiler.md +13 -5
  72. package/docs/id/intlayer_with_vite+react_compiler.md +13 -5
  73. package/docs/id/per_locale_file.md +1 -1
  74. package/docs/it/compiler.md +73 -8
  75. package/docs/it/configuration.md +54 -18
  76. package/docs/it/intlayer_with_nextjs_compiler.md +12 -4
  77. package/docs/it/intlayer_with_vite+react_compiler.md +12 -4
  78. package/docs/it/per_locale_file.md +1 -1
  79. package/docs/ja/compiler.md +75 -10
  80. package/docs/ja/configuration.md +50 -14
  81. package/docs/ja/intlayer_with_nextjs_compiler.md +13 -5
  82. package/docs/ja/intlayer_with_vite+react_compiler.md +13 -5
  83. package/docs/ko/compiler.md +75 -10
  84. package/docs/ko/configuration.md +50 -14
  85. package/docs/ko/intlayer_with_nextjs_compiler.md +22 -3
  86. package/docs/ko/intlayer_with_vite+react_compiler.md +22 -3
  87. package/docs/pl/compiler.md +73 -8
  88. package/docs/pl/configuration.md +47 -11
  89. package/docs/pl/intlayer_with_nextjs_compiler.md +13 -5
  90. package/docs/pl/intlayer_with_vite+react_compiler.md +13 -5
  91. package/docs/pl/per_locale_file.md +1 -1
  92. package/docs/pt/compiler.md +74 -9
  93. package/docs/pt/configuration.md +50 -14
  94. package/docs/pt/intlayer_with_nextjs_compiler.md +12 -4
  95. package/docs/pt/intlayer_with_vite+react_compiler.md +12 -4
  96. package/docs/pt/per_locale_file.md +1 -1
  97. package/docs/ru/compiler.md +74 -9
  98. package/docs/ru/configuration.md +49 -13
  99. package/docs/ru/intlayer_with_nextjs_compiler.md +11 -3
  100. package/docs/ru/intlayer_with_vite+react_compiler.md +11 -3
  101. package/docs/tr/compiler.md +73 -8
  102. package/docs/tr/configuration.md +53 -17
  103. package/docs/tr/intlayer_with_nextjs_compiler.md +11 -3
  104. package/docs/tr/intlayer_with_vite+react_compiler.md +11 -3
  105. package/docs/tr/per_locale_file.md +1 -1
  106. package/docs/uk/compiler.md +74 -9
  107. package/docs/uk/configuration.md +183 -147
  108. package/docs/uk/intlayer_with_nextjs_compiler.md +13 -5
  109. package/docs/uk/intlayer_with_vite+react_compiler.md +13 -5
  110. package/docs/vi/compiler.md +75 -10
  111. package/docs/vi/configuration.md +47 -11
  112. package/docs/vi/intlayer_with_nextjs_compiler.md +14 -6
  113. package/docs/vi/intlayer_with_vite+react_compiler.md +14 -6
  114. package/docs/vi/per_locale_file.md +1 -1
  115. package/docs/zh/compiler.md +75 -10
  116. package/docs/zh/configuration.md +54 -18
  117. package/docs/zh/intlayer_with_nextjs_compiler.md +13 -5
  118. package/docs/zh/intlayer_with_vite+react_compiler.md +13 -5
  119. package/package.json +16 -16
  120. package/src/blog.ts +1 -1
  121. package/src/common.ts +2 -1
  122. package/src/doc.ts +1 -1
  123. package/src/frequentQuestions.ts +1 -1
  124. package/src/generated/blog.entry.ts +1 -1
  125. package/src/generated/docs.entry.ts +1 -1
  126. package/src/generated/frequentQuestions.entry.ts +1 -1
  127. package/src/generated/legal.entry.ts +1 -1
  128. package/src/legal.ts +1 -1
@@ -19,6 +19,9 @@ slugs:
19
19
  applicationTemplate: https://github.com/aymericzip/intlayer-vite-react-template
20
20
  youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
21
21
  history:
22
+ - version: 8.2.0
23
+ date: 2026-03-09
24
+ changes: Update compiler options, add FilePathPattern support
22
25
  - version: 8.1.6
23
26
  date: 2026-02-23
24
27
  changes: Lançamento inicial
@@ -135,18 +138,23 @@ const config: IntlayerConfig = {
135
138
  enabled: true,
136
139
 
137
140
  /**
138
- * Diretório de saída para os dicionários otimizados.
141
+ * Diretório de saída para os dicionários optimizados.
139
142
  */
140
- outputDir: "compiler",
143
+ output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
144
+
145
+ /**
146
+ * Inserir apenas o conteúdo no arquivo gerado, sem chave.
147
+ */
148
+ noMetadata: false,
141
149
 
142
150
  /**
143
151
  * Prefixo da chave do dicionário
144
152
  */
145
- dictionaryKeyPrefix: "", // Remover prefixo base
153
+ dictionaryKeyPrefix: "", // Remove base prefix
146
154
 
147
155
  /**
148
156
  * Indica se os componentes devem ser salvos após serem transformados.
149
- * Dessa forma, o compilador pode ser executado apenas uma vez para transformar o aplicativo e depois pode ser removido.
157
+ * Dessa forma, o compilador pode ser executado apenas uma vez para transformar o app e depois removido.
150
158
  */
151
159
  saveComponents: false,
152
160
  },
@@ -128,7 +128,7 @@ const config: IntlayerConfig = {
128
128
  export default config;
129
129
  ```
130
130
 
131
- Usando essa configuração, todos os arquivos por localidade serão gerados com a localidade padrão definida como Inglês. Isso também inclui a geração de arquivos `.content` usando o comando `extract` e o compiler. (Veja [Compiler](https://intlayer.org/doc/compiler) ou [Extract](https://intlayer.org/doc/concept/cli/extract) para mais informações.)
131
+ Usando essa configuração, todos os arquivos por localidade serão gerados com a localidade padrão definida como Inglês. Isso também inclui a geração de arquivos `.content` usando o comando `extract` e o compiler. (Veja [Compiler](https://intlayer.org/doc/compiler) ou [Extract](https://github.com/aymericzip/intlayer/edit/main/docs/docs/en/cli/extract.md) para mais informações.)
132
132
 
133
133
  ## Formato Por Localidade
134
134
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  createdAt: 2025-09-09
3
- updatedAt: 2026-02-25
3
+ updatedAt: 2026-03-10
4
4
  title: Intlayer Compiler | Автоматизированное извлечение контента для i18n
5
5
  description: Автоматизируйте процесс интернационализации с помощью Intlayer Compiler. Извлекайте контент напрямую из ваших компонентов для более быстрого и эффективного i18n в Vite, Next.js и других.
6
6
  keywords:
@@ -20,6 +20,9 @@ slugs:
20
20
  - doc
21
21
  - compiler
22
22
  history:
23
+ - version: 8.2.0
24
+ date: 2026-03-10
25
+ changes: Update compiler options, add FilePathPattern support
23
26
  - version: 8.1.7
24
27
  date: 2026-02-25
25
28
  changes: Обновление опций компилятора
@@ -157,13 +160,12 @@ import { type IntlayerConfig, Locales } from "intlayer";
157
160
  const config: IntlayerConfig = {
158
161
  compiler: {
159
162
  /**
160
- * Указывает, должен ли быть включен компилятор.
161
- * Установите значение 'build-only', чтобы пропустить компилятор во время разработки и ускорить время запуска.
163
+ * Установите значение 'build-only', чтобы пропустить компилятор во время разработки и ускорить запуск.
162
164
  */
163
165
  enabled: true,
164
166
 
165
167
  /**
166
- * Шаблон для обхода кода для оптимизации.
168
+ * Pattern to traverse the code to optimize.
167
169
  */
168
170
  transformPattern: [
169
171
  "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
@@ -171,23 +173,28 @@ const config: IntlayerConfig = {
171
173
  ],
172
174
 
173
175
  /**
174
- * Шаблон для исключения из оптимизации.
176
+ * Pattern to exclude from the optimization.
175
177
  */
176
178
  excludePattern: ["**/node_modules/**"],
177
179
 
178
180
  /**
179
181
  * Выходной каталог для оптимизированных словарей.
180
182
  */
181
- outputDir: "i18n",
183
+ output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
184
+
185
+ /**
186
+ * Вставьте только содержимое в сгенерированный файл, без ключа.
187
+ */
188
+ noMetadata: false,
182
189
 
183
190
  /**
184
191
  * Префикс ключа словаря
185
192
  */
186
- dictionaryKeyPrefix: "", // Удалить базовый префикс
193
+ dictionaryKeyPrefix: "", // Remove base prefix
187
194
 
188
195
  /**
189
- * Указывает, должны ли компоненты сохраняться после преобразования.
190
- * Таким образом, компилятор можно запустить только один раз для преобразования приложения, а затем его можно удалить.
196
+ * Указывает, должны ли компоненты сохраняться после трансформации.
197
+ * Таким образом, компилятор можно запустить только один раз для трансформации приложения, а затем удалить.
191
198
  */
192
199
  saveComponents: false,
193
200
  },
@@ -209,3 +216,61 @@ npx intlayer fill # Заполнить недостающие перев
209
216
  ```
210
217
 
211
218
  > Для получения более подробной информации обратитесь к [документации CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/ci.md)
219
+
220
+ ### Справочник по конфигурации компилятора
221
+
222
+ Следующие свойства могут быть настроены в блоке `compiler` вашего файла `intlayer.config.ts`:
223
+
224
+ - **enabled**:
225
+ - _Тип_: `boolean | 'build-only'`
226
+ - _По умолчанию_: `true`
227
+ - _Описание_: Указывает, должен ли компилятор быть включен.
228
+ - **dictionaryKeyPrefix**:
229
+ - _Тип_: `string`
230
+ - _По умолчанию_: `'comp-'`
231
+ - _Описание_: Префикс для извлеченных ключей словаря.
232
+ - **transformPattern**:
233
+ - _Тип_: `string | string[]`
234
+ - _По умолчанию_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
235
+ - _Описание_: Шаблоны для обхода кода для оптимизации.
236
+ - **excludePattern**:
237
+ - _Тип_: `string | string[]`
238
+ - _По умолчанию_: `['**/node_modules/**']`
239
+ - _Описание_: Шаблоны для исключения из оптимизации.
240
+ - **outputDir** (Deprecated):
241
+ - _Тип_: `string`
242
+ - _По умолчанию_: `'compiler'`
243
+ - _Описание_: Каталог, в котором будут храниться извлеченные словари.
244
+
245
+ - **output**:
246
+ - _Тип_: `FilePathPattern`
247
+ - _По умолчанию_: `({ key }) => 'compiler/${key}.content.json'`
248
+ - _Описание_: Определяет путь к выходным файлам. Заменяет `outputDir`. Поддерживает динамические переменные, такие как `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`. Может быть задано как строка в формате `'my/{{var}}/path'` или как функция.
249
+ - _Примечание_: `./**/*` Пути разрешаются относительно компонента. `/**/*` пути разрешаются относительно `baseDir` Intlayer.
250
+ - _Пример_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
251
+
252
+ - **noMetadata**:
253
+ - _Тип_: `boolean`
254
+ - _По умолчанию_: `false`
255
+ - _Описание_: Указывает, должны ли метаданные сохраняться в файле. Если true, компилятор не будет сохранять метаданные словарей (ключ, оболочка содержимого).
256
+ - _Примечание_: Полезно при использовании с плагином `loadJSON`.
257
+ - _Пример_: Если `true`:
258
+ ```json
259
+ {
260
+ "key": "value"
261
+ }
262
+ ```
263
+ Если `false`:
264
+ ```json
265
+ {
266
+ "key": "value",
267
+ "content": {
268
+ "key": "value"
269
+ }
270
+ }
271
+ ```
272
+
273
+ - **saveComponents**:
274
+ - _Тип_: `boolean`
275
+ - _По умолчанию_: `false`
276
+ - _Описание_: Указывает, должны ли компоненты сохраняться после трансформации.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  createdAt: 2024-08-13
3
- updatedAt: 2026-02-25
3
+ updatedAt: 2026-03-10
4
4
  title: Конфигурация
5
5
  description: Узнайте, как настроить Intlayer для вашего приложения. Поймите различные параметры и опции, доступные для настройки Intlayer под ваши нужды.
6
6
  keywords:
@@ -14,6 +14,9 @@ slugs:
14
14
  - concept
15
15
  - configuration
16
16
  history:
17
+ - version: 8.2.0
18
+ date: 2026-03-10
19
+ changes: Update compiler options, add 'output' and 'noMetadata' support
17
20
  - version: 8.1.7
18
21
  date: 2026-02-25
19
22
  changes: Обновление опций компилятора
@@ -427,7 +430,7 @@ const config: IntlayerConfig = {
427
430
  */
428
431
  compiler: {
429
432
  /**
430
- * Indicates if the compiler should be enabled.
433
+ * Указывает, должен ли компилятор быть включен.
431
434
  */
432
435
  enabled: true,
433
436
 
@@ -445,18 +448,23 @@ const config: IntlayerConfig = {
445
448
  excludePattern: ["**/node_modules/**"],
446
449
 
447
450
  /**
448
- * Output directory for the optimized dictionaries.
451
+ * Выходной каталог для оптимизированных словарей.
449
452
  */
450
- outputDir: "compiler",
453
+ output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
451
454
 
452
455
  /**
453
- * Dictionary key prefix
456
+ * Вставьте только содержимое в сгенерированный файл, без ключа.
457
+ */
458
+ noMetadata: false,
459
+
460
+ /**
461
+ * Префикс ключа словаря
454
462
  */
455
463
  dictionaryKeyPrefix: "", // Remove base prefix
456
464
 
457
465
  /**
458
- * Indicates if the components should be saved after being transformed.
459
- * That way, the compiler can be run only once to transform the app, and then it can be removed.
466
+ * Указывает, должны ли компоненты сохраняться после трансформации.
467
+ * Таким образом, компилятор можно запустить только один раз для трансформации приложения, а затем удалить.
460
468
  */
461
469
  saveComponents: false,
462
470
  },
@@ -712,7 +720,7 @@ export default config;
712
720
  #### Свойства
713
721
 
714
722
  - **autoFill**:
715
- - _Тип_: `boolean | string | { [key in Locales]?: string }`
723
+ - _Тип_: `boolean | string | FilePathPattern | { [key in Locales]?: string }`
716
724
  - _По умолчанию_: `undefined`
717
725
  - _Описание_: Указывает, как содержимое должно автоматически заполняться с помощью ИИ. Может быть объявлено глобально в файле `intlayer.config.ts`.
718
726
  - _Пример_: true
@@ -970,10 +978,10 @@ Intlayer поддерживает несколько провайдеров ИИ
970
978
  - _Примечание_: Может использоваться для отключения сборки словарей, например, когда следует избегать выполнения в среде Node.js.
971
979
 
972
980
  - **checkTypes**:
973
- - _Type_: `boolean`
974
- - _Default_: `false`
975
- - _Description_: Указывает, должна ли сборка проверять типы TypeScript и регистрировать ошибки.
976
- - _Note_: Это может замедлить процесс сборки.
981
+ - _Тип_: `boolean`
982
+ - _По умолчанию_: `false`
983
+ - _Описание_: Указывает, должна ли сборка проверять типы TypeScript и регистрировать ошибки.
984
+ - _Примечание_: Это может замедлить процесс сборки.
977
985
 
978
986
  - **optimize**:
979
987
  - _Тип_: `boolean`
@@ -986,7 +994,7 @@ Intlayer поддерживает несколько провайдеров ИИ
986
994
  - _Примечание_: Убедитесь, что все ключи объявлены статически в вызовах `useIntlayer`, например `useIntlayer('navbar')`.
987
995
 
988
996
  - **importMode**:
989
- - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
997
+ - _Примечание_: **Deprecated**: Use `dictionary.importMode` instead.
990
998
  - _Тип_: `'static' | 'dynamic' | 'fetch'`
991
999
  - _По умолчанию_: `'static'`
992
1000
  - _Описание_: Управляет способом импорта словарей.
@@ -1065,3 +1073,31 @@ Intlayer поддерживает несколько провайдеров ИИ
1065
1073
  - _Тип_: `string`
1066
1074
  - _По умолчанию_: `'compiler'`
1067
1075
  - _Описание_: Каталог, в котором будут храниться извлеченные словари, относительно базового пути вашего проекта.
1076
+
1077
+ - **output**:
1078
+ - _Тип_: `FilePathPattern`
1079
+ - _По умолчанию_: `({ key }) => 'compiler/${key}.content.json'`
1080
+ - _Описание_: Определяет путь к выходным файлам. Заменяет `outputDir`. Поддерживает динамические переменные, такие как `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`. Может быть задано как строка в формате `'my/{{var}}/path'` или как функция.
1081
+ - _Примечание_: `./**/*` Пути разрешаются относительно компонента. `/**/*` пути разрешаются относительно `baseDir` Intlayer.
1082
+ - _Пример_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
1083
+
1084
+ - **noMetadata**:
1085
+ - _Тип_: `boolean`
1086
+ - _По умолчанию_: `false`
1087
+ - _Описание_: Указывает, должны ли метаданные сохраняться в файле. Если true, компилятор не будет сохранять метаданные словарей (ключ, оболочка содержимого).
1088
+ - _Примечание_: Полезно при использовании с плагином `loadJSON`.
1089
+ - _Пример_: Если `true`:
1090
+ ```json
1091
+ {
1092
+ "key": "value"
1093
+ }
1094
+ ```
1095
+ Если `false`:
1096
+ ```json
1097
+ {
1098
+ "key": "value",
1099
+ "content": {
1100
+ "key": "value"
1101
+ }
1102
+ }
1103
+ ```
@@ -20,6 +20,9 @@ slugs:
20
20
  applicationTemplate: https://github.com/aymericzip/intlayer-next-no-lolale-path-template
21
21
  youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
22
22
  history:
23
+ - version: 8.2.0
24
+ date: 2026-03-09
25
+ changes: Update compiler options, add FilePathPattern support
23
26
  - version: 8.1.6
24
27
  date: 2026-02-23
25
28
  changes: Начальный выпуск
@@ -135,16 +138,21 @@ const config: IntlayerConfig = {
135
138
  /**
136
139
  * Выходной каталог для оптимизированных словарей.
137
140
  */
138
- outputDir: "compiler",
141
+ output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
142
+
143
+ /**
144
+ * Вставьте только содержимое в сгенерированный файл, без ключа.
145
+ */
146
+ noMetadata: false,
139
147
 
140
148
  /**
141
149
  * Префикс ключа словаря
142
150
  */
143
- dictionaryKeyPrefix: "", // Удалить базовый префикс
151
+ dictionaryKeyPrefix: "", // Remove base prefix
144
152
 
145
153
  /**
146
154
  * Указывает, должны ли компоненты сохраняться после трансформации.
147
- * Таким образом, компилятор можно запустить один раз для трансформации приложения, после чего его можно удалить.
155
+ * Таким образом, компилятор можно запустить только один раз для трансформации приложения, а затем удалить.
148
156
  */
149
157
  saveComponents: false,
150
158
  },
@@ -19,6 +19,9 @@ slugs:
19
19
  applicationTemplate: https://github.com/aymericzip/intlayer-vite-react-template
20
20
  youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
21
21
  history:
22
+ - version: 8.2.0
23
+ date: 2026-03-09
24
+ changes: Update compiler options, add FilePathPattern support
22
25
  - version: 8.1.6
23
26
  date: 2026-02-23
24
27
  changes: Первый выпуск
@@ -132,16 +135,21 @@ const config: IntlayerConfig = {
132
135
  /**
133
136
  * Выходной каталог для оптимизированных словарей.
134
137
  */
135
- outputDir: "compiler",
138
+ output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
139
+
140
+ /**
141
+ * Вставьте только содержимое в сгенерированный файл, без ключа.
142
+ */
143
+ noMetadata: false,
136
144
 
137
145
  /**
138
146
  * Префикс ключа словаря
139
147
  */
140
- dictionaryKeyPrefix: "", // Удалить базовый префикс
148
+ dictionaryKeyPrefix: "", // Remove base prefix
141
149
 
142
150
  /**
143
151
  * Указывает, должны ли компоненты сохраняться после трансформации.
144
- * Таким образом, компилятор можно запустить один раз для трансформации приложения, после чего его можно удалить.
152
+ * Таким образом, компилятор можно запустить только один раз для трансформации приложения, а затем удалить.
145
153
  */
146
154
  saveComponents: false,
147
155
  },
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  createdAt: 2025-09-09
3
- updatedAt: 2026-02-25
3
+ updatedAt: 2026-03-10
4
4
  title: Intlayer Compiler | i18n için Otomatik İçerik Çıkarımı
5
5
  description: Uluslararasılaştırma sürecinizi Intlayer Compiler ile otomatikleştirin. İçeriği bileşenlerinizden doğrudan çıkararak Vite, Next.js ve daha fazlasında daha hızlı ve verimli i18n sağlayın.
6
6
  keywords:
@@ -20,6 +20,9 @@ slugs:
20
20
  - doc
21
21
  - compiler
22
22
  history:
23
+ - version: 8.2.0
24
+ date: 2026-03-09
25
+ changes: Update compiler options, add FilePathPattern support
23
26
  - version: 8.1.7
24
27
  date: 2026-02-25
25
28
  changes: Derleyici seçeneklerini güncelle
@@ -157,13 +160,12 @@ import { type IntlayerConfig, Locales } from "intlayer";
157
160
  const config: IntlayerConfig = {
158
161
  compiler: {
159
162
  /**
160
- * Derleyicinin etkinleştirilip etkinleştirilmeyeceğini belirtir.
161
163
  * Geliştirme sırasında derleyiciyi atlamak ve başlangıç sürelerini hızlandırmak için 'build-only' olarak ayarlayın.
162
164
  */
163
165
  enabled: true,
164
166
 
165
167
  /**
166
- * Optimize edilecek kodu taramak için desen.
168
+ * Pattern to traverse the code to optimize.
167
169
  */
168
170
  transformPattern: [
169
171
  "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
@@ -171,19 +173,24 @@ const config: IntlayerConfig = {
171
173
  ],
172
174
 
173
175
  /**
174
- * Optimizasyondan hariç tutulacak desen.
176
+ * Pattern to exclude from the optimization.
175
177
  */
176
178
  excludePattern: ["**/node_modules/**"],
177
179
 
178
180
  /**
179
- * Optimize edilmiş sözlükler için çıktı dizini.
181
+ * Optimize edilmiş sözlükler für çıktı dizini.
180
182
  */
181
- outputDir: "i18n",
183
+ output: ({ key }) => `compiler/${key}.content.json`,
182
184
 
183
185
  /**
184
- * Sözlük anahtarı öneki
186
+ * Oluşturulan dosyaya yalnızca içeriği yerleştirin, anahtar olmadan.
185
187
  */
186
- dictionaryKeyPrefix: "", // Temel öneki kaldır
188
+ noMetadata: false,
189
+
190
+ /**
191
+ * Sözlük anahtar öneki
192
+ */
193
+ dictionaryKeyPrefix: "", // Remove base prefix
187
194
 
188
195
  /**
189
196
  * Bileşenlerin dönüştürüldükten sonra kaydedilip kaydedilmeyeceğini belirtir.
@@ -209,3 +216,61 @@ npx intlayer fill # Eksik çevirileri doldur
209
216
  ```
210
217
 
211
218
  > Daha fazla ayrıntı için [CLI belgelerine](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/ci.md) bakın.
219
+
220
+ ### Derleyici Yapılandırma Referansı
221
+
222
+ Aşağıdaki özellikler `intlayer.config.ts` dosyanızın `compiler` bloğunda yapılandırılabilir:
223
+
224
+ - **enabled**:
225
+ - _Tip_: `boolean | 'build-only'`
226
+ - _Varsayılan_: `true`
227
+ - _Açıklama_: Derleyicinin etkinleştirilip etkinleştirilmeyeceğini belirtir.
228
+ - **dictionaryKeyPrefix**:
229
+ - _Tip_: `string`
230
+ - _Varsayılan_: `'comp-'`
231
+ - _Açıklama_: Ayıklanan sözlük anahtarları için önek.
232
+ - **transformPattern**:
233
+ - _Tip_: `string | string[]`
234
+ - _Varsayılan_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
235
+ - _Açıklama_: Optimize edilecek kodu taramak için desenler.
236
+ - **excludePattern**:
237
+ - _Tip_: `string | string[]`
238
+ - _Varsayılan_: `['**/node_modules/**']`
239
+ - _Açıklama_: Optimizasyondan hariç tutulacak desenler.
240
+ - **outputDir** (Deprecated):
241
+ - _Tip_: `string`
242
+ - _Varsayılan_: `'compiler'`
243
+ - _Açıklama_: Ayıklanan sözlüklerin saklanacağı dizin.
244
+
245
+ - **output**:
246
+ - _Tip_: `FilePathPattern`
247
+ - _Varsayılan_: `({ key }) => 'compiler/${key}.content.json'`
248
+ - _Açıklama_: Çıktı dosyalarının yolunu tanımlar. `outputDir` yerine geçer. `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, ve `{{componentFormat}}` gibi dinamik değişkenleri işler. `'my/{{var}}/path'` formatı kullanılarak bir dize olarak veya bir fonksiyon olarak ayarlanabilir.
249
+ - _Not_: `./**/*` yolları bileşene göre çözümlenir. `/**/*` yolları Intlayer `baseDir`'e göre çözümlenir.
250
+ - _Örnek_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
251
+
252
+ - **noMetadata**:
253
+ - _Tip_: `boolean`
254
+ - _Varsayılan_: `false`
255
+ - _Açıklama_: Meta verilerin dosyaya kaydedilip kaydedilmeyeceğini belirtir. Doğruysa, derleyici sözlüklerin meta verilerini (anahtar, içerik sarmalayıcı) kaydetmez.
256
+ - _Not_: `loadJSON` eklentisi ile kullanıldığında kullanışlıdır.
257
+ - _Örnek_: `true` ise:
258
+ ```json
259
+ {
260
+ "key": "value"
261
+ }
262
+ ```
263
+ `false` ise:
264
+ ```json
265
+ {
266
+ "key": "value",
267
+ "content": {
268
+ "key": "value"
269
+ }
270
+ }
271
+ ```
272
+
273
+ - **saveComponents**:
274
+ - _Tip_: `boolean`
275
+ - _Varsayılan_: `false`
276
+ - _Açıklama_: Bileşenlerin dönüştürüldükten sonra kaydedilip kaydedilmeyeceğini belirtir.
@@ -14,6 +14,9 @@ slugs:
14
14
  - concept
15
15
  - configuration
16
16
  history:
17
+ - version: 8.2.0
18
+ date: 2026-03-09
19
+ changes: Update compiler options, add 'output' and 'noMetadata' support
17
20
  - version: 8.1.7
18
21
  date: 2026-02-25
19
22
  changes: Derleyici seçeneklerini güncelle
@@ -422,7 +425,7 @@ const config: IntlayerConfig = {
422
425
  */
423
426
  compiler: {
424
427
  /**
425
- * Indicates if the compiler should be enabled.
428
+ * Derleyicinin etkinleştirilip etkinleştirilmeyeceğini belirtir.
426
429
  */
427
430
  enabled: true,
428
431
 
@@ -440,18 +443,23 @@ const config: IntlayerConfig = {
440
443
  excludePattern: ["**/node_modules/**"],
441
444
 
442
445
  /**
443
- * Output directory for the optimized dictionaries.
446
+ * Optimize edilmiş sözlükler für çıktı dizini.
444
447
  */
445
- outputDir: "compiler",
448
+ output: ({ key }) => `compiler/${key}.content.json`,
446
449
 
447
450
  /**
448
- * Dictionary key prefix
451
+ * Oluşturulan dosyaya yalnızca içeriği yerleştirin, anahtar olmadan.
452
+ */
453
+ noMetadata: false,
454
+
455
+ /**
456
+ * Sözlük anahtar öneki
449
457
  */
450
458
  dictionaryKeyPrefix: "", // Remove base prefix
451
459
 
452
460
  /**
453
- * Indicates if the components should be saved after being transformed.
454
- * That way, the compiler can be run only once to transform the app, and then it can be removed.
461
+ * Bileşenlerin dönüştürüldükten sonra kaydedilip kaydedilmeyeceğini belirtir.
462
+ * Bu şekilde, derleyici uygulamayı dönüştürmek için yalnızca bir kez çalıştırılabilir ve ardından kaldırılabilir.
455
463
  */
456
464
  saveComponents: false,
457
465
  },
@@ -707,7 +715,7 @@ Uygulama içindeki içerik yönetimi ile ilgili ayarlar; dizin isimleri, dosya u
707
715
  #### Özellikler
708
716
 
709
717
  - **autoFill**:
710
- - _Tür_: `boolean | string | { [key in Locales]?: string }`
718
+ - _Tür_: `boolean | string | FilePathPattern | { [key in Locales]?: string }`
711
719
  - _Varsayılan_: `undefined`
712
720
  - _Açıklama_: İçeriğin yapay zeka kullanılarak otomatik olarak nasıl doldurulacağını belirtir. `intlayer.config.ts` dosyasında global olarak tanımlanabilir.
713
721
  - _Örnek_: true
@@ -823,11 +831,11 @@ Bu sözlük yapılandırması iki ana amaç için hizmet eder:
823
831
  - **locale**
824
832
  - **location**
825
833
  - **importMode**:
826
- - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
827
- - _Type_: `'static' | 'dynamic' | 'fetch'`
828
- - _Default_: `'static'`
829
- - _Description_: Controls how dictionaries are imported.
830
- - _Example_: `'dynamic'`
834
+ - _Not_: **Deprecated**: Use `dictionary.importMode` instead.
835
+ - _Tip_: `'static' | 'dynamic' | 'fetch'`
836
+ - _Varsayılan_: `'static'`
837
+ - _Açıklama_: Controls how dictionaries are imported.
838
+ - _Örnek_: `'dynamic'`
831
839
  - **priority**
832
840
  - **live**
833
841
  - **schema**
@@ -958,10 +966,10 @@ Derleme seçenekleri `@intlayer/babel` ve `@intlayer/swc` eklentilerine uygulan
958
966
  - _Not_: Sözlük derlemesini devre dışı bırakmak için kullanılabilir, örneğin Node.js ortamında yürütmeden kaçınılması gerektiğinde.
959
967
 
960
968
  - **checkTypes**:
961
- - _Type_: `boolean`
962
- - _Default_: `false`
963
- - _Description_: Derlemenin TypeScript türlerini kontrol edip etmeyeceğini ve hataları kaydedip kaydetmeyeceğini belirtir.
964
- - _Note_: Bu, derleme işlemini yavaşlatabilir.
969
+ - _Tip_: `boolean`
970
+ - _Varsayılan_: `false`
971
+ - _Açıklama_: Derlemenin TypeScript türlerini kontrol edip etmeyeceğini ve hataları kaydedip kaydetmeyeceğini belirtir.
972
+ - _Not_: Bu, derleme işlemini yavaşlatabilir.
965
973
 
966
974
  - **optimize**:
967
975
  - _Tür_: `boolean`
@@ -974,7 +982,7 @@ Derleme seçenekleri `@intlayer/babel` ve `@intlayer/swc` eklentilerine uygulan
974
982
  - _Not_: `useIntlayer` çağrılarında tüm anahtarların statik olarak tanımlandığından emin olun. Örneğin `useIntlayer('navbar')`.
975
983
 
976
984
  - **importMode**:
977
- - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
985
+ - _Not_: **Deprecated**: Use `dictionary.importMode` instead.
978
986
  - _Tür_: `'static' | 'dynamic' | 'fetch'`
979
987
  - _Varsayılan_: `'static'`
980
988
  - _Açıklama_: Sözlüklerin nasıl içe aktarılacağını kontrol eder.
@@ -1053,3 +1061,31 @@ Sözlükleri doğrudan bileşenlerinizden çıkaran Intlayer derleyicisini kontr
1053
1061
  - _Tür_: `string`
1054
1062
  - _Varsayılan_: `'compiler'`
1055
1063
  - _Açıklama_: Çıkarılan sözlüklerin, proje temel yolunuza göre saklanacağı dizin.
1064
+
1065
+ - **output**:
1066
+ - _Tip_: `FilePathPattern`
1067
+ - _Varsayılan_: `({ key }) => 'compiler/${key}.content.json'`
1068
+ - _Açıklama_: Çıktı dosyalarının yolunu tanımlar. `outputDir` yerine geçer. `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, ve `{{componentFormat}}` gibi dinamik değişkenleri işler. `'my/{{var}}/path'` formatı kullanılarak bir dize olarak veya bir fonksiyon olarak ayarlanabilir.
1069
+ - _Not_: `./**/*` yolları bileşene göre çözümlenir. `/**/*` yolları Intlayer `baseDir`'e göre çözümlenir.
1070
+ - _Örnek_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
1071
+
1072
+ - **noMetadata**:
1073
+ - _Tip_: `boolean`
1074
+ - _Varsayılan_: `false`
1075
+ - _Açıklama_: Meta verilerin dosyaya kaydedilip kaydedilmeyeceğini belirtir. Doğruysa, derleyici sözlüklerin meta verilerini (anahtar, içerik sarmalayıcı) kaydetmez.
1076
+ - _Not_: `loadJSON` eklentisi ile kullanıldığında kullanışlıdır.
1077
+ - _Örnek_: `true` ise:
1078
+ ```json
1079
+ {
1080
+ "key": "value"
1081
+ }
1082
+ ```
1083
+ `false` ise:
1084
+ ```json
1085
+ {
1086
+ "key": "value",
1087
+ "content": {
1088
+ "key": "value"
1089
+ }
1090
+ }
1091
+ ```
@@ -20,6 +20,9 @@ slugs:
20
20
  applicationTemplate: https://github.com/aymericzip/intlayer-next-no-lolale-path-template
21
21
  youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
22
22
  history:
23
+ - version: 8.2.0
24
+ date: 2026-03-09
25
+ changes: Update compiler options, add FilePathPattern support
23
26
  - version: 8.1.6
24
27
  date: 2026-02-23
25
28
  changes: İlk Sürüm
@@ -133,14 +136,19 @@ const config: IntlayerConfig = {
133
136
  enabled: true,
134
137
 
135
138
  /**
136
- * Optimize edilmiş sözlükler için çıktı dizini.
139
+ * Optimize edilmiş sözlükler für çıktı dizini.
137
140
  */
138
- outputDir: "compiler",
141
+ output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
142
+
143
+ /**
144
+ * Oluşturulan dosyaya yalnızca içeriği yerleştirin, anahtar olmadan.
145
+ */
146
+ noMetadata: false,
139
147
 
140
148
  /**
141
149
  * Sözlük anahtar öneki
142
150
  */
143
- dictionaryKeyPrefix: "", // Temel öneki kaldır
151
+ dictionaryKeyPrefix: "", // Remove base prefix
144
152
 
145
153
  /**
146
154
  * Bileşenlerin dönüştürüldükten sonra kaydedilip kaydedilmeyeceğini belirtir.