@univerjs/sheets-ui 0.12.4 → 0.13.0

package/lib/locale/ca-ES.js

@@ -166,6 +166,7 @@ const e = {
     copy: "Copiar",
     cut: "Retallar",
     paste: "Enganxar",
+    copySpecial: "Còpia especial",
     pasteSpecial: "Enganxat especial",
     pasteValue: "Enganxar només els valors",
     pasteFormat: "Enganxar només el format",

package/lib/locale/en-US.js

@@ -166,6 +166,7 @@ const e = {
     copy: "Copy",
     cut: "Cut",
     paste: "Paste",
+    copySpecial: "Copy Special",
     pasteSpecial: "Paste Special",
     pasteValue: "Paste Value",
     pasteFormat: "Paste Format",

package/lib/locale/es-ES.js

@@ -166,6 +166,7 @@ const e = {
     copy: "Copiar",
     cut: "Cortar",
     paste: "Pegar",
+    copySpecial: "Copiar especial",
     pasteSpecial: "Pegado especial",
     pasteValue: "Pegar solo valores",
     pasteFormat: "Pegar solo formato",

package/lib/locale/fa-IR.js

@@ -166,6 +166,7 @@ const e = {
     copy: "کپی",
     cut: "برش",
     paste: "چسباندن",
+    copySpecial: "کپی ویژه",
     pasteSpecial: "چسباندن ویژه",
     pasteValue: "چسباندن مقدار",
     pasteFormat: "چسباندن قالب",

package/lib/locale/fr-FR.js

@@ -166,6 +166,7 @@ const e = {
     copy: "Copier",
     cut: "Couper",
     paste: "Coller",
+    copySpecial: "Collage spécial",
     pasteSpecial: "Collage spécial",
     pasteValue: "Coller la valeur",
     pasteFormat: "Coller le format",

package/lib/locale/ja-JP.js

@@ -166,6 +166,7 @@ const e = {
     copy: "コピー",
     cut: "切り取り",
     paste: "貼り付け",
+    copySpecial: "選択的にコピー",
     pasteSpecial: "形式を選択して貼り付け",
     pasteValue: "値を貼り付け",
     pasteFormat: "書式を貼り付け",

package/lib/locale/ko-KR.js

@@ -166,6 +166,7 @@ const e = {
     copy: "복사",
     cut: "자르기",
     paste: "붙여넣기",
+    copySpecial: "선택하여 복사",
     pasteSpecial: "선택하여 붙여넣기",
     pasteValue: "값 붙여넣기",
     pasteFormat: "서식 붙여넣기",

package/lib/locale/ru-RU.js

@@ -166,6 +166,7 @@ const e = {
     copy: "Копировать",
     cut: "Вырезать",
     paste: "Вставить",
+    copySpecial: "Выборочная копия",
     pasteSpecial: "Специальная вставка",
     pasteValue: "Вставить значение",
     pasteFormat: "Вставить формат",

package/lib/locale/vi-VN.js

@@ -166,6 +166,7 @@ const n = {
     copy: "Sao chép",
     cut: "Cắt",
     paste: "Dán",
+    copySpecial: "Sao chép đặc biệt",
     pasteSpecial: "Dán đặc biệt",
     pasteValue: "Chỉ dán giá trị",
     pasteFormat: "Chỉ dán định dạng",

package/lib/locale/zh-CN.js

@@ -167,6 +167,7 @@ const e = {
     copy: "复制",
     cut: "剪切",
     paste: "粘贴",
+    copySpecial: "选择性复制",
     pasteSpecial: "选择性粘贴",
     pasteValue: "仅粘贴值",
     pasteFormat: "仅粘贴格式",

package/lib/locale/zh-TW.js

@@ -167,6 +167,7 @@ const e = {
     copy: "複製",
     cut: "剪下",
     paste: "貼上",
+    copySpecial: "選擇性複製",
     pasteSpecial: "選擇性貼上",
     pasteValue: "僅貼上值",
     pasteFormat: "僅貼上格式",

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

@@ -47,6 +47,8 @@ export declare function TextRotateMenuItemFactory(accessor: IAccessor): IMenuSel
 export declare function CopyMenuItemFactory(accessor: IAccessor): IMenuButtonItem;
 export declare function CutMenuItemFactory(accessor: IAccessor): IMenuButtonItem;
 export declare function PasteMenuItemFactory(accessor: IAccessor): IMenuButtonItem;
+export declare const COPY_SPECIAL_MENU_ID = "sheet.menu.copy-special";
+export declare function CopySpacialMenuItemFactory(accessor: IAccessor): IMenuSelectorItem;
 export declare const PASTE_SPECIAL_MENU_ID = "sheet.menu.paste-special";
 export declare function PasteSpacialMenuItemFactory(accessor: IAccessor): IMenuSelectorItem;
 export declare function PasteValueMenuItemFactory(accessor: IAccessor): IMenuButtonItem<string>;

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 { PASTE_SPECIAL_MENU_ID, SheetMenuPosition } from './controllers/menu/menu';
+export { COPY_SPECIAL_MENU_ID, 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';
@@ -90,9 +90,9 @@ export { type ICanvasPopup, SheetCanvasPopManagerService } from './services/canv
 export { CellAlertManagerService, CellAlertType, type ICellAlert } from './services/cell-alert-manager.service';
 export { type IDropdownParam, ISheetCellDropdownManagerService, SheetCellDropdownManagerService } from './services/cell-dropdown-manager.service';
 export { CellPopupManagerService } from './services/cell-popup-manager.service';
-export { getMatrixPlainText, ISheetClipboardService, PREDEFINED_HOOK_NAME, SheetClipboardService } from './services/clipboard/clipboard.service';
+export { getMatrixPlainText, ISheetClipboardService, PREDEFINED_HOOK_NAME, PREDEFINED_HOOK_NAME_COPY, PREDEFINED_HOOK_NAME_PASTE, SheetClipboardService } from './services/clipboard/clipboard.service';
 export { COPY_TYPE } from './services/clipboard/type';
-export type { ICellDataWithSpanInfo, ICopyPastePayload, IPasteHookValueType, ISheetClipboardHook, ISheetDiscreteRangeLocation } from './services/clipboard/type';
+export type { ICellDataWithSpanInfo, ICopyHookKeyType, ICopyHookValueType, ICopyPastePayload, IPasteHookKeyType, IPasteHookValueType, ISheetClipboardHook, ISheetDiscreteRangeLocation } from './services/clipboard/type';
 export { getRepeatRange, mergeSetRangeValues } from './services/clipboard/utils';
 export { DragManagerService, type IDragCellPosition } from './services/drag-manager.service';
 export { EditorBridgeService, IEditorBridgeService, type IEditorBridgeServiceVisibleParam } from './services/editor-bridge.service';

package/lib/types/locale/en-US.d.ts

@@ -181,6 +181,7 @@ declare const locale: {
         copy: string;
         cut: string;
         paste: string;
+        copySpecial: string;
         pasteSpecial: string;
         pasteValue: string;
         pasteFormat: string;

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

@@ -1,14 +1,17 @@
 import { ICellDataWithSpanAndDisplay, IDisposable, IRange, Nullable, Disposable, ErrorService, ICommandService, ILogService, Injector, IUndoRedoService, IUniverInstanceService, LocaleService, ObjectMatrix, ThemeService } from '@univerjs/core';
 import { Observable } from 'rxjs';
 import { IDiscreteRange } from '../../controllers/utils/range-tools';
-import { IPasteHookKeyType, IPasteOptionCache, ISheetClipboardHook, COPY_TYPE } from './type';
+import { ICopyOptions, IPasteHookKeyType, IPasteOptionCache, ISheetClipboardHook } from './type';
 import { IRenderManagerService } from '@univerjs/engine-render';
 import { SheetsSelectionsService } from '@univerjs/sheets';
 import { IClipboardInterfaceService, INotificationService, IPlatformService } from '@univerjs/ui';
 import { IMarkSelectionService } from '../mark-selection/mark-selection.service';
 import { CopyContentCache } from './copy-content-cache';
-export declare const PREDEFINED_HOOK_NAME: {
+export declare const PREDEFINED_HOOK_NAME_COPY: {
     readonly DEFAULT_COPY: "default-copy";
+    readonly SPECIAL_COPY_FORMULA_ONLY: "special-copy-formula-only";
+};
+export declare const PREDEFINED_HOOK_NAME_PASTE: {
     readonly DEFAULT_PASTE: "default-paste";
     readonly SPECIAL_PASTE_VALUE: "special-paste-value";
     readonly SPECIAL_PASTE_FORMAT: "special-paste-format";
@@ -16,6 +19,16 @@ export declare const PREDEFINED_HOOK_NAME: {
     readonly SPECIAL_PASTE_BESIDES_BORDER: "special-paste-besides-border";
     readonly SPECIAL_PASTE_FORMULA: "special-paste-formula";
 };
+export declare const PREDEFINED_HOOK_NAME: {
+    readonly DEFAULT_PASTE: "default-paste";
+    readonly SPECIAL_PASTE_VALUE: "special-paste-value";
+    readonly SPECIAL_PASTE_FORMAT: "special-paste-format";
+    readonly SPECIAL_PASTE_COL_WIDTH: "special-paste-col-width";
+    readonly SPECIAL_PASTE_BESIDES_BORDER: "special-paste-besides-border";
+    readonly SPECIAL_PASTE_FORMULA: "special-paste-formula";
+    readonly DEFAULT_COPY: "default-copy";
+    readonly SPECIAL_COPY_FORMULA_ONLY: "special-copy-formula-only";
+};
 interface ICopyContent {
     copyId: string;
     plain: string;
@@ -30,13 +43,13 @@ export interface ISheetClipboardService {
     pasteOptionsCache$: Observable<IPasteOptionCache | null>;
     getPasteOptionsCache: () => IPasteOptionCache | null;
     updatePasteOptionsCache(cache: IPasteOptionCache | null): void;
-    copy(): Promise<boolean>;
+    copy(options?: ICopyOptions): Promise<boolean>;
     cut(): Promise<boolean>;
     paste(item: ClipboardItem, pasteType?: string): Promise<boolean>;
     legacyPaste(html?: string, text?: string, files?: File[]): Promise<boolean>;
     rePasteWithPasteType(type: IPasteHookKeyType): boolean;
     disposePasteOptionsCache(): void;
-    generateCopyContent(workbookId: string, worksheetId: string, range: IRange, copyType?: COPY_TYPE): Nullable<ICopyContent>;
+    generateCopyContent(workbookId: string, worksheetId: string, range: IRange, options?: ICopyOptions): Nullable<ICopyContent>;
     copyContentCache(): CopyContentCache;
     addClipboardHook(hook: ISheetClipboardHook): IDisposable;
     getClipboardHooks(): ISheetClipboardHook[];
@@ -74,8 +87,8 @@ export declare class SheetClipboardService extends Disposable implements ISheetC
     getPasteMenuVisible(): boolean;
     getPasteOptionsCache(): IPasteOptionCache | null;
     copyContentCache(): CopyContentCache;
-    generateCopyContent(workbookId: string, worksheetId: string, range: IRange, copyType?: COPY_TYPE): Nullable<ICopyContent>;
-    copy(copyType?: COPY_TYPE): Promise<boolean>;
+    generateCopyContent(workbookId: string, worksheetId: string, range: IRange, options?: ICopyOptions): Nullable<ICopyContent>;
+    copy(options?: ICopyOptions): Promise<boolean>;
     cut(): Promise<boolean>;
     paste(item: ClipboardItem, pasteType?: "default-paste"): Promise<boolean>;
     legacyPaste(html?: string, text?: string, files?: File[]): Promise<boolean>;

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

@@ -1,6 +1,6 @@
-import { ICellData, IDocumentData, IMutationInfo, IRange, ObjectMatrix } from '@univerjs/core';
+import { ICellData, ICellDataWithSpanAndDisplay, IDocumentData, IMutationInfo, IRange, ObjectMatrix } from '@univerjs/core';
 import { IDiscreteRange } from '../../controllers/utils/range-tools';
-import { PREDEFINED_HOOK_NAME } from './clipboard.service';
+import { PREDEFINED_HOOK_NAME_COPY, PREDEFINED_HOOK_NAME_PASTE } from './clipboard.service';
 export declare enum COPY_TYPE {
     COPY = "COPY",
     CUT = "CUT"
@@ -196,8 +196,18 @@ export interface ISheetClipboardHook {
      * The callback would be called before the clipboard service decides what region need to be copied from or pasted to.
      * It would jump over these filtered rows when copying or pasting.
      */
-    getFilteredOutRows?(range: IRange): number[];
+    getFilteredOutRows?(unitId: string, subUnitId: string, range: IRange): number[];
+    /**
+     * Handle matrix on each cell of copy operation.
+     */
+    handleMatrixOnCell?(row: number, column: number, rowIndexInMatrix: number, columnIndexInMatrix: number, matrix: ObjectMatrix<ICellDataWithSpanAndDisplay>, matrixFragment: ObjectMatrix<ICellDataWithSpanInfo>, plainMatrix: ObjectMatrix<ICellDataWithSpanAndDisplay>): void;
+}
+export interface ICopyOptions {
+    copyType?: COPY_TYPE;
+    copyHookType?: ICopyHookValueType;
 }
+export type ICopyHookKeyType = keyof typeof PREDEFINED_HOOK_NAME_COPY;
+export type ICopyHookValueType = typeof PREDEFINED_HOOK_NAME_COPY[ICopyHookKeyType];
 export interface IPasteOptionCache {
     target: IPasteTarget;
     source?: IPasteSource;
@@ -210,6 +220,5 @@ export type IPasteSource = ISheetDiscreteRangeLocation & {
     copyId: string;
     copyType: COPY_TYPE;
 };
-export type IPasteHookKeyType = Exclude<keyof typeof PREDEFINED_HOOK_NAME, 'default-copy'>;
-export type IPasteHookValueTypeWithoutDefaultCopy = typeof PREDEFINED_HOOK_NAME[IPasteHookKeyType];
-export type IPasteHookValueType = Exclude<IPasteHookValueTypeWithoutDefaultCopy, 'default-copy'>;
+export type IPasteHookKeyType = keyof typeof PREDEFINED_HOOK_NAME_PASTE;
+export type IPasteHookValueType = typeof PREDEFINED_HOOK_NAME_PASTE[IPasteHookKeyType];