@univerjs/sheets-ui 1.0.2 → 1.0.4

package/lib/types/commands/commands/set-selection.command.d.ts

@@ -48,6 +48,8 @@ export interface IExpandSelectionCommandParams {
     jumpOver?: JumpOver;
     nextStep?: number;
     extra?: string;
+    /** Use the normal selection's primary cell to start a formula reference. */
+    fromCurrentSelection?: boolean;
 }
 export declare const ExpandSelectionCommand: ICommand<IExpandSelectionCommandParams>;
 export interface ISelectAllCommandParams {

package/lib/types/{views/editor-container/index.d.ts → common/selection-input.d.ts}

@@ -13,5 +13,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export * from './EditorContainer';
-export { useKeyEventConfig } from './hooks';
+import type { IMouseEvent } from '@univerjs/engine-render';
+export declare function isSheetContextMenuGesture(event: Pick<IMouseEvent, 'button' | 'ctrlKey'>, isMac: boolean, refSelectionsEnabled: boolean): boolean;
+export declare function isSheetMultiSelectModifier(event: Pick<IMouseEvent, 'ctrlKey' | 'metaKey'>, isMac: boolean): boolean;

package/lib/types/config/config.d.ts

@@ -23,6 +23,12 @@ export interface IUniverSheetsUIConfig {
     menu?: MenuConfig;
     disableAutoFocus?: true;
     override?: DependencyOverride;
+    /**
+     * Whether arrow keys may wrap to another row or column at worksheet boundaries.
+     * Does not affect Enter/Tab cycling within selected ranges.
+     * @default true
+     */
+    allowArrowKeyWrapOnSheetBoundary?: boolean;
     /**
      * The maximum count of rows triggering auto height. This is used to avoid performance issue.
      * @default 1000

package/lib/types/controllers/editor/data-sync.controller.d.ts

@@ -47,6 +47,7 @@ export declare class EditorDataSyncController extends Disposable {
     private _syncFormulaBarTextColorOnThemeChange;
     private _refreshRenderStyleConfig;
     private _checkAndSetRenderStyleConfig;
+    private _getFormulaBarTextColor;
     protected _getSourceStyleRenderValue(isFormulaBar: boolean): BooleanNumber;
     private _clearParagraph;
 }

package/lib/types/controllers/editor/editing.render-controller.d.ts

@@ -67,6 +67,7 @@ export declare class EditingRenderController extends Disposable {
      */
     private _commandExecutedListener;
     private _handleEditorVisible;
+    private _resizeEditorOnOpen;
     private _cacheEmptyCellTextStyle;
     private _refreshCurrentSelections;
     private _handleEditorInvisible;

package/lib/types/controllers/render-controllers/contextmenu.render-controller.d.ts

@@ -17,9 +17,9 @@ import type { Workbook } from '@univerjs/core';
 import type { IRenderContext, IRenderModule } from '@univerjs/engine-render';
 import type { ISheetEmbedRuntimeDomScope } from '../../services/sheet-embed-integration.service';
 import type { ISheetHostChromeOverride } from '../../services/sheet-host-chrome-override.service';
-import { Disposable, Injector } from '@univerjs/core';
+import { Disposable, IContextService, Injector } from '@univerjs/core';
 import { SheetsSelectionsService } from '@univerjs/sheets';
-import { IContextMenuService } from '@univerjs/ui';
+import { IContextMenuService, IPlatformService } from '@univerjs/ui';
 import { ISheetSelectionRenderService } from '../../services/selection/base-selection-render.service';
 /**
  * This controller subscribe to context menu events in sheet rendering views and invoke context menu at a correct
@@ -31,8 +31,11 @@ export declare class SheetContextMenuRenderController extends Disposable impleme
     private readonly _selectionManagerService;
     private readonly _selectionRenderService;
     private readonly _injector;
-    constructor(_context: IRenderContext<Workbook>, _contextMenuService: IContextMenuService, _selectionManagerService: SheetsSelectionsService, _selectionRenderService: ISheetSelectionRenderService, _injector: Injector);
+    private readonly _platformService;
+    private readonly _contextService;
+    constructor(_context: IRenderContext<Workbook>, _contextMenuService: IContextMenuService, _selectionManagerService: SheetsSelectionsService, _selectionRenderService: ISheetSelectionRenderService, _injector: Injector, _platformService: IPlatformService, _contextService: IContextService);
     private _init;
+    private _isContextMenuGesture;
     private _initEmbedRuntimeSessionListener;
     private _shouldSuppressHostContextMenu;
     private _getSheetHostChromeOverrideService;

package/lib/types/controllers/render-controllers/desktop-cell-edit.render-controller.d.ts

@@ -18,6 +18,7 @@ import type { IRenderContext, IRenderModule } from '@univerjs/engine-render';
 import { ICommandService, IContextService, IUniverInstanceService, RxDisposable } from '@univerjs/core';
 import { IRenderManagerService } from '@univerjs/engine-render';
 import { SheetsSelectionsService } from '@univerjs/sheets';
+import { IPlatformService } from '@univerjs/ui';
 import { IEditorBridgeService } from '../../services/editor-bridge.service';
 import { ISheetEmbedRuntimeFocusCoordinator } from '../../services/sheet-embed-integration.service';
 export declare class DesktopCellEditRenderController extends RxDisposable implements IRenderModule {
@@ -28,9 +29,10 @@ export declare class DesktopCellEditRenderController extends RxDisposable implem
     private readonly _selectionManagerService;
     private readonly _contextService;
     private readonly _renderManagerService;
+    private readonly _platformService;
     private readonly _embedRuntimeFocusCoordinator?;
     private _d;
-    constructor(_context: IRenderContext<Workbook>, _instanceService: IUniverInstanceService, _commandService: ICommandService, _editorBridgeService: IEditorBridgeService, _selectionManagerService: SheetsSelectionsService, _contextService: IContextService, _renderManagerService: IRenderManagerService, _embedRuntimeFocusCoordinator?: ISheetEmbedRuntimeFocusCoordinator | undefined);
+    constructor(_context: IRenderContext<Workbook>, _instanceService: IUniverInstanceService, _commandService: ICommandService, _editorBridgeService: IEditorBridgeService, _selectionManagerService: SheetsSelectionsService, _contextService: IContextService, _renderManagerService: IRenderManagerService, _platformService: IPlatformService, _embedRuntimeFocusCoordinator?: ISheetEmbedRuntimeFocusCoordinator | undefined);
     private _init;
     private _disposeCurrent;
     private _initEventListener;

package/lib/types/index.d.ts

@@ -143,13 +143,15 @@ export { calculateDocSkeletonRects, getCustomRangePosition, getEditingCustomRang
 export { AutoFillPopupMenu } from './views/auto-fill-popup-menu/AutoFillPopupMenu';
 export { BorderLine } from './views/border-panel/border-line/BorderLine';
 export { BORDER_LINE_CHILDREN, BORDER_SIZE_CHILDREN } from './views/border-panel/interface';
-export { EditorContainer, useKeyEventConfig } from './views/editor-container';
+export { DEFINED_NAME_CONTAINER } from './views/defined-name/component-name';
+export { EditorContainer } from './views/editor-container/EditorContainer';
+export { useKeyEventConfig } from './views/editor-container/hooks';
 export { FormulaBar } from './views/formula-bar';
 export { useActiveWorkbook, useActiveWorksheet, useWorkbooks } from './views/hook';
 export type { IRangeProtectionRenderCellData } from './views/permission/extensions/range-protection.render';
-export { type IPermissionDetailUserPartProps } from './views/permission/panel-detail/PermissionDetailUserPart';
-export { type IBaseSheetBarProps } from './views/sheet-bar/sheet-bar-tabs/SheetBarItem';
+export type { IPermissionDetailUserPartProps } from './views/permission/panel-detail/PermissionDetailUserPart';
+export type { IBaseSheetBarProps } from './views/sheet-bar/sheet-bar-tabs/SheetBarItem';
 export { SheetBar } from './views/sheet-bar/SheetBar';
 export { SHEET_FOOTER_BAR_HEIGHT } from './views/sheet-container/SheetContainer';
-export { type IStatisticItem } from './views/status-bar/CopyableStatisticItem';
+export type { IStatisticItem } from './views/status-bar/CopyableStatisticItem';
 export { functionDisplayNames } from './views/status-bar/CopyableStatisticItem';

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

@@ -71,6 +71,8 @@ export declare const COPY_SPECIAL_MENU_ID = "sheet.menu.copy-special";
 export declare function CopySpacialMenuItemFactory(accessor: IAccessor): IMenuSelectorItem<LocaleKey>;
 export declare const PASTE_SPECIAL_MENU_ID = "sheet.menu.paste-special";
 export declare function PasteSpacialMenuItemFactory(accessor: IAccessor): IMenuSelectorItem<LocaleKey>;
+export declare const PASTE_RIBBON_MENU_ID = "sheet.menu.paste";
+export declare function PasteRibbonMenuItemFactory(accessor: IAccessor): IMenuSelectorItem<LocaleKey>;
 export declare function PasteValueMenuItemFactory(accessor: IAccessor): IMenuButtonItem<LocaleKey, string>;
 export declare function PasteFormatMenuItemFactory(accessor: IAccessor): IMenuButtonItem<LocaleKey, string>;
 export declare function PasteColWidthMenuItemFactory(accessor: IAccessor): IMenuButtonItem<LocaleKey, string>;

package/lib/types/services/editor-bridge.service.d.ts

@@ -29,6 +29,10 @@ export interface IEditorBridgeServiceVisibleParam {
     keycode?: KeyCode;
     isShift?: boolean;
     initialValue?: string;
+    pointerPosition?: {
+        x: number;
+        y: number;
+    };
 }
 export interface ICurrentEditCellParam {
     scene: Scene;

package/lib/types/services/hover-manager.service.d.ts

@@ -110,7 +110,7 @@ export declare class HoverManagerService extends Disposable {
     currentCellPosWithEvent$: import("rxjs").Observable<void | ICellPosWithEvent | null | undefined>;
     currentPosition$: import("rxjs").Observable<Nullable<IHoverCellPosition>>;
     currentClickedCell$: import("rxjs").Observable<IHoverRichTextInfo>;
-    currentDbClickedCell$: import("rxjs").Observable<IHoverRichTextInfo>;
+    currentDbClickedCell$: import("rxjs").Observable<IHoverRichTextInfo & ICellWithEvent>;
     currentPointerDownCell$: import("rxjs").Observable<ICellPosWithEvent>;
     currentPointerUpCell$: import("rxjs").Observable<ICellPosWithEvent>;
     currentHoveredRowHeader$: import("rxjs").Observable<Nullable<IHoverHeaderPosition>>;
@@ -140,7 +140,7 @@ export declare class HoverManagerService extends Disposable {
      * @param offsetY
      */
     triggerClick(unitId: string, offsetX: number, offsetY: number): void;
-    triggerDbClick(unitId: string, offsetX: number, offsetY: number): void;
+    triggerDbClick(unitId: string, event: IPointerEvent | IMouseEvent): void;
     triggerScroll(): void;
     triggerRowHeaderClick(unitId: string, offsetX: number, offsetY: number): void;
     triggerColHeaderClick(unitId: string, offsetX: number, offsetY: number): void;

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

@@ -216,6 +216,8 @@ export declare class BaseSelectionRenderService extends Disposable implements IS
         x: number;
         y: number;
     }): Nullable<ISelectionWithCoord>;
