oasis-editor 0.0.149 → 0.0.151

package/dist/plugins/internal/essentialsCapabilities.d.ts

@@ -120,6 +120,16 @@ export interface EssentialsImageCapability {
     toggleCrop: () => void;
     /** Apply an aspect-ratio crop preset (e.g. "16:9", "1:1", "reset"). */
     applyCropAspect: (preset: string) => void;
+    /** Current DrawingML picture mask preset, or `null` for a rectangle. */
+    getCropShape: () => string | null;
+    /** Apply/remove a DrawingML picture mask preset. */
+    applyCropShape: (preset: string) => void;
+    /** Fill the current picture frame by cropping the source. */
+    applyCropFill: () => void;
+    /** Fit the complete source image inside the current picture frame. */
+    applyCropFit: () => void;
+    /** Clear source crop, fit/fill mode and picture mask. */
+    resetCrop: () => void;
     /** Outline of the selected image (`pic:spPr/a:ln`), or `null`. */
     getBorder: () => EditorImageBorder | null;
     /** Merge a partial outline edit; `{ color: null }` removes the outline. */

package/dist/ui/OasisEditorEditorProps.d.ts

@@ -71,6 +71,9 @@ export interface OasisEditorEditorSurfaceHandlers {
     onImageCropHandleMouseDown?: (paragraphId: string, paragraphOffset: number, direction: ResizeHandleDirection, event: MouseEvent & {
         currentTarget: HTMLElement;
     }) => void;
+    onImageCropBodyMouseDown?: (paragraphId: string, paragraphOffset: number, event: MouseEvent & {
+        currentTarget: HTMLElement;
+    }) => void;
     onTextBoxRotateHandleMouseDown: (paragraphId: string, paragraphOffset: number, event: MouseEvent & {
         currentTarget: HTMLElement;
     }) => void;

package/dist/ui/app/buildEditorViewProps.d.ts

@@ -61,6 +61,7 @@ export interface EditorViewSurfaceInput {
     handleTextBoxResizeHandleMouseDown: OasisEditorEditorSurfaceHandlers["onTextBoxResizeHandleMouseDown"];
     handleImageRotateHandleMouseDown: OasisEditorEditorSurfaceHandlers["onImageRotateHandleMouseDown"];
     handleImageCropHandleMouseDown: NonNullable<OasisEditorEditorSurfaceHandlers["onImageCropHandleMouseDown"]>;
+    handleImageCropBodyMouseDown: NonNullable<OasisEditorEditorSurfaceHandlers["onImageCropBodyMouseDown"]>;
     handleTextBoxRotateHandleMouseDown: OasisEditorEditorSurfaceHandlers["onTextBoxRotateHandleMouseDown"];
     handleEditorContextMenu: (event: MouseEvent) => void;
 }

package/dist/ui/app/createAppCommandsController.d.ts

@@ -72,6 +72,10 @@ declare function createAppCommandsControllerImpl(deps: AppCommandsControllerDeps
         applyImageWidthCmCommand: (cm: number) => void;
         applyImageHeightCmCommand: (cm: number) => void;
         applyImageCropAspectCommand: (preset: string) => void;
+        applyImageCropShapeCommand: (preset: string) => void;
+        applyImageCropFillCommand: () => void;
+        applyImageCropFitCommand: () => void;
+        resetImageCropCommand: () => void;
         applyImageBorderCommand: (patch: import('../../core/commands/image.js').ImageBorderPatch) => void;
         handleListTab: (direction: "indent" | "outdent") => boolean;
         handleListEnter: () => boolean;
@@ -110,6 +114,10 @@ declare function createAppCommandsControllerImpl(deps: AppCommandsControllerDeps
         applyImageWidthCmCommand: (cm: number) => void;
         applyImageHeightCmCommand: (cm: number) => void;
         applyImageCropAspectCommand: (preset: string) => void;
+        applyImageCropShapeCommand: (preset: string) => void;
+        applyImageCropFillCommand: () => void;
+        applyImageCropFitCommand: () => void;
+        resetImageCropCommand: () => void;
         applyImageBorderCommand: (patch: import('../../core/commands/image.js').ImageBorderPatch) => void;
         handleListTab: (direction: "indent" | "outdent") => boolean;
         handleListEnter: () => boolean;

package/dist/ui/app/createEditorCommandRuntime.d.ts

@@ -105,6 +105,10 @@ declare function createEditorCommandRuntimeImpl(deps: EditorCommandRuntimeDeps):
         applyImageWidthCmCommand: (cm: number) => void;
         applyImageHeightCmCommand: (cm: number) => void;
         applyImageCropAspectCommand: (preset: string) => void;
+        applyImageCropShapeCommand: (preset: string) => void;
+        applyImageCropFillCommand: () => void;
+        applyImageCropFitCommand: () => void;
+        resetImageCropCommand: () => void;
         applyImageBorderCommand: (patch: import('../../core/commands/image.js').ImageBorderPatch) => void;
         handleListTab: (direction: "indent" | "outdent") => boolean;
         handleListEnter: () => boolean;

package/dist/ui/app/createEditorInteractionRuntime.d.ts

@@ -124,6 +124,9 @@ declare function createEditorInteractionRuntimeImpl(deps: EditorInteractionRunti
         handleImageCropHandleMouseDown: (paragraphId: string, paragraphOffset: number, direction: import('../resizeGeometry.js').ResizeHandleDirection, event: MouseEvent & {
             currentTarget: HTMLElement;
         }) => void;
+        handleImageCropBodyMouseDown: (paragraphId: string, paragraphOffset: number, event: MouseEvent & {
+            currentTarget: HTMLElement;
+        }) => void;
     };
     textBoxOps: {
         handleTextBoxResizeHandleMouseDown: (paragraphId: string, paragraphOffset: number, direction: import('../resizeGeometry.js').ResizeHandleDirection, event: MouseEvent & {

package/dist/ui/cropGeometry.d.ts

@@ -16,8 +16,9 @@ export interface CropResult {
 }
 /**
  * Resolves the next crop + displayed size for a crop-handle drag. `deltaX`/
- * `deltaY` are pointer deltas in document px (already divided by zoom). Growing
- * a side is bounded by that side's original crop (you cannot un-crop past the
- * source image).
+ * `deltaY` are pointer deltas in document px (already divided by zoom). The
+ * display dimensions follow the handle so the source image keeps its scale.
  */
 export declare function resolveCroppedImage(geometry: CropSessionGeometry, deltaX: number, deltaY: number): CropResult;
+/** Moves the source image inside the fixed crop frame. */
+export declare function resolveMovedImageCrop(geometry: CropSessionGeometry, deltaX: number, deltaY: number): CropResult;

package/dist/ui/overlays/ImageCropPreviewOverlay.d.ts

@@ -0,0 +1,16 @@
+import { JSX } from 'solid-js';
+import { EditorImageRunData } from '../../core/model.js';
+
+export interface ImageCropPreviewOverlayProps {
+    box: () => {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    } | null;
+    image: () => EditorImageRunData | null;
+    src: () => string;
+    rotation: () => number;
+}
+/** Shows the uncropped source below the crop mask, as Word does while editing. */
+export declare function ImageCropPreviewOverlay(props: ImageCropPreviewOverlayProps): JSX.Element;

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "oasis-editor",
-  "version": "0.0.149",
+  "version": "0.0.151",
+  "license": "MIT",
   "type": "module",
   "repository": {
     "type": "git",