@univerjs/core 1.0.0-alpha.7 → 1.0.0-beta.0

package/lib/cjs/index.js

@@ -152,7 +152,7 @@ function installShims() {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/typeof.js
+//#region \0@oxc-project+runtime@0.140.0/helpers/esm/typeof.js
 function _typeof(o) {
 	"@babel/helpers - typeof";
 	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
@@ -163,7 +163,7 @@ function _typeof(o) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/toPrimitive.js
+//#region \0@oxc-project+runtime@0.140.0/helpers/esm/toPrimitive.js
 function toPrimitive(t, r) {
 	if ("object" != _typeof(t) || !t) return t;
 	var e = t[Symbol.toPrimitive];
@@ -176,14 +176,14 @@ function toPrimitive(t, r) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/toPropertyKey.js
+//#region \0@oxc-project+runtime@0.140.0/helpers/esm/toPropertyKey.js
 function toPropertyKey(t) {
 	var i = toPrimitive(t, "string");
 	return "symbol" == _typeof(i) ? i : i + "";
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/defineProperty.js
+//#region \0@oxc-project+runtime@0.140.0/helpers/esm/defineProperty.js
 function _defineProperty(e, r, t) {
 	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
 		value: t,
@@ -712,76 +712,6 @@ var Tools = class Tools {
 		if (isIE11) return "IE11";
 		return "Unknown browser";
 	}
-	/** @deprecated This method is deprecated, please use `import { merge } from '@univerjs/core` instead */
-	static deepMerge(target, ...sources) {
-		sources.forEach((item) => item && deepItem(item));
-		function isDangerousKey(key) {
-			return key === "__proto__" || key === "constructor" || key === "prototype";
-		}
-		function deepArray(array, to) {
-			array.forEach((value, key) => {
-				if (typeof key === "string" && isDangerousKey(key)) return;
-				if (Tools.isArray(value)) {
-					var _to$key;
-					const origin = (_to$key = to[key]) !== null && _to$key !== void 0 ? _to$key : [];
-					to[key] = origin;
-					deepArray(value, origin);
-					return;
-				}
-				if (Tools.isObject(value)) {
-					var _to$key2;
-					const origin = (_to$key2 = to[key]) !== null && _to$key2 !== void 0 ? _to$key2 : {};
-					to[key] = origin;
-					deepObject(value, origin);
-					return;
-				}
-				to[key] = value;
-			});
-		}
-		function deepObject(object, to) {
-			Object.keys(object).forEach((key) => {
-				if (isDangerousKey(key)) return;
-				const value = object[key];
-				if (Tools.isObject(value)) {
-					var _to$key3;
-					const origin = (_to$key3 = to[key]) !== null && _to$key3 !== void 0 ? _to$key3 : {};
-					to[key] = origin;
-					deepObject(value, origin);
-					return;
-				}
-				if (Tools.isArray(value)) {
-					var _to$key4;
-					const origin = (_to$key4 = to[key]) !== null && _to$key4 !== void 0 ? _to$key4 : [];
-					to[key] = origin;
-					deepArray(value, origin);
-					return;
-				}
-				to[key] = value;
-			});
-		}
-		function deepItem(item) {
-			Object.keys(item).forEach((key) => {
-				if (isDangerousKey(key)) return;
-				const value = item[key];
-				if (Tools.isArray(value)) {
-					var _target$key;
-					const origin = (_target$key = target[key]) !== null && _target$key !== void 0 ? _target$key : [];
-					target[key] = origin;
-					deepArray(value, origin);
-					return;
-				}
-				if (Tools.isObject(value)) {
-					var _target$key2;
-					const origin = (_target$key2 = target[key]) !== null && _target$key2 !== void 0 ? _target$key2 : {};
-					target[key] = origin;
-					deepObject(value, origin);
-					return;
-				}
-				target[key] = value;
-			});
-		}
-		return target;
-	}
 	static diffValue(one, two) {
 		return isValueEqual(one, two);
 	}
@@ -1568,6 +1498,8 @@ let TextDecoration = /* @__PURE__ */ function(TextDecoration) {
 	TextDecoration[TextDecoration["WAVY_DOUBLE"] = 15] = "WAVY_DOUBLE";
 	TextDecoration[TextDecoration["WAVY_HEAVY"] = 16] = "WAVY_HEAVY";
 	TextDecoration[TextDecoration["WORDS"] = 17] = "WORDS";
+	TextDecoration[TextDecoration["SINGLE_ACCOUNTING"] = 18] = "SINGLE_ACCOUNTING";
+	TextDecoration[TextDecoration["DOUBLE_ACCOUNTING"] = 19] = "DOUBLE_ACCOUNTING";
 	return TextDecoration;
 }({});
 /**
@@ -1681,8 +1613,6 @@ let CellValueType = /* @__PURE__ */ function(CellValueType) {
 */
 /**
 * Theme color type enum
-*
-* @deprecated
 */
 let ThemeColorType = /* @__PURE__ */ function(ThemeColorType) {
 	/**
@@ -1710,8 +1640,6 @@ let ThemeColorType = /* @__PURE__ */ function(ThemeColorType) {
 }({});
 /**
 * Preset theme names.
-*
-* @deprecated
 */
 let ThemeColors = /* @__PURE__ */ function(ThemeColors) {
 	ThemeColors["OFFICE"] = "Office";
@@ -1743,7 +1671,7 @@ let ThemeColors = /* @__PURE__ */ function(ThemeColors) {
 //#endregion
 //#region package.json
 var name = "@univerjs/core";
-var version = "1.0.0-alpha.7";
+var version = "1.0.0-beta.0";
 
 //#endregion
 //#region src/common/array.ts
@@ -1952,9 +1880,8 @@ var ConfigService = class {
 		return this._config.get(id);
 	}
 	setConfig(id, value, options) {
-		var _this$_config$get;
 		const { merge: isMerge = false } = options || {};
-		let nextValue = (_this$_config$get = this._config.get(id)) !== null && _this$_config$get !== void 0 ? _this$_config$get : {};
+		let nextValue = this._config.get(id) ?? {};
 		if (isMerge) nextValue = (0, lodash_es.merge)(nextValue, value);
 		else nextValue = value;
 		this._config.set(id, nextValue);
@@ -2003,8 +1930,7 @@ var ContextService = class extends Disposable {
 		this._contextMap.clear();
 	}
 	getContextValue(key) {
-		var _this$_contextMap$get;
-		return (_this$_contextMap$get = this._contextMap.get(key)) !== null && _this$_contextMap$get !== void 0 ? _this$_contextMap$get : false;
+		return this._contextMap.get(key) ?? false;
 	}
 	setContextValue(key, value) {
 		this._contextMap.set(key, value);
@@ -2091,7 +2017,7 @@ function hashLogContent(...args) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/decorateParam.js
+//#region \0@oxc-project+runtime@0.140.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);
@@ -2099,7 +2025,7 @@ function __decorateParam(paramIndex, decorator) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.140.0/helpers/esm/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);
@@ -2262,7 +2188,7 @@ let CommandService = class CommandService extends Disposable {
 					params
 				};
 				const stackItemDisposable = this._pushCommandExecutionStack(commandInfo);
-				const _options = options !== null && options !== void 0 ? options : {};
+				const _options = options ?? {};
 				this._beforeCommandExecutionListeners.forEach((listener) => listener(commandInfo, _options));
 				if (this._disposed) {
 					stackItemDisposable.dispose();
@@ -2302,13 +2228,12 @@ let CommandService = class CommandService extends Disposable {
 				if (command.type === 2) {
 					const triggerCommand = findLast(this._commandExecutionStack, (item) => item.type === 0);
 					if (triggerCommand) {
-						var _commandInfo$params;
-						commandInfo.params = (_commandInfo$params = commandInfo.params) !== null && _commandInfo$params !== void 0 ? _commandInfo$params : {};
+						commandInfo.params = commandInfo.params ?? {};
 						commandInfo.params.trigger = triggerCommand.id;
 					}
 				}
 				const stackItemDisposable = this._pushCommandExecutionStack(commandInfo);
-				const _options = options !== null && options !== void 0 ? options : {};
+				const _options = options ?? {};
 				this._beforeCommandExecutionListeners.forEach((listener) => listener(commandInfo, _options));
 				if (this._disposed) {
 					stackItemDisposable.dispose();
@@ -3396,18 +3321,18 @@ const COLORS = {
 };
 var ColorKit = class ColorKit {
 	static mix(color1, color2, amount) {
-		var _rgb1$a, _rgb2$a;
 		amount = Math.min(1, Math.max(0, amount));
 		const rgb1 = new ColorKit(color1).toRgb();
 		const rgb2 = new ColorKit(color2).toRgb();
-		const alpha1 = (_rgb1$a = rgb1.a) !== null && _rgb1$a !== void 0 ? _rgb1$a : 1;
-		const alpha2 = (_rgb2$a = rgb2.a) !== null && _rgb2$a !== void 0 ? _rgb2$a : 1;
-		return new ColorKit({
+		const alpha1 = rgb1.a ?? 1;
+		const alpha2 = rgb2.a ?? 1;
+		const rgba = {
 			r: (rgb2.r - rgb1.r) * amount + rgb1.r,
 			g: (rgb2.g - rgb1.g) * amount + rgb1.g,
 			b: (rgb2.b - rgb1.b) * amount + rgb1.b,
 			a: (alpha2 - alpha1) * amount + alpha1
-		});
+		};
+		return new ColorKit(rgba);
 	}
 	static getContrastRatio(foreground, background) {
 		const lumA = new ColorKit(foreground).getLuminance();
@@ -3505,8 +3430,7 @@ var ColorKit = class ColorKit {
 		return (r * 299 + g * 587 + b * 114) / 1e3;
 	}
 	getAlpha() {
-		var _this$_color$a;
-		return (_this$_color$a = this._color.a) !== null && _this$_color$a !== void 0 ? _this$_color$a : 1;
+		return this._color.a ?? 1;
 	}
 	isDark() {
 		return this.getBrightness() < 128;
@@ -3903,57 +3827,6 @@ let DOC_RANGE_TYPE = /* @__PURE__ */ function(DOC_RANGE_TYPE) {
 	DOC_RANGE_TYPE["TEXT"] = "TEXT";
 	return DOC_RANGE_TYPE;
 }({});
-/**
-* Determines whether the cell(row, column) is within the range of the merged cells.
-* @deprecated please use worksheet.getCellInfoInMergeData instead
-*/
-function getCellInfoInMergeData(row, column, mergeData) {
-	let isMerged = false;
-	let isMergedMainCell = false;
-	let newEndRow = row;
-	let newEndColumn = column;
-	let mergeRow = row;
-	let mergeColumn = column;
-	if (mergeData == null) return {
-		actualRow: row,
-		actualColumn: column,
-		isMergedMainCell,
-		isMerged,
-		endRow: newEndRow,
-		endColumn: newEndColumn,
-		startRow: mergeRow,
-		startColumn: mergeColumn
-	};
-	for (let i = 0; i < mergeData.length; i++) {
-		const { startRow: startRowMarge, endRow: endRowMarge, startColumn: startColumnMarge, endColumn: endColumnMarge } = mergeData[i];
-		if (row === startRowMarge && column === startColumnMarge) {
-			newEndRow = endRowMarge;
-			newEndColumn = endColumnMarge;
-			mergeRow = startRowMarge;
-			mergeColumn = startColumnMarge;
-			isMergedMainCell = true;
-			break;
-		}
-		if (row >= startRowMarge && row <= endRowMarge && column >= startColumnMarge && column <= endColumnMarge) {
-			newEndRow = endRowMarge;
-			newEndColumn = endColumnMarge;
-			mergeRow = startRowMarge;
-			mergeColumn = startColumnMarge;
-			isMerged = true;
-			break;
-		}
-	}
-	return {
-		actualRow: row,
-		actualColumn: column,
-		isMergedMainCell,
-		isMerged,
-		endRow: newEndRow,
-		endColumn: newEndColumn,
-		startRow: mergeRow,
-		startColumn: mergeColumn
-	};
-}
 let CellModeEnum = /* @__PURE__ */ function(CellModeEnum) {
 	CellModeEnum["Raw"] = "raw";
 	CellModeEnum["Intercepted"] = "intercepted";
@@ -4149,7 +4022,6 @@ const dateCodes = [
 	["hm", 9]
 ];
 function info(partitions, currencyId = null) {
-	var _positive$scale;
 	const [partPositive, partNegative] = partitions;
 	if (!partPositive) throw new TypeError("Cannot read properties of undefined (reading 'frac_max')");
 	const positive = isParsedSection$1(partPositive) ? partPositive : void 0;
@@ -4161,8 +4033,8 @@ function info(partitions, currencyId = null) {
 		isDate: isDate(partitions),
 		isText: isText(partitions),
 		isPercent: isPercent(partitions),
-		maxDecimals: (positive === null || positive === void 0 ? void 0 : positive.general) ? 9 : fracMax !== null && fracMax !== void 0 ? fracMax : 0,
-		scale: (_positive$scale = positive === null || positive === void 0 ? void 0 : positive.scale) !== null && _positive$scale !== void 0 ? _positive$scale : 1,
+		maxDecimals: (positive === null || positive === void 0 ? void 0 : positive.general) ? 9 : fracMax ?? 0,
+		scale: (positive === null || positive === void 0 ? void 0 : positive.scale) ?? 1,
 		color: 0,
 		parentheses: 0,
 		grouped: (positive === null || positive === void 0 ? void 0 : positive.grouping) ? 1 : 0,
@@ -4245,11 +4117,10 @@ function info(partitions, currencyId = null) {
 	return Object.freeze(output);
 }
 function dateInfo(partitions) {
-	var _positive$date;
 	const [partPositive] = partitions;
 	if (!partPositive) throw new TypeError("Cannot read properties of undefined (reading 'date')");
 	const positive = isParsedSection$1(partPositive) ? partPositive : void 0;
-	const date = (_positive$date = positive === null || positive === void 0 ? void 0 : positive.date) !== null && _positive$date !== void 0 ? _positive$date : 0;
+	const date = (positive === null || positive === void 0 ? void 0 : positive.date) ?? 0;
 	return {
 		year: !!(date & 2),
 		month: !!(date & 4),
@@ -5825,8 +5696,7 @@ function getAbsoluteDecimal(value) {
 	} : value;
 }
 function getDecimalExponent(value) {
-	var _value$exponent;
-	return (_value$exponent = value === null || value === void 0 ? void 0 : value.exponent) !== null && _value$exponent !== void 0 ? _value$exponent : 0;
+	return (value === null || value === void 0 ? void 0 : value.exponent) ?? 0;
 }
 function usesShortestSignificand(value) {
 	return !value || value.exponent < -308;
@@ -6012,7 +5882,6 @@ function legacyRound(number, places = 0) {
 	return Math.round(number);
 }
 function runPart(value, part, options, locale, decimalValue = null) {
-	var _options$grouping$, _options$grouping$2;
 	const section = part;
 	let renderValue = value;
 	let numericValue = value;
@@ -6075,8 +5944,8 @@ function runPart(value, part, options, locale, decimalValue = null) {
 		const roundedInteger = Math.abs(Number.isSafeInteger(numericValue) && places === 0 ? numericValue : legacyRound(numericValue, places));
 		integer += roundedInteger < 1 ? "" : Math.floor(roundedInteger);
 	}
-	const primaryGroup = (_options$grouping$ = options.grouping[0]) !== null && _options$grouping$ !== void 0 ? _options$grouping$ : 3;
-	const secondaryGroup = (_options$grouping$2 = options.grouping[1]) !== null && _options$grouping$2 !== void 0 ? _options$grouping$2 : primaryGroup;
+	const primaryGroup = options.grouping[0] ?? 3;
+	const secondaryGroup = options.grouping[1] ?? primaryGroup;
 	if (section.dec_fractions) fraction = roundedNumber ? roundedNumber.fraction : String(legacyRound(numericValue, section.frac_max)).split(".")[1] || "";
 	const fixedSlash = !section.error && (section.num_p.includes("0") || section.den_p.includes("0"));
 	let haveFraction = fixedSlash;
@@ -6753,7 +6622,7 @@ function dateToSerial(date, options) {
 	let timestamp = null;
 	if (Array.isArray(date)) {
 		const [year, month, day, hours, minutes, seconds] = date;
-		timestamp = dateUTC(year, month == null ? 0 : month - 1, day !== null && day !== void 0 ? day : 1, hours || 0, minutes || 0, seconds || 0);
+		timestamp = dateUTC(year, month == null ? 0 : month - 1, day ?? 1, hours || 0, minutes || 0, seconds || 0);
 	} else if (date instanceof Date) {
 		timestamp = date.getTime();
 		if (!(options === null || options === void 0 ? void 0 : options.ignoreTimezone)) {
@@ -7077,6 +6946,7 @@ function isValidDate(year, month, day) {
 	} else if ((month === 4 || month === 6 || month === 9 || month === 11) && day > 30 || (month === 1 || month === 3 || month === 5 || month === 7 || month === 8 || month === 10 || month === 12) && day > 31) return false;
 	return true;
 }
+const dateLocaleLookupCache = /* @__PURE__ */ new WeakMap();
 const matchRec = (string, data, skipPeriod = false) => {
 	for (const item of data) if (string.startsWith(item[0])) {
 		let length = item[0].length;
@@ -7187,23 +7057,39 @@ const getLookups = (values, symbol) => {
 	lookups.sort((a, b) => b[0].length - a[0].length);
 	return lookups;
 };
+const tokensMatch = (values, cachedValues) => values.length === cachedValues.length && values.every((value, index) => value === cachedValues[index]);
+const getDateLocaleLookups = (locale) => {
+	let cached = dateLocaleLookupCache.get(locale);
+	if (!cached || !tokensMatch(locale.mmmm, cached.mmmm) || !tokensMatch(locale.mmm, cached.mmm) || !tokensMatch(locale.dddd, cached.dddd) || !tokensMatch(locale.ddd, cached.ddd)) {
+		cached = {
+			lookups: {
+				mon: getLookups(locale.mmmm, "F").concat(getLookups(locale.mmm, "M")),
+				mp: locale.mmm[0].endsWith("."),
+				day: getLookups(locale.dddd, "l").concat(getLookups(locale.ddd, "D")),
+				dp: locale.ddd[0].endsWith(".")
+			},
+			mmmm: [...locale.mmmm],
+			mmm: [...locale.mmm],
+			dddd: [...locale.dddd],
+			ddd: [...locale.ddd]
+		};
+		dateLocaleLookupCache.set(locale, cached);
+	}
+	return cached.lookups;
+};
 /** Parse a date or datetime string and return its serial value and format. */
 function parseDate(value, options = {}) {
-	var _date$year, _date$day;
 	const l10n = getLocale(options.locale || "") || defaultLocale;
 	const localeData = {
-		mon: getLookups(l10n.mmmm, "F").concat(getLookups(l10n.mmm, "M")),
-		mp: l10n.mmm[0].at(-1) === ".",
-		day: getLookups(l10n.dddd, "l").concat(getLookups(l10n.ddd, "D")),
-		dp: l10n.ddd[0].at(-1) === ".",
+		...getDateLocaleLookups(l10n),
 		locale: options.locale
 	};
 	const date = nextToken(normDateStr(value), l10n.preferMDY ? dateTrieMD : dateTrieDM, { path: "" }, localeData);
 	if (!date) return null;
 	if (date.sep === "." && date.path.length === 3) return null;
 	if (date.month == null || date._mon == null) return null;
-	const year = +((_date$year = date.year) !== null && _date$year !== void 0 ? _date$year : currentYear);
-	const day = (_date$day = date.day) !== null && _date$day !== void 0 ? _date$day : "1";
+	const year = +(date.year ?? currentYear);
+	const day = date.day ?? "1";
 	let epoch = -Infinity;
 	if (year < 1900) return null;
 	else if (year <= 1900 && date.month <= 2) epoch = 25568;
@@ -7268,8 +7154,7 @@ function parseBool(value, options = {}) {
 }
 /** Parse a spreadsheet input as a number, date, time, or boolean. */
 function parseValue(value, options) {
-	var _ref, _ref2, _parseNumber;
-	return (_ref = (_ref2 = (_parseNumber = parseNumber(value, options)) !== null && _parseNumber !== void 0 ? _parseNumber : parseDate(value, options)) !== null && _ref2 !== void 0 ? _ref2 : parseTime(value, options)) !== null && _ref !== void 0 ? _ref : parseBool(value, options);
+	return parseNumber(value, options) ?? parseDate(value, options) ?? parseTime(value, options) ?? parseBool(value, options);
 }
 
 //#endregion
@@ -7330,19 +7215,17 @@ function prepareFormatterData(pattern, shouldThrow = false) {
 * Formats a value as a string and returns the result.
 */
 function format(pattern, value, options = {}) {
-	var _handleDates;
 	const resolvedOptions = Object.assign({}, defaultOptions, options);
 	const data = prepareFormatterData(pattern, resolvedOptions.throws);
-	return formatValue((_handleDates = dateToSerial(value, resolvedOptions)) !== null && _handleDates !== void 0 ? _handleDates : value, data, resolvedOptions);
+	return formatValue(dateToSerial(value, resolvedOptions) ?? value, data, resolvedOptions);
 }
 /**
 * Find the color appropriate to a value as dictated by a format pattern.
 */
 function formatColor(pattern, value, options) {
-	var _handleDates2;
 	const resolvedOptions = Object.assign({}, defaultOptions, options);
 	const data = prepareFormatterData(pattern, resolvedOptions.throws);
-	return formatColor$1((_handleDates2 = dateToSerial(value, resolvedOptions)) !== null && _handleDates2 !== void 0 ? _handleDates2 : value, data, resolvedOptions);
+	return formatColor$1(dateToSerial(value, resolvedOptions) ?? value, data, resolvedOptions);
 }
 /** Determine if a given format pattern is a date pattern. */
 function isDateFormat(pattern) {
@@ -7812,8 +7695,7 @@ const CURRENCY_SYMBOL_PREFIX_REG = new RegExp(`^${regexp.charset(...Array.from(n
 * Get the numfmt parse value, and filter out the parse error.
 */
 const getNumfmtParseValueFilter = (value) => {
-	var _ref, _parseDate;
-	const parseData = (_ref = (_parseDate = parseDate(value)) !== null && _parseDate !== void 0 ? _parseDate : parseTime(value)) !== null && _ref !== void 0 ? _ref : parseNumber(value);
+	const parseData = parseDate(value) ?? parseTime(value) ?? parseNumber(value);
 	if (!parseData) return null;
 	const { z } = parseData;
 	if (z) {
@@ -8041,24 +7923,15 @@ var ObjectMatrix = class ObjectMatrix {
 		const objectArray = this.getRowOrCreate(row);
 		objectArray[column] = value;
 	}
-	/**
-	* ！！
-	* Please +1 ‘！’, who fell into this pit.
-	* @deprecated use `realDelete` or `splice`
-	*/
-	deleteValue(row, column) {
+	realDeleteValue(row, column) {
 		var _this$_matrix2;
 		(_this$_matrix2 = this._matrix) === null || _this$_matrix2 === void 0 || (_this$_matrix2 = _this$_matrix2[row]) === null || _this$_matrix2 === void 0 || delete _this$_matrix2[column];
-	}
-	realDeleteValue(row, column) {
-		var _this$_matrix3;
-		(_this$_matrix3 = this._matrix) === null || _this$_matrix3 === void 0 || (_this$_matrix3 = _this$_matrix3[row]) === null || _this$_matrix3 === void 0 || delete _this$_matrix3[column];
 		if (this.getRow(row)) {
 			const objectArray = this.getRow(row);
 			if (objectArray == null) return;
 			if (Object.keys(objectArray).length === 0) {
-				var _this$_matrix4;
-				(_this$_matrix4 = this._matrix) === null || _this$_matrix4 === void 0 || delete _this$_matrix4[row];
+				var _this$_matrix3;
+				(_this$_matrix3 = this._matrix) === null || _this$_matrix3 === void 0 || delete _this$_matrix3[row];
 			}
 		}
 	}
@@ -8257,23 +8130,10 @@ var ObjectMatrix = class ObjectMatrix {
 		});
 		return array;
 	}
-	/**
-	* @deprecated Use getMatrix as a substitute.
-	*/
-	toJSON() {
-		return this._matrix;
-	}
 	clone() {
 		const json = JSON.stringify(this._matrix);
 		return JSON.parse(json);
 	}
-	/**
-	* @deprecated Use clone as a substitute.
-	*/
-	getData() {
-		const json = JSON.stringify(this._matrix);
-		return JSON.parse(json);
-	}
 	getArrayData() {
 		let startRow = 0;
 		let startColumn = 0;
@@ -8295,7 +8155,7 @@ var ObjectMatrix = class ObjectMatrix {
 				objectMatrix.setValue(rowIndex - startRow, columnIndex - startColumn, value);
 			});
 		});
-		return objectMatrix.getData();
+		return objectMatrix.clone();
 	}
 	/**
 	* the function can only be used in all the row and column are positive integer
@@ -8441,10 +8301,6 @@ function convertCellToRange(cellInfo) {
 		endX
 	};
 }
-/**
-* @deprecated use `convertCellToRange` instead
-*/
-const makeCellToSelection = convertCellToRange;
 function makeCellRangeToRangeData(cellInfo) {
 	if (!cellInfo) return;
 	const { actualRow, actualColumn, isMerged, isMergedMainCell, startRow: mergeStartRow, startColumn: mergeStartColumn, endRow: mergeEndRow, endColumn: mergeEndColumn } = cellInfo;
@@ -8558,20 +8414,20 @@ function handleStyleToString(style, isCell = false) {
 		["bd", () => {
 			var _style$bd, _style$bd3, _style$bd5, _style$bd7;
 			if ((_style$bd = style.bd) === null || _style$bd === void 0 ? void 0 : _style$bd.b) {
-				var _style$bd2, _getColorStyle;
-				str += `border-bottom: ${getBorderStyle((_style$bd2 = style.bd) === null || _style$bd2 === void 0 ? void 0 : _style$bd2.b.s)} ${(_getColorStyle = getColorStyle(style.bd.b.cl)) !== null && _getColorStyle !== void 0 ? _getColorStyle : ""}; `;
+				var _style$bd2;
+				str += `border-bottom: ${getBorderStyle((_style$bd2 = style.bd) === null || _style$bd2 === void 0 ? void 0 : _style$bd2.b.s)} ${getColorStyle(style.bd.b.cl) ?? ""}; `;
 			}
 			if ((_style$bd3 = style.bd) === null || _style$bd3 === void 0 ? void 0 : _style$bd3.t) {
-				var _style$bd4, _getColorStyle2;
-				str += `border-top: ${getBorderStyle((_style$bd4 = style.bd) === null || _style$bd4 === void 0 ? void 0 : _style$bd4.t.s)} ${(_getColorStyle2 = getColorStyle(style.bd.t.cl)) !== null && _getColorStyle2 !== void 0 ? _getColorStyle2 : ""}; `;
+				var _style$bd4;
+				str += `border-top: ${getBorderStyle((_style$bd4 = style.bd) === null || _style$bd4 === void 0 ? void 0 : _style$bd4.t.s)} ${getColorStyle(style.bd.t.cl) ?? ""}; `;
 			}
 			if ((_style$bd5 = style.bd) === null || _style$bd5 === void 0 ? void 0 : _style$bd5.r) {
-				var _style$bd6, _getColorStyle3;
-				str += `border-right: ${getBorderStyle((_style$bd6 = style.bd) === null || _style$bd6 === void 0 ? void 0 : _style$bd6.r.s)} ${(_getColorStyle3 = getColorStyle(style.bd.r.cl)) !== null && _getColorStyle3 !== void 0 ? _getColorStyle3 : ""}; `;
+				var _style$bd6;
+				str += `border-right: ${getBorderStyle((_style$bd6 = style.bd) === null || _style$bd6 === void 0 ? void 0 : _style$bd6.r.s)} ${getColorStyle(style.bd.r.cl) ?? ""}; `;
 			}
 			if ((_style$bd7 = style.bd) === null || _style$bd7 === void 0 ? void 0 : _style$bd7.l) {
-				var _style$bd8, _getColorStyle4;
-				str += `border-left: ${getBorderStyle((_style$bd8 = style.bd) === null || _style$bd8 === void 0 ? void 0 : _style$bd8.l.s)} ${(_getColorStyle4 = getColorStyle(style.bd.l.cl)) !== null && _getColorStyle4 !== void 0 ? _getColorStyle4 : ""}; `;
+				var _style$bd8;
+				str += `border-left: ${getBorderStyle((_style$bd8 = style.bd) === null || _style$bd8 === void 0 ? void 0 : _style$bd8.l.s)} ${getColorStyle(style.bd.l.cl) ?? ""}; `;
 			}
 		}],
 		["cl", () => {
@@ -8988,8 +8844,7 @@ function parseDateString(input, isUTC) {
 	return new Date(text);
 }
 function normalizeUnit(unit) {
-	var _UNIT_ALIASES$unit;
-	return (_UNIT_ALIASES$unit = UNIT_ALIASES[unit]) !== null && _UNIT_ALIASES$unit !== void 0 ? _UNIT_ALIASES$unit : UNIT_ALIASES[String(unit).toLowerCase()];
+	return UNIT_ALIASES[unit] ?? UNIT_ALIASES[String(unit).toLowerCase()];
 }
 function daysInMonth(year, month, isUTC) {
 	return isUTC ? new Date(Date.UTC(year, month, 0)).getUTCDate() : new Date(year, month, 0).getDate();
@@ -9108,10 +8963,7 @@ function ordinal(value) {
 	}
 }
 function replaceLocalizedTokens(template) {
-	return template.replace(/LLLL|LLL|LL|L|llll|lll|ll|l/g, (token) => {
-		var _LOCALIZED_FORMAT_MAP;
-		return (_LOCALIZED_FORMAT_MAP = LOCALIZED_FORMAT_MAP[token]) !== null && _LOCALIZED_FORMAT_MAP !== void 0 ? _LOCALIZED_FORMAT_MAP : token;
-	});
+	return template.replace(/LLLL|LLL|LL|L|llll|lll|ll|l/g, (token) => LOCALIZED_FORMAT_MAP[token] ?? token);
 }
 function formatDate(date, template, isUTC) {
 	const parts = getDateParts(date, isUTC);
@@ -9153,13 +9005,7 @@ function formatDate(date, template, isUTC) {
 	const escapedBlocks = [];
 	return replaceLocalizedTokens(template.replace(/\[([^\]]+)]/g, (_, value) => {
 		return `\u0000${escapedBlocks.push(value) - 1}\u0000`;
-	})).replace(/YYYY|YY|MMMM|MMM|MM|M|DD|Do|D|dddd|ddd|dd|d|HH|H|hh|h|mm|m|ss|s|SSS|A|a|Qo|Q|X|x|ZZ|Z/g, (token) => {
-		var _tokenMap$token;
-		return (_tokenMap$token = tokenMap[token]) !== null && _tokenMap$token !== void 0 ? _tokenMap$token : token;
-	}).replace(/\u0000(\d+)\u0000/g, (_, indexText) => {
-		var _escapedBlocks$Number;
-		return (_escapedBlocks$Number = escapedBlocks[Number(indexText)]) !== null && _escapedBlocks$Number !== void 0 ? _escapedBlocks$Number : "";
-	});
+	})).replace(/YYYY|YY|MMMM|MMM|MM|M|DD|Do|D|dddd|ddd|dd|d|HH|H|hh|h|mm|m|ss|s|SSS|A|a|Qo|Q|X|x|ZZ|Z/g, (token) => tokenMap[token] ?? token).replace(/\u0000(\d+)\u0000/g, (_, indexText) => escapedBlocks[Number(indexText)] ?? "");
 }
 function createDateKit(input) {
 	return new DateKitImpl(toDate(input, false), false);
@@ -9328,7 +9174,10 @@ function mergeLocales(...locales) {
 
 //#endregion
 //#region src/shared/lru/lru-map.ts
-let _Symbol$iterator, _Symbol$iterator2, _Symbol$iterator3, _Symbol$iterator4;
+let _Symbol$iterator;
+let _Symbol$iterator2;
+let _Symbol$iterator3;
+let _Symbol$iterator4;
 const NEWER = Symbol("newer");
 const OLDER = Symbol("older");
 _Symbol$iterator = Symbol.iterator;
@@ -9833,6 +9682,11 @@ let CustomRangeType = /* @__PURE__ */ function(CustomRangeType) {
 	CustomRangeType[CustomRangeType["DELTED"] = 9999] = "DELTED";
 	return CustomRangeType;
 }({});
+let DocxBreakType = /* @__PURE__ */ function(DocxBreakType) {
+	DocxBreakType["COLUMN"] = "column";
+	DocxBreakType["TEXT_WRAPPING"] = "textWrapping";
+	return DocxBreakType;
+}({});
 let CustomDecorationType = /* @__PURE__ */ function(CustomDecorationType) {
 	CustomDecorationType[CustomDecorationType["COMMENT"] = 0] = "COMMENT";
 	CustomDecorationType[CustomDecorationType["DELETED"] = 9999] = "DELETED";
@@ -9865,9 +9719,10 @@ let GridType = /* @__PURE__ */ function(GridType) {
 let SectionType = /* @__PURE__ */ function(SectionType) {
 	SectionType[SectionType["SECTION_TYPE_UNSPECIFIED"] = 0] = "SECTION_TYPE_UNSPECIFIED";
 	SectionType[SectionType["CONTINUOUS"] = 1] = "CONTINUOUS";
-	SectionType[SectionType["NEXT_PAGE"] = 2] = "NEXT_PAGE";
-	SectionType[SectionType["EVEN_PAGE"] = 3] = "EVEN_PAGE";
-	SectionType[SectionType["ODD_PAGE"] = 4] = "ODD_PAGE";
+	SectionType[SectionType["NEXT_COLUMN"] = 2] = "NEXT_COLUMN";
+	SectionType[SectionType["NEXT_PAGE"] = 3] = "NEXT_PAGE";
+	SectionType[SectionType["EVEN_PAGE"] = 4] = "EVEN_PAGE";
+	SectionType[SectionType["ODD_PAGE"] = 5] = "ODD_PAGE";
 	return SectionType;
 }({});
 /**
@@ -9912,15 +9767,25 @@ let WrapTextType = /* @__PURE__ */ function(WrapTextType) {
 	return WrapTextType;
 }({});
 /**
-* The possible layouts of a [PositionedObject]
+* Controls how a positioned object participates in document text layout.
+*
+* `WRAP_NONE` does not by itself determine whether the object is in front of or behind text. Drawing data uses
+* `behindDoc` for that stacking choice.
 */
 let PositionedObjectLayoutType = /* @__PURE__ */ function(PositionedObjectLayoutType) {
+	/** Places the object in the text flow like a character and lets it affect the containing line's metrics. */
 	PositionedObjectLayoutType[PositionedObjectLayoutType["INLINE"] = 0] = "INLINE";
+	/** Floats the object without reflowing text. The object and text can overlap. */
 	PositionedObjectLayoutType[PositionedObjectLayoutType["WRAP_NONE"] = 1] = "WRAP_NONE";
+	/** Floats the object and wraps text around the custom polygon defined by its wrap path. */
 	PositionedObjectLayoutType[PositionedObjectLayoutType["WRAP_POLYGON"] = 2] = "WRAP_POLYGON";
+	/** Floats the object and wraps text around its rectangular bounds. */
 	PositionedObjectLayoutType[PositionedObjectLayoutType["WRAP_SQUARE"] = 3] = "WRAP_SQUARE";
+	/** Floats the object and allows text to flow through eligible open regions in its wrap contour. */
 	PositionedObjectLayoutType[PositionedObjectLayoutType["WRAP_THROUGH"] = 4] = "WRAP_THROUGH";
+	/** Floats the object and wraps text closely around its contour instead of its rectangular bounds. */
 	PositionedObjectLayoutType[PositionedObjectLayoutType["WRAP_TIGHT"] = 5] = "WRAP_TIGHT";
+	/** Floats the object in a horizontal band, leaving text only above and below it. */
 	PositionedObjectLayoutType[PositionedObjectLayoutType["WRAP_TOP_AND_BOTTOM"] = 6] = "WRAP_TOP_AND_BOTTOM";
 	return PositionedObjectLayoutType;
 }({});
@@ -10558,6 +10423,8 @@ const MODERN_DOCUMENT_WIDTH = {
 	["wide"]: PAGE_SIZE["A3"].width
 };
 const MODERN_DOCUMENT_DEFAULT_MARGIN = 50 / .75;
+/** Default margin for a paginated Traditional document, in 96-DPI layout pixels. */
+const TRADITIONAL_DOCUMENT_DEFAULT_MARGIN = 72;
 
 //#endregion
 //#region src/sheets/range.ts
@@ -10746,7 +10613,7 @@ var Range = class Range {
 	*/
 	getObjectValues(options = {}) {
 		const { startRow, endRow, startColumn, endColumn } = this._range;
-		const values = this._worksheet.getCellMatrix().getFragment(startRow, endRow, startColumn, endColumn).getData();
+		const values = this._worksheet.getCellMatrix().getFragment(startRow, endRow, startColumn, endColumn).clone();
 		if (options.isIncludeStyle) {
 			const style = this._deps.getStyles();
 			for (let r = 0; r <= endRow - startRow; r++) for (let c = 0; c <= endColumn - startColumn; c++) {
@@ -10797,8 +10664,8 @@ var Range = class Range {
 	* Returns the underline of the cells in the range.
 	*/
 	getUnderline() {
-		var _this$getValue, _p$body;
-		const { p } = (_this$getValue = this.getValue()) !== null && _this$getValue !== void 0 ? _this$getValue : {};
+		var _p$body;
+		const { p } = this.getValue() ?? {};
 		if (p && Array.isArray((_p$body = p.body) === null || _p$body === void 0 ? void 0 : _p$body.textRuns) && p.body.textRuns.length > 0) return isAllFormatInTextRuns("ul", p.body) === 1 ? { s: 1 } : { s: 0 };
 		return this.getUnderlines()[0][0];
 	}
@@ -10818,8 +10685,8 @@ var Range = class Range {
 	* Returns the strikeThrough of the cells in the range.
 	*/
 	getStrikeThrough() {
-		var _this$getValue2, _p$body2;
-		const { p } = (_this$getValue2 = this.getValue()) !== null && _this$getValue2 !== void 0 ? _this$getValue2 : {};
+		var _p$body2;
+		const { p } = this.getValue() ?? {};
 		if (p && Array.isArray((_p$body2 = p.body) === null || _p$body2 === void 0 ? void 0 : _p$body2.textRuns) && p.body.textRuns.length > 0) return isAllFormatInTextRuns("st", p.body) === 1 ? { s: 1 } : { s: 0 };
 		return this.getStrikeThroughs()[0][0];
 	}
@@ -10833,8 +10700,8 @@ var Range = class Range {
 	* Returns the font size in point size of the cell in the top-left corner of the range.
 	*/
 	getFontSize() {
-		var _this$getValue3, _p$body3;
-		const p = ((_this$getValue3 = this.getValue()) === null || _this$getValue3 === void 0 ? void 0 : _this$getValue3.p) || {};
+		var _this$getValue, _p$body3;
+		const p = ((_this$getValue = this.getValue()) === null || _this$getValue === void 0 ? void 0 : _this$getValue.p) || {};
 		if (p && Array.isArray((_p$body3 = p.body) === null || _p$body3 === void 0 ? void 0 : _p$body3.textRuns) && p.body.textRuns.length > 0) if (p.body.textRuns.some((textRun) => {
 			var _textRun$ts;
 			return (textRun === null || textRun === void 0 || (_textRun$ts = textRun.ts) === null || _textRun$ts === void 0 ? void 0 : _textRun$ts.fs) != null;
@@ -10864,8 +10731,8 @@ var Range = class Range {
 	* Returns the font style ('italic' or 'normal') of the cell in the top-left corner of the range.
 	*/
 	getFontStyle() {
-		var _this$getValue4, _p$body4;
-		const { p } = (_this$getValue4 = this.getValue()) !== null && _this$getValue4 !== void 0 ? _this$getValue4 : {};
+		var _p$body4;
+		const { p } = this.getValue() ?? {};
 		if (p && Array.isArray((_p$body4 = p.body) === null || _p$body4 === void 0 ? void 0 : _p$body4.textRuns) && p.body.textRuns.length > 0) return isAllFormatInTextRuns("it", p.body) === 1 ? 1 : 0;
 		return this._getFontStyles()[0][0];
 	}
@@ -10882,8 +10749,8 @@ var Range = class Range {
 	* otherwise return FontWeight.NORMAL.
 	*/
 	getFontWeight() {
-		var _this$getValue5, _p$body5;
-		const { p } = (_this$getValue5 = this.getValue()) !== null && _this$getValue5 !== void 0 ? _this$getValue5 : {};
+		var _p$body5;
+		const { p } = this.getValue() ?? {};
 		if (p && Array.isArray((_p$body5 = p.body) === null || _p$body5 === void 0 ? void 0 : _p$body5.textRuns) && p.body.textRuns.length > 0) return isAllFormatInTextRuns("bl", p.body) === 1 ? 1 : 0;
 		return this._getFontWeights()[0][0];
 	}
@@ -11502,52 +11369,6 @@ var Rectangle = class Rectangle {
 		}).length > 0);
 	}
 	/**
-	* Gets the intersection range between two ranges
-	* @param src
-	* @param target
-	* @deprecated use `getIntersectRange` instead
-	* @example
-	* ```typescript
-	* const range1 = { startRow: 0, startColumn: 0, endRow: 2, endColumn: 2 };
-	* const range2 = { startRow: 1, startColumn: 1, endRow: 3, endColumn: 3 };
-	* const intersection = Rectangle.getIntersects(range1, range2);
-	* // intersection = { startRow: 1, startColumn: 1, endRow: 2, endColumn: 2 }
-	* ```
-	*/
-	static getIntersects(src, target) {
-		const currentStartRow = src.startRow;
-		const currentEndRow = src.endRow;
-		const currentStartColumn = src.startColumn;
-		const currentEndColumn = src.endColumn;
-		const incomingStartRow = target.startRow;
-		const incomingEndRow = target.endRow;
-		const incomingStartColumn = target.startColumn;
-		const incomingEndColumn = target.endColumn;
-		let startColumn;
-		let startRow;
-		let endColumn;
-		let endRow;
-		if (incomingStartRow <= currentEndRow) if (incomingStartRow >= currentStartRow) startRow = incomingStartRow;
-		else startRow = currentStartRow;
-		else return null;
-		if (incomingEndRow >= currentStartRow) if (incomingEndRow >= currentEndRow) endRow = currentEndRow;
-		else endRow = incomingEndRow;
-		else return null;
-		if (incomingStartColumn <= currentEndColumn) if (incomingStartColumn > currentStartColumn) startColumn = incomingStartColumn;
-		else startColumn = currentStartColumn;
-		else return null;
-		if (incomingEndColumn >= currentStartColumn) if (incomingEndColumn >= currentEndColumn) endColumn = currentEndColumn;
-		else endColumn = incomingEndColumn;
-		else return null;
-		return {
-			startRow,
-			endRow,
-			startColumn,
-			endColumn,
-			rangeType: 0
-		};
-	}
-	/**
 	* Checks if one range completely contains another range
 	* @param src
 	* @param target
@@ -12104,7 +11925,6 @@ function ABCToNumber(a) {
 const orderA = "A".charCodeAt(0);
 "Z".charCodeAt(0);
 const order_a = "a".charCodeAt(0);
-"z".charCodeAt(0);
 /**
 * column subscript number to letters
 * @param n number
@@ -12201,26 +12021,25 @@ let BaseFieldType = /* @__PURE__ */ function(BaseFieldType) {
 	BaseFieldType["Checkbox"] = "checkbox";
 	BaseFieldType["Link"] = "link";
 	BaseFieldType["Formula"] = "formula";
-	BaseFieldType["Lookup"] = "lookup";
-	BaseFieldType["Flow"] = "flow";
-	BaseFieldType["Button"] = "button";
 	BaseFieldType["Numbering"] = "numbering";
 	BaseFieldType["Phone"] = "phone";
 	BaseFieldType["Email"] = "email";
-	BaseFieldType["Location"] = "location";
-	BaseFieldType["Barcode"] = "barcode";
 	BaseFieldType["Progress"] = "progress";
 	BaseFieldType["Currency"] = "currency";
 	BaseFieldType["Rating"] = "rating";
-	BaseFieldType["TwoWayLink"] = "twoWayLink";
+	BaseFieldType["RecordLink"] = "recordLink";
 	BaseFieldType["RecordId"] = "recordId";
 	BaseFieldType["CreatedBy"] = "createdBy";
 	BaseFieldType["UpdatedBy"] = "updatedBy";
 	BaseFieldType["CreatedAt"] = "createdAt";
 	BaseFieldType["UpdatedAt"] = "updatedAt";
-	BaseFieldType["Summary"] = "summary";
 	return BaseFieldType;
 }({});
+/** Semantic roles supported by Base RecordLink fields. */
+let BaseRecordLinkRole = /* @__PURE__ */ function(BaseRecordLinkRole) {
+	BaseRecordLinkRole["Parent"] = "parent";
+	return BaseRecordLinkRole;
+}({});
 let BaseViewType = /* @__PURE__ */ function(BaseViewType) {
 	BaseViewType["Grid"] = "grid";
 	BaseViewType["Kanban"] = "kanban";
@@ -12229,6 +12048,56 @@ let BaseViewType = /* @__PURE__ */ function(BaseViewType) {
 	BaseViewType["Gallery"] = "gallery";
 	return BaseViewType;
 }({});
+/** Where a Base conditional color is painted when its condition matches. */
+const BaseConditionalColorTarget = {
+	/** Paint only the cell in the rule's field. */
+	CELL: "cell",
+	/** Paint the complete record row. */
+	ROW: "row",
+	/** Paint the rule's field column unconditionally; operator, operand, and date mode are ignored. */
+	COLUMN: "column"
+};
+/**
+* Operators supported by Base conditional coloring rules.
+*
+* Text, select, person, and similar fields support equality, containment, and
+* empty checks. Number, currency, progress, and rating fields support equality,
+* numeric comparison, and empty checks. Date-like fields support equality,
+* before/after, and empty checks. Checkbox fields support equality only.
+*/
+const BaseConditionalColorOperator = {
+	IS: "is",
+	IS_NOT: "isNot",
+	CONTAINS: "contains",
+	NOT_CONTAINS: "notContains",
+	IS_EMPTY: "isEmpty",
+	IS_NOT_EMPTY: "isNotEmpty",
+	GREATER_THAN: "greaterThan",
+	LESS_THAN: "lessThan",
+	BEFORE: "before",
+	AFTER: "after"
+};
+/**
+* Relative or exact date windows supported by date conditional coloring rules.
+*
+* With `IS`, dates inside the selected window match. `IS_NOT` matches dates
+* outside it, `BEFORE` matches dates before its start, and `AFTER` matches
+* dates after its end. Relative windows do not use an operand; `EXACT` does.
+*/
+const BaseConditionalDateMode = {
+	EXACT: "exact",
+	TODAY: "today",
+	TOMORROW: "tomorrow",
+	YESTERDAY: "yesterday",
+	THIS_WEEK: "thisWeek",
+	LAST_WEEK: "lastWeek",
+	THIS_MONTH: "thisMonth",
+	LAST_MONTH: "lastMonth",
+	PAST_7_DAYS: "past7",
+	NEXT_7_DAYS: "next7",
+	PAST_30_DAYS: "past30",
+	NEXT_30_DAYS: "next30"
+};
 let BaseFilterOperator = /* @__PURE__ */ function(BaseFilterOperator) {
 	BaseFilterOperator["IS"] = "is";
 	BaseFilterOperator["IS_NOT"] = "isNot";
@@ -12254,18 +12123,58 @@ let BaseSortDirection = /* @__PURE__ */ function(BaseSortDirection) {
 	BaseSortDirection["DESC"] = "desc";
 	return BaseSortDirection;
 }({});
+/** Why a stored Parent link cannot participate in the effective hierarchy. */
+let BaseHierarchyInvalidReason = /* @__PURE__ */ function(BaseHierarchyInvalidReason) {
+	BaseHierarchyInvalidReason["MissingParent"] = "missingParent";
+	BaseHierarchyInvalidReason["SelfParent"] = "selfParent";
+	BaseHierarchyInvalidReason["Cycle"] = "cycle";
+	BaseHierarchyInvalidReason["MaxDepth"] = "maxDepth";
+	return BaseHierarchyInvalidReason;
+}({});
+
+//#endregion
+//#region src/bases/record-identity.ts
+const BASE_RECORD_ID_FIELD_ID = "__record_id";
+const BASE_RECORD_ID_FIELD_NAME = "record-id";
+const BASE_RECORD_ID_PATTERN = /^[A-Za-z0-9_-]+$/;
+function createBaseRecordIdField() {
+	return {
+		id: BASE_RECORD_ID_FIELD_ID,
+		name: BASE_RECORD_ID_FIELD_NAME,
+		type: "recordId",
+		config: {},
+		system: true,
+		readonly: true
+	};
+}
+function isValidBaseRecordId(recordId) {
+	return BASE_RECORD_ID_PATTERN.test(recordId);
+}
+function isBaseRecordIdFieldName(name) {
+	return name.trim().toLowerCase() === BASE_RECORD_ID_FIELD_NAME;
+}
+function assertBaseTableRecordIdentity(table) {
+	const recordIdField = table.fields[BASE_RECORD_ID_FIELD_ID];
+	const recordIdFields = Object.values(table.fields).filter((field) => field.type === "recordId");
+	if (!recordIdField || recordIdFields.length !== 1 || recordIdField.type !== "recordId" || recordIdField.name !== "record-id" || recordIdField.system !== true || recordIdField.readonly !== true || table.fieldOrder[0] !== "__record_id" || table.primaryFieldId === "__record_id" || !table.fields[table.primaryFieldId]) throw new Error(`[BaseDataModel]: table "${table.id}" has an invalid record-id system field.`);
+	const conflictingField = Object.values(table.fields).find((field) => {
+		return field.id !== "__record_id" && isBaseRecordIdFieldName(field.name);
+	});
+	if (conflictingField) throw new Error(`[BaseDataModel]: field name "${conflictingField.name}" is reserved for the record-id system field.`);
+	for (const [recordKey, record] of Object.entries(table.records)) if (record.id !== recordKey || !isValidBaseRecordId(record.id) || record.values["__record_id"] !== record.id) throw new Error(`[BaseDataModel]: record "${recordKey}" has an invalid record-id projection.`);
+}
 
 //#endregion
 //#region src/bases/empty-snapshot.ts
 function createDefaultBaseTableSnapshot(options) {
-	var _options$now, _options$primaryField, _options$gridViewId, _options$recordCount, _options$primaryField2;
-	const now = (_options$now = options.now) !== null && _options$now !== void 0 ? _options$now : Date.now();
-	const primaryFieldId = (_options$primaryField = options.primaryFieldId) !== null && _options$primaryField !== void 0 ? _options$primaryField : generateRandomId(6);
-	const gridViewId = (_options$gridViewId = options.gridViewId) !== null && _options$gridViewId !== void 0 ? _options$gridViewId : generateRandomId(6);
-	const recordCount = (_options$recordCount = options.recordCount) !== null && _options$recordCount !== void 0 ? _options$recordCount : 5;
+	const now = options.now ?? Date.now();
+	const primaryFieldId = options.primaryFieldId ?? generateRandomId(6);
+	const gridViewId = options.gridViewId ?? generateRandomId(6);
+	const recordCount = options.recordCount ?? 0;
+	const recordIdField = createBaseRecordIdField();
 	const primaryField = {
 		id: primaryFieldId,
-		name: (_options$primaryField2 = options.primaryFieldName) !== null && _options$primaryField2 !== void 0 ? _options$primaryField2 : "Name",
+		name: options.primaryFieldName ?? "Name",
 		type: "text",
 		config: { placeholder: "bases.fieldConfig.textPlaceholder" }
 	};
@@ -12278,7 +12187,7 @@ function createDefaultBaseTableSnapshot(options) {
 		const recordId = `${options.id}-record-${index + 1}`;
 		records[recordId] = {
 			id: recordId,
-			values: {},
+			values: { [BASE_RECORD_ID_FIELD_ID]: recordId },
 			orderKey: String(index + 1).padStart(4, "0"),
 			createdAt: now,
 			updatedAt: now
@@ -12286,29 +12195,41 @@ function createDefaultBaseTableSnapshot(options) {
 		recordOrder.push(recordId);
 		rowIndex[recordId] = index;
 		rowId[index] = recordId;
-		cellData[index] = {};
+		cellData[index] = { 0: {
+			v: recordId,
+			t: 1
+		} };
 	}
 	const gridView = {
 		id: gridViewId,
 		tableId: options.id,
 		name: "Grid",
 		type: "grid",
-		fieldOrder: [primaryFieldId],
-		fieldSettings: {},
+		fieldOrder: [BASE_RECORD_ID_FIELD_ID, primaryFieldId],
+		fieldSettings: { [BASE_RECORD_ID_FIELD_ID]: { hidden: true } },
 		config: { frozenFieldCount: 1 }
 	};
 	return {
 		id: options.id,
 		name: options.name,
 		primaryFieldId,
-		fieldOrder: [primaryFieldId],
-		fields: { [primaryFieldId]: primaryField },
+		fieldOrder: [BASE_RECORD_ID_FIELD_ID, primaryFieldId],
+		fields: {
+			[BASE_RECORD_ID_FIELD_ID]: recordIdField,
+			[primaryFieldId]: primaryField
+		},
 		records,
 		recordOrder,
 		rowIndex,
 		rowId,
-		colIndex: { [primaryFieldId]: 0 },
-		colId: { 0: primaryFieldId },
+		colIndex: {
+			[BASE_RECORD_ID_FIELD_ID]: 0,
+			[primaryFieldId]: 1
+		},
+		colId: {
+			0: BASE_RECORD_ID_FIELD_ID,
+			1: primaryFieldId
+		},
 		cellData,
 		resources: {
 			attachmentSets: {},
@@ -12326,13 +12247,13 @@ function getEmptySnapshot(unitId = generateRandomId(), name = "", locale = "zhCN
 		name,
 		locale,
 		appVersion: version,
-		schemaVersion: 1,
+		schemaVersion: 2,
 		tableOrder: [tableId],
 		tables: { [tableId]: createDefaultBaseTableSnapshot({
 			id: tableId,
 			name: "Table 1",
 			now,
-			recordCount: 5
+			recordCount: 0
 		}) },
 		createdAt: now,
 		updatedAt: now
@@ -12386,8 +12307,7 @@ var BaseDataModel = class extends UnitModel {
 		this._name$.next(snapshot.name);
 	}
 	getRev() {
-		var _this$_snapshot$rev;
-		return (_this$_snapshot$rev = this._snapshot.rev) !== null && _this$_snapshot$rev !== void 0 ? _this$_snapshot$rev : 1;
+		return this._snapshot.rev ?? 1;
 	}
 	incrementRev() {
 		this._snapshot.rev = this.getRev() + 1;
@@ -12401,27 +12321,28 @@ var BaseDataModel = class extends UnitModel {
 	}
 };
 function normalizeBaseSnapshot(snapshot) {
-	var _snapshot$tables;
 	delete snapshot.compress;
 	delete snapshot.kind;
-	Object.values((_snapshot$tables = snapshot.tables) !== null && _snapshot$tables !== void 0 ? _snapshot$tables : {}).forEach((table) => {
+	Object.values(snapshot.tables ?? {}).forEach((table) => {
+		assertBaseTableRecordIdentity(table);
 		normalizeBaseTable(table);
+		assertMaterializedRecordIdentity(table);
 	});
 	return snapshot;
 }
 function isNormalizedBaseSnapshot(snapshot) {
-	var _snapshot$tables2;
-	return Object.values((_snapshot$tables2 = snapshot.tables) !== null && _snapshot$tables2 !== void 0 ? _snapshot$tables2 : {}).every((table) => isNormalizedBaseTable(table));
+	return Object.values(snapshot.tables ?? {}).every((table) => isNormalizedBaseTable(table));
 }
 function isNormalizedBaseTable(table) {
-	var _table$records, _table$fields;
-	const records = (_table$records = table.records) !== null && _table$records !== void 0 ? _table$records : {};
-	const fields = (_table$fields = table.fields) !== null && _table$fields !== void 0 ? _table$fields : {};
+	const records = table.records ?? {};
+	const fields = table.fields ?? {};
+	assertBaseTableRecordIdentity(table);
 	if (!Array.isArray(table.recordOrder) || !table.rowIndex || !table.rowId || !table.colIndex || !table.colId || !table.cellData || !table.resources || !table.resources.attachmentSets || !table.resources.attachments) return false;
 	if (Object.keys(records).length !== table.recordOrder.length) return false;
 	for (let index = 0; index < table.recordOrder.length; index++) {
+		var _table$cellData$index;
 		const recordId = table.recordOrder[index];
-		if (!records[recordId] || table.rowIndex[recordId] !== index || table.rowId[index] !== recordId) return false;
+		if (!records[recordId] || table.rowIndex[recordId] !== index || table.rowId[index] !== recordId || ((_table$cellData$index = table.cellData[index]) === null || _table$cellData$index === void 0 || (_table$cellData$index = _table$cellData$index[0]) === null || _table$cellData$index === void 0 ? void 0 : _table$cellData$index.v) !== recordId) return false;
 	}
 	for (let index = 0; index < table.fieldOrder.length; index++) {
 		const fieldId = table.fieldOrder[index];
@@ -12431,10 +12352,9 @@ function isNormalizedBaseTable(table) {
 	return true;
 }
 function normalizeBaseTable(table) {
-	var _table$records2, _table$fields2;
 	hydrateCompressedCellData(table);
-	const records = (_table$records2 = table.records) !== null && _table$records2 !== void 0 ? _table$records2 : {};
-	const fields = (_table$fields2 = table.fields) !== null && _table$fields2 !== void 0 ? _table$fields2 : {};
+	const records = table.records ?? {};
+	const fields = table.fields ?? {};
 	const orderedRecordIds = getOrderedRecordIds(table, records);
 	const orderedFieldIds = getOrderedFieldIds(table, fields);
 	table.recordOrder = orderedRecordIds;
@@ -12449,8 +12369,7 @@ function hydrateCompressedCellData(table) {
 	if (compressedCellData && !table.cellData) {
 		table.cellData = Object.create(null);
 		compressedCellData.forEach(([row, col, cell]) => {
-			var _row;
-			table.cellData[row] = (_row = table.cellData[row]) !== null && _row !== void 0 ? _row : {};
+			table.cellData[row] = table.cellData[row] ?? {};
 			const { c: _compressed, ...cellData } = cell;
 			table.cellData[row][col] = cellData;
 		});
@@ -12458,8 +12377,8 @@ function hydrateCompressedCellData(table) {
 	}
 }
 function getOrderedRecordIds(table, records) {
-	var _table$recordOrder$fi, _table$recordOrder;
-	const orderedRecordIds = (_table$recordOrder$fi = (_table$recordOrder = table.recordOrder) === null || _table$recordOrder === void 0 ? void 0 : _table$recordOrder.filter((recordId) => records[recordId])) !== null && _table$recordOrder$fi !== void 0 ? _table$recordOrder$fi : [];
+	var _table$recordOrder;
+	const orderedRecordIds = ((_table$recordOrder = table.recordOrder) === null || _table$recordOrder === void 0 ? void 0 : _table$recordOrder.filter((recordId) => records[recordId])) ?? [];
 	const orderedRecordIdSet = new Set(orderedRecordIds);
 	const missingRecords = Object.values(records).filter((record) => !orderedRecordIdSet.has(record.id));
 	if (!missingRecords.length) return orderedRecordIds;
@@ -12479,12 +12398,10 @@ function cloneBaseTableMutableMaps(table) {
 	table.resources.attachments = { ...table.resources.attachments };
 }
 function normalizeExistingCellData(table, fields) {
-	var _table$cellData;
-	Object.entries((_table$cellData = table.cellData) !== null && _table$cellData !== void 0 ? _table$cellData : {}).forEach(([rowKey, rowData]) => {
-		var _row2;
+	Object.entries(table.cellData ?? {}).forEach(([rowKey, rowData]) => {
 		const row = Number(rowKey);
 		table.cellData[row] = { ...rowData };
-		Object.entries((_row2 = table.cellData[row]) !== null && _row2 !== void 0 ? _row2 : {}).forEach(([colKey, cell]) => {
+		Object.entries(table.cellData[row] ?? {}).forEach(([colKey, cell]) => {
 			var _table$colId;
 			const col = Number(colKey);
 			const fieldId = (_table$colId = table.colId) === null || _table$colId === void 0 ? void 0 : _table$colId[col];
@@ -12493,44 +12410,58 @@ function normalizeExistingCellData(table, fields) {
 	});
 }
 function rebuildRowIndexes(table, records, orderedRecordIds) {
-	var _table$rowIndex;
 	orderedRecordIds.forEach((recordId, index) => {
 		if (table.rowIndex[recordId] == null) table.rowIndex[recordId] = index;
 	});
-	Object.entries((_table$rowIndex = table.rowIndex) !== null && _table$rowIndex !== void 0 ? _table$rowIndex : {}).forEach(([recordId, row]) => {
+	Object.entries(table.rowIndex ?? {}).forEach(([recordId, row]) => {
 		if (records[recordId]) table.rowId[row] = recordId;
 	});
 }
 function rebuildColumnIndexes(table, fields, orderedFieldIds) {
-	var _table$colIndex;
 	orderedFieldIds.forEach((fieldId, index) => {
 		if (table.colIndex[fieldId] == null) table.colIndex[fieldId] = index;
 	});
-	Object.entries((_table$colIndex = table.colIndex) !== null && _table$colIndex !== void 0 ? _table$colIndex : {}).forEach(([fieldId, col]) => {
+	Object.entries(table.colIndex ?? {}).forEach(([fieldId, col]) => {
 		if (fields[fieldId]) table.colId[col] = fieldId;
 	});
 }
 function hydrateRecordCellData(table, records, fields) {
+	const rowIndex = table.rowIndex ?? {};
+	const colIndex = table.colIndex ?? {};
+	const cellData = table.cellData ?? {};
+	table.rowIndex = rowIndex;
+	table.colIndex = colIndex;
+	table.cellData = cellData;
 	Object.values(records).forEach((record) => {
-		var _record$values;
-		const row = table.rowIndex[record.id];
+		const row = rowIndex[record.id];
 		if (row == null) return;
-		table.cellData[row] = { ...table.cellData[row] };
-		Object.entries((_record$values = record.values) !== null && _record$values !== void 0 ? _record$values : {}).forEach(([fieldId, value]) => {
+		cellData[row] = { ...cellData[row] };
+		cellData[row][0] = {
+			v: record.id,
+			t: 1
+		};
+		Object.entries(record.values ?? {}).forEach(([fieldId, value]) => {
 			const field = fields[fieldId];
 			if ((field === null || field === void 0 ? void 0 : field.type) === "attachment") writeAttachmentResources(table, record.id, fieldId, value);
-			const col = table.colIndex[fieldId];
+			const col = colIndex[fieldId];
 			if (col == null) return;
-			const existingCell = table.cellData[row][col];
+			const existingCell = cellData[row][col];
 			if (existingCell != null) {
-				table.cellData[row][col] = normalizeBaseCellData(existingCell, field);
-				if (shouldRefreshCellDataFromRecord(existingCell, field, value)) table.cellData[row][col] = toBaseCellData(value, field);
+				cellData[row][col] = normalizeBaseCellData(existingCell, field);
+				if (shouldRefreshCellDataFromRecord(existingCell, field, value)) cellData[row][col] = toBaseCellData(value, field);
 				return;
 			}
-			table.cellData[row][col] = toBaseCellData(value, field);
+			cellData[row][col] = toBaseCellData(value, field);
 		});
 	});
 }
+function assertMaterializedRecordIdentity(table) {
+	for (const record of Object.values(table.records)) {
+		var _table$rowIndex, _table$colIndex, _table$colId2, _table$cellData;
+		const row = (_table$rowIndex = table.rowIndex) === null || _table$rowIndex === void 0 ? void 0 : _table$rowIndex[record.id];
+		if (row == null || ((_table$colIndex = table.colIndex) === null || _table$colIndex === void 0 ? void 0 : _table$colIndex["__record_id"]) !== 0 || ((_table$colId2 = table.colId) === null || _table$colId2 === void 0 ? void 0 : _table$colId2[0]) !== "__record_id" || ((_table$cellData = table.cellData) === null || _table$cellData === void 0 || (_table$cellData = _table$cellData[row]) === null || _table$cellData === void 0 || (_table$cellData = _table$cellData[0]) === null || _table$cellData === void 0 ? void 0 : _table$cellData.v) !== record.id) throw new Error(`[BaseDataModel]: record "${record.id}" is missing its record-id cell projection.`);
+	}
+}
 function toBaseCellData(value, field) {
 	if (isBaseCellData(value)) {
 		if ((field === null || field === void 0 ? void 0 : field.type) === "attachment") return {
@@ -12549,10 +12480,9 @@ function toBaseCellData(value, field) {
 		t: 1
 	};
 	if ((field === null || field === void 0 ? void 0 : field.type) === "link" && value && typeof value === "object" && !Array.isArray(value)) {
-		var _ref, _link$text;
 		const link = value;
 		return {
-			v: String((_ref = (_link$text = link.text) !== null && _link$text !== void 0 ? _link$text : link.url) !== null && _ref !== void 0 ? _ref : ""),
+			v: String(link.text ?? link.url ?? ""),
 			t: 1
 		};
 	}
@@ -12586,8 +12516,7 @@ function writeAttachmentResources(table, recordId, fieldId, value) {
 	table.resources.attachments = { ...table.resources.attachments };
 	const key = `${fieldId}${BASE_ATTACHMENT_RESOURCE_KEY_SEPARATOR}${recordId}`;
 	table.resources.attachmentSets[key] = attachments.map((attachment, index) => {
-		var _attachment$id;
-		const id = String((_attachment$id = attachment.id) !== null && _attachment$id !== void 0 ? _attachment$id : `${key}${BASE_ATTACHMENT_RESOURCE_KEY_SEPARATOR}${index}`);
+		const id = String(attachment.id ?? `${key}${BASE_ATTACHMENT_RESOURCE_KEY_SEPARATOR}${index}`);
 		const normalizedAttachment = {
 			...attachment,
 			id
@@ -12616,6 +12545,7 @@ function normalizeAttachmentValue(value) {
 	return attachments;
 }
 function shouldRefreshCellDataFromRecord(cell, field, value) {
+	if ((field === null || field === void 0 ? void 0 : field.type) === "recordId") return cell.v !== value;
 	if ((field === null || field === void 0 ? void 0 : field.type) === "attachment") return cell.v !== "";
 	if (isListField(field)) return Array.isArray(value) && (cell.v == null || cell.v === "");
 	return false;
@@ -12644,9 +12574,8 @@ function primitiveText(value) {
 	if (value == null) return "";
 	if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return String(value);
 	if (typeof value === "object") {
-		var _ref2, _ref3, _record$id;
 		const record = value;
-		return String((_ref2 = (_ref3 = (_record$id = record.id) !== null && _record$id !== void 0 ? _record$id : record.name) !== null && _ref3 !== void 0 ? _ref3 : record.text) !== null && _ref2 !== void 0 ? _ref2 : "");
+		return String(record.id ?? record.name ?? record.text ?? "");
 	}
 	return String(value);
 }
@@ -12658,7 +12587,7 @@ function inferPrimitiveType(value) {
 }
 function normalizeBaseCellValueType(type, value) {
 	if (type === 1 || type === 2 || type === 3 || type === 4 || type == null) return type;
-	return inferPrimitiveType(value !== null && value !== void 0 ? value : null);
+	return inferPrimitiveType(value ?? null);
 }
 
 //#endregion
@@ -12828,10 +12757,7 @@ var InterceptorManager = class {
 		if (!this._interceptorsByName.has(key)) this._interceptorsByName.set(key, []);
 		const interceptors = this._interceptorsByName.get(key);
 		interceptors.push(interceptor);
-		this._interceptorsByName.set(key, interceptors.sort((a, b) => {
-			var _b$priority, _a$priority;
-			return ((_b$priority = b.priority) !== null && _b$priority !== void 0 ? _b$priority : 0) - ((_a$priority = a.priority) !== null && _a$priority !== void 0 ? _a$priority : 0);
-		}));
+		this._interceptorsByName.set(key, interceptors.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0)));
 		return () => remove(this._interceptorsByName.get(key), interceptor);
 	}
 	getInterceptPoints() {
@@ -12887,10 +12813,7 @@ var AsyncInterceptorManager = class {
 		if (!this._asyncInterceptorsByName.has(key)) this._asyncInterceptorsByName.set(key, []);
 		const interceptors = this._asyncInterceptorsByName.get(key);
 		interceptors.push(interceptor);
-		this._asyncInterceptorsByName.set(key, interceptors.sort((a, b) => {
-			var _b$priority2, _a$priority2;
-			return ((_b$priority2 = b.priority) !== null && _b$priority2 !== void 0 ? _b$priority2 : 0) - ((_a$priority2 = a.priority) !== null && _a$priority2 !== void 0 ? _a$priority2 : 0);
-		}));
+		this._asyncInterceptorsByName.set(key, interceptors.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0)));
 		return () => remove(this._asyncInterceptorsByName.get(key), interceptor);
 	}
 	getInterceptPoints() {
@@ -12996,7 +12919,8 @@ const blackLuminance = getLuminance(black.r, black.g, black.b);
 * @returns The inverted color.
 */
 function invertNormalizedColorByHSL(color) {
-	const originalContrast = getContrastRatio(whiteLuminance, getLuminance(color[0], color[1], color[2]));
+	const originalLuminance = getLuminance(color[0], color[1], color[2]);
+	const originalContrast = getContrastRatio(whiteLuminance, originalLuminance);
 	const hsl = rgbToHsl(color);
 	let l = 1 - hsl[2];
 	let newColor, newLuminance, newContrast;
@@ -13282,10 +13206,9 @@ function createParagraphId(existingIds) {
 	return paragraphId;
 }
 function cloneBodyWithFreshParagraphIds(body, _scope) {
-	var _cloned$paragraphs;
 	const cloned = cloneBody(body);
 	const existingIds = /* @__PURE__ */ new Set();
-	for (const paragraph of (_cloned$paragraphs = cloned.paragraphs) !== null && _cloned$paragraphs !== void 0 ? _cloned$paragraphs : []) paragraph.paragraphId = createParagraphId(existingIds);
+	for (const paragraph of cloned.paragraphs ?? []) paragraph.paragraphId = createParagraphId(existingIds);
 	return cloned;
 }
 function cloneParagraphWithId(paragraph, existingIds, preserveId) {
@@ -13479,10 +13402,6 @@ let DataStreamTreeTokenType = /* @__PURE__ */ function(DataStreamTreeTokenType)
 	DataStreamTreeTokenType["SPACE"] = " ";
 	return DataStreamTreeTokenType;
 }({});
-/** Wrap your stream in a pair of custom range tokens. */
-function makeCustomRangeStream(stream) {
-	return `${stream}`;
-}
 
 //#endregion
 //#region src/docs/data-model/text-x/build-utils/range-interval.ts
@@ -13661,13 +13580,12 @@ function normalizeTextRuns(textRuns, reserveEmptyTextRun = false) {
 * @param currentIndex Determining the index where the content will be inserted into the current content.
 */
 function insertTextRuns(body, insertBody, textLength, currentIndex) {
-	var _insertBody$textRuns;
 	const { textRuns } = body;
 	if (textRuns == null) return;
 	const newTextRuns = [];
 	const len = textRuns.length;
 	let hasInserted = false;
-	const insertTextRuns = (_insertBody$textRuns = insertBody.textRuns) !== null && _insertBody$textRuns !== void 0 ? _insertBody$textRuns : [];
+	const insertTextRuns = insertBody.textRuns ?? [];
 	if (insertTextRuns.length) for (const insertTextRun of insertTextRuns) {
 		insertTextRun.st += currentIndex;
 		insertTextRun.ed += currentIndex;
@@ -13715,9 +13633,9 @@ function insertTextRuns(body, insertBody, textLength, currentIndex) {
 * @param currentIndex Determining the index where the content will be inserted into the current content.
 */
 function insertParagraphs(body, insertBody, textLength, currentIndex, preserveMissingParagraphIds = false, originalDataStream = body.dataStream) {
-	var _insertBody$paragraph, _body$paragraphs;
+	var _insertBody$paragraph;
 	if (!body.paragraphs && !((_insertBody$paragraph = insertBody.paragraphs) === null || _insertBody$paragraph === void 0 ? void 0 : _insertBody$paragraph.length)) return;
-	(_body$paragraphs = body.paragraphs) !== null && _body$paragraphs !== void 0 || (body.paragraphs = []);
+	body.paragraphs ??= [];
 	const { paragraphs } = body;
 	const { paragraphs: insertParagraphs } = insertBody;
 	normalizeInsertedParagraphIdsForDocument(paragraphs, insertParagraphs, currentIndex, {
@@ -13750,7 +13668,6 @@ function insertParagraphs(body, insertBody, textLength, currentIndex, preserveMi
 	}
 }
 function normalizeInsertedParagraphIdsForDocument(paragraphs, insertParagraphs, currentIndex, options) {
-	var _options$reservedPara;
 	if (!paragraphs || !(insertParagraphs === null || insertParagraphs === void 0 ? void 0 : insertParagraphs.length)) return;
 	const splitParagraph = getParagraphSplitByInsert(paragraphs, currentIndex, options.dataStream);
 	const firstSplitInsertIndex = splitParagraph ? getFirstInsertedParagraphIndex(insertParagraphs) : -1;
@@ -13760,12 +13677,11 @@ function normalizeInsertedParagraphIdsForDocument(paragraphs, insertParagraphs,
 	const existingParagraphIds = collectParagraphIds(paragraphs);
 	const preservedInsertedParagraphIds = /* @__PURE__ */ new Set();
 	if (splitParagraphId) existingParagraphIds.delete(splitParagraphId);
-	for (const paragraphId of (_options$reservedPara = options.reservedParagraphIds) !== null && _options$reservedPara !== void 0 ? _options$reservedPara : []) existingParagraphIds.add(paragraphId);
+	for (const paragraphId of options.reservedParagraphIds ?? []) existingParagraphIds.add(paragraphId);
 	let splitRemainderParagraph;
 	if (splitParagraphId && firstSplitInsertIndex !== -1 && !shouldPreserveExplicitSplitParagraphId) {
-		var _options$preserveMiss;
 		const firstInsertParagraph = insertParagraphs[firstSplitInsertIndex];
-		splitRemainderParagraph = firstInsertedParagraphId != null && firstInsertedParagraphId !== splitParagraphId ? cloneInsertedParagraphWithId(firstInsertParagraph, existingParagraphIds, (_options$preserveMiss = options.preserveMissingParagraphIds) !== null && _options$preserveMiss !== void 0 ? _options$preserveMiss : false) : cloneParagraphWithId(firstInsertParagraph, existingParagraphIds, false);
+		splitRemainderParagraph = firstInsertedParagraphId != null && firstInsertedParagraphId !== splitParagraphId ? cloneInsertedParagraphWithId(firstInsertParagraph, existingParagraphIds, options.preserveMissingParagraphIds ?? false) : cloneParagraphWithId(firstInsertParagraph, existingParagraphIds, false);
 		if (options.freshenSplitParagraph && splitRemainderParagraph.paragraphId) splitParagraph.paragraphId = splitRemainderParagraph.paragraphId;
 	}
 	for (let i = 0, len = insertParagraphs.length; i < len; i++) {
@@ -13776,8 +13692,7 @@ function normalizeInsertedParagraphIdsForDocument(paragraphs, insertParagraphs,
 			continue;
 		}
 		if (i !== firstSplitInsertIndex || splitParagraphId == null || shouldPreserveExplicitSplitParagraphId) {
-			var _options$preserveMiss2;
-			insertParagraphs[i] = cloneInsertedParagraphWithId(insertParagraphs[i], existingParagraphIds, (_options$preserveMiss2 = options.preserveMissingParagraphIds) !== null && _options$preserveMiss2 !== void 0 ? _options$preserveMiss2 : false);
+			insertParagraphs[i] = cloneInsertedParagraphWithId(insertParagraphs[i], existingParagraphIds, options.preserveMissingParagraphIds ?? false);
 			continue;
 		}
 		insertParagraphs[i] = options.freshenSplitParagraph || firstInsertedParagraphId == null || firstInsertedParagraphId === splitParagraphId ? cloneParagraphWithId({
@@ -13786,13 +13701,13 @@ function normalizeInsertedParagraphIdsForDocument(paragraphs, insertParagraphs,
 		}, existingParagraphIds) : splitRemainderParagraph;
 	}
 	for (const insertParagraph of insertParagraphs) if (insertParagraph.paragraphId) {
-		var _options$reservedPara2;
-		(_options$reservedPara2 = options.reservedParagraphIds) === null || _options$reservedPara2 === void 0 || _options$reservedPara2.add(insertParagraph.paragraphId);
+		var _options$reservedPara;
+		(_options$reservedPara = options.reservedParagraphIds) === null || _options$reservedPara === void 0 || _options$reservedPara.add(insertParagraph.paragraphId);
 	}
 }
 function collectParagraphIds(paragraphs) {
 	const paragraphIds = /* @__PURE__ */ new Set();
-	for (const paragraph of paragraphs !== null && paragraphs !== void 0 ? paragraphs : []) if (paragraph.paragraphId) paragraphIds.add(paragraph.paragraphId);
+	for (const paragraph of paragraphs ?? []) if (paragraph.paragraphId) paragraphIds.add(paragraph.paragraphId);
 	return paragraphIds;
 }
 function cloneInsertedParagraphWithId(insertParagraph, existingParagraphIds, preserveMissingParagraphIds) {
@@ -13833,9 +13748,9 @@ function getFirstInsertedParagraphIndex(insertParagraphs) {
 	return index;
 }
 function insertSectionBreaks(body, insertBody, textLength, currentIndex) {
-	var _insertBody$sectionBr, _body$sectionBreaks;
+	var _insertBody$sectionBr;
 	if (!body.sectionBreaks && !((_insertBody$sectionBr = insertBody.sectionBreaks) === null || _insertBody$sectionBr === void 0 ? void 0 : _insertBody$sectionBr.length)) return;
-	(_body$sectionBreaks = body.sectionBreaks) !== null && _body$sectionBreaks !== void 0 || (body.sectionBreaks = []);
+	body.sectionBreaks ??= [];
 	const { sectionBreaks } = body;
 	const insertSectionBreaks = insertBody.sectionBreaks;
 	normalizeInsertedSectionIdsForDocument(sectionBreaks, insertSectionBreaks);
@@ -13862,9 +13777,8 @@ function insertSectionBreaks(body, insertBody, textLength, currentIndex) {
 	}
 }
 function normalizeInsertedSectionIdsForDocument(sectionBreaks, insertSectionBreaks, reservedSectionIds = /* @__PURE__ */ new Set()) {
-	var _sectionBreaks$map;
 	if (!(insertSectionBreaks === null || insertSectionBreaks === void 0 ? void 0 : insertSectionBreaks.length)) return;
-	const existingSectionIds = new Set((_sectionBreaks$map = sectionBreaks === null || sectionBreaks === void 0 ? void 0 : sectionBreaks.map((sectionBreak) => sectionBreak.sectionId)) !== null && _sectionBreaks$map !== void 0 ? _sectionBreaks$map : []);
+	const existingSectionIds = new Set((sectionBreaks === null || sectionBreaks === void 0 ? void 0 : sectionBreaks.map((sectionBreak) => sectionBreak.sectionId)) ?? []);
 	for (const sectionId of reservedSectionIds) existingSectionIds.add(sectionId);
 	for (let i = 0; i < insertSectionBreaks.length; i++) {
 		insertSectionBreaks[i] = cloneSectionBreakWithId(insertSectionBreaks[i], existingSectionIds);
@@ -14918,7 +14832,7 @@ function updateParagraphs(body, updateBody, textLength, currentIndex, coverType)
 				if (updateStartIndex === removeStartIndex) {
 					splitUpdateParagraphs.push({
 						startIndex: updateStartIndex,
-						paragraphId: updateParagraphId !== null && updateParagraphId !== void 0 ? updateParagraphId : removeParagraphId,
+						paragraphId: updateParagraphId ?? removeParagraphId,
 						paragraphStyle: newParagraphStyle,
 						bullet: newBullet
 					});
@@ -15188,7 +15102,7 @@ function isSegmentIntersects(start, end, start2, end2) {
 }
 function getParagraphsInRange(activeRange, paragraphs, dataStream, paragraphRanges) {
 	const { startOffset, endOffset } = activeRange;
-	const fullParagraphs = paragraphRanges !== null && paragraphRanges !== void 0 ? paragraphRanges : transformParagraphs(paragraphs, dataStream);
+	const fullParagraphs = paragraphRanges ?? transformParagraphs(paragraphs, dataStream);
 	const results = [];
 	let start = -1;
 	for (let i = 0; i < fullParagraphs.length; i++) {
@@ -15236,10 +15150,10 @@ function transformParagraphs(paragraphs, dataStream) {
 //#endregion
 //#region src/docs/data-model/text-x/build-utils/paragraph.ts
 const switchParagraphBullet = (params) => {
-	var _docDataModel$getSelf, _docDataModel$getSelf2;
+	var _docDataModel$getSelf;
 	const { paragraphs: currentParagraphs, segmentId, document: docDataModel } = params;
 	let listType = params.listType;
-	const paragraphs = (_docDataModel$getSelf = (_docDataModel$getSelf2 = docDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _docDataModel$getSelf2 === void 0 || (_docDataModel$getSelf2 = _docDataModel$getSelf2.getBody()) === null || _docDataModel$getSelf2 === void 0 ? void 0 : _docDataModel$getSelf2.paragraphs) !== null && _docDataModel$getSelf !== void 0 ? _docDataModel$getSelf : [];
+	const paragraphs = ((_docDataModel$getSelf = docDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _docDataModel$getSelf === void 0 || (_docDataModel$getSelf = _docDataModel$getSelf.getBody()) === null || _docDataModel$getSelf === void 0 ? void 0 : _docDataModel$getSelf.paragraphs) ?? [];
 	const isAlreadyList = currentParagraphs.every((paragraph) => {
 		var _paragraph$bullet;
 		return ((_paragraph$bullet = paragraph.bullet) === null || _paragraph$bullet === void 0 ? void 0 : _paragraph$bullet.listType.indexOf(listType)) === 0;
@@ -15261,7 +15175,6 @@ const switchParagraphBullet = (params) => {
 	memoryCursor.reset();
 	const textX = new TextX();
 	for (const paragraph of currentParagraphs) {
-		var _bullet$nestingLevel;
 		const { startIndex, paragraphId, paragraphStyle = {}, bullet } = paragraph;
 		textX.push({
 			t: "r",
@@ -15281,7 +15194,7 @@ const switchParagraphBullet = (params) => {
 					paragraphId,
 					paragraphStyle: { ...paragraphStyle },
 					bullet: {
-						nestingLevel: (_bullet$nestingLevel = bullet === null || bullet === void 0 ? void 0 : bullet.nestingLevel) !== null && _bullet$nestingLevel !== void 0 ? _bullet$nestingLevel : 0,
+						nestingLevel: (bullet === null || bullet === void 0 ? void 0 : bullet.nestingLevel) ?? 0,
 						textStyle: { fs: 20 },
 						listType,
 						listId
@@ -15295,9 +15208,9 @@ const switchParagraphBullet = (params) => {
 	return textX;
 };
 const toggleChecklistParagraph = (params) => {
-	var _docDataModel$getSelf3;
+	var _docDataModel$getSelf2;
 	const { paragraphIndex, segmentId, document: docDataModel } = params;
-	const paragraphs = (_docDataModel$getSelf3 = docDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _docDataModel$getSelf3 === void 0 || (_docDataModel$getSelf3 = _docDataModel$getSelf3.getBody()) === null || _docDataModel$getSelf3 === void 0 ? void 0 : _docDataModel$getSelf3.paragraphs;
+	const paragraphs = (_docDataModel$getSelf2 = docDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _docDataModel$getSelf2 === void 0 || (_docDataModel$getSelf2 = _docDataModel$getSelf2.getBody()) === null || _docDataModel$getSelf2 === void 0 ? void 0 : _docDataModel$getSelf2.paragraphs;
 	if (paragraphs == null) return false;
 	const currentParagraph = paragraphs.find((p) => p.startIndex === paragraphIndex);
 	if (!(currentParagraph === null || currentParagraph === void 0 ? void 0 : currentParagraph.bullet) || currentParagraph.bullet.listType.indexOf("CHECK_LIST") === -1) return false;
@@ -15331,15 +15244,14 @@ const toggleChecklistParagraph = (params) => {
 	return textX;
 };
 const setParagraphBullet = (params) => {
-	var _docDataModel$getSelf4;
+	var _docDataModel$getSelf3;
 	const { paragraphs: currentParagraphs, listType, listId: explicitListId, segmentId, document: docDataModel } = params;
-	if (((_docDataModel$getSelf4 = docDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _docDataModel$getSelf4 === void 0 || (_docDataModel$getSelf4 = _docDataModel$getSelf4.getBody()) === null || _docDataModel$getSelf4 === void 0 ? void 0 : _docDataModel$getSelf4.paragraphs) == null) return false;
-	const listId = explicitListId !== null && explicitListId !== void 0 ? explicitListId : generateRandomId(6);
+	if (((_docDataModel$getSelf3 = docDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _docDataModel$getSelf3 === void 0 || (_docDataModel$getSelf3 = _docDataModel$getSelf3.getBody()) === null || _docDataModel$getSelf3 === void 0 ? void 0 : _docDataModel$getSelf3.paragraphs) == null) return false;
+	const listId = explicitListId ?? generateRandomId(6);
 	const memoryCursor = new MemoryCursor();
 	memoryCursor.reset();
 	const textX = new TextX();
 	for (const paragraph of currentParagraphs) {
-		var _bullet$nestingLevel2;
 		const { startIndex, paragraphId, paragraphStyle = {}, bullet } = paragraph;
 		textX.push({
 			t: "r",
@@ -15355,7 +15267,7 @@ const setParagraphBullet = (params) => {
 					paragraphId,
 					paragraphStyle,
 					bullet: {
-						nestingLevel: (_bullet$nestingLevel2 = bullet === null || bullet === void 0 ? void 0 : bullet.nestingLevel) !== null && _bullet$nestingLevel2 !== void 0 ? _bullet$nestingLevel2 : 0,
+						nestingLevel: (bullet === null || bullet === void 0 ? void 0 : bullet.nestingLevel) ?? 0,
 						textStyle: (bullet === null || bullet === void 0 ? void 0 : bullet.listType) === listType ? bullet.textStyle : { fs: 20 },
 						listType,
 						listId
@@ -15390,17 +15302,15 @@ const PARAGRAPH_CONTAINER_TOKENS = /* @__PURE__ */ new Set([
 	""
 ]);
 function getParagraphContentStartOffset(body, paragraph) {
-	var _body$paragraphs;
 	let previousParagraph;
-	for (const candidate of (_body$paragraphs = body.paragraphs) !== null && _body$paragraphs !== void 0 ? _body$paragraphs : []) if (candidate.startIndex < paragraph.startIndex && (!previousParagraph || candidate.startIndex > previousParagraph.startIndex)) previousParagraph = candidate;
+	for (const candidate of body.paragraphs ?? []) if (candidate.startIndex < paragraph.startIndex && (!previousParagraph || candidate.startIndex > previousParagraph.startIndex)) previousParagraph = candidate;
 	let startOffset = previousParagraph ? previousParagraph.startIndex + 1 : 0;
 	while (startOffset < paragraph.startIndex && PARAGRAPH_CONTAINER_TOKENS.has(body.dataStream[startOffset])) startOffset++;
 	return startOffset;
 }
 function getParagraphContentStartOffsets(body) {
-	var _body$paragraphs2;
 	const startOffsets = /* @__PURE__ */ new Map();
-	const paragraphs = [...(_body$paragraphs2 = body.paragraphs) !== null && _body$paragraphs2 !== void 0 ? _body$paragraphs2 : []].sort((left, right) => left.startIndex - right.startIndex);
+	const paragraphs = [...body.paragraphs ?? []].sort((left, right) => left.startIndex - right.startIndex);
 	for (let index = 0; index < paragraphs.length; index++) {
 		const paragraph = paragraphs[index];
 		let startOffset = index > 0 ? paragraphs[index - 1].startIndex + 1 : 0;
@@ -15410,21 +15320,20 @@ function getParagraphContentStartOffsets(body) {
 	return startOffsets;
 }
 function getParagraphFollowingBlockOffset(body, paragraph) {
-	var _body$blockRanges;
-	const containingBlock = ((_body$blockRanges = body.blockRanges) !== null && _body$blockRanges !== void 0 ? _body$blockRanges : []).find((blockRange) => {
+	const containingBlock = (body.blockRanges ?? []).find((blockRange) => {
 		const interval = getBlockRangeInterval(blockRange);
 		return paragraph.startIndex > interval.startOffset && paragraph.startIndex < interval.endOffset - 1;
 	});
 	return containingBlock ? getBlockRangeInterval(containingBlock).endOffset : paragraph.startIndex + 1;
 }
 const changeParagraphBulletNestLevel = (params) => {
-	var _docDataModel$getSnap, _docDataModel$getBody, _docDataModel$getBody2;
+	var _docDataModel$getBody;
 	const { paragraphs: currentParagraphs, document: docDataModel, type } = params;
 	const memoryCursor = new MemoryCursor();
 	memoryCursor.reset();
 	const textX = new TextX();
-	const customLists = (_docDataModel$getSnap = docDataModel.getSnapshot().lists) !== null && _docDataModel$getSnap !== void 0 ? _docDataModel$getSnap : {};
-	const tables = (_docDataModel$getBody = (_docDataModel$getBody2 = docDataModel.getBody()) === null || _docDataModel$getBody2 === void 0 ? void 0 : _docDataModel$getBody2.tables) !== null && _docDataModel$getBody !== void 0 ? _docDataModel$getBody : [];
+	const customLists = docDataModel.getSnapshot().lists ?? {};
+	const tables = ((_docDataModel$getBody = docDataModel.getBody()) === null || _docDataModel$getBody === void 0 ? void 0 : _docDataModel$getBody.tables) ?? [];
 	const lists = {
 		...PRESET_LIST_TYPE,
 		...customLists
@@ -15465,13 +15374,13 @@ const changeParagraphBulletNestLevel = (params) => {
 	return textX;
 };
 const setParagraphStyle = (params) => {
-	var _segment$getBody$para, _segment$getBody, _segment$getBody$data, _segment$getBody2;
+	var _segment$getBody, _segment$getBody2;
 	const { textRanges, segmentId, document: docDataModel, style, paragraphTextRun, cursor, deleteLen, textX: _textX } = params;
 	const segment = docDataModel.getSelfOrHeaderFooterModel(segmentId);
-	const currentParagraphs = getParagraphsInRanges(textRanges, (_segment$getBody$para = segment === null || segment === void 0 || (_segment$getBody = segment.getBody()) === null || _segment$getBody === void 0 ? void 0 : _segment$getBody.paragraphs) !== null && _segment$getBody$para !== void 0 ? _segment$getBody$para : [], (_segment$getBody$data = segment === null || segment === void 0 || (_segment$getBody2 = segment.getBody()) === null || _segment$getBody2 === void 0 ? void 0 : _segment$getBody2.dataStream) !== null && _segment$getBody$data !== void 0 ? _segment$getBody$data : "");
+	const currentParagraphs = getParagraphsInRanges(textRanges, (segment === null || segment === void 0 || (_segment$getBody = segment.getBody()) === null || _segment$getBody === void 0 ? void 0 : _segment$getBody.paragraphs) ?? [], (segment === null || segment === void 0 || (_segment$getBody2 = segment.getBody()) === null || _segment$getBody2 === void 0 ? void 0 : _segment$getBody2.dataStream) ?? "");
 	const memoryCursor = new MemoryCursor();
 	if (cursor) memoryCursor.moveCursorTo(cursor);
-	const textX = _textX !== null && _textX !== void 0 ? _textX : new TextX();
+	const textX = _textX ?? new TextX();
 	currentParagraphs.sort((a, b) => a.startIndex - b.startIndex);
 	const start = Math.max(0, currentParagraphs[0].paragraphStart - 1);
 	if (start > memoryCursor.cursor) {
@@ -15635,8 +15544,7 @@ function getParagraphsSlice(body, startOffset, endOffset, type = 1) {
 	const sortedParagraphs = [...paragraphs].sort((a, b) => a.startIndex - b.startIndex);
 	const paragraphStartOffsets = getParagraphContentStartOffsets(body);
 	for (const paragraph of sortedParagraphs) {
-		var _paragraphStartOffset;
-		const paragraphStart = (_paragraphStartOffset = paragraphStartOffsets.get(paragraph.startIndex)) !== null && _paragraphStartOffset !== void 0 ? _paragraphStartOffset : 0;
+		const paragraphStart = paragraphStartOffsets.get(paragraph.startIndex) ?? 0;
 		const paragraphEnd = paragraph.startIndex;
 		if (paragraphEnd >= startOffset && paragraphEnd < endOffset || Math.max(paragraphStart, startOffset) < Math.min(paragraphEnd, endOffset)) {
 			const copy = Tools.deepClone(paragraph);
@@ -15787,11 +15695,11 @@ function getCustomDecorationSlice(body, startOffset, endOffset) {
 	return customDecorationSlice;
 }
 function composeTextRuns(updateDataTextRuns, originTextRuns, coverType) {
-	if (updateDataTextRuns == null || originTextRuns == null) return updateDataTextRuns !== null && updateDataTextRuns !== void 0 ? updateDataTextRuns : originTextRuns;
+	if (updateDataTextRuns == null || originTextRuns == null) return updateDataTextRuns ?? originTextRuns;
 	return coverTextRuns(updateDataTextRuns, originTextRuns, coverType);
 }
 function composeCustomRanges(updateDataCustomRanges, originCustomRanges, coverType) {
-	if (updateDataCustomRanges == null || originCustomRanges == null) return updateDataCustomRanges !== null && updateDataCustomRanges !== void 0 ? updateDataCustomRanges : originCustomRanges;
+	if (updateDataCustomRanges == null || originCustomRanges == null) return updateDataCustomRanges ?? originCustomRanges;
 	if (originCustomRanges.length === 0 || updateDataCustomRanges.length === 0) return updateDataCustomRanges;
 	if (originCustomRanges.length > 1 || updateDataCustomRanges.length > 1) throw new Error("Cannot cover multiple customRanges");
 	if (coverType === 1) return [{ ...updateDataCustomRanges[0] }];
@@ -15828,7 +15736,7 @@ function composeBody(thisBody, otherBody, coverType = 0) {
 		const { startIndex: thisStart } = thisParagraph;
 		const { startIndex: otherStart } = otherParagraph;
 		if (thisStart === otherStart) {
-			paragraphs.push(Tools.deepMerge(thisParagraph, otherParagraph));
+			paragraphs.push((0, lodash_es.merge)(thisParagraph, otherParagraph));
 			thisIndex++;
 			otherIndex++;
 		} else if (thisStart < otherStart) {
@@ -16271,7 +16179,7 @@ function transformBlockRanges(thisBlockRanges, otherBlockRanges, priority) {
 	if (!otherBlockRanges.length) return [];
 	return otherBlockRanges.map((otherBlockRange) => {
 		const thisBlockRange = thisBlockRanges.find((blockRange) => blockRange.blockId === otherBlockRange.blockId);
-		return thisBlockRange && priority ? Tools.deepMerge(otherBlockRange, thisBlockRange) : otherBlockRange;
+		return thisBlockRange && priority ? (0, lodash_es.merge)(otherBlockRange, thisBlockRange) : otherBlockRange;
 	});
 }
 
@@ -16620,7 +16528,7 @@ const isEmptyDocument = (dataStream) => {
 	return getPlainText(dataStream).replaceAll("\r", "") === "";
 };
 const fromPlainText = (text) => {
-	const dataStream = text.replace(/\n/g, "\r");
+	const dataStream = text.replace(/\r\n?|\n/g, "\r");
 	const paragraphs = [];
 	const existingParagraphIds = /* @__PURE__ */ new Set();
 	const customRanges = [];
@@ -16696,18 +16604,16 @@ var DocumentDataModelSimple = class extends UnitModel {
 		throw new Error("Method not implemented.");
 	}
 	constructor(snapshot) {
-		var _this$snapshot$title;
 		super();
 		_defineProperty(this, "type", _univerjs_protocol.UniverType.UNIVER_DOC);
 		_defineProperty(this, "_name$", new rxjs.BehaviorSubject(""));
 		_defineProperty(this, "name$", this._name$.asObservable());
 		_defineProperty(this, "snapshot", void 0);
 		this.snapshot = createDocumentSnapshot(snapshot);
-		this._name$.next((_this$snapshot$title = this.snapshot.title) !== null && _this$snapshot$title !== void 0 ? _this$snapshot$title : "No Title");
+		this._name$.next(this.snapshot.title ?? "No Title");
 	}
 	getRev() {
-		var _this$snapshot$rev;
-		return (_this$snapshot$rev = this.snapshot.rev) !== null && _this$snapshot$rev !== void 0 ? _this$snapshot$rev : 1;
+		return this.snapshot.rev ?? 1;
 	}
 	incrementRev() {
 		this.snapshot.rev = this.getRev() + 1;
@@ -16743,8 +16649,7 @@ var DocumentDataModelSimple = class extends UnitModel {
 		return this.snapshot;
 	}
 	getBulletPresetList() {
-		var _this$snapshot$lists;
-		const customLists = (_this$snapshot$lists = this.snapshot.lists) !== null && _this$snapshot$lists !== void 0 ? _this$snapshot$lists : {};
+		const customLists = this.snapshot.lists ?? {};
 		return {
 			...PRESET_LIST_TYPE,
 			...customLists
@@ -16783,8 +16688,8 @@ var DocumentDataModelSimple = class extends UnitModel {
 		const { documentStyle } = this.snapshot;
 		if (!documentStyle.pageSize) {
 			documentStyle.pageSize = {
-				width: width !== null && width !== void 0 ? width : Number.POSITIVE_INFINITY,
-				height: height !== null && height !== void 0 ? height : Number.POSITIVE_INFINITY
+				width: width ?? Number.POSITIVE_INFINITY,
+				height: height ?? Number.POSITIVE_INFINITY
 			};
 			return;
 		}
@@ -16818,16 +16723,15 @@ var DocumentDataModelSimple = class extends UnitModel {
 };
 var DocumentDataModel = class DocumentDataModel extends DocumentDataModelSimple {
 	constructor(snapshot) {
-		var _this$snapshot$id, _this$snapshot$title2;
 		super(Tools.isEmptyObject(snapshot) ? getEmptySnapshot$1() : snapshot);
 		_defineProperty(this, "_unitId", void 0);
 		_defineProperty(this, "headerModelMap", /* @__PURE__ */ new Map());
 		_defineProperty(this, "footerModelMap", /* @__PURE__ */ new Map());
 		_defineProperty(this, "change$", new rxjs.BehaviorSubject(0));
 		const UNIT_ID_LENGTH = 6;
-		this._unitId = (_this$snapshot$id = this.snapshot.id) !== null && _this$snapshot$id !== void 0 ? _this$snapshot$id : generateRandomId(UNIT_ID_LENGTH);
+		this._unitId = this.snapshot.id ?? generateRandomId(UNIT_ID_LENGTH);
 		this._initializeHeaderFooterModel();
-		this._name$.next((_this$snapshot$title2 = this.snapshot.title) !== null && _this$snapshot$title2 !== void 0 ? _this$snapshot$title2 : "");
+		this._name$.next(this.snapshot.title ?? "");
 	}
 	dispose() {
 		super.dispose();
@@ -16905,8 +16809,8 @@ var DocumentDataModel = class DocumentDataModel extends DocumentDataModelSimple
 		this._unitId = unitId;
 	}
 	getPlainText() {
-		var _this$getBody$dataStr, _this$getBody;
-		return getPlainText((_this$getBody$dataStr = (_this$getBody = this.getBody()) === null || _this$getBody === void 0 ? void 0 : _this$getBody.dataStream) !== null && _this$getBody$dataStr !== void 0 ? _this$getBody$dataStr : "");
+		var _this$getBody;
+		return getPlainText(((_this$getBody = this.getBody()) === null || _this$getBody === void 0 ? void 0 : _this$getBody.dataStream) ?? "");
 	}
 };
 
@@ -16914,16 +16818,36 @@ var DocumentDataModel = class DocumentDataModel extends DocumentDataModelSimple
 //#region src/docs/data-model/paragraph-style.ts
 function _definedStyle(style) {
 	if (style == null) return {};
-	return Object.fromEntries(Object.entries(style).filter(([, value]) => value != null));
+	const definedStyle = Tools.deepClone(style);
+	Tools.removeNull(definedStyle);
+	return definedStyle;
+}
+function _resolveNamedParagraphStyle(styles, styleId) {
+	if (!styles || !styleId) return {};
+	const visiting = /* @__PURE__ */ new Set();
+	const resolve = (currentStyleId) => {
+		if (visiting.has(currentStyleId)) return {};
+		const style = styles[currentStyleId];
+		if (!style || style.type !== 1) return {};
+		visiting.add(currentStyleId);
+		const base = style.basedOn ? resolve(style.basedOn) : {};
+		visiting.delete(currentStyleId);
+		return {
+			...base,
+			..._definedStyle(style.paragraphStyle)
+		};
+	};
+	return resolve(styleId);
 }
 function resolveDocumentParagraphStyle(documentStyle, paragraphStyle, options = {}) {
-	var _options$useLegacyMod;
+	const legacyStyle = options.useLegacyModernDefaults ?? (documentStyle === null || documentStyle === void 0 ? void 0 : documentStyle.documentFlavor) === 2 ? {
+		lineSpacing: DEFAULT_DOCUMENT_PARAGRAPH_LINE_SPACING,
+		spaceAbove: { v: 0 },
+		spaceBelow: { v: 12 }
+	} : {};
 	const documentDefaults = {
-		...((_options$useLegacyMod = options.useLegacyModernDefaults) !== null && _options$useLegacyMod !== void 0 ? _options$useLegacyMod : (documentStyle === null || documentStyle === void 0 ? void 0 : documentStyle.documentFlavor) === 2) ? {
-			lineSpacing: DEFAULT_DOCUMENT_PARAGRAPH_LINE_SPACING,
-			spaceAbove: { v: 0 },
-			spaceBelow: { v: 12 }
-		} : {},
+		...(documentStyle === null || documentStyle === void 0 ? void 0 : documentStyle.documentFlavor) === 1 ? { widowControl: 1 } : {},
+		...legacyStyle,
 		..._definedStyle(documentStyle === null || documentStyle === void 0 ? void 0 : documentStyle.defaultParagraphStyle)
 	};
 	if (options.excludeDocumentOuterSpacing) {
@@ -16931,10 +16855,13 @@ function resolveDocumentParagraphStyle(documentStyle, paragraphStyle, options =
 		delete documentDefaults.spaceBelow;
 	}
 	const definedParagraphStyle = _definedStyle(paragraphStyle);
-	const namedStyle = definedParagraphStyle.namedStyleType == null ? null : NAMED_STYLE_SPACE_MAP[definedParagraphStyle.namedStyleType];
+	const referencedParagraphStyle = _resolveNamedParagraphStyle(options.styles, options.paragraphStyleId);
+	const namedStyleType = definedParagraphStyle.namedStyleType ?? referencedParagraphStyle.namedStyleType;
+	const namedStyle = namedStyleType == null ? null : NAMED_STYLE_SPACE_MAP[namedStyleType];
 	return Tools.deepClone({
 		...documentDefaults,
 		...namedStyle,
+		...referencedParagraphStyle,
 		...definedParagraphStyle
 	});
 }
@@ -17095,10 +17022,10 @@ function getIntersectingCustomRanges(startIndex, endIndex, customRanges, rangeTy
 	return relativeCustomRanges;
 }
 function getSelectionForAddCustomRange(range, body) {
-	var _body$customRanges, _ranges$0$startIndex, _ranges$, _ranges$endIndex, _ranges;
-	const ranges = getIntersectingCustomRanges(range.startOffset, range.collapsed ? range.startOffset : range.endOffset - 1, (_body$customRanges = body.customRanges) !== null && _body$customRanges !== void 0 ? _body$customRanges : []);
-	const startOffset = Math.min(range.startOffset, (_ranges$0$startIndex = (_ranges$ = ranges[0]) === null || _ranges$ === void 0 ? void 0 : _ranges$.startIndex) !== null && _ranges$0$startIndex !== void 0 ? _ranges$0$startIndex : Infinity);
-	const endOffset = Math.max(range.endOffset, ((_ranges$endIndex = (_ranges = ranges[ranges.length - 1]) === null || _ranges === void 0 ? void 0 : _ranges.endIndex) !== null && _ranges$endIndex !== void 0 ? _ranges$endIndex : -Infinity) + 1);
+	var _ranges$, _ranges;
+	const ranges = getIntersectingCustomRanges(range.startOffset, range.collapsed ? range.startOffset : range.endOffset - 1, body.customRanges ?? []);
+	const startOffset = Math.min(range.startOffset, ((_ranges$ = ranges[0]) === null || _ranges$ === void 0 ? void 0 : _ranges$.startIndex) ?? Infinity);
+	const endOffset = Math.max(range.endOffset, (((_ranges = ranges[ranges.length - 1]) === null || _ranges === void 0 ? void 0 : _ranges.endIndex) ?? -Infinity) + 1);
 	return {
 		startOffset,
 		endOffset,
@@ -17109,7 +17036,7 @@ function getSelectionForAddCustomRange(range, body) {
 //#endregion
 //#region src/docs/data-model/text-x/build-utils/text-x-utils.ts
 function deleteCustomRangeTextX(params) {
-	var _documentDataModel$ge, _insert$dataStream$le;
+	var _documentDataModel$ge;
 	const { rangeId, segmentId, documentDataModel, insert } = params;
 	const range = (_documentDataModel$ge = documentDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _documentDataModel$ge === void 0 || (_documentDataModel$ge = _documentDataModel$ge.getBody()) === null || _documentDataModel$ge === void 0 || (_documentDataModel$ge = _documentDataModel$ge.customRanges) === null || _documentDataModel$ge === void 0 ? void 0 : _documentDataModel$ge.find((r) => r.rangeId === rangeId);
 	if (!range) return false;
@@ -17133,7 +17060,7 @@ function deleteCustomRangeTextX(params) {
 		body: insert,
 		len: insert.dataStream.length
 	});
-	const end = endIndex + 1 + ((_insert$dataStream$le = insert === null || insert === void 0 ? void 0 : insert.dataStream.length) !== null && _insert$dataStream$le !== void 0 ? _insert$dataStream$le : 0);
+	const end = endIndex + 1 + ((insert === null || insert === void 0 ? void 0 : insert.dataStream.length) ?? 0);
 	textX.selections = [{
 		startOffset: end,
 		endOffset: end,
@@ -17147,17 +17074,16 @@ function addCustomRangeTextX(param) {
 	const textX = new TextX();
 	let changed = false;
 	ranges.forEach((range) => {
-		var _body$customRanges, _body$paragraphs, _body$customBlocks;
 		const actualRange = getSelectionForAddCustomRange(range, body);
 		if (!actualRange) return false;
 		if (!body) return false;
 		const { startOffset, endOffset } = actualRange;
-		const customRanges = (_body$customRanges = body.customRanges) !== null && _body$customRanges !== void 0 ? _body$customRanges : [];
+		const customRanges = body.customRanges ?? [];
 		const addCustomRange = (startIndex, endIndex, index) => {
-			var _relativeCustomRanges, _relativeCustomRanges2, _relativeCustomRanges3, _relativeCustomRanges4;
+			var _relativeCustomRanges, _relativeCustomRanges2;
 			const relativeCustomRanges = getIntersectingCustomRanges(startIndex, endIndex, customRanges, rangeType);
-			const rangeStartIndex = Math.min((_relativeCustomRanges = (_relativeCustomRanges2 = relativeCustomRanges[0]) === null || _relativeCustomRanges2 === void 0 ? void 0 : _relativeCustomRanges2.startIndex) !== null && _relativeCustomRanges !== void 0 ? _relativeCustomRanges : Infinity, startIndex);
-			const rangeEndIndex = Math.max((_relativeCustomRanges3 = (_relativeCustomRanges4 = relativeCustomRanges[relativeCustomRanges.length - 1]) === null || _relativeCustomRanges4 === void 0 ? void 0 : _relativeCustomRanges4.endIndex) !== null && _relativeCustomRanges3 !== void 0 ? _relativeCustomRanges3 : -Infinity, endIndex);
+			const rangeStartIndex = Math.min(((_relativeCustomRanges = relativeCustomRanges[0]) === null || _relativeCustomRanges === void 0 ? void 0 : _relativeCustomRanges.startIndex) ?? Infinity, startIndex);
+			const rangeEndIndex = Math.max(((_relativeCustomRanges2 = relativeCustomRanges[relativeCustomRanges.length - 1]) === null || _relativeCustomRanges2 === void 0 ? void 0 : _relativeCustomRanges2.endIndex) ?? -Infinity, endIndex);
 			const customRange = {
 				rangeId: index ? `${rangeId}$${index}` : rangeId,
 				rangeType,
@@ -17181,8 +17107,8 @@ function addCustomRangeTextX(param) {
 			});
 			cursor = rangeEndIndex + 1;
 		};
-		const relativeParagraphs = ((_body$paragraphs = body.paragraphs) !== null && _body$paragraphs !== void 0 ? _body$paragraphs : []).filter((p) => p.startIndex < endOffset && p.startIndex > startOffset);
-		const customBlocks = ((_body$customBlocks = body.customBlocks) !== null && _body$customBlocks !== void 0 ? _body$customBlocks : []).filter((block) => block.startIndex < endOffset && block.startIndex > startOffset);
+		const relativeParagraphs = (body.paragraphs ?? []).filter((p) => p.startIndex < endOffset && p.startIndex > startOffset);
+		const customBlocks = (body.customBlocks ?? []).filter((block) => block.startIndex < endOffset && block.startIndex > startOffset);
 		excludePointsFromRange([startOffset, endOffset - 1], [...relativeParagraphs.map((p) => p.startIndex), ...customBlocks.map((b) => b.startIndex)]).forEach(([start, end], i) => addCustomRange(start, end, i));
 		changed = true;
 		textX.selections = [{
@@ -17212,8 +17138,7 @@ function protectDeletedColumnBoundaryTokens(body, selections, protectedOffsets)
 	}
 }
 function protectPartiallyDeletedBlockBoundaryTokens(body, selections, protectedOffsets) {
-	var _body$blockRanges;
-	for (const blockRange of (_body$blockRanges = body.blockRanges) !== null && _body$blockRanges !== void 0 ? _body$blockRanges : []) {
+	for (const blockRange of body.blockRanges ?? []) {
 		const blockInterval = getBlockRangeInterval(blockRange);
 		if (selections.some((selection) => selection.startOffset <= blockInterval.startOffset && selection.endOffset >= blockInterval.endOffset)) continue;
 		if (isOffsetDeleted(blockRange.startIndex, selections)) protectedOffsets.add(blockRange.startIndex);
@@ -17221,8 +17146,7 @@ function protectPartiallyDeletedBlockBoundaryTokens(body, selections, protectedO
 	}
 }
 function collectBlockTextContainers(body) {
-	var _body$blockRanges2, _body$paragraphs2, _body$sectionBreaks;
-	const blockRanges = [...(_body$blockRanges2 = body.blockRanges) !== null && _body$blockRanges2 !== void 0 ? _body$blockRanges2 : []].sort((left, right) => left.startIndex - right.startIndex);
+	const blockRanges = [...body.blockRanges ?? []].sort((left, right) => left.startIndex - right.startIndex);
 	const containers = blockRanges.map((blockRange) => {
 		const atomicRange = getBlockRangeInterval(blockRange);
 		return {
@@ -17250,8 +17174,8 @@ function collectBlockTextContainers(body) {
 		}
 		if (index >= 0) containers[index][key].push(offset);
 	};
-	((_body$paragraphs2 = body.paragraphs) !== null && _body$paragraphs2 !== void 0 ? _body$paragraphs2 : []).forEach((paragraph) => assignPoint(paragraph.startIndex, "paragraphs"));
-	((_body$sectionBreaks = body.sectionBreaks) !== null && _body$sectionBreaks !== void 0 ? _body$sectionBreaks : []).forEach((sectionBreak) => assignPoint(sectionBreak.startIndex, "sectionBreaks"));
+	(body.paragraphs ?? []).forEach((paragraph) => assignPoint(paragraph.startIndex, "paragraphs"));
+	(body.sectionBreaks ?? []).forEach((sectionBreak) => assignPoint(sectionBreak.startIndex, "sectionBreaks"));
 	return containers;
 }
 function collectStructuralTextContainers(body) {
@@ -17304,10 +17228,9 @@ function collectStructuralTextContainers(body) {
 	return containers;
 }
 function protectRequiredContainerChildren(container, selections, insertBody, insertOffset, protectedOffsets) {
-	var _insertBody$dataStrea;
 	if (isAtomicContainerDeleted(container, selections)) return;
 	const insertAppliesToContainer = insertBody && isInsertInContainer(insertOffset, container);
-	const insertDataStream = (_insertBody$dataStrea = insertBody === null || insertBody === void 0 ? void 0 : insertBody.dataStream) !== null && _insertBody$dataStrea !== void 0 ? _insertBody$dataStrea : "";
+	const insertDataStream = (insertBody === null || insertBody === void 0 ? void 0 : insertBody.dataStream) ?? "";
 	const insertHasParagraph = insertDataStream.includes("\r");
 	const insertHasSectionBreak = insertDataStream.includes("\n");
 	if (container.require === "paragraph-or-section") {
@@ -17516,12 +17439,12 @@ const replaceSelectionTextRuns = (params) => {
 					t: "r",
 					body: isTextRunsEqual(textRunsSlice, oldTextRunsSlice) ? void 0 : {
 						textRuns: textRunsSlice === null || textRunsSlice === void 0 ? void 0 : textRunsSlice.map((textRun) => {
-							var _textRun$ts, _textRun$ts$cl$rgb, _textRun$ts2, _textRun$ts3;
+							var _textRun$ts, _textRun$ts2, _textRun$ts3;
 							return {
 								...textRun,
 								ts: {
 									...textRun.ts,
-									cl: ((_textRun$ts = textRun.ts) === null || _textRun$ts === void 0 || (_textRun$ts = _textRun$ts.cl) === null || _textRun$ts === void 0 || (_textRun$ts = _textRun$ts.rgb) === null || _textRun$ts === void 0 ? void 0 : _textRun$ts.includes(".")) ? { rgb: themeService.getColorFromTheme((_textRun$ts$cl$rgb = (_textRun$ts2 = textRun.ts) === null || _textRun$ts2 === void 0 || (_textRun$ts2 = _textRun$ts2.cl) === null || _textRun$ts2 === void 0 ? void 0 : _textRun$ts2.rgb) !== null && _textRun$ts$cl$rgb !== void 0 ? _textRun$ts$cl$rgb : "") } : (_textRun$ts3 = textRun.ts) === null || _textRun$ts3 === void 0 ? void 0 : _textRun$ts3.cl
+									cl: ((_textRun$ts = textRun.ts) === null || _textRun$ts === void 0 || (_textRun$ts = _textRun$ts.cl) === null || _textRun$ts === void 0 || (_textRun$ts = _textRun$ts.rgb) === null || _textRun$ts === void 0 ? void 0 : _textRun$ts.includes(".")) ? { rgb: themeService.getColorFromTheme(((_textRun$ts2 = textRun.ts) === null || _textRun$ts2 === void 0 || (_textRun$ts2 = _textRun$ts2.cl) === null || _textRun$ts2 === void 0 ? void 0 : _textRun$ts2.rgb) ?? "") } : (_textRun$ts3 = textRun.ts) === null || _textRun$ts3 === void 0 ? void 0 : _textRun$ts3.cl
 								}
 							};
 						}),
@@ -17573,7 +17496,7 @@ function getCustomBlockIdsInSelections(body, selections) {
 	return customBlockIds;
 }
 const addDrawing = (param) => {
-	var _documentDataModel$ge, _documentDataModel$ge2, _documentDataModel$ge3;
+	var _documentDataModel$ge, _documentDataModel$ge2;
 	const { selection, documentDataModel, drawings } = param;
 	const { collapsed, startOffset, segmentId } = selection;
 	const textX = new TextX();
@@ -17581,21 +17504,20 @@ const addDrawing = (param) => {
 	const rawActions = [];
 	const body = (_documentDataModel$ge = documentDataModel.getSelfOrHeaderFooterModel(segmentId)) === null || _documentDataModel$ge === void 0 ? void 0 : _documentDataModel$ge.getBody();
 	if (!body) return false;
-	const drawingOrderLength = (_documentDataModel$ge2 = (_documentDataModel$ge3 = documentDataModel.getSnapshot().drawingsOrder) === null || _documentDataModel$ge3 === void 0 ? void 0 : _documentDataModel$ge3.length) !== null && _documentDataModel$ge2 !== void 0 ? _documentDataModel$ge2 : 0;
+	const drawingOrderLength = ((_documentDataModel$ge2 = documentDataModel.getSnapshot().drawingsOrder) === null || _documentDataModel$ge2 === void 0 ? void 0 : _documentDataModel$ge2.length) ?? 0;
 	let removeDrawingLen = 0;
-	const insertOffset = collapsed ? normalizeDrawingInsertOffset(body, startOffset !== null && startOffset !== void 0 ? startOffset : 0) : startOffset !== null && startOffset !== void 0 ? startOffset : 0;
+	const insertOffset = collapsed ? normalizeDrawingInsertOffset(body, startOffset ?? 0) : startOffset ?? 0;
 	if (collapsed) {
 		if (insertOffset > 0) textX.push({
 			t: "r",
 			len: insertOffset
 		});
 	} else {
-		var _documentDataModel$ge4, _documentDataModel$ge5;
 		const dos = deleteSelectionTextX([selection], body, 0, null, false);
 		textX.push(...dos);
 		const removedCustomBlockIds = getCustomBlockIdsInSelections(body, [selection]);
-		const drawings = (_documentDataModel$ge4 = documentDataModel.getDrawings()) !== null && _documentDataModel$ge4 !== void 0 ? _documentDataModel$ge4 : {};
-		const drawingOrder = (_documentDataModel$ge5 = documentDataModel.getDrawingsOrder()) !== null && _documentDataModel$ge5 !== void 0 ? _documentDataModel$ge5 : [];
+		const drawings = documentDataModel.getDrawings() ?? {};
+		const drawingOrder = documentDataModel.getDrawingsOrder() ?? [];
 		const sortedRemovedCustomBlockIds = removedCustomBlockIds.sort((a, b) => {
 			if (drawingOrder.indexOf(a) > drawingOrder.indexOf(b)) return -1;
 			else if (drawingOrder.indexOf(a) < drawingOrder.indexOf(b)) return 1;
@@ -17633,7 +17555,16 @@ const addDrawing = (param) => {
 	}, null);
 };
 function normalizeDrawingInsertOffset(body, offset) {
-	return offset === 0 && body.dataStream[0] === "\r" ? 1 : offset;
+	const { dataStream } = body;
+	if (offset === 0 && dataStream[0] === "\r") return 1;
+	if (dataStream[offset] === "\n" && dataStream[offset - 1] === "\r" && isInsideTableCell(dataStream, offset)) return offset - 1;
+	return offset;
+}
+function isInsideTableCell(dataStream, offset) {
+	let cellDepth = 0;
+	for (let index = 0; index < offset; index++) if (dataStream[index] === "") cellDepth++;
+	else if (dataStream[index] === "") cellDepth = Math.max(0, cellDepth - 1);
+	return cellDepth > 0;
 }
 function buildDrawingInsertBody(body, drawings, insertOffset) {
 	var _body$paragraphs;
@@ -17713,8 +17644,8 @@ function collectNewStructuralStartOffsets(previousBody, nextBody) {
 	return Array.from(new Set(offsets)).sort((left, right) => left - right);
 }
 function collectNewStartOffsets(previousItems, nextItems, getId) {
-	const previousIds = new Set((previousItems !== null && previousItems !== void 0 ? previousItems : []).map(getId));
-	return (nextItems !== null && nextItems !== void 0 ? nextItems : []).filter((item) => !previousIds.has(getId(item))).map((item) => item.startIndex);
+	const previousIds = new Set((previousItems ?? []).map(getId));
+	return (nextItems ?? []).filter((item) => !previousIds.has(getId(item))).map((item) => item.startIndex);
 }
 
 //#endregion
@@ -17808,8 +17739,7 @@ function normalizeBody$1(body) {
 	return body;
 }
 function normalizeData(data) {
-	var _data$body;
-	data.body = normalizeBody$1((_data$body = data.body) !== null && _data$body !== void 0 ? _data$body : { dataStream: "" });
+	data.body = normalizeBody$1(data.body ?? { dataStream: "" });
 	if (!data.drawingsOrder) data.drawingsOrder = [];
 	if (!data.drawings) data.drawings = {};
 	if (!data.documentStyle) data.documentStyle = {};
@@ -17852,8 +17782,8 @@ function normalizeRichTextParagraphStyle(style) {
 	};
 }
 function hasRichTextContent(data) {
-	var _data$body$dataStream, _data$body2;
-	return ((_data$body$dataStream = (_data$body2 = data.body) === null || _data$body2 === void 0 ? void 0 : _data$body2.dataStream) !== null && _data$body$dataStream !== void 0 ? _data$body$dataStream : "").replace(/\r|\n/g, "").length > 0;
+	var _data$body;
+	return (((_data$body = data.body) === null || _data$body === void 0 ? void 0 : _data$body.dataStream) ?? "").replace(/\r|\n/g, "").length > 0;
 }
 /**
 * Represents a read-only font style value object.
@@ -19256,8 +19186,8 @@ var RichTextValue = class RichTextValue {
 	* ```
 	*/
 	toPlainText() {
-		var _this$_data$body$data, _this$_data$body;
-		return BuildTextUtils.transform.getPlainText((_this$_data$body$data = (_this$_data$body = this._data.body) === null || _this$_data$body === void 0 ? void 0 : _this$_data$body.dataStream) !== null && _this$_data$body$data !== void 0 ? _this$_data$body$data : "").replaceAll("\r", "\n");
+		var _this$_data$body;
+		return BuildTextUtils.transform.getPlainText(((_this$_data$body = this._data.body) === null || _this$_data$body === void 0 ? void 0 : _this$_data$body.dataStream) ?? "").replaceAll("\r", "\n");
 	}
 	/**
 	* Gets the paragraph style of the current RichTextValue instance
@@ -19295,14 +19225,13 @@ var RichTextValue = class RichTextValue {
 	* ```
 	*/
 	getParagraphs() {
-		var _this$_data$body$para, _this$_data$body4;
-		const paragraphs = (_this$_data$body$para = (_this$_data$body4 = this._data.body) === null || _this$_data$body4 === void 0 ? void 0 : _this$_data$body4.paragraphs) !== null && _this$_data$body$para !== void 0 ? _this$_data$body$para : [];
-		let start = 0;
-		return paragraphs.map((paragraph) => {
-			const sub = this.slice(start, paragraph.startIndex);
-			start = paragraph.startIndex;
-			return sub;
-		});
+		const body = this._data.body;
+		if (!body) return [];
+		const startOffsets = getParagraphContentStartOffsets(body);
+		return (body.paragraphs ?? []).map((paragraph) => RichTextBuilder.create(createParagraphSnapshot(this._data, paragraph.paragraphId, {
+			startOffset: startOffsets.get(paragraph.startIndex) ?? 0,
+			endOffset: paragraph.startIndex
+		})));
 	}
 	/**
 	* Gets the text runs of the current RichTextValue instance
@@ -19314,8 +19243,8 @@ var RichTextValue = class RichTextValue {
 	* ```
 	*/
 	getTextRuns() {
-		var _this$_data$body$text, _this$_data$body5;
-		return ((_this$_data$body$text = (_this$_data$body5 = this._data.body) === null || _this$_data$body5 === void 0 ? void 0 : _this$_data$body5.textRuns) !== null && _this$_data$body$text !== void 0 ? _this$_data$body$text : []).map((t) => ({
+		var _this$_data$body4;
+		return (((_this$_data$body4 = this._data.body) === null || _this$_data$body4 === void 0 ? void 0 : _this$_data$body4.textRuns) ?? []).map((t) => ({
 			...t,
 			ts: t.ts ? TextStyleValue.create(t.ts) : null
 		}));
@@ -19330,8 +19259,8 @@ var RichTextValue = class RichTextValue {
 	* ```
 	*/
 	getLinks() {
-		var _this$_data$body$cust, _this$_data$body6;
-		return (_this$_data$body$cust = (_this$_data$body6 = this._data.body) === null || _this$_data$body6 === void 0 || (_this$_data$body6 = _this$_data$body6.customRanges) === null || _this$_data$body6 === void 0 ? void 0 : _this$_data$body6.filter((r) => r.rangeType === 0)) !== null && _this$_data$body$cust !== void 0 ? _this$_data$body$cust : [];
+		var _this$_data$body5;
+		return ((_this$_data$body5 = this._data.body) === null || _this$_data$body5 === void 0 || (_this$_data$body5 = _this$_data$body5.customRanges) === null || _this$_data$body5 === void 0 ? void 0 : _this$_data$body5.filter((r) => r.rangeType === 0)) ?? [];
 	}
 	/**
 	* Gets the data of the current RichTextValue instance
@@ -19387,19 +19316,22 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 	* @returns {RichTextBuilder} A new RichTextBuilder instance
 	*/
 	static create(data) {
-		return new RichTextBuilder(data !== null && data !== void 0 ? data : RichTextBuilder.newEmptyData());
+		return new RichTextBuilder(data ?? RichTextBuilder.newEmptyData());
 	}
 	constructor(data) {
 		super(data);
 		_defineProperty(this, "_doc", void 0);
 		_defineProperty(this, "_trackedRanges", /* @__PURE__ */ new Set());
+		_defineProperty(this, "_childHandleRevision", 0);
 		this._doc = new DocumentDataModel(data);
 	}
 	/**
 	* Returns editable paragraph handles backed by this detached rich-text builder.
 	*
-	* Paragraph boundaries come from the document model rather than splitting plain text. Each handle stays aligned
-	* when text in this builder grows or shrinks, so callers can safely iterate from the first paragraph to the last.
+	* Paragraph boundaries come from the document model rather than splitting plain text. Handles stay aligned across
+	* edits made through their child run handles, so callers can safely iterate from the first paragraph to the last.
+	* Direct builder edits that change text or run boundaries invalidate previously returned paragraph and run handles;
+	* query them again after calling methods such as `insertText()`, `setStyle()`, `setLink()`, or `delete()`.
 	*
 	* @returns Editable paragraphs in document order.
 	* @example
@@ -19414,14 +19346,10 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 	* ```
 	*/
 	getParagraphs() {
-		var _body$paragraphs;
 		const body = this._data.body;
 		if (!body) return [];
 		const startOffsets = getParagraphContentStartOffsets(body);
-		return ((_body$paragraphs = body.paragraphs) !== null && _body$paragraphs !== void 0 ? _body$paragraphs : []).map((paragraph) => {
-			var _startOffsets$get;
-			return this._createParagraphBuilder(paragraph.paragraphId, (_startOffsets$get = startOffsets.get(paragraph.startIndex)) !== null && _startOffsets$get !== void 0 ? _startOffsets$get : 0, paragraph.startIndex);
-		});
+		return (body.paragraphs ?? []).map((paragraph) => this._createParagraphBuilder(paragraph.paragraphId, startOffsets.get(paragraph.startIndex) ?? 0, paragraph.startIndex));
 	}
 	/**
 	* Returns editable text-run handles for all paragraph text in this builder.
@@ -19445,7 +19373,6 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 	}
 	/** @internal */
 	_createTextRunBuilders(range) {
-		var _body$textRuns, _body$customRanges, _body$customDecoratio;
 		const body = this._data.body;
 		if (!body || range.startOffset >= range.endOffset) return [];
 		const boundaries = /* @__PURE__ */ new Set([range.startOffset, range.endOffset]);
@@ -19457,9 +19384,9 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 				boundaries.add(end);
 			}
 		};
-		for (const textRun of (_body$textRuns = body.textRuns) !== null && _body$textRuns !== void 0 ? _body$textRuns : []) addRangeBoundaries(textRun.st, textRun.ed);
-		for (const customRange of (_body$customRanges = body.customRanges) !== null && _body$customRanges !== void 0 ? _body$customRanges : []) addRangeBoundaries(customRange.startIndex, customRange.endIndex + 1);
-		for (const decoration of (_body$customDecoratio = body.customDecorations) !== null && _body$customDecoratio !== void 0 ? _body$customDecoratio : []) addRangeBoundaries(decoration.startIndex, decoration.endIndex + 1);
+		for (const textRun of body.textRuns ?? []) addRangeBoundaries(textRun.st, textRun.ed);
+		for (const customRange of body.customRanges ?? []) addRangeBoundaries(customRange.startIndex, customRange.endIndex + 1);
+		for (const decoration of body.customDecorations ?? []) addRangeBoundaries(decoration.startIndex, decoration.endIndex + 1);
 		for (let offset = range.startOffset; offset < range.endOffset; offset++) if (NON_EDITABLE_RICH_TEXT_TOKENS.has(body.dataStream[offset])) {
 			boundaries.add(offset);
 			boundaries.add(offset + 1);
@@ -19467,12 +19394,11 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 		const offsets = [...boundaries].sort((left, right) => left - right);
 		const runs = [];
 		for (let index = 0; index < offsets.length - 1; index++) {
-			var _body$textRuns2;
 			const startOffset = offsets[index];
 			const endOffset = offsets[index + 1];
 			if (startOffset >= endOffset || endOffset - startOffset === 1 && NON_EDITABLE_RICH_TEXT_TOKENS.has(body.dataStream[startOffset])) continue;
-			const sourceRun = ((_body$textRuns2 = body.textRuns) !== null && _body$textRuns2 !== void 0 ? _body$textRuns2 : []).find((textRun) => textRun.st <= startOffset && textRun.ed >= endOffset);
-			runs.push(new RichTextRunBuilder(this, this._trackRange(startOffset, endOffset), sourceRun === null || sourceRun === void 0 ? void 0 : sourceRun.ts, sourceRun === null || sourceRun === void 0 ? void 0 : sourceRun.sId, Boolean(sourceRun)));
+			const sourceRun = (body.textRuns ?? []).find((textRun) => textRun.st <= startOffset && textRun.ed >= endOffset);
+			runs.push(new RichTextRunBuilder(this, this._trackRange(startOffset, endOffset), sourceRun === null || sourceRun === void 0 ? void 0 : sourceRun.ts, sourceRun === null || sourceRun === void 0 ? void 0 : sourceRun.sId, Boolean(sourceRun), this._childHandleRevision));
 		}
 		return runs;
 	}
@@ -19516,7 +19442,11 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 		this._rebaseTrackedRanges(startOffset, endOffset, text.length);
 	}
 	_createParagraphBuilder(paragraphId, startOffset, endOffset) {
-		return new RichTextParagraphBuilder(this, paragraphId, this._trackRange(startOffset, endOffset));
+		return new RichTextParagraphBuilder(this, paragraphId, this._trackRange(startOffset, endOffset), this._childHandleRevision);
+	}
+	/** @internal */
+	_assertChildHandleRevision(revision) {
+		if (revision !== this._childHandleRevision) throw new Error("Rich text child handle is no longer valid.");
 	}
 	_trackRange(startOffset, endOffset) {
 		const range = {
@@ -19543,6 +19473,10 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 			trackedRange.endOffset = mapEnd(trackedRange.endOffset);
 		}
 	}
+	_invalidateChildHandles() {
+		this._childHandleRevision++;
+		this._trackedRanges.clear();
+	}
 	/**
 	* Appends plain text to the rich text.
 	*
@@ -19583,13 +19517,12 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 	* ```
 	*/
 	align(alignment) {
-		var _this$_data, _this$_data$documentS, _documentStyle$render;
-		const documentStyle = (_this$_data$documentS = (_this$_data = this._data).documentStyle) !== null && _this$_data$documentS !== void 0 ? _this$_data$documentS : _this$_data.documentStyle = {};
-		const renderConfig = (_documentStyle$render = documentStyle.renderConfig) !== null && _documentStyle$render !== void 0 ? _documentStyle$render : documentStyle.renderConfig = {};
+		const documentStyle = this._data.documentStyle ??= {};
+		const renderConfig = documentStyle.renderConfig ??= {};
 		if (alignment.horizontal !== void 0) {
-			var _this$_data$body$para2, _this$_data$body7;
+			var _this$_data$body6;
 			renderConfig.horizontalAlign = alignment.horizontal;
-			for (const paragraph of (_this$_data$body$para2 = (_this$_data$body7 = this._data.body) === null || _this$_data$body7 === void 0 ? void 0 : _this$_data$body7.paragraphs) !== null && _this$_data$body$para2 !== void 0 ? _this$_data$body$para2 : []) paragraph.paragraphStyle = {
+			for (const paragraph of ((_this$_data$body6 = this._data.body) === null || _this$_data$body6 === void 0 ? void 0 : _this$_data$body6.paragraphs) ?? []) paragraph.paragraphStyle = {
 				...paragraph.paragraphStyle,
 				horizontalAlign: alignment.horizontal
 			};
@@ -19629,18 +19562,17 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 	* ```
 	*/
 	columns(options) {
-		var _this$_data2, _this$_data2$body, _body$sectionBreaks, _options$spacing;
 		if (!Number.isInteger(options.count) || options.count < 1) throw new RangeError("Rich text column count must be a positive integer.");
-		const body = (_this$_data2$body = (_this$_data2 = this._data).body) !== null && _this$_data2$body !== void 0 ? _this$_data2$body : _this$_data2.body = { dataStream: "\r\n" };
-		const sectionBreaks = (_body$sectionBreaks = body.sectionBreaks) !== null && _body$sectionBreaks !== void 0 ? _body$sectionBreaks : body.sectionBreaks = [];
+		const body = this._data.body ??= { dataStream: "\r\n" };
+		const sectionBreaks = body.sectionBreaks ??= [];
 		if (!sectionBreaks.length) {
-			var _body$dataStream$leng, _body$dataStream;
+			var _body$dataStream;
 			sectionBreaks.push({
 				sectionId: createSectionId(/* @__PURE__ */ new Set()),
-				startIndex: Math.max(0, ((_body$dataStream$leng = (_body$dataStream = body.dataStream) === null || _body$dataStream === void 0 ? void 0 : _body$dataStream.length) !== null && _body$dataStream$leng !== void 0 ? _body$dataStream$leng : 0) - 1)
+				startIndex: Math.max(0, (((_body$dataStream = body.dataStream) === null || _body$dataStream === void 0 ? void 0 : _body$dataStream.length) ?? 0) - 1)
 			});
 		}
-		const spacing = Math.max(0, (_options$spacing = options.spacing) !== null && _options$spacing !== void 0 ? _options$spacing : 0);
+		const spacing = Math.max(0, options.spacing ?? 0);
 		const columns = options.count === 1 ? void 0 : Array.from({ length: options.count }, (_, index) => ({
 			width: 0,
 			paddingEnd: index === options.count - 1 ? 0 : spacing
@@ -19650,14 +19582,15 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 		return this;
 	}
 	/**
-	* Appends one text span with explicit style.
+	* Appends one text span with an optional style.
 	*
 	* Prefer this method when combining multiple styles, because the style object is local to the inserted text and does
 	* not leak into following calls.
 	*
 	* @param text Text to append.
-	* @param style Text style for this span. Agent-friendly aliases such as `bold`, `italic`, `fontFamily`, `fontSize`,
-	* `color`, and `background` are supported alongside native document text style fields.
+	* @param style Optional text style for this span. When omitted, the span is appended as unstyled text. Agent-friendly
+	* aliases such as `bold`, `italic`, `fontFamily`, `fontSize`, `color`, and `background` are supported alongside native
+	* document text style fields.
 	* @returns The current builder for chaining.
 	* @example
 	* ```ts
@@ -19668,18 +19601,7 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 	*/
 	span(text, style) {
 		if (!text) return this;
-		return this.insertRichText(RichTextValue.create({
-			id: "d",
-			documentStyle: {},
-			body: {
-				dataStream: text,
-				textRuns: [{
-					st: 0,
-					ed: text.length,
-					ts: normalizeRichTextSpanStyle(style)
-				}]
-			}
-		}));
+		return style ? this.insertText(text, normalizeRichTextSpanStyle(style)) : this.insertText(text);
 	}
 	/**
 	* Appends bold text.
@@ -19753,22 +19675,19 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 	* ```
 	*/
 	listItem(text, options = {}) {
-		var _options$type, _this$_data$body8, _options$listId, _this$_data$body9;
-		const listType = (_options$type = options.type) !== null && _options$type !== void 0 ? _options$type : "BULLET_LIST";
-		const currentParagraph = (_this$_data$body8 = this._data.body) === null || _this$_data$body8 === void 0 || (_this$_data$body8 = _this$_data$body8.paragraphs) === null || _this$_data$body8 === void 0 ? void 0 : _this$_data$body8.at(-1);
+		var _this$_data$body7, _options$listId, _this$_data$body8;
+		const listType = options.type ?? "BULLET_LIST";
+		const currentParagraph = (_this$_data$body7 = this._data.body) === null || _this$_data$body7 === void 0 || (_this$_data$body7 = _this$_data$body7.paragraphs) === null || _this$_data$body7 === void 0 ? void 0 : _this$_data$body7.slice(-1)[0];
 		const currentBullet = currentParagraph === null || currentParagraph === void 0 ? void 0 : currentParagraph.bullet;
 		const listId = ((_options$listId = options.listId) === null || _options$listId === void 0 ? void 0 : _options$listId.trim()) || ((currentBullet === null || currentBullet === void 0 ? void 0 : currentBullet.listType) === listType ? currentBullet.listId : generateRandomId());
 		if (hasRichTextContent(this._data)) this.paragraph(options.paragraphStyle);
 		else if (options.paragraphStyle) this.paragraph(options.paragraphStyle);
-		const targetParagraph = (_this$_data$body9 = this._data.body) === null || _this$_data$body9 === void 0 || (_this$_data$body9 = _this$_data$body9.paragraphs) === null || _this$_data$body9 === void 0 ? void 0 : _this$_data$body9.at(-1);
-		if (targetParagraph) {
-			var _options$level;
-			targetParagraph.bullet = {
-				listId,
-				listType,
-				nestingLevel: Math.max(0, Math.trunc((_options$level = options.level) !== null && _options$level !== void 0 ? _options$level : 0))
-			};
-		}
+		const targetParagraph = (_this$_data$body8 = this._data.body) === null || _this$_data$body8 === void 0 || (_this$_data$body8 = _this$_data$body8.paragraphs) === null || _this$_data$body8 === void 0 ? void 0 : _this$_data$body8.slice(-1)[0];
+		if (targetParagraph) targetParagraph.bullet = {
+			listId,
+			listType,
+			nestingLevel: Math.max(0, Math.trunc(options.level ?? 0))
+		};
 		return this.text(text);
 	}
 	/**
@@ -19789,20 +19708,20 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 	* ```
 	*/
 	paragraph(paragraphStyle) {
-		var _this$_data$body11, _this$_data$body$data2, _this$_data$body12, _this$_data$body13;
+		var _this$_data$body10, _this$_data$body11, _this$_data$body12;
 		const nextParagraphStyle = normalizeRichTextParagraphStyle(paragraphStyle);
 		if (!hasRichTextContent(this._data)) {
 			if (nextParagraphStyle) {
-				var _this$_data$body10;
-				const firstParagraph = (_this$_data$body10 = this._data.body) === null || _this$_data$body10 === void 0 || (_this$_data$body10 = _this$_data$body10.paragraphs) === null || _this$_data$body10 === void 0 ? void 0 : _this$_data$body10[0];
+				var _this$_data$body9;
+				const firstParagraph = (_this$_data$body9 = this._data.body) === null || _this$_data$body9 === void 0 || (_this$_data$body9 = _this$_data$body9.paragraphs) === null || _this$_data$body9 === void 0 ? void 0 : _this$_data$body9[0];
 				if (firstParagraph) firstParagraph.paragraphStyle = nextParagraphStyle;
 			}
 			return this;
 		}
-		const currentParagraph = (_this$_data$body11 = this._data.body) === null || _this$_data$body11 === void 0 || (_this$_data$body11 = _this$_data$body11.paragraphs) === null || _this$_data$body11 === void 0 ? void 0 : _this$_data$body11.at(-1);
+		const currentParagraph = (_this$_data$body10 = this._data.body) === null || _this$_data$body10 === void 0 || (_this$_data$body10 = _this$_data$body10.paragraphs) === null || _this$_data$body10 === void 0 ? void 0 : _this$_data$body10.slice(-1)[0];
 		const currentParagraphStyle = Tools.deepClone(currentParagraph === null || currentParagraph === void 0 ? void 0 : currentParagraph.paragraphStyle);
 		const currentParagraphBullet = Tools.deepClone(currentParagraph === null || currentParagraph === void 0 ? void 0 : currentParagraph.bullet);
-		const startIndex = Math.max(0, ((_this$_data$body$data2 = (_this$_data$body12 = this._data.body) === null || _this$_data$body12 === void 0 ? void 0 : _this$_data$body12.dataStream.length) !== null && _this$_data$body$data2 !== void 0 ? _this$_data$body$data2 : 2) - 2);
+		const startIndex = Math.max(0, (((_this$_data$body11 = this._data.body) === null || _this$_data$body11 === void 0 ? void 0 : _this$_data$body11.dataStream.length) ?? 2) - 2);
 		this.insertRichText(startIndex, RichTextValue.create({
 			id: "d",
 			documentStyle: {},
@@ -19816,7 +19735,7 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 				}]
 			}
 		}));
-		const nextParagraph = (_this$_data$body13 = this._data.body) === null || _this$_data$body13 === void 0 || (_this$_data$body13 = _this$_data$body13.paragraphs) === null || _this$_data$body13 === void 0 ? void 0 : _this$_data$body13.at(-1);
+		const nextParagraph = (_this$_data$body12 = this._data.body) === null || _this$_data$body12 === void 0 || (_this$_data$body12 = _this$_data$body12.paragraphs) === null || _this$_data$body12 === void 0 ? void 0 : _this$_data$body12.slice(-1)[0];
 		if (nextParagraphStyle) {
 			if (nextParagraph) nextParagraph.paragraphStyle = nextParagraphStyle;
 		} else if (nextParagraph) delete nextParagraph.paragraphStyle;
@@ -19824,24 +19743,26 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 		return this;
 	}
 	insertText(start, text, style) {
-		var _this$_data$body$data3, _this$_data$body14;
-		let startIndex = ((_this$_data$body$data3 = (_this$_data$body14 = this._data.body) === null || _this$_data$body14 === void 0 ? void 0 : _this$_data$body14.dataStream.length) !== null && _this$_data$body$data3 !== void 0 ? _this$_data$body$data3 : 2) - 2;
+		var _this$_data$body13;
+		let startIndex = (((_this$_data$body13 = this._data.body) === null || _this$_data$body13 === void 0 ? void 0 : _this$_data$body13.dataStream.length) ?? 2) - 2;
 		let insertText;
 		let insertStyle;
 		if (typeof start === "string") insertText = start;
 		else {
 			startIndex = Math.min(start, startIndex);
-			insertText = text;
+			insertText = typeof text === "string" ? text : "";
 		}
 		if (typeof text === "object") insertStyle = text instanceof TextStyleBuilder ? text.build() : text;
 		else insertStyle = style instanceof TextStyleBuilder ? style.build() : style;
 		if (!insertText) return this;
+		const plainTextBody = BuildTextUtils.transform.fromPlainText(insertText);
 		const newBody = {
-			dataStream: insertText,
+			dataStream: plainTextBody.dataStream,
+			paragraphs: plainTextBody.paragraphs,
 			textRuns: insertStyle ? [{
 				ts: insertStyle,
-				st: startIndex,
-				ed: startIndex + insertText.length
+				st: 0,
+				ed: plainTextBody.dataStream.length
 			}] : []
 		};
 		const textX = BuildTextUtils.selection.replace({
@@ -19855,11 +19776,12 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 		});
 		if (!textX) throw new Error("Insert text failed, please check.");
 		TextX.apply(this._doc.getBody(), textX.serialize());
+		this._invalidateChildHandles();
 		return this;
 	}
 	insertRichText(start, richText) {
-		var _this$_data$body$data4, _this$_data$body15;
-		let startIndex = ((_this$_data$body$data4 = (_this$_data$body15 = this._data.body) === null || _this$_data$body15 === void 0 ? void 0 : _this$_data$body15.dataStream.length) !== null && _this$_data$body$data4 !== void 0 ? _this$_data$body$data4 : 2) - 2;
+		var _this$_data$body14;
+		let startIndex = (((_this$_data$body14 = this._data.body) === null || _this$_data$body14 === void 0 ? void 0 : _this$_data$body14.dataStream.length) ?? 2) - 2;
 		let insertText;
 		if (typeof start === "object") insertText = start instanceof RichTextValue ? start.getData() : start;
 		else {
@@ -19877,17 +19799,32 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 		});
 		if (!textX) throw new Error("Insert text failed, please check.");
 		TextX.apply(this._doc.getBody(), textX.serialize());
+		this._invalidateChildHandles();
 		return this;
 	}
 	delete(start, count) {
-		if (count !== void 0) {
-			if (!count) return this;
+		var _this$_data$body15;
+		const terminalTokenLength = "\r".length + "\n".length;
+		const contentLength = Math.max(0, (((_this$_data$body15 = this._data.body) === null || _this$_data$body15 === void 0 ? void 0 : _this$_data$body15.dataStream.length) ?? terminalTokenLength) - terminalTokenLength);
+		let startOffset;
+		let deleteCount;
+		if (count === void 0) {
+			if (start < 0) throw new RangeError("Delete count cannot be negative.");
+			deleteCount = Math.min(start, contentLength);
+			startOffset = contentLength - deleteCount;
+		} else {
+			if (start < 0 || count < 0) throw new RangeError("Delete range cannot be negative.");
+			startOffset = Math.min(start, contentLength);
+			deleteCount = Math.min(count, contentLength - startOffset);
+		}
+		if (deleteCount > 0) {
 			const actions = BuildTextUtils.selection.delete([{
-				startOffset: start,
-				endOffset: start + count,
+				startOffset,
+				endOffset: startOffset + deleteCount,
 				collapsed: true
 			}], this._data.body);
 			TextX.apply(this._doc.getBody(), actions);
+			this._invalidateChildHandles();
 		}
 		return this;
 	}
@@ -19918,6 +19855,7 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 			collapsed: true
 		}], newBody);
 		TextX.apply(this._doc.getBody(), actions);
+		this._invalidateChildHandles();
 		return this;
 	}
 	/**
@@ -19946,9 +19884,11 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 		});
 		if (!textX) throw new Error("Insert text failed, please check.");
 		TextX.apply(this._doc.getBody(), textX.serialize());
+		this._invalidateChildHandles();
 		return this;
 	}
 	cancelLink(start, end) {
+		let changed = false;
 		if (typeof start === "string") {
 			const textX = BuildTextUtils.customRange.delete({
 				rangeId: start,
@@ -19956,6 +19896,7 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 			});
 			if (!textX) throw new Error("Insert text failed, please check.");
 			TextX.apply(this._doc.getBody(), textX.serialize());
+			changed = true;
 		} else this.slice(start, end).getLinks().forEach((l) => {
 			const textX = BuildTextUtils.customRange.delete({
 				rangeId: l.rangeId,
@@ -19963,7 +19904,9 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 			});
 			if (!textX) throw new Error("Insert text failed, please check.");
 			TextX.apply(this._doc.getBody(), textX.serialize());
+			changed = true;
 		});
+		if (changed) this._invalidateChildHandles();
 		return this;
 	}
 	updateLink(id, url) {
@@ -19977,7 +19920,7 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 		let newBody;
 		let startIndex;
 		if (typeof start === "object") {
-			var _this$_data$body$data5, _this$_data$body17;
+			var _this$_data$body17;
 			newBody = {
 				dataStream: "\r",
 				paragraphs: [{
@@ -19986,7 +19929,7 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 					paragraphStyle: start.build()
 				}]
 			};
-			startIndex = ((_this$_data$body$data5 = (_this$_data$body17 = this._data.body) === null || _this$_data$body17 === void 0 ? void 0 : _this$_data$body17.dataStream.length) !== null && _this$_data$body$data5 !== void 0 ? _this$_data$body$data5 : 2) - 2;
+			startIndex = (((_this$_data$body17 = this._data.body) === null || _this$_data$body17 === void 0 ? void 0 : _this$_data$body17.dataStream.length) ?? 2) - 2;
 		} else {
 			startIndex = start;
 			newBody = {
@@ -20036,18 +19979,21 @@ var RichTextBuilder = class RichTextBuilder extends RichTextValue {
 */
 var RichTextParagraphBuilder = class extends RichTextValue {
 	/** @hideconstructor */
-	constructor(_owner, _paragraphId, _range) {
+	constructor(_owner, _paragraphId, _range, _revision) {
 		super(createParagraphSnapshot(_owner.getData(), _paragraphId, _range));
 		this._owner = _owner;
 		this._paragraphId = _paragraphId;
 		this._range = _range;
+		this._revision = _revision;
 	}
 	/** Returns the persisted paragraph id. */
 	getId() {
+		this._assertActive();
 		return this._paragraphId;
 	}
 	/** Returns the current paragraph range without its trailing paragraph marker. */
 	getRange() {
+		this._assertActive();
 		return { ...this._range };
 	}
 	/**
@@ -20060,8 +20006,9 @@ var RichTextParagraphBuilder = class extends RichTextValue {
 	* ```
 	*/
 	getText() {
-		var _this$_owner$getData$, _this$_owner$getData$2;
-		return ((_this$_owner$getData$ = (_this$_owner$getData$2 = this._owner.getData().body) === null || _this$_owner$getData$2 === void 0 ? void 0 : _this$_owner$getData$2.dataStream) !== null && _this$_owner$getData$ !== void 0 ? _this$_owner$getData$ : "").slice(this._range.startOffset, this._range.endOffset);
+		var _this$_owner$getData$;
+		this._assertActive();
+		return (((_this$_owner$getData$ = this._owner.getData().body) === null || _this$_owner$getData$ === void 0 ? void 0 : _this$_owner$getData$.dataStream) ?? "").slice(this._range.startOffset, this._range.endOffset);
 	}
 	toPlainText() {
 		return this.getText();
@@ -20071,34 +20018,42 @@ var RichTextParagraphBuilder = class extends RichTextValue {
 	* @returns Editable text runs in document order.
 	*/
 	getTextRuns() {
+		this._assertActive();
 		return this._owner._createTextRunBuilders(this._range);
 	}
 	getParagraphStyle() {
+		this._assertActive();
 		return ParagraphStyleValue.create(this._getParagraph().paragraphStyle);
 	}
 	getParagraphBullet() {
+		this._assertActive();
 		return this._getParagraph().bullet;
 	}
 	getLinks() {
-		var _this$getData$body$cu, _this$getData$body;
-		return (_this$getData$body$cu = (_this$getData$body = this.getData().body) === null || _this$getData$body === void 0 || (_this$getData$body = _this$getData$body.customRanges) === null || _this$getData$body === void 0 ? void 0 : _this$getData$body.filter((range) => range.rangeType === 0)) !== null && _this$getData$body$cu !== void 0 ? _this$getData$body$cu : [];
+		var _this$getData$body;
+		this._assertActive();
+		return ((_this$getData$body = this.getData().body) === null || _this$getData$body === void 0 || (_this$getData$body = _this$getData$body.customRanges) === null || _this$getData$body === void 0 ? void 0 : _this$getData$body.filter((range) => range.rangeType === 0)) ?? [];
 	}
 	/** Agent-friendly alias of `getParagraphBullet()`. */
 	getBullet() {
 		return this.getParagraphBullet();
 	}
 	getData() {
+		this._assertActive();
 		return createParagraphSnapshot(this._owner.getData(), this._paragraphId, this._range);
 	}
 	copy() {
 		return RichTextBuilder.create(Tools.deepClone(this.getData()));
 	}
 	_getParagraph() {
-		var _this$_owner$getData$3;
-		const paragraph = (_this$_owner$getData$3 = this._owner.getData().body) === null || _this$_owner$getData$3 === void 0 || (_this$_owner$getData$3 = _this$_owner$getData$3.paragraphs) === null || _this$_owner$getData$3 === void 0 ? void 0 : _this$_owner$getData$3.find((item) => item.paragraphId === this._paragraphId);
+		var _this$_owner$getData$2;
+		const paragraph = (_this$_owner$getData$2 = this._owner.getData().body) === null || _this$_owner$getData$2 === void 0 || (_this$_owner$getData$2 = _this$_owner$getData$2.paragraphs) === null || _this$_owner$getData$2 === void 0 ? void 0 : _this$_owner$getData$2.find((item) => item.paragraphId === this._paragraphId);
 		if (!paragraph) throw new Error(`Rich text paragraph "${this._paragraphId}" was not found.`);
 		return paragraph;
 	}
+	_assertActive() {
+		this._owner._assertChildHandleRevision(this._revision);
+	}
 };
 /**
 * An editable text-run handle owned by a detached {@link RichTextBuilder}.
@@ -20108,38 +20063,45 @@ var RichTextParagraphBuilder = class extends RichTextValue {
 */
 var RichTextRunBuilder = class {
 	/** @hideconstructor */
-	constructor(_owner, _range, _textStyle, _styleId, _hasExplicitTextStyle) {
+	constructor(_owner, _range, _textStyle, _styleId, _hasExplicitTextStyle, _revision) {
 		this._owner = _owner;
 		this._range = _range;
 		this._textStyle = _textStyle;
 		this._styleId = _styleId;
 		this._hasExplicitTextStyle = _hasExplicitTextStyle;
+		this._revision = _revision;
 		_defineProperty(this, "_active", true);
 	}
 	/** Inclusive start offset, kept for compatibility with existing `getTextRuns()` callers. */
 	get st() {
+		this._assertActive();
 		return this._range.startOffset;
 	}
 	/** Exclusive end offset, automatically updated after text replacement. */
 	get ed() {
+		this._assertActive();
 		return this._range.endOffset;
 	}
 	/** Optional persisted style id. This is not a stable run identity. */
 	get sId() {
+		this._assertActive();
 		return this._styleId;
 	}
 	/** Existing text-style value property exposed by `getTextRuns()`. */
 	get ts() {
+		this._assertActive();
 		return this._textStyle ? TextStyleValue.create(this._textStyle) : null;
 	}
 	/** Returns the current run range. */
 	getRange() {
+		this._assertActive();
 		return { ...this._range };
 	}
 	/** Returns the current run text. */
 	getText() {
-		var _this$_owner$getData$4, _this$_owner$getData$5;
-		return ((_this$_owner$getData$4 = (_this$_owner$getData$5 = this._owner.getData().body) === null || _this$_owner$getData$5 === void 0 ? void 0 : _this$_owner$getData$5.dataStream) !== null && _this$_owner$getData$4 !== void 0 ? _this$_owner$getData$4 : "").slice(this._range.startOffset, this._range.endOffset);
+		var _this$_owner$getData$3;
+		this._assertActive();
+		return (((_this$_owner$getData$3 = this._owner.getData().body) === null || _this$_owner$getData$3 === void 0 ? void 0 : _this$_owner$getData$3.dataStream) ?? "").slice(this._range.startOffset, this._range.endOffset);
 	}
 	/** Returns this run's explicit text style, or `null` for an unstyled text segment. */
 	getTextStyle() {
@@ -20147,6 +20109,7 @@ var RichTextRunBuilder = class {
 	}
 	/** Returns whether this segment is backed by an explicit document text run. */
 	hasTextStyle() {
+		this._assertActive();
 		return this._hasExplicitTextStyle;
 	}
 	/**
@@ -20174,17 +20137,21 @@ var RichTextRunBuilder = class {
 	* ```
 	*/
 	setText(text) {
-		if (!this._active) throw new Error("Rich text run handle is no longer valid.");
+		this._assertActive();
 		this._owner._replaceTextRun(this._range, text, this._textStyle, this._styleId, this._hasExplicitTextStyle);
 		if (!text) this._active = false;
 		return this;
 	}
+	_assertActive() {
+		if (!this._active) throw new Error("Rich text run handle is no longer valid.");
+		this._owner._assertChildHandleRevision(this._revision);
+	}
 };
 function createParagraphSnapshot(data, paragraphId, range) {
-	var _body$paragraphs2;
+	var _body$paragraphs;
 	const { body, ...documentData } = data;
 	if (!body) throw new Error("Rich text body is not available.");
-	const paragraph = (_body$paragraphs2 = body.paragraphs) === null || _body$paragraphs2 === void 0 ? void 0 : _body$paragraphs2.find((item) => item.paragraphId === paragraphId);
+	const paragraph = (_body$paragraphs = body.paragraphs) === null || _body$paragraphs === void 0 ? void 0 : _body$paragraphs.find((item) => item.paragraphId === paragraphId);
 	if (!paragraph) throw new Error(`Rich text paragraph "${paragraphId}" was not found.`);
 	const paragraphBody = getBodySlice(body, range.startOffset, range.endOffset);
 	paragraphBody.paragraphs = [{
@@ -20231,13 +20198,9 @@ function validateMinimumRootSentinels(body, issues, context) {
 	if (!body.dataStream.includes("\n")) issues.push(createIssue(context, "missing-root-section-break", "Document body must contain at least one section break sentinel."));
 }
 function validateParagraphMetadata(body, issues, context) {
-	var _body$paragraphs;
 	const metadataCounts = /* @__PURE__ */ new Map();
-	for (const paragraph of (_body$paragraphs = body.paragraphs) !== null && _body$paragraphs !== void 0 ? _body$paragraphs : []) if (body.dataStream[paragraph.startIndex] !== "\r") issues.push(createIssue(context, "paragraph-token-mismatch", "Paragraph metadata must point to a paragraph sentinel.", paragraph.startIndex));
-	else {
-		var _metadataCounts$get;
-		metadataCounts.set(paragraph.startIndex, ((_metadataCounts$get = metadataCounts.get(paragraph.startIndex)) !== null && _metadataCounts$get !== void 0 ? _metadataCounts$get : 0) + 1);
-	}
+	for (const paragraph of body.paragraphs ?? []) if (body.dataStream[paragraph.startIndex] !== "\r") issues.push(createIssue(context, "paragraph-token-mismatch", "Paragraph metadata must point to a paragraph sentinel.", paragraph.startIndex));
+	else metadataCounts.set(paragraph.startIndex, (metadataCounts.get(paragraph.startIndex) ?? 0) + 1);
 	validatePointMetadataDuplicates(metadataCounts, {
 		context,
 		duplicateCode: "duplicate-paragraph-metadata",
@@ -20245,20 +20208,13 @@ function validateParagraphMetadata(body, issues, context) {
 	}, issues);
 }
 function validateSectionBreakMetadata(body, issues, context) {
-	var _body$sectionBreaks;
 	const metadataCounts = /* @__PURE__ */ new Map();
 	const sectionIds = /* @__PURE__ */ new Map();
-	for (const sectionBreak of (_body$sectionBreaks = body.sectionBreaks) !== null && _body$sectionBreaks !== void 0 ? _body$sectionBreaks : []) {
+	for (const sectionBreak of body.sectionBreaks ?? []) {
 		if (!sectionBreak.sectionId) issues.push(createIssue(context, "missing-section-id", "Section break metadata must have a stable section id.", sectionBreak.startIndex));
-		else {
-			var _sectionIds$get;
-			sectionIds.set(sectionBreak.sectionId, ((_sectionIds$get = sectionIds.get(sectionBreak.sectionId)) !== null && _sectionIds$get !== void 0 ? _sectionIds$get : 0) + 1);
-		}
+		else sectionIds.set(sectionBreak.sectionId, (sectionIds.get(sectionBreak.sectionId) ?? 0) + 1);
 		if (body.dataStream[sectionBreak.startIndex] !== "\n") issues.push(createIssue(context, "section-break-token-mismatch", "Section break metadata must point to a section break sentinel.", sectionBreak.startIndex));
-		else {
-			var _metadataCounts$get2;
-			metadataCounts.set(sectionBreak.startIndex, ((_metadataCounts$get2 = metadataCounts.get(sectionBreak.startIndex)) !== null && _metadataCounts$get2 !== void 0 ? _metadataCounts$get2 : 0) + 1);
-		}
+		else metadataCounts.set(sectionBreak.startIndex, (metadataCounts.get(sectionBreak.startIndex) ?? 0) + 1);
 	}
 	validatePointMetadataDuplicates(metadataCounts, {
 		context,
@@ -20287,11 +20243,10 @@ function collectPairedTokenRanges(dataStream, startToken, endToken, exclusiveEnd
 	};
 }
 function validateTableMetadata(body, issues, context) {
-	var _body$tables;
 	const pairedTables = collectPairedTokenRanges(body.dataStream, "", "", true).pairs;
 	const metadataStarts = /* @__PURE__ */ new Set();
 	let previousTable;
-	const tables = [...(_body$tables = body.tables) !== null && _body$tables !== void 0 ? _body$tables : []].sort((a, b) => a.startIndex - b.startIndex || a.endIndex - b.endIndex);
+	const tables = [...body.tables ?? []].sort((a, b) => a.startIndex - b.startIndex || a.endIndex - b.endIndex);
 	for (const table of tables) {
 		metadataStarts.add(table.startIndex);
 		if (!Number.isInteger(table.startIndex) || body.dataStream[table.startIndex] !== "") issues.push(createIssue(context, "table-start-token-mismatch", "Table startIndex must point to a table start sentinel.", table.startIndex));
@@ -20302,10 +20257,9 @@ function validateTableMetadata(body, issues, context) {
 	for (const startIndex of pairedTables.keys()) if (!metadataStarts.has(startIndex)) issues.push(createIssue(context, "missing-table-metadata", "Table token range must have a table metadata entry.", startIndex));
 }
 function validateBlockRangeMetadata(body, issues, context) {
-	var _body$blockRanges;
 	const pairedBlocks = collectPairedTokenRanges(body.dataStream, "", "", false);
 	for (const index of [...pairedBlocks.unmatchedStarts, ...pairedBlocks.unmatchedEnds]) issues.push(createIssue(context, "unbalanced-block", "Block sentinel has no matching boundary.", index));
-	const blockRanges = [...(_body$blockRanges = body.blockRanges) !== null && _body$blockRanges !== void 0 ? _body$blockRanges : []].sort((a, b) => a.startIndex - b.startIndex || a.endIndex - b.endIndex);
+	const blockRanges = [...body.blockRanges ?? []].sort((a, b) => a.startIndex - b.startIndex || a.endIndex - b.endIndex);
 	const metadataStarts = /* @__PURE__ */ new Set();
 	let previousBlockRange;
 	for (let i = 0; i < blockRanges.length; i++) {
@@ -20318,10 +20272,9 @@ function validateBlockRangeMetadata(body, issues, context) {
 	for (const startIndex of pairedBlocks.pairs.keys()) if (!metadataStarts.has(startIndex)) issues.push(createIssue(context, "missing-block-range-metadata", "Block token range must have a block metadata entry.", startIndex));
 }
 function validateColumnGroupMetadata(body, issues, context) {
-	var _body$columnGroups;
 	const pairedColumnGroups = collectPairedTokenRanges(body.dataStream, "", "", false).pairs;
 	const metadataStarts = /* @__PURE__ */ new Set();
-	const columnGroups = [...(_body$columnGroups = body.columnGroups) !== null && _body$columnGroups !== void 0 ? _body$columnGroups : []].sort((a, b) => a.startIndex - b.startIndex || a.endIndex - b.endIndex);
+	const columnGroups = [...body.columnGroups ?? []].sort((a, b) => a.startIndex - b.startIndex || a.endIndex - b.endIndex);
 	let previousColumnGroup;
 	for (const columnGroup of columnGroups) {
 		metadataStarts.add(columnGroup.startIndex);
@@ -20331,7 +20284,7 @@ function validateColumnGroupMetadata(body, issues, context) {
 		previousColumnGroup = columnGroup;
 		if (Array.isArray(columnGroup.columns)) {
 			let streamColumnCount = 0;
-			const scanEnd = pairedEndIndex !== null && pairedEndIndex !== void 0 ? pairedEndIndex : columnGroup.endIndex;
+			const scanEnd = pairedEndIndex ?? columnGroup.endIndex;
 			for (let index = columnGroup.startIndex + 1; index < scanEnd; index++) if (body.dataStream[index] === "") streamColumnCount++;
 			if (streamColumnCount !== columnGroup.columns.length) issues.push(createIssue(context, "column-group-column-count-mismatch", "Column group metadata column count must match the data stream.", columnGroup.startIndex));
 		}
@@ -20339,16 +20292,14 @@ function validateColumnGroupMetadata(body, issues, context) {
 	for (const startIndex of pairedColumnGroups.keys()) if (!metadataStarts.has(startIndex)) issues.push(createIssue(context, "missing-column-group-metadata", "Column group token range must have a metadata entry.", startIndex));
 }
 function validateCustomBlockMetadata(body, issues, context) {
-	var _body$customBlocks;
 	const metadataCounts = /* @__PURE__ */ new Map();
-	for (const customBlock of (_body$customBlocks = body.customBlocks) !== null && _body$customBlocks !== void 0 ? _body$customBlocks : []) {
-		var _metadataCounts$get3;
+	for (const customBlock of body.customBlocks ?? []) {
 		const { startIndex } = customBlock;
 		if (!Number.isInteger(startIndex) || body.dataStream[startIndex] !== "\b") {
 			issues.push(createIssue(context, "custom-block-token-mismatch", "Custom block startIndex must point to a custom block sentinel.", startIndex));
 			continue;
 		}
-		metadataCounts.set(startIndex, ((_metadataCounts$get3 = metadataCounts.get(startIndex)) !== null && _metadataCounts$get3 !== void 0 ? _metadataCounts$get3 : 0) + 1);
+		metadataCounts.set(startIndex, (metadataCounts.get(startIndex) ?? 0) + 1);
 	}
 	validatePointMetadataDuplicates(metadataCounts, {
 		context,
@@ -20423,14 +20374,13 @@ function validateDocBodyStructure(body, context = { segmentType: "body" }) {
 	return issues;
 }
 function validateDocumentStructure(snapshot) {
-	var _snapshot$headers, _snapshot$footers;
 	const issues = [];
 	if (snapshot.body) issues.push(...validateDocBodyStructure(snapshot.body, { segmentType: "body" }));
-	for (const [headerId, header] of Object.entries((_snapshot$headers = snapshot.headers) !== null && _snapshot$headers !== void 0 ? _snapshot$headers : {})) issues.push(...validateDocBodyStructure(header.body, {
+	for (const [headerId, header] of Object.entries(snapshot.headers ?? {})) issues.push(...validateDocBodyStructure(header.body, {
 		segmentType: "header",
 		segmentId: headerId
 	}));
-	for (const [footerId, footer] of Object.entries((_snapshot$footers = snapshot.footers) !== null && _snapshot$footers !== void 0 ? _snapshot$footers : {})) issues.push(...validateDocBodyStructure(footer.body, {
+	for (const [footerId, footer] of Object.entries(snapshot.footers ?? {})) issues.push(...validateDocBodyStructure(footer.body, {
 		segmentType: "footer",
 		segmentId: footerId
 	}));
@@ -20541,10 +20491,7 @@ var EventSubject = class extends rxjs.Subject {
 		else ob = observer;
 		const subscription = super.subscribe(ob);
 		this._sortedObservers.push(ob);
-		this._sortedObservers.sort((a, b) => {
-			var _a$priority, _b$priority;
-			return ((_a$priority = a.priority) !== null && _a$priority !== void 0 ? _a$priority : 0) - ((_b$priority = b.priority) !== null && _b$priority !== void 0 ? _b$priority : 0);
-		});
+		this._sortedObservers.sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
 		subscription.add(() => this._sortedObservers = this._sortedObservers.filter((o) => o !== ob));
 		return subscription;
 	}
@@ -21046,8 +20993,6 @@ const FOCUSING_SHEET = "FOCUSING_SHEET";
 const FOCUSING_DOC = "FOCUSING_DOC";
 const FOCUSING_SLIDE = "FOCUSING_SLIDE";
 const FOCUSING_BOARD = "FOCUSING_BOARD";
-/** @deprecated */
-const FOCUSING_EDITOR_BUT_HIDDEN = "FOCUSING_EDITOR_BUT_HIDDEN";
 const EDITOR_ACTIVATED = "EDITOR_ACTIVATED";
 const FOCUSING_EDITOR_INPUT_FORMULA = "FOCUSING_EDITOR_INPUT_FORMULA";
 /** The focusing state of the formula editor (Fx bar). */
@@ -21255,13 +21200,12 @@ const getDefaultBaselineOffset = (fontSize) => ({
 	spo: fontSize
 });
 function createDocumentModelWithStyle(content, textStyle, config = {}) {
-	var _paddingData$t, _paddingData$r, _paddingData$b, _paddingData$l;
 	const contentLength = content.length;
 	const { textRotation, paddingData, horizontalAlign = 0, verticalAlign = 0, wrapStrategy = 0, cellValueType } = config;
-	const marginTop = (_paddingData$t = paddingData === null || paddingData === void 0 ? void 0 : paddingData.t) !== null && _paddingData$t !== void 0 ? _paddingData$t : DEFAULT_PADDING_DATA.t;
-	const marginRight = (_paddingData$r = paddingData === null || paddingData === void 0 ? void 0 : paddingData.r) !== null && _paddingData$r !== void 0 ? _paddingData$r : DEFAULT_PADDING_DATA.r;
-	const marginBottom = (_paddingData$b = paddingData === null || paddingData === void 0 ? void 0 : paddingData.b) !== null && _paddingData$b !== void 0 ? _paddingData$b : DEFAULT_PADDING_DATA.b;
-	const marginLeft = (_paddingData$l = paddingData === null || paddingData === void 0 ? void 0 : paddingData.l) !== null && _paddingData$l !== void 0 ? _paddingData$l : DEFAULT_PADDING_DATA.l;
+	const marginTop = (paddingData === null || paddingData === void 0 ? void 0 : paddingData.t) ?? DEFAULT_PADDING_DATA.t;
+	const marginRight = (paddingData === null || paddingData === void 0 ? void 0 : paddingData.r) ?? DEFAULT_PADDING_DATA.r;
+	const marginBottom = (paddingData === null || paddingData === void 0 ? void 0 : paddingData.b) ?? DEFAULT_PADDING_DATA.b;
+	const marginLeft = (paddingData === null || paddingData === void 0 ? void 0 : paddingData.l) ?? DEFAULT_PADDING_DATA.l;
 	const { vertexAngle, centerAngle } = convertTextRotation(textRotation);
 	return new DocumentDataModel({
 		id: "d",
@@ -21441,214 +21385,22 @@ function convertTextRotation(textRotation) {
 }
 
 //#endregion
-//#region src/sheets/clone.ts
+//#region src/sheets/column-manager.ts
 /**
-* Fast clone for primitive values and simple objects.
-* Avoids type checking overhead when we know the structure.
+* Manage configuration information of all columns, get column width, column length, set column width, etc.
 */
-function cloneValue(value) {
-	if (value === null || value === void 0) return value;
-	if (typeof value !== "object") return value;
-	if (Array.isArray(value)) {
-		const len = value.length;
-		const result = new Array(len);
-		for (let i = 0; i < len; i++) result[i] = cloneValue(value[i]);
-		return result;
+var ColumnManager = class {
+	constructor(_config, data) {
+		this._config = _config;
+		_defineProperty(this, "_columnData", {});
+		this._columnData = data;
 	}
-	const result = {};
-	const keys = Object.keys(value);
-	for (let i = 0, len = keys.length; i < len; i++) {
-		const key = keys[i];
-		result[key] = cloneValue(value[key]);
-	}
-	return result;
-}
-/**
-* Fast clone for ICellData. Optimized for the known structure.
-* @param cell - The cell data to clone
-* @returns A deep clone of the cell data
-*/
-function cloneCellData(cell) {
-	if (cell === null || cell === void 0) return cell;
-	const result = {};
-	if (cell.p !== void 0) result.p = cell.p === null ? null : cloneValue(cell.p);
-	if (cell.s !== void 0) if (cell.s === null || typeof cell.s === "string") result.s = cell.s;
-	else result.s = cloneValue(cell.s);
-	if (cell.v !== void 0) result.v = cell.v;
-	if (cell.t !== void 0) result.t = cell.t;
-	if (cell.f !== void 0) result.f = cell.f;
-	if (cell.ref !== void 0) result.ref = cell.ref;
-	if (cell.xf !== void 0) result.xf = cell.xf;
-	if (cell.si !== void 0) result.si = cell.si;
-	if (cell.custom !== void 0) result.custom = cell.custom === null ? null : cloneValue(cell.custom);
-	return result;
-}
-/**
-* Fast clone for ICellDataWithSpanAndDisplay. Optimized for the known structure.
-* This extends cloneCellData with additional span and display properties.
-* @param cell - The cell data with span and display info to clone
-* @returns A deep clone of the cell data
-*/
-function cloneCellDataWithSpanAndDisplay(cell) {
-	if (cell === null || cell === void 0) return cell;
-	const result = {};
-	if (cell.p !== void 0) result.p = cell.p === null ? null : cloneValue(cell.p);
-	if (cell.s !== void 0) if (cell.s === null || typeof cell.s === "string") result.s = cell.s;
-	else result.s = cloneValue(cell.s);
-	if (cell.v !== void 0) result.v = cell.v;
-	if (cell.t !== void 0) result.t = cell.t;
-	if (cell.f !== void 0) result.f = cell.f;
-	if (cell.ref !== void 0) result.ref = cell.ref;
-	if (cell.xf !== void 0) result.xf = cell.xf;
-	if (cell.si !== void 0) result.si = cell.si;
-	if (cell.custom !== void 0) result.custom = cell.custom === null ? null : cloneValue(cell.custom);
-	if (cell.rowSpan !== void 0) result.rowSpan = cell.rowSpan;
-	if (cell.colSpan !== void 0) result.colSpan = cell.colSpan;
-	if (cell.displayV !== void 0) result.displayV = cell.displayV;
-	return result;
-}
-/**
-* Fast clone for cell data matrix. Optimized for sparse matrix structure.
-* @param cellData - The cell data matrix to clone
-* @returns A deep clone of the cell data matrix
-*/
-function cloneCellDataMatrix(cellData) {
-	const result = {};
-	const rowKeys = Object.keys(cellData);
-	for (let i = 0, rowLen = rowKeys.length; i < rowLen; i++) {
-		const rowKey = rowKeys[i];
-		const rowNum = Number(rowKey);
-		const rowData = cellData[rowNum];
-		if (rowData === void 0) continue;
-		const clonedRow = {};
-		const colKeys = Object.keys(rowData);
-		for (let j = 0, colLen = colKeys.length; j < colLen; j++) {
-			const colKey = colKeys[j];
-			const colNum = Number(colKey);
-			const cell = rowData[colNum];
-			if (cell !== void 0 && cell !== null) clonedRow[colNum] = cloneCellData(cell);
-		}
-		result[rowNum] = clonedRow;
-	}
-	return result;
-}
-/**
-* Fast clone for row/column data arrays (sparse arrays stored as objects).
-* @param data - The row or column data to clone
-* @returns A deep clone of the row or column data
-*/
-function cloneRowColumnData(data) {
-	const result = {};
-	const keys = Object.keys(data);
-	for (let i = 0, len = keys.length; i < len; i++) {
-		const key = keys[i];
-		const idx = Number(key);
-		const item = data[idx];
-		if (item === void 0) continue;
-		const cloned = {};
-		if ("h" in item && item.h !== void 0) cloned.h = item.h;
-		if ("ia" in item && item.ia !== void 0) cloned.ia = item.ia;
-		if ("ah" in item && item.ah !== void 0) cloned.ah = item.ah;
-		if ("hd" in item && item.hd !== void 0) cloned.hd = item.hd;
-		if ("w" in item && item.w !== void 0) cloned.w = item.w;
-		if ("s" in item && item.s !== void 0) if (item.s === null || typeof item.s === "string") cloned.s = item.s;
-		else cloned.s = cloneValue(item.s);
-		if ("custom" in item && item.custom !== void 0) cloned.custom = item.custom === null ? null : cloneValue(item.custom);
-		result[idx] = cloned;
-	}
-	return result;
-}
-/**
-* Fast clone for IRange array (merge data).
-* @param ranges - The array of ranges to clone
-* @returns A shallow clone of the ranges (IRange contains only primitive values)
-*/
-function cloneMergeData(ranges) {
-	const len = ranges.length;
-	const result = new Array(len);
-	for (let i = 0; i < len; i++) {
-		const range = ranges[i];
-		result[i] = {
-			startRow: range.startRow,
-			startColumn: range.startColumn,
-			endRow: range.endRow,
-			endColumn: range.endColumn,
-			rangeType: range.rangeType,
-			startAbsoluteRefType: range.startAbsoluteRefType,
-			endAbsoluteRefType: range.endAbsoluteRefType
-		};
-	}
-	return result;
-}
-/**
-* Optimized deep clone specifically for IWorksheetData.
-* This is significantly faster than generic deepClone because:
-* 1. No recursive type checking - we know the structure
-* 2. Direct property access instead of Object.keys iteration for known properties
-* 3. Specialized handlers for cellData matrix (the largest data)
-* 4. Primitive values copied directly without cloning
-*
-* @param worksheet - The worksheet data to clone
-* @returns A deep clone of the worksheet data
-*/
-function cloneWorksheetData(worksheet) {
-	const result = {
-		id: worksheet.id,
-		name: worksheet.name,
-		tabColor: worksheet.tabColor,
-		hidden: worksheet.hidden,
-		rowCount: worksheet.rowCount,
-		columnCount: worksheet.columnCount,
-		zoomRatio: worksheet.zoomRatio,
-		scrollTop: worksheet.scrollTop,
-		scrollLeft: worksheet.scrollLeft,
-		defaultColumnWidth: worksheet.defaultColumnWidth,
-		defaultRowHeight: worksheet.defaultRowHeight,
-		showGridlines: worksheet.showGridlines,
-		rightToLeft: worksheet.rightToLeft,
-		freeze: {
-			xSplit: worksheet.freeze.xSplit,
-			ySplit: worksheet.freeze.ySplit,
-			startRow: worksheet.freeze.startRow,
-			startColumn: worksheet.freeze.startColumn
-		},
-		rowHeader: {
-			width: worksheet.rowHeader.width,
-			hidden: worksheet.rowHeader.hidden
-		},
-		columnHeader: {
-			height: worksheet.columnHeader.height,
-			hidden: worksheet.columnHeader.hidden
-		},
-		mergeData: cloneMergeData(worksheet.mergeData),
-		cellData: cloneCellDataMatrix(worksheet.cellData),
-		rowData: cloneRowColumnData(worksheet.rowData),
-		columnData: cloneRowColumnData(worksheet.columnData)
-	};
-	if (worksheet.gridlinesColor !== void 0) result.gridlinesColor = worksheet.gridlinesColor;
-	if (worksheet.defaultStyle !== void 0) if (worksheet.defaultStyle === null || typeof worksheet.defaultStyle === "string") result.defaultStyle = worksheet.defaultStyle;
-	else result.defaultStyle = cloneValue(worksheet.defaultStyle);
-	if (worksheet.custom !== void 0) result.custom = worksheet.custom === null ? null : cloneValue(worksheet.custom);
-	return result;
-}
-
-//#endregion
-//#region src/sheets/column-manager.ts
-/**
-* Manage configuration information of all columns, get column width, column length, set column width, etc.
-*/
-var ColumnManager = class {
-	constructor(_config, data) {
-		this._config = _config;
-		_defineProperty(this, "_columnData", {});
-		this._columnData = data;
-	}
-	/**
-	* Get width and hidden status of columns in the sheet
-	* @returns {IObjectArrayPrimitiveType<Partial<IColumnData>>} Column data, including width, hidden status, etc.
-	*/
-	getColumnData() {
-		return this._columnData;
+	/**
+	* Get width and hidden status of columns in the sheet
+	* @returns {IObjectArrayPrimitiveType<Partial<IColumnData>>} Column data, including width, hidden status, etc.
+	*/
+	getColumnData() {
+		return this._columnData;
 	}
 	getColVisible(colPos) {
 		const { _columnData } = this;
@@ -21748,8 +21500,7 @@ var ColumnManager = class {
 		const columnData = {};
 		let index = 0;
 		for (let i = columnPos; i < columnPos + numColumns; i++) {
-			const data = this.getColumn(i);
-			columnData[index] = data !== null && data !== void 0 ? data : {
+			columnData[index] = this.getColumn(i) ?? {
 				w: this._config.defaultColumnWidth,
 				hd: 0
 			};
@@ -21770,8 +21521,8 @@ var ColumnManager = class {
 	* @returns {number} width of column
 	*/
 	getColumnWidth(columnPos) {
-		var _this$_columnData$col2, _this$_columnData$col3;
-		return (_this$_columnData$col2 = (_this$_columnData$col3 = this._columnData[columnPos]) === null || _this$_columnData$col3 === void 0 ? void 0 : _this$_columnData$col3.w) !== null && _this$_columnData$col2 !== void 0 ? _this$_columnData$col2 : this._config.defaultColumnWidth;
+		var _this$_columnData$col2;
+		return ((_this$_columnData$col2 = this._columnData[columnPos]) === null || _this$_columnData$col2 === void 0 ? void 0 : _this$_columnData$col2.w) ?? this._config.defaultColumnWidth;
 	}
 	/**
 	* Set the width of column
@@ -21892,8 +21643,7 @@ var RowManager = class {
 		const rowData = {};
 		let index = 0;
 		for (let i = rowPos; i < rowPos + numRows; i++) {
-			const data = this.getRow(i);
-			rowData[index] = data !== null && data !== void 0 ? data : {
+			rowData[index] = this.getRow(i) ?? {
 				h: this._config.defaultRowHeight,
 				hd: 0
 			};
@@ -22334,8 +22084,8 @@ var SheetViewModel = class extends Disposable {
 		return this.getRawCell(row, col);
 	}
 	getRowFiltered(row) {
-		var _this$_rowFilteredInt, _this$_rowFilteredInt2;
-		return (_this$_rowFilteredInt = (_this$_rowFilteredInt2 = this._rowFilteredInterceptor) === null || _this$_rowFilteredInt2 === void 0 ? void 0 : _this$_rowFilteredInt2.getRowFiltered(row)) !== null && _this$_rowFilteredInt !== void 0 ? _this$_rowFilteredInt : false;
+		var _this$_rowFilteredInt;
+		return ((_this$_rowFilteredInt = this._rowFilteredInterceptor) === null || _this$_rowFilteredInt === void 0 ? void 0 : _this$_rowFilteredInt.getRowFiltered(row)) ?? false;
 	}
 	registerCellContentInterceptor(interceptor) {
 		if (this._cellContentInterceptor) throw new Error("[SheetViewModel]: Interceptor already registered.");
@@ -22359,9 +22109,8 @@ const DEFAULT_CELL_DOCUMENT_MODEL_OPTION = {
 /**
 * The model of a Worksheet.
 */
-var Worksheet = class Worksheet {
+var Worksheet = class {
 	constructor(unitId, snapshot, _styles) {
-		var _this$_snapshot$id;
 		this.unitId = unitId;
 		this._styles = _styles;
 		_defineProperty(this, "_sheetId", void 0);
@@ -22375,7 +22124,7 @@ var Worksheet = class Worksheet {
 		_defineProperty(this, "_getCellHeight", void 0);
 		this._snapshot = mergeWorksheetSnapshotWithDefault(snapshot);
 		const { columnData, rowData, cellData } = this._snapshot;
-		this._sheetId = (_this$_snapshot$id = this._snapshot.id) !== null && _this$_snapshot$id !== void 0 ? _this$_snapshot$id : generateRandomId(6);
+		this._sheetId = this._snapshot.id ?? generateRandomId(6);
 		this._cellData = new ObjectMatrix(cellData);
 		this._viewModel = new SheetViewModel((row, col) => this.getCellRaw(row, col));
 		this._rowManager = new RowManager(this._snapshot, this._viewModel, rowData);
@@ -22492,7 +22241,7 @@ var Worksheet = class Worksheet {
 		const colStyle = this.getColumnStyle(col);
 		const cell = this.getCell(row, col);
 		const cellStyle = this._styles.getStyleByCell(cell);
-		return (rowPriority !== null && rowPriority !== void 0 ? rowPriority : this._isRowStylePrecedeColumnStyle) ? composeStyles(defaultStyle, colStyle, rowStyle, cell === null || cell === void 0 ? void 0 : cell.themeStyle, cellStyle) : composeStyles(defaultStyle, rowStyle, colStyle, cell === null || cell === void 0 ? void 0 : cell.themeStyle, cellStyle);
+		return rowPriority ?? this._isRowStylePrecedeColumnStyle ? composeStyles(defaultStyle, colStyle, rowStyle, cell === null || cell === void 0 ? void 0 : cell.themeStyle, cellStyle) : composeStyles(defaultStyle, rowStyle, colStyle, cell === null || cell === void 0 ? void 0 : cell.themeStyle, cellStyle);
 	}
 	/**
 	* Get the composed style of the cell. If you want to get the style of the cell without merging row style,
@@ -22510,7 +22259,7 @@ var Worksheet = class Worksheet {
 		const rowStyle = this.getRowStyle(row);
 		const colStyle = this.getColumnStyle(col);
 		const cellStyle = this._styles.getStyleByCell(cellData);
-		return (rowPriority !== null && rowPriority !== void 0 ? rowPriority : this._isRowStylePrecedeColumnStyle) ? composeStyles(defaultStyle, colStyle, rowStyle, cellData === null || cellData === void 0 ? void 0 : cellData.themeStyle, cellStyle) : composeStyles(defaultStyle, rowStyle, colStyle, cellData === null || cellData === void 0 ? void 0 : cellData.themeStyle, cellStyle);
+		return rowPriority ?? this._isRowStylePrecedeColumnStyle ? composeStyles(defaultStyle, colStyle, rowStyle, cellData === null || cellData === void 0 ? void 0 : cellData.themeStyle, cellStyle) : composeStyles(defaultStyle, rowStyle, colStyle, cellData === null || cellData === void 0 ? void 0 : cellData.themeStyle, cellStyle);
 	}
 	/**
 	* Get the composed style of the cell without its own style.
@@ -22628,16 +22377,6 @@ var Worksheet = class Worksheet {
 		return this._snapshot.name;
 	}
 	/**
-	* Returns WorkSheet Clone Object
-	* @returns WorkSheet Clone Object
-	* @deprecated
-	*/
-	clone() {
-		const { _snapshot: _config } = this;
-		const copy = cloneWorksheetData(_config);
-		return new Worksheet(this.unitId, copy, this._styles);
-	}
-	/**
 	* Get the merged cell list of the sheet.
 	* @returns {IRange[]} merged cell list
 	*/
@@ -23228,14 +22967,14 @@ var Worksheet = class Worksheet {
 		};
 	}
 	_updateConfigAndGetDocumentModel(documentData, horizontalAlign, paddingData, renderConfig) {
-		var _documentData$body, _paddingData$t, _paddingData$b, _paddingData$l, _paddingData$r;
+		var _documentData$body;
 		if (!renderConfig) return;
 		if (!((_documentData$body = documentData.body) === null || _documentData$body === void 0 ? void 0 : _documentData$body.dataStream)) return;
 		if (!documentData.documentStyle) documentData.documentStyle = {};
-		documentData.documentStyle.marginTop = (_paddingData$t = paddingData.t) !== null && _paddingData$t !== void 0 ? _paddingData$t : 0;
-		documentData.documentStyle.marginBottom = (_paddingData$b = paddingData.b) !== null && _paddingData$b !== void 0 ? _paddingData$b : 2;
-		documentData.documentStyle.marginLeft = (_paddingData$l = paddingData.l) !== null && _paddingData$l !== void 0 ? _paddingData$l : 2;
-		documentData.documentStyle.marginRight = (_paddingData$r = paddingData.r) !== null && _paddingData$r !== void 0 ? _paddingData$r : 2;
+		documentData.documentStyle.marginTop = paddingData.t ?? 0;
+		documentData.documentStyle.marginBottom = paddingData.b ?? 2;
+		documentData.documentStyle.marginLeft = paddingData.l ?? 2;
+		documentData.documentStyle.marginRight = paddingData.r ?? 2;
 		documentData.documentStyle.pageSize = {
 			width: Number.POSITIVE_INFINITY,
 			height: Number.POSITIVE_INFINITY
@@ -23424,10 +23163,6 @@ let Workbook = class Workbook extends UnitModel {
 	getSnapshot() {
 		return this._snapshot;
 	}
-	/** @deprecated use use name property instead */
-	getName() {
-		return this._snapshot.name;
-	}
 	setName(name) {
 		this._name$.next(name);
 		this._snapshot.name = name;
@@ -23436,8 +23171,7 @@ let Workbook = class Workbook extends UnitModel {
 		return this._unitId;
 	}
 	getRev() {
-		var _this$_snapshot$rev;
-		return (_this$_snapshot$rev = this._snapshot.rev) !== null && _this$_snapshot$rev !== void 0 ? _this$_snapshot$rev : 1;
+		return this._snapshot.rev ?? 1;
 	}
 	incrementRev() {
 		this._snapshot.rev = this.getRev() + 1;
@@ -23721,10 +23455,7 @@ let UniverInstanceService = class UniverInstanceService extends Disposable {
 		return this._ctorByType.get(type);
 	}
 	getCurrentTypeOfUnit$(type) {
-		return this.currentUnits$.pipe((0, rxjs.map)((units) => {
-			var _units$get;
-			return (_units$get = units.get(type)) !== null && _units$get !== void 0 ? _units$get : null;
-		}), (0, rxjs.distinctUntilChanged)());
+		return this.currentUnits$.pipe((0, rxjs.map)((units) => units.get(type) ?? null), (0, rxjs.distinctUntilChanged)());
 	}
 	getCurrentUnitOfType(type) {
 		return this._currentUnits.get(type);
@@ -23747,7 +23478,6 @@ let UniverInstanceService = class UniverInstanceService extends Disposable {
 	* @param unit The unit to be added.
 	*/
 	__addUnit(unit, options) {
-		var _options$makeCurrent;
 		this._logService.debug(`[UniverInstanceService]: Adding unit with id ${unit.getUnitId()}`);
 		const type = unit.type;
 		if (!this._unitsByType.has(type)) this._unitsByType.set(type, []);
@@ -23760,7 +23490,7 @@ let UniverInstanceService = class UniverInstanceService extends Disposable {
 			unit,
 			options
 		});
-		if ((_options$makeCurrent = options === null || options === void 0 ? void 0 : options.makeCurrent) !== null && _options$makeCurrent !== void 0 ? _options$makeCurrent : true) this.setCurrentUnitForType(unit.getUnitId());
+		if ((options === null || options === void 0 ? void 0 : options.makeCurrent) ?? true) this.setCurrentUnitForType(unit.getUnitId());
 	}
 	getTypeOfUnitDisposed$(type) {
 		return this.unitDisposed$.pipe((0, rxjs.filter)((unit) => unit.type === type));
@@ -23772,24 +23502,10 @@ let UniverInstanceService = class UniverInstanceService extends Disposable {
 		return unit;
 	}
 	getUnitCreateOptions(unitId) {
-		var _this$_unitCreateOpti;
-		return (_this$_unitCreateOpti = this._unitCreateOptions.get(unitId)) !== null && _this$_unitCreateOpti !== void 0 ? _this$_unitCreateOpti : null;
-	}
-	getUniverSheetInstance(unitId) {
-		return this.getUnit(unitId, _univerjs_protocol.UniverType.UNIVER_SHEET);
+		return this._unitCreateOptions.get(unitId) ?? null;
 	}
 	getAllUnitsForType(type) {
-		var _this$_unitsByType$ge;
-		return (_this$_unitsByType$ge = this._unitsByType.get(type)) !== null && _this$_unitsByType$ge !== void 0 ? _this$_unitsByType$ge : [];
-	}
-	changeDoc(unitId, doc) {
-		const allDocs = this.getAllUnitsForType(_univerjs_protocol.UniverType.UNIVER_DOC);
-		const oldDoc = allDocs.find((doc) => doc.getUnitId() === unitId);
-		if (oldDoc != null) {
-			const index = allDocs.indexOf(oldDoc);
-			allDocs.splice(index, 1);
-		}
-		this.__addUnit(doc);
+		return this._unitsByType.get(type) ?? [];
 	}
 	get focused() {
 		var _this$_getUnitById2;
@@ -24098,16 +23814,15 @@ var LocaleService = class extends Disposable {
 	* @param locales - Locale object
 	*/
 	load(locales) {
-		var _this$_locales;
-		this._locales = (0, lodash_es.merge)((_this$_locales = this._locales) !== null && _this$_locales !== void 0 ? _this$_locales : {}, locales);
+		this._locales = (0, lodash_es.merge)(this._locales ?? {}, locales);
 	}
 	setLocale(locale) {
 		this._currentLocale$.next(locale);
 		this.localeChanged$.next();
 	}
 	getLocales() {
-		var _this$_locales2;
-		return (_this$_locales2 = this._locales) === null || _this$_locales2 === void 0 ? void 0 : _this$_locales2[this._currentLocale];
+		var _this$_locales;
+		return (_this$_locales = this._locales) === null || _this$_locales === void 0 ? void 0 : _this$_locales[this._currentLocale];
 	}
 	getCurrentLocale() {
 		return this._currentLocale;
@@ -24834,12 +24549,12 @@ let LocalUndoRedoService = class LocalUndoRedoService extends Disposable {
 		if (isFocusSheet) if (isFocusFormulaEditor) unitID = DOCS_FORMULA_BAR_EDITOR_UNIT_ID_KEY;
 		else if (isFocusEditor) unitID = DOCS_NORMAL_EDITOR_UNIT_ID_KEY;
 		else {
-			var _this$_univerInstance, _this$_univerInstance2;
-			unitID = (_this$_univerInstance = (_this$_univerInstance2 = this._univerInstanceService.getFocusedUnit()) === null || _this$_univerInstance2 === void 0 ? void 0 : _this$_univerInstance2.getUnitId()) !== null && _this$_univerInstance !== void 0 ? _this$_univerInstance : "";
+			var _this$_univerInstance;
+			unitID = ((_this$_univerInstance = this._univerInstanceService.getFocusedUnit()) === null || _this$_univerInstance === void 0 ? void 0 : _this$_univerInstance.getUnitId()) ?? "";
 		}
 		else {
-			var _this$_univerInstance3, _this$_univerInstance4;
-			unitID = (_this$_univerInstance3 = (_this$_univerInstance4 = this._univerInstanceService.getFocusedUnit()) === null || _this$_univerInstance4 === void 0 ? void 0 : _this$_univerInstance4.getUnitId()) !== null && _this$_univerInstance3 !== void 0 ? _this$_univerInstance3 : "";
+			var _this$_univerInstance2;
+			unitID = ((_this$_univerInstance2 = this._univerInstanceService.getFocusedUnit()) === null || _this$_univerInstance2 === void 0 ? void 0 : _this$_univerInstance2.getUnitId()) ?? "";
 		}
 		return unitID;
 	}
@@ -25217,6 +24932,198 @@ function delayAnimationFrame(frames = 1) {
 	});
 }
 
+//#endregion
+//#region src/sheets/clone.ts
+/**
+* Fast clone for primitive values and simple objects.
+* Avoids type checking overhead when we know the structure.
+*/
+function cloneValue(value) {
+	if (value === null || value === void 0) return value;
+	if (typeof value !== "object") return value;
+	if (Array.isArray(value)) {
+		const len = value.length;
+		const result = new Array(len);
+		for (let i = 0; i < len; i++) result[i] = cloneValue(value[i]);
+		return result;
+	}
+	const result = {};
+	const keys = Object.keys(value);
+	for (let i = 0, len = keys.length; i < len; i++) {
+		const key = keys[i];
+		result[key] = cloneValue(value[key]);
+	}
+	return result;
+}
+/**
+* Fast clone for ICellData. Optimized for the known structure.
+* @param cell - The cell data to clone
+* @returns A deep clone of the cell data
+*/
+function cloneCellData(cell) {
+	if (cell === null || cell === void 0) return cell;
+	const result = {};
+	if (cell.p !== void 0) result.p = cell.p === null ? null : cloneValue(cell.p);
+	if (cell.s !== void 0) if (cell.s === null || typeof cell.s === "string") result.s = cell.s;
+	else result.s = cloneValue(cell.s);
+	if (cell.v !== void 0) result.v = cell.v;
+	if (cell.t !== void 0) result.t = cell.t;
+	if (cell.f !== void 0) result.f = cell.f;
+	if (cell.ref !== void 0) result.ref = cell.ref;
+	if (cell.xf !== void 0) result.xf = cell.xf;
+	if (cell.si !== void 0) result.si = cell.si;
+	if (cell.custom !== void 0) result.custom = cell.custom === null ? null : cloneValue(cell.custom);
+	return result;
+}
+/**
+* Fast clone for ICellDataWithSpanAndDisplay. Optimized for the known structure.
+* This extends cloneCellData with additional span and display properties.
+* @param cell - The cell data with span and display info to clone
+* @returns A deep clone of the cell data
+*/
+function cloneCellDataWithSpanAndDisplay(cell) {
+	if (cell === null || cell === void 0) return cell;
+	const result = {};
+	if (cell.p !== void 0) result.p = cell.p === null ? null : cloneValue(cell.p);
+	if (cell.s !== void 0) if (cell.s === null || typeof cell.s === "string") result.s = cell.s;
+	else result.s = cloneValue(cell.s);
+	if (cell.v !== void 0) result.v = cell.v;
+	if (cell.t !== void 0) result.t = cell.t;
+	if (cell.f !== void 0) result.f = cell.f;
+	if (cell.ref !== void 0) result.ref = cell.ref;
+	if (cell.xf !== void 0) result.xf = cell.xf;
+	if (cell.si !== void 0) result.si = cell.si;
+	if (cell.custom !== void 0) result.custom = cell.custom === null ? null : cloneValue(cell.custom);
+	if (cell.rowSpan !== void 0) result.rowSpan = cell.rowSpan;
+	if (cell.colSpan !== void 0) result.colSpan = cell.colSpan;
+	if (cell.displayV !== void 0) result.displayV = cell.displayV;
+	return result;
+}
+/**
+* Fast clone for cell data matrix. Optimized for sparse matrix structure.
+* @param cellData - The cell data matrix to clone
+* @returns A deep clone of the cell data matrix
+*/
+function cloneCellDataMatrix(cellData) {
+	const result = {};
+	const rowKeys = Object.keys(cellData);
+	for (let i = 0, rowLen = rowKeys.length; i < rowLen; i++) {
+		const rowKey = rowKeys[i];
+		const rowNum = Number(rowKey);
+		const rowData = cellData[rowNum];
+		if (rowData === void 0) continue;
+		const clonedRow = {};
+		const colKeys = Object.keys(rowData);
+		for (let j = 0, colLen = colKeys.length; j < colLen; j++) {
+			const colKey = colKeys[j];
+			const colNum = Number(colKey);
+			const cell = rowData[colNum];
+			if (cell !== void 0 && cell !== null) clonedRow[colNum] = cloneCellData(cell);
+		}
+		result[rowNum] = clonedRow;
+	}
+	return result;
+}
+/**
+* Fast clone for row/column data arrays (sparse arrays stored as objects).
+* @param data - The row or column data to clone
+* @returns A deep clone of the row or column data
+*/
+function cloneRowColumnData(data) {
+	const result = {};
+	const keys = Object.keys(data);
+	for (let i = 0, len = keys.length; i < len; i++) {
+		const key = keys[i];
+		const idx = Number(key);
+		const item = data[idx];
+		if (item === void 0) continue;
+		const cloned = {};
+		if ("h" in item && item.h !== void 0) cloned.h = item.h;
+		if ("ia" in item && item.ia !== void 0) cloned.ia = item.ia;
+		if ("ah" in item && item.ah !== void 0) cloned.ah = item.ah;
+		if ("hd" in item && item.hd !== void 0) cloned.hd = item.hd;
+		if ("w" in item && item.w !== void 0) cloned.w = item.w;
+		if ("s" in item && item.s !== void 0) if (item.s === null || typeof item.s === "string") cloned.s = item.s;
+		else cloned.s = cloneValue(item.s);
+		if ("custom" in item && item.custom !== void 0) cloned.custom = item.custom === null ? null : cloneValue(item.custom);
+		result[idx] = cloned;
+	}
+	return result;
+}
+/**
+* Fast clone for IRange array (merge data).
+* @param ranges - The array of ranges to clone
+* @returns A shallow clone of the ranges (IRange contains only primitive values)
+*/
+function cloneMergeData(ranges) {
+	const len = ranges.length;
+	const result = new Array(len);
+	for (let i = 0; i < len; i++) {
+		const range = ranges[i];
+		result[i] = {
+			startRow: range.startRow,
+			startColumn: range.startColumn,
+			endRow: range.endRow,
+			endColumn: range.endColumn,
+			rangeType: range.rangeType,
+			startAbsoluteRefType: range.startAbsoluteRefType,
+			endAbsoluteRefType: range.endAbsoluteRefType
+		};
+	}
+	return result;
+}
+/**
+* Optimized deep clone specifically for IWorksheetData.
+* This is significantly faster than generic deepClone because:
+* 1. No recursive type checking - we know the structure
+* 2. Direct property access instead of Object.keys iteration for known properties
+* 3. Specialized handlers for cellData matrix (the largest data)
+* 4. Primitive values copied directly without cloning
+*
+* @param worksheet - The worksheet data to clone
+* @returns A deep clone of the worksheet data
+*/
+function cloneWorksheetData(worksheet) {
+	const result = {
+		id: worksheet.id,
+		name: worksheet.name,
+		tabColor: worksheet.tabColor,
+		hidden: worksheet.hidden,
+		rowCount: worksheet.rowCount,
+		columnCount: worksheet.columnCount,
+		zoomRatio: worksheet.zoomRatio,
+		scrollTop: worksheet.scrollTop,
+		scrollLeft: worksheet.scrollLeft,
+		defaultColumnWidth: worksheet.defaultColumnWidth,
+		defaultRowHeight: worksheet.defaultRowHeight,
+		showGridlines: worksheet.showGridlines,
+		rightToLeft: worksheet.rightToLeft,
+		freeze: {
+			xSplit: worksheet.freeze.xSplit,
+			ySplit: worksheet.freeze.ySplit,
+			startRow: worksheet.freeze.startRow,
+			startColumn: worksheet.freeze.startColumn
+		},
+		rowHeader: {
+			width: worksheet.rowHeader.width,
+			hidden: worksheet.rowHeader.hidden
+		},
+		columnHeader: {
+			height: worksheet.columnHeader.height,
+			hidden: worksheet.columnHeader.hidden
+		},
+		mergeData: cloneMergeData(worksheet.mergeData),
+		cellData: cloneCellDataMatrix(worksheet.cellData),
+		rowData: cloneRowColumnData(worksheet.rowData),
+		columnData: cloneRowColumnData(worksheet.columnData)
+	};
+	if (worksheet.gridlinesColor !== void 0) result.gridlinesColor = worksheet.gridlinesColor;
+	if (worksheet.defaultStyle !== void 0) if (worksheet.defaultStyle === null || typeof worksheet.defaultStyle === "string") result.defaultStyle = worksheet.defaultStyle;
+	else result.defaultStyle = cloneValue(worksheet.defaultStyle);
+	if (worksheet.custom !== void 0) result.custom = worksheet.custom === null ? null : cloneValue(worksheet.custom);
+	return result;
+}
+
 //#endregion
 //#region src/skeleton.ts
 let Skeleton = class Skeleton extends Disposable {
@@ -25323,18 +25230,11 @@ let SheetSkeleton = class SheetSkeleton extends Skeleton {
 		this.initConfig();
 	}
 	initConfig() {
-		var _this$_configService$, _this$_configService$2;
-		this._skipAutoHeightForMergedCells = !((_this$_configService$ = this._configService.getConfig(AUTO_HEIGHT_FOR_MERGED_CELLS)) !== null && _this$_configService$ !== void 0 ? _this$_configService$ : false);
-		this.worksheet.setIsRowStylePrecedeColumnStyle((_this$_configService$2 = this._configService.getConfig("isRowStylePrecedeColumnStyle")) !== null && _this$_configService$2 !== void 0 ? _this$_configService$2 : false);
+		this._skipAutoHeightForMergedCells = !(this._configService.getConfig(AUTO_HEIGHT_FOR_MERGED_CELLS) ?? false);
+		this.worksheet.setIsRowStylePrecedeColumnStyle(this._configService.getConfig("isRowStylePrecedeColumnStyle") ?? false);
 	}
 	resetCache() {}
 	/**
-	* @deprecated should never expose a property that is provided by another module!
-	*/
-	getWorksheetConfig() {
-		return this._worksheetData;
-	}
-	/**
 	* Get which Workbook and Worksheet this skeleton is attached to.
 	* @returns [unitId, sheetId]
 	*/
@@ -25417,28 +25317,27 @@ let SheetSkeleton = class SheetSkeleton extends Skeleton {
 		this._updateLayout();
 	}
 	_fillDefaultGapThemeColors(config) {
-		var _config$defaultBackgr, _config$defaultStripe;
 		if (config.defaultBackgroundColor && config.defaultStripeColor) return config;
 		const { r, g, b } = new ColorKit(this._injector.get(ThemeService).getColorFromTheme("primary.500")).toRgb();
 		return {
 			...config,
-			defaultBackgroundColor: (_config$defaultBackgr = config.defaultBackgroundColor) !== null && _config$defaultBackgr !== void 0 ? _config$defaultBackgr : `rgba(${r}, ${g}, ${b}, 0.025)`,
-			defaultStripeColor: (_config$defaultStripe = config.defaultStripeColor) !== null && _config$defaultStripe !== void 0 ? _config$defaultStripe : `rgba(${r}, ${g}, ${b}, 0.08)`
+			defaultBackgroundColor: config.defaultBackgroundColor ?? `rgba(${r}, ${g}, ${b}, 0.025)`,
+			defaultStripeColor: config.defaultStripeColor ?? `rgba(${r}, ${g}, ${b}, 0.08)`
 		};
 	}
 	/**
 	* Get the gap size (in px) BEFORE the given row.
 	*/
 	getRowGapSize(row) {
-		var _this$_gapConfig$rowG, _this$_gapConfig$rowG2;
-		return (_this$_gapConfig$rowG = (_this$_gapConfig$rowG2 = this._gapConfig.rowGaps) === null || _this$_gapConfig$rowG2 === void 0 || (_this$_gapConfig$rowG2 = _this$_gapConfig$rowG2[row]) === null || _this$_gapConfig$rowG2 === void 0 ? void 0 : _this$_gapConfig$rowG2.size) !== null && _this$_gapConfig$rowG !== void 0 ? _this$_gapConfig$rowG : 0;
+		var _this$_gapConfig$rowG;
+		return ((_this$_gapConfig$rowG = this._gapConfig.rowGaps) === null || _this$_gapConfig$rowG === void 0 || (_this$_gapConfig$rowG = _this$_gapConfig$rowG[row]) === null || _this$_gapConfig$rowG === void 0 ? void 0 : _this$_gapConfig$rowG.size) ?? 0;
 	}
 	/**
 	* Get the gap size (in px) BEFORE the given column.
 	*/
 	getColGapSize(col) {
-		var _this$_gapConfig$colG, _this$_gapConfig$colG2;
-		return (_this$_gapConfig$colG = (_this$_gapConfig$colG2 = this._gapConfig.colGaps) === null || _this$_gapConfig$colG2 === void 0 || (_this$_gapConfig$colG2 = _this$_gapConfig$colG2[col]) === null || _this$_gapConfig$colG2 === void 0 ? void 0 : _this$_gapConfig$colG2.size) !== null && _this$_gapConfig$colG !== void 0 ? _this$_gapConfig$colG : 0;
+		var _this$_gapConfig$colG;
+		return ((_this$_gapConfig$colG = this._gapConfig.colGaps) === null || _this$_gapConfig$colG === void 0 || (_this$_gapConfig$colG = _this$_gapConfig$colG[col]) === null || _this$_gapConfig$colG === void 0 ? void 0 : _this$_gapConfig$colG.size) ?? 0;
 	}
 	/**
 	* Returns a gap size getter object for use with coordinate utility functions.
@@ -25458,11 +25357,11 @@ let SheetSkeleton = class SheetSkeleton extends Skeleton {
 		const { rowGaps } = this._gapConfig;
 		if (!rowGaps) return -1;
 		for (const rowStr of Object.keys(rowGaps)) {
-			var _rowGaps$row$size, _rowGaps$row, _this$_rowHeightAccum;
+			var _rowGaps$row;
 			const row = Number(rowStr);
-			const gapSize = (_rowGaps$row$size = (_rowGaps$row = rowGaps[row]) === null || _rowGaps$row === void 0 ? void 0 : _rowGaps$row.size) !== null && _rowGaps$row$size !== void 0 ? _rowGaps$row$size : 0;
+			const gapSize = ((_rowGaps$row = rowGaps[row]) === null || _rowGaps$row === void 0 ? void 0 : _rowGaps$row.size) ?? 0;
 			if (gapSize <= 0) continue;
-			const gapStart = (_this$_rowHeightAccum = this._rowHeightAccumulation[row - 1]) !== null && _this$_rowHeightAccum !== void 0 ? _this$_rowHeightAccum : 0;
+			const gapStart = this._rowHeightAccumulation[row - 1] ?? 0;
 			const gapEnd = gapStart + gapSize;
 			if (y >= gapStart && y < gapEnd) return row;
 		}
@@ -25476,11 +25375,11 @@ let SheetSkeleton = class SheetSkeleton extends Skeleton {
 		const { colGaps } = this._gapConfig;
 		if (!colGaps) return -1;
 		for (const colStr of Object.keys(colGaps)) {
-			var _colGaps$col$size, _colGaps$col, _this$_columnWidthAcc;
+			var _colGaps$col;
 			const col = Number(colStr);
-			const gapSize = (_colGaps$col$size = (_colGaps$col = colGaps[col]) === null || _colGaps$col === void 0 ? void 0 : _colGaps$col.size) !== null && _colGaps$col$size !== void 0 ? _colGaps$col$size : 0;
+			const gapSize = ((_colGaps$col = colGaps[col]) === null || _colGaps$col === void 0 ? void 0 : _colGaps$col.size) ?? 0;
 			if (gapSize <= 0) continue;
-			const gapStart = (_this$_columnWidthAcc = this._columnWidthAccumulation[col - 1]) !== null && _this$_columnWidthAcc !== void 0 ? _this$_columnWidthAcc : 0;
+			const gapStart = this._columnWidthAccumulation[col - 1] ?? 0;
 			const gapEnd = gapStart + gapSize;
 			if (x >= gapStart && x < gapEnd) return col;
 		}
@@ -25491,7 +25390,7 @@ let SheetSkeleton = class SheetSkeleton extends Skeleton {
 		const rowHeightAccumulation = [];
 		const data = rowData;
 		for (let r = 0; r < rowCount; r++) {
-			var _this$_gapConfig$rowG3, _this$_gapConfig$rowG4;
+			var _this$_gapConfig$rowG2;
 			let rowHeight = defaultRowHeight;
 			if (this.worksheet.getRowFiltered(r)) rowHeight = 0;
 			else if (data[r] != null) {
@@ -25502,7 +25401,7 @@ let SheetSkeleton = class SheetSkeleton extends Skeleton {
 				else rowHeight = h;
 				if (rowDataItem.hd === 1) rowHeight = 0;
 			}
-			const gapSize = (_this$_gapConfig$rowG3 = (_this$_gapConfig$rowG4 = this._gapConfig.rowGaps) === null || _this$_gapConfig$rowG4 === void 0 || (_this$_gapConfig$rowG4 = _this$_gapConfig$rowG4[r]) === null || _this$_gapConfig$rowG4 === void 0 ? void 0 : _this$_gapConfig$rowG4.size) !== null && _this$_gapConfig$rowG3 !== void 0 ? _this$_gapConfig$rowG3 : 0;
+			const gapSize = ((_this$_gapConfig$rowG2 = this._gapConfig.rowGaps) === null || _this$_gapConfig$rowG2 === void 0 || (_this$_gapConfig$rowG2 = _this$_gapConfig$rowG2[r]) === null || _this$_gapConfig$rowG2 === void 0 ? void 0 : _this$_gapConfig$rowG2.size) ?? 0;
 			rowTotalHeight += gapSize;
 			rowTotalHeight += rowHeight;
 			rowHeightAccumulation.push(rowTotalHeight);
@@ -25520,7 +25419,7 @@ let SheetSkeleton = class SheetSkeleton extends Skeleton {
 		const columnWidthAccumulation = [];
 		const data = columnData;
 		for (let c = 0; c < colCount; c++) {
-			var _this$_gapConfig$colG3, _this$_gapConfig$colG4;
+			var _this$_gapConfig$colG2;
 			let columnWidth = defaultColumnWidth;
 			if (data[c] != null) {
 				const columnDataItem = data[c];
@@ -25528,7 +25427,7 @@ let SheetSkeleton = class SheetSkeleton extends Skeleton {
 				if (columnDataItem.w != null) columnWidth = columnDataItem.w;
 				if (columnDataItem.hd === 1) columnWidth = 0;
 			}
-			const gapSize = (_this$_gapConfig$colG3 = (_this$_gapConfig$colG4 = this._gapConfig.colGaps) === null || _this$_gapConfig$colG4 === void 0 || (_this$_gapConfig$colG4 = _this$_gapConfig$colG4[c]) === null || _this$_gapConfig$colG4 === void 0 ? void 0 : _this$_gapConfig$colG4.size) !== null && _this$_gapConfig$colG3 !== void 0 ? _this$_gapConfig$colG3 : 0;
+			const gapSize = ((_this$_gapConfig$colG2 = this._gapConfig.colGaps) === null || _this$_gapConfig$colG2 === void 0 || (_this$_gapConfig$colG2 = _this$_gapConfig$colG2[c]) === null || _this$_gapConfig$colG2 === void 0 ? void 0 : _this$_gapConfig$colG2.size) ?? 0;
 			columnTotalWidth += gapSize;
 			columnTotalWidth += columnWidth;
 			columnWidthAccumulation.push(columnTotalWidth);
@@ -25714,8 +25613,7 @@ let SheetSkeleton = class SheetSkeleton extends Skeleton {
 		offsetY = getTransformOffsetY(offsetY, scaleY, scrollXY, this.columnHeaderHeightAndMarginTop);
 		let row = searchArray(rowHeightAccumulation, offsetY, options === null || options === void 0 ? void 0 : options.firstMatch);
 		if (options === null || options === void 0 ? void 0 : options.closeFirst) {
-			var _rowHeightAccumulatio;
-			if (Math.abs(rowHeightAccumulation[row] - offsetY) < Math.abs(offsetY - ((_rowHeightAccumulatio = rowHeightAccumulation[row - 1]) !== null && _rowHeightAccumulatio !== void 0 ? _rowHeightAccumulatio : 0))) row = row + 1;
+			if (Math.abs(rowHeightAccumulation[row] - offsetY) < Math.abs(offsetY - (rowHeightAccumulation[row - 1] ?? 0))) row = row + 1;
 		}
 		return row;
 	}
@@ -25727,8 +25625,7 @@ let SheetSkeleton = class SheetSkeleton extends Skeleton {
 		const { columnWidthAccumulation } = this;
 		let column = searchArray(columnWidthAccumulation, offsetX, options === null || options === void 0 ? void 0 : options.firstMatch);
 		if (options === null || options === void 0 ? void 0 : options.closeFirst) {
-			var _columnWidthAccumulat;
-			if (Math.abs(columnWidthAccumulation[column] - offsetX) < Math.abs(offsetX - ((_columnWidthAccumulat = columnWidthAccumulation[column - 1]) !== null && _columnWidthAccumulat !== void 0 ? _columnWidthAccumulat : 0))) column = column + 1;
+			if (Math.abs(columnWidthAccumulation[column] - offsetX) < Math.abs(offsetX - (columnWidthAccumulation[column - 1] ?? 0))) column = column + 1;
 		}
 		return column;
 	}
@@ -25863,14 +25760,14 @@ let SheetSkeleton = class SheetSkeleton extends Skeleton {
 		};
 	}
 	_updateConfigAndGetDocumentModel(documentData, horizontalAlign, paddingData, renderConfig) {
-		var _documentData$body, _paddingData$t, _paddingData$b, _paddingData$l, _paddingData$r;
+		var _documentData$body;
 		if (!renderConfig) return;
 		if (!((_documentData$body = documentData.body) === null || _documentData$body === void 0 ? void 0 : _documentData$body.dataStream)) return;
 		if (!documentData.documentStyle) documentData.documentStyle = {};
-		documentData.documentStyle.marginTop = (_paddingData$t = paddingData.t) !== null && _paddingData$t !== void 0 ? _paddingData$t : 0;
-		documentData.documentStyle.marginBottom = (_paddingData$b = paddingData.b) !== null && _paddingData$b !== void 0 ? _paddingData$b : 2;
-		documentData.documentStyle.marginLeft = (_paddingData$l = paddingData.l) !== null && _paddingData$l !== void 0 ? _paddingData$l : 2;
-		documentData.documentStyle.marginRight = (_paddingData$r = paddingData.r) !== null && _paddingData$r !== void 0 ? _paddingData$r : 2;
+		documentData.documentStyle.marginTop = paddingData.t ?? 0;
+		documentData.documentStyle.marginBottom = paddingData.b ?? 2;
+		documentData.documentStyle.marginLeft = paddingData.l ?? 2;
+		documentData.documentStyle.marginRight = paddingData.r ?? 2;
 		documentData.documentStyle.pageSize = {
 			width: Number.POSITIVE_INFINITY,
 			height: Number.POSITIVE_INFINITY
@@ -25945,10 +25842,9 @@ function getCellCoordByIndexSimple(row, column, rowHeightAccumulation, columnWid
 * @returns {ICellWithCoord} The cell position information of the specified row and column, including the position information of the cell and the merge information of the cell
 */
 function getCellWithCoordByIndexCore(row, column, rowHeightAccumulation, columnWidthAccumulation, mergeDataInfo, gapSizeGetter) {
-	var _gapSizeGetter$row, _gapSizeGetter$col;
 	row = Tools.clamp(row, 0, rowHeightAccumulation.length - 1);
 	column = Tools.clamp(column, 0, columnWidthAccumulation.length - 1);
-	let { startY, endY, startX, endX } = getCellCoordByIndexSimple(row, column, rowHeightAccumulation, columnWidthAccumulation, (_gapSizeGetter$row = gapSizeGetter === null || gapSizeGetter === void 0 ? void 0 : gapSizeGetter.row(row)) !== null && _gapSizeGetter$row !== void 0 ? _gapSizeGetter$row : 0, (_gapSizeGetter$col = gapSizeGetter === null || gapSizeGetter === void 0 ? void 0 : gapSizeGetter.col(column)) !== null && _gapSizeGetter$col !== void 0 ? _gapSizeGetter$col : 0);
+	let { startY, endY, startX, endX } = getCellCoordByIndexSimple(row, column, rowHeightAccumulation, columnWidthAccumulation, (gapSizeGetter === null || gapSizeGetter === void 0 ? void 0 : gapSizeGetter.row(row)) ?? 0, (gapSizeGetter === null || gapSizeGetter === void 0 ? void 0 : gapSizeGetter.col(column)) ?? 0);
 	if (!mergeDataInfo) return {
 		startY,
 		endY,
@@ -25983,9 +25879,8 @@ function getCellWithCoordByIndexCore(row, column, rowHeightAccumulation, columnW
 	const rowAccumulationCount = rowHeightAccumulation.length - 1;
 	const columnAccumulationCount = columnWidthAccumulation.length - 1;
 	if (isMerged && startRow !== -1 && startColumn !== -1) {
-		var _gapSizeGetter$row2, _gapSizeGetter$col2;
-		const mergeRowGapSize = (_gapSizeGetter$row2 = gapSizeGetter === null || gapSizeGetter === void 0 ? void 0 : gapSizeGetter.row(startRow)) !== null && _gapSizeGetter$row2 !== void 0 ? _gapSizeGetter$row2 : 0;
-		const mergeColGapSize = (_gapSizeGetter$col2 = gapSizeGetter === null || gapSizeGetter === void 0 ? void 0 : gapSizeGetter.col(startColumn)) !== null && _gapSizeGetter$col2 !== void 0 ? _gapSizeGetter$col2 : 0;
+		const mergeRowGapSize = (gapSizeGetter === null || gapSizeGetter === void 0 ? void 0 : gapSizeGetter.row(startRow)) ?? 0;
+		const mergeColGapSize = (gapSizeGetter === null || gapSizeGetter === void 0 ? void 0 : gapSizeGetter.col(startColumn)) ?? 0;
 		const mergeStartY = (rowHeightAccumulation[startRow - 1] || 0) + mergeRowGapSize;
 		const mergeEndY = rowHeightAccumulation[endRow] || rowHeightAccumulation[rowAccumulationCount];
 		const mergeStartX = (columnWidthAccumulation[startColumn - 1] || 0) + mergeColGapSize;
@@ -26440,13 +26335,12 @@ var Univer = class {
 		this._univerInstanceService.registerCtorForType(_univerjs_protocol.UniverType.UNIVER_SLIDE, SlideDataModel);
 		const univerInstanceService = injector.get(IUniverInstanceService);
 		univerInstanceService.__setCreateHandler((type, data, ctor, options) => {
-			var _univerInstanceServic;
 			const isFirstTime = !this._startedTypes.has(type);
 			if (isFirstTime) {
 				this._pluginService.startPluginsForType(type);
 				this._startedTypes.add(type);
 			}
-			const actualCtor = (_univerInstanceServic = univerInstanceService.__getCtorByType(type)) !== null && _univerInstanceServic !== void 0 ? _univerInstanceServic : ctor;
+			const actualCtor = univerInstanceService.__getCtorByType(type) ?? ctor;
 			if (!actualCtor) throw new Error(`[Univer]: No constructor registered for unit type ${type}.`);
 			const model = injector.createInstance(actualCtor, data);
 			univerInstanceService.__addUnit(model, options);
@@ -26549,12 +26443,19 @@ Object.defineProperty(exports, 'AuthzIoLocalService', {
   }
 });
 exports.AutoFillSeries = AutoFillSeries;
+exports.BASE_RECORD_ID_FIELD_ID = BASE_RECORD_ID_FIELD_ID;
+exports.BASE_RECORD_ID_FIELD_NAME = BASE_RECORD_ID_FIELD_NAME;
 exports.BORDER_KEYS = BORDER_KEYS;
 exports.BORDER_STYLE_KEYS = BORDER_STYLE_KEYS;
+exports.BaseConditionalColorOperator = BaseConditionalColorOperator;
+exports.BaseConditionalColorTarget = BaseConditionalColorTarget;
+exports.BaseConditionalDateMode = BaseConditionalDateMode;
 exports.BaseDataModel = BaseDataModel;
 exports.BaseFieldType = BaseFieldType;
 exports.BaseFilterConjunction = BaseFilterConjunction;
 exports.BaseFilterOperator = BaseFilterOperator;
+exports.BaseHierarchyInvalidReason = BaseHierarchyInvalidReason;
+exports.BaseRecordLinkRole = BaseRecordLinkRole;
 exports.BaseSortDirection = BaseSortDirection;
 exports.BaseViewType = BaseViewType;
 exports.BaselineOffset = BaselineOffset;
@@ -26642,6 +26543,7 @@ exports.DocumentBlockRangeType = DocumentBlockRangeType;
 exports.DocumentBlockType = DocumentBlockType;
 exports.DocumentDataModel = DocumentDataModel;
 exports.DocumentFlavor = DocumentFlavor;
+exports.DocxBreakType = DocxBreakType;
 exports.DrawingTypeEnum = DrawingTypeEnum;
 exports.EDITOR_ACTIVATED = EDITOR_ACTIVATED;
 exports.EXTENSION_NAMES = EXTENSION_NAMES;
@@ -26652,7 +26554,6 @@ exports.FOCUSING_BOARD = FOCUSING_BOARD;
 exports.FOCUSING_COMMENT_EDITOR = FOCUSING_COMMENT_EDITOR;
 exports.FOCUSING_COMMON_DRAWINGS = FOCUSING_COMMON_DRAWINGS;
 exports.FOCUSING_DOC = FOCUSING_DOC;
-exports.FOCUSING_EDITOR_BUT_HIDDEN = FOCUSING_EDITOR_BUT_HIDDEN;
 exports.FOCUSING_EDITOR_INPUT_FORMULA = FOCUSING_EDITOR_INPUT_FORMULA;
 exports.FOCUSING_EDITOR_STANDALONE = FOCUSING_EDITOR_STANDALONE;
 exports.FOCUSING_FX_BAR_EDITOR = FOCUSING_FX_BAR_EDITOR;
@@ -26885,6 +26786,7 @@ exports.Styles = Styles;
 exports.TEXT_DECORATION_KEYS = TEXT_DECORATION_KEYS;
 exports.TEXT_ROTATION_KEYS = TEXT_ROTATION_KEYS;
 exports.THEME_COLORS = THEME_COLORS;
+exports.TRADITIONAL_DOCUMENT_DEFAULT_MARGIN = TRADITIONAL_DOCUMENT_DEFAULT_MARGIN;
 exports.TabStopAlignment = TabStopAlignment;
 exports.TableAlignmentType = TableAlignmentType;
 exports.TableLayoutType = TableLayoutType;
@@ -26937,6 +26839,7 @@ exports.WrapTextType = WrapTextType;
 exports.addLinkToDocumentModel = addLinkToDocumentModel;
 exports.afterInitApply = afterInitApply;
 exports.afterTime = afterTime;
+exports.assertBaseTableRecordIdentity = assertBaseTableRecordIdentity;
 exports.awaitTime = awaitTime;
 exports.binSearchFirstGreaterThanTarget = binSearchFirstGreaterThanTarget;
 exports.binarySearchArray = binarySearchArray;
@@ -26969,6 +26872,7 @@ exports.convertObservableToBehaviorSubject = convertObservableToBehaviorSubject;
 exports.covertCellValue = covertCellValue;
 exports.covertCellValues = covertCellValues;
 exports.createAsyncInterceptorKey = createAsyncInterceptorKey;
+exports.createBaseRecordIdField = createBaseRecordIdField;
 exports.createDefaultBaseTableSnapshot = createDefaultBaseTableSnapshot;
 exports.createDefaultUser = createDefaultUser;
 exports.createDocumentModelWithStyle = createDocumentModelWithStyle;
@@ -27024,7 +26928,6 @@ exports.getBodySliceForSplitTextXAction = getBodySliceForSplitTextXAction;
 exports.getBodySliceForTextXAction = getBodySliceForTextXAction;
 exports.getBorderStyleType = getBorderStyleType;
 exports.getCellCoordByIndexSimple = getCellCoordByIndexSimple;
-exports.getCellInfoInMergeData = getCellInfoInMergeData;
 exports.getCellValueType = getCellValueType;
 exports.getCellWithCoordByIndexCore = getCellWithCoordByIndexCore;
 exports.getColorStyle = getColorStyle;
@@ -27084,6 +26987,7 @@ Object.defineProperty(exports, 'isAsyncHook', {
     return _wendellhu_redi.isAsyncHook;
   }
 });
+exports.isBaseRecordIdFieldName = isBaseRecordIdFieldName;
 exports.isBlackColor = isBlackColor;
 exports.isBooleanString = isBooleanString;
 exports.isCellCoverable = isCellCoverable;
@@ -27131,6 +27035,7 @@ exports.isSafeUrl = isSafeUrl;
 exports.isSameStyleTextRun = isSameStyleTextRun;
 exports.isTextFormat = isTextFormat;
 exports.isUnitRangesEqual = isUnitRangesEqual;
+exports.isValidBaseRecordId = isValidBaseRecordId;
 exports.isValidRange = isValidRange;
 Object.defineProperty(exports, 'isValueDependencyItem', {
   enumerable: true,
@@ -27141,8 +27046,6 @@ Object.defineProperty(exports, 'isValueDependencyItem', {
 exports.isWhiteColor = isWhiteColor;
 exports.makeArray = makeArray;
 exports.makeCellRangeToRangeData = makeCellRangeToRangeData;
-exports.makeCellToSelection = makeCellToSelection;
-exports.makeCustomRangeStream = makeCustomRangeStream;
 exports.mapObjectMatrix = mapObjectMatrix;
 Object.defineProperty(exports, 'merge', {
   enumerable: true,