oasis-editor 0.0.149 → 0.0.150

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

@@ -1,2 +1,2 @@
-export declare const OASIS_BUILTIN_COMMANDS: readonly ["selectAll", "insertFootnote", "insertText", "insertEquation", "updateEquation", "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", "newDocument", "exportDocx", "exportPdf", "importDocument", "insertImage", "editImageAlt", "insertImageCaption", "imageContext", "imageWidthCm", "imageHeightCm", "imageCrop", "imageCropAspect", "imageBorder", "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", "tableApplyBorderPreset", "toggleTableDrawBorders", "toggleTableGridlines", "tableWidth100", "tableAlignLeft", "tableAlignCenter", "tableAlignRight", "tableSetCellWidth", "tableToggleHeaderRow", "tableToggleTotalRow", "tableToggleBandedRows", "tableToggleFirstColumn", "tableToggleLastColumn", "tableToggleBandedColumns", "setTableStyle", "tableToggleAutoFit", "tableDistributeColumns", "tableDistributeRows", "insertTable", "insertShape", "openSymbolDialog", "openEquationDialog"];
+export declare const OASIS_BUILTIN_COMMANDS: readonly ["selectAll", "insertFootnote", "insertText", "insertEquation", "updateEquation", "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", "newDocument", "exportDocx", "exportPdf", "importDocument", "insertImage", "editImageAlt", "insertImageCaption", "imageContext", "imageWidthCm", "imageHeightCm", "imageCrop", "imageCropAspect", "imageCropShape", "imageCropFill", "imageCropFit", "imageCropReset", "imageBorder", "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", "tableApplyBorderPreset", "toggleTableDrawBorders", "toggleTableGridlines", "tableWidth100", "tableAlignLeft", "tableAlignCenter", "tableAlignRight", "tableSetCellWidth", "tableToggleHeaderRow", "tableToggleTotalRow", "tableToggleBandedRows", "tableToggleFirstColumn", "tableToggleLastColumn", "tableToggleBandedColumns", "setTableStyle", "tableToggleAutoFit", "tableDistributeColumns", "tableDistributeRows", "insertTable", "insertShape", "openSymbolDialog", "openEquationDialog"];
 export type OasisBuiltinCommand = (typeof OASIS_BUILTIN_COMMANDS)[number];

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

@@ -1,4 +1,4 @@
-import { EditorPosition, EditorState, EditorImageRunData, EditorImageBorder, EditorImageCrop, EditorLineDash } from '../model.js';
+import { EditorPosition, EditorState, EditorImageRunData, EditorImageBorder, EditorImageCrop, EditorImageCropShape, EditorLineDash } from '../model.js';
 import { SelectedObjectRun } from './selectedObjectRun.js';
 import { WrapPreset } from './floatingLayout.js';
 
@@ -42,6 +42,21 @@ export type ImageCropAspectMode = number | "reset";
 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;
+/** Returns the selected picture's clipping geometry, or `null`. */
+export declare function getSelectedImageCropShape(state: EditorState): EditorImageCropShape | null;
+/** Applies/removes a DrawingML preset geometry used as a picture mask. */
+export declare function setSelectedImageCropShape(state: EditorState, preset: string | null): EditorState;
+/**
+ * Computes a centred source crop that covers the existing display frame. The
+ * frame dimensions are unchanged, matching Word's Fill command.
+ */
+export declare function computeImageFillCrop(image: EditorImageRunData): EditorImageCrop;
+/** Applies Word's Fill behaviour while keeping the picture frame stable. */
+export declare function applySelectedImageCropFill(state: EditorState): EditorState;
+/** Shows the complete source image inside the frame (Word's Adjust command). */
+export declare function applySelectedImageCropFit(state: EditorState): EditorState;
+/** Removes crop, fit/fill state and picture mask, restoring a plain picture. */
+export declare function resetSelectedImageCrop(state: EditorState): EditorState;
 /** Outline of the selected image (`pic:spPr/a:ln`), or `null`. */
 export declare function getSelectedImageBorder(state: EditorState): EditorImageBorder | null;
 /**

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

@@ -93,6 +93,10 @@ export interface OasisCommandPayloads {
     imageHeightCm: number | string | null;
     imageCrop: undefined;
     imageCropAspect: string;
+    imageCropShape: string;
+    imageCropFill: undefined;
+    imageCropFit: undefined;
+    imageCropReset: undefined;
     outdent: undefined;
     indent: undefined;
     togglePageBreakBefore: undefined;

package/dist/core/model/index.d.ts

@@ -6,7 +6,7 @@
  * statements that pointed there continue to work via the barrel
  * re-export in `src/core/model.ts`.
  */
