@univerjs/docs-drawing 1.0.0-alpha.7 → 1.0.0-beta.0

package/lib/index.js

@@ -1,6 +1,6 @@
-import { ArrangeTypeEnum, BooleanNumber, BuildTextUtils, CommandType, Disposable, ICommandService, IConfigService, IResourceManagerService, IUndoRedoService, IUniverInstanceService, Inject, Injector, JSONX, MemoryCursor, Plugin, PositionedObjectLayoutType, TextX, TextXActionType, Tools, UniverInstanceType, createIdentifier, getCustomBlockIdsInSelections, getRichTextEditPath, merge, toDisposable, touchDependencies } from "@univerjs/core";
-import { DocSelectionManagerService, RichTextEditingMutation, getContentInsertRange, normalizeTextRange } from "@univerjs/docs";
-import { IDrawingManagerService, UnitDrawingService } from "@univerjs/drawing";
+import { ArrangeTypeEnum, BooleanNumber, BuildTextUtils, CommandType, DependentOn, Disposable, ICommandService, IConfigService, IResourceManagerService, IUndoRedoService, IUniverInstanceService, Inject, Injector, JSONX, MemoryCursor, Plugin, PositionedObjectLayoutType, TextX, TextXActionType, Tools, UniverInstanceType, createIdentifier, getRichTextEditPath, merge, toDisposable, touchDependencies } from "@univerjs/core";
+import { DocSelectionManagerService, RichTextEditingMutation, UniverDocsPlugin, getContentInsertRange, normalizeTextRange } from "@univerjs/docs";
+import { IDrawingManagerService, UnitDrawingService, UniverDrawingPlugin } from "@univerjs/drawing";
 
 //#region src/commands/commands/insert-doc-drawing.command.ts
 /**
@@ -10,81 +10,29 @@ const InsertDocDrawingCommand = {
 	id: "doc.command.insert-doc-image",
 	type: CommandType.COMMAND,
 	handler: (accessor, params) => {
-		var _documentDataModel$ge, _snapshot$headers, _snapshot$footers, _snapshot$drawingsOrd, _snapshot$drawingsOrd2;
+		var _documentDataModel$ge, _snapshot$headers, _snapshot$footers;
 		if (!params) return false;
 		const commandService = accessor.get(ICommandService);
 		const univerInstanceService = accessor.get(IUniverInstanceService);
 		const { unitId, drawings, textRange } = params;
 		const documentDataModel = univerInstanceService.getUnit(unitId, UniverInstanceType.UNIVER_DOC);
 		if (!documentDataModel) return false;
-		const targetTextRange = resolveDocDrawingInsertTextRange(accessor, unitId, textRange);
-		if (!targetTextRange) return false;
-		const { collapsed, startOffset, segmentId = "" } = targetTextRange;
-		const body = (_documentDataModel$ge = documentDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _documentDataModel$ge === void 0 ? void 0 : _documentDataModel$ge.getBody();
-		if (!body) return false;
-		const textX = new TextX();
-		const jsonX = JSONX.getInstance();
-		const rawActions = [];
+		const resolvedTextRange = resolveDocDrawingInsertTextRange(accessor, unitId, textRange);
+		if (!resolvedTextRange) return false;
+		const { segmentId = "" } = resolvedTextRange;
+		if (!((_documentDataModel$ge = documentDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _documentDataModel$ge === void 0 ? void 0 : _documentDataModel$ge.getBody())) return false;
 		const snapshot = documentDataModel.getSnapshot();
-		const targetDrawings = !!((_snapshot$headers = snapshot.headers) === null || _snapshot$headers === void 0 ? void 0 : _snapshot$headers[segmentId]) || !!((_snapshot$footers = snapshot.footers) === null || _snapshot$footers === void 0 ? void 0 : _snapshot$footers[segmentId]) ? drawings.map((drawing) => {
-			var _drawing$transforms;
-			return {
-				...drawing,
-				isMultiTransform: BooleanNumber.TRUE,
-				transforms: (_drawing$transforms = drawing.transforms) !== null && _drawing$transforms !== void 0 ? _drawing$transforms : drawing.transform ? [drawing.transform] : null
-			};
-		}) : drawings;
-		const drawingOrderLength = (_snapshot$drawingsOrd = (_snapshot$drawingsOrd2 = snapshot.drawingsOrder) === null || _snapshot$drawingsOrd2 === void 0 ? void 0 : _snapshot$drawingsOrd2.length) !== null && _snapshot$drawingsOrd !== void 0 ? _snapshot$drawingsOrd : 0;
-		let removeDrawingLen = 0;
-		if (collapsed) {
-			if (startOffset > 0) textX.push({
-				t: TextXActionType.RETAIN,
-				len: startOffset
-			});
-		} else {
-			var _documentDataModel$ge2, _documentDataModel$ge3;
-			const dos = BuildTextUtils.selection.delete([targetTextRange], body, 0, null, false);
-			textX.push(...dos);
-			const removedCustomBlockIds = getCustomBlockIdsInSelections(body, [targetTextRange]);
-			const drawings = (_documentDataModel$ge2 = documentDataModel.getDrawings()) !== null && _documentDataModel$ge2 !== void 0 ? _documentDataModel$ge2 : {};
-			const drawingOrder = (_documentDataModel$ge3 = documentDataModel.getDrawingsOrder()) !== null && _documentDataModel$ge3 !== void 0 ? _documentDataModel$ge3 : [];
-			const sortedRemovedCustomBlockIds = removedCustomBlockIds.sort((a, b) => {
-				if (drawingOrder.indexOf(a) > drawingOrder.indexOf(b)) return -1;
-				else if (drawingOrder.indexOf(a) < drawingOrder.indexOf(b)) return 1;
-				return 0;
-			});
-			if (sortedRemovedCustomBlockIds.length > 0) for (const blockId of sortedRemovedCustomBlockIds) {
-				const drawing = drawings[blockId];
-				const drawingIndex = drawingOrder.indexOf(blockId);
-				if (drawing == null || drawingIndex < 0) continue;
-				const removeDrawingAction = jsonX.removeOp(["drawings", blockId], drawing);
-				const removeDrawingOrderAction = jsonX.removeOp(["drawingsOrder", drawingIndex], blockId);
-				rawActions.push(removeDrawingAction);
-				rawActions.push(removeDrawingOrderAction);
-				removeDrawingLen++;
-			}
-		}
-		textX.push({
-			t: TextXActionType.INSERT,
-			body: {
-				dataStream: "\b".repeat(targetDrawings.length),
-				customBlocks: targetDrawings.map((drawing, i) => ({
-					startIndex: i,
-					blockId: drawing.drawingId
-				}))
-			},
-			len: targetDrawings.length
+		const targetDrawings = !!((_snapshot$headers = snapshot.headers) === null || _snapshot$headers === void 0 ? void 0 : _snapshot$headers[segmentId]) || !!((_snapshot$footers = snapshot.footers) === null || _snapshot$footers === void 0 ? void 0 : _snapshot$footers[segmentId]) ? drawings.map((drawing) => ({
+			...drawing,
+			isMultiTransform: BooleanNumber.TRUE,
+			transforms: drawing.transforms ?? (drawing.transform ? [drawing.transform] : null)
+		})) : drawings;
+		const actions = BuildTextUtils.drawing.add({
+			selection: resolvedTextRange,
+			documentDataModel,
+			drawings: targetDrawings
 		});
-		const path = getRichTextEditPath(documentDataModel, segmentId);
-		const placeHolderAction = jsonX.editOp(textX.serialize(), path);
-		rawActions.push(placeHolderAction);
-		for (const drawing of targetDrawings) {
-			const { drawingId } = drawing;
-			const addDrawingAction = jsonX.insertOp(["drawings", drawingId], drawing);
-			const addDrawingOrderAction = jsonX.insertOp(["drawingsOrder", drawingOrderLength - removeDrawingLen], drawingId);
-			rawActions.push(addDrawingAction);
-			rawActions.push(addDrawingOrderAction);
-		}
+		if (!actions) return false;
 		const doMutation = {
 			id: RichTextEditingMutation.id,
 			params: {
@@ -93,30 +41,26 @@ const InsertDocDrawingCommand = {
 				textRanges: []
 			}
 		};
-		doMutation.params.actions = rawActions.reduce((acc, cur) => {
-			return JSONX.compose(acc, cur);
-		}, null);
+		doMutation.params.actions = actions;
 		const result = commandService.syncExecuteCommand(doMutation.id, doMutation.params);
 		return Boolean(result);
 	}
 };
 function resolveDocDrawingInsertTextRange(accessor, unitId, textRange) {
-	var _ref, _contentInsertRange$s;
 	const activeTextRange = accessor.get(DocSelectionManagerService).getActiveTextRange();
-	const explicitTextRange = textRange ? normalizeTextRange(textRange) : null;
-	const contentInsertRange = explicitTextRange !== null && explicitTextRange !== void 0 ? explicitTextRange : getContentInsertRange(accessor, unitId);
-	if (!contentInsertRange) return activeTextRange !== null && activeTextRange !== void 0 ? activeTextRange : null;
+	const contentInsertRange = (textRange ? normalizeTextRange(textRange) : null) ?? getContentInsertRange(accessor, unitId);
+	if (!contentInsertRange) return activeTextRange ?? null;
 	return {
 		...activeTextRange,
 		startOffset: contentInsertRange.startOffset,
 		endOffset: contentInsertRange.endOffset,
 		collapsed: contentInsertRange.startOffset === contentInsertRange.endOffset,
-		segmentId: (_ref = (_contentInsertRange$s = contentInsertRange.segmentId) !== null && _contentInsertRange$s !== void 0 ? _contentInsertRange$s : activeTextRange === null || activeTextRange === void 0 ? void 0 : activeTextRange.segmentId) !== null && _ref !== void 0 ? _ref : ""
+		segmentId: contentInsertRange.segmentId ?? (activeTextRange === null || activeTextRange === void 0 ? void 0 : activeTextRange.segmentId) ?? ""
 	};
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/typeof.js
+//#region \0@oxc-project+runtime@0.140.0/helpers/esm/typeof.js
 function _typeof(o) {
 	"@babel/helpers - typeof";
 	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
@@ -127,7 +71,7 @@ function _typeof(o) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/toPrimitive.js
+//#region \0@oxc-project+runtime@0.140.0/helpers/esm/toPrimitive.js
 function toPrimitive(t, r) {
 	if ("object" != _typeof(t) || !t) return t;
 	var e = t[Symbol.toPrimitive];
@@ -140,14 +84,14 @@ function toPrimitive(t, r) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/toPropertyKey.js
+//#region \0@oxc-project+runtime@0.140.0/helpers/esm/toPropertyKey.js
 function toPropertyKey(t) {
 	var i = toPrimitive(t, "string");
 	return "symbol" == _typeof(i) ? i : i + "";
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/defineProperty.js
+//#region \0@oxc-project+runtime@0.140.0/helpers/esm/defineProperty.js
 function _defineProperty(e, r, t) {
 	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
 		value: t,
@@ -201,7 +145,7 @@ const RemoveDocDrawingCommand = {
 	id: "doc.command.remove-doc-image",
 	type: CommandType.COMMAND,
 	handler: (accessor, params) => {
-		var _ref, _contentInsertRange$s, _documentDataModel$ge, _documentDataModel$ge2, _documentDataModel$ge3;
+		var _documentDataModel$ge;
 		if (!params) return false;
 		const commandService = accessor.get(ICommandService);
 		const undoRedoService = accessor.get(IUndoRedoService);
@@ -212,29 +156,27 @@ const RemoveDocDrawingCommand = {
 		const documentDataModel = univerInstanceService.getUnit(unitId, UniverInstanceType.UNIVER_DOC);
 		if (!documentDataModel || removeDrawings.length === 0) return false;
 		const activeTextRange = docSelectionManagerService.getActiveTextRange();
-		const explicitTextRange = !textRange ? null : normalizeTextRange(textRange);
-		const contentInsertRange = explicitTextRange !== null && explicitTextRange !== void 0 ? explicitTextRange : getContentInsertRange(accessor, unitId);
-		const segmentId = (_ref = (_contentInsertRange$s = contentInsertRange === null || contentInsertRange === void 0 ? void 0 : contentInsertRange.segmentId) !== null && _contentInsertRange$s !== void 0 ? _contentInsertRange$s : activeTextRange === null || activeTextRange === void 0 ? void 0 : activeTextRange.segmentId) !== null && _ref !== void 0 ? _ref : "";
+		const contentInsertRange = (!textRange ? null : normalizeTextRange(textRange)) ?? getContentInsertRange(accessor, unitId);
+		const segmentId = (contentInsertRange === null || contentInsertRange === void 0 ? void 0 : contentInsertRange.segmentId) ?? (activeTextRange === null || activeTextRange === void 0 ? void 0 : activeTextRange.segmentId) ?? "";
 		const textX = new TextX();
 		const jsonX = JSONX.getInstance();
-		const customBlocks = (_documentDataModel$ge = (_documentDataModel$ge2 = documentDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _documentDataModel$ge2 === void 0 || (_documentDataModel$ge2 = _documentDataModel$ge2.getBody()) === null || _documentDataModel$ge2 === void 0 ? void 0 : _documentDataModel$ge2.customBlocks) !== null && _documentDataModel$ge !== void 0 ? _documentDataModel$ge : [];
+		const customBlocks = ((_documentDataModel$ge = documentDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _documentDataModel$ge === void 0 || (_documentDataModel$ge = _documentDataModel$ge.getBody()) === null || _documentDataModel$ge === void 0 ? void 0 : _documentDataModel$ge.customBlocks) ?? [];
 		const removeCustomBlocks = removeDrawings.map((drawing) => customBlocks.find((customBlock) => customBlock.blockId === drawing.drawingId)).filter((block) => !!block).sort((a, b) => a.startIndex > b.startIndex ? 1 : -1);
 		if (removeCustomBlocks.length === 0) return false;
-		const drawings = (_documentDataModel$ge3 = documentDataModel.getDrawings()) !== null && _documentDataModel$ge3 !== void 0 ? _documentDataModel$ge3 : {};
+		const drawings = documentDataModel.getDrawings() ?? {};
 		const removeDrawingParamById = new Map(removeDrawings.map((drawing) => [drawing.drawingId, drawing]));
 		const removeDrawingSnapshots = removeCustomBlocks.map((block) => drawings[block.blockId]).filter((drawing) => drawing != null);
 		const resourceRedoMutations = [];
 		const resourceUndoMutations = [];
 		const resourceMutationGroups = [];
 		for (const block of removeCustomBlocks) {
-			var _removeDrawingParam$s;
 			const { blockId } = block;
 			const drawing = drawings[blockId];
 			if (drawing == null) continue;
 			const removeDrawingParam = removeDrawingParamById.get(blockId);
 			const mutationInfos = drawingAdapterService.getRemoveDrawingMutationInfos({
 				unitId,
-				subUnitId: (_removeDrawingParam$s = removeDrawingParam === null || removeDrawingParam === void 0 ? void 0 : removeDrawingParam.subUnitId) !== null && _removeDrawingParam$s !== void 0 ? _removeDrawingParam$s : unitId,
+				subUnitId: (removeDrawingParam === null || removeDrawingParam === void 0 ? void 0 : removeDrawingParam.subUnitId) ?? unitId,
 				drawing,
 				removeDrawings: removeDrawingSnapshots
 			});
@@ -319,13 +261,47 @@ function executeMutations(mutations, commandService) {
 	return true;
 }
 
-//#endregion
-//#region src/services/doc-drawing.service.ts
-var DocDrawingService = class extends UnitDrawingService {};
-const IDocDrawingService = createIdentifier("univer.doc.plugin.doc-drawing.service");
-
 //#endregion
 //#region src/commands/commands/set-drawing-arrange.command.ts
+const DRAWINGS_ORDER_KEY = "drawingsOrder";
+/**
+* Calculates the target model order. Adjacent moves treat selected drawings as a group,
+* so selected drawings keep their relative order instead of crossing each other.
+*/
+function getArrangedDrawingOrder(drawingOrder, drawingIds, arrangeType) {
+	const selectedDrawingIds = new Set(drawingIds.filter((drawingId) => drawingOrder.includes(drawingId)));
+	const arrangedDrawingOrder = [...drawingOrder];
+	if (selectedDrawingIds.size === 0) return arrangedDrawingOrder;
+	if (arrangeType === ArrangeTypeEnum.forward) {
+		for (let index = arrangedDrawingOrder.length - 2; index >= 0; index--) if (selectedDrawingIds.has(arrangedDrawingOrder[index]) && !selectedDrawingIds.has(arrangedDrawingOrder[index + 1])) [arrangedDrawingOrder[index], arrangedDrawingOrder[index + 1]] = [arrangedDrawingOrder[index + 1], arrangedDrawingOrder[index]];
+	} else if (arrangeType === ArrangeTypeEnum.backward) {
+		for (let index = 1; index < arrangedDrawingOrder.length; index++) if (selectedDrawingIds.has(arrangedDrawingOrder[index]) && !selectedDrawingIds.has(arrangedDrawingOrder[index - 1])) [arrangedDrawingOrder[index], arrangedDrawingOrder[index - 1]] = [arrangedDrawingOrder[index - 1], arrangedDrawingOrder[index]];
+	} else if (arrangeType === ArrangeTypeEnum.front || arrangeType === ArrangeTypeEnum.back) {
+		const selected = arrangedDrawingOrder.filter((drawingId) => selectedDrawingIds.has(drawingId));
+		const unselected = arrangedDrawingOrder.filter((drawingId) => !selectedDrawingIds.has(drawingId));
+		return arrangeType === ArrangeTypeEnum.front ? [...unselected, ...selected] : [...selected, ...unselected];
+	}
+	return arrangedDrawingOrder;
+}
+/**
+* Converts the target order into granular JSONX move operations. This avoids replacing
+* the entire drawingsOrder array and keeps collaboration conflicts scoped to moved items.
+*/
+function createDrawingOrderActions(drawingOrder, arrangedDrawingOrder) {
+	const jsonX = JSONX.getInstance();
+	const workingDrawingOrder = [...drawingOrder];
+	const rawActions = [];
+	for (let targetIndex = 0; targetIndex < arrangedDrawingOrder.length; targetIndex++) {
+		const drawingId = arrangedDrawingOrder[targetIndex];
+		const currentIndex = workingDrawingOrder.indexOf(drawingId);
+		if (currentIndex < 0 || currentIndex === targetIndex) continue;
+		const action = jsonX.moveOp([DRAWINGS_ORDER_KEY, currentIndex], [DRAWINGS_ORDER_KEY, targetIndex]);
+		if (action) rawActions.push(action);
+		workingDrawingOrder.splice(currentIndex, 1);
+		workingDrawingOrder.splice(targetIndex, 0, drawingId);
+	}
+	return rawActions.reduce((actions, action) => JSONX.compose(actions, action), null);
+}
 /**
 * The command to arrange drawings.
 */
