oasis-editor 0.0.133 → 0.0.134

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

@@ -90,6 +90,21 @@ export interface EssentialsImageCapability {
     promptAlt: () => void;
     promptCaption: () => void;
     isSelected: () => boolean;
+    /** Displayed size of the selected image in centimetres, or `null`. */
+    getSizeCm: () => {
+        width: number;
+        height: number;
+    } | null;
+    /** Set the displayed width (cm), scaling height to keep the aspect ratio. */
+    setWidthCm: (cm: number) => void;
+    /** Set the displayed height (cm), scaling width to keep the aspect ratio. */
+    setHeightCm: (cm: number) => void;
+    /** Whether interactive crop mode is currently active. */
+    isCropActive: () => boolean;
+    /** Toggle interactive crop mode for the selected image. */
+    toggleCrop: () => void;
+    /** Apply an aspect-ratio crop preset (e.g. "16:9", "1:1", "reset"). */
+    applyCropAspect: (preset: string) => void;
 }
 export interface EssentialsBrowserCapability {
     print: () => void;

package/dist/ui/OasisEditorEditorProps.d.ts

@@ -31,6 +31,8 @@ export interface OasisEditorEditorOverlayProps {
     focused: Accessor<boolean>;
     showCaret: Accessor<boolean>;
     importProgress?: Accessor<ImportProgress | null>;
+    /** Whether interactive image crop mode is active (shows crop handles). */
+    imageCropMode?: Accessor<boolean>;
     toolbarHost?: () => ToolbarHost;
     persistenceStatus?: () => string;
     showFloatingTableToolbar?: Accessor<boolean>;
@@ -66,6 +68,9 @@ export interface OasisEditorEditorSurfaceHandlers {
     onImageRotateHandleMouseDown: (paragraphId: string, paragraphOffset: number, event: MouseEvent & {
         currentTarget: HTMLElement;
     }) => void;
+    onImageCropHandleMouseDown?: (paragraphId: string, paragraphOffset: number, direction: ResizeHandleDirection, event: MouseEvent & {
+        currentTarget: HTMLElement;
+    }) => void;
     onTextBoxRotateHandleMouseDown: (paragraphId: string, paragraphOffset: number, event: MouseEvent & {
         currentTarget: HTMLElement;
     }) => void;

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

@@ -35,6 +35,7 @@ export interface EditorViewOverlayInput {
     focused: Accessor<boolean>;
     showCaret: Accessor<boolean>;
     importProgress: Accessor<ImportProgress | null>;
+    imageCropMode: Accessor<boolean>;
 }
 /** Owner of the editor element refs. */
 export interface EditorViewRefsInput {
@@ -58,6 +59,7 @@ export interface EditorViewSurfaceInput {
     handleImageResizeHandleMouseDown: OasisEditorEditorSurfaceHandlers["onImageResizeHandleMouseDown"];
     handleTextBoxResizeHandleMouseDown: OasisEditorEditorSurfaceHandlers["onTextBoxResizeHandleMouseDown"];
     handleImageRotateHandleMouseDown: OasisEditorEditorSurfaceHandlers["onImageRotateHandleMouseDown"];
+    handleImageCropHandleMouseDown: NonNullable<OasisEditorEditorSurfaceHandlers["onImageCropHandleMouseDown"]>;
     handleTextBoxRotateHandleMouseDown: OasisEditorEditorSurfaceHandlers["onTextBoxRotateHandleMouseDown"];
     handleEditorContextMenu: (event: MouseEvent) => void;
 }

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

@@ -69,6 +69,9 @@ declare function createAppCommandsControllerImpl(deps: AppCommandsControllerDeps
         promptForImageAlt: () => void;
         applyImageCaptionCommand: (caption: string) => void;
         promptForImageCaption: () => void;
+        applyImageWidthCmCommand: (cm: number) => void;
+        applyImageHeightCmCommand: (cm: number) => void;
+        applyImageCropAspectCommand: (preset: string) => void;
         handleListTab: (direction: "indent" | "outdent") => boolean;
         handleListEnter: () => boolean;
         handleListBoundaryBackspace: (event: KeyboardEvent & {
@@ -103,6 +106,9 @@ declare function createAppCommandsControllerImpl(deps: AppCommandsControllerDeps
         promptForImageAlt: () => void;
         applyImageCaptionCommand: (caption: string) => void;
         promptForImageCaption: () => void;
+        applyImageWidthCmCommand: (cm: number) => void;
+        applyImageHeightCmCommand: (cm: number) => void;
+        applyImageCropAspectCommand: (preset: string) => void;
         handleListTab: (direction: "indent" | "outdent") => boolean;
         handleListEnter: () => boolean;
         handleListBoundaryBackspace: (event: KeyboardEvent & {

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

@@ -84,6 +84,9 @@ declare function createEditorCommandRuntimeImpl(deps: EditorCommandRuntimeDeps):
         promptForImageAlt: () => void;
         applyImageCaptionCommand: (caption: string) => void;
         promptForImageCaption: () => void;
+        applyImageWidthCmCommand: (cm: number) => void;
+        applyImageHeightCmCommand: (cm: number) => void;
+        applyImageCropAspectCommand: (preset: string) => void;
         handleListTab: (direction: "indent" | "outdent") => boolean;
         handleListEnter: () => boolean;
         handleListBoundaryBackspace: (event: KeyboardEvent & {

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

@@ -89,6 +89,9 @@ declare function createEditorInteractionRuntimeImpl(deps: EditorInteractionRunti
     };
     imageOps: {
         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<import('../../app/controllers/useEditorImageOperations.js').ActiveImageDrag | null>;
         mousePos: import('solid-js').Accessor<{
             x: number;
@@ -107,6 +110,7 @@ declare function createEditorInteractionRuntimeImpl(deps: EditorInteractionRunti
         stopImageDrag: () => void;
         stopImageResize: () => void;
         stopImageRotate: () => void;
+        stopImageCrop: () => void;
         handleImageMouseDown: (paragraphId: string, paragraphOffset: number, event: MouseEvent & {
             currentTarget: HTMLElement;
         }) => void;
@@ -116,6 +120,9 @@ declare function createEditorInteractionRuntimeImpl(deps: EditorInteractionRunti
         handleImageRotateHandleMouseDown: (paragraphId: string, paragraphOffset: number, event: MouseEvent & {
             currentTarget: HTMLElement;
         }) => void;
+        handleImageCropHandleMouseDown: (paragraphId: string, paragraphOffset: number, direction: import('../resizeGeometry.js').ResizeHandleDirection, event: MouseEvent & {
+            currentTarget: HTMLElement;
+        }) => void;
     };
     textBoxOps: {
         handleTextBoxResizeHandleMouseDown: (paragraphId: string, paragraphOffset: number, direction: import('../resizeGeometry.js').ResizeHandleDirection, event: MouseEvent & {

package/dist/ui/app/essentials/types.d.ts

@@ -29,6 +29,11 @@ export interface CreateEditorEssentialsPluginOptions {
     importInputRef: () => HTMLInputElement | undefined;
     imageInputRef: () => HTMLInputElement | undefined;
     selectedImageRun: () => SelectedImageRun | null;
+    /** Interactive image crop-mode signal (owned by the image operations). */
+    imageCropMode: {
+        isActive: () => boolean;
+        toggle: () => void;
+    };
     selectionBoxes: () => Array<unknown>;
     focusInput: () => void;
     applyState: (nextState: EditorState) => void;

package/dist/ui/components/Toolbar/controls/ImageSizeControls.d.ts

@@ -0,0 +1,16 @@
+import { JSX } from 'solid-js';
+import { ToolbarActionApi } from '../schema/items.js';
+
+/**
+ * A labelled centimetre field for the image Size group (height or width). Reads
+ * the current size from the `imageHeightCm`/`imageWidthCm` command and writes it
+ * back on change; the core keeps the aspect ratio locked.
+ */
+export declare function ImageSizeField(props: {
+    api: ToolbarActionApi;
+    dimension: "height" | "width";
+}): JSX.Element;
+/** The Cortar chevron menu: toggle crop mode + aspect-ratio presets. */
+export declare function ImageCropMenu(props: {
+    api: ToolbarActionApi;
+}): JSX.Element;

package/dist/ui/cropGeometry.d.ts

@@ -0,0 +1,23 @@
+import { ResizeHandleDirection } from './resizeGeometry.js';
+import { EditorImageCrop } from '../core/model.js';
+
+export interface CropSessionGeometry {
+    handleDirection: ResizeHandleDirection;
+    /** Displayed box size (px) captured when the handle was grabbed. */
+    startWidth: number;
+    startHeight: number;
+    /** Crop fractions captured when the handle was grabbed. */
+    startCrop: EditorImageCrop;
+}
+export interface CropResult {
+    crop: EditorImageCrop;
+    width: number;
+    height: number;
+}
+/**
+ * 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).
+ */
+export declare function resolveCroppedImage(geometry: CropSessionGeometry, deltaX: number, deltaY: number): CropResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oasis-editor",
-  "version": "0.0.133",
+  "version": "0.0.134",
   "type": "module",
   "repository": {
     "type": "git",