/**
 * 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.
 */
import type { IWorkbookData, IWorksheetData, UniverInstanceType } from '@univerjs/core';
import type { IEventBase } from '@univerjs/core/facade';
import type { CommandListenerValueChange } from '@univerjs/sheets';
import type { FRange } from './f-range';
import type { FWorkbook } from './f-workbook';
import type { FWorksheet } from './f-worksheet';
import { FEventName } from '@univerjs/core/facade';
/**
 * Interface for sheet-related events
 * Provides event names for sheet creation, workbook creation, and gridline changes
 * @ignore
 */
export interface IFSheetsEventNameMixin {
    /**
     * Event fired after a sheet is created
     * @see {@link ISheetCreatedEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.SheetCreated, (params) => {
     *   const { workbook, worksheet } = params;
     *   console.log('sheet created', params);
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly SheetCreated: 'SheetCreated';
    /**
     * Event fired before a sheet is created
     * @see {@link IBeforeSheetCreateEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.BeforeSheetCreate, (params) => {
     *   const { workbook, index, sheet } = params;
     *   console.log('before sheet create', params);
     *
     *   // Cancel the sheet creation operation
     *   params.cancel = true;
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly BeforeSheetCreate: 'BeforeSheetCreate';
    /**
     * Event fired before the active sheet changes
     * @see {@link IBeforeActiveSheetChangeEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.BeforeActiveSheetChange, (params) => {
     *   const { workbook, activeSheet, oldActiveSheet } = params;
     *   console.log('before active sheet change', params);
     *
     *   // Cancel the active sheet change operation
     *   params.cancel = true;
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly BeforeActiveSheetChange: 'BeforeActiveSheetChange';
    /**
     * Event fired after the active sheet changes
     * @see {@link IActiveSheetChangedEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.ActiveSheetChanged, (params) => {
     *   const { workbook, activeSheet } = params;
     *   console.log('after active sheet changed', params);
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly ActiveSheetChanged: 'ActiveSheetChanged';
    /**
     * Event fired after a sheet is deleted
     * @see {@link ISheetDeletedEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.SheetDeleted, (params) => {
     *   const { workbook, sheetId } = params;
     *   console.log('sheet deleted', params);
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly SheetDeleted: 'SheetDeleted';
    /**
     * Event fired before a sheet is deleted
     * @see {@link IBeforeSheetDeleteEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.BeforeSheetDelete, (params) => {
     *   const { workbook, worksheet } = params;
     *   console.log('before sheet delete', params);
     *
     *   // Cancel the sheet deletion operation
     *   params.cancel = true;
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly BeforeSheetDelete: 'BeforeSheetDelete';
    /**
     * Event fired after a sheet is moved
     * @see {@link ISheetMovedEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.SheetMoved, (params) => {
     *   const { workbook, worksheet, newIndex } = params;
     *   console.log('sheet moved', params);
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly SheetMoved: 'SheetMoved';
    /**
     * Event fired before a sheet is moved
     * @see {@link IBeforeSheetMoveEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.BeforeSheetMove, (params) => {
     *   const { workbook, worksheet, newIndex, oldIndex } = params;
     *   console.log('before sheet move', params);
     *
     *   // Cancel the sheet move operation
     *   params.cancel = true;
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly BeforeSheetMove: 'BeforeSheetMove';
    /**
     * Event fired after a sheet name is changed
     * @see {@link ISheetNameChangedEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.SheetNameChanged, (params) => {
     *   const { workbook, worksheet, newName } = params;
     *   console.log('sheet name changed', params);
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly SheetNameChanged: 'SheetNameChanged';
    /**
     * Event fired before a sheet name is changed
     * @see {@link IBeforeSheetNameChangeEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.BeforeSheetNameChange, (params) => {
     *   const { workbook, worksheet, newName, oldName } = params;
     *   console.log('before sheet name change', params);
     *
     *   // Cancel the sheet name change operation
     *   params.cancel = true;
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly BeforeSheetNameChange: 'BeforeSheetNameChange';
    /**
     * Event fired after a sheet tab color is changed
     * @see {@link ISheetTabColorChangedEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.SheetTabColorChanged, (params) => {
     *   const { workbook, worksheet, newColor } = params;
     *   console.log('sheet tab color changed', params);
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly SheetTabColorChanged: 'SheetTabColorChanged';
    /**
     * Event fired before a sheet tab color is changed
     * @see {@link IBeforeSheetTabColorChangeEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.BeforeSheetTabColorChange, (params) => {
     *   const { workbook, worksheet, newColor, oldColor } = params;
     *   console.log('before sheet tab color change', params);
     *
     *   // Cancel the sheet tab color change operation
     *   params.cancel = true;
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly BeforeSheetTabColorChange: 'BeforeSheetTabColorChange';
    /**
     * Event fired after a sheet is hidden
     * @see {@link ISheetHideChangedEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.SheetHideChanged, (params) => {
     *   const { workbook, worksheet, hidden } = params;
     *   console.log('sheet hide changed', params);
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly SheetHideChanged: 'SheetHideChanged';
    /**
     * Event fired before a sheet is hidden
     * @see {@link IBeforeSheetHideChangeEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.BeforeSheetHideChange, (params) => {
     *   const { workbook, worksheet, hidden } = params;
     *   console.log('before sheet hide change', params);
     *
     *   // Cancel the sheet hide operation
     *   params.cancel = true;
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly BeforeSheetHideChange: 'BeforeSheetHideChange';
    /**
     * Event fired after a workbook is created
     * @see {@link IWorkbookCreateEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.WorkbookCreated, (params) => {
     *   const { unitId, type, workbook, unit } = params;
     *   console.log('workbook created', params);
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly WorkbookCreated: 'WorkbookCreated';
    /**
     * Event fired after a workbook is disposed
     * @see {@link IWorkbookDisposedEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.WorkbookDisposed, (params) => {
     *   const { unitId, unitType, snapshot } = params;
     *   console.log('workbook disposed', params);
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly WorkbookDisposed: 'WorkbookDisposed';
    /**
     * Event fired when gridline changed
     * @see {@link IGridlineChangedEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.GridlineChanged, (params) => {
     *   const { workbook, worksheet, enabled, color } = params;
     *   console.log('gridline changed', params);
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly GridlineChanged: 'GridlineChanged';
    /**
     * Event fired before gridline enable changed
     * @see {@link IBeforeGridlineEnableChangeEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.BeforeGridlineEnableChange, (params) => {
     *   const { workbook, worksheet, enabled } = params;
     *   console.log('before gridline enable change', params);
     *
     *   // Cancel the gridline enable change operation
     *   params.cancel = true;
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly BeforeGridlineEnableChange: 'BeforeGridlineEnableChange';
    /**
     * Event fired before gridline color changed
     * @see {@link IBeforeGridlineColorChangedEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.BeforeGridlineColorChange, (params) => {
     *   const { workbook, worksheet, color } = params;
     *   console.log('before gridline color change', params);
     *
     *   // Cancel the gridline color change operation
     *   params.cancel = true;
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly BeforeGridlineColorChange: 'BeforeGridlineColorChange';
    /**
     * Event fired when sheet value changed
     * @see {@link ISheetValueChangedEventParams}
     * @example
     * ```ts
     * const disposable = univerAPI.addEvent(univerAPI.Event.SheetValueChanged, (params)=> {
     *   const { effectedRanges, payload } = params;
     *   console.log('sheet value changed', params);
     * });
     *
     * // Remove the event listener, use `disposable.dispose()`
     * ```
     */
    readonly SheetValueChanged: 'SheetValueChanged';
}
/**
 * Interface for workbook creation parameters
 * Extends the base event interface and includes workbook initialization details
 */
