@makhmudov.kay/az-editor 0.1.0-beta.11 → 0.1.0-beta.13

package/dist/library/EditorFrame.d.ts

@@ -5,4 +5,5 @@ export declare const EditorFrame: import("react").ForwardRefExoticComponent<Docx
     rulerUnit: 'cm' | 'inch';
     titleBar?: boolean;
     controls?: ReactNode;
+    imagesDisabled?: boolean;
 } & import("react").RefAttributes<DocxEditorRef>>;

package/dist/library/ImageInsertControl.d.ts

@@ -0,0 +1,5 @@
+import './image-insertion.css';
+export declare function ImageInsertControl({ disabled, documentKey }: {
+    disabled?: boolean;
+    documentKey: unknown;
+}): import("react").JSX.Element;

package/dist/library/hujjat/docx-images.d.ts

@@ -0,0 +1,11 @@
+import type JSZip from 'jszip';
+export declare const IMAGE_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+type Resource = {
+    src: string;
+} | {
+    error: string;
+};
+export declare function readDocxImages(zip: JSZip): Promise<Map<string, Resource>>;
+export declare function drawingHtml(element: Element, story: string, resources: Map<string, Resource>, loss: (code: string, message: string) => void): string;
+export declare function imageDrawing(id: number, rel: string, width: number, height: number, alt: string): string;
+export {};

package/dist/library/hujjat/image-resource.d.ts

@@ -0,0 +1,21 @@
+/** Shared bounded raster contract. Decoding pixels is done by the picker/server. */
+export declare const IMAGE_MAX_BYTES: number;
+export declare const IMAGE_MAX_COUNT = 32;
+export declare const IMAGE_MAX_EDGE = 4096;
+export declare const IMAGE_MAX_PIXELS: number;
+export type RasterInfo = {
+    mime: 'image/png' | 'image/jpeg';
+    width: number;
+    height: number;
+    orientation?: number;
+};
+export declare function readRaster(data: Uint8Array): RasterInfo;
+export declare function imageDataUri(data: Uint8Array, mime: RasterInfo['mime']): string;
+export declare function validateImageDataUri(src: string): RasterInfo & {
+    data: Uint8Array;
+};
+/** HTML dimensions are canonicalized to physical points before sending to Hujjat. */
+export declare function imageDimensions(element: Element, info: RasterInfo): {
+    width: number;
+    height: number;
+};

package/dist/library/image-insertion.d.ts

@@ -0,0 +1,8 @@
+/** Decode only bounded raster input, apply EXIF orientation, and strip metadata. */
+export declare function prepareImageFile(file: File, signal: AbortSignal): Promise<{
+    data: Uint8Array<ArrayBuffer>;
+    mime: "image/jpeg" | "image/png";
+    widthPoints: number;
+    heightPoints: number;
+    description: string;
+}>;

package/docs/inline-images.ru.md

@@ -0,0 +1,21 @@
+# Вставка изображений
+
+Кнопка «Вставить изображение» добавляет PNG/JPEG в текущую позицию курсора. Вставка работает в абзацах, ячейках и полноэкранном редакторе, поддерживает отмену/повтор. Файл нормализуется перед вставкой: уменьшается разрешение и размер, удаляются метаданные; прозрачность PNG сохраняется.
+
+В текущем движке вставка внутри некоторых текстовых фрагментов ячейки ограничена. В таком случае редактор просит установить курсор в начале или конце текста ячейки; самопроизвольного перемещения изображения нет.
+
+В HTML сохраняется `<img src="data:image/png;base64,..." alt="Описание" style="width:72pt;height:36pt">` (также `image/jpeg`). Байты принадлежат версии шаблона Hujjat: отдельный ресурс, публичный URL и endpoint загрузки не создаются. Экспорт JSON и сохранение старых версий включают изображения; доступ совпадает с доступом к соответствующему шаблону/документу.
+
+Контракт библиотеки и Hujjat:
+
+- PNG/JPEG, до 256 КиБ на изображение после нормализации; до 4096 пикселей по каждой стороне и 16 Мп. До 32 изображений в HTML-фрагменте.
+- Общий HTML остаётся ограничен 1 МиБ на тело и 100 КиБ на колонтитул, включая base64 (примерно на треть больше бинарных данных). При превышении сохранение выдаёт ошибку; изображения не удаляются автоматически.
+- Размеры от 1 EMU (1/12700 pt — минимальная единица DOCX) до 600 pt; API получает канонические `width`/`height` в pt. Описание `alt` — до 500 символов.
+- Встроенное размещение в строке, включая таблицы и общие колонтитулы. Выравнивание задаётся абзацем. Внешние URL, пути файлов, SVG, анимация, обтекание, обрезка, повороты и эффекты не входят в контракт. Для изменённого рисунка сначала примените преобразования к файлу и вставьте его заново.
+- Сервер проверяет фактический формат и декодирование изображения. Некорректные изображения при сохранении шаблона отклоняются с ошибкой валидации.
+
+DOCX хранит бинарные media parts и отдельные relationships для тела/колонтитула. Экспорт в HTML переносит те же байты и размеры; импорт восстанавливает inline drawing. Неподдерживаемые объекты дают явную диагностику потери. mPDF читает только проверенный встроенный ресурс этого контракта, без сетевого запроса.
+
+Уже встроенное в Word изображение не нужно вставлять заново. Его физический размер берётся из `wp:extent` (12700 EMU = 1 pt), а не из разрешения PNG/JPEG. Явное отсутствие заливки/линии и остаточные `effectExtent` без фактического эффекта допустимы; обрезка, видимая рамка и тень по-прежнему требуют предварительного преобразования изображения. Исправление библиотеки доступно с `0.1.0-beta.13`; для серверного DOCX-импорта также необходимы соответствующие изменения Hujjat.
+
+Для включения необходимы новая сборка библиотеки **и** изменения Hujjat: старый sanitizer удаляет `img`. Изменений схемы БД не требуется. Agrodox передаёт HTML существующим сохранением и предпросмотром PDF; опубликованную зависимость нужно обновить после выпуска новой версии библиотеки.