@@ -334,39 +310,18 @@ const SetDocDrawingArrangeCommand = {
 	type: CommandType.COMMAND,
 	handler: (accessor, params) => {
 		const commandService = accessor.get(ICommandService);
-		const docDrawingService = accessor.get(IDocDrawingService);
 		if (params == null) return false;
-		const { unitId, subUnitId, drawingIds, arrangeType } = params;
-		const drawingOrderMapParam = {
+		const { unitId, drawingIds, arrangeType } = params;
+		const documentDataModel = accessor.get(IUniverInstanceService).getUnit(unitId, UniverInstanceType.UNIVER_DOC);
+		const drawingOrder = documentDataModel === null || documentDataModel === void 0 ? void 0 : documentDataModel.getDrawingsOrder();
+		if (!drawingOrder) return false;
+		const actions = createDrawingOrderActions(drawingOrder, getArrangedDrawingOrder(drawingOrder, drawingIds, arrangeType));
+		if (JSONX.isNoop(actions)) return false;
+		const result = commandService.syncExecuteCommand(RichTextEditingMutation.id, {
 			unitId,
-			subUnitId,
-			drawingIds
-		};
-		let jsonOp;
-		if (arrangeType === ArrangeTypeEnum.forward) jsonOp = docDrawingService.getForwardDrawingsOp(drawingOrderMapParam);
-		else if (arrangeType === ArrangeTypeEnum.backward) jsonOp = docDrawingService.getBackwardDrawingOp(drawingOrderMapParam);
-		else if (arrangeType === ArrangeTypeEnum.front) jsonOp = docDrawingService.getFrontDrawingsOp(drawingOrderMapParam);
-		else if (arrangeType === ArrangeTypeEnum.back) jsonOp = docDrawingService.getBackDrawingsOp(drawingOrderMapParam);
-		if (jsonOp == null) return false;
-		const { redo } = jsonOp;
-		if (redo == null) return false;
-		const rawActions = [];
-		let redoCopy = Tools.deepClone(redo);
-		redoCopy = redoCopy.slice(3);
-		redoCopy.unshift("drawingsOrder");
-		rawActions.push(redoCopy);
-		const doMutation = {
-			id: RichTextEditingMutation.id,
-			params: {
-				unitId,
-				actions: [],
-				textRanges: null
-			}
-		};
-		doMutation.params.actions = rawActions.reduce((acc, cur) => {
-			return JSONX.compose(acc, cur);
-		}, null);
-		const result = commandService.syncExecuteCommand(doMutation.id, doMutation.params);
+			actions,
+			textRanges: null
+		});
 		return Boolean(result);
 	}
 };