export interface IWorkbookCreateEventParams extends IEventBase {
    /** Unique identifier for the workbook unit */
    unitId: string;
    /** Type identifier specifying this is a sheet instance */
    type: UniverInstanceType.UNIVER_SHEET;
    /** The workbook instance being created */
    workbook: FWorkbook;
    /** The workbook unit reference */
    unit: FWorkbook;
}
/**
 * Interface for workbook disposal event
 * Contains information about the disposed workbook including its snapshot data
 */
export interface IWorkbookDisposedEventParams extends IEventBase {
    /** Unique identifier of the disposed workbook unit */
    unitId: string;
    /** Type identifier specifying this was a sheet instance */
    unitType: UniverInstanceType.UNIVER_SHEET;
    /** Snapshot data of the workbook at the time of disposal */
    snapshot: IWorkbookData;
}
/**
 * Interface for gridline change event
 * Triggered when gridline visibility or color changes in a worksheet
 */
export interface IGridlineChangedEventParams extends IEventBase {
    /** The workbook instance containing the worksheet */
    workbook: FWorkbook;
    /** The worksheet where gridline changes occurred */
    worksheet: FWorksheet;
    /** Flag indicating whether gridlines are enabled or disabled */
    enabled: boolean;
    /** The color of the gridlines, undefined if using default color */
    color: string | undefined;
}
/**
 * Interface for event before gridline enable/disable
 * Triggered before changing the gridline visibility state
 */
