@univerjs/sheets-drawing-ui 1.0.3 → 1.0.4

package/lib/index.js

@@ -1,16 +1,16 @@
 import { BooleanNumber, BuildTextUtils, CommandType, DOCS_FORMULA_BAR_EDITOR_UNIT_ID_KEY, DOCS_NORMAL_EDITOR_UNIT_ID_KEY, DependentOn, Direction, Disposable, DisposableCollection, DrawingTypeEnum, FOCUSING_COMMON_DRAWINGS, FOCUSING_FX_BAR_EDITOR, FOCUSING_PANEL_EDITOR, FOCUSING_SHAPE_TEXT_EDITOR, FOCUSING_SHEET, ICommandService, IConfigService, IContextService, IImageIoService, IPermissionService, IURLImageService, IUndoRedoService, IUniverInstanceService, ImageCacheMap, ImageSourceType, ImageUploadStatusType, Inject, Injector, InterceptorEffectEnum, LifecycleService, LifecycleStages, LocaleService, ObjectMatrix, Optional, Plugin, PositionedObjectLayoutType, RxDisposable, Tools, UniverInstanceType, UserManagerService, WrapTextType, createDocumentModelWithStyle, createIdentifier, fromEventSubject, generateRandomId, merge, mergeOverrideWithDependencies, registerDependencies, sequenceExecute, toDisposable, touchDependencies } from "@univerjs/core";
-import { ClearSheetDrawingTransformerOperation, DrawingApplyType, ISheetDrawingService, InsertSheetDrawingCommand, RemoveSheetDrawingCommand, SetDrawingApplyMutation, SetDrawingArrangeCommand, SetSheetDrawingCommand, SetSheetDrawingPlacementCommand, SetWorksheetBackgroundImageCommand, SetWorksheetBackgroundImageMutation, SheetDrawingAnchorType, UniverSheetsDrawingPlugin, drawingPositionToTransform, getSheetDrawingPlacement, transformToAxisAlignPosition, transformToDrawingPosition } from "@univerjs/sheets-drawing";
+import { ClearSheetDrawingTransformerOperation, DrawingApplyType, ISheetDrawingService, InsertSheetDrawingCommand, RemoveSheetDrawingCommand, SetDrawingApplyMutation, SetDrawingArrangeCommand, SetSheetDrawingCommand, SetSheetDrawingPlacementCommand, SetWorksheetBackgroundImageCommand, SetWorksheetBackgroundImageMutation, SheetDrawingAnchorType, UniverSheetsDrawingPlugin, applySheetDrawingPlacement, drawingPositionToTransform, getSheetDrawingPlacement, transformToAxisAlignPosition, transformToDrawingPosition } from "@univerjs/sheets-drawing";
 import { CURSOR_TYPE, DEFAULT_TRANSFORMER_CONFIG, DRAWING_OBJECT_LAYER_INDEX, IRenderManagerService, Image, ObjectType, Rect, SHEET_EXTENSION_TYPE, SHEET_VIEWPORT_KEY, SheetExtension, UniverRenderEnginePlugin, Vector2, getCurrentTypeOfRenderer, getGroupState, transformObjectOutOfGroup } from "@univerjs/engine-render";
-import { Button, Checkbox, CheckboxGroup, FormLayout, MessageType, MobileSelect, Radio, RadioGroup, Select, clsx, render, unmount } from "@univerjs/design";
+import { Button, Checkbox, CheckboxGroup, DropdownMenu, FormLayout, Input, MessageType, MobileSelect, Radio, RadioGroup, Select, borderClassName, clsx, render, unmount } from "@univerjs/design";
 import { buildDocTransform, docDrawingPositionToTransform } from "@univerjs/docs";
