@docx-editor.dev/i18n 2.22.0 → 2.23.0

package/README.md

@@ -14,7 +14,7 @@
 
 # @docx-editor.dev/i18n
 
-Translate [docx-editor.dev](https://docx-editor.dev) controls with locale strings, types, and runtime helpers. The package provides ten languages and falls back to English for missing translations.
+Translate [docx-editor.dev](https://docx-editor.dev) controls with locale strings, types, and runtime helpers. The package provides eleven languages and falls back to English for missing translations.
 
 ## Quick start
 
@@ -28,11 +28,13 @@ Pass a locale to the editor. This example requires the React adapter and its eng
 
 ```tsx
 import { DocxEditor } from '@docx-editor.dev/react';
-import { de } from '@docx-editor.dev/i18n';
+import { es } from '@docx-editor.dev/i18n';
 
-<DocxEditor document={bytes} i18n={de} />;
+<DocxEditor document={bytes} i18n={es} locale="es-ES" />;
 ```
 
+The `i18n` prop translates controls. Set `locale` separately for regional date input and generated document labels. It defaults to `en-US`.
+
 To share a locale across editors and custom controls, use `LocaleProvider`:
 
 ```tsx
@@ -44,7 +46,7 @@ import { de } from '@docx-editor.dev/i18n';
 </LocaleProvider>;
 ```
 
-Chrome you write yourself reads the same catalog through `useTranslation()`.
+Custom controls read the same catalog through `useTranslation()`.
 
 Mix a community locale with custom overrides:
 
@@ -57,7 +59,7 @@ const myLocale = {
 };
 ```
 
-Keys set to `null` in any locale fall back to English.
+Missing or `null` keys keep the inherited catalog value. Without an outer `LocaleProvider`, they fall back to English.
 
 ## Available locales
 
@@ -65,6 +67,7 @@ Keys set to `null` in any locale fall back to English.
 | ------- | ------ | ------------------- |
 | `en`    | `en`   | English (source)    |
 | `de`    | `de`   | German              |
+| `es`    | `es`   | Spanish             |
 | `fr`    | `fr`   | French              |
 | `he`    | `he`   | Hebrew              |
 | `hi`    | `hi`   | Hindi               |
@@ -101,7 +104,7 @@ For on-demand loading, use a dynamic import instead:
 const pl = (await import('@docx-editor.dev/i18n/pl')).default;
 ```
 
-Subpaths ship for every locale: `/en`, `/de`, `/fr`, `/he`, `/hi`, `/id`, `/pl`, `/pt-BR`, `/tr`, `/zh-CN`. Each also exports its locale as a named binding (`import { pl } from '@docx-editor.dev/i18n/pl'`) for callers that prefer non-default imports.
+Subpaths ship for every locale: `/en`, `/de`, `/es`, `/fr`, `/he`, `/hi`, `/id`, `/pl`, `/pt-BR`, `/tr`, `/zh-CN`. Each also exports its locale as a named binding (`import { pl } from '@docx-editor.dev/i18n/pl'`) for callers that prefer non-default imports.
 
 ## Types