-export type { EditorUnderlineStyle, EditorLigatures, EditorNumberSpacing, EditorNumberForm, EditorTextLanguage, EditorBorderStyle, EditorEmphasisMark, EditorTabStop, EditorParagraphListStyle, EditorImageCrop, EditorImageFillMode, EditorLineDash, EditorImageBorder, EditorImageFloatingPosition, EditorImageFloatingLayout, EditorImageRunData, EditorWrapPolygonPoint, EditorFieldData, EditorFieldChar, EditorFootnoteReferenceData, EditorEndnoteReferenceData, EditorRevision, EditorRevisionMetadata, EditorStructuralRevision, EditorPropertyRevision, EditorAsset, EditorFootnoteNumberFormat, EditorFootnoteRestart, EditorDocxWidthValue, EditorTableLayout, EditorTableRowHeightRule, EditorGradientStop, EditorTextFill, EditorTextOutline, EditorTextShadow, EditorGlow, EditorReflection, } from './types/primitives.js';
+export type { EditorUnderlineStyle, EditorLigatures, EditorNumberSpacing, EditorNumberForm, EditorTextLanguage, EditorBorderStyle, EditorEmphasisMark, EditorTabStop, EditorParagraphListStyle, EditorImageCrop, EditorImageCropShape, EditorImageCropFit, EditorImageFillMode, EditorLineDash, EditorImageBorder, EditorImageFloatingPosition, EditorImageFloatingLayout, EditorImageRunData, EditorWrapPolygonPoint, EditorFieldData, EditorFieldChar, EditorFootnoteReferenceData, EditorEndnoteReferenceData, EditorRevision, EditorRevisionMetadata, EditorStructuralRevision, EditorPropertyRevision, EditorAsset, EditorFootnoteNumberFormat, EditorFootnoteRestart, EditorDocxWidthValue, EditorTableLayout, EditorTableRowHeightRule, EditorGradientStop, EditorTextFill, EditorTextOutline, EditorTextShadow, EditorGlow, EditorReflection, } from './types/primitives.js';
 export type { EditorTextStyle, EditorParagraphStyle, EditorTableStyle, EditorTableFloatingLayout, EditorTableConditionalFormat, EditorConditionalRowStyle, EditorTableConditionalType, EditorTableConditionalFlags, EditorTableCellStyle, EditorNamedStyle, } from './types/styles.js';
 export type { EditorRunBase, EditorTextRun, EditorTextBoxShape, EditorTextBoxBody, EditorTextBoxData, EditorDropCap, EditorSdtBlockWrapper, EditorSdtPr, EditorSdtSubtype, EditorSdtListItem, EditorSdtDataBinding, EditorParagraphNode, EditorTableCellNode, EditorTableRowStyle, EditorTableRowNode, EditorTableNode, EditorBlockNode, } from './types/nodes.js';
 export type { EditorMathNode, EditorMathText, EditorMathFraction, EditorMathRadical, EditorMathScript, EditorMathDelimiter, EditorMathAccent, EditorMathNary, EditorMathLimit, EditorMathMatrix, EditorMathBox, EditorMathGroup, EditorMathRaw, EditorMathStyle, EditorMathExpression, } from './types/math.js';

package/dist/core/model/types/primitives.d.ts

