nuvra 0.4.1 → 0.6.0

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

@@ -35,7 +35,49 @@ export declare const setHighlight: (root: HTMLElement, range: Range, color: stri
 export declare const setLink: (root: HTMLElement, range: Range, href: string, target: string | null) => boolean;
 /** Removes links from the selected text, keeping the text itself. */
 export declare const unsetLink: (root: HTMLElement, range: Range) => void;
-/** Removes every mark, span style, highlight and link from the selected text. */
+/** Attribute holding the id of the comment a span of text is anchored to. */
+export declare const COMMENT_ATTRIBUTE = "data-comment";
+/** A valid comment id: letters, digits, `_` and `-`. */
+export declare const COMMENT_ID: RegExp;
+/** Selector of every comment anchor. */
+export declare const COMMENT_SELECTOR = "span[data-comment]";
+/**
+ * Anchors a comment to the selected text. Text that already belongs to another comment keeps it, so comments may
+ * overlap.
+ * @returns whether any text was selected.
+ */
+export declare const addCommentAnchor: (root: HTMLElement, range: Range, id: string) => boolean;
+/** Attribute holding the id of a tracked change; inserted and deleted text of one edit share it. */
+export declare const CHANGE_ATTRIBUTE = "data-change";
+/** A valid change id. */
+export declare const CHANGE_ID: RegExp;
+/** Selector of every tracked insertion and deletion. */
+export declare const CHANGE_SELECTOR = "ins[data-change], del[data-change]";
+/** Who made a tracked change and when, written on its `<ins>` or `<del>`. */
+export interface ChangeMark {
+    /** Id shared by the parts of one edit. */
+    id: string;
+    /** Name of the author; may be empty. */
+    author: string;
+    /** When the change was made, as an ISO 8601 string. */
+    time: string;
+}
+/** Tracked deletion around `node`, if any. */
+export declare const deletionAncestor: (node: Node, root: HTMLElement) => HTMLElement | null;
+/** Marks the text and inline atoms of a range as inserted, unless they already are. */
+export declare const markInserted: (root: HTMLElement, range: Range, mark: ChangeMark) => void;
+/**
+ * Deletes a range the tracked way: text the same author inserted while tracking is removed for real, other text is
+ * marked as deleted and stays visible until the deletion is accepted.
+ * @returns whether anything was selected.
+ */
+export declare const markDeleted: (root: HTMLElement, range: Range, mark: ChangeMark) => boolean;
+/**
+ * Accepts or rejects tracked changes: accepting keeps inserted text and drops deleted text, rejecting does the
+ * opposite. Blocks left empty by removed text are kept, like Word keeps the paragraph.
+ */
+export declare const resolveChanges: (elements: HTMLElement[], accept: boolean) => void;
+/** Removes every mark, span style, highlight and link from the selected text; comment anchors and changes stay. */
 export declare const clearMarks: (root: HTMLElement, range: Range) => void;
 /** Letter case transformations offered by the toolbar. */
 export type TextCase = 'upper' | 'lower' | 'title' | 'sentence' | 'toggle';
@@ -46,6 +88,13 @@ export type TextCase = 'upper' | 'lower' | 'title' | 'sentence' | 'toggle';
  * @returns whether any text was selected.
  */
 export declare const applyTextCase: (root: HTMLElement, range: Range, mode: TextCase) => boolean;
+/**
+ * Rewrites the selected text node by node, so every mark around it stays; each call also receives the character
+ * before the node in the same block, so rules that depend on word boundaries work across formatting.
+ *
+ * @returns whether any text was selected.
+ */
+export declare const transformSelectedText: (root: HTMLElement, range: Range, transform: (text: string, previous: string) => string) => 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

@@ -1,3 +1,9 @@
+/** A valid template variable name: letters, digits, `_`, `.` and `-`, as used in `{{name}}`. */
+export declare const VARIABLE_NAME: RegExp;
+/** Attribute holding the label a variable chip shows in the editor; editor-only. */
+export declare const VARIABLE_LABEL_ATTRIBUTE = "data-label";
+/** Attribute pagination writes on blocks of a section turned against the document's orientation; editor-only. */
+export declare const ROTATED_ATTRIBUTE = "data-doc-rotated";
 /** Attribute pagination writes on blocks it moved to the next sheet; editor-only. */
 export declare const GAP_ATTRIBUTE = "data-doc-gap";
 /** Class marking table cells in a drag selection; editor-only. */
@@ -32,9 +38,10 @@ export declare const normalizeContainer: (container: ParentNode & Node, isRoot?:
 export declare const sanitizeHtml: (html: string) => DocumentFragment;
 /**
  * Removes editor-only markup (pagination gaps, cell selection). With `forExport` it also drops caret placeholders
- * and editing attributes, which history snapshots keep so the restored DOM is immediately editable.
+ * and editing attributes, which history snapshots keep so the restored DOM is immediately editable, and numbers the
+ * footnote references from `firstFootnote` (a sheet of a longer document continues the numbering).
  */
-export declare const cleanEditorArtifacts: (scope: Element | DocumentFragment, forExport: boolean) => void;
+export declare const cleanEditorArtifacts: (scope: Element | DocumentFragment, forExport: boolean, firstFootnote?: number) => void;
 /** Clean HTML of the editor content, as stored in the model and exported. */
 export declare const serialize: (root: HTMLElement) => string;
 /** Whether the document is a single unformatted, empty paragraph. */

package/dist/core/export.d.ts

@@ -1,3 +1,4 @@
+import { type SheetFootnote } from './footnotes';
 import { type PageSettings } from './page';
 /** Everything needed to print or export the document. */
 interface DocumentSnapshot {
@@ -8,11 +9,20 @@ interface DocumentSnapshot {
      * with real page numbers and breaks the pages exactly where the editor shows them.
      */
     pages?: string[];
+    /** For every sheet of `pages`, whether a section break turned it against the document's orientation. */
+    rotated?: boolean[];
+    /** Footnotes of every sheet of `pages`; without pages, the notes of all of them are printed after the document. */
+    footnotes?: SheetFootnote[][];
     /** Document title, used for the print title and file names. */
     title: string;
     /** Page size, orientation, margins and the running texts. */
     page: PageSettings;
 }
+/** Paper width and height in millimetres, in the chosen orientation. */
+export declare const paperSize: ({ size, orientation }: PageSettings) => {
+    width: number;
+    height: number;
+};
 /** Turns a document title into a safe file name without extension. */
 export declare const toFileName: (title: string) => string;
 /**
@@ -21,11 +31,9 @@ export declare const toFileName: (title: string) => string;
  * 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. */
-export declare const downloadFile: (content: string, fileName: string, type: string) => void;
+export declare const buildPrintableHtml: ({ html, pages, rotated, footnotes, title, page }: DocumentSnapshot) => string;
+/** Offers text or binary content as a file download. */
+export declare const downloadFile: (content: string | Blob, fileName: string, type: string) => void;
 /** Prints through a detached iframe so the application chrome never ends up on paper. Waits for images first. */
 export declare const printHtml: (documentHtml: string) => void;
 export {};

package/dist/core/footnotes.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The notes of footnotes as they are drawn at the bottom of a sheet. The editor, the layout measurement and printing
+ * all render them with this markup, so the space pagination reserves matches what is drawn.
+ */
+/** A footnote as it appears at the bottom of a sheet. */
+export interface SheetFootnote {
+    /** Number of the footnote in the document, starting at 1. */
+    number: number;
+    /** Text of the note. */
+    text: string;
+}
+/** Class of the notes block; its look is defined in `document-content.css`. */
+export declare const FOOTNOTES_CLASS = "doc-footnotes";
+/** HTML of the notes block of one sheet, or an empty string when the sheet has no footnotes. */
+export declare const footnotesHtml: (notes: readonly SheetFootnote[]) => string;

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 = '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';
+export type IconName = 'a-arrow-down' | 'a-arrow-up' | 'banknote' | 'between-horizontal-end' | 'between-horizontal-start' | 'between-vertical-end' | 'between-vertical-start' | 'bold' | 'braces' | 'calendar-days' | 'case-sensitive' | 'check' | '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-checks' | 'list-indent-decrease' | 'list-indent-increase' | 'list-ordered' | 'list-todo' | 'loader-circle' | 'maximize-2' | 'message-square' | 'message-square-plus' | 'minimize-2' | 'minus' | 'move-horizontal' | 'omega' | 'paintbrush' | 'panel-left' | 'panel-top' | 'panel-top-dashed' | 'pencil' | 'pilcrow' | 'pilcrow-left' | 'pilcrow-right' | 'plus' | 'printer' | 'quote' | 'rectangle-horizontal' | 'rectangle-vertical' | 'redo-2' | 'remove-formatting' | 'reply' | 'rows-2' | 'ruler' | 'scissors' | 'scroll-text' | 'search' | 'separator-horizontal' | 'signature' | 'square-code' | 'square-split-vertical' | 'strikethrough' | 'subscript' | 'superscript' | 'table-cells-merge' | 'table-cells-split' | 'table-of-contents' | '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,7 +1,7 @@
 import { type EditorLabelKey } from './locales/uz';
 export type { EditorLabelKey };
-/** Languages the editor interface is available in. */
-export type EditorLocaleCode = 'uz' | 'en' | 'ru';
+/** Languages the editor interface is available in: Uzbek in Latin and Cyrillic script, English and Russian. */
+export type EditorLocaleCode = 'uz' | 'uz-Cyrl' | 'en' | 'ru';
 /**
  * A built-in interface language. Locales only select one of the translations shipped with the editor; the texts
  * themselves cannot be changed from outside.
@@ -16,6 +16,8 @@ export interface EditorLocale {
 export type EditorLocaleInput = EditorLocale | EditorLocaleCode;
 /** Uzbek (Latin) interface. */
 export declare const uzLocale: EditorLocale;
+/** Uzbek (Cyrillic) interface. */
+export declare const uzCyrlLocale: EditorLocale;
 /** English interface. */
 export declare const enLocale: EditorLocale;
 /** Russian interface. */
@@ -35,4 +37,6 @@ export declare const formatShortcut: (shortcut: string) => string;
 export declare const useEditorLabels: (locale?: () => EditorLocaleInput | undefined) => {
     t: (key: EditorLabelKey, named?: Record<string, unknown>) => string;
     withShortcut: (key: EditorLabelKey, shortcut: string) => string;
+    /** Code of the editor's language, e.g. for numbers and dates written into the document. */
+    locale: import("vue").ComputedRef<EditorLocaleCode>;
 };

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

@@ -0,0 +1,3 @@
+import type { EditorLabelKey } from './uz';
+/** Uzbek (Cyrillic) texts of the editor interface, generated by `scripts/generate-uz-cyrl.mjs`. */
+export declare const uzCyrl: Readonly<Record<EditorLabelKey, string>>;

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

@@ -1,5 +1,6 @@
 /** Uzbek (Latin) texts of the editor interface; `{name}` marks a placeholder filled in at translation time. */
 export declare const uz: {
+    readonly 'editor.amountInWords': "Summani so‘z bilan yozish";
     readonly 'editor.align': "Tekislash";
     readonly 'editor.align.center': "Markazga";
     readonly 'editor.align.justify': "Ikki tomonga";
@@ -14,9 +15,32 @@ export declare const uz: {
     readonly 'editor.case.toggle': "rEGISTRNI ALMASHTIRISH";
     readonly 'editor.case.upper': "BOSH HARFLAR";
     readonly 'editor.changeCase': "Harf registri";
+    readonly 'editor.changes': "O‘zgarishlar";
+    readonly 'editor.changes.accept': "Qabul qilish";
+    readonly 'editor.changes.acceptAll': "Hammasini qabul qilish";
+    readonly 'editor.changes.deleted': "O‘chirildi";
+    readonly 'editor.changes.empty': "Kuzatilgan o‘zgarishlar yo‘q. Kuzatishni yoqing — yozilgan va o‘chirilgan matn shu yerda ko‘rinadi.";
+    readonly 'editor.changes.inserted': "Qo‘shildi";
+    readonly 'editor.changes.reject': "Rad etish";
+    readonly 'editor.changes.rejectAll': "Hammasini rad etish";
     readonly 'editor.clearFormatting': "Formatni tozalash";
     readonly 'editor.close': "Yopish";
     readonly 'editor.codeBlock': "Kod bloki";
+    readonly 'editor.comment.add': "Izoh qo‘shish";
+    readonly 'editor.comment.cancel': "Bekor qilish";
+    readonly 'editor.comment.detached': "Izoh qoldirilgan matn o‘chirilgan";
+    readonly 'editor.comment.placeholder': "Izoh yozing… (Ctrl+Enter — saqlash)";
+    readonly 'editor.comment.reopen': "Qayta ochish";
+    readonly 'editor.comment.reply': "Javob";
+    readonly 'editor.comment.replyPlaceholder': "Javob yozing…";
+    readonly 'editor.comment.resolve': "Hal qilindi";
+    readonly 'editor.comment.resolved': "Hal qilingan";
+    readonly 'editor.comment.save': "Saqlash";
+    readonly 'editor.comments': "Izohlar";
+    readonly 'editor.comments.empty': "Hali izohlar yo‘q. Matnni belgilab, izoh qo‘shing.";
+    readonly 'editor.compare.deletions': "O‘chirilgan so‘zlar: {count}";
+    readonly 'editor.compare.insertions': "Qo‘shilgan so‘zlar: {count}";
+    readonly 'editor.compare.same': "Versiyalar bir xil";
     readonly 'editor.colors.automatic': "Avtomatik";
     readonly 'editor.colors.custom': "Boshqa rang…";
     readonly 'editor.colors.none': "Rangsiz";
@@ -35,10 +59,13 @@ export declare const uz: {
     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.exportPdf': "PDF sifatida yuklab olish";
+    readonly 'editor.exportWord': "Word (.docx) sifatida yuklab olish";
     readonly 'editor.fitWidth': "Kenglikka moslash";
     readonly 'editor.fontFamily': "Shrift";
     readonly 'editor.fontSize': "Shrift o‘lchami";
+    readonly 'editor.footnote': "Snoska (sahifa osti izohi)";
+    readonly 'editor.footnote.placeholder': "Snoska matni… (Ctrl+Enter — saqlash)";
     readonly 'editor.footer': "Pastki kolontitul";
     readonly 'editor.formatPainter': "Format bo‘yoqchasi";
     readonly 'editor.formattingMarks': "Formatlash belgilari";
@@ -46,6 +73,8 @@ export declare const uz: {
     readonly 'editor.headerFooter': "Kolontitullar";
     readonly 'editor.headerFooter.center': "Markaz";
     readonly 'editor.headerFooter.clear': "Tozalash";
+    readonly 'editor.headerFooter.differentFirst': "Birinchi sahifada ko‘rsatilmasin";
+    readonly 'editor.headerFooter.firstNumber': "Raqamlash boshlanishi";
     readonly 'editor.headerFooter.hint': "Matn har bir sahifada takrorlanadi.";
     readonly 'editor.headerFooter.left': "Chap";
     readonly 'editor.headerFooter.right': "O‘ng";
@@ -63,11 +92,13 @@ export declare const uz: {
     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.importWord': "Word faylini ochish (.docx)";
     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.insertDateLong': "Bugungi sana (to‘liq)";
     readonly 'editor.insertMore': "Boshqa elementlar";
     readonly 'editor.italic': "Kursiv";
     readonly 'editor.lineHeight': "Qator oralig‘i";
@@ -77,6 +108,15 @@ export declare const uz: {
     readonly 'editor.linkUrl': "Manzil (URL)";
     readonly 'editor.more': "Yana";
     readonly 'editor.moreFormatting': "Boshqa formatlar";
+    readonly 'editor.numbering': "Raqamlash turi";
+    readonly 'editor.numbering.default': "Oddiy raqamlash (1, 2, 3)";
+    readonly 'editor.numbering.legal': "Ko‘p darajali raqamlash (1.1, 1.2)";
+    readonly 'editor.outline': "Navigatsiya paneli";
+    readonly 'editor.outline.empty': "Hujjatda sarlavhalar yo‘q. Sarlavha uslubini qo‘llang, ular shu yerda ko‘rinadi.";
+    readonly 'editor.outline.headings': "Sarlavhalar";
+    readonly 'editor.outline.noPages': "Sahifalar faqat sahifa ko‘rinishida chiqadi.";
+    readonly 'editor.outline.page': "{page}-sahifa";
+    readonly 'editor.outline.pages': "Sahifalar";
     readonly 'editor.openLink': "Havolani ochish";
     readonly 'editor.or': "yoki havola orqali";
     readonly 'editor.orderedList': "Raqamli ro‘yxat";
@@ -112,6 +152,7 @@ export declare const uz: {
     readonly 'editor.replace.one': "Almashtirish";
     readonly 'editor.replace.placeholder': "Almashtirish";
     readonly 'editor.replace.toggle': "Almashtirishni ko‘rsatish";
+    readonly 'editor.review': "Taqriz: izohlar va o‘zgarishlar";
     readonly 'editor.ruler': "Chizg‘ich";
     readonly 'editor.ruler.firstLine': "Birinchi qator chekinishi";
     readonly 'editor.ruler.indentLeft': "Chap chekinish";
@@ -125,6 +166,23 @@ export declare const uz: {
     readonly 'editor.search.title': "Qidirish va almashtirish";
     readonly 'editor.search.wholeWord': "Butun so‘z";
     readonly 'editor.selectAll': "Barchasini tanlash";
+    readonly 'editor.sectionBreak.landscape': "Bo‘lim uzilishi: albom sahifalar";
+    readonly 'editor.sectionBreak.portrait': "Bo‘lim uzilishi: kitob sahifalar";
+    readonly 'editor.signature': "Imzo bloki";
+    readonly 'editor.signature.agreed': "KELISHILDI grifi";
+    readonly 'editor.signature.approval': "TASDIQLAYMAN grifi";
+    readonly 'editor.signature.parties': "Tomonlarning imzolari";
+    readonly 'editor.signature.signer': "Imzo qatori";
+    readonly 'editor.signature.text.agreed': "KELISHILDI";
+    readonly 'editor.signature.text.approved': "TASDIQLAYMAN";
+    readonly 'editor.signature.text.contractor': "IJROCHI:";
+    readonly 'editor.signature.text.customer': "BUYURTMACHI:";
+    readonly 'editor.signature.text.date': "«___» ____________ 20__ y.";
+    readonly 'editor.signature.text.name': "F.I.Sh.";
+    readonly 'editor.signature.text.organization': "Tashkilot nomi";
+    readonly 'editor.signature.text.position': "Lavozim";
+    readonly 'editor.signature.text.seal': "M.O‘.";
+    readonly 'editor.slash.title': "Buyruqlar";
     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";
@@ -151,15 +209,28 @@ export declare const uz: {
     readonly 'editor.table.splitCell': "Katakni ajratish";
     readonly 'editor.table.title': "Jadval";
     readonly 'editor.taskList': "Vazifalar ro‘yxati";
+    readonly 'editor.templates': "Hujjat shablonlari";
+    readonly 'editor.templates.act': "Dalolatnoma";
+    readonly 'editor.templates.application': "Ariza";
+    readonly 'editor.templates.certificate': "Ma’lumotnoma";
+    readonly 'editor.templates.letter': "Xizmat xati";
+    readonly 'editor.templates.order': "Buyruq";
     readonly 'editor.textColor': "Matn rangi";
     readonly 'editor.textDirection': "Matn yo‘nalishi";
     readonly 'editor.textStyle': "Matn uslubi";
+    readonly 'editor.toc': "Mundarija";
+    readonly 'editor.toc.empty': "Hujjatda sarlavhalar yo‘q";
+    readonly 'editor.toc.update': "Mundarijani yangilash";
     readonly 'editor.toolbar': "Muharrir asboblari";
+    readonly 'editor.track': "O‘zgarishlarni kuzatish";
+    readonly 'editor.transliterate.toCyrillic': "Kirill yozuviga o‘girish";
+    readonly 'editor.transliterate.toLatin': "Lotin yozuviga o‘girish";
     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.variables': "O‘zgaruvchi qo‘shish";
     readonly 'editor.view.page': "Sahifa ko‘rinishi";
     readonly 'editor.view.web': "Veb ko‘rinish";
     readonly 'editor.zoom': "Masshtab";

package/dist/core/numbers.d.ts

@@ -0,0 +1,19 @@
+/** Languages numbers can be written out in. */
+export type NumberWordsLocale = 'uz' | 'uz-Cyrl' | 'ru' | 'en';
+/**
+ * Writes a whole number out in words, for example `15 000 000` as `o‘n besh million`. Fractions are dropped; negative
+ * numbers get a minus word.
+ *
+ * @throws RangeError for values that are not finite or reach a quadrillion.
+ */
+export declare const numberToWords: (value: number, locale?: NumberWordsLocale) => string;
+/**
+ * An amount with its digits grouped and the whole part in words, as written in contracts and payment documents:
+ * `15 000 000 (o‘n besh million)`. Hundredths stay in digits: `1 250,50 (bir ming ikki yuz ellik)`.
+ */
+export declare const formatAmountInWords: (value: number, locale?: NumberWordsLocale) => string;
+/**
+ * Reads a typed amount such as `15 000 000`, `15000000`, `1 250,50` or `1,250.50`; `null` when the text is not an
+ * amount. A separator followed by exactly three digits groups thousands; one or two digits at the end are decimals.
+ */
+export declare const parseAmount: (text: string) => number | null;

package/dist/core/outline.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The outline of a document: its headings, the navigation panel built from them, and the table of contents. The table
+ * of contents is a borderless `<table data-type="toc">` of ordinary content, so it prints and exports to Word like any
+ * other table and can be refreshed after the headings or the page breaks change.
+ */
+/** A heading of the document. */
+export interface OutlineHeading {
+    /** Heading level, 1 to 6. */
+    level: number;
+    /** Heading text with collapsed whitespace. */
+    text: string;
+    /** The heading element in the editable document. */
+    element: HTMLElement;
+}
+/** What the navigation panel lists: the headings, or thumbnails of the pages. */
+export type OutlineView = 'headings' | 'pages';
+/** A line of the table of contents. */
+export interface TableOfContentsEntry {
+    /** Heading level, 1 to 6; deeper levels are indented. */
+    level: number;
+    /** Heading text. */
+    text: string;
+    /** Page the heading starts on, or `null` when the document is not laid out in pages. */
+    page: number | null;
+}
+/** Options of {@link buildTableOfContents}. */
+export interface TableOfContentsOptions {
+    /** Title written above the entries. */
+    title: string;
+    /** Text shown instead of the entries when the document has no headings. */
+    emptyText: string;
+    /** Width of the text column in pixels; the table spans it plus the page number column. */
+    width?: number;
+}
+/** Marks the table of contents among the tables of a document. */
+export declare const TABLE_OF_CONTENTS_TYPE = "toc";
+/** Selector of the table of contents. */
+export declare const TABLE_OF_CONTENTS_SELECTOR = "table[data-type=\"toc\"]";
+/** Deepest heading level the table of contents lists by default. */
+export declare const TABLE_OF_CONTENTS_DEPTH = 3;
+/** Headings written directly in the document, not inside tables, lists or quotes, in document order. */
+export declare const readOutline: (root: HTMLElement, depth?: number) => OutlineHeading[];
+/** HTML of a table of contents: the title, then one row per heading with its page number on the right. */
+export declare const buildTableOfContents: (entries: TableOfContentsEntry[], options: TableOfContentsOptions) => string;

package/dist/core/page.d.ts

@@ -47,6 +47,10 @@ export interface PageSettings {
     footer?: PageHeaderFooter;
     /** Watermark drawn behind the text of every page; omitted while the document has none. */
     watermark?: PageWatermark;
+    /** Whether the first page shows no header, footer or page number, as on title pages and letterheads. */
+    differentFirstPage?: boolean;
+    /** Number printed on the first page; the following pages count on from it. Defaults to 1. */
+    firstPageNumber?: number;
 }
 /** Page geometry in CSS pixels, ready for layout. */
 export interface PageMetrics {
@@ -130,15 +134,21 @@ export declare const createPageSettings: () => PageSettings;
 export declare const createHeaderFooter: () => PageHeaderFooter;
 /** Whether a header or footer holds any text at all. */
 export declare const hasHeaderFooterText: (value: PageHeaderFooter | undefined) => boolean;
+/** Largest first page number the page setup accepts. */
+export declare const MAX_FIRST_PAGE_NUMBER = 9999;
+/** Number printed on a sheet, counted from 1 for the first sheet. */
+export declare const pageNumberOf: (page: PageSettings, sheet: number) => number;
+/** Whether the header, footer and page number are drawn on a sheet, counted from 1 for the first sheet. */
+export declare const showsRunningTexts: (page: PageSettings, sheet: number) => boolean;
 /** Tokens a header or footer text may contain, replaced when the text is drawn on a page. */
 export declare const HEADER_FOOTER_TOKENS: readonly ["page", "pages", "date", "title"];
 /** One of the tokens a header or footer text may contain. */
 export type HeaderFooterToken = (typeof HEADER_FOOTER_TOKENS)[number];
 /** Values the tokens of a header or footer are replaced with. */
 export interface HeaderFooterContext {
-    /** Number of the page the text is drawn on. */
+    /** Number printed on the page the text is drawn on. */
     page: number;
-    /** Number of pages in the document. */
+    /** Number of pages in the document, as Word counts them: every sheet, whatever number it prints. */
     pages: number;
     /** Document title. */
     title: string;

package/dist/core/pagination.d.ts

@@ -1,4 +1,18 @@
-import type { PageMetrics } from './page';
+import { type SheetFootnote } from './footnotes';
+import type { PageMetrics, PageOrientation } from './page';
+/** Where a sheet is drawn and which way it is turned. */
+export interface SheetGeometry {
+    /** Distance of the sheet from the top of the first sheet, in pixels. */
+    top: number;
+    /** Sheet width in pixels. */
+    width: number;
+    /** Sheet height in pixels. */
+    height: number;
+    /** Orientation of the sheet. */
+    orientation: PageOrientation;
+    /** Whether the sheet is turned against the document's own orientation, by a section break. */
+    rotated: boolean;
+}
 /** Handle returned by {@link createPagination}. */
 export interface PaginationController {
     /** Sets the page geometry and re-runs the layout; pass `null` to switch pagination off (web view). */
@@ -12,15 +26,23 @@ export interface PaginationController {
 interface PaginationOptions {
     /** Receives the number of sheets whenever it changes. */
     onPageCount: (count: number) => void;
+    /** Receives the footnotes of every sheet whenever they change; the web view is one sheet holding all of them. */
+    onFootnotes?: (sheets: SheetFootnote[][]) => void;
+    /** Receives the position, size and orientation of every sheet whenever they change; empty in the web view. */
+    onSheets?: (sheets: SheetGeometry[]) => void;
     /** Whether an IME composition is in progress, during which blocks must not move. */
     isComposing: () => boolean;
 }
+/** Sheets of a document without section breaks, all alike. */
+export declare const uniformSheets: (metrics: PageMetrics, count: number) => SheetGeometry[];
+/** Index of the sheet a vertical position falls on, counted from the top of the first sheet. */
+export declare const sheetIndexAt: (sheets: readonly SheetGeometry[], offset: number) => number;
 /**
  * Splits the laid-out document into the clean HTML of every sheet, for printing and export. Pagination has already
  * moved every block onto its page, so a block belongs to the page its top falls on; blocks taller than a page stay
- * whole, exactly as they are shown on screen.
+ * whole, exactly as they are shown on screen. Footnote references keep their document-wide numbers.
  */
-export declare const splitIntoPages: (root: HTMLElement, metrics: PageMetrics, pageCount: number) => string[];
+export declare const splitIntoPages: (root: HTMLElement, metrics: PageMetrics, pageCount: number, geometry?: readonly SheetGeometry[]) => string[];
 /**
  * Keeps the document laid out on sheets. Layout passes are batched to one per animation frame and re-run when the
  * document resizes, images or fonts load, or the host schedules one after an edit.

package/dist/core/pdf.d.ts

@@ -0,0 +1,43 @@
+/**
+ * PDF download without the print dialog and without dependencies. Every sheet of the printable document is drawn into
+ * a canvas through an SVG `foreignObject`, and the pictures are written into a PDF, one per page. The PDF looks like
+ * the printout, but its text cannot be selected or searched.
+ */
+/** A rendered page: a JPEG picture of the sheet and the paper size it is printed on. */
+export interface PdfPage {
+    /** JPEG data of the page picture. */
+    jpeg: Uint8Array;
+    /** Picture width in pixels. */
+    width: number;
+    /** Picture height in pixels. */
+    height: number;
+    /** Paper width in PDF points (1/72 inch). */
+    widthPt: number;
+    /** Paper height in PDF points. */
+    heightPt: number;
+}
+/** Options of {@link renderPdf}. */
+export interface PdfOptions {
+    /** Pixels per CSS pixel of the page pictures; higher is sharper and larger. Defaults to 2. */
+    scale?: number;
+    /** JPEG quality between 0 and 1. Defaults to 0.92. */
+    quality?: number;
+}
+/** MIME type of PDF files. */
+export declare const PDF_MIME = "application/pdf";
+/**
+ * Writes JPEG pictures into a PDF document, one picture filling each page.
+ *
+ * @returns the PDF file content.
+ */
+export declare const buildPdf: (pages: readonly PdfPage[]) => Uint8Array;
+/**
+ * Turns the printable HTML of a paginated document (one `section.doc-sheet` per page) into a PDF.
+ *
+ * @param printableHtml Standalone HTML as built for printing from the page view.
+ * @param paper Paper width and height in millimetres, in the chosen orientation.
+ */
+export declare const renderPdf: (printableHtml: string, paper: {
+    width: number;
+    height: number;
+}, options?: PdfOptions) => Promise<Blob>;

package/dist/core/signature.d.ts

@@ -0,0 +1,15 @@
+import type { EditorLabelKey } from './labels';
+/** Signature blocks offered by the toolbar. */
+export type SignaturePreset = 'signer' | 'approval' | 'agreed' | 'parties';
+/** Every preset, in the order the menu lists them. */
+export declare const SIGNATURE_PRESETS: ReadonlyArray<{
+    value: SignaturePreset;
+    label: EditorLabelKey;
+}>;
+/**
+ * HTML of a signature block in the editor's language. Every text in it is ordinary editable content: the user replaces
+ * the position and name, or puts template variables there.
+ *
+ * @param t Translates the placeholder texts into the editor's language.
+ */
+export declare const buildSignatureBlock: (preset: SignaturePreset, t: (key: EditorLabelKey) => string) => string;

package/dist/core/slash-commands.d.ts

@@ -0,0 +1,19 @@
+import type { DocumentEngine } from './engine/engine';
+import type { IconName } from './icons';
+/** An entry of the `/` command menu, opened by typing `/` at the start of a line or after a space. */
+export interface SlashCommand {
+    /** Unique id; also matched by the typed filter. */
+    id: string;
+    /** Name shown in the menu. */
+    label: string;
+    /** Icon from the editor's icon set. */
+    icon?: IconName;
+    /** More words the typed filter finds the command by, for example in other languages. */
+    keywords?: readonly string[];
+    /** Runs the command; the typed `/filter` has already been removed and the caret is where it was. */
+    run: (engine: DocumentEngine) => void;
+}
+/** The filter typed after `/` before the caret, or `null` when the text does not end with a trigger. */
+export declare const readSlashQuery: (textBeforeCaret: string | null) => string | null;
+/** Commands whose id, label or keywords contain the filter, those starting with it first. */
+export declare const filterSlashCommands: (commands: readonly SlashCommand[], query: string) => SlashCommand[];

package/dist/core/templates.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Template variables outside the editor. A saved document writes every variable as
+ * `<span data-variable="name">{{name}}</span>`, so a template can be filled in the browser, on a Node server or by a
+ * plain string replacement in any backend.
+ */
+/** A variable the user can insert into a template. */
+export interface TemplateVariable {
+    /** Name used in the saved HTML and in `{{name}}`: letters, digits, `_`, `.` and `-`. */
+    name: string;
+    /** Text the chip shows in the editor and the variable menu lists, for example `Full name`. */
+    label: string;
+}
+/** Values for the variables of a template, by name. */
+export type TemplateValues = Readonly<Record<string, string | number | null | undefined>>;
+/** How {@link fillTemplate} treats a variable without a value. */
+export interface FillTemplateOptions {
+    /**
+     * `keep` (the default) leaves the variable in place, so the result is still a template; `empty` removes it; `name`
+     * writes `{{name}}` as plain text.
+     */
+    missing?: 'keep' | 'empty' | 'name';
+}
+/**
+ * Replaces the variables of a document saved by the editor with values. Values are escaped, so user input cannot
+ * inject markup; the formatting around a variable (bold, font, colour) applies to its value.
+ *
+ * @param html Document HTML as saved by the editor.
+ * @param values Values by variable name.
+ */
+export declare const fillTemplate: (html: string, values: TemplateValues, options?: FillTemplateOptions) => string;
+/** Names of the variables a saved document uses, each once, in document order. */
+export declare const getTemplateVariables: (html: string) => string[];

package/dist/core/transliterate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Conversion of Uzbek text between the Latin and the Cyrillic alphabet, following the official correspondence of the
+ * two alphabets. Placeholders such as `{count}` and `{{name}}` are left untouched.
+ */
+/** Direction of a conversion. */
+export type TransliterationDirection = 'toCyrillic' | 'toLatin';
+/**
+ * Converts Uzbek text between the Latin and the Cyrillic alphabet. Letters of the other alphabet, digits, punctuation
+ * and placeholders stay as they are.
+ *
+ * @param previous The character before `text`, when `text` continues earlier text; it decides the spelling of `e`.
+ */
+export declare const transliterate: (text: string, direction: TransliterationDirection, previous?: string) => string;

package/dist/core/types.d.ts

@@ -1,3 +1,3 @@
 /** Uploads an image and resolves with its public URL. Without a handler, images are embedded as data URLs. */
 export type DocumentImageUploadHandler = (file: File) => Promise<string>;
-export type DocumentMenuAction = 'source' | 'print' | 'exportHtml' | 'exportWord' | 'formattingMarks' | 'ruler' | 'fullscreen';
+export type DocumentMenuAction = 'source' | 'print' | 'exportHtml' | 'exportWord' | 'exportPdf' | 'importWord' | 'formattingMarks' | 'ruler' | 'outline' | 'tableOfContents' | 'comments' | 'addComment' | 'footnote' | 'trackChanges' | 'changes' | 'fullscreen';