export interface IBeforeGridlineEnableChangeEventParams extends IEventBase {
    /** The workbook instance containing the worksheet */
    workbook: FWorkbook;
    /** The worksheet where gridline state will change */
    worksheet: FWorksheet;
    /** The new enabled state to be applied */
    enabled: boolean;
}
/**
 * Interface for event before gridline color change
 * Triggered before changing the gridline color
 */
export interface IBeforeGridlineColorChangedEventParams extends IEventBase {
    /** The workbook instance containing the worksheet */
    workbook: FWorkbook;
    /** The worksheet where gridline color will change */
    worksheet: FWorksheet;
    /** The new color to be applied, undefined to use default color */
    color: string | undefined;
}
/**
 * Interface for event parameters triggered before creating a new worksheet
 * Extends the base event interface and includes workbook and worksheet details
 */
export interface IBeforeSheetCreateEventParams extends IEventBase {
    /** The workbook instance */
    workbook: FWorkbook;
    /** Optional index where the new sheet will be inserted */
    index?: number;
    /** Optional initial worksheet data */
    sheet?: IWorksheetData;
}
/**
 * Interface for event parameters triggered after a worksheet is created
 * Extends the base event interface and includes workbook and worksheet details
 */
export interface ISheetCreatedEventParams extends IEventBase {
    /** The workbook instance */
    workbook: FWorkbook;
    /** The newly created worksheet */
    worksheet: FWorksheet;
}
/**
 * Interface for sheet active change event
 * Contains information about the sheet that will become active
 */
export interface IBeforeActiveSheetChangeEventParams extends IEventBase {
    /** The workbook instance containing the worksheet */
    workbook: FWorkbook;
    /** The worksheet that will become active */
    activeSheet: FWorksheet;
    /** The currently active worksheet */
    oldActiveSheet: FWorksheet;
}
/**
 * Interface for sheet active changed event
 * Contains information about the newly activated sheet
 */
export interface IActiveSheetChangedEventParams extends IEventBase {
    /** The workbook instance containing the worksheet */
    workbook: FWorkbook;
    /** The worksheet that has become active */
    activeSheet: FWorksheet;
}
/**
 * Interface for sheet deletion event
 * Contains information about the sheet that was deleted
 */
export interface ISheetDeletedEventParams extends IEventBase {
    /** The workbook instance containing the worksheet */
    workbook: FWorkbook;
    /** The worksheet that was deleted */
    sheetId: string;
}
/**
 * Interface for before sheet deletion event
 * Contains information about the sheet that will be deleted
 */