@@ -109,6 +109,17 @@ export interface EditorImageCrop {
     right?: number;
     bottom?: number;
 }
+/**
+ * DrawingML preset geometry used to clip a picture. `rawXml` keeps imported
+ * geometries that the renderer does not understand lossless on export.
+ */
+export interface EditorImageCropShape {
+    preset: string;
+    adjustments?: Record<string, number>;
+    rawXml?: string;
+}
+/** How the source image is fitted into the displayed crop frame. */
+export type EditorImageCropFit = "fill" | "fit";
 export type EditorImageFillMode = "stretch" | "tile";
 /**
  * Preset dash patterns for an outline, mapped from DrawingML `a:prstDash/@val`.
@@ -159,9 +170,14 @@ export interface EditorImageRunData {
     src: string;
     width: number;
     height: number;
+    /** Intrinsic source dimensions, when available. */
+    intrinsicWidth?: number;
+    intrinsicHeight?: number;
     alt?: string;
     linkedSrc?: string;
     crop?: EditorImageCrop;
+    cropFit?: EditorImageCropFit;
+    cropShape?: EditorImageCropShape;
     fillMode?: EditorImageFillMode;
     border?: EditorImageBorder;
     rotation?: number;

package/dist/export/docx/docxTypes.d.ts

@@ -1,4 +1,4 @@
-import { EditorBlockNode, EditorImageBorder, EditorImageCrop, EditorImageFillMode, EditorImageFloatingLayout, EditorParagraphListStyle, EditorWrapPolygonPoint } from '../../core/model.js';
+import { EditorBlockNode, EditorImageBorder, EditorImageCrop, EditorImageCropShape, EditorImageCropFit, EditorImageFillMode, EditorImageFloatingLayout, EditorParagraphListStyle, EditorWrapPolygonPoint } from '../../core/model.js';
 import { EditorListOoxmlNumberingMetadata } from '../../ooxml/word/numberingMetadata.js';
 import { BookmarkEventsByParagraph } from './bookmarksXml.js';
 import { CommentEventsByParagraph } from './commentsXml.js';
