/**
 * 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 { FRange } from '@univerjs/sheets/facade';
export interface ICellHyperLink {
    id: string;
    row: number;
    column: number;
    url: string;
    label: string;
    tooltip?: string;
}
/**
 * @ignore
 */
export interface IFRangeSheetsHyperlinkMixin {
    /**
     * Set a hyperlink for this range top left cell.
     * The hyperlink can be a URL, a range link, or a sheet link.
     * When the hyperlink is a range link or a sheet link, the url should be the url of the target range or sheet.
     * @param {string} url - The hyperlink url, can be a URL, a range link, or a sheet link.
     * @param {string} [label] - The display text of the hyperlink. If omitted, the existing cell text is linked. Supply a label when linking an empty cell.
     * @param {string} [tooltip] - Optional text shown inside the hyperlink popup.
     * @return {Promise<boolean>} A promise that resolves to true if the hyperlink is set successfully, otherwise false.
     *
     * @example
     * ```ts
     * const fWorkbook = univerAPI.getActiveWorkbook();
     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
     * if (!fWorksheet) return;
     *
     * // Create a hyperlink to Univer on cell A1
     * const fRange = fWorksheet.getRange('A1');
     * await fRange.setHyperLink('https://univer.ai/', 'Univer');
     *
     * // Create a hyperlink to Sheet1 range B2:D4 on cell A2
     * const fRange2 = fWorksheet.getRange('A2');
     * const rangeUrl = fWorksheet.getRange('B2:D4').getUrl();
     * await fRange2.setHyperLink(rangeUrl, 'Link to B2:D4');
     *
     * // Create a hyperlink to another sheet range on cell A3
     * const anotherSheet = fWorkbook.getSheetByName('Another Sheet');
     * if (anotherSheet) {
     *   const anotherSheetUrl = anotherSheet.getUrl();
     *   const fRange3 = fWorksheet.getRange('A3');
     *   await fRange3.setHyperLink(anotherSheetUrl, 'Link to Another Sheet');
     * }
     *
     * // Create a hyperlink to a defined name on cell A4
     * const fRange4 = fWorksheet.getRange('A4');
     * const definedNameHyperlinkUrl = fWorkbook.getUrlOfDefineName('MyDefinedName');
     * await fRange4.setHyperLink(definedNameHyperlinkUrl, 'Link to MyDefinedName');
     * ```
     */
    setHyperLink(url: string, label?: string, tooltip?: string): Promise<boolean>;
    /**
     * Gets the first hyperlink from each cell containing hyperlinks in this range.
     * @returns {ICellHyperLink[]} At most one hyperlink per cell, with absolute, zero-based worksheet coordinates.
     *
     * @example
     * ```ts
     * const fWorkbook = univerAPI.getActiveWorkbook();
     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
     * if (!fWorksheet) return;
     * console.log(fWorksheet.getRange('A1:T100').getHyperLinks());
     * ```
     */
    getHyperLinks(): ICellHyperLink[];
    /**
     * Update the hyperlink of this range top left cell.
     * @param {string} url - The new hyperlink url, can be a URL, a range link, or a sheet link.
     * @param {string} [label] - The new display text of the hyperlink. If omitted, the existing hyperlink label is preserved.
     * @param {string} [tooltip] - Omit to preserve the current tooltip; use an empty string to clear it.
     *
     * @returns {Promise<boolean>} A promise resolving to whether the update succeeded.
     * @throws {Error} The promise rejects if the top-left cell contains no hyperlink.
     * @example
     * ```ts
     * const fWorkbook = univerAPI.getActiveWorkbook();
     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
     * if (!fWorksheet) return;
     *
     * // Create a hyperlink to Univer on cell A1
     * const fRange = fWorksheet.getRange('A1');
     * await fRange.setHyperLink('https://univer.ai/', 'Univer');
     *
     * // Update hyperlink after 3 seconds
     * await new Promise((resolve) => setTimeout(resolve, 3000));
     *
     * const rangeUrl = fWorksheet.getRange('B2:D4').getUrl();
     * await fRange.updateHyperLink(rangeUrl, 'Link to B2:D4');
     * ```
     */
    updateHyperLink(url: string, label?: string, tooltip?: string): Promise<boolean>;
    /**
     * Cancel all hyperlinks in this range. If a hyperlink is provided, only cancel the specified hyperlink.
     * @param {ICellHyperLink} [hyperlink] - The hyperlink to be cancelled. If not provided, all hyperlinks in this range will be cancelled.
     * @return {boolean} True if the hyperlink(s) is cancelled successfully, otherwise false.
     *
     * @example
     * ```ts
     * const fWorkbook = univerAPI.getActiveWorkbook();
     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
     * if (!fWorksheet) return;
     *
     * // Cancel the hyperlink in cell A1
     * const fRange = fWorksheet.getRange('A1');
     * fRange.cancelHyperLink();
     *
     * // Cancel all hyperlinks in range A2:B4
     * const fRange2 = fWorksheet.getRange('A2:B4');
     * fRange2.cancelHyperLink();
     *
     * // Cancel a specific hyperlink in range A1:T100
     * const fRange3 = fWorksheet.getRange('A1:T100');
     * const hyperlinks = fRange3.getHyperLinks();
     * if (hyperlinks.length > 1) {
     *   fRange3.cancelHyperLink(hyperlinks[1]);
     * }
     * ```
     */
    cancelHyperLink(hyperlink?: ICellHyperLink): boolean;
    /**
     * Create a hyperlink url to this range
     * @returns {string} The hyperlink url of this range
     *
     * @example
     * ```ts
     * const fWorkbook = univerAPI.getActiveWorkbook();
     * const fWorksheet = fWorkbook.getSheetByName('Sheet1');
     * if (!fWorksheet) return;
     * const fRange = fWorksheet.getRange('A1');
     * const url = fRange.getUrl();
     * console.log(url);
     * ```
     */
    getUrl(): string;
}
export declare class FRangeSheetsHyperlinkMixin extends FRange implements IFRangeSheetsHyperlinkMixin {
    setHyperLink(url: string, label?: string, tooltip?: string): Promise<boolean>;
    getHyperLinks(): ICellHyperLink[];
    updateHyperLink(url: string, label?: string, tooltip?: string): Promise<boolean>;
    cancelHyperLink(hyperlink?: ICellHyperLink): boolean;
    getUrl(): string;
}
declare module '@univerjs/sheets/facade' {
    interface FRange extends IFRangeSheetsHyperlinkMixin {
    }
}