oasis-editor 0.0.133 → 0.0.134

package/dist/{OasisEditorApp-DmXn9H33.js → OasisEditorApp-B2f15Gpe.js}

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import { E as EMPTY_PROJECTION_CONTEXT, d as domTextMeasurer, g as getProjectedParagraphBlockHeight, e as estimateTableBlockHeight, p as projectParagraphLayout, a as getPageBodyBottom, b as getPageBodyTop, c as getPageContentWidth, F as FOOTNOTE_MARKER_GUTTER_PX, f as getParagraphText, h as getBlockParagraphs, i as getRunFootnoteReference, l as listReferencedEndnotes, j as getFootnoteDisplayMarker, k as createProjectionContext, m as getDocumentSections, n as getRunField, o as projectBlocksLayout, v as visitRun, q as assertNever, r as createSignal, s as createEditorStateFromDocument, t as createInitialEditorState, S as STANDARD_FONT_SIZES_PT, u as fontSizePxToPt, w as probeLocalFontFamilies, x as createEditorParagraphFromRuns, y as isInlineObjectRun, z as createEditorStyledRun, A as getParagraphLength, B as getActiveZone, C as getActiveSectionIndex, D as getParagraphs, G as normalizeSelection, H as positionToParagraphOffset, I as paragraphOffsetToPosition, J as clampPosition, K as findParagraphIndex, L as createCollapsedSelection, M as isSelectionCollapsed, N as parseFontSizePtToPx, O as formatFontSizePt, P as createEditorParagraph, Q as resolveDefaultParagraphStyleId, R as findParagraphTableLocation, T as buildTableCellLayout, U as PT_PER_PX, V as createEditorTableCell, W as createEditorTableRow, X as createEditorTable, Y as PX_PER_POINT, Z as underlineStyleToCssDecorationStyle, _ as resolveImageSrc, $ as listKindForTag, a0 as isParagraphTag, a1 as collectInlineRuns, a2 as parseParagraphStyle, a3 as getRunImage, a4 as InlineShell, a5 as BalloonShell, a6 as DocumentShell, a7 as createMemo, a8 as getCaretRectFromSnapshot, a9 as getParagraphRectFromSnapshot, aa as createComponent, ab as CaretOverlay, ac as Show, ad as createRenderEffect, ae as style, af as setStyleProperty, ag as setAttribute, ah as memo, ai as template, aj as Button, ak as useI18n, al as createEffect, am as TextField, an as Dialog, ao as insert, ap as className, aq as Grid, ar as SelectField, as as StatusText, at as ColorField, au as UNDERLINE_STYLE_OPTIONS, av as Stack, aw as For, ax as ToggleChip, ay as FormField, az as Checkbox, aA as FieldGroup, aB as Tabs, aC as NumberField, aD as parseNumber, aE as createStore, aF as reconcile, aG as RadioGroup, aH as Radio$1, aI as TextAreaField, aJ as Text, aK as SurfaceButton, aL as delegateEvents, aM as onMount, aN as onCleanup, aO as CheckIcon, aP as use, aQ as PluginUiHost, aR as OasisEditorEditor, aS as OasisBrandMark, aT as setPreciseFontPreference, aU as setWelcomeSeen, aV as enablePreciseFontMode, aW as TWIPS_PER_POINT, aX as PX_PER_INCH, aY as TWIPS_PER_INCH, aZ as normalizeHex6, a_ as TABLE_CONDITIONAL_FLAG_ATTRIBUTES, a$ as TABLE_BORDER_EDGE_KEYS, b0 as resolveEffectiveParagraphStyle, b1 as resolveEffectiveTextStyleForParagraph, b2 as EMU_PER_PT, b3 as OOXML_ROTATION_UNITS, b4 as OOXML_PERCENT_DENOMINATOR, b5 as parseHexColorToRgb255, b6 as EMU_PER_PX, b7 as getRunEndnoteReference, b8 as iterateFootnoteReferenceRuns, b9 as iterateEndnoteReferenceRuns, ba as imageContentTypeDefaults, bb as getRunFieldChar, bc as getRunFieldInstruction, bd as createEditorRun, be as JSZip, bf as imageExtensionFromMime, bg as pxToPt$1, bh as resolveFloatingObjectRect, bi as getTextBoxFloatingGeometry, bj as getPresetPathSegments, bk as buildListLabels, bl as DEFAULT_FONT_SIZE_PX, bm as resolveGradientAxis, bn as isDoubleUnderlineStyle, bo as isWavyUnderlineStyle, bp as underlineStyleLineWidthPx, bq as WAVY_UNDERLINE_WAVELENGTH_PX, br as WAVY_UNDERLINE_AMPLITUDE_PX, bs as DOUBLE_UNDERLINE_OFFSET_PX, bt as underlineStyleDashArray, bu as EMPHASIS_GLYPH, bv as rgb255ToHex, bw as getImageFloatingGeometry, bx as textStyleToFontSizePt, by as resolveTextAlignmentBaselineOffset, bz as TEXT_BASELINE_RATIO, bA as resolveOpenTypeFeatureTags, bB as resolveDecorationLineY, bC as DOUBLE_STRIKE_OFFSET_PX, bD as resolveListLabel, bE as getListLabelInset, bF as getAlignedListLabelInset, bG as getParagraphBorderInsets, bH as buildSegmentTable, bI as buildCanvasTableLayout, bJ as resolveCanvasTableWidth, bK as resolveFloatingTableRect, bL as paragraphBetweenBorderMatches, bM as normalizeFamily, bN as ROBOTO_FONT_FILES, bO as loadFontAsset, bP as OFFICE_COMPAT_FONT_FAMILIES, bQ as BinaryReader, bR as buildSfnt, bS as defaultFontDecoderRegistry, bT as SfntFontProgram, bU as collectPdfFontFamilies, bV as outlineFrom, bW as getPageHeaderZoneTop, bX as getPageColumnRects, bY as findFootnoteReference, bZ as resolveImporterForFile, b_ as roundTo, b$ as getDocumentSectionsCanonical, c0 as getDocumentParagraphsCanonical, c1 as getDocumentParagraphs, c2 as getDocumentPageSettings, c3 as getTableCellContentWidthForParagraph, c4 as layoutMetricsEpoch, c5 as bumpLayoutMetricsEpoch, c6 as createCanvasLayoutSnapshotProvider, c7 as on, c8 as debounce, c9 as unwrap, ca as perfTimer, cb as getRunTextBox, cc as createEditorDocument, cd as resolveResizedDimensions, ce as resolveTextBoxRenderHeight, cf as getToolbarStyleState, cg as VERTICAL_HIT_WEIGHT, ch as getCachedCanvasImage, ci as measureParagraphMinContentWidthPx, cj as getEditableBlocksForZone, ck as findParagraphLocation, cl as createSectionBoundaryParagraph, cm as normalizePageSettings, cn as DEFAULT_EDITOR_PAGE_SETTINGS, co as markStart, cp as markEnd, cq as getParagraphEntries, cr as getParagraphById, cs as createEditorFootnote, ct as createFootnoteReferenceRun, cu as renumberFootnotes, cv as preciseFontModeVersion, cw as isPreciseFontModeEnabled, cx as getHeadingLevel, cy as togglePreciseFontMode, cz as nextFontSizePt, cA as previousFontSizePt, cB as fontSizePtToPx, cC as resolveNamedTextStyle, cD as createDefaultToolbarPreset, cE as MenuRegistry, cF as createToolbarRegistry, cG as Editor, cH as resolveCommandRef, cI as commandRefName, cJ as createOasisEditorClient, cK as createEditorZoom, cL as startLongTaskObserver, cM as installGlobalReport, cN as applyStoredPreciseFontPreference, cO as getWelcomeSeen, cP as isLocalFontAccessSupported, cQ as EDITOR_SCROLL_PADDING_PX, cR as Toolbar, cS as OasisEditorLoading, cT as I18nProvider, cU as createTranslator, cV as registerDomStatsSurface, cW as createEditorLogger } from "./index-BOj4-NlJ.js";
+import { E as EMPTY_PROJECTION_CONTEXT, d as domTextMeasurer, g as getProjectedParagraphBlockHeight, e as estimateTableBlockHeight, p as projectParagraphLayout, a as getPageBodyBottom, b as getPageBodyTop, c as getPageContentWidth, F as FOOTNOTE_MARKER_GUTTER_PX, f as getParagraphText, h as getBlockParagraphs, i as getRunFootnoteReference, l as listReferencedEndnotes, j as getFootnoteDisplayMarker, k as createProjectionContext, m as getDocumentSections, n as getRunField, o as projectBlocksLayout, v as visitRun, q as assertNever, r as createSignal, s as createEditorStateFromDocument, t as createInitialEditorState, S as STANDARD_FONT_SIZES_PT, u as fontSizePxToPt, w as probeLocalFontFamilies, x as createEditorParagraphFromRuns, y as isInlineObjectRun, z as createEditorStyledRun, A as getParagraphLength, B as getActiveZone, C as getActiveSectionIndex, D as getParagraphs, G as normalizeSelection, H as positionToParagraphOffset, I as paragraphOffsetToPosition, J as clampPosition, K as findParagraphIndex, L as createCollapsedSelection, M as isSelectionCollapsed, N as parseFontSizePtToPx, O as formatFontSizePt, P as createEditorParagraph, Q as resolveDefaultParagraphStyleId, R as findParagraphTableLocation, T as buildTableCellLayout, U as PT_PER_PX, V as createEditorTableCell, W as createEditorTableRow, X as createEditorTable, Y as PX_PER_POINT, Z as underlineStyleToCssDecorationStyle, _ as resolveImageSrc, $ as listKindForTag, a0 as isParagraphTag, a1 as collectInlineRuns, a2 as parseParagraphStyle, a3 as getRunImage, a4 as InlineShell, a5 as BalloonShell, a6 as DocumentShell, a7 as createMemo, a8 as getCaretRectFromSnapshot, a9 as getParagraphRectFromSnapshot, aa as createComponent, ab as CaretOverlay, ac as Show, ad as createRenderEffect, ae as style, af as setStyleProperty, ag as setAttribute, ah as memo, ai as template, aj as Button, ak as useI18n, al as createEffect, am as TextField, an as Dialog, ao as insert, ap as className, aq as Grid, ar as SelectField, as as StatusText, at as ColorField, au as UNDERLINE_STYLE_OPTIONS, av as Stack, aw as For, ax as ToggleChip, ay as FormField, az as Checkbox, aA as FieldGroup, aB as Tabs, aC as NumberField, aD as parseNumber, aE as createStore, aF as reconcile, aG as RadioGroup, aH as Radio$1, aI as TextAreaField, aJ as Text, aK as SurfaceButton, aL as delegateEvents, aM as onMount, aN as onCleanup, aO as CheckIcon, aP as use, aQ as PluginUiHost, aR as OasisEditorEditor, aS as OasisBrandMark, aT as setPreciseFontPreference, aU as setWelcomeSeen, aV as enablePreciseFontMode, aW as TWIPS_PER_POINT, aX as PX_PER_INCH, aY as TWIPS_PER_INCH, aZ as normalizeHex6, a_ as TABLE_CONDITIONAL_FLAG_ATTRIBUTES, a$ as TABLE_BORDER_EDGE_KEYS, b0 as resolveEffectiveParagraphStyle, b1 as resolveEffectiveTextStyleForParagraph, b2 as EMU_PER_PT, b3 as OOXML_ROTATION_UNITS, b4 as OOXML_PERCENT_DENOMINATOR, b5 as parseHexColorToRgb255, b6 as EMU_PER_PX, b7 as getRunEndnoteReference, b8 as iterateFootnoteReferenceRuns, b9 as iterateEndnoteReferenceRuns, ba as imageContentTypeDefaults, bb as getRunFieldChar, bc as getRunFieldInstruction, bd as createEditorRun, be as JSZip, bf as imageExtensionFromMime, bg as pxToPt$1, bh as resolveFloatingObjectRect, bi as getTextBoxFloatingGeometry, bj as getPresetPathSegments, bk as buildListLabels, bl as DEFAULT_FONT_SIZE_PX, bm as resolveGradientAxis, bn as isDoubleUnderlineStyle, bo as isWavyUnderlineStyle, bp as underlineStyleLineWidthPx, bq as WAVY_UNDERLINE_WAVELENGTH_PX, br as WAVY_UNDERLINE_AMPLITUDE_PX, bs as DOUBLE_UNDERLINE_OFFSET_PX, bt as underlineStyleDashArray, bu as EMPHASIS_GLYPH, bv as rgb255ToHex, bw as getImageFloatingGeometry, bx as textStyleToFontSizePt, by as resolveTextAlignmentBaselineOffset, bz as TEXT_BASELINE_RATIO, bA as resolveOpenTypeFeatureTags, bB as resolveDecorationLineY, bC as DOUBLE_STRIKE_OFFSET_PX, bD as resolveListLabel, bE as getListLabelInset, bF as getAlignedListLabelInset, bG as getParagraphBorderInsets, bH as buildSegmentTable, bI as buildCanvasTableLayout, bJ as resolveCanvasTableWidth, bK as resolveFloatingTableRect, bL as paragraphBetweenBorderMatches, bM as normalizeFamily, bN as ROBOTO_FONT_FILES, bO as loadFontAsset, bP as OFFICE_COMPAT_FONT_FAMILIES, bQ as BinaryReader, bR as buildSfnt, bS as defaultFontDecoderRegistry, bT as SfntFontProgram, bU as collectPdfFontFamilies, bV as outlineFrom, bW as getPageHeaderZoneTop, bX as getPageColumnRects, bY as findFootnoteReference, bZ as resolveImporterForFile, b_ as roundTo, b$ as getDocumentSectionsCanonical, c0 as getDocumentParagraphsCanonical, c1 as getDocumentParagraphs, c2 as PX_PER_CM, c3 as getDocumentPageSettings, c4 as getTableCellContentWidthForParagraph, c5 as layoutMetricsEpoch, c6 as bumpLayoutMetricsEpoch, c7 as createCanvasLayoutSnapshotProvider, c8 as on, c9 as debounce, ca as unwrap, cb as perfTimer, cc as getRunTextBox, cd as createEditorDocument, ce as resolveResizedDimensions, cf as axisSignForDirection, cg as clamp$1, ch as MIN_RESIZE_SIZE_PX, ci as resolveTextBoxRenderHeight, cj as getToolbarStyleState, ck as VERTICAL_HIT_WEIGHT, cl as getCachedCanvasImage, cm as measureParagraphMinContentWidthPx, cn as getEditableBlocksForZone, co as findParagraphLocation, cp as createSectionBoundaryParagraph, cq as normalizePageSettings, cr as DEFAULT_EDITOR_PAGE_SETTINGS, cs as markStart, ct as markEnd, cu as getParagraphEntries, cv as getParagraphById, cw as createEditorFootnote, cx as createFootnoteReferenceRun, cy as renumberFootnotes, cz as preciseFontModeVersion, cA as isPreciseFontModeEnabled, cB as getHeadingLevel, cC as togglePreciseFontMode, cD as nextFontSizePt, cE as previousFontSizePt, cF as fontSizePtToPx, cG as resolveNamedTextStyle, cH as createDefaultToolbarPreset, cI as MenuRegistry, cJ as createToolbarRegistry, cK as Editor, cL as resolveCommandRef, cM as commandRefName, cN as createOasisEditorClient, cO as createEditorZoom, cP as startLongTaskObserver, cQ as installGlobalReport, cR as applyStoredPreciseFontPreference, cS as getWelcomeSeen, cT as isLocalFontAccessSupported, cU as EDITOR_SCROLL_PADDING_PX, cV as Toolbar, cW as OasisEditorLoading, cX as I18nProvider, cY as createTranslator, cZ as registerDomStatsSurface, c_ as createEditorLogger } from "./index-ogn0S9F3.js";
 function projectHeaderFooterBlocksWithDependencies(blocks, deps, context = {}) {
   const {
     pageIndex,
@@ -27476,6 +27476,7 @@ const MERGE_KEYS = {
   link: "link",
   imageAlt: "imageAlt",
   imageCaption: "imageCaption",
+  imageResize: "imageResize",
   layoutWrapPolygon: "layoutWrapPolygon",
   specialIndent: "specialIndent",
   paraBorders: "paraBorders",
@@ -35938,7 +35939,8 @@ function buildEditorViewProps(ctx) {
     hoveredRevision: overlayInput.hoveredRevision,
     focused: overlayInput.focused,
     showCaret: overlayInput.showCaret,
-    importProgress: overlayInput.importProgress
+    importProgress: overlayInput.importProgress,
+    imageCropMode: overlayInput.imageCropMode
   };
   const refs = {
     onViewportRef: (element) => {
@@ -35980,6 +35982,7 @@ function buildEditorViewProps(ctx) {
     onImageResizeHandleMouseDown: surface.handleImageResizeHandleMouseDown,
     onTextBoxResizeHandleMouseDown: surface.handleTextBoxResizeHandleMouseDown,
     onImageRotateHandleMouseDown: surface.handleImageRotateHandleMouseDown,
+    onImageCropHandleMouseDown: surface.handleImageCropHandleMouseDown,
     onTextBoxRotateHandleMouseDown: surface.handleTextBoxRotateHandleMouseDown,
     onTableDragHandleMouseDown: surface.tableDrag.handleMouseDown,
     onTableCornerResizeHandleMouseDown: surface.tableCornerResize.handleMouseDown,
@@ -39927,7 +39930,8 @@ async function drawFloatingImagesForParagraph(options) {
         y: pxToPt$1(rect.y),
         width: pxToPt$1(rect.width),
         height: pxToPt$1(rect.height),
-        rotation: image.rotation
+        rotation: image.rotation,
+        crop: image.crop
       });
     }
   }
@@ -40030,7 +40034,8 @@ async function drawFragmentText(writer, pageIndex, paragraph, line, fragment, do
       y: pxToPt$1(originY + line.top + line.height - fragment.image.height),
       width: pxToPt$1(fragment.image.width),
       height: pxToPt$1(fragment.image.height),
-      rotation: fragment.image.rotation
+      rotation: fragment.image.rotation,
+      crop: fragment.image.crop
     });
     return;
   }
@@ -41278,6 +41283,20 @@ class PdfContentStream {
     page.imageResourceNames.add(options.resourceName);
     const bottom = page.height - options.y - options.height;
     const rotation = Number.isFinite(options.rotation) ? options.rotation ?? 0 : 0;
+    const crop = options.crop;
+    const cl = (crop == null ? void 0 : crop.left) ?? 0;
+    const ct = (crop == null ? void 0 : crop.top) ?? 0;
+    const cr = (crop == null ? void 0 : crop.right) ?? 0;
+    const cb = (crop == null ? void 0 : crop.bottom) ?? 0;
+    if (crop && (cl > 0 || ct > 0 || cr > 0 || cb > 0)) {
+      this.drawCroppedImage(options, bottom, rotation, {
+        left: cl,
+        top: ct,
+        right: cr,
+        bottom: cb
+      });
+      return;
+    }
     if (rotation === 0) {
       page.commands.push(
         [
@@ -41323,6 +41342,63 @@ class PdfContentStream {
       ].join("\n")
     );
   }
+  /**
+   * 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.
+   */
+  drawCroppedImage(options, bottom, rotation, crop) {
+    const page = this.page;
+    const { width, height } = options;
+    const fw = Math.max(1e-4, 1 - crop.left - crop.right);
+    const fh = Math.max(1e-4, 1 - crop.top - crop.bottom);
+    const fullWidth = width / fw;
+    const fullHeight = height / fh;
+    const originX = -crop.left * fullWidth;
+    const originY = -crop.bottom * fullHeight;
+    const radians = -rotation * Math.PI / 180;
+    const cos = Math.cos(radians);
+    const sin = Math.sin(radians);
+    const cxl = width / 2;
+    const cyl = height / 2;
+    const cxPage = options.x + width / 2;
+    const cyPage = bottom + height / 2;
+    const ra = cos;
+    const rb = sin;
+    const rc = -sin;
+    const rd = cos;
+    const re = cxPage - (ra * cxl + rc * cyl);
+    const rf = cyPage - (rb * cxl + rd * cyl);
+    page.commands.push(
+      [
+        "q",
+        [
+          formatNumber(ra),
+          formatNumber(rb),
+          formatNumber(rc),
+          formatNumber(rd),
+          formatNumber(re),
+          formatNumber(rf),
+          "cm"
+        ].join(" "),
+        // Clip to the displayed box (box-local coordinates).
+        `0 0 ${formatNumber(width)} ${formatNumber(height)} re W n`,
+        [
+          formatNumber(fullWidth),
+          "0",
+          "0",
+          formatNumber(fullHeight),
+          formatNumber(originX),
+          formatNumber(originY),
+          "cm"
+        ].join(" "),
+        `/${options.resourceName} Do`,
+        "Q"
+      ].join("\n")
+    );
+  }
 }
 function parseExtensionLookup(reader, offset, parseSubtable2) {
   reader.seek(offset);
@@ -44233,6 +44309,118 @@ function resizeSelectedImage(state, width, height) {
     height: Math.max(24, Math.round(height))
   }));
 }
