oasis-editor 0.0.133 → 0.0.134

package/dist/app/controllers/createCropSession.d.ts

@@ -0,0 +1,26 @@
+import { EditorState } from '../../core/model.js';
+import { ResizeHandleDirection } from '../../ui/resizeGeometry.js';
+import { EditorHistoryState } from '../../ui/editorHistory.js';
+import { EditorLogger } from '../../utils/logger.js';
+
+export interface CropSessionDeps {
+    state: EditorState;
+    applyState: (next: EditorState) => void;
+    updateHistoryState: (updater: (current: EditorHistoryState) => EditorHistoryState) => void;
+    cloneState: (source: EditorState) => EditorState;
+    focusInput: () => void;
+    logger: EditorLogger;
+    /** Visual zoom factor `z`; pointer deltas (screen px) are divided by it. */
+    zoomFactor?: () => number;
+}
+/**
+ * Drives a handle-based image crop, mirroring {@link createResizeSession}: it
+ * tracks the pointer, resolves the next crop + displayed size via
+ * {@link resolveCroppedImage} from the captured start geometry each move (so
+ * rounding never accumulates), and snapshots the pre-crop state onto the undo
+ * stack on release.
+ */
+export declare function createCropSession(deps: CropSessionDeps): {
+    start: (paragraphId: string, paragraphOffset: number, handleDirection: ResizeHandleDirection, event: MouseEvent, initialState: EditorState) => void;
+    stop: () => void;
+};

package/dist/app/controllers/useEditorImageOperations.d.ts

