nuvra 0.3.0 → 0.4.0

package/README.md

@@ -97,6 +97,7 @@ const uploadImage: DocumentImageUploadHandler = async file => {
 | `defaultViewMode` | `'page' \| 'web'`                 | `'page'` | View shown first.                                                          |
 | `disabled`        | `boolean`                         | `false`  | Read-only document, disabled controls.                                     |
 | `height`          | `number \| string`                | `760`    | Height of the editor, or `'auto'` to grow between `minHeight`/`maxHeight`. |
+| `locale`          | `EditorLocale \| 'uz' \| 'en' \| 'ru'` | —   | Interface language; defaults to the app-wide language (Uzbek).             |
 | `minHeight`       | `number \| string`                | `240`    | Smallest height of an auto-height editor.                                  |
 | `maxHeight`       | `number \| string`                | `600`    | Largest height of an auto-height editor.                                   |
 | `maxImageSizeMb`  | `number`                          | `10`     | Largest accepted image file.                                               |
@@ -136,34 +137,35 @@ redo · `Ctrl/⌘+F` — find · `Ctrl/⌘+H` — replace · `Ctrl/⌘+K` — li
 The full list, with Markdown-like input rules, is in the
 [keyboard shortcuts guide](https://nuvra-docs.vercel.app/docs/keyboard-shortcuts).
 
-## Translations
+## Languages
 
-Built-in labels are in Uzbek. Every label has a key such as `editor.bold`; the full list with default texts is
-exported as `editorMessages`. Register a translator once, before the app mounts. Returning `undefined` keeps the
-built-in text for that key.
+The interface ships in Uzbek (`uz`, the default), English (`en`) and Russian (`ru`). The translations are part of
+the package and cannot be changed from outside; an app only picks the language.
 
-```ts
-import { setEditorTranslator } from 'nuvra';
+For one editor, pass the locale (or just its code) to the `locale` prop:
 
-const en: Record<string, string> = {
-  'editor.bold': 'Bold',
-  'editor.status.words': '{count} words'
-};
+```vue
+<script setup lang="ts">
+import { DocumentEditor, ru } from 'nuvra';
+</script>
 
-setEditorTranslator((key, named) =>
-  en[key]?.replace(/\{(\w+)\}/g, (_, name) => String(named?.[name] ?? ''))
-);
+<template>
+  <DocumentEditor v-model="html" :locale="ru" />
+</template>
 ```
 
-With `vue-i18n`, labels follow the active locale:
+For the whole app, call `setEditorLocale` once, for example in `main.ts`. It is reactive, so calling it again from a
+language switcher updates editors already on the page:
 
 ```ts
-import { setEditorTranslator } from 'nuvra';
-import { i18n } from './i18n';
+import { en, setEditorLocale } from 'nuvra';
 
-setEditorTranslator((key, named) => (i18n.global.te(key) ? i18n.global.t(key, named ?? {}) : undefined));
+setEditorLocale(en);
 ```
 
+The `locale` prop wins over `setEditorLocale`; without either the editor is in Uzbek. `editorLocales` lists every
+built-in locale with its name, for language pickers.
+
 ## Theming
 
 Colors come from CSS variables declared on `.document-editor` with zero specificity, so any rule that targets

package/dist/components/document-editor.vue.d.ts

@@ -1,4 +1,5 @@
 import { DocumentEngine } from '../core/engine/engine';
+import { type EditorLocaleInput } from '../core/labels';
 import { type DocumentViewMode, type PageSettings } from '../core/page';
 import type { DocumentImageUploadHandler } from '../core/types';
 import '../styles/document-content.css';
@@ -16,6 +17,8 @@ interface Props {
     disabled?: boolean;
     /** Height of the whole editor, or `'auto'` to grow with the content between `minHeight` and `maxHeight`. */
     height?: CssSize;
+    /** Interface language: a built-in locale (`uz`, `en`, `ru`) or its code; defaults to the app-wide language. */
+    locale?: EditorLocaleInput;
     /** Largest height of an auto-height editor; longer documents scroll inside it. */
     maxHeight?: CssSize;
     /** Largest accepted image file, in megabytes. */
@@ -78,6 +81,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
     autofocus: boolean;
     canvasPadding: CssSize;
     defaultViewMode: DocumentViewMode;
+    locale: EditorLocaleInput;
     maxImageSizeMb: number;
     uploadImage: DocumentImageUploadHandler;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/core/labels.d.ts

@@ -1,192 +1,38 @@
-/** Built-in Uzbek texts, used for every key the registered translator does not translate. */
-declare const MESSAGES: {
-    readonly 'editor.align': "Tekislash";
-    readonly 'editor.align.center': "Markazga";
-    readonly 'editor.align.justify': "Ikki tomonga";
-    readonly 'editor.align.left': "Chapga";
-    readonly 'editor.align.right': "O‘ngga";
-    readonly 'editor.apply': "Qo‘llash";
-    readonly 'editor.bold': "Qalin";
-    readonly 'editor.bulletList': "Belgili ro‘yxat";
-    readonly 'editor.case.lower': "kichik harflar";
-    readonly 'editor.case.sentence': "Gap boshi bosh harf";
-    readonly 'editor.case.title': "Har So‘z Bosh Harf";
-    readonly 'editor.case.toggle': "rEGISTRNI ALMASHTIRISH";
-    readonly 'editor.case.upper': "BOSH HARFLAR";
-    readonly 'editor.changeCase': "Harf registri";
-    readonly 'editor.clearFormatting': "Formatni tozalash";
-    readonly 'editor.close': "Yopish";
-    readonly 'editor.codeBlock': "Kod bloki";
-    readonly 'editor.colors.automatic': "Avtomatik";
-    readonly 'editor.colors.custom': "Boshqa rang…";
-    readonly 'editor.colors.none': "Rangsiz";
-    readonly 'editor.copy': "Nusxalash";
-    readonly 'editor.cut': "Kesish";
-    readonly 'editor.defaultFont': "Standart shrift";
-    readonly 'editor.defaultLineHeight': "Standart";
-    readonly 'editor.decreaseFontSize': "Shriftni kichraytirish";
-    readonly 'editor.defaultSize': "Standart o‘lcham";
-    readonly 'editor.delete': "O‘chirish";
-    readonly 'editor.direction.auto': "Avtomatik yo‘nalish";
-    readonly 'editor.direction.ltr': "Chapdan o‘ngga";
-    readonly 'editor.direction.rtl': "O‘ngdan chapga";
-    readonly 'editor.document': "Hujjat";
-    readonly 'editor.editLink': "Havolani tahrirlash";
-    readonly 'editor.enterFullscreen': "To‘liq ekran";
-    readonly 'editor.exitFullscreen': "To‘liq ekrandan chiqish";
-    readonly 'editor.exportHtml': "HTML sifatida yuklab olish";
-    readonly 'editor.exportWord': "Word (.doc) sifatida yuklab olish";
-    readonly 'editor.fitWidth': "Kenglikka moslash";
-    readonly 'editor.fontFamily': "Shrift";
-    readonly 'editor.fontSize': "Shrift o‘lchami";
-    readonly 'editor.footer': "Pastki kolontitul";
-    readonly 'editor.formatPainter': "Format bo‘yoqchasi";
-    readonly 'editor.formattingMarks': "Formatlash belgilari";
-    readonly 'editor.header': "Yuqori kolontitul";
-    readonly 'editor.headerFooter': "Kolontitullar";
-    readonly 'editor.headerFooter.center': "Markaz";
-    readonly 'editor.headerFooter.clear': "Tozalash";
-    readonly 'editor.headerFooter.hint': "Matn har bir sahifada takrorlanadi.";
-    readonly 'editor.headerFooter.left': "Chap";
-    readonly 'editor.headerFooter.right': "O‘ng";
-    readonly 'editor.headerFooter.token.date': "Sana";
-    readonly 'editor.headerFooter.token.page': "Sahifa raqami";
-    readonly 'editor.headerFooter.token.pages': "Sahifalar soni";
-    readonly 'editor.headerFooter.token.title': "Hujjat nomi";
-    readonly 'editor.headerFooter.tokens': "Qo‘shish:";
-    readonly 'editor.heading': "Sarlavha {level}";
-    readonly 'editor.highlight': "Belgilash rangi";
-    readonly 'editor.horizontalRule': "Gorizontal chiziq";
-    readonly 'editor.image': "Rasm";
-    readonly 'editor.imageAlt': "Muqobil matn (alt)";
-    readonly 'editor.imageReadError': "Rasmni o‘qib bo‘lmadi";
-    readonly 'editor.imageSizeError': "Rasm hajmi {size} MB dan oshmasligi kerak";
-    readonly 'editor.imageTypeError': "Faqat rasm fayllarini qo‘shish mumkin";
-    readonly 'editor.imageUploadError': "Rasmni yuklab bo‘lmadi";
-    readonly 'editor.increaseFontSize': "Shriftni kattalashtirish";
-    readonly 'editor.indent': "Chekinishni oshirish";
-    readonly 'editor.inlineCode': "Kod";
-    readonly 'editor.insert': "Qo‘shish";
-    readonly 'editor.insertDate': "Bugungi sana";
-    readonly 'editor.insertMore': "Boshqa elementlar";
-    readonly 'editor.italic': "Kursiv";
-    readonly 'editor.lineHeight': "Qator oralig‘i";
-    readonly 'editor.link': "Havola";
-    readonly 'editor.linkNewTab': "Yangi oynada ochish";
-    readonly 'editor.linkText': "Matn";
-    readonly 'editor.linkUrl': "Manzil (URL)";
-    readonly 'editor.more': "Yana";
-    readonly 'editor.moreFormatting': "Boshqa formatlar";
-    readonly 'editor.openLink': "Havolani ochish";
-    readonly 'editor.or': "yoki havola orqali";
-    readonly 'editor.orderedList': "Raqamli ro‘yxat";
-    readonly 'editor.outdent': "Chekinishni kamaytirish";
-    readonly 'editor.page.customMargins': "Aniq qiymatlar (mm)";
-    readonly 'editor.page.landscape': "Albom";
-    readonly 'editor.page.marginBottom': "Pastki";
-    readonly 'editor.page.marginLeft': "Chap";
-    readonly 'editor.page.marginRight': "O‘ng";
-    readonly 'editor.page.marginTop': "Yuqori";
-    readonly 'editor.page.margins': "Hoshiyalar";
-    readonly 'editor.page.margins.moderate': "O‘rtacha";
-    readonly 'editor.page.margins.narrow': "Tor";
-    readonly 'editor.page.margins.normal': "Oddiy";
-    readonly 'editor.page.margins.official': "Rasmiy hujjat";
-    readonly 'editor.page.margins.wide': "Keng";
-    readonly 'editor.page.orientation': "Yo‘nalish";
-    readonly 'editor.page.portrait': "Kitob";
-    readonly 'editor.page.setup': "Sahifa sozlamalari";
-    readonly 'editor.page.watermark': "Suv belgisi";
-    readonly 'editor.page.watermarkColor': "Rangi";
-    readonly 'editor.page.watermarkDiagonal': "Qiya";
-    readonly 'editor.page.watermarkText': "Matn, masalan NUSXA";
-    readonly 'editor.page.size': "Qog‘oz o‘lchami";
-    readonly 'editor.pageBreak': "Sahifa uzilishi";
-    readonly 'editor.paragraph': "Oddiy matn";
-    readonly 'editor.paste': "Joylashtirish";
-    readonly 'editor.placeholder': "Hujjat matnini kiriting…";
-    readonly 'editor.print': "Chop etish / PDF";
-    readonly 'editor.quote': "Iqtibos";
-    readonly 'editor.redo': "Qaytarish";
-    readonly 'editor.replace.all': "Barchasini";
-    readonly 'editor.replace.one': "Almashtirish";
-    readonly 'editor.replace.placeholder': "Almashtirish";
-    readonly 'editor.replace.toggle': "Almashtirishni ko‘rsatish";
-    readonly 'editor.ruler': "Chizg‘ich";
-    readonly 'editor.ruler.firstLine': "Birinchi qator chekinishi";
-    readonly 'editor.ruler.indentLeft': "Chap chekinish";
-    readonly 'editor.ruler.indentRight': "O‘ng chekinish";
-    readonly 'editor.ruler.marginLeft': "Chap hoshiya";
-    readonly 'editor.ruler.marginRight': "O‘ng hoshiya";
-    readonly 'editor.search.caseSensitive': "Katta-kichik harfni farqlash";
-    readonly 'editor.search.next': "Keyingisi";
-    readonly 'editor.search.placeholder': "Qidirish";
-    readonly 'editor.search.previous': "Oldingisi";
-    readonly 'editor.search.title': "Qidirish va almashtirish";
-    readonly 'editor.search.wholeWord': "Butun so‘z";
-    readonly 'editor.selectAll': "Barchasini tanlash";
-    readonly 'editor.source': "HTML kod";
-    readonly 'editor.spacing.addAfter': "Keyin bo‘sh joy qo‘shish";
-    readonly 'editor.spacing.addBefore': "Oldin bo‘sh joy qo‘shish";
-    readonly 'editor.spacing.removeAfter': "Keyingi bo‘sh joyni olib tashlash";
-    readonly 'editor.spacing.removeBefore': "Oldingi bo‘sh joyni olib tashlash";
-    readonly 'editor.specialCharacters': "Maxsus belgilar";
-    readonly 'editor.status.characters': "{count} belgi";
-    readonly 'editor.status.page': "Sahifa {current} / {total}";
-    readonly 'editor.status.words': "{count} so‘z";
-    readonly 'editor.strike': "Ustidan chizilgan";
-    readonly 'editor.subscript': "Pastki indeks";
-    readonly 'editor.superscript': "Yuqori indeks";
-    readonly 'editor.table.addColumnAfter': "O‘ngga ustun qo‘shish";
-    readonly 'editor.table.addColumnBefore': "Chapga ustun qo‘shish";
-    readonly 'editor.table.addRowAfter': "Pastga qator qo‘shish";
-    readonly 'editor.table.addRowBefore': "Yuqoriga qator qo‘shish";
-    readonly 'editor.table.delete': "Jadvalni o‘chirish";
-    readonly 'editor.table.deleteColumn': "Ustunni o‘chirish";
-    readonly 'editor.table.deleteRow': "Qatorni o‘chirish";
-    readonly 'editor.table.headerRow': "Sarlavha qatori";
-    readonly 'editor.table.insert': "Jadval qo‘shish";
-    readonly 'editor.table.mergeCells': "Kataklarni birlashtirish";
-    readonly 'editor.table.pickSize': "O‘lchamni tanlang";
-    readonly 'editor.table.splitCell': "Katakni ajratish";
-    readonly 'editor.table.title': "Jadval";
-    readonly 'editor.taskList': "Vazifalar ro‘yxati";
-    readonly 'editor.textColor': "Matn rangi";
-    readonly 'editor.textDirection': "Matn yo‘nalishi";
-    readonly 'editor.textStyle': "Matn uslubi";
-    readonly 'editor.toolbar': "Muharrir asboblari";
-    readonly 'editor.underline': "Tagiga chizilgan";
-    readonly 'editor.undo': "Bekor qilish";
-    readonly 'editor.unlink': "Havolani olib tashlash";
-    readonly 'editor.uploadImage': "Kompyuterdan yuklash";
-    readonly 'editor.uploading': "Rasm yuklanmoqda…";
-    readonly 'editor.view.page': "Sahifa ko‘rinishi";
-    readonly 'editor.view.web': "Veb ko‘rinish";
-    readonly 'editor.zoom': "Masshtab";
-    readonly 'editor.zoomIn': "Kattalashtirish";
-    readonly 'editor.zoomOut': "Kichraytirish";
-    readonly 'editor.zoomReset': "100% ga qaytarish";
-};
-/** Every label key the editor uses. */
-export type EditorLabelKey = keyof typeof MESSAGES;
-/** Built-in label texts by key; `{name}` marks a placeholder filled in at translation time. */
-export declare const editorMessages: Readonly<Record<EditorLabelKey, string>>;
+import { type EditorLabelKey } from './locales/uz';
+export type { EditorLabelKey };
+/** Languages the editor interface is available in. */
+export type EditorLocaleCode = 'uz' | 'en' | 'ru';
 /**
- * Translates an editor label into the app's language; returning `undefined` keeps the built-in text.
- *
- * @param named Values for `{name}` placeholders in the message.
+ * A built-in interface language. Locales only select one of the translations shipped with the editor; the texts
+ * themselves cannot be changed from outside.
  */
-export type EditorTranslator = (key: EditorLabelKey, named?: Record<string, unknown>) => string | undefined;
-/** Registers the translator used for every editor label; calling it without arguments restores the built-in texts. */
-export declare const setEditorTranslator: (next?: EditorTranslator) => void;
+export interface EditorLocale {
+    /** Language code. */
+    readonly code: EditorLocaleCode;
+    /** Name of the language in that language, for language pickers. */
+    readonly name: string;
+}
+/** A locale object, or just its code. */
+export type EditorLocaleInput = EditorLocale | EditorLocaleCode;
+/** Uzbek (Latin) interface. */
+export declare const uzLocale: EditorLocale;
+/** English interface. */
+export declare const enLocale: EditorLocale;
+/** Russian interface. */
+export declare const ruLocale: EditorLocale;
+/** Every built-in locale, in the order they are offered. */
+export declare const editorLocales: ReadonlyArray<EditorLocale>;
+/** Sets the interface language of every editor that does not choose its own with the `locale` prop. */
+export declare const setEditorLocale: (locale: EditorLocaleInput) => void;
+/** Formats a shortcut written as `Mod+Shift+K` for the current platform (`Ctrl+Shift+K` or `⌘⇧K`). */
+export declare const formatShortcut: (shortcut: string) => string;
 /**
- * Translates an editor label, falling back to the built-in Uzbek text while the key has no translation.
+ * Label helpers in the editor's language. The root editor passes its `locale` prop and shares the result with its
+ * children; child components call it without arguments. Must be called during component setup.
  *
- * @param named Values for `{name}` placeholders in the message.
+ * @param locale Getter for the language chosen by this component; `undefined` inherits it.
  */
-export declare const t: (key: EditorLabelKey, named?: Record<string, unknown>) => string;
-/** Formats a shortcut written as `Mod+Shift+K` for the current platform (`Ctrl+Shift+K` or `⌘⇧K`). */
-export declare const formatShortcut: (shortcut: string) => string;
-/** Label followed by its keyboard shortcut in parentheses, for button tooltips. */
-export declare const withShortcut: (key: EditorLabelKey, shortcut: string) => string;
-export {};
+export declare const useEditorLabels: (locale?: () => EditorLocaleInput | undefined) => {
+    t: (key: EditorLabelKey, named?: Record<string, unknown>) => string;
+    withShortcut: (key: EditorLabelKey, shortcut: string) => string;
+};

package/dist/core/locales/en.d.ts

@@ -0,0 +1,3 @@
+import type { EditorLabelKey } from './uz';
+/** English texts of the editor interface. */
+export declare const en: Readonly<Record<EditorLabelKey, string>>;

package/dist/core/locales/ru.d.ts

@@ -0,0 +1,3 @@
+import type { EditorLabelKey } from './uz';
+/** Russian texts of the editor interface. */
+export declare const ru: Readonly<Record<EditorLabelKey, string>>;

package/dist/core/locales/uz.d.ts

@@ -0,0 +1,171 @@
+/** Uzbek (Latin) texts of the editor interface; `{name}` marks a placeholder filled in at translation time. */
+export declare const uz: {
+    readonly 'editor.align': "Tekislash";
+    readonly 'editor.align.center': "Markazga";
+    readonly 'editor.align.justify': "Ikki tomonga";
+    readonly 'editor.align.left': "Chapga";
+    readonly 'editor.align.right': "O‘ngga";
+    readonly 'editor.apply': "Qo‘llash";
+    readonly 'editor.bold': "Qalin";
+    readonly 'editor.bulletList': "Belgili ro‘yxat";
+    readonly 'editor.case.lower': "kichik harflar";
+    readonly 'editor.case.sentence': "Gap boshi bosh harf";
+    readonly 'editor.case.title': "Har So‘z Bosh Harf";
+    readonly 'editor.case.toggle': "rEGISTRNI ALMASHTIRISH";
+    readonly 'editor.case.upper': "BOSH HARFLAR";
+    readonly 'editor.changeCase': "Harf registri";
+    readonly 'editor.clearFormatting': "Formatni tozalash";
+    readonly 'editor.close': "Yopish";
+    readonly 'editor.codeBlock': "Kod bloki";
+    readonly 'editor.colors.automatic': "Avtomatik";
+    readonly 'editor.colors.custom': "Boshqa rang…";
+    readonly 'editor.colors.none': "Rangsiz";
+    readonly 'editor.copy': "Nusxalash";
+    readonly 'editor.cut': "Kesish";
+    readonly 'editor.defaultFont': "Standart shrift";
+    readonly 'editor.defaultLineHeight': "Standart";
+    readonly 'editor.decreaseFontSize': "Shriftni kichraytirish";
+    readonly 'editor.defaultSize': "Standart o‘lcham";
+    readonly 'editor.delete': "O‘chirish";
+    readonly 'editor.direction.auto': "Avtomatik yo‘nalish";
+    readonly 'editor.direction.ltr': "Chapdan o‘ngga";
+    readonly 'editor.direction.rtl': "O‘ngdan chapga";
+    readonly 'editor.document': "Hujjat";
+    readonly 'editor.editLink': "Havolani tahrirlash";
+    readonly 'editor.enterFullscreen': "To‘liq ekran";
+    readonly 'editor.exitFullscreen': "To‘liq ekrandan chiqish";
+    readonly 'editor.exportHtml': "HTML sifatida yuklab olish";
+    readonly 'editor.exportWord': "Word (.doc) sifatida yuklab olish";
+    readonly 'editor.fitWidth': "Kenglikka moslash";
+    readonly 'editor.fontFamily': "Shrift";
+    readonly 'editor.fontSize': "Shrift o‘lchami";
+    readonly 'editor.footer': "Pastki kolontitul";
+    readonly 'editor.formatPainter': "Format bo‘yoqchasi";
+    readonly 'editor.formattingMarks': "Formatlash belgilari";
+    readonly 'editor.header': "Yuqori kolontitul";
+    readonly 'editor.headerFooter': "Kolontitullar";
+    readonly 'editor.headerFooter.center': "Markaz";
+    readonly 'editor.headerFooter.clear': "Tozalash";
+    readonly 'editor.headerFooter.hint': "Matn har bir sahifada takrorlanadi.";
+    readonly 'editor.headerFooter.left': "Chap";
+    readonly 'editor.headerFooter.right': "O‘ng";
+    readonly 'editor.headerFooter.token.date': "Sana";
+    readonly 'editor.headerFooter.token.page': "Sahifa raqami";
+    readonly 'editor.headerFooter.token.pages': "Sahifalar soni";
+    readonly 'editor.headerFooter.token.title': "Hujjat nomi";
+    readonly 'editor.headerFooter.tokens': "Qo‘shish:";
+    readonly 'editor.heading': "Sarlavha {level}";
+    readonly 'editor.highlight': "Belgilash rangi";
+    readonly 'editor.horizontalRule': "Gorizontal chiziq";
+    readonly 'editor.image': "Rasm";
+    readonly 'editor.imageAlt': "Muqobil matn (alt)";
+    readonly 'editor.imageReadError': "Rasmni o‘qib bo‘lmadi";
+    readonly 'editor.imageSizeError': "Rasm hajmi {size} MB dan oshmasligi kerak";
+    readonly 'editor.imageTypeError': "Faqat rasm fayllarini qo‘shish mumkin";
+    readonly 'editor.imageUploadError': "Rasmni yuklab bo‘lmadi";
+    readonly 'editor.increaseFontSize': "Shriftni kattalashtirish";
+    readonly 'editor.indent': "Chekinishni oshirish";
+    readonly 'editor.inlineCode': "Kod";
+    readonly 'editor.insert': "Qo‘shish";
+    readonly 'editor.insertDate': "Bugungi sana";
+    readonly 'editor.insertMore': "Boshqa elementlar";
+    readonly 'editor.italic': "Kursiv";
+    readonly 'editor.lineHeight': "Qator oralig‘i";
+    readonly 'editor.link': "Havola";
+    readonly 'editor.linkNewTab': "Yangi oynada ochish";
+    readonly 'editor.linkText': "Matn";
+    readonly 'editor.linkUrl': "Manzil (URL)";
+    readonly 'editor.more': "Yana";
+    readonly 'editor.moreFormatting': "Boshqa formatlar";
+    readonly 'editor.openLink': "Havolani ochish";
+    readonly 'editor.or': "yoki havola orqali";
+    readonly 'editor.orderedList': "Raqamli ro‘yxat";
+    readonly 'editor.outdent': "Chekinishni kamaytirish";
+    readonly 'editor.page.customMargins': "Aniq qiymatlar (mm)";
+    readonly 'editor.page.landscape': "Albom";
+    readonly 'editor.page.marginBottom': "Pastki";
+    readonly 'editor.page.marginLeft': "Chap";
+    readonly 'editor.page.marginRight': "O‘ng";
+    readonly 'editor.page.marginTop': "Yuqori";
+    readonly 'editor.page.margins': "Hoshiyalar";
+    readonly 'editor.page.margins.moderate': "O‘rtacha";
+    readonly 'editor.page.margins.narrow': "Tor";
+    readonly 'editor.page.margins.normal': "Oddiy";
+    readonly 'editor.page.margins.official': "Rasmiy hujjat";
+    readonly 'editor.page.margins.wide': "Keng";
+    readonly 'editor.page.orientation': "Yo‘nalish";
+    readonly 'editor.page.portrait': "Kitob";
+    readonly 'editor.page.setup': "Sahifa sozlamalari";
+    readonly 'editor.page.watermark': "Suv belgisi";
+    readonly 'editor.page.watermarkColor': "Rangi";
+    readonly 'editor.page.watermarkDiagonal': "Qiya";
+    readonly 'editor.page.watermarkText': "Matn, masalan NUSXA";
+    readonly 'editor.page.size': "Qog‘oz o‘lchami";
+    readonly 'editor.pageBreak': "Sahifa uzilishi";
+    readonly 'editor.paragraph': "Oddiy matn";
+    readonly 'editor.paste': "Joylashtirish";
+    readonly 'editor.placeholder': "Hujjat matnini kiriting…";
+    readonly 'editor.print': "Chop etish / PDF";
+    readonly 'editor.quote': "Iqtibos";
+    readonly 'editor.redo': "Qaytarish";
+    readonly 'editor.replace.all': "Barchasini";
+    readonly 'editor.replace.one': "Almashtirish";
+    readonly 'editor.replace.placeholder': "Almashtirish";
+    readonly 'editor.replace.toggle': "Almashtirishni ko‘rsatish";
+    readonly 'editor.ruler': "Chizg‘ich";
+    readonly 'editor.ruler.firstLine': "Birinchi qator chekinishi";
+    readonly 'editor.ruler.indentLeft': "Chap chekinish";
+    readonly 'editor.ruler.indentRight': "O‘ng chekinish";
+    readonly 'editor.ruler.marginLeft': "Chap hoshiya";
+    readonly 'editor.ruler.marginRight': "O‘ng hoshiya";
+    readonly 'editor.search.caseSensitive': "Katta-kichik harfni farqlash";
+    readonly 'editor.search.next': "Keyingisi";
+    readonly 'editor.search.placeholder': "Qidirish";
+    readonly 'editor.search.previous': "Oldingisi";
+    readonly 'editor.search.title': "Qidirish va almashtirish";
+    readonly 'editor.search.wholeWord': "Butun so‘z";
+    readonly 'editor.selectAll': "Barchasini tanlash";
+    readonly 'editor.source': "HTML kod";
+    readonly 'editor.spacing.addAfter': "Keyin bo‘sh joy qo‘shish";
+    readonly 'editor.spacing.addBefore': "Oldin bo‘sh joy qo‘shish";
+    readonly 'editor.spacing.removeAfter': "Keyingi bo‘sh joyni olib tashlash";
+    readonly 'editor.spacing.removeBefore': "Oldingi bo‘sh joyni olib tashlash";
+    readonly 'editor.specialCharacters': "Maxsus belgilar";
+    readonly 'editor.status.characters': "{count} belgi";
+    readonly 'editor.status.page': "Sahifa {current} / {total}";
+    readonly 'editor.status.words': "{count} so‘z";
+    readonly 'editor.strike': "Ustidan chizilgan";
+    readonly 'editor.subscript': "Pastki indeks";
+    readonly 'editor.superscript': "Yuqori indeks";
+    readonly 'editor.table.addColumnAfter': "O‘ngga ustun qo‘shish";
+    readonly 'editor.table.addColumnBefore': "Chapga ustun qo‘shish";
+    readonly 'editor.table.addRowAfter': "Pastga qator qo‘shish";
+    readonly 'editor.table.addRowBefore': "Yuqoriga qator qo‘shish";
+    readonly 'editor.table.delete': "Jadvalni o‘chirish";
+    readonly 'editor.table.deleteColumn': "Ustunni o‘chirish";
+    readonly 'editor.table.deleteRow': "Qatorni o‘chirish";
+    readonly 'editor.table.headerRow': "Sarlavha qatori";
+    readonly 'editor.table.insert': "Jadval qo‘shish";
+    readonly 'editor.table.mergeCells': "Kataklarni birlashtirish";
+    readonly 'editor.table.pickSize': "O‘lchamni tanlang";
+    readonly 'editor.table.splitCell': "Katakni ajratish";
+    readonly 'editor.table.title': "Jadval";
+    readonly 'editor.taskList': "Vazifalar ro‘yxati";
+    readonly 'editor.textColor': "Matn rangi";
+    readonly 'editor.textDirection': "Matn yo‘nalishi";
+    readonly 'editor.textStyle': "Matn uslubi";
+    readonly 'editor.toolbar': "Muharrir asboblari";
+    readonly 'editor.underline': "Tagiga chizilgan";
+    readonly 'editor.undo': "Bekor qilish";
+    readonly 'editor.unlink': "Havolani olib tashlash";
+    readonly 'editor.uploadImage': "Kompyuterdan yuklash";
+    readonly 'editor.uploading': "Rasm yuklanmoqda…";
+    readonly 'editor.view.page': "Sahifa ko‘rinishi";
+    readonly 'editor.view.web': "Veb ko‘rinish";
+    readonly 'editor.zoom': "Masshtab";
+    readonly 'editor.zoomIn': "Kattalashtirish";
+    readonly 'editor.zoomOut': "Kichraytirish";
+    readonly 'editor.zoomReset': "100% ga qaytarish";
+};
+/** Every label key the editor uses; the Uzbek texts are the reference set. */
+export type EditorLabelKey = keyof typeof uz;

package/dist/editor.vue.d.ts

@@ -1,3 +1,4 @@
+import type { EditorLocaleInput } from './core/labels';
 import type { DocumentImageUploadHandler } from './core/types';
 interface Props {
     /** Places the caret at the end of the content once the editor is ready. */
@@ -6,6 +7,8 @@ interface Props {
     canvasPadding?: number | string;
     /** Makes the content read-only and disables the toolbar. */
     disabled?: boolean;
+    /** Interface language: a built-in locale (`uz`, `en`, `ru`) or its code; defaults to the app-wide language. */
+    locale?: EditorLocaleInput;
     /** Height at which the field stops growing and starts scrolling. */
     maxHeight?: number | string;
     /** Largest accepted image file, in megabytes. */
@@ -43,6 +46,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
     maxHeight: number | string;
     autofocus: boolean;
     canvasPadding: number | string;
+    locale: EditorLocaleInput;
     maxImageSizeMb: number;
     uploadImage: DocumentImageUploadHandler;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 /**
  * Public API of the document editor: the editor itself, its form-field wrapper (`Editor`), page settings, the image
- * upload contract, and label translation.
+ * upload contract, and the built-in interface languages.
  */
 export { default as DocumentEditor } from './components/document-editor.vue';
-export type { EditorLabelKey, EditorTranslator } from './core/labels';
-export { editorMessages, setEditorTranslator } from './core/labels';
+export type { EditorLocale, EditorLocaleCode, EditorLocaleInput } from './core/labels';
+export { editorLocales, enLocale as en, ruLocale as ru, setEditorLocale, uzLocale as uz } from './core/labels';
 export type { DocumentViewMode, PageHeaderFooter, PageMargins, PageOrientation, PageSettings, PageSizeKey, PageWatermark } from './core/page';
 export { createHeaderFooter, createPageSettings, createWatermark } from './core/page';
 export type { DocumentImageUploadHandler } from './core/types';