@univerjs/sheets-drawing-ui 1.0.3 → 1.1.0

package/lib/cjs/index.js

@@ -428,7 +428,7 @@ function readUint32Be(bytes, offset) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/typeof.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/typeof.js
 function _typeof(o) {
 	"@babel/helpers - typeof";
 	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
@@ -439,7 +439,7 @@ function _typeof(o) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/toPrimitive.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/toPrimitive.js
 function toPrimitive(t, r) {
 	if ("object" != _typeof(t) || !t) return t;
 	var e = t[Symbol.toPrimitive];
@@ -452,14 +452,14 @@ function toPrimitive(t, r) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/toPropertyKey.js
+//#region \0@oxc-project+runtime@0.153.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.149.0/helpers/esm/defineProperty.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/defineProperty.js
 function _defineProperty(e, r, t) {
 	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
 		value: t,
@@ -470,7 +470,7 @@ function _defineProperty(e, r, t) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorateParam.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);
@@ -478,7 +478,7 @@ function __decorateParam(paramIndex, decorator) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.153.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);
@@ -3071,7 +3071,12 @@ let SheetCanvasFloatDomManagerService = _SheetCanvasFloatDomManagerService = cla
 				domAnchor,
 				unitId,
 				subUnitId,
-				id: drawingId
+				id: drawingId,
+				runtimeMetadata: {
+					componentKey,
+					data,
+					allowTransform
+				}
 			};
 			const initedPosition = calcSheetFloatDomPosition(domRect, renderObject.renderUnit.scene, skeletonParam.skeleton, target.worksheet, floatDomInfo);
 			const position$ = new rxjs.BehaviorSubject(initedPosition);
@@ -3275,7 +3280,12 @@ let SheetCanvasFloatDomManagerService = _SheetCanvasFloatDomManagerService = cla
 					right: viewMain.right
 				},
 				domAnchor: domLayoutParam,
-				scrollDirectionResponse: "HORIZONTAL"
+				scrollDirectionResponse: "HORIZONTAL",
+				runtimeMetadata: {
+					componentKey,
+					data,
+					allowTransform
+				}
 			};
 			const initedPosition = calcSheetFloatDomPosition(domRect, renderObject.renderUnit.scene, skeleton.skeleton, target.worksheet, floatDomInfo);
 			const position$ = new rxjs.BehaviorSubject(initedPosition);
@@ -3718,7 +3728,7 @@ const menuSchema = {
 //#endregion
 //#region package.json
 var name = "@univerjs/sheets-drawing-ui";
-var version = "1.0.3";
+var version = "1.1.0";
 
 //#endregion
 //#region src/config/config.ts
@@ -3949,9 +3959,19 @@ function MobileBatchSaveImagesDialog() {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BatchSaveImagesDialog, { SelectComponent: _univerjs_design.MobileSelect });
 }
 
+//#endregion
+//#region src/views/sheet-image-panel/sheet-drawing-panel.util.ts
+function isSheetDrawing(drawing) {
+	return Boolean(drawing && "sheetTransform" in drawing && drawing.sheetTransform);
+}
+
 //#endregion
 //#region src/views/sheet-image-panel/SheetDrawingAnchor.tsx
 const SheetDrawingAnchor = (props) => {
+	function getAnchorKind(value) {
+		if (value === _univerjs_sheets_drawing.SheetDrawingAnchorType.Position || value === _univerjs_sheets_drawing.SheetDrawingAnchorType.Both || value === _univerjs_sheets_drawing.SheetDrawingAnchorType.None) return value;
+		return null;
+	}
 	const commandService = (0, _univerjs_ui.useDependency)(_univerjs_core.ICommandService);
 	const localeService = (0, _univerjs_ui.useDependency)(_univerjs_core.LocaleService);
 	const drawingManagerService = (0, _univerjs_ui.useDependency)(_univerjs_drawing.IDrawingManagerService);
@@ -4067,12 +4087,389 @@ const SheetDrawingAnchor = (props) => {
 		}) })]
 	});
 };