+const MIN_IMAGE_PX = 24;
+function getSelectedImageSizeCm(state) {
+  const selectedImage = getSelectedImageRun(state);
+  const image = selectedImage && getRunImage(selectedImage.run);
+  if (!image) {
+    return null;
+  }
+  return {
+    width: image.width / PX_PER_CM,
+    height: image.height / PX_PER_CM
+  };
+}
+function setSelectedImageWidthCm(state, cm) {
+  const selectedImage = getSelectedImageRun(state);
+  const image = selectedImage && getRunImage(selectedImage.run);
+  if (!image || !Number.isFinite(cm) || cm <= 0) {
+    return state;
+  }
+  const nextWidth = Math.max(MIN_IMAGE_PX, Math.round(cm * PX_PER_CM));
+  const ratio = image.height / image.width;
+  return resizeSelectedImage(state, nextWidth, nextWidth * ratio);
+}
+function setSelectedImageHeightCm(state, cm) {
+  const selectedImage = getSelectedImageRun(state);
+  const image = selectedImage && getRunImage(selectedImage.run);
+  if (!image || !Number.isFinite(cm) || cm <= 0) {
+    return state;
+  }
+  const nextHeight = Math.max(MIN_IMAGE_PX, Math.round(cm * PX_PER_CM));
+  const ratio = image.width / image.height;
+  return resizeSelectedImage(state, nextHeight * ratio, nextHeight);
+}
+function clampCropSide(value) {
+  if (!value || !Number.isFinite(value) || value < 0) {
+    return 0;
+  }
+  return Math.min(value, 0.99);
+}
+function normalizeCrop(crop) {
+  if (!crop) {
+    return void 0;
+  }
+  const left = clampCropSide(crop.left);
+  const top = clampCropSide(crop.top);
+  const right = clampCropSide(crop.right);
+  const bottom = clampCropSide(crop.bottom);
+  const safeRight = Math.min(right, Math.max(0, 0.99 - left));
+  const safeBottom = Math.min(bottom, Math.max(0, 0.99 - top));
+  if (left === 0 && top === 0 && safeRight === 0 && safeBottom === 0) {
+    return void 0;
+  }
+  return { left, top, right: safeRight, bottom: safeBottom };
+}
+function setSelectedImageCrop(state, update) {
+  return patchSelectedImage(state, (image) => {
+    const next = { ...image };
+    const crop = normalizeCrop(update.crop);
+    if (crop) {
+      next.crop = crop;
+    } else {
+      delete next.crop;
+    }
+    if (update.width !== void 0) {
+      next.width = Math.max(MIN_IMAGE_PX, Math.round(update.width));
+    }
+    if (update.height !== void 0) {
+      next.height = Math.max(MIN_IMAGE_PX, Math.round(update.height));
+    }
+    return next;
+  });
+}
+function computeImageAspectCrop(image, mode) {
+  if (mode === "reset") {
+    return { crop: null };
+  }
+  const target = mode;
+  const { width: W, height: H } = image;
+  if (!Number.isFinite(target) || target <= 0 || W <= 0 || H <= 0) {
+    return { crop: image.crop ?? null };
+  }
+  const c = image.crop ?? {};
+  const l0 = clampCropSide(c.left);
+  const t0 = clampCropSide(c.top);
+  const r0 = clampCropSide(c.right);
+  const b0 = clampCropSide(c.bottom);
+  const currentRatio = W / H;
+  if (currentRatio > target) {
+    const newWidth = H * target;
+    const addFrac = (W - newWidth) / W * Math.max(0, 1 - l0 - r0);
+    return {
+      crop: { ...c, left: l0 + addFrac / 2, right: r0 + addFrac / 2 },
+      width: newWidth
+    };
+  }
+  if (currentRatio < target) {
+    const newHeight = W / target;
+    const addFrac = (H - newHeight) / H * Math.max(0, 1 - t0 - b0);
+    return {
+      crop: { ...c, top: t0 + addFrac / 2, bottom: b0 + addFrac / 2 },
+      height: newHeight
+    };
+  }
+  return { crop: image.crop ?? null };
+}
+function applySelectedImageCropAspect(state, mode) {
+  const selectedImage = getSelectedImageRun(state);
+  const image = selectedImage && getRunImage(selectedImage.run);
+  if (!image) {
+    return state;
+  }
+  return setSelectedImageCrop(state, computeImageAspectCrop(image, mode));
+}
 function normalizeRotation$1(rotation) {
   if (!Number.isFinite(rotation)) {
     return void 0;
@@ -47710,12 +47898,168 @@ function createRotateSession(adapter, deps) {
   };
   return { start, stop };
 }
+function visibleFraction(near, far) {
+  return Math.max(1e-4, 1 - near - far);
+}
+function resolveCroppedImage(geometry, deltaX, deltaY) {
+  const { startWidth: W, startHeight: H } = geometry;
+  const l0 = geometry.startCrop.left ?? 0;
+  const t0 = geometry.startCrop.top ?? 0;
+  const r0 = geometry.startCrop.right ?? 0;
+  const b0 = geometry.startCrop.bottom ?? 0;
+  const kx = visibleFraction(l0, r0) / W;
+  const ky = visibleFraction(t0, b0) / H;
+  const xs = axisSignForDirection(geometry.handleDirection, "x");
+  const ys = axisSignForDirection(geometry.handleDirection, "y");
+  let left = l0;
+  let right = r0;
+  let width = W;
+  if (xs !== 0) {
+    const maxGrow = (xs > 0 ? r0 : l0) / kx;
+    width = clamp$1(W + deltaX * xs, MIN_RESIZE_SIZE_PX, W + maxGrow);
+    const widthDelta = width - W;
+    if (xs > 0) {
+      right = Math.max(0, r0 - widthDelta * kx);
+    } else {
+      left = Math.max(0, l0 - widthDelta * kx);
+    }
+  }
+  let top = t0;
+  let bottom = b0;
+  let height = H;
+  if (ys !== 0) {
+    const maxGrow = (ys > 0 ? b0 : t0) / ky;
+    height = clamp$1(H + deltaY * ys, MIN_RESIZE_SIZE_PX, H + maxGrow);
+    const heightDelta = height - H;
+    if (ys > 0) {
+      bottom = Math.max(0, b0 - heightDelta * ky);
+    } else {
+      top = Math.max(0, t0 - heightDelta * ky);
+    }
+  }
+  return {
+    crop: { left, top, right, bottom },
+    width: Math.round(width),
+    height: Math.round(height)
+  };
+}
+function createCropSession(deps) {
+  let active = null;
+  const selectionForObject = (state, paragraphId, paragraphOffset) => {
+    const paragraph = getParagraphs(state).find(
+      (p) => p.id === paragraphId
+    );
+    if (!paragraph) {
+      return null;
+    }
+    return {
+      anchor: paragraphOffsetToPosition(paragraph, paragraphOffset),
+      focus: paragraphOffsetToPosition(paragraph, paragraphOffset + 1)
+    };
+  };
+  const withSelection2 = (state, selection) => ({
+    ...state,
+    selection: {
+      anchor: { ...selection.anchor },
+      focus: { ...selection.focus }
+    }
+  });
+  const handleMouseMove = (event) => {
+    var _a2;
+    const crop = active;
+    if (!crop) {
+      return;
+    }
+    const z = ((_a2 = deps.zoomFactor) == null ? void 0 : _a2.call(deps)) ?? 1;
+    const deltaX = (event.clientX - crop.startClientX) / z;
+    const deltaY = (event.clientY - crop.startClientY) / z;
+    const result = resolveCroppedImage(crop, deltaX, deltaY);
+    const selection = selectionForObject(
+      deps.state,
+      crop.paragraphId,
+      crop.paragraphOffset
+    );
+    if (!selection) {
+      deps.logger.warn("image crop:missing paragraph", crop);
+      return;
+    }
+    deps.applyState(
+      setSelectedImageCrop(withSelection2(deps.state, selection), {
+        crop: result.crop,
+        width: result.width,
+        height: result.height
+      })
+    );
+  };
+  const handleMouseUp = () => {
+    const crop = active;
+    if (crop) {
+      deps.updateHistoryState((current) => ({
+        ...current,
+        undoStack: [...current.undoStack, deps.cloneState(crop.initialState)],
+        redoStack: []
+      }));
+    }
+    stop();
+    deps.focusInput();
+  };
+  const stop = () => {
+    active = null;
+    window.removeEventListener("mousemove", handleMouseMove);
+    window.removeEventListener("mouseup", handleMouseUp);
+  };
+  const start = (paragraphId, paragraphOffset, handleDirection, event, initialState) => {
+    const selection = selectionForObject(
+      initialState,
+      paragraphId,
+      paragraphOffset
+    );
+    if (!selection) {
+      return;
+    }
+    const selected = getSelectedImageRun(
+      withSelection2(initialState, selection)
+    );
+    const image = selected && getRunImage(selected.run);
+    if (!image) {
+      return;
+    }
+    const startCrop = { ...image.crop ?? {} };
+    active = {
+      paragraphId,
+      paragraphOffset,
+      handleDirection,
+      startClientX: event.clientX,
+      startClientY: event.clientY,
+      startWidth: image.width,
+      startHeight: image.height,
+      startCrop,
+      initialState: deps.cloneState(initialState)
+    };
+    window.addEventListener("mousemove", handleMouseMove);
+    window.addEventListener("mouseup", handleMouseUp);
+  };
+  return { start, stop };
+}
 function createEditorImageOperations(deps) {
   return createEditorImageOperationsImpl(deps);
 }
 function createEditorImageOperationsImpl(deps) {
   const [dragging, setDragging] = createSignal(false);
+  const [cropMode, setCropMode] = createSignal(false);
   const [draggedImageInfo, setDraggedImageInfo] = createSignal(null);
+  createEffect(() => {
+    if (cropMode() && !getSelectedImageInfo(deps.state)) {
+      setCropMode(false);
+    }
+  });
+  const toggleCropMode = () => {
+    if (!getSelectedImageInfo(deps.state)) {
+      setCropMode(false);
+      return;
+    }
+    setCropMode((value) => !value);
+  };
   const [mousePos, setMousePos] = createSignal({ x: 0, y: 0 });
   const [dropTargetPos, setDropTargetPos] = createSignal(
     null
@@ -47817,6 +48161,15 @@ function createEditorImageOperationsImpl(deps) {
       logger: deps.logger
     }
   );
+  const imageCropSession = createCropSession({
+    state: deps.state,
+    applyState: deps.applyState,
+    updateHistoryState: deps.updateHistoryState,
+    cloneState: deps.cloneState,
+    focusInput: deps.focusInput,
+    logger: deps.logger,
+    zoomFactor: deps.zoomFactor
+  });
   const handleImageDragMouseMove = (event) => {
     let dragState = activeImageDrag;
     if (!dragState) {
@@ -47945,8 +48298,22 @@ function createEditorImageOperationsImpl(deps) {
     event.stopPropagation();
     imageRotateSession.start(paragraphId, paragraphOffset, event, deps.state);
   };
+  const handleImageCropHandleMouseDown = (paragraphId, paragraphOffset, direction, event) => {
+    event.preventDefault();
+    event.stopPropagation();
+    imageCropSession.start(
+      paragraphId,
+      paragraphOffset,
+      direction,
+      event,
+      deps.state
+    );
+  };
   return {
     dragging,
+    cropMode,
+    setCropMode,
+    toggleCropMode,
     draggedImageInfo,
     mousePos,
     dropTargetPos,
@@ -47955,9 +48322,11 @@ function createEditorImageOperationsImpl(deps) {
     stopImageDrag,
     stopImageResize: imageResizeSession.stop,
     stopImageRotate: imageRotateSession.stop,
+    stopImageCrop: imageCropSession.stop,
     handleImageMouseDown,
     handleImageResizeHandleMouseDown,
-    handleImageRotateHandleMouseDown
+    handleImageRotateHandleMouseDown,
+    handleImageCropHandleMouseDown
   };
 }
 function createEditorTextBoxOperations(deps) {
@@ -51992,6 +52361,22 @@ function setParagraphListStartAt(state, startAt) {
     preserveSelectionByParagraphOffsets(nextParagraphs, normalized)
   );
 }
+function parseCropAspectPreset(preset) {
+  const value = preset.trim().toLowerCase();
+  if (value === "reset" || value === "fit" || value === "fill") {
+    return "reset";
+  }
+  const parts = value.split(/[:/]/);
+  if (parts.length !== 2) {
+    return null;
+  }
+  const a = Number(parts[0]);
+  const b = Number(parts[1]);
+  if (!Number.isFinite(a) || !Number.isFinite(b) || a <= 0 || b <= 0) {
+    return null;
+  }
+  return a / b;
+}
 function createEditorCommandsController(deps) {
   return createEditorCommandsControllerImpl(deps);
 }
@@ -52286,6 +52671,36 @@ function createEditorCommandsControllerImpl(deps) {
     }
     deps.openImageCaptionDialog(getSelectedImageCaption(state) ?? "");
   };
+  const applyImageWidthCmCommand = (cm) => {
+    if (!selectedImageRun() || !Number.isFinite(cm) || cm <= 0) {
+      return;
+    }
+    execTransactional(
+      (current) => setSelectedImageWidthCm(current, cm),
+      { mergeKey: MERGE_KEYS.imageResize }
+    );
+  };
+  const applyImageHeightCmCommand = (cm) => {
+    if (!selectedImageRun() || !Number.isFinite(cm) || cm <= 0) {
+      return;
+    }
+    execTransactional(
+      (current) => setSelectedImageHeightCm(current, cm),
+      { mergeKey: MERGE_KEYS.imageResize }
+    );
+  };
+  const applyImageCropAspectCommand = (preset) => {
+    if (!selectedImageRun()) {
+      return;
+    }
+    const mode = parseCropAspectPreset(preset);
+    if (mode === null) {
+      return;
+    }
+    execTransactional(
+      (current) => applySelectedImageCropAspect(current, mode)
+    );
+  };
   return {
     applyBooleanStyleCommand,
     applyValueStyleCommand,
@@ -52314,6 +52729,9 @@ function createEditorCommandsControllerImpl(deps) {
     promptForImageAlt,
     applyImageCaptionCommand,
     promptForImageCaption,
+    applyImageWidthCmCommand,
+    applyImageHeightCmCommand,
+    applyImageCropAspectCommand,
     handleListTab,
     handleListEnter,
     handleListBoundaryBackspace
@@ -53317,6 +53735,53 @@ function buildDocumentAndBrowserCommands({
         isEnabled: image.isSelected(),
         isActive: image.isSelected()
       })
+    ),
+    imageContext: actionCommand(
+      "imageContext",
+      () => {
+      },
+      () => ({
+        isEnabled: image.isSelected(),
+        isActive: image.isSelected(),
+        value: null
+      })
+    ),
+    imageWidthCm: actionCommand(
+      "imageWidthCm",
+      (p) => image.setWidthCm(Number(p)),
+      () => {
+        var _a2;
+        return {
+          isEnabled: image.isSelected(),
+          value: ((_a2 = image.getSizeCm()) == null ? void 0 : _a2.width) ?? null
+        };
+      }
+    ),
+    imageHeightCm: actionCommand(
+      "imageHeightCm",
+      (p) => image.setHeightCm(Number(p)),
+      () => {
+        var _a2;
+        return {
+          isEnabled: image.isSelected(),
+          value: ((_a2 = image.getSizeCm()) == null ? void 0 : _a2.height) ?? null
+        };
+      }
+    ),
+    imageCrop: actionCommand(
+      "imageCrop",
+      () => image.toggleCrop(),
+      () => ({
+        isEnabled: image.isSelected(),
+        isActive: image.isCropActive()
+      })
+    ),
+    imageCropAspect: actionCommand(
+      "imageCropAspect",
+      (p) => image.applyCropAspect(String(p)),
+      () => ({
+        isEnabled: image.isSelected()
+      })
     )
   };
 }
@@ -54134,7 +54599,13 @@ function buildEssentialsImage(options) {
   return {
     promptAlt: () => options.commandsController.promptForImageAlt(),
     promptCaption: () => options.commandsController.promptForImageCaption(),
-    isSelected: () => Boolean(options.selectedImageRun())
+    isSelected: () => Boolean(options.selectedImageRun()),
+    getSizeCm: () => getSelectedImageSizeCm(options.state()),
+    setWidthCm: (cm) => options.commandsController.applyImageWidthCmCommand(cm),
+    setHeightCm: (cm) => options.commandsController.applyImageHeightCmCommand(cm),
+    isCropActive: () => options.imageCropMode.isActive(),
+    toggleCrop: () => options.imageCropMode.toggle(),
+    applyCropAspect: (preset) => options.commandsController.applyImageCropAspectCommand(preset)
   };
 }
 function buildEssentialsBrowser() {
@@ -55083,6 +55554,10 @@ function createEditorCommandRuntimeImpl(deps) {
       importInputRef: deps.importInputRef,
       imageInputRef: deps.imageInputRef,
       selectedImageRun: interaction.selectedImageRun,
+      imageCropMode: {
+        isActive: interaction.imageOps.cropMode,
+        toggle: interaction.imageOps.toggleCropMode
+      },
       selectionBoxes: doc.selectionBoxes,
       focusInput: deps.focusInput,
       applyState: deps.applyState,
@@ -55409,7 +55884,8 @@ function OasisEditorApp(props = {}) {
       hoveredRevision: revisionController.hoveredRevision,
       focused,
       showCaret: shouldShowCaret,
-      importProgress: docIO.importProgress
+      importProgress: docIO.importProgress,
+      imageCropMode: imageOps.cropMode
     },
     refs: {
       focusController
@@ -55430,6 +55906,7 @@ function OasisEditorApp(props = {}) {
       handleImageResizeHandleMouseDown: imageOps.handleImageResizeHandleMouseDown,
       handleTextBoxResizeHandleMouseDown: textBoxOps.handleTextBoxResizeHandleMouseDown,
       handleImageRotateHandleMouseDown: imageOps.handleImageRotateHandleMouseDown,
+      handleImageCropHandleMouseDown: imageOps.handleImageCropHandleMouseDown,
       handleTextBoxRotateHandleMouseDown: textBoxOps.handleTextBoxRotateHandleMouseDown,
       handleEditorContextMenu
     },
@@ -55458,6 +55935,7 @@ function OasisEditorApp(props = {}) {
     textDrag.stopDrag();
     imageOps.stopImageDrag();
     imageOps.stopImageResize();
+    imageOps.stopImageCrop();
     textBoxOps.stopTextBoxResize();
     stopIconObserver();
   });

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

@@ -44,6 +44,9 @@ declare function createEditorCommandsControllerImpl(deps: EditorCommandsControll
     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 & {