@docx-editor.dev/i18n 2.21.0 → 2.22.0

package/README.md

@@ -14,15 +14,17 @@
 
 # @docx-editor.dev/i18n
 
-Locale strings, types, and runtime helpers for the [docx-editor.dev](https://docx-editor.dev) editor chrome. Ten languages, with per-key fallback to English.
+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.
 
-## Quick Start
+## Quick start
+
+Install the locale package:
 
 ```bash
 npm install @docx-editor.dev/i18n
 ```
 
-Hand the catalog to the editor:
+Pass a locale to the editor. This example requires the React adapter and its engine peer:
 
 ```tsx
 import { DocxEditor } from '@docx-editor.dev/react';
@@ -31,13 +33,13 @@ import { de } from '@docx-editor.dev/i18n';
 <DocxEditor document={bytes} i18n={de} />;
 ```
 
-For several editors, or for chrome parts you compose yourself, put it in context once with `LocaleProvider` instead:
+To share a locale across editors and custom controls, use `LocaleProvider`:
 
 ```tsx
 import { DocxEditor, LocaleProvider } from '@docx-editor.dev/react';
+import { de } from '@docx-editor.dev/i18n';
 
 <LocaleProvider i18n={de}>
-  <DocxEditor.Toolbar />
   <DocxEditor document={bytes} />
 </LocaleProvider>;
 ```
@@ -51,24 +53,12 @@ import { de } from '@docx-editor.dev/i18n';
 
 const myLocale = {
   ...de,
-  toolbar: { ...de.toolbar, bold: 'Fettdruck' },
+  formattingBar: { ...de.formattingBar, bold: 'Fettdruck' },
 };
 ```
 
 Keys set to `null` in any locale fall back to English.
 
-## Packages
-
-| Package                                                                                    | Description                                                                                       |
-| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- |
-| [`@docx-editor.dev/react`](https://www.npmjs.com/package/@docx-editor.dev/react)           | React adapter. `<DocxEditor>`, provider primitives, hooks, and compound chrome.                   |
-| [`@docx-editor.dev/core`](https://www.npmjs.com/package/@docx-editor.dev/core)             | Framework-agnostic engine: OOXML read/write, canonical document tree, layout, paint.              |
-| [`@docx-editor.dev/i18n`](https://www.npmjs.com/package/@docx-editor.dev/i18n)             | Shared locale strings and types.                                                                  |
-| [`@docx-editor.dev/pro`](https://www.npmjs.com/package/@docx-editor.dev/pro)               | Tracked changes, comments, and custom nodes.                                                      |
-| [`@docx-editor.dev/editor-api`](https://www.npmjs.com/package/@docx-editor.dev/editor-api) | Office.js-compatible editing API: a batching object model, on a server or against an open editor. |
-
-> **Forking the adapter?** Keep your fork thin. Depend on `@docx-editor.dev/core` directly so parser, serializer, and rendering fixes land in your build automatically, without backporting each upstream change by hand.
-
 ## Available locales
 
 | Code    | Export | Language            |
@@ -94,17 +84,20 @@ import { locales } from '@docx-editor.dev/i18n';
 </LocaleProvider>;
 ```
 
-> Importing `locales` pulls every locale into your bundle. For a smaller bundle, import only the ones you need by name; `sideEffects: false` lets the rest tree-shake.
+Importing `locales` includes every locale in your bundle. Import individual locales to reduce the bundle size.
 
 ## Per-locale subpaths
 
-For apps that pick the locale at runtime, the named exports above don't tree-shake — the bundler can't know which locale wins, so it ships them all. Use the per-locale subpaths instead. Each one bundles a single locale (~30KB) and code-splits cleanly:
+If you choose a locale at runtime, import its subpath to load only that locale. Static imports include it in the bundle. Dynamic imports let the bundler create a separate chunk:
 
 ```ts
-// Static — bundler ships only this locale's strings
+// Static import: include only this locale's strings.
 import pl from '@docx-editor.dev/i18n/pl';
+```
+
+For on-demand loading, use a dynamic import instead:
 
-// Dynamic — splits into its own chunk, loaded on demand
+```ts
 const pl = (await import('@docx-editor.dev/i18n/pl')).default;
 ```
 
@@ -112,6 +105,8 @@ Subpaths ship for every locale: `/en`, `/de`, `/fr`, `/he`, `/hi`, `/id`, `/pl`,
 
 ## Types
 
+Import types to describe locale data and translation functions:
+
 ```ts
 import type {
   LocaleStrings, // shape of `en`, the full source of truth
@@ -140,8 +135,8 @@ t('navigation.find.total', { total: 15 }); // ICU plurals
 
 ## Contributing
 
-Contributions welcome. See [CONTRIBUTING.md](https://github.com/eigenpal/docx-editor/blob/main/CONTRIBUTING.md) for setup, tests, and the one-time CLA signature.
+To contribute, see [CONTRIBUTING.md](https://github.com/eigenpal/docx-editor/blob/main/CONTRIBUTING.md) for setup, tests, and the one-time CLA signature.
 
-## Commercial Support
+## Commercial support
 
-> [!TIP] Questions or custom features? Email **[docx-editor@eigenpal.com](mailto:docx-editor@eigenpal.com)**.
+For commercial support or custom features, [email the support team](mailto:docx-editor@eigenpal.com).

package/dist/de.js

@@ -62,7 +62,28 @@ var de_default = {
     insertFootnote: "Fußnote einfügen",
     insertEndnote: "Endnote einfügen",
     insertTable: null,
-    review: null
+    review: null,
+    export: null,
+    exportFailed: null,
+    exportMarkdown: null,
+    exportMarkdownMissing: null,
+    exportPdf: null,
+    exportPdfMissing: null,
+    exportPdfServerUnavailable: null,
+    exportContinueEditing: null,
+    exportDownloadHint: null,
+    exportMarkdownFailed: null,
+    exportPdfFailed: null,
+    exportingMarkdown: null,
+    exportingPdf: null,
+    printFailed: null,
+    printFailedMessage: null,
+    printOpenPdf: null,
+    printPdfMissing: null,
+    printPreparing: null,
+    printNoViewer: null,
+    printLoadFailed: null,
+    printRefused: null
   },
   formattingBar: {
     groups: {
@@ -107,7 +128,8 @@ var de_default = {
     imageWrap: "Textumbruch",
     formatPainter: null,
     formatPainterShortcut: null,
-    paragraphMarks: null
+    paragraphMarks: null,
+    label: null
   },
   alignment: {
     alignLeft: "Linksbündig",
@@ -497,7 +519,9 @@ var de_default = {
   editor: {
     showDocumentOutline: "Dokumentgliederung anzeigen",
     linkCopied: "Link in Zwischenablage kopiert",
-    fontSubstitutionNotice: "Einige Schriftarten in diesem Dokument sind nicht verfügbar, daher werden Ersatzschriftarten angezeigt: {fonts}"
+    fontSubstitutionNotice: "Einige Schriftarten in diesem Dokument sind nicht verfügbar, daher werden Ersatzschriftarten angezeigt: {fonts}",
+    documentContent: null,
+    documentViewport: null
   },
   hyperlinkPopup: {
     displayTextPlaceholder: "Anzuzeigender Text",
@@ -620,6 +644,14 @@ var de_default = {
       start: null,
       strike: null,
       underline: null
+    },
+    structuralDetails: {
+      cellDelete: null,
+      cellInsert: null,
+      cellMerge: null,
+      numberingInsert: null,
+      rowDelete: null,
+      rowInsert: null
     }
   },
   toc: {
@@ -936,6 +968,44 @@ var de_default = {
     lowercase: null,
     firstCapital: null,
     titleCase: null
+  },
+  documentRefresh: {
+    cancel: null,
+    cancelled: null,
+    capturing: null,
+    clear: null,
+    complete: null,
+    count: null,
+    delivery: null,
+    description: null,
+    download: null,
+    empty: null,
+    failed: null,
+    idle: null,
+    invalidDocument: null,
+    limitations: null,
+    loadError: null,
+    localEdits: null,
+    next: null,
+    partial: null,
+    position: null,
+    previous: null,
+    processing: null,
+    recovering: null,
+    recoveryFailed: null,
+    refreshing: null,
+    reset: null,
+    retry: null,
+    review: null,
+    show: null,
+    start: null,
+    title: null,
+    unavailable: null,
+    sampleDescription: null,
+    scrollToChange: null,
+    scrolled: null,
+    processingLabel: null,
+    sampleEdited: null
   }
 };
 

package/dist/de.mjs

@@ -35,7 +35,28 @@ var de_default = {
     insertFootnote: "Fußnote einfügen",
     insertEndnote: "Endnote einfügen",
     insertTable: null,
-    review: null
+    review: null,
+    export: null,
+    exportFailed: null,
+    exportMarkdown: null,
+    exportMarkdownMissing: null,
+    exportPdf: null,
+    exportPdfMissing: null,
+    exportPdfServerUnavailable: null,
+    exportContinueEditing: null,
+    exportDownloadHint: null,
+    exportMarkdownFailed: null,
+    exportPdfFailed: null,
+    exportingMarkdown: null,
+    exportingPdf: null,
+    printFailed: null,
+    printFailedMessage: null,
+    printOpenPdf: null,
+    printPdfMissing: null,
+    printPreparing: null,
+    printNoViewer: null,
+    printLoadFailed: null,
+    printRefused: null
   },
   formattingBar: {
     groups: {
@@ -80,7 +101,8 @@ var de_default = {
     imageWrap: "Textumbruch",
     formatPainter: null,
     formatPainterShortcut: null,
-    paragraphMarks: null
+    paragraphMarks: null,
+    label: null
   },
   alignment: {
     alignLeft: "Linksbündig",
@@ -470,7 +492,9 @@ var de_default = {
   editor: {
     showDocumentOutline: "Dokumentgliederung anzeigen",
     linkCopied: "Link in Zwischenablage kopiert",
-    fontSubstitutionNotice: "Einige Schriftarten in diesem Dokument sind nicht verfügbar, daher werden Ersatzschriftarten angezeigt: {fonts}"
+    fontSubstitutionNotice: "Einige Schriftarten in diesem Dokument sind nicht verfügbar, daher werden Ersatzschriftarten angezeigt: {fonts}",
+    documentContent: null,
+    documentViewport: null
   },
   hyperlinkPopup: {
     displayTextPlaceholder: "Anzuzeigender Text",
@@ -593,6 +617,14 @@ var de_default = {
       start: null,
       strike: null,
       underline: null
+    },
+    structuralDetails: {
+      cellDelete: null,
+      cellInsert: null,
+      cellMerge: null,
+      numberingInsert: null,
+      rowDelete: null,
+      rowInsert: null
     }
   },
   toc: {
@@ -909,6 +941,44 @@ var de_default = {
     lowercase: null,
     firstCapital: null,
     titleCase: null
+  },
+  documentRefresh: {
+    cancel: null,
+    cancelled: null,
+    capturing: null,
+    clear: null,
+    complete: null,
+    count: null,
+    delivery: null,
+    description: null,
+    download: null,
+    empty: null,
+    failed: null,
+    idle: null,
+    invalidDocument: null,
+    limitations: null,
+    loadError: null,
+    localEdits: null,
+    next: null,
+    partial: null,
+    position: null,
+    previous: null,
+    processing: null,
+    recovering: null,
+    recoveryFailed: null,
+    refreshing: null,
+    reset: null,
+    retry: null,
+    review: null,
+    show: null,
+    start: null,
+    title: null,
+    unavailable: null,
+    sampleDescription: null,
+    scrollToChange: null,
+    scrolled: null,
+    processingLabel: null,
+    sampleEdited: null
   }
 };
 

package/dist/en.js

@@ -91,13 +91,35 @@ var en_default = {
     tableOfContents: "Table of contents",
     watermark: "Watermark",
     help: "Help",
-    reportIssue: "Report issue"
+    reportIssue: "Report issue",
+    export: "Export",
+    exportMarkdown: "Markdown (.md)",
+    exportPdf: "PDF (.pdf)",
+    exportFailed: "Export failed: {message}",
+    exportMarkdownMissing: "Install @docx-editor.dev/docx-to-markdown and configure menu.exporters.markdown.",
+    exportPdfMissing: "Install @docx-editor.dev/docx-to-pdf on your Node.js server and configure menu.exporters.pdf.",
+    exportPdfServerUnavailable: "PDF export is unavailable. Configure a Node.js server with @docx-editor.dev/docx-to-pdf.",
+    exportingMarkdown: "Exporting Markdown…",
+    exportingPdf: "Exporting PDF…",
+    exportMarkdownFailed: "Markdown export failed",
+    exportPdfFailed: "PDF export failed",
+    exportDownloadHint: "Your download starts when the file is ready. You can continue editing while the export runs.",
+    exportContinueEditing: "Continue editing",
+    printPreparing: "Preparing to print…",
+    printOpenPdf: "Open PDF",
+    printFailed: "Print failed",
+    printFailedMessage: "Printing failed: {message}",
+    printLoadFailed: "The PDF did not load for printing. Select Open PDF, then print from the PDF viewer.",
+    printRefused: "The browser did not allow printing from the page. Select Open PDF, then print from the PDF viewer.",
+    printNoViewer: "This browser cannot print PDF files from the page. Select Open PDF, then print from the PDF viewer.",
+    printPdfMissing: "Printing uses PDF conversion. Install @docx-editor.dev/docx-to-pdf on your Node.js server and configure menu.exporters.pdf."
   },
   toc: {
     refresh: "Refresh table of contents",
     refreshPageNumbers: "Refresh page numbers"
   },
   formattingBar: {
+    label: "Formatting controls",
     groups: {
       history: "History",
       zoom: "Zoom",
@@ -427,6 +449,14 @@ var en_default = {
       single: "Single",
       double: "Double",
       auto: "Automatic"
+    },
+    structuralDetails: {
+      rowInsert: "Inserted table row",
+      rowDelete: "Deleted table row",
+      cellInsert: "Inserted table cell",
+      cellDelete: "Deleted table cell",
+      cellMerge: "Changed cell merge",
+      numberingInsert: "Inserted numbering reference"
     }
   },
   contextMenu: {
@@ -645,6 +675,8 @@ var en_default = {
     description: "Description"
   },
   editor: {
+    documentContent: "Document content",
+    documentViewport: "Document pages",
     showDocumentOutline: "Show document outline",
     linkCopied: "Link copied to clipboard",
     fontSubstitutionNotice: "Some fonts in this document aren't available, so substitutes are shown: {fonts}"
@@ -936,6 +968,44 @@ var en_default = {
     lowercase: "Lowercase",
     firstCapital: "First capital",
     titleCase: "Title case"
+  },
+  documentRefresh: {
+    title: "Server updates",
+    description: "Receive two sample updates while you read. Your scroll position stays in place.",
+    limitations: "Each update resets selection and undo history. Edits during processing prevent replacement.",
+    start: "Simulate server updates",
+    cancel: "Cancel updates",
+    reset: "Reset example",
+    show: "Highlight recent changes",
+    clear: "Clear highlights",
+    previous: "Previous change",
+    next: "Next change",
+    retry: "Restore document",
+    download: "Download recovery file",
+    empty: "No reliable change locations are available.",
+    count: "{count, plural, one {# recent change} other {# recent changes}}",
+    position: "Change {current} of {total}",
+    partial: "{count} processor operations failed. Successful changes remain applied.",
+    idle: "Ready for updates.",
+    capturing: "Preparing the document. Finish text composition to continue.",
+    processing: "Processing on the server. Edits made now prevent this update.",
+    refreshing: "Displaying the updated document.",
+    recovering: "Restoring your previous document.",
+    complete: "Document updated. Your scroll position stays in place.",
+    failed: "The update could not finish.",
+    loadError: "The example document could not load.",
+    localEdits: "Your edits are safe. Submit the document again to request an update.",
+    invalidDocument: "The returned file is invalid. Your document stays open.",
+    recoveryFailed: "Restore the document or download the recovery file.",
+    cancelled: "Updates cancelled.",
+    unavailable: "This change has no available location.",
+    delivery: "Delivery date",
+    review: "Review date",
+    sampleDescription: "The mock replaces this sample. Reset the example before each test.",
+    scrollToChange: "Scroll to the change after the update",
+    scrolled: "Document updated. Scrolled to the changed paragraph.",
+    processingLabel: "Processing",
+    sampleEdited: "Your edits stay in the document. Reset the sample to run this demo again."
   }
 };
 

package/dist/en.mjs

@@ -64,13 +64,35 @@ var en_default = {
     tableOfContents: "Table of contents",
     watermark: "Watermark",
     help: "Help",
-    reportIssue: "Report issue"
+    reportIssue: "Report issue",
+    export: "Export",
+    exportMarkdown: "Markdown (.md)",
+    exportPdf: "PDF (.pdf)",
+    exportFailed: "Export failed: {message}",
+    exportMarkdownMissing: "Install @docx-editor.dev/docx-to-markdown and configure menu.exporters.markdown.",
+    exportPdfMissing: "Install @docx-editor.dev/docx-to-pdf on your Node.js server and configure menu.exporters.pdf.",
+    exportPdfServerUnavailable: "PDF export is unavailable. Configure a Node.js server with @docx-editor.dev/docx-to-pdf.",
+    exportingMarkdown: "Exporting Markdown…",
+    exportingPdf: "Exporting PDF…",
+    exportMarkdownFailed: "Markdown export failed",
+    exportPdfFailed: "PDF export failed",
+    exportDownloadHint: "Your download starts when the file is ready. You can continue editing while the export runs.",
+    exportContinueEditing: "Continue editing",
+    printPreparing: "Preparing to print…",
+    printOpenPdf: "Open PDF",
+    printFailed: "Print failed",
+    printFailedMessage: "Printing failed: {message}",
+    printLoadFailed: "The PDF did not load for printing. Select Open PDF, then print from the PDF viewer.",
+    printRefused: "The browser did not allow printing from the page. Select Open PDF, then print from the PDF viewer.",
+    printNoViewer: "This browser cannot print PDF files from the page. Select Open PDF, then print from the PDF viewer.",
+    printPdfMissing: "Printing uses PDF conversion. Install @docx-editor.dev/docx-to-pdf on your Node.js server and configure menu.exporters.pdf."
   },
   toc: {
     refresh: "Refresh table of contents",
     refreshPageNumbers: "Refresh page numbers"
   },
   formattingBar: {
+    label: "Formatting controls",
     groups: {
       history: "History",
       zoom: "Zoom",
@@ -400,6 +422,14 @@ var en_default = {
       single: "Single",
       double: "Double",
       auto: "Automatic"
+    },
+    structuralDetails: {
+      rowInsert: "Inserted table row",
+      rowDelete: "Deleted table row",
+      cellInsert: "Inserted table cell",
+      cellDelete: "Deleted table cell",
+      cellMerge: "Changed cell merge",
+      numberingInsert: "Inserted numbering reference"
     }
   },
   contextMenu: {
@@ -618,6 +648,8 @@ var en_default = {
     description: "Description"
   },
   editor: {
+    documentContent: "Document content",
+    documentViewport: "Document pages",
     showDocumentOutline: "Show document outline",
     linkCopied: "Link copied to clipboard",
     fontSubstitutionNotice: "Some fonts in this document aren't available, so substitutes are shown: {fonts}"
@@ -909,6 +941,44 @@ var en_default = {
     lowercase: "Lowercase",
     firstCapital: "First capital",
     titleCase: "Title case"
+  },
+  documentRefresh: {
+    title: "Server updates",
+    description: "Receive two sample updates while you read. Your scroll position stays in place.",
+    limitations: "Each update resets selection and undo history. Edits during processing prevent replacement.",
+    start: "Simulate server updates",
+    cancel: "Cancel updates",
+    reset: "Reset example",
+    show: "Highlight recent changes",
+    clear: "Clear highlights",
+    previous: "Previous change",
+    next: "Next change",
+    retry: "Restore document",
+    download: "Download recovery file",
+    empty: "No reliable change locations are available.",
+    count: "{count, plural, one {# recent change} other {# recent changes}}",
+    position: "Change {current} of {total}",
+    partial: "{count} processor operations failed. Successful changes remain applied.",
+    idle: "Ready for updates.",
+    capturing: "Preparing the document. Finish text composition to continue.",
+    processing: "Processing on the server. Edits made now prevent this update.",
+    refreshing: "Displaying the updated document.",
+    recovering: "Restoring your previous document.",
+    complete: "Document updated. Your scroll position stays in place.",
+    failed: "The update could not finish.",
+    loadError: "The example document could not load.",
+    localEdits: "Your edits are safe. Submit the document again to request an update.",
+    invalidDocument: "The returned file is invalid. Your document stays open.",
+    recoveryFailed: "Restore the document or download the recovery file.",
+    cancelled: "Updates cancelled.",
+    unavailable: "This change has no available location.",
+    delivery: "Delivery date",
+    review: "Review date",
+    sampleDescription: "The mock replaces this sample. Reset the example before each test.",
+    scrollToChange: "Scroll to the change after the update",
+    scrolled: "Document updated. Scrolled to the changed paragraph.",
+    processingLabel: "Processing",
+    sampleEdited: "Your edits stay in the document. Reset the sample to run this demo again."
   }
 };
 

package/dist/fr.js

@@ -62,7 +62,28 @@ var fr_default = {
     insertFootnote: "Insérer une note de bas de page",
     insertEndnote: "Insérer une note de fin",
     insertTable: null,
-    review: null
+    review: null,
+    export: null,
+    exportFailed: null,
+    exportMarkdown: null,
+    exportMarkdownMissing: null,
+    exportPdf: null,
+    exportPdfMissing: null,
+    exportPdfServerUnavailable: null,
+    exportContinueEditing: null,
+    exportDownloadHint: null,
+    exportMarkdownFailed: null,
+    exportPdfFailed: null,
+    exportingMarkdown: null,
+    exportingPdf: null,
+    printFailed: null,
+    printFailedMessage: null,
+    printOpenPdf: null,
+    printPdfMissing: null,
+    printPreparing: null,
+    printNoViewer: null,
+    printLoadFailed: null,
+    printRefused: null
   },
   formattingBar: {
     groups: {
@@ -107,7 +128,8 @@ var fr_default = {
     imageWrap: "Habillage du texte",
     formatPainter: null,
     formatPainterShortcut: null,
-    paragraphMarks: null
+    paragraphMarks: null,
+    label: null
   },
   alignment: {
     alignLeft: "Aligner à gauche",
@@ -500,7 +522,9 @@ var fr_default = {
   editor: {
     showDocumentOutline: "Afficher le plan",
     linkCopied: "Lien copié dans le presse-papiers",
-    fontSubstitutionNotice: "Certaines polices de ce document ne sont pas disponibles ; des polices de substitution sont affichées : {fonts}"
+    fontSubstitutionNotice: "Certaines polices de ce document ne sont pas disponibles ; des polices de substitution sont affichées : {fonts}",
+    documentContent: null,
+    documentViewport: null
   },
   hyperlinkPopup: {
     displayTextPlaceholder: "Texte à afficher",
@@ -620,6 +644,14 @@ var fr_default = {
       start: null,
       strike: null,
       underline: null
+    },
+    structuralDetails: {
+      cellDelete: null,
+      cellInsert: null,
+      cellMerge: null,
+      numberingInsert: null,
+      rowDelete: null,
+      rowInsert: null
     }
   },
   toc: {
@@ -936,6 +968,44 @@ var fr_default = {
     lowercase: null,
     firstCapital: null,
     titleCase: null
+  },
+  documentRefresh: {
+    cancel: null,
+    cancelled: null,
+    capturing: null,
+    clear: null,
+    complete: null,
+    count: null,
+    delivery: null,
+    description: null,
+    download: null,
+    empty: null,
+    failed: null,
+    idle: null,
+    invalidDocument: null,
+    limitations: null,
+    loadError: null,
+    localEdits: null,
+    next: null,
+    partial: null,
+    position: null,
+    previous: null,
+    processing: null,
+    recovering: null,
+    recoveryFailed: null,
+    refreshing: null,
+    reset: null,
+    retry: null,
+    review: null,
+    show: null,
+    start: null,
+    title: null,
+    unavailable: null,
+    sampleDescription: null,
+    scrollToChange: null,
+    scrolled: null,
+    processingLabel: null,
+    sampleEdited: null
   }
 };