@rt-tools/ui-kit-v2 0.24.0 → 0.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rt-tools/ui-kit-v2",
-  "version": "0.24.0",
+  "version": "0.26.0",
   "license": "Apache-2.0",
   "author": "Yauheni Krumin",
   "type": "module",
@@ -19,11 +19,15 @@
     "@angular/forms": "^22.0.0",
     "@angular/platform-browser": "^22.0.0",
     "@angular/router": "^22.0.0",
+    "pdfjs-dist": "^6.4.299",
     "quill": "^2.0.3",
     "rxjs": "^7.8.2",
     "typescript": "^6.0.0"
   },
   "peerDependenciesMeta": {
+    "pdfjs-dist": {
+      "optional": true
+    },
     "quill": {
       "optional": true
     }
@@ -313,6 +317,10 @@
       "types": "./types/rt-tools-ui-kit-v2-pagination.d.ts",
       "default": "./fesm2022/rt-tools-ui-kit-v2-pagination.mjs"
     },
+    "./pdf-viewer": {
+      "types": "./types/rt-tools-ui-kit-v2-pdf-viewer.d.ts",
+      "default": "./fesm2022/rt-tools-ui-kit-v2-pdf-viewer.mjs"
+    },
     "./photo-viewer": {
       "types": "./types/rt-tools-ui-kit-v2-photo-viewer.d.ts",
       "default": "./fesm2022/rt-tools-ui-kit-v2-photo-viewer.mjs"

package/src/lib/components/CONTEXT.md

@@ -41,7 +41,7 @@ tag/
 | списки выбора            | `select`, `multiselect`, `autocomplete`, `filter-control`, `dynamic-selector`                                                                  |
 | обёртка поля             | `field`, `form-control` (основа)                                                                                                               |
 | плавающие панели         | `popover`, `tooltip`, `confirm-popover`, `menu`, `toast`                                                                                       |
-| окна и панели            | `dialog`, `aside`, `aside-section`, `bottom-sheet`, `welcome-dialog`, `photo-viewer`                                                           |
+| окна и панели            | `dialog`, `aside`, `aside-section`, `bottom-sheet`, `welcome-dialog`, `photo-viewer`, `pdf-viewer`                                             |
 | каркас страницы          | `container`, `workspace`, `workspace-details`, `header`, `page-header`, `toolbar`, `section-nav`                                               |
 | данные                   | `table`, `pagination`, `thread-list`, `detail-list`, `money-list`, `bar-list`, `timeline`, `night-grid`, `calendar`                            |
 | переписка                | `chat`, `message`, `message-composer`                                                                                                          |

package/src/lib/components/pdf-viewer/CONTEXT.md

@@ -0,0 +1,54 @@
+# `rt-pdf-viewer`
+
+Полноэкранный просмотр документа PDF. Открывается через [`RtDialogService`](../dialog/CONTEXT.md)
+из отдельного входа `@rt-tools/ui-kit-v2/pdf-viewer`.
+
+```typescript
+this.#dialog.open<RtPdfViewerComponent, IRtPdfViewer.Data, void>(RtPdfViewerComponent, {
+    data: { source: bytes, fileName: 'Договор.pdf' },
+});
+```
+
+Данные приходят токеном `RT_DIALOG_DATA`: `source` — байты (`Uint8Array`, `ArrayBuffer`) или
+адрес, `fileName` — имя в полосе и имя скачанного файла.
+
+## Главное, что нужно знать
+
+**Рисует `pdfjs-dist`, и он необязателен.** Пакет стоит в `peerDependenciesMeta` как optional и
+грузится динамическим `import()` только при открытии окна. Вход отдельный и корнем пакета не
+переотдаётся: из корня сборщик разрешал бы `import('pdfjs-dist')` каждому приложению, даже тому,
+кто просмотрщик не ставит.
+
+**Воркер приложение кладёт себе само.** Адрес по умолчанию — `assets/pdfjs/pdf.worker.min.mjs`
+от `<base href>`, другой задаётся `provideRtPdfViewer({ workerSrc })`. Файл копируется из того же
+`node_modules`: версии воркера и рисовальщика обязаны совпадать, и чужой адрес разошёлся бы с ними
+на первом же обновлении.
+
+**Рисуются только видимые страницы и по одной соседней.** Места под все страницы ставятся сразу,
+по размерам из документа, — прокрутка не прыгает. Холсты дальше трёх страниц от видимых очищаются.
+Холст рисуется в точках экрана (`devicePixelRatio`), а не в CSS-пикселях.
+
+**Масштаб «по ширине» — режим, а не число.** При смене ширины окна страница подстраивается заново.
+Узкое окно (до 768 включительно) и страница, которая в 100% не влезает, открываются «по ширине»,
+остальные — в 100%. Ступени — 50…300%; «по ширине» ими не зажат: на телефоне это около 45%, и
+«−» там уже выключен.
+
+**Печать — картинками, а не кадром с файлом.** Каждая страница рисуется в картинку 150 точек на
+дюйм и встаёт в лист в конце `<body>`; на время печати корень страницы получает признак
+`rt-pdf-viewer-printing`, и печатается только лист. Кадр `<iframe>` с самим файлом отвергнут:
+у мобильных браузеров встроенного показа PDF нет, а часть настольных печатает из такого кадра
+пустую или только первую страницу. Картинки печатает любой браузер. Лист убирается по
+`afterprint` и при закрытии окна.
+
+**Байты уходят рисовальщику копией.** Рисовальщик забирает буфер себе в поток, и без копии
+скачать файл после открытия было бы нечем.
+
+## Края
+
+- Документ, который не открылся (битый файл, рисовальщик не загрузился, воркер не найден), даёт
+  отказ по центру с кнопкой «Скачать»: файл всё равно у человека.
+- Скачивание адреса без загруженного документа отдаёт ссылку как есть — чужой домен может не
+  принять имя из `download`.
+- Фокус после закрытия возвращается туда, где стоял при открытии: просмотрщик помнит его сам и
+  не зависит от `restoreFocus` в настройке открытия.
+- Номер видимой страницы — та, что занимает больше высоты окна; в конце прокрутки — последняя.

package/src/lib/components/pdf-viewer/rt-pdf-viewer.component.scss

@@ -0,0 +1,231 @@
+@use '../../../styles/breakpoints' as bp;
+
+@layer rt-kit.components {
+    /* rt-pdf-viewer — ViewEncapsulation.None: правила таргетируют BEM-класс блока.
+       `.rt-pdf-viewer` — сам хост (шаблон начинается с ng-container, класс ставит host). */
+
+    .rt-pdf-viewer {
+        // Документ читают на тёмном в обеих темах: белый лист на светлой подложке теряет край.
+        // Поэтому цвета взяты со ступеней серого, а не с назначений темы, и стоят своими
+        // свойствами — потребитель перекрывает их правилом той же цели.
+        --rt-pdf-viewer-bg: var(--rt-neutral-900);
+        --rt-pdf-viewer-bar-bg: color-mix(in srgb, var(--rt-neutral-900) 35%, var(--rt-neutral-950));
+        --rt-pdf-viewer-bar-height: var(--rt-control-height-2xl);
+        --rt-pdf-viewer-text-color: var(--rt-neutral-0);
+        --rt-pdf-viewer-muted-color: var(--rt-neutral-200);
+        --rt-pdf-viewer-page-bg: var(--rt-neutral-0);
+        --rt-pdf-viewer-page-shadow: var(--rt-shadow-md);
+        --rt-pdf-viewer-page-gap: var(--rt-space-4);
+        --rt-pdf-viewer-toolbar-bg: var(--rt-neutral-800);
+        --rt-pdf-viewer-toolbar-radius: var(--rt-radius-full);
+        --rt-pdf-viewer-divider-width: var(--rt-border-width-thin);
+        --rt-pdf-viewer-divider-color: color-mix(in srgb, var(--rt-neutral-0) 20%, transparent);
+        --rt-pdf-viewer-control-radius: var(--rt-radius-md);
+        --rt-pdf-viewer-control-bg: color-mix(in srgb, var(--rt-neutral-0) 10%, transparent);
+        --rt-pdf-viewer-control-bg-hover: color-mix(in srgb, var(--rt-neutral-0) 24%, transparent);
+
+        display: block;
+        width: 100vw;
+        height: 100vh;
+        height: 100dvh;
+        background: var(--rt-pdf-viewer-bg);
+        color: var(--rt-pdf-viewer-text-color);
+
+        // Обёртка существует ради ловушки фокуса: display: contents ломает ловушку
+        &__surface {
+            position: absolute;
+            display: flex;
+            flex-direction: column;
+            inset: 0;
+        }
+
+        &__bar {
+            display: flex;
+            height: var(--rt-pdf-viewer-bar-height);
+            flex: none;
+            align-items: center;
+            justify-content: space-between;
+            padding: 0 var(--rt-space-4);
+            background: var(--rt-pdf-viewer-bar-bg);
+            gap: var(--rt-space-4);
+        }
+
+        // Имя файла сжимается первым: кнопки справа не уходят за край ни при каком имени
+        &__title {
+            display: flex;
+            min-width: 0;
+            align-items: center;
+            gap: var(--rt-space-2);
+        }
+
+        &__file-icon {
+            flex: none;
+            color: var(--rt-pdf-viewer-text-color);
+        }
+
+        // Обрезанное имя целиком видно в подсказке: оно же стоит в title
+        &__file-name {
+            overflow: hidden;
+            min-width: 0;
+            font-size: var(--rt-text-sm);
+            text-overflow: ellipsis;
+            white-space: nowrap;
+        }
+
+        &__actions {
+            display: flex;
+            flex: none;
+            align-items: center;
+            gap: var(--rt-space-2);
+        }
+
+        // Кнопки полосы — тот же вид управляющего элемента поверх тёмного, что у просмотра фото
+        &__actions rt-icon-button {
+            --rt-icon-button-color: var(--rt-pdf-viewer-text-color);
+            --rt-icon-button-color-bg-hover: var(--rt-pdf-viewer-control-bg-hover);
+
+            border-radius: var(--rt-pdf-viewer-control-radius);
+            background: var(--rt-pdf-viewer-control-bg);
+        }
+
+        &__scroller {
+            position: relative;
+            overflow: auto;
+            flex: 1 1 auto;
+            overscroll-behavior: contain;
+
+            // Место под полосу прокрутки занято с самого начала: «по ширине» меряется до того, как
+            // страницы встанут, и полоса, появившись после, давала бы прокрутку вбок
+            scrollbar-gutter: stable;
+        }
+
+        // Столбец шире окна, когда страница увеличена: иначе левый край листа уходил бы за край
+        // прокрутки и до него нельзя было бы дотянуться
+        &__column {
+            display: flex;
+            width: max-content;
+            min-width: 100%;
+            box-sizing: border-box;
+            flex-direction: column;
+            align-items: center;
+            padding: var(--rt-space-4) var(--rt-space-4) var(--rt-space-24);
+            gap: var(--rt-pdf-viewer-page-gap);
+        }
+
+        &__page {
+            flex: none;
+            background: var(--rt-pdf-viewer-page-bg);
+            box-shadow: var(--rt-pdf-viewer-page-shadow);
+        }
+
+        &__canvas {
+            display: block;
+            width: 100%;
+            height: 100%;
+        }
+
+        // Индикатор и отказ стоят по центру окна под полосой, поверх пустого столбца
+        &__center {
+            position: absolute;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            padding: var(--rt-space-4);
+            inset: var(--rt-pdf-viewer-bar-height) 0 0;
+        }
+
+        // Свойства заглушки объявлены на её же блоке — перекрываются правилом сильнее его
+        & &__error {
+            --rt-empty-state-title-color: var(--rt-pdf-viewer-text-color);
+
+            .rt-empty-state__description {
+                color: var(--rt-pdf-viewer-muted-color);
+            }
+        }
+
+        // Белая кнопка на тёмном: та же кнопка кита, перекрашенная своими свойствами
+        & &__error-download {
+            --rt-btn-bg: var(--rt-pdf-viewer-page-bg);
+            --rt-btn-bg-hover: var(--rt-neutral-100);
+            --rt-btn-bg-active: var(--rt-neutral-200);
+            --rt-btn-color: var(--rt-neutral-900);
+        }
+
+        &__toolbar {
+            position: absolute;
+            bottom: var(--rt-space-6);
+            left: 50%;
+            display: flex;
+            align-items: center;
+            padding: var(--rt-space-1) var(--rt-space-2);
+            border-radius: var(--rt-pdf-viewer-toolbar-radius);
+            background: var(--rt-pdf-viewer-toolbar-bg);
+            gap: var(--rt-space-1);
+            transform: translateX(-50%);
+            white-space: nowrap;
+        }
+
+        &__toolbar rt-icon-button {
+            --rt-icon-button-color: var(--rt-pdf-viewer-text-color);
+            --rt-icon-button-color-bg-hover: var(--rt-pdf-viewer-control-bg-hover);
+        }
+
+        &__counter,
+        &__zoom {
+            padding: 0 var(--rt-space-2);
+            font-size: var(--rt-text-sm);
+            font-variant-numeric: tabular-nums;
+        }
+
+        // Подпись масштаба не дёргает кнопки при смене «75%» на «100%»
+        &__zoom {
+            min-width: var(--rt-size-12);
+            text-align: center;
+        }
+
+        &__divider,
+        &__fit-divider {
+            width: var(--rt-pdf-viewer-divider-width);
+            height: var(--rt-size-5);
+            margin: 0 var(--rt-space-1);
+            background: var(--rt-pdf-viewer-divider-color);
+        }
+
+        & &__fit {
+            --rt-btn-color: var(--rt-pdf-viewer-text-color);
+            --rt-btn-bg-hover: var(--rt-pdf-viewer-control-bg-hover);
+        }
+
+        @media (width <= #{bp.$rt-bp-sm}) {
+            --rt-pdf-viewer-bar-height: var(--rt-control-height-xl);
+
+            &__fit,
+            &__fit-divider {
+                display: none;
+            }
+        }
+    }
+
+    /* Печатный лист: страницы картинками в конце <body>. Вне печати его не видно, а при печати
+       не видно ничего, кроме него, — ни полосы, ни плашки, ни страницы приложения под окном. */
+    .rt-pdf-viewer-print {
+        display: none;
+
+        &__page {
+            display: block;
+            width: 100%;
+            break-after: page;
+            break-inside: avoid;
+        }
+    }
+
+    @media print {
+        .rt-pdf-viewer-printing body > :not(.rt-pdf-viewer-print) {
+            display: none;
+        }
+
+        .rt-pdf-viewer-printing .rt-pdf-viewer-print {
+            display: block;
+        }
+    }
+}

package/src/rich-editor/lib/components/ai-chat/CONTEXT.md

@@ -53,6 +53,9 @@
   «Delete» — `danger`, отдаёт `deleteThread` без `confirmMessage`, подтверждение на приложении.
   Подписи — `uiMoreActions`, `aiCopyThreadId`, `uiRemove`. Пока панель открыта, действия строки
   видны: правило `:has(.rt-menu--open)` в `rt-thread-list`.
+- `--rt-ai-chat-content-max-width` (по умолчанию `100%`) становится боковым отступом `feed`,
+  `composer` и `disclaimer`: колонка стоит по центру беседы, полоса прокрутки ленты остаётся у её
+  края. `max-inline-size` на самой ленте увёл бы полосу прокрутки внутрь колонки.
 - Подсветка совпадений поиска по беседам — `splitSideMenuTitle`.
 - Строки-превью пустого списка бесед — `emptyPreviewIcons`, по умолчанию `sparkle`, `bot`, `sparkle`:
   беседы идут с ассистентом, а не с людьми. Вход уходит в `rt-thread-list` как есть.

package/src/rich-editor/lib/components/ai-chat/rt-ai-chat.component.scss

@@ -6,6 +6,7 @@
         --rt-ai-chat-bubble-radius: var(--rt-radius-xl);
         --rt-ai-chat-column-border-width: var(--rt-border-width-thin);
         --rt-ai-chat-column-width: 280px;
+        --rt-ai-chat-content-max-width: 100%;
         --rt-ai-chat-match-bg: var(--rt-yellow-400);
         --rt-ai-chat-match-color: var(--rt-neutral-950);
         --rt-ai-chat-match-radius: var(--rt-radius-xs);
@@ -91,11 +92,12 @@
             display: flex;
             flex: 1 1 auto;
             flex-direction: column;
-            padding: var(--rt-space-md);
             font-size: var(--rt-text-sm);
             gap: var(--rt-space-md);
             min-block-size: 0;
             overflow-y: auto;
+            padding-block: var(--rt-space-md);
+            padding-inline: max(var(--rt-space-md), calc((100% - var(--rt-ai-chat-content-max-width)) / 2));
         }
 
         &__spinner {
@@ -171,16 +173,18 @@
         &__composer {
             box-sizing: border-box;
             flex: none;
-            padding: var(--rt-space-sm) var(--rt-space-md) 0;
+            padding-block: var(--rt-space-sm) 0;
+            padding-inline: max(var(--rt-space-md), calc((100% - var(--rt-ai-chat-content-max-width)) / 2));
         }
 
         &__disclaimer {
             flex: none;
-            padding: var(--rt-space-xs) var(--rt-space-md) var(--rt-space-sm);
             margin: 0;
             color: var(--rt-color-text-muted);
             font-size: var(--rt-text-xs);
             line-height: var(--rt-leading-snug);
+            padding-block: var(--rt-space-xs) var(--rt-space-sm);
+            padding-inline: max(var(--rt-space-md), calc((100% - var(--rt-ai-chat-content-max-width)) / 2));
             text-align: center;
         }
 

package/types/rt-tools-ui-kit-v2-core.d.ts

@@ -539,6 +539,15 @@ export declare const RT_KIT_LABELS_EN: {
   readonly fieldErrorMinLength: "Value is too short";
   readonly fieldErrorPattern: "Invalid format";
   readonly fieldErrorRequired: "Required field";
+  readonly pdfViewerClose: "Close document";
+  readonly pdfViewerDownload: "Download";
+  readonly pdfViewerErrorText: "You can download the file and open it on your computer.";
+  readonly pdfViewerErrorTitle: "Couldn't show the document";
+  readonly pdfViewerFitWidth: "Fit to width";
+  readonly pdfViewerPageOf: "Page {{page}} of {{total}}";
+  readonly pdfViewerPrint: "Print";
+  readonly pdfViewerZoomIn: "Zoom in";
+  readonly pdfViewerZoomOut: "Zoom out";
   readonly photoViewerClose: "Close viewer";
   readonly photoViewerNext: "Next photo";
   readonly photoViewerPrev: "Previous photo";

package/types/rt-tools-ui-kit-v2-pdf-viewer.d.ts

@@ -0,0 +1,243 @@
+import * as i0 from "@angular/core";
+import { ElementRef, InjectionToken, Provider, Signal, WritableSignal } from "@angular/core";
+import { TRtKitLabelMap } from "@rt-tools/ui-kit-v2/core";
+/**
+ * Контракты полноэкранного просмотрщика документа PDF. Один корневой неймспейс с префиксом `I`.
+ */
+export declare namespace IRtPdfViewer {
+  /**
+   * Откуда взять документ: байты или адрес. Байты просмотрщик не отдаёт рисовальщику как есть —
+   * тот забирает буфер себе в поток, и скачать файл после этого было бы нечем. Отдаётся копия.
+   */
+  type Source = Uint8Array | ArrayBuffer | string;
+  /**
+   * Данные открытия: документ и имя файла.
+   *
+   * Имя показывается в полосе сверху и становится именем скачанного файла: адрес документа
+   * часто бывает подписанной ссылкой, и имени в нём нет.
+   */
+  interface Data {
+    readonly source: Source;
+    readonly fileName: string;
+  }
+  /** Что сейчас на месте страниц: индикатор, сами страницы или отказ. */
+  type Status = 'loading' | 'ready' | 'error';
+  /**
+   * Масштаб. «По ширине» хранится как режим, а не как число: окно меняет ширину, и страница
+   * обязана подстроиться под новую, а не остаться на числе, посчитанном для прежней.
+   */
+  type Zoom = {
+    readonly kind: 'fit';
+  } | {
+    readonly kind: 'percent';
+    readonly percent: number;
+  };
+  /** Размер страницы в пунктах документа — в единицах, в которых его пишет сам PDF. */
+  interface PageSize {
+    readonly width: number;
+    readonly height: number;
+  }
+  /** Размер места под страницу на экране, в CSS-пикселях. */
+  interface PageBox {
+    readonly index: number;
+    readonly width: number;
+    readonly height: number;
+  }
+  /**
+   * Настройки рисовальщика. Даёт их приложение через `provideRtPdfViewer()`: только оно знает,
+   * куда при сборке положен файл воркера.
+   */
+  interface Config {
+    /**
+     * Адрес файла воркера `pdf.worker.min.mjs`. Относительный адрес считается от `<base href>`
+     * страницы. Версия воркера обязана совпадать с версией `pdfjs-dist`, поэтому файл копируется
+     * из того же `node_modules`, а не берётся с чужого адреса.
+     */
+    readonly workerSrc: string;
+    /** Как загрузить рисовальщик. Умолчание — динамический `import('pdfjs-dist')`. */
+    readonly load: () => Promise<PdfJs>;
+    /** Каталог `cmaps/` пакета — нужен документам с азиатскими шрифтами без вложенных карт. */
+    readonly cMapUrl?: string;
+    /** Каталог `standard_fonts/` пакета — нужен документам на стандартных шрифтах без вложения. */
+    readonly standardFontDataUrl?: string;
+    /** Каталог `wasm/` пакета — нужен документам со снимками в JPEG 2000. */
+    readonly wasmUrl?: string;
+  }
+  /**
+   * Та часть `pdfjs-dist`, которой пользуется просмотрщик. Описана своими типами, а не взята из
+   * пакета: тогда типы кита не требуют пакета у того, кто просмотрщик не ставит, а в тесте
+   * рисовальщик подменяется объектом из нескольких функций.
+   */
+  interface PdfJs {
+    readonly GlobalWorkerOptions: {
+      workerSrc: string;
+    };
+    getDocument(params: DocumentParams): LoadingTask;
+  }
+  interface DocumentParams {
+    readonly url?: string;
+    readonly data?: Uint8Array;
+    readonly cMapUrl?: string;
+    readonly cMapPacked?: boolean;
+    readonly standardFontDataUrl?: string;
+    readonly wasmUrl?: string;
+  }
+  interface LoadingTask {
+    readonly promise: Promise<PdfDocument>;
+    destroy(): Promise<void>;
+  }
+  interface PdfDocument {
+    readonly numPages: number;
+    getPage(pageNumber: number): Promise<PdfPage>;
+    getData(): Promise<Uint8Array>;
+  }
+  interface PdfPage {
+    getViewport(params: {
+      scale: number;
+    }): Viewport;
+    render(params: RenderParams): RenderTask;
+  }
+  interface Viewport {
+    readonly width: number;
+    readonly height: number;
+  }
+  interface RenderParams {
+    readonly canvas: HTMLCanvasElement;
+    readonly viewport: Viewport;
+    readonly intent?: string;
+  }
+  interface RenderTask {
+    readonly promise: Promise<void>;
+    cancel(): void;
+  }
+  /** Печатный лист: разметка страниц картинками и уборка за ней. */
+  interface PrintSheet {
+    dispose(): void;
+  }
+}
+/**
+ * Полноэкранный просмотр документа PDF поверх `RtDialogService`.
+ *
+ * Страницы рисует `pdfjs-dist` — необязательная зависимость кита. Он грузится динамическим импортом
+ * только при открытии окна, поэтому вход `@rt-tools/ui-kit-v2/pdf-viewer` не утяжеляет бандл, пока
+ * окно не открыто. Рисуются только видимые страницы и их соседи, с плотностью точек экрана.
+ *
+ * `Esc`, блокировку прокрутки фона и затемнение даёт сам диалог; фокус после закрытия
+ * просмотрщик возвращает туда, откуда его открыли.
+ */
+export declare class RtPdfViewerComponent {
+  #private;
+  protected readonly t: Signal<TRtKitLabelMap>;
+  protected readonly scroller: Signal<ElementRef<HTMLElement> | undefined>;
+  protected readonly column: Signal<ElementRef<HTMLElement> | undefined>;
+  protected readonly pageNodes: Signal<readonly ElementRef<HTMLElement>[]>;
+  protected readonly canvases: Signal<readonly ElementRef<HTMLCanvasElement>[]>;
+  protected readonly fileName: string;
+  protected readonly status: WritableSignal<IRtPdfViewer.Status>;
+  protected readonly printing: WritableSignal<boolean>;
+  protected readonly zoom: WritableSignal<IRtPdfViewer.Zoom>;
+  /** Масштаб на экране в процентах — и для «по ширине», который хранится режимом */
+  protected readonly percent: Signal<number>;
+  protected readonly isFit: Signal<boolean>;
+  protected readonly zoomLabel: Signal<string>;
+  protected readonly canZoomIn: Signal<boolean>;
+  protected readonly canZoomOut: Signal<boolean>;
+  protected readonly boxes: Signal<IRtPdfViewer.PageBox[]>;
+  /** Видимая сейчас страница, с нуля */
+  protected readonly currentPage: WritableSignal<number>;
+  protected readonly counter: Signal<string>;
+  protected readonly pageOfLabel: Signal<string>;
+  constructor();
+  close(): void;
+  /** Esc закрывает только окно: окно под ним, например боковая панель, остаётся открытым */
+  protected onEscape(event: Event): void;
+  protected zoomIn(): void;
+  protected zoomOut(): void;
+  protected fitWidth(): void;
+  protected onScroll(): void;
+  protected onResize(): void;
+  /** Байты уходят как пришли, а адрес — байтами документа, если он уже загружен */
+  protected download(): Promise<void>;
+  /**
+   * Печать документа целиком, без полосы и плашки: страницы рисуются картинками в отдельный лист,
+   * и на время печати страница прячет всё, кроме него. Лист убирается после печати.
+   */
+  protected print(): Promise<void>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RtPdfViewerComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RtPdfViewerComponent, "rt-pdf-viewer", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Чистая логика просмотрщика документа: шаги масштаба, начальный масштаб, номер видимой страницы и
+ * то, какие страницы стоит держать нарисованными.
+ */
+/** Ступени масштаба в процентах. Кнопки «−» и «+» ходят только по ним. */
+export declare const RT_PDF_ZOOM_STEPS: readonly number[];
+export declare const RT_PDF_ZOOM_MIN: number;
+export declare const RT_PDF_ZOOM_MAX: number;
+/**
+ * Сколько CSS-пикселей в пункте документа. Пункт — 1/72 дюйма, CSS-пиксель — 1/96: при 100%
+ * страница A4 на экране той же ширины, что на бумаге.
+ */
+export declare const RT_PDF_CSS_UNITS: number;
+/** Ширина окна, до которой документ открывается «по ширине» при любом размере страницы. */
+export declare const RT_PDF_NARROW_WIDTH: number;
+/**
+ * Следующая ступень масштаба. Шаг идёт от того, что на экране сейчас: из «по ширине» в 83% кнопка
+ * «+» ведёт на 100%, а «−» — на 75%, а не на ступень, соседнюю с последней выбранной руками.
+ */
+export declare function nextZoomStep(current: number, direction: 1 | -1): number;
+/** Есть ли куда увеличивать: на верхней границе кнопка «+» выключена. */
+export declare function canZoomIn(current: number): boolean;
+/** Есть ли куда уменьшать: на нижней границе кнопка «−» выключена. */
+export declare function canZoomOut(current: number): boolean;
+/**
+ * Масштаб «по ширине» в процентах: самая широкая страница занимает всё место столбца.
+ *
+ * Границами ступеней он не зажат. На телефоне страница A4 «по ширине» — около 45%, и зажать её до
+ * 50% значило бы вернуть горизонтальную прокрутку, ради которой режим и существует.
+ */
+export declare function fitWidthPercent(availableWidth: number, pages: readonly IRtPdfViewer.PageSize[]): number;
+/**
+ * С какого масштаба открыть документ. Узкий экран и страница, которая в 100% не влезает, —
+ * «по ширине»: иначе человек сначала видит обрезанный край листа. Остальные — в 100%.
+ */
+export declare function initialZoom(viewportWidth: number, availableWidth: number, pages: readonly IRtPdfViewer.PageSize[]): IRtPdfViewer.Zoom;
+/** Места под страницы на экране: от размера в пунктах и масштаба, в целых пикселях. */
+export declare function pageBoxes(pages: readonly IRtPdfViewer.PageSize[], percent: number): IRtPdfViewer.PageBox[];
+/**
+ * Номер страницы, которая видна сейчас, — с нуля. Это та, что занимает больше всего высоты окна;
+ * при прокрутке до конца — последняя, даже если она короче соседки: иначе счётчик никогда не
+ * показал бы «M / M» у документа с маленькой последней страницей. Документ, который виден целиком
+ * без прокрутки, стоит на первой: до конца его никто не прокручивал.
+ */
+export declare function visiblePageIndex(tops: readonly number[], heights: readonly number[], scrollTop: number, viewportHeight: number): number;
+/**
+ * Страницы, которые стоит нарисовать: видимые и по `overscan` соседних с каждой стороны. Документ
+ * в сотню страниц разом не рисуется — каждая страница это холст в мегабайты памяти.
+ */
+export declare function pagesToRender(tops: readonly number[], heights: readonly number[], scrollTop: number, viewportHeight: number, overscan?: number): number[];
+/**
+ * Куда прокрутить после смены масштаба, чтобы на экране осталось то же место той же страницы.
+ * Без этого увеличение уводило бы человека на несколько страниц вниз от того, что он читал.
+ */
+export declare function anchoredScrollTop(oldTop: number, oldHeight: number, oldScrollTop: number, newTop: number, newHeight: number): number;
+/** Подпись масштаба для плашки в процентах: «83%», а не «83.47%». */
+export declare function zoomPercentLabel(percent: number): string;
+/**
+ * Адрес воркера по умолчанию. Относительный: считается от `<base href>`, поэтому приложение под
+ * своим префиксом не правит его руками. Файл туда кладёт сборка приложения — см. обзор компонента.
+ */
+export declare const RT_PDF_VIEWER_WORKER_SRC: string;
+/** Настройки рисовальщика просмотрщика. Без провайдера — умолчания выше. */
+export declare const RT_PDF_VIEWER_CONFIG: InjectionToken<IRtPdfViewer.Config>;
+/**
+ * Настраивает просмотрщик: адрес воркера и каталоги данных `pdfjs-dist`. Незаданное берётся из
+ * умолчаний.
+ *
+ * ```typescript
+ * export const appConfig: ApplicationConfig = {
+ *     providers: [provideRtPdfViewer({ workerSrc: 'static/pdf.worker.min.mjs' })],
+ * };
+ * ```
+ */
+export declare function provideRtPdfViewer(config: Partial<IRtPdfViewer.Config>): Provider;