@a3s-lab/office 0.44.0 → 0.45.0

package/README.md

@@ -309,6 +309,18 @@ and [CLI reference](./docs/latest/en/cli-reference.md).
 
 ## Current release
 
+Version `0.45.0` adds bounded Writer picture transforms without introducing a
+second document model or a remote service:
+
+- The contextual **Picture** ribbon now exposes quarter-turn rotation plus
+  horizontal and vertical reflection with accessible Lucide icons. **Picture
+  Properties** keeps the same controls in a responsive dialog, and each
+  confirmed change is one undoable, controlled update.
+- The transform is projected consistently into editing, preview, PDF capture,
+  and the native DOCX `a:xfrm` fields (`rot`, `flipH`, and `flipV`). Imported
+  90-degree/reflection values reopen as editable state, while arbitrary-angle
+  or malformed values produce a compatibility diagnostic and normalize safely.
+
 Version `0.44.0` adds dependent local dropdowns to Spreadsheet Data Validation
 without introducing a remote service:
 

package/dist/0~2330.js

@@ -1,5 +1,5 @@
 import { documentRunBorderDomAttributes, normalizeDocumentRunBorder, normalizeDocumentParagraphBorder, serializeDocumentRunBorder, serializeDocumentRunShading, documentIndexEntryHtml, attribute as work_ooxml_package_attribute, documentScriptFontFallbackSlots, documentScriptFontsDomAttributes, documentHighlightFromDocxValue, serializeDocxThemeReference, directChildren as work_ooxml_package_directChildren, documentParagraphShadingDomAttributes, documentTableOfContentsHtml, documentParagraphBordersDomAttributes, normalizeDocumentScriptFontHint, normalizeDocumentScriptFonts, DOCUMENT_PARAGRAPH_BORDER_STYLES, normalizeDocumentParagraphBorders as work_document_paragraph_borders_normalizeDocumentParagraphBorders, DOCUMENT_PARAGRAPH_BORDER_EDGES, documentScriptFontFamily, normalizeDocumentThemeFont, normalizeDocumentParagraphId, documentHighlightDomAttributes, descendants, documentIndexHtml, documentHighlightCssColor, xmlNamespacePrefix, normalizeDocumentFontName, documentProofingDomAttributes, work_document_paragraph_shading_DOCUMENT_PARAGRAPH_SHADING_PATTERNS, directChild, documentScriptFontSegments, childPath, parseDocumentTableOfContentsInstruction, documentRunShadingDomAttributes } from "./6968.js";