-function isSheetDrawing(drawing) {
-	return Boolean(drawing && "sheetTransform" in drawing && "axisAlignSheetTransform" in drawing);
+
+//#endregion
+//#region src/commands/operations/preview-sheet-image-opacity.operation.ts
+const PreviewSheetImageOpacityOperation = {
+	id: "sheet.operation.preview-image-opacity",
+	type: _univerjs_core.CommandType.OPERATION,
+	handler: (accessor, params) => {
+		var _renderManagerService;
+		if (!params || !Number.isFinite(params.opacity)) return false;
+		const scene = (_renderManagerService = accessor.get(_univerjs_engine_render.IRenderManagerService).getRenderUnitById(params.unitId)) === null || _renderManagerService === void 0 ? void 0 : _renderManagerService.scene;
+		const image = scene === null || scene === void 0 ? void 0 : scene.getObject((0, _univerjs_drawing.getDrawingShapeKeyByDrawingSearch)(params));
+		if (!(image instanceof _univerjs_engine_render.Image)) return false;
+		image.setOpacity(Math.min(Math.max(params.opacity, 0), 1));
+		return true;
+	}
+};
+
+//#endregion
+//#region src/views/sheet-image-panel/SheetImageTransparencySlider.tsx
+const MIN_TRANSPARENCY = 0;
+const MAX_TRANSPARENCY = 100;
+const TRANSPARENCY_STEP = 1;
+const TRANSPARENCY_PAGE_STEP = 10;
+const DRAG_PREVIEW_INTERVAL = 50;
+function SheetImageTransparencySlider(props) {
+	const { value, shortcuts, ariaLabel, disabled = false, onChange, onChangeComplete } = props;
+	const localeService = (0, _univerjs_ui.useDependency)(_univerjs_core.LocaleService);
+	const isRtl = (0, _univerjs_ui.useObservable)(localeService.direction$, localeService.getDirection()) === "rtl";
+	const sliderRailRef = (0, react.useRef)(null);
+	const dragValueRef = (0, react.useRef)(value);
+	const pendingDragValueRef = (0, react.useRef)(null);
+	const lastPreviewedDragValueRef = (0, react.useRef)(value);
+	const dragPreviewTimerRef = (0, react.useRef)(null);
+	const dragCleanupRef = (0, react.useRef)(null);
+	const [isDragging, setIsDragging] = (0, react.useState)(false);
+	const [dragValue, setDragValue] = (0, react.useState)(value);
+	(0, react.useEffect)(() => () => {
+		var _dragCleanupRef$curre;
+		(_dragCleanupRef$curre = dragCleanupRef.current) === null || _dragCleanupRef$curre === void 0 || _dragCleanupRef$curre.call(dragCleanupRef);
+		clearDragPreviewTimer();
+	}, []);
+	function getValueByClientX(clientX) {
+		const rail = sliderRailRef.current;
+		if (!rail) return value;
+		const railRect = rail.getBoundingClientRect();
+		if (railRect.width <= 0) return value;
+		let ratio = (clientX - railRect.left) / railRect.width;
+		ratio = Math.min(Math.max(ratio, 0), 1);
+		if (isRtl) ratio = 1 - ratio;
+		return normalizeTransparency$1(MIN_TRANSPARENCY + ratio * 100);
+	}
+	function clearDragPreviewTimer() {
+		if (dragPreviewTimerRef.current != null) {
+			window.clearTimeout(dragPreviewTimerRef.current);
+			dragPreviewTimerRef.current = null;
+		}
+	}
+	function previewDragValue(nextValue) {
+		if (nextValue === lastPreviewedDragValueRef.current) return;
+		lastPreviewedDragValueRef.current = nextValue;
+		onChange === null || onChange === void 0 || onChange(nextValue);
+	}
+	function flushDragPreview() {
+		clearDragPreviewTimer();
+		const nextValue = pendingDragValueRef.current;
+		pendingDragValueRef.current = null;
+		if (nextValue != null) previewDragValue(nextValue);
+	}
+	function scheduleDragPreview(nextValue) {
+		pendingDragValueRef.current = nextValue;
+		if (dragPreviewTimerRef.current != null) return;
+		dragPreviewTimerRef.current = window.setTimeout(() => {
+			dragPreviewTimerRef.current = null;
+			const pendingValue = pendingDragValueRef.current;
+			pendingDragValueRef.current = null;
+			if (pendingValue != null) previewDragValue(pendingValue);
+		}, DRAG_PREVIEW_INTERVAL);
+	}
+	function updateDragValue(clientX) {
+		const nextValue = getValueByClientX(clientX);
+		dragValueRef.current = nextValue;
+		setDragValue(nextValue);
+		return nextValue;
+	}
+	function handlePointerDown(e) {
+		var _dragCleanupRef$curre2;
+		if (disabled) return;
+		e.preventDefault();
+		e.stopPropagation();
+		(_dragCleanupRef$curre2 = dragCleanupRef.current) === null || _dragCleanupRef$curre2 === void 0 || _dragCleanupRef$curre2.call(dragCleanupRef);
+		clearDragPreviewTimer();
+		pendingDragValueRef.current = null;
+		lastPreviewedDragValueRef.current = value;
+		setIsDragging(true);
+		scheduleDragPreview(updateDragValue(e.clientX));
+		function cleanup() {
+			window.removeEventListener("pointermove", handlePointerMove);
+			window.removeEventListener("pointerup", handlePointerUp);
+			window.removeEventListener("pointercancel", handlePointerUp);
+			dragCleanupRef.current = null;
+		}
+		function handlePointerMove(event) {
+			scheduleDragPreview(updateDragValue(event.clientX));
+		}
+		function handlePointerUp() {
+			cleanup();
+			flushDragPreview();
+			setIsDragging(false);
+			onChangeComplete === null || onChangeComplete === void 0 || onChangeComplete(dragValueRef.current);
+		}
+		dragCleanupRef.current = cleanup;
+		window.addEventListener("pointermove", handlePointerMove);
+		window.addEventListener("pointerup", handlePointerUp);
+		window.addEventListener("pointercancel", handlePointerUp);
+	}
+	function handleSliderKeyDown(e) {
+		let nextValue = null;
+		if (e.key === "ArrowLeft" || e.key === "ArrowDown") nextValue = value - TRANSPARENCY_STEP;
+		else if (e.key === "ArrowRight" || e.key === "ArrowUp") nextValue = value + TRANSPARENCY_STEP;
+		else if (e.key === "PageDown") nextValue = value - TRANSPARENCY_PAGE_STEP;
+		else if (e.key === "PageUp") nextValue = value + TRANSPARENCY_PAGE_STEP;
+		else if (e.key === "Home") nextValue = MIN_TRANSPARENCY;
+		else if (e.key === "End") nextValue = MAX_TRANSPARENCY;
+		if (nextValue == null || disabled) return;
+		e.preventDefault();
+		e.stopPropagation();
+		const normalizedValue = normalizeTransparency$1(nextValue);
+		onChange === null || onChange === void 0 || onChange(normalizedValue);
+		onChangeComplete === null || onChangeComplete === void 0 || onChangeComplete(normalizedValue);
+	}
+	const visualValue = isDragging ? dragValue : value;
+	const sliderOffset = normalizeTransparency$1(visualValue);
+	const handleOffset = isRtl ? MAX_TRANSPARENCY - sliderOffset : sliderOffset;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: (0, _univerjs_design.clsx)("univer-flex univer-select-none univer-items-center univer-gap-1.5", { "univer-cursor-not-allowed": disabled }),
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			className: "univer-flex univer-h-6 univer-min-w-0 univer-flex-1 univer-items-center",
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: (0, _univerjs_design.clsx)("univer-relative univer-h-1.5 univer-w-full univer-rounded-full univer-bg-gray-200 univer-px-1.5 univer-transition-colors dark:!univer-bg-gray-600", { "univer-opacity-60": disabled }),
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					ref: sliderRailRef,
+					"data-u-comp": "sheet-image-transparency-slider-track",
+					className: "univer-relative univer-h-1.5 univer-bg-gray-200 dark:!univer-bg-gray-600",
+					onPointerDown: handlePointerDown,
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: (0, _univerjs_design.clsx)("univer-bg-primary-500/60 univer-absolute univer-top-0 univer-h-full univer-rounded-full", isRtl ? "univer-right-0" : "univer-left-0"),
+						style: { width: `${sliderOffset}%` }
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						className: (0, _univerjs_design.clsx)("univer-absolute univer-top-1/2 univer-size-3.5 -univer-translate-x-1/2 -univer-translate-y-1/2 univer-rounded-full univer-bg-gray-0 univer-shadow-sm focus-visible:univer-outline-none focus-visible:univer-ring-2 focus-visible:univer-ring-primary-100 dark:!univer-bg-gray-800", _univerjs_design.borderClassName, {
+							"univer-cursor-pointer hover:univer-border-primary-600 hover:univer-shadow-md": !disabled,
+							"univer-cursor-not-allowed": disabled,
+							"univer-scale-105 univer-border-primary-600 univer-shadow-md": isDragging,
+							"univer-transition-all": !isDragging,
+							"univer-transition-none": isDragging
+						}),
+						role: "slider",
+						"aria-label": ariaLabel,
+						"aria-valuemin": MIN_TRANSPARENCY,
+						"aria-valuemax": MAX_TRANSPARENCY,
+						"aria-valuenow": visualValue,
+						"aria-valuetext": `${visualValue}%`,
+						disabled,
+						type: "button",
+						style: { left: `${handleOffset}%` },
+						onKeyDown: handleSliderKeyDown
+					})]
+				})
+			})
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SheetImageTransparencyInput, {
+			value,
+			shortcuts,
+			ariaLabel,
+			disabled,
+			onChange,
+			onChangeComplete
+		})]
+	});
+}
+function SheetImageTransparencyInput(props) {
+	const { value, shortcuts, ariaLabel, disabled = false, onChange, onChangeComplete } = props;
+	const iconManager = (0, _univerjs_ui.useDependency)(_univerjs_ui.IconManager);
+	const isEditingRef = (0, react.useRef)(false);
+	const [listVisible, setListVisible] = (0, react.useState)(false);
+	const [inputValue, setInputValue] = (0, react.useState)(() => `${value}%`);
+	(0, react.useEffect)(() => {
+		if (!isEditingRef.current) setInputValue(`${value}%`);
+	}, [value]);
+	function emitValue(nextValue) {
+		const normalizedValue = normalizeTransparency$1(nextValue);
+		onChange === null || onChange === void 0 || onChange(normalizedValue);
+		onChangeComplete === null || onChangeComplete === void 0 || onChangeComplete(normalizedValue);
+	}
+	function handleSelect(nextValue) {
+		if (disabled) return;
+		setListVisible(false);
+		emitValue(nextValue);
+	}
+	function handleFocus() {
+		if (disabled) return;
+		isEditingRef.current = true;
+		setInputValue(String(value));
+	}
+	function commitInput() {
+		if (disabled || !isEditingRef.current) return;
+		const parsedValue = parseTransparency(inputValue);
+		isEditingRef.current = false;
+		if (parsedValue == null) {
+			setInputValue(`${value}%`);
+			return;
+		}
+		if (parsedValue === value) {
+			setInputValue(`${parsedValue}%`);
+			return;
+		}
+		emitValue(parsedValue);
+	}
+	function handleKeyDown(e) {
+		e.stopPropagation();
+		if (e.key === "Enter") {
+			e.preventDefault();
+			commitInput();
+			e.currentTarget.blur();
+		}
+	}
+	const items = [{
+		type: "radio",
+		value: value.toString(),
+		options: shortcuts.map((shortcut) => ({
+			value: shortcut.toString(),
+			label: `${shortcut}%`
+		})),
+		onSelect: (selectedValue) => handleSelect(Number(selectedValue))
+	}];
+	const MoreDownIcon = iconManager.get("MoreDownIcon");
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: (0, _univerjs_design.clsx)("univer-flex univer-h-6 univer-w-[68px] univer-flex-shrink-0 univer-items-center univer-overflow-hidden univer-rounded-md univer-border univer-border-gray-200 univer-bg-gray-0 dark:!univer-border-gray-600 dark:!univer-bg-gray-800", { "univer-opacity-60": disabled }),
+		onClick: (e) => e.stopPropagation(),
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_univerjs_design.Input, {
+			className: "univer-box-border univer-h-6 univer-min-w-0 univer-flex-1 univer-border-none univer-bg-transparent [&_input:focus]:!univer-ring-0 [&_input]:univer-h-6 [&_input]:univer-w-full [&_input]:univer-border-none [&_input]:!univer-bg-transparent [&_input]:univer-px-1 [&_input]:univer-text-center [&_input]:univer-text-xs [&_input]:univer-tabular-nums",
+			inputClass: "univer-w-full",
+			size: "mini",
+			"aria-label": ariaLabel,
+			value: inputValue,
+			disabled,
+			type: "text",
+			onChange: setInputValue,
+			onFocus: handleFocus,
+			onBlur: commitInput,
+			onKeyDown: handleKeyDown
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_univerjs_design.DropdownMenu, {
+			align: "end",
+			items,
+			open: listVisible,
+			disabled,
+			onOpenChange: setListVisible,
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_univerjs_design.Button, {
+				className: "univer-h-6 univer-w-4 univer-rounded-none univer-p-0",
+				size: "small",
+				variant: "text",
+				"aria-label": ariaLabel,
+				disabled,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MoreDownIcon, { className: "univer-size-3 univer-text-gray-500 dark:!univer-text-gray-300" })
+			})
+		})]
+	});
 }
