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

package/dist/library/ImageControls.d.ts

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

package/dist/library/ImageManipulationOverlay.d.ts

@@ -0,0 +1,8 @@
+import { type RefObject } from 'react';
+export declare function ImageManipulationOverlay({ host, disabled, aspect, onError, documentKey }: {
+    host: RefObject<HTMLDivElement | null>;
+    disabled: boolean;
+    aspect: boolean;
+    onError: (error: string) => void;
+    documentKey: unknown;
+}): import("react").ReactPortal | null;

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

@@ -0,0 +1,30 @@
+import { type OoxmlNode, type OoxmlParagraphNode } from '@docx-editor.dev/core/store';
+import type { PaginatedSurface } from '@docx-editor.dev/core/editor';
+import { type SemanticPosition } from '@docx-editor.dev/core/layout';
+export declare const EMU_PER_CM = 360000;
+export declare const EMU_PER_PT = 12700;
+export declare const formatCm: (emu: number) => string;
+export declare function drawingSource(surface: PaginatedSurface, id: string): {
+    drawing: Extract<OoxmlNode, {
+        kind: 'drawing';
+    }>;
+    paragraph: OoxmlParagraphNode;
+    span: {
+        start: number;
+        end: number;
+    };
+    alone: boolean;
+} | null;
+export declare function imageSizeLimit(surface: PaginatedSurface, id: string): {
+    width: number;
+    height: number;
+};
+export declare function selectInlineImage(surface: PaginatedSurface, id: string, paragraphId: string): boolean;
+/** Delete and insert the same OOXML node in one guarded, undoable transaction. */
+export declare function moveInlineImage(surface: PaginatedSurface, id: string, target: SemanticPosition): import("@docx-editor.dev/core/editor").TreeApplyResult | {
+    rejected: boolean;
+    reason: string;
+} | {
+    reason?: undefined;
+    rejected: boolean;
+};

package/docs/inline-images.ru.md

@@ -1,5 +1,17 @@
 # Вставка изображений
 
+## Управление изображением
+
+Нажмите на изображение, чтобы открыть панель параметров и рамку с восемью маркерами. Размер можно менять за маркеры мышью либо задать ширину и высоту в сантиметрах и нажать «Применить размер». По умолчанию пропорции сохраняются; флажок позволяет менять стороны независимо. При вводе проверяется, что изображение помещается в область текста страницы или ячейки. Исходные размеры не округляются при одном лишь открытии панели.
+
+Чтобы перенести изображение, потяните его за середину рамки к нужной позиции текста. Синяя вертикальная линия показывает место вставки. Перенос выполняется внутри основного текста документа, в том числе между абзацами; запрет перемещения из исходного DOCX учитывается. Escape отменяет незавершённый жест. Каждый завершённый перенос или жест изменения размера отменяется одним Ctrl+Z и возвращается Ctrl+Y.
+
+В панели доступны выравнивание слева / по центру / справа (для изображения в отдельном абзаце), описание до 500 символов, замена PNG/JPEG с сохранением размеров и описания, удаление. При изменении размера или переносе байты изображения сохраняются; нормализация файла выполняется только при вставке и замене.
+
+Размеры сохраняются в HTML в pt, выравнивание — на абзаце, описание — в `alt`. Используется существующий контракт Hujjat, дополнительных endpoints и изменений БД для этих действий не требуется. Свободное размещение, обтекание, поворот и обрезка в эту панель не входят.
+
+## Загрузка и хранение
+
 Кнопка «Вставить изображение» добавляет PNG/JPEG в текущую позицию курсора. Вставка работает в абзацах, ячейках и полноэкранном редакторе, поддерживает отмену/повтор. Файл нормализуется перед вставкой: уменьшается разрешение и размер, удаляются метаданные; прозрачность PNG сохраняется.
 
 В текущем движке вставка внутри некоторых текстовых фрагментов ячейки ограничена. В таком случае редактор просит установить курсор в начале или конце текста ячейки; самопроизвольного перемещения изображения нет.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@makhmudov.kay/az-editor",
-  "version": "0.1.0-beta.13",
+  "version": "0.1.0-beta.14",
   "type": "module",
   "types": "./dist/library/index.d.ts",
   "sideEffects": [