@univerjs/docs 0.2.5 → 0.2.7

package/lib/types/basics/custom-decoration-factory.d.ts

@@ -3,7 +3,7 @@ import { IRichTextEditingMutationParams } from '../commands/mutations/core-editi
 
 interface IAddCustomDecorationParam {
     unitId: string;
-    range: ITextRange;
+    ranges: ITextRange[];
     segmentId?: string;
     id: string;
     type: CustomDecorationType;

package/lib/types/basics/custom-range.d.ts

@@ -1,5 +1,6 @@
-import { ICustomRange, DataStreamTreeTokenType } from '@univerjs/core';
+import { ICustomRange, ITextRange, DataStreamTreeTokenType } from '@univerjs/core';
 
 export declare function isCustomRangeSplitSymbol(text: string): text is DataStreamTreeTokenType.CUSTOM_RANGE_START | DataStreamTreeTokenType.CUSTOM_RANGE_END;
 export declare function isIntersecting(line1Start: number, line1End: number, line2Start: number, line2End: number): boolean;
 export declare function shouldDeleteCustomRange(deleteStart: number, deleteLen: number, customRange: ICustomRange, dataStream: string): boolean;
+export declare function getCustomRangesIntesetsWithRange(range: ITextRange, customRanges: ICustomRange[]): ICustomRange[];

package/lib/types/basics/selection.d.ts

@@ -1,11 +1,8 @@
 import { IDocumentBody, ITextRange, Nullable } from '@univerjs/core';
 import { DeleteDirection } from '../types/enums/delete-direction';
 
-export declare function normalizeSelection(selection: ITextRange): {
-    startOffset: number;
-    endOffset: number;
-    collapsed: boolean;
-};
+export declare function makeSelection(startOffset: number, endOffset?: number): ITextRange;
+export declare function normalizeSelection(selection: ITextRange): ITextRange;
 export declare function getSelectionWithSymbolMax(selection: ITextRange, body: IDocumentBody): {
     startOffset: number;
     endOffset: number;

package/lib/types/basics/table.d.ts

@@ -0,0 +1,19 @@
+import { Nullable } from '@univerjs/core';
+import { IDocumentSkeletonLine, IDocumentSkeletonPage, IDocumentSkeletonTable } from '@univerjs/engine-render';
+
+export declare function firstLineInTable(table: IDocumentSkeletonTable): IDocumentSkeletonLine;
+export declare function lastLineInTable(table: IDocumentSkeletonTable): IDocumentSkeletonLine | undefined;
+export declare function findTableAfterLine(line: IDocumentSkeletonLine, page: IDocumentSkeletonPage): IDocumentSkeletonTable | null;
+export declare function findLineBeforeAndAfterTable(table: Nullable<IDocumentSkeletonTable>): {
+    lineBeforeTable: null;
+    lineAfterTable: null;
+};
+export declare function findBellowCell(cell: IDocumentSkeletonPage): IDocumentSkeletonPage | undefined;
+export declare function findAboveCell(cell: IDocumentSkeletonPage): IDocumentSkeletonPage | undefined;
+export declare function findNextCell(cell: IDocumentSkeletonPage): void;
+export declare function findPrevCell(cell: IDocumentSkeletonPage): void;
+export declare function findTableBeforeLine(line: IDocumentSkeletonLine, page: IDocumentSkeletonPage): IDocumentSkeletonTable | null;
+export declare function firstLineInCell(cell: IDocumentSkeletonPage): IDocumentSkeletonLine;
+export declare function lastLineInCell(cell: IDocumentSkeletonPage): IDocumentSkeletonLine | undefined;
+export declare function isFirstLineInCell(line: IDocumentSkeletonLine, cell: IDocumentSkeletonPage): boolean;
+export declare function isLastLineInCell(line: IDocumentSkeletonLine, cell: IDocumentSkeletonPage): boolean;

package/lib/types/commands/commands/__tests__/mock-text-selection-render-manager.d.ts

@@ -4,7 +4,7 @@ import { ITextSelectionInnerParam } from '@univerjs/engine-render';
 export declare class TextSelectionRenderManager {
     private readonly _textSelectionInner$;
     readonly textSelectionInner$: import('rxjs').Observable<Nullable<ITextSelectionInnerParam>>;
-    removeAllTextRanges(): void;
-    addTextRanges(): void;
+    removeAllRanges(): void;
+    addDocRanges(): void;
 }
 export declare const ITextSelectionRenderManager: import('@univerjs/core').IdentifierDecorator<TextSelectionRenderManager>;

package/lib/types/commands/commands/auto-format.command.d.ts

@@ -0,0 +1,8 @@
+import { ICommand } from '@univerjs/core';
+
+export interface ITabCommandParams {
+    shift?: boolean;
+}
+export declare const TabCommand: ICommand<ITabCommandParams>;
+export declare const AfterSpaceCommand: ICommand;
+export declare const EnterCommand: ICommand;

package/lib/types/commands/commands/break-line.command.d.ts

@@ -1,3 +1,4 @@
-import { ICommand } from '@univerjs/core';
+import { ICommand, IParagraph } from '@univerjs/core';
 
+export declare function generateParagraphs(dataStream: string, prevParagraph?: IParagraph): IParagraph[];
 export declare const BreakLineCommand: ICommand;

package/lib/types/commands/commands/clipboard.inner.command.d.ts

@@ -1,9 +1,9 @@
-import { ICommand, IDocumentBody, ITextRange } from '@univerjs/core';
+import { ICommand, IDocumentData, ITextRange } from '@univerjs/core';
 import { ITextRangeWithStyle } from '@univerjs/engine-render';
 
 export interface IInnerPasteCommandParams {
     segmentId: string;
-    body: IDocumentBody;
+    doc: Partial<IDocumentData>;
     textRanges: ITextRangeWithStyle[];
 }
 export declare const InnerPasteCommand: ICommand<IInnerPasteCommandParams>;

package/lib/types/commands/commands/delete.command.d.ts

@@ -1,5 +1,5 @@
-import { ICommand } from '@univerjs/core';
-import { IActiveTextRange } from '@univerjs/engine-render';
+import { ICommand, Nullable } from '@univerjs/core';
+import { IActiveTextRange, RectRange, TextRange } from '@univerjs/engine-render';
 import { DeleteDirection } from '../../types/enums/delete-direction';
 
 export interface IDeleteCustomBlockParams {
@@ -14,6 +14,7 @@ interface IMergeTwoParagraphParams {
     range: IActiveTextRange;
 }
 export declare const MergeTwoParagraphCommand: ICommand<IMergeTwoParagraphParams>;
+export declare function getCursorWhenDelete(textRanges: Readonly<Nullable<TextRange[]>>, rectRanges: readonly RectRange[]): number;
 export declare const DeleteLeftCommand: ICommand;
 export declare const DeleteRightCommand: ICommand;
 export {};

package/lib/types/commands/commands/inline-format.command.d.ts

@@ -1,7 +1,6 @@
 import { ICommand } from '@univerjs/core';
 
 export interface ISetInlineFormatCommandParams {
-    segmentId: string;
     preCommandId: string;
     value?: string;
 }

package/lib/types/commands/commands/list.command.d.ts

@@ -1,16 +1,42 @@
-import { ICommand, IParagraph, ISectionBreak, PresetListType } from '@univerjs/core';
-import { IActiveTextRange } from '@univerjs/engine-render';
+import { ICommand, IParagraph, IParagraphRange, ISectionBreak, PresetListType } from '@univerjs/core';
+import { IActiveTextRange, IDocRange } from '@univerjs/engine-render';
 
 interface IListOperationCommandParams {
     listType: PresetListType;
 }
 export declare const ListOperationCommand: ICommand<IListOperationCommandParams>;
+interface IChangeListTypeCommandParams {
+    listType: PresetListType;
+}
+export declare const ChangeListTypeCommand: ICommand<IChangeListTypeCommandParams>;
+export declare enum ChangeListNestingLevelType {
+    increase = 1,
+    decrease = -1
+}
+interface IChangeListNestingLevelCommandParams {
+    type: ChangeListNestingLevelType;
+}
+export declare const ChangeListNestingLevelCommand: ICommand<IChangeListNestingLevelCommandParams>;
 interface IBulletListCommandParams {
+    value?: PresetListType;
 }
 export declare const BulletListCommand: ICommand<IBulletListCommandParams>;
+export declare const CheckListCommand: ICommand<IBulletListCommandParams>;
+export interface IToggleCheckListCommandParams {
+    index: number;
+}
+export declare const ToggleCheckListCommand: ICommand<IToggleCheckListCommandParams>;
 interface IOrderListCommandParams {
+    value?: PresetListType;
 }
 export declare const OrderListCommand: ICommand<IOrderListCommandParams>;
+interface IQuickListCommandParams {
+    listType: PresetListType;
+    paragraph: IParagraphRange;
+}
+export declare const QuickListCommand: ICommand<IQuickListCommandParams>;
 export declare function getParagraphsInRange(activeRange: IActiveTextRange, paragraphs: IParagraph[]): IParagraph[];
+export declare function getParagraphsRelative(ranges: IDocRange[], paragraphs: IParagraph[]): IParagraph[];
+export declare function getParagraphsInRanges(ranges: IDocRange[], paragraphs: IParagraph[]): IParagraph[];
 export declare function findNearestSectionBreak(currentIndex: number, sectionBreaks: ISectionBreak[]): ISectionBreak | undefined;
 export {};

package/lib/types/commands/commands/table/doc-table-create.command.d.ts

@@ -0,0 +1,11 @@
+import { ICommand } from '@univerjs/core';
+
+export declare const CreateDocTableCommandId = "doc.command.create-table";
+export interface ICreateDocTableCommandParams {
+    rowCount: number;
+    colCount: number;
+}
+/**
+ * The command to create a table at cursor point.
+ */
+export declare const CreateDocTableCommand: ICommand<ICreateDocTableCommandParams>;

package/lib/types/commands/commands/table/doc-table-delete.command.d.ts

@@ -0,0 +1,11 @@
+import { ICommand } from '@univerjs/core';
+
+export interface IDocTableDeleteRowsCommandParams {
+}
+export declare const DocTableDeleteRowsCommand: ICommand<IDocTableDeleteRowsCommandParams>;
+export interface IDocTableDeleteColumnsCommandParams {
+}
+export declare const DocTableDeleteColumnsCommand: ICommand<IDocTableDeleteColumnsCommandParams>;
+export interface IDocTableDeleteTableCommandParams {
+}
+export declare const DocTableDeleteTableCommand: ICommand<IDocTableDeleteTableCommandParams>;

package/lib/types/commands/commands/table/doc-table-insert.command.d.ts

@@ -0,0 +1,35 @@
+import { ICommand } from '@univerjs/core';
+import { INSERT_COLUMN_POSITION, INSERT_ROW_POSITION } from './table';
+
+export declare const DocTableInsertRowCommandId = "doc.command.table-insert-row";
+export declare const DocTableInsertColumnCommandId = "doc.command.table-insert-column";
+export declare const DocTableInsertRowAboveCommandId = "doc.command.table-insert-row-above";
+export declare const DocTableInsertRowBellowCommandId = "doc.command.table-insert-row-bellow";
+export declare const DocTableInsertColumnLeftCommandId = "doc.command.table-insert-column-left";
+export declare const DocTableInsertColumnRightCommandId = "doc.command.table-insert-column-right";
+export interface IDocTableInsertRowAboveCommandParams {
+}
+export declare const DocTableInsertRowAboveCommand: ICommand<IDocTableInsertRowAboveCommandParams>;
+export interface IDocTableInsertRowBellowCommandParams {
+}
+export declare const DocTableInsertRowBellowCommand: ICommand<IDocTableInsertRowBellowCommandParams>;
+export interface IDocTableInsertColumnLeftCommandParams {
+}
+export declare const DocTableInsertColumnLeftCommand: ICommand<IDocTableInsertColumnLeftCommandParams>;
+export interface IDocTableInsertColumnRightCommandParams {
+}
+export declare const DocTableInsertColumnRightCommand: ICommand<IDocTableInsertColumnRightCommandParams>;
+export interface IDocTableInsertRowCommandParams {
+    position: INSERT_ROW_POSITION;
+}
+/**
+ * The command to insert table row.
+ */
+export declare const DocTableInsertRowCommand: ICommand<IDocTableInsertRowCommandParams>;
+export interface IDocTableInsertColumnCommandParams {
+    position: INSERT_COLUMN_POSITION;
+}
+/**
+ * The command to insert table column.
+ */
+export declare const DocTableInsertColumnCommand: ICommand<IDocTableInsertColumnCommandParams>;

package/lib/types/commands/commands/table/doc-table-tab.command.d.ts

@@ -0,0 +1,8 @@
+import { ICommand } from '@univerjs/core';
+
+export interface IDocTableTabCommandParams {
+}
+export declare const DocTableTabCommand: ICommand<IDocTableTabCommandParams>;
+export interface IDocTableShiftTabCommandParams {
+}
+export declare const DocTableShiftTabCommand: ICommand<IDocTableShiftTabCommandParams>;

package/lib/types/commands/commands/table/table.d.ts

@@ -0,0 +1,85 @@
+import { IParagraph, ISectionBreak, ITable, ITableCell, ITableColumn, ITableRow, Nullable } from '@univerjs/core';
+import { DocumentViewModel, RectRange, TextRange } from '@univerjs/engine-render';
+
+export declare enum INSERT_ROW_POSITION {
+    ABOVE = 0,
+    BELLOW = 1
+}
+export declare enum INSERT_COLUMN_POSITION {
+    LEFT = 0,
+    RIGHT = 1
+}
+export declare function genEmptyTable(rowCount: number, colCount: number): {
+    dataStream: string;
+    paragraphs: IParagraph[];
+    sectionBreaks: ISectionBreak[];
+};
+export declare function getEmptyTableCell(): ITableCell;
+export declare function getEmptyTableRow(col: number): ITableRow;
+export declare function getTableColumn(width: number): ITableColumn;
+export declare function genTableSource(rowCount: number, colCount: number, pageContentWidth: number): ITable;
+interface IRangeInfo {
+    startOffset: number;
+    endOffset: number;
+    segmentId: string;
+}
+export declare function getRangeInfoFromRanges(textRange: Nullable<TextRange>, rectRanges: Readonly<Nullable<RectRange[]>>): Nullable<IRangeInfo>;
+export declare function getInsertRowBody(col: number): {
+    dataStream: string;
+    paragraphs: IParagraph[];
+    sectionBreaks: ISectionBreak[];
+};
+export declare function getInsertColumnBody(): {
+    dataStream: string;
+    paragraphs: IParagraph[];
+    sectionBreaks: ISectionBreak[];
+};
+export declare function getInsertRowActionsParams(rangeInfo: IRangeInfo, position: INSERT_ROW_POSITION, viewModel: DocumentViewModel): {
+    offset: number;
+    colCount: number;
+    tableId: string;
+    insertRowIndex: number;
+} | null;
+export declare function getInsertColumnActionsParams(rangeInfo: IRangeInfo, position: INSERT_COLUMN_POSITION, viewModel: DocumentViewModel): {
+    offsets: number[];
+    tableId: string;
+    columnIndex: number;
+    rowCount: number;
+} | null;
+export declare function getColumnWidths(pageWidth: number, tableColumns: ITableColumn[], insertColumnIndex: number): {
+    widths: number[];
+    newColWidth: number;
+};
+export declare function getDeleteRowsActionsParams(rangeInfo: IRangeInfo, viewModel: DocumentViewModel): {
+    tableId: string;
+    rowIndexes: number[];
+    offset: number;
+    len: number;
+    cursor: number;
+    selectWholeTable: boolean;
+} | null;
+interface IRetainDeleteOffset {
+    retain: number;
+    delete: number;
+}
+export declare function getDeleteColumnsActionParams(rangeInfo: IRangeInfo, viewModel: DocumentViewModel): {
+    offsets: IRetainDeleteOffset[];
+    tableId: string;
+    columnIndexes: number[];
+    cursor: number;
+    selectWholeTable: boolean;
+    rowCount: number;
+} | null;
+export declare function getDeleteTableActionParams(rangeInfo: IRangeInfo, viewModel: DocumentViewModel): {
+    tableId: string;
+    offset: number;
+    len: number;
+    cursor: number;
+} | null;
+export declare function getDeleteRowContentActionParams(rangeInfo: IRangeInfo, viewModel: DocumentViewModel): {
+    offsets: IRetainDeleteOffset[];
+    tableId: string;
+    cursor: number;
+    rowCount: number;
+} | null;
+export {};

package/lib/types/commands/mutations/docs-rename.mutation.d.ts

@@ -0,0 +1,7 @@
+import { ICommand } from '@univerjs/core';
+
+export interface IDocsRenameMutationParams {
+    name: string;
+    unitId: string;
+}
+export declare const DocsRenameMutation: ICommand;

package/lib/types/controllers/ime-input.controller.d.ts

@@ -1,11 +1,13 @@
 import { Disposable, ICommandService, IUniverInstanceService } from '@univerjs/core';
 import { IRenderManagerService, ITextSelectionRenderManager } from '@univerjs/engine-render';
 import { IMEInputManagerService } from '../services/ime-input-manager.service';
+import { TextSelectionManagerService } from '../services/text-selection-manager.service';
 
 export declare class IMEInputController extends Disposable {
     private readonly _univerInstanceService;
     private readonly _renderManagerSrv;
     private readonly _textSelectionRenderManager;
+    private readonly _textSelectionManagerService;
     private readonly _imeInputManagerService;
     private readonly _commandService;
     private _previousIMEContent;
@@ -13,7 +15,7 @@ export declare class IMEInputController extends Disposable {
     private _onStartSubscription;
     private _onUpdateSubscription;
     private _onEndSubscription;
-    constructor(_univerInstanceService: IUniverInstanceService, _renderManagerSrv: IRenderManagerService, _textSelectionRenderManager: ITextSelectionRenderManager, _imeInputManagerService: IMEInputManagerService, _commandService: ICommandService);
+    constructor(_univerInstanceService: IUniverInstanceService, _renderManagerSrv: IRenderManagerService, _textSelectionRenderManager: ITextSelectionRenderManager, _textSelectionManagerService: TextSelectionManagerService, _imeInputManagerService: IMEInputManagerService, _commandService: ICommandService);
     dispose(): void;
     private _initialize;
     private _initialOnCompositionstart;

package/lib/types/index.d.ts

@@ -13,14 +13,15 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+export { getParagraphsInRange, getParagraphsInRanges } from './commands/commands/list.command';
 export { replaceSelectionFactory } from './basics/replace';
-export { getSelectionText, getDeleteSelection, getInsertSelection, isSegmentIntersects } from './basics/selection';
+export { makeSelection, getSelectionText, getDeleteSelection, getInsertSelection, isSegmentIntersects } from './basics/selection';
 export type { IDocObjectParam } from './basics/component-tools';
 export { getDocObject, neoGetDocObject, getDocObjectById } from './basics/component-tools';
 export * from './basics/docs-view-key';
 export { type IUniverDocsConfig, UniverDocsPlugin } from './doc-plugin';
 export { DocSkeletonManagerService } from './services/doc-skeleton-manager.service';
-export { TextSelectionManagerService, serializeTextRange } from './services/text-selection-manager.service';
+export { TextSelectionManagerService, serializeDocRange } from './services/text-selection-manager.service';
 export { DocStateChangeManagerService, type IDocStateChangeParams } from './services/doc-state-change-manager.service';
 export { IMEInputManagerService } from './services/ime-input-manager.service';
 export { DocCustomRangeService, type ICustomRangeHook } from './services/doc-custom-range.service';
@@ -30,14 +31,11 @@ export { InsertCommand, DeleteCommand, UpdateCommand, EditorInsertTextCommandId,
 export { DeleteLeftCommand, DeleteRightCommand, DeleteCustomBlockCommand, MergeTwoParagraphCommand, type IDeleteCustomBlockParams } from './commands/commands/delete.command';
 export { IMEInputCommand, type IIMEInputCommandParams } from './commands/commands/ime-input.command';
 export { SetInlineFormatBoldCommand, SetInlineFormatItalicCommand, SetInlineFormatUnderlineCommand, SetInlineFormatStrikethroughCommand, SetInlineFormatSubscriptCommand, SetInlineFormatSuperscriptCommand, SetInlineFormatFontSizeCommand, SetInlineFormatFontFamilyCommand, SetInlineFormatTextColorCommand, SetInlineFormatTextBackgroundColorCommand, ResetInlineFormatTextBackgroundColorCommand, SetInlineFormatCommand, } from './commands/commands/inline-format.command';
-export { ListOperationCommand, BulletListCommand, OrderListCommand } from './commands/commands/list.command';
+export { ListOperationCommand, BulletListCommand, OrderListCommand, ChangeListNestingLevelCommand, ChangeListTypeCommand, CheckListCommand, ToggleCheckListCommand, QuickListCommand, } from './commands/commands/list.command';
 export { AlignOperationCommand, AlignLeftCommand, AlignCenterCommand, AlignRightCommand, AlignJustifyCommand, } from './commands/commands/paragraph-align.command';
 export { ReplaceContentCommand, CoverContentCommand } from './commands/commands/replace-content.command';
 export { SetDocZoomRatioCommand } from './commands/commands/set-doc-zoom-ratio.command';
-export { addCustomRangeFactory, addCustomRangeBySelectionFactory, deleteCustomRangeFactory } from './basics/custom-range-factory';
-export { addCustomDecorationBySelectionFactory, addCustomDecorationFactory, deleteCustomDecorationFactory } from './basics/custom-decoration-factory';
-export { DocInterceptorService } from './services/doc-interceptor/doc-interceptor.service';
-export { DOC_INTERCEPTOR_POINT } from './services/doc-interceptor/interceptor-const';
+export { AfterSpaceCommand, TabCommand, EnterCommand, type ITabCommandParams } from './commands/commands/auto-format.command';
 export { RichTextEditingMutation, type IRichTextEditingMutationParams, } from './commands/mutations/core-editing.mutation';
 export { MoveCursorOperation, MoveSelectionOperation } from './commands/operations/cursor.operation';
 export { SelectAllOperation } from './commands/operations/select-all.operation';
@@ -46,3 +44,21 @@ export { SetTextSelectionsOperation, type ISetTextSelectionsOperationParams, } f
 export { getRetainAndDeleteFromReplace } from './basics/retain-delete-params';
 export { getRichTextEditPath } from './commands/util';
 export { getPlainTextFormDocument } from './basics/plain-text';
+export { addCustomRangeFactory, addCustomRangeBySelectionFactory, deleteCustomRangeFactory } from './basics/custom-range-factory';
+export { addCustomDecorationBySelectionFactory, addCustomDecorationFactory, deleteCustomDecorationFactory } from './basics/custom-decoration-factory';
+export { DocInterceptorService } from './services/doc-interceptor/doc-interceptor.service';
+export { DOC_INTERCEPTOR_POINT } from './services/doc-interceptor/interceptor-const';
+export { DocAutoFormatService } from './services/doc-auto-format.service';
+export { ChangeListNestingLevelType } from './commands/commands/list.command';
+export { getCommandSkeleton } from './commands/util';
+export { generateParagraphs } from './commands/commands/break-line.command';
+export type { IInnerCutCommandParams } from './commands/commands/clipboard.inner.command';
+export { CreateDocTableCommand, type ICreateDocTableCommandParams } from './commands/commands/table/doc-table-create.command';
+export { DocTableDeleteRowsCommand, DocTableDeleteColumnsCommand, DocTableDeleteTableCommand } from './commands/commands/table/doc-table-delete.command';
+export type { IDocTableDeleteRowsCommandParams, IDocTableDeleteColumnsCommandParams, IDocTableDeleteTableCommandParams } from './commands/commands/table/doc-table-delete.command';
+export type { IDocTableInsertColumnCommandParams, IDocTableInsertRowCommandParams, IDocTableInsertColumnRightCommandParams, IDocTableInsertRowAboveCommandParams, IDocTableInsertRowBellowCommandParams, IDocTableInsertColumnLeftCommandParams } from './commands/commands/table/doc-table-insert.command';
+export { DocTableInsertColumnCommand, DocTableInsertRowCommand, DocTableInsertColumnRightCommand, DocTableInsertRowAboveCommand, DocTableInsertRowBellowCommand, DocTableInsertColumnLeftCommand } from './commands/commands/table/doc-table-insert.command';
+export type { IDocTableShiftTabCommandParams, IDocTableTabCommandParams } from './commands/commands/table/doc-table-tab.command';
+export { DocTableTabCommand, DocTableShiftTabCommand } from './commands/commands/table/doc-table-tab.command';
+export { genTableSource, getEmptyTableRow, getEmptyTableCell, getTableColumn } from './commands/commands/table/table';
+export { getCursorWhenDelete } from './commands/commands/delete.command';

package/lib/types/services/doc-auto-format.service.d.ts

@@ -0,0 +1,38 @@
+import { DocumentDataModel, ICommandInfo, ICustomRange, IDisposable, IParagraphRange, ITextRange, Nullable, Disposable, IUniverInstanceService } from '@univerjs/core';
+import { TextSelectionManagerService } from './text-selection-manager.service';
+
+export interface IAutoFormatContext {
+    unit: DocumentDataModel;
+    selection: ITextRange;
+    /**
+     * is selection at doc body
+     */
+    isBody: boolean;
+    /**
+     * selection relative paragraphs
+     */
+    paragraphs: IParagraphRange[];
+    /**
+     * selection relative custom ranges
+     */
+    customRanges: ICustomRange[];
+    commandId: string;
+    commandParams: Nullable<object>;
+}
+export interface IAutoFormat {
+    id: string;
+    match: (context: IAutoFormatContext) => boolean;
+    getMutations: (context: IAutoFormatContext) => ICommandInfo[];
+    priority?: number;
+}
+/**
+ * service for auto-formating, handle shortcut like `Space` or `Tab`
+ */
+export declare class DocAutoFormatService extends Disposable {
+    private readonly _univerInstanceService;
+    private readonly _textSelectionManagerService;
+    private _matches;
+    constructor(_univerInstanceService: IUniverInstanceService, _textSelectionManagerService: TextSelectionManagerService);
+    registerAutoFormat(match: IAutoFormat): IDisposable;
+    onAutoFormat(id: string, params: Nullable<object>): ICommandInfo[];
+}

package/lib/types/services/text-selection-manager.service.d.ts

@@ -1,7 +1,7 @@
 import { Nullable, ICommandService, RxDisposable } from '@univerjs/core';
-import { INodePosition, ISuccinctTextRangeParam, ITextRangeWithStyle, ITextSelectionInnerParam, ITextSelectionStyle, RANGE_DIRECTION, TextRange, ITextSelectionRenderManager } from '@univerjs/engine-render';
+import { IDocRange, INodePosition, ISuccinctDocRangeParam, ITextRangeWithStyle, ITextSelectionInnerParam, ITextSelectionStyle, RANGE_DIRECTION, RectRange, TextRange, ITextSelectionRenderManager } from '@univerjs/engine-render';
 
-interface ITextSelectionManagerSearchParam {
+interface IDocSelectionManagerSearchParam {
     unitId: string;
     subUnitId: string;
 }
@@ -16,9 +16,9 @@ export interface ITextActiveRange {
     style: ITextSelectionStyle;
     segmentPage: number;
 }
-interface ITextSelectionManagerInsertParam extends ITextSelectionManagerSearchParam, ITextSelectionInnerParam {
+interface ITextSelectionManagerInsertParam extends IDocSelectionManagerSearchParam, ITextSelectionInnerParam {
 }
-export declare function serializeTextRange(textRange: TextRange): ITextRangeWithStyle;
+export declare function serializeDocRange(textRange: IDocRange): ITextRangeWithStyle;
 /**
  * This service is for text selection.
  */
@@ -30,17 +30,20 @@ export declare class TextSelectionManagerService extends RxDisposable {
     private readonly _textSelection$;
     readonly textSelection$: import('rxjs').Observable<Nullable<ITextSelectionManagerInsertParam>>;
     constructor(_textSelectionRenderManager: ITextSelectionRenderManager, _commandService: ICommandService);
-    getCurrentSelection(): Nullable<ITextSelectionManagerSearchParam>;
+    getCurrentSelection(): Nullable<IDocSelectionManagerSearchParam>;
     getCurrentSelectionInfo(): ITextSelectionInnerParam | undefined;
     dispose(): void;
     refreshSelection(): void;
-    setCurrentSelection(param: ITextSelectionManagerSearchParam): void;
-    setCurrentSelectionNotRefresh(param: ITextSelectionManagerSearchParam): void;
-    getCurrentSelections(): Readonly<Nullable<TextRange[]>>;
+    setCurrentSelection(param: IDocSelectionManagerSearchParam): void;
+    setCurrentSelectionNotRefresh(param: IDocSelectionManagerSearchParam): void;
+    getCurrentTextRanges(): Readonly<Nullable<TextRange[]>>;
+    getCurrentRectRanges(): Readonly<Nullable<RectRange[]>>;
+    getDocRanges(): (TextRange | RectRange)[];
     getActiveTextRange(): Nullable<TextRange>;
-    getActiveRange(): Nullable<ITextActiveRange>;
-    add(textRanges: ISuccinctTextRangeParam[], isEditing?: boolean): void;
-    replaceTextRanges(textRanges: ISuccinctTextRangeParam[], isEditing?: boolean, options?: {
+    getActiveRectRange(): Nullable<RectRange>;
+    getActiveTextRangeWithStyle(): Nullable<ITextActiveRange>;
+    add(textRanges: ISuccinctDocRangeParam[], isEditing?: boolean): void;
+    replaceTextRanges(docRanges: ISuccinctDocRangeParam[], isEditing?: boolean, options?: {
         [key: string]: boolean;
     }): void;
     private _syncSelectionFromRenderService;