-import { DRAWING_IMAGE_ALLOW_IMAGE_LIST, DRAWING_IMAGE_COUNT_LIMIT, DRAWING_IMAGE_HEIGHT_LIMIT, DRAWING_IMAGE_WIDTH_LIMIT, IDrawingManagerService, SetDrawingSelectedOperation, UniverDrawingPlugin, getDrawingImageAllowSize, getDrawingShapeKeyByDrawingSearch, getImageSize } from "@univerjs/drawing";
+import { DRAWING_IMAGE_ALLOW_IMAGE_LIST, DRAWING_IMAGE_COUNT_LIMIT, DRAWING_IMAGE_HEIGHT_LIMIT, DRAWING_IMAGE_WIDTH_LIMIT, IDrawingManagerService, SetDrawingSelectedOperation, UniverDrawingPlugin, getDrawingImageAllowSize, getDrawingShapeKeyByDrawingSearch, getImageSize, normalizeImageOpacity } from "@univerjs/drawing";
 import { COMMAND_LISTENER_SKELETON_CHANGE, IAutoFillService, INTERCEPTOR_POINT, InterceptCellContentPriority, RangeProtectionPermissionEditPoint, SetFrozenMutation, SetRangeValuesCommand, SetSelectionsOperation, SetWorksheetActiveOperation, SetWorksheetRowAutoHeightMutation, SheetInterceptorService, SheetPermissionCheckController, SheetSkeletonService, SheetsSelectionsService, UniverSheetsPlugin, WorkbookEditablePermission, WorkbookViewPermission, WorksheetEditPermission, WorksheetViewPermission, attachRangeWithCoord, discreteRangeToRange, getSheetCommandTarget, isCellImage } from "@univerjs/sheets";
 import { COPY_TYPE, EditingRenderController, HoverManagerService, IEditorBridgeService, ISheetClipboardService, ISheetSelectionRenderService, PREDEFINED_HOOK_NAME_PASTE, SetCellEditVisibleOperation, SetScrollOperation, SetZoomRatioOperation, SheetCanvasPopManagerService, SheetPrintInterceptorService, SheetSkeletonManagerService, UniverSheetsMobileUIPlugin, UniverSheetsUIPlugin, getCurrentRangeDisable$, useHighlightRange, virtualizeDiscreteRanges } from "@univerjs/sheets-ui";
-import { CanvasFloatDomPreviewService, CanvasFloatDomService, ComponentManager, ContextMenuGroup, ContextMenuPosition, FloatingObjectToolbarPosition, IClipboardInterfaceService, IContextMenuService, IDialogService, ILayoutService, ILocalFileService, IMenuManagerService, IMessageService, IShortcutService, ISidebarService, KeyCode, MenuItemType, PrintFloatDomSingle, RibbonDataGroup, RibbonInsertGroup, RibbonPosition, RibbonViewGroup, UndoRedoGroupService, UniverMobileUIPlugin, connectInjector, getMenuHiddenObservable, useDependency, useObservable } from "@univerjs/ui";
+import { CanvasFloatDomPreviewService, CanvasFloatDomService, ComponentManager, ContextMenuGroup, ContextMenuPosition, FloatingObjectToolbarPosition, IClipboardInterfaceService, IContextMenuService, IDialogService, ILayoutService, ILocalFileService, IMenuManagerService, IMessageService, IShortcutService, ISidebarService, IconManager, KeyCode, MenuItemType, PrintFloatDomSingle, RibbonDataGroup, RibbonInsertGroup, RibbonPosition, RibbonViewGroup, UndoRedoGroupService, UniverMobileUIPlugin, connectInjector, getMenuHiddenObservable, useDependency, useObservable } from "@univerjs/ui";
 import { COMPONENT_IMAGE_POPUP_MENU, COMPONENT_MOBILE_IMAGE_POPUP_MENU, DrawingCommonPanel, DrawingRenderService, ImageCropperObject, ImageResetSizeOperation, OpenImageCropOperation, UniverDrawingMobileUIPlugin, UniverDrawingUIPlugin, disposeDrawingRenderObject, insertGroupObject } from "@univerjs/drawing-ui";
 import { BehaviorSubject, EMPTY, Observable, Subject, combineLatest, distinctUntilChanged, filter, map, of, switchMap, take, takeUntil, tap, throttleTime, timer } from "rxjs";
 import { DocDrawingController, UniverDocsDrawingPlugin } from "@univerjs/docs-drawing";
-import { useCallback, useEffect, useMemo, useState } from "react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { InnerPasteCommand } from "@univerjs/docs-ui";
 
