nuvra 0.2.1 → 0.4.0

package/dist/core/engine/blocks.d.ts

@@ -23,6 +23,31 @@ export declare const setTextAlign: (root: HTMLElement, range: Range, align: Text
 export declare const setLineHeight: (root: HTMLElement, range: Range, lineHeight: string | null) => void;
 /** Sets the writing direction of the selected blocks; `auto` lets each paragraph follow its own text. */
 export declare const setTextDirection: (root: HTMLElement, range: Range, direction: TextDirection) => void;
+/** Side of a paragraph that can keep extra space, as in the paragraph settings of office suites. */
+export type SpacingSide = 'before' | 'after';
+/** Space a block keeps on one side, in points; `0` when it uses the document default. */
+export declare const paragraphSpacing: (block: HTMLElement, side: SpacingSide) => number;
+/**
+ * Sets the space before or after the selected paragraphs, in points; `null` restores the document default. The gap
+ * pagination may have added is dropped, because it is written into the same margin and is recomputed anyway.
+ */
+export declare const setParagraphSpacing: (root: HTMLElement, range: Range, side: SpacingSide, points: number | null) => void;
+/** Paragraph indents in CSS pixels, the exact distances the ruler drags. */
+export interface ParagraphIndents {
+    /** Distance the paragraph keeps from the left text edge. */
+    left: number;
+    /** Distance it keeps from the right text edge. */
+    right: number;
+    /** Extra distance of its first line; a negative value hangs the first line out to the left. */
+    firstLine: number;
+}
+/** Indents of a block; a block without them uses zero. */
+export declare const paragraphIndents: (block: HTMLElement) => ParagraphIndents;
+/**
+ * Sets exact indents on the selected paragraphs; a side left out of `patch` keeps its value. Exact indents replace
+ * the stepped indentation of the toolbar buttons, so the step attribute is dropped with them.
+ */
+export declare const setParagraphIndents: (root: HTMLElement, range: Range, patch: Partial<ParagraphIndents>) => void;
 /**
  * Moves the selected paragraphs outside lists by whole indentation steps.
  * @returns whether any block's indentation changed.

package/dist/core/engine/clipboard.d.ts

@@ -17,6 +17,11 @@ export declare const singleUrl: (content: TransferContent) => string | null;
 export declare const textToFragment: (text: string) => DocumentFragment;
 /** Converts a payload into editor blocks, preferring sanitised HTML over plain text; `null` when it has neither. */
 export declare const transferToFragment: (content: TransferContent) => DocumentFragment | null;
+/** Clean HTML and plain text of a selection, as put on the clipboard by copy, cut and drag. */
+export declare const selectionClipboardData: (root: HTMLElement, range: Range) => {
+    html: string;
+    text: string;
+};
 /** Puts clean HTML and plain text of the selection on a clipboard or drag payload for copy, cut and drag. */
 export declare const writeTransfer: (data: DataTransfer, root: HTMLElement, range: Range) => void;
 /** Collapsed range at the text position under the pointer, used to place dropped content and canvas clicks. */

package/dist/core/engine/engine.d.ts

@@ -1,8 +1,8 @@
 import { type EditorUiState } from '../ui-state';
-import { type HeadingTag, type TextAlign, type TextDirection } from './blocks';
+import { type HeadingTag, type ParagraphIndents, type SpacingSide, type TextAlign, type TextDirection } from './blocks';
 import { EditorHistory } from './history';
 import { type ListKind } from './lists';
-import { type MarkName, type StyleName } from './marks';
+import { type MarkName, type StyleName, type TextCase } from './marks';
 import { SearchController, type SearchState } from './search';
 import { type TableCell } from './tables';
 /** Settings the host component passes when it creates the engine. */
@@ -46,6 +46,23 @@ interface ImageAttributes {
     /** Rendered height in CSS pixels. */
     height?: number | null;
 }
+/** Character and paragraph formatting picked up by the format painter. */
+export interface CopiedFormat {
+    /** Marks that were active on the copied text. */
+    marks: Partial<Record<MarkName, boolean>>;
+    /** Span styles of the copied text; empty values mean the document default. */
+    styles: Partial<Record<StyleName, string>>;
+    /** Highlight colour of the copied text, empty when it was not highlighted. */
+    highlight: string;
+    /** Tag of the copied block, so headings are painted as headings. */
+    tag: 'P' | HeadingTag;
+    /** Alignment of the copied paragraph. */
+    align: TextAlign;
+    /** Line spacing of the copied paragraph, empty for the default. */
+    lineHeight: string;
+    /** Indentation steps of the copied paragraph. */
+    indent: number;
+}
 /** Callback registered with {@link DocumentEngine.on}. */
 type Listener<T> = (payload: T) => void;
 /**
@@ -81,6 +98,8 @@ export declare class DocumentEngine {
     private dragRange;
     /** Image selected by a click, shown with resize handles. */
     private selectedImageElement;
+    /** Formatting the format painter carries until it is painted onto a selection. */
+    private painterFormat;
     /**
      * Takes over `root` as the editable document, loads the initial content and starts listening to its events.
      *
@@ -140,6 +159,14 @@ export declare class DocumentEngine {
      * @param position Place the caret at the start or end; without it the last selection is restored.
      */
     focus(position?: 'start' | 'end'): void;
+    /** Selects the whole document, as Ctrl/⌘+A does. */
+    selectAll(): void;
+    /** Copies the selection to the system clipboard as clean HTML and plain text. */
+    copySelection(): Promise<void>;
+    /** Copies the selection and removes it as one undo step. */
+    cutSelection(): Promise<void>;
+    /** Inserts the clipboard content at the selection; the browser asks for clipboard permission the first time. */
+    pasteFromClipboard(): Promise<void>;
     /** Marks the next selection changes as caused by the engine, so they keep pending formatting and typing groups. */
     private expectInternalSelection;
     /** Live selection inside the document, or a copy of the last one while focus is elsewhere (e.g. in a popover). */
@@ -248,6 +275,19 @@ export declare class DocumentEngine {
     setHighlight(color: string | null): void;
     /** Merges a formatting change into the pending format and keeps focus in the document. */
     private setPending;
+    /** Changes the letter case of the selected text. */
+    changeTextCase(mode: TextCase): void;
+    /** Stores the format the painter carries and shows the painting cursor while it does. */
+    private setPainterFormat;
+    /**
+     * Picks up the character and paragraph formatting at the selection. The next selection made with the mouse, or a
+     * click inside a paragraph, receives it; {@link cancelFormatPainter} and Escape drop it again.
+     */
+    copyFormat(): void;
+    /** Drops the copied format without painting it. */
+    cancelFormatPainter(): void;
+    /** Paints the copied format onto the selection, or onto the whole paragraph at a collapsed caret. */
+    paintFormat(): void;
     /** Removes marks from the selection and turns its blocks into plain paragraphs outside lists and quotes. */
     clearFormatting(): void;
     /** Turns the selected blocks into paragraphs or headings. */
@@ -260,6 +300,10 @@ export declare class DocumentEngine {
     setTextAlign(align: TextAlign): void;
     /** Sets or removes (`null`) the line spacing of the selected paragraphs. */
     setLineHeight(lineHeight: string | null): void;
+    /** Sets exact indents on the selected paragraphs, in pixels; sides left out keep their value. */
+    setParagraphIndents(patch: Partial<ParagraphIndents>): void;
+    /** Sets the space before or after the selected paragraphs, in points; `null` restores the document default. */
+    setParagraphSpacing(side: SpacingSide, points: number | null): void;
     /** Sets the writing direction of the selected paragraphs. */
     setTextDirection(direction: TextDirection): void;
     /** Turns the selected blocks into a list of the given kind, converts another list kind, or lifts them out. */

package/dist/core/engine/marks.d.ts

@@ -37,6 +37,15 @@ export declare const setLink: (root: HTMLElement, range: Range, href: string, ta
 export declare const unsetLink: (root: HTMLElement, range: Range) => void;
 /** Removes every mark, span style, highlight and link from the selected text. */
 export declare const clearMarks: (root: HTMLElement, range: Range) => void;
+/** Letter case transformations offered by the toolbar. */
+export type TextCase = 'upper' | 'lower' | 'title' | 'sentence' | 'toggle';
+/**
+ * Changes the letter case of the selected text. The selection is transformed as one string, so sentence and title
+ * case also work across formatting boundaries.
+ *
+ * @returns whether any text was selected.
+ */
+export declare const applyTextCase: (root: HTMLElement, range: Range, mode: TextCase) => boolean;
 /** Which marks apply to `node`. */
 export declare const readMarks: (root: HTMLElement, node: Node) => Record<MarkName, boolean>;
 /** Value of a span style at `node`, or an empty string when none is set. */

package/dist/core/engine/schema.d.ts

@@ -2,6 +2,10 @@
 export declare const GAP_ATTRIBUTE = "data-doc-gap";
 /** Class marking table cells in a drag selection; editor-only. */
 export declare const SELECTED_CELL_CLASS = "doc-cell-selected";
+/** Attribute holding the space a paragraph keeps before it, in points. */
+export declare const SPACE_BEFORE_ATTRIBUTE = "data-space-before";
+/** Attribute holding the space a paragraph keeps after it, in points. */
+export declare const SPACE_AFTER_ATTRIBUTE = "data-space-after";
 /** Whether the node is a block in the editor model. */
 export declare const isBlockNode: (node: Node | null | undefined) => node is HTMLElement;
 /** Sets a paragraph's indentation level as `data-indent` plus the matching left margin, removing both at level 0. */

package/dist/core/export.d.ts

@@ -1,17 +1,27 @@
 import { type PageSettings } from './page';
 /** Everything needed to print or export the document. */
 interface DocumentSnapshot {
-    /** Clean document HTML. */
+    /** Clean document HTML, used when the document is not laid out in sheets. */
     html: string;
+    /**
+     * Clean HTML of every sheet, in document order. The page view passes it so printing repeats the header and footer
+     * with real page numbers and breaks the pages exactly where the editor shows them.
+     */
+    pages?: string[];
     /** Document title, used for the print title and file names. */
     title: string;
-    /** Page size, orientation and margins. */
+    /** Page size, orientation, margins and the running texts. */
     page: PageSettings;
 }
 /** Turns a document title into a safe file name without extension. */
 export declare const toFileName: (title: string) => string;
-/** Standalone HTML with the page size and margins encoded as `@page`, used for printing and HTML export. */
-export declare const buildPrintableHtml: ({ html, title, page }: DocumentSnapshot) => string;
+/**
+ * Standalone HTML with the page size, margins and running texts encoded in CSS, used for printing and HTML export.
+ * With the sheets of the page view every page carries its own header and footer, so the page numbers are exact and
+ * the pages break where the editor shows them; without them the document flows and the browser repeats one fixed
+ * header and footer on every page.
+ */
+export declare const buildPrintableHtml: ({ html, pages, title, page }: DocumentSnapshot) => string;
 /** Word opens HTML saved with the Office namespaces as a regular document in print layout. */
 export declare const buildWordHtml: ({ html, title, page }: DocumentSnapshot) => string;
 /** Offers text content as a file download. */

package/dist/core/icons.d.ts

@@ -3,7 +3,7 @@
  * from Lucide 1.44.0 (https://lucide.dev, ISC license, see LICENSE); the data is generated, not edited by hand.
  */
 /** Name of an icon in the editor's set. */
-export type IconName = 'between-horizontal-end' | 'between-horizontal-start' | 'between-vertical-end' | 'between-vertical-start' | 'bold' | 'calendar-days' | 'case-sensitive' | 'chevron-down' | 'chevron-right' | 'chevron-up' | 'code' | 'columns-2' | 'ellipsis' | 'external-link' | 'file-code' | 'file-down' | 'file-sliders' | 'file-text' | 'file-type' | 'grid-2x2-x' | 'grid-3x3' | 'highlighter' | 'image-plus' | 'italic' | 'languages' | 'link' | 'list' | 'list-indent-decrease' | 'list-indent-increase' | 'list-ordered' | 'list-todo' | 'loader-circle' | 'maximize-2' | 'minimize-2' | 'minus' | 'move-horizontal' | 'omega' | 'panel-top' | 'pencil' | 'pilcrow-left' | 'pilcrow-right' | 'plus' | 'printer' | 'quote' | 'rectangle-horizontal' | 'rectangle-vertical' | 'redo-2' | 'remove-formatting' | 'rows-2' | 'scroll-text' | 'search' | 'separator-horizontal' | 'square-code' | 'square-split-vertical' | 'strikethrough' | 'subscript' | 'superscript' | 'table-cells-merge' | 'table-cells-split' | 'text-align-center' | 'text-align-end' | 'text-align-justify' | 'text-align-start' | 'text-cursor-input' | 'trash' | 'underline' | 'undo-2' | 'unfold-vertical' | 'unlink' | 'upload' | 'whole-word' | 'x';
+export type IconName = 'a-arrow-down' | 'a-arrow-up' | 'between-horizontal-end' | 'between-horizontal-start' | 'between-vertical-end' | 'between-vertical-start' | 'bold' | 'calendar-days' | 'case-sensitive' | 'chevron-down' | 'chevron-right' | 'chevron-up' | 'clipboard' | 'code' | 'columns-2' | 'copy' | 'ellipsis' | 'external-link' | 'file-code' | 'file-down' | 'file-sliders' | 'file-text' | 'file-type' | 'grid-2x2-x' | 'grid-3x3' | 'highlighter' | 'image-plus' | 'italic' | 'languages' | 'link' | 'list' | 'list-indent-decrease' | 'list-indent-increase' | 'list-ordered' | 'list-todo' | 'loader-circle' | 'maximize-2' | 'minimize-2' | 'minus' | 'move-horizontal' | 'omega' | 'paintbrush' | 'panel-top' | 'panel-top-dashed' | 'pencil' | 'pilcrow' | 'pilcrow-left' | 'pilcrow-right' | 'plus' | 'printer' | 'quote' | 'rectangle-horizontal' | 'rectangle-vertical' | 'redo-2' | 'remove-formatting' | 'rows-2' | 'ruler' | 'scissors' | 'scroll-text' | 'search' | 'separator-horizontal' | 'square-code' | 'square-split-vertical' | 'strikethrough' | 'subscript' | 'superscript' | 'table-cells-merge' | 'table-cells-split' | 'text-align-center' | 'text-align-end' | 'text-align-justify' | 'text-align-start' | 'text-cursor-input' | 'trash' | 'underline' | 'undo-2' | 'unfold-vertical' | 'unlink' | 'upload' | 'whole-word' | 'x';
 /** One SVG element of an icon: its tag and attributes. */
 export type IconElement = readonly [tag: string, attributes: Readonly<Record<string, string | number>>];
 /** Elements of every icon, by name. */

package/dist/core/labels.d.ts

@@ -1,150 +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.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.defaultFont': "Standart shrift";
-    readonly 'editor.defaultLineHeight': "Standart";
-    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.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.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.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.size': "Qog‘oz o‘lchami";
-    readonly 'editor.pageBreak': "Sahifa uzilishi";
-    readonly 'editor.paragraph': "Oddiy matn";
-    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.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.source': "HTML kod";
-    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;