-import { docxThemeFont, XML_NAMESPACE as work_docx_settings_xml_XML_NAMESPACE, parseDocumentIndexEntryInstruction, resolveDocxProofing, parseDocumentIndexInstruction, DOCX_WORD_2010_NAMESPACE, XMLNS_NAMESPACE as work_docx_settings_xml_XMLNS_NAMESPACE, STRICT_WORDPROCESSING_NAMESPACE, docxCharacterSpacingTwipsFromProperties, parseBoundedDocxInteger, xmlAttributeLocalName, resolveDocxOpenTypeFeatures, docxCharacterScalePercentFromProperties, resolveDocxEmphasisMark, docxCharacterPositionHalfPointsFromProperties, docxThemeColor, parseDocxParagraphDefaultCollapsed, resolveDocxKerningThresholdHalfPoints, resolveDocxThemeResolver as work_docx_theme_resolveDocxThemeResolver, DOCX_WORDPROCESSING_NAMESPACES, xmlAttributeNamespace, parseDocxTwipsMeasure } from "./0~5024.js";
+import { docxThemeFont, XML_NAMESPACE as work_docx_settings_xml_XML_NAMESPACE, parseDocumentIndexEntryInstruction, resolveDocxProofing, parseDocumentIndexInstruction, DOCX_WORD_2010_NAMESPACE, XMLNS_NAMESPACE as work_docx_settings_xml_XMLNS_NAMESPACE, STRICT_WORDPROCESSING_NAMESPACE, docxCharacterSpacingTwipsFromProperties, parseBoundedDocxInteger, xmlAttributeLocalName, resolveDocxOpenTypeFeatures, docxCharacterScalePercentFromProperties, resolveDocxEmphasisMark, docxCharacterPositionHalfPointsFromProperties, docxThemeColor, parseDocxParagraphDefaultCollapsed, resolveDocxKerningThresholdHalfPoints, resolveDocxThemeResolver as work_docx_theme_resolveDocxThemeResolver, DOCX_WORDPROCESSING_NAMESPACES, xmlAttributeNamespace, parseDocxTwipsMeasure } from "./0~4042.js";
 import { normalizeDocumentEmphasisMark, normalizeDocumentPageBorders, documentCharacterPositionDomAttributes, DOCUMENT_PAGE_BORDER_EDGES, normalizeDocumentTabStops, documentTextCaseFromWordFlags, documentStrikeDomAttributes, serializeDocumentNumberingChange, numberingTypeFromFormat, normalizeDocumentUnderlineColor, documentAutoLineHeight, documentKerningDomAttributes, documentCharacterScaleDomAttributes, serializeDocumentParagraphFormatting, normalizeDocumentPaperSource, documentEquationText, documentLegacyTextEffectsDomAttributes, documentLegacyTextEffectsConflict, documentCharacterSpacingDomAttributes, normalizeDocumentParagraphIndent, normalizeDocumentEquation, documentOpenTypeDomAttributes, renderDocumentAutoLineHeight, documentUnderlineDomAttributes, MAX_DOCUMENT_NUMBERING_START, normalizeDocumentUnderlineStyle, applyDocumentTextCaseStyle, documentHiddenTextDomAttributes, importedDocumentCharacterFormatting, DOCUMENT_LEGACY_TEXT_EFFECT_NAMES, createDocumentEquationElement, normalizeDocumentPageGeometry, serializeDocumentTabStops, documentWordLineHeightFactor, documentEmphasisMarkDomAttributes, normalizeDocumentPageMargins } from "./4174.js";
 function docxCaptionSequenceKind(instruction) {
     const identifier = /^\s*SEQ\s+([^\s\\]+)/i.exec(instruction)?.[1]?.toLowerCase();

package/dist/{0~5024.js → 0~4042.js}

@@ -1,6 +1,6 @@
 import jszip from "jszip";
 import { normalizeDocumentIndexEntryDraft, serializeUtf8Xml, directChildren, xmlNamespacePrefix, normalizeDocumentLanguageTag, parseXml, firstDescendant, decodeXmlBytes, directChild, descendants, normalizeDocumentProofingLanguages, attribute as work_ooxml_package_attribute, normalizeDocumentIndexOptions } from "./6968.js";
-import { normalizeDocumentEmphasisMark, normalizeDocumentCharacterScalePercent, documentCitationStyle, normalizeDocumentKerningThresholdHalfPoints, normalizeDocumentCharacterPositionHalfPoints, normalizeDocumentCharacterSpacingTwips, normalizeDocumentOpenTypeNumberSpacing, createDocumentBibliography, normalizeDocumentOpenTypeNumberForm, normalizeDocumentOpenTypeLigatures, normalizeDocumentTabStops, documentCitationStyleDetails, normalizeDocumentOpenTypeStylisticSets } from "./4174.js";
+import { normalizeDocumentEmphasisMark, normalizeDocumentCharacterScalePercent, documentCitationStyle, normalizeDocumentCharacterPositionHalfPoints, normalizeDocumentCharacterSpacingTwips, normalizeDocumentKerningThresholdHalfPoints, normalizeDocumentOpenTypeNumberSpacing, createDocumentBibliography, normalizeDocumentImageTransform, normalizeDocumentOpenTypeLigatures, normalizeDocumentOpenTypeNumberForm, normalizeDocumentTabStops, documentCitationStyleDetails, normalizeDocumentOpenTypeStylisticSets } from "./4174.js";
 const BIBLIOGRAPHY_NAMESPACE = 'http://schemas.openxmlformats.org/officeDocument/2006/bibliography';
 const CUSTOM_XML_NAMESPACE = 'http://schemas.openxmlformats.org/officeDocument/2006/customXml';
 const OFFICE_RELATIONSHIPS_NAMESPACE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships';
@@ -708,6 +708,114 @@ function isAllowedExtensionNamespace(namespace, context) {
 function isNamespacePrefix(value) {
     return /^[A-Za-z_][A-Za-z0-9_.-]*$/.test(value) && 'xml' !== value;
 }
+const DOCX_ROTATION_UNITS_PER_DEGREE = 60000;
+const DOCX_QUADRANT_ROTATION_UNITS = 5400000;
+function readDocxImageTransform(drawing) {
+    const target = pictureTransform(drawing);
+    if (!target) return {
+        transform: null,
+        supported: true
+    };
+    const rawRotation = work_ooxml_package_attribute(target, 'rot');
+    const rawFlipHorizontal = work_ooxml_package_attribute(target, 'flipH');
+    const rawFlipVertical = work_ooxml_package_attribute(target, 'flipV');
+    const rotation = parseRotation(rawRotation);
+    const flipHorizontal = parseFlip(rawFlipHorizontal);
+    const flipVertical = parseFlip(rawFlipVertical);
+    const supported = null !== rotation && null !== flipHorizontal && null !== flipVertical && (0 === rotation || rotation % DOCX_QUADRANT_ROTATION_UNITS === 0);
+    const normalized = normalizeDocumentImageTransform({
+        rotation: null === rotation ? 0 : rotation / DOCX_ROTATION_UNITS_PER_DEGREE,
+        flipHorizontal: flipHorizontal ?? false,
+        flipVertical: flipVertical ?? false
+    });
+    return {
+        transform: 0 !== normalized.rotation || normalized.flipHorizontal || normalized.flipVertical ? normalized : null,
+        supported
+    };
+}
+class DocxImageTransformPatchCollector {
+    patches = [];
+    nextMarker = 1;
+    marker(transform) {
+        if (!transform) return '';
+        const normalized = normalizeDocumentImageTransform(transform);
+        if (0 === normalized.rotation && !normalized.flipHorizontal && !normalized.flipVertical) return '';
+        const marker = `__A3S_IMAGE_TRANSFORM_${this.nextMarker}__`;
+        this.nextMarker += 1;
+        this.patches.push({
+            marker,
+            transform: normalized
+        });
+        return marker;
+    }
+}
+async function patchDocxImageTransforms(buffer, patches) {
+    if (!patches.length) return buffer;
+    const archive = await jszip.loadAsync(buffer);
+    const entries = Object.values(archive.files).filter((entry)=>!entry.dir && /^word\/(?:document|header\d+|footer\d+|footnotes|endnotes|comments)\.xml$/.test(entry.name));
+    const byMarker = new Map(patches.map((patch)=>[
+            patch.marker,
+            patch
+        ]));
+    for (const entry of entries){
+        const document = parseXml(await entry.async('text'), entry.name);
+        let changed = false;
+        for (const properties of descendants(document, 'docPr')){
+            const patch = imageTransformPatch(properties, byMarker);
+            if (!patch) continue;
+            removeTransformMarker(properties, patch.marker);
+            changed = true;
+            const drawing = closestDrawing(properties);
+            const transform = drawing ? pictureTransform(drawing) : void 0;
+            if (transform) applyImageTransform(transform, patch.transform);
+        }
+        if (changed) archive.file(entry.name, new XMLSerializer().serializeToString(document));
+    }
+    return archive.generateAsync({
+        type: 'arraybuffer'
+    });
+}
+function imageTransformPatch(properties, patches) {
+    for (const attribute of Array.from(properties.attributes))for (const [marker, patch] of patches)if (attribute.value.includes(marker)) return patch;
+    return null;
+}
+function removeTransformMarker(properties, marker) {
+    for (const attribute of Array.from(properties.attributes))if (attribute.value.includes(marker)) attribute.value = attribute.value.replace(marker, '');
+}
+function closestDrawing(element) {
+    let current = element;
+    while(current){
+        if ('anchor' === current.localName || 'inline' === current.localName) return current;
+        current = current.parentElement;
+    }
+    return null;
+}
+function pictureTransform(drawing) {
+    const picture = descendants(drawing, 'pic')[0];
+    const properties = picture ? directChild(picture, 'spPr') : void 0;
+    return properties ? directChild(properties, 'xfrm') : descendants(drawing, 'xfrm')[0];
+}
+function parseRotation(value) {
+    if (null === value || !value.trim()) return 0;
+    const number = Number(value);
+    return Number.isInteger(number) && number >= 0 ? number : null;
+}
+function parseFlip(value) {
+    if (null === value || !value.trim()) return false;
+    const normalized = value.trim().toLowerCase();
+    if ('1' === normalized || 'true' === normalized) return true;
+    if ('0' === normalized || 'false' === normalized) return false;
+    return null;
+}
+function applyImageTransform(target, transform) {
+    const normalized = normalizeDocumentImageTransform(transform);
+    if (0 === normalized.rotation) target.removeAttribute('rot');
+    else target.setAttribute('rot', String(normalized.rotation * DOCX_ROTATION_UNITS_PER_DEGREE));
+    if (normalized.flipHorizontal) target.setAttribute('flipH', '1');
+    else target.removeAttribute('flipH');
+    if (normalized.flipVertical) target.setAttribute('flipV', '1');
+    else target.removeAttribute('flipV');
+}
 function parseDocumentIndexEntryInstruction(instruction) {
     const command = /^\s*XE\b/i.exec(instruction);
     if (!command) return {
@@ -2072,4 +2180,4 @@ function isParagraphPartRoot(root, path) {
     const expected = /^word\/header\d*\.xml$/i.test(path) ? 'hdr' : /^word\/footer\d*\.xml$/i.test(path) ? 'ftr' : /^word\/footnotes\.xml$/i.test(path) ? 'footnotes' : /^word\/endnotes\.xml$/i.test(path) ? 'endnotes' : 'document';
     return root.localName === expected && DOCX_WORDPROCESSING_NAMESPACES.has(root.namespaceURI ?? '');
 }
-export { DOCX_COLOR_SCHEME_MAPPING_ATTRIBUTES, DOCX_WORDPROCESSING_NAMESPACES, DOCX_WORD_2010_NAMESPACE, DocxParagraphDefaultCollapsedPatchCollector, STRICT_WORDPROCESSING_NAMESPACE, XMLNS_NAMESPACE, XML_NAMESPACE, assertXmlRoot, cloneXmlElement, createDocxThemeResolver, cssColorToHex, cssFontFamily, cssFontSize, dataBoolean, documentIndexEntryInstruction, documentIndexInstruction, documentProofingLanguageDocxOptions, docxCharacterPositionHalfPointsFromProperties, docxCharacterPositionValue, docxCharacterScalePercentFromProperties, docxCharacterScaleValue, docxCharacterSpacingTwipsFromProperties, docxCharacterSpacingValue, docxEmphasisMarkRunOptions, docxKerningThresholdValue, docxThemeColor, docxThemeFont, domDirection, hasNonWhitespaceXmlText, inspectDocxEmphasisMark, inspectDocxKerningThresholdHalfPoints, inspectDocxNoProof, inspectDocxProofingLanguages, mergeDocxIgnorableExtensions, mergeDocxIgnorableExtensionsAtPairs, paragraphAlignment, paragraphBidirectional, paragraphDirectionOptions, paragraphIndent, paragraphPaginationOptions, paragraphSpacingOptions, paragraphTabStops, parseBoundedDocxInteger, parseDocumentIndexEntryInstruction, parseDocumentIndexInstruction, parseDocxColorSchemeMappingElement, parseDocxParagraphDefaultCollapsed, parseDocxTwipsMeasure, patchDocxBibliography, patchDocxExplicitZeroCharacterSpacing, patchDocxExplicitZeroKerningThresholds, patchDocxParagraphDefaultCollapsed, readDocxBibliography, resolveDocxEmphasisMark, resolveDocxKerningThresholdHalfPoints, resolveDocxOpenTypeFeatures, resolveDocxProofing, resolveDocxThemeResolver, xmlAttributeLocalName, xmlAttributeNamespace, xmlDeclaredPrefix, xmlNamespaceUri };
+export { DOCX_COLOR_SCHEME_MAPPING_ATTRIBUTES, DOCX_WORDPROCESSING_NAMESPACES, DOCX_WORD_2010_NAMESPACE, DocxImageTransformPatchCollector, DocxParagraphDefaultCollapsedPatchCollector, STRICT_WORDPROCESSING_NAMESPACE, XMLNS_NAMESPACE, XML_NAMESPACE, assertXmlRoot, cloneXmlElement, createDocxThemeResolver, cssColorToHex, cssFontFamily, cssFontSize, dataBoolean, documentIndexEntryInstruction, documentIndexInstruction, documentProofingLanguageDocxOptions, docxCharacterPositionHalfPointsFromProperties, docxCharacterPositionValue, docxCharacterScalePercentFromProperties, docxCharacterScaleValue, docxCharacterSpacingTwipsFromProperties, docxCharacterSpacingValue, docxEmphasisMarkRunOptions, docxKerningThresholdValue, docxThemeColor, docxThemeFont, domDirection, hasNonWhitespaceXmlText, inspectDocxEmphasisMark, inspectDocxKerningThresholdHalfPoints, inspectDocxNoProof, inspectDocxProofingLanguages, mergeDocxIgnorableExtensions, mergeDocxIgnorableExtensionsAtPairs, paragraphAlignment, paragraphBidirectional, paragraphDirectionOptions, paragraphIndent, paragraphPaginationOptions, paragraphSpacingOptions, paragraphTabStops, parseBoundedDocxInteger, parseDocumentIndexEntryInstruction, parseDocumentIndexInstruction, parseDocxColorSchemeMappingElement, parseDocxParagraphDefaultCollapsed, parseDocxTwipsMeasure, patchDocxBibliography, patchDocxExplicitZeroCharacterSpacing, patchDocxExplicitZeroKerningThresholds, patchDocxImageTransforms, patchDocxParagraphDefaultCollapsed, readDocxBibliography, readDocxImageTransform, resolveDocxEmphasisMark, resolveDocxKerningThresholdHalfPoints, resolveDocxOpenTypeFeatures, resolveDocxProofing, resolveDocxThemeResolver, xmlAttributeLocalName, xmlAttributeNamespace, xmlDeclaredPrefix, xmlNamespaceUri };

package/dist/0~document-editor.js

@@ -6,7 +6,7 @@ import { Fragment as external_react_Fragment, forwardRef, useCallback, useEffect
 import { Extension, createNodeFromContent } from "@tiptap/core";
 import { NodeSelection, Plugin, PluginKey, TextSelection } from "@tiptap/pm/state";
 import { Decoration, DecorationSet } from "@tiptap/pm/view";
-import { AArrowDown, AArrowUp, ALargeSmall, AlignCenter, AlignJustify, AlignLeft, AlignRight, AlignVerticalJustifyCenter, AlignVerticalJustifyEnd, AlignVerticalJustifyStart, ArrowDown, ArrowUp, BetweenHorizontalEnd, BetweenHorizontalStart, BetweenVerticalEnd, BetweenVerticalStart, Bold, BookMarked, BookOpen, Bookmark, CaseUpper, Check, CheckCheck, CheckCircle2, ChevronDown, ChevronRight, ChevronUp, ClipboardCopy, ClipboardPaste, Cloud, Columns3, Eraser, Eye, FileCheck2, FileDiff, FilePlus2, FileStack, FileText, FileUp, GitCompareArrows, Globe2, Grid2X2, Hash, Highlighter, Image, IndentDecrease, IndentIncrease, Italic, Languages, Link2, List, ListChecks, ListOrdered, ListTree, MessageSquarePlus, MessageSquareReply, MessagesSquare, MoveVertical, Paintbrush, Palette, PanelBottom, PanelBottomOpen, PanelLeftOpen, PanelTop, PanelTopOpen, Pilcrow, PilcrowLeft, PilcrowRight, Plus, Quote, Redo2, RefreshCw, Replace, ReplaceAll, RotateCcw, Rows3, Ruler, Scan, Search, Settings2, Square, StretchHorizontal, Strikethrough, Subscript, Superscript, Table2, TableCellsMerge, TableCellsSplit, TableProperties, Tags, TextWrap, Trash2, TriangleAlert, Type, Underline, Undo2, Unlink, Unlink2, X, XCircle, ZoomIn, ZoomOut } from "lucide-react";
+import { AArrowDown, AArrowUp, ALargeSmall, AlignCenter, AlignJustify, AlignLeft, AlignRight, AlignVerticalJustifyCenter, AlignVerticalJustifyEnd, AlignVerticalJustifyStart, ArrowDown, ArrowUp, BetweenHorizontalEnd, BetweenHorizontalStart, BetweenVerticalEnd, BetweenVerticalStart, Bold, BookMarked, BookOpen, Bookmark, CaseUpper, Check, CheckCheck, CheckCircle2, ChevronDown, ChevronRight, ChevronUp, ClipboardCopy, ClipboardPaste, Cloud, Columns3, Eraser, Eye, FileCheck2, FileDiff, FilePlus2, FileStack, FileText, FileUp, FlipHorizontal2, FlipVertical2, GitCompareArrows, Globe2, Grid2X2, Hash, Highlighter, Image, IndentDecrease, IndentIncrease, Italic, Languages, Link2, List, ListChecks, ListOrdered, ListTree, MessageSquarePlus, MessageSquareReply, MessagesSquare, MoveVertical, Paintbrush, Palette, PanelBottom, PanelBottomOpen, PanelLeftOpen, PanelTop, PanelTopOpen, Pilcrow, PilcrowLeft, PilcrowRight, Plus, Quote, Redo2, RefreshCw, Replace, ReplaceAll, RotateCcw, RotateCw, Rows3, Ruler, Scan, Search, Settings2, Square, StretchHorizontal, Strikethrough, Subscript, Superscript, Table2, TableCellsMerge, TableCellsSplit, TableProperties, Tags, TextWrap, Trash2, TriangleAlert, Type, Underline, Undo2, Unlink, Unlink2, X, XCircle, ZoomIn, ZoomOut } from "lucide-react";
 import { Fragment as model_Fragment, Node as model_Node } from "@tiptap/pm/model";
 import extension_color from "@tiptap/extension-color";
 import { TableKit } from "@tiptap/extension-table";
@@ -16,7 +16,7 @@ import starter_kit from "@tiptap/starter-kit";
 import { BubbleMenu } from "@tiptap/react/menus";
 import { TableMap, isInTable, selectedRect } from "@tiptap/pm/tables";
 import { closeHistory } from "@tiptap/pm/history";
-import { documentTableSizing, transferChangedDocumentTextStatistics, documentPageBordersVisible, documentUnderlineStyle, DOCUMENT_PAGE_BORDER_EDGES, documentTableRowOptions, normalizeDocumentColumns, clampDocumentMargin, materializeLazyDocumentEditorRoot, documentKerningThresholdPoints, selectedDocumentIndexOptions, nextDocumentTabAlignment, DOCUMENT_BOOKMARK_DUPLICATE_MESSAGE, normalizedTabPosition, documentCitationCount, resolveDocumentPageBorders, documentLazyHtmlChunkFragment, DocumentFontFamily, normalizeDocumentHiddenText, documentLegacyTextEffectsConflict, DOCUMENT_CHUNK_VISIBLE_IDS_META, selectedDocumentIndexDraft, MAX_DOCUMENT_IMAGE_RELATIVE_HEIGHT, retainAnchoredDocumentComments, DocumentTableRowIdentity, work_document_page_margins_twipsToMillimeters, DEFAULT_DOCUMENT_TABLE_CELL_FORMAT, resolveWorkDocumentEditorInput, documentOpenTypeCssProperties, documentBulletListStyle, documentCharacterPositionPoints, collectDocumentTextLayoutParagraphs, readOfficeDocumentCollaboration as readWorkOfficeDocumentCollaboration, normalizeDocumentCharacterScalePercent, DOCUMENT_PARAGRAPH_FORMAT_ATTRIBUTES, documentOrderedListState, normalizeDocumentPageChrome, documentTextStatistics, documentPageMarginsForLayout, invalidateDocumentLazyHtmlProjection, documentTableCellFormat, normalizeDocumentPageGeometry, normalizeDocumentImageLayer, documentImageProperties, isValidDocumentCitationTag, sanitizeDocumentPageChromeHtml, pageTwipsToMillimeters, normalizeDocumentPageBorders, importWorkDocumentFile, DocumentParagraphFormatting, documentModelHasTrustedInitialIntegrityFeatures, normalizeDocumentHtml, documentInitialSectionLayout, activeDocumentSection, documentParagraphDirection, documentParagraphPagination, normalizeDocumentOpenTypeFeatures, isDocumentCharacterFormatMark, documentModelUsesWindowing, documentPageChromeLegacyFields, documentChunkMountedIds, collectDocumentCommentAnchors, documentTextCaseKeyboardShortcuts, DocumentTextStyle, canChangeDocumentIndent, patchDocumentOpenTypeFeatures, normalizeDocumentOpenTypeNumberForm, parseDocumentOpenTypeFeatures, documentCharacterSpacingPoints, documentKerningIsEffective, DocumentSuperscript, documentSectionById, activeDocumentBookmark, DocumentEquation, documentLazyHtmlProjectionFingerprint, documentLazyHtmlProjection, normalizeDocumentParagraphIndent, updateDocumentGutterPosition, DocumentStrike, mountWorkLiveDocumentCapture, registerDocumentPageSurfaceGeometry, documentHiddenTextKeyboardShortcut, documentHasIndex, syncDocumentContentFromHtml, documentLegacyTextEffectsCss, editorDocumentCaptionTargets, resolveDocumentPageChrome, documentImageLayoutOptions, MAX_DOCUMENT_NUMBERING_START, resolveDocumentPageSize, normalizeDocumentOpenTypeNumberSpacing, editorDocumentBookmarkReferenceTargets, serializeWorkDocumentNode, DOCUMENT_CHUNK_PAGINATION_META, documentModelForContent, createOfficeDocumentCollaborationBinding as createWorkOfficeDocumentCollaborationBinding, documentLegacyTextEffectsFromTextStyleAttributes, normalizeDocumentEmphasisMark, selectedDocumentChunkId, documentCommentViews, documentParagraphSpacing, normalizeDocumentTabStops, patchDocumentLazyHtmlProjection, normalizeDocumentTextCase, documentUnderlineColor, documentBookmarkNameExists, collectDocumentChanges, DocumentImage, selectedDocumentTableOfContentsOptions, resolveDocumentPageMargins, updateDocumentPageMarginMode, serializeDocumentParagraphFormatting, canSetDocumentTableRowRepeatHeader, isDocumentOpenTypeFeaturePatch, normalizeDocumentCharacterSpacingTwips, DocumentCharacterFormatting, millimetersToPixels as work_document_layout_millimetersToPixels, DOCUMENT_PARAGRAPH_CHANGE_ATTRIBUTES, serializeDocumentCharacterFormatting, DOCUMENT_CHUNK_HYDRATION_META, documentTabLeaderLabel, createSchemaDerivedWorkDocumentModel, updateDocumentCustomPageMillimeters, DocumentUnderline, documentCommentDraftRange, documentParagraphTabStops, documentTableHorizontalAlignment, documentUnderlineKeyboardShortcuts, documentParagraphIndent, DocumentScriptFontFormatting, canInsertDocumentComment, resolveAllDocumentChanges, serializeDocumentOpenTypeFeatures, documentHasTableOfContents, documentTextLayoutBatches, normalizeDocumentImageWrapSide, updateDocumentPageOrientation, documentCitationStyleDetails, validateDocumentBookmarkName, setCustomDocumentColumns, updateDocumentPageMarginMillimeters, normalizeDocumentCharacterPositionHalfPoints, documentCitationStyle, documentTransactionsOnlyHydrateChunks, normalizeDocumentKerningThresholdHalfPoints, forgetSourceBlob as forgetWorkSourceBlob, DEFAULT_DOCUMENT_TABLE_CELL_MARGINS, DOCUMENT_TABLE_STYLE_OPTIONS, updateDocumentColumnWidth, updateDocumentPaperSizePreset, documentPageMetrics, documentStrikeStyle, DocumentHighlight, createDocumentBibliography, DocumentSubscript, normalizeDocumentOpenTypeLigatures, selectedDocumentIndexEntry, updateDocumentPageChromeVariant, updateDocumentMirrorMargins, activeDocumentTableStyle, measureDocumentLayoutBlocksIncrementally, documentWordLineHeightFactor, normalizeDocumentLegacyTextEffect, createWorkDocumentExtensions } from "./4174.js";
+import { documentTableSizing, transferChangedDocumentTextStatistics, documentPageBordersVisible, documentUnderlineStyle, DOCUMENT_PAGE_BORDER_EDGES, documentTableRowOptions, normalizeDocumentColumns, clampDocumentMargin, materializeLazyDocumentEditorRoot, documentKerningThresholdPoints, selectedDocumentIndexOptions, nextDocumentTabAlignment, DOCUMENT_BOOKMARK_DUPLICATE_MESSAGE, normalizedTabPosition, documentCitationCount, resolveDocumentPageBorders, documentLazyHtmlChunkFragment, DocumentFontFamily, normalizeDocumentHiddenText, documentLegacyTextEffectsConflict, DOCUMENT_CHUNK_VISIBLE_IDS_META, selectedDocumentIndexDraft, MAX_DOCUMENT_IMAGE_RELATIVE_HEIGHT, retainAnchoredDocumentComments, DocumentTableRowIdentity, work_document_page_margins_twipsToMillimeters, DEFAULT_DOCUMENT_TABLE_CELL_FORMAT, resolveWorkDocumentEditorInput, defaultDocumentImageTransform, documentOpenTypeCssProperties, documentBulletListStyle, documentCharacterPositionPoints, collectDocumentTextLayoutParagraphs, readOfficeDocumentCollaboration as readWorkOfficeDocumentCollaboration, normalizeDocumentCharacterScalePercent, DOCUMENT_PARAGRAPH_FORMAT_ATTRIBUTES, documentOrderedListState, normalizeDocumentPageChrome, documentTextStatistics, documentPageMarginsForLayout, invalidateDocumentLazyHtmlProjection, documentTableCellFormat, normalizeDocumentImageTransform, normalizeDocumentPageGeometry, documentImageProperties, normalizeDocumentImageLayer, isValidDocumentCitationTag, sanitizeDocumentPageChromeHtml, pageTwipsToMillimeters, normalizeDocumentPageBorders, importWorkDocumentFile, DocumentParagraphFormatting, documentModelHasTrustedInitialIntegrityFeatures, normalizeDocumentHtml, documentInitialSectionLayout, activeDocumentSection, documentParagraphDirection, documentParagraphPagination, normalizeDocumentOpenTypeFeatures, isDocumentCharacterFormatMark, documentModelUsesWindowing, documentPageChromeLegacyFields, documentChunkMountedIds, collectDocumentCommentAnchors, documentTextCaseKeyboardShortcuts, DocumentTextStyle, canChangeDocumentIndent, patchDocumentOpenTypeFeatures, normalizeDocumentOpenTypeNumberForm, parseDocumentOpenTypeFeatures, documentCharacterSpacingPoints, documentKerningIsEffective, DocumentSuperscript, documentSectionById, activeDocumentBookmark, DocumentEquation, documentLazyHtmlProjectionFingerprint, documentLazyHtmlProjection, normalizeDocumentParagraphIndent, updateDocumentGutterPosition, DocumentStrike, mountWorkLiveDocumentCapture, registerDocumentPageSurfaceGeometry, documentHiddenTextKeyboardShortcut, documentHasIndex, syncDocumentContentFromHtml, documentLegacyTextEffectsCss, editorDocumentCaptionTargets, resolveDocumentPageChrome, documentImageLayoutOptions, MAX_DOCUMENT_NUMBERING_START, resolveDocumentPageSize, normalizeDocumentOpenTypeNumberSpacing, editorDocumentBookmarkReferenceTargets, serializeWorkDocumentNode, DOCUMENT_CHUNK_PAGINATION_META, documentModelForContent, createOfficeDocumentCollaborationBinding as createWorkOfficeDocumentCollaborationBinding, documentLegacyTextEffectsFromTextStyleAttributes, normalizeDocumentEmphasisMark, selectedDocumentChunkId, documentCommentViews, documentParagraphSpacing, normalizeDocumentTabStops, patchDocumentLazyHtmlProjection, normalizeDocumentTextCase, documentUnderlineColor, documentBookmarkNameExists, collectDocumentChanges, DocumentImage, selectedDocumentTableOfContentsOptions, resolveDocumentPageMargins, updateDocumentPageMarginMode, serializeDocumentParagraphFormatting, canSetDocumentTableRowRepeatHeader, isDocumentOpenTypeFeaturePatch, normalizeDocumentCharacterSpacingTwips, DocumentCharacterFormatting, millimetersToPixels as work_document_layout_millimetersToPixels, DOCUMENT_PARAGRAPH_CHANGE_ATTRIBUTES, serializeDocumentCharacterFormatting, DOCUMENT_CHUNK_HYDRATION_META, documentTabLeaderLabel, createSchemaDerivedWorkDocumentModel, updateDocumentCustomPageMillimeters, DocumentUnderline, documentCommentDraftRange, documentParagraphTabStops, documentTableHorizontalAlignment, documentUnderlineKeyboardShortcuts, documentParagraphIndent, DocumentScriptFontFormatting, canInsertDocumentComment, resolveAllDocumentChanges, serializeDocumentOpenTypeFeatures, documentHasTableOfContents, documentTextLayoutBatches, normalizeDocumentImageWrapSide, updateDocumentPageOrientation, documentCitationStyleDetails, validateDocumentBookmarkName, setCustomDocumentColumns, updateDocumentPageMarginMillimeters, normalizeDocumentCharacterPositionHalfPoints, documentCitationStyle, documentTransactionsOnlyHydrateChunks, normalizeDocumentKerningThresholdHalfPoints, forgetSourceBlob as forgetWorkSourceBlob, DEFAULT_DOCUMENT_TABLE_CELL_MARGINS, DOCUMENT_TABLE_STYLE_OPTIONS, updateDocumentColumnWidth, updateDocumentPaperSizePreset, documentPageMetrics, documentStrikeStyle, DocumentHighlight, createDocumentBibliography, DocumentSubscript, normalizeDocumentOpenTypeLigatures, selectedDocumentIndexEntry, updateDocumentPageChromeVariant, updateDocumentMirrorMargins, activeDocumentTableStyle, measureDocumentLayoutBlocksIncrementally, documentWordLineHeightFactor, normalizeDocumentLegacyTextEffect, createWorkDocumentExtensions } from "./4174.js";
 import { useOfficeTaskPaneEscape, OfficeCheckbox, useOfficeDialog, useOfficeTaskPaneModal, CommittedOfficeNumberField, createOfficeKernelClient, CollectionState, OfficeNumberField } from "./0~7831.js";
 import { moveOfficeMenuFocus, office_text_field_OfficeTextArea, Popover, officeOverlayPortalRoot, Dialog, button_Button, useOfficePublishPresenceLocation, OfficeTiptapPresenceLayer, icon_button_IconButton, office_text_field_OfficeTextField, useDialogFocusScope, useOfficeEditorWheelZoom, office_text_field_OfficeFileInput } from "./0~8136.js";
 import { WorkOfficePreviewBar, isWorkspaceContextMenuKeyboardEvent, Tabs, WorkOfficeZoomControls, WorkOfficeStatusBar, WorkOfficeRibbon, workspaceContextMenuPosition, OfficeSelect, WorkspaceContextMenu, WorkOfficeRibbonGroup, WorkOfficeRibbonButton } from "./0~9073.js";
@@ -12689,6 +12689,9 @@ function createDocumentPicturePropertiesDraft(source) {
         cropRight: formatNumber(source.properties.crop?.right ?? 0),
         cropBottom: formatNumber(source.properties.crop?.bottom ?? 0),
         cropLeft: formatNumber(source.properties.crop?.left ?? 0),
+        rotation: (source.properties.transform ?? defaultDocumentImageTransform()).rotation,
+        flipHorizontal: Boolean(source.properties.transform?.flipHorizontal),
+        flipVertical: Boolean(source.properties.transform?.flipVertical),
         relativeHeight: String(layer.relativeHeight),
         behindDocument: layer.behindDocument,
         allowOverlap: layer.allowOverlap,
@@ -12767,6 +12770,14 @@ function documentPicturePropertyChanges(initial, current) {
         };
         changes.crop = Object.values(crop).some((edge)=>edge > 0) ? crop : null;
     }
+    if (initial.rotation !== current.rotation || initial.flipHorizontal !== current.flipHorizontal || initial.flipVertical !== current.flipVertical) {
+        const transform = normalizeDocumentImageTransform({
+            rotation: current.rotation,
+            flipHorizontal: current.flipHorizontal,
+            flipVertical: current.flipVertical
+        });
+        changes.transform = 0 !== transform.rotation || transform.flipHorizontal || transform.flipVertical ? transform : null;
+    }
     if (!sameDraftNumber(initial.relativeHeight, current.relativeHeight) || initial.behindDocument !== current.behindDocument || initial.allowOverlap !== current.allowOverlap || initial.layoutInCell !== current.layoutInCell || initial.lockAnchor !== current.lockAnchor) changes.layer = normalizeDocumentImageLayer({
         relativeHeight: current.relativeHeight,
         behindDocument: current.behindDocument,
@@ -12926,6 +12937,24 @@ const verticalReferenceOptions = [
         label: '页面'
     }
 ];
+const rotationOptions = [
+    {
+        value: '0',
+        label: '0°（原始）'
+    },
+    {
+        value: '90',
+        label: '90°'
+    },
+    {
+        value: '180',
+        label: '180°'
+    },
+    {
+        value: '270',
+        label: '270°'
+    }
+];
 function DocumentPicturePropertiesControl({ editor }) {
     const [source, setSource] = useState(null);
     const triggerRef = useRef(null);
@@ -13029,6 +13058,10 @@ function DocumentPicturePropertiesDialog({ editor, source, restoreFocusTarget, o
                     errors: errors,
                     onDraftChange: setDraft
                 }),
+                /*#__PURE__*/ jsx(PictureTransformSection, {
+                    draft: draft,
+                    onDraftChange: setDraft
+                }),
                 /*#__PURE__*/ jsxs("label", {
                     className: "work-document-picture-properties-alt-text",
                     htmlFor: alternativeTextId,
@@ -13418,6 +13451,60 @@ function PictureCropSection({ draft, errors, onDraftChange }) {
         ]
     });
 }
+function PictureTransformSection({ draft, onDraftChange }) {
+    return /*#__PURE__*/ jsxs("fieldset", {
+        className: "work-document-picture-properties-section transform",
+        children: [
+            /*#__PURE__*/ jsx("legend", {
+                children: "变换"
+            }),
+            /*#__PURE__*/ jsxs("div", {
+                className: "work-document-picture-properties-transform-row",
+                children: [
+                    /*#__PURE__*/ jsx("span", {
+                        children: "旋转"
+                    }),
+                    /*#__PURE__*/ jsx(OfficeSelect, {
+                        ariaLabel: "图片旋转角度",
+                        value: String(draft.rotation),
+                        options: rotationOptions,
+                        onValueChange: (value)=>onDraftChange((current)=>({
+                                    ...current,
+                                    rotation: Number(value)
+                                }))
+                    })
+                ]
+            }),
+            /*#__PURE__*/ jsxs("div", {
+                className: "work-document-picture-properties-transform-options",
+                children: [
+                    /*#__PURE__*/ jsx(OfficeCheckbox, {
+                        ariaLabel: "水平翻转图片",
+                        checked: draft.flipHorizontal,
+                        onCheckedChange: (flipHorizontal)=>onDraftChange((current)=>({
+                                    ...current,
+                                    flipHorizontal
+                                })),
+                        children: "水平翻转"
+                    }),
+                    /*#__PURE__*/ jsx(OfficeCheckbox, {
+                        ariaLabel: "垂直翻转图片",
+                        checked: draft.flipVertical,
+                        onCheckedChange: (flipVertical)=>onDraftChange((current)=>({
+                                    ...current,
+                                    flipVertical
+                                })),
+                        children: "垂直翻转"
+                    })
+                ]
+            }),
+            /*#__PURE__*/ jsx("small", {
+                className: "work-document-picture-properties-transform-help",
+                children: "旋转以 90\xb0 为单位；每次确认作为一次可撤销操作保存。"
+            })
+        ]
+    });
+}
 function PictureNumberRow({ label, ariaLabel, value, unit, min, max, step, disabled = false, invalid, onValueChange }) {
     return /*#__PURE__*/ jsxs("div", {
         className: "work-document-picture-properties-number-row",
@@ -13481,6 +13568,7 @@ const imageWrapDistanceOptions = [
 ];
 function DocumentPictureRibbon({ editor }) {
     const image = documentImageLayoutOptions(editor);
+    const transform = documentImageProperties(editor).transform ?? defaultDocumentImageTransform();
     const imageSelected = editor.isActive('image');
     const wrapDistanceValue = String(image.wrapDistance);
     const updateLayout = (layout)=>editor.commands.setDocumentImageLayoutOptions({
@@ -13489,6 +13577,15 @@ function DocumentPictureRibbon({ editor }) {
     const updateAlignment = (alignment)=>editor.commands.setDocumentImageLayoutOptions({
             alignment
         });
+    const updateTransform = (next)=>{
+        const current = documentImageProperties(editor).transform ?? defaultDocumentImageTransform();
+        return editor.commands.setDocumentImageProperties({
+            transform: {
+                ...current,
+                ...next(current)
+            }
+        });
+    };
     return /*#__PURE__*/ jsxs(Fragment, {
         children: [
             /*#__PURE__*/ jsxs(WorkOfficeRibbonGroup, {
@@ -13582,6 +13679,53 @@ function DocumentPictureRibbon({ editor }) {
                     })
                 ]
             }),
+            /*#__PURE__*/ jsxs(WorkOfficeRibbonGroup, {
+                label: "变换",
+                children: [
+                    /*#__PURE__*/ jsx(PictureButton, {
+                        label: "向左旋转",
+                        disabled: !imageSelected,
+                        onClick: ()=>updateTransform((current)=>({
+                                    rotation: rotateImage(current.rotation, -90)
+                                })),
+                        children: /*#__PURE__*/ jsx(RotateCcw, {
+                            size: 18
+                        })
+                    }),
+                    /*#__PURE__*/ jsx(PictureButton, {
+                        label: "向右旋转",
+                        disabled: !imageSelected,
+                        onClick: ()=>updateTransform((current)=>({
+                                    rotation: rotateImage(current.rotation, 90)
+                                })),
+                        children: /*#__PURE__*/ jsx(RotateCw, {
+                            size: 18
+                        })
+                    }),
+                    /*#__PURE__*/ jsx(PictureButton, {
+                        label: "水平翻转",
+                        active: transform.flipHorizontal,
+                        disabled: !imageSelected,
+                        onClick: ()=>updateTransform((current)=>({
+                                    flipHorizontal: !current.flipHorizontal
+                                })),
+                        children: /*#__PURE__*/ jsx(FlipHorizontal2, {
+                            size: 18
+                        })
+                    }),
+                    /*#__PURE__*/ jsx(PictureButton, {
+                        label: "垂直翻转",
+                        active: transform.flipVertical,
+                        disabled: !imageSelected,
+                        onClick: ()=>updateTransform((current)=>({
+                                    flipVertical: !current.flipVertical
+                                })),
+                        children: /*#__PURE__*/ jsx(FlipVertical2, {
+                            size: 18
+                        })
+                    })
+                ]
+            }),
             /*#__PURE__*/ jsx(WorkOfficeRibbonGroup, {
                 label: "与文字距离",
                 children: /*#__PURE__*/ jsx(OfficeSelect, {
@@ -13613,6 +13757,10 @@ function DocumentPictureRibbon({ editor }) {
         ]
     });
 }
+function rotateImage(rotation, delta) {
+    const next = (rotation + delta + 360) % 360;
+    return next;
+}
 function imageWrapDistanceOptionsForValue(value) {
     if (imageWrapDistanceOptions.some((option)=>option.value === value)) return imageWrapDistanceOptions;
     return [

package/dist/0~work-docx-export.js

@@ -1,8 +1,8 @@
 import jszip from "jszip";
-import { normalizeDocumentBookmarkName, normalizeDocumentEmphasisMark, DOCUMENT_STRIKE_STYLE_ATTRIBUTE, applyDocumentImageIdentityToElement, documentEmphasisMarkFromElement, DOCUMENT_PAGE_BORDER_EDGES, DOCUMENT_UNDERLINE_STYLE_ATTRIBUTE, createDocumentImageIdentityRegistry, normalizeDocumentColumns, normalizeDocumentTableVerticalAlign, normalizeDocumentTextCase, documentCharacterSpacingTwipsFromElement, documentCharacterPositionHalfPointsFromElement, documentTableColumnPercentagesFromElement, documentTableCellMarginOverridesFromElement, applyDocumentTableRowIdentityToElement, normalizeDocumentBookmarksHtml, documentImageIdentityFromElement, documentTableGeometryFromElement, normalizeDocumentTableRowHeightRule, documentNoteKey, DOCUMENT_LEGACY_TEXT_EMBOSS_ATTRIBUTE, normalizeDocumentHiddenText, documentLegacyTextEffectsConflict, normalizeDocumentTableBorderWidth, normalizeDocumentCharacterSpacingTwips, documentStrikeFormattingFromElement, normalizeDocumentTableBorderStyle, parseDocumentNumberingChange, normalizeDocumentBookmarkReferencesHtml, documentCitationInstruction, documentImageWrapContourFromElement, documentImagePositionFromElement, normalizeDocumentCharacterScalePercent, normalizeDocumentUnderlineStyle, normalizeDocumentPageChrome, documentPageMarginsForLayout, normalizeDocumentImageLayer, documentKerningThresholdHalfPointsFromElement, documentImageCropFromElement, documentBookmarkReferenceInstruction, normalizeDocumentPageBorders, documentImageLayerFromElement, serializeDocumentOpenTypeFeatures, documentCaptionLabel, documentCaptionKind, isContourImageLayout, normalizeDocumentLegacyTextEffects, DOCUMENT_LEGACY_TEXT_IMPRINT_ATTRIBUTE, normalizeDocumentImageIdentity, normalizeDocumentStrikeStyle, normalizeTableColor, normalizeDocumentOpenTypeFeatures, documentCitationTags, docxDocumentFieldKind, documentTableBordersFromElement, documentSections, wrapsBesideImage, normalizeDocumentCharacterPositionHalfPoints, normalizeDocumentKerningThresholdHalfPoints, defaultDocumentImageWrapContour, parseDocumentOpenTypeFeatures, normalizeDocumentPaperSource, DOCUMENT_LEGACY_TEXT_OUTLINE_ATTRIBUTE, documentEquationFromElement, parseDocumentCharacterFormatting, documentLegacyTextEffectsFromElement, documentUnderlineFormattingFromElement, DOCUMENT_LEGACY_TEXT_SHADOW_ATTRIBUTE, normalizeDocumentEquation, parseDocumentParagraphFormatting, documentOpenTypeFeaturesFromElement, normalizeDocumentBookmarkNativeId, documentTableRowIdentityFromElement, DOCUMENT_PAGE_MARGIN_KEYS, uniqueDocumentImageIdentity, documentHiddenTextFromElement, collectDocumentNotes, documentImageLayoutFromElement, documentPageHorizontalMarginTwips, DOCUMENT_OPEN_TYPE_ATTRIBUTE, MAX_DOCUMENT_NUMBERING_START, documentPageGeometryForLayout, DOCUMENT_LEGACY_TEXT_EFFECT_NAMES, documentCharacterScalePercentFromElement, normalizeDocumentPageMargins, normalizeDocumentLegacyTextEffect, documentNoteKind } from "./4174.js";
+import { normalizeDocumentBookmarkName, normalizeDocumentEmphasisMark, DOCUMENT_STRIKE_STYLE_ATTRIBUTE, applyDocumentImageIdentityToElement, documentEmphasisMarkFromElement, DOCUMENT_PAGE_BORDER_EDGES, DOCUMENT_UNDERLINE_STYLE_ATTRIBUTE, createDocumentImageIdentityRegistry, normalizeDocumentColumns, normalizeDocumentTableVerticalAlign, normalizeDocumentTextCase, documentCharacterSpacingTwipsFromElement, documentCharacterPositionHalfPointsFromElement, documentTableColumnPercentagesFromElement, documentTableCellMarginOverridesFromElement, applyDocumentTableRowIdentityToElement, normalizeDocumentBookmarksHtml, documentImageIdentityFromElement, documentTableGeometryFromElement, normalizeDocumentTableRowHeightRule, documentNoteKey, DOCUMENT_LEGACY_TEXT_EMBOSS_ATTRIBUTE, normalizeDocumentHiddenText, documentLegacyTextEffectsConflict, normalizeDocumentTableBorderWidth, normalizeDocumentCharacterSpacingTwips, documentStrikeFormattingFromElement, normalizeDocumentTableBorderStyle, parseDocumentNumberingChange, normalizeDocumentBookmarkReferencesHtml, documentCitationInstruction, documentImageWrapContourFromElement, documentImagePositionFromElement, normalizeDocumentCharacterScalePercent, normalizeDocumentUnderlineStyle, normalizeDocumentPageChrome, documentPageMarginsForLayout, normalizeDocumentImageLayer, documentKerningThresholdHalfPointsFromElement, documentImageCropFromElement, documentBookmarkReferenceInstruction, normalizeDocumentPageBorders, documentImageLayerFromElement, serializeDocumentOpenTypeFeatures, documentCaptionLabel, documentCaptionKind, isContourImageLayout, normalizeDocumentLegacyTextEffects, DOCUMENT_LEGACY_TEXT_IMPRINT_ATTRIBUTE, normalizeDocumentImageIdentity, normalizeDocumentStrikeStyle, normalizeTableColor, normalizeDocumentOpenTypeFeatures, documentCitationTags, docxDocumentFieldKind, documentTableBordersFromElement, documentSections, wrapsBesideImage, normalizeDocumentCharacterPositionHalfPoints, normalizeDocumentKerningThresholdHalfPoints, defaultDocumentImageWrapContour, parseDocumentOpenTypeFeatures, normalizeDocumentPaperSource, DOCUMENT_LEGACY_TEXT_OUTLINE_ATTRIBUTE, documentEquationFromElement, documentImageTransformFromElement, parseDocumentCharacterFormatting, documentLegacyTextEffectsFromElement, documentUnderlineFormattingFromElement, DOCUMENT_LEGACY_TEXT_SHADOW_ATTRIBUTE, normalizeDocumentEquation, parseDocumentParagraphFormatting, documentOpenTypeFeaturesFromElement, normalizeDocumentBookmarkNativeId, documentTableRowIdentityFromElement, DOCUMENT_PAGE_MARGIN_KEYS, uniqueDocumentImageIdentity, documentHiddenTextFromElement, collectDocumentNotes, documentImageLayoutFromElement, documentPageHorizontalMarginTwips, DOCUMENT_OPEN_TYPE_ATTRIBUTE, MAX_DOCUMENT_NUMBERING_START, documentPageGeometryForLayout, DOCUMENT_LEGACY_TEXT_EFFECT_NAMES, documentCharacterScalePercentFromElement, normalizeDocumentPageMargins, normalizeDocumentLegacyTextEffect, documentNoteKind } from "./4174.js";
 import { normalizeDocumentRunBorder, parseDocumentScriptFonts, parseDocxThemeReference, parseXml, parseDocumentRunShading, applyDocumentParagraphIdentityToElement, DOCUMENT_RUN_SHADING_ATTRIBUTE, documentScriptFontSlotFromElement, DOCUMENT_HIGHLIGHT_ATTRIBUTE, normalizeDocumentIndexesHtml, serializeDocumentScriptFonts, attribute as work_ooxml_package_attribute, createDocumentParagraphIdentityRegistry, uniqueDocumentParagraphIdentity, DOCUMENT_NO_PROOF_ATTRIBUTE, documentHighlightForCssColor, directChildren, documentTableOfContentsValueFromElement, DOCUMENT_PROOFING_LANGUAGES_ATTRIBUTE, DocxThemePatchCollector, normalizeDocumentScriptFonts, normalizeDocumentParagraphIdentity, normalizeDocumentHighlight, normalizeDocumentParagraphBorders, serializeUtf8Xml, DOCUMENT_PARAGRAPH_BORDER_EDGES, parseDocumentRunBorder, normalizeDocumentNoProof, decodeXmlBytes, documentParagraphIdentityFromElement, normalizeDocumentParagraphId, documentScriptFontFamily, descendants, resolvePartTarget, documentProofingLanguagesFromElement, documentHighlightFromElement, parseDocumentRunShadingElement, parseDocumentProofingLanguages, patchDocxThemeReferences, parseDocumentParagraphBordersElement, DOCUMENT_RUN_BORDER_ATTRIBUTE, parseDocumentRunBorderElement, xmlNamespacePrefix, documentScriptFontSlotFromHint, documentNoProofFromElement, documentScriptFontsFromElement, normalizeDocumentRunShading, normalizeDocumentScriptFontSlot, directChild, documentIndexEntryFromElement, documentIndexValueFromElement, parseDocumentParagraphShadingElement, documentFontNameFromCssFamily } from "./6968.js";
 import { assignDocxNoteIds, patchDocxPageColor, normalizeDocxCommentId, assignDocxCommentThreads } from "./0~4980.js";
-import { paragraphTabStops, mergeDocxIgnorableExtensionsAtPairs, DOCX_WORD_2010_NAMESPACE, docxKerningThresholdValue, patchDocxBibliography, documentIndexInstruction, docxCharacterScaleValue, XMLNS_NAMESPACE as work_docx_settings_xml_XMLNS_NAMESPACE, paragraphAlignment, xmlNamespaceUri, paragraphSpacingOptions, docxCharacterPositionValue, documentIndexEntryInstruction, docxEmphasisMarkRunOptions, hasNonWhitespaceXmlText, patchDocxExplicitZeroCharacterSpacing, cloneXmlElement, cssColorToHex, xmlDeclaredPrefix, assertXmlRoot, DOCX_WORDPROCESSING_NAMESPACES, paragraphIndent, domDirection, xmlAttributeNamespace, paragraphBidirectional, XML_NAMESPACE as work_docx_settings_xml_XML_NAMESPACE, mergeDocxIgnorableExtensions, DocxParagraphDefaultCollapsedPatchCollector, dataBoolean, patchDocxParagraphDefaultCollapsed, patchDocxExplicitZeroKerningThresholds, parseDocxColorSchemeMappingElement, paragraphPaginationOptions, DOCX_COLOR_SCHEME_MAPPING_ATTRIBUTES, documentProofingLanguageDocxOptions, xmlAttributeLocalName, cssFontSize, paragraphDirectionOptions, cssFontFamily, docxCharacterSpacingValue } from "./0~5024.js";
+import { DocxImageTransformPatchCollector, paragraphTabStops, patchDocxImageTransforms, mergeDocxIgnorableExtensionsAtPairs, DOCX_WORD_2010_NAMESPACE, docxKerningThresholdValue, patchDocxBibliography, documentIndexInstruction, docxCharacterScaleValue, XMLNS_NAMESPACE as work_docx_settings_xml_XMLNS_NAMESPACE, paragraphAlignment, xmlNamespaceUri, paragraphSpacingOptions, docxCharacterPositionValue, documentIndexEntryInstruction, docxEmphasisMarkRunOptions, hasNonWhitespaceXmlText, patchDocxExplicitZeroCharacterSpacing, cloneXmlElement, cssColorToHex, xmlDeclaredPrefix, assertXmlRoot, DOCX_WORDPROCESSING_NAMESPACES, paragraphIndent, domDirection, xmlAttributeNamespace, paragraphBidirectional, XML_NAMESPACE as work_docx_settings_xml_XML_NAMESPACE, mergeDocxIgnorableExtensions, DocxParagraphDefaultCollapsedPatchCollector, dataBoolean, patchDocxParagraphDefaultCollapsed, patchDocxExplicitZeroKerningThresholds, parseDocxColorSchemeMappingElement, paragraphPaginationOptions, DOCX_COLOR_SCHEME_MAPPING_ATTRIBUTES, documentProofingLanguageDocxOptions, xmlAttributeLocalName, cssFontSize, paragraphDirectionOptions, cssFontFamily, docxCharacterSpacingValue } from "./0~4042.js";
 import { normalizeDocumentHref } from "./0~work-document-links.js";
 const WORD_NAMESPACE = 'http://schemas.openxmlformats.org/wordprocessingml/2006/main';
 class DocxBookmarkPatchCollector {
@@ -1959,7 +1959,7 @@ function supportedPartRoot(root, path) {
     const expected = /^word\/header\d*\.xml$/i.test(path) ? 'hdr' : /^word\/footer\d*\.xml$/i.test(path) ? 'ftr' : /^word\/footnotes\.xml$/i.test(path) ? 'footnotes' : /^word\/endnotes\.xml$/i.test(path) ? 'endnotes' : 'document';
     return root.localName === expected && DOCX_WORDPROCESSING_NAMESPACES.has(root.namespaceURI ?? '');
 }
-async function imageToDocx(element, docx, cropPatches, wrapPatches, layerPatches, identityPatches) {
+async function imageToDocx(element, docx, cropPatches, wrapPatches, layerPatches, identityPatches, transformPatches) {
     const source = element.getAttribute('src');
     const alt = element.getAttribute('alt') || element.getAttribute('title') || 'Image';
     if (!source) return new docx.TextRun(`[${alt}]`);
@@ -1982,6 +1982,7 @@ async function imageToDocx(element, docx, cropPatches, wrapPatches, layerPatches
         const wrapMarker = wrapPatches?.marker(imageLayout, documentImageWrapContourFromElement(element));
         const layer = documentImageLayerFromElement(element);
         const layerMarker = layerPatches?.marker(imageLayout.layout, layer);
+        const transformMarker = transformPatches?.marker(documentImageTransformFromElement(element));
         return new docx.ImageRun({
             type,
             data: await blob.arrayBuffer(),
@@ -1990,7 +1991,7 @@ async function imageToDocx(element, docx, cropPatches, wrapPatches, layerPatches
                 height: Math.max(24, Math.round(dimensions.height * scale))
             },
             altText: {
-                name: `${alt}${cropMarker ?? ''}${wrapMarker ?? ''}${layerMarker ?? ''}${identity?.marker ?? ''}`,
+                name: `${alt}${cropMarker ?? ''}${wrapMarker ?? ''}${layerMarker ?? ''}${identity?.marker ?? ''}${transformMarker ?? ''}`,
                 description: alt,
                 title: alt,
                 id: identity ? String(identity.docPropertiesId) : void 0
@@ -8686,6 +8687,7 @@ async function createDocxBlob(content, sourcePackage) {
         imageIdentityPatches: new DocxImageIdentityPatchCollector(),
         imageLayerPatches: new DocxImageLayerPatchCollector(),
         imageWrapPatches: new DocxImageWrapPatchCollector(),
+        imageTransformPatches: new DocxImageTransformPatchCollector(),
         paragraphBorderPatches: new DocxParagraphBorderPatchCollector(JSON.stringify(normalizedContent)),
         paragraphDefaultCollapsedPatches: new DocxParagraphDefaultCollapsedPatchCollector(),
         paragraphIdentityPatches: new DocxParagraphIdentityPatchCollector(JSON.stringify(normalizedContent)),
@@ -8773,7 +8775,8 @@ async function createDocxBlob(content, sourcePackage) {
     const imageCropPatched = await patchDocxImageCrops(themePatched, noteContext.imageCropPatches.patches);
     const imageWrapPatched = await patchDocxImageWraps(imageCropPatched, noteContext.imageWrapPatches.patches);
     const imageLayerPatched = await patchDocxImageLayers(imageWrapPatched, noteContext.imageLayerPatches.patches);
-    const imageIdentityPatched = await patchDocxImageIdentities(imageLayerPatched, noteContext.imageIdentityPatches.patches);
+    const imageTransformPatched = await patchDocxImageTransforms(imageLayerPatched, noteContext.imageTransformPatches.patches);
+    const imageIdentityPatched = await patchDocxImageIdentities(imageTransformPatched, noteContext.imageIdentityPatches.patches);
     const bookmarkPatched = await patchDocxBookmarks(imageIdentityPatched, noteContext.bookmarkPatches.patches);
     const paragraphDefaultCollapsedPatched = await patchDocxParagraphDefaultCollapsed(bookmarkPatched, noteContext.paragraphDefaultCollapsedPatches.patches);
     const paragraphIdentityPatched = await patchDocxParagraphIdentities(paragraphDefaultCollapsedPatched, noteContext.paragraphIdentityPatches.patches);
@@ -8980,7 +8983,7 @@ async function blockToFileChildren(element, docx, noteContext) {
     if ('img' === tag) return [
         new docx.Paragraph({
             children: [
-                await imageToDocx(element, docx, noteContext.imageCropPatches, noteContext.imageWrapPatches, noteContext.imageLayerPatches, noteContext.imageIdentityPatches)
+                await imageToDocx(element, docx, noteContext.imageCropPatches, noteContext.imageWrapPatches, noteContext.imageLayerPatches, noteContext.imageIdentityPatches, noteContext.imageTransformPatches)
             ]
         })
     ];
@@ -9221,7 +9224,7 @@ async function work_docx_export_inlineRuns(root, docx, noteContext) {
             ];
         }
         if ('img' === tag) return [
-            await imageToDocx(node, docx, noteContext.imageCropPatches, noteContext.imageWrapPatches, noteContext.imageLayerPatches, noteContext.imageIdentityPatches)
+            await imageToDocx(node, docx, noteContext.imageCropPatches, noteContext.imageWrapPatches, noteContext.imageLayerPatches, noteContext.imageIdentityPatches, noteContext.imageTransformPatches)
         ];
         if ('span' === tag && 'true' === node.dataset.documentBookmarkBoundary) {
             const marker = noteContext.bookmarkPatches.register(node);

package/dist/0~work-docx-import.js

@@ -1,8 +1,8 @@
 import jszip from "jszip";
 import { documentRunBorderDomAttributes, contentTypeForPart, bytesToDataUrl, OoxmlPackage, normalizeDocumentIndexesHtml, firstDescendant, normalizeDocumentParagraphId, applyDocumentParagraphIdentityToElement, descendants, documentHighlightDomAttributes, attribute as work_ooxml_package_attribute, documentHighlightFromDocxValue, serializeDocxThemeReference, normalizeDocumentTableOfContentsHtml, directChildren, documentParagraphShadingDomAttributes, documentProofingDomAttributes, documentParagraphBordersDomAttributes, directChild, documentScriptFontSegments, normalizeDocumentParagraphIdentity, documentRunShadingDomAttributes } from "./6968.js";
-import { normalizeDocumentBookmarkName, renderDocumentTableCellMarginOverrides, applyDocumentImageIdentityToElement, documentCharacterPositionDomAttributes, createDocumentImageIdentityRegistry, normalizeDocumentColumns, documentStrikeDomAttributes, normalizeDocumentImageWrapContour, DOCUMENT_TABLE_ROW_ID_ATTRIBUTE, normalizeDocumentBookmarksHtml, applyDocumentTableRowIdentityToElement, normalizeDocumentCaptionsHtml, documentCharacterSpacingDomAttributes, normalizeDocumentImageAlignment, applyDocumentImageLayerToElement, normalizeDocumentNotesHtml, normalizeDocumentBookmarkReferencesHtml, documentCitationTagsFromInstruction, applyDocumentImageWrapContourToElement, documentUnderlineDomAttributes, documentHiddenTextDomAttributes, normalizeDocumentPageChrome, normalizeDocumentImageLayoutOptions, applyDocumentImageCropToElement, documentPageMarginsForLayout, applyDocumentPageGeometry, createDocumentNoteElement, normalizeDocumentImageLayer, DOCUMENT_TABLE_ROW_TEXT_ID_ATTRIBUTE, documentBookmarkReferenceInstruction, documentInitialSectionLayout, normalizeDocumentFieldsHtml, documentCaptionLabel, documentTableBordersFromElement, isContourImageLayout, normalizeDocumentCitationsHtml, normalizeDocumentImageIdentity, normalizeDocumentImageWrapSide, documentKerningDomAttributes, docxDocumentFieldKind, renderDocumentTableBorders, docxBookmarkReferenceTarget, normalizeDocumentImagePosition, wrapsBesideImage, documentPageChromeLegacyFields, documentCharacterScaleDomAttributes, DEFAULT_DOCUMENT_TABLE_GEOMETRY, documentSectionDomAttributes, DEFAULT_DOCUMENT_TABLE_CELL_MARGINS, documentPageMarginBody, documentLegacyTextEffectsDomAttributes, normalizeDocumentTableRowIdentity, normalizeDocumentBookmarkNativeId, documentOpenTypeDomAttributes, uniqueDocumentImageIdentity, applyDocumentTableGeometryToElement, normalizeDocumentImageCrop, documentContentLayoutProperties, documentEmphasisMarkDomAttributes } from "./4174.js";
+import { normalizeDocumentBookmarkName, renderDocumentTableCellMarginOverrides, applyDocumentImageIdentityToElement, documentCharacterPositionDomAttributes, createDocumentImageIdentityRegistry, normalizeDocumentColumns, documentStrikeDomAttributes, normalizeDocumentImageWrapContour, DOCUMENT_TABLE_ROW_ID_ATTRIBUTE, normalizeDocumentBookmarksHtml, applyDocumentTableRowIdentityToElement, normalizeDocumentCaptionsHtml, documentCharacterSpacingDomAttributes, normalizeDocumentImageAlignment, applyDocumentImageLayerToElement, normalizeDocumentNotesHtml, normalizeDocumentBookmarkReferencesHtml, documentCitationTagsFromInstruction, applyDocumentImageWrapContourToElement, documentUnderlineDomAttributes, documentHiddenTextDomAttributes, normalizeDocumentPageChrome, normalizeDocumentImageLayoutOptions, applyDocumentImageCropToElement, documentPageMarginsForLayout, applyDocumentPageGeometry, createDocumentNoteElement, normalizeDocumentImageLayer, DOCUMENT_TABLE_ROW_TEXT_ID_ATTRIBUTE, documentBookmarkReferenceInstruction, applyDocumentImageTransformToElement, documentInitialSectionLayout, normalizeDocumentFieldsHtml, documentCaptionLabel, documentTableBordersFromElement, isContourImageLayout, normalizeDocumentCitationsHtml, normalizeDocumentImageIdentity, normalizeDocumentImageWrapSide, documentKerningDomAttributes, docxDocumentFieldKind, renderDocumentTableBorders, docxBookmarkReferenceTarget, normalizeDocumentImagePosition, wrapsBesideImage, documentPageChromeLegacyFields, documentCharacterScaleDomAttributes, DEFAULT_DOCUMENT_TABLE_GEOMETRY, documentSectionDomAttributes, DEFAULT_DOCUMENT_TABLE_CELL_MARGINS, documentPageMarginBody, documentLegacyTextEffectsDomAttributes, normalizeDocumentTableRowIdentity, normalizeDocumentBookmarkNativeId, documentOpenTypeDomAttributes, uniqueDocumentImageIdentity, applyDocumentTableGeometryToElement, normalizeDocumentImageCrop, documentContentLayoutProperties, documentEmphasisMarkDomAttributes } from "./4174.js";
 import { hasImportedDocxIndexMarkers, markDocxRunFormattingIntoState, applyImportedDocxParagraphSpacingMarkers, hasImportedDocxParagraphDirectionMarkers, hasImportedDocxParagraphIndentMarkers, resolveDocxParagraphBordersForParagraph, applyImportedDocxNumberingChangeMarkers, applyImportedDocxParagraphShadingMarkers, markDocxParagraphSpacing, docxCaptionBookmark, docxFieldResultText, createDocxParagraphStyleResolver, docxTableCellStyleLayers, createImportedDocxRunFormattingMarkerState, parseDocxPaperSource, resolveDocxLegacyTextEffects, markDocxTablesOfContents, hasImportedDocxParagraphSpacingMarkers, applyImportedDocxIndexMarkers, applyImportedDocxTableOfContentsMarkers, markDocxIndexes, parseDocxPageMargins, docxTablePropertySources, parseDirectDocxParagraphShading, markDocxParagraphIndents, markDocxPackageEquations, resolveDocxRunBorder, parseDocxPageGeometry, docxCaptionReferenceTarget, applyImportedDocxEquationMarkers, hasImportedDocxParagraphPaginationMarkers, createDocxTableStyleResolver, hasImportedDocxParagraphShadingMarkers, isDocxEquationLikeRoot, importedDocxStrike, docxTableRunPropertySources, hasImportedDocxNumberingChangeMarkers, inspectDocxPageMarginSettings, hasImportedDocxRunFormattingMarkers, hasImportedDocxTableOfContentsMarkers, applyImportedDocxParagraphFormattingChangeMarkers, hasImportedDocxParagraphTabStopMarkers, resolveDocxRunShading, docxCaptionSequenceKind, applyImportedDocxRunFormattingMarkers, markDocxParagraphAlignments, markDocxParagraphDirections, hasImportedDocxParagraphBorderMarkers, hasImportedDocxParagraphFormattingChangeMarkers, resolveDocxHiddenText, docxEquationHtml, docxFieldOccurrences, hasImportedDocxParagraphAlignmentMarkers, markDocxParagraphTabStops, applyImportedDocxParagraphIndentMarkers, resolveDocxTableStyleResolver, applyImportedDocxParagraphDirectionMarkers, markDocxNumberingChanges, applyImportedDocxParagraphAlignmentMarkers, importedDocxUnderline, markDocxParagraphBorders, markDocxParagraphPagination, applyImportedDocxParagraphTabStopMarkers, applyImportedDocxParagraphPaginationMarkers, docxFieldOccurrenceIsInlineEditable, applyImportedDocxParagraphBorderMarkers, docxRunPropertySources, markDocxParagraphFormattingChanges, markDocxParagraphShading, parseDocxPageBorders } from "./0~2330.js";
-import { readDocxBibliography, resolveDocxProofing, XMLNS_NAMESPACE, docxCharacterScalePercentFromProperties, docxCharacterSpacingTwipsFromProperties, parseBoundedDocxInteger, resolveDocxOpenTypeFeatures, xmlAttributeLocalName, resolveDocxEmphasisMark, createDocxThemeResolver, docxCharacterPositionHalfPointsFromProperties, docxThemeColor, parseDocxParagraphDefaultCollapsed, resolveDocxKerningThresholdHalfPoints, resolveDocxThemeResolver, DOCX_WORDPROCESSING_NAMESPACES, xmlAttributeNamespace } from "./0~5024.js";
+import { readDocxBibliography, resolveDocxProofing, XMLNS_NAMESPACE, docxCharacterScalePercentFromProperties, docxCharacterSpacingTwipsFromProperties, parseBoundedDocxInteger, resolveDocxOpenTypeFeatures, xmlAttributeLocalName, resolveDocxEmphasisMark, createDocxThemeResolver, docxCharacterPositionHalfPointsFromProperties, readDocxImageTransform, docxThemeColor, parseDocxParagraphDefaultCollapsed, resolveDocxKerningThresholdHalfPoints, resolveDocxThemeResolver, DOCX_WORDPROCESSING_NAMESPACES, xmlAttributeNamespace } from "./0~4042.js";
 import { importDocxPageColor, importedDocumentNoteId } from "./0~4980.js";
 const WORD_NAMESPACE = 'http://schemas.openxmlformats.org/wordprocessingml/2006/main';
 const XML_NAMESPACE = 'http://www.w3.org/XML/1998/namespace';
@@ -1039,6 +1039,7 @@ function markDocxImageLayouts(document, state = createImportedDocxImageLayoutMar
         const run = closestAncestor(anchor, 'r');
         if (!run || markedRuns.has(run)) continue;
         const crop = anchorCrop(anchor);
+        const transform = anchorTransform(anchor);
         const layout = 'inline' === anchor.localName ? 'inline' : anchorLayout(anchor);
         if (!layout) continue;
         if (state.nextMarker > MAX_IMPORTED_IMAGE_LAYOUTS) throw new Error('Imported DOCX exceeds the image-layout limit.');
@@ -1060,6 +1061,7 @@ function markDocxImageLayouts(document, state = createImportedDocxImageLayoutMar
             }),
             position: anchorPosition(anchor),
             crop,
+            transform,
             contour: isContourImageLayout(layout) ? anchorWrapContour(anchor, layout) : null,
             layer: 'anchor' === anchor.localName ? anchorLayer(anchor) : null,
             identity: uniqueDocumentImageIdentity(drawingIdentitySource(anchor), state.identityRegistry)
@@ -1098,7 +1100,7 @@ function applyImportedDocxImageLayoutMarkers(document, markers) {
             continue;
         }
         if (!state.applied && state.active && node instanceof HTMLImageElement) {
-            applyImageLayout(node, state.active.options, state.active.position, state.active.crop, state.active.contour, state.active.layer, state.active.identity);
+            applyImageLayout(node, state.active.options, state.active.position, state.active.crop, state.active.transform, state.active.contour, state.active.layer, state.active.identity);
             state.applied = true;
         }
     }
@@ -1185,6 +1187,9 @@ function anchorCrop(anchor) {
         cropLeft: cropPercentage(source, 'l')
     });
 }
+function anchorTransform(anchor) {
+    return readDocxImageTransform(anchor).transform;
+}
 function anchorLayer(anchor) {
     return normalizeDocumentImageLayer({
         relativeHeight: work_ooxml_package_attribute(anchor, 'relativeHeight'),
@@ -1225,7 +1230,7 @@ function insertMarkerRun(document, run, marker, position) {
     if (!parent) return;
     parent.insertBefore(markerRun, 'before' === position ? run : run.nextSibling);
 }
-function applyImageLayout(image, options, position, crop, contour, layer, identity) {
+function applyImageLayout(image, options, position, crop, transform, contour, layer, identity) {
     applyDocumentImageIdentityToElement(image, identity);
     image.dataset.officeImageLayout = options.layout;
     image.dataset.officeImageAlignment = options.alignment;
@@ -1246,6 +1251,7 @@ function applyImageLayout(image, options, position, crop, contour, layer, identi
         image.dataset.officeImageVerticalReference = position.verticalReference;
     }
     applyDocumentImageCropToElement(image, crop);
+    applyDocumentImageTransformToElement(image, transform);
     applyDocumentImageWrapContourToElement(image, contour);
     if (layer) applyDocumentImageLayerToElement(image, layer);
 }

package/dist/0~work-office-diagnostics.js

@@ -3,7 +3,7 @@ import { contentTypeForPart, directChildren, OoxmlPackage, parseXml, firstDescen
 import { normalizeDocumentBookmarkName, docxBookmarkReferenceTarget, normalizeDocumentBookmarkNativeId, DOCUMENT_LEGACY_TEXT_EFFECT_NAMES, supportedDocxBookmarkReferenceInstruction, documentCitationTagsFromInstruction, docxDocumentFieldKind } from "./4174.js";
 import { markDocxParagraphShading, inspectDocxPageSize, isSupportedDocxNumberingChange, docxCaptionBookmark, hasInvalidDocxFieldStructure, inspectDocxLegacyTextEffects, inspectDocxPageMargins, inspectDocxPaperSource, createDocxParagraphStyleResolver, supportedDocxTableOfContentsField, docxFieldOccurrences, supportedDocxIndexEntryField, createDocxTableStyleResolver, inspectDocxEquation, inspectDocxPageMarginSettings, inspectDocxRunBorder, inspectDocxRunFonts, inspectDocxRunShading, markDocxParagraphBorders, isSupportedDocxParagraphFormattingChange, docxFieldOccurrenceIsInlineEditable, supportedDocxIndexField, docxCaptionSequenceKind, inspectDocxHiddenText, inspectDocxPageBorders, isSupportedDocxRunFormattingChange, docxFieldInstructions, isSupportedDocxEquationPlacement } from "./0~2330.js";
 import { normalizeDocumentHref } from "./0~work-document-links.js";
-import { xmlAttributeLocalName, resolveDocxOpenTypeFeatures, inspectDocxProofingLanguages, readDocxBibliography, inspectDocxEmphasisMark, createDocxThemeResolver, DOCX_WORD_2010_NAMESPACE, inspectDocxNoProof, parseDocxParagraphDefaultCollapsed, DOCX_WORDPROCESSING_NAMESPACES, xmlAttributeNamespace, inspectDocxKerningThresholdHalfPoints } from "./0~5024.js";
+import { xmlAttributeLocalName, resolveDocxOpenTypeFeatures, inspectDocxProofingLanguages, readDocxBibliography, inspectDocxEmphasisMark, createDocxThemeResolver, DOCX_WORD_2010_NAMESPACE, inspectDocxNoProof, parseDocxParagraphDefaultCollapsed, readDocxImageTransform, DOCX_WORDPROCESSING_NAMESPACES, xmlAttributeNamespace, inspectDocxKerningThresholdHalfPoints } from "./0~4042.js";
 import { updateSpreadsheetWorksheetCompatibilitySummary, inspectXlsxPivotTables, isSupportedXlsxChartLegend, isSupportedXlsxChartPlotLayout, xlsxChartNodeUsesStackedGrouping, isSupportedXlsxChartSeriesFormatting, readXlsxFormulaFeaturesFromPackage, inspectXlsxHeaderFooterText, emptySpreadsheetWorksheetCompatibilitySummary, isSupportedXlsxWorksheetImageContentType, MAX_XLSX_WORKSHEET_IMAGE_BYTES, xlsxChartSeriesFormattingShapeProperties, diagnoseXlsxProtection, isEditableXlsxPaperSizeCode, isSupportedXlsxCombinationChartNodes } from "./4166.js";
 import { spreadsheetConditionalComparisonNeedsUpperValue, isSpreadsheetConditionalIconSetName, isSpreadsheetConditionalComparisonOperator, spreadsheetConditionalIconSetCount, xlsxWorksheetCellEntries } from "./9333.js";
 import { formulaHasStructuredReference, formulaHasExternalReference, parseSpreadsheetPrintTitles, volatileSpreadsheetFormulaFunctions, stripSpreadsheetSheetQualifier } from "./8715.js";
@@ -2191,7 +2191,11 @@ async function analyzeDocxCompatibility(file, messages, sourcePackage) {
             const captionDiagnostics = diagnoseDocxCaptions(document);
             issues.push(...captionDiagnostics.issues);
             if (descendants(document, 'tbl').length) issues.push(work_office_diagnostics_issue('docx.tables', 'Tables', 'Table rows, non-splitting rows, repeated headers, cell shading, vertical alignment, per-edge borders, and paragraph-boundary row continuation remain editable. Native row identities survive body and page-chrome HTML; uniquely matched passive extensions on stable table, row, and cell scopes and their property nodes are retained, while duplicate, cross-kind, relationship-bound, or semantic branches fail closed. Layout algorithm, preferred auto, percentage, or pixel width, alignment, indent, percentage or pixel column widths, table-level cell margins, and cell-level margin overrides are preserved independently across edit, preview, and DOCX export. Percentage column preferences use pixel grid widths as responsive browser fallbacks and remain coherent through merged cells. Nested tables retain independent edit and DOCX geometry, and tall outer rows can paginate at nested-row boundaries. Row-spanning cells continue through every covered physical row with in-cell page breaks and contiguous content ranges; combined row and column spans retain native DOCX merge semantics. Common inherited Word table styles apply whole-table, banded row or column, first or last row or column, corner-cell, border, fill, text-emphasis, paragraph alignment, direction, indents, spacing, line, pagination, and tab-stop rules before direct table, cell, paragraph, and run formatting. Theme tint and shade values resolve to stable RGB for edit and preview, while untouched run colors, run shading, cell fills, and per-edge borders retain their semantic theme references on export; explicit color edits use direct RGB. Less-common conditional paragraph properties may be normalized.'));
-            if (descendants(document, 'drawing').length || descendants(document, 'pict').length) issues.push(work_office_diagnostics_issue('docx.images', 'Images', 'Inline images and supported square, tight, through, top-and-bottom, or no-wrap free-floating images remain embedded with editable size, alternative text, alignment, wrap side and distance where applicable, signed horizontal or vertical offsets relative to the column, paragraph, margin, or page, four-edge percentage cropping, and drawing-layer options. Aligned and precise DOCX anchors retain their distinct position semantics; inline and floating crop geometry round-trips as DrawingML source rectangles; tight or through anchors retain their ordered wrap polygons; no-wrap anchors remain outside the body text flow and use behind-text placement to choose their side of the text; and supported floating images preserve relative Z-order, overlap and cell-layout policy, and anchor locking. Inline and floating pictures retain unique drawing-property and anchor IDs together with their edit IDs. Copies receive independent identities while move, delete, undo, and relationship regeneration retain the original object identity. Unsupported drawing types may be normalized.'));
+            if (descendants(document, 'drawing').length || descendants(document, 'pict').length) {
+                const unsupportedImageTransforms = docxUnsupportedImageTransformCount(document);
+                issues.push(work_office_diagnostics_issue('docx.images', 'Images', 'Inline images and supported square, tight, through, top-and-bottom, or no-wrap free-floating images remain embedded with editable size, alternative text, alignment, wrap side and distance where applicable, signed horizontal or vertical offsets relative to the column, paragraph, margin, or page, four-edge percentage cropping, 90-degree rotation, horizontal or vertical reflection, and drawing-layer options. Aligned and precise DOCX anchors retain their distinct position semantics; inline and floating crop geometry round-trips as DrawingML source rectangles; tight or through anchors retain their ordered wrap polygons; no-wrap anchors remain outside the body text flow and use behind-text placement to choose their side of the text; and supported floating images preserve relative Z-order, overlap and cell-layout policy, and anchor locking. Inline and floating pictures retain unique drawing-property and anchor IDs together with their edit IDs. Copies receive independent identities while move, delete, undo, and relationship regeneration retain the original object identity. Arbitrary-angle or malformed picture transforms and unsupported drawing types may be normalized.'));
+                if (unsupportedImageTransforms) issues.push(work_office_diagnostics_issue('docx.images.transform', 'Image transforms', `${unsupportedImageTransforms} picture transform(s) use an arbitrary angle or malformed rotation/reflection value. Work imports the editable 90-degree/reflection subset and normalizes the unsupported transform instead of exposing an inexact control.`));
+            }
             const textRevisions = [
                 ...descendants(document, 'ins'),
                 ...descendants(document, 'del')
@@ -2349,6 +2353,13 @@ async function inspectXlsxPackage(archive, issues, importedMetadata) {
         })) issues.push(work_office_diagnostics_issue('xlsx.manual-page-breaks', 'Manual page breaks', 'Manual row and column page breaks are preserved, editable, and honored by PDF pagination.', 'info'));
     }
 }
+function docxUnsupportedImageTransformCount(document) {
+    const drawings = [
+        ...descendants(document, 'anchor'),
+        ...descendants(document, 'inline')
+    ];
+    return drawings.filter((drawing)=>descendants(drawing, 'pic').length > 0 && !readDocxImageTransform(drawing).supported).length;
+}
 function report(file, sourceFormat, issues) {
     return {
         sourceFormat,

package/dist/4174.js

@@ -12711,6 +12711,9 @@ const DEFAULT_IMAGE_ALIGNMENT = 'center';
 const DEFAULT_WRAP_DISTANCE_MILLIMETERS = 3;
 const MAX_WRAP_DISTANCE_MILLIMETERS = 25;
 const DEFAULT_LOCK_ASPECT_RATIO = true;
+const DEFAULT_IMAGE_ROTATION = 0;
+const DEFAULT_IMAGE_FLIP_HORIZONTAL = false;
+const DEFAULT_IMAGE_FLIP_VERTICAL = false;
 const DEFAULT_HORIZONTAL_REFERENCE = 'column';
 const DEFAULT_VERTICAL_REFERENCE = 'paragraph';
 const MAX_IMAGE_OFFSET_MILLIMETERS = 558.7;
@@ -12854,6 +12857,9 @@ const DocumentImage = extension_image.extend({
             cropRight: imageCropNumberAttribute('right'),
             cropBottom: imageCropNumberAttribute('bottom'),
             cropLeft: imageCropNumberAttribute('left'),
+            rotation: imageTransformRotationAttribute(),
+            flipHorizontal: imageTransformBooleanAttribute('flipHorizontal', 'data-office-image-flip-horizontal'),
+            flipVertical: imageTransformBooleanAttribute('flipVertical', 'data-office-image-flip-vertical'),
             wrapPolygon: imageWrapPolygonAttribute(),
             wrapPolygonEdited: {
                 default: false,
@@ -12935,6 +12941,7 @@ function documentImageProperties(editor) {
     const layout = normalizeDocumentImageLayoutOptions(attributes);
     const position = normalizeDocumentImagePosition(attributes);
     const crop = normalizeDocumentImageCrop(attributes);
+    const transform = normalizeDocumentImageTransform(attributes);
     const contour = effectiveDocumentImageWrapContour(attributes);
     return {
         ...layout,
@@ -12948,6 +12955,9 @@ function documentImageProperties(editor) {
         ...crop ? {
             crop
         } : {},
+        ...documentImageTransformIsDefault(transform) ? {} : {
+            transform
+        },
         ...contour ? {
             contour
         } : {},
@@ -12986,6 +12996,14 @@ function documentImageCropFromElement(element) {
         cropLeft: element.getAttribute('data-office-image-crop-left')
     });
 }
+function documentImageTransformFromElement(element) {
+    const transform = normalizeDocumentImageTransform({
+        rotation: element.getAttribute('data-office-image-rotation'),
+        flipHorizontal: element.getAttribute('data-office-image-flip-horizontal'),
+        flipVertical: element.getAttribute('data-office-image-flip-vertical')
+    });
+    return documentImageTransformIsDefault(transform) ? null : transform;
+}
 function documentImageLayerFromElement(element) {
     return normalizeDocumentImageLayer({
         relativeHeight: element.getAttribute('data-office-image-relative-height'),
@@ -13061,6 +13079,56 @@ function normalizeDocumentImageCropEdge(value) {
     if (!Number.isFinite(number)) return 0;
     return Math.round(100 * Math.min(99.99, Math.max(0, number))) / 100;
 }
+function defaultDocumentImageTransform() {
+    return {
+        rotation: DEFAULT_IMAGE_ROTATION,
+        flipHorizontal: DEFAULT_IMAGE_FLIP_HORIZONTAL,
+        flipVertical: DEFAULT_IMAGE_FLIP_VERTICAL
+    };
+}
+function normalizeDocumentImageTransform(value) {
+    return {
+        rotation: normalizeDocumentImageRotation(value.rotation),
+        flipHorizontal: normalizeDocumentImageTransformBoolean(value.flipHorizontal, DEFAULT_IMAGE_FLIP_HORIZONTAL),
+        flipVertical: normalizeDocumentImageTransformBoolean(value.flipVertical, DEFAULT_IMAGE_FLIP_VERTICAL)
+    };
+}
+function normalizeDocumentImageRotation(value) {
+    const number = 'number' == typeof value ? value : 'string' == typeof value && value.trim() ? Number(value) : DEFAULT_IMAGE_ROTATION;
+    if (!Number.isFinite(number)) return DEFAULT_IMAGE_ROTATION;
+    const normalized = (Math.round(number) % 360 + 360) % 360;
+    return 90 === normalized || 180 === normalized || 270 === normalized ? normalized : DEFAULT_IMAGE_ROTATION;
+}
+function documentImageTransformIsDefault(transform) {
+    return transform.rotation === DEFAULT_IMAGE_ROTATION && !transform.flipHorizontal && !transform.flipVertical;
+}
+function documentImageTransformCss(transform) {
+    const normalized = normalizeDocumentImageTransform(transform);
+    if (documentImageTransformIsDefault(normalized)) return '';
+    return [
+        `--work-document-image-rotation:${normalized.rotation}deg`,
+        `--work-document-image-flip-x:${normalized.flipHorizontal ? -1 : 1}`,
+        `--work-document-image-flip-y:${normalized.flipVertical ? -1 : 1}`
+    ].join(';');
+}
+function applyDocumentImageTransformToElement(element, transform) {
+    const normalized = normalizeDocumentImageTransform(transform ?? {});
+    if (normalized.rotation === DEFAULT_IMAGE_ROTATION) delete element.dataset.officeImageRotation;
+    else element.dataset.officeImageRotation = String(normalized.rotation);
+    if (normalized.flipHorizontal) element.dataset.officeImageFlipHorizontal = 'true';
+    else delete element.dataset.officeImageFlipHorizontal;
+    if (normalized.flipVertical) element.dataset.officeImageFlipVertical = 'true';
+    else delete element.dataset.officeImageFlipVertical;
+    if (documentImageTransformIsDefault(normalized)) {
+        element.style.removeProperty('--work-document-image-rotation');
+        element.style.removeProperty('--work-document-image-flip-x');
+        element.style.removeProperty('--work-document-image-flip-y');
+        return;
+    }
+    element.style.setProperty('--work-document-image-rotation', `${normalized.rotation}deg`);
+    element.style.setProperty('--work-document-image-flip-x', normalized.flipHorizontal ? '-1' : '1');
+    element.style.setProperty('--work-document-image-flip-y', normalized.flipVertical ? '-1' : '1');
+}
 function normalizeDocumentImageLayer(value) {
     return {
         relativeHeight: normalizeDocumentImageRelativeHeight(value.relativeHeight),
@@ -13115,6 +13183,12 @@ function documentImageAttributesForChanges(value) {
         attributes.cropBottom = crop?.bottom ?? 0;
         attributes.cropLeft = crop?.left ?? 0;
     }
+    if (Object.hasOwn(value, 'transform')) {
+        const transform = value.transform ? normalizeDocumentImageTransform(value.transform) : defaultDocumentImageTransform();
+        attributes.rotation = transform.rotation;
+        attributes.flipHorizontal = transform.flipHorizontal;
+        attributes.flipVertical = transform.flipVertical;
+    }
     if (Object.hasOwn(value, 'contour')) {
         const contour = value.contour ? normalizeDocumentImageWrapContour(value.contour) : null;
         attributes.wrapPolygon = contour ? serializeDocumentImageWrapPoints(contour.points) : null;
@@ -13147,6 +13221,7 @@ function syncDocumentImageNodeView(element, container, attributes) {
     const lockAspectRatio = normalizeDocumentImageLockAspectRatio(attributes.lockAspectRatio);
     const position = normalizeDocumentImagePosition(attributes);
     const crop = normalizeDocumentImageCrop(attributes);
+    const transform = normalizeDocumentImageTransform(attributes);
     const wrapSide = normalizeDocumentImageWrapSide(attributes.wrapSide);
     const contour = effectiveDocumentImageWrapContour(attributes);
     const layer = normalizeDocumentImageLayer(attributes);
@@ -13161,6 +13236,7 @@ function syncDocumentImageNodeView(element, container, attributes) {
     element.dataset.officeImageWrapSide = wrapSide;
     syncDocumentImagePosition(element, position);
     applyDocumentImageCropToElement(element, crop);
+    applyDocumentImageTransformToElement(element, transform);
     applyDocumentImageWrapContourToElement(element, contour);
     applyDocumentImageLayerToElement(element, layer);
     if (identity) applyDocumentImageIdentityToElement(element, identity);
@@ -13175,6 +13251,7 @@ function syncDocumentImageNodeView(element, container, attributes) {
     container.dataset.officeImageWrapSide = wrapSide;
     syncDocumentImagePosition(container, position);
     applyDocumentImageCropToElement(container, crop);
+    applyDocumentImageTransformToElement(container, transform);
     applyDocumentImageWrapContourToElement(container, contour);
     applyDocumentImageLayerToElement(container, layer);
     if (identity) applyDocumentImageIdentityToElement(container, identity);
@@ -13219,6 +13296,32 @@ function imageCropNumberAttribute(edge) {
         }
     };
 }
+function imageTransformRotationAttribute() {
+    return {
+        default: DEFAULT_IMAGE_ROTATION,
+        parseHTML: (element)=>normalizeDocumentImageRotation(element.getAttribute('data-office-image-rotation')),
+        renderHTML: (attributes)=>{
+            const transform = normalizeDocumentImageTransform(attributes);
+            const result = {};
+            if (transform.rotation !== DEFAULT_IMAGE_ROTATION) result['data-office-image-rotation'] = String(transform.rotation);
+            const style = documentImageTransformCss(transform);
+            if (style) result.style = style;
+            return result;
+        }
+    };
+}
+function imageTransformBooleanAttribute(key, name) {
+    return {
+        default: false,
+        parseHTML: (element)=>normalizeDocumentImageTransformBoolean(element.getAttribute(name), false),
+        renderHTML: (attributes)=>{
+            const value = normalizeDocumentImageTransformBoolean(attributes[key], false);
+            return value ? {
+                [name]: 'true'
+            } : {};
+        }
+    };
+}
 function imageWrapPolygonAttribute() {
     return {
         default: null,
@@ -13338,6 +13441,11 @@ function normalizeDocumentImageLayerBoolean(value, fallback) {
     if (false === value || 0 === value || '0' === value || 'false' === value) return false;
     return fallback;
 }
+function normalizeDocumentImageTransformBoolean(value, fallback) {
+    if (true === value || 1 === value || '1' === value || 'true' === value) return true;
+    if (false === value || 0 === value || '0' === value || 'false' === value) return false;
+    return fallback;
+}
 function documentImageCropStyle(crop) {
     return documentImageCropStyleEntries(crop).map(([name, value])=>`${name}:${value}`).join(';');
 }
@@ -22003,4 +22111,4 @@ function registerDocumentPageSurfaceGeometry(element, provider) {
 function documentPageSurfaceGeometryForElement(element) {
     return documentPageSurfaceProviders.get(element)?.() ?? null;
 }
-export { DEFAULT_DOCUMENT_TABLE_CELL_FORMAT, DEFAULT_DOCUMENT_TABLE_CELL_MARGINS, DEFAULT_DOCUMENT_TABLE_GEOMETRY, DOCUMENT_BOOKMARK_DUPLICATE_MESSAGE, DOCUMENT_CHUNK_HYDRATION_META, DOCUMENT_CHUNK_PAGINATION_META, DOCUMENT_CHUNK_VISIBLE_IDS_META, DOCUMENT_LEGACY_TEXT_EFFECT_NAMES, DOCUMENT_LEGACY_TEXT_EMBOSS_ATTRIBUTE, DOCUMENT_LEGACY_TEXT_IMPRINT_ATTRIBUTE, DOCUMENT_LEGACY_TEXT_OUTLINE_ATTRIBUTE, DOCUMENT_LEGACY_TEXT_SHADOW_ATTRIBUTE, DOCUMENT_OPEN_TYPE_ATTRIBUTE, DOCUMENT_PAGE_BORDER_EDGES, DOCUMENT_PAGE_MARGIN_KEYS, DOCUMENT_PARAGRAPH_CHANGE_ATTRIBUTES, DOCUMENT_PARAGRAPH_FORMAT_ATTRIBUTES, DOCUMENT_STRIKE_STYLE_ATTRIBUTE, DOCUMENT_TABLE_ROW_ID_ATTRIBUTE, DOCUMENT_TABLE_ROW_TEXT_ID_ATTRIBUTE, DOCUMENT_TABLE_STYLE_OPTIONS, DOCUMENT_UNDERLINE_STYLE_ATTRIBUTE, DocumentCharacterFormatting, DocumentEquation, DocumentFontFamily, DocumentHighlight, DocumentImage, DocumentParagraphFormatting, DocumentScriptFontFormatting, DocumentStrike, DocumentSubscript, DocumentSuperscript, DocumentTableRowIdentity, DocumentTextStyle, DocumentUnderline, MAX_DOCUMENT_IMAGE_RELATIVE_HEIGHT, MAX_DOCUMENT_NUMBERING_START, activeDocumentBookmark, activeDocumentSection, activeDocumentTableStyle, applyDocumentImageCropToElement, applyDocumentImageIdentityToElement, applyDocumentImageLayerToElement, applyDocumentImageWrapContourToElement, applyDocumentPageGeometry, applyDocumentTableGeometryToElement, applyDocumentTableRowIdentityToElement, applyDocumentTextCaseStyle, canChangeDocumentIndent, canInsertDocumentComment, canSetDocumentTableRowRepeatHeader, clampDocumentMargin, collectDocumentChanges, collectDocumentCommentAnchors, collectDocumentNotes, collectDocumentTextLayoutParagraphs, createDocumentBibliography, createDocumentEquationElement, createDocumentImageIdentityRegistry, createDocumentNoteElement, createSchemaDerivedWorkDocumentModel, createWorkDocumentBlob, createWorkDocumentExtensions, createWorkDocumentModel, createWorkOfficeDocumentCollaborationBinding as createOfficeDocumentCollaborationBinding, defaultDocumentImageWrapContour, documentAutoLineHeight, documentBookmarkNameExists, documentBookmarkReferenceInstruction, documentBulletListStyle, documentCaptionKind, documentCaptionLabel, documentCharacterPositionDomAttributes, documentCharacterPositionHalfPointsFromElement, documentCharacterPositionPoints, documentCharacterScaleDomAttributes, documentCharacterScalePercentFromElement, documentCharacterSpacingDomAttributes, documentCharacterSpacingPoints, documentCharacterSpacingTwipsFromElement, documentChunkMountedIds, documentCitationCount, documentCitationInstruction, documentCitationStyle, documentCitationStyleDetails, documentCitationTags, documentCitationTagsFromInstruction, documentCommentDraftRange, documentCommentViews, documentContentLayoutProperties, documentEmphasisMarkDomAttributes, documentEmphasisMarkFromElement, documentEquationFromElement, documentEquationText, documentHasIndex, documentHasTableOfContents, documentHiddenTextDomAttributes, documentHiddenTextFromElement, documentHiddenTextKeyboardShortcut, documentImageCropFromElement, documentImageIdentityFromElement, documentImageLayerFromElement, documentImageLayoutFromElement, documentImageLayoutOptions, documentImagePositionFromElement, documentImageProperties, documentImageWrapContourFromElement, documentInitialSectionLayout, documentKerningDomAttributes, documentKerningIsEffective, documentKerningThresholdHalfPointsFromElement, documentKerningThresholdPoints, documentLazyHtmlChunkFragment, documentLazyHtmlProjection, documentLazyHtmlProjectionFingerprint, documentLegacyTextEffectsConflict, documentLegacyTextEffectsCss, documentLegacyTextEffectsDomAttributes, documentLegacyTextEffectsFromElement, documentLegacyTextEffectsFromTextStyleAttributes, documentModelForContent, documentModelForHtml, documentModelHasTrustedInitialIntegrityFeatures, documentModelUsesWindowing, documentNoteKey, documentNoteKind, documentOpenTypeCssProperties, documentOpenTypeDomAttributes, documentOpenTypeFeaturesFromElement, documentOrderedListState, documentPageBordersVisible, documentPageChromeLegacyFields, documentPageGeometryForLayout, documentPageHorizontalMarginTwips, documentPageMarginBody, documentPageMarginsForLayout, documentPageMetrics, documentPageSurfaceGeometryForElement, documentPaperSizeForGeometry, documentParagraphDirection, documentParagraphIndent, documentParagraphPagination, documentParagraphSpacing, documentParagraphTabStops, documentSectionById, documentSectionDomAttributes, documentSections, documentStrikeDomAttributes, documentStrikeFormattingFromElement, documentStrikeStyle, documentTabLeaderLabel, documentTableBordersFromElement, documentTableCellFormat, documentTableCellMarginOverridesFromElement, documentTableColumnPercentagesFromElement, documentTableGeometryFromElement, documentTableHorizontalAlignment, documentTableRowIdentityFromElement, documentTableRowOptions, documentTableSizing, documentTextCaseFromWordFlags, documentTextCaseKeyboardShortcuts, documentTextLayoutBatches, documentTextStatistics, documentTransactionsOnlyHydrateChunks, documentUnderlineColor, documentUnderlineDomAttributes, documentUnderlineFormattingFromElement, documentUnderlineKeyboardShortcuts, documentUnderlineStyle, documentWordLineHeightFactor, docxBookmarkReferenceTarget, docxDocumentFieldKind, editorDocumentBookmarkReferenceTargets, editorDocumentCaptionTargets, fileNameWithoutExtension, forgetWorkSourceBlob as forgetSourceBlob, importWorkDocumentFile, importedDocumentCharacterFormatting, initializeWorkOfficeDocumentCollaboration as initializeOfficeDocumentCollaboration, invalidateDocumentLazyHtmlProjection, isContourImageLayout, isDocumentCharacterFormatMark, isDocumentOpenTypeFeaturePatch, isValidDocumentCitationTag, materializeLazyDocumentEditorRoot, measureDocumentLayoutBlocksIncrementally, millimetersToPixels, mountWorkLiveDocumentCapture, moveWorkSourceBlob, nextDocumentTabAlignment, normalizeDocumentBookmarkName, normalizeDocumentBookmarkNativeId, normalizeDocumentBookmarkReferencesHtml, normalizeDocumentBookmarksHtml, normalizeDocumentCaptionsHtml, normalizeDocumentCharacterPositionHalfPoints, normalizeDocumentCharacterScalePercent, normalizeDocumentCharacterSpacingTwips, normalizeDocumentCitationsHtml, normalizeDocumentColumns, normalizeDocumentEmphasisMark, normalizeDocumentEquation, normalizeDocumentFieldsHtml, normalizeDocumentHiddenText, normalizeDocumentHtml, normalizeDocumentImageAlignment, normalizeDocumentImageCrop, normalizeDocumentImageIdentity, normalizeDocumentImageLayer, normalizeDocumentImageLayoutOptions, normalizeDocumentImagePosition, normalizeDocumentImageWrapContour, normalizeDocumentImageWrapSide, normalizeDocumentKerningThresholdHalfPoints, normalizeDocumentLegacyTextEffect, normalizeDocumentLegacyTextEffects, normalizeDocumentNotesHtml, normalizeDocumentOpenTypeFeatures, normalizeDocumentOpenTypeLigatures, normalizeDocumentOpenTypeNumberForm, normalizeDocumentOpenTypeNumberSpacing, normalizeDocumentOpenTypeStylisticSets, normalizeDocumentPageBorders, normalizeDocumentPageChrome, normalizeDocumentPageGeometry, normalizeDocumentPageMargins, normalizeDocumentPaperSource, normalizeDocumentParagraphIndent, normalizeDocumentStrikeStyle, normalizeDocumentTabStops, normalizeDocumentTableBorderStyle, normalizeDocumentTableBorderWidth, normalizeDocumentTableRowHeightRule, normalizeDocumentTableRowIdentity, normalizeDocumentTableVerticalAlign, normalizeDocumentTextCase, normalizeDocumentUnderlineColor, normalizeDocumentUnderlineStyle, normalizeTableColor, normalizedTabPosition, numberingTypeFromFormat, pageTwipsToMillimeters, parseDocumentCharacterFormatting, parseDocumentNumberingChange, parseDocumentOpenTypeFeatures, parseDocumentParagraphFormatting, patchDocumentLazyHtmlProjection, patchDocumentOpenTypeFeatures, positionWorkLiveDocumentCapture, readWorkOfficeDocumentCollaboration as readOfficeDocumentCollaboration, readWorkSourceBlob as readSourceBlob, registerDocumentPageSurfaceGeometry, rememberWorkSourceBlob as registerSourceBlob, renderDocumentAutoLineHeight, renderDocumentTableBorders, renderDocumentTableCellMarginOverrides, resolveAllDocumentChanges, resolveDocumentPageBorders, resolveDocumentPageChrome, resolveDocumentPageMargins, resolveDocumentPageSize, resolveWorkDocumentEditorInput, retainAnchoredDocumentComments, sanitizeDocumentPageChromeHtml, selectedDocumentChunkId, selectedDocumentIndexDraft, selectedDocumentIndexEntry, selectedDocumentIndexOptions, selectedDocumentTableOfContentsOptions, serializeDocumentCharacterFormatting, serializeDocumentNumberingChange, serializeDocumentOpenTypeFeatures, serializeDocumentParagraphFormatting, serializeDocumentTabStops, serializeWorkDocumentNode, setCustomDocumentColumns, supportedDocxBookmarkReferenceInstruction, syncDocumentContentFromHtml, transferChangedDocumentTextStatistics, uniqueDocumentImageIdentity, updateDocumentColumnWidth, updateDocumentCustomPageMillimeters, updateDocumentGutterPosition, updateDocumentMirrorMargins, updateDocumentPageChromeVariant, updateDocumentPageMarginMillimeters, updateDocumentPageMarginMode, updateDocumentPageOrientation, updateDocumentPaperSizePreset, validateDocumentBookmarkName, windowDocumentModel, workDocumentSchema, workOfficeDocumentCollaborationFragment as officeDocumentCollaborationFragment, work_document_model_codec_createWorkDocumentModelFromContent as createWorkDocumentModelFromContent, work_document_model_codec_materializeWorkDocumentContent as materializeWorkDocumentContent, work_document_model_createSchemaValidatedWorkDocumentModel as createSchemaValidatedWorkDocumentModel, work_document_page_margins_twipsToMillimeters, work_file_download_downloadBlob, work_file_download_safeFileName, wrapsBesideImage };
+export { DEFAULT_DOCUMENT_TABLE_CELL_FORMAT, DEFAULT_DOCUMENT_TABLE_CELL_MARGINS, DEFAULT_DOCUMENT_TABLE_GEOMETRY, DOCUMENT_BOOKMARK_DUPLICATE_MESSAGE, DOCUMENT_CHUNK_HYDRATION_META, DOCUMENT_CHUNK_PAGINATION_META, DOCUMENT_CHUNK_VISIBLE_IDS_META, DOCUMENT_LEGACY_TEXT_EFFECT_NAMES, DOCUMENT_LEGACY_TEXT_EMBOSS_ATTRIBUTE, DOCUMENT_LEGACY_TEXT_IMPRINT_ATTRIBUTE, DOCUMENT_LEGACY_TEXT_OUTLINE_ATTRIBUTE, DOCUMENT_LEGACY_TEXT_SHADOW_ATTRIBUTE, DOCUMENT_OPEN_TYPE_ATTRIBUTE, DOCUMENT_PAGE_BORDER_EDGES, DOCUMENT_PAGE_MARGIN_KEYS, DOCUMENT_PARAGRAPH_CHANGE_ATTRIBUTES, DOCUMENT_PARAGRAPH_FORMAT_ATTRIBUTES, DOCUMENT_STRIKE_STYLE_ATTRIBUTE, DOCUMENT_TABLE_ROW_ID_ATTRIBUTE, DOCUMENT_TABLE_ROW_TEXT_ID_ATTRIBUTE, DOCUMENT_TABLE_STYLE_OPTIONS, DOCUMENT_UNDERLINE_STYLE_ATTRIBUTE, DocumentCharacterFormatting, DocumentEquation, DocumentFontFamily, DocumentHighlight, DocumentImage, DocumentParagraphFormatting, DocumentScriptFontFormatting, DocumentStrike, DocumentSubscript, DocumentSuperscript, DocumentTableRowIdentity, DocumentTextStyle, DocumentUnderline, MAX_DOCUMENT_IMAGE_RELATIVE_HEIGHT, MAX_DOCUMENT_NUMBERING_START, activeDocumentBookmark, activeDocumentSection, activeDocumentTableStyle, applyDocumentImageCropToElement, applyDocumentImageIdentityToElement, applyDocumentImageLayerToElement, applyDocumentImageTransformToElement, applyDocumentImageWrapContourToElement, applyDocumentPageGeometry, applyDocumentTableGeometryToElement, applyDocumentTableRowIdentityToElement, applyDocumentTextCaseStyle, canChangeDocumentIndent, canInsertDocumentComment, canSetDocumentTableRowRepeatHeader, clampDocumentMargin, collectDocumentChanges, collectDocumentCommentAnchors, collectDocumentNotes, collectDocumentTextLayoutParagraphs, createDocumentBibliography, createDocumentEquationElement, createDocumentImageIdentityRegistry, createDocumentNoteElement, createSchemaDerivedWorkDocumentModel, createWorkDocumentBlob, createWorkDocumentExtensions, createWorkDocumentModel, createWorkOfficeDocumentCollaborationBinding as createOfficeDocumentCollaborationBinding, defaultDocumentImageTransform, defaultDocumentImageWrapContour, documentAutoLineHeight, documentBookmarkNameExists, documentBookmarkReferenceInstruction, documentBulletListStyle, documentCaptionKind, documentCaptionLabel, documentCharacterPositionDomAttributes, documentCharacterPositionHalfPointsFromElement, documentCharacterPositionPoints, documentCharacterScaleDomAttributes, documentCharacterScalePercentFromElement, documentCharacterSpacingDomAttributes, documentCharacterSpacingPoints, documentCharacterSpacingTwipsFromElement, documentChunkMountedIds, documentCitationCount, documentCitationInstruction, documentCitationStyle, documentCitationStyleDetails, documentCitationTags, documentCitationTagsFromInstruction, documentCommentDraftRange, documentCommentViews, documentContentLayoutProperties, documentEmphasisMarkDomAttributes, documentEmphasisMarkFromElement, documentEquationFromElement, documentEquationText, documentHasIndex, documentHasTableOfContents, documentHiddenTextDomAttributes, documentHiddenTextFromElement, documentHiddenTextKeyboardShortcut, documentImageCropFromElement, documentImageIdentityFromElement, documentImageLayerFromElement, documentImageLayoutFromElement, documentImageLayoutOptions, documentImagePositionFromElement, documentImageProperties, documentImageTransformFromElement, documentImageWrapContourFromElement, documentInitialSectionLayout, documentKerningDomAttributes, documentKerningIsEffective, documentKerningThresholdHalfPointsFromElement, documentKerningThresholdPoints, documentLazyHtmlChunkFragment, documentLazyHtmlProjection, documentLazyHtmlProjectionFingerprint, documentLegacyTextEffectsConflict, documentLegacyTextEffectsCss, documentLegacyTextEffectsDomAttributes, documentLegacyTextEffectsFromElement, documentLegacyTextEffectsFromTextStyleAttributes, documentModelForContent, documentModelForHtml, documentModelHasTrustedInitialIntegrityFeatures, documentModelUsesWindowing, documentNoteKey, documentNoteKind, documentOpenTypeCssProperties, documentOpenTypeDomAttributes, documentOpenTypeFeaturesFromElement, documentOrderedListState, documentPageBordersVisible, documentPageChromeLegacyFields, documentPageGeometryForLayout, documentPageHorizontalMarginTwips, documentPageMarginBody, documentPageMarginsForLayout, documentPageMetrics, documentPageSurfaceGeometryForElement, documentPaperSizeForGeometry, documentParagraphDirection, documentParagraphIndent, documentParagraphPagination, documentParagraphSpacing, documentParagraphTabStops, documentSectionById, documentSectionDomAttributes, documentSections, documentStrikeDomAttributes, documentStrikeFormattingFromElement, documentStrikeStyle, documentTabLeaderLabel, documentTableBordersFromElement, documentTableCellFormat, documentTableCellMarginOverridesFromElement, documentTableColumnPercentagesFromElement, documentTableGeometryFromElement, documentTableHorizontalAlignment, documentTableRowIdentityFromElement, documentTableRowOptions, documentTableSizing, documentTextCaseFromWordFlags, documentTextCaseKeyboardShortcuts, documentTextLayoutBatches, documentTextStatistics, documentTransactionsOnlyHydrateChunks, documentUnderlineColor, documentUnderlineDomAttributes, documentUnderlineFormattingFromElement, documentUnderlineKeyboardShortcuts, documentUnderlineStyle, documentWordLineHeightFactor, docxBookmarkReferenceTarget, docxDocumentFieldKind, editorDocumentBookmarkReferenceTargets, editorDocumentCaptionTargets, fileNameWithoutExtension, forgetWorkSourceBlob as forgetSourceBlob, importWorkDocumentFile, importedDocumentCharacterFormatting, initializeWorkOfficeDocumentCollaboration as initializeOfficeDocumentCollaboration, invalidateDocumentLazyHtmlProjection, isContourImageLayout, isDocumentCharacterFormatMark, isDocumentOpenTypeFeaturePatch, isValidDocumentCitationTag, materializeLazyDocumentEditorRoot, measureDocumentLayoutBlocksIncrementally, millimetersToPixels, mountWorkLiveDocumentCapture, moveWorkSourceBlob, nextDocumentTabAlignment, normalizeDocumentBookmarkName, normalizeDocumentBookmarkNativeId, normalizeDocumentBookmarkReferencesHtml, normalizeDocumentBookmarksHtml, normalizeDocumentCaptionsHtml, normalizeDocumentCharacterPositionHalfPoints, normalizeDocumentCharacterScalePercent, normalizeDocumentCharacterSpacingTwips, normalizeDocumentCitationsHtml, normalizeDocumentColumns, normalizeDocumentEmphasisMark, normalizeDocumentEquation, normalizeDocumentFieldsHtml, normalizeDocumentHiddenText, normalizeDocumentHtml, normalizeDocumentImageAlignment, normalizeDocumentImageCrop, normalizeDocumentImageIdentity, normalizeDocumentImageLayer, normalizeDocumentImageLayoutOptions, normalizeDocumentImagePosition, normalizeDocumentImageTransform, normalizeDocumentImageWrapContour, normalizeDocumentImageWrapSide, normalizeDocumentKerningThresholdHalfPoints, normalizeDocumentLegacyTextEffect, normalizeDocumentLegacyTextEffects, normalizeDocumentNotesHtml, normalizeDocumentOpenTypeFeatures, normalizeDocumentOpenTypeLigatures, normalizeDocumentOpenTypeNumberForm, normalizeDocumentOpenTypeNumberSpacing, normalizeDocumentOpenTypeStylisticSets, normalizeDocumentPageBorders, normalizeDocumentPageChrome, normalizeDocumentPageGeometry, normalizeDocumentPageMargins, normalizeDocumentPaperSource, normalizeDocumentParagraphIndent, normalizeDocumentStrikeStyle, normalizeDocumentTabStops, normalizeDocumentTableBorderStyle, normalizeDocumentTableBorderWidth, normalizeDocumentTableRowHeightRule, normalizeDocumentTableRowIdentity, normalizeDocumentTableVerticalAlign, normalizeDocumentTextCase, normalizeDocumentUnderlineColor, normalizeDocumentUnderlineStyle, normalizeTableColor, normalizedTabPosition, numberingTypeFromFormat, pageTwipsToMillimeters, parseDocumentCharacterFormatting, parseDocumentNumberingChange, parseDocumentOpenTypeFeatures, parseDocumentParagraphFormatting, patchDocumentLazyHtmlProjection, patchDocumentOpenTypeFeatures, positionWorkLiveDocumentCapture, readWorkOfficeDocumentCollaboration as readOfficeDocumentCollaboration, readWorkSourceBlob as readSourceBlob, registerDocumentPageSurfaceGeometry, rememberWorkSourceBlob as registerSourceBlob, renderDocumentAutoLineHeight, renderDocumentTableBorders, renderDocumentTableCellMarginOverrides, resolveAllDocumentChanges, resolveDocumentPageBorders, resolveDocumentPageChrome, resolveDocumentPageMargins, resolveDocumentPageSize, resolveWorkDocumentEditorInput, retainAnchoredDocumentComments, sanitizeDocumentPageChromeHtml, selectedDocumentChunkId, selectedDocumentIndexDraft, selectedDocumentIndexEntry, selectedDocumentIndexOptions, selectedDocumentTableOfContentsOptions, serializeDocumentCharacterFormatting, serializeDocumentNumberingChange, serializeDocumentOpenTypeFeatures, serializeDocumentParagraphFormatting, serializeDocumentTabStops, serializeWorkDocumentNode, setCustomDocumentColumns, supportedDocxBookmarkReferenceInstruction, syncDocumentContentFromHtml, transferChangedDocumentTextStatistics, uniqueDocumentImageIdentity, updateDocumentColumnWidth, updateDocumentCustomPageMillimeters, updateDocumentGutterPosition, updateDocumentMirrorMargins, updateDocumentPageChromeVariant, updateDocumentPageMarginMillimeters, updateDocumentPageMarginMode, updateDocumentPageOrientation, updateDocumentPaperSizePreset, validateDocumentBookmarkName, windowDocumentModel, workDocumentSchema, workOfficeDocumentCollaborationFragment as officeDocumentCollaborationFragment, work_document_model_codec_createWorkDocumentModelFromContent as createWorkDocumentModelFromContent, work_document_model_codec_materializeWorkDocumentContent as materializeWorkDocumentContent, work_document_model_createSchemaValidatedWorkDocumentModel as createSchemaValidatedWorkDocumentModel, work_document_page_margins_twipsToMillimeters, work_file_download_downloadBlob, work_file_download_safeFileName, wrapsBesideImage };

package/dist/internal/features/work/editors/document-picture-properties-dialog-model.d.ts

@@ -1,4 +1,4 @@
-import type { WorkDocumentImageAlignment, WorkDocumentImageHorizontalReference, WorkDocumentImageLayout, WorkDocumentImageProperties, WorkDocumentImageWrapSide, WorkDocumentImageVerticalReference } from '../work-document-image-layout';
+import type { WorkDocumentImageAlignment, WorkDocumentImageHorizontalReference, WorkDocumentImageLayout, WorkDocumentImageProperties, WorkDocumentImageRotation, WorkDocumentImageVerticalReference, WorkDocumentImageWrapSide } from '../work-document-image-layout';
 export declare const IMAGE_PIXELS_PER_CENTIMETER: number;
 export interface DocumentPicturePropertiesSource {
     properties: WorkDocumentImageProperties;
@@ -24,6 +24,9 @@ export interface DocumentPicturePropertiesDraft {
     cropRight: string;
     cropBottom: string;
     cropLeft: string;
+    rotation: WorkDocumentImageRotation;
+    flipHorizontal: boolean;
+    flipVertical: boolean;
     relativeHeight: string;
     behindDocument: boolean;
     allowOverlap: boolean;

package/dist/internal/features/work/work-document-image-layout.d.ts

@@ -16,6 +16,12 @@ export interface WorkDocumentImageCrop {
     bottom: number;
     left: number;
 }
+export type WorkDocumentImageRotation = 0 | 90 | 180 | 270;
+export interface WorkDocumentImageTransform {
+    rotation: WorkDocumentImageRotation;
+    flipHorizontal: boolean;
+    flipVertical: boolean;
+}
 export interface WorkDocumentImageLayer {
     relativeHeight: number;
     behindDocument: boolean;
@@ -36,6 +42,7 @@ export interface WorkDocumentImageProperties extends WorkDocumentImageLayoutOpti
     alternativeText: string;
     position?: WorkDocumentImagePosition | null;
     crop?: WorkDocumentImageCrop | null;
+    transform?: WorkDocumentImageTransform | null;
     contour?: WorkDocumentImageWrapContour | null;
     layer?: WorkDocumentImageLayer | null;
 }
@@ -63,6 +70,7 @@ export declare function documentImageAlternativeText(editor: Editor): string;
 export declare function documentImageLayoutFromElement(element: Element): WorkDocumentImageLayoutOptions;
 export declare function documentImagePositionFromElement(element: Element): WorkDocumentImagePosition | null;
 export declare function documentImageCropFromElement(element: Element): WorkDocumentImageCrop | null;
+export declare function documentImageTransformFromElement(element: Element): WorkDocumentImageTransform | null;
 export declare function documentImageLayerFromElement(element: Element): WorkDocumentImageLayer;
 export declare function normalizeDocumentImageLayoutOptions(value: Partial<Record<keyof WorkDocumentImageLayoutOptions, unknown>>): WorkDocumentImageLayoutOptions;
 export declare function normalizeDocumentImageLayout(value: unknown): WorkDocumentImageLayout;
@@ -76,6 +84,12 @@ export declare function normalizeDocumentImageHorizontalReference(value: unknown
 export declare function normalizeDocumentImageVerticalReference(value: unknown): WorkDocumentImageVerticalReference;
 export declare function normalizeDocumentImageCrop(value: Partial<Record<'cropBottom' | 'cropLeft' | 'cropRight' | 'cropTop', unknown>>): WorkDocumentImageCrop | null;
 export declare function normalizeDocumentImageCropEdge(value: unknown): number;
+export declare function defaultDocumentImageTransform(): WorkDocumentImageTransform;
+export declare function normalizeDocumentImageTransform(value: Partial<Record<keyof WorkDocumentImageTransform, unknown>>): WorkDocumentImageTransform;
+export declare function normalizeDocumentImageRotation(value: unknown): WorkDocumentImageRotation;
+export declare function documentImageTransformIsDefault(transform: WorkDocumentImageTransform): boolean;
+export declare function documentImageTransformCss(transform: WorkDocumentImageTransform): string;
+export declare function applyDocumentImageTransformToElement(element: HTMLElement, transform: WorkDocumentImageTransform | null): void;
 export declare function normalizeDocumentImageLayer(value: Partial<Record<keyof WorkDocumentImageLayer, unknown>>): WorkDocumentImageLayer;
 export declare function normalizeDocumentImageRelativeHeight(value: unknown): number;
 export declare function documentImageLayerCssZIndex(layer: WorkDocumentImageLayer): number;

package/dist/internal/features/work/work-docx-export-image.d.ts

@@ -2,5 +2,6 @@ import type { ParagraphChild } from 'docx';
 import type { DocxImageCropPatchCollector } from './work-docx-image-crop';
 import type { DocxImageIdentityPatchCollector } from './work-docx-image-identity';
 import type { DocxImageLayerPatchCollector } from './work-docx-image-layer';
+import type { DocxImageTransformPatchCollector } from './work-docx-image-transform';
 import type { DocxImageWrapPatchCollector } from './work-docx-image-wrap';
-export declare function imageToDocx(element: HTMLImageElement, docx: typeof import('docx'), cropPatches?: DocxImageCropPatchCollector, wrapPatches?: DocxImageWrapPatchCollector, layerPatches?: DocxImageLayerPatchCollector, identityPatches?: DocxImageIdentityPatchCollector): Promise<ParagraphChild>;
+export declare function imageToDocx(element: HTMLImageElement, docx: typeof import('docx'), cropPatches?: DocxImageCropPatchCollector, wrapPatches?: DocxImageWrapPatchCollector, layerPatches?: DocxImageLayerPatchCollector, identityPatches?: DocxImageIdentityPatchCollector, transformPatches?: DocxImageTransformPatchCollector): Promise<ParagraphChild>;

package/dist/internal/features/work/work-docx-image-layout-import.d.ts

@@ -1,5 +1,5 @@
 import { type WorkDocumentImageIdentity, type WorkDocumentImageIdentityRegistry } from './work-document-image-identity';
-import { type WorkDocumentImageCrop, type WorkDocumentImageLayer, type WorkDocumentImageLayoutOptions, type WorkDocumentImagePosition } from './work-document-image-layout';
+import { type WorkDocumentImageCrop, type WorkDocumentImageLayer, type WorkDocumentImageLayoutOptions, type WorkDocumentImagePosition, type WorkDocumentImageTransform } from './work-document-image-layout';
 import { type WorkDocumentImageWrapContour } from './work-document-image-wrap-contour';
 export interface ImportedDocxImageLayoutMarker {
     startMarker: string;
@@ -7,6 +7,7 @@ export interface ImportedDocxImageLayoutMarker {
     options: WorkDocumentImageLayoutOptions;
     position: WorkDocumentImagePosition | null;
     crop: WorkDocumentImageCrop | null;
+    transform: WorkDocumentImageTransform | null;
     contour: WorkDocumentImageWrapContour | null;
     layer: WorkDocumentImageLayer | null;
     identity: WorkDocumentImageIdentity;

package/dist/internal/features/work/work-docx-image-transform.d.ts

@@ -0,0 +1,17 @@
+import { type WorkDocumentImageTransform } from './work-document-image-layout';
+interface DocxImageTransformPatch {
+    marker: string;
+    transform: WorkDocumentImageTransform;
+}
+export interface DocxImageTransformReadResult {
+    transform: WorkDocumentImageTransform | null;
+    supported: boolean;
+}
+export declare function readDocxImageTransform(drawing: Element): DocxImageTransformReadResult;
+export declare class DocxImageTransformPatchCollector {
+    readonly patches: DocxImageTransformPatch[];
+    private nextMarker;
+    marker(transform: WorkDocumentImageTransform | null): string;
+}
+export declare function patchDocxImageTransforms(buffer: ArrayBuffer, patches: readonly DocxImageTransformPatch[]): Promise<ArrayBuffer>;
+export {};

package/dist/styles.css

@@ -8383,7 +8383,7 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
   display: grid;
 }
 
-.work-document-picture-properties-section.position, .work-document-picture-properties-section.layer, .work-document-picture-properties-section.crop, .work-document-picture-properties-alt-text {
+.work-document-picture-properties-section.position, .work-document-picture-properties-section.layer, .work-document-picture-properties-section.crop, .work-document-picture-properties-section.transform, .work-document-picture-properties-alt-text {
   grid-column: 1 / -1;
 }
 
@@ -8448,6 +8448,34 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
   display: grid;
 }
 
+.work-document-picture-properties-transform-row {
+  min-height: 34px;
+  color: var(--a3s-muted);
+  grid-template-columns: 64px minmax(0, 1fr);
+  align-items: center;
+  gap: 8px;
+  font-size: 11px;
+  display: grid;
+}
+
+.work-document-picture-properties-transform-options {
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 6px 12px;
+  display: grid;
+}
+
+.work-document-picture-properties-transform-options .work-office-checkbox {
+  border-radius: 6px;
+  min-height: 34px;
+  padding: 5px 6px;
+}
+
+.work-document-picture-properties-transform-help {
+  color: var(--a3s-faint);
+  font-size: 10px;
+  line-height: 1.4;
+}
+
 .work-document-picture-properties-layer-options {
   grid-template-columns: repeat(2, minmax(0, 1fr));
   gap: 6px 12px;
@@ -11762,6 +11790,10 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
 .work-document-page .tiptap [data-resize-container][data-node="image"] {
   width: fit-content;
   max-width: 100%;
+  rotate: var(--work-document-image-rotation, 0deg);
+  scale: var(--work-document-image-flip-x, 1)
+    var(--work-document-image-flip-y, 1);
+  transform-origin: center;
   margin-block: 18px;
   display: block !important;
 }
@@ -12601,8 +12633,12 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
 }
 
 :is(.work-document-preview-page, .work-pdf-export-page.document) img[data-office-image-layout] {
-  border-radius: 4px;
   height: auto;
+  rotate: var(--work-document-image-rotation, 0deg);
+  scale: var(--work-document-image-flip-x, 1)
+    var(--work-document-image-flip-y, 1);
+  transform-origin: center;
+  border-radius: 4px;
   margin-block: 18px;
   display: block;
 }

package/docs/latest/en/browser-editor-architecture.md

@@ -836,12 +836,13 @@ stable ProseMirror position, and distribute list-container height without
 double-counting nested content.
 
 Document image nodes carry typed layout, alignment, wrap-distance, alternative
-text, size, and per-image aspect-ratio-lock attributes. The contextual Picture
+text, size, per-image aspect-ratio-lock, and bounded transform attributes. The contextual Picture
 ribbon keeps fast layout actions and opens one responsive Picture Properties
 dialog for centimeter width and height, aspect-ratio locking, wrapping,
 alignment, text distance, signed horizontal and vertical offsets, their column,
 paragraph, margin, or page reference frames, four-edge percentage cropping,
-relative drawing order, behind-text placement, overlap and cell-layout policy,
+quarter-turn rotation, horizontal/vertical reflection, relative drawing order,
+behind-text placement, overlap and cell-layout policy,
 anchor locking, and alternative text. Applying the complete draft
 updates only changed attributes in one separated TipTap history entry; cancel
 and Escape preserve the node and return focus to the exact invoker. Dimensions
@@ -865,7 +866,10 @@ and ordered `wrapPolygon` vertices. Aligned anchors remain aligned,
 while precise offsets preserve `positionH` and `positionV` reference frames
 through edit, preview, and regenerated DOCX. Four-edge crop geometry remains
 typed in the controlled model and round-trips as DrawingML `a:srcRect` for
-inline and floating pictures. Supported floating pictures also preserve
+inline and floating pictures. Quarter-turn rotation and reflection round-trip
+as DrawingML `a:xfrm` `rot`, `flipH`, and `flipV` values for inline and floating
+pictures. Arbitrary-angle or malformed transform values are diagnosed and
+normalized to the bounded model. Supported floating pictures also preserve
 drawing-layer relationships through unsigned `relativeHeight`,
 `behindDoc`, `allowOverlap`, `layoutInCell`, and `locked` anchor attributes.
 The browser maps the unsigned drawing order into bounded foreground and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.44.0",
+  "version": "0.45.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",