export interface IBeforeSheetDeleteEventParams extends IEventBase {
    /** The workbook instance containing the worksheet */
    workbook: FWorkbook;
    /** The worksheet that will be deleted */
    worksheet: FWorksheet;
}
/**
 * Interface for sheet moved event
 * Contains information about the sheet movement
 */
export interface ISheetMovedEventParams extends IEventBase {
    /** The workbook instance containing the worksheet */
    workbook: FWorkbook;
    /** The worksheet that was moved */
    worksheet: FWorksheet;
    /** The new position index of the sheet */
    newIndex: number;
}
/**
 * Interface for before sheet move event
 * Contains information about the planned sheet movement
 */
export interface IBeforeSheetMoveEventParams extends IEventBase {
    /** The workbook instance containing the worksheet */
    workbook: FWorkbook;
    /** The worksheet that will be moved */
    worksheet: FWorksheet;
    /** The target position index for the sheet */
    newIndex: number;
    /** The current position index of the sheet */
    oldIndex: number;
}
/**
 * Interface for sheet name change event
 * Contains information about the sheet name change
 */
export interface ISheetNameChangedEventParams extends IEventBase {
    /** The workbook instance containing the worksheet */
    workbook: FWorkbook;
    /** The worksheet whose name was changed */
    worksheet: FWorksheet;
    /** The new name of the sheet */
    newName: string;
}
/**
 * Interface for before sheet name change event
 * Contains information about the planned sheet name change
 */
export interface IBeforeSheetNameChangeEventParams extends IEventBase {
    /** The workbook instance containing the worksheet */
    workbook: FWorkbook;
    /** The worksheet whose name will be changed */
    worksheet: FWorksheet;
    /** The new name to be applied */
    newName: string;
    /** The current name of the sheet */
    oldName: string;
}
/**
 * Interface for sheet tab color change event
 * Contains information about the sheet tab color change
 */
export interface ISheetTabColorChangedEventParams extends IEventBase {
    /** The workbook instance containing the worksheet */
    workbook: FWorkbook;
    /** The worksheet whose tab color was changed */
    worksheet: FWorksheet;
    /** The new color of the sheet tab */
    newColor: string | undefined;
}
/**
 * Interface for before sheet tab color change event
 * Contains information about the planned sheet tab color change
 */
export interface IBeforeSheetTabColorChangeEventParams extends IEventBase {
    /** The workbook instance containing the worksheet */
    workbook: FWorkbook;
    /** The worksheet whose tab color will be changed */
    worksheet: FWorksheet;
    /** The new color to be applied */
    newColor: string | undefined;
    /** The current color of the sheet tab */
    oldColor: string | undefined;
}
/**
 * Interface for sheet hide state change event
 * Contains information about the sheet visibility change
 */
export interface ISheetHideChangedEventParams extends IEventBase {
    /** The workbook instance containing the worksheet */
    workbook: FWorkbook;
    /** The worksheet whose visibility was changed */
    worksheet: FWorksheet;
    /** The new visibility state */
    hidden: boolean;
}
/**
 * Interface for before sheet hide state change event
 * Contains information about the planned sheet visibility change
 */
export interface IBeforeSheetHideChangeEventParams extends IEventBase {
    /** The workbook instance containing the worksheet */
    workbook: FWorkbook;
    /** The worksheet whose visibility will be changed */
    worksheet: FWorksheet;
    /** The new visibility state to be applied */
    hidden: boolean;
}
/**
 * Interface for sheet value changed event
 * Contains information about the sheet value change
 */
export interface ISheetValueChangedEventParams extends IEventBase {
    /** The affected ranges of the sheet */
    effectedRanges: FRange[];
    /** The payload of the value change */
    payload: CommandListenerValueChange;
}
/**
 * Configuration interface for sheet-related events
 * Provides event names and their corresponding event parameter interfaces
 * @ignore
 */