@@ -377,14 +332,13 @@ const UpdateDrawingDocTransformCommand = {
 	id: "doc.command.update-drawing-doc-transform",
 	type: CommandType.COMMAND,
 	handler: (accessor, params) => {
-		var _documentDataModel$ge;
 		if (!params) return false;
 		const commandService = accessor.get(ICommandService);
 		const univerInstanceService = accessor.get(IUniverInstanceService);
 		const { unitId, drawings } = params;
 		const documentDataModel = univerInstanceService.getUnit(unitId, UniverInstanceType.UNIVER_DOC);
 		if (!documentDataModel) return false;
-		const oldDrawings = (_documentDataModel$ge = documentDataModel.getSnapshot().drawings) !== null && _documentDataModel$ge !== void 0 ? _documentDataModel$ge : {};
+		const oldDrawings = documentDataModel.getSnapshot().drawings ?? {};
 		const jsonX = JSONX.getInstance();
 		const actions = [];
 		for (const { drawingId, key, value } of drawings) {
@@ -411,11 +365,43 @@ const UpdateDrawingDocTransformCommand = {
 
 //#endregion
 //#region src/commands/commands/update-doc-drawing-wrapping-style.command.ts
+/**
+* Controls how a document drawing participates in text layout.
+*
+* `INLINE`, `WRAP_SQUARE`, and `WRAP_TOP_AND_BOTTOM` participate in text layout and can cause text to reflow.
+* `BEHIND_TEXT` and `IN_FRONT_OF_TEXT` are overlay styles and do not cause text to reflow.
+*/
 let TextWrappingStyle = /* @__PURE__ */ function(TextWrappingStyle) {
+	/**
+	* Places the drawing in the text flow like a character.
+	*
+	* The drawing occupies layout space and does not overlap surrounding text. Its position is determined by its
+	* document range, so floating position settings have no visible effect.
+	*/
 	TextWrappingStyle["INLINE"] = "inline";
+	/**
+	* Floats the drawing behind document text without causing the text to reflow.
+	*
+	* Use this style for backgrounds or watermarks. Text can overlap the drawing, so ensure that it remains readable.
+	*/
 	TextWrappingStyle["BEHIND_TEXT"] = "behindText";
+	/**
+	* Floats the drawing in front of document text without causing the text to reflow.
+	*
+	* The drawing can cover overlapping text. Use this style only when an overlay is intentional.
+	*/
 	TextWrappingStyle["IN_FRONT_OF_TEXT"] = "inFrontOfText";
+	/**
+	* Floats the drawing and wraps text around its rectangular bounds.
+	*
+	* Use this style for images that should appear beside body text, such as portraits or illustrations.
+	*/
 	TextWrappingStyle["WRAP_SQUARE"] = "wrapSquare";
+	/**
+	* Floats the drawing in a horizontal band, with text only above and below it.
+	*
+	* Use this style for wide figures or standalone illustrations that should not have text beside them.
+	*/
 	TextWrappingStyle["WRAP_TOP_AND_BOTTOM"] = "wrapTopAndBottom";
 	return TextWrappingStyle;
 }({});
@@ -433,13 +419,12 @@ const UpdateDocDrawingWrappingStyleCommand = {
 	id: "doc.command.update-doc-drawing-wrapping-style",
 	type: CommandType.COMMAND,
 	handler: (accessor, params) => {
-		var _documentDataModel$ge;
 		if (!params) return false;
 		const { drawings, wrappingStyle, unitId } = params;
 		const commandService = accessor.get(ICommandService);
 		const documentDataModel = accessor.get(IUniverInstanceService).getUnit(unitId, UniverInstanceType.UNIVER_DOC);
 		if (!documentDataModel) return false;
-		const oldDrawings = (_documentDataModel$ge = documentDataModel.getDrawings()) !== null && _documentDataModel$ge !== void 0 ? _documentDataModel$ge : {};
+		const oldDrawings = documentDataModel.getDrawings() ?? {};
 		const jsonX = JSONX.getInstance();
 		const rawActions = [];
 		for (const drawing of drawings) {
@@ -484,7 +469,12 @@ const UpdateDocDrawingWrappingStyleCommand = {
 };
 
 //#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/decorateParam.js
+//#region src/services/doc-drawing.service.ts
+var DocDrawingService = class extends UnitDrawingService {};
+const IDocDrawingService = createIdentifier("univer.doc.plugin.doc-drawing.service");
+
+//#endregion
+//#region \0@oxc-project+runtime@0.140.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);
@@ -492,7 +482,7 @@ function __decorateParam(paramIndex, decorator) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.140.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -537,8 +527,8 @@ let DocDrawingController = class DocDrawingController extends Disposable {
 				const drawings = doc.getSnapshot().drawings;
 				const drawingOrder = doc.getSnapshot().drawingsOrder;
 				return JSON.stringify({
-					data: drawings !== null && drawings !== void 0 ? drawings : {},
-					order: drawingOrder !== null && drawingOrder !== void 0 ? drawingOrder : []
+					data: drawings ?? {},
+					order: drawingOrder ?? []
 				});
 			}
 			return "";
@@ -569,10 +559,9 @@ let DocDrawingController = class DocDrawingController extends Disposable {
 				});
 			},
 			onLoad: (unitId, value) => {
-				var _value$data, _value$order;
 				this._setDrawingDataForUnit(unitId, {
-					data: (_value$data = value.data) !== null && _value$data !== void 0 ? _value$data : {},
-					order: (_value$order = value.order) !== null && _value$order !== void 0 ? _value$order : []
+					data: value.data ?? {},
+					order: value.order ?? []
 				});
 			}
 		}));
@@ -625,7 +614,7 @@ DocDrawingController = __decorate([
 //#endregion
 //#region package.json
 var name = "@univerjs/docs-drawing";
-var version = "1.0.0-alpha.7";
+var version = "1.0.0-beta.0";
 
 //#endregion
 //#region src/config/config.ts
@@ -674,7 +663,11 @@ _defineProperty(UniverDocsDrawingPlugin, "pluginName", DOCS_DRAWING_PLUGIN);
 _defineProperty(UniverDocsDrawingPlugin, "packageName", name);
 _defineProperty(UniverDocsDrawingPlugin, "version", version);
 _defineProperty(UniverDocsDrawingPlugin, "type", UniverInstanceType.UNIVER_DOC);
-UniverDocsDrawingPlugin = __decorate([__decorateParam(1, Inject(Injector)), __decorateParam(2, IConfigService)], UniverDocsDrawingPlugin);
+UniverDocsDrawingPlugin = __decorate([
+	DependentOn(UniverDocsPlugin, UniverDrawingPlugin),
+	__decorateParam(1, Inject(Injector)),
+	__decorateParam(2, IConfigService)
+], UniverDocsDrawingPlugin);
 
 //#endregion
 export { DOCS_DRAWING_PLUGIN, DocDrawingAdapterService, DocDrawingController, DocDrawingService, IDocDrawingAdapterService, IDocDrawingService, InsertDocDrawingCommand, RemoveDocDrawingCommand, SetDocDrawingArrangeCommand, TextWrappingStyle, UniverDocsDrawingPlugin, UpdateDocDrawingWrappingStyleCommand, UpdateDrawingDocTransformCommand, WRAPPING_STYLE_TO_LAYOUT_TYPE, getDocDrawingRenderOrder };

package/lib/types/commands/commands/update-doc-drawing-wrapping-style.command.d.ts

@@ -16,11 +16,43 @@
 import type { ICommand } from '@univerjs/core';
 import type { IDocDrawing } from '../../services/doc-drawing.service';
 import { PositionedObjectLayoutType } from '@univerjs/core';
+/**
+ * Controls how a document drawing participates in text layout.
+ *
+ * `INLINE`, `WRAP_SQUARE`, and `WRAP_TOP_AND_BOTTOM` participate in text layout and can cause text to reflow.
+ * `BEHIND_TEXT` and `IN_FRONT_OF_TEXT` are overlay styles and do not cause text to reflow.
+ */
 export declare enum TextWrappingStyle {
+    /**
+     * Places the drawing in the text flow like a character.
+     *
+     * The drawing occupies layout space and does not overlap surrounding text. Its position is determined by its
+     * document range, so floating position settings have no visible effect.
+     */
     INLINE = "inline",
+    /**
+     * Floats the drawing behind document text without causing the text to reflow.
+     *
+     * Use this style for backgrounds or watermarks. Text can overlap the drawing, so ensure that it remains readable.
+     */
     BEHIND_TEXT = "behindText",
+    /**
+     * Floats the drawing in front of document text without causing the text to reflow.
+     *
+     * The drawing can cover overlapping text. Use this style only when an overlay is intentional.
+     */
     IN_FRONT_OF_TEXT = "inFrontOfText",
+    /**
+     * Floats the drawing and wraps text around its rectangular bounds.
+     *
+     * Use this style for images that should appear beside body text, such as portraits or illustrations.
+     */
     WRAP_SQUARE = "wrapSquare",
+    /**
+     * Floats the drawing in a horizontal band, with text only above and below it.
+     *
+     * Use this style for wide figures or standalone illustrations that should not have text beside them.
+     */
     WRAP_TOP_AND_BOTTOM = "wrapTopAndBottom"
 }
 export declare const WRAPPING_STYLE_TO_LAYOUT_TYPE: Record<TextWrappingStyle, PositionedObjectLayoutType>;

package/lib/types/facade/f-document-image.d.ts

@@ -228,6 +228,11 @@ export declare class FDocumentImage {
     setPositionV(positionV: IObjectPositionV): boolean;
     /**
      * Sets the image wrapping style.
+     *
+     * Use `INLINE` to place the image in the text flow, `WRAP_SQUARE` to flow text beside it, or
+     * `WRAP_TOP_AND_BOTTOM` to keep text above and below it. `BEHIND_TEXT` and `IN_FRONT_OF_TEXT` do not reserve space
+     * in the text layout and can overlap text.
+     *
      * When switching from inline to a floating style in a UI environment, the current visual position is preserved.
      * @param {TextWrappingStyle} wrappingStyle The wrapping style to apply.
      * @returns {boolean} `true` when the update command succeeds; otherwise, `false`.
@@ -237,7 +242,8 @@ export declare class FDocumentImage {
      * const image = fDocument.getImages()[0];
      *
      * if (image) {
-     *   const success = image.setWrappingStyle(univerAPI.Enum.DocsImageWrappingStyle.WRAP_SQUARE);
+     *   // Float the image beside body text without covering it.
+     *   const success = image.setWrappingStyle(univerAPI.Enum.TextWrappingStyle.WRAP_SQUARE);
      *   console.log(success);
      * }
      * ```

package/lib/types/facade/f-document.d.ts

@@ -40,7 +40,13 @@ export interface IFDocumentInsertImageOptions {
      * It has a visible positioning effect only when `wrappingStyle` is not `INLINE`.
      */
     positionV?: IObjectPositionV;
-    /** The image wrapping style. Defaults to `TextWrappingStyle.INLINE`. */
+    /**
+     * The image wrapping style. Defaults to `TextWrappingStyle.INLINE`.
+     *
+     * Use `INLINE` to place the image in the text flow, `WRAP_SQUARE` to flow text beside it, or
+     * `WRAP_TOP_AND_BOTTOM` to keep text above and below it. `BEHIND_TEXT` and `IN_FRONT_OF_TEXT` are overlay styles:
+     * they do not reserve space in the text layout, so text and the image can overlap.
+     */
     wrappingStyle?: TextWrappingStyle;
     /** The document range at which to insert the image. The current selection is used when omitted. */
     textRange?: ITextRangeParam;
@@ -51,6 +57,9 @@ export interface IFDocumentImageMixin {
      * Inserts an image into the document.
      *
      * When width and height are both omitted, the intrinsic size is proportionally limited to 500 by 500 pixels.
+     * For ordinary content, prefer `INLINE`, `WRAP_SQUARE`, or `WRAP_TOP_AND_BOTTOM`. Use `BEHIND_TEXT` for
+     * backgrounds or watermarks and `IN_FRONT_OF_TEXT` only for intentional overlays, because these two styles do not
+     * cause text to reflow.
      *
      * @param {IFDocumentInsertImageOptions} options The image source, optional transform, and insertion range.
      * @returns {Promise<FDocumentImage | null>} The inserted image facade, or `null` when the insertion command fails.
@@ -61,6 +70,8 @@ export interface IFDocumentImageMixin {
      *   source: 'https://avatars.githubusercontent.com/u/61444807?s=48&v=4',
      *   imageSourceType: univerAPI.Enum.ImageSourceType.URL,
      *   width: 320,
+     *   // Keep the image in the text flow so it cannot cover surrounding text.
+     *   wrappingStyle: univerAPI.Enum.TextWrappingStyle.INLINE,
      *   textRange: {
      *     startOffset: 30,
      *   },
@@ -75,7 +86,8 @@ export interface IFDocumentImageMixin {
      *   source: 'https://avatars.githubusercontent.com/u/61444807?s=48&v=4',
      *   imageSourceType: univerAPI.Enum.ImageSourceType.URL,
      *   width: 320,
-     *   wrappingStyle: univerAPI.Enum.DocsImageWrappingStyle.WRAP_SQUARE,
+     *   // Float the image and let body text flow beside its rectangular bounds.
+     *   wrappingStyle: univerAPI.Enum.TextWrappingStyle.WRAP_SQUARE,
      *   textRange: {
      *     startOffset: 30,
      *   },

package/lib/types/facade/f-enum.d.ts

@@ -21,7 +21,11 @@ import { TextWrappingStyle } from '@univerjs/docs-drawing';
  */
 export interface IFDocumentImageEnumMixin {
     /**
-     * Represents the wrapping styles used by docs image operations.
+     * Represents the text wrapping styles used by document drawings, including images and Shapes.
+     *
+     * Prefer `INLINE`, `WRAP_SQUARE`, or `WRAP_TOP_AND_BOTTOM` for ordinary document content.
+     * `BEHIND_TEXT` and `IN_FRONT_OF_TEXT` are overlay styles that do not cause text to reflow.
+     * Use this property whenever a Facade signature references `TextWrappingStyle`.
      * @example
      * ```ts
      * const fDocument = univerAPI.getActiveDocument();
@@ -29,7 +33,8 @@ export interface IFDocumentImageEnumMixin {
      *   source: 'https://avatars.githubusercontent.com/u/61444807?s=48&v=4',
      *   imageSourceType: univerAPI.Enum.ImageSourceType.URL,
      *   width: 320,
-     *   wrappingStyle: univerAPI.Enum.DocsImageWrappingStyle.WRAP_SQUARE,
+     *   // Float the image and wrap body text around its rectangular bounds.
+     *   wrappingStyle: univerAPI.Enum.TextWrappingStyle.WRAP_SQUARE,
      *   textRange: {
      *     startOffset: 30,
      *   },
@@ -37,7 +42,7 @@ export interface IFDocumentImageEnumMixin {
      * console.log(image);
      * ```
      */
-    DocsImageWrappingStyle: typeof TextWrappingStyle;
+    TextWrappingStyle: typeof TextWrappingStyle;
     /**
      * Represents the horizontal position types used by docs image operations.
      * @example
@@ -74,7 +79,7 @@ export interface IFDocumentImageEnumMixin {
     DocsImageRelativeFromV: typeof ObjectRelativeFromV;
 }
 export declare class FDocumentImageEnumMixin extends FEnum implements IFDocumentImageEnumMixin {
-    get DocsImageWrappingStyle(): typeof TextWrappingStyle;
+    get TextWrappingStyle(): typeof TextWrappingStyle;
     get DocsImageRelativeFromH(): typeof ObjectRelativeFromH;
     get DocsImageRelativeFromV(): typeof ObjectRelativeFromV;
 }

package/lib/umd/facade.js

@@ -1 +1 @@
-(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("@univerjs/core"),require("@univerjs/docs"),require("@univerjs/docs-drawing"),require("@univerjs/docs/facade"),require("@univerjs/drawing"),require("@univerjs/core/facade")):typeof define==`function`&&define.amd?define([`exports`,`@univerjs/core`,`@univerjs/docs`,`@univerjs/docs-drawing`,`@univerjs/docs/facade`,`@univerjs/drawing`,`@univerjs/core/facade`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.UniverDocsDrawingFacade={},e.UniverCore,e.UniverDocs,e.UniverDocsDrawing,e.UniverDocsFacade,e.UniverDrawing,e.UniverCoreFacade))})(this,function(e,t,n,r,i,a,o){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var s=class{constructor(e,t,n){this._document=e,this._imageId=t,this._injector=n}getUnitId(){return this._document.getId()}getId(){return this._imageId}getSource(){var e;return(e=this.getImageData())==null?void 0:e.source}getSourceType(){var e;return(e=this.getImageData())==null?void 0:e.imageSourceType}getSize(){var e,t;return(e=(t=this.getImageData())==null?void 0:t.docTransform.size)==null?null:e}getAngle(){var e;return(e=this.getImageData())==null?void 0:e.docTransform.angle}getPositionH(){var e,t;return(e=(t=this.getImageData())==null?void 0:t.docTransform.positionH)==null?null:e}getPositionV(){var e,t;return(e=(t=this.getImageData())==null?void 0:t.docTransform.positionV)==null?null:e}getImageData(){var e;let n=(e=this._document.getDocumentDataModel().getDrawings())==null?void 0:e[this._imageId];return!n||n.drawingType!==t.DrawingTypeEnum.DRAWING_IMAGE?null:n}setSize(e,t){return this._updateTransform(`size`,{width:e,height:t})}setRotate(e){return this._updateTransform(`angle`,e)}setPositionH(e){return this._updateTransform(`positionH`,e)}setPositionV(e){return this._updateTransform(`positionV`,e)}setWrappingStyle(e){let n=this.getImageData();return n?this._injector.get(t.ICommandService).syncExecuteCommand(r.UpdateDocDrawingWrappingStyleCommand.id,{unitId:this.getUnitId(),subUnitId:this.getUnitId(),drawings:[n],wrappingStyle:e}):!1}setForward(){return this._arrange(t.ArrangeTypeEnum.forward)}setBackward(){return this._arrange(t.ArrangeTypeEnum.backward)}setBack(){return this._arrange(t.ArrangeTypeEnum.back)}setFront(){return this._arrange(t.ArrangeTypeEnum.front)}remove(){let e=this.getImageData(),n=this._getTextRange();return!e||!n?!1:this._injector.get(t.ICommandService).syncExecuteCommand(r.RemoveDocDrawingCommand.id,{unitId:this.getUnitId(),drawings:[{unitId:this.getUnitId(),subUnitId:this.getUnitId(),drawingId:this._imageId,drawingType:t.DrawingTypeEnum.DRAWING_IMAGE}],textRange:n})}_updateTransform(e,n){return this._injector.get(t.ICommandService).syncExecuteCommand(r.UpdateDrawingDocTransformCommand.id,{unitId:this.getUnitId(),subUnitId:this.getUnitId(),drawings:[{drawingId:this._imageId,key:e,value:n}]})}_arrange(e){return this._injector.get(t.ICommandService).syncExecuteCommand(r.SetDocDrawingArrangeCommand.id,{unitId:this.getUnitId(),subUnitId:this.getUnitId(),drawingIds:[this._imageId],arrangeType:e})}_getTextRange(){let{body:e,headers:t={},footers:n={}}=this._document.getDocumentDataModel().getSnapshot(),r=[{segmentId:``,body:e},...Object.entries(t).map(([e,t])=>({segmentId:e,body:t.body})),...Object.entries(n).map(([e,t])=>({segmentId:e,body:t.body}))];for(let{segmentId:e,body:t}of r){var i;let n=t==null||(i=t.customBlocks)==null?void 0:i.find(e=>e.blockId===this._imageId);if(n)return{startOffset:n.startIndex,endOffset:n.startIndex,collapsed:!0,segmentId:e}}return null}},c=class extends i.FDocument{async insertImage(e){var i,a,o,c;let u=this.getId(),d=(0,t.generateRandomId)(6),f=l(await this._getIntrinsicSize(e.source,e.imageSourceType),e),p=(0,n.buildDocTransform)(f.width,f.height),m=(i=e.wrappingStyle)==null?r.TextWrappingStyle.INLINE:i,h={...p,angle:(a=e.angle)==null?p.angle:a,positionH:(o=e.positionH)==null?p.positionH:o,positionV:(c=e.positionV)==null?p.positionV:c},g=(0,n.docDrawingPositionToTransform)(h),_={unitId:u,subUnitId:u,drawingId:d,drawingType:t.DrawingTypeEnum.DRAWING_IMAGE,imageSourceType:e.imageSourceType,source:e.source,transform:g,docTransform:h,behindDoc:m===r.TextWrappingStyle.BEHIND_TEXT?t.BooleanNumber.TRUE:t.BooleanNumber.FALSE,title:``,description:``,layoutType:r.WRAPPING_STYLE_TO_LAYOUT_TYPE[m],wrapText:t.WrapTextType.BOTH_SIDES,distB:0,distL:0,distR:0,distT:0};return this._injector.get(t.ICommandService).syncExecuteCommand(r.InsertDocDrawingCommand.id,{unitId:u,drawings:[_],textRange:e.textRange})?this._injector.createInstance(s,this,d,this._injector):null}getImage(e){var n;let r=(n=this.getDocumentDataModel().getDrawings())==null?void 0:n[e];return!r||r.drawingType!==t.DrawingTypeEnum.DRAWING_IMAGE?null:this._injector.createInstance(s,this,e,this._injector)}getImages(){var e,n;let r=this.getDocumentDataModel(),i=(e=r.getDrawings())==null?{}:e;return((n=r.getDrawingsOrder())==null?Object.keys(i):n).filter(e=>{var n;return((n=i[e])==null?void 0:n.drawingType)===t.DrawingTypeEnum.DRAWING_IMAGE}).map(e=>this._injector.createInstance(s,this,e,this._injector))}async _getIntrinsicSize(e,n){let r=this._injector.has(t.IImageIoService)?this._injector.get(t.IImageIoService):null,i=e;if(n===t.ImageSourceType.UUID&&r)i=await r.getImage(e);else if(n===t.ImageSourceType.URL&&this._injector.has(t.IURLImageService))try{i=await this._injector.get(t.IURLImageService).getImage(e)}catch{i=e}let{width:o,height:s,image:c}=await(0,a.getImageSize)(i);return r==null||r.addImageSourceCache(e,n,c),{width:o,height:s}}};function l(e,t){let{width:n,height:r}=e;if(t.width!=null&&t.height!=null)return{width:t.width,height:t.height};if(t.width!=null)return{width:t.width,height:r*t.width/n};if(t.height!=null)return{width:n*t.height/r,height:t.height};let i=Math.min(1,a.DRAWING_IMAGE_WIDTH_LIMIT/n,a.DRAWING_IMAGE_HEIGHT_LIMIT/r);return{width:n*i,height:r*i}}i.FDocument.extend(c);var u=class extends o.FEnum{get DocsImageWrappingStyle(){return r.TextWrappingStyle}get DocsImageRelativeFromH(){return t.ObjectRelativeFromH}get DocsImageRelativeFromV(){return t.ObjectRelativeFromV}};o.FEnum.extend(u),e.FDocumentImage=s});
+(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("@univerjs/core"),require("@univerjs/docs"),require("@univerjs/docs-drawing"),require("@univerjs/docs/facade"),require("@univerjs/drawing"),require("@univerjs/core/facade")):typeof define==`function`&&define.amd?define([`exports`,`@univerjs/core`,`@univerjs/docs`,`@univerjs/docs-drawing`,`@univerjs/docs/facade`,`@univerjs/drawing`,`@univerjs/core/facade`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.UniverDocsDrawingFacade={},e.UniverCore,e.UniverDocs,e.UniverDocsDrawing,e.UniverDocsFacade,e.UniverDrawing,e.UniverCoreFacade))})(this,function(e,t,n,r,i,a,o){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var s=class{constructor(e,t,n){this._document=e,this._imageId=t,this._injector=n}getUnitId(){return this._document.getId()}getId(){return this._imageId}getSource(){var e;return(e=this.getImageData())==null?void 0:e.source}getSourceType(){var e;return(e=this.getImageData())==null?void 0:e.imageSourceType}getSize(){var e;return((e=this.getImageData())==null?void 0:e.docTransform.size)??null}getAngle(){var e;return(e=this.getImageData())==null?void 0:e.docTransform.angle}getPositionH(){var e;return((e=this.getImageData())==null?void 0:e.docTransform.positionH)??null}getPositionV(){var e;return((e=this.getImageData())==null?void 0:e.docTransform.positionV)??null}getImageData(){var e;let n=(e=this._document.getDocumentDataModel().getDrawings())==null?void 0:e[this._imageId];return!n||n.drawingType!==t.DrawingTypeEnum.DRAWING_IMAGE?null:n}setSize(e,t){return this._updateTransform(`size`,{width:e,height:t})}setRotate(e){return this._updateTransform(`angle`,e)}setPositionH(e){return this._updateTransform(`positionH`,e)}setPositionV(e){return this._updateTransform(`positionV`,e)}setWrappingStyle(e){let n=this.getImageData();return n?this._injector.get(t.ICommandService).syncExecuteCommand(r.UpdateDocDrawingWrappingStyleCommand.id,{unitId:this.getUnitId(),subUnitId:this.getUnitId(),drawings:[n],wrappingStyle:e}):!1}setForward(){return this._arrange(t.ArrangeTypeEnum.forward)}setBackward(){return this._arrange(t.ArrangeTypeEnum.backward)}setBack(){return this._arrange(t.ArrangeTypeEnum.back)}setFront(){return this._arrange(t.ArrangeTypeEnum.front)}remove(){let e=this.getImageData(),n=this._getTextRange();return!e||!n?!1:this._injector.get(t.ICommandService).syncExecuteCommand(r.RemoveDocDrawingCommand.id,{unitId:this.getUnitId(),drawings:[{unitId:this.getUnitId(),subUnitId:this.getUnitId(),drawingId:this._imageId,drawingType:t.DrawingTypeEnum.DRAWING_IMAGE}],textRange:n})}_updateTransform(e,n){return this._injector.get(t.ICommandService).syncExecuteCommand(r.UpdateDrawingDocTransformCommand.id,{unitId:this.getUnitId(),subUnitId:this.getUnitId(),drawings:[{drawingId:this._imageId,key:e,value:n}]})}_arrange(e){return this._injector.get(t.ICommandService).syncExecuteCommand(r.SetDocDrawingArrangeCommand.id,{unitId:this.getUnitId(),subUnitId:this.getUnitId(),drawingIds:[this._imageId],arrangeType:e})}_getTextRange(){let{body:e,headers:t={},footers:n={}}=this._document.getDocumentDataModel().getSnapshot(),r=[{segmentId:``,body:e},...Object.entries(t).map(([e,t])=>({segmentId:e,body:t.body})),...Object.entries(n).map(([e,t])=>({segmentId:e,body:t.body}))];for(let{segmentId:e,body:t}of r){var i;let n=t==null||(i=t.customBlocks)==null?void 0:i.find(e=>e.blockId===this._imageId);if(n)return{startOffset:n.startIndex,endOffset:n.startIndex,collapsed:!0,segmentId:e}}return null}},c=class extends i.FDocument{async insertImage(e){let i=this.getId(),a=(0,t.generateRandomId)(6),o=e.width!=null&&e.height!=null?{width:e.width,height:e.height}:l(await this._getIntrinsicSize(e.source,e.imageSourceType),e),c=(0,n.buildDocTransform)(o.width,o.height),u=e.wrappingStyle??r.TextWrappingStyle.INLINE,d={...c,angle:e.angle??c.angle,positionH:e.positionH??c.positionH,positionV:e.positionV??c.positionV},f=(0,n.docDrawingPositionToTransform)(d),p={unitId:i,subUnitId:i,drawingId:a,drawingType:t.DrawingTypeEnum.DRAWING_IMAGE,imageSourceType:e.imageSourceType,source:e.source,transform:f,docTransform:d,behindDoc:u===r.TextWrappingStyle.BEHIND_TEXT?t.BooleanNumber.TRUE:t.BooleanNumber.FALSE,title:``,description:``,layoutType:r.WRAPPING_STYLE_TO_LAYOUT_TYPE[u],wrapText:t.WrapTextType.BOTH_SIDES,distB:0,distL:0,distR:0,distT:0};return this._injector.get(t.ICommandService).syncExecuteCommand(r.InsertDocDrawingCommand.id,{unitId:i,drawings:[p],textRange:e.textRange})?this._injector.createInstance(s,this,a,this._injector):null}getImage(e){var n;let r=(n=this.getDocumentDataModel().getDrawings())==null?void 0:n[e];return!r||r.drawingType!==t.DrawingTypeEnum.DRAWING_IMAGE?null:this._injector.createInstance(s,this,e,this._injector)}getImages(){let e=this.getDocumentDataModel(),n=e.getDrawings()??{};return(e.getDrawingsOrder()??Object.keys(n)).filter(e=>{var r;return((r=n[e])==null?void 0:r.drawingType)===t.DrawingTypeEnum.DRAWING_IMAGE}).map(e=>this._injector.createInstance(s,this,e,this._injector))}async _getIntrinsicSize(e,n){let r=this._injector.has(t.IImageIoService)?this._injector.get(t.IImageIoService):null,i=e;if(n===t.ImageSourceType.UUID&&r)i=await r.getImage(e);else if(n===t.ImageSourceType.URL&&this._injector.has(t.IURLImageService))try{i=await this._injector.get(t.IURLImageService).getImage(e)}catch{i=e}let{width:o,height:s,image:c}=await(0,a.getImageSize)(i);return r==null||r.addImageSourceCache(e,n,c),{width:o,height:s}}};function l(e,t){let{width:n,height:r}=e;if(t.width!=null&&t.height!=null)return{width:t.width,height:t.height};if(t.width!=null)return{width:t.width,height:r*t.width/n};if(t.height!=null)return{width:n*t.height/r,height:t.height};let i=Math.min(1,a.DRAWING_IMAGE_WIDTH_LIMIT/n,a.DRAWING_IMAGE_HEIGHT_LIMIT/r);return{width:n*i,height:r*i}}i.FDocument.extend(c);var u=class extends o.FEnum{get TextWrappingStyle(){return r.TextWrappingStyle}get DocsImageRelativeFromH(){return t.ObjectRelativeFromH}get DocsImageRelativeFromV(){return t.ObjectRelativeFromV}};o.FEnum.extend(u),e.FDocumentImage=s});