+    protected _isContextMenuGesture(evt: IPointerEvent | IMouseEvent): boolean;
+    protected _isMultiSelectModifier(evt: IPointerEvent | IMouseEvent): boolean;
     protected _checkClearPreviousControls(evt: IPointerEvent | IMouseEvent): void;
     protected _makeSelectionByTwoCells(currentCell: ICellWithCoord, startSelectionRange: IRangeWithCoord, skeleton: SpreadsheetSkeleton, rangeType: RANGE_TYPE, activeControl: SelectionControl): void;
     isSelectionEnabled(): boolean;

package/lib/types/services/selection/selection-control.d.ts

@@ -61,6 +61,9 @@ export declare class SelectionControl extends Disposable {
     protected _scene: Scene;
     protected _zIndex: number;
     protected readonly _themeService: ThemeService;
+    private _moveAnimationFrame;
+    private _animatedRange;
+    private _restoreMoveEvents;
     private _isHelperSelection;
     /**
      * For ref selections, there is no auto fill.
@@ -196,7 +199,9 @@ export declare class SelectionControl extends Disposable {
      * Update range and primary range and style.
      * @param selectionWthCoord
      */
-    updateRangeBySelectionWithCoord(selectionWthCoord: ISelectionWithCoord, sk?: SpreadsheetSkeleton): void;
+    updateRangeBySelectionWithCoord(selectionWthCoord: ISelectionWithCoord, sk?: SpreadsheetSkeleton, animate?: boolean): void;
+    private _animateMove;
+    private _stopMoveAnimation;
     /**
      * Update primary range.
      * highlight cell would update if primary cell has value.

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

@@ -75,5 +75,6 @@ export declare class SheetSelectionRenderService extends BaseSelectionRenderServ
      */
     protected _onPointerDown(evt: IPointerEvent | IMouseEvent, _zIndex: number | undefined, rangeType: RANGE_TYPE | undefined, viewport: Nullable<Viewport>, scrollTimerType?: ScrollTimerType): void;
     private _updateSelectionControl;
+    private _canAnimateSelection;
     endSelection(): void;
 }