@@ -37,6 +37,8 @@ export interface DocContext {
         cy: number;
         alt?: string;
         crop?: EditorImageCrop;
+        cropShape?: EditorImageCropShape;
+        cropFit?: EditorImageCropFit;
         fillMode?: EditorImageFillMode;
         border?: EditorImageBorder;
         rotation?: number;

package/dist/export/pdf/OasisPdfWriter.d.ts

@@ -1,4 +1,4 @@
-import { OasisPdfAxialGradient, OasisPdfLinkAnnotation, OasisPdfNamedDestination, OasisPdfOutlineItem, OasisPdfDocumentInfo, OasisPdfFontResource, OasisPdfImageOptions, OasisPdfImageResource, OasisPdfLineOptions, OasisPdfPageSize, OasisPdfPathOptions, OasisPdfRectOptions, OasisPdfTextOptions } from './writer/pdfTypes.js';
+import { OasisPdfAxialGradient, OasisPdfLinkAnnotation, OasisPdfNamedDestination, OasisPdfOutlineItem, OasisPdfDocumentInfo, OasisPdfFontResource, OasisPdfImageOptions, OasisPdfImageResource, OasisPdfLineOptions, OasisPdfPageSize, OasisPdfPathOptions, OasisPdfPathSegment, OasisPdfRectOptions, OasisPdfTextOptions } from './writer/pdfTypes.js';
 
 export type { OasisPdfPageSize, OasisPdfPage, OasisPdfRectOptions, OasisPdfLineOptions, OasisPdfPathSegment, OasisPdfPathOptions, OasisPdfTextOptions, OasisPdfImageResource, OasisPdfImageOptions, OasisPdfFontResource, OasisPdfBase14FontResource, OasisPdfUnicodeFontResource, OasisPdfLinkAnnotation, OasisPdfAnnotation, OasisPdfNamedDestination, OasisPdfOutlineItem, OasisPdfDocumentInfo, } from './writer/pdfTypes.js';
 export declare class OasisPdfWriter {
@@ -21,6 +21,7 @@ export declare class OasisPdfWriter {
     restoreGraphicsState(pageIndex: number): void;
     rotateAbout(pageIndex: number, centerX: number, centerY: number, degrees: number): void;
     clipRect(pageIndex: number, x: number, y: number, width: number, height: number): void;
+    clipPath(pageIndex: number, segments: OasisPdfPathSegment[]): void;
     drawText(pageIndex: number, options: OasisPdfTextOptions): void;
     /**
      * Registers an axial (linear) gradient on a page for use as a glyph fill, and

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

@@ -1,4 +1,4 @@
-import { OasisPdfAxialGradient, OasisPdfImageOptions, OasisPdfLineOptions, OasisPdfPage, OasisPdfPathOptions, OasisPdfRectOptions, OasisPdfTextOptions } from './pdfTypes.js';
+import { OasisPdfAxialGradient, OasisPdfImageOptions, OasisPdfLineOptions, OasisPdfPage, OasisPdfPathOptions, OasisPdfPathSegment, OasisPdfRectOptions, OasisPdfTextOptions } from './pdfTypes.js';
 import { PdfFontTable } from './PdfFontTable.js';
 import { PdfImageTable } from './PdfImageTable.js';
 import { PdfShadingTable } from './PdfShadingTable.js';
@@ -22,6 +22,8 @@ export declare class PdfContentStream {
     restoreGraphicsState(): void;
     rotateAbout(centerX: number, centerY: number, degrees: number): void;
     clipRect(x: number, y: number, width: number, height: number): void;
+    /** Intersects the current clip with an arbitrary top-left-origin path. */
+    clipPath(segments: OasisPdfPathSegment[]): void;
     drawText(options: OasisPdfTextOptions): void;
     private textSetupCommands;
     private emitTextBlock;

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

@@ -408,6 +408,7 @@ export declare const en: {
     "ribbon.group.paragraph": string;
     "ribbon.group.styles": string;
     "ribbon.group.illustrations": string;
+    "ribbon.group.symbols": string;
     "ribbon.group.tables": string;
     "ribbon.group.links": string;
     "ribbon.group.footnotes": string;
@@ -426,10 +427,17 @@ export declare const en: {
     "ribbon.group.size": string;
     "ribbon.group.imageStyles": string;
     "image.crop": string;
+    "image.cropToShape": string;
+    "image.cropAspectRatio": string;
+    "image.cropFill": string;
+    "image.cropFit": string;
     "image.height": string;
     "image.width": string;
     "image.cropReset": string;
     "image.cropRatio.square": string;
+    "image.cropRatio.squareGroup": string;
+    "image.cropRatio.portrait": string;
+    "image.cropRatio.landscape": string;
     "image.cropRatio.16x9": string;
     "image.cropRatio.4x3": string;
     "image.cropRatio.3x2": string;

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

@@ -408,6 +408,7 @@ export declare const ptBR: {
     "ribbon.group.paragraph": string;
     "ribbon.group.styles": string;
     "ribbon.group.illustrations": string;
+    "ribbon.group.symbols": string;
     "ribbon.group.tables": string;
     "ribbon.group.links": string;
     "ribbon.group.footnotes": string;
@@ -426,10 +427,17 @@ export declare const ptBR: {
     "ribbon.group.size": string;
     "ribbon.group.imageStyles": string;
     "image.crop": string;
+    "image.cropToShape": string;
+    "image.cropAspectRatio": string;
+    "image.cropFill": string;
+    "image.cropFit": string;
     "image.height": string;
     "image.width": string;
     "image.cropReset": string;
     "image.cropRatio.square": string;
+    "image.cropRatio.squareGroup": string;
+    "image.cropRatio.portrait": string;
+    "image.cropRatio.landscape": string;
     "image.cropRatio.16x9": string;
     "image.cropRatio.4x3": string;
     "image.cropRatio.3x2": string;