oasis-editor 0.0.134 → 0.0.135

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

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

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

@@ -1,4 +1,4 @@
-import { EditorPosition, EditorState, EditorImageRunData, EditorImageCrop } from '../model.js';
+import { EditorPosition, EditorState, EditorImageRunData, EditorImageBorder, EditorImageCrop, EditorLineDash } from '../model.js';
 import { SelectedObjectRun } from './selectedObjectRun.js';
 import { WrapPreset } from './floatingLayout.js';
 
@@ -42,6 +42,20 @@ 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;
+/** Outline of the selected image (`pic:spPr/a:ln`), or `null`. */
+export declare function getSelectedImageBorder(state: EditorState): EditorImageBorder | null;
+/**
+ * A partial edit of the image outline, as dispatched by the picture-border
+ * toolbar popup. Each popup action touches one facet, so the patch merges onto
+ * whatever border the image already has. `color: null` removes the outline.
+ */
+export interface ImageBorderPatch {
+    color?: string | null;
+    widthPt?: number;
+    dash?: EditorLineDash;
+}
+/** Merges `patch` onto the selected image's outline. `color: null` clears it. */
+export declare function setSelectedImageBorder(state: EditorState, patch: ImageBorderPatch): EditorState;
 export declare function rotateSelectedImage(state: EditorState, rotation: number): EditorState;
 export declare function getSelectedImageWrapPreset(state: EditorState): WrapPreset | null;
 export declare function isSelectedImageFixedPosition(state: EditorState): boolean;

package/dist/core/lineDash.d.ts

@@ -0,0 +1,16 @@
+import { EditorLineDash } from './model/types/primitives.js';
+
+/**
+ * Canonical dash patterns for DrawingML `a:prstDash` presets, expressed in
+ * typographic points. This is the single source of truth shared by every
+ * renderer: the canvas scales them by `PX_PER_POINT` for `setLineDash`, the PDF
+ * exporter feeds them straight to the `d` operator, and the DOCX serializer
+ * needs no numbers at all (it writes the preset name back out verbatim).
+ *
+ * `solid` is the empty pattern — a continuous line in both backends.
+ */
+export declare const LINE_DASH_PATTERN_PT: Record<EditorLineDash, number[]>;
+/** Narrows an untrusted `a:prstDash/@val` to a supported preset. */
+export declare function parseLineDash(value: string | null | undefined): EditorLineDash | undefined;
+/** Dash pattern for a border, in points. Empty for solid/undefined. */
+export declare function lineDashPatternPt(dash: EditorLineDash | undefined): number[];

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, 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, 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, EditorParagraphNode, EditorTableCellNode, EditorTableRowStyle, EditorTableRowNode, EditorTableNode, EditorBlockNode, } from './types/nodes.js';
 export type { RunKind, RunOfKind, RunVisitor } from './runKind.js';

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

@@ -110,6 +110,24 @@ export interface EditorImageCrop {
     bottom?: number;
 }
 export type EditorImageFillMode = "stretch" | "tile";