@@ -39,6 +39,9 @@ export interface EditorImageOperationsDeps {
 export declare function createEditorImageOperations(deps: EditorImageOperationsDeps): ReturnType<typeof createEditorImageOperationsImpl>;
 declare function createEditorImageOperationsImpl(deps: EditorImageOperationsDeps): {
     dragging: import('solid-js').Accessor<boolean>;
+    cropMode: import('solid-js').Accessor<boolean>;
+    setCropMode: import('solid-js').Setter<boolean>;
+    toggleCropMode: () => void;
     draggedImageInfo: import('solid-js').Accessor<ActiveImageDrag | null>;
     mousePos: import('solid-js').Accessor<{
         x: number;
@@ -57,6 +60,7 @@ declare function createEditorImageOperationsImpl(deps: EditorImageOperationsDeps
     stopImageDrag: () => void;
     stopImageResize: () => void;
     stopImageRotate: () => void;
+    stopImageCrop: () => void;
     handleImageMouseDown: (paragraphId: string, paragraphOffset: number, event: MouseEvent & {
         currentTarget: HTMLElement;
     }) => void;
@@ -66,5 +70,8 @@ declare function createEditorImageOperationsImpl(deps: EditorImageOperationsDeps
     handleImageRotateHandleMouseDown: (paragraphId: string, paragraphOffset: number, event: MouseEvent & {
         currentTarget: HTMLElement;
     }) => void;
+    handleImageCropHandleMouseDown: (paragraphId: string, paragraphOffset: number, direction: ResizeHandleDirection, event: MouseEvent & {
+        currentTarget: HTMLElement;
+    }) => void;
 };
 export {};

package/dist/core/commands/builtinCommands.d.ts

@@ -1,2 +1,2 @@
-export declare const OASIS_BUILTIN_COMMANDS: readonly ["selectAll", "insertFootnote", "insertTableOfContents", "updateTableOfContents", "pastePlainText", "bold", "italic", "underline", "strike", "superscript", "subscript", "link", "unlink", "alignLeft", "alignCenter", "alignRight", "alignJustify", "orderedList", "bulletList", "find", "replace", "toggleTrackChanges", "acceptRevisions", "rejectRevisions", "toggleShowMargins", "toggleShowParagraphMarks", "togglePreciseFonts", "undo", "redo", "pageBreak", "lineBreak", "splitBlock", "setFontFamily", "setFontSize", "increaseFontSize", "decreaseFontSize", "changeTextCase", "clearFormatting", "setColor", "setHighlight", "setTextShading", "setStyleId", "setCharacterStyleId", "setUnderlineStyle", "documentStyles", "print", "copy", "exportDocx", "exportPdf", "importDocument", "insertImage", "editImageAlt", "insertImageCaption", "outdent", "indent", "togglePageBreakBefore", "toggleKeepWithNext", "setSpacingAfter", "setSpacingBefore", "setIndentLeft", "setIndentRight", "setIndentFirstLine", "setIndentHanging", "setSpecialIndent", "setParagraphShading", "applyParagraphBorders", "setLineHeight", "setListFormat", "setListStartAt", "toggleOrientation", "setOrientation", "sectionBreakNextPage", "sectionBreakContinuous", "setPageMargins", "tableContext", "tableMerge", "tableSplit", "tableInsertColumnBefore", "tableInsertColumnAfter", "tableDeleteColumn", "tableInsertRowBefore", "tableInsertRowAfter", "tableDeleteRow", "tableCellShading", "tableCellBorders", "tableCellNoBorders", "tableWidth100", "tableAlignLeft", "tableAlignCenter", "tableAlignRight", "tableSetCellWidth", "tableToggleHeaderRow", "tableToggleTotalRow", "tableToggleBandedRows", "tableToggleFirstColumn", "tableToggleLastColumn", "tableToggleBandedColumns", "setTableStyle", "tableToggleAutoFit", "tableDistributeColumns", "tableDistributeRows", "insertTable", "insertShape"];
+export declare const OASIS_BUILTIN_COMMANDS: readonly ["selectAll", "insertFootnote", "insertTableOfContents", "updateTableOfContents", "pastePlainText", "bold", "italic", "underline", "strike", "superscript", "subscript", "link", "unlink", "alignLeft", "alignCenter", "alignRight", "alignJustify", "orderedList", "bulletList", "find", "replace", "toggleTrackChanges", "acceptRevisions", "rejectRevisions", "toggleShowMargins", "toggleShowParagraphMarks", "togglePreciseFonts", "undo", "redo", "pageBreak", "lineBreak", "splitBlock", "setFontFamily", "setFontSize", "increaseFontSize", "decreaseFontSize", "changeTextCase", "clearFormatting", "setColor", "setHighlight", "setTextShading", "setStyleId", "setCharacterStyleId", "setUnderlineStyle", "documentStyles", "print", "copy", "exportDocx", "exportPdf", "importDocument", "insertImage", "editImageAlt", "insertImageCaption", "imageContext", "imageWidthCm", "imageHeightCm", "imageCrop", "imageCropAspect", "outdent", "indent", "togglePageBreakBefore", "toggleKeepWithNext", "setSpacingAfter", "setSpacingBefore", "setIndentLeft", "setIndentRight", "setIndentFirstLine", "setIndentHanging", "setSpecialIndent", "setParagraphShading", "applyParagraphBorders", "setLineHeight", "setListFormat", "setListStartAt", "toggleOrientation", "setOrientation", "sectionBreakNextPage", "sectionBreakContinuous", "setPageMargins", "tableContext", "tableMerge", "tableSplit", "tableInsertColumnBefore", "tableInsertColumnAfter", "tableDeleteColumn", "tableInsertRowBefore", "tableInsertRowAfter", "tableDeleteRow", "tableCellShading", "tableCellBorders", "tableCellNoBorders", "tableWidth100", "tableAlignLeft", "tableAlignCenter", "tableAlignRight", "tableSetCellWidth", "tableToggleHeaderRow", "tableToggleTotalRow", "tableToggleBandedRows", "tableToggleFirstColumn", "tableToggleLastColumn", "tableToggleBandedColumns", "setTableStyle", "tableToggleAutoFit", "tableDistributeColumns", "tableDistributeRows", "insertTable", "insertShape"];
 export type OasisBuiltinCommand = (typeof OASIS_BUILTIN_COMMANDS)[number];

package/dist/core/commands/image.d.ts

@@ -1,4 +1,4 @@
-import { EditorPosition, EditorState, EditorImageRunData } from '../model.js';
+import { EditorPosition, EditorState, EditorImageRunData, EditorImageCrop } from '../model.js';
 import { SelectedObjectRun } from './selectedObjectRun.js';
 import { WrapPreset } from './floatingLayout.js';
 
@@ -6,6 +6,42 @@ export type SelectedImageRun = SelectedObjectRun;
 export declare function getSelectedImageRun(state: EditorState): SelectedImageRun | null;
 export declare function insertImageAtSelection(state: EditorState, image: EditorImageRunData): EditorState;
 export declare function resizeSelectedImage(state: EditorState, width: number, height: number): EditorState;
+/** Displayed size of the selected image, in centimetres, or `null`. */
+export declare function getSelectedImageSizeCm(state: EditorState): {
+    width: number;
+    height: number;
+} | null;
+/**
+ * Sets the displayed width from a centimetre value, scaling the height by the
+ * current aspect ratio (Word locks aspect for pictures).
+ */
+export declare function setSelectedImageWidthCm(state: EditorState, cm: number): EditorState;
+/** Sets the displayed height from a centimetre value, scaling width to match. */
+export declare function setSelectedImageHeightCm(state: EditorState, cm: number): EditorState;
+/** Crop fractions of the selected image (`a:srcRect`), or `null`. */
+export declare function getSelectedImageCrop(state: EditorState): EditorImageCrop | null;
+export interface ImageCropUpdate {
+    crop: EditorImageCrop | null;
+    /** Optional new displayed width (px) — used when cropping shrinks the box. */
+    width?: number;
+    /** Optional new displayed height (px). */
+    height?: number;
+}
+/**
+ * Applies a crop (and optionally a new displayed size) to the selected image.
+ * Passing `crop: null` clears the crop. Round-trips to DOCX `a:srcRect`.
+ */
+export declare function setSelectedImageCrop(state: EditorState, update: ImageCropUpdate): EditorState;
+/** Aspect-ratio crop preset: a numeric `width/height` ratio, or `"reset"`. */
+export type ImageCropAspectMode = number | "reset";
+/**
+ * Computes a centred crop that makes the displayed box match `mode` (a
+ * `width/height` ratio), trimming the longer axis and shrinking that box
+ * dimension so the image is not distorted. `"reset"` clears the crop.
+ */
+export declare function computeImageAspectCrop(image: EditorImageRunData, mode: ImageCropAspectMode): ImageCropUpdate;
+/** Applies an aspect-ratio crop preset to the selected image. */
+export declare function applySelectedImageCropAspect(state: EditorState, mode: ImageCropAspectMode): EditorState;
 export declare function rotateSelectedImage(state: EditorState, rotation: number): EditorState;
 export declare function getSelectedImageWrapPreset(state: EditorState): WrapPreset | null;
 export declare function isSelectedImageFixedPosition(state: EditorState): boolean;

package/dist/core/commands/publicCommandTypes.d.ts

@@ -67,6 +67,11 @@ export interface OasisCommandPayloads {
     insertImage: undefined;
     editImageAlt: undefined;
     insertImageCaption: undefined;
+    imageContext: undefined;
+    imageWidthCm: number | string | null;
+    imageHeightCm: number | string | null;
+    imageCrop: undefined;
+    imageCropAspect: string;
     outdent: undefined;
     indent: undefined;
     togglePageBreakBefore: undefined;

package/dist/core/pluginUiTypes.d.ts

@@ -1,4 +1,4 @@
-export declare const RIBBON_TABS: readonly ["file", "home", "insert", "draw", "layout", "references", "collaboration", "protection", "view", "tableDesign", "tableLayout", "plugins", "ai"];
+export declare const RIBBON_TABS: readonly ["file", "home", "insert", "draw", "layout", "references", "collaboration", "protection", "view", "tableDesign", "tableLayout", "imageFormat", "plugins", "ai"];
 export type RibbonTabId = (typeof RIBBON_TABS)[number];
 /**
  * Contextual tabs are hidden from the tab strip unless their gating command

package/dist/core/transactionMergeKeys.d.ts

@@ -7,6 +7,8 @@ export declare const MERGE_KEYS: {
     readonly link: "link";
     readonly imageAlt: "imageAlt";
     readonly imageCaption: "imageCaption";
+    readonly imageResize: "imageResize";
+    readonly imageCrop: "imageCrop";
     readonly layoutWrapPolygon: "layoutWrapPolygon";
     readonly specialIndent: "specialIndent";
     readonly paraBorders: "paraBorders";

package/dist/export/pdf/writer/PdfContentStream.d.ts

@@ -34,4 +34,12 @@ export declare class PdfContentStream {
      */
     private emitGradientTextBlock;
     drawImage(options: OasisPdfImageOptions): void;
+    /**
+     * Draws a cropped image by clipping to the displayed box and scaling the full
+     * image so only the cropped sub-region fills it — mirroring the canvas/DOCX
+     * `a:srcRect` semantics. Works with rotation by mapping box-local space to the
+     * page (rotation about the box centre), clipping in that space, then drawing
+     * the enlarged image behind the clip.
+     */
+    private drawCroppedImage;
 }

package/dist/export/pdf/writer/pdfTypes.d.ts

@@ -165,6 +165,16 @@ export interface OasisPdfImageOptions {
     width: number;
     height: number;
     rotation?: number;
+    /**
+     * Crop fractions (0..1 trimmed per edge, matching `a:srcRect`). When present,
+     * only the cropped sub-region is shown, scaled to fill the box.
+     */
+    crop?: {
+        left?: number;
+        top?: number;
+        right?: number;
+        bottom?: number;
+    };
 }
 export type OasisPdfFontResource = OasisPdfBase14FontResource | OasisPdfUnicodeFontResource;
 export interface OasisPdfBase14FontResource {

package/dist/i18n/locales/en.d.ts

@@ -365,6 +365,7 @@ export declare const en: {
     "ribbon.tab.view": string;
     "ribbon.tab.tableDesign": string;
     "ribbon.tab.tableLayout": string;
+    "ribbon.tab.imageFormat": string;
     "ribbon.tab.plugins": string;
     "ribbon.tab.ai": string;
     "ribbon.group.clipboard": string;
@@ -387,6 +388,18 @@ export declare const en: {
     "ribbon.group.merge": string;
     "ribbon.group.cellSize": string;
     "ribbon.group.alignment": string;
+    "ribbon.group.size": string;
+    "image.crop": string;
+    "image.height": string;
+    "image.width": string;
+    "image.cropReset": string;
+    "image.cropRatio.square": string;
+    "image.cropRatio.16x9": string;
+    "image.cropRatio.4x3": string;
+    "image.cropRatio.3x2": string;
+    "image.cropRatio.2x3": string;
+    "image.cropRatio.3x4": string;
+    "image.cropRatio.9x16": string;
     "toolbar.exportDocx": string;
     "toolbar.exportPdf": string;
     "underline.style.single": string;

package/dist/i18n/locales/pt-BR.d.ts

@@ -365,6 +365,7 @@ export declare const ptBR: {
     "ribbon.tab.view": string;
     "ribbon.tab.tableDesign": string;
     "ribbon.tab.tableLayout": string;
+    "ribbon.tab.imageFormat": string;
     "ribbon.tab.plugins": string;
     "ribbon.tab.ai": string;
     "ribbon.group.clipboard": string;
@@ -387,6 +388,18 @@ export declare const ptBR: {
     "ribbon.group.merge": string;
     "ribbon.group.cellSize": string;
     "ribbon.group.alignment": string;
+    "ribbon.group.size": string;
+    "image.crop": string;
+    "image.height": string;
+    "image.width": string;
+    "image.cropReset": string;
+    "image.cropRatio.square": string;
+    "image.cropRatio.16x9": string;
+    "image.cropRatio.4x3": string;
+    "image.cropRatio.3x2": string;
+    "image.cropRatio.2x3": string;
+    "image.cropRatio.3x4": string;
+    "image.cropRatio.9x16": string;
     "toolbar.exportDocx": string;
     "toolbar.exportPdf": string;
     "underline.style.single": string;