@univerjs/sheets-hyper-link 0.23.0 → 0.24.0-insiders.20260528-29f582d

package/lib/cjs/facade.js

@@ -1,44 +1,20 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-let _univerjs_core = require("@univerjs/core");
+let _univerjs_engine_formula = require("@univerjs/engine-formula");
 let _univerjs_sheets_hyper_link = require("@univerjs/sheets-hyper-link");
 let _univerjs_sheets_facade = require("@univerjs/sheets/facade");
+let _univerjs_core = require("@univerjs/core");
 let _univerjs_core_facade = require("@univerjs/core/facade");
 
-//#region \0@oxc-project+runtime@0.129.0/helpers/decorateParam.js
-function __decorateParam(paramIndex, decorator) {
-	return function(target, key) {
-		decorator(target, key, paramIndex);
-	};
-}
-
-//#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/decorate.js
-function __decorate(decorators, target, key, desc) {
-	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-	return c > 3 && r && Object.defineProperty(target, key, r), r;
-}
-
-//#endregion
 //#region src/facade/f-workbook.ts
-let SheetHyperLinkBuilder = class SheetHyperLinkBuilder {
-	constructor(_workbook, _parserService) {
-		this._workbook = _workbook;
-		this._parserService = _parserService;
-	}
-	getRangeUrl(range) {
-		this._parserService.buildHyperLink(this._workbook.getId(), range.getSheetId(), range.getRange());
-		return this;
-	}
-};
-SheetHyperLinkBuilder = __decorate([__decorateParam(1, (0, _univerjs_core.Inject)(_univerjs_sheets_hyper_link.SheetsHyperLinkParserService))], SheetHyperLinkBuilder);
 var FWorkbookHyperlinkMixin = class extends _univerjs_sheets_facade.FWorkbook {
-	/**
-	* Parse the hyperlink string to get the hyperlink info.
-	* @param {string} hyperlink the hyperlink string
-	* @returns {ISheetHyperLinkInfo} the hyperlink info
-	*/
+	getUrlOfDefineName(name) {
+		const definedNameService = this._injector.get(_univerjs_engine_formula.IDefinedNamesService);
+		const parserService = this._injector.get(_univerjs_sheets_hyper_link.SheetsHyperLinkParserService);
+		const definedName = definedNameService.getValueByName(this._workbook.getUnitId(), name);
+		if (!definedName) throw new Error(`Defined name "${name}" does not exist.`);
+		if (definedName.formulaOrRefString.startsWith(_univerjs_engine_formula.operatorToken.EQUALS)) throw new Error(`Defined name "${name}" is not a reference range, cannot be converted to hyperlink.`);
+		return parserService.buildHyperLink(definedName.id);
+	}
 	parseSheetHyperlink(hyperlink) {
 		return this._injector.get(_univerjs_sheets_hyper_link.SheetsHyperLinkParserService).parseHyperLink(hyperlink);
 	}
@@ -64,7 +40,7 @@ _univerjs_sheets_facade.FWorkbook.extend(FWorkbookHyperlinkMixin);
 */
 var FWorksheetHyperlinkMixin = class extends _univerjs_sheets_facade.FWorksheet {
 	getUrl() {
-		return this._injector.get(_univerjs_sheets_hyper_link.SheetsHyperLinkParserService).buildHyperLink(this._workbook.getUnitId(), this._worksheet.getSheetId());
+		return this._injector.get(_univerjs_sheets_hyper_link.SheetsHyperLinkParserService).buildHyperLink(null, this._worksheet.getSheetId());
 	}
 };
 _univerjs_sheets_facade.FWorksheet.extend(FWorksheetHyperlinkMixin);
@@ -73,60 +49,84 @@ _univerjs_sheets_facade.FWorksheet.extend(FWorksheetHyperlinkMixin);
 //#region src/facade/f-range.ts
 var FRangeSheetsHyperlinkMixin = class extends _univerjs_sheets_facade.FRange {
 	setHyperLink(url, label) {
-		const params = {
+		return this._commandService.executeCommand(_univerjs_sheets_hyper_link.AddHyperLinkCommand.id, {
 			unitId: this.getUnitId(),
 			subUnitId: this._worksheet.getSheetId(),
 			link: {
+				id: (0, _univerjs_core.generateRandomId)(),
 				row: this._range.startRow,
 				column: this._range.startColumn,
 				payload: url,
-				display: label,
-				id: (0, _univerjs_core.generateRandomId)()
+				display: label
 			}
-		};
-		return this._commandService.executeCommand(_univerjs_sheets_hyper_link.AddHyperLinkCommand.id, params);
+		});
 	}
 	getHyperLinks() {
-		var _cellValue$p$body$cus, _cellValue$p$body;
-		const cellValue = this._worksheet.getCellRaw(this._range.startRow, this._range.startColumn);
-		if (!(cellValue === null || cellValue === void 0 ? void 0 : cellValue.p)) return [];
-		return (_cellValue$p$body$cus = (_cellValue$p$body = cellValue.p.body) === null || _cellValue$p$body === void 0 || (_cellValue$p$body = _cellValue$p$body.customRanges) === null || _cellValue$p$body === void 0 ? void 0 : _cellValue$p$body.filter((range) => range.rangeType === _univerjs_core.CustomRangeType.HYPERLINK).map((range) => {
-			var _range$properties$url, _range$properties, _cellValue$p$body$dat, _cellValue$p;
-			return {
-				id: `${range.rangeId}`,
-				startIndex: range.startIndex,
-				endIndex: range.endIndex,
-				url: (_range$properties$url = (_range$properties = range.properties) === null || _range$properties === void 0 ? void 0 : _range$properties.url) !== null && _range$properties$url !== void 0 ? _range$properties$url : "",
-				label: (_cellValue$p$body$dat = (_cellValue$p = cellValue.p) === null || _cellValue$p === void 0 || (_cellValue$p = _cellValue$p.body) === null || _cellValue$p === void 0 ? void 0 : _cellValue$p.dataStream.slice(range.startIndex, range.endIndex + 1).replaceAll(_univerjs_core.DataStreamTreeTokenType.CUSTOM_RANGE_START, "").replaceAll(_univerjs_core.DataStreamTreeTokenType.CUSTOM_RANGE_END, "")) !== null && _cellValue$p$body$dat !== void 0 ? _cellValue$p$body$dat : ""
-			};
-		})) !== null && _cellValue$p$body$cus !== void 0 ? _cellValue$p$body$cus : [];
+		const hyperlinks = [];
+		this.forEach((row, column, cell) => {
+			var _cell$p$body$customRa, _cell$p$body;
+			if (!cell.p) return;
+			const ranges = (_cell$p$body$customRa = (_cell$p$body = cell.p.body) === null || _cell$p$body === void 0 || (_cell$p$body = _cell$p$body.customRanges) === null || _cell$p$body === void 0 ? void 0 : _cell$p$body.filter((range) => range.rangeType === _univerjs_core.CustomRangeType.HYPERLINK)) !== null && _cell$p$body$customRa !== void 0 ? _cell$p$body$customRa : [];
+			if (ranges.length > 0) {
+				var _cell$p, _properties$url, _dataStream$slice$rep;
+				const dataStream = (_cell$p = cell.p) === null || _cell$p === void 0 || (_cell$p = _cell$p.body) === null || _cell$p === void 0 ? void 0 : _cell$p.dataStream;
+				const { rangeId, properties, startIndex, endIndex } = ranges[0];
+				const url = (_properties$url = properties === null || properties === void 0 ? void 0 : properties.url) !== null && _properties$url !== void 0 ? _properties$url : "";
+				const label = (_dataStream$slice$rep = dataStream === null || dataStream === void 0 ? void 0 : dataStream.slice(startIndex, endIndex + 1).replaceAll(_univerjs_core.DataStreamTreeTokenType.CUSTOM_RANGE_START, "").replaceAll(_univerjs_core.DataStreamTreeTokenType.CUSTOM_RANGE_END, "")) !== null && _dataStream$slice$rep !== void 0 ? _dataStream$slice$rep : "";
+				hyperlinks.push({
+					id: `${rangeId}`,
+					row,
+					column,
+					url,
+					label
+				});
+			}
+		});
+		return hyperlinks;
 	}
-	updateHyperLink(id, url, label) {
-		const params = {
+	updateHyperLink(url, label) {
+		const hyperlink = this.getHyperLinks().find((link) => link.row === this._range.startRow && link.column === this._range.startColumn);
+		if (!hyperlink) return Promise.reject(/* @__PURE__ */ new Error("No hyperlink found in the top left cell of the range"));
+		const { id, row, column } = hyperlink;
+		return this._commandService.executeCommand(_univerjs_sheets_hyper_link.UpdateHyperLinkCommand.id, {
 			unitId: this.getUnitId(),
 			subUnitId: this._worksheet.getSheetId(),
-			row: this._range.startRow,
-			column: this._range.startColumn,
 			id,
+			row,
+			column,
 			payload: {
 				payload: url,
 				display: label
 			}
-		};
-		return this._commandService.executeCommand(_univerjs_sheets_hyper_link.UpdateHyperLinkCommand.id, params);
+		});
 	}
-	cancelHyperLink(id) {
-		const params = {
-			unitId: this.getUnitId(),
-			subUnitId: this._worksheet.getSheetId(),
-			row: this._range.startRow,
-			column: this._range.startColumn,
-			id
-		};
-		return this._commandService.syncExecuteCommand(_univerjs_sheets_hyper_link.CancelHyperLinkCommand.id, params);
+	cancelHyperLink(hyperlink) {
+		if (hyperlink) {
+			const { id, row, column } = hyperlink;
+			return this._commandService.syncExecuteCommand(_univerjs_sheets_hyper_link.CancelHyperLinkCommand.id, {
+				unitId: this.getUnitId(),
+				subUnitId: this._worksheet.getSheetId(),
+				id,
+				row,
+				column
+			});
+		} else {
+			const hyperlinks = this.getHyperLinks();
+			if (hyperlinks.length === 0) return true;
+			return hyperlinks.every((link) => {
+				const { id, row, column } = link;
+				return this._commandService.syncExecuteCommand(_univerjs_sheets_hyper_link.CancelHyperLinkCommand.id, {
+					unitId: this.getUnitId(),
+					subUnitId: this._worksheet.getSheetId(),
+					id,
+					row,
+					column
+				});
+			});
+		}
 	}
 	getUrl() {
-		return this._injector.get(_univerjs_sheets_hyper_link.SheetsHyperLinkParserService).buildHyperLink(this.getUnitId(), this.getSheetId(), this.getRange());
+		return this._injector.get(_univerjs_sheets_hyper_link.SheetsHyperLinkParserService).buildHyperLink(this.getRange(), this.getSheetId());
 	}
 };
 _univerjs_sheets_facade.FRange.extend(FRangeSheetsHyperlinkMixin);

package/lib/cjs/index.js

@@ -706,7 +706,7 @@ const UpdateRichHyperLinkMutation = {
 //#endregion
 //#region package.json
 var name = "@univerjs/sheets-hyper-link";
-var version = "0.23.0";
+var version = "0.24.0-insiders.20260528-29f582d";
 
 //#endregion
 //#region src/config/config.ts
@@ -1003,7 +1003,7 @@ let SheetsHyperLinkRemoveSheetController = class SheetsHyperLinkRemoveSheetContr
 			if (commandInfo.id === _univerjs_sheets.RemoveSheetCommand.id) {
 				var _workbook$getActiveSh;
 				const params = commandInfo.params;
-				const workbook = params.unitId ? this._univerInstanceService.getUnit(params.unitId) : this._univerInstanceService.getCurrentUnitForType(_univerjs_core.UniverInstanceType.UNIVER_SHEET);
+				const workbook = params.unitId ? this._univerInstanceService.getUnit(params.unitId) : this._univerInstanceService.getCurrentUnitOfType(_univerjs_core.UniverInstanceType.UNIVER_SHEET);
 				if (!workbook) return {
 					redos: [],
 					undos: []
@@ -1456,8 +1456,11 @@ let SheetsHyperLinkParserService = class SheetsHyperLinkParserService {
 		this._localeService = _localeService;
 		this._definedNamesService = _definedNamesService;
 	}
-	buildHyperLink(unitId, sheetId, range) {
-		return `#${"gid"}=${sheetId}${range ? `&${typeof range === "string" ? "rangeid" : "range"}=${typeof range === "string" ? range : (0, _univerjs_engine_formula.serializeRange)(range)}` : ""}`;
+	buildHyperLink(defineNameIdOrRange, sheetId) {
+		if (typeof defineNameIdOrRange === "string") return `#${"rangeid"}=${defineNameIdOrRange}`;
+		let result = `#${"gid"}=${sheetId}`;
+		if (defineNameIdOrRange) result += `&${"range"}=${(0, _univerjs_engine_formula.serializeRange)(defineNameIdOrRange)}`;
+		return result;
 	}
 	parseHyperLink(urlStr) {
 		if (urlStr.startsWith("#")) {
@@ -1486,10 +1489,10 @@ let SheetsHyperLinkParserService = class SheetsHyperLinkParserService {
 	_getURLName(params) {
 		var _sheet$getName;
 		const { gid, range, rangeid, unitid } = params;
-		const workbook = unitid ? this._univerInstanceService.getUnit(unitid, _univerjs_core.UniverInstanceType.UNIVER_SHEET) : this._univerInstanceService.getCurrentUnitForType(_univerjs_core.UniverInstanceType.UNIVER_SHEET);
+		const workbook = unitid ? this._univerInstanceService.getUnit(unitid, _univerjs_core.UniverInstanceType.UNIVER_SHEET) : this._univerInstanceService.getCurrentUnitOfType(_univerjs_core.UniverInstanceType.UNIVER_SHEET);
 		const invalidLink = {
 			type: "invalid",
-			name: this._localeService.t("hyperLink.message.refError")
+			name: this._localeService.t("sheets-hyper-link.message.refError")
 		};
 		if (!workbook) return invalidLink;
 		const sheet = gid ? workbook.getSheetBySheetId(gid) : workbook.getActiveSheet();

package/lib/cjs/locale/ar-SA.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/ar-SA.ts
+const locale = { "sheets-hyper-link": { message: { refError: "نطاق غير صالح" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/ca-ES.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/ca-ES.ts
+const locale = { "sheets-hyper-link": { message: { refError: "Interval no vàlid" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/de-DE.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/de-DE.ts
+const locale = { "sheets-hyper-link": { message: { refError: "Ungültiger Bereich" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/en-US.js

@@ -0,0 +1,21 @@
+
+//#region src/locale/en-US.ts
+/**
+* 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.
+*/
+const locale = { "sheets-hyper-link": { message: { refError: "Invalid Range" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/es-ES.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/es-ES.ts
+const locale = { "sheets-hyper-link": { message: { refError: "Rango no válido" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/fa-IR.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/fa-IR.ts
+const locale = { "sheets-hyper-link": { message: { refError: "محدوده نامعتبر" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/fr-FR.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/fr-FR.ts
+const locale = { "sheets-hyper-link": { message: { refError: "Plage invalide" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/id-ID.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/id-ID.ts
+const locale = { "sheets-hyper-link": { message: { refError: "Rentang Tidak Valid" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/it-IT.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/it-IT.ts
+const locale = { "sheets-hyper-link": { message: { refError: "Intervallo non valido" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/ja-JP.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/ja-JP.ts
+const locale = { "sheets-hyper-link": { message: { refError: "無効な範囲です" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/ko-KR.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/ko-KR.ts
+const locale = { "sheets-hyper-link": { message: { refError: "잘못된 범위입니다" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/pl-PL.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/pl-PL.ts
+const locale = { "sheets-hyper-link": { message: { refError: "Nieprawidłowy zakres" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/pt-BR.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/pt-BR.ts
+const locale = { "sheets-hyper-link": { message: { refError: "Intervalo Inválido" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/ru-RU.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/ru-RU.ts
+const locale = { "sheets-hyper-link": { message: { refError: "Недопустимый диапазон" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/sk-SK.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/sk-SK.ts
+const locale = { "sheets-hyper-link": { message: { refError: "Neplatný rozsah" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/vi-VN.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/vi-VN.ts
+const locale = { "sheets-hyper-link": { message: { refError: "Tham chiếu lỗi" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/zh-CN.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/zh-CN.ts
+const locale = { "sheets-hyper-link": { message: { refError: "错误的引用" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/zh-HK.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/zh-HK.ts
+const locale = { "sheets-hyper-link": { message: { refError: "錯誤的引用" } } };
+
+//#endregion
+module.exports = locale;

package/lib/cjs/locale/zh-TW.js

@@ -0,0 +1,6 @@
+
+//#region src/locale/zh-TW.ts
+const locale = { "sheets-hyper-link": { message: { refError: "錯誤的引用" } } };
+
+//#endregion
+module.exports = locale;

package/lib/es/facade.js

@@ -1,43 +1,19 @@
-import { CanceledError, CustomRangeType, DataStreamTreeTokenType, ICommandService, Inject, generateRandomId } from "@univerjs/core";
+import { IDefinedNamesService, operatorToken } from "@univerjs/engine-formula";
 import { AddHyperLinkCommand, CancelHyperLinkCommand, SheetsHyperLinkParserService, UpdateHyperLinkCommand } from "@univerjs/sheets-hyper-link";
 import { FRange, FWorkbook, FWorksheet } from "@univerjs/sheets/facade";
+import { CanceledError, CustomRangeType, DataStreamTreeTokenType, ICommandService, generateRandomId } from "@univerjs/core";
 import { FEventName, FUniver } from "@univerjs/core/facade";
 
-//#region \0@oxc-project+runtime@0.129.0/helpers/decorateParam.js
-function __decorateParam(paramIndex, decorator) {
-	return function(target, key) {
-		decorator(target, key, paramIndex);
-	};
-}
-
-//#endregion
-//#region \0@oxc-project+runtime@0.129.0/helpers/decorate.js
-function __decorate(decorators, target, key, desc) {
-	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-	return c > 3 && r && Object.defineProperty(target, key, r), r;
-}
-
-//#endregion
 //#region src/facade/f-workbook.ts
-let SheetHyperLinkBuilder = class SheetHyperLinkBuilder {
-	constructor(_workbook, _parserService) {
-		this._workbook = _workbook;
-		this._parserService = _parserService;
-	}
-	getRangeUrl(range) {
-		this._parserService.buildHyperLink(this._workbook.getId(), range.getSheetId(), range.getRange());
-		return this;
-	}
-};
-SheetHyperLinkBuilder = __decorate([__decorateParam(1, Inject(SheetsHyperLinkParserService))], SheetHyperLinkBuilder);
 var FWorkbookHyperlinkMixin = class extends FWorkbook {
-	/**
-	* Parse the hyperlink string to get the hyperlink info.
-	* @param {string} hyperlink the hyperlink string
-	* @returns {ISheetHyperLinkInfo} the hyperlink info
-	*/
+	getUrlOfDefineName(name) {
+		const definedNameService = this._injector.get(IDefinedNamesService);
+		const parserService = this._injector.get(SheetsHyperLinkParserService);
+		const definedName = definedNameService.getValueByName(this._workbook.getUnitId(), name);
+		if (!definedName) throw new Error(`Defined name "${name}" does not exist.`);
+		if (definedName.formulaOrRefString.startsWith(operatorToken.EQUALS)) throw new Error(`Defined name "${name}" is not a reference range, cannot be converted to hyperlink.`);
+		return parserService.buildHyperLink(definedName.id);
+	}
 	parseSheetHyperlink(hyperlink) {
 		return this._injector.get(SheetsHyperLinkParserService).parseHyperLink(hyperlink);
 	}
@@ -63,7 +39,7 @@ FWorkbook.extend(FWorkbookHyperlinkMixin);
 */
 var FWorksheetHyperlinkMixin = class extends FWorksheet {
 	getUrl() {
-		return this._injector.get(SheetsHyperLinkParserService).buildHyperLink(this._workbook.getUnitId(), this._worksheet.getSheetId());
+		return this._injector.get(SheetsHyperLinkParserService).buildHyperLink(null, this._worksheet.getSheetId());
 	}
 };
 FWorksheet.extend(FWorksheetHyperlinkMixin);
@@ -72,60 +48,84 @@ FWorksheet.extend(FWorksheetHyperlinkMixin);
 //#region src/facade/f-range.ts
 var FRangeSheetsHyperlinkMixin = class extends FRange {
 	setHyperLink(url, label) {
-		const params = {
+		return this._commandService.executeCommand(AddHyperLinkCommand.id, {
 			unitId: this.getUnitId(),
 			subUnitId: this._worksheet.getSheetId(),
 			link: {
+				id: generateRandomId(),
 				row: this._range.startRow,
 				column: this._range.startColumn,
 				payload: url,
-				display: label,
-				id: generateRandomId()
+				display: label
 			}
-		};
-		return this._commandService.executeCommand(AddHyperLinkCommand.id, params);
+		});
 	}
 	getHyperLinks() {
-		var _cellValue$p$body$cus, _cellValue$p$body;
-		const cellValue = this._worksheet.getCellRaw(this._range.startRow, this._range.startColumn);
-		if (!(cellValue === null || cellValue === void 0 ? void 0 : cellValue.p)) return [];
-		return (_cellValue$p$body$cus = (_cellValue$p$body = cellValue.p.body) === null || _cellValue$p$body === void 0 || (_cellValue$p$body = _cellValue$p$body.customRanges) === null || _cellValue$p$body === void 0 ? void 0 : _cellValue$p$body.filter((range) => range.rangeType === CustomRangeType.HYPERLINK).map((range) => {
-			var _range$properties$url, _range$properties, _cellValue$p$body$dat, _cellValue$p;
-			return {
-				id: `${range.rangeId}`,
-				startIndex: range.startIndex,
-				endIndex: range.endIndex,
-				url: (_range$properties$url = (_range$properties = range.properties) === null || _range$properties === void 0 ? void 0 : _range$properties.url) !== null && _range$properties$url !== void 0 ? _range$properties$url : "",
-				label: (_cellValue$p$body$dat = (_cellValue$p = cellValue.p) === null || _cellValue$p === void 0 || (_cellValue$p = _cellValue$p.body) === null || _cellValue$p === void 0 ? void 0 : _cellValue$p.dataStream.slice(range.startIndex, range.endIndex + 1).replaceAll(DataStreamTreeTokenType.CUSTOM_RANGE_START, "").replaceAll(DataStreamTreeTokenType.CUSTOM_RANGE_END, "")) !== null && _cellValue$p$body$dat !== void 0 ? _cellValue$p$body$dat : ""
-			};
-		})) !== null && _cellValue$p$body$cus !== void 0 ? _cellValue$p$body$cus : [];
+		const hyperlinks = [];
+		this.forEach((row, column, cell) => {
+			var _cell$p$body$customRa, _cell$p$body;
+			if (!cell.p) return;
+			const ranges = (_cell$p$body$customRa = (_cell$p$body = cell.p.body) === null || _cell$p$body === void 0 || (_cell$p$body = _cell$p$body.customRanges) === null || _cell$p$body === void 0 ? void 0 : _cell$p$body.filter((range) => range.rangeType === CustomRangeType.HYPERLINK)) !== null && _cell$p$body$customRa !== void 0 ? _cell$p$body$customRa : [];
+			if (ranges.length > 0) {
+				var _cell$p, _properties$url, _dataStream$slice$rep;
+				const dataStream = (_cell$p = cell.p) === null || _cell$p === void 0 || (_cell$p = _cell$p.body) === null || _cell$p === void 0 ? void 0 : _cell$p.dataStream;
+				const { rangeId, properties, startIndex, endIndex } = ranges[0];
+				const url = (_properties$url = properties === null || properties === void 0 ? void 0 : properties.url) !== null && _properties$url !== void 0 ? _properties$url : "";
+				const label = (_dataStream$slice$rep = dataStream === null || dataStream === void 0 ? void 0 : dataStream.slice(startIndex, endIndex + 1).replaceAll(DataStreamTreeTokenType.CUSTOM_RANGE_START, "").replaceAll(DataStreamTreeTokenType.CUSTOM_RANGE_END, "")) !== null && _dataStream$slice$rep !== void 0 ? _dataStream$slice$rep : "";
+				hyperlinks.push({
+					id: `${rangeId}`,
+					row,
+					column,
+					url,
+					label
+				});
+			}
+		});
+		return hyperlinks;
 	}
-	updateHyperLink(id, url, label) {
-		const params = {
+	updateHyperLink(url, label) {
+		const hyperlink = this.getHyperLinks().find((link) => link.row === this._range.startRow && link.column === this._range.startColumn);
+		if (!hyperlink) return Promise.reject(/* @__PURE__ */ new Error("No hyperlink found in the top left cell of the range"));
+		const { id, row, column } = hyperlink;
+		return this._commandService.executeCommand(UpdateHyperLinkCommand.id, {
 			unitId: this.getUnitId(),
 			subUnitId: this._worksheet.getSheetId(),
-			row: this._range.startRow,
-			column: this._range.startColumn,
 			id,
+			row,
+			column,
 			payload: {
 				payload: url,
 				display: label
 			}
-		};
-		return this._commandService.executeCommand(UpdateHyperLinkCommand.id, params);
+		});
 	}
-	cancelHyperLink(id) {
-		const params = {
-			unitId: this.getUnitId(),
-			subUnitId: this._worksheet.getSheetId(),
-			row: this._range.startRow,
-			column: this._range.startColumn,
-			id
-		};
-		return this._commandService.syncExecuteCommand(CancelHyperLinkCommand.id, params);
+	cancelHyperLink(hyperlink) {
+		if (hyperlink) {
+			const { id, row, column } = hyperlink;
+			return this._commandService.syncExecuteCommand(CancelHyperLinkCommand.id, {
+				unitId: this.getUnitId(),
+				subUnitId: this._worksheet.getSheetId(),
+				id,
+				row,
+				column
+			});
+		} else {
+			const hyperlinks = this.getHyperLinks();
+			if (hyperlinks.length === 0) return true;
+			return hyperlinks.every((link) => {
+				const { id, row, column } = link;
+				return this._commandService.syncExecuteCommand(CancelHyperLinkCommand.id, {
+					unitId: this.getUnitId(),
+					subUnitId: this._worksheet.getSheetId(),
+					id,
+					row,
+					column
+				});
+			});
+		}
 	}
 	getUrl() {
-		return this._injector.get(SheetsHyperLinkParserService).buildHyperLink(this.getUnitId(), this.getSheetId(), this.getRange());
+		return this._injector.get(SheetsHyperLinkParserService).buildHyperLink(this.getRange(), this.getSheetId());
 	}
 };
 FRange.extend(FRangeSheetsHyperlinkMixin);

package/lib/es/index.js

@@ -705,7 +705,7 @@ const UpdateRichHyperLinkMutation = {
 //#endregion
 //#region package.json
 var name = "@univerjs/sheets-hyper-link";
-var version = "0.23.0";
+var version = "0.24.0-insiders.20260528-29f582d";
 
 //#endregion
 //#region src/config/config.ts
@@ -1002,7 +1002,7 @@ let SheetsHyperLinkRemoveSheetController = class SheetsHyperLinkRemoveSheetContr
 			if (commandInfo.id === RemoveSheetCommand.id) {
 				var _workbook$getActiveSh;
 				const params = commandInfo.params;
-				const workbook = params.unitId ? this._univerInstanceService.getUnit(params.unitId) : this._univerInstanceService.getCurrentUnitForType(UniverInstanceType.UNIVER_SHEET);
+				const workbook = params.unitId ? this._univerInstanceService.getUnit(params.unitId) : this._univerInstanceService.getCurrentUnitOfType(UniverInstanceType.UNIVER_SHEET);
 				if (!workbook) return {
 					redos: [],
 					undos: []
@@ -1455,8 +1455,11 @@ let SheetsHyperLinkParserService = class SheetsHyperLinkParserService {
 		this._localeService = _localeService;
 		this._definedNamesService = _definedNamesService;
 	}
-	buildHyperLink(unitId, sheetId, range) {
-		return `#${"gid"}=${sheetId}${range ? `&${typeof range === "string" ? "rangeid" : "range"}=${typeof range === "string" ? range : serializeRange(range)}` : ""}`;
+	buildHyperLink(defineNameIdOrRange, sheetId) {
+		if (typeof defineNameIdOrRange === "string") return `#${"rangeid"}=${defineNameIdOrRange}`;
+		let result = `#${"gid"}=${sheetId}`;
+		if (defineNameIdOrRange) result += `&${"range"}=${serializeRange(defineNameIdOrRange)}`;
+		return result;
 	}
 	parseHyperLink(urlStr) {
 		if (urlStr.startsWith("#")) {
@@ -1485,10 +1488,10 @@ let SheetsHyperLinkParserService = class SheetsHyperLinkParserService {
 	_getURLName(params) {
 		var _sheet$getName;
 		const { gid, range, rangeid, unitid } = params;
-		const workbook = unitid ? this._univerInstanceService.getUnit(unitid, UniverInstanceType.UNIVER_SHEET) : this._univerInstanceService.getCurrentUnitForType(UniverInstanceType.UNIVER_SHEET);
+		const workbook = unitid ? this._univerInstanceService.getUnit(unitid, UniverInstanceType.UNIVER_SHEET) : this._univerInstanceService.getCurrentUnitOfType(UniverInstanceType.UNIVER_SHEET);
 		const invalidLink = {
 			type: "invalid",
-			name: this._localeService.t("hyperLink.message.refError")
+			name: this._localeService.t("sheets-hyper-link.message.refError")
 		};
 		if (!workbook) return invalidLink;
 		const sheet = gid ? workbook.getSheetBySheetId(gid) : workbook.getActiveSheet();

package/lib/es/locale/ar-SA.js

@@ -0,0 +1,5 @@
+//#region src/locale/ar-SA.ts
+const locale = { "sheets-hyper-link": { message: { refError: "نطاق غير صالح" } } };
+
+//#endregion
+export { locale as default };

package/lib/es/locale/ca-ES.js

@@ -0,0 +1,5 @@
+//#region src/locale/ca-ES.ts
+const locale = { "sheets-hyper-link": { message: { refError: "Interval no vàlid" } } };
+
+//#endregion
+export { locale as default };