+/**
+ * Preset dash patterns for an outline, mapped from DrawingML `a:prstDash/@val`.
+ * The member names are the serialized OOXML tokens.
+ */
+export type EditorLineDash = "solid" | "dot" | "sysDot" | "dash" | "sysDash" | "dashDot" | "lgDash" | "lgDashDot" | "lgDashDotDot";
+/**
+ * An image outline, mapped from `pic:spPr/a:ln`. Word centers the stroke on the
+ * displayed box edge and reserves no layout space for it. An absent `border`
+ * means no outline.
+ */
+export interface EditorImageBorder {
+    /** `a:ln/a:solidFill/a:srgbClr` as `#RRGGBB`. */
+    color: string;
+    /** `a:ln/@w`, in points. Absent ⇒ 1pt. */
+    widthPt?: number;
+    /** `a:ln/a:prstDash/@val`. Absent ⇒ solid. */
+    dash?: EditorLineDash;
+}
 export interface EditorImageFloatingPosition {
     relativeFrom?: string;
     align?: string;
@@ -145,6 +163,7 @@ export interface EditorImageRunData {
     linkedSrc?: string;
     crop?: EditorImageCrop;
     fillMode?: EditorImageFillMode;
+    border?: EditorImageBorder;
     rotation?: number;
     flipH?: boolean;
     flipV?: boolean;

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

@@ -1,4 +1,4 @@
-import { EditorBlockNode, EditorImageCrop, EditorImageFillMode, EditorImageFloatingLayout, EditorParagraphListStyle, EditorWrapPolygonPoint } from '../../core/model.js';
+import { EditorBlockNode, EditorImageBorder, EditorImageCrop, EditorImageFillMode, EditorImageFloatingLayout, EditorParagraphListStyle, EditorWrapPolygonPoint } from '../../core/model.js';
 import { BookmarkEventsByParagraph } from './bookmarksXml.js';
 import { CommentEventsByParagraph } from './commentsXml.js';
 
@@ -36,6 +36,7 @@ export interface DocContext {
         alt?: string;
         crop?: EditorImageCrop;
         fillMode?: EditorImageFillMode;
+        border?: EditorImageBorder;
         rotation?: number;
         flipH?: boolean;
         flipV?: boolean;

package/dist/export/docx/text/drawingContainerXml.d.ts

@@ -1,8 +1,14 @@
-import { EditorImageFloatingLayout, EditorWrapPolygonPoint } from '../../../core/model.js';
+import { EditorImageBorder, EditorImageFloatingLayout, EditorWrapPolygonPoint } from '../../../core/model.js';
 import { DocContext } from '../docxTypes.js';
 
 export declare function buildXfrmAttrs(img: DocContext["images"][number]): string;
 export declare function buildSrcRect(crop: DocContext["images"][number]["crop"]): string;
+/**
+ * The picture outline. Belongs inside `pic:spPr` right after `a:prstGeom` —
+ * `CT_ShapeProperties` sequences xfrm, geometry, fill, then `a:ln` (a picture's
+ * fill lives in `pic:blipFill`, so nothing sits between the two here).
+ */
+export declare function buildImageLnXml(border: EditorImageBorder | undefined): string;
 export declare function buildDrawingContainerXml(options: {
     cx: number;
     cy: number;

package/dist/export/pdf/draw/drawImageObject.d.ts

@@ -0,0 +1,14 @@
+import { EditorDocument, EditorImageRunData } from '../../../core/model.js';
+import { OasisPdfWriter } from '../OasisPdfWriter.js';
+
+/**
+ * Draws one image — inline or floating — onto a page: the XObject itself, then
+ * its picture outline (`pic:spPr/a:ln`) if it has one. Shared by both call
+ * sites so the two can never drift on border handling.
+ *
+ * The rect passed in is the displayed box, in points. Crop never changes it:
+ * `drawImage` already clips the (enlarged) source to this same box, so the
+ * outline hugs what the reader sees. Rotation is applied around the box centre,
+ * mirroring `paintTextBox`.
+ */
+export declare function drawImageObject(writer: OasisPdfWriter, pageIndex: number, document: EditorDocument, image: EditorImageRunData, x: number, y: number, width: number, height: number): Promise<void>;

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

@@ -87,6 +87,8 @@ export interface OasisPdfRectOptions {
     fill?: string;
     stroke?: string;
     lineWidth?: number;
+    /** Stroke dash pattern, in points. Ignored without a `stroke`. */
+    dashArray?: number[];
 }
 export interface OasisPdfLineOptions {
     x1: number;

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

@@ -389,6 +389,7 @@ export declare const en: {
     "ribbon.group.cellSize": string;
     "ribbon.group.alignment": string;
     "ribbon.group.size": string;
+    "ribbon.group.imageStyles": string;
     "image.crop": string;
     "image.height": string;
     "image.width": string;
@@ -400,6 +401,20 @@ export declare const en: {
     "image.cropRatio.2x3": string;
     "image.cropRatio.3x4": string;
     "image.cropRatio.9x16": string;
+    "image.border": string;
+    "image.borderNone": string;
+    "image.borderMoreColors": string;
+    "image.borderWeight": string;
+    "image.borderDashes": string;
+    "image.borderDash.solid": string;
+    "image.borderDash.sysDot": string;
+    "image.borderDash.sysDash": string;
+    "image.borderDash.dot": string;
+    "image.borderDash.dash": string;
+    "image.borderDash.dashDot": string;
+    "image.borderDash.lgDash": string;
+    "image.borderDash.lgDashDot": string;
+    "image.borderDash.lgDashDotDot": string;
     "toolbar.exportDocx": string;
     "toolbar.exportPdf": string;
     "underline.style.single": string;

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

@@ -389,6 +389,7 @@ export declare const ptBR: {
     "ribbon.group.cellSize": string;
     "ribbon.group.alignment": string;
     "ribbon.group.size": string;
+    "ribbon.group.imageStyles": string;
     "image.crop": string;
     "image.height": string;
     "image.width": string;
@@ -400,6 +401,20 @@ export declare const ptBR: {
     "image.cropRatio.2x3": string;
     "image.cropRatio.3x4": string;
     "image.cropRatio.9x16": string;
+    "image.border": string;
+    "image.borderNone": string;
+    "image.borderMoreColors": string;
+    "image.borderWeight": string;
+    "image.borderDashes": string;
+    "image.borderDash.solid": string;
+    "image.borderDash.sysDot": string;
+    "image.borderDash.sysDash": string;
+    "image.borderDash.dot": string;
+    "image.borderDash.dash": string;
+    "image.borderDash.dashDot": string;
+    "image.borderDash.lgDash": string;
+    "image.borderDash.lgDashDot": string;
+    "image.borderDash.lgDashDotDot": string;
     "toolbar.exportDocx": string;
     "toolbar.exportPdf": string;
     "underline.style.single": string;