-function getAnchorKind(value) {
-	if (value === _univerjs_sheets_drawing.SheetDrawingAnchorType.Position || value === _univerjs_sheets_drawing.SheetDrawingAnchorType.Both || value === _univerjs_sheets_drawing.SheetDrawingAnchorType.None) return value;
-	return null;
+function parseTransparency(rawValue) {
+	const normalizedValue = rawValue.trim().replace(/%$/, "").trim();
+	if (normalizedValue === "") return null;
+	const parsedValue = Number(normalizedValue);
+	return Number.isFinite(parsedValue) ? normalizeTransparency$1(parsedValue) : null;
+}
+function normalizeTransparency$1(value) {
+	return Math.min(Math.max(Math.round(value), MIN_TRANSPARENCY), MAX_TRANSPARENCY);
+}
+
+//#endregion
+//#region src/views/sheet-image-panel/SheetImageTransparency.tsx
+const IMAGE_TRANSPARENCY_PRESETS = [
+	0,
+	15,
+	30,
+	50,
+	65,
+	80
+];
+const SheetImageTransparency = ({ drawings }) => {
+	const commandService = (0, _univerjs_ui.useDependency)(_univerjs_core.ICommandService);
+	const localeService = (0, _univerjs_ui.useDependency)(_univerjs_core.LocaleService);
+	const sheetDrawingService = (0, _univerjs_ui.useDependency)(_univerjs_sheets_drawing.ISheetDrawingService);
+	const drawingParam = isSheetDrawing(drawings[0]) ? drawings[0] : void 0;
+	const currentDrawing = drawingParam ? sheetDrawingService.getDrawingByParam(drawingParam) ?? drawingParam : void 0;
+	const image = (currentDrawing === null || currentDrawing === void 0 ? void 0 : currentDrawing.drawingType) === _univerjs_core.DrawingTypeEnum.DRAWING_IMAGE ? currentDrawing : void 0;
+	const modelOpacity = (0, _univerjs_drawing.normalizeImageOpacity)(image === null || image === void 0 ? void 0 : image.opacity);
+	const modelTransparency = Math.round((1 - modelOpacity) * 100);
+	const [previewState, setPreviewState] = (0, react.useState)(null);
+	const previewPendingRef = (0, react.useRef)(false);
+	const [, setModelRevision] = (0, react.useState)(0);
+	const transparency = image && (previewState === null || previewState === void 0 ? void 0 : previewState.unitId) === image.unitId && previewState.subUnitId === image.subUnitId && previewState.drawingId === image.drawingId ? previewState.transparency : modelTransparency;
+	(0, react.useEffect)(() => {
+		if (!drawingParam) return;
+		const subscription = sheetDrawingService.update$.subscribe((updatedDrawings) => {
+			if (updatedDrawings.some((updatedDrawing) => updatedDrawing.unitId === drawingParam.unitId && updatedDrawing.subUnitId === drawingParam.subUnitId && updatedDrawing.drawingId === drawingParam.drawingId)) setModelRevision((revision) => revision + 1);
+		});
+		return () => subscription.unsubscribe();
+	}, [drawingParam, sheetDrawingService]);
+	(0, react.useEffect)(() => {
+		previewPendingRef.current = false;
+		return () => {
+			if (!previewPendingRef.current || !image) return;
+			commandService.syncExecuteCommand(PreviewSheetImageOpacityOperation.id, {
+				unitId: image.unitId,
+				subUnitId: image.subUnitId,
+				drawingId: image.drawingId,
+				opacity: modelOpacity
+			});
+		};
+	}, [
+		commandService,
+		image,
+		modelOpacity,
+		modelTransparency
+	]);
+	if (!image) return null;
+	const title = localeService.t("sheets-drawing-ui.image-transparency.title");
+	const { unitId, subUnitId, drawingId } = image;
+	function previewTransparency(nextTransparency) {
+		const normalizedTransparency = normalizeTransparency(nextTransparency);
+		const opacity = transparencyToOpacity(normalizedTransparency);
+		previewPendingRef.current = true;
+		setPreviewState({
+			unitId,
+			subUnitId,
+			drawingId,
+			transparency: normalizedTransparency
+		});
+		commandService.syncExecuteCommand(PreviewSheetImageOpacityOperation.id, {
+			unitId,
+			subUnitId,
+			drawingId,
+			opacity
+		});
+	}
+	function commitTransparency(nextTransparency) {
+		const opacity = transparencyToOpacity(normalizeTransparency(nextTransparency));
+		previewPendingRef.current = false;
+		setPreviewState(null);
+		if (opacity === modelOpacity) return;
+		if (!commandService.syncExecuteCommand(_univerjs_sheets_drawing.SetSheetDrawingCommand.id, {
+			unitId,
+			drawings: [{
+				unitId,
+				subUnitId,
+				drawingId,
+				opacity
+			}]
+		})) commandService.syncExecuteCommand(PreviewSheetImageOpacityOperation.id, {
+			unitId,
+			subUnitId,
+			drawingId,
+			opacity: modelOpacity
+		});
+	}
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+		className: "univer-grid univer-gap-2 univer-py-2 univer-text-gray-400",
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("header", {
+			className: "univer-text-gray-600 dark:!univer-text-gray-200",
+			children: title
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SheetImageTransparencySlider, {
+			value: transparency,
+			shortcuts: IMAGE_TRANSPARENCY_PRESETS,
+			ariaLabel: title,
+			onChange: previewTransparency,
+			onChangeComplete: commitTransparency
+		})]
+	});
+};
+function normalizeTransparency(transparency) {
+	if (!Number.isFinite(transparency)) return 0;
+	return Math.min(Math.max(Math.round(transparency), 0), 100);
+}
+function transparencyToOpacity(transparency) {
+	return (100 - transparency) / 100;
 }
 
 //#endregion
