@univerjs/sheets-ui 0.15.0 → 0.15.1-insiders.20260117-8ce4a01

package/lib/types/consts/mobile-context.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Context key indicating that pinch-to-zoom gesture is in progress on mobile.
+ * Used to prevent selection operations during pinch zoom.
+ */
+export declare const MOBILE_PINCH_ZOOMING = "MOBILE_PINCH_ZOOMING";
+/**
+ * Context key indicating that selection is being expanded on mobile (dragging fill controls).
+ * Used to prevent scroll/inertia/zoom operations during selection expansion.
+ */
+export declare const MOBILE_EXPANDING_SELECTION = "MOBILE_EXPANDING_SELECTION";

package/lib/types/controllers/clipboard/clipboard.controller.d.ts

@@ -22,6 +22,8 @@ export declare class SheetClipboardController extends RxDisposable {
     private _init;
     private _initCopyingHooks;
     private _initPastingHook;
+    private _initPastingRowsHook;
+    private _initPastingColumnsHook;
     private _generateDocumentDataModelSnapshot;
     private _onPastePlainText;
     private _onPasteCells;

package/lib/types/controllers/menu/menu.d.ts

@@ -1,5 +1,6 @@
 import { IAccessor, HorizontalAlign, VerticalAlign, WrapStrategy } from '@univerjs/core';
 import { IMenuButtonItem, IMenuSelectorItem } from '@univerjs/ui';
+import { Observable } from 'rxjs';
 export declare enum SheetMenuPosition {
     ROW_HEADER_CONTEXT_MENU = "ROW_HEADER_CONTEXT_MENU",
     COL_HEADER_CONTEXT_MENU = "COL_HEADER_CONTEXT_MENU",
@@ -44,6 +45,7 @@ export declare const TEXT_ROTATE_CHILDREN: ({
     value: string;
 })[];
 export declare function TextRotateMenuItemFactory(accessor: IAccessor): IMenuSelectorItem<number | string>;
+export declare function menuClipboardDisabledObservable(injector: IAccessor): Observable<boolean>;
 export declare function CopyMenuItemFactory(accessor: IAccessor): IMenuButtonItem;
 export declare function CutMenuItemFactory(accessor: IAccessor): IMenuButtonItem;
 export declare function PasteMenuItemFactory(accessor: IAccessor): IMenuButtonItem;

package/lib/types/controllers/render-controllers/mobile/mobile-scroll.render-controller.d.ts

@@ -1,4 +1,4 @@
-import { IRange, Workbook, Disposable, ICommandService, IUniverInstanceService } from '@univerjs/core';
+import { IRange, Workbook, Disposable, ICommandService, IContextService, IUniverInstanceService } from '@univerjs/core';
 import { IRenderContext, IRenderModule, IRenderManagerService } from '@univerjs/engine-render';
 import { SheetsSelectionsService } from '@univerjs/sheets';
 import { SheetScrollManagerService } from '../../../services/scroll-manager.service';
@@ -14,7 +14,8 @@ export declare class MobileSheetsScrollRenderController extends Disposable imple
     private readonly _selectionManagerService;
     private readonly _scrollManagerService;
     protected readonly _univerInstanceService: IUniverInstanceService;
-    constructor(_context: IRenderContext<Workbook>, _sheetSkeletonManagerService: SheetSkeletonManagerService, _commandService: ICommandService, _renderManagerService: IRenderManagerService, _selectionManagerService: SheetsSelectionsService, _scrollManagerService: SheetScrollManagerService, _univerInstanceService: IUniverInstanceService);
+    private readonly _contextService;
+    constructor(_context: IRenderContext<Workbook>, _sheetSkeletonManagerService: SheetSkeletonManagerService, _commandService: ICommandService, _renderManagerService: IRenderManagerService, _selectionManagerService: SheetsSelectionsService, _scrollManagerService: SheetScrollManagerService, _univerInstanceService: IUniverInstanceService, _contextService: IContextService);
     scrollToRange(range: IRange): boolean;
     private _init;
     private _initCommandListener;
@@ -23,12 +24,25 @@ export declare class MobileSheetsScrollRenderController extends Disposable imple
     private _initScrollEventListener;
     private _initSkeletonListener;
     /**
-     * for mobile
+     * for mobile - iOS-like smooth inertia scrolling
+     * Uses native touch events for better mobile experience while keeping onPointerDown$ as trigger
+     * to avoid interfering with header events
      */
     private _initPointerScrollEvent;
+    /**
+     * Create zoom indicator overlay element
+     */
+    private _createZoomIndicator;
+    /**
+     * Show zoom indicator with percentage
+     */
+    private _showZoomIndicator;
+    /**
+     * Hide zoom indicator with fade out
+     */
+    private _hideZoomIndicator;
     private _updateSceneSize;
     private _getSheetObject;
-    private _scrollToSelectionByDirection;
     private _scrollToSelection;
     private _getViewportBounding;
     private _scrollToCell;

package/lib/types/index.d.ts

@@ -64,7 +64,7 @@ export { EMBEDDING_FORMULA_EDITOR, isEmbeddingFormulaEditor } from './controller
 export { isRangeSelector, RANGE_SELECTOR_SYMBOLS } from './controllers/editor/utils/is-range-selector';
 export { HoverRenderController } from './controllers/hover-render.controller';
 export { menuSchema as SheetsUIMenuSchema } from './controllers/menu.schema';
-export { COPY_SPECIAL_MENU_ID, PASTE_SPECIAL_MENU_ID, SheetMenuPosition } from './controllers/menu/menu';
+export { COPY_SPECIAL_MENU_ID, menuClipboardDisabledObservable, PASTE_SPECIAL_MENU_ID, SheetMenuPosition } from './controllers/menu/menu';
 export { deriveStateFromActiveSheet$, getCurrentExclusiveRangeInterest$, getCurrentRangeDisable$, getObservableWithExclusiveRange$ } from './controllers/menu/menu-util';
 export { SheetPermissionCheckUIController } from './controllers/permission/sheet-permission-check-ui.controller';
 export { HeaderFreezeRenderController } from './controllers/render-controllers/freeze.render-controller';

package/lib/types/services/canvas-pop-manager.service.d.ts

@@ -25,6 +25,7 @@ export declare class SheetCanvasPopManagerService extends Disposable {
     private readonly _refSelectionsService;
     private readonly _selectionManagerService;
     private _popupMenuFeatureMap;
+    private _popupMenuOffsetMap;
     constructor(_globalPopupManagerService: ICanvasPopupService, _renderManagerService: IRenderManagerService, _univerInstanceService: IUniverInstanceService, _refRangeService: RefRangeService, _commandService: ICommandService, _refSelectionsService: ISheetSelectionRenderService, _selectionManagerService: SheetsSelectionsService);
     private _isSelectionMoving;
     private _initMoving;
@@ -32,6 +33,13 @@ export declare class SheetCanvasPopManagerService extends Disposable {
      * Register a feature menu callback for a specific drawing type.such as image, chart, etc.
      */
     registerFeatureMenu(type: DrawingTypeEnum, getPopupMenuCallBack: getPopupMenuItemCallback): void;
+    /**
+     * Register a feature menu offset for a specific drawing type.
+     * @param {DrawingTypeEnum} type the drawing type
+     * @param offsetX The offset x
+     * @param offsetY The offset y
+     */
+    registerFeatureMenuOffset(type: DrawingTypeEnum, offsetX: number, offsetY: number): void;
     /**
      * Get the feature menu by drawing type, the function should be called when a drawing element need trigger popup menu, so the unitId, subUnitId, drawingId should be provided.
      * @param {string} unitId the unit id

package/lib/types/services/clipboard/clipboard.service.d.ts

@@ -13,6 +13,8 @@ export declare const PREDEFINED_HOOK_NAME_COPY: {
 };
 export declare const PREDEFINED_HOOK_NAME_PASTE: {
     readonly DEFAULT_PASTE: "default-paste";
+    readonly DEFAULT_PASTE_ROWS: "default-paste-rows";
+    readonly DEFAULT_PASTE_COLUMNS: "default-paste-columns";
     readonly SPECIAL_PASTE_VALUE: "special-paste-value";
     readonly SPECIAL_PASTE_FORMAT: "special-paste-format";
     readonly SPECIAL_PASTE_COL_WIDTH: "special-paste-col-width";
@@ -21,6 +23,8 @@ export declare const PREDEFINED_HOOK_NAME_PASTE: {
 };
 export declare const PREDEFINED_HOOK_NAME: {
     readonly DEFAULT_PASTE: "default-paste";
+    readonly DEFAULT_PASTE_ROWS: "default-paste-rows";
+    readonly DEFAULT_PASTE_COLUMNS: "default-paste-columns";
     readonly SPECIAL_PASTE_VALUE: "special-paste-value";
     readonly SPECIAL_PASTE_FORMAT: "special-paste-format";
     readonly SPECIAL_PASTE_COL_WIDTH: "special-paste-col-width";
@@ -46,6 +50,7 @@ export interface ISheetClipboardService {
     copy(options?: ICopyOptions): Promise<boolean>;
     cut(): Promise<boolean>;
     paste(item: ClipboardItem, pasteType?: string): Promise<boolean>;
+    pasteByCopyId(copyId: string, pasteType?: string): Promise<boolean>;
     legacyPaste(html?: string, text?: string, files?: File[]): Promise<boolean>;
     rePasteWithPasteType(type: IPasteHookKeyType): boolean;
     disposePasteOptionsCache(): void;
@@ -91,6 +96,7 @@ export declare class SheetClipboardService extends Disposable implements ISheetC
     copy(options?: ICopyOptions): Promise<boolean>;
     cut(): Promise<boolean>;
     paste(item: ClipboardItem, pasteType?: "default-paste"): Promise<boolean>;
+    pasteByCopyId(copyId: string, pasteType?: "default-paste"): Promise<boolean>;
     legacyPaste(html?: string, text?: string, files?: File[]): Promise<boolean>;
     rePasteWithPasteType(type: IPasteHookKeyType): boolean;
     updatePasteOptionsCache(cache: IPasteOptionCache | null): void;
@@ -106,6 +112,7 @@ export declare class SheetClipboardService extends Disposable implements ISheetC
     private _pasteExternal;
     private _pasteInternal;
     private _pasteUSM;
+    private _getPastedRangeAutoHeightMutation;
     private _getSetSelectionOperation;
     private _getPastingTarget;
     /**

package/lib/types/services/clipboard/copy-content-cache.d.ts

@@ -12,10 +12,13 @@ export declare function genId(): string;
 export declare function extractId(html: string): string | null;
 export declare class CopyContentCache {
     private _cache;
+    private readonly _lastCopyId$;
+    readonly lastCopyId$: import('rxjs').Observable<string | null>;
     set(id: string, clipboardData: ICopyContentCacheData): void;
     get(id: string): ICopyContentCacheData | undefined;
     del(id: string): void;
     clear(): void;
     clearWithUnitId(unitId: string): void;
+    getLastCopyId(): string | null;
 }
 export declare const copyContentCache: CopyContentCache;

package/lib/types/services/clipboard/type.d.ts

@@ -149,7 +149,7 @@ export interface ISheetClipboardHook {
      * @param payload
      * @returns undo and redo mutations
      */
-    onPasteRows?(pasteTo: ISheetDiscreteRangeLocation, rowProperties: IClipboardPropertyItem[], payload: ICopyPastePayload): {
+    onPasteRows?(pasteTo: ISheetDiscreteRangeLocation): {
         undos: IMutationInfo[];
         redos: IMutationInfo[];
     };

package/lib/types/services/clipboard/usm-to-html/convertor.d.ts

@@ -5,5 +5,5 @@ export declare class USMToHtmlService {
     convert(matrix: ObjectMatrix<ICellData & {
         rowSpan?: number | undefined;
         colSpan?: number | undefined;
-    }>, range: IDiscreteRange, hooks: ISheetClipboardHook[]): string;
+    }>, range: IDiscreteRange, hooks: ISheetClipboardHook[], copyId?: string): string;
 }

package/lib/types/services/selection/mobile-selection-render.service.d.ts

@@ -1,5 +1,5 @@
-import { Workbook, ICommandService, IContextService, ILogService, Injector, RANGE_TYPE, ThemeService } from '@univerjs/core';
-import { IMouseEvent, IPointerEvent, IRenderContext, IRenderModule, Scene, SpreadsheetSkeleton, Viewport } from '@univerjs/engine-render';
+import { Nullable, Workbook, ICommandService, IContextService, ILogService, Injector, RANGE_TYPE, ThemeService } from '@univerjs/core';
+import { IMouseEvent, IPointerEvent, IRenderContext, IRenderModule, Scene, SpreadsheetSkeleton, Viewport, ScrollTimerType } from '@univerjs/engine-render';
 import { ISelectionWithStyle, SheetsSelectionsService } from '@univerjs/sheets';
 import { IShortcutService } from '@univerjs/ui';
 import { SheetScrollManagerService } from '../scroll-manager.service';
@@ -25,6 +25,7 @@ export declare class MobileSheetsSelectionRenderService extends BaseSelectionRen
     _expandingSelection: boolean;
     protected _selectionControls: MobileSelectionControl[];
     expandingControlMode: ExpandingControl;
+    private _anchorCellForExpanding;
     constructor(_context: IRenderContext<Workbook>, injector: Injector, themeService: ThemeService, shortcutService: IShortcutService, selectionManagerService: SheetsSelectionsService, sheetSkeletonManagerService: SheetSkeletonManagerService, _logService: ILogService, _commandService: ICommandService, _contextService: IContextService, _scrollManagerService: SheetScrollManagerService);
     private _init;
     private _initSkeletonChangeListener;
@@ -56,6 +57,11 @@ export declare class MobileSheetsSelectionRenderService extends BaseSelectionRen
     getSelectionControls(): MobileSelectionControl[];
     private _fillControlPointerDownHandler;
     private _changeCurrCellWhenControlPointerDown;
+    /**
+     * Override base class method to add pinch zoom check.
+     * When pinch zooming, we should not process pointer move events for selection.
+     */
+    protected _setupPointerMoveListener(viewportMain: Nullable<Viewport>, activeSelectionControl: MobileSelectionControl, rangeType: RANGE_TYPE, scrollTimerType: ScrollTimerType | undefined, moveStartPosX: number, moveStartPosY: number): void;
     /**
      * Not same as _moving in PC (base selection render service)
      * The diff is

package/lib/types/views/dropdown/list-dropdown/index.d.ts

@@ -11,6 +11,7 @@ export interface IListDropdownProps {
     }[];
     defaultValue?: string;
     showEdit?: boolean;
+    showSearch?: boolean;
 }
 export declare function ListDropDown(props: {
     popup: IPopup<IListDropdownProps & IBaseDropdownProps>;