package/lib/types/views/defined-name/DefinedNameOverlay.d.ts

@@ -13,7 +13,10 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export declare function DefinedNameOverlay({ search, isInputEvent }: {
+interface IDefinedNameOverlayProps {
     search: string;
     isInputEvent: boolean;
-}): import("react").JSX.Element;
+    onClose: () => void;
+}
+export declare function DefinedNameOverlay({ search, isInputEvent, onClose }: IDefinedNameOverlayProps): import("react").JSX.Element;
+export {};

package/lib/types/views/editor-container/focus-editor.d.ts

@@ -14,12 +14,13 @@
  * limitations under the License.
  */
 import type { IDisposable } from '@univerjs/core';
+import type { IEditorService } from '@univerjs/docs-ui';
 import type { ISheetEmbedInteractionBoundaryService, ISheetEmbedRuntimeFocusCoordinator } from '../../services/sheet-embed-integration.service';
-export declare function focusSheetCellEditorElement(ownerDocument?: Document): boolean;
+export declare function focusSheetCellEditorElement(editorService: IEditorService): boolean;
 export declare function registerSheetCellEditorRuntimePortal(options: {
     embedId: string;
+    editorService: IEditorService;
     ownerDocument?: Document;
     interactionBoundaryService?: ISheetEmbedInteractionBoundaryService;
     focusCoordinator?: ISheetEmbedRuntimeFocusCoordinator;
 }): IDisposable;
-export declare function resolveSheetCellEditorPortalRoot(ownerDocument?: Document): HTMLElement | null;