@el-j/google-sheet-translations 3.0.0-beta.13 → 3.0.0-beta.14

package/dist/core/rowTransformer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rowTransformer.d.ts","sourceRoot":"","sources":["../../src/core/rowTransformer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,eAAe,CAAC;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,0BAA0B;IACzC,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACzE,mBAAmB,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,mBAAmB,CAAC;IAC3F,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,EAAE,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,0BAA0B,GAC/B,qBAAqB,CA8EvB"}
+{"version":3,"file":"rowTransformer.d.ts","sourceRoot":"","sources":["../../src/core/rowTransformer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,eAAe,CAAC;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,0BAA0B;IACzC,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACzE,mBAAmB,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,mBAAmB,CAAC;IAC3F,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,EAAE,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,0BAA0B,GAC/B,qBAAqB,CAqFvB"}

package/dist/esm/index.js

@@ -12,6 +12,7 @@ import fs$1 from "node:fs/promises";
 import { parse } from "csv-parse/sync";
 import crypto from "node:crypto";
 import nacl from "tweetnacl";
+import { WebSocket } from "ws";
 //#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -224,9 +225,9 @@ function transformRowsToSheetData(rows, sheetTitle, deps) {
 			if (!originalHeader) continue;
 			const nonEmptyLanguageCells = rows.map((row) => {
 				const keyField = Object.keys(row).find((k) => k.toLowerCase() === keyColumn);
-				if (!keyField || !row[keyField] || !row[originalHeader]) return {};
+				if (!keyField || !row[keyField]) return {};
 				const rowLocal = {};
-				rowLocal[row[keyField].toString().toLowerCase()] = row[originalHeader];
+				rowLocal[row[keyField].toString().toLowerCase()] = row[originalHeader] ?? "";
 				return rowLocal;
 			}).filter((cell) => Object.keys(cell).length > 0);
 			const prepareObj = {};
@@ -737,7 +738,7 @@ function findLocalChanges(localData, spreadsheetData) {
 		for (const sheet of Object.keys(localData[locale])) {
 			if (!localData[locale][sheet]) continue;
 			if (sheet === "i18n") continue;
-			for (const key of Object.keys(localData[locale][sheet])) if (!resolvedLocale || !spreadsheetData[resolvedLocale]?.[sheet] || !spreadsheetData[resolvedLocale][sheet][key]) {
+			for (const key of Object.keys(localData[locale][sheet])) if (!resolvedLocale || !spreadsheetData[resolvedLocale]?.[sheet] || spreadsheetData[resolvedLocale][sheet][key] === void 0) {
 				if (!changes[locale]) changes[locale] = {};
 				if (!changes[locale][sheet]) changes[locale][sheet] = {};
 				changes[locale][sheet][key] = localData[locale][sheet][key];
@@ -3428,6 +3429,49 @@ function encryptCryptPadPayload(plaintext, cryptKey, signKey) {
 }
 //#endregion
 //#region src/providers/cryptpad/netflux.ts
+function getWebSocketImpl() {
+	if (typeof window !== "undefined" && window.WebSocket) return window.WebSocket;
+	if (typeof process !== "undefined" && process.env.VITEST && typeof globalThis !== "undefined" && globalThis.WebSocket) return globalThis.WebSocket;
+	return WebSocket;
+}
+function formatUnknownError(err) {
+	const errObj = err;
+	const details = [];
+	if (errObj?.message) details.push(`message=${errObj.message}`);
+	if (errObj?.error) {
+		if (typeof errObj.error === "string") details.push(`inner=${errObj.error}`);
+		else {
+			const inner = errObj.error;
+			if (inner.name) details.push(`innerName=${inner.name}`);
+			if (inner.message) details.push(`innerMessage=${inner.message}`);
+			if (inner.cause !== void 0) details.push(`innerCause=${String(inner.cause)}`);
+			if (inner.stack) details.push(`innerStack=${inner.stack}`);
+		}
+	}
+	if (err && typeof err === "object") {
+		const e = err;
+		if (e.type) details.push(`eventType=${e.type}`);
+		const keys = Object.keys(e);
+		if (keys.length > 0) details.push(`eventKeys=${keys.join(",")}`);
+	}
+	if (details.length > 0) return details.join(" | ");
+	return String(err);
+}
+function shouldRetryBroadcastError(err) {
+	const message = formatUnknownError(err).toLowerCase();
+	return message.includes("unexpected server response: 429") || message.includes("server response: 429") || message.includes("too many requests");
+}
+function wait$1(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function withAttemptContext(err, attempt, maxAttempts) {
+	if (err instanceof Error) {
+		if (maxAttempts <= 1) return err;
+		if (err.message.includes("Timeout") || err.message.includes("aborted") || err.message.includes("Operation aborted")) return err;
+	}
+	const detail = formatUnknownError(err);
+	return /* @__PURE__ */ new Error(`Attempt ${attempt}/${maxAttempts} failed: ${detail}`);
+}
 /**
 * Discovers the real WebSocket URL for a CryptPad instance by querying its `/api/config` endpoint.
 */
@@ -3437,7 +3481,17 @@ async function resolveCryptPadWebsocketUrl(origin, signal) {
 		const res = await fetch(configUrl, { signal });
 		if (res.ok) {
 			const match = (await res.text()).match(/"websocketPath":\s*"([^"]+)"/);
-			if (match && match[1]) return match[1];
+			if (match && match[1]) {
+				const candidate = match[1].trim();
+				if (!candidate) throw new Error("Empty websocketPath");
+				if (/^ws(s)?:\/\//i.test(candidate)) return candidate;
+				if (candidate.startsWith("/") || !/^[a-z]+:\/\//i.test(candidate)) try {
+					const urlObj = new URL(origin);
+					const baseWsScheme = urlObj.protocol === "https:" ? "wss:" : "ws:";
+					return candidate.startsWith("/") ? `${baseWsScheme}//${urlObj.host}${candidate}` : `${baseWsScheme}//${urlObj.host}/${candidate.replace(/^\//, "")}`;
+				} catch {}
+				return candidate;
+			}
 		}
 	} catch {}
 	const urlObj = new URL(origin);
@@ -3450,9 +3504,9 @@ async function resolveCryptPadWebsocketUrl(origin, signal) {
 */
 function fetchChannelHistory(wsUrl, channelHex, cryptKey, options = {}) {
 	const { timeoutMs = 8e3, quietPeriodMs = 1200, signal } = options;
-	return new Promise((resolve, reject) => {
+	const fetchOnce = () => new Promise((resolve, reject) => {
 		if (signal?.aborted) return reject(/* @__PURE__ */ new Error("Operation aborted"));
-		const ws = new WebSocket(wsUrl);
+		const ws = new (getWebSocketImpl())(wsUrl);
 		let seq = 1;
 		const decryptedMessages = [];
 		let quietTimer = null;
@@ -3545,11 +3599,24 @@ function fetchChannelHistory(wsUrl, channelHex, cryptKey, options = {}) {
 		};
 		ws.onerror = (err) => {
 			cleanup();
-			const errObj = err;
-			const detail = errObj?.message || errObj?.error?.message || (errObj?.error ? String(errObj.error) : String(err));
-			reject(/* @__PURE__ */ new Error(`CryptPad WebSocket error: ${detail}`));
+			reject(/* @__PURE__ */ new Error(`CryptPad WebSocket error: ${formatUnknownError(err)}`));
 		};
 	});
+	const maxAttempts = Math.max(1, options.maxAttempts ?? 3);
+	const retryDelayMs = Math.max(100, options.retryDelayMs ?? 1500);
+	return (async () => {
+		let lastError;
+		for (let attempt = 1; attempt <= maxAttempts; attempt++) try {
+			return await fetchOnce();
+		} catch (error) {
+			lastError = withAttemptContext(error, attempt, maxAttempts);
+			if (signal?.aborted) throw new Error("Operation aborted");
+			if (attempt >= maxAttempts || !shouldRetryBroadcastError(error)) throw lastError;
+			const jitter = Math.floor(Math.random() * 250);
+			await wait$1(retryDelayMs * attempt + jitter);
+		}
+		throw lastError ?? /* @__PURE__ */ new Error("CryptPad WebSocket history fetch failed.");
+	})();
 }
 /**
 * Connects to the CryptPad Netflux WebSocket server, joins a channel,
@@ -3558,9 +3625,9 @@ function fetchChannelHistory(wsUrl, channelHex, cryptKey, options = {}) {
 */
 function broadcastChannelMessage(wsUrl, channelHex, cryptKey, message, options = {}) {
 	const { timeoutMs = 8e3, signal } = options;
-	return new Promise((resolve, reject) => {
+	const broadcastOnce = () => new Promise((resolve, reject) => {
 		if (signal?.aborted) return reject(/* @__PURE__ */ new Error("Operation aborted"));
-		const ws = new WebSocket(wsUrl);
+		const ws = new (getWebSocketImpl())(wsUrl);
 		let seq = 1;
 		let timeout = null;
 		let sent = false;
@@ -3596,19 +3663,28 @@ function broadcastChannelMessage(wsUrl, channelHex, cryptKey, message, options =
 			signal.addEventListener("abort", abortListener);
 		}
 		ws.onopen = () => {
-			ws.send(JSON.stringify([
-				seq++,
-				"JOIN",
-				channelHex
-			]));
+			try {
+				ws.send(JSON.stringify([
+					seq++,
+					"JOIN",
+					channelHex
+				]));
+			} catch (error) {
+				rejectOnce(/* @__PURE__ */ new Error(`CryptPad WebSocket JOIN send failed: ${formatUnknownError(error)}`));
+			}
 		};
 		ws.onmessage = (event) => {
+			const raw = typeof event.data === "string" ? event.data : event.data.toString();
+			let msg;
 			try {
-				const raw = typeof event.data === "string" ? event.data : event.data.toString();
-				const msg = JSON.parse(raw);
-				if (!Array.isArray(msg)) return;
-				const [, peerId, cmd] = msg;
-				if (cmd === "JOIN" && typeof peerId === "string" && !sent) {
+				msg = JSON.parse(raw);
+			} catch {
+				return;
+			}
+			if (!Array.isArray(msg)) return;
+			const [, peerId, cmd] = msg;
+			if (cmd === "JOIN" && typeof peerId === "string" && !sent) {
+				try {
 					sent = true;
 					const encrypted = encryptCryptPadPayload(message, cryptKey, options.signKey);
 					ws.send(JSON.stringify([
@@ -3617,18 +3693,39 @@ function broadcastChannelMessage(wsUrl, channelHex, cryptKey, message, options =
 						channelHex,
 						encrypted
 					]));
-					setTimeout(() => {
-						resolveOnce();
-					}, 350);
+				} catch (error) {
+					rejectOnce(/* @__PURE__ */ new Error(`CryptPad WebSocket MSG send failed: ${formatUnknownError(error)}`));
+					return;
 				}
-			} catch {}
+				setTimeout(() => {
+					resolveOnce();
+				}, 350);
+			}
+		};
+		ws.onclose = (event) => {
+			if (settled) return;
+			if (!sent) rejectOnce(/* @__PURE__ */ new Error(`CryptPad WebSocket closed before broadcast (code=${event.code}, reason=${event.reason || "none"}, clean=${event.wasClean}).`));
 		};
 		ws.onerror = (err) => {
-			const errObj = err;
-			const detail = errObj?.message || errObj?.error?.message || (errObj?.error ? String(errObj.error) : String(err));
-			rejectOnce(/* @__PURE__ */ new Error(`CryptPad WebSocket broadcast error: ${detail}`));
+			rejectOnce(/* @__PURE__ */ new Error(`CryptPad WebSocket broadcast error: ${formatUnknownError(err)}`));
 		};
 	});
+	const maxAttempts = Math.max(1, options.maxAttempts ?? 3);
+	const retryDelayMs = Math.max(100, options.retryDelayMs ?? 1500);
+	return (async () => {
+		let lastError;
+		for (let attempt = 1; attempt <= maxAttempts; attempt++) try {
+			await broadcastOnce();
+			return;
+		} catch (error) {
+			lastError = withAttemptContext(error, attempt, maxAttempts);
+			if (signal?.aborted) throw new Error("Operation aborted");
+			if (attempt >= maxAttempts || !shouldRetryBroadcastError(error)) throw lastError;
+			const jitter = Math.floor(Math.random() * 250);
+			await wait$1(retryDelayMs * attempt + jitter);
+		}
+		throw lastError ?? /* @__PURE__ */ new Error("CryptPad WebSocket broadcast failed.");
+	})();
 }
 /*!
 *    Copyright 2015-2017 Thomas Rosenau
@@ -7352,6 +7449,8 @@ function extractOnlyOfficeChannelId(metadataMessages) {
 function parseOnlyOfficeChanges(rtMessages) {
 	const cells = {};
 	const sheetNames = /* @__PURE__ */ new Map();
+	const preMapped = extractOnlyOfficeSheetIdMap(rtMessages);
+	for (const [id, name] of Object.entries(preMapped.idToName)) sheetNames.set(id, name);
 	let defaultSheetId = "6";
 	for (const raw of rtMessages) try {
 		const data = JSON.parse(raw);
@@ -7375,7 +7474,14 @@ function parseOnlyOfficeChanges(rtMessages) {
 					const len = buf.readUInt32LE(j + 1);
 					if (len > 0 && j + 5 + len <= buf.length) strings.push(buf.subarray(j + 5, j + 5 + len).toString("utf16le"));
 				}
-				if (strings.length >= 2) sheetNames.set(defaultSheetId, strings[1]);
+				if (strings.length >= 2) {
+					let sid = defaultSheetId;
+					if (buf[7] === 1) {
+						const sLen = buf.readUInt32LE(8);
+						if (sLen > 0 && 12 + sLen <= buf.length) sid = buf.subarray(12, 12 + sLen).toString("utf16le");
+					}
+					sheetNames.set(sid, strings[1]);
+				}
 			}
 			if (magic === 19595520) {
 				const strings = [];
@@ -7389,6 +7495,25 @@ function parseOnlyOfficeChanges(rtMessages) {
 					sheetNames.set(id, name);
 				}
 			}
+			if (magic === 19595776) {
+				const strings = [];
+				for (let j = 0; j < buf.length - 4; j++) if (buf[j] === 8) {
+					const len = buf.readUInt32LE(j + 1);
+					if (len > 0 && j + 5 + len <= buf.length) strings.push(buf.subarray(j + 5, j + 5 + len).toString("utf16le"));
+				}
+				if (strings.length >= 1) {
+					const deletedId = strings[0];
+					const deletedName = sheetNames.get(deletedId);
+					sheetNames.delete(deletedId);
+					if (deletedName) {
+						const prefix = `${deletedName}!`;
+						for (const key of Object.keys(cells)) if (key.startsWith(prefix)) delete cells[key];
+					}
+					if (deletedId === "6") {
+						for (const key of Object.keys(cells)) if (!key.includes("!") || key.startsWith("Sheet1!")) delete cells[key];
+					}
+				}
+			}
 			if (magic === 19468289) {
 				const sheetIdLen = buf.readUInt32LE(8);
 				if (sheetIdLen > 0 && sheetIdLen < 200 && 12 + sheetIdLen + 17 <= buf.length) {
@@ -7402,7 +7527,7 @@ function parseOnlyOfficeChanges(rtMessages) {
 							if (strLen >= 0 && strLen < 1e5 && k + 5 + strLen <= buf.length) {
 								const val = buf.subarray(k + 5, k + 5 + strLen).toString("utf16le");
 								const colLetter = colIndexToLetter(c1);
-								const tabName = sheetNames.get(sheetIdStr) || (sheetIdStr === "6" ? sheetNames.get("6") || "" : "");
+								const tabName = sheetNames.get(sheetIdStr) && sheetNames.get(sheetIdStr) !== "Sheet1" ? sheetNames.get(sheetIdStr) : "";
 								const cellRef = `${tabName ? `${tabName}!` : ""}${colLetter}${r1 + 1}`;
 								cells[cellRef] = val;
 							}
@@ -7469,9 +7594,15 @@ function extractOnlyOfficeSheetIdMap(rtMessages) {
 					if (len > 0 && j + 5 + len <= buf.length) strings.push(buf.subarray(j + 5, j + 5 + len).toString("utf16le"));
 				}
 				if (strings.length >= 2) {
-					delete nameToId[idToName[defaultSheetId]];
-					idToName[defaultSheetId] = strings[1];
-					nameToId[strings[1]] = defaultSheetId;
+					let sid = defaultSheetId;
+					if (buf[7] === 1) {
+						const sLen = buf.readUInt32LE(8);
+						if (sLen > 0 && 12 + sLen <= buf.length) sid = buf.subarray(12, 12 + sLen).toString("utf16le");
+					}
+					const oldName = idToName[sid] || strings[0];
+					delete nameToId[oldName];
+					idToName[sid] = strings[1];
+					nameToId[strings[1]] = sid;
 				}
 			}
 			if (magic === 19595520) {
@@ -7487,6 +7618,20 @@ function extractOnlyOfficeSheetIdMap(rtMessages) {
 					nameToId[name] = id;
 				}
 			}
+			if (magic === 19595776) {
+				const strings = [];
+				for (let j = 0; j < buf.length - 4; j++) if (buf[j] === 8) {
+					const len = buf.readUInt32LE(j + 1);
+					if (len > 0 && j + 5 + len <= buf.length) strings.push(buf.subarray(j + 5, j + 5 + len).toString("utf16le"));
+				}
+				if (strings.length >= 1) {
+					const id = strings[0];
+					const name = idToName[id];
+					delete idToName[id];
+					if (name) delete nameToId[name];
+					if (id === defaultSheetId) delete nameToId["Sheet1"];
+				}
+			}
 		}
 	} catch {}
 	return {
@@ -7765,8 +7910,7 @@ function buildOnlyOfficeChangePayload(updates, defaultSheetId) {
 		time: now
 	});
 	for (const u of updates) {
-		const colStr = typeof u.col === "number" ? colIndexToLetter(u.col) : u.col.toUpperCase();
-		const ref = `${u.sheet && u.sheet.trim().length > 0 ? `${u.sheet.trim()}!` : ""}${colStr}${u.row}`;
+		const ref = `${typeof u.col === "number" ? colIndexToLetter(u.col) : u.col.toUpperCase()}${u.row}`;
 		const sid = u.sheetId ?? defaultSheetId ?? 6;
 		const rec = u.formula !== void 0 ? encodeOnlyOfficeFormulaCellRecord(ref, u.formula, sid) : encodeOnlyOfficeCellRecord(ref, u.value ?? "", sid);
 		changeItems.push({
@@ -7879,6 +8023,142 @@ function buildOnlyOfficeSheetAddPayload(name, sheetId, insertBeforeIndex) {
 		isExcel: true
 	});
 }
+/**
+* Encodes a single "delete worksheet tab" record into the native OnlyOffice binary format:
+* AscCH.historyitem_Workbook_SheetDelete (magic 0x012b0200), UndoRedoDataTypes.SheetDelete (26, 0x1a).
+*
+* @param sheetId - Sheet identifier to delete.
+*/
+function encodeOnlyOfficeSheetDeleteRecord(sheetId) {
+	const sheetIdStr = String(sheetId);
+	const sheetIdBuf = Buffer.from(sheetIdStr, "utf16le");
+	const idLen = sheetIdBuf.length;
+	const propertyBlock = Buffer.concat([
+		Buffer.from([
+			0,
+			2,
+			1
+		]),
+		Buffer.from([1, 8]),
+		Buffer.alloc(4),
+		sheetIdBuf,
+		Buffer.from([
+			2,
+			9,
+			255,
+			0,
+			0
+		])
+	]);
+	propertyBlock.writeUInt32LE(idLen, 5);
+	const remainingLen = Buffer.alloc(4);
+	remainingLen.writeUInt32LE(propertyBlock.length + 2, 0);
+	const magic = Buffer.alloc(4);
+	magic.writeUInt32BE(19595776, 0);
+	const body = Buffer.concat([
+		magic,
+		Buffer.from([0, 26]),
+		remainingLen,
+		propertyBlock
+	]);
+	const header = Buffer.alloc(4);
+	header.writeUInt32LE(body.length + 2, 0);
+	return Buffer.concat([header, body]);
+}
+/**
+* Formats a single "delete worksheet tab" operation into an OnlyOffice `saveChanges`
+* message, structured the same way as {@link buildOnlyOfficeChangePayload}.
+*/
+function buildOnlyOfficeSheetDeletePayload(sheetId) {
+	const txOpen = Buffer.from("0a0000000129000000ff00000000", "hex");
+	const now = Date.now();
+	const rec = encodeOnlyOfficeSheetDeleteRecord(sheetId);
+	return JSON.stringify({
+		type: "saveChanges",
+		changes: [{
+			change: JSON.stringify(`${txOpen.length};${txOpen.toString("base64")}`),
+			time: now
+		}, {
+			change: JSON.stringify(`${rec.length};${rec.toString("base64")}`),
+			time: now
+		}],
+		startSaveChanges: true,
+		endSaveChanges: true,
+		isExcel: true
+	});
+}
+/**
+* Encodes a single "rename worksheet tab" record into the native OnlyOffice binary format:
+* AscCH.historyitem_Worksheet_Rename (magic 0x012a1201), UndoRedoDataTypes.FromTo (5),
+* matching `UndoRedoData_FromTo` (`from` = 0, `to` = 1, `copyRange` = 2, `sheetIdTo` = 3).
+*
+* @param sheetId - Internal sheet identifier to rename (e.g. '6').
+* @param oldName - Current name of the sheet tab (e.g. 'Sheet1').
+* @param newName - Desired new name for the tab (e.g. 'i18n').
+*/
+function encodeOnlyOfficeSheetRenameRecord(sheetId, oldName, newName) {
+	const sheetIdBuf = Buffer.from(String(sheetId), "utf16le");
+	const sheetIdLen = Buffer.alloc(4);
+	sheetIdLen.writeUInt32LE(sheetIdBuf.length, 0);
+	const oldNameBuf = Buffer.from(oldName, "utf16le");
+	const oldNameLen = Buffer.alloc(4);
+	oldNameLen.writeUInt32LE(oldNameBuf.length, 0);
+	const newNameBuf = Buffer.from(newName, "utf16le");
+	const newNameLen = Buffer.alloc(4);
+	newNameLen.writeUInt32LE(newNameBuf.length, 0);
+	const propertyBlock = Buffer.concat([
+		Buffer.from([0, 8]),
+		oldNameLen,
+		oldNameBuf,
+		Buffer.from([1, 8]),
+		newNameLen,
+		newNameBuf,
+		Buffer.from([2, 0]),
+		Buffer.from([3, 1])
+	]);
+	const propertyLen = Buffer.alloc(4);
+	propertyLen.writeUInt32LE(propertyBlock.length, 0);
+	const magic = Buffer.from([
+		1,
+		42,
+		18,
+		1
+	]);
+	const body = Buffer.concat([
+		magic,
+		sheetIdLen,
+		sheetIdBuf,
+		Buffer.from([0]),
+		Buffer.from([5]),
+		propertyLen,
+		propertyBlock
+	]);
+	const header = Buffer.alloc(4);
+	header.writeUInt32LE(body.length, 0);
+	return Buffer.concat([header, body]);
+}
+/**
+* Formats a single "rename worksheet tab" operation into an OnlyOffice `saveChanges`
+* message, structured the same way as {@link buildOnlyOfficeChangePayload}.
+*/
+function buildOnlyOfficeSheetRenamePayload(sheetId, oldName, newName) {
+	const txOpen = Buffer.from("0a0000000129000000ff00000000", "hex");
+	const now = Date.now();
+	const rec = encodeOnlyOfficeSheetRenameRecord(sheetId, oldName, newName);
+	return JSON.stringify({
+		type: "saveChanges",
+		changes: [{
+			change: JSON.stringify(`${txOpen.length};${txOpen.toString("base64")}`),
+			time: now
+		}, {
+			change: JSON.stringify(`${rec.length};${rec.toString("base64")}`),
+			time: now
+		}],
+		startSaveChanges: true,
+		endSaveChanges: true,
+		isExcel: true
+	});
+}
 //#endregion
 //#region src/providers/cryptpad/client.ts
 /**
@@ -7998,7 +8278,7 @@ var CryptPadClient = class {
 			await new Promise((r) => setTimeout(r, 800));
 		}
 		const sheetId = generateOnlyOfficeSheetId();
-		const insertAt = insertBeforeIndex ?? data.sheetNames.length;
+		const insertAt = Math.min(insertBeforeIndex ?? data.sheetNames.length, data.sheetNames.length);
 		await this.broadcastSheetAdd(name, sheetId, insertAt, rtChannel, signal);
 		return sheetId;
 	}
@@ -8020,6 +8300,61 @@ var CryptPadClient = class {
 		});
 	}
 	/**
+	* Deletes a worksheet tab by name from the CryptPad workbook.
+	*
+	* @param sheetName - Name of the sheet tab to delete (e.g. 'Sheet1').
+	* @param signal - Optional AbortSignal.
+	*/
+	async deleteSheet(sheetName, signal) {
+		const data = await this.fetchSheetData(signal);
+		const targetSheetId = data.sheetIds?.[sheetName];
+		if (!targetSheetId) return;
+		if (data.sheetNames.length <= 1) throw new Error(`Cannot delete sheet "${sheetName}": workbook must contain at least one worksheet.`);
+		const rtChannel = data.metadata.rtChannelId;
+		if (!rtChannel) throw new Error("Cannot delete sheet: pad has no active real-time collaboration channel.");
+		await this.broadcastSheetDelete(targetSheetId, rtChannel, signal);
+	}
+	/**
+	* Broadcasts a `Workbook_SheetDelete` record to an already-known RT channel.
+	*/
+	async broadcastSheetDelete(sheetId, rtChannel, signal) {
+		const wsUrl = await this.getWebsocketUrl(signal);
+		const { cryptKey, signKey } = this.getKeys();
+		await broadcastChannelMessage(wsUrl, rtChannel, cryptKey, buildOnlyOfficeSheetDeletePayload(sheetId), {
+			timeoutMs: this.timeoutMs,
+			signal,
+			signKey
+		});
+	}
+	/**
+	* Broadcasts a `Worksheet_Rename` record to an already-known RT channel.
+	*/
+	async broadcastSheetRename(sheetId, oldName, newName, rtChannel, signal) {
+		const wsUrl = await this.getWebsocketUrl(signal);
+		const { cryptKey, signKey } = this.getKeys();
+		await broadcastChannelMessage(wsUrl, rtChannel, cryptKey, buildOnlyOfficeSheetRenamePayload(sheetId, oldName, newName), {
+			timeoutMs: this.timeoutMs,
+			signal,
+			signKey
+		});
+	}
+	/**
+	* Renames an existing worksheet tab by name in the CryptPad workbook.
+	*
+	* @param oldSheetName - Current name of the sheet tab (e.g. 'Sheet1').
+	* @param newSheetName - Desired new name for the tab (e.g. 'i18n').
+	* @param signal - Optional AbortSignal.
+	*/
+	async renameSheet(oldSheetName, newSheetName, signal) {
+		if (oldSheetName === newSheetName) return;
+		const data = await this.fetchSheetData(signal);
+		const targetSheetId = data.sheetIds?.[oldSheetName];
+		if (!targetSheetId) throw new Error(`Cannot rename sheet "${oldSheetName}": sheet not found in the workbook.`);
+		const rtChannel = data.metadata.rtChannelId;
+		if (!rtChannel) throw new Error("Cannot rename sheet: pad has no active real-time collaboration channel.");
+		await this.broadcastSheetRename(targetSheetId, oldSheetName, newSheetName, rtChannel, signal);
+	}
+	/**
 	* Writes a literal-text header row (row 1) into a sheet — the canonical, non-linked
 	* form used for the `i18n` sheet itself (there is nothing to link an `i18n` header to)
 	* and as the safe fallback whenever a new sheet's columns can't be aligned 1:1 with an
@@ -8138,7 +8473,12 @@ var CryptPadClient = class {
 			sheetIdMap = extractOnlyOfficeSheetIdMap(rtMessages);
 		}
 		const multiSheets = convertCellsToMultiSheetRows(cells);
-		const sheetNames = Object.keys(multiSheets);
+		const discoveredSheetNames = /* @__PURE__ */ new Set();
+		for (const name of Object.keys(sheetIdMap.nameToId)) if (name && name.trim().length > 0) discoveredSheetNames.add(name);
+		if (discoveredSheetNames.size === 0) {
+			for (const name of Object.keys(multiSheets)) if (name && name.trim().length > 0) discoveredSheetNames.add(name);
+		}
+		const sheetNames = Array.from(discoveredSheetNames);
 		const defaultSheet = multiSheets["Sheet1"] ? "Sheet1" : sheetNames[0];
 		const defaultRows = defaultSheet && multiSheets[defaultSheet] ? multiSheets[defaultSheet] : convertCellsToSheetRows(cells);
 		const groupedCells = groupCellsBySheet(cells);
@@ -8215,16 +8555,26 @@ var CryptPadClient = class {
 	async writeSheetRows(sheetName, rows, options = {}) {
 		if (rows.length === 0) return 0;
 		const data = await this.fetchSheetData(options.signal);
+		let rtChannel = data.metadata.rtChannelId;
 		let existingRows = data.sheets[sheetName]?.rows ?? [];
 		let targetSheetId = data.sheetIds?.[sheetName];
 		let justCreated = false;
 		if (!targetSheetId) {
-			this.onProgress?.(`Sheet "${sheetName}" not found — creating it.`);
-			targetSheetId = await this.createSheet(sheetName, data.sheetNames.length, options.signal);
-			existingRows = [];
-			justCreated = true;
+			if (data.sheetNames.includes("Sheet1") && (data.sheets["Sheet1"]?.rows.length ?? 0) === 0 && Object.keys(data.sheets["Sheet1"]?.cells ?? {}).length === 0 && sheetName !== "Sheet1" && (data.sheetNames.length === 1 || sheetName === "i18n")) {
+				const sheet1Id = data.sheetIds?.["Sheet1"] ?? "6";
+				this.onProgress?.(`Renaming fresh empty "Sheet1" tab to "${sheetName}".`);
+				if (rtChannel) await this.broadcastSheetRename(sheet1Id, "Sheet1", sheetName, rtChannel, options.signal);
+				else await this.renameSheet("Sheet1", sheetName, options.signal);
+				targetSheetId = sheet1Id;
+				existingRows = [];
+				justCreated = true;
+			} else {
+				this.onProgress?.(`Sheet "${sheetName}" not found — creating it.`);
+				targetSheetId = await this.createSheet(sheetName, data.sheetNames.length, options.signal);
+				existingRows = [];
+				justCreated = true;
+			}
 		}
-		let rtChannel = data.metadata.rtChannelId;
 		let keyColName = "key";
 		const firstExisting = existingRows[0];
 		const firstIncoming = rows[0];
@@ -8338,7 +8688,7 @@ function createCryptPadSheetInputProvider(options) {
 					}).fetchSheetData(request.signal);
 					const sourceTables = [];
 					if (Array.isArray(sheetData.sheetNames) && sheetData.sheetNames.length > 1) {
-						for (const tabName of sheetData.sheetNames) if (requested.size === 0 || requested.has(tabName) || requested.has(source.tableName)) sourceTables.push({
+						for (const tabName of sheetData.sheetNames) if (requested.size === 0 || requested.has(tabName)) sourceTables.push({
 							tableId: `${source.tableId ?? url}#${tabName}`,
 							tableName: tabName,
 							rows: sheetData.sheets[tabName]?.rows ?? [],
@@ -8351,7 +8701,7 @@ function createCryptPadSheetInputProvider(options) {
 							}
 						});
 					}
-					if (sourceTables.length === 0) sourceTables.push({
+					if (sourceTables.length === 0 && (!Array.isArray(sheetData.sheetNames) || sheetData.sheetNames.length <= 1)) sourceTables.push({
 						tableId: source.tableId ?? url,
 						tableName: source.tableName,
 						rows: sheetData.rows,
@@ -8380,12 +8730,12 @@ const CRYPTPAD_SHEET_OUTPUT_CAPABILITIES = createCapabilitySet({ writeTables: tr
 * Converts nested TranslationData `[locale][sheet][key] = value` into
 * tabular rows `Record<sheetName, SheetRow[]>`.
 */
-function convertTranslationsToSheetRows(translations, localeMapping = {}, keyColumnName = "key") {
+function convertTranslationsToSheetRows(translations, localeMapping = {}, keyColumnName = "key", includeI18nSheet = false) {
 	const sheetRowsMap = {};
 	for (const [locale, sheets] of Object.entries(translations)) {
 		const colHeader = localeMapping[locale] ?? locale;
 		for (const [sheetName, keys] of Object.entries(sheets)) {
-			if (sheetName === "i18n") continue;
+			if (!includeI18nSheet && sheetName === "i18n") continue;
 			if (!sheetRowsMap[sheetName]) sheetRowsMap[sheetName] = /* @__PURE__ */ new Map();
 			for (const [key, value] of Object.entries(keys)) {
 				if (!sheetRowsMap[sheetName].has(key)) sheetRowsMap[sheetName].set(key, { [keyColumnName]: key });
@@ -8418,17 +8768,22 @@ function createCryptPadSheetOutputProvider(options = {}) {
 				timeoutMs: options.timeoutMs
 			});
 			const effectiveMapping = options.localeMapping ?? payload.localeMapping ?? {};
-			const sheetRowsMap = convertTranslationsToSheetRows(payload.translations, effectiveMapping, options.keyColumnName ?? "key");
+			const sheetRowsMap = convertTranslationsToSheetRows(payload.translations, effectiveMapping, options.keyColumnName ?? "key", options.includeI18nSheet ?? false);
 			const updatedSheets = [];
 			let totalUpdatedCells = 0;
-			for (const [sheetName, rows] of Object.entries(sheetRowsMap)) {
+			const sheetEntries = Object.entries(sheetRowsMap).sort(([a], [b]) => {
+				if (a === "i18n") return -1;
+				if (b === "i18n") return 1;
+				return 0;
+			});
+			for (const [sheetName, rows] of sheetEntries) {
 				const count = await client.writeSheetRows(sheetName, rows, {
 					override: options.override ?? false,
 					linkHeadersToI18nSheet: options.linkHeadersToI18nSheet ?? false
 				});
 				updatedSheets.push(sheetName);
 				totalUpdatedCells += count;
-				await new Promise((r) => setTimeout(r, 400));
+				await new Promise((r) => setTimeout(r, 1200));
 			}
 			return {
 				wroteFiles: [url],
@@ -9738,4 +10093,4 @@ function migrateProjectToV3(options = {}) {
 //#region src/index.ts
 var src_default = getSpreadSheetData;
 //#endregion
-export { CRYPTPAD_ASSET_SYNC_CAPABILITIES, CRYPTPAD_CSV_INPUT_CAPABILITIES, CRYPTPAD_SHEET_INPUT_CAPABILITIES, CRYPTPAD_WORKSPACE_OUTPUT_CAPABILITIES, CRYPTPAD_WORKSPACE_SYNC_CAPABILITIES, CryptPadClient, DEFAULT_IMAGE_EXTENSIONS, DEFAULT_WAIT_SECONDS, EMPTY_PROVIDER_CAPABILITIES, GOOGLE_SHEETS_PROVIDER_CAPABILITIES, GcpApiError, OPERATION_CAPABILITY_REQUIREMENTS, PROVIDER_CAPABILITIES, assertOperationCapabilities, assertRequiredCapabilities, assertValidProviderRuntimeConfig, broadcastChannelMessage, buildGoogleAuth, buildManifest, buildSyncPlan, columnIndexToLetter, convertCellsToSheetRows, convertFromDataJsonFormat, convertToDataJsonFormat, createAuthClient, createCapabilitySet, createCryptPadAssetSyncProvider, createCryptPadCsvInputProvider, createCryptPadSheetInputProvider, createCryptPadWorkspaceOutputProvider, createCryptPadWorkspaceSyncProvider, createDefaultProviderCatalog, createGoogleSheetsInputProvider, createGoogleSheetsOutputProvider, createGoogleSheetsSyncProvider, createInMemoryProviderCatalogProvider, createLocaleMapping, createProvidersFromRuntimeConfig, createSpreadsheet, decryptCryptPadPayload, src_default as default, deriveCryptPadKeys, encodeOnlyOfficeCellRecord, encryptCryptPadPayload, entriesToSeedKeys, entriesToTranslationData, exportDoc, extractOnlyOfficeChannelId, extractOnlyOfficeMetadata, extractOnlyOfficeSheetIdMap, fetchChannelHistory, filterValidLocales, findLocalChanges, getGoogleTranslateCode, getLanguagePrefix, getLocaleDisplayName, getMultipleSpreadSheetsData, getNormalizedLocaleForHeader, getOriginalHeaderForLocale, getSpreadSheetData, getTranslationSummary, grantDrivePermissions, handleBidirectionalSync, hasRequiredCapabilities, inferLocaleFromDocName, ingestDoc, isValidLocale, manageDriveTranslations, mapLegacyGoogleOptionsToProviderConfig, mergeMultipleTranslationData, mergeSheets, migrateProjectToV3, missingCapabilities, moveSpreadsheetToFolder, normalizeExtension, normalizeLocaleCode, normalizePrivateKey, parseDocContent, parseOnlyOfficeChanges, parsePadUrl, processRawRows, readManifest, readPublicSheet, requiresGoogleAuthForRuntimeConfig, resolveCryptPadWebsocketUrl, resolveLocaleWithFallback, resolveSyncPlan, runProviderPipeline, sanitizeFolderName, scanDriveFolderForDocs, scanDriveFolderForSpreadsheets, setupWIF, slugifyKey, syncDriveImages, updateSpreadsheetWithLocalChanges, validateCredentials, validateEnv, validateImageDirectory, validateProviderRuntimeConfig, wait, walkDirectory, withRetry, writeLanguageDataFile, writeLocalesFile, writeManifest, writeTranslationFiles };
+export { CRYPTPAD_ASSET_SYNC_CAPABILITIES, CRYPTPAD_CSV_INPUT_CAPABILITIES, CRYPTPAD_SHEET_INPUT_CAPABILITIES, CRYPTPAD_WORKSPACE_OUTPUT_CAPABILITIES, CRYPTPAD_WORKSPACE_SYNC_CAPABILITIES, CryptPadClient, DEFAULT_IMAGE_EXTENSIONS, DEFAULT_WAIT_SECONDS, EMPTY_PROVIDER_CAPABILITIES, GOOGLE_SHEETS_PROVIDER_CAPABILITIES, GcpApiError, OPERATION_CAPABILITY_REQUIREMENTS, PROVIDER_CAPABILITIES, assertOperationCapabilities, assertRequiredCapabilities, assertValidProviderRuntimeConfig, broadcastChannelMessage, buildGoogleAuth, buildManifest, buildOnlyOfficeSheetDeletePayload, buildOnlyOfficeSheetRenamePayload, buildSyncPlan, columnIndexToLetter, convertCellsToSheetRows, convertFromDataJsonFormat, convertToDataJsonFormat, createAuthClient, createCapabilitySet, createCryptPadAssetSyncProvider, createCryptPadCsvInputProvider, createCryptPadSheetInputProvider, createCryptPadWorkspaceOutputProvider, createCryptPadWorkspaceSyncProvider, createDefaultProviderCatalog, createGoogleSheetsInputProvider, createGoogleSheetsOutputProvider, createGoogleSheetsSyncProvider, createInMemoryProviderCatalogProvider, createLocaleMapping, createProvidersFromRuntimeConfig, createSpreadsheet, decryptCryptPadPayload, src_default as default, deriveCryptPadKeys, encodeOnlyOfficeCellRecord, encodeOnlyOfficeSheetDeleteRecord, encodeOnlyOfficeSheetRenameRecord, encryptCryptPadPayload, entriesToSeedKeys, entriesToTranslationData, exportDoc, extractOnlyOfficeChannelId, extractOnlyOfficeMetadata, extractOnlyOfficeSheetIdMap, fetchChannelHistory, filterValidLocales, findLocalChanges, getGoogleTranslateCode, getLanguagePrefix, getLocaleDisplayName, getMultipleSpreadSheetsData, getNormalizedLocaleForHeader, getOriginalHeaderForLocale, getSpreadSheetData, getTranslationSummary, grantDrivePermissions, handleBidirectionalSync, hasRequiredCapabilities, inferLocaleFromDocName, ingestDoc, isValidLocale, manageDriveTranslations, mapLegacyGoogleOptionsToProviderConfig, mergeMultipleTranslationData, mergeSheets, migrateProjectToV3, missingCapabilities, moveSpreadsheetToFolder, normalizeExtension, normalizeLocaleCode, normalizePrivateKey, parseDocContent, parseOnlyOfficeChanges, parsePadUrl, processRawRows, readManifest, readPublicSheet, requiresGoogleAuthForRuntimeConfig, resolveCryptPadWebsocketUrl, resolveLocaleWithFallback, resolveSyncPlan, runProviderPipeline, sanitizeFolderName, scanDriveFolderForDocs, scanDriveFolderForSpreadsheets, setupWIF, slugifyKey, syncDriveImages, updateSpreadsheetWithLocalChanges, validateCredentials, validateEnv, validateImageDirectory, validateProviderRuntimeConfig, wait, walkDirectory, withRetry, writeLanguageDataFile, writeLocalesFile, writeManifest, writeTranslationFiles };