export interface ISheetsEventParamConfig {
    /** Event fired after a worksheet is created */
    SheetCreated: ISheetCreatedEventParams;
    /** Event fired before creating a worksheet */
    BeforeSheetCreate: IBeforeSheetCreateEventParams;
    /** Event fired after a workbook is created */
    WorkbookCreated: IWorkbookCreateEventParams;
    /** Event fired when a workbook is disposed */
    WorkbookDisposed: IWorkbookDisposedEventParams;
    /** Event fired when gridline changed */
    GridlineChanged: IGridlineChangedEventParams;
    /** Event fired before gridline enable changed */
    BeforeGridlineEnableChange: IBeforeGridlineEnableChangeEventParams;
    /** Event fired before gridline color changed */
    BeforeGridlineColorChange: IBeforeGridlineColorChangedEventParams;
    /** Event fired before active sheet changes */
    BeforeActiveSheetChange: IBeforeActiveSheetChangeEventParams;
    /** Event fired after active sheet changed */
    ActiveSheetChanged: IActiveSheetChangedEventParams;
    /** Event fired after a sheet is deleted */
    SheetDeleted: ISheetDeletedEventParams;
    /** Event fired before a sheet is deleted */
    BeforeSheetDelete: IBeforeSheetDeleteEventParams;
    /** Event fired after a sheet is moved */
    SheetMoved: ISheetMovedEventParams;
    /** Event fired before a sheet is moved */
    BeforeSheetMove: IBeforeSheetMoveEventParams;
    /** Event fired after a sheet name is changed */
    SheetNameChanged: ISheetNameChangedEventParams;
    /** Event fired before a sheet name is changed */
    BeforeSheetNameChange: IBeforeSheetNameChangeEventParams;
    /** Event fired after a sheet tab color is changed */
    SheetTabColorChanged: ISheetTabColorChangedEventParams;
    /** Event fired before a sheet tab color is changed */
    BeforeSheetTabColorChange: IBeforeSheetTabColorChangeEventParams;
    /** Event fired after a sheet visibility is changed */
    SheetHideChanged: ISheetHideChangedEventParams;
    /** Event fired before a sheet visibility is changed */
    BeforeSheetHideChange: IBeforeSheetHideChangeEventParams;
    /** Event fired after a sheet value is changed */
    SheetValueChanged: ISheetValueChangedEventParams;
}
export declare class FSheetsEventNameMixin extends FEventName implements IFSheetsEventNameMixin {
    get SheetCreated(): 'SheetCreated';
    get BeforeSheetCreate(): 'BeforeSheetCreate';
    get WorkbookCreated(): 'WorkbookCreated';
    get WorkbookDisposed(): 'WorkbookDisposed';
    get GridlineChanged(): 'GridlineChanged';
    get BeforeGridlineEnableChange(): 'BeforeGridlineEnableChange';
    get BeforeGridlineColorChange(): 'BeforeGridlineColorChange';
    get BeforeActiveSheetChange(): 'BeforeActiveSheetChange';
    get ActiveSheetChanged(): 'ActiveSheetChanged';
    get SheetDeleted(): 'SheetDeleted';
    get BeforeSheetDelete(): 'BeforeSheetDelete';
    get SheetMoved(): 'SheetMoved';
    get BeforeSheetMove(): 'BeforeSheetMove';
    get SheetNameChanged(): 'SheetNameChanged';
    get BeforeSheetNameChange(): 'BeforeSheetNameChange';
    get SheetTabColorChanged(): 'SheetTabColorChanged';
    get BeforeSheetTabColorChange(): 'BeforeSheetTabColorChange';
    get SheetHideChanged(): 'SheetHideChanged';
    get BeforeSheetHideChange(): 'BeforeSheetHideChange';
    get SheetValueChanged(): 'SheetValueChanged';
}
declare module '@univerjs/core/facade' {
    interface FEventName extends IFSheetsEventNameMixin {
    }
    interface IEventParamConfig extends ISheetsEventParamConfig {
    }
}