@@ -4097,7 +4494,11 @@ const SheetDrawingPanel = () => {
 	const drawings = (0, _univerjs_ui.useObservable)(() => drawingManagerService.focus$, drawingManagerService.getFocusDrawings(), false, [drawingManagerService]);
 	return !!(drawings === null || drawings === void 0 ? void 0 : drawings.length) && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "univer-text-sm",
-		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_univerjs_drawing_ui.DrawingCommonPanel, { drawings }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SheetDrawingAnchor, { drawings })]
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_univerjs_drawing_ui.DrawingCommonPanel, { drawings }),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SheetImageTransparency, { drawings }),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SheetDrawingAnchor, { drawings })
+		]
 	});
 };
 
@@ -4508,80 +4909,121 @@ SheetCellImageCopyPasteController = __decorate([
 //#endregion
 //#region src/controllers/sheet-drawing-active-render.controller.ts
 let SheetDrawingActiveRenderController = class SheetDrawingActiveRenderController extends _univerjs_core.Disposable {
-	constructor(_context, _commandService, _sheetSkeletonService, _sheetDrawingService, _drawingManagerService) {
+	constructor(_context, _commandService, _sheetSkeletonService, _sheetDrawingService, _drawingManagerService, _logService) {
 		super();
 		this._context = _context;
 		this._commandService = _commandService;
 		this._sheetSkeletonService = _sheetSkeletonService;
 		this._sheetDrawingService = _sheetDrawingService;
 		this._drawingManagerService = _drawingManagerService;
+		this._logService = _logService;
+		_defineProperty(this, "_renderTimeout", void 0);
 		this._commandListener();
 	}
+	dispose() {
+		this._cancelPendingRender();
+		super.dispose();
+	}
+	_cancelPendingRender() {
+		if (this._renderTimeout !== void 0) {
+			clearTimeout(this._renderTimeout);
+			this._renderTimeout = void 0;
+		}
+	}
+	_scheduleRender(callback) {
+		this._cancelPendingRender();
+		this._renderTimeout = setTimeout(() => {
+			this._renderTimeout = void 0;
+			callback();
+		}, 0);
+	}
 	_commandListener() {
+		this.disposeWithMe(this._commandService.beforeCommandExecuted((command) => {
+			if (command.id !== _univerjs_sheets.SetWorksheetActiveOperation.id) return;
+			const { unitId, subUnitId } = command.params;
+			const { unit, unitId: contextUnitId } = this._context;
+			if (unitId !== contextUnitId || !unit.getSheetBySheetId(subUnitId) || unit.getActiveSheet().getSheetId() === subUnitId) return;
+			this._clearDrawings(unitId, subUnitId);
+		}));
 		this.disposeWithMe(this._commandService.onCommandExecuted((command) => {
 			if (command.id === _univerjs_sheets.SetWorksheetActiveOperation.id) {
 				const { unitId, subUnitId } = command.params;
-				this._updateDrawings(unitId, subUnitId);
+				if (unitId === this._context.unitId && subUnitId === this._context.unit.getActiveSheet().getSheetId()) this._updateDrawings(unitId, subUnitId);
 			}
 		}));
 		this.disposeWithMe(this._context.activated$.subscribe((activated) => {
 			const { unit, unitId } = this._context;
-			if (activated) this._updateDrawings(unitId, unit.getActiveSheet().getSheetId());
-			else this._clearDrawings(unitId);
+			if (activated) {
+				const subUnitId = unit.getActiveSheet().getSheetId();
+				this._clearDrawings(unitId, subUnitId);
+				this._updateDrawings(unitId, subUnitId);
+			} else this._clearDrawings(unitId);
 		}));
 	}
-	_clearDrawings(selfUnitId) {
-		setTimeout(() => {
-			const drawingMap = this._drawingManagerService.drawingManagerData;
-			const removeDrawings = [];
-			Object.keys(drawingMap ?? {}).forEach((unitId) => {
-				const subUnitMap = drawingMap[unitId] ?? {};
-				Object.keys(subUnitMap).forEach((subUnitId) => {
-					var _subUnitMap$subUnitId;
-					const drawingData = ((_subUnitMap$subUnitId = subUnitMap[subUnitId]) === null || _subUnitMap$subUnitId === void 0 ? void 0 : _subUnitMap$subUnitId.data) ?? {};
-					Object.keys(drawingData).forEach((drawingId) => {
-						if (unitId === selfUnitId) removeDrawings.push(drawingData[drawingId]);
-					});
-				});
-			});
-			this._sheetDrawingService.removeNotification(removeDrawings);
-			this._drawingManagerService.removeNotification(removeDrawings);
-		});
+	_clearDrawings(unitId, keepSubUnitId) {
+		this._cancelPendingRender();
+		const subUnitMap = this._drawingManagerService.drawingManagerData[unitId] ?? {};
+		const removeDrawings = [];
+		for (const subUnitId of Object.keys(subUnitMap)) {
+			var _subUnitMap$subUnitId;
+			if (subUnitId === keepSubUnitId) continue;
+			for (const drawing of Object.values(((_subUnitMap$subUnitId = subUnitMap[subUnitId]) === null || _subUnitMap$subUnitId === void 0 ? void 0 : _subUnitMap$subUnitId.data) ?? {})) removeDrawings.push(drawing);
+		}
+		this._sheetDrawingService.removeNotification(removeDrawings);
+		this._drawingManagerService.removeNotification(removeDrawings);
 	}
 	_updateDrawings(showUnitId, showSubunitId) {
-		setTimeout(() => {
+		this._scheduleRender(() => {
+			var _subUnitMap$showSubun;
 			const sheetSkeletonParam = this._sheetSkeletonService.getSkeletonParam(showUnitId, showSubunitId);
-			const drawingMap = this._drawingManagerService.drawingManagerData;
-			const insertDrawings = [];
-			const removeDrawings = [];
-			Object.keys(drawingMap ?? {}).forEach((unitId) => {
-				if (unitId !== showUnitId) return;
-				const subUnitMap = drawingMap[unitId] ?? {};
-				Object.keys(subUnitMap).forEach((subUnitId) => {
-					var _subUnitMap$subUnitId2;
-					const drawingData = ((_subUnitMap$subUnitId2 = subUnitMap[subUnitId]) === null || _subUnitMap$subUnitId2 === void 0 ? void 0 : _subUnitMap$subUnitId2.data) ?? {};
-					Object.keys(drawingData).forEach((drawingId) => {
-						if (unitId === showUnitId && subUnitId === showSubunitId) {
-							const drawing = drawingData[drawingId];
-							if (drawing.sheetTransform && drawing.anchorType !== _univerjs_sheets_drawing.SheetDrawingAnchorType.None) drawing.transform = (0, _univerjs_sheets_drawing.drawingPositionToTransform)(drawing.sheetTransform, sheetSkeletonParam);
-							insertDrawings.push(drawingData[drawingId]);
-						} else removeDrawings.push(drawingData[drawingId]);
-					});
-				});
-			});
+			const drawingData = ((_subUnitMap$showSubun = (this._drawingManagerService.drawingManagerData[showUnitId] ?? {})[showSubunitId]) === null || _subUnitMap$showSubun === void 0 ? void 0 : _subUnitMap$showSubun.data) ?? {};
+			const { successDrawings, refreshedDrawings, failures } = prepareSheetDrawings(Object.values(drawingData), sheetSkeletonParam === null || sheetSkeletonParam === void 0 ? void 0 : sheetSkeletonParam.skeleton);
+			const removeDrawings = failures.map(({ drawingId }) => drawingData[drawingId]);
+			this._sheetDrawingService.refreshTransform(refreshedDrawings);
+			this._drawingManagerService.refreshTransform(refreshedDrawings);
 			this._sheetDrawingService.removeNotification(removeDrawings);
-			this._sheetDrawingService.addNotification(insertDrawings);
+			this._sheetDrawingService.addNotification(successDrawings);
 			this._drawingManagerService.removeNotification(removeDrawings);
-			this._drawingManagerService.addNotification(insertDrawings);
-		}, 0);
+			this._drawingManagerService.addNotification(successDrawings);
+			if (failures.length) this._logService.error("[SheetDrawingActiveRenderController]", {
+				unitId: showUnitId,
+				subUnitId: showSubunitId,
+				failures
+			});
+		});
 	}
 };
 SheetDrawingActiveRenderController = __decorate([
 	__decorateParam(1, _univerjs_core.ICommandService),
 	__decorateParam(2, (0, _univerjs_core.Inject)(_univerjs_sheets.SheetSkeletonService)),
 	__decorateParam(3, _univerjs_sheets_drawing.ISheetDrawingService),
-	__decorateParam(4, _univerjs_drawing.IDrawingManagerService)
+	__decorateParam(4, _univerjs_drawing.IDrawingManagerService),
+	__decorateParam(5, _univerjs_core.ILogService)
 ], SheetDrawingActiveRenderController);
+function prepareSheetDrawings(drawings, skeleton) {
+	const successDrawings = [];
+	const refreshedDrawings = [];
+	const failures = [];
+	for (const drawing of drawings) {
+		if (skeleton && drawing.sheetTransform && drawing.anchorType !== _univerjs_sheets_drawing.SheetDrawingAnchorType.None) try {
+			refreshedDrawings.push((0, _univerjs_sheets_drawing.applySheetDrawingPlacement)(drawing, (0, _univerjs_sheets_drawing.getSheetDrawingPlacement)(drawing), skeleton));
+		} catch (error) {
+			failures.push({
+				drawingId: drawing.drawingId,
+				drawingType: drawing.drawingType,
+				anchorType: drawing.anchorType ?? _univerjs_sheets_drawing.SheetDrawingAnchorType.Position,
+				error
+			});
+			continue;
+		}
+		successDrawings.push(drawing);
+	}
+	return {
+		successDrawings,
+		refreshedDrawings,
+		failures
+	};
+}
 
 //#endregion
 //#region src/controllers/sheet-drawing-copy-paste.controller.ts
@@ -5633,7 +6075,8 @@ let SheetDrawingUIController = class SheetDrawingUIController extends _univerjs_
 			MoveDrawingsCommand,
 			DeleteDrawingsCommand,
 			SaveCellImagesCommand,
-			FlipSheetDrawingCommand
+			FlipSheetDrawingCommand,
+			PreviewSheetImageOpacityOperation
 		].forEach((command) => this.disposeWithMe(this._commandService.registerCommand(command)));
 	}
 	_initShortcuts() {
@@ -6552,7 +6995,7 @@ UniverSheetsDrawingUIPlugin = __decorate([
 
 //#endregion
 exports.AddWorksheetBackgroundImageCommand = AddWorksheetBackgroundImageCommand;
-Object.defineProperty(exports, 'BatchSaveImagesService', {
+Object.defineProperty(exports, "BatchSaveImagesService", {
   enumerable: true,
   get: function () {
     return BatchSaveImagesService;
@@ -6573,26 +7016,26 @@ exports.SHEETS_IMAGE_MENU_ID = SHEETS_IMAGE_MENU_ID;
 exports.SHEET_CHART_RENDER_OBJECT_CONFIG = SHEET_CHART_RENDER_OBJECT_CONFIG;
 exports.SHEET_FLOAT_DOM_PREFIX = SHEET_FLOAT_DOM_PREFIX;
 exports.SaveCellImagesCommand = SaveCellImagesCommand;
-Object.defineProperty(exports, 'SheetCanvasFloatDomManagerService', {
+Object.defineProperty(exports, "SheetCanvasFloatDomManagerService", {
   enumerable: true,
   get: function () {
     return SheetCanvasFloatDomManagerService;
   }
 });
 exports.SheetDrawingAnchor = SheetDrawingAnchor;
-Object.defineProperty(exports, 'SheetDrawingHitTestService', {
+Object.defineProperty(exports, "SheetDrawingHitTestService", {
   enumerable: true,
   get: function () {
     return SheetDrawingHitTestService;
   }
 });
-Object.defineProperty(exports, 'SheetDrawingUpdateController', {
+Object.defineProperty(exports, "SheetDrawingUpdateController", {
   enumerable: true,
   get: function () {
     return SheetDrawingUpdateController;
   }
 });
-Object.defineProperty(exports, 'SheetsDrawingGroupCopyPasteController', {
+Object.defineProperty(exports, "SheetsDrawingGroupCopyPasteController", {
   enumerable: true,
   get: function () {
     return SheetsDrawingGroupCopyPasteController;
@@ -6601,13 +7044,13 @@ Object.defineProperty(exports, 'SheetsDrawingGroupCopyPasteController', {
 exports.SheetsDrawingUIMenuSchema = menuSchema;
 exports.SidebarSheetDrawingOperation = SidebarSheetDrawingOperation;
 exports.UngroupSheetDrawingCommand = UngroupSheetDrawingCommand;
-Object.defineProperty(exports, 'UniverSheetsDrawingMobileUIPlugin', {
+Object.defineProperty(exports, "UniverSheetsDrawingMobileUIPlugin", {
   enumerable: true,
   get: function () {
     return UniverSheetsDrawingMobileUIPlugin;
   }
 });
-Object.defineProperty(exports, 'UniverSheetsDrawingUIPlugin', {
+Object.defineProperty(exports, "UniverSheetsDrawingUIPlugin", {
   enumerable: true,
   get: function () {
     return UniverSheetsDrawingUIPlugin;