oasis-editor 0.0.149 → 0.0.151

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Celso Fontes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -392,6 +392,12 @@ npm run build:lib
 - [Client API](docs/client-api.md)
 - [Plugin API](docs/plugin-api.md)
 
+## License
+
+Oasis Editor is open source software licensed under the [MIT License](LICENSE).
+Third-party dependencies and bundled assets may be distributed under their own
+licenses; see the corresponding notices in the repository and package metadata.
+
 ## Status
 
 Oasis is under active development. The public client, command, toolbar, menubar,

package/dist/{OasisEditorApp-CmqlSXEk.js → OasisEditorApp-CZNfjaj2.js}

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key2, value) => key2 in obj ? __defProp(obj, key2, { enumerable: true, configurable: true, writable: true, value }) : obj[key2] = value;
 var __publicField = (obj, key2, value) => __defNormalProp(obj, typeof key2 !== "symbol" ? key2 + "" : key2, 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, q as assertNever, r as cloneRun, s as createSignal, t as createEditorStateFromDocument, u as createInitialEditorState, S as STANDARD_FONT_SIZES_PT, v as fontSizePxToPt, w as probeLocalFontFamilies, x as createEditorParagraphFromRuns, y as isInlineObjectRun, z as stylesEqual, A as cloneStyle, B as createEditorStyledRun, C as cloneParagraphList, D as cloneParagraph, G as getParagraphLength, H as getActiveZone, I as getActiveSectionIndex, J as getParagraphs, K as normalizeSelection, L as positionToParagraphOffset, M as cloneParagraphs, N as paragraphOffsetToPosition, O as findParagraphIndex, P as createCollapsedSelection, Q as isSelectionCollapsed, R as MATH_OBJECT_REPLACEMENT, T as setValueStyle, U as setBooleanStyle, V as parseFontSizePtToPx, W as formatFontSizePt, X as setParagraphStyleValue, Y as createEditorParagraph, Z as cloneBlocks, _ as resolveDefaultParagraphStyleId, $ as findParagraphTablePathLocation, a0 as findParagraphLocation, a1 as resolveTablePath, a2 as buildTableCellLayout, a3 as PT_PER_PX, a4 as createEditorTableCell, a5 as createEditorTableRow, a6 as createEditorTable, a7 as clampPosition, a8 as PX_PER_POINT, a9 as underlineStyleToCssDecorationStyle, aa as resolveImageSrc, ab as listKindForTag, ac as isParagraphTag, ad as collectInlineRuns, ae as parseParagraphStyle, af as getRunImage, ag as InlineShell, ah as BalloonShell, ai as DocumentShell, aj as findParagraphTableLocation, ak as createMemo, al as getCaretRectFromSnapshot, am as getParagraphRectFromSnapshot, an as createComponent, ao as CaretOverlay, ap as Show, aq as createRenderEffect, ar as style, as as setStyleProperty, at as setAttribute, au as memo, av as template, aw as Button, ax as useI18n, ay as createEffect, az as TextField, aA as Dialog, aB as insert, aC as className, aD as Grid, aE as SelectField, aF as StatusText, aG as ColorField, aH as UNDERLINE_STYLE_OPTIONS, aI as Stack, aJ as For, aK as ToggleChip, aL as FormField, aM as Checkbox, aN as FieldGroup, aO as Tabs, aP as NumberField, aQ as parseNumber, aR as createStore, aS as reconcile, aT as RadioGroup, aU as Radio$1, aV as TextAreaField, aW as COMMON_SYMBOLS, aX as getRecentSymbols, aY as SYMBOL_CATEGORIES, aZ as rememberSymbol, a_ as delegateEvents, a$ as EMPTY_EDITOR_MATH_EXPRESSION, b0 as serializeLinearMath, b1 as parseLinearMath, b2 as Text, b3 as SurfaceButton, b4 as onMount, b5 as onCleanup, b6 as CheckIcon, b7 as use, b8 as PluginUiHost, b9 as OasisEditorEditor, ba as OasisBrandMark, bb as setPreciseFontPreference, bc as setWelcomeSeen, bd as enablePreciseFontMode, be as WORD_NS$6, bf as XMLSerializer, bg as DOMParser, bh as WORD14_NS, bi as mergeNestedExtensionMarkup, bj as resolveOpcRelationships, bk as parseOpcRelationships, bl as JSZip, bm as normalizeOpcPartPath, bn as OPC_CONTENT_TYPES_PATH, bo as getOpcRelationshipOwnerPath, bp as serializeOpcRelationships, bq as OPC_ROOT_RELATIONSHIPS_PATH, br as hashDocxPartBytes, bs as parseOpcContentTypes, bt as serializeOpcContentTypes, bu as mergeParagraphPropertiesXmlSource, bv as setEditorRunOoxmlSource, bw as mergeRunOoxmlSourceIntoGeneratedXml, bx as mergeTableCellPropertiesXmlSource, by as mergeTableRowPropertiesXmlSource, bz as mergeTablePropertiesXmlSource, bA as exportEditorDocumentToDocxBlob, bB as exportEditorDocumentToDocx, bC as pxToPt$1, bD as resolveFloatingObjectRect, bE as getTextBoxFloatingGeometry, bF as getPresetPathSegments, bG as buildListLabels, bH as lineDashPatternPt, bI as DEFAULT_FONT_SIZE_PX, bJ as resolveGradientAxis, bK as isDoubleUnderlineStyle, bL as isWavyUnderlineStyle, bM as underlineStyleLineWidthPx, bN as WAVY_UNDERLINE_WAVELENGTH_PX, bO as WAVY_UNDERLINE_AMPLITUDE_PX, bP as DOUBLE_UNDERLINE_OFFSET_PX, bQ as underlineStyleDashArray, bR as resolveEffectiveParagraphStyle, bS as EMPHASIS_GLYPH, bT as parseHexColorToRgb255, bU as rgb255ToHex, bV as getImageFloatingGeometry, bW as resolveEffectiveTextStyleForParagraph, bX as textStyleToFontSizePt, bY as mathDisplayText, bZ as TEXT_BASELINE_RATIO, b_ as resolveTextAlignmentBaselineOffset, b$ as resolveRenderedTextChar, c0 as resolveOpenTypeFeatureTags, c1 as isLowercaseSmallCapsChar, c2 as resolveDecorationLineY, c3 as DOUBLE_STRIKE_OFFSET_PX, c4 as resolveListLabel, c5 as getListLabelInset, c6 as getAlignedListLabelInset, c7 as getParagraphBorderInsets, c8 as buildSegmentTable, c9 as buildCanvasTableLayout, ca as resolveCanvasTableWidth, cb as resolveFloatingTableRect, cc as paragraphBetweenBorderMatches, cd as normalizeFamily, ce as ROBOTO_FONT_FILES, cf as loadFontAsset, cg as getRemotePdfFontFaces, ch as OFFICE_COMPAT_FONT_FAMILIES, ci as BinaryReader, cj as buildSfnt, ck as defaultFontDecoderRegistry, cl as SfntFontProgram, cm as zlibSync, cn as renumberImageCaptionsInDocument, co as collectPdfFontFamilies, cp as outlineFrom, cq as getPageHeaderZoneTop, cr as getPageColumnRects, cs as findFootnoteReference, ct as resolveImporterForFile, cu as roundTo, cv as getDocumentSectionsCanonical, cw as getDocumentParagraphsCanonical, cx as getDocumentParagraphs, cy as getImageCaptionText, cz as isImageCaptionParagraph, cA as updateImageCaptionParagraph, cB as createImageCaptionParagraph, cC as renumberImageCaptionParagraphs, cD as getCaptionSelectionOffset, cE as PX_PER_CM, cF as getDocumentPageSettings, cG as getTableCellContentWidthForParagraph, cH as layoutMetricsEpoch, cI as bumpLayoutMetricsEpoch, cJ as createCanvasLayoutSnapshotProvider, cK as on, cL as debounce, cM as unwrap, cN as perfTimer, cO as prepareDocumentFonts, cP as getRunTextBox, cQ as EMU_PER_PX, cR as createEditorDocument, cS as resolveResizedDimensions, cT as axisSignForDirection, cU as clamp$1, cV as MIN_RESIZE_SIZE_PX, cW as resolveTextBoxRenderHeight, cX as getToolbarStyleState, cY as VERTICAL_HIT_WEIGHT, cZ as getCachedCanvasImage, c_ as measureParagraphMinContentWidthPx, c$ as createSectionBoundaryParagraph, d0 as normalizePageSettings, d1 as DEFAULT_EDITOR_PAGE_SETTINGS, d2 as markStart, d3 as markEnd, d4 as getParagraphEntries, d5 as getParagraphById, d6 as createEditorFootnote, d7 as createFootnoteReferenceRun, d8 as renumberFootnotes, d9 as iterateFootnoteReferenceRuns, da as preciseFontModeVersion, db as isPreciseFontModeEnabled, dc as getRunFieldChar, dd as getRunFieldInstruction, de as getHeadingLevel, df as createEditorRun, dg as TWIPS_PER_INCH, dh as PX_PER_INCH, di as togglePreciseFontMode, dj as nextFontSizePt, dk as previousFontSizePt, dl as fontSizePtToPx, dm as resolveNamedTextStyle, dn as resolveNamedTableStyle, dp as resolveEffectiveTableStyle, dq as createDefaultToolbarPreset, dr as MenuRegistry, ds as createToolbarRegistry, dt as Editor, du as resolveCommandRef, dv as commandRefName, dw as createOasisEditorClient, dx as createEditorZoom, dy as startLongTaskObserver, dz as installGlobalReport, dA as applyStoredPreciseFontPreference, dB as getWelcomeSeen, dC as isLocalFontAccessSupported, dD as EDITOR_SCROLL_PADDING_PX, dE as Toolbar, dF as OasisEditorLoading, dG as I18nProvider, dH as createTranslator, dI as registerDomStatsSurface, dJ as createEditorLogger } from "./index-B7V7kbjr.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, q as assertNever, r as cloneRun, s as createSignal, t as createEditorStateFromDocument, u as createInitialEditorState, S as STANDARD_FONT_SIZES_PT, v as fontSizePxToPt, w as probeLocalFontFamilies, x as createEditorParagraphFromRuns, y as isInlineObjectRun, z as stylesEqual, A as cloneStyle, B as createEditorStyledRun, C as cloneParagraphList, D as cloneParagraph, G as getParagraphLength, H as getActiveZone, I as getActiveSectionIndex, J as getParagraphs, K as normalizeSelection, L as positionToParagraphOffset, M as cloneParagraphs, N as paragraphOffsetToPosition, O as findParagraphIndex, P as createCollapsedSelection, Q as isSelectionCollapsed, R as MATH_OBJECT_REPLACEMENT, T as setValueStyle, U as setBooleanStyle, V as parseFontSizePtToPx, W as formatFontSizePt, X as setParagraphStyleValue, Y as createEditorParagraph, Z as cloneBlocks, _ as resolveDefaultParagraphStyleId, $ as findParagraphTablePathLocation, a0 as findParagraphLocation, a1 as resolveTablePath, a2 as buildTableCellLayout, a3 as PT_PER_PX, a4 as createEditorTableCell, a5 as createEditorTableRow, a6 as createEditorTable, a7 as clampPosition, a8 as PX_PER_POINT, a9 as underlineStyleToCssDecorationStyle, aa as resolveImageSrc, ab as listKindForTag, ac as isParagraphTag, ad as collectInlineRuns, ae as parseParagraphStyle, af as getRunImage, ag as InlineShell, ah as BalloonShell, ai as DocumentShell, aj as findParagraphTableLocation, ak as createMemo, al as getCaretRectFromSnapshot, am as getParagraphRectFromSnapshot, an as createComponent, ao as CaretOverlay, ap as Show, aq as createRenderEffect, ar as style, as as setStyleProperty, at as setAttribute, au as memo, av as template, aw as Button, ax as useI18n, ay as createEffect, az as TextField, aA as Dialog, aB as insert, aC as className, aD as Grid, aE as SelectField, aF as StatusText, aG as ColorField, aH as UNDERLINE_STYLE_OPTIONS, aI as Stack, aJ as For, aK as ToggleChip, aL as FormField, aM as Checkbox, aN as FieldGroup, aO as Tabs, aP as NumberField, aQ as parseNumber, aR as createStore, aS as reconcile, aT as RadioGroup, aU as Radio$1, aV as TextAreaField, aW as COMMON_SYMBOLS, aX as getRecentSymbols, aY as SYMBOL_CATEGORIES, aZ as rememberSymbol, a_ as delegateEvents, a$ as EMPTY_EDITOR_MATH_EXPRESSION, b0 as serializeLinearMath, b1 as parseLinearMath, b2 as Text, b3 as SurfaceButton, b4 as onMount, b5 as onCleanup, b6 as CheckIcon, b7 as use, b8 as PluginUiHost, b9 as OasisEditorEditor, ba as OasisBrandMark, bb as setPreciseFontPreference, bc as setWelcomeSeen, bd as enablePreciseFontMode, be as WORD_NS$6, bf as XMLSerializer, bg as DOMParser, bh as WORD14_NS, bi as mergeNestedExtensionMarkup, bj as resolveOpcRelationships, bk as parseOpcRelationships, bl as JSZip, bm as normalizeOpcPartPath, bn as OPC_CONTENT_TYPES_PATH, bo as getOpcRelationshipOwnerPath, bp as serializeOpcRelationships, bq as OPC_ROOT_RELATIONSHIPS_PATH, br as hashDocxPartBytes, bs as parseOpcContentTypes, bt as serializeOpcContentTypes, bu as mergeParagraphPropertiesXmlSource, bv as setEditorRunOoxmlSource, bw as mergeRunOoxmlSourceIntoGeneratedXml, bx as mergeTableCellPropertiesXmlSource, by as mergeTableRowPropertiesXmlSource, bz as mergeTablePropertiesXmlSource, bA as exportEditorDocumentToDocxBlob, bB as exportEditorDocumentToDocx, bC as pxToPt$1, bD as resolveFloatingObjectRect, bE as getTextBoxFloatingGeometry, bF as getPresetPathSegments, bG as buildListLabels, bH as lineDashPatternPt, bI as DEFAULT_FONT_SIZE_PX, bJ as resolveGradientAxis, bK as isDoubleUnderlineStyle, bL as isWavyUnderlineStyle, bM as underlineStyleLineWidthPx, bN as WAVY_UNDERLINE_WAVELENGTH_PX, bO as WAVY_UNDERLINE_AMPLITUDE_PX, bP as DOUBLE_UNDERLINE_OFFSET_PX, bQ as underlineStyleDashArray, bR as resolveEffectiveParagraphStyle, bS as EMPHASIS_GLYPH, bT as parseHexColorToRgb255, bU as rgb255ToHex, bV as getImageFloatingGeometry, bW as resolveEffectiveTextStyleForParagraph, bX as textStyleToFontSizePt, bY as mathDisplayText, bZ as TEXT_BASELINE_RATIO, b_ as resolveTextAlignmentBaselineOffset, b$ as resolveRenderedTextChar, c0 as resolveOpenTypeFeatureTags, c1 as isLowercaseSmallCapsChar, c2 as resolveDecorationLineY, c3 as DOUBLE_STRIKE_OFFSET_PX, c4 as resolveListLabel, c5 as getListLabelInset, c6 as getAlignedListLabelInset, c7 as getParagraphBorderInsets, c8 as buildSegmentTable, c9 as buildCanvasTableLayout, ca as resolveCanvasTableWidth, cb as resolveFloatingTableRect, cc as paragraphBetweenBorderMatches, cd as normalizeFamily, ce as ROBOTO_FONT_FILES, cf as loadFontAsset, cg as getRemotePdfFontFaces, ch as OFFICE_COMPAT_FONT_FAMILIES, ci as BinaryReader, cj as buildSfnt, ck as defaultFontDecoderRegistry, cl as SfntFontProgram, cm as zlibSync, cn as renumberImageCaptionsInDocument, co as collectPdfFontFamilies, cp as outlineFrom, cq as getPageHeaderZoneTop, cr as getPageColumnRects, cs as findFootnoteReference, ct as resolveImporterForFile, cu as roundTo, cv as getDocumentSectionsCanonical, cw as getDocumentParagraphsCanonical, cx as getDocumentParagraphs, cy as getImageCaptionText, cz as isImageCaptionParagraph, cA as updateImageCaptionParagraph, cB as createImageCaptionParagraph, cC as renumberImageCaptionParagraphs, cD as getCaptionSelectionOffset, cE as PX_PER_CM, cF as getDocumentPageSettings, cG as getTableCellContentWidthForParagraph, cH as layoutMetricsEpoch, cI as bumpLayoutMetricsEpoch, cJ as createCanvasLayoutSnapshotProvider, cK as on, cL as debounce, cM as unwrap, cN as perfTimer, cO as prepareDocumentFonts, cP as getRunTextBox, cQ as EMU_PER_PX, cR as createEditorDocument, cS as resolveResizedDimensions, cT as axisSignForDirection, cU as clamp$1, cV as MIN_RESIZE_SIZE_PX, cW as resolveTextBoxRenderHeight, cX as getToolbarStyleState, cY as VERTICAL_HIT_WEIGHT, cZ as getCachedCanvasImage, c_ as measureParagraphMinContentWidthPx, c$ as createSectionBoundaryParagraph, d0 as normalizePageSettings, d1 as DEFAULT_EDITOR_PAGE_SETTINGS, d2 as markStart, d3 as markEnd, d4 as getParagraphEntries, d5 as getParagraphById, d6 as createEditorFootnote, d7 as createFootnoteReferenceRun, d8 as renumberFootnotes, d9 as iterateFootnoteReferenceRuns, da as preciseFontModeVersion, db as isPreciseFontModeEnabled, dc as getRunFieldChar, dd as getRunFieldInstruction, de as getHeadingLevel, df as createEditorRun, dg as TWIPS_PER_INCH, dh as PX_PER_INCH, di as togglePreciseFontMode, dj as nextFontSizePt, dk as previousFontSizePt, dl as fontSizePtToPx, dm as resolveNamedTextStyle, dn as resolveNamedTableStyle, dp as resolveEffectiveTableStyle, dq as createDefaultToolbarPreset, dr as MenuRegistry, ds as createToolbarRegistry, dt as Editor, du as resolveCommandRef, dv as commandRefName, dw as createOasisEditorClient, dx as createEditorZoom, dy as startLongTaskObserver, dz as installGlobalReport, dA as applyStoredPreciseFontPreference, dB as getWelcomeSeen, dC as isLocalFontAccessSupported, dD as EDITOR_SCROLL_PADDING_PX, dE as Toolbar, dF as OasisEditorLoading, dG as I18nProvider, dH as createTranslator, dI as registerDomStatsSurface, dJ as createEditorLogger } from "./index-DgN6KXYw.js";
 function projectHeaderFooterBlocksWithDependencies(blocks, deps, context = {}) {
   const {
     pageIndex,
@@ -27315,6 +27315,7 @@ const MERGE_KEYS = {
   imageAlt: "imageAlt",
   imageCaption: "imageCaption",
   imageResize: "imageResize",
+  imageCrop: "imageCrop",
   layoutWrapPolygon: "layoutWrapPolygon",
   specialIndent: "specialIndent",
   paraBorders: "paraBorders",
@@ -36591,6 +36592,7 @@ function buildEditorViewProps(ctx) {
     onTextBoxResizeHandleMouseDown: surface.handleTextBoxResizeHandleMouseDown,
     onImageRotateHandleMouseDown: surface.handleImageRotateHandleMouseDown,
     onImageCropHandleMouseDown: surface.handleImageCropHandleMouseDown,
+    onImageCropBodyMouseDown: surface.handleImageCropBodyMouseDown,
     onTextBoxRotateHandleMouseDown: surface.handleTextBoxRotateHandleMouseDown,
     onTableDragHandleMouseDown: surface.tableDrag.handleMouseDown,
     onTableCornerResizeHandleMouseDown: surface.tableCornerResize.handleMouseDown,
@@ -40970,40 +40972,133 @@ async function registerPdfImageRun(writer, document2, image) {
   perWriter.set(resolvedSrc, preparedPromise);
   return preparedPromise;
 }
+function transformPath(segments, x, y, width, height, rotation) {
+  if (!rotation) return segments;
+  const cx = x + width / 2;
+  const cy = y + height / 2;
+  const radians = rotation * Math.PI / 180;
+  const rotate = (px, py) => ({
+    x: cx + (px - cx) * Math.cos(radians) - (py - cy) * Math.sin(radians),
+    y: cy + (px - cx) * Math.sin(radians) + (py - cy) * Math.cos(radians)
+  });
+  return segments.map((segment) => {
+    if (segment.type === "close") return segment;
+    if (segment.type === "cubic") {
+      const p1 = rotate(segment.x1, segment.y1);
+      const p2 = rotate(segment.x2, segment.y2);
+      const p3 = rotate(segment.x, segment.y);
+      return {
+        type: "cubic",
+        x1: p1.x,
+        y1: p1.y,
+        x2: p2.x,
+        y2: p2.y,
+        x: p3.x,
+        y: p3.y
+      };
+    }
+    const p = rotate(segment.x, segment.y);
+    return { type: segment.type, x: p.x, y: p.y };
+  });
+}
 async function drawImageObject(writer, pageIndex, document2, image, x, y, width, height) {
+  var _a;
   const resourceName = await registerPdfImageRun(writer, document2, image);
   if (!resourceName) {
     return;
   }
-  writer.drawImage(pageIndex, {
-    resourceName,
+  const sourceWidth = image.intrinsicWidth ?? image.width;
+  const sourceHeight = image.intrinsicHeight ?? image.height;
+  const sourceRatio = sourceWidth / Math.max(1, sourceHeight);
+  const frameRatio = width / Math.max(1, height);
+  let drawX = x;
+  let drawY = y;
+  let drawWidth = width;
+  let drawHeight = height;
+  if (image.cropFit === "fit" && sourceRatio > 0) {
+    if (sourceRatio > frameRatio) {
+      drawHeight = width / sourceRatio;
+      drawY += (height - drawHeight) / 2;
+    } else {
+      drawWidth = height * sourceRatio;
+      drawX += (width - drawWidth) / 2;
+    }
+  }
+  const effectiveCrop = image.cropFit === "fill" && !image.crop ? (() => {
+    if (sourceRatio > frameRatio) {
+      const visible = frameRatio / sourceRatio;
+      const trim = Math.max(0, (1 - visible) / 2);
+      return { left: trim, right: trim };
+    }
+    if (sourceRatio < frameRatio) {
+      const visible = sourceRatio / frameRatio;
+      const trim = Math.max(0, (1 - visible) / 2);
+      return { top: trim, bottom: trim };
+    }
+    return void 0;
+  })() : image.crop;
+  const shape = (_a = image.cropShape) == null ? void 0 : _a.preset;
+  const shapePath = shape ? transformPath(
+    getPresetPathSegments(shape, x, y, width, height),
     x,
     y,
     width,
     height,
-    rotation: image.rotation,
-    crop: image.crop
+    image.rotation ?? 0
+  ) : null;
+  const rotateFitAroundFrame = image.cropFit === "fit" && Boolean(image.rotation);
+  if (shapePath) {
+    writer.saveGraphicsState(pageIndex);
+    writer.clipPath(pageIndex, shapePath);
+  }
+  if (rotateFitAroundFrame) {
+    writer.saveGraphicsState(pageIndex);
+    writer.rotateAbout(
+      pageIndex,
+      x + width / 2,
+      y + height / 2,
+      image.rotation ?? 0
+    );
+  }
+  writer.drawImage(pageIndex, {
+    resourceName,
+    x: drawX,
+    y: drawY,
+    width: drawWidth,
+    height: drawHeight,
+    rotation: rotateFitAroundFrame ? void 0 : image.rotation,
+    crop: effectiveCrop
   });
+  if (rotateFitAroundFrame) writer.restoreGraphicsState(pageIndex);
+  if (shapePath) writer.restoreGraphicsState(pageIndex);
   const border = image.border;
   if (!border) {
     return;
   }
   const rotation = image.rotation;
-  if (rotation) {
+  if (rotation && !shapePath) {
     writer.saveGraphicsState(pageIndex);
     writer.rotateAbout(pageIndex, x + width / 2, y + height / 2, rotation);
   }
   const dashArray = lineDashPatternPt(border.dash);
-  writer.drawRect(pageIndex, {
-    x,
-    y,
-    width,
-    height,
-    stroke: border.color,
-    lineWidth: border.widthPt ?? 1,
-    ...dashArray.length > 0 ? { dashArray } : {}
-  });
-  if (rotation) {
+  if (shapePath) {
+    writer.drawPath(pageIndex, {
+      segments: shapePath,
+      stroke: border.color,
+      lineWidth: border.widthPt ?? 1
+    });
+  } else {
+    writer.drawRect(pageIndex, {
+      x,
+      y,
+      width,
+      height,
+      stroke: border.color,
+      lineWidth: border.widthPt ?? 1,
+      ...dashArray.length > 0 ? { dashArray } : {}
+    });
+  }
+  if (rotation && !shapePath) {
     writer.restoreGraphicsState(pageIndex);
   }
 }
@@ -42711,6 +42806,37 @@ class PdfContentStream {
       "n"
     );
   }
+  /** Intersects the current clip with an arbitrary top-left-origin path. */
+  clipPath(segments) {
+    const page = this.page;
+    if (segments.length === 0) return;
+    const flip = (yy) => page.height - yy;
+    const commands = [];
+    for (const segment of segments) {
+      switch (segment.type) {
+        case "move":
+          commands.push(
+            `${formatNumber(segment.x)} ${formatNumber(flip(segment.y))} m`
+          );
+          break;
+        case "line":
+          commands.push(
+            `${formatNumber(segment.x)} ${formatNumber(flip(segment.y))} l`
+          );
+          break;
+        case "cubic":
+          commands.push(
+            `${formatNumber(segment.x1)} ${formatNumber(flip(segment.y1))} ${formatNumber(segment.x2)} ${formatNumber(flip(segment.y2))} ${formatNumber(segment.x)} ${formatNumber(flip(segment.y))} c`
+          );
+          break;
+        case "close":
+          commands.push("h");
+          break;
+      }
+    }
+    commands.push("W", "n");
+    page.commands.push(commands.join("\n"));
+  }
   drawText(options) {
     if (options.text.length === 0) {
       return;
@@ -44643,6 +44769,10 @@ class OasisPdfWriter {
     var _a;
     (_a = this.streams[pageIndex]) == null ? void 0 : _a.clipRect(x, y, width, height);
   }
+  clipPath(pageIndex, segments) {
+    var _a;
+    (_a = this.streams[pageIndex]) == null ? void 0 : _a.clipPath(segments);
+  }
   drawText(pageIndex, options) {
     var _a;
     (_a = this.streams[pageIndex]) == null ? void 0 : _a.drawText(options);
@@ -45441,6 +45571,72 @@ function applySelectedImageCropAspect(state, mode) {
   }
   return setSelectedImageCrop(state, computeImageAspectCrop(image, mode));
 }
+function getSelectedImageCropShape(state) {
+  const selectedImage = getSelectedImageRun(state);
+  const image = selectedImage && getRunImage(selectedImage.run);
+  return (image == null ? void 0 : image.cropShape) ?? null;
+}
+function setSelectedImageCropShape(state, preset) {
+  const normalized = preset == null ? void 0 : preset.trim();
+  return patchSelectedImage(state, (image) => {
+    const next = { ...image };
+    if (!normalized || normalized === "rect") {
+      delete next.cropShape;
+    } else {
+      next.cropShape = { preset: normalized };
+      if (!next.cropFit) next.cropFit = "fill";
+    }
+    return next;
+  });
+}
+function computeImageFillCrop(image) {
+  const sourceWidth = image.intrinsicWidth ?? image.width;
+  const sourceHeight = image.intrinsicHeight ?? image.height;
+  const sourceRatio = sourceWidth > 0 && sourceHeight > 0 ? sourceWidth / sourceHeight : image.width / Math.max(1, image.height);
+  const frameRatio = image.width / Math.max(1, image.height);
+  if (!Number.isFinite(sourceRatio) || !Number.isFinite(frameRatio)) {
+    return {};
+  }
+  if (sourceRatio > frameRatio) {
+    const visibleWidth = frameRatio / sourceRatio;
+    const trim = Math.max(0, (1 - visibleWidth) / 2);
+    return { left: trim, right: trim };
+  }
+  if (sourceRatio < frameRatio) {
+    const visibleHeight = sourceRatio / frameRatio;
+    const trim = Math.max(0, (1 - visibleHeight) / 2);
+    return { top: trim, bottom: trim };
+  }
+  return {};
+}
+function applySelectedImageCropFill(state) {
+  const selectedImage = getSelectedImageRun(state);
+  const image = selectedImage && getRunImage(selectedImage.run);
+  if (!image) return state;
+  const cropped = setSelectedImageCrop(state, {
+    crop: computeImageFillCrop(image)
+  });
+  return patchSelectedImage(cropped, (next) => ({
+    ...next,
+    cropFit: "fill"
+  }));
+}
+function applySelectedImageCropFit(state) {
+  return patchSelectedImage(state, (image) => {
+    const next = { ...image, cropFit: "fit" };
+    delete next.crop;
+    return next;
+  });
+}
+function resetSelectedImageCrop(state) {
+  return patchSelectedImage(state, (image) => {
+    const next = { ...image };
+    delete next.crop;
+    delete next.cropFit;
+    delete next.cropShape;
+    return next;
+  });
+}
 function getSelectedImageBorder(state) {
   const selectedImage = getSelectedImageRun(state);
   const image = selectedImage && getRunImage(selectedImage.run);
@@ -45755,7 +45951,13 @@ function createImageInsertionService(deps) {
     deps.applyTransactionalState(
       (current) => {
         const targetState = position ? setSelection(current, { anchor: position, focus: position }) : current;
-        return insertImageAtSelection(targetState, { src, width, height });
+        return insertImageAtSelection(targetState, {
+          src,
+          width,
+          height,
+          intrinsicWidth: naturalWidth,
+          intrinsicHeight: naturalHeight
+        });
       },
       { mergeKey: MERGE_KEYS.insertImage }
     );
@@ -49176,6 +49378,15 @@ function createRotateSession(adapter, deps) {
 function visibleFraction(near, far) {
   return Math.max(1e-4, 1 - near - far);
 }
+function clampCropPair(near, far, nextNear, nextFar) {
+  const visible = Math.max(0.01, 1 - near - far);
+  const clampedNear = Math.max(0, Math.min(nextNear, 0.99 - far));
+  const clampedFar = Math.max(0, Math.min(nextFar, 0.99 - clampedNear));
+  if (clampedNear + clampedFar >= 0.99) {
+    return { near: Math.max(0, 0.99 - visible - far), far };
+  }
+  return { near: clampedNear, far: clampedFar };
+}
 function resolveCroppedImage(geometry, deltaX, deltaY) {
   const { startWidth: W, startHeight: H } = geometry;
   const l0 = geometry.startCrop.left ?? 0;
@@ -49190,26 +49401,36 @@ function resolveCroppedImage(geometry, deltaX, deltaY) {
   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);
+    if (xs < 0) {
+      const maxWidth = W + l0 / kx;
+      width = clamp$1(W - deltaX, MIN_RESIZE_SIZE_PX, maxWidth);
+      const pair = clampCropPair(l0, r0, l0 - (width - W) * kx, r0);
+      left = pair.near;
+      right = pair.far;
     } else {
-      left = Math.max(0, l0 - widthDelta * kx);
+      const maxWidth = W + r0 / kx;
+      width = clamp$1(W + deltaX, MIN_RESIZE_SIZE_PX, maxWidth);
+      const pair = clampCropPair(l0, r0, l0, r0 - (width - W) * kx);
+      left = pair.near;
+      right = pair.far;
     }
   }
   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);
+    if (ys < 0) {
+      const maxHeight = H + t0 / ky;
+      height = clamp$1(H - deltaY, MIN_RESIZE_SIZE_PX, maxHeight);
+      const pair = clampCropPair(t0, b0, t0 - (height - H) * ky, b0);
+      top = pair.near;
+      bottom = pair.far;
     } else {
-      top = Math.max(0, t0 - heightDelta * ky);
+      const maxHeight = H + b0 / ky;
+      height = clamp$1(H + deltaY, MIN_RESIZE_SIZE_PX, maxHeight);
+      const pair = clampCropPair(t0, b0, t0, b0 - (height - H) * ky);
+      top = pair.near;
+      bottom = pair.far;
     }
   }
   return {
@@ -49218,6 +49439,29 @@ function resolveCroppedImage(geometry, deltaX, deltaY) {
     height: Math.round(height)
   };
 }
+function resolveMovedImageCrop(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 visibleW = 1 - l0 - r0;
+  const visibleH = 1 - t0 - b0;
+  const nextLeft = Math.max(0, Math.min(1 - visibleW, l0 - deltaX * kx));
+  const nextTop = Math.max(0, Math.min(1 - visibleH, t0 - deltaY * ky));
+  return {
+    crop: {
+      left: nextLeft,
+      right: Math.max(0, 1 - visibleW - nextLeft),
+      top: nextTop,
+      bottom: Math.max(0, 1 - visibleH - nextTop)
+    },
+    width: Math.round(W),
+    height: Math.round(H)
+  };
+}
 function createCropSession(deps) {
   let active = null;
   const selectionForObject = (state, paragraphId, paragraphOffset) => {
@@ -49248,7 +49492,7 @@ function createCropSession(deps) {
     const z = ((_a = deps.zoomFactor) == null ? void 0 : _a.call(deps)) ?? 1;
     const deltaX = (event.clientX - crop.startClientX) / z;
     const deltaY = (event.clientY - crop.startClientY) / z;
-    const result = resolveCroppedImage(crop, deltaX, deltaY);
+    const result = crop.mode === "move" ? resolveMovedImageCrop(crop, deltaX, deltaY) : resolveCroppedImage(crop, deltaX, deltaY);
     const selection = selectionForObject(
       deps.state,
       crop.paragraphId,
@@ -49286,7 +49530,7 @@ function createCropSession(deps) {
     window.removeEventListener("mousemove", handleMouseMove);
     window.removeEventListener("mouseup", handleMouseUp);
   };
-  const start = (paragraphId, paragraphOffset, handleDirection, event, initialState) => {
+  const begin = (paragraphId, paragraphOffset, handleDirection, event, initialState, mode) => {
     const selection = selectionForObject(
       initialState,
       paragraphId,
@@ -49312,12 +49556,22 @@ function createCropSession(deps) {
       startWidth: image.width,
       startHeight: image.height,
       startCrop,
-      initialState: deps.cloneState(initialState)
+      initialState: deps.cloneState(initialState),
+      mode
     };
     window.addEventListener("mousemove", handleMouseMove);
     window.addEventListener("mouseup", handleMouseUp);
   };
-  return { start, stop };
+  const start = (paragraphId, paragraphOffset, handleDirection, event, initialState) => begin(
+    paragraphId,
+    paragraphOffset,
+    handleDirection,
+    event,
+    initialState,
+    "handle"
+  );
+  const startMove = (paragraphId, paragraphOffset, event, initialState) => begin(paragraphId, paragraphOffset, "se", event, initialState, "move");
+  return { start, startMove, stop };
 }
 function createEditorImageOperations(deps) {
   return createEditorImageOperationsImpl(deps);
@@ -49587,6 +49841,11 @@ function createEditorImageOperationsImpl(deps) {
       deps.state
     );
   };
+  const handleImageCropBodyMouseDown = (paragraphId, paragraphOffset, event) => {
+    event.preventDefault();
+    event.stopPropagation();
+    imageCropSession.startMove(paragraphId, paragraphOffset, event, deps.state);
+  };
   return {
     dragging,
     cropMode,
@@ -49604,7 +49863,8 @@ function createEditorImageOperationsImpl(deps) {
     handleImageMouseDown,
     handleImageResizeHandleMouseDown,
     handleImageRotateHandleMouseDown,
-    handleImageCropHandleMouseDown
+    handleImageCropHandleMouseDown,
+    handleImageCropBodyMouseDown
   };
 }
 function createEditorTextBoxOperations(deps) {
@@ -54190,7 +54450,36 @@ function createEditorCommandsControllerImpl(deps) {
       return;
     }
     execTransactional(
-      (current) => applySelectedImageCropAspect(current, mode)
+      (current) => mode === "reset" ? resetSelectedImageCrop(current) : applySelectedImageCropAspect(current, mode),
+      { mergeKey: MERGE_KEYS.imageCrop }
+    );
+  };
+  const applyImageCropShapeCommand = (preset) => {
+    if (!selectedImageRun()) return;
+    execTransactional(
+      (current) => setSelectedImageCropShape(current, preset),
+      { mergeKey: MERGE_KEYS.imageCrop }
+    );
+  };
+  const applyImageCropFillCommand = () => {
+    if (!selectedImageRun()) return;
+    execTransactional(
+      (current) => applySelectedImageCropFill(current),
+      { mergeKey: MERGE_KEYS.imageCrop }
+    );
+  };
+  const applyImageCropFitCommand = () => {
+    if (!selectedImageRun()) return;
+    execTransactional(
+      (current) => applySelectedImageCropFit(current),
+      { mergeKey: MERGE_KEYS.imageCrop }
+    );
+  };
+  const resetImageCropCommand = () => {
+    if (!selectedImageRun()) return;
+    execTransactional(
+      (current) => resetSelectedImageCrop(current),
+      { mergeKey: MERGE_KEYS.imageCrop }
     );
   };
   const applyImageBorderCommand = (patch) => {
@@ -54232,6 +54521,10 @@ function createEditorCommandsControllerImpl(deps) {
     applyImageWidthCmCommand,
     applyImageHeightCmCommand,
     applyImageCropAspectCommand,
+    applyImageCropShapeCommand,
+    applyImageCropFillCommand,
+    applyImageCropFitCommand,
+    resetImageCropCommand,
     applyImageBorderCommand,
     handleListTab,
     handleListEnter,
@@ -55338,6 +55631,29 @@ function buildDocumentAndBrowserCommands({
         isEnabled: image.isSelected()
       })
     ),
+    imageCropShape: actionCommand(
+      "imageCropShape",
+      (p) => image.applyCropShape(String(p)),
+      () => ({
+        isEnabled: image.isSelected(),
+        value: image.getCropShape()
+      })
+    ),
+    imageCropFill: actionCommand(
+      "imageCropFill",
+      () => image.applyCropFill(),
+      () => ({ isEnabled: image.isSelected() })
+    ),
+    imageCropFit: actionCommand(
+      "imageCropFit",
+      () => image.applyCropFit(),
+      () => ({ isEnabled: image.isSelected() })
+    ),
+    imageCropReset: actionCommand(
+      "imageCropReset",
+      () => image.resetCrop(),
+      () => ({ isEnabled: image.isSelected() })
+    ),
     imageBorder: actionCommand(
       "imageBorder",
       (p) => image.setBorder(p),
@@ -56239,6 +56555,14 @@ function buildEssentialsImage(options) {
     isCropActive: () => options.imageCropMode.isActive(),
     toggleCrop: () => options.imageCropMode.toggle(),
     applyCropAspect: (preset) => options.commandsController.applyImageCropAspectCommand(preset),
+    getCropShape: () => {
+      var _a;
+      return ((_a = getSelectedImageCropShape(options.state())) == null ? void 0 : _a.preset) ?? null;
+    },
+    applyCropShape: (preset) => options.commandsController.applyImageCropShapeCommand(preset),
+    applyCropFill: () => options.commandsController.applyImageCropFillCommand(),
+    applyCropFit: () => options.commandsController.applyImageCropFitCommand(),
+    resetCrop: () => options.commandsController.resetImageCropCommand(),
     getBorder: () => getSelectedImageBorder(options.state()),
     setBorder: (patch) => options.commandsController.applyImageBorderCommand(patch)
   };
@@ -57674,6 +57998,7 @@ function OasisEditorApp(props = {}) {
       handleTextBoxResizeHandleMouseDown: textBoxOps.handleTextBoxResizeHandleMouseDown,
       handleImageRotateHandleMouseDown: imageOps.handleImageRotateHandleMouseDown,
       handleImageCropHandleMouseDown: imageOps.handleImageCropHandleMouseDown,
+      handleImageCropBodyMouseDown: imageOps.handleImageCropBodyMouseDown,
       handleTextBoxRotateHandleMouseDown: textBoxOps.handleTextBoxRotateHandleMouseDown,
       handleEditorContextMenu
     },

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

@@ -48,6 +48,10 @@ declare function createEditorCommandsControllerImpl(deps: EditorCommandsControll
     applyImageWidthCmCommand: (cm: number) => void;
     applyImageHeightCmCommand: (cm: number) => void;
     applyImageCropAspectCommand: (preset: string) => void;
+    applyImageCropShapeCommand: (preset: string) => void;
+    applyImageCropFillCommand: () => void;
+    applyImageCropFitCommand: () => void;
+    resetImageCropCommand: () => void;
     applyImageBorderCommand: (patch: ImageBorderPatch) => void;
     handleListTab: (direction: "indent" | "outdent") => boolean;
     handleListEnter: () => boolean;

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

@@ -22,5 +22,6 @@ export interface CropSessionDeps {
  */
 export declare function createCropSession(deps: CropSessionDeps): {
     start: (paragraphId: string, paragraphOffset: number, handleDirection: ResizeHandleDirection, event: MouseEvent, initialState: EditorState) => void;
+    startMove: (paragraphId: string, paragraphOffset: number, event: MouseEvent, initialState: EditorState) => void;
     stop: () => void;
 };

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

@@ -73,5 +73,8 @@ declare function createEditorImageOperationsImpl(deps: EditorImageOperationsDeps
     handleImageCropHandleMouseDown: (paragraphId: string, paragraphOffset: number, direction: ResizeHandleDirection, event: MouseEvent & {
         currentTarget: HTMLElement;
     }) => void;
+    handleImageCropBodyMouseDown: (paragraphId: string, paragraphOffset: number, event: MouseEvent & {
+        currentTarget: HTMLElement;
+    }) => void;
 };
 export {};