package/docs/integration.ru.md

@@ -1,6 +1,6 @@
 # Интеграция Az Editor в React-приложение
 
-Руководство описывает API `@makhmudov.kay/az-editor` версии `0.1.0-beta.11`.
+Руководство описывает API `@makhmudov.kay/az-editor` версии `0.1.0-beta.13`.
 Поддержка серверного `page`, описанная ниже, добавлена в beta.5.
 Совместимые исправления разрывов и строк таблиц добавлены в beta.6 и описаны ниже.
 Исправление общей сетки таблиц и более строгая диагностика размеров добавлены в beta.7.
@@ -129,7 +129,7 @@ npm install @makhmudov.kay/az-editor@beta
 Для фиксации опубликованной версии:
 
 ```sh
-npm install --save-exact @makhmudov.kay/az-editor@0.1.0-beta.11
+npm install --save-exact @makhmudov.kay/az-editor@0.1.0-beta.13
 ```
 
 Тег `beta` может указывать на более новую версию. Сохраняйте lockfile и проверяйте
@@ -985,12 +985,13 @@ export default function Page() {
 ```text
 div p span br hr b strong i em u s sub sup
 h1 h2 h3 h4 h5 h6 ul ol li
-table thead tbody tfoot tr td th
+table thead tbody tfoot tr td th img
 ```
 
 Сохраняются разрешённые inline-стили и `colspan`/`rowspan` ячеек в пределах 1–100.
 Произвольные `class`, `id`, обработчики событий и `data-*` в контракт не входят.
-`a` превращается в текст: ссылка как ссылка не сохраняется. `img`, `svg`, `script`,
+PNG/JPEG сохраняются как встроенные data URI: до 256 КиБ на изображение, 4096 пикселей по стороне, 32 изображения; общий лимит HTML учитывает base64. Размеры — положительные `width`/`height` в pt, до 600 pt. Нужен обновлённый sanitizer Hujjat. Подробнее: [вставка изображений](inline-images.ru.md).
+`a` превращается в текст: ссылка как ссылка не сохраняется. `svg`, `script`,
 `style`, `iframe`, формы и медиа удаляются с диагностикой потери.
 
 CSS ограничен шрифтом/цветом, базовым оформлением, выравниванием, интервалами,
@@ -1006,7 +1007,8 @@ CSS ограничен шрифтом/цветом, базовым оформл
 | Простой bullet/decimal список | Поддерживается |
 | Многоуровневая нумерация, нестандартный старт/продолжение | Возможны потери; атрибут `start` удаляется |
 | Явный разрыв страницы | Передаётся, автоматическая пагинация рассчитывается заново |
-| Картинки, фигуры, текстовые блоки | Не входят в HTML-контракт |
+| Строчные PNG/JPEG | Встроены в HTML как проверенные data URI с размерами в pt |
+| Плавающие картинки, фигуры, текстовые блоки | Не входят в HTML-контракт |
 | Общие колонтитулы | Через `page.header/footer`; разные варианты требуют отдельного решения |
 | Сноски, комментарии, исправления, поля | Не сохраняются как интерактивные HTML-объекты |
 | Скрытый текст | Не раскрывается при экспорте; удаление требует принятия потерь |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@makhmudov.kay/az-editor",
-  "version": "0.1.0-beta.11",
+  "version": "0.1.0-beta.13",
   "type": "module",
   "types": "./dist/library/index.d.ts",
   "sideEffects": [
@@ -17,6 +17,7 @@
   "files": [
     "dist",
     "docs/integration.ru.md",
+    "docs/inline-images.ru.md",
     "docs/layout-metadata-v1.ru.md",
     "CHANGELOG.md",
     "examples/integration",