@@ -3717,7 +3717,7 @@ const menuSchema = {
 //#endregion
 //#region package.json
 var name = "@univerjs/sheets-drawing-ui";
-var version = "1.0.3";
+var version = "1.0.4";
 
 //#endregion
 //#region src/config/config.ts
@@ -3948,9 +3948,19 @@ function MobileBatchSaveImagesDialog() {
 	return /* @__PURE__ */ jsx(BatchSaveImagesDialog, { SelectComponent: 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 === SheetDrawingAnchorType.Position || value === SheetDrawingAnchorType.Both || value === SheetDrawingAnchorType.None) return value;
+		return null;
+	}
 	const commandService = useDependency(ICommandService);
 	const localeService = useDependency(LocaleService);
 	const drawingManagerService = useDependency(IDrawingManagerService);
@@ -4066,12 +4076,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: CommandType.OPERATION,
+	handler: (accessor, params) => {
+		var _renderManagerService;
+		if (!params || !Number.isFinite(params.opacity)) return false;
+		const scene = (_renderManagerService = accessor.get(IRenderManagerService).getRenderUnitById(params.unitId)) === null || _renderManagerService === void 0 ? void 0 : _renderManagerService.scene;
+		const image = scene === null || scene === void 0 ? void 0 : scene.getObject(getDrawingShapeKeyByDrawingSearch(params));
+		if (!(image instanceof 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 = useDependency(LocaleService);
+	const isRtl = useObservable(localeService.direction$, localeService.getDirection()) === "rtl";
+	const sliderRailRef = useRef(null);
+	const dragValueRef = useRef(value);
+	const pendingDragValueRef = useRef(null);
+	const lastPreviewedDragValueRef = useRef(value);
+	const dragPreviewTimerRef = useRef(null);
+	const dragCleanupRef = useRef(null);
+	const [isDragging, setIsDragging] = useState(false);
+	const [dragValue, setDragValue] = useState(value);
+	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__ */ jsxs("div", {
+		className: clsx("univer-flex univer-select-none univer-items-center univer-gap-1.5", { "univer-cursor-not-allowed": disabled }),
+		children: [/* @__PURE__ */ jsx("div", {
+			className: "univer-flex univer-h-6 univer-min-w-0 univer-flex-1 univer-items-center",
+			children: /* @__PURE__ */ jsx("div", {
+				className: 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__ */ 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__ */ jsx("div", {
+						className: 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__ */ jsx("button", {
+						className: 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", 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__ */ jsx(SheetImageTransparencyInput, {
+			value,
+			shortcuts,
+			ariaLabel,
+			disabled,
+			onChange,
+			onChangeComplete
+		})]
+	});
+}
+function SheetImageTransparencyInput(props) {
+	const { value, shortcuts, ariaLabel, disabled = false, onChange, onChangeComplete } = props;
+	const iconManager = useDependency(IconManager);
+	const isEditingRef = useRef(false);
+	const [listVisible, setListVisible] = useState(false);
+	const [inputValue, setInputValue] = useState(() => `${value}%`);
+	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__ */ jsxs("div", {
+		className: 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__ */ jsx(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__ */ jsx(DropdownMenu, {
+			align: "end",
+			items,
+			open: listVisible,
+			disabled,
+			onOpenChange: setListVisible,
+			children: /* @__PURE__ */ jsx(Button, {
+				className: "univer-h-6 univer-w-4 univer-rounded-none univer-p-0",
+				size: "small",
+				variant: "text",
+				"aria-label": ariaLabel,
+				disabled,
+				children: /* @__PURE__ */ jsx(MoreDownIcon, { className: "univer-size-3 univer-text-gray-500 dark:!univer-text-gray-300" })
+			})
+		})]
+	});
 }
-function getAnchorKind(value) {
-	if (value === SheetDrawingAnchorType.Position || value === SheetDrawingAnchorType.Both || value === 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 = useDependency(ICommandService);
+	const localeService = useDependency(LocaleService);
+	const sheetDrawingService = useDependency(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) === DrawingTypeEnum.DRAWING_IMAGE ? currentDrawing : void 0;
+	const modelOpacity = normalizeImageOpacity(image === null || image === void 0 ? void 0 : image.opacity);
+	const modelTransparency = Math.round((1 - modelOpacity) * 100);
+	const [previewState, setPreviewState] = useState(null);
+	const previewPendingRef = useRef(false);
+	const [, setModelRevision] = 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;
+	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]);
+	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(SetSheetDrawingCommand.id, {
+			unitId,
+			drawings: [{
+				unitId,
+				subUnitId,
+				drawingId,
+				opacity
+			}]
+		})) commandService.syncExecuteCommand(PreviewSheetImageOpacityOperation.id, {
+			unitId,
+			subUnitId,
+			drawingId,
+			opacity: modelOpacity
+		});
+	}
+	return /* @__PURE__ */ jsxs("section", {
+		className: "univer-grid univer-gap-2 univer-py-2 univer-text-gray-400",
+		children: [/* @__PURE__ */ jsx("header", {
+			className: "univer-text-gray-600 dark:!univer-text-gray-200",
+			children: title
+		}), /* @__PURE__ */ 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
@@ -4096,7 +4483,11 @@ const SheetDrawingPanel = () => {
 	const drawings = useObservable(() => drawingManagerService.focus$, drawingManagerService.getFocusDrawings(), false, [drawingManagerService]);
 	return !!(drawings === null || drawings === void 0 ? void 0 : drawings.length) && /* @__PURE__ */ jsxs("div", {
 		className: "univer-text-sm",
-		children: [/* @__PURE__ */ jsx(DrawingCommonPanel, { drawings }), /* @__PURE__ */ jsx(SheetDrawingAnchor, { drawings })]
+		children: [
+			/* @__PURE__ */ jsx(DrawingCommonPanel, { drawings }),
+			/* @__PURE__ */ jsx(SheetImageTransparency, { drawings }),
+			/* @__PURE__ */ jsx(SheetDrawingAnchor, { drawings })
+		]
 	});
 };
 
@@ -4514,8 +4905,26 @@ let SheetDrawingActiveRenderController = class SheetDrawingActiveRenderControlle
 		this._sheetSkeletonService = _sheetSkeletonService;
 		this._sheetDrawingService = _sheetDrawingService;
 		this._drawingManagerService = _drawingManagerService;
+		_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.onCommandExecuted((command) => {
 			if (command.id === SetWorksheetActiveOperation.id) {
@@ -4530,7 +4939,7 @@ let SheetDrawingActiveRenderController = class SheetDrawingActiveRenderControlle
 		}));
 	}
 	_clearDrawings(selfUnitId) {
-		setTimeout(() => {
+		this._scheduleRender(() => {
 			const drawingMap = this._drawingManagerService.drawingManagerData;
 			const removeDrawings = [];
 			Object.keys(drawingMap ?? {}).forEach((unitId) => {
@@ -4548,10 +4957,11 @@ let SheetDrawingActiveRenderController = class SheetDrawingActiveRenderControlle
 		});
 	}
 	_updateDrawings(showUnitId, showSubunitId) {
-		setTimeout(() => {
+		this._scheduleRender(() => {
 			const sheetSkeletonParam = this._sheetSkeletonService.getSkeletonParam(showUnitId, showSubunitId);
 			const drawingMap = this._drawingManagerService.drawingManagerData;
 			const insertDrawings = [];
+			const refreshedDrawings = [];
 			const removeDrawings = [];
 			Object.keys(drawingMap ?? {}).forEach((unitId) => {
 				if (unitId !== showUnitId) return;
@@ -4562,17 +4972,19 @@ let SheetDrawingActiveRenderController = class SheetDrawingActiveRenderControlle
 					Object.keys(drawingData).forEach((drawingId) => {
 						if (unitId === showUnitId && subUnitId === showSubunitId) {
 							const drawing = drawingData[drawingId];
-							if (drawing.sheetTransform && drawing.anchorType !== SheetDrawingAnchorType.None) drawing.transform = drawingPositionToTransform(drawing.sheetTransform, sheetSkeletonParam);
+							if (sheetSkeletonParam && drawing.sheetTransform && drawing.anchorType !== SheetDrawingAnchorType.None) refreshedDrawings.push(applySheetDrawingPlacement(drawing, getSheetDrawingPlacement(drawing), sheetSkeletonParam.skeleton));
 							insertDrawings.push(drawingData[drawingId]);
 						} else removeDrawings.push(drawingData[drawingId]);
 					});
 				});
 			});
+			this._sheetDrawingService.refreshTransform(refreshedDrawings);
+			this._drawingManagerService.refreshTransform(refreshedDrawings);
 			this._sheetDrawingService.removeNotification(removeDrawings);
 			this._sheetDrawingService.addNotification(insertDrawings);
 			this._drawingManagerService.removeNotification(removeDrawings);
 			this._drawingManagerService.addNotification(insertDrawings);
-		}, 0);
+		});
 	}
 };
 SheetDrawingActiveRenderController = __decorate([
@@ -5632,7 +6044,8 @@ let SheetDrawingUIController = class SheetDrawingUIController extends Disposable
 			MoveDrawingsCommand,
 			DeleteDrawingsCommand,
 			SaveCellImagesCommand,
-			FlipSheetDrawingCommand
+			FlipSheetDrawingCommand,
+			PreviewSheetImageOpacityOperation
 		].forEach((command) => this.disposeWithMe(this._commandService.registerCommand(command)));
 	}
 	_initShortcuts() {

package/lib/locale/ar-SA.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "يمكن رفع {0} صور فقط في المرة الواحدة",
 		invalidImage: "صورة غير صالحة"
 	},
+	"image-transparency": { title: "الشفافية" },
 	"drawing-anchor": {
 		title: "خصائص المرساة",
 		both: "النقل والتحجيم مع الخلايا",

package/lib/locale/ca-ES.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Només es poden pujar {0} imatges alhora",
 		invalidImage: "Imatge no vàlida"
 	},
+	"image-transparency": { title: "Transparència" },
 	"drawing-anchor": {
 		title: "Propietats d’ancoratge",
 		both: "Mou i canvia la mida amb les cel·les",

package/lib/locale/de-DE.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Es können nur {0} Bilder gleichzeitig hochgeladen werden",
 		invalidImage: "Ungültiges Bild"
 	},
+	"image-transparency": { title: "Transparenz" },
 	"drawing-anchor": {
 		title: "Anker-Eigenschaften",
 		both: "Mit Zellen verschieben und skalieren",

package/lib/locale/en-US.js

@@ -54,6 +54,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Only {0} images can be uploaded at a time",
 		invalidImage: "Invalid image"
 	},
+	"image-transparency": { title: "Transparency" },
 	"drawing-anchor": {
 		title: "Anchor Properties",
 		both: "Move and size with cells",

package/lib/locale/es-ES.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Solo se pueden subir {0} imágenes a la vez",
 		invalidImage: "Imagen no válida"
 	},
+	"image-transparency": { title: "Transparencia" },
 	"drawing-anchor": {
 		title: "Propiedades de anclaje",
 		both: "Mover y cambiar tamaño con las celdas",

package/lib/locale/fa-IR.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "فقط {0} تصویر می‌توانند همزمان آپلود شوند",
 		invalidImage: "تصویر نامعتبر است"
 	},
+	"image-transparency": { title: "شفافیت" },
 	"drawing-anchor": {
 		title: "خواص لنگر",
 		both: "جابه‌جایی و تغییر اندازه با سلول‌ها",

package/lib/locale/fr-FR.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Seulement {0} images peuvent être téléchargées à la fois",
 		invalidImage: "Image invalide"
 	},
+	"image-transparency": { title: "Transparence" },
 	"drawing-anchor": {
 		title: "Propriétés de l'ancre",
 		both: "Déplacer et redimensionner avec les cellules",

package/lib/locale/id-ID.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Hanya {0} gambar yang dapat diunggah dalam satu waktu",
 		invalidImage: "Gambar tidak valid"
 	},
+	"image-transparency": { title: "Transparansi" },
 	"drawing-anchor": {
 		title: "Properti Jangkar",
 		both: "Pindah dan ukur bersama sel",

package/lib/locale/it-IT.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "È possibile caricare solo {0} immagini alla volta",
 		invalidImage: "Immagine non valida"
 	},
+	"image-transparency": { title: "Trasparenza" },
 	"drawing-anchor": {
 		title: "Proprietà ancoraggio",
 		both: "Sposta e ridimensiona con le celle",

package/lib/locale/ja-JP.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "一度にアップロードできるのは {0} 個までです",
 		invalidImage: "無効な画像です"
 	},
+	"image-transparency": { title: "透明度" },
 	"drawing-anchor": {
 		title: "プロパティ",
 		both: "セルに合わせて移動やサイズ変更をする",

package/lib/locale/ko-KR.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "한 번에 {0}개까지만 업로드할 수 있습니다",
 		invalidImage: "유효하지 않은 이미지입니다"
 	},
+	"image-transparency": { title: "투명도" },
 	"drawing-anchor": {
 		title: "고정 위치 설정",
 		both: "셀과 함께 이동 및 크기 조절",

package/lib/locale/pl-PL.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Jednocześnie można przesłać tylko {0} obrazów",
 		invalidImage: "Nieprawidłowy obraz"
 	},
+	"image-transparency": { title: "Przezroczystość" },
 	"drawing-anchor": {
 		title: "Właściwości kotwicy",
 		both: "Przesuwaj i zmieniaj rozmiar razem z komórkami",

package/lib/locale/pt-BR.js

@@ -39,6 +39,7 @@ const locale = { "sheets-drawing-ui": {
 		exceedMaxCount: "Apenas {0} imagens podem ser enviadas de cada vez",
 		invalidImage: "Imagem inválida"
 	},
+	"image-transparency": { title: "Transparência" },
 	"drawing-anchor": {
 		title: "Propriedades da âncora",
 		both: "